@directive-run/ai 0.8.6 → 0.8.8

package/dist/index.d.cts

@@ -1,11 +1,11 @@
-import { G as GuardrailFn, I as InputGuardrailData, O as OutputGuardrailData, S as SchemaValidator, T as ToolCallGuardrailData, A as AgentLike, M as Message, a as AdapterHooks, b as AgentRunner, c as ApprovalState, d as AgentState, e as AgentSelectionStrategy, D as DagNode, f as DagExecutionContext, g as DagPattern, h as GoalNode, R as RelaxationTier, i as GoalMetrics, P as PatternCheckpointConfig, j as GoalPattern, k as RunResult, l as OrchestratorConstraint, m as RunOptions, n as DebugEvent, B as BreakpointState, o as GoalResult } from './types-BM-6xZf_.cjs';
-export { p as AgentCircuitBreakerConfig, q as AgentCompleteEvent, r as AgentErrorEvent, s as AgentHealthState, t as AgentRetryConfig, u as AgentRetryEvent, v as AgentStartEvent, w as ApprovalRequest, x as ApprovalRequestEvent, y as ApprovalResponseEvent, z as BreakpointConfig, C as BreakpointContext, E as BreakpointHitEvent, F as BreakpointModifications, H as BreakpointRequest, J as BreakpointResumedEvent, K as BreakpointState, L as BreakpointType, N as Checkpoint, Q as CheckpointContext, U as CheckpointDiff, V as CheckpointLocalState, W as CheckpointProgress, X as CheckpointRestoreEvent, Y as CheckpointSaveEvent, Z as CheckpointStore, _ as ConstraintEvaluateEvent, $ as CrossAgentDerivationFn, a0 as CrossAgentSnapshot, a1 as DagCheckpointState, a2 as DagNodeStatus, a3 as DagNodeUpdateEvent, a4 as DebateCheckpointState, a5 as DebateRoundEvent, a6 as DebugEventBase, a7 as DebugEventType, a8 as DerivationUpdateEvent, a9 as GoalCheckpointConfig, aa as GoalCheckpointState, ab as GoalStepMetrics, ac as GuardrailCheckEvent, ad as GuardrailContext, ae as GuardrailError, af as GuardrailErrorCode, ag as GuardrailResult, ah as GuardrailRetryConfig, ai as GuardrailsConfig, aj as HandoffCompleteEvent, ak as HandoffStartEvent, al as HealthMonitorConfig, am as InMemoryCheckpointStore, an as InMemoryCheckpointStoreOptions, ao as MAX_BREAKPOINT_HISTORY, ap as MultiAgentBreakpointType, aq as MultiAgentCheckpointLocalState, ar as MultiAgentLifecycleHooks, as as MultiAgentSelfHealingConfig, at as NamedGuardrail, au as OrchestratorDebugConfig, av as OrchestratorLifecycleHooks, aw as OrchestratorResolver, ax as OrchestratorResolverContext, ay as OrchestratorState, az as PatternCheckpointBase, aA as PatternCheckpointState, aB as PatternCompleteEvent, aC as PatternStartEvent, aD as RaceCancelledEvent, aE as RaceStartEvent, aF as RaceWinnerEvent, aG as ReflectCheckpointState, aH as ReflectionIterationEvent, aI as RejectedRequest, aJ as RelaxationContext, aK as RelaxationRecord, aL as RelaxationStrategy, aM as RerouteDebugEvent, aN as RerouteEvent, aO as ResolverCompleteEvent, aP as ResolverErrorEvent, aQ as ResolverStartEvent, aR as SchemaValidationResult, aS as Scratchpad, aT as ScratchpadUpdateEvent, aU as SelfHealingConfig, aV as SequentialCheckpointState, aW as SingleAgentCheckpointLocalState, aX as StreamingCallbackRunner, aY as SupervisorCheckpointState, aZ as TaskCompleteEvent, a_ as TaskErrorEvent, a$ as TaskProgressEvent, b0 as TaskStartEvent, b1 as TokenUsage, b2 as ToolCall, b3 as createBreakpointId, b4 as createCheckpointId, b5 as createInitialBreakpointState, b6 as isGuardrailError, b7 as matchBreakpoint, b8 as validateCheckpoint } from './types-BM-6xZf_.cjs';
-import { P as ParallelPattern, R as RacePattern, a as ReflectionEvaluation, b as ReflectIterationRecord, c as ReflectPattern, S as SequentialPattern, d as SupervisorPattern, E as ExecutionPattern, D as DebatePattern, A as AgentRegistry, M as MultiAgentOrchestrator, e as RunAgentRequirement, f as DebateResult, g as AgentHealthMetrics, h as DebugTimeline, H as HealthMonitor } from './multi-agent-orchestrator-C3VKkLzg.cjs';
-export { i as AgentMemory, j as AgentMemoryConfig, k as AgentOrchestrator, l as AgentRegistration, B as BackpressureStrategy, m as DebugTimelineListener, n as DebugTimelineOptions, o as DoneChunk, p as ErrorChunk, G as GuardrailTriggeredChunk, q as HandoffRequest, r as HandoffResult, s as HealthCircuitState, t as MemoryManageResult, u as MemoryState, v as MemoryStrategy, w as MemoryStrategyConfig, x as MemoryStrategyResult, y as MergedTaggedStreamResult, z as MessageChunk, C as MessageSummarizer, F as MultiAgentOrchestratorOptions, I as MultiAgentRunCallOptions, J as MultiAgentState, K as MultiplexedStreamChunk, L as MultiplexedStreamResult, O as OrchestratorOptions, N as OrchestratorStreamChunk, Q as OrchestratorStreamResult, T as ProgressChunk, U as RaceResult, V as RaceSuccessEntry, W as ReflectionConfig, X as ReflectionContext, Y as ReflectionEvaluator, Z as ReflectionExhaustedError, _ as RunCallOptions, $ as SafeParseResult, a0 as SafeParseable, a1 as Semaphore, a2 as StreamChunk, a3 as StreamRunOptions, a4 as StreamRunner, a5 as StreamingGuardrail, a6 as StreamingGuardrailResult, a7 as StreamingRunResult, a8 as StructuredOutputConfig, a9 as StructuredOutputError, aa as TaskContext, ab as TaskRegistration, ac as TokenChunk, ad as ToolEndChunk, ae as ToolStartChunk, af as adaptOutputGuardrail, ag as collectTokens, ah as combineStreamingGuardrails, ai as createAgentMemory, aj as createAgentOrchestrator, ak as createDebugTimeline, al as createDebugTimelinePlugin, am as createHealthMonitor, an as createHybridStrategy, ao as createKeyPointsSummarizer, ap as createLLMSummarizer, aq as createLengthStreamingGuardrail, ar as createMultiAgentOrchestrator, as as createPatternStreamingGuardrail, at as createSlidingWindowStrategy, au as createStreamingRunner, av as createTokenBasedStrategy, aw as createToxicityStreamingGuardrail, ax as createTruncationSummarizer, ay as diffCheckpoints, az as extractJsonFromOutput, aA as filterStream, aB as forkFromCheckpoint, aC as getCheckpointProgress, aD as getPatternStep, aE as mapStream, aF as mergeTaggedStreams, aG as tapStream, aH as withReflection, aI as withStructuredOutput } from './multi-agent-orchestrator-C3VKkLzg.cjs';
+import { G as GuardrailFn, I as InputGuardrailData, O as OutputGuardrailData, S as SchemaValidator, T as ToolCallGuardrailData, A as AgentLike, M as Message, a as AdapterHooks, b as AgentRunner, c as ApprovalState, d as AgentState, P as PatternCheckpointState, C as CheckpointDiff, e as CheckpointStore, f as CheckpointProgress, g as AgentSelectionStrategy, D as DagNode, h as DagExecutionContext, i as DagPattern, j as GoalNode, R as RelaxationTier, k as GoalMetrics, l as PatternCheckpointConfig, m as GoalPattern, n as RunResult, o as OrchestratorConstraint, p as RunOptions, q as DebugEvent, B as BreakpointState, r as GoalResult } from './types-CRmwFnVk.cjs';
+export { s as AgentCircuitBreakerConfig, t as AgentCompleteEvent, u as AgentErrorEvent, v as AgentHealthState, w as AgentRetryConfig, x as AgentRetryEvent, y as AgentStartEvent, z as ApprovalRequest, E as ApprovalRequestEvent, F as ApprovalResponseEvent, H as BreakpointConfig, J as BreakpointContext, K as BreakpointHitEvent, L as BreakpointModifications, N as BreakpointRequest, Q as BreakpointResumedEvent, U as BreakpointState, V as BreakpointType, W as Checkpoint, X as CheckpointContext, Y as CheckpointLocalState, Z as CheckpointRestoreEvent, _ as CheckpointSaveEvent, $ as ConstraintEvaluateEvent, a0 as CrossAgentDerivationFn, a1 as CrossAgentSnapshot, a2 as DagCheckpointState, a3 as DagNodeStatus, a4 as DagNodeUpdateEvent, a5 as DebateCheckpointState, a6 as DebateRoundEvent, a7 as DebugEventBase, a8 as DebugEventType, a9 as DerivationUpdateEvent, aa as GoalCheckpointConfig, ab as GoalCheckpointState, ac as GoalStepMetrics, ad as GuardrailCheckEvent, ae as GuardrailContext, af as GuardrailError, ag as GuardrailErrorCode, ah as GuardrailResult, ai as GuardrailRetryConfig, aj as GuardrailsConfig, ak as HandoffCompleteEvent, al as HandoffStartEvent, am as HealthMonitorConfig, an as InMemoryCheckpointStore, ao as InMemoryCheckpointStoreOptions, ap as MAX_BREAKPOINT_HISTORY, aq as MultiAgentBreakpointType, ar as MultiAgentCheckpointLocalState, as as MultiAgentLifecycleHooks, at as MultiAgentSelfHealingConfig, au as NamedGuardrail, av as OrchestratorDebugConfig, aw as OrchestratorLifecycleHooks, ax as OrchestratorResolver, ay as OrchestratorResolverContext, az as OrchestratorState, aA as PatternCheckpointBase, aB as PatternCompleteEvent, aC as PatternStartEvent, aD as RaceCancelledEvent, aE as RaceStartEvent, aF as RaceWinnerEvent, aG as ReflectCheckpointState, aH as ReflectionIterationEvent, aI as RejectedRequest, aJ as RelaxationContext, aK as RelaxationRecord, aL as RelaxationStrategy, aM as RerouteDebugEvent, aN as RerouteEvent, aO as ResolverCompleteEvent, aP as ResolverErrorEvent, aQ as ResolverStartEvent, aR as SchemaValidationResult, aS as Scratchpad, aT as ScratchpadUpdateEvent, aU as SelfHealingConfig, aV as SequentialCheckpointState, aW as SingleAgentCheckpointLocalState, aX as StreamingCallbackRunner, aY as SupervisorCheckpointState, aZ as TaskCompleteEvent, a_ as TaskErrorEvent, a$ as TaskProgressEvent, b0 as TaskStartEvent, b1 as TokenUsage, b2 as ToolCall, b3 as createBreakpointId, b4 as createCheckpointId, b5 as createInitialBreakpointState, b6 as isGuardrailError, b7 as matchBreakpoint, b8 as validateCheckpoint } from './types-CRmwFnVk.cjs';
+import { M as MultiAgentOrchestratorOptions, a as MultiAgentOrchestrator, P as ParallelPattern, R as RacePattern, b as ReflectionEvaluation, c as ReflectIterationRecord, d as ReflectPattern, S as SequentialPattern, e as SupervisorPattern, E as ExecutionPattern, D as DebatePattern, A as AgentRegistry, f as RunAgentRequirement, g as DebateResult, h as AgentHealthMetrics, i as DebugTimeline, H as HealthMonitor } from './orchestrator-types-tATJCBi5.cjs';
+export { j as AgentMemory, k as AgentMemoryConfig, l as AgentOrchestrator, m as AgentRegistration, B as BackpressureStrategy, n as DebugTimelineListener, o as DebugTimelineOptions, p as DoneChunk, q as ErrorChunk, G as GuardrailTriggeredChunk, r as HandoffRequest, s as HandoffResult, t as HealthCircuitState, u as MemoryManageResult, v as MemoryState, w as MemoryStrategy, x as MemoryStrategyConfig, y as MemoryStrategyResult, z as MergedTaggedStreamResult, C as MessageChunk, F as MessageSummarizer, I as MultiAgentRunCallOptions, J as MultiAgentState, K as MultiplexedStreamChunk, L as MultiplexedStreamResult, O as OrchestratorOptions, N as OrchestratorStreamChunk, Q as OrchestratorStreamResult, T as ProgressChunk, U as RaceResult, V as RaceSuccessEntry, W as ReflectionConfig, X as ReflectionContext, Y as ReflectionEvaluator, Z as ReflectionExhaustedError, _ as RunCallOptions, $ as SafeParseResult, a0 as SafeParseable, a1 as StreamChunk, a2 as StreamRunOptions, a3 as StreamRunner, a4 as StreamingGuardrail, a5 as StreamingGuardrailResult, a6 as StreamingRunResult, a7 as StructuredOutputConfig, a8 as StructuredOutputError, a9 as TaskContext, aa as TaskRegistration, ab as TokenChunk, ac as ToolEndChunk, ad as ToolStartChunk, ae as adaptOutputGuardrail, af as collectTokens, ag as combineStreamingGuardrails, ah as createAgentMemory, ai as createAgentOrchestrator, aj as createDebugTimeline, ak as createDebugTimelinePlugin, al as createHealthMonitor, am as createHybridStrategy, an as createKeyPointsSummarizer, ao as createLLMSummarizer, ap as createLengthStreamingGuardrail, aq as createPatternStreamingGuardrail, ar as createSlidingWindowStrategy, as as createStreamingRunner, at as createTokenBasedStrategy, au as createToxicityStreamingGuardrail, av as createTruncationSummarizer, aw as extractJsonFromOutput, ax as filterStream, ay as mapStream, az as mergeTaggedStreams, aA as tapStream, aB as withReflection, aC as withStructuredOutput } from './orchestrator-types-tATJCBi5.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 } from '@directive-run/core';
-import { E as Embedding, a as EmbedderFn } from './semantic-cache-F0psCRuz.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-F0psCRuz.cjs';
+import { E as Embedding, a as EmbedderFn } from './semantic-cache-nBpQqILc.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-nBpQqILc.cjs';
 
 /**
  * Built-in guardrails for AI adapter — PII, moderation, rate limiting, tool allowlists, schema validation.
@@ -367,6 +367,98 @@ type RunnerMiddleware = (runner: AgentRunner) => AgentRunner;
  */
 declare function pipe(runner: AgentRunner, ...middlewares: RunnerMiddleware[]): AgentRunner;
 
+/**
+ * Async semaphore for controlling concurrent access.
+ * Uses a queue-based approach instead of polling for efficiency.
+ *
+ * @example
+ * ```typescript
+ * import { Semaphore } from '@directive-run/ai';
+ *
+ * const sem = new Semaphore(3); // Allow 3 concurrent operations
+ *
+ * async function doWork() {
+ *   const release = await sem.acquire();
+ *   try {
+ *     await performWork();
+ *   } finally {
+ *     release();
+ *   }
+ * }
+ * ```
+ */
+declare class Semaphore {
+    private count;
+    private readonly maxPermits;
+    private readonly queue;
+    constructor(max: number);
+    /** Create a one-shot release function that guards against double-release */
+    private createReleaseFn;
+    /** Acquire a permit, optionally with abort signal support */
+    acquire(signal?: AbortSignal): Promise<() => void>;
+    /** Non-blocking acquire — returns null if no permits available */
+    tryAcquire(): (() => void) | null;
+    private release;
+    /** Get current available permits */
+    get available(): number;
+    /** Get number of waiters in queue */
+    get waiting(): number;
+    /** Get maximum permits */
+    get max(): number;
+    /** Reject all pending waiters with an error and reset permits */
+    drain(): void;
+}
+/**
+ * Get the current step/round/iteration count from a pattern checkpoint state.
+ *
+ * Maps each pattern type to its natural progress counter: `step` for sequential
+ * and goal, `round` for supervisor and debate, `iteration` for reflect, and
+ * `completedCount` for DAG.
+ *
+ * @param state - The pattern checkpoint state to inspect.
+ * @returns The current progress count for the pattern.
+ */
+declare function getPatternStep(state: PatternCheckpointState): number;
+/**
+ * Compute progress metrics from a pattern checkpoint state.
+ *
+ * Returns percentage complete, steps completed/remaining, tokens consumed,
+ * and estimated tokens remaining (when computable). Each pattern type
+ * calculates these metrics from its own state structure.
+ *
+ * @param state - The pattern checkpoint state to analyze.
+ * @returns A {@link CheckpointProgress} object with completion metrics.
+ */
+declare function getCheckpointProgress(state: PatternCheckpointState): CheckpointProgress;
+/**
+ * Compute the diff between two checkpoint states of the same pattern type.
+ *
+ * Returns the delta in steps, tokens, and time between checkpoints.
+ * Useful for understanding how much progress occurred between saves.
+ *
+ * @param a - The earlier checkpoint state.
+ * @param b - The later checkpoint state.
+ * @returns A {@link CheckpointDiff} with step, token, and time deltas.
+ * @throws If the two checkpoints have different pattern types.
+ */
+declare function diffCheckpoints(a: PatternCheckpointState, b: PatternCheckpointState): CheckpointDiff;
+/**
+ * Fork an orchestrator from a checkpoint — creates a new independent orchestrator
+ * restored to the checkpoint's state, ready to diverge from that point.
+ *
+ * @param options - The original orchestrator options used to create the orchestrator
+ * @param checkpointStore - The checkpoint store containing the checkpoint
+ * @param checkpointId - The ID of the checkpoint to fork from
+ * @returns A new independent MultiAgentOrchestrator restored to checkpoint state
+ *
+ * @example
+ * ```typescript
+ * const forked = await forkFromCheckpoint(orchestratorOptions, store, "ckpt_abc123");
+ * const result = await forked.replay("ckpt_abc123", pattern, { input: "new input" });
+ * ```
+ */
+declare function forkFromCheckpoint(options: MultiAgentOrchestratorOptions, checkpointStore: CheckpointStore, checkpointId: string): Promise<MultiAgentOrchestrator>;
+
 /**
  * Create a parallel execution pattern that runs handlers concurrently and merges results.
  *
@@ -686,8 +778,7 @@ declare function patternToJSON(pattern: ExecutionPattern<unknown>): SerializedPa
  * @remarks
  * Returns the data structure with all function fields set to `undefined`.
  * Supply callbacks via the optional `overrides` parameter to re-attach
- * runtime behavior. Handles legacy field migrations (`agent` to `handler`,
- * `agents` to `handlers`, `converge` to `goal`).
+ * runtime behavior.
  *
  * @param json - The serialized pattern from {@link patternToJSON} or persisted storage.
  * @param overrides - Optional partial pattern to re-attach function callbacks (e.g. `merge`, `extract`).
@@ -1017,6 +1108,82 @@ interface SpawnPoolConfig {
  */
 declare function spawnPool(when: (facts: Record<string, unknown>) => boolean, config: SpawnPoolConfig): OrchestratorConstraint<Record<string, unknown>>;
 
+/**
+ * Multi-Agent Orchestration Patterns
+ *
+ * Provides patterns for coordinating multiple AI agents:
+ * - Parallel execution with result merging
+ * - Sequential pipelines
+ * - Supervisor patterns with worker delegation
+ * - Constraint-driven agent selection
+ *
+ * @example
+ * ```typescript
+ * import { createMultiAgentOrchestrator } from '@directive-run/ai';
+ *
+ * const orchestrator = createMultiAgentOrchestrator({
+ *   agents: {
+ *     researcher: { agent: researchAgent, maxConcurrent: 3 },
+ *     writer: { agent: writerAgent, maxConcurrent: 1 },
+ *     reviewer: { agent: reviewerAgent, maxConcurrent: 1 },
+ *   },
+ *   patterns: {
+ *     parallelResearch: {
+ *       type: 'parallel',
+ *       handlers: ['researcher', 'researcher', 'researcher'],
+ *       merge: (results) => combineResearch(results),
+ *     },
+ *   },
+ * });
+ * ```
+ */
+
+/**
+ * Create a multi-agent orchestrator backed by a Directive System.
+ *
+ * Each registered agent becomes a namespaced Directive module with reactive state,
+ * constraint evaluation, guardrails, streaming, approval, memory, retry, budget,
+ * hooks, and time-travel debugging -- all features at parity with {@link createAgentOrchestrator}.
+ *
+ * @param options - Orchestrator configuration including runner, agent registry, patterns, guardrails, and plugins.
+ * @returns A {@link MultiAgentOrchestrator} instance with `runAgent`, `runPattern`, `handoff`, and checkpoint APIs.
+ *
+ * @example
+ * ```typescript
+ * const orchestrator = createMultiAgentOrchestrator({
+ *   runner,
+ *   agents: {
+ *     researcher: { agent: researchAgent, maxConcurrent: 3 },
+ *     writer: { agent: writerAgent },
+ *     reviewer: { agent: reviewerAgent },
+ *   },
+ *   guardrails: {
+ *     input: [detectPII],
+ *     output: [checkToxicity],
+ *   },
+ *   hooks: {
+ *     onAgentStart: ({ agentId, input }) => console.log(`${agentId}: ${input}`),
+ *   },
+ *   maxTokenBudget: 50000,
+ *   debug: true,
+ * });
+ *
+ * // Run with full guardrails + approval + streaming
+ * const result = await orchestrator.runAgent('researcher', 'What is AI?');
+ *
+ * // Stream agent output
+ * const { stream } = orchestrator.runAgentStream('writer', 'Write about AI');
+ * for await (const chunk of stream) {
+ *   if (chunk.type === 'token') process.stdout.write(chunk.data);
+ * }
+ * ```
+ *
+ * @throws If a pattern references an agent that is not in the registry
+ * @throws If autoApproveToolCalls is false but no onApprovalRequest callback is provided
+ * @public
+ */
+declare function createMultiAgentOrchestrator(options: MultiAgentOrchestratorOptions): MultiAgentOrchestrator;
+
 type MermaidDirection = "LR" | "TD" | "TB" | "RL" | "BT";
 interface MermaidNodeShapes {
     /** Shape for agent nodes. @default "square" */
@@ -1218,8 +1385,8 @@ interface MessageBus {
     getPending(agentId: string): TypedAgentMessage[];
     /** Clear all messages and data */
     clear(): void;
-    /** Dispose of the message bus, clearing all data and subscriptions */
-    dispose(): void;
+    /** Destroy the message bus, clearing all data and subscriptions */
+    destroy(): void;
 }
 /**
  * Create a message bus for agent communication.
@@ -1296,8 +1463,8 @@ interface AgentNetwork {
     listen(agentId: string, handler: MessageHandler, filter?: MessageFilter): Subscription;
     /** Get the message bus */
     getBus(): MessageBus;
-    /** Dispose of the network, clearing pending waiters and timers */
-    dispose(): void;
+    /** Destroy the network, clearing pending waiters and timers */
+    destroy(): void;
 }
 /**
  * Create an agent network for coordinated communication.
@@ -1352,8 +1519,8 @@ declare function createResponder(network: AgentNetwork, agentId: string): {
     }>): void;
     /** Remove a request handler */
     offRequest(action: string): void;
-    /** Dispose of this responder, unsubscribing from network */
-    dispose(): void;
+    /** Destroy this responder, unsubscribing from network */
+    destroy(): void;
 };
 /**
  * Create a task delegator for handling incoming delegations.
@@ -1385,8 +1552,8 @@ declare function createDelegator(network: AgentNetwork, agentId: string): {
     }>): void;
     /** Remove the delegation handler */
     offDelegation(): void;
-    /** Dispose of this delegator, unsubscribing from network */
-    dispose(): void;
+    /** Destroy this delegator, unsubscribing from network */
+    destroy(): void;
 };
 /**
  * Create a pub/sub helper for topic-based communication.
@@ -1407,8 +1574,8 @@ declare function createDelegator(network: AgentNetwork, agentId: string): {
 declare function createPubSub(network: AgentNetwork, agentId: string): {
     subscribe(topics: string[], handler: (topic: string, content: unknown) => void): () => void;
     publish(topic: string, content: unknown): void;
-    /** Dispose of this pub/sub, unsubscribing from network and clearing handlers */
-    dispose(): void;
+    /** Destroy this pub/sub, unsubscribing from network and clearing handlers */
+    destroy(): void;
 };
 
 /**
@@ -1715,8 +1882,8 @@ interface AuditInstance {
     prune(): number;
     /** Get audit statistics */
     getStats(): AuditStats;
-    /** Dispose of the instance (clears timers, flushes exports) */
-    dispose(): Promise<void>;
+    /** Destroy the instance (clears timers, flushes exports) */
+    destroy(): Promise<void>;
     /** Create a plugin for a directive system */
     createPlugin<M extends ModuleSchema>(): Plugin<M>;
     /** Add a custom audit entry */
@@ -2494,8 +2661,8 @@ interface RAGStorage {
     }>>;
     /** Reload storage (clear cache, re-read from source) */
     reload?(): Promise<void>;
-    /** Dispose of resources */
-    dispose?(): void;
+    /** Destroy and release resources */
+    destroy?(): void;
 }
 interface RAGEnricherConfig {
     /** Function to generate query embeddings */
@@ -3059,7 +3226,7 @@ declare function withModelSelection(runner: AgentRunner, configOrRules: ModelSel
  * await queue.flush();
  *
  * // Clean up (flushes remaining calls)
- * await queue.dispose();
+ * await queue.destroy();
  * ```
  */
 
@@ -3078,8 +3245,8 @@ interface BatchQueue {
     flush(): Promise<void>;
     /** Get the number of pending calls. */
     readonly pending: number;
-    /** Dispose the queue, flushing remaining calls. */
-    dispose(): Promise<void>;
+    /** Destroy the queue, flushing remaining calls. */
+    destroy(): Promise<void>;
 }
 /**
  * Create a batch queue for grouping agent calls.
@@ -3100,7 +3267,7 @@ interface BatchQueue {
  * ]);
  *
  * // Clean up
- * await queue.dispose();
+ * await queue.destroy();
  * ```
  */
 declare function createBatchQueue(runner: AgentRunner, config?: BatchQueueConfig): BatchQueue;
@@ -4722,4 +4889,4 @@ interface OtelPlugin {
  */
 declare function createOtelPlugin(config: OtelPluginConfig): OtelPlugin;
 
-export { type ANNIndex, type ANNSearchResult, AdapterHooks, AgentHealthMetrics, type AgentInfo, AgentLike, type AgentMessage, type AgentMessageType, type AgentNetwork, type AgentNetworkConfig, AgentRegistry, AgentRunner, AgentSelectionStrategy, 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 ConnectDevToolsOptions, type ConstraintRouterConfig, type ConstraintRouterRunner, type CreateRunnerOptions, DEFAULT_INJECTION_PATTERNS, DagExecutionContext, DagNode, DagPattern, type DebateConfig, DebatePattern, DebateResult, DebugEvent, DebugTimeline, type DelegationMessage, type DelegationResultMessage, type DevToolsClient, type DevToolsClientMessage, type DevToolsCompatibleOrchestrator, type DevToolsServer, type DevToolsServerConfig, type DevToolsServerMessage, type DevToolsSnapshot, type DevToolsTransport, EmbedderFn, Embedding, type EnhancedPIIGuardrailOptions, type EvalAgentSummary, type EvalAssertOptions, type EvalCase, type EvalCaseResult, type EvalContext, type EvalCostOptions, type EvalCriterion, type EvalCriterionFn, type EvalJudgeOptions, type EvalLatencyOptions, type EvalMatchOptions, type EvalOutputLengthOptions, type EvalResults, type EvalSafetyOptions, type EvalScore, type EvalSemanticOptions, type EvalStructureOptions, type EvalSuite, type EvalSuiteConfig, ExecutionPattern, type FallbackConfig, type GoalAgentDeclaration, type GoalDependencyEdge, type GoalDependencyGraph, type GoalExecutionPlan, type GoalExplanation, type GoalExplanationStep, GoalMetrics, GoalNode, GoalPattern, type GoalPlanStep, GoalResult, type GoalValidationResult, GuardrailFn, HealthMonitor, type InformMessage, InputGuardrailData, type JSONFileStoreOptions, type MCPAdapter, type MCPAdapterConfig, type MCPApprovalRequest, type MCPCallToolRequirement, type MCPGetPromptRequirement, type MCPReadResourceRequirement, type MCPRequirement, type MCPResource, type MCPServerConfig, type MCPSyncResourcesRequirement, type MCPTool, type MCPToolConstraint, type MCPToolResult, type MermaidDirection, type MermaidNodeShapes, type MermaidOptions, Message, type MessageBus, type MessageBusConfig, type MessageFilter, type MessageHandler, type ModelRule, type ModelSelectionConfig, MultiAgentOrchestrator, OrchestratorConstraint, type OtelPlugin, type OtelPluginConfig, type OtelSpan, OtelStatusCode, type OtelTracer, OutputGuardrailData, ParallelPattern, type ParsedResponse, PatternCheckpointConfig, type PromptInjectionGuardrailOptions, type ProviderStats, type QueryMessage, type RAGChunk, type RAGEnrichOptions, type RAGEnricher, type RAGEnricherConfig, type RAGStorage, RacePattern, type RateLimitGuardrail, ReflectIterationRecord, ReflectPattern, ReflectionEvaluation, RelaxationTier, type RequestMessage, type ResponseMessage, type RetryConfig, RetryExhaustedError, type RoutingConstraint, type RoutingFacts, type RoutingProvider, RunAgentRequirement, RunOptions, RunResult, type RunnerMiddleware, type SSEEvent, type SSETransport, type SSETransportConfig, STRICT_INJECTION_PATTERNS, SchemaValidator, SequentialPattern, type SerializedDagNode, type SerializedGoalNode, type SerializedPattern, type SpanData, type SpawnOnConditionOptions, type SpawnPoolConfig, type StreamChannel, type StreamChannelConfig, type StreamChannelState, type Subscription, SupervisorPattern, type TokenPricing, ToolCallGuardrailData, type TypedAgentMessage, type UpdateMessage, type VPTreeIndexConfig, type WsTransportConfig, aggregateTokens, allReadyStrategy, byAgentName, byInputLength, byPattern, capabilityRoute, collectOutputs, composePatterns, concatResults, connectDevTools, convertToolsForLLM, costEfficientStrategy, createAgentAuditHandlers, createAgentNetwork, createAuditTrail, createBatchQueue, createBidirectionalStream, createBruteForceIndex, createCompliance, createConstraintRouter, createContentFilterGuardrail, createDelegator, createDevToolsServer, createEnhancedPIIGuardrail, createEvalSuite, createInMemoryComplianceStorage, createJSONFileStore, createLengthGuardrail, createMCPAdapter, createMessageBus, createModerationGuardrail, createOtelPlugin, createOutputPIIGuardrail, createOutputSchemaGuardrail, createOutputTypeGuardrail, createPIIGuardrail, createPromptInjectionGuardrail, createPubSub, createRAGEnricher, createRateLimitGuardrail, createResponder, createRunner, createSSETransport, createStreamChannel, createToolGuardrail, createUntrustedContentGuardrail, createVPTreeIndex, createWsTransport, dag, debate, derivedConstraint, detectPII, detectPromptInjection, estimateCost, evalAssert, evalCoherence, evalCost, evalFaithfulness, evalJudge, evalLatency, evalMatch, evalOutputLength, evalRelevance, evalSafety, evalStructure, explainGoal, findAgentsByCapability, getDependencyGraph, goal, hasPendingApprovals, highestImpactStrategy, isAgentRunning, markUntrustedContent, mcpCallTool, mcpGetPrompt, mcpReadResource, mcpSyncResources, mergeStreams, parallel, parseHttpStatus, parseRetryAfter, patternFromJSON, patternToJSON, patternToMermaid, pickBestResult, pipe, pipeThrough, planGoal, race, redactPII, reflect, runAgentRequirement, runDebate, sanitizeInjection, selectAgent, sequential, spawnOnCondition, spawnPool, supervisor, validateBaseURL, validateGoal, withBudget, withFallback, withModelSelection, withRetry };
+export { type ANNIndex, type ANNSearchResult, AdapterHooks, AgentHealthMetrics, type AgentInfo, AgentLike, type AgentMessage, type AgentMessageType, type AgentNetwork, type AgentNetworkConfig, AgentRegistry, AgentRunner, AgentSelectionStrategy, AgentState, AllProvidersFailedError, ApprovalState, type AuditEventType, type AuditInstance, type AuditPluginConfig, type BatchQueue, type BatchQueueConfig, type BidirectionalStream, type BudgetConfig, type BudgetExceededDetails, BudgetExceededError, type BudgetRunner, type BudgetWindow, CheckpointDiff, CheckpointProgress, CheckpointStore, type ComplianceConfig, type ComplianceInstance, type ComplianceStorage, type ConnectDevToolsOptions, type ConstraintRouterConfig, type ConstraintRouterRunner, type CreateRunnerOptions, DEFAULT_INJECTION_PATTERNS, DagExecutionContext, DagNode, DagPattern, type DebateConfig, DebatePattern, DebateResult, DebugEvent, DebugTimeline, type DelegationMessage, type DelegationResultMessage, type DevToolsClient, type DevToolsClientMessage, type DevToolsCompatibleOrchestrator, type DevToolsServer, type DevToolsServerConfig, type DevToolsServerMessage, type DevToolsSnapshot, type DevToolsTransport, EmbedderFn, Embedding, type EnhancedPIIGuardrailOptions, type EvalAgentSummary, type EvalAssertOptions, type EvalCase, type EvalCaseResult, type EvalContext, type EvalCostOptions, type EvalCriterion, type EvalCriterionFn, type EvalJudgeOptions, type EvalLatencyOptions, type EvalMatchOptions, type EvalOutputLengthOptions, type EvalResults, type EvalSafetyOptions, type EvalScore, type EvalSemanticOptions, type EvalStructureOptions, type EvalSuite, type EvalSuiteConfig, ExecutionPattern, type FallbackConfig, type GoalAgentDeclaration, type GoalDependencyEdge, type GoalDependencyGraph, type GoalExecutionPlan, type GoalExplanation, type GoalExplanationStep, GoalMetrics, GoalNode, GoalPattern, type GoalPlanStep, GoalResult, type GoalValidationResult, GuardrailFn, HealthMonitor, type InformMessage, InputGuardrailData, type JSONFileStoreOptions, type MCPAdapter, type MCPAdapterConfig, type MCPApprovalRequest, type MCPCallToolRequirement, type MCPGetPromptRequirement, type MCPReadResourceRequirement, type MCPRequirement, type MCPResource, type MCPServerConfig, type MCPSyncResourcesRequirement, type MCPTool, type MCPToolConstraint, type MCPToolResult, type MermaidDirection, type MermaidNodeShapes, type MermaidOptions, Message, type MessageBus, type MessageBusConfig, type MessageFilter, type MessageHandler, type ModelRule, type ModelSelectionConfig, MultiAgentOrchestrator, MultiAgentOrchestratorOptions, OrchestratorConstraint, type OtelPlugin, type OtelPluginConfig, type OtelSpan, OtelStatusCode, type OtelTracer, OutputGuardrailData, ParallelPattern, type ParsedResponse, PatternCheckpointConfig, PatternCheckpointState, type PromptInjectionGuardrailOptions, type ProviderStats, type QueryMessage, type RAGChunk, type RAGEnrichOptions, type RAGEnricher, type RAGEnricherConfig, type RAGStorage, RacePattern, type RateLimitGuardrail, ReflectIterationRecord, ReflectPattern, ReflectionEvaluation, RelaxationTier, type RequestMessage, type ResponseMessage, type RetryConfig, RetryExhaustedError, type RoutingConstraint, type RoutingFacts, type RoutingProvider, RunAgentRequirement, RunOptions, RunResult, type RunnerMiddleware, type SSEEvent, type SSETransport, type SSETransportConfig, STRICT_INJECTION_PATTERNS, SchemaValidator, Semaphore, SequentialPattern, type SerializedDagNode, type SerializedGoalNode, type SerializedPattern, type SpanData, type SpawnOnConditionOptions, type SpawnPoolConfig, type StreamChannel, type StreamChannelConfig, type StreamChannelState, type Subscription, SupervisorPattern, type TokenPricing, ToolCallGuardrailData, type TypedAgentMessage, type UpdateMessage, type VPTreeIndexConfig, type WsTransportConfig, aggregateTokens, allReadyStrategy, byAgentName, byInputLength, byPattern, capabilityRoute, collectOutputs, composePatterns, concatResults, connectDevTools, convertToolsForLLM, costEfficientStrategy, createAgentAuditHandlers, createAgentNetwork, createAuditTrail, createBatchQueue, createBidirectionalStream, createBruteForceIndex, createCompliance, createConstraintRouter, createContentFilterGuardrail, createDelegator, createDevToolsServer, createEnhancedPIIGuardrail, createEvalSuite, createInMemoryComplianceStorage, createJSONFileStore, createLengthGuardrail, createMCPAdapter, createMessageBus, createModerationGuardrail, createMultiAgentOrchestrator, createOtelPlugin, createOutputPIIGuardrail, createOutputSchemaGuardrail, createOutputTypeGuardrail, createPIIGuardrail, createPromptInjectionGuardrail, createPubSub, createRAGEnricher, createRateLimitGuardrail, createResponder, createRunner, createSSETransport, createStreamChannel, createToolGuardrail, createUntrustedContentGuardrail, createVPTreeIndex, createWsTransport, dag, debate, derivedConstraint, detectPII, detectPromptInjection, diffCheckpoints, estimateCost, evalAssert, evalCoherence, evalCost, evalFaithfulness, evalJudge, evalLatency, evalMatch, evalOutputLength, evalRelevance, evalSafety, evalStructure, explainGoal, findAgentsByCapability, forkFromCheckpoint, getCheckpointProgress, getDependencyGraph, getPatternStep, goal, hasPendingApprovals, highestImpactStrategy, isAgentRunning, markUntrustedContent, mcpCallTool, mcpGetPrompt, mcpReadResource, mcpSyncResources, mergeStreams, parallel, parseHttpStatus, parseRetryAfter, patternFromJSON, patternToJSON, patternToMermaid, pickBestResult, pipe, pipeThrough, planGoal, race, redactPII, reflect, runAgentRequirement, runDebate, sanitizeInjection, selectAgent, sequential, spawnOnCondition, spawnPool, supervisor, validateBaseURL, validateGoal, withBudget, withFallback, withModelSelection, withRetry };