@warlock.js/ai 4.2.11 → 4.4.0

package/cjs/index.cjs.map

@@ -1 +1 @@
-{"version":3,"file":"index.cjs","names":["LOG_MODULE","called","log","invoke","safeStringify","resolveSnapshotStore","LOG_MODULE_BASE","log","toAIError","computeSignature","hash","computeSignature","generateRunId","validate","asTool","createCancelledError","loadSnapshotForResume","createCancelledError","log","createCancelledError","generateRunId","loadSnapshotForResume","asTool","combined"],"sources":["../../../../../../@warlock.js/ai/src/errors/ai-error.ts","../../../../../../@warlock.js/ai/src/errors/agent-execution-error.ts","../../../../../../@warlock.js/ai/src/errors/agent-cancelled-error.ts","../../../../../../@warlock.js/ai/src/errors/agent-max-trips-error.ts","../../../../../../@warlock.js/ai/src/errors/budget-exceeded-error.ts","../../../../../../@warlock.js/ai/src/errors/provider-error.ts","../../../../../../@warlock.js/ai/src/errors/content-filter-error.ts","../../../../../../@warlock.js/ai/src/errors/context-length-exceeded-error.ts","../../../../../../@warlock.js/ai/src/errors/guardrail-violation-error.ts","../../../../../../@warlock.js/ai/src/errors/invalid-request-error.ts","../../../../../../@warlock.js/ai/src/errors/supervisor-failed-error.ts","../../../../../../@warlock.js/ai/src/errors/max-iterations-error.ts","../../../../../../@warlock.js/ai/src/errors/workflow-error.ts","../../../../../../@warlock.js/ai/src/errors/max-steps-exceeded-error.ts","../../../../../../@warlock.js/ai/src/errors/provider-auth-error.ts","../../../../../../@warlock.js/ai/src/errors/provider-rate-limit-error.ts","../../../../../../@warlock.js/ai/src/errors/provider-timeout-error.ts","../../../../../../@warlock.js/ai/src/errors/quota-exceeded-error.ts","../../../../../../@warlock.js/ai/src/errors/routing-error.ts","../../../../../../@warlock.js/ai/src/errors/schema-validation-error.ts","../../../../../../@warlock.js/ai/src/errors/step-failed-error.ts","../../../../../../@warlock.js/ai/src/errors/supervisor-cancelled-error.ts","../../../../../../@warlock.js/ai/src/errors/supervisor-drift-error.ts","../../../../../../@warlock.js/ai/src/errors/supervisor-routing-error.ts","../../../../../../@warlock.js/ai/src/errors/tool-execution-error.ts","../../../../../../@warlock.js/ai/src/errors/workflow-cancelled-error.ts","../../../../../../@warlock.js/ai/src/errors/workflow-drift-error.ts","../../../../../../@warlock.js/ai/src/middleware/utils/extract-user-text.ts","../../../../../../@warlock.js/ai/src/middleware/utils/namespaced-state.ts","../../../../../../@warlock.js/ai/src/middleware/builtins/budget.ts","../../../../../../@warlock.js/ai/src/middleware/builtins/guardrail.ts","../../../../../../@warlock.js/ai/src/config.ts","../../../../../../@warlock.js/ai/src/middleware/builtins/semantic-cache.ts","../../../../../../@warlock.js/ai/src/middleware/helpers/compose.ts","../../../../../../@warlock.js/ai/src/middleware/helpers/for-tool.ts","../../../../../../@warlock.js/ai/src/middleware/pipeline.ts","../../../../../../@warlock.js/ai/src/utils/compute-cost.ts","../../../../../../@warlock.js/ai/src/utils/extract-json-payload.ts","../../../../../../@warlock.js/ai/src/utils/generate-run-id.ts","../../../../../../@warlock.js/ai/src/utils/json-schema.ts","../../../../../../@warlock.js/ai/src/utils/resolve-attachment.ts","../../../../../../@warlock.js/ai/src/utils/prepare-attachment-part.ts","../../../../../../@warlock.js/ai/src/utils/safe-json-parse.ts","../../../../../../@warlock.js/ai/src/contracts/result/base-report.type.ts","../../../../../../@warlock.js/ai/src/utils/stamp-report-lineage.ts","../../../../../../@warlock.js/ai/src/utils/token-count.ts","../../../../../../@warlock.js/ai/src/agent/agent-input-builder.ts","../../../../../../@warlock.js/ai/src/agent/agent-log-event.ts","../../../../../../@warlock.js/ai/src/agent/agent-stream.ts","../../../../../../@warlock.js/ai/src/agent/agent-to-stream-event.ts","../../../../../../@warlock.js/ai/src/agent/json-stream-guard.ts","../../../../../../@warlock.js/ai/src/agent/agent.ts","../../../../../../@warlock.js/ai/src/tool/tool.ts","../../../../../../@warlock.js/ai/src/supervisor/as-tool.ts","../../../../../../@warlock.js/ai/src/supervisor/emitter.ts","../../../../../../@warlock.js/ai/src/supervisor/entries.ts","../../../../../../@warlock.js/ai/src/contracts/end.type.ts","../../../../../../@warlock.js/ai/src/supervisor/cancellation.ts","../../../../../../@warlock.js/ai/src/supervisor/router-prompt.ts","../../../../../../@warlock.js/ai/src/supervisor/decide.ts","../../../../../../@warlock.js/ai/src/supervisor/snapshot.ts","../../../../../../@warlock.js/ai/src/supervisor/execution.ts","../../../../../../@warlock.js/ai/src/supervisor/signature.ts","../../../../../../@warlock.js/ai/src/supervisor/supervisor-stream.ts","../../../../../../@warlock.js/ai/src/supervisor/supervisor.ts","../../../../../../@warlock.js/ai/src/system-prompt/render-placeholders.ts","../../../../../../@warlock.js/ai/src/system-prompt/instruction.ts","../../../../../../@warlock.js/ai/src/system-prompt/persona.ts","../../../../../../@warlock.js/ai/src/system-prompt/system-prompt.ts","../../../../../../@warlock.js/ai/src/workflow/step.ts","../../../../../../@warlock.js/ai/src/workflow/as-tool.ts","../../../../../../@warlock.js/ai/src/workflow/emitter.ts","../../../../../../@warlock.js/ai/src/workflow/cancellation.ts","../../../../../../@warlock.js/ai/src/workflow/router.ts","../../../../../../@warlock.js/ai/src/workflow/run-scoped-emitter.ts","../../../../../../@warlock.js/ai/src/workflow/snapshot.ts","../../../../../../@warlock.js/ai/src/workflow/state.ts","../../../../../../@warlock.js/ai/src/workflow/retry.ts","../../../../../../@warlock.js/ai/src/workflow/step-runner.ts","../../../../../../@warlock.js/ai/src/workflow/engine.ts","../../../../../../@warlock.js/ai/src/workflow/signature.ts","../../../../../../@warlock.js/ai/src/workflow/workflow.ts","../../../../../../@warlock.js/ai/src/ai.ts","../../../../../../@warlock.js/ai/src/mock/mock-model.ts","../../../../../../@warlock.js/ai/src/mock/mock-sdk.ts","../../../../../../@warlock.js/ai/src/mock/mock-agent.ts"],"sourcesContent":["import type { ErrorCategory } from \"./error-category.type\";\nimport type { AIErrorCode } from \"./error-code.type\";\n\n/**\n * Optional constructor payload shared by every `AIError` subclass.\n *\n * `cause` carries the original thrown value (SDK error, runtime crash,\n * validation failure) so downstream logging and debuggers can still\n * reach it. `context` is a free-form diagnostic bag for provider-raw\n * metadata (status codes, request ids, response headers) that shouldn't\n * be promoted to typed fields but is useful in logs and telemetry.\n *\n * **No `category` here.** Category is fixed per subclass via the\n * class-level `static defaultCategory`. Subclasses ARE their\n * category — `RateLimitError` is always `\"rate-limit\"`, never\n * something else at runtime. Direct `new AIError(...)` callers (the\n * one legitimate override case, since the base catch-all has no\n * specific class) receive a separate 4th constructor argument\n * instead, so the override is structurally unreachable from subclass\n * call sites.\n */\nexport type AIErrorOptions = {\n  cause?: unknown;\n  context?: Record<string, unknown>;\n};\n\n/**\n * Base class for every error thrown (or surfaced via `result.error`) by\n * `@warlock.js/ai` and its provider adapter packages.\n *\n * **Role.** The single typed error contract across the AI framework.\n * Every thrown error anywhere in `@warlock.js/ai*` is either an\n * `AIError` itself or one of its subclasses — plain `Error` must never\n * leak out. Consumers branch either on the narrow `error.code` (stable\n * string), on `error.category` (coarse dashboard grouping), or on\n * `instanceof` a specific subclass.\n *\n * **Independence.** Deliberately extends the platform `Error` directly\n * — never `HttpError` from `@warlock.js/core`. The AI framework is a\n * standalone product; coupling its error base to a web framework would\n * force every consumer to pull in the HTTP layer even when they only\n * use AI in a CLI, worker, or test.\n *\n * **Fields.**\n * - `code` — stable machine-readable identifier (see `AIErrorCode`).\n * - `category` — coarse `ErrorCategory` for dashboards / retry policy.\n *   Resolved at construction from the subclass's `static defaultCategory`\n *   (or, for direct `new AIError(...)` calls, from the explicit 4th\n *   constructor argument).\n * - `cause` — optional original thrown value (SDK error, nested error,\n *   raw value). Preserves root cause through re-wrapping.\n * - `context` — optional free-form diagnostic bag (status, requestId,\n *   headers). Consumers treat it as opaque; logs and telemetry read it.\n *\n * **Category override — direct AIError usage only.** Subclasses ARE\n * their category by type; there's no legitimate runtime override at\n * the subclass level. The 4th constructor argument exists ONLY for\n * direct `new AIError(...)` callers, who would otherwise be stuck with\n * the `\"unknown\"` default. Subclasses construct via `super(code,\n * message, options)` and physically cannot reach the override slot\n * through their own typed signatures.\n *\n * @example\n * try {\n *   await agent.execute(\"hello\");\n * } catch (error) {\n *   if (error instanceof AIError) {\n *     console.error(`[${error.code}] (${error.category}) ${error.message}`);\n *   }\n * }\n *\n * @example\n * // Direct AIError construction with explicit category — escape hatch\n * // for call sites that lack a specific subclass.\n * throw new AIError(\"UNEXPECTED\", \"transient glitch\", undefined, \"provider\");\n */\nexport class AIError extends Error {\n  /**\n   * Class-level category for every instance of this error type.\n   * Subclasses redeclare with their own concrete `ErrorCategory` so\n   * `error.category` is correct without per-call wiring. The base\n   * class keeps `\"unknown\"` so untyped direct throws of `AIError`\n   * itself remain honest about their lack of dispatch information\n   * (and can override via the 4th constructor argument).\n   */\n  public static readonly defaultCategory: ErrorCategory = \"unknown\";\n\n  public readonly code: AIErrorCode;\n  public readonly category: ErrorCategory;\n  public readonly context?: Record<string, unknown>;\n\n  public constructor(\n    code: AIErrorCode,\n    message: string,\n    options?: AIErrorOptions,\n    category?: ErrorCategory,\n  ) {\n    super(message);\n\n    this.name = \"AIError\";\n    this.code = code;\n    this.context = options?.context;\n    this.category = category ?? (this.constructor as typeof AIError).defaultCategory;\n\n    if (options?.cause !== undefined) {\n      (this as { cause?: unknown }).cause = options.cause;\n    }\n  }\n}\n","import { AIError, type AIErrorOptions } from \"./ai-error\";\nimport type { AIErrorCode } from \"./error-code.type\";\n\n/**\n * Base for agent runtime failures that aren't schema / tool / provider\n * problems — runtime-structural issues inside the trip loop or\n * authoring-time middleware misconfiguration. Two specialized\n * subclasses cover the two non-generic cases:\n *\n * - {@link AgentCancelledError} (`AGENT_CANCELLED`) — caller-driven\n *   abort via `AbortSignal`.\n * - {@link AgentMaxTripsError} (`AGENT_MAX_TRIPS`) — trip loop hit\n *   the `maxTrips` cap without a natural stop.\n *\n * Use the base class directly for anything else (unregistered tool\n * dispatch, authoring-time middleware validation, surprise\n * exceptions). The subclasses exist so consumers can branch on a\n * dedicated `instanceof` / category without inferring from `context`\n * flags or parsing the message.\n *\n * @example\n * if (result.error?.code === \"AGENT_EXEC_FAILED\") {\n *   logger.warn(\"unexpected agent failure\", result.error.context);\n * }\n */\nexport class AgentExecutionError extends AIError {\n  public constructor(\n    message: string,\n    options?: AIErrorOptions,\n    code: AIErrorCode = \"AGENT_EXEC_FAILED\",\n  ) {\n    super(code, message, options);\n    this.name = \"AgentExecutionError\";\n  }\n}\n","import { AgentExecutionError } from \"./agent-execution-error\";\nimport type { AIErrorOptions } from \"./ai-error\";\nimport type { ErrorCategory } from \"./error-category.type\";\n\n/**\n * Payload for {@link AgentCancelledError}. `cancelledAt` is the\n * ISO-8601 timestamp at which the abort was observed; `reason`\n * carries the value the caller supplied to `controller.abort(reason)`\n * when present.\n */\nexport type AgentCancelledErrorOptions = AIErrorOptions & {\n  cancelledAt?: string;\n  reason?: string;\n};\n\n/**\n * Agent run was cancelled via `AbortSignal` before it could finish.\n * Between-trip cancellation is guaranteed; mid-trip cancellation is\n * best-effort (the signal is threaded into the provider adapter's\n * HTTP client when supported).\n *\n * Surfaced on `result.error` rather than thrown — `agent.execute()`\n * still returns with `report.status = \"cancelled\"` and partial trip\n * history intact. Consumers branch on the class (not the message) to\n * distinguish caller-initiated stops from other failures.\n *\n * **Why split from `AgentExecutionError`.** Cancellation is a\n * different operational signal from \"the agent crashed\" — retry\n * policy and dashboards typically want different behavior for each.\n * Keeping cancellation in its own class lets the category\n * (`\"cancelled\"`) be set declaratively per type instead of inferred\n * from a `context.cancelled === true` flag.\n *\n * @example\n * const result = await agent.execute(input, { signal });\n * if (result.error instanceof AgentCancelledError) {\n *   // caller pulled the plug — don't retry, surface a \"stopped\" UI\n *   return { status: \"cancelled\" };\n * }\n */\nexport class AgentCancelledError extends AgentExecutionError {\n  public static readonly defaultCategory: ErrorCategory = \"cancelled\";\n\n  public readonly cancelledAt?: string;\n  public readonly reason?: string;\n\n  public constructor(message: string, options?: AgentCancelledErrorOptions) {\n    super(message, options, \"AGENT_CANCELLED\");\n    this.name = \"AgentCancelledError\";\n    this.cancelledAt = options?.cancelledAt;\n    this.reason = options?.reason;\n  }\n}\n","import { AgentExecutionError } from \"./agent-execution-error\";\nimport type { AIErrorOptions } from \"./ai-error\";\nimport type { ErrorCategory } from \"./error-category.type\";\n\n/**\n * Payload for {@link AgentMaxTripsError}. `maxTrips` is the cap the\n * agent hit — useful for log/metric attribution and for retry-with-\n * higher-cap recovery strategies.\n */\nexport type AgentMaxTripsErrorOptions = AIErrorOptions & {\n  maxTrips: number;\n};\n\n/**\n * Runaway-loop hard guard: the agent's trip loop ran `maxTrips` round\n * trips to the model without the model issuing a natural stop. The\n * loop terminates with this typed error on `result.error` and the\n * full trip history preserved in `result.report.trips` so consumers\n * can see where the loop got stuck.\n *\n * **Not retryable by default.** A run that hit the cap usually\n * indicates either a tool the agent can't satisfy (causing infinite\n * re-asks) or a model that won't commit to an answer. Bumping\n * `maxTrips` and retrying without root-causing the underlying issue\n * just burns more tokens.\n *\n * **Why split from `AgentExecutionError`.** The catch-all base wears\n * too many hats — cancellation vs. max-trips vs. generic crashes had\n * to be disambiguated from `context` flags or message regex. Split\n * subclasses let category dispatch (`\"max-trips\"`) and consumer\n * branching (`instanceof`) work without inference.\n *\n * @example\n * if (result.error instanceof AgentMaxTripsError) {\n *   logger.warn(\"agent hit trip cap\", { max: result.error.maxTrips });\n * }\n */\nexport class AgentMaxTripsError extends AgentExecutionError {\n  public static readonly defaultCategory: ErrorCategory = \"max-trips\";\n\n  public readonly maxTrips: number;\n\n  public constructor(message: string, options: AgentMaxTripsErrorOptions) {\n    super(message, options, \"AGENT_MAX_TRIPS\");\n    this.name = \"AgentMaxTripsError\";\n    this.maxTrips = options.maxTrips;\n  }\n}\n","import { AIError, type AIErrorOptions } from \"./ai-error\";\nimport type { ErrorCategory } from \"./error-category.type\";\n\n/**\n * Unit of the budget being enforced. `tokens` for context/output\n * caps, `usd` for monetary caps, `requests` for call-count caps.\n */\nexport type BudgetUnit = \"tokens\" | \"usd\" | \"requests\";\n\n/**\n * Payload for `BudgetExceededError`. All three fields are required so\n * consumers can present the breach numerically without having to\n * reparse the message.\n */\nexport type BudgetExceededErrorOptions = AIErrorOptions & {\n  limit: number;\n  actual: number;\n  unit: BudgetUnit;\n};\n\n/**\n * A user- or framework-configured budget was exceeded mid-execution.\n *\n * **Not thrown yet.** The class is defined here so v2's budget\n * middleware can throw it without a breaking release of the error\n * hierarchy. Shape is locked: `{ limit, actual, unit }`.\n *\n * @example\n * if (error instanceof BudgetExceededError && error.unit === \"usd\") {\n *   alertFinance(error.actual, error.limit);\n * }\n */\nexport class BudgetExceededError extends AIError {\n  public static readonly defaultCategory: ErrorCategory = \"budget\";\n\n  public readonly limit: number;\n  public readonly actual: number;\n  public readonly unit: BudgetUnit;\n\n  public constructor(message: string, options: BudgetExceededErrorOptions) {\n    super(\"BUDGET_EXCEEDED\", message, options);\n    this.name = \"BudgetExceededError\";\n    this.limit = options.limit;\n    this.actual = options.actual;\n    this.unit = options.unit;\n  }\n}\n","import { AIError, type AIErrorOptions } from \"./ai-error\";\nimport type { ErrorCategory } from \"./error-category.type\";\nimport type { AIErrorCode } from \"./error-code.type\";\n\n/**\n * Any failure that originated from the model provider (OpenAI, Azure,\n * OpenRouter, local gateway). Base class for the provider subclasses\n * below — raw provider errors caught in an adapter are always wrapped\n * into *some* `ProviderError` so downstream code can branch on\n * `instanceof ProviderError` when any provider-side failure will do.\n *\n * **Subclasses (more specific first).**\n * - `ProviderRateLimitError` — 429 / rate-limit / quota exhaustion.\n * - `ProviderTimeoutError` — connection or request timeout.\n * - `ContextLengthExceededError` — prompt exceeded the model window.\n * - `ContentFilterError` — response blocked by provider safety policy.\n * - `ProviderAuthError` — bad / expired API key.\n * - `InvalidRequestError` — catch-all 4xx not covered above.\n *\n * When no subclass fits (e.g. 5xx server error, unknown network\n * failure), adapters throw plain `ProviderError` with the raw payload\n * captured in `context`.\n *\n * @example\n * if (result.error instanceof ProviderError) {\n *   if (result.error instanceof ProviderRateLimitError) {\n *     return retryAfter(result.error.retryAfter ?? 1000);\n *   }\n * }\n */\nexport class ProviderError extends AIError {\n  public static readonly defaultCategory: ErrorCategory = \"provider\";\n\n  public constructor(\n    message: string,\n    options?: AIErrorOptions,\n    code: AIErrorCode = \"PROVIDER_ERROR\",\n  ) {\n    super(code, message, options);\n    this.name = \"ProviderError\";\n  }\n}\n","import type { AIErrorOptions } from \"./ai-error\";\nimport type { ErrorCategory } from \"./error-category.type\";\nimport { ProviderError } from \"./provider-error\";\n\n/**\n * Payload for `ContentFilterError`. Both fields optional — providers\n * don't consistently disclose the specific filter reason or\n * categories, especially when the block is pre-generation.\n */\nexport type ContentFilterErrorOptions = AIErrorOptions & {\n  reason?: string;\n  categories?: string[];\n};\n\n/**\n * Response (or request) was blocked by the provider's safety filter.\n * Not retryable with the same input — reshape the prompt or lean on\n * a less-restrictive model.\n *\n * @example\n * if (result.error instanceof ContentFilterError) {\n *   return respondWithPolicyMessage(result.error.reason);\n * }\n */\nexport class ContentFilterError extends ProviderError {\n  public static readonly defaultCategory: ErrorCategory = \"content-filter\";\n\n  public readonly reason?: string;\n  public readonly categories?: string[];\n\n  public constructor(message: string, options?: ContentFilterErrorOptions) {\n    super(message, options, \"CONTENT_FILTER\");\n    this.name = \"ContentFilterError\";\n    this.reason = options?.reason;\n    this.categories = options?.categories;\n  }\n}\n","import type { AIErrorOptions } from \"./ai-error\";\nimport type { ErrorCategory } from \"./error-category.type\";\nimport { ProviderError } from \"./provider-error\";\n\n/**\n * Payload for `ContextLengthExceededError`. All fields are optional —\n * providers inconsistently surface exact token counts and the\n * model's limit. When present, they let callers compute a trim\n * target; when absent, the error still categorizes the failure.\n */\nexport type ContextLengthExceededErrorOptions = AIErrorOptions & {\n  limit?: number;\n  actual?: number;\n  modelName?: string;\n};\n\n/**\n * The request's prompt (messages + tools + schema) exceeded the\n * model's context window. Not retryable without shortening the input.\n *\n * Typically surfaced as OpenAI 400 with `code: \"context_length_exceeded\"`.\n *\n * @example\n * if (result.error instanceof ContextLengthExceededError) {\n *   messages = truncateOldestTurns(messages);\n *   return agent.execute(input, { history: messages });\n * }\n */\nexport class ContextLengthExceededError extends ProviderError {\n  public static readonly defaultCategory: ErrorCategory = \"context-length\";\n\n  public readonly limit?: number;\n  public readonly actual?: number;\n  public readonly modelName?: string;\n\n  public constructor(\n    message: string,\n    options?: ContextLengthExceededErrorOptions,\n  ) {\n    super(message, options, \"CONTEXT_LENGTH_EXCEEDED\");\n    this.name = \"ContextLengthExceededError\";\n    this.limit = options?.limit;\n    this.actual = options?.actual;\n    this.modelName = options?.modelName;\n  }\n}\n","import { AIError, type AIErrorOptions } from \"./ai-error\";\nimport type { ErrorCategory } from \"./error-category.type\";\n\n/**\n * Phase at which a guardrail rejected the content — `\"input\"` when the\n * violation was detected on the outbound prompt (before the model saw\n * it), `\"output\"` when it was detected on the model's response (before\n * the caller saw it).\n */\nexport type GuardrailPhase = \"input\" | \"output\";\n\n/**\n * Payload for `GuardrailViolationError`. `phase` tells the caller\n * whether the prompt or the response tripped the check; `reason` is\n * the free-form explanation the guardrail middleware produced;\n * `guardrail` names the offending middleware so operators can tune a\n * specific rule without hunting through logs.\n */\nexport type GuardrailViolationErrorOptions = AIErrorOptions & {\n  phase: GuardrailPhase;\n  reason: string;\n  guardrail?: string;\n};\n\n/**\n * A guardrail middleware rejected the prompt or response mid-execution.\n *\n * **Role.** The typed abort surface for `ai.middleware.guardrail`.\n * Consumers branch on `error.phase` to distinguish \"the user asked\n * something disallowed\" (`\"input\"`) from \"the model produced something\n * disallowed\" (`\"output\"`) — the two failure modes have very different\n * product responses (block vs. retry, or surface a policy message vs.\n * re-prompt the model).\n *\n * Thrown from inside the middleware pipeline's `trip.before` / `trip.after`\n * hooks; surfaced to the caller via `result.error` like every other\n * `AIError`.\n *\n * @example\n * if (result.error instanceof GuardrailViolationError) {\n *   if (result.error.phase === \"input\") {\n *     return respondWithPolicyMessage(result.error.reason);\n *   }\n *   return retryWithSanitizedPrompt();\n * }\n */\nexport class GuardrailViolationError extends AIError {\n  public static readonly defaultCategory: ErrorCategory = \"guardrail\";\n\n  public readonly phase: GuardrailPhase;\n  public readonly reason: string;\n  public readonly guardrail?: string;\n\n  public constructor(message: string, options: GuardrailViolationErrorOptions) {\n    super(\"GUARDRAIL_VIOLATION\", message, options);\n\n    this.name = \"GuardrailViolationError\";\n    this.phase = options.phase;\n    this.reason = options.reason;\n    this.guardrail = options.guardrail;\n  }\n}\n","import type { AIErrorOptions } from \"./ai-error\";\nimport type { ErrorCategory } from \"./error-category.type\";\nimport { ProviderError } from \"./provider-error\";\n\n/**\n * Provider rejected the request as malformed — bad model name,\n * unsupported feature, missing required field, image attached to a\n * non-vision model, etc. The catch-all for 4xx responses that aren't\n * auth, rate-limit, context-length, or content-filter.\n *\n * Also thrown from the agent when user-side validation fails at the\n * boundary (e.g. vision gate, malformed attachment shape) — the\n * category is \"you sent something the provider / agent cannot use\".\n *\n * @example\n * if (result.error instanceof InvalidRequestError) {\n *   logger.error(\"bad agent input\", { context: result.error.context });\n * }\n */\nexport class InvalidRequestError extends ProviderError {\n  public static readonly defaultCategory: ErrorCategory = \"validation\";\n\n  public constructor(message: string, options?: AIErrorOptions) {\n    super(message, options, \"PROVIDER_INVALID_REQUEST\");\n    this.name = \"InvalidRequestError\";\n  }\n}\n","import { AIError, type AIErrorOptions } from \"./ai-error\";\nimport type { AIErrorCode } from \"./error-code.type\";\n\n/**\n * Base class for every supervisor-specific failure surfaced from\n * `supervisor.execute()` / `supervisor.resume()` / authoring-time\n * `ai.supervisor()` validation.\n *\n * **Role.** Anchor for the `SUPERVISOR_*` code family. Subclasses\n * carry precise codes (`SUPERVISOR_MAX_ITERATIONS`,\n * `SUPERVISOR_INVALID_ROUTE`, …); this base catches everything a\n * supervisor run can produce that isn't already an agent / tool /\n * provider / workflow error bubbling up from a child execution.\n *\n * Child-execution errors (agent, tool, provider, workflow) flow\n * through the supervisor unchanged — they are captured on the\n * relevant branch snapshot and, if fatal, wrapped as the `cause` of a\n * `SupervisorFailedError` only when the supervisor itself has no\n * narrower subclass to throw.\n *\n * @example\n * try {\n *   ai.supervisor({\n *     route: () => \"triage\",\n *     router: routerAgent,\n *     intents: { triage },\n *   });\n * } catch (error) {\n *   if (error instanceof SupervisorFailedError) {\n *     console.error(error.code, error.message);\n *   }\n * }\n */\nexport class SupervisorFailedError extends AIError {\n  public constructor(\n    message: string,\n    options?: AIErrorOptions,\n    code: AIErrorCode = \"SUPERVISOR_FAILED\",\n  ) {\n    super(code, message, options);\n    this.name = \"SupervisorFailedError\";\n  }\n}\n","import type { AIErrorOptions } from \"./ai-error\";\nimport type { ErrorCategory } from \"./error-category.type\";\nimport { SupervisorFailedError } from \"./supervisor-failed-error\";\n\nexport type MaxIterationsErrorOptions = AIErrorOptions & {\n  maxIterations: number;\n};\n\n/**\n * Hard-cap guard: the supervisor ran `maxIterations` loop turns\n * without reaching a terminal decision (`END`, `satisfied: true`, or\n * cancellation). Terminates the run immediately with a typed error on\n * `result.error` — partial per-iteration snapshots are still\n * available on `result.report.snapshots`.\n *\n * @example\n * const { error, report } = await supervisor.execute(input);\n * if (error?.code === \"SUPERVISOR_MAX_ITERATIONS\") {\n *   logger.warn(\"supervisor did not converge\", {\n *     iterations: report.iterations,\n *   });\n * }\n */\nexport class MaxIterationsError extends SupervisorFailedError {\n  public static readonly defaultCategory: ErrorCategory = \"max-iterations\";\n\n  public readonly maxIterations: number;\n\n  public constructor(message: string, options: MaxIterationsErrorOptions) {\n    super(message, options, \"SUPERVISOR_MAX_ITERATIONS\");\n    this.name = \"MaxIterationsError\";\n    this.maxIterations = options.maxIterations;\n  }\n}\n","import { AIError, type AIErrorOptions } from \"./ai-error\";\nimport type { AIErrorCode } from \"./error-code.type\";\n\n/**\n * Base class for all workflow-specific failures. Subclasses carry\n * precise codes; this base catches everything `workflow.execute()`\n * can produce beyond agent/tool/provider errors.\n */\nexport class WorkflowError extends AIError {\n  public constructor(\n    message: string,\n    options?: AIErrorOptions,\n    code: AIErrorCode = \"WORKFLOW_ERROR\",\n  ) {\n    super(code, message, options);\n    this.name = \"WorkflowError\";\n  }\n}\n","import type { AIErrorOptions } from \"./ai-error\";\nimport type { ErrorCategory } from \"./error-category.type\";\nimport { WorkflowError } from \"./workflow-error\";\n\nexport type MaxStepsExceededErrorOptions = AIErrorOptions & {\n  maxSteps: number;\n};\n\n/**\n * Runaway-loop hard guard: workflow executed more step transitions\n * than `maxSteps` allows. Terminates the workflow immediately.\n */\nexport class MaxStepsExceededError extends WorkflowError {\n  public static readonly defaultCategory: ErrorCategory = \"max-steps\";\n\n  public readonly maxSteps: number;\n\n  public constructor(message: string, options: MaxStepsExceededErrorOptions) {\n    super(message, options, \"WORKFLOW_MAX_STEPS\");\n    this.name = \"MaxStepsExceededError\";\n    this.maxSteps = options.maxSteps;\n  }\n}\n","import type { AIErrorOptions } from \"./ai-error\";\nimport type { ErrorCategory } from \"./error-category.type\";\nimport { ProviderError } from \"./provider-error\";\n\n/**\n * Provider rejected the credential — missing / invalid / expired API\n * key or insufficient permissions on the underlying account. Not\n * retryable; fix the credential and retry.\n *\n * @example\n * if (result.error instanceof ProviderAuthError) {\n *   notifyOps(\"rotate API key\", result.error.context);\n * }\n */\nexport class ProviderAuthError extends ProviderError {\n  public static readonly defaultCategory: ErrorCategory = \"auth\";\n\n  public constructor(message: string, options?: AIErrorOptions) {\n    super(message, options, \"PROVIDER_AUTH\");\n    this.name = \"ProviderAuthError\";\n  }\n}\n","import type { AIErrorOptions } from \"./ai-error\";\nimport type { ErrorCategory } from \"./error-category.type\";\nimport { ProviderError } from \"./provider-error\";\n\n/**\n * Payload for `ProviderRateLimitError`. `retryAfter` is the server's\n * hint (typically parsed from the `Retry-After` header) in milliseconds.\n */\nexport type ProviderRateLimitErrorOptions = AIErrorOptions & {\n  retryAfter?: number;\n};\n\n/**\n * Provider refused the call because the account (or key, or window)\n * is over its rate-limit or quota. Retryable after `retryAfter`\n * milliseconds — consumers are expected to back off before retrying.\n *\n * Covers both transient `429 Too Many Requests` and the billing-level\n * `insufficient_quota` case; the adapter decides which provider\n * signals map here.\n *\n * @example\n * if (result.error instanceof ProviderRateLimitError) {\n *   await sleep(result.error.retryAfter ?? 1000);\n * }\n */\nexport class ProviderRateLimitError extends ProviderError {\n  public static readonly defaultCategory: ErrorCategory = \"rate-limit\";\n\n  public readonly retryAfter?: number;\n\n  public constructor(message: string, options?: ProviderRateLimitErrorOptions) {\n    super(message, options, \"PROVIDER_RATE_LIMIT\");\n    this.name = \"ProviderRateLimitError\";\n    this.retryAfter = options?.retryAfter;\n  }\n}\n","import type { AIErrorOptions } from \"./ai-error\";\nimport type { ErrorCategory } from \"./error-category.type\";\nimport { ProviderError } from \"./provider-error\";\n\n/**\n * Provider call timed out — either at the transport layer (socket\n * connection) or on the server side (request exceeded the provider's\n * processing deadline). Idempotent retries are usually safe.\n *\n * @example\n * if (result.error instanceof ProviderTimeoutError) {\n *   return retry();\n * }\n */\nexport class ProviderTimeoutError extends ProviderError {\n  public static readonly defaultCategory: ErrorCategory = \"timeout\";\n\n  public constructor(message: string, options?: AIErrorOptions) {\n    super(message, options, \"PROVIDER_TIMEOUT\");\n    this.name = \"ProviderTimeoutError\";\n  }\n}\n","import type { AIErrorOptions } from \"./ai-error\";\nimport type { ErrorCategory } from \"./error-category.type\";\nimport { ProviderError } from \"./provider-error\";\n\n/**\n * Provider refused the call because the account has exhausted its\n * paid quota (monthly credit, billing cap, subscription tier limit).\n *\n * **Not retryable.** Unlike `ProviderRateLimitError` — where the\n * bucket refills after `retryAfter` milliseconds — this one needs\n * human intervention: top up the account, upgrade the plan, or\n * switch to a different key. Consumers who blindly back-off-and-retry\n * on rate-limit errors would loop forever here, which is why the two\n * are split.\n *\n * Typically surfaced as OpenAI `code: \"insufficient_quota\"`.\n *\n * **Distinct from `BudgetExceededError`.** `QuotaExceededError` is\n * the *provider* telling us their billing cap is hit.\n * `BudgetExceededError` is our *own* middleware enforcing a\n * user-configured ceiling client-side.\n *\n * @example\n * if (result.error instanceof QuotaExceededError) {\n *   await pagerDuty.trigger(\"openai quota exhausted\");\n *   return fallbackResponse();\n * }\n */\nexport class QuotaExceededError extends ProviderError {\n  public static readonly defaultCategory: ErrorCategory = \"quota\";\n\n  public constructor(message: string, options?: AIErrorOptions) {\n    super(message, options, \"PROVIDER_QUOTA_EXCEEDED\");\n    this.name = \"QuotaExceededError\";\n  }\n}\n","import type { AIErrorOptions } from \"./ai-error\";\nimport type { ErrorCategory } from \"./error-category.type\";\nimport { WorkflowError } from \"./workflow-error\";\n\nexport type RoutingErrorOptions = AIErrorOptions & {\n  stepName: string;\n  targetName?: string;\n};\n\n/**\n * `nextStep` returned an invalid `goto`, or the `nextStep` callback\n * itself threw. Routing is authoritative and has no recovery path —\n * the workflow terminates immediately.\n */\nexport class RoutingError extends WorkflowError {\n  public static readonly defaultCategory: ErrorCategory = \"routing\";\n\n  public readonly stepName: string;\n  public readonly targetName?: string;\n\n  public constructor(message: string, options: RoutingErrorOptions) {\n    super(message, options, \"WORKFLOW_INVALID_GOTO\");\n    this.name = \"RoutingError\";\n    this.stepName = options.stepName;\n    this.targetName = options.targetName;\n  }\n}\n","import type { StandardSchemaV1 } from \"@standard-schema/spec\";\nimport { AIError, type AIErrorOptions } from \"./ai-error\";\nimport type { ErrorCategory } from \"./error-category.type\";\n\n/**\n * Payload passed to `SchemaValidationError`. Subset of\n * `AIErrorOptions` plus the machine-readable validation issues list.\n */\nexport type SchemaValidationErrorOptions = AIErrorOptions & {\n  issues?: readonly StandardSchemaV1.Issue[];\n};\n\n/**\n * A `StandardSchemaV1` validation call returned issues, or the input\n * was not valid JSON before validation could even run.\n *\n * Produced in two places today:\n * - Agent output parsing — the final trip text failed `JSON.parse` or\n *   the parsed value failed `~standard.validate`.\n * - Tool input validation — the model's raw arguments for a tool call\n *   didn't match the tool's `input` schema.\n *\n * `issues` carries the structured validation result when available so\n * consumers can present per-field feedback.\n *\n * @example\n * if (result.error instanceof SchemaValidationError) {\n *   for (const issue of result.error.issues ?? []) {\n *     console.warn(issue.path, issue.message);\n *   }\n * }\n */\nexport class SchemaValidationError extends AIError {\n  public static readonly defaultCategory: ErrorCategory = \"schema\";\n\n  public readonly issues?: readonly StandardSchemaV1.Issue[];\n\n  public constructor(message: string, options?: SchemaValidationErrorOptions) {\n    super(\"SCHEMA_VALIDATION_FAILED\", message, options);\n    this.name = \"SchemaValidationError\";\n    this.issues = options?.issues;\n  }\n}\n","import type { AIErrorOptions } from \"./ai-error\";\nimport { WorkflowError } from \"./workflow-error\";\n\nexport type StepFailedErrorOptions = AIErrorOptions & {\n  stepName: string;\n  attempts: number;\n};\n\n/**\n * A workflow step exhausted its retries (or was not retried) and\n * terminated with an error. `cause` carries the last underlying error.\n */\nexport class StepFailedError extends WorkflowError {\n  public readonly stepName: string;\n  public readonly attempts: number;\n\n  public constructor(message: string, options: StepFailedErrorOptions) {\n    super(message, options, \"STEP_FAILED\");\n    this.name = \"StepFailedError\";\n    this.stepName = options.stepName;\n    this.attempts = options.attempts;\n  }\n}\n","import type { AIErrorOptions } from \"./ai-error\";\nimport type { ErrorCategory } from \"./error-category.type\";\nimport { SupervisorFailedError } from \"./supervisor-failed-error\";\n\nexport type SupervisorCancelledErrorOptions = AIErrorOptions & {\n  /** ISO-8601 timestamp at which the abort was observed by the supervisor. */\n  cancelledAt: string;\n  /** `controller.abort(reason)` payload when the caller supplied one. */\n  reason?: string;\n};\n\n/**\n * Supervisor run was cancelled via `AbortSignal` before it could\n * finish. Between-iteration cancellation is guaranteed; mid-iteration\n * cancellation is best-effort (the signal is also threaded into every\n * in-flight child `execute()` call, but effectiveness depends on the\n * child primitive respecting it).\n *\n * On cancellation the supervisor returns normally with `status:\n * \"cancelled\"` and partial `report.snapshots` — the error is placed\n * on `result.error` rather than thrown.\n */\nexport class SupervisorCancelledError extends SupervisorFailedError {\n  public static readonly defaultCategory: ErrorCategory = \"cancelled\";\n\n  public readonly cancelledAt: string;\n  public readonly reason?: string;\n\n  public constructor(\n    message: string,\n    options: SupervisorCancelledErrorOptions,\n  ) {\n    super(message, options, \"SUPERVISOR_CANCELLED\");\n    this.name = \"SupervisorCancelledError\";\n    this.cancelledAt = options.cancelledAt;\n    this.reason = options.reason;\n  }\n}\n","import type { AIErrorOptions } from \"./ai-error\";\nimport type { ErrorCategory } from \"./error-category.type\";\nimport { SupervisorFailedError } from \"./supervisor-failed-error\";\n\nexport type SupervisorDriftErrorOptions = AIErrorOptions & {\n  /** Signature recorded on the snapshot being resumed. */\n  savedSignature: string;\n  /** Signature computed from the current supervisor definition. */\n  currentSignature: string;\n  runId: string;\n};\n\n/**\n * `supervisor.resume(runId)` loaded a snapshot whose structural\n * fingerprint does not match the current supervisor definition\n * (agent keys + descriptions + router identity + route presence).\n * The resume is refused — no iteration runs — and the user decides\n * how to recover: discard the snapshot, migrate manually, or call\n * `resume(runId, { force: true })` to bypass the check.\n *\n * Mirrors `WorkflowDriftError` for workflow resume — same rationale,\n * different primitive.\n */\nexport class SupervisorDriftError extends SupervisorFailedError {\n  public static readonly defaultCategory: ErrorCategory = \"drift\";\n\n  public readonly savedSignature: string;\n  public readonly currentSignature: string;\n  public readonly runId: string;\n\n  public constructor(message: string, options: SupervisorDriftErrorOptions) {\n    super(message, options, \"SUPERVISOR_DRIFT\");\n    this.name = \"SupervisorDriftError\";\n    this.savedSignature = options.savedSignature;\n    this.currentSignature = options.currentSignature;\n    this.runId = options.runId;\n  }\n}\n","import type { AIErrorOptions } from \"./ai-error\";\nimport type { ErrorCategory } from \"./error-category.type\";\nimport { SupervisorFailedError } from \"./supervisor-failed-error\";\n\nexport type SupervisorRoutingErrorOptions = AIErrorOptions & {\n  /**\n   * The raw value the `route` callback or router agent returned. Keyed\n   * `unknown` because a misbehaving router can emit any JSON value —\n   * consumers should format it for display, not trust its shape.\n   */\n  returned: unknown;\n  /** Every legal intent key configured on the supervisor at run time. */\n  availableKeys: string[];\n};\n\n/**\n * A `route` callback or router agent returned a value that doesn't\n * resolve to a configured agent key, a `string[]` of configured keys,\n * or the `END` sentinel. Routing is authoritative — there is no\n * recovery path, so the supervisor terminates the run immediately.\n *\n * Named `SupervisorRoutingError` (not `RoutingError`) to avoid\n * colliding with `@warlock.js/ai`'s existing workflow `RoutingError`\n * (`WORKFLOW_INVALID_GOTO`). Both carry the same semantic weight —\n * \"routing asked for something I can't dispatch\" — in their\n * respective primitives.\n *\n * @example\n * const { error } = await supervisor.execute(input);\n * if (error?.code === \"SUPERVISOR_INVALID_ROUTE\") {\n *   logger.error(\"bad router decision\", {\n *     returned: (error as SupervisorRoutingError).returned,\n *     available: (error as SupervisorRoutingError).availableKeys,\n *   });\n * }\n */\nexport class SupervisorRoutingError extends SupervisorFailedError {\n  public static readonly defaultCategory: ErrorCategory = \"routing\";\n\n  public readonly returned: unknown;\n  public readonly availableKeys: string[];\n\n  public constructor(message: string, options: SupervisorRoutingErrorOptions) {\n    super(message, options, \"SUPERVISOR_INVALID_ROUTE\");\n    this.name = \"SupervisorRoutingError\";\n    this.returned = options.returned;\n    this.availableKeys = options.availableKeys;\n  }\n}\n","import { AIError, type AIErrorOptions } from \"./ai-error\";\nimport type { ErrorCategory } from \"./error-category.type\";\n\n/**\n * Payload passed to `ToolExecutionError` — identifies which tool\n * failed and, when applicable, which trip it was dispatched from.\n */\nexport type ToolExecutionErrorOptions = AIErrorOptions & {\n  toolName: string;\n  tripIndex?: number;\n};\n\n/**\n * A registered tool's `execute()` threw during dispatch — the tool\n * code itself failed (not its input schema). The model's request was\n * valid; the implementation crashed.\n *\n * Carries `toolName` so consumers can branch on which tool failed\n * without regex-parsing the message, and `tripIndex` to correlate\n * with the `LLMTrip` entry in `result.report.trips`.\n *\n * @example\n * if (result.error instanceof ToolExecutionError) {\n *   metrics.increment(\"tool.failure\", { tool: result.error.toolName });\n * }\n */\nexport class ToolExecutionError extends AIError {\n  public static readonly defaultCategory: ErrorCategory = \"tool\";\n\n  public readonly toolName: string;\n  public readonly tripIndex?: number;\n\n  public constructor(message: string, options: ToolExecutionErrorOptions) {\n    super(\"TOOL_EXEC_FAILED\", message, options);\n    this.name = \"ToolExecutionError\";\n    this.toolName = options.toolName;\n    this.tripIndex = options.tripIndex;\n  }\n}\n","import type { AIErrorOptions } from \"./ai-error\";\nimport type { ErrorCategory } from \"./error-category.type\";\nimport { WorkflowError } from \"./workflow-error\";\n\nexport type WorkflowCancelledErrorOptions = AIErrorOptions & {\n  cancelledAt: string;\n  reason?: string;\n};\n\n/**\n * Workflow was cancelled via `AbortSignal` before it could finish.\n * `cancelledAt` is ISO timestamp at abort; `reason` carries the\n * `controller.abort(reason)` payload when provided.\n */\nexport class WorkflowCancelledError extends WorkflowError {\n  public static readonly defaultCategory: ErrorCategory = \"cancelled\";\n\n  public readonly cancelledAt: string;\n  public readonly reason?: string;\n\n  public constructor(message: string, options: WorkflowCancelledErrorOptions) {\n    super(message, options, \"WORKFLOW_CANCELLED\");\n    this.name = \"WorkflowCancelledError\";\n    this.cancelledAt = options.cancelledAt;\n    this.reason = options.reason;\n  }\n}\n","import type { AIErrorOptions } from \"./ai-error\";\nimport type { ErrorCategory } from \"./error-category.type\";\nimport { WorkflowError } from \"./workflow-error\";\n\nexport type WorkflowDriftErrorOptions = AIErrorOptions & {\n  savedSignature: string;\n  currentSignature: string;\n  runId: string;\n};\n\n/**\n * `workflow.resume(runId)` found a snapshot whose structural signature\n * doesn't match the current workflow definition. Thrown without\n * executing anything. User must discard, force, or migrate manually.\n */\nexport class WorkflowDriftError extends WorkflowError {\n  public static readonly defaultCategory: ErrorCategory = \"drift\";\n\n  public readonly savedSignature: string;\n  public readonly currentSignature: string;\n  public readonly runId: string;\n\n  public constructor(message: string, options: WorkflowDriftErrorOptions) {\n    super(message, options, \"WORKFLOW_DRIFT\");\n    this.name = \"WorkflowDriftError\";\n    this.savedSignature = options.savedSignature;\n    this.currentSignature = options.currentSignature;\n    this.runId = options.runId;\n  }\n}\n","import type { Message } from \"../../contracts/conversation-message.type\";\n\n/**\n * Pull the text a content-inspection middleware should care about\n * from the outbound message list.\n *\n * **Role.** Built-ins that inspect \"what the user just said\" — the\n * guardrail on `trip.before`, the semantic cache on `trip.before`,\n * future consumers like PII redactors — all need the same string:\n * the most recent `user`-role message's text content. This helper\n * is the single authority on how that string is resolved.\n *\n * **Behavior.**\n * - Walks `messages` from the end backwards so the LAST user turn\n *   wins (correct when the agent has history + a fresh prompt).\n * - Returns a plain string directly when `content` is a string.\n * - Joins `text` parts with `\"\\n\"` when `content` is a multipart\n *   `ContentPart[]`. Non-text parts (images, audio) are skipped —\n *   callers concerned with multimodal content inspect `request`\n *   / attachments separately.\n * - Returns `\"\"` when there is no user message at all (e.g. a trip\n *   composed entirely of tool results).\n *\n * @example\n * const prompt = extractUserText(context.messages);\n * if (!prompt) return;\n * const verdict = await inputCheck(prompt);\n */\nexport function extractUserText(messages: ReadonlyArray<Message>): string {\n  for (let index = messages.length - 1; index >= 0; index--) {\n    const message = messages[index];\n\n    if (message.role !== \"user\") {\n      continue;\n    }\n\n    if (typeof message.content === \"string\") {\n      return message.content;\n    }\n\n    if (Array.isArray(message.content)) {\n      return message.content\n        .filter((part) => part.type === \"text\")\n        .map((part) => (part as { text: string }).text)\n        .join(\"\\n\");\n    }\n  }\n\n  return \"\";\n}\n","import type { MiddlewareState } from \"../../contracts/middleware\";\n\n/**\n * Typed accessor over `ctx.state` for a single namespace key. Wraps\n * the raw `Map<string, unknown>` so middleware authors stop typing\n * `as Counters | undefined` on every read.\n *\n * **Role.** Every built-in middleware reads and writes one or two\n * entries in `ctx.state` under its own name. Without a helper,\n * every call-site looks like:\n *\n * ```ts\n * const counters = context.state.get(\"budget.counters\") as Counters | undefined;\n * if (!counters) { ... }\n * counters.tokens += n;\n * ```\n *\n * — cast noise, no type narrowing on `set`, no protection against\n * key typos. `namespacedState<T>` eliminates all three.\n *\n * **Scope.** Deliberately narrow: one key, typed value, four methods\n * (`get` / `set` / `delete` / `has`). Does NOT try to model compound\n * or nested keys — if you need those, use the raw `ctx.state` Map\n * directly, or create a second namespaced accessor for the second key.\n *\n * **Namespace convention.** Use the middleware's `name` as the key\n * (or a `name.<field>` prefix when a middleware needs multiple\n * entries). The pipeline does not enforce this — it is a convention\n * the built-ins follow to avoid collisions between middlewares.\n *\n * @example\n * // Inside a budget middleware:\n * const counters = namespacedState<Counters>(ctx, \"budget\");\n *\n * if (!counters.has()) {\n *   counters.set({ tokens: 0, costUSD: 0 });\n * }\n *\n * const current = counters.get()!;\n * current.tokens += response.usage.total;\n */\nexport function namespacedState<T>(\n  ctx: { readonly state: MiddlewareState },\n  namespace: string,\n): NamespacedStateAccessor<T> {\n  return {\n    get(): T | undefined {\n      return ctx.state.get(namespace) as T | undefined;\n    },\n    set(value: T): void {\n      ctx.state.set(namespace, value);\n    },\n    delete(): void {\n      ctx.state.delete(namespace);\n    },\n    has(): boolean {\n      return ctx.state.has(namespace);\n    },\n  };\n}\n\n/**\n * Four-method accessor returned by `namespacedState`. Callers hold\n * it for the lifetime of a hook body — it is a thin typed view over\n * `ctx.state`, not a detached snapshot. Reads are live; writes hit\n * the underlying Map immediately and are visible to every other\n * hook that uses the same namespace.\n */\nexport type NamespacedStateAccessor<T> = {\n  get(): T | undefined;\n  set(value: T): void;\n  delete(): void;\n  has(): boolean;\n};\n","import type { AgentMiddleware } from \"../../contracts/middleware\";\nimport { BudgetExceededError, type BudgetUnit } from \"../../errors\";\nimport { namespacedState } from \"../utils\";\n\n/**\n * Per-model pricing used to compute USD cost from token counts.\n * Caller-supplied — no bundled table. Keys are model names (the\n * `ModelContract.name` value); values are input / output token\n * prices expressed as **USD per 1K tokens** to match every major\n * provider's published pricing sheet.\n */\nexport type BudgetPricing = Record<\n  string,\n  {\n    /** USD per 1,000 input tokens. */\n    inputPer1K: number;\n    /** USD per 1,000 output tokens. */\n    outputPer1K: number;\n  }\n>;\n\n/**\n * Configuration for `budget()`. At least one of `maxTokens` or\n * `maxCostUSD` must be supplied — a budget with no cap is a no-op.\n */\nexport type BudgetOptions = {\n  /**\n   * Hard cap on cumulative total tokens (input + output, summed\n   * across every trip of the run). Inclusive — exceeding triggers\n   * the configured `onExceeded`.\n   */\n  maxTokens?: number;\n  /**\n   * Hard cap on cumulative USD cost. Requires `pricing` for the\n   * agent's configured model — without a pricing entry the USD check\n   * silently skips (tokens-only enforcement still applies).\n   */\n  maxCostUSD?: number;\n  /**\n   * Per-model pricing table used to compute USD cost. Only consulted\n   * when `maxCostUSD` is set. Model names must match the running\n   * agent's `ModelContract.name` exactly.\n   */\n  pricing?: BudgetPricing;\n  /**\n   * Behavior when a cap is breached. `\"abort\"` throws\n   * `BudgetExceededError` — surfaces on `result.error`, stops the\n   * run at the next trip boundary. `\"warn\"` logs a warning and\n   * lets the run continue (useful for observability-first rollouts\n   * before flipping the switch to abort). Default `\"abort\"`.\n   */\n  onExceeded?: \"abort\" | \"warn\";\n  /**\n   * Override the middleware name. Useful when two budgets coexist\n   * (e.g. a per-request cap plus a session-wide cap via different\n   * instances). Default `\"budget\"`.\n   */\n  name?: string;\n};\n\ntype BudgetCounters = {\n  tokens: number;\n  costUSD: number;\n  warned: boolean;\n};\n\nfunction breach(\n  limit: number,\n  actual: number,\n  unit: BudgetUnit,\n  name: string,\n): never {\n  throw new BudgetExceededError(\n    `budget \"${name}\" exceeded — ${actual} ${unit} (cap: ${limit})`,\n    { limit, actual, unit },\n  );\n}\n\n/**\n * Enforced token and / or USD budget for an agent run.\n *\n * **Role.** Guards against runaway tool loops, misconfigured\n * prompts, and unexpected provider price swings by capping\n * cumulative usage across every LLM trip of a single execution.\n * Aborts the run with a typed `BudgetExceededError` the moment a cap\n * is breached, rather than letting the damage grow trip by trip.\n *\n * **Scope.** Per-execution. A fresh counter is created at\n * `execute.before` and lives in the middleware state bag until the\n * run ends. Two concurrent `agent.execute()` calls on the same\n * agent therefore enforce the cap independently.\n *\n * **Token accounting.** After each successful trip, the middleware\n * adds `response.usage.total` to its running total and checks\n * against `maxTokens`. Synthetic trips (cache hits) contribute\n * `usage.total` as returned by the cache — cache middleware is\n * expected to surface zero usage on a hit, which naturally excludes\n * those trips from the budget.\n *\n * **USD accounting.** When `maxCostUSD` + `pricing[modelName]` are\n * both present, the middleware converts per-trip input / output\n * tokens to USD and accumulates. Missing pricing silently degrades\n * to tokens-only — explicit rather than guessing.\n *\n * **Warn mode.** `onExceeded: \"warn\"` logs a single warning the first\n * time a cap is breached and lets the run continue. Useful for\n * measuring real-world traffic against a proposed cap before flipping\n * to `\"abort\"` in production.\n *\n * @example\n * const budgetMiddleware = budget({ maxTokens: 50_000 });\n *\n * const myAgent = agent({\n *   model,\n *   middleware: [budgetMiddleware],\n * });\n *\n * @example\n * // With USD cap and custom pricing\n * const guard = budget({\n *   maxCostUSD: 0.5,\n *   pricing: {\n *     \"gpt-4o\": { inputPer1K: 0.005, outputPer1K: 0.015 },\n *   },\n * });\n */\nexport function budget(options: BudgetOptions): AgentMiddleware {\n  const name = options.name ?? \"budget\";\n  const onExceeded = options.onExceeded ?? \"abort\";\n  const hasTokenCap = typeof options.maxTokens === \"number\";\n  const hasCostCap = typeof options.maxCostUSD === \"number\";\n\n  return {\n    name,\n    execute: {\n      before(context) {\n        const counters = namespacedState<BudgetCounters>(context, name);\n        counters.set({ tokens: 0, costUSD: 0, warned: false });\n      },\n    },\n    trip: {\n      after(context, response) {\n        const counters = namespacedState<BudgetCounters>(context, name).get();\n\n        if (!counters) {\n          return;\n        }\n\n        counters.tokens += response.usage.total;\n\n        if (hasCostCap && options.pricing) {\n          const pricing = options.pricing[context.model.name];\n\n          if (pricing) {\n            const tripCost =\n              (response.usage.input / 1000) * pricing.inputPer1K +\n              (response.usage.output / 1000) * pricing.outputPer1K;\n            counters.costUSD += tripCost;\n          }\n        }\n\n        if (hasTokenCap && counters.tokens > options.maxTokens!) {\n          if (onExceeded === \"abort\") {\n            breach(options.maxTokens!, counters.tokens, \"tokens\", name);\n          }\n\n          if (!counters.warned) {\n            counters.warned = true;\n          }\n        }\n\n        if (hasCostCap && counters.costUSD > options.maxCostUSD!) {\n          if (onExceeded === \"abort\") {\n            breach(options.maxCostUSD!, counters.costUSD, \"usd\", name);\n          }\n\n          if (!counters.warned) {\n            counters.warned = true;\n          }\n        }\n      },\n    },\n  };\n}\n","import type {\n  AgentMiddleware,\n  MiddlewareTripContext,\n} from \"../../contracts/middleware\";\nimport type { ModelResponse } from \"../../contracts/model.contract\";\nimport { GuardrailViolationError } from \"../../errors\";\nimport { extractUserText } from \"../utils\";\n\n/**\n * Decision returned by a guardrail check function. `ok: true`\n * permits the call; `ok: false` rejects with a human-readable\n * `reason` surfaced on `GuardrailViolationError`.\n */\nexport type GuardrailCheckResult = { ok: true } | { ok: false; reason: string };\n\n/**\n * Synchronous or asynchronous check invoked against the outbound\n * prompt (`inputCheck`) or the inbound response (`outputCheck`).\n * Receives the raw text and the surrounding trip context so\n * consumers can classify, route to an external moderation API, or\n * branch on tripIndex / messages history.\n */\nexport type GuardrailCheck = (\n  text: string,\n  context: MiddlewareTripContext,\n) => GuardrailCheckResult | Promise<GuardrailCheckResult>;\n\n/**\n * Configuration for `guardrail()`.  At least one of `inputCheck` or\n * `outputCheck` must be supplied — a guardrail with no checks is a\n * no-op.\n */\nexport type GuardrailOptions = {\n  /**\n   * Run against the outbound prompt just before the model sees it.\n   * Fires every trip with the concatenated last user-message text.\n   * Rejection aborts the trip with a `GuardrailViolationError` whose\n   * `phase === \"input\"`.\n   */\n  inputCheck?: GuardrailCheck;\n  /**\n   * Run against the model's response text after the trip completes.\n   * Fires every trip with `response.content`. Rejection aborts with\n   * a `GuardrailViolationError` whose `phase === \"output\"`.\n   *\n   * Output checks run BEFORE any tool dispatch — a rejected response\n   * means the tool calls it requested are never invoked.\n   */\n  outputCheck?: GuardrailCheck;\n  /**\n   * Override the middleware name — surfaces on\n   * `GuardrailViolationError.guardrail` so operators can tell two\n   * guardrails apart in logs. Default `\"guardrail\"`.\n   */\n  name?: string;\n};\n\n/**\n * Pre/post content guardrail for an agent run.\n *\n * **Role.** Inspects outbound prompts and inbound responses against\n * caller-supplied policies, aborting the trip with a typed\n * `GuardrailViolationError` when either trips a check. Consumers\n * distinguish `\"input\"` vs `\"output\"` violations off `error.phase`\n * — the two failure modes have very different product responses\n * (block the user vs re-prompt the model).\n *\n * **Scope.** Per-trip. Fires on every round-trip the agent makes,\n * including repair attempts and tool-follow-up trips. Input checks\n * evaluate the last user-role message; output checks evaluate the\n * raw model response text before any tool call is dispatched.\n *\n * **Composition.** A single middleware instance can carry both\n * `inputCheck` and `outputCheck`, or two separate instances can be\n * registered (useful when input and output policies come from\n * different teams / services). Registration order determines which\n * guardrail's violation surfaces first — the short-circuit throws\n * from the innermost offending hook, and outer guardrails never run\n * after an abort.\n *\n * **Not a sanitizer.** The guardrail either passes a trip unchanged\n * or aborts it. Mutating the prompt / response in-place is out of\n * scope — use a bespoke middleware for content rewriting.\n *\n * @example\n * const policy = guardrail({\n *   inputCheck: async (text) =>\n *     text.includes(\"SSN\") ? { ok: false, reason: \"pii\" } : { ok: true },\n *   outputCheck: async (text) =>\n *     text.length > 10_000 ? { ok: false, reason: \"too-long\" } : { ok: true },\n * });\n *\n * const myAgent = agent({ model, middleware: [policy] });\n */\nexport function guardrail(options: GuardrailOptions): AgentMiddleware {\n  const name = options.name ?? \"guardrail\";\n  const { inputCheck, outputCheck } = options;\n\n  return {\n    name,\n    trip: {\n      async before(context) {\n        if (!inputCheck) {\n          return;\n        }\n\n        const prompt = extractUserText(context.messages);\n\n        if (!prompt) {\n          return;\n        }\n\n        const verdict = await inputCheck(prompt, context);\n\n        if (!verdict.ok) {\n          throw new GuardrailViolationError(\n            `guardrail \"${name}\" rejected input — ${verdict.reason}`,\n            { phase: \"input\", reason: verdict.reason, guardrail: name },\n          );\n        }\n      },\n      async after(context, response: ModelResponse) {\n        if (!outputCheck) {\n          return;\n        }\n\n        if (!response.content) {\n          return;\n        }\n\n        const verdict = await outputCheck(response.content, context);\n\n        if (!verdict.ok) {\n          throw new GuardrailViolationError(\n            `guardrail \"${name}\" rejected output — ${verdict.reason}`,\n            { phase: \"output\", reason: verdict.reason, guardrail: name },\n          );\n        }\n      },\n    },\n  };\n}\n","import type { CacheDriver } from \"@warlock.js/cache\";\n\n/**\n * Process-wide `@warlock.js/ai` configuration. **Intentionally tiny.**\n * Lives here only for genuinely cross-cutting defaults that would\n * otherwise force users to wire the same value into every consumer.\n *\n * **What lives here.** A field earns a slot only when it satisfies\n * all three:\n * 1. Multiple unrelated consumers need the same value.\n * 2. The value is infrastructure (drivers, clients, pools), not\n *    behavior (kill-switches, mode flags).\n * 3. Per-call override doesn't make sense for the use case.\n *\n * **What does NOT live here.** Logger config (use\n * `@warlock.js/logger` directly). Per-primitive feature flags\n * (live on the relevant config type). Anything that's really one\n * consumer's concern (lives on that consumer).\n *\n * Phase 3.2 deliberately removed the previous `configureAI()` bag\n * because it was growing unbounded. Treat new fields here with the\n * same suspicion.\n */\nexport type AIConfig = {\n  /**\n   * Default store used by every consumer that supports persistence\n   * but didn't supply its own `store` / `snapshotStore`. Most\n   * realistic deployments back resume snapshots, semantic cache, and\n   * future memory primitives with the same driver — declaring it\n   * once here removes the repetition.\n   *\n   * Per-declaration overrides (`SupervisorConfig.snapshotStore`,\n   * `semanticCache({ store })`) win when supplied. Set this once at\n   * app boot, *after* you've constructed your driver.\n   *\n   * @example\n   * import { cache } from \"@warlock.js/cache\";\n   * import { ai } from \"@warlock.js/ai\";\n   *\n   * ai.config({\n   *   defaultStore: cache.driver(\"redis\", { client: redisClient }),\n   * });\n   */\n  defaultStore?: CacheDriver<any, any>;\n};\n\nconst aiConfig: AIConfig = {};\n\n/**\n * Set or extend process-wide AI configuration. Merges over existing\n * values — fields not present in `partial` keep whatever was set\n * before (or stay unset). Call once at app boot, before constructing\n * any agent / supervisor / middleware that should pick up the\n * defaults.\n *\n * Returns the merged config so callers can verify what landed.\n *\n * @example\n * import { cache } from \"@warlock.js/cache\";\n * import { ai } from \"@warlock.js/ai\";\n *\n * ai.config({ defaultStore: cache.driver(\"redis\", { client }) });\n */\nexport function setAIConfig(partial: Partial<AIConfig>): AIConfig {\n  Object.assign(aiConfig, partial);\n  return { ...aiConfig };\n}\n\n/**\n * Read the current AI config snapshot. Returns a shallow copy so\n * callers can't accidentally mutate the source of truth. Used\n * internally by consumers to resolve their `defaultStore` fallback.\n */\nexport function getAIConfig(): AIConfig {\n  return { ...aiConfig };\n}\n\n/**\n * Resolve the effective store for a consumer that didn't receive an\n * explicit one. Returns the global `defaultStore` if set, otherwise\n * `undefined`. Consumers decide whether `undefined` is fatal (semantic\n * cache: yes, throws) or a no-op (snapshot persistence: yes, just\n * skips).\n */\nexport function resolveDefaultStore(): CacheDriver<any, any> | undefined {\n  return aiConfig.defaultStore;\n}\n","import type { CacheDriver } from \"@warlock.js/cache\";\nimport { resolveDefaultStore } from \"../../config\";\nimport type { Message } from \"../../contracts/conversation-message.type\";\nimport type { EmbedderContract } from \"../../contracts/embedder.contract\";\nimport type { AgentMiddleware } from \"../../contracts/middleware\";\nimport type { ModelResponse } from \"../../contracts/model.contract\";\nimport { extractUserText } from \"../utils\";\n\n/**\n * Configuration for `semanticCache()`.\n */\nexport type SemanticCacheOptions = {\n  /** Embedder used to produce the query vector from the prompt text. */\n  embedder: EmbedderContract;\n  /**\n   * Vector-capable cache driver from `@warlock.js/cache`. Production\n   * deployments pick a driver with a real ANN index (`pg` with\n   * pgvector, `redis` with RediSearch). Dev / test environments use\n   * `new MemoryCacheDriver()` — zero config, correct, but O(N) per\n   * query. Drivers without similarity support throw\n   * `CacheUnsupportedError` from `set({ vector })` / `similar()`.\n   *\n   * Falls back to `ai.config({ defaultStore })` when omitted. When\n   * neither is set, the factory throws at construction time —\n   * semantic cache cannot operate without a store.\n   */\n  store?: CacheDriver<any, any>;\n  /**\n   * Minimum cosine similarity for a vector hit. Between 0 and 1 —\n   * 0.95 is a solid default for question-answering caches.\n   */\n  threshold: number;\n  /**\n   * Optional TTL in milliseconds. Entries whose `storedAt` is older\n   * than this are treated as misses on read and overwritten on the\n   * next write. Default: no expiry — entries live until the store\n   * evicts them (per its own TTL/eviction policy).\n   */\n  ttlMs?: number;\n  /**\n   * Namespace prefix applied to every key the cache writes. Lets\n   * multiple agents share one driver without collision. Default\n   * `\"ai.cache\"`.\n   */\n  namespace?: string;\n  /**\n   * Middleware name — also the state-bag key prefix inside a single\n   * execution. Default `\"semantic-cache\"`.\n   */\n  name?: string;\n};\n\ntype CachedEntry = {\n  response: ModelResponse;\n  storedAt: number;\n};\n\ntype PendingWrite = {\n  promptKey: string;\n  vector: number[];\n};\n\nconst DEFAULT_NAMESPACE = \"ai.cache\";\n\n/**\n * Build a stable fingerprint for a prompt covering the full message\n * list (system + history + user turn). Ensures two prompts sharing\n * the user text but differing in prior context do not collide on\n * the exact-match fast path.\n *\n * FNV-1a variant — cheap, collision-resistant enough for a cache,\n * dependency-free. NOT a cryptographic hash: collisions would\n * surface as wrong cache hits, not a security issue in the current\n * trust model.\n */\nfunction hashPrompt(messages: ReadonlyArray<Message>): string {\n  const serialized = messages\n    .map((message) => {\n      const role = message.role;\n      const content = Array.isArray(message.content)\n        ? message.content\n            .filter((part) => part.type === \"text\")\n            .map((part) => (part as { text: string }).text)\n            .join(\"|\")\n        : message.content;\n\n      return `${role}:${content}`;\n    })\n    .join(\"||\");\n\n  let hash = 0x811c9dc5;\n\n  for (let index = 0; index < serialized.length; index++) {\n    hash ^= serialized.charCodeAt(index);\n    hash = Math.imul(hash, 0x01000193);\n  }\n\n  return (hash >>> 0).toString(16);\n}\n\nfunction isFresh(entry: CachedEntry, ttlMs: number | undefined): boolean {\n  if (ttlMs === undefined) {\n    return true;\n  }\n\n  return Date.now() - entry.storedAt <= ttlMs;\n}\n\n/**\n * Semantic-similarity response cache for an agent run.\n *\n * **Role.** Skips LLM round-trips when the current prompt is\n * semantically close to one the agent has already answered. For\n * FAQ / support-style traffic this often eliminates 60–80% of\n * model calls — the production win is massive for cost and\n * latency.\n *\n * **Delegation to `@warlock.js/cache`.** This middleware does NOT\n * implement similarity search itself. It delegates to the supplied\n * `CacheDriver`. Production deployments pick a driver with an ANN\n * index (`pg` + pgvector, `redis` + RediSearch). Dev / test\n * environments pass `new MemoryCacheDriver()` — zero config, correct,\n * but O(N) per query. Drivers without similarity support throw\n * `CacheUnsupportedError` from `set({ vector })` / `similar()`.\n *\n * **Two-tier lookup.**\n * 1. *Exact-match key* — a cheap FNV hash over the entire message\n *    list. `store.get(hash)` returns the entry without an embedding\n *    round trip when the prompt hasn't changed at all.\n * 2. *Vector-match* — on exact-match miss, embed the prompt and\n *    call `store.similar(vector, { topK: 1, threshold })`. The\n *    driver uses its native similarity index; anything clearing\n *    `threshold` is returned as a hit.\n *\n * **Write-on-miss.** When both tiers miss, `trip.before` stashes\n * the prompt hash + vector in `ctx.state`; `trip.after` reads back\n * the pending entry and calls\n * `store.set(hash, entry, { vector })`. If an outer middleware\n * (guardrail) throws in `trip.after` before the cache's `trip.after`\n * runs, the pending entry is never written — bad responses stay out\n * of the cache **as long as the canonical install order is followed**\n * (cache outermost).\n *\n * **Synthetic-response on hit.** Returns a `ModelResponse` with\n * `usage: { input: 0, output: 0, total: 0 }` so budget /\n * observability correctly exclude the saved trip.\n *\n * @example\n * import { semanticCache } from \"@warlock.js/ai\";\n * import { MemoryCacheDriver } from \"@warlock.js/cache\";\n *\n * const store = new MemoryCacheDriver();\n * store.setOptions({});\n *\n * const cache = semanticCache({\n *   embedder: openai.embedder({ name: \"text-embedding-3-small\" }),\n *   store,\n *   threshold: 0.95,\n *   ttlMs: 60 * 60 * 1000,\n * });\n *\n * const myAgent = agent({ model, middleware: [cache] });\n */\nexport function semanticCache(options: SemanticCacheOptions): AgentMiddleware {\n  const name = options.name ?? \"semantic-cache\";\n  const namespace = options.namespace ?? DEFAULT_NAMESPACE;\n  const pendingKey = `${name}.pending`;\n\n  // Resolve the effective store at factory time, not per-call. Every\n  // subsequent hook closes over `store` so the resolution happens once.\n  // Throws now (loud, at construction) instead of later during the\n  // first trip (silent until the agent actually runs).\n  const store = options.store ?? resolveDefaultStore();\n\n  if (!store) {\n    throw new Error(\n      `semanticCache: no store supplied — pass \\`store\\` in options or call \\`ai.config({ defaultStore })\\` at app boot before constructing the middleware`,\n    );\n  }\n\n  // Cache's parseKey replaces \":\" with \".\" so the namespace boundary\n  // matches what `similar()` actually returns in `hit.key`. Using a\n  // dot here keeps prefix checks aligned with stored keys.\n  const keyFor = (hash: string): string => `${namespace}.${hash}`;\n\n  return {\n    name,\n    log: true,\n    trip: {\n      async before(context) {\n        // Only cache the first trip's response. Subsequent trips\n        // happen because the previous trip requested tool calls — the\n        // message list now carries tool results the original prompt\n        // never saw, so a semantic match on the unchanged user text\n        // would serve back the prior `tool_calls` response and loop\n        // the agent forever. The first turn is also the only one\n        // where a \"same question → same final answer\" caching story\n        // is sound.\n        if (context.tripIndex !== 0) {\n          return;\n        }\n\n        const promptText = extractUserText(context.messages);\n\n        if (!promptText) {\n          return;\n        }\n\n        const promptKey = hashPrompt(context.messages);\n        const scopedKey = keyFor(promptKey);\n\n        const exact = await store.get<CachedEntry>(scopedKey);\n\n        if (exact && isFresh(exact, options.ttlMs)) {\n          return toSyntheticResponse(exact.response);\n        }\n\n        const query = await options.embedder.embed(promptText);\n\n        const [hit] = await store.similar<CachedEntry>(query.vector, {\n          topK: 1,\n          threshold: options.threshold,\n        });\n\n        if (hit && isFresh(hit.value, options.ttlMs)) {\n          // Only return hits whose stored key is within this cache's\n          // namespace. Drivers shared across namespaces would otherwise\n          // leak foreign entries into queries.\n          if (hit.key.startsWith(`${namespace}.`)) {\n            return toSyntheticResponse(hit.value.response);\n          }\n        }\n\n        const pending: PendingWrite = { promptKey, vector: query.vector };\n        context.state.set(pendingKey, pending);\n\n        return;\n      },\n      async after(context, response) {\n        const pending = context.state.get(pendingKey) as PendingWrite | undefined;\n\n        if (!pending) {\n          return;\n        }\n\n        // Mid-stream tool-call responses must not be cached — the\n        // useful answer comes from the trip *after* the tool returns.\n        // Crucially, leave the pending entry in place so a later trip\n        // (the one that actually finishes with `stop`) can read it\n        // and write the final response under the *original* trip-0\n        // prompt key. Deleting here would orphan the pending and the\n        // post-tool answer would never make it into the store.\n        if (response.finishReason === \"tool_calls\") {\n          return;\n        }\n\n        context.state.delete(pendingKey);\n\n        const entry: CachedEntry = { response, storedAt: Date.now() };\n\n        await store.set(keyFor(pending.promptKey), entry, {\n          vector: pending.vector,\n        });\n\n        return;\n      },\n    },\n  };\n}\n\nfunction toSyntheticResponse(response: ModelResponse): ModelResponse {\n  return {\n    content: response.content,\n    finishReason: response.finishReason,\n    usage: { input: 0, output: 0, total: 0 },\n    toolCalls: response.toolCalls,\n  };\n}\n","import type { AgentMiddleware } from \"../../contracts/middleware\";\n\n/**\n * Flatten one or more middleware sources into a single ordered\n * array suitable for `agent({ middleware: [...] })`.\n *\n * **Role.** As middleware catalogs grow, agent configs accumulate\n * long arrays that mix \"always-on\" stacks (cache + budget + guardrail)\n * with per-concern extras (per-tool rate-limits, audit hooks). A\n * single `compose` call lets callers keep those sources as named\n * variables and flatten at the registration site.\n *\n * **Semantics.** Registration order is preserved across sources —\n * `compose(a, b, c)` produces `[...a, ...b, ...c]`. Because the\n * pipeline's onion is strictly registration-ordered, the flattened\n * order is the execution order. No de-duplication, no sorting, no\n * priority logic — that would hide bugs, not fix them.\n *\n * **Accepts arrays OR individual middlewares.** Both forms are\n * common in callsite code; the helper flattens either.\n *\n * @example\n * const standardStack = [\n *   ai.middleware.semanticCache({ ... }),\n *   ai.middleware.budget({ maxTokens: 20_000 }),\n *   ai.middleware.guardrail({ ... }),\n * ];\n *\n * const toolRateLimits = [\n *   toolRateLimit({ tool: \"search_web\", maxCalls: 3 }),\n *   toolRateLimit({ tool: \"expensive_api\", maxCalls: 1 }),\n * ];\n *\n * const myAgent = ai.agent({\n *   model,\n *   middleware: ai.middleware.compose(standardStack, toolRateLimits, auditMiddleware),\n * });\n */\nexport function composeMiddleware(\n  ...sources: ReadonlyArray<AgentMiddleware | ReadonlyArray<AgentMiddleware>>\n): AgentMiddleware[] {\n  const out: AgentMiddleware[] = [];\n\n  for (const source of sources) {\n    if (Array.isArray(source)) {\n      out.push(...source);\n      continue;\n    }\n\n    out.push(source as AgentMiddleware);\n  }\n\n  return out;\n}\n","import type { AgentMiddleware } from \"../../contracts/middleware\";\n\n/**\n * Scope a middleware's `tool`-level hooks to only fire for a\n * specific tool name (or a set of names). `execute` and `trip`\n * hooks pass through unchanged.\n *\n * **Role.** Tool-specific concerns — \"rate-limit `search_web`\",\n * \"cache results for `fetch_faq`\" — are common. Rather than adding\n * a `middleware` field to `ai.tool()` (see decisions §27), the\n * framework keeps one contract (`AgentMiddleware`) and offers this\n * helper for the locality problem. The middleware body stays agnostic\n * of the tool name; `forTool` handles the filtering.\n *\n * **What gets filtered.** Only `tool.before` / `tool.after` /\n * `tool.onError`. Each hook is wrapped so that `ctx.tool.name`\n * must be in the allowed set or the wrapped hook is a no-op.\n * `execute` and `trip` hooks are NOT touched — they run normally.\n *\n * **Why not filter execute/trip too?** Because a middleware that\n * reaches across levels (a tool-specific budget that initializes a\n * counter in `execute.before` and checks it in `tool.before`) still\n * needs `execute.before` to fire unconditionally. Scoping all hooks\n * would break cross-level middleware; scoping only `tool` hooks\n * matches the mental model of \"this middleware cares about these\n * tools.\"\n *\n * **Single-name vs multi-name.** A string matches one tool; a string\n * array matches any of the listed tools. No wildcards, no regex —\n * keep it boring.\n *\n * @example\n * // Single tool\n * const scoped = ai.middleware.forTool(\n *   \"search_web\",\n *   toolRateLimit({ maxCalls: 3 }),\n * );\n *\n * @example\n * // Multiple tools sharing a rule\n * const scoped = ai.middleware.forTool(\n *   [\"paid_api\", \"expensive_db\"],\n *   toolRateLimit({ maxCalls: 5 }),\n * );\n *\n * ai.agent({\n *   model,\n *   tools: [webTool, paidApiTool, expensiveDbTool],\n *   middleware: [scoped],\n * });\n */\nexport function forTool(\n  toolNames: string | ReadonlyArray<string>,\n  middleware: AgentMiddleware,\n): AgentMiddleware {\n  const allowed = new Set(\n    typeof toolNames === \"string\" ? [toolNames] : toolNames,\n  );\n  const scope =\n    allowed.size === 1 ? Array.from(allowed)[0] : Array.from(allowed).join(\"+\");\n\n  if (!middleware.tool) {\n    return middleware;\n  }\n\n  const innerBefore = middleware.tool.before;\n  const innerAfter = middleware.tool.after;\n  const innerOnError = middleware.tool.onError;\n\n  return {\n    ...middleware,\n    name: `${middleware.name}[for:${scope}]`,\n    tool: {\n      before: innerBefore\n        ? async ctx => {\n            if (!allowed.has(ctx.tool.name)) {\n              return;\n            }\n\n            return innerBefore(ctx);\n          }\n        : undefined,\n      after: innerAfter\n        ? async (ctx, result) => {\n            if (!allowed.has(ctx.tool.name)) {\n              return;\n            }\n\n            return innerAfter(ctx, result);\n          }\n        : undefined,\n      onError: innerOnError\n        ? async (ctx, error) => {\n            if (!allowed.has(ctx.tool.name)) {\n              return;\n            }\n\n            return innerOnError(ctx, error);\n          }\n        : undefined,\n    },\n  };\n}\n","import type { Logger } from \"@warlock.js/logger\";\nimport type {\n  AgentMiddleware,\n  MiddlewareExecuteContext,\n  MiddlewareToolContext,\n  MiddlewareTripContext,\n} from \"../contracts/middleware\";\n\nconst LOG_MODULE = \"ai.middleware\";\n\n/**\n * The three levels at which agent middleware can hook — mirrors\n * `AgentMiddleware`'s optional `execute` / `trip` / `tool` keys.\n * Kept as a single named union so callers can pass it around without\n * inline-duplicating the literals.\n */\nexport type MiddlewareLevel = \"execute\" | \"trip\" | \"tool\";\n\n/**\n * Shape of the context object for each level. The pipeline is\n * level-parameterized on the ctx type via this mapping so callers\n * get compile-time narrowing when they instantiate `runPipeline`.\n */\nexport type MiddlewareContextByLevel = {\n  execute: MiddlewareExecuteContext;\n  trip: MiddlewareTripContext;\n  tool: MiddlewareToolContext;\n};\n\n/**\n * Run an inner async operation through a stack of agent middlewares\n * at a single level, applying the onion-model before/after/onError\n * semantics documented on `AgentMiddleware`.\n *\n * **Semantics.**\n * - `before` hooks run in registration order (top-down).\n *   Returning a defined value from a `before` hook short-circuits the\n *   pipeline with that value as the result, skipping `inner()` and\n *   all deeper `before` / `after` hooks — but outer middleware\n *   `after` hooks (registered earlier) still run on the synthetic\n *   value.\n * - `after` hooks run in reverse registration order (bottom-up).\n *   Returning a defined value replaces the result before it\n *   propagates further out. Returning `void` / `undefined` keeps the\n *   existing result.\n * - `onError` hooks also run in reverse (bottom-up) — any error\n *   thrown by `inner()`, by a `before` hook, or by an `after` hook\n *   unwinds through each frame's `onError` in turn. Returning a\n *   defined value from `onError` recovers: the error is cleared and\n *   the returned value becomes the new result (which then flows\n *   through outer `after` hooks). Returning `void` propagates the\n *   error to the next outer frame.\n *\n * **Implementation.** Built by folding the middleware array from the\n * end inward: each middleware produces a closure that wraps the\n * previous closure (the deeper pipeline). The outermost wrap is\n * middleware index 0 — so registration order matches onion order\n * without any reverse iteration at call time.\n *\n * **No magic.** The pipeline does not swallow, retry, or translate\n * errors. Hooks that throw propagate unchanged (subject to `onError`\n * recovery). Pipeline-level logging is debug-only and respects each\n * middleware's `log: false` kill-switch.\n *\n * @example\n * const response = await runPipeline(\n *   middlewares,\n *   \"trip\",\n *   tripContext,\n *   () => model.complete(messages, callOptions),\n *   logger,\n * );\n */\nexport async function runPipeline<Level extends MiddlewareLevel, TResult>(\n  middlewares: ReadonlyArray<AgentMiddleware>,\n  level: Level,\n  context: MiddlewareContextByLevel[Level],\n  inner: () => Promise<TResult>,\n  logger?: Logger,\n): Promise<TResult> {\n  if (middlewares.length === 0) {\n    return inner();\n  }\n\n  let next: () => Promise<TResult> = inner;\n\n  for (let index = middlewares.length - 1; index >= 0; index--) {\n    const middleware = middlewares[index];\n    const hooks = middleware[level];\n\n    if (!hooks) {\n      continue;\n    }\n\n    const previous = next;\n\n    next = async () => {\n      const logEnabled = middleware.log !== false && logger !== undefined;\n\n      if (hooks.before) {\n        if (logEnabled) {\n          logger!.debug(LOG_MODULE, `${level}.before`, middleware.name, {\n            middleware: middleware.name,\n            level,\n          });\n        }\n\n        const shortCircuit = await (\n          hooks.before as (ctx: unknown) => Promise<unknown> | unknown\n        )(context);\n\n        if (shortCircuit !== undefined) {\n          if (logEnabled) {\n            logger!.debug(\n              LOG_MODULE,\n              `${level}.short-circuit`,\n              middleware.name,\n              {\n                middleware: middleware.name,\n                level,\n              },\n            );\n          }\n\n          return shortCircuit as TResult;\n        }\n      }\n\n      let result: TResult;\n\n      try {\n        result = await previous();\n      } catch (thrown) {\n        if (!hooks.onError) {\n          throw thrown;\n        }\n\n        const recovered = await (\n          hooks.onError as (\n            ctx: unknown,\n            error: unknown,\n          ) => Promise<unknown> | unknown\n        )(context, thrown);\n\n        if (recovered === undefined) {\n          throw thrown;\n        }\n\n        if (logEnabled) {\n          logger!.debug(LOG_MODULE, `${level}.recovered`, middleware.name, {\n            middleware: middleware.name,\n            level,\n          });\n        }\n\n        result = recovered as TResult;\n      }\n\n      if (hooks.after) {\n        const replacement = await (\n          hooks.after as (\n            ctx: unknown,\n            value: unknown,\n          ) => Promise<unknown> | unknown\n        )(context, result);\n\n        if (replacement !== undefined) {\n          result = replacement as TResult;\n        }\n\n        if (logEnabled) {\n          logger!.debug(LOG_MODULE, `${level}.after`, middleware.name, {\n            middleware: middleware.name,\n            level,\n          });\n        }\n      }\n\n      return result;\n    };\n  }\n\n  return next();\n}\n","import type { ModelPricing } from \"../contracts/result/model-pricing.type\";\nimport type { Usage } from \"../contracts/result/usage.type\";\n\n/**\n * Compute a per-channel USD cost breakdown for a single `Usage` against\n * a model's pricing table. Returns `undefined` when no pricing is\n * configured — the framework treats unpriced runs as \"cost unknown,\"\n * not \"cost zero,\" so dashboards can distinguish free-tier from\n * un-instrumented.\n *\n * **Shape mirrors `ModelPricing`** — `input`, `output`, optional\n * `cachedInput` / `cachedOutput`. Consumers needing a scalar total\n * sum the populated fields. The breakdown is the value-add: it tells\n * downstream tooling HOW the total was reached (input-vs-output\n * share, cache savings) without re-deriving against pricing tables\n * that may have shifted since the report was written.\n *\n * **Cache-aware.** `usage.cachedTokens` is the subset of `usage.input`\n * served from the provider's prompt cache and bills at\n * `pricing.cachedInput` (falls back to full `pricing.input` when the\n * provider doesn't publish a cache rate). The remaining `input -\n * cachedTokens` bills at full rate and shows up in `cost.input`. The\n * `cachedOutput` channel is reserved for Anthropic-style cache writes;\n * until an adapter populates `usage.cacheWriteTokens`, the framework\n * leaves it undefined.\n *\n * Pricing values are USD-per-million-tokens. The function divides\n * once at the end to avoid floating-point accumulation error on\n * per-token math.\n *\n * @example\n * const usage: Usage = { input: 150_000, output: 30_000, total: 180_000, cachedTokens: 90_000 };\n * const cost = computeCost(usage, { input: 0.15, output: 0.6, cachedInput: 0.075 });\n * // cost = {\n * //   input: (60_000 * 0.15) / 1e6 = 0.009,\n * //   output: (30_000 * 0.6) / 1e6 = 0.018,\n * //   cachedInput: (90_000 * 0.075) / 1e6 = 0.00675,\n * // }\n */\nexport function computeCost(usage: Usage, pricing: ModelPricing | undefined): ModelPricing | undefined {\n  if (!pricing) {\n    return undefined;\n  }\n\n  const cachedInput = usage.cachedTokens ?? 0;\n  const uncachedInput = Math.max(0, usage.input - cachedInput);\n\n  const cost: ModelPricing = {\n    input: (uncachedInput * pricing.input) / 1_000_000,\n    output: (usage.output * pricing.output) / 1_000_000,\n  };\n\n  if (cachedInput > 0) {\n    const cachedInputRate = pricing.cachedInput ?? pricing.input;\n    cost.cachedInput = (cachedInput * cachedInputRate) / 1_000_000;\n  }\n\n  return cost;\n}\n\n/**\n * Merge a child's cost breakdown into a running parent total. Each\n * channel (`input`, `output`, `cachedInput`, `cachedOutput`) sums\n * independently — an undefined channel on either side is treated as\n * zero contribution rather than dropping the other side's value. A\n * single unpriced child should never erase the cost of its priced\n * siblings.\n *\n * Returns the new parent breakdown, or `undefined` when neither parent\n * nor child carried any cost data (preserves the \"no priced\n * contributor has appeared yet\" signal that distinguishes \"missing\n * pricing\" from \"genuinely zero\").\n */\nexport function accumulateCost(\n  parent: ModelPricing | undefined,\n  child: ModelPricing | undefined,\n): ModelPricing | undefined {\n  if (!child) {\n    return parent;\n  }\n\n  if (!parent) {\n    return { ...child };\n  }\n\n  const merged: ModelPricing = {\n    input: parent.input + child.input,\n    output: parent.output + child.output,\n  };\n\n  const cachedInput = sumOptional(parent.cachedInput, child.cachedInput);\n  if (cachedInput !== undefined) {\n    merged.cachedInput = cachedInput;\n  }\n\n  const cachedOutput = sumOptional(parent.cachedOutput, child.cachedOutput);\n  if (cachedOutput !== undefined) {\n    merged.cachedOutput = cachedOutput;\n  }\n\n  return merged;\n}\n\n/**\n * Add two optional numbers, treating either side's `undefined` as\n * zero — but return `undefined` when both are absent. Keeps \"this\n * channel was never reported anywhere\" distinguishable from \"this\n * channel was reported as 0.\"\n */\nfunction sumOptional(parent: number | undefined, child: number | undefined): number | undefined {\n  if (parent === undefined && child === undefined) {\n    return undefined;\n  }\n\n  return (parent ?? 0) + (child ?? 0);\n}\n","/**\n * Strip markdown code fences from an LLM response before JSON parsing.\n *\n * Models — especially Claude, smaller models, and local models — routinely\n * wrap JSON output in fenced code blocks (` ```json\\n{...}\\n``` `) even when\n * instructed otherwise. Sometimes they also precede the fence with prose\n * (\"Here you go:\\n```json\\n...\\n```\"). This helper finds the first fenced\n * block regardless of language tag and returns its trimmed contents.\n *\n * Returns the trimmed original text unchanged when no fence is present, so\n * clean JSON passes through as a no-op.\n *\n * Deliberately does NOT fall back to \"find first `{` and last `}` and slice\n * between them\" — that heuristic silently corrupts data when prose contains\n * stray braces. Failing loudly at `JSON.parse` is safer.\n *\n * @example\n * extractJsonPayload('```json\\n{\"a\":1}\\n```');\n * // => '{\"a\":1}'\n *\n * @example\n * extractJsonPayload('Here you go:\\n```\\n{\"a\":1}\\n```\\nHope this helps.');\n * // => '{\"a\":1}'\n *\n * @example\n * extractJsonPayload('{\"a\":1}');\n * // => '{\"a\":1}'   (no fence → unchanged)\n */\nexport function extractJsonPayload(text: string): string {\n  const trimmed = text.trim();\n\n  const fenceMatch = trimmed.match(/```(?:json)?\\s*\\n?([\\s\\S]*?)\\n?```/);\n\n  if (fenceMatch) {\n    return fenceMatch[1].trim();\n  }\n\n  return trimmed;\n}\n","/**\n * Generates a stable, human-readable run id for any execution node\n * (tool invocation, agent run, workflow run, supervisor run). Format:\n * `${prefix}_${timestamp36}_${random36}` — compact, sortable by\n * prefix, collision-resistant within a run.\n *\n * Shared helper so every primitive emits the same id shape. The\n * prefix is conventionally the primitive kind (`\"tool\"`, `\"agent\"`,\n * `\"workflow\"`, `\"sup\"`) but callers can pass anything; the id is\n * purely for correlation, never parsed.\n *\n * @example\n * const runId = generateRunId(\"tool\");\n * // → \"tool_ld8x3m_7fq2j1kp\"\n */\nexport function generateRunId(prefix: string): string {\n  return `${prefix}_${Date.now().toString(36)}_${Math.random()\n    .toString(36)\n    .slice(2, 10)}`;\n}\n","import type { StandardSchemaV1 } from \"@standard-schema/spec\";\n\n/**\n * Supported JSON Schema output targets per the Standard JSON Schema V1\n * spec. `openai-strict` is the richest for OpenAI structured outputs —\n * every property listed in `required`, optionals expressed as\n * `[\"T\", \"null\"]`, `additionalProperties: false` everywhere. Other\n * targets produce standards-compliant but looser output.\n */\nexport type JsonSchemaTarget = \"draft-2020-12\" | \"draft-07\" | \"openapi-3.0\" | \"openai-strict\";\n\n/**\n * Options for `extractJsonSchema`. `target` is forwarded to libraries that\n * implement the Standard JSON Schema V1 spec (Seal, and any future lib\n * that follows the spec). Libraries using their own top-level `.jsonSchema`\n * / `._jsonSchema` property ignore the target.\n */\nexport type ExtractJsonSchemaOptions = {\n  target?: JsonSchemaTarget | (string & {});\n};\n\n/**\n * Best-effort JSON Schema extraction from a Standard Schema instance.\n *\n * Different libraries expose their JSON representation through different\n * paths:\n * - **Seal / Standard JSON Schema V1**: `[\"~standard\"].jsonSchema.input({ target })`\n *   — nested under the spec object, takes a target switch. Default target\n *   is `\"openai-strict\"` since the primary consumer is OpenAI's native\n *   structured-output mechanism; pass `options.target` to override.\n * - **Zod / similar**: top-level `.jsonSchema` property. Zod v4 actually\n *   ships `toJSONSchema` as a module function, not a method, so it does\n *   NOT hit this probe — Zod users pass their converted schema via the\n *   `AgentExecuteOptions.responseSchema` escape hatch.\n *\n * Deliberately does NOT probe `toJSON` — that's a generic JavaScript\n * serialization hook (Seal's schemas have one that dumps internal rule\n * state) and matching it would return garbage disguised as a JSON Schema.\n *\n * Returns `undefined` when no path matches. The caller then either skips\n * native structured-output wiring or falls back to a schema-less\n * instruction.\n *\n * Shared across every SDK adapter package (OpenAI, Anthropic, Bedrock…)\n * so each provider converts schemas identically.\n *\n * @example\n * const schema = extractJsonSchema(mySealSchema);\n * // { type: \"object\", properties: { ... }, required: [ ... ], additionalProperties: false }\n *\n * @example\n * // Ask for a different target explicitly\n * const draft = extractJsonSchema(mySealSchema, { target: \"draft-2020-12\" });\n */\nexport function extractJsonSchema(\n  schema: StandardSchemaV1<unknown> | undefined,\n  options: ExtractJsonSchemaOptions = {},\n): Record<string, unknown> | undefined {\n  if (!schema) return undefined;\n\n  const target = options.target ?? \"openai-strict\";\n\n  // 1. Seal / Standard JSON Schema V1 pattern: [\"~standard\"].jsonSchema.input({ target })\n  const sealJsonSchema = extractFromSealPath(schema, target);\n\n  if (sealJsonSchema) {\n    return sealJsonSchema;\n  }\n\n  // 2. Top-level jsonSchema / _jsonSchema (Zod-like, property or method form)\n  const topLevel = extractFromCandidateKeys(schema as unknown as Record<string, unknown>);\n\n  if (topLevel) {\n    return topLevel;\n  }\n\n  return undefined;\n}\n\n/**\n * Probe the Standard JSON Schema V1 extension path on `schema[\"~standard\"]`.\n * The spec defines `jsonSchema.input({ target, libraryOptions? })` as a\n * function returning a JSON Schema tailored to the requested target. We\n * pass the caller's target (default `\"openai-strict\"`) so the library\n * produces output ready for OpenAI's native structured-output mode\n * without additional post-processing.\n *\n * Calling `.input()` without a target would throw (or return garbage) per\n * the spec — a failure here returns `undefined` so the fallback probe\n * runs.\n */\nfunction extractFromSealPath(\n  schema: StandardSchemaV1<unknown>,\n  target: string,\n): Record<string, unknown> | undefined {\n  const standardSlot = (schema as unknown as Record<string, unknown>)[\"~standard\"];\n\n  if (!standardSlot || typeof standardSlot !== \"object\") {\n    return undefined;\n  }\n\n  const jsonSchemaSlot = (standardSlot as Record<string, unknown>)[\"jsonSchema\"];\n\n  if (!jsonSchemaSlot || typeof jsonSchemaSlot !== \"object\") {\n    return undefined;\n  }\n\n  const inputFn = (jsonSchemaSlot as Record<string, unknown>)[\"input\"];\n\n  if (typeof inputFn !== \"function\") {\n    return undefined;\n  }\n\n  try {\n    const result = (inputFn as (options: { target: string }) => unknown).call(jsonSchemaSlot, {\n      target,\n    });\n\n    if (result && typeof result === \"object\") {\n      return result as Record<string, unknown>;\n    }\n  } catch {\n    // fall through — library didn't support the target or threw otherwise\n  }\n\n  return undefined;\n}\n\n/**\n * Probe well-known top-level keys libraries use to expose their JSON\n * Schema. Supports both method form (rare) and property form (common).\n * Deliberately narrow — `toJSON` is NOT probed here because it's a\n * generic serialization hook that returns library-internal state for\n * many validators (Seal included), not a JSON Schema.\n */\nfunction extractFromCandidateKeys(\n  schemaRecord: Record<string, unknown>,\n): Record<string, unknown> | undefined {\n  const candidateKeys = [\"jsonSchema\", \"_jsonSchema\"] as const;\n\n  for (const key of candidateKeys) {\n    const value = schemaRecord[key];\n\n    if (typeof value === \"function\") {\n      try {\n        const result = (value as () => unknown).call(schemaRecord);\n\n        if (result && typeof result === \"object\") {\n          return result as Record<string, unknown>;\n        }\n      } catch {\n        // try next candidate\n      }\n\n      continue;\n    }\n\n    if (value && typeof value === \"object\") {\n      return value as Record<string, unknown>;\n    }\n  }\n\n  return undefined;\n}\n","import type {\n  Attachment,\n  AttachmentSource,\n  ResolvedAttachment,\n} from \"../contracts/attachment.type\";\nimport { InvalidRequestError } from \"../errors\";\n\nconst REMOTE_URL_PATTERN = /^https?:\\/\\//i;\n\n/**\n * Normalize a user-supplied `Attachment` (or bare `AttachmentSource`)\n * into a `ResolvedAttachment` the agent can hand to file-reading code\n * without re-discriminating the input variant.\n *\n * Resolution rules:\n * - `{ base64, mediaType }` → `{ type: \"base64\", value, mediaType }`.\n * - `StorageFileShape` (`{ url?, absolutePath? }`) → URL wins over\n *   absolute path. URL becomes `{ type: \"url\" }`; absolute path\n *   becomes `{ type: \"path\" }`.\n * - String starting with `http://` / `https://` → `{ type: \"url\" }`.\n * - Any other string → `{ type: \"path\" }`.\n * - Tagged `{ type: \"image\" | \"text\", source }` → recurses into `source`.\n *\n * Throws `InvalidRequestError` on obviously invalid input (empty\n * string, storage object with neither url nor absolutePath, missing\n * source field).\n *\n * @example\n * resolveAttachment(\"https://cdn.example.com/doc.pdf\");\n * // → { type: \"url\", value: \"https://cdn.example.com/doc.pdf\" }\n *\n * @example\n * resolveAttachment({ type: \"image\", source: \"/tmp/x.png\" });\n * // → { type: \"path\", value: \"/tmp/x.png\" }\n */\nexport function resolveAttachment(attachment: Attachment): ResolvedAttachment {\n  if (\n    typeof attachment === \"object\" &&\n    attachment !== null &&\n    \"type\" in attachment\n  ) {\n    return resolveSource(attachment.source);\n  }\n\n  return resolveSource(attachment);\n}\n\nfunction resolveSource(source: AttachmentSource): ResolvedAttachment {\n  if (typeof source === \"string\") {\n    if (!source) {\n      throw new InvalidRequestError(\"Cannot resolve empty attachment string\");\n    }\n\n    if (REMOTE_URL_PATTERN.test(source)) {\n      return { type: \"url\", value: source };\n    }\n\n    return { type: \"path\", value: source };\n  }\n\n  // StorageFile objects (from @warlock.js/core) can expose a `base64`\n  // property alongside `url` / `absolutePath`. Check storage shape\n  // first so we don't treat a StorageFile as an inline-bytes payload.\n  if (\"url\" in source || \"absolutePath\" in source) {\n    const storage = source as { url?: string; absolutePath?: string };\n\n    if (storage.absolutePath) {\n      return { type: \"path\", value: storage.absolutePath };\n    }\n\n    if (storage.url) {\n      return { type: \"url\", value: storage.url };\n    }\n\n    throw new InvalidRequestError(\n      \"Storage attachment has neither url nor absolutePath\",\n    );\n  }\n\n  if (\"base64\" in source) {\n    if (!source.base64 || !source.mediaType) {\n      throw new InvalidRequestError(\n        \"Inline attachment requires both `base64` and `mediaType`\",\n      );\n    }\n\n    return {\n      type: \"base64\",\n      value: source.base64,\n      mediaType: source.mediaType,\n    };\n  }\n\n  throw new InvalidRequestError(\n    \"Unrecognized attachment source — expected a string path/URL, a StorageFile, or `{ base64, mediaType }`\",\n  );\n}\n","import { readFile } from \"node:fs/promises\";\nimport { extname } from \"node:path\";\nimport type { Attachment } from \"../contracts/attachment.type\";\nimport type { ContentPart } from \"../contracts/content-part.type\";\nimport { InvalidRequestError } from \"../errors\";\nimport { resolveAttachment } from \"./resolve-attachment\";\n\nconst IMAGE_EXTENSIONS_TO_MEDIA_TYPE: Record<string, string> = {\n  \".png\": \"image/png\",\n  \".jpg\": \"image/jpeg\",\n  \".jpeg\": \"image/jpeg\",\n  \".webp\": \"image/webp\",\n  \".gif\": \"image/gif\",\n};\n\nconst TEXT_EXTENSIONS = new Set([\".txt\"]);\n\ntype AttachmentKind = \"image\" | \"text\";\n\n/**\n * Convert a user-supplied `Attachment` into a provider-ready\n * `ContentPart` the model adapter can consume without doing any I/O of\n * its own.\n *\n * Kind resolution:\n * - Tagged `{ type: \"image\", source }` / `{ type: \"text\", source }`\n *   trusts the caller's intent.\n * - Shorthand (raw string / `StorageFileShape`) infers from the file\n *   extension. Image extensions (`.png`/`.jpg`/`.jpeg`/`.webp`/`.gif`)\n *   map to `\"image\"`. `.txt` maps to `\"text\"`. Anything else throws\n *   `InvalidRequestError` — silent inference on ambiguous inputs\n *   causes silent bugs.\n *\n * Local paths are read from disk; images are base64-encoded inline,\n * text files are read as UTF-8 strings and returned as a `text`\n * `ContentPart`. Remote URLs for image attachments are passed through\n * unchanged; remote URLs for text attachments are fetched so the\n * adapter never needs network access.\n *\n * @example\n * await prepareAttachmentPart(\"./photo.png\");\n * // → { type: \"image\", source: { base64: \"...\", mediaType: \"image/png\" } }\n *\n * @example\n * await prepareAttachmentPart({ type: \"text\", source: \"./notes.txt\" });\n * // → { type: \"text\", text: \"<file contents>\" }\n */\nexport async function prepareAttachmentPart(\n  attachment: Attachment,\n): Promise<ContentPart> {\n  const kind = resolveKind(attachment);\n\n  if (kind === \"text\") {\n    return prepareTextPart(attachment);\n  }\n\n  return prepareImagePart(attachment);\n}\n\n/**\n * Decide whether the attachment is text or image. Tagged forms win\n * immediately; for shorthand we inspect the extension. Throws if the\n * shorthand doesn't look like anything we recognize.\n */\nfunction resolveKind(attachment: Attachment): AttachmentKind {\n  if (isTaggedAttachment(attachment)) {\n    return attachment.type;\n  }\n\n  const path = extractPath(attachment);\n  const extension = path ? extname(stripQuery(path)).toLowerCase() : \"\";\n\n  if (IMAGE_EXTENSIONS_TO_MEDIA_TYPE[extension]) {\n    return \"image\";\n  }\n\n  if (TEXT_EXTENSIONS.has(extension)) {\n    return \"text\";\n  }\n\n  throw new InvalidRequestError(\n    \"Cannot infer attachment type from input — pass an explicit `{ type: 'image' | 'text', source: ... }` or use a recognized extension (.png, .jpg, .jpeg, .webp, .gif, .txt)\",\n  );\n}\n\n/**\n * Produce an `image` ContentPart. URLs pass through; paths are\n * read from disk and base64-encoded with an inferred media type.\n * Inline base64 attachments pass through unchanged.\n */\nasync function prepareImagePart(attachment: Attachment): Promise<ContentPart> {\n  const inferredMediaType = isTaggedAttachment(attachment)\n    ? undefined\n    : inferImageMediaType(attachment);\n\n  const resolved = resolveAttachment(attachment);\n\n  if (resolved.type === \"url\") {\n    return { type: \"image\", source: { url: resolved.value } };\n  }\n\n  if (resolved.type === \"base64\") {\n    return {\n      type: \"image\",\n      source: { base64: resolved.value, mediaType: resolved.mediaType },\n    };\n  }\n\n  const mediaType = inferredMediaType ?? inferImageMediaType(resolved.value);\n\n  if (!mediaType) {\n    throw new InvalidRequestError(\n      `Cannot infer media type for path \"${resolved.value}\" — use a recognized image extension or pass ` +\n        \"`{ type: 'image', source: { base64, mediaType } }`\",\n      { context: { path: resolved.value } },\n    );\n  }\n\n  const bytes = await readFile(resolved.value);\n\n  return {\n    type: \"image\",\n    source: { base64: bytes.toString(\"base64\"), mediaType },\n  };\n}\n\n/**\n * Produce a `text` ContentPart. URLs are fetched as UTF-8, paths are\n * read from disk as UTF-8, inline base64 is decoded to UTF-8. The\n * result joins the conversation as an additional text part the model\n * sees before responding.\n */\nasync function prepareTextPart(attachment: Attachment): Promise<ContentPart> {\n  const resolved = resolveAttachment(attachment);\n\n  if (resolved.type === \"url\") {\n    const response = await fetch(resolved.value);\n\n    if (!response.ok) {\n      throw new InvalidRequestError(\n        `Failed to fetch text attachment \"${resolved.value}\" — status ${response.status}`,\n        { context: { url: resolved.value, status: response.status } },\n      );\n    }\n\n    return { type: \"text\", text: await response.text() };\n  }\n\n  if (resolved.type === \"base64\") {\n    const decoded = Buffer.from(resolved.value, \"base64\").toString(\"utf8\");\n\n    return { type: \"text\", text: decoded };\n  }\n\n  const bytes = await readFile(resolved.value, \"utf8\");\n\n  return { type: \"text\", text: bytes };\n}\n\nfunction isTaggedAttachment(\n  attachment: Attachment,\n): attachment is Extract<Attachment, { type: string }> {\n  return (\n    typeof attachment === \"object\" &&\n    attachment !== null &&\n    \"type\" in attachment\n  );\n}\n\nfunction inferImageMediaType(input: unknown): string | undefined {\n  const path = extractPath(input);\n\n  if (!path) {\n    return undefined;\n  }\n\n  const extension = extname(stripQuery(path)).toLowerCase();\n\n  return IMAGE_EXTENSIONS_TO_MEDIA_TYPE[extension];\n}\n\nfunction extractPath(input: unknown): string | undefined {\n  if (typeof input === \"string\") {\n    return input;\n  }\n\n  if (typeof input === \"object\" && input !== null) {\n    const storage = input as { url?: string; absolutePath?: string };\n    return storage.url ?? storage.absolutePath;\n  }\n\n  return undefined;\n}\n\nfunction stripQuery(path: string): string {\n  const queryIndex = path.indexOf(\"?\");\n\n  return queryIndex === -1 ? path : path.slice(0, queryIndex);\n}\n","/**\n * Parse a JSON string, returning a caller-supplied fallback when the input\n * is empty or malformed instead of throwing. Useful at provider boundaries\n * where tool-call arguments may arrive as `null`, `\"\"`, or partial JSON\n * during streaming — callers want a safe default, not an exception.\n *\n * @example\n * const args = safeJsonParse<Record<string, unknown>>(toolCall.function.arguments, {});\n */\nexport function safeJsonParse<TValue>(\n  data: string | null | undefined,\n  defaultValue: TValue,\n): TValue {\n  if (!data) {\n    return defaultValue;\n  }\n\n  try {\n    return JSON.parse(data) as TValue;\n  } catch {\n    return defaultValue;\n  }\n}\n","import type { AttemptEntry } from \"./attempt-entry.type\";\nimport type { Usage } from \"./usage.type\";\n\n/**\n * Wire-format version stamped on every root `BaseReport`. Bumped only\n * when we make a BREAKING change to the report shape (field removed,\n * required-ness flipped, semantics changed). Additive changes (new\n * optional fields) do not bump.\n *\n * Panoptic and other downstream consumers branch on this to parse\n * old stored reports with their original-shape rules.\n *\n * Current: **1** — initial Panoptic-readiness shape.\n */\nexport const REPORT_SCHEMA_VERSION = 1;\n\n/**\n * Discriminator for the kind of executable that produced a given\n * {@link BaseReport}. Forms a closed union so consumers can narrow on\n * the tree without string-matching on `name`.\n */\nexport type ReportType =\n  | \"tool\"\n  | \"callback\"\n  | \"agent\"\n  | \"workflow\"\n  | \"supervisor\";\n\n/**\n * Terminal status every executable primitive reports. Unified across\n * tools, agents, workflows, and supervisors so dashboards and\n * generic traversal helpers don't special-case per primitive.\n *\n * - `\"completed\"` — ran to natural end with a usable result.\n * - `\"failed\"` — aborted mid-run or finished without a usable result\n *   (crash, schema failure, max-trips, etc.). The\n *   accompanying `error` on the envelope carries the typed cause.\n * - `\"cancelled\"` — caller aborted before completion via `AbortSignal`.\n * - `\"max-iterations\"` — supervisor-specific termination when the\n *   iteration cap was hit without an explicit `END` / `satisfied`.\n *   Harmless on non-supervisor reports; keeping it on the shared\n *   union lets consumers write one `switch` for every status.\n */\nexport type ReportStatus =\n  | \"completed\"\n  | \"failed\"\n  | \"cancelled\"\n  | \"max-iterations\";\n\n/**\n * Universal execution report shared by every primitive. Per-primitive\n * report types extend this with their own domain-specific fields\n * (agent trips, workflow steps, supervisor iteration snapshots) while\n * keeping the root fields identical. Recursion happens through\n * {@link BaseReport.children} — any executable this node invoked\n * contributes its own full report here, producing a walkable tree of\n * the entire run.\n *\n * **Usage rollup.** `usage` at every node equals this node's own cost\n * plus the sum of each child's `usage`. Leaves (tools) contribute\n * zero own-cost; composites contribute their direct LLM spend only,\n * with children covering everything delegated.\n *\n * @example\n * function totalCost(report: BaseReport): number {\n *   return report.usage.total;\n * }\n *\n * function walk(report: BaseReport, depth = 0): void {\n *   console.log(`${\"  \".repeat(depth)}${report.type} \"${report.name}\" — ${report.status}`);\n *   for (const child of report.children) walk(child, depth + 1);\n * }\n */\nexport type BaseReport = {\n  /** Stable id for this execution node. Generated per `execute()`/`invoke()` call. */\n  runId: string;\n  /**\n   * Run-id of the immediate parent execution node, when this node was\n   * invoked as part of a larger run (e.g. a tool dispatched by an\n   * agent; an agent dispatched by a supervisor; an inner primitive\n   * wrapped via `asTool()`). Absent on root nodes.\n   *\n   * Lets Panoptic and other flat-row consumers reconstruct the tree\n   * without traversing `children[]` in memory.\n   */\n  parentRunId?: string;\n  /**\n   * Run-id of the top-level execution this node belongs to. Equals\n   * `runId` on the root node, and is propagated downward to every\n   * descendant. Used to slice flat report tables back into per-run\n   * groupings.\n   */\n  rootRunId: string;\n  /** Executable identity — the tool/agent/workflow/supervisor name. */\n  name: string;\n  /**\n   * Dev-curated version string mirrored from the primitive's config\n   * (`AgentConfig.version`, `ToolConfig.version`, etc.). Free-form —\n   * the framework neither parses nor compares it. Stored verbatim on\n   * every report so trip-archive queries can distinguish runs of\n   * \"agent X v2.1\" from \"agent X v2.2\" even when name + signature\n   * are identical.\n   *\n   * Stays `undefined` when the dev didn't declare one — never\n   * auto-defaulted.\n   */\n  version?: string;\n  /**\n   * Caller-supplied identifier that groups multiple `.execute()` calls\n   * into one conceptual user session / request. Propagated to every\n   * descendant report node so flat queries (\"total spend for session\n   * X today\") work without joining the tree.\n   *\n   * Threaded from `execute()` options on every primitive. Optional —\n   * absent when the caller didn't supply one.\n   */\n  sessionId?: string;\n  /** Discriminator for the kind of executable that produced this report. */\n  type: ReportType;\n  /** Terminal status of this execution. */\n  status: ReportStatus;\n  /** ISO-8601 wall-clock timestamp when execution began. */\n  startedAt: string;\n  /** ISO-8601 wall-clock timestamp when execution finished. */\n  endedAt: string;\n  /** Monotonic duration in milliseconds — `performance.now()` delta. */\n  duration: number;\n  /** Rolled-up usage: own cost + sum of `children[].usage`. */\n  usage: Usage;\n  /**\n   * Reports of every executable invoked by this node, in invocation\n   * order. Empty for leaves (pure tools) and for executables that\n   * didn't delegate work.\n   */\n  children: BaseReport[];\n  /**\n   * Retry history when middleware (or, for workflow steps, the engine\n   * itself) retried this node before it either succeeded or gave up.\n   * Absent when zero retries happened — keeps the common-case payload\n   * lean. The surviving (final) attempt is NOT duplicated here; its\n   * outcome is the report's own `status` / timing.\n   */\n  attempts?: AttemptEntry[];\n  /**\n   * Wire-format version of this report shape. Only present on root\n   * report nodes — implies the same version for the whole tree.\n   * Panoptic / archive consumers branch on this to parse old reports\n   * with their original-shape rules.\n   *\n   * Always equals {@link REPORT_SCHEMA_VERSION} at write time.\n   */\n  reportSchemaVersion?: number;\n};\n","import type { BaseReport } from \"../contracts/result/base-report.type\";\nimport { REPORT_SCHEMA_VERSION } from \"../contracts/result/base-report.type\";\n\n/**\n * Options for {@link stampReportLineage}. Every field is optional —\n * the caller supplies whichever pieces it knows. Missing pieces are\n * left untouched (existing values on the report survive).\n */\nexport type LineageStamp = {\n  /**\n   * The outermost run-id this subtree belongs to. When set, EVERY\n   * node in the subtree gets its `rootRunId` rewritten to this\n   * value — overrides any inner self-roots produced by nested\n   * `buildResult` calls.\n   */\n  rootRunId: string;\n  /**\n   * Run-id of the immediate parent of THIS subtree's top node. Each\n   * descendant's `parentRunId` is then derived from its own walk\n   * position (its parent's `runId`).\n   */\n  parentRunId?: string;\n  /**\n   * Caller-supplied session identifier — propagates to every node in\n   * the subtree. Skipped when undefined.\n   */\n  sessionId?: string;\n};\n\n/**\n * Walk a freshly-built report tree and stamp lineage fields onto\n * every node:\n *\n * - `rootRunId` — rewritten to `stamp.rootRunId` everywhere. Composite\n *   children built by inner primitives carry their own self-root; this\n *   walk overrides it so the outer root wins (single coherent run id\n *   across the whole tree).\n * - `parentRunId` — root node gets `stamp.parentRunId`; descendants\n *   derive theirs from each parent's own `runId`.\n * - `sessionId` — propagated when provided.\n * - `reportSchemaVersion` — stamped only on the root (the value is the\n *   same for the whole tree; storing it on every node would waste\n *   space).\n *\n * Designed to run ONCE per top-level `buildResult` call. Each\n * primitive's executor invokes this on the assembled root report just\n * before returning; nested primitives produced their own subtree with\n * a self-root, and this pass relinks everything to the outer caller's\n * lineage.\n *\n * Mutates the report in place — internal use only, before the report\n * is exposed via `result.report`.\n *\n * @example\n * const root = this.buildBareReport();\n * stampReportLineage(root, { rootRunId: this.runId, sessionId: this.options?.sessionId });\n * return { ..., report: root };\n */\nexport function stampReportLineage(root: BaseReport, stamp: LineageStamp): void {\n  root.reportSchemaVersion = REPORT_SCHEMA_VERSION;\n\n  walk(root, stamp.rootRunId, stamp.parentRunId, stamp.sessionId);\n}\n\nfunction walk(node: BaseReport, rootRunId: string, parentRunId?: string, sessionId?: string): void {\n  node.rootRunId = rootRunId;\n\n  if (parentRunId !== undefined) {\n    node.parentRunId = parentRunId;\n  } else {\n    delete node.parentRunId;\n  }\n\n  if (sessionId !== undefined) {\n    node.sessionId = sessionId;\n  }\n\n  for (const child of node.children) {\n    walk(child, rootRunId, node.runId, sessionId);\n  }\n}\n","/**\n * Approximate the number of tokens in a string.\n *\n * Uses the ~4-characters-per-token heuristic, which is accurate enough for\n * GPT-4 family models and most English text. Use this when a real tokenizer\n * (tiktoken, etc.) isn't available or would add native dependencies.\n *\n * @example\n * const tokens = approximateTokenCount(\"Hello, world!\"); // 4\n */\nexport function approximateTokenCount(text: string): number {\n  return Math.ceil(text.length / 4);\n}\n","import type { StandardSchemaV1 } from \"@standard-schema/spec\";\nimport type { AgentExecuteOptions } from \"../contracts/agent/agent-options.type\";\nimport type { Attachment } from \"../contracts/attachment.type\";\nimport type { ContentPart } from \"../contracts/content-part.type\";\nimport type { Message } from \"../contracts/conversation-message.type\";\nimport type { Placeholders } from \"../contracts/placeholders.type\";\nimport { InvalidRequestError } from \"../errors\";\nimport { extractJsonSchema, prepareAttachmentPart } from \"../utils\";\nimport type { AgentConfig } from \"./agent-config.type\";\n\n/**\n * Outcome of `buildAgentInputMessages` — the seeded message list and\n * the JSON Schema cached for every trip's\n * `ModelCallOptions.responseSchema`. `responseSchema` is `undefined`\n * when the caller didn't ask for structured output.\n */\nexport type AgentInputBuildResult = {\n  messages: Message[];\n  responseSchema?: Record<string, unknown>;\n};\n\n/**\n * Assemble the seed conversation for an agent execution. Runs exactly\n * once per run — subsequent trips append to the same message list.\n *\n * Responsibilities (previously three methods on `Execution`):\n * 1. Merge factory + per-call placeholders.\n * 2. Resolve the system prompt (string, contract, or absent).\n * 3. When an output schema is supplied:\n *    - cache its JSON Schema form for `ModelCallOptions.responseSchema`\n *      so native-structured-output providers enforce it at the token\n *      level;\n *    - fall back to a soft system-prompt instruction for providers\n *      that don't advertise `structuredOutput` capability.\n * 4. Append caller-supplied `history` (e.g. session-level prior turns).\n * 5. Shape the user message — plain string in the common case,\n *    multipart `ContentPart[]` when `attachments` are present. Image\n *    attachments require model vision capability; mismatch throws\n *    `InvalidRequestError` here rather than failing opaquely at the\n *    provider.\n *\n * Extracted from the `Execution` class to isolate the declarative\n * input-shaping phase from the stateful trip loop.\n */\nexport async function buildAgentInputMessages<TOutput>(params: {\n  config: AgentConfig<TOutput>;\n  input: string;\n  options?: AgentExecuteOptions<TOutput>;\n}): Promise<AgentInputBuildResult> {\n  const { config, input, options } = params;\n\n  const placeholders: Placeholders = {\n    ...config.placeholders,\n    ...options?.placeholders,\n  };\n\n  const systemPrompt = options?.systemPrompt ?? config.systemPrompt;\n  let systemContent = \"\";\n\n  if (typeof systemPrompt === \"string\") {\n    systemContent = systemPrompt;\n  } else if (systemPrompt) {\n    systemContent = systemPrompt.resolve(placeholders);\n  }\n\n  const { responseSchema, instruction } = resolveStructuredOutput({\n    outputSchema: options?.output ?? config.output,\n    overrideResponseSchema: options?.responseSchema,\n    modelSupportsStructuredOutput: Boolean(config.model.capabilities?.structuredOutput),\n  });\n\n  if (instruction) {\n    systemContent = systemContent ? `${systemContent}\\n\\n${instruction}` : instruction;\n  }\n\n  const messages: Message[] = [];\n\n  if (systemContent) {\n    messages.push({ role: \"system\", content: systemContent });\n  }\n\n  if (options?.history) {\n    messages.push(...options.history);\n  }\n\n  const userContent = await buildUserMessageContent({\n    input,\n    attachments: options?.attachments,\n    modelName: config.model.name,\n    modelSupportsVision: Boolean(config.model.capabilities?.vision),\n  });\n\n  messages.push({ role: \"user\", content: userContent });\n\n  return { messages, responseSchema };\n}\n\n/**\n * Build the user message `content` field. Plain string when no\n * attachments (the hot path) — keeps wire payloads small. Multipart\n * `ContentPart[]` when attachments exist: input text first, resolved\n * parts in declaration order.\n */\nasync function buildUserMessageContent(params: {\n  input: string;\n  attachments?: Attachment[];\n  modelName: string;\n  modelSupportsVision: boolean;\n}): Promise<string | ContentPart[]> {\n  const { input, attachments, modelName, modelSupportsVision } = params;\n\n  if (!attachments || attachments.length === 0) {\n    return input;\n  }\n\n  const parts: ContentPart[] = await Promise.all(\n    attachments.map((attachment) => prepareAttachmentPart(attachment)),\n  );\n\n  const hasImage = parts.some((part) => part.type === \"image\");\n\n  if (hasImage && !modelSupportsVision) {\n    throw new InvalidRequestError(\n      `Model \"${modelName}\" does not declare vision capability — image attachments are not supported`,\n      { context: { modelName } },\n    );\n  }\n\n  return [{ type: \"text\", text: input }, ...parts];\n}\n\n/**\n * When the caller supplied an `output` schema, resolve two artifacts:\n *\n * - `responseSchema` — extracted JSON Schema to attach on every trip.\n *   Adapters that natively support structured output (OpenAI's\n *   `response_format: json_schema`) consume it; others ignore it.\n * - `instruction` — a soft fallback appended to the system prompt\n *   **only** for models without native structured-output capability.\n *   Capable adapters skip it to save tokens and avoid redundancy.\n */\nfunction resolveStructuredOutput(params: {\n  outputSchema?: StandardSchemaV1<unknown>;\n  overrideResponseSchema?: Record<string, unknown>;\n  modelSupportsStructuredOutput: boolean;\n}): {\n  responseSchema?: Record<string, unknown>;\n  instruction?: string;\n} {\n  const { outputSchema, overrideResponseSchema, modelSupportsStructuredOutput } = params;\n\n  if (!outputSchema) {\n    return {};\n  }\n\n  const responseSchema = overrideResponseSchema ?? extractJsonSchema(outputSchema);\n\n  if (modelSupportsStructuredOutput) {\n    return { responseSchema };\n  }\n\n  const schemaHint = responseSchema\n    ? `\\n\\nThe response MUST match this JSON Schema:\\n${JSON.stringify(responseSchema, null, 2)}`\n    : \"\";\n\n  const instruction = [\n    \"You MUST respond with a single valid JSON value only.\",\n    \"Do not wrap it in markdown code fences. Do not include prose, commentary, or explanation — JSON only.\",\n    schemaHint,\n  ]\n    .join(\"\")\n    .trim();\n\n  return { responseSchema, instruction };\n}\n","import type { Logger } from \"@warlock.js/logger\";\nimport type { AgentEventMap } from \"../contracts/events/event-map.type\";\nimport type { LLMTrip } from \"../contracts/result/llm-trip.type\";\nimport type { ToolCall } from \"../contracts/result/tool-call.type\";\nimport type { Usage } from \"../contracts/result/usage.type\";\n\n/**\n * Aggregate snapshot the agent-level log entries need at emission time\n * (agent completion + model name + running totals). Passed instead of\n * storing a back-reference to the Execution class — keeps this helper\n * a pure function.\n */\nexport type AgentLogContext = {\n  /** Dotted logger module, e.g. `\"ai.agent.my-writer\"`. */\n  module: string;\n  /** Maximum trips configured for this run — logged once on `agent.starting`. */\n  maxTrips: number;\n  /** Model identifier — logged once on `agent.starting`. */\n  modelName: string;\n  /** Final running usage totals at the moment `agent.completed` fires. */\n  totalUsage: Usage;\n  /** Monotonic duration (ms) since start at the moment `agent.completed` fires. */\n  totalDurationMs: number;\n  /** All trips recorded so far — logged count on `agent.completed`. */\n  trips: LLMTrip[];\n  /** All tool calls recorded so far — logged count on `agent.completed`. */\n  toolCalls: ToolCall[];\n};\n\n/**\n * Structured logging for agent lifecycle events. Mirrors\n * `Execution.emit`'s call sites without touching class state — the\n * caller passes the ambient snapshot in `ctx`, we route each event to\n * the right logger level and enrich with the per-event forensic\n * detail.\n *\n * Log-level convention:\n * - `info` — lifecycle boundaries (agent starting / completed) users\n *   want to see at default verbosity\n * - `debug` — per-trip + per-tool progress (hot-path, opt-in)\n * - `success` — trip completion + tool success (terminal per-step state)\n * - `warn` — tool failures (recoverable, agent loop continues)\n * - `error` — agent-level terminal errors\n *\n * Streaming deltas (`agent.trip.streaming`) are intentionally skipped\n * to avoid token-granularity log spam.\n */\nexport function logAgentEvent<K extends keyof AgentEventMap>(\n  logger: Logger,\n  ctx: AgentLogContext,\n  event: K,\n  payload: AgentEventMap[K],\n): void {\n  const action = event.replace(/^agent\\./, \"\");\n\n  switch (event) {\n    case \"agent.starting\": {\n      const { input } = payload as AgentEventMap[\"agent.starting\"];\n      logger.info(ctx.module, action, \"agent starting\", {\n        maxTrips: ctx.maxTrips,\n        model: ctx.modelName,\n        inputLength: input.length,\n      });\n      return;\n    }\n\n    case \"agent.trip.started\": {\n      const { tripIndex } = payload as AgentEventMap[\"agent.trip.started\"];\n      logger.debug(ctx.module, action, \"trip started\", { tripIndex });\n      return;\n    }\n\n    case \"agent.trip.streaming\": {\n      // Deltas are too high-volume to log at token granularity.\n      // Skipped on purpose; debug level still fires on trip boundaries.\n      return;\n    }\n\n    case \"agent.trip.completed\": {\n      const { trip } = payload as AgentEventMap[\"agent.trip.completed\"];\n      logger.success(ctx.module, action, \"trip completed\", {\n        tripIndex: trip.index,\n        duration: trip.duration,\n        usage: trip.usage,\n        finishReason: trip.finishReason,\n      });\n      return;\n    }\n\n    case \"agent.tool.calling\": {\n      const { tool, tripIndex } =\n        payload as AgentEventMap[\"agent.tool.calling\"];\n      logger.debug(ctx.module, action, `calling tool \"${tool.name}\"`, {\n        tool: tool.name,\n        action: tool.action,\n        tripIndex,\n      });\n      return;\n    }\n\n    case \"agent.tool.called\": {\n      const toolCall = payload as AgentEventMap[\"agent.tool.called\"];\n      logger.success(ctx.module, action, `tool \"${toolCall.name}\" finished`, {\n        tool: toolCall.name,\n        duration: toolCall.duration,\n        tripIndex: toolCall.tripIndex,\n      });\n      return;\n    }\n\n    case \"agent.tool.failed\": {\n      const { tool, error, tripIndex } =\n        payload as AgentEventMap[\"agent.tool.failed\"];\n\n      logger.warn(ctx.module, action, `tool \"${tool.name}\" failed`, {\n        tool: tool.name,\n        tripIndex,\n        error: {\n          code: error.code,\n          message: error.message,\n          name: error.name,\n          stack: error.stack,\n        },\n      });\n      return;\n    }\n\n    case \"agent.completed\": {\n      logger.info(ctx.module, action, \"agent completed\", {\n        duration: ctx.totalDurationMs,\n        usage: ctx.totalUsage,\n        trips: ctx.trips.length,\n        tools: ctx.toolCalls.length,\n      });\n      return;\n    }\n\n    case \"agent.error\": {\n      const { error } = payload as AgentEventMap[\"agent.error\"];\n      logger.error(ctx.module, action, error.message, {\n        code: error.code,\n        context: error.context,\n      });\n      return;\n    }\n  }\n}\n","import type { StreamContract, StreamEvent } from \"../contracts\";\n\n/**\n * Internal async-queue `StreamContract` used by `agent().stream()`.\n *\n * **Role.** The bridge between a streaming `Execution` (which runs in the\n * background, pushing events as they happen) and a consumer that reads\n * those events with `for await` or an `on(...)` handler map.\n *\n * **Responsibility.**\n * - Owns: the event queue, the pending-read promise chain, the terminal\n *   `result` promise, and any user-registered event handlers.\n * - Does NOT own: any knowledge of agents, models, or tool calls — it is a\n *   generic producer/consumer pipe parameterized by `TResult`. The streaming\n *   execution writes via `push()` / `end()` / `fail()`; the consumer reads\n *   via the AsyncIterable surface.\n *\n * Events are coalesced into a queue so that a consumer that starts\n * iterating late still sees every event in order — nothing is dropped. The\n * `on()` handlers fire the moment an event is pushed, independent of\n * whether anyone is iterating.\n *\n * @example\n * // Inside agent.stream():\n * const { controller, stream } = createAgentStream<AgentResult<TOutput>>();\n * new Execution(config, input, options, controller).run();\n * return stream;\n *\n * // Consumer:\n * for await (const event of stream) {\n *   if (event.type === \"streaming\") process.stdout.write(event.delta);\n * }\n * const result = await stream.result;\n */\nexport type StreamController<TResult> = {\n  push(event: StreamEvent): void;\n  end(result: TResult): void;\n  fail(error: Error): void;\n};\n\ntype PendingRead = {\n  resolve(value: IteratorResult<StreamEvent>): void;\n  reject(error: Error): void;\n};\n\nexport function createAgentStream<TResult>(): {\n  controller: StreamController<TResult>;\n  stream: StreamContract<TResult>;\n} {\n  const queue: StreamEvent[] = [];\n  const pending: PendingRead[] = [];\n  const handlers = new Map<StreamEvent[\"type\"], (event: StreamEvent) => void>();\n\n  let closed = false;\n  let failure: Error | undefined;\n  let resolveResult!: (value: TResult) => void;\n  let rejectResult!: (error: Error) => void;\n\n  const result = new Promise<TResult>((resolve, reject) => {\n    resolveResult = resolve;\n    rejectResult = reject;\n  });\n\n  const controller: StreamController<TResult> = {\n    push(event) {\n      const handler = handlers.get(event.type);\n\n      if (handler) {\n        try {\n          handler(event);\n        } catch {\n          // User-provided stream handlers must never crash the agent.\n          // Swallow — structured logging attaches here in Phase 0.5.\n        }\n      }\n\n      const reader = pending.shift();\n\n      if (reader) {\n        reader.resolve({ value: event, done: false });\n        return;\n      }\n\n      queue.push(event);\n    },\n\n    end(finalResult) {\n      closed = true;\n      resolveResult(finalResult);\n\n      while (pending.length > 0) {\n        const reader = pending.shift();\n\n        reader?.resolve({ value: undefined, done: true });\n      }\n    },\n\n    fail(error) {\n      closed = true;\n      failure = error;\n      rejectResult(error);\n\n      while (pending.length > 0) {\n        const reader = pending.shift();\n\n        reader?.reject(error);\n      }\n    },\n  };\n\n  const iterator: AsyncIterator<StreamEvent> = {\n    next() {\n      if (queue.length > 0) {\n        return Promise.resolve({ value: queue.shift()!, done: false });\n      }\n\n      if (closed) {\n        if (failure) {\n          return Promise.reject(failure);\n        }\n\n        return Promise.resolve({ value: undefined, done: true });\n      }\n\n      return new Promise<IteratorResult<StreamEvent>>((resolve, reject) => {\n        pending.push({ resolve, reject });\n      });\n    },\n  };\n\n  const stream: StreamContract<TResult> = {\n    result,\n    on(handlerMap) {\n      for (const [key, handler] of Object.entries(handlerMap)) {\n        if (handler) {\n          handlers.set(\n            key as StreamEvent[\"type\"],\n            handler as (event: StreamEvent) => void,\n          );\n        }\n      }\n\n      return stream;\n    },\n    [Symbol.asyncIterator]() {\n      return iterator;\n    },\n  };\n\n  return { controller, stream };\n}\n","import type { AgentEventMap } from \"../contracts/events/event-map.type\";\nimport type { StreamEventBody } from \"../contracts/stream/stream-event.type\";\n\n/**\n * Map an internal `AgentEventMap` entry into the public `StreamEvent`\n * shape. Event names are the same dot-notation strings on both sides;\n * only the payload shape needs per-event translation — the notable\n * case is `agent.tool.called`, whose event-map payload is a bare\n * `ToolCall` but whose stream wrapper is `{ toolCall }`.\n *\n * Extracted from the `Execution` class in `agent.ts` because it's\n * fully stateless (pure function of event name + payload) and used\n * only from the stream-forwarding path. Keeps the class focused on\n * stateful orchestration.\n */\nexport function agentEventToStreamEvent<K extends keyof AgentEventMap>(\n  event: K,\n  payload: AgentEventMap[K],\n): StreamEventBody | undefined {\n  switch (event) {\n    case \"agent.starting\": {\n      const { input } = payload as AgentEventMap[\"agent.starting\"];\n      return { type: \"agent.starting\", input };\n    }\n\n    case \"agent.trip.started\": {\n      const { tripIndex, input } =\n        payload as AgentEventMap[\"agent.trip.started\"];\n      return { type: \"agent.trip.started\", tripIndex, input };\n    }\n\n    case \"agent.trip.streaming\": {\n      const { delta, tripIndex } =\n        payload as AgentEventMap[\"agent.trip.streaming\"];\n      return { type: \"agent.trip.streaming\", delta, tripIndex };\n    }\n\n    case \"agent.tool.calling\": {\n      const { tool, input, tripIndex } =\n        payload as AgentEventMap[\"agent.tool.calling\"];\n      return { type: \"agent.tool.calling\", tool, input, tripIndex };\n    }\n\n    case \"agent.tool.called\": {\n      const called = payload as AgentEventMap[\"agent.tool.called\"];\n      // Split off the agent's enriched ToolCall record from the tool meta\n      // so the stream event surface mirrors the bus payload shape.\n      const { tool, ...toolCall } = called;\n      return { type: \"agent.tool.called\", toolCall, tool };\n    }\n\n    case \"agent.tool.failed\": {\n      const { tool, error, tripIndex } =\n        payload as AgentEventMap[\"agent.tool.failed\"];\n      return { type: \"agent.tool.failed\", tool, error, tripIndex };\n    }\n\n    case \"agent.trip.completed\": {\n      const { trip } = payload as AgentEventMap[\"agent.trip.completed\"];\n      return { type: \"agent.trip.completed\", trip };\n    }\n\n    case \"agent.completed\": {\n      return { type: \"agent.completed\" };\n    }\n\n    case \"agent.error\": {\n      const { error } = payload as AgentEventMap[\"agent.error\"];\n      return { type: \"agent.error\", error };\n    }\n\n    default: {\n      return undefined;\n    }\n  }\n}\n","import type { StandardSchemaV1 } from \"@standard-schema/spec\";\nimport type { ModelToolCallRequest } from \"../contracts/model-tool-call-request.type\";\nimport type { ToolContract } from \"../tool/tool\";\n\n/**\n * Default cap on bytes accumulated in a single suspect buffer before\n * the guard gives up, flushes as text, and resets to pass-through.\n * Real envelope payloads observed in production leaks are well under\n * 1 KB; this is a safety valve against runaway / adversarial input.\n */\nconst DEFAULT_MAX_BUFFER_BYTES = 4096;\n\n/**\n * Fence opener the guard recognizes in pass-through mode. Targets the\n * lowercase form ```` ```json ```` only — that is the form models\n * actually emit in the wild when they fence-wrap a JSON tool envelope.\n * Other languages / casings flush as plain text.\n */\nconst FENCE_OPENER = \"```json\";\n\n/**\n * Closing fence sequence inside `bufferingFence` mode. Three backticks,\n * no language tag.\n */\nconst FENCE_CLOSER = \"```\";\n\n/**\n * Options passed when constructing a `JsonStreamGuard`.\n *\n * The guard is deliberately framework-agnostic of *how* deltas are\n * emitted or how recovered calls are dispatched — callers wire those\n * via `onSafeDelta` / `onRecoveredCall`. This keeps the unit-testable\n * surface tiny and lets the agent loop own all event-emission policy.\n */\nexport type JsonStreamGuardOptions = {\n  /** Tools the agent has registered for this trip. Envelope lookups use `.name`. */\n  tools: ReadonlyArray<ToolContract<unknown, unknown>>;\n  /**\n   * Hard cap on a single suspect buffer's size. When exceeded, the\n   * buffer is flushed verbatim as text and the guard returns to\n   * pass-through. Defaults to {@link DEFAULT_MAX_BUFFER_BYTES}.\n   */\n  maxBufferBytes?: number;\n  /**\n   * Called for every chunk of text that survived the guard — exactly\n   * what the consumer should treat as the visible delta. May be\n   * called many times per `feed()` call, possibly with a single\n   * character or with a multi-character flush.\n   */\n  onSafeDelta: (delta: string) => void;\n  /**\n   * Called once per envelope the guard successfully classifies as a\n   * tool-call recovery. The request carries `recoveredFrom:\n   * \"stream-text\"` so downstream consumers can distinguish synthesized\n   * calls from real ones.\n   */\n  onRecoveredCall: (request: ModelToolCallRequest) => void;\n};\n\n/**\n * Per-trip state machine that intercepts streamed text deltas, detects\n * JSON envelopes the model has emitted as plain text (the\n * tool-call-leakage symptom), and synthesizes real `ModelToolCallRequest`\n * entries for them while suppressing the JSON from visible output.\n *\n * **Role.** A `JsonStreamGuard` is the per-trip implementation of the\n * opt-in `streamingToolGuard` config. It sits between the model\n * adapter's `delta` chunks and the agent's `agent.trip.streaming`\n * emit + `content` accumulator — text that survives the guard is what\n * the consumer sees and what the trip records as `output`.\n *\n * **Responsibility.**\n * - Owns: a small character-level state machine (pass-through,\n *   brace-buffering, fence-buffering), string-literal-aware brace\n *   tracking, fence-opener / fence-closer detection, named-envelope\n *   matching against registered tool schemas, buffer-cap enforcement.\n * - Does NOT own: event emission (delegated via callbacks), tool\n *   dispatch, `finishReason` normalization, dedupe vs. real tool\n *   calls — the agent loop handles all four.\n *\n * **Matcher tier — named envelope only (v1).** A buffer matches when\n * it parses as a JSON object containing both:\n *   - a `name` or `tool` key resolving to a registered tool name, AND\n *   - an `arguments` or `input` key whose value validates against the\n *     resolved tool's `~standard` schema.\n * Bare-object matching (where any registered tool's schema is the\n * sole signal) is deferred until tool input schemas are tight enough\n * to distinguish — `v.record(v.any())` would match everything.\n *\n * **Per-trip lifecycle.** One instance per trip. The agent loop calls\n * `feed(chunk)` for every `delta` chunk and `finalize()` exactly once\n * after the stream's `done` chunk. Mid-stream cancellation: the loop\n * simply stops calling `feed`; any open buffer is discarded with the\n * guard instance.\n *\n * Modeled as a class (see §4.2 of code-style.md — per-call execution\n * state across phases): the machine has 3 states, accumulators for\n * brace depth, string-literal escape tracking, and a synthesized-call\n * counter for stable ids across the trip.\n *\n * @example\n * // Inside the agent's streaming trip body:\n * const guard = new JsonStreamGuard({\n *   tools: this.config.tools ?? [],\n *   maxBufferBytes: guardConfig.maxBufferBytes,\n *   onSafeDelta: (delta) => {\n *     content += delta;\n *     this.emit(\"agent.trip.streaming\", { delta, tripIndex });\n *   },\n *   onRecoveredCall: (request) => recoveredCalls.push(request),\n * });\n *\n * for await (const chunk of model.stream(messages, callOptions)) {\n *   if (chunk.type === \"delta\") await guard.feed(chunk.content);\n *   // ... other chunk types\n * }\n *\n * await guard.finalize();\n */\nexport class JsonStreamGuard {\n  private readonly tools: ReadonlyArray<ToolContract<unknown, unknown>>;\n  private readonly maxBufferBytes: number;\n  private readonly onSafeDelta: (delta: string) => void;\n  private readonly onRecoveredCall: (request: ModelToolCallRequest) => void;\n\n  private mode: \"passThrough\" | \"bufferingBrace\" | \"bufferingFence\" = \"passThrough\";\n\n  /**\n   * Characters held back in pass-through mode while we resolve whether\n   * a partial fence opener (`` ` ``, `` `` ``, `` ``` ``, `` ```j ``, …)\n   * will complete or break. Always a strict prefix of {@link FENCE_OPENER};\n   * emptied (and emitted verbatim) the moment a non-matching character\n   * arrives.\n   */\n  private holdback = \"\";\n\n  /**\n   * Accumulator while `mode === \"bufferingBrace\"` or `\"bufferingFence\"`.\n   * In brace mode it carries the JSON including the outermost `{`/`}`.\n   * In fence mode it carries everything between the opener and the\n   * closer (the opener and closer themselves are NOT in the buffer —\n   * they are reconstructed only on a flush-as-text fallback).\n   */\n  private buffer = \"\";\n\n  /**\n   * Brace-depth counter for `bufferingBrace` mode. Increments on `{`,\n   * decrements on `}` — but only when {@link inString} is false, so a\n   * `{` inside a JSON string literal does not skew the depth. Buffer\n   * closes when depth returns to zero.\n   */\n  private braceDepth = 0;\n\n  /** True while the scanner is inside a `\"...\"` JSON string literal. */\n  private inString = false;\n\n  /**\n   * True when the previous character inside a string literal was a\n   * backslash, so the current character is escaped (`\\\"` does not end\n   * the string; `\\\\` resets the flag without escaping anything else).\n   */\n  private escapeNext = false;\n\n  /**\n   * Trailing tail of the fence buffer used to detect the closing\n   * ```` ``` ```` sequence. Length capped at the closer length; rotated\n   * forward as new characters arrive.\n   */\n  private fenceCloseTail = \"\";\n\n  /**\n   * Count of envelopes the guard has successfully synthesized this\n   * trip. Used to assign deterministic, collision-free ids on\n   * recovered `ModelToolCallRequest` entries.\n   */\n  private recoveredCount = 0;\n\n  public constructor(options: JsonStreamGuardOptions) {\n    this.tools = options.tools;\n    this.maxBufferBytes = options.maxBufferBytes ?? DEFAULT_MAX_BUFFER_BYTES;\n    this.onSafeDelta = options.onSafeDelta;\n    this.onRecoveredCall = options.onRecoveredCall;\n  }\n\n  /**\n   * Feed the next raw delta from the model. Splits the chunk into\n   * characters and runs each through the state machine, awaiting\n   * envelope classification whenever a buffer closes mid-chunk.\n   *\n   * The hot path (pass-through prose with no `{` / `` ` ``) is fully\n   * synchronous — `await` here only blocks at buffer-close points,\n   * which are rare in normal traffic.\n   */\n  public async feed(chunk: string): Promise<void> {\n    for (let i = 0; i < chunk.length; i++) {\n      await this.processChar(chunk[i]);\n    }\n  }\n\n  /**\n   * Stream ended. Anything still in the holdback was prose\n   * misclassified as a partial fence opener — emit it. Anything still\n   * in an open buffer never closed — emit it as text too (a leak\n   * truncated mid-flight is still text the user partially saw).\n   */\n  public async finalize(): Promise<void> {\n    if (this.holdback.length > 0) {\n      this.onSafeDelta(this.holdback);\n      this.holdback = \"\";\n    }\n\n    if (this.mode === \"bufferingBrace\") {\n      this.flushBraceBufferAsText();\n      return;\n    }\n\n    if (this.mode === \"bufferingFence\") {\n      this.flushFenceBufferAsText();\n    }\n  }\n\n  /**\n   * True when at least one envelope was recovered this trip. The\n   * agent loop reads this to override `finishReason` from `\"stop\"` to\n   * `\"tool_calls\"` when the model reported a natural stop but the\n   * guard found tool calls hiding in the text channel.\n   */\n  public hasRecoveredCalls(): boolean {\n    return this.recoveredCount > 0;\n  }\n\n  /**\n   * Route a single character based on the current mode. The\n   * `passThrough` branch handles holdback expansion / flushing\n   * iteratively (no recursion) so a character that \"breaks\" a fence\n   * opener can be re-evaluated as a fresh pass-through input in the\n   * same call.\n   */\n  private async processChar(char: string): Promise<void> {\n    if (this.mode === \"bufferingBrace\") {\n      await this.processBraceChar(char);\n      return;\n    }\n\n    if (this.mode === \"bufferingFence\") {\n      await this.processFenceChar(char);\n      return;\n    }\n\n    let current = char;\n\n    while (true) {\n      if (this.holdback.length === 0 && current === \"{\") {\n        this.openBraceBuffer(current);\n        return;\n      }\n\n      const extended = this.holdback + current;\n\n      if (this.isFenceOpenerPrefix(extended)) {\n        this.holdback = extended;\n\n        if (extended === FENCE_OPENER) {\n          this.openFenceBuffer();\n        }\n\n        return;\n      }\n\n      if (this.holdback.length === 0) {\n        this.onSafeDelta(current);\n        return;\n      }\n\n      this.onSafeDelta(this.holdback);\n      this.holdback = \"\";\n    }\n  }\n\n  /**\n   * Recognize any strict prefix of {@link FENCE_OPENER} including the\n   * full string. Used to decide whether to keep extending the holdback\n   * or flush it as plain text.\n   */\n  private isFenceOpenerPrefix(candidate: string): boolean {\n    return candidate.length <= FENCE_OPENER.length && FENCE_OPENER.startsWith(candidate);\n  }\n\n  /**\n   * Enter `bufferingBrace` mode with the seed `{` as the first buffer\n   * character and the initial brace depth set to one. Any holdback at\n   * this point was already a non-fence sequence so it stays empty.\n   */\n  private openBraceBuffer(seed: string): void {\n    this.mode = \"bufferingBrace\";\n    this.buffer = seed;\n    this.braceDepth = 1;\n    this.inString = false;\n    this.escapeNext = false;\n  }\n\n  /**\n   * Enter `bufferingFence` mode immediately after the opener\n   * ```` ```json ```` matched in the holdback. Holdback resets;\n   * subsequent characters accumulate into the buffer until the\n   * closing fence is seen.\n   */\n  private openFenceBuffer(): void {\n    this.mode = \"bufferingFence\";\n    this.buffer = \"\";\n    this.fenceCloseTail = \"\";\n    this.holdback = \"\";\n  }\n\n  /**\n   * Process one character while accumulating a brace-delimited JSON\n   * object. Tracks string-literal context so `{` / `}` inside `\"...\"`\n   * do not skew brace depth. Closes (and classifies) on balanced\n   * braces; flushes-as-text on cap overflow.\n   */\n  private async processBraceChar(char: string): Promise<void> {\n    this.buffer += char;\n\n    if (this.inString) {\n      if (this.escapeNext) {\n        this.escapeNext = false;\n        return;\n      }\n\n      if (char === \"\\\\\") {\n        this.escapeNext = true;\n        return;\n      }\n\n      if (char === '\"') {\n        this.inString = false;\n      }\n\n      this.guardBufferCap(\"brace\");\n      return;\n    }\n\n    if (char === '\"') {\n      this.inString = true;\n      this.guardBufferCap(\"brace\");\n      return;\n    }\n\n    if (char === \"{\") {\n      this.braceDepth++;\n      this.guardBufferCap(\"brace\");\n      return;\n    }\n\n    if (char === \"}\") {\n      this.braceDepth--;\n\n      if (this.braceDepth === 0) {\n        await this.closeBraceBuffer();\n        return;\n      }\n\n      this.guardBufferCap(\"brace\");\n      return;\n    }\n\n    this.guardBufferCap(\"brace\");\n  }\n\n  /**\n   * Process one character while accumulating a fence-delimited JSON\n   * block. The closing fence ```` ``` ```` ends the block; the closing\n   * characters are NOT included in the classified buffer (they are\n   * re-emitted only when the block flushes back to text).\n   */\n  private async processFenceChar(char: string): Promise<void> {\n    this.fenceCloseTail += char;\n\n    if (this.fenceCloseTail.length > FENCE_CLOSER.length) {\n      this.fenceCloseTail = this.fenceCloseTail.slice(-FENCE_CLOSER.length);\n    }\n\n    if (this.fenceCloseTail === FENCE_CLOSER) {\n      const innerLength = this.buffer.length - (FENCE_CLOSER.length - 1);\n      this.buffer = this.buffer.slice(0, Math.max(0, innerLength));\n\n      await this.closeFenceBuffer();\n      return;\n    }\n\n    this.buffer += char;\n    this.guardBufferCap(\"fence\");\n  }\n\n  /**\n   * Enforce the buffer-byte cap. When the current buffer exceeds the\n   * cap, flush it back to the consumer as plain text and reset to\n   * pass-through. Acts as a runaway / adversarial-input safety valve.\n   */\n  private guardBufferCap(source: \"brace\" | \"fence\"): void {\n    if (this.buffer.length <= this.maxBufferBytes) {\n      return;\n    }\n\n    if (source === \"brace\") {\n      this.flushBraceBufferAsText();\n      return;\n    }\n\n    this.flushFenceBufferAsText();\n  }\n\n  /**\n   * Run the envelope matcher against the closed brace buffer. On a\n   * match, synthesize a recovered `ModelToolCallRequest`; on no\n   * match, flush the buffer back as plain text. Resets state to\n   * pass-through either way.\n   */\n  private async closeBraceBuffer(): Promise<void> {\n    const closed = this.buffer;\n\n    this.resetToPassThrough();\n\n    const matched = await this.tryMatchEnvelope(closed);\n\n    if (matched) {\n      return;\n    }\n\n    this.onSafeDelta(closed);\n  }\n\n  /**\n   * Run the envelope matcher against the closed fence buffer. On a\n   * match, synthesize a recovered call; on no match, flush as text\n   * **with** the original opener and closer reconstructed so the\n   * customer sees exactly the markdown the model emitted.\n   */\n  private async closeFenceBuffer(): Promise<void> {\n    const closed = this.buffer;\n\n    this.resetToPassThrough();\n\n    const matched = await this.tryMatchEnvelope(closed);\n\n    if (matched) {\n      return;\n    }\n\n    this.onSafeDelta(`${FENCE_OPENER}${closed}${FENCE_CLOSER}`);\n  }\n\n  /**\n   * Emit the brace-buffer verbatim as text and reset to pass-through.\n   * Used on cap overflow and on `finalize()` for an unclosed buffer.\n   */\n  private flushBraceBufferAsText(): void {\n    const closed = this.buffer;\n    this.resetToPassThrough();\n    this.onSafeDelta(closed);\n  }\n\n  /**\n   * Emit the fence-buffer verbatim as text, reconstructing the\n   * opener and closer so the original markdown structure is\n   * preserved for the consumer.\n   */\n  private flushFenceBufferAsText(): void {\n    const closed = this.buffer;\n    this.resetToPassThrough();\n    this.onSafeDelta(`${FENCE_OPENER}${closed}`);\n  }\n\n  /**\n   * Reset all per-buffer state back to the pass-through baseline.\n   * Called whenever a buffer closes — by recovery, by flush, or by\n   * cap overflow — so the next character starts a fresh scan.\n   */\n  private resetToPassThrough(): void {\n    this.mode = \"passThrough\";\n    this.buffer = \"\";\n    this.braceDepth = 0;\n    this.inString = false;\n    this.escapeNext = false;\n    this.fenceCloseTail = \"\";\n  }\n\n  /**\n   * Attempt to classify a closed buffer as a tool-call envelope. On\n   * success, invoke `onRecoveredCall` with a synthesized request and\n   * return `true`; on failure return `false` so the caller can flush\n   * the buffer back as text.\n   */\n  private async tryMatchEnvelope(raw: string): Promise<boolean> {\n    const parsed = safeParseJson(raw);\n\n    if (parsed === undefined || typeof parsed !== \"object\" || parsed === null) {\n      return false;\n    }\n\n    const envelope = parsed as Record<string, unknown>;\n    const candidateName = readString(envelope, \"name\") ?? readString(envelope, \"tool\");\n    const candidateInput = readObject(envelope, \"arguments\") ?? readObject(envelope, \"input\");\n\n    if (!candidateName || !candidateInput) {\n      return false;\n    }\n\n    const tool = this.tools.find((entry) => entry.name === candidateName);\n\n    if (!tool || !tool.input) {\n      return false;\n    }\n\n    const schema = tool.input as StandardSchemaV1<unknown>;\n\n    let validationResult: StandardSchemaV1.Result<unknown>;\n\n    try {\n      validationResult = await schema[\"~standard\"].validate(candidateInput);\n    } catch {\n      return false;\n    }\n\n    if (validationResult.issues) {\n      return false;\n    }\n\n    this.recoveredCount++;\n\n    this.onRecoveredCall({\n      id: `synth_${candidateName}_${this.recoveredCount}`,\n      name: candidateName,\n      input: validationResult.value,\n      recoveredFrom: \"stream-text\",\n    });\n\n    return true;\n  }\n}\n\n/**\n * Parse a JSON string returning `undefined` on any failure. Local to\n * the guard so it can distinguish \"not JSON\" from a parsed `null`\n * value, which `safeJsonParse` cannot — a parsed `null` is a valid\n * JSON value but not a valid envelope, and we want the difference.\n */\nfunction safeParseJson(raw: string): unknown {\n  try {\n    return JSON.parse(raw);\n  } catch {\n    return undefined;\n  }\n}\n\n/**\n * Read a string-typed field from an envelope candidate. Returns\n * `undefined` when the key is missing or the value is non-string —\n * the matcher rejects either case.\n */\nfunction readString(envelope: Record<string, unknown>, key: string): string | undefined {\n  const value = envelope[key];\n\n  return typeof value === \"string\" && value.length > 0 ? value : undefined;\n}\n\n/**\n * Read an object-typed field from an envelope candidate. Returns\n * `undefined` when the key is missing or the value is not a\n * plain object (rejects arrays, primitives, null) — tool input\n * schemas always validate against an object root.\n */\nfunction readObject(\n  envelope: Record<string, unknown>,\n  key: string,\n): Record<string, unknown> | undefined {\n  const value = envelope[key];\n\n  if (value === null || typeof value !== \"object\" || Array.isArray(value)) {\n    return undefined;\n  }\n\n  return value as Record<string, unknown>;\n}\n","import type { StandardSchemaV1 } from \"@standard-schema/spec\";\nimport { log, type Logger } from \"@warlock.js/logger\";\nimport type {\n  AgentContract,\n  AgentEventHandler,\n  AgentEventMap,\n  AgentExecuteOptions,\n  AgentResult,\n  BaseReport,\n  CompleteEvent,\n  FinishReason,\n  LLMTrip,\n  Message,\n  MiddlewareExecuteContext,\n  MiddlewareState,\n  MiddlewareToolContext,\n  MiddlewareTripContext,\n  ModelResponse,\n  ModelToolCallRequest,\n  StreamContract,\n  StreamEventBody,\n  StreamingToolGuardConfig,\n  ToolCall,\n  ToolEventMeta,\n  Usage,\n  UsageEvent,\n  WithoutIdentity,\n} from \"../contracts\";\nimport {\n  AgentCancelledError,\n  AgentExecutionError,\n  AgentMaxTripsError,\n  AIError,\n  SchemaValidationError,\n} from \"../errors\";\nimport { runPipeline } from \"../middleware\";\nimport type { ToolContract, ToolInvokeResult } from \"../tool/tool\";\nimport {\n  accumulateCost,\n  computeCost,\n  extractJsonPayload,\n  generateRunId,\n  safeJsonParse,\n  stampReportLineage,\n} from \"../utils\";\nimport type { AgentConfig } from \"./agent-config.type\";\nimport { buildAgentInputMessages } from \"./agent-input-builder\";\nimport { logAgentEvent } from \"./agent-log-event\";\nimport { createAgentStream, type StreamController } from \"./agent-stream\";\nimport { agentEventToStreamEvent } from \"./agent-to-stream-event\";\nimport { JsonStreamGuard } from \"./json-stream-guard\";\n\nconst LOG_MODULE = \"ai.agent\";\n\n/**\n * Detect abort-flavored errors surfaced by SDK HTTP layers — the\n * DOM `AbortError`, axios `ERR_CANCELED`, node-fetch's own\n * `AbortError`. Used to classify them as cancellation rather than\n * generic agent-execution failures.\n */\nfunction isAbortLike(err: unknown): boolean {\n  if (!err || typeof err !== \"object\") return false;\n\n  const e = err as { name?: unknown; code?: unknown };\n\n  return e.name === \"AbortError\" || e.code === \"ERR_CANCELED\" || e.code === \"ABORT_ERR\";\n}\n\n/**\n * Readable synthetic name for agents constructed without an explicit\n * `name`. Format: `anon_<provider>_<model>[_<tool1>+<tool2>+...]` —\n * deterministic (same config → same name across restarts) and\n * human-readable in logs / workflow snapshots.\n *\n * Keeps drift detection honest for the `ai.agent({ model })`\n * one-liner without punishing it with a hashed id nobody can read.\n */\nfunction synthesizeAgentName<T>(config: AgentConfig<T>): string {\n  const provider = (config.model as unknown as { provider?: string })?.provider ?? \"unknown\";\n  const model = config.model?.name ?? \"unknown\";\n  const tools = (config.tools ?? [])\n    .map((tool) => tool.name)\n    .sort()\n    .join(\"+\");\n\n  const base = `anon_${sanitize(provider)}_${sanitize(model)}`;\n  return tools ? `${base}_${sanitize(tools, { keepPlus: true })}` : base;\n}\n\nfunction sanitize(value: string, opts: { keepPlus?: boolean } = {}): string {\n  const allowed = opts.keepPlus ? /[^a-zA-Z0-9._+-]/g : /[^a-zA-Z0-9._-]/g;\n  return value.replace(allowed, \"-\");\n}\n\n/**\n * Authoring-time check on the middleware array. Throws an\n * `AgentExecutionError` with `context: { authoring: true }` the\n * moment an invalid entry is found — the agent factory surface is\n * where config bugs should surface, not ten trips into a run.\n *\n * Validates:\n * - Every entry is a non-null object with a non-empty string `name`.\n * - No two entries share the same `name` (would silently collide on\n *   `ctx.state` keys and produce impossible-to-debug behavior).\n *\n * Does NOT validate that hook maps contain callable functions —\n * that would catch late-binding bugs but also reject legitimate\n * patterns like `before` being conditionally `undefined`. Runtime\n * dispatch handles missing hooks safely.\n */\nfunction validateMiddleware(middleware: ReadonlyArray<unknown> | undefined): void {\n  if (!middleware || middleware.length === 0) {\n    return;\n  }\n\n  const seen = new Set<string>();\n\n  for (let index = 0; index < middleware.length; index++) {\n    const entry = middleware[index];\n\n    if (!entry || typeof entry !== \"object\") {\n      throw new AgentExecutionError(\n        `middleware[${index}] must be an object; received ${entry === null ? \"null\" : typeof entry}`,\n        { context: { authoring: true, index } },\n      );\n    }\n\n    const name = (entry as { name?: unknown }).name;\n\n    if (typeof name !== \"string\" || name.length === 0) {\n      throw new AgentExecutionError(`middleware[${index}] must have a non-empty string \"name\"`, {\n        context: { authoring: true, index },\n      });\n    }\n\n    if (seen.has(name)) {\n      throw new AgentExecutionError(\n        `duplicate middleware name \"${name}\" — each middleware needs a unique name so ctx.state keys do not collide`,\n        { context: { authoring: true, index, name } },\n      );\n    }\n\n    seen.add(name);\n  }\n}\n\n/**\n * Creates an executable AI agent from the given configuration.\n *\n * The agent runs a bounded trip loop: each trip calls the model, dispatches\n * any requested tool calls, then loops until the model stops or `maxTrips`\n * is reached. Each `execute()` / `stream()` call spawns a fresh internal\n * `Execution` instance — the factory itself holds no state across calls.\n *\n * `execute()` never throws — any error is attached to the returned result\n * under `result.error`. `stream()` surfaces errors both on the terminal\n * `error` stream event and via the `stream.result` promise.\n *\n * @example\n * const myAgent = agent({\n *   model: openai.model({ name: \"gpt-4o\" }),\n *   systemPrompt: \"You are a helpful assistant.\",\n *   tools: [searchTool],\n * });\n *\n * const result = await myAgent.execute(\"What is the capital of Egypt?\");\n *\n * @example\n * const stream = myAgent.stream(\"Write a haiku about Cairo.\");\n *\n * for await (const event of stream) {\n *   if (event.type === \"streaming\") process.stdout.write(event.delta);\n * }\n *\n * const result = await stream.result;\n */\nexport function agent<TOutput = unknown>(config: AgentConfig<TOutput>): AgentContract<TOutput> {\n  // Authoring-time validation of the middleware array. Rejects two\n  // classes of bug that would otherwise surface as opaque failures\n  // mid-execution: (a) entries that aren't proper middleware\n  // objects (null, undefined, missing `name`), and (b) two\n  // middlewares sharing the same `name`, which would silently\n  // collide on `ctx.state` keys. Fail fast, fail loud — per the\n  // authoring-time rules in `domains/ai/conventions/errors.md`.\n  validateMiddleware(config.middleware);\n\n  // Resolve the agent's identity. Explicit `name` wins; otherwise we\n  // synthesize a DETERMINISTIC fingerprint from the config's\n  // identity-defining fields (model + provider + tool names). Same\n  // config across process restarts produces the same synthetic name,\n  // so workflow signature drift detection stays honest for agents\n  // composed into workflows without explicit names.\n  const isAnonymous = !config.name || typeof config.name !== \"string\";\n  const name = isAnonymous ? synthesizeAgentName(config) : (config.name as string);\n  const resolvedConfig: AgentConfig<TOutput> = { ...config, name };\n\n  // Instance-level handlers registered via `.on()`. Stored here\n  // (factory-scope) so every `execute()` / `stream()` call on this\n  // agent sees the same set. Each event name gets its own Set so\n  // `off()` can remove a specific handler without disturbing others.\n  const instanceHandlers = new Map<\n    keyof AgentEventMap,\n    Set<AgentEventHandler<keyof AgentEventMap>>\n  >();\n\n  function on<K extends keyof AgentEventMap>(event: K, handler: AgentEventHandler<K>): () => void {\n    const existing = instanceHandlers.get(event);\n    const bucket = existing ?? new Set<AgentEventHandler<keyof AgentEventMap>>();\n\n    if (!existing) {\n      instanceHandlers.set(event, bucket);\n    }\n\n    bucket.add(handler as AgentEventHandler<keyof AgentEventMap>);\n\n    return () => off(event, handler);\n  }\n\n  function off<K extends keyof AgentEventMap>(event: K, handler: AgentEventHandler<K>): void {\n    const bucket = instanceHandlers.get(event);\n\n    if (!bucket) {\n      return;\n    }\n\n    bucket.delete(handler as AgentEventHandler<keyof AgentEventMap>);\n\n    if (bucket.size === 0) {\n      instanceHandlers.delete(event);\n    }\n  }\n\n  return {\n    name,\n    isAnonymous,\n    description: config.description,\n    async execute(\n      input: string,\n      options?: AgentExecuteOptions<TOutput>,\n    ): Promise<AgentResult<TOutput>> {\n      return new Execution<TOutput>(\n        resolvedConfig,\n        input,\n        options,\n        undefined,\n        instanceHandlers,\n      ).run();\n    },\n\n    stream(\n      input: string,\n      options?: AgentExecuteOptions<TOutput>,\n    ): StreamContract<AgentResult<TOutput>> {\n      const { controller, stream } = createAgentStream<AgentResult<TOutput>>();\n\n      const execution = new Execution<TOutput>(\n        resolvedConfig,\n        input,\n        options,\n        controller,\n        instanceHandlers,\n      );\n\n      void execution.run();\n\n      return stream;\n    },\n\n    on,\n    off,\n  };\n}\n\n/**\n * Name → handler-set map shared between the `agent()` factory and its\n * per-call `Execution`. Each `.on()` registration mutates this map;\n * every `Execution` reads from the same reference so additions and\n * removals take effect mid-flight.\n */\ntype InstanceHandlerMap = Map<keyof AgentEventMap, Set<AgentEventHandler<keyof AgentEventMap>>>;\n\n/**\n * Per-call driver that owns the full lifecycle of a single\n * `agent.execute()` or `agent.stream()` invocation.\n *\n * **Role.** An `Execution` is the short-lived state container and phase\n * orchestrator for one agent run. The public `agent()` factory stays purely\n * functional — all mutable bookkeeping (trips, tool calls, usage totals,\n * message history, terminal error, parsed output) lives here so each call\n * gets a fresh, isolated instance.\n *\n * **Responsibility.**\n * - Owns: building the initial message list, driving the bounded trip loop,\n *   dispatching tool calls safely, parsing the final output against the\n *   caller's schema, emitting lifecycle events (to both the user handler\n *   and, in stream mode, the `StreamController`), and producing the\n *   `AgentResult`.\n * - Does NOT own: how the model produces responses (delegated to\n *   `ModelContract.complete` / `ModelContract.stream`), how tools execute\n *   (delegated to `ToolContract.invoke`), the async-queue plumbing for\n *   streaming (delegated to `createAgentStream`), or any cross-call state\n *   (factory-level concerns live in `agent()`).\n *\n * Streaming mode is opt-in via the fourth constructor argument: pass a\n * `StreamController` and every event is mirrored into it while model calls\n * are driven via `model.stream()` instead of `model.complete()`. The public\n * contract of `execute()` says it never throws — `Execution` enforces that\n * by funneling every unexpected error into `this.error` and returning a\n * well-formed result regardless of what went wrong.\n *\n * Not exported — consumers interact only with the `agent()` factory (see\n * §4.2 of code-style.md — \"per-call execution state across phases\").\n *\n * @example\n * // Non-streaming — inside agent.execute():\n * const result = await new Execution(config, input, options).run();\n *\n * @example\n * // Streaming — inside agent.stream():\n * const { controller, stream } = createAgentStream();\n * void new Execution(config, input, options, controller).run();\n * return stream;\n */\nclass Execution<TOutput> {\n  private readonly trips: LLMTrip[] = [];\n  private readonly toolCalls: ToolCall[] = [];\n  private readonly usage: Usage = { input: 0, output: 0, total: 0 };\n  private readonly messages: Message[] = [];\n  private readonly maxTrips: number;\n  private readonly startedAt = new Date();\n  private readonly start = performance.now();\n  private readonly runId = generateRunId(\"agent\");\n  private readonly logger: Logger = log;\n  private readonly middleware: ReadonlyArray<\n    NonNullable<AgentConfig<TOutput>[\"middleware\"]>[number]\n  >;\n  private readonly middlewareState: MiddlewareState = new Map();\n\n  private error?: AIError;\n  private data?: TOutput;\n  private responseSchema?: Record<string, unknown>;\n\n  public constructor(\n    private readonly config: AgentConfig<TOutput>,\n    private readonly input: string,\n    private readonly options?: AgentExecuteOptions<TOutput>,\n    private readonly streamController?: StreamController<AgentResult<TOutput>>,\n    private readonly instanceHandlers?: InstanceHandlerMap,\n  ) {\n    this.maxTrips = config.maxTrips ?? 10;\n    this.middleware = config.middleware ?? [];\n  }\n\n  /**\n   * Base middleware context shared by every level. `state` is the\n   * single mutable bag threaded through `execute`, `trip`, and `tool`\n   * hooks for the lifetime of this execution — fresh per `execute()`\n   * call, never reused across runs.\n   */\n  private buildExecuteContext(): MiddlewareExecuteContext {\n    return {\n      agent: {\n        name: this.config.name ?? this.config.model.name,\n        isAnonymous: !this.config.name,\n      },\n      model: {\n        name: this.config.model.name,\n        provider: this.config.model.provider,\n      },\n      input: this.input,\n      options: this.options as AgentExecuteOptions<unknown> | undefined,\n      state: this.middlewareState,\n      signal: this.options?.signal,\n    };\n  }\n\n  /**\n   * Entry point for a single agent execution. Wraps the real work\n   * (`runCore`) in the `execute`-level middleware pipeline, then\n   * emits the terminal `agent.completed` / `agent.error` events and\n   * closes the stream (if any) with the post-pipeline result — so\n   * middleware that short-circuits or transforms the final result\n   * still produces a well-formed public outcome.\n   *\n   * Must never throw: any error that escapes the pipeline is\n   * converted into an `AgentResult` with `error` populated before\n   * returning, preserving the `agent.execute()` public contract.\n   */\n  public async run(): Promise<AgentResult<TOutput>> {\n    const context = this.buildExecuteContext();\n\n    let result: AgentResult<TOutput>;\n\n    try {\n      result = (await runPipeline(\n        this.middleware,\n        \"execute\",\n        context,\n        () => this.runCore(),\n        this.logger,\n      )) as AgentResult<TOutput>;\n    } catch (thrown) {\n      this.error = this.toAIError(thrown);\n      result = this.buildResult();\n    }\n\n    if (result.error) {\n      this.emit(\"agent.error\", { error: result.error });\n    }\n\n    this.emit(\"agent.completed\", { result });\n\n    // Fire the `onComplete` hook with a flat payload (runId +\n    // durationMs pre-extracted) for audit-log consumers. Awaited but\n    // errors swallowed so consumer bugs cannot crash the agent or\n    // interfere with the result returned to the caller.\n    await this.fireCompleteHook(result);\n\n    this.streamController?.end(result);\n\n    return result;\n  }\n\n  /**\n   * Inner body wrapped by the `execute`-level pipeline. Drives the\n   * full lifecycle — build messages → emit starting → run trip loop\n   * → parse output → build result. Catches any unexpected throw and\n   * funnels it into `this.error` so the returned result is always\n   * well-formed; `execute`-level `after` hooks receive the result,\n   * with `error` populated when things went wrong.\n   */\n  private async runCore(): Promise<AgentResult<TOutput>> {\n    try {\n      await this.buildInitialMessages();\n\n      this.emit(\"agent.starting\", { input: this.input });\n\n      await this.runTripLoop();\n\n      const parseOutcome = await this.parseOutput();\n\n      if (parseOutcome === \"failed\" && this.options?.repair) {\n        await this.runRepairLoop();\n      }\n    } catch (thrown) {\n      this.error = this.toAIError(thrown);\n    }\n\n    return this.buildResult();\n  }\n\n  /**\n   * Resolve the system prompt (string or `SystemPromptContract`), merge\n   * placeholders from config + execute options, inject a structured-output\n   * instruction when the caller wants typed output but the model can't\n   * enforce it natively, prepend any conversation history, and append the\n   * user input. Produces the initial `messages` array the first trip sends\n   * to the model. Runs exactly once per execution.\n   */\n  private async buildInitialMessages(): Promise<void> {\n    const { messages, responseSchema } = await buildAgentInputMessages({\n      config: this.config,\n      input: this.input,\n      options: this.options,\n    });\n    this.messages.push(...messages);\n    this.responseSchema = responseSchema;\n  }\n\n  /**\n   * Drive sequential trips up to `maxTrips`. Each trip may stop the loop\n   * naturally (model returned a non-tool-call finish), abort it (model\n   * threw), or continue it (model requested tools). When the loop exits\n   * after the cap without a natural stop, records a \"Max trips exceeded\"\n   * error so the caller can distinguish runaway tool loops from a real result.\n   */\n  private async runTripLoop(): Promise<void> {\n    for (let tripIndex = 0; tripIndex < this.maxTrips; tripIndex++) {\n      if (this.options?.signal?.aborted) {\n        this.error = this.makeCancelledError();\n        return;\n      }\n\n      const tripInput = tripIndex === 0 ? this.input : \"[tool results]\";\n      const outcome = await this.runTrip(tripIndex, tripInput);\n\n      if (outcome === \"error\" || outcome === \"stop\") {\n        return;\n      }\n    }\n\n    const lastTrip = this.trips[this.trips.length - 1];\n\n    if (lastTrip?.finishReason === \"tool_calls\") {\n      this.error = new AgentMaxTripsError(\"Max trips exceeded\", {\n        maxTrips: this.maxTrips,\n      });\n    }\n  }\n\n  /**\n   * Execute one round-trip to the model. Aggregates usage into the running\n   * total, dispatches any requested tool calls, appends the assistant +\n   * tool-result messages for the next trip, and records an `LLMTrip`.\n   * Returns an outcome that tells `runTripLoop` whether to continue, stop,\n   * or abort.\n   */\n  private async runTrip(\n    tripIndex: number,\n    tripInput: string,\n  ): Promise<\"continue\" | \"stop\" | \"error\"> {\n    this.emit(\"agent.trip.started\", { tripIndex, input: tripInput });\n\n    const tripStartedAt = new Date();\n    const tripStart = performance.now();\n\n    let response: ModelResponse;\n\n    try {\n      response = await this.runTripThroughPipeline(tripIndex);\n    } catch (thrown) {\n      this.error = this.toAIError(thrown);\n\n      const failedTrip: LLMTrip = {\n        index: tripIndex,\n        input: tripInput,\n        output: \"\",\n        finishReason: \"error\",\n        startedAt: tripStartedAt.toISOString(),\n        endedAt: new Date().toISOString(),\n        duration: performance.now() - tripStart,\n        usage: { input: 0, output: 0, total: 0 },\n        error: this.error,\n      };\n\n      this.trips.push(failedTrip);\n\n      this.emit(\"agent.trip.completed\", { trip: failedTrip });\n      this.emit(\"agent.error\", { error: this.error });\n\n      return \"error\";\n    }\n\n    // Attach per-trip cost breakdown using the model's pricing table\n    // (when configured). Done at the framework boundary so stored trip\n    // records carry historical cost — Panoptic and other archive\n    // consumers never re-derive against today's pricing, and the\n    // input/output/cached split stays queryable without joining to a\n    // pricing table at all.\n    if (response.usage.cost === undefined) {\n      response.usage.cost = computeCost(response.usage, this.config.model.pricing);\n    }\n\n    this.usage.input += response.usage.input;\n    this.usage.output += response.usage.output;\n    this.usage.total += response.usage.total;\n    if (response.usage.cachedTokens !== undefined) {\n      this.usage.cachedTokens = (this.usage.cachedTokens ?? 0) + response.usage.cachedTokens;\n    }\n    this.usage.cost = accumulateCost(this.usage.cost, response.usage.cost);\n\n    // Fire the `onUsage` hook with a flat, pre-packaged payload so\n    // cost-ledger code receives stable identity (runId, model+provider)\n    // without joining from elsewhere. Awaited but errors swallowed.\n    await this.fireUsageHook(tripIndex, response.usage);\n\n    const isToolCallTrip =\n      response.finishReason === \"tool_calls\" &&\n      response.toolCalls !== undefined &&\n      response.toolCalls.length > 0;\n\n    const tripToolCalls: ToolCall[] = [];\n\n    if (isToolCallTrip) {\n      this.messages.push({\n        role: \"assistant\",\n        content: response.content,\n        toolCalls: response.toolCalls,\n      });\n\n      for (const toolCallRequest of response.toolCalls!) {\n        const record = await this.dispatchToolCall(toolCallRequest, tripIndex);\n\n        tripToolCalls.push(record);\n      }\n    }\n\n    const trip: LLMTrip = {\n      index: tripIndex,\n      input: tripInput,\n      output: response.content,\n      finishReason: response.finishReason,\n      startedAt: tripStartedAt.toISOString(),\n      endedAt: new Date().toISOString(),\n      duration: performance.now() - tripStart,\n      usage: response.usage,\n      toolCalls: tripToolCalls.length > 0 ? tripToolCalls : undefined,\n    };\n\n    this.trips.push(trip);\n\n    this.emit(\"agent.trip.completed\", { trip });\n\n    if (!isToolCallTrip) {\n      return \"stop\";\n    }\n\n    // Terminate the trip loop when EVERY tool call this trip is\n    // `mode: \"silent\"`. Silent tools don't feed their result back\n    // to the model — the prose the model streamed alongside the\n    // tool call IS the final reply. The \"all\" rule is load-bearing:\n    // if any feedback tool was called too, its result still needs\n    // to round-trip, so we must continue.\n    //\n    // Composite (`asTool`-wrapped) tools never set `mode: \"silent\"`\n    // in v1 — silent-composite mechanics are deferred per plan\n    // 2026-05-07-silent-tools.md (Q4). They behave as feedback.\n    const allSilent = response.toolCalls!.every((request) => {\n      const registered = this.config.tools?.find((tool) => tool.name === request.name);\n      return registered?.mode === \"silent\";\n    });\n\n    return allSilent ? \"stop\" : \"continue\";\n  }\n\n  /**\n   * Route `getModelResponse` through the `trip`-level middleware\n   * pipeline. `trip.before` hooks can short-circuit the trip by\n   * returning a synthetic `ModelResponse` (semantic cache hit).\n   * `trip.after` hooks can transform the response before the trip\n   * record is built or any tool calls are dispatched. `trip.onError`\n   * hooks can recover from provider failures (fallback chain).\n   */\n  private async runTripThroughPipeline(tripIndex: number): Promise<ModelResponse> {\n    const context: MiddlewareTripContext = {\n      ...this.buildExecuteContext(),\n      tripIndex,\n      messages: this.messages,\n    };\n\n    return (await runPipeline(\n      this.middleware,\n      \"trip\",\n      context,\n      () => this.getModelResponse(tripIndex),\n      this.logger,\n    )) as ModelResponse;\n  }\n\n  /**\n   * Produce the `ModelResponse` for the current trip. In non-streaming\n   * mode, delegates straight to `model.complete()`. In streaming mode,\n   * drains `model.stream()` while emitting `streaming` events per delta\n   * and accumulates the chunks into the same `ModelResponse` shape, so the\n   * rest of the trip pipeline (tool dispatch, trip record, usage\n   * aggregation) stays identical between the two modes.\n   */\n  private async getModelResponse(tripIndex: number): Promise<ModelResponse> {\n    const callOptions = {\n      ...this.config.modelOptions,\n      tools: this.config.tools ?? [],\n      ...(this.responseSchema ? { responseSchema: this.responseSchema } : {}),\n      ...(this.options?.signal ? { signal: this.options.signal } : {}),\n    };\n\n    if (!this.streamController) {\n      return this.config.model.complete(this.messages, callOptions);\n    }\n\n    let content = \"\";\n    let finishReason: FinishReason = \"stop\";\n    let usage: Usage = { input: 0, output: 0, total: 0 };\n    const toolCalls: ModelToolCallRequest[] = [];\n    const recoveredCalls: ModelToolCallRequest[] = [];\n\n    const guardConfig = this.resolveStreamingToolGuard();\n    const guard = guardConfig\n      ? new JsonStreamGuard({\n          tools: (this.config.tools ?? []) as ReadonlyArray<ToolContract<unknown, unknown>>,\n          maxBufferBytes: guardConfig.maxBufferBytes,\n          onSafeDelta: (delta) => {\n            content += delta;\n\n            this.emit(\"agent.trip.streaming\", { delta, tripIndex });\n          },\n          onRecoveredCall: (request) => {\n            recoveredCalls.push(request);\n          },\n        })\n      : undefined;\n\n    for await (const chunk of this.config.model.stream(this.messages, callOptions)) {\n      // Mid-stream abort — break out cleanly instead of continuing to\n      // consume the iterator. The underlying fetch is already\n      // cancelled via `signal` forwarded in callOptions; this covers\n      // adapters that don't honor signal natively and keeps mock\n      // models consistent under cancellation tests.\n      if (this.options?.signal?.aborted) {\n        throw this.makeCancelledError();\n      }\n\n      if (chunk.type === \"delta\") {\n        if (guard) {\n          await guard.feed(chunk.content);\n        } else {\n          content += chunk.content;\n\n          this.emit(\"agent.trip.streaming\", { delta: chunk.content, tripIndex });\n        }\n\n        continue;\n      }\n\n      if (chunk.type === \"tool-call\") {\n        toolCalls.push({\n          id: chunk.id,\n          name: chunk.name,\n          input: chunk.input,\n          ...(chunk.providerMetadata ? { providerMetadata: chunk.providerMetadata } : {}),\n        });\n\n        continue;\n      }\n\n      finishReason = chunk.finishReason;\n      usage = chunk.usage;\n    }\n\n    if (guard) {\n      await guard.finalize();\n    }\n\n    // Dedupe synthesized calls against real ones the provider streamed\n    // structurally — the model occasionally emits BOTH channels for\n    // the same call (real tool-call chunk + narrated JSON envelope).\n    // Real wins; the synthesized duplicate is dropped so dispatch\n    // doesn't run twice. See plan 2026-05-22 §Q5.\n    const dedupedRecovered = recoveredCalls.filter(\n      (recovered) => !isDuplicateToolCall(recovered, toolCalls),\n    );\n\n    const mergedToolCalls = [...toolCalls, ...dedupedRecovered];\n\n    // When the guard recovered any calls but the model reported a\n    // natural `\"stop\"`, override to `\"tool_calls\"` so the agent's\n    // dispatch loop (`runTrip` → `isToolCallTrip`) actually fires.\n    // Without this the guard silently suppresses the leaked JSON but\n    // never dispatches the real action — chips never render.\n    const resolvedFinishReason: FinishReason =\n      dedupedRecovered.length > 0 && finishReason === \"stop\" ? \"tool_calls\" : finishReason;\n\n    return {\n      content,\n      finishReason: resolvedFinishReason,\n      usage,\n      toolCalls: mergedToolCalls.length > 0 ? mergedToolCalls : undefined,\n    };\n  }\n\n  /**\n   * Resolve the effective `streamingToolGuard` for this trip.\n   * Per-call options win over the agent-level config when the key is\n   * explicitly present on options (including the explicit `undefined`\n   * \"disable for this call\" form). Returns `undefined` when no guard\n   * should run.\n   */\n  private resolveStreamingToolGuard(): StreamingToolGuardConfig | undefined {\n    if (\n      this.options !== undefined &&\n      Object.prototype.hasOwnProperty.call(this.options, \"streamingToolGuard\")\n    ) {\n      return this.options.streamingToolGuard;\n    }\n\n    return this.config.streamingToolGuard;\n  }\n\n  /**\n   * Dispatch a single tool call requested by the model. Looks up the tool\n   * by name, invokes it via the safe `ToolContract.invoke` entry, pushes a\n   * matching tool-result message into `this.messages` so the next trip can\n   * see it, and emits the right lifecycle event (`tool-called` on success,\n   * `tool-calling-failed` when the tool is unregistered or invoke returned\n   * an error). Never throws — always returns a `ToolCall` record.\n   */\n  private async dispatchToolCall(\n    toolCallRequest: ModelToolCallRequest,\n    tripIndex: number,\n  ): Promise<ToolCall> {\n    const registeredTool = this.config.tools?.find((tool) => tool.name === toolCallRequest.name);\n\n    if (!registeredTool) {\n      const error = new AgentExecutionError(`Tool not registered: ${toolCallRequest.name}`, {\n        context: { toolName: toolCallRequest.name, tripIndex },\n      });\n\n      const nowIso = new Date().toISOString();\n\n      const record: ToolCall = {\n        runId: generateRunId(\"tool\"),\n        rootRunId: this.runId,\n        name: toolCallRequest.name,\n        type: \"tool\",\n        status: \"failed\",\n        startedAt: nowIso,\n        endedAt: nowIso,\n        duration: 0,\n        usage: { input: 0, output: 0, total: 0 },\n        children: [],\n        tripIndex,\n        input: toolCallRequest.input,\n        error,\n        ...(toolCallRequest.recoveredFrom ? { recoveredFrom: toolCallRequest.recoveredFrom } : {}),\n      };\n\n      this.toolCalls.push(record);\n\n      this.messages.push({\n        role: \"tool\",\n        toolCallId: toolCallRequest.id,\n        content: JSON.stringify({ error: error.message }),\n      });\n\n      // Stub meta — there's no real tool to describe. Carries the\n      // requested name for log correlation and an explanatory\n      // description so consumers don't see an empty string.\n      this.emit(\"agent.tool.failed\", {\n        tool: {\n          name: toolCallRequest.name,\n          description: \"(unregistered tool — no description available)\",\n        },\n        input: toolCallRequest.input,\n        error,\n        tripIndex,\n      });\n\n      return record;\n    }\n\n    // Build the lightweight event meta once. Resolves `action` to a\n    // string here so consumers receive plain data rather than having\n    // to re-evaluate a callback on every event.\n    const toolMeta: ToolEventMeta = {\n      name: registeredTool.name,\n      description: registeredTool.description,\n      action: resolveToolAction(registeredTool, toolCallRequest.input),\n    };\n\n    this.emit(\"agent.tool.calling\", {\n      tool: toolMeta,\n      input: toolCallRequest.input,\n      tripIndex,\n    });\n\n    const toolContext: MiddlewareToolContext = {\n      ...this.buildExecuteContext(),\n      tripIndex,\n      messages: this.messages,\n      tool: {\n        name: registeredTool.name,\n        description: registeredTool.description,\n        mode: registeredTool.mode,\n      },\n      request: toolCallRequest,\n    };\n\n    let invokeResult: ToolInvokeResult<unknown>;\n\n    try {\n      invokeResult = (await runPipeline(\n        this.middleware,\n        \"tool\",\n        toolContext,\n        () => registeredTool.invoke(toolCallRequest.input, this.options?.toolCtx),\n        this.logger,\n      )) as ToolInvokeResult<unknown>;\n    } catch (thrown) {\n      // A `tool`-level middleware hook threw. The real invoke never\n      // throws (it funnels errors into `result.error`), so only a\n      // middleware abort or a bug reaches this branch. Synthesize a\n      // failed-invoke record so the tool-call trace stays consistent.\n      const error = this.toAIError(thrown);\n      const nowIso = new Date().toISOString();\n      const emptyUsage: Usage = { input: 0, output: 0, total: 0 };\n\n      const failedRunId = generateRunId(\"tool\");\n      invokeResult = {\n        error,\n        usage: emptyUsage,\n        report: {\n          runId: failedRunId,\n          rootRunId: failedRunId,\n          name: registeredTool.name,\n          version: registeredTool.version,\n          type: \"tool\",\n          status: \"failed\",\n          startedAt: nowIso,\n          endedAt: nowIso,\n          duration: 0,\n          usage: emptyUsage,\n          children: [],\n        },\n      };\n    }\n\n    // The agent-level ToolCall record merges the tool's own invocation\n    // report with agent-side enrichments (tripIndex, input, output,\n    // error). When the underlying tool was an `asTool`-wrapped\n    // composite, its inner report becomes the sole child of this\n    // ToolCall — preserving the full nested tree while keeping this\n    // node's own `type` as `\"tool\"` (from the agent's POV it *was* a\n    // tool dispatch).\n    const innerReport = invokeResult.report;\n    const isComposite = innerReport.type !== \"tool\";\n\n    const record: ToolCall = {\n      runId: innerReport.runId,\n      rootRunId: this.runId,\n      name: toolCallRequest.name,\n      version: registeredTool.version,\n      type: \"tool\",\n      status: innerReport.status,\n      startedAt: innerReport.startedAt,\n      endedAt: innerReport.endedAt,\n      duration: innerReport.duration,\n      usage: invokeResult.usage,\n      children: isComposite ? [innerReport] : innerReport.children,\n      tripIndex,\n      input: toolCallRequest.input,\n      output: invokeResult.data,\n      error: invokeResult.error,\n      ...(toolCallRequest.recoveredFrom ? { recoveredFrom: toolCallRequest.recoveredFrom } : {}),\n    };\n\n    this.toolCalls.push(record);\n\n    // Roll child usage into the agent's accumulator. Leaf tools\n    // contribute zero; `asTool`-wrapped composites contribute the\n    // full cost of the inner agent/workflow/supervisor run.\n    this.usage.input += invokeResult.usage.input;\n    this.usage.output += invokeResult.usage.output;\n    this.usage.total += invokeResult.usage.total;\n    this.usage.cost = accumulateCost(this.usage.cost, invokeResult.usage.cost);\n\n    this.messages.push({\n      role: \"tool\",\n      toolCallId: toolCallRequest.id,\n      content: invokeResult.error\n        ? JSON.stringify({ error: invokeResult.error.message })\n        : JSON.stringify(invokeResult.data ?? null),\n    });\n\n    if (invokeResult.error) {\n      this.emit(\"agent.tool.failed\", {\n        tool: toolMeta,\n        input: toolCallRequest.input,\n        error: invokeResult.error,\n        tripIndex,\n      });\n    } else {\n      this.emit(\"agent.tool.called\", { ...record, tool: toolMeta });\n    }\n\n    return record;\n  }\n\n  /**\n   * Parse the final trip output against the user-supplied schema (if any).\n   * Failures populate `this.error` but never throw. Returns an outcome the\n   * caller uses to decide whether self-repair is worth attempting:\n   *\n   * - `\"skipped\"` — no schema, or a prior trip-level error already set\n   *   `this.error` (model crash, max trips). Not repairable; the failure\n   *   isn't a parse problem the model can fix by re-asking.\n   * - `\"failed\"` — schema present, output text either failed JSON.parse\n   *   or failed `~standard.validate`. Repairable via `runRepairLoop`.\n   * - `\"success\"` — parsed and validated; `this.data` populated.\n   */\n  private async parseOutput(): Promise<\"success\" | \"failed\" | \"skipped\"> {\n    const schema = this.options?.output ?? this.config.output;\n\n    if (!schema || this.error) {\n      return \"skipped\";\n    }\n\n    const finalTrip = this.trips[this.trips.length - 1];\n    const text = finalTrip?.output ?? \"\";\n\n    if (!text) {\n      return \"skipped\";\n    }\n\n    const payload = extractJsonPayload(text);\n    const sentinel = Symbol(\"parse-failed\");\n    const parsed = safeJsonParse<unknown>(payload, sentinel);\n\n    if (parsed === sentinel) {\n      this.error = new SchemaValidationError(\"Failed to parse model output as JSON\", {\n        context: { text },\n      });\n      return \"failed\";\n    }\n\n    const validation = await (schema as StandardSchemaV1<TOutput>)[\"~standard\"].validate(parsed);\n\n    if (validation.issues) {\n      const summary = validation.issues.map((issue) => issue.message).join(\"; \");\n      this.error = new SchemaValidationError(summary, {\n        issues: validation.issues,\n      });\n      return \"failed\";\n    }\n\n    this.data = validation.value;\n    return \"success\";\n  }\n\n  /**\n   * Opt-in self-repair loop for `output` schema failures. Triggered only\n   * when `options.repair` is set and `parseOutput()` returned `\"failed\"`.\n   *\n   * Each attempt:\n   * 1. Pushes the bad assistant response into `this.messages` (so the\n   *    model can see what it just produced).\n   * 2. Pushes a corrective user message naming the validation/parse error.\n   * 3. Runs another trip — counted against the same `maxTrips` cap as\n   *    normal trips so a stuck model can't loop forever.\n   * 4. Re-parses. Stops on success, on a trip-level error, or when\n   *    either `maxAttempts` or `maxTrips` is exhausted.\n   *\n   * Resets `this.error` and `this.data` before each attempt so the final\n   * outcome (success or last failure) is what surfaces to the caller.\n   */\n  private async runRepairLoop(): Promise<void> {\n    const maxAttempts = this.options?.repair?.maxAttempts ?? 1;\n\n    for (let attempt = 0; attempt < maxAttempts; attempt++) {\n      if (this.trips.length >= this.maxTrips) {\n        return;\n      }\n\n      const lastTrip = this.trips[this.trips.length - 1];\n      const badResponse = lastTrip?.output ?? \"\";\n      const failureReason = this.error?.message ?? \"unknown validation failure\";\n\n      this.error = undefined;\n      this.data = undefined;\n\n      this.messages.push({ role: \"assistant\", content: badResponse });\n\n      this.messages.push({\n        role: \"user\",\n        content: [\n          `Your previous response failed validation: ${failureReason}.`,\n          \"Respond again with valid JSON only — no prose, no markdown fences, no commentary.\",\n        ].join(\" \"),\n      });\n\n      const tripIndex = this.trips.length;\n\n      this.logger.warn(LOG_MODULE, \"repair.attempting\", \"retrying after validation failure\", {\n        attempt: attempt + 1,\n        maxAttempts,\n        reason: failureReason,\n      });\n\n      const outcome = await this.runTrip(tripIndex, \"[repair attempt]\");\n\n      if (outcome === \"error\") {\n        return;\n      }\n\n      const parseOutcome = await this.parseOutput();\n\n      if (parseOutcome === \"success\") {\n        return;\n      }\n    }\n  }\n\n  /**\n   * Build the final `AgentResult` snapshot from accumulated state\n   * (trips, tool calls, data/error, usage, timing).\n   *\n   * Pure — no side effects. `run()` owns terminal event emission and\n   * stream closure so the post-pipeline result (possibly transformed\n   * or short-circuited by an `execute`-level middleware) is what\n   * flows out to consumers and listeners.\n   *\n   * Trips, tool calls, status, and timing live under `report` so the\n   * root stays focused on the four things callers reach for most:\n   * `data`, `text`, `usage`, `error`.\n   */\n  private buildResult(): AgentResult<TOutput> {\n    const finalTrip = this.trips[this.trips.length - 1];\n    const endedAt = new Date();\n\n    const agentName = this.config.name ?? this.config.model.name;\n    const status: BaseReport[\"status\"] = this.error\n      ? this.error instanceof AgentCancelledError\n        ? \"cancelled\"\n        : \"failed\"\n      : \"completed\";\n\n    const report = {\n      runId: this.runId,\n      rootRunId: this.runId,\n      name: agentName,\n      version: this.config.version,\n      type: \"agent\" as const,\n      status,\n      startedAt: this.startedAt.toISOString(),\n      endedAt: endedAt.toISOString(),\n      duration: performance.now() - this.start,\n      usage: this.usage,\n      children: this.toolCalls,\n      model: {\n        name: this.config.model.name,\n        provider: this.config.model.provider,\n      },\n      trips: this.trips,\n    };\n\n    // Stamp lineage on the assembled tree exactly once per run.\n    // Rewrites any inner self-roots from composite children to this\n    // run's id, stamps `reportSchemaVersion` on the root, and\n    // propagates `sessionId` to every node.\n    stampReportLineage(report, {\n      rootRunId: this.runId,\n      sessionId: this.options?.sessionId,\n    });\n\n    return {\n      type: \"agent\",\n      data: this.data,\n      text: finalTrip?.output,\n      report,\n      usage: this.usage,\n      error: this.error,\n    };\n  }\n\n  /**\n   * Normalize any thrown value into an `AIError`. `AIError` instances\n   * pass through untouched; provider-adapter SDK errors are caught by\n   * the adapter and already arrive typed, so this branch mainly\n   * handles runtime crashes (TypeError, ReferenceError) inside\n   * model.complete / model.stream and non-Error values (`throw \"bad\"`).\n   */\n  private toAIError(thrown: unknown): AIError {\n    if (thrown instanceof AIError) {\n      return thrown;\n    }\n\n    // Classify abort-flavored errors (DOMException \"AbortError\",\n    // node-fetch's `FetchError` with name \"AbortError\", `ERR_CANCELED`\n    // from the OpenAI SDK's axios-ish layer) as cancelled instead of\n    // a generic exec failure so callers can route retries correctly.\n    if (isAbortLike(thrown)) {\n      return this.makeCancelledError();\n    }\n\n    const message = thrown instanceof Error ? thrown.message : String(thrown);\n\n    return new AgentExecutionError(message, { cause: thrown });\n  }\n\n  /**\n   * Build the typed cancelled error that both the trip-loop guard\n   * and the mid-stream guard emit. Captures the abort reason when\n   * one was supplied to `controller.abort(reason)` so logs and\n   * telemetry can see what cancelled the run.\n   */\n  private makeCancelledError(): AgentCancelledError {\n    const reason = this.options?.signal?.reason;\n    const reasonText = reason === undefined ? \"\" : String(reason);\n\n    return new AgentCancelledError(\"agent execution cancelled\", {\n      cause: reason,\n      cancelledAt: new Date().toISOString(),\n      reason: reasonText,\n    });\n  }\n\n  /**\n   * Fire a single event through all three subscription tiers in order\n   * — factory → instance → per-call — and mirror it into the\n   * `StreamController` when streaming is active. A throwing user\n   * handler must never crash the agent, so every dispatch is wrapped\n   * in `safeCall`. Stream events are converted from the internal\n   * `AgentEventMap` payload to the public `StreamEvent` shape because\n   * some of them differ (e.g. the tool-called payload vs stream\n   * event).\n   */\n  private emit<K extends keyof AgentEventMap>(\n    event: K,\n    payload: WithoutIdentity<AgentEventMap[K]>,\n  ): void {\n    // Inject run identity once, here, so every subscription tier and\n    // the stream see it. `rootRunId === runId` for a standalone run;\n    // nested propagation lands in a follow-up.\n    const fullPayload = {\n      ...payload,\n      runId: this.runId,\n      rootRunId: this.runId,\n    } as AgentEventMap[K];\n\n    this.logEvent(event, fullPayload);\n\n    const factoryHandler = this.config.on?.[event] as AgentEventHandler<K> | undefined;\n\n    if (factoryHandler) {\n      safeCall(factoryHandler, fullPayload);\n    }\n\n    const bucket = this.instanceHandlers?.get(event);\n\n    if (bucket) {\n      for (const handler of bucket) {\n        safeCall(handler as AgentEventHandler<K>, fullPayload);\n      }\n    }\n\n    const perCallHandler = this.options?.on?.[event] as AgentEventHandler<K> | undefined;\n\n    if (perCallHandler) {\n      safeCall(perCallHandler, fullPayload);\n    }\n\n    if (this.streamController) {\n      const body = this.toStreamEvent(event, fullPayload);\n\n      if (body) {\n        this.streamController.push({\n          runId: this.runId,\n          rootRunId: this.runId,\n          ...body,\n        });\n      }\n    }\n  }\n\n  /**\n   * Emit a structured log line for a lifecycle event. The action\n   * string mirrors the event name with the `agent.` prefix stripped\n   * (`agent.trip.started` → `trip.started`) so log grep filters and\n   * event handlers read the same vocabulary. Level mapping follows\n   * the convention documented on `@warlock.js/logger`'s `Logger`.\n   */\n  private logEvent<K extends keyof AgentEventMap>(event: K, payload: AgentEventMap[K]): void {\n    const agentName = this.config.name || this.config.model.name;\n    logAgentEvent(\n      this.logger,\n      {\n        module: `${LOG_MODULE}.${agentName}`,\n        maxTrips: this.maxTrips,\n        modelName: this.config.model.name,\n        totalUsage: this.usage,\n        totalDurationMs: performance.now() - this.start,\n        trips: this.trips,\n        toolCalls: this.toolCalls,\n      },\n      event,\n      payload,\n    );\n  }\n\n  private toStreamEvent<K extends keyof AgentEventMap>(\n    event: K,\n    payload: AgentEventMap[K],\n  ): StreamEventBody | undefined {\n    return agentEventToStreamEvent(event, payload);\n  }\n\n  /**\n   * Invoke the `onUsage` hook (when configured) with a flat payload\n   * carrying stable identity. Awaits the handler so async ledger\n   * writes complete before the next trip starts; swallows any throw\n   * so consumer bugs cannot crash the agent. Sync handlers wrapped\n   * via `Promise.resolve()` so the await is safe in either case.\n   */\n  private async fireUsageHook(tripIndex: number, tripUsage: Usage): Promise<void> {\n    const handler = this.config.onUsage;\n    if (!handler) return;\n\n    const event: UsageEvent = {\n      runId: this.runId,\n      tripIndex,\n      model: {\n        name: this.config.model.name,\n        provider: this.config.model.provider,\n      },\n      usage: { ...tripUsage },\n      timestamp: new Date().toISOString(),\n    };\n\n    try {\n      await Promise.resolve(handler(event));\n    } catch (err) {\n      this.logger.warn(LOG_MODULE, \"onUsage.hook.error\", \"onUsage handler threw\", {\n        runId: this.runId,\n        tripIndex,\n        error: err instanceof Error ? err.message : String(err),\n      });\n    }\n  }\n\n  /**\n   * Invoke the `onComplete` hook (when configured) once at the end\n   * of every run. Receives the full `AgentResult` plus pre-extracted\n   * `runId` and `durationMs`. Same swallow-and-log error policy as\n   * `fireUsageHook`.\n   */\n  private async fireCompleteHook(result: AgentResult<TOutput>): Promise<void> {\n    const handler = this.config.onComplete;\n    if (!handler) return;\n\n    const event: CompleteEvent<TOutput> = {\n      result,\n      runId: this.runId,\n      durationMs: performance.now() - this.start,\n    };\n\n    try {\n      await Promise.resolve(handler(event));\n    } catch (err) {\n      this.logger.warn(LOG_MODULE, \"onComplete.hook.error\", \"onComplete handler threw\", {\n        runId: this.runId,\n        error: err instanceof Error ? err.message : String(err),\n      });\n    }\n  }\n}\n\n/**\n * Decide whether a guard-synthesized tool call duplicates a real one\n * the provider already streamed structurally. Match key is\n * `name + key-sorted JSON of input` so identical calls (regardless of\n * argument key order) collapse, but two legitimate calls to the same\n * tool with different inputs still both dispatch.\n */\nfunction isDuplicateToolCall(\n  recovered: ModelToolCallRequest,\n  realCalls: ReadonlyArray<ModelToolCallRequest>,\n): boolean {\n  const recoveredKey = `${recovered.name}|${stableStringify(recovered.input)}`;\n\n  for (const real of realCalls) {\n    const realKey = `${real.name}|${stableStringify(real.input)}`;\n\n    if (realKey === recoveredKey) {\n      return true;\n    }\n  }\n\n  return false;\n}\n\n/**\n * `JSON.stringify` variant that sorts object keys at every nesting\n * level so structurally-equal inputs serialize to identical strings.\n * Used only for dedupe-key comparison; never surfaces to consumers.\n */\nfunction stableStringify(value: unknown): string {\n  return JSON.stringify(value, (_key, val) => {\n    if (val !== null && typeof val === \"object\" && !Array.isArray(val)) {\n      const source = val as Record<string, unknown>;\n      const sorted: Record<string, unknown> = {};\n\n      for (const key of Object.keys(source).sort()) {\n        sorted[key] = source[key];\n      }\n\n      return sorted;\n    }\n\n    return val;\n  });\n}\n\n/**\n * Invoke a user-supplied event handler without letting exceptions\n * escape the agent. Thrown errors are swallowed — structured logging\n * attaches here in Phase 0.5 so operators still see the failure.\n */\nfunction safeCall<T>(handler: (payload: T) => void, payload: T): void {\n  try {\n    handler(payload);\n  } catch {\n    // Intentionally swallowed — user handlers never crash the agent.\n  }\n}\n\n/**\n * Resolve a tool's `action` declaration into a plain string for\n * inclusion in `ToolEventMeta`. Static strings pass through;\n * function-shaped actions are invoked with the validated input.\n *\n * Defensive: if the user's callback throws, swallow and return\n * `undefined` rather than crashing the agent — UI strings are not\n * worth aborting an LLM dispatch over.\n */\nfunction resolveToolAction(\n  tool: ToolContract<unknown, unknown>,\n  input: unknown,\n): string | undefined {\n  if (tool.action === undefined) return undefined;\n  if (typeof tool.action === \"string\") return tool.action;\n  try {\n    return tool.action(input);\n  } catch {\n    return undefined;\n  }\n}\n","import type { StandardSchemaV1 } from \"@standard-schema/spec\";\nimport type { BaseReport } from \"../contracts/result/base-report.type\";\nimport type { Usage } from \"../contracts/result/usage.type\";\nimport type { ToolConfig, ToolContext } from \"../contracts/tool.contract\";\nimport { AIError, SchemaValidationError, ToolExecutionError } from \"../errors\";\nimport { generateRunId } from \"../utils/generate-run-id\";\n\n/**\n * Degraded `ToolContext` supplied when no caller threads one through\n * (`tool.invoke(input)` standalone, batch scripts, tests). Per\n * decisions §35 — mutations on the empty bag are harmless no-ops;\n * production paths under a supervisor receive a real ctx with the\n * iteration's shared bag.\n */\nfunction defaultToolContext(): ToolContext {\n  return { artifacts: {} };\n}\n\nconst EMPTY_USAGE: Usage = Object.freeze({ input: 0, output: 0, total: 0 });\n\n/**\n * Result returned by `ToolContract.invoke()`.\n *\n * **Canonical destructure:** `const { data, usage, report, error }` —\n * matches every other executable (`AgentResult`, `WorkflowResult`,\n * `SupervisorResult`) so parent agents can treat every tool dispatch\n * uniformly.\n *\n * **Shape.** `data` / `error` carry the outcome; `usage` and `report`\n * are always present. For leaf tools, `usage` is zero and `report`\n * is a framework-synthesized {@link BaseReport} (`type: \"tool\"`,\n * `children: []`, real timing) so parents never have to nil-check.\n * For composites wrapped via `asTool()`, `usage` and `report` mirror\n * the inner primitive's — the nested tree lives in `report.children`.\n *\n * @example\n * const result = await myTool.invoke({ city: \"Cairo\" });\n * if (result.error) console.error(result.error.message);\n * else console.log(result.data, result.report.duration);\n */\nexport type ToolInvokeResult<TOutput> = {\n  /** Successfully-returned output. Undefined if execution or validation failed. */\n  data?: TOutput;\n  /** Typed AI error produced by validation or execute(), if any. */\n  error?: AIError;\n  /** Rolled-up usage (zero for leaf tools, populated for composites). */\n  usage: Usage;\n  /** Recursive execution report — `report.children` carries nested executables. */\n  report: BaseReport;\n};\n\n/**\n * A `ToolConfig` augmented with a safe `invoke()` entry point for the agent runtime.\n *\n * @example\n * const wrapped: ToolContract<{ city: string }, { temp: number }> = tool(contract);\n * const result = await wrapped.invoke({ city: \"Cairo\" });\n */\nexport interface ToolContract<TInput = unknown, TOutput = unknown> extends ToolConfig<\n  TInput,\n  TOutput\n> {\n  /**\n   * Agent-runtime entry point. Validates raw input against the tool's schema,\n   * calls execute(), catches errors, and reports duration.\n   * Never throws — errors surface in the returned `error` field as\n   * typed `AIError` subclasses.\n   *\n   * The optional second argument is a `ToolContext` (Phase 5 /\n   * decisions §35) — when supplied, threaded into `execute(input, ctx)`\n   * so tools can write system-only side data into `ctx.artifacts`.\n   * Standalone callers may omit it; the framework supplies a\n   * degraded `{ artifacts: {} }` so single-arg legacy handlers keep\n   * working unchanged.\n   *\n   * @example\n   * const result = await myTool.invoke(rawLLMArgs);\n   * if (result.error) handleError(result.error);\n   */\n  invoke(rawInput: unknown, ctx?: ToolContext): Promise<ToolInvokeResult<TOutput>>;\n}\n\n/**\n * Wraps a raw `ToolConfig` and adds a safe `invoke()` method for the agent runtime.\n * The returned object preserves all original contract fields unchanged.\n *\n * Error categorization:\n * - Input schema rejects model args → `SchemaValidationError` (issues preserved).\n * - Schema's `validate()` itself throws → `SchemaValidationError` wrapping the cause.\n * - `execute()` throws → `ToolExecutionError` wrapping the cause.\n *\n * @example\n * const weatherTool = tool({\n *   name: \"getWeather\",\n *   description: \"Fetch current weather for a city\",\n *   input: z.object({ city: z.string() }),\n *   execute: async ({ city }) => ({ temp: 72 }),\n * });\n *\n * const result = await weatherTool.invoke({ city: \"Cairo\" });\n */\n/**\n * Internal factory for `asTool()` wrappers on composite primitives\n * (agent / workflow / supervisor). Unlike the public `tool()` factory\n * (which synthesizes a leaf `BaseReport` every time), this variant\n * lets the composite's own `ExecuteResult` flow through: the inner\n * primitive's `report` becomes the sole child of the outer tool-call\n * node, and the inner `usage` is surfaced so parents can roll it up.\n *\n * The caller supplies `execute()` returning `{ data, usage, report }`\n * from the composite's own `execute()` method. Validation failures\n * and thrown errors still produce a synthesized failed leaf report —\n * the inner-report propagation is strictly a success-path concern.\n *\n * Not exported from the package barrel — used by `agent.asTool()`,\n * `workflow.asTool()`, `supervisor.asTool()` only.\n */\nexport function compositeAsTool<TInput, TOutput>(contract: {\n  name: string;\n  description?: string;\n  version?: string;\n  meta?: ToolConfig[\"meta\"];\n  input: StandardSchemaV1<TInput>;\n  /** Runs the underlying composite and returns its full envelope. */\n  execute: (input: TInput) => Promise<{\n    data?: TOutput;\n    error?: AIError;\n    usage: Usage;\n    report: BaseReport;\n  }>;\n}): ToolContract<TInput, TOutput> {\n  // The underlying `ToolConfig<TInput, TOutput>.execute` is typed as\n  // `(input) => Promise<TOutput>`, but composite wrappers return an\n  // envelope object instead. Surface a contract-shaped view that\n  // extracts `.data` on demand for any code that still treats this\n  // like a plain tool.\n  const publicExecute = async (input: TInput): Promise<TOutput> => {\n    const envelope = await contract.execute(input);\n    if (envelope.error) throw envelope.error;\n    return envelope.data as TOutput;\n  };\n\n  return {\n    name: contract.name,\n    description: contract.description ?? `Composite tool \"${contract.name}\".`,\n    meta: contract.meta,\n    input: contract.input,\n    execute: publicExecute,\n\n    async invoke(rawInput: unknown, _ctx?: ToolContext): Promise<ToolInvokeResult<TOutput>> {\n      // Composite tools (asTool-wrapped agent/workflow/supervisor) do\n      // NOT relay the ctx into their inner execution — composites\n      // have their own state/scope; an inner supervisor gets a fresh\n      // artifacts bag. The parameter is accepted for signature parity\n      // with `tool()` so callers can use both interchangeably.\n      const startedAtDate = new Date();\n      const start = performance.now();\n      const runId = generateRunId(\"tool\");\n\n      const failLeaf = (error: AIError): ToolInvokeResult<TOutput> => {\n        const endedAt = new Date().toISOString();\n        const duration = performance.now() - start;\n        return {\n          error,\n          usage: EMPTY_USAGE,\n          report: {\n            runId,\n            rootRunId: runId,\n            name: contract.name,\n            version: contract.version,\n            type: \"tool\",\n            status: \"failed\",\n            startedAt: startedAtDate.toISOString(),\n            endedAt,\n            duration,\n            usage: EMPTY_USAGE,\n            children: [],\n          },\n        };\n      };\n\n      let validationResult: StandardSchemaV1.Result<TInput>;\n      try {\n        const schema = contract.input as StandardSchemaV1<TInput>;\n        validationResult = await schema[\"~standard\"].validate(rawInput);\n      } catch (thrown) {\n        const message = thrown instanceof Error ? thrown.message : String(thrown);\n        return failLeaf(\n          new SchemaValidationError(\n            `Schema validation threw for tool \"${contract.name}\": ${message}`,\n            { cause: thrown, context: { toolName: contract.name } },\n          ),\n        );\n      }\n\n      if (validationResult.issues) {\n        const summary = validationResult.issues.map((issue) => issue.message).join(\"; \");\n        return failLeaf(\n          new SchemaValidationError(`Validation failed: ${summary}`, {\n            issues: validationResult.issues,\n            context: { toolName: contract.name },\n          }),\n        );\n      }\n\n      try {\n        const composite = await contract.execute(validationResult.value);\n        // Surface the inner primitive's full envelope. The outer\n        // ToolInvokeResult carries the composite's usage and report\n        // verbatim; the agent runtime nests the report as a child of\n        // the tool-dispatch node it records.\n        return {\n          data: composite.data,\n          error: composite.error,\n          usage: composite.usage,\n          report: composite.report,\n        };\n      } catch (thrown) {\n        const message = thrown instanceof Error ? thrown.message : String(thrown);\n        return failLeaf(\n          new ToolExecutionError(message, {\n            cause: thrown,\n            toolName: contract.name,\n          }),\n        );\n      }\n    },\n  };\n}\n\nexport function tool<TInput, TOutput>(\n  contract: ToolConfig<TInput, TOutput>,\n): ToolContract<TInput, TOutput> {\n  return {\n    ...contract,\n\n    async invoke(rawInput: unknown, ctx?: ToolContext): Promise<ToolInvokeResult<TOutput>> {\n      const startedAtDate = new Date();\n      const start = performance.now();\n      const runId = generateRunId(\"tool\");\n      const handlerCtx = ctx ?? defaultToolContext();\n\n      const finish = (partial: { data?: TOutput; error?: AIError }): ToolInvokeResult<TOutput> => {\n        const endedAt = new Date().toISOString();\n        const duration = performance.now() - start;\n        const status: BaseReport[\"status\"] = partial.error ? \"failed\" : \"completed\";\n        const report: BaseReport = {\n          runId,\n          rootRunId: runId,\n          name: contract.name,\n          version: contract.version,\n          type: \"tool\",\n          status,\n          startedAt: startedAtDate.toISOString(),\n          endedAt,\n          duration,\n          usage: EMPTY_USAGE,\n          children: [],\n        };\n\n        return {\n          ...partial,\n          usage: EMPTY_USAGE,\n          report,\n        };\n      };\n\n      let validationResult: StandardSchemaV1.Result<TInput>;\n      if (contract.input) {\n        try {\n          validationResult = await contract.input[\"~standard\"].validate(rawInput);\n        } catch (thrown) {\n          const message = thrown instanceof Error ? thrown.message : String(thrown);\n\n          return finish({\n            error: new SchemaValidationError(\n              `Schema validation threw for tool \"${contract.name}\": ${message}`,\n              { cause: thrown, context: { toolName: contract.name } },\n            ),\n          });\n        }\n      } else {\n        // `input` is optional on ToolConfig — this is a no-argument tool\n        // (e.g. view_cart, checkout). With no schema there is nothing to\n        // validate, so pass the raw model args straight to execute()\n        // instead of dereferencing a missing schema's `~standard`.\n        validationResult = { value: rawInput as TInput };\n      }\n\n      if (validationResult.issues) {\n        const summary = validationResult.issues.map((issue) => issue.message).join(\"; \");\n\n        return finish({\n          error: new SchemaValidationError(`Validation failed: ${summary}`, {\n            issues: validationResult.issues,\n            context: { toolName: contract.name },\n          }),\n        });\n      }\n\n      try {\n        const output = await contract.execute(validationResult.value, handlerCtx);\n        return finish({ data: output });\n      } catch (thrown) {\n        const message = thrown instanceof Error ? thrown.message : String(thrown);\n\n        return finish({\n          error: new ToolExecutionError(message, {\n            cause: thrown,\n            toolName: contract.name,\n          }),\n        });\n      }\n    },\n  };\n}\n","import type {\n  SupervisorAsToolOptions,\n  SupervisorContract,\n} from \"../contracts/supervisor/supervisor.contract\";\nimport { SupervisorFailedError } from \"../errors\";\nimport { compositeAsTool, type ToolContract } from \"../tool/tool\";\n\n/**\n * Wrap a `SupervisorContract` as a `ToolContract` so an outer agent\n * can invoke it from its tool-call loop. Mirrors\n * `workflow.asTool()` / `agent.asTool()` — same composition pattern,\n * same error-normalization behavior.\n *\n * Behavior:\n * - The tool's `name` mirrors the supervisor's `name` unless the\n *   caller overrides via `options.name`. Supervisors without a\n *   meaningful name throw `SupervisorFailedError` — an outer agent\n *   can't route to an anonymous tool.\n * - Tool `input` is the supplied schema; the validated value is\n *   coerced to a string (via `String()` for non-string values, or\n *   `JSON.stringify()` for objects) before being forwarded to\n *   `supervisor.execute(input)`. Consumers whose inputs need\n *   richer shaping should pre-format the string themselves.\n * - On `result.error`, the supervisor error is thrown so the tool\n *   wrapper catches it and produces a `ToolExecutionError` with\n *   `cause` set to the original typed supervisor error — the outer\n *   agent sees one uniform error class regardless of which\n *   primitive failed.\n *\n * **Usage caveat** (mirrors workflow-as-tool): nested usage is not\n * rolled into the outer agent's `result.usage` today — the\n * supervisor's tokens stay on the supervisor result. Sum manually\n * if you need a combined cost number until nested-usage\n * standardization lands.\n *\n * @example\n * const support = ai.supervisor({ ... });\n * const supportTool = support.asTool({\n *   name: \"handle_support_ticket\",\n *   description: \"Process a customer support ticket end-to-end.\",\n *   inputSchema: z.object({ ticket: z.string() }),\n * });\n * const concierge = ai.agent({ model, tools: [supportTool] });\n */\nexport function asTool<TOutput, TToolInput>(\n  supervisorInstance: SupervisorContract<TOutput>,\n  options: SupervisorAsToolOptions<TToolInput>,\n): ToolContract<TToolInput, TOutput> {\n  if (!supervisorInstance.name || typeof supervisorInstance.name !== \"string\") {\n    throw new SupervisorFailedError(\n      \"supervisor.asTool(): supervisor must have a `name` to be wrapped as a tool\",\n    );\n  }\n\n  return compositeAsTool<TToolInput, TOutput>({\n    name: options.name ?? supervisorInstance.name,\n    description: options.description ?? `Invoke supervisor \"${supervisorInstance.name}\" as a tool.`,\n    input: options.inputSchema,\n    execute: async (input) => {\n      const coerced = coerceInput(input);\n      const result = await supervisorInstance.execute(coerced);\n\n      if (result.error) {\n        // Surface the typed supervisor error — the outer ToolContract\n        // wraps it as a ToolExecutionError with `cause` preserved.\n        throw result.error;\n      }\n\n      return {\n        data: result.data as TOutput,\n        usage: result.usage,\n        report: result.report,\n      };\n    },\n  });\n}\n\n/**\n * Coerce a tool-input value into the `string` shape supervisor\n * `execute()` expects. Strings pass through; everything else gets\n * JSON-stringified so supervisors invoked via tool wrappers receive a\n * predictable textual input regardless of how the outer agent shaped\n * its call.\n */\nfunction coerceInput(value: unknown): string {\n  if (typeof value === \"string\") {\n    return value;\n  }\n\n  if (value === undefined || value === null) {\n    return \"\";\n  }\n\n  try {\n    return JSON.stringify(value);\n  } catch {\n    return String(value);\n  }\n}\n","import type { SupervisorEventMap } from \"../contracts/events/event-map.type\";\nimport type {\n  SupervisorEventHandler,\n  SupervisorEventHandlers,\n} from \"../contracts/supervisor/supervisor-config.type\";\n\ntype AnyHandler = SupervisorEventHandler<keyof SupervisorEventMap>;\n\n/**\n * Three-tier supervisor event emitter — factory (definition) → instance\n * → per-execution. Mirrors `WorkflowEmitter` structurally; the only\n * difference is the event map. All matching handlers fire in layer\n * order. Handler errors are swallowed so a listener bug can never\n * derail the run.\n *\n * @example\n * const emitter = new SupervisorEmitter(definition.on);\n * const unsubscribe = emitter.on(\"supervisor.completed\", (payload) => ...);\n * emitter.emit(\"supervisor.starting\", { runId, rootRunId, supervisorName, input }, perCallHandlers);\n */\nexport class SupervisorEmitter {\n  private readonly factoryHandlers?: SupervisorEventHandlers;\n  private readonly instanceHandlers = new Map<\n    keyof SupervisorEventMap,\n    Set<AnyHandler>\n  >();\n\n  public constructor(factoryHandlers?: SupervisorEventHandlers) {\n    this.factoryHandlers = factoryHandlers;\n  }\n\n  public on<K extends keyof SupervisorEventMap>(\n    event: K,\n    handler: SupervisorEventHandler<K>,\n  ): () => void {\n    let bucket = this.instanceHandlers.get(event);\n\n    if (!bucket) {\n      bucket = new Set();\n      this.instanceHandlers.set(event, bucket);\n    }\n\n    bucket.add(handler as AnyHandler);\n\n    return () => this.off(event, handler);\n  }\n\n  public off<K extends keyof SupervisorEventMap>(\n    event: K,\n    handler: SupervisorEventHandler<K>,\n  ): void {\n    this.instanceHandlers.get(event)?.delete(handler as AnyHandler);\n  }\n\n  public emit<K extends keyof SupervisorEventMap>(\n    event: K,\n    payload: SupervisorEventMap[K],\n    executionHandlers?: SupervisorEventHandlers,\n  ): void {\n    invoke(this.factoryHandlers?.[event], payload);\n\n    const bucket = this.instanceHandlers.get(event);\n\n    if (bucket) {\n      for (const handler of bucket) {\n        invoke(handler, payload);\n      }\n    }\n\n    invoke(executionHandlers?.[event], payload);\n  }\n}\n\nfunction invoke<K extends keyof SupervisorEventMap>(\n  handler: ((payload: SupervisorEventMap[K]) => void) | undefined,\n  payload: SupervisorEventMap[K],\n): void {\n  if (typeof handler !== \"function\") {\n    return;\n  }\n\n  try {\n    handler(payload);\n  } catch {\n    // Listener bugs must not derail the supervisor.\n  }\n}\n","import type { StandardSchemaV1 } from \"@standard-schema/spec\";\nimport type { AgentContract } from \"../contracts/agent/agent.contract\";\nimport type { Message } from \"../contracts/conversation-message.type\";\nimport type { EndSentinel } from \"../contracts/end.type\";\nimport type { AgentResult } from \"../contracts/result/agent-result.type\";\nimport type { WorkflowResult } from \"../contracts/result/workflow-result.type\";\nimport type { DispatchContext } from \"../contracts/supervisor/dispatch-context.type\";\nimport type {\n  DispatchRawResult,\n  IntentCallback,\n  IntentEntry,\n  IntentRunEntry,\n  SupervisorIntentValue,\n} from \"../contracts/supervisor/intent-entry.type\";\nimport type { RouteContext } from \"../contracts/supervisor/route-context.type\";\nimport type { SupervisorConfig } from \"../contracts/supervisor/supervisor-config.type\";\nimport type { WorkflowInstance } from \"../contracts/workflow/workflow.contract\";\nimport { SupervisorFailedError } from \"../errors\";\n\n/**\n * Normalized internal representation of one entry in a supervisor's\n * `intents` map — resolved at factory time from one of the accepted\n * value forms (bare agent / workflow / callback / object entry).\n *\n * Carrying the explicit `type` discriminator keeps downstream code\n * (execution, signature, router-prompt) from having to re-detect\n * shape on every dispatch. The discriminated union below replaces\n * the flat-shape used in Phase 3 so callbacks can carry their own\n * function reference + dispatch-context-shaped resolvers.\n *\n * Discriminator renamed `kind` → `type` (Q12) for codebase-wide\n * consistency — every other discriminated result/report shape uses\n * `type`.\n */\nexport type ResolvedIntentEntry =\n  | ResolvedAgentEntry\n  | ResolvedWorkflowEntry\n  | ResolvedCallbackEntry;\n\n/**\n * Successor directive function type — the resolver-time projection of\n * `IntentEntry.next` / `IntentRunEntry.next`. Single source of truth\n * across the three resolved variants.\n */\nexport type IntentNext = (ctx: DispatchContext) => string | string[] | EndSentinel | undefined;\n\n/**\n * Resolver-time projection of `IntentEntry.history` /\n * `RouterEntry.history` / `AckEntry.history`. Custom slicer that\n * REPLACES the default `historyWindow.<role>` slice.\n */\nexport type EntryHistorySlicer = (ctx: RouteContext) => Message[] | ReadonlyArray<Message>;\n\nexport type ResolvedAgentEntry = {\n  intent: string;\n  type: \"agent\";\n  unit: AgentContract<unknown>;\n  description: string;\n  input?: (ctx: RouteContext) => string;\n  /**\n   * Per-dispatch placeholder values for the agent's systemPrompt\n   * template. Forwarded as `agent.execute(input, { placeholders })`.\n   * Phase 3.4 (Stage 4b) — replaces the dropped `composeAgentInput`\n   * mechanism for threading state into agents.\n   */\n  placeholders?: (ctx: DispatchContext) => Record<string, unknown>;\n  /**\n   * Schema declaring this intent's slice of supervisor state. Agent\n   * output is strip-merged against it; only validated keys appear on\n   * `IterationSnapshot.result[intent].output` AND merge into\n   * supervisor `state`.\n   */\n  output?: StandardSchemaV1<unknown>;\n  /**\n   * Successor directive (Stage 4d / Q24). When present, runs after\n   * this branch's slice merges into state to choose the next dispatch\n   * (or terminate) without invoking the router.\n   */\n  next?: IntentNext;\n  /**\n   * Custom history slicer — replaces the default\n   * `historyWindow.agents` slice when supplied. See `IntentEntry.history`.\n   */\n  history?: EntryHistorySlicer;\n  /**\n   * Phase 5 / decisions §34. `\"stream\"` runs the agent without\n   * structured-output coercion and writes the assembled prose into\n   * `state[streamTo]`; `\"structured\"` is the default. Resolved at\n   * factory time — `undefined` here is treated as `\"structured\"`.\n   */\n  mode?: \"structured\" | \"stream\";\n  /** State key the assembled stream-mode prose writes into. Set iff `mode === \"stream\"`. */\n  streamTo?: string;\n};\n\nexport type ResolvedWorkflowEntry = {\n  intent: string;\n  type: \"workflow\";\n  unit: WorkflowInstance<unknown, unknown>;\n  description: string;\n  input?: (ctx: RouteContext) => string;\n  placeholders?: (ctx: DispatchContext) => Record<string, unknown>;\n  output?: StandardSchemaV1<unknown>;\n  next?: IntentNext;\n  history?: EntryHistorySlicer;\n};\n\nexport type ResolvedCallbackEntry = {\n  intent: string;\n  type: \"callback\";\n  /**\n   * The callback that actually runs at dispatch time. Always present\n   * regardless of whether the user passed bare-function shorthand or\n   * the `{ run, ... }` entry form.\n   */\n  callback: IntentCallback;\n  /**\n   * Description is required only when the supervisor uses a router.\n   * Callback intents under a router are validated separately\n   * (see {@link assertRouterDescriptions}); under deterministic\n   * `route` mode this field is `undefined`.\n   */\n  description?: string;\n  /**\n   * Per-intent input resolver. Receives the upcoming\n   * `DispatchContext` and returns the value forwarded as\n   * `ctx.input` to the callback.\n   */\n  input?: (ctx: DispatchContext) => unknown;\n  placeholders?: (ctx: DispatchContext) => Record<string, unknown>;\n  /**\n   * Schema declaring this callback's slice of state. Without it, the\n   * full return value shallow-merges; with it, return is strip-merged\n   * to declared keys before merging.\n   */\n  output?: StandardSchemaV1<unknown>;\n  next?: IntentNext;\n};\n\n/**\n * Validate and normalize the `intents` map into resolved entries.\n * Runs at factory time — throws `SupervisorFailedError` on the first\n * malformed entry so author-time bugs surface immediately rather\n * than mid-run.\n *\n * Validation rules:\n * - Every value must be an agent, a workflow, a callback function,\n *   or an object entry with `agent` / `workflow` / `run`.\n * - Object entries with more than one of `{ agent, workflow, run }`\n *   throw with code `SUPERVISOR_INTENT_MIXED_DISPATCH`.\n * - Agent / workflow / agent-shaped entries must resolve to a\n *   non-empty description from the underlying unit or the entry's\n *   `description` override. Bare callback shorthand has no\n *   description source — that's enforced separately by\n *   {@link assertRouterDescriptions} when a router is configured.\n */\nexport function resolveIntentEntries(\n  rawIntents: Record<string, SupervisorIntentValue>,\n  supervisorName: string,\n): Map<string, ResolvedIntentEntry> {\n  const entries = Object.entries(rawIntents);\n\n  if (entries.length === 0) {\n    throw new SupervisorFailedError(\n      `ai.supervisor(\"${supervisorName}\"): \\`intents\\` must contain at least one entry`,\n      { context: { authoring: true } },\n    );\n  }\n\n  const resolved = new Map<string, ResolvedIntentEntry>();\n\n  for (const [intent, value] of entries) {\n    if (!intent || typeof intent !== \"string\") {\n      throw new SupervisorFailedError(\n        `ai.supervisor(\"${supervisorName}\"): every \\`intents\\` key must be a non-empty string`,\n        { context: { authoring: true } },\n      );\n    }\n\n    resolved.set(intent, resolveOne(intent, value, supervisorName));\n  }\n\n  return resolved;\n}\n\n/**\n * Construction-time guard: when the supervisor is configured with a\n * `router`, every intent must resolve to a non-empty description so\n * the router LLM has a signal for picking it. Bare callback\n * shorthand and `IntentRunEntry` without `description` fail this\n * check; agents and workflows whose underlying primitive lacks a\n * description fail too — same uniform error message.\n *\n * Deterministic `route` callers skip this check entirely.\n */\nexport function assertRouterDescriptions(\n  config: SupervisorConfig<unknown>,\n  entries: Map<string, ResolvedIntentEntry>,\n): void {\n  if (!config.router) {\n    return;\n  }\n\n  for (const [intent, entry] of entries) {\n    const description = entry.type === \"callback\" ? entry.description : entry.description;\n\n    if (description && description.trim().length > 0) {\n      continue;\n    }\n\n    const fix =\n      entry.type === \"callback\"\n        ? \"upgrade the bare callback to `{ run, description }`\"\n        : \"set `description` on the agent/workflow or via the `IntentEntry` `description` override\";\n\n    throw new SupervisorFailedError(\n      `ai.supervisor(\"${config.name}\"): intents[\"${intent}\"] needs a description because a \\`router\\` is configured — ${fix}`,\n      { context: { authoring: true, intent } },\n      \"SUPERVISOR_INTENT_DESCRIPTION_REQUIRED\",\n    );\n  }\n}\n\nfunction resolveOne(\n  intent: string,\n  value: SupervisorIntentValue,\n  supervisorName: string,\n): ResolvedIntentEntry {\n  // (c) Bare callback shorthand — typeof function. Highest priority\n  // so a user passing `(ctx) => …` never accidentally matches the\n  // object-shape branches below.\n  if (typeof value === \"function\") {\n    return {\n      intent,\n      type: \"callback\",\n      callback: value as IntentCallback,\n      description: undefined,\n    };\n  }\n\n  if (!value || typeof value !== \"object\") {\n    throw new SupervisorFailedError(\n      `ai.supervisor(\"${supervisorName}\"): intents[\"${intent}\"] is not an agent, workflow, callback, or entry object`,\n      { context: { authoring: true, intent } },\n    );\n  }\n\n  // Detect mixed-dispatch entries up front. Two of `{ agent, workflow,\n  // run }` together is dev confusion, not a feature.\n  assertSingleDispatchField(intent, value, supervisorName);\n\n  // (d.run) Run-entry — `{ run, description?, input?, output? }`.\n  if (\"run\" in value && typeof (value as IntentRunEntry).run === \"function\") {\n    const entry = value as IntentRunEntry;\n\n    return {\n      intent,\n      type: \"callback\",\n      callback: entry.run,\n      description: entry.description,\n      input: entry.input,\n      placeholders: entry.placeholders,\n      output: entry.output,\n      next: entry.next,\n    };\n  }\n\n  // (d.agent / a / b) Agent-entry or bare unit. The existing\n  // `IntentEntry` shape uses `agent: AgentContract | WorkflowInstance`\n  // for both agent and workflow object entries; the resolver still\n  // dispatches the underlying unit kind correctly.\n  const entryForm = asAgentEntryForm(value);\n  const unit = entryForm\n    ? entryForm.agent\n    : (value as AgentContract<unknown> | WorkflowInstance<unknown, unknown>);\n\n  if (!isDispatchableUnit(unit)) {\n    throw new SupervisorFailedError(\n      `ai.supervisor(\"${supervisorName}\"): intents[\"${intent}\"] must be an AgentContract, WorkflowInstance, callback, or entry object`,\n      { context: { authoring: true, intent } },\n    );\n  }\n\n  const detectedType = detectType(unit);\n  const description = resolveAgentLikeDescription(intent, entryForm, unit, supervisorName);\n\n  if (detectedType === \"workflow\") {\n    if (entryForm?.mode === \"stream\") {\n      throw new SupervisorFailedError(\n        `ai.supervisor(\"${supervisorName}\"): intents[\"${intent}\"] sets \\`mode: \"stream\"\\` on a workflow entry — stream mode is agent-only in v1. Wrap the workflow in an agent or remove the \\`mode\\` field.`,\n        { context: { authoring: true, intent } },\n        \"SUPERVISOR_INTENT_STREAM_ON_WORKFLOW\",\n      );\n    }\n\n    return {\n      intent,\n      type: \"workflow\",\n      unit: unit as WorkflowInstance<unknown, unknown>,\n      description,\n      input: entryForm?.input,\n      placeholders: entryForm?.placeholders,\n      output: entryForm?.output,\n      next: entryForm?.next,\n      history: entryForm?.history,\n    };\n  }\n\n  assertStreamModeShape(intent, entryForm, supervisorName);\n\n  return {\n    intent,\n    type: \"agent\",\n    unit: unit as AgentContract<unknown>,\n    description,\n    input: entryForm?.input,\n    placeholders: entryForm?.placeholders,\n    output: entryForm?.output,\n    next: entryForm?.next,\n    history: entryForm?.history,\n    mode: entryForm?.mode,\n    streamTo: entryForm?.streamTo,\n  };\n}\n\n/**\n * Phase 5 / decisions §34 — enforce the two stream-mode invariants at\n * construction time:\n *\n * 1. `mode: \"stream\"` and per-intent `output` are mutually exclusive.\n *    Stream agents declare their state contribution via `streamTo`,\n *    not via a schema; allowing both would silently pick one and\n *    surprise the author.\n * 2. `streamTo` is required when `mode === \"stream\"`. A stream agent\n *    that doesn't write somewhere is a black box — fail loud at the\n *    factory rather than at run-time when state validation surfaces a\n *    missing key.\n */\nfunction assertStreamModeShape(\n  intent: string,\n  entryForm: IntentEntry | undefined,\n  supervisorName: string,\n): void {\n  if (!entryForm || entryForm.mode !== \"stream\") {\n    return;\n  }\n\n  if (entryForm.output) {\n    throw new SupervisorFailedError(\n      `ai.supervisor(\"${supervisorName}\"): intents[\"${intent}\"] sets both \\`mode: \"stream\"\\` and \\`output\\` — stream mode declares its slice via \\`streamTo\\`, not a schema. Drop one.`,\n      { context: { authoring: true, intent } },\n      \"SUPERVISOR_INTENT_STREAM_AND_OUTPUT\",\n    );\n  }\n\n  if (typeof entryForm.streamTo !== \"string\" || entryForm.streamTo.trim().length === 0) {\n    throw new SupervisorFailedError(\n      `ai.supervisor(\"${supervisorName}\"): intents[\"${intent}\"] sets \\`mode: \"stream\"\\` without a non-empty \\`streamTo\\` — a stream agent must name the state key its assembled prose writes into.`,\n      { context: { authoring: true, intent } },\n      \"SUPERVISOR_INTENT_STREAM_TO_REQUIRED\",\n    );\n  }\n}\n\n/**\n * Reject entries that mix dispatch fields. `{ agent, run }` is a\n * common copy-paste bug; we surface it at construction with a clear\n * message rather than silently picking one based on resolution\n * order.\n */\nfunction assertSingleDispatchField(intent: string, value: object, supervisorName: string): void {\n  const dispatchKeys = ([\"run\", \"agent\", \"workflow\"] as const).filter((key) => key in value);\n\n  if (dispatchKeys.length > 1) {\n    throw new SupervisorFailedError(\n      `ai.supervisor(\"${supervisorName}\"): intents[\"${intent}\"] has multiple dispatch fields (${dispatchKeys\n        .map((key) => `\\`${key}\\``)\n        .join(\n          \", \",\n        )}) — pick one. Two dispatch fields on the same entry is dev confusion, not a feature.`,\n      { context: { authoring: true, intent } },\n      \"SUPERVISOR_INTENT_MIXED_DISPATCH\",\n    );\n  }\n}\n\n/**\n * Coerce a `SupervisorIntentValue` into the agent-flavored\n * `IntentEntry` form when the caller passed the object form. Returns\n * `undefined` for bare shorthand. The shape check keys on the\n * presence of an `agent` property because both `AgentContract` and\n * `WorkflowInstance` have their own identifying fields\n * (`isAnonymous` for agents, `signature` for workflows) but neither\n * carries a top-level `agent`.\n */\nfunction asAgentEntryForm(value: object): IntentEntry | undefined {\n  if (!(\"agent\" in value)) {\n    return undefined;\n  }\n\n  const candidate = (value as { agent: unknown }).agent;\n\n  if (!candidate || typeof candidate !== \"object\") {\n    return undefined;\n  }\n\n  return value as IntentEntry;\n}\n\nfunction isDispatchableUnit(\n  value: unknown,\n): value is AgentContract<unknown> | WorkflowInstance<unknown, unknown> {\n  if (!value || typeof value !== \"object\") {\n    return false;\n  }\n\n  const candidate = value as { name?: unknown; execute?: unknown };\n\n  return typeof candidate.name === \"string\" && typeof candidate.execute === \"function\";\n}\n\nfunction detectType(\n  unit: AgentContract<unknown> | WorkflowInstance<unknown, unknown>,\n): \"agent\" | \"workflow\" {\n  // Workflows expose a structural `signature` field; agents don't.\n  if (typeof (unit as WorkflowInstance<unknown, unknown>).signature === \"string\") {\n    return \"workflow\";\n  }\n\n  return \"agent\";\n}\n\nfunction resolveAgentLikeDescription(\n  intent: string,\n  entryForm: IntentEntry | undefined,\n  unit: AgentContract<unknown> | WorkflowInstance<unknown, unknown>,\n  supervisorName: string,\n): string {\n  const entryOverride = entryForm?.description;\n\n  if (entryOverride && entryOverride.trim().length > 0) {\n    return entryOverride;\n  }\n\n  const unitDescription = (unit as { description?: unknown }).description;\n\n  if (typeof unitDescription === \"string\" && unitDescription.trim().length > 0) {\n    return unitDescription;\n  }\n\n  // Empty string sentinel — caller (assertRouterDescriptions) decides\n  // whether a missing description is fatal. Under deterministic\n  // `route` mode it isn't.\n  return \"\";\n}\n\n/**\n * Type guard helper for downstream modules. Narrows a raw\n * `AgentResult | WorkflowResult` based on the resolved entry's kind,\n * so transformers and emitters can pull the right fields without\n * re-checking shape.\n */\nexport function isAgentResult(raw: DispatchRawResult): raw is AgentResult<unknown> {\n  return raw.type === \"agent\";\n}\n\nexport function isWorkflowResult(raw: DispatchRawResult): raw is WorkflowResult<unknown> {\n  return raw.type === \"workflow\";\n}\n","/**\n * Framework-global termination sentinel. Emitted by any primitive\n * whose control flow is routed through JSON-serializable strings —\n * supervisor (router agent's `next`, deterministic `route` callback),\n * future planner (plan steps), future orchestrator (session\n * directive), any future primitive that needs to say \"stop\" across a\n * wire that can't carry `null`.\n *\n * **Why one shared literal.** Consumers learn one word. Cross-\n * primitive pipes — a planner feeding a supervisor, a supervisor\n * nested as a tool inside an orchestrator — can pass the sentinel\n * through without translation.\n *\n * **Why this specific string.** Brand-prefixed (`__warlock:`) so it\n * can't collide with a realistic user-chosen intent / step / route\n * key (`\"end\"`, `\"done\"`, `\"stop\"` are all valid user keys).\n * Underscore-surrounded so it stands out in logs and snapshots.\n * JSON-safe so a router agent emits it verbatim.\n *\n * **Not used by every primitive.** Workflow's `nextStep` returns\n * `null` to end — a callback-level mechanism that predates this\n * sentinel. Workflows keep `null`; the sentinel is for primitives\n * whose \"end\" must survive a JSON boundary.\n *\n * @example\n * import { END } from \"@warlock.js/ai\";\n *\n * // Supervisor route callback\n * ai.supervisor({\n *   intents: { writer, critic },\n *   route: (ctx) => (ctx.iteration >= 5 ? END : \"writer\"),\n * });\n *\n * // Router agent output schema\n * const router = ai.agent({\n *   model,\n *   output: z.object({\n *     next: z.union([z.string(), z.array(z.string()), z.literal(END)]),\n *   }),\n * });\n */\nexport const END = \"__warlock:end__\" as const;\n\n/**\n * Value type of `END`. Exposed so consumers building Zod / Standard\n * Schema output schemas can write `z.literal(END)` without\n * hard-coding the string, and so generic helpers that accept \"the\n * end sentinel\" can type-narrow correctly.\n */\nexport type EndSentinel = typeof END;\n","import { SupervisorCancelledError } from \"../errors\";\n\n/**\n * Build a `SupervisorCancelledError` from an `AbortSignal`. Extracts a\n * human-readable reason from `signal.reason` whether it was a string,\n * an `Error`, or some other value. Used at between-iteration boundaries\n * and on any mid-iteration cancellation path.\n */\nexport function createCancelledError(\n  signal: AbortSignal | undefined,\n): SupervisorCancelledError {\n  const reason = signal?.reason;\n  const reasonText =\n    typeof reason === \"string\"\n      ? reason\n      : reason instanceof Error\n        ? reason.message\n        : reason === undefined\n          ? \"\"\n          : String(reason);\n\n  return new SupervisorCancelledError(\n    `supervisor cancelled${reasonText ? `: ${reasonText}` : \"\"}`,\n    { cancelledAt: new Date().toISOString(), reason: reasonText },\n  );\n}\n","import { END } from \"../contracts/end.type\";\nimport type { IterationSnapshot } from \"../contracts/supervisor/iteration-snapshot.type\";\nimport type { SupervisorInput } from \"../contracts/supervisor/supervisor-input.type\";\nimport type { ResolvedIntentEntry } from \"./entries\";\n\n/**\n * Build the per-turn user message the supervisor feeds to the router\n * agent. Carries everything the LLM needs to make a routing decision:\n *\n * - Available intents with descriptions (so the router knows what\n *   to pick from).\n * - The reserved `END` sentinel value it can emit to terminate.\n * - Iteration counter + ceiling so the router can pace itself.\n * - Compact history of prior iterations (intent + short output clip).\n * - The supervisor's original input so the router stays anchored.\n *\n * Note the router's own `systemPrompt` is kept persistent across\n * turns — this function produces only the per-turn USER message.\n */\nexport function buildRouterContextMessage(params: {\n  entries: Map<string, ResolvedIntentEntry>;\n  iteration: number;\n  maxIterations: number;\n  iterations: IterationSnapshot[];\n  input: SupervisorInput;\n  /**\n   * Per-execute state at the START of this iteration (post-merge of\n   * the previous iteration). Rendered as a JSON snippet so the\n   * router can pick the next intent based on what's already filled\n   * in (Q14).\n   */\n  state?: Record<string, unknown>;\n  /**\n   * Reviewer feedback string from the previous iteration's evaluate\n   * verdict. Rendered as its own section so the router weighs it\n   * alongside the intent list (Q18).\n   */\n  feedback?: string;\n  /**\n   * Supervisor-level system prompt text, when configured. Surfaced at\n   * the TOP of the router's per-turn user message so the router reads\n   * team/domain context before the routing mechanics block. Skipped\n   * when the supervisor didn't configure `systemPrompt`.\n   */\n  supervisorPrompt?: string;\n  /**\n   * Resolved natural-language objective from `SupervisorConfig.goal`.\n   * Surfaced as its own labeled section near the top of the router's\n   * user message so routing decisions are objective-aware. Skipped\n   * when no goal was configured.\n   */\n  goal?: string;\n}): string {\n  const {\n    entries,\n    iteration,\n    maxIterations,\n    iterations,\n    input,\n    state,\n    feedback,\n    supervisorPrompt,\n    goal,\n  } = params;\n\n  const intentLines = [...entries.values()].map(\n    entry => `- ${entry.intent}: ${entry.description}`,\n  );\n\n  const historyLines =\n    iterations.length === 0\n      ? [\"(none yet)\"]\n      : iterations.map(snapshot => formatHistoryLine(snapshot));\n\n  const sections: string[] = [];\n\n  if (supervisorPrompt) {\n    sections.push(supervisorPrompt.trim(), \"\");\n  }\n\n  if (goal) {\n    sections.push(\"Goal:\", goal.trim(), \"\");\n  }\n\n  sections.push(\n    \"Available intents:\",\n    ...intentLines,\n    \"\",\n    \"Reserved values:\",\n    `- ${END} = terminate the run`,\n    \"\",\n    `Iteration: ${iteration + 1} / ${maxIterations}`,\n    \"\",\n    \"History:\",\n    ...historyLines,\n  );\n\n  if (state && Object.keys(state).length > 0) {\n    sections.push(\"\", \"Current state:\", safeStringify(state));\n  }\n\n  if (feedback) {\n    sections.push(\"\", `Reviewer feedback from last iteration: ${feedback}`);\n  }\n\n  const renderedInput =\n    typeof input === \"string\" ? input : safeStringify(input);\n\n  sections.push(\"\", `Original input: ${renderedInput}`);\n\n  return sections.join(\"\\n\");\n}\n\nfunction formatHistoryLine(snapshot: IterationSnapshot): string {\n  const branches = Object.entries(snapshot.result).map(\n    ([intent, branch]) => `${intent} → ${clip(branch.output)}`,\n  );\n\n  return `[${snapshot.iteration}] ${branches.join(\" | \")}`;\n}\n\nfunction clip(value: unknown, maxLength = 160): string {\n  if (value === undefined || value === null) {\n    return String(value);\n  }\n\n  const raw = typeof value === \"string\" ? value : safeStringify(value);\n\n  if (raw.length <= maxLength) {\n    return raw;\n  }\n\n  return `${raw.slice(0, maxLength - 1)}…`;\n}\n\nfunction safeStringify(value: unknown): string {\n  try {\n    return JSON.stringify(value);\n  } catch {\n    return `[unserializable: ${typeof value}]`;\n  }\n}\n","import type { StandardSchemaV1 } from \"@standard-schema/spec\";\nimport type { AgentContract } from \"../contracts/agent/agent.contract\";\nimport type { Message } from \"../contracts/conversation-message.type\";\nimport { END, type EndSentinel } from \"../contracts/end.type\";\nimport type { BaseReport } from \"../contracts/result/base-report.type\";\nimport type { IterationSnapshot } from \"../contracts/supervisor/iteration-snapshot.type\";\nimport type { Next } from \"../contracts/supervisor/next.type\";\nimport type { RouteContext } from \"../contracts/supervisor/route-context.type\";\nimport type { RouterEntry } from \"../contracts/supervisor/router-entry.type\";\nimport type { SupervisorConfig } from \"../contracts/supervisor/supervisor-config.type\";\nimport type { SupervisorInput } from \"../contracts/supervisor/supervisor-input.type\";\nimport { AIError, SupervisorFailedError, SupervisorRoutingError } from \"../errors\";\nimport type { ResolvedIntentEntry } from \"./entries\";\nimport { buildRouterContextMessage } from \"./router-prompt\";\n\n/**\n * Outcome of one dispatch decision — what the iteration loop needs to\n * act on. `kind: \"end\"` signals termination; `kind: \"dispatch\"` carries\n * the resolved intents (always an array; single-agent dispatch has\n * length 1). `source` records which path made the call so the\n * iteration snapshot can surface it to debuggers.\n */\nexport type DispatchDecision =\n  | {\n      kind: \"end\";\n      source: \"route\" | \"router\" | \"initialAgent\" | \"classifier\";\n      raw: Next;\n      reasoning?: string;\n      durationMs: number;\n      usage?: { input: number; output: number; total: number };\n      /** Full router-agent report when this decision came from a router. */\n      routerReport?: BaseReport;\n    }\n  | {\n      kind: \"dispatch\";\n      intents: string[];\n      source: \"route\" | \"router\" | \"initialAgent\" | \"classifier\";\n      raw: Next;\n      reasoning?: string;\n      durationMs: number;\n      usage?: { input: number; output: number; total: number };\n      /** Full router-agent report when this decision came from a router. */\n      routerReport?: BaseReport;\n    };\n\nexport type DecideParams = {\n  config: SupervisorConfig<unknown>;\n  entries: Map<string, ResolvedIntentEntry>;\n  iteration: number;\n  maxIterations: number;\n  iterations: IterationSnapshot[];\n  input: SupervisorInput;\n  /**\n   * Per-execute state accumulator at the start of this iteration.\n   * Threaded into `RouteContext` for the route callback and\n   * rendered into the router prompt so routing decisions can be\n   * state-aware (Q14).\n   */\n  state: Record<string, unknown>;\n  /**\n   * Frozen request-scoped bag from the `execute({ context })` call —\n   * surfaced on `RouteContext.context` for both `route` callbacks\n   * and `RouterEntry.placeholders` / `RouterEntry.input` resolvers.\n   */\n  context: Readonly<Record<string, unknown>>;\n  /**\n   * Frozen prior-conversation history from `execute({ history })` —\n   * surfaced on `RouteContext.history` and forwarded to the router\n   * agent as `agent.execute(input, { history })` so router decisions\n   * are conversation-aware.\n   */\n  history: ReadonlyArray<Message>;\n  /**\n   * Resolved natural-language objective from `SupervisorConfig.goal`\n   * (materialized to plain text at supervisor construction). Surfaced\n   * on `RouteContext.goal` for `route` / `RouterEntry` resolvers, and\n   * injected into the router agent's per-turn user message via\n   * `buildRouterContextMessage`. `undefined` when no goal was set.\n   */\n  goal: string | undefined;\n  evaluateFeedback?: RouteContext[\"evaluateFeedback\"];\n  /**\n   * Forensic record of the iter-0 classifier (Phase 7). Threaded into\n   * `RouteContext.classifier` so route callbacks and router-agent\n   * input composers can read the classification trail without\n   * re-parsing state.\n   */\n  classifier?: RouteContext[\"classifier\"];\n  signal?: AbortSignal;\n  /**\n   * Override for the very first iteration — when `initialAgent` is\n   * set, the first turn skips `route`/`router` and dispatches the\n   * named intent directly. `runIteration` passes `true` only on turn\n   * 0 when the config has `initialAgent`.\n   */\n  useInitialAgent?: boolean;\n};\n\n/**\n * Unified dispatch decision entry — calls either the `route` callback\n * or the `router` agent based on the supervisor's configured mode and\n * normalizes the result into a `DispatchDecision`. Runtime validates\n * every routing value against the configured agent keys; unknown keys\n * surface as `SupervisorRoutingError`.\n */\nexport async function decide(params: DecideParams): Promise<DispatchDecision> {\n  if (params.useInitialAgent && params.config.initialAgent) {\n    const intent = params.config.initialAgent;\n    validateKey(intent, params.entries);\n\n    return {\n      kind: \"dispatch\",\n      intents: [intent],\n      source: \"initialAgent\",\n      raw: intent,\n      durationMs: 0,\n    };\n  }\n\n  if (params.config.route) {\n    return decideViaCallback(params);\n  }\n\n  if (params.config.router) {\n    return decideViaRouter(params);\n  }\n\n  throw new SupervisorFailedError(\n    `ai.supervisor(\"${params.config.name}\"): neither \\`route\\` nor \\`router\\` is configured — factory validation should have prevented this`,\n    { context: { authoring: true } },\n  );\n}\n\nasync function decideViaCallback(params: DecideParams): Promise<DispatchDecision> {\n  const started = performance.now();\n  const ctx: RouteContext = {\n    iteration: params.iteration,\n    input: params.input,\n    state: params.state,\n    iterations: params.iterations,\n    feedback:\n      typeof params.evaluateFeedback?.feedback === \"string\"\n        ? params.evaluateFeedback.feedback\n        : undefined,\n    evaluateFeedback: params.evaluateFeedback,\n    context: params.context,\n    history: params.history,\n    goal: params.goal,\n    classifier: params.classifier,\n  };\n\n  let raw: Next;\n\n  try {\n    raw = await params.config.route!(ctx);\n  } catch (thrown) {\n    throw wrapRouteError(params.config.name, thrown);\n  }\n\n  const durationMs = performance.now() - started;\n\n  return normalize(raw, params.entries, \"route\", durationMs);\n}\n\nasync function decideViaRouter(params: DecideParams): Promise<DispatchDecision> {\n  const { agent, placeholders, inputOverride, historySlicer } = resolveRouterEntry(\n    params.config.router!,\n  );\n  const started = performance.now();\n\n  const routeCtx: RouteContext = {\n    iteration: params.iteration,\n    input: params.input,\n    state: params.state,\n    iterations: params.iterations,\n    feedback:\n      typeof params.evaluateFeedback?.feedback === \"string\"\n        ? params.evaluateFeedback.feedback\n        : undefined,\n    evaluateFeedback: params.evaluateFeedback,\n    context: params.context,\n    history: params.history,\n    goal: params.goal,\n  };\n\n  const userMessage =\n    inputOverride?.(routeCtx) ??\n    buildRouterContextMessage({\n      entries: params.entries,\n      iteration: params.iteration,\n      maxIterations: params.maxIterations,\n      iterations: params.iterations,\n      input: params.input,\n      state: params.state,\n      feedback: routeCtx.feedback,\n      supervisorPrompt: resolveSupervisorPromptText(params.config),\n      goal: params.goal,\n    });\n\n  const resolvedPlaceholders = placeholders?.(routeCtx);\n\n  // Inject the canonical router output schema so the supervisor gets\n  // a predictable `{ next, reasoning? }` shape regardless of what the\n  // user scripted on the router agent. Lets the router stay a plain\n  // agent — no supervisor-specific config needed at construction.\n  const routerHistory = resolveRouterHistory(\n    historySlicer,\n    routeCtx,\n    params.history,\n    params.config.historyWindow?.router,\n  );\n\n  const routerResult = await agent.execute(userMessage, {\n    signal: params.signal,\n    output: ROUTER_OUTPUT_SCHEMA as unknown as StandardSchemaV1<{\n      next: Next;\n      reasoning?: string;\n    }>,\n    ...(resolvedPlaceholders ? { placeholders: resolvedPlaceholders } : {}),\n    ...(routerHistory.length > 0 ? { history: routerHistory } : {}),\n  });\n\n  const durationMs = performance.now() - started;\n\n  if (routerResult.error) {\n    throw routerResult.error instanceof AIError\n      ? routerResult.error\n      : new SupervisorFailedError(`router agent failed`, {\n          cause: routerResult.error,\n        });\n  }\n\n  const data = routerResult.data;\n\n  if (!data || typeof data !== \"object\") {\n    throw new SupervisorRoutingError(\n      `router agent returned no structured \\`next\\` — did its output schema include { next, reasoning? }?`,\n      { returned: data, availableKeys: [...params.entries.keys()] },\n    );\n  }\n\n  const rawNext = (data as { next?: unknown }).next;\n  const reasoning = (data as { reasoning?: unknown }).reasoning;\n\n  if (rawNext === undefined) {\n    throw new SupervisorRoutingError(`router agent output missing \\`next\\` field`, {\n      returned: data,\n      availableKeys: [...params.entries.keys()],\n    });\n  }\n\n  const decision = normalize(rawNext as Next, params.entries, \"router\", durationMs);\n\n  return {\n    ...decision,\n    reasoning: typeof reasoning === \"string\" ? reasoning : undefined,\n    usage: routerResult.usage,\n    routerReport: routerResult.report,\n  };\n}\n\n/**\n * Normalize the `router` config field — accepts either a bare\n * `AgentContract` (shorthand) or a full `RouterEntry` — into a\n * uniform `{ agent, placeholders?, inputOverride? }` triple. Centralized\n * so the dispatch path doesn't branch on shape.\n */\nfunction resolveRouterEntry(router: AgentContract<unknown> | RouterEntry): {\n  agent: AgentContract<unknown>;\n  placeholders?: RouterEntry[\"placeholders\"];\n  inputOverride?: RouterEntry[\"input\"];\n  historySlicer?: RouterEntry[\"history\"];\n} {\n  if (typeof (router as { execute?: unknown }).execute === \"function\") {\n    return { agent: router as AgentContract<unknown> };\n  }\n\n  const entry = router as RouterEntry;\n\n  return {\n    agent: entry.agent,\n    placeholders: entry.placeholders,\n    inputOverride: entry.input,\n    historySlicer: entry.history,\n  };\n}\n\n/**\n * Resolve the supervisor's own `systemPrompt` (string or contract)\n * into plain text. Returns `undefined` when the supervisor didn't\n * configure one. The resolved text is surfaced in the per-turn\n * router user message so the router sees team/domain context without\n * disturbing the router agent's own factory-level system prompt —\n * functionally equivalent to prepending, without requiring an API\n * expansion on `AgentContract` to read the router's system prompt.\n */\nfunction resolveSupervisorPromptText(config: SupervisorConfig<unknown>): string | undefined {\n  if (!config.systemPrompt) {\n    return undefined;\n  }\n\n  return typeof config.systemPrompt === \"string\"\n    ? config.systemPrompt\n    : config.systemPrompt.resolve();\n}\n\n/**\n * Convert the raw routing value (callback return OR router agent\n * `next` field) into a canonical `DispatchDecision`, validating every\n * named intent against the supervisor's `intents` map.\n */\nfunction normalize(\n  raw: Next,\n  entries: Map<string, ResolvedIntentEntry>,\n  source: \"route\" | \"router\",\n  durationMs: number,\n): DispatchDecision {\n  if (isEnd(raw)) {\n    return { kind: \"end\", source, raw, durationMs };\n  }\n\n  if (typeof raw === \"string\") {\n    validateKey(raw, entries);\n\n    return {\n      kind: \"dispatch\",\n      intents: [raw],\n      source,\n      raw,\n      durationMs,\n    };\n  }\n\n  if (Array.isArray(raw)) {\n    if (raw.length === 0) {\n      throw new SupervisorRoutingError(\n        `router returned an empty array — must be a non-empty list of agent intents`,\n        { returned: raw, availableKeys: [...entries.keys()] },\n      );\n    }\n\n    for (const intent of raw) {\n      if (typeof intent !== \"string\") {\n        throw new SupervisorRoutingError(`router returned a non-string inside its fan-out array`, {\n          returned: raw,\n          availableKeys: [...entries.keys()],\n        });\n      }\n\n      validateKey(intent, entries);\n    }\n\n    return {\n      kind: \"dispatch\",\n      intents: raw,\n      source,\n      raw,\n      durationMs,\n    };\n  }\n\n  throw new SupervisorRoutingError(\n    `router returned an unsupported value — expected a string, string[], or END`,\n    { returned: raw, availableKeys: [...entries.keys()] },\n  );\n}\n\nfunction validateKey(intent: string, entries: Map<string, ResolvedIntentEntry>): void {\n  if (!entries.has(intent)) {\n    throw new SupervisorRoutingError(`router returned unknown agent key \"${intent}\"`, {\n      returned: intent,\n      availableKeys: [...entries.keys()],\n    });\n  }\n}\n\nfunction isEnd(value: unknown): value is EndSentinel {\n  return value === END;\n}\n\n/**\n * Resolve the history slice forwarded to the router agent. Mirrors\n * `SupervisorExecution.resolveHistoryFor(\"router\", ...)` — duplicated\n * here so the standalone `decide()` function stays callable without\n * threading the execution instance through. Precedence is identical:\n * entry slicer > `historyWindow.router` > full history.\n */\nfunction resolveRouterHistory(\n  slicer: RouterEntry[\"history\"] | undefined,\n  routeCtx: RouteContext,\n  full: ReadonlyArray<Message>,\n  window: number | undefined,\n): Message[] {\n  if (slicer) {\n    const sliced = slicer(routeCtx);\n    return sliced ? [...sliced] : [];\n  }\n\n  if (window === undefined || window < 0) {\n    return [...full];\n  }\n\n  if (window === 0) {\n    return [];\n  }\n\n  return full.slice(-window);\n}\n\n/**\n * JSON Schema form of the canonical router output shape. Surfaced via\n * the Standard JSON Schema V1 extension path (`[\"~standard\"].jsonSchema.input`)\n * so `extractJsonSchema()` can pull it for native structured-output\n * enforcement on capable providers (OpenAI strict json_schema mode,\n * Anthropic tool-use shape, etc.). Without this, the model is told to\n * emit JSON only via soft system-prompt instruction — fragile, and\n * skipped entirely when the model advertises `structuredOutput: true`.\n *\n * `next` is intentionally `string` (not a union with arrays) because\n * OpenAI strict mode rejects polymorphic root types — fan-out via\n * `string[]` is still validated at the framework layer; the model\n * just emits a single intent name (or the END sentinel) and the\n * supervisor's own normalizer handles the rest.\n */\nconst ROUTER_OUTPUT_JSON_SCHEMA = {\n  type: \"object\",\n  properties: {\n    next: {\n      type: \"string\",\n      description: \"Name of the agent to dispatch next, or the END sentinel to terminate the run.\",\n    },\n    reasoning: {\n      type: \"string\",\n      description: \"One-sentence justification for the routing choice.\",\n    },\n  },\n  required: [\"next\", \"reasoning\"],\n  additionalProperties: false,\n};\n\n/**\n * Canonical Standard Schema the supervisor injects when calling the\n * router agent. Pragmatic — accepts any `next` shape the router can\n * plausibly emit (`string`, `string[]`, or the `END` literal) plus an\n * optional `reasoning` field. Rejects anything else so a broken\n * router output surfaces cleanly via the agent's own validation path.\n *\n * Exposes `[\"~standard\"].jsonSchema.input()` (Standard JSON Schema V1)\n * so capable providers enforce the shape natively rather than relying\n * on prompt-side coaching.\n */\nconst ROUTER_OUTPUT_SCHEMA: StandardSchemaV1<{\n  next: Next;\n  reasoning?: string;\n}> = {\n  \"~standard\": {\n    version: 1,\n    vendor: \"warlock-supervisor\",\n    jsonSchema: {\n      input: () => ROUTER_OUTPUT_JSON_SCHEMA,\n    },\n    validate(value: unknown): StandardSchemaV1.Result<{ next: Next; reasoning?: string }> {\n      if (!value || typeof value !== \"object\") {\n        return { issues: [{ message: \"router output must be an object\" }] };\n      }\n\n      const record = value as { next?: unknown; reasoning?: unknown };\n      const rawNext = record.next;\n\n      const nextIsValid =\n        typeof rawNext === \"string\" ||\n        (Array.isArray(rawNext) && rawNext.every((element) => typeof element === \"string\"));\n\n      if (!nextIsValid) {\n        return {\n          issues: [\n            {\n              message: \"router output `next` must be a string, string[], or the END sentinel\",\n            },\n          ],\n        };\n      }\n\n      const reasoning = typeof record.reasoning === \"string\" ? record.reasoning : undefined;\n\n      return {\n        value: { next: rawNext as Next, reasoning },\n      };\n    },\n  } as StandardSchemaV1<{ next: Next; reasoning?: string }>[\"~standard\"] & {\n    jsonSchema: { input: () => Record<string, unknown> };\n  },\n};\n\nfunction wrapRouteError(supervisorName: string, thrown: unknown): AIError {\n  if (thrown instanceof AIError) {\n    return thrown;\n  }\n\n  const message = thrown instanceof Error ? thrown.message : String(thrown);\n\n  return new SupervisorFailedError(\n    `\\`route\\` callback threw in supervisor \"${supervisorName}\": ${message}`,\n    { cause: thrown },\n  );\n}\n","import { resolveDefaultStore } from \"../config\";\nimport type { IterationSnapshot } from \"../contracts/supervisor/iteration-snapshot.type\";\nimport type { SupervisorConfig } from \"../contracts/supervisor/supervisor-config.type\";\nimport type { SupervisorResumeOptions } from \"../contracts/supervisor/supervisor-execute-options.type\";\nimport type { SupervisorInput } from \"../contracts/supervisor/supervisor-input.type\";\nimport type {\n  SupervisorSnapshot,\n  SupervisorSnapshotStatus,\n} from \"../contracts/supervisor/supervisor-snapshot.type\";\nimport { SupervisorDriftError, SupervisorFailedError } from \"../errors\";\n\n/**\n * Resolve the effective snapshot store: the supervisor's own\n * `snapshotStore` field wins; absent that, fall back to the global\n * default set via `ai.config({ defaultStore })`.\n */\nfunction resolveSnapshotStore(config: SupervisorConfig<unknown>) {\n  return config.snapshotStore ?? resolveDefaultStore();\n}\n\nexport type PersistParams = {\n  config: SupervisorConfig<unknown>;\n  signature: string;\n  runId: string;\n  input: SupervisorInput;\n  startedAt: string;\n  iteration: number;\n  snapshots: IterationSnapshot[];\n  status: SupervisorSnapshotStatus;\n};\n\nexport type PersistOutcome = { ok: true } | { ok: false; error: unknown };\n\n/**\n * Write the current run state to the resolved snapshot store. No-op\n * (ok) when neither the supervisor's `snapshotStore` nor the global\n * `defaultStore` is configured. Failures are returned as\n * `{ ok: false }` rather than thrown so the engine can surface them\n * via events/logs without aborting the run — callers decide whether\n * a failed checkpoint is fatal.\n */\nexport async function persistSupervisorSnapshot(\n  params: PersistParams,\n): Promise<PersistOutcome> {\n  const store = resolveSnapshotStore(params.config);\n\n  if (!store) {\n    return { ok: true };\n  }\n\n  const snapshot: SupervisorSnapshot = {\n    runId: params.runId,\n    supervisorName: params.config.name,\n    signature: params.signature,\n    input: params.input,\n    iteration: params.iteration,\n    snapshots: params.snapshots,\n    status: params.status,\n    startedAt: params.startedAt,\n    savedAt: new Date().toISOString(),\n  };\n\n  try {\n    await store.set(snapshotKey(params.runId), snapshot);\n\n    return { ok: true };\n  } catch (error) {\n    return { ok: false, error };\n  }\n}\n\n/**\n * Load a persisted snapshot for `resume()` and run the drift check.\n * Throws `SupervisorFailedError` when no store is configured or when\n * the run is missing; throws `SupervisorDriftError` when the stored\n * signature doesn't match the current definition (unless `force` is\n * set).\n */\nexport async function loadSnapshotForResume(params: {\n  config: SupervisorConfig<unknown>;\n  signature: string;\n  runId: string;\n  options?: SupervisorResumeOptions;\n}): Promise<SupervisorSnapshot> {\n  const store = resolveSnapshotStore(params.config);\n\n  if (!store) {\n    throw new SupervisorFailedError(\n      `supervisor \"${params.config.name}\" has no store configured — set \\`snapshotStore\\` on the config or call \\`ai.config({ defaultStore })\\` at boot before calling resume()`,\n      { context: { runId: params.runId } },\n    );\n  }\n\n  const snapshot =\n    (await store.get<SupervisorSnapshot>(snapshotKey(params.runId))) ?? null;\n\n  if (!snapshot) {\n    throw new SupervisorFailedError(\n      `supervisor \"${params.config.name}\": no snapshot for runId \"${params.runId}\"`,\n      { context: { runId: params.runId } },\n    );\n  }\n\n  if (!params.options?.force && snapshot.signature !== params.signature) {\n    throw new SupervisorDriftError(\n      `supervisor \"${params.config.name}\" signature drift on resume`,\n      {\n        savedSignature: snapshot.signature,\n        currentSignature: params.signature,\n        runId: params.runId,\n      },\n    );\n  }\n\n  return snapshot;\n}\n\n/**\n * Canonical key shape used in the KVStore. Prefixed so supervisor\n * snapshots don't collide with workflow / session snapshots in a\n * shared store.\n */\nexport function snapshotKey(runId: string): string {\n  return `supervisor:${runId}`;\n}\n","import type { StandardSchemaV1 } from \"@standard-schema/spec\";\nimport { log, type Logger } from \"@warlock.js/logger\";\nimport type { AgentContract } from \"../contracts/agent/agent.contract\";\nimport type { Message } from \"../contracts/conversation-message.type\";\nimport { END } from \"../contracts/end.type\";\nimport type { EventIdentity, WithoutIdentity } from \"../contracts/events/event-identity.type\";\nimport type { SupervisorEventMap } from \"../contracts/events/event-map.type\";\nimport type { AgentResult } from \"../contracts/result/agent-result.type\";\nimport type { BaseReport } from \"../contracts/result/base-report.type\";\nimport type {\n  SupervisorReport,\n  SupervisorResult,\n  SupervisorTerminatedBy,\n} from \"../contracts/result/supervisor-result.type\";\nimport type { Usage } from \"../contracts/result/usage.type\";\nimport type { WorkflowResult } from \"../contracts/result/workflow-result.type\";\nimport type { StreamContract } from \"../contracts/stream/stream.contract\";\nimport type {\n  ClassifierConfig,\n  ClassifierContext,\n  ClassifierOutput,\n  ClassifierRefineContext,\n  ClassifierRefineResult,\n  ClassifierSnapshot,\n} from \"../contracts/supervisor/classifier-context.type\";\nimport type {\n  DispatchContext,\n  StreamableExecutable,\n  SupervisableExecutable,\n  SupervisableExecuteOptions,\n  SupervisableResult,\n} from \"../contracts/supervisor/dispatch-context.type\";\nimport type {\n  EvaluateBranchResult,\n  EvaluateContext,\n  EvaluateResult,\n} from \"../contracts/supervisor/evaluate-context.type\";\nimport type {\n  AckSnapshot,\n  AgentBranchSnapshot,\n  IterationSnapshot,\n} from \"../contracts/supervisor/iteration-snapshot.type\";\nimport type { RouteContext } from \"../contracts/supervisor/route-context.type\";\nimport type { SupervisorConfig } from \"../contracts/supervisor/supervisor-config.type\";\nimport type { SupervisorExecuteOptions } from \"../contracts/supervisor/supervisor-execute-options.type\";\nimport type { SupervisorInput } from \"../contracts/supervisor/supervisor-input.type\";\nimport type {\n  SupervisorSnapshot,\n  SupervisorSnapshotStatus,\n} from \"../contracts/supervisor/supervisor-snapshot.type\";\nimport type { WorkflowInstance } from \"../contracts/workflow/workflow.contract\";\nimport {\n  AIError,\n  MaxIterationsError,\n  SchemaValidationError,\n  SupervisorCancelledError,\n  SupervisorFailedError,\n} from \"../errors\";\nimport { stampReportLineage } from \"../utils\";\nimport { createCancelledError } from \"./cancellation\";\nimport { decide, type DispatchDecision } from \"./decide\";\nimport type { SupervisorEmitter } from \"./emitter\";\nimport type { ResolvedCallbackEntry, ResolvedIntentEntry } from \"./entries\";\nimport { isAgentResult, isWorkflowResult } from \"./entries\";\nimport { persistSupervisorSnapshot } from \"./snapshot\";\nimport type { SupervisorStreamController, SupervisorStreamEvent } from \"./supervisor-stream\";\n\nconst DEFAULT_MAX_ITERATIONS = 10;\nconst LOG_MODULE_BASE = \"ai.supervisor\";\n\nexport type SupervisorExecutionParams<TOutput> = {\n  config: SupervisorConfig<TOutput>;\n  entries: Map<string, ResolvedIntentEntry>;\n  signature: string;\n  emitter: SupervisorEmitter;\n  input: SupervisorInput;\n  runId: string;\n  options?: SupervisorExecuteOptions;\n  streamController?: SupervisorStreamController<SupervisorResult<TOutput>>;\n  resumeFrom?: SupervisorSnapshot;\n};\n\n/**\n * Per-call driver that owns the full lifecycle of one supervisor run.\n *\n * **Role.** Short-lived state container and phase orchestrator —\n * mirrors `agent/Execution` and `workflow/runWorkflow`, one level up.\n *\n * **Responsibility.**\n * - Owns: the iteration loop, per-iteration dispatch (single or\n *   fan-out), evaluate scheduling, usage aggregation across router +\n *   every branch + evaluate, snapshot collection, event emission\n *   through all three tiers, KV-store checkpointing, final result\n *   assembly (state validation against the output schema → typed data).\n * - Does NOT own: how child agents produce responses (delegated via\n *   `agent.execute` / `workflow.execute`), the routing decision\n *   itself (delegated to `decide.ts`), snapshot persistence mechanics\n *   (delegated to `snapshot.ts`), the stream queue plumbing\n *   (delegated to `supervisor-stream.ts`).\n *\n * `execute()` never throws — every unexpected failure funnels into\n * `this.error` and is returned on `result.error` with an appropriate\n * `SupervisorFailedError` / `MaxIterationsError` / `SupervisorRoutingError`\n * / `SupervisorCancelledError`.\n *\n * @example\n * // Inside supervisor.execute() — never constructed by user code directly:\n * return new SupervisorExecution(params).run();\n */\nexport class SupervisorExecution<TOutput> {\n  private readonly config: SupervisorConfig<TOutput>;\n  private readonly entries: Map<string, ResolvedIntentEntry>;\n  private readonly signature: string;\n  private readonly emitter: SupervisorEmitter;\n  private readonly input: SupervisorInput;\n  private readonly runId: string;\n  private readonly options?: SupervisorExecuteOptions;\n  private readonly streamController?: SupervisorStreamController<SupervisorResult<TOutput>>;\n  private readonly resumeFrom?: SupervisorSnapshot;\n\n  private readonly maxIterations: number;\n  private readonly logger: Logger = log;\n  private readonly logModule: string;\n\n  private readonly snapshots: IterationSnapshot[] = [];\n  private readonly childReports: BaseReport[] = [];\n  private readonly usage: Usage = { input: 0, output: 0, total: 0 };\n\n  private readonly startedAtIso: string;\n  private readonly startPerf = performance.now();\n\n  private iteration = 0;\n  private carriedFeedback?: EvaluateResult;\n  /**\n   * Per-intent `next` directive (Q24 / Stage 4d) collected at the\n   * end of an iteration after evaluate hasn't already steered. When\n   * set, `decideDispatch` consumes it on the next iteration's start —\n   * skipping the router entirely. Cleared after consumption.\n   *\n   * Only the dispatch variant is stored; an `END` collection\n   * terminates the iteration loop directly inside `runIteration`.\n   */\n  private carriedNextDispatch?: { intents: string[] };\n  private terminatedBy: SupervisorTerminatedBy = \"error\";\n  private status: SupervisorReport[\"status\"] = \"failed\";\n  private cancelledAtIso?: string;\n  private error?: AIError;\n  private data?: TOutput;\n  private lastDispatchIntents: string[] = [];\n  /**\n   * Per-execute typed accumulator. Initialized from `config.state`\n   * (default `{}`) at construction; rehydrated from the last\n   * snapshot's `state` on resume; mutated in-place as each iteration's\n   * intents strip-merge their outputs into it.\n   */\n  private state: Record<string, unknown> = {};\n  /**\n   * Per-iteration artifacts bag (Phase 5 / decisions §35). Tools\n   * dispatched within an iteration mutate `ctx.artifacts` — which\n   * points at this object. After the iteration's branches settle and\n   * their slices merge into state, this bag validates against\n   * `config.artifactsSchema` (if set) and merges via\n   * `config.finalizeArtifacts` or auto-spread, then resets to `{}`\n   * for the next iteration. The reset is crucial — long runs and\n   * orchestrator sessions never accumulate raw artifacts here.\n   */\n  private currentArtifacts: Record<string, unknown> = {};\n  /**\n   * Frozen copy of the iteration's `currentArtifacts` bag captured at\n   * merge time — BEFORE `finalizeArtifacts` (or auto-spread) reshaped\n   * it into state (Phase 8 / decisions §38). Surfaced on the iteration\n   * snapshot's `artifacts` field for forensic / telemetry consumers\n   * that want the raw tool contributions.\n   *\n   * Reset to `{}` at the start of every iteration so a snapshot built\n   * for an iteration whose tools wrote nothing carries an empty bag,\n   * not a stale carry-over.\n   */\n  private capturedIterationArtifacts: Readonly<Record<string, unknown>> = Object.freeze({});\n  /**\n   * Classifier (Phase 7 / decisions §37) forensic record. Set on iter\n   * 0 when `SupervisorConfig.classifier` is configured AND the run\n   * started fresh (resumes don't re-fire classifier — same as ack).\n   * Surfaced on `SupervisorReport.classifier` and threaded into\n   * `ctx.classifier` on RouteContext / DispatchContext /\n   * EvaluateContext from iter 0 onward.\n   */\n  private classifierSnapshot?: ClassifierSnapshot;\n  /**\n   * Iter-0 dispatch decision pre-computed by the classifier (Phase 7).\n   * When set, `decideDispatch` short-circuits and uses this directly\n   * with `source: \"classifier\"`. Cleared after consumption.\n   */\n  private carriedClassifierDispatch?: { intent: string };\n  /** Set true by classifier refine returning END to halt before any dispatch. */\n  private classifierHalted = false;\n  /**\n   * Receptionist forensic record. Set when an `ackAgent` was\n   * configured AND the run started fresh (resumes don't re-fire ack).\n   * Surfaced on `SupervisorReport.ack`.\n   */\n  private ackSnapshot?: AckSnapshot;\n  /**\n   * Read-only request-scoped context surfaced on every `ctx.context`.\n   * Shallow-copied + frozen at construction so callbacks see a stable\n   * snapshot of the caller's bag and can't mutate the original.\n   * Always present — defaults to a frozen `{}` when no context was\n   * passed. NOT persisted in snapshots.\n   */\n  private readonly context: Readonly<Record<string, unknown>>;\n  /**\n   * Prior conversation messages threaded through every callback context\n   * (`ctx.history`) and forwarded verbatim to dispatched agents (and the\n   * receptionist `ack` agent) as `agent.execute(input, { history })`.\n   * Frozen reference so callbacks see a stable view; not deep-cloned —\n   * conversation messages are treated as immutable by convention. NOT\n   * persisted in snapshots (re-supply on `resume()`).\n   */\n  private readonly history: ReadonlyArray<Message>;\n  /**\n   * Resolved natural-language objective from `SupervisorConfig.goal`.\n   * Materialized to plain text at construction (string passes through;\n   * `SystemPromptContract` is `.resolve()`-d). `undefined` when the\n   * supervisor was configured without a goal.\n   */\n  private readonly goal: string | undefined;\n\n  public constructor(params: SupervisorExecutionParams<TOutput>) {\n    this.config = params.config;\n    this.entries = params.entries;\n    this.signature = params.signature;\n    this.emitter = params.emitter;\n    this.input = params.input;\n    this.runId = params.runId;\n    this.options = params.options;\n    this.streamController = params.streamController;\n    this.resumeFrom = params.resumeFrom;\n\n    this.maxIterations = params.config.maxIterations ?? DEFAULT_MAX_ITERATIONS;\n    this.logModule = `${LOG_MODULE_BASE}.${params.config.name}`;\n\n    // Shallow-copy + freeze the caller's context. Shallow only —\n    // freezing deeply would break valid use cases (mutable DB\n    // clients, abort controllers) without delivering meaningful\n    // safety beyond what TS `Readonly` already enforces.\n    this.context = Object.freeze({ ...(params.options?.context ?? {}) });\n    // Freeze the array reference so callbacks can't mutate the slot\n    // (`history.push(...)`); messages themselves are passed by reference\n    // — supervisors trust the agent layer's read-only convention.\n    // Precedence: per-call `options.history` (most explicit) overrides\n    // factory-level `config.history` (default for callers who don't\n    // supply per-call history). Final fallback is an empty array.\n    this.history = Object.freeze([...(params.options?.history ?? params.config.history ?? [])]);\n\n    // Resolve `goal` to plain text once, at construction. `string`\n    // passes through; `SystemPromptContract` is `.resolve()`-d (it owns\n    // its own placeholder substitution). `undefined` when no goal was\n    // configured — every `ctx.goal` consumer must guard for absence.\n    if (typeof params.config.goal === \"string\") {\n      this.goal = params.config.goal;\n    } else if (params.config.goal) {\n      this.goal = params.config.goal.resolve();\n    } else {\n      this.goal = undefined;\n    }\n\n    if (params.resumeFrom) {\n      this.snapshots.push(...params.resumeFrom.snapshots);\n      this.iteration = params.resumeFrom.iteration + 1;\n      this.startedAtIso = params.resumeFrom.startedAt;\n      // Resume rehydrates state from the last persisted iteration —\n      // every iteration's snapshot carries the post-merge state, so\n      // the resume point's state is the last snapshot's state.\n      const lastSnapshot = params.resumeFrom.snapshots[params.resumeFrom.snapshots.length - 1];\n      this.state = {\n        ...(lastSnapshot?.state ??\n          (params.config.state as Record<string, unknown> | undefined) ??\n          {}),\n      };\n    } else {\n      this.startedAtIso = new Date().toISOString();\n      this.state = {\n        ...((params.config.state as Record<string, unknown> | undefined) ?? {}),\n      };\n    }\n  }\n\n  /**\n   * Resolve the history slice forwarded to a child execution (router /\n   * dispatched agent / ack). Precedence:\n   *\n   *   1. Per-entry `history` callback — full override; whatever it\n   *      returns goes through (after defensive copy).\n   *   2. `SupervisorConfig.historyWindow.<role>` — last-N slice of the\n   *      caller-supplied history.\n   *   3. Default — full history for `router`/`agents`, empty for `ack`\n   *      (receptionists rarely benefit from scroll-back).\n   *\n   * Always returns a fresh `Message[]` (the agent layer\n   * mutates by reference internally, e.g. via `messages.push(...)`).\n   */\n  private resolveHistoryFor(\n    role: \"router\" | \"agents\" | \"ack\",\n    routeContext: RouteContext,\n    entrySlicer?: (ctx: RouteContext) => Message[] | ReadonlyArray<Message>,\n  ): Message[] {\n    if (entrySlicer) {\n      const sliced = entrySlicer(routeContext);\n      return sliced ? [...sliced] : [];\n    }\n\n    const window = this.config.historyWindow?.[role];\n\n    if (role === \"ack\") {\n      // Default for ack is empty — receptionists rarely need history.\n      // Override is opt-in via `historyWindow.ack: N`.\n      if (window === undefined || window <= 0) {\n        return [];\n      }\n\n      return this.history.slice(-window);\n    }\n\n    if (window === undefined || window < 0) {\n      return [...this.history];\n    }\n\n    if (window === 0) {\n      return [];\n    }\n\n    return this.history.slice(-window);\n  }\n\n  /**\n   * Apply only the global `historyWindow.agents` slice — used by the\n   * recursive `ctx.intents.X.execute()` re-entry path where no\n   * `RouteContext` is available to feed the per-entry slicer.\n   */\n  private applyAgentsWindow(): Message[] {\n    const window = this.config.historyWindow?.agents;\n\n    if (window === undefined || window < 0) {\n      return [...this.history];\n    }\n\n    if (window === 0) {\n      return [];\n    }\n\n    return this.history.slice(-window);\n  }\n\n  /**\n   * Entry point. Drives the iteration loop, finalizes the result, and\n   * emits terminal events. Returns the uniform\n   * `{ data, report, usage, error }` shape and closes the stream if\n   * one was attached. Never throws.\n   */\n  public async run(): Promise<SupervisorResult<TOutput>> {\n    this.emit(\"supervisor.starting\", {\n      supervisorName: this.config.name,\n      input: this.input,\n    });\n\n    this.logger.info(this.logModule, \"starting\", \"supervisor starting\", {\n      runId: this.runId,\n      maxIterations: this.maxIterations,\n    });\n\n    try {\n      await this.runIterationLoop();\n    } catch (thrown) {\n      this.error = toAIError(thrown);\n      this.status = this.error instanceof SupervisorCancelledError ? \"cancelled\" : \"failed\";\n      this.terminatedBy = this.error instanceof SupervisorCancelledError ? \"cancelled\" : \"error\";\n\n      if (this.error instanceof SupervisorCancelledError) {\n        this.cancelledAtIso = this.error.cancelledAt;\n      }\n\n      if (this.error instanceof MaxIterationsError) {\n        this.status = \"max-iterations\";\n        this.terminatedBy = \"max-iterations\";\n      }\n    }\n\n    const result = await this.finalize();\n\n    if (result.error) {\n      if (this.status === \"cancelled\") {\n        this.emit(\"supervisor.cancelled\", {\n          cancelledAt: this.cancelledAtIso ?? new Date().toISOString(),\n          reason: (result.error as SupervisorCancelledError).reason,\n        });\n      } else {\n        this.emit(\"supervisor.error\", { error: result.error });\n      }\n    }\n\n    this.emit(\"supervisor.completed\", { result });\n\n    this.streamController?.end(result);\n\n    this.logger.info(this.logModule, \"completed\", \"supervisor completed\", {\n      runId: this.runId,\n      status: this.status,\n      iterations: this.snapshots.length,\n      duration: performance.now() - this.startPerf,\n    });\n\n    return result;\n  }\n\n  /**\n   * Drive the iteration loop until a terminal condition fires:\n   * `END` / `satisfied:true` / `maxIterations` / signal abort /\n   * routing error. Between-iteration cancellation is guaranteed —\n   * the signal is checked before every iteration starts.\n   */\n  private async runIterationLoop(): Promise<void> {\n    while (this.iteration < this.maxIterations) {\n      this.throwIfCancelled();\n\n      const continued = await this.runIteration();\n\n      if (!continued) {\n        return;\n      }\n\n      this.iteration += 1;\n    }\n\n    throw new MaxIterationsError(\n      `supervisor \"${this.config.name}\" exceeded maxIterations=${this.maxIterations}`,\n      { maxIterations: this.maxIterations },\n    );\n  }\n\n  /**\n   * Run one iteration end-to-end: decide → dispatch → evaluate →\n   * snapshot. Returns `true` when the loop should continue to the\n   * next iteration, `false` when this iteration terminated the run\n   * (success or satisfied-verdict). Failures throw — the loop's\n   * outer catch converts them into typed errors on the result.\n   */\n  private async runIteration(): Promise<boolean> {\n    const iterationStartedAt = new Date();\n    const iterationStart = performance.now();\n    const iterationUsage: Usage = { input: 0, output: 0, total: 0 };\n\n    // Phase 8 / decisions §38 — reset the captured-artifacts forensic\n    // surface at iteration start so a snapshot built for an iteration\n    // whose tools wrote nothing carries an empty bag, not a stale\n    // carry-over from the prior iteration. `mergeArtifactsIntoState`\n    // refreshes this with the live bag (frozen) before merge.\n    this.capturedIterationArtifacts = Object.freeze({});\n\n    this.emit(\"supervisor.iteration.starting\", { iteration: this.iteration });\n\n    // Kick off the receptionist (`ack`) in parallel with phase A's\n    // dispatch decision — fires on iter 0 only when the run is fresh\n    // (resumes don't re-emit; user already saw the original ack). The\n    // promise is NOT awaited inline — `settleAck` probes it\n    // non-blockingly later so a slow ack never extends total wall-\n    // clock time. If ack hasn't settled by the probe point, its slice\n    // is abandoned with a warning + error on the report.\n    const ackPromise =\n      this.iteration === 0 && !this.resumeFrom && this.config.ack ? this.runAck() : undefined;\n\n    // Phase 7 / decisions §37 — classifier prelude. Runs once on iter 0\n    // for fresh runs only (resumes inherit the prior classifier output\n    // via state + report.classifier). Awaited inline because its\n    // output drives the iter-0 dispatch decision; ack remains\n    // non-blocking parallel by design.\n    if (this.iteration === 0 && !this.resumeFrom && this.config.classifier) {\n      await this.runClassifier();\n\n      if (this.classifierHalted) {\n        // Refine returned END (or classifier-alone mode interpreted\n        // an END signal). Settle ack, mark terminated, capture a\n        // synthetic decision snapshot, and exit the loop. State may\n        // already carry refine's slice — do not clobber.\n        await this.settleAck(ackPromise, iterationUsage);\n        this.terminatedBy = \"classifier\";\n        this.status = \"completed\";\n\n        await this.recordTerminalDecisionSnapshot(\n          {\n            kind: \"end\",\n            source: \"classifier\",\n            raw: END,\n            durationMs: 0,\n          },\n          iterationStartedAt,\n          iterationStart,\n          iterationUsage,\n        );\n\n        return false;\n      }\n    }\n\n    const decision = await this.decideDispatch();\n\n    this.aggregateUsage(iterationUsage, decision.usage);\n\n    if (decision.kind === \"end\") {\n      await this.settleAck(ackPromise, iterationUsage);\n      this.terminatedBy = decision.source === \"route\" ? \"route\" : \"router\";\n      this.status = \"completed\";\n\n      await this.recordTerminalDecisionSnapshot(\n        decision,\n        iterationStartedAt,\n        iterationStart,\n        iterationUsage,\n      );\n\n      return false;\n    }\n\n    const branchSnapshots = await this.dispatchBranches(decision);\n\n    for (const snapshot of branchSnapshots) {\n      this.aggregateUsage(iterationUsage, snapshot.usage);\n    }\n\n    // Settle ack (if kicked off) before phase C merge. Probe is\n    // non-blocking — `setImmediate` yields one macrotask cycle so an\n    // already-resolved ack wins via microtask priority; otherwise the\n    // probe returns NOT_READY and ack is abandoned (slice dropped,\n    // warning logged, error captured on `report.ack`). Specialist\n    // branches override the receptionist on key collision either way.\n    await this.settleAck(ackPromise, iterationUsage);\n\n    // Merge branch outputs into supervisor state in decision.intents\n    // order so fan-out conflict resolution is deterministic — last\n    // intent in the array wins on key collisions (Q15). Errored\n    // branches don't contribute. Entries without an `output` schema\n    // (agent/workflow) are NOT auto-merged — declaring the slice is\n    // opt-in. Callbacks always merge (their full return value when\n    // no schema; strip-merged when schema is declared) — they had\n    // their schema applied inside runCallback already.\n    this.mergeBranchesIntoState(decision.intents, branchSnapshots);\n\n    // Phase 5 / decisions §35 — merge tool-side artifacts into state\n    // AFTER branch slices land but BEFORE evaluate runs, so the\n    // evaluate verdict sees the post-merge state including blocks /\n    // citations / soft signals contributed by tools. Resets the bag\n    // for the next iteration; long runs and orchestrator sessions\n    // never accumulate raw artifacts.\n    await this.mergeArtifactsIntoState();\n\n    this.lastDispatchIntents = decision.intents;\n\n    const evaluateVerdict = await this.runEvaluate(branchSnapshots);\n\n    if (evaluateVerdict !== undefined && evaluateVerdict !== null) {\n      this.emit(\"supervisor.evaluate.verdict\", {\n        iteration: this.iteration,\n        verdict: evaluateVerdict,\n      });\n    }\n\n    const iterationEndedAt = new Date();\n    const duration = performance.now() - iterationStart;\n\n    const snapshot: IterationSnapshot = Object.freeze({\n      iteration: this.iteration,\n      result: indexByIntent(branchSnapshots),\n      decision: {\n        source: decision.source,\n        next: decision.raw,\n        reasoning: decision.reasoning,\n        durationMs: decision.durationMs,\n      },\n      evaluateVerdict,\n      state: { ...this.state },\n      artifacts: this.capturedIterationArtifacts,\n      startedAt: iterationStartedAt.toISOString(),\n      endedAt: iterationEndedAt.toISOString(),\n      duration,\n      usage: iterationUsage,\n    });\n\n    this.snapshots.push(snapshot);\n\n    this.emit(\"supervisor.iteration.completed\", {\n      iteration: this.iteration,\n      snapshot,\n    });\n\n    await this.checkpoint(\"running\");\n\n    if (evaluateVerdict?.satisfied) {\n      this.terminatedBy = \"evaluate\";\n      this.status = \"completed\";\n\n      return false;\n    }\n\n    this.carriedFeedback = evaluateVerdict;\n\n    // Stage 4d (Q24): when evaluate hasn't taken a stance via\n    // `reassignTo`, collect each branch's `intent.next(ctx)` to drive\n    // the next iteration without a router call. Evaluate's\n    // `reassignTo` outranks `next` — if evaluate forced a target,\n    // `next` doesn't get to vote.\n    const evaluateForcedReassign =\n      evaluateVerdict?.reassignTo !== undefined &&\n      normalizeReassign(evaluateVerdict.reassignTo).length > 0;\n\n    if (!evaluateForcedReassign) {\n      const collected = this.collectIntentNext(decision.intents, branchSnapshots);\n\n      if (collected?.kind === \"end\") {\n        this.terminatedBy = \"route\";\n        this.status = \"completed\";\n        this.carriedNextDispatch = undefined;\n        return false;\n      }\n\n      if (collected?.kind === \"dispatch\") {\n        this.carriedNextDispatch = { intents: collected.intents };\n      }\n    }\n\n    // Phase 7 / decisions §37 — classifier-alone supervisor auto-\n    // terminates after iter 0's branch settles. Without router/route,\n    // there's no decision source for iter 1; preempt the throw with\n    // a clean termination. `intent.next` from iter 0's dispatched\n    // intent still wins if it set a continuation (rare, but allowed).\n    if (\n      this.iteration === 0 &&\n      this.config.classifier &&\n      !this.config.router &&\n      !this.config.route &&\n      !this.carriedNextDispatch\n    ) {\n      this.terminatedBy = \"classifier\";\n      this.status = \"completed\";\n\n      return false;\n    }\n\n    return true;\n  }\n\n  /**\n   * Resolve the dispatch decision for this iteration — defers to\n   * `decide.ts`. When `carriedFeedback.reassignTo` is set the\n   * supervisor overrides the router/route decision with an\n   * evaluator-forced dispatch (design §2 — \"Evaluate can override\n   * router\").\n   */\n  private async decideDispatch(): Promise<DispatchDecision> {\n    if (this.config.router) {\n      this.emit(\"supervisor.router.deciding\", { iteration: this.iteration });\n    }\n\n    const reassignTo = normalizeReassign(this.carriedFeedback?.reassignTo);\n\n    if (reassignTo.length > 0) {\n      this.carriedNextDispatch = undefined;\n      for (const intent of reassignTo) {\n        if (!this.entries.has(intent)) {\n          throw new SupervisorFailedError(\n            `evaluate.reassignTo targeted unknown agent \"${intent}\"`,\n            { context: { available: [...this.entries.keys()] } },\n          );\n        }\n      }\n\n      const decision: DispatchDecision = {\n        kind: \"dispatch\",\n        intents: reassignTo,\n        source: \"route\",\n        raw: reassignTo.length === 1 ? reassignTo[0] : reassignTo,\n        durationMs: 0,\n      };\n\n      this.emit(\"supervisor.router.decided\", {\n        iteration: this.iteration,\n        next: decision.raw,\n        reasoning: this.carriedFeedback?.feedback,\n        durationMs: 0,\n      });\n\n      return decision;\n    }\n\n    // Phase 7 / decisions §37 — classifier prelude (iter 0 only)\n    // produced an intent dispatch decision. Skip router/route /\n    // initialAgent entirely; classifier's pick wins. Cleared after\n    // consumption — iter 1+ falls through to router/route as usual.\n    if (this.carriedClassifierDispatch) {\n      const carried = this.carriedClassifierDispatch;\n      this.carriedClassifierDispatch = undefined;\n\n      const decision: DispatchDecision = {\n        kind: \"dispatch\",\n        intents: [carried.intent],\n        source: \"classifier\",\n        raw: carried.intent,\n        durationMs: 0,\n      };\n\n      this.emit(\"supervisor.router.decided\", {\n        iteration: this.iteration,\n        next: decision.raw,\n        reasoning: this.classifierSnapshot?.reasoning,\n        durationMs: 0,\n      });\n\n      return decision;\n    }\n\n    // Stage 4d: per-intent `next` collected from the previous\n    // iteration drives this dispatch — skip router/route entirely.\n    if (this.carriedNextDispatch) {\n      const carried = this.carriedNextDispatch;\n      this.carriedNextDispatch = undefined;\n\n      const decision: DispatchDecision = {\n        kind: \"dispatch\",\n        intents: carried.intents,\n        source: \"route\",\n        raw: carried.intents.length === 1 ? carried.intents[0] : carried.intents,\n        durationMs: 0,\n      };\n\n      this.emit(\"supervisor.router.decided\", {\n        iteration: this.iteration,\n        next: decision.raw,\n        reasoning: undefined,\n        durationMs: 0,\n      });\n\n      return decision;\n    }\n\n    const decision = await decide({\n      config: this.config as SupervisorConfig<unknown>,\n      entries: this.entries,\n      iteration: this.iteration,\n      maxIterations: this.maxIterations,\n      iterations: this.snapshots,\n      input: this.input,\n      state: this.state,\n      context: this.context,\n      history: this.history,\n      goal: this.goal,\n      evaluateFeedback: this.carriedFeedback,\n      classifier: this.classifierSnapshot,\n      signal: this.options?.signal,\n      useInitialAgent: this.iteration === 0 && !this.resumeFrom,\n    });\n\n    // Capture the router agent's report into the supervisor's tree so\n    // router cost + internals are observable alongside dispatched\n    // branches. Only present when decide() went through a router agent.\n    if (decision.routerReport) {\n      this.childReports.push(decision.routerReport);\n    }\n\n    this.emit(\"supervisor.router.decided\", {\n      iteration: this.iteration,\n      next: decision.raw,\n      reasoning: decision.reasoning,\n      durationMs: decision.durationMs,\n    });\n\n    return decision;\n  }\n\n  /**\n   * Dispatch every intent named by the decision in parallel. Per-\n   * branch errors don't abort siblings — they're recorded on the\n   * branch snapshot and let evaluate (or default termination logic)\n   * decide the response.\n   */\n  private async dispatchBranches(\n    decision: DispatchDecision & { kind: \"dispatch\" },\n  ): Promise<AgentBranchSnapshot[]> {\n    const branches = await Promise.all(decision.intents.map((intent) => this.dispatchOne(intent)));\n\n    return branches;\n  }\n\n  /**\n   * Execute a single branch — resolve the input, invoke the\n   * agent / workflow / callback, apply the per-intent `output`\n   * transformer, and produce an immutable `AgentBranchSnapshot`.\n   */\n  private async dispatchOne(intent: string): Promise<AgentBranchSnapshot> {\n    const entry = this.entries.get(intent)!;\n\n    if (entry.type === \"callback\") {\n      return this.dispatchCallback(entry);\n    }\n\n    const routeContext: RouteContext = {\n      iteration: this.iteration,\n      input: this.input,\n      state: this.state,\n      iterations: this.snapshots,\n      feedback:\n        typeof this.carriedFeedback?.feedback === \"string\"\n          ? this.carriedFeedback.feedback\n          : undefined,\n      evaluateFeedback: this.carriedFeedback,\n      context: this.context,\n      history: this.history,\n      goal: this.goal,\n      classifier: this.classifierSnapshot,\n    };\n\n    const resolvedInput = this.resolveBranchInput(entry, routeContext);\n    const dispatchCtxForPlaceholders = this.seedDispatchContext(\n      intent,\n      resolvedInput,\n      new Set<string>([intent]),\n      [],\n    );\n    const placeholders = entry.placeholders\n      ? entry.placeholders(dispatchCtxForPlaceholders)\n      : undefined;\n\n    this.emit(\"supervisor.agent.starting\", {\n      iteration: this.iteration,\n      intent,\n      input: resolvedInput,\n    });\n\n    const startedAt = new Date();\n    const startPerf = performance.now();\n\n    let rawResult: AgentResult<unknown> | WorkflowResult<unknown> | undefined;\n    let branchError: AIError | undefined;\n    let branchUsage: Usage = { input: 0, output: 0, total: 0 };\n\n    try {\n      rawResult = await this.invokeUnit(entry, resolvedInput, placeholders, routeContext);\n\n      if (rawResult.error) {\n        branchError = rawResult.error;\n      }\n\n      branchUsage = rawResult.usage;\n\n      // Capture the child's execution report into the supervisor's\n      // recursive tree. Each dispatched agent/workflow contributes\n      // one BaseReport node; fan-out produces sibling children.\n      if (rawResult.report) {\n        this.childReports.push(rawResult.report);\n      }\n    } catch (thrown) {\n      branchError = toAIError(thrown);\n    }\n\n    const sliceOutcome = await this.applyOutputSchema(entry, rawResult);\n    const transformedOutput = sliceOutcome.value;\n    if (sliceOutcome.error && !branchError) {\n      branchError = sliceOutcome.error;\n    }\n    const endedAt = new Date();\n    const duration = performance.now() - startPerf;\n\n    const snapshot: AgentBranchSnapshot = Object.freeze({\n      intent,\n      input: resolvedInput,\n      output: transformedOutput,\n      usage: branchUsage,\n      startedAt: startedAt.toISOString(),\n      endedAt: endedAt.toISOString(),\n      duration,\n      error: branchError,\n    });\n\n    if (branchError) {\n      this.emit(\"supervisor.agent.failed\", {\n        iteration: this.iteration,\n        intent,\n        error: branchError,\n      });\n    } else {\n      this.emit(\"supervisor.agent.completed\", {\n        iteration: this.iteration,\n        intent,\n        output: transformedOutput,\n        usage: branchUsage,\n        duration,\n      });\n    }\n\n    return snapshot;\n  }\n\n  /**\n   * Dispatch a callback intent as a top-level branch — produces an\n   * `AgentBranchSnapshot` and pushes the synthesized callback report\n   * onto the supervisor's recursive children. Delegates the actual\n   * callback invocation to {@link runCallback} so nested\n   * `ctx.intents.X.execute()` calls can reuse the same machinery.\n   *\n   * Each branch dispatch starts with a fresh per-branch call stack —\n   * sibling fan-out branches don't share cycle-detection state, so\n   * branch A and branch B both invoking the same intent isn't a\n   * cycle. The branch's own intent name is seeded onto the stack so\n   * a callback that re-enters itself via `ctx.intents.X.execute()` trips\n   * cycle detection on the first recursion.\n   */\n  private async dispatchCallback(entry: ResolvedCallbackEntry): Promise<AgentBranchSnapshot> {\n    const intent = entry.intent;\n    const callStack = new Set<string>([intent]);\n    const callbackInput = entry.input\n      ? entry.input(this.seedDispatchContext(intent, this.input, callStack, []))\n      : this.input;\n    const inputForSnapshot =\n      typeof callbackInput === \"string\" ? callbackInput : safeStringify(callbackInput);\n\n    this.emit(\"supervisor.agent.starting\", {\n      iteration: this.iteration,\n      intent,\n      input: inputForSnapshot,\n    });\n\n    const outcome = await this.runCallback(entry, callbackInput, callStack, this.childReports);\n\n    const snapshot: AgentBranchSnapshot = Object.freeze({\n      intent,\n      input: inputForSnapshot,\n      output: outcome.output,\n      usage: outcome.report.usage,\n      startedAt: outcome.report.startedAt,\n      endedAt: outcome.report.endedAt,\n      duration: outcome.report.duration,\n      error: outcome.error,\n    });\n\n    if (outcome.error) {\n      this.emit(\"supervisor.agent.failed\", {\n        iteration: this.iteration,\n        intent,\n        error: outcome.error,\n      });\n    } else {\n      this.emit(\"supervisor.agent.completed\", {\n        iteration: this.iteration,\n        intent,\n        output: outcome.output,\n        usage: outcome.report.usage,\n        duration: outcome.report.duration,\n      });\n    }\n\n    return snapshot;\n  }\n\n  /**\n   * Run a callback intent and produce its leaf report + final\n   * output. Used both for top-level branch dispatch (via\n   * {@link dispatchCallback}) and for nested `dispatch.byName`\n   * recursion. The synthesized report is appended to `reportSink`,\n   * which is either `this.childReports` (top-level) or the calling\n   * callback's own `children[]` (nested) — that's what gives the\n   * unified report tree its compositional shape.\n   *\n   * Usage on the report rolls up children's usage; the callback\n   * itself contributes zero (it's dev code, no token spend).\n   */\n  private async runCallback(\n    entry: ResolvedCallbackEntry,\n    input: unknown,\n    callStack: Set<string>,\n    reportSink: BaseReport[],\n  ): Promise<{ output: unknown; error?: AIError; report: BaseReport }> {\n    const childReports: BaseReport[] = [];\n    const dispatchCtx: DispatchContext = this.seedDispatchContext(\n      entry.intent,\n      input,\n      callStack,\n      childReports,\n    );\n\n    const startedAt = new Date();\n    const startPerf = performance.now();\n\n    let rawOutput: unknown;\n    let error: AIError | undefined;\n\n    try {\n      rawOutput = await entry.callback(dispatchCtx);\n    } catch (thrown) {\n      error =\n        thrown instanceof AIError\n          ? thrown\n          : new SupervisorFailedError(\n              `callback intent \"${entry.intent}\" threw: ${\n                thrown instanceof Error ? thrown.message : String(thrown)\n              }`,\n              { cause: thrown },\n            );\n    }\n\n    let transformedOutput: unknown = rawOutput;\n\n    if (!error && entry.output) {\n      const validation = await entry.output[\"~standard\"].validate(rawOutput);\n      if (validation.issues) {\n        error = new SchemaValidationError(\n          `intent \"${entry.intent}\" output failed validation: ${validation.issues\n            .map((issue) => issue.message)\n            .join(\"; \")}`,\n          { issues: validation.issues },\n        );\n        transformedOutput = undefined;\n      } else {\n        transformedOutput = validation.value;\n      }\n    }\n\n    const endedAt = new Date();\n    const duration = performance.now() - startPerf;\n    const rolledUsage = aggregateChildUsage(childReports);\n\n    const report: BaseReport = {\n      runId: `${this.runId}.${entry.intent}`,\n      rootRunId: this.runId,\n      name: entry.intent,\n      type: \"callback\",\n      status: error ? \"failed\" : \"completed\",\n      startedAt: startedAt.toISOString(),\n      endedAt: endedAt.toISOString(),\n      duration,\n      usage: rolledUsage,\n      children: childReports,\n    };\n\n    reportSink.push(report);\n\n    return { output: transformedOutput, error, report };\n  }\n\n  /**\n   * Build a {@link DispatchContext} with a typed `intents` map of\n   * `IntentRunner` closures, each closing over the supplied call\n   * stack and report sink. Cycle detection uses the call stack —\n   * re-entering an intent already on it throws\n   * `SupervisorFailedError` with code `SUPERVISOR_DISPATCH_CYCLE`\n   * and the offending chain in the message.\n   *\n   * Replaces the Phase-3.3 `ctx.dispatch.byName` plumbing with\n   * property-access on a typed map (Q5/Q6) — autocomplete, no typo\n   * crashes, `.execute()` matches every other primitive's verb.\n   */\n  private seedDispatchContext(\n    intent: string,\n    input: unknown,\n    callStack: Set<string>,\n    reportSink: BaseReport[],\n  ): DispatchContext {\n    type RunnerSlot = {\n      execute: (input?: unknown) => Promise<unknown>;\n      stream: (input?: unknown) => unknown;\n    };\n    const intentsMap: Record<string, RunnerSlot> = {};\n\n    for (const target of this.entries.keys()) {\n      intentsMap[target] = {\n        execute: (override?: unknown) =>\n          this.runIntent(target, override === undefined ? input : override, callStack, reportSink),\n        stream: (override?: unknown) =>\n          this.streamIntent(\n            target,\n            override === undefined ? input : override,\n            callStack,\n            reportSink,\n            intent,\n          ),\n      };\n    }\n\n    return {\n      iteration: this.iteration,\n      intent,\n      input,\n      state: this.state,\n      result: {},\n      iterations: this.snapshots,\n      signal: this.options?.signal ?? new AbortController().signal,\n      intents: intentsMap as DispatchContext[\"intents\"],\n      context: this.context,\n      history: this.history,\n      goal: this.goal,\n      run: (executable, runInput, runOptions) =>\n        this.runInline(executable, runInput, runOptions, callStack, reportSink),\n      stream: (executable, runInput, runOptions) =>\n        this.streamInline(executable, runInput, runOptions, callStack, reportSink, intent),\n      classifier: this.classifierSnapshot,\n    } as DispatchContext;\n  }\n\n  /**\n   * Backing implementation for `ctx.intents.X.execute(input?)`.\n   * Looks up the named intent in the supervisor's registry, asserts\n   * the call wouldn't close a cycle, and runs the dispatchable\n   * through the same machinery a top-level branch would — except\n   * the resulting report nests under the calling callback's\n   * `children[]` rather than the supervisor's top-level child list,\n   * and only the final output is returned (no snapshot).\n   */\n  private async runIntent(\n    target: string,\n    callerInput: unknown,\n    callStack: Set<string>,\n    reportSink: BaseReport[],\n  ): Promise<unknown> {\n    if (callStack.has(target)) {\n      const chain = [...callStack, target].join(\" → \");\n      throw new SupervisorFailedError(\n        `ctx.intents.${target}.execute: cycle detected (${chain})`,\n        { context: { intent: target } },\n        \"SUPERVISOR_DISPATCH_CYCLE\",\n      );\n    }\n\n    const entry = this.entries.get(target);\n\n    if (!entry) {\n      throw new SupervisorFailedError(\n        `ctx.intents.${target}.execute: unknown intent \"${target}\" — must be a key in the supervisor's \\`intents\\` map`,\n        { context: { intent: target } },\n      );\n    }\n\n    callStack.add(target);\n\n    try {\n      if (entry.type === \"callback\") {\n        const { output, error } = await this.runCallback(entry, callerInput, callStack, reportSink);\n\n        if (error) {\n          throw error;\n        }\n\n        return output;\n      }\n\n      // Agent / workflow path. The unified-report tree gets the\n      // child's report under the calling callback's children — we\n      // intentionally do NOT also push to `this.childReports` (that\n      // would double-count). The agent/workflow's own usage flows\n      // up through the callback's roll-up.\n      const inputString =\n        typeof callerInput === \"string\" ? callerInput : safeStringify(callerInput);\n\n      if (entry.type === \"agent\") {\n        // Recursive `ctx.intents.X.execute()` re-entry path — no\n        // `RouteContext` constructed here, so the per-entry slicer is\n        // skipped; only the global `historyWindow.agents` window\n        // applies. The original outer dispatch already passed a sliced\n        // view; this sub-call mirrors that behavior.\n        const reentryHistory = this.applyAgentsWindow();\n        const result = await entry.unit.execute(inputString, {\n          signal: this.options?.signal,\n          ...(reentryHistory.length > 0 ? { history: reentryHistory } : {}),\n        });\n\n        if (result.report) {\n          reportSink.push(result.report);\n        }\n\n        if (result.error) {\n          throw result.error;\n        }\n\n        return result.data ?? result.text ?? undefined;\n      }\n\n      // workflow\n      const result = await entry.unit.execute(inputString as never, {\n        signal: this.options?.signal,\n      });\n\n      if (result.report) {\n        reportSink.push(result.report);\n      }\n\n      if (result.error) {\n        throw result.error;\n      }\n\n      return result.data;\n    } finally {\n      callStack.delete(target);\n    }\n  }\n\n  /**\n   * Backing implementation for `ctx.intents.X.stream(input?)` (Phase 6\n   * / decisions §36). Streaming sibling of {@link runIntent} — same\n   * cycle protection, same auto-merge of supervisor-level concerns,\n   * but routes through the unit's `.stream()` method when available\n   * and bubbles deltas as `supervisor.agent.streaming` under the\n   * **calling callback's** intent name (not the dispatched intent's).\n   */\n  private streamIntent(\n    target: string,\n    callerInput: unknown,\n    callStack: Set<string>,\n    reportSink: BaseReport[],\n    callerIntent: string,\n  ): StreamContract<SupervisableResult> {\n    if (callStack.has(target)) {\n      const chain = [...callStack, target].join(\" → \");\n      throw new SupervisorFailedError(\n        `ctx.intents.${target}.stream: cycle detected (${chain})`,\n        { context: { intent: target } },\n        \"SUPERVISOR_DISPATCH_CYCLE\",\n      );\n    }\n\n    const entry = this.entries.get(target);\n\n    if (!entry) {\n      throw new SupervisorFailedError(\n        `ctx.intents.${target}.stream: unknown intent \"${target}\" — must be a key in the supervisor's \\`intents\\` map`,\n        { context: { intent: target } },\n      );\n    }\n\n    if (entry.type === \"callback\") {\n      throw new SupervisorFailedError(\n        `ctx.intents.${target}.stream: callback intents are not streamable — use \\`.execute(input?)\\` instead`,\n        { context: { intent: target } },\n      );\n    }\n\n    callStack.add(target);\n\n    const inputString = typeof callerInput === \"string\" ? callerInput : safeStringify(callerInput);\n\n    return this.streamSupervisedExecutable(\n      entry.unit as StreamableExecutable,\n      inputString,\n      undefined,\n      callerIntent,\n      reportSink,\n      () => callStack.delete(target),\n    );\n  }\n\n  /**\n   * Backing implementation for `ctx.run(executable, input, options?)`\n   * (Phase 6 / decisions §36). Runs an inline / un-registered\n   * executable under supervision: auto-merges `signal`, `toolCtx`,\n   * `history` defaults; nests the resulting report under the\n   * calling callback's `children[]`. Per-call options REPLACE auto-\n   * defaults — standard Warlock convention.\n   *\n   * Cycle protection by executable `name` matches the registered-\n   * intent path so a callback that recurses on the same agent trips\n   * the same error, regardless of whether the agent was looked up\n   * via `ctx.intents.X.execute()` or passed inline.\n   */\n  private async runInline(\n    executable: SupervisableExecutable,\n    input: unknown,\n    options: SupervisableExecuteOptions | undefined,\n    callStack: Set<string>,\n    reportSink: BaseReport[],\n  ): Promise<SupervisableResult> {\n    const name = executable.name;\n\n    if (callStack.has(name)) {\n      const chain = [...callStack, name].join(\" → \");\n      throw new SupervisorFailedError(\n        `ctx.run(\"${name}\"): cycle detected (${chain})`,\n        { context: { intent: name } },\n        \"SUPERVISOR_DISPATCH_CYCLE\",\n      );\n    }\n\n    callStack.add(name);\n\n    try {\n      const merged = this.mergeInlineOptions(options);\n      const inputForExecutable = this.coerceInlineInput(executable, input);\n      const result = (await (\n        executable as {\n          execute: (input: unknown, options?: unknown) => Promise<SupervisableResult>;\n        }\n      ).execute(inputForExecutable, merged)) as SupervisableResult;\n\n      if (result.report) {\n        reportSink.push(result.report);\n      }\n\n      return result;\n    } finally {\n      callStack.delete(name);\n    }\n  }\n\n  /**\n   * Backing implementation for `ctx.stream(executable, input, options?)`\n   * (Phase 6 / decisions §36). Streaming sibling of {@link runInline}.\n   * Routes through the executable's native `.stream()` method,\n   * subscribes to delta events, and bubbles them as\n   * `supervisor.agent.streaming` under the calling callback's intent\n   * name. The returned `StreamContract` is the executable's own —\n   * iteration and `.result` work identically.\n   *\n   * Cycle protection on entry mirrors {@link runInline}; release runs\n   * after `.result` settles so a same-callback recursion is caught\n   * regardless of which path closed the cycle.\n   */\n  private streamInline(\n    executable: StreamableExecutable,\n    input: unknown,\n    options: SupervisableExecuteOptions | undefined,\n    callStack: Set<string>,\n    reportSink: BaseReport[],\n    callerIntent: string,\n  ): StreamContract<SupervisableResult> {\n    const name = executable.name;\n\n    if (callStack.has(name)) {\n      const chain = [...callStack, name].join(\" → \");\n      throw new SupervisorFailedError(\n        `ctx.stream(\"${name}\"): cycle detected (${chain})`,\n        { context: { intent: name } },\n        \"SUPERVISOR_DISPATCH_CYCLE\",\n      );\n    }\n\n    callStack.add(name);\n\n    return this.streamSupervisedExecutable(\n      executable,\n      this.coerceInlineInput(executable, input),\n      options,\n      callerIntent,\n      reportSink,\n      () => callStack.delete(name),\n    );\n  }\n\n  /**\n   * Shared wiring for both `ctx.intents.X.stream()` and\n   * `ctx.stream(...)`. Subscribes to the executable's stream, re-\n   * emits deltas as `supervisor.agent.streaming` under the calling\n   * callback's intent name, and pushes the inner report onto the\n   * reportSink once `.result` settles. The returned StreamContract\n   * is the executable's own — the framework attaches handlers\n   * transparently via `.on(...)`.\n   */\n  private streamSupervisedExecutable(\n    executable: StreamableExecutable,\n    input: unknown,\n    options: SupervisableExecuteOptions | undefined,\n    callerIntent: string,\n    reportSink: BaseReport[],\n    release: () => void,\n  ): StreamContract<SupervisableResult> {\n    const merged = this.mergeInlineOptions(options);\n    const stream = (\n      executable as {\n        stream: (input: unknown, options?: unknown) => StreamContract<SupervisableResult>;\n      }\n    ).stream(input, merged);\n\n    // Bubble inner deltas under the CALLING callback's intent name.\n    // Agents fire `agent.trip.streaming`; supervisors fire\n    // `supervisor.agent.streaming` already — the inner intent name\n    // there is the inner supervisor's specialist, which we replace\n    // with the outer callback's name so attribution is consistent.\n    const handlers: Record<string, (event: { delta: string }) => void> = {\n      \"agent.trip.streaming\": ({ delta }) => {\n        this.emit(\"supervisor.agent.streaming\", {\n          iteration: this.iteration,\n          intent: callerIntent,\n          delta,\n        });\n      },\n      \"supervisor.agent.streaming\": ({ delta }) => {\n        this.emit(\"supervisor.agent.streaming\", {\n          iteration: this.iteration,\n          intent: callerIntent,\n          delta,\n        });\n      },\n    };\n\n    stream.on(handlers);\n\n    // Always release the cycle-protection slot after `.result` settles\n    // (success OR failure) so subsequent calls in the same callback\n    // see a clean stack. Push report on success.\n    void stream.result.then(\n      (result) => {\n        if (result?.report) {\n          reportSink.push(result.report);\n        }\n\n        release();\n      },\n      () => release(),\n    );\n\n    return stream;\n  }\n\n  /**\n   * Build the options object passed into an inline `.execute()` /\n   * `.stream()` call. Auto-merges supervisor-level defaults\n   * (`signal`, `toolCtx`, `history` window) under the caller's\n   * options. Per-call values REPLACE the auto-defaults — when the\n   * dev passes `signal: undefined` they explicitly opt out.\n   */\n  private mergeInlineOptions(\n    options: SupervisableExecuteOptions | undefined,\n  ): SupervisableExecuteOptions {\n    const supplied = (options ?? {}) as Record<string, unknown>;\n    const merged: Record<string, unknown> = { ...supplied };\n\n    if (!(\"signal\" in supplied)) {\n      merged.signal = this.options?.signal;\n    }\n\n    if (!(\"toolCtx\" in supplied)) {\n      merged.toolCtx = {\n        artifacts: this.currentArtifacts,\n        signal: this.options?.signal,\n      };\n    }\n\n    if (!(\"history\" in supplied)) {\n      const window = this.applyAgentsWindow();\n\n      if (window.length > 0) {\n        merged.history = window;\n      }\n    }\n\n    return merged as SupervisableExecuteOptions;\n  }\n\n  /**\n   * Coerce an arbitrary inline input into the shape the underlying\n   * executable expects. Agents take `string`; workflows + supervisors\n   * take whatever they declared. We safe-stringify objects only when\n   * passing to an agent — workflow / supervisor calls hand the value\n   * through unchanged so structured inputs work.\n   */\n  private coerceInlineInput(executable: SupervisableExecutable, input: unknown): unknown {\n    // Agents are the only kind that strictly require string input.\n    // Workflows / supervisors accept arbitrary shapes.\n    const isAgent =\n      !(\"signature\" in executable) &&\n      typeof executable.execute === \"function\" &&\n      !this.isSupervisor(executable);\n\n    if (isAgent && typeof input !== \"string\") {\n      return safeStringify(input);\n    }\n\n    return input;\n  }\n\n  /**\n   * Heuristic detection of `SupervisorContract` — the contract carries\n   * a `signature` getter same as workflows, but supervisors expose\n   * `resume()` while workflows expose `resume(runId, options)` too.\n   * Cleanest distinguisher in the public surface: supervisors carry\n   * the `asTool` method name `as` … unfortunately so do workflows.\n   * Use the `streamableType` brand if we add one in v2; for now lean\n   * on a duck-typed check that's good enough for the ctx.run path\n   * (incorrect routing for workflows would still produce a runnable\n   * call — workflow.execute accepts the same args either way).\n   */\n  private isSupervisor(executable: SupervisableExecutable): boolean {\n    return (\n      typeof (executable as { resume?: unknown; signature?: unknown }).resume === \"function\" &&\n      typeof (executable as { signature?: unknown }).signature === \"string\" &&\n      typeof (executable as { stream?: unknown }).stream === \"function\"\n    );\n  }\n\n  /**\n   * Invoke the underlying dispatchable unit. Agents and workflows\n   * both satisfy `ExecutableContract<string, …>` so the call shape\n   * is uniform; the `type` discriminator picks which options get\n   * threaded through (e.g. per-call stream event bubbling for\n   * agents, which we wire inline so child agent tokens surface as\n   * `supervisor.agent.streaming`).\n   */\n  private async invokeUnit(\n    entry: Exclude<ResolvedIntentEntry, ResolvedCallbackEntry>,\n    input: string,\n    placeholders: Record<string, unknown> | undefined,\n    routeContext: RouteContext,\n  ): Promise<AgentResult<unknown> | WorkflowResult<unknown>> {\n    // When the supervisor itself is being streamed by the caller, run\n    // the child agent in streaming mode too — that's the only way\n    // token deltas surface up the tree as `supervisor.agent.streaming`\n    // events. `agent.execute()` always uses `model.complete()` which\n    // never fires `agent.trip.streaming`, so wiring a callback there\n    // is a silent no-op for tokens. Lifecycle events (trip.started /\n    // tool.called / completed) still fire through `.on()` regardless\n    // — they're driven by orchestration boundaries, not the wire mode.\n    const isStreaming = this.streamController !== undefined;\n\n    if (entry.type === \"agent\") {\n      // `type` and `unit` aren't a discriminated union on the entry\n      // type — narrow manually. `resolveIntentEntries` guarantees\n      // `unit` matches `type` at runtime.\n      const agent = entry.unit as AgentContract<unknown>;\n      const handlers = {\n        \"agent.trip.streaming\": ({ delta }: { delta: string }) => {\n          this.emit(\"supervisor.agent.streaming\", {\n            iteration: this.iteration,\n            intent: entry.intent,\n            delta,\n          });\n        },\n      };\n\n      // Phase 5 / decisions §34 — stream-mode intents drop the\n      // structured-output schema (factory already rejects coexistence)\n      // and always run via `agent.stream()` so token deltas surface as\n      // `supervisor.agent.streaming` events regardless of whether the\n      // top-level caller streamed the supervisor.\n      const isStreamMode = entry.mode === \"stream\";\n\n      // Stage 4b/4d: forward `intent.output` as the agent's per-call\n      // output schema when declared. The agent then parses model\n      // output as structured data; `applyOutputSchema` re-validates\n      // (cheap) and strip-merges into supervisor state.\n      const resolvedHistory = this.resolveHistoryFor(\"agents\", routeContext, entry.history);\n      const agentOptions = {\n        signal: this.options?.signal,\n        on: handlers,\n        ...(placeholders ? { placeholders } : {}),\n        ...(entry.output && !isStreamMode ? { output: entry.output } : {}),\n        ...(resolvedHistory.length > 0 ? { history: resolvedHistory } : {}),\n        toolCtx: {\n          artifacts: this.currentArtifacts,\n          signal: this.options?.signal,\n        },\n      };\n\n      if (isStreamMode || isStreaming) {\n        const childStream = agent.stream(input, agentOptions);\n        return childStream.result;\n      }\n\n      return agent.execute(input, agentOptions);\n    }\n\n    const workflow = entry.unit as WorkflowInstance<unknown, unknown>;\n\n    return workflow.execute(input, {\n      signal: this.options?.signal,\n      on: {\n        \"workflow.step.streaming\": ({ delta }) => {\n          this.emit(\"supervisor.agent.streaming\", {\n            iteration: this.iteration,\n            intent: entry.intent,\n            delta,\n          });\n        },\n      },\n    });\n  }\n\n  /**\n   * Build the input string passed to a branch's child execution.\n   * Default: pass the supervisor's original `ctx.input` through\n   * unchanged. The per-intent `entry.input` override is the escape\n   * hatch for the rare case where the agent's user message itself\n   * must vary per intent.\n   *\n   * Q17 lock: dropped `composeAgentInput` + `defaultComposeAgentInput`.\n   * Their three jobs (carry original / prior outputs / feedback) all\n   * have cleaner homes in the new model — original is the input\n   * itself, prior outputs are state (Stage 4b), feedback is a\n   * router-only signal (Q18).\n   */\n  private resolveBranchInput(\n    entry: Exclude<ResolvedIntentEntry, ResolvedCallbackEntry>,\n    ctx: RouteContext,\n  ): string {\n    const override = entry.input?.(ctx);\n\n    if (typeof override === \"string\") {\n      return override;\n    }\n\n    // Q1: supervisor-level input may be an object payload. Agents\n    // need a string — JSON-stringify when no per-intent override\n    // converted it. Devs wanting a different shape supply\n    // `entry.input(ctx)`.\n    return typeof ctx.input === \"string\" ? ctx.input : safeStringify(ctx.input);\n  }\n\n  /**\n   * Strip-merge the agent/workflow's raw output against the per-intent\n   * `output` schema (Q11/Q13). Returns the validated slice that:\n   *\n   *   1. Lands on `IterationSnapshot.result[intent].output` (so\n   *      consumers see the same shape that hit state).\n   *   2. Shallow-merges into `this.state` (handled by the caller).\n   *\n   * When `entry.output` is omitted the agent's full `data` (or `text`\n   * fallback for unstructured agents) flows through unvalidated — but\n   * is NOT auto-merged into state. State contribution is opt-in via\n   * declaring the slice schema.\n   *\n   * Validation failure surfaces as a per-branch error on the\n   * snapshot; sibling branches still run.\n   */\n  private async applyOutputSchema(\n    entry: Exclude<ResolvedIntentEntry, ResolvedCallbackEntry>,\n    raw: AgentResult<unknown> | WorkflowResult<unknown> | undefined,\n  ): Promise<{ value: unknown; error?: AIError }> {\n    if (!raw) {\n      return { value: undefined };\n    }\n\n    const sourceValue = isAgentResult(raw)\n      ? (raw.data ?? raw.text ?? undefined)\n      : isWorkflowResult(raw)\n        ? raw.data\n        : undefined;\n\n    // Phase 5 / decisions §34 — stream-mode agents have no `output`\n    // schema. The assembled prose comes back as `raw.text` (the agent\n    // never produced structured `data` because we dropped the schema\n    // in `invokeUnit`). Wrap it as `{ [streamTo]: text }` so the\n    // existing strip-merge path lands the prose under the named state\n    // key without further special-casing downstream.\n    if (entry.type === \"agent\" && entry.mode === \"stream\") {\n      const text = typeof sourceValue === \"string\" ? sourceValue : \"\";\n\n      return { value: { [entry.streamTo as string]: text } };\n    }\n\n    if (!entry.output) {\n      return { value: sourceValue };\n    }\n\n    const validation = await entry.output[\"~standard\"].validate(sourceValue);\n\n    if (validation.issues) {\n      return {\n        value: undefined,\n        error: new SchemaValidationError(\n          `intent \"${entry.intent}\" output failed validation: ${validation.issues\n            .map((issue) => issue.message)\n            .join(\"; \")}`,\n          { issues: validation.issues },\n        ),\n      };\n    }\n\n    return { value: validation.value };\n  }\n\n  /**\n   * Fire the receptionist (`ack`) — runs in parallel with phase A on\n   * iteration 0 only. Accepts three shapes:\n   *\n   * - `AckEntry` — `{ agent, placeholders?, input?, output? }`. LLM\n   *   form. Streams tokens via `supervisor.ack.streaming`; report\n   *   node pushes onto `childReports[]`.\n   * - `AckRunEntry` — `{ run, output? }`. Pure-code callback. Settles\n   *   without an LLM call. No streaming events; just `.completed`.\n   * - `AckCallback` — bare `(ctx) => slice` shorthand for the\n   *   pure-code form when no schema is declared.\n   *\n   * Failures are recorded but never abort the run — the receptionist\n   * tripping doesn't stop the specialist from doing the actual job.\n   * The returned outcome is what `mergeAckIntoState` consumes.\n   */\n  private async runAck(): Promise<\n    | {\n        output: unknown;\n        usage: Usage;\n        duration: number;\n        error?: AIError;\n      }\n    | undefined\n  > {\n    const ack = this.config.ack;\n    if (!ack) return undefined;\n\n    const routeContext: RouteContext = {\n      iteration: this.iteration,\n      input: this.input,\n      state: this.state,\n      iterations: this.snapshots,\n      feedback:\n        typeof this.carriedFeedback?.feedback === \"string\"\n          ? this.carriedFeedback.feedback\n          : undefined,\n      evaluateFeedback: this.carriedFeedback,\n      context: this.context,\n      history: this.history,\n      goal: this.goal,\n      classifier: this.classifierSnapshot,\n    };\n\n    const startedAt = new Date();\n    const startPerf = performance.now();\n\n    // Bare-callback shorthand: `ack: (ctx) => slice`.\n    if (typeof ack === \"function\") {\n      return this.runAckCallback(\n        ack as (ctx: RouteContext) => unknown | Promise<unknown>,\n        undefined,\n        routeContext,\n        startedAt,\n        startPerf,\n      );\n    }\n\n    // Run-entry form: `ack: { run, output? }`.\n    if (\"run\" in ack && typeof (ack as { run?: unknown }).run === \"function\") {\n      const runEntry = ack as {\n        run: (ctx: RouteContext) => unknown | Promise<unknown>;\n        output?: StandardSchemaV1<unknown>;\n      };\n      return this.runAckCallback(runEntry.run, runEntry.output, routeContext, startedAt, startPerf);\n    }\n\n    // Agent-entry form: `ack: { agent, placeholders?, input?, output? }`.\n    return this.runAckAgent(\n      ack as {\n        agent: import(\"../contracts/agent/agent.contract\").AgentContract<unknown>;\n        placeholders?: (ctx: RouteContext) => Record<string, unknown>;\n        input?: (ctx: RouteContext) => string;\n        output?: StandardSchemaV1<unknown>;\n        history?: (ctx: RouteContext) => Message[] | ReadonlyArray<Message>;\n      },\n      routeContext,\n      startedAt,\n      startPerf,\n    );\n  }\n\n  /**\n   * Pure-code receptionist path — invokes the callback, strip-validates\n   * the return value (when an `output` schema is declared), records the\n   * snapshot, emits `supervisor.ack.completed`, returns the outcome.\n   * No streaming events fire (callbacks settle synchronously from the\n   * supervisor's POV).\n   */\n  private async runAckCallback(\n    run: (ctx: RouteContext) => unknown | Promise<unknown>,\n    output: StandardSchemaV1<unknown> | undefined,\n    routeContext: RouteContext,\n    startedAt: Date,\n    startPerf: number,\n  ): Promise<{\n    output: unknown;\n    usage: Usage;\n    duration: number;\n    error?: AIError;\n  }> {\n    const usage: Usage = { input: 0, output: 0, total: 0 };\n    let validatedOutput: unknown;\n    let ackError: AIError | undefined;\n\n    try {\n      const raw = await run(routeContext);\n\n      if (output) {\n        const validation = await output[\"~standard\"].validate(raw);\n        if (validation.issues) {\n          ackError = new SchemaValidationError(\n            `ack output failed validation: ${validation.issues\n              .map((issue) => issue.message)\n              .join(\"; \")}`,\n            { issues: validation.issues },\n          );\n        } else {\n          validatedOutput = validation.value;\n        }\n      } else {\n        validatedOutput = raw;\n      }\n    } catch (thrown) {\n      ackError = toAIError(thrown);\n    }\n\n    const endedAt = new Date();\n    const duration = performance.now() - startPerf;\n\n    this.ackSnapshot = Object.freeze({\n      input: typeof this.input === \"string\" ? this.input : safeStringify(this.input),\n      output: validatedOutput,\n      usage,\n      startedAt: startedAt.toISOString(),\n      endedAt: endedAt.toISOString(),\n      duration,\n      error: ackError,\n    });\n\n    this.emit(\"supervisor.ack.completed\", {\n      output: validatedOutput,\n      usage,\n      duration,\n      error: ackError,\n    });\n\n    return { output: validatedOutput, usage, duration, error: ackError };\n  }\n\n  /**\n   * Agent-driven receptionist path — invokes the agent, streams tokens\n   * via `supervisor.ack.streaming`, captures the report node, strip-\n   * validates against `output` (when declared), records the snapshot,\n   * emits `supervisor.ack.completed`.\n   */\n  private async runAckAgent(\n    ack: {\n      agent: import(\"../contracts/agent/agent.contract\").AgentContract<unknown>;\n      placeholders?: (ctx: RouteContext) => Record<string, unknown>;\n      input?: (ctx: RouteContext) => string;\n      output?: StandardSchemaV1<unknown>;\n      history?: (ctx: RouteContext) => Message[] | ReadonlyArray<Message>;\n    },\n    routeContext: RouteContext,\n    startedAt: Date,\n    startPerf: number,\n  ): Promise<{\n    output: unknown;\n    usage: Usage;\n    duration: number;\n    error?: AIError;\n  }> {\n    const placeholders = ack.placeholders?.(routeContext);\n    const inputForAck =\n      ack.input?.(routeContext) ??\n      (typeof this.input === \"string\" ? this.input : safeStringify(this.input));\n\n    const isStreaming = this.streamController !== undefined;\n\n    const handlers = {\n      \"agent.trip.streaming\": ({ delta }: { delta: string }) => {\n        this.emit(\"supervisor.ack.streaming\", { delta });\n      },\n    };\n\n    const resolvedHistory = this.resolveHistoryFor(\"ack\", routeContext, ack.history);\n    const agentOptions = {\n      signal: this.options?.signal,\n      on: handlers,\n      ...(placeholders ? { placeholders } : {}),\n      ...(ack.output ? { output: ack.output } : {}),\n      ...(resolvedHistory.length > 0 ? { history: resolvedHistory } : {}),\n    };\n\n    let rawResult: AgentResult<unknown> | undefined;\n    let ackError: AIError | undefined;\n    let usage: Usage = { input: 0, output: 0, total: 0 };\n\n    try {\n      if (isStreaming) {\n        const childStream = ack.agent.stream(inputForAck, agentOptions);\n        rawResult = await childStream.result;\n      } else {\n        rawResult = await ack.agent.execute(inputForAck, agentOptions);\n      }\n\n      if (rawResult.error) {\n        ackError = rawResult.error;\n      }\n\n      usage = rawResult.usage ?? usage;\n\n      // Ack agent's report node in the supervisor's recursive tree.\n      if (rawResult.report) {\n        this.childReports.push(rawResult.report);\n      }\n    } catch (thrown) {\n      ackError = toAIError(thrown);\n    }\n\n    const endedAt = new Date();\n    const duration = performance.now() - startPerf;\n\n    // Strip-validate against `ack.output` (when declared) — same\n    // contract as per-intent output schemas.\n    let validatedOutput: unknown;\n    if (rawResult && !ackError && ack.output) {\n      const sourceValue = rawResult.data ?? rawResult.text ?? undefined;\n      const validation = await ack.output[\"~standard\"].validate(sourceValue);\n      if (validation.issues) {\n        ackError = new SchemaValidationError(\n          `ack output failed validation: ${validation.issues\n            .map((issue) => issue.message)\n            .join(\"; \")}`,\n          { issues: validation.issues },\n        );\n      } else {\n        validatedOutput = validation.value;\n      }\n    } else if (rawResult && !ackError) {\n      validatedOutput = rawResult.data ?? rawResult.text ?? undefined;\n    }\n\n    this.ackSnapshot = Object.freeze({\n      input: inputForAck,\n      output: validatedOutput,\n      usage,\n      startedAt: startedAt.toISOString(),\n      endedAt: endedAt.toISOString(),\n      duration,\n      error: ackError,\n    });\n\n    this.emit(\"supervisor.ack.completed\", {\n      output: validatedOutput,\n      usage,\n      duration,\n      error: ackError,\n    });\n\n    return { output: validatedOutput, usage, duration, error: ackError };\n  }\n\n  /**\n   * Probe the ack promise non-blockingly. Yields one macrotask cycle\n   * (`setImmediate`) so an already-resolved ack wins via microtask\n   * priority; if the probe returns first, the slice is abandoned —\n   * warning logged, error captured on `report.ack`, run completes\n   * regardless. Specialists own the actual answer; the receptionist\n   * was just a reassuring preview.\n   */\n  private async settleAck(\n    ackPromise:\n      | Promise<{ output: unknown; usage: Usage; duration: number; error?: AIError } | undefined>\n      | undefined,\n    iterationUsage: Usage,\n  ): Promise<void> {\n    if (!ackPromise) return;\n\n    const NOT_READY = Symbol(\"ack-not-ready\");\n    const probe = await Promise.race([\n      ackPromise,\n      new Promise<typeof NOT_READY>((resolve) => setTimeout(() => resolve(NOT_READY), 0)),\n    ]);\n\n    if (probe === NOT_READY) {\n      this.logger.warn(\n        this.logModule,\n        \"ack.abandoned\",\n        \"ack receptionist did not settle before iteration completed; slice dropped\",\n      );\n      const abandonedAt = new Date();\n      this.ackSnapshot = Object.freeze({\n        input: typeof this.input === \"string\" ? this.input : safeStringify(this.input),\n        output: undefined,\n        usage: { input: 0, output: 0, total: 0 },\n        startedAt: abandonedAt.toISOString(),\n        endedAt: abandonedAt.toISOString(),\n        duration: 0,\n        error: new SupervisorFailedError(\n          \"ack receptionist did not settle before iteration completed\",\n          { context: { ackAbandoned: true } },\n        ),\n      });\n      return;\n    }\n\n    const ackOutcome = probe;\n    if (ackOutcome) {\n      this.aggregateUsage(iterationUsage, ackOutcome.usage);\n      this.mergeAckIntoState(ackOutcome);\n    }\n  }\n\n  /**\n   * Merge the receptionist's strip-validated slice into state. Called\n   * from `settleAck` BEFORE branch merges so specialists override the\n   * receptionist on key collision — the receptionist hedges, the\n   * specialist commits.\n   */\n  private mergeAckIntoState(ackOutcome: { output: unknown; error?: AIError }): void {\n    if (ackOutcome.error || !ackOutcome.output) return;\n\n    if (typeof ackOutcome.output !== \"object\" || ackOutcome.output === null) return;\n\n    const slice = ackOutcome.output as Record<string, unknown>;\n\n    for (const [key, value] of Object.entries(slice)) {\n      this.state[key] = value;\n    }\n  }\n\n  /**\n   * Run the iter-0 classifier prelude (Phase 7 / decisions §37).\n   * Resolves the configured classifier (agent / callback / entry\n   * form), invokes it, runs the optional `refine` post-process hook,\n   * and either:\n   *\n   *   - sets `carriedClassifierDispatch` so the upcoming\n   *     `decideDispatch` short-circuits to the chosen intent, OR\n   *   - sets `classifierHalted = true` so `runIteration` terminates\n   *     before any dispatch (refine returned `END`).\n   *\n   * Captures the full forensic record on `classifierSnapshot` —\n   * surfaced on `SupervisorReport.classifier` and threaded into\n   * `ctx.classifier` on every downstream context.\n   *\n   * Errors in the classifier OR the refine hook abort the run with\n   * a `SupervisorFailedError` so issues surface loudly instead of\n   * silently falling through to router/route.\n   */\n  private async runClassifier(): Promise<void> {\n    const startedAt = new Date();\n    const startPerf = performance.now();\n    const startedAtIso = startedAt.toISOString();\n\n    this.emit(\"supervisor.classifier.starting\", { iteration: 0 });\n\n    const ctx = this.buildClassifierContext();\n    const config = this.config.classifier as ClassifierConfig;\n\n    let raw: ClassifierOutput | undefined;\n    let usage: Usage = { input: 0, output: 0, total: 0 };\n    let executionError: AIError | undefined;\n\n    try {\n      const outcome = await this.invokeClassifier(config, ctx);\n      raw = outcome.output;\n      usage = outcome.usage;\n    } catch (thrown) {\n      executionError = toAIError(thrown);\n    }\n\n    if (executionError || !raw) {\n      const error =\n        executionError ??\n        new SupervisorFailedError(\n          `ai.supervisor(\"${this.config.name}\"): classifier produced no output`,\n          { context: { iteration: 0 } },\n        );\n\n      this.classifierSnapshot = {\n        intent: undefined,\n        refined: false,\n        halted: true,\n        raw: raw ?? { intent: \"\" },\n        startedAt: startedAtIso,\n        endedAt: new Date().toISOString(),\n        duration: performance.now() - startPerf,\n        usage,\n        error,\n      };\n\n      this.aggregateUsage(this.usage, usage);\n\n      this.emit(\"supervisor.classifier.failed\", { error });\n\n      // Classifier failure aborts the run — no fallback to router/route.\n      // Phase 7 / decisions §37.\n      throw error;\n    }\n\n    // Validate the classifier's chosen intent against the registry\n    // before running refine — refine may override, but we still want\n    // to fail fast on raw classifier output that targets nothing.\n    if (!this.entries.has(raw.intent)) {\n      const error = new SupervisorFailedError(\n        `ai.supervisor(\"${this.config.name}\"): classifier picked unknown intent \"${raw.intent}\" — must be a key in \\`intents\\``,\n        { context: { iteration: 0, available: [...this.entries.keys()] } },\n        \"SUPERVISOR_INVALID_ROUTE\",\n      );\n\n      this.classifierSnapshot = {\n        intent: undefined,\n        refined: false,\n        halted: true,\n        raw,\n        startedAt: startedAtIso,\n        endedAt: new Date().toISOString(),\n        duration: performance.now() - startPerf,\n        usage,\n        error,\n      };\n\n      this.aggregateUsage(this.usage, usage);\n\n      this.emit(\"supervisor.classifier.failed\", { error });\n\n      throw error;\n    }\n\n    // Refine pass — optional. Refine receives the classifier output\n    // on `ctx.result.data` plus `run` / `stream` for inline secondary\n    // classifiers. Returns: undefined (use as-is) | END (halt) |\n    // { intent?, ...slice } (override + merge).\n    const refineHook = this.resolveRefineHook(config);\n    let final: ClassifierOutput = raw;\n    let refined = false;\n    let halted = false;\n\n    if (refineHook) {\n      let refineResult: ClassifierRefineResult;\n\n      try {\n        refineResult = await refineHook(this.buildClassifierRefineContext(ctx, raw));\n      } catch (thrown) {\n        const error = toAIError(thrown);\n\n        this.classifierSnapshot = {\n          intent: undefined,\n          refined: false,\n          halted: true,\n          raw,\n          startedAt: startedAtIso,\n          endedAt: new Date().toISOString(),\n          duration: performance.now() - startPerf,\n          usage,\n          error,\n        };\n\n        this.aggregateUsage(this.usage, usage);\n\n        this.emit(\"supervisor.classifier.failed\", { error });\n\n        throw error;\n      }\n\n      const interpretation = this.interpretRefineResult(refineResult, raw);\n\n      if (interpretation.error) {\n        this.classifierSnapshot = {\n          intent: undefined,\n          refined: true,\n          halted: true,\n          raw,\n          startedAt: startedAtIso,\n          endedAt: new Date().toISOString(),\n          duration: performance.now() - startPerf,\n          usage,\n          error: interpretation.error,\n        };\n\n        this.aggregateUsage(this.usage, usage);\n\n        this.emit(\"supervisor.classifier.failed\", { error: interpretation.error });\n\n        throw interpretation.error;\n      }\n\n      refined = interpretation.refined;\n      halted = interpretation.halted;\n      final = interpretation.final ?? raw;\n\n      // Merge refine's slice into state BEFORE dispatching — refine\n      // can augment state (e.g. detected language) regardless of\n      // override-vs-keep decision.\n      if (interpretation.sliceToMerge) {\n        for (const [key, value] of Object.entries(interpretation.sliceToMerge)) {\n          this.state[key] = value;\n        }\n      }\n    }\n\n    // Always merge the (possibly refined) classifier output's\n    // remaining fields into state — universal locked fields (intent,\n    // reasoning, confidence) plus any dev-extended fields. Subject\n    // to the supervisor's `output` schema validation at finalize.\n    for (const [key, value] of Object.entries(final)) {\n      this.state[key] = value;\n    }\n\n    this.classifierSnapshot = {\n      intent: halted ? undefined : final.intent,\n      reasoning: final.reasoning,\n      confidence: final.confidence,\n      refined,\n      halted,\n      raw,\n      startedAt: startedAtIso,\n      endedAt: new Date().toISOString(),\n      duration: performance.now() - startPerf,\n      usage,\n    };\n\n    this.aggregateUsage(this.usage, usage);\n\n    this.emit(\"supervisor.classifier.completed\", {\n      output: {\n        intent: this.classifierSnapshot.intent,\n        reasoning: this.classifierSnapshot.reasoning,\n        confidence: this.classifierSnapshot.confidence,\n      },\n      intent: this.classifierSnapshot.intent,\n      refined,\n      halted,\n      duration: this.classifierSnapshot.duration,\n      usage,\n    });\n\n    if (halted) {\n      this.classifierHalted = true;\n\n      return;\n    }\n\n    // Validate the FINAL intent against the registry — refine may\n    // have overridden to an unknown name. Throw loudly.\n    if (!this.entries.has(final.intent)) {\n      const error = new SupervisorFailedError(\n        `ai.supervisor(\"${this.config.name}\"): classifier.refine returned unknown intent \"${final.intent}\" — must be a key in \\`intents\\``,\n        { context: { iteration: 0, available: [...this.entries.keys()] } },\n        \"SUPERVISOR_INVALID_ROUTE\",\n      );\n\n      this.classifierSnapshot = { ...this.classifierSnapshot, halted: true, error };\n      this.classifierHalted = true;\n\n      this.emit(\"supervisor.classifier.failed\", { error });\n\n      throw error;\n    }\n\n    this.carriedClassifierDispatch = { intent: final.intent };\n  }\n\n  /**\n   * Resolve the configured classifier into a callable that returns\n   * `{ output, usage }`. Handles the four accepted shapes — bare\n   * agent / bare callback / agent-entry / run-entry. Pure shape\n   * normalization; no side effects.\n   */\n  private async invokeClassifier(\n    config: ClassifierConfig,\n    ctx: ClassifierContext,\n  ): Promise<{ output: ClassifierOutput; usage: Usage }> {\n    // (a) Bare callback shorthand.\n    if (typeof config === \"function\") {\n      const output = await (\n        config as (ctx: ClassifierContext) => Promise<ClassifierOutput> | ClassifierOutput\n      )(ctx);\n\n      return { output, usage: { input: 0, output: 0, total: 0 } };\n    }\n\n    // (b) Run-entry — `{ run, refine? }`.\n    if (typeof (config as { run?: unknown }).run === \"function\") {\n      const runFn = (\n        config as { run: (ctx: ClassifierContext) => Promise<ClassifierOutput> | ClassifierOutput }\n      ).run;\n      const output = await runFn(ctx);\n\n      return { output, usage: { input: 0, output: 0, total: 0 } };\n    }\n\n    // (c) Agent-entry — `{ agent, placeholders?, input?, history?, refine? }`.\n    if (typeof (config as { agent?: { execute?: unknown } }).agent?.execute === \"function\") {\n      const entry = config as {\n        agent: AgentContract<unknown>;\n        placeholders?: (ctx: ClassifierContext) => Record<string, unknown>;\n        input?: (ctx: ClassifierContext) => string;\n        history?: (ctx: ClassifierContext) => Message[] | ReadonlyArray<Message>;\n      };\n\n      return this.invokeClassifierAgent(\n        entry.agent,\n        ctx,\n        entry.placeholders,\n        entry.input,\n        entry.history,\n      );\n    }\n\n    // (d) Bare agent shorthand.\n    if (typeof (config as { execute?: unknown }).execute === \"function\") {\n      return this.invokeClassifierAgent(config as AgentContract<unknown>, ctx);\n    }\n\n    throw new SupervisorFailedError(\n      `ai.supervisor(\"${this.config.name}\"): \\`classifier\\` is not an agent, callback, or entry object`,\n      { context: { authoring: true } },\n    );\n  }\n\n  /**\n   * Invoke a classifier agent with the supervisor's standard wiring\n   * — placeholders, input override, history slicing, signal,\n   * streaming bubble. Output schema validation belongs to the agent\n   * itself; we just pull the typed `data` (or fall back to parsing\n   * `text`) and assert the locked `intent` field.\n   */\n  private async invokeClassifierAgent(\n    agent: AgentContract<unknown>,\n    ctx: ClassifierContext,\n    placeholders?: (ctx: ClassifierContext) => Record<string, unknown>,\n    inputResolver?: (ctx: ClassifierContext) => string,\n    historySlicer?: (ctx: ClassifierContext) => Message[] | ReadonlyArray<Message>,\n  ): Promise<{ output: ClassifierOutput; usage: Usage }> {\n    const inputForAgent =\n      inputResolver?.(ctx) ??\n      (typeof ctx.input === \"string\" ? ctx.input : safeStringify(ctx.input));\n\n    const history = historySlicer ? [...historySlicer(ctx)] : this.applyAgentsWindow();\n\n    const isStreaming = this.streamController !== undefined;\n\n    const handlers = {\n      \"agent.trip.streaming\": ({ delta }: { delta: string }) => {\n        this.emit(\"supervisor.classifier.streaming\", { delta });\n      },\n    };\n\n    const agentOptions = {\n      signal: this.options?.signal,\n      on: handlers,\n      ...(placeholders ? { placeholders: placeholders(ctx) } : {}),\n      ...(history.length > 0 ? { history } : {}),\n    };\n\n    let result: AgentResult<unknown>;\n\n    if (isStreaming) {\n      result = await agent.stream(inputForAgent, agentOptions).result;\n    } else {\n      result = await agent.execute(inputForAgent, agentOptions);\n    }\n\n    if (result.error) {\n      throw result.error;\n    }\n\n    if (result.report) {\n      this.childReports.push(result.report);\n    }\n\n    const data = result.data ?? result.text ?? undefined;\n    const output = this.coerceClassifierOutput(data);\n\n    return { output, usage: result.usage };\n  }\n\n  /**\n   * Coerce an agent's output into the locked classifier shape.\n   * Accepts a typed object with `intent` (the canonical case) or a\n   * plain string (interpreted as the intent name with no reasoning).\n   * Throws `SupervisorFailedError` if neither shape matches.\n   */\n  private coerceClassifierOutput(data: unknown): ClassifierOutput {\n    if (typeof data === \"string\") {\n      return { intent: data };\n    }\n\n    if (\n      data &&\n      typeof data === \"object\" &&\n      typeof (data as { intent?: unknown }).intent === \"string\"\n    ) {\n      const record = data as Record<string, unknown>;\n\n      return {\n        intent: record.intent as string,\n        reasoning: typeof record.reasoning === \"string\" ? (record.reasoning as string) : undefined,\n        confidence:\n          typeof record.confidence === \"number\" ? (record.confidence as number) : undefined,\n      };\n    }\n\n    throw new SupervisorFailedError(\n      `ai.supervisor(\"${this.config.name}\"): classifier output missing required \\`intent\\` field — got ${JSON.stringify(data)?.slice(0, 200)}`,\n      { context: { iteration: 0 } },\n    );\n  }\n\n  /**\n   * Build the read-only context passed to a classifier callback / agent\n   * resolvers. No dispatch helpers — registered intents haven't fired\n   * yet; pre-running them from the classifier would be confusing.\n   */\n  private buildClassifierContext(): ClassifierContext {\n    return {\n      iteration: 0,\n      input: this.input,\n      state: this.state,\n      context: this.context,\n      history: this.history,\n      signal: this.options?.signal ?? new AbortController().signal,\n      goal: this.goal,\n    };\n  }\n\n  /**\n   * Build the refine context — extends ClassifierContext with the\n   * classifier's just-resolved output plus `run` / `stream` so the\n   * refine hook can spin up secondary classifiers / validators\n   * inline (Phase 6 features).\n   */\n  private buildClassifierRefineContext(\n    base: ClassifierContext,\n    raw: ClassifierOutput,\n  ): ClassifierRefineContext {\n    const callStack = new Set<string>();\n    const reportSink = this.childReports;\n\n    return {\n      ...base,\n      result: { data: raw },\n      run: (executable, runInput, runOptions) =>\n        this.runInline(executable, runInput, runOptions, callStack, reportSink),\n      stream: (executable, runInput, runOptions) =>\n        this.streamInline(executable, runInput, runOptions, callStack, reportSink, \"classifier\"),\n    };\n  }\n\n  /**\n   * Pull the optional `refine` hook off whichever classifier-config\n   * shape was supplied. Bare-callback and bare-agent forms have no\n   * refine; only entry forms do.\n   */\n  private resolveRefineHook(\n    config: ClassifierConfig,\n  ):\n    | ((ctx: ClassifierRefineContext) => Promise<ClassifierRefineResult> | ClassifierRefineResult)\n    | undefined {\n    if (typeof config === \"function\") {\n      return undefined;\n    }\n\n    const refine = (config as { refine?: unknown }).refine;\n\n    return typeof refine === \"function\"\n      ? (refine as (\n          ctx: ClassifierRefineContext,\n        ) => Promise<ClassifierRefineResult> | ClassifierRefineResult)\n      : undefined;\n  }\n\n  /**\n   * Interpret a refine return value into actionable bits — final\n   * classifier output to dispatch, slice-to-merge, halted/refined\n   * flags, or an error. See {@link ClassifierRefineResult} for the\n   * accepted shapes.\n   */\n  private interpretRefineResult(\n    refineResult: ClassifierRefineResult,\n    raw: ClassifierOutput,\n  ): {\n    final?: ClassifierOutput;\n    sliceToMerge?: Record<string, unknown>;\n    refined: boolean;\n    halted: boolean;\n    error?: AIError;\n  } {\n    if (refineResult === undefined) {\n      return { final: raw, refined: false, halted: false };\n    }\n\n    if (refineResult === END) {\n      return { refined: true, halted: true };\n    }\n\n    if (typeof refineResult !== \"object\" || refineResult === null) {\n      return {\n        refined: false,\n        halted: true,\n        error: new SupervisorFailedError(\n          `ai.supervisor(\"${this.config.name}\"): classifier.refine returned an unsupported value — expected undefined, END, or an object`,\n          { context: { iteration: 0 } },\n        ),\n      };\n    }\n\n    const record = refineResult as Record<string, unknown>;\n    const intentField = record.intent;\n    const halted = intentField === END;\n    const intentOverride = typeof intentField === \"string\" ? intentField : undefined;\n\n    // Slice-to-merge is the refine return MINUS the `intent` field\n    // (which is dispatch metadata, not state contribution).\n    const slice: Record<string, unknown> = {};\n\n    for (const [key, value] of Object.entries(record)) {\n      if (key === \"intent\") continue;\n\n      slice[key] = value;\n    }\n\n    const final: ClassifierOutput = {\n      ...raw,\n      ...(intentOverride ? { intent: intentOverride } : {}),\n    };\n\n    return {\n      final: halted ? undefined : final,\n      sliceToMerge: Object.keys(slice).length > 0 ? slice : undefined,\n      refined: true,\n      halted,\n    };\n  }\n\n  /**\n   * Run the `evaluate` callback (when configured) after the\n   * iteration's branches settle and outputs have merged into state.\n   * Errors in the callback surface as `SupervisorFailedError` so a\n   * buggy evaluate doesn't silently swallow the whole run.\n   *\n   * Phase 3.4 (Stage 4b) — `EvaluateContext.state` carries the\n   * post-merge accumulator so verdicts can be state-aware. Q9\n   * lifted the router-only restriction; evaluate now runs in both\n   * router and route modes.\n   */\n  private async runEvaluate(branches: AgentBranchSnapshot[]): Promise<EvaluateResult> {\n    if (!this.config.evaluate) {\n      return undefined;\n    }\n\n    const evaluateContext: EvaluateContext = {\n      iteration: this.iteration,\n      input: this.input,\n      state: this.state,\n      result: indexBranchesForEvaluate(branches),\n      iterations: this.snapshots,\n      context: this.context,\n      history: this.history,\n      goal: this.goal,\n      classifier: this.classifierSnapshot,\n    };\n\n    try {\n      return await (\n        this.config.evaluate as (ctx: EvaluateContext) => EvaluateResult | Promise<EvaluateResult>\n      )(evaluateContext);\n    } catch (thrown) {\n      const message = thrown instanceof Error ? thrown.message : String(thrown);\n\n      throw new SupervisorFailedError(`evaluate callback threw: ${message}`, {\n        cause: thrown,\n      });\n    }\n  }\n\n  /**\n   * Merge each branch's output into supervisor `state` in\n   * `decision.intents` order — Q15 conflict rule: last intent in\n   * the array wins on key collisions. Errored branches don't\n   * contribute. Non-object outputs (primitives, null) are skipped\n   * with a warning log; they can't shallow-merge into an object.\n   *\n   * For agent/workflow intents: merging is opt-in via declaring an\n   * `output` schema (the strip-merge gate). Without a schema, the\n   * raw output stays on the branch snapshot but doesn't pollute\n   * state. For callback intents: their return is already strip-merged\n   * (or pass-through) inside `runCallback` — we just merge what's on\n   * the branch snapshot.\n   */\n  private mergeBranchesIntoState(intentsOrder: string[], branches: AgentBranchSnapshot[]): void {\n    const indexed = new Map<string, AgentBranchSnapshot>();\n    for (const branch of branches) {\n      indexed.set(branch.intent, branch);\n    }\n\n    const mergedKeys = new Map<string, string>();\n\n    for (const intent of intentsOrder) {\n      const branch = indexed.get(intent);\n      if (!branch || branch.error) continue;\n\n      const entry = this.entries.get(intent);\n\n      // For agent/workflow intents, only merge when the slice schema\n      // was declared (output present on the entry). For callbacks,\n      // their output is always merged (the schema, if any, was\n      // applied inside runCallback). Stream-mode agents (Phase 5 /\n      // decisions §34) merge unconditionally — `applyOutputSchema`\n      // already shaped their slice as `{ [streamTo]: text }`, and\n      // they have no `output` schema by construction.\n      const isStreamModeAgent = entry?.type === \"agent\" && entry.mode === \"stream\";\n      const shouldMerge =\n        entry?.type === \"callback\" || (entry && entry.output !== undefined) || isStreamModeAgent;\n\n      if (!shouldMerge) continue;\n\n      const slice = branch.output;\n\n      if (!slice || typeof slice !== \"object\" || Array.isArray(slice)) {\n        if (slice !== undefined) {\n          this.logger.warn(\n            this.logModule,\n            \"state.merge.skip\",\n            `intent \"${intent}\" output is not a mergeable object — skipping state merge`,\n            { intent, type: typeof slice },\n          );\n        }\n        continue;\n      }\n\n      for (const [key, value] of Object.entries(slice as Record<string, unknown>)) {\n        const previousOwner = mergedKeys.get(key);\n        if (previousOwner !== undefined && previousOwner !== intent) {\n          this.logger.warn(\n            this.logModule,\n            \"state.merge.conflict\",\n            `state key \"${key}\" written by both \"${previousOwner}\" and \"${intent}\" — last-in-decision-array wins (Q15)`,\n            { key, previousOwner, currentIntent: intent },\n          );\n        }\n        this.state[key] = value;\n        mergedKeys.set(key, intent);\n      }\n    }\n  }\n\n  /**\n   * Merge the iteration's accumulated `currentArtifacts` bag into\n   * supervisor state (Phase 5 / decisions §35). Runs once per\n   * iteration after branch slices land and before evaluate.\n   *\n   * Order of operations:\n   *\n   * 1. **Empty-bag fast path** — if no tool wrote anything, skip\n   *    validation and merge entirely; reset the bag for the next\n   *    iteration is also a no-op (already empty).\n   * 2. **Schema validation** — when `config.artifactsSchema` is set,\n   *    validate the bag against it. Failure aborts the iteration via\n   *    a thrown `SchemaValidationError`; the iteration loop's outer\n   *    catch surfaces it on `result.error`. Validation is opt-in\n   *    (no schema → no validation cost).\n   * 3. **Merge** — `config.finalizeArtifacts` when supplied, else\n   *    auto-spread `state = { ...state, ...artifacts }`. Replace\n   *    semantics under auto-spread; `finalizeArtifacts` carries\n   *    full responsibility for concat / dedupe / cross-iteration\n   *    accumulation when configured.\n   * 4. **Reset** — `currentArtifacts = {}`. The next iteration's\n   *    tool calls start with a fresh empty bag; long runs never\n   *    accumulate raw artifacts here.\n   */\n  private async mergeArtifactsIntoState(): Promise<void> {\n    const artifacts = this.currentArtifacts;\n    const keys = Object.keys(artifacts);\n\n    // Phase 8 / decisions §38 — capture the raw bag BEFORE validation\n    // or merge so the iteration snapshot surfaces what the tools\n    // actually wrote, regardless of what `finalizeArtifacts` did with\n    // it. Frozen — consumers should never mutate forensic data.\n    // Always run, even on empty bags — snapshot builder reads\n    // `capturedIterationArtifacts` regardless.\n    this.capturedIterationArtifacts = Object.freeze({ ...artifacts });\n\n    if (keys.length === 0) {\n      return;\n    }\n\n    const schema = this.config.artifactsSchema;\n\n    if (schema) {\n      const validation = await schema[\"~standard\"].validate(artifacts);\n\n      if (validation.issues) {\n        throw new SchemaValidationError(\n          `supervisor \"${this.config.name}\": iteration ${this.iteration} artifacts failed validation: ${validation.issues\n            .map((issue) => issue.message)\n            .join(\"; \")}`,\n          { issues: validation.issues, context: { iteration: this.iteration } },\n        );\n      }\n    }\n\n    const finalize = this.config.finalizeArtifacts as\n      | ((\n          state: Record<string, unknown>,\n          artifacts: Record<string, unknown>,\n        ) => Record<string, unknown>)\n      | undefined;\n\n    if (finalize) {\n      const merged = finalize(this.state, artifacts);\n\n      // Mutate in place so external references to `this.state`\n      // (snapshot copies, evaluate ctx) stay coherent. Drop keys\n      // the finalize callback removed; overwrite the rest.\n      for (const key of Object.keys(this.state)) {\n        if (!(key in merged)) {\n          delete this.state[key];\n        }\n      }\n\n      for (const [key, value] of Object.entries(merged)) {\n        this.state[key] = value;\n      }\n    } else {\n      for (const [key, value] of Object.entries(artifacts)) {\n        this.state[key] = value;\n      }\n    }\n\n    this.currentArtifacts = {};\n  }\n\n  /**\n   * Collect each branch's `intent.next(ctx)` directive after state\n   * merge (Stage 4d / Q24). Iterates `decision.intents` order so\n   * union resolution is deterministic.\n   *\n   * Rules:\n   * - Errored branch → silent (treated as if no `next` defined).\n   * - Branch with no `next` → silent; abstains (does NOT drag the\n   *   iteration to the router).\n   * - Branch returns `END` → supreme; terminates immediately and\n   *   discards other branches' opinions.\n   * - Branch returns `string` or `string[]` → contributes to the\n   *   union of unique intent names. Validated against the\n   *   supervisor's registry; unknown keys throw `SupervisorFailedError`.\n   * - All branches silent → returns `undefined`; caller falls back\n   *   to router/route.\n   */\n  private collectIntentNext(\n    intentsOrder: string[],\n    branches: AgentBranchSnapshot[],\n  ): { kind: \"dispatch\"; intents: string[] } | { kind: \"end\" } | undefined {\n    const indexed = new Map<string, AgentBranchSnapshot>();\n    for (const branch of branches) {\n      indexed.set(branch.intent, branch);\n    }\n\n    const collected: string[] = [];\n    const seen = new Set<string>();\n    let anySilent = false;\n\n    for (const intent of intentsOrder) {\n      const branch = indexed.get(intent);\n      if (!branch || branch.error) {\n        anySilent = true;\n        continue;\n      }\n\n      const entry = this.entries.get(intent);\n      if (!entry?.next) {\n        anySilent = true;\n        continue;\n      }\n\n      // Build a per-branch DispatchContext for the resolver. Cycle\n      // stack is fresh-and-self-seeded so a `next` that calls\n      // `ctx.intents.X.execute()` reuses the per-iteration cycle\n      // detection mechanic.\n      const dispatchCtx = this.seedDispatchContext(\n        intent,\n        branch.input,\n        new Set<string>([intent]),\n        [],\n      );\n\n      let raw: string | string[] | typeof END | undefined;\n      try {\n        raw = entry.next(dispatchCtx) as string | string[] | typeof END | undefined;\n      } catch (thrown) {\n        const message = thrown instanceof Error ? thrown.message : String(thrown);\n        throw new SupervisorFailedError(`intent \"${intent}\" \\`next\\` resolver threw: ${message}`, {\n          cause: thrown,\n          context: { intent },\n        });\n      }\n\n      if (raw === undefined) {\n        anySilent = true;\n        continue;\n      }\n\n      if (raw === END) {\n        return { kind: \"end\" };\n      }\n\n      const proposed = Array.isArray(raw) ? raw : [raw];\n\n      for (const target of proposed) {\n        if (typeof target !== \"string\") {\n          throw new SupervisorFailedError(\n            `intent \"${intent}\" \\`next\\` returned a non-string value`,\n            { context: { intent } },\n          );\n        }\n\n        if (!this.entries.has(target)) {\n          throw new SupervisorFailedError(\n            `intent \"${intent}\" \\`next\\` returned unknown intent \"${target}\"`,\n            {\n              context: { intent, target, available: [...this.entries.keys()] },\n            },\n          );\n        }\n\n        if (!seen.has(target)) {\n          seen.add(target);\n          collected.push(target);\n        }\n      }\n    }\n\n    void anySilent;\n\n    if (collected.length === 0) {\n      // No branch directed the next iteration — fall back to router.\n      return undefined;\n    }\n\n    return { kind: \"dispatch\", intents: collected };\n  }\n\n  /**\n   * Finalize the supervisor result: validate accumulated state\n   * against the output schema and build the public `SupervisorResult`.\n   * Assemble-only — event emission and stream close happen in\n   * `run()` around this call.\n   */\n  private async finalize(): Promise<SupervisorResult<TOutput>> {\n    if (this.status === \"completed\" && !this.error) {\n      try {\n        this.data = await this.buildTypedData();\n      } catch (thrown) {\n        this.error = toAIError(thrown);\n        this.status = \"failed\";\n        this.terminatedBy = \"error\";\n      }\n    }\n\n    const endedAt = new Date();\n\n    const finalStatus: SupervisorSnapshotStatus =\n      this.status === \"max-iterations\" ? \"failed\" : this.status;\n\n    await this.checkpoint(finalStatus);\n\n    const report: SupervisorReport = {\n      runId: this.runId,\n      rootRunId: this.runId,\n      name: this.config.name,\n      version: this.config.version,\n      type: \"supervisor\",\n      supervisorName: this.config.name,\n      signature: this.signature,\n      status: this.status,\n      terminatedBy: this.terminatedBy,\n      iterations: this.snapshots.length,\n      startedAt: this.startedAtIso,\n      endedAt: endedAt.toISOString(),\n      duration: performance.now() - this.startPerf,\n      cancelledAt: this.cancelledAtIso,\n      usage: this.usage,\n      children: this.childReports,\n      snapshots: this.snapshots,\n      ack: this.ackSnapshot,\n      classifier: this.classifierSnapshot,\n    };\n\n    // Stamp lineage on the assembled tree exactly once per run.\n    // Walker rewrites inner self-roots from every nested agent /\n    // workflow / callback report the supervisor absorbed, propagates\n    // sessionId, and writes `reportSchemaVersion` on the root.\n    stampReportLineage(report, {\n      rootRunId: this.runId,\n      sessionId: this.options?.sessionId,\n    });\n\n    return {\n      type: \"supervisor\",\n      data: this.data,\n      report,\n      usage: this.usage,\n      error: this.error,\n    };\n  }\n\n  /**\n   * Build the typed `data` at finalize. Stage 4c — single mode:\n   *\n   * - When `config.output` is declared, validate the accumulated\n   *   `state` against it and return the validated value (Q8).\n   *   `result.data` always matches the schema, or `result.error`\n   *   carries the validation issues.\n   * - When `config.output` is omitted, return the raw state object.\n   *\n   * Validation failure surfaces as `SchemaValidationError` on\n   * `result.error`; the run is still considered semantically\n   * \"completed\" (intents ran, evaluate said done) but the typed\n   * data slot is empty.\n   */\n  private async buildTypedData(): Promise<TOutput | undefined> {\n    if (this.config.output) {\n      return validateOutput<TOutput>(this.config.output, this.state as unknown);\n    }\n\n    return this.state as TOutput;\n  }\n\n  /**\n   * Record a snapshot for an iteration whose first decision was\n   * `END` — no dispatch, no evaluate, just the decision record. Keeps\n   * the snapshot log uniform so a late-route-to-END still appears in\n   * the forensic history rather than vanishing.\n   */\n  private async recordTerminalDecisionSnapshot(\n    decision: DispatchDecision & { kind: \"end\" },\n    iterationStartedAt: Date,\n    iterationStart: number,\n    iterationUsage: Usage,\n  ): Promise<void> {\n    const snapshot: IterationSnapshot = Object.freeze({\n      iteration: this.iteration,\n      result: {},\n      decision: {\n        source: decision.source,\n        next: decision.raw,\n        reasoning: decision.reasoning,\n        durationMs: decision.durationMs,\n      },\n      state: { ...this.state },\n      artifacts: this.capturedIterationArtifacts,\n      startedAt: iterationStartedAt.toISOString(),\n      endedAt: new Date().toISOString(),\n      duration: performance.now() - iterationStart,\n      usage: iterationUsage,\n    });\n\n    this.snapshots.push(snapshot);\n\n    this.emit(\"supervisor.iteration.completed\", {\n      iteration: this.iteration,\n      snapshot,\n    });\n\n    await this.checkpoint(\"running\");\n  }\n\n  /**\n   * Write the current run state to the configured KV store (if any).\n   * Persistence failures surface as `supervisor.error` events and\n   * logged warnings but never abort the run — checkpoint best-effort\n   * by design, matching `workflow` semantics.\n   */\n  private async checkpoint(status: SupervisorSnapshotStatus): Promise<void> {\n    const outcome = await persistSupervisorSnapshot({\n      config: this.config as SupervisorConfig<unknown>,\n      signature: this.signature,\n      runId: this.runId,\n      input: this.input,\n      startedAt: this.startedAtIso,\n      iteration: this.snapshots.length - 1,\n      snapshots: this.snapshots,\n      status,\n    });\n\n    if (!outcome.ok) {\n      this.logger.warn(this.logModule, \"persist.failed\", \"snapshot persist failed\", {\n        runId: this.runId,\n      });\n    }\n  }\n\n  /**\n   * Between-iteration cancellation check. Called at the top of\n   * every iteration; signal abort here means the loop exits before\n   * any routing happens.\n   */\n  private throwIfCancelled(): void {\n    if (this.options?.signal?.aborted) {\n      throw createCancelledError(this.options.signal);\n    }\n  }\n\n  /**\n   * Aggregate one usage record (typically a branch or a router call)\n   * into both the run-wide total and the iteration-local total.\n   */\n  private aggregateUsage(iterationUsage: Usage, partial?: Usage): void {\n    if (!partial) {\n      return;\n    }\n\n    this.usage.input += partial.input;\n    this.usage.output += partial.output;\n    this.usage.total += partial.total;\n\n    iterationUsage.input += partial.input;\n    iterationUsage.output += partial.output;\n    iterationUsage.total += partial.total;\n  }\n\n  /**\n   * Fan an event out through the three-tier emitter AND mirror it\n   * into the stream controller when streaming. Event names map 1:1\n   * to stream event types so consumers iterating the stream see the\n   * exact same surface as `.on()` / `options.on` handlers.\n   */\n  private emit<K extends keyof SupervisorEventMap>(\n    event: K,\n    payload: WithoutIdentity<SupervisorEventMap[K]>,\n  ): void {\n    // Inject run identity once, here, so the three-tier emitter, the\n    // structured log line, and the stream all see it. `rootRunId ===\n    // runId` for a standalone run; nested propagation is a follow-up.\n    const identity: EventIdentity = {\n      runId: this.runId,\n      rootRunId: this.runId,\n    };\n\n    const fullPayload = { ...payload, ...identity } as SupervisorEventMap[K];\n\n    this.emitter.emit(event, fullPayload, this.options?.on);\n    this.logEvent(event, fullPayload);\n\n    if (this.streamController) {\n      this.streamController.push({\n        type: event,\n        ...(fullPayload as object),\n      } as SupervisorStreamEvent);\n    }\n  }\n\n  private logEvent<K extends keyof import(\"../contracts/events/event-map.type\").SupervisorEventMap>(\n    event: K,\n    payload: import(\"../contracts/events/event-map.type\").SupervisorEventMap[K],\n  ): void {\n    const action = event.replace(/^supervisor\\./, \"\");\n\n    switch (event) {\n      case \"supervisor.starting\":\n        this.logger.info(this.logModule, action, \"supervisor starting\", {\n          runId: this.runId,\n        });\n        return;\n\n      case \"supervisor.iteration.starting\":\n        this.logger.debug(this.logModule, action, \"iteration starting\", {\n          iteration: (payload as { iteration: number }).iteration,\n        });\n        return;\n\n      case \"supervisor.router.decided\":\n        this.logger.debug(this.logModule, action, \"router decided\", {\n          iteration: (payload as { iteration: number }).iteration,\n          next: (payload as { next: unknown }).next,\n        });\n        return;\n\n      case \"supervisor.agent.completed\": {\n        const typed = payload as {\n          intent: string;\n          duration: number;\n          usage: Usage;\n        };\n        this.logger.success(this.logModule, action, `branch \"${typed.intent}\" done`, {\n          duration: typed.duration,\n          usage: typed.usage,\n        });\n        return;\n      }\n\n      case \"supervisor.agent.failed\": {\n        const typed = payload as { intent: string; error: AIError };\n        this.logger.warn(this.logModule, action, `branch \"${typed.intent}\" failed`, {\n          code: typed.error.code,\n          message: typed.error.message,\n        });\n        return;\n      }\n\n      case \"supervisor.error\": {\n        const { error } = payload as { error: AIError };\n        this.logger.error(this.logModule, action, error.message, {\n          code: error.code,\n        });\n        return;\n      }\n\n      case \"supervisor.cancelled\": {\n        const typed = payload as { cancelledAt: string; reason?: string };\n        this.logger.warn(this.logModule, action, \"supervisor cancelled\", {\n          cancelledAt: typed.cancelledAt,\n          reason: typed.reason,\n        });\n        return;\n      }\n\n      case \"supervisor.iteration.completed\":\n        this.logger.debug(this.logModule, action, \"iteration completed\", {\n          iteration: (payload as { iteration: number }).iteration,\n        });\n        return;\n\n      default:\n        // Streaming / per-branch starting events are high-volume — no\n        // dedicated log line.\n        return;\n    }\n  }\n}\n\nfunction indexByIntent(branches: AgentBranchSnapshot[]): Record<string, AgentBranchSnapshot> {\n  const indexed: Record<string, AgentBranchSnapshot> = {};\n\n  for (const branch of branches) {\n    indexed[branch.intent] = branch;\n  }\n\n  return indexed;\n}\n\nfunction indexBranchesForEvaluate(\n  branches: AgentBranchSnapshot[],\n): Record<string, EvaluateBranchResult> {\n  const indexed: Record<string, EvaluateBranchResult> = {};\n\n  for (const branch of branches) {\n    indexed[branch.intent] = {\n      output: branch.output,\n      input: branch.input,\n      usage: branch.usage,\n      durationMs: branch.duration,\n      error: branch.error,\n    };\n  }\n\n  return indexed;\n}\n\nfunction normalizeReassign(reassignTo: string | string[] | undefined): string[] {\n  if (!reassignTo) {\n    return [];\n  }\n\n  if (Array.isArray(reassignTo)) {\n    return reassignTo;\n  }\n\n  return [reassignTo];\n}\n\nfunction toAIError(thrown: unknown): AIError {\n  if (thrown instanceof AIError) {\n    return thrown;\n  }\n\n  const message = thrown instanceof Error ? thrown.message : String(thrown);\n\n  return new SupervisorFailedError(message, { cause: thrown });\n}\n\n/**\n * Sum a list of child `BaseReport.usage` values. Callbacks\n * themselves contribute zero own-cost (they're dev code, not LLM\n * calls); their report's `usage` equals the sum of whatever\n * agents / workflows / nested callbacks they dispatched via\n * `ctx.intents.X.execute()`. Mirrors `compositeAsTool` semantics.\n */\nfunction aggregateChildUsage(children: BaseReport[]): Usage {\n  return children.reduce<Usage>(\n    (acc, child) => ({\n      input: acc.input + child.usage.input,\n      output: acc.output + child.usage.output,\n      total: acc.total + child.usage.total,\n    }),\n    { input: 0, output: 0, total: 0 },\n  );\n}\n\n/**\n * Best-effort stringification for the snapshot's `input` field when\n * a callback intent's resolved input is a non-string value. Falls\n * back to a typed placeholder if `JSON.stringify` throws (circular\n * refs, BigInt, etc.) so a snapshot write never fails on its own.\n */\nfunction safeStringify(value: unknown): string {\n  if (value === undefined) {\n    return \"undefined\";\n  }\n\n  try {\n    return JSON.stringify(value);\n  } catch {\n    return `[unserializable: ${typeof value}]`;\n  }\n}\n\nasync function validateOutput<TOutput>(\n  schema: StandardSchemaV1<TOutput>,\n  value: unknown,\n): Promise<TOutput> {\n  const validation = await schema[\"~standard\"].validate(value);\n\n  if (validation.issues) {\n    throw new SchemaValidationError(validation.issues.map((issue) => issue.message).join(\"; \"), {\n      issues: validation.issues,\n    });\n  }\n\n  return validation.value;\n}\n","import { ClassifierAgentEntry, ClassifierRunEntry } from \"../contracts\";\nimport type { SupervisorConfig } from \"../contracts/supervisor/supervisor-config.type\";\nimport type { ResolvedIntentEntry } from \"./entries\";\n\n/**\n * Deterministic structural fingerprint of a supervisor definition.\n * Persisted on every snapshot so `resume()` can detect drift between\n * the saved run and the current definition. Covers:\n *\n * - Supervisor name.\n * - Every intent key + its resolved description + the underlying\n *   unit's stable identity (agent name, workflow name + signature,\n *   or `\"callback\"` marker for dev-callback intents).\n * - Router agent's name (if the supervisor uses LLM routing).\n * - Whether a deterministic `route` callback is configured (but not\n *   its contents — route callbacks are code, not data).\n * - Whether an `evaluate` callback is configured.\n * - `initialAgent` when set.\n * - `maxIterations` (a semantic shape change, not a cosmetic one).\n *\n * Does NOT cover: system prompt text, logger, store identity, per-\n * event handlers — all runtime knobs that don't change the shape of\n * a resumable run.\n */\nexport function computeSignature(\n  config: SupervisorConfig<unknown>,\n  entries: Map<string, ResolvedIntentEntry>,\n): string {\n  const intentsFingerprint = [...entries.entries()]\n    .sort(([a], [b]) => a.localeCompare(b))\n    .map(([intent, entry]) => ({\n      k: intent,\n      d: entry.description,\n      u: fingerprintUnit(entry),\n    }));\n\n  const fingerprint = {\n    n: config.name,\n    a: intentsFingerprint,\n    r: resolveRouterName(config.router),\n    rc: config.route ? 1 : 0,\n    e: config.evaluate ? 1 : 0,\n    i: config.initialAgent ?? null,\n    m: config.maxIterations ?? null,\n    // Phase 7 / decisions §37 — classifier is part of structural identity.\n    // Resume drift detection notices when the classifier swap changes\n    // routing semantics. Same fingerprint shape as router (agent name\n    // when applicable; \"callback\" marker for callback form).\n    c: resolveClassifierFingerprint(config.classifier),\n  };\n\n  return hash(JSON.stringify(fingerprint));\n}\n\nfunction resolveRouterName(router: SupervisorConfig<unknown>[\"router\"]): string | null {\n  if (!router) {\n    return null;\n  }\n\n  if (typeof (router as { execute?: unknown }).execute === \"function\") {\n    return (router as { name?: string }).name ?? null;\n  }\n\n  return (router as { agent?: { name?: string } }).agent?.name ?? null;\n}\n\nfunction resolveClassifierFingerprint(\n  classifier: SupervisorConfig<unknown>[\"classifier\"],\n): unknown {\n  if (!classifier) {\n    return null;\n  }\n\n  if (typeof classifier === \"function\") {\n    return { t: \"callback\" };\n  }\n\n  if (typeof (classifier as { execute?: unknown }).execute === \"function\") {\n    return { t: \"agent\", n: (classifier as { name?: string }).name ?? null };\n  }\n\n  if (typeof (classifier as ClassifierRunEntry).run === \"function\") {\n    return { t: \"callback\" };\n  }\n\n  if (typeof (classifier as ClassifierAgentEntry).agent?.execute === \"function\") {\n    return {\n      t: \"agent\",\n      n: (classifier as ClassifierAgentEntry).agent?.name ?? null,\n    };\n  }\n\n  return { t: \"unknown\" };\n}\n\nfunction fingerprintUnit(entry: ResolvedIntentEntry): unknown {\n  if (entry.type === \"callback\") {\n    // Callbacks are dev code — fingerprint the type + intent name\n    // only (the closure itself can't be hashed deterministically).\n    // Drift detection covers add/remove/rename of callback intents,\n    // not edits to the function body. Same trade-off as `route`.\n    return { t: \"callback\" };\n  }\n\n  if (entry.type === \"workflow\") {\n    const workflow = entry.unit;\n    return { t: \"workflow\", n: workflow.name, s: workflow.signature };\n  }\n\n  return { t: \"agent\", n: entry.unit.name };\n}\n\n/**\n * FNV-1a 32-bit — same hash `workflow/signature.ts` uses. Deterministic,\n * no crypto dependency, cheap; signatures are 8-char hex.\n */\nfunction hash(input: string): string {\n  let h = 0x811c9dc5;\n\n  for (let i = 0; i < input.length; i++) {\n    h ^= input.charCodeAt(i);\n    h = (h + ((h << 1) + (h << 4) + (h << 7) + (h << 8) + (h << 24))) >>> 0;\n  }\n\n  return h.toString(16).padStart(8, \"0\");\n}\n","import type { StreamContract } from \"../contracts/stream/stream.contract\";\nimport type { SupervisorStreamEvent } from \"../contracts/supervisor/supervisor-stream-event.type\";\n\n// Re-export so internal callers that already imported from this file\n// keep working unchanged. Canonical home is the contracts barrel.\nexport type { SupervisorStreamEvent };\n\n/**\n * Internal async-queue controller driving `supervisor.stream()`.\n * Mirrors `StreamController` from `agent-stream.ts` — same\n * producer/consumer pipe, same semantics, parameterized by the\n * supervisor event union and terminal result type.\n */\nexport type SupervisorStreamController<TResult> = {\n  push(event: SupervisorStreamEvent): void;\n  end(result: TResult): void;\n  fail(error: Error): void;\n};\n\ntype PendingRead = {\n  resolve(value: IteratorResult<SupervisorStreamEvent>): void;\n  reject(error: Error): void;\n};\n\n/**\n * Factory mirroring `createAgentStream`. Returns a paired\n * `{ controller, stream }` — the `SupervisorExecution` pushes events\n * into the controller while the caller iterates (or awaits `.result`)\n * on the stream side. See `agent-stream.ts` for the full role\n * description.\n */\nexport function createSupervisorStream<TResult>(): {\n  controller: SupervisorStreamController<TResult>;\n  stream: StreamContract<TResult, SupervisorStreamEvent>;\n} {\n  const queue: SupervisorStreamEvent[] = [];\n  const pending: PendingRead[] = [];\n  const handlers = new Map<string, (event: SupervisorStreamEvent) => void>();\n\n  let closed = false;\n  let failure: Error | undefined;\n  let resolveResult!: (value: TResult) => void;\n  let rejectResult!: (error: Error) => void;\n\n  const result = new Promise<TResult>((resolve, reject) => {\n    resolveResult = resolve;\n    rejectResult = reject;\n  });\n\n  const controller: SupervisorStreamController<TResult> = {\n    push(event) {\n      const handler = handlers.get(event.type);\n\n      if (handler) {\n        try {\n          handler(event);\n        } catch {\n          // Stream handlers must never crash the supervisor.\n        }\n      }\n\n      const reader = pending.shift();\n\n      if (reader) {\n        reader.resolve({ value: event, done: false });\n        return;\n      }\n\n      queue.push(event);\n    },\n\n    end(finalResult) {\n      closed = true;\n      resolveResult(finalResult);\n\n      while (pending.length > 0) {\n        pending.shift()?.resolve({ value: undefined, done: true });\n      }\n    },\n\n    fail(error) {\n      closed = true;\n      failure = error;\n      rejectResult(error);\n\n      while (pending.length > 0) {\n        pending.shift()?.reject(error);\n      }\n    },\n  };\n\n  const iterator: AsyncIterator<SupervisorStreamEvent> = {\n    next() {\n      if (queue.length > 0) {\n        return Promise.resolve({ value: queue.shift()!, done: false });\n      }\n\n      if (closed) {\n        if (failure) {\n          return Promise.reject(failure);\n        }\n\n        return Promise.resolve({ value: undefined, done: true });\n      }\n\n      return new Promise<IteratorResult<SupervisorStreamEvent>>(\n        (resolve, reject) => {\n          pending.push({ resolve, reject });\n        },\n      );\n    },\n  };\n\n  // The `StreamContract<TResult>` shape is shared across primitives —\n  // it types `on()` over the generic `StreamEvent` union (agent\n  // events). Supervisor events are a distinct discriminated union\n  // with the same `type`-keyed shape, so we satisfy the contract via\n  // a structural cast — handlers see the supervisor events at their\n  // correct narrowed types.\n  const stream = {\n    result,\n    on(handlerMap) {\n      for (const [key, handler] of Object.entries(handlerMap)) {\n        if (handler) {\n          handlers.set(key, handler as (event: SupervisorStreamEvent) => void);\n        }\n      }\n\n      return stream;\n    },\n    [Symbol.asyncIterator]() {\n      return iterator;\n    },\n  } as StreamContract<TResult, SupervisorStreamEvent>;\n\n  return { controller, stream };\n}\n","import type { SupervisorEventMap } from \"../contracts/events/event-map.type\";\nimport type { SupervisorResult } from \"../contracts/result/supervisor-result.type\";\nimport type { StreamContract } from \"../contracts/stream/stream.contract\";\nimport type { SupervisorIntentValue } from \"../contracts/supervisor/intent-entry.type\";\nimport type {\n  SupervisorConfig,\n  SupervisorEventHandler,\n} from \"../contracts/supervisor/supervisor-config.type\";\nimport type {\n  SupervisorExecuteOptions,\n  SupervisorResumeOptions,\n} from \"../contracts/supervisor/supervisor-execute-options.type\";\nimport type { SupervisorInput } from \"../contracts/supervisor/supervisor-input.type\";\nimport type { SupervisorStreamEvent } from \"../contracts/supervisor/supervisor-stream-event.type\";\nimport type {\n  SupervisorAsToolOptions,\n  SupervisorContract,\n} from \"../contracts/supervisor/supervisor.contract\";\nimport { SupervisorFailedError } from \"../errors\";\nimport type { ToolContract } from \"../tool/tool\";\nimport { asTool } from \"./as-tool\";\nimport { SupervisorEmitter } from \"./emitter\";\nimport { assertRouterDescriptions, resolveIntentEntries } from \"./entries\";\nimport { SupervisorExecution } from \"./execution\";\nimport { computeSignature } from \"./signature\";\nimport { loadSnapshotForResume } from \"./snapshot\";\nimport { createSupervisorStream } from \"./supervisor-stream\";\n\n/**\n * `ai.supervisor(config)` — construct a `SupervisorContract`. Validates\n * the config at author time (throws `SupervisorFailedError` on bad\n * shape), resolves agent entries, computes a stable structural\n * signature, wires the three-tier event emitter, and returns an\n * instance that satisfies `ExecutableContract` so it can compose into\n * tools, outer agents, and (future) orchestrators uniformly.\n *\n * @example\n * const support = ai.supervisor({\n *   name: \"customer-support\",\n *   router: routerAgent,\n *   intents: { triage, orderLookup, billingLookup, resolver },\n *   evaluate: (ctx) => ctx.result.resolver?.output ? { satisfied: true } : undefined,\n *   output: z.object({ response: z.string(), refund: z.boolean() }),\n *   maxIterations: 6,\n * });\n */\nexport function supervisor<\n  TOutput = unknown,\n  TState = TOutput,\n  TIntents extends Record<string, SupervisorIntentValue> = Record<string, SupervisorIntentValue>,\n  TArtifacts = Record<string, unknown>,\n>(config: SupervisorConfig<TOutput, TState, TIntents, TArtifacts>): SupervisorContract<TOutput> {\n  validateFactoryConfig(config as unknown as SupervisorConfig<TOutput>);\n\n  const entries = resolveIntentEntries(config.intents, config.name);\n\n  assertRouterDescriptions(config as SupervisorConfig<unknown>, entries);\n\n  if (config.initialAgent && !entries.has(config.initialAgent)) {\n    throw new SupervisorFailedError(\n      `ai.supervisor(\"${config.name}\"): \\`initialAgent\\` \"${config.initialAgent}\" is not a key in \\`intents\\``,\n      { context: { authoring: true } },\n    );\n  }\n\n  const signature = computeSignature(config as SupervisorConfig<unknown>, entries);\n  const emitter = new SupervisorEmitter(config.on);\n\n  async function execute(\n    input: SupervisorInput,\n    options?: SupervisorExecuteOptions,\n  ): Promise<SupervisorResult<TOutput>> {\n    const runId = options?.runId ?? generateRunId();\n\n    const execution = new SupervisorExecution<TOutput>({\n      config: config as unknown as SupervisorConfig<TOutput>,\n      entries,\n      signature,\n      emitter,\n      input,\n      runId,\n      options,\n    });\n\n    return execution.run();\n  }\n\n  function stream(\n    input: SupervisorInput,\n    options?: SupervisorExecuteOptions,\n  ): StreamContract<SupervisorResult<TOutput>, SupervisorStreamEvent> {\n    const runId = options?.runId ?? generateRunId();\n    const { controller, stream: contract } = createSupervisorStream<SupervisorResult<TOutput>>();\n\n    const execution = new SupervisorExecution<TOutput>({\n      config: config as unknown as SupervisorConfig<TOutput>,\n      entries,\n      signature,\n      emitter,\n      input,\n      runId,\n      options,\n      streamController: controller,\n    });\n\n    void execution.run();\n\n    return contract;\n  }\n\n  async function resume(\n    runId: string,\n    options?: SupervisorResumeOptions,\n  ): Promise<SupervisorResult<TOutput>> {\n    const snapshot = await loadSnapshotForResume({\n      config: config as SupervisorConfig<unknown>,\n      signature,\n      runId,\n      options,\n    });\n\n    const execution = new SupervisorExecution<TOutput>({\n      config: config as unknown as SupervisorConfig<TOutput>,\n      entries,\n      signature,\n      emitter,\n      input: snapshot.input,\n      runId,\n      options,\n      resumeFrom: snapshot,\n    });\n\n    return execution.run();\n  }\n\n  const instance: SupervisorContract<TOutput> = {\n    name: config.name,\n    signature,\n    execute,\n    stream,\n    resume,\n    on<K extends keyof SupervisorEventMap>(\n      event: K,\n      handler: SupervisorEventHandler<K>,\n    ): () => void {\n      return emitter.on(event, handler);\n    },\n    off<K extends keyof SupervisorEventMap>(event: K, handler: SupervisorEventHandler<K>): void {\n      emitter.off(event, handler);\n    },\n    asTool<TToolInput = string>(\n      options: SupervisorAsToolOptions<TToolInput>,\n    ): ToolContract<TToolInput, TOutput> {\n      return asTool<TOutput, TToolInput>(instance, options);\n    },\n  };\n\n  return instance;\n}\n\n/**\n * Factory-time validation. Enforces the XOR + pairing rules the design\n * locked in §2 and surfaces any violation as a typed\n * `SupervisorFailedError` tagged `authoring: true`.\n */\nfunction validateFactoryConfig<T>(config: SupervisorConfig<T>): void {\n  if (!config.name || typeof config.name !== \"string\") {\n    throw new SupervisorFailedError(\"ai.supervisor: `name` is required and must be a string\", {\n      context: { authoring: true },\n    });\n  }\n\n  if (!config.intents || typeof config.intents !== \"object\") {\n    throw new SupervisorFailedError(`ai.supervisor(\"${config.name}\"): \\`intents\\` is required`, {\n      context: { authoring: true },\n    });\n  }\n\n  const hasRoute = typeof config.route === \"function\";\n  const hasRouter = !!config.router;\n\n  if (hasRouter) {\n    const router = config.router as { execute?: unknown } | { agent?: { execute?: unknown } };\n    const isBareAgent = typeof (router as { execute?: unknown }).execute === \"function\";\n    const isEntryForm =\n      !isBareAgent &&\n      typeof (router as { agent?: { execute?: unknown } }).agent === \"object\" &&\n      typeof (router as { agent?: { execute?: unknown } }).agent?.execute === \"function\";\n\n    if (!isBareAgent && !isEntryForm) {\n      throw new SupervisorFailedError(\n        `ai.supervisor(\"${config.name}\"): \\`router\\` must be an agent contract or a \\`{ agent, placeholders?, input? }\\` entry`,\n        { context: { authoring: true } },\n      );\n    }\n  }\n\n  if (hasRoute && hasRouter) {\n    throw new SupervisorFailedError(\n      `ai.supervisor(\"${config.name}\"): \\`route\\` and \\`router\\` are mutually exclusive — configure exactly one`,\n      { context: { authoring: true } },\n    );\n  }\n\n  // Phase 7 / decisions §37 — `classifier` is the iter-0 prelude;\n  // satisfies the \"must have a dispatch source\" rule on its own.\n  // Composes with router/route (classifier drives iter 0; router/route\n  // takes iter 1+). When configured alone, supervisor terminates after\n  // iter 0's branch settles.\n  const hasClassifier = config.classifier !== undefined;\n\n  if (!hasRoute && !hasRouter && !hasClassifier) {\n    throw new SupervisorFailedError(\n      `ai.supervisor(\"${config.name}\"): one of \\`route\\`, \\`router\\`, or \\`classifier\\` is required`,\n      { context: { authoring: true } },\n    );\n  }\n\n  // Phase 7 — classifier and initialAgent both decide what runs first.\n  // Coexistence is meaningless; throw loudly.\n  if (hasClassifier && config.initialAgent) {\n    throw new SupervisorFailedError(\n      `ai.supervisor(\"${config.name}\"): \\`classifier\\` and \\`initialAgent\\` are mutually exclusive — both decide which intent runs first. Pick one.`,\n      { context: { authoring: true } },\n    );\n  }\n\n  // Phase 3.4 (Q9) — evaluate now pairs with both `route` and\n  // `router`. State-driven termination is useful in either dispatch\n  // mode; the historical router-only restriction was incidental,\n  // not principled.\n\n  if (config.ack !== undefined) {\n    const ack = config.ack;\n    const isCallback = typeof ack === \"function\";\n    const isAgentEntry =\n      typeof ack === \"object\" &&\n      ack !== null &&\n      typeof (ack as { agent?: { execute?: unknown } }).agent?.execute === \"function\";\n    const isRunEntry =\n      typeof ack === \"object\" &&\n      ack !== null &&\n      typeof (ack as { run?: unknown }).run === \"function\";\n\n    if (!isCallback && !isAgentEntry && !isRunEntry) {\n      throw new SupervisorFailedError(\n        `ai.supervisor(\"${config.name}\"): \\`ack\\` must be an \\`{ agent, ... }\\` entry, an \\`{ run, ... }\\` entry, or a bare callback function`,\n        { context: { authoring: true } },\n      );\n    }\n\n    if (isAgentEntry && isRunEntry) {\n      throw new SupervisorFailedError(\n        `ai.supervisor(\"${config.name}\"): \\`ack\\` cannot declare both \\`agent\\` and \\`run\\` — pick one`,\n        { context: { authoring: true } },\n      );\n    }\n  }\n\n  if (config.maxIterations !== undefined && config.maxIterations < 1) {\n    throw new SupervisorFailedError(\n      `ai.supervisor(\"${config.name}\"): \\`maxIterations\\` must be >= 1`,\n      { context: { authoring: true, maxIterations: config.maxIterations } },\n    );\n  }\n}\n\nfunction generateRunId(): string {\n  return `sup_${Date.now().toString(36)}_${Math.random().toString(36).slice(2, 10)}`;\n}\n","import type { Placeholders } from \"../contracts/placeholders.type\";\n\nconst PLACEHOLDER_PATTERN = /\\{\\{\\s*([^{}]+?)\\s*\\}\\}/g;\n\n/**\n * Render a template string against a placeholders map, supporting dot-path\n * lookups and inline fallback values.\n *\n * Supported syntax:\n * - `{{key}}` — replaced by `placeholders.key`, left untouched if missing.\n * - `{{a.b.c}}` — dot-path lookup into nested objects.\n * - `{{key|default}}` — substitutes `default` when the key resolves to\n *   `undefined`, `null`, or empty string.\n *\n * Whitespace inside the braces is ignored (`{{ key }}` == `{{key}}`).\n * Values are coerced to strings via `String(value)`.\n *\n * @example\n * renderPlaceholders(\n *   \"Hello {{user.name|friend}}, your role is {{role}}\",\n *   { user: { name: \"Hasan\" }, role: \"admin\" },\n * );\n * // \"Hello Hasan, your role is admin\"\n *\n * @example\n * renderPlaceholders(\"Hello {{user.name|friend}}\", {});\n * // \"Hello friend\"\n */\nexport function renderPlaceholders(\n  template: string,\n  placeholders: Placeholders = {},\n): string {\n  return template.replace(\n    PLACEHOLDER_PATTERN,\n    (match, rawExpression: string) => {\n      const [rawPath, rawFallback] = rawExpression.split(\"|\");\n      const path = rawPath.trim();\n      const fallback = rawFallback?.trim();\n\n      const value = lookupPath(placeholders, path);\n\n      if (value === undefined || value === null || value === \"\") {\n        if (fallback !== undefined) {\n          return fallback;\n        }\n\n        return match;\n      }\n\n      return String(value);\n    },\n  );\n}\n\n/**\n * Walk a dot-path (`\"a.b.c\"`) through an arbitrary record, returning the\n * leaf value or `undefined` when any segment is missing or blocks traversal\n * (non-object). Never throws.\n */\nfunction lookupPath(source: Placeholders, path: string): unknown {\n  const segments = path.split(\".\");\n  let current: unknown = source;\n\n  for (const segment of segments) {\n    if (current === null || current === undefined) {\n      return undefined;\n    }\n\n    if (typeof current !== \"object\") {\n      return undefined;\n    }\n\n    current = (current as Record<string, unknown>)[segment];\n  }\n\n  return current;\n}\n","import type { Placeholders } from \"../contracts/placeholders.type\";\nimport type { InstructionContract } from \"../contracts/system-prompt.contract\";\nimport { renderPlaceholders } from \"./render-placeholders\";\n\n/**\n * Concrete `InstructionContract` — a reusable directive block.\n *\n * **Role.** A single addressable prompt block representing one rule the\n * agent must follow (`\"Always respond in {{language|English}}.\"`). Exists\n * as its own type so the same instruction can be shared across many\n * prompts and agents, each render supplying its own placeholder map.\n *\n * **Responsibility.**\n * - Owns: the `type: \"instruction\"` discriminator, the raw template text,\n *   and the placeholder-rendering step.\n * - Does NOT own: ordering relative to other instructions, joining with a\n *   persona, or any surrounding prompt composition — those concerns live\n *   in `SystemPrompt`.\n *\n * Users construct via the `ai.instruction()` factory — `new Instruction()`\n * is not the public API (see §4.2 of code-style.md).\n *\n * @example\n * const replyInLanguage = ai.instruction(\"Respond in {{language|English}}.\");\n *\n * const prompt = ai.systemPrompt()\n *   .persona(\"You are Alex.\")\n *   .instruction(replyInLanguage)\n *   .instruction(\"Always include code examples.\");\n */\nexport class Instruction implements InstructionContract {\n  public readonly type = \"instruction\" as const;\n\n  public constructor(public readonly text: string) {\n    //\n  }\n\n  /**\n   * Substitute `{{mustache}}` placeholders in the instruction text against\n   * the supplied map. Delegates to the shared `renderPlaceholders` helper\n   * so persona / instruction / system-prompt rendering stays identical.\n   */\n  public resolve(placeholders?: Placeholders): string {\n    return renderPlaceholders(this.text, placeholders);\n  }\n}\n\n/**\n * Create an `Instruction` from raw template text.\n *\n * @example\n * const replyIn = instruction(\"Respond in {{language|English}}.\");\n * const cite = instruction(\"Always cite sources inline.\");\n */\nexport function instruction(text: string): Instruction {\n  return new Instruction(text);\n}\n","import type { Placeholders } from \"../contracts/placeholders.type\";\nimport type { PersonaContract } from \"../contracts/system-prompt.contract\";\nimport { renderPlaceholders } from \"./render-placeholders\";\n\n/**\n * Concrete `PersonaContract` — a reusable \"who the agent is\" block.\n *\n * **Role.** A single addressable prompt block representing the agent's\n * identity (`\"You are Alex, a senior TypeScript engineer.\"`). Exists as\n * its own type so personas can be defined once and reused across many\n * `SystemPrompt` compositions, agents, and sessions — each render can\n * supply a different placeholder map.\n *\n * **Responsibility.**\n * - Owns: the `type: \"persona\"` discriminator, the raw template text, and\n *   the placeholder-rendering step.\n * - Does NOT own: composition with instructions, ordering, joining, or\n *   any knowledge of the surrounding `SystemPrompt`. Those concerns live\n *   in `SystemPrompt`.\n *\n * Users construct via the `ai.persona()` factory — `new Persona()` is not\n * the public API (see §4.2 of code-style.md).\n *\n * @example\n * const alex = ai.persona(\"You are Alex, a TypeScript expert.\");\n *\n * const prompt = ai.systemPrompt()\n *   .persona(alex)\n *   .instruction(\"Always cite sources.\");\n */\nexport class Persona implements PersonaContract {\n  public readonly type = \"persona\" as const;\n\n  public constructor(public readonly text: string) {\n    //\n  }\n\n  /**\n   * Substitute `{{mustache}}` placeholders in the persona text against the\n   * supplied map. Delegates to the shared `renderPlaceholders` helper so\n   * persona / instruction / system-prompt rendering stays identical.\n   */\n  public resolve(placeholders?: Placeholders): string {\n    return renderPlaceholders(this.text, placeholders);\n  }\n}\n\n/**\n * Create a `Persona` from raw template text.\n *\n * @example\n * const alex = persona(\"You are Alex, a TypeScript expert.\");\n * const greeter = persona(\"You are a greeter in {{language|English}}.\");\n */\nexport function persona(text: string): Persona {\n  return new Persona(text);\n}\n","import type { Placeholders } from \"../contracts/placeholders.type\";\nimport type {\n  InstructionContract,\n  PersonaContract,\n  SystemPromptBlockContract,\n  SystemPromptContract,\n} from \"../contracts/system-prompt.contract\";\nimport { Instruction } from \"./instruction\";\nimport { Persona } from \"./persona\";\n\n/**\n * Concrete `SystemPromptContract` — an immutable layered prompt builder.\n *\n * **Role.** The top-level composer for a system prompt: it holds an ordered\n * list of typed blocks (persona + instructions) and resolves the whole\n * stack into one final string when the agent is about to call the model.\n *\n * **Responsibility.**\n * - Owns: the ordered `blocks` list and the block-join rules (insertion\n *   order, blank-line separator, trim).\n * - Does NOT own: how any individual block is rendered (delegated to each\n *   block's `resolve()`), the placeholder syntax (delegated to\n *   `renderPlaceholders`), or any knowledge of the agent, model, or\n *   session consuming the resolved text.\n *\n * Blocks are discriminated by a string `type` tag (`\"persona\"` /\n * `\"instruction\"`) rather than `instanceof`, so user-supplied blocks that\n * implement `SystemPromptBlockContract` interoperate seamlessly with blocks\n * built via `ai.persona()` / `ai.instruction()` — even across duplicate\n * package copies or bundler scope boundaries.\n *\n * The builder is **immutable** — every `.persona()` / `.instruction()`\n * call returns a fresh `SystemPrompt` instance sharing nothing mutable\n * with its parent. This makes forking a base prompt into specialized\n * variants a safe, side-effect-free operation.\n *\n * Users construct via the `ai.systemPrompt()` factory — `new SystemPrompt()`\n * is not the public API (see §4.2 of code-style.md). Modeled as a class so\n * that methods live on the prototype (one copy shared across every forked\n * instance) and downstream code can branch via `instanceof SystemPrompt`.\n *\n * @example\n * // Chainable form\n * const alex = ai.persona(\"You are Alex, a TypeScript expert.\");\n * const replyIn = ai.instruction(\"Respond in {{language|English}}.\");\n *\n * const base = ai.systemPrompt().persona(alex).instruction(replyIn);\n * const arabicVariant = base.instruction(\"Prefer Arabic comments.\");\n *\n * base.resolve({ language: \"English\" });\n * arabicVariant.resolve({ language: \"Arabic\" });\n *\n * @example\n * // Array form — insertion order is preserved exactly\n * const prompt = ai.systemPrompt([\n *   ai.persona(\"You are Alex, a TypeScript expert.\"),\n *   ai.instruction(\"Respond in {{language|English}}.\"),\n * ]);\n */\nexport class SystemPrompt implements SystemPromptContract {\n  public constructor(\n    public readonly blocks: readonly SystemPromptBlockContract[] = [],\n  ) {}\n\n  /**\n   * Return a new builder with the persona block set. If a persona already\n   * exists it's replaced in place (preserving its position in `blocks`);\n   * otherwise the new persona is prepended so persona-first remains the\n   * default for chain-built prompts. Accepts either raw text (auto-wrapped\n   * via `new Persona`) or an existing `PersonaContract` instance for reuse\n   * across prompts.\n   */\n  public persona(value: PersonaContract | string): SystemPromptContract {\n    const block = typeof value === \"string\" ? new Persona(value) : value;\n    const existingIndex = this.blocks.findIndex(\n      candidate => candidate.type === \"persona\",\n    );\n\n    if (existingIndex >= 0) {\n      const next = [...this.blocks];\n      next[existingIndex] = block;\n\n      return new SystemPrompt(next) as this;\n    }\n\n    return new SystemPrompt([block, ...this.blocks]);\n  }\n\n  /**\n   * Return a new builder with the given instruction appended. Instructions\n   * render in insertion order. Accepts either raw text (auto-wrapped via\n   * `new Instruction`) or an existing `InstructionContract` instance for\n   * cross-prompt reuse.\n   */\n  public instruction(\n    value: InstructionContract | string,\n  ): SystemPromptContract {\n    const block = typeof value === \"string\" ? new Instruction(value) : value;\n\n    return new SystemPrompt([...this.blocks, block]);\n  }\n\n  /**\n   * Resolve every block against the placeholder map, join the results with\n   * blank-line separators (in insertion order), and trim. Returns an empty\n   * string when no blocks are present — callers treat that as \"no system\n   * message\".\n   */\n  public resolve(placeholders?: Placeholders): string {\n    return this.blocks\n      .map(block => block.resolve(placeholders))\n      .join(\"\\n\\n\")\n      .trim();\n  }\n}\n\n/**\n * Create a new immutable system-prompt builder.\n *\n * **Role.** Public factory for `SystemPrompt` — keeps user-facing code\n * free of `new` and consistent with `ai.tool()`, `ai.agent()`,\n * `ai.persona()`, `ai.instruction()`.\n *\n * Three input forms:\n * - No argument → empty builder, chain `.persona()` / `.instruction()`\n * - Single string → seeded with one instruction for quick one-shot prompts\n * - Array of blocks → used verbatim, preserving insertion order\n *\n * @example\n * // Composed builder\n * const prompt = systemPrompt()\n *   .persona(\"You are Alex, a senior TypeScript engineer.\")\n *   .instruction(\"Always include working code examples.\")\n *   .instruction(\"Respond in {{language|English}}.\");\n *\n * prompt.resolve({ language: \"Arabic\" });\n *\n * @example\n * // One-shot seed\n * const prompt = systemPrompt(\"Answer only with JSON matching the schema.\");\n *\n * @example\n * // Array form — fully declarative\n * const prompt = systemPrompt([\n *   ai.persona(\"You are Alex.\"),\n *   ai.instruction(\"Always cite sources.\"),\n *   ai.instruction(\"Respond in {{language|English}}.\"),\n * ]);\n */\nexport function systemPrompt(\n  input?: string | ReadonlyArray<SystemPromptBlockContract>,\n): SystemPrompt {\n  if (input === undefined) {\n    return new SystemPrompt();\n  }\n\n  if (typeof input === \"string\") {\n    return new SystemPrompt([new Instruction(input)]);\n  }\n\n  return new SystemPrompt([...input]);\n}\n","import type { StepDefinition } from \"../contracts/workflow/step.contract\";\nimport { WorkflowError } from \"../errors\";\n\n/**\n * `ai.step(def)` — pass-through factory used for authoring. Returns\n * the definition object verbatim so the workflow engine can read it\n * during execution; the factory exists for API symmetry with\n * `ai.workflow()` and to leave room for future validation or\n * metadata annotation.\n *\n * Generics flow from the enclosing `ai.workflow<...>()` call when the\n * step is declared inline inside `steps: [...]`. To author a step\n * outside that context with full typing, pass them explicitly:\n * `ai.step<MyInput, MyState, MyContext>({ ... })`.\n */\nexport function step<\n  TInput = unknown,\n  TState = Record<string, unknown>,\n  TContext = unknown,\n>(\n  definition: StepDefinition<TInput, TState, TContext>,\n): StepDefinition<TInput, TState, TContext> {\n  validate(definition);\n  return definition;\n}\n\nfunction validate<TInput, TState, TContext>(\n  def: StepDefinition<TInput, TState, TContext>,\n): void {\n  if (!def.name || typeof def.name !== \"string\") {\n    throw new WorkflowError(\"ai.step: `name` is required\");\n  }\n\n  const hasRun = typeof def.run === \"function\";\n  const hasAgent = def.agent !== undefined;\n  const hasParallel = Array.isArray(def.parallel) && def.parallel.length > 0;\n\n  const modes = [hasRun, hasAgent, hasParallel].filter(Boolean).length;\n\n  if (modes === 0) {\n    throw new WorkflowError(\n      `ai.step(\"${def.name}\"): must define exactly one of run | agent | parallel`,\n    );\n  }\n\n  if (modes > 1) {\n    throw new WorkflowError(\n      `ai.step(\"${def.name}\"): define only one of run | agent | parallel`,\n    );\n  }\n\n  if (hasAgent && typeof def.input !== \"function\") {\n    throw new WorkflowError(\n      `ai.step(\"${def.name}\"): \\`input(ctx)\\` is required when \\`agent\\` is set`,\n    );\n  }\n}\n","import type { StandardSchemaV1 } from \"@standard-schema/spec\";\nimport type { WorkflowInstance } from \"../contracts/workflow/workflow.contract\";\nimport { WorkflowError } from \"../errors\";\nimport { compositeAsTool, type ToolContract } from \"../tool/tool\";\n\n/**\n * Wrap a `WorkflowInstance` as a `ToolContract` so an agent can invoke\n * it inside its tool-call loop. Closes the agent-calls-workflow\n * composition gap.\n *\n * Behavior:\n * - Tool `name` mirrors `workflow.name` — workflows without a name throw\n *   `WorkflowError` at wrap time (the agent surface needs a stable id).\n * - Tool `input` is the supplied `inputSchema`; the validated value is\n *   forwarded straight to `workflow.execute(input)`.\n * - On `result.error`, the workflow error is wrapped in\n *   `ToolExecutionError` with `cause` set to the original\n *   `WorkflowError` subclass — the agent's tool-call loop sees a\n *   uniform error class regardless of which primitive failed.\n *\n * **Usage caveat (deferred to Phase 2):** the parent agent's\n * `result.usage` does NOT roll up tokens consumed inside the wrapped\n * workflow today. Nested-usage standardization lands with the\n * supervisor work; until then, sum workflow + agent usage manually if\n * you need a combined cost figure.\n *\n * @example\n * const wf = workflow({ name: \"triage\", steps: [...] });\n * const triageTool = asTool(wf, {\n *   description: \"Run the support-ticket triage flow\",\n *   inputSchema: ticketSchema,\n * });\n * const a = ai.agent({ model, tools: [triageTool] });\n */\nexport function asTool<TInput, TOutput, TToolInput = TInput>(\n  workflowInstance: WorkflowInstance<TInput, TOutput>,\n  options: {\n    description?: string;\n    inputSchema: StandardSchemaV1<TToolInput>;\n  },\n): ToolContract<TToolInput, TOutput> {\n  if (!workflowInstance.name || typeof workflowInstance.name !== \"string\") {\n    throw new WorkflowError(\n      \"workflow.asTool(): workflow must have a `name` to be wrapped as a tool\",\n    );\n  }\n\n  return compositeAsTool<TToolInput, TOutput>({\n    name: workflowInstance.name,\n    description: options.description ?? `Invoke workflow \"${workflowInstance.name}\" as a tool.`,\n    input: options.inputSchema,\n    execute: async (input) => {\n      const result = await workflowInstance.execute(input as unknown as TInput);\n\n      if (result.error) {\n        // Throw the workflow error so the surrounding wrapper catches\n        // it and produces a `ToolExecutionError` with `cause` pointing\n        // back at the original `WorkflowError` subclass — keeps the\n        // agent's tool-call loop seeing one uniform error class\n        // regardless of which primitive failed.\n        throw result.error;\n      }\n\n      return {\n        data: result.data as TOutput,\n        usage: result.usage,\n        report: result.report,\n      };\n    },\n  });\n}\n","import type { WithoutIdentity } from \"../contracts/events/event-identity.type\";\nimport type { WorkflowEventMap } from \"../contracts/events/event-map.type\";\nimport type {\n  WorkflowEventHandler,\n  WorkflowEventHandlers,\n} from \"../contracts/workflow/workflow.contract\";\n\ntype AnyHandler = WorkflowEventHandler<keyof WorkflowEventMap>;\n\n/**\n * The emit surface the workflow engine and step-runner depend on.\n * They never construct run identity themselves — they hand a bare\n * payload to a sink that injects `runId` / `rootRunId` before\n * delegating to the real three-tier `WorkflowEmitter`.\n *\n * `WorkflowEmitter` is factory-scoped (shared across every\n * `execute()`), so it cannot own per-run identity. A per-run sink\n * (see `runScopedEmitter`) closes that gap without touching the ~15\n * `emit` call sites in `engine.ts` / `step-runner.ts`.\n */\nexport interface WorkflowEventSink {\n  emit<K extends keyof WorkflowEventMap>(\n    event: K,\n    payload: WithoutIdentity<WorkflowEventMap[K]>,\n    executionHandlers?: WorkflowEventHandlers,\n  ): void;\n}\n\n/**\n * Three-tier workflow event emitter — factory (definition) → instance →\n * per-execution. All matching handlers fire, in layer order. Handler\n * errors are swallowed so listener bugs can never derail the workflow.\n */\nexport class WorkflowEmitter {\n  private readonly factoryHandlers?: WorkflowEventHandlers;\n  private readonly instanceHandlers = new Map<\n    keyof WorkflowEventMap,\n    Set<AnyHandler>\n  >();\n\n  public constructor(factoryHandlers?: WorkflowEventHandlers) {\n    this.factoryHandlers = factoryHandlers;\n  }\n\n  public on<K extends keyof WorkflowEventMap>(\n    event: K,\n    handler: WorkflowEventHandler<K>,\n  ): () => void {\n    let bucket = this.instanceHandlers.get(event);\n    if (!bucket) {\n      bucket = new Set();\n      this.instanceHandlers.set(event, bucket);\n    }\n    bucket.add(handler as AnyHandler);\n    return () => this.off(event, handler);\n  }\n\n  public off<K extends keyof WorkflowEventMap>(\n    event: K,\n    handler: WorkflowEventHandler<K>,\n  ): void {\n    this.instanceHandlers.get(event)?.delete(handler as AnyHandler);\n  }\n\n  public emit<K extends keyof WorkflowEventMap>(\n    event: K,\n    payload: WorkflowEventMap[K],\n    executionHandlers?: WorkflowEventHandlers,\n  ): void {\n    // Layer 1 — factory\n    invoke(this.factoryHandlers?.[event], payload);\n\n    // Layer 2 — instance (set-based, possibly many handlers)\n    const bucket = this.instanceHandlers.get(event);\n    if (bucket) {\n      for (const handler of bucket) invoke(handler, payload);\n    }\n\n    // Layer 3 — per-execution\n    invoke(executionHandlers?.[event], payload);\n  }\n}\n\nfunction invoke<K extends keyof WorkflowEventMap>(\n  handler: ((payload: WorkflowEventMap[K]) => void) | undefined,\n  payload: WorkflowEventMap[K],\n): void {\n  if (typeof handler !== \"function\") return;\n  try {\n    handler(payload);\n  } catch {\n    // Swallow — listener bugs must not derail workflow execution.\n  }\n}\n","import { WorkflowCancelledError } from \"../errors\";\n\n/**\n * Build a `WorkflowCancelledError` from an `AbortSignal`, extracting\n * a human-readable reason from `signal.reason` (string | Error | any).\n * Used both at between-step boundaries and inside the retry backoff\n * sleep.\n */\nexport function createCancelledError(\n  signal: AbortSignal | undefined,\n): WorkflowCancelledError {\n  const reason = signal?.reason;\n  const reasonText =\n    typeof reason === \"string\"\n      ? reason\n      : reason instanceof Error\n        ? reason.message\n        : reason === undefined\n          ? \"\"\n          : String(reason);\n\n  return new WorkflowCancelledError(\n    `workflow cancelled${reasonText ? `: ${reasonText}` : \"\"}`,\n    { cancelledAt: new Date().toISOString(), reason: reasonText },\n  );\n}\n\n/**\n * Promise-based sleep that resolves after `ms` milliseconds, or\n * rejects with `WorkflowCancelledError` if the signal fires. The\n * timer is cleared on abort so we never leak a pending setTimeout.\n */\nexport function sleep(ms: number, signal?: AbortSignal): Promise<void> {\n  return new Promise((resolve, reject) => {\n    if (signal?.aborted) {\n      reject(createCancelledError(signal));\n      return;\n    }\n\n    const timer = setTimeout(() => {\n      signal?.removeEventListener(\"abort\", onAbort);\n      resolve();\n    }, ms);\n\n    const onAbort = () => {\n      clearTimeout(timer);\n      reject(createCancelledError(signal));\n    };\n\n    signal?.addEventListener(\"abort\", onAbort, { once: true });\n  });\n}\n","import type { NextStepResult } from \"../contracts/workflow/next-step-result.type\";\nimport type { StepDefinition } from \"../contracts/workflow/step.contract\";\nimport type { WorkflowContext } from \"../contracts/workflow/workflow-context.type\";\nimport type { WorkflowDefinition } from \"../contracts/workflow/workflow.contract\";\nimport { RoutingError } from \"../errors\";\n\n/**\n * Resolve the next step to run after `step` completes. Tries\n * step-level `nextStep` first, then workflow-level, then falls\n * through (returns `undefined`, engine picks the next declared step).\n *\n * Throws `RoutingError` when either callback throws — routing is\n * authoritative, so a broken router terminates the workflow instead\n * of being retried.\n */\nexport async function resolveNextStep<T>(params: {\n  step: StepDefinition;\n  definition: WorkflowDefinition<any, T, any, any>;\n  ctx: WorkflowContext;\n}): Promise<\"end\" | string | undefined> {\n  const { step, definition, ctx } = params;\n\n  if (step.nextStep) {\n    let outcome: NextStepResult;\n    try {\n      outcome = await step.nextStep(ctx);\n    } catch (err) {\n      throw new RoutingError(\n        `workflow \"${definition.name}\": step \"${step.name}\" nextStep threw`,\n        { stepName: step.name, cause: err },\n      );\n    }\n    const mapped = mapNextStep(outcome);\n    if (mapped !== undefined) return mapped;\n  }\n\n  if (definition.nextStep) {\n    let outcome: NextStepResult;\n    try {\n      outcome = await definition.nextStep(step.name, ctx);\n    } catch (err) {\n      throw new RoutingError(\n        `workflow \"${definition.name}\": workflow-level nextStep threw after \"${step.name}\"`,\n        { stepName: step.name, cause: err },\n      );\n    }\n    const mapped = mapNextStep(outcome);\n    if (mapped !== undefined) return mapped;\n  }\n\n  return undefined;\n}\n\nexport function mapNextStep(\n  outcome: NextStepResult,\n): \"end\" | string | undefined {\n  if (!outcome) return undefined;\n  if (\"end\" in outcome && outcome.end === true) return \"end\";\n  if (\"goto\" in outcome && typeof outcome.goto === \"string\")\n    return outcome.goto;\n  return undefined;\n}\n\nexport function nextDeclaredStep<T>(\n  definition: WorkflowDefinition<any, T, any, any>,\n  currentName: string,\n): string | null {\n  const idx = definition.steps.findIndex(s => s.name === currentName);\n  if (idx === -1) return null;\n  return definition.steps[idx + 1]?.name ?? null;\n}\n","import type { EventIdentity } from \"../contracts/events/event-identity.type\";\nimport type { WorkflowEventMap } from \"../contracts/events/event-map.type\";\nimport type { WorkflowEventHandlers } from \"../contracts/workflow/workflow.contract\";\nimport type { WorkflowEmitter, WorkflowEventSink } from \"./emitter\";\n\n/**\n * Bind a factory-scoped `WorkflowEmitter` to one run's identity.\n *\n * The engine and step-runner emit bare payloads through this sink;\n * it injects `runId` / `rootRunId` once and delegates to the real\n * three-tier emitter. This is the single place workflow run identity\n * is stamped — the alternative (editing every `emitter.emit` call\n * site) would be ~15 scattered edits and easy to miss one.\n *\n * `rootRunId === runId` for a standalone run; nested propagation\n * (a child workflow inheriting an outer run's root) lands in a\n * follow-up.\n *\n * @example\n * // Inside runWorkflow(), once per execution:\n * const emitter = runScopedEmitter(params.emitter, { runId, rootRunId: runId });\n * emitter.emit(\"workflow.starting\", { workflowName, input }, executionHandlers);\n */\nexport function runScopedEmitter(\n  emitter: WorkflowEmitter,\n  identity: EventIdentity,\n): WorkflowEventSink {\n  return {\n    emit(event, payload, executionHandlers?: WorkflowEventHandlers) {\n      const fullPayload = {\n        ...payload,\n        ...identity,\n      } as WorkflowEventMap[typeof event];\n\n      emitter.emit(event, fullPayload, executionHandlers);\n    },\n  };\n}\n","import { resolveDefaultStore } from \"../config\";\nimport type { StepSnapshot } from \"../contracts/result/step-result.type\";\nimport type { WorkflowSnapshot } from \"../contracts/workflow/workflow-snapshot.type\";\nimport type {\n  WorkflowDefinition,\n  WorkflowResumeOptions,\n} from \"../contracts/workflow/workflow.contract\";\nimport { WorkflowDriftError, WorkflowError } from \"../errors\";\n\n/**\n * Resolve the effective snapshot store: the workflow's own\n * `snapshotStore` field wins; absent that, fall back to the global\n * default set via `ai.config({ defaultStore })`.\n */\nfunction resolveSnapshotStore<T>(definition: WorkflowDefinition<any, T, any, any>) {\n  return definition.snapshotStore ?? resolveDefaultStore();\n}\n\nexport type PersistParams<T> = {\n  definition: WorkflowDefinition<any, T, any, any>;\n  signature: string;\n  runId: string;\n  startedAt: string;\n  input: unknown;\n  state: Record<string, unknown>;\n  steps: Record<string, StepSnapshot>;\n  next: string | null;\n  status: WorkflowSnapshot[\"status\"];\n};\n\nexport type PersistOutcome = { ok: true } | { ok: false; error: unknown };\n\n/**\n * Write the current run's state to the configured `KVStore`. Returns\n * an outcome object instead of throwing so the engine can surface\n * persistence failures via events + logs without aborting the run.\n * Callers decide whether a failed checkpoint is fatal.\n *\n * No-op (returns `{ ok: true }`) when the workflow has no store\n * configured — the common in-memory test case.\n */\nexport async function persistSnapshot<T>(\n  params: PersistParams<T>,\n): Promise<PersistOutcome> {\n  const store = resolveSnapshotStore(params.definition);\n\n  if (!store) return { ok: true };\n\n  const snapshot: WorkflowSnapshot = {\n    runId: params.runId,\n    workflowName: params.definition.name,\n    signature: params.signature,\n    version: params.definition.version,\n    input: params.input,\n    state: { ...params.state },\n    steps: { ...params.steps },\n    next: params.next,\n    status: params.status,\n    startedAt: params.startedAt,\n    savedAt: new Date().toISOString(),\n  };\n\n  try {\n    await store.set(params.runId, snapshot);\n    return { ok: true };\n  } catch (err) {\n    return { ok: false, error: err };\n  }\n}\n\n/**\n * Load a prior run's snapshot from the store and run the drift\n * check. Throws `WorkflowError` when no snapshot exists, and\n * `WorkflowDriftError` when the stored signature doesn't match the\n * current definition (unless `force` is set).\n */\nexport async function loadSnapshotForResume<T>(params: {\n  definition: WorkflowDefinition<any, T, any, any>;\n  signature: string;\n  runId: string;\n  options?: WorkflowResumeOptions;\n}): Promise<WorkflowSnapshot> {\n  const store = resolveSnapshotStore(params.definition);\n\n  if (!store) {\n    throw new WorkflowError(\n      `workflow \"${params.definition.name}\" has no store configured — set \\`snapshotStore\\` on the definition or call \\`ai.config({ defaultStore })\\` at boot before calling resume()`,\n    );\n  }\n\n  const snap = (await store.get<WorkflowSnapshot>(params.runId)) ?? null;\n\n  if (!snap) {\n    throw new WorkflowError(\n      `workflow \"${params.definition.name}\": no snapshot for runId \"${params.runId}\"`,\n    );\n  }\n\n  if (!params.options?.force && snap.signature !== params.signature) {\n    throw new WorkflowDriftError(\n      `workflow \"${params.definition.name}\" signature drift on resume`,\n      {\n        savedSignature: snap.signature,\n        currentSignature: params.signature,\n        runId: params.runId,\n      },\n    );\n  }\n\n  return snap;\n}\n","import { WorkflowError } from \"../errors\";\n\n/**\n * Deep-clone workflow state. Uses `structuredClone` — handles Date,\n * Map, Set, ArrayBuffer, nested objects, arrays, primitives. Throws\n * a typed `WorkflowError` on older runtimes (pre-Node-17) rather\n * than silently falling back to a JSON round-trip that would drop\n * non-serializable values like Dates without warning.\n *\n * Workflow state should stay serializable anyway (it round-trips\n * through `KVStore` on every checkpoint). If `structuredClone` chokes\n * on a value, that's a bug in the user's state — surface it.\n */\nexport function cloneState<T>(value: T): T {\n  if (typeof structuredClone !== \"function\") {\n    throw new WorkflowError(\n      \"workflow state cloning requires `structuredClone` (Node 17+ or a modern browser)\",\n    );\n  }\n\n  return structuredClone(value);\n}\n\n/**\n * Recursively freeze `value` and every nested plain object / array so\n * consumers of `ctx.steps[x].state` or `report.state` can't mutate\n * historical snapshots. Already-frozen values are skipped.\n */\nexport function deepFreeze<T>(value: T): T {\n  if (value === null || typeof value !== \"object\") return value;\n  if (Object.isFrozen(value)) return value;\n\n  for (const key of Object.keys(value as Record<string, unknown>)) {\n    const child = (value as Record<string, unknown>)[key];\n    if (child && typeof child === \"object\") deepFreeze(child);\n  }\n\n  return Object.freeze(value);\n}\n","import type {\n  RetryBackoff,\n  RetryConfig,\n} from \"../contracts/workflow/retry-config.type\";\n\nexport const DEFAULT_BACKOFF_CAP_MS = 30_000;\n\nexport function resolveBackoff(\n  attempt: number,\n  backoff: RetryBackoff | undefined,\n): number {\n  const value = (() => {\n    switch (backoff) {\n      case \"none\":\n        return 0;\n      case \"linear\":\n        return attempt * 500;\n      case \"exponential\":\n      case undefined:\n        return 500 * 2 ** (attempt - 1);\n      default:\n        return backoff(attempt);\n    }\n  })();\n\n  return Math.max(0, Math.min(value, DEFAULT_BACKOFF_CAP_MS));\n}\n\nexport function isAbortError(error: unknown): boolean {\n  if (!error || typeof error !== \"object\") return false;\n  const name = (error as { name?: unknown }).name;\n  return name === \"AbortError\";\n}\n\n/**\n * Resolve the effective retry config for a step, merging per-step and\n * workflow-level defaults. `retry: false` disables retries entirely.\n */\nexport function resolveRetryConfig(\n  step: { retry?: RetryConfig | false } | undefined,\n  workflowDefault: RetryConfig | false | undefined,\n): RetryConfig {\n  if (step?.retry === false) return { attempts: 1 };\n  if (step?.retry) return step.retry;\n  if (workflowDefault === false || workflowDefault === undefined) {\n    return { attempts: 1 };\n  }\n  return workflowDefault;\n}\n","import type { StandardSchemaV1 } from \"@standard-schema/spec\";\nimport type { Logger } from \"@warlock.js/logger\";\nimport type { AgentResult } from \"../contracts/result/agent-result.type\";\nimport type { AgentReport } from \"../contracts/result/execution-report.type\";\nimport type { AttemptEntry, StepSnapshot } from \"../contracts/result/step-result.type\";\nimport type { Usage } from \"../contracts/result/usage.type\";\nimport type { RetryConfig } from \"../contracts/workflow/retry-config.type\";\nimport type { StepDefinition } from \"../contracts/workflow/step.contract\";\nimport type { WorkflowContext } from \"../contracts/workflow/workflow-context.type\";\nimport type { WorkflowEventHandlers } from \"../contracts/workflow/workflow.contract\";\nimport {\n  AIError,\n  SchemaValidationError,\n  StepFailedError,\n  WorkflowCancelledError,\n  WorkflowError,\n} from \"../errors\";\nimport { createCancelledError, sleep } from \"./cancellation\";\nimport type { WorkflowEventSink } from \"./emitter\";\nimport { isAbortError, resolveBackoff, resolveRetryConfig } from \"./retry\";\nimport { cloneState, deepFreeze } from \"./state\";\n\n/**\n * Mutable snapshot used by the step runner — finalized (deep-frozen)\n * by the engine before being written to `ctx.steps` / `report.steps`.\n */\nexport type MutableStepSnapshot = {\n  output: unknown;\n  skipped: boolean;\n  status: \"completed\" | \"skipped\" | \"failed\";\n  startedAt: string;\n  endedAt: string;\n  duration: number;\n  attempts: number;\n  attemptHistory: AttemptEntry[];\n  error?: AIError;\n  state: Record<string, unknown>;\n  executionResult?: unknown;\n  agentReport?: AgentReport;\n  agentUsage?: Usage;\n  steps?: Record<string, StepSnapshot>;\n};\n\n/**\n * Narrow an `executionResult` to an `AgentResult` when the step ran\n * an agent. Custom `run` steps return arbitrary values, so the\n * `type: \"agent\"` discriminant keeps us honest.\n */\nfunction asAgentResult(result: unknown): AgentResult<unknown> | undefined {\n  if (!result || typeof result !== \"object\") return undefined;\n  if ((result as { type?: unknown }).type !== \"agent\") return undefined;\n  return result as AgentResult<unknown>;\n}\n\nexport type ExecuteStepParams = {\n  step: StepDefinition;\n  state: Record<string, unknown>;\n  emitter: WorkflowEventSink;\n  executionHandlers?: WorkflowEventHandlers;\n  logger: Logger;\n  logModule: string;\n  signal?: AbortSignal;\n  buildContext: (current?: {\n    state: Record<string, unknown>;\n    agentResult?: unknown;\n  }) => WorkflowContext;\n  usage: Usage;\n  workflowDefaultRetry?: RetryConfig | false;\n};\n\n/**\n * Drive one step's full lifecycle — skip evaluation, parallel\n * dispatch, retry loop around before → run|agent → output → after.\n * Returns a mutable snapshot; the engine deep-freezes it before\n * exposing.\n */\nexport async function executeStep(params: ExecuteStepParams): Promise<MutableStepSnapshot> {\n  const { step, emitter, executionHandlers, logger, logModule, signal } = params;\n  const startedAt = new Date().toISOString();\n  const stepStartPerf = performance.now();\n\n  params.step.on?.starting?.({ step: step.name });\n  emitter.emit(\"workflow.step.starting\", { step: step.name }, executionHandlers);\n  logger.debug(logModule, \"step.starting\", `${step.name} step starting`, {\n    step: step.name,\n  });\n\n  const stepState: Record<string, unknown> = cloneState(params.state);\n\n  // SKIP\n  try {\n    if (step.skip) {\n      const shouldSkip = await step.skip(params.buildContext({ state: stepState }));\n      if (shouldSkip) {\n        const endedAt = new Date().toISOString();\n        const duration = performance.now() - stepStartPerf;\n        emitter.emit(\"workflow.step.skipped\", { step: step.name }, executionHandlers);\n        logger.debug(logModule, \"step.skipped\", `${step.name} step skipped`, {\n          step: step.name,\n        });\n\n        return {\n          output: undefined,\n          skipped: true,\n          status: \"skipped\",\n          startedAt,\n          endedAt,\n          duration,\n          attempts: 0,\n          attemptHistory: [],\n          state: stepState,\n        };\n      }\n    }\n  } catch (err) {\n    return buildFailedSnapshot(step, stepState, startedAt, stepStartPerf, 1, [\n      failedAttempt(1, err, new Date().toISOString(), performance.now()),\n    ]);\n  }\n\n  // PARALLEL\n  if (step.parallel && step.parallel.length > 0) {\n    return runParallelStep({\n      ...params,\n      step,\n      stepState,\n      startedAt,\n      startPerf: stepStartPerf,\n    });\n  }\n\n  const retryConfig = resolveRetryConfig(step, params.workflowDefaultRetry);\n\n  const attempts: AttemptEntry[] = [];\n  const totalAttempts = Math.max(1, retryConfig.attempts ?? 1);\n  let lastError: unknown;\n  let executionResult: unknown;\n  let output: unknown;\n  let succeeded = false;\n\n  for (let attempt = 1; attempt <= totalAttempts; attempt++) {\n    if (signal?.aborted) throw createCancelledError(signal);\n\n    const attemptStart = new Date().toISOString();\n    const attemptStartPerf = performance.now();\n    try {\n      // Fresh deep-clone per attempt — retries restart cleanly.\n      const attemptState: Record<string, unknown> = cloneState(params.state);\n\n      if (step.before) {\n        await step.before(params.buildContext({ state: attemptState }));\n      }\n\n      if (step.agent) {\n        const agentInput = step.input\n          ? await step.input(params.buildContext({ state: attemptState }))\n          : { prompt: \"\" };\n\n        const { prompt, ...agentOpts } = agentInput;\n\n        const result = await step.agent.execute(prompt, {\n          ...agentOpts,\n          signal,\n        });\n\n        executionResult = result;\n\n        if (result.usage) {\n          params.usage.input += result.usage.input ?? 0;\n          params.usage.output += result.usage.output ?? 0;\n          params.usage.total += result.usage.total ?? 0;\n        }\n\n        if (result.error) throw result.error;\n      } else if (step.run) {\n        executionResult = await step.run(params.buildContext({ state: attemptState }));\n      }\n\n      if (step.output) {\n        const extracted = await step.output.extract(\n          params.buildContext({\n            state: attemptState,\n            agentResult: executionResult,\n          }),\n        );\n        output = await validateSchema(step.output.schema, extracted);\n      } else {\n        output = undefined;\n      }\n\n      if (step.after) {\n        await step.after(\n          params.buildContext({\n            state: attemptState,\n            agentResult: executionResult,\n          }),\n        );\n      }\n\n      Object.assign(stepState, attemptState);\n\n      attempts.push({\n        index: attempt,\n        startedAt: attemptStart,\n        endedAt: new Date().toISOString(),\n        duration: performance.now() - attemptStartPerf,\n        status: \"success\",\n      });\n      succeeded = true;\n      break;\n    } catch (err) {\n      if (isAbortError(err) || err instanceof WorkflowCancelledError) {\n        throw createCancelledError(signal);\n      }\n\n      attempts.push({\n        index: attempt,\n        startedAt: attemptStart,\n        endedAt: new Date().toISOString(),\n        duration: performance.now() - attemptStartPerf,\n        status: \"failed\",\n        error: toAIError(err),\n      });\n\n      lastError = err;\n\n      const shouldRetry =\n        attempt < totalAttempts &&\n        (retryConfig.retryOn ? retryConfig.retryOn(err, attempt) !== false : true);\n\n      if (!shouldRetry) break;\n\n      emitter.emit(\n        \"workflow.step.retrying\",\n        {\n          step: step.name,\n          attempt: attempt + 1,\n          totalAttempts,\n          lastError: err,\n        },\n        params.executionHandlers,\n      );\n\n      step.on?.retrying?.({\n        step: step.name,\n        attempt: attempt + 1,\n        totalAttempts,\n        lastError: err,\n      });\n\n      logger.warn(logModule, \"step.retrying\", `${step.name} step retrying`, {\n        step: step.name,\n        attempt: attempt + 1,\n      });\n\n      retryConfig.onRetry?.(attempt + 1, err);\n\n      const delay = resolveBackoff(attempt, retryConfig.backoff);\n      if (delay > 0) await sleep(delay, signal);\n    }\n  }\n\n  const endedAt = new Date().toISOString();\n  const duration = performance.now() - stepStartPerf;\n\n  if (!succeeded) {\n    const aiError = toAIError(lastError);\n    const stepError = new StepFailedError(\n      `step \"${step.name}\" failed after ${attempts.length} attempt(s): ${aiError.message}`,\n      { stepName: step.name, attempts: attempts.length, cause: aiError },\n    );\n\n    emitter.emit(\n      \"workflow.step.failed\",\n      { step: step.name, error: stepError, attempts: attempts.length },\n      params.executionHandlers,\n    );\n\n    step.on?.failed?.({\n      step: step.name,\n      error: stepError,\n      attempts: attempts.length,\n    });\n\n    logger.error(logModule, \"step.failed\", `${step.name} step failed`, {\n      step: step.name,\n      attempts: attempts.length,\n      code: stepError.code,\n    });\n\n    const failedAgentResult = asAgentResult(executionResult);\n    return {\n      output: undefined,\n      skipped: false,\n      status: \"failed\",\n      startedAt,\n      endedAt,\n      duration,\n      attempts: attempts.length,\n      attemptHistory: attempts,\n      error: stepError,\n      state: stepState,\n      executionResult:\n        executionResult && typeof executionResult === \"object\" ? executionResult : undefined,\n      agentReport: failedAgentResult?.report,\n      agentUsage: failedAgentResult?.usage,\n    };\n  }\n\n  emitter.emit(\n    \"workflow.step.completed\",\n    { step: step.name, output, duration },\n    params.executionHandlers,\n  );\n  step.on?.completed?.({ step: step.name, output, duration });\n  logger.debug(logModule, \"step.completed\", \"step completed\", {\n    step: step.name,\n    duration,\n  });\n\n  const completedAgentResult = asAgentResult(executionResult);\n  return {\n    output,\n    skipped: false,\n    status: \"completed\",\n    startedAt,\n    endedAt,\n    duration,\n    attempts: attempts.length,\n    attemptHistory: attempts,\n    state: stepState,\n    executionResult:\n      executionResult && typeof executionResult === \"object\" ? executionResult : undefined,\n    agentReport: completedAgentResult?.report,\n    agentUsage: completedAgentResult?.usage,\n  };\n}\n\n// ---------------------------------------------------------------------------\n// Parallel runner\n// ---------------------------------------------------------------------------\n\ntype ParallelParams = ExecuteStepParams & {\n  stepState: Record<string, unknown>;\n  startedAt: string;\n  startPerf: number;\n};\n\nasync function runParallelStep(params: ParallelParams): Promise<MutableStepSnapshot> {\n  const { step, emitter, executionHandlers, logger, logModule, signal } = params;\n\n  const sharedState = params.stepState;\n  const childSnapshots: Record<string, StepSnapshot> = {};\n  let firstError: AIError | undefined;\n\n  const results = await Promise.all(\n    (step.parallel ?? []).map(async (child) => {\n      const snap = await executeStep({\n        step: child,\n        state: sharedState,\n        emitter,\n        executionHandlers,\n        logger,\n        logModule,\n        signal,\n        buildContext: params.buildContext,\n        usage: params.usage,\n      });\n\n      Object.assign(sharedState, snap.state);\n      return { child, snap };\n    }),\n  );\n\n  for (const { child, snap } of results) {\n    childSnapshots[child.name] = finalizeSnapshot(snap);\n    if (snap.status === \"failed\" && !firstError && snap.error) {\n      firstError = snap.error;\n    }\n  }\n\n  const endedAt = new Date().toISOString();\n  const duration = performance.now() - params.startPerf;\n\n  let output: unknown;\n\n  if (step.output) {\n    try {\n      const ctx = params.buildContext({ state: sharedState });\n      const ctxWithChildren = {\n        ...ctx,\n        steps: {\n          ...ctx.steps,\n          [step.name]: {\n            ...(childSnapshots as unknown as StepSnapshot),\n            steps: childSnapshots,\n            status: firstError ? \"failed\" : \"completed\",\n          } as StepSnapshot,\n        } as Readonly<Record<string, StepSnapshot>>,\n      };\n\n      const extracted = await step.output.extract(ctxWithChildren);\n      output = await validateSchema(step.output.schema, extracted);\n    } catch (err) {\n      firstError = firstError ?? toAIError(err);\n    }\n  }\n\n  const status: \"completed\" | \"failed\" = firstError ? \"failed\" : \"completed\";\n\n  if (status === \"completed\") {\n    emitter.emit(\n      \"workflow.step.completed\",\n      { step: step.name, output, duration },\n      executionHandlers,\n    );\n    step.on?.completed?.({ step: step.name, output, duration });\n  } else {\n    emitter.emit(\n      \"workflow.step.failed\",\n      { step: step.name, error: firstError!, attempts: 1 },\n      executionHandlers,\n    );\n    step.on?.failed?.({ step: step.name, error: firstError!, attempts: 1 });\n  }\n\n  return {\n    output,\n    skipped: false,\n    status,\n    startedAt: params.startedAt,\n    endedAt,\n    duration,\n    attempts: 1,\n    attemptHistory: [],\n    error: firstError,\n    state: sharedState,\n    steps: childSnapshots,\n  };\n}\n\n// ---------------------------------------------------------------------------\n// Helpers\n// ---------------------------------------------------------------------------\n\nexport function finalizeSnapshot(snap: MutableStepSnapshot): StepSnapshot {\n  return Object.freeze({\n    output: snap.output,\n    skipped: snap.skipped,\n    status: snap.status,\n    startedAt: snap.startedAt,\n    endedAt: snap.endedAt,\n    duration: snap.duration,\n    attempts: snap.attempts,\n    attemptHistory: snap.attemptHistory,\n    error: snap.error,\n    state: deepFreeze(cloneState(snap.state)),\n    executionResult: snap.executionResult as StepSnapshot[\"executionResult\"],\n    agentReport: snap.agentReport,\n    agentUsage: snap.agentUsage,\n    steps: snap.steps,\n  }) as StepSnapshot;\n}\n\nfunction buildFailedSnapshot(\n  step: StepDefinition,\n  state: Record<string, unknown>,\n  startedAt: string,\n  startPerf: number,\n  attemptsCount: number,\n  attemptHistory: AttemptEntry[],\n): MutableStepSnapshot {\n  const endedAt = new Date().toISOString();\n  const duration = performance.now() - startPerf;\n  const lastErr = attemptHistory[attemptHistory.length - 1]?.error;\n  const wrapped = lastErr\n    ? new StepFailedError(`step \"${step.name}\" skip threw: ${lastErr.message}`, {\n        stepName: step.name,\n        attempts: attemptsCount,\n        cause: lastErr,\n      })\n    : new StepFailedError(`step \"${step.name}\" failed`, {\n        stepName: step.name,\n        attempts: attemptsCount,\n      });\n\n  return {\n    output: undefined,\n    skipped: false,\n    status: \"failed\",\n    startedAt,\n    endedAt,\n    duration,\n    attempts: attemptsCount,\n    attemptHistory,\n    error: wrapped,\n    state,\n  };\n}\n\nfunction failedAttempt(\n  index: number,\n  err: unknown,\n  startedAt: string,\n  startPerf: number,\n): AttemptEntry {\n  return {\n    index,\n    startedAt,\n    endedAt: new Date().toISOString(),\n    duration: performance.now() - startPerf,\n    status: \"failed\",\n    error: toAIError(err),\n  };\n}\n\nexport function toAIError(err: unknown): AIError {\n  if (err instanceof AIError) return err;\n  if (err instanceof Error) return new WorkflowError(err.message, { cause: err });\n  return new WorkflowError(String(err));\n}\n\nasync function validateSchema(\n  schema: StandardSchemaV1<unknown> | undefined,\n  value: unknown,\n): Promise<unknown> {\n  if (!schema) return value;\n  const result = await schema[\"~standard\"].validate(value);\n\n  if (\"issues\" in result && result.issues) {\n    throw new SchemaValidationError(\"workflow step output failed schema validation\", {\n      issues: result.issues,\n    });\n  }\n\n  return (result as { value: unknown }).value;\n}\n","import { log } from \"@warlock.js/logger\";\nimport type { BaseReport } from \"../contracts/result/base-report.type\";\nimport type { StepSnapshot } from \"../contracts/result/step-result.type\";\nimport type { Usage } from \"../contracts/result/usage.type\";\nimport type {\n  WorkflowReport,\n  WorkflowResult,\n} from \"../contracts/result/workflow-result.type\";\nimport type { StepDefinition } from \"../contracts/workflow/step.contract\";\nimport type { WorkflowContext } from \"../contracts/workflow/workflow-context.type\";\nimport type { WorkflowSnapshot } from \"../contracts/workflow/workflow-snapshot.type\";\nimport type {\n  WorkflowDefinition,\n  WorkflowEventHandlers,\n} from \"../contracts/workflow/workflow.contract\";\nimport {\n  AIError,\n  MaxStepsExceededError,\n  RoutingError,\n  SchemaValidationError,\n  WorkflowCancelledError,\n  WorkflowError,\n} from \"../errors\";\nimport { stampReportLineage } from \"../utils\";\nimport { createCancelledError } from \"./cancellation\";\nimport type { WorkflowEmitter } from \"./emitter\";\nimport { mapNextStep, nextDeclaredStep, resolveNextStep } from \"./router\";\nimport { runScopedEmitter } from \"./run-scoped-emitter\";\nimport { persistSnapshot } from \"./snapshot\";\nimport { cloneState, deepFreeze } from \"./state\";\nimport { executeStep, finalizeSnapshot, toAIError } from \"./step-runner\";\n\nexport { loadSnapshotForResume } from \"./snapshot\";\n\nconst DEFAULT_MAX_STEPS = 100;\nconst DEFAULT_LOOP_WARN = 5;\nconst LOG_MODULE_BASE = \"ai.workflow\";\n\ntype EngineParams<TOutput> = {\n  definition: WorkflowDefinition<any, TOutput, any, any>;\n  signature: string;\n  emitter: WorkflowEmitter;\n  input: unknown;\n  /**\n   * Request-scoped envelope, frozen and exposed as `ctx.context` to\n   * every step. Never persisted in snapshots; resume callers supply\n   * it fresh via `WorkflowResumeOptions.context`. Defaults to a\n   * frozen empty object when caller omits it.\n   */\n  context?: unknown;\n  runId: string;\n  signal?: AbortSignal;\n  executionHandlers?: WorkflowEventHandlers;\n  resumeFrom?: WorkflowSnapshot;\n  /**\n   * Opaque session identifier propagated onto every report node this\n   * run produces — including agent reports from child steps. Threaded\n   * from `WorkflowRunOptions.sessionId`. Omitted leaves the field\n   * undefined throughout the tree.\n   */\n  sessionId?: string;\n};\n\n/**\n * Main workflow driver. Walks the declared steps, handling routing,\n * cancellation, retries, parallel execution, and snapshot\n * persistence. Delegates the step lifecycle to `step-runner.ts`,\n * routing to `router.ts`, persistence to `snapshot.ts`. Never throws\n * — every failure funnels into `result.error`.\n */\nexport async function runWorkflow<TOutput>(\n  params: EngineParams<TOutput>,\n): Promise<WorkflowResult<TOutput>> {\n  const { definition, signature, input, runId, signal } = params;\n  // Bind the factory-scoped emitter to THIS run's identity. Every\n  // `emitter.emit(...)` below — and the one threaded into\n  // `executeStep` — now stamps `runId` / `rootRunId` automatically.\n  const emitter = runScopedEmitter(params.emitter, {\n    runId,\n    rootRunId: runId,\n  });\n\n  // Freeze the envelope once at run start. Default to `{}` so step\n  // code can always read `ctx.context` without an undefined guard.\n  const context = Object.freeze(params.context ?? {});\n  const maxSteps = definition.maxSteps ?? DEFAULT_MAX_STEPS;\n  const loopWarnAfter = definition.loopWarnAfter ?? DEFAULT_LOOP_WARN;\n\n  const logger = log;\n  const logModule = `${LOG_MODULE_BASE}.${definition.name}`;\n\n  const stepByName = new Map<string, StepDefinition>();\n  for (const s of definition.steps) stepByName.set(s.name, s);\n\n  const state: Record<string, unknown> = params.resumeFrom\n    ? { ...params.resumeFrom.state }\n    : {};\n  const steps: Record<string, StepSnapshot> = params.resumeFrom\n    ? { ...params.resumeFrom.steps }\n    : {};\n  const enteredCount = new Map<string, number>();\n  const usage: Usage = { input: 0, output: 0, total: 0 };\n\n  const startedAt = params.resumeFrom?.startedAt ?? new Date().toISOString();\n  const startedAtDate = new Date(startedAt);\n  const runStartPerf = performance.now();\n\n  let error: AIError | undefined;\n  let status: \"completed\" | \"failed\" | \"cancelled\" = \"completed\";\n  let cancelledAt: string | undefined;\n  let lastGoto: string | null = null;\n  // Captured when a step throws after retries exhaust (and `onFailure`\n  // didn't recover). Used to point the final snapshot's `next` at the\n  // failed step so `resume()` re-runs it after the cause is fixed.\n  let failedStepName: string | undefined;\n\n  const buildContext = (current?: {\n    state: Record<string, unknown>;\n    agentResult?: unknown;\n  }): WorkflowContext => ({\n    input,\n    context,\n    steps: steps as Readonly<Record<string, StepSnapshot>>,\n    state: current?.state ?? state,\n    agentResult: current?.agentResult as WorkflowContext[\"agentResult\"],\n    runId,\n    signal,\n    startedAt: startedAtDate,\n  });\n\n  emitter.emit(\n    \"workflow.starting\",\n    { workflowName: definition.name, input },\n    params.executionHandlers,\n  );\n  logger.info(logModule, \"starting\", \"workflow starting\", { runId });\n\n  let currentName: string | null = resolveInitialStep(\n    definition,\n    params.resumeFrom,\n  );\n  let stepCount = 0;\n\n  try {\n    while (currentName !== null) {\n      if (signal?.aborted) throw createCancelledError(signal);\n\n      stepCount += 1;\n      if (stepCount > maxSteps) {\n        throw new MaxStepsExceededError(\n          `workflow \"${definition.name}\" exceeded maxSteps=${maxSteps}`,\n          { maxSteps },\n        );\n      }\n\n      const entered = (enteredCount.get(currentName) ?? 0) + 1;\n      enteredCount.set(currentName, entered);\n      if (entered === loopWarnAfter) {\n        emitter.emit(\n          \"workflow.loop.warning\",\n          { step: currentName, enteredCount: entered, lastGoto },\n          params.executionHandlers,\n        );\n        logger.warn(logModule, \"loop.warning\", \"loop warning\", {\n          step: currentName,\n          enteredCount: entered,\n        });\n      }\n\n      const step = stepByName.get(currentName);\n      if (!step) {\n        throw new RoutingError(\n          `workflow \"${definition.name}\": unknown step \"${currentName}\"`,\n          { stepName: currentName },\n        );\n      }\n\n      const snapshot = await executeStep({\n        step,\n        state,\n        emitter,\n        executionHandlers: params.executionHandlers,\n        logger,\n        logModule,\n        signal,\n        buildContext,\n        usage,\n        workflowDefaultRetry: definition.defaultRetry,\n      });\n\n      Object.assign(state, snapshot.state);\n      steps[step.name] = finalizeSnapshot(snapshot);\n      // Parallel children — flat-path addressing alongside nested.\n      if (snapshot.steps) {\n        for (const [childName, childSnap] of Object.entries(snapshot.steps)) {\n          steps[childName] = childSnap;\n        }\n      }\n\n      // Failure path: retries exhausted. Give `onFailure` a chance to\n      // recover; otherwise checkpoint at the failed step (so resume\n      // re-runs it) and throw — workflow halts.\n      if (snapshot.status === \"failed\" && snapshot.error) {\n        const failureRoute = await resolveFailureRoute({\n          step,\n          definition,\n          error: snapshot.error,\n          ctx: buildContext({ state, agentResult: snapshot.executionResult }),\n        });\n\n        if (failureRoute === undefined) {\n          // No recovery — persist with `next: step.name` so resume\n          // re-runs this step after the user fixes the cause.\n          const persistOutcome = await persistSnapshot({\n            definition,\n            signature,\n            runId,\n            startedAt,\n            input,\n            state,\n            steps,\n            next: step.name,\n            status: \"running\",\n          });\n          if (!persistOutcome.ok) {\n            const persistErr = toAIError(persistOutcome.error);\n            emitter.emit(\n              \"workflow.error\",\n              { error: persistErr },\n              params.executionHandlers,\n            );\n            logger.error(\n              logModule,\n              \"persist.failed\",\n              \"snapshot persist failed\",\n              {\n                step: step.name,\n                code: persistErr.code,\n                message: persistErr.message,\n              },\n            );\n          }\n          failedStepName = step.name;\n          throw snapshot.error;\n        }\n\n        // onFailure routed — workflow continues. Checkpoint at the\n        // routed target (or `null` for `end`) so resume picks up there.\n        const failureNext = failureRoute === \"end\" ? null : failureRoute;\n        if (failureNext !== null && !stepByName.has(failureNext)) {\n          throw new RoutingError(\n            `workflow \"${definition.name}\": step \"${step.name}\" onFailure routed to unknown target \"${failureNext}\"`,\n            { stepName: step.name, targetName: failureNext },\n          );\n        }\n\n        const failurePersist = await persistSnapshot({\n          definition,\n          signature,\n          runId,\n          startedAt,\n          input,\n          state,\n          steps,\n          next: failureNext,\n          status: \"running\",\n        });\n        if (!failurePersist.ok) {\n          const persistErr = toAIError(failurePersist.error);\n          emitter.emit(\n            \"workflow.error\",\n            { error: persistErr },\n            params.executionHandlers,\n          );\n          logger.error(\n            logModule,\n            \"persist.failed\",\n            \"snapshot persist failed\",\n            {\n              step: step.name,\n              code: persistErr.code,\n              message: persistErr.message,\n            },\n          );\n        }\n\n        if (signal?.aborted) throw createCancelledError(signal);\n\n        if (failureRoute === \"end\") {\n          currentName = null;\n          break;\n        }\n\n        lastGoto = failureRoute;\n        currentName = failureRoute;\n        continue;\n      }\n\n      // Resolve next step for checkpoint accuracy BEFORE routing errors\n      // bubble — so the snapshot records where resume should resume from.\n      const resolved = await resolveNextStep({\n        step,\n        definition,\n        ctx: buildContext({ state, agentResult: snapshot.executionResult }),\n      });\n\n      const nextName =\n        resolved === \"end\"\n          ? null\n          : typeof resolved === \"string\"\n            ? resolved\n            : nextDeclaredStep(definition, step.name);\n\n      // Checkpoint after every step with the resolved `next`.\n      const outcome = await persistSnapshot({\n        definition,\n        signature,\n        runId,\n        startedAt,\n        input,\n        state,\n        steps,\n        next: nextName,\n        status: \"running\",\n      });\n      if (!outcome.ok) {\n        const persistErr = toAIError(outcome.error);\n        emitter.emit(\n          \"workflow.error\",\n          { error: persistErr },\n          params.executionHandlers,\n        );\n        logger.error(logModule, \"persist.failed\", \"snapshot persist failed\", {\n          step: step.name,\n          code: persistErr.code,\n          message: persistErr.message,\n        });\n      }\n\n      if (signal?.aborted) throw createCancelledError(signal);\n\n      if (resolved === \"end\") {\n        currentName = null;\n        break;\n      }\n\n      if (typeof resolved === \"string\") {\n        if (!stepByName.has(resolved)) {\n          throw new RoutingError(\n            `workflow \"${definition.name}\": step \"${step.name}\" goto unknown target \"${resolved}\"`,\n            { stepName: step.name, targetName: resolved },\n          );\n        }\n        lastGoto = resolved;\n        currentName = resolved;\n        continue;\n      }\n\n      currentName = nextName;\n      lastGoto = currentName;\n    }\n  } catch (err) {\n    if (err instanceof WorkflowCancelledError) {\n      status = \"cancelled\";\n      cancelledAt = err.cancelledAt;\n      error = err;\n    } else if (err instanceof AIError) {\n      status = \"failed\";\n      error = err;\n    } else {\n      status = \"failed\";\n      error = new WorkflowError(\n        err instanceof Error ? err.message : String(err),\n        { cause: err },\n      );\n    }\n  }\n\n  // Note: a `failed` step always throws (caught above) unless its\n  // `onFailure` recovered the run. A `completed` workflow may still\n  // contain `failed` step snapshots — those are the recovered cases\n  // and are intentionally preserved for forensic trace.\n\n  const endedAt = new Date().toISOString();\n  const duration = performance.now() - runStartPerf;\n\n  let data: TOutput | undefined;\n  if (status === \"completed\" && definition.output) {\n    try {\n      const extracted = await definition.output.extract(\n        buildContext({ state }),\n      );\n      data = (await validateWorkflowOutput(\n        definition.output.schema,\n        extracted,\n      )) as TOutput;\n    } catch (err) {\n      status = \"failed\";\n      error =\n        err instanceof AIError\n          ? err\n          : new WorkflowError(\n              err instanceof Error ? err.message : String(err),\n              { cause: err },\n            );\n    }\n  }\n\n  // Collect child executable reports from every step that ran one.\n  // Today the step runner surfaces agent reports (the only executable\n  // kind steps can invoke natively via `step.agent`); custom `run`\n  // callbacks that call tools/workflows/supervisors can't be observed\n  // here without a richer step-runner API — that's a v1.x follow-up\n  // (see backlog: \"step.run executables surface in workflow tree\").\n  const children: BaseReport[] = [];\n  for (const stepName in steps) {\n    const snap = steps[stepName];\n    if (snap.agentReport) {\n      children.push(snap.agentReport);\n    }\n  }\n\n  const report: WorkflowReport = {\n    runId,\n    rootRunId: runId,\n    name: definition.name,\n    version: definition.version,\n    type: \"workflow\",\n    workflowName: definition.name,\n    signature,\n    status,\n    startedAt,\n    endedAt,\n    duration,\n    cancelledAt,\n    usage,\n    children,\n    steps,\n    state: deepFreeze(cloneState(state)),\n  };\n\n  // Stamp lineage on the assembled tree exactly once. Walker rewrites\n  // any inner self-roots that nested agent reports brought in (each\n  // agent's `buildResult` set its own runId as root), propagates\n  // sessionId, and writes `reportSchemaVersion` on the root.\n  stampReportLineage(report, {\n    rootRunId: runId,\n    sessionId: params.sessionId,\n  });\n\n  // On a failed run with a captured `failedStepName`, point `next` at\n  // the failed step so `resume()` re-runs it. The pre-throw checkpoint\n  // already wrote this value, but the final snapshot would otherwise\n  // overwrite it with `null` and force resume to fall back to the\n  // first non-completed step (which is the same step in practice, but\n  // less informative for tooling reading the snapshot).\n  const finalNext = status === \"failed\" ? failedStepName ?? null : null;\n\n  const finalOutcome = await persistSnapshot({\n    definition,\n    signature,\n    runId,\n    startedAt,\n    input,\n    state,\n    steps,\n    next: finalNext,\n    status,\n  });\n  if (!finalOutcome.ok) {\n    const persistErr = toAIError(finalOutcome.error);\n    emitter.emit(\n      \"workflow.error\",\n      { error: persistErr },\n      params.executionHandlers,\n    );\n    logger.error(logModule, \"persist.failed\", \"final snapshot persist failed\", {\n      code: persistErr.code,\n      message: persistErr.message,\n    });\n  }\n\n  const result: WorkflowResult<TOutput> = {\n    type: \"workflow\",\n    data,\n    report,\n    usage,\n    error,\n  };\n\n  if (status === \"cancelled\") {\n    emitter.emit(\n      \"workflow.cancelled\",\n      {\n        cancelledAt: cancelledAt ?? endedAt,\n        reason: (error as WorkflowCancelledError | undefined)?.reason ?? \"\",\n      },\n      params.executionHandlers,\n    );\n    logger.warn(logModule, \"cancelled\", \"workflow cancelled\", { runId });\n  }\n\n  if (status === \"failed\" && error) {\n    emitter.emit(\"workflow.error\", { error }, params.executionHandlers);\n    logger.error(logModule, \"error\", \"workflow failed\", {\n      runId,\n      code: error.code,\n      message: error.message,\n    });\n  }\n\n  emitter.emit(\n    \"workflow.completed\",\n    { result: result as WorkflowResult<unknown> },\n    params.executionHandlers,\n  );\n  logger.info(logModule, \"completed\", \"workflow completed\", {\n    runId,\n    status,\n    duration,\n  });\n\n  return result;\n}\n\n/**\n * Run a failed step's `onFailure` hook (if present) and translate its\n * result into a route. Returns `undefined` when the workflow should\n * halt with the original error; `\"end\"` for clean termination; or a\n * step name to redirect to. A throw inside `onFailure` is wrapped in\n * `RoutingError` — routing is authoritative, never retried.\n */\nasync function resolveFailureRoute<T>(params: {\n  step: StepDefinition;\n  definition: WorkflowDefinition<any, T, any, any>;\n  error: AIError;\n  ctx: WorkflowContext;\n}): Promise<\"end\" | string | undefined> {\n  const { step, definition, error, ctx } = params;\n  if (!step.onFailure) return undefined;\n\n  let outcome;\n  try {\n    outcome = await step.onFailure(ctx, error);\n  } catch (err) {\n    throw new RoutingError(\n      `workflow \"${definition.name}\": step \"${step.name}\" onFailure threw`,\n      { stepName: step.name, cause: err },\n    );\n  }\n  return mapNextStep(outcome);\n}\n\nfunction resolveInitialStep<T>(\n  definition: WorkflowDefinition<any, T, any, any>,\n  resumeFrom: WorkflowSnapshot | undefined,\n): string | null {\n  if (!resumeFrom) return definition.steps[0]?.name ?? null;\n\n  // Prefer the explicitly-recorded `next` (now populated on every\n  // checkpoint). Falls back to first step whose snapshot is missing\n  // or not in a terminal-success state — covers older snapshots\n  // written before `next` was wired.\n  if (\n    resumeFrom.next &&\n    definition.steps.some(s => s.name === resumeFrom.next)\n  ) {\n    return resumeFrom.next;\n  }\n\n  for (const step of definition.steps) {\n    const snap = resumeFrom.steps[step.name];\n    if (!snap || (snap.status !== \"completed\" && snap.status !== \"skipped\")) {\n      return step.name;\n    }\n  }\n\n  return null;\n}\n\nasync function validateWorkflowOutput(\n  schema: unknown,\n  value: unknown,\n): Promise<unknown> {\n  if (!schema) return value;\n\n  const result = await (\n    schema as {\n      \"~standard\": { validate: (v: unknown) => Promise<unknown> | unknown };\n    }\n  )[\"~standard\"].validate(value);\n\n  if (\n    result &&\n    typeof result === \"object\" &&\n    \"issues\" in result &&\n    (result as { issues: unknown }).issues\n  ) {\n    throw new SchemaValidationError(\n      \"workflow output failed schema validation\",\n      {\n        issues: (result as { issues: any }).issues,\n      },\n    );\n  }\n\n  return (result as { value: unknown }).value;\n}\n","import type { StepDefinition } from \"../contracts/workflow/step.contract\";\nimport type { WorkflowDefinition } from \"../contracts/workflow/workflow.contract\";\n\nfunction stepFingerprint(step: StepDefinition): unknown {\n  const tag = step.parallel\n    ? \"parallel\"\n    : step.agent\n      ? \"agent\"\n      : step.run\n        ? \"run\"\n        : \"empty\";\n\n  const agentName = step.agent?.name;\n\n  return {\n    n: step.name,\n    t: tag,\n    a: agentName,\n    c: step.parallel?.map(child => stepFingerprint(child)) ?? null,\n  };\n}\n\n/**\n * FNV-1a 32-bit hash — deterministic, no crypto dependency.\n */\nfunction hash(input: string): string {\n  let h = 0x811c9dc5;\n\n  for (let i = 0; i < input.length; i++) {\n    h ^= input.charCodeAt(i);\n    h = (h + ((h << 1) + (h << 4) + (h << 7) + (h << 8) + (h << 24))) >>> 0;\n  }\n\n  return h.toString(16).padStart(8, \"0\");\n}\n\nexport function computeSignature<T>(definition: WorkflowDefinition<any, T, any, any>): string {\n  const fingerprint = {\n    n: definition.name,\n    v: definition.version ?? null,\n    s: definition.steps.map(step => stepFingerprint(step)),\n  };\n\n  return hash(JSON.stringify(fingerprint));\n}\n","import type { StandardSchemaV1 } from \"@standard-schema/spec\";\nimport type { WorkflowEventMap } from \"../contracts/events/event-map.type\";\nimport type { WorkflowResult } from \"../contracts/result/workflow-result.type\";\nimport type {\n  WorkflowDefinition,\n  WorkflowEventHandler,\n  WorkflowExecuteOptions,\n  WorkflowInstance,\n  WorkflowResumeOptions,\n  WorkflowRunOptions,\n} from \"../contracts/workflow/workflow.contract\";\nimport { WorkflowError } from \"../errors\";\nimport type { ToolContract } from \"../tool/tool\";\nimport { asTool } from \"./as-tool\";\nimport { WorkflowEmitter } from \"./emitter\";\nimport { loadSnapshotForResume, runWorkflow } from \"./engine\";\nimport { computeSignature } from \"./signature\";\n\n/**\n * `ai.workflow(def)` — construct a `WorkflowInstance`. Validates the\n * definition, computes a stable structural signature, and wires up the\n * three-tier event subscription model.\n */\nexport function workflow<\n  TInput = unknown,\n  TOutput = unknown,\n  TState = Record<string, unknown>,\n  TContext = unknown,\n>(\n  definition: WorkflowDefinition<TInput, TOutput, TState, TContext>,\n): WorkflowInstance<TInput, TOutput, TState, TContext> {\n  validate(definition);\n  const signature = computeSignature(definition);\n  const emitter = new WorkflowEmitter(definition.on);\n\n  function execute(\n    inputOrOptions: TInput | WorkflowExecuteOptions<TInput, TContext>,\n    maybeOptions?: WorkflowRunOptions<TContext>,\n  ): Promise<WorkflowResult<TOutput>> {\n    const { input, options } = normalizeExecuteArgs<TInput, TContext>(\n      inputOrOptions,\n      maybeOptions,\n    );\n    const runId = options?.runId ?? generateRunId();\n    return runWorkflow<TOutput>({\n      definition,\n      signature,\n      emitter,\n      input,\n      context: options?.context,\n      runId,\n      signal: options?.signal,\n      executionHandlers: options?.on,\n      sessionId: options?.sessionId,\n    });\n  }\n\n  async function resume(\n    runId: string,\n    options?: WorkflowResumeOptions<TContext>,\n  ): Promise<WorkflowResult<TOutput>> {\n    const snapshot = await loadSnapshotForResume({\n      definition,\n      signature,\n      runId,\n      options,\n    });\n\n    return runWorkflow<TOutput>({\n      definition,\n      signature,\n      emitter,\n      input: snapshot.input,\n      context: options?.context,\n      runId,\n      signal: options?.signal,\n      executionHandlers: options?.on,\n      sessionId: options?.sessionId,\n      resumeFrom: snapshot,\n    });\n  }\n\n  const instance: WorkflowInstance<TInput, TOutput, TState, TContext> = {\n    name: definition.name,\n    description: definition.description,\n    signature,\n    version: definition.version,\n    execute,\n    resume,\n    on<K extends keyof WorkflowEventMap>(event: K, handler: WorkflowEventHandler<K>) {\n      return emitter.on(event, handler);\n    },\n    off<K extends keyof WorkflowEventMap>(event: K, handler: WorkflowEventHandler<K>) {\n      emitter.off(event, handler);\n    },\n    asTool<TToolInput = TInput>(options: {\n      description?: string;\n      inputSchema: StandardSchemaV1<TToolInput>;\n    }): ToolContract<TToolInput, TOutput> {\n      return asTool<TInput, TOutput, TToolInput>(instance, options);\n    },\n  };\n\n  return instance;\n}\n\n/**\n * Resolve the overloaded `execute()` call shape. If the caller passed\n * a single plain object with an `input` field, treat it as the\n * combined `WorkflowExecuteOptions`. Otherwise the first arg is the\n * raw workflow input and the second is the run options.\n *\n * Ambiguity note: if your real workflow `input` is itself an object\n * with a top-level `input` key, prefer `execute(rawInput, options)`\n * explicitly — the single-arg detection heuristic would mis-classify\n * it.\n */\nfunction normalizeExecuteArgs<TInput, TContext>(\n  inputOrOptions: TInput | WorkflowExecuteOptions<TInput, TContext>,\n  maybeOptions: WorkflowRunOptions<TContext> | undefined,\n): { input: TInput; options?: WorkflowRunOptions<TContext> } {\n  if (\n    maybeOptions === undefined &&\n    inputOrOptions !== null &&\n    typeof inputOrOptions === \"object\" &&\n    \"input\" in (inputOrOptions as object)\n  ) {\n    const combined = inputOrOptions as WorkflowExecuteOptions<TInput, TContext>;\n    const { input, ...options } = combined;\n    return { input, options };\n  }\n\n  return { input: inputOrOptions as TInput, options: maybeOptions };\n}\n\nfunction validate<TInput, TOutput, TState, TContext>(\n  definition: WorkflowDefinition<TInput, TOutput, TState, TContext>,\n): void {\n  if (!definition.name || typeof definition.name !== \"string\") {\n    throw new WorkflowError(\"ai.workflow: `name` is required\");\n  }\n\n  if (!Array.isArray(definition.steps) || definition.steps.length === 0) {\n    throw new WorkflowError(`ai.workflow(\"${definition.name}\"): at least one step is required`);\n  }\n\n  const seen = new Set<string>();\n  const walk = (name: string) => {\n    if (seen.has(name)) {\n      throw new WorkflowError(`ai.workflow(\"${definition.name}\"): duplicate step name \"${name}\"`);\n    }\n    seen.add(name);\n  };\n\n  for (const step of definition.steps) {\n    walk(step.name);\n\n    if (step.parallel) {\n      for (const child of step.parallel) {\n        walk(child.name);\n      }\n    }\n  }\n}\n\nfunction generateRunId(): string {\n  // Non-crypto random — adequate for ephemeral workflow runs.\n  return `wf_${Date.now().toString(36)}_${Math.random().toString(36).slice(2, 10)}`;\n}\n","import { agent } from \"./agent/agent\";\nimport { setAIConfig } from \"./config\";\nimport { budget } from \"./middleware/builtins/budget\";\nimport { guardrail } from \"./middleware/builtins/guardrail\";\nimport { semanticCache } from \"./middleware/builtins/semantic-cache\";\nimport { composeMiddleware, forTool } from \"./middleware/helpers\";\nimport { supervisor } from \"./supervisor/supervisor\";\nimport { instruction } from \"./system-prompt/instruction\";\nimport { persona } from \"./system-prompt/persona\";\nimport { systemPrompt } from \"./system-prompt/system-prompt\";\nimport { tool } from \"./tool/tool\";\nimport { step } from \"./workflow/step\";\nimport { workflow } from \"./workflow/workflow\";\n\n/**\n * Top-level `ai` namespace — holds built-in factories and user-registered SDK adapters.\n *\n * Factories:\n * - `ai.tool(...)` — wrap an async function with a schema-validated input.\n * - `ai.agent(...)` — build an executable agent from model + tools + prompt.\n * - `ai.systemPrompt(...)` — compose a layered persona + instructions prompt.\n * - `ai.persona(text)` — reusable persona block (can be passed to `systemPrompt`).\n * - `ai.instruction(text)` — reusable instruction block (can be passed to `systemPrompt`).\n * - `ai.openai.model(...)` / `ai.anthropic.model(...)` / ... once the adapter SDK is registered.\n *\n * @example\n * const alex = ai.persona(\"You are Alex, a TypeScript expert.\");\n * const replyIn = ai.instruction(\"Respond in {{language|English}}.\");\n *\n * const prompt = ai.systemPrompt().persona(alex).instruction(replyIn);\n *\n * const myAgent = ai.agent({\n *   model: ai.openai.model({ name: \"gpt-4o\" }),\n *   systemPrompt: prompt,\n *   tools: [myTool],\n * });\n *\n * const result = await myAgent.execute(\"What is the weather in Cairo?\", {\n *   placeholders: { language: \"Arabic\" },\n * });\n */\nexport const ai = {\n  config: setAIConfig,\n  tool,\n  agent,\n  systemPrompt,\n  persona,\n  instruction,\n  workflow,\n  step,\n  supervisor,\n  middleware: {\n    budget,\n    guardrail,\n    semanticCache,\n    compose: composeMiddleware,\n    forTool,\n  },\n};\n","import type { Message } from \"../contracts/conversation-message.type\";\nimport type {\n  ModelCallOptions,\n  ModelCapabilities,\n  ModelContract,\n  ModelResponse,\n  ModelStreamChunk,\n} from \"../contracts/model.contract\";\nimport type { MockModelResponse } from \"./mock-config.type\";\n\ntype RecordedCall = {\n  messages: Message[];\n  options?: ModelCallOptions;\n};\n\n/**\n * Deterministic in-memory `ModelContract` implementation for tests.\n *\n * **Role.** Stands in for a real provider model so agent/workflow/supervisor\n * tests can assert behavior without hitting the network, spending tokens, or\n * depending on non-deterministic LLM output.\n *\n * **Responsibility.**\n * - Owns: a scripted queue of `MockModelResponse` entries, a call-history\n *   log for assertions, and the index pointer that advances through the\n *   queue on each `complete()` / `stream()` call.\n * - Does NOT own: any real inference, tokenization, or network I/O — when\n *   the queue is exhausted, the final entry is reused so tests never crash\n *   on accidental over-consumption.\n *\n * Every AI-related test in this repo uses `MockSDK` / `MockModel` — real\n * provider APIs are never hit from the test suite (see §6 of code-style.md).\n *\n * @example\n * const model = new MockModel(\"mock-gpt\", [\n *   { content: \"Hello!\", finishReason: \"stop\" },\n *   { content: \"Second turn.\", finishReason: \"stop\" },\n * ]);\n *\n * const first = await model.complete([{ role: \"user\", content: \"hi\" }]);\n * expect(first.content).toBe(\"Hello!\");\n * expect(model.callCount).toBe(1);\n */\nexport class MockModel implements ModelContract {\n  public readonly provider = \"mock\";\n  public readonly capabilities?: ModelCapabilities;\n\n  private responseIndex = 0;\n  private calls: RecordedCall[] = [];\n\n  public constructor(\n    public readonly name: string,\n    private readonly responses: MockModelResponse[],\n    capabilities?: ModelCapabilities,\n  ) {\n    this.capabilities = capabilities;\n  }\n\n  /**\n   * Full history of calls made to this model. Each entry is the exact\n   * `{ messages, options }` pair that was passed — useful for asserting\n   * that an agent built the right prompt or forwarded the right tool list.\n   */\n  public get callHistory(): RecordedCall[] {\n    return this.calls;\n  }\n\n  /**\n   * Number of times `complete()` or `stream()` has been invoked. Convenient\n   * shorthand for `callHistory.length` in assertions.\n   */\n  public get callCount(): number {\n    return this.calls.length;\n  }\n\n  /**\n   * Advance the scripted response queue by one and return the entry at the\n   * current pointer. If the queue is exhausted, the final scripted entry is\n   * returned repeatedly so over-consumption in tests produces predictable\n   * output instead of `undefined`.\n   */\n  private nextResponse(): MockModelResponse {\n    const response = this.responses[Math.min(this.responseIndex, this.responses.length - 1)];\n\n    this.responseIndex++;\n\n    return response ?? { content: \"Mock response\", finishReason: \"stop\" };\n  }\n\n  /**\n   * Convert a scripted `MockModelResponse` into a full `ModelResponse` with\n   * synthesized usage numbers when the script didn't supply them. Input\n   * usage is a fixed estimate; output usage is derived from content length.\n   */\n  private buildResponse(mock: MockModelResponse): ModelResponse {\n    const estimatedInput = 10;\n    const estimatedOutput = Math.ceil(mock.content.length / 4);\n\n    return {\n      content: mock.content,\n      finishReason: mock.finishReason ?? \"stop\",\n      usage: {\n        input: mock.usage?.input ?? estimatedInput,\n        output: mock.usage?.output ?? estimatedOutput,\n        total: (mock.usage?.input ?? estimatedInput) + (mock.usage?.output ?? estimatedOutput),\n        ...(mock.usage?.cachedTokens !== undefined ? { cachedTokens: mock.usage.cachedTokens } : {}),\n      },\n      toolCalls: mock.toolCalls,\n    };\n  }\n\n  /**\n   * Record the call, optionally delay (to simulate latency), and either\n   * throw the scripted error or return the scripted response. Mirrors the\n   * real provider's `complete()` contract so agents cannot tell the\n   * difference at runtime.\n   */\n  public async complete(messages: Message[], options?: ModelCallOptions): Promise<ModelResponse> {\n    this.calls.push({ messages, options });\n\n    const mock = this.nextResponse();\n\n    if (mock.delay) {\n      await new Promise((resolve) => setTimeout(resolve, mock.delay));\n    }\n\n    if (mock.error) {\n      throw mock.error;\n    }\n\n    return this.buildResponse(mock);\n  }\n\n  /**\n   * Record the call, optionally delay, then emit the scripted response as a\n   * sequence of stream chunks: content split word-by-word as `delta`\n   * chunks, each scripted tool call as a `tool-call` chunk, and finally a\n   * `done` chunk with finish reason + usage. Throws eagerly if the scripted\n   * entry carries an `error`.\n   */\n  public async *stream(\n    messages: Message[],\n    options?: ModelCallOptions,\n  ): AsyncIterable<ModelStreamChunk> {\n    this.calls.push({ messages, options });\n\n    const mock = this.nextResponse();\n\n    if (mock.delay) {\n      await new Promise((resolve) => setTimeout(resolve, mock.delay));\n    }\n\n    if (mock.error) {\n      throw mock.error;\n    }\n\n    const words = mock.content.split(\" \");\n\n    for (const word of words) {\n      yield { type: \"delta\", content: word + \" \" };\n    }\n\n    if (mock.toolCalls) {\n      for (const toolCall of mock.toolCalls) {\n        yield {\n          type: \"tool-call\",\n          id: toolCall.id,\n          name: toolCall.name,\n          input: toolCall.input,\n        };\n      }\n    }\n\n    const response = this.buildResponse(mock);\n\n    yield {\n      type: \"done\",\n      finishReason: response.finishReason,\n      usage: response.usage,\n    };\n  }\n\n  /**\n   * Reset call history and response pointer back to their initial state.\n   * Intended for test-suite `beforeEach` hooks so a single `MockModel`\n   * instance can be reused across cases without cross-test leakage.\n   */\n  public reset(): void {\n    this.calls = [];\n    this.responseIndex = 0;\n  }\n}\n","import type {\n  ModelConfig,\n  SDKAdapterContract,\n} from \"../contracts/sdk-adapter.contract\";\nimport { approximateTokenCount } from \"../utils/token-count\";\nimport type { MockSDKConfig } from \"./mock-config.type\";\nimport { MockModel } from \"./mock-model\";\n\n/**\n * Creates a mock SDK adapter for testing — no HTTP calls, fully configurable.\n *\n * @example\n * const mock = MockSDK({\n *   responses: [\n *     { content: \"Hello from mock!\" },\n *     { content: \"Second response\" },\n *   ],\n * });\n * const model = mock.model({ name: \"gpt-4o\" });\n * const result = await model.complete([{ role: \"user\", content: \"Hi\" }]);\n * console.log(result.content); // \"Hello from mock!\"\n */\nexport function MockSDK(config: MockSDKConfig = {}): SDKAdapterContract & {\n  /** All model instances created by this SDK — for inspecting calls in tests */\n  models: MockModel[];\n} {\n  const models: MockModel[] = [];\n  const responses = config.responses ?? [{ content: \"Mock response\" }];\n\n  return {\n    models,\n    model(modelConfig: ModelConfig) {\n      const model = new MockModel(\n        modelConfig.name ?? config.defaultModelName ?? \"mock-model\",\n        responses,\n        config.capabilities,\n      );\n      models.push(model);\n      return model;\n    },\n    async count(text: string, _model?: string): Promise<number> {\n      return approximateTokenCount(text);\n    },\n  };\n}\n","import { agent } from \"../agent/agent\";\nimport type { AgentConfig } from \"../agent/agent-config.type\";\nimport type { AgentContract } from \"../contracts/agent/agent.contract\";\nimport type { ToolContract } from \"../tool/tool\";\nimport type { MockModelResponse } from \"./mock-config.type\";\nimport { MockSDK } from \"./mock-sdk\";\n\n/**\n * Test helper that wires `MockSDK` → mock model → `agent()` in one call.\n *\n * Replaces the 4-line ritual specs typically write:\n * ```ts\n * const mock = MockSDK({ responses: [...] });\n * const myAgent = agent({ name: \"x\", model: mock.model({ name: \"m\" }) });\n * ```\n *\n * Defaults to a single empty `\"stop\"` response — enough to exercise an\n * agent that doesn't need a scripted reply (composition wiring,\n * anonymous-name tests, etc.). Pass `responses` to script outputs.\n *\n * `name` is optional — when omitted the resulting agent runs through\n * the normal anonymous-name fingerprint\n * (`anon_<provider>_<model>[_<tool1>+<tool2>...]`), which is the\n * default for `agent({ model })`.\n *\n * @example\n * const a = mockAgent({ name: \"writer\", responses: [{ content: \"hi\", finishReason: \"stop\" }] });\n * const result = await a.execute(\"anything\");\n */\nexport function mockAgent<TOutput = unknown>(\n  options: {\n    name?: string;\n    responses?: MockModelResponse[];\n    tools?: ToolContract<unknown, unknown>[];\n    /**\n     * Override the model name reported by the mock model. Defaults to\n     * `\"mock-model\"` (the MockSDK default). Useful when a test needs\n     * deterministic provider/model fingerprinting.\n     */\n    modelName?: string;\n  } = {},\n): AgentContract<TOutput> {\n  const responses = options.responses ?? [{ content: \"\", finishReason: \"stop\" as const }];\n  const sdk = MockSDK({ responses });\n  const model = sdk.model({ name: options.modelName ?? \"mock-model\" });\n\n  const config: AgentConfig<TOutput> = { model };\n\n  if (options.name !== undefined) {\n    config.name = options.name;\n  }\n\n  if (options.tools !== undefined) {\n    config.tools = options.tools;\n  }\n\n  return agent<TOutput>(config);\n}\n"],"mappings":"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"}
+{"version":3,"file":"index.cjs","names":["LOG_MODULE","judgeScorer","LOG_MODULE","called","LOG_MODULE","log","createCancelledError","sleep","cloneState","cloneState","createCancelledError","toAIError","sleep","toAIError","DEFAULT_TABLE","SAFE_IDENTIFIER","toNumber","DEFAULT_PREFIX","RECALL_OVERSCAN","memory","END","coerceInput","invoke","asTool","invoke","END","safeStringify","END","resolveSnapshotStore","LOG_MODULE_BASE","log","END","computeSignature","fingerprintUnit","resolveRouterName","hash","computeSignature","generateRunId","asTool","validateFactoryConfig","createSupervisor","resolveSnapshotStore","hash","orchestratorAsTool","resolvePrefix","memory","pg","redis","END","validate","asTool","loadSnapshotForResume","log","createCancelledError","toAIError","cloneState","computeSignature","computeSignature","generateRunId","loadSnapshotForResume","asTool","combined","checkpointMemory","checkpointPg","checkpointRedis","snapshotMemory","snapshotPg","snapshotRedis"],"sources":["../../../../../../@warlock.js/ai/src/errors/ai-error.ts","../../../../../../@warlock.js/ai/src/errors/agent-execution-error.ts","../../../../../../@warlock.js/ai/src/errors/agent-cancelled-error.ts","../../../../../../@warlock.js/ai/src/errors/agent-max-trips-error.ts","../../../../../../@warlock.js/ai/src/errors/budget-exceeded-error.ts","../../../../../../@warlock.js/ai/src/errors/provider-error.ts","../../../../../../@warlock.js/ai/src/errors/content-filter-error.ts","../../../../../../@warlock.js/ai/src/errors/context-length-exceeded-error.ts","../../../../../../@warlock.js/ai/src/errors/guardrail-violation-error.ts","../../../../../../@warlock.js/ai/src/errors/invalid-request-error.ts","../../../../../../@warlock.js/ai/src/errors/supervisor-failed-error.ts","../../../../../../@warlock.js/ai/src/errors/max-iterations-error.ts","../../../../../../@warlock.js/ai/src/errors/workflow-error.ts","../../../../../../@warlock.js/ai/src/errors/max-steps-exceeded-error.ts","../../../../../../@warlock.js/ai/src/errors/orchestrator-failed-error.ts","../../../../../../@warlock.js/ai/src/errors/orchestrator-cancelled-error.ts","../../../../../../@warlock.js/ai/src/errors/orchestrator-config-error.ts","../../../../../../@warlock.js/ai/src/errors/orchestrator-drift-error.ts","../../../../../../@warlock.js/ai/src/errors/planner-failed-error.ts","../../../../../../@warlock.js/ai/src/errors/planner-cancelled-error.ts","../../../../../../@warlock.js/ai/src/errors/planner-plan-invalid-error.ts","../../../../../../@warlock.js/ai/src/errors/provider-auth-error.ts","../../../../../../@warlock.js/ai/src/errors/provider-rate-limit-error.ts","../../../../../../@warlock.js/ai/src/errors/provider-timeout-error.ts","../../../../../../@warlock.js/ai/src/errors/quota-exceeded-error.ts","../../../../../../@warlock.js/ai/src/errors/routing-error.ts","../../../../../../@warlock.js/ai/src/errors/schema-validation-error.ts","../../../../../../@warlock.js/ai/src/errors/step-failed-error.ts","../../../../../../@warlock.js/ai/src/errors/supervisor-cancelled-error.ts","../../../../../../@warlock.js/ai/src/errors/supervisor-drift-error.ts","../../../../../../@warlock.js/ai/src/errors/supervisor-routing-error.ts","../../../../../../@warlock.js/ai/src/errors/tool-execution-error.ts","../../../../../../@warlock.js/ai/src/errors/workflow-cancelled-error.ts","../../../../../../@warlock.js/ai/src/errors/workflow-drift-error.ts","../../../../../../@warlock.js/ai/src/utils/compute-cost.ts","../../../../../../@warlock.js/ai/src/utils/extract-json-payload.ts","../../../../../../@warlock.js/ai/src/utils/generate-run-id.ts","../../../../../../@warlock.js/ai/src/utils/json-schema.ts","../../../../../../@warlock.js/ai/src/utils/resolve-attachment.ts","../../../../../../@warlock.js/ai/src/utils/prepare-attachment-part.ts","../../../../../../@warlock.js/ai/src/utils/safe-json-parse.ts","../../../../../../@warlock.js/ai/src/contracts/result/base-report.type.ts","../../../../../../@warlock.js/ai/src/utils/stamp-report-lineage.ts","../../../../../../@warlock.js/ai/src/utils/token-count.ts","../../../../../../@warlock.js/ai/src/eval/judge-scorer.ts","../../../../../../@warlock.js/ai/src/eval/eval-runner.ts","../../../../../../@warlock.js/ai/src/middleware/utils/extract-user-text.ts","../../../../../../@warlock.js/ai/src/middleware/utils/namespaced-state.ts","../../../../../../@warlock.js/ai/src/middleware/builtins/budget.ts","../../../../../../@warlock.js/ai/src/middleware/builtins/guardrail.ts","../../../../../../@warlock.js/ai/src/config.ts","../../../../../../@warlock.js/ai/src/middleware/builtins/semantic-cache.ts","../../../../../../@warlock.js/ai/src/middleware/helpers/compose.ts","../../../../../../@warlock.js/ai/src/middleware/helpers/for-tool.ts","../../../../../../@warlock.js/ai/src/middleware/pipeline.ts","../../../../../../@warlock.js/ai/src/tool/tool.ts","../../../../../../@warlock.js/ai/src/tool/executable-as-tool.ts","../../../../../../@warlock.js/ai/src/agent/agent-input-builder.ts","../../../../../../@warlock.js/ai/src/agent/agent-log-event.ts","../../../../../../@warlock.js/ai/src/agent/agent-stream.ts","../../../../../../@warlock.js/ai/src/agent/agent-to-stream-event.ts","../../../../../../@warlock.js/ai/src/agent/json-stream-guard.ts","../../../../../../@warlock.js/ai/src/agent/agent.ts","../../../../../../@warlock.js/ai/src/agent/spawn-sub-agent.ts","../../../../../../@warlock.js/ai/src/workflow/retry.ts","../../../../../../@warlock.js/ai/src/workflow/cancellation.ts","../../../../../../@warlock.js/ai/src/workflow/state.ts","../../../../../../@warlock.js/ai/src/workflow/step-runner.ts","../../../../../../@warlock.js/ai/src/batch/run-batch-item.ts","../../../../../../@warlock.js/ai/src/batch/run-with-concurrency.ts","../../../../../../@warlock.js/ai/src/batch/batch.ts","../../../../../../@warlock.js/ai/src/checkpoint/memory.ts","../../../../../../@warlock.js/ai/src/checkpoint/pg.ts","../../../../../../@warlock.js/ai/src/checkpoint/redis.ts","../../../../../../@warlock.js/ai/src/eval/scorers.ts","../../../../../../@warlock.js/ai/src/eval/index.ts","../../../../../../@warlock.js/ai/src/memory/derive-id.ts","../../../../../../@warlock.js/ai/src/memory/episodic-memory.ts","../../../../../../@warlock.js/ai/src/memory/procedural-memory.ts","../../../../../../@warlock.js/ai/src/memory/semantic-memory.ts","../../../../../../@warlock.js/ai/src/memory/working-memory.ts","../../../../../../@warlock.js/ai/src/memory/memory.ts","../../../../../../@warlock.js/ai/src/mock/mock-model.ts","../../../../../../@warlock.js/ai/src/mock/mock-sdk.ts","../../../../../../@warlock.js/ai/src/mock/mock-agent.ts","../../../../../../@warlock.js/ai/src/mock/mock-router.ts","../../../../../../@warlock.js/ai/src/model/fallback-model.ts","../../../../../../@warlock.js/ai/src/orchestrator/as-tool.ts","../../../../../../@warlock.js/ai/src/orchestrator/commands.ts","../../../../../../@warlock.js/ai/src/orchestrator/emitter.ts","../../../../../../@warlock.js/ai/src/orchestrator/memory.ts","../../../../../../@warlock.js/ai/src/orchestrator/checkpoint.ts","../../../../../../@warlock.js/ai/src/orchestrator/lock.ts","../../../../../../@warlock.js/ai/src/orchestrator/compaction.ts","../../../../../../@warlock.js/ai/src/supervisor/as-tool.ts","../../../../../../@warlock.js/ai/src/supervisor/emitter.ts","../../../../../../@warlock.js/ai/src/supervisor/entries.ts","../../../../../../@warlock.js/ai/src/supervisor/cancellation.ts","../../../../../../@warlock.js/ai/src/supervisor/router-prompt.ts","../../../../../../@warlock.js/ai/src/supervisor/decide.ts","../../../../../../@warlock.js/ai/src/supervisor/snapshot.ts","../../../../../../@warlock.js/ai/src/supervisor/execution.ts","../../../../../../@warlock.js/ai/src/supervisor/signature.ts","../../../../../../@warlock.js/ai/src/supervisor/supervisor-stream.ts","../../../../../../@warlock.js/ai/src/supervisor/supervisor.ts","../../../../../../@warlock.js/ai/src/orchestrator/dispatch.ts","../../../../../../@warlock.js/ai/src/orchestrator/load.ts","../../../../../../@warlock.js/ai/src/orchestrator/resume.ts","../../../../../../@warlock.js/ai/src/orchestrator/window.ts","../../../../../../@warlock.js/ai/src/orchestrator/execution.ts","../../../../../../@warlock.js/ai/src/orchestrator/orchestrator-stream.ts","../../../../../../@warlock.js/ai/src/orchestrator/signature.ts","../../../../../../@warlock.js/ai/src/orchestrator/orchestrator.ts","../../../../../../@warlock.js/ai/src/planner/plan-prompt.ts","../../../../../../@warlock.js/ai/src/planner/plan-schema.ts","../../../../../../@warlock.js/ai/src/planner/planner-run.ts","../../../../../../@warlock.js/ai/src/planner/signature.ts","../../../../../../@warlock.js/ai/src/planner/planner.ts","../../../../../../@warlock.js/ai/src/snapshot/memory.ts","../../../../../../@warlock.js/ai/src/snapshot/pg.ts","../../../../../../@warlock.js/ai/src/snapshot/redis.ts","../../../../../../@warlock.js/ai/src/supervisor/fan-out.ts","../../../../../../@warlock.js/ai/src/supervisor/router-factory.ts","../../../../../../@warlock.js/ai/src/system-prompt/render-placeholders.ts","../../../../../../@warlock.js/ai/src/system-prompt/instruction.ts","../../../../../../@warlock.js/ai/src/system-prompt/persona.ts","../../../../../../@warlock.js/ai/src/system-prompt/system-prompt.ts","../../../../../../@warlock.js/ai/src/workflow/step.ts","../../../../../../@warlock.js/ai/src/workflow/as-tool.ts","../../../../../../@warlock.js/ai/src/workflow/emitter.ts","../../../../../../@warlock.js/ai/src/workflow/router.ts","../../../../../../@warlock.js/ai/src/workflow/run-scoped-emitter.ts","../../../../../../@warlock.js/ai/src/workflow/snapshot.ts","../../../../../../@warlock.js/ai/src/workflow/engine.ts","../../../../../../@warlock.js/ai/src/workflow/signature.ts","../../../../../../@warlock.js/ai/src/workflow/workflow.ts","../../../../../../@warlock.js/ai/src/ai.ts","../../../../../../@warlock.js/ai/src/testing/register-lazy.ts"],"sourcesContent":["import type { ErrorCategory } from \"./error-category.type\";\nimport type { AIErrorCode } from \"./error-code.type\";\n\n/**\n * Optional constructor payload shared by every `AIError` subclass.\n *\n * `cause` carries the original thrown value (SDK error, runtime crash,\n * validation failure) so downstream logging and debuggers can still\n * reach it. `context` is a free-form diagnostic bag for provider-raw\n * metadata (status codes, request ids, response headers) that shouldn't\n * be promoted to typed fields but is useful in logs and telemetry.\n *\n * **No `category` here.** Category is fixed per subclass via the\n * class-level `static defaultCategory`. Subclasses ARE their\n * category — `RateLimitError` is always `\"rate-limit\"`, never\n * something else at runtime. Direct `new AIError(...)` callers (the\n * one legitimate override case, since the base catch-all has no\n * specific class) receive a separate 4th constructor argument\n * instead, so the override is structurally unreachable from subclass\n * call sites.\n */\nexport type AIErrorOptions = {\n  cause?: unknown;\n  context?: Record<string, unknown>;\n};\n\n/**\n * Base class for every error thrown (or surfaced via `result.error`) by\n * `@warlock.js/ai` and its provider adapter packages.\n *\n * **Role.** The single typed error contract across the AI framework.\n * Every thrown error anywhere in `@warlock.js/ai*` is either an\n * `AIError` itself or one of its subclasses — plain `Error` must never\n * leak out. Consumers branch either on the narrow `error.code` (stable\n * string), on `error.category` (coarse dashboard grouping), or on\n * `instanceof` a specific subclass.\n *\n * **Independence.** Deliberately extends the platform `Error` directly\n * — never `HttpError` from `@warlock.js/core`. The AI framework is a\n * standalone product; coupling its error base to a web framework would\n * force every consumer to pull in the HTTP layer even when they only\n * use AI in a CLI, worker, or test.\n *\n * **Fields.**\n * - `code` — stable machine-readable identifier (see `AIErrorCode`).\n * - `category` — coarse `ErrorCategory` for dashboards / retry policy.\n *   Resolved at construction from the subclass's `static defaultCategory`\n *   (or, for direct `new AIError(...)` calls, from the explicit 4th\n *   constructor argument).\n * - `cause` — optional original thrown value (SDK error, nested error,\n *   raw value). Preserves root cause through re-wrapping.\n * - `context` — optional free-form diagnostic bag (status, requestId,\n *   headers). Consumers treat it as opaque; logs and telemetry read it.\n *\n * **Category override — direct AIError usage only.** Subclasses ARE\n * their category by type; there's no legitimate runtime override at\n * the subclass level. The 4th constructor argument exists ONLY for\n * direct `new AIError(...)` callers, who would otherwise be stuck with\n * the `\"unknown\"` default. Subclasses construct via `super(code,\n * message, options)` and physically cannot reach the override slot\n * through their own typed signatures.\n *\n * @example\n * try {\n *   await agent.execute(\"hello\");\n * } catch (error) {\n *   if (error instanceof AIError) {\n *     console.error(`[${error.code}] (${error.category}) ${error.message}`);\n *   }\n * }\n *\n * @example\n * // Direct AIError construction with explicit category — escape hatch\n * // for call sites that lack a specific subclass.\n * throw new AIError(\"UNEXPECTED\", \"transient glitch\", undefined, \"provider\");\n */\nexport class AIError extends Error {\n  /**\n   * Class-level category for every instance of this error type.\n   * Subclasses redeclare with their own concrete `ErrorCategory` so\n   * `error.category` is correct without per-call wiring. The base\n   * class keeps `\"unknown\"` so untyped direct throws of `AIError`\n   * itself remain honest about their lack of dispatch information\n   * (and can override via the 4th constructor argument).\n   */\n  public static readonly defaultCategory: ErrorCategory = \"unknown\";\n\n  public readonly code: AIErrorCode;\n  public readonly category: ErrorCategory;\n  public readonly context?: Record<string, unknown>;\n\n  public constructor(\n    code: AIErrorCode,\n    message: string,\n    options?: AIErrorOptions,\n    category?: ErrorCategory,\n  ) {\n    super(message);\n\n    this.name = \"AIError\";\n    this.code = code;\n    this.context = options?.context;\n    this.category = category ?? (this.constructor as typeof AIError).defaultCategory;\n\n    if (options?.cause !== undefined) {\n      (this as { cause?: unknown }).cause = options.cause;\n    }\n  }\n}\n","import { AIError, type AIErrorOptions } from \"./ai-error\";\nimport type { AIErrorCode } from \"./error-code.type\";\n\n/**\n * Base for agent runtime failures that aren't schema / tool / provider\n * problems — runtime-structural issues inside the trip loop or\n * authoring-time middleware misconfiguration. Two specialized\n * subclasses cover the two non-generic cases:\n *\n * - {@link AgentCancelledError} (`AGENT_CANCELLED`) — caller-driven\n *   abort via `AbortSignal`.\n * - {@link AgentMaxTripsError} (`AGENT_MAX_TRIPS`) — trip loop hit\n *   the `maxTrips` cap without a natural stop.\n *\n * Use the base class directly for anything else (unregistered tool\n * dispatch, authoring-time middleware validation, surprise\n * exceptions). The subclasses exist so consumers can branch on a\n * dedicated `instanceof` / category without inferring from `context`\n * flags or parsing the message.\n *\n * @example\n * if (result.error?.code === \"AGENT_EXEC_FAILED\") {\n *   logger.warn(\"unexpected agent failure\", result.error.context);\n * }\n */\nexport class AgentExecutionError extends AIError {\n  public constructor(\n    message: string,\n    options?: AIErrorOptions,\n    code: AIErrorCode = \"AGENT_EXEC_FAILED\",\n  ) {\n    super(code, message, options);\n    this.name = \"AgentExecutionError\";\n  }\n}\n","import { AgentExecutionError } from \"./agent-execution-error\";\nimport type { AIErrorOptions } from \"./ai-error\";\nimport type { ErrorCategory } from \"./error-category.type\";\n\n/**\n * Payload for {@link AgentCancelledError}. `cancelledAt` is the\n * ISO-8601 timestamp at which the abort was observed; `reason`\n * carries the value the caller supplied to `controller.abort(reason)`\n * when present.\n */\nexport type AgentCancelledErrorOptions = AIErrorOptions & {\n  cancelledAt?: string;\n  reason?: string;\n};\n\n/**\n * Agent run was cancelled via `AbortSignal` before it could finish.\n * Between-trip cancellation is guaranteed; mid-trip cancellation is\n * best-effort (the signal is threaded into the provider adapter's\n * HTTP client when supported).\n *\n * Surfaced on `result.error` rather than thrown — `agent.execute()`\n * still returns with `report.status = \"cancelled\"` and partial trip\n * history intact. Consumers branch on the class (not the message) to\n * distinguish caller-initiated stops from other failures.\n *\n * **Why split from `AgentExecutionError`.** Cancellation is a\n * different operational signal from \"the agent crashed\" — retry\n * policy and dashboards typically want different behavior for each.\n * Keeping cancellation in its own class lets the category\n * (`\"cancelled\"`) be set declaratively per type instead of inferred\n * from a `context.cancelled === true` flag.\n *\n * @example\n * const result = await agent.execute(input, { signal });\n * if (result.error instanceof AgentCancelledError) {\n *   // caller pulled the plug — don't retry, surface a \"stopped\" UI\n *   return { status: \"cancelled\" };\n * }\n */\nexport class AgentCancelledError extends AgentExecutionError {\n  public static readonly defaultCategory: ErrorCategory = \"cancelled\";\n\n  public readonly cancelledAt?: string;\n  public readonly reason?: string;\n\n  public constructor(message: string, options?: AgentCancelledErrorOptions) {\n    super(message, options, \"AGENT_CANCELLED\");\n    this.name = \"AgentCancelledError\";\n    this.cancelledAt = options?.cancelledAt;\n    this.reason = options?.reason;\n  }\n}\n","import { AgentExecutionError } from \"./agent-execution-error\";\nimport type { AIErrorOptions } from \"./ai-error\";\nimport type { ErrorCategory } from \"./error-category.type\";\n\n/**\n * Payload for {@link AgentMaxTripsError}. `maxTrips` is the cap the\n * agent hit — useful for log/metric attribution and for retry-with-\n * higher-cap recovery strategies.\n */\nexport type AgentMaxTripsErrorOptions = AIErrorOptions & {\n  maxTrips: number;\n};\n\n/**\n * Runaway-loop hard guard: the agent's trip loop ran `maxTrips` round\n * trips to the model without the model issuing a natural stop. The\n * loop terminates with this typed error on `result.error` and the\n * full trip history preserved in `result.report.trips` so consumers\n * can see where the loop got stuck.\n *\n * **Not retryable by default.** A run that hit the cap usually\n * indicates either a tool the agent can't satisfy (causing infinite\n * re-asks) or a model that won't commit to an answer. Bumping\n * `maxTrips` and retrying without root-causing the underlying issue\n * just burns more tokens.\n *\n * **Why split from `AgentExecutionError`.** The catch-all base wears\n * too many hats — cancellation vs. max-trips vs. generic crashes had\n * to be disambiguated from `context` flags or message regex. Split\n * subclasses let category dispatch (`\"max-trips\"`) and consumer\n * branching (`instanceof`) work without inference.\n *\n * @example\n * if (result.error instanceof AgentMaxTripsError) {\n *   logger.warn(\"agent hit trip cap\", { max: result.error.maxTrips });\n * }\n */\nexport class AgentMaxTripsError extends AgentExecutionError {\n  public static readonly defaultCategory: ErrorCategory = \"max-trips\";\n\n  public readonly maxTrips: number;\n\n  public constructor(message: string, options: AgentMaxTripsErrorOptions) {\n    super(message, options, \"AGENT_MAX_TRIPS\");\n    this.name = \"AgentMaxTripsError\";\n    this.maxTrips = options.maxTrips;\n  }\n}\n","import { AIError, type AIErrorOptions } from \"./ai-error\";\nimport type { ErrorCategory } from \"./error-category.type\";\n\n/**\n * Unit of the budget being enforced. `tokens` for context/output\n * caps, `usd` for monetary caps, `requests` for call-count caps.\n */\nexport type BudgetUnit = \"tokens\" | \"usd\" | \"requests\";\n\n/**\n * Payload for `BudgetExceededError`. All three fields are required so\n * consumers can present the breach numerically without having to\n * reparse the message.\n */\nexport type BudgetExceededErrorOptions = AIErrorOptions & {\n  limit: number;\n  actual: number;\n  unit: BudgetUnit;\n};\n\n/**\n * A user- or framework-configured budget was exceeded mid-execution.\n *\n * **Not thrown yet.** The class is defined here so v2's budget\n * middleware can throw it without a breaking release of the error\n * hierarchy. Shape is locked: `{ limit, actual, unit }`.\n *\n * @example\n * if (error instanceof BudgetExceededError && error.unit === \"usd\") {\n *   alertFinance(error.actual, error.limit);\n * }\n */\nexport class BudgetExceededError extends AIError {\n  public static readonly defaultCategory: ErrorCategory = \"budget\";\n\n  public readonly limit: number;\n  public readonly actual: number;\n  public readonly unit: BudgetUnit;\n\n  public constructor(message: string, options: BudgetExceededErrorOptions) {\n    super(\"BUDGET_EXCEEDED\", message, options);\n    this.name = \"BudgetExceededError\";\n    this.limit = options.limit;\n    this.actual = options.actual;\n    this.unit = options.unit;\n  }\n}\n","import { AIError, type AIErrorOptions } from \"./ai-error\";\nimport type { ErrorCategory } from \"./error-category.type\";\nimport type { AIErrorCode } from \"./error-code.type\";\n\n/**\n * Any failure that originated from the model provider (OpenAI, Azure,\n * OpenRouter, local gateway). Base class for the provider subclasses\n * below — raw provider errors caught in an adapter are always wrapped\n * into *some* `ProviderError` so downstream code can branch on\n * `instanceof ProviderError` when any provider-side failure will do.\n *\n * **Subclasses (more specific first).**\n * - `ProviderRateLimitError` — 429 / rate-limit / quota exhaustion.\n * - `ProviderTimeoutError` — connection or request timeout.\n * - `ContextLengthExceededError` — prompt exceeded the model window.\n * - `ContentFilterError` — response blocked by provider safety policy.\n * - `ProviderAuthError` — bad / expired API key.\n * - `InvalidRequestError` — catch-all 4xx not covered above.\n *\n * When no subclass fits (e.g. 5xx server error, unknown network\n * failure), adapters throw plain `ProviderError` with the raw payload\n * captured in `context`.\n *\n * @example\n * if (result.error instanceof ProviderError) {\n *   if (result.error instanceof ProviderRateLimitError) {\n *     return retryAfter(result.error.retryAfter ?? 1000);\n *   }\n * }\n */\nexport class ProviderError extends AIError {\n  public static readonly defaultCategory: ErrorCategory = \"provider\";\n\n  public constructor(\n    message: string,\n    options?: AIErrorOptions,\n    code: AIErrorCode = \"PROVIDER_ERROR\",\n  ) {\n    super(code, message, options);\n    this.name = \"ProviderError\";\n  }\n}\n","import type { AIErrorOptions } from \"./ai-error\";\nimport type { ErrorCategory } from \"./error-category.type\";\nimport { ProviderError } from \"./provider-error\";\n\n/**\n * Payload for `ContentFilterError`. Both fields optional — providers\n * don't consistently disclose the specific filter reason or\n * categories, especially when the block is pre-generation.\n */\nexport type ContentFilterErrorOptions = AIErrorOptions & {\n  reason?: string;\n  categories?: string[];\n};\n\n/**\n * Response (or request) was blocked by the provider's safety filter.\n * Not retryable with the same input — reshape the prompt or lean on\n * a less-restrictive model.\n *\n * @example\n * if (result.error instanceof ContentFilterError) {\n *   return respondWithPolicyMessage(result.error.reason);\n * }\n */\nexport class ContentFilterError extends ProviderError {\n  public static readonly defaultCategory: ErrorCategory = \"content-filter\";\n\n  public readonly reason?: string;\n  public readonly categories?: string[];\n\n  public constructor(message: string, options?: ContentFilterErrorOptions) {\n    super(message, options, \"CONTENT_FILTER\");\n    this.name = \"ContentFilterError\";\n    this.reason = options?.reason;\n    this.categories = options?.categories;\n  }\n}\n","import type { AIErrorOptions } from \"./ai-error\";\nimport type { ErrorCategory } from \"./error-category.type\";\nimport { ProviderError } from \"./provider-error\";\n\n/**\n * Payload for `ContextLengthExceededError`. All fields are optional —\n * providers inconsistently surface exact token counts and the\n * model's limit. When present, they let callers compute a trim\n * target; when absent, the error still categorizes the failure.\n */\nexport type ContextLengthExceededErrorOptions = AIErrorOptions & {\n  limit?: number;\n  actual?: number;\n  modelName?: string;\n};\n\n/**\n * The request's prompt (messages + tools + schema) exceeded the\n * model's context window. Not retryable without shortening the input.\n *\n * Typically surfaced as OpenAI 400 with `code: \"context_length_exceeded\"`.\n *\n * @example\n * if (result.error instanceof ContextLengthExceededError) {\n *   messages = truncateOldestTurns(messages);\n *   return agent.execute(input, { history: messages });\n * }\n */\nexport class ContextLengthExceededError extends ProviderError {\n  public static readonly defaultCategory: ErrorCategory = \"context-length\";\n\n  public readonly limit?: number;\n  public readonly actual?: number;\n  public readonly modelName?: string;\n\n  public constructor(\n    message: string,\n    options?: ContextLengthExceededErrorOptions,\n  ) {\n    super(message, options, \"CONTEXT_LENGTH_EXCEEDED\");\n    this.name = \"ContextLengthExceededError\";\n    this.limit = options?.limit;\n    this.actual = options?.actual;\n    this.modelName = options?.modelName;\n  }\n}\n","import { AIError, type AIErrorOptions } from \"./ai-error\";\nimport type { ErrorCategory } from \"./error-category.type\";\n\n/**\n * Phase at which a guardrail rejected the content — `\"input\"` when the\n * violation was detected on the outbound prompt (before the model saw\n * it), `\"output\"` when it was detected on the model's response (before\n * the caller saw it).\n */\nexport type GuardrailPhase = \"input\" | \"output\";\n\n/**\n * Payload for `GuardrailViolationError`. `phase` tells the caller\n * whether the prompt or the response tripped the check; `reason` is\n * the free-form explanation the guardrail middleware produced;\n * `guardrail` names the offending middleware so operators can tune a\n * specific rule without hunting through logs.\n */\nexport type GuardrailViolationErrorOptions = AIErrorOptions & {\n  phase: GuardrailPhase;\n  reason: string;\n  guardrail?: string;\n};\n\n/**\n * A guardrail middleware rejected the prompt or response mid-execution.\n *\n * **Role.** The typed abort surface for `ai.middleware.guardrail`.\n * Consumers branch on `error.phase` to distinguish \"the user asked\n * something disallowed\" (`\"input\"`) from \"the model produced something\n * disallowed\" (`\"output\"`) — the two failure modes have very different\n * product responses (block vs. retry, or surface a policy message vs.\n * re-prompt the model).\n *\n * Thrown from inside the middleware pipeline's `trip.before` / `trip.after`\n * hooks; surfaced to the caller via `result.error` like every other\n * `AIError`.\n *\n * @example\n * if (result.error instanceof GuardrailViolationError) {\n *   if (result.error.phase === \"input\") {\n *     return respondWithPolicyMessage(result.error.reason);\n *   }\n *   return retryWithSanitizedPrompt();\n * }\n */\nexport class GuardrailViolationError extends AIError {\n  public static readonly defaultCategory: ErrorCategory = \"guardrail\";\n\n  public readonly phase: GuardrailPhase;\n  public readonly reason: string;\n  public readonly guardrail?: string;\n\n  public constructor(message: string, options: GuardrailViolationErrorOptions) {\n    super(\"GUARDRAIL_VIOLATION\", message, options);\n\n    this.name = \"GuardrailViolationError\";\n    this.phase = options.phase;\n    this.reason = options.reason;\n    this.guardrail = options.guardrail;\n  }\n}\n","import type { AIErrorOptions } from \"./ai-error\";\nimport type { ErrorCategory } from \"./error-category.type\";\nimport { ProviderError } from \"./provider-error\";\n\n/**\n * Provider rejected the request as malformed — bad model name,\n * unsupported feature, missing required field, image attached to a\n * non-vision model, etc. The catch-all for 4xx responses that aren't\n * auth, rate-limit, context-length, or content-filter.\n *\n * Also thrown from the agent when user-side validation fails at the\n * boundary (e.g. vision gate, malformed attachment shape) — the\n * category is \"you sent something the provider / agent cannot use\".\n *\n * @example\n * if (result.error instanceof InvalidRequestError) {\n *   logger.error(\"bad agent input\", { context: result.error.context });\n * }\n */\nexport class InvalidRequestError extends ProviderError {\n  public static readonly defaultCategory: ErrorCategory = \"validation\";\n\n  public constructor(message: string, options?: AIErrorOptions) {\n    super(message, options, \"PROVIDER_INVALID_REQUEST\");\n    this.name = \"InvalidRequestError\";\n  }\n}\n","import { AIError, type AIErrorOptions } from \"./ai-error\";\nimport type { AIErrorCode } from \"./error-code.type\";\n\n/**\n * Base class for every supervisor-specific failure surfaced from\n * `supervisor.execute()` / `supervisor.resume()` / authoring-time\n * `ai.supervisor()` validation.\n *\n * **Role.** Anchor for the `SUPERVISOR_*` code family. Subclasses\n * carry precise codes (`SUPERVISOR_MAX_ITERATIONS`,\n * `SUPERVISOR_INVALID_ROUTE`, …); this base catches everything a\n * supervisor run can produce that isn't already an agent / tool /\n * provider / workflow error bubbling up from a child execution.\n *\n * Child-execution errors (agent, tool, provider, workflow) flow\n * through the supervisor unchanged — they are captured on the\n * relevant branch snapshot and, if fatal, wrapped as the `cause` of a\n * `SupervisorFailedError` only when the supervisor itself has no\n * narrower subclass to throw.\n *\n * @example\n * try {\n *   ai.supervisor({\n *     route: () => \"triage\",\n *     router: routerAgent,\n *     intents: { triage },\n *   });\n * } catch (error) {\n *   if (error instanceof SupervisorFailedError) {\n *     console.error(error.code, error.message);\n *   }\n * }\n */\nexport class SupervisorFailedError extends AIError {\n  public constructor(\n    message: string,\n    options?: AIErrorOptions,\n    code: AIErrorCode = \"SUPERVISOR_FAILED\",\n  ) {\n    super(code, message, options);\n    this.name = \"SupervisorFailedError\";\n  }\n}\n","import type { AIErrorOptions } from \"./ai-error\";\nimport type { ErrorCategory } from \"./error-category.type\";\nimport { SupervisorFailedError } from \"./supervisor-failed-error\";\n\nexport type MaxIterationsErrorOptions = AIErrorOptions & {\n  maxIterations: number;\n};\n\n/**\n * Hard-cap guard: the supervisor ran `maxIterations` loop turns\n * without reaching a terminal decision (`END`, `satisfied: true`, or\n * cancellation). Terminates the run immediately with a typed error on\n * `result.error` — partial per-iteration snapshots are still\n * available on `result.report.snapshots`.\n *\n * @example\n * const { error, report } = await supervisor.execute(input);\n * if (error?.code === \"SUPERVISOR_MAX_ITERATIONS\") {\n *   logger.warn(\"supervisor did not converge\", {\n *     iterations: report.iterations,\n *   });\n * }\n */\nexport class MaxIterationsError extends SupervisorFailedError {\n  public static readonly defaultCategory: ErrorCategory = \"max-iterations\";\n\n  public readonly maxIterations: number;\n\n  public constructor(message: string, options: MaxIterationsErrorOptions) {\n    super(message, options, \"SUPERVISOR_MAX_ITERATIONS\");\n    this.name = \"MaxIterationsError\";\n    this.maxIterations = options.maxIterations;\n  }\n}\n","import { AIError, type AIErrorOptions } from \"./ai-error\";\nimport type { AIErrorCode } from \"./error-code.type\";\n\n/**\n * Base class for all workflow-specific failures. Subclasses carry\n * precise codes; this base catches everything `workflow.execute()`\n * can produce beyond agent/tool/provider errors.\n */\nexport class WorkflowError extends AIError {\n  public constructor(\n    message: string,\n    options?: AIErrorOptions,\n    code: AIErrorCode = \"WORKFLOW_ERROR\",\n  ) {\n    super(code, message, options);\n    this.name = \"WorkflowError\";\n  }\n}\n","import type { AIErrorOptions } from \"./ai-error\";\nimport type { ErrorCategory } from \"./error-category.type\";\nimport { WorkflowError } from \"./workflow-error\";\n\nexport type MaxStepsExceededErrorOptions = AIErrorOptions & {\n  maxSteps: number;\n};\n\n/**\n * Runaway-loop hard guard: workflow executed more step transitions\n * than `maxSteps` allows. Terminates the workflow immediately.\n */\nexport class MaxStepsExceededError extends WorkflowError {\n  public static readonly defaultCategory: ErrorCategory = \"max-steps\";\n\n  public readonly maxSteps: number;\n\n  public constructor(message: string, options: MaxStepsExceededErrorOptions) {\n    super(message, options, \"WORKFLOW_MAX_STEPS\");\n    this.name = \"MaxStepsExceededError\";\n    this.maxSteps = options.maxSteps;\n  }\n}\n","import { AIError, type AIErrorOptions } from \"./ai-error\";\nimport type { AIErrorCode } from \"./error-code.type\";\n\n/**\n * Base class for every orchestrator-specific failure surfaced from\n * `orchestrator.execute()` / `orchestrator.resume()` /\n * `orchestrator.command()` or thrown at authoring-time by\n * `ai.orchestrator()` validation (orchestrator.md §17).\n *\n * **Role.** Anchor for the `ORCHESTRATOR_*` code family. Subclasses\n * carry precise codes (`ORCHESTRATOR_DRIFT`, `ORCHESTRATOR_CONFIG`,\n * `ORCHESTRATOR_CANCELLED`, …); this base catches everything a turn can\n * produce that isn't already an agent / tool / provider / supervisor\n * error bubbling up from the dispatched child.\n *\n * Child-execution errors (agent, tool, provider, supervisor) flow\n * through the orchestrator unchanged — they are captured on the turn's\n * `childReport` and surfaced on `result.error` directly, never\n * re-wrapped.\n *\n * @example\n * const result = await orchestrator.execute(message, { sessionId, history });\n * if (result.error instanceof OrchestratorFailedError) {\n *   console.error(result.error.code, result.error.message);\n * }\n */\nexport class OrchestratorFailedError extends AIError {\n  public constructor(\n    message: string,\n    options?: AIErrorOptions,\n    code: AIErrorCode = \"ORCHESTRATOR_FAILED\",\n  ) {\n    super(code, message, options);\n    this.name = \"OrchestratorFailedError\";\n  }\n}\n","import type { AIErrorOptions } from \"./ai-error\";\nimport type { ErrorCategory } from \"./error-category.type\";\nimport { OrchestratorFailedError } from \"./orchestrator-failed-error\";\n\nexport type OrchestratorCancelledErrorOptions = AIErrorOptions & {\n  /** ISO-8601 timestamp at which the abort was observed by the orchestrator. */\n  cancelledAt: string;\n  /** The session whose turn was cancelled. */\n  sessionId: string;\n  /** `controller.abort(reason)` payload when the caller supplied one. */\n  reason?: string;\n};\n\n/**\n * A turn was cancelled via `AbortSignal` before it could settle\n * (orchestrator.md §17 — \"mid-turn cancel\"). The orchestrator returns\n * normally with `report.status: \"cancelled\"` and the error placed on\n * `result.error` rather than thrown; session state reverts to the\n * pre-turn checkpoint (the orchestrator does not persist a fresh row\n * for a cancelled turn — Q10).\n *\n * Mirrors `SupervisorCancelledError`, orchestrator scope. When an\n * `iterate: true` turn is cancelled mid-iteration, the underlying\n * `SupervisorCancelledError` rides on `cause`.\n */\nexport class OrchestratorCancelledError extends OrchestratorFailedError {\n  public static readonly defaultCategory: ErrorCategory = \"cancelled\";\n\n  public readonly cancelledAt: string;\n  public readonly sessionId: string;\n  public readonly reason?: string;\n\n  public constructor(\n    message: string,\n    options: OrchestratorCancelledErrorOptions,\n  ) {\n    super(message, options, \"ORCHESTRATOR_CANCELLED\");\n    this.name = \"OrchestratorCancelledError\";\n    this.cancelledAt = options.cancelledAt;\n    this.sessionId = options.sessionId;\n    this.reason = options.reason;\n  }\n}\n","import type { AIErrorOptions } from \"./ai-error\";\nimport type { ErrorCategory } from \"./error-category.type\";\nimport { OrchestratorFailedError } from \"./orchestrator-failed-error\";\n\n/**\n * Authoring-time misconfiguration of `ai.orchestrator(config)`\n * (orchestrator.md §17). Thrown synchronously at construction — never\n * surfaced via `result.error` — so a bad definition fails fast at boot\n * rather than on the first turn.\n *\n * Examples (§17): `iterate: true` with no `snapshotStore` (or\n * `ai.config({ defaultSnapshotStore })`); no resolvable\n * `checkpointStore`; both `route` and `router` configured;\n * `initialAgent` that is not a key in `intents`.\n *\n * Mirrors the `authoring: true` context tag the supervisor factory\n * stamps on its construction-time failures.\n */\nexport class OrchestratorConfigError extends OrchestratorFailedError {\n  public static readonly defaultCategory: ErrorCategory = \"validation\";\n\n  public constructor(message: string, options?: AIErrorOptions) {\n    super(message, options, \"ORCHESTRATOR_CONFIG\");\n    this.name = \"OrchestratorConfigError\";\n  }\n}\n","import type { AIErrorOptions } from \"./ai-error\";\nimport type { ErrorCategory } from \"./error-category.type\";\nimport { OrchestratorFailedError } from \"./orchestrator-failed-error\";\n\nexport type OrchestratorDriftErrorOptions = AIErrorOptions & {\n  /** Signature recorded on the loaded checkpoint. */\n  savedSignature: string;\n  /** Signature computed from the current orchestrator definition. */\n  currentSignature: string;\n  /** The session whose checkpoint drifted. */\n  sessionId: string;\n};\n\n/**\n * Phase 2 drift guard (orchestrator.md §3 / §10). `execute()` or\n * `resume()` loaded a checkpoint whose structural fingerprint does not\n * match the current orchestrator definition (name + intents map +\n * route/router presence + evaluate presence + initialAgent +\n * maxIterations + iterate flag + historyWindow shape — §10.1).\n *\n * The turn is refused synchronously — nothing dispatches — and the dev\n * decides how to recover: discard the session, migrate the persisted\n * state, or pass `{ force: true }` to accept the new signature on the\n * next persisted checkpoint.\n *\n * Mirrors `SupervisorDriftError` / `WorkflowDriftError` — same\n * rationale, orchestrator scope. The orchestrator signature does NOT\n * aggregate the internal supervisor's signature (§10.1); internal-\n * supervisor drift surfaces only on `iterate: true` resume via the\n * supervisor's own drift check.\n */\nexport class OrchestratorDriftError extends OrchestratorFailedError {\n  public static readonly defaultCategory: ErrorCategory = \"drift\";\n\n  public readonly savedSignature: string;\n  public readonly currentSignature: string;\n  public readonly sessionId: string;\n\n  public constructor(message: string, options: OrchestratorDriftErrorOptions) {\n    super(message, options, \"ORCHESTRATOR_DRIFT\");\n    this.name = \"OrchestratorDriftError\";\n    this.savedSignature = options.savedSignature;\n    this.currentSignature = options.currentSignature;\n    this.sessionId = options.sessionId;\n  }\n}\n","import { AIError, type AIErrorOptions } from \"./ai-error\";\nimport type { AIErrorCode } from \"./error-code.type\";\nimport type { ErrorCategory } from \"./error-category.type\";\n\n/**\n * Base class for every planner-specific failure surfaced from\n * `planner.execute()` or thrown at authoring-time by `ai.planner()`\n * validation.\n *\n * **Role.** Anchor for the `PLANNER_*` code family. Subclasses carry\n * precise codes (`PLANNER_PLAN_INVALID`, `PLANNER_CANCELLED`); this base\n * catches everything a planning run can produce that isn't already an\n * agent / tool / workflow / supervisor error bubbling up from a\n * dispatched capability.\n *\n * Child-execution errors (agent, tool, provider, workflow) flow through\n * the planner unchanged — they are captured on the relevant step\n * snapshot and surfaced on `result.error` directly, never re-wrapped.\n *\n * @example\n * const result = await planner.execute(\"Research and summarize X\");\n * if (result.error instanceof PlannerFailedError) {\n *   console.error(result.error.code, result.error.message);\n * }\n */\nexport class PlannerFailedError extends AIError {\n  /**\n   * Generic planner failures (authoring-time config violations, the\n   * `toAIError` catch-all for unexpected runtime crashes during a run)\n   * are orchestration-level provider failures. Subclasses with a more\n   * precise meaning redeclare their own — `PlannerPlanInvalidError` is\n   * `\"schema\"`, `PlannerCancelledError` is `\"cancelled\"`.\n   */\n  public static readonly defaultCategory: ErrorCategory = \"provider\";\n\n  public constructor(\n    message: string,\n    options?: AIErrorOptions,\n    code: AIErrorCode = \"PLANNER_FAILED\",\n  ) {\n    super(code, message, options);\n    this.name = \"PlannerFailedError\";\n  }\n}\n","import type { AIErrorOptions } from \"./ai-error\";\nimport type { ErrorCategory } from \"./error-category.type\";\nimport { PlannerFailedError } from \"./planner-failed-error\";\n\n/**\n * Options for {@link PlannerCancelledError}. Carries the observation\n * timestamp and the optional `controller.abort(reason)` payload.\n */\nexport type PlannerCancelledErrorOptions = AIErrorOptions & {\n  /** ISO-8601 timestamp at which the abort was observed by the planner. */\n  cancelledAt: string;\n  /** `controller.abort(reason)` payload when the caller supplied one. */\n  reason?: string;\n};\n\n/**\n * Planner run was cancelled via `AbortSignal` before it could finish.\n * Between-step cancellation is guaranteed; mid-step cancellation is\n * best-effort (the signal is threaded into every in-flight capability\n * `execute()` call, but effectiveness depends on the child primitive\n * respecting it).\n *\n * On cancellation the planner returns normally with\n * `report.status === \"cancelled\"` and the partial step snapshots — the\n * error is placed on `result.error` rather than thrown.\n */\nexport class PlannerCancelledError extends PlannerFailedError {\n  public static readonly defaultCategory: ErrorCategory = \"cancelled\";\n\n  public readonly cancelledAt: string;\n  public readonly reason?: string;\n\n  public constructor(message: string, options: PlannerCancelledErrorOptions) {\n    super(message, options, \"PLANNER_CANCELLED\");\n    this.name = \"PlannerCancelledError\";\n    this.cancelledAt = options.cancelledAt;\n    this.reason = options.reason;\n  }\n}\n","import type { AIErrorOptions } from \"./ai-error\";\nimport type { ErrorCategory } from \"./error-category.type\";\nimport { PlannerFailedError } from \"./planner-failed-error\";\n\n/**\n * The planner asked the LLM for an execution plan but the response\n * could not be parsed / validated into a usable {@link PlannerPlan},\n * or it referenced a capability that was never registered.\n *\n * Surfaced on `result.error` with `report.status === \"failed\"` — the\n * planner returns normally rather than throwing, so callers branch on\n * the typed envelope like every other primitive.\n */\nexport class PlannerPlanInvalidError extends PlannerFailedError {\n  public static readonly defaultCategory: ErrorCategory = \"schema\";\n\n  public constructor(message: string, options?: AIErrorOptions) {\n    super(message, options, \"PLANNER_PLAN_INVALID\");\n    this.name = \"PlannerPlanInvalidError\";\n  }\n}\n","import type { AIErrorOptions } from \"./ai-error\";\nimport type { ErrorCategory } from \"./error-category.type\";\nimport { ProviderError } from \"./provider-error\";\n\n/**\n * Provider rejected the credential — missing / invalid / expired API\n * key or insufficient permissions on the underlying account. Not\n * retryable; fix the credential and retry.\n *\n * @example\n * if (result.error instanceof ProviderAuthError) {\n *   notifyOps(\"rotate API key\", result.error.context);\n * }\n */\nexport class ProviderAuthError extends ProviderError {\n  public static readonly defaultCategory: ErrorCategory = \"auth\";\n\n  public constructor(message: string, options?: AIErrorOptions) {\n    super(message, options, \"PROVIDER_AUTH\");\n    this.name = \"ProviderAuthError\";\n  }\n}\n","import type { AIErrorOptions } from \"./ai-error\";\nimport type { ErrorCategory } from \"./error-category.type\";\nimport { ProviderError } from \"./provider-error\";\n\n/**\n * Payload for `ProviderRateLimitError`. `retryAfter` is the server's\n * hint (typically parsed from the `Retry-After` header) in milliseconds.\n */\nexport type ProviderRateLimitErrorOptions = AIErrorOptions & {\n  retryAfter?: number;\n};\n\n/**\n * Provider refused the call because the account (or key, or window)\n * is over its rate-limit or quota. Retryable after `retryAfter`\n * milliseconds — consumers are expected to back off before retrying.\n *\n * Covers both transient `429 Too Many Requests` and the billing-level\n * `insufficient_quota` case; the adapter decides which provider\n * signals map here.\n *\n * @example\n * if (result.error instanceof ProviderRateLimitError) {\n *   await sleep(result.error.retryAfter ?? 1000);\n * }\n */\nexport class ProviderRateLimitError extends ProviderError {\n  public static readonly defaultCategory: ErrorCategory = \"rate-limit\";\n\n  public readonly retryAfter?: number;\n\n  public constructor(message: string, options?: ProviderRateLimitErrorOptions) {\n    super(message, options, \"PROVIDER_RATE_LIMIT\");\n    this.name = \"ProviderRateLimitError\";\n    this.retryAfter = options?.retryAfter;\n  }\n}\n","import type { AIErrorOptions } from \"./ai-error\";\nimport type { ErrorCategory } from \"./error-category.type\";\nimport { ProviderError } from \"./provider-error\";\n\n/**\n * Provider call timed out — either at the transport layer (socket\n * connection) or on the server side (request exceeded the provider's\n * processing deadline). Idempotent retries are usually safe.\n *\n * @example\n * if (result.error instanceof ProviderTimeoutError) {\n *   return retry();\n * }\n */\nexport class ProviderTimeoutError extends ProviderError {\n  public static readonly defaultCategory: ErrorCategory = \"timeout\";\n\n  public constructor(message: string, options?: AIErrorOptions) {\n    super(message, options, \"PROVIDER_TIMEOUT\");\n    this.name = \"ProviderTimeoutError\";\n  }\n}\n","import type { AIErrorOptions } from \"./ai-error\";\nimport type { ErrorCategory } from \"./error-category.type\";\nimport { ProviderError } from \"./provider-error\";\n\n/**\n * Provider refused the call because the account has exhausted its\n * paid quota (monthly credit, billing cap, subscription tier limit).\n *\n * **Not retryable.** Unlike `ProviderRateLimitError` — where the\n * bucket refills after `retryAfter` milliseconds — this one needs\n * human intervention: top up the account, upgrade the plan, or\n * switch to a different key. Consumers who blindly back-off-and-retry\n * on rate-limit errors would loop forever here, which is why the two\n * are split.\n *\n * Typically surfaced as OpenAI `code: \"insufficient_quota\"`.\n *\n * **Distinct from `BudgetExceededError`.** `QuotaExceededError` is\n * the *provider* telling us their billing cap is hit.\n * `BudgetExceededError` is our *own* middleware enforcing a\n * user-configured ceiling client-side.\n *\n * @example\n * if (result.error instanceof QuotaExceededError) {\n *   await pagerDuty.trigger(\"openai quota exhausted\");\n *   return fallbackResponse();\n * }\n */\nexport class QuotaExceededError extends ProviderError {\n  public static readonly defaultCategory: ErrorCategory = \"quota\";\n\n  public constructor(message: string, options?: AIErrorOptions) {\n    super(message, options, \"PROVIDER_QUOTA_EXCEEDED\");\n    this.name = \"QuotaExceededError\";\n  }\n}\n","import type { AIErrorOptions } from \"./ai-error\";\nimport type { ErrorCategory } from \"./error-category.type\";\nimport { WorkflowError } from \"./workflow-error\";\n\nexport type RoutingErrorOptions = AIErrorOptions & {\n  stepName: string;\n  targetName?: string;\n};\n\n/**\n * `nextStep` returned an invalid `goto`, or the `nextStep` callback\n * itself threw. Routing is authoritative and has no recovery path —\n * the workflow terminates immediately.\n */\nexport class RoutingError extends WorkflowError {\n  public static readonly defaultCategory: ErrorCategory = \"routing\";\n\n  public readonly stepName: string;\n  public readonly targetName?: string;\n\n  public constructor(message: string, options: RoutingErrorOptions) {\n    super(message, options, \"WORKFLOW_INVALID_GOTO\");\n    this.name = \"RoutingError\";\n    this.stepName = options.stepName;\n    this.targetName = options.targetName;\n  }\n}\n","import type { StandardSchemaV1 } from \"@standard-schema/spec\";\nimport { AIError, type AIErrorOptions } from \"./ai-error\";\nimport type { ErrorCategory } from \"./error-category.type\";\n\n/**\n * Payload passed to `SchemaValidationError`. Subset of\n * `AIErrorOptions` plus the machine-readable validation issues list.\n */\nexport type SchemaValidationErrorOptions = AIErrorOptions & {\n  issues?: readonly StandardSchemaV1.Issue[];\n};\n\n/**\n * A `StandardSchemaV1` validation call returned issues, or the input\n * was not valid JSON before validation could even run.\n *\n * Produced in two places today:\n * - Agent output parsing — the final trip text failed `JSON.parse` or\n *   the parsed value failed `~standard.validate`.\n * - Tool input validation — the model's raw arguments for a tool call\n *   didn't match the tool's `input` schema.\n *\n * `issues` carries the structured validation result when available so\n * consumers can present per-field feedback.\n *\n * @example\n * if (result.error instanceof SchemaValidationError) {\n *   for (const issue of result.error.issues ?? []) {\n *     console.warn(issue.path, issue.message);\n *   }\n * }\n */\nexport class SchemaValidationError extends AIError {\n  public static readonly defaultCategory: ErrorCategory = \"schema\";\n\n  public readonly issues?: readonly StandardSchemaV1.Issue[];\n\n  public constructor(message: string, options?: SchemaValidationErrorOptions) {\n    super(\"SCHEMA_VALIDATION_FAILED\", message, options);\n    this.name = \"SchemaValidationError\";\n    this.issues = options?.issues;\n  }\n}\n","import type { AIErrorOptions } from \"./ai-error\";\nimport { WorkflowError } from \"./workflow-error\";\n\nexport type StepFailedErrorOptions = AIErrorOptions & {\n  stepName: string;\n  attempts: number;\n};\n\n/**\n * A workflow step exhausted its retries (or was not retried) and\n * terminated with an error. `cause` carries the last underlying error.\n */\nexport class StepFailedError extends WorkflowError {\n  public readonly stepName: string;\n  public readonly attempts: number;\n\n  public constructor(message: string, options: StepFailedErrorOptions) {\n    super(message, options, \"STEP_FAILED\");\n    this.name = \"StepFailedError\";\n    this.stepName = options.stepName;\n    this.attempts = options.attempts;\n  }\n}\n","import type { AIErrorOptions } from \"./ai-error\";\nimport type { ErrorCategory } from \"./error-category.type\";\nimport { SupervisorFailedError } from \"./supervisor-failed-error\";\n\nexport type SupervisorCancelledErrorOptions = AIErrorOptions & {\n  /** ISO-8601 timestamp at which the abort was observed by the supervisor. */\n  cancelledAt: string;\n  /** `controller.abort(reason)` payload when the caller supplied one. */\n  reason?: string;\n};\n\n/**\n * Supervisor run was cancelled via `AbortSignal` before it could\n * finish. Between-iteration cancellation is guaranteed; mid-iteration\n * cancellation is best-effort (the signal is also threaded into every\n * in-flight child `execute()` call, but effectiveness depends on the\n * child primitive respecting it).\n *\n * On cancellation the supervisor returns normally with `status:\n * \"cancelled\"` and partial `report.snapshots` — the error is placed\n * on `result.error` rather than thrown.\n */\nexport class SupervisorCancelledError extends SupervisorFailedError {\n  public static readonly defaultCategory: ErrorCategory = \"cancelled\";\n\n  public readonly cancelledAt: string;\n  public readonly reason?: string;\n\n  public constructor(\n    message: string,\n    options: SupervisorCancelledErrorOptions,\n  ) {\n    super(message, options, \"SUPERVISOR_CANCELLED\");\n    this.name = \"SupervisorCancelledError\";\n    this.cancelledAt = options.cancelledAt;\n    this.reason = options.reason;\n  }\n}\n","import type { AIErrorOptions } from \"./ai-error\";\nimport type { ErrorCategory } from \"./error-category.type\";\nimport { SupervisorFailedError } from \"./supervisor-failed-error\";\n\nexport type SupervisorDriftErrorOptions = AIErrorOptions & {\n  /** Signature recorded on the snapshot being resumed. */\n  savedSignature: string;\n  /** Signature computed from the current supervisor definition. */\n  currentSignature: string;\n  runId: string;\n};\n\n/**\n * `supervisor.resume(runId)` loaded a snapshot whose structural\n * fingerprint does not match the current supervisor definition\n * (agent keys + descriptions + router identity + route presence).\n * The resume is refused — no iteration runs — and the user decides\n * how to recover: discard the snapshot, migrate manually, or call\n * `resume(runId, { force: true })` to bypass the check.\n *\n * Mirrors `WorkflowDriftError` for workflow resume — same rationale,\n * different primitive.\n */\nexport class SupervisorDriftError extends SupervisorFailedError {\n  public static readonly defaultCategory: ErrorCategory = \"drift\";\n\n  public readonly savedSignature: string;\n  public readonly currentSignature: string;\n  public readonly runId: string;\n\n  public constructor(message: string, options: SupervisorDriftErrorOptions) {\n    super(message, options, \"SUPERVISOR_DRIFT\");\n    this.name = \"SupervisorDriftError\";\n    this.savedSignature = options.savedSignature;\n    this.currentSignature = options.currentSignature;\n    this.runId = options.runId;\n  }\n}\n","import type { AIErrorOptions } from \"./ai-error\";\nimport type { ErrorCategory } from \"./error-category.type\";\nimport { SupervisorFailedError } from \"./supervisor-failed-error\";\n\nexport type SupervisorRoutingErrorOptions = AIErrorOptions & {\n  /**\n   * The raw value the `route` callback or router agent returned. Keyed\n   * `unknown` because a misbehaving router can emit any JSON value —\n   * consumers should format it for display, not trust its shape.\n   */\n  returned: unknown;\n  /** Every legal intent key configured on the supervisor at run time. */\n  availableKeys: string[];\n};\n\n/**\n * A `route` callback or router agent returned a value that doesn't\n * resolve to a configured agent key, a `string[]` of configured keys,\n * or the `END` sentinel. Routing is authoritative — there is no\n * recovery path, so the supervisor terminates the run immediately.\n *\n * Named `SupervisorRoutingError` (not `RoutingError`) to avoid\n * colliding with `@warlock.js/ai`'s existing workflow `RoutingError`\n * (`WORKFLOW_INVALID_GOTO`). Both carry the same semantic weight —\n * \"routing asked for something I can't dispatch\" — in their\n * respective primitives.\n *\n * @example\n * const { error } = await supervisor.execute(input);\n * if (error?.code === \"SUPERVISOR_INVALID_ROUTE\") {\n *   logger.error(\"bad router decision\", {\n *     returned: (error as SupervisorRoutingError).returned,\n *     available: (error as SupervisorRoutingError).availableKeys,\n *   });\n * }\n */\nexport class SupervisorRoutingError extends SupervisorFailedError {\n  public static readonly defaultCategory: ErrorCategory = \"routing\";\n\n  public readonly returned: unknown;\n  public readonly availableKeys: string[];\n\n  public constructor(message: string, options: SupervisorRoutingErrorOptions) {\n    super(message, options, \"SUPERVISOR_INVALID_ROUTE\");\n    this.name = \"SupervisorRoutingError\";\n    this.returned = options.returned;\n    this.availableKeys = options.availableKeys;\n  }\n}\n","import { AIError, type AIErrorOptions } from \"./ai-error\";\nimport type { ErrorCategory } from \"./error-category.type\";\n\n/**\n * Payload passed to `ToolExecutionError` — identifies which tool\n * failed and, when applicable, which trip it was dispatched from.\n */\nexport type ToolExecutionErrorOptions = AIErrorOptions & {\n  toolName: string;\n  tripIndex?: number;\n};\n\n/**\n * A registered tool's `execute()` threw during dispatch — the tool\n * code itself failed (not its input schema). The model's request was\n * valid; the implementation crashed.\n *\n * Carries `toolName` so consumers can branch on which tool failed\n * without regex-parsing the message, and `tripIndex` to correlate\n * with the `LLMTrip` entry in `result.report.trips`.\n *\n * @example\n * if (result.error instanceof ToolExecutionError) {\n *   metrics.increment(\"tool.failure\", { tool: result.error.toolName });\n * }\n */\nexport class ToolExecutionError extends AIError {\n  public static readonly defaultCategory: ErrorCategory = \"tool\";\n\n  public readonly toolName: string;\n  public readonly tripIndex?: number;\n\n  public constructor(message: string, options: ToolExecutionErrorOptions) {\n    super(\"TOOL_EXEC_FAILED\", message, options);\n    this.name = \"ToolExecutionError\";\n    this.toolName = options.toolName;\n    this.tripIndex = options.tripIndex;\n  }\n}\n","import type { AIErrorOptions } from \"./ai-error\";\nimport type { ErrorCategory } from \"./error-category.type\";\nimport { WorkflowError } from \"./workflow-error\";\n\nexport type WorkflowCancelledErrorOptions = AIErrorOptions & {\n  cancelledAt: string;\n  reason?: string;\n};\n\n/**\n * Workflow was cancelled via `AbortSignal` before it could finish.\n * `cancelledAt` is ISO timestamp at abort; `reason` carries the\n * `controller.abort(reason)` payload when provided.\n */\nexport class WorkflowCancelledError extends WorkflowError {\n  public static readonly defaultCategory: ErrorCategory = \"cancelled\";\n\n  public readonly cancelledAt: string;\n  public readonly reason?: string;\n\n  public constructor(message: string, options: WorkflowCancelledErrorOptions) {\n    super(message, options, \"WORKFLOW_CANCELLED\");\n    this.name = \"WorkflowCancelledError\";\n    this.cancelledAt = options.cancelledAt;\n    this.reason = options.reason;\n  }\n}\n","import type { AIErrorOptions } from \"./ai-error\";\nimport type { ErrorCategory } from \"./error-category.type\";\nimport { WorkflowError } from \"./workflow-error\";\n\nexport type WorkflowDriftErrorOptions = AIErrorOptions & {\n  savedSignature: string;\n  currentSignature: string;\n  runId: string;\n};\n\n/**\n * `workflow.resume(runId)` found a snapshot whose structural signature\n * doesn't match the current workflow definition. Thrown without\n * executing anything. User must discard, force, or migrate manually.\n */\nexport class WorkflowDriftError extends WorkflowError {\n  public static readonly defaultCategory: ErrorCategory = \"drift\";\n\n  public readonly savedSignature: string;\n  public readonly currentSignature: string;\n  public readonly runId: string;\n\n  public constructor(message: string, options: WorkflowDriftErrorOptions) {\n    super(message, options, \"WORKFLOW_DRIFT\");\n    this.name = \"WorkflowDriftError\";\n    this.savedSignature = options.savedSignature;\n    this.currentSignature = options.currentSignature;\n    this.runId = options.runId;\n  }\n}\n","import type { ModelPricing } from \"../contracts/result/model-pricing.type\";\nimport type { Usage } from \"../contracts/result/usage.type\";\n\n/**\n * Compute a per-channel USD cost breakdown for a single `Usage` against\n * a model's pricing table. Returns `undefined` when no pricing is\n * configured — the framework treats unpriced runs as \"cost unknown,\"\n * not \"cost zero,\" so dashboards can distinguish free-tier from\n * un-instrumented.\n *\n * **Shape mirrors `ModelPricing`** — `input`, `output`, optional\n * `cachedInput` / `cachedOutput`. Consumers needing a scalar total\n * sum the populated fields. The breakdown is the value-add: it tells\n * downstream tooling HOW the total was reached (input-vs-output\n * share, cache savings) without re-deriving against pricing tables\n * that may have shifted since the report was written.\n *\n * **Cache-aware.** `usage.cachedTokens` is the subset of `usage.input`\n * served from the provider's prompt cache and bills at\n * `pricing.cachedInput` (falls back to full `pricing.input` when the\n * provider doesn't publish a cache rate). The remaining `input -\n * cachedTokens` bills at full rate and shows up in `cost.input`. The\n * `cachedOutput` channel is reserved for Anthropic-style cache writes;\n * until an adapter populates `usage.cacheWriteTokens`, the framework\n * leaves it undefined.\n *\n * Pricing values are USD-per-million-tokens. The function divides\n * once at the end to avoid floating-point accumulation error on\n * per-token math.\n *\n * @example\n * const usage: Usage = { input: 150_000, output: 30_000, total: 180_000, cachedTokens: 90_000 };\n * const cost = computeCost(usage, { input: 0.15, output: 0.6, cachedInput: 0.075 });\n * // cost = {\n * //   input: (60_000 * 0.15) / 1e6 = 0.009,\n * //   output: (30_000 * 0.6) / 1e6 = 0.018,\n * //   cachedInput: (90_000 * 0.075) / 1e6 = 0.00675,\n * // }\n */\nexport function computeCost(usage: Usage, pricing: ModelPricing | undefined): ModelPricing | undefined {\n  if (!pricing) {\n    return undefined;\n  }\n\n  const cachedInput = usage.cachedTokens ?? 0;\n  const uncachedInput = Math.max(0, usage.input - cachedInput);\n\n  const cost: ModelPricing = {\n    input: (uncachedInput * pricing.input) / 1_000_000,\n    output: (usage.output * pricing.output) / 1_000_000,\n  };\n\n  if (cachedInput > 0) {\n    const cachedInputRate = pricing.cachedInput ?? pricing.input;\n    cost.cachedInput = (cachedInput * cachedInputRate) / 1_000_000;\n  }\n\n  return cost;\n}\n\n/**\n * Merge a child's cost breakdown into a running parent total. Each\n * channel (`input`, `output`, `cachedInput`, `cachedOutput`) sums\n * independently — an undefined channel on either side is treated as\n * zero contribution rather than dropping the other side's value. A\n * single unpriced child should never erase the cost of its priced\n * siblings.\n *\n * Returns the new parent breakdown, or `undefined` when neither parent\n * nor child carried any cost data (preserves the \"no priced\n * contributor has appeared yet\" signal that distinguishes \"missing\n * pricing\" from \"genuinely zero\").\n */\nexport function accumulateCost(\n  parent: ModelPricing | undefined,\n  child: ModelPricing | undefined,\n): ModelPricing | undefined {\n  if (!child) {\n    return parent;\n  }\n\n  if (!parent) {\n    return { ...child };\n  }\n\n  const merged: ModelPricing = {\n    input: parent.input + child.input,\n    output: parent.output + child.output,\n  };\n\n  const cachedInput = sumOptional(parent.cachedInput, child.cachedInput);\n  if (cachedInput !== undefined) {\n    merged.cachedInput = cachedInput;\n  }\n\n  const cachedOutput = sumOptional(parent.cachedOutput, child.cachedOutput);\n  if (cachedOutput !== undefined) {\n    merged.cachedOutput = cachedOutput;\n  }\n\n  return merged;\n}\n\n/**\n * Add two optional numbers, treating either side's `undefined` as\n * zero — but return `undefined` when both are absent. Keeps \"this\n * channel was never reported anywhere\" distinguishable from \"this\n * channel was reported as 0.\"\n */\nfunction sumOptional(parent: number | undefined, child: number | undefined): number | undefined {\n  if (parent === undefined && child === undefined) {\n    return undefined;\n  }\n\n  return (parent ?? 0) + (child ?? 0);\n}\n","/**\n * Strip markdown code fences from an LLM response before JSON parsing.\n *\n * Models — especially Claude, smaller models, and local models — routinely\n * wrap JSON output in fenced code blocks (` ```json\\n{...}\\n``` `) even when\n * instructed otherwise. Sometimes they also precede the fence with prose\n * (\"Here you go:\\n```json\\n...\\n```\"). This helper finds the first fenced\n * block regardless of language tag and returns its trimmed contents.\n *\n * Returns the trimmed original text unchanged when no fence is present, so\n * clean JSON passes through as a no-op.\n *\n * Deliberately does NOT fall back to \"find first `{` and last `}` and slice\n * between them\" — that heuristic silently corrupts data when prose contains\n * stray braces. Failing loudly at `JSON.parse` is safer.\n *\n * @example\n * extractJsonPayload('```json\\n{\"a\":1}\\n```');\n * // => '{\"a\":1}'\n *\n * @example\n * extractJsonPayload('Here you go:\\n```\\n{\"a\":1}\\n```\\nHope this helps.');\n * // => '{\"a\":1}'\n *\n * @example\n * extractJsonPayload('{\"a\":1}');\n * // => '{\"a\":1}'   (no fence → unchanged)\n */\nexport function extractJsonPayload(text: string): string {\n  const trimmed = text.trim();\n\n  const fenceMatch = trimmed.match(/```(?:json)?\\s*\\n?([\\s\\S]*?)\\n?```/);\n\n  if (fenceMatch) {\n    return fenceMatch[1].trim();\n  }\n\n  return trimmed;\n}\n","/**\n * Generates a stable, human-readable run id for any execution node\n * (tool invocation, agent run, workflow run, supervisor run). Format:\n * `${prefix}_${timestamp36}_${random36}` — compact, sortable by\n * prefix, collision-resistant within a run.\n *\n * Shared helper so every primitive emits the same id shape. The\n * prefix is conventionally the primitive kind (`\"tool\"`, `\"agent\"`,\n * `\"workflow\"`, `\"sup\"`) but callers can pass anything; the id is\n * purely for correlation, never parsed.\n *\n * @example\n * const runId = generateRunId(\"tool\");\n * // → \"tool_ld8x3m_7fq2j1kp\"\n */\nexport function generateRunId(prefix: string): string {\n  return `${prefix}_${Date.now().toString(36)}_${Math.random()\n    .toString(36)\n    .slice(2, 10)}`;\n}\n","import type { StandardSchemaV1 } from \"@standard-schema/spec\";\n\n/**\n * Supported JSON Schema output targets per the Standard JSON Schema V1\n * spec. `openai-strict` is the richest for OpenAI structured outputs —\n * every property listed in `required`, optionals expressed as\n * `[\"T\", \"null\"]`, `additionalProperties: false` everywhere. Other\n * targets produce standards-compliant but looser output.\n */\nexport type JsonSchemaTarget = \"draft-2020-12\" | \"draft-07\" | \"openapi-3.0\" | \"openai-strict\";\n\n/**\n * Options for `extractJsonSchema`. `target` is forwarded to libraries that\n * implement the Standard JSON Schema V1 spec (Seal, and any future lib\n * that follows the spec). Libraries using their own top-level `.jsonSchema`\n * / `._jsonSchema` property ignore the target.\n */\nexport type ExtractJsonSchemaOptions = {\n  target?: JsonSchemaTarget | (string & {});\n};\n\n/**\n * Best-effort JSON Schema extraction from a Standard Schema instance.\n *\n * Different libraries expose their JSON representation through different\n * paths:\n * - **Seal / Standard JSON Schema V1**: `[\"~standard\"].jsonSchema.input({ target })`\n *   — nested under the spec object, takes a target switch. Default target\n *   is `\"openai-strict\"` since the primary consumer is OpenAI's native\n *   structured-output mechanism; pass `options.target` to override.\n * - **Zod / similar**: top-level `.jsonSchema` property. Zod v4 actually\n *   ships `toJSONSchema` as a module function, not a method, so it does\n *   NOT hit this probe — Zod users pass their converted schema via the\n *   `AgentExecuteOptions.responseSchema` escape hatch.\n *\n * Deliberately does NOT probe `toJSON` — that's a generic JavaScript\n * serialization hook (Seal's schemas have one that dumps internal rule\n * state) and matching it would return garbage disguised as a JSON Schema.\n *\n * Returns `undefined` when no path matches. The caller then either skips\n * native structured-output wiring or falls back to a schema-less\n * instruction.\n *\n * Shared across every SDK adapter package (OpenAI, Anthropic, Bedrock…)\n * so each provider converts schemas identically.\n *\n * @example\n * const schema = extractJsonSchema(mySealSchema);\n * // { type: \"object\", properties: { ... }, required: [ ... ], additionalProperties: false }\n *\n * @example\n * // Ask for a different target explicitly\n * const draft = extractJsonSchema(mySealSchema, { target: \"draft-2020-12\" });\n */\nexport function extractJsonSchema(\n  schema: StandardSchemaV1<unknown> | undefined,\n  options: ExtractJsonSchemaOptions = {},\n): Record<string, unknown> | undefined {\n  if (!schema) return undefined;\n\n  const target = options.target ?? \"openai-strict\";\n\n  // 1. Seal / Standard JSON Schema V1 pattern: [\"~standard\"].jsonSchema.input({ target })\n  const sealJsonSchema = extractFromSealPath(schema, target);\n\n  if (sealJsonSchema) {\n    return sealJsonSchema;\n  }\n\n  // 2. Top-level jsonSchema / _jsonSchema (Zod-like, property or method form)\n  const topLevel = extractFromCandidateKeys(schema as unknown as Record<string, unknown>);\n\n  if (topLevel) {\n    return topLevel;\n  }\n\n  return undefined;\n}\n\n/**\n * Probe the Standard JSON Schema V1 extension path on `schema[\"~standard\"]`.\n * The spec defines `jsonSchema.input({ target, libraryOptions? })` as a\n * function returning a JSON Schema tailored to the requested target. We\n * pass the caller's target (default `\"openai-strict\"`) so the library\n * produces output ready for OpenAI's native structured-output mode\n * without additional post-processing.\n *\n * Calling `.input()` without a target would throw (or return garbage) per\n * the spec — a failure here returns `undefined` so the fallback probe\n * runs.\n */\nfunction extractFromSealPath(\n  schema: StandardSchemaV1<unknown>,\n  target: string,\n): Record<string, unknown> | undefined {\n  const standardSlot = (schema as unknown as Record<string, unknown>)[\"~standard\"];\n\n  if (!standardSlot || typeof standardSlot !== \"object\") {\n    return undefined;\n  }\n\n  const jsonSchemaSlot = (standardSlot as Record<string, unknown>)[\"jsonSchema\"];\n\n  if (!jsonSchemaSlot || typeof jsonSchemaSlot !== \"object\") {\n    return undefined;\n  }\n\n  const inputFn = (jsonSchemaSlot as Record<string, unknown>)[\"input\"];\n\n  if (typeof inputFn !== \"function\") {\n    return undefined;\n  }\n\n  try {\n    const result = (inputFn as (options: { target: string }) => unknown).call(jsonSchemaSlot, {\n      target,\n    });\n\n    if (result && typeof result === \"object\") {\n      return result as Record<string, unknown>;\n    }\n  } catch {\n    // fall through — library didn't support the target or threw otherwise\n  }\n\n  return undefined;\n}\n\n/**\n * Probe well-known top-level keys libraries use to expose their JSON\n * Schema. Supports both method form (rare) and property form (common).\n * Deliberately narrow — `toJSON` is NOT probed here because it's a\n * generic serialization hook that returns library-internal state for\n * many validators (Seal included), not a JSON Schema.\n */\nfunction extractFromCandidateKeys(\n  schemaRecord: Record<string, unknown>,\n): Record<string, unknown> | undefined {\n  const candidateKeys = [\"jsonSchema\", \"_jsonSchema\"] as const;\n\n  for (const key of candidateKeys) {\n    const value = schemaRecord[key];\n\n    if (typeof value === \"function\") {\n      try {\n        const result = (value as () => unknown).call(schemaRecord);\n\n        if (result && typeof result === \"object\") {\n          return result as Record<string, unknown>;\n        }\n      } catch {\n        // try next candidate\n      }\n\n      continue;\n    }\n\n    if (value && typeof value === \"object\") {\n      return value as Record<string, unknown>;\n    }\n  }\n\n  return undefined;\n}\n","import type {\n  Attachment,\n  AttachmentSource,\n  ResolvedAttachment,\n} from \"../contracts/attachment.type\";\nimport { InvalidRequestError } from \"../errors\";\n\nconst REMOTE_URL_PATTERN = /^https?:\\/\\//i;\n\n/**\n * Normalize a user-supplied `Attachment` (or bare `AttachmentSource`)\n * into a `ResolvedAttachment` the agent can hand to file-reading code\n * without re-discriminating the input variant.\n *\n * Resolution rules:\n * - `{ base64, mediaType }` → `{ type: \"base64\", value, mediaType }`.\n * - `StorageFileShape` (`{ url?, absolutePath? }`) → URL wins over\n *   absolute path. URL becomes `{ type: \"url\" }`; absolute path\n *   becomes `{ type: \"path\" }`.\n * - String starting with `http://` / `https://` → `{ type: \"url\" }`.\n * - Any other string → `{ type: \"path\" }`.\n * - Tagged `{ type: \"image\" | \"text\", source }` → recurses into `source`.\n *\n * Throws `InvalidRequestError` on obviously invalid input (empty\n * string, storage object with neither url nor absolutePath, missing\n * source field).\n *\n * @example\n * resolveAttachment(\"https://cdn.example.com/doc.pdf\");\n * // → { type: \"url\", value: \"https://cdn.example.com/doc.pdf\" }\n *\n * @example\n * resolveAttachment({ type: \"image\", source: \"/tmp/x.png\" });\n * // → { type: \"path\", value: \"/tmp/x.png\" }\n */\nexport function resolveAttachment(attachment: Attachment): ResolvedAttachment {\n  if (\n    typeof attachment === \"object\" &&\n    attachment !== null &&\n    \"type\" in attachment\n  ) {\n    return resolveSource(attachment.source);\n  }\n\n  return resolveSource(attachment);\n}\n\nfunction resolveSource(source: AttachmentSource): ResolvedAttachment {\n  if (typeof source === \"string\") {\n    if (!source) {\n      throw new InvalidRequestError(\"Cannot resolve empty attachment string\");\n    }\n\n    if (REMOTE_URL_PATTERN.test(source)) {\n      return { type: \"url\", value: source };\n    }\n\n    return { type: \"path\", value: source };\n  }\n\n  // StorageFile objects (from @warlock.js/core) can expose a `base64`\n  // property alongside `url` / `absolutePath`. Check storage shape\n  // first so we don't treat a StorageFile as an inline-bytes payload.\n  if (\"url\" in source || \"absolutePath\" in source) {\n    const storage = source as { url?: string; absolutePath?: string };\n\n    if (storage.absolutePath) {\n      return { type: \"path\", value: storage.absolutePath };\n    }\n\n    if (storage.url) {\n      return { type: \"url\", value: storage.url };\n    }\n\n    throw new InvalidRequestError(\n      \"Storage attachment has neither url nor absolutePath\",\n    );\n  }\n\n  if (\"base64\" in source) {\n    if (!source.base64 || !source.mediaType) {\n      throw new InvalidRequestError(\n        \"Inline attachment requires both `base64` and `mediaType`\",\n      );\n    }\n\n    return {\n      type: \"base64\",\n      value: source.base64,\n      mediaType: source.mediaType,\n    };\n  }\n\n  throw new InvalidRequestError(\n    \"Unrecognized attachment source — expected a string path/URL, a StorageFile, or `{ base64, mediaType }`\",\n  );\n}\n","import { readFile } from \"node:fs/promises\";\nimport { extname } from \"node:path\";\nimport type { Attachment } from \"../contracts/attachment.type\";\nimport type { ContentPart } from \"../contracts/content-part.type\";\nimport { InvalidRequestError } from \"../errors\";\nimport { resolveAttachment } from \"./resolve-attachment\";\n\nconst IMAGE_EXTENSIONS_TO_MEDIA_TYPE: Record<string, string> = {\n  \".png\": \"image/png\",\n  \".jpg\": \"image/jpeg\",\n  \".jpeg\": \"image/jpeg\",\n  \".webp\": \"image/webp\",\n  \".gif\": \"image/gif\",\n};\n\nconst TEXT_EXTENSIONS = new Set([\".txt\"]);\n\ntype AttachmentKind = \"image\" | \"text\";\n\n/**\n * Convert a user-supplied `Attachment` into a provider-ready\n * `ContentPart` the model adapter can consume without doing any I/O of\n * its own.\n *\n * Kind resolution:\n * - Tagged `{ type: \"image\", source }` / `{ type: \"text\", source }`\n *   trusts the caller's intent.\n * - Shorthand (raw string / `StorageFileShape`) infers from the file\n *   extension. Image extensions (`.png`/`.jpg`/`.jpeg`/`.webp`/`.gif`)\n *   map to `\"image\"`. `.txt` maps to `\"text\"`. Anything else throws\n *   `InvalidRequestError` — silent inference on ambiguous inputs\n *   causes silent bugs.\n *\n * Local paths are read from disk; images are base64-encoded inline,\n * text files are read as UTF-8 strings and returned as a `text`\n * `ContentPart`. Remote URLs for image attachments are passed through\n * unchanged; remote URLs for text attachments are fetched so the\n * adapter never needs network access.\n *\n * @example\n * await prepareAttachmentPart(\"./photo.png\");\n * // → { type: \"image\", source: { base64: \"...\", mediaType: \"image/png\" } }\n *\n * @example\n * await prepareAttachmentPart({ type: \"text\", source: \"./notes.txt\" });\n * // → { type: \"text\", text: \"<file contents>\" }\n */\nexport async function prepareAttachmentPart(\n  attachment: Attachment,\n): Promise<ContentPart> {\n  const kind = resolveKind(attachment);\n\n  if (kind === \"text\") {\n    return prepareTextPart(attachment);\n  }\n\n  return prepareImagePart(attachment);\n}\n\n/**\n * Decide whether the attachment is text or image. Tagged forms win\n * immediately; for shorthand we inspect the extension. Throws if the\n * shorthand doesn't look like anything we recognize.\n */\nfunction resolveKind(attachment: Attachment): AttachmentKind {\n  if (isTaggedAttachment(attachment)) {\n    return attachment.type;\n  }\n\n  const path = extractPath(attachment);\n  const extension = path ? extname(stripQuery(path)).toLowerCase() : \"\";\n\n  if (IMAGE_EXTENSIONS_TO_MEDIA_TYPE[extension]) {\n    return \"image\";\n  }\n\n  if (TEXT_EXTENSIONS.has(extension)) {\n    return \"text\";\n  }\n\n  throw new InvalidRequestError(\n    \"Cannot infer attachment type from input — pass an explicit `{ type: 'image' | 'text', source: ... }` or use a recognized extension (.png, .jpg, .jpeg, .webp, .gif, .txt)\",\n  );\n}\n\n/**\n * Produce an `image` ContentPart. URLs pass through; paths are\n * read from disk and base64-encoded with an inferred media type.\n * Inline base64 attachments pass through unchanged.\n */\nasync function prepareImagePart(attachment: Attachment): Promise<ContentPart> {\n  const inferredMediaType = isTaggedAttachment(attachment)\n    ? undefined\n    : inferImageMediaType(attachment);\n\n  const resolved = resolveAttachment(attachment);\n\n  if (resolved.type === \"url\") {\n    return { type: \"image\", source: { url: resolved.value } };\n  }\n\n  if (resolved.type === \"base64\") {\n    return {\n      type: \"image\",\n      source: { base64: resolved.value, mediaType: resolved.mediaType },\n    };\n  }\n\n  const mediaType = inferredMediaType ?? inferImageMediaType(resolved.value);\n\n  if (!mediaType) {\n    throw new InvalidRequestError(\n      `Cannot infer media type for path \"${resolved.value}\" — use a recognized image extension or pass ` +\n        \"`{ type: 'image', source: { base64, mediaType } }`\",\n      { context: { path: resolved.value } },\n    );\n  }\n\n  const bytes = await readFile(resolved.value);\n\n  return {\n    type: \"image\",\n    source: { base64: bytes.toString(\"base64\"), mediaType },\n  };\n}\n\n/**\n * Produce a `text` ContentPart. URLs are fetched as UTF-8, paths are\n * read from disk as UTF-8, inline base64 is decoded to UTF-8. The\n * result joins the conversation as an additional text part the model\n * sees before responding.\n */\nasync function prepareTextPart(attachment: Attachment): Promise<ContentPart> {\n  const resolved = resolveAttachment(attachment);\n\n  if (resolved.type === \"url\") {\n    const response = await fetch(resolved.value);\n\n    if (!response.ok) {\n      throw new InvalidRequestError(\n        `Failed to fetch text attachment \"${resolved.value}\" — status ${response.status}`,\n        { context: { url: resolved.value, status: response.status } },\n      );\n    }\n\n    return { type: \"text\", text: await response.text() };\n  }\n\n  if (resolved.type === \"base64\") {\n    const decoded = Buffer.from(resolved.value, \"base64\").toString(\"utf8\");\n\n    return { type: \"text\", text: decoded };\n  }\n\n  const bytes = await readFile(resolved.value, \"utf8\");\n\n  return { type: \"text\", text: bytes };\n}\n\nfunction isTaggedAttachment(\n  attachment: Attachment,\n): attachment is Extract<Attachment, { type: string }> {\n  return (\n    typeof attachment === \"object\" &&\n    attachment !== null &&\n    \"type\" in attachment\n  );\n}\n\nfunction inferImageMediaType(input: unknown): string | undefined {\n  const path = extractPath(input);\n\n  if (!path) {\n    return undefined;\n  }\n\n  const extension = extname(stripQuery(path)).toLowerCase();\n\n  return IMAGE_EXTENSIONS_TO_MEDIA_TYPE[extension];\n}\n\nfunction extractPath(input: unknown): string | undefined {\n  if (typeof input === \"string\") {\n    return input;\n  }\n\n  if (typeof input === \"object\" && input !== null) {\n    const storage = input as { url?: string; absolutePath?: string };\n    return storage.url ?? storage.absolutePath;\n  }\n\n  return undefined;\n}\n\nfunction stripQuery(path: string): string {\n  const queryIndex = path.indexOf(\"?\");\n\n  return queryIndex === -1 ? path : path.slice(0, queryIndex);\n}\n","/**\n * Parse a JSON string, returning a caller-supplied fallback when the input\n * is empty or malformed instead of throwing. Useful at provider boundaries\n * where tool-call arguments may arrive as `null`, `\"\"`, or partial JSON\n * during streaming — callers want a safe default, not an exception.\n *\n * @example\n * const args = safeJsonParse<Record<string, unknown>>(toolCall.function.arguments, {});\n */\nexport function safeJsonParse<TValue>(\n  data: string | null | undefined,\n  defaultValue: TValue,\n): TValue {\n  if (!data) {\n    return defaultValue;\n  }\n\n  try {\n    return JSON.parse(data) as TValue;\n  } catch {\n    return defaultValue;\n  }\n}\n","import type { AttemptEntry } from \"./attempt-entry.type\";\nimport type { Usage } from \"./usage.type\";\n\n/**\n * Wire-format version stamped on every root `BaseReport`. Bumped only\n * when we make a BREAKING change to the report shape (field removed,\n * required-ness flipped, semantics changed). Additive changes (new\n * optional fields) do not bump.\n *\n * Panoptic and other downstream consumers branch on this to parse\n * old stored reports with their original-shape rules.\n *\n * Current: **1** — initial Panoptic-readiness shape.\n */\nexport const REPORT_SCHEMA_VERSION = 1;\n\n/**\n * Discriminator for the kind of executable that produced a given\n * {@link BaseReport}. Forms a closed union so consumers can narrow on\n * the tree without string-matching on `name`.\n */\nexport type ReportType =\n  | \"tool\"\n  | \"callback\"\n  | \"agent\"\n  | \"workflow\"\n  | \"supervisor\"\n  | \"orchestrator\"\n  | \"batch\"\n  | \"planner\";\n\n/**\n * Terminal status every executable primitive reports. Unified across\n * tools, agents, workflows, and supervisors so dashboards and\n * generic traversal helpers don't special-case per primitive.\n *\n * - `\"completed\"` — ran to natural end with a usable result.\n * - `\"failed\"` — aborted mid-run or finished without a usable result\n *   (crash, schema failure, max-trips, etc.). The\n *   accompanying `error` on the envelope carries the typed cause.\n * - `\"cancelled\"` — caller aborted before completion via `AbortSignal`.\n * - `\"max-iterations\"` — supervisor-specific termination when the\n *   iteration cap was hit without an explicit `END` / `satisfied`.\n *   Harmless on non-supervisor reports; keeping it on the shared\n *   union lets consumers write one `switch` for every status.\n * - `\"awaiting-input\"` — orchestrator-specific NON-terminal status: the\n *   session is paused waiting for the next user turn (§15.6). The only\n *   non-terminal member of this union; consumers branching on\n *   `status === \"completed\"` must treat it as a session-continues path,\n *   not a failure. Harmless on non-orchestrator reports.\n */\nexport type ReportStatus =\n  | \"completed\"\n  | \"failed\"\n  | \"cancelled\"\n  | \"max-iterations\"\n  | \"awaiting-input\";\n\n/**\n * Universal execution report shared by every primitive. Per-primitive\n * report types extend this with their own domain-specific fields\n * (agent trips, workflow steps, supervisor iteration snapshots) while\n * keeping the root fields identical. Recursion happens through\n * {@link BaseReport.children} — any executable this node invoked\n * contributes its own full report here, producing a walkable tree of\n * the entire run.\n *\n * **Usage rollup.** `usage` at every node equals this node's own cost\n * plus the sum of each child's `usage`. Leaves (tools) contribute\n * zero own-cost; composites contribute their direct LLM spend only,\n * with children covering everything delegated.\n *\n * @example\n * function totalCost(report: BaseReport): number {\n *   return report.usage.total;\n * }\n *\n * function walk(report: BaseReport, depth = 0): void {\n *   console.log(`${\"  \".repeat(depth)}${report.type} \"${report.name}\" — ${report.status}`);\n *   for (const child of report.children) walk(child, depth + 1);\n * }\n */\nexport type BaseReport = {\n  /** Stable id for this execution node. Generated per `execute()`/`invoke()` call. */\n  runId: string;\n  /**\n   * Run-id of the immediate parent execution node, when this node was\n   * invoked as part of a larger run (e.g. a tool dispatched by an\n   * agent; an agent dispatched by a supervisor; an inner primitive\n   * wrapped via `asTool()`). Absent on root nodes.\n   *\n   * Lets Panoptic and other flat-row consumers reconstruct the tree\n   * without traversing `children[]` in memory.\n   */\n  parentRunId?: string;\n  /**\n   * Run-id of the top-level execution this node belongs to. Equals\n   * `runId` on the root node, and is propagated downward to every\n   * descendant. Used to slice flat report tables back into per-run\n   * groupings.\n   */\n  rootRunId: string;\n  /** Executable identity — the tool/agent/workflow/supervisor name. */\n  name: string;\n  /**\n   * Dev-curated version string mirrored from the primitive's config\n   * (`AgentConfig.version`, `ToolConfig.version`, etc.). Free-form —\n   * the framework neither parses nor compares it. Stored verbatim on\n   * every report so trip-archive queries can distinguish runs of\n   * \"agent X v2.1\" from \"agent X v2.2\" even when name + signature\n   * are identical.\n   *\n   * Stays `undefined` when the dev didn't declare one — never\n   * auto-defaulted.\n   */\n  version?: string;\n  /**\n   * Caller-supplied identifier that groups multiple `.execute()` calls\n   * into one conceptual user session / request. Propagated to every\n   * descendant report node so flat queries (\"total spend for session\n   * X today\") work without joining the tree.\n   *\n   * Threaded from `execute()` options on every primitive. Optional —\n   * absent when the caller didn't supply one.\n   */\n  sessionId?: string;\n  /** Discriminator for the kind of executable that produced this report. */\n  type: ReportType;\n  /** Terminal status of this execution. */\n  status: ReportStatus;\n  /** ISO-8601 wall-clock timestamp when execution began. */\n  startedAt: string;\n  /** ISO-8601 wall-clock timestamp when execution finished. */\n  endedAt: string;\n  /** Monotonic duration in milliseconds — `performance.now()` delta. */\n  duration: number;\n  /** Rolled-up usage: own cost + sum of `children[].usage`. */\n  usage: Usage;\n  /**\n   * Reports of every executable invoked by this node, in invocation\n   * order. Empty for leaves (pure tools) and for executables that\n   * didn't delegate work.\n   */\n  children: BaseReport[];\n  /**\n   * Retry history when middleware (or, for workflow steps, the engine\n   * itself) retried this node before it either succeeded or gave up.\n   * Absent when zero retries happened — keeps the common-case payload\n   * lean. The surviving (final) attempt is NOT duplicated here; its\n   * outcome is the report's own `status` / timing.\n   */\n  attempts?: AttemptEntry[];\n  /**\n   * Wire-format version of this report shape. Only present on root\n   * report nodes — implies the same version for the whole tree.\n   * Panoptic / archive consumers branch on this to parse old reports\n   * with their original-shape rules.\n   *\n   * Always equals {@link REPORT_SCHEMA_VERSION} at write time.\n   */\n  reportSchemaVersion?: number;\n};\n","import type { BaseReport } from \"../contracts/result/base-report.type\";\nimport { REPORT_SCHEMA_VERSION } from \"../contracts/result/base-report.type\";\n\n/**\n * Options for {@link stampReportLineage}. Every field is optional —\n * the caller supplies whichever pieces it knows. Missing pieces are\n * left untouched (existing values on the report survive).\n */\nexport type LineageStamp = {\n  /**\n   * The outermost run-id this subtree belongs to. When set, EVERY\n   * node in the subtree gets its `rootRunId` rewritten to this\n   * value — overrides any inner self-roots produced by nested\n   * `buildResult` calls.\n   */\n  rootRunId: string;\n  /**\n   * Run-id of the immediate parent of THIS subtree's top node. Each\n   * descendant's `parentRunId` is then derived from its own walk\n   * position (its parent's `runId`).\n   */\n  parentRunId?: string;\n  /**\n   * Caller-supplied session identifier — propagates to every node in\n   * the subtree. Skipped when undefined.\n   */\n  sessionId?: string;\n};\n\n/**\n * Walk a freshly-built report tree and stamp lineage fields onto\n * every node:\n *\n * - `rootRunId` — rewritten to `stamp.rootRunId` everywhere. Composite\n *   children built by inner primitives carry their own self-root; this\n *   walk overrides it so the outer root wins (single coherent run id\n *   across the whole tree).\n * - `parentRunId` — root node gets `stamp.parentRunId`; descendants\n *   derive theirs from each parent's own `runId`.\n * - `sessionId` — propagated when provided.\n * - `reportSchemaVersion` — stamped only on the root (the value is the\n *   same for the whole tree; storing it on every node would waste\n *   space).\n *\n * Designed to run ONCE per top-level `buildResult` call. Each\n * primitive's executor invokes this on the assembled root report just\n * before returning; nested primitives produced their own subtree with\n * a self-root, and this pass relinks everything to the outer caller's\n * lineage.\n *\n * Mutates the report in place — internal use only, before the report\n * is exposed via `result.report`.\n *\n * @example\n * const root = this.buildBareReport();\n * stampReportLineage(root, { rootRunId: this.runId, sessionId: this.options?.sessionId });\n * return { ..., report: root };\n */\nexport function stampReportLineage(root: BaseReport, stamp: LineageStamp): void {\n  root.reportSchemaVersion = REPORT_SCHEMA_VERSION;\n\n  walk(root, stamp.rootRunId, stamp.parentRunId, stamp.sessionId);\n}\n\nfunction walk(node: BaseReport, rootRunId: string, parentRunId?: string, sessionId?: string): void {\n  node.rootRunId = rootRunId;\n\n  if (parentRunId !== undefined) {\n    node.parentRunId = parentRunId;\n  } else {\n    delete node.parentRunId;\n  }\n\n  if (sessionId !== undefined) {\n    node.sessionId = sessionId;\n  }\n\n  for (const child of node.children) {\n    walk(child, rootRunId, node.runId, sessionId);\n  }\n}\n","/**\n * Approximate the number of tokens in a string.\n *\n * Uses the ~4-characters-per-token heuristic, which is accurate enough for\n * GPT-4 family models and most English text. Use this when a real tokenizer\n * (tiktoken, etc.) isn't available or would add native dependencies.\n *\n * @example\n * const tokens = approximateTokenCount(\"Hello, world!\"); // 4\n */\nexport function approximateTokenCount(text: string): number {\n  return Math.ceil(text.length / 4);\n}\n","import type {\n  EvalJudge,\n  EvalScore,\n  EvalScorer,\n  EvalScorerContext,\n} from \"../contracts/agent/eval.type\";\nimport { extractJsonPayload, safeJsonParse } from \"../utils\";\n\n/**\n * Raw shape the judge agent is expected to return — either parsed from\n * `result.data` (when the judge has an output schema) or extracted\n * from `result.text`.\n */\ntype JudgeVerdict = {\n  score?: unknown;\n  passed?: unknown;\n  reason?: unknown;\n};\n\n/** Clamp an arbitrary numeric value into the `[0, 1]` score range. */\nfunction clampScore(value: number): number {\n  if (Number.isNaN(value)) return 0;\n  if (value < 0) return 0;\n  if (value > 1) return 1;\n  return value;\n}\n\n/**\n * Render the prompt the judge agent receives for one case. Includes\n * the rubric (if any), the original question, the expected reference\n * (when supplied), and the actual answer — then asks for a strict JSON\n * verdict so the response is machine-parseable even without an output\n * schema.\n */\nfunction buildJudgePrompt(context: EvalScorerContext, judge: EvalJudge): string {\n  const lines: string[] = [];\n\n  if (judge.rubric) {\n    lines.push(`Grading rubric:\\n${judge.rubric}`, \"\");\n  }\n\n  lines.push(`Question:\\n${context.case.input}`, \"\");\n\n  if (context.case.expected !== undefined) {\n    const expectedText =\n      typeof context.case.expected === \"string\"\n        ? context.case.expected\n        : JSON.stringify(context.case.expected);\n    lines.push(`Reference answer:\\n${expectedText}`, \"\");\n  }\n\n  const actual = context.text ?? JSON.stringify(context.output ?? null);\n  lines.push(`Answer to grade:\\n${actual}`, \"\");\n\n  lines.push(\n    'Respond with JSON only: { \"score\": <0..1>, \"passed\": <true|false>, \"reason\": \"<short explanation>\" }.',\n  );\n\n  return lines.join(\"\\n\");\n}\n\n/**\n * Coerce the judge agent's parsed/extracted verdict into a normalized\n * {@link EvalScore}. Defends against a judge that returns a string\n * score or omits `passed` — the caller-supplied `passThreshold`\n * derives `passed` from `score` when the judge didn't decide.\n */\nfunction toEvalScore(verdict: JudgeVerdict, passThreshold: number): EvalScore {\n  const rawScore = typeof verdict.score === \"string\" ? Number(verdict.score) : verdict.score;\n  const score = clampScore(typeof rawScore === \"number\" ? rawScore : 0);\n\n  const passed = typeof verdict.passed === \"boolean\" ? verdict.passed : score >= passThreshold;\n\n  const reason = typeof verdict.reason === \"string\" ? verdict.reason : undefined;\n\n  return { score, passed, reason };\n}\n\n/**\n * LLM-as-judge scorer. Runs the judge agent on a prompt built from the\n * case (question + expected + actual answer + rubric) and parses its\n * `{ score, passed?, reason? }` verdict.\n *\n * Verdict source order: `result.data` (when the judge declares an\n * output schema), then `result.text` parsed as JSON. A judge that\n * errors or returns unparseable text scores `0` with the failure\n * reason attached — a broken judge fails the case rather than crashing\n * the suite.\n *\n * @example\n * scorers: [judge({ agent: judgeAgent, rubric: \"Cite a source for full marks.\" })]\n */\nexport function judge<TOutput = unknown>(\n  config: EvalJudge,\n  passThreshold = 0.5,\n): EvalScorer<TOutput> {\n  const threshold = config.passThreshold ?? passThreshold;\n\n  return async (context: EvalScorerContext<TOutput>): Promise<EvalScore> => {\n    const prompt = buildJudgePrompt(context as EvalScorerContext, config);\n\n    const verdictResult = await config.agent.execute(prompt);\n\n    if (verdictResult.error) {\n      return {\n        score: 0,\n        passed: false,\n        reason: `judge failed: ${verdictResult.error.message}`,\n      };\n    }\n\n    if (verdictResult.data && typeof verdictResult.data === \"object\") {\n      return toEvalScore(verdictResult.data as JudgeVerdict, threshold);\n    }\n\n    const text = verdictResult.text ?? \"\";\n    const sentinel = Symbol(\"judge-parse-failed\");\n    const parsed = safeJsonParse<unknown>(extractJsonPayload(text), sentinel);\n\n    if (parsed === sentinel || parsed === null || typeof parsed !== \"object\") {\n      return {\n        score: 0,\n        passed: false,\n        reason: \"judge returned no parseable verdict\",\n      };\n    }\n\n    return toEvalScore(parsed as JudgeVerdict, threshold);\n  };\n}\n","import type { AgentContract } from \"../contracts/agent/agent.contract\";\nimport type { AgentExecuteOptions } from \"../contracts/agent/agent-options.type\";\nimport type {\n  EvalCase,\n  EvalCaseResult,\n  EvalOptions,\n  EvalReport,\n  EvalScore,\n  EvalScorer,\n  EvalScorerContext,\n} from \"../contracts/agent/eval.type\";\nimport { AgentExecutionError } from \"../errors\";\nimport { log } from \"@warlock.js/logger\";\nimport { judge as judgeScorer } from \"./judge-scorer\";\n\nconst LOG_MODULE = \"ai.eval\";\nconst DEFAULT_PASS_THRESHOLD = 0.5;\n\n/**\n * Resolve the scorer list for a single case. Precedence: the case's\n * own `scorers` → the suite `scorers` → a synthesized judge scorer\n * when `judge` is configured. Throws an authoring-time\n * `AgentExecutionError` when a case can resolve none — an eval suite\n * with no way to score a case is a config bug worth surfacing at the\n * call site, not a silent pass.\n */\nfunction resolveScorers<TOutput>(\n  evalCase: EvalCase<TOutput>,\n  options: EvalOptions<TOutput>,\n  passThreshold: number,\n): EvalScorer<TOutput>[] {\n  if (evalCase.scorers && evalCase.scorers.length > 0) {\n    return evalCase.scorers;\n  }\n\n  if (options.scorers && options.scorers.length > 0) {\n    return options.scorers;\n  }\n\n  if (options.judge) {\n    return [judgeScorer<TOutput>(options.judge, passThreshold)];\n  }\n\n  throw new AgentExecutionError(\n    `eval case \"${evalCase.name}\" has no scorer — supply per-case \"scorers\", suite \"scorers\", or a \"judge\"`,\n    { context: { authoring: true, case: evalCase.name } },\n  );\n}\n\n/**\n * Decide a single scorer verdict's pass/fail. Honors an explicit\n * `passed` from the scorer; otherwise derives it from\n * `score >= passThreshold`.\n */\nfunction isScorePassing(score: EvalScore, passThreshold: number): boolean {\n  if (typeof score.passed === \"boolean\") {\n    return score.passed;\n  }\n\n  return score.score >= passThreshold;\n}\n\n/**\n * Merge suite-level execute options with the case's own override.\n * Per-case wins on conflict (shallow merge).\n */\nfunction mergeOptions<TOutput>(\n  suite: AgentExecuteOptions<TOutput> | undefined,\n  perCase: AgentExecuteOptions<TOutput> | undefined,\n): AgentExecuteOptions<TOutput> | undefined {\n  if (!suite) return perCase;\n  if (!perCase) return suite;\n  return { ...suite, ...perCase };\n}\n\n/**\n * Run one case end-to-end: execute the agent, run every resolved\n * scorer, aggregate into an {@link EvalCaseResult}. A case passes only\n * when the agent did not error AND every scorer passed.\n */\nasync function runCase<TOutput>(\n  agent: AgentContract<TOutput>,\n  evalCase: EvalCase<TOutput>,\n  options: EvalOptions<TOutput>,\n  passThreshold: number,\n): Promise<EvalCaseResult<TOutput>> {\n  const scorers = resolveScorers(evalCase, options, passThreshold);\n  const executeOptions = mergeOptions(options.executeOptions, evalCase.options);\n\n  const start = performance.now();\n  const result = await agent.execute(evalCase.input, executeOptions);\n  const duration = performance.now() - start;\n\n  const context: EvalScorerContext<TOutput> = {\n    case: evalCase,\n    result,\n    output: result.data,\n    text: result.text,\n  };\n\n  const scores: EvalScore[] = [];\n\n  for (const scorer of scorers) {\n    scores.push(await scorer(context));\n  }\n\n  const meanScore =\n    scores.length > 0 ? scores.reduce((sum, score) => sum + score.score, 0) / scores.length : 0;\n\n  const allScorersPassed = scores.every((score) => isScorePassing(score, passThreshold));\n  const passed = result.error === undefined && allScorersPassed;\n\n  return {\n    case: evalCase,\n    result,\n    scores,\n    score: meanScore,\n    passed,\n    duration,\n  };\n}\n\n/**\n * Core implementation of `agent.eval`. Runs every case sequentially\n * (cases share the agent and may carry side effects — ordering must be\n * deterministic), scores each, fires `onFailure` for failed cases, and\n * assembles the aggregate {@link EvalReport}.\n *\n * Never throws on a case-level failure; the only throw is the\n * authoring-time \"no scorer\" guard from {@link resolveScorers}.\n */\nexport async function runEval<TOutput>(\n  agent: AgentContract<TOutput>,\n  options: EvalOptions<TOutput>,\n): Promise<EvalReport<TOutput>> {\n  const passThreshold = options.passThreshold ?? DEFAULT_PASS_THRESHOLD;\n  const start = performance.now();\n\n  const cases: EvalCaseResult<TOutput>[] = [];\n\n  for (const evalCase of options.cases) {\n    const caseResult = await runCase(agent, evalCase, options, passThreshold);\n\n    cases.push(caseResult);\n\n    if (!caseResult.passed && options.onFailure) {\n      try {\n        await options.onFailure(caseResult);\n      } catch (error) {\n        log.warn(LOG_MODULE, \"onFailure.hook.error\", \"eval onFailure handler threw\", {\n          agent: agent.name,\n          case: evalCase.name,\n          error: error instanceof Error ? error.message : String(error),\n        });\n      }\n    }\n  }\n\n  const passedCount = cases.filter((entry) => entry.passed).length;\n  const total = cases.length;\n  const meanScore =\n    total > 0 ? cases.reduce((sum, entry) => sum + entry.score, 0) / total : 0;\n\n  return {\n    agentName: agent.name,\n    total,\n    passedCount,\n    failedCount: total - passedCount,\n    passRate: total > 0 ? passedCount / total : 0,\n    meanScore,\n    passed: total > 0 && passedCount === total,\n    cases,\n    duration: performance.now() - start,\n  };\n}\n","import type { Message } from \"../../contracts/conversation-message.type\";\n\n/**\n * Pull the text a content-inspection middleware should care about\n * from the outbound message list.\n *\n * **Role.** Built-ins that inspect \"what the user just said\" — the\n * guardrail on `trip.before`, the semantic cache on `trip.before`,\n * future consumers like PII redactors — all need the same string:\n * the most recent `user`-role message's text content. This helper\n * is the single authority on how that string is resolved.\n *\n * **Behavior.**\n * - Walks `messages` from the end backwards so the LAST user turn\n *   wins (correct when the agent has history + a fresh prompt).\n * - Returns a plain string directly when `content` is a string.\n * - Joins `text` parts with `\"\\n\"` when `content` is a multipart\n *   `ContentPart[]`. Non-text parts (images, audio) are skipped —\n *   callers concerned with multimodal content inspect `request`\n *   / attachments separately.\n * - Returns `\"\"` when there is no user message at all (e.g. a trip\n *   composed entirely of tool results).\n *\n * @example\n * const prompt = extractUserText(context.messages);\n * if (!prompt) return;\n * const verdict = await inputCheck(prompt);\n */\nexport function extractUserText(messages: ReadonlyArray<Message>): string {\n  for (let index = messages.length - 1; index >= 0; index--) {\n    const message = messages[index];\n\n    if (message.role !== \"user\") {\n      continue;\n    }\n\n    if (typeof message.content === \"string\") {\n      return message.content;\n    }\n\n    if (Array.isArray(message.content)) {\n      return message.content\n        .filter((part) => part.type === \"text\")\n        .map((part) => (part as { text: string }).text)\n        .join(\"\\n\");\n    }\n  }\n\n  return \"\";\n}\n","import type { MiddlewareState } from \"../../contracts/middleware\";\n\n/**\n * Typed accessor over `ctx.state` for a single namespace key. Wraps\n * the raw `Map<string, unknown>` so middleware authors stop typing\n * `as Counters | undefined` on every read.\n *\n * **Role.** Every built-in middleware reads and writes one or two\n * entries in `ctx.state` under its own name. Without a helper,\n * every call-site looks like:\n *\n * ```ts\n * const counters = context.state.get(\"budget.counters\") as Counters | undefined;\n * if (!counters) { ... }\n * counters.tokens += n;\n * ```\n *\n * — cast noise, no type narrowing on `set`, no protection against\n * key typos. `namespacedState<T>` eliminates all three.\n *\n * **Scope.** Deliberately narrow: one key, typed value, four methods\n * (`get` / `set` / `delete` / `has`). Does NOT try to model compound\n * or nested keys — if you need those, use the raw `ctx.state` Map\n * directly, or create a second namespaced accessor for the second key.\n *\n * **Namespace convention.** Use the middleware's `name` as the key\n * (or a `name.<field>` prefix when a middleware needs multiple\n * entries). The pipeline does not enforce this — it is a convention\n * the built-ins follow to avoid collisions between middlewares.\n *\n * @example\n * // Inside a budget middleware:\n * const counters = namespacedState<Counters>(ctx, \"budget\");\n *\n * if (!counters.has()) {\n *   counters.set({ tokens: 0, costUSD: 0 });\n * }\n *\n * const current = counters.get()!;\n * current.tokens += response.usage.total;\n */\nexport function namespacedState<T>(\n  ctx: { readonly state: MiddlewareState },\n  namespace: string,\n): NamespacedStateAccessor<T> {\n  return {\n    get(): T | undefined {\n      return ctx.state.get(namespace) as T | undefined;\n    },\n    set(value: T): void {\n      ctx.state.set(namespace, value);\n    },\n    delete(): void {\n      ctx.state.delete(namespace);\n    },\n    has(): boolean {\n      return ctx.state.has(namespace);\n    },\n  };\n}\n\n/**\n * Four-method accessor returned by `namespacedState`. Callers hold\n * it for the lifetime of a hook body — it is a thin typed view over\n * `ctx.state`, not a detached snapshot. Reads are live; writes hit\n * the underlying Map immediately and are visible to every other\n * hook that uses the same namespace.\n */\nexport type NamespacedStateAccessor<T> = {\n  get(): T | undefined;\n  set(value: T): void;\n  delete(): void;\n  has(): boolean;\n};\n","import type {\n  AgentMiddleware,\n  MiddlewareExecuteContext,\n} from \"../../contracts/middleware\";\nimport { BudgetExceededError, type BudgetUnit } from \"../../errors\";\nimport { namespacedState } from \"../utils\";\nimport type {\n  BudgetContract,\n  BudgetContractDimension,\n  BudgetContractViolation,\n} from \"./budget-contract.type\";\n\nexport type {\n  BudgetContract,\n  BudgetContractDimension,\n  BudgetContractFallback,\n  BudgetContractViolation,\n  BudgetContractViolationMode,\n} from \"./budget-contract.type\";\n\n/**\n * Per-model pricing used to compute USD cost from token counts.\n * Caller-supplied — no bundled table. Keys are model names (the\n * `ModelContract.name` value); values are input / output token\n * prices expressed as **USD per 1K tokens** to match every major\n * provider's published pricing sheet.\n */\nexport type BudgetPricing = Record<\n  string,\n  {\n    /** USD per 1,000 input tokens. */\n    inputPer1K: number;\n    /** USD per 1,000 output tokens. */\n    outputPer1K: number;\n  }\n>;\n\n/**\n * Configuration for `budget()`. At least one of `maxTokens` or\n * `maxCostUSD` must be supplied — a budget with no cap is a no-op.\n */\nexport type BudgetOptions = {\n  /**\n   * Hard cap on cumulative total tokens (input + output, summed\n   * across every trip of the run). Inclusive — exceeding triggers\n   * the configured `onExceeded`.\n   */\n  maxTokens?: number;\n  /**\n   * Hard cap on cumulative USD cost. Requires `pricing` for the\n   * agent's configured model — without a pricing entry the USD check\n   * silently skips (tokens-only enforcement still applies).\n   */\n  maxCostUSD?: number;\n  /**\n   * Per-model pricing table used to compute USD cost. Only consulted\n   * when `maxCostUSD` is set. Model names must match the running\n   * agent's `ModelContract.name` exactly.\n   */\n  pricing?: BudgetPricing;\n  /**\n   * Behavior when a cap is breached. `\"abort\"` throws\n   * `BudgetExceededError` — surfaces on `result.error`, stops the\n   * run at the next trip boundary. `\"warn\"` logs a warning and\n   * lets the run continue (useful for observability-first rollouts\n   * before flipping the switch to abort). Default `\"abort\"`.\n   */\n  onExceeded?: \"abort\" | \"warn\";\n  /**\n   * Override the middleware name. Useful when two budgets coexist\n   * (e.g. a per-request cap plus a session-wide cap via different\n   * instances). Default `\"budget\"`.\n   */\n  name?: string;\n  /**\n   * Declarative SLO / cost contract enforced on top of (and\n   * independently of) the legacy `maxTokens` / `maxCostUSD` caps.\n   * Adds a wall-clock `maxLatencyMs` dimension and a per-contract\n   * `onViolation` reaction (`\"abort\"` hard-stops, `\"fallback\"` records\n   * a signal + fires `fallback` and lets the run continue). Omit to\n   * keep the classic budget behavior unchanged.\n   *\n   * Read a recorded fallback signal back with\n   * {@link readBudgetFallbackSignal}.\n   */\n  contract?: BudgetContract;\n};\n\ntype BudgetCounters = {\n  tokens: number;\n  costUSD: number;\n  warned: boolean;\n  /**\n   * Wall-clock epoch ms captured at `execute.before`. Used to derive\n   * cumulative run latency for the contract's `maxLatencyMs` clause.\n   */\n  startedAt: number;\n  /**\n   * Set once a `\"fallback\"` contract clause has fired, so the signal +\n   * callback are emitted at most once per run even if later trips keep\n   * breaching.\n   */\n  fallbackFired: boolean;\n};\n\n/**\n * Recorded contract fallback signal, stashed under the `<name>.fallback`\n * state key when a `\"fallback\"` clause trips. A fallback orchestrator\n * reads it via {@link readBudgetFallbackSignal} to decide how to degrade.\n */\nexport type BudgetFallbackSignal = BudgetContractViolation;\n\n/**\n * The `BudgetUnit` to stamp on the thrown error per contract dimension.\n * Latency has no native unit — it borrows `\"requests\"` as the least-wrong\n * operational measure, while the authoritative detail rides on the\n * error's `context.dimension`.\n */\nconst DIMENSION_UNIT: Record<BudgetContractDimension, BudgetUnit> = {\n  tokens: \"tokens\",\n  cost: \"usd\",\n  latency: \"requests\",\n};\n\nfunction breach(\n  limit: number,\n  actual: number,\n  unit: BudgetUnit,\n  name: string,\n): never {\n  throw new BudgetExceededError(\n    `budget \"${name}\" exceeded — ${actual} ${unit} (cap: ${limit})`,\n    { limit, actual, unit },\n  );\n}\n\nfunction breachContract(\n  name: string,\n  dimension: BudgetContractDimension,\n  limit: number,\n  actual: number,\n): never {\n  throw new BudgetExceededError(\n    `budget \"${name}\" contract exceeded — ${dimension} ${actual} (cap: ${limit})`,\n    {\n      limit,\n      actual,\n      unit: DIMENSION_UNIT[dimension],\n      context: { dimension, limit, actual, source: \"contract\" },\n    },\n  );\n}\n\n/**\n * Read the contract fallback signal recorded by a `budget()` middleware\n * running under `contract.onViolation: \"fallback\"`. Returns `undefined`\n * when no clause was breached.\n *\n * **Role.** The middleware cannot itself switch models on a soft breach,\n * so it records a typed {@link BudgetFallbackSignal} in the shared state\n * bag and lets the run continue. A fallback orchestrator (or the\n * `execute.after` hook of an outer middleware) reads it back here and\n * decides how to degrade the next run — cheaper model, cached answer,\n * truncated context.\n *\n * @param state - The middleware state bag (`ctx.state`).\n * @param name - The budget middleware's name. Default `\"budget\"`,\n *   matching `BudgetOptions.name`'s default.\n *\n * @example\n * const guard = budget({ contract: { maxCostUSD: 0.05, onViolation: \"fallback\" } });\n *\n * // In an outer middleware's execute.after, after the run:\n * const signal = readBudgetFallbackSignal(ctx.state);\n * if (signal?.dimension === \"cost\") {\n *   await rerunOnCheaperModel();\n * }\n */\nexport function readBudgetFallbackSignal(\n  state: MiddlewareExecuteContext[\"state\"],\n  name = \"budget\",\n): BudgetFallbackSignal | undefined {\n  return namespacedState<BudgetFallbackSignal>(\n    { state },\n    `${name}.fallback`,\n  ).get();\n}\n\n/**\n * Enforced token and / or USD budget for an agent run.\n *\n * **Role.** Guards against runaway tool loops, misconfigured\n * prompts, and unexpected provider price swings by capping\n * cumulative usage across every LLM trip of a single execution.\n * Aborts the run with a typed `BudgetExceededError` the moment a cap\n * is breached, rather than letting the damage grow trip by trip.\n *\n * **Scope.** Per-execution. A fresh counter is created at\n * `execute.before` and lives in the middleware state bag until the\n * run ends. Two concurrent `agent.execute()` calls on the same\n * agent therefore enforce the cap independently.\n *\n * **Token accounting.** After each successful trip, the middleware\n * adds `response.usage.total` to its running total and checks\n * against `maxTokens`. Synthetic trips (cache hits) contribute\n * `usage.total` as returned by the cache — cache middleware is\n * expected to surface zero usage on a hit, which naturally excludes\n * those trips from the budget.\n *\n * **USD accounting.** When `maxCostUSD` + `pricing[modelName]` are\n * both present, the middleware converts per-trip input / output\n * tokens to USD and accumulates. Missing pricing silently degrades\n * to tokens-only — explicit rather than guessing.\n *\n * **Warn mode.** `onExceeded: \"warn\"` logs a single warning the first\n * time a cap is breached and lets the run continue. Useful for\n * measuring real-world traffic against a proposed cap before flipping\n * to `\"abort\"` in production.\n *\n * **Contract / SLO mode.** Pass `contract` to enforce a declarative\n * service-level objective — `maxCostUSD`, `maxLatencyMs`, `maxTokens` —\n * on top of the legacy caps, with a single `onViolation` reaction:\n * `\"abort\"` hard-stops with `BudgetExceededError`; `\"fallback\"` records\n * a typed signal (read it via {@link readBudgetFallbackSignal}), fires\n * the optional `fallback` callback, and lets the run continue so an\n * outer layer can degrade gracefully. The contract's clauses are\n * evaluated independently of — and after — the top-level caps; the\n * top-level caps stay fully functional with or without a contract.\n *\n * @example\n * const budgetMiddleware = budget({ maxTokens: 50_000 });\n *\n * const myAgent = agent({\n *   model,\n *   middleware: [budgetMiddleware],\n * });\n *\n * @example\n * // With USD cap and custom pricing\n * const guard = budget({\n *   maxCostUSD: 0.5,\n *   pricing: {\n *     \"gpt-4o\": { inputPer1K: 0.005, outputPer1K: 0.015 },\n *   },\n * });\n *\n * @example\n * // SLO contract — soft-fallback on any breach\n * const sloGuard = budget({\n *   pricing: { \"gpt-4o\": { inputPer1K: 0.005, outputPer1K: 0.015 } },\n *   contract: {\n *     maxCostUSD: 0.05,\n *     maxLatencyMs: 8_000,\n *     maxTokens: 40_000,\n *     onViolation: \"fallback\",\n *     fallback: (violation) => routeToCheaperModel(violation.dimension),\n *   },\n * });\n */\nexport function budget(options: BudgetOptions): AgentMiddleware {\n  const name = options.name ?? \"budget\";\n  const onExceeded = options.onExceeded ?? \"abort\";\n  const hasTokenCap = typeof options.maxTokens === \"number\";\n  const hasCostCap = typeof options.maxCostUSD === \"number\";\n\n  const contract = options.contract;\n  const contractMode = contract?.onViolation ?? \"abort\";\n  const hasContractTokenCap = typeof contract?.maxTokens === \"number\";\n  const hasContractCostCap = typeof contract?.maxCostUSD === \"number\";\n  const hasContractLatencyCap = typeof contract?.maxLatencyMs === \"number\";\n  const contractNeedsCost = hasCostCap || hasContractCostCap;\n\n  return {\n    name,\n    execute: {\n      before(context) {\n        const counters = namespacedState<BudgetCounters>(context, name);\n        counters.set({\n          tokens: 0,\n          costUSD: 0,\n          warned: false,\n          startedAt: Date.now(),\n          fallbackFired: false,\n        });\n      },\n    },\n    trip: {\n      async after(context, response) {\n        const counters = namespacedState<BudgetCounters>(context, name).get();\n\n        if (!counters) {\n          return;\n        }\n\n        counters.tokens += response.usage.total;\n\n        if (contractNeedsCost && options.pricing) {\n          const pricing = options.pricing[context.model.name];\n\n          if (pricing) {\n            const tripCost =\n              (response.usage.input / 1000) * pricing.inputPer1K +\n              (response.usage.output / 1000) * pricing.outputPer1K;\n            counters.costUSD += tripCost;\n          }\n        }\n\n        if (hasTokenCap && counters.tokens > options.maxTokens!) {\n          if (onExceeded === \"abort\") {\n            breach(options.maxTokens!, counters.tokens, \"tokens\", name);\n          }\n\n          if (!counters.warned) {\n            counters.warned = true;\n          }\n        }\n\n        if (hasCostCap && counters.costUSD > options.maxCostUSD!) {\n          if (onExceeded === \"abort\") {\n            breach(options.maxCostUSD!, counters.costUSD, \"usd\", name);\n          }\n\n          if (!counters.warned) {\n            counters.warned = true;\n          }\n        }\n\n        if (!contract) {\n          return;\n        }\n\n        if (hasContractTokenCap && counters.tokens > contract.maxTokens!) {\n          await enforceContract(\n            context,\n            counters,\n            name,\n            contractMode,\n            contract,\n            \"tokens\",\n            contract.maxTokens!,\n            counters.tokens,\n          );\n        }\n\n        if (hasContractCostCap && counters.costUSD > contract.maxCostUSD!) {\n          await enforceContract(\n            context,\n            counters,\n            name,\n            contractMode,\n            contract,\n            \"cost\",\n            contract.maxCostUSD!,\n            counters.costUSD,\n          );\n        }\n\n        if (hasContractLatencyCap) {\n          const elapsedMs = Date.now() - counters.startedAt;\n\n          if (elapsedMs > contract.maxLatencyMs!) {\n            await enforceContract(\n              context,\n              counters,\n              name,\n              contractMode,\n              contract,\n              \"latency\",\n              contract.maxLatencyMs!,\n              elapsedMs,\n            );\n          }\n        }\n      },\n    },\n  };\n}\n\n/**\n * Apply the contract's reaction to a single breached clause. `\"abort\"`\n * throws `BudgetExceededError` (stops the run); `\"fallback\"` records the\n * signal once, fires the callback, and returns so the run continues.\n *\n * The callback is invoked at most once per run (guarded by\n * `counters.fallbackFired`) and its rejections are swallowed — a buggy\n * fallback hook must never crash the agent.\n */\nasync function enforceContract(\n  context: MiddlewareExecuteContext,\n  counters: BudgetCounters,\n  name: string,\n  mode: NonNullable<BudgetContract[\"onViolation\"]>,\n  contract: BudgetContract,\n  dimension: BudgetContractDimension,\n  limit: number,\n  actual: number,\n): Promise<void> {\n  if (mode === \"abort\") {\n    breachContract(name, dimension, limit, actual);\n  }\n\n  if (counters.fallbackFired) {\n    return;\n  }\n\n  counters.fallbackFired = true;\n\n  const violation: BudgetContractViolation = {\n    dimension,\n    limit,\n    actual,\n    mode,\n  };\n\n  namespacedState<BudgetContractViolation>(context, `${name}.fallback`).set(\n    violation,\n  );\n\n  if (!contract.fallback) {\n    return;\n  }\n\n  try {\n    await contract.fallback(violation, context);\n  } catch {\n    // A fallback callback is a notification hook — its failure must\n    // never crash the run. Swallow deliberately.\n  }\n}\n","import type {\n  AgentMiddleware,\n  MiddlewareTripContext,\n} from \"../../contracts/middleware\";\nimport type { ModelResponse } from \"../../contracts/model.contract\";\nimport { GuardrailViolationError } from \"../../errors\";\nimport { extractUserText } from \"../utils\";\n\n/**\n * Decision returned by a guardrail check function. `ok: true`\n * permits the call; `ok: false` rejects with a human-readable\n * `reason` surfaced on `GuardrailViolationError`.\n */\nexport type GuardrailCheckResult = { ok: true } | { ok: false; reason: string };\n\n/**\n * Synchronous or asynchronous check invoked against the outbound\n * prompt (`inputCheck`) or the inbound response (`outputCheck`).\n * Receives the raw text and the surrounding trip context so\n * consumers can classify, route to an external moderation API, or\n * branch on tripIndex / messages history.\n */\nexport type GuardrailCheck = (\n  text: string,\n  context: MiddlewareTripContext,\n) => GuardrailCheckResult | Promise<GuardrailCheckResult>;\n\n/**\n * Configuration for `guardrail()`.  At least one of `inputCheck` or\n * `outputCheck` must be supplied — a guardrail with no checks is a\n * no-op.\n */\nexport type GuardrailOptions = {\n  /**\n   * Run against the outbound prompt just before the model sees it.\n   * Fires every trip with the concatenated last user-message text.\n   * Rejection aborts the trip with a `GuardrailViolationError` whose\n   * `phase === \"input\"`.\n   */\n  inputCheck?: GuardrailCheck;\n  /**\n   * Run against the model's response text after the trip completes.\n   * Fires every trip with `response.content`. Rejection aborts with\n   * a `GuardrailViolationError` whose `phase === \"output\"`.\n   *\n   * Output checks run BEFORE any tool dispatch — a rejected response\n   * means the tool calls it requested are never invoked.\n   */\n  outputCheck?: GuardrailCheck;\n  /**\n   * Override the middleware name — surfaces on\n   * `GuardrailViolationError.guardrail` so operators can tell two\n   * guardrails apart in logs. Default `\"guardrail\"`.\n   */\n  name?: string;\n};\n\n/**\n * Pre/post content guardrail for an agent run.\n *\n * **Role.** Inspects outbound prompts and inbound responses against\n * caller-supplied policies, aborting the trip with a typed\n * `GuardrailViolationError` when either trips a check. Consumers\n * distinguish `\"input\"` vs `\"output\"` violations off `error.phase`\n * — the two failure modes have very different product responses\n * (block the user vs re-prompt the model).\n *\n * **Scope.** Per-trip. Fires on every round-trip the agent makes,\n * including repair attempts and tool-follow-up trips. Input checks\n * evaluate the last user-role message; output checks evaluate the\n * raw model response text before any tool call is dispatched.\n *\n * **Composition.** A single middleware instance can carry both\n * `inputCheck` and `outputCheck`, or two separate instances can be\n * registered (useful when input and output policies come from\n * different teams / services). Registration order determines which\n * guardrail's violation surfaces first — the short-circuit throws\n * from the innermost offending hook, and outer guardrails never run\n * after an abort.\n *\n * **Not a sanitizer.** The guardrail either passes a trip unchanged\n * or aborts it. Mutating the prompt / response in-place is out of\n * scope — use a bespoke middleware for content rewriting.\n *\n * @example\n * const policy = guardrail({\n *   inputCheck: async (text) =>\n *     text.includes(\"SSN\") ? { ok: false, reason: \"pii\" } : { ok: true },\n *   outputCheck: async (text) =>\n *     text.length > 10_000 ? { ok: false, reason: \"too-long\" } : { ok: true },\n * });\n *\n * const myAgent = agent({ model, middleware: [policy] });\n */\nexport function guardrail(options: GuardrailOptions): AgentMiddleware {\n  const name = options.name ?? \"guardrail\";\n  const { inputCheck, outputCheck } = options;\n\n  return {\n    name,\n    trip: {\n      async before(context) {\n        if (!inputCheck) {\n          return;\n        }\n\n        const prompt = extractUserText(context.messages);\n\n        if (!prompt) {\n          return;\n        }\n\n        const verdict = await inputCheck(prompt, context);\n\n        if (!verdict.ok) {\n          throw new GuardrailViolationError(\n            `guardrail \"${name}\" rejected input — ${verdict.reason}`,\n            { phase: \"input\", reason: verdict.reason, guardrail: name },\n          );\n        }\n      },\n      async after(context, response: ModelResponse) {\n        if (!outputCheck) {\n          return;\n        }\n\n        if (!response.content) {\n          return;\n        }\n\n        const verdict = await outputCheck(response.content, context);\n\n        if (!verdict.ok) {\n          throw new GuardrailViolationError(\n            `guardrail \"${name}\" rejected output — ${verdict.reason}`,\n            { phase: \"output\", reason: verdict.reason, guardrail: name },\n          );\n        }\n      },\n    },\n  };\n}\n","import type { CacheDriver } from \"@warlock.js/cache\";\nimport type { CheckpointStore } from \"./contracts/orchestrator/checkpoint-store.contract\";\nimport type { SnapshotStore } from \"./contracts/orchestrator/snapshot-store.contract\";\n\n/**\n * Process-wide `@warlock.js/ai` configuration. **Intentionally tiny.**\n * Lives here only for genuinely cross-cutting defaults that would\n * otherwise force users to wire the same value into every consumer.\n *\n * **What lives here.** A field earns a slot only when it satisfies\n * all three:\n * 1. Multiple unrelated consumers need the same value.\n * 2. The value is infrastructure (drivers, clients, pools), not\n *    behavior (kill-switches, mode flags).\n * 3. Per-call override doesn't make sense for the use case.\n *\n * **What does NOT live here.** Logger config (use\n * `@warlock.js/logger` directly). Per-primitive feature flags\n * (live on the relevant config type). Anything that's really one\n * consumer's concern (lives on that consumer).\n *\n * Phase 3.2 deliberately removed the previous `configureAI()` bag\n * because it was growing unbounded. Treat new fields here with the\n * same suspicion.\n */\nexport type AIConfig = {\n  /**\n   * Default `@warlock.js/cache` driver for cache-backed consumers that\n   * didn't supply their own `store` — currently the `semanticCache`\n   * middleware's vector store. Declaring it once here removes the\n   * repetition across middleware declarations.\n   *\n   * NOT the snapshot-persistence fallback anymore. Supervisor /\n   * workflow / orchestrator resume snapshots resolve through\n   * {@link AIConfig.defaultSnapshotStore} (a {@link SnapshotStore}),\n   * never this driver.\n   *\n   * Per-declaration overrides (`semanticCache({ store })`) win when\n   * supplied. Set this once at app boot, *after* you've constructed\n   * your driver.\n   *\n   * @example\n   * import { cache } from \"@warlock.js/cache\";\n   * import { ai } from \"@warlock.js/ai\";\n   *\n   * ai.config({\n   *   defaultStore: cache.driver(\"redis\", { client: redisClient }),\n   * });\n   */\n  defaultStore?: CacheDriver<any, any>;\n\n  /**\n   * Default {@link CheckpointStore} for every orchestrator that didn't\n   * supply its own `checkpointStore` (orchestrator.md §15.2). Holds\n   * durable session state — `state`, `turn_index`, drift `signature`,\n   * compaction locks. Per-orchestrator `checkpointStore` wins when\n   * supplied. Set once at app boot.\n   *\n   * @example\n   * import { ai } from \"@warlock.js/ai\";\n   *\n   * ai.config({ defaultCheckpointStore: ai.checkpoint.memory() });\n   */\n  defaultCheckpointStore?: CheckpointStore;\n\n  /**\n   * Default {@link SnapshotStore} for every orchestrator that didn't\n   * supply its own `snapshotStore` (orchestrator.md §15.2). Holds the\n   * internal supervisor run state used to resume an interrupted\n   * `iterate: true` turn. Per-orchestrator `snapshotStore` wins when\n   * supplied. Set once at app boot.\n   *\n   * @example\n   * import { ai } from \"@warlock.js/ai\";\n   *\n   * ai.config({ defaultSnapshotStore: ai.snapshot.memory() });\n   */\n  defaultSnapshotStore?: SnapshotStore;\n};\n\nconst aiConfig: AIConfig = {};\n\n/**\n * Set or extend process-wide AI configuration. Merges over existing\n * values — fields not present in `partial` keep whatever was set\n * before (or stay unset). Call once at app boot, before constructing\n * any agent / supervisor / middleware that should pick up the\n * defaults.\n *\n * Returns the merged config so callers can verify what landed.\n *\n * @example\n * import { cache } from \"@warlock.js/cache\";\n * import { ai } from \"@warlock.js/ai\";\n *\n * ai.config({ defaultStore: cache.driver(\"redis\", { client }) });\n */\nexport function setAIConfig(partial: Partial<AIConfig>): AIConfig {\n  Object.assign(aiConfig, partial);\n  return { ...aiConfig };\n}\n\n/**\n * Read the current AI config snapshot. Returns a shallow copy so\n * callers can't accidentally mutate the source of truth. Used\n * internally by consumers to resolve their `defaultStore` fallback.\n */\nexport function getAIConfig(): AIConfig {\n  return { ...aiConfig };\n}\n\n/**\n * Resolve the effective `@warlock.js/cache` driver for a cache-backed\n * consumer that didn't receive an explicit one. Returns the global\n * `defaultStore` if set, otherwise `undefined`. The semantic-cache\n * middleware treats `undefined` as fatal and throws. Snapshot\n * persistence no longer consults this — it resolves through\n * {@link resolveDefaultSnapshotStore}.\n */\nexport function resolveDefaultStore(): CacheDriver<any, any> | undefined {\n  return aiConfig.defaultStore;\n}\n\n/**\n * Resolve the global default {@link CheckpointStore} for an\n * orchestrator that didn't receive an explicit `checkpointStore`.\n * Returns `undefined` when none is configured — the orchestrator\n * factory decides whether that's fatal.\n */\nexport function resolveDefaultCheckpointStore(): CheckpointStore | undefined {\n  return aiConfig.defaultCheckpointStore;\n}\n\n/**\n * Resolve the global default {@link SnapshotStore} for an orchestrator\n * that didn't receive an explicit `snapshotStore`. Returns `undefined`\n * when none is configured — the orchestrator factory decides whether\n * that's fatal (it is, when `iterate: true`).\n */\nexport function resolveDefaultSnapshotStore(): SnapshotStore | undefined {\n  return aiConfig.defaultSnapshotStore;\n}\n","import type { CacheDriver } from \"@warlock.js/cache\";\nimport { resolveDefaultStore } from \"../../config\";\nimport type { Message } from \"../../contracts/conversation-message.type\";\nimport type { EmbedderContract } from \"../../contracts/embedder.contract\";\nimport type { AgentMiddleware } from \"../../contracts/middleware\";\nimport type { ModelResponse } from \"../../contracts/model.contract\";\nimport { extractUserText } from \"../utils\";\n\n/**\n * Configuration for `semanticCache()`.\n */\nexport type SemanticCacheOptions = {\n  /** Embedder used to produce the query vector from the prompt text. */\n  embedder: EmbedderContract;\n  /**\n   * Vector-capable cache driver from `@warlock.js/cache`. Production\n   * deployments pick a driver with a real ANN index (`pg` with\n   * pgvector, `redis` with RediSearch). Dev / test environments use\n   * `new MemoryCacheDriver()` — zero config, correct, but O(N) per\n   * query. Drivers without similarity support throw\n   * `CacheUnsupportedError` from `set({ vector })` / `similar()`.\n   *\n   * Falls back to `ai.config({ defaultStore })` when omitted. When\n   * neither is set, the factory throws at construction time —\n   * semantic cache cannot operate without a store.\n   */\n  store?: CacheDriver<any, any>;\n  /**\n   * Minimum cosine similarity for a vector hit. Between 0 and 1 —\n   * 0.95 is a solid default for question-answering caches.\n   */\n  threshold: number;\n  /**\n   * Optional TTL in milliseconds. Entries whose `storedAt` is older\n   * than this are treated as misses on read and overwritten on the\n   * next write. Default: no expiry — entries live until the store\n   * evicts them (per its own TTL/eviction policy).\n   */\n  ttlMs?: number;\n  /**\n   * Namespace prefix applied to every key the cache writes. Lets\n   * multiple agents share one driver without collision. Default\n   * `\"ai.cache\"`.\n   */\n  namespace?: string;\n  /**\n   * Middleware name — also the state-bag key prefix inside a single\n   * execution. Default `\"semantic-cache\"`.\n   */\n  name?: string;\n};\n\ntype CachedEntry = {\n  response: ModelResponse;\n  storedAt: number;\n};\n\ntype PendingWrite = {\n  promptKey: string;\n  vector: number[];\n};\n\nconst DEFAULT_NAMESPACE = \"ai.cache\";\n\n/**\n * Build a stable fingerprint for a prompt covering the full message\n * list (system + history + user turn). Ensures two prompts sharing\n * the user text but differing in prior context do not collide on\n * the exact-match fast path.\n *\n * FNV-1a variant — cheap, collision-resistant enough for a cache,\n * dependency-free. NOT a cryptographic hash: collisions would\n * surface as wrong cache hits, not a security issue in the current\n * trust model.\n */\nfunction hashPrompt(messages: ReadonlyArray<Message>): string {\n  const serialized = messages\n    .map((message) => {\n      const role = message.role;\n      const content = Array.isArray(message.content)\n        ? message.content\n            .filter((part) => part.type === \"text\")\n            .map((part) => (part as { text: string }).text)\n            .join(\"|\")\n        : message.content;\n\n      return `${role}:${content}`;\n    })\n    .join(\"||\");\n\n  let hash = 0x811c9dc5;\n\n  for (let index = 0; index < serialized.length; index++) {\n    hash ^= serialized.charCodeAt(index);\n    hash = Math.imul(hash, 0x01000193);\n  }\n\n  return (hash >>> 0).toString(16);\n}\n\nfunction isFresh(entry: CachedEntry, ttlMs: number | undefined): boolean {\n  if (ttlMs === undefined) {\n    return true;\n  }\n\n  return Date.now() - entry.storedAt <= ttlMs;\n}\n\n/**\n * Semantic-similarity response cache for an agent run.\n *\n * **Role.** Skips LLM round-trips when the current prompt is\n * semantically close to one the agent has already answered. For\n * FAQ / support-style traffic this often eliminates 60–80% of\n * model calls — the production win is massive for cost and\n * latency.\n *\n * **Delegation to `@warlock.js/cache`.** This middleware does NOT\n * implement similarity search itself. It delegates to the supplied\n * `CacheDriver`. Production deployments pick a driver with an ANN\n * index (`pg` + pgvector, `redis` + RediSearch). Dev / test\n * environments pass `new MemoryCacheDriver()` — zero config, correct,\n * but O(N) per query. Drivers without similarity support throw\n * `CacheUnsupportedError` from `set({ vector })` / `similar()`.\n *\n * **Two-tier lookup.**\n * 1. *Exact-match key* — a cheap FNV hash over the entire message\n *    list. `store.get(hash)` returns the entry without an embedding\n *    round trip when the prompt hasn't changed at all.\n * 2. *Vector-match* — on exact-match miss, embed the prompt and\n *    call `store.similar(vector, { topK: 1, threshold })`. The\n *    driver uses its native similarity index; anything clearing\n *    `threshold` is returned as a hit.\n *\n * **Write-on-miss.** When both tiers miss, `trip.before` stashes\n * the prompt hash + vector in `ctx.state`; `trip.after` reads back\n * the pending entry and calls\n * `store.set(hash, entry, { vector })`. If an outer middleware\n * (guardrail) throws in `trip.after` before the cache's `trip.after`\n * runs, the pending entry is never written — bad responses stay out\n * of the cache **as long as the canonical install order is followed**\n * (cache outermost).\n *\n * **Synthetic-response on hit.** Returns a `ModelResponse` with\n * `usage: { input: 0, output: 0, total: 0 }` so budget /\n * observability correctly exclude the saved trip.\n *\n * @example\n * import { semanticCache } from \"@warlock.js/ai\";\n * import { MemoryCacheDriver } from \"@warlock.js/cache\";\n *\n * const store = new MemoryCacheDriver();\n * store.setOptions({});\n *\n * const cache = semanticCache({\n *   embedder: openai.embedder({ name: \"text-embedding-3-small\" }),\n *   store,\n *   threshold: 0.95,\n *   ttlMs: 60 * 60 * 1000,\n * });\n *\n * const myAgent = agent({ model, middleware: [cache] });\n */\nexport function semanticCache(options: SemanticCacheOptions): AgentMiddleware {\n  const name = options.name ?? \"semantic-cache\";\n  const namespace = options.namespace ?? DEFAULT_NAMESPACE;\n  const pendingKey = `${name}.pending`;\n\n  // Resolve the effective store at factory time, not per-call. Every\n  // subsequent hook closes over `store` so the resolution happens once.\n  // Throws now (loud, at construction) instead of later during the\n  // first trip (silent until the agent actually runs).\n  const store = options.store ?? resolveDefaultStore();\n\n  if (!store) {\n    throw new Error(\n      `semanticCache: no store supplied — pass \\`store\\` in options or call \\`ai.config({ defaultStore })\\` at app boot before constructing the middleware`,\n    );\n  }\n\n  // Cache's parseKey replaces \":\" with \".\" so the namespace boundary\n  // matches what `similar()` actually returns in `hit.key`. Using a\n  // dot here keeps prefix checks aligned with stored keys.\n  const keyFor = (hash: string): string => `${namespace}.${hash}`;\n\n  return {\n    name,\n    log: true,\n    trip: {\n      async before(context) {\n        // Only cache the first trip's response. Subsequent trips\n        // happen because the previous trip requested tool calls — the\n        // message list now carries tool results the original prompt\n        // never saw, so a semantic match on the unchanged user text\n        // would serve back the prior `tool_calls` response and loop\n        // the agent forever. The first turn is also the only one\n        // where a \"same question → same final answer\" caching story\n        // is sound.\n        if (context.tripIndex !== 0) {\n          return;\n        }\n\n        const promptText = extractUserText(context.messages);\n\n        if (!promptText) {\n          return;\n        }\n\n        const promptKey = hashPrompt(context.messages);\n        const scopedKey = keyFor(promptKey);\n\n        const exact = await store.get<CachedEntry>(scopedKey);\n\n        if (exact && isFresh(exact, options.ttlMs)) {\n          return toSyntheticResponse(exact.response);\n        }\n\n        const query = await options.embedder.embed(promptText);\n\n        const [hit] = await store.similar<CachedEntry>(query.vector, {\n          topK: 1,\n          threshold: options.threshold,\n        });\n\n        if (hit && isFresh(hit.value, options.ttlMs)) {\n          // Only return hits whose stored key is within this cache's\n          // namespace. Drivers shared across namespaces would otherwise\n          // leak foreign entries into queries.\n          if (hit.key.startsWith(`${namespace}.`)) {\n            return toSyntheticResponse(hit.value.response);\n          }\n        }\n\n        const pending: PendingWrite = { promptKey, vector: query.vector };\n        context.state.set(pendingKey, pending);\n\n        return;\n      },\n      async after(context, response) {\n        const pending = context.state.get(pendingKey) as PendingWrite | undefined;\n\n        if (!pending) {\n          return;\n        }\n\n        // Mid-stream tool-call responses must not be cached — the\n        // useful answer comes from the trip *after* the tool returns.\n        // Crucially, leave the pending entry in place so a later trip\n        // (the one that actually finishes with `stop`) can read it\n        // and write the final response under the *original* trip-0\n        // prompt key. Deleting here would orphan the pending and the\n        // post-tool answer would never make it into the store.\n        if (response.finishReason === \"tool_calls\") {\n          return;\n        }\n\n        context.state.delete(pendingKey);\n\n        const entry: CachedEntry = { response, storedAt: Date.now() };\n\n        await store.set(keyFor(pending.promptKey), entry, {\n          vector: pending.vector,\n        });\n\n        return;\n      },\n    },\n  };\n}\n\nfunction toSyntheticResponse(response: ModelResponse): ModelResponse {\n  return {\n    content: response.content,\n    finishReason: response.finishReason,\n    usage: { input: 0, output: 0, total: 0 },\n    toolCalls: response.toolCalls,\n  };\n}\n","import type { AgentMiddleware } from \"../../contracts/middleware\";\n\n/**\n * Flatten one or more middleware sources into a single ordered\n * array suitable for `agent({ middleware: [...] })`.\n *\n * **Role.** As middleware catalogs grow, agent configs accumulate\n * long arrays that mix \"always-on\" stacks (cache + budget + guardrail)\n * with per-concern extras (per-tool rate-limits, audit hooks). A\n * single `compose` call lets callers keep those sources as named\n * variables and flatten at the registration site.\n *\n * **Semantics.** Registration order is preserved across sources —\n * `compose(a, b, c)` produces `[...a, ...b, ...c]`. Because the\n * pipeline's onion is strictly registration-ordered, the flattened\n * order is the execution order. No de-duplication, no sorting, no\n * priority logic — that would hide bugs, not fix them.\n *\n * **Accepts arrays OR individual middlewares.** Both forms are\n * common in callsite code; the helper flattens either.\n *\n * @example\n * const standardStack = [\n *   ai.middleware.semanticCache({ ... }),\n *   ai.middleware.budget({ maxTokens: 20_000 }),\n *   ai.middleware.guardrail({ ... }),\n * ];\n *\n * const toolRateLimits = [\n *   toolRateLimit({ tool: \"search_web\", maxCalls: 3 }),\n *   toolRateLimit({ tool: \"expensive_api\", maxCalls: 1 }),\n * ];\n *\n * const myAgent = ai.agent({\n *   model,\n *   middleware: ai.middleware.compose(standardStack, toolRateLimits, auditMiddleware),\n * });\n */\nexport function composeMiddleware(\n  ...sources: ReadonlyArray<AgentMiddleware | ReadonlyArray<AgentMiddleware>>\n): AgentMiddleware[] {\n  const out: AgentMiddleware[] = [];\n\n  for (const source of sources) {\n    if (Array.isArray(source)) {\n      out.push(...source);\n      continue;\n    }\n\n    out.push(source as AgentMiddleware);\n  }\n\n  return out;\n}\n","import type { AgentMiddleware } from \"../../contracts/middleware\";\n\n/**\n * Scope a middleware's `tool`-level hooks to only fire for a\n * specific tool name (or a set of names). `execute` and `trip`\n * hooks pass through unchanged.\n *\n * **Role.** Tool-specific concerns — \"rate-limit `search_web`\",\n * \"cache results for `fetch_faq`\" — are common. Rather than adding\n * a `middleware` field to `ai.tool()` (see decisions §27), the\n * framework keeps one contract (`AgentMiddleware`) and offers this\n * helper for the locality problem. The middleware body stays agnostic\n * of the tool name; `forTool` handles the filtering.\n *\n * **What gets filtered.** Only `tool.before` / `tool.after` /\n * `tool.onError`. Each hook is wrapped so that `ctx.tool.name`\n * must be in the allowed set or the wrapped hook is a no-op.\n * `execute` and `trip` hooks are NOT touched — they run normally.\n *\n * **Why not filter execute/trip too?** Because a middleware that\n * reaches across levels (a tool-specific budget that initializes a\n * counter in `execute.before` and checks it in `tool.before`) still\n * needs `execute.before` to fire unconditionally. Scoping all hooks\n * would break cross-level middleware; scoping only `tool` hooks\n * matches the mental model of \"this middleware cares about these\n * tools.\"\n *\n * **Single-name vs multi-name.** A string matches one tool; a string\n * array matches any of the listed tools. No wildcards, no regex —\n * keep it boring.\n *\n * @example\n * // Single tool\n * const scoped = ai.middleware.forTool(\n *   \"search_web\",\n *   toolRateLimit({ maxCalls: 3 }),\n * );\n *\n * @example\n * // Multiple tools sharing a rule\n * const scoped = ai.middleware.forTool(\n *   [\"paid_api\", \"expensive_db\"],\n *   toolRateLimit({ maxCalls: 5 }),\n * );\n *\n * ai.agent({\n *   model,\n *   tools: [webTool, paidApiTool, expensiveDbTool],\n *   middleware: [scoped],\n * });\n */\nexport function forTool(\n  toolNames: string | ReadonlyArray<string>,\n  middleware: AgentMiddleware,\n): AgentMiddleware {\n  const allowed = new Set(\n    typeof toolNames === \"string\" ? [toolNames] : toolNames,\n  );\n  const scope =\n    allowed.size === 1 ? Array.from(allowed)[0] : Array.from(allowed).join(\"+\");\n\n  if (!middleware.tool) {\n    return middleware;\n  }\n\n  const innerBefore = middleware.tool.before;\n  const innerAfter = middleware.tool.after;\n  const innerOnError = middleware.tool.onError;\n\n  return {\n    ...middleware,\n    name: `${middleware.name}[for:${scope}]`,\n    tool: {\n      before: innerBefore\n        ? async ctx => {\n            if (!allowed.has(ctx.tool.name)) {\n              return;\n            }\n\n            return innerBefore(ctx);\n          }\n        : undefined,\n      after: innerAfter\n        ? async (ctx, result) => {\n            if (!allowed.has(ctx.tool.name)) {\n              return;\n            }\n\n            return innerAfter(ctx, result);\n          }\n        : undefined,\n      onError: innerOnError\n        ? async (ctx, error) => {\n            if (!allowed.has(ctx.tool.name)) {\n              return;\n            }\n\n            return innerOnError(ctx, error);\n          }\n        : undefined,\n    },\n  };\n}\n","import type { Logger } from \"@warlock.js/logger\";\nimport type {\n  AgentMiddleware,\n  MiddlewareExecuteContext,\n  MiddlewareSupervisorContext,\n  MiddlewareToolContext,\n  MiddlewareTripContext,\n} from \"../contracts/middleware\";\n\nconst LOG_MODULE = \"ai.middleware\";\n\n/**\n * The four levels at which middleware can hook — mirrors\n * `AgentMiddleware`'s optional `execute` / `trip` / `tool` /\n * `supervisor` keys. Kept as a single named union so callers can pass\n * it around without inline-duplicating the literals. The first three\n * fire on the agent pipeline; `supervisor` fires once around a whole\n * `supervisor.execute()` run.\n */\nexport type MiddlewareLevel = \"execute\" | \"trip\" | \"tool\" | \"supervisor\";\n\n/**\n * Shape of the context object for each level. The pipeline is\n * level-parameterized on the ctx type via this mapping so callers\n * get compile-time narrowing when they instantiate `runPipeline`.\n */\nexport type MiddlewareContextByLevel = {\n  execute: MiddlewareExecuteContext;\n  trip: MiddlewareTripContext;\n  tool: MiddlewareToolContext;\n  supervisor: MiddlewareSupervisorContext;\n};\n\n/**\n * Run an inner async operation through a stack of agent middlewares\n * at a single level, applying the onion-model before/after/onError\n * semantics documented on `AgentMiddleware`.\n *\n * **Semantics.**\n * - `before` hooks run in registration order (top-down).\n *   Returning a defined value from a `before` hook short-circuits the\n *   pipeline with that value as the result, skipping `inner()` and\n *   all deeper `before` / `after` hooks — but outer middleware\n *   `after` hooks (registered earlier) still run on the synthetic\n *   value.\n * - `after` hooks run in reverse registration order (bottom-up).\n *   Returning a defined value replaces the result before it\n *   propagates further out. Returning `void` / `undefined` keeps the\n *   existing result.\n * - `onError` hooks also run in reverse (bottom-up) — any error\n *   thrown by `inner()`, by a `before` hook, or by an `after` hook\n *   unwinds through each frame's `onError` in turn. Returning a\n *   defined value from `onError` recovers: the error is cleared and\n *   the returned value becomes the new result (which then flows\n *   through outer `after` hooks). Returning `void` propagates the\n *   error to the next outer frame.\n *\n * **Implementation.** Built by folding the middleware array from the\n * end inward: each middleware produces a closure that wraps the\n * previous closure (the deeper pipeline). The outermost wrap is\n * middleware index 0 — so registration order matches onion order\n * without any reverse iteration at call time.\n *\n * **No magic.** The pipeline does not swallow, retry, or translate\n * errors. Hooks that throw propagate unchanged (subject to `onError`\n * recovery). Pipeline-level logging is debug-only and respects each\n * middleware's `log: false` kill-switch.\n *\n * @example\n * const response = await runPipeline(\n *   middlewares,\n *   \"trip\",\n *   tripContext,\n *   () => model.complete(messages, callOptions),\n *   logger,\n * );\n */\nexport async function runPipeline<Level extends MiddlewareLevel, TResult>(\n  middlewares: ReadonlyArray<AgentMiddleware>,\n  level: Level,\n  context: MiddlewareContextByLevel[Level],\n  inner: () => Promise<TResult>,\n  logger?: Logger,\n): Promise<TResult> {\n  if (middlewares.length === 0) {\n    return inner();\n  }\n\n  let next: () => Promise<TResult> = inner;\n\n  for (let index = middlewares.length - 1; index >= 0; index--) {\n    const middleware = middlewares[index];\n    const hooks = middleware[level];\n\n    if (!hooks) {\n      continue;\n    }\n\n    const previous = next;\n\n    next = async () => {\n      const logEnabled = middleware.log !== false && logger !== undefined;\n\n      if (hooks.before) {\n        if (logEnabled) {\n          logger!.debug(LOG_MODULE, `${level}.before`, middleware.name, {\n            middleware: middleware.name,\n            level,\n          });\n        }\n\n        const shortCircuit = await (\n          hooks.before as (ctx: unknown) => Promise<unknown> | unknown\n        )(context);\n\n        if (shortCircuit !== undefined) {\n          if (logEnabled) {\n            logger!.debug(\n              LOG_MODULE,\n              `${level}.short-circuit`,\n              middleware.name,\n              {\n                middleware: middleware.name,\n                level,\n              },\n            );\n          }\n\n          return shortCircuit as TResult;\n        }\n      }\n\n      let result: TResult;\n\n      try {\n        result = await previous();\n      } catch (thrown) {\n        if (!hooks.onError) {\n          throw thrown;\n        }\n\n        const recovered = await (\n          hooks.onError as (\n            ctx: unknown,\n            error: unknown,\n          ) => Promise<unknown> | unknown\n        )(context, thrown);\n\n        if (recovered === undefined) {\n          throw thrown;\n        }\n\n        if (logEnabled) {\n          logger!.debug(LOG_MODULE, `${level}.recovered`, middleware.name, {\n            middleware: middleware.name,\n            level,\n          });\n        }\n\n        result = recovered as TResult;\n      }\n\n      if (hooks.after) {\n        const replacement = await (\n          hooks.after as (\n            ctx: unknown,\n            value: unknown,\n          ) => Promise<unknown> | unknown\n        )(context, result);\n\n        if (replacement !== undefined) {\n          result = replacement as TResult;\n        }\n\n        if (logEnabled) {\n          logger!.debug(LOG_MODULE, `${level}.after`, middleware.name, {\n            middleware: middleware.name,\n            level,\n          });\n        }\n      }\n\n      return result;\n    };\n  }\n\n  return next();\n}\n","import type { StandardSchemaV1 } from \"@standard-schema/spec\";\nimport type { BaseReport } from \"../contracts/result/base-report.type\";\nimport type { Usage } from \"../contracts/result/usage.type\";\nimport type { ToolConfig, ToolContext } from \"../contracts/tool.contract\";\nimport { AIError, SchemaValidationError, ToolExecutionError } from \"../errors\";\nimport { generateRunId } from \"../utils/generate-run-id\";\n\n/**\n * Degraded `ToolContext` supplied when no caller threads one through\n * (`tool.invoke(input)` standalone, batch scripts, tests). Per\n * decisions §35 — mutations on the empty bag are harmless no-ops;\n * production paths under a supervisor receive a real ctx with the\n * iteration's shared bag.\n */\nfunction defaultToolContext(): ToolContext {\n  return { artifacts: {} };\n}\n\nconst EMPTY_USAGE: Usage = Object.freeze({ input: 0, output: 0, total: 0 });\n\n/**\n * Result returned by `ToolContract.invoke()`.\n *\n * **Canonical destructure:** `const { data, usage, report, error }` —\n * matches every other executable (`AgentResult`, `WorkflowResult`,\n * `SupervisorResult`) so parent agents can treat every tool dispatch\n * uniformly.\n *\n * **Shape.** `data` / `error` carry the outcome; `usage` and `report`\n * are always present. For leaf tools, `usage` is zero and `report`\n * is a framework-synthesized {@link BaseReport} (`type: \"tool\"`,\n * `children: []`, real timing) so parents never have to nil-check.\n * For composites wrapped via `asTool()`, `usage` and `report` mirror\n * the inner primitive's — the nested tree lives in `report.children`.\n *\n * @example\n * const result = await myTool.invoke({ city: \"Cairo\" });\n * if (result.error) console.error(result.error.message);\n * else console.log(result.data, result.report.duration);\n */\nexport type ToolInvokeResult<TOutput> = {\n  /** Successfully-returned output. Undefined if execution or validation failed. */\n  data?: TOutput;\n  /** Typed AI error produced by validation or execute(), if any. */\n  error?: AIError;\n  /** Rolled-up usage (zero for leaf tools, populated for composites). */\n  usage: Usage;\n  /** Recursive execution report — `report.children` carries nested executables. */\n  report: BaseReport;\n};\n\n/**\n * A `ToolConfig` augmented with a safe `invoke()` entry point for the agent runtime.\n *\n * @example\n * const wrapped: ToolContract<{ city: string }, { temp: number }> = tool(contract);\n * const result = await wrapped.invoke({ city: \"Cairo\" });\n */\nexport interface ToolContract<TInput = unknown, TOutput = unknown> extends ToolConfig<\n  TInput,\n  TOutput\n> {\n  /**\n   * Agent-runtime entry point. Validates raw input against the tool's schema,\n   * calls execute(), catches errors, and reports duration.\n   * Never throws — errors surface in the returned `error` field as\n   * typed `AIError` subclasses.\n   *\n   * The optional second argument is a `ToolContext` (Phase 5 /\n   * decisions §35) — when supplied, threaded into `execute(input, ctx)`\n   * so tools can write system-only side data into `ctx.artifacts`.\n   * Standalone callers may omit it; the framework supplies a\n   * degraded `{ artifacts: {} }` so single-arg legacy handlers keep\n   * working unchanged.\n   *\n   * @example\n   * const result = await myTool.invoke(rawLLMArgs);\n   * if (result.error) handleError(result.error);\n   */\n  invoke(rawInput: unknown, ctx?: ToolContext): Promise<ToolInvokeResult<TOutput>>;\n}\n\n/**\n * Wraps a raw `ToolConfig` and adds a safe `invoke()` method for the agent runtime.\n * The returned object preserves all original contract fields unchanged.\n *\n * Error categorization:\n * - Input schema rejects model args → `SchemaValidationError` (issues preserved).\n * - Schema's `validate()` itself throws → `SchemaValidationError` wrapping the cause.\n * - `execute()` throws → `ToolExecutionError` wrapping the cause.\n *\n * @example\n * const weatherTool = tool({\n *   name: \"getWeather\",\n *   description: \"Fetch current weather for a city\",\n *   input: z.object({ city: z.string() }),\n *   execute: async ({ city }) => ({ temp: 72 }),\n * });\n *\n * const result = await weatherTool.invoke({ city: \"Cairo\" });\n */\n/**\n * Internal factory for `asTool()` wrappers on composite primitives\n * (agent / workflow / supervisor). Unlike the public `tool()` factory\n * (which synthesizes a leaf `BaseReport` every time), this variant\n * lets the composite's own `ExecuteResult` flow through: the inner\n * primitive's `report` becomes the sole child of the outer tool-call\n * node, and the inner `usage` is surfaced so parents can roll it up.\n *\n * The caller supplies `execute()` returning `{ data, usage, report }`\n * from the composite's own `execute()` method. Validation failures\n * and thrown errors still produce a synthesized failed leaf report —\n * the inner-report propagation is strictly a success-path concern.\n *\n * Not exported from the package barrel — used by `agent.asTool()`,\n * `workflow.asTool()`, `supervisor.asTool()` only.\n */\nexport function compositeAsTool<TInput, TOutput>(contract: {\n  name: string;\n  description?: string;\n  version?: string;\n  meta?: ToolConfig[\"meta\"];\n  input: StandardSchemaV1<TInput>;\n  /** Runs the underlying composite and returns its full envelope. */\n  execute: (input: TInput) => Promise<{\n    data?: TOutput;\n    error?: AIError;\n    usage: Usage;\n    report: BaseReport;\n  }>;\n}): ToolContract<TInput, TOutput> {\n  // The underlying `ToolConfig<TInput, TOutput>.execute` is typed as\n  // `(input) => Promise<TOutput>`, but composite wrappers return an\n  // envelope object instead. Surface a contract-shaped view that\n  // extracts `.data` on demand for any code that still treats this\n  // like a plain tool.\n  const publicExecute = async (input: TInput): Promise<TOutput> => {\n    const envelope = await contract.execute(input);\n    if (envelope.error) throw envelope.error;\n    return envelope.data as TOutput;\n  };\n\n  return {\n    name: contract.name,\n    description: contract.description ?? `Composite tool \"${contract.name}\".`,\n    meta: contract.meta,\n    input: contract.input,\n    execute: publicExecute,\n\n    async invoke(rawInput: unknown, _ctx?: ToolContext): Promise<ToolInvokeResult<TOutput>> {\n      // Composite tools (asTool-wrapped agent/workflow/supervisor) do\n      // NOT relay the ctx into their inner execution — composites\n      // have their own state/scope; an inner supervisor gets a fresh\n      // artifacts bag. The parameter is accepted for signature parity\n      // with `tool()` so callers can use both interchangeably.\n      const startedAtDate = new Date();\n      const start = performance.now();\n      const runId = generateRunId(\"tool\");\n\n      const failLeaf = (error: AIError): ToolInvokeResult<TOutput> => {\n        const endedAt = new Date().toISOString();\n        const duration = performance.now() - start;\n        return {\n          error,\n          usage: EMPTY_USAGE,\n          report: {\n            runId,\n            rootRunId: runId,\n            name: contract.name,\n            version: contract.version,\n            type: \"tool\",\n            status: \"failed\",\n            startedAt: startedAtDate.toISOString(),\n            endedAt,\n            duration,\n            usage: EMPTY_USAGE,\n            children: [],\n          },\n        };\n      };\n\n      let validationResult: StandardSchemaV1.Result<TInput>;\n      try {\n        const schema = contract.input as StandardSchemaV1<TInput>;\n        validationResult = await schema[\"~standard\"].validate(rawInput);\n      } catch (thrown) {\n        const message = thrown instanceof Error ? thrown.message : String(thrown);\n        return failLeaf(\n          new SchemaValidationError(\n            `Schema validation threw for tool \"${contract.name}\": ${message}`,\n            { cause: thrown, context: { toolName: contract.name } },\n          ),\n        );\n      }\n\n      if (validationResult.issues) {\n        const summary = validationResult.issues.map((issue) => issue.message).join(\"; \");\n        return failLeaf(\n          new SchemaValidationError(`Validation failed: ${summary}`, {\n            issues: validationResult.issues,\n            context: { toolName: contract.name },\n          }),\n        );\n      }\n\n      try {\n        const composite = await contract.execute(validationResult.value);\n        // Surface the inner primitive's full envelope. The outer\n        // ToolInvokeResult carries the composite's usage and report\n        // verbatim; the agent runtime nests the report as a child of\n        // the tool-dispatch node it records.\n        return {\n          data: composite.data,\n          error: composite.error,\n          usage: composite.usage,\n          report: composite.report,\n        };\n      } catch (thrown) {\n        const message = thrown instanceof Error ? thrown.message : String(thrown);\n        return failLeaf(\n          new ToolExecutionError(message, {\n            cause: thrown,\n            toolName: contract.name,\n          }),\n        );\n      }\n    },\n  };\n}\n\nexport function tool<TInput, TOutput>(\n  contract: ToolConfig<TInput, TOutput>,\n): ToolContract<TInput, TOutput> {\n  return {\n    ...contract,\n\n    async invoke(rawInput: unknown, ctx?: ToolContext): Promise<ToolInvokeResult<TOutput>> {\n      const startedAtDate = new Date();\n      const start = performance.now();\n      const runId = generateRunId(\"tool\");\n      const handlerCtx = ctx ?? defaultToolContext();\n\n      const finish = (partial: { data?: TOutput; error?: AIError }): ToolInvokeResult<TOutput> => {\n        const endedAt = new Date().toISOString();\n        const duration = performance.now() - start;\n        const status: BaseReport[\"status\"] = partial.error ? \"failed\" : \"completed\";\n        const report: BaseReport = {\n          runId,\n          rootRunId: runId,\n          name: contract.name,\n          version: contract.version,\n          type: \"tool\",\n          status,\n          startedAt: startedAtDate.toISOString(),\n          endedAt,\n          duration,\n          usage: EMPTY_USAGE,\n          children: [],\n        };\n\n        return {\n          ...partial,\n          usage: EMPTY_USAGE,\n          report,\n        };\n      };\n\n      let validationResult: StandardSchemaV1.Result<TInput>;\n      if (contract.input) {\n        try {\n          validationResult = await contract.input[\"~standard\"].validate(rawInput);\n        } catch (thrown) {\n          const message = thrown instanceof Error ? thrown.message : String(thrown);\n\n          return finish({\n            error: new SchemaValidationError(\n              `Schema validation threw for tool \"${contract.name}\": ${message}`,\n              { cause: thrown, context: { toolName: contract.name } },\n            ),\n          });\n        }\n      } else {\n        // `input` is optional on ToolConfig — this is a no-argument tool\n        // (e.g. view_cart, checkout). With no schema there is nothing to\n        // validate, so pass the raw model args straight to execute()\n        // instead of dereferencing a missing schema's `~standard`.\n        validationResult = { value: rawInput as TInput };\n      }\n\n      if (validationResult.issues) {\n        const summary = validationResult.issues.map((issue) => issue.message).join(\"; \");\n\n        return finish({\n          error: new SchemaValidationError(`Validation failed: ${summary}`, {\n            issues: validationResult.issues,\n            context: { toolName: contract.name },\n          }),\n        });\n      }\n\n      try {\n        const output = await contract.execute(validationResult.value, handlerCtx);\n        return finish({ data: output });\n      } catch (thrown) {\n        const message = thrown instanceof Error ? thrown.message : String(thrown);\n\n        return finish({\n          error: new ToolExecutionError(message, {\n            cause: thrown,\n            toolName: contract.name,\n          }),\n        });\n      }\n    },\n  };\n}\n","import type { StandardSchemaV1 } from \"@standard-schema/spec\";\nimport type { BaseReport } from \"../contracts/result/base-report.type\";\nimport type { BaseResult } from \"../contracts/result/base-result.type\";\nimport type { Usage } from \"../contracts/result/usage.type\";\nimport { AgentExecutionError, type AIError } from \"../errors\";\nimport { compositeAsTool, type ToolContract } from \"./tool\";\n\n/**\n * Envelope every executable's `execute()` resolves to. Agent, workflow,\n * and supervisor results all satisfy this shape — `data` / `error`\n * carry the outcome while `usage` and `report` are always present —\n * which is exactly what {@link compositeAsTool} needs to nest the inner\n * run under the outer tool-call node.\n */\ntype ExecutableEnvelope<TOutput> = BaseResult & {\n  data?: TOutput;\n  error?: AIError;\n  report: BaseReport;\n};\n\n/**\n * Structural view of an executable primitive (agent / workflow /\n * supervisor) when it is dropped straight into an agent's `tools: []`\n * array WITHOUT being wrapped via `.asTool()` first.\n *\n * Only the fields the auto-adapt path reads are declared:\n * - `name` — becomes the LLM tool name (required; anonymous executables\n *   are rejected at author time, mirroring `.asTool()`).\n * - `description` — the \"when would the model pick this?\" line.\n * - `inputSchema` — opt-in Standard Schema typing the tool's arguments.\n *   Surfaced on `WorkflowInstance` / `SupervisorContract` from the new\n *   optional `inputSchema` config field. Absent for agents (which take\n *   a plain string prompt).\n * - `execute` — the dispatch entry every `ExecutableContract` exposes.\n *\n * `invoke` is declared `never` so a `ToolContract` (which HAS `invoke`)\n * can never be mistaken for an executable by the {@link isExecutableTool}\n * guard.\n */\nexport type ExecutableTool<TInput = unknown, TOutput = unknown> = {\n  readonly name: string;\n  readonly description?: string;\n  readonly inputSchema?: StandardSchemaV1<TInput>;\n  execute(input: TInput, options?: unknown): Promise<ExecutableEnvelope<TOutput>>;\n  invoke?: never;\n};\n\n/**\n * Entry accepted in an agent's `tools: []` array — either an already-\n * built `ToolContract` (the `.asTool()` / `ai.tool()` path) or a raw\n * executable primitive the framework auto-adapts on the caller's\n * behalf.\n */\nexport type AgentToolEntry<TInput = unknown, TOutput = unknown> =\n  | ToolContract<TInput, TOutput>\n  | ExecutableTool<TInput, TOutput>;\n\n/**\n * Identity passthrough schema used when an executable is registered as\n * a tool without declaring an `inputSchema`. The model's raw arguments\n * flow straight to `execute()` unchanged — the executable validates\n * internally (workflows via their steps, supervisors/agents via their\n * own input handling).\n */\nfunction passthroughSchema<TInput>(): StandardSchemaV1<TInput> {\n  return {\n    \"~standard\": {\n      version: 1,\n      vendor: \"warlock-ai\",\n      validate: (value: unknown) => ({ value: value as TInput }),\n    },\n  };\n}\n\n/**\n * Type guard distinguishing a raw executable primitive from a built\n * `ToolContract`. An executable exposes `execute()` and no `invoke()`;\n * a `ToolContract` exposes `invoke()`. The `invoke` check is the\n * load-bearing discriminator — `.asTool()`-wrapped composites keep\n * their own `execute` too, so checking `execute` alone is insufficient.\n */\nexport function isExecutableTool(entry: unknown): entry is ExecutableTool {\n  if (!entry || typeof entry !== \"object\") {\n    return false;\n  }\n\n  const candidate = entry as { execute?: unknown; invoke?: unknown };\n\n  return typeof candidate.execute === \"function\" && typeof candidate.invoke !== \"function\";\n}\n\n/**\n * Adapt a raw executable primitive (agent / workflow / supervisor) into\n * a `ToolContract` so an agent can dispatch it inside its tool-call\n * loop WITHOUT the caller writing `.asTool()`. Derives the LLM tool\n * manifest from the executable's own `name` + `description` +\n * (optional) `inputSchema`, then dispatches through the executable's\n * `execute()` — the inner report nests under the outer tool-call node\n * exactly like an explicit `.asTool()` wrapper.\n *\n * Throws `AgentExecutionError` at author time when the executable lacks\n * a usable `name` — the agent's tool surface needs a stable id, the\n * same constraint `.asTool()` enforces.\n */\nexport function executableToTool<TInput, TOutput>(\n  executable: ExecutableTool<TInput, TOutput>,\n): ToolContract<TInput, TOutput> {\n  if (!executable.name || typeof executable.name !== \"string\") {\n    throw new AgentExecutionError(\n      \"tools[]: an executable (agent/workflow/supervisor) used as a tool must have a `name`\",\n      { context: { authoring: true } },\n    );\n  }\n\n  return compositeAsTool<TInput, TOutput>({\n    name: executable.name,\n    description: executable.description ?? `Invoke \"${executable.name}\" as a tool.`,\n    input: executable.inputSchema ?? passthroughSchema<TInput>(),\n    execute: async (input) => {\n      const result = await executable.execute(input);\n\n      if (result.error) {\n        // Surface the inner typed error so the surrounding\n        // `compositeAsTool` wrapper produces a `ToolExecutionError`\n        // with `cause` pointing back at the original subclass — the\n        // agent's tool-call loop sees one uniform error class\n        // regardless of which primitive failed.\n        throw result.error;\n      }\n\n      return {\n        data: result.data as TOutput,\n        usage: result.usage as Usage,\n        report: result.report,\n      };\n    },\n  });\n}\n\n/**\n * Normalize an agent's `tools: []` array into a uniform\n * `ToolContract[]` for the runtime. Already-built `ToolContract`s\n * (`.asTool()` / `ai.tool()`) pass through untouched; raw executable\n * primitives are auto-adapted via {@link executableToTool}.\n *\n * Returns `undefined` when no tools were supplied so the agent's\n * existing `config.tools ?? []` fallbacks stay byte-identical.\n */\nexport function normalizeAgentTools(\n  tools: ReadonlyArray<AgentToolEntry> | undefined,\n): ToolContract<unknown, unknown>[] | undefined {\n  if (!tools) {\n    return undefined;\n  }\n\n  return tools.map((entry) => {\n    if (isExecutableTool(entry)) {\n      return executableToTool(entry) as ToolContract<unknown, unknown>;\n    }\n\n    return entry as ToolContract<unknown, unknown>;\n  });\n}\n","import type { StandardSchemaV1 } from \"@standard-schema/spec\";\nimport type { AgentExecuteOptions } from \"../contracts/agent/agent-options.type\";\nimport type { Attachment } from \"../contracts/attachment.type\";\nimport type { ContentPart } from \"../contracts/content-part.type\";\nimport type { Message } from \"../contracts/conversation-message.type\";\nimport type { Placeholders } from \"../contracts/placeholders.type\";\nimport { InvalidRequestError } from \"../errors\";\nimport { extractJsonSchema, prepareAttachmentPart } from \"../utils\";\nimport type { AgentConfig } from \"./agent-config.type\";\n\n/**\n * Outcome of `buildAgentInputMessages` — the seeded message list and\n * the JSON Schema cached for every trip's\n * `ModelCallOptions.responseSchema`. `responseSchema` is `undefined`\n * when the caller didn't ask for structured output.\n */\nexport type AgentInputBuildResult = {\n  messages: Message[];\n  responseSchema?: Record<string, unknown>;\n};\n\n/**\n * Assemble the seed conversation for an agent execution. Runs exactly\n * once per run — subsequent trips append to the same message list.\n *\n * Responsibilities (previously three methods on `Execution`):\n * 1. Merge factory + per-call placeholders.\n * 2. Resolve the system prompt (string, contract, or absent).\n * 3. When an output schema is supplied:\n *    - cache its JSON Schema form for `ModelCallOptions.responseSchema`\n *      so native-structured-output providers enforce it at the token\n *      level;\n *    - fall back to a soft system-prompt instruction for providers\n *      that don't advertise `structuredOutput` capability.\n * 4. Append caller-supplied `history` (e.g. session-level prior turns).\n * 5. Shape the user message — plain string in the common case,\n *    multipart `ContentPart[]` when `attachments` are present. Image\n *    attachments require model vision capability; mismatch throws\n *    `InvalidRequestError` here rather than failing opaquely at the\n *    provider.\n *\n * Extracted from the `Execution` class to isolate the declarative\n * input-shaping phase from the stateful trip loop.\n */\nexport async function buildAgentInputMessages<TOutput>(params: {\n  config: AgentConfig<TOutput>;\n  input: string;\n  options?: AgentExecuteOptions<TOutput>;\n}): Promise<AgentInputBuildResult> {\n  const { config, input, options } = params;\n\n  const placeholders: Placeholders = {\n    ...config.placeholders,\n    ...options?.placeholders,\n  };\n\n  const systemPrompt = options?.systemPrompt ?? config.systemPrompt;\n  let systemContent = \"\";\n\n  if (typeof systemPrompt === \"string\") {\n    systemContent = systemPrompt;\n  } else if (systemPrompt) {\n    systemContent = systemPrompt.resolve(placeholders);\n  }\n\n  const { responseSchema, instruction } = resolveStructuredOutput({\n    outputSchema: options?.output ?? config.output,\n    overrideResponseSchema: options?.responseSchema,\n    modelSupportsStructuredOutput: Boolean(config.model.capabilities?.structuredOutput),\n  });\n\n  if (instruction) {\n    systemContent = systemContent ? `${systemContent}\\n\\n${instruction}` : instruction;\n  }\n\n  const messages: Message[] = [];\n\n  if (systemContent) {\n    messages.push({ role: \"system\", content: systemContent });\n  }\n\n  if (options?.history) {\n    messages.push(...options.history);\n  }\n\n  const userContent = await buildUserMessageContent({\n    input,\n    attachments: options?.attachments,\n    modelName: config.model.name,\n    modelSupportsVision: Boolean(config.model.capabilities?.vision),\n  });\n\n  messages.push({ role: \"user\", content: userContent });\n\n  return { messages, responseSchema };\n}\n\n/**\n * Build the user message `content` field. Plain string when no\n * attachments (the hot path) — keeps wire payloads small. Multipart\n * `ContentPart[]` when attachments exist: input text first, resolved\n * parts in declaration order.\n */\nasync function buildUserMessageContent(params: {\n  input: string;\n  attachments?: Attachment[];\n  modelName: string;\n  modelSupportsVision: boolean;\n}): Promise<string | ContentPart[]> {\n  const { input, attachments, modelName, modelSupportsVision } = params;\n\n  if (!attachments || attachments.length === 0) {\n    return input;\n  }\n\n  const parts: ContentPart[] = await Promise.all(\n    attachments.map((attachment) => prepareAttachmentPart(attachment)),\n  );\n\n  const hasImage = parts.some((part) => part.type === \"image\");\n\n  if (hasImage && !modelSupportsVision) {\n    throw new InvalidRequestError(\n      `Model \"${modelName}\" does not declare vision capability — image attachments are not supported`,\n      { context: { modelName } },\n    );\n  }\n\n  return [{ type: \"text\", text: input }, ...parts];\n}\n\n/**\n * When the caller supplied an `output` schema, resolve two artifacts:\n *\n * - `responseSchema` — extracted JSON Schema to attach on every trip.\n *   Adapters that natively support structured output (OpenAI's\n *   `response_format: json_schema`) consume it; others ignore it.\n * - `instruction` — a soft fallback appended to the system prompt\n *   **only** for models without native structured-output capability.\n *   Capable adapters skip it to save tokens and avoid redundancy.\n */\nfunction resolveStructuredOutput(params: {\n  outputSchema?: StandardSchemaV1<unknown>;\n  overrideResponseSchema?: Record<string, unknown>;\n  modelSupportsStructuredOutput: boolean;\n}): {\n  responseSchema?: Record<string, unknown>;\n  instruction?: string;\n} {\n  const { outputSchema, overrideResponseSchema, modelSupportsStructuredOutput } = params;\n\n  if (!outputSchema) {\n    return {};\n  }\n\n  const responseSchema = overrideResponseSchema ?? extractJsonSchema(outputSchema);\n\n  if (modelSupportsStructuredOutput) {\n    return { responseSchema };\n  }\n\n  const schemaHint = responseSchema\n    ? `\\n\\nThe response MUST match this JSON Schema:\\n${JSON.stringify(responseSchema, null, 2)}`\n    : \"\";\n\n  const instruction = [\n    \"You MUST respond with a single valid JSON value only.\",\n    \"Do not wrap it in markdown code fences. Do not include prose, commentary, or explanation — JSON only.\",\n    schemaHint,\n  ]\n    .join(\"\")\n    .trim();\n\n  return { responseSchema, instruction };\n}\n","import type { Logger } from \"@warlock.js/logger\";\nimport type { AgentEventMap } from \"../contracts/events/event-map.type\";\nimport type { LLMTrip } from \"../contracts/result/llm-trip.type\";\nimport type { ToolCall } from \"../contracts/result/tool-call.type\";\nimport type { Usage } from \"../contracts/result/usage.type\";\n\n/**\n * Aggregate snapshot the agent-level log entries need at emission time\n * (agent completion + model name + running totals). Passed instead of\n * storing a back-reference to the Execution class — keeps this helper\n * a pure function.\n */\nexport type AgentLogContext = {\n  /** Dotted logger module, e.g. `\"ai.agent.my-writer\"`. */\n  module: string;\n  /** Maximum trips configured for this run — logged once on `agent.starting`. */\n  maxTrips: number;\n  /** Model identifier — logged once on `agent.starting`. */\n  modelName: string;\n  /** Final running usage totals at the moment `agent.completed` fires. */\n  totalUsage: Usage;\n  /** Monotonic duration (ms) since start at the moment `agent.completed` fires. */\n  totalDurationMs: number;\n  /** All trips recorded so far — logged count on `agent.completed`. */\n  trips: LLMTrip[];\n  /** All tool calls recorded so far — logged count on `agent.completed`. */\n  toolCalls: ToolCall[];\n};\n\n/**\n * Structured logging for agent lifecycle events. Mirrors\n * `Execution.emit`'s call sites without touching class state — the\n * caller passes the ambient snapshot in `ctx`, we route each event to\n * the right logger level and enrich with the per-event forensic\n * detail.\n *\n * Log-level convention:\n * - `info` — lifecycle boundaries (agent starting / completed) users\n *   want to see at default verbosity\n * - `debug` — per-trip + per-tool progress (hot-path, opt-in)\n * - `success` — trip completion + tool success (terminal per-step state)\n * - `warn` — tool failures (recoverable, agent loop continues)\n * - `error` — agent-level terminal errors\n *\n * Streaming deltas (`agent.trip.streaming`) are intentionally skipped\n * to avoid token-granularity log spam.\n */\nexport function logAgentEvent<K extends keyof AgentEventMap>(\n  logger: Logger,\n  ctx: AgentLogContext,\n  event: K,\n  payload: AgentEventMap[K],\n): void {\n  const action = event.replace(/^agent\\./, \"\");\n\n  switch (event) {\n    case \"agent.starting\": {\n      const { input } = payload as AgentEventMap[\"agent.starting\"];\n      logger.info(ctx.module, action, \"agent starting\", {\n        maxTrips: ctx.maxTrips,\n        model: ctx.modelName,\n        inputLength: input.length,\n      });\n      return;\n    }\n\n    case \"agent.trip.started\": {\n      const { tripIndex } = payload as AgentEventMap[\"agent.trip.started\"];\n      logger.debug(ctx.module, action, \"trip started\", { tripIndex });\n      return;\n    }\n\n    case \"agent.trip.streaming\": {\n      // Deltas are too high-volume to log at token granularity.\n      // Skipped on purpose; debug level still fires on trip boundaries.\n      return;\n    }\n\n    case \"agent.trip.completed\": {\n      const { trip } = payload as AgentEventMap[\"agent.trip.completed\"];\n      logger.success(ctx.module, action, \"trip completed\", {\n        tripIndex: trip.index,\n        duration: trip.duration,\n        usage: trip.usage,\n        finishReason: trip.finishReason,\n      });\n      return;\n    }\n\n    case \"agent.tool.calling\": {\n      const { tool, tripIndex } =\n        payload as AgentEventMap[\"agent.tool.calling\"];\n      logger.debug(ctx.module, action, `calling tool \"${tool.name}\"`, {\n        tool: tool.name,\n        action: tool.action,\n        tripIndex,\n      });\n      return;\n    }\n\n    case \"agent.tool.called\": {\n      const toolCall = payload as AgentEventMap[\"agent.tool.called\"];\n      logger.success(ctx.module, action, `tool \"${toolCall.name}\" finished`, {\n        tool: toolCall.name,\n        duration: toolCall.duration,\n        tripIndex: toolCall.tripIndex,\n      });\n      return;\n    }\n\n    case \"agent.tool.failed\": {\n      const { tool, error, tripIndex } =\n        payload as AgentEventMap[\"agent.tool.failed\"];\n\n      logger.warn(ctx.module, action, `tool \"${tool.name}\" failed`, {\n        tool: tool.name,\n        tripIndex,\n        error: {\n          code: error.code,\n          message: error.message,\n          name: error.name,\n          stack: error.stack,\n        },\n      });\n      return;\n    }\n\n    case \"agent.completed\": {\n      logger.info(ctx.module, action, \"agent completed\", {\n        duration: ctx.totalDurationMs,\n        usage: ctx.totalUsage,\n        trips: ctx.trips.length,\n        tools: ctx.toolCalls.length,\n      });\n      return;\n    }\n\n    case \"agent.error\": {\n      const { error } = payload as AgentEventMap[\"agent.error\"];\n      logger.error(ctx.module, action, error.message, {\n        code: error.code,\n        context: error.context,\n      });\n      return;\n    }\n  }\n}\n","import type { StreamContract, StreamEvent } from \"../contracts\";\n\n/**\n * Internal async-queue `StreamContract` used by `agent().stream()`.\n *\n * **Role.** The bridge between a streaming `Execution` (which runs in the\n * background, pushing events as they happen) and a consumer that reads\n * those events with `for await` or an `on(...)` handler map.\n *\n * **Responsibility.**\n * - Owns: the event queue, the pending-read promise chain, the terminal\n *   `result` promise, and any user-registered event handlers.\n * - Does NOT own: any knowledge of agents, models, or tool calls — it is a\n *   generic producer/consumer pipe parameterized by `TResult`. The streaming\n *   execution writes via `push()` / `end()` / `fail()`; the consumer reads\n *   via the AsyncIterable surface.\n *\n * Events are coalesced into a queue so that a consumer that starts\n * iterating late still sees every event in order — nothing is dropped. The\n * `on()` handlers fire the moment an event is pushed, independent of\n * whether anyone is iterating.\n *\n * @example\n * // Inside agent.stream():\n * const { controller, stream } = createAgentStream<AgentResult<TOutput>>();\n * new Execution(config, input, options, controller).run();\n * return stream;\n *\n * // Consumer:\n * for await (const event of stream) {\n *   if (event.type === \"streaming\") process.stdout.write(event.delta);\n * }\n * const result = await stream.result;\n */\nexport type StreamController<TResult> = {\n  push(event: StreamEvent): void;\n  end(result: TResult): void;\n  fail(error: Error): void;\n};\n\ntype PendingRead = {\n  resolve(value: IteratorResult<StreamEvent>): void;\n  reject(error: Error): void;\n};\n\nexport function createAgentStream<TResult>(): {\n  controller: StreamController<TResult>;\n  stream: StreamContract<TResult>;\n} {\n  const queue: StreamEvent[] = [];\n  const pending: PendingRead[] = [];\n  const handlers = new Map<StreamEvent[\"type\"], (event: StreamEvent) => void>();\n\n  let closed = false;\n  let failure: Error | undefined;\n  let resolveResult!: (value: TResult) => void;\n  let rejectResult!: (error: Error) => void;\n\n  const result = new Promise<TResult>((resolve, reject) => {\n    resolveResult = resolve;\n    rejectResult = reject;\n  });\n\n  const controller: StreamController<TResult> = {\n    push(event) {\n      const handler = handlers.get(event.type);\n\n      if (handler) {\n        try {\n          handler(event);\n        } catch {\n          // User-provided stream handlers must never crash the agent.\n          // Swallow — structured logging attaches here in Phase 0.5.\n        }\n      }\n\n      const reader = pending.shift();\n\n      if (reader) {\n        reader.resolve({ value: event, done: false });\n        return;\n      }\n\n      queue.push(event);\n    },\n\n    end(finalResult) {\n      closed = true;\n      resolveResult(finalResult);\n\n      while (pending.length > 0) {\n        const reader = pending.shift();\n\n        reader?.resolve({ value: undefined, done: true });\n      }\n    },\n\n    fail(error) {\n      closed = true;\n      failure = error;\n      rejectResult(error);\n\n      while (pending.length > 0) {\n        const reader = pending.shift();\n\n        reader?.reject(error);\n      }\n    },\n  };\n\n  const iterator: AsyncIterator<StreamEvent> = {\n    next() {\n      if (queue.length > 0) {\n        return Promise.resolve({ value: queue.shift()!, done: false });\n      }\n\n      if (closed) {\n        if (failure) {\n          return Promise.reject(failure);\n        }\n\n        return Promise.resolve({ value: undefined, done: true });\n      }\n\n      return new Promise<IteratorResult<StreamEvent>>((resolve, reject) => {\n        pending.push({ resolve, reject });\n      });\n    },\n  };\n\n  const stream: StreamContract<TResult> = {\n    result,\n    on(handlerMap) {\n      for (const [key, handler] of Object.entries(handlerMap)) {\n        if (handler) {\n          handlers.set(\n            key as StreamEvent[\"type\"],\n            handler as (event: StreamEvent) => void,\n          );\n        }\n      }\n\n      return stream;\n    },\n    [Symbol.asyncIterator]() {\n      return iterator;\n    },\n  };\n\n  return { controller, stream };\n}\n","import type { AgentEventMap } from \"../contracts/events/event-map.type\";\nimport type { StreamEventBody } from \"../contracts/stream/stream-event.type\";\n\n/**\n * Map an internal `AgentEventMap` entry into the public `StreamEvent`\n * shape. Event names are the same dot-notation strings on both sides;\n * only the payload shape needs per-event translation — the notable\n * case is `agent.tool.called`, whose event-map payload is a bare\n * `ToolCall` but whose stream wrapper is `{ toolCall }`.\n *\n * Extracted from the `Execution` class in `agent.ts` because it's\n * fully stateless (pure function of event name + payload) and used\n * only from the stream-forwarding path. Keeps the class focused on\n * stateful orchestration.\n */\nexport function agentEventToStreamEvent<K extends keyof AgentEventMap>(\n  event: K,\n  payload: AgentEventMap[K],\n): StreamEventBody | undefined {\n  switch (event) {\n    case \"agent.starting\": {\n      const { input } = payload as AgentEventMap[\"agent.starting\"];\n      return { type: \"agent.starting\", input };\n    }\n\n    case \"agent.trip.started\": {\n      const { tripIndex, input } =\n        payload as AgentEventMap[\"agent.trip.started\"];\n      return { type: \"agent.trip.started\", tripIndex, input };\n    }\n\n    case \"agent.trip.streaming\": {\n      const { delta, tripIndex } =\n        payload as AgentEventMap[\"agent.trip.streaming\"];\n      return { type: \"agent.trip.streaming\", delta, tripIndex };\n    }\n\n    case \"agent.tool.calling\": {\n      const { tool, input, tripIndex } =\n        payload as AgentEventMap[\"agent.tool.calling\"];\n      return { type: \"agent.tool.calling\", tool, input, tripIndex };\n    }\n\n    case \"agent.tool.called\": {\n      const called = payload as AgentEventMap[\"agent.tool.called\"];\n      // Split off the agent's enriched ToolCall record from the tool meta\n      // so the stream event surface mirrors the bus payload shape.\n      const { tool, ...toolCall } = called;\n      return { type: \"agent.tool.called\", toolCall, tool };\n    }\n\n    case \"agent.tool.failed\": {\n      const { tool, error, tripIndex } =\n        payload as AgentEventMap[\"agent.tool.failed\"];\n      return { type: \"agent.tool.failed\", tool, error, tripIndex };\n    }\n\n    case \"agent.trip.completed\": {\n      const { trip } = payload as AgentEventMap[\"agent.trip.completed\"];\n      return { type: \"agent.trip.completed\", trip };\n    }\n\n    case \"agent.completed\": {\n      return { type: \"agent.completed\" };\n    }\n\n    case \"agent.error\": {\n      const { error } = payload as AgentEventMap[\"agent.error\"];\n      return { type: \"agent.error\", error };\n    }\n\n    default: {\n      return undefined;\n    }\n  }\n}\n","import type { StandardSchemaV1 } from \"@standard-schema/spec\";\nimport type { ModelToolCallRequest } from \"../contracts/model-tool-call-request.type\";\nimport type { ToolContract } from \"../tool/tool\";\n\n/**\n * Default cap on bytes accumulated in a single suspect buffer before\n * the guard gives up, flushes as text, and resets to pass-through.\n * Real envelope payloads observed in production leaks are well under\n * 1 KB; this is a safety valve against runaway / adversarial input.\n */\nconst DEFAULT_MAX_BUFFER_BYTES = 4096;\n\n/**\n * Fence opener the guard recognizes in pass-through mode. Targets the\n * lowercase form ```` ```json ```` only — that is the form models\n * actually emit in the wild when they fence-wrap a JSON tool envelope.\n * Other languages / casings flush as plain text.\n */\nconst FENCE_OPENER = \"```json\";\n\n/**\n * Closing fence sequence inside `bufferingFence` mode. Three backticks,\n * no language tag.\n */\nconst FENCE_CLOSER = \"```\";\n\n/**\n * Options passed when constructing a `JsonStreamGuard`.\n *\n * The guard is deliberately framework-agnostic of *how* deltas are\n * emitted or how recovered calls are dispatched — callers wire those\n * via `onSafeDelta` / `onRecoveredCall`. This keeps the unit-testable\n * surface tiny and lets the agent loop own all event-emission policy.\n */\nexport type JsonStreamGuardOptions = {\n  /** Tools the agent has registered for this trip. Envelope lookups use `.name`. */\n  tools: ReadonlyArray<ToolContract<unknown, unknown>>;\n  /**\n   * Hard cap on a single suspect buffer's size. When exceeded, the\n   * buffer is flushed verbatim as text and the guard returns to\n   * pass-through. Defaults to {@link DEFAULT_MAX_BUFFER_BYTES}.\n   */\n  maxBufferBytes?: number;\n  /**\n   * Called for every chunk of text that survived the guard — exactly\n   * what the consumer should treat as the visible delta. May be\n   * called many times per `feed()` call, possibly with a single\n   * character or with a multi-character flush.\n   */\n  onSafeDelta: (delta: string) => void;\n  /**\n   * Called once per envelope the guard successfully classifies as a\n   * tool-call recovery. The request carries `recoveredFrom:\n   * \"stream-text\"` so downstream consumers can distinguish synthesized\n   * calls from real ones.\n   */\n  onRecoveredCall: (request: ModelToolCallRequest) => void;\n};\n\n/**\n * Per-trip state machine that intercepts streamed text deltas, detects\n * JSON envelopes the model has emitted as plain text (the\n * tool-call-leakage symptom), and synthesizes real `ModelToolCallRequest`\n * entries for them while suppressing the JSON from visible output.\n *\n * **Role.** A `JsonStreamGuard` is the per-trip implementation of the\n * opt-in `streamingToolGuard` config. It sits between the model\n * adapter's `delta` chunks and the agent's `agent.trip.streaming`\n * emit + `content` accumulator — text that survives the guard is what\n * the consumer sees and what the trip records as `output`.\n *\n * **Responsibility.**\n * - Owns: a small character-level state machine (pass-through,\n *   brace-buffering, fence-buffering), string-literal-aware brace\n *   tracking, fence-opener / fence-closer detection, named-envelope\n *   matching against registered tool schemas, buffer-cap enforcement.\n * - Does NOT own: event emission (delegated via callbacks), tool\n *   dispatch, `finishReason` normalization, dedupe vs. real tool\n *   calls — the agent loop handles all four.\n *\n * **Matcher tier — named envelope only (v1).** A buffer matches when\n * it parses as a JSON object containing both:\n *   - a `name` or `tool` key resolving to a registered tool name, AND\n *   - an `arguments` or `input` key whose value validates against the\n *     resolved tool's `~standard` schema.\n * Bare-object matching (where any registered tool's schema is the\n * sole signal) is deferred until tool input schemas are tight enough\n * to distinguish — `v.record(v.any())` would match everything.\n *\n * **Per-trip lifecycle.** One instance per trip. The agent loop calls\n * `feed(chunk)` for every `delta` chunk and `finalize()` exactly once\n * after the stream's `done` chunk. Mid-stream cancellation: the loop\n * simply stops calling `feed`; any open buffer is discarded with the\n * guard instance.\n *\n * Modeled as a class (see §4.2 of code-style.md — per-call execution\n * state across phases): the machine has 3 states, accumulators for\n * brace depth, string-literal escape tracking, and a synthesized-call\n * counter for stable ids across the trip.\n *\n * @example\n * // Inside the agent's streaming trip body:\n * const guard = new JsonStreamGuard({\n *   tools: this.config.tools ?? [],\n *   maxBufferBytes: guardConfig.maxBufferBytes,\n *   onSafeDelta: (delta) => {\n *     content += delta;\n *     this.emit(\"agent.trip.streaming\", { delta, tripIndex });\n *   },\n *   onRecoveredCall: (request) => recoveredCalls.push(request),\n * });\n *\n * for await (const chunk of model.stream(messages, callOptions)) {\n *   if (chunk.type === \"delta\") await guard.feed(chunk.content);\n *   // ... other chunk types\n * }\n *\n * await guard.finalize();\n */\nexport class JsonStreamGuard {\n  private readonly tools: ReadonlyArray<ToolContract<unknown, unknown>>;\n  private readonly maxBufferBytes: number;\n  private readonly onSafeDelta: (delta: string) => void;\n  private readonly onRecoveredCall: (request: ModelToolCallRequest) => void;\n\n  private mode: \"passThrough\" | \"bufferingBrace\" | \"bufferingFence\" = \"passThrough\";\n\n  /**\n   * Characters held back in pass-through mode while we resolve whether\n   * a partial fence opener (`` ` ``, `` `` ``, `` ``` ``, `` ```j ``, …)\n   * will complete or break. Always a strict prefix of {@link FENCE_OPENER};\n   * emptied (and emitted verbatim) the moment a non-matching character\n   * arrives.\n   */\n  private holdback = \"\";\n\n  /**\n   * Accumulator while `mode === \"bufferingBrace\"` or `\"bufferingFence\"`.\n   * In brace mode it carries the JSON including the outermost `{`/`}`.\n   * In fence mode it carries everything between the opener and the\n   * closer (the opener and closer themselves are NOT in the buffer —\n   * they are reconstructed only on a flush-as-text fallback).\n   */\n  private buffer = \"\";\n\n  /**\n   * Brace-depth counter for `bufferingBrace` mode. Increments on `{`,\n   * decrements on `}` — but only when {@link inString} is false, so a\n   * `{` inside a JSON string literal does not skew the depth. Buffer\n   * closes when depth returns to zero.\n   */\n  private braceDepth = 0;\n\n  /** True while the scanner is inside a `\"...\"` JSON string literal. */\n  private inString = false;\n\n  /**\n   * True when the previous character inside a string literal was a\n   * backslash, so the current character is escaped (`\\\"` does not end\n   * the string; `\\\\` resets the flag without escaping anything else).\n   */\n  private escapeNext = false;\n\n  /**\n   * Trailing tail of the fence buffer used to detect the closing\n   * ```` ``` ```` sequence. Length capped at the closer length; rotated\n   * forward as new characters arrive.\n   */\n  private fenceCloseTail = \"\";\n\n  /**\n   * Count of envelopes the guard has successfully synthesized this\n   * trip. Used to assign deterministic, collision-free ids on\n   * recovered `ModelToolCallRequest` entries.\n   */\n  private recoveredCount = 0;\n\n  public constructor(options: JsonStreamGuardOptions) {\n    this.tools = options.tools;\n    this.maxBufferBytes = options.maxBufferBytes ?? DEFAULT_MAX_BUFFER_BYTES;\n    this.onSafeDelta = options.onSafeDelta;\n    this.onRecoveredCall = options.onRecoveredCall;\n  }\n\n  /**\n   * Feed the next raw delta from the model. Splits the chunk into\n   * characters and runs each through the state machine, awaiting\n   * envelope classification whenever a buffer closes mid-chunk.\n   *\n   * The hot path (pass-through prose with no `{` / `` ` ``) is fully\n   * synchronous — `await` here only blocks at buffer-close points,\n   * which are rare in normal traffic.\n   */\n  public async feed(chunk: string): Promise<void> {\n    for (let i = 0; i < chunk.length; i++) {\n      await this.processChar(chunk[i]);\n    }\n  }\n\n  /**\n   * Stream ended. Anything still in the holdback was prose\n   * misclassified as a partial fence opener — emit it. Anything still\n   * in an open buffer never closed — emit it as text too (a leak\n   * truncated mid-flight is still text the user partially saw).\n   */\n  public async finalize(): Promise<void> {\n    if (this.holdback.length > 0) {\n      this.onSafeDelta(this.holdback);\n      this.holdback = \"\";\n    }\n\n    if (this.mode === \"bufferingBrace\") {\n      this.flushBraceBufferAsText();\n      return;\n    }\n\n    if (this.mode === \"bufferingFence\") {\n      this.flushFenceBufferAsText();\n    }\n  }\n\n  /**\n   * True when at least one envelope was recovered this trip. The\n   * agent loop reads this to override `finishReason` from `\"stop\"` to\n   * `\"tool_calls\"` when the model reported a natural stop but the\n   * guard found tool calls hiding in the text channel.\n   */\n  public hasRecoveredCalls(): boolean {\n    return this.recoveredCount > 0;\n  }\n\n  /**\n   * Route a single character based on the current mode. The\n   * `passThrough` branch handles holdback expansion / flushing\n   * iteratively (no recursion) so a character that \"breaks\" a fence\n   * opener can be re-evaluated as a fresh pass-through input in the\n   * same call.\n   */\n  private async processChar(char: string): Promise<void> {\n    if (this.mode === \"bufferingBrace\") {\n      await this.processBraceChar(char);\n      return;\n    }\n\n    if (this.mode === \"bufferingFence\") {\n      await this.processFenceChar(char);\n      return;\n    }\n\n    let current = char;\n\n    while (true) {\n      if (this.holdback.length === 0 && current === \"{\") {\n        this.openBraceBuffer(current);\n        return;\n      }\n\n      const extended = this.holdback + current;\n\n      if (this.isFenceOpenerPrefix(extended)) {\n        this.holdback = extended;\n\n        if (extended === FENCE_OPENER) {\n          this.openFenceBuffer();\n        }\n\n        return;\n      }\n\n      if (this.holdback.length === 0) {\n        this.onSafeDelta(current);\n        return;\n      }\n\n      this.onSafeDelta(this.holdback);\n      this.holdback = \"\";\n    }\n  }\n\n  /**\n   * Recognize any strict prefix of {@link FENCE_OPENER} including the\n   * full string. Used to decide whether to keep extending the holdback\n   * or flush it as plain text.\n   */\n  private isFenceOpenerPrefix(candidate: string): boolean {\n    return candidate.length <= FENCE_OPENER.length && FENCE_OPENER.startsWith(candidate);\n  }\n\n  /**\n   * Enter `bufferingBrace` mode with the seed `{` as the first buffer\n   * character and the initial brace depth set to one. Any holdback at\n   * this point was already a non-fence sequence so it stays empty.\n   */\n  private openBraceBuffer(seed: string): void {\n    this.mode = \"bufferingBrace\";\n    this.buffer = seed;\n    this.braceDepth = 1;\n    this.inString = false;\n    this.escapeNext = false;\n  }\n\n  /**\n   * Enter `bufferingFence` mode immediately after the opener\n   * ```` ```json ```` matched in the holdback. Holdback resets;\n   * subsequent characters accumulate into the buffer until the\n   * closing fence is seen.\n   */\n  private openFenceBuffer(): void {\n    this.mode = \"bufferingFence\";\n    this.buffer = \"\";\n    this.fenceCloseTail = \"\";\n    this.holdback = \"\";\n  }\n\n  /**\n   * Process one character while accumulating a brace-delimited JSON\n   * object. Tracks string-literal context so `{` / `}` inside `\"...\"`\n   * do not skew brace depth. Closes (and classifies) on balanced\n   * braces; flushes-as-text on cap overflow.\n   */\n  private async processBraceChar(char: string): Promise<void> {\n    this.buffer += char;\n\n    if (this.inString) {\n      if (this.escapeNext) {\n        this.escapeNext = false;\n        return;\n      }\n\n      if (char === \"\\\\\") {\n        this.escapeNext = true;\n        return;\n      }\n\n      if (char === '\"') {\n        this.inString = false;\n      }\n\n      this.guardBufferCap(\"brace\");\n      return;\n    }\n\n    if (char === '\"') {\n      this.inString = true;\n      this.guardBufferCap(\"brace\");\n      return;\n    }\n\n    if (char === \"{\") {\n      this.braceDepth++;\n      this.guardBufferCap(\"brace\");\n      return;\n    }\n\n    if (char === \"}\") {\n      this.braceDepth--;\n\n      if (this.braceDepth === 0) {\n        await this.closeBraceBuffer();\n        return;\n      }\n\n      this.guardBufferCap(\"brace\");\n      return;\n    }\n\n    this.guardBufferCap(\"brace\");\n  }\n\n  /**\n   * Process one character while accumulating a fence-delimited JSON\n   * block. The closing fence ```` ``` ```` ends the block; the closing\n   * characters are NOT included in the classified buffer (they are\n   * re-emitted only when the block flushes back to text).\n   */\n  private async processFenceChar(char: string): Promise<void> {\n    this.fenceCloseTail += char;\n\n    if (this.fenceCloseTail.length > FENCE_CLOSER.length) {\n      this.fenceCloseTail = this.fenceCloseTail.slice(-FENCE_CLOSER.length);\n    }\n\n    if (this.fenceCloseTail === FENCE_CLOSER) {\n      const innerLength = this.buffer.length - (FENCE_CLOSER.length - 1);\n      this.buffer = this.buffer.slice(0, Math.max(0, innerLength));\n\n      await this.closeFenceBuffer();\n      return;\n    }\n\n    this.buffer += char;\n    this.guardBufferCap(\"fence\");\n  }\n\n  /**\n   * Enforce the buffer-byte cap. When the current buffer exceeds the\n   * cap, flush it back to the consumer as plain text and reset to\n   * pass-through. Acts as a runaway / adversarial-input safety valve.\n   */\n  private guardBufferCap(source: \"brace\" | \"fence\"): void {\n    if (this.buffer.length <= this.maxBufferBytes) {\n      return;\n    }\n\n    if (source === \"brace\") {\n      this.flushBraceBufferAsText();\n      return;\n    }\n\n    this.flushFenceBufferAsText();\n  }\n\n  /**\n   * Run the envelope matcher against the closed brace buffer. On a\n   * match, synthesize a recovered `ModelToolCallRequest`; on no\n   * match, flush the buffer back as plain text. Resets state to\n   * pass-through either way.\n   */\n  private async closeBraceBuffer(): Promise<void> {\n    const closed = this.buffer;\n\n    this.resetToPassThrough();\n\n    const matched = await this.tryMatchEnvelope(closed);\n\n    if (matched) {\n      return;\n    }\n\n    this.onSafeDelta(closed);\n  }\n\n  /**\n   * Run the envelope matcher against the closed fence buffer. On a\n   * match, synthesize a recovered call; on no match, flush as text\n   * **with** the original opener and closer reconstructed so the\n   * customer sees exactly the markdown the model emitted.\n   */\n  private async closeFenceBuffer(): Promise<void> {\n    const closed = this.buffer;\n\n    this.resetToPassThrough();\n\n    const matched = await this.tryMatchEnvelope(closed);\n\n    if (matched) {\n      return;\n    }\n\n    this.onSafeDelta(`${FENCE_OPENER}${closed}${FENCE_CLOSER}`);\n  }\n\n  /**\n   * Emit the brace-buffer verbatim as text and reset to pass-through.\n   * Used on cap overflow and on `finalize()` for an unclosed buffer.\n   */\n  private flushBraceBufferAsText(): void {\n    const closed = this.buffer;\n    this.resetToPassThrough();\n    this.onSafeDelta(closed);\n  }\n\n  /**\n   * Emit the fence-buffer verbatim as text, reconstructing the\n   * opener and closer so the original markdown structure is\n   * preserved for the consumer.\n   */\n  private flushFenceBufferAsText(): void {\n    const closed = this.buffer;\n    this.resetToPassThrough();\n    this.onSafeDelta(`${FENCE_OPENER}${closed}`);\n  }\n\n  /**\n   * Reset all per-buffer state back to the pass-through baseline.\n   * Called whenever a buffer closes — by recovery, by flush, or by\n   * cap overflow — so the next character starts a fresh scan.\n   */\n  private resetToPassThrough(): void {\n    this.mode = \"passThrough\";\n    this.buffer = \"\";\n    this.braceDepth = 0;\n    this.inString = false;\n    this.escapeNext = false;\n    this.fenceCloseTail = \"\";\n  }\n\n  /**\n   * Attempt to classify a closed buffer as a tool-call envelope. On\n   * success, invoke `onRecoveredCall` with a synthesized request and\n   * return `true`; on failure return `false` so the caller can flush\n   * the buffer back as text.\n   */\n  private async tryMatchEnvelope(raw: string): Promise<boolean> {\n    const parsed = safeParseJson(raw);\n\n    if (parsed === undefined || typeof parsed !== \"object\" || parsed === null) {\n      return false;\n    }\n\n    const envelope = parsed as Record<string, unknown>;\n    const candidateName = readString(envelope, \"name\") ?? readString(envelope, \"tool\");\n    const candidateInput = readObject(envelope, \"arguments\") ?? readObject(envelope, \"input\");\n\n    if (!candidateName || !candidateInput) {\n      return false;\n    }\n\n    const tool = this.tools.find((entry) => entry.name === candidateName);\n\n    if (!tool || !tool.input) {\n      return false;\n    }\n\n    const schema = tool.input as StandardSchemaV1<unknown>;\n\n    let validationResult: StandardSchemaV1.Result<unknown>;\n\n    try {\n      validationResult = await schema[\"~standard\"].validate(candidateInput);\n    } catch {\n      return false;\n    }\n\n    if (validationResult.issues) {\n      return false;\n    }\n\n    this.recoveredCount++;\n\n    this.onRecoveredCall({\n      id: `synth_${candidateName}_${this.recoveredCount}`,\n      name: candidateName,\n      input: validationResult.value,\n      recoveredFrom: \"stream-text\",\n    });\n\n    return true;\n  }\n}\n\n/**\n * Parse a JSON string returning `undefined` on any failure. Local to\n * the guard so it can distinguish \"not JSON\" from a parsed `null`\n * value, which `safeJsonParse` cannot — a parsed `null` is a valid\n * JSON value but not a valid envelope, and we want the difference.\n */\nfunction safeParseJson(raw: string): unknown {\n  try {\n    return JSON.parse(raw);\n  } catch {\n    return undefined;\n  }\n}\n\n/**\n * Read a string-typed field from an envelope candidate. Returns\n * `undefined` when the key is missing or the value is non-string —\n * the matcher rejects either case.\n */\nfunction readString(envelope: Record<string, unknown>, key: string): string | undefined {\n  const value = envelope[key];\n\n  return typeof value === \"string\" && value.length > 0 ? value : undefined;\n}\n\n/**\n * Read an object-typed field from an envelope candidate. Returns\n * `undefined` when the key is missing or the value is not a\n * plain object (rejects arrays, primitives, null) — tool input\n * schemas always validate against an object root.\n */\nfunction readObject(\n  envelope: Record<string, unknown>,\n  key: string,\n): Record<string, unknown> | undefined {\n  const value = envelope[key];\n\n  if (value === null || typeof value !== \"object\" || Array.isArray(value)) {\n    return undefined;\n  }\n\n  return value as Record<string, unknown>;\n}\n","import type { StandardSchemaV1 } from \"@standard-schema/spec\";\nimport { log, type Logger } from \"@warlock.js/logger\";\nimport type {\n  AgentContract,\n  AgentEventHandler,\n  AgentEventMap,\n  AgentExecuteOptions,\n  AgentResult,\n  BaseReport,\n  CompleteEvent,\n  FinishReason,\n  LLMTrip,\n  Message,\n  MiddlewareExecuteContext,\n  MiddlewareState,\n  MiddlewareToolContext,\n  MiddlewareTripContext,\n  ModelResponse,\n  ModelToolCallRequest,\n  StreamContract,\n  StreamEventBody,\n  StreamingToolGuardConfig,\n  ToolCall,\n  ToolEventMeta,\n  Usage,\n  UsageEvent,\n  WithoutIdentity,\n} from \"../contracts\";\nimport {\n  AgentCancelledError,\n  AgentExecutionError,\n  AgentMaxTripsError,\n  AIError,\n  SchemaValidationError,\n} from \"../errors\";\nimport type { AgentContract as AgentContractType } from \"../contracts/agent/agent.contract\";\nimport type { EvalOptions, EvalReport } from \"../contracts/agent/eval.type\";\nimport { runEval } from \"../eval/eval-runner\";\nimport { runPipeline } from \"../middleware\";\nimport { normalizeAgentTools } from \"../tool/executable-as-tool\";\nimport type { ToolContract, ToolInvokeResult } from \"../tool/tool\";\nimport {\n  accumulateCost,\n  computeCost,\n  extractJsonPayload,\n  generateRunId,\n  safeJsonParse,\n  stampReportLineage,\n} from \"../utils\";\nimport type { AgentConfig } from \"./agent-config.type\";\nimport { buildAgentInputMessages } from \"./agent-input-builder\";\nimport { logAgentEvent } from \"./agent-log-event\";\nimport { createAgentStream, type StreamController } from \"./agent-stream\";\nimport { agentEventToStreamEvent } from \"./agent-to-stream-event\";\nimport { JsonStreamGuard } from \"./json-stream-guard\";\n\nconst LOG_MODULE = \"ai.agent\";\n\n/**\n * Internal post-normalization view of an `AgentConfig`. The public\n * `tools` field accepts both built `ToolContract`s and raw executables\n * (`AgentToolEntry[]`); by the time the runtime sees the config every\n * entry has been adapted to a `ToolContract`, so `Execution` works\n * against this narrowed shape and never has to re-discriminate.\n */\ntype ResolvedAgentConfig<TOutput> = Omit<AgentConfig<TOutput>, \"tools\"> & {\n  tools?: ToolContract<unknown, unknown>[];\n};\n\n/**\n * Detect abort-flavored errors surfaced by SDK HTTP layers — the\n * DOM `AbortError`, axios `ERR_CANCELED`, node-fetch's own\n * `AbortError`. Used to classify them as cancellation rather than\n * generic agent-execution failures.\n */\nfunction isAbortLike(err: unknown): boolean {\n  if (!err || typeof err !== \"object\") return false;\n\n  const e = err as { name?: unknown; code?: unknown };\n\n  return e.name === \"AbortError\" || e.code === \"ERR_CANCELED\" || e.code === \"ABORT_ERR\";\n}\n\n/**\n * Readable synthetic name for agents constructed without an explicit\n * `name`. Format: `anon_<provider>_<model>[_<tool1>+<tool2>+...]` —\n * deterministic (same config → same name across restarts) and\n * human-readable in logs / workflow snapshots.\n *\n * Keeps drift detection honest for the `ai.agent({ model })`\n * one-liner without punishing it with a hashed id nobody can read.\n */\nfunction synthesizeAgentName<T>(config: AgentConfig<T>): string {\n  const provider = (config.model as unknown as { provider?: string })?.provider ?? \"unknown\";\n  const model = config.model?.name ?? \"unknown\";\n  const tools = (config.tools ?? [])\n    .map((tool) => tool.name)\n    .sort()\n    .join(\"+\");\n\n  const base = `anon_${sanitize(provider)}_${sanitize(model)}`;\n  return tools ? `${base}_${sanitize(tools, { keepPlus: true })}` : base;\n}\n\nfunction sanitize(value: string, opts: { keepPlus?: boolean } = {}): string {\n  const allowed = opts.keepPlus ? /[^a-zA-Z0-9._+-]/g : /[^a-zA-Z0-9._-]/g;\n  return value.replace(allowed, \"-\");\n}\n\n/**\n * Authoring-time check on the middleware array. Throws an\n * `AgentExecutionError` with `context: { authoring: true }` the\n * moment an invalid entry is found — the agent factory surface is\n * where config bugs should surface, not ten trips into a run.\n *\n * Validates:\n * - Every entry is a non-null object with a non-empty string `name`.\n * - No two entries share the same `name` (would silently collide on\n *   `ctx.state` keys and produce impossible-to-debug behavior).\n *\n * Does NOT validate that hook maps contain callable functions —\n * that would catch late-binding bugs but also reject legitimate\n * patterns like `before` being conditionally `undefined`. Runtime\n * dispatch handles missing hooks safely.\n */\nfunction validateMiddleware(middleware: ReadonlyArray<unknown> | undefined): void {\n  if (!middleware || middleware.length === 0) {\n    return;\n  }\n\n  const seen = new Set<string>();\n\n  for (let index = 0; index < middleware.length; index++) {\n    const entry = middleware[index];\n\n    if (!entry || typeof entry !== \"object\") {\n      throw new AgentExecutionError(\n        `middleware[${index}] must be an object; received ${entry === null ? \"null\" : typeof entry}`,\n        { context: { authoring: true, index } },\n      );\n    }\n\n    const name = (entry as { name?: unknown }).name;\n\n    if (typeof name !== \"string\" || name.length === 0) {\n      throw new AgentExecutionError(`middleware[${index}] must have a non-empty string \"name\"`, {\n        context: { authoring: true, index },\n      });\n    }\n\n    if (seen.has(name)) {\n      throw new AgentExecutionError(\n        `duplicate middleware name \"${name}\" — each middleware needs a unique name so ctx.state keys do not collide`,\n        { context: { authoring: true, index, name } },\n      );\n    }\n\n    seen.add(name);\n  }\n}\n\n/**\n * Creates an executable AI agent from the given configuration.\n *\n * The agent runs a bounded trip loop: each trip calls the model, dispatches\n * any requested tool calls, then loops until the model stops or `maxTrips`\n * is reached. Each `execute()` / `stream()` call spawns a fresh internal\n * `Execution` instance — the factory itself holds no state across calls.\n *\n * `execute()` never throws — any error is attached to the returned result\n * under `result.error`. `stream()` surfaces errors both on the terminal\n * `error` stream event and via the `stream.result` promise.\n *\n * @example\n * const myAgent = agent({\n *   model: openai.model({ name: \"gpt-4o\" }),\n *   systemPrompt: \"You are a helpful assistant.\",\n *   tools: [searchTool],\n * });\n *\n * const result = await myAgent.execute(\"What is the capital of Egypt?\");\n *\n * @example\n * const stream = myAgent.stream(\"Write a haiku about Cairo.\");\n *\n * for await (const event of stream) {\n *   if (event.type === \"streaming\") process.stdout.write(event.delta);\n * }\n *\n * const result = await stream.result;\n */\nexport function agent<TOutput = unknown>(config: AgentConfig<TOutput>): AgentContract<TOutput> {\n  // Authoring-time validation of the middleware array. Rejects two\n  // classes of bug that would otherwise surface as opaque failures\n  // mid-execution: (a) entries that aren't proper middleware\n  // objects (null, undefined, missing `name`), and (b) two\n  // middlewares sharing the same `name`, which would silently\n  // collide on `ctx.state` keys. Fail fast, fail loud — per the\n  // authoring-time rules in `domains/ai/conventions/errors.md`.\n  validateMiddleware(config.middleware);\n\n  // Resolve the agent's identity. Explicit `name` wins; otherwise we\n  // synthesize a DETERMINISTIC fingerprint from the config's\n  // identity-defining fields (model + provider + tool names). Same\n  // config across process restarts produces the same synthetic name,\n  // so workflow signature drift detection stays honest for agents\n  // composed into workflows without explicit names.\n  const isAnonymous = !config.name || typeof config.name !== \"string\";\n\n  // Auto-adapt any raw executable (agent/workflow/supervisor) dropped\n  // into `tools: []` into a `ToolContract` before the name is\n  // synthesized — `synthesizeAgentName` reads `config.tools[].name`,\n  // so the fingerprint must see the normalized entries. Built\n  // `ToolContract`s (from `.asTool()` / `ai.tool()`) pass through\n  // untouched, so this is a no-op for the existing surface.\n  const tools = normalizeAgentTools(config.tools);\n  const name = isAnonymous\n    ? synthesizeAgentName({ ...config, tools })\n    : (config.name as string);\n  const resolvedConfig: ResolvedAgentConfig<TOutput> = { ...config, name, tools };\n\n  // Instance-level handlers registered via `.on()`. Stored here\n  // (factory-scope) so every `execute()` / `stream()` call on this\n  // agent sees the same set. Each event name gets its own Set so\n  // `off()` can remove a specific handler without disturbing others.\n  const instanceHandlers = new Map<\n    keyof AgentEventMap,\n    Set<AgentEventHandler<keyof AgentEventMap>>\n  >();\n\n  function on<K extends keyof AgentEventMap>(event: K, handler: AgentEventHandler<K>): () => void {\n    const existing = instanceHandlers.get(event);\n    const bucket = existing ?? new Set<AgentEventHandler<keyof AgentEventMap>>();\n\n    if (!existing) {\n      instanceHandlers.set(event, bucket);\n    }\n\n    bucket.add(handler as AgentEventHandler<keyof AgentEventMap>);\n\n    return () => off(event, handler);\n  }\n\n  function off<K extends keyof AgentEventMap>(event: K, handler: AgentEventHandler<K>): void {\n    const bucket = instanceHandlers.get(event);\n\n    if (!bucket) {\n      return;\n    }\n\n    bucket.delete(handler as AgentEventHandler<keyof AgentEventMap>);\n\n    if (bucket.size === 0) {\n      instanceHandlers.delete(event);\n    }\n  }\n\n  const agentContract: AgentContractType<TOutput> = {\n    name,\n    isAnonymous,\n    description: config.description,\n    async execute(\n      input: string,\n      options?: AgentExecuteOptions<TOutput>,\n    ): Promise<AgentResult<TOutput>> {\n      return new Execution<TOutput>(\n        resolvedConfig,\n        input,\n        options,\n        undefined,\n        instanceHandlers,\n      ).run();\n    },\n\n    stream(\n      input: string,\n      options?: AgentExecuteOptions<TOutput>,\n    ): StreamContract<AgentResult<TOutput>> {\n      const { controller, stream } = createAgentStream<AgentResult<TOutput>>();\n\n      const execution = new Execution<TOutput>(\n        resolvedConfig,\n        input,\n        options,\n        controller,\n        instanceHandlers,\n      );\n\n      void execution.run();\n\n      return stream;\n    },\n\n    on,\n    off,\n\n    eval<TEval = TOutput>(options: EvalOptions<TEval>): Promise<EvalReport<TEval>> {\n      return runEval<TEval>(agentContract as unknown as AgentContract<TEval>, options);\n    },\n  };\n\n  return agentContract;\n}\n\n/**\n * Name → handler-set map shared between the `agent()` factory and its\n * per-call `Execution`. Each `.on()` registration mutates this map;\n * every `Execution` reads from the same reference so additions and\n * removals take effect mid-flight.\n */\ntype InstanceHandlerMap = Map<keyof AgentEventMap, Set<AgentEventHandler<keyof AgentEventMap>>>;\n\n/**\n * Per-call driver that owns the full lifecycle of a single\n * `agent.execute()` or `agent.stream()` invocation.\n *\n * **Role.** An `Execution` is the short-lived state container and phase\n * orchestrator for one agent run. The public `agent()` factory stays purely\n * functional — all mutable bookkeeping (trips, tool calls, usage totals,\n * message history, terminal error, parsed output) lives here so each call\n * gets a fresh, isolated instance.\n *\n * **Responsibility.**\n * - Owns: building the initial message list, driving the bounded trip loop,\n *   dispatching tool calls safely, parsing the final output against the\n *   caller's schema, emitting lifecycle events (to both the user handler\n *   and, in stream mode, the `StreamController`), and producing the\n *   `AgentResult`.\n * - Does NOT own: how the model produces responses (delegated to\n *   `ModelContract.complete` / `ModelContract.stream`), how tools execute\n *   (delegated to `ToolContract.invoke`), the async-queue plumbing for\n *   streaming (delegated to `createAgentStream`), or any cross-call state\n *   (factory-level concerns live in `agent()`).\n *\n * Streaming mode is opt-in via the fourth constructor argument: pass a\n * `StreamController` and every event is mirrored into it while model calls\n * are driven via `model.stream()` instead of `model.complete()`. The public\n * contract of `execute()` says it never throws — `Execution` enforces that\n * by funneling every unexpected error into `this.error` and returning a\n * well-formed result regardless of what went wrong.\n *\n * Not exported — consumers interact only with the `agent()` factory (see\n * §4.2 of code-style.md — \"per-call execution state across phases\").\n *\n * @example\n * // Non-streaming — inside agent.execute():\n * const result = await new Execution(config, input, options).run();\n *\n * @example\n * // Streaming — inside agent.stream():\n * const { controller, stream } = createAgentStream();\n * void new Execution(config, input, options, controller).run();\n * return stream;\n */\nclass Execution<TOutput> {\n  private readonly trips: LLMTrip[] = [];\n  private readonly toolCalls: ToolCall[] = [];\n  private readonly usage: Usage = { input: 0, output: 0, total: 0 };\n  private readonly messages: Message[] = [];\n  private readonly maxTrips: number;\n  private readonly startedAt = new Date();\n  private readonly start = performance.now();\n  private readonly runId = generateRunId(\"agent\");\n  private readonly logger: Logger = log;\n  private readonly middleware: ReadonlyArray<\n    NonNullable<AgentConfig<TOutput>[\"middleware\"]>[number]\n  >;\n  private readonly middlewareState: MiddlewareState = new Map();\n\n  private error?: AIError;\n  private data?: TOutput;\n  private responseSchema?: Record<string, unknown>;\n\n  public constructor(\n    private readonly config: ResolvedAgentConfig<TOutput>,\n    private readonly input: string,\n    private readonly options?: AgentExecuteOptions<TOutput>,\n    private readonly streamController?: StreamController<AgentResult<TOutput>>,\n    private readonly instanceHandlers?: InstanceHandlerMap,\n  ) {\n    this.maxTrips = config.maxTrips ?? 10;\n    this.middleware = config.middleware ?? [];\n  }\n\n  /**\n   * Base middleware context shared by every level. `state` is the\n   * single mutable bag threaded through `execute`, `trip`, and `tool`\n   * hooks for the lifetime of this execution — fresh per `execute()`\n   * call, never reused across runs.\n   */\n  private buildExecuteContext(): MiddlewareExecuteContext {\n    return {\n      agent: {\n        name: this.config.name ?? this.config.model.name,\n        isAnonymous: !this.config.name,\n      },\n      model: {\n        name: this.config.model.name,\n        provider: this.config.model.provider,\n      },\n      input: this.input,\n      options: this.options as AgentExecuteOptions<unknown> | undefined,\n      state: this.middlewareState,\n      signal: this.options?.signal,\n    };\n  }\n\n  /**\n   * Entry point for a single agent execution. Wraps the real work\n   * (`runCore`) in the `execute`-level middleware pipeline, then\n   * emits the terminal `agent.completed` / `agent.error` events and\n   * closes the stream (if any) with the post-pipeline result — so\n   * middleware that short-circuits or transforms the final result\n   * still produces a well-formed public outcome.\n   *\n   * Must never throw: any error that escapes the pipeline is\n   * converted into an `AgentResult` with `error` populated before\n   * returning, preserving the `agent.execute()` public contract.\n   */\n  public async run(): Promise<AgentResult<TOutput>> {\n    const context = this.buildExecuteContext();\n\n    let result: AgentResult<TOutput>;\n\n    try {\n      result = (await runPipeline(\n        this.middleware,\n        \"execute\",\n        context,\n        () => this.runCore(),\n        this.logger,\n      )) as AgentResult<TOutput>;\n    } catch (thrown) {\n      this.error = this.toAIError(thrown);\n      result = this.buildResult();\n    }\n\n    if (result.error) {\n      this.emit(\"agent.error\", { error: result.error });\n    }\n\n    this.emit(\"agent.completed\", { result });\n\n    // Fire the `onComplete` hook with a flat payload (runId +\n    // durationMs pre-extracted) for audit-log consumers. Awaited but\n    // errors swallowed so consumer bugs cannot crash the agent or\n    // interfere with the result returned to the caller.\n    await this.fireCompleteHook(result);\n\n    this.streamController?.end(result);\n\n    return result;\n  }\n\n  /**\n   * Inner body wrapped by the `execute`-level pipeline. Drives the\n   * full lifecycle — build messages → emit starting → run trip loop\n   * → parse output → build result. Catches any unexpected throw and\n   * funnels it into `this.error` so the returned result is always\n   * well-formed; `execute`-level `after` hooks receive the result,\n   * with `error` populated when things went wrong.\n   */\n  private async runCore(): Promise<AgentResult<TOutput>> {\n    try {\n      await this.buildInitialMessages();\n\n      this.emit(\"agent.starting\", { input: this.input });\n\n      await this.runTripLoop();\n\n      const parseOutcome = await this.parseOutput();\n\n      if (parseOutcome === \"failed\" && this.options?.repair) {\n        await this.runRepairLoop();\n      }\n    } catch (thrown) {\n      this.error = this.toAIError(thrown);\n    }\n\n    return this.buildResult();\n  }\n\n  /**\n   * Resolve the system prompt (string or `SystemPromptContract`), merge\n   * placeholders from config + execute options, inject a structured-output\n   * instruction when the caller wants typed output but the model can't\n   * enforce it natively, prepend any conversation history, and append the\n   * user input. Produces the initial `messages` array the first trip sends\n   * to the model. Runs exactly once per execution.\n   */\n  private async buildInitialMessages(): Promise<void> {\n    const { messages, responseSchema } = await buildAgentInputMessages({\n      config: this.config,\n      input: this.input,\n      options: this.options,\n    });\n    this.messages.push(...messages);\n    this.responseSchema = responseSchema;\n  }\n\n  /**\n   * Drive sequential trips up to `maxTrips`. Each trip may stop the loop\n   * naturally (model returned a non-tool-call finish), abort it (model\n   * threw), or continue it (model requested tools). When the loop exits\n   * after the cap without a natural stop, records a \"Max trips exceeded\"\n   * error so the caller can distinguish runaway tool loops from a real result.\n   */\n  private async runTripLoop(): Promise<void> {\n    for (let tripIndex = 0; tripIndex < this.maxTrips; tripIndex++) {\n      if (this.options?.signal?.aborted) {\n        this.error = this.makeCancelledError();\n        return;\n      }\n\n      const tripInput = tripIndex === 0 ? this.input : \"[tool results]\";\n      const outcome = await this.runTrip(tripIndex, tripInput);\n\n      if (outcome === \"error\" || outcome === \"stop\") {\n        return;\n      }\n    }\n\n    const lastTrip = this.trips[this.trips.length - 1];\n\n    if (lastTrip?.finishReason === \"tool_calls\") {\n      this.error = new AgentMaxTripsError(\"Max trips exceeded\", {\n        maxTrips: this.maxTrips,\n      });\n    }\n  }\n\n  /**\n   * Execute one round-trip to the model. Aggregates usage into the running\n   * total, dispatches any requested tool calls, appends the assistant +\n   * tool-result messages for the next trip, and records an `LLMTrip`.\n   * Returns an outcome that tells `runTripLoop` whether to continue, stop,\n   * or abort.\n   */\n  private async runTrip(\n    tripIndex: number,\n    tripInput: string,\n  ): Promise<\"continue\" | \"stop\" | \"error\"> {\n    this.emit(\"agent.trip.started\", { tripIndex, input: tripInput });\n\n    const tripStartedAt = new Date();\n    const tripStart = performance.now();\n\n    let response: ModelResponse;\n\n    try {\n      response = await this.runTripThroughPipeline(tripIndex);\n    } catch (thrown) {\n      this.error = this.toAIError(thrown);\n\n      const failedTrip: LLMTrip = {\n        index: tripIndex,\n        input: tripInput,\n        output: \"\",\n        finishReason: \"error\",\n        startedAt: tripStartedAt.toISOString(),\n        endedAt: new Date().toISOString(),\n        duration: performance.now() - tripStart,\n        usage: { input: 0, output: 0, total: 0 },\n        error: this.error,\n      };\n\n      this.trips.push(failedTrip);\n\n      this.emit(\"agent.trip.completed\", { trip: failedTrip });\n      this.emit(\"agent.error\", { error: this.error });\n\n      return \"error\";\n    }\n\n    // Attach per-trip cost breakdown using the model's pricing table\n    // (when configured). Done at the framework boundary so stored trip\n    // records carry historical cost — Panoptic and other archive\n    // consumers never re-derive against today's pricing, and the\n    // input/output/cached split stays queryable without joining to a\n    // pricing table at all.\n    if (response.usage.cost === undefined) {\n      response.usage.cost = computeCost(response.usage, this.config.model.pricing);\n    }\n\n    this.usage.input += response.usage.input;\n    this.usage.output += response.usage.output;\n    this.usage.total += response.usage.total;\n    if (response.usage.cachedTokens !== undefined) {\n      this.usage.cachedTokens = (this.usage.cachedTokens ?? 0) + response.usage.cachedTokens;\n    }\n    this.usage.cost = accumulateCost(this.usage.cost, response.usage.cost);\n\n    // Fire the `onUsage` hook with a flat, pre-packaged payload so\n    // cost-ledger code receives stable identity (runId, model+provider)\n    // without joining from elsewhere. Awaited but errors swallowed.\n    await this.fireUsageHook(tripIndex, response.usage);\n\n    const isToolCallTrip =\n      response.finishReason === \"tool_calls\" &&\n      response.toolCalls !== undefined &&\n      response.toolCalls.length > 0;\n\n    const tripToolCalls: ToolCall[] = [];\n\n    if (isToolCallTrip) {\n      this.messages.push({\n        role: \"assistant\",\n        content: response.content,\n        toolCalls: response.toolCalls,\n      });\n\n      for (const toolCallRequest of response.toolCalls!) {\n        const record = await this.dispatchToolCall(toolCallRequest, tripIndex);\n\n        tripToolCalls.push(record);\n      }\n    }\n\n    const trip: LLMTrip = {\n      index: tripIndex,\n      input: tripInput,\n      output: response.content,\n      finishReason: response.finishReason,\n      startedAt: tripStartedAt.toISOString(),\n      endedAt: new Date().toISOString(),\n      duration: performance.now() - tripStart,\n      usage: response.usage,\n      toolCalls: tripToolCalls.length > 0 ? tripToolCalls : undefined,\n    };\n\n    this.trips.push(trip);\n\n    this.emit(\"agent.trip.completed\", { trip });\n\n    if (!isToolCallTrip) {\n      return \"stop\";\n    }\n\n    // Terminate the trip loop when EVERY tool call this trip is\n    // `mode: \"silent\"`. Silent tools don't feed their result back\n    // to the model — the prose the model streamed alongside the\n    // tool call IS the final reply. The \"all\" rule is load-bearing:\n    // if any feedback tool was called too, its result still needs\n    // to round-trip, so we must continue.\n    //\n    // Composite (`asTool`-wrapped) tools never set `mode: \"silent\"`\n    // in v1 — silent-composite mechanics are deferred per plan\n    // 2026-05-07-silent-tools.md (Q4). They behave as feedback.\n    const allSilent = response.toolCalls!.every((request) => {\n      const registered = this.config.tools?.find((tool) => tool.name === request.name);\n      return registered?.mode === \"silent\";\n    });\n\n    return allSilent ? \"stop\" : \"continue\";\n  }\n\n  /**\n   * Route `getModelResponse` through the `trip`-level middleware\n   * pipeline. `trip.before` hooks can short-circuit the trip by\n   * returning a synthetic `ModelResponse` (semantic cache hit).\n   * `trip.after` hooks can transform the response before the trip\n   * record is built or any tool calls are dispatched. `trip.onError`\n   * hooks can recover from provider failures (fallback chain).\n   */\n  private async runTripThroughPipeline(tripIndex: number): Promise<ModelResponse> {\n    const context: MiddlewareTripContext = {\n      ...this.buildExecuteContext(),\n      tripIndex,\n      messages: this.messages,\n    };\n\n    return (await runPipeline(\n      this.middleware,\n      \"trip\",\n      context,\n      () => this.getModelResponse(tripIndex),\n      this.logger,\n    )) as ModelResponse;\n  }\n\n  /**\n   * Produce the `ModelResponse` for the current trip. In non-streaming\n   * mode, delegates straight to `model.complete()`. In streaming mode,\n   * drains `model.stream()` while emitting `streaming` events per delta\n   * and accumulates the chunks into the same `ModelResponse` shape, so the\n   * rest of the trip pipeline (tool dispatch, trip record, usage\n   * aggregation) stays identical between the two modes.\n   */\n  private async getModelResponse(tripIndex: number): Promise<ModelResponse> {\n    const callOptions = {\n      ...this.config.modelOptions,\n      tools: this.config.tools ?? [],\n      ...(this.responseSchema ? { responseSchema: this.responseSchema } : {}),\n      ...(this.options?.signal ? { signal: this.options.signal } : {}),\n    };\n\n    if (!this.streamController) {\n      return this.config.model.complete(this.messages, callOptions);\n    }\n\n    let content = \"\";\n    let finishReason: FinishReason = \"stop\";\n    let usage: Usage = { input: 0, output: 0, total: 0 };\n    const toolCalls: ModelToolCallRequest[] = [];\n    const recoveredCalls: ModelToolCallRequest[] = [];\n\n    const guardConfig = this.resolveStreamingToolGuard();\n    const guard = guardConfig\n      ? new JsonStreamGuard({\n          tools: (this.config.tools ?? []) as ReadonlyArray<ToolContract<unknown, unknown>>,\n          maxBufferBytes: guardConfig.maxBufferBytes,\n          onSafeDelta: (delta) => {\n            content += delta;\n\n            this.emit(\"agent.trip.streaming\", { delta, tripIndex });\n          },\n          onRecoveredCall: (request) => {\n            recoveredCalls.push(request);\n          },\n        })\n      : undefined;\n\n    for await (const chunk of this.config.model.stream(this.messages, callOptions)) {\n      // Mid-stream abort — break out cleanly instead of continuing to\n      // consume the iterator. The underlying fetch is already\n      // cancelled via `signal` forwarded in callOptions; this covers\n      // adapters that don't honor signal natively and keeps mock\n      // models consistent under cancellation tests.\n      if (this.options?.signal?.aborted) {\n        throw this.makeCancelledError();\n      }\n\n      if (chunk.type === \"delta\") {\n        if (guard) {\n          await guard.feed(chunk.content);\n        } else {\n          content += chunk.content;\n\n          this.emit(\"agent.trip.streaming\", { delta: chunk.content, tripIndex });\n        }\n\n        continue;\n      }\n\n      if (chunk.type === \"tool-call\") {\n        toolCalls.push({\n          id: chunk.id,\n          name: chunk.name,\n          input: chunk.input,\n          ...(chunk.providerMetadata ? { providerMetadata: chunk.providerMetadata } : {}),\n        });\n\n        continue;\n      }\n\n      finishReason = chunk.finishReason;\n      usage = chunk.usage;\n    }\n\n    if (guard) {\n      await guard.finalize();\n    }\n\n    // Dedupe synthesized calls against real ones the provider streamed\n    // structurally — the model occasionally emits BOTH channels for\n    // the same call (real tool-call chunk + narrated JSON envelope).\n    // Real wins; the synthesized duplicate is dropped so dispatch\n    // doesn't run twice. See plan 2026-05-22 §Q5.\n    const dedupedRecovered = recoveredCalls.filter(\n      (recovered) => !isDuplicateToolCall(recovered, toolCalls),\n    );\n\n    const mergedToolCalls = [...toolCalls, ...dedupedRecovered];\n\n    // When the guard recovered any calls but the model reported a\n    // natural `\"stop\"`, override to `\"tool_calls\"` so the agent's\n    // dispatch loop (`runTrip` → `isToolCallTrip`) actually fires.\n    // Without this the guard silently suppresses the leaked JSON but\n    // never dispatches the real action — chips never render.\n    const resolvedFinishReason: FinishReason =\n      dedupedRecovered.length > 0 && finishReason === \"stop\" ? \"tool_calls\" : finishReason;\n\n    return {\n      content,\n      finishReason: resolvedFinishReason,\n      usage,\n      toolCalls: mergedToolCalls.length > 0 ? mergedToolCalls : undefined,\n    };\n  }\n\n  /**\n   * Resolve the effective `streamingToolGuard` for this trip.\n   * Per-call options win over the agent-level config when the key is\n   * explicitly present on options (including the explicit `undefined`\n   * \"disable for this call\" form). Returns `undefined` when no guard\n   * should run.\n   */\n  private resolveStreamingToolGuard(): StreamingToolGuardConfig | undefined {\n    if (\n      this.options !== undefined &&\n      Object.prototype.hasOwnProperty.call(this.options, \"streamingToolGuard\")\n    ) {\n      return this.options.streamingToolGuard;\n    }\n\n    return this.config.streamingToolGuard;\n  }\n\n  /**\n   * Dispatch a single tool call requested by the model. Looks up the tool\n   * by name, invokes it via the safe `ToolContract.invoke` entry, pushes a\n   * matching tool-result message into `this.messages` so the next trip can\n   * see it, and emits the right lifecycle event (`tool-called` on success,\n   * `tool-calling-failed` when the tool is unregistered or invoke returned\n   * an error). Never throws — always returns a `ToolCall` record.\n   */\n  private async dispatchToolCall(\n    toolCallRequest: ModelToolCallRequest,\n    tripIndex: number,\n  ): Promise<ToolCall> {\n    const registeredTool = this.config.tools?.find((tool) => tool.name === toolCallRequest.name);\n\n    if (!registeredTool) {\n      const error = new AgentExecutionError(`Tool not registered: ${toolCallRequest.name}`, {\n        context: { toolName: toolCallRequest.name, tripIndex },\n      });\n\n      const nowIso = new Date().toISOString();\n\n      const record: ToolCall = {\n        runId: generateRunId(\"tool\"),\n        rootRunId: this.runId,\n        name: toolCallRequest.name,\n        type: \"tool\",\n        status: \"failed\",\n        startedAt: nowIso,\n        endedAt: nowIso,\n        duration: 0,\n        usage: { input: 0, output: 0, total: 0 },\n        children: [],\n        tripIndex,\n        input: toolCallRequest.input,\n        error,\n        ...(toolCallRequest.recoveredFrom ? { recoveredFrom: toolCallRequest.recoveredFrom } : {}),\n      };\n\n      this.toolCalls.push(record);\n\n      this.messages.push({\n        role: \"tool\",\n        toolCallId: toolCallRequest.id,\n        content: JSON.stringify({ error: error.message }),\n      });\n\n      // Stub meta — there's no real tool to describe. Carries the\n      // requested name for log correlation and an explanatory\n      // description so consumers don't see an empty string.\n      this.emit(\"agent.tool.failed\", {\n        tool: {\n          name: toolCallRequest.name,\n          description: \"(unregistered tool — no description available)\",\n        },\n        input: toolCallRequest.input,\n        error,\n        tripIndex,\n      });\n\n      return record;\n    }\n\n    // Build the lightweight event meta once. Resolves `action` to a\n    // string here so consumers receive plain data rather than having\n    // to re-evaluate a callback on every event.\n    const toolMeta: ToolEventMeta = {\n      name: registeredTool.name,\n      description: registeredTool.description,\n      action: resolveToolAction(registeredTool, toolCallRequest.input),\n    };\n\n    this.emit(\"agent.tool.calling\", {\n      tool: toolMeta,\n      input: toolCallRequest.input,\n      tripIndex,\n    });\n\n    const toolContext: MiddlewareToolContext = {\n      ...this.buildExecuteContext(),\n      tripIndex,\n      messages: this.messages,\n      tool: {\n        name: registeredTool.name,\n        description: registeredTool.description,\n        mode: registeredTool.mode,\n      },\n      request: toolCallRequest,\n    };\n\n    let invokeResult: ToolInvokeResult<unknown>;\n\n    try {\n      invokeResult = (await runPipeline(\n        this.middleware,\n        \"tool\",\n        toolContext,\n        () => registeredTool.invoke(toolCallRequest.input, this.options?.toolCtx),\n        this.logger,\n      )) as ToolInvokeResult<unknown>;\n    } catch (thrown) {\n      // A `tool`-level middleware hook threw. The real invoke never\n      // throws (it funnels errors into `result.error`), so only a\n      // middleware abort or a bug reaches this branch. Synthesize a\n      // failed-invoke record so the tool-call trace stays consistent.\n      const error = this.toAIError(thrown);\n      const nowIso = new Date().toISOString();\n      const emptyUsage: Usage = { input: 0, output: 0, total: 0 };\n\n      const failedRunId = generateRunId(\"tool\");\n      invokeResult = {\n        error,\n        usage: emptyUsage,\n        report: {\n          runId: failedRunId,\n          rootRunId: failedRunId,\n          name: registeredTool.name,\n          version: registeredTool.version,\n          type: \"tool\",\n          status: \"failed\",\n          startedAt: nowIso,\n          endedAt: nowIso,\n          duration: 0,\n          usage: emptyUsage,\n          children: [],\n        },\n      };\n    }\n\n    // The agent-level ToolCall record merges the tool's own invocation\n    // report with agent-side enrichments (tripIndex, input, output,\n    // error). When the underlying tool was an `asTool`-wrapped\n    // composite, its inner report becomes the sole child of this\n    // ToolCall — preserving the full nested tree while keeping this\n    // node's own `type` as `\"tool\"` (from the agent's POV it *was* a\n    // tool dispatch).\n    const innerReport = invokeResult.report;\n    const isComposite = innerReport.type !== \"tool\";\n\n    const record: ToolCall = {\n      runId: innerReport.runId,\n      rootRunId: this.runId,\n      name: toolCallRequest.name,\n      version: registeredTool.version,\n      type: \"tool\",\n      status: innerReport.status,\n      startedAt: innerReport.startedAt,\n      endedAt: innerReport.endedAt,\n      duration: innerReport.duration,\n      usage: invokeResult.usage,\n      children: isComposite ? [innerReport] : innerReport.children,\n      tripIndex,\n      input: toolCallRequest.input,\n      output: invokeResult.data,\n      error: invokeResult.error,\n      ...(toolCallRequest.recoveredFrom ? { recoveredFrom: toolCallRequest.recoveredFrom } : {}),\n    };\n\n    this.toolCalls.push(record);\n\n    // Roll child usage into the agent's accumulator. Leaf tools\n    // contribute zero; `asTool`-wrapped composites contribute the\n    // full cost of the inner agent/workflow/supervisor run.\n    this.usage.input += invokeResult.usage.input;\n    this.usage.output += invokeResult.usage.output;\n    this.usage.total += invokeResult.usage.total;\n    this.usage.cost = accumulateCost(this.usage.cost, invokeResult.usage.cost);\n\n    this.messages.push({\n      role: \"tool\",\n      toolCallId: toolCallRequest.id,\n      content: invokeResult.error\n        ? JSON.stringify({ error: invokeResult.error.message })\n        : JSON.stringify(invokeResult.data ?? null),\n    });\n\n    if (invokeResult.error) {\n      this.emit(\"agent.tool.failed\", {\n        tool: toolMeta,\n        input: toolCallRequest.input,\n        error: invokeResult.error,\n        tripIndex,\n      });\n    } else {\n      this.emit(\"agent.tool.called\", { ...record, tool: toolMeta });\n    }\n\n    return record;\n  }\n\n  /**\n   * Parse the final trip output against the user-supplied schema (if any).\n   * Failures populate `this.error` but never throw. Returns an outcome the\n   * caller uses to decide whether self-repair is worth attempting:\n   *\n   * - `\"skipped\"` — no schema, or a prior trip-level error already set\n   *   `this.error` (model crash, max trips). Not repairable; the failure\n   *   isn't a parse problem the model can fix by re-asking.\n   * - `\"failed\"` — schema present, output text either failed JSON.parse\n   *   or failed `~standard.validate`. Repairable via `runRepairLoop`.\n   * - `\"success\"` — parsed and validated; `this.data` populated.\n   */\n  private async parseOutput(): Promise<\"success\" | \"failed\" | \"skipped\"> {\n    const schema = this.options?.output ?? this.config.output;\n\n    if (!schema || this.error) {\n      return \"skipped\";\n    }\n\n    const finalTrip = this.trips[this.trips.length - 1];\n    const text = finalTrip?.output ?? \"\";\n\n    if (!text) {\n      return \"skipped\";\n    }\n\n    const payload = extractJsonPayload(text);\n    const sentinel = Symbol(\"parse-failed\");\n    const parsed = safeJsonParse<unknown>(payload, sentinel);\n\n    if (parsed === sentinel) {\n      this.error = new SchemaValidationError(\"Failed to parse model output as JSON\", {\n        context: { text },\n      });\n      return \"failed\";\n    }\n\n    const validation = await (schema as StandardSchemaV1<TOutput>)[\"~standard\"].validate(parsed);\n\n    if (validation.issues) {\n      const summary = validation.issues.map((issue) => issue.message).join(\"; \");\n      this.error = new SchemaValidationError(summary, {\n        issues: validation.issues,\n      });\n      return \"failed\";\n    }\n\n    this.data = validation.value;\n    return \"success\";\n  }\n\n  /**\n   * Opt-in self-repair loop for `output` schema failures. Triggered only\n   * when `options.repair` is set and `parseOutput()` returned `\"failed\"`.\n   *\n   * Each attempt:\n   * 1. Pushes the bad assistant response into `this.messages` (so the\n   *    model can see what it just produced).\n   * 2. Pushes a corrective user message naming the validation/parse error.\n   * 3. Runs another trip — counted against the same `maxTrips` cap as\n   *    normal trips so a stuck model can't loop forever.\n   * 4. Re-parses. Stops on success, on a trip-level error, or when\n   *    either `maxAttempts` or `maxTrips` is exhausted.\n   *\n   * Resets `this.error` and `this.data` before each attempt so the final\n   * outcome (success or last failure) is what surfaces to the caller.\n   */\n  private async runRepairLoop(): Promise<void> {\n    const maxAttempts = this.options?.repair?.maxAttempts ?? 1;\n\n    for (let attempt = 0; attempt < maxAttempts; attempt++) {\n      if (this.trips.length >= this.maxTrips) {\n        return;\n      }\n\n      const lastTrip = this.trips[this.trips.length - 1];\n      const badResponse = lastTrip?.output ?? \"\";\n      const failureReason = this.error?.message ?? \"unknown validation failure\";\n\n      this.error = undefined;\n      this.data = undefined;\n\n      this.messages.push({ role: \"assistant\", content: badResponse });\n\n      this.messages.push({\n        role: \"user\",\n        content: [\n          `Your previous response failed validation: ${failureReason}.`,\n          \"Respond again with valid JSON only — no prose, no markdown fences, no commentary.\",\n        ].join(\" \"),\n      });\n\n      const tripIndex = this.trips.length;\n\n      this.logger.warn(LOG_MODULE, \"repair.attempting\", \"retrying after validation failure\", {\n        attempt: attempt + 1,\n        maxAttempts,\n        reason: failureReason,\n      });\n\n      const outcome = await this.runTrip(tripIndex, \"[repair attempt]\");\n\n      if (outcome === \"error\") {\n        return;\n      }\n\n      const parseOutcome = await this.parseOutput();\n\n      if (parseOutcome === \"success\") {\n        return;\n      }\n    }\n  }\n\n  /**\n   * Build the final `AgentResult` snapshot from accumulated state\n   * (trips, tool calls, data/error, usage, timing).\n   *\n   * Pure — no side effects. `run()` owns terminal event emission and\n   * stream closure so the post-pipeline result (possibly transformed\n   * or short-circuited by an `execute`-level middleware) is what\n   * flows out to consumers and listeners.\n   *\n   * Trips, tool calls, status, and timing live under `report` so the\n   * root stays focused on the four things callers reach for most:\n   * `data`, `text`, `usage`, `error`.\n   */\n  private buildResult(): AgentResult<TOutput> {\n    const finalTrip = this.trips[this.trips.length - 1];\n    const endedAt = new Date();\n\n    const agentName = this.config.name ?? this.config.model.name;\n    const status: BaseReport[\"status\"] = this.error\n      ? this.error instanceof AgentCancelledError\n        ? \"cancelled\"\n        : \"failed\"\n      : \"completed\";\n\n    const report = {\n      runId: this.runId,\n      rootRunId: this.runId,\n      name: agentName,\n      version: this.config.version,\n      type: \"agent\" as const,\n      status,\n      startedAt: this.startedAt.toISOString(),\n      endedAt: endedAt.toISOString(),\n      duration: performance.now() - this.start,\n      usage: this.usage,\n      children: this.toolCalls,\n      model: {\n        name: this.config.model.name,\n        provider: this.config.model.provider,\n      },\n      trips: this.trips,\n    };\n\n    // Stamp lineage on the assembled tree exactly once per run.\n    // Rewrites any inner self-roots from composite children to this\n    // run's id, stamps `reportSchemaVersion` on the root, and\n    // propagates `sessionId` to every node.\n    stampReportLineage(report, {\n      rootRunId: this.runId,\n      sessionId: this.options?.sessionId,\n    });\n\n    return {\n      type: \"agent\",\n      data: this.data,\n      text: finalTrip?.output,\n      report,\n      usage: this.usage,\n      error: this.error,\n    };\n  }\n\n  /**\n   * Normalize any thrown value into an `AIError`. `AIError` instances\n   * pass through untouched; provider-adapter SDK errors are caught by\n   * the adapter and already arrive typed, so this branch mainly\n   * handles runtime crashes (TypeError, ReferenceError) inside\n   * model.complete / model.stream and non-Error values (`throw \"bad\"`).\n   */\n  private toAIError(thrown: unknown): AIError {\n    if (thrown instanceof AIError) {\n      return thrown;\n    }\n\n    // Classify abort-flavored errors (DOMException \"AbortError\",\n    // node-fetch's `FetchError` with name \"AbortError\", `ERR_CANCELED`\n    // from the OpenAI SDK's axios-ish layer) as cancelled instead of\n    // a generic exec failure so callers can route retries correctly.\n    if (isAbortLike(thrown)) {\n      return this.makeCancelledError();\n    }\n\n    const message = thrown instanceof Error ? thrown.message : String(thrown);\n\n    return new AgentExecutionError(message, { cause: thrown });\n  }\n\n  /**\n   * Build the typed cancelled error that both the trip-loop guard\n   * and the mid-stream guard emit. Captures the abort reason when\n   * one was supplied to `controller.abort(reason)` so logs and\n   * telemetry can see what cancelled the run.\n   */\n  private makeCancelledError(): AgentCancelledError {\n    const reason = this.options?.signal?.reason;\n    const reasonText = reason === undefined ? \"\" : String(reason);\n\n    return new AgentCancelledError(\"agent execution cancelled\", {\n      cause: reason,\n      cancelledAt: new Date().toISOString(),\n      reason: reasonText,\n    });\n  }\n\n  /**\n   * Fire a single event through all three subscription tiers in order\n   * — factory → instance → per-call — and mirror it into the\n   * `StreamController` when streaming is active. A throwing user\n   * handler must never crash the agent, so every dispatch is wrapped\n   * in `safeCall`. Stream events are converted from the internal\n   * `AgentEventMap` payload to the public `StreamEvent` shape because\n   * some of them differ (e.g. the tool-called payload vs stream\n   * event).\n   */\n  private emit<K extends keyof AgentEventMap>(\n    event: K,\n    payload: WithoutIdentity<AgentEventMap[K]>,\n  ): void {\n    // Inject run identity once, here, so every subscription tier and\n    // the stream see it. `rootRunId === runId` for a standalone run;\n    // nested propagation lands in a follow-up.\n    const fullPayload = {\n      ...payload,\n      runId: this.runId,\n      rootRunId: this.runId,\n    } as AgentEventMap[K];\n\n    this.logEvent(event, fullPayload);\n\n    const factoryHandler = this.config.on?.[event] as AgentEventHandler<K> | undefined;\n\n    if (factoryHandler) {\n      safeCall(factoryHandler, fullPayload);\n    }\n\n    const bucket = this.instanceHandlers?.get(event);\n\n    if (bucket) {\n      for (const handler of bucket) {\n        safeCall(handler as AgentEventHandler<K>, fullPayload);\n      }\n    }\n\n    const perCallHandler = this.options?.on?.[event] as AgentEventHandler<K> | undefined;\n\n    if (perCallHandler) {\n      safeCall(perCallHandler, fullPayload);\n    }\n\n    if (this.streamController) {\n      const body = this.toStreamEvent(event, fullPayload);\n\n      if (body) {\n        this.streamController.push({\n          runId: this.runId,\n          rootRunId: this.runId,\n          ...body,\n        });\n      }\n    }\n  }\n\n  /**\n   * Emit a structured log line for a lifecycle event. The action\n   * string mirrors the event name with the `agent.` prefix stripped\n   * (`agent.trip.started` → `trip.started`) so log grep filters and\n   * event handlers read the same vocabulary. Level mapping follows\n   * the convention documented on `@warlock.js/logger`'s `Logger`.\n   */\n  private logEvent<K extends keyof AgentEventMap>(event: K, payload: AgentEventMap[K]): void {\n    const agentName = this.config.name || this.config.model.name;\n    logAgentEvent(\n      this.logger,\n      {\n        module: `${LOG_MODULE}.${agentName}`,\n        maxTrips: this.maxTrips,\n        modelName: this.config.model.name,\n        totalUsage: this.usage,\n        totalDurationMs: performance.now() - this.start,\n        trips: this.trips,\n        toolCalls: this.toolCalls,\n      },\n      event,\n      payload,\n    );\n  }\n\n  private toStreamEvent<K extends keyof AgentEventMap>(\n    event: K,\n    payload: AgentEventMap[K],\n  ): StreamEventBody | undefined {\n    return agentEventToStreamEvent(event, payload);\n  }\n\n  /**\n   * Invoke the `onUsage` hook (when configured) with a flat payload\n   * carrying stable identity. Awaits the handler so async ledger\n   * writes complete before the next trip starts; swallows any throw\n   * so consumer bugs cannot crash the agent. Sync handlers wrapped\n   * via `Promise.resolve()` so the await is safe in either case.\n   */\n  private async fireUsageHook(tripIndex: number, tripUsage: Usage): Promise<void> {\n    const handler = this.config.onUsage;\n    if (!handler) return;\n\n    const event: UsageEvent = {\n      runId: this.runId,\n      tripIndex,\n      model: {\n        name: this.config.model.name,\n        provider: this.config.model.provider,\n      },\n      usage: { ...tripUsage },\n      timestamp: new Date().toISOString(),\n    };\n\n    try {\n      await Promise.resolve(handler(event));\n    } catch (err) {\n      this.logger.warn(LOG_MODULE, \"onUsage.hook.error\", \"onUsage handler threw\", {\n        runId: this.runId,\n        tripIndex,\n        error: err instanceof Error ? err.message : String(err),\n      });\n    }\n  }\n\n  /**\n   * Invoke the `onComplete` hook (when configured) once at the end\n   * of every run. Receives the full `AgentResult` plus pre-extracted\n   * `runId` and `durationMs`. Same swallow-and-log error policy as\n   * `fireUsageHook`.\n   */\n  private async fireCompleteHook(result: AgentResult<TOutput>): Promise<void> {\n    const handler = this.config.onComplete;\n    if (!handler) return;\n\n    const event: CompleteEvent<TOutput> = {\n      result,\n      runId: this.runId,\n      durationMs: performance.now() - this.start,\n    };\n\n    try {\n      await Promise.resolve(handler(event));\n    } catch (err) {\n      this.logger.warn(LOG_MODULE, \"onComplete.hook.error\", \"onComplete handler threw\", {\n        runId: this.runId,\n        error: err instanceof Error ? err.message : String(err),\n      });\n    }\n  }\n}\n\n/**\n * Decide whether a guard-synthesized tool call duplicates a real one\n * the provider already streamed structurally. Match key is\n * `name + key-sorted JSON of input` so identical calls (regardless of\n * argument key order) collapse, but two legitimate calls to the same\n * tool with different inputs still both dispatch.\n */\nfunction isDuplicateToolCall(\n  recovered: ModelToolCallRequest,\n  realCalls: ReadonlyArray<ModelToolCallRequest>,\n): boolean {\n  const recoveredKey = `${recovered.name}|${stableStringify(recovered.input)}`;\n\n  for (const real of realCalls) {\n    const realKey = `${real.name}|${stableStringify(real.input)}`;\n\n    if (realKey === recoveredKey) {\n      return true;\n    }\n  }\n\n  return false;\n}\n\n/**\n * `JSON.stringify` variant that sorts object keys at every nesting\n * level so structurally-equal inputs serialize to identical strings.\n * Used only for dedupe-key comparison; never surfaces to consumers.\n */\nfunction stableStringify(value: unknown): string {\n  return JSON.stringify(value, (_key, val) => {\n    if (val !== null && typeof val === \"object\" && !Array.isArray(val)) {\n      const source = val as Record<string, unknown>;\n      const sorted: Record<string, unknown> = {};\n\n      for (const key of Object.keys(source).sort()) {\n        sorted[key] = source[key];\n      }\n\n      return sorted;\n    }\n\n    return val;\n  });\n}\n\n/**\n * Invoke a user-supplied event handler without letting exceptions\n * escape the agent. Thrown errors are swallowed — structured logging\n * attaches here in Phase 0.5 so operators still see the failure.\n */\nfunction safeCall<T>(handler: (payload: T) => void, payload: T): void {\n  try {\n    handler(payload);\n  } catch {\n    // Intentionally swallowed — user handlers never crash the agent.\n  }\n}\n\n/**\n * Resolve a tool's `action` declaration into a plain string for\n * inclusion in `ToolEventMeta`. Static strings pass through;\n * function-shaped actions are invoked with the validated input.\n *\n * Defensive: if the user's callback throws, swallow and return\n * `undefined` rather than crashing the agent — UI strings are not\n * worth aborting an LLM dispatch over.\n */\nfunction resolveToolAction(\n  tool: ToolContract<unknown, unknown>,\n  input: unknown,\n): string | undefined {\n  if (tool.action === undefined) return undefined;\n  if (typeof tool.action === \"string\") return tool.action;\n  try {\n    return tool.action(input);\n  } catch {\n    return undefined;\n  }\n}\n","import type { StandardSchemaV1 } from \"@standard-schema/spec\";\nimport type { AgentExecuteOptions } from \"../contracts/agent/agent-options.type\";\nimport type { AgentContract } from \"../contracts/agent/agent.contract\";\nimport type { AgentResult } from \"../contracts/result/agent-result.type\";\nimport type { ModelContract } from \"../contracts/model.contract\";\nimport type { SystemPromptContract } from \"../contracts/system-prompt.contract\";\nimport { budget, type BudgetOptions } from \"../middleware/builtins/budget\";\nimport type { AgentToolEntry } from \"../tool/executable-as-tool\";\nimport { agent } from \"./agent\";\n\n/**\n * Spec for `spawnSubAgent` — a one-shot agent invocation. `spawnSubAgent`\n * is a thin convenience wrapper: it builds a fresh `agent()` from this\n * spec, optionally attaches a `budget` middleware, runs the `task` once,\n * and returns the `AgentResult`. There is no separate \"sub-agent\" runtime\n * — a spawn is an ordinary new `agent()` instance, so it starts from an\n * empty conversation with its own tools/prompt exactly the way every\n * `agent()` does.\n *\n * `budget` is the one field that adds something a bare `agent()` config\n * doesn't already give you ergonomically: a first-class per-task\n * cost/token cap. When set, the spawn runs under a `budget` middleware\n * that aborts the moment a cap is crossed, so a delegated subtask cannot\n * overrun its allowance. (Equivalent to passing\n * `middleware: [budget(...)]` to a plain agent — this just promotes it to\n * a spec field.) Distinct from `maxTrips`, which caps round-trips, not spend.\n */\nexport type SpawnSubAgentSpec<TOutput = unknown> = {\n  /** Stable identifier for the spawned agent. */\n  name: string;\n  /** The model the sub-agent runs against. */\n  model: ModelContract;\n  /** The subtask instruction handed to the sub-agent's `execute()`. */\n  task: string;\n  /** Optional system prompt scoping the sub-agent's behavior. */\n  systemPrompt?: SystemPromptContract | string;\n  /** Tools the spawned agent may call inside its own loop (a fresh agent, so not shared with the caller). */\n  tools?: AgentToolEntry<unknown, unknown>[];\n  /** Per-spawn round-trip cap. Forwarded to the agent. Defaults to the agent default. */\n  maxTrips?: number;\n  /**\n   * Per-task budget. When set, the spawn runs under a `budget` middleware\n   * that aborts once a cap (`maxTokens` / `maxCostUSD`) is crossed — a\n   * spend ceiling scoped to this one subtask. Because each spawn is its\n   * own `agent()` instance, that ledger starts fresh per spawn.\n   */\n  budget?: BudgetOptions;\n  /** Structured-output schema validated into `result.data`. */\n  output?: StandardSchemaV1<TOutput>;\n  /** Cancellation handle threaded into the sub-agent run. */\n  signal?: AbortSignal;\n  /**\n   * Session identifier propagated onto the sub-agent's report tree so\n   * the spawned run groups under the parent's session in flat trace\n   * queries.\n   */\n  sessionId?: string;\n};\n\n/**\n * Build a fresh agent, run a single subtask through it once, and return\n * the unified {@link AgentResult}. Equivalent to\n * `agent({ ...spec, middleware: spec.budget && [budget(spec.budget)] }).execute(spec.task, { output, signal, sessionId })`.\n *\n * **Role.** A general-purpose \"build, run, discard\" primitive: a caller\n * (an agent tool, a workflow step, a planner step, a route callback, or\n * hand-rolled orchestration) hands a self-contained subtask to a\n * single-use agent created just for it, instead of reusing a long-lived\n * agent. The spawned `report` slots under the caller's\n * `report.children[]` like any executable, so cost and traces roll up\n * uniformly. It is not tied to any one primitive — it depends only on\n * `agent()` and the optional `budget` middleware.\n *\n * **What it is NOT.** Not a sandbox or a separate runtime. Each spawn is\n * a plain new `agent()` — its fresh conversation, own tools, and own\n * middleware state are ordinary new-instance behavior, not special\n * isolation (every `agent()` already has them). It is also a *narrower*\n * surface than `agent.execute`: one-shot, with no `history`,\n * `placeholders`, per-call event handlers, or `repair`. Reach for it when\n * you want a named single-use delegation with a per-task budget cap;\n * otherwise just construct an `agent()` and call it.\n *\n * Never throws on runtime failure — the agent surfaces failures on\n * `result.error` and a `\"failed\"` / `\"cancelled\"` report status.\n *\n * @example\n * const result = await spawnSubAgent({\n *   name: \"extract-entities\",\n *   model,\n *   task: \"Pull every company name from this article: ...\",\n *   budget: { maxCostUSD: 0.05 },\n *   output: z.object({ companies: z.array(z.string()) }),\n * });\n */\nexport async function spawnSubAgent<TOutput = unknown>(\n  spec: SpawnSubAgentSpec<TOutput>,\n): Promise<AgentResult<TOutput>> {\n  const subAgent = buildSubAgent<TOutput>(spec);\n\n  const options: AgentExecuteOptions<TOutput> = {};\n\n  if (spec.output !== undefined) {\n    options.output = spec.output;\n  }\n\n  if (spec.signal !== undefined) {\n    options.signal = spec.signal;\n  }\n\n  if (spec.sessionId !== undefined) {\n    options.sessionId = spec.sessionId;\n  }\n\n  return subAgent.execute(spec.task, options);\n}\n\n/**\n * Construct the fresh agent for one spawn. Attaches a `budget`\n * middleware only when a cap was requested, so the common no-budget case\n * is just a plain agent.\n */\nfunction buildSubAgent<TOutput>(spec: SpawnSubAgentSpec<TOutput>): AgentContract<TOutput> {\n  const middleware = spec.budget !== undefined ? [budget(spec.budget)] : undefined;\n\n  return agent<TOutput>({\n    name: spec.name,\n    model: spec.model,\n    systemPrompt: spec.systemPrompt,\n    tools: spec.tools,\n    maxTrips: spec.maxTrips,\n    output: spec.output,\n    middleware,\n  });\n}\n","import type {\n  RetryBackoff,\n  RetryConfig,\n} from \"../contracts/workflow/retry-config.type\";\n\nexport const DEFAULT_BACKOFF_CAP_MS = 30_000;\n\nexport function resolveBackoff(\n  attempt: number,\n  backoff: RetryBackoff | undefined,\n): number {\n  const value = (() => {\n    switch (backoff) {\n      case \"none\":\n        return 0;\n      case \"linear\":\n        return attempt * 500;\n      case \"exponential\":\n      case undefined:\n        return 500 * 2 ** (attempt - 1);\n      default:\n        return backoff(attempt);\n    }\n  })();\n\n  return Math.max(0, Math.min(value, DEFAULT_BACKOFF_CAP_MS));\n}\n\nexport function isAbortError(error: unknown): boolean {\n  if (!error || typeof error !== \"object\") return false;\n  const name = (error as { name?: unknown }).name;\n  return name === \"AbortError\";\n}\n\n/**\n * Resolve the effective retry config for a step, merging per-step and\n * workflow-level defaults. `retry: false` disables retries entirely.\n */\nexport function resolveRetryConfig(\n  step: { retry?: RetryConfig | false } | undefined,\n  workflowDefault: RetryConfig | false | undefined,\n): RetryConfig {\n  if (step?.retry === false) return { attempts: 1 };\n  if (step?.retry) return step.retry;\n  if (workflowDefault === false || workflowDefault === undefined) {\n    return { attempts: 1 };\n  }\n  return workflowDefault;\n}\n","import { WorkflowCancelledError } from \"../errors\";\n\n/**\n * Build a `WorkflowCancelledError` from an `AbortSignal`, extracting\n * a human-readable reason from `signal.reason` (string | Error | any).\n * Used both at between-step boundaries and inside the retry backoff\n * sleep.\n */\nexport function createCancelledError(\n  signal: AbortSignal | undefined,\n): WorkflowCancelledError {\n  const reason = signal?.reason;\n  const reasonText =\n    typeof reason === \"string\"\n      ? reason\n      : reason instanceof Error\n        ? reason.message\n        : reason === undefined\n          ? \"\"\n          : String(reason);\n\n  return new WorkflowCancelledError(\n    `workflow cancelled${reasonText ? `: ${reasonText}` : \"\"}`,\n    { cancelledAt: new Date().toISOString(), reason: reasonText },\n  );\n}\n\n/**\n * Promise-based sleep that resolves after `ms` milliseconds, or\n * rejects with `WorkflowCancelledError` if the signal fires. The\n * timer is cleared on abort so we never leak a pending setTimeout.\n */\nexport function sleep(ms: number, signal?: AbortSignal): Promise<void> {\n  return new Promise((resolve, reject) => {\n    if (signal?.aborted) {\n      reject(createCancelledError(signal));\n      return;\n    }\n\n    const timer = setTimeout(() => {\n      signal?.removeEventListener(\"abort\", onAbort);\n      resolve();\n    }, ms);\n\n    const onAbort = () => {\n      clearTimeout(timer);\n      reject(createCancelledError(signal));\n    };\n\n    signal?.addEventListener(\"abort\", onAbort, { once: true });\n  });\n}\n","import { WorkflowError } from \"../errors\";\n\n/**\n * Deep-clone workflow state. Uses `structuredClone` — handles Date,\n * Map, Set, ArrayBuffer, nested objects, arrays, primitives. Throws\n * a typed `WorkflowError` on older runtimes (pre-Node-17) rather\n * than silently falling back to a JSON round-trip that would drop\n * non-serializable values like Dates without warning.\n *\n * Workflow state should stay serializable anyway (it round-trips\n * through `KVStore` on every checkpoint). If `structuredClone` chokes\n * on a value, that's a bug in the user's state — surface it.\n */\nexport function cloneState<T>(value: T): T {\n  if (typeof structuredClone !== \"function\") {\n    throw new WorkflowError(\n      \"workflow state cloning requires `structuredClone` (Node 17+ or a modern browser)\",\n    );\n  }\n\n  return structuredClone(value);\n}\n\n/**\n * Recursively freeze `value` and every nested plain object / array so\n * consumers of `ctx.steps[x].state` or `report.state` can't mutate\n * historical snapshots. Already-frozen values are skipped.\n */\nexport function deepFreeze<T>(value: T): T {\n  if (value === null || typeof value !== \"object\") return value;\n  if (Object.isFrozen(value)) return value;\n\n  for (const key of Object.keys(value as Record<string, unknown>)) {\n    const child = (value as Record<string, unknown>)[key];\n    if (child && typeof child === \"object\") deepFreeze(child);\n  }\n\n  return Object.freeze(value);\n}\n","import type { StandardSchemaV1 } from \"@standard-schema/spec\";\nimport type { Logger } from \"@warlock.js/logger\";\nimport type { AgentResult } from \"../contracts/result/agent-result.type\";\nimport type { AgentReport } from \"../contracts/result/execution-report.type\";\nimport type { AttemptEntry, StepSnapshot } from \"../contracts/result/step-result.type\";\nimport type { Usage } from \"../contracts/result/usage.type\";\nimport type { RetryConfig } from \"../contracts/workflow/retry-config.type\";\nimport type { StepDefinition } from \"../contracts/workflow/step.contract\";\nimport type { WorkflowContext } from \"../contracts/workflow/workflow-context.type\";\nimport type { WorkflowEventHandlers } from \"../contracts/workflow/workflow.contract\";\nimport {\n  AIError,\n  SchemaValidationError,\n  StepFailedError,\n  WorkflowCancelledError,\n  WorkflowError,\n} from \"../errors\";\nimport { createCancelledError, sleep } from \"./cancellation\";\nimport type { WorkflowEventSink } from \"./emitter\";\nimport { isAbortError, resolveBackoff, resolveRetryConfig } from \"./retry\";\nimport { cloneState, deepFreeze } from \"./state\";\n\n/**\n * Mutable snapshot used by the step runner — finalized (deep-frozen)\n * by the engine before being written to `ctx.steps` / `report.steps`.\n */\nexport type MutableStepSnapshot = {\n  output: unknown;\n  skipped: boolean;\n  status: \"completed\" | \"skipped\" | \"failed\";\n  startedAt: string;\n  endedAt: string;\n  duration: number;\n  attempts: number;\n  attemptHistory: AttemptEntry[];\n  error?: AIError;\n  state: Record<string, unknown>;\n  executionResult?: unknown;\n  agentReport?: AgentReport;\n  agentUsage?: Usage;\n  steps?: Record<string, StepSnapshot>;\n};\n\n/**\n * Narrow an `executionResult` to an `AgentResult` when the step ran\n * an agent. Custom `run` steps return arbitrary values, so the\n * `type: \"agent\"` discriminant keeps us honest.\n */\nfunction asAgentResult(result: unknown): AgentResult<unknown> | undefined {\n  if (!result || typeof result !== \"object\") return undefined;\n  if ((result as { type?: unknown }).type !== \"agent\") return undefined;\n  return result as AgentResult<unknown>;\n}\n\nexport type ExecuteStepParams = {\n  step: StepDefinition;\n  state: Record<string, unknown>;\n  emitter: WorkflowEventSink;\n  executionHandlers?: WorkflowEventHandlers;\n  logger: Logger;\n  logModule: string;\n  signal?: AbortSignal;\n  buildContext: (current?: {\n    state: Record<string, unknown>;\n    agentResult?: unknown;\n  }) => WorkflowContext;\n  usage: Usage;\n  workflowDefaultRetry?: RetryConfig | false;\n};\n\n/**\n * Drive one step's full lifecycle — skip evaluation, parallel\n * dispatch, retry loop around before → run|agent → output → after.\n * Returns a mutable snapshot; the engine deep-freezes it before\n * exposing.\n */\nexport async function executeStep(params: ExecuteStepParams): Promise<MutableStepSnapshot> {\n  const { step, emitter, executionHandlers, logger, logModule, signal } = params;\n  const startedAt = new Date().toISOString();\n  const stepStartPerf = performance.now();\n\n  params.step.on?.starting?.({ step: step.name });\n  emitter.emit(\"workflow.step.starting\", { step: step.name }, executionHandlers);\n  logger.debug(logModule, \"step.starting\", `${step.name} step starting`, {\n    step: step.name,\n  });\n\n  const stepState: Record<string, unknown> = cloneState(params.state);\n\n  // SKIP\n  try {\n    if (step.skip) {\n      const shouldSkip = await step.skip(params.buildContext({ state: stepState }));\n      if (shouldSkip) {\n        const endedAt = new Date().toISOString();\n        const duration = performance.now() - stepStartPerf;\n        emitter.emit(\"workflow.step.skipped\", { step: step.name }, executionHandlers);\n        logger.debug(logModule, \"step.skipped\", `${step.name} step skipped`, {\n          step: step.name,\n        });\n\n        return {\n          output: undefined,\n          skipped: true,\n          status: \"skipped\",\n          startedAt,\n          endedAt,\n          duration,\n          attempts: 0,\n          attemptHistory: [],\n          state: stepState,\n        };\n      }\n    }\n  } catch (err) {\n    return buildFailedSnapshot(step, stepState, startedAt, stepStartPerf, 1, [\n      failedAttempt(1, err, new Date().toISOString(), performance.now()),\n    ]);\n  }\n\n  // PARALLEL\n  if (step.parallel && step.parallel.length > 0) {\n    return runParallelStep({\n      ...params,\n      step,\n      stepState,\n      startedAt,\n      startPerf: stepStartPerf,\n    });\n  }\n\n  const retryConfig = resolveRetryConfig(step, params.workflowDefaultRetry);\n\n  const attempts: AttemptEntry[] = [];\n  const totalAttempts = Math.max(1, retryConfig.attempts ?? 1);\n  let lastError: unknown;\n  let executionResult: unknown;\n  let output: unknown;\n  let succeeded = false;\n\n  for (let attempt = 1; attempt <= totalAttempts; attempt++) {\n    if (signal?.aborted) throw createCancelledError(signal);\n\n    const attemptStart = new Date().toISOString();\n    const attemptStartPerf = performance.now();\n    try {\n      // Fresh deep-clone per attempt — retries restart cleanly.\n      const attemptState: Record<string, unknown> = cloneState(params.state);\n\n      if (step.before) {\n        await step.before(params.buildContext({ state: attemptState }));\n      }\n\n      if (step.agent) {\n        const agentInput = step.input\n          ? await step.input(params.buildContext({ state: attemptState }))\n          : { prompt: \"\" };\n\n        const { prompt, ...agentOpts } = agentInput;\n\n        const result = await step.agent.execute(prompt, {\n          ...agentOpts,\n          signal,\n        });\n\n        executionResult = result;\n\n        if (result.usage) {\n          params.usage.input += result.usage.input ?? 0;\n          params.usage.output += result.usage.output ?? 0;\n          params.usage.total += result.usage.total ?? 0;\n        }\n\n        if (result.error) throw result.error;\n      } else if (step.run) {\n        executionResult = await step.run(params.buildContext({ state: attemptState }));\n      }\n\n      if (step.output) {\n        const extracted = await step.output.extract(\n          params.buildContext({\n            state: attemptState,\n            agentResult: executionResult,\n          }),\n        );\n        output = await validateSchema(step.output.schema, extracted);\n      } else {\n        output = undefined;\n      }\n\n      if (step.after) {\n        await step.after(\n          params.buildContext({\n            state: attemptState,\n            agentResult: executionResult,\n          }),\n        );\n      }\n\n      Object.assign(stepState, attemptState);\n\n      attempts.push({\n        index: attempt,\n        startedAt: attemptStart,\n        endedAt: new Date().toISOString(),\n        duration: performance.now() - attemptStartPerf,\n        status: \"success\",\n      });\n      succeeded = true;\n      break;\n    } catch (err) {\n      if (isAbortError(err) || err instanceof WorkflowCancelledError) {\n        throw createCancelledError(signal);\n      }\n\n      attempts.push({\n        index: attempt,\n        startedAt: attemptStart,\n        endedAt: new Date().toISOString(),\n        duration: performance.now() - attemptStartPerf,\n        status: \"failed\",\n        error: toAIError(err),\n      });\n\n      lastError = err;\n\n      const shouldRetry =\n        attempt < totalAttempts &&\n        (retryConfig.retryOn ? retryConfig.retryOn(err, attempt) !== false : true);\n\n      if (!shouldRetry) break;\n\n      emitter.emit(\n        \"workflow.step.retrying\",\n        {\n          step: step.name,\n          attempt: attempt + 1,\n          totalAttempts,\n          lastError: err,\n        },\n        params.executionHandlers,\n      );\n\n      step.on?.retrying?.({\n        step: step.name,\n        attempt: attempt + 1,\n        totalAttempts,\n        lastError: err,\n      });\n\n      logger.warn(logModule, \"step.retrying\", `${step.name} step retrying`, {\n        step: step.name,\n        attempt: attempt + 1,\n      });\n\n      retryConfig.onRetry?.(attempt + 1, err);\n\n      const delay = resolveBackoff(attempt, retryConfig.backoff);\n      if (delay > 0) await sleep(delay, signal);\n    }\n  }\n\n  const endedAt = new Date().toISOString();\n  const duration = performance.now() - stepStartPerf;\n\n  if (!succeeded) {\n    const aiError = toAIError(lastError);\n    const stepError = new StepFailedError(\n      `step \"${step.name}\" failed after ${attempts.length} attempt(s): ${aiError.message}`,\n      { stepName: step.name, attempts: attempts.length, cause: aiError },\n    );\n\n    emitter.emit(\n      \"workflow.step.failed\",\n      { step: step.name, error: stepError, attempts: attempts.length },\n      params.executionHandlers,\n    );\n\n    step.on?.failed?.({\n      step: step.name,\n      error: stepError,\n      attempts: attempts.length,\n    });\n\n    logger.error(logModule, \"step.failed\", `${step.name} step failed`, {\n      step: step.name,\n      attempts: attempts.length,\n      code: stepError.code,\n    });\n\n    const failedAgentResult = asAgentResult(executionResult);\n    return {\n      output: undefined,\n      skipped: false,\n      status: \"failed\",\n      startedAt,\n      endedAt,\n      duration,\n      attempts: attempts.length,\n      attemptHistory: attempts,\n      error: stepError,\n      state: stepState,\n      executionResult:\n        executionResult && typeof executionResult === \"object\" ? executionResult : undefined,\n      agentReport: failedAgentResult?.report,\n      agentUsage: failedAgentResult?.usage,\n    };\n  }\n\n  emitter.emit(\n    \"workflow.step.completed\",\n    { step: step.name, output, duration },\n    params.executionHandlers,\n  );\n  step.on?.completed?.({ step: step.name, output, duration });\n  logger.debug(logModule, \"step.completed\", \"step completed\", {\n    step: step.name,\n    duration,\n  });\n\n  const completedAgentResult = asAgentResult(executionResult);\n  return {\n    output,\n    skipped: false,\n    status: \"completed\",\n    startedAt,\n    endedAt,\n    duration,\n    attempts: attempts.length,\n    attemptHistory: attempts,\n    state: stepState,\n    executionResult:\n      executionResult && typeof executionResult === \"object\" ? executionResult : undefined,\n    agentReport: completedAgentResult?.report,\n    agentUsage: completedAgentResult?.usage,\n  };\n}\n\n// ---------------------------------------------------------------------------\n// Parallel runner\n// ---------------------------------------------------------------------------\n\ntype ParallelParams = ExecuteStepParams & {\n  stepState: Record<string, unknown>;\n  startedAt: string;\n  startPerf: number;\n};\n\nasync function runParallelStep(params: ParallelParams): Promise<MutableStepSnapshot> {\n  const { step, emitter, executionHandlers, logger, logModule, signal } = params;\n\n  const sharedState = params.stepState;\n  const childSnapshots: Record<string, StepSnapshot> = {};\n  let firstError: AIError | undefined;\n\n  const results = await Promise.all(\n    (step.parallel ?? []).map(async (child) => {\n      const snap = await executeStep({\n        step: child,\n        state: sharedState,\n        emitter,\n        executionHandlers,\n        logger,\n        logModule,\n        signal,\n        buildContext: params.buildContext,\n        usage: params.usage,\n      });\n\n      Object.assign(sharedState, snap.state);\n      return { child, snap };\n    }),\n  );\n\n  for (const { child, snap } of results) {\n    childSnapshots[child.name] = finalizeSnapshot(snap);\n    if (snap.status === \"failed\" && !firstError && snap.error) {\n      firstError = snap.error;\n    }\n  }\n\n  const endedAt = new Date().toISOString();\n  const duration = performance.now() - params.startPerf;\n\n  let output: unknown;\n\n  if (step.output) {\n    try {\n      const ctx = params.buildContext({ state: sharedState });\n      const ctxWithChildren = {\n        ...ctx,\n        steps: {\n          ...ctx.steps,\n          [step.name]: {\n            ...(childSnapshots as unknown as StepSnapshot),\n            steps: childSnapshots,\n            status: firstError ? \"failed\" : \"completed\",\n          } as StepSnapshot,\n        } as Readonly<Record<string, StepSnapshot>>,\n      };\n\n      const extracted = await step.output.extract(ctxWithChildren);\n      output = await validateSchema(step.output.schema, extracted);\n    } catch (err) {\n      firstError = firstError ?? toAIError(err);\n    }\n  }\n\n  const status: \"completed\" | \"failed\" = firstError ? \"failed\" : \"completed\";\n\n  if (status === \"completed\") {\n    emitter.emit(\n      \"workflow.step.completed\",\n      { step: step.name, output, duration },\n      executionHandlers,\n    );\n    step.on?.completed?.({ step: step.name, output, duration });\n  } else {\n    emitter.emit(\n      \"workflow.step.failed\",\n      { step: step.name, error: firstError!, attempts: 1 },\n      executionHandlers,\n    );\n    step.on?.failed?.({ step: step.name, error: firstError!, attempts: 1 });\n  }\n\n  return {\n    output,\n    skipped: false,\n    status,\n    startedAt: params.startedAt,\n    endedAt,\n    duration,\n    attempts: 1,\n    attemptHistory: [],\n    error: firstError,\n    state: sharedState,\n    steps: childSnapshots,\n  };\n}\n\n// ---------------------------------------------------------------------------\n// Helpers\n// ---------------------------------------------------------------------------\n\nexport function finalizeSnapshot(snap: MutableStepSnapshot): StepSnapshot {\n  return Object.freeze({\n    output: snap.output,\n    skipped: snap.skipped,\n    status: snap.status,\n    startedAt: snap.startedAt,\n    endedAt: snap.endedAt,\n    duration: snap.duration,\n    attempts: snap.attempts,\n    attemptHistory: snap.attemptHistory,\n    error: snap.error,\n    state: deepFreeze(cloneState(snap.state)),\n    executionResult: snap.executionResult as StepSnapshot[\"executionResult\"],\n    agentReport: snap.agentReport,\n    agentUsage: snap.agentUsage,\n    steps: snap.steps,\n  }) as StepSnapshot;\n}\n\nfunction buildFailedSnapshot(\n  step: StepDefinition,\n  state: Record<string, unknown>,\n  startedAt: string,\n  startPerf: number,\n  attemptsCount: number,\n  attemptHistory: AttemptEntry[],\n): MutableStepSnapshot {\n  const endedAt = new Date().toISOString();\n  const duration = performance.now() - startPerf;\n  const lastErr = attemptHistory[attemptHistory.length - 1]?.error;\n  const wrapped = lastErr\n    ? new StepFailedError(`step \"${step.name}\" skip threw: ${lastErr.message}`, {\n        stepName: step.name,\n        attempts: attemptsCount,\n        cause: lastErr,\n      })\n    : new StepFailedError(`step \"${step.name}\" failed`, {\n        stepName: step.name,\n        attempts: attemptsCount,\n      });\n\n  return {\n    output: undefined,\n    skipped: false,\n    status: \"failed\",\n    startedAt,\n    endedAt,\n    duration,\n    attempts: attemptsCount,\n    attemptHistory,\n    error: wrapped,\n    state,\n  };\n}\n\nfunction failedAttempt(\n  index: number,\n  err: unknown,\n  startedAt: string,\n  startPerf: number,\n): AttemptEntry {\n  return {\n    index,\n    startedAt,\n    endedAt: new Date().toISOString(),\n    duration: performance.now() - startPerf,\n    status: \"failed\",\n    error: toAIError(err),\n  };\n}\n\nexport function toAIError(err: unknown): AIError {\n  if (err instanceof AIError) return err;\n  if (err instanceof Error) return new WorkflowError(err.message, { cause: err });\n  return new WorkflowError(String(err));\n}\n\nasync function validateSchema(\n  schema: StandardSchemaV1<unknown> | undefined,\n  value: unknown,\n): Promise<unknown> {\n  if (!schema) return value;\n  const result = await schema[\"~standard\"].validate(value);\n\n  if (\"issues\" in result && result.issues) {\n    throw new SchemaValidationError(\"workflow step output failed schema validation\", {\n      issues: result.issues,\n    });\n  }\n\n  return (result as { value: unknown }).value;\n}\n","import type { BaseResult } from \"../contracts/result/base-result.type\";\nimport type { ExecutableContract } from \"../contracts/executable.contract\";\nimport type { RetryConfig } from \"../contracts/workflow/retry-config.type\";\nimport { isAbortError, resolveBackoff, resolveRetryConfig } from \"../workflow/retry\";\nimport { toAIError } from \"../workflow/step-runner\";\nimport type { BatchItemResult } from \"./batch.type\";\n\n/**\n * Parameters for {@link runBatchItem}. Kept as a plain bag so the\n * concurrency pool can build it once per index without a long\n * positional argument list.\n */\nexport type RunBatchItemParams<TInput, TOptions, TResult extends BaseResult> = {\n  index: number;\n  input: TInput;\n  executable: ExecutableContract<TInput, TOptions, TResult>;\n  retry: RetryConfig | undefined;\n  signal: AbortSignal | undefined;\n};\n\n/**\n * Sleep for `ms`, settling early (without throwing) if `signal`\n * aborts during the wait. The caller re-checks `signal.aborted` after\n * this resolves, so a silent early return is enough — we never want a\n * pending timer to keep the batch alive past cancellation.\n */\nfunction sleep(ms: number, signal: AbortSignal | undefined): Promise<void> {\n  return new Promise((resolve) => {\n    const timer = setTimeout(() => {\n      signal?.removeEventListener(\"abort\", onAbort);\n      resolve();\n    }, ms);\n\n    const onAbort = (): void => {\n      clearTimeout(timer);\n      resolve();\n    };\n\n    signal?.addEventListener(\"abort\", onAbort, { once: true });\n  });\n}\n\n/**\n * Execute one item with per-item retry, isolated so a failure can\n * neither throw nor disturb sibling items running in the same pool.\n *\n * Reuses the workflow retry vocabulary verbatim\n * ({@link resolveRetryConfig} / {@link resolveBackoff}) so batch and\n * workflow steps retry identically. An item is `\"completed\"` when the\n * primitive's own result carries no `error`; a primitive that returns\n * `result.error` (rather than throwing) is treated as a failed attempt\n * and re-run under the same policy.\n *\n * Cancellation short-circuits: if the signal is already aborted on\n * entry the item is reported `\"cancelled\"` without executing; an abort\n * observed mid-flight surfaces as `\"cancelled\"` too.\n */\nexport async function runBatchItem<TInput, TOptions, TResult extends BaseResult>(\n  params: RunBatchItemParams<TInput, TOptions, TResult>,\n): Promise<BatchItemResult<TResult>> {\n  const { index, input, executable, signal } = params;\n\n  if (signal?.aborted) {\n    return { index, status: \"cancelled\", attempts: 0 };\n  }\n\n  const retryConfig = resolveRetryConfig({ retry: params.retry }, undefined);\n  const totalAttempts = Math.max(1, retryConfig.attempts ?? 1);\n\n  let lastResult: TResult | undefined;\n  let lastError: unknown;\n  let attemptsMade = 0;\n\n  for (let attempt = 1; attempt <= totalAttempts; attempt++) {\n    if (signal?.aborted) {\n      return { index, status: \"cancelled\", result: lastResult, attempts: attemptsMade };\n    }\n\n    attemptsMade = attempt;\n\n    try {\n      const result = await executable.execute(input, { signal } as TOptions);\n      lastResult = result;\n\n      if (!result.error) {\n        return { index, status: \"completed\", result, attempts: attempt };\n      }\n\n      lastError = result.error;\n    } catch (error) {\n      if (isAbortError(error)) {\n        return { index, status: \"cancelled\", result: lastResult, attempts: attempt };\n      }\n\n      lastError = error;\n    }\n\n    const canRetry =\n      attempt < totalAttempts &&\n      (retryConfig.retryOn ? retryConfig.retryOn(lastError, attempt) !== false : true);\n\n    if (!canRetry) {\n      break;\n    }\n\n    retryConfig.onRetry?.(attempt + 1, lastError);\n\n    const delay = resolveBackoff(attempt, retryConfig.backoff);\n    if (delay > 0) {\n      await sleep(delay, signal);\n    }\n  }\n\n  if (signal?.aborted) {\n    return { index, status: \"cancelled\", result: lastResult, attempts: attemptsMade };\n  }\n\n  return {\n    index,\n    status: \"failed\",\n    result: lastResult,\n    error: toAIError(lastError),\n    attempts: attemptsMade,\n  };\n}\n","/**\n * Run an async `worker` over every index `0..total-1` with at most\n * `limit` workers in flight at any moment, preserving nothing about\n * completion order (the worker is responsible for recording results\n * positionally). Resolves once every index has settled.\n *\n * A fixed pool of `limit` runners each pull the next unclaimed index\n * from a shared cursor — this keeps exactly `limit` items in flight\n * even when item durations vary wildly, unlike fixed-size chunking\n * which stalls a chunk on its slowest member.\n *\n * `limit` is clamped to `[1, total]`: a non-positive limit runs fully\n * serially, a limit larger than `total` simply starts every item.\n * `total === 0` resolves immediately.\n *\n * The worker must never reject — it owns its own try/catch and records\n * outcomes. A rejection here would abort sibling runners, which is not\n * the batch contract (one item's failure never cancels another's).\n */\nexport async function runWithConcurrency(\n  total: number,\n  limit: number,\n  worker: (index: number) => Promise<void>,\n): Promise<void> {\n  if (total <= 0) {\n    return;\n  }\n\n  const poolSize = Math.max(1, Math.min(limit, total));\n  let cursor = 0;\n\n  const runner = async (): Promise<void> => {\n    while (cursor < total) {\n      const index = cursor;\n      cursor += 1;\n      await worker(index);\n    }\n  };\n\n  const pool: Promise<void>[] = [];\n  for (let slot = 0; slot < poolSize; slot++) {\n    pool.push(runner());\n  }\n\n  await Promise.all(pool);\n}\n","import type { BaseReport } from \"../contracts/result/base-report.type\";\nimport { REPORT_SCHEMA_VERSION } from \"../contracts/result/base-report.type\";\nimport type { BaseResult } from \"../contracts/result/base-result.type\";\nimport type { ExecutableContract } from \"../contracts/executable.contract\";\nimport type { ExecuteResult } from \"../contracts/result/execute-result.type\";\nimport type { Usage } from \"../contracts/result/usage.type\";\nimport { accumulateCost } from \"../utils/compute-cost\";\nimport { generateRunId } from \"../utils/generate-run-id\";\nimport { stampReportLineage } from \"../utils/stamp-report-lineage\";\nimport type {\n  BatchItemResult,\n  BatchOptions,\n  BatchReport,\n  BatchResult,\n} from \"./batch.type\";\nimport { runBatchItem } from \"./run-batch-item\";\nimport { runWithConcurrency } from \"./run-with-concurrency\";\n\n/**\n * Run an executable AI primitive (agent, workflow, supervisor, tool,\n * or anything satisfying {@link ExecutableContract}) over a dataset\n * with bounded concurrency and per-item retry, returning per-item\n * outcomes plus rolled-up usage and a walkable report tree.\n *\n * **Role.** The fan-out primitive of `@warlock.js/ai`. Where an agent\n * runs once, `batch` runs the SAME executable N times — once per item\n * — and aggregates the results into the unified {@link ExecuteResult}\n * envelope, so a batch slots into cost dashboards and trace tooling\n * exactly like a single run does.\n *\n * **Isolation.** Items are independent: one item's failure (after its\n * retries are exhausted) never cancels a sibling, and the batch as a\n * whole never rejects — failures live on each {@link BatchItemResult}.\n * Reach for `result.report.failed` / `item.status` to inspect them.\n *\n * **Usage rollup.** `result.usage` and `result.report.usage` sum every\n * item's usage, satisfying the universal rollup invariant (\"own cost\n * + sum of children\"; a batch has zero own cost). Each item's own\n * report is attached under `report.children[]`, in original item\n * order, so a trace walker sees every run.\n *\n * @example\n * const result = await batch(summarizer, articles, {\n *   concurrency: 4,\n *   retry: { attempts: 3, backoff: \"exponential\" },\n *   onItem: (item) => log.info(\"batch\", \"item\", \"settled\", { index: item.index }),\n * });\n *\n * console.log(`${result.report.succeeded}/${result.report.total} ok`);\n * console.log(`${result.usage.total} tokens total`);\n */\nexport async function batch<TInput, TOptions, TResult extends BaseResult = ExecuteResult>(\n  executable: ExecutableContract<TInput, TOptions, TResult>,\n  items: readonly TInput[],\n  options: BatchOptions<TResult> = {},\n): Promise<BatchResult<TResult>> {\n  return new BatchRun(executable, items, options).run();\n}\n\n/**\n * Per-call orchestration state for one {@link batch} invocation.\n * Instantiated fresh inside the factory so the mutable accumulators\n * (`results`, `usage`) are never shared across batches. Unexported —\n * callers only ever see the plain {@link BatchResult}.\n */\nclass BatchRun<TInput, TOptions, TResult extends BaseResult> {\n  private readonly runId: string;\n  private readonly results: BatchItemResult<TResult>[];\n  private readonly startedAt = new Date().toISOString();\n  private readonly startPerf = performance.now();\n\n  public constructor(\n    private readonly executable: ExecutableContract<TInput, TOptions, TResult>,\n    private readonly items: readonly TInput[],\n    private readonly options: BatchOptions<TResult>,\n  ) {\n    this.runId = generateRunId(\"batch\");\n    this.results = new Array<BatchItemResult<TResult>>(items.length);\n  }\n\n  /**\n   * Dispatch every item through the concurrency pool, then assemble\n   * the rolled-up {@link BatchResult}. Runs once per `batch()` call.\n   */\n  public async run(): Promise<BatchResult<TResult>> {\n    const concurrency = this.options.concurrency ?? this.items.length;\n\n    await runWithConcurrency(this.items.length, concurrency, (index) =>\n      this.processItem(index),\n    );\n\n    return this.buildResult();\n  }\n\n  /**\n   * Run a single item with retry, record it positionally, then fire\n   * the `onItem` hook. A throw from the hook is swallowed — a progress\n   * callback must never break the batch.\n   */\n  private async processItem(index: number): Promise<void> {\n    const item = await runBatchItem({\n      index,\n      input: this.items[index] as TInput,\n      executable: this.executable,\n      retry: this.options.retry,\n      signal: this.options.signal,\n    });\n\n    this.results[index] = item;\n\n    if (this.options.onItem) {\n      try {\n        await this.options.onItem(item);\n      } catch {\n        // A progress hook must never break the batch — swallow its throw.\n      }\n    }\n  }\n\n  /**\n   * Fold the per-item outcomes into rolled-up usage, the child report\n   * list, and the final {@link BatchResult}, then stamp lineage across\n   * the whole subtree so every child shares this batch's root run id.\n   */\n  private buildResult(): BatchResult<TResult> {\n    const usage: Usage = { input: 0, output: 0, total: 0 };\n    const children: BaseReport[] = [];\n    const data: (unknown | undefined)[] = new Array(this.items.length).fill(undefined);\n\n    let succeeded = 0;\n    let failed = 0;\n    let cancelled = 0;\n\n    for (const item of this.results) {\n      if (item.status === \"completed\") {\n        succeeded += 1;\n      } else if (item.status === \"failed\") {\n        failed += 1;\n      } else {\n        cancelled += 1;\n      }\n\n      const itemResult = item.result;\n      if (itemResult) {\n        this.mergeUsage(usage, itemResult.usage);\n\n        if (\"report\" in itemResult && itemResult.report) {\n          children.push(itemResult.report as BaseReport);\n        }\n\n        if (item.status === \"completed\" && \"data\" in itemResult) {\n          data[item.index] = (itemResult as { data?: unknown }).data;\n        }\n      }\n    }\n\n    const report = this.buildReport(usage, children, { succeeded, failed, cancelled });\n\n    stampReportLineage(report, {\n      rootRunId: this.runId,\n      sessionId: this.options.sessionId,\n    });\n\n    return {\n      type: \"batch\",\n      data,\n      usage,\n      report,\n      items: this.results,\n    };\n  }\n\n  /**\n   * Add a child's usage into the running batch total. Scalar token\n   * channels sum directly; the optional cost breakdown merges via\n   * {@link accumulateCost} so a single unpriced child can't erase the\n   * cost of priced siblings. Optional token sub-channels\n   * (`cachedTokens`, etc.) accumulate only when some child reports\n   * them, preserving the \"never reported anywhere\" signal.\n   */\n  private mergeUsage(target: Usage, child: Usage): void {\n    target.input += child.input;\n    target.output += child.output;\n    target.total += child.total;\n\n    if (child.cachedTokens !== undefined) {\n      target.cachedTokens = (target.cachedTokens ?? 0) + child.cachedTokens;\n    }\n\n    if (child.reasoningTokens !== undefined) {\n      target.reasoningTokens = (target.reasoningTokens ?? 0) + child.reasoningTokens;\n    }\n\n    if (child.cacheWriteTokens !== undefined) {\n      target.cacheWriteTokens = (target.cacheWriteTokens ?? 0) + child.cacheWriteTokens;\n    }\n\n    const mergedCost = accumulateCost(target.cost, child.cost);\n    if (mergedCost !== undefined) {\n      target.cost = mergedCost;\n    }\n  }\n\n  /**\n   * Build the batch's own {@link BatchReport} node. `parentRunId` /\n   * `rootRunId` are placeholders here — {@link stampReportLineage}\n   * rewrites them across the whole subtree right after.\n   */\n  private buildReport(\n    usage: Usage,\n    children: BaseReport[],\n    counts: { succeeded: number; failed: number; cancelled: number },\n  ): BatchReport {\n    const status = counts.failed > 0 || counts.cancelled > 0 ? \"failed\" : \"completed\";\n\n    return {\n      runId: this.runId,\n      rootRunId: this.runId,\n      name: this.options.name ?? \"batch\",\n      type: \"batch\",\n      status,\n      startedAt: this.startedAt,\n      endedAt: new Date().toISOString(),\n      duration: performance.now() - this.startPerf,\n      usage,\n      children,\n      total: this.items.length,\n      succeeded: counts.succeeded,\n      failed: counts.failed,\n      cancelled: counts.cancelled,\n      reportSchemaVersion: REPORT_SCHEMA_VERSION,\n    };\n  }\n}\n","import type {\n  CheckpointRecord,\n  CheckpointStore,\n} from \"../contracts/orchestrator/checkpoint-store.contract\";\n\n/**\n * Composite key for the in-memory session index — one bucket per\n * `(orchestratorName, sessionId)` pair. The separator can't appear in\n * the segments in practice (names are identifiers, sessionIds are\n * dev-owned opaque strings), so a simple join is collision-safe enough\n * for an in-process store.\n */\nfunction bucketKey(orchestratorName: string, sessionId: string): string {\n  return `${orchestratorName}\u0000${sessionId}`;\n}\n\n/**\n * In-memory {@link CheckpointStore} — append-only session checkpoints\n * held in a process-local `Map`, never persisted to disk.\n *\n * Owns: the per-session bucket of {@link CheckpointRecord} rows and the\n * \"latest turn wins\" load semantics. Does NOT own: durability,\n * cross-process sharing, or TTL eviction — it is the zero-config\n * default for dev, tests, and single-process apps that don't need\n * resume across restarts. Reach for `ai.checkpoint.pg()` /\n * `ai.checkpoint.redis()` (Phase 2) when durability matters.\n *\n * Front it with the {@link memory} factory — callers never `new` it.\n */\nclass MemoryCheckpointStore implements CheckpointStore {\n  /** Per-session append-only row buckets, keyed by `(orchestratorName, sessionId)`. */\n  private readonly sessions = new Map<string, CheckpointRecord[]>();\n\n  /**\n   * Return the latest checkpoint (highest `turn_index`) for a session,\n   * or `undefined` when the session has no rows. Rows are appended in\n   * turn order, so the last element is the latest — no scan needed.\n   */\n  public async load(\n    orchestratorName: string,\n    sessionId: string,\n  ): Promise<CheckpointRecord | undefined> {\n    const rows = this.sessions.get(bucketKey(orchestratorName, sessionId));\n\n    if (!rows || rows.length === 0) {\n      return undefined;\n    }\n\n    return rows[rows.length - 1];\n  }\n\n  /**\n   * Append a checkpoint row to its session bucket. Append-only — an\n   * existing `turn_index` is never overwritten; a fresh row is pushed.\n   */\n  public async save(record: CheckpointRecord): Promise<void> {\n    const key = bucketKey(record.orchestrator_name, record.session_id);\n    const rows = this.sessions.get(key);\n\n    if (rows) {\n      rows.push(record);\n\n      return;\n    }\n\n    this.sessions.set(key, [record]);\n  }\n\n  /**\n   * Drop every row for a session, ending it.\n   */\n  public async delete(\n    orchestratorName: string,\n    sessionId: string,\n  ): Promise<void> {\n    this.sessions.delete(bucketKey(orchestratorName, sessionId));\n  }\n\n  /**\n   * List the session ids known for an orchestrator, optionally filtered\n   * by a session-id prefix. Reads the latest row of each bucket so the\n   * authoritative `session_id` is returned even if the key encoding\n   * ever changes.\n   */\n  public async list(\n    orchestratorName: string,\n    prefix?: string,\n  ): Promise<string[]> {\n    const sessionIds: string[] = [];\n\n    for (const rows of this.sessions.values()) {\n      const latest = rows[rows.length - 1];\n\n      if (!latest || latest.orchestrator_name !== orchestratorName) {\n        continue;\n      }\n\n      if (prefix !== undefined && !latest.session_id.startsWith(prefix)) {\n        continue;\n      }\n\n      sessionIds.push(latest.session_id);\n    }\n\n    return sessionIds;\n  }\n\n  /**\n   * Drop every row for a session whose `turn_index` is strictly below\n   * `keepBeforeTurnIndex`, enforcing the `keepSnapshots` retention bound\n   * (§4 Phase 6, Q20). Rebuilds the bucket in place with the surviving\n   * tail; an emptied bucket is removed so `list()` no longer reports the\n   * session.\n   */\n  public async prune(\n    orchestratorName: string,\n    sessionId: string,\n    keepBeforeTurnIndex: number,\n  ): Promise<void> {\n    const key = bucketKey(orchestratorName, sessionId);\n    const rows = this.sessions.get(key);\n\n    if (!rows) {\n      return;\n    }\n\n    const kept = rows.filter((row) => row.turn_index >= keepBeforeTurnIndex);\n\n    if (kept.length === 0) {\n      this.sessions.delete(key);\n\n      return;\n    }\n\n    if (kept.length !== rows.length) {\n      this.sessions.set(key, kept);\n    }\n  }\n\n  /**\n   * The memory store has no backing table — there is nothing to\n   * migrate. Returns an empty string so callers can treat `schema()`\n   * uniformly across drivers.\n   */\n  public schema(): string {\n    return \"\";\n  }\n}\n\n/**\n * Create an in-memory {@link CheckpointStore}. Zero-config — no client,\n * no connection. Suitable for dev, tests, and single-process apps that\n * don't need resume across restarts.\n *\n * @example\n * import { ai } from \"@warlock.js/ai\";\n *\n * const orchestrator = ai.orchestrator({\n *   name: \"support\",\n *   intents: { ... },\n *   checkpointStore: ai.checkpoint.memory(),\n * });\n */\nexport function memory(): CheckpointStore {\n  return new MemoryCheckpointStore();\n}\n","import type {\n  CheckpointRecord,\n  CheckpointStore,\n} from \"../contracts/orchestrator/checkpoint-store.contract\";\nimport type { PgClientLike } from \"../contracts/orchestrator/snapshot-store.contract\";\n\n/**\n * Options for the Postgres {@link CheckpointStore} (orchestrator.md §8.3).\n *\n * The dev owns the connection — `@warlock.js/ai` takes no peer dep on\n * `pg` and never opens or closes the client. A single `pg.Pool` can\n * back both the cache and the orchestrator stores.\n */\nexport type PgCheckpointOptions = {\n  /** An already-built `pg.Pool` / `pg.Client` — anything matching {@link PgClientLike}. */\n  client: PgClientLike;\n  /** Backing table name. Defaults to `warlock_orchestrator_sessions` (§8.6). Must be a safe SQL identifier. */\n  table?: string;\n  /** Idle-row TTL in seconds. When set, rows older than the TTL are eligible for cleanup on prune. */\n  ttl?: number;\n};\n\n/**\n * Default backing table — matches the §8.6 reference DDL verbatim so a\n * stock migration provisions the store with no extra config.\n */\nconst DEFAULT_TABLE = \"warlock_orchestrator_sessions\";\n\n/**\n * Allowed characters in a Postgres identifier (table name). The table\n * name is interpolated into DDL/DML, so anything outside this\n * conservative ASCII subset is rejected — interpolating an arbitrary\n * string would be a SQL-injection footgun (mirrors `PgCacheDriver`).\n */\nconst SAFE_IDENTIFIER = /^[A-Za-z_][A-Za-z0-9_]*$/;\n\n/**\n * Coerce a Postgres `INTEGER` column back to a number. `pg` hands back\n * `INTEGER` as a JS number already, but some pool wrappers surface it\n * as a string — normalize defensively so `turn_index` arithmetic and\n * the latest-turn ordering never compare strings.\n */\nfunction toNumber(value: unknown): number {\n  return typeof value === \"string\" ? Number(value) : (value as number);\n}\n\n/**\n * Coerce a nullable Postgres integer column to `number | null`.\n */\nfunction toNullableNumber(value: unknown): number | null {\n  return value === null || value === undefined ? null : toNumber(value);\n}\n\n/**\n * Coerce a Postgres timestamp/text column to an ISO string. `pg`\n * returns `TIMESTAMPTZ` as a `Date`; normalize to the ISO wire shape\n * the {@link CheckpointRecord} contract declares.\n */\nfunction toIso(value: unknown): string {\n  if (value instanceof Date) {\n    return value.toISOString();\n  }\n\n  return value as string;\n}\n\n/**\n * Coerce a nullable Postgres timestamp column to `string | null`.\n */\nfunction toNullableIso(value: unknown): string | null {\n  if (value === null || value === undefined) {\n    return null;\n  }\n\n  return toIso(value);\n}\n\n/**\n * Decode the single `last_route` `TEXT` column back to the\n * `string | string[] | null` shape the contract declares. A fan-out\n * array is written JSON-encoded (it starts with `[`), so a leading `[`\n * is the signal to parse; any other value is a single intent stored\n * verbatim. Symmetric with {@link PgCheckpointStore.serializeRoute}.\n */\nfunction deserializeRoute(value: unknown): string | string[] | null {\n  if (value === null || value === undefined) {\n    return null;\n  }\n\n  const route = value as string;\n\n  if (route.startsWith(\"[\")) {\n    return JSON.parse(route) as string[];\n  }\n\n  return route;\n}\n\n/**\n * Map a raw DB row to a {@link CheckpointRecord}. Column names match\n * the §8.6 DDL 1:1, so this is a typed projection plus the defensive\n * coercions a heterogeneous `pg` client population needs.\n */\nfunction rowToRecord(row: Record<string, unknown>): CheckpointRecord {\n  const state =\n    typeof row.state === \"string\" ? JSON.parse(row.state) : row.state;\n\n  return {\n    orchestrator_name: row.orchestrator_name as string,\n    session_id: row.session_id as string,\n    turn_index: toNumber(row.turn_index),\n    state,\n    last_route: deserializeRoute(row.last_route),\n    signature: row.signature as string,\n    version: (row.version as string | null) ?? null,\n    summarized_through: toNullableNumber(row.summarized_through),\n    lock_acquired_at: toNullableIso(row.lock_acquired_at),\n    lock_expires_at: toNullableIso(row.lock_expires_at),\n    saved_at: toIso(row.saved_at),\n  };\n}\n\n/**\n * Postgres-backed {@link CheckpointStore} (orchestrator.md §8.2, §8.6).\n *\n * Owns: append-only checkpoint rows keyed by\n * `(orchestrator_name, session_id, turn_index)`, the \"latest turn wins\"\n * load, the §8.6 DDL via {@link PgCheckpointStore.schema}, and the\n * §4-Phase-6 retention prune. Does NOT own: the connection lifecycle\n * (the dev passes a client and keeps it), schema migration (the dev\n * runs `schema()` through their own tool — never auto-migrated, §8.5),\n * or the `keepSnapshots` policy itself (that lives on the orchestrator\n * config; the orchestrator passes the resolved bound into\n * {@link PgCheckpointStore.prune}).\n *\n * Front it with the {@link pg} factory — callers never `new` it.\n */\nclass PgCheckpointStore implements CheckpointStore {\n  /** The dev-supplied `pg.Pool` / `pg.Client`. Never closed by the store. */\n  private readonly client: PgClientLike;\n\n  /** Validated backing table name, safe to interpolate into SQL. */\n  private readonly table: string;\n\n  /** Idle-row TTL in seconds, or `undefined` for no expiry. */\n  private ttl?: number;\n\n  public constructor(options: PgCheckpointOptions) {\n    if (!options || typeof options.client?.query !== \"function\") {\n      throw new TypeError(\n        \"ai.checkpoint.pg requires a 'client' option implementing { query(text, params) } — pass a pg.Pool or pg.Client.\",\n      );\n    }\n\n    const table = options.table ?? DEFAULT_TABLE;\n\n    if (!SAFE_IDENTIFIER.test(table)) {\n      throw new TypeError(\n        `ai.checkpoint.pg: invalid table name '${table}'. Allowed: [A-Za-z_][A-Za-z0-9_]*.`,\n      );\n    }\n\n    this.client = options.client;\n    this.table = table;\n    this.ttl = options.ttl;\n  }\n\n  /**\n   * Return the latest checkpoint (highest `turn_index`) for a session,\n   * or `undefined` when the store has never seen it. The `(name,\n   * session_id, turn_index DESC)` lookup index keeps this O(1) on the\n   * latest row (§8.6).\n   */\n  public async load(\n    orchestratorName: string,\n    sessionId: string,\n  ): Promise<CheckpointRecord | undefined> {\n    const { rows } = await this.client.query(\n      `SELECT * FROM ${this.table}\n       WHERE orchestrator_name = $1 AND session_id = $2\n       ORDER BY turn_index DESC\n       LIMIT 1`,\n      [orchestratorName, sessionId],\n    );\n\n    if (rows.length === 0) {\n      return undefined;\n    }\n\n    return rowToRecord(rows[0] as Record<string, unknown>);\n  }\n\n  /**\n   * Persist a fresh checkpoint row. Append-only — an existing\n   * `turn_index` is never overwritten; the PK collision surfaces as a\n   * Postgres error rather than a silent clobber (§4 Phase 6, Q15).\n   */\n  public async save(record: CheckpointRecord): Promise<void> {\n    await this.client.query(\n      `INSERT INTO ${this.table} (\n         orchestrator_name, session_id, turn_index, state, last_route,\n         signature, version, summarized_through, lock_acquired_at,\n         lock_expires_at, saved_at\n       )\n       VALUES ($1, $2, $3, $4::jsonb, $5, $6, $7, $8, $9, $10, $11)`,\n      [\n        record.orchestrator_name,\n        record.session_id,\n        record.turn_index,\n        JSON.stringify(record.state),\n        this.serializeRoute(record.last_route),\n        record.signature,\n        record.version,\n        record.summarized_through,\n        record.lock_acquired_at,\n        record.lock_expires_at,\n        record.saved_at,\n      ],\n    );\n  }\n\n  /**\n   * Delete every checkpoint row for a session, ending it.\n   */\n  public async delete(\n    orchestratorName: string,\n    sessionId: string,\n  ): Promise<void> {\n    await this.client.query(\n      `DELETE FROM ${this.table}\n       WHERE orchestrator_name = $1 AND session_id = $2`,\n      [orchestratorName, sessionId],\n    );\n  }\n\n  /**\n   * List the distinct session ids known for an orchestrator, optionally\n   * filtered by a session-id prefix. Used by the production boot-drain\n   * loop (§9.3). The prefix is matched with `LIKE`, escaping the SQL\n   * wildcards so a literal `_` or `%` in the prefix is not treated as a\n   * pattern.\n   */\n  public async list(\n    orchestratorName: string,\n    prefix?: string,\n  ): Promise<string[]> {\n    if (prefix === undefined) {\n      const { rows } = await this.client.query(\n        `SELECT DISTINCT session_id FROM ${this.table}\n         WHERE orchestrator_name = $1`,\n        [orchestratorName],\n      );\n\n      return rows.map((row) => (row as Record<string, unknown>).session_id as string);\n    }\n\n    const escaped = prefix\n      .replace(/\\\\/g, \"\\\\\\\\\")\n      .replace(/_/g, \"\\\\_\")\n      .replace(/%/g, \"\\\\%\");\n\n    const { rows } = await this.client.query(\n      `SELECT DISTINCT session_id FROM ${this.table}\n       WHERE orchestrator_name = $1 AND session_id LIKE $2 ESCAPE '\\\\'`,\n      [orchestratorName, `${escaped}%`],\n    );\n\n    return rows.map((row) => (row as Record<string, unknown>).session_id as string);\n  }\n\n  /**\n   * Prune retained turns for a session down to the most recent\n   * `keepSnapshots` rows (orchestrator.md §4 Phase 6 / §15.2). Deletes\n   * every row with `turn_index < (max_turn_index - keepSnapshots)`. The\n   * orchestrator calls this synchronously after a successful\n   * {@link save} when `keepSnapshots` is a finite number; `\"all\"`\n   * retention skips the call entirely. Additive to the\n   * {@link CheckpointStore} contract — the contract carries no prune\n   * hook, so the policy stays on the orchestrator and the store only\n   * executes the bounded delete.\n   */\n  public async prune(\n    orchestratorName: string,\n    sessionId: string,\n    keepSnapshots: number,\n  ): Promise<void> {\n    if (!Number.isFinite(keepSnapshots) || keepSnapshots < 0) {\n      return;\n    }\n\n    await this.client.query(\n      `DELETE FROM ${this.table}\n       WHERE orchestrator_name = $1\n         AND session_id = $2\n         AND turn_index < (\n           SELECT max(turn_index) - $3\n           FROM ${this.table}\n           WHERE orchestrator_name = $1 AND session_id = $2\n         )`,\n      [orchestratorName, sessionId, keepSnapshots],\n    );\n  }\n\n  /**\n   * Return the §8.6 reference DDL for this store's backing table,\n   * interpolating the configured table name. The dev runs it through\n   * their migration tool — the framework never auto-migrates (§8.5).\n   *\n   * @example\n   * await pool.query(store.schema());\n   */\n  public schema(): string {\n    return [\n      `CREATE TABLE IF NOT EXISTS ${this.table} (`,\n      `  orchestrator_name    TEXT NOT NULL,`,\n      `  session_id           TEXT NOT NULL,`,\n      `  turn_index           INTEGER NOT NULL,`,\n      `  state                JSONB NOT NULL,`,\n      `  last_route           TEXT,`,\n      `  signature            TEXT NOT NULL,`,\n      `  version              TEXT,`,\n      `  summarized_through   INTEGER,`,\n      `  lock_acquired_at     TIMESTAMPTZ,`,\n      `  lock_expires_at      TIMESTAMPTZ,`,\n      `  saved_at             TIMESTAMPTZ NOT NULL DEFAULT now(),`,\n      `  PRIMARY KEY (orchestrator_name, session_id, turn_index)`,\n      `);`,\n      `CREATE INDEX IF NOT EXISTS idx_${this.table}_saved_at`,\n      `  ON ${this.table} (saved_at);`,\n      `CREATE INDEX IF NOT EXISTS idx_${this.table}_lookup`,\n      `  ON ${this.table} (orchestrator_name, session_id, turn_index DESC);`,\n    ].join(\"\\n\");\n  }\n\n  /**\n   * Set the idle-row TTL (§8.2). Stored for prune-time cleanup; the\n   * store never opens a background timer.\n   */\n  public setOptions(options: { ttl?: number }): void {\n    this.ttl = options.ttl;\n  }\n\n  /**\n   * `last_route` rides a single `TEXT` column. A fan-out array is\n   * JSON-encoded so it round-trips through one column without a schema\n   * change; a single intent (an identifier — never starts with `[`) is\n   * stored verbatim. {@link deserializeRoute} reverses this on load.\n   */\n  private serializeRoute(route: string | string[] | null): string | null {\n    if (route === null) {\n      return null;\n    }\n\n    if (Array.isArray(route)) {\n      return JSON.stringify(route);\n    }\n\n    return route;\n  }\n}\n\n/**\n * Create a Postgres-backed {@link CheckpointStore} (orchestrator.md\n * §8.3). The dev installs `pg` and passes a `pg.Pool` / `pg.Client` —\n * `@warlock.js/ai` never imports `pg`. Run {@link CheckpointStore.schema}\n * through your migration tool once before use; the store never\n * auto-migrates.\n *\n * @example\n * import { Pool } from \"pg\";\n * import { ai } from \"@warlock.js/ai\";\n *\n * const pool = new Pool({ connectionString: process.env.DATABASE_URL });\n * const store = ai.checkpoint.pg({ client: pool });\n *\n * // Once, via your migration tooling:\n * // await pool.query(store.schema());\n */\nexport function pg(options: PgCheckpointOptions): CheckpointStore {\n  return new PgCheckpointStore(options);\n}\n","import type {\n  CheckpointRecord,\n  CheckpointStore,\n} from \"../contracts/orchestrator/checkpoint-store.contract\";\nimport type { RedisClientLike } from \"../contracts/orchestrator/snapshot-store.contract\";\n\n/**\n * Options for the Redis {@link CheckpointStore} (orchestrator.md §8.3).\n *\n * The dev owns the connection — `@warlock.js/ai` takes no peer dep on\n * `redis` and never opens or closes the client.\n */\nexport type RedisCheckpointOptions = {\n  /** An already-connected `redis` client — anything matching {@link RedisClientLike}. */\n  client: RedisClientLike;\n  /**\n   * Key prefix for every key this store writes. Lets one Redis database\n   * back multiple stores without collision. Defaults to\n   * `warlock:orchestrator`.\n   */\n  prefix?: string;\n  /** Idle-key TTL in seconds. When set, every written key expires after the TTL. */\n  ttl?: number;\n};\n\n/**\n * Default key prefix — namespaces the store's keys inside a shared\n * Redis database.\n */\nconst DEFAULT_PREFIX = \"warlock:orchestrator\";\n\n/**\n * Per-session document persisted under one Redis key: the append-only\n * list of {@link CheckpointRecord} rows in turn order, mirroring the\n * Postgres append-only PK shape (§8.6) inside a single JSON value so\n * the store needs only `get`/`set`/`del` from {@link RedisClientLike}.\n */\ntype SessionDocument = {\n  rows: CheckpointRecord[];\n};\n\n/**\n * Per-orchestrator index document: the set of live session ids. Kept as\n * a JSON array because {@link RedisClientLike} exposes no `keys` / `scan`\n * — enumeration for the §9.3 boot drain must be self-maintained.\n */\ntype IndexDocument = {\n  sessionIds: string[];\n};\n\n/**\n * Redis-backed {@link CheckpointStore} (orchestrator.md §8.2).\n *\n * Owns: the per-session append-only document, a per-orchestrator\n * session-id index (so {@link RedisCheckpointStore.list} works without\n * `KEYS`/`SCAN`), the \"latest turn wins\" load, and the §4-Phase-6\n * retention prune. Does NOT own: durability guarantees beyond Redis's\n * own, the connection lifecycle (the dev passes a client), or the\n * `keepSnapshots` policy (that lives on the orchestrator config).\n *\n * Because {@link RedisClientLike} is intentionally minimal (`get` /\n * `set` / `del` only — §8.4), the store models a session as a single\n * JSON document rather than one Redis key per turn. This keeps every\n * operation a single round-trip and avoids depending on key scanning,\n * at the cost of read-modify-write on `save`. Callers must serialize\n * traffic per `sessionId` anyway (§17 \"two turns racing\"), so the\n * read-modify-write is safe under that contract.\n *\n * Front it with the {@link redis} factory — callers never `new` it.\n */\nclass RedisCheckpointStore implements CheckpointStore {\n  /** The dev-supplied redis client. Never disconnected by the store. */\n  private readonly client: RedisClientLike;\n\n  /** Key prefix namespacing every key this store writes. */\n  private readonly prefix: string;\n\n  /** Idle-key TTL in seconds, or `undefined` for no expiry. */\n  private ttl?: number;\n\n  public constructor(options: RedisCheckpointOptions) {\n    if (\n      !options ||\n      typeof options.client?.get !== \"function\" ||\n      typeof options.client?.set !== \"function\" ||\n      typeof options.client?.del !== \"function\"\n    ) {\n      throw new TypeError(\n        \"ai.checkpoint.redis requires a 'client' option implementing { get, set, del } — pass a connected redis client.\",\n      );\n    }\n\n    this.client = options.client;\n    this.prefix = options.prefix ?? DEFAULT_PREFIX;\n    this.ttl = options.ttl;\n  }\n\n  /**\n   * Return the latest checkpoint (highest `turn_index`) for a session,\n   * or `undefined` when the session has no document. Rows are appended\n   * in turn order, so the last element is the latest.\n   */\n  public async load(\n    orchestratorName: string,\n    sessionId: string,\n  ): Promise<CheckpointRecord | undefined> {\n    const document = await this.readSession(orchestratorName, sessionId);\n\n    if (!document || document.rows.length === 0) {\n      return undefined;\n    }\n\n    return document.rows[document.rows.length - 1];\n  }\n\n  /**\n   * Append a checkpoint row to its session document, creating the\n   * document and indexing the session id on first write. Append-only —\n   * an existing `turn_index` is never overwritten; a fresh row is\n   * pushed (§4 Phase 6, Q15).\n   */\n  public async save(record: CheckpointRecord): Promise<void> {\n    const { orchestrator_name, session_id } = record;\n\n    const document =\n      (await this.readSession(orchestrator_name, session_id)) ?? { rows: [] };\n\n    document.rows.push(record);\n\n    await this.writeSession(orchestrator_name, session_id, document);\n    await this.indexSession(orchestrator_name, session_id);\n  }\n\n  /**\n   * Drop a session document and de-index its session id.\n   */\n  public async delete(\n    orchestratorName: string,\n    sessionId: string,\n  ): Promise<void> {\n    await this.client.del(this.sessionKey(orchestratorName, sessionId));\n    await this.deindexSession(orchestratorName, sessionId);\n  }\n\n  /**\n   * List the session ids known for an orchestrator, optionally filtered\n   * by a session-id prefix. Reads the self-maintained index document\n   * (§9.3 boot drain).\n   */\n  public async list(\n    orchestratorName: string,\n    prefix?: string,\n  ): Promise<string[]> {\n    const index = await this.readIndex(orchestratorName);\n\n    if (prefix === undefined) {\n      return [...index.sessionIds];\n    }\n\n    return index.sessionIds.filter((sessionId) =>\n      sessionId.startsWith(prefix),\n    );\n  }\n\n  /**\n   * Prune retained turns for a session down to the most recent\n   * `keepSnapshots` rows (orchestrator.md §4 Phase 6 / §15.2). Drops\n   * every row whose `turn_index` is below `(max_turn_index -\n   * keepSnapshots)`. The orchestrator calls this synchronously after a\n   * successful {@link save} when `keepSnapshots` is a finite number;\n   * `\"all\"` retention skips the call. Additive to the\n   * {@link CheckpointStore} contract — the policy stays on the\n   * orchestrator and the store only executes the bounded trim.\n   */\n  public async prune(\n    orchestratorName: string,\n    sessionId: string,\n    keepSnapshots: number,\n  ): Promise<void> {\n    if (!Number.isFinite(keepSnapshots) || keepSnapshots < 0) {\n      return;\n    }\n\n    const document = await this.readSession(orchestratorName, sessionId);\n\n    if (!document || document.rows.length === 0) {\n      return;\n    }\n\n    const maxTurnIndex = document.rows[document.rows.length - 1].turn_index;\n    const threshold = maxTurnIndex - keepSnapshots;\n\n    const kept = document.rows.filter((row) => row.turn_index >= threshold);\n\n    if (kept.length === document.rows.length) {\n      return;\n    }\n\n    await this.writeSession(orchestratorName, sessionId, { rows: kept });\n  }\n\n  /**\n   * The Redis store has no relational table — there is nothing to\n   * migrate. Returns an empty string so callers can treat `schema()`\n   * uniformly across drivers (mirrors the memory store).\n   */\n  public schema(): string {\n    return \"\";\n  }\n\n  /**\n   * Set the idle-key TTL (§8.2). Applied on every subsequent write; the\n   * store never opens a background timer.\n   */\n  public setOptions(options: { ttl?: number }): void {\n    this.ttl = options.ttl;\n  }\n\n  /**\n   * Read and parse a session document, or `undefined` when the key is\n   * absent.\n   */\n  private async readSession(\n    orchestratorName: string,\n    sessionId: string,\n  ): Promise<SessionDocument | undefined> {\n    const raw = await this.client.get(\n      this.sessionKey(orchestratorName, sessionId),\n    );\n\n    if (raw === null) {\n      return undefined;\n    }\n\n    return JSON.parse(raw) as SessionDocument;\n  }\n\n  /**\n   * Serialize and persist a session document, honoring the configured\n   * idle TTL when set.\n   */\n  private async writeSession(\n    orchestratorName: string,\n    sessionId: string,\n    document: SessionDocument,\n  ): Promise<void> {\n    await this.write(\n      this.sessionKey(orchestratorName, sessionId),\n      JSON.stringify(document),\n    );\n  }\n\n  /**\n   * Read and parse the per-orchestrator index document, defaulting to an\n   * empty index when absent.\n   */\n  private async readIndex(orchestratorName: string): Promise<IndexDocument> {\n    const raw = await this.client.get(this.indexKey(orchestratorName));\n\n    if (raw === null) {\n      return { sessionIds: [] };\n    }\n\n    return JSON.parse(raw) as IndexDocument;\n  }\n\n  /**\n   * Add a session id to the per-orchestrator index, no-op when already\n   * present.\n   */\n  private async indexSession(\n    orchestratorName: string,\n    sessionId: string,\n  ): Promise<void> {\n    const index = await this.readIndex(orchestratorName);\n\n    if (index.sessionIds.includes(sessionId)) {\n      return;\n    }\n\n    index.sessionIds.push(sessionId);\n\n    await this.write(this.indexKey(orchestratorName), JSON.stringify(index));\n  }\n\n  /**\n   * Remove a session id from the per-orchestrator index, no-op when\n   * absent.\n   */\n  private async deindexSession(\n    orchestratorName: string,\n    sessionId: string,\n  ): Promise<void> {\n    const index = await this.readIndex(orchestratorName);\n    const next = index.sessionIds.filter((id) => id !== sessionId);\n\n    if (next.length === index.sessionIds.length) {\n      return;\n    }\n\n    await this.write(\n      this.indexKey(orchestratorName),\n      JSON.stringify({ sessionIds: next }),\n    );\n  }\n\n  /**\n   * Write a key, attaching the `EX` expiry option when an idle TTL is\n   * configured. The TTL flows through {@link RedisClientLike.set}'s\n   * variadic args as node-redis's `{ EX }` option object.\n   */\n  private async write(key: string, value: string): Promise<void> {\n    if (this.ttl !== undefined && this.ttl > 0) {\n      await this.client.set(key, value, { EX: this.ttl });\n\n      return;\n    }\n\n    await this.client.set(key, value);\n  }\n\n  /**\n   * Key for a session document — `<prefix>:session:<name>:<sessionId>`.\n   */\n  private sessionKey(orchestratorName: string, sessionId: string): string {\n    return `${this.prefix}:session:${orchestratorName}:${sessionId}`;\n  }\n\n  /**\n   * Key for a per-orchestrator session-id index —\n   * `<prefix>:index:<name>`.\n   */\n  private indexKey(orchestratorName: string): string {\n    return `${this.prefix}:index:${orchestratorName}`;\n  }\n}\n\n/**\n * Create a Redis-backed {@link CheckpointStore} (orchestrator.md §8.3).\n * The dev installs `redis` and passes a connected client —\n * `@warlock.js/ai` never imports `redis`. {@link CheckpointStore.schema}\n * returns an empty string; Redis needs no migration.\n *\n * @example\n * import { createClient } from \"redis\";\n * import { ai } from \"@warlock.js/ai\";\n *\n * const client = createClient();\n * await client.connect();\n *\n * const store = ai.checkpoint.redis({ client });\n */\nexport function redis(options: RedisCheckpointOptions): CheckpointStore {\n  return new RedisCheckpointStore(options);\n}\n","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","import { judge } from \"./judge-scorer\";\nimport { contains, exact, predicate } from \"./scorers\";\n\n// Runner — wired into AgentContract.eval() by the agent factory.\nexport { runEval } from \"./eval-runner\";\n\n// Scorer factories — re-exported individually for direct import.\nexport { contains, exact, predicate } from \"./scorers\";\nexport type { EvalPredicate } from \"./scorers\";\nexport { judge } from \"./judge-scorer\";\n\n/**\n * Built-in eval scorer factories, surfaced on `ai.eval.*`.\n *\n * - `exact()` — pass when output equals the case `expected` (trimmed,\n *   case-insensitive; structured values compared by canonical JSON).\n * - `contains()` — pass when `expected` appears as a substring.\n * - `predicate(fn)` — wrap an arbitrary boolean assertion.\n * - `judge(config)` — LLM-as-judge scoring against a rubric.\n *\n * @example\n * await myAgent.eval({\n *   cases: [{ name: \"q\", input: \"Capital of Egypt?\", expected: \"Cairo\" }],\n *   scorers: [ai.eval.contains()],\n * });\n */\nexport const evalScorers = {\n  exact,\n  contains,\n  predicate,\n  judge,\n};\n","/**\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","import type { CacheDriver, CacheSimilarHit } from \"@warlock.js/cache\";\nimport type { EmbedderContract } from \"../contracts/embedder.contract\";\nimport type {\n  MemoryItem,\n  RecalledMemory,\n} from \"../contracts/memory/memory-item.type\";\nimport { deriveMemoryId } from \"./derive-id\";\n\n/**\n * Shape persisted per episode. `ts` is the wall-clock time the episode\n * was remembered — the basis for the recency half of the blended recall\n * score. The vector lives in the driver's index (via `set({ vector })`),\n * so it is not duplicated here.\n */\ntype StoredEpisode = {\n  id: string;\n  text: string;\n  ts: number;\n  metadata?: Record<string, unknown>;\n};\n\n/**\n * How many extra candidates to pull from `similar()` before re-ranking by\n * the recency-blended score and slicing to `k`. Recency can promote a\n * slightly-less-similar-but-recent episode past a stale exact match, so\n * the raw top-`k` by similarity alone would miss it — overscan, then\n * re-rank.\n */\nconst RECALL_OVERSCAN = 5;\n\n/**\n * Episodic recall tier (memory core M2).\n *\n * Holds a durable, timestamped log of *what happened* — events/episodes —\n * and retrieves the ones most relevant to a query, **blended with\n * recency** so recent episodes outrank stale ones at equal similarity.\n * That recency weighting is the whole difference from the {@link\n * import(\"./semantic-memory\").SemanticMemory} tier (pure similarity over\n * timeless facts): episodic memory is time-anchored.\n *\n * Like the semantic tier it delegates the similarity search to the\n * `@warlock.js/cache` driver's `similar()` and never implements ANN\n * itself; it adds a stored `ts` per entry and a decay curve at recall.\n * The blended `score` stays in `[0, 1]` so a consumer can merge episodic\n * hits with the other tiers and sort on one field.\n *\n * Internal to the `memory()` factory — never exported on the package\n * surface.\n */\nexport class EpisodicMemory {\n  public constructor(\n    private readonly embedder: EmbedderContract,\n    private readonly store: CacheDriver<any, any>,\n    private readonly namespace: string,\n    private readonly recencyWeight: number,\n    private readonly halfLifeMs: number,\n    private readonly now: () => number,\n  ) {}\n\n  /**\n   * Embed the episode text and index it under a namespaced, id-derived\n   * key, stamping the current time. Re-remembering the same id overwrites\n   * the prior entry (and refreshes its timestamp).\n   */\n  public async remember(item: MemoryItem): Promise<void> {\n    const id = item.id ?? deriveMemoryId(item.text);\n    const { vector } = await this.embedder.embed(item.text);\n\n    const value: StoredEpisode = {\n      id,\n      text: item.text,\n      ts: this.now(),\n      metadata: item.metadata,\n    };\n\n    await this.store.set(this.keyFor(id), value, { vector });\n  }\n\n  /**\n   * Embed `query`, pull the nearest episodes clearing the similarity\n   * `threshold`, then re-rank each by a recency-blended score before\n   * returning the top `k`. The similarity floor still gates relevance —\n   * recency only reorders episodes that already cleared it, it never\n   * surfaces an irrelevant-but-recent one.\n   */\n  public async recall(\n    query: string,\n    k: number,\n    threshold: number,\n  ): Promise<RecalledMemory[]> {\n    const { vector } = await this.embedder.embed(query);\n\n    const hits = await this.store.similar<StoredEpisode>(vector, {\n      topK: Math.max(k * RECALL_OVERSCAN, k),\n      threshold,\n    });\n\n    const prefix = `${this.namespace}.`;\n    const now = this.now();\n\n    return hits\n      .filter((hit: CacheSimilarHit<StoredEpisode>) =>\n        hit.key.startsWith(prefix),\n      )\n      .map((hit: CacheSimilarHit<StoredEpisode>) => ({\n        id: hit.value.id,\n        text: hit.value.text,\n        tier: \"episodic\" as const,\n        score: this.blend(hit.score, hit.value.ts, now),\n        metadata: hit.value.metadata,\n      }))\n      .sort((first, second) => second.score - first.score)\n      .slice(0, k);\n  }\n\n  /** Drop every episode written under this instance's namespace. */\n  public async clear(): Promise<void> {\n    await this.store.removeNamespace(this.namespace);\n  }\n\n  /**\n   * Combine raw similarity with an exponential recency decay:\n   * `(1 - w)·similarity + w·0.5^(age / halfLife)`. A just-remembered\n   * episode contributes a recency of `1`; one `halfLife` old, `0.5`;\n   * older trends toward `0`. With `recencyWeight` 0 the score is pure\n   * similarity (an opt-out back to semantic-style ranking).\n   */\n  private blend(similarity: number, ts: number, now: number): number {\n    const ageMs = Math.max(0, now - ts);\n    const recency = 0.5 ** (ageMs / this.halfLifeMs);\n\n    return (1 - this.recencyWeight) * similarity + this.recencyWeight * recency;\n  }\n\n  /**\n   * Namespaced key for an entry. Mirrors the semantic tier's dot\n   * separator so the prefix used here matches the `hit.key` the driver\n   * returns from `similar()`.\n   */\n  private keyFor(id: string): string {\n    return `${this.namespace}.${id}`;\n  }\n}\n","import type { CacheDriver, CacheSimilarHit } from \"@warlock.js/cache\";\nimport type { EmbedderContract } from \"../contracts/embedder.contract\";\nimport type {\n  MemoryItem,\n  RecalledMemory,\n} from \"../contracts/memory/memory-item.type\";\nimport { deriveMemoryId } from \"./derive-id\";\n\n/**\n * Shape persisted per procedure. `uses` is the reinforcement counter —\n * how many times the procedure has been remembered/re-affirmed — and\n * feeds the reinforcement half of the blended recall score. The vector\n * lives in the driver's index, so it is not duplicated here.\n */\ntype StoredProcedure = {\n  id: string;\n  text: string;\n  uses: number;\n  metadata?: Record<string, unknown>;\n};\n\n/**\n * Extra candidates pulled from `similar()` before re-ranking by the\n * reinforcement-blended score and slicing to `k` — reinforcement can\n * promote a well-worn procedure past a slightly-closer one-off, which the\n * raw top-`k` by similarity would miss.\n */\nconst RECALL_OVERSCAN = 5;\n\n/**\n * Procedural recall tier (memory core M2).\n *\n * Holds durable *how-to* knowledge — learned procedures, policies, and\n * playbooks — and retrieves the ones relevant to a query, **blended with\n * reinforcement** so procedures that have proven themselves (remembered /\n * re-affirmed more often) outrank one-offs at equal similarity. That\n * reinforcement weighting is the difference from the semantic tier (which\n * treats every fact equally): procedural memory gets *stronger with use*.\n *\n * Reinforcement is explicit and side-effect-free on read: re-remembering\n * a procedure (same id, or same text → same derived id) increments its\n * `uses`, so a caller strengthens a procedure by remembering it again\n * after a successful application. Recall never mutates.\n *\n * Like the other vector tiers it delegates similarity to the\n * `@warlock.js/cache` driver's `similar()`. The blended `score` stays in\n * `[0, 1]` so procedural hits merge and sort alongside the other tiers.\n *\n * Internal to the `memory()` factory — never exported on the package\n * surface.\n */\nexport class ProceduralMemory {\n  public constructor(\n    private readonly embedder: EmbedderContract,\n    private readonly store: CacheDriver<any, any>,\n    private readonly namespace: string,\n    private readonly reinforcementWeight: number,\n  ) {}\n\n  /**\n   * Embed the procedure text and index it, incrementing its `uses` when\n   * it already exists (reinforcement) or seeding it at `1` when new.\n   * Metadata on a reinforcing write wins; an omitted metadata keeps the\n   * prior value rather than wiping it.\n   */\n  public async remember(item: MemoryItem): Promise<void> {\n    const id = item.id ?? deriveMemoryId(item.text);\n    const { vector } = await this.embedder.embed(item.text);\n\n    const existing = await this.store.get<StoredProcedure>(this.keyFor(id));\n    const uses = (existing?.uses ?? 0) + 1;\n\n    const value: StoredProcedure = {\n      id,\n      text: item.text,\n      uses,\n      metadata: item.metadata ?? existing?.metadata,\n    };\n\n    await this.store.set(this.keyFor(id), value, { vector });\n  }\n\n  /**\n   * Embed `query`, pull the nearest procedures clearing the similarity\n   * `threshold`, then re-rank each by a reinforcement-blended score and\n   * return the top `k`. The similarity floor still gates relevance;\n   * reinforcement only reorders procedures that already cleared it.\n   */\n  public async recall(\n    query: string,\n    k: number,\n    threshold: number,\n  ): Promise<RecalledMemory[]> {\n    const { vector } = await this.embedder.embed(query);\n\n    const hits = await this.store.similar<StoredProcedure>(vector, {\n      topK: Math.max(k * RECALL_OVERSCAN, k),\n      threshold,\n    });\n\n    const prefix = `${this.namespace}.`;\n\n    return hits\n      .filter((hit: CacheSimilarHit<StoredProcedure>) =>\n        hit.key.startsWith(prefix),\n      )\n      .map((hit: CacheSimilarHit<StoredProcedure>) => ({\n        id: hit.value.id,\n        text: hit.value.text,\n        tier: \"procedural\" as const,\n        score: this.blend(hit.score, hit.value.uses),\n        metadata: hit.value.metadata,\n      }))\n      .sort((first, second) => second.score - first.score)\n      .slice(0, k);\n  }\n\n  /** Drop every procedure written under this instance's namespace. */\n  public async clear(): Promise<void> {\n    await this.store.removeNamespace(this.namespace);\n  }\n\n  /**\n   * Combine raw similarity with a saturating reinforcement proxy:\n   * `(1 - w)·similarity + w·(uses / (uses + 1))`. A first-time procedure\n   * contributes `0.5`; each reinforcement nudges it toward `1` with\n   * diminishing returns. With `reinforcementWeight` 0 the score is pure\n   * similarity.\n   */\n  private blend(similarity: number, uses: number): number {\n    const reinforcement = uses / (uses + 1);\n\n    return (\n      (1 - this.reinforcementWeight) * similarity +\n      this.reinforcementWeight * reinforcement\n    );\n  }\n\n  /** Namespaced key for an entry — dot separator, matching `similar()` keys. */\n  private keyFor(id: string): string {\n    return `${this.namespace}.${id}`;\n  }\n}\n","import type { CacheDriver, CacheSimilarHit } from \"@warlock.js/cache\";\nimport type { EmbedderContract } from \"../contracts/embedder.contract\";\nimport type {\n  MemoryItem,\n  RecalledMemory,\n} from \"../contracts/memory/memory-item.type\";\nimport { deriveMemoryId } from \"./derive-id\";\n\n/**\n * Shape persisted per semantic memory in the cache driver. The vector\n * itself is stored by the driver's own index (passed via\n * `set({ vector })`), so it is not duplicated in the value.\n */\ntype StoredMemory = {\n  id: string;\n  text: string;\n  metadata?: Record<string, unknown>;\n};\n\n/**\n * Semantic recall tier (memory core M1).\n *\n * Owns: embedding remembered text, writing it to a `@warlock.js/cache`\n * driver with `set({ vector })`, and retrieving by cosine similarity via\n * the driver's `similar()`. Does NOT own: the similarity algorithm or\n * the ANN index — those belong to the cache driver. This mirrors the\n * delegation model of `middleware/builtins/semantic-cache.ts`: memory is\n * embedding-agnostic and store-agnostic, gluing an {@link EmbedderContract}\n * to a {@link CacheDriver}.\n *\n * The driver may be shared across memory instances, so every key carries\n * the configured `namespace` and recall filters hits to that prefix —\n * foreign entries indexed by another instance never leak into a query.\n *\n * Internal to the `memory()` factory — never exported on the package\n * surface.\n */\nexport class SemanticMemory {\n  public constructor(\n    private readonly embedder: EmbedderContract,\n    private readonly store: CacheDriver<any, any>,\n    private readonly namespace: string,\n  ) {}\n\n  /**\n   * Embed the item's text and index it under a namespaced, id-derived\n   * key. Re-remembering the same id overwrites the prior vector +\n   * value (the driver upserts by key).\n   */\n  public async remember(item: MemoryItem): Promise<void> {\n    const id = item.id ?? deriveMemoryId(item.text);\n    const { vector } = await this.embedder.embed(item.text);\n\n    const value: StoredMemory = {\n      id,\n      text: item.text,\n      metadata: item.metadata,\n    };\n\n    await this.store.set(this.keyFor(id), value, { vector });\n  }\n\n  /**\n   * Embed `query`, ask the driver for the `k` nearest entries clearing\n   * `threshold`, and return those within this instance's namespace as\n   * scored {@link RecalledMemory}. Hits indexed under a different\n   * namespace (a shared driver) are filtered out.\n   */\n  public async recall(\n    query: string,\n    k: number,\n    threshold: number,\n  ): Promise<RecalledMemory[]> {\n    const { vector } = await this.embedder.embed(query);\n\n    const hits = await this.store.similar<StoredMemory>(vector, {\n      topK: k,\n      threshold,\n    });\n\n    const prefix = `${this.namespace}.`;\n\n    return hits\n      .filter((hit: CacheSimilarHit<StoredMemory>) =>\n        hit.key.startsWith(prefix),\n      )\n      .map((hit: CacheSimilarHit<StoredMemory>) => ({\n        id: hit.value.id,\n        text: hit.value.text,\n        tier: \"semantic\" as const,\n        score: hit.score,\n        metadata: hit.value.metadata,\n      }));\n  }\n\n  /** Drop every semantic entry written under this instance's namespace. */\n  public async clear(): Promise<void> {\n    await this.store.removeNamespace(this.namespace);\n  }\n\n  /**\n   * Namespaced key for an entry. The cache's `parseKey` normalizes `:`\n   * to `.`, so a dot separator keeps the prefix used here aligned with\n   * the `hit.key` the driver returns from `similar()`.\n   */\n  private keyFor(id: string): string {\n    return `${this.namespace}.${id}`;\n  }\n}\n","import type {\n  MemoryItem,\n  RecalledMemory,\n} from \"../contracts/memory/memory-item.type\";\nimport { deriveMemoryId } from \"./derive-id\";\n\n/**\n * In-run working memory — the volatile scratch tier (memory core M1).\n *\n * Owns: an insertion-ordered buffer of remembered items keyed by id,\n * with overwrite-in-place on a repeated id. Does NOT own: durability,\n * cross-process sharing, embeddings, or similarity — working memory is\n * a plain in-process buffer the orchestrator threads across the turns of\n * a single run.\n *\n * Recall here is not semantic: with no vector index, \"relevant\" reduces\n * to \"recent.\" `recall()` returns the most-recently-remembered items\n * first, each scored on a `[0, 1]` recency proxy so a caller can merge\n * working hits with semantic hits and sort on one `score` field.\n *\n * Internal to the `memory()` factory — never exported on the package\n * surface.\n */\nexport class WorkingMemory {\n  /**\n   * Id → text/metadata. A `Map` preserves insertion order, so iteration\n   * yields oldest-first; recall reverses it for most-recent-first.\n   */\n  private readonly entries = new Map<\n    string,\n    { text: string; metadata?: Record<string, unknown> }\n  >();\n\n  /**\n   * Append an item to the buffer (or overwrite the entry sharing its\n   * id). Re-inserting an existing id keeps its original position; delete\n   * + set would move it to the end and lie about recency, so the value\n   * is updated in place.\n   */\n  public remember(item: MemoryItem): void {\n    const id = item.id ?? deriveMemoryId(item.text);\n\n    this.entries.set(id, { text: item.text, metadata: item.metadata });\n  }\n\n  /**\n   * Return up to `k` most-recently-remembered items, newest first. The\n   * `score` is a linear recency proxy: the newest item scores `1`, the\n   * oldest of the returned slice trends toward `0`. Working memory\n   * ignores any similarity threshold — it has no vector to compare.\n   */\n  public recall(k: number): RecalledMemory[] {\n    const ordered = [...this.entries.entries()].reverse();\n    const slice = ordered.slice(0, Math.max(0, k));\n\n    return slice.map(([id, entry], index) => ({\n      id,\n      text: entry.text,\n      tier: \"working\" as const,\n      score: slice.length <= 1 ? 1 : 1 - index / slice.length,\n      metadata: entry.metadata,\n    }));\n  }\n\n  /** Drop every working-tier entry. */\n  public clear(): void {\n    this.entries.clear();\n  }\n}\n","import { resolveDefaultStore } from \"../config\";\nimport type { MemoryConfig } from \"../contracts/memory/memory-config.type\";\nimport type {\n  MemoryItem,\n  MemoryTier,\n  RecalledMemory,\n} from \"../contracts/memory/memory-item.type\";\nimport type { MemoryContract } from \"../contracts/memory/memory.contract\";\nimport type { RecallOptions } from \"../contracts/memory/recall-options.type\";\nimport { EpisodicMemory } from \"./episodic-memory\";\nimport { ProceduralMemory } from \"./procedural-memory\";\nimport { SemanticMemory } from \"./semantic-memory\";\nimport { WorkingMemory } from \"./working-memory\";\n\nconst DEFAULT_NAME = \"memory\";\nconst DEFAULT_SEMANTIC_NAMESPACE = \"ai.memory.semantic\";\nconst DEFAULT_EPISODIC_NAMESPACE = \"ai.memory.episodic\";\nconst DEFAULT_PROCEDURAL_NAMESPACE = \"ai.memory.procedural\";\nconst DEFAULT_K = 5;\nconst DEFAULT_THRESHOLD = 0.7;\nconst DEFAULT_RECENCY_WEIGHT = 0.3;\nconst DEFAULT_HALF_LIFE_MS = 7 * 24 * 60 * 60 * 1000;\nconst DEFAULT_REINFORCEMENT_WEIGHT = 0.3;\n\n/**\n * Create an agent memory store (memory core M2).\n *\n * Wires up to four tiers behind the {@link MemoryContract}: **working**\n * (in-run scratch, recency), **semantic** (durable facts by cosine\n * similarity), **episodic** (durable events, similarity blended with\n * recency), and **procedural** (durable how-tos, similarity blended with\n * reinforcement). The working tier is on by default; the other three each\n * activate only when their config is supplied. The three vector tiers\n * mirror how `semanticCache` delegates similarity to the cache driver's\n * `.similar()`.\n *\n * Resolution happens once here, at construction (loud), rather than per\n * call (silent until first use): a vector-tier config with no `store` and\n * no `ai.config({ defaultStore })` throws now; enabling no tier at all\n * throws now.\n *\n * Decay / forgetting (TTL-based falloff, eviction) remains deferred.\n *\n * @example\n * import { ai } from \"@warlock.js/ai\";\n * import { MemoryCacheDriver } from \"@warlock.js/cache\";\n *\n * const store = new MemoryCacheDriver();\n * store.setOptions({});\n *\n * const mem = ai.memory({\n *   semantic: { embedder, store },\n *   defaultTier: \"semantic\",\n * });\n *\n * await mem.remember({ text: \"User prefers concise answers.\" });\n * const hits = await mem.recall(\"how should I respond?\", { k: 3 });\n */\nexport function memory(config: MemoryConfig = {}): MemoryContract {\n  const name = config.name ?? DEFAULT_NAME;\n  const workingEnabled = config.working ?? true;\n  const defaultK = config.k ?? DEFAULT_K;\n  const defaultThreshold = config.threshold ?? DEFAULT_THRESHOLD;\n\n  const working = workingEnabled ? new WorkingMemory() : undefined;\n\n  const semantic = config.semantic\n    ? buildSemanticTier(config.semantic, name)\n    : undefined;\n\n  const episodic = config.episodic\n    ? buildEpisodicTier(config.episodic, name)\n    : undefined;\n\n  const procedural = config.procedural\n    ? buildProceduralTier(config.procedural, name)\n    : undefined;\n\n  const tiers: Tiers = { working, semantic, episodic, procedural };\n\n  if (!working && !semantic && !episodic && !procedural) {\n    throw new Error(\n      `memory(\"${name}\"): no tier enabled — enable \\`working\\` (default) or pass a \\`semantic\\` / \\`episodic\\` / \\`procedural\\` config; a memory with no tiers can neither store nor recall`,\n    );\n  }\n\n  const defaultTier: MemoryTier = config.defaultTier ?? \"working\";\n\n  assertTierEnabled(defaultTier, tiers, name);\n\n  return {\n    name,\n    async remember(items: MemoryItem | MemoryItem[]): Promise<void> {\n      const list = Array.isArray(items) ? items : [items];\n\n      const writes: Promise<void>[] = [];\n\n      for (const item of list) {\n        const tier = item.tier ?? defaultTier;\n\n        assertTierEnabled(tier, tiers, name);\n\n        if (tier === \"working\") {\n          working!.remember(item);\n\n          continue;\n        }\n\n        if (tier === \"semantic\") {\n          writes.push(semantic!.remember(item));\n\n          continue;\n        }\n\n        if (tier === \"episodic\") {\n          writes.push(episodic!.remember(item));\n\n          continue;\n        }\n\n        writes.push(procedural!.remember(item));\n      }\n\n      await Promise.all(writes);\n    },\n    async recall(\n      query: string,\n      options: RecallOptions = {},\n    ): Promise<RecalledMemory[]> {\n      const k = options.k ?? defaultK;\n      const threshold = options.threshold ?? defaultThreshold;\n\n      if (options.tier) {\n        assertTierEnabled(options.tier, tiers, name);\n      }\n\n      const wants = (tier: MemoryTier): boolean =>\n        !options.tier || options.tier === tier;\n\n      const [workingHits, semanticHits, episodicHits, proceduralHits] =\n        await Promise.all([\n          working && wants(\"working\")\n            ? Promise.resolve(working.recall(k))\n            : Promise.resolve([] as RecalledMemory[]),\n          semantic && wants(\"semantic\")\n            ? semantic.recall(query, k, threshold)\n            : Promise.resolve([] as RecalledMemory[]),\n          episodic && wants(\"episodic\")\n            ? episodic.recall(query, k, threshold)\n            : Promise.resolve([] as RecalledMemory[]),\n          procedural && wants(\"procedural\")\n            ? procedural.recall(query, k, threshold)\n            : Promise.resolve([] as RecalledMemory[]),\n        ]);\n\n      return [\n        ...workingHits,\n        ...semanticHits,\n        ...episodicHits,\n        ...proceduralHits,\n      ]\n        .sort((first, second) => second.score - first.score)\n        .slice(0, k);\n    },\n    async clear(tier?: MemoryTier): Promise<void> {\n      const clears: Promise<void>[] = [];\n\n      if (working && (!tier || tier === \"working\")) {\n        working.clear();\n      }\n\n      if (semantic && (!tier || tier === \"semantic\")) {\n        clears.push(semantic.clear());\n      }\n\n      if (episodic && (!tier || tier === \"episodic\")) {\n        clears.push(episodic.clear());\n      }\n\n      if (procedural && (!tier || tier === \"procedural\")) {\n        clears.push(procedural.clear());\n      }\n\n      await Promise.all(clears);\n    },\n  };\n}\n\n/** The four tier instances a `memory()` composes; `undefined` when off. */\ntype Tiers = {\n  working: WorkingMemory | undefined;\n  semantic: SemanticMemory | undefined;\n  episodic: EpisodicMemory | undefined;\n  procedural: ProceduralMemory | undefined;\n};\n\n/**\n * Resolve the semantic tier's store (explicit `store` wins, else the\n * global `ai.config({ defaultStore })`) and build the tier. Throws at\n * construction when neither is available — the same loud-now contract\n * `semanticCache` follows.\n */\nfunction buildSemanticTier(\n  semanticConfig: NonNullable<MemoryConfig[\"semantic\"]>,\n  name: string,\n): SemanticMemory {\n  const store = semanticConfig.store ?? resolveDefaultStore();\n\n  if (!store) {\n    throw new Error(\n      `memory(\"${name}\"): semantic tier has no store — pass \\`semantic.store\\` or call \\`ai.config({ defaultStore })\\` at app boot before constructing the memory`,\n    );\n  }\n\n  return new SemanticMemory(\n    semanticConfig.embedder,\n    store,\n    semanticConfig.namespace ?? DEFAULT_SEMANTIC_NAMESPACE,\n  );\n}\n\n/**\n * Resolve the episodic tier's store (explicit `store` wins, else the\n * global default) and build the tier with its recency knobs. Throws at\n * construction when neither store is available — the same loud-now\n * contract the semantic tier follows.\n */\nfunction buildEpisodicTier(\n  episodicConfig: NonNullable<MemoryConfig[\"episodic\"]>,\n  name: string,\n): EpisodicMemory {\n  const store = episodicConfig.store ?? resolveDefaultStore();\n\n  if (!store) {\n    throw new Error(\n      `memory(\"${name}\"): episodic tier has no store — pass \\`episodic.store\\` or call \\`ai.config({ defaultStore })\\` at app boot before constructing the memory`,\n    );\n  }\n\n  return new EpisodicMemory(\n    episodicConfig.embedder,\n    store,\n    episodicConfig.namespace ?? DEFAULT_EPISODIC_NAMESPACE,\n    episodicConfig.recencyWeight ?? DEFAULT_RECENCY_WEIGHT,\n    episodicConfig.halfLifeMs ?? DEFAULT_HALF_LIFE_MS,\n    episodicConfig.now ?? (() => Date.now()),\n  );\n}\n\n/**\n * Resolve the procedural tier's store and build the tier with its\n * reinforcement knob. Throws at construction when no store is available.\n */\nfunction buildProceduralTier(\n  proceduralConfig: NonNullable<MemoryConfig[\"procedural\"]>,\n  name: string,\n): ProceduralMemory {\n  const store = proceduralConfig.store ?? resolveDefaultStore();\n\n  if (!store) {\n    throw new Error(\n      `memory(\"${name}\"): procedural tier has no store — pass \\`procedural.store\\` or call \\`ai.config({ defaultStore })\\` at app boot before constructing the memory`,\n    );\n  }\n\n  return new ProceduralMemory(\n    proceduralConfig.embedder,\n    store,\n    proceduralConfig.namespace ?? DEFAULT_PROCEDURAL_NAMESPACE,\n    proceduralConfig.reinforcementWeight ?? DEFAULT_REINFORCEMENT_WEIGHT,\n  );\n}\n\n/**\n * Guard that a tier referenced by config / a call is actually enabled,\n * failing fast with an actionable message instead of a downstream\n * `undefined` dereference.\n */\nfunction assertTierEnabled(tier: MemoryTier, tiers: Tiers, name: string): void {\n  if (tier === \"working\" && !tiers.working) {\n    throw new Error(\n      `memory(\"${name}\"): working tier is disabled — set \\`working: true\\` (the default) to use it`,\n    );\n  }\n\n  if (tier === \"semantic\" && !tiers.semantic) {\n    throw new Error(\n      `memory(\"${name}\"): semantic tier is not configured — pass \\`semantic\\` config to use it`,\n    );\n  }\n\n  if (tier === \"episodic\" && !tiers.episodic) {\n    throw new Error(\n      `memory(\"${name}\"): episodic tier is not configured — pass \\`episodic\\` config to use it`,\n    );\n  }\n\n  if (tier === \"procedural\" && !tiers.procedural) {\n    throw new Error(\n      `memory(\"${name}\"): procedural tier is not configured — pass \\`procedural\\` config to use it`,\n    );\n  }\n}\n","import type { Message } from \"../contracts/conversation-message.type\";\nimport type {\n  ModelCallOptions,\n  ModelCapabilities,\n  ModelContract,\n  ModelResponse,\n  ModelStreamChunk,\n} from \"../contracts/model.contract\";\nimport type { MockModelResponse } from \"./mock-config.type\";\n\ntype RecordedCall = {\n  messages: Message[];\n  options?: ModelCallOptions;\n};\n\n/**\n * Deterministic in-memory `ModelContract` implementation for tests.\n *\n * **Role.** Stands in for a real provider model so agent/workflow/supervisor\n * tests can assert behavior without hitting the network, spending tokens, or\n * depending on non-deterministic LLM output.\n *\n * **Responsibility.**\n * - Owns: a scripted queue of `MockModelResponse` entries, a call-history\n *   log for assertions, and the index pointer that advances through the\n *   queue on each `complete()` / `stream()` call.\n * - Does NOT own: any real inference, tokenization, or network I/O — when\n *   the queue is exhausted, the final entry is reused so tests never crash\n *   on accidental over-consumption.\n *\n * Every AI-related test in this repo uses `MockSDK` / `MockModel` — real\n * provider APIs are never hit from the test suite (see §6 of code-style.md).\n *\n * @example\n * const model = new MockModel(\"mock-gpt\", [\n *   { content: \"Hello!\", finishReason: \"stop\" },\n *   { content: \"Second turn.\", finishReason: \"stop\" },\n * ]);\n *\n * const first = await model.complete([{ role: \"user\", content: \"hi\" }]);\n * expect(first.content).toBe(\"Hello!\");\n * expect(model.callCount).toBe(1);\n */\nexport class MockModel implements ModelContract {\n  public readonly provider = \"mock\";\n  public readonly capabilities?: ModelCapabilities;\n\n  private responseIndex = 0;\n  private calls: RecordedCall[] = [];\n\n  public constructor(\n    public readonly name: string,\n    private readonly responses: MockModelResponse[],\n    capabilities?: ModelCapabilities,\n  ) {\n    this.capabilities = capabilities;\n  }\n\n  /**\n   * Full history of calls made to this model. Each entry is the exact\n   * `{ messages, options }` pair that was passed — useful for asserting\n   * that an agent built the right prompt or forwarded the right tool list.\n   */\n  public get callHistory(): RecordedCall[] {\n    return this.calls;\n  }\n\n  /**\n   * Number of times `complete()` or `stream()` has been invoked. Convenient\n   * shorthand for `callHistory.length` in assertions.\n   */\n  public get callCount(): number {\n    return this.calls.length;\n  }\n\n  /**\n   * Advance the scripted response queue by one and return the entry at the\n   * current pointer. If the queue is exhausted, the final scripted entry is\n   * returned repeatedly so over-consumption in tests produces predictable\n   * output instead of `undefined`.\n   */\n  private nextResponse(): MockModelResponse {\n    const response = this.responses[Math.min(this.responseIndex, this.responses.length - 1)];\n\n    this.responseIndex++;\n\n    return response ?? { content: \"Mock response\", finishReason: \"stop\" };\n  }\n\n  /**\n   * Convert a scripted `MockModelResponse` into a full `ModelResponse` with\n   * synthesized usage numbers when the script didn't supply them. Input\n   * usage is a fixed estimate; output usage is derived from content length.\n   */\n  private buildResponse(mock: MockModelResponse): ModelResponse {\n    const estimatedInput = 10;\n    const estimatedOutput = Math.ceil(mock.content.length / 4);\n\n    return {\n      content: mock.content,\n      finishReason: mock.finishReason ?? \"stop\",\n      usage: {\n        input: mock.usage?.input ?? estimatedInput,\n        output: mock.usage?.output ?? estimatedOutput,\n        total: (mock.usage?.input ?? estimatedInput) + (mock.usage?.output ?? estimatedOutput),\n        ...(mock.usage?.cachedTokens !== undefined ? { cachedTokens: mock.usage.cachedTokens } : {}),\n      },\n      toolCalls: mock.toolCalls,\n    };\n  }\n\n  /**\n   * Record the call, optionally delay (to simulate latency), and either\n   * throw the scripted error or return the scripted response. Mirrors the\n   * real provider's `complete()` contract so agents cannot tell the\n   * difference at runtime.\n   */\n  public async complete(messages: Message[], options?: ModelCallOptions): Promise<ModelResponse> {\n    this.calls.push({ messages, options });\n\n    const mock = this.nextResponse();\n\n    if (mock.delay) {\n      await new Promise((resolve) => setTimeout(resolve, mock.delay));\n    }\n\n    if (mock.error) {\n      throw mock.error;\n    }\n\n    return this.buildResponse(mock);\n  }\n\n  /**\n   * Record the call, optionally delay, then emit the scripted response as a\n   * sequence of stream chunks: content split word-by-word as `delta`\n   * chunks, each scripted tool call as a `tool-call` chunk, and finally a\n   * `done` chunk with finish reason + usage. Throws eagerly if the scripted\n   * entry carries an `error`.\n   */\n  public async *stream(\n    messages: Message[],\n    options?: ModelCallOptions,\n  ): AsyncIterable<ModelStreamChunk> {\n    this.calls.push({ messages, options });\n\n    const mock = this.nextResponse();\n\n    if (mock.delay) {\n      await new Promise((resolve) => setTimeout(resolve, mock.delay));\n    }\n\n    if (mock.error) {\n      throw mock.error;\n    }\n\n    const words = mock.content.split(\" \");\n\n    for (const word of words) {\n      yield { type: \"delta\", content: word + \" \" };\n    }\n\n    if (mock.toolCalls) {\n      for (const toolCall of mock.toolCalls) {\n        yield {\n          type: \"tool-call\",\n          id: toolCall.id,\n          name: toolCall.name,\n          input: toolCall.input,\n        };\n      }\n    }\n\n    const response = this.buildResponse(mock);\n\n    yield {\n      type: \"done\",\n      finishReason: response.finishReason,\n      usage: response.usage,\n    };\n  }\n\n  /**\n   * Reset call history and response pointer back to their initial state.\n   * Intended for test-suite `beforeEach` hooks so a single `MockModel`\n   * instance can be reused across cases without cross-test leakage.\n   */\n  public reset(): void {\n    this.calls = [];\n    this.responseIndex = 0;\n  }\n}\n","import type {\n  ModelConfig,\n  SDKAdapterContract,\n} from \"../contracts/sdk-adapter.contract\";\nimport { approximateTokenCount } from \"../utils/token-count\";\nimport type { MockSDKConfig } from \"./mock-config.type\";\nimport { MockModel } from \"./mock-model\";\n\n/**\n * Creates a mock SDK adapter for testing — no HTTP calls, fully configurable.\n *\n * @example\n * const mock = MockSDK({\n *   responses: [\n *     { content: \"Hello from mock!\" },\n *     { content: \"Second response\" },\n *   ],\n * });\n * const model = mock.model({ name: \"gpt-4o\" });\n * const result = await model.complete([{ role: \"user\", content: \"Hi\" }]);\n * console.log(result.content); // \"Hello from mock!\"\n */\nexport function MockSDK(config: MockSDKConfig = {}): SDKAdapterContract & {\n  /** All model instances created by this SDK — for inspecting calls in tests */\n  models: MockModel[];\n} {\n  const models: MockModel[] = [];\n  const responses = config.responses ?? [{ content: \"Mock response\" }];\n\n  return {\n    models,\n    model(modelConfig: ModelConfig) {\n      const model = new MockModel(\n        modelConfig.name ?? config.defaultModelName ?? \"mock-model\",\n        responses,\n        config.capabilities,\n      );\n      models.push(model);\n      return model;\n    },\n    async count(text: string, _model?: string): Promise<number> {\n      return approximateTokenCount(text);\n    },\n  };\n}\n","import { agent } from \"../agent/agent\";\nimport type { AgentConfig } from \"../agent/agent-config.type\";\nimport type { AgentContract } from \"../contracts/agent/agent.contract\";\nimport type { ToolContract } from \"../tool/tool\";\nimport type { MockModelResponse } from \"./mock-config.type\";\nimport { MockSDK } from \"./mock-sdk\";\n\n/**\n * Test helper that wires `MockSDK` → mock model → `agent()` in one call.\n *\n * Replaces the 4-line ritual specs typically write:\n * ```ts\n * const mock = MockSDK({ responses: [...] });\n * const myAgent = agent({ name: \"x\", model: mock.model({ name: \"m\" }) });\n * ```\n *\n * Defaults to a single empty `\"stop\"` response — enough to exercise an\n * agent that doesn't need a scripted reply (composition wiring,\n * anonymous-name tests, etc.). Pass `responses` to script outputs.\n *\n * `name` is optional — when omitted the resulting agent runs through\n * the normal anonymous-name fingerprint\n * (`anon_<provider>_<model>[_<tool1>+<tool2>...]`), which is the\n * default for `agent({ model })`.\n *\n * @example\n * const a = mockAgent({ name: \"writer\", responses: [{ content: \"hi\", finishReason: \"stop\" }] });\n * const result = await a.execute(\"anything\");\n */\nexport function mockAgent<TOutput = unknown>(\n  options: {\n    name?: string;\n    responses?: MockModelResponse[];\n    tools?: ToolContract<unknown, unknown>[];\n    /**\n     * Override the model name reported by the mock model. Defaults to\n     * `\"mock-model\"` (the MockSDK default). Useful when a test needs\n     * deterministic provider/model fingerprinting.\n     */\n    modelName?: string;\n  } = {},\n): AgentContract<TOutput> {\n  const responses = options.responses ?? [{ content: \"\", finishReason: \"stop\" as const }];\n  const sdk = MockSDK({ responses });\n  const model = sdk.model({ name: options.modelName ?? \"mock-model\" });\n\n  const config: AgentConfig<TOutput> = { model };\n\n  if (options.name !== undefined) {\n    config.name = options.name;\n  }\n\n  if (options.tools !== undefined) {\n    config.tools = options.tools;\n  }\n\n  return agent<TOutput>(config);\n}\n","import { END } from \"../contracts/end.type\";\nimport type { Next } from \"../contracts/supervisor/next.type\";\nimport type { RouteContext } from \"../contracts/supervisor/route-context.type\";\n\n/**\n * A canned routing decision for {@link mockRouter}. Either a literal\n * {@link Next} value (intent key, fan-out array, or the `END`\n * sentinel) or a predicate that derives the decision from the live\n * {@link RouteContext} — the latter lets a test branch on accumulated\n * state without scripting an exact per-iteration sequence.\n */\nexport type MockRouterDecision<TState = Record<string, unknown>> =\n  | Next\n  | ((context: RouteContext<TState>) => Next);\n\n/**\n * Behavior when the canned decision queue is exhausted before the\n * supervisor terminates on its own.\n *\n * - `\"end\"` (default) — return `END`, terminating the run cleanly. The\n *   common case: script the interesting turns, let the run stop.\n * - `\"throw\"` — throw, surfacing the over-run as a test failure. Use\n *   when every iteration must be accounted for.\n * - `\"repeat\"` — replay the last decision for every further iteration.\n *   Useful for \"keep routing to the same intent until evaluate is\n *   satisfied\" scenarios.\n */\nexport type MockRouterExhaustion = \"end\" | \"throw\" | \"repeat\";\n\n/**\n * Options for {@link mockRouter}.\n */\nexport type MockRouterOptions = {\n  /** What to do once the decision queue is exhausted. Default `\"end\"`. */\n  onExhausted?: MockRouterExhaustion;\n};\n\n/**\n * Build a deterministic `route` callback that replays a canned\n * sequence of routing decisions — one per supervisor iteration — for\n * testing supervisors without an LLM router.\n *\n * Drop the returned callback into `ai.supervisor({ route: mockRouter([...]) })`\n * in place of an LLM `router`. The Nth iteration consumes the Nth\n * decision; a function decision is evaluated against the live\n * `RouteContext`. When the queue runs out, behavior follows\n * `options.onExhausted` (default: terminate with `END`).\n *\n * Pairs with the `toRouteTo` / `toConverge` matchers to assert the\n * resulting report tree.\n *\n * @example\n * const supervisor = ai.supervisor({\n *   name: \"draft-then-review\",\n *   intents: { writer, critic },\n *   route: mockRouter([\"writer\", \"critic\", END]),\n * });\n *\n * @example\n * // Branch on accumulated state, repeat the last decision until done.\n * route: mockRouter(\n *   [\"research\", (ctx) => (ctx.state.summary ? END : \"research\")],\n *   { onExhausted: \"repeat\" },\n * );\n */\nexport function mockRouter<TState = Record<string, unknown>>(\n  decisions: MockRouterDecision<TState>[],\n  options: MockRouterOptions = {},\n): (context: RouteContext<TState>) => Next {\n  const onExhausted = options.onExhausted ?? \"end\";\n  let cursor = 0;\n\n  return (context: RouteContext<TState>): Next => {\n    if (cursor < decisions.length) {\n      const decision = decisions[cursor];\n      cursor++;\n\n      return resolveDecision(decision, context);\n    }\n\n    if (onExhausted === \"throw\") {\n      throw new Error(\n        `mockRouter exhausted after ${decisions.length} decision(s) at iteration ${context.iteration}`,\n      );\n    }\n\n    if (onExhausted === \"repeat\" && decisions.length > 0) {\n      return resolveDecision(decisions[decisions.length - 1], context);\n    }\n\n    return END;\n  };\n}\n\n/**\n * Resolve a single decision entry into a concrete {@link Next} —\n * invoking the predicate form against the live context, or returning\n * the literal form verbatim.\n */\nfunction resolveDecision<TState>(\n  decision: MockRouterDecision<TState>,\n  context: RouteContext<TState>,\n): Next {\n  if (typeof decision === \"function\") {\n    return decision(context);\n  }\n\n  return decision;\n}\n","import type {\n  FallbackAttempt,\n  FallbackModelContract,\n  FallbackModelOptions,\n  FallbackRetryPredicate,\n} from \"../contracts/fallback-model.contract\";\nimport type { Message } from \"../contracts/conversation-message.type\";\nimport type {\n  ModelCallOptions,\n  ModelCapabilities,\n  ModelContract,\n  ModelResponse,\n  ModelStreamChunk,\n} from \"../contracts/model.contract\";\nimport type { Usage } from \"../contracts/result/usage.type\";\nimport { AIError } from \"../errors/ai-error\";\nimport type { AIErrorCode } from \"../errors/error-code.type\";\nimport { accumulateCost } from \"../utils/compute-cost\";\n\n/**\n * Error codes treated as transient — and therefore worth falling over\n * to the next model — when the caller does not supply an explicit\n * `retryOn`. Covers provider rate-limits, timeouts, and the generic\n * `PROVIDER_ERROR` catch-all that adapters throw for 5xx / unknown\n * network failures. Deliberately omits auth, invalid-request,\n * context-length, and content-filter: those fail identically on every\n * downstream model, so retrying only burns budget.\n */\nconst DEFAULT_RETRYABLE_CODES: readonly AIErrorCode[] = [\n  \"PROVIDER_RATE_LIMIT\",\n  \"PROVIDER_TIMEOUT\",\n  \"PROVIDER_ERROR\",\n];\n\n/**\n * A `ModelContract` that wraps an ordered list of models and tries each\n * in turn, advancing to the next only when the current one fails with a\n * matching (transient) provider error.\n *\n * **Role.** A drop-in `ModelContract` for resilience: hand it to any\n * agent / workflow / supervisor in place of a single model and provider\n * outages, rate-limits, and timeouts transparently fail over to a\n * backup. Non-transient failures (bad key, oversized prompt, blocked\n * content) re-throw immediately rather than wastefully retrying.\n *\n * **What it owns / doesn't own.** Owns the ordered model list, the\n * retry decision, and per-call usage aggregation across attempted\n * models. Does NOT own retry/backoff timing (it advances instantly to\n * the next model — pair it with a backoff middleware if you want delay)\n * nor any provider I/O of its own; every call is delegated to a wrapped\n * model.\n *\n * **Streaming fall-over caveat.** `stream()` can only fail over while no\n * chunk has been emitted yet. Once the first `delta` / `tool-call`\n * reaches the consumer, the partial output cannot be un-sent, so a\n * mid-stream failure propagates instead of restarting on the next\n * model.\n *\n * @example\n * const model = fallbackModel([\n *   ai.openai.model({ name: \"gpt-4o\" }),\n *   ai.anthropic.model({ name: \"claude-3-5-sonnet\" }),\n * ]);\n * const agent = ai.agent({ model });\n *\n * @example\n * // custom retry predicate\n * const model = fallbackModel([primary, backup], {\n *   retryOn: (error) => error instanceof ProviderError,\n * });\n */\nexport function fallbackModel(\n  models: ModelContract[],\n  options?: FallbackModelOptions,\n): FallbackModelContract {\n  if (models.length === 0) {\n    throw new AIError(\n      \"PROVIDER_INVALID_REQUEST\",\n      \"fallbackModel() requires at least one model in the chain.\",\n      undefined,\n      \"validation\",\n    );\n  }\n\n  return new FallbackModel(models, resolveShouldRetry(options?.retryOn));\n}\n\n/**\n * Build the chain-advancement predicate from the caller's `retryOn`.\n * An array becomes a code membership test against an `AIError.code`; a\n * function is used verbatim; absence falls back to the transient\n * default set.\n */\nfunction resolveShouldRetry(\n  retryOn: FallbackModelOptions[\"retryOn\"],\n): FallbackRetryPredicate {\n  if (typeof retryOn === \"function\") {\n    return retryOn;\n  }\n\n  const codes: readonly AIErrorCode[] = retryOn ?? DEFAULT_RETRYABLE_CODES;\n\n  return (error: unknown): boolean => {\n    return error instanceof AIError && codes.includes(error.code);\n  };\n}\n\n/**\n * Add a successful call's usage into a running aggregate, mirroring the\n * agent's trip accumulation: scalar token counts sum, optional channels\n * sum only when present, and cost merges via `accumulateCost` so an\n * unpriced model never erases a priced sibling's cost.\n */\nfunction aggregateUsage(total: Usage, next: Usage): void {\n  total.input += next.input;\n  total.output += next.output;\n  total.total += next.total;\n\n  if (next.cachedTokens !== undefined) {\n    total.cachedTokens = (total.cachedTokens ?? 0) + next.cachedTokens;\n  }\n\n  if (next.reasoningTokens !== undefined) {\n    total.reasoningTokens = (total.reasoningTokens ?? 0) + next.reasoningTokens;\n  }\n\n  if (next.cacheWriteTokens !== undefined) {\n    total.cacheWriteTokens = (total.cacheWriteTokens ?? 0) + next.cacheWriteTokens;\n  }\n\n  total.cost = accumulateCost(total.cost, next.cost);\n}\n\n/**\n * Internal `ModelContract` implementation backing {@link fallbackModel}.\n *\n * Long-lived (its identity, capabilities, and pricing front the primary\n * model for the wrapper's whole lifetime) so it is a class rather than a\n * closure. Per-call mutable state (the usage aggregate, the attempt log)\n * lives in {@link FallbackRun}, instantiated fresh on every\n * `complete()` / `stream()` so concurrent calls never share bookkeeping.\n */\nclass FallbackModel implements FallbackModelContract {\n  public readonly name: string;\n  public readonly provider: string;\n  public readonly capabilities?: ModelCapabilities;\n  public readonly pricing?: ModelContract[\"pricing\"];\n\n  private latestAttempts: FallbackAttempt[] = [];\n\n  public constructor(\n    private readonly models: ModelContract[],\n    private readonly shouldRetry: FallbackRetryPredicate,\n  ) {\n    const primary = models[0]!;\n\n    this.name = primary.name;\n    this.provider = primary.provider;\n    this.capabilities = primary.capabilities;\n    this.pricing = primary.pricing;\n  }\n\n  /**\n   * Models that failed with a chain-advancing error during the most\n   * recent `complete()` / `stream()` call, in attempt order. Empty when\n   * the primary model succeeded outright. Overwritten on each call.\n   */\n  public get lastAttempts(): FallbackAttempt[] {\n    return this.latestAttempts;\n  }\n\n  public async complete(\n    messages: Message[],\n    options?: ModelCallOptions,\n  ): Promise<ModelResponse> {\n    const run = new FallbackRun(this.models, this.shouldRetry);\n    const response = await run.complete(messages, options);\n\n    this.latestAttempts = run.attempts;\n\n    return response;\n  }\n\n  public stream(\n    messages: Message[],\n    options?: ModelCallOptions,\n  ): AsyncIterable<ModelStreamChunk> {\n    const run = new FallbackRun(this.models, this.shouldRetry);\n\n    return run.stream(messages, options, (attempts) => {\n      this.latestAttempts = attempts;\n    });\n  }\n}\n\n/**\n * Per-call execution of the fallback chain. Holds the usage aggregate\n * and the attempt log for a single `complete()` / `stream()` invocation\n * so the long-lived {@link FallbackModel} stays free of shared mutable\n * state across concurrent calls.\n */\nclass FallbackRun {\n  public readonly attempts: FallbackAttempt[] = [];\n\n  private readonly usage: Usage = { input: 0, output: 0, total: 0 };\n\n  public constructor(\n    private readonly models: ModelContract[],\n    private readonly shouldRetry: FallbackRetryPredicate,\n  ) {}\n\n  /**\n   * Try each model's `complete()` in order. On a chain-advancing error,\n   * record the attempt and move to the next; on the last model (or a\n   * non-retryable error) re-throw the underlying error verbatim so the\n   * caller still sees a typed `AIError` with its original code.\n   */\n  public async complete(\n    messages: Message[],\n    options?: ModelCallOptions,\n  ): Promise<ModelResponse> {\n    for (let index = 0; index < this.models.length; index++) {\n      const model = this.models[index]!;\n      const isLast = index === this.models.length - 1;\n\n      try {\n        const response = await model.complete(messages, options);\n\n        aggregateUsage(this.usage, response.usage);\n\n        return { ...response, usage: this.usage };\n      } catch (error) {\n        if (isLast || !this.shouldRetry(error)) {\n          throw error;\n        }\n\n        this.recordAttempt(model, error);\n      }\n    }\n\n    throw new AIError(\n      \"PROVIDER_ERROR\",\n      \"fallbackModel() exhausted its chain without producing a response.\",\n      undefined,\n      \"provider\",\n    );\n  }\n\n  /**\n   * Try each model's `stream()` in order. Fall-over is only attempted\n   * while no chunk has been emitted yet for the current model — once the\n   * consumer has seen a `delta` / `tool-call`, a mid-stream failure\n   * propagates instead of restarting (partial output cannot be un-sent).\n   * The aggregated usage replaces the `done` chunk's usage so the caller\n   * sees the chain total.\n   */\n  public async *stream(\n    messages: Message[],\n    options: ModelCallOptions | undefined,\n    onSettle: (attempts: FallbackAttempt[]) => void,\n  ): AsyncIterable<ModelStreamChunk> {\n    try {\n      for (let index = 0; index < this.models.length; index++) {\n        const model = this.models[index]!;\n        const isLast = index === this.models.length - 1;\n        let emitted = false;\n\n        try {\n          for await (const chunk of model.stream(messages, options)) {\n            if (chunk.type === \"done\") {\n              aggregateUsage(this.usage, chunk.usage);\n\n              yield { ...chunk, usage: this.usage };\n              return;\n            }\n\n            emitted = true;\n\n            yield chunk;\n          }\n\n          return;\n        } catch (error) {\n          if (emitted || isLast || !this.shouldRetry(error)) {\n            throw error;\n          }\n\n          this.recordAttempt(model, error);\n        }\n      }\n\n      throw new AIError(\n        \"PROVIDER_ERROR\",\n        \"fallbackModel() exhausted its chain without producing a response.\",\n        undefined,\n        \"provider\",\n      );\n    } finally {\n      onSettle(this.attempts);\n    }\n  }\n\n  private recordAttempt(model: ModelContract, error: unknown): void {\n    this.attempts.push({\n      modelName: model.name,\n      provider: model.provider,\n      error,\n    });\n  }\n}\n","import type { Message } from \"../contracts/conversation-message.type\";\nimport type {\n  OrchestratorAsToolOptions,\n  OrchestratorContract,\n} from \"../contracts/orchestrator/orchestrator.contract\";\nimport type { SupervisorInput } from \"../contracts/supervisor/supervisor-input.type\";\nimport { SupervisorFailedError } from \"../errors\";\nimport { compositeAsTool, type ToolContract } from \"../tool/tool\";\nimport { generateRunId } from \"../utils/generate-run-id\";\n\n/**\n * Shape the orchestrator looks for inside the validated tool input when\n * `sessionScope: \"shared\"` — the parent must thread the session id (and\n * optionally the prior history) through the tool's `inputSchema`\n * payload, since the boundary is opaque (§13). Everything else on the\n * payload becomes the orchestrator's `execute(input)` argument.\n */\ntype SharedScopePayload = {\n  sessionId?: unknown;\n  history?: unknown;\n  [key: string]: unknown;\n};\n\n/**\n * Wrap an {@link OrchestratorContract} as a {@link ToolContract} so an\n * outer agent can invoke it from its tool-call loop (design §13).\n * Mirrors `supervisor.asTool()` — same `compositeAsTool` composition and\n * error normalization — and adds `sessionScope`.\n *\n * The boundary is OPAQUE (§13, §18.6): the parent's `signal` / `context`\n * / events do NOT auto-forward. Anything the wrapped orchestrator needs\n * per call must ride on the tool's `inputSchema` payload.\n *\n * Session continuity:\n * - `\"fresh\"` (default) — each invocation gets a brand-new `sessionId`\n *   (a generated id) and empty history; the session lives only for this\n *   tool call. The whole validated payload is forwarded as the\n *   orchestrator's `execute(input)` argument.\n * - `\"shared\"` — the parent supplies `sessionId` (and optionally\n *   `history`) inside the validated payload; the orchestrator\n *   participates in that session. The remaining payload fields are\n *   forwarded as `execute(input)`. A missing/blank `sessionId` throws\n *   {@link SupervisorFailedError}.\n *\n * On `result.error`, the typed orchestrator error is thrown so the tool\n * wrapper produces a `ToolExecutionError` with `cause` preserved — the\n * outer agent sees one uniform error class.\n *\n * @example\n * const support = ai.orchestrator({ name: \"refund-support\", intents });\n * const supportTool = support.asTool({\n *   name: \"handle_refund\",\n *   description: \"Handle a refund conversation end-to-end.\",\n *   inputSchema: v.object({ message: v.string() }),\n * });\n * const concierge = ai.agent({ model, tools: [supportTool] });\n */\nexport function asTool<TOutput, TState, TToolInput>(\n  orchestrator: OrchestratorContract<TOutput, TState>,\n  options: OrchestratorAsToolOptions<TToolInput>,\n): ToolContract<TToolInput, TOutput> {\n  if (!orchestrator.name || typeof orchestrator.name !== \"string\") {\n    throw new SupervisorFailedError(\n      \"orchestrator.asTool(): orchestrator must have a `name` to be wrapped as a tool\",\n    );\n  }\n\n  const sessionScope = options.sessionScope ?? \"fresh\";\n\n  return compositeAsTool<TToolInput, TOutput>({\n    name: options.name ?? orchestrator.name,\n    description:\n      options.description ??\n      `Invoke orchestrator \"${orchestrator.name}\" as a tool.`,\n    input: options.inputSchema,\n    execute: async (input) => {\n      const { sessionId, history, executeInput } = resolveSession(\n        sessionScope,\n        input,\n      );\n\n      const result = await orchestrator.execute(executeInput, {\n        sessionId,\n        history,\n      });\n\n      if (result.error) {\n        // Surface the typed orchestrator error — the outer ToolContract\n        // wraps it as a ToolExecutionError with `cause` preserved.\n        throw result.error;\n      }\n\n      return {\n        data: result.data as TOutput,\n        usage: result.usage,\n        report: result.report,\n      };\n    },\n  });\n}\n\n/**\n * Resolve the per-call `sessionId`, `history`, and the `execute(input)`\n * argument from the validated tool payload, according to `sessionScope`.\n */\nfunction resolveSession(\n  sessionScope: \"fresh\" | \"shared\",\n  input: unknown,\n): { sessionId: string; history: Message[]; executeInput: SupervisorInput } {\n  if (sessionScope === \"fresh\") {\n    return {\n      sessionId: generateRunId(\"session\"),\n      history: [],\n      executeInput: coerceInput(input),\n    };\n  }\n\n  const payload = (\n    typeof input === \"object\" && input !== null ? input : {}\n  ) as SharedScopePayload;\n\n  if (typeof payload.sessionId !== \"string\" || payload.sessionId.length === 0) {\n    throw new SupervisorFailedError(\n      'orchestrator.asTool(): sessionScope \"shared\" requires a `sessionId` string in the tool input payload',\n    );\n  }\n\n  const { sessionId, history, ...rest } = payload;\n\n  return {\n    sessionId,\n    history: Array.isArray(history) ? (history as Message[]) : [],\n    executeInput: coerceInput(rest),\n  };\n}\n\n/**\n * Coerce a tool-input value into the `SupervisorInput` shape the\n * orchestrator's `execute()` accepts (`string | Record<string,\n * unknown>`). Strings and plain objects pass through; everything else\n * is JSON-stringified so the orchestrator receives a predictable input\n * regardless of how the outer agent shaped its call.\n */\nfunction coerceInput(value: unknown): SupervisorInput {\n  if (typeof value === \"string\") {\n    return value;\n  }\n\n  if (typeof value === \"object\" && value !== null) {\n    return value as Record<string, unknown>;\n  }\n\n  if (value === undefined || value === null) {\n    return \"\";\n  }\n\n  return String(value);\n}\n","import type { OrchestratorCommands } from \"../contracts/orchestrator/orchestrator-commands.type\";\nimport { SupervisorFailedError } from \"../errors\";\n\n/**\n * Per-command handler bag — one async runner per key of\n * {@link OrchestratorCommands}. The orchestrator factory supplies the\n * `compact` runner (which delegates to the shared compaction code path,\n * §11) so this module owns command ROUTING only, never the compaction\n * logic itself.\n *\n * Typed against the same discriminated map the public `command<K>`\n * method uses, so a registered handler's `args` / result line up with\n * the contract with no casting at the call site.\n */\nexport type OrchestratorCommandHandlers = {\n  [K in keyof OrchestratorCommands]: (\n    args: OrchestratorCommands[K][\"args\"],\n  ) => Promise<OrchestratorCommands[K][\"result\"]>;\n};\n\n/**\n * Build the typed `command(name, args)` dispatcher backing\n * {@link import(\"../contracts/orchestrator/orchestrator.contract\").OrchestratorContract.command}\n * (design §11). Looks the command up in the supplied handler bag and\n * forwards `args`, preserving the discriminated `OrchestratorCommands`\n * typing end to end.\n *\n * v1 ships exactly one built-in command, `compact`. v2 user commands\n * attach via module augmentation of `OrchestratorCommands`; the\n * dispatcher widens with the map automatically, and an unregistered\n * command throws {@link SupervisorFailedError} rather than silently\n * resolving `undefined`.\n *\n * @example\n * const command = createCommandDispatcher({\n *   compact: (args) => runCompaction(args),\n * });\n * const result = await command(\"compact\", { sessionId, history });\n */\nexport function createCommandDispatcher(handlers: OrchestratorCommandHandlers) {\n  return function command<K extends keyof OrchestratorCommands>(\n    name: K,\n    args: OrchestratorCommands[K][\"args\"],\n  ): Promise<OrchestratorCommands[K][\"result\"]> {\n    const handler = handlers[name];\n\n    if (typeof handler !== \"function\") {\n      throw new SupervisorFailedError(\n        `orchestrator.command(): unknown command \"${String(name)}\"`,\n      );\n    }\n\n    return handler(args);\n  };\n}\n","import type {\n  EventIdentity,\n  WithoutIdentity,\n} from \"../contracts/events/event-identity.type\";\nimport type {\n  OrchestratorEventHandler,\n  OrchestratorEventHandlers,\n  OrchestratorEventMap,\n  OrchestratorEventName,\n} from \"../contracts/orchestrator/orchestrator-event.type\";\n\n/** Full identity-stamped payload an orchestrator handler receives. */\ntype EventPayload<K extends OrchestratorEventName> = OrchestratorEventMap[K] &\n  EventIdentity;\n\n/**\n * Erased handler shape for the instance registry. Per-event handlers\n * are contravariant in their payload, so the registry stores them under\n * a single structural `(payload) => void` and re-narrows at the call\n * site — the `on` / `off` public surface keeps the precise per-event\n * typing.\n */\ntype AnyHandler = (payload: EventPayload<OrchestratorEventName>) => void;\n\n/**\n * Three-tier orchestrator event emitter — definition (factory) →\n * instance → per-call — for the `orchestrator.*` namespace (design\n * §14.3). Mirrors {@link import(\"../supervisor/emitter\").SupervisorEmitter}\n * structurally; the differences are the event map and a central\n * identity-injection chokepoint (`emit` accepts an identity-less\n * payload and stamps {@link EventIdentity} once so all three tiers, and\n * any mirror like the stream, see the same value).\n *\n * Owns: the instance-handler registry and the fan-out order. Does NOT\n * own: child `supervisor.*` / `agent.*` events — those bubble up\n * unmodified under their own identity (§14.2) and never pass through\n * this emitter. All matching handlers fire in tier order; a handler\n * throwing never derails the turn.\n *\n * @example\n * const emitter = new OrchestratorEmitter(config.on);\n * const off = emitter.on(\"orchestrator.turn.completed\", (event) => log(event));\n * emitter.emit(\n *   \"orchestrator.turn.starting\",\n *   { sessionId, turnIndex },\n *   { runId, rootRunId },\n *   perCallHandlers,\n * );\n */\nexport class OrchestratorEmitter {\n  private readonly factoryHandlers?: OrchestratorEventHandlers;\n  private readonly instanceHandlers = new Map<\n    OrchestratorEventName,\n    Set<AnyHandler>\n  >();\n\n  public constructor(factoryHandlers?: OrchestratorEventHandlers) {\n    this.factoryHandlers = factoryHandlers;\n  }\n\n  /**\n   * Subscribe an instance-level handler (tier 2). Returns an\n   * unsubscribe function equivalent to `off(event, handler)`.\n   */\n  public on<K extends OrchestratorEventName>(\n    event: K,\n    handler: OrchestratorEventHandler<K>,\n  ): () => void {\n    let bucket = this.instanceHandlers.get(event);\n\n    if (!bucket) {\n      bucket = new Set();\n      this.instanceHandlers.set(event, bucket);\n    }\n\n    bucket.add(handler as unknown as AnyHandler);\n\n    return () => this.off(event, handler);\n  }\n\n  /**\n   * Remove a previously-subscribed instance handler. No-op when the\n   * handler was never registered or already removed.\n   */\n  public off<K extends OrchestratorEventName>(\n    event: K,\n    handler: OrchestratorEventHandler<K>,\n  ): void {\n    this.instanceHandlers.get(event)?.delete(handler as unknown as AnyHandler);\n  }\n\n  /**\n   * Stamp run identity onto the payload, then fan out through all three\n   * tiers in order: definition → instance → per-call. Returns the full\n   * identity-stamped payload so the caller can mirror the same value\n   * into the stream controller (keeping `.on()` and iteration in lockstep).\n   */\n  public emit<K extends OrchestratorEventName>(\n    event: K,\n    payload: WithoutIdentity<OrchestratorEventMap[K]>,\n    identity: EventIdentity,\n    perCallHandlers?: OrchestratorEventHandlers,\n  ): EventPayload<K> {\n    const fullPayload = { ...payload, ...identity } as EventPayload<K>;\n\n    invoke(this.factoryHandlers?.[event], fullPayload);\n\n    const bucket = this.instanceHandlers.get(event);\n\n    if (bucket) {\n      for (const handler of bucket) {\n        invoke(handler as unknown as (payload: EventPayload<K>) => void, fullPayload);\n      }\n    }\n\n    invoke(perCallHandlers?.[event], fullPayload);\n\n    return fullPayload;\n  }\n}\n\n/**\n * Invoke a single handler, swallowing any throw. A listener bug must\n * never derail the orchestrator turn. Typed structurally (a plain\n * `(payload) => void`) so the identity-stamped payload flows in without\n * fighting the contravariant `OrchestratorEventHandler<K>` union.\n */\nfunction invoke<K extends OrchestratorEventName>(\n  handler: ((payload: EventPayload<K>) => void) | undefined,\n  payload: EventPayload<K>,\n): void {\n  if (typeof handler !== \"function\") {\n    return;\n  }\n\n  try {\n    handler(payload);\n  } catch {\n    // Listener bugs must not derail the orchestrator.\n  }\n}\n","import type { MemoryContract } from \"../contracts/memory/memory.contract\";\nimport type {\n  MemoryItem,\n  RecalledMemory,\n} from \"../contracts/memory/memory-item.type\";\nimport type { OrchestratorMemoryConfig } from \"../contracts/orchestrator/orchestrator-config.type\";\nimport type { TurnSnapshot } from \"../contracts/result/orchestrator-result.type\";\nimport type { SupervisorInput } from \"../contracts/supervisor/supervisor-input.type\";\n\n/** Default key the recalled memories are injected under in the context bag. */\nconst DEFAULT_INJECT_KEY = \"memories\";\n\n/**\n * Memory wiring resolved once per turn from `OrchestratorConfig.memory`\n * (memory core M2). Normalizes the two accepted config shapes — a bare\n * {@link MemoryContract} or the richer {@link OrchestratorMemoryConfig} —\n * into a single flat record the lifecycle phase reads, so `runTurn` never\n * branches on which form the dev supplied.\n */\nexport type ResolvedOrchestratorMemory = {\n  /** The store recalled-from before dispatch and remembered-into after. */\n  store: MemoryContract;\n  /** Recall count cap; `0` disables recall (write-only memory). */\n  k?: number;\n  /** Semantic-similarity floor for recall. */\n  threshold?: number;\n  /** Single-tier recall restriction. */\n  tier?: ResolvedTier;\n  /** Whether a clean turn writes its outcome back. Default `true`. */\n  remember: boolean;\n  /** Tier the remembered outcome lands in. Omit for the memory's `defaultTier`. */\n  rememberTier?: ResolvedTier;\n  /** Context-bag key the recalled memories are injected under. */\n  injectKey: string;\n};\n\ntype ResolvedTier = NonNullable<OrchestratorMemoryConfig[\"recall\"]>[\"tier\"];\n\n/**\n * A `MemoryContract` is the bare-store form; anything carrying a `store`\n * is the {@link OrchestratorMemoryConfig} wrapper. Distinguished by the\n * presence of `recall` — a method on the contract, absent on the config\n * (whose own `recall` is a plain options object, never a function).\n */\nfunction isBareMemory(\n  value: MemoryContract | OrchestratorMemoryConfig,\n): value is MemoryContract {\n  return typeof (value as MemoryContract).recall === \"function\";\n}\n\n/**\n * Normalize `OrchestratorConfig.memory` into {@link ResolvedOrchestratorMemory},\n * or `undefined` when no memory is configured. Centralizes the\n * bare-store-vs-config distinction so the engine context carries one\n * shape and the lifecycle phase stays branch-free.\n */\nexport function resolveOrchestratorMemory(\n  memory: MemoryContract | OrchestratorMemoryConfig | undefined,\n): ResolvedOrchestratorMemory | undefined {\n  if (!memory) {\n    return undefined;\n  }\n\n  if (isBareMemory(memory)) {\n    return {\n      store: memory,\n      remember: true,\n      injectKey: DEFAULT_INJECT_KEY,\n    };\n  }\n\n  return {\n    store: memory.store,\n    k: memory.recall?.k,\n    threshold: memory.recall?.threshold,\n    tier: memory.recall?.tier,\n    remember: memory.remember ?? true,\n    rememberTier: memory.rememberTier,\n    injectKey: memory.injectKey ?? DEFAULT_INJECT_KEY,\n  };\n}\n\n/**\n * Coerce a turn's {@link SupervisorInput} (string or structured object)\n * into the natural-language query the memory store recalls / embeds\n * against. Strings pass through; objects are JSON-serialized — the same\n * coercion the supervisor applies when forwarding an object input to a\n * child agent without an explicit `input(ctx)` override.\n */\nexport function memoryQueryFromInput(input: SupervisorInput): string {\n  return typeof input === \"string\" ? input : JSON.stringify(input);\n}\n\n/**\n * Recall the memories relevant to a turn's input (memory core M2 — the\n * pre-dispatch half). Returns the scored {@link RecalledMemory}[] the\n * lifecycle injects into the turn's `context` bag under\n * `memory.injectKey`. Returns an empty array — never throws on \"no hits\"\n * — and short-circuits when `k === 0` (recall disabled / write-only\n * memory) so a write-only config never round-trips the embedder.\n */\nexport async function recallForTurn(\n  memory: ResolvedOrchestratorMemory,\n  input: SupervisorInput,\n): Promise<RecalledMemory[]> {\n  if (memory.k === 0) {\n    return [];\n  }\n\n  return memory.store.recall(memoryQueryFromInput(input), {\n    k: memory.k,\n    threshold: memory.threshold,\n    tier: memory.tier,\n  });\n}\n\n/**\n * Merge the recalled memories into a fresh per-turn context bag under\n * `memory.injectKey` (memory core M2 — the injection half). Never\n * mutates the caller's `context` object — returns a new bag (or the\n * original when there is nothing to inject) so the request-scoped input\n * stays immutable, and the supervisor's intake (which freezes a\n * shallow copy) sees the recalled set on every `ctx.context[injectKey]`.\n *\n * A pre-existing value at `injectKey` is preserved when recall produced\n * nothing, and overwritten with the recalled set otherwise — the\n * orchestrator owns that key once memory is configured.\n */\nexport function injectMemories(\n  context: Record<string, unknown> | undefined,\n  memory: ResolvedOrchestratorMemory,\n  recalled: RecalledMemory[],\n): Record<string, unknown> | undefined {\n  if (recalled.length === 0) {\n    return context;\n  }\n\n  return { ...(context ?? {}), [memory.injectKey]: recalled };\n}\n\n/**\n * Remember a settled turn's outcome (memory core M2 — the post-dispatch\n * half). Called only after a clean turn (cancelled / failed turns revert\n * and never remember — §17). No-ops when `remember` is `false`\n * (read-only memory) or when the produced text is empty.\n *\n * The remembered text is the turn input followed by the model's textual\n * outcome when one is available, so a later `recall` keyed on a similar\n * input surfaces both the prior question and its answer.\n */\nexport async function rememberTurnOutcome(\n  memory: ResolvedOrchestratorMemory,\n  input: SupervisorInput,\n  outcomeText: string | undefined,\n): Promise<void> {\n  if (!memory.remember) {\n    return;\n  }\n\n  const text = buildOutcomeText(input, outcomeText);\n\n  if (!text) {\n    return;\n  }\n\n  const item: MemoryItem = { text, tier: memory.rememberTier };\n\n  await memory.store.remember(item);\n}\n\n/**\n * Compose the text written to memory for a turn: the input query, plus\n * the outcome text on a following line when the dispatch produced one.\n * Returns `undefined` when neither side carries content so an empty turn\n * never pollutes the store.\n */\nfunction buildOutcomeText(\n  input: SupervisorInput,\n  outcomeText: string | undefined,\n): string | undefined {\n  const query = memoryQueryFromInput(input).trim();\n  const outcome = outcomeText?.trim();\n\n  if (query && outcome) {\n    return `${query}\\n${outcome}`;\n  }\n\n  return query || outcome || undefined;\n}\n\n/**\n * Derive a turn's textual outcome for remembering (memory core M2).\n * Prefers the validated `result.data` (an `output` schema reshaped it);\n * otherwise stringifies the dispatched intents' branch outputs from the\n * turn snapshot, joined newline-wise so a multi-branch fan-out\n * contributes every output. Returns `undefined` when the turn produced\n * no usable text — the caller then remembers the input alone.\n */\nexport function outcomeTextFromTurn(\n  data: unknown,\n  turnSnapshot: TurnSnapshot,\n): string | undefined {\n  const fromData = stringifyOutcome(data);\n\n  if (fromData) {\n    return fromData;\n  }\n\n  const outputs = Object.values(turnSnapshot.result)\n    .map((branch) => stringifyOutcome(branch.output))\n    .filter((text): text is string => Boolean(text));\n\n  return outputs.length > 0 ? outputs.join(\"\\n\") : undefined;\n}\n\n/**\n * Coerce one outcome value to text: strings pass through; everything\n * else (objects, numbers) is JSON-serialized. `undefined` / `null` and\n * empty strings collapse to `undefined` so they don't masquerade as\n * content.\n */\nfunction stringifyOutcome(value: unknown): string | undefined {\n  if (value === undefined || value === null) {\n    return undefined;\n  }\n\n  const text = typeof value === \"string\" ? value : JSON.stringify(value);\n\n  return text.trim() ? text : undefined;\n}\n","import type { CheckpointRecord } from \"../contracts/orchestrator/checkpoint-store.contract\";\nimport type { Next } from \"../contracts/supervisor/next.type\";\nimport type { OrchestratorEngineContext } from \"./engine-context.type\";\n\n/** Framework default for snapshot retention per session (§4 Phase 6). */\nexport const DEFAULT_KEEP_SNAPSHOTS = 100;\n\n/** Fields the engine supplies to build a fresh checkpoint row. */\nexport type PersistParams<TState> = {\n  ctx: OrchestratorEngineContext<unknown, TState>;\n  sessionId: string;\n  turnIndex: number;\n  state: unknown;\n  /** Dispatch decision summary — a single intent, fan-out list, or null. */\n  lastRoute: string | string[] | null;\n  /** Carried forward from the loaded checkpoint (compaction progress). */\n  summarizedThrough: number | null;\n};\n\n/**\n * Summarize a supervisor dispatch decision into the `last_route`\n * checkpoint column (§4 Phase 6). A bare string passes through; a\n * fan-out array passes through; the `END` sentinel and anything else\n * collapse to `null` (the turn routed nowhere worth recording).\n */\nexport function summarizeRoute(next: Next | undefined): string | string[] | null {\n  if (typeof next === \"string\") {\n    return next === \"__warlock:end__\" ? null : next;\n  }\n\n  if (Array.isArray(next)) {\n    return next;\n  }\n\n  return null;\n}\n\n/**\n * Phase 6 — persist checkpoint (orchestrator.md §3 / §4 Phase 6).\n * Writes a fresh append-only row at `turn_index = N` carrying the\n * post-merge `state`, the current `signature` (read by the next call's\n * Phase 2), the informational `version`, the dispatch `last_route`, and\n * the carried-forward `summarized_through`. Lock columns are written\n * `null` here — they are populated only by an in-flight Phase 7\n * compaction.\n *\n * Emits `orchestrator.checkpoint.persisted` after the row lands, then\n * prunes to `keepSnapshots` (default 100; `\"all\"` opts out) — §4 Phase\n * 6 pruning (Q20). Pruning runs only when the store exposes the\n * optional `prune` hook (memory/pg/redis own their own pruning); when\n * absent the write still succeeds.\n *\n * Returns the persisted record so the engine can fold it into the\n * turn's report.\n */\nexport async function persistCheckpoint<TState>(\n  params: PersistParams<TState>,\n): Promise<CheckpointRecord> {\n  const { ctx, sessionId, turnIndex, state, lastRoute, summarizedThrough } = params;\n\n  const record: CheckpointRecord = {\n    orchestrator_name: ctx.config.name,\n    session_id: sessionId,\n    turn_index: turnIndex,\n    state,\n    last_route: lastRoute,\n    signature: ctx.signature,\n    version: ctx.config.version ?? null,\n    summarized_through: summarizedThrough,\n    lock_acquired_at: null,\n    lock_expires_at: null,\n    saved_at: new Date().toISOString(),\n  };\n\n  await ctx.checkpointStore.save(record);\n\n  ctx.emitter.emit(\"orchestrator.checkpoint.persisted\", {\n    sessionId,\n    turnIndex,\n  });\n\n  await prune(ctx, sessionId, turnIndex);\n\n  return record;\n}\n\n/**\n * Prune session rows older than `max_turn_index - keepSnapshots` (§4\n * Phase 6). Synchronous-after-save; opted out with\n * `keepSnapshots: \"all\"`. Delegated to an optional store-side `prune`\n * hook so each driver implements deletion in its own dialect — the\n * engine never reaches into store internals.\n */\nasync function prune<TState>(\n  ctx: OrchestratorEngineContext<unknown, TState>,\n  sessionId: string,\n  latestTurnIndex: number,\n): Promise<void> {\n  const keep = ctx.config.keepSnapshots ?? DEFAULT_KEEP_SNAPSHOTS;\n\n  if (keep === \"all\") {\n    return;\n  }\n\n  const store = ctx.checkpointStore as {\n    prune?: (\n      orchestratorName: string,\n      sessionId: string,\n      keepBeforeTurnIndex: number,\n    ) => Promise<void>;\n  };\n\n  if (typeof store.prune !== \"function\") {\n    return;\n  }\n\n  const keepBeforeTurnIndex = latestTurnIndex - keep + 1;\n\n  if (keepBeforeTurnIndex <= 0) {\n    return;\n  }\n\n  await store.prune(ctx.config.name, sessionId, keepBeforeTurnIndex);\n}\n","import type { CheckpointRecord } from \"../contracts/orchestrator/checkpoint-store.contract\";\nimport type { SummarizeConfig } from \"../contracts/orchestrator/orchestrator-config.type\";\nimport type { OrchestratorEngineContext } from \"./engine-context.type\";\n\n/** Framework default for the compaction-lock wait, in ms (§3 / §12.3). */\nexport const DEFAULT_LOCK_MAX_WAIT = 30_000;\n\n/** Poll interval while waiting on a held lock, in ms. */\nconst LOCK_POLL_INTERVAL = 100;\n\n/**\n * Resolve the configured `summarize.lock.maxWait`, falling back to the\n * framework default. The callback form of `summarize` carries no lock\n * config, so it uses the default.\n */\nfunction resolveMaxWait(ctx: OrchestratorEngineContext): number {\n  const summarize = ctx.config.summarize;\n\n  if (typeof summarize === \"function\" || summarize === undefined) {\n    return DEFAULT_LOCK_MAX_WAIT;\n  }\n\n  return (summarize as SummarizeConfig).lock?.maxWait ?? DEFAULT_LOCK_MAX_WAIT;\n}\n\n/** Whether a checkpoint's lock is still held relative to `now`. */\nfunction isLocked(record: CheckpointRecord, now: number): boolean {\n  if (!record.lock_expires_at) {\n    return false;\n  }\n\n  const expiresAt = Date.parse(record.lock_expires_at);\n\n  return Number.isFinite(expiresAt) && expiresAt > now;\n}\n\n/**\n * Outcome of Phase 3. `waited` is true when the turn observed a held\n * lock and spent time waiting; `waitedMs` is how long. `failedOpen` is\n * true when the wait timed out and the turn proceeds without the lock\n * (orchestrator.md §3 / §12.3 — a stuck summarizer must never block a\n * session forever).\n */\nexport type LockOutcome = {\n  waited: boolean;\n  waitedMs: number;\n  failedOpen: boolean;\n};\n\n/**\n * Phase 3 — lock check (orchestrator.md §3 / §4 Phase 3). The loaded\n * checkpoint may carry a compaction lock written by a prior turn's\n * Phase 7 (or by `command(\"compact\")`). When the lock is still live,\n * wait up to `summarize.lock.maxWait` (default 30s), re-loading the\n * latest checkpoint each poll, then **fail open** — proceed without\n * the lock.\n *\n * Emits `orchestrator.lock.waiting` once, only when a held lock is\n * observed (§14.1 — \"only when locked\"). The dispatch then runs\n * against whatever state was written before the lock was taken (§3).\n *\n * A new session (`loaded === undefined`) is never locked, so this\n * returns immediately.\n */\nexport async function acquireLock<TState>(\n  ctx: OrchestratorEngineContext<unknown, TState>,\n  sessionId: string,\n  loaded: CheckpointRecord | undefined,\n): Promise<LockOutcome> {\n  if (!loaded || !isLocked(loaded, Date.now())) {\n    return { waited: false, waitedMs: 0, failedOpen: false };\n  }\n\n  const maxWait = resolveMaxWait(ctx as OrchestratorEngineContext);\n  const startedAt = Date.now();\n\n  ctx.emitter.emit(\"orchestrator.lock.waiting\", { sessionId, waitedMs: 0 });\n\n  let latest: CheckpointRecord | undefined = loaded;\n\n  while (latest && isLocked(latest, Date.now())) {\n    const waitedMs = Date.now() - startedAt;\n\n    if (waitedMs >= maxWait) {\n      return { waited: true, waitedMs, failedOpen: true };\n    }\n\n    await delay(Math.min(LOCK_POLL_INTERVAL, maxWait - waitedMs));\n\n    latest = await ctx.checkpointStore.load(ctx.config.name, sessionId);\n  }\n\n  return { waited: true, waitedMs: Date.now() - startedAt, failedOpen: false };\n}\n\n/** Promise-based sleep used by the cooperative wait loop. */\nfunction delay(ms: number): Promise<void> {\n  return new Promise((resolve) => {\n    setTimeout(resolve, ms);\n  });\n}\n","import type { Message } from \"../contracts/conversation-message.type\";\nimport type {\n  SummarizeCallback,\n  SummarizeConfig,\n} from \"../contracts/orchestrator/orchestrator-config.type\";\nimport type { CompactionResult } from \"../contracts/result/orchestrator-result.type\";\nimport type { OrchestratorEngineContext } from \"./engine-context.type\";\nimport { DEFAULT_LOCK_MAX_WAIT } from \"./lock\";\n\n/**\n * Most-recent messages kept verbatim when `summarize.keep` is omitted.\n * Defaulting to 0 would compact the entire history into one memo (losing\n * the live tail every turn), so the object form keeps a small recent\n * window by default — matching the canonical doc examples (`keep: 8`).\n */\nexport const DEFAULT_COMPACTION_KEEP = 8;\n\n/** Whether the configured `summarize` is the fully-pluggable callback form. */\nfunction isCallbackForm(\n  summarize: SummarizeConfig | SummarizeCallback | undefined,\n): summarize is SummarizeCallback {\n  return typeof summarize === \"function\";\n}\n\n/**\n * Decide whether Phase 7 compaction should fire this turn (orchestrator\n * .md §4 Phase 7 / §12.1). v1 trigger is count-based:\n * `summarize.afterTurns` fires once `turnIndex >= afterTurns`. The\n * callback form has no threshold and never auto-fires — it is driven\n * exclusively by `command(\"compact\")` (the manual path). Returns false\n * when `summarize` is unset.\n */\nexport function shouldCompact(\n  ctx: OrchestratorEngineContext,\n  turnIndex: number,\n): boolean {\n  const summarize = ctx.config.summarize;\n\n  if (summarize === undefined || isCallbackForm(summarize)) {\n    return false;\n  }\n\n  const afterTurns = summarize.afterTurns;\n\n  return afterTurns !== undefined && turnIndex >= afterTurns;\n}\n\n/** Result of a Phase-7 run — what the engine folds into the turn. */\nexport type CompactionOutcome = {\n  /** The produced compaction, surfaced on `result.compaction`. */\n  compaction: CompactionResult;\n  /**\n   * Whether `summarize.onCompact` ran AND succeeded — when true the\n   * engine advances `summarized_through` to `replacesToIndex` (§12.2\n   * step 4); when false it leaves it unchanged (§12.2 step 5).\n   */\n  applied: boolean;\n};\n\n/**\n * Run the configured summarizer against the session history and build\n * a {@link CompactionResult} (§12.2 step 2–3). Three resolution paths:\n *\n * - callback form — `summarize(history)` returns the result directly.\n * - config + `summarizer` model — summarize the slice (history minus\n *   the most-recent `keep`) into one synthetic memo turn.\n * - config without a `summarizer` — produce a trivial degenerate memo\n *   (no model available); the dev is expected to supply a summarizer\n *   for real compaction. The range still reflects the kept tail.\n */\nasync function produceCompaction(\n  summarize: SummarizeConfig | SummarizeCallback,\n  history: Message[],\n): Promise<CompactionResult> {\n  if (isCallbackForm(summarize)) {\n    return summarize(history);\n  }\n\n  const keep = summarize.keep ?? DEFAULT_COMPACTION_KEEP;\n  const replacesFromIndex = 0;\n  const replacesToIndex = Math.max(-1, history.length - keep - 1);\n  const slice = history.slice(0, replacesToIndex + 1);\n\n  const summaryText = await summarizeSlice(summarize, slice);\n\n  return {\n    summary: { role: \"system\", content: summaryText },\n    replacesFromIndex,\n    replacesToIndex,\n  };\n}\n\n/**\n * Summarize a slice of history into text. Uses the configured\n * `summarizer` model when present (a single non-streaming completion);\n * otherwise returns a placeholder memo. The summarizer is intentionally\n * the cheap model — never the specialists (§12.4).\n */\nasync function summarizeSlice(\n  summarize: SummarizeConfig,\n  slice: Message[],\n): Promise<string> {\n  if (slice.length === 0) {\n    return \"\";\n  }\n\n  if (!summarize.summarizer) {\n    return `Summary of ${slice.length} prior message(s).`;\n  }\n\n  const transcript = slice\n    .map((message) => `${message.role}: ${stringifyContent(message.content)}`)\n    .join(\"\\n\");\n\n  const response = await summarize.summarizer.complete([\n    {\n      role: \"system\",\n      content:\n        \"Summarize the following conversation slice into a concise memo \" +\n        \"that preserves the facts, decisions, and open threads a later \" +\n        \"turn would need. Reply with the memo only.\",\n    },\n    { role: \"user\", content: transcript },\n  ]);\n\n  return response.content;\n}\n\n/** Coerce a message's content into a flat string for the summarizer prompt. */\nfunction stringifyContent(content: Message[\"content\"]): string {\n  if (typeof content === \"string\") {\n    return content;\n  }\n\n  return JSON.stringify(content);\n}\n\n/**\n * Phase 7 — post-turn compaction (orchestrator.md §3 / §4 Phase 7 /\n * §12.2). Runs AFTER the turn settles; never blocks the caller's\n * resolution path beyond this phase.\n *\n * Acquires the cooperative session lock (writes `lock_acquired_at` /\n * `lock_expires_at` onto a fresh row), runs the summarizer, builds the\n * compaction, then either invokes `summarize.onCompact` (framework-\n * driven apply) or surfaces the compaction on the result for the dev to\n * apply. Releases the lock on settle. Emits\n * `orchestrator.compaction.suggested` always,\n * `orchestrator.compaction.applied` only when `onCompact` succeeded, and\n * `orchestrator.compaction.failed` (carrying the thrown `error` and the\n * `phase` that failed) when the summarizer or `onCompact` throws.\n *\n * Retry policy is skip-and-log (§4 Phase 7): a summarizer failure\n * leaves the session running with unchanged history — the engine\n * treats a thrown summarizer / `onCompact` as \"no compaction this\n * turn\", emits `orchestrator.compaction.failed`, and returns `undefined`\n * (summarizer) or surfaces the unapplied compaction (`onCompact`).\n */\nexport async function runCompaction<TState>(\n  ctx: OrchestratorEngineContext<unknown, TState>,\n  sessionId: string,\n  history: Message[],\n): Promise<CompactionOutcome | undefined> {\n  const summarize = ctx.config.summarize;\n\n  if (summarize === undefined) {\n    return undefined;\n  }\n\n  await acquireCompactionLock(ctx, sessionId);\n\n  try {\n    const compaction = await produceCompaction(summarize, history);\n\n    ctx.emitter.emit(\"orchestrator.compaction.suggested\", {\n      sessionId,\n      compaction,\n    });\n\n    const onCompact = isCallbackForm(summarize) ? undefined : summarize.onCompact;\n\n    if (!onCompact) {\n      return { compaction, applied: false };\n    }\n\n    try {\n      await onCompact(compaction, { sessionId });\n\n      ctx.emitter.emit(\"orchestrator.compaction.applied\", {\n        sessionId,\n        compaction,\n      });\n\n      return { compaction, applied: true };\n    } catch (error) {\n      // onCompact threw — surface the compaction for the dev to apply,\n      // leave summarized_through unchanged (§12.2 step 4 failure path).\n      ctx.emitter.emit(\"orchestrator.compaction.failed\", {\n        sessionId,\n        phase: \"onCompact\",\n        error,\n      });\n\n      return { compaction, applied: false };\n    }\n  } catch (error) {\n    // Summarizer failed — skip-and-log; session keeps running unchanged.\n    ctx.emitter.emit(\"orchestrator.compaction.failed\", {\n      sessionId,\n      phase: \"summarize\",\n      error,\n    });\n\n    return undefined;\n  } finally {\n    await releaseCompactionLock(ctx, sessionId);\n  }\n}\n\n/**\n * Run a manual compaction for `command(\"compact\", ...)` (§11 / §12.1).\n * Same code path as the post-turn trigger but driven on demand against\n * the supplied history, returning the raw {@link CompactionResult}. The\n * callback form is honored; the config form without a `summarizer`\n * produces the degenerate memo. Does not apply `onCompact` — the\n * command surface returns the compaction for the caller to handle.\n */\nexport async function runManualCompaction<TState>(\n  ctx: OrchestratorEngineContext<unknown, TState>,\n  history: Message[],\n): Promise<CompactionResult> {\n  const summarize = ctx.config.summarize;\n\n  if (summarize === undefined) {\n    // No summarize policy configured — produce a degenerate memo over\n    // the full supplied history so the command always resolves.\n    return {\n      summary: { role: \"system\", content: `Summary of ${history.length} message(s).` },\n      replacesFromIndex: 0,\n      replacesToIndex: Math.max(-1, history.length - 1),\n    };\n  }\n\n  return produceCompaction(summarize, history);\n}\n\n/** Resolve the lock TTL from the summarize config (config form only). */\nfunction resolveLockMaxWait(ctx: OrchestratorEngineContext): number {\n  const summarize = ctx.config.summarize;\n\n  if (summarize === undefined || isCallbackForm(summarize)) {\n    return DEFAULT_LOCK_MAX_WAIT;\n  }\n\n  return summarize.lock?.maxWait ?? DEFAULT_LOCK_MAX_WAIT;\n}\n\n/**\n * Write the cooperative compaction lock onto a fresh checkpoint row\n * (§12.2 step 1). The lock lives on the latest persisted row; we load\n * it, stamp the lock columns, and re-save (append-only) so the next\n * turn's Phase 3 observes it.\n */\nasync function acquireCompactionLock<TState>(\n  ctx: OrchestratorEngineContext<unknown, TState>,\n  sessionId: string,\n): Promise<void> {\n  const latest = await ctx.checkpointStore.load(ctx.config.name, sessionId);\n\n  if (!latest) {\n    return;\n  }\n\n  const now = Date.now();\n  const maxWait = resolveLockMaxWait(ctx as OrchestratorEngineContext);\n\n  await ctx.checkpointStore.save({\n    ...latest,\n    lock_acquired_at: new Date(now).toISOString(),\n    lock_expires_at: new Date(now + maxWait).toISOString(),\n    saved_at: new Date(now).toISOString(),\n  });\n}\n\n/**\n * Clear the compaction lock columns (§12.2 step 6) by re-saving the\n * latest row with the lock fields nulled.\n */\nasync function releaseCompactionLock<TState>(\n  ctx: OrchestratorEngineContext<unknown, TState>,\n  sessionId: string,\n): Promise<void> {\n  const latest = await ctx.checkpointStore.load(ctx.config.name, sessionId);\n\n  if (!latest) {\n    return;\n  }\n\n  await ctx.checkpointStore.save({\n    ...latest,\n    lock_acquired_at: null,\n    lock_expires_at: null,\n    saved_at: new Date().toISOString(),\n  });\n}\n","import type {\n  SupervisorAsToolOptions,\n  SupervisorContract,\n} from \"../contracts/supervisor/supervisor.contract\";\nimport { SupervisorFailedError } from \"../errors\";\nimport { compositeAsTool, type ToolContract } from \"../tool/tool\";\n\n/**\n * Wrap a `SupervisorContract` as a `ToolContract` so an outer agent\n * can invoke it from its tool-call loop. Mirrors\n * `workflow.asTool()` / `agent.asTool()` — same composition pattern,\n * same error-normalization behavior.\n *\n * Behavior:\n * - The tool's `name` mirrors the supervisor's `name` unless the\n *   caller overrides via `options.name`. Supervisors without a\n *   meaningful name throw `SupervisorFailedError` — an outer agent\n *   can't route to an anonymous tool.\n * - Tool `input` is the supplied schema; the validated value is\n *   coerced to a string (via `String()` for non-string values, or\n *   `JSON.stringify()` for objects) before being forwarded to\n *   `supervisor.execute(input)`. Consumers whose inputs need\n *   richer shaping should pre-format the string themselves.\n * - On `result.error`, the supervisor error is thrown so the tool\n *   wrapper catches it and produces a `ToolExecutionError` with\n *   `cause` set to the original typed supervisor error — the outer\n *   agent sees one uniform error class regardless of which\n *   primitive failed.\n *\n * @example\n * const support = ai.supervisor({ ... });\n * const supportTool = support.asTool({\n *   name: \"handle_support_ticket\",\n *   description: \"Process a customer support ticket end-to-end.\",\n *   inputSchema: z.object({ ticket: z.string() }),\n * });\n * const concierge = ai.agent({ model, tools: [supportTool] });\n */\nexport function asTool<TOutput, TToolInput>(\n  supervisorInstance: SupervisorContract<TOutput>,\n  options: SupervisorAsToolOptions<TToolInput>,\n): ToolContract<TToolInput, TOutput> {\n  if (!supervisorInstance.name || typeof supervisorInstance.name !== \"string\") {\n    throw new SupervisorFailedError(\n      \"supervisor.asTool(): supervisor must have a `name` to be wrapped as a tool\",\n    );\n  }\n\n  return compositeAsTool<TToolInput, TOutput>({\n    name: options.name ?? supervisorInstance.name,\n    description: options.description ?? `Invoke supervisor \"${supervisorInstance.name}\" as a tool.`,\n    input: options.inputSchema,\n    execute: async (input) => {\n      const coerced = coerceInput(input);\n      const result = await supervisorInstance.execute(coerced);\n\n      if (result.error) {\n        // Surface the typed supervisor error — the outer ToolContract\n        // wraps it as a ToolExecutionError with `cause` preserved.\n        throw result.error;\n      }\n\n      return {\n        data: result.data as TOutput,\n        usage: result.usage,\n        report: result.report,\n      };\n    },\n  });\n}\n\n/**\n * Coerce a tool-input value into the `string` shape supervisor\n * `execute()` expects. Strings pass through; everything else gets\n * JSON-stringified so supervisors invoked via tool wrappers receive a\n * predictable textual input regardless of how the outer agent shaped\n * its call.\n */\nfunction coerceInput(value: unknown): string {\n  if (typeof value === \"string\") {\n    return value;\n  }\n\n  if (value === undefined || value === null) {\n    return \"\";\n  }\n\n  try {\n    return JSON.stringify(value);\n  } catch {\n    return String(value);\n  }\n}\n","import type { SupervisorEventMap } from \"../contracts/events/event-map.type\";\nimport type {\n  SupervisorEventHandler,\n  SupervisorEventHandlers,\n} from \"../contracts/supervisor/supervisor-config.type\";\n\ntype AnyHandler = SupervisorEventHandler<keyof SupervisorEventMap>;\n\n/**\n * Three-tier supervisor event emitter — factory (definition) → instance\n * → per-execution. Mirrors `WorkflowEmitter` structurally; the only\n * difference is the event map. All matching handlers fire in layer\n * order. Handler errors are swallowed so a listener bug can never\n * derail the run.\n *\n * @example\n * const emitter = new SupervisorEmitter(definition.on);\n * const unsubscribe = emitter.on(\"supervisor.completed\", (payload) => ...);\n * emitter.emit(\"supervisor.starting\", { runId, rootRunId, supervisorName, input }, perCallHandlers);\n */\nexport class SupervisorEmitter {\n  private readonly factoryHandlers?: SupervisorEventHandlers;\n  private readonly instanceHandlers = new Map<\n    keyof SupervisorEventMap,\n    Set<AnyHandler>\n  >();\n\n  public constructor(factoryHandlers?: SupervisorEventHandlers) {\n    this.factoryHandlers = factoryHandlers;\n  }\n\n  public on<K extends keyof SupervisorEventMap>(\n    event: K,\n    handler: SupervisorEventHandler<K>,\n  ): () => void {\n    let bucket = this.instanceHandlers.get(event);\n\n    if (!bucket) {\n      bucket = new Set();\n      this.instanceHandlers.set(event, bucket);\n    }\n\n    bucket.add(handler as AnyHandler);\n\n    return () => this.off(event, handler);\n  }\n\n  public off<K extends keyof SupervisorEventMap>(\n    event: K,\n    handler: SupervisorEventHandler<K>,\n  ): void {\n    this.instanceHandlers.get(event)?.delete(handler as AnyHandler);\n  }\n\n  public emit<K extends keyof SupervisorEventMap>(\n    event: K,\n    payload: SupervisorEventMap[K],\n    executionHandlers?: SupervisorEventHandlers,\n  ): void {\n    invoke(this.factoryHandlers?.[event], payload);\n\n    const bucket = this.instanceHandlers.get(event);\n\n    if (bucket) {\n      for (const handler of bucket) {\n        invoke(handler, payload);\n      }\n    }\n\n    invoke(executionHandlers?.[event], payload);\n  }\n}\n\nfunction invoke<K extends keyof SupervisorEventMap>(\n  handler: ((payload: SupervisorEventMap[K]) => void) | undefined,\n  payload: SupervisorEventMap[K],\n): void {\n  if (typeof handler !== \"function\") {\n    return;\n  }\n\n  try {\n    handler(payload);\n  } catch {\n    // Listener bugs must not derail the supervisor.\n  }\n}\n","import type { StandardSchemaV1 } from \"@standard-schema/spec\";\nimport type { AgentContract } from \"../contracts/agent/agent.contract\";\nimport type { Message } from \"../contracts/conversation-message.type\";\nimport type { EndSentinel } from \"../contracts/end.type\";\nimport type { AgentResult } from \"../contracts/result/agent-result.type\";\nimport type { WorkflowResult } from \"../contracts/result/workflow-result.type\";\nimport type { DispatchContext } from \"../contracts/supervisor/dispatch-context.type\";\nimport type {\n  DispatchRawResult,\n  IntentCallback,\n  IntentEntry,\n  IntentRunEntry,\n  SupervisorIntentValue,\n} from \"../contracts/supervisor/intent-entry.type\";\nimport type { RouteContext } from \"../contracts/supervisor/route-context.type\";\nimport type { SupervisorConfig } from \"../contracts/supervisor/supervisor-config.type\";\nimport type { WorkflowInstance } from \"../contracts/workflow/workflow.contract\";\nimport { SupervisorFailedError } from \"../errors\";\n\n/**\n * Normalized internal representation of one entry in a supervisor's\n * `intents` map — resolved at factory time from one of the accepted\n * value forms (bare agent / workflow / callback / object entry).\n *\n * Carrying the explicit `type` discriminator keeps downstream code\n * (execution, signature, router-prompt) from having to re-detect\n * shape on every dispatch. The discriminated union below replaces\n * the flat-shape used in Phase 3 so callbacks can carry their own\n * function reference + dispatch-context-shaped resolvers.\n *\n * Discriminator renamed `kind` → `type` (Q12) for codebase-wide\n * consistency — every other discriminated result/report shape uses\n * `type`.\n */\nexport type ResolvedIntentEntry =\n  | ResolvedAgentEntry\n  | ResolvedWorkflowEntry\n  | ResolvedCallbackEntry;\n\n/**\n * Successor directive function type — the resolver-time projection of\n * `IntentEntry.next` / `IntentRunEntry.next`. Single source of truth\n * across the three resolved variants.\n */\nexport type IntentNext = (ctx: DispatchContext) => string | string[] | EndSentinel | undefined;\n\n/**\n * Resolver-time projection of `IntentEntry.history` /\n * `RouterEntry.history` / `AckEntry.history`. Custom slicer that\n * REPLACES the default `historyWindow.<role>` slice.\n */\nexport type EntryHistorySlicer = (ctx: RouteContext) => Message[] | ReadonlyArray<Message>;\n\nexport type ResolvedAgentEntry = {\n  intent: string;\n  type: \"agent\";\n  unit: AgentContract<unknown>;\n  description: string;\n  input?: (ctx: RouteContext) => string;\n  /**\n   * Per-dispatch placeholder values for the agent's systemPrompt\n   * template. Forwarded as `agent.execute(input, { placeholders })`.\n   * Phase 3.4 (Stage 4b) — replaces the dropped `composeAgentInput`\n   * mechanism for threading state into agents.\n   */\n  placeholders?: (ctx: DispatchContext) => Record<string, unknown>;\n  /**\n   * Schema declaring this intent's slice of supervisor state. Agent\n   * output is strip-merged against it; only validated keys appear on\n   * `IterationSnapshot.result[intent].output` AND merge into\n   * supervisor `state`.\n   */\n  output?: StandardSchemaV1<unknown>;\n  /**\n   * Successor directive (Stage 4d / Q24). When present, runs after\n   * this branch's slice merges into state to choose the next dispatch\n   * (or terminate) without invoking the router.\n   */\n  next?: IntentNext;\n  /**\n   * Custom history slicer — replaces the default\n   * `historyWindow.agents` slice when supplied. See `IntentEntry.history`.\n   */\n  history?: EntryHistorySlicer;\n  /**\n   * Phase 5 / decisions §34. `\"stream\"` runs the agent without\n   * structured-output coercion and writes the assembled prose into\n   * `state[streamTo]`; `\"structured\"` is the default. Resolved at\n   * factory time — `undefined` here is treated as `\"structured\"`.\n   */\n  mode?: \"structured\" | \"stream\";\n  /** State key the assembled stream-mode prose writes into. Set iff `mode === \"stream\"`. */\n  streamTo?: string;\n};\n\nexport type ResolvedWorkflowEntry = {\n  intent: string;\n  type: \"workflow\";\n  unit: WorkflowInstance<unknown, unknown>;\n  description: string;\n  input?: (ctx: RouteContext) => string;\n  placeholders?: (ctx: DispatchContext) => Record<string, unknown>;\n  output?: StandardSchemaV1<unknown>;\n  next?: IntentNext;\n  history?: EntryHistorySlicer;\n};\n\nexport type ResolvedCallbackEntry = {\n  intent: string;\n  type: \"callback\";\n  /**\n   * The callback that actually runs at dispatch time. Always present\n   * regardless of whether the user passed bare-function shorthand or\n   * the `{ run, ... }` entry form.\n   */\n  callback: IntentCallback;\n  /**\n   * Description is required only when the supervisor uses a router.\n   * Callback intents under a router are validated separately\n   * (see {@link assertRouterDescriptions}); under deterministic\n   * `route` mode this field is `undefined`.\n   */\n  description?: string;\n  /**\n   * Per-intent input resolver. Receives the upcoming\n   * `DispatchContext` and returns the value forwarded as\n   * `ctx.input` to the callback.\n   */\n  input?: (ctx: DispatchContext) => unknown;\n  placeholders?: (ctx: DispatchContext) => Record<string, unknown>;\n  /**\n   * Schema declaring this callback's slice of state. Without it, the\n   * full return value shallow-merges; with it, return is strip-merged\n   * to declared keys before merging.\n   */\n  output?: StandardSchemaV1<unknown>;\n  next?: IntentNext;\n};\n\n/**\n * Validate and normalize the `intents` map into resolved entries.\n * Runs at factory time — throws `SupervisorFailedError` on the first\n * malformed entry so author-time bugs surface immediately rather\n * than mid-run.\n *\n * Validation rules:\n * - Every value must be an agent, a workflow, a callback function,\n *   or an object entry with `agent` / `workflow` / `run`.\n * - Object entries with more than one of `{ agent, workflow, run }`\n *   throw with code `SUPERVISOR_INTENT_MIXED_DISPATCH`.\n * - Agent / workflow / agent-shaped entries must resolve to a\n *   non-empty description from the underlying unit or the entry's\n *   `description` override. Bare callback shorthand has no\n *   description source — that's enforced separately by\n *   {@link assertRouterDescriptions} when a router is configured.\n */\nexport function resolveIntentEntries(\n  rawIntents: Record<string, SupervisorIntentValue>,\n  supervisorName: string,\n): Map<string, ResolvedIntentEntry> {\n  const entries = Object.entries(rawIntents);\n\n  if (entries.length === 0) {\n    throw new SupervisorFailedError(\n      `ai.supervisor(\"${supervisorName}\"): \\`intents\\` must contain at least one entry`,\n      { context: { authoring: true } },\n    );\n  }\n\n  const resolved = new Map<string, ResolvedIntentEntry>();\n\n  for (const [intent, value] of entries) {\n    if (!intent || typeof intent !== \"string\") {\n      throw new SupervisorFailedError(\n        `ai.supervisor(\"${supervisorName}\"): every \\`intents\\` key must be a non-empty string`,\n        { context: { authoring: true } },\n      );\n    }\n\n    resolved.set(intent, resolveOne(intent, value, supervisorName));\n  }\n\n  return resolved;\n}\n\n/**\n * Construction-time guard: when the supervisor is configured with a\n * `router`, every intent must resolve to a non-empty description so\n * the router LLM has a signal for picking it. Bare callback\n * shorthand and `IntentRunEntry` without `description` fail this\n * check; agents and workflows whose underlying primitive lacks a\n * description fail too — same uniform error message.\n *\n * Deterministic `route` callers skip this check entirely.\n */\nexport function assertRouterDescriptions(\n  config: SupervisorConfig<unknown>,\n  entries: Map<string, ResolvedIntentEntry>,\n): void {\n  if (!config.router) {\n    return;\n  }\n\n  for (const [intent, entry] of entries) {\n    const description = entry.type === \"callback\" ? entry.description : entry.description;\n\n    if (description && description.trim().length > 0) {\n      continue;\n    }\n\n    const fix =\n      entry.type === \"callback\"\n        ? \"upgrade the bare callback to `{ run, description }`\"\n        : \"set `description` on the agent/workflow or via the `IntentEntry` `description` override\";\n\n    throw new SupervisorFailedError(\n      `ai.supervisor(\"${config.name}\"): intents[\"${intent}\"] needs a description because a \\`router\\` is configured — ${fix}`,\n      { context: { authoring: true, intent } },\n      \"SUPERVISOR_INTENT_DESCRIPTION_REQUIRED\",\n    );\n  }\n}\n\nfunction resolveOne(\n  intent: string,\n  value: SupervisorIntentValue,\n  supervisorName: string,\n): ResolvedIntentEntry {\n  // (c) Bare callback shorthand — typeof function. Highest priority\n  // so a user passing `(ctx) => …` never accidentally matches the\n  // object-shape branches below.\n  if (typeof value === \"function\") {\n    return {\n      intent,\n      type: \"callback\",\n      callback: value as IntentCallback,\n      description: undefined,\n    };\n  }\n\n  if (!value || typeof value !== \"object\") {\n    throw new SupervisorFailedError(\n      `ai.supervisor(\"${supervisorName}\"): intents[\"${intent}\"] is not an agent, workflow, callback, or entry object`,\n      { context: { authoring: true, intent } },\n    );\n  }\n\n  // Detect mixed-dispatch entries up front. Two of `{ agent, workflow,\n  // run }` together is dev confusion, not a feature.\n  assertSingleDispatchField(intent, value, supervisorName);\n\n  // (d.run) Run-entry — `{ run, description?, input?, output? }`.\n  if (\"run\" in value && typeof (value as IntentRunEntry).run === \"function\") {\n    const entry = value as IntentRunEntry;\n\n    return {\n      intent,\n      type: \"callback\",\n      callback: entry.run,\n      description: entry.description,\n      input: entry.input,\n      placeholders: entry.placeholders,\n      output: entry.output,\n      next: entry.next,\n    };\n  }\n\n  // (d.agent / a / b) Agent-entry or bare unit. The existing\n  // `IntentEntry` shape uses `agent: AgentContract | WorkflowInstance`\n  // for both agent and workflow object entries; the resolver still\n  // dispatches the underlying unit kind correctly.\n  const entryForm = asAgentEntryForm(value);\n  const unit = entryForm\n    ? entryForm.agent\n    : (value as AgentContract<unknown> | WorkflowInstance<unknown, unknown>);\n\n  if (!isDispatchableUnit(unit)) {\n    throw new SupervisorFailedError(\n      `ai.supervisor(\"${supervisorName}\"): intents[\"${intent}\"] must be an AgentContract, WorkflowInstance, callback, or entry object`,\n      { context: { authoring: true, intent } },\n    );\n  }\n\n  const detectedType = detectType(unit);\n  const description = resolveAgentLikeDescription(intent, entryForm, unit, supervisorName);\n\n  if (detectedType === \"workflow\") {\n    if (entryForm?.mode === \"stream\") {\n      throw new SupervisorFailedError(\n        `ai.supervisor(\"${supervisorName}\"): intents[\"${intent}\"] sets \\`mode: \"stream\"\\` on a workflow entry — stream mode is agent-only in v1. Wrap the workflow in an agent or remove the \\`mode\\` field.`,\n        { context: { authoring: true, intent } },\n        \"SUPERVISOR_INTENT_STREAM_ON_WORKFLOW\",\n      );\n    }\n\n    return {\n      intent,\n      type: \"workflow\",\n      unit: unit as WorkflowInstance<unknown, unknown>,\n      description,\n      input: entryForm?.input,\n      placeholders: entryForm?.placeholders,\n      output: entryForm?.output,\n      next: entryForm?.next,\n      history: entryForm?.history,\n    };\n  }\n\n  assertStreamModeShape(intent, entryForm, supervisorName);\n\n  return {\n    intent,\n    type: \"agent\",\n    unit: unit as AgentContract<unknown>,\n    description,\n    input: entryForm?.input,\n    placeholders: entryForm?.placeholders,\n    output: entryForm?.output,\n    next: entryForm?.next,\n    history: entryForm?.history,\n    mode: entryForm?.mode,\n    streamTo: entryForm?.streamTo,\n  };\n}\n\n/**\n * Phase 5 / decisions §34 — enforce the two stream-mode invariants at\n * construction time:\n *\n * 1. `mode: \"stream\"` and per-intent `output` are mutually exclusive.\n *    Stream agents declare their state contribution via `streamTo`,\n *    not via a schema; allowing both would silently pick one and\n *    surprise the author.\n * 2. `streamTo` is required when `mode === \"stream\"`. A stream agent\n *    that doesn't write somewhere is a black box — fail loud at the\n *    factory rather than at run-time when state validation surfaces a\n *    missing key.\n */\nfunction assertStreamModeShape(\n  intent: string,\n  entryForm: IntentEntry | undefined,\n  supervisorName: string,\n): void {\n  if (!entryForm || entryForm.mode !== \"stream\") {\n    return;\n  }\n\n  if (entryForm.output) {\n    throw new SupervisorFailedError(\n      `ai.supervisor(\"${supervisorName}\"): intents[\"${intent}\"] sets both \\`mode: \"stream\"\\` and \\`output\\` — stream mode declares its slice via \\`streamTo\\`, not a schema. Drop one.`,\n      { context: { authoring: true, intent } },\n      \"SUPERVISOR_INTENT_STREAM_AND_OUTPUT\",\n    );\n  }\n\n  if (typeof entryForm.streamTo !== \"string\" || entryForm.streamTo.trim().length === 0) {\n    throw new SupervisorFailedError(\n      `ai.supervisor(\"${supervisorName}\"): intents[\"${intent}\"] sets \\`mode: \"stream\"\\` without a non-empty \\`streamTo\\` — a stream agent must name the state key its assembled prose writes into.`,\n      { context: { authoring: true, intent } },\n      \"SUPERVISOR_INTENT_STREAM_TO_REQUIRED\",\n    );\n  }\n}\n\n/**\n * Reject entries that mix dispatch fields. `{ agent, run }` is a\n * common copy-paste bug; we surface it at construction with a clear\n * message rather than silently picking one based on resolution\n * order.\n */\nfunction assertSingleDispatchField(intent: string, value: object, supervisorName: string): void {\n  const dispatchKeys = ([\"run\", \"agent\", \"workflow\"] as const).filter((key) => key in value);\n\n  if (dispatchKeys.length > 1) {\n    throw new SupervisorFailedError(\n      `ai.supervisor(\"${supervisorName}\"): intents[\"${intent}\"] has multiple dispatch fields (${dispatchKeys\n        .map((key) => `\\`${key}\\``)\n        .join(\n          \", \",\n        )}) — pick one. Two dispatch fields on the same entry is dev confusion, not a feature.`,\n      { context: { authoring: true, intent } },\n      \"SUPERVISOR_INTENT_MIXED_DISPATCH\",\n    );\n  }\n}\n\n/**\n * Coerce a `SupervisorIntentValue` into the agent-flavored\n * `IntentEntry` form when the caller passed the object form. Returns\n * `undefined` for bare shorthand. The shape check keys on the\n * presence of an `agent` property because both `AgentContract` and\n * `WorkflowInstance` have their own identifying fields\n * (`isAnonymous` for agents, `signature` for workflows) but neither\n * carries a top-level `agent`.\n */\nfunction asAgentEntryForm(value: object): IntentEntry | undefined {\n  if (!(\"agent\" in value)) {\n    return undefined;\n  }\n\n  const candidate = (value as { agent: unknown }).agent;\n\n  if (!candidate || typeof candidate !== \"object\") {\n    return undefined;\n  }\n\n  return value as IntentEntry;\n}\n\nfunction isDispatchableUnit(\n  value: unknown,\n): value is AgentContract<unknown> | WorkflowInstance<unknown, unknown> {\n  if (!value || typeof value !== \"object\") {\n    return false;\n  }\n\n  const candidate = value as { name?: unknown; execute?: unknown };\n\n  return typeof candidate.name === \"string\" && typeof candidate.execute === \"function\";\n}\n\nfunction detectType(\n  unit: AgentContract<unknown> | WorkflowInstance<unknown, unknown>,\n): \"agent\" | \"workflow\" {\n  // Workflows expose a structural `signature` field; agents don't.\n  if (typeof (unit as WorkflowInstance<unknown, unknown>).signature === \"string\") {\n    return \"workflow\";\n  }\n\n  return \"agent\";\n}\n\nfunction resolveAgentLikeDescription(\n  intent: string,\n  entryForm: IntentEntry | undefined,\n  unit: AgentContract<unknown> | WorkflowInstance<unknown, unknown>,\n  supervisorName: string,\n): string {\n  const entryOverride = entryForm?.description;\n\n  if (entryOverride && entryOverride.trim().length > 0) {\n    return entryOverride;\n  }\n\n  const unitDescription = (unit as { description?: unknown }).description;\n\n  if (typeof unitDescription === \"string\" && unitDescription.trim().length > 0) {\n    return unitDescription;\n  }\n\n  // Empty string sentinel — caller (assertRouterDescriptions) decides\n  // whether a missing description is fatal. Under deterministic\n  // `route` mode it isn't.\n  return \"\";\n}\n\n/**\n * Type guard helper for downstream modules. Narrows a raw\n * `AgentResult | WorkflowResult` based on the resolved entry's kind,\n * so transformers and emitters can pull the right fields without\n * re-checking shape.\n */\nexport function isAgentResult(raw: DispatchRawResult): raw is AgentResult<unknown> {\n  return raw.type === \"agent\";\n}\n\nexport function isWorkflowResult(raw: DispatchRawResult): raw is WorkflowResult<unknown> {\n  return raw.type === \"workflow\";\n}\n","import { SupervisorCancelledError } from \"../errors\";\n\n/**\n * Build a `SupervisorCancelledError` from an `AbortSignal`. Extracts a\n * human-readable reason from `signal.reason` whether it was a string,\n * an `Error`, or some other value. Used at between-iteration boundaries\n * and on any mid-iteration cancellation path.\n */\nexport function createCancelledError(\n  signal: AbortSignal | undefined,\n): SupervisorCancelledError {\n  const reason = signal?.reason;\n  const reasonText =\n    typeof reason === \"string\"\n      ? reason\n      : reason instanceof Error\n        ? reason.message\n        : reason === undefined\n          ? \"\"\n          : String(reason);\n\n  return new SupervisorCancelledError(\n    `supervisor cancelled${reasonText ? `: ${reasonText}` : \"\"}`,\n    { cancelledAt: new Date().toISOString(), reason: reasonText },\n  );\n}\n","import { END } from \"../contracts/end.type\";\nimport type { IterationSnapshot } from \"../contracts/supervisor/iteration-snapshot.type\";\nimport type { SupervisorInput } from \"../contracts/supervisor/supervisor-input.type\";\nimport type { ResolvedIntentEntry } from \"./entries\";\n\n/**\n * Build the per-turn user message the supervisor feeds to the router\n * agent. Carries everything the LLM needs to make a routing decision:\n *\n * - Available intents with descriptions (so the router knows what\n *   to pick from).\n * - The reserved `END` sentinel value it can emit to terminate.\n * - Iteration counter + ceiling so the router can pace itself.\n * - Compact history of prior iterations (intent + short output clip).\n * - The supervisor's original input so the router stays anchored.\n *\n * Note the router's own `systemPrompt` is kept persistent across\n * turns — this function produces only the per-turn USER message.\n */\nexport function buildRouterContextMessage(params: {\n  entries: Map<string, ResolvedIntentEntry>;\n  iteration: number;\n  maxIterations: number;\n  iterations: IterationSnapshot[];\n  input: SupervisorInput;\n  /**\n   * Per-execute state at the START of this iteration (post-merge of\n   * the previous iteration). Rendered as a JSON snippet so the\n   * router can pick the next intent based on what's already filled\n   * in (Q14).\n   */\n  state?: Record<string, unknown>;\n  /**\n   * Reviewer feedback string from the previous iteration's evaluate\n   * verdict. Rendered as its own section so the router weighs it\n   * alongside the intent list (Q18).\n   */\n  feedback?: string;\n  /**\n   * Supervisor-level system prompt text, when configured. Surfaced at\n   * the TOP of the router's per-turn user message so the router reads\n   * team/domain context before the routing mechanics block. Skipped\n   * when the supervisor didn't configure `systemPrompt`.\n   */\n  supervisorPrompt?: string;\n  /**\n   * Resolved natural-language objective from `SupervisorConfig.goal`.\n   * Surfaced as its own labeled section near the top of the router's\n   * user message so routing decisions are objective-aware. Skipped\n   * when no goal was configured.\n   */\n  goal?: string;\n}): string {\n  const {\n    entries,\n    iteration,\n    maxIterations,\n    iterations,\n    input,\n    state,\n    feedback,\n    supervisorPrompt,\n    goal,\n  } = params;\n\n  const intentLines = [...entries.values()].map(\n    entry => `- ${entry.intent}: ${entry.description}`,\n  );\n\n  const historyLines =\n    iterations.length === 0\n      ? [\"(none yet)\"]\n      : iterations.map(snapshot => formatHistoryLine(snapshot));\n\n  const sections: string[] = [];\n\n  if (supervisorPrompt) {\n    sections.push(supervisorPrompt.trim(), \"\");\n  }\n\n  if (goal) {\n    sections.push(\"Goal:\", goal.trim(), \"\");\n  }\n\n  sections.push(\n    \"Available intents:\",\n    ...intentLines,\n    \"\",\n    \"Reserved values:\",\n    `- ${END} = terminate the run`,\n    \"\",\n    `Iteration: ${iteration + 1} / ${maxIterations}`,\n    \"\",\n    \"History:\",\n    ...historyLines,\n  );\n\n  if (state && Object.keys(state).length > 0) {\n    sections.push(\"\", \"Current state:\", safeStringify(state));\n  }\n\n  if (feedback) {\n    sections.push(\"\", `Reviewer feedback from last iteration: ${feedback}`);\n  }\n\n  const renderedInput =\n    typeof input === \"string\" ? input : safeStringify(input);\n\n  sections.push(\"\", `Original input: ${renderedInput}`);\n\n  return sections.join(\"\\n\");\n}\n\nfunction formatHistoryLine(snapshot: IterationSnapshot): string {\n  const branches = Object.entries(snapshot.result).map(\n    ([intent, branch]) => `${intent} → ${clip(branch.output)}`,\n  );\n\n  return `[${snapshot.iteration}] ${branches.join(\" | \")}`;\n}\n\nfunction clip(value: unknown, maxLength = 160): string {\n  if (value === undefined || value === null) {\n    return String(value);\n  }\n\n  const raw = typeof value === \"string\" ? value : safeStringify(value);\n\n  if (raw.length <= maxLength) {\n    return raw;\n  }\n\n  return `${raw.slice(0, maxLength - 1)}…`;\n}\n\nfunction safeStringify(value: unknown): string {\n  try {\n    return JSON.stringify(value);\n  } catch {\n    return `[unserializable: ${typeof value}]`;\n  }\n}\n","import type { StandardSchemaV1 } from \"@standard-schema/spec\";\nimport type { AgentContract } from \"../contracts/agent/agent.contract\";\nimport type { Message } from \"../contracts/conversation-message.type\";\nimport { END, type EndSentinel } from \"../contracts/end.type\";\nimport type { BaseReport } from \"../contracts/result/base-report.type\";\nimport type { IterationSnapshot } from \"../contracts/supervisor/iteration-snapshot.type\";\nimport type { Next } from \"../contracts/supervisor/next.type\";\nimport type { RouteContext } from \"../contracts/supervisor/route-context.type\";\nimport type { RouterEntry } from \"../contracts/supervisor/router-entry.type\";\nimport type { SupervisorConfig } from \"../contracts/supervisor/supervisor-config.type\";\nimport type { SupervisorInput } from \"../contracts/supervisor/supervisor-input.type\";\nimport { AIError, SupervisorFailedError, SupervisorRoutingError } from \"../errors\";\nimport type { ResolvedIntentEntry } from \"./entries\";\nimport { buildRouterContextMessage } from \"./router-prompt\";\n\n/**\n * Outcome of one dispatch decision — what the iteration loop needs to\n * act on. `kind: \"end\"` signals termination; `kind: \"dispatch\"` carries\n * the resolved intents (always an array; single-agent dispatch has\n * length 1). `source` records which path made the call so the\n * iteration snapshot can surface it to debuggers.\n */\nexport type DispatchDecision =\n  | {\n      kind: \"end\";\n      source: \"route\" | \"router\" | \"initialAgent\" | \"classifier\";\n      raw: Next;\n      reasoning?: string;\n      durationMs: number;\n      usage?: { input: number; output: number; total: number };\n      /** Full router-agent report when this decision came from a router. */\n      routerReport?: BaseReport;\n    }\n  | {\n      kind: \"dispatch\";\n      intents: string[];\n      source: \"route\" | \"router\" | \"initialAgent\" | \"classifier\";\n      raw: Next;\n      reasoning?: string;\n      durationMs: number;\n      usage?: { input: number; output: number; total: number };\n      /** Full router-agent report when this decision came from a router. */\n      routerReport?: BaseReport;\n    };\n\nexport type DecideParams = {\n  config: SupervisorConfig<unknown>;\n  entries: Map<string, ResolvedIntentEntry>;\n  iteration: number;\n  maxIterations: number;\n  iterations: IterationSnapshot[];\n  input: SupervisorInput;\n  /**\n   * Per-execute state accumulator at the start of this iteration.\n   * Threaded into `RouteContext` for the route callback and\n   * rendered into the router prompt so routing decisions can be\n   * state-aware (Q14).\n   */\n  state: Record<string, unknown>;\n  /**\n   * Frozen request-scoped bag from the `execute({ context })` call —\n   * surfaced on `RouteContext.context` for both `route` callbacks\n   * and `RouterEntry.placeholders` / `RouterEntry.input` resolvers.\n   */\n  context: Readonly<Record<string, unknown>>;\n  /**\n   * Frozen prior-conversation history from `execute({ history })` —\n   * surfaced on `RouteContext.history` and forwarded to the router\n   * agent as `agent.execute(input, { history })` so router decisions\n   * are conversation-aware.\n   */\n  history: ReadonlyArray<Message>;\n  /**\n   * Resolved natural-language objective from `SupervisorConfig.goal`\n   * (materialized to plain text at supervisor construction). Surfaced\n   * on `RouteContext.goal` for `route` / `RouterEntry` resolvers, and\n   * injected into the router agent's per-turn user message via\n   * `buildRouterContextMessage`. `undefined` when no goal was set.\n   */\n  goal: string | undefined;\n  evaluateFeedback?: RouteContext[\"evaluateFeedback\"];\n  /**\n   * Forensic record of the iter-0 classifier (Phase 7). Threaded into\n   * `RouteContext.classifier` so route callbacks and router-agent\n   * input composers can read the classification trail without\n   * re-parsing state.\n   */\n  classifier?: RouteContext[\"classifier\"];\n  signal?: AbortSignal;\n  /**\n   * Override for the very first iteration — when `initialAgent` is\n   * set, the first turn skips `route`/`router` and dispatches the\n   * named intent directly. `runIteration` passes `true` only on turn\n   * 0 when the config has `initialAgent`.\n   */\n  useInitialAgent?: boolean;\n};\n\n/**\n * Unified dispatch decision entry — calls either the `route` callback\n * or the `router` agent based on the supervisor's configured mode and\n * normalizes the result into a `DispatchDecision`. Runtime validates\n * every routing value against the configured agent keys; unknown keys\n * surface as `SupervisorRoutingError`.\n */\nexport async function decide(params: DecideParams): Promise<DispatchDecision> {\n  if (params.useInitialAgent && params.config.initialAgent) {\n    const intent = params.config.initialAgent;\n    validateKey(intent, params.entries);\n\n    return {\n      kind: \"dispatch\",\n      intents: [intent],\n      source: \"initialAgent\",\n      raw: intent,\n      durationMs: 0,\n    };\n  }\n\n  if (params.config.route) {\n    return decideViaCallback(params);\n  }\n\n  if (params.config.router) {\n    return decideViaRouter(params);\n  }\n\n  throw new SupervisorFailedError(\n    `ai.supervisor(\"${params.config.name}\"): neither \\`route\\` nor \\`router\\` is configured — factory validation should have prevented this`,\n    { context: { authoring: true } },\n  );\n}\n\nasync function decideViaCallback(params: DecideParams): Promise<DispatchDecision> {\n  const started = performance.now();\n  const ctx: RouteContext = {\n    iteration: params.iteration,\n    input: params.input,\n    state: params.state,\n    iterations: params.iterations,\n    feedback:\n      typeof params.evaluateFeedback?.feedback === \"string\"\n        ? params.evaluateFeedback.feedback\n        : undefined,\n    evaluateFeedback: params.evaluateFeedback,\n    context: params.context,\n    history: params.history,\n    goal: params.goal,\n    classifier: params.classifier,\n  };\n\n  let raw: Next;\n\n  try {\n    raw = await params.config.route!(ctx);\n  } catch (thrown) {\n    throw wrapRouteError(params.config.name, thrown);\n  }\n\n  const durationMs = performance.now() - started;\n\n  return normalize(raw, params.entries, \"route\", durationMs);\n}\n\nasync function decideViaRouter(params: DecideParams): Promise<DispatchDecision> {\n  const { agent, placeholders, inputOverride, historySlicer } = resolveRouterEntry(\n    params.config.router!,\n  );\n  const started = performance.now();\n\n  const routeCtx: RouteContext = {\n    iteration: params.iteration,\n    input: params.input,\n    state: params.state,\n    iterations: params.iterations,\n    feedback:\n      typeof params.evaluateFeedback?.feedback === \"string\"\n        ? params.evaluateFeedback.feedback\n        : undefined,\n    evaluateFeedback: params.evaluateFeedback,\n    context: params.context,\n    history: params.history,\n    goal: params.goal,\n  };\n\n  const userMessage =\n    inputOverride?.(routeCtx) ??\n    buildRouterContextMessage({\n      entries: params.entries,\n      iteration: params.iteration,\n      maxIterations: params.maxIterations,\n      iterations: params.iterations,\n      input: params.input,\n      state: params.state,\n      feedback: routeCtx.feedback,\n      supervisorPrompt: resolveSupervisorPromptText(params.config),\n      goal: params.goal,\n    });\n\n  const resolvedPlaceholders = placeholders?.(routeCtx);\n\n  // Inject the canonical router output schema so the supervisor gets\n  // a predictable `{ next, reasoning? }` shape regardless of what the\n  // user scripted on the router agent. Lets the router stay a plain\n  // agent — no supervisor-specific config needed at construction.\n  const routerHistory = resolveRouterHistory(\n    historySlicer,\n    routeCtx,\n    params.history,\n    params.config.historyWindow?.router,\n  );\n\n  const routerResult = await agent.execute(userMessage, {\n    signal: params.signal,\n    output: ROUTER_OUTPUT_SCHEMA as unknown as StandardSchemaV1<{\n      next: Next;\n      reasoning?: string;\n    }>,\n    ...(resolvedPlaceholders ? { placeholders: resolvedPlaceholders } : {}),\n    ...(routerHistory.length > 0 ? { history: routerHistory } : {}),\n  });\n\n  const durationMs = performance.now() - started;\n\n  if (routerResult.error) {\n    throw routerResult.error instanceof AIError\n      ? routerResult.error\n      : new SupervisorFailedError(`router agent failed`, {\n          cause: routerResult.error,\n        });\n  }\n\n  const data = routerResult.data;\n\n  if (!data || typeof data !== \"object\") {\n    throw new SupervisorRoutingError(\n      `router agent returned no structured \\`next\\` — did its output schema include { next, reasoning? }?`,\n      { returned: data, availableKeys: [...params.entries.keys()] },\n    );\n  }\n\n  const rawNext = (data as { next?: unknown }).next;\n  const reasoning = (data as { reasoning?: unknown }).reasoning;\n\n  if (rawNext === undefined) {\n    throw new SupervisorRoutingError(`router agent output missing \\`next\\` field`, {\n      returned: data,\n      availableKeys: [...params.entries.keys()],\n    });\n  }\n\n  const decision = normalize(rawNext as Next, params.entries, \"router\", durationMs);\n\n  return {\n    ...decision,\n    reasoning: typeof reasoning === \"string\" ? reasoning : undefined,\n    usage: routerResult.usage,\n    routerReport: routerResult.report,\n  };\n}\n\n/**\n * Normalize the `router` config field — accepts either a bare\n * `AgentContract` (shorthand) or a full `RouterEntry` — into a\n * uniform `{ agent, placeholders?, inputOverride? }` triple. Centralized\n * so the dispatch path doesn't branch on shape.\n */\nfunction resolveRouterEntry(router: AgentContract<unknown> | RouterEntry): {\n  agent: AgentContract<unknown>;\n  placeholders?: RouterEntry[\"placeholders\"];\n  inputOverride?: RouterEntry[\"input\"];\n  historySlicer?: RouterEntry[\"history\"];\n} {\n  if (typeof (router as { execute?: unknown }).execute === \"function\") {\n    return { agent: router as AgentContract<unknown> };\n  }\n\n  const entry = router as RouterEntry;\n\n  return {\n    agent: entry.agent,\n    placeholders: entry.placeholders,\n    inputOverride: entry.input,\n    historySlicer: entry.history,\n  };\n}\n\n/**\n * Resolve the supervisor's own `systemPrompt` (string or contract)\n * into plain text. Returns `undefined` when the supervisor didn't\n * configure one. The resolved text is surfaced in the per-turn\n * router user message so the router sees team/domain context without\n * disturbing the router agent's own factory-level system prompt —\n * functionally equivalent to prepending, without requiring an API\n * expansion on `AgentContract` to read the router's system prompt.\n */\nfunction resolveSupervisorPromptText(config: SupervisorConfig<unknown>): string | undefined {\n  if (!config.systemPrompt) {\n    return undefined;\n  }\n\n  return typeof config.systemPrompt === \"string\"\n    ? config.systemPrompt\n    : config.systemPrompt.resolve();\n}\n\n/**\n * Convert the raw routing value (callback return OR router agent\n * `next` field) into a canonical `DispatchDecision`, validating every\n * named intent against the supervisor's `intents` map.\n */\nfunction normalize(\n  raw: Next,\n  entries: Map<string, ResolvedIntentEntry>,\n  source: \"route\" | \"router\",\n  durationMs: number,\n): DispatchDecision {\n  if (isEnd(raw)) {\n    return { kind: \"end\", source, raw, durationMs };\n  }\n\n  if (typeof raw === \"string\") {\n    validateKey(raw, entries);\n\n    return {\n      kind: \"dispatch\",\n      intents: [raw],\n      source,\n      raw,\n      durationMs,\n    };\n  }\n\n  if (Array.isArray(raw)) {\n    if (raw.length === 0) {\n      throw new SupervisorRoutingError(\n        `router returned an empty array — must be a non-empty list of agent intents`,\n        { returned: raw, availableKeys: [...entries.keys()] },\n      );\n    }\n\n    for (const intent of raw) {\n      if (typeof intent !== \"string\") {\n        throw new SupervisorRoutingError(`router returned a non-string inside its fan-out array`, {\n          returned: raw,\n          availableKeys: [...entries.keys()],\n        });\n      }\n\n      validateKey(intent, entries);\n    }\n\n    return {\n      kind: \"dispatch\",\n      intents: raw,\n      source,\n      raw,\n      durationMs,\n    };\n  }\n\n  throw new SupervisorRoutingError(\n    `router returned an unsupported value — expected a string, string[], or END`,\n    { returned: raw, availableKeys: [...entries.keys()] },\n  );\n}\n\nfunction validateKey(intent: string, entries: Map<string, ResolvedIntentEntry>): void {\n  if (!entries.has(intent)) {\n    throw new SupervisorRoutingError(`router returned unknown agent key \"${intent}\"`, {\n      returned: intent,\n      availableKeys: [...entries.keys()],\n    });\n  }\n}\n\nfunction isEnd(value: unknown): value is EndSentinel {\n  return value === END;\n}\n\n/**\n * Resolve the history slice forwarded to the router agent. Mirrors\n * `SupervisorExecution.resolveHistoryFor(\"router\", ...)` — duplicated\n * here so the standalone `decide()` function stays callable without\n * threading the execution instance through. Precedence is identical:\n * entry slicer > `historyWindow.router` > full history.\n */\nfunction resolveRouterHistory(\n  slicer: RouterEntry[\"history\"] | undefined,\n  routeCtx: RouteContext,\n  full: ReadonlyArray<Message>,\n  window: number | undefined,\n): Message[] {\n  if (slicer) {\n    const sliced = slicer(routeCtx);\n    return sliced ? [...sliced] : [];\n  }\n\n  if (window === undefined || window < 0) {\n    return [...full];\n  }\n\n  if (window === 0) {\n    return [];\n  }\n\n  return full.slice(-window);\n}\n\n/**\n * JSON Schema form of the canonical router output shape. Surfaced via\n * the Standard JSON Schema V1 extension path (`[\"~standard\"].jsonSchema.input`)\n * so `extractJsonSchema()` can pull it for native structured-output\n * enforcement on capable providers (OpenAI strict json_schema mode,\n * Anthropic tool-use shape, etc.). Without this, the model is told to\n * emit JSON only via soft system-prompt instruction — fragile, and\n * skipped entirely when the model advertises `structuredOutput: true`.\n *\n * `next` is intentionally `string` (not a union with arrays) because\n * OpenAI strict mode rejects polymorphic root types — fan-out via\n * `string[]` is still validated at the framework layer; the model\n * just emits a single intent name (or the END sentinel) and the\n * supervisor's own normalizer handles the rest.\n */\nconst ROUTER_OUTPUT_JSON_SCHEMA = {\n  type: \"object\",\n  properties: {\n    next: {\n      type: \"string\",\n      description: \"Name of the agent to dispatch next, or the END sentinel to terminate the run.\",\n    },\n    reasoning: {\n      type: \"string\",\n      description: \"One-sentence justification for the routing choice.\",\n    },\n  },\n  required: [\"next\", \"reasoning\"],\n  additionalProperties: false,\n};\n\n/**\n * Canonical Standard Schema the supervisor injects when calling the\n * router agent. Pragmatic — accepts any `next` shape the router can\n * plausibly emit (`string`, `string[]`, or the `END` literal) plus an\n * optional `reasoning` field. Rejects anything else so a broken\n * router output surfaces cleanly via the agent's own validation path.\n *\n * Exposes `[\"~standard\"].jsonSchema.input()` (Standard JSON Schema V1)\n * so capable providers enforce the shape natively rather than relying\n * on prompt-side coaching.\n */\nconst ROUTER_OUTPUT_SCHEMA: StandardSchemaV1<{\n  next: Next;\n  reasoning?: string;\n}> = {\n  \"~standard\": {\n    version: 1,\n    vendor: \"warlock-supervisor\",\n    jsonSchema: {\n      input: () => ROUTER_OUTPUT_JSON_SCHEMA,\n    },\n    validate(value: unknown): StandardSchemaV1.Result<{ next: Next; reasoning?: string }> {\n      if (!value || typeof value !== \"object\") {\n        return { issues: [{ message: \"router output must be an object\" }] };\n      }\n\n      const record = value as { next?: unknown; reasoning?: unknown };\n      const rawNext = record.next;\n\n      const nextIsValid =\n        typeof rawNext === \"string\" ||\n        (Array.isArray(rawNext) && rawNext.every((element) => typeof element === \"string\"));\n\n      if (!nextIsValid) {\n        return {\n          issues: [\n            {\n              message: \"router output `next` must be a string, string[], or the END sentinel\",\n            },\n          ],\n        };\n      }\n\n      const reasoning = typeof record.reasoning === \"string\" ? record.reasoning : undefined;\n\n      return {\n        value: { next: rawNext as Next, reasoning },\n      };\n    },\n  } as StandardSchemaV1<{ next: Next; reasoning?: string }>[\"~standard\"] & {\n    jsonSchema: { input: () => Record<string, unknown> };\n  },\n};\n\nfunction wrapRouteError(supervisorName: string, thrown: unknown): AIError {\n  if (thrown instanceof AIError) {\n    return thrown;\n  }\n\n  const message = thrown instanceof Error ? thrown.message : String(thrown);\n\n  return new SupervisorFailedError(\n    `\\`route\\` callback threw in supervisor \"${supervisorName}\": ${message}`,\n    { cause: thrown },\n  );\n}\n","import { resolveDefaultSnapshotStore } from \"../config\";\nimport type { IterationSnapshot } from \"../contracts/supervisor/iteration-snapshot.type\";\nimport type { SupervisorConfig } from \"../contracts/supervisor/supervisor-config.type\";\nimport type { SupervisorResumeOptions } from \"../contracts/supervisor/supervisor-execute-options.type\";\nimport type { SupervisorInput } from \"../contracts/supervisor/supervisor-input.type\";\nimport type {\n  SupervisorSnapshot,\n  SupervisorSnapshotStatus,\n} from \"../contracts/supervisor/supervisor-snapshot.type\";\nimport { SupervisorDriftError, SupervisorFailedError } from \"../errors\";\n\n/**\n * Resolve the effective {@link SnapshotStore}: the supervisor's own\n * `snapshotStore` field wins; absent that, fall back to the global\n * default set via `ai.config({ defaultSnapshotStore })`.\n */\nfunction resolveSnapshotStore(config: SupervisorConfig<unknown>) {\n  return config.snapshotStore ?? resolveDefaultSnapshotStore();\n}\n\nexport type PersistParams = {\n  config: SupervisorConfig<unknown>;\n  signature: string;\n  runId: string;\n  input: SupervisorInput;\n  startedAt: string;\n  iteration: number;\n  snapshots: IterationSnapshot[];\n  status: SupervisorSnapshotStatus;\n};\n\nexport type PersistOutcome = { ok: true } | { ok: false; error: unknown };\n\n/**\n * Write the current run state to the resolved snapshot store. No-op\n * (ok) when neither the supervisor's `snapshotStore` nor the global\n * `defaultStore` is configured. Failures are returned as\n * `{ ok: false }` rather than thrown so the engine can surface them\n * via events/logs without aborting the run — callers decide whether\n * a failed checkpoint is fatal.\n */\nexport async function persistSupervisorSnapshot(\n  params: PersistParams,\n): Promise<PersistOutcome> {\n  const store = resolveSnapshotStore(params.config);\n\n  if (!store) {\n    return { ok: true };\n  }\n\n  const snapshot: SupervisorSnapshot = {\n    runId: params.runId,\n    supervisorName: params.config.name,\n    signature: params.signature,\n    input: params.input,\n    iteration: params.iteration,\n    snapshots: params.snapshots,\n    status: params.status,\n    startedAt: params.startedAt,\n    savedAt: new Date().toISOString(),\n  };\n\n  try {\n    await store.save(snapshot);\n\n    return { ok: true };\n  } catch (error) {\n    return { ok: false, error };\n  }\n}\n\n/**\n * Load a persisted snapshot for `resume()` and run the drift check.\n * Throws `SupervisorFailedError` when no store is configured or when\n * the run is missing; throws `SupervisorDriftError` when the stored\n * signature doesn't match the current definition (unless `force` is\n * set).\n */\nexport async function loadSnapshotForResume(params: {\n  config: SupervisorConfig<unknown>;\n  signature: string;\n  runId: string;\n  options?: SupervisorResumeOptions;\n}): Promise<SupervisorSnapshot> {\n  const store = resolveSnapshotStore(params.config);\n\n  if (!store) {\n    throw new SupervisorFailedError(\n      `supervisor \"${params.config.name}\" has no store configured — set \\`snapshotStore\\` on the config or call \\`ai.config({ defaultSnapshotStore })\\` at boot before calling resume()`,\n      { context: { runId: params.runId } },\n    );\n  }\n\n  const snapshot = (await store.load(params.runId)) ?? null;\n\n  if (!snapshot) {\n    throw new SupervisorFailedError(\n      `supervisor \"${params.config.name}\": no snapshot for runId \"${params.runId}\"`,\n      { context: { runId: params.runId } },\n    );\n  }\n\n  if (!params.options?.force && snapshot.signature !== params.signature) {\n    throw new SupervisorDriftError(\n      `supervisor \"${params.config.name}\" signature drift on resume`,\n      {\n        savedSignature: snapshot.signature,\n        currentSignature: params.signature,\n        runId: params.runId,\n      },\n    );\n  }\n\n  return snapshot;\n}\n","import type { StandardSchemaV1 } from \"@standard-schema/spec\";\nimport { log, type Logger } from \"@warlock.js/logger\";\nimport type { AgentContract } from \"../contracts/agent/agent.contract\";\nimport type { Message } from \"../contracts/conversation-message.type\";\nimport { END } from \"../contracts/end.type\";\nimport type { EventIdentity, WithoutIdentity } from \"../contracts/events/event-identity.type\";\nimport type { SupervisorEventMap } from \"../contracts/events/event-map.type\";\nimport type { AgentResult } from \"../contracts/result/agent-result.type\";\nimport type { BaseReport } from \"../contracts/result/base-report.type\";\nimport type {\n  SupervisorReport,\n  SupervisorResult,\n  SupervisorTerminatedBy,\n} from \"../contracts/result/supervisor-result.type\";\nimport type { Usage } from \"../contracts/result/usage.type\";\nimport type { WorkflowResult } from \"../contracts/result/workflow-result.type\";\nimport type { StreamContract } from \"../contracts/stream/stream.contract\";\nimport type {\n  ClassifierConfig,\n  ClassifierContext,\n  ClassifierOutput,\n  ClassifierRefineContext,\n  ClassifierRefineResult,\n  ClassifierSnapshot,\n} from \"../contracts/supervisor/classifier-context.type\";\nimport type {\n  DispatchContext,\n  StreamableExecutable,\n  SupervisableExecutable,\n  SupervisableExecuteOptions,\n  SupervisableResult,\n} from \"../contracts/supervisor/dispatch-context.type\";\nimport type {\n  EvaluateBranchResult,\n  EvaluateContext,\n  EvaluateResult,\n} from \"../contracts/supervisor/evaluate-context.type\";\nimport type {\n  AckSnapshot,\n  AgentBranchSnapshot,\n  IterationSnapshot,\n} from \"../contracts/supervisor/iteration-snapshot.type\";\nimport type { RouteContext } from \"../contracts/supervisor/route-context.type\";\nimport type { SupervisorConfig } from \"../contracts/supervisor/supervisor-config.type\";\nimport type { SupervisorExecuteOptions } from \"../contracts/supervisor/supervisor-execute-options.type\";\nimport type { SupervisorInput } from \"../contracts/supervisor/supervisor-input.type\";\nimport type {\n  SupervisorSnapshot,\n  SupervisorSnapshotStatus,\n} from \"../contracts/supervisor/supervisor-snapshot.type\";\nimport type { WorkflowInstance } from \"../contracts/workflow/workflow.contract\";\nimport {\n  AIError,\n  MaxIterationsError,\n  SchemaValidationError,\n  SupervisorCancelledError,\n  SupervisorFailedError,\n} from \"../errors\";\nimport { stampReportLineage } from \"../utils\";\nimport type { AgentMiddleware } from \"../contracts/middleware/middleware.contract\";\nimport type { MiddlewareSupervisorContext } from \"../contracts/middleware/middleware-context.type\";\nimport type { MiddlewareState } from \"../contracts/middleware/middleware-state.type\";\nimport { runPipeline } from \"../middleware/pipeline\";\nimport { createCancelledError } from \"./cancellation\";\nimport { decide, type DispatchDecision } from \"./decide\";\nimport type { SupervisorEmitter } from \"./emitter\";\nimport type { ResolvedCallbackEntry, ResolvedIntentEntry } from \"./entries\";\nimport { isAgentResult, isWorkflowResult } from \"./entries\";\nimport { persistSupervisorSnapshot } from \"./snapshot\";\nimport type { SupervisorStreamController, SupervisorStreamEvent } from \"./supervisor-stream\";\n\nconst DEFAULT_MAX_ITERATIONS = 10;\nconst LOG_MODULE_BASE = \"ai.supervisor\";\n\nexport type SupervisorExecutionParams<TOutput> = {\n  config: SupervisorConfig<TOutput>;\n  entries: Map<string, ResolvedIntentEntry>;\n  signature: string;\n  emitter: SupervisorEmitter;\n  input: SupervisorInput;\n  runId: string;\n  options?: SupervisorExecuteOptions;\n  streamController?: SupervisorStreamController<SupervisorResult<TOutput>>;\n  resumeFrom?: SupervisorSnapshot;\n};\n\n/**\n * Per-call driver that owns the full lifecycle of one supervisor run.\n *\n * **Role.** Short-lived state container and phase orchestrator —\n * mirrors `agent/Execution` and `workflow/runWorkflow`, one level up.\n *\n * **Responsibility.**\n * - Owns: the iteration loop, per-iteration dispatch (single or\n *   fan-out), evaluate scheduling, usage aggregation across router +\n *   every branch + evaluate, snapshot collection, event emission\n *   through all three tiers, KV-store checkpointing, final result\n *   assembly (state validation against the output schema → typed data).\n * - Does NOT own: how child agents produce responses (delegated via\n *   `agent.execute` / `workflow.execute`), the routing decision\n *   itself (delegated to `decide.ts`), snapshot persistence mechanics\n *   (delegated to `snapshot.ts`), the stream queue plumbing\n *   (delegated to `supervisor-stream.ts`).\n *\n * `execute()` never throws — every unexpected failure funnels into\n * `this.error` and is returned on `result.error` with an appropriate\n * `SupervisorFailedError` / `MaxIterationsError` / `SupervisorRoutingError`\n * / `SupervisorCancelledError`.\n *\n * @example\n * // Inside supervisor.execute() — never constructed by user code directly:\n * return new SupervisorExecution(params).run();\n */\nexport class SupervisorExecution<TOutput> {\n  private readonly config: SupervisorConfig<TOutput>;\n  private readonly entries: Map<string, ResolvedIntentEntry>;\n  private readonly signature: string;\n  private readonly emitter: SupervisorEmitter;\n  private readonly input: SupervisorInput;\n  private readonly runId: string;\n  private readonly options?: SupervisorExecuteOptions;\n  private readonly streamController?: SupervisorStreamController<SupervisorResult<TOutput>>;\n  private readonly resumeFrom?: SupervisorSnapshot;\n\n  private readonly maxIterations: number;\n  private readonly logger: Logger = log;\n  private readonly logModule: string;\n\n  /**\n   * Supervisor-level middleware stack — `config.middleware` (default\n   * empty). Each entry's optional `supervisor` hook map fires once\n   * around the whole run via `runPipeline(..., \"supervisor\", ...)` in\n   * {@link run}; entries without that hook map are skipped by the\n   * pipeline.\n   */\n  private readonly middleware: ReadonlyArray<AgentMiddleware>;\n  /**\n   * Per-run shared-state bag threaded through every `supervisor`-level\n   * hook (`before` / `after` / `onError`) of this one run. Fresh `Map`\n   * per `SupervisorExecution` so two concurrent runs of the same\n   * supervisor get isolated bags — mirrors the agent pipeline.\n   */\n  private readonly middlewareState: MiddlewareState = new Map();\n\n  private readonly snapshots: IterationSnapshot[] = [];\n  private readonly childReports: BaseReport[] = [];\n  private readonly usage: Usage = { input: 0, output: 0, total: 0 };\n\n  private readonly startedAtIso: string;\n  private readonly startPerf = performance.now();\n\n  private iteration = 0;\n  private carriedFeedback?: EvaluateResult;\n  /**\n   * Per-intent `next` directive (Q24 / Stage 4d) collected at the\n   * end of an iteration after evaluate hasn't already steered. When\n   * set, `decideDispatch` consumes it on the next iteration's start —\n   * skipping the router entirely. Cleared after consumption.\n   *\n   * Only the dispatch variant is stored; an `END` collection\n   * terminates the iteration loop directly inside `runIteration`.\n   */\n  private carriedNextDispatch?: { intents: string[] };\n  private terminatedBy: SupervisorTerminatedBy = \"error\";\n  private status: SupervisorReport[\"status\"] = \"failed\";\n  private cancelledAtIso?: string;\n  private error?: AIError;\n  private data?: TOutput;\n  private lastDispatchIntents: string[] = [];\n  /**\n   * Per-execute typed accumulator. Initialized from `config.state`\n   * (default `{}`) at construction; rehydrated from the last\n   * snapshot's `state` on resume; mutated in-place as each iteration's\n   * intents strip-merge their outputs into it.\n   */\n  private state: Record<string, unknown> = {};\n  /**\n   * Per-iteration artifacts bag (Phase 5 / decisions §35). Tools\n   * dispatched within an iteration mutate `ctx.artifacts` — which\n   * points at this object. After the iteration's branches settle and\n   * their slices merge into state, this bag validates against\n   * `config.artifactsSchema` (if set) and merges via\n   * `config.finalizeArtifacts` or auto-spread, then resets to `{}`\n   * for the next iteration. The reset is crucial — long runs and\n   * orchestrator sessions never accumulate raw artifacts here.\n   */\n  private currentArtifacts: Record<string, unknown> = {};\n  /**\n   * Frozen copy of the iteration's `currentArtifacts` bag captured at\n   * merge time — BEFORE `finalizeArtifacts` (or auto-spread) reshaped\n   * it into state (Phase 8 / decisions §38). Surfaced on the iteration\n   * snapshot's `artifacts` field for forensic / telemetry consumers\n   * that want the raw tool contributions.\n   *\n   * Reset to `{}` at the start of every iteration so a snapshot built\n   * for an iteration whose tools wrote nothing carries an empty bag,\n   * not a stale carry-over.\n   */\n  private capturedIterationArtifacts: Readonly<Record<string, unknown>> = Object.freeze({});\n  /**\n   * Classifier (Phase 7 / decisions §37) forensic record. Set on iter\n   * 0 when `SupervisorConfig.classifier` is configured AND the run\n   * started fresh (resumes don't re-fire classifier — same as ack).\n   * Surfaced on `SupervisorReport.classifier` and threaded into\n   * `ctx.classifier` on RouteContext / DispatchContext /\n   * EvaluateContext from iter 0 onward.\n   */\n  private classifierSnapshot?: ClassifierSnapshot;\n  /**\n   * Iter-0 dispatch decision pre-computed by the classifier (Phase 7).\n   * When set, `decideDispatch` short-circuits and uses this directly\n   * with `source: \"classifier\"`. Cleared after consumption.\n   */\n  private carriedClassifierDispatch?: { intent: string };\n  /** Set true by classifier refine returning END to halt before any dispatch. */\n  private classifierHalted = false;\n  /**\n   * Receptionist forensic record. Set when an `ackAgent` was\n   * configured AND the run started fresh (resumes don't re-fire ack).\n   * Surfaced on `SupervisorReport.ack`.\n   */\n  private ackSnapshot?: AckSnapshot;\n  /**\n   * Read-only request-scoped context surfaced on every `ctx.context`.\n   * Shallow-copied + frozen at construction so callbacks see a stable\n   * snapshot of the caller's bag and can't mutate the original.\n   * Always present — defaults to a frozen `{}` when no context was\n   * passed. NOT persisted in snapshots.\n   */\n  private readonly context: Readonly<Record<string, unknown>>;\n  /**\n   * Prior conversation messages threaded through every callback context\n   * (`ctx.history`) and forwarded verbatim to dispatched agents (and the\n   * receptionist `ack` agent) as `agent.execute(input, { history })`.\n   * Frozen reference so callbacks see a stable view; not deep-cloned —\n   * conversation messages are treated as immutable by convention. NOT\n   * persisted in snapshots (re-supply on `resume()`).\n   */\n  private readonly history: ReadonlyArray<Message>;\n  /**\n   * Resolved natural-language objective from `SupervisorConfig.goal`.\n   * Materialized to plain text at construction (string passes through;\n   * `SystemPromptContract` is `.resolve()`-d). `undefined` when the\n   * supervisor was configured without a goal.\n   */\n  private readonly goal: string | undefined;\n\n  public constructor(params: SupervisorExecutionParams<TOutput>) {\n    this.config = params.config;\n    this.entries = params.entries;\n    this.signature = params.signature;\n    this.emitter = params.emitter;\n    this.input = params.input;\n    this.runId = params.runId;\n    this.options = params.options;\n    this.streamController = params.streamController;\n    this.resumeFrom = params.resumeFrom;\n\n    this.maxIterations = params.config.maxIterations ?? DEFAULT_MAX_ITERATIONS;\n    this.logModule = `${LOG_MODULE_BASE}.${params.config.name}`;\n    this.middleware = params.config.middleware ?? [];\n\n    // Shallow-copy + freeze the caller's context. Shallow only —\n    // freezing deeply would break valid use cases (mutable DB\n    // clients, abort controllers) without delivering meaningful\n    // safety beyond what TS `Readonly` already enforces.\n    this.context = Object.freeze({ ...(params.options?.context ?? {}) });\n    // Freeze the array reference so callbacks can't mutate the slot\n    // (`history.push(...)`); messages themselves are passed by reference\n    // — supervisors trust the agent layer's read-only convention.\n    // Precedence: per-call `options.history` (most explicit) overrides\n    // factory-level `config.history` (default for callers who don't\n    // supply per-call history). Final fallback is an empty array.\n    this.history = Object.freeze([...(params.options?.history ?? params.config.history ?? [])]);\n\n    // Resolve `goal` to plain text once, at construction. `string`\n    // passes through; `SystemPromptContract` is `.resolve()`-d (it owns\n    // its own placeholder substitution). `undefined` when no goal was\n    // configured — every `ctx.goal` consumer must guard for absence.\n    if (typeof params.config.goal === \"string\") {\n      this.goal = params.config.goal;\n    } else if (params.config.goal) {\n      this.goal = params.config.goal.resolve();\n    } else {\n      this.goal = undefined;\n    }\n\n    if (params.resumeFrom) {\n      this.snapshots.push(...params.resumeFrom.snapshots);\n      this.iteration = params.resumeFrom.iteration + 1;\n      this.startedAtIso = params.resumeFrom.startedAt;\n      // Resume rehydrates state from the last persisted iteration —\n      // every iteration's snapshot carries the post-merge state, so\n      // the resume point's state is the last snapshot's state.\n      const lastSnapshot = params.resumeFrom.snapshots[params.resumeFrom.snapshots.length - 1];\n      this.state = {\n        ...(lastSnapshot?.state ??\n          (params.config.state as Record<string, unknown> | undefined) ??\n          {}),\n      };\n    } else {\n      this.startedAtIso = new Date().toISOString();\n      this.state = {\n        ...((params.config.state as Record<string, unknown> | undefined) ?? {}),\n      };\n    }\n  }\n\n  /**\n   * Resolve the history slice forwarded to a child execution (router /\n   * dispatched agent / ack). Precedence:\n   *\n   *   1. Per-entry `history` callback — full override; whatever it\n   *      returns goes through (after defensive copy).\n   *   2. `SupervisorConfig.historyWindow.<role>` — last-N slice of the\n   *      caller-supplied history.\n   *   3. Default — full history for `router`/`agents`, empty for `ack`\n   *      (receptionists rarely benefit from scroll-back).\n   *\n   * Always returns a fresh `Message[]` (the agent layer\n   * mutates by reference internally, e.g. via `messages.push(...)`).\n   */\n  private resolveHistoryFor(\n    role: \"router\" | \"agents\" | \"ack\",\n    routeContext: RouteContext,\n    entrySlicer?: (ctx: RouteContext) => Message[] | ReadonlyArray<Message>,\n  ): Message[] {\n    if (entrySlicer) {\n      const sliced = entrySlicer(routeContext);\n      return sliced ? [...sliced] : [];\n    }\n\n    const window = this.config.historyWindow?.[role];\n\n    if (role === \"ack\") {\n      // Default for ack is empty — receptionists rarely need history.\n      // Override is opt-in via `historyWindow.ack: N`.\n      if (window === undefined || window <= 0) {\n        return [];\n      }\n\n      return this.history.slice(-window);\n    }\n\n    if (window === undefined || window < 0) {\n      return [...this.history];\n    }\n\n    if (window === 0) {\n      return [];\n    }\n\n    return this.history.slice(-window);\n  }\n\n  /**\n   * Apply only the global `historyWindow.agents` slice — used by the\n   * recursive `ctx.intents.X.execute()` re-entry path where no\n   * `RouteContext` is available to feed the per-entry slicer.\n   */\n  private applyAgentsWindow(): Message[] {\n    const window = this.config.historyWindow?.agents;\n\n    if (window === undefined || window < 0) {\n      return [...this.history];\n    }\n\n    if (window === 0) {\n      return [];\n    }\n\n    return this.history.slice(-window);\n  }\n\n  /**\n   * Entry point. Wraps the core run (`runCore`) in the\n   * `supervisor`-level middleware pipeline, then emits the terminal\n   * `supervisor.cancelled` / `supervisor.error` / `supervisor.completed`\n   * events and closes the stream (if any) with the post-pipeline result\n   * — so a middleware that short-circuits or transforms the final\n   * result still produces a well-formed public outcome. Returns the\n   * uniform `{ data, report, usage, error }` shape. Never throws.\n   */\n  public async run(): Promise<SupervisorResult<TOutput>> {\n    const context = this.buildSupervisorContext();\n\n    let result: SupervisorResult<TOutput>;\n\n    try {\n      result = (await runPipeline(\n        this.middleware,\n        \"supervisor\",\n        context,\n        () => this.runCore(),\n        this.logger,\n      )) as SupervisorResult<TOutput>;\n    } catch (thrown) {\n      // A `supervisor`-level hook threw without recovery (or\n      // `onError` returned void). The iteration loop's own failures\n      // are already absorbed into `this.error` inside `runCore` and\n      // never reach here — this catch covers middleware aborts and\n      // any unexpected throw, funneling them into a well-formed\n      // result so `supervisor.execute()` keeps its never-throws\n      // contract.\n      this.error = toAIError(thrown);\n      this.status = this.error instanceof SupervisorCancelledError ? \"cancelled\" : \"failed\";\n      this.terminatedBy = this.error instanceof SupervisorCancelledError ? \"cancelled\" : \"error\";\n\n      if (this.error instanceof SupervisorCancelledError) {\n        this.cancelledAtIso = this.error.cancelledAt;\n      }\n\n      if (this.error instanceof MaxIterationsError) {\n        this.status = \"max-iterations\";\n        this.terminatedBy = \"max-iterations\";\n      }\n\n      result = await this.finalize();\n    }\n\n    if (result.error) {\n      if (this.status === \"cancelled\") {\n        this.emit(\"supervisor.cancelled\", {\n          cancelledAt: this.cancelledAtIso ?? new Date().toISOString(),\n          reason: (result.error as SupervisorCancelledError).reason,\n        });\n      } else {\n        this.emit(\"supervisor.error\", { error: result.error });\n      }\n    }\n\n    this.emit(\"supervisor.completed\", { result });\n\n    this.streamController?.end(result);\n\n    this.logger.info(this.logModule, \"completed\", \"supervisor completed\", {\n      runId: this.runId,\n      status: this.status,\n      iterations: this.snapshots.length,\n      duration: performance.now() - this.startPerf,\n    });\n\n    return result;\n  }\n\n  /**\n   * Build the `supervisor`-level middleware context — the stable\n   * identity of this run plus the per-run shared-state bag every hook\n   * sees. Constructed once per run, before the pipeline `before` hooks\n   * fire. Mirrors the agent's `buildExecuteContext`, one level up.\n   */\n  private buildSupervisorContext(): MiddlewareSupervisorContext {\n    return {\n      supervisor: {\n        name: this.config.name,\n        signature: this.signature,\n      },\n      input: this.input,\n      options: this.options,\n      state: this.middlewareState,\n      signal: this.options?.signal,\n    };\n  }\n\n  /**\n   * Inner body wrapped by the `supervisor`-level pipeline. Emits the\n   * `supervisor.starting` event, drives the iteration loop, absorbs\n   * every iteration-loop failure into `this.error` (so the run never\n   * throws from here), and returns the assembled `SupervisorResult`.\n   * `supervisor`-level `after` hooks receive this result, with `error`\n   * populated when the loop failed; `before` hooks can short-circuit\n   * before this ever runs.\n   */\n  private async runCore(): Promise<SupervisorResult<TOutput>> {\n    this.emit(\"supervisor.starting\", {\n      supervisorName: this.config.name,\n      input: this.input,\n    });\n\n    this.logger.info(this.logModule, \"starting\", \"supervisor starting\", {\n      runId: this.runId,\n      maxIterations: this.maxIterations,\n    });\n\n    try {\n      await this.runIterationLoop();\n    } catch (thrown) {\n      this.error = toAIError(thrown);\n      this.status = this.error instanceof SupervisorCancelledError ? \"cancelled\" : \"failed\";\n      this.terminatedBy = this.error instanceof SupervisorCancelledError ? \"cancelled\" : \"error\";\n\n      if (this.error instanceof SupervisorCancelledError) {\n        this.cancelledAtIso = this.error.cancelledAt;\n      }\n\n      if (this.error instanceof MaxIterationsError) {\n        this.status = \"max-iterations\";\n        this.terminatedBy = \"max-iterations\";\n      }\n    }\n\n    return this.finalize();\n  }\n\n  /**\n   * Drive the iteration loop until a terminal condition fires:\n   * `END` / `satisfied:true` / `maxIterations` / signal abort /\n   * routing error. Between-iteration cancellation is guaranteed —\n   * the signal is checked before every iteration starts.\n   */\n  private async runIterationLoop(): Promise<void> {\n    while (this.iteration < this.maxIterations) {\n      this.throwIfCancelled();\n\n      const continued = await this.runIteration();\n\n      if (!continued) {\n        return;\n      }\n\n      this.iteration += 1;\n    }\n\n    throw new MaxIterationsError(\n      `supervisor \"${this.config.name}\" exceeded maxIterations=${this.maxIterations}`,\n      { maxIterations: this.maxIterations },\n    );\n  }\n\n  /**\n   * Run one iteration end-to-end: decide → dispatch → evaluate →\n   * snapshot. Returns `true` when the loop should continue to the\n   * next iteration, `false` when this iteration terminated the run\n   * (success or satisfied-verdict). Failures throw — the loop's\n   * outer catch converts them into typed errors on the result.\n   */\n  private async runIteration(): Promise<boolean> {\n    const iterationStartedAt = new Date();\n    const iterationStart = performance.now();\n    const iterationUsage: Usage = { input: 0, output: 0, total: 0 };\n\n    // Phase 8 / decisions §38 — reset the captured-artifacts forensic\n    // surface at iteration start so a snapshot built for an iteration\n    // whose tools wrote nothing carries an empty bag, not a stale\n    // carry-over from the prior iteration. `mergeArtifactsIntoState`\n    // refreshes this with the live bag (frozen) before merge.\n    this.capturedIterationArtifacts = Object.freeze({});\n\n    this.emit(\"supervisor.iteration.starting\", { iteration: this.iteration });\n\n    // Kick off the receptionist (`ack`) in parallel with phase A's\n    // dispatch decision — fires on iter 0 only when the run is fresh\n    // (resumes don't re-emit; user already saw the original ack). The\n    // promise is NOT awaited inline — `settleAck` probes it\n    // non-blockingly later so a slow ack never extends total wall-\n    // clock time. If ack hasn't settled by the probe point, its slice\n    // is abandoned with a warning + error on the report.\n    const ackPromise =\n      this.iteration === 0 && !this.resumeFrom && this.config.ack ? this.runAck() : undefined;\n\n    // Phase 7 / decisions §37 — classifier prelude. Runs once on iter 0\n    // for fresh runs only (resumes inherit the prior classifier output\n    // via state + report.classifier). Awaited inline because its\n    // output drives the iter-0 dispatch decision; ack remains\n    // non-blocking parallel by design.\n    if (this.iteration === 0 && !this.resumeFrom && this.config.classifier) {\n      await this.runClassifier();\n\n      if (this.classifierHalted) {\n        // Refine returned END (or classifier-alone mode interpreted\n        // an END signal). Settle ack, mark terminated, capture a\n        // synthetic decision snapshot, and exit the loop. State may\n        // already carry refine's slice — do not clobber.\n        await this.settleAck(ackPromise, iterationUsage);\n        this.terminatedBy = \"classifier\";\n        this.status = \"completed\";\n\n        await this.recordTerminalDecisionSnapshot(\n          {\n            kind: \"end\",\n            source: \"classifier\",\n            raw: END,\n            durationMs: 0,\n          },\n          iterationStartedAt,\n          iterationStart,\n          iterationUsage,\n        );\n\n        return false;\n      }\n    }\n\n    const decision = await this.decideDispatch();\n\n    this.aggregateUsage(iterationUsage, decision.usage);\n\n    if (decision.kind === \"end\") {\n      await this.settleAck(ackPromise, iterationUsage);\n      this.terminatedBy = decision.source === \"route\" ? \"route\" : \"router\";\n      this.status = \"completed\";\n\n      await this.recordTerminalDecisionSnapshot(\n        decision,\n        iterationStartedAt,\n        iterationStart,\n        iterationUsage,\n      );\n\n      return false;\n    }\n\n    const branchSnapshots = await this.dispatchBranches(decision);\n\n    for (const snapshot of branchSnapshots) {\n      this.aggregateUsage(iterationUsage, snapshot.usage);\n    }\n\n    // Settle ack (if kicked off) before phase C merge. Probe is\n    // non-blocking — `setImmediate` yields one macrotask cycle so an\n    // already-resolved ack wins via microtask priority; otherwise the\n    // probe returns NOT_READY and ack is abandoned (slice dropped,\n    // warning logged, error captured on `report.ack`). Specialist\n    // branches override the receptionist on key collision either way.\n    await this.settleAck(ackPromise, iterationUsage);\n\n    // Merge branch outputs into supervisor state in decision.intents\n    // order so fan-out conflict resolution is deterministic — last\n    // intent in the array wins on key collisions (Q15). Errored\n    // branches don't contribute. Entries without an `output` schema\n    // (agent/workflow) are NOT auto-merged — declaring the slice is\n    // opt-in. Callbacks always merge (their full return value when\n    // no schema; strip-merged when schema is declared) — they had\n    // their schema applied inside runCallback already.\n    this.mergeBranchesIntoState(decision.intents, branchSnapshots);\n\n    // Phase 5 / decisions §35 — merge tool-side artifacts into state\n    // AFTER branch slices land but BEFORE evaluate runs, so the\n    // evaluate verdict sees the post-merge state including blocks /\n    // citations / soft signals contributed by tools. Resets the bag\n    // for the next iteration; long runs and orchestrator sessions\n    // never accumulate raw artifacts.\n    await this.mergeArtifactsIntoState();\n\n    this.lastDispatchIntents = decision.intents;\n\n    const evaluateVerdict = await this.runEvaluate(branchSnapshots);\n\n    if (evaluateVerdict !== undefined && evaluateVerdict !== null) {\n      this.emit(\"supervisor.evaluate.verdict\", {\n        iteration: this.iteration,\n        verdict: evaluateVerdict,\n      });\n    }\n\n    const iterationEndedAt = new Date();\n    const duration = performance.now() - iterationStart;\n\n    const snapshot: IterationSnapshot = Object.freeze({\n      iteration: this.iteration,\n      result: indexByIntent(branchSnapshots),\n      decision: {\n        source: decision.source,\n        next: decision.raw,\n        reasoning: decision.reasoning,\n        durationMs: decision.durationMs,\n      },\n      evaluateVerdict,\n      state: { ...this.state },\n      artifacts: this.capturedIterationArtifacts,\n      startedAt: iterationStartedAt.toISOString(),\n      endedAt: iterationEndedAt.toISOString(),\n      duration,\n      usage: iterationUsage,\n    });\n\n    this.snapshots.push(snapshot);\n\n    this.emit(\"supervisor.iteration.completed\", {\n      iteration: this.iteration,\n      snapshot,\n    });\n\n    await this.checkpoint(\"running\");\n\n    if (evaluateVerdict?.satisfied) {\n      this.terminatedBy = \"evaluate\";\n      this.status = \"completed\";\n\n      return false;\n    }\n\n    this.carriedFeedback = evaluateVerdict;\n\n    // Stage 4d (Q24): when evaluate hasn't taken a stance via\n    // `reassignTo`, collect each branch's `intent.next(ctx)` to drive\n    // the next iteration without a router call. Evaluate's\n    // `reassignTo` outranks `next` — if evaluate forced a target,\n    // `next` doesn't get to vote.\n    const evaluateForcedReassign =\n      evaluateVerdict?.reassignTo !== undefined &&\n      normalizeReassign(evaluateVerdict.reassignTo).length > 0;\n\n    if (!evaluateForcedReassign) {\n      const collected = this.collectIntentNext(decision.intents, branchSnapshots);\n\n      if (collected?.kind === \"end\") {\n        this.terminatedBy = \"route\";\n        this.status = \"completed\";\n        this.carriedNextDispatch = undefined;\n        return false;\n      }\n\n      if (collected?.kind === \"dispatch\") {\n        this.carriedNextDispatch = { intents: collected.intents };\n      }\n    }\n\n    // Phase 7 / decisions §37 — classifier-alone supervisor auto-\n    // terminates after iter 0's branch settles. Without router/route,\n    // there's no decision source for iter 1; preempt the throw with\n    // a clean termination. `intent.next` from iter 0's dispatched\n    // intent still wins if it set a continuation (rare, but allowed).\n    if (\n      this.iteration === 0 &&\n      this.config.classifier &&\n      !this.config.router &&\n      !this.config.route &&\n      !this.carriedNextDispatch\n    ) {\n      this.terminatedBy = \"classifier\";\n      this.status = \"completed\";\n\n      return false;\n    }\n\n    return true;\n  }\n\n  /**\n   * Resolve the dispatch decision for this iteration — defers to\n   * `decide.ts`. When `carriedFeedback.reassignTo` is set the\n   * supervisor overrides the router/route decision with an\n   * evaluator-forced dispatch (design §2 — \"Evaluate can override\n   * router\").\n   */\n  private async decideDispatch(): Promise<DispatchDecision> {\n    if (this.config.router) {\n      this.emit(\"supervisor.router.deciding\", { iteration: this.iteration });\n    }\n\n    const reassignTo = normalizeReassign(this.carriedFeedback?.reassignTo);\n\n    if (reassignTo.length > 0) {\n      this.carriedNextDispatch = undefined;\n      for (const intent of reassignTo) {\n        if (!this.entries.has(intent)) {\n          throw new SupervisorFailedError(\n            `evaluate.reassignTo targeted unknown agent \"${intent}\"`,\n            { context: { available: [...this.entries.keys()] } },\n          );\n        }\n      }\n\n      const decision: DispatchDecision = {\n        kind: \"dispatch\",\n        intents: reassignTo,\n        source: \"route\",\n        raw: reassignTo.length === 1 ? reassignTo[0] : reassignTo,\n        durationMs: 0,\n      };\n\n      this.emit(\"supervisor.router.decided\", {\n        iteration: this.iteration,\n        next: decision.raw,\n        reasoning: this.carriedFeedback?.feedback,\n        durationMs: 0,\n      });\n\n      return decision;\n    }\n\n    // Phase 7 / decisions §37 — classifier prelude (iter 0 only)\n    // produced an intent dispatch decision. Skip router/route /\n    // initialAgent entirely; classifier's pick wins. Cleared after\n    // consumption — iter 1+ falls through to router/route as usual.\n    if (this.carriedClassifierDispatch) {\n      const carried = this.carriedClassifierDispatch;\n      this.carriedClassifierDispatch = undefined;\n\n      const decision: DispatchDecision = {\n        kind: \"dispatch\",\n        intents: [carried.intent],\n        source: \"classifier\",\n        raw: carried.intent,\n        durationMs: 0,\n      };\n\n      this.emit(\"supervisor.router.decided\", {\n        iteration: this.iteration,\n        next: decision.raw,\n        reasoning: this.classifierSnapshot?.reasoning,\n        durationMs: 0,\n      });\n\n      return decision;\n    }\n\n    // Stage 4d: per-intent `next` collected from the previous\n    // iteration drives this dispatch — skip router/route entirely.\n    if (this.carriedNextDispatch) {\n      const carried = this.carriedNextDispatch;\n      this.carriedNextDispatch = undefined;\n\n      const decision: DispatchDecision = {\n        kind: \"dispatch\",\n        intents: carried.intents,\n        source: \"route\",\n        raw: carried.intents.length === 1 ? carried.intents[0] : carried.intents,\n        durationMs: 0,\n      };\n\n      this.emit(\"supervisor.router.decided\", {\n        iteration: this.iteration,\n        next: decision.raw,\n        reasoning: undefined,\n        durationMs: 0,\n      });\n\n      return decision;\n    }\n\n    const decision = await decide({\n      config: this.config as SupervisorConfig<unknown>,\n      entries: this.entries,\n      iteration: this.iteration,\n      maxIterations: this.maxIterations,\n      iterations: this.snapshots,\n      input: this.input,\n      state: this.state,\n      context: this.context,\n      history: this.history,\n      goal: this.goal,\n      evaluateFeedback: this.carriedFeedback,\n      classifier: this.classifierSnapshot,\n      signal: this.options?.signal,\n      useInitialAgent: this.iteration === 0 && !this.resumeFrom,\n    });\n\n    // Capture the router agent's report into the supervisor's tree so\n    // router cost + internals are observable alongside dispatched\n    // branches. Only present when decide() went through a router agent.\n    if (decision.routerReport) {\n      this.childReports.push(decision.routerReport);\n    }\n\n    this.emit(\"supervisor.router.decided\", {\n      iteration: this.iteration,\n      next: decision.raw,\n      reasoning: decision.reasoning,\n      durationMs: decision.durationMs,\n    });\n\n    return decision;\n  }\n\n  /**\n   * Dispatch every intent named by the decision in parallel. Per-\n   * branch errors don't abort siblings — they're recorded on the\n   * branch snapshot and let evaluate (or default termination logic)\n   * decide the response.\n   */\n  private async dispatchBranches(\n    decision: DispatchDecision & { kind: \"dispatch\" },\n  ): Promise<AgentBranchSnapshot[]> {\n    const branches = await Promise.all(decision.intents.map((intent) => this.dispatchOne(intent)));\n\n    return branches;\n  }\n\n  /**\n   * Execute a single branch — resolve the input, invoke the\n   * agent / workflow / callback, apply the per-intent `output`\n   * transformer, and produce an immutable `AgentBranchSnapshot`.\n   */\n  private async dispatchOne(intent: string): Promise<AgentBranchSnapshot> {\n    const entry = this.entries.get(intent)!;\n\n    if (entry.type === \"callback\") {\n      return this.dispatchCallback(entry);\n    }\n\n    const routeContext: RouteContext = {\n      iteration: this.iteration,\n      input: this.input,\n      state: this.state,\n      iterations: this.snapshots,\n      feedback:\n        typeof this.carriedFeedback?.feedback === \"string\"\n          ? this.carriedFeedback.feedback\n          : undefined,\n      evaluateFeedback: this.carriedFeedback,\n      context: this.context,\n      history: this.history,\n      goal: this.goal,\n      classifier: this.classifierSnapshot,\n    };\n\n    const resolvedInput = this.resolveBranchInput(entry, routeContext);\n    const dispatchCtxForPlaceholders = this.seedDispatchContext(\n      intent,\n      resolvedInput,\n      new Set<string>([intent]),\n      [],\n    );\n    const placeholders = entry.placeholders\n      ? entry.placeholders(dispatchCtxForPlaceholders)\n      : undefined;\n\n    this.emit(\"supervisor.agent.starting\", {\n      iteration: this.iteration,\n      intent,\n      input: resolvedInput,\n    });\n\n    const startedAt = new Date();\n    const startPerf = performance.now();\n\n    let rawResult: AgentResult<unknown> | WorkflowResult<unknown> | undefined;\n    let branchError: AIError | undefined;\n    let branchUsage: Usage = { input: 0, output: 0, total: 0 };\n\n    try {\n      rawResult = await this.invokeUnit(entry, resolvedInput, placeholders, routeContext);\n\n      if (rawResult.error) {\n        branchError = rawResult.error;\n      }\n\n      branchUsage = rawResult.usage;\n\n      // Capture the child's execution report into the supervisor's\n      // recursive tree. Each dispatched agent/workflow contributes\n      // one BaseReport node; fan-out produces sibling children.\n      if (rawResult.report) {\n        this.childReports.push(rawResult.report);\n      }\n    } catch (thrown) {\n      branchError = toAIError(thrown);\n    }\n\n    const sliceOutcome = await this.applyOutputSchema(entry, rawResult);\n    const transformedOutput = sliceOutcome.value;\n    if (sliceOutcome.error && !branchError) {\n      branchError = sliceOutcome.error;\n    }\n    const endedAt = new Date();\n    const duration = performance.now() - startPerf;\n\n    const snapshot: AgentBranchSnapshot = Object.freeze({\n      intent,\n      input: resolvedInput,\n      output: transformedOutput,\n      usage: branchUsage,\n      startedAt: startedAt.toISOString(),\n      endedAt: endedAt.toISOString(),\n      duration,\n      error: branchError,\n    });\n\n    if (branchError) {\n      this.emit(\"supervisor.agent.failed\", {\n        iteration: this.iteration,\n        intent,\n        error: branchError,\n      });\n    } else {\n      this.emit(\"supervisor.agent.completed\", {\n        iteration: this.iteration,\n        intent,\n        output: transformedOutput,\n        usage: branchUsage,\n        duration,\n      });\n    }\n\n    return snapshot;\n  }\n\n  /**\n   * Dispatch a callback intent as a top-level branch — produces an\n   * `AgentBranchSnapshot` and pushes the synthesized callback report\n   * onto the supervisor's recursive children. Delegates the actual\n   * callback invocation to {@link runCallback} so nested\n   * `ctx.intents.X.execute()` calls can reuse the same machinery.\n   *\n   * Each branch dispatch starts with a fresh per-branch call stack —\n   * sibling fan-out branches don't share cycle-detection state, so\n   * branch A and branch B both invoking the same intent isn't a\n   * cycle. The branch's own intent name is seeded onto the stack so\n   * a callback that re-enters itself via `ctx.intents.X.execute()` trips\n   * cycle detection on the first recursion.\n   */\n  private async dispatchCallback(entry: ResolvedCallbackEntry): Promise<AgentBranchSnapshot> {\n    const intent = entry.intent;\n    const callStack = new Set<string>([intent]);\n    const callbackInput = entry.input\n      ? entry.input(this.seedDispatchContext(intent, this.input, callStack, []))\n      : this.input;\n    const inputForSnapshot =\n      typeof callbackInput === \"string\" ? callbackInput : safeStringify(callbackInput);\n\n    this.emit(\"supervisor.agent.starting\", {\n      iteration: this.iteration,\n      intent,\n      input: inputForSnapshot,\n    });\n\n    const outcome = await this.runCallback(entry, callbackInput, callStack, this.childReports);\n\n    const snapshot: AgentBranchSnapshot = Object.freeze({\n      intent,\n      input: inputForSnapshot,\n      output: outcome.output,\n      usage: outcome.report.usage,\n      startedAt: outcome.report.startedAt,\n      endedAt: outcome.report.endedAt,\n      duration: outcome.report.duration,\n      error: outcome.error,\n    });\n\n    if (outcome.error) {\n      this.emit(\"supervisor.agent.failed\", {\n        iteration: this.iteration,\n        intent,\n        error: outcome.error,\n      });\n    } else {\n      this.emit(\"supervisor.agent.completed\", {\n        iteration: this.iteration,\n        intent,\n        output: outcome.output,\n        usage: outcome.report.usage,\n        duration: outcome.report.duration,\n      });\n    }\n\n    return snapshot;\n  }\n\n  /**\n   * Run a callback intent and produce its leaf report + final\n   * output. Used both for top-level branch dispatch (via\n   * {@link dispatchCallback}) and for nested `dispatch.byName`\n   * recursion. The synthesized report is appended to `reportSink`,\n   * which is either `this.childReports` (top-level) or the calling\n   * callback's own `children[]` (nested) — that's what gives the\n   * unified report tree its compositional shape.\n   *\n   * Usage on the report rolls up children's usage; the callback\n   * itself contributes zero (it's dev code, no token spend).\n   */\n  private async runCallback(\n    entry: ResolvedCallbackEntry,\n    input: unknown,\n    callStack: Set<string>,\n    reportSink: BaseReport[],\n  ): Promise<{ output: unknown; error?: AIError; report: BaseReport }> {\n    const childReports: BaseReport[] = [];\n    const dispatchCtx: DispatchContext = this.seedDispatchContext(\n      entry.intent,\n      input,\n      callStack,\n      childReports,\n    );\n\n    const startedAt = new Date();\n    const startPerf = performance.now();\n\n    let rawOutput: unknown;\n    let error: AIError | undefined;\n\n    try {\n      rawOutput = await entry.callback(dispatchCtx);\n    } catch (thrown) {\n      error =\n        thrown instanceof AIError\n          ? thrown\n          : new SupervisorFailedError(\n              `callback intent \"${entry.intent}\" threw: ${\n                thrown instanceof Error ? thrown.message : String(thrown)\n              }`,\n              { cause: thrown },\n            );\n    }\n\n    let transformedOutput: unknown = rawOutput;\n\n    if (!error && entry.output) {\n      const validation = await entry.output[\"~standard\"].validate(rawOutput);\n      if (validation.issues) {\n        error = new SchemaValidationError(\n          `intent \"${entry.intent}\" output failed validation: ${validation.issues\n            .map((issue) => issue.message)\n            .join(\"; \")}`,\n          { issues: validation.issues },\n        );\n        transformedOutput = undefined;\n      } else {\n        transformedOutput = validation.value;\n      }\n    }\n\n    const endedAt = new Date();\n    const duration = performance.now() - startPerf;\n    const rolledUsage = aggregateChildUsage(childReports);\n\n    const report: BaseReport = {\n      runId: `${this.runId}.${entry.intent}`,\n      rootRunId: this.runId,\n      name: entry.intent,\n      type: \"callback\",\n      status: error ? \"failed\" : \"completed\",\n      startedAt: startedAt.toISOString(),\n      endedAt: endedAt.toISOString(),\n      duration,\n      usage: rolledUsage,\n      children: childReports,\n    };\n\n    reportSink.push(report);\n\n    return { output: transformedOutput, error, report };\n  }\n\n  /**\n   * Build a {@link DispatchContext} with a typed `intents` map of\n   * `IntentRunner` closures, each closing over the supplied call\n   * stack and report sink. Cycle detection uses the call stack —\n   * re-entering an intent already on it throws\n   * `SupervisorFailedError` with code `SUPERVISOR_DISPATCH_CYCLE`\n   * and the offending chain in the message.\n   *\n   * Replaces the Phase-3.3 `ctx.dispatch.byName` plumbing with\n   * property-access on a typed map (Q5/Q6) — autocomplete, no typo\n   * crashes, `.execute()` matches every other primitive's verb.\n   */\n  private seedDispatchContext(\n    intent: string,\n    input: unknown,\n    callStack: Set<string>,\n    reportSink: BaseReport[],\n  ): DispatchContext {\n    type RunnerSlot = {\n      execute: (input?: unknown) => Promise<unknown>;\n      stream: (input?: unknown) => unknown;\n    };\n    const intentsMap: Record<string, RunnerSlot> = {};\n\n    for (const target of this.entries.keys()) {\n      intentsMap[target] = {\n        execute: (override?: unknown) =>\n          this.runIntent(target, override === undefined ? input : override, callStack, reportSink),\n        stream: (override?: unknown) =>\n          this.streamIntent(\n            target,\n            override === undefined ? input : override,\n            callStack,\n            reportSink,\n            intent,\n          ),\n      };\n    }\n\n    return {\n      iteration: this.iteration,\n      intent,\n      input,\n      state: this.state,\n      result: {},\n      iterations: this.snapshots,\n      signal: this.options?.signal ?? new AbortController().signal,\n      intents: intentsMap as DispatchContext[\"intents\"],\n      context: this.context,\n      history: this.history,\n      goal: this.goal,\n      run: (executable, runInput, runOptions) =>\n        this.runInline(executable, runInput, runOptions, callStack, reportSink),\n      stream: (executable, runInput, runOptions) =>\n        this.streamInline(executable, runInput, runOptions, callStack, reportSink, intent),\n      classifier: this.classifierSnapshot,\n    } as DispatchContext;\n  }\n\n  /**\n   * Backing implementation for `ctx.intents.X.execute(input?)`.\n   * Looks up the named intent in the supervisor's registry, asserts\n   * the call wouldn't close a cycle, and runs the dispatchable\n   * through the same machinery a top-level branch would — except\n   * the resulting report nests under the calling callback's\n   * `children[]` rather than the supervisor's top-level child list,\n   * and only the final output is returned (no snapshot).\n   */\n  private async runIntent(\n    target: string,\n    callerInput: unknown,\n    callStack: Set<string>,\n    reportSink: BaseReport[],\n  ): Promise<unknown> {\n    if (callStack.has(target)) {\n      const chain = [...callStack, target].join(\" → \");\n      throw new SupervisorFailedError(\n        `ctx.intents.${target}.execute: cycle detected (${chain})`,\n        { context: { intent: target } },\n        \"SUPERVISOR_DISPATCH_CYCLE\",\n      );\n    }\n\n    const entry = this.entries.get(target);\n\n    if (!entry) {\n      throw new SupervisorFailedError(\n        `ctx.intents.${target}.execute: unknown intent \"${target}\" — must be a key in the supervisor's \\`intents\\` map`,\n        { context: { intent: target } },\n      );\n    }\n\n    callStack.add(target);\n\n    try {\n      if (entry.type === \"callback\") {\n        const { output, error } = await this.runCallback(entry, callerInput, callStack, reportSink);\n\n        if (error) {\n          throw error;\n        }\n\n        return output;\n      }\n\n      // Agent / workflow path. The unified-report tree gets the\n      // child's report under the calling callback's children — we\n      // intentionally do NOT also push to `this.childReports` (that\n      // would double-count). The agent/workflow's own usage flows\n      // up through the callback's roll-up.\n      const inputString =\n        typeof callerInput === \"string\" ? callerInput : safeStringify(callerInput);\n\n      if (entry.type === \"agent\") {\n        // Recursive `ctx.intents.X.execute()` re-entry path — no\n        // `RouteContext` constructed here, so the per-entry slicer is\n        // skipped; only the global `historyWindow.agents` window\n        // applies. The original outer dispatch already passed a sliced\n        // view; this sub-call mirrors that behavior.\n        const reentryHistory = this.applyAgentsWindow();\n        const result = await entry.unit.execute(inputString, {\n          signal: this.options?.signal,\n          ...(reentryHistory.length > 0 ? { history: reentryHistory } : {}),\n        });\n\n        if (result.report) {\n          reportSink.push(result.report);\n        }\n\n        if (result.error) {\n          throw result.error;\n        }\n\n        return result.data ?? result.text ?? undefined;\n      }\n\n      // workflow\n      const result = await entry.unit.execute(inputString as never, {\n        signal: this.options?.signal,\n      });\n\n      if (result.report) {\n        reportSink.push(result.report);\n      }\n\n      if (result.error) {\n        throw result.error;\n      }\n\n      return result.data;\n    } finally {\n      callStack.delete(target);\n    }\n  }\n\n  /**\n   * Backing implementation for `ctx.intents.X.stream(input?)` (Phase 6\n   * / decisions §36). Streaming sibling of {@link runIntent} — same\n   * cycle protection, same auto-merge of supervisor-level concerns,\n   * but routes through the unit's `.stream()` method when available\n   * and bubbles deltas as `supervisor.agent.streaming` under the\n   * **calling callback's** intent name (not the dispatched intent's).\n   */\n  private streamIntent(\n    target: string,\n    callerInput: unknown,\n    callStack: Set<string>,\n    reportSink: BaseReport[],\n    callerIntent: string,\n  ): StreamContract<SupervisableResult> {\n    if (callStack.has(target)) {\n      const chain = [...callStack, target].join(\" → \");\n      throw new SupervisorFailedError(\n        `ctx.intents.${target}.stream: cycle detected (${chain})`,\n        { context: { intent: target } },\n        \"SUPERVISOR_DISPATCH_CYCLE\",\n      );\n    }\n\n    const entry = this.entries.get(target);\n\n    if (!entry) {\n      throw new SupervisorFailedError(\n        `ctx.intents.${target}.stream: unknown intent \"${target}\" — must be a key in the supervisor's \\`intents\\` map`,\n        { context: { intent: target } },\n      );\n    }\n\n    if (entry.type === \"callback\") {\n      throw new SupervisorFailedError(\n        `ctx.intents.${target}.stream: callback intents are not streamable — use \\`.execute(input?)\\` instead`,\n        { context: { intent: target } },\n      );\n    }\n\n    callStack.add(target);\n\n    const inputString = typeof callerInput === \"string\" ? callerInput : safeStringify(callerInput);\n\n    return this.streamSupervisedExecutable(\n      entry.unit as StreamableExecutable,\n      inputString,\n      undefined,\n      callerIntent,\n      reportSink,\n      () => callStack.delete(target),\n    );\n  }\n\n  /**\n   * Backing implementation for `ctx.run(executable, input, options?)`\n   * (Phase 6 / decisions §36). Runs an inline / un-registered\n   * executable under supervision: auto-merges `signal`, `toolCtx`,\n   * `history` defaults; nests the resulting report under the\n   * calling callback's `children[]`. Per-call options REPLACE auto-\n   * defaults — standard Warlock convention.\n   *\n   * Cycle protection by executable `name` matches the registered-\n   * intent path so a callback that recurses on the same agent trips\n   * the same error, regardless of whether the agent was looked up\n   * via `ctx.intents.X.execute()` or passed inline.\n   */\n  private async runInline(\n    executable: SupervisableExecutable,\n    input: unknown,\n    options: SupervisableExecuteOptions | undefined,\n    callStack: Set<string>,\n    reportSink: BaseReport[],\n  ): Promise<SupervisableResult> {\n    const name = executable.name;\n\n    if (callStack.has(name)) {\n      const chain = [...callStack, name].join(\" → \");\n      throw new SupervisorFailedError(\n        `ctx.run(\"${name}\"): cycle detected (${chain})`,\n        { context: { intent: name } },\n        \"SUPERVISOR_DISPATCH_CYCLE\",\n      );\n    }\n\n    callStack.add(name);\n\n    try {\n      const merged = this.mergeInlineOptions(options);\n      const inputForExecutable = this.coerceInlineInput(executable, input);\n      const result = (await (\n        executable as {\n          execute: (input: unknown, options?: unknown) => Promise<SupervisableResult>;\n        }\n      ).execute(inputForExecutable, merged)) as SupervisableResult;\n\n      if (result.report) {\n        reportSink.push(result.report);\n      }\n\n      return result;\n    } finally {\n      callStack.delete(name);\n    }\n  }\n\n  /**\n   * Backing implementation for `ctx.stream(executable, input, options?)`\n   * (Phase 6 / decisions §36). Streaming sibling of {@link runInline}.\n   * Routes through the executable's native `.stream()` method,\n   * subscribes to delta events, and bubbles them as\n   * `supervisor.agent.streaming` under the calling callback's intent\n   * name. The returned `StreamContract` is the executable's own —\n   * iteration and `.result` work identically.\n   *\n   * Cycle protection on entry mirrors {@link runInline}; release runs\n   * after `.result` settles so a same-callback recursion is caught\n   * regardless of which path closed the cycle.\n   */\n  private streamInline(\n    executable: StreamableExecutable,\n    input: unknown,\n    options: SupervisableExecuteOptions | undefined,\n    callStack: Set<string>,\n    reportSink: BaseReport[],\n    callerIntent: string,\n  ): StreamContract<SupervisableResult> {\n    const name = executable.name;\n\n    if (callStack.has(name)) {\n      const chain = [...callStack, name].join(\" → \");\n      throw new SupervisorFailedError(\n        `ctx.stream(\"${name}\"): cycle detected (${chain})`,\n        { context: { intent: name } },\n        \"SUPERVISOR_DISPATCH_CYCLE\",\n      );\n    }\n\n    callStack.add(name);\n\n    return this.streamSupervisedExecutable(\n      executable,\n      this.coerceInlineInput(executable, input),\n      options,\n      callerIntent,\n      reportSink,\n      () => callStack.delete(name),\n    );\n  }\n\n  /**\n   * Shared wiring for both `ctx.intents.X.stream()` and\n   * `ctx.stream(...)`. Subscribes to the executable's stream, re-\n   * emits deltas as `supervisor.agent.streaming` under the calling\n   * callback's intent name, and pushes the inner report onto the\n   * reportSink once `.result` settles. The returned StreamContract\n   * is the executable's own — the framework attaches handlers\n   * transparently via `.on(...)`.\n   */\n  private streamSupervisedExecutable(\n    executable: StreamableExecutable,\n    input: unknown,\n    options: SupervisableExecuteOptions | undefined,\n    callerIntent: string,\n    reportSink: BaseReport[],\n    release: () => void,\n  ): StreamContract<SupervisableResult> {\n    const merged = this.mergeInlineOptions(options);\n    const stream = (\n      executable as {\n        stream: (input: unknown, options?: unknown) => StreamContract<SupervisableResult>;\n      }\n    ).stream(input, merged);\n\n    // Bubble inner deltas under the CALLING callback's intent name.\n    // Agents fire `agent.trip.streaming`; supervisors fire\n    // `supervisor.agent.streaming` already — the inner intent name\n    // there is the inner supervisor's specialist, which we replace\n    // with the outer callback's name so attribution is consistent.\n    const handlers: Record<string, (event: { delta: string }) => void> = {\n      \"agent.trip.streaming\": ({ delta }) => {\n        this.emit(\"supervisor.agent.streaming\", {\n          iteration: this.iteration,\n          intent: callerIntent,\n          delta,\n        });\n      },\n      \"supervisor.agent.streaming\": ({ delta }) => {\n        this.emit(\"supervisor.agent.streaming\", {\n          iteration: this.iteration,\n          intent: callerIntent,\n          delta,\n        });\n      },\n    };\n\n    stream.on(handlers);\n\n    // Always release the cycle-protection slot after `.result` settles\n    // (success OR failure) so subsequent calls in the same callback\n    // see a clean stack. Push report on success.\n    void stream.result.then(\n      (result) => {\n        if (result?.report) {\n          reportSink.push(result.report);\n        }\n\n        release();\n      },\n      () => release(),\n    );\n\n    return stream;\n  }\n\n  /**\n   * Build the options object passed into an inline `.execute()` /\n   * `.stream()` call. Auto-merges supervisor-level defaults\n   * (`signal`, `toolCtx`, `history` window) under the caller's\n   * options. Per-call values REPLACE the auto-defaults — when the\n   * dev passes `signal: undefined` they explicitly opt out.\n   */\n  private mergeInlineOptions(\n    options: SupervisableExecuteOptions | undefined,\n  ): SupervisableExecuteOptions {\n    const supplied = (options ?? {}) as Record<string, unknown>;\n    const merged: Record<string, unknown> = { ...supplied };\n\n    if (!(\"signal\" in supplied)) {\n      merged.signal = this.options?.signal;\n    }\n\n    if (!(\"toolCtx\" in supplied)) {\n      merged.toolCtx = {\n        artifacts: this.currentArtifacts,\n        signal: this.options?.signal,\n      };\n    }\n\n    if (!(\"history\" in supplied)) {\n      const window = this.applyAgentsWindow();\n\n      if (window.length > 0) {\n        merged.history = window;\n      }\n    }\n\n    return merged as SupervisableExecuteOptions;\n  }\n\n  /**\n   * Coerce an arbitrary inline input into the shape the underlying\n   * executable expects. Agents take `string`; workflows + supervisors\n   * take whatever they declared. We safe-stringify objects only when\n   * passing to an agent — workflow / supervisor calls hand the value\n   * through unchanged so structured inputs work.\n   */\n  private coerceInlineInput(executable: SupervisableExecutable, input: unknown): unknown {\n    // Agents are the only kind that strictly require string input.\n    // Workflows / supervisors accept arbitrary shapes.\n    const isAgent =\n      !(\"signature\" in executable) &&\n      typeof executable.execute === \"function\" &&\n      !this.isSupervisor(executable);\n\n    if (isAgent && typeof input !== \"string\") {\n      return safeStringify(input);\n    }\n\n    return input;\n  }\n\n  /**\n   * Heuristic detection of `SupervisorContract` — the contract carries\n   * a `signature` getter same as workflows, but supervisors expose\n   * `resume()` while workflows expose `resume(runId, options)` too.\n   * Cleanest distinguisher in the public surface: supervisors carry\n   * the `asTool` method name `as` … unfortunately so do workflows.\n   * Use the `streamableType` brand if we add one in v2; for now lean\n   * on a duck-typed check that's good enough for the ctx.run path\n   * (incorrect routing for workflows would still produce a runnable\n   * call — workflow.execute accepts the same args either way).\n   */\n  private isSupervisor(executable: SupervisableExecutable): boolean {\n    return (\n      typeof (executable as { resume?: unknown; signature?: unknown }).resume === \"function\" &&\n      typeof (executable as { signature?: unknown }).signature === \"string\" &&\n      typeof (executable as { stream?: unknown }).stream === \"function\"\n    );\n  }\n\n  /**\n   * Invoke the underlying dispatchable unit. Agents and workflows\n   * both satisfy `ExecutableContract<string, …>` so the call shape\n   * is uniform; the `type` discriminator picks which options get\n   * threaded through (e.g. per-call stream event bubbling for\n   * agents, which we wire inline so child agent tokens surface as\n   * `supervisor.agent.streaming`).\n   */\n  private async invokeUnit(\n    entry: Exclude<ResolvedIntentEntry, ResolvedCallbackEntry>,\n    input: string,\n    placeholders: Record<string, unknown> | undefined,\n    routeContext: RouteContext,\n  ): Promise<AgentResult<unknown> | WorkflowResult<unknown>> {\n    // When the supervisor itself is being streamed by the caller, run\n    // the child agent in streaming mode too — that's the only way\n    // token deltas surface up the tree as `supervisor.agent.streaming`\n    // events. `agent.execute()` always uses `model.complete()` which\n    // never fires `agent.trip.streaming`, so wiring a callback there\n    // is a silent no-op for tokens. Lifecycle events (trip.started /\n    // tool.called / completed) still fire through `.on()` regardless\n    // — they're driven by orchestration boundaries, not the wire mode.\n    const isStreaming = this.streamController !== undefined;\n\n    if (entry.type === \"agent\") {\n      // `type` and `unit` aren't a discriminated union on the entry\n      // type — narrow manually. `resolveIntentEntries` guarantees\n      // `unit` matches `type` at runtime.\n      const agent = entry.unit as AgentContract<unknown>;\n      const handlers = {\n        \"agent.trip.streaming\": ({ delta }: { delta: string }) => {\n          this.emit(\"supervisor.agent.streaming\", {\n            iteration: this.iteration,\n            intent: entry.intent,\n            delta,\n          });\n        },\n      };\n\n      // Phase 5 / decisions §34 — stream-mode intents drop the\n      // structured-output schema (factory already rejects coexistence)\n      // and always run via `agent.stream()` so token deltas surface as\n      // `supervisor.agent.streaming` events regardless of whether the\n      // top-level caller streamed the supervisor.\n      const isStreamMode = entry.mode === \"stream\";\n\n      // Stage 4b/4d: forward `intent.output` as the agent's per-call\n      // output schema when declared. The agent then parses model\n      // output as structured data; `applyOutputSchema` re-validates\n      // (cheap) and strip-merges into supervisor state.\n      const resolvedHistory = this.resolveHistoryFor(\"agents\", routeContext, entry.history);\n      const agentOptions = {\n        signal: this.options?.signal,\n        on: handlers,\n        ...(placeholders ? { placeholders } : {}),\n        ...(entry.output && !isStreamMode ? { output: entry.output } : {}),\n        ...(resolvedHistory.length > 0 ? { history: resolvedHistory } : {}),\n        toolCtx: {\n          artifacts: this.currentArtifacts,\n          signal: this.options?.signal,\n        },\n      };\n\n      if (isStreamMode || isStreaming) {\n        const childStream = agent.stream(input, agentOptions);\n        return childStream.result;\n      }\n\n      return agent.execute(input, agentOptions);\n    }\n\n    const workflow = entry.unit as WorkflowInstance<unknown, unknown>;\n\n    return workflow.execute(input, {\n      signal: this.options?.signal,\n      on: {\n        \"workflow.step.streaming\": ({ delta }) => {\n          this.emit(\"supervisor.agent.streaming\", {\n            iteration: this.iteration,\n            intent: entry.intent,\n            delta,\n          });\n        },\n      },\n    });\n  }\n\n  /**\n   * Build the input string passed to a branch's child execution.\n   * Default: pass the supervisor's original `ctx.input` through\n   * unchanged. The per-intent `entry.input` override is the escape\n   * hatch for the rare case where the agent's user message itself\n   * must vary per intent.\n   *\n   * Q17 lock: dropped `composeAgentInput` + `defaultComposeAgentInput`.\n   * Their three jobs (carry original / prior outputs / feedback) all\n   * have cleaner homes in the new model — original is the input\n   * itself, prior outputs are state (Stage 4b), feedback is a\n   * router-only signal (Q18).\n   */\n  private resolveBranchInput(\n    entry: Exclude<ResolvedIntentEntry, ResolvedCallbackEntry>,\n    ctx: RouteContext,\n  ): string {\n    const override = entry.input?.(ctx);\n\n    if (typeof override === \"string\") {\n      return override;\n    }\n\n    // Q1: supervisor-level input may be an object payload. Agents\n    // need a string — JSON-stringify when no per-intent override\n    // converted it. Devs wanting a different shape supply\n    // `entry.input(ctx)`.\n    return typeof ctx.input === \"string\" ? ctx.input : safeStringify(ctx.input);\n  }\n\n  /**\n   * Strip-merge the agent/workflow's raw output against the per-intent\n   * `output` schema (Q11/Q13). Returns the validated slice that:\n   *\n   *   1. Lands on `IterationSnapshot.result[intent].output` (so\n   *      consumers see the same shape that hit state).\n   *   2. Shallow-merges into `this.state` (handled by the caller).\n   *\n   * When `entry.output` is omitted the agent's full `data` (or `text`\n   * fallback for unstructured agents) flows through unvalidated — but\n   * is NOT auto-merged into state. State contribution is opt-in via\n   * declaring the slice schema.\n   *\n   * Validation failure surfaces as a per-branch error on the\n   * snapshot; sibling branches still run.\n   */\n  private async applyOutputSchema(\n    entry: Exclude<ResolvedIntentEntry, ResolvedCallbackEntry>,\n    raw: AgentResult<unknown> | WorkflowResult<unknown> | undefined,\n  ): Promise<{ value: unknown; error?: AIError }> {\n    if (!raw) {\n      return { value: undefined };\n    }\n\n    const sourceValue = isAgentResult(raw)\n      ? (raw.data ?? raw.text ?? undefined)\n      : isWorkflowResult(raw)\n        ? raw.data\n        : undefined;\n\n    // Phase 5 / decisions §34 — stream-mode agents have no `output`\n    // schema. The assembled prose comes back as `raw.text` (the agent\n    // never produced structured `data` because we dropped the schema\n    // in `invokeUnit`). Wrap it as `{ [streamTo]: text }` so the\n    // existing strip-merge path lands the prose under the named state\n    // key without further special-casing downstream.\n    if (entry.type === \"agent\" && entry.mode === \"stream\") {\n      const text = typeof sourceValue === \"string\" ? sourceValue : \"\";\n\n      return { value: { [entry.streamTo as string]: text } };\n    }\n\n    if (!entry.output) {\n      return { value: sourceValue };\n    }\n\n    const validation = await entry.output[\"~standard\"].validate(sourceValue);\n\n    if (validation.issues) {\n      return {\n        value: undefined,\n        error: new SchemaValidationError(\n          `intent \"${entry.intent}\" output failed validation: ${validation.issues\n            .map((issue) => issue.message)\n            .join(\"; \")}`,\n          { issues: validation.issues },\n        ),\n      };\n    }\n\n    return { value: validation.value };\n  }\n\n  /**\n   * Fire the receptionist (`ack`) — runs in parallel with phase A on\n   * iteration 0 only. Accepts three shapes:\n   *\n   * - `AckEntry` — `{ agent, placeholders?, input?, output? }`. LLM\n   *   form. Streams tokens via `supervisor.ack.streaming`; report\n   *   node pushes onto `childReports[]`.\n   * - `AckRunEntry` — `{ run, output? }`. Pure-code callback. Settles\n   *   without an LLM call. No streaming events; just `.completed`.\n   * - `AckCallback` — bare `(ctx) => slice` shorthand for the\n   *   pure-code form when no schema is declared.\n   *\n   * Failures are recorded but never abort the run — the receptionist\n   * tripping doesn't stop the specialist from doing the actual job.\n   * The returned outcome is what `mergeAckIntoState` consumes.\n   */\n  private async runAck(): Promise<\n    | {\n        output: unknown;\n        usage: Usage;\n        duration: number;\n        error?: AIError;\n      }\n    | undefined\n  > {\n    const ack = this.config.ack;\n    if (!ack) return undefined;\n\n    const routeContext: RouteContext = {\n      iteration: this.iteration,\n      input: this.input,\n      state: this.state,\n      iterations: this.snapshots,\n      feedback:\n        typeof this.carriedFeedback?.feedback === \"string\"\n          ? this.carriedFeedback.feedback\n          : undefined,\n      evaluateFeedback: this.carriedFeedback,\n      context: this.context,\n      history: this.history,\n      goal: this.goal,\n      classifier: this.classifierSnapshot,\n    };\n\n    const startedAt = new Date();\n    const startPerf = performance.now();\n\n    // Bare-callback shorthand: `ack: (ctx) => slice`.\n    if (typeof ack === \"function\") {\n      return this.runAckCallback(\n        ack as (ctx: RouteContext) => unknown | Promise<unknown>,\n        undefined,\n        routeContext,\n        startedAt,\n        startPerf,\n      );\n    }\n\n    // Run-entry form: `ack: { run, output? }`.\n    if (\"run\" in ack && typeof (ack as { run?: unknown }).run === \"function\") {\n      const runEntry = ack as {\n        run: (ctx: RouteContext) => unknown | Promise<unknown>;\n        output?: StandardSchemaV1<unknown>;\n      };\n      return this.runAckCallback(runEntry.run, runEntry.output, routeContext, startedAt, startPerf);\n    }\n\n    // Agent-entry form: `ack: { agent, placeholders?, input?, output? }`.\n    return this.runAckAgent(\n      ack as {\n        agent: import(\"../contracts/agent/agent.contract\").AgentContract<unknown>;\n        placeholders?: (ctx: RouteContext) => Record<string, unknown>;\n        input?: (ctx: RouteContext) => string;\n        output?: StandardSchemaV1<unknown>;\n        history?: (ctx: RouteContext) => Message[] | ReadonlyArray<Message>;\n      },\n      routeContext,\n      startedAt,\n      startPerf,\n    );\n  }\n\n  /**\n   * Pure-code receptionist path — invokes the callback, strip-validates\n   * the return value (when an `output` schema is declared), records the\n   * snapshot, emits `supervisor.ack.completed`, returns the outcome.\n   * No streaming events fire (callbacks settle synchronously from the\n   * supervisor's POV).\n   */\n  private async runAckCallback(\n    run: (ctx: RouteContext) => unknown | Promise<unknown>,\n    output: StandardSchemaV1<unknown> | undefined,\n    routeContext: RouteContext,\n    startedAt: Date,\n    startPerf: number,\n  ): Promise<{\n    output: unknown;\n    usage: Usage;\n    duration: number;\n    error?: AIError;\n  }> {\n    const usage: Usage = { input: 0, output: 0, total: 0 };\n    let validatedOutput: unknown;\n    let ackError: AIError | undefined;\n\n    try {\n      const raw = await run(routeContext);\n\n      if (output) {\n        const validation = await output[\"~standard\"].validate(raw);\n        if (validation.issues) {\n          ackError = new SchemaValidationError(\n            `ack output failed validation: ${validation.issues\n              .map((issue) => issue.message)\n              .join(\"; \")}`,\n            { issues: validation.issues },\n          );\n        } else {\n          validatedOutput = validation.value;\n        }\n      } else {\n        validatedOutput = raw;\n      }\n    } catch (thrown) {\n      ackError = toAIError(thrown);\n    }\n\n    const endedAt = new Date();\n    const duration = performance.now() - startPerf;\n\n    this.ackSnapshot = Object.freeze({\n      input: typeof this.input === \"string\" ? this.input : safeStringify(this.input),\n      output: validatedOutput,\n      usage,\n      startedAt: startedAt.toISOString(),\n      endedAt: endedAt.toISOString(),\n      duration,\n      error: ackError,\n    });\n\n    this.emit(\"supervisor.ack.completed\", {\n      output: validatedOutput,\n      usage,\n      duration,\n      error: ackError,\n    });\n\n    return { output: validatedOutput, usage, duration, error: ackError };\n  }\n\n  /**\n   * Agent-driven receptionist path — invokes the agent, streams tokens\n   * via `supervisor.ack.streaming`, captures the report node, strip-\n   * validates against `output` (when declared), records the snapshot,\n   * emits `supervisor.ack.completed`.\n   */\n  private async runAckAgent(\n    ack: {\n      agent: import(\"../contracts/agent/agent.contract\").AgentContract<unknown>;\n      placeholders?: (ctx: RouteContext) => Record<string, unknown>;\n      input?: (ctx: RouteContext) => string;\n      output?: StandardSchemaV1<unknown>;\n      history?: (ctx: RouteContext) => Message[] | ReadonlyArray<Message>;\n    },\n    routeContext: RouteContext,\n    startedAt: Date,\n    startPerf: number,\n  ): Promise<{\n    output: unknown;\n    usage: Usage;\n    duration: number;\n    error?: AIError;\n  }> {\n    const placeholders = ack.placeholders?.(routeContext);\n    const inputForAck =\n      ack.input?.(routeContext) ??\n      (typeof this.input === \"string\" ? this.input : safeStringify(this.input));\n\n    const isStreaming = this.streamController !== undefined;\n\n    const handlers = {\n      \"agent.trip.streaming\": ({ delta }: { delta: string }) => {\n        this.emit(\"supervisor.ack.streaming\", { delta });\n      },\n    };\n\n    const resolvedHistory = this.resolveHistoryFor(\"ack\", routeContext, ack.history);\n    const agentOptions = {\n      signal: this.options?.signal,\n      on: handlers,\n      ...(placeholders ? { placeholders } : {}),\n      ...(ack.output ? { output: ack.output } : {}),\n      ...(resolvedHistory.length > 0 ? { history: resolvedHistory } : {}),\n    };\n\n    let rawResult: AgentResult<unknown> | undefined;\n    let ackError: AIError | undefined;\n    let usage: Usage = { input: 0, output: 0, total: 0 };\n\n    try {\n      if (isStreaming) {\n        const childStream = ack.agent.stream(inputForAck, agentOptions);\n        rawResult = await childStream.result;\n      } else {\n        rawResult = await ack.agent.execute(inputForAck, agentOptions);\n      }\n\n      if (rawResult.error) {\n        ackError = rawResult.error;\n      }\n\n      usage = rawResult.usage ?? usage;\n\n      // Ack agent's report node in the supervisor's recursive tree.\n      if (rawResult.report) {\n        this.childReports.push(rawResult.report);\n      }\n    } catch (thrown) {\n      ackError = toAIError(thrown);\n    }\n\n    const endedAt = new Date();\n    const duration = performance.now() - startPerf;\n\n    // Strip-validate against `ack.output` (when declared) — same\n    // contract as per-intent output schemas.\n    let validatedOutput: unknown;\n    if (rawResult && !ackError && ack.output) {\n      const sourceValue = rawResult.data ?? rawResult.text ?? undefined;\n      const validation = await ack.output[\"~standard\"].validate(sourceValue);\n      if (validation.issues) {\n        ackError = new SchemaValidationError(\n          `ack output failed validation: ${validation.issues\n            .map((issue) => issue.message)\n            .join(\"; \")}`,\n          { issues: validation.issues },\n        );\n      } else {\n        validatedOutput = validation.value;\n      }\n    } else if (rawResult && !ackError) {\n      validatedOutput = rawResult.data ?? rawResult.text ?? undefined;\n    }\n\n    this.ackSnapshot = Object.freeze({\n      input: inputForAck,\n      output: validatedOutput,\n      usage,\n      startedAt: startedAt.toISOString(),\n      endedAt: endedAt.toISOString(),\n      duration,\n      error: ackError,\n    });\n\n    this.emit(\"supervisor.ack.completed\", {\n      output: validatedOutput,\n      usage,\n      duration,\n      error: ackError,\n    });\n\n    return { output: validatedOutput, usage, duration, error: ackError };\n  }\n\n  /**\n   * Probe the ack promise non-blockingly. Yields one macrotask cycle\n   * (`setImmediate`) so an already-resolved ack wins via microtask\n   * priority; if the probe returns first, the slice is abandoned —\n   * warning logged, error captured on `report.ack`, run completes\n   * regardless. Specialists own the actual answer; the receptionist\n   * was just a reassuring preview.\n   */\n  private async settleAck(\n    ackPromise:\n      | Promise<{ output: unknown; usage: Usage; duration: number; error?: AIError } | undefined>\n      | undefined,\n    iterationUsage: Usage,\n  ): Promise<void> {\n    if (!ackPromise) return;\n\n    const NOT_READY = Symbol(\"ack-not-ready\");\n    const probe = await Promise.race([\n      ackPromise,\n      new Promise<typeof NOT_READY>((resolve) => setTimeout(() => resolve(NOT_READY), 0)),\n    ]);\n\n    if (probe === NOT_READY) {\n      this.logger.warn(\n        this.logModule,\n        \"ack.abandoned\",\n        \"ack receptionist did not settle before iteration completed; slice dropped\",\n      );\n      const abandonedAt = new Date();\n      this.ackSnapshot = Object.freeze({\n        input: typeof this.input === \"string\" ? this.input : safeStringify(this.input),\n        output: undefined,\n        usage: { input: 0, output: 0, total: 0 },\n        startedAt: abandonedAt.toISOString(),\n        endedAt: abandonedAt.toISOString(),\n        duration: 0,\n        error: new SupervisorFailedError(\n          \"ack receptionist did not settle before iteration completed\",\n          { context: { ackAbandoned: true } },\n        ),\n      });\n      return;\n    }\n\n    const ackOutcome = probe;\n    if (ackOutcome) {\n      this.aggregateUsage(iterationUsage, ackOutcome.usage);\n      this.mergeAckIntoState(ackOutcome);\n    }\n  }\n\n  /**\n   * Merge the receptionist's strip-validated slice into state. Called\n   * from `settleAck` BEFORE branch merges so specialists override the\n   * receptionist on key collision — the receptionist hedges, the\n   * specialist commits.\n   */\n  private mergeAckIntoState(ackOutcome: { output: unknown; error?: AIError }): void {\n    if (ackOutcome.error || !ackOutcome.output) return;\n\n    if (typeof ackOutcome.output !== \"object\" || ackOutcome.output === null) return;\n\n    const slice = ackOutcome.output as Record<string, unknown>;\n\n    for (const [key, value] of Object.entries(slice)) {\n      this.state[key] = value;\n    }\n  }\n\n  /**\n   * Run the iter-0 classifier prelude (Phase 7 / decisions §37).\n   * Resolves the configured classifier (agent / callback / entry\n   * form), invokes it, runs the optional `refine` post-process hook,\n   * and either:\n   *\n   *   - sets `carriedClassifierDispatch` so the upcoming\n   *     `decideDispatch` short-circuits to the chosen intent, OR\n   *   - sets `classifierHalted = true` so `runIteration` terminates\n   *     before any dispatch (refine returned `END`).\n   *\n   * Captures the full forensic record on `classifierSnapshot` —\n   * surfaced on `SupervisorReport.classifier` and threaded into\n   * `ctx.classifier` on every downstream context.\n   *\n   * Errors in the classifier OR the refine hook abort the run with\n   * a `SupervisorFailedError` so issues surface loudly instead of\n   * silently falling through to router/route.\n   */\n  private async runClassifier(): Promise<void> {\n    const startedAt = new Date();\n    const startPerf = performance.now();\n    const startedAtIso = startedAt.toISOString();\n\n    this.emit(\"supervisor.classifier.starting\", { iteration: 0 });\n\n    const ctx = this.buildClassifierContext();\n    const config = this.config.classifier as ClassifierConfig;\n\n    let raw: ClassifierOutput | undefined;\n    let usage: Usage = { input: 0, output: 0, total: 0 };\n    let executionError: AIError | undefined;\n\n    try {\n      const outcome = await this.invokeClassifier(config, ctx);\n      raw = outcome.output;\n      usage = outcome.usage;\n    } catch (thrown) {\n      executionError = toAIError(thrown);\n    }\n\n    if (executionError || !raw) {\n      const error =\n        executionError ??\n        new SupervisorFailedError(\n          `ai.supervisor(\"${this.config.name}\"): classifier produced no output`,\n          { context: { iteration: 0 } },\n        );\n\n      this.classifierSnapshot = {\n        intent: undefined,\n        refined: false,\n        halted: true,\n        raw: raw ?? { intent: \"\" },\n        startedAt: startedAtIso,\n        endedAt: new Date().toISOString(),\n        duration: performance.now() - startPerf,\n        usage,\n        error,\n      };\n\n      this.aggregateUsage(this.usage, usage);\n\n      this.emit(\"supervisor.classifier.failed\", { error });\n\n      // Classifier failure aborts the run — no fallback to router/route.\n      // Phase 7 / decisions §37.\n      throw error;\n    }\n\n    // Validate the classifier's chosen intent against the registry\n    // before running refine — refine may override, but we still want\n    // to fail fast on raw classifier output that targets nothing.\n    if (!this.entries.has(raw.intent)) {\n      const error = new SupervisorFailedError(\n        `ai.supervisor(\"${this.config.name}\"): classifier picked unknown intent \"${raw.intent}\" — must be a key in \\`intents\\``,\n        { context: { iteration: 0, available: [...this.entries.keys()] } },\n        \"SUPERVISOR_INVALID_ROUTE\",\n      );\n\n      this.classifierSnapshot = {\n        intent: undefined,\n        refined: false,\n        halted: true,\n        raw,\n        startedAt: startedAtIso,\n        endedAt: new Date().toISOString(),\n        duration: performance.now() - startPerf,\n        usage,\n        error,\n      };\n\n      this.aggregateUsage(this.usage, usage);\n\n      this.emit(\"supervisor.classifier.failed\", { error });\n\n      throw error;\n    }\n\n    // Refine pass — optional. Refine receives the classifier output\n    // on `ctx.result.data` plus `run` / `stream` for inline secondary\n    // classifiers. Returns: undefined (use as-is) | END (halt) |\n    // { intent?, ...slice } (override + merge).\n    const refineHook = this.resolveRefineHook(config);\n    let final: ClassifierOutput = raw;\n    let refined = false;\n    let halted = false;\n\n    if (refineHook) {\n      let refineResult: ClassifierRefineResult;\n\n      try {\n        refineResult = await refineHook(this.buildClassifierRefineContext(ctx, raw));\n      } catch (thrown) {\n        const error = toAIError(thrown);\n\n        this.classifierSnapshot = {\n          intent: undefined,\n          refined: false,\n          halted: true,\n          raw,\n          startedAt: startedAtIso,\n          endedAt: new Date().toISOString(),\n          duration: performance.now() - startPerf,\n          usage,\n          error,\n        };\n\n        this.aggregateUsage(this.usage, usage);\n\n        this.emit(\"supervisor.classifier.failed\", { error });\n\n        throw error;\n      }\n\n      const interpretation = this.interpretRefineResult(refineResult, raw);\n\n      if (interpretation.error) {\n        this.classifierSnapshot = {\n          intent: undefined,\n          refined: true,\n          halted: true,\n          raw,\n          startedAt: startedAtIso,\n          endedAt: new Date().toISOString(),\n          duration: performance.now() - startPerf,\n          usage,\n          error: interpretation.error,\n        };\n\n        this.aggregateUsage(this.usage, usage);\n\n        this.emit(\"supervisor.classifier.failed\", { error: interpretation.error });\n\n        throw interpretation.error;\n      }\n\n      refined = interpretation.refined;\n      halted = interpretation.halted;\n      final = interpretation.final ?? raw;\n\n      // Merge refine's slice into state BEFORE dispatching — refine\n      // can augment state (e.g. detected language) regardless of\n      // override-vs-keep decision.\n      if (interpretation.sliceToMerge) {\n        for (const [key, value] of Object.entries(interpretation.sliceToMerge)) {\n          this.state[key] = value;\n        }\n      }\n    }\n\n    // Always merge the (possibly refined) classifier output's\n    // remaining fields into state — universal locked fields (intent,\n    // reasoning, confidence) plus any dev-extended fields. Subject\n    // to the supervisor's `output` schema validation at finalize.\n    for (const [key, value] of Object.entries(final)) {\n      this.state[key] = value;\n    }\n\n    this.classifierSnapshot = {\n      intent: halted ? undefined : final.intent,\n      reasoning: final.reasoning,\n      confidence: final.confidence,\n      refined,\n      halted,\n      raw,\n      startedAt: startedAtIso,\n      endedAt: new Date().toISOString(),\n      duration: performance.now() - startPerf,\n      usage,\n    };\n\n    this.aggregateUsage(this.usage, usage);\n\n    this.emit(\"supervisor.classifier.completed\", {\n      output: {\n        intent: this.classifierSnapshot.intent,\n        reasoning: this.classifierSnapshot.reasoning,\n        confidence: this.classifierSnapshot.confidence,\n      },\n      intent: this.classifierSnapshot.intent,\n      refined,\n      halted,\n      duration: this.classifierSnapshot.duration,\n      usage,\n    });\n\n    if (halted) {\n      this.classifierHalted = true;\n\n      return;\n    }\n\n    // Validate the FINAL intent against the registry — refine may\n    // have overridden to an unknown name. Throw loudly.\n    if (!this.entries.has(final.intent)) {\n      const error = new SupervisorFailedError(\n        `ai.supervisor(\"${this.config.name}\"): classifier.refine returned unknown intent \"${final.intent}\" — must be a key in \\`intents\\``,\n        { context: { iteration: 0, available: [...this.entries.keys()] } },\n        \"SUPERVISOR_INVALID_ROUTE\",\n      );\n\n      this.classifierSnapshot = { ...this.classifierSnapshot, halted: true, error };\n      this.classifierHalted = true;\n\n      this.emit(\"supervisor.classifier.failed\", { error });\n\n      throw error;\n    }\n\n    this.carriedClassifierDispatch = { intent: final.intent };\n  }\n\n  /**\n   * Resolve the configured classifier into a callable that returns\n   * `{ output, usage }`. Handles the four accepted shapes — bare\n   * agent / bare callback / agent-entry / run-entry. Pure shape\n   * normalization; no side effects.\n   */\n  private async invokeClassifier(\n    config: ClassifierConfig,\n    ctx: ClassifierContext,\n  ): Promise<{ output: ClassifierOutput; usage: Usage }> {\n    // (a) Bare callback shorthand.\n    if (typeof config === \"function\") {\n      const output = await (\n        config as (ctx: ClassifierContext) => Promise<ClassifierOutput> | ClassifierOutput\n      )(ctx);\n\n      return { output, usage: { input: 0, output: 0, total: 0 } };\n    }\n\n    // (b) Run-entry — `{ run, refine? }`.\n    if (typeof (config as { run?: unknown }).run === \"function\") {\n      const runFn = (\n        config as { run: (ctx: ClassifierContext) => Promise<ClassifierOutput> | ClassifierOutput }\n      ).run;\n      const output = await runFn(ctx);\n\n      return { output, usage: { input: 0, output: 0, total: 0 } };\n    }\n\n    // (c) Agent-entry — `{ agent, placeholders?, input?, history?, refine? }`.\n    if (typeof (config as { agent?: { execute?: unknown } }).agent?.execute === \"function\") {\n      const entry = config as {\n        agent: AgentContract<unknown>;\n        placeholders?: (ctx: ClassifierContext) => Record<string, unknown>;\n        input?: (ctx: ClassifierContext) => string;\n        history?: (ctx: ClassifierContext) => Message[] | ReadonlyArray<Message>;\n      };\n\n      return this.invokeClassifierAgent(\n        entry.agent,\n        ctx,\n        entry.placeholders,\n        entry.input,\n        entry.history,\n      );\n    }\n\n    // (d) Bare agent shorthand.\n    if (typeof (config as { execute?: unknown }).execute === \"function\") {\n      return this.invokeClassifierAgent(config as AgentContract<unknown>, ctx);\n    }\n\n    throw new SupervisorFailedError(\n      `ai.supervisor(\"${this.config.name}\"): \\`classifier\\` is not an agent, callback, or entry object`,\n      { context: { authoring: true } },\n    );\n  }\n\n  /**\n   * Invoke a classifier agent with the supervisor's standard wiring\n   * — placeholders, input override, history slicing, signal,\n   * streaming bubble. Output schema validation belongs to the agent\n   * itself; we just pull the typed `data` (or fall back to parsing\n   * `text`) and assert the locked `intent` field.\n   */\n  private async invokeClassifierAgent(\n    agent: AgentContract<unknown>,\n    ctx: ClassifierContext,\n    placeholders?: (ctx: ClassifierContext) => Record<string, unknown>,\n    inputResolver?: (ctx: ClassifierContext) => string,\n    historySlicer?: (ctx: ClassifierContext) => Message[] | ReadonlyArray<Message>,\n  ): Promise<{ output: ClassifierOutput; usage: Usage }> {\n    const inputForAgent =\n      inputResolver?.(ctx) ??\n      (typeof ctx.input === \"string\" ? ctx.input : safeStringify(ctx.input));\n\n    const history = historySlicer ? [...historySlicer(ctx)] : this.applyAgentsWindow();\n\n    const isStreaming = this.streamController !== undefined;\n\n    const handlers = {\n      \"agent.trip.streaming\": ({ delta }: { delta: string }) => {\n        this.emit(\"supervisor.classifier.streaming\", { delta });\n      },\n    };\n\n    const agentOptions = {\n      signal: this.options?.signal,\n      on: handlers,\n      ...(placeholders ? { placeholders: placeholders(ctx) } : {}),\n      ...(history.length > 0 ? { history } : {}),\n    };\n\n    let result: AgentResult<unknown>;\n\n    if (isStreaming) {\n      result = await agent.stream(inputForAgent, agentOptions).result;\n    } else {\n      result = await agent.execute(inputForAgent, agentOptions);\n    }\n\n    if (result.error) {\n      throw result.error;\n    }\n\n    if (result.report) {\n      this.childReports.push(result.report);\n    }\n\n    const data = result.data ?? result.text ?? undefined;\n    const output = this.coerceClassifierOutput(data);\n\n    return { output, usage: result.usage };\n  }\n\n  /**\n   * Coerce an agent's output into the locked classifier shape.\n   * Accepts a typed object with `intent` (the canonical case) or a\n   * plain string (interpreted as the intent name with no reasoning).\n   * Throws `SupervisorFailedError` if neither shape matches.\n   */\n  private coerceClassifierOutput(data: unknown): ClassifierOutput {\n    if (typeof data === \"string\") {\n      return { intent: data };\n    }\n\n    if (\n      data &&\n      typeof data === \"object\" &&\n      typeof (data as { intent?: unknown }).intent === \"string\"\n    ) {\n      const record = data as Record<string, unknown>;\n\n      return {\n        intent: record.intent as string,\n        reasoning: typeof record.reasoning === \"string\" ? (record.reasoning as string) : undefined,\n        confidence:\n          typeof record.confidence === \"number\" ? (record.confidence as number) : undefined,\n      };\n    }\n\n    throw new SupervisorFailedError(\n      `ai.supervisor(\"${this.config.name}\"): classifier output missing required \\`intent\\` field — got ${JSON.stringify(data)?.slice(0, 200)}`,\n      { context: { iteration: 0 } },\n    );\n  }\n\n  /**\n   * Build the read-only context passed to a classifier callback / agent\n   * resolvers. No dispatch helpers — registered intents haven't fired\n   * yet; pre-running them from the classifier would be confusing.\n   */\n  private buildClassifierContext(): ClassifierContext {\n    return {\n      iteration: 0,\n      input: this.input,\n      state: this.state,\n      context: this.context,\n      history: this.history,\n      signal: this.options?.signal ?? new AbortController().signal,\n      goal: this.goal,\n    };\n  }\n\n  /**\n   * Build the refine context — extends ClassifierContext with the\n   * classifier's just-resolved output plus `run` / `stream` so the\n   * refine hook can spin up secondary classifiers / validators\n   * inline (Phase 6 features).\n   */\n  private buildClassifierRefineContext(\n    base: ClassifierContext,\n    raw: ClassifierOutput,\n  ): ClassifierRefineContext {\n    const callStack = new Set<string>();\n    const reportSink = this.childReports;\n\n    return {\n      ...base,\n      result: { data: raw },\n      run: (executable, runInput, runOptions) =>\n        this.runInline(executable, runInput, runOptions, callStack, reportSink),\n      stream: (executable, runInput, runOptions) =>\n        this.streamInline(executable, runInput, runOptions, callStack, reportSink, \"classifier\"),\n    };\n  }\n\n  /**\n   * Pull the optional `refine` hook off whichever classifier-config\n   * shape was supplied. Bare-callback and bare-agent forms have no\n   * refine; only entry forms do.\n   */\n  private resolveRefineHook(\n    config: ClassifierConfig,\n  ):\n    | ((ctx: ClassifierRefineContext) => Promise<ClassifierRefineResult> | ClassifierRefineResult)\n    | undefined {\n    if (typeof config === \"function\") {\n      return undefined;\n    }\n\n    const refine = (config as { refine?: unknown }).refine;\n\n    return typeof refine === \"function\"\n      ? (refine as (\n          ctx: ClassifierRefineContext,\n        ) => Promise<ClassifierRefineResult> | ClassifierRefineResult)\n      : undefined;\n  }\n\n  /**\n   * Interpret a refine return value into actionable bits — final\n   * classifier output to dispatch, slice-to-merge, halted/refined\n   * flags, or an error. See {@link ClassifierRefineResult} for the\n   * accepted shapes.\n   */\n  private interpretRefineResult(\n    refineResult: ClassifierRefineResult,\n    raw: ClassifierOutput,\n  ): {\n    final?: ClassifierOutput;\n    sliceToMerge?: Record<string, unknown>;\n    refined: boolean;\n    halted: boolean;\n    error?: AIError;\n  } {\n    if (refineResult === undefined) {\n      return { final: raw, refined: false, halted: false };\n    }\n\n    if (refineResult === END) {\n      return { refined: true, halted: true };\n    }\n\n    if (typeof refineResult !== \"object\" || refineResult === null) {\n      return {\n        refined: false,\n        halted: true,\n        error: new SupervisorFailedError(\n          `ai.supervisor(\"${this.config.name}\"): classifier.refine returned an unsupported value — expected undefined, END, or an object`,\n          { context: { iteration: 0 } },\n        ),\n      };\n    }\n\n    const record = refineResult as Record<string, unknown>;\n    const intentField = record.intent;\n    const halted = intentField === END;\n    const intentOverride = typeof intentField === \"string\" ? intentField : undefined;\n\n    // Slice-to-merge is the refine return MINUS the `intent` field\n    // (which is dispatch metadata, not state contribution).\n    const slice: Record<string, unknown> = {};\n\n    for (const [key, value] of Object.entries(record)) {\n      if (key === \"intent\") continue;\n\n      slice[key] = value;\n    }\n\n    const final: ClassifierOutput = {\n      ...raw,\n      ...(intentOverride ? { intent: intentOverride } : {}),\n    };\n\n    return {\n      final: halted ? undefined : final,\n      sliceToMerge: Object.keys(slice).length > 0 ? slice : undefined,\n      refined: true,\n      halted,\n    };\n  }\n\n  /**\n   * Run the `evaluate` callback (when configured) after the\n   * iteration's branches settle and outputs have merged into state.\n   * Errors in the callback surface as `SupervisorFailedError` so a\n   * buggy evaluate doesn't silently swallow the whole run.\n   *\n   * Phase 3.4 (Stage 4b) — `EvaluateContext.state` carries the\n   * post-merge accumulator so verdicts can be state-aware. Q9\n   * lifted the router-only restriction; evaluate now runs in both\n   * router and route modes.\n   */\n  private async runEvaluate(branches: AgentBranchSnapshot[]): Promise<EvaluateResult> {\n    if (!this.config.evaluate) {\n      return undefined;\n    }\n\n    const evaluateContext: EvaluateContext = {\n      iteration: this.iteration,\n      input: this.input,\n      state: this.state,\n      result: indexBranchesForEvaluate(branches),\n      iterations: this.snapshots,\n      context: this.context,\n      history: this.history,\n      goal: this.goal,\n      classifier: this.classifierSnapshot,\n    };\n\n    try {\n      return await (\n        this.config.evaluate as (ctx: EvaluateContext) => EvaluateResult | Promise<EvaluateResult>\n      )(evaluateContext);\n    } catch (thrown) {\n      const message = thrown instanceof Error ? thrown.message : String(thrown);\n\n      throw new SupervisorFailedError(`evaluate callback threw: ${message}`, {\n        cause: thrown,\n      });\n    }\n  }\n\n  /**\n   * Merge each branch's output into supervisor `state` in\n   * `decision.intents` order — Q15 conflict rule: last intent in\n   * the array wins on key collisions. Errored branches don't\n   * contribute. Non-object outputs (primitives, null) are skipped\n   * with a warning log; they can't shallow-merge into an object.\n   *\n   * For agent/workflow intents: merging is opt-in via declaring an\n   * `output` schema (the strip-merge gate). Without a schema, the\n   * raw output stays on the branch snapshot but doesn't pollute\n   * state. For callback intents: their return is already strip-merged\n   * (or pass-through) inside `runCallback` — we just merge what's on\n   * the branch snapshot.\n   */\n  private mergeBranchesIntoState(intentsOrder: string[], branches: AgentBranchSnapshot[]): void {\n    const indexed = new Map<string, AgentBranchSnapshot>();\n    for (const branch of branches) {\n      indexed.set(branch.intent, branch);\n    }\n\n    const mergedKeys = new Map<string, string>();\n\n    for (const intent of intentsOrder) {\n      const branch = indexed.get(intent);\n      if (!branch || branch.error) continue;\n\n      const entry = this.entries.get(intent);\n\n      // For agent/workflow intents, only merge when the slice schema\n      // was declared (output present on the entry). For callbacks,\n      // their output is always merged (the schema, if any, was\n      // applied inside runCallback). Stream-mode agents (Phase 5 /\n      // decisions §34) merge unconditionally — `applyOutputSchema`\n      // already shaped their slice as `{ [streamTo]: text }`, and\n      // they have no `output` schema by construction.\n      const isStreamModeAgent = entry?.type === \"agent\" && entry.mode === \"stream\";\n      const shouldMerge =\n        entry?.type === \"callback\" || (entry && entry.output !== undefined) || isStreamModeAgent;\n\n      if (!shouldMerge) continue;\n\n      const slice = branch.output;\n\n      if (!slice || typeof slice !== \"object\" || Array.isArray(slice)) {\n        if (slice !== undefined) {\n          this.logger.warn(\n            this.logModule,\n            \"state.merge.skip\",\n            `intent \"${intent}\" output is not a mergeable object — skipping state merge`,\n            { intent, type: typeof slice },\n          );\n        }\n        continue;\n      }\n\n      for (const [key, value] of Object.entries(slice as Record<string, unknown>)) {\n        const previousOwner = mergedKeys.get(key);\n        if (previousOwner !== undefined && previousOwner !== intent) {\n          this.logger.warn(\n            this.logModule,\n            \"state.merge.conflict\",\n            `state key \"${key}\" written by both \"${previousOwner}\" and \"${intent}\" — last-in-decision-array wins (Q15)`,\n            { key, previousOwner, currentIntent: intent },\n          );\n        }\n        this.state[key] = value;\n        mergedKeys.set(key, intent);\n      }\n    }\n  }\n\n  /**\n   * Merge the iteration's accumulated `currentArtifacts` bag into\n   * supervisor state (Phase 5 / decisions §35). Runs once per\n   * iteration after branch slices land and before evaluate.\n   *\n   * Order of operations:\n   *\n   * 1. **Empty-bag fast path** — if no tool wrote anything, skip\n   *    validation and merge entirely; reset the bag for the next\n   *    iteration is also a no-op (already empty).\n   * 2. **Schema validation** — when `config.artifactsSchema` is set,\n   *    validate the bag against it. Failure aborts the iteration via\n   *    a thrown `SchemaValidationError`; the iteration loop's outer\n   *    catch surfaces it on `result.error`. Validation is opt-in\n   *    (no schema → no validation cost).\n   * 3. **Merge** — `config.finalizeArtifacts` when supplied, else\n   *    auto-spread `state = { ...state, ...artifacts }`. Replace\n   *    semantics under auto-spread; `finalizeArtifacts` carries\n   *    full responsibility for concat / dedupe / cross-iteration\n   *    accumulation when configured.\n   * 4. **Reset** — `currentArtifacts = {}`. The next iteration's\n   *    tool calls start with a fresh empty bag; long runs never\n   *    accumulate raw artifacts here.\n   */\n  private async mergeArtifactsIntoState(): Promise<void> {\n    const artifacts = this.currentArtifacts;\n    const keys = Object.keys(artifacts);\n\n    // Phase 8 / decisions §38 — capture the raw bag BEFORE validation\n    // or merge so the iteration snapshot surfaces what the tools\n    // actually wrote, regardless of what `finalizeArtifacts` did with\n    // it. Frozen — consumers should never mutate forensic data.\n    // Always run, even on empty bags — snapshot builder reads\n    // `capturedIterationArtifacts` regardless.\n    this.capturedIterationArtifacts = Object.freeze({ ...artifacts });\n\n    if (keys.length === 0) {\n      return;\n    }\n\n    const schema = this.config.artifactsSchema;\n\n    if (schema) {\n      const validation = await schema[\"~standard\"].validate(artifacts);\n\n      if (validation.issues) {\n        throw new SchemaValidationError(\n          `supervisor \"${this.config.name}\": iteration ${this.iteration} artifacts failed validation: ${validation.issues\n            .map((issue) => issue.message)\n            .join(\"; \")}`,\n          { issues: validation.issues, context: { iteration: this.iteration } },\n        );\n      }\n    }\n\n    const finalize = this.config.finalizeArtifacts as\n      | ((\n          state: Record<string, unknown>,\n          artifacts: Record<string, unknown>,\n        ) => Record<string, unknown>)\n      | undefined;\n\n    if (finalize) {\n      const merged = finalize(this.state, artifacts);\n\n      // Mutate in place so external references to `this.state`\n      // (snapshot copies, evaluate ctx) stay coherent. Drop keys\n      // the finalize callback removed; overwrite the rest.\n      for (const key of Object.keys(this.state)) {\n        if (!(key in merged)) {\n          delete this.state[key];\n        }\n      }\n\n      for (const [key, value] of Object.entries(merged)) {\n        this.state[key] = value;\n      }\n    } else {\n      for (const [key, value] of Object.entries(artifacts)) {\n        this.state[key] = value;\n      }\n    }\n\n    this.currentArtifacts = {};\n  }\n\n  /**\n   * Collect each branch's `intent.next(ctx)` directive after state\n   * merge (Stage 4d / Q24). Iterates `decision.intents` order so\n   * union resolution is deterministic.\n   *\n   * Rules:\n   * - Errored branch → silent (treated as if no `next` defined).\n   * - Branch with no `next` → silent; abstains (does NOT drag the\n   *   iteration to the router).\n   * - Branch returns `END` → supreme; terminates immediately and\n   *   discards other branches' opinions.\n   * - Branch returns `string` or `string[]` → contributes to the\n   *   union of unique intent names. Validated against the\n   *   supervisor's registry; unknown keys throw `SupervisorFailedError`.\n   * - All branches silent → returns `undefined`; caller falls back\n   *   to router/route.\n   */\n  private collectIntentNext(\n    intentsOrder: string[],\n    branches: AgentBranchSnapshot[],\n  ): { kind: \"dispatch\"; intents: string[] } | { kind: \"end\" } | undefined {\n    const indexed = new Map<string, AgentBranchSnapshot>();\n    for (const branch of branches) {\n      indexed.set(branch.intent, branch);\n    }\n\n    const collected: string[] = [];\n    const seen = new Set<string>();\n    let anySilent = false;\n\n    for (const intent of intentsOrder) {\n      const branch = indexed.get(intent);\n      if (!branch || branch.error) {\n        anySilent = true;\n        continue;\n      }\n\n      const entry = this.entries.get(intent);\n      if (!entry?.next) {\n        anySilent = true;\n        continue;\n      }\n\n      // Build a per-branch DispatchContext for the resolver. Cycle\n      // stack is fresh-and-self-seeded so a `next` that calls\n      // `ctx.intents.X.execute()` reuses the per-iteration cycle\n      // detection mechanic.\n      const dispatchCtx = this.seedDispatchContext(\n        intent,\n        branch.input,\n        new Set<string>([intent]),\n        [],\n      );\n\n      let raw: string | string[] | typeof END | undefined;\n      try {\n        raw = entry.next(dispatchCtx) as string | string[] | typeof END | undefined;\n      } catch (thrown) {\n        const message = thrown instanceof Error ? thrown.message : String(thrown);\n        throw new SupervisorFailedError(`intent \"${intent}\" \\`next\\` resolver threw: ${message}`, {\n          cause: thrown,\n          context: { intent },\n        });\n      }\n\n      if (raw === undefined) {\n        anySilent = true;\n        continue;\n      }\n\n      if (raw === END) {\n        return { kind: \"end\" };\n      }\n\n      const proposed = Array.isArray(raw) ? raw : [raw];\n\n      for (const target of proposed) {\n        if (typeof target !== \"string\") {\n          throw new SupervisorFailedError(\n            `intent \"${intent}\" \\`next\\` returned a non-string value`,\n            { context: { intent } },\n          );\n        }\n\n        if (!this.entries.has(target)) {\n          throw new SupervisorFailedError(\n            `intent \"${intent}\" \\`next\\` returned unknown intent \"${target}\"`,\n            {\n              context: { intent, target, available: [...this.entries.keys()] },\n            },\n          );\n        }\n\n        if (!seen.has(target)) {\n          seen.add(target);\n          collected.push(target);\n        }\n      }\n    }\n\n    void anySilent;\n\n    if (collected.length === 0) {\n      // No branch directed the next iteration — fall back to router.\n      return undefined;\n    }\n\n    return { kind: \"dispatch\", intents: collected };\n  }\n\n  /**\n   * Finalize the supervisor result: validate accumulated state\n   * against the output schema and build the public `SupervisorResult`.\n   * Assemble-only — event emission and stream close happen in\n   * `run()` around this call.\n   */\n  private async finalize(): Promise<SupervisorResult<TOutput>> {\n    if (this.status === \"completed\" && !this.error) {\n      try {\n        this.data = await this.buildTypedData();\n      } catch (thrown) {\n        this.error = toAIError(thrown);\n        this.status = \"failed\";\n        this.terminatedBy = \"error\";\n      }\n    }\n\n    const endedAt = new Date();\n\n    // `max-iterations` and the orchestrator-only `awaiting-input` are\n    // members of the shared `ReportStatus` union but not of the narrower\n    // `SupervisorSnapshotStatus`. A supervisor never reaches\n    // `awaiting-input` at runtime; both collapse to the existing\n    // `failed` fallback here so the snapshot status stays representable.\n    const finalStatus: SupervisorSnapshotStatus =\n      this.status === \"max-iterations\" || this.status === \"awaiting-input\"\n        ? \"failed\"\n        : this.status;\n\n    await this.checkpoint(finalStatus);\n\n    const report: SupervisorReport = {\n      runId: this.runId,\n      rootRunId: this.runId,\n      name: this.config.name,\n      version: this.config.version,\n      type: \"supervisor\",\n      supervisorName: this.config.name,\n      signature: this.signature,\n      status: this.status,\n      terminatedBy: this.terminatedBy,\n      iterations: this.snapshots.length,\n      startedAt: this.startedAtIso,\n      endedAt: endedAt.toISOString(),\n      duration: performance.now() - this.startPerf,\n      cancelledAt: this.cancelledAtIso,\n      usage: this.usage,\n      children: this.childReports,\n      snapshots: this.snapshots,\n      ack: this.ackSnapshot,\n      classifier: this.classifierSnapshot,\n    };\n\n    // Stamp lineage on the assembled tree exactly once per run.\n    // Walker rewrites inner self-roots from every nested agent /\n    // workflow / callback report the supervisor absorbed, propagates\n    // sessionId, and writes `reportSchemaVersion` on the root.\n    stampReportLineage(report, {\n      rootRunId: this.runId,\n      sessionId: this.options?.sessionId,\n    });\n\n    return {\n      type: \"supervisor\",\n      data: this.data,\n      report,\n      usage: this.usage,\n      error: this.error,\n    };\n  }\n\n  /**\n   * Build the typed `data` at finalize. Stage 4c — single mode:\n   *\n   * - When `config.output` is declared, validate the accumulated\n   *   `state` against it and return the validated value (Q8).\n   *   `result.data` always matches the schema, or `result.error`\n   *   carries the validation issues.\n   * - When `config.output` is omitted, return the raw state object.\n   *\n   * Validation failure surfaces as `SchemaValidationError` on\n   * `result.error`; the run is still considered semantically\n   * \"completed\" (intents ran, evaluate said done) but the typed\n   * data slot is empty.\n   */\n  private async buildTypedData(): Promise<TOutput | undefined> {\n    if (this.config.output) {\n      return validateOutput<TOutput>(this.config.output, this.state as unknown);\n    }\n\n    return this.state as TOutput;\n  }\n\n  /**\n   * Record a snapshot for an iteration whose first decision was\n   * `END` — no dispatch, no evaluate, just the decision record. Keeps\n   * the snapshot log uniform so a late-route-to-END still appears in\n   * the forensic history rather than vanishing.\n   */\n  private async recordTerminalDecisionSnapshot(\n    decision: DispatchDecision & { kind: \"end\" },\n    iterationStartedAt: Date,\n    iterationStart: number,\n    iterationUsage: Usage,\n  ): Promise<void> {\n    const snapshot: IterationSnapshot = Object.freeze({\n      iteration: this.iteration,\n      result: {},\n      decision: {\n        source: decision.source,\n        next: decision.raw,\n        reasoning: decision.reasoning,\n        durationMs: decision.durationMs,\n      },\n      state: { ...this.state },\n      artifacts: this.capturedIterationArtifacts,\n      startedAt: iterationStartedAt.toISOString(),\n      endedAt: new Date().toISOString(),\n      duration: performance.now() - iterationStart,\n      usage: iterationUsage,\n    });\n\n    this.snapshots.push(snapshot);\n\n    this.emit(\"supervisor.iteration.completed\", {\n      iteration: this.iteration,\n      snapshot,\n    });\n\n    await this.checkpoint(\"running\");\n  }\n\n  /**\n   * Write the current run state to the configured KV store (if any).\n   * Persistence failures surface as `supervisor.error` events and\n   * logged warnings but never abort the run — checkpoint best-effort\n   * by design, matching `workflow` semantics.\n   */\n  private async checkpoint(status: SupervisorSnapshotStatus): Promise<void> {\n    const outcome = await persistSupervisorSnapshot({\n      config: this.config as SupervisorConfig<unknown>,\n      signature: this.signature,\n      runId: this.runId,\n      input: this.input,\n      startedAt: this.startedAtIso,\n      iteration: this.snapshots.length - 1,\n      snapshots: this.snapshots,\n      status,\n    });\n\n    if (!outcome.ok) {\n      this.logger.warn(this.logModule, \"persist.failed\", \"snapshot persist failed\", {\n        runId: this.runId,\n      });\n    }\n  }\n\n  /**\n   * Between-iteration cancellation check. Called at the top of\n   * every iteration; signal abort here means the loop exits before\n   * any routing happens.\n   */\n  private throwIfCancelled(): void {\n    if (this.options?.signal?.aborted) {\n      throw createCancelledError(this.options.signal);\n    }\n  }\n\n  /**\n   * Aggregate one usage record (typically a branch or a router call)\n   * into both the run-wide total and the iteration-local total.\n   */\n  private aggregateUsage(iterationUsage: Usage, partial?: Usage): void {\n    if (!partial) {\n      return;\n    }\n\n    this.usage.input += partial.input;\n    this.usage.output += partial.output;\n    this.usage.total += partial.total;\n\n    iterationUsage.input += partial.input;\n    iterationUsage.output += partial.output;\n    iterationUsage.total += partial.total;\n  }\n\n  /**\n   * Fan an event out through the three-tier emitter AND mirror it\n   * into the stream controller when streaming. Event names map 1:1\n   * to stream event types so consumers iterating the stream see the\n   * exact same surface as `.on()` / `options.on` handlers.\n   */\n  private emit<K extends keyof SupervisorEventMap>(\n    event: K,\n    payload: WithoutIdentity<SupervisorEventMap[K]>,\n  ): void {\n    // Inject run identity once, here, so the three-tier emitter, the\n    // structured log line, and the stream all see it. `rootRunId ===\n    // runId` for a standalone run; nested propagation is a follow-up.\n    const identity: EventIdentity = {\n      runId: this.runId,\n      rootRunId: this.runId,\n    };\n\n    const fullPayload = { ...payload, ...identity } as SupervisorEventMap[K];\n\n    this.emitter.emit(event, fullPayload, this.options?.on);\n    this.logEvent(event, fullPayload);\n\n    if (this.streamController) {\n      this.streamController.push({\n        type: event,\n        ...(fullPayload as object),\n      } as SupervisorStreamEvent);\n    }\n  }\n\n  private logEvent<K extends keyof import(\"../contracts/events/event-map.type\").SupervisorEventMap>(\n    event: K,\n    payload: import(\"../contracts/events/event-map.type\").SupervisorEventMap[K],\n  ): void {\n    const action = event.replace(/^supervisor\\./, \"\");\n\n    switch (event) {\n      case \"supervisor.starting\":\n        this.logger.info(this.logModule, action, \"supervisor starting\", {\n          runId: this.runId,\n        });\n        return;\n\n      case \"supervisor.iteration.starting\":\n        this.logger.debug(this.logModule, action, \"iteration starting\", {\n          iteration: (payload as { iteration: number }).iteration,\n        });\n        return;\n\n      case \"supervisor.router.decided\":\n        this.logger.debug(this.logModule, action, \"router decided\", {\n          iteration: (payload as { iteration: number }).iteration,\n          next: (payload as { next: unknown }).next,\n        });\n        return;\n\n      case \"supervisor.agent.completed\": {\n        const typed = payload as {\n          intent: string;\n          duration: number;\n          usage: Usage;\n        };\n        this.logger.success(this.logModule, action, `branch \"${typed.intent}\" done`, {\n          duration: typed.duration,\n          usage: typed.usage,\n        });\n        return;\n      }\n\n      case \"supervisor.agent.failed\": {\n        const typed = payload as { intent: string; error: AIError };\n        this.logger.warn(this.logModule, action, `branch \"${typed.intent}\" failed`, {\n          code: typed.error.code,\n          message: typed.error.message,\n        });\n        return;\n      }\n\n      case \"supervisor.error\": {\n        const { error } = payload as { error: AIError };\n        this.logger.error(this.logModule, action, error.message, {\n          code: error.code,\n        });\n        return;\n      }\n\n      case \"supervisor.cancelled\": {\n        const typed = payload as { cancelledAt: string; reason?: string };\n        this.logger.warn(this.logModule, action, \"supervisor cancelled\", {\n          cancelledAt: typed.cancelledAt,\n          reason: typed.reason,\n        });\n        return;\n      }\n\n      case \"supervisor.iteration.completed\":\n        this.logger.debug(this.logModule, action, \"iteration completed\", {\n          iteration: (payload as { iteration: number }).iteration,\n        });\n        return;\n\n      default:\n        // Streaming / per-branch starting events are high-volume — no\n        // dedicated log line.\n        return;\n    }\n  }\n}\n\nfunction indexByIntent(branches: AgentBranchSnapshot[]): Record<string, AgentBranchSnapshot> {\n  const indexed: Record<string, AgentBranchSnapshot> = {};\n\n  for (const branch of branches) {\n    indexed[branch.intent] = branch;\n  }\n\n  return indexed;\n}\n\nfunction indexBranchesForEvaluate(\n  branches: AgentBranchSnapshot[],\n): Record<string, EvaluateBranchResult> {\n  const indexed: Record<string, EvaluateBranchResult> = {};\n\n  for (const branch of branches) {\n    indexed[branch.intent] = {\n      output: branch.output,\n      input: branch.input,\n      usage: branch.usage,\n      durationMs: branch.duration,\n      error: branch.error,\n    };\n  }\n\n  return indexed;\n}\n\nfunction normalizeReassign(reassignTo: string | string[] | undefined): string[] {\n  if (!reassignTo) {\n    return [];\n  }\n\n  if (Array.isArray(reassignTo)) {\n    return reassignTo;\n  }\n\n  return [reassignTo];\n}\n\nfunction toAIError(thrown: unknown): AIError {\n  if (thrown instanceof AIError) {\n    return thrown;\n  }\n\n  const message = thrown instanceof Error ? thrown.message : String(thrown);\n\n  return new SupervisorFailedError(message, { cause: thrown });\n}\n\n/**\n * Sum a list of child `BaseReport.usage` values. Callbacks\n * themselves contribute zero own-cost (they're dev code, not LLM\n * calls); their report's `usage` equals the sum of whatever\n * agents / workflows / nested callbacks they dispatched via\n * `ctx.intents.X.execute()`. Mirrors `compositeAsTool` semantics.\n */\nfunction aggregateChildUsage(children: BaseReport[]): Usage {\n  return children.reduce<Usage>(\n    (acc, child) => ({\n      input: acc.input + child.usage.input,\n      output: acc.output + child.usage.output,\n      total: acc.total + child.usage.total,\n    }),\n    { input: 0, output: 0, total: 0 },\n  );\n}\n\n/**\n * Best-effort stringification for the snapshot's `input` field when\n * a callback intent's resolved input is a non-string value. Falls\n * back to a typed placeholder if `JSON.stringify` throws (circular\n * refs, BigInt, etc.) so a snapshot write never fails on its own.\n */\nfunction safeStringify(value: unknown): string {\n  if (value === undefined) {\n    return \"undefined\";\n  }\n\n  try {\n    return JSON.stringify(value);\n  } catch {\n    return `[unserializable: ${typeof value}]`;\n  }\n}\n\nasync function validateOutput<TOutput>(\n  schema: StandardSchemaV1<TOutput>,\n  value: unknown,\n): Promise<TOutput> {\n  const validation = await schema[\"~standard\"].validate(value);\n\n  if (validation.issues) {\n    throw new SchemaValidationError(validation.issues.map((issue) => issue.message).join(\"; \"), {\n      issues: validation.issues,\n    });\n  }\n\n  return validation.value;\n}\n","import { ClassifierAgentEntry, ClassifierRunEntry } from \"../contracts\";\nimport type { SupervisorConfig } from \"../contracts/supervisor/supervisor-config.type\";\nimport type { ResolvedIntentEntry } from \"./entries\";\n\n/**\n * Deterministic structural fingerprint of a supervisor definition.\n * Persisted on every snapshot so `resume()` can detect drift between\n * the saved run and the current definition. Covers:\n *\n * - Supervisor name.\n * - Every intent key + its resolved description + the underlying\n *   unit's stable identity (agent name, workflow name + signature,\n *   or `\"callback\"` marker for dev-callback intents).\n * - Router agent's name (if the supervisor uses LLM routing).\n * - Whether a deterministic `route` callback is configured (but not\n *   its contents — route callbacks are code, not data).\n * - Whether an `evaluate` callback is configured.\n * - `initialAgent` when set.\n * - `maxIterations` (a semantic shape change, not a cosmetic one).\n *\n * Does NOT cover: system prompt text, logger, store identity, per-\n * event handlers — all runtime knobs that don't change the shape of\n * a resumable run.\n */\nexport function computeSignature(\n  config: SupervisorConfig<unknown>,\n  entries: Map<string, ResolvedIntentEntry>,\n): string {\n  const intentsFingerprint = [...entries.entries()]\n    .sort(([a], [b]) => a.localeCompare(b))\n    .map(([intent, entry]) => ({\n      k: intent,\n      d: entry.description,\n      u: fingerprintUnit(entry),\n    }));\n\n  const fingerprint = {\n    n: config.name,\n    a: intentsFingerprint,\n    r: resolveRouterName(config.router),\n    rc: config.route ? 1 : 0,\n    e: config.evaluate ? 1 : 0,\n    i: config.initialAgent ?? null,\n    m: config.maxIterations ?? null,\n    // Phase 7 / decisions §37 — classifier is part of structural identity.\n    // Resume drift detection notices when the classifier swap changes\n    // routing semantics. Same fingerprint shape as router (agent name\n    // when applicable; \"callback\" marker for callback form).\n    c: resolveClassifierFingerprint(config.classifier),\n  };\n\n  return hash(JSON.stringify(fingerprint));\n}\n\nfunction resolveRouterName(router: SupervisorConfig<unknown>[\"router\"]): string | null {\n  if (!router) {\n    return null;\n  }\n\n  if (typeof (router as { execute?: unknown }).execute === \"function\") {\n    return (router as { name?: string }).name ?? null;\n  }\n\n  return (router as { agent?: { name?: string } }).agent?.name ?? null;\n}\n\nfunction resolveClassifierFingerprint(\n  classifier: SupervisorConfig<unknown>[\"classifier\"],\n): unknown {\n  if (!classifier) {\n    return null;\n  }\n\n  if (typeof classifier === \"function\") {\n    return { t: \"callback\" };\n  }\n\n  if (typeof (classifier as { execute?: unknown }).execute === \"function\") {\n    return { t: \"agent\", n: (classifier as { name?: string }).name ?? null };\n  }\n\n  if (typeof (classifier as ClassifierRunEntry).run === \"function\") {\n    return { t: \"callback\" };\n  }\n\n  if (typeof (classifier as ClassifierAgentEntry).agent?.execute === \"function\") {\n    return {\n      t: \"agent\",\n      n: (classifier as ClassifierAgentEntry).agent?.name ?? null,\n    };\n  }\n\n  return { t: \"unknown\" };\n}\n\nfunction fingerprintUnit(entry: ResolvedIntentEntry): unknown {\n  if (entry.type === \"callback\") {\n    // Callbacks are dev code — fingerprint the type + intent name\n    // only (the closure itself can't be hashed deterministically).\n    // Drift detection covers add/remove/rename of callback intents,\n    // not edits to the function body. Same trade-off as `route`.\n    return { t: \"callback\" };\n  }\n\n  if (entry.type === \"workflow\") {\n    const workflow = entry.unit;\n    return { t: \"workflow\", n: workflow.name, s: workflow.signature };\n  }\n\n  return { t: \"agent\", n: entry.unit.name };\n}\n\n/**\n * FNV-1a 32-bit — same hash `workflow/signature.ts` uses. Deterministic,\n * no crypto dependency, cheap; signatures are 8-char hex.\n */\nfunction hash(input: string): string {\n  let h = 0x811c9dc5;\n\n  for (let i = 0; i < input.length; i++) {\n    h ^= input.charCodeAt(i);\n    h = (h + ((h << 1) + (h << 4) + (h << 7) + (h << 8) + (h << 24))) >>> 0;\n  }\n\n  return h.toString(16).padStart(8, \"0\");\n}\n","import type { StreamContract } from \"../contracts/stream/stream.contract\";\nimport type { SupervisorStreamEvent } from \"../contracts/supervisor/supervisor-stream-event.type\";\n\n// Re-export so internal callers that already imported from this file\n// keep working unchanged. Canonical home is the contracts barrel.\nexport type { SupervisorStreamEvent };\n\n/**\n * Internal async-queue controller driving `supervisor.stream()`.\n * Mirrors `StreamController` from `agent-stream.ts` — same\n * producer/consumer pipe, same semantics, parameterized by the\n * supervisor event union and terminal result type.\n */\nexport type SupervisorStreamController<TResult> = {\n  push(event: SupervisorStreamEvent): void;\n  end(result: TResult): void;\n  fail(error: Error): void;\n};\n\ntype PendingRead = {\n  resolve(value: IteratorResult<SupervisorStreamEvent>): void;\n  reject(error: Error): void;\n};\n\n/**\n * Factory mirroring `createAgentStream`. Returns a paired\n * `{ controller, stream }` — the `SupervisorExecution` pushes events\n * into the controller while the caller iterates (or awaits `.result`)\n * on the stream side. See `agent-stream.ts` for the full role\n * description.\n */\nexport function createSupervisorStream<TResult>(): {\n  controller: SupervisorStreamController<TResult>;\n  stream: StreamContract<TResult, SupervisorStreamEvent>;\n} {\n  const queue: SupervisorStreamEvent[] = [];\n  const pending: PendingRead[] = [];\n  const handlers = new Map<string, (event: SupervisorStreamEvent) => void>();\n\n  let closed = false;\n  let failure: Error | undefined;\n  let resolveResult!: (value: TResult) => void;\n  let rejectResult!: (error: Error) => void;\n\n  const result = new Promise<TResult>((resolve, reject) => {\n    resolveResult = resolve;\n    rejectResult = reject;\n  });\n\n  const controller: SupervisorStreamController<TResult> = {\n    push(event) {\n      const handler = handlers.get(event.type);\n\n      if (handler) {\n        try {\n          handler(event);\n        } catch {\n          // Stream handlers must never crash the supervisor.\n        }\n      }\n\n      const reader = pending.shift();\n\n      if (reader) {\n        reader.resolve({ value: event, done: false });\n        return;\n      }\n\n      queue.push(event);\n    },\n\n    end(finalResult) {\n      closed = true;\n      resolveResult(finalResult);\n\n      while (pending.length > 0) {\n        pending.shift()?.resolve({ value: undefined, done: true });\n      }\n    },\n\n    fail(error) {\n      closed = true;\n      failure = error;\n      rejectResult(error);\n\n      while (pending.length > 0) {\n        pending.shift()?.reject(error);\n      }\n    },\n  };\n\n  const iterator: AsyncIterator<SupervisorStreamEvent> = {\n    next() {\n      if (queue.length > 0) {\n        return Promise.resolve({ value: queue.shift()!, done: false });\n      }\n\n      if (closed) {\n        if (failure) {\n          return Promise.reject(failure);\n        }\n\n        return Promise.resolve({ value: undefined, done: true });\n      }\n\n      return new Promise<IteratorResult<SupervisorStreamEvent>>(\n        (resolve, reject) => {\n          pending.push({ resolve, reject });\n        },\n      );\n    },\n  };\n\n  // The `StreamContract<TResult>` shape is shared across primitives —\n  // it types `on()` over the generic `StreamEvent` union (agent\n  // events). Supervisor events are a distinct discriminated union\n  // with the same `type`-keyed shape, so we satisfy the contract via\n  // a structural cast — handlers see the supervisor events at their\n  // correct narrowed types.\n  const stream = {\n    result,\n    on(handlerMap) {\n      for (const [key, handler] of Object.entries(handlerMap)) {\n        if (handler) {\n          handlers.set(key, handler as (event: SupervisorStreamEvent) => void);\n        }\n      }\n\n      return stream;\n    },\n    [Symbol.asyncIterator]() {\n      return iterator;\n    },\n  } as StreamContract<TResult, SupervisorStreamEvent>;\n\n  return { controller, stream };\n}\n","import type { SupervisorEventMap } from \"../contracts/events/event-map.type\";\nimport type { SupervisorResult } from \"../contracts/result/supervisor-result.type\";\nimport type { StreamContract } from \"../contracts/stream/stream.contract\";\nimport type { SupervisorIntentValue } from \"../contracts/supervisor/intent-entry.type\";\nimport type {\n  SupervisorConfig,\n  SupervisorEventHandler,\n} from \"../contracts/supervisor/supervisor-config.type\";\nimport type {\n  SupervisorExecuteOptions,\n  SupervisorResumeOptions,\n} from \"../contracts/supervisor/supervisor-execute-options.type\";\nimport type { SupervisorInput } from \"../contracts/supervisor/supervisor-input.type\";\nimport type { SupervisorStreamEvent } from \"../contracts/supervisor/supervisor-stream-event.type\";\nimport type {\n  SupervisorAsToolOptions,\n  SupervisorContract,\n} from \"../contracts/supervisor/supervisor.contract\";\nimport { SupervisorFailedError } from \"../errors\";\nimport type { ToolContract } from \"../tool/tool\";\nimport { asTool } from \"./as-tool\";\nimport { SupervisorEmitter } from \"./emitter\";\nimport { assertRouterDescriptions, resolveIntentEntries } from \"./entries\";\nimport { SupervisorExecution } from \"./execution\";\nimport { computeSignature } from \"./signature\";\nimport { loadSnapshotForResume } from \"./snapshot\";\nimport { createSupervisorStream } from \"./supervisor-stream\";\n\n/**\n * `ai.supervisor(config)` — construct a `SupervisorContract`. Validates\n * the config at author time (throws `SupervisorFailedError` on bad\n * shape), resolves agent entries, computes a stable structural\n * signature, wires the three-tier event emitter, and returns an\n * instance that satisfies `ExecutableContract` so it can compose into\n * tools, outer agents, and (future) orchestrators uniformly.\n *\n * @example\n * const support = ai.supervisor({\n *   name: \"customer-support\",\n *   router: routerAgent,\n *   intents: { triage, orderLookup, billingLookup, resolver },\n *   evaluate: (ctx) => ctx.result.resolver?.output ? { satisfied: true } : undefined,\n *   output: z.object({ response: z.string(), refund: z.boolean() }),\n *   maxIterations: 6,\n * });\n */\nexport function supervisor<\n  TOutput = unknown,\n  TState = TOutput,\n  TIntents extends Record<string, SupervisorIntentValue> = Record<string, SupervisorIntentValue>,\n  TArtifacts = Record<string, unknown>,\n>(config: SupervisorConfig<TOutput, TState, TIntents, TArtifacts>): SupervisorContract<TOutput> {\n  validateFactoryConfig(config as unknown as SupervisorConfig<TOutput>);\n\n  const entries = resolveIntentEntries(config.intents, config.name);\n\n  assertRouterDescriptions(config as SupervisorConfig<unknown>, entries);\n\n  if (config.initialAgent && !entries.has(config.initialAgent)) {\n    throw new SupervisorFailedError(\n      `ai.supervisor(\"${config.name}\"): \\`initialAgent\\` \"${config.initialAgent}\" is not a key in \\`intents\\``,\n      { context: { authoring: true } },\n    );\n  }\n\n  const signature = computeSignature(config as SupervisorConfig<unknown>, entries);\n  const emitter = new SupervisorEmitter(config.on);\n\n  async function execute(\n    input: SupervisorInput,\n    options?: SupervisorExecuteOptions,\n  ): Promise<SupervisorResult<TOutput>> {\n    const runId = options?.runId ?? generateRunId();\n\n    const execution = new SupervisorExecution<TOutput>({\n      config: config as unknown as SupervisorConfig<TOutput>,\n      entries,\n      signature,\n      emitter,\n      input,\n      runId,\n      options,\n    });\n\n    return execution.run();\n  }\n\n  function stream(\n    input: SupervisorInput,\n    options?: SupervisorExecuteOptions,\n  ): StreamContract<SupervisorResult<TOutput>, SupervisorStreamEvent> {\n    const runId = options?.runId ?? generateRunId();\n    const { controller, stream: contract } = createSupervisorStream<SupervisorResult<TOutput>>();\n\n    const execution = new SupervisorExecution<TOutput>({\n      config: config as unknown as SupervisorConfig<TOutput>,\n      entries,\n      signature,\n      emitter,\n      input,\n      runId,\n      options,\n      streamController: controller,\n    });\n\n    void execution.run();\n\n    return contract;\n  }\n\n  async function resume(\n    runId: string,\n    options?: SupervisorResumeOptions,\n  ): Promise<SupervisorResult<TOutput>> {\n    const snapshot = await loadSnapshotForResume({\n      config: config as SupervisorConfig<unknown>,\n      signature,\n      runId,\n      options,\n    });\n\n    const execution = new SupervisorExecution<TOutput>({\n      config: config as unknown as SupervisorConfig<TOutput>,\n      entries,\n      signature,\n      emitter,\n      input: snapshot.input,\n      runId,\n      options,\n      resumeFrom: snapshot,\n    });\n\n    return execution.run();\n  }\n\n  const instance: SupervisorContract<TOutput> = {\n    name: config.name,\n    inputSchema: config.inputSchema,\n    signature,\n    execute,\n    stream,\n    resume,\n    on<K extends keyof SupervisorEventMap>(\n      event: K,\n      handler: SupervisorEventHandler<K>,\n    ): () => void {\n      return emitter.on(event, handler);\n    },\n    off<K extends keyof SupervisorEventMap>(event: K, handler: SupervisorEventHandler<K>): void {\n      emitter.off(event, handler);\n    },\n    asTool<TToolInput = string>(\n      options: SupervisorAsToolOptions<TToolInput>,\n    ): ToolContract<TToolInput, TOutput> {\n      return asTool<TOutput, TToolInput>(instance, options);\n    },\n  };\n\n  return instance;\n}\n\n/**\n * Factory-time validation. Enforces the XOR + pairing rules the design\n * locked in §2 and surfaces any violation as a typed\n * `SupervisorFailedError` tagged `authoring: true`.\n */\nfunction validateFactoryConfig<T>(config: SupervisorConfig<T>): void {\n  if (!config.name || typeof config.name !== \"string\") {\n    throw new SupervisorFailedError(\"ai.supervisor: `name` is required and must be a string\", {\n      context: { authoring: true },\n    });\n  }\n\n  if (!config.intents || typeof config.intents !== \"object\") {\n    throw new SupervisorFailedError(`ai.supervisor(\"${config.name}\"): \\`intents\\` is required`, {\n      context: { authoring: true },\n    });\n  }\n\n  const hasRoute = typeof config.route === \"function\";\n  const hasRouter = !!config.router;\n\n  if (hasRouter) {\n    const router = config.router as { execute?: unknown } | { agent?: { execute?: unknown } };\n    const isBareAgent = typeof (router as { execute?: unknown }).execute === \"function\";\n    const isEntryForm =\n      !isBareAgent &&\n      typeof (router as { agent?: { execute?: unknown } }).agent === \"object\" &&\n      typeof (router as { agent?: { execute?: unknown } }).agent?.execute === \"function\";\n\n    if (!isBareAgent && !isEntryForm) {\n      throw new SupervisorFailedError(\n        `ai.supervisor(\"${config.name}\"): \\`router\\` must be an agent contract or a \\`{ agent, placeholders?, input? }\\` entry`,\n        { context: { authoring: true } },\n      );\n    }\n  }\n\n  if (hasRoute && hasRouter) {\n    throw new SupervisorFailedError(\n      `ai.supervisor(\"${config.name}\"): \\`route\\` and \\`router\\` are mutually exclusive — configure exactly one`,\n      { context: { authoring: true } },\n    );\n  }\n\n  // Phase 7 / decisions §37 — `classifier` is the iter-0 prelude;\n  // satisfies the \"must have a dispatch source\" rule on its own.\n  // Composes with router/route (classifier drives iter 0; router/route\n  // takes iter 1+). When configured alone, supervisor terminates after\n  // iter 0's branch settles.\n  const hasClassifier = config.classifier !== undefined;\n\n  if (!hasRoute && !hasRouter && !hasClassifier) {\n    throw new SupervisorFailedError(\n      `ai.supervisor(\"${config.name}\"): one of \\`route\\`, \\`router\\`, or \\`classifier\\` is required`,\n      { context: { authoring: true } },\n    );\n  }\n\n  // Phase 7 — classifier and initialAgent both decide what runs first.\n  // Coexistence is meaningless; throw loudly.\n  if (hasClassifier && config.initialAgent) {\n    throw new SupervisorFailedError(\n      `ai.supervisor(\"${config.name}\"): \\`classifier\\` and \\`initialAgent\\` are mutually exclusive — both decide which intent runs first. Pick one.`,\n      { context: { authoring: true } },\n    );\n  }\n\n  // Phase 3.4 (Q9) — evaluate now pairs with both `route` and\n  // `router`. State-driven termination is useful in either dispatch\n  // mode; the historical router-only restriction was incidental,\n  // not principled.\n\n  if (config.ack !== undefined) {\n    const ack = config.ack;\n    const isCallback = typeof ack === \"function\";\n    const isAgentEntry =\n      typeof ack === \"object\" &&\n      ack !== null &&\n      typeof (ack as { agent?: { execute?: unknown } }).agent?.execute === \"function\";\n    const isRunEntry =\n      typeof ack === \"object\" &&\n      ack !== null &&\n      typeof (ack as { run?: unknown }).run === \"function\";\n\n    if (!isCallback && !isAgentEntry && !isRunEntry) {\n      throw new SupervisorFailedError(\n        `ai.supervisor(\"${config.name}\"): \\`ack\\` must be an \\`{ agent, ... }\\` entry, an \\`{ run, ... }\\` entry, or a bare callback function`,\n        { context: { authoring: true } },\n      );\n    }\n\n    if (isAgentEntry && isRunEntry) {\n      throw new SupervisorFailedError(\n        `ai.supervisor(\"${config.name}\"): \\`ack\\` cannot declare both \\`agent\\` and \\`run\\` — pick one`,\n        { context: { authoring: true } },\n      );\n    }\n  }\n\n  if (config.maxIterations !== undefined && config.maxIterations < 1) {\n    throw new SupervisorFailedError(\n      `ai.supervisor(\"${config.name}\"): \\`maxIterations\\` must be >= 1`,\n      { context: { authoring: true, maxIterations: config.maxIterations } },\n    );\n  }\n}\n\nfunction generateRunId(): string {\n  return `sup_${Date.now().toString(36)}_${Math.random().toString(36).slice(2, 10)}`;\n}\n","import type { Message } from \"../contracts/conversation-message.type\";\nimport type { SnapshotStore } from \"../contracts/orchestrator/snapshot-store.contract\";\nimport type { SupervisorResult } from \"../contracts/result/supervisor-result.type\";\nimport type { TurnSnapshot } from \"../contracts/result/orchestrator-result.type\";\nimport type { SupervisorConfig } from \"../contracts/supervisor/supervisor-config.type\";\nimport type { SupervisorInput } from \"../contracts/supervisor/supervisor-input.type\";\nimport type { SupervisorReport } from \"../contracts/result/supervisor-result.type\";\nimport type { OrchestratorEngineContext } from \"./engine-context.type\";\nimport { supervisor as createSupervisor } from \"../supervisor/supervisor\";\n\n/**\n * Derive the deterministic supervisor `runId` for an `iterate: true`\n * turn (orchestrator.md §5 Phase 5 / §10.2 / §18.7):\n * `${sessionId}.${version ?? \"unversioned\"}.${turnIndex}`. No base64,\n * no hashing — the `sessionId` is the dev's responsibility to make\n * unique. Deploying a new `version` cleanly partitions in-flight runs\n * across deploys so old runIds never collide with new ones.\n */\nexport function deriveRunId(\n  sessionId: string,\n  version: string | undefined,\n  turnIndex: number,\n): string {\n  return `${sessionId}.${version ?? \"unversioned\"}.${turnIndex}`;\n}\n\n/** Parameters for one Phase-5 dispatch. */\nexport type DispatchParams<TOutput, TState> = {\n  ctx: OrchestratorEngineContext<TOutput, TState>;\n  sessionId: string;\n  input: SupervisorInput;\n  /** The session-state seed assembled in Phase 1 + the per-call patch. */\n  seedState: TState;\n  turnIndex: number;\n  /** Agent-windowed history from Phase 4. */\n  history: Message[];\n  context?: Record<string, unknown>;\n  signal?: AbortSignal;\n};\n\n/** Outcome of Phase 5 — the supervisor result plus the turn's snapshot. */\nexport type DispatchOutcome<TOutput> = {\n  result: SupervisorResult<TOutput>;\n  /** Post-dispatch session state (replaces session state per §5). */\n  state: unknown;\n  turnSnapshot: TurnSnapshot;\n};\n\n/**\n * Build the internal supervisor config by spreading the orchestrator's\n * supervisor-surface fields (orchestrator.md §1 / §5 Phase 5) and\n * seeding `state` from the session-state seed.\n *\n * `iterate: false` caps `maxIterations` at 1 — a single dispatch per\n * turn (\"the supervisor's Phase A + Phase B once, no iteration loop\" —\n * §5). `iterate: true` keeps the configured `maxIterations` (default\n * 10) and wires the `snapshotStore` for mid-turn resume.\n *\n * The orchestrator DELEGATES to the existing supervisor — it never\n * reimplements dispatch / route / evaluate / strip-merge logic.\n */\nfunction buildSupervisorConfig<TOutput, TState>(\n  ctx: OrchestratorEngineContext<TOutput, TState>,\n  seedState: TState,\n  iterate: boolean,\n  snapshotStore: SnapshotStore | undefined,\n): SupervisorConfig<TOutput, TState> {\n  const config = ctx.config;\n\n  const supervisorConfig: SupervisorConfig<TOutput, TState> = {\n    name: config.name,\n    version: config.version,\n    systemPrompt: config.systemPrompt,\n    intents: config.intents,\n    route: config.route,\n    router: config.router,\n    evaluate: config.evaluate,\n    state: seedState,\n    output: config.output,\n    initialAgent: config.initialAgent,\n    maxIterations: iterate ? config.maxIterations : 1,\n    historyWindow: config.historyWindow\n      ? { router: toNumber(config.historyWindow.router), agents: toNumber(config.historyWindow.agents) }\n      : undefined,\n    snapshotStore: iterate ? snapshotStore : undefined,\n  };\n\n  return supervisorConfig;\n}\n\n/**\n * The supervisor's `historyWindow` tiers accept only numbers; the\n * orchestrator's accept a number OR a slicer callback. The callback\n * form is already applied at the orchestrator level (Phase 4), so any\n * non-number here has already done its slicing — drop it for the\n * supervisor (which sees the pre-sliced history) by returning\n * `undefined`.\n */\nfunction toNumber(\n  value: number | ((messages: Message[]) => Message[]) | undefined,\n): number | undefined {\n  return typeof value === \"number\" ? value : undefined;\n}\n\n/**\n * Build the forensic {@link TurnSnapshot} for the dispatched turn from\n * the supervisor's result. Mirrors the supervisor's `IterationSnapshot`\n * shape (§15.5) so a turn reads uniformly whether one agent ran\n * (`iterate: false`) or the internal supervisor iterated\n * (`iterate: true`). The terminal iteration's branch records and\n * decision are lifted onto the turn; the supervisor's full report tree\n * becomes the turn's `childReport`.\n */\nfunction buildTurnSnapshot(\n  input: SupervisorInput,\n  turnIndex: number,\n  result: SupervisorResult<unknown>,\n  state: unknown,\n): TurnSnapshot {\n  const report = result.report;\n  const snapshots = report.snapshots;\n  const terminal = snapshots.length > 0 ? snapshots[snapshots.length - 1] : undefined;\n\n  const decisionSource = mapDecisionSource(terminal?.decision.source);\n\n  return Object.freeze({\n    turn: turnIndex,\n    input,\n    decision: {\n      source: decisionSource,\n      raw: terminal?.decision.next ?? null,\n      reasoning: terminal?.decision.reasoning,\n    },\n    result: terminal?.result ?? {},\n    state,\n    evaluate: terminal?.evaluateVerdict,\n    startedAt: report.startedAt,\n    endedAt: report.endedAt,\n    duration: report.duration,\n    usage: report.usage,\n    childReport: report,\n  });\n}\n\n/**\n * Map the supervisor's `DecisionSource` onto the narrower turn-snapshot\n * decision source (§15.5 — `\"route\" | \"router\" | \"intent.next\"`). The\n * supervisor's `initialAgent` / `classifier` first-turn sources collapse\n * to `\"intent.next\"` (a non-route/router origin) at the orchestrator\n * layer, which only distinguishes the three coarse decision origins.\n */\nfunction mapDecisionSource(\n  source: \"route\" | \"router\" | \"initialAgent\" | \"classifier\" | undefined,\n): \"route\" | \"router\" | \"intent.next\" {\n  if (source === \"route\" || source === \"router\") {\n    return source;\n  }\n\n  return \"intent.next\";\n}\n\n/**\n * Phase 5 — dispatch turn (orchestrator.md §3 / §4 Phase 5).\n *\n * Constructs a fresh internal supervisor seeded from the session state,\n * then:\n *\n * - `iterate: false` — runs a single dispatch (`maxIterations: 1`).\n * - `iterate: true` — runs the full supervisor with a deterministic\n *   `runId`, resuming an in-flight run when the `SnapshotStore` already\n *   has one for that `runId` (§5 step 5).\n *\n * The supervisor's final state replaces the session state (§5 — replace\n * semantics). The supervisor is never kept alive across turns\n * (single-call lifecycle invariant — §18.8).\n */\nexport async function dispatchTurn<TOutput, TState>(\n  params: DispatchParams<TOutput, TState>,\n): Promise<DispatchOutcome<TOutput>> {\n  const { ctx, sessionId, input, seedState, turnIndex, history, context, signal } =\n    params;\n\n  const iterate = ctx.config.iterate === true;\n  const sup = createSupervisor<TOutput, TState>(\n    buildSupervisorConfig(ctx, seedState, iterate, ctx.snapshotStore),\n  );\n\n  let result: SupervisorResult<TOutput>;\n\n  if (iterate) {\n    const runId = deriveRunId(sessionId, ctx.config.version, turnIndex);\n    const inFlight = ctx.snapshotStore\n      ? await ctx.snapshotStore.load(runId)\n      : undefined;\n\n    if (inFlight && inFlight.status === \"running\") {\n      result = await sup.resume(runId, { context, signal, history, sessionId });\n    } else {\n      result = await sup.execute(input, { runId, context, signal, history, sessionId });\n    }\n  } else {\n    result = await sup.execute(input, { context, signal, history, sessionId });\n  }\n\n  const state = deriveFinalState(result, seedState);\n  const turnSnapshot = buildTurnSnapshot(input, turnIndex, result, state);\n\n  return { result, state, turnSnapshot };\n}\n\n/**\n * Derive the post-turn session state from the supervisor result.\n * Prefers the terminal iteration's accumulated `state`; falls back to\n * the validated `data` (when an `output` schema reshaped it), then to\n * the seed when the run produced neither (e.g. it terminated before\n * dispatching anything). Replace semantics — the supervisor is the\n * authority on state evolution within its loop (§5).\n */\nfunction deriveFinalState<TOutput, TState>(\n  result: SupervisorResult<TOutput>,\n  seedState: TState,\n): unknown {\n  const report: SupervisorReport = result.report;\n  const snapshots = report.snapshots;\n  const terminal = snapshots.length > 0 ? snapshots[snapshots.length - 1] : undefined;\n\n  if (terminal && terminal.state !== undefined) {\n    return terminal.state;\n  }\n\n  if (result.data !== undefined) {\n    return result.data;\n  }\n\n  return seedState;\n}\n","import type { CheckpointRecord } from \"../contracts/orchestrator/checkpoint-store.contract\";\nimport type { OrchestratorEngineContext } from \"./engine-context.type\";\n\n/**\n * Outcome of Phase 1 — load session (orchestrator.md §4 Phase 1).\n *\n * `record` is the latest persisted checkpoint, or `undefined` for a\n * brand-new session. `state` is the starting accumulator the turn\n * mutates: the rehydrated `state` on a subsequent call, or the\n * `config.state ?? {}` seed on first call (the framework never\n * re-seeds from `config.state` once a session exists — §4 Phase 1).\n * `turnIndex` is the index of the turn ABOUT to run (loaded + 1, or 0\n * on first call). `previousTurnIndex` is the loaded value (or -1 when\n * none) — needed by resume's `runId` derivation (§9.1).\n */\nexport type LoadedSession<TState> = {\n  /** Latest persisted checkpoint, or `undefined` for a new session. */\n  record: CheckpointRecord | undefined;\n  /** Whether a prior checkpoint existed (drives `session.loaded.found`). */\n  found: boolean;\n  /** Starting state accumulator for this turn. */\n  state: TState;\n  /** Index of the turn about to run. */\n  turnIndex: number;\n  /** Index of the last settled turn (-1 when the session is new). */\n  previousTurnIndex: number;\n};\n\n/**\n * Deep-clone a JSON-serializable value so a rehydrated checkpoint's\n * `state` can be mutated by the turn without aliasing the stored row\n * (the in-memory store hands back live references). Mirrors the\n * round-trip semantics the design mandates for state (§5 — \"JSON-\n * serializable only\", `JSON.parse(JSON.stringify(...))`-equivalent).\n */\nfunction cloneState<TState>(state: unknown): TState {\n  if (state === undefined || state === null) {\n    return {} as TState;\n  }\n\n  return JSON.parse(JSON.stringify(state)) as TState;\n}\n\n/**\n * Phase 1 — load session. Reads the latest checkpoint for the session\n * and resolves the starting state accumulator + the turn index about\n * to run.\n *\n * First-call seeding (Q2): when no checkpoint exists this is the\n * session's birth — `state` defaults to `config.state ?? {}` and\n * `turnIndex` is 0. Subsequent calls rehydrate the persisted `state`\n * and advance the turn index. The dev-passed `options.history` is the\n * per-call seed (Path 2 — the framework never persists messages), so\n * load does not touch history.\n *\n * Does NOT apply the per-call `state` patch — that shallow-merges over\n * this result in the dispatch phase (§5), where the supervisor seed is\n * assembled.\n */\nexport async function loadSession<TState>(\n  ctx: OrchestratorEngineContext<unknown, TState>,\n  sessionId: string,\n): Promise<LoadedSession<TState>> {\n  const record = await ctx.checkpointStore.load(ctx.config.name, sessionId);\n\n  if (!record) {\n    return {\n      record: undefined,\n      found: false,\n      state: cloneState<TState>(ctx.config.state),\n      turnIndex: 0,\n      previousTurnIndex: -1,\n    };\n  }\n\n  return {\n    record,\n    found: true,\n    state: cloneState<TState>(record.state),\n    turnIndex: record.turn_index + 1,\n    previousTurnIndex: record.turn_index,\n  };\n}\n","import type { OrchestratorResumeOptions } from \"../contracts/orchestrator/orchestrator-execute-options.type\";\nimport type {\n  OrchestratorReport,\n  OrchestratorReportStatus,\n  OrchestratorResult,\n  TurnSnapshot,\n} from \"../contracts/result/orchestrator-result.type\";\nimport type { BaseReport } from \"../contracts/result/base-report.type\";\nimport { summarizeRoute } from \"./checkpoint\";\nimport { deriveRunId, dispatchTurn } from \"./dispatch\";\nimport type { OrchestratorEngineContext } from \"./engine-context.type\";\nimport { loadSession } from \"./load\";\n\n/**\n * Hooks the resume protocol borrows from the execution module so it can\n * reuse the drift check, report assembly, status mapping, terminal\n * event emission, and checkpoint persistence without a circular import\n * (execution.ts owns those; resume.ts is called by it).\n */\nexport type ResumeHooks = {\n  assertNoDrift(loadedSignature: string | undefined): void;\n  buildReport(\n    turnIndex: number,\n    status: OrchestratorReportStatus,\n    turnSnapshot: TurnSnapshot | undefined,\n    childReport: BaseReport | undefined,\n  ): OrchestratorReport;\n  deriveStatus(childStatus: BaseReport[\"status\"]): OrchestratorReportStatus;\n  emitTerminal(turnIndex: number, status: OrchestratorReportStatus): void;\n  persist(\n    turnIndex: number,\n    state: unknown,\n    lastRoute: string | string[] | null,\n    summarizedThrough: number | null,\n  ): Promise<unknown>;\n};\n\n/**\n * §9 resume protocol. Detects and drains an interrupted `iterate: true`\n * turn:\n *\n * 1. Load the latest checkpoint (§9.1 step 1).\n * 2. Compute the candidate `runId` for the NEXT turn — the one that was\n *    in flight — `${sessionId}.${version}.${turn_index + 1}` (§9.1 step 2).\n * 3. Load the supervisor snapshot for that runId (§9.1 step 3).\n * 4. If a still-`running` snapshot exists, resume the supervisor, persist\n *    a fresh checkpoint for `turn_index + 1`, and return the result\n *    (§9.1 step 4).\n * 5. Otherwise return `null` — nothing in flight; the caller proceeds to\n *    `execute()` normally (§9.1 step 5, §9.3 drain idempotency).\n *\n * Runs the same Phase 2 drift check as `execute()` (§9.4). Resume is a\n * no-op for `iterate: false` orchestrators (no SnapshotStore, nothing to\n * resume) — it returns `null`.\n */\nexport async function resolveResume<TOutput, TState>(\n  ctx: OrchestratorEngineContext<TOutput, TState>,\n  sessionId: string,\n  options: OrchestratorResumeOptions | undefined,\n  hooks: ResumeHooks,\n): Promise<OrchestratorResult<TOutput> | null> {\n  if (!ctx.snapshotStore || ctx.config.iterate !== true) {\n    return null;\n  }\n\n  const loaded = await loadSession(ctx, sessionId);\n\n  // Drift guard — same as execute() (§9.4).\n  hooks.assertNoDrift(loaded.record?.signature);\n\n  // The in-flight turn is the one AFTER the last settled checkpoint.\n  const resumedTurnIndex = (loaded.record?.turn_index ?? -1) + 1;\n  const runId = deriveRunId(sessionId, ctx.config.version, resumedTurnIndex);\n\n  const snapshot = await ctx.snapshotStore.load(runId);\n\n  if (!snapshot || snapshot.status !== \"running\") {\n    return null;\n  }\n\n  ctx.emitter.emit(\"orchestrator.turn.starting\", {\n    sessionId,\n    turnIndex: resumedTurnIndex,\n  });\n\n  // Re-dispatch: dispatchTurn detects the in-flight snapshot for this\n  // runId and calls supervisor.resume() rather than execute() (§5 step 5).\n  const { result, state, turnSnapshot } = await dispatchTurn<TOutput, TState>({\n    ctx,\n    sessionId,\n    input: snapshot.input,\n    seedState: loaded.state,\n    turnIndex: resumedTurnIndex,\n    history: [],\n    context: options?.context,\n    signal: options?.signal,\n  });\n\n  const status = result.error\n    ? hooks.deriveStatus(result.report.status)\n    : \"awaiting-input\";\n\n  if (result.error) {\n    const report = hooks.buildReport(\n      resumedTurnIndex,\n      status,\n      turnSnapshot,\n      result.report,\n    );\n\n    hooks.emitTerminal(resumedTurnIndex, status);\n\n    return {\n      data: result.data,\n      error: result.error,\n      usage: result.usage,\n      report,\n      sessionId,\n      turnIndex: resumedTurnIndex,\n    };\n  }\n\n  // Finalize: persist a fresh checkpoint for the resumed turn (§9.1 step 4).\n  await hooks.persist(\n    resumedTurnIndex,\n    state,\n    summarizeRoute(turnSnapshot.decision.raw as never),\n    loaded.record?.summarized_through ?? null,\n  );\n\n  const report = hooks.buildReport(\n    resumedTurnIndex,\n    \"awaiting-input\",\n    turnSnapshot,\n    result.report,\n  );\n\n  hooks.emitTerminal(resumedTurnIndex, \"awaiting-input\");\n\n  return {\n    data: result.data,\n    error: undefined,\n    usage: result.usage,\n    report,\n    sessionId,\n    turnIndex: resumedTurnIndex,\n  };\n}\n","import type { Message } from \"../contracts/conversation-message.type\";\nimport type { OrchestratorEngineContext } from \"./engine-context.type\";\n\n/**\n * Framework-default history windows (orchestrator.md §4 Phase 4 — \"5\n * for the router, 15 for intents\"). Applied when neither a per-entity\n * override nor a tier default is configured.\n */\nexport const DEFAULT_ROUTER_WINDOW = 5;\nexport const DEFAULT_AGENTS_WINDOW = 15;\n\n/** A history window: keep the last N messages, or a custom slicer. */\nexport type HistoryWindowValue =\n  | number\n  | ((messages: Message[]) => Message[]);\n\n/**\n * The windowed history bound into each consumer for a turn (§4 Phase\n * 4). Applied per-dispatchable, independently: the router can see a\n * different slice than the dispatched agents.\n */\nexport type WindowedHistory = {\n  /** Slice bound into the router's context. */\n  router: Message[];\n  /** Slice forwarded to every dispatched intent/agent. */\n  agents: Message[];\n};\n\n/**\n * Apply a single window to a history array. A number keeps the last N\n * messages (most recent, chronological order preserved); a callback\n * takes full control of the slice (the escape hatch for token-counting\n * or semantic windowing — §4 Phase 4). `N <= 0` keeps nothing.\n */\nexport function applyWindow(\n  messages: Message[],\n  window: HistoryWindowValue,\n): Message[] {\n  if (typeof window === \"function\") {\n    return window(messages);\n  }\n\n  if (window <= 0) {\n    return [];\n  }\n\n  if (messages.length <= window) {\n    return messages.slice();\n  }\n\n  return messages.slice(messages.length - window);\n}\n\n/**\n * Phase 4 — window history (orchestrator.md §3 / §4 Phase 4). Applies\n * the `historyWindow` cascade to the dev-supplied `history` before it\n * is bound into the router and the dispatched agents. Two tiers,\n * evaluated per-role:\n *\n * 1. Tier default — `historyWindow.router` / `historyWindow.agents`.\n * 2. Framework default — `5` for the router, `15` for agents.\n *\n * (The first cascade layer — per-entity overrides on individual\n * intents / the router entry — is the supervisor's concern: it lives\n * on the intent entries the orchestrator spreads into the supervisor,\n * and the supervisor applies it to the agent-windowed slice this phase\n * produces. The orchestrator owns only the two role-level tiers.)\n *\n * Emits `orchestrator.history.windowed` with the agent-slice message\n * count. Pure aside from the event — returns the per-role slices for\n * the dispatch phase to thread through.\n */\nexport function windowHistory(\n  ctx: OrchestratorEngineContext,\n  sessionId: string,\n  history: Message[],\n): WindowedHistory {\n  const config = ctx.config.historyWindow;\n\n  const router = applyWindow(history, config?.router ?? DEFAULT_ROUTER_WINDOW);\n  const agents = applyWindow(history, config?.agents ?? DEFAULT_AGENTS_WINDOW);\n\n  ctx.emitter.emit(\"orchestrator.history.windowed\", {\n    sessionId,\n    messageCount: agents.length,\n  });\n\n  return { router, agents };\n}\n","import type { Message } from \"../contracts/conversation-message.type\";\nimport type { OrchestratorCommands } from \"../contracts/orchestrator/orchestrator-commands.type\";\nimport type { OrchestratorConfig } from \"../contracts/orchestrator/orchestrator-config.type\";\nimport type {\n  OrchestratorEvent,\n  OrchestratorEventHandlers,\n  OrchestratorEventMap,\n  OrchestratorEventName,\n} from \"../contracts/orchestrator/orchestrator-event.type\";\nimport type {\n  OrchestratorExecuteOptions,\n  OrchestratorResumeOptions,\n} from \"../contracts/orchestrator/orchestrator-execute-options.type\";\nimport type {\n  CompactionResult,\n  OrchestratorReport,\n  OrchestratorReportStatus,\n  OrchestratorResult,\n  TurnSnapshot,\n} from \"../contracts/result/orchestrator-result.type\";\nimport { REPORT_SCHEMA_VERSION } from \"../contracts/result/base-report.type\";\nimport type { BaseReport } from \"../contracts/result/base-report.type\";\nimport type { Usage } from \"../contracts/result/usage.type\";\nimport type { SupervisorInput } from \"../contracts/supervisor/supervisor-input.type\";\nimport type { EventIdentity } from \"../contracts/events/event-identity.type\";\nimport {\n  resolveDefaultCheckpointStore,\n  resolveDefaultSnapshotStore,\n} from \"../config\";\nimport { OrchestratorConfigError, OrchestratorDriftError } from \"../errors\";\nimport type { ResolvedIntentEntry } from \"../supervisor/entries\";\nimport { generateRunId } from \"../utils/generate-run-id\";\nimport { persistCheckpoint, summarizeRoute } from \"./checkpoint\";\nimport { runCompaction, runManualCompaction, shouldCompact } from \"./compaction\";\nimport { deriveRunId, dispatchTurn } from \"./dispatch\";\nimport type { OrchestratorEmitter } from \"./emitter\";\nimport type { OrchestratorEmitterLike } from \"./emitter-port.type\";\nimport type { OrchestratorEngineContext } from \"./engine-context.type\";\nimport { acquireLock } from \"./lock\";\nimport { loadSession } from \"./load\";\nimport {\n  injectMemories,\n  outcomeTextFromTurn,\n  recallForTurn,\n  rememberTurnOutcome,\n  resolveOrchestratorMemory,\n} from \"./memory\";\nimport type { OrchestratorStreamController } from \"./orchestrator-stream\";\nimport { resolveResume } from \"./resume\";\nimport { windowHistory } from \"./window\";\n\n/** Empty rolled-up usage for turns that never dispatched (drift/seed). */\nconst ZERO_USAGE: Usage = { input: 0, output: 0, total: 0 };\n\n/**\n * Constructor params the C1 factory passes when building an\n * {@link OrchestratorExecution} per call. The factory owns author-time\n * validation, intent-entry resolution, and signature computation; it\n * hands the engine the validated `config`, the resolved `entries`, the\n * computed `signature`, and the shared three-tier `emitter`. The\n * per-call inputs vary by entry point:\n *\n * - `execute` / `stream` — `input` + `options` (and `streamController`\n *   for `stream`).\n * - `resume` — `resumeSessionId` + `resumeOptions`.\n * - `command(\"compact\")` — neither; `compact(args)` carries its own.\n */\nexport type OrchestratorExecutionParams<TOutput, TState> = {\n  config: OrchestratorConfig<TOutput, TState>;\n  /** Resolved intent entries (validated by C1; the engine delegates dispatch to the supervisor). */\n  entries?: Map<string, ResolvedIntentEntry>;\n  signature: string;\n  emitter: OrchestratorEmitter;\n  input?: SupervisorInput;\n  options?: OrchestratorExecuteOptions<TState>;\n  streamController?: OrchestratorStreamController<OrchestratorResult<TOutput>>;\n  resumeSessionId?: string;\n  resumeOptions?: OrchestratorResumeOptions;\n};\n\n/**\n * Per-call lifecycle engine — the single object the C1 factory\n * constructs and drives. Owns the 7-phase lifecycle (orchestrator.md §3:\n * load → drift → lock → window → dispatch → persist → compaction),\n * resolving the durable stores (own config field → `ai.config` default)\n * and adapting C1's three-tier {@link OrchestratorEmitter} to the\n * {@link OrchestratorEmitterLike} port the phase modules call.\n *\n * The factory creates a fresh instance per `execute` / `stream` /\n * `resume` / `command` call (single-call lifecycle invariant — §18.8);\n * the heavy lifting lives in the standalone phase functions\n * ({@link runTurn} / {@link runResume}) which this class delegates to.\n *\n * @example\n * const execution = new OrchestratorExecution({\n *   config, entries, signature, emitter, input, options,\n * });\n * const result = await execution.run();\n */\nexport class OrchestratorExecution<TOutput, TState> {\n  private readonly params: OrchestratorExecutionParams<TOutput, TState>;\n  private readonly ctx: OrchestratorEngineContext<TOutput, TState>;\n  private readonly streamController?: OrchestratorStreamController<\n    OrchestratorResult<TOutput>\n  >;\n\n  public constructor(params: OrchestratorExecutionParams<TOutput, TState>) {\n    this.params = params;\n    this.streamController = params.streamController;\n    this.ctx = {\n      config: params.config,\n      signature: params.signature,\n      checkpointStore: resolveCheckpointStore(params.config),\n      snapshotStore: resolveSnapshotStore(params.config),\n      emitter: adaptEmitter(\n        params.emitter,\n        generateRunId(\"orchestrator\"),\n        this.streamController as\n          | OrchestratorStreamController<unknown>\n          | undefined,\n      ),\n      memory: resolveOrchestratorMemory(params.config.memory),\n    };\n  }\n\n  /**\n   * `execute()` / `stream()` entry — run one turn through the 7-phase\n   * lifecycle. When a `streamController` was supplied, the adapter mirrors\n   * every emitted event into the stream and the controller is settled\n   * (`end` / `fail`) once the result resolves.\n   */\n  public async run(): Promise<OrchestratorResult<TOutput>> {\n    if (this.params.input === undefined || !this.params.options) {\n      throw new OrchestratorConfigError(\n        `ai.orchestrator(\"${this.params.config.name}\"): internal — run() invoked without input/options`,\n      );\n    }\n\n    try {\n      const result = await runTurn(\n        this.ctx,\n        this.params.input,\n        this.params.options,\n      );\n\n      this.streamController?.end(result);\n\n      return result;\n    } catch (error) {\n      this.streamController?.fail(error as Error);\n\n      throw error;\n    }\n  }\n\n  /**\n   * `resume()` entry — drain an interrupted `iterate: true` turn (§9).\n   * Returns `null` when nothing is in flight.\n   */\n  public async resume(): Promise<OrchestratorResult<TOutput> | null> {\n    if (!this.params.resumeSessionId) {\n      throw new OrchestratorConfigError(\n        `ai.orchestrator(\"${this.params.config.name}\"): internal — resume() invoked without a sessionId`,\n      );\n    }\n\n    return runResume(this.ctx, this.params.resumeSessionId, this.params.resumeOptions);\n  }\n\n  /**\n   * `command(\"compact\")` entry — run a manual compaction on demand (§11 /\n   * §12.1). Reuses the post-turn compaction code path against the\n   * caller-supplied history and returns the raw {@link CompactionResult}.\n   */\n  public async compact(\n    args: OrchestratorCommands[\"compact\"][\"args\"],\n  ): Promise<OrchestratorCommands[\"compact\"][\"result\"]> {\n    return runManualCompaction(\n      this.ctx as OrchestratorEngineContext<unknown, TState>,\n      args.history,\n    );\n  }\n}\n\n/**\n * Resolve the durable checkpoint store: the config's own field, falling\n * back to `ai.config({ defaultCheckpointStore })`. Throws\n * {@link OrchestratorConfigError} when neither resolves — persistence is\n * always on (§8.1), so a turn can never run without a checkpoint store.\n */\nfunction resolveCheckpointStore<TOutput, TState>(\n  config: OrchestratorConfig<TOutput, TState>,\n) {\n  const store = config.checkpointStore ?? resolveDefaultCheckpointStore();\n\n  if (!store) {\n    throw new OrchestratorConfigError(\n      `ai.orchestrator(\"${config.name}\"): a \\`checkpointStore\\` is required ` +\n        `(set one on the config or via \\`ai.config({ defaultCheckpointStore })\\`)`,\n    );\n  }\n\n  return store;\n}\n\n/**\n * Resolve the internal-supervisor snapshot store for `iterate: true`\n * turns: the config's own field, falling back to\n * `ai.config({ defaultSnapshotStore })`. Returns `undefined` for\n * `iterate: false` orchestrators (no mid-turn resume — nothing to\n * snapshot). The factory already guarantees presence when\n * `iterate: true`, so the engine never asserts here.\n */\nfunction resolveSnapshotStore<TOutput, TState>(\n  config: OrchestratorConfig<TOutput, TState>,\n) {\n  if (config.iterate !== true) {\n    return undefined;\n  }\n\n  return config.snapshotStore ?? resolveDefaultSnapshotStore();\n}\n\n/**\n * Adapt C1's three-tier {@link OrchestratorEmitter} (whose `emit` takes\n * `event, payload, identity, perCallHandlers?`) to the\n * {@link OrchestratorEmitterLike} port the phase modules call (a 2-arg\n * `emit(event, payload)` plus `bindPerCall`).\n *\n * The adapter injects the run identity centrally and, when a stream\n * controller is present, mirrors every fully-stamped event into the\n * stream pipe (§14.1 — the orchestrator's own events surface on the\n * stream alongside the bubbled child events). `bindPerCall` registers\n * the per-call `options.on` bag for the turn's duration and returns a\n * disposer that clears it.\n */\nfunction adaptEmitter(\n  emitter: OrchestratorEmitter,\n  runId: string,\n  streamController: OrchestratorStreamController<unknown> | undefined,\n): OrchestratorEmitterLike {\n  // `rootRunId === runId` for a standalone run; nested propagation lands\n  // in a follow-up (see `EventIdentity`).\n  const fullIdentity: EventIdentity = { runId, rootRunId: runId };\n\n  let perCall: OrchestratorEventHandlers | undefined;\n\n  return {\n    emit<K extends OrchestratorEventName>(\n      event: K,\n      payload: OrchestratorEventMap[K],\n    ): void {\n      const fullPayload = emitter.emit(event, payload, fullIdentity, perCall);\n\n      // The discriminated-union correlation between `type` and the\n      // matching payload variant can't be expressed structurally — the\n      // cast mirrors the supervisor stream's established pattern.\n      streamController?.push({ type: event, ...fullPayload } as OrchestratorEvent);\n    },\n    bindPerCall(handlers: OrchestratorEventHandlers | undefined): () => void {\n      perCall = handlers;\n\n      return () => {\n        perCall = undefined;\n      };\n    },\n  };\n}\n\n/**\n * Phase 2 — drift check (orchestrator.md §3 / §4 Phase 2). Compares the\n * loaded checkpoint's `signature` against the current definition's.\n * Mismatch throws `OrchestratorDriftError` synchronously unless\n * `force` is set. Emits `orchestrator.drift.checked` either way. A new\n * session (no loaded signature) never drifts.\n */\nfunction assertNoDrift(\n  ctx: OrchestratorEngineContext,\n  sessionId: string,\n  loadedSignature: string | undefined,\n  force: boolean | undefined,\n): void {\n  const drifted =\n    loadedSignature !== undefined && loadedSignature !== ctx.signature;\n\n  ctx.emitter.emit(\"orchestrator.drift.checked\", {\n    sessionId,\n    signature: ctx.signature,\n    drifted,\n  });\n\n  if (drifted && !force) {\n    throw new OrchestratorDriftError(\n      `orchestrator \"${ctx.config.name}\": signature drift on session \"${sessionId}\" — ` +\n        `the definition changed since this session was last persisted. ` +\n        `Pass { force: true } only after reviewing the change, or discard / migrate the session.`,\n      {\n        savedSignature: loadedSignature as string,\n        currentSignature: ctx.signature,\n        sessionId,\n      },\n    );\n  }\n}\n\n/**\n * Shallow-merge the per-call `state` patch (§5 — partial state\n * override) over the loaded session-state seed. The merged value\n * becomes the supervisor's seed for this turn.\n */\nfunction applyStatePatch<TState>(\n  seed: TState,\n  patch: Partial<TState> | undefined,\n): TState {\n  if (!patch) {\n    return seed;\n  }\n\n  return { ...seed, ...patch } as TState;\n}\n\n/**\n * Assemble the orchestrator-scope {@link OrchestratorReport} from the\n * dispatched turn's child report and the turn snapshot. Wraps the\n * child supervisor/agent report tree as `children[0]` (§15.6 —\n * `children[]` carries only the CURRENT turn's dispatched primitive\n * reports) while the per-turn forensic record lives on `turns[]`.\n */\nfunction buildReport(\n  ctx: OrchestratorEngineContext,\n  sessionId: string,\n  turnIndex: number,\n  status: OrchestratorReportStatus,\n  turnSnapshot: TurnSnapshot | undefined,\n  childReport: BaseReport | undefined,\n): OrchestratorReport {\n  const now = new Date().toISOString();\n  const usage = turnSnapshot?.usage ?? childReport?.usage ?? ZERO_USAGE;\n\n  return {\n    runId: deriveRunId(sessionId, ctx.config.version, turnIndex),\n    rootRunId: deriveRunId(sessionId, ctx.config.version, turnIndex),\n    name: ctx.config.name,\n    version: ctx.config.version,\n    sessionId,\n    type: \"orchestrator\",\n    status,\n    startedAt: turnSnapshot?.startedAt ?? now,\n    endedAt: turnSnapshot?.endedAt ?? now,\n    duration: turnSnapshot?.duration ?? 0,\n    usage,\n    children: childReport ? [childReport] : [],\n    reportSchemaVersion: REPORT_SCHEMA_VERSION,\n    turnIndex,\n    signature: ctx.signature,\n    turns: turnSnapshot ? [turnSnapshot] : [],\n  };\n}\n\n/**\n * Map the dispatched supervisor result's report status onto the\n * orchestrator's status surface (§15.6). A clean completion that is\n * still mid-conversation reports `\"awaiting-input\"` (the session\n * continues) rather than `\"completed\"`; failures and cancellations\n * pass through.\n */\nfunction deriveStatus(childStatus: BaseReport[\"status\"]): OrchestratorReportStatus {\n  if (childStatus === \"completed\") {\n    return \"awaiting-input\";\n  }\n\n  return childStatus;\n}\n\n/**\n * Emit the terminal turn event matching the report status (§14.1).\n */\nfunction emitTerminal(\n  ctx: OrchestratorEngineContext,\n  sessionId: string,\n  turnIndex: number,\n  status: OrchestratorReportStatus,\n): void {\n  if (status === \"cancelled\") {\n    ctx.emitter.emit(\"orchestrator.turn.cancelled\", { sessionId, turnIndex });\n\n    return;\n  }\n\n  if (status === \"failed\" || status === \"max-iterations\") {\n    ctx.emitter.emit(\"orchestrator.turn.failed\", { sessionId, turnIndex });\n\n    return;\n  }\n\n  if (status === \"awaiting-input\") {\n    ctx.emitter.emit(\"orchestrator.turn.awaiting-input\", {\n      sessionId,\n      turnIndex,\n    });\n\n    return;\n  }\n\n  ctx.emitter.emit(\"orchestrator.turn.completed\", { sessionId, turnIndex });\n}\n\n/**\n * Run one turn end-to-end through the 7-phase lifecycle (orchestrator\n * .md §3). The single entry the C1 factory's `execute()` delegates to.\n *\n * Phase order is the diagram's contract: load → drift → lock → window\n * → dispatch → persist → compaction. Drift / config misuse throw;\n * every other failure surfaces on `result.error` (the contract: the\n * orchestrator never throws on runtime failure). Cancellation and\n * failure do NOT persist a fresh checkpoint (§17 — state reverts to the\n * pre-turn checkpoint).\n */\nexport async function runTurn<TOutput, TState>(\n  ctx: OrchestratorEngineContext<TOutput, TState>,\n  input: SupervisorInput,\n  options: OrchestratorExecuteOptions<TState>,\n): Promise<OrchestratorResult<TOutput>> {\n  const sessionId = options.sessionId;\n  const disposePerCall = ctx.emitter.bindPerCall(options.on);\n\n  try {\n    // Phase 1 — load session.\n    const loaded = await loadSession(ctx, sessionId);\n\n    ctx.emitter.emit(\"orchestrator.turn.starting\", {\n      sessionId,\n      turnIndex: loaded.turnIndex,\n    });\n\n    ctx.emitter.emit(\"orchestrator.session.loaded\", {\n      sessionId,\n      turnIndex: loaded.turnIndex,\n      found: loaded.found,\n    });\n\n    // Phase 2 — drift check.\n    assertNoDrift(\n      ctx as OrchestratorEngineContext,\n      sessionId,\n      loaded.record?.signature,\n      options.force,\n    );\n\n    // Phase 3 — lock check (cooperative, fail-open).\n    await acquireLock(ctx, sessionId, loaded.record);\n\n    // Phase 4 — window history.\n    const windowed = windowHistory(\n      ctx as OrchestratorEngineContext,\n      sessionId,\n      options.history,\n    );\n\n    // Phase 5 — dispatch. When memory is configured, recall the\n    // turn-relevant memories and inject them into the request-scoped\n    // context bag so every route / router / evaluate / dispatch callback\n    // surfaces them at `ctx.context[injectKey]` before routing runs.\n    const seedState = applyStatePatch(loaded.state, options.state);\n\n    let turnContext = options.context;\n\n    if (ctx.memory) {\n      const recalled = await recallForTurn(ctx.memory, input);\n      turnContext = injectMemories(turnContext, ctx.memory, recalled);\n    }\n\n    const { result, state, turnSnapshot } = await dispatchTurn<TOutput, TState>({\n      ctx,\n      sessionId,\n      input,\n      seedState,\n      turnIndex: loaded.turnIndex,\n      history: windowed.agents,\n      context: turnContext,\n      signal: options.signal,\n    });\n\n    ctx.emitter.emit(\"orchestrator.turn.routed\", {\n      sessionId,\n      turnIndex: loaded.turnIndex,\n      source: turnSnapshot.decision.source,\n      raw: turnSnapshot.decision.raw,\n    });\n\n    const status = result.error\n      ? deriveStatus(result.report.status)\n      : \"awaiting-input\";\n\n    // Cancelled / failed turns revert: no fresh checkpoint, no compaction.\n    if (result.error) {\n      const report = buildReport(\n        ctx as OrchestratorEngineContext,\n        sessionId,\n        loaded.turnIndex,\n        status,\n        turnSnapshot,\n        result.report,\n      );\n\n      emitTerminal(ctx as OrchestratorEngineContext, sessionId, loaded.turnIndex, status);\n\n      return {\n        data: result.data,\n        error: result.error,\n        usage: result.usage,\n        report,\n        sessionId,\n        turnIndex: loaded.turnIndex,\n      };\n    }\n\n    // Phase 6 — persist checkpoint.\n    await persistCheckpoint({\n      ctx,\n      sessionId,\n      turnIndex: loaded.turnIndex,\n      state,\n      lastRoute: summarizeRoute(turnSnapshot.decision.raw as never),\n      summarizedThrough: loaded.record?.summarized_through ?? null,\n    });\n\n    // Memory write-back (memory core M2). The turn settled cleanly (the\n    // `result.error` branch above already returned for cancelled /\n    // failed turns, which revert and never remember — §17), so remember\n    // the input + its outcome for later recall.\n    if (ctx.memory) {\n      await rememberTurnOutcome(\n        ctx.memory,\n        input,\n        outcomeTextFromTurn(result.data, turnSnapshot),\n      );\n    }\n\n    // Phase 7 — post-turn compaction (only when triggered).\n    let compaction: CompactionResult | undefined;\n\n    if (shouldCompact(ctx as OrchestratorEngineContext, loaded.turnIndex)) {\n      const outcome = await runCompaction(\n        ctx as OrchestratorEngineContext<unknown, TState>,\n        sessionId,\n        options.history,\n      );\n\n      if (outcome) {\n        compaction = outcome.compaction;\n\n        if (outcome.applied) {\n          await advanceSummarizedThrough(\n            ctx as OrchestratorEngineContext<unknown, TState>,\n            sessionId,\n            outcome.compaction.replacesToIndex,\n          );\n        }\n      }\n    }\n\n    const report = buildReport(\n      ctx as OrchestratorEngineContext,\n      sessionId,\n      loaded.turnIndex,\n      \"awaiting-input\",\n      turnSnapshot,\n      result.report,\n    );\n\n    emitTerminal(ctx as OrchestratorEngineContext, sessionId, loaded.turnIndex, \"awaiting-input\");\n\n    return {\n      data: result.data,\n      error: undefined,\n      usage: result.usage,\n      report,\n      sessionId,\n      turnIndex: loaded.turnIndex,\n      compaction,\n    };\n  } finally {\n    disposePerCall();\n  }\n}\n\n/**\n * After a framework-applied compaction (`onCompact` succeeded), advance\n * the persisted `summarized_through` to the compaction's\n * `replacesToIndex` (§12.2 step 4). Re-saves the latest row with the\n * updated marker (append-only stores keep the prior row).\n */\nasync function advanceSummarizedThrough<TState>(\n  ctx: OrchestratorEngineContext<unknown, TState>,\n  sessionId: string,\n  replacesToIndex: number,\n): Promise<void> {\n  const latest = await ctx.checkpointStore.load(ctx.config.name, sessionId);\n\n  if (!latest) {\n    return;\n  }\n\n  await ctx.checkpointStore.save({\n    ...latest,\n    summarized_through: replacesToIndex,\n    saved_at: new Date().toISOString(),\n  });\n}\n\n/**\n * §9 resume protocol entry the C1 factory's `resume()` delegates to.\n * Returns `null` when no in-flight `iterate: true` turn is detected;\n * otherwise drains the interrupted supervisor run, persists a fresh\n * checkpoint for the resumed turn, and returns the completed result.\n *\n * Runs the same Phase 2 drift check as `runTurn` (§9.4). The heavy\n * lifting lives in `resume.ts`; this wrapper threads the engine\n * context.\n */\nexport async function runResume<TOutput, TState>(\n  ctx: OrchestratorEngineContext<TOutput, TState>,\n  sessionId: string,\n  options?: OrchestratorResumeOptions,\n): Promise<OrchestratorResult<TOutput> | null> {\n  const disposePerCall = ctx.emitter.bindPerCall(options?.on);\n\n  try {\n    return await resolveResume(ctx, sessionId, options, {\n      assertNoDrift: (loadedSignature) =>\n        assertNoDrift(\n          ctx as OrchestratorEngineContext,\n          sessionId,\n          loadedSignature,\n          options?.force,\n        ),\n      buildReport: (turnIndex, status, turnSnapshot, childReport) =>\n        buildReport(\n          ctx as OrchestratorEngineContext,\n          sessionId,\n          turnIndex,\n          status,\n          turnSnapshot,\n          childReport,\n        ),\n      deriveStatus,\n      emitTerminal: (turnIndex, status) =>\n        emitTerminal(ctx as OrchestratorEngineContext, sessionId, turnIndex, status),\n      persist: (turnIndex, state, lastRoute, summarizedThrough) =>\n        persistCheckpoint({\n          ctx,\n          sessionId,\n          turnIndex,\n          state,\n          lastRoute,\n          summarizedThrough,\n        }),\n    });\n  } finally {\n    disposePerCall();\n  }\n}\n\n/**\n * The `stream()` entry. The orchestrator's streaming surface bubbles\n * child agent/supervisor events under their own namespace (§14.2); the\n * C1 stream controller owns the `StreamContract` wiring. This engine\n * entry runs the same lifecycle as `runTurn` — the C1 factory passes a\n * per-call `on` bag wired to the stream controller, so the engine needs\n * no streaming-specific branch. Exposed as a distinct name for the\n * factory to call, returning the same `OrchestratorResult` the stream's\n * `.result` resolves to.\n */\nexport async function streamTurn<TOutput, TState>(\n  ctx: OrchestratorEngineContext<TOutput, TState>,\n  input: SupervisorInput,\n  options: OrchestratorExecuteOptions<TState>,\n): Promise<OrchestratorResult<TOutput>> {\n  return runTurn(ctx, input, options);\n}\n\nexport type { OrchestratorEngineContext } from \"./engine-context.type\";\nexport type { Message };\n","import type { OrchestratorEvent } from \"../contracts/orchestrator/orchestrator-event.type\";\nimport type { StreamContract } from \"../contracts/stream/stream.contract\";\n\n/**\n * Internal async-queue controller driving `orchestrator.stream()`.\n * Mirrors {@link import(\"../supervisor/supervisor-stream\").createSupervisorStream}'s\n * controller — same producer/consumer pipe, parameterized by the\n * orchestrator event union and the terminal result type.\n *\n * The turn pushes events as it advances through the lifecycle phases,\n * then settles with `end(result)` (the same `OrchestratorResult` that\n * `execute()` resolves) or `fail(error)` on an authoring/drift throw.\n */\nexport type OrchestratorStreamController<TResult> = {\n  push(event: OrchestratorEvent): void;\n  end(result: TResult): void;\n  fail(error: Error): void;\n};\n\ntype PendingRead = {\n  resolve(value: IteratorResult<OrchestratorEvent>): void;\n  reject(error: Error): void;\n};\n\n/**\n * Factory mirroring `createSupervisorStream`. Returns a paired\n * `{ controller, stream }` — the turn pushes events into the controller\n * while the caller iterates (or awaits `.result`) on the stream side.\n *\n * The `result` promise resolves to the same `OrchestratorResult` value\n * `execute()` produces; it rejects only when the turn throws before\n * producing a result (drift / config misuse) — runtime failures ride on\n * `result.error` and still settle via `end()`.\n *\n * Child `supervisor.*` / `agent.*` events bubble through this same pipe\n * unmodified (the turn forwards them as it observes them on the\n * delegated run); they share the `{ type, ...payload }` shape with the\n * orchestrator's own events so iteration narrows uniformly on\n * `event.type`.\n */\nexport function createOrchestratorStream<TResult>(): {\n  controller: OrchestratorStreamController<TResult>;\n  stream: StreamContract<TResult, OrchestratorEvent>;\n} {\n  const queue: OrchestratorEvent[] = [];\n  const pending: PendingRead[] = [];\n  const handlers = new Map<string, (event: OrchestratorEvent) => void>();\n\n  let closed = false;\n  let failure: Error | undefined;\n  let resolveResult!: (value: TResult) => void;\n  let rejectResult!: (error: Error) => void;\n\n  const result = new Promise<TResult>((resolve, reject) => {\n    resolveResult = resolve;\n    rejectResult = reject;\n  });\n\n  const controller: OrchestratorStreamController<TResult> = {\n    push(event) {\n      const handler = handlers.get(event.type);\n\n      if (handler) {\n        try {\n          handler(event);\n        } catch {\n          // Stream handlers must never crash the orchestrator.\n        }\n      }\n\n      const reader = pending.shift();\n\n      if (reader) {\n        reader.resolve({ value: event, done: false });\n        return;\n      }\n\n      queue.push(event);\n    },\n\n    end(finalResult) {\n      closed = true;\n      resolveResult(finalResult);\n\n      while (pending.length > 0) {\n        pending.shift()?.resolve({ value: undefined, done: true });\n      }\n    },\n\n    fail(error) {\n      closed = true;\n      failure = error;\n      rejectResult(error);\n\n      while (pending.length > 0) {\n        pending.shift()?.reject(error);\n      }\n    },\n  };\n\n  const iterator: AsyncIterator<OrchestratorEvent> = {\n    next() {\n      if (queue.length > 0) {\n        return Promise.resolve({ value: queue.shift()!, done: false });\n      }\n\n      if (closed) {\n        if (failure) {\n          return Promise.reject(failure);\n        }\n\n        return Promise.resolve({ value: undefined, done: true });\n      }\n\n      return new Promise<IteratorResult<OrchestratorEvent>>(\n        (resolve, reject) => {\n          pending.push({ resolve, reject });\n        },\n      );\n    },\n  };\n\n  const stream = {\n    result,\n    on(handlerMap) {\n      for (const [key, handler] of Object.entries(handlerMap)) {\n        if (handler) {\n          handlers.set(key, handler as (event: OrchestratorEvent) => void);\n        }\n      }\n\n      return stream;\n    },\n    [Symbol.asyncIterator]() {\n      return iterator;\n    },\n  } as StreamContract<TResult, OrchestratorEvent>;\n\n  return { controller, stream };\n}\n","import type { OrchestratorConfig } from \"../contracts/orchestrator/orchestrator-config.type\";\nimport type { ResolvedIntentEntry } from \"../supervisor/entries\";\n\n/**\n * Shape of the `historyWindow` config a fingerprint records. A number\n * window is recorded as `\"number\"`; a callback window as `\"callback\"`;\n * an absent role as `null`. The window VALUE (the literal `5`, the\n * callback body) is deliberately excluded — only the structural choice\n * of windowing strategy per role drifts the signature (§10.1).\n */\ntype HistoryWindowRoleFingerprint = \"number\" | \"callback\" | null;\n\n/**\n * Deterministic structural fingerprint of an orchestrator definition\n * (orchestrator.md §10.1). Persisted on every checkpoint so Phase 2 can\n * refuse a turn when the live definition no longer matches the saved\n * session shape. Covers exactly the dispatch contract:\n *\n * - `name`.\n * - The `intents` map — each intent key + its resolved description +\n *   the underlying unit's stable identity (agent name, workflow name +\n *   signature, or a `\"callback\"` marker for dev-callback intents).\n *   Reuses the supervisor's resolved-entry fingerprinting verbatim.\n * - `route` callback presence (its body is code, not data).\n * - `router` agent identity when LLM routing is configured.\n * - `evaluate` callback presence.\n * - `initialAgent` when set.\n * - `maxIterations`.\n * - The `iterate` flag — flipping single-dispatch to delegated\n *   iteration is a semantic shape change.\n * - The `historyWindow` config SHAPE — which roles window and whether\n *   each is a number or a callback (not the window value itself).\n *\n * Does NOT cover (§10.1): `version` (metadata only), `systemPrompt`\n * text, logger config, store identities, event handlers, or callback\n * function bodies (callbacks fingerprint as their presence/`\"callback\"`\n * marker only). The orchestrator signature does NOT aggregate the\n * internal supervisor's signature — that is a per-run concern delegated\n * to `supervisor.resume()`'s own drift check on `iterate: true`.\n *\n * @example\n * const signature = computeOrchestratorSignature(config, resolvedEntries);\n * // \"1a2b3c4d\" — 8-char FNV-1a hex, stable across process restarts.\n */\nexport function computeOrchestratorSignature(\n  config: OrchestratorConfig<unknown>,\n  entries: Map<string, ResolvedIntentEntry>,\n): string {\n  const intentsFingerprint = [...entries.entries()]\n    .sort(([first], [second]) => first.localeCompare(second))\n    .map(([intent, entry]) => ({\n      k: intent,\n      d: entry.description,\n      u: fingerprintUnit(entry),\n    }));\n\n  const fingerprint = {\n    n: config.name,\n    a: intentsFingerprint,\n    r: resolveRouterName(config.router),\n    rc: config.route ? 1 : 0,\n    e: config.evaluate ? 1 : 0,\n    i: config.initialAgent ?? null,\n    m: config.maxIterations ?? null,\n    it: config.iterate ? 1 : 0,\n    hw: fingerprintHistoryWindow(config.historyWindow),\n  };\n\n  return hash(JSON.stringify(fingerprint));\n}\n\n/**\n * Router identity for the fingerprint. Accepts both the bare-agent\n * shorthand and the `{ agent, ... }` entry form, returning the agent's\n * name (or `null` when no router is configured). Mirrors the\n * supervisor's `resolveRouterName`.\n */\nfunction resolveRouterName(router: OrchestratorConfig<unknown>[\"router\"]): string | null {\n  if (!router) {\n    return null;\n  }\n\n  if (typeof (router as { execute?: unknown }).execute === \"function\") {\n    return (router as { name?: string }).name ?? null;\n  }\n\n  return (router as { agent?: { name?: string } }).agent?.name ?? null;\n}\n\n/**\n * Structural fingerprint of the `historyWindow` config. Records the\n * windowing strategy per role (`\"number\"` / `\"callback\"` / `null`) so a\n * dev swapping a fixed-size window for a token-counting callback drifts\n * the signature, while tuning the window value (e.g. `5` → `8`) does\n * not. The window value is a runtime knob, not a shape change.\n */\nfunction fingerprintHistoryWindow(\n  historyWindow: OrchestratorConfig<unknown>[\"historyWindow\"],\n): { router: HistoryWindowRoleFingerprint; agents: HistoryWindowRoleFingerprint } {\n  return {\n    router: fingerprintHistoryWindowRole(historyWindow?.router),\n    agents: fingerprintHistoryWindowRole(historyWindow?.agents),\n  };\n}\n\nfunction fingerprintHistoryWindowRole(\n  window: number | ((...args: never[]) => unknown) | undefined,\n): HistoryWindowRoleFingerprint {\n  if (window === undefined) {\n    return null;\n  }\n\n  if (typeof window === \"function\") {\n    return \"callback\";\n  }\n\n  return \"number\";\n}\n\n/**\n * Stable identity of one resolved intent's underlying unit. Agents\n * fingerprint by name; workflows by name + their own signature;\n * callbacks by a type marker only (their closure can't be hashed\n * deterministically, so drift covers add/remove/rename, not body\n * edits). Identical to the supervisor's `fingerprintUnit`.\n */\nfunction fingerprintUnit(entry: ResolvedIntentEntry): unknown {\n  if (entry.type === \"callback\") {\n    return { t: \"callback\" };\n  }\n\n  if (entry.type === \"workflow\") {\n    const workflow = entry.unit;\n    return { t: \"workflow\", n: workflow.name, s: workflow.signature };\n  }\n\n  return { t: \"agent\", n: entry.unit.name };\n}\n\n/**\n * FNV-1a 32-bit — the same hash `supervisor/signature.ts` and\n * `workflow/signature.ts` use. Deterministic, no crypto dependency,\n * cheap; signatures are 8-char hex.\n */\nfunction hash(input: string): string {\n  let h = 0x811c9dc5;\n\n  for (let i = 0; i < input.length; i++) {\n    h ^= input.charCodeAt(i);\n    h = (h + ((h << 1) + (h << 4) + (h << 7) + (h << 8) + (h << 24))) >>> 0;\n  }\n\n  return h.toString(16).padStart(8, \"0\");\n}\n","import type { OrchestratorConfig } from \"../contracts/orchestrator/orchestrator-config.type\";\nimport type {\n  OrchestratorEventHandler,\n  OrchestratorEventName,\n} from \"../contracts/orchestrator/orchestrator-event.type\";\nimport type {\n  OrchestratorAsToolOptions,\n  OrchestratorContract,\n} from \"../contracts/orchestrator/orchestrator.contract\";\nimport type { OrchestratorCommands } from \"../contracts/orchestrator/orchestrator-commands.type\";\nimport type {\n  OrchestratorExecuteOptions,\n  OrchestratorResumeOptions,\n} from \"../contracts/orchestrator/orchestrator-execute-options.type\";\nimport type { OrchestratorEvent } from \"../contracts/orchestrator/orchestrator-event.type\";\nimport type { OrchestratorResult } from \"../contracts/result/orchestrator-result.type\";\nimport type { StreamContract } from \"../contracts/stream/stream.contract\";\nimport type { SupervisorIntentValue } from \"../contracts/supervisor/intent-entry.type\";\nimport type { SupervisorInput } from \"../contracts/supervisor/supervisor-input.type\";\nimport { resolveDefaultSnapshotStore } from \"../config\";\nimport { OrchestratorConfigError } from \"../errors/orchestrator-config-error\";\nimport { resolveIntentEntries, type ResolvedIntentEntry } from \"../supervisor/entries\";\nimport { SupervisorFailedError } from \"../errors\";\nimport type { ToolContract } from \"../tool/tool\";\nimport { asTool as orchestratorAsTool } from \"./as-tool\";\nimport { createCommandDispatcher } from \"./commands\";\nimport { OrchestratorEmitter } from \"./emitter\";\nimport { OrchestratorExecution } from \"./execution\";\nimport { createOrchestratorStream } from \"./orchestrator-stream\";\nimport { computeOrchestratorSignature } from \"./signature\";\n\n/**\n * `ai.orchestrator(config)` — construct an {@link OrchestratorContract}:\n * a session-state manager wrapped around a supervisor (orchestrator.md\n * §1, §15). Validates the config at author time (throws\n * {@link OrchestratorConfigError} on bad shape), resolves the intent\n * entries, computes a stable structural signature for drift detection\n * (§10.1), wires the three-tier event emitter, and returns a handle that\n * runs one durable session turn per `execute` / `stream` call, resumes\n * an interrupted `iterate: true` turn via `resume`, and exposes typed\n * built-in commands plus an `asTool` wrapper.\n *\n * The \"what runs\" fields (`intents`, `route` / `router`, `evaluate`,\n * `state`, `output`, `initialAgent`, `maxIterations`) are the\n * supervisor's surface spread directly — the lifecycle builds the\n * supervisor lazily per turn and delegates to it (§3 Phase 5). Users\n * never see the supervisor object.\n *\n * @example\n * const supportBot = ai.orchestrator<SessionState>({\n *   name: \"refund-support\",\n *   intents: { classify, lookup, process, compose },\n *   route: (ctx) => (ctx.iteration === 0 ? \"classify\" : END),\n *   iterate: true,\n *   checkpointStore: ai.checkpoint.pg({ client: pg }),\n *   snapshotStore: ai.snapshot.pg({ client: pg }),\n * });\n *\n * const result = await supportBot.execute(message, { sessionId, history });\n */\nexport function orchestrator<\n  TOutput = unknown,\n  TState = TOutput,\n  TIntents extends Record<string, SupervisorIntentValue> = Record<\n    string,\n    SupervisorIntentValue\n  >,\n>(\n  config: OrchestratorConfig<TOutput, TState, TIntents>,\n): OrchestratorContract<TOutput, TState> {\n  validateFactoryConfig(config as unknown as OrchestratorConfig<unknown>);\n\n  const entries = resolveEntries(config as unknown as OrchestratorConfig<unknown>);\n\n  assertInitialAgent(config as unknown as OrchestratorConfig<unknown>, entries);\n\n  const signature = computeOrchestratorSignature(\n    config as unknown as OrchestratorConfig<unknown>,\n    entries,\n  );\n  const emitter = new OrchestratorEmitter(config.on);\n\n  async function execute(\n    input: SupervisorInput,\n    options: OrchestratorExecuteOptions<TState>,\n  ): Promise<OrchestratorResult<TOutput>> {\n    const execution = new OrchestratorExecution<TOutput, TState>({\n      config: config as unknown as OrchestratorConfig<TOutput, TState>,\n      entries,\n      signature,\n      emitter,\n      input,\n      options,\n    });\n\n    return execution.run();\n  }\n\n  function stream(\n    input: SupervisorInput,\n    options: OrchestratorExecuteOptions<TState>,\n  ): StreamContract<OrchestratorResult<TOutput>, OrchestratorEvent> {\n    const { controller, stream: contract } = createOrchestratorStream<\n      OrchestratorResult<TOutput>\n    >();\n\n    const execution = new OrchestratorExecution<TOutput, TState>({\n      config: config as unknown as OrchestratorConfig<TOutput, TState>,\n      entries,\n      signature,\n      emitter,\n      input,\n      options,\n      streamController: controller,\n    });\n\n    void execution.run();\n\n    return contract;\n  }\n\n  async function resume(\n    sessionId: string,\n    options?: OrchestratorResumeOptions,\n  ): Promise<OrchestratorResult<TOutput> | null> {\n    const execution = new OrchestratorExecution<TOutput, TState>({\n      config: config as unknown as OrchestratorConfig<TOutput, TState>,\n      entries,\n      signature,\n      emitter,\n      resumeSessionId: sessionId,\n      resumeOptions: options,\n    });\n\n    return execution.resume();\n  }\n\n  // The dispatcher owns command ROUTING only; the `compact` handler\n  // delegates to the shared compaction code path on the lifecycle engine\n  // (§11 / §12.2 — manual compact reuses the post-turn compaction path).\n  const command = createCommandDispatcher({\n    compact: (args: OrchestratorCommands[\"compact\"][\"args\"]) => {\n      const execution = new OrchestratorExecution<TOutput, TState>({\n        config: config as unknown as OrchestratorConfig<TOutput, TState>,\n        entries,\n        signature,\n        emitter,\n      });\n\n      return execution.compact(args);\n    },\n  });\n\n  const instance: OrchestratorContract<TOutput, TState> = {\n    name: config.name,\n    signature,\n    version: config.version,\n    execute,\n    stream,\n    resume,\n    command,\n    asTool<TToolInput = string>(\n      options: OrchestratorAsToolOptions<TToolInput>,\n    ): ToolContract<TToolInput, TOutput> {\n      return orchestratorAsTool<TOutput, TState, TToolInput>(instance, options);\n    },\n    on<K extends OrchestratorEventName>(\n      event: K,\n      handler: OrchestratorEventHandler<K>,\n    ): () => void {\n      return emitter.on(event, handler);\n    },\n    off<K extends OrchestratorEventName>(\n      event: K,\n      handler: OrchestratorEventHandler<K>,\n    ): void {\n      emitter.off(event, handler);\n    },\n  };\n\n  return instance;\n}\n\n/**\n * Author-time validation (orchestrator.md §17). Enforces the rules that\n * must fail at construction rather than on the first turn:\n *\n * - `name` present and a string.\n * - `intents` present.\n * - `route` XOR `router` (mutually exclusive; at least one required) —\n *   the supervisor's dispatch-source rule, surfaced as an orchestrator\n *   config error.\n * - `router` is a valid agent contract or `{ agent, ... }` entry.\n * - `maxIterations >= 1` when set.\n * - `snapshotStore` resolvable when `iterate: true` — explicit field or\n *   the global `ai.config({ defaultSnapshotStore })` fallback.\n *\n * `initialAgent` membership is checked separately once the intent\n * entries are resolved.\n */\nfunction validateFactoryConfig(config: OrchestratorConfig<unknown>): void {\n  if (!config.name || typeof config.name !== \"string\") {\n    throw new OrchestratorConfigError(\n      \"ai.orchestrator: `name` is required and must be a string\",\n      { context: { authoring: true } },\n    );\n  }\n\n  if (!config.intents || typeof config.intents !== \"object\") {\n    throw new OrchestratorConfigError(\n      `ai.orchestrator(\"${config.name}\"): \\`intents\\` is required`,\n      { context: { authoring: true } },\n    );\n  }\n\n  const hasRoute = typeof config.route === \"function\";\n  const hasRouter = Boolean(config.router);\n\n  if (hasRouter) {\n    const router = config.router;\n    const isBareAgent = typeof (router as { execute?: unknown }).execute === \"function\";\n    const isEntryForm =\n      !isBareAgent &&\n      typeof (router as { agent?: { execute?: unknown } }).agent === \"object\" &&\n      typeof (router as { agent?: { execute?: unknown } }).agent?.execute === \"function\";\n\n    if (!isBareAgent && !isEntryForm) {\n      throw new OrchestratorConfigError(\n        `ai.orchestrator(\"${config.name}\"): \\`router\\` must be an agent contract or a \\`{ agent, placeholders?, input? }\\` entry`,\n        { context: { authoring: true } },\n      );\n    }\n  }\n\n  if (hasRoute && hasRouter) {\n    throw new OrchestratorConfigError(\n      `ai.orchestrator(\"${config.name}\"): \\`route\\` and \\`router\\` are mutually exclusive — configure exactly one`,\n      { context: { authoring: true } },\n    );\n  }\n\n  if (!hasRoute && !hasRouter) {\n    throw new OrchestratorConfigError(\n      `ai.orchestrator(\"${config.name}\"): one of \\`route\\` or \\`router\\` is required`,\n      { context: { authoring: true } },\n    );\n  }\n\n  if (config.maxIterations !== undefined && config.maxIterations < 1) {\n    throw new OrchestratorConfigError(\n      `ai.orchestrator(\"${config.name}\"): \\`maxIterations\\` must be >= 1`,\n      { context: { authoring: true, maxIterations: config.maxIterations } },\n    );\n  }\n\n  if (config.iterate && !config.snapshotStore && !resolveDefaultSnapshotStore()) {\n    throw new OrchestratorConfigError(\n      `ai.orchestrator(\"${config.name}\"): \\`iterate: true\\` requires a \\`snapshotStore\\` (or \\`ai.config({ defaultSnapshotStore })\\`) for mid-turn resume`,\n      { context: { authoring: true } },\n    );\n  }\n}\n\n/**\n * Resolve the `intents` map into the supervisor's internal entry shape,\n * re-wrapping the supervisor's authoring failure as an\n * {@link OrchestratorConfigError} so misuse surfaces under the\n * orchestrator's error family rather than the supervisor's.\n */\nfunction resolveEntries(\n  config: OrchestratorConfig<unknown>,\n): Map<string, ResolvedIntentEntry> {\n  try {\n    return resolveIntentEntries(config.intents, config.name);\n  } catch (error) {\n    if (error instanceof SupervisorFailedError) {\n      throw new OrchestratorConfigError(error.message, {\n        context: { authoring: true },\n        cause: error,\n      });\n    }\n\n    throw error;\n  }\n}\n\n/**\n * Enforce the `initialAgent` membership rule (§17) once entries are\n * resolved — `initialAgent`, when set, must name a key in `intents`.\n */\nfunction assertInitialAgent(\n  config: OrchestratorConfig<unknown>,\n  entries: Map<string, ResolvedIntentEntry>,\n): void {\n  if (config.initialAgent && !entries.has(config.initialAgent)) {\n    throw new OrchestratorConfigError(\n      `ai.orchestrator(\"${config.name}\"): \\`initialAgent\\` \"${config.initialAgent}\" is not a key in \\`intents\\``,\n      { context: { authoring: true } },\n    );\n  }\n}\n","import type { PlannerCapability } from \"../contracts/planner/planner-capability.type\";\nimport type { SystemPromptContract } from \"../contracts/system-prompt.contract\";\n\n/**\n * Assemble the plan-generation system prompt: optional caller framing on\n * top, then the mechanical block listing every capability + its\n * description and the rules for emitting an ordered plan.\n *\n * Runs once at factory time (the capability set is fixed for the\n * planner's lifetime) — the produced string is baked onto the internal\n * planning agent.\n */\nexport function buildPlanSystemPrompt(\n  capabilities: PlannerCapability[],\n  maxSteps: number,\n  prefix: SystemPromptContract | string | undefined,\n): string {\n  const capabilityLines = capabilities.map(\n    (capability) => `- ${capability.name}: ${capability.description}`,\n  );\n\n  const sections: string[] = [];\n  const resolvedPrefix = resolvePrefix(prefix);\n\n  if (resolvedPrefix && resolvedPrefix.trim().length > 0) {\n    sections.push(resolvedPrefix.trim(), \"\");\n  }\n\n  sections.push(\n    \"You are a planner. Break the user's goal into an ordered sequence of steps,\",\n    \"each one dispatching exactly one of the available capabilities below.\",\n    \"\",\n    \"Available capabilities:\",\n    ...capabilityLines,\n    \"\",\n    \"Rules:\",\n    `- Produce at most ${maxSteps} steps.`,\n    \"- Each step's `capability` must be exactly one name from the list above.\",\n    \"- Each step's `input` is the concrete instruction passed to that capability.\",\n    \"- Order the steps so each builds on the outputs of the ones before it.\",\n    \"- Never invent a capability name that is not listed.\",\n    \"- Keep the plan minimal — only the steps actually needed to satisfy the goal.\",\n  );\n\n  return sections.join(\"\\n\");\n}\n\n/**\n * Resolve a caller-supplied `systemPrompt` (string or contract) to plain\n * text. Returns `undefined` when none was supplied.\n */\nfunction resolvePrefix(prompt: SystemPromptContract | string | undefined): string | undefined {\n  if (!prompt) {\n    return undefined;\n  }\n\n  return typeof prompt === \"string\" ? prompt : prompt.resolve();\n}\n","import type { StandardSchemaV1 } from \"@standard-schema/spec\";\nimport type { PlannerPlan, PlannerStep } from \"../contracts/planner/planner-plan.type\";\n\n/**\n * Build the Standard Schema the planning agent emits — an ordered\n * `{ steps: [...], summary? }` plan whose every step references one of\n * `capabilityNames` via the `capability` field.\n *\n * Mirrors the router's hand-built schema approach\n * (`supervisor/router-factory.ts`): the JSON Schema extension carries\n * the capability names as an `enum` so capable providers enforce the\n * choice natively, while `validate()` still accepts the shape softly so\n * providers without native structured output can pass a parsed object\n * through. Validation is intentionally lenient on `capability` — an\n * unknown name is surfaced later by the planner as a typed\n * `PlannerPlanInvalidError`, with the full forensic context, rather\n * than as an opaque schema issue here.\n *\n * `maxSteps`, when provided, is emitted as the `steps` array's\n * `maxItems` so capable providers refuse to over-produce up front\n * (the planner still truncates the tail to `skipped` defensively).\n */\nexport function planSchema(\n  capabilityNames: string[],\n  maxSteps?: number,\n): StandardSchemaV1<PlannerPlan> {\n  // OpenAI strict `json_schema` mode (and other native structured-output\n  // providers) require EVERY property to appear in `required` — with truly\n  // optional fields expressed as nullable — and reject array `minItems` /\n  // `maxItems`. So the schema is strict-shaped: all keys required, the\n  // optional ones nullable, no item-count bounds. A non-empty plan is\n  // enforced in `validate()`, and `maxSteps` by the runtime's tail\n  // truncation, so neither bound is needed on the wire.\n  void maxSteps;\n\n  const jsonSchema = {\n    type: \"object\",\n    properties: {\n      summary: {\n        type: [\"string\", \"null\"],\n        description: \"One-line summary of the overall strategy.\",\n      },\n      steps: {\n        type: \"array\",\n        description: \"Ordered steps to execute, one capability dispatch each.\",\n        items: stepItemsSchema(capabilityNames),\n      },\n    },\n    required: [\"summary\", \"steps\"],\n    additionalProperties: false,\n  };\n\n  return {\n    \"~standard\": {\n      version: 1,\n      vendor: \"warlock-planner\",\n      jsonSchema: {\n        input: () => jsonSchema,\n      },\n      validate(value: unknown): StandardSchemaV1.Result<PlannerPlan> {\n        if (!value || typeof value !== \"object\") {\n          return { issues: [{ message: \"plan must be an object\" }] };\n        }\n\n        const record = value as { steps?: unknown; summary?: unknown };\n\n        if (!Array.isArray(record.steps) || record.steps.length === 0) {\n          return { issues: [{ message: \"plan `steps` must be a non-empty array\" }] };\n        }\n\n        const steps: PlannerStep[] = [];\n\n        for (const raw of record.steps) {\n          const normalized = normalizeStep(raw);\n\n          if (!normalized) {\n            return {\n              issues: [{ message: \"each plan step must carry a string `capability` and `input`\" }],\n            };\n          }\n\n          steps.push(normalized);\n        }\n\n        const summary = typeof record.summary === \"string\" ? record.summary : undefined;\n\n        return { value: summary !== undefined ? { steps, summary } : { steps } };\n      },\n    } as StandardSchemaV1<PlannerPlan>[\"~standard\"] & {\n      jsonSchema: { input: () => Record<string, unknown> };\n    },\n  };\n}\n\n/** Per-step JSON Schema object — one capability dispatch. */\nfunction stepItemsSchema(capabilityNames: string[]): Record<string, unknown> {\n  return {\n    type: \"object\",\n    properties: {\n      id: {\n        type: [\"string\", \"null\"],\n        description: \"Stable step id, referenced by dependsOn.\",\n      },\n      capability: {\n        type: \"string\",\n        enum: capabilityNames,\n        description: \"Name of the capability to dispatch for this step.\",\n      },\n      input: {\n        type: \"string\",\n        description: \"Concrete input passed to the capability's execute().\",\n      },\n      reason: { type: [\"string\", \"null\"], description: \"Why this step exists.\" },\n      dependsOn: {\n        type: [\"array\", \"null\"],\n        items: { type: \"string\" },\n        description: \"Ids of steps this one conceptually follows.\",\n      },\n    },\n    // Strict mode: every property required; the genuinely-optional ones\n    // (id / reason / dependsOn) are nullable. `validate()` treats null and\n    // missing identically, so a model emitting `null` round-trips fine.\n    required: [\"id\", \"capability\", \"input\", \"reason\", \"dependsOn\"],\n    additionalProperties: false,\n  };\n}\n\n/**\n * Coerce one raw step object into a {@link PlannerStep}, returning\n * `undefined` when the mandatory `capability` / `input` strings are\n * missing. Optional fields are copied only when well-typed.\n */\nfunction normalizeStep(raw: unknown): PlannerStep | undefined {\n  if (!raw || typeof raw !== \"object\") {\n    return undefined;\n  }\n\n  const record = raw as {\n    id?: unknown;\n    capability?: unknown;\n    input?: unknown;\n    reason?: unknown;\n    dependsOn?: unknown;\n  };\n\n  if (typeof record.capability !== \"string\" || record.capability.length === 0) {\n    return undefined;\n  }\n\n  if (typeof record.input !== \"string\") {\n    return undefined;\n  }\n\n  const step: PlannerStep = {\n    capability: record.capability,\n    input: record.input,\n  };\n\n  if (typeof record.id === \"string\") {\n    step.id = record.id;\n  }\n\n  if (typeof record.reason === \"string\") {\n    step.reason = record.reason;\n  }\n\n  if (Array.isArray(record.dependsOn) && record.dependsOn.every((entry) => typeof entry === \"string\")) {\n    step.dependsOn = record.dependsOn as string[];\n  }\n\n  return step;\n}\n","import type { StandardSchemaV1 } from \"@standard-schema/spec\";\nimport type { AgentContract } from \"../contracts/agent/agent.contract\";\nimport type { PlannerCapability } from \"../contracts/planner/planner-capability.type\";\nimport type { PlannerConfig } from \"../contracts/planner/planner-config.type\";\nimport type { PlannerExecuteOptions } from \"../contracts/planner/planner-execute-options.type\";\nimport type { PlannerPlan, PlannerStep } from \"../contracts/planner/planner-plan.type\";\nimport type {\n  PlannerReport,\n  PlannerResult,\n  PlannerStepSnapshot,\n} from \"../contracts/planner/planner-result.type\";\nimport type { BaseReport } from \"../contracts/result/base-report.type\";\nimport { REPORT_SCHEMA_VERSION } from \"../contracts/result/base-report.type\";\nimport type { BaseResult } from \"../contracts/result/base-result.type\";\nimport type { Usage } from \"../contracts/result/usage.type\";\nimport { AIError } from \"../errors/ai-error\";\nimport { PlannerCancelledError } from \"../errors/planner-cancelled-error\";\nimport { PlannerFailedError } from \"../errors/planner-failed-error\";\nimport { PlannerPlanInvalidError } from \"../errors/planner-plan-invalid-error\";\nimport { SchemaValidationError } from \"../errors/schema-validation-error\";\nimport { accumulateCost } from \"../utils/compute-cost\";\nimport { generateRunId } from \"../utils/generate-run-id\";\nimport { stampReportLineage } from \"../utils/stamp-report-lineage\";\nimport { planSchema } from \"./plan-schema\";\n\n/**\n * Construction args for one {@link PlannerRun}. Carries everything the\n * factory resolved once (config, capability map, signature, planning\n * agent) plus the per-call goal and options.\n */\nexport type PlannerRunArgs<TOutput> = {\n  config: PlannerConfig<TOutput>;\n  capabilities: Map<string, PlannerCapability>;\n  maxSteps: number;\n  signature: string;\n  planningAgent: AgentContract<unknown>;\n  goal: string;\n  options?: PlannerExecuteOptions<TOutput>;\n};\n\n/**\n * Per-call orchestration state for one `planner.execute()` invocation.\n *\n * **Role.** Owns the full bounded-v1 planning lifecycle across four\n * phases that share mutable accumulators: (1) ask the LLM to GENERATE a\n * plan, (2) execute each plan step through its capability's `execute()`,\n * (3) optionally validate the final output, (4) assemble the unified\n * {@link PlannerResult}. Instantiated fresh per call inside the factory\n * so the accumulators (`usage`, `children`, `executedSteps`) are never\n * shared across runs. Unexported — callers only ever see the plain\n * {@link PlannerResult}.\n *\n * **Composition, not a fork.** Plan generation runs through a normal\n * `agent.execute()`; each step runs through the capability's own\n * `executable.execute()`. The planner adds the plan-generation brain and\n * the ordered-dispatch loop on top of the existing executable machinery —\n * it does not reimplement agent or step internals.\n */\nexport class PlannerRun<TOutput> {\n  private readonly runId: string;\n  private readonly startedAt = new Date().toISOString();\n  private readonly startPerf = performance.now();\n\n  private readonly usage: Usage = { input: 0, output: 0, total: 0 };\n  private readonly children: BaseReport[] = [];\n  private readonly executedSteps: PlannerStepSnapshot[] = [];\n\n  private plan?: PlannerPlan;\n  private data?: TOutput;\n  private error?: AIError;\n  private cancelledAt?: string;\n\n  public constructor(private readonly args: PlannerRunArgs<TOutput>) {\n    this.runId = args.options?.runId ?? generateRunId(\"planner\");\n  }\n\n  /**\n   * Run the planner end-to-end. Never throws on runtime failure —\n   * generation errors, plan-validity errors, step failures, and\n   * cancellation all surface on `result.error` with a narrowing\n   * `report.status`.\n   */\n  public async run(): Promise<PlannerResult<TOutput>> {\n    try {\n      if (this.isAborted()) {\n        this.markCancelled();\n        return this.buildResult();\n      }\n\n      const plan = await this.generatePlan();\n\n      if (this.error || !plan) {\n        return this.buildResult();\n      }\n\n      this.plan = plan;\n\n      await this.executePlan(plan);\n\n      await this.finalizeOutput();\n    } catch (caught) {\n      this.error = this.toAIError(caught);\n    }\n\n    return this.buildResult();\n  }\n\n  /**\n   * Phase 1 — ask the planning agent for a structured plan. The plan\n   * schema (built from the live capability names) is supplied as the\n   * agent's per-call `output`, so the model is steered to reference only\n   * real capabilities. The planning trip's usage + report roll into the\n   * planner's totals regardless of outcome.\n   */\n  private async generatePlan(): Promise<PlannerPlan | undefined> {\n    const schema = planSchema([...this.args.capabilities.keys()], this.args.maxSteps);\n\n    const result = await this.args.planningAgent.execute(this.buildPlanPrompt(), {\n      output: schema as StandardSchemaV1<unknown>,\n      placeholders: this.args.options?.placeholders,\n      signal: this.args.options?.signal,\n      sessionId: this.args.options?.sessionId,\n    });\n\n    this.absorb(result.usage, result.report);\n\n    if (result.error) {\n      // A schema rejection from the planning trip (e.g. an empty\n      // `steps` array tripping the plan schema) is really an invalid\n      // plan — re-wrap it into the typed planner contract so callers\n      // branch on `PlannerPlanInvalidError` rather than the agent's raw\n      // `SchemaValidationError`. Any other child error flows through\n      // unchanged.\n      this.error =\n        result.error instanceof SchemaValidationError\n          ? new PlannerPlanInvalidError(\n              `ai.planner(\"${this.args.config.name}\"): the planner produced no usable plan`,\n              { cause: result.error, context: { runId: this.runId } },\n            )\n          : result.error;\n      return undefined;\n    }\n\n    const plan = result.data as PlannerPlan | undefined;\n\n    if (!plan || !Array.isArray(plan.steps) || plan.steps.length === 0) {\n      this.error = new PlannerPlanInvalidError(\n        `ai.planner(\"${this.args.config.name}\"): the planner produced no usable plan`,\n        { context: { runId: this.runId } },\n      );\n      return undefined;\n    }\n\n    const unknownStep = plan.steps.find((step) => !this.args.capabilities.has(step.capability));\n\n    if (unknownStep) {\n      this.error = new PlannerPlanInvalidError(\n        `ai.planner(\"${this.args.config.name}\"): plan references unknown capability \"${unknownStep.capability}\"`,\n        { context: { runId: this.runId, capability: unknownStep.capability } },\n      );\n      return undefined;\n    }\n\n    return plan;\n  }\n\n  /**\n   * Phase 2 — execute the plan's steps strictly in order, threading each\n   * completed step's output into the next step's input context. Stops at\n   * the first step failure (its `error` becomes the run error) or when\n   * the abort signal fires between steps. Steps beyond `maxSteps` are\n   * recorded as `skipped` without running.\n   */\n  private async executePlan(plan: PlannerPlan): Promise<void> {\n    const previousOutputs: string[] = [];\n\n    for (let index = 0; index < plan.steps.length; index++) {\n      const step = plan.steps[index] as PlannerStep;\n\n      if (index >= this.args.maxSteps) {\n        this.recordSkipped(index, step);\n        continue;\n      }\n\n      if (this.isAborted()) {\n        this.markCancelled();\n        this.recordSkipped(index, step);\n        continue;\n      }\n\n      const completed = await this.executeStep(index, step, previousOutputs);\n\n      if (!completed) {\n        // Step failed — record the remaining steps as skipped so the\n        // report still describes the whole intended plan, then stop.\n        for (let rest = index + 1; rest < plan.steps.length; rest++) {\n          this.recordSkipped(rest, plan.steps[rest] as PlannerStep);\n        }\n        return;\n      }\n    }\n  }\n\n  /**\n   * Dispatch one plan step through its capability's `executable.execute()`\n   * and fold the outcome into the accumulators. Returns `true` when the\n   * step completed, `false` when it failed (setting the run error).\n   */\n  private async executeStep(\n    index: number,\n    step: PlannerStep,\n    previousOutputs: string[],\n  ): Promise<boolean> {\n    const capability = this.args.capabilities.get(step.capability) as PlannerCapability;\n    const stepStart = performance.now();\n    const startedAt = new Date().toISOString();\n    const input = this.composeStepInput(step, previousOutputs);\n\n    const result = await capability.executable.execute(input, {\n      signal: this.args.options?.signal,\n      sessionId: this.args.options?.sessionId,\n    });\n\n    const childReport = \"report\" in result ? (result.report as BaseReport) : undefined;\n    this.absorb(result.usage, childReport);\n\n    const output = this.extractOutput(result);\n    const failed = result.error !== undefined;\n\n    this.executedSteps.push({\n      index,\n      step,\n      status: failed ? \"failed\" : \"completed\",\n      output: failed ? undefined : output,\n      error: result.error,\n      startedAt,\n      endedAt: new Date().toISOString(),\n      duration: performance.now() - stepStart,\n      usage: result.usage,\n      childReport,\n    });\n\n    if (failed) {\n      this.error = result.error;\n      return false;\n    }\n\n    previousOutputs.push(this.stringifyOutput(step.capability, output));\n    this.data = output as TOutput;\n\n    return true;\n  }\n\n  /**\n   * Phase 3 — when an `output` schema is configured (factory or per-call\n   * override), validate the final completed step's output into typed\n   * `result.data`. A validation failure replaces the run error and flips\n   * the status to failed.\n   */\n  private async finalizeOutput(): Promise<void> {\n    const schema = this.args.options?.output ?? this.args.config.output;\n\n    if (!schema || this.error) {\n      return;\n    }\n\n    if (this.data === undefined) {\n      // An `output` schema is configured but the final completed step\n      // produced nothing to validate — returning `{ data: undefined,\n      // error: undefined, status: \"completed\" }` would be a silent\n      // contract violation. Surface it as an invalid plan instead.\n      this.error = new PlannerPlanInvalidError(\n        `ai.planner(\"${this.args.config.name}\"): plan completed without producing output for the configured \\`output\\` schema`,\n        { context: { runId: this.runId } },\n      );\n      return;\n    }\n\n    const validation = await schema[\"~standard\"].validate(this.data);\n\n    if (validation.issues) {\n      this.error = new PlannerPlanInvalidError(\n        `ai.planner(\"${this.args.config.name}\"): final output failed validation`,\n        {\n          context: {\n            runId: this.runId,\n            issues: validation.issues.map((issue) => issue.message),\n          },\n        },\n      );\n      this.data = undefined;\n      return;\n    }\n\n    this.data = validation.value as TOutput;\n  }\n\n  /**\n   * Phase 4 — fold the accumulators into the planner's own\n   * {@link PlannerReport} node and the final {@link PlannerResult}, then\n   * stamp lineage across the whole subtree so every child shares this\n   * run's root id.\n   */\n  private buildResult(): PlannerResult<TOutput> {\n    const status = this.resolveStatus();\n\n    const report: PlannerReport = {\n      runId: this.runId,\n      rootRunId: this.runId,\n      name: this.args.config.name,\n      version: this.args.config.version,\n      type: \"planner\",\n      status,\n      startedAt: this.startedAt,\n      endedAt: new Date().toISOString(),\n      duration: performance.now() - this.startPerf,\n      usage: this.usage,\n      children: this.children,\n      signature: this.args.signature,\n      plan: this.plan,\n      executedSteps: this.executedSteps,\n      cancelledAt: this.cancelledAt,\n      reportSchemaVersion: REPORT_SCHEMA_VERSION,\n    };\n\n    stampReportLineage(report, {\n      rootRunId: this.runId,\n      sessionId: this.args.options?.sessionId,\n    });\n\n    return {\n      type: \"planner\",\n      data: this.error ? undefined : this.data,\n      error: this.error,\n      usage: this.usage,\n      report,\n    };\n  }\n\n  /**\n   * Resolve the terminal status from the accumulated outcome. Cancelled\n   * wins over failed (an abort that also produced a step error still\n   * reads as cancelled); failed wins over completed.\n   */\n  private resolveStatus(): PlannerReport[\"status\"] {\n    if (this.cancelledAt !== undefined) {\n      return \"cancelled\";\n    }\n\n    if (this.error) {\n      return \"failed\";\n    }\n\n    return \"completed\";\n  }\n\n  /** Build the prompt handed to the planning agent — the user's goal. */\n  private buildPlanPrompt(): string {\n    return this.args.goal;\n  }\n\n  /**\n   * Compose a step's effective input: the step's own `input`, prefixed\n   * with a compact digest of every prior step's output so a downstream\n   * capability can build on what ran before it. No prior output → the\n   * step's raw input.\n   */\n  private composeStepInput(step: PlannerStep, previousOutputs: string[]): string {\n    if (previousOutputs.length === 0) {\n      return step.input;\n    }\n\n    return [\n      \"Context from earlier steps:\",\n      ...previousOutputs,\n      \"\",\n      `Task: ${step.input}`,\n    ].join(\"\\n\");\n  }\n\n  /**\n   * Pull the usable output off a capability's result. Prefers structured\n   * `data` (agents/workflows with an `output` schema, tools), and falls\n   * back to an agent's raw `text` when no structured data was produced —\n   * the common case for a plain text-producing capability agent.\n   */\n  private extractOutput(result: BaseResult): unknown {\n    const shaped = result as { data?: unknown; text?: unknown };\n\n    if (shaped.data !== undefined) {\n      return shaped.data;\n    }\n\n    if (typeof shaped.text === \"string\") {\n      return shaped.text;\n    }\n\n    return undefined;\n  }\n\n  /** Serialize a capability output into a single context line for the next step. */\n  private stringifyOutput(capability: string, output: unknown): string {\n    if (output === undefined) {\n      return `- ${capability}: (no output)`;\n    }\n\n    if (typeof output === \"string\") {\n      return `- ${capability}: ${output}`;\n    }\n\n    return `- ${capability}: ${JSON.stringify(output)}`;\n  }\n\n  /** Push a `skipped` snapshot for a step the planner never dispatched. */\n  private recordSkipped(index: number, step: PlannerStep): void {\n    const now = new Date().toISOString();\n\n    this.executedSteps.push({\n      index,\n      step,\n      status: \"skipped\",\n      startedAt: now,\n      endedAt: now,\n      duration: 0,\n      usage: { input: 0, output: 0, total: 0 },\n    });\n  }\n\n  /** Fold a child's usage + report node into the planner's accumulators. */\n  private absorb(usage: Usage, report: BaseReport | undefined): void {\n    this.mergeUsage(this.usage, usage);\n\n    if (report) {\n      this.children.push(report);\n    }\n  }\n\n  /**\n   * Add a child's usage into the running total. Mirrors the batch\n   * primitive's rollup: scalar token channels sum directly, optional\n   * sub-channels accumulate only when reported, and the cost breakdown\n   * merges via {@link accumulateCost} so one unpriced child can't erase\n   * priced siblings.\n   */\n  private mergeUsage(target: Usage, child: Usage): void {\n    target.input += child.input;\n    target.output += child.output;\n    target.total += child.total;\n\n    if (child.cachedTokens !== undefined) {\n      target.cachedTokens = (target.cachedTokens ?? 0) + child.cachedTokens;\n    }\n\n    if (child.reasoningTokens !== undefined) {\n      target.reasoningTokens = (target.reasoningTokens ?? 0) + child.reasoningTokens;\n    }\n\n    if (child.cacheWriteTokens !== undefined) {\n      target.cacheWriteTokens = (target.cacheWriteTokens ?? 0) + child.cacheWriteTokens;\n    }\n\n    const mergedCost = accumulateCost(target.cost, child.cost);\n\n    if (mergedCost !== undefined) {\n      target.cost = mergedCost;\n    }\n  }\n\n  /** Whether the caller's abort signal has fired. */\n  private isAborted(): boolean {\n    return this.args.options?.signal?.aborted === true;\n  }\n\n  /** Record a cancellation observation, setting the run error once. */\n  private markCancelled(): void {\n    if (this.cancelledAt !== undefined) {\n      return;\n    }\n\n    this.cancelledAt = new Date().toISOString();\n\n    const reason = this.args.options?.signal?.reason;\n\n    this.error = new PlannerCancelledError(\n      `ai.planner(\"${this.args.config.name}\"): run cancelled`,\n      {\n        cancelledAt: this.cancelledAt,\n        reason: typeof reason === \"string\" ? reason : undefined,\n        context: { runId: this.runId },\n      },\n    );\n  }\n\n  /** Normalize any thrown value into a typed {@link AIError}. */\n  private toAIError(caught: unknown): AIError {\n    if (caught instanceof AIError) {\n      return caught;\n    }\n\n    const message = caught instanceof Error ? caught.message : String(caught);\n\n    return new PlannerFailedError(`ai.planner(\"${this.args.config.name}\"): ${message}`, {\n      cause: caught,\n      context: { runId: this.runId },\n    });\n  }\n}\n","import type { PlannerCapability } from \"../contracts/planner/planner-capability.type\";\n\n/**\n * Delimiter between capability names in a planner signature. A NUL\n * control character can never appear in a real capability name, so it\n * keeps name boundaries unambiguous — a single capability literally\n * named `\"a,b\"` can never collide with the two capabilities\n * `[\"a\", \"b\"]` (a comma delimiter would render both as `caps:a,b`).\n */\nconst CAPABILITY_DELIMITER = String.fromCharCode(0);\n\n/**\n * Compute a stable structural fingerprint for a planner definition —\n * the planner name plus its ordered capability names. Stamped on every\n * report node the planner produces so trace consumers can tell runs of\n * structurally-different planners apart even when they share a name.\n *\n * Deliberately coarse: it captures WHICH capabilities the planner can\n * dispatch (and in what registration order), not their descriptions or\n * the underlying executables' internals — those don't change the set of\n * plans the planner can produce.\n */\nexport function computeSignature(name: string, capabilities: PlannerCapability[]): string {\n  const capabilityNames = capabilities\n    .map((capability) => capability.name)\n    .join(CAPABILITY_DELIMITER);\n\n  return `planner:${name}|caps:${capabilityNames}`;\n}\n","import { log } from \"@warlock.js/logger\";\nimport { agent } from \"../agent/agent\";\nimport type { AgentContract } from \"../contracts/agent/agent.contract\";\nimport type { PlannerCapability } from \"../contracts/planner/planner-capability.type\";\nimport type { PlannerConfig } from \"../contracts/planner/planner-config.type\";\nimport type { PlannerExecuteOptions } from \"../contracts/planner/planner-execute-options.type\";\nimport type { PlannerResult } from \"../contracts/planner/planner-result.type\";\nimport type { PlannerContract } from \"../contracts/planner/planner.contract\";\nimport { PlannerFailedError } from \"../errors\";\nimport { buildPlanSystemPrompt } from \"./plan-prompt\";\nimport { PlannerRun } from \"./planner-run\";\nimport { computeSignature } from \"./signature\";\n\nconst LOG_MODULE = \"ai.planner\";\n\n/**\n * `ai.planner(config)` — construct a {@link PlannerContract}.\n *\n * Validates the config at author time (throws {@link PlannerFailedError}\n * on a bad shape), builds (or adopts) the plan-generation agent, computes\n * a stable structural signature, and returns an instance satisfying\n * `ExecutableContract` so the planner composes into supervisors,\n * orchestrators, and outer agents through the same uniform surface.\n *\n * At `execute(goal)` the planner asks its LLM for an ordered plan over\n * the registered `capabilities`, then executes that plan step-by-step\n * through each capability's own `execute()` — reusing the existing\n * executable machinery rather than forking it — and returns the unified\n * `{ data, report, usage, error }` envelope with `report.type ===\n * \"planner\"`.\n *\n * @example\n * const research = ai.planner({\n *   name: \"research-assistant\",\n *   model: ai.openai.model({ name: \"gpt-4o\" }),\n *   capabilities: [\n *     { name: \"search\", description: \"Search the web\", executable: searchAgent },\n *     { name: \"write\", description: \"Draft a summary\", executable: writerAgent },\n *   ],\n *   maxSteps: 6,\n * });\n *\n * const { data, report } = await research.execute(\"Compare React vs Vue in 2026\");\n */\nexport function planner<TOutput = unknown>(\n  config: PlannerConfig<TOutput>,\n): PlannerContract<TOutput> {\n  validateConfig(config);\n\n  const maxSteps = config.maxSteps ?? 10;\n  const capabilities = new Map<string, PlannerCapability>();\n\n  for (const capability of config.capabilities) {\n    capabilities.set(capability.name, capability);\n  }\n\n  const signature = computeSignature(config.name, config.capabilities);\n  const planningAgent = resolvePlanningAgent(config, maxSteps);\n\n  async function execute(\n    goal: string,\n    options?: PlannerExecuteOptions<TOutput>,\n  ): Promise<PlannerResult<TOutput>> {\n    log.debug(LOG_MODULE, \"execute\", \"Planner run starting\", {\n      name: config.name,\n      capabilities: capabilities.size,\n    });\n\n    return new PlannerRun<TOutput>({\n      config,\n      capabilities,\n      maxSteps,\n      signature,\n      planningAgent,\n      goal,\n      options,\n    }).run();\n  }\n\n  return {\n    name: config.name,\n    signature,\n    execute,\n  };\n}\n\n/**\n * Resolve the plan-generation agent: either adopt the dev's `planner`\n * agent, or build an internal one from `model` with the generated\n * plan-system-prompt baked on. The plan output schema is supplied\n * per-call in {@link PlannerRun}, so it isn't baked here.\n *\n * **`maxSteps` and BYO planners.** In `model` mode the cap is woven\n * into the generated plan-system-prompt *and* the per-call plan schema\n * (`steps.maxItems`). In `planner` (BYO) mode the dev owns the prompt,\n * so the cap is communicated only through that same per-call schema —\n * and, regardless of mode, {@link PlannerRun} truncates any over-long\n * plan to `skipped` at execution time, so the cap is always enforced.\n */\nfunction resolvePlanningAgent<TOutput>(\n  config: PlannerConfig<TOutput>,\n  maxSteps: number,\n): AgentContract<unknown> {\n  if (config.planner) {\n    return config.planner;\n  }\n\n  const systemPrompt = buildPlanSystemPrompt(config.capabilities, maxSteps, config.systemPrompt);\n\n  return agent({\n    name: `${config.name}-planner`,\n    description: \"Generates an ordered execution plan over the planner's capabilities.\",\n    model: config.model!,\n    systemPrompt,\n    maxTrips: 1,\n  });\n}\n\n/**\n * Factory-time validation. Surfaces every violation as a typed\n * {@link PlannerFailedError} tagged `authoring: true`, mirroring the\n * supervisor/orchestrator authoring-error convention.\n */\nfunction validateConfig<TOutput>(config: PlannerConfig<TOutput>): void {\n  if (!config.name || typeof config.name !== \"string\") {\n    throw new PlannerFailedError(\"ai.planner: `name` is required and must be a string\", {\n      context: { authoring: true },\n    });\n  }\n\n  const hasModel = config.model !== undefined;\n  const hasPlanner = config.planner !== undefined;\n\n  if (!hasModel && !hasPlanner) {\n    throw new PlannerFailedError(\n      `ai.planner(\"${config.name}\"): one of \\`model\\` or \\`planner\\` is required`,\n      { context: { authoring: true } },\n    );\n  }\n\n  if (hasModel && hasPlanner) {\n    throw new PlannerFailedError(\n      `ai.planner(\"${config.name}\"): \\`model\\` and \\`planner\\` are mutually exclusive — configure exactly one`,\n      { context: { authoring: true } },\n    );\n  }\n\n  if (!Array.isArray(config.capabilities) || config.capabilities.length === 0) {\n    throw new PlannerFailedError(\n      `ai.planner(\"${config.name}\"): at least one capability is required`,\n      { context: { authoring: true } },\n    );\n  }\n\n  const seen = new Set<string>();\n\n  for (const capability of config.capabilities) {\n    if (!capability || typeof capability.name !== \"string\" || capability.name.length === 0) {\n      throw new PlannerFailedError(\n        `ai.planner(\"${config.name}\"): every capability needs a non-empty \\`name\\``,\n        { context: { authoring: true } },\n      );\n    }\n\n    if (typeof capability.description !== \"string\" || capability.description.length === 0) {\n      throw new PlannerFailedError(\n        `ai.planner(\"${config.name}\"): capability \"${capability.name}\" needs a \\`description\\``,\n        { context: { authoring: true } },\n      );\n    }\n\n    if (!capability.executable || typeof capability.executable.execute !== \"function\") {\n      throw new PlannerFailedError(\n        `ai.planner(\"${config.name}\"): capability \"${capability.name}\" needs an \\`executable\\` with an execute() method`,\n        { context: { authoring: true } },\n      );\n    }\n\n    if (seen.has(capability.name)) {\n      throw new PlannerFailedError(\n        `ai.planner(\"${config.name}\"): duplicate capability name \"${capability.name}\"`,\n        { context: { authoring: true } },\n      );\n    }\n\n    seen.add(capability.name);\n  }\n\n  if (config.maxSteps !== undefined && config.maxSteps < 1) {\n    throw new PlannerFailedError(`ai.planner(\"${config.name}\"): \\`maxSteps\\` must be >= 1`, {\n      context: { authoring: true, maxSteps: config.maxSteps },\n    });\n  }\n}\n","import type { SnapshotStore } from \"../contracts/orchestrator/snapshot-store.contract\";\nimport type { SupervisorSnapshot } from \"../contracts/supervisor/supervisor-snapshot.type\";\n\n/**\n * In-memory {@link SnapshotStore} — supervisor run snapshots held in a\n * process-local `Map`, keyed by `runId`, never persisted to disk.\n *\n * Owns: the `runId` → {@link SupervisorSnapshot} mapping for\n * `iterate: true` mid-turn resume. Does NOT own: durability,\n * cross-process sharing, or TTL eviction — it is the zero-config\n * default for dev, tests, and single-process apps. Reach for\n * `ai.snapshot.pg()` / `ai.snapshot.redis()` (Phase 2) when a crashed\n * process must resume an in-flight turn.\n *\n * Front it with the {@link memory} factory — callers never `new` it.\n */\nclass MemorySnapshotStore<TSnapshot extends { runId: string }>\n  implements SnapshotStore<TSnapshot>\n{\n  /** Snapshots keyed by `runId`. */\n  private readonly snapshots = new Map<string, TSnapshot>();\n\n  /**\n   * Return the snapshot for a `runId`, or `undefined` when no in-flight\n   * run is recorded.\n   */\n  public async load(runId: string): Promise<TSnapshot | undefined> {\n    return this.snapshots.get(runId);\n  }\n\n  /**\n   * Persist a snapshot, keyed by its own `runId`. Overwrites any prior\n   * snapshot for the same run — a run has exactly one live snapshot.\n   */\n  public async save(snapshot: TSnapshot): Promise<void> {\n    this.snapshots.set(snapshot.runId, snapshot);\n  }\n\n  /**\n   * Drop the snapshot for a `runId`.\n   */\n  public async delete(runId: string): Promise<void> {\n    this.snapshots.delete(runId);\n  }\n\n  /**\n   * List the known run ids, optionally filtered by a prefix.\n   */\n  public async list(prefix?: string): Promise<string[]> {\n    const runIds: string[] = [];\n\n    for (const runId of this.snapshots.keys()) {\n      if (prefix !== undefined && !runId.startsWith(prefix)) {\n        continue;\n      }\n\n      runIds.push(runId);\n    }\n\n    return runIds;\n  }\n\n  /**\n   * The memory store has no backing table — there is nothing to\n   * migrate. Returns an empty string so callers can treat `schema()`\n   * uniformly across drivers.\n   */\n  public schema(): string {\n    return \"\";\n  }\n}\n\n/**\n * Create an in-memory {@link SnapshotStore}. Zero-config — no client,\n * no connection. Suitable for dev, tests, and single-process apps that\n * don't need to resume an interrupted `iterate: true` turn across\n * restarts.\n *\n * @example\n * import { ai } from \"@warlock.js/ai\";\n *\n * const orchestrator = ai.orchestrator({\n *   name: \"support\",\n *   intents: { ... },\n *   iterate: true,\n *   snapshotStore: ai.snapshot.memory(),\n * });\n */\nexport function memory<\n  TSnapshot extends { runId: string } = SupervisorSnapshot,\n>(): SnapshotStore<TSnapshot> {\n  return new MemorySnapshotStore<TSnapshot>();\n}\n","import type {\n  PgClientLike,\n  SnapshotStore,\n} from \"../contracts/orchestrator/snapshot-store.contract\";\nimport type { SupervisorSnapshot } from \"../contracts/supervisor/supervisor-snapshot.type\";\n\n/**\n * Default backing table for the pg snapshot store. Matches the name used\n * in the orchestrator.md §8 reference wiring\n * (`ai.snapshot.pg({ client, table: \"warlock_supervisor_snapshots\" })`).\n */\nconst DEFAULT_TABLE = \"warlock_supervisor_snapshots\";\n\n/**\n * Allowed characters in a Postgres identifier (table name). The\n * conservative ASCII subset; anything else is rejected because the table\n * name is interpolated directly into DDL/DML, and an arbitrary string\n * there would be a SQL-injection footgun. Mirrors `@warlock.js/cache`'s\n * `PgCacheDriver`.\n */\nconst SAFE_IDENTIFIER = /^[A-Za-z_][A-Za-z0-9_]*$/;\n\n/**\n * Options for {@link pg}. The `client` is an already-built `pg.Pool` /\n * `pg.Client` (anything satisfying {@link PgClientLike}); the store never\n * opens or closes it — connection lifecycle stays with the caller.\n */\nexport type PgSnapshotStoreOptions = {\n  /** Pre-built pg client. The store only ever calls `query`. */\n  client: PgClientLike;\n  /** Table name. Defaults to `warlock_supervisor_snapshots`. */\n  table?: string;\n};\n\n/**\n * Validate and resolve the table name. Throws on an unsafe identifier so\n * the failure surfaces at construction time, not on the first query.\n */\nfunction resolveTable(table: string | undefined): string {\n  const resolved = table ?? DEFAULT_TABLE;\n\n  if (!SAFE_IDENTIFIER.test(resolved)) {\n    throw new Error(\n      `Pg snapshot store: invalid table name '${resolved}'. Allowed: [A-Za-z_][A-Za-z0-9_]*.`,\n    );\n  }\n\n  return resolved;\n}\n\n/**\n * Coerce a `payload` column value back into a {@link SupervisorSnapshot}.\n * node-postgres parses `JSONB` into a JS value already, but some pool\n * wrappers hand back the raw string — be defensive across both.\n */\nfunction parsePayload(payload: unknown): SupervisorSnapshot {\n  if (typeof payload === \"string\") {\n    return JSON.parse(payload) as SupervisorSnapshot;\n  }\n\n  return payload as SupervisorSnapshot;\n}\n\n/**\n * Postgres {@link SnapshotStore} — supervisor run snapshots persisted to a\n * single row per `runId` in a dev-provisioned table (orchestrator.md §8).\n *\n * Owns: durable round-tripping of the {@link SupervisorSnapshot} envelope\n * keyed by `runId`, so a crashed mid-turn `iterate: true` iteration can\n * resume after a restart. Does NOT own: the connection (the caller passes\n * a live `pg.Pool`/`pg.Client` and keeps owning its lifecycle) or schema\n * migration ({@link PgSnapshotStore.schema} returns DDL the dev runs\n * themselves — the framework never auto-migrates, §8.5).\n *\n * Unlike the append-only checkpoint store, a run has exactly one live\n * snapshot, so `save()` upserts on the `run_id` primary key.\n *\n * Front it with the {@link pg} factory — callers never `new` it.\n */\nclass PgSnapshotStore implements SnapshotStore {\n  /** The user-supplied pg client. The store only ever calls `query`. */\n  private readonly client: PgClientLike;\n\n  /** Validated, resolved table name. Safe to interpolate into SQL. */\n  private readonly table: string;\n\n  public constructor(options: PgSnapshotStoreOptions) {\n    if (!options || !options.client || typeof options.client.query !== \"function\") {\n      throw new Error(\n        \"Pg snapshot store requires a 'client' option implementing { query(text, params) } — pass a pg.Pool or pg.Client.\",\n      );\n    }\n\n    this.client = options.client;\n    this.table = resolveTable(options.table);\n  }\n\n  /**\n   * Load the snapshot for a `runId`, or `undefined` when no in-flight run\n   * is recorded.\n   */\n  public async load(runId: string): Promise<SupervisorSnapshot | undefined> {\n    const { rows } = await this.client.query(\n      `SELECT payload FROM ${this.table} WHERE run_id = $1`,\n      [runId],\n    );\n\n    if (rows.length === 0) {\n      return undefined;\n    }\n\n    return parsePayload((rows[0] as { payload: unknown }).payload);\n  }\n\n  /**\n   * Persist a snapshot, keyed by its own `runId`. Upserts — a run has\n   * exactly one live snapshot, so a second save for the same `runId`\n   * overwrites the payload rather than appending.\n   */\n  public async save(snapshot: SupervisorSnapshot): Promise<void> {\n    await this.client.query(\n      `INSERT INTO ${this.table} (run_id, payload, saved_at)\n       VALUES ($1, $2::jsonb, now())\n       ON CONFLICT (run_id) DO UPDATE\n         SET payload = EXCLUDED.payload,\n             saved_at = EXCLUDED.saved_at`,\n      [snapshot.runId, JSON.stringify(snapshot)],\n    );\n  }\n\n  /**\n   * Drop the snapshot for a `runId`.\n   */\n  public async delete(runId: string): Promise<void> {\n    await this.client.query(`DELETE FROM ${this.table} WHERE run_id = $1`, [\n      runId,\n    ]);\n  }\n\n  /**\n   * List the known run ids, optionally filtered by a prefix. The `_` and\n   * `%` LIKE wildcards in the prefix are escaped so an opaque runId that\n   * happens to contain them is matched literally.\n   */\n  public async list(prefix?: string): Promise<string[]> {\n    if (prefix === undefined) {\n      const { rows } = await this.client.query(\n        `SELECT run_id FROM ${this.table}`,\n      );\n\n      return rows.map((row) => (row as { run_id: string }).run_id);\n    }\n\n    const escaped = prefix\n      .replace(/\\\\/g, \"\\\\\\\\\")\n      .replace(/_/g, \"\\\\_\")\n      .replace(/%/g, \"\\\\%\");\n\n    const { rows } = await this.client.query(\n      `SELECT run_id FROM ${this.table} WHERE run_id LIKE $1 ESCAPE '\\\\'`,\n      [`${escaped}%`],\n    );\n\n    return rows.map((row) => (row as { run_id: string }).run_id);\n  }\n\n  /**\n   * Return the DDL for this store's backing table. Run once via the\n   * caller's migration tooling — the store never auto-migrates (§8.5).\n   *\n   * @example\n   * await pool.query(store.schema());\n   */\n  public schema(): string {\n    return [\n      `CREATE TABLE IF NOT EXISTS ${this.table} (`,\n      `  run_id    TEXT PRIMARY KEY,`,\n      `  payload   JSONB NOT NULL,`,\n      `  saved_at  TIMESTAMPTZ NOT NULL DEFAULT now()`,\n      `);`,\n      `CREATE INDEX IF NOT EXISTS idx_${this.table}_saved_at ON ${this.table} (saved_at);`,\n    ].join(\"\\n\");\n  }\n}\n\n/**\n * Create a Postgres-backed {@link SnapshotStore}. Pass a live\n * `pg.Pool`/`pg.Client` — the store never opens or closes it. Schema is\n * not auto-migrated: run {@link SnapshotStore.schema} through your own\n * migration tool first.\n *\n * @example\n * import { Pool } from \"pg\";\n * import { ai } from \"@warlock.js/ai\";\n *\n * const pool = new Pool({ connectionString: process.env.DATABASE_URL });\n *\n * const orchestrator = ai.orchestrator({\n *   name: \"support\",\n *   intents: { ... },\n *   iterate: true,\n *   snapshotStore: ai.snapshot.pg({\n *     client: pool,\n *     table: \"warlock_supervisor_snapshots\",\n *   }),\n * });\n *\n * // Run once, via your own migration tooling:\n * // await pool.query(orchestrator's store.schema());\n */\nexport function pg(options: PgSnapshotStoreOptions): SnapshotStore {\n  return new PgSnapshotStore(options);\n}\n","import type {\n  RedisClientLike,\n  SnapshotStore,\n} from \"../contracts/orchestrator/snapshot-store.contract\";\nimport type { SupervisorSnapshot } from \"../contracts/supervisor/supervisor-snapshot.type\";\n\n/**\n * Default key prefix the redis store prepends to each `runId`. Namespaces\n * the snapshot keys so they coexist with other data in the same Redis\n * database without collision.\n */\nconst DEFAULT_PREFIX = \"warlock:supervisor:snapshot:\";\n\n/**\n * Options for {@link redis}. The `client` is an already-connected redis\n * client (anything satisfying {@link RedisClientLike}); the store never\n * connects or quits it — connection lifecycle stays with the caller.\n */\nexport type RedisSnapshotStoreOptions = {\n  /** Pre-connected redis client. The store only calls `get`/`set`/`del`. */\n  client: RedisClientLike;\n  /**\n   * Key prefix prepended to each `runId`. Defaults to\n   * `warlock:supervisor:snapshot:`.\n   */\n  prefix?: string;\n};\n\n/**\n * Redis {@link SnapshotStore} — supervisor run snapshots persisted as one\n * JSON string value per `runId`, under a namespaced key (orchestrator.md\n * §8).\n *\n * Owns: durable round-tripping of the {@link SupervisorSnapshot} envelope\n * keyed by `runId`, so a crashed mid-turn `iterate: true` iteration can\n * resume after a restart. Does NOT own: the connection (the caller passes\n * a live client and keeps owning its lifecycle) or enumeration — the\n * structural {@link RedisClientLike} surface exposes only `get`/`set`/\n * `del`, with no `SCAN`/`KEYS`, so `list()` is intentionally not\n * implemented (the contract allows stores that can't enumerate to omit\n * it). Pair it with a {@link import(\"../contracts/orchestrator/checkpoint-store.contract\").CheckpointStore}\n * for the boot-drain loop, which is where enumeration is actually needed.\n *\n * `save()` overwrites the key — a run has exactly one live snapshot.\n * Redis needs no schema, so {@link RedisSnapshotStore.schema} returns an\n * empty string for uniformity with the other drivers.\n *\n * Front it with the {@link redis} factory — callers never `new` it.\n */\nclass RedisSnapshotStore implements SnapshotStore {\n  /** The user-supplied redis client. Only `get`/`set`/`del` are called. */\n  private readonly client: RedisClientLike;\n\n  /** Key prefix prepended to each `runId`. */\n  private readonly prefix: string;\n\n  public constructor(options: RedisSnapshotStoreOptions) {\n    if (\n      !options ||\n      !options.client ||\n      typeof options.client.get !== \"function\" ||\n      typeof options.client.set !== \"function\" ||\n      typeof options.client.del !== \"function\"\n    ) {\n      throw new Error(\n        \"Redis snapshot store requires a 'client' option implementing { get, set, del } — pass a connected redis client.\",\n      );\n    }\n\n    this.client = options.client;\n    this.prefix = options.prefix ?? DEFAULT_PREFIX;\n  }\n\n  /**\n   * Build the namespaced Redis key for a `runId`.\n   */\n  private key(runId: string): string {\n    return `${this.prefix}${runId}`;\n  }\n\n  /**\n   * Load the snapshot for a `runId`, or `undefined` when the key is\n   * missing. Redis returns `null` for an absent key — converted to\n   * `undefined` at the boundary.\n   */\n  public async load(runId: string): Promise<SupervisorSnapshot | undefined> {\n    const value = await this.client.get(this.key(runId));\n\n    if (value === null) {\n      return undefined;\n    }\n\n    return JSON.parse(value) as SupervisorSnapshot;\n  }\n\n  /**\n   * Persist a snapshot, keyed by its own `runId`. Overwrites any prior\n   * snapshot for the same run — a run has exactly one live snapshot.\n   */\n  public async save(snapshot: SupervisorSnapshot): Promise<void> {\n    await this.client.set(this.key(snapshot.runId), JSON.stringify(snapshot));\n  }\n\n  /**\n   * Drop the snapshot for a `runId`.\n   */\n  public async delete(runId: string): Promise<void> {\n    await this.client.del(this.key(runId));\n  }\n\n  /**\n   * Redis needs no backing table — there is nothing to migrate. Returns\n   * an empty string so callers can treat `schema()` uniformly across\n   * drivers.\n   */\n  public schema(): string {\n    return \"\";\n  }\n}\n\n/**\n * Create a Redis-backed {@link SnapshotStore}. Pass a connected redis\n * client — the store never connects or quits it.\n *\n * Note: this store does not implement the optional `list()` — the\n * structural client surface has no `SCAN`/`KEYS`. Use a checkpoint store\n * for the production boot-drain loop where enumeration is needed.\n *\n * @example\n * import { createClient } from \"redis\";\n * import { ai } from \"@warlock.js/ai\";\n *\n * const client = createClient({ url: process.env.REDIS_URL });\n * await client.connect();\n *\n * const orchestrator = ai.orchestrator({\n *   name: \"support\",\n *   intents: { ... },\n *   iterate: true,\n *   snapshotStore: ai.snapshot.redis({ client }),\n * });\n */\nexport function redis(options: RedisSnapshotStoreOptions): SnapshotStore {\n  return new RedisSnapshotStore(options);\n}\n","import type { AgentContract } from \"../contracts/agent/agent.contract\";\nimport type { IntentEntry } from \"../contracts/supervisor/intent-entry.type\";\nimport type { WorkflowInstance } from \"../contracts/workflow/workflow.contract\";\n\n/**\n * A dispatchable unit that can be fanned out — an agent or a workflow.\n * The same union the supervisor's `intents` map accepts for its\n * agent/workflow object entries.\n */\nexport type FanOutUnit = AgentContract<unknown> | WorkflowInstance<unknown, unknown>;\n\n/**\n * Options for {@link fanOut}.\n */\nexport type FanOutOptions = {\n  /**\n   * Base name for the generated intent keys. Defaults to the unit's own\n   * `name`. The keys are `<keyPrefix>1`, `<keyPrefix>2`, … `<keyPrefix>n`.\n   */\n  keyPrefix?: string;\n  /**\n   * Description applied to every generated entry. Defaults to the\n   * unit's own `description`. A description is required when the\n   * supervisor uses a `router` (the LLM needs a signal per intent); the\n   * factory enforces that downstream, so supply one here when the\n   * underlying unit has none.\n   */\n  description?: string;\n};\n\n/**\n * Spread one agent/workflow into `n` distinctly-keyed intent entries\n * for voting / self-consistency under a supervisor.\n *\n * A supervisor dispatches a fan-out array (`[\"writer1\", \"writer2\",\n * \"writer3\"]`) in parallel; each branch runs the SAME unit independently\n * so a downstream evaluate/aggregate intent can pick the majority answer\n * or the best of `n` samples. Because every branch needs its own intent\n * KEY, this helper clones the unit across distinct keys rather than\n * cloning the unit itself — the underlying agent/workflow is referenced\n * by all entries, but each entry is a separate dispatch slot.\n *\n * Returns a `Record<string, IntentEntry>` you spread directly into the\n * supervisor's `intents` map. The keys are `<keyPrefix>1..<keyPrefix>n`.\n *\n * @example\n * const writer = ai.agent({ name: \"writer\", description: \"Drafts an answer.\", model });\n *\n * const support = ai.supervisor({\n *   name: \"self-consistency\",\n *   intents: {\n *     ...ai.fanOut(writer, 3),          // writer1, writer2, writer3\n *     vote: { run: pickMajority, description: \"Choose the majority answer.\" },\n *   },\n *   route: (ctx) =>\n *     ctx.iteration === 0 ? [\"writer1\", \"writer2\", \"writer3\"] : \"vote\",\n * });\n *\n * @param unit  The agent or workflow to fan out.\n * @param count Number of parallel copies. Must be an integer >= 1.\n * @param options Optional key-prefix / description overrides.\n */\nexport function fanOut(\n  unit: FanOutUnit,\n  count: number,\n  options: FanOutOptions = {},\n): Record<string, IntentEntry> {\n  if (!unit || typeof (unit as { execute?: unknown }).execute !== \"function\") {\n    throw new TypeError(\"ai.fanOut: first argument must be an agent or workflow\");\n  }\n\n  if (!Number.isInteger(count) || count < 1) {\n    throw new TypeError(`ai.fanOut: \\`count\\` must be an integer >= 1 (received ${String(count)})`);\n  }\n\n  const keyPrefix = resolveKeyPrefix(unit, options.keyPrefix);\n  const description = options.description ?? readDescription(unit);\n\n  const entries: Record<string, IntentEntry> = {};\n\n  for (let index = 1; index <= count; index++) {\n    const entry: IntentEntry = { agent: unit };\n\n    if (description) {\n      entry.description = description;\n    }\n\n    entries[`${keyPrefix}${index}`] = entry;\n  }\n\n  return entries;\n}\n\n/**\n * Resolve the base key prefix: explicit override wins, then the unit's\n * own name. A unit with no usable name forces an explicit `keyPrefix`\n * so the generated keys stay meaningful and collision-free.\n */\nfunction resolveKeyPrefix(unit: FanOutUnit, override: string | undefined): string {\n  if (override && override.trim().length > 0) {\n    return override.trim();\n  }\n\n  const name = (unit as { name?: unknown }).name;\n\n  if (typeof name === \"string\" && name.trim().length > 0) {\n    return name.trim();\n  }\n\n  throw new TypeError(\n    \"ai.fanOut: the unit has no usable `name` — pass `options.keyPrefix` to name the generated intent keys\",\n  );\n}\n\nfunction readDescription(unit: FanOutUnit): string | undefined {\n  const description = (unit as { description?: unknown }).description;\n\n  return typeof description === \"string\" && description.trim().length > 0 ? description : undefined;\n}\n","import type { StandardSchemaV1 } from \"@standard-schema/spec\";\nimport { agent } from \"../agent/agent\";\nimport type { AgentEventHandlers } from \"../agent/agent-config.type\";\nimport type { AgentContract } from \"../contracts/agent/agent.contract\";\nimport { END } from \"../contracts/end.type\";\nimport type { ModelCallOptions, ModelContract } from \"../contracts/model.contract\";\nimport type { Placeholders } from \"../contracts/placeholders.type\";\nimport type { SupervisorIntentValue } from \"../contracts/supervisor/intent-entry.type\";\nimport type { Next } from \"../contracts/supervisor/next.type\";\nimport type { SystemPromptContract } from \"../contracts/system-prompt.contract\";\n\n/**\n * Output shape every router agent produced by {@link router} emits —\n * the canonical `{ next, reasoning }` contract the supervisor's\n * dispatch loop reads. Exposed so callers can type a router result\n * they handle directly.\n */\nexport type RouterOutput = {\n  /** Chosen intent name, a fan-out array, or the `END` sentinel. */\n  next: Next;\n  /** One-sentence justification for the routing choice. */\n  reasoning: string;\n};\n\n/**\n * Description source for one intent the router can pick from. Accepts\n * the same value-shapes the supervisor's `intents` map does (bare\n * agent / workflow / callback / object entry) so a caller can pass the\n * very same `intents` object to both `router()` and `ai.supervisor()`.\n *\n * The router only needs each intent's NAME (the map key) and a\n * human-readable DESCRIPTION — it never dispatches anything itself, so\n * the underlying unit is read for its `description` only.\n */\nexport type RouterIntents = Record<string, SupervisorIntentValue>;\n\n/**\n * Config for {@link router}. Mirrors the relevant slice of `AgentConfig`\n * — the router IS an agent — plus the `intents` map it routes over.\n *\n * Everything except `model` and `intents` is optional; the helper\n * generates the output schema and the routing system prompt for you.\n */\nexport type RouterConfig = {\n  /**\n   * Stable identifier for the router agent. Defaults to\n   * `\"<supervisor-ish>-router\"` is NOT assumed — when omitted the helper\n   * uses `\"router\"` so the agent carries a meaningful (non-anonymous)\n   * name, which `ai.supervisor({ router })` is happy to accept.\n   */\n  name?: string;\n  /** The routing LLM. Required — a router with no model can't decide. */\n  model: ModelContract;\n  /**\n   * The intents the router chooses among. Same object you pass to\n   * `ai.supervisor({ intents })`. Their descriptions are rendered into\n   * the generated routing system prompt so the LLM knows what each\n   * option does.\n   */\n  intents: RouterIntents;\n  /**\n   * Extra guidance prepended to the framework-generated routing system\n   * prompt. Use it for domain framing (\"You coordinate a support\n   * team.\"); the mechanical \"here are your options, emit `next`\"\n   * scaffolding is appended automatically.\n   */\n  systemPrompt?: SystemPromptContract | string;\n  /** Placeholder values merged into the router's system prompt template. */\n  placeholders?: Placeholders;\n  /** Base model call options forwarded to the underlying agent. */\n  modelOptions?: ModelCallOptions;\n  /**\n   * Hard cap on LLM trips for the router agent. A router is a\n   * single-shot decision maker, so this defaults to `1` — override\n   * only if the router itself calls tools mid-decision.\n   */\n  maxTrips?: number;\n  /** Factory-level event handlers forwarded to the underlying agent. */\n  on?: AgentEventHandlers;\n};\n\n/**\n * Build a routing agent for `ai.supervisor({ router })` without\n * hand-writing the output schema or the \"pick one of these intents\"\n * system prompt.\n *\n * **What it does for you.**\n * - Generates the canonical `{ next, reasoning }` output schema\n *   (baked onto the agent so it's a valid router standalone, and\n *   identical to what the supervisor injects per-turn) — the model is\n *   steered to emit a single intent name or the `END` sentinel.\n * - Auto-builds a system prompt that lists every intent + its\n *   description + the reserved `END` value + terse routing rules, with\n *   any caller-supplied `systemPrompt` framing kept on top.\n *\n * The result is a plain {@link AgentContract}; pass it straight to\n * `ai.supervisor({ router: ... })`. Because the supervisor also injects\n * the same schema per-turn and prepends its own per-turn context\n * message, the baked schema/prompt are belt-and-suspenders — they make\n * the agent a correct router even when invoked directly.\n *\n * @example\n * const intents = { triage, orderLookup, billingLookup, resolver };\n *\n * const supportRouter = ai.router({\n *   model,\n *   intents,\n *   systemPrompt: \"You coordinate a customer-support team.\",\n * });\n *\n * const support = ai.supervisor({\n *   name: \"customer-support\",\n *   router: supportRouter,\n *   intents,\n *   maxIterations: 6,\n * });\n */\nexport function router(config: RouterConfig): AgentContract<RouterOutput> {\n  if (!config.model) {\n    throw new TypeError(\"ai.router: `model` is required\");\n  }\n\n  if (!config.intents || typeof config.intents !== \"object\") {\n    throw new TypeError(\"ai.router: `intents` is required and must be an object\");\n  }\n\n  const intentNames = Object.keys(config.intents);\n\n  if (intentNames.length === 0) {\n    throw new TypeError(\"ai.router: `intents` must contain at least one entry\");\n  }\n\n  const routingPrompt = buildRoutingSystemPrompt(config.intents, resolvePrefix(config.systemPrompt));\n\n  return agent<RouterOutput>({\n    name: config.name ?? \"router\",\n    description: \"Routes a supervisor run to the next intent (or terminates it).\",\n    model: config.model,\n    systemPrompt: routingPrompt,\n    output: routerOutputSchema(intentNames),\n    placeholders: config.placeholders,\n    modelOptions: config.modelOptions,\n    maxTrips: config.maxTrips ?? 1,\n    on: config.on,\n  });\n}\n\n/**\n * Resolve a caller-supplied `systemPrompt` (string or contract) to\n * plain text for prepending to the generated routing block. Returns\n * `undefined` when none was supplied.\n */\nfunction resolvePrefix(prompt: SystemPromptContract | string | undefined): string | undefined {\n  if (!prompt) {\n    return undefined;\n  }\n\n  return typeof prompt === \"string\" ? prompt : prompt.resolve();\n}\n\n/**\n * Assemble the routing system prompt: optional caller framing on top,\n * then the mechanical block listing every intent + description, the\n * reserved `END` sentinel, and the rules for emitting `next`.\n */\nfunction buildRoutingSystemPrompt(intents: RouterIntents, prefix: string | undefined): string {\n  const intentLines = Object.entries(intents).map(([name, value]) => {\n    const description = resolveIntentDescription(value);\n\n    return description ? `- ${name}: ${description}` : `- ${name}`;\n  });\n\n  const sections: string[] = [];\n\n  if (prefix && prefix.trim().length > 0) {\n    sections.push(prefix.trim(), \"\");\n  }\n\n  sections.push(\n    \"You are a router. Pick the single best intent to handle the next step, or terminate the run.\",\n    \"\",\n    \"Available intents:\",\n    ...intentLines,\n    \"\",\n    \"Reserved values:\",\n    `- ${END} = terminate the run when no further intent is needed`,\n    \"\",\n    \"Rules:\",\n    \"- Respond with the `next` field set to exactly one intent name from the list above, or the END sentinel.\",\n    \"- Put a one-sentence justification in the `reasoning` field.\",\n    \"- Never invent an intent name that is not listed.\",\n  );\n\n  return sections.join(\"\\n\");\n}\n\n/**\n * Read the human-readable description off a supervisor-intent value,\n * regardless of which accepted shape it is (bare agent / workflow,\n * object entry with a `description` override, callback entry). Bare\n * callbacks have no description source — returns `undefined`, and the\n * prompt simply lists the intent by name.\n */\nfunction resolveIntentDescription(value: SupervisorIntentValue): string | undefined {\n  if (!value || typeof value === \"function\") {\n    return undefined;\n  }\n\n  const entry = value as {\n    description?: unknown;\n    agent?: { description?: unknown };\n  };\n\n  if (typeof entry.description === \"string\" && entry.description.trim().length > 0) {\n    return entry.description.trim();\n  }\n\n  const agentDescription = entry.agent?.description;\n\n  if (typeof agentDescription === \"string\" && agentDescription.trim().length > 0) {\n    return agentDescription.trim();\n  }\n\n  return undefined;\n}\n\n/**\n * Build the canonical router output Standard Schema. The same shape the\n * supervisor injects per-turn — `{ next: string, reasoning: string }` —\n * with the JSON Schema extension carrying the intent names as an `enum`\n * (plus the `END` sentinel) so capable providers enforce the choice\n * natively rather than via soft prompt coaching. Validation still\n * accepts `string` / `string[]` for framework-level fan-out.\n */\nfunction routerOutputSchema(intentNames: string[]): StandardSchemaV1<RouterOutput> {\n  const nextEnum = [...intentNames, END];\n\n  const jsonSchema = {\n    type: \"object\",\n    properties: {\n      next: {\n        type: \"string\",\n        enum: nextEnum,\n        description: \"Name of the intent to dispatch next, or the END sentinel to terminate.\",\n      },\n      reasoning: {\n        type: \"string\",\n        description: \"One-sentence justification for the routing choice.\",\n      },\n    },\n    required: [\"next\", \"reasoning\"],\n    additionalProperties: false,\n  };\n\n  return {\n    \"~standard\": {\n      version: 1,\n      vendor: \"warlock-router\",\n      jsonSchema: {\n        input: () => jsonSchema,\n      },\n      validate(value: unknown): StandardSchemaV1.Result<RouterOutput> {\n        if (!value || typeof value !== \"object\") {\n          return { issues: [{ message: \"router output must be an object\" }] };\n        }\n\n        const record = value as { next?: unknown; reasoning?: unknown };\n        const rawNext = record.next;\n\n        const nextIsValid =\n          typeof rawNext === \"string\" ||\n          (Array.isArray(rawNext) && rawNext.every((element) => typeof element === \"string\"));\n\n        if (!nextIsValid) {\n          return {\n            issues: [\n              { message: \"router output `next` must be a string, string[], or the END sentinel\" },\n            ],\n          };\n        }\n\n        const reasoning = typeof record.reasoning === \"string\" ? record.reasoning : \"\";\n\n        return {\n          value: { next: rawNext as Next, reasoning },\n        };\n      },\n    } as StandardSchemaV1<RouterOutput>[\"~standard\"] & {\n      jsonSchema: { input: () => Record<string, unknown> };\n    },\n  };\n}\n","import type { Placeholders } from \"../contracts/placeholders.type\";\n\nconst PLACEHOLDER_PATTERN = /\\{\\{\\s*([^{}]+?)\\s*\\}\\}/g;\n\n/**\n * Render a template string against a placeholders map, supporting dot-path\n * lookups and inline fallback values.\n *\n * Supported syntax:\n * - `{{key}}` — replaced by `placeholders.key`, left untouched if missing.\n * - `{{a.b.c}}` — dot-path lookup into nested objects.\n * - `{{key|default}}` — substitutes `default` when the key resolves to\n *   `undefined`, `null`, or empty string.\n *\n * Whitespace inside the braces is ignored (`{{ key }}` == `{{key}}`).\n * Values are coerced to strings via `String(value)`.\n *\n * @example\n * renderPlaceholders(\n *   \"Hello {{user.name|friend}}, your role is {{role}}\",\n *   { user: { name: \"Hasan\" }, role: \"admin\" },\n * );\n * // \"Hello Hasan, your role is admin\"\n *\n * @example\n * renderPlaceholders(\"Hello {{user.name|friend}}\", {});\n * // \"Hello friend\"\n */\nexport function renderPlaceholders(\n  template: string,\n  placeholders: Placeholders = {},\n): string {\n  return template.replace(\n    PLACEHOLDER_PATTERN,\n    (match, rawExpression: string) => {\n      const [rawPath, rawFallback] = rawExpression.split(\"|\");\n      const path = rawPath.trim();\n      const fallback = rawFallback?.trim();\n\n      const value = lookupPath(placeholders, path);\n\n      if (value === undefined || value === null || value === \"\") {\n        if (fallback !== undefined) {\n          return fallback;\n        }\n\n        return match;\n      }\n\n      return String(value);\n    },\n  );\n}\n\n/**\n * Walk a dot-path (`\"a.b.c\"`) through an arbitrary record, returning the\n * leaf value or `undefined` when any segment is missing or blocks traversal\n * (non-object). Never throws.\n */\nfunction lookupPath(source: Placeholders, path: string): unknown {\n  const segments = path.split(\".\");\n  let current: unknown = source;\n\n  for (const segment of segments) {\n    if (current === null || current === undefined) {\n      return undefined;\n    }\n\n    if (typeof current !== \"object\") {\n      return undefined;\n    }\n\n    current = (current as Record<string, unknown>)[segment];\n  }\n\n  return current;\n}\n","import type { Placeholders } from \"../contracts/placeholders.type\";\nimport type { InstructionContract } from \"../contracts/system-prompt.contract\";\nimport { renderPlaceholders } from \"./render-placeholders\";\n\n/**\n * Concrete `InstructionContract` — a reusable directive block.\n *\n * **Role.** A single addressable prompt block representing one rule the\n * agent must follow (`\"Always respond in {{language|English}}.\"`). Exists\n * as its own type so the same instruction can be shared across many\n * prompts and agents, each render supplying its own placeholder map.\n *\n * **Responsibility.**\n * - Owns: the `type: \"instruction\"` discriminator, the raw template text,\n *   and the placeholder-rendering step.\n * - Does NOT own: ordering relative to other instructions, joining with a\n *   persona, or any surrounding prompt composition — those concerns live\n *   in `SystemPrompt`.\n *\n * Users construct via the `ai.instruction()` factory — `new Instruction()`\n * is not the public API (see §4.2 of code-style.md).\n *\n * @example\n * const replyInLanguage = ai.instruction(\"Respond in {{language|English}}.\");\n *\n * const prompt = ai.systemPrompt()\n *   .persona(\"You are Alex.\")\n *   .instruction(replyInLanguage)\n *   .instruction(\"Always include code examples.\");\n */\nexport class Instruction implements InstructionContract {\n  public readonly type = \"instruction\" as const;\n\n  public constructor(public readonly text: string) {\n    //\n  }\n\n  /**\n   * Substitute `{{mustache}}` placeholders in the instruction text against\n   * the supplied map. Delegates to the shared `renderPlaceholders` helper\n   * so persona / instruction / system-prompt rendering stays identical.\n   */\n  public resolve(placeholders?: Placeholders): string {\n    return renderPlaceholders(this.text, placeholders);\n  }\n}\n\n/**\n * Create an `Instruction` from raw template text.\n *\n * @example\n * const replyIn = instruction(\"Respond in {{language|English}}.\");\n * const cite = instruction(\"Always cite sources inline.\");\n */\nexport function instruction(text: string): Instruction {\n  return new Instruction(text);\n}\n","import type { Placeholders } from \"../contracts/placeholders.type\";\nimport type { PersonaContract } from \"../contracts/system-prompt.contract\";\nimport { renderPlaceholders } from \"./render-placeholders\";\n\n/**\n * Concrete `PersonaContract` — a reusable \"who the agent is\" block.\n *\n * **Role.** A single addressable prompt block representing the agent's\n * identity (`\"You are Alex, a senior TypeScript engineer.\"`). Exists as\n * its own type so personas can be defined once and reused across many\n * `SystemPrompt` compositions, agents, and sessions — each render can\n * supply a different placeholder map.\n *\n * **Responsibility.**\n * - Owns: the `type: \"persona\"` discriminator, the raw template text, and\n *   the placeholder-rendering step.\n * - Does NOT own: composition with instructions, ordering, joining, or\n *   any knowledge of the surrounding `SystemPrompt`. Those concerns live\n *   in `SystemPrompt`.\n *\n * Users construct via the `ai.persona()` factory — `new Persona()` is not\n * the public API (see §4.2 of code-style.md).\n *\n * @example\n * const alex = ai.persona(\"You are Alex, a TypeScript expert.\");\n *\n * const prompt = ai.systemPrompt()\n *   .persona(alex)\n *   .instruction(\"Always cite sources.\");\n */\nexport class Persona implements PersonaContract {\n  public readonly type = \"persona\" as const;\n\n  public constructor(public readonly text: string) {\n    //\n  }\n\n  /**\n   * Substitute `{{mustache}}` placeholders in the persona text against the\n   * supplied map. Delegates to the shared `renderPlaceholders` helper so\n   * persona / instruction / system-prompt rendering stays identical.\n   */\n  public resolve(placeholders?: Placeholders): string {\n    return renderPlaceholders(this.text, placeholders);\n  }\n}\n\n/**\n * Create a `Persona` from raw template text.\n *\n * @example\n * const alex = persona(\"You are Alex, a TypeScript expert.\");\n * const greeter = persona(\"You are a greeter in {{language|English}}.\");\n */\nexport function persona(text: string): Persona {\n  return new Persona(text);\n}\n","import { readFileSync } from \"node:fs\";\nimport type { Placeholders } from \"../contracts/placeholders.type\";\nimport type {\n  InstructionContract,\n  PersonaContract,\n  SystemPromptBlockContract,\n  SystemPromptContract,\n} from \"../contracts/system-prompt.contract\";\nimport { InvalidRequestError } from \"../errors\";\nimport { Instruction } from \"./instruction\";\nimport { Persona } from \"./persona\";\n\n/**\n * Concrete `SystemPromptContract` — an immutable layered prompt builder.\n *\n * **Role.** The top-level composer for a system prompt: it holds an ordered\n * list of typed blocks (persona + instructions) and resolves the whole\n * stack into one final string when the agent is about to call the model.\n *\n * **Responsibility.**\n * - Owns: the ordered `blocks` list and the block-join rules (insertion\n *   order, blank-line separator, trim).\n * - Does NOT own: how any individual block is rendered (delegated to each\n *   block's `resolve()`), the placeholder syntax (delegated to\n *   `renderPlaceholders`), or any knowledge of the agent, model, or\n *   session consuming the resolved text.\n *\n * Blocks are discriminated by a string `type` tag (`\"persona\"` /\n * `\"instruction\"`) rather than `instanceof`, so user-supplied blocks that\n * implement `SystemPromptBlockContract` interoperate seamlessly with blocks\n * built via `ai.persona()` / `ai.instruction()` — even across duplicate\n * package copies or bundler scope boundaries.\n *\n * The builder is **immutable** — every `.persona()` / `.instruction()`\n * call returns a fresh `SystemPrompt` instance sharing nothing mutable\n * with its parent. This makes forking a base prompt into specialized\n * variants a safe, side-effect-free operation.\n *\n * Users construct via the `ai.systemPrompt()` factory — `new SystemPrompt()`\n * is not the public API (see §4.2 of code-style.md). Modeled as a class so\n * that methods live on the prototype (one copy shared across every forked\n * instance) and downstream code can branch via `instanceof SystemPrompt`.\n *\n * @example\n * // Chainable form\n * const alex = ai.persona(\"You are Alex, a TypeScript expert.\");\n * const replyIn = ai.instruction(\"Respond in {{language|English}}.\");\n *\n * const base = ai.systemPrompt().persona(alex).instruction(replyIn);\n * const arabicVariant = base.instruction(\"Prefer Arabic comments.\");\n *\n * base.resolve({ language: \"English\" });\n * arabicVariant.resolve({ language: \"Arabic\" });\n *\n * @example\n * // Array form — insertion order is preserved exactly\n * const prompt = ai.systemPrompt([\n *   ai.persona(\"You are Alex, a TypeScript expert.\"),\n *   ai.instruction(\"Respond in {{language|English}}.\"),\n * ]);\n */\nexport class SystemPrompt implements SystemPromptContract {\n  public constructor(\n    public readonly blocks: readonly SystemPromptBlockContract[] = [],\n  ) {}\n\n  /**\n   * Build a system prompt by reading the file at `path` once, synchronously,\n   * at construction time. The file's UTF-8 contents seed a single instruction\n   * block — the same semantics as the string-seed form of `systemPrompt()` —\n   * so placeholders inside the file (`{{language|English}}`) resolve at\n   * `resolve()` time and the result can be forked with further\n   * `.persona()` / `.instruction()` calls.\n   *\n   * One-shot by design: the file is read exactly once here, never re-read on\n   * `resolve()`. Reads are synchronous so the call stays a drop-in for the\n   * synchronous `systemPrompt()` factory and the synchronous `resolve()` API.\n   *\n   * Throws `InvalidRequestError` when the file cannot be read (missing path,\n   * permission denied) — surfacing the underlying cause so a typo in the\n   * prompt path fails loudly at construction instead of silently producing an\n   * empty prompt.\n   *\n   * @param path - Filesystem path to the prompt template file.\n   *\n   * @example\n   * const prompt = SystemPrompt.fromFile(\"./prompts/support-agent.md\");\n   *\n   * const localized = prompt.instruction(\"Respond in {{language|English}}.\");\n   * localized.resolve({ language: \"Arabic\" });\n   */\n  public static fromFile(path: string): SystemPrompt {\n    let contents: string;\n\n    try {\n      contents = readFileSync(path, \"utf8\");\n    } catch (error) {\n      throw new InvalidRequestError(\n        `Failed to read system prompt file \"${path}\" — ${\n          error instanceof Error ? error.message : String(error)\n        }`,\n        { context: { path }, cause: error },\n      );\n    }\n\n    return new SystemPrompt([new Instruction(contents)]);\n  }\n\n  /**\n   * Return a new builder with the persona block set. If a persona already\n   * exists it's replaced in place (preserving its position in `blocks`);\n   * otherwise the new persona is prepended so persona-first remains the\n   * default for chain-built prompts. Accepts either raw text (auto-wrapped\n   * via `new Persona`) or an existing `PersonaContract` instance for reuse\n   * across prompts.\n   */\n  public persona(value: PersonaContract | string): SystemPromptContract {\n    const block = typeof value === \"string\" ? new Persona(value) : value;\n    const existingIndex = this.blocks.findIndex(\n      candidate => candidate.type === \"persona\",\n    );\n\n    if (existingIndex >= 0) {\n      const next = [...this.blocks];\n      next[existingIndex] = block;\n\n      return new SystemPrompt(next) as this;\n    }\n\n    return new SystemPrompt([block, ...this.blocks]);\n  }\n\n  /**\n   * Return a new builder with the given instruction appended. Instructions\n   * render in insertion order. Accepts either raw text (auto-wrapped via\n   * `new Instruction`) or an existing `InstructionContract` instance for\n   * cross-prompt reuse.\n   */\n  public instruction(\n    value: InstructionContract | string,\n  ): SystemPromptContract {\n    const block = typeof value === \"string\" ? new Instruction(value) : value;\n\n    return new SystemPrompt([...this.blocks, block]);\n  }\n\n  /**\n   * Resolve every block against the placeholder map, join the results with\n   * blank-line separators (in insertion order), and trim. Returns an empty\n   * string when no blocks are present — callers treat that as \"no system\n   * message\".\n   */\n  public resolve(placeholders?: Placeholders): string {\n    return this.blocks\n      .map(block => block.resolve(placeholders))\n      .join(\"\\n\\n\")\n      .trim();\n  }\n}\n\n/**\n * Public factory for `SystemPrompt`, callable directly or via its\n * `fromFile` static. Exists as a named interface so the callable signature\n * and the `fromFile` attachment travel together as one public type.\n */\nexport interface SystemPromptFactory {\n  (input?: string | ReadonlyArray<SystemPromptBlockContract>): SystemPrompt;\n\n  /**\n   * Build a system prompt from a file read once at construction. Delegates\n   * to {@link SystemPrompt.fromFile}, so `ai.systemPrompt.fromFile(path)` and\n   * `SystemPrompt.fromFile(path)` behave identically.\n   *\n   * @example\n   * const prompt = ai.systemPrompt.fromFile(\"./prompts/support-agent.md\");\n   */\n  fromFile(path: string): SystemPrompt;\n}\n\nfunction systemPromptFactory(\n  input?: string | ReadonlyArray<SystemPromptBlockContract>,\n): SystemPrompt {\n  if (input === undefined) {\n    return new SystemPrompt();\n  }\n\n  if (typeof input === \"string\") {\n    return new SystemPrompt([new Instruction(input)]);\n  }\n\n  return new SystemPrompt([...input]);\n}\n\n/**\n * Create a new immutable system-prompt builder.\n *\n * **Role.** Public factory for `SystemPrompt` — keeps user-facing code\n * free of `new` and consistent with `ai.tool()`, `ai.agent()`,\n * `ai.persona()`, `ai.instruction()`.\n *\n * Input forms:\n * - No argument → empty builder, chain `.persona()` / `.instruction()`\n * - Single string → seeded with one instruction for quick one-shot prompts\n * - Array of blocks → used verbatim, preserving insertion order\n * - `.fromFile(path)` → seeded from a file read once at construction\n *\n * @example\n * // Composed builder\n * const prompt = systemPrompt()\n *   .persona(\"You are Alex, a senior TypeScript engineer.\")\n *   .instruction(\"Always include working code examples.\")\n *   .instruction(\"Respond in {{language|English}}.\");\n *\n * prompt.resolve({ language: \"Arabic\" });\n *\n * @example\n * // One-shot seed\n * const prompt = systemPrompt(\"Answer only with JSON matching the schema.\");\n *\n * @example\n * // From a file, read once at construction\n * const prompt = systemPrompt.fromFile(\"./prompts/support-agent.md\");\n *\n * @example\n * // Array form — fully declarative\n * const prompt = systemPrompt([\n *   ai.persona(\"You are Alex.\"),\n *   ai.instruction(\"Always cite sources.\"),\n *   ai.instruction(\"Respond in {{language|English}}.\"),\n * ]);\n */\nexport const systemPrompt: SystemPromptFactory = Object.assign(\n  systemPromptFactory,\n  { fromFile: SystemPrompt.fromFile },\n);\n","import type { StepDefinition } from \"../contracts/workflow/step.contract\";\nimport { WorkflowError } from \"../errors\";\n\n/**\n * `ai.step(def)` — pass-through factory used for authoring. Returns\n * the definition object verbatim so the workflow engine can read it\n * during execution; the factory exists for API symmetry with\n * `ai.workflow()` and to leave room for future validation or\n * metadata annotation.\n *\n * Generics flow from the enclosing `ai.workflow<...>()` call when the\n * step is declared inline inside `steps: [...]`. To author a step\n * outside that context with full typing, pass them explicitly:\n * `ai.step<MyInput, MyState, MyContext>({ ... })`.\n */\nexport function step<\n  TInput = unknown,\n  TState = Record<string, unknown>,\n  TContext = unknown,\n>(\n  definition: StepDefinition<TInput, TState, TContext>,\n): StepDefinition<TInput, TState, TContext> {\n  validate(definition);\n  return definition;\n}\n\nfunction validate<TInput, TState, TContext>(\n  def: StepDefinition<TInput, TState, TContext>,\n): void {\n  if (!def.name || typeof def.name !== \"string\") {\n    throw new WorkflowError(\"ai.step: `name` is required\");\n  }\n\n  const hasRun = typeof def.run === \"function\";\n  const hasAgent = def.agent !== undefined;\n  const hasParallel = Array.isArray(def.parallel) && def.parallel.length > 0;\n\n  const modes = [hasRun, hasAgent, hasParallel].filter(Boolean).length;\n\n  if (modes === 0) {\n    throw new WorkflowError(\n      `ai.step(\"${def.name}\"): must define exactly one of run | agent | parallel`,\n    );\n  }\n\n  if (modes > 1) {\n    throw new WorkflowError(\n      `ai.step(\"${def.name}\"): define only one of run | agent | parallel`,\n    );\n  }\n\n  if (hasAgent && typeof def.input !== \"function\") {\n    throw new WorkflowError(\n      `ai.step(\"${def.name}\"): \\`input(ctx)\\` is required when \\`agent\\` is set`,\n    );\n  }\n}\n","import type { StandardSchemaV1 } from \"@standard-schema/spec\";\nimport type { WorkflowInstance } from \"../contracts/workflow/workflow.contract\";\nimport { WorkflowError } from \"../errors\";\nimport { compositeAsTool, type ToolContract } from \"../tool/tool\";\n\n/**\n * Wrap a `WorkflowInstance` as a `ToolContract` so an agent can invoke\n * it inside its tool-call loop. Closes the agent-calls-workflow\n * composition gap.\n *\n * Behavior:\n * - Tool `name` mirrors `workflow.name` — workflows without a name throw\n *   `WorkflowError` at wrap time (the agent surface needs a stable id).\n * - Tool `input` is the supplied `inputSchema`; the validated value is\n *   forwarded straight to `workflow.execute(input)`.\n * - On `result.error`, the workflow error is wrapped in\n *   `ToolExecutionError` with `cause` set to the original\n *   `WorkflowError` subclass — the agent's tool-call loop sees a\n *   uniform error class regardless of which primitive failed.\n *\n * @example\n * const wf = workflow({ name: \"triage\", steps: [...] });\n * const triageTool = asTool(wf, {\n *   description: \"Run the support-ticket triage flow\",\n *   inputSchema: ticketSchema,\n * });\n * const a = ai.agent({ model, tools: [triageTool] });\n */\nexport function asTool<TInput, TOutput, TToolInput = TInput>(\n  workflowInstance: WorkflowInstance<TInput, TOutput>,\n  options: {\n    description?: string;\n    inputSchema: StandardSchemaV1<TToolInput>;\n  },\n): ToolContract<TToolInput, TOutput> {\n  if (!workflowInstance.name || typeof workflowInstance.name !== \"string\") {\n    throw new WorkflowError(\n      \"workflow.asTool(): workflow must have a `name` to be wrapped as a tool\",\n    );\n  }\n\n  return compositeAsTool<TToolInput, TOutput>({\n    name: workflowInstance.name,\n    description: options.description ?? `Invoke workflow \"${workflowInstance.name}\" as a tool.`,\n    input: options.inputSchema,\n    execute: async (input) => {\n      const result = await workflowInstance.execute(input as unknown as TInput);\n\n      if (result.error) {\n        // Throw the workflow error so the surrounding wrapper catches\n        // it and produces a `ToolExecutionError` with `cause` pointing\n        // back at the original `WorkflowError` subclass — keeps the\n        // agent's tool-call loop seeing one uniform error class\n        // regardless of which primitive failed.\n        throw result.error;\n      }\n\n      return {\n        data: result.data as TOutput,\n        usage: result.usage,\n        report: result.report,\n      };\n    },\n  });\n}\n","import type { WithoutIdentity } from \"../contracts/events/event-identity.type\";\nimport type { WorkflowEventMap } from \"../contracts/events/event-map.type\";\nimport type {\n  WorkflowEventHandler,\n  WorkflowEventHandlers,\n} from \"../contracts/workflow/workflow.contract\";\n\ntype AnyHandler = WorkflowEventHandler<keyof WorkflowEventMap>;\n\n/**\n * The emit surface the workflow engine and step-runner depend on.\n * They never construct run identity themselves — they hand a bare\n * payload to a sink that injects `runId` / `rootRunId` before\n * delegating to the real three-tier `WorkflowEmitter`.\n *\n * `WorkflowEmitter` is factory-scoped (shared across every\n * `execute()`), so it cannot own per-run identity. A per-run sink\n * (see `runScopedEmitter`) closes that gap without touching the ~15\n * `emit` call sites in `engine.ts` / `step-runner.ts`.\n */\nexport interface WorkflowEventSink {\n  emit<K extends keyof WorkflowEventMap>(\n    event: K,\n    payload: WithoutIdentity<WorkflowEventMap[K]>,\n    executionHandlers?: WorkflowEventHandlers,\n  ): void;\n}\n\n/**\n * Three-tier workflow event emitter — factory (definition) → instance →\n * per-execution. All matching handlers fire, in layer order. Handler\n * errors are swallowed so listener bugs can never derail the workflow.\n */\nexport class WorkflowEmitter {\n  private readonly factoryHandlers?: WorkflowEventHandlers;\n  private readonly instanceHandlers = new Map<\n    keyof WorkflowEventMap,\n    Set<AnyHandler>\n  >();\n\n  public constructor(factoryHandlers?: WorkflowEventHandlers) {\n    this.factoryHandlers = factoryHandlers;\n  }\n\n  public on<K extends keyof WorkflowEventMap>(\n    event: K,\n    handler: WorkflowEventHandler<K>,\n  ): () => void {\n    let bucket = this.instanceHandlers.get(event);\n    if (!bucket) {\n      bucket = new Set();\n      this.instanceHandlers.set(event, bucket);\n    }\n    bucket.add(handler as AnyHandler);\n    return () => this.off(event, handler);\n  }\n\n  public off<K extends keyof WorkflowEventMap>(\n    event: K,\n    handler: WorkflowEventHandler<K>,\n  ): void {\n    this.instanceHandlers.get(event)?.delete(handler as AnyHandler);\n  }\n\n  public emit<K extends keyof WorkflowEventMap>(\n    event: K,\n    payload: WorkflowEventMap[K],\n    executionHandlers?: WorkflowEventHandlers,\n  ): void {\n    // Layer 1 — factory\n    invoke(this.factoryHandlers?.[event], payload);\n\n    // Layer 2 — instance (set-based, possibly many handlers)\n    const bucket = this.instanceHandlers.get(event);\n    if (bucket) {\n      for (const handler of bucket) invoke(handler, payload);\n    }\n\n    // Layer 3 — per-execution\n    invoke(executionHandlers?.[event], payload);\n  }\n}\n\nfunction invoke<K extends keyof WorkflowEventMap>(\n  handler: ((payload: WorkflowEventMap[K]) => void) | undefined,\n  payload: WorkflowEventMap[K],\n): void {\n  if (typeof handler !== \"function\") return;\n  try {\n    handler(payload);\n  } catch {\n    // Swallow — listener bugs must not derail workflow execution.\n  }\n}\n","import type { NextStepResult } from \"../contracts/workflow/next-step-result.type\";\nimport type { StepDefinition } from \"../contracts/workflow/step.contract\";\nimport type { WorkflowContext } from \"../contracts/workflow/workflow-context.type\";\nimport type { WorkflowDefinition } from \"../contracts/workflow/workflow.contract\";\nimport { RoutingError } from \"../errors\";\n\n/**\n * Resolve the next step to run after `step` completes. Tries\n * step-level `nextStep` first, then workflow-level, then falls\n * through (returns `undefined`, engine picks the next declared step).\n *\n * Throws `RoutingError` when either callback throws — routing is\n * authoritative, so a broken router terminates the workflow instead\n * of being retried.\n */\nexport async function resolveNextStep<T>(params: {\n  step: StepDefinition;\n  definition: WorkflowDefinition<any, T, any, any>;\n  ctx: WorkflowContext;\n}): Promise<\"end\" | string | undefined> {\n  const { step, definition, ctx } = params;\n\n  if (step.nextStep) {\n    let outcome: NextStepResult;\n    try {\n      outcome = await step.nextStep(ctx);\n    } catch (err) {\n      throw new RoutingError(\n        `workflow \"${definition.name}\": step \"${step.name}\" nextStep threw`,\n        { stepName: step.name, cause: err },\n      );\n    }\n    const mapped = mapNextStep(outcome);\n    if (mapped !== undefined) return mapped;\n  }\n\n  if (definition.nextStep) {\n    let outcome: NextStepResult;\n    try {\n      outcome = await definition.nextStep(step.name, ctx);\n    } catch (err) {\n      throw new RoutingError(\n        `workflow \"${definition.name}\": workflow-level nextStep threw after \"${step.name}\"`,\n        { stepName: step.name, cause: err },\n      );\n    }\n    const mapped = mapNextStep(outcome);\n    if (mapped !== undefined) return mapped;\n  }\n\n  return undefined;\n}\n\nexport function mapNextStep(\n  outcome: NextStepResult,\n): \"end\" | string | undefined {\n  if (!outcome) return undefined;\n  if (\"end\" in outcome && outcome.end === true) return \"end\";\n  if (\"goto\" in outcome && typeof outcome.goto === \"string\")\n    return outcome.goto;\n  return undefined;\n}\n\nexport function nextDeclaredStep<T>(\n  definition: WorkflowDefinition<any, T, any, any>,\n  currentName: string,\n): string | null {\n  const idx = definition.steps.findIndex(s => s.name === currentName);\n  if (idx === -1) return null;\n  return definition.steps[idx + 1]?.name ?? null;\n}\n","import type { EventIdentity } from \"../contracts/events/event-identity.type\";\nimport type { WorkflowEventMap } from \"../contracts/events/event-map.type\";\nimport type { WorkflowEventHandlers } from \"../contracts/workflow/workflow.contract\";\nimport type { WorkflowEmitter, WorkflowEventSink } from \"./emitter\";\n\n/**\n * Bind a factory-scoped `WorkflowEmitter` to one run's identity.\n *\n * The engine and step-runner emit bare payloads through this sink;\n * it injects `runId` / `rootRunId` once and delegates to the real\n * three-tier emitter. This is the single place workflow run identity\n * is stamped — the alternative (editing every `emitter.emit` call\n * site) would be ~15 scattered edits and easy to miss one.\n *\n * `rootRunId === runId` for a standalone run; nested propagation\n * (a child workflow inheriting an outer run's root) lands in a\n * follow-up.\n *\n * @example\n * // Inside runWorkflow(), once per execution:\n * const emitter = runScopedEmitter(params.emitter, { runId, rootRunId: runId });\n * emitter.emit(\"workflow.starting\", { workflowName, input }, executionHandlers);\n */\nexport function runScopedEmitter(\n  emitter: WorkflowEmitter,\n  identity: EventIdentity,\n): WorkflowEventSink {\n  return {\n    emit(event, payload, executionHandlers?: WorkflowEventHandlers) {\n      const fullPayload = {\n        ...payload,\n        ...identity,\n      } as WorkflowEventMap[typeof event];\n\n      emitter.emit(event, fullPayload, executionHandlers);\n    },\n  };\n}\n","import { resolveDefaultSnapshotStore } from \"../config\";\nimport type { SnapshotStore } from \"../contracts/orchestrator/snapshot-store.contract\";\nimport type { StepSnapshot } from \"../contracts/result/step-result.type\";\nimport type { WorkflowSnapshot } from \"../contracts/workflow/workflow-snapshot.type\";\nimport type {\n  WorkflowDefinition,\n  WorkflowResumeOptions,\n} from \"../contracts/workflow/workflow.contract\";\nimport { WorkflowDriftError, WorkflowError } from \"../errors\";\n\n/**\n * Resolve the effective {@link SnapshotStore}: the workflow's own\n * `snapshotStore` field wins; absent that, fall back to the global\n * default set via `ai.config({ defaultSnapshotStore })`.\n *\n * The global default is typed for the supervisor snapshot shape, but\n * every store impl keys purely by `runId` and round-trips whatever\n * envelope it is handed — so it serves a `WorkflowSnapshot` just as\n * well. The cast re-tags the shape at this single boundary; the\n * workflow only ever hands it a `WorkflowSnapshot`.\n */\nfunction resolveSnapshotStore<T>(\n  definition: WorkflowDefinition<any, T, any, any>,\n): SnapshotStore<WorkflowSnapshot> | undefined {\n  return (\n    definition.snapshotStore ??\n    (resolveDefaultSnapshotStore() as SnapshotStore<WorkflowSnapshot> | undefined)\n  );\n}\n\nexport type PersistParams<T> = {\n  definition: WorkflowDefinition<any, T, any, any>;\n  signature: string;\n  runId: string;\n  startedAt: string;\n  input: unknown;\n  state: Record<string, unknown>;\n  steps: Record<string, StepSnapshot>;\n  next: string | null;\n  status: WorkflowSnapshot[\"status\"];\n};\n\nexport type PersistOutcome = { ok: true } | { ok: false; error: unknown };\n\n/**\n * Write the current run's state to the configured `KVStore`. Returns\n * an outcome object instead of throwing so the engine can surface\n * persistence failures via events + logs without aborting the run.\n * Callers decide whether a failed checkpoint is fatal.\n *\n * No-op (returns `{ ok: true }`) when the workflow has no store\n * configured — the common in-memory test case.\n */\nexport async function persistSnapshot<T>(\n  params: PersistParams<T>,\n): Promise<PersistOutcome> {\n  const store = resolveSnapshotStore(params.definition);\n\n  if (!store) return { ok: true };\n\n  const snapshot: WorkflowSnapshot = {\n    runId: params.runId,\n    workflowName: params.definition.name,\n    signature: params.signature,\n    version: params.definition.version,\n    input: params.input,\n    state: { ...params.state },\n    steps: { ...params.steps },\n    next: params.next,\n    status: params.status,\n    startedAt: params.startedAt,\n    savedAt: new Date().toISOString(),\n  };\n\n  try {\n    await store.save(snapshot);\n    return { ok: true };\n  } catch (err) {\n    return { ok: false, error: err };\n  }\n}\n\n/**\n * Load a prior run's snapshot from the store and run the drift\n * check. Throws `WorkflowError` when no snapshot exists, and\n * `WorkflowDriftError` when the stored signature doesn't match the\n * current definition (unless `force` is set).\n */\nexport async function loadSnapshotForResume<T>(params: {\n  definition: WorkflowDefinition<any, T, any, any>;\n  signature: string;\n  runId: string;\n  options?: WorkflowResumeOptions;\n}): Promise<WorkflowSnapshot> {\n  const store = resolveSnapshotStore(params.definition);\n\n  if (!store) {\n    throw new WorkflowError(\n      `workflow \"${params.definition.name}\" has no store configured — set \\`snapshotStore\\` on the definition or call \\`ai.config({ defaultSnapshotStore })\\` at boot before calling resume()`,\n    );\n  }\n\n  const snap = (await store.load(params.runId)) ?? null;\n\n  if (!snap) {\n    throw new WorkflowError(\n      `workflow \"${params.definition.name}\": no snapshot for runId \"${params.runId}\"`,\n    );\n  }\n\n  if (!params.options?.force && snap.signature !== params.signature) {\n    throw new WorkflowDriftError(\n      `workflow \"${params.definition.name}\" signature drift on resume`,\n      {\n        savedSignature: snap.signature,\n        currentSignature: params.signature,\n        runId: params.runId,\n      },\n    );\n  }\n\n  return snap;\n}\n","import { log } from \"@warlock.js/logger\";\nimport type { BaseReport } from \"../contracts/result/base-report.type\";\nimport type { StepSnapshot } from \"../contracts/result/step-result.type\";\nimport type { Usage } from \"../contracts/result/usage.type\";\nimport type {\n  WorkflowReport,\n  WorkflowResult,\n} from \"../contracts/result/workflow-result.type\";\nimport type { StepDefinition } from \"../contracts/workflow/step.contract\";\nimport type { WorkflowContext } from \"../contracts/workflow/workflow-context.type\";\nimport type { WorkflowSnapshot } from \"../contracts/workflow/workflow-snapshot.type\";\nimport type {\n  WorkflowDefinition,\n  WorkflowEventHandlers,\n} from \"../contracts/workflow/workflow.contract\";\nimport {\n  AIError,\n  MaxStepsExceededError,\n  RoutingError,\n  SchemaValidationError,\n  WorkflowCancelledError,\n  WorkflowError,\n} from \"../errors\";\nimport { stampReportLineage } from \"../utils\";\nimport { createCancelledError } from \"./cancellation\";\nimport type { WorkflowEmitter } from \"./emitter\";\nimport { mapNextStep, nextDeclaredStep, resolveNextStep } from \"./router\";\nimport { runScopedEmitter } from \"./run-scoped-emitter\";\nimport { persistSnapshot } from \"./snapshot\";\nimport { cloneState, deepFreeze } from \"./state\";\nimport { executeStep, finalizeSnapshot, toAIError } from \"./step-runner\";\n\nexport { loadSnapshotForResume } from \"./snapshot\";\n\nconst DEFAULT_MAX_STEPS = 100;\nconst DEFAULT_LOOP_WARN = 5;\nconst LOG_MODULE_BASE = \"ai.workflow\";\n\ntype EngineParams<TOutput> = {\n  definition: WorkflowDefinition<any, TOutput, any, any>;\n  signature: string;\n  emitter: WorkflowEmitter;\n  input: unknown;\n  /**\n   * Request-scoped envelope, frozen and exposed as `ctx.context` to\n   * every step. Never persisted in snapshots; resume callers supply\n   * it fresh via `WorkflowResumeOptions.context`. Defaults to a\n   * frozen empty object when caller omits it.\n   */\n  context?: unknown;\n  runId: string;\n  signal?: AbortSignal;\n  executionHandlers?: WorkflowEventHandlers;\n  resumeFrom?: WorkflowSnapshot;\n  /**\n   * Opaque session identifier propagated onto every report node this\n   * run produces — including agent reports from child steps. Threaded\n   * from `WorkflowRunOptions.sessionId`. Omitted leaves the field\n   * undefined throughout the tree.\n   */\n  sessionId?: string;\n};\n\n/**\n * Main workflow driver. Walks the declared steps, handling routing,\n * cancellation, retries, parallel execution, and snapshot\n * persistence. Delegates the step lifecycle to `step-runner.ts`,\n * routing to `router.ts`, persistence to `snapshot.ts`. Never throws\n * — every failure funnels into `result.error`.\n */\nexport async function runWorkflow<TOutput>(\n  params: EngineParams<TOutput>,\n): Promise<WorkflowResult<TOutput>> {\n  const { definition, signature, input, runId, signal } = params;\n  // Bind the factory-scoped emitter to THIS run's identity. Every\n  // `emitter.emit(...)` below — and the one threaded into\n  // `executeStep` — now stamps `runId` / `rootRunId` automatically.\n  const emitter = runScopedEmitter(params.emitter, {\n    runId,\n    rootRunId: runId,\n  });\n\n  // Freeze the envelope once at run start. Default to `{}` so step\n  // code can always read `ctx.context` without an undefined guard.\n  const context = Object.freeze(params.context ?? {});\n  const maxSteps = definition.maxSteps ?? DEFAULT_MAX_STEPS;\n  const loopWarnAfter = definition.loopWarnAfter ?? DEFAULT_LOOP_WARN;\n\n  const logger = log;\n  const logModule = `${LOG_MODULE_BASE}.${definition.name}`;\n\n  const stepByName = new Map<string, StepDefinition>();\n  for (const s of definition.steps) stepByName.set(s.name, s);\n\n  const state: Record<string, unknown> = params.resumeFrom\n    ? { ...params.resumeFrom.state }\n    : {};\n  const steps: Record<string, StepSnapshot> = params.resumeFrom\n    ? { ...params.resumeFrom.steps }\n    : {};\n  const enteredCount = new Map<string, number>();\n  const usage: Usage = { input: 0, output: 0, total: 0 };\n\n  const startedAt = params.resumeFrom?.startedAt ?? new Date().toISOString();\n  const startedAtDate = new Date(startedAt);\n  const runStartPerf = performance.now();\n\n  let error: AIError | undefined;\n  let status: \"completed\" | \"failed\" | \"cancelled\" = \"completed\";\n  let cancelledAt: string | undefined;\n  let lastGoto: string | null = null;\n  // Captured when a step throws after retries exhaust (and `onFailure`\n  // didn't recover). Used to point the final snapshot's `next` at the\n  // failed step so `resume()` re-runs it after the cause is fixed.\n  let failedStepName: string | undefined;\n\n  const buildContext = (current?: {\n    state: Record<string, unknown>;\n    agentResult?: unknown;\n  }): WorkflowContext => ({\n    input,\n    context,\n    steps: steps as Readonly<Record<string, StepSnapshot>>,\n    state: current?.state ?? state,\n    agentResult: current?.agentResult as WorkflowContext[\"agentResult\"],\n    runId,\n    signal,\n    startedAt: startedAtDate,\n  });\n\n  emitter.emit(\n    \"workflow.starting\",\n    { workflowName: definition.name, input },\n    params.executionHandlers,\n  );\n  logger.info(logModule, \"starting\", \"workflow starting\", { runId });\n\n  let currentName: string | null = resolveInitialStep(\n    definition,\n    params.resumeFrom,\n  );\n  let stepCount = 0;\n\n  try {\n    while (currentName !== null) {\n      if (signal?.aborted) throw createCancelledError(signal);\n\n      stepCount += 1;\n      if (stepCount > maxSteps) {\n        throw new MaxStepsExceededError(\n          `workflow \"${definition.name}\" exceeded maxSteps=${maxSteps}`,\n          { maxSteps },\n        );\n      }\n\n      const entered = (enteredCount.get(currentName) ?? 0) + 1;\n      enteredCount.set(currentName, entered);\n      if (entered === loopWarnAfter) {\n        emitter.emit(\n          \"workflow.loop.warning\",\n          { step: currentName, enteredCount: entered, lastGoto },\n          params.executionHandlers,\n        );\n        logger.warn(logModule, \"loop.warning\", \"loop warning\", {\n          step: currentName,\n          enteredCount: entered,\n        });\n      }\n\n      const step = stepByName.get(currentName);\n      if (!step) {\n        throw new RoutingError(\n          `workflow \"${definition.name}\": unknown step \"${currentName}\"`,\n          { stepName: currentName },\n        );\n      }\n\n      const snapshot = await executeStep({\n        step,\n        state,\n        emitter,\n        executionHandlers: params.executionHandlers,\n        logger,\n        logModule,\n        signal,\n        buildContext,\n        usage,\n        workflowDefaultRetry: definition.defaultRetry,\n      });\n\n      Object.assign(state, snapshot.state);\n      steps[step.name] = finalizeSnapshot(snapshot);\n      // Parallel children — flat-path addressing alongside nested.\n      if (snapshot.steps) {\n        for (const [childName, childSnap] of Object.entries(snapshot.steps)) {\n          steps[childName] = childSnap;\n        }\n      }\n\n      // Failure path: retries exhausted. Give `onFailure` a chance to\n      // recover; otherwise checkpoint at the failed step (so resume\n      // re-runs it) and throw — workflow halts.\n      if (snapshot.status === \"failed\" && snapshot.error) {\n        const failureRoute = await resolveFailureRoute({\n          step,\n          definition,\n          error: snapshot.error,\n          ctx: buildContext({ state, agentResult: snapshot.executionResult }),\n        });\n\n        if (failureRoute === undefined) {\n          // No recovery — persist with `next: step.name` so resume\n          // re-runs this step after the user fixes the cause.\n          const persistOutcome = await persistSnapshot({\n            definition,\n            signature,\n            runId,\n            startedAt,\n            input,\n            state,\n            steps,\n            next: step.name,\n            status: \"running\",\n          });\n          if (!persistOutcome.ok) {\n            const persistErr = toAIError(persistOutcome.error);\n            emitter.emit(\n              \"workflow.error\",\n              { error: persistErr },\n              params.executionHandlers,\n            );\n            logger.error(\n              logModule,\n              \"persist.failed\",\n              \"snapshot persist failed\",\n              {\n                step: step.name,\n                code: persistErr.code,\n                message: persistErr.message,\n              },\n            );\n          }\n          failedStepName = step.name;\n          throw snapshot.error;\n        }\n\n        // onFailure routed — workflow continues. Checkpoint at the\n        // routed target (or `null` for `end`) so resume picks up there.\n        const failureNext = failureRoute === \"end\" ? null : failureRoute;\n        if (failureNext !== null && !stepByName.has(failureNext)) {\n          throw new RoutingError(\n            `workflow \"${definition.name}\": step \"${step.name}\" onFailure routed to unknown target \"${failureNext}\"`,\n            { stepName: step.name, targetName: failureNext },\n          );\n        }\n\n        const failurePersist = await persistSnapshot({\n          definition,\n          signature,\n          runId,\n          startedAt,\n          input,\n          state,\n          steps,\n          next: failureNext,\n          status: \"running\",\n        });\n        if (!failurePersist.ok) {\n          const persistErr = toAIError(failurePersist.error);\n          emitter.emit(\n            \"workflow.error\",\n            { error: persistErr },\n            params.executionHandlers,\n          );\n          logger.error(\n            logModule,\n            \"persist.failed\",\n            \"snapshot persist failed\",\n            {\n              step: step.name,\n              code: persistErr.code,\n              message: persistErr.message,\n            },\n          );\n        }\n\n        if (signal?.aborted) throw createCancelledError(signal);\n\n        if (failureRoute === \"end\") {\n          currentName = null;\n          break;\n        }\n\n        lastGoto = failureRoute;\n        currentName = failureRoute;\n        continue;\n      }\n\n      // Resolve next step for checkpoint accuracy BEFORE routing errors\n      // bubble — so the snapshot records where resume should resume from.\n      const resolved = await resolveNextStep({\n        step,\n        definition,\n        ctx: buildContext({ state, agentResult: snapshot.executionResult }),\n      });\n\n      const nextName =\n        resolved === \"end\"\n          ? null\n          : typeof resolved === \"string\"\n            ? resolved\n            : nextDeclaredStep(definition, step.name);\n\n      // Checkpoint after every step with the resolved `next`.\n      const outcome = await persistSnapshot({\n        definition,\n        signature,\n        runId,\n        startedAt,\n        input,\n        state,\n        steps,\n        next: nextName,\n        status: \"running\",\n      });\n      if (!outcome.ok) {\n        const persistErr = toAIError(outcome.error);\n        emitter.emit(\n          \"workflow.error\",\n          { error: persistErr },\n          params.executionHandlers,\n        );\n        logger.error(logModule, \"persist.failed\", \"snapshot persist failed\", {\n          step: step.name,\n          code: persistErr.code,\n          message: persistErr.message,\n        });\n      }\n\n      if (signal?.aborted) throw createCancelledError(signal);\n\n      if (resolved === \"end\") {\n        currentName = null;\n        break;\n      }\n\n      if (typeof resolved === \"string\") {\n        if (!stepByName.has(resolved)) {\n          throw new RoutingError(\n            `workflow \"${definition.name}\": step \"${step.name}\" goto unknown target \"${resolved}\"`,\n            { stepName: step.name, targetName: resolved },\n          );\n        }\n        lastGoto = resolved;\n        currentName = resolved;\n        continue;\n      }\n\n      currentName = nextName;\n      lastGoto = currentName;\n    }\n  } catch (err) {\n    if (err instanceof WorkflowCancelledError) {\n      status = \"cancelled\";\n      cancelledAt = err.cancelledAt;\n      error = err;\n    } else if (err instanceof AIError) {\n      status = \"failed\";\n      error = err;\n    } else {\n      status = \"failed\";\n      error = new WorkflowError(\n        err instanceof Error ? err.message : String(err),\n        { cause: err },\n      );\n    }\n  }\n\n  // Note: a `failed` step always throws (caught above) unless its\n  // `onFailure` recovered the run. A `completed` workflow may still\n  // contain `failed` step snapshots — those are the recovered cases\n  // and are intentionally preserved for forensic trace.\n\n  const endedAt = new Date().toISOString();\n  const duration = performance.now() - runStartPerf;\n\n  let data: TOutput | undefined;\n  if (status === \"completed\" && definition.output) {\n    try {\n      const extracted = await definition.output.extract(\n        buildContext({ state }),\n      );\n      data = (await validateWorkflowOutput(\n        definition.output.schema,\n        extracted,\n      )) as TOutput;\n    } catch (err) {\n      status = \"failed\";\n      error =\n        err instanceof AIError\n          ? err\n          : new WorkflowError(\n              err instanceof Error ? err.message : String(err),\n              { cause: err },\n            );\n    }\n  }\n\n  // Collect child executable reports from every step that ran one.\n  // Today the step runner surfaces agent reports (the only executable\n  // kind steps can invoke natively via `step.agent`); custom `run`\n  // callbacks that call tools/workflows/supervisors can't be observed\n  // here without a richer step-runner API — that's a v1.x follow-up\n  // (see backlog: \"step.run executables surface in workflow tree\").\n  const children: BaseReport[] = [];\n  for (const stepName in steps) {\n    const snap = steps[stepName];\n    if (snap.agentReport) {\n      children.push(snap.agentReport);\n    }\n  }\n\n  const report: WorkflowReport = {\n    runId,\n    rootRunId: runId,\n    name: definition.name,\n    version: definition.version,\n    type: \"workflow\",\n    workflowName: definition.name,\n    signature,\n    status,\n    startedAt,\n    endedAt,\n    duration,\n    cancelledAt,\n    usage,\n    children,\n    steps,\n    state: deepFreeze(cloneState(state)),\n  };\n\n  // Stamp lineage on the assembled tree exactly once. Walker rewrites\n  // any inner self-roots that nested agent reports brought in (each\n  // agent's `buildResult` set its own runId as root), propagates\n  // sessionId, and writes `reportSchemaVersion` on the root.\n  stampReportLineage(report, {\n    rootRunId: runId,\n    sessionId: params.sessionId,\n  });\n\n  // On a failed run with a captured `failedStepName`, point `next` at\n  // the failed step so `resume()` re-runs it. The pre-throw checkpoint\n  // already wrote this value, but the final snapshot would otherwise\n  // overwrite it with `null` and force resume to fall back to the\n  // first non-completed step (which is the same step in practice, but\n  // less informative for tooling reading the snapshot).\n  const finalNext = status === \"failed\" ? failedStepName ?? null : null;\n\n  const finalOutcome = await persistSnapshot({\n    definition,\n    signature,\n    runId,\n    startedAt,\n    input,\n    state,\n    steps,\n    next: finalNext,\n    status,\n  });\n  if (!finalOutcome.ok) {\n    const persistErr = toAIError(finalOutcome.error);\n    emitter.emit(\n      \"workflow.error\",\n      { error: persistErr },\n      params.executionHandlers,\n    );\n    logger.error(logModule, \"persist.failed\", \"final snapshot persist failed\", {\n      code: persistErr.code,\n      message: persistErr.message,\n    });\n  }\n\n  const result: WorkflowResult<TOutput> = {\n    type: \"workflow\",\n    data,\n    report,\n    usage,\n    error,\n  };\n\n  if (status === \"cancelled\") {\n    emitter.emit(\n      \"workflow.cancelled\",\n      {\n        cancelledAt: cancelledAt ?? endedAt,\n        reason: (error as WorkflowCancelledError | undefined)?.reason ?? \"\",\n      },\n      params.executionHandlers,\n    );\n    logger.warn(logModule, \"cancelled\", \"workflow cancelled\", { runId });\n  }\n\n  if (status === \"failed\" && error) {\n    emitter.emit(\"workflow.error\", { error }, params.executionHandlers);\n    logger.error(logModule, \"error\", \"workflow failed\", {\n      runId,\n      code: error.code,\n      message: error.message,\n    });\n  }\n\n  emitter.emit(\n    \"workflow.completed\",\n    { result: result as WorkflowResult<unknown> },\n    params.executionHandlers,\n  );\n  logger.info(logModule, \"completed\", \"workflow completed\", {\n    runId,\n    status,\n    duration,\n  });\n\n  return result;\n}\n\n/**\n * Run a failed step's `onFailure` hook (if present) and translate its\n * result into a route. Returns `undefined` when the workflow should\n * halt with the original error; `\"end\"` for clean termination; or a\n * step name to redirect to. A throw inside `onFailure` is wrapped in\n * `RoutingError` — routing is authoritative, never retried.\n */\nasync function resolveFailureRoute<T>(params: {\n  step: StepDefinition;\n  definition: WorkflowDefinition<any, T, any, any>;\n  error: AIError;\n  ctx: WorkflowContext;\n}): Promise<\"end\" | string | undefined> {\n  const { step, definition, error, ctx } = params;\n  if (!step.onFailure) return undefined;\n\n  let outcome;\n  try {\n    outcome = await step.onFailure(ctx, error);\n  } catch (err) {\n    throw new RoutingError(\n      `workflow \"${definition.name}\": step \"${step.name}\" onFailure threw`,\n      { stepName: step.name, cause: err },\n    );\n  }\n  return mapNextStep(outcome);\n}\n\nfunction resolveInitialStep<T>(\n  definition: WorkflowDefinition<any, T, any, any>,\n  resumeFrom: WorkflowSnapshot | undefined,\n): string | null {\n  if (!resumeFrom) return definition.steps[0]?.name ?? null;\n\n  // Prefer the explicitly-recorded `next` (now populated on every\n  // checkpoint). Falls back to first step whose snapshot is missing\n  // or not in a terminal-success state — covers older snapshots\n  // written before `next` was wired.\n  if (\n    resumeFrom.next &&\n    definition.steps.some(s => s.name === resumeFrom.next)\n  ) {\n    return resumeFrom.next;\n  }\n\n  for (const step of definition.steps) {\n    const snap = resumeFrom.steps[step.name];\n    if (!snap || (snap.status !== \"completed\" && snap.status !== \"skipped\")) {\n      return step.name;\n    }\n  }\n\n  return null;\n}\n\nasync function validateWorkflowOutput(\n  schema: unknown,\n  value: unknown,\n): Promise<unknown> {\n  if (!schema) return value;\n\n  const result = await (\n    schema as {\n      \"~standard\": { validate: (v: unknown) => Promise<unknown> | unknown };\n    }\n  )[\"~standard\"].validate(value);\n\n  if (\n    result &&\n    typeof result === \"object\" &&\n    \"issues\" in result &&\n    (result as { issues: unknown }).issues\n  ) {\n    throw new SchemaValidationError(\n      \"workflow output failed schema validation\",\n      {\n        issues: (result as { issues: any }).issues,\n      },\n    );\n  }\n\n  return (result as { value: unknown }).value;\n}\n","import type { StepDefinition } from \"../contracts/workflow/step.contract\";\nimport type { WorkflowDefinition } from \"../contracts/workflow/workflow.contract\";\n\nfunction stepFingerprint(step: StepDefinition): unknown {\n  const tag = step.parallel\n    ? \"parallel\"\n    : step.agent\n      ? \"agent\"\n      : step.run\n        ? \"run\"\n        : \"empty\";\n\n  const agentName = step.agent?.name;\n\n  return {\n    n: step.name,\n    t: tag,\n    a: agentName,\n    c: step.parallel?.map(child => stepFingerprint(child)) ?? null,\n  };\n}\n\n/**\n * FNV-1a 32-bit hash — deterministic, no crypto dependency.\n */\nfunction hash(input: string): string {\n  let h = 0x811c9dc5;\n\n  for (let i = 0; i < input.length; i++) {\n    h ^= input.charCodeAt(i);\n    h = (h + ((h << 1) + (h << 4) + (h << 7) + (h << 8) + (h << 24))) >>> 0;\n  }\n\n  return h.toString(16).padStart(8, \"0\");\n}\n\nexport function computeSignature<T>(definition: WorkflowDefinition<any, T, any, any>): string {\n  const fingerprint = {\n    n: definition.name,\n    v: definition.version ?? null,\n    s: definition.steps.map(step => stepFingerprint(step)),\n  };\n\n  return hash(JSON.stringify(fingerprint));\n}\n","import type { StandardSchemaV1 } from \"@standard-schema/spec\";\nimport type { WorkflowEventMap } from \"../contracts/events/event-map.type\";\nimport type { WorkflowResult } from \"../contracts/result/workflow-result.type\";\nimport type {\n  WorkflowDefinition,\n  WorkflowEventHandler,\n  WorkflowExecuteOptions,\n  WorkflowInstance,\n  WorkflowResumeOptions,\n  WorkflowRunOptions,\n} from \"../contracts/workflow/workflow.contract\";\nimport { WorkflowError } from \"../errors\";\nimport type { ToolContract } from \"../tool/tool\";\nimport { asTool } from \"./as-tool\";\nimport { WorkflowEmitter } from \"./emitter\";\nimport { loadSnapshotForResume, runWorkflow } from \"./engine\";\nimport { computeSignature } from \"./signature\";\n\n/**\n * `ai.workflow(def)` — construct a `WorkflowInstance`. Validates the\n * definition, computes a stable structural signature, and wires up the\n * three-tier event subscription model.\n */\nexport function workflow<\n  TInput = unknown,\n  TOutput = unknown,\n  TState = Record<string, unknown>,\n  TContext = unknown,\n>(\n  definition: WorkflowDefinition<TInput, TOutput, TState, TContext>,\n): WorkflowInstance<TInput, TOutput, TState, TContext> {\n  validate(definition);\n  const signature = computeSignature(definition);\n  const emitter = new WorkflowEmitter(definition.on);\n\n  function execute(\n    inputOrOptions: TInput | WorkflowExecuteOptions<TInput, TContext>,\n    maybeOptions?: WorkflowRunOptions<TContext>,\n  ): Promise<WorkflowResult<TOutput>> {\n    const { input, options } = normalizeExecuteArgs<TInput, TContext>(\n      inputOrOptions,\n      maybeOptions,\n    );\n    const runId = options?.runId ?? generateRunId();\n    return runWorkflow<TOutput>({\n      definition,\n      signature,\n      emitter,\n      input,\n      context: options?.context,\n      runId,\n      signal: options?.signal,\n      executionHandlers: options?.on,\n      sessionId: options?.sessionId,\n    });\n  }\n\n  async function resume(\n    runId: string,\n    options?: WorkflowResumeOptions<TContext>,\n  ): Promise<WorkflowResult<TOutput>> {\n    const snapshot = await loadSnapshotForResume({\n      definition,\n      signature,\n      runId,\n      options,\n    });\n\n    return runWorkflow<TOutput>({\n      definition,\n      signature,\n      emitter,\n      input: snapshot.input,\n      context: options?.context,\n      runId,\n      signal: options?.signal,\n      executionHandlers: options?.on,\n      sessionId: options?.sessionId,\n      resumeFrom: snapshot,\n    });\n  }\n\n  const instance: WorkflowInstance<TInput, TOutput, TState, TContext> = {\n    name: definition.name,\n    description: definition.description,\n    inputSchema: definition.inputSchema,\n    signature,\n    version: definition.version,\n    execute,\n    resume,\n    on<K extends keyof WorkflowEventMap>(event: K, handler: WorkflowEventHandler<K>) {\n      return emitter.on(event, handler);\n    },\n    off<K extends keyof WorkflowEventMap>(event: K, handler: WorkflowEventHandler<K>) {\n      emitter.off(event, handler);\n    },\n    asTool<TToolInput = TInput>(options: {\n      description?: string;\n      inputSchema: StandardSchemaV1<TToolInput>;\n    }): ToolContract<TToolInput, TOutput> {\n      return asTool<TInput, TOutput, TToolInput>(instance, options);\n    },\n  };\n\n  return instance;\n}\n\n/**\n * Resolve the overloaded `execute()` call shape. If the caller passed\n * a single plain object with an `input` field, treat it as the\n * combined `WorkflowExecuteOptions`. Otherwise the first arg is the\n * raw workflow input and the second is the run options.\n *\n * Ambiguity note: if your real workflow `input` is itself an object\n * with a top-level `input` key, prefer `execute(rawInput, options)`\n * explicitly — the single-arg detection heuristic would mis-classify\n * it.\n */\nfunction normalizeExecuteArgs<TInput, TContext>(\n  inputOrOptions: TInput | WorkflowExecuteOptions<TInput, TContext>,\n  maybeOptions: WorkflowRunOptions<TContext> | undefined,\n): { input: TInput; options?: WorkflowRunOptions<TContext> } {\n  if (\n    maybeOptions === undefined &&\n    inputOrOptions !== null &&\n    typeof inputOrOptions === \"object\" &&\n    \"input\" in (inputOrOptions as object)\n  ) {\n    const combined = inputOrOptions as WorkflowExecuteOptions<TInput, TContext>;\n    const { input, ...options } = combined;\n    return { input, options };\n  }\n\n  return { input: inputOrOptions as TInput, options: maybeOptions };\n}\n\nfunction validate<TInput, TOutput, TState, TContext>(\n  definition: WorkflowDefinition<TInput, TOutput, TState, TContext>,\n): void {\n  if (!definition.name || typeof definition.name !== \"string\") {\n    throw new WorkflowError(\"ai.workflow: `name` is required\");\n  }\n\n  if (!Array.isArray(definition.steps) || definition.steps.length === 0) {\n    throw new WorkflowError(`ai.workflow(\"${definition.name}\"): at least one step is required`);\n  }\n\n  const seen = new Set<string>();\n  const walk = (name: string) => {\n    if (seen.has(name)) {\n      throw new WorkflowError(`ai.workflow(\"${definition.name}\"): duplicate step name \"${name}\"`);\n    }\n    seen.add(name);\n  };\n\n  for (const step of definition.steps) {\n    walk(step.name);\n\n    if (step.parallel) {\n      for (const child of step.parallel) {\n        walk(child.name);\n      }\n    }\n  }\n}\n\nfunction generateRunId(): string {\n  // Non-crypto random — adequate for ephemeral workflow runs.\n  return `wf_${Date.now().toString(36)}_${Math.random().toString(36).slice(2, 10)}`;\n}\n","import { agent } from \"./agent/agent\";\nimport { batch } from \"./batch\";\nimport {\n  checkpointMemory,\n  checkpointPg,\n  checkpointRedis,\n} from \"./checkpoint\";\nimport { setAIConfig } from \"./config\";\nimport { evalScorers } from \"./eval\";\nimport { budget, readBudgetFallbackSignal } from \"./middleware/builtins/budget\";\nimport { memory } from \"./memory\";\nimport { guardrail } from \"./middleware/builtins/guardrail\";\nimport { semanticCache } from \"./middleware/builtins/semantic-cache\";\nimport { composeMiddleware, forTool } from \"./middleware/helpers\";\nimport { mockRouter } from \"./mock\";\nimport { fallbackModel } from \"./model\";\nimport { orchestrator } from \"./orchestrator\";\nimport { planner } from \"./planner\";\nimport { spawnSubAgent } from \"./agent/spawn-sub-agent\";\nimport { snapshotMemory, snapshotPg, snapshotRedis } from \"./snapshot\";\nimport { fanOut, router } from \"./supervisor\";\nimport { supervisor } from \"./supervisor/supervisor\";\nimport { instruction } from \"./system-prompt/instruction\";\nimport { persona } from \"./system-prompt/persona\";\nimport { systemPrompt } from \"./system-prompt/system-prompt\";\nimport { tool } from \"./tool/tool\";\nimport { step } from \"./workflow/step\";\nimport { workflow } from \"./workflow/workflow\";\n\n/**\n * Top-level `ai` namespace — holds built-in factories and user-registered SDK adapters.\n *\n * Factories:\n * - `ai.tool(...)` — wrap an async function with a schema-validated input.\n * - `ai.agent(...)` — build an executable agent from model + tools + prompt.\n * - `ai.systemPrompt(...)` — compose a layered persona + instructions prompt.\n * - `ai.persona(text)` — reusable persona block (can be passed to `systemPrompt`).\n * - `ai.instruction(text)` — reusable instruction block (can be passed to `systemPrompt`).\n * - `ai.orchestrator(...)` — session-state manager wrapped around a supervisor (durable session, drift detection, resume, commands).\n * - `ai.memory(...)` — build an agent-memory store with WORKING (in-run scratch) and SEMANTIC (cache-driver `.similar()` recall) tiers.\n * - `ai.planner(...)` — build an executable that generates an ordered plan over registered capabilities, then runs it step-by-step.\n * - `ai.spawnSubAgent(spec)` — thin wrapper that builds a fresh one-shot `agent()` with an optional per-task `budget` and runs the task once. A general primitive (not planner-specific).\n * - `ai.router(...)` — build a supervisor-compatible routing agent from named intents.\n * - `ai.fanOut(unit, count)` — spread one agent/workflow into N intent entries for voting / self-consistency.\n * - `ai.batch(executable, items, opts?)` — run any executable over a dataset with bounded concurrency + per-item retry.\n * - `ai.fallbackModel(models, opts?)` — wrap an ordered model list that fails over to the next on transient provider errors.\n * - `ai.eval.{exact,contains,predicate,judge}(...)` — built-in scorer factories for `agent.eval(...)`.\n * - `ai.mockRouter(decisions, opts?)` — deterministic supervisor `route` callback for tests.\n * - `ai.checkpoint.{memory,pg,redis}()` — durable orchestrator session checkpoint stores.\n * - `ai.snapshot.{memory,pg,redis}()` — supervisor-run snapshot stores for `iterate: true` resume.\n * - `ai.openai.model(...)` / `ai.anthropic.model(...)` / ... once the adapter SDK is registered.\n *\n * @example\n * const alex = ai.persona(\"You are Alex, a TypeScript expert.\");\n * const replyIn = ai.instruction(\"Respond in {{language|English}}.\");\n *\n * const prompt = ai.systemPrompt().persona(alex).instruction(replyIn);\n *\n * const myAgent = ai.agent({\n *   model: ai.openai.model({ name: \"gpt-4o\" }),\n *   systemPrompt: prompt,\n *   tools: [myTool],\n * });\n *\n * const result = await myAgent.execute(\"What is the weather in Cairo?\", {\n *   placeholders: { language: \"Arabic\" },\n * });\n */\nexport const ai = {\n  config: setAIConfig,\n  tool,\n  agent,\n  systemPrompt,\n  persona,\n  instruction,\n  workflow,\n  step,\n  supervisor,\n  orchestrator,\n  memory,\n  planner,\n  spawnSubAgent,\n  router,\n  fanOut,\n  batch,\n  fallbackModel,\n  eval: evalScorers,\n  mockRouter,\n  middleware: {\n    budget,\n    guardrail,\n    semanticCache,\n    compose: composeMiddleware,\n    forTool,\n    readBudgetFallbackSignal,\n  },\n  checkpoint: {\n    memory: checkpointMemory,\n    pg: checkpointPg,\n    redis: checkpointRedis,\n  },\n  snapshot: {\n    memory: snapshotMemory,\n    pg: snapshotPg,\n    redis: snapshotRedis,\n  },\n};\n","// Lazy bridge for the vitest-coupled matcher registration.\n//\n// WHY: `@warlock.js/ai`'s root barrel (`src/index.ts`) is the package's\n// only public entry, and it is loaded by every production consumer.\n// `./matchers` statically imports `vitest` (a devDependency) at module\n// top to call `expect.extend`, so pulling it into the eager barrel would\n// force `vitest` to resolve in production — where it is not installed —\n// and crash the import. This wrapper defers that import to call time via\n// a dynamic `import()`, mirroring the package's optional-peer discipline,\n// so `registerAiMatchers` can ship on the root barrel while staying inert\n// (and `vitest`-free) until a test actually invokes it.\n\n/**\n * Register the `@warlock.js/ai` custom Vitest matchers\n * (`toRouteTo` / `toConverge` / `toPassStep` / `toOutputShape`) on the\n * global `expect`. Call once from test code before using them. The\n * underlying `vitest`-coupled implementation is imported lazily on the\n * first call, so importing `@warlock.js/ai` in production never pulls in\n * `vitest`. Idempotent — the underlying registration is itself a no-op on\n * repeat calls.\n *\n * @example\n * import { registerAiMatchers } from \"@warlock.js/ai\";\n * await registerAiMatchers();\n *\n * expect(await supervisor.execute(input)).toRouteTo(\"critic\");\n */\nexport async function registerAiMatchers(): Promise<void> {\n  const { registerAiMatchers: register } = await import(\"./matchers\");\n\n  register();\n}\n"],"mappings":"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"}