/** * 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 * • 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 { 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 { 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