@warlock.js/ai 4.1.15 → 4.2.1

package/cjs/index.cjs

@@ -3,7 +3,7 @@ let _warlock_js_logger = require("@warlock.js/logger");
 let node_fs_promises = require("node:fs/promises");
 let node_path = require("node:path");
 
-//#region ../../@warlock.js/ai/src/errors/ai-error.ts
+//#region ../@warlock.js/ai/src/errors/ai-error.ts
 /**
 * Base class for every error thrown (or surfaced via `result.error`) by
 * `@warlock.js/ai` and its provider adapter packages.
@@ -69,7 +69,7 @@ var AIError = class extends Error {
 };
 
 //#endregion
-//#region ../../@warlock.js/ai/src/errors/agent-execution-error.ts
+//#region ../@warlock.js/ai/src/errors/agent-execution-error.ts
 /**
 * Base for agent runtime failures that aren't schema / tool / provider
 * problems — runtime-structural issues inside the trip loop or
@@ -100,7 +100,7 @@ var AgentExecutionError = class extends AIError {
 };
 
 //#endregion
-//#region ../../@warlock.js/ai/src/errors/agent-cancelled-error.ts
+//#region ../@warlock.js/ai/src/errors/agent-cancelled-error.ts
 /**
 * Agent run was cancelled via `AbortSignal` before it could finish.
 * Between-trip cancellation is guaranteed; mid-trip cancellation is
@@ -139,7 +139,7 @@ var AgentCancelledError = class extends AgentExecutionError {
 };
 
 //#endregion
-//#region ../../@warlock.js/ai/src/errors/agent-max-trips-error.ts
+//#region ../@warlock.js/ai/src/errors/agent-max-trips-error.ts
 /**
 * Runaway-loop hard guard: the agent's trip loop ran `maxTrips` round
 * trips to the model without the model issuing a natural stop. The
@@ -176,7 +176,7 @@ var AgentMaxTripsError = class extends AgentExecutionError {
 };
 
 //#endregion
-//#region ../../@warlock.js/ai/src/errors/budget-exceeded-error.ts
+//#region ../@warlock.js/ai/src/errors/budget-exceeded-error.ts
 /**
 * A user- or framework-configured budget was exceeded mid-execution.
 *
@@ -203,7 +203,7 @@ var BudgetExceededError = class extends AIError {
 };
 
 //#endregion
-//#region ../../@warlock.js/ai/src/errors/provider-error.ts
+//#region ../@warlock.js/ai/src/errors/provider-error.ts
 /**
 * Any failure that originated from the model provider (OpenAI, Azure,
 * OpenRouter, local gateway). Base class for the provider subclasses
@@ -241,7 +241,7 @@ var ProviderError = class extends AIError {
 };
 
 //#endregion
-//#region ../../@warlock.js/ai/src/errors/content-filter-error.ts
+//#region ../@warlock.js/ai/src/errors/content-filter-error.ts
 /**
 * Response (or request) was blocked by the provider's safety filter.
 * Not retryable with the same input — reshape the prompt or lean on
@@ -265,7 +265,7 @@ var ContentFilterError = class extends ProviderError {
 };
 
 //#endregion
-//#region ../../@warlock.js/ai/src/errors/context-length-exceeded-error.ts
+//#region ../@warlock.js/ai/src/errors/context-length-exceeded-error.ts
 /**
 * The request's prompt (messages + tools + schema) exceeded the
 * model's context window. Not retryable without shortening the input.
@@ -292,7 +292,7 @@ var ContextLengthExceededError = class extends ProviderError {
 };
 
 //#endregion
-//#region ../../@warlock.js/ai/src/errors/guardrail-violation-error.ts
+//#region ../@warlock.js/ai/src/errors/guardrail-violation-error.ts
 /**
 * A guardrail middleware rejected the prompt or response mid-execution.
 *
@@ -329,7 +329,7 @@ var GuardrailViolationError = class extends AIError {
 };
 
 //#endregion
-//#region ../../@warlock.js/ai/src/errors/invalid-request-error.ts
+//#region ../@warlock.js/ai/src/errors/invalid-request-error.ts
 /**
 * Provider rejected the request as malformed — bad model name,
 * unsupported feature, missing required field, image attached to a
@@ -356,7 +356,7 @@ var InvalidRequestError = class extends ProviderError {
 };
 
 //#endregion
-//#region ../../@warlock.js/ai/src/errors/supervisor-failed-error.ts
+//#region ../@warlock.js/ai/src/errors/supervisor-failed-error.ts
 /**
 * Base class for every supervisor-specific failure surfaced from
 * `supervisor.execute()` / `supervisor.resume()` / authoring-time
@@ -395,7 +395,7 @@ var SupervisorFailedError = class extends AIError {
 };
 
 //#endregion
-//#region ../../@warlock.js/ai/src/errors/max-iterations-error.ts
+//#region ../@warlock.js/ai/src/errors/max-iterations-error.ts
 /**
 * Hard-cap guard: the supervisor ran `maxIterations` loop turns
 * without reaching a terminal decision (`END`, `satisfied: true`, or
@@ -423,7 +423,7 @@ var MaxIterationsError = class extends SupervisorFailedError {
 };
 
 //#endregion
-//#region ../../@warlock.js/ai/src/errors/workflow-error.ts
+//#region ../@warlock.js/ai/src/errors/workflow-error.ts
 /**
 * Base class for all workflow-specific failures. Subclasses carry
 * precise codes; this base catches everything `workflow.execute()`
@@ -437,7 +437,7 @@ var WorkflowError = class extends AIError {
 };
 
 //#endregion
-//#region ../../@warlock.js/ai/src/errors/max-steps-exceeded-error.ts
+//#region ../@warlock.js/ai/src/errors/max-steps-exceeded-error.ts
 /**
 * Runaway-loop hard guard: workflow executed more step transitions
 * than `maxSteps` allows. Terminates the workflow immediately.
@@ -454,7 +454,7 @@ var MaxStepsExceededError = class extends WorkflowError {
 };
 
 //#endregion
-//#region ../../@warlock.js/ai/src/errors/provider-auth-error.ts
+//#region ../@warlock.js/ai/src/errors/provider-auth-error.ts
 /**
 * Provider rejected the credential — missing / invalid / expired API
 * key or insufficient permissions on the underlying account. Not
@@ -476,7 +476,7 @@ var ProviderAuthError = class extends ProviderError {
 };
 
 //#endregion
-//#region ../../@warlock.js/ai/src/errors/provider-rate-limit-error.ts
+//#region ../@warlock.js/ai/src/errors/provider-rate-limit-error.ts
 /**
 * Provider refused the call because the account (or key, or window)
 * is over its rate-limit or quota. Retryable after `retryAfter`
@@ -503,7 +503,7 @@ var ProviderRateLimitError = class extends ProviderError {
 };
 
 //#endregion
-//#region ../../@warlock.js/ai/src/errors/provider-timeout-error.ts
+//#region ../@warlock.js/ai/src/errors/provider-timeout-error.ts
 /**
 * Provider call timed out — either at the transport layer (socket
 * connection) or on the server side (request exceeded the provider's
@@ -525,7 +525,7 @@ var ProviderTimeoutError = class extends ProviderError {
 };
 
 //#endregion
-//#region ../../@warlock.js/ai/src/errors/quota-exceeded-error.ts
+//#region ../@warlock.js/ai/src/errors/quota-exceeded-error.ts
 /**
 * Provider refused the call because the account has exhausted its
 * paid quota (monthly credit, billing cap, subscription tier limit).
@@ -561,7 +561,7 @@ var QuotaExceededError = class extends ProviderError {
 };
 
 //#endregion
-//#region ../../@warlock.js/ai/src/errors/routing-error.ts
+//#region ../@warlock.js/ai/src/errors/routing-error.ts
 /**
 * `nextStep` returned an invalid `goto`, or the `nextStep` callback
 * itself threw. Routing is authoritative and has no recovery path —
@@ -580,7 +580,7 @@ var RoutingError = class extends WorkflowError {
 };
 
 //#endregion
-//#region ../../@warlock.js/ai/src/errors/schema-validation-error.ts
+//#region ../@warlock.js/ai/src/errors/schema-validation-error.ts
 /**
 * A `StandardSchemaV1` validation call returned issues, or the input
 * was not valid JSON before validation could even run.
@@ -613,7 +613,7 @@ var SchemaValidationError = class extends AIError {
 };
 
 //#endregion
-//#region ../../@warlock.js/ai/src/errors/step-failed-error.ts
+//#region ../@warlock.js/ai/src/errors/step-failed-error.ts
 /**
 * A workflow step exhausted its retries (or was not retried) and
 * terminated with an error. `cause` carries the last underlying error.
@@ -628,7 +628,7 @@ var StepFailedError = class extends WorkflowError {
 };
 
 //#endregion
-//#region ../../@warlock.js/ai/src/errors/supervisor-cancelled-error.ts
+//#region ../@warlock.js/ai/src/errors/supervisor-cancelled-error.ts
 /**
 * Supervisor run was cancelled via `AbortSignal` before it could
 * finish. Between-iteration cancellation is guaranteed; mid-iteration
@@ -653,7 +653,7 @@ var SupervisorCancelledError = class extends SupervisorFailedError {
 };
 
 //#endregion
-//#region ../../@warlock.js/ai/src/errors/supervisor-drift-error.ts
+//#region ../@warlock.js/ai/src/errors/supervisor-drift-error.ts
 /**
 * `supervisor.resume(runId)` loaded a snapshot whose structural
 * fingerprint does not match the current supervisor definition
@@ -679,7 +679,7 @@ var SupervisorDriftError = class extends SupervisorFailedError {
 };
 
 //#endregion
-//#region ../../@warlock.js/ai/src/errors/supervisor-routing-error.ts
+//#region ../@warlock.js/ai/src/errors/supervisor-routing-error.ts
 /**
 * A `route` callback or router agent returned a value that doesn't
 * resolve to a configured agent key, a `string[]` of configured keys,
@@ -714,7 +714,7 @@ var SupervisorRoutingError = class extends SupervisorFailedError {
 };
 
 //#endregion
-//#region ../../@warlock.js/ai/src/errors/tool-execution-error.ts
+//#region ../@warlock.js/ai/src/errors/tool-execution-error.ts
 /**
 * A registered tool's `execute()` threw during dispatch — the tool
 * code itself failed (not its input schema). The model's request was
@@ -742,7 +742,7 @@ var ToolExecutionError = class extends AIError {
 };
 
 //#endregion
-//#region ../../@warlock.js/ai/src/errors/workflow-cancelled-error.ts
+//#region ../@warlock.js/ai/src/errors/workflow-cancelled-error.ts
 /**
 * Workflow was cancelled via `AbortSignal` before it could finish.
 * `cancelledAt` is ISO timestamp at abort; `reason` carries the
@@ -761,7 +761,7 @@ var WorkflowCancelledError = class extends WorkflowError {
 };
 
 //#endregion
-//#region ../../@warlock.js/ai/src/errors/workflow-drift-error.ts
+//#region ../@warlock.js/ai/src/errors/workflow-drift-error.ts
 /**
 * `workflow.resume(runId)` found a snapshot whose structural signature
 * doesn't match the current workflow definition. Thrown without
@@ -781,7 +781,7 @@ var WorkflowDriftError = class extends WorkflowError {
 };
 
 //#endregion
-//#region ../../@warlock.js/ai/src/middleware/utils/extract-user-text.ts
+//#region ../@warlock.js/ai/src/middleware/utils/extract-user-text.ts
 /**
 * Pull the text a content-inspection middleware should care about
 * from the outbound message list.
@@ -819,7 +819,7 @@ function extractUserText(messages) {
 }
 
 //#endregion
-//#region ../../@warlock.js/ai/src/middleware/utils/namespaced-state.ts
+//#region ../@warlock.js/ai/src/middleware/utils/namespaced-state.ts
 /**
 * Typed accessor over `ctx.state` for a single namespace key. Wraps
 * the raw `Map<string, unknown>` so middleware authors stop typing
@@ -877,7 +877,7 @@ function namespacedState(ctx, namespace) {
 }
 
 //#endregion
-//#region ../../@warlock.js/ai/src/middleware/builtins/budget.ts
+//#region ../@warlock.js/ai/src/middleware/builtins/budget.ts
 function breach(limit, actual, unit, name) {
 	throw new BudgetExceededError(`budget "${name}" exceeded — ${actual} ${unit} (cap: ${limit})`, {
 		limit,
@@ -971,7 +971,7 @@ function budget(options) {
 }
 
 //#endregion
-//#region ../../@warlock.js/ai/src/middleware/builtins/guardrail.ts
+//#region ../@warlock.js/ai/src/middleware/builtins/guardrail.ts
 /**
 * Pre/post content guardrail for an agent run.
 *
@@ -1041,7 +1041,7 @@ function guardrail(options) {
 }
 
 //#endregion
-//#region ../../@warlock.js/ai/src/config.ts
+//#region ../@warlock.js/ai/src/config.ts
 const aiConfig = {};
 /**
 * Set or extend process-wide AI configuration. Merges over existing
@@ -1082,7 +1082,7 @@ function resolveDefaultStore() {
 }
 
 //#endregion
-//#region ../../@warlock.js/ai/src/middleware/builtins/semantic-cache.ts
+//#region ../@warlock.js/ai/src/middleware/builtins/semantic-cache.ts
 const DEFAULT_NAMESPACE = "ai.cache";
 /**
 * Build a stable fingerprint for a prompt covering the full message
@@ -1226,7 +1226,7 @@ function toSyntheticResponse(response) {
 }
 
 //#endregion
-//#region ../../@warlock.js/ai/src/middleware/helpers/compose.ts
+//#region ../@warlock.js/ai/src/middleware/helpers/compose.ts
 /**
 * Flatten one or more middleware sources into a single ordered
 * array suitable for `agent({ middleware: [...] })`.
@@ -1276,7 +1276,7 @@ function composeMiddleware(...sources) {
 }
 
 //#endregion
-//#region ../../@warlock.js/ai/src/middleware/helpers/for-tool.ts
+//#region ../@warlock.js/ai/src/middleware/helpers/for-tool.ts
 /**
 * Scope a middleware's `tool`-level hooks to only fire for a
 * specific tool name (or a set of names). `execute` and `trip`
@@ -1354,7 +1354,7 @@ function forTool(toolNames, middleware) {
 }
 
 //#endregion
-//#region ../../@warlock.js/ai/src/middleware/pipeline.ts
+//#region ../@warlock.js/ai/src/middleware/pipeline.ts
 const LOG_MODULE$1 = "ai.middleware";
 /**
 * Run an inner async operation through a stack of agent middlewares
@@ -1452,7 +1452,7 @@ async function runPipeline(middlewares, level, context, inner, logger) {
 }
 
 //#endregion
-//#region ../../@warlock.js/ai/src/utils/compute-cost.ts
+//#region ../@warlock.js/ai/src/utils/compute-cost.ts
 /**
 * Compute a per-channel USD cost breakdown for a single `Usage` against
 * a model's pricing table. Returns `undefined` when no pricing is
@@ -1537,7 +1537,7 @@ function sumOptional(parent, child) {
 }
 
 //#endregion
-//#region ../../@warlock.js/ai/src/utils/extract-json-payload.ts
+//#region ../@warlock.js/ai/src/utils/extract-json-payload.ts
 /**
 * Strip markdown code fences from an LLM response before JSON parsing.
 *
@@ -1574,7 +1574,7 @@ function extractJsonPayload(text) {
 }
 
 //#endregion
-//#region ../../@warlock.js/ai/src/utils/generate-run-id.ts
+//#region ../@warlock.js/ai/src/utils/generate-run-id.ts
 /**
 * Generates a stable, human-readable run id for any execution node
 * (tool invocation, agent run, workflow run, supervisor run). Format:
@@ -1595,7 +1595,7 @@ function generateRunId(prefix) {
 }
 
 //#endregion
-//#region ../../@warlock.js/ai/src/utils/json-schema.ts
+//#region ../@warlock.js/ai/src/utils/json-schema.ts
 /**
 * Best-effort JSON Schema extraction from a Standard Schema instance.
 *
@@ -1682,7 +1682,7 @@ function extractFromCandidateKeys(schemaRecord) {
 }
 
 //#endregion
-//#region ../../@warlock.js/ai/src/utils/resolve-attachment.ts
+//#region ../@warlock.js/ai/src/utils/resolve-attachment.ts
 const REMOTE_URL_PATTERN = /^https?:\/\//i;
 /**
 * Normalize a user-supplied `Attachment` (or bare `AttachmentSource`)
@@ -1750,7 +1750,7 @@ function resolveSource(source) {
 }
 
 //#endregion
-//#region ../../@warlock.js/ai/src/utils/prepare-attachment-part.ts
+//#region ../@warlock.js/ai/src/utils/prepare-attachment-part.ts
 const IMAGE_EXTENSIONS_TO_MEDIA_TYPE = {
 	".png": "image/png",
 	".jpg": "image/jpeg",
@@ -1882,7 +1882,7 @@ function stripQuery(path) {
 }
 
 //#endregion
-//#region ../../@warlock.js/ai/src/utils/safe-json-parse.ts
+//#region ../@warlock.js/ai/src/utils/safe-json-parse.ts
 /**
 * Parse a JSON string, returning a caller-supplied fallback when the input
 * is empty or malformed instead of throwing. Useful at provider boundaries
@@ -1902,7 +1902,7 @@ function safeJsonParse(data, defaultValue) {
 }
 
 //#endregion
-//#region ../../@warlock.js/ai/src/contracts/result/base-report.type.ts
+//#region ../@warlock.js/ai/src/contracts/result/base-report.type.ts
 /**
 * Wire-format version stamped on every root `BaseReport`. Bumped only
 * when we make a BREAKING change to the report shape (field removed,
@@ -1917,7 +1917,7 @@ function safeJsonParse(data, defaultValue) {
 const REPORT_SCHEMA_VERSION = 1;
 
 //#endregion
-//#region ../../@warlock.js/ai/src/utils/stamp-report-lineage.ts
+//#region ../@warlock.js/ai/src/utils/stamp-report-lineage.ts
 /**
 * Walk a freshly-built report tree and stamp lineage fields onto
 * every node:
@@ -1960,7 +1960,7 @@ function walk(node, rootRunId, parentRunId, sessionId) {
 }
 
 //#endregion
-//#region ../../@warlock.js/ai/src/utils/token-count.ts
+//#region ../@warlock.js/ai/src/utils/token-count.ts
 /**
 * Approximate the number of tokens in a string.
 *
@@ -1976,7 +1976,7 @@ function approximateTokenCount(text) {
 }
 
 //#endregion
-//#region ../../@warlock.js/ai/src/agent/agent-input-builder.ts
+//#region ../@warlock.js/ai/src/agent/agent-input-builder.ts
 /**
 * Assemble the seed conversation for an agent execution. Runs exactly
 * once per run — subsequent trips append to the same message list.
@@ -2079,7 +2079,7 @@ function resolveStructuredOutput(params) {
 }
 
 //#endregion
-//#region ../../@warlock.js/ai/src/agent/agent-log-event.ts
+//#region ../@warlock.js/ai/src/agent/agent-log-event.ts
 /**
 * Structured logging for agent lifecycle events. Mirrors
 * `Execution.emit`'s call sites without touching class state — the
@@ -2178,7 +2178,7 @@ function logAgentEvent(logger, ctx, event, payload) {
 }
 
 //#endregion
-//#region ../../@warlock.js/ai/src/agent/agent-stream.ts
+//#region ../@warlock.js/ai/src/agent/agent-stream.ts
 function createAgentStream() {
 	const queue = [];
 	const pending = [];
@@ -2258,7 +2258,7 @@ function createAgentStream() {
 }
 
 //#endregion
-//#region ../../@warlock.js/ai/src/agent/agent-to-stream-event.ts
+//#region ../@warlock.js/ai/src/agent/agent-to-stream-event.ts
 /**
 * Map an internal `AgentEventMap` entry into the public `StreamEvent`
 * shape. Event names are the same dot-notation strings on both sides;
@@ -2342,7 +2342,7 @@ function agentEventToStreamEvent(event, payload) {
 }
 
 //#endregion
-//#region ../../@warlock.js/ai/src/agent/json-stream-guard.ts
+//#region ../@warlock.js/ai/src/agent/json-stream-guard.ts
 /**
 * Default cap on bytes accumulated in a single suspect buffer before
 * the guard gives up, flushes as text, and resets to pass-through.
@@ -2740,7 +2740,7 @@ function readObject(envelope, key) {
 }
 
 //#endregion
-//#region ../../@warlock.js/ai/src/agent/agent.ts
+//#region ../@warlock.js/ai/src/agent/agent.ts
 const LOG_MODULE = "ai.agent";
 /**
 * Detect abort-flavored errors surfaced by SDK HTTP layers — the
@@ -3691,7 +3691,7 @@ function resolveToolAction(tool, input) {
 }
 
 //#endregion
-//#region ../../@warlock.js/ai/src/tool/tool.ts
+//#region ../@warlock.js/ai/src/tool/tool.ts
 /**
 * Degraded `ToolContext` supplied when no caller threads one through
 * (`tool.invoke(input)` standalone, batch scripts, tests). Per
@@ -3842,7 +3842,7 @@ function tool(contract) {
 				};
 			};
 			let validationResult;
-			try {
+			if (contract.input) try {
 				validationResult = await contract.input["~standard"].validate(rawInput);
 			} catch (thrown) {
 				const message = thrown instanceof Error ? thrown.message : String(thrown);
@@ -3851,6 +3851,7 @@ function tool(contract) {
 					context: { toolName: contract.name }
 				}) });
 			}
+			else validationResult = { value: rawInput };
 			if (validationResult.issues) return finish({ error: new SchemaValidationError(`Validation failed: ${validationResult.issues.map((issue) => issue.message).join("; ")}`, {
 				issues: validationResult.issues,
 				context: { toolName: contract.name }
@@ -3868,7 +3869,7 @@ function tool(contract) {
 }
 
 //#endregion
-//#region ../../@warlock.js/ai/src/supervisor/as-tool.ts
+//#region ../@warlock.js/ai/src/supervisor/as-tool.ts
 /**
 * Wrap a `SupervisorContract` as a `ToolContract` so an outer agent
 * can invoke it from its tool-call loop. Mirrors
@@ -3942,7 +3943,7 @@ function coerceInput(value) {
 }
 
 //#endregion
-//#region ../../@warlock.js/ai/src/supervisor/emitter.ts
+//#region ../@warlock.js/ai/src/supervisor/emitter.ts
 /**
 * Three-tier supervisor event emitter — factory (definition) → instance
 * → per-execution. Mirrors `WorkflowEmitter` structurally; the only
@@ -3987,7 +3988,7 @@ function invoke$1(handler, payload) {
 }
 
 //#endregion
-//#region ../../@warlock.js/ai/src/supervisor/entries.ts
+//#region ../@warlock.js/ai/src/supervisor/entries.ts
 /**
 * Validate and normalize the `intents` map into resolved entries.
 * Runs at factory time — throws `SupervisorFailedError` on the first
@@ -4188,7 +4189,7 @@ function isWorkflowResult(raw) {
 }
 
 //#endregion
-//#region ../../@warlock.js/ai/src/contracts/end.type.ts
+//#region ../@warlock.js/ai/src/contracts/end.type.ts
 /**
 * Framework-global termination sentinel. Emitted by any primitive
 * whose control flow is routed through JSON-serializable strings —
@@ -4233,7 +4234,7 @@ function isWorkflowResult(raw) {
 const END = "__warlock:end__";
 
 //#endregion
-//#region ../../@warlock.js/ai/src/supervisor/cancellation.ts
+//#region ../@warlock.js/ai/src/supervisor/cancellation.ts
 /**
 * Build a `SupervisorCancelledError` from an `AbortSignal`. Extracts a
 * human-readable reason from `signal.reason` whether it was a string,
@@ -4250,7 +4251,7 @@ function createCancelledError(signal) {
 }
 
 //#endregion
-//#region ../../@warlock.js/ai/src/supervisor/router-prompt.ts
+//#region ../@warlock.js/ai/src/supervisor/router-prompt.ts
 /**
 * Build the per-turn user message the supervisor feeds to the router
 * agent. Carries everything the LLM needs to make a routing decision:
@@ -4298,7 +4299,7 @@ function safeStringify$1(value) {
 }
 
 //#endregion
-//#region ../../@warlock.js/ai/src/supervisor/decide.ts
+//#region ../@warlock.js/ai/src/supervisor/decide.ts
 /**
 * Unified dispatch decision entry — calls either the `route` callback
 * or the `router` agent based on the supervisor's configured mode and
@@ -4561,7 +4562,7 @@ function wrapRouteError(supervisorName, thrown) {
 }
 
 //#endregion
-//#region ../../@warlock.js/ai/src/supervisor/snapshot.ts
+//#region ../@warlock.js/ai/src/supervisor/snapshot.ts
 /**
 * Resolve the effective snapshot store: the supervisor's own
 * `snapshotStore` field wins; absent that, fall back to the global
@@ -4631,7 +4632,7 @@ function snapshotKey(runId) {
 }
 
 //#endregion
-//#region ../../@warlock.js/ai/src/supervisor/execution.ts
+//#region ../@warlock.js/ai/src/supervisor/execution.ts
 const DEFAULT_MAX_ITERATIONS = 10;
 const LOG_MODULE_BASE$1 = "ai.supervisor";
 /**
@@ -6482,7 +6483,7 @@ async function validateOutput(schema, value) {
 }
 
 //#endregion
-//#region ../../@warlock.js/ai/src/supervisor/signature.ts
+//#region ../@warlock.js/ai/src/supervisor/signature.ts
 /**
 * Deterministic structural fingerprint of a supervisor definition.
 * Persisted on every snapshot so `resume()` can detect drift between
@@ -6569,7 +6570,7 @@ function hash$1(input) {
 }
 
 //#endregion
-//#region ../../@warlock.js/ai/src/supervisor/supervisor-stream.ts
+//#region ../@warlock.js/ai/src/supervisor/supervisor-stream.ts
 /**
 * Factory mirroring `createAgentStream`. Returns a paired
 * `{ controller, stream }` — the `SupervisorExecution` pushes events
@@ -6656,7 +6657,7 @@ function createSupervisorStream() {
 }
 
 //#endregion
-//#region ../../@warlock.js/ai/src/supervisor/supervisor.ts
+//#region ../@warlock.js/ai/src/supervisor/supervisor.ts
 /**
 * `ai.supervisor(config)` — construct a `SupervisorContract`. Validates
 * the config at author time (throws `SupervisorFailedError` on bad
@@ -6782,7 +6783,7 @@ function generateRunId$2() {
 }
 
 //#endregion
-//#region ../../@warlock.js/ai/src/system-prompt/render-placeholders.ts
+//#region ../@warlock.js/ai/src/system-prompt/render-placeholders.ts
 const PLACEHOLDER_PATTERN = /\{\{\s*([^{}]+?)\s*\}\}/g;
 /**
 * Render a template string against a placeholders map, supporting dot-path
@@ -6838,7 +6839,7 @@ function lookupPath(source, path) {
 }
 
 //#endregion
-//#region ../../@warlock.js/ai/src/system-prompt/instruction.ts
+//#region ../@warlock.js/ai/src/system-prompt/instruction.ts
 /**
 * Concrete `InstructionContract` — a reusable directive block.
 *
@@ -6891,7 +6892,7 @@ function instruction(text) {
 }
 
 //#endregion
-//#region ../../@warlock.js/ai/src/system-prompt/persona.ts
+//#region ../@warlock.js/ai/src/system-prompt/persona.ts
 /**
 * Concrete `PersonaContract` — a reusable "who the agent is" block.
 *
@@ -6944,7 +6945,7 @@ function persona(text) {
 }
 
 //#endregion
-//#region ../../@warlock.js/ai/src/system-prompt/system-prompt.ts
+//#region ../@warlock.js/ai/src/system-prompt/system-prompt.ts
 /**
 * Concrete `SystemPromptContract` — an immutable layered prompt builder.
 *
@@ -7076,7 +7077,7 @@ function systemPrompt(input) {
 }
 
 //#endregion
-//#region ../../@warlock.js/ai/src/workflow/step.ts
+//#region ../@warlock.js/ai/src/workflow/step.ts
 /**
 * `ai.step(def)` — pass-through factory used for authoring. Returns
 * the definition object verbatim so the workflow engine can read it
@@ -7108,7 +7109,7 @@ function validate$1(def) {
 }
 
 //#endregion
-//#region ../../@warlock.js/ai/src/workflow/as-tool.ts
+//#region ../@warlock.js/ai/src/workflow/as-tool.ts
 /**
 * Wrap a `WorkflowInstance` as a `ToolContract` so an agent can invoke
 * it inside its tool-call loop. Closes the agent-calls-workflow
@@ -7157,7 +7158,7 @@ function asTool$1(workflowInstance, options) {
 }
 
 //#endregion
-//#region ../../@warlock.js/ai/src/workflow/emitter.ts
+//#region ../@warlock.js/ai/src/workflow/emitter.ts
 /**
 * Three-tier workflow event emitter — factory (definition) → instance →
 * per-execution. All matching handlers fire, in layer order. Handler
@@ -7195,7 +7196,7 @@ function invoke(handler, payload) {
 }
 
 //#endregion
-//#region ../../@warlock.js/ai/src/workflow/cancellation.ts
+//#region ../@warlock.js/ai/src/workflow/cancellation.ts
 /**
 * Build a `WorkflowCancelledError` from an `AbortSignal`, extracting
 * a human-readable reason from `signal.reason` (string | Error | any).
@@ -7234,7 +7235,7 @@ function sleep(ms, signal) {
 }
 
 //#endregion
-//#region ../../@warlock.js/ai/src/workflow/router.ts
+//#region ../@warlock.js/ai/src/workflow/router.ts
 /**
 * Resolve the next step to run after `step` completes. Tries
 * step-level `nextStep` first, then workflow-level, then falls
@@ -7285,7 +7286,7 @@ function nextDeclaredStep(definition, currentName) {
 }
 
 //#endregion
-//#region ../../@warlock.js/ai/src/workflow/run-scoped-emitter.ts
+//#region ../@warlock.js/ai/src/workflow/run-scoped-emitter.ts
 /**
 * Bind a factory-scoped `WorkflowEmitter` to one run's identity.
 *
@@ -7315,7 +7316,7 @@ function runScopedEmitter(emitter, identity) {
 }
 
 //#endregion
-//#region ../../@warlock.js/ai/src/workflow/snapshot.ts
+//#region ../@warlock.js/ai/src/workflow/snapshot.ts
 /**
 * Resolve the effective snapshot store: the workflow's own
 * `snapshotStore` field wins; absent that, fall back to the global
@@ -7379,7 +7380,7 @@ async function loadSnapshotForResume$1(params) {
 }
 
 //#endregion
-//#region ../../@warlock.js/ai/src/workflow/state.ts
+//#region ../@warlock.js/ai/src/workflow/state.ts
 /**
 * Deep-clone workflow state. Uses `structuredClone` — handles Date,
 * Map, Set, ArrayBuffer, nested objects, arrays, primitives. Throws
@@ -7411,7 +7412,7 @@ function deepFreeze(value) {
 }
 
 //#endregion
-//#region ../../@warlock.js/ai/src/workflow/retry.ts
+//#region ../@warlock.js/ai/src/workflow/retry.ts
 const DEFAULT_BACKOFF_CAP_MS = 3e4;
 function resolveBackoff(attempt, backoff) {
 	const value = (() => {
@@ -7441,7 +7442,7 @@ function resolveRetryConfig(step, workflowDefault) {
 }
 
 //#endregion
-//#region ../../@warlock.js/ai/src/workflow/step-runner.ts
+//#region ../@warlock.js/ai/src/workflow/step-runner.ts
 /**
 * Narrow an `executionResult` to an `AgentResult` when the step ran
 * an agent. Custom `run` steps return arbitrary values, so the
@@ -7800,7 +7801,7 @@ async function validateSchema(schema, value) {
 }
 
 //#endregion
-//#region ../../@warlock.js/ai/src/workflow/engine.ts
+//#region ../@warlock.js/ai/src/workflow/engine.ts
 const DEFAULT_MAX_STEPS = 100;
 const DEFAULT_LOOP_WARN = 5;
 const LOG_MODULE_BASE = "ai.workflow";
@@ -8143,7 +8144,7 @@ async function validateWorkflowOutput(schema, value) {
 }
 
 //#endregion
-//#region ../../@warlock.js/ai/src/workflow/signature.ts
+//#region ../@warlock.js/ai/src/workflow/signature.ts
 function stepFingerprint(step) {
 	const tag = step.parallel ? "parallel" : step.agent ? "agent" : step.run ? "run" : "empty";
 	const agentName = step.agent?.name;
@@ -8175,7 +8176,7 @@ function computeSignature(definition) {
 }
 
 //#endregion
-//#region ../../@warlock.js/ai/src/workflow/workflow.ts
+//#region ../@warlock.js/ai/src/workflow/workflow.ts
 /**
 * `ai.workflow(def)` — construct a `WorkflowInstance`. Validates the
 * definition, computes a stable structural signature, and wires up the
@@ -8281,7 +8282,7 @@ function generateRunId$1() {
 }
 
 //#endregion
-//#region ../../@warlock.js/ai/src/ai.ts
+//#region ../@warlock.js/ai/src/ai.ts
 /**
 * Top-level `ai` namespace — holds built-in factories and user-registered SDK adapters.
 *
@@ -8329,7 +8330,7 @@ const ai = {
 };
 
 //#endregion
-//#region ../../@warlock.js/ai/src/mock/mock-model.ts
+//#region ../@warlock.js/ai/src/mock/mock-model.ts
 /**
 * Deterministic in-memory `ModelContract` implementation for tests.
 *
@@ -8477,7 +8478,7 @@ var MockModel = class {
 };
 
 //#endregion
-//#region ../../@warlock.js/ai/src/mock/mock-sdk.ts
+//#region ../@warlock.js/ai/src/mock/mock-sdk.ts
 /**
 * Creates a mock SDK adapter for testing — no HTTP calls, fully configurable.
 *
@@ -8509,7 +8510,7 @@ function MockSDK(config = {}) {
 }
 
 //#endregion
-//#region ../../@warlock.js/ai/src/mock/mock-agent.ts
+//#region ../@warlock.js/ai/src/mock/mock-agent.ts
 /**
 * Test helper that wires `MockSDK` → mock model → `agent()` in one call.
 *