@warlock.js/core 4.7.0 → 4.8.1

package/esm/ai/src/supervisor/router-factory.mjs.map

@@ -1 +0,0 @@
-{"version":3,"file":"router-factory.mjs","names":[],"sources":["../../../../../../../../../@warlock.js/ai/src/supervisor/router-factory.ts"],"sourcesContent":["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"],"mappings":";;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;AAqHA,SAAgB,OAAO,QAAmD;CACxE,IAAI,CAAC,OAAO,OACV,MAAM,IAAI,UAAU,gCAAgC;CAGtD,IAAI,CAAC,OAAO,WAAW,OAAO,OAAO,YAAY,UAC/C,MAAM,IAAI,UAAU,wDAAwD;CAG9E,MAAM,cAAc,OAAO,KAAK,OAAO,OAAO;CAE9C,IAAI,YAAY,WAAW,GACzB,MAAM,IAAI,UAAU,sDAAsD;CAG5E,MAAM,gBAAgB,yBAAyB,OAAO,SAAS,cAAc,OAAO,YAAY,CAAC;CAEjG,OAAO,MAAoB;EACzB,MAAM,OAAO,QAAQ;EACrB,aAAa;EACb,OAAO,OAAO;EACd,cAAc;EACd,QAAQ,mBAAmB,WAAW;EACtC,cAAc,OAAO;EACrB,cAAc,OAAO;EACrB,UAAU,OAAO,YAAY;EAC7B,IAAI,OAAO;CACb,CAAC;AACH;;;;;;AAOA,SAAS,cAAc,QAAuE;CAC5F,IAAI,CAAC,QACH;CAGF,OAAO,OAAO,WAAW,WAAW,SAAS,OAAO,QAAQ;AAC9D;;;;;;AAOA,SAAS,yBAAyB,SAAwB,QAAoC;CAC5F,MAAM,cAAc,OAAO,QAAQ,OAAO,CAAC,CAAC,KAAK,CAAC,MAAM,WAAW;EACjE,MAAM,cAAc,yBAAyB,KAAK;EAElD,OAAO,cAAc,KAAK,KAAK,IAAI,gBAAgB,KAAK;CAC1D,CAAC;CAED,MAAM,WAAqB,CAAC;CAE5B,IAAI,UAAU,OAAO,KAAK,CAAC,CAAC,SAAS,GACnC,SAAS,KAAK,OAAO,KAAK,GAAG,EAAE;CAGjC,SAAS,KACP,gGACA,IACA,sBACA,GAAG,aACH,IACA,oBACA,KAAK,IAAI,wDACT,IACA,UACA,4GACA,gEACA,mDACF;CAEA,OAAO,SAAS,KAAK,IAAI;AAC3B;;;;;;;;AASA,SAAS,yBAAyB,OAAkD;CAClF,IAAI,CAAC,SAAS,OAAO,UAAU,YAC7B;CAGF,MAAM,QAAQ;CAKd,IAAI,OAAO,MAAM,gBAAgB,YAAY,MAAM,YAAY,KAAK,CAAC,CAAC,SAAS,GAC7E,OAAO,MAAM,YAAY,KAAK;CAGhC,MAAM,mBAAmB,MAAM,OAAO;CAEtC,IAAI,OAAO,qBAAqB,YAAY,iBAAiB,KAAK,CAAC,CAAC,SAAS,GAC3E,OAAO,iBAAiB,KAAK;AAIjC;;;;;;;;;AAUA,SAAS,mBAAmB,aAAuD;CAGjF,MAAM,aAAa;EACjB,MAAM;EACN,YAAY;GACV,MAAM;IACJ,MAAM;IACN,MAAM,CAPM,GAAG,aAAa,GAOf;IACb,aAAa;GACf;GACA,WAAW;IACT,MAAM;IACN,aAAa;GACf;EACF;EACA,UAAU,CAAC,QAAQ,WAAW;EAC9B,sBAAsB;CACxB;CAEA,OAAO,EACL,aAAa;EACX,SAAS;EACT,QAAQ;EACR,YAAY,EACV,aAAa,WACf;EACA,SAAS,OAAuD;GAC9D,IAAI,CAAC,SAAS,OAAO,UAAU,UAC7B,OAAO,EAAE,QAAQ,CAAC,EAAE,SAAS,kCAAkC,CAAC,EAAE;GAGpE,MAAM,SAAS;GACf,MAAM,UAAU,OAAO;GAMvB,IAAI,EAHF,OAAO,YAAY,YAClB,MAAM,QAAQ,OAAO,KAAK,QAAQ,OAAO,YAAY,OAAO,YAAY,QAAQ,IAGjF,OAAO,EACL,QAAQ,CACN,EAAE,SAAS,uEAAuE,CACpF,EACF;GAKF,OAAO,EACL,OAAO;IAAE,MAAM;IAAiB,WAHhB,OAAO,OAAO,cAAc,WAAW,OAAO,YAAY;GAGhC,EAC5C;EACF;CACF,EAGF;AACF"}

package/esm/ai/src/supervisor/router-prompt.mjs

@@ -1,52 +0,0 @@
-import { END } from "../contracts/end.type.mjs";
-
-//#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:
-*
-* - Available intents with descriptions (so the router knows what
-*   to pick from).
-* - The reserved `END` sentinel value it can emit to terminate.
-* - Iteration counter + ceiling so the router can pace itself.
-* - Compact history of prior iterations (intent + short output clip).
-* - The supervisor's original input so the router stays anchored.
-*
-* Note the router's own `systemPrompt` is kept persistent across
-* turns — this function produces only the per-turn USER message.
-*/
-function buildRouterContextMessage(params) {
-	const { entries, iteration, maxIterations, iterations, input, state, feedback, supervisorPrompt, goal } = params;
-	const intentLines = [...entries.values()].map((entry) => `- ${entry.intent}: ${entry.description}`);
-	const historyLines = iterations.length === 0 ? ["(none yet)"] : iterations.map((snapshot) => formatHistoryLine(snapshot));
-	const sections = [];
-	if (supervisorPrompt) sections.push(supervisorPrompt.trim(), "");
-	if (goal) sections.push("Goal:", goal.trim(), "");
-	sections.push("Available intents:", ...intentLines, "", "Reserved values:", `- ${END} = terminate the run`, "", `Iteration: ${iteration + 1} / ${maxIterations}`, "", "History:", ...historyLines);
-	if (state && Object.keys(state).length > 0) sections.push("", "Current state:", safeStringify(state));
-	if (feedback) sections.push("", `Reviewer feedback from last iteration: ${feedback}`);
-	const renderedInput = typeof input === "string" ? input : safeStringify(input);
-	sections.push("", `Original input: ${renderedInput}`);
-	return sections.join("\n");
-}
-function formatHistoryLine(snapshot) {
-	const branches = Object.entries(snapshot.result).map(([intent, branch]) => `${intent} → ${clip(branch.output)}`);
-	return `[${snapshot.iteration}] ${branches.join(" | ")}`;
-}
-function clip(value, maxLength = 160) {
-	if (value === void 0 || value === null) return String(value);
-	const raw = typeof value === "string" ? value : safeStringify(value);
-	if (raw.length <= maxLength) return raw;
-	return `${raw.slice(0, maxLength - 1)}…`;
-}
-function safeStringify(value) {
-	try {
-		return JSON.stringify(value);
-	} catch {
-		return `[unserializable: ${typeof value}]`;
-	}
-}
-
-//#endregion
-export { buildRouterContextMessage };
-//# sourceMappingURL=router-prompt.mjs.map

package/esm/ai/src/supervisor/router-prompt.mjs.map

@@ -1 +0,0 @@
-{"version":3,"file":"router-prompt.mjs","names":[],"sources":["../../../../../../../../../@warlock.js/ai/src/supervisor/router-prompt.ts"],"sourcesContent":["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"],"mappings":";;;;;;;;;;;;;;;;;AAmBA,SAAgB,0BAA0B,QAiC/B;CACT,MAAM,EACJ,SACA,WACA,eACA,YACA,OACA,OACA,UACA,kBACA,SACE;CAEJ,MAAM,cAAc,CAAC,GAAG,QAAQ,OAAO,CAAC,CAAC,CAAC,KACxC,UAAS,KAAK,MAAM,OAAO,IAAI,MAAM,aACvC;CAEA,MAAM,eACJ,WAAW,WAAW,IAClB,CAAC,YAAY,IACb,WAAW,KAAI,aAAY,kBAAkB,QAAQ,CAAC;CAE5D,MAAM,WAAqB,CAAC;CAE5B,IAAI,kBACF,SAAS,KAAK,iBAAiB,KAAK,GAAG,EAAE;CAG3C,IAAI,MACF,SAAS,KAAK,SAAS,KAAK,KAAK,GAAG,EAAE;CAGxC,SAAS,KACP,sBACA,GAAG,aACH,IACA,oBACA,KAAK,IAAI,uBACT,IACA,cAAc,YAAY,EAAE,KAAK,iBACjC,IACA,YACA,GAAG,YACL;CAEA,IAAI,SAAS,OAAO,KAAK,KAAK,CAAC,CAAC,SAAS,GACvC,SAAS,KAAK,IAAI,kBAAkB,cAAc,KAAK,CAAC;CAG1D,IAAI,UACF,SAAS,KAAK,IAAI,0CAA0C,UAAU;CAGxE,MAAM,gBACJ,OAAO,UAAU,WAAW,QAAQ,cAAc,KAAK;CAEzD,SAAS,KAAK,IAAI,mBAAmB,eAAe;CAEpD,OAAO,SAAS,KAAK,IAAI;AAC3B;AAEA,SAAS,kBAAkB,UAAqC;CAC9D,MAAM,WAAW,OAAO,QAAQ,SAAS,MAAM,CAAC,CAAC,KAC9C,CAAC,QAAQ,YAAY,GAAG,OAAO,KAAK,KAAK,OAAO,MAAM,GACzD;CAEA,OAAO,IAAI,SAAS,UAAU,IAAI,SAAS,KAAK,KAAK;AACvD;AAEA,SAAS,KAAK,OAAgB,YAAY,KAAa;CACrD,IAAI,UAAU,UAAa,UAAU,MACnC,OAAO,OAAO,KAAK;CAGrB,MAAM,MAAM,OAAO,UAAU,WAAW,QAAQ,cAAc,KAAK;CAEnE,IAAI,IAAI,UAAU,WAChB,OAAO;CAGT,OAAO,GAAG,IAAI,MAAM,GAAG,YAAY,CAAC,EAAE;AACxC;AAEA,SAAS,cAAc,OAAwB;CAC7C,IAAI;EACF,OAAO,KAAK,UAAU,KAAK;CAC7B,QAAQ;EACN,OAAO,oBAAoB,OAAO,MAAM;CAC1C;AACF"}

package/esm/ai/src/supervisor/signature.mjs

@@ -1,89 +0,0 @@
-//#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
-* the saved run and the current definition. Covers:
-*
-* - Supervisor name.
-* - Every intent key + its resolved description + the underlying
-*   unit's stable identity (agent name, workflow name + signature,
-*   or `"callback"` marker for dev-callback intents).
-* - Router agent's name (if the supervisor uses LLM routing).
-* - Whether a deterministic `route` callback is configured (but not
-*   its contents — route callbacks are code, not data).
-* - Whether an `evaluate` callback is configured.
-* - `initialAgent` when set.
-* - `maxIterations` (a semantic shape change, not a cosmetic one).
-*
-* Does NOT cover: system prompt text, logger, store identity, per-
-* event handlers — all runtime knobs that don't change the shape of
-* a resumable run.
-*/
-function computeSignature(config, entries) {
-	const intentsFingerprint = [...entries.entries()].sort(([a], [b]) => a.localeCompare(b)).map(([intent, entry]) => ({
-		k: intent,
-		d: entry.description,
-		u: fingerprintUnit(entry)
-	}));
-	const fingerprint = {
-		n: config.name,
-		a: intentsFingerprint,
-		r: resolveRouterName(config.router),
-		rc: config.route ? 1 : 0,
-		e: config.evaluate ? 1 : 0,
-		i: config.initialAgent ?? null,
-		m: config.maxIterations ?? null,
-		c: resolveClassifierFingerprint(config.classifier)
-	};
-	return hash(JSON.stringify(fingerprint));
-}
-function resolveRouterName(router) {
-	if (!router) return null;
-	if (typeof router.execute === "function") return router.name ?? null;
-	return router.agent?.name ?? null;
-}
-function resolveClassifierFingerprint(classifier) {
-	if (!classifier) return null;
-	if (typeof classifier === "function") return { t: "callback" };
-	if (typeof classifier.execute === "function") return {
-		t: "agent",
-		n: classifier.name ?? null
-	};
-	if (typeof classifier.run === "function") return { t: "callback" };
-	if (typeof classifier.agent?.execute === "function") return {
-		t: "agent",
-		n: classifier.agent?.name ?? null
-	};
-	return { t: "unknown" };
-}
-function fingerprintUnit(entry) {
-	if (entry.type === "callback") return { t: "callback" };
-	if (entry.type === "workflow") {
-		const workflow = entry.unit;
-		return {
-			t: "workflow",
-			n: workflow.name,
-			s: workflow.signature
-		};
-	}
-	return {
-		t: "agent",
-		n: entry.unit.name
-	};
-}
-/**
-* FNV-1a 32-bit — same hash `workflow/signature.ts` uses. Deterministic,
-* no crypto dependency, cheap; signatures are 8-char hex.
-*/
-function hash(input) {
-	let h = 2166136261;
-	for (let i = 0; i < input.length; i++) {
-		h ^= input.charCodeAt(i);
-		h = h + ((h << 1) + (h << 4) + (h << 7) + (h << 8) + (h << 24)) >>> 0;
-	}
-	return h.toString(16).padStart(8, "0");
-}
-
-//#endregion
-export { computeSignature };
-//# sourceMappingURL=signature.mjs.map

package/esm/ai/src/supervisor/signature.mjs.map

@@ -1 +0,0 @@
-{"version":3,"file":"signature.mjs","names":[],"sources":["../../../../../../../../../@warlock.js/ai/src/supervisor/signature.ts"],"sourcesContent":["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"],"mappings":";;;;;;;;;;;;;;;;;;;;;AAwBA,SAAgB,iBACd,QACA,SACQ;CACR,MAAM,qBAAqB,CAAC,GAAG,QAAQ,QAAQ,CAAC,CAAC,CAC9C,MAAM,CAAC,IAAI,CAAC,OAAO,EAAE,cAAc,CAAC,CAAC,CAAC,CACtC,KAAK,CAAC,QAAQ,YAAY;EACzB,GAAG;EACH,GAAG,MAAM;EACT,GAAG,gBAAgB,KAAK;CAC1B,EAAE;CAEJ,MAAM,cAAc;EAClB,GAAG,OAAO;EACV,GAAG;EACH,GAAG,kBAAkB,OAAO,MAAM;EAClC,IAAI,OAAO,QAAQ,IAAI;EACvB,GAAG,OAAO,WAAW,IAAI;EACzB,GAAG,OAAO,gBAAgB;EAC1B,GAAG,OAAO,iBAAiB;EAK3B,GAAG,6BAA6B,OAAO,UAAU;CACnD;CAEA,OAAO,KAAK,KAAK,UAAU,WAAW,CAAC;AACzC;AAEA,SAAS,kBAAkB,QAA4D;CACrF,IAAI,CAAC,QACH,OAAO;CAGT,IAAI,OAAQ,OAAiC,YAAY,YACvD,OAAQ,OAA6B,QAAQ;CAG/C,OAAQ,OAAyC,OAAO,QAAQ;AAClE;AAEA,SAAS,6BACP,YACS;CACT,IAAI,CAAC,YACH,OAAO;CAGT,IAAI,OAAO,eAAe,YACxB,OAAO,EAAE,GAAG,WAAW;CAGzB,IAAI,OAAQ,WAAqC,YAAY,YAC3D,OAAO;EAAE,GAAG;EAAS,GAAI,WAAiC,QAAQ;CAAK;CAGzE,IAAI,OAAQ,WAAkC,QAAQ,YACpD,OAAO,EAAE,GAAG,WAAW;CAGzB,IAAI,OAAQ,WAAoC,OAAO,YAAY,YACjE,OAAO;EACL,GAAG;EACH,GAAI,WAAoC,OAAO,QAAQ;CACzD;CAGF,OAAO,EAAE,GAAG,UAAU;AACxB;AAEA,SAAS,gBAAgB,OAAqC;CAC5D,IAAI,MAAM,SAAS,YAKjB,OAAO,EAAE,GAAG,WAAW;CAGzB,IAAI,MAAM,SAAS,YAAY;EAC7B,MAAM,WAAW,MAAM;EACvB,OAAO;GAAE,GAAG;GAAY,GAAG,SAAS;GAAM,GAAG,SAAS;EAAU;CAClE;CAEA,OAAO;EAAE,GAAG;EAAS,GAAG,MAAM,KAAK;CAAK;AAC1C;;;;;AAMA,SAAS,KAAK,OAAuB;CACnC,IAAI,IAAI;CAER,KAAK,IAAI,IAAI,GAAG,IAAI,MAAM,QAAQ,KAAK;EACrC,KAAK,MAAM,WAAW,CAAC;EACvB,IAAK,MAAM,KAAK,MAAM,KAAK,MAAM,KAAK,MAAM,KAAK,MAAM,KAAK,SAAU;CACxE;CAEA,OAAO,EAAE,SAAS,EAAE,CAAC,CAAC,SAAS,GAAG,GAAG;AACvC"}

package/esm/ai/src/supervisor/snapshot.mjs

@@ -1,69 +0,0 @@
-import { SupervisorFailedError } from "../errors/supervisor-failed-error.mjs";
-import { SupervisorDriftError } from "../errors/supervisor-drift-error.mjs";
-import "../errors/index.mjs";
-import { resolveDefaultSnapshotStore } from "../config.mjs";
-
-//#region ../@warlock.js/ai/src/supervisor/snapshot.ts
-/**
-* Resolve the effective {@link SnapshotStore}: the supervisor's own
-* `snapshotStore` field wins; absent that, fall back to the global
-* default set via `ai.config({ defaultSnapshotStore })`.
-*/
-function resolveSnapshotStore(config) {
-	return config.snapshotStore ?? resolveDefaultSnapshotStore();
-}
-/**
-* Write the current run state to the resolved snapshot store. No-op
-* (ok) when neither the supervisor's `snapshotStore` nor the global
-* `defaultStore` is configured. Failures are returned as
-* `{ ok: false }` rather than thrown so the engine can surface them
-* via events/logs without aborting the run — callers decide whether
-* a failed checkpoint is fatal.
-*/
-async function persistSupervisorSnapshot(params) {
-	const store = resolveSnapshotStore(params.config);
-	if (!store) return { ok: true };
-	const snapshot = {
-		runId: params.runId,
-		supervisorName: params.config.name,
-		signature: params.signature,
-		input: params.input,
-		iteration: params.iteration,
-		snapshots: params.snapshots,
-		status: params.status,
-		startedAt: params.startedAt,
-		savedAt: (/* @__PURE__ */ new Date()).toISOString()
-	};
-	try {
-		await store.save(snapshot);
-		return { ok: true };
-	} catch (error) {
-		return {
-			ok: false,
-			error
-		};
-	}
-}
-/**
-* Load a persisted snapshot for `resume()` and run the drift check.
-* Throws `SupervisorFailedError` when no store is configured or when
-* the run is missing; throws `SupervisorDriftError` when the stored
-* signature doesn't match the current definition (unless `force` is
-* set).
-*/
-async function loadSnapshotForResume(params) {
-	const store = resolveSnapshotStore(params.config);
-	if (!store) throw new SupervisorFailedError(`supervisor "${params.config.name}" has no store configured — set \`snapshotStore\` on the config or call \`ai.config({ defaultSnapshotStore })\` at boot before calling resume()`, { context: { runId: params.runId } });
-	const snapshot = await store.load(params.runId) ?? null;
-	if (!snapshot) throw new SupervisorFailedError(`supervisor "${params.config.name}": no snapshot for runId "${params.runId}"`, { context: { runId: params.runId } });
-	if (!params.options?.force && snapshot.signature !== params.signature) throw new SupervisorDriftError(`supervisor "${params.config.name}" signature drift on resume`, {
-		savedSignature: snapshot.signature,
-		currentSignature: params.signature,
-		runId: params.runId
-	});
-	return snapshot;
-}
-
-//#endregion
-export { loadSnapshotForResume, persistSupervisorSnapshot };
-//# sourceMappingURL=snapshot.mjs.map

package/esm/ai/src/supervisor/snapshot.mjs.map

@@ -1 +0,0 @@
-{"version":3,"file":"snapshot.mjs","names":[],"sources":["../../../../../../../../../@warlock.js/ai/src/supervisor/snapshot.ts"],"sourcesContent":["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"],"mappings":";;;;;;;;;;;AAgBA,SAAS,qBAAqB,QAAmC;CAC/D,OAAO,OAAO,iBAAiB,4BAA4B;AAC7D;;;;;;;;;AAuBA,eAAsB,0BACpB,QACyB;CACzB,MAAM,QAAQ,qBAAqB,OAAO,MAAM;CAEhD,IAAI,CAAC,OACH,OAAO,EAAE,IAAI,KAAK;CAGpB,MAAM,WAA+B;EACnC,OAAO,OAAO;EACd,gBAAgB,OAAO,OAAO;EAC9B,WAAW,OAAO;EAClB,OAAO,OAAO;EACd,WAAW,OAAO;EAClB,WAAW,OAAO;EAClB,QAAQ,OAAO;EACf,WAAW,OAAO;EAClB,0BAAS,IAAI,KAAK,EAAC,CAAC,YAAY;CAClC;CAEA,IAAI;EACF,MAAM,MAAM,KAAK,QAAQ;EAEzB,OAAO,EAAE,IAAI,KAAK;CACpB,SAAS,OAAO;EACd,OAAO;GAAE,IAAI;GAAO;EAAM;CAC5B;AACF;;;;;;;;AASA,eAAsB,sBAAsB,QAKZ;CAC9B,MAAM,QAAQ,qBAAqB,OAAO,MAAM;CAEhD,IAAI,CAAC,OACH,MAAM,IAAI,sBACR,eAAe,OAAO,OAAO,KAAK,kJAClC,EAAE,SAAS,EAAE,OAAO,OAAO,MAAM,EAAE,CACrC;CAGF,MAAM,WAAY,MAAM,MAAM,KAAK,OAAO,KAAK,KAAM;CAErD,IAAI,CAAC,UACH,MAAM,IAAI,sBACR,eAAe,OAAO,OAAO,KAAK,4BAA4B,OAAO,MAAM,IAC3E,EAAE,SAAS,EAAE,OAAO,OAAO,MAAM,EAAE,CACrC;CAGF,IAAI,CAAC,OAAO,SAAS,SAAS,SAAS,cAAc,OAAO,WAC1D,MAAM,IAAI,qBACR,eAAe,OAAO,OAAO,KAAK,8BAClC;EACE,gBAAgB,SAAS;EACzB,kBAAkB,OAAO;EACzB,OAAO,OAAO;CAChB,CACF;CAGF,OAAO;AACT"}

package/esm/ai/src/supervisor/supervisor-stream.mjs

@@ -1,89 +0,0 @@
-//#region ../@warlock.js/ai/src/supervisor/supervisor-stream.ts
-/**
-* Factory mirroring `createAgentStream`. Returns a paired
-* `{ controller, stream }` — the `SupervisorExecution` pushes events
-* into the controller while the caller iterates (or awaits `.result`)
-* on the stream side. See `agent-stream.ts` for the full role
-* description.
-*/
-function createSupervisorStream() {
-	const queue = [];
-	const pending = [];
-	const handlers = /* @__PURE__ */ new Map();
-	let closed = false;
-	let failure;
-	let resolveResult;
-	let rejectResult;
-	const result = new Promise((resolve, reject) => {
-		resolveResult = resolve;
-		rejectResult = reject;
-	});
-	const controller = {
-		push(event) {
-			const handler = handlers.get(event.type);
-			if (handler) try {
-				handler(event);
-			} catch {}
-			const reader = pending.shift();
-			if (reader) {
-				reader.resolve({
-					value: event,
-					done: false
-				});
-				return;
-			}
-			queue.push(event);
-		},
-		end(finalResult) {
-			closed = true;
-			resolveResult(finalResult);
-			while (pending.length > 0) pending.shift()?.resolve({
-				value: void 0,
-				done: true
-			});
-		},
-		fail(error) {
-			closed = true;
-			failure = error;
-			rejectResult(error);
-			while (pending.length > 0) pending.shift()?.reject(error);
-		}
-	};
-	const iterator = { next() {
-		if (queue.length > 0) return Promise.resolve({
-			value: queue.shift(),
-			done: false
-		});
-		if (closed) {
-			if (failure) return Promise.reject(failure);
-			return Promise.resolve({
-				value: void 0,
-				done: true
-			});
-		}
-		return new Promise((resolve, reject) => {
-			pending.push({
-				resolve,
-				reject
-			});
-		});
-	} };
-	const stream = {
-		result,
-		on(handlerMap) {
-			for (const [key, handler] of Object.entries(handlerMap)) if (handler) handlers.set(key, handler);
-			return stream;
-		},
-		[Symbol.asyncIterator]() {
-			return iterator;
-		}
-	};
-	return {
-		controller,
-		stream
-	};
-}
-
-//#endregion
-export { createSupervisorStream };
-//# sourceMappingURL=supervisor-stream.mjs.map

package/esm/ai/src/supervisor/supervisor-stream.mjs.map

@@ -1 +0,0 @@
-{"version":3,"file":"supervisor-stream.mjs","names":[],"sources":["../../../../../../../../../@warlock.js/ai/src/supervisor/supervisor-stream.ts"],"sourcesContent":["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"],"mappings":";;;;;;;;AA+BA,SAAgB,yBAGd;CACA,MAAM,QAAiC,CAAC;CACxC,MAAM,UAAyB,CAAC;CAChC,MAAM,2BAAW,IAAI,IAAoD;CAEzE,IAAI,SAAS;CACb,IAAI;CACJ,IAAI;CACJ,IAAI;CAEJ,MAAM,SAAS,IAAI,SAAkB,SAAS,WAAW;EACvD,gBAAgB;EAChB,eAAe;CACjB,CAAC;CAED,MAAM,aAAkD;EACtD,KAAK,OAAO;GACV,MAAM,UAAU,SAAS,IAAI,MAAM,IAAI;GAEvC,IAAI,SACF,IAAI;IACF,QAAQ,KAAK;GACf,QAAQ,CAER;GAGF,MAAM,SAAS,QAAQ,MAAM;GAE7B,IAAI,QAAQ;IACV,OAAO,QAAQ;KAAE,OAAO;KAAO,MAAM;IAAM,CAAC;IAC5C;GACF;GAEA,MAAM,KAAK,KAAK;EAClB;EAEA,IAAI,aAAa;GACf,SAAS;GACT,cAAc,WAAW;GAEzB,OAAO,QAAQ,SAAS,GACtB,QAAQ,MAAM,CAAC,EAAE,QAAQ;IAAE,OAAO;IAAW,MAAM;GAAK,CAAC;EAE7D;EAEA,KAAK,OAAO;GACV,SAAS;GACT,UAAU;GACV,aAAa,KAAK;GAElB,OAAO,QAAQ,SAAS,GACtB,QAAQ,MAAM,CAAC,EAAE,OAAO,KAAK;EAEjC;CACF;CAEA,MAAM,WAAiD,EACrD,OAAO;EACL,IAAI,MAAM,SAAS,GACjB,OAAO,QAAQ,QAAQ;GAAE,OAAO,MAAM,MAAM;GAAI,MAAM;EAAM,CAAC;EAG/D,IAAI,QAAQ;GACV,IAAI,SACF,OAAO,QAAQ,OAAO,OAAO;GAG/B,OAAO,QAAQ,QAAQ;IAAE,OAAO;IAAW,MAAM;GAAK,CAAC;EACzD;EAEA,OAAO,IAAI,SACR,SAAS,WAAW;GACnB,QAAQ,KAAK;IAAE;IAAS;GAAO,CAAC;EAClC,CACF;CACF,EACF;CAQA,MAAM,SAAS;EACb;EACA,GAAG,YAAY;GACb,KAAK,MAAM,CAAC,KAAK,YAAY,OAAO,QAAQ,UAAU,GACpD,IAAI,SACF,SAAS,IAAI,KAAK,OAAiD;GAIvE,OAAO;EACT;EACA,CAAC,OAAO,iBAAiB;GACvB,OAAO;EACT;CACF;CAEA,OAAO;EAAE;EAAY;CAAO;AAC9B"}

package/esm/ai/src/supervisor/supervisor.mjs

@@ -1,144 +0,0 @@
-import { SupervisorFailedError } from "../errors/supervisor-failed-error.mjs";
-import "../errors/index.mjs";
-import { notifyObservers } from "../observe/resolve-observers.mjs";
-import { asTool } from "./as-tool.mjs";
-import { SupervisorEmitter } from "./emitter.mjs";
-import { assertRouterDescriptions, resolveIntentEntries } from "./entries.mjs";
-import { loadSnapshotForResume } from "./snapshot.mjs";
-import { SupervisorExecution } from "./execution.mjs";
-import { computeSignature } from "./signature.mjs";
-import { createSupervisorStream } from "./supervisor-stream.mjs";
-
-//#region ../@warlock.js/ai/src/supervisor/supervisor.ts
-/**
-* `ai.supervisor(config)` — construct a `SupervisorContract`. Validates
-* the config at author time (throws `SupervisorFailedError` on bad
-* shape), resolves agent entries, computes a stable structural
-* signature, wires the three-tier event emitter, and returns an
-* instance that satisfies `ExecutableContract` so it can compose into
-* tools, outer agents, and (future) orchestrators uniformly.
-*
-* @example
-* const support = ai.supervisor({
-*   name: "customer-support",
-*   router: routerAgent,
-*   intents: { triage, orderLookup, billingLookup, resolver },
-*   evaluate: (ctx) => ctx.result.resolver?.output ? { satisfied: true } : undefined,
-*   output: z.object({ response: z.string(), refund: z.boolean() }),
-*   maxIterations: 6,
-* });
-*/
-function supervisor(config) {
-	validateFactoryConfig(config);
-	const entries = resolveIntentEntries(config.intents, config.name);
-	assertRouterDescriptions(config, entries);
-	if (config.initialAgent && !entries.has(config.initialAgent)) throw new SupervisorFailedError(`ai.supervisor("${config.name}"): \`initialAgent\` "${config.initialAgent}" is not a key in \`intents\``, { context: { authoring: true } });
-	const signature = computeSignature(config, entries);
-	const emitter = new SupervisorEmitter(config.on);
-	async function execute(input, options) {
-		const result = await new SupervisorExecution({
-			config,
-			entries,
-			signature,
-			emitter,
-			input,
-			runId: options?.runId ?? generateRunId(),
-			options
-		}).run();
-		await notifyObservers(config.observe, result.report);
-		return result;
-	}
-	function stream(input, options) {
-		const runId = options?.runId ?? generateRunId();
-		const { controller, stream: contract } = createSupervisorStream();
-		new SupervisorExecution({
-			config,
-			entries,
-			signature,
-			emitter,
-			input,
-			runId,
-			options,
-			streamController: controller
-		}).run().then((result) => notifyObservers(config.observe, result.report));
-		return contract;
-	}
-	async function resume(runId, options) {
-		const snapshot = await loadSnapshotForResume({
-			config,
-			signature,
-			runId,
-			options
-		});
-		const result = await new SupervisorExecution({
-			config,
-			entries,
-			signature,
-			emitter,
-			input: snapshot.input,
-			runId,
-			options,
-			resumeFrom: snapshot
-		}).run();
-		await notifyObservers(config.observe, result.report);
-		return result;
-	}
-	const instance = {
-		name: config.name,
-		inputSchema: config.inputSchema,
-		signature,
-		execute,
-		stream,
-		resume,
-		on(event, handler) {
-			return emitter.on(event, handler);
-		},
-		off(event, handler) {
-			emitter.off(event, handler);
-		},
-		asTool(options) {
-			return asTool(instance, options);
-		}
-	};
-	return instance;
-}
-/**
-* Factory-time validation. Enforces the XOR + pairing rules the design
-* locked in §2 and surfaces any violation as a typed
-* `SupervisorFailedError` tagged `authoring: true`.
-*/
-function validateFactoryConfig(config) {
-	if (!config.name || typeof config.name !== "string") throw new SupervisorFailedError("ai.supervisor: `name` is required and must be a string", { context: { authoring: true } });
-	if (!config.intents || typeof config.intents !== "object") throw new SupervisorFailedError(`ai.supervisor("${config.name}"): \`intents\` is required`, { context: { authoring: true } });
-	const hasRoute = typeof config.route === "function";
-	const hasRouter = !!config.router;
-	if (hasRouter) {
-		const router = config.router;
-		const isBareAgent = typeof router.execute === "function";
-		const isEntryForm = !isBareAgent && typeof router.agent === "object" && typeof router.agent?.execute === "function";
-		if (!isBareAgent && !isEntryForm) throw new SupervisorFailedError(`ai.supervisor("${config.name}"): \`router\` must be an agent contract or a \`{ agent, placeholders?, input? }\` entry`, { context: { authoring: true } });
-	}
-	if (hasRoute && hasRouter) throw new SupervisorFailedError(`ai.supervisor("${config.name}"): \`route\` and \`router\` are mutually exclusive — configure exactly one`, { context: { authoring: true } });
-	const hasClassifier = config.classifier !== void 0;
-	if (!hasRoute && !hasRouter && !hasClassifier) throw new SupervisorFailedError(`ai.supervisor("${config.name}"): one of \`route\`, \`router\`, or \`classifier\` is required`, { context: { authoring: true } });
-	if (hasClassifier && config.initialAgent) throw new SupervisorFailedError(`ai.supervisor("${config.name}"): \`classifier\` and \`initialAgent\` are mutually exclusive — both decide which intent runs first. Pick one.`, { context: { authoring: true } });
-	if (config.ack !== void 0) {
-		const ack = config.ack;
-		const isCallback = typeof ack === "function";
-		const isAgentEntry = typeof ack === "object" && ack !== null && typeof ack.agent?.execute === "function";
-		const isRunEntry = typeof ack === "object" && ack !== null && typeof ack.run === "function";
-		if (!isCallback && !isAgentEntry && !isRunEntry) throw new SupervisorFailedError(`ai.supervisor("${config.name}"): \`ack\` must be an \`{ agent, ... }\` entry, an \`{ run, ... }\` entry, or a bare callback function`, { context: { authoring: true } });
-		if (isAgentEntry && isRunEntry) throw new SupervisorFailedError(`ai.supervisor("${config.name}"): \`ack\` cannot declare both \`agent\` and \`run\` — pick one`, { context: { authoring: true } });
-	}
-	if (config.maxIterations !== void 0 && config.maxIterations < 1) throw new SupervisorFailedError(`ai.supervisor("${config.name}"): \`maxIterations\` must be >= 1`, { context: {
-		authoring: true,
-		maxIterations: config.maxIterations
-	} });
-}
-function generateRunId() {
-	return `sup_${Date.now().toString(36)}_${Math.random().toString(36).slice(2, 10)}`;
-}
-
-//#endregion
-export { supervisor };
-//# sourceMappingURL=supervisor.mjs.map

package/esm/ai/src/supervisor/supervisor.mjs.map

@@ -1 +0,0 @@
-{"version":3,"file":"supervisor.mjs","names":[],"sources":["../../../../../../../../../@warlock.js/ai/src/supervisor/supervisor.ts"],"sourcesContent":["import type { SupervisorEventMap } from \"../contracts/events/event-map.type\";\nimport type { ExecutionReport } from \"../contracts/result/execution-report.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 { notifyObservers } from \"../observe/resolve-observers\";\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    const result = await execution.run();\n\n    // Route the finished report to any resolved observers (F1/F3).\n    // Gated by `config.observe` + the global observe-all flag; observer\n    // errors are swallowed inside `notifyObservers`. `ai.team(...)`\n    // forwards its `observe` into this same config, so a team inherits\n    // observability through here with no extra wiring. Bridge the\n    // pre-existing `SupervisorReport = Omit<BaseReport, \"type\">` drift\n    // (the report carries `type: \"supervisor\"` at runtime) so this call\n    // site adds no new type error beyond the documented baseline.\n    await notifyObservers(config.observe, result.report as unknown as ExecutionReport);\n\n    return result;\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    // Route the finished report to resolved observers once the streamed\n    // run settles. Attached to the run promise (not awaited — `stream`\n    // returns synchronously); `notifyObservers` swallows observer errors.\n    void execution\n      .run()\n      .then((result) =>\n        notifyObservers(config.observe, result.report as unknown as ExecutionReport),\n      );\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    const result = await execution.run();\n\n    await notifyObservers(config.observe, result.report as unknown as ExecutionReport);\n\n    return result;\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"],"mappings":"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"}

package/esm/ai/src/system-prompt/index.mjs

@@ -1,7 +0,0 @@
-import { renderPlaceholders } from "./render-placeholders.mjs";
-import { Instruction, instruction } from "./instruction.mjs";
-import { Persona, persona } from "./persona.mjs";
-import { RefinedSystemPrompt } from "./refined-system-prompt.mjs";
-import { SystemPrompt, systemPrompt } from "./system-prompt.mjs";
-
-export {  };

package/esm/ai/src/system-prompt/instruction.mjs

@@ -1,57 +0,0 @@
-import { renderPlaceholders } from "./render-placeholders.mjs";
-
-//#region ../@warlock.js/ai/src/system-prompt/instruction.ts
-/**
-* Concrete `InstructionContract` — a reusable directive block.
-*
-* **Role.** A single addressable prompt block representing one rule the
-* agent must follow (`"Always respond in {{language|English}}."`). Exists
-* as its own type so the same instruction can be shared across many
-* prompts and agents, each render supplying its own placeholder map.
-*
-* **Responsibility.**
-* - Owns: the `type: "instruction"` discriminator, the raw template text,
-*   and the placeholder-rendering step.
-* - Does NOT own: ordering relative to other instructions, joining with a
-*   persona, or any surrounding prompt composition — those concerns live
-*   in `SystemPrompt`.
-*
-* Users construct via the `ai.instruction()` factory — `new Instruction()`
-* is not the public API (see §4.2 of code-style.md).
-*
-* @example
-* const replyInLanguage = ai.instruction("Respond in {{language|English}}.");
-*
-* const prompt = ai.systemPrompt()
-*   .persona("You are Alex.")
-*   .instruction(replyInLanguage)
-*   .instruction("Always include code examples.");
-*/
-var Instruction = class {
-	constructor(text) {
-		this.text = text;
-		this.type = "instruction";
-	}
-	/**
-	* Substitute `{{mustache}}` placeholders in the instruction text against
-	* the supplied map. Delegates to the shared `renderPlaceholders` helper
-	* so persona / instruction / system-prompt rendering stays identical.
-	*/
-	resolve(placeholders) {
-		return renderPlaceholders(this.text, placeholders);
-	}
-};
-/**
-* Create an `Instruction` from raw template text.
-*
-* @example
-* const replyIn = instruction("Respond in {{language|English}}.");
-* const cite = instruction("Always cite sources inline.");
-*/
-function instruction(text) {
-	return new Instruction(text);
-}
-
-//#endregion
-export { Instruction, instruction };
-//# sourceMappingURL=instruction.mjs.map

package/esm/ai/src/system-prompt/instruction.mjs.map

@@ -1 +0,0 @@
-{"version":3,"file":"instruction.mjs","names":[],"sources":["../../../../../../../../../@warlock.js/ai/src/system-prompt/instruction.ts"],"sourcesContent":["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"],"mappings":";;;;;;;;;;;;;;;;;;;;;;;;;;;;;AA8BA,IAAa,cAAb,MAAwD;CAGtD,AAAO,YAAY,AAAgB,MAAc;EAAd;cAFZ;CAIvB;;;;;;CAOA,AAAO,QAAQ,cAAqC;EAClD,OAAO,mBAAmB,KAAK,MAAM,YAAY;CACnD;AACF;;;;;;;;AASA,SAAgB,YAAY,MAA2B;CACrD,OAAO,IAAI,YAAY,IAAI;AAC7B"}