@warlock.js/ai 4.2.11 → 4.4.0

package/esm/eval/scorers.mjs

@@ -0,0 +1,101 @@
+//#region ../@warlock.js/ai/src/eval/scorers.ts
+/**
+* Normalize a value for case-insensitive, whitespace-trimmed string
+* comparison. Non-string values are JSON-serialized first so a
+* structured `expected` can still be matched against structured
+* `output`.
+*/
+function normalizeForComparison(value) {
+	return (typeof value === "string" ? value : JSON.stringify(value)).trim().toLowerCase();
+}
+/**
+* Exact-match scorer. Compares the agent's output against the case's
+* `expected` reference. Prefers `result.data` (parsed structured
+* output) when present, falling back to `result.text`. Comparison is
+* trimmed and case-insensitive; structured values are compared by
+* canonical JSON.
+*
+* Scores `1` / `passed: true` on a match, `0` / `passed: false`
+* otherwise. A case with no `expected` always scores `0` — exact
+* matching is meaningless without a reference.
+*
+* @example
+* const report = await agent.eval({
+*   cases: [{ name: "q", input: "2+2?", expected: "4" }],
+*   scorers: [exact()],
+* });
+*/
+function exact() {
+	return (context) => {
+		if (context.case.expected === void 0) return {
+			score: 0,
+			passed: false,
+			reason: "no expected value supplied for exact match"
+		};
+		const actual = context.output ?? context.text;
+		if (actual === void 0) return {
+			score: 0,
+			passed: false,
+			reason: "agent produced no output"
+		};
+		const matches = normalizeForComparison(actual) === normalizeForComparison(context.case.expected);
+		return {
+			score: matches ? 1 : 0,
+			passed: matches,
+			reason: matches ? "exact match" : "output did not match expected"
+		};
+	};
+}
+/**
+* Substring / contains scorer. Passes when the normalized `expected`
+* string appears anywhere in the agent's normalized output. Useful
+* when the agent's phrasing varies but a key fact must be present.
+*
+* @example
+* scorers: [contains()] // expected "Cairo" passes "The capital is Cairo."
+*/
+function contains() {
+	return (context) => {
+		if (context.case.expected === void 0) return {
+			score: 0,
+			passed: false,
+			reason: "no expected value supplied for contains match"
+		};
+		const actual = context.output ?? context.text;
+		if (actual === void 0) return {
+			score: 0,
+			passed: false,
+			reason: "agent produced no output"
+		};
+		const found = normalizeForComparison(actual).includes(normalizeForComparison(context.case.expected));
+		return {
+			score: found ? 1 : 0,
+			passed: found,
+			reason: found ? "expected substring found" : "expected substring not found"
+		};
+	};
+}
+/**
+* Predicate scorer. Wraps a boolean-returning callback into a scorer —
+* `true` scores `1` / `passed`, `false` scores `0` / fails. The
+* escape hatch for arbitrary assertions ("output is valid JSON", "no
+* tool errored", "duration under budget") that don't fit exact or
+* judge scoring.
+*
+* @example
+* scorers: [predicate((ctx) => ctx.result.report.children.every(c => c.status === "completed"))]
+*/
+function predicate(fn) {
+	return async (context) => {
+		const result = await fn(context);
+		return {
+			score: result ? 1 : 0,
+			passed: result,
+			reason: result ? "predicate passed" : "predicate failed"
+		};
+	};
+}
+
+//#endregion
+export { contains, exact, predicate };
+//# sourceMappingURL=scorers.mjs.map

package/esm/eval/scorers.mjs.map

@@ -0,0 +1 @@
+{"version":3,"file":"scorers.mjs","names":[],"sources":["../../../../../../../@warlock.js/ai/src/eval/scorers.ts"],"sourcesContent":["import type {\n  EvalScore,\n  EvalScorer,\n  EvalScorerContext,\n} from \"../contracts/agent/eval.type\";\n\n/**\n * Predicate signature for {@link predicate}. Receives the same context\n * a full scorer does and returns a boolean (sync or async). A `true`\n * verdict scores `1`, `false` scores `0`.\n */\nexport type EvalPredicate<TOutput = unknown> = (\n  context: EvalScorerContext<TOutput>,\n) => boolean | Promise<boolean>;\n\n/**\n * Normalize a value for case-insensitive, whitespace-trimmed string\n * comparison. Non-string values are JSON-serialized first so a\n * structured `expected` can still be matched against structured\n * `output`.\n */\nfunction normalizeForComparison(value: unknown): string {\n  const text = typeof value === \"string\" ? value : JSON.stringify(value);\n  return text.trim().toLowerCase();\n}\n\n/**\n * Exact-match scorer. Compares the agent's output against the case's\n * `expected` reference. Prefers `result.data` (parsed structured\n * output) when present, falling back to `result.text`. Comparison is\n * trimmed and case-insensitive; structured values are compared by\n * canonical JSON.\n *\n * Scores `1` / `passed: true` on a match, `0` / `passed: false`\n * otherwise. A case with no `expected` always scores `0` — exact\n * matching is meaningless without a reference.\n *\n * @example\n * const report = await agent.eval({\n *   cases: [{ name: \"q\", input: \"2+2?\", expected: \"4\" }],\n *   scorers: [exact()],\n * });\n */\nexport function exact<TOutput = unknown>(): EvalScorer<TOutput> {\n  return (context: EvalScorerContext<TOutput>): EvalScore => {\n    if (context.case.expected === undefined) {\n      return {\n        score: 0,\n        passed: false,\n        reason: \"no expected value supplied for exact match\",\n      };\n    }\n\n    const actual = context.output ?? context.text;\n\n    if (actual === undefined) {\n      return { score: 0, passed: false, reason: \"agent produced no output\" };\n    }\n\n    const matches =\n      normalizeForComparison(actual) === normalizeForComparison(context.case.expected);\n\n    return {\n      score: matches ? 1 : 0,\n      passed: matches,\n      reason: matches ? \"exact match\" : \"output did not match expected\",\n    };\n  };\n}\n\n/**\n * Substring / contains scorer. Passes when the normalized `expected`\n * string appears anywhere in the agent's normalized output. Useful\n * when the agent's phrasing varies but a key fact must be present.\n *\n * @example\n * scorers: [contains()] // expected \"Cairo\" passes \"The capital is Cairo.\"\n */\nexport function contains<TOutput = unknown>(): EvalScorer<TOutput> {\n  return (context: EvalScorerContext<TOutput>): EvalScore => {\n    if (context.case.expected === undefined) {\n      return {\n        score: 0,\n        passed: false,\n        reason: \"no expected value supplied for contains match\",\n      };\n    }\n\n    const actual = context.output ?? context.text;\n\n    if (actual === undefined) {\n      return { score: 0, passed: false, reason: \"agent produced no output\" };\n    }\n\n    const found = normalizeForComparison(actual).includes(\n      normalizeForComparison(context.case.expected),\n    );\n\n    return {\n      score: found ? 1 : 0,\n      passed: found,\n      reason: found ? \"expected substring found\" : \"expected substring not found\",\n    };\n  };\n}\n\n/**\n * Predicate scorer. Wraps a boolean-returning callback into a scorer —\n * `true` scores `1` / `passed`, `false` scores `0` / fails. The\n * escape hatch for arbitrary assertions (\"output is valid JSON\", \"no\n * tool errored\", \"duration under budget\") that don't fit exact or\n * judge scoring.\n *\n * @example\n * scorers: [predicate((ctx) => ctx.result.report.children.every(c => c.status === \"completed\"))]\n */\nexport function predicate<TOutput = unknown>(\n  fn: EvalPredicate<TOutput>,\n): EvalScorer<TOutput> {\n  return async (context: EvalScorerContext<TOutput>): Promise<EvalScore> => {\n    const result = await fn(context);\n\n    return {\n      score: result ? 1 : 0,\n      passed: result,\n      reason: result ? \"predicate passed\" : \"predicate failed\",\n    };\n  };\n}\n"],"mappings":";;;;;;;AAqBA,SAAS,uBAAuB,OAAwB;CAEtD,QADa,OAAO,UAAU,WAAW,QAAQ,KAAK,UAAU,KAAK,EAC1D,CAAC,KAAK,CAAC,CAAC,YAAY;AACjC;;;;;;;;;;;;;;;;;;AAmBA,SAAgB,QAAgD;CAC9D,QAAQ,YAAmD;EACzD,IAAI,QAAQ,KAAK,aAAa,QAC5B,OAAO;GACL,OAAO;GACP,QAAQ;GACR,QAAQ;EACV;EAGF,MAAM,SAAS,QAAQ,UAAU,QAAQ;EAEzC,IAAI,WAAW,QACb,OAAO;GAAE,OAAO;GAAG,QAAQ;GAAO,QAAQ;EAA2B;EAGvE,MAAM,UACJ,uBAAuB,MAAM,MAAM,uBAAuB,QAAQ,KAAK,QAAQ;EAEjF,OAAO;GACL,OAAO,UAAU,IAAI;GACrB,QAAQ;GACR,QAAQ,UAAU,gBAAgB;EACpC;CACF;AACF;;;;;;;;;AAUA,SAAgB,WAAmD;CACjE,QAAQ,YAAmD;EACzD,IAAI,QAAQ,KAAK,aAAa,QAC5B,OAAO;GACL,OAAO;GACP,QAAQ;GACR,QAAQ;EACV;EAGF,MAAM,SAAS,QAAQ,UAAU,QAAQ;EAEzC,IAAI,WAAW,QACb,OAAO;GAAE,OAAO;GAAG,QAAQ;GAAO,QAAQ;EAA2B;EAGvE,MAAM,QAAQ,uBAAuB,MAAM,CAAC,CAAC,SAC3C,uBAAuB,QAAQ,KAAK,QAAQ,CAC9C;EAEA,OAAO;GACL,OAAO,QAAQ,IAAI;GACnB,QAAQ;GACR,QAAQ,QAAQ,6BAA6B;EAC/C;CACF;AACF;;;;;;;;;;;AAYA,SAAgB,UACd,IACqB;CACrB,OAAO,OAAO,YAA4D;EACxE,MAAM,SAAS,MAAM,GAAG,OAAO;EAE/B,OAAO;GACL,OAAO,SAAS,IAAI;GACpB,QAAQ;GACR,QAAQ,SAAS,qBAAqB;EACxC;CACF;AACF"}

package/esm/index.d.mts

@@ -21,8 +21,10 @@ import { ExecuteResult } from "./contracts/result/execute-result.type.mjs";
 import { ExecutableContract } from "./contracts/executable.contract.mjs";
 import { StreamEvent, StreamEventBody } from "./contracts/stream/stream-event.type.mjs";
 import { StreamContract } from "./contracts/stream/stream.contract.mjs";
+import { EvalCase, EvalCaseResult, EvalJudge, EvalOptions, EvalReport, EvalScore, EvalScorer, EvalScorerContext } from "./contracts/agent/eval.type.mjs";
 import { AgentContract, AgentEventHandler } from "./contracts/agent/agent.contract.mjs";
 import { END, EndSentinel } from "./contracts/end.type.mjs";
+import { SupervisorReport, SupervisorResult, SupervisorTerminatedBy } from "./contracts/result/supervisor-result.type.mjs";
 import { StepSnapshot } from "./contracts/result/step-result.type.mjs";
 import { WorkflowReport, WorkflowResult } from "./contracts/result/workflow-result.type.mjs";
 import { ToolConfig, ToolContext, ToolMeta, ToolMode } from "./contracts/tool.contract.mjs";
@@ -39,6 +41,13 @@ import { SupervisorFailedError } from "./errors/supervisor-failed-error.mjs";
 import { MaxIterationsError, MaxIterationsErrorOptions } from "./errors/max-iterations-error.mjs";
 import { WorkflowError } from "./errors/workflow-error.mjs";
 import { MaxStepsExceededError, MaxStepsExceededErrorOptions } from "./errors/max-steps-exceeded-error.mjs";
+import { OrchestratorFailedError } from "./errors/orchestrator-failed-error.mjs";
+import { OrchestratorCancelledError, OrchestratorCancelledErrorOptions } from "./errors/orchestrator-cancelled-error.mjs";
+import { OrchestratorConfigError } from "./errors/orchestrator-config-error.mjs";
+import { OrchestratorDriftError, OrchestratorDriftErrorOptions } from "./errors/orchestrator-drift-error.mjs";
+import { PlannerFailedError } from "./errors/planner-failed-error.mjs";
+import { PlannerCancelledError, PlannerCancelledErrorOptions } from "./errors/planner-cancelled-error.mjs";
+import { PlannerPlanInvalidError } from "./errors/planner-plan-invalid-error.mjs";
 import { ProviderAuthError } from "./errors/provider-auth-error.mjs";
 import { ProviderRateLimitError, ProviderRateLimitErrorOptions } from "./errors/provider-rate-limit-error.mjs";
 import { ProviderTimeoutError } from "./errors/provider-timeout-error.mjs";
@@ -53,76 +62,128 @@ import { ToolExecutionError, ToolExecutionErrorOptions } from "./errors/tool-exe
 import { WorkflowCancelledError, WorkflowCancelledErrorOptions } from "./errors/workflow-cancelled-error.mjs";
 import { WorkflowDriftError, WorkflowDriftErrorOptions } from "./errors/workflow-drift-error.mjs";
 import { ToolContract, ToolInvokeResult, tool } from "./tool/tool.mjs";
+import { SupervisorInput } from "./contracts/supervisor/supervisor-input.type.mjs";
+import { SupervisorSnapshot, SupervisorSnapshotStatus } from "./contracts/supervisor/supervisor-snapshot.type.mjs";
+import { PgClientLike, RedisClientLike, SnapshotStore } from "./contracts/orchestrator/snapshot-store.contract.mjs";
 import { NextStepResult } from "./contracts/workflow/next-step-result.type.mjs";
 import { RetryBackoff, RetryConfig } from "./contracts/workflow/retry-config.type.mjs";
 import { WorkflowContext } from "./contracts/workflow/workflow-context.type.mjs";
 import { StepAgentInput, StepDefinition, StepLocalEvents, StepOutputSpec } from "./contracts/workflow/step.contract.mjs";
+import { WorkflowSnapshot } from "./contracts/workflow/workflow-snapshot.type.mjs";
 import { WorkflowDefinition, WorkflowEventHandler, WorkflowEventHandlers, WorkflowExecuteOptions, WorkflowInstance, WorkflowResumeOptions, WorkflowRunOptions } from "./contracts/workflow/workflow.contract.mjs";
+import { AgentToolEntry, ExecutableTool, executableToTool, isExecutableTool, normalizeAgentTools } from "./tool/executable-as-tool.mjs";
+import { ModelCallOptions, ModelCapabilities, ModelContract, ModelResponse, ModelStreamChunk, ReasoningEffort } from "./contracts/model.contract.mjs";
+import { SupervisorExecuteOptions, SupervisorResumeOptions } from "./contracts/supervisor/supervisor-execute-options.type.mjs";
+import { MiddlewareState } from "./contracts/middleware/middleware-state.type.mjs";
+import { MiddlewareAgentRef, MiddlewareExecuteContext, MiddlewareModelRef, MiddlewareSupervisorContext, MiddlewareSupervisorRef, MiddlewareToolContext, MiddlewareTripContext } from "./contracts/middleware/middleware-context.type.mjs";
+import { AgentMiddleware, AgentMiddlewareExecuteHooks, AgentMiddlewareSupervisorHooks, AgentMiddlewareToolHooks, AgentMiddlewareTripHooks } from "./contracts/middleware/middleware.contract.mjs";
 import { Placeholders } from "./contracts/placeholders.type.mjs";
 import { InstructionContract, PersonaContract, SystemPromptBlockContract, SystemPromptContract } from "./contracts/system-prompt.contract.mjs";
-import { Next } from "./contracts/supervisor/next.type.mjs";
-import { AckSnapshot, AgentBranchSnapshot, DecisionSource, IterationDecision, IterationSnapshot } from "./contracts/supervisor/iteration-snapshot.type.mjs";
-import { SupervisorInput } from "./contracts/supervisor/supervisor-input.type.mjs";
-import { EvaluateBranchResult, EvaluateContext, EvaluateResult } from "./contracts/supervisor/evaluate-context.type.mjs";
 import { RouteContext } from "./contracts/supervisor/route-context.type.mjs";
 import { AckCallback, AckConfig, AckEntry, AckRunEntry } from "./contracts/supervisor/ack-entry.type.mjs";
 import { DispatchRawResult, IntentCallback, IntentEntry, IntentRunEntry, SupervisorIntentValue } from "./contracts/supervisor/intent-entry.type.mjs";
+import { Next } from "./contracts/supervisor/next.type.mjs";
 import { RouterEntry } from "./contracts/supervisor/router-entry.type.mjs";
 import { SupervisorConfig, SupervisorEventHandler, SupervisorEventHandlers } from "./contracts/supervisor/supervisor-config.type.mjs";
-import { SupervisorExecuteOptions, SupervisorResumeOptions } from "./contracts/supervisor/supervisor-execute-options.type.mjs";
 import { SupervisorStreamEvent } from "./contracts/supervisor/supervisor-stream-event.type.mjs";
 import { SupervisorAsToolOptions, SupervisorContract } from "./contracts/supervisor/supervisor.contract.mjs";
 import { DispatchContext, IntentRunner, IntentRunnerMap } from "./contracts/supervisor/dispatch-context.type.mjs";
 import { ClassifierAgentEntry, ClassifierCallback, ClassifierConfig, ClassifierContext, ClassifierOutput, ClassifierRefineContext, ClassifierRefineResult, ClassifierRunEntry, ClassifierSnapshot } from "./contracts/supervisor/classifier-context.type.mjs";
-import { SupervisorReport, SupervisorResult, SupervisorTerminatedBy } from "./contracts/result/supervisor-result.type.mjs";
+import { EvaluateBranchResult, EvaluateContext, EvaluateResult } from "./contracts/supervisor/evaluate-context.type.mjs";
+import { AckSnapshot, AgentBranchSnapshot, DecisionSource, IterationDecision, IterationSnapshot } from "./contracts/supervisor/iteration-snapshot.type.mjs";
+import { CompactionResult, OrchestratorAwaitingStatus, OrchestratorReport, OrchestratorReportStatus, OrchestratorReportType, OrchestratorResult, TurnSnapshot } from "./contracts/result/orchestrator-result.type.mjs";
 import { SessionSendResult } from "./contracts/result/session-send-result.type.mjs";
-import { SupervisorSnapshot, SupervisorSnapshotStatus } from "./contracts/supervisor/supervisor-snapshot.type.mjs";
 import { SupervisorAgentCompletedPayload, SupervisorAgentFailedPayload, SupervisorAgentStartingPayload, SupervisorAgentStreamingPayload, SupervisorCancelledPayload, SupervisorCompletedPayload, SupervisorErrorPayload, SupervisorEvaluateVerdictPayload, SupervisorIterationCompletedPayload, SupervisorIterationStartingPayload, SupervisorRouterDecidedPayload, SupervisorRouterDecidingPayload, SupervisorStartingPayload } from "./contracts/events/supervisor-events.type.mjs";
 import { WorkflowCancelledPayload, WorkflowCompletedPayload, WorkflowErrorPayload, WorkflowLoopWarningPayload, WorkflowStartingPayload, WorkflowStepCompletedPayload, WorkflowStepFailedPayload, WorkflowStepRetryingPayload, WorkflowStepSkippedPayload, WorkflowStepStartingPayload, WorkflowStepStreamingPayload } from "./contracts/events/workflow-events.type.mjs";
 import { AgentEventMap, SupervisorEventMap, WorkflowEventMap } from "./contracts/events/event-map.type.mjs";
 import { StreamingToolGuardConfig } from "./contracts/streaming-tool-guard-config.type.mjs";
 import { AgentExecuteOptions } from "./contracts/agent/agent-options.type.mjs";
 import { EmbedderConfig, EmbedderContract, EmbeddingBatchResult, EmbeddingResult, EmbeddingUsage } from "./contracts/embedder.contract.mjs";
-import { MiddlewareState } from "./contracts/middleware/middleware-state.type.mjs";
-import { MiddlewareAgentRef, MiddlewareExecuteContext, MiddlewareModelRef, MiddlewareToolContext, MiddlewareTripContext } from "./contracts/middleware/middleware-context.type.mjs";
-import { ModelCallOptions, ModelCapabilities, ModelContract, ModelResponse, ModelStreamChunk } from "./contracts/model.contract.mjs";
-import { AgentMiddleware, AgentMiddlewareExecuteHooks, AgentMiddlewareToolHooks, AgentMiddlewareTripHooks } from "./contracts/middleware/middleware.contract.mjs";
+import { MemoryItem, MemoryTier, RecalledMemory } from "./contracts/memory/memory-item.type.mjs";
+import { RecallOptions } from "./contracts/memory/recall-options.type.mjs";
+import { MemoryContract } from "./contracts/memory/memory.contract.mjs";
+import { EpisodicMemoryConfig, MemoryConfig, ProceduralMemoryConfig, SemanticMemoryConfig } from "./contracts/memory/memory-config.type.mjs";
+import { CheckpointRecord, CheckpointStore } from "./contracts/orchestrator/checkpoint-store.contract.mjs";
+import { OrchestratorCommands } from "./contracts/orchestrator/orchestrator-commands.type.mjs";
+import { OrchestratorEvent, OrchestratorEventHandler, OrchestratorEventHandlers, OrchestratorEventMap, OrchestratorEventName } from "./contracts/orchestrator/orchestrator-event.type.mjs";
+import { OrchestratorExecuteOptions, OrchestratorResumeOptions } from "./contracts/orchestrator/orchestrator-execute-options.type.mjs";
+import { OrchestratorAsToolOptions, OrchestratorContract, OrchestratorSessionScope, SessionContextOverrides } from "./contracts/orchestrator/orchestrator.contract.mjs";
+import { OrchestratorConfig, OrchestratorMemoryConfig, SummarizeCallback, SummarizeConfig } from "./contracts/orchestrator/orchestrator-config.type.mjs";
+import { SessionContract } from "./contracts/orchestrator/session.contract.mjs";
+import { PlannerCapability } from "./contracts/planner/planner-capability.type.mjs";
+import { PlannerConfig } from "./contracts/planner/planner-config.type.mjs";
+import { PlannerExecuteOptions } from "./contracts/planner/planner-execute-options.type.mjs";
+import { PlannerPlan, PlannerStep } from "./contracts/planner/planner-plan.type.mjs";
+import { PlannerReport, PlannerReportType, PlannerResult, PlannerStepSnapshot } from "./contracts/planner/planner-result.type.mjs";
+import { PlannerContract } from "./contracts/planner/planner.contract.mjs";
 import { ModelConfig, SDKAdapterContract } from "./contracts/sdk-adapter.contract.mjs";
-import { WorkflowSnapshot } from "./contracts/workflow/workflow-snapshot.type.mjs";
 import { CompleteEvent } from "./contracts/events/complete-event.type.mjs";
 import { UsageEvent } from "./contracts/events/usage-event.type.mjs";
 import { AgentConfig } from "./agent/agent-config.type.mjs";
 import { agent } from "./agent/agent.mjs";
 import { StreamController, createAgentStream } from "./agent/agent-stream.mjs";
-import { AIConfig, getAIConfig, resolveDefaultStore, setAIConfig } from "./config.mjs";
-import { BudgetOptions, BudgetPricing, budget } from "./middleware/builtins/budget.mjs";
+import { BudgetContract, BudgetContractDimension, BudgetContractFallback, BudgetContractViolation, BudgetContractViolationMode } from "./middleware/builtins/budget-contract.type.mjs";
+import { BudgetFallbackSignal, BudgetOptions, BudgetPricing, budget, readBudgetFallbackSignal } from "./middleware/builtins/budget.mjs";
+import { SpawnSubAgentSpec, spawnSubAgent } from "./agent/spawn-sub-agent.mjs";
+import { SystemPrompt, systemPrompt } from "./system-prompt/system-prompt.mjs";
+import { judge } from "./eval/judge-scorer.mjs";
+import { EvalPredicate, contains, exact, predicate } from "./eval/scorers.mjs";
+import { runEval } from "./eval/eval-runner.mjs";
+import { evalScorers } from "./eval/index.mjs";
+import { BatchItemHandler, BatchItemResult, BatchItemStatus, BatchOptions, BatchReport, BatchResult } from "./batch/batch.type.mjs";
+import { batch } from "./batch/batch.mjs";
+import { memory } from "./checkpoint/memory.mjs";
+import { PgCheckpointOptions, pg } from "./checkpoint/pg.mjs";
+import { RedisCheckpointOptions, redis } from "./checkpoint/redis.mjs";
+import { AIConfig, getAIConfig, resolveDefaultCheckpointStore, resolveDefaultSnapshotStore, resolveDefaultStore, setAIConfig } from "./config.mjs";
+import { memory as memory$1 } from "./memory/memory.mjs";
 import { GuardrailCheck, GuardrailCheckResult, GuardrailOptions, guardrail } from "./middleware/builtins/guardrail.mjs";
 import { SemanticCacheOptions, semanticCache } from "./middleware/builtins/semantic-cache.mjs";
 import { composeMiddleware } from "./middleware/helpers/compose.mjs";
 import { forTool } from "./middleware/helpers/for-tool.mjs";
-import { supervisor } from "./supervisor/supervisor.mjs";
-import { Instruction, instruction } from "./system-prompt/instruction.mjs";
-import { Persona, persona } from "./system-prompt/persona.mjs";
-import { SystemPrompt, systemPrompt } from "./system-prompt/system-prompt.mjs";
-import { step } from "./workflow/step.mjs";
-import { workflow } from "./workflow/workflow.mjs";
-import { ai } from "./ai.mjs";
-import { MiddlewareContextByLevel, MiddlewareLevel, runPipeline } from "./middleware/pipeline.mjs";
-import { extractUserText } from "./middleware/utils/extract-user-text.mjs";
-import { NamespacedStateAccessor, namespacedState } from "./middleware/utils/namespaced-state.mjs";
 import { MockModelResponse, MockSDKConfig } from "./mock/mock-config.type.mjs";
 import { mockAgent } from "./mock/mock-agent.mjs";
 import { MockModel } from "./mock/mock-model.mjs";
+import { MockRouterDecision, MockRouterExhaustion, MockRouterOptions, mockRouter } from "./mock/mock-router.mjs";
 import { MockSDK } from "./mock/mock-sdk.mjs";
-import { asTool } from "./supervisor/as-tool.mjs";
+import { FallbackAttempt, FallbackModelContract, FallbackModelOptions, FallbackRetryPredicate } from "./contracts/fallback-model.contract.mjs";
+import { fallbackModel } from "./model/fallback-model.mjs";
+import { asTool } from "./orchestrator/as-tool.mjs";
+import { OrchestratorCommandHandlers, createCommandDispatcher } from "./orchestrator/commands.mjs";
+import { OrchestratorEmitter } from "./orchestrator/emitter.mjs";
+import { ResolvedOrchestratorMemory, injectMemories, memoryQueryFromInput, outcomeTextFromTurn, recallForTurn, rememberTurnOutcome, resolveOrchestratorMemory } from "./orchestrator/memory.mjs";
+import { ResolvedIntentEntry, resolveIntentEntries } from "./supervisor/entries.mjs";
+import { OrchestratorStreamController, createOrchestratorStream } from "./orchestrator/orchestrator-stream.mjs";
+import { OrchestratorExecution, OrchestratorExecutionParams, runResume, runTurn, streamTurn } from "./orchestrator/execution.mjs";
+import { orchestrator } from "./orchestrator/orchestrator.mjs";
+import { computeOrchestratorSignature } from "./orchestrator/signature.mjs";
+import { planner } from "./planner/planner.mjs";
+import { planSchema } from "./planner/plan-schema.mjs";
+import { buildPlanSystemPrompt } from "./planner/plan-prompt.mjs";
+import { computeSignature } from "./planner/signature.mjs";
+import { PlannerRunArgs } from "./planner/planner-run.mjs";
+import { memory as memory$2 } from "./snapshot/memory.mjs";
+import { PgSnapshotStoreOptions, pg as pg$1 } from "./snapshot/pg.mjs";
+import { RedisSnapshotStoreOptions, redis as redis$1 } from "./snapshot/redis.mjs";
+import { asTool as asTool$1 } from "./supervisor/as-tool.mjs";
 import { createCancelledError } from "./supervisor/cancellation.mjs";
 import { SupervisorEmitter } from "./supervisor/emitter.mjs";
-import { ResolvedIntentEntry, resolveIntentEntries } from "./supervisor/entries.mjs";
 import { SupervisorStreamController, createSupervisorStream } from "./supervisor/supervisor-stream.mjs";
 import { SupervisorExecution } from "./supervisor/execution.mjs";
+import { FanOutOptions, FanOutUnit, fanOut } from "./supervisor/fan-out.mjs";
+import { RouterConfig, RouterIntents, RouterOutput, router } from "./supervisor/router-factory.mjs";
 import { buildRouterContextMessage } from "./supervisor/router-prompt.mjs";
-import { computeSignature as computeSignature$1 } from "./supervisor/signature.mjs";
-import { loadSnapshotForResume, persistSupervisorSnapshot, snapshotKey } from "./supervisor/snapshot.mjs";
+import { computeSignature as computeSignature$2 } from "./supervisor/signature.mjs";
+import { loadSnapshotForResume, persistSupervisorSnapshot } from "./supervisor/snapshot.mjs";
+import { supervisor } from "./supervisor/supervisor.mjs";
+import { Instruction, instruction } from "./system-prompt/instruction.mjs";
+import { Persona, persona } from "./system-prompt/persona.mjs";
+import { step } from "./workflow/step.mjs";
+import { workflow } from "./workflow/workflow.mjs";
+import { ai } from "./ai.mjs";
+import { MiddlewareContextByLevel, MiddlewareLevel, runPipeline } from "./middleware/pipeline.mjs";
+import { extractUserText } from "./middleware/utils/extract-user-text.mjs";
+import { NamespacedStateAccessor, namespacedState } from "./middleware/utils/namespaced-state.mjs";
 import { renderPlaceholders } from "./system-prompt/render-placeholders.mjs";
 import { accumulateCost, computeCost } from "./utils/compute-cost.mjs";
 import { extractJsonPayload } from "./utils/extract-json-payload.mjs";
@@ -133,5 +194,9 @@ import { resolveAttachment } from "./utils/resolve-attachment.mjs";
 import { safeJsonParse } from "./utils/safe-json-parse.mjs";
 import { LineageStamp, stampReportLineage } from "./utils/stamp-report-lineage.mjs";
 import { approximateTokenCount } from "./utils/token-count.mjs";
-import { computeSignature } from "./workflow/signature.mjs";
-export { AIConfig, AIError, type AIErrorCode, type AIErrorOptions, type AckCallback, type AckConfig, type AckEntry, type AckRunEntry, type AckSnapshot, type AgentBranchSnapshot, AgentCancelledError, type AgentCancelledErrorOptions, type AgentCompletedPayload, type AgentConfig, type AgentContract, type AgentErrorPayload, type AgentEventHandler, type AgentEventMap, type AgentExecuteOptions, AgentExecutionError, AgentMaxTripsError, type AgentMaxTripsErrorOptions, type AgentMiddleware, type AgentMiddlewareExecuteHooks, type AgentMiddlewareToolHooks, type AgentMiddlewareTripHooks, type AgentReport, type AgentResult, type AgentStartingPayload, type AgentStreamingPayload, type AgentToolCalledPayload, type AgentToolCallingFailedPayload, type AgentToolCallingPayload, type AgentTripCompletedPayload, type AgentTripStartedPayload, Attachment, AttachmentSource, type AttemptEntry, type BaseReport, type BaseResult, BudgetExceededError, type BudgetExceededErrorOptions, type BudgetOptions, type BudgetPricing, type BudgetUnit, type ClassifierAgentEntry, type ClassifierCallback, type ClassifierConfig, type ClassifierContext, type ClassifierOutput, type ClassifierRefineContext, type ClassifierRefineResult, type ClassifierRunEntry, type ClassifierSnapshot, type CompleteEvent, ContentFilterError, type ContentFilterErrorOptions, ContentPart, ContextLengthExceededError, type ContextLengthExceededErrorOptions, type DecisionSource, type DispatchContext, type DispatchRawResult, END, EmbedderConfig, EmbedderContract, EmbeddingBatchResult, EmbeddingResult, EmbeddingUsage, EndSentinel, type ErrorCategory, type EvaluateBranchResult, type EvaluateContext, type EvaluateResult, type EventIdentity, ExecutableContract, type ExecuteResult, type ExecutionReport, type ExecutionStatus, FinishReason, type GuardrailCheck, type GuardrailCheckResult, type GuardrailOptions, type GuardrailPhase, GuardrailViolationError, type GuardrailViolationErrorOptions, ImageSource, Instruction, InstructionContract, type IntentCallback, type IntentEntry, type IntentRunEntry, type IntentRunner, type IntentRunnerMap, InvalidRequestError, type IterationDecision, type IterationSnapshot, type LLMTrip, type LineageStamp, MaxIterationsError, type MaxIterationsErrorOptions, MaxStepsExceededError, type MaxStepsExceededErrorOptions, Message, type MiddlewareAgentRef, type MiddlewareContextByLevel, type MiddlewareExecuteContext, type MiddlewareLevel, type MiddlewareModelRef, type MiddlewareState, type MiddlewareToolContext, type MiddlewareTripContext, MockModel, type MockModelResponse, MockSDK, type MockSDKConfig, ModelCallOptions, ModelCapabilities, ModelConfig, ModelContract, type ModelPricing, ModelResponse, ModelStreamChunk, ModelToolCallRequest, type NamespacedStateAccessor, type Next, type NextStepResult, Persona, PersonaContract, Placeholders, ProviderAuthError, ProviderError, ProviderRateLimitError, type ProviderRateLimitErrorOptions, ProviderTimeoutError, QuotaExceededError, REPORT_SCHEMA_VERSION, type ReportStatus, type ReportType, ResolvedAttachment, type ResolvedIntentEntry, type RetryBackoff, type RetryConfig, type RouteContext, type RouterEntry, RoutingError, type RoutingErrorOptions, SDKAdapterContract, SchemaValidationError, type SchemaValidationErrorOptions, type SemanticCacheOptions, type SessionSendResult, type StepAgentInput, type StepDefinition, StepFailedError, type StepFailedErrorOptions, type StepLocalEvents, type StepOutputSpec, type StepSnapshot, StorageFileShape, type StreamContract, type StreamController, type StreamEvent, type StreamEventBody, StreamingToolGuardConfig, type SupervisorAgentCompletedPayload, type SupervisorAgentFailedPayload, type SupervisorAgentStartingPayload, type SupervisorAgentStreamingPayload, type SupervisorAsToolOptions, SupervisorCancelledError, type SupervisorCancelledErrorOptions, type SupervisorCancelledPayload, type SupervisorCompletedPayload, type SupervisorConfig, type SupervisorContract, SupervisorDriftError, type SupervisorDriftErrorOptions, SupervisorEmitter, type SupervisorErrorPayload, type SupervisorEvaluateVerdictPayload, type SupervisorEventHandler, type SupervisorEventHandlers, type SupervisorEventMap, type SupervisorExecuteOptions, SupervisorExecution, SupervisorFailedError, type SupervisorInput, type SupervisorIntentValue, type SupervisorIterationCompletedPayload, type SupervisorIterationStartingPayload, type SupervisorReport, type SupervisorResult, type SupervisorResumeOptions, type SupervisorRouterDecidedPayload, type SupervisorRouterDecidingPayload, SupervisorRoutingError, type SupervisorRoutingErrorOptions, type SupervisorSnapshot, type SupervisorSnapshotStatus, type SupervisorStartingPayload, type SupervisorStreamController, type SupervisorStreamEvent, type SupervisorTerminatedBy, SystemPrompt, SystemPromptBlockContract, SystemPromptContract, type ToolCall, ToolConfig, ToolContext, type ToolContract, type ToolEventMeta, ToolExecutionError, type ToolExecutionErrorOptions, type ToolInvokeResult, ToolMeta, ToolMode, type Usage, type UsageEvent, type WithoutIdentity, WorkflowCancelledError, type WorkflowCancelledErrorOptions, type WorkflowCancelledPayload, type WorkflowCompletedPayload, type WorkflowContext, type WorkflowDefinition, WorkflowDriftError, type WorkflowDriftErrorOptions, WorkflowError, type WorkflowErrorPayload, type WorkflowEventHandler, type WorkflowEventHandlers, type WorkflowEventMap, type WorkflowExecuteOptions, type WorkflowInstance, type WorkflowLoopWarningPayload, type WorkflowReport, type WorkflowResult, type WorkflowResumeOptions, type WorkflowRunOptions, type WorkflowSnapshot, type WorkflowStartingPayload, type WorkflowStepCompletedPayload, type WorkflowStepFailedPayload, type WorkflowStepRetryingPayload, type WorkflowStepSkippedPayload, type WorkflowStepStartingPayload, type WorkflowStepStreamingPayload, accumulateCost, agent, ai, approximateTokenCount, budget, buildRouterContextMessage, composeMiddleware, computeCost, computeSignature, computeSignature$1 as computeSupervisorSignature, createAgentStream, createCancelledError as createSupervisorCancelledError, createSupervisorStream, extractJsonPayload, extractJsonSchema, extractUserText, forTool, generateRunId, getAIConfig, guardrail, instruction, loadSnapshotForResume as loadSupervisorSnapshotForResume, mockAgent, namespacedState, persistSupervisorSnapshot, persona, prepareAttachmentPart, renderPlaceholders, resolveAttachment, resolveDefaultStore, resolveIntentEntries, runPipeline, safeJsonParse, semanticCache, setAIConfig, stampReportLineage, step, supervisor, asTool as supervisorAsTool, snapshotKey as supervisorSnapshotKey, systemPrompt, tool, workflow };
+import { computeSignature as computeSignature$1 } from "./workflow/signature.mjs";
+import { MatcherVerdict, matchConverge, matchOutputShape, matchPassStep, matchRouteTo } from "./testing/matcher-logic.mjs";
+import { AiMatchers } from "./testing/matchers.mjs";
+import { registerAiMatchers } from "./testing/register-lazy.mjs";
+export { AIConfig, AIError, type AIErrorCode, type AIErrorOptions, type AckCallback, type AckConfig, type AckEntry, type AckRunEntry, type AckSnapshot, type AgentBranchSnapshot, AgentCancelledError, type AgentCancelledErrorOptions, type AgentCompletedPayload, type AgentConfig, type AgentContract, type AgentErrorPayload, type AgentEventHandler, type AgentEventMap, type AgentExecuteOptions, AgentExecutionError, AgentMaxTripsError, type AgentMaxTripsErrorOptions, type AgentMiddleware, type AgentMiddlewareExecuteHooks, type AgentMiddlewareSupervisorHooks, type AgentMiddlewareToolHooks, type AgentMiddlewareTripHooks, type AgentReport, type AgentResult, type AgentStartingPayload, type AgentStreamingPayload, type AgentToolCalledPayload, type AgentToolCallingFailedPayload, type AgentToolCallingPayload, type AgentToolEntry, type AgentTripCompletedPayload, type AgentTripStartedPayload, type AiMatchers, Attachment, AttachmentSource, type AttemptEntry, type BaseReport, type BaseResult, type BatchItemHandler, type BatchItemResult, type BatchItemStatus, type BatchOptions, type BatchReport, type BatchResult, type BudgetContract, type BudgetContractDimension, type BudgetContractFallback, type BudgetContractViolation, type BudgetContractViolationMode, BudgetExceededError, type BudgetExceededErrorOptions, type BudgetFallbackSignal, type BudgetOptions, type BudgetPricing, type BudgetUnit, type CheckpointRecord, type CheckpointStore, type ClassifierAgentEntry, type ClassifierCallback, type ClassifierConfig, type ClassifierContext, type ClassifierOutput, type ClassifierRefineContext, type ClassifierRefineResult, type ClassifierRunEntry, type ClassifierSnapshot, type CompactionResult, type CompleteEvent, ContentFilterError, type ContentFilterErrorOptions, ContentPart, ContextLengthExceededError, type ContextLengthExceededErrorOptions, type DecisionSource, type DispatchContext, type DispatchRawResult, END, EmbedderConfig, EmbedderContract, EmbeddingBatchResult, EmbeddingResult, EmbeddingUsage, EndSentinel, type EpisodicMemoryConfig, type ErrorCategory, type EvalCase, type EvalCaseResult, type EvalJudge, type EvalOptions, type EvalPredicate, type EvalReport, type EvalScore, type EvalScorer, type EvalScorerContext, type EvaluateBranchResult, type EvaluateContext, type EvaluateResult, type EventIdentity, ExecutableContract, type ExecutableTool, type ExecuteResult, type ExecutionReport, type ExecutionStatus, type FallbackAttempt, type FallbackModelContract, type FallbackModelOptions, type FallbackRetryPredicate, type FanOutOptions, type FanOutUnit, FinishReason, type GuardrailCheck, type GuardrailCheckResult, type GuardrailOptions, type GuardrailPhase, GuardrailViolationError, type GuardrailViolationErrorOptions, ImageSource, Instruction, InstructionContract, type IntentCallback, type IntentEntry, type IntentRunEntry, type IntentRunner, type IntentRunnerMap, InvalidRequestError, type IterationDecision, type IterationSnapshot, type LLMTrip, type LineageStamp, type MatcherVerdict, MaxIterationsError, type MaxIterationsErrorOptions, MaxStepsExceededError, type MaxStepsExceededErrorOptions, type MemoryConfig, type MemoryContract, type MemoryItem, type MemoryTier, Message, type MiddlewareAgentRef, type MiddlewareContextByLevel, type MiddlewareExecuteContext, type MiddlewareLevel, type MiddlewareModelRef, type MiddlewareState, type MiddlewareSupervisorContext, type MiddlewareSupervisorRef, type MiddlewareToolContext, type MiddlewareTripContext, MockModel, type MockModelResponse, type MockRouterDecision, type MockRouterExhaustion, type MockRouterOptions, MockSDK, type MockSDKConfig, ModelCallOptions, ModelCapabilities, ModelConfig, ModelContract, type ModelPricing, ModelResponse, ModelStreamChunk, ModelToolCallRequest, type NamespacedStateAccessor, type Next, type NextStepResult, type OrchestratorAsToolOptions, type OrchestratorAwaitingStatus, OrchestratorCancelledError, type OrchestratorCancelledErrorOptions, type OrchestratorCommandHandlers, type OrchestratorCommands, type OrchestratorConfig, OrchestratorConfigError, type OrchestratorContract, OrchestratorDriftError, type OrchestratorDriftErrorOptions, OrchestratorEmitter, type OrchestratorEvent, type OrchestratorEventHandler, type OrchestratorEventHandlers, type OrchestratorEventMap, type OrchestratorEventName, type OrchestratorExecuteOptions, OrchestratorExecution, type OrchestratorExecutionParams, OrchestratorFailedError, type OrchestratorMemoryConfig, type OrchestratorReport, type OrchestratorReportStatus, type OrchestratorReportType, type OrchestratorResult, type OrchestratorResumeOptions, type OrchestratorSessionScope, type OrchestratorStreamController, Persona, PersonaContract, type PgCheckpointOptions, type PgClientLike, type PgSnapshotStoreOptions, Placeholders, PlannerCancelledError, type PlannerCancelledErrorOptions, type PlannerCapability, type PlannerConfig, type PlannerContract, type PlannerExecuteOptions, PlannerFailedError, type PlannerPlan, PlannerPlanInvalidError, type PlannerReport, type PlannerReportType, type PlannerResult, type PlannerRunArgs, type PlannerStep, type PlannerStepSnapshot, type ProceduralMemoryConfig, ProviderAuthError, ProviderError, ProviderRateLimitError, type ProviderRateLimitErrorOptions, ProviderTimeoutError, QuotaExceededError, REPORT_SCHEMA_VERSION, ReasoningEffort, type RecallOptions, type RecalledMemory, type RedisCheckpointOptions, type RedisClientLike, type RedisSnapshotStoreOptions, type ReportStatus, type ReportType, ResolvedAttachment, type ResolvedIntentEntry, type ResolvedOrchestratorMemory, type RetryBackoff, type RetryConfig, type RouteContext, type RouterConfig, type RouterEntry, type RouterIntents, type RouterOutput, RoutingError, type RoutingErrorOptions, SDKAdapterContract, SchemaValidationError, type SchemaValidationErrorOptions, type SemanticCacheOptions, type SemanticMemoryConfig, type SessionContextOverrides, type SessionContract, type SessionSendResult, type SnapshotStore, type SpawnSubAgentSpec, type StepAgentInput, type StepDefinition, StepFailedError, type StepFailedErrorOptions, type StepLocalEvents, type StepOutputSpec, type StepSnapshot, StorageFileShape, type StreamContract, type StreamController, type StreamEvent, type StreamEventBody, StreamingToolGuardConfig, type SummarizeCallback, type SummarizeConfig, type SupervisorAgentCompletedPayload, type SupervisorAgentFailedPayload, type SupervisorAgentStartingPayload, type SupervisorAgentStreamingPayload, type SupervisorAsToolOptions, SupervisorCancelledError, type SupervisorCancelledErrorOptions, type SupervisorCancelledPayload, type SupervisorCompletedPayload, type SupervisorConfig, type SupervisorContract, SupervisorDriftError, type SupervisorDriftErrorOptions, SupervisorEmitter, type SupervisorErrorPayload, type SupervisorEvaluateVerdictPayload, type SupervisorEventHandler, type SupervisorEventHandlers, type SupervisorEventMap, type SupervisorExecuteOptions, SupervisorExecution, SupervisorFailedError, type SupervisorInput, type SupervisorIntentValue, type SupervisorIterationCompletedPayload, type SupervisorIterationStartingPayload, type SupervisorReport, type SupervisorResult, type SupervisorResumeOptions, type SupervisorRouterDecidedPayload, type SupervisorRouterDecidingPayload, SupervisorRoutingError, type SupervisorRoutingErrorOptions, type SupervisorSnapshot, type SupervisorSnapshotStatus, type SupervisorStartingPayload, type SupervisorStreamController, type SupervisorStreamEvent, type SupervisorTerminatedBy, SystemPrompt, SystemPromptBlockContract, SystemPromptContract, type ToolCall, ToolConfig, ToolContext, type ToolContract, type ToolEventMeta, ToolExecutionError, type ToolExecutionErrorOptions, type ToolInvokeResult, ToolMeta, ToolMode, type TurnSnapshot, type Usage, type UsageEvent, type WithoutIdentity, WorkflowCancelledError, type WorkflowCancelledErrorOptions, type WorkflowCancelledPayload, type WorkflowCompletedPayload, type WorkflowContext, type WorkflowDefinition, WorkflowDriftError, type WorkflowDriftErrorOptions, WorkflowError, type WorkflowErrorPayload, type WorkflowEventHandler, type WorkflowEventHandlers, type WorkflowEventMap, type WorkflowExecuteOptions, type WorkflowInstance, type WorkflowLoopWarningPayload, type WorkflowReport, type WorkflowResult, type WorkflowResumeOptions, type WorkflowRunOptions, type WorkflowSnapshot, type WorkflowStartingPayload, type WorkflowStepCompletedPayload, type WorkflowStepFailedPayload, type WorkflowStepRetryingPayload, type WorkflowStepSkippedPayload, type WorkflowStepStartingPayload, type WorkflowStepStreamingPayload, accumulateCost, agent, ai, approximateTokenCount, batch, budget, buildPlanSystemPrompt, buildRouterContextMessage, memory as checkpointMemory, pg as checkpointPg, redis as checkpointRedis, composeMiddleware, computeCost, computeOrchestratorSignature, computeSignature as computePlannerSignature, computeSignature$1 as computeSignature, computeSignature$2 as computeSupervisorSignature, contains, createAgentStream, createCommandDispatcher as createOrchestratorCommandDispatcher, createOrchestratorStream, createCancelledError as createSupervisorCancelledError, createSupervisorStream, evalScorers, exact, executableToTool, extractJsonPayload, extractJsonSchema, extractUserText, fallbackModel, fanOut, forTool, generateRunId, getAIConfig, guardrail, injectMemories as injectOrchestratorMemories, instruction, isExecutableTool, judge, loadSnapshotForResume as loadSupervisorSnapshotForResume, matchConverge, matchOutputShape, matchPassStep, matchRouteTo, memory$1 as memory, mockAgent, mockRouter, namespacedState, normalizeAgentTools, orchestrator, asTool as orchestratorAsTool, memoryQueryFromInput as orchestratorMemoryQueryFromInput, outcomeTextFromTurn as orchestratorOutcomeTextFromTurn, persistSupervisorSnapshot, persona, planSchema, planner, predicate, prepareAttachmentPart, readBudgetFallbackSignal, recallForTurn as recallOrchestratorMemory, registerAiMatchers, rememberTurnOutcome as rememberOrchestratorTurnOutcome, renderPlaceholders, resolveAttachment, resolveDefaultCheckpointStore, resolveDefaultSnapshotStore, resolveDefaultStore, resolveIntentEntries, resolveOrchestratorMemory, router, runEval, runResume as runOrchestratorResume, runTurn as runOrchestratorTurn, runPipeline, safeJsonParse, semanticCache, setAIConfig, memory$2 as snapshotMemory, pg$1 as snapshotPg, redis$1 as snapshotRedis, spawnSubAgent, stampReportLineage, step, streamTurn as streamOrchestratorTurn, supervisor, asTool$1 as supervisorAsTool, systemPrompt, tool, workflow };
+import "./testing/matchers.mjs";

package/esm/index.mjs

@@ -12,6 +12,13 @@ import { SupervisorFailedError } from "./errors/supervisor-failed-error.mjs";
 import { MaxIterationsError } from "./errors/max-iterations-error.mjs";
 import { WorkflowError } from "./errors/workflow-error.mjs";
 import { MaxStepsExceededError } from "./errors/max-steps-exceeded-error.mjs";
+import { OrchestratorFailedError } from "./errors/orchestrator-failed-error.mjs";
+import { OrchestratorCancelledError } from "./errors/orchestrator-cancelled-error.mjs";
+import { OrchestratorConfigError } from "./errors/orchestrator-config-error.mjs";
+import { OrchestratorDriftError } from "./errors/orchestrator-drift-error.mjs";
+import { PlannerFailedError } from "./errors/planner-failed-error.mjs";
+import { PlannerCancelledError } from "./errors/planner-cancelled-error.mjs";
+import { PlannerPlanInvalidError } from "./errors/planner-plan-invalid-error.mjs";
 import { ProviderAuthError } from "./errors/provider-auth-error.mjs";
 import { ProviderRateLimitError } from "./errors/provider-rate-limit-error.mjs";
 import { ProviderTimeoutError } from "./errors/provider-timeout-error.mjs";
@@ -26,16 +33,6 @@ import { ToolExecutionError } from "./errors/tool-execution-error.mjs";
 import { WorkflowCancelledError } from "./errors/workflow-cancelled-error.mjs";
 import { WorkflowDriftError } from "./errors/workflow-drift-error.mjs";
 import "./errors/index.mjs";
-import { extractUserText } from "./middleware/utils/extract-user-text.mjs";
-import { namespacedState } from "./middleware/utils/namespaced-state.mjs";
-import { budget } from "./middleware/builtins/budget.mjs";
-import { guardrail } from "./middleware/builtins/guardrail.mjs";
-import { getAIConfig, resolveDefaultStore, setAIConfig } from "./config.mjs";
-import { semanticCache } from "./middleware/builtins/semantic-cache.mjs";
-import { composeMiddleware } from "./middleware/helpers/compose.mjs";
-import { forTool } from "./middleware/helpers/for-tool.mjs";
-import { runPipeline } from "./middleware/pipeline.mjs";
-import "./middleware/index.mjs";
 import { accumulateCost, computeCost } from "./utils/compute-cost.mjs";
 import { extractJsonPayload } from "./utils/extract-json-payload.mjs";
 import { generateRunId } from "./utils/generate-run-id.mjs";
@@ -47,35 +44,82 @@ import { REPORT_SCHEMA_VERSION } from "./contracts/result/base-report.type.mjs";
 import { stampReportLineage } from "./utils/stamp-report-lineage.mjs";
 import { approximateTokenCount } from "./utils/token-count.mjs";
 import "./utils/index.mjs";
+import { judge } from "./eval/judge-scorer.mjs";
+import { runEval } from "./eval/eval-runner.mjs";
+import { extractUserText } from "./middleware/utils/extract-user-text.mjs";
+import { namespacedState } from "./middleware/utils/namespaced-state.mjs";
+import { budget, readBudgetFallbackSignal } from "./middleware/builtins/budget.mjs";
+import { guardrail } from "./middleware/builtins/guardrail.mjs";
+import { getAIConfig, resolveDefaultCheckpointStore, resolveDefaultSnapshotStore, resolveDefaultStore, setAIConfig } from "./config.mjs";
+import { semanticCache } from "./middleware/builtins/semantic-cache.mjs";
+import { composeMiddleware } from "./middleware/helpers/compose.mjs";
+import { forTool } from "./middleware/helpers/for-tool.mjs";
+import { runPipeline } from "./middleware/pipeline.mjs";
+import "./middleware/index.mjs";
+import { tool } from "./tool/tool.mjs";
+import { executableToTool, isExecutableTool, normalizeAgentTools } from "./tool/executable-as-tool.mjs";
 import { createAgentStream } from "./agent/agent-stream.mjs";
 import { agent } from "./agent/agent.mjs";
+import { spawnSubAgent } from "./agent/spawn-sub-agent.mjs";
 import "./agent/index.mjs";
-import { tool } from "./tool/tool.mjs";
-import { asTool } from "./supervisor/as-tool.mjs";
+import { batch } from "./batch/batch.mjs";
+import "./batch/index.mjs";
+import { memory } from "./checkpoint/memory.mjs";
+import { pg } from "./checkpoint/pg.mjs";
+import { redis } from "./checkpoint/redis.mjs";
+import { contains, exact, predicate } from "./eval/scorers.mjs";
+import { evalScorers } from "./eval/index.mjs";
+import { memory as memory$1 } from "./memory/memory.mjs";
+import { MockModel } from "./mock/mock-model.mjs";
+import { MockSDK } from "./mock/mock-sdk.mjs";
+import { mockAgent } from "./mock/mock-agent.mjs";
+import { END } from "./contracts/end.type.mjs";
+import { mockRouter } from "./mock/mock-router.mjs";
+import "./mock/index.mjs";
+import { fallbackModel } from "./model/fallback-model.mjs";
+import "./model/index.mjs";
+import { asTool } from "./orchestrator/as-tool.mjs";
+import { createCommandDispatcher } from "./orchestrator/commands.mjs";
+import { OrchestratorEmitter } from "./orchestrator/emitter.mjs";
+import { injectMemories, memoryQueryFromInput, outcomeTextFromTurn, recallForTurn, rememberTurnOutcome, resolveOrchestratorMemory } from "./orchestrator/memory.mjs";
+import { asTool as asTool$1 } from "./supervisor/as-tool.mjs";
 import { SupervisorEmitter } from "./supervisor/emitter.mjs";
 import { resolveIntentEntries } from "./supervisor/entries.mjs";
-import { END } from "./contracts/end.type.mjs";
 import { createCancelledError } from "./supervisor/cancellation.mjs";
 import { buildRouterContextMessage } from "./supervisor/router-prompt.mjs";
-import { loadSnapshotForResume, persistSupervisorSnapshot, snapshotKey } from "./supervisor/snapshot.mjs";
+import { loadSnapshotForResume, persistSupervisorSnapshot } from "./supervisor/snapshot.mjs";
 import { SupervisorExecution } from "./supervisor/execution.mjs";
-import { computeSignature as computeSignature$1 } from "./supervisor/signature.mjs";
+import { computeSignature as computeSignature$2 } from "./supervisor/signature.mjs";
 import { createSupervisorStream } from "./supervisor/supervisor-stream.mjs";
 import { supervisor } from "./supervisor/supervisor.mjs";
+import { OrchestratorExecution, runResume, runTurn, streamTurn } from "./orchestrator/execution.mjs";
+import { createOrchestratorStream } from "./orchestrator/orchestrator-stream.mjs";
+import { computeOrchestratorSignature } from "./orchestrator/signature.mjs";
+import { orchestrator } from "./orchestrator/orchestrator.mjs";
+import "./orchestrator/index.mjs";
+import { buildPlanSystemPrompt } from "./planner/plan-prompt.mjs";
+import { planSchema } from "./planner/plan-schema.mjs";
+import { computeSignature } from "./planner/signature.mjs";
+import { planner } from "./planner/planner.mjs";
+import "./planner/index.mjs";
+import { memory as memory$2 } from "./snapshot/memory.mjs";
+import { pg as pg$1 } from "./snapshot/pg.mjs";
+import { redis as redis$1 } from "./snapshot/redis.mjs";
+import { fanOut } from "./supervisor/fan-out.mjs";
+import { router } from "./supervisor/router-factory.mjs";
+import "./supervisor/index.mjs";
 import { renderPlaceholders } from "./system-prompt/render-placeholders.mjs";
 import { Instruction, instruction } from "./system-prompt/instruction.mjs";
 import { Persona, persona } from "./system-prompt/persona.mjs";
 import { SystemPrompt, systemPrompt } from "./system-prompt/system-prompt.mjs";
 import { step } from "./workflow/step.mjs";
-import { computeSignature } from "./workflow/signature.mjs";
+import { computeSignature as computeSignature$1 } from "./workflow/signature.mjs";
 import { workflow } from "./workflow/workflow.mjs";
 import { ai } from "./ai.mjs";
-import { MockModel } from "./mock/mock-model.mjs";
-import { MockSDK } from "./mock/mock-sdk.mjs";
-import { mockAgent } from "./mock/mock-agent.mjs";
-import "./mock/index.mjs";
-import "./supervisor/index.mjs";
+import "./system-prompt/index.mjs";
 import "./tool/index.mjs";
 import "./workflow/index.mjs";
+import { matchConverge, matchOutputShape, matchPassStep, matchRouteTo } from "./testing/matcher-logic.mjs";
+import { registerAiMatchers } from "./testing/register-lazy.mjs";
 
-export { AIError, AgentCancelledError, AgentExecutionError, AgentMaxTripsError, BudgetExceededError, ContentFilterError, ContextLengthExceededError, END, GuardrailViolationError, Instruction, InvalidRequestError, MaxIterationsError, MaxStepsExceededError, MockModel, MockSDK, Persona, ProviderAuthError, ProviderError, ProviderRateLimitError, ProviderTimeoutError, QuotaExceededError, REPORT_SCHEMA_VERSION, RoutingError, SchemaValidationError, StepFailedError, SupervisorCancelledError, SupervisorDriftError, SupervisorEmitter, SupervisorExecution, SupervisorFailedError, SupervisorRoutingError, SystemPrompt, ToolExecutionError, WorkflowCancelledError, WorkflowDriftError, WorkflowError, accumulateCost, agent, ai, approximateTokenCount, budget, buildRouterContextMessage, composeMiddleware, computeCost, computeSignature, computeSignature$1 as computeSupervisorSignature, createAgentStream, createCancelledError as createSupervisorCancelledError, createSupervisorStream, extractJsonPayload, extractJsonSchema, extractUserText, forTool, generateRunId, getAIConfig, guardrail, instruction, loadSnapshotForResume as loadSupervisorSnapshotForResume, mockAgent, namespacedState, persistSupervisorSnapshot, persona, prepareAttachmentPart, renderPlaceholders, resolveAttachment, resolveDefaultStore, resolveIntentEntries, runPipeline, safeJsonParse, semanticCache, setAIConfig, stampReportLineage, step, supervisor, asTool as supervisorAsTool, snapshotKey as supervisorSnapshotKey, systemPrompt, tool, workflow };
+export { AIError, AgentCancelledError, AgentExecutionError, AgentMaxTripsError, BudgetExceededError, ContentFilterError, ContextLengthExceededError, END, GuardrailViolationError, Instruction, InvalidRequestError, MaxIterationsError, MaxStepsExceededError, MockModel, MockSDK, OrchestratorCancelledError, OrchestratorConfigError, OrchestratorDriftError, OrchestratorEmitter, OrchestratorExecution, OrchestratorFailedError, Persona, PlannerCancelledError, PlannerFailedError, PlannerPlanInvalidError, ProviderAuthError, ProviderError, ProviderRateLimitError, ProviderTimeoutError, QuotaExceededError, REPORT_SCHEMA_VERSION, RoutingError, SchemaValidationError, StepFailedError, SupervisorCancelledError, SupervisorDriftError, SupervisorEmitter, SupervisorExecution, SupervisorFailedError, SupervisorRoutingError, SystemPrompt, ToolExecutionError, WorkflowCancelledError, WorkflowDriftError, WorkflowError, accumulateCost, agent, ai, approximateTokenCount, batch, budget, buildPlanSystemPrompt, buildRouterContextMessage, memory as checkpointMemory, pg as checkpointPg, redis as checkpointRedis, composeMiddleware, computeCost, computeOrchestratorSignature, computeSignature as computePlannerSignature, computeSignature$1 as computeSignature, computeSignature$2 as computeSupervisorSignature, contains, createAgentStream, createCommandDispatcher as createOrchestratorCommandDispatcher, createOrchestratorStream, createCancelledError as createSupervisorCancelledError, createSupervisorStream, evalScorers, exact, executableToTool, extractJsonPayload, extractJsonSchema, extractUserText, fallbackModel, fanOut, forTool, generateRunId, getAIConfig, guardrail, injectMemories as injectOrchestratorMemories, instruction, isExecutableTool, judge, loadSnapshotForResume as loadSupervisorSnapshotForResume, matchConverge, matchOutputShape, matchPassStep, matchRouteTo, memory$1 as memory, mockAgent, mockRouter, namespacedState, normalizeAgentTools, orchestrator, asTool as orchestratorAsTool, memoryQueryFromInput as orchestratorMemoryQueryFromInput, outcomeTextFromTurn as orchestratorOutcomeTextFromTurn, persistSupervisorSnapshot, persona, planSchema, planner, predicate, prepareAttachmentPart, readBudgetFallbackSignal, recallForTurn as recallOrchestratorMemory, registerAiMatchers, rememberTurnOutcome as rememberOrchestratorTurnOutcome, renderPlaceholders, resolveAttachment, resolveDefaultCheckpointStore, resolveDefaultSnapshotStore, resolveDefaultStore, resolveIntentEntries, resolveOrchestratorMemory, router, runEval, runResume as runOrchestratorResume, runTurn as runOrchestratorTurn, runPipeline, safeJsonParse, semanticCache, setAIConfig, memory$2 as snapshotMemory, pg$1 as snapshotPg, redis$1 as snapshotRedis, spawnSubAgent, stampReportLineage, step, streamTurn as streamOrchestratorTurn, supervisor, asTool$1 as supervisorAsTool, systemPrompt, tool, workflow };

package/esm/memory/derive-id.mjs

@@ -0,0 +1,24 @@
+//#region ../@warlock.js/ai/src/memory/derive-id.ts
+/**
+* Derive a stable memory id from its text when the caller didn't supply
+* one. Re-remembering identical text therefore lands on the same id and
+* overwrites in place rather than duplicating.
+*
+* FNV-1a variant — cheap, dependency-free, collision-resistant enough
+* for de-duplicating memory entries. NOT cryptographic: a collision
+* would merge two distinct memories, not breach security in the current
+* trust model. Mirrors the prompt hash in
+* `middleware/builtins/semantic-cache.ts`.
+*/
+function deriveMemoryId(text) {
+	let hash = 2166136261;
+	for (let index = 0; index < text.length; index++) {
+		hash ^= text.charCodeAt(index);
+		hash = Math.imul(hash, 16777619);
+	}
+	return (hash >>> 0).toString(16);
+}
+
+//#endregion
+export { deriveMemoryId };
+//# sourceMappingURL=derive-id.mjs.map

package/esm/memory/derive-id.mjs.map

@@ -0,0 +1 @@
+{"version":3,"file":"derive-id.mjs","names":[],"sources":["../../../../../../../@warlock.js/ai/src/memory/derive-id.ts"],"sourcesContent":["/**\n * Derive a stable memory id from its text when the caller didn't supply\n * one. Re-remembering identical text therefore lands on the same id and\n * overwrites in place rather than duplicating.\n *\n * FNV-1a variant — cheap, dependency-free, collision-resistant enough\n * for de-duplicating memory entries. NOT cryptographic: a collision\n * would merge two distinct memories, not breach security in the current\n * trust model. Mirrors the prompt hash in\n * `middleware/builtins/semantic-cache.ts`.\n */\nexport function deriveMemoryId(text: string): string {\n  let hash = 0x811c9dc5;\n\n  for (let index = 0; index < text.length; index++) {\n    hash ^= text.charCodeAt(index);\n    hash = Math.imul(hash, 0x01000193);\n  }\n\n  return (hash >>> 0).toString(16);\n}\n"],"mappings":";;;;;;;;;;;;AAWA,SAAgB,eAAe,MAAsB;CACnD,IAAI,OAAO;CAEX,KAAK,IAAI,QAAQ,GAAG,QAAQ,KAAK,QAAQ,SAAS;EAChD,QAAQ,KAAK,WAAW,KAAK;EAC7B,OAAO,KAAK,KAAK,MAAM,QAAU;CACnC;CAEA,QAAQ,SAAS,EAAC,CAAE,SAAS,EAAE;AACjC"}

package/esm/memory/episodic-memory.mjs

@@ -0,0 +1,106 @@
+import { deriveMemoryId } from "./derive-id.mjs";
+
+//#region ../@warlock.js/ai/src/memory/episodic-memory.ts
+/**
+* How many extra candidates to pull from `similar()` before re-ranking by
+* the recency-blended score and slicing to `k`. Recency can promote a
+* slightly-less-similar-but-recent episode past a stale exact match, so
+* the raw top-`k` by similarity alone would miss it — overscan, then
+* re-rank.
+*/
+const RECALL_OVERSCAN = 5;
+/**
+* Episodic recall tier (memory core M2).
+*
+* Holds a durable, timestamped log of *what happened* — events/episodes —
+* and retrieves the ones most relevant to a query, **blended with
+* recency** so recent episodes outrank stale ones at equal similarity.
+* That recency weighting is the whole difference from the {@link
+* import("./semantic-memory").SemanticMemory} tier (pure similarity over
+* timeless facts): episodic memory is time-anchored.
+*
+* Like the semantic tier it delegates the similarity search to the
+* `@warlock.js/cache` driver's `similar()` and never implements ANN
+* itself; it adds a stored `ts` per entry and a decay curve at recall.
+* The blended `score` stays in `[0, 1]` so a consumer can merge episodic
+* hits with the other tiers and sort on one field.
+*
+* Internal to the `memory()` factory — never exported on the package
+* surface.
+*/
+var EpisodicMemory = class {
+	constructor(embedder, store, namespace, recencyWeight, halfLifeMs, now) {
+		this.embedder = embedder;
+		this.store = store;
+		this.namespace = namespace;
+		this.recencyWeight = recencyWeight;
+		this.halfLifeMs = halfLifeMs;
+		this.now = now;
+	}
+	/**
+	* Embed the episode text and index it under a namespaced, id-derived
+	* key, stamping the current time. Re-remembering the same id overwrites
+	* the prior entry (and refreshes its timestamp).
+	*/
+	async remember(item) {
+		const id = item.id ?? deriveMemoryId(item.text);
+		const { vector } = await this.embedder.embed(item.text);
+		const value = {
+			id,
+			text: item.text,
+			ts: this.now(),
+			metadata: item.metadata
+		};
+		await this.store.set(this.keyFor(id), value, { vector });
+	}
+	/**
+	* Embed `query`, pull the nearest episodes clearing the similarity
+	* `threshold`, then re-rank each by a recency-blended score before
+	* returning the top `k`. The similarity floor still gates relevance —
+	* recency only reorders episodes that already cleared it, it never
+	* surfaces an irrelevant-but-recent one.
+	*/
+	async recall(query, k, threshold) {
+		const { vector } = await this.embedder.embed(query);
+		const hits = await this.store.similar(vector, {
+			topK: Math.max(k * RECALL_OVERSCAN, k),
+			threshold
+		});
+		const prefix = `${this.namespace}.`;
+		const now = this.now();
+		return hits.filter((hit) => hit.key.startsWith(prefix)).map((hit) => ({
+			id: hit.value.id,
+			text: hit.value.text,
+			tier: "episodic",
+			score: this.blend(hit.score, hit.value.ts, now),
+			metadata: hit.value.metadata
+		})).sort((first, second) => second.score - first.score).slice(0, k);
+	}
+	/** Drop every episode written under this instance's namespace. */
+	async clear() {
+		await this.store.removeNamespace(this.namespace);
+	}
+	/**
+	* Combine raw similarity with an exponential recency decay:
+	* `(1 - w)·similarity + w·0.5^(age / halfLife)`. A just-remembered
+	* episode contributes a recency of `1`; one `halfLife` old, `0.5`;
+	* older trends toward `0`. With `recencyWeight` 0 the score is pure
+	* similarity (an opt-out back to semantic-style ranking).
+	*/
+	blend(similarity, ts, now) {
+		const recency = .5 ** (Math.max(0, now - ts) / this.halfLifeMs);
+		return (1 - this.recencyWeight) * similarity + this.recencyWeight * recency;
+	}
+	/**
+	* Namespaced key for an entry. Mirrors the semantic tier's dot
+	* separator so the prefix used here matches the `hit.key` the driver
+	* returns from `similar()`.
+	*/
+	keyFor(id) {
+		return `${this.namespace}.${id}`;
+	}
+};
+
+//#endregion
+export { EpisodicMemory };
+//# sourceMappingURL=episodic-memory.mjs.map