@directive-run/ai 1.17.2 → 1.19.0

package/dist/index.d.cts

@@ -1,17 +1,17 @@
-import { b as AgentLike, M as Message, o as AdapterHooks, c as AgentRunner, a1 as ApprovalState, a2 as AgentState, m as GuardrailFn, I as InputGuardrailData, R as RunOptions, q as RunResult } from './types-DJ09LjZX.cjs';
-export { a3 as AgentCircuitBreakerConfig, a4 as AgentCompleteEvent, a5 as AgentErrorEvent, a6 as AgentHealthState, w as AgentRetryConfig, a7 as AgentRetryEvent, J as AgentSelectionStrategy, a8 as AgentStartEvent, A as ApprovalRequest, a9 as ApprovalRequestEvent, aa as ApprovalResponseEvent, z as BreakpointConfig, ab as BreakpointContext, ac as BreakpointHitEvent, B as BreakpointModifications, d as BreakpointRequest, ad as BreakpointResumedEvent, ae as BreakpointState, af as BreakpointType, C as Checkpoint, ag as CheckpointContext, ah as CheckpointDiff, ai as CheckpointLocalState, aj as CheckpointProgress, ak as CheckpointRestoreEvent, al as CheckpointSaveEvent, h as CheckpointStore, am as ConstraintEvaluateEvent, a0 as CrossAgentDerivationFn, an as CrossAgentSnapshot, Y as DagCheckpointState, D as DagExecutionContext, j as DagNode, e as DagNodeStatus, ao as DagNodeUpdateEvent, k as DagPattern, X as DebateCheckpointState, ap as DebateRoundEvent, l as DebugEvent, aq as DebugEventBase, g as DebugEventType, ar as DerivationUpdateEvent, as as GoalCheckpointConfig, Q as GoalCheckpointState, at as GoalMetrics, F as GoalNode, E as GoalPattern, L as GoalResult, au as GoalStepMetrics, av as GuardrailCheckEvent, n as GuardrailContext, aw as GuardrailError, ax as GuardrailErrorCode, G as GuardrailResult, ay as GuardrailRetryConfig, u as GuardrailsConfig, az as HandoffCompleteEvent, aA as HandoffStartEvent, H as HealthMonitorConfig, i as InMemoryCheckpointStore, aB as InMemoryCheckpointStoreOptions, aC as MAX_BREAKPOINT_HISTORY, $ as MultiAgentBreakpointType, aD as MultiAgentCheckpointLocalState, Z as MultiAgentLifecycleHooks, _ as MultiAgentSelfHealingConfig, N as NamedGuardrail, s as OrchestratorConstraint, v as OrchestratorDebugConfig, x as OrchestratorLifecycleHooks, t as OrchestratorResolver, aE as OrchestratorResolverContext, r as OrchestratorState, O as OutputGuardrailData, aF as PatternCheckpointBase, P as PatternCheckpointConfig, aG as PatternCheckpointState, aH as PatternCompleteEvent, aI as PatternStartEvent, aJ as RaceCancelledEvent, aK as RaceStartEvent, aL as RaceWinnerEvent, W as ReflectCheckpointState, aM as ReflectionIterationEvent, aN as RejectedRequest, aO as RelaxationContext, aP as RelaxationRecord, aQ as RelaxationStrategy, K as RelaxationTier, aR as RerouteDebugEvent, f as RerouteEvent, aS as ResolverCompleteEvent, aT as ResolverErrorEvent, aU as ResolverStartEvent, aV as SchemaValidationResult, aW as SchemaValidator, S as Scratchpad, aX as ScratchpadUpdateEvent, y as SelfHealingConfig, U as SequentialCheckpointState, aY as SingleAgentCheckpointLocalState, p as StreamingCallbackRunner, V as SupervisorCheckpointState, aZ as TaskCompleteEvent, a_ as TaskErrorEvent, a$ as TaskProgressEvent, b0 as TaskStartEvent, b1 as TokenUsage, a as ToolCall, T as ToolCallGuardrailData, b2 as createBreakpointId, b3 as createCheckpointId, b4 as createInitialBreakpointState, b5 as isGuardrailError, b6 as matchBreakpoint, b7 as validateCheckpoint } from './types-DJ09LjZX.cjs';
-export { c as AgentMemory, d as AgentMemoryConfig, A as AgentOrchestrator, e as AgentRegistration, f as AgentRegistry, B as BackpressureStrategy, D as DebatePattern, g as DebateResult, h as DoneChunk, E as ErrorChunk, i as ExecutionPattern, G as GuardrailTriggeredChunk, H as HandoffRequest, j as HandoffResult, k as MemoryManageResult, l as MemoryState, m as MemoryStrategy, n as MemoryStrategyConfig, o as MemoryStrategyResult, p as MergedTaggedStreamResult, q as MessageChunk, r as MessageSummarizer, M as MultiAgentOrchestrator, a as MultiAgentOrchestratorOptions, s as MultiAgentRunCallOptions, t as MultiAgentState, b as MultiplexedStreamChunk, u as MultiplexedStreamResult, O as OrchestratorOptions, v as OrchestratorStreamChunk, w as OrchestratorStreamResult, P as ParallelPattern, x as ProgressChunk, y as RacePattern, z as RaceResult, C as RaceSuccessEntry, F as ReflectIterationRecord, I as ReflectPattern, J as ReflectionConfig, K as ReflectionContext, L as ReflectionEvaluation, R as ReflectionEvaluator, N as ReflectionExhaustedError, Q as RunAgentRequirement, S as RunCallOptions, U as SafeParseResult, V as SafeParseable, W as SequentialPattern, X as StreamChunk, Y as StreamRunOptions, Z as StreamRunner, _ as StreamingGuardrail, $ as StreamingGuardrailResult, a0 as StreamingRunResult, a1 as StructuredOutputConfig, a2 as StructuredOutputError, a3 as SupervisorPattern, a4 as TaskContext, T as TaskRegistration, a5 as TokenChunk, a6 as ToolEndChunk, a7 as ToolStartChunk, a8 as adaptOutputGuardrail, a9 as collectTokens, aa as combineStreamingGuardrails, ab as createAgentMemory, ac as createAgentOrchestrator, ad as createHybridStrategy, ae as createKeyPointsSummarizer, af as createLLMSummarizer, ag as createLengthStreamingGuardrail, ah as createPatternStreamingGuardrail, ai as createSlidingWindowStrategy, aj as createStreamingRunner, ak as createTokenBasedStrategy, al as createToxicityStreamingGuardrail, am as createTruncationSummarizer, an as extractJsonFromOutput, ao as filterStream, ap as mapStream, aq as mergeTaggedStreams, ar as tapStream, as as withReflection, at as withStructuredOutput } from './orchestrator-types-CbNE7Rjp.cjs';
-import { PIIType, RedactionStyle } from './guardrails.cjs';
-export { ANNIndex, ANNSearchResult, DEFAULT_INJECTION_PATTERNS, DetectedPII, EnhancedPIIGuardrailOptions, InjectionDetectionResult, PIIDetectionResult, PIIDetector, PromptInjectionGuardrailOptions, RateLimitGuardrail, STRICT_INJECTION_PATTERNS, VPTreeIndexConfig, createBruteForceIndex, createContentFilterGuardrail, createEnhancedPIIGuardrail, createLengthGuardrail, createModerationGuardrail, createOutputPIIGuardrail, createOutputSchemaGuardrail, createOutputTypeGuardrail, createPIIGuardrail, createPromptInjectionGuardrail, createRateLimitGuardrail, createToolGuardrail, createUntrustedContentGuardrail, createVPTreeIndex, detectAndRedactPII, detectPII, detectPromptInjection, markUntrustedContent, redactPII, sanitizeInjection } from './guardrails.cjs';
+import { b as AgentLike, M as Message, o as AdapterHooks, c as AgentRunner, a2 as ApprovalState, a3 as AgentState, m as GuardrailFn, I as InputGuardrailData, R as RunOptions, r as RunResult } from './types-CUp1N0uU.cjs';
+export { a4 as AgentCircuitBreakerConfig, a5 as AgentCompleteEvent, a6 as AgentErrorEvent, a7 as AgentHealthState, x as AgentRetryConfig, a8 as AgentRetryEvent, K as AgentSelectionStrategy, a9 as AgentStartEvent, A as ApprovalRequest, aa as ApprovalRequestEvent, ab as ApprovalResponseEvent, E as BreakpointConfig, ac as BreakpointContext, ad as BreakpointHitEvent, B as BreakpointModifications, d as BreakpointRequest, ae as BreakpointResumedEvent, af as BreakpointState, ag as BreakpointType, C as Checkpoint, ah as CheckpointContext, ai as CheckpointDiff, aj as CheckpointLocalState, ak as CheckpointProgress, al as CheckpointRestoreEvent, am as CheckpointSaveEvent, h as CheckpointStore, an as ConstraintEvaluateEvent, a1 as CrossAgentDerivationFn, ao as CrossAgentSnapshot, Z as DagCheckpointState, D as DagExecutionContext, j as DagNode, e as DagNodeStatus, ap as DagNodeUpdateEvent, k as DagPattern, Y as DebateCheckpointState, aq as DebateRoundEvent, l as DebugEvent, ar as DebugEventBase, g as DebugEventType, as as DerivationUpdateEvent, at as GoalCheckpointConfig, U as GoalCheckpointState, au as GoalMetrics, J as GoalNode, F as GoalPattern, Q as GoalResult, av as GoalStepMetrics, aw as GuardrailCheckEvent, n as GuardrailContext, ax as GuardrailError, ay as GuardrailErrorCode, G as GuardrailResult, az as GuardrailRetryConfig, v as GuardrailsConfig, aA as HandoffCompleteEvent, aB as HandoffStartEvent, H as HealthMonitorConfig, i as InMemoryCheckpointStore, aC as InMemoryCheckpointStoreOptions, aD as MAX_BREAKPOINT_HISTORY, a0 as MultiAgentBreakpointType, aE as MultiAgentCheckpointLocalState, _ as MultiAgentLifecycleHooks, $ as MultiAgentSelfHealingConfig, N as NamedGuardrail, t as OrchestratorConstraint, w as OrchestratorDebugConfig, y as OrchestratorLifecycleHooks, u as OrchestratorResolver, aF as OrchestratorResolverContext, s as OrchestratorState, O as OutputGuardrailData, aG as PatternCheckpointBase, P as PatternCheckpointConfig, aH as PatternCheckpointState, aI as PatternCompleteEvent, aJ as PatternStartEvent, aK as RaceCancelledEvent, aL as RaceStartEvent, aM as RaceWinnerEvent, X as ReflectCheckpointState, aN as ReflectionIterationEvent, aO as RejectedRequest, aP as RelaxationContext, aQ as RelaxationRecord, aR as RelaxationStrategy, L as RelaxationTier, aS as RerouteDebugEvent, f as RerouteEvent, aT as ResolverCompleteEvent, aU as ResolverErrorEvent, aV as ResolverStartEvent, aW as SchemaValidationResult, q as SchemaValidator, S as Scratchpad, aX as ScratchpadUpdateEvent, z as SelfHealingConfig, V as SequentialCheckpointState, aY as SingleAgentCheckpointLocalState, p as StreamingCallbackRunner, W as SupervisorCheckpointState, aZ as TaskCompleteEvent, a_ as TaskErrorEvent, a$ as TaskProgressEvent, b0 as TaskStartEvent, b1 as TokenUsage, a as ToolCall, T as ToolCallGuardrailData, b2 as createBreakpointId, b3 as createCheckpointId, b4 as createInitialBreakpointState, b5 as isGuardrailError, b6 as matchBreakpoint, b7 as validateCheckpoint } from './types-CUp1N0uU.cjs';
+export { c as AgentMemory, d as AgentMemoryConfig, A as AgentOrchestrator, e as AgentRegistration, f as AgentRegistry, B as BackpressureStrategy, D as DebatePattern, g as DebateResult, h as DoneChunk, E as ErrorChunk, i as ExecutionPattern, G as GuardrailTriggeredChunk, H as HandoffRequest, j as HandoffResult, k as MemoryManageResult, l as MemoryState, m as MemoryStrategy, n as MemoryStrategyConfig, o as MemoryStrategyResult, p as MergedTaggedStreamResult, q as MessageChunk, r as MessageSummarizer, M as MultiAgentOrchestrator, a as MultiAgentOrchestratorOptions, s as MultiAgentRunCallOptions, t as MultiAgentState, b as MultiplexedStreamChunk, u as MultiplexedStreamResult, O as OrchestratorOptions, v as OrchestratorStreamChunk, w as OrchestratorStreamResult, P as ParallelPattern, x as ProgressChunk, y as RacePattern, z as RaceResult, C as RaceSuccessEntry, F as ReflectIterationRecord, I as ReflectPattern, J as ReflectionConfig, K as ReflectionContext, L as ReflectionEvaluation, R as ReflectionEvaluator, N as ReflectionExhaustedError, Q as RunAgentRequirement, S as RunCallOptions, U as SafeParseResult, V as SafeParseable, W as SequentialPattern, X as StreamChunk, Y as StreamRunOptions, Z as StreamRunner, _ as StreamingGuardrail, $ as StreamingGuardrailResult, a0 as StreamingRunResult, a1 as StructuredOutputConfig, a2 as StructuredOutputError, a3 as SupervisorPattern, a4 as TaskContext, T as TaskRegistration, a5 as TokenChunk, a6 as ToolEndChunk, a7 as ToolStartChunk, a8 as adaptOutputGuardrail, a9 as collectTokens, aa as combineStreamingGuardrails, ab as createAgentMemory, ac as createAgentOrchestrator, ad as createHybridStrategy, ae as createKeyPointsSummarizer, af as createLLMSummarizer, ag as createLengthStreamingGuardrail, ah as createPatternStreamingGuardrail, ai as createSlidingWindowStrategy, aj as createStreamingRunner, ak as createTokenBasedStrategy, al as createToxicityStreamingGuardrail, am as createTruncationSummarizer, an as extractJsonFromOutput, ao as filterStream, ap as mapStream, aq as mergeTaggedStreams, ar as tapStream, as as withReflection, at as withStructuredOutput } from './orchestrator-types-s0766dDB.cjs';
+import { d as PIIType, f as RedactionStyle } from './ann-index-HoZFIUA-.cjs';
+export { A as ANNIndex, a as ANNSearchResult, D as DEFAULT_INJECTION_PATTERNS, b as DetectedPII, E as EnhancedPIIGuardrailOptions, I as InjectionDetectionResult, P as PIIDetectionResult, c as PIIDetector, e as PromptInjectionGuardrailOptions, R as RateLimitGuardrail, S as STRICT_INJECTION_PATTERNS, V as VPTreeIndexConfig, g as createBruteForceIndex, h as createContentFilterGuardrail, i as createEnhancedPIIGuardrail, j as createLengthGuardrail, k as createModerationGuardrail, l as createOutputPIIGuardrail, m as createOutputSchemaGuardrail, n as createOutputTypeGuardrail, o as createPIIGuardrail, p as createPromptInjectionGuardrail, q as createRateLimitGuardrail, r as createToolGuardrail, s as createUntrustedContentGuardrail, t as createVPTreeIndex, u as detectAndRedactPII, v as detectPII, w as detectPromptInjection, x as markUntrustedContent, y as redactPII, z as sanitizeInjection } from './ann-index-HoZFIUA-.cjs';
 export { AgentInfo, AgentMessage, AgentMessageType, AgentNetwork, AgentNetworkConfig, DebateConfig, DelegationMessage, DelegationResultMessage, GoalAgentDeclaration, GoalDependencyEdge, GoalDependencyGraph, GoalExecutionPlan, GoalExplanation, GoalExplanationStep, GoalPlanStep, GoalValidationResult, InformMessage, MermaidDirection, MermaidNodeShapes, MermaidOptions, MessageBus, MessageBusConfig, MessageFilter, MessageHandler, QueryMessage, RequestMessage, ResponseMessage, Semaphore, SerializedDagNode, SerializedGoalNode, SerializedPattern, SpawnOnConditionOptions, SpawnPoolConfig, Subscription, TypedAgentMessage, UpdateMessage, aggregateTokens, allReadyStrategy, capabilityRoute, collectOutputs, composePatterns, concatResults, costEfficientStrategy, createAgentNetwork, createDelegator, createMessageBus, createMultiAgentOrchestrator, createPubSub, createResponder, dag, debate, derivedConstraint, diffCheckpoints, explainGoal, findAgentsByCapability, forkFromCheckpoint, getCheckpointProgress, getDependencyGraph, getPatternStep, goal, highestImpactStrategy, parallel, patternFromJSON, patternToJSON, patternToMermaid, pickBestResult, planGoal, race, reflect, runAgentRequirement, runDebate, selectAgent, sequential, spawnOnCondition, spawnPool, supervisor, validateGoal } from './multi-agent.cjs';
 export { AggregatedMetric, AlertConfig, AlertEvent, CircuitBreaker, CircuitBreakerConfig, CircuitBreakerOpenError, CircuitBreakerStats, CircuitState, DashboardData, MetricDataPoint, MetricType, OTLPExporter, OTLPExporterConfig, ObservabilityConfig, ObservabilityInstance, TraceSpan, createCircuitBreaker, createOTLPExporter } from '@directive-run/core/plugins';
 import { ModuleSchema, Plugin, SystemInspection } from '@directive-run/core';
-import { a as Embedding, E as EmbedderFn } from './semantic-cache-DM7ev7NQ.cjs';
-export { B as BatchedEmbedder, C as CacheEntry, b as CacheLookupResult, c as CacheStats, S as SemanticCache, d as SemanticCacheConfig, e as SemanticCacheStorage, f as createBatchedEmbedder, g as createInMemoryStorage, h as createSemanticCache, i as createSemanticCacheGuardrail, j as createTestEmbedder } from './semantic-cache-DM7ev7NQ.cjs';
+import { c as Embedding, E as EmbedderFn } from './semantic-cache-Ba0-jEwb.cjs';
+export { B as BatchedEmbedder, C as CacheEntry, a as CacheLookupResult, b as CacheStats, S as SemanticCache, d as SemanticCacheConfig, e as SemanticCacheStorage, f as createBatchedEmbedder, g as createInMemoryStorage, h as createSemanticCache, i as createSemanticCacheGuardrail, j as createTestEmbedder } from './semantic-cache-Ba0-jEwb.cjs';
 export { PredicateFromIntentDiagnostics, PredicateFromIntentError, PredicateFromIntentOptions, PredicateFromIntentProvenance, PredicateFromIntentWithProvenanceResult, PredicateToolSpec, PredicateToolSpecAnthropic, PredicateToolSpecOpenAI, PredicateToolSpecOptions, predicateFromIntent, predicateFromIntentRaw, predicateFromIntentWithProvenance, predicateToolSpec, predicateToolSpecAnthropic, predicateToolSpecOpenAI } from './predicate.cjs';
-import { D as DebugTimeline } from './debug-timeline-DpnRMnLU.cjs';
-export { a as DebugTimelineListener, b as DebugTimelineOptions, c as createDebugTimeline, d as createDebugTimelinePlugin } from './debug-timeline-DpnRMnLU.cjs';
-export { A as AgentHealthMetrics, a as HealthCircuitState, H as HealthMonitor, c as createHealthMonitor } from './health-monitor-C6xoXrQz.cjs';
+import { D as DebugTimeline } from './debug-timeline-Dn1lC_gK.cjs';
+export { a as DebugTimelineListener, b as DebugTimelineOptions, c as createDebugTimeline, d as createDebugTimelinePlugin } from './debug-timeline-Dn1lC_gK.cjs';
+export { A as AgentHealthMetrics, a as HealthCircuitState, H as HealthMonitor, c as createHealthMonitor } from './health-monitor-Cq5sDvid.cjs';
 export { ConnectDevToolsOptions, DevToolsClient, DevToolsClientMessage, DevToolsCompatibleOrchestrator, DevToolsServer, DevToolsServerConfig, DevToolsServerMessage, DevToolsSnapshot, DevToolsTransport, WsTransportConfig, connectDevTools, createDevToolsServer, createWsTransport } from './devtools.cjs';
 export { MCPAdapter, MCPAdapterConfig, MCPApprovalRequest, MCPCallToolRequirement, MCPGetPromptRequirement, MCPReadResourceRequirement, MCPRequirement, MCPResource, MCPServerConfig, MCPSyncResourcesRequirement, MCPTool, MCPToolConstraint, MCPToolResult, convertToolsForLLM, createMCPAdapter, mcpCallTool, mcpGetPrompt, mcpReadResource, mcpSyncResources } from './mcp.cjs';
 export { EvalAgentSummary, EvalAssertOptions, EvalCase, EvalCaseResult, EvalContext, EvalCostOptions, EvalCriterion, EvalCriterionFn, EvalJudgeOptions, EvalLatencyOptions, EvalMatchOptions, EvalOutputLengthOptions, EvalResults, EvalSafetyOptions, EvalScore, EvalSemanticOptions, EvalStructureOptions, EvalSuite, EvalSuiteConfig, createEvalSuite, evalAssert, evalCoherence, evalCost, evalFaithfulness, evalJudge, evalLatency, evalMatch, evalOutputLength, evalRelevance, evalSafety, evalStructure } from './evals.cjs';
@@ -1806,4 +1806,87 @@ interface OtelPlugin {
  */
 declare function createOtelPlugin(config: OtelPluginConfig): OtelPlugin;
 
-export { AdapterHooks, AgentLike, AgentRunner, AgentState, AllProvidersFailedError, ApprovalState, type AuditEventType, type AuditInstance, type AuditPluginConfig, type BatchQueue, type BatchQueueConfig, type BidirectionalStream, type BudgetConfig, type BudgetExceededDetails, BudgetExceededError, type BudgetRunner, type BudgetWindow, type ComplianceConfig, type ComplianceInstance, type ComplianceStorage, type ConstraintRouterConfig, type ConstraintRouterRunner, type CreateRunnerOptions, DebugTimeline, EmbedderFn, Embedding, type FallbackConfig, GuardrailFn, InputGuardrailData, type JSONFileStoreOptions, Message, type ModelRule, type ModelSelectionConfig, type OtelPlugin, type OtelPluginConfig, type OtelSpan, OtelStatusCode, type OtelTracer, PIIType, type ParsedResponse, type ProviderStats, type RAGChunk, type RAGEnrichOptions, type RAGEnricher, type RAGEnricherConfig, type RAGStorage, RedactionStyle, type RetryConfig, RetryExhaustedError, type RoutingConstraint, type RoutingFacts, type RoutingProvider, RunOptions, RunResult, type RunnerMiddleware, type SSEEvent, type SSETransport, type SSETransportConfig, type SpanData, type StreamChannel, type StreamChannelConfig, type StreamChannelState, type TokenPricing, byAgentName, byInputLength, byPattern, createAgentAuditHandlers, createAuditTrail, createBatchQueue, createBidirectionalStream, createCompliance, createConstraintRouter, createInMemoryComplianceStorage, createJSONFileStore, createOtelPlugin, createRAGEnricher, createRunner, createSSETransport, createStreamChannel, estimateCost, formatSystemMeta, hasPendingApprovals, isAgentRunning, mergeStreams, parseHttpStatus, parseRetryAfter, pipe, pipeThrough, toAIContext, validateBaseURL, withBudget, withFallback, withModelSelection, withRetry };
+/**
+ * OTel × Sources — emit source-lifecycle spans from `system.observe()`
+ *
+ * The R5 observability reviewer found `@directive-run/ai/otel.ts`
+ * subscribes only to the AI `DebugTimeline` event stream — so the four
+ * `ObservationEvent.source.*` variants (`source.attach`,
+ * `source.publish`, `source.detach`, `source.error`) shipped by the
+ * source primitive never reach the OTel exporter. SREs running with
+ * `createOtelPlugin` see agent spans but cannot answer "which source
+ * is publishing?" or "did source `mcp` error attach?" from their
+ * tracing backend.
+ *
+ * This module closes the gap as a focused helper (NOT a second OTel
+ * plugin) so a single `OtelTracer` can carry both AI and core source
+ * spans. Wire it once at `createSystem` time:
+ *
+ * @example Wire source events into the same OTel tracer as the AI plugin
+ * ```ts
+ * import { trace } from "@opentelemetry/api";
+ * import { createSystem } from "@directive-run/core";
+ * import { createOtelPlugin, attachSourcesToOtel } from "@directive-run/ai";
+ *
+ * const tracer = trace.getTracer("directive-app");
+ * const otel = createOtelPlugin({ serviceName: "my-app", tracer });
+ *
+ * const system = createSystem({ module });
+ * otel.attach(orchestrator.timeline);            // existing AI wiring
+ * const unsub = attachSourcesToOtel(system, {    // NEW — source.* spans
+ *   tracer,
+ *   serviceName: "my-app",
+ * });
+ *
+ * system.start();
+ *
+ * // Later
+ * unsub();
+ * ```
+ *
+ * Spans emitted:
+ *
+ * - `directive.source.attach` — short-duration (start → end same tick)
+ *   span with attributes `source.id`, `source.module_id`, plus
+ *   `attached_at` timestamp.
+ * - `directive.source.publish` — short-duration counter span (NOT a
+ *   per-publish full span; events of this kind are emitted as
+ *   span EVENTS on a long-lived per-source "active" span so cardinality
+ *   stays bounded).
+ * - `directive.source.detach` — short-duration span, ends the matching
+ *   "active" parent.
+ * - `directive.source.error` — error-status span carrying the phase
+ *   (`attach`/`cleanup`/`runtime` per RFC 0008) and the truncated
+ *   message from R6/R7.
+ *
+ * Cardinality budget: ONE active span per (sourceId, moduleId) at a
+ * time. Publishes attach as span events (cheap), not as new spans. At
+ * 10 sources × 100 publishes/sec the exporter sees 1000 events/sec on
+ * 10 long-lived spans — well within typical OTel collector budgets.
+ */
+
+interface SourcesOtelOptions {
+    /** Tracer to emit spans through. */
+    tracer: OtelTracer;
+    /** Service name attribute for every span. */
+    serviceName: string;
+    /** Span name prefix. Default: `"directive.source"`. */
+    spanPrefix?: string;
+    /**
+     * Optional sampling for publish events. Sources at very high publish
+     * rate (price ticks, cursor moves) may want to drop most publish
+     * events from the trace. Default: `1.0` (every publish recorded as
+     * an event on the active span).
+     */
+    publishSampleRate?: number;
+}
+/**
+ * Subscribe to a system's source-lifecycle events and emit OTel spans
+ * for each. Returns an unsubscribe to detach.
+ *
+ * @returns a function that detaches the OTel wiring without affecting
+ *   other observers.
+ */
+declare function attachSourcesToOtel(system: unknown, options: SourcesOtelOptions): () => void;
+
+export { AdapterHooks, AgentLike, AgentRunner, AgentState, AllProvidersFailedError, ApprovalState, type AuditEventType, type AuditInstance, type AuditPluginConfig, type BatchQueue, type BatchQueueConfig, type BidirectionalStream, type BudgetConfig, type BudgetExceededDetails, BudgetExceededError, type BudgetRunner, type BudgetWindow, type ComplianceConfig, type ComplianceInstance, type ComplianceStorage, type ConstraintRouterConfig, type ConstraintRouterRunner, type CreateRunnerOptions, DebugTimeline, EmbedderFn, Embedding, type FallbackConfig, GuardrailFn, InputGuardrailData, type JSONFileStoreOptions, Message, type ModelRule, type ModelSelectionConfig, type OtelPlugin, type OtelPluginConfig, type OtelSpan, OtelStatusCode, type OtelTracer, PIIType, type ParsedResponse, type ProviderStats, type RAGChunk, type RAGEnrichOptions, type RAGEnricher, type RAGEnricherConfig, type RAGStorage, RedactionStyle, type RetryConfig, RetryExhaustedError, type RoutingConstraint, type RoutingFacts, type RoutingProvider, RunOptions, RunResult, type RunnerMiddleware, type SSEEvent, type SSETransport, type SSETransportConfig, type SourcesOtelOptions, type SpanData, type StreamChannel, type StreamChannelConfig, type StreamChannelState, type TokenPricing, attachSourcesToOtel, byAgentName, byInputLength, byPattern, createAgentAuditHandlers, createAuditTrail, createBatchQueue, createBidirectionalStream, createCompliance, createConstraintRouter, createInMemoryComplianceStorage, createJSONFileStore, createOtelPlugin, createRAGEnricher, createRunner, createSSETransport, createStreamChannel, estimateCost, formatSystemMeta, hasPendingApprovals, isAgentRunning, mergeStreams, parseHttpStatus, parseRetryAfter, pipe, pipeThrough, toAIContext, validateBaseURL, withBudget, withFallback, withModelSelection, withRetry };

package/dist/index.d.ts

@@ -1,17 +1,17 @@
-import { b as AgentLike, M as Message, o as AdapterHooks, c as AgentRunner, a1 as ApprovalState, a2 as AgentState, m as GuardrailFn, I as InputGuardrailData, R as RunOptions, q as RunResult } from './types-DJ09LjZX.js';
-export { a3 as AgentCircuitBreakerConfig, a4 as AgentCompleteEvent, a5 as AgentErrorEvent, a6 as AgentHealthState, w as AgentRetryConfig, a7 as AgentRetryEvent, J as AgentSelectionStrategy, a8 as AgentStartEvent, A as ApprovalRequest, a9 as ApprovalRequestEvent, aa as ApprovalResponseEvent, z as BreakpointConfig, ab as BreakpointContext, ac as BreakpointHitEvent, B as BreakpointModifications, d as BreakpointRequest, ad as BreakpointResumedEvent, ae as BreakpointState, af as BreakpointType, C as Checkpoint, ag as CheckpointContext, ah as CheckpointDiff, ai as CheckpointLocalState, aj as CheckpointProgress, ak as CheckpointRestoreEvent, al as CheckpointSaveEvent, h as CheckpointStore, am as ConstraintEvaluateEvent, a0 as CrossAgentDerivationFn, an as CrossAgentSnapshot, Y as DagCheckpointState, D as DagExecutionContext, j as DagNode, e as DagNodeStatus, ao as DagNodeUpdateEvent, k as DagPattern, X as DebateCheckpointState, ap as DebateRoundEvent, l as DebugEvent, aq as DebugEventBase, g as DebugEventType, ar as DerivationUpdateEvent, as as GoalCheckpointConfig, Q as GoalCheckpointState, at as GoalMetrics, F as GoalNode, E as GoalPattern, L as GoalResult, au as GoalStepMetrics, av as GuardrailCheckEvent, n as GuardrailContext, aw as GuardrailError, ax as GuardrailErrorCode, G as GuardrailResult, ay as GuardrailRetryConfig, u as GuardrailsConfig, az as HandoffCompleteEvent, aA as HandoffStartEvent, H as HealthMonitorConfig, i as InMemoryCheckpointStore, aB as InMemoryCheckpointStoreOptions, aC as MAX_BREAKPOINT_HISTORY, $ as MultiAgentBreakpointType, aD as MultiAgentCheckpointLocalState, Z as MultiAgentLifecycleHooks, _ as MultiAgentSelfHealingConfig, N as NamedGuardrail, s as OrchestratorConstraint, v as OrchestratorDebugConfig, x as OrchestratorLifecycleHooks, t as OrchestratorResolver, aE as OrchestratorResolverContext, r as OrchestratorState, O as OutputGuardrailData, aF as PatternCheckpointBase, P as PatternCheckpointConfig, aG as PatternCheckpointState, aH as PatternCompleteEvent, aI as PatternStartEvent, aJ as RaceCancelledEvent, aK as RaceStartEvent, aL as RaceWinnerEvent, W as ReflectCheckpointState, aM as ReflectionIterationEvent, aN as RejectedRequest, aO as RelaxationContext, aP as RelaxationRecord, aQ as RelaxationStrategy, K as RelaxationTier, aR as RerouteDebugEvent, f as RerouteEvent, aS as ResolverCompleteEvent, aT as ResolverErrorEvent, aU as ResolverStartEvent, aV as SchemaValidationResult, aW as SchemaValidator, S as Scratchpad, aX as ScratchpadUpdateEvent, y as SelfHealingConfig, U as SequentialCheckpointState, aY as SingleAgentCheckpointLocalState, p as StreamingCallbackRunner, V as SupervisorCheckpointState, aZ as TaskCompleteEvent, a_ as TaskErrorEvent, a$ as TaskProgressEvent, b0 as TaskStartEvent, b1 as TokenUsage, a as ToolCall, T as ToolCallGuardrailData, b2 as createBreakpointId, b3 as createCheckpointId, b4 as createInitialBreakpointState, b5 as isGuardrailError, b6 as matchBreakpoint, b7 as validateCheckpoint } from './types-DJ09LjZX.js';
-export { c as AgentMemory, d as AgentMemoryConfig, A as AgentOrchestrator, e as AgentRegistration, f as AgentRegistry, B as BackpressureStrategy, D as DebatePattern, g as DebateResult, h as DoneChunk, E as ErrorChunk, i as ExecutionPattern, G as GuardrailTriggeredChunk, H as HandoffRequest, j as HandoffResult, k as MemoryManageResult, l as MemoryState, m as MemoryStrategy, n as MemoryStrategyConfig, o as MemoryStrategyResult, p as MergedTaggedStreamResult, q as MessageChunk, r as MessageSummarizer, M as MultiAgentOrchestrator, a as MultiAgentOrchestratorOptions, s as MultiAgentRunCallOptions, t as MultiAgentState, b as MultiplexedStreamChunk, u as MultiplexedStreamResult, O as OrchestratorOptions, v as OrchestratorStreamChunk, w as OrchestratorStreamResult, P as ParallelPattern, x as ProgressChunk, y as RacePattern, z as RaceResult, C as RaceSuccessEntry, F as ReflectIterationRecord, I as ReflectPattern, J as ReflectionConfig, K as ReflectionContext, L as ReflectionEvaluation, R as ReflectionEvaluator, N as ReflectionExhaustedError, Q as RunAgentRequirement, S as RunCallOptions, U as SafeParseResult, V as SafeParseable, W as SequentialPattern, X as StreamChunk, Y as StreamRunOptions, Z as StreamRunner, _ as StreamingGuardrail, $ as StreamingGuardrailResult, a0 as StreamingRunResult, a1 as StructuredOutputConfig, a2 as StructuredOutputError, a3 as SupervisorPattern, a4 as TaskContext, T as TaskRegistration, a5 as TokenChunk, a6 as ToolEndChunk, a7 as ToolStartChunk, a8 as adaptOutputGuardrail, a9 as collectTokens, aa as combineStreamingGuardrails, ab as createAgentMemory, ac as createAgentOrchestrator, ad as createHybridStrategy, ae as createKeyPointsSummarizer, af as createLLMSummarizer, ag as createLengthStreamingGuardrail, ah as createPatternStreamingGuardrail, ai as createSlidingWindowStrategy, aj as createStreamingRunner, ak as createTokenBasedStrategy, al as createToxicityStreamingGuardrail, am as createTruncationSummarizer, an as extractJsonFromOutput, ao as filterStream, ap as mapStream, aq as mergeTaggedStreams, ar as tapStream, as as withReflection, at as withStructuredOutput } from './orchestrator-types-ZK9lv5Sm.js';
-import { PIIType, RedactionStyle } from './guardrails.js';
-export { ANNIndex, ANNSearchResult, DEFAULT_INJECTION_PATTERNS, DetectedPII, EnhancedPIIGuardrailOptions, InjectionDetectionResult, PIIDetectionResult, PIIDetector, PromptInjectionGuardrailOptions, RateLimitGuardrail, STRICT_INJECTION_PATTERNS, VPTreeIndexConfig, createBruteForceIndex, createContentFilterGuardrail, createEnhancedPIIGuardrail, createLengthGuardrail, createModerationGuardrail, createOutputPIIGuardrail, createOutputSchemaGuardrail, createOutputTypeGuardrail, createPIIGuardrail, createPromptInjectionGuardrail, createRateLimitGuardrail, createToolGuardrail, createUntrustedContentGuardrail, createVPTreeIndex, detectAndRedactPII, detectPII, detectPromptInjection, markUntrustedContent, redactPII, sanitizeInjection } from './guardrails.js';
+import { b as AgentLike, M as Message, o as AdapterHooks, c as AgentRunner, a2 as ApprovalState, a3 as AgentState, m as GuardrailFn, I as InputGuardrailData, R as RunOptions, r as RunResult } from './types-CUp1N0uU.js';
+export { a4 as AgentCircuitBreakerConfig, a5 as AgentCompleteEvent, a6 as AgentErrorEvent, a7 as AgentHealthState, x as AgentRetryConfig, a8 as AgentRetryEvent, K as AgentSelectionStrategy, a9 as AgentStartEvent, A as ApprovalRequest, aa as ApprovalRequestEvent, ab as ApprovalResponseEvent, E as BreakpointConfig, ac as BreakpointContext, ad as BreakpointHitEvent, B as BreakpointModifications, d as BreakpointRequest, ae as BreakpointResumedEvent, af as BreakpointState, ag as BreakpointType, C as Checkpoint, ah as CheckpointContext, ai as CheckpointDiff, aj as CheckpointLocalState, ak as CheckpointProgress, al as CheckpointRestoreEvent, am as CheckpointSaveEvent, h as CheckpointStore, an as ConstraintEvaluateEvent, a1 as CrossAgentDerivationFn, ao as CrossAgentSnapshot, Z as DagCheckpointState, D as DagExecutionContext, j as DagNode, e as DagNodeStatus, ap as DagNodeUpdateEvent, k as DagPattern, Y as DebateCheckpointState, aq as DebateRoundEvent, l as DebugEvent, ar as DebugEventBase, g as DebugEventType, as as DerivationUpdateEvent, at as GoalCheckpointConfig, U as GoalCheckpointState, au as GoalMetrics, J as GoalNode, F as GoalPattern, Q as GoalResult, av as GoalStepMetrics, aw as GuardrailCheckEvent, n as GuardrailContext, ax as GuardrailError, ay as GuardrailErrorCode, G as GuardrailResult, az as GuardrailRetryConfig, v as GuardrailsConfig, aA as HandoffCompleteEvent, aB as HandoffStartEvent, H as HealthMonitorConfig, i as InMemoryCheckpointStore, aC as InMemoryCheckpointStoreOptions, aD as MAX_BREAKPOINT_HISTORY, a0 as MultiAgentBreakpointType, aE as MultiAgentCheckpointLocalState, _ as MultiAgentLifecycleHooks, $ as MultiAgentSelfHealingConfig, N as NamedGuardrail, t as OrchestratorConstraint, w as OrchestratorDebugConfig, y as OrchestratorLifecycleHooks, u as OrchestratorResolver, aF as OrchestratorResolverContext, s as OrchestratorState, O as OutputGuardrailData, aG as PatternCheckpointBase, P as PatternCheckpointConfig, aH as PatternCheckpointState, aI as PatternCompleteEvent, aJ as PatternStartEvent, aK as RaceCancelledEvent, aL as RaceStartEvent, aM as RaceWinnerEvent, X as ReflectCheckpointState, aN as ReflectionIterationEvent, aO as RejectedRequest, aP as RelaxationContext, aQ as RelaxationRecord, aR as RelaxationStrategy, L as RelaxationTier, aS as RerouteDebugEvent, f as RerouteEvent, aT as ResolverCompleteEvent, aU as ResolverErrorEvent, aV as ResolverStartEvent, aW as SchemaValidationResult, q as SchemaValidator, S as Scratchpad, aX as ScratchpadUpdateEvent, z as SelfHealingConfig, V as SequentialCheckpointState, aY as SingleAgentCheckpointLocalState, p as StreamingCallbackRunner, W as SupervisorCheckpointState, aZ as TaskCompleteEvent, a_ as TaskErrorEvent, a$ as TaskProgressEvent, b0 as TaskStartEvent, b1 as TokenUsage, a as ToolCall, T as ToolCallGuardrailData, b2 as createBreakpointId, b3 as createCheckpointId, b4 as createInitialBreakpointState, b5 as isGuardrailError, b6 as matchBreakpoint, b7 as validateCheckpoint } from './types-CUp1N0uU.js';
+export { c as AgentMemory, d as AgentMemoryConfig, A as AgentOrchestrator, e as AgentRegistration, f as AgentRegistry, B as BackpressureStrategy, D as DebatePattern, g as DebateResult, h as DoneChunk, E as ErrorChunk, i as ExecutionPattern, G as GuardrailTriggeredChunk, H as HandoffRequest, j as HandoffResult, k as MemoryManageResult, l as MemoryState, m as MemoryStrategy, n as MemoryStrategyConfig, o as MemoryStrategyResult, p as MergedTaggedStreamResult, q as MessageChunk, r as MessageSummarizer, M as MultiAgentOrchestrator, a as MultiAgentOrchestratorOptions, s as MultiAgentRunCallOptions, t as MultiAgentState, b as MultiplexedStreamChunk, u as MultiplexedStreamResult, O as OrchestratorOptions, v as OrchestratorStreamChunk, w as OrchestratorStreamResult, P as ParallelPattern, x as ProgressChunk, y as RacePattern, z as RaceResult, C as RaceSuccessEntry, F as ReflectIterationRecord, I as ReflectPattern, J as ReflectionConfig, K as ReflectionContext, L as ReflectionEvaluation, R as ReflectionEvaluator, N as ReflectionExhaustedError, Q as RunAgentRequirement, S as RunCallOptions, U as SafeParseResult, V as SafeParseable, W as SequentialPattern, X as StreamChunk, Y as StreamRunOptions, Z as StreamRunner, _ as StreamingGuardrail, $ as StreamingGuardrailResult, a0 as StreamingRunResult, a1 as StructuredOutputConfig, a2 as StructuredOutputError, a3 as SupervisorPattern, a4 as TaskContext, T as TaskRegistration, a5 as TokenChunk, a6 as ToolEndChunk, a7 as ToolStartChunk, a8 as adaptOutputGuardrail, a9 as collectTokens, aa as combineStreamingGuardrails, ab as createAgentMemory, ac as createAgentOrchestrator, ad as createHybridStrategy, ae as createKeyPointsSummarizer, af as createLLMSummarizer, ag as createLengthStreamingGuardrail, ah as createPatternStreamingGuardrail, ai as createSlidingWindowStrategy, aj as createStreamingRunner, ak as createTokenBasedStrategy, al as createToxicityStreamingGuardrail, am as createTruncationSummarizer, an as extractJsonFromOutput, ao as filterStream, ap as mapStream, aq as mergeTaggedStreams, ar as tapStream, as as withReflection, at as withStructuredOutput } from './orchestrator-types-C5D5JZUj.js';
+import { d as PIIType, f as RedactionStyle } from './ann-index-27QV9tPC.js';
+export { A as ANNIndex, a as ANNSearchResult, D as DEFAULT_INJECTION_PATTERNS, b as DetectedPII, E as EnhancedPIIGuardrailOptions, I as InjectionDetectionResult, P as PIIDetectionResult, c as PIIDetector, e as PromptInjectionGuardrailOptions, R as RateLimitGuardrail, S as STRICT_INJECTION_PATTERNS, V as VPTreeIndexConfig, g as createBruteForceIndex, h as createContentFilterGuardrail, i as createEnhancedPIIGuardrail, j as createLengthGuardrail, k as createModerationGuardrail, l as createOutputPIIGuardrail, m as createOutputSchemaGuardrail, n as createOutputTypeGuardrail, o as createPIIGuardrail, p as createPromptInjectionGuardrail, q as createRateLimitGuardrail, r as createToolGuardrail, s as createUntrustedContentGuardrail, t as createVPTreeIndex, u as detectAndRedactPII, v as detectPII, w as detectPromptInjection, x as markUntrustedContent, y as redactPII, z as sanitizeInjection } from './ann-index-27QV9tPC.js';
 export { AgentInfo, AgentMessage, AgentMessageType, AgentNetwork, AgentNetworkConfig, DebateConfig, DelegationMessage, DelegationResultMessage, GoalAgentDeclaration, GoalDependencyEdge, GoalDependencyGraph, GoalExecutionPlan, GoalExplanation, GoalExplanationStep, GoalPlanStep, GoalValidationResult, InformMessage, MermaidDirection, MermaidNodeShapes, MermaidOptions, MessageBus, MessageBusConfig, MessageFilter, MessageHandler, QueryMessage, RequestMessage, ResponseMessage, Semaphore, SerializedDagNode, SerializedGoalNode, SerializedPattern, SpawnOnConditionOptions, SpawnPoolConfig, Subscription, TypedAgentMessage, UpdateMessage, aggregateTokens, allReadyStrategy, capabilityRoute, collectOutputs, composePatterns, concatResults, costEfficientStrategy, createAgentNetwork, createDelegator, createMessageBus, createMultiAgentOrchestrator, createPubSub, createResponder, dag, debate, derivedConstraint, diffCheckpoints, explainGoal, findAgentsByCapability, forkFromCheckpoint, getCheckpointProgress, getDependencyGraph, getPatternStep, goal, highestImpactStrategy, parallel, patternFromJSON, patternToJSON, patternToMermaid, pickBestResult, planGoal, race, reflect, runAgentRequirement, runDebate, selectAgent, sequential, spawnOnCondition, spawnPool, supervisor, validateGoal } from './multi-agent.js';
 export { AggregatedMetric, AlertConfig, AlertEvent, CircuitBreaker, CircuitBreakerConfig, CircuitBreakerOpenError, CircuitBreakerStats, CircuitState, DashboardData, MetricDataPoint, MetricType, OTLPExporter, OTLPExporterConfig, ObservabilityConfig, ObservabilityInstance, TraceSpan, createCircuitBreaker, createOTLPExporter } from '@directive-run/core/plugins';
 import { ModuleSchema, Plugin, SystemInspection } from '@directive-run/core';
-import { a as Embedding, E as EmbedderFn } from './semantic-cache-DM7ev7NQ.js';
-export { B as BatchedEmbedder, C as CacheEntry, b as CacheLookupResult, c as CacheStats, S as SemanticCache, d as SemanticCacheConfig, e as SemanticCacheStorage, f as createBatchedEmbedder, g as createInMemoryStorage, h as createSemanticCache, i as createSemanticCacheGuardrail, j as createTestEmbedder } from './semantic-cache-DM7ev7NQ.js';
+import { c as Embedding, E as EmbedderFn } from './semantic-cache-Ba0-jEwb.js';
+export { B as BatchedEmbedder, C as CacheEntry, a as CacheLookupResult, b as CacheStats, S as SemanticCache, d as SemanticCacheConfig, e as SemanticCacheStorage, f as createBatchedEmbedder, g as createInMemoryStorage, h as createSemanticCache, i as createSemanticCacheGuardrail, j as createTestEmbedder } from './semantic-cache-Ba0-jEwb.js';
 export { PredicateFromIntentDiagnostics, PredicateFromIntentError, PredicateFromIntentOptions, PredicateFromIntentProvenance, PredicateFromIntentWithProvenanceResult, PredicateToolSpec, PredicateToolSpecAnthropic, PredicateToolSpecOpenAI, PredicateToolSpecOptions, predicateFromIntent, predicateFromIntentRaw, predicateFromIntentWithProvenance, predicateToolSpec, predicateToolSpecAnthropic, predicateToolSpecOpenAI } from './predicate.js';
-import { D as DebugTimeline } from './debug-timeline-L13P-U2I.js';
-export { a as DebugTimelineListener, b as DebugTimelineOptions, c as createDebugTimeline, d as createDebugTimelinePlugin } from './debug-timeline-L13P-U2I.js';
-export { A as AgentHealthMetrics, a as HealthCircuitState, H as HealthMonitor, c as createHealthMonitor } from './health-monitor-qL9RNMH3.js';
+import { D as DebugTimeline } from './debug-timeline-BGcPa0JO.js';
+export { a as DebugTimelineListener, b as DebugTimelineOptions, c as createDebugTimeline, d as createDebugTimelinePlugin } from './debug-timeline-BGcPa0JO.js';
+export { A as AgentHealthMetrics, a as HealthCircuitState, H as HealthMonitor, c as createHealthMonitor } from './health-monitor-DtwmIJkb.js';
 export { ConnectDevToolsOptions, DevToolsClient, DevToolsClientMessage, DevToolsCompatibleOrchestrator, DevToolsServer, DevToolsServerConfig, DevToolsServerMessage, DevToolsSnapshot, DevToolsTransport, WsTransportConfig, connectDevTools, createDevToolsServer, createWsTransport } from './devtools.js';
 export { MCPAdapter, MCPAdapterConfig, MCPApprovalRequest, MCPCallToolRequirement, MCPGetPromptRequirement, MCPReadResourceRequirement, MCPRequirement, MCPResource, MCPServerConfig, MCPSyncResourcesRequirement, MCPTool, MCPToolConstraint, MCPToolResult, convertToolsForLLM, createMCPAdapter, mcpCallTool, mcpGetPrompt, mcpReadResource, mcpSyncResources } from './mcp.js';
 export { EvalAgentSummary, EvalAssertOptions, EvalCase, EvalCaseResult, EvalContext, EvalCostOptions, EvalCriterion, EvalCriterionFn, EvalJudgeOptions, EvalLatencyOptions, EvalMatchOptions, EvalOutputLengthOptions, EvalResults, EvalSafetyOptions, EvalScore, EvalSemanticOptions, EvalStructureOptions, EvalSuite, EvalSuiteConfig, createEvalSuite, evalAssert, evalCoherence, evalCost, evalFaithfulness, evalJudge, evalLatency, evalMatch, evalOutputLength, evalRelevance, evalSafety, evalStructure } from './evals.js';
@@ -1806,4 +1806,87 @@ interface OtelPlugin {
  */
 declare function createOtelPlugin(config: OtelPluginConfig): OtelPlugin;
 
-export { AdapterHooks, AgentLike, AgentRunner, AgentState, AllProvidersFailedError, ApprovalState, type AuditEventType, type AuditInstance, type AuditPluginConfig, type BatchQueue, type BatchQueueConfig, type BidirectionalStream, type BudgetConfig, type BudgetExceededDetails, BudgetExceededError, type BudgetRunner, type BudgetWindow, type ComplianceConfig, type ComplianceInstance, type ComplianceStorage, type ConstraintRouterConfig, type ConstraintRouterRunner, type CreateRunnerOptions, DebugTimeline, EmbedderFn, Embedding, type FallbackConfig, GuardrailFn, InputGuardrailData, type JSONFileStoreOptions, Message, type ModelRule, type ModelSelectionConfig, type OtelPlugin, type OtelPluginConfig, type OtelSpan, OtelStatusCode, type OtelTracer, PIIType, type ParsedResponse, type ProviderStats, type RAGChunk, type RAGEnrichOptions, type RAGEnricher, type RAGEnricherConfig, type RAGStorage, RedactionStyle, type RetryConfig, RetryExhaustedError, type RoutingConstraint, type RoutingFacts, type RoutingProvider, RunOptions, RunResult, type RunnerMiddleware, type SSEEvent, type SSETransport, type SSETransportConfig, type SpanData, type StreamChannel, type StreamChannelConfig, type StreamChannelState, type TokenPricing, byAgentName, byInputLength, byPattern, createAgentAuditHandlers, createAuditTrail, createBatchQueue, createBidirectionalStream, createCompliance, createConstraintRouter, createInMemoryComplianceStorage, createJSONFileStore, createOtelPlugin, createRAGEnricher, createRunner, createSSETransport, createStreamChannel, estimateCost, formatSystemMeta, hasPendingApprovals, isAgentRunning, mergeStreams, parseHttpStatus, parseRetryAfter, pipe, pipeThrough, toAIContext, validateBaseURL, withBudget, withFallback, withModelSelection, withRetry };
+/**
+ * OTel × Sources — emit source-lifecycle spans from `system.observe()`
+ *
+ * The R5 observability reviewer found `@directive-run/ai/otel.ts`
+ * subscribes only to the AI `DebugTimeline` event stream — so the four
+ * `ObservationEvent.source.*` variants (`source.attach`,
+ * `source.publish`, `source.detach`, `source.error`) shipped by the
+ * source primitive never reach the OTel exporter. SREs running with
+ * `createOtelPlugin` see agent spans but cannot answer "which source
+ * is publishing?" or "did source `mcp` error attach?" from their
+ * tracing backend.
+ *
+ * This module closes the gap as a focused helper (NOT a second OTel
+ * plugin) so a single `OtelTracer` can carry both AI and core source
+ * spans. Wire it once at `createSystem` time:
+ *
+ * @example Wire source events into the same OTel tracer as the AI plugin
+ * ```ts
+ * import { trace } from "@opentelemetry/api";
+ * import { createSystem } from "@directive-run/core";
+ * import { createOtelPlugin, attachSourcesToOtel } from "@directive-run/ai";
+ *
+ * const tracer = trace.getTracer("directive-app");
+ * const otel = createOtelPlugin({ serviceName: "my-app", tracer });
+ *
+ * const system = createSystem({ module });
+ * otel.attach(orchestrator.timeline);            // existing AI wiring
+ * const unsub = attachSourcesToOtel(system, {    // NEW — source.* spans
+ *   tracer,
+ *   serviceName: "my-app",
+ * });
+ *
+ * system.start();
+ *
+ * // Later
+ * unsub();
+ * ```
+ *
+ * Spans emitted:
+ *
+ * - `directive.source.attach` — short-duration (start → end same tick)
+ *   span with attributes `source.id`, `source.module_id`, plus
+ *   `attached_at` timestamp.
+ * - `directive.source.publish` — short-duration counter span (NOT a
+ *   per-publish full span; events of this kind are emitted as
+ *   span EVENTS on a long-lived per-source "active" span so cardinality
+ *   stays bounded).
+ * - `directive.source.detach` — short-duration span, ends the matching
+ *   "active" parent.
+ * - `directive.source.error` — error-status span carrying the phase
+ *   (`attach`/`cleanup`/`runtime` per RFC 0008) and the truncated
+ *   message from R6/R7.
+ *
+ * Cardinality budget: ONE active span per (sourceId, moduleId) at a
+ * time. Publishes attach as span events (cheap), not as new spans. At
+ * 10 sources × 100 publishes/sec the exporter sees 1000 events/sec on
+ * 10 long-lived spans — well within typical OTel collector budgets.
+ */
+
+interface SourcesOtelOptions {
+    /** Tracer to emit spans through. */
+    tracer: OtelTracer;
+    /** Service name attribute for every span. */
+    serviceName: string;
+    /** Span name prefix. Default: `"directive.source"`. */
+    spanPrefix?: string;
+    /**
+     * Optional sampling for publish events. Sources at very high publish
+     * rate (price ticks, cursor moves) may want to drop most publish
+     * events from the trace. Default: `1.0` (every publish recorded as
+     * an event on the active span).
+     */
+    publishSampleRate?: number;
+}
+/**
+ * Subscribe to a system's source-lifecycle events and emit OTel spans
+ * for each. Returns an unsubscribe to detach.
+ *
+ * @returns a function that detaches the OTel wiring without affecting
+ *   other observers.
+ */
+declare function attachSourcesToOtel(system: unknown, options: SourcesOtelOptions): () => void;
+
+export { AdapterHooks, AgentLike, AgentRunner, AgentState, AllProvidersFailedError, ApprovalState, type AuditEventType, type AuditInstance, type AuditPluginConfig, type BatchQueue, type BatchQueueConfig, type BidirectionalStream, type BudgetConfig, type BudgetExceededDetails, BudgetExceededError, type BudgetRunner, type BudgetWindow, type ComplianceConfig, type ComplianceInstance, type ComplianceStorage, type ConstraintRouterConfig, type ConstraintRouterRunner, type CreateRunnerOptions, DebugTimeline, EmbedderFn, Embedding, type FallbackConfig, GuardrailFn, InputGuardrailData, type JSONFileStoreOptions, Message, type ModelRule, type ModelSelectionConfig, type OtelPlugin, type OtelPluginConfig, type OtelSpan, OtelStatusCode, type OtelTracer, PIIType, type ParsedResponse, type ProviderStats, type RAGChunk, type RAGEnrichOptions, type RAGEnricher, type RAGEnricherConfig, type RAGStorage, RedactionStyle, type RetryConfig, RetryExhaustedError, type RoutingConstraint, type RoutingFacts, type RoutingProvider, RunOptions, RunResult, type RunnerMiddleware, type SSEEvent, type SSETransport, type SSETransportConfig, type SourcesOtelOptions, type SpanData, type StreamChannel, type StreamChannelConfig, type StreamChannelState, type TokenPricing, attachSourcesToOtel, byAgentName, byInputLength, byPattern, createAgentAuditHandlers, createAuditTrail, createBatchQueue, createBidirectionalStream, createCompliance, createConstraintRouter, createInMemoryComplianceStorage, createJSONFileStore, createOtelPlugin, createRAGEnricher, createRunner, createSSETransport, createStreamChannel, estimateCost, formatSystemMeta, hasPendingApprovals, isAgentRunning, mergeStreams, parseHttpStatus, parseRetryAfter, pipe, pipeThrough, toAIContext, validateBaseURL, withBudget, withFallback, withModelSelection, withRetry };