@directive-run/ai 0.8.5 → 0.8.7

package/dist/{multi-agent-orchestrator-C3VKkLzg.d.cts → orchestrator-types-tATJCBi5.d.cts}

@@ -1,4 +1,4 @@
-import { M as Message$1, k as RunResult, A as AgentLike, G as GuardrailFn, O as OutputGuardrailData, aX as StreamingCallbackRunner, n as DebugEvent, a7 as DebugEventType, b as AgentRunner, ay as OrchestratorState, at as NamedGuardrail, I as InputGuardrailData, N as Checkpoint, F as BreakpointModifications, H as BreakpointRequest, l as OrchestratorConstraint, aw as OrchestratorResolver, ai as GuardrailsConfig, w as ApprovalRequest, au as OrchestratorDebugConfig, t as AgentRetryConfig, av as OrchestratorLifecycleHooks, aU as SelfHealingConfig, Z as CheckpointStore, z as BreakpointConfig, al as HealthMonitorConfig, m as RunOptions, T as ToolCallGuardrailData, P as PatternCheckpointConfig, g as DagPattern, j as GoalPattern, h as GoalNode, e as AgentSelectionStrategy, R as RelaxationTier, o as GoalResult, aa as GoalCheckpointState, aV as SequentialCheckpointState, aY as SupervisorCheckpointState, aG as ReflectCheckpointState, a4 as DebateCheckpointState, a1 as DagCheckpointState, aS as Scratchpad, ar as MultiAgentLifecycleHooks, as as MultiAgentSelfHealingConfig, ap as MultiAgentBreakpointType, $ as CrossAgentDerivationFn, aA as PatternCheckpointState, U as CheckpointDiff, W as CheckpointProgress } from './types-BM-6xZf_.cjs';
+import { M as Message$1, n as RunResult, A as AgentLike, G as GuardrailFn, O as OutputGuardrailData, aX as StreamingCallbackRunner, q as DebugEvent, a8 as DebugEventType, b as AgentRunner, az as OrchestratorState, au as NamedGuardrail, I as InputGuardrailData, W as Checkpoint, L as BreakpointModifications, N as BreakpointRequest, o as OrchestratorConstraint, ax as OrchestratorResolver, aj as GuardrailsConfig, z as ApprovalRequest, av as OrchestratorDebugConfig, w as AgentRetryConfig, aw as OrchestratorLifecycleHooks, aU as SelfHealingConfig, e as CheckpointStore, H as BreakpointConfig, am as HealthMonitorConfig, p as RunOptions, T as ToolCallGuardrailData, l as PatternCheckpointConfig, i as DagPattern, m as GoalPattern, j as GoalNode, g as AgentSelectionStrategy, R as RelaxationTier, r as GoalResult, ab as GoalCheckpointState, aV as SequentialCheckpointState, aY as SupervisorCheckpointState, aG as ReflectCheckpointState, a5 as DebateCheckpointState, a2 as DagCheckpointState, aS as Scratchpad, as as MultiAgentLifecycleHooks, at as MultiAgentSelfHealingConfig, aq as MultiAgentBreakpointType, a0 as CrossAgentDerivationFn } from './types-CRmwFnVk.cjs';
 import { Plugin, System, Requirement } from '@directive-run/core';
 import { CircuitBreaker } from '@directive-run/core/plugins';
 
@@ -998,8 +998,8 @@ interface AgentOrchestrator<F extends Record<string, unknown>> {
     cancelBreakpoint(id: string, reason?: string): void;
     /** Get all currently pending breakpoint requests. */
     getPendingBreakpoints(): BreakpointRequest[];
-    /** Dispose of the orchestrator */
-    dispose(): void;
+    /** Destroy the orchestrator, releasing all resources. */
+    destroy(): void;
 }
 /**
  * Create a constraint-driven agent orchestrator backed by a Directive System.
@@ -1208,97 +1208,6 @@ declare class ReflectionExhaustedError extends Error {
  */
 declare function withReflection<T = unknown>(runner: AgentRunner, config: ReflectionConfig<T>): AgentRunner;
 
-/**
- * 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>;
-/**
- * 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;
-}
 /** Configuration for a registered agent */
 interface AgentRegistration {
     /** The agent instance */
@@ -1854,53 +1763,8 @@ interface MultiAgentOrchestrator {
     onDerivedChange(callback: (id: string, value: unknown) => void): () => void;
     /** Shared scratchpad (null when not configured) */
     readonly scratchpad: Scratchpad | null;
-    /** Dispose of the orchestrator, resetting all state */
-    dispose(): void;
+    /** Destroy the orchestrator, resetting all state and releasing resources. */
+    destroy(): void;
 }
-/**
- * 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;
 
-export { type SafeParseResult as $, type AgentRegistry as A, type BackpressureStrategy as B, type MessageSummarizer as C, type DebatePattern as D, type ExecutionPattern as E, type MultiAgentOrchestratorOptions as F, type GuardrailTriggeredChunk as G, type HealthMonitor as H, type MultiAgentRunCallOptions as I, type MultiAgentState as J, type MultiplexedStreamChunk as K, type MultiplexedStreamResult as L, type MultiAgentOrchestrator as M, type OrchestratorStreamChunk as N, type OrchestratorOptions as O, type ParallelPattern as P, type OrchestratorStreamResult as Q, type RacePattern as R, type SequentialPattern as S, type ProgressChunk as T, type RaceResult as U, type RaceSuccessEntry as V, type ReflectionConfig as W, type ReflectionContext as X, type ReflectionEvaluator as Y, ReflectionExhaustedError as Z, type RunCallOptions as _, type ReflectionEvaluation as a, type SafeParseable as a0, Semaphore as a1, type StreamChunk as a2, type StreamRunOptions as a3, type StreamRunner as a4, type StreamingGuardrail as a5, type StreamingGuardrailResult as a6, type StreamingRunResult as a7, type StructuredOutputConfig as a8, StructuredOutputError as a9, filterStream as aA, forkFromCheckpoint as aB, getCheckpointProgress as aC, getPatternStep as aD, mapStream as aE, mergeTaggedStreams as aF, tapStream as aG, withReflection as aH, withStructuredOutput as aI, type TaskContext as aa, type TaskRegistration as ab, type TokenChunk as ac, type ToolEndChunk as ad, type ToolStartChunk as ae, adaptOutputGuardrail as af, collectTokens as ag, combineStreamingGuardrails as ah, createAgentMemory as ai, createAgentOrchestrator as aj, createDebugTimeline as ak, createDebugTimelinePlugin as al, createHealthMonitor as am, createHybridStrategy as an, createKeyPointsSummarizer as ao, createLLMSummarizer as ap, createLengthStreamingGuardrail as aq, createMultiAgentOrchestrator as ar, createPatternStreamingGuardrail as as, createSlidingWindowStrategy as at, createStreamingRunner as au, createTokenBasedStrategy as av, createToxicityStreamingGuardrail as aw, createTruncationSummarizer as ax, diffCheckpoints as ay, extractJsonFromOutput as az, type ReflectIterationRecord as b, type ReflectPattern as c, type SupervisorPattern as d, type RunAgentRequirement as e, type DebateResult as f, type AgentHealthMetrics as g, type DebugTimeline as h, type AgentMemory as i, type AgentMemoryConfig as j, type AgentOrchestrator as k, type AgentRegistration as l, type DebugTimelineListener as m, type DebugTimelineOptions as n, type DoneChunk as o, type ErrorChunk as p, type HandoffRequest as q, type HandoffResult as r, type HealthCircuitState as s, type MemoryManageResult as t, type MemoryState as u, type MemoryStrategy as v, type MemoryStrategyConfig as w, type MemoryStrategyResult as x, type MergedTaggedStreamResult as y, type MessageChunk as z };
+export { type SafeParseResult as $, type AgentRegistry as A, type BackpressureStrategy as B, type MessageChunk as C, type DebatePattern as D, type ExecutionPattern as E, type MessageSummarizer as F, type GuardrailTriggeredChunk as G, type HealthMonitor as H, type MultiAgentRunCallOptions as I, type MultiAgentState as J, type MultiplexedStreamChunk as K, type MultiplexedStreamResult as L, type MultiAgentOrchestratorOptions as M, type OrchestratorStreamChunk as N, type OrchestratorOptions as O, type ParallelPattern as P, type OrchestratorStreamResult as Q, type RacePattern as R, type SequentialPattern as S, type ProgressChunk as T, type RaceResult as U, type RaceSuccessEntry as V, type ReflectionConfig as W, type ReflectionContext as X, type ReflectionEvaluator as Y, ReflectionExhaustedError as Z, type RunCallOptions as _, type MultiAgentOrchestrator as a, type SafeParseable as a0, type StreamChunk as a1, type StreamRunOptions as a2, type StreamRunner as a3, type StreamingGuardrail as a4, type StreamingGuardrailResult as a5, type StreamingRunResult as a6, type StructuredOutputConfig as a7, StructuredOutputError as a8, type TaskContext as a9, tapStream as aA, withReflection as aB, withStructuredOutput as aC, type TaskRegistration as aa, type TokenChunk as ab, type ToolEndChunk as ac, type ToolStartChunk as ad, adaptOutputGuardrail as ae, collectTokens as af, combineStreamingGuardrails as ag, createAgentMemory as ah, createAgentOrchestrator as ai, createDebugTimeline as aj, createDebugTimelinePlugin as ak, createHealthMonitor as al, createHybridStrategy as am, createKeyPointsSummarizer as an, createLLMSummarizer as ao, createLengthStreamingGuardrail as ap, createPatternStreamingGuardrail as aq, createSlidingWindowStrategy as ar, createStreamingRunner as as, createTokenBasedStrategy as at, createToxicityStreamingGuardrail as au, createTruncationSummarizer as av, extractJsonFromOutput as aw, filterStream as ax, mapStream as ay, mergeTaggedStreams as az, type ReflectionEvaluation as b, type ReflectIterationRecord as c, type ReflectPattern as d, type SupervisorPattern as e, type RunAgentRequirement as f, type DebateResult as g, type AgentHealthMetrics as h, type DebugTimeline as i, type AgentMemory as j, type AgentMemoryConfig as k, type AgentOrchestrator as l, type AgentRegistration as m, type DebugTimelineListener as n, type DebugTimelineOptions as o, type DoneChunk as p, type ErrorChunk as q, type HandoffRequest as r, type HandoffResult as s, type HealthCircuitState as t, type MemoryManageResult as u, type MemoryState as v, type MemoryStrategy as w, type MemoryStrategyConfig as x, type MemoryStrategyResult as y, type MergedTaggedStreamResult as z };

package/dist/{semantic-cache-F0psCRuz.d.cts → semantic-cache-nBpQqILc.d.cts}

@@ -223,20 +223,20 @@ declare function createSemanticCacheGuardrail(config: {
  * NOT suitable for production - use a real embedding model.
  */
 declare function createTestEmbedder(dimensions?: number): EmbedderFn;
-/** Batched embedder instance with dispose capability */
+/** Batched embedder instance with destroy capability */
 interface BatchedEmbedder {
     /** Embed a single text (batched internally) */
     embed: EmbedderFn;
     /** Flush any pending batch immediately */
     flush(): Promise<void>;
-    /** Dispose of the embedder, clearing timers and rejecting pending requests */
-    dispose(): void;
+    /** Destroy the embedder, clearing timers and rejecting pending requests */
+    destroy(): void;
 }
 /**
  * Create a batched embedder that groups multiple texts into single API calls.
  *
  * **BREAKING CHANGE:** Previously returned `EmbedderFn` directly. Now returns
- * a `BatchedEmbedder` object with `embed`, `flush`, and `dispose` methods.
+ * a `BatchedEmbedder` object with `embed`, `flush`, and `destroy` methods.
  *
  * To migrate: `const embed = createBatchedEmbedder(...)` becomes
  * `const { embed } = createBatchedEmbedder(...)`.
@@ -259,7 +259,7 @@ interface BatchedEmbedder {
  * const embedding = await batchedEmbedder.embed("Hello world");
  *
  * // Clean up when done
- * batchedEmbedder.dispose();
+ * batchedEmbedder.destroy();
  * ```
  */
 declare function createBatchedEmbedder(config: {

package/dist/{semantic-cache-F0psCRuz.d.ts → semantic-cache-nBpQqILc.d.ts}

@@ -223,20 +223,20 @@ declare function createSemanticCacheGuardrail(config: {
  * NOT suitable for production - use a real embedding model.
  */
 declare function createTestEmbedder(dimensions?: number): EmbedderFn;
-/** Batched embedder instance with dispose capability */
+/** Batched embedder instance with destroy capability */
 interface BatchedEmbedder {
     /** Embed a single text (batched internally) */
     embed: EmbedderFn;
     /** Flush any pending batch immediately */
     flush(): Promise<void>;
-    /** Dispose of the embedder, clearing timers and rejecting pending requests */
-    dispose(): void;
+    /** Destroy the embedder, clearing timers and rejecting pending requests */
+    destroy(): void;
 }
 /**
  * Create a batched embedder that groups multiple texts into single API calls.
  *
  * **BREAKING CHANGE:** Previously returned `EmbedderFn` directly. Now returns
- * a `BatchedEmbedder` object with `embed`, `flush`, and `dispose` methods.
+ * a `BatchedEmbedder` object with `embed`, `flush`, and `destroy` methods.
  *
  * To migrate: `const embed = createBatchedEmbedder(...)` becomes
  * `const { embed } = createBatchedEmbedder(...)`.
@@ -259,7 +259,7 @@ interface BatchedEmbedder {
  * const embedding = await batchedEmbedder.embed("Hello world");
  *
  * // Clean up when done
- * batchedEmbedder.dispose();
+ * batchedEmbedder.destroy();
  * ```
  */
 declare function createBatchedEmbedder(config: {