/** * agentfootprint/observe — observability recorders. * * Pattern: Observer (GoF) — pluggable, fire-and-forget event listeners * for the agent's typed event stream. * Role: Outer ring (Hexagonal). Attach via `runner.attachScopeRecorder()`; * the runner emits events, recorders accumulate state. * * Three tiers (progressive disclosure): * * Tier 1 — context + stream (the core) * • ContextRecorder — every slot composition * • StreamRecorder — token-level LLM streaming * * Tier 2 — composition + agent (structural nav) * • CompositionRecorder — Sequence/Parallel/Conditional/Loop entries * • AgentRecorder — agent-loop iterations, tool calls * • BoundaryRecorder — domain-tagged subflow entry/exit * • FlowchartRecorder — StepGraph projection (Lens-friendly) * * Tier 3 — domain dashboards (attach on demand) * • CostRecorder — token/USD spend * • EvalRecorder — eval scores from `runner.emit('eval.*', ...)` * • MemoryRecorder — memory injections + writes * • EmbeddingRecorder — embedding cost, index-time vs query-time * • PermissionRecorder — permission decisions + denials * • SkillRecorder — skill activations * • LoggingRecorder — structured log lines per event * • StatusRecorder — chat-bubble first-person status * * Domain-flavored consumers (Lens, Grafana, Datadog) compose Tier 1+2 * directly; Tier 3 dashboards are opt-in. */ export { ContextRecorder, type ContextRecorderOptions } from './recorders/core/ContextRecorder.js'; export { streamRecorder, type StreamRecorderOptions } from './recorders/core/StreamRecorder.js'; export { compositionRecorder, type CompositionRecorderOptions, } from './recorders/core/CompositionRecorder.js'; export { agentRecorder, type AgentRecorderOptions } from './recorders/core/AgentRecorder.js'; export { boundaryRecorder, BoundaryRecorder, type ActorArrow, type BoundaryAggregate, type BoundaryRecorderOptions, type BoundaryRangeLabel, type DomainContextInjectedEvent, type DomainDecisionBranchEvent, type DomainEvent, type DomainForkBranchEvent, type DomainLLMEndEvent, type DomainLLMStartEvent, type DomainLoopIterationEvent, type DomainRunEvent, type DomainSubflowEvent, type DomainToolStartEvent, type DomainToolEndEvent, type LeanDomainEvent, type TypedEventSource, } from './recorders/observability/BoundaryRecorder.js'; export { buildRunSteps, RunStepRecorder, runStepRecorder, type BuildRunStepsOptions, type RunStep, type RunStepGraph, type RunStepKind, type RunStepMeta, type RunStepRecorderOptions, type RunStepTransition, } from './recorders/observability/RunStepRecorder.js'; export { attachFlowchart, buildStepGraph, buildStepGraphFromEvents, type StepGraph, type StepNode, type StepEdge, type SlotBoundary, type ContextInjection, type FlowchartOptions, type FlowchartHandle, } from './recorders/observability/FlowchartRecorder.js'; export { recordRun, type Recording, type RecordRunOptions, type RunRecorder, } from './recorders/observability/recordRun.js'; export { buildRecordingEnvelope, persistRecording, FULL_PRIVACY_POLICY_ID, RECORDING_ENVELOPE_FORMAT, IndeterminateRunFactError, UnsupportedPrivacyModeError, type BuildRecordingEnvelopeOptions, type PersistRecordingOptions, type RecordingConfiguration, type RecordingEnvelope, type RecordingPrivacy, type RecordingPrivacyMode, type RecordingProducer, type RecordingRun, type RecordingRunFacts, type RecordingSink, type RecordingSource, type RecordingTimestamp, } from './recorders/observability/recordingEnvelope.js'; export { fileRecordingSink, recordingFileName, UnsafeRecordingIdError, type FileRecordingSinkOptions, } from './recorders/observability/fileRecordingSink.js'; export { describeBugReport, exportBugReport, type BugReport, type BugReportEnvironment, type BugReportExcluded, type BugReportFields, type BugReportFile, type BugReportFileSummary, type BugReportInput, type BugReportManifest, type BugReportOversize, type BugReportRunFacts, type BugReportSource, type BugReportUnit, type DescribeBugReportOptions, type ExportBugReportOptions, type Transcript, type TranscriptStep, type TranscriptTurn, } from './lib/bug-report/index.js'; export { summarizeEmbeddings, summarizeVector, type EmbeddingSummary, } from './recorders/observability/embeddingSummary.js'; export { serializeTrace, redactContent, traceToStepGraph, type Trace, type TraceSummary, type TraceRedaction, type SerializeTraceOptions, } from './recorders/observability/trace.js'; export { attachLocalObservability, type LocalObservabilityHandle, type LocalObservabilityOptions, } from './recorders/observability/localObservability.js'; export { liveStateRecorder, LiveStateRecorder, LiveLLMTracker, LiveToolTracker, LiveAgentTurnTracker, type LLMLiveState, type ToolLiveState, type AgentTurnLiveState, type LiveStateRunnerLike, } from './recorders/observability/LiveStateRecorder.js'; export { costRecorder, type CostRecorderOptions } from './recorders/core/CostRecorder.js'; export { toolsRecorder, type ToolsRecorderOptions } from './recorders/core/ToolsRecorder.js'; export { contextEvaluatedRecorder, type ContextEvaluatedRecorderOptions, } from './recorders/core/ContextEvaluatedRecorder.js'; export { evalRecorder, type EvalRecorderOptions } from './recorders/core/EvalRecorder.js'; export { memoryRecorder, type MemoryRecorderOptions } from './recorders/core/MemoryRecorder.js'; export { embeddingRecorder, type EmbeddingRecorderOptions, } from './recorders/core/EmbeddingRecorder.js'; export { permissionRecorder, type PermissionRecorderOptions, } from './recorders/core/PermissionRecorder.js'; export { skillRecorder, type SkillRecorderOptions } from './recorders/core/SkillRecorder.js'; export { resilienceRecorder, type ResilienceRecorderOptions, } from './recorders/core/ResilienceRecorder.js'; export { attachLogging, LoggingDomains, type LoggingLogger, type LoggingDomain, type LoggingOptions, } from './recorders/observability/LoggingRecorder.js'; export { attachStatus, type StatusEvent, type StatusOptions, } from './recorders/observability/StatusRecorder.js'; export { toolLineageRecorder, type ToolLineageRecorderHandle, type ToolLineageOptions, type ToolLineageGraph, type ToolLineageEdge, type ToolCallRef, } from './recorders/observability/ToolLineageRecorder.js'; export { agentThinkingTrace, type AgentThinkingTraceHandle, type AgentThinkingTraceOptions, type AttTrace, type AttStep, type AttCost, type AttAnswer, type AttToolSeen, } from './recorders/observability/AgentThinkingTraceRecorder.js'; export { typedEmit } from './recorders/core/typedEmit.js'; export * from './debug.js'; export { buildChoiceContext, toolChoiceRecorder, type OfferedTool, type ToolChoiceCall, type ToolChoiceRecorderHandle, type ToolChoiceRecorderOptions, type ToolChoiceSkipReason, type ToolChoiceSummary, } from './recorders/observability/ToolChoiceRecorder.js'; export { routeRecorder, formatRouteHop, type RouteRecorderHandle, type RouteRecorderOptions, type RouteHop, type RouteOutcome, type RouteTrip, type RouteTripKind, } from './recorders/observability/RouteRecorder.js'; export { contextLedger, ledgerToolGate, ledgerEntryScorer, ledgerGated, } from './lib/context-ledger/index.js'; export type { ContextLedger, LedgerJSON, LedgerPolicy, LedgerRow, PieceKind, RecordedRun, UsedSignal, } from './lib/context-ledger/index.js'; //# sourceMappingURL=observe.d.ts.map