@warlock.js/core 4.8.0 → 4.8.1

package/esm/ai/src/errors/step-failed-error.mjs

@@ -1,19 +0,0 @@
-import { WorkflowError } from "./workflow-error.mjs";
-
-//#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.
-*/
-var StepFailedError = class extends WorkflowError {
-	constructor(message, options) {
-		super(message, options, "STEP_FAILED");
-		this.name = "StepFailedError";
-		this.stepName = options.stepName;
-		this.attempts = options.attempts;
-	}
-};
-
-//#endregion
-export { StepFailedError };
-//# sourceMappingURL=step-failed-error.mjs.map

package/esm/ai/src/errors/step-failed-error.mjs.map

@@ -1 +0,0 @@
-{"version":3,"file":"step-failed-error.mjs","names":[],"sources":["../../../../../../../../../@warlock.js/ai/src/errors/step-failed-error.ts"],"sourcesContent":["import type { AIErrorOptions } from \"./ai-error\";\nimport { WorkflowError } from \"./workflow-error\";\n\nexport type StepFailedErrorOptions = AIErrorOptions & {\n  stepName: string;\n  attempts: number;\n};\n\n/**\n * A workflow step exhausted its retries (or was not retried) and\n * terminated with an error. `cause` carries the last underlying error.\n */\nexport class StepFailedError extends WorkflowError {\n  public readonly stepName: string;\n  public readonly attempts: number;\n\n  public constructor(message: string, options: StepFailedErrorOptions) {\n    super(message, options, \"STEP_FAILED\");\n    this.name = \"StepFailedError\";\n    this.stepName = options.stepName;\n    this.attempts = options.attempts;\n  }\n}\n"],"mappings":";;;;;;;AAYA,IAAa,kBAAb,cAAqC,cAAc;CAIjD,AAAO,YAAY,SAAiB,SAAiC;EACnE,MAAM,SAAS,SAAS,aAAa;EACrC,KAAK,OAAO;EACZ,KAAK,WAAW,QAAQ;EACxB,KAAK,WAAW,QAAQ;CAC1B;AACF"}

package/esm/ai/src/errors/supervisor-cancelled-error.mjs

@@ -1,29 +0,0 @@
-import { SupervisorFailedError } from "./supervisor-failed-error.mjs";
-
-//#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
-* cancellation is best-effort (the signal is also threaded into every
-* in-flight child `execute()` call, but effectiveness depends on the
-* child primitive respecting it).
-*
-* On cancellation the supervisor returns normally with `status:
-* "cancelled"` and partial `report.snapshots` — the error is placed
-* on `result.error` rather than thrown.
-*/
-var SupervisorCancelledError = class extends SupervisorFailedError {
-	static {
-		this.defaultCategory = "cancelled";
-	}
-	constructor(message, options) {
-		super(message, options, "SUPERVISOR_CANCELLED");
-		this.name = "SupervisorCancelledError";
-		this.cancelledAt = options.cancelledAt;
-		this.reason = options.reason;
-	}
-};
-
-//#endregion
-export { SupervisorCancelledError };
-//# sourceMappingURL=supervisor-cancelled-error.mjs.map

package/esm/ai/src/errors/supervisor-cancelled-error.mjs.map

@@ -1 +0,0 @@
-{"version":3,"file":"supervisor-cancelled-error.mjs","names":[],"sources":["../../../../../../../../../@warlock.js/ai/src/errors/supervisor-cancelled-error.ts"],"sourcesContent":["import type { AIErrorOptions } from \"./ai-error\";\nimport type { ErrorCategory } from \"./error-category.type\";\nimport { SupervisorFailedError } from \"./supervisor-failed-error\";\n\nexport type SupervisorCancelledErrorOptions = AIErrorOptions & {\n  /** ISO-8601 timestamp at which the abort was observed by the supervisor. */\n  cancelledAt: string;\n  /** `controller.abort(reason)` payload when the caller supplied one. */\n  reason?: string;\n};\n\n/**\n * Supervisor run was cancelled via `AbortSignal` before it could\n * finish. Between-iteration cancellation is guaranteed; mid-iteration\n * cancellation is best-effort (the signal is also threaded into every\n * in-flight child `execute()` call, but effectiveness depends on the\n * child primitive respecting it).\n *\n * On cancellation the supervisor returns normally with `status:\n * \"cancelled\"` and partial `report.snapshots` — the error is placed\n * on `result.error` rather than thrown.\n */\nexport class SupervisorCancelledError extends SupervisorFailedError {\n  public static readonly defaultCategory: ErrorCategory = \"cancelled\";\n\n  public readonly cancelledAt: string;\n  public readonly reason?: string;\n\n  public constructor(\n    message: string,\n    options: SupervisorCancelledErrorOptions,\n  ) {\n    super(message, options, \"SUPERVISOR_CANCELLED\");\n    this.name = \"SupervisorCancelledError\";\n    this.cancelledAt = options.cancelledAt;\n    this.reason = options.reason;\n  }\n}\n"],"mappings":";;;;;;;;;;;;;;AAsBA,IAAa,2BAAb,cAA8C,sBAAsB;;yBACV;;CAKxD,AAAO,YACL,SACA,SACA;EACA,MAAM,SAAS,SAAS,sBAAsB;EAC9C,KAAK,OAAO;EACZ,KAAK,cAAc,QAAQ;EAC3B,KAAK,SAAS,QAAQ;CACxB;AACF"}

package/esm/ai/src/errors/supervisor-drift-error.mjs

@@ -1,30 +0,0 @@
-import { SupervisorFailedError } from "./supervisor-failed-error.mjs";
-
-//#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
-* (agent keys + descriptions + router identity + route presence).
-* The resume is refused — no iteration runs — and the user decides
-* how to recover: discard the snapshot, migrate manually, or call
-* `resume(runId, { force: true })` to bypass the check.
-*
-* Mirrors `WorkflowDriftError` for workflow resume — same rationale,
-* different primitive.
-*/
-var SupervisorDriftError = class extends SupervisorFailedError {
-	static {
-		this.defaultCategory = "drift";
-	}
-	constructor(message, options) {
-		super(message, options, "SUPERVISOR_DRIFT");
-		this.name = "SupervisorDriftError";
-		this.savedSignature = options.savedSignature;
-		this.currentSignature = options.currentSignature;
-		this.runId = options.runId;
-	}
-};
-
-//#endregion
-export { SupervisorDriftError };
-//# sourceMappingURL=supervisor-drift-error.mjs.map

package/esm/ai/src/errors/supervisor-drift-error.mjs.map

@@ -1 +0,0 @@
-{"version":3,"file":"supervisor-drift-error.mjs","names":[],"sources":["../../../../../../../../../@warlock.js/ai/src/errors/supervisor-drift-error.ts"],"sourcesContent":["import type { AIErrorOptions } from \"./ai-error\";\nimport type { ErrorCategory } from \"./error-category.type\";\nimport { SupervisorFailedError } from \"./supervisor-failed-error\";\n\nexport type SupervisorDriftErrorOptions = AIErrorOptions & {\n  /** Signature recorded on the snapshot being resumed. */\n  savedSignature: string;\n  /** Signature computed from the current supervisor definition. */\n  currentSignature: string;\n  runId: string;\n};\n\n/**\n * `supervisor.resume(runId)` loaded a snapshot whose structural\n * fingerprint does not match the current supervisor definition\n * (agent keys + descriptions + router identity + route presence).\n * The resume is refused — no iteration runs — and the user decides\n * how to recover: discard the snapshot, migrate manually, or call\n * `resume(runId, { force: true })` to bypass the check.\n *\n * Mirrors `WorkflowDriftError` for workflow resume — same rationale,\n * different primitive.\n */\nexport class SupervisorDriftError extends SupervisorFailedError {\n  public static readonly defaultCategory: ErrorCategory = \"drift\";\n\n  public readonly savedSignature: string;\n  public readonly currentSignature: string;\n  public readonly runId: string;\n\n  public constructor(message: string, options: SupervisorDriftErrorOptions) {\n    super(message, options, \"SUPERVISOR_DRIFT\");\n    this.name = \"SupervisorDriftError\";\n    this.savedSignature = options.savedSignature;\n    this.currentSignature = options.currentSignature;\n    this.runId = options.runId;\n  }\n}\n"],"mappings":";;;;;;;;;;;;;;AAuBA,IAAa,uBAAb,cAA0C,sBAAsB;;yBACN;;CAMxD,AAAO,YAAY,SAAiB,SAAsC;EACxE,MAAM,SAAS,SAAS,kBAAkB;EAC1C,KAAK,OAAO;EACZ,KAAK,iBAAiB,QAAQ;EAC9B,KAAK,mBAAmB,QAAQ;EAChC,KAAK,QAAQ,QAAQ;CACvB;AACF"}

package/esm/ai/src/errors/supervisor-failed-error.mjs

@@ -1,43 +0,0 @@
-import { AIError } from "./ai-error.mjs";
-
-//#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
-* `ai.supervisor()` validation.
-*
-* **Role.** Anchor for the `SUPERVISOR_*` code family. Subclasses
-* carry precise codes (`SUPERVISOR_MAX_ITERATIONS`,
-* `SUPERVISOR_INVALID_ROUTE`, …); this base catches everything a
-* supervisor run can produce that isn't already an agent / tool /
-* provider / workflow error bubbling up from a child execution.
-*
-* Child-execution errors (agent, tool, provider, workflow) flow
-* through the supervisor unchanged — they are captured on the
-* relevant branch snapshot and, if fatal, wrapped as the `cause` of a
-* `SupervisorFailedError` only when the supervisor itself has no
-* narrower subclass to throw.
-*
-* @example
-* try {
-*   ai.supervisor({
-*     route: () => "triage",
-*     router: routerAgent,
-*     intents: { triage },
-*   });
-* } catch (error) {
-*   if (error instanceof SupervisorFailedError) {
-*     console.error(error.code, error.message);
-*   }
-* }
-*/
-var SupervisorFailedError = class extends AIError {
-	constructor(message, options, code = "SUPERVISOR_FAILED") {
-		super(code, message, options);
-		this.name = "SupervisorFailedError";
-	}
-};
-
-//#endregion
-export { SupervisorFailedError };
-//# sourceMappingURL=supervisor-failed-error.mjs.map

package/esm/ai/src/errors/supervisor-failed-error.mjs.map

@@ -1 +0,0 @@
-{"version":3,"file":"supervisor-failed-error.mjs","names":[],"sources":["../../../../../../../../../@warlock.js/ai/src/errors/supervisor-failed-error.ts"],"sourcesContent":["import { AIError, type AIErrorOptions } from \"./ai-error\";\nimport type { AIErrorCode } from \"./error-code.type\";\n\n/**\n * Base class for every supervisor-specific failure surfaced from\n * `supervisor.execute()` / `supervisor.resume()` / authoring-time\n * `ai.supervisor()` validation.\n *\n * **Role.** Anchor for the `SUPERVISOR_*` code family. Subclasses\n * carry precise codes (`SUPERVISOR_MAX_ITERATIONS`,\n * `SUPERVISOR_INVALID_ROUTE`, …); this base catches everything a\n * supervisor run can produce that isn't already an agent / tool /\n * provider / workflow error bubbling up from a child execution.\n *\n * Child-execution errors (agent, tool, provider, workflow) flow\n * through the supervisor unchanged — they are captured on the\n * relevant branch snapshot and, if fatal, wrapped as the `cause` of a\n * `SupervisorFailedError` only when the supervisor itself has no\n * narrower subclass to throw.\n *\n * @example\n * try {\n *   ai.supervisor({\n *     route: () => \"triage\",\n *     router: routerAgent,\n *     intents: { triage },\n *   });\n * } catch (error) {\n *   if (error instanceof SupervisorFailedError) {\n *     console.error(error.code, error.message);\n *   }\n * }\n */\nexport class SupervisorFailedError extends AIError {\n  public constructor(\n    message: string,\n    options?: AIErrorOptions,\n    code: AIErrorCode = \"SUPERVISOR_FAILED\",\n  ) {\n    super(code, message, options);\n    this.name = \"SupervisorFailedError\";\n  }\n}\n"],"mappings":";;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;AAiCA,IAAa,wBAAb,cAA2C,QAAQ;CACjD,AAAO,YACL,SACA,SACA,OAAoB,qBACpB;EACA,MAAM,MAAM,SAAS,OAAO;EAC5B,KAAK,OAAO;CACd;AACF"}

package/esm/ai/src/errors/supervisor-routing-error.mjs

@@ -1,39 +0,0 @@
-import { SupervisorFailedError } from "./supervisor-failed-error.mjs";
-
-//#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,
-* or the `END` sentinel. Routing is authoritative — there is no
-* recovery path, so the supervisor terminates the run immediately.
-*
-* Named `SupervisorRoutingError` (not `RoutingError`) to avoid
-* colliding with `@warlock.js/ai`'s existing workflow `RoutingError`
-* (`WORKFLOW_INVALID_GOTO`). Both carry the same semantic weight —
-* "routing asked for something I can't dispatch" — in their
-* respective primitives.
-*
-* @example
-* const { error } = await supervisor.execute(input);
-* if (error?.code === "SUPERVISOR_INVALID_ROUTE") {
-*   logger.error("bad router decision", {
-*     returned: (error as SupervisorRoutingError).returned,
-*     available: (error as SupervisorRoutingError).availableKeys,
-*   });
-* }
-*/
-var SupervisorRoutingError = class extends SupervisorFailedError {
-	static {
-		this.defaultCategory = "routing";
-	}
-	constructor(message, options) {
-		super(message, options, "SUPERVISOR_INVALID_ROUTE");
-		this.name = "SupervisorRoutingError";
-		this.returned = options.returned;
-		this.availableKeys = options.availableKeys;
-	}
-};
-
-//#endregion
-export { SupervisorRoutingError };
-//# sourceMappingURL=supervisor-routing-error.mjs.map

package/esm/ai/src/errors/supervisor-routing-error.mjs.map

@@ -1 +0,0 @@
-{"version":3,"file":"supervisor-routing-error.mjs","names":[],"sources":["../../../../../../../../../@warlock.js/ai/src/errors/supervisor-routing-error.ts"],"sourcesContent":["import type { AIErrorOptions } from \"./ai-error\";\nimport type { ErrorCategory } from \"./error-category.type\";\nimport { SupervisorFailedError } from \"./supervisor-failed-error\";\n\nexport type SupervisorRoutingErrorOptions = AIErrorOptions & {\n  /**\n   * The raw value the `route` callback or router agent returned. Keyed\n   * `unknown` because a misbehaving router can emit any JSON value —\n   * consumers should format it for display, not trust its shape.\n   */\n  returned: unknown;\n  /** Every legal intent key configured on the supervisor at run time. */\n  availableKeys: string[];\n};\n\n/**\n * A `route` callback or router agent returned a value that doesn't\n * resolve to a configured agent key, a `string[]` of configured keys,\n * or the `END` sentinel. Routing is authoritative — there is no\n * recovery path, so the supervisor terminates the run immediately.\n *\n * Named `SupervisorRoutingError` (not `RoutingError`) to avoid\n * colliding with `@warlock.js/ai`'s existing workflow `RoutingError`\n * (`WORKFLOW_INVALID_GOTO`). Both carry the same semantic weight —\n * \"routing asked for something I can't dispatch\" — in their\n * respective primitives.\n *\n * @example\n * const { error } = await supervisor.execute(input);\n * if (error?.code === \"SUPERVISOR_INVALID_ROUTE\") {\n *   logger.error(\"bad router decision\", {\n *     returned: (error as SupervisorRoutingError).returned,\n *     available: (error as SupervisorRoutingError).availableKeys,\n *   });\n * }\n */\nexport class SupervisorRoutingError extends SupervisorFailedError {\n  public static readonly defaultCategory: ErrorCategory = \"routing\";\n\n  public readonly returned: unknown;\n  public readonly availableKeys: string[];\n\n  public constructor(message: string, options: SupervisorRoutingErrorOptions) {\n    super(message, options, \"SUPERVISOR_INVALID_ROUTE\");\n    this.name = \"SupervisorRoutingError\";\n    this.returned = options.returned;\n    this.availableKeys = options.availableKeys;\n  }\n}\n"],"mappings":";;;;;;;;;;;;;;;;;;;;;;;;AAoCA,IAAa,yBAAb,cAA4C,sBAAsB;;yBACR;;CAKxD,AAAO,YAAY,SAAiB,SAAwC;EAC1E,MAAM,SAAS,SAAS,0BAA0B;EAClD,KAAK,OAAO;EACZ,KAAK,WAAW,QAAQ;EACxB,KAAK,gBAAgB,QAAQ;CAC/B;AACF"}

package/esm/ai/src/errors/tool-execution-error.mjs

@@ -1,32 +0,0 @@
-import { AIError } from "./ai-error.mjs";
-
-//#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
-* valid; the implementation crashed.
-*
-* Carries `toolName` so consumers can branch on which tool failed
-* without regex-parsing the message, and `tripIndex` to correlate
-* with the `LLMTrip` entry in `result.report.trips`.
-*
-* @example
-* if (result.error instanceof ToolExecutionError) {
-*   metrics.increment("tool.failure", { tool: result.error.toolName });
-* }
-*/
-var ToolExecutionError = class extends AIError {
-	static {
-		this.defaultCategory = "tool";
-	}
-	constructor(message, options) {
-		super("TOOL_EXEC_FAILED", message, options);
-		this.name = "ToolExecutionError";
-		this.toolName = options.toolName;
-		this.tripIndex = options.tripIndex;
-	}
-};
-
-//#endregion
-export { ToolExecutionError };
-//# sourceMappingURL=tool-execution-error.mjs.map

package/esm/ai/src/errors/tool-execution-error.mjs.map

@@ -1 +0,0 @@
-{"version":3,"file":"tool-execution-error.mjs","names":[],"sources":["../../../../../../../../../@warlock.js/ai/src/errors/tool-execution-error.ts"],"sourcesContent":["import { AIError, type AIErrorOptions } from \"./ai-error\";\nimport type { ErrorCategory } from \"./error-category.type\";\n\n/**\n * Payload passed to `ToolExecutionError` — identifies which tool\n * failed and, when applicable, which trip it was dispatched from.\n */\nexport type ToolExecutionErrorOptions = AIErrorOptions & {\n  toolName: string;\n  tripIndex?: number;\n};\n\n/**\n * A registered tool's `execute()` threw during dispatch — the tool\n * code itself failed (not its input schema). The model's request was\n * valid; the implementation crashed.\n *\n * Carries `toolName` so consumers can branch on which tool failed\n * without regex-parsing the message, and `tripIndex` to correlate\n * with the `LLMTrip` entry in `result.report.trips`.\n *\n * @example\n * if (result.error instanceof ToolExecutionError) {\n *   metrics.increment(\"tool.failure\", { tool: result.error.toolName });\n * }\n */\nexport class ToolExecutionError extends AIError {\n  public static readonly defaultCategory: ErrorCategory = \"tool\";\n\n  public readonly toolName: string;\n  public readonly tripIndex?: number;\n\n  public constructor(message: string, options: ToolExecutionErrorOptions) {\n    super(\"TOOL_EXEC_FAILED\", message, options);\n    this.name = \"ToolExecutionError\";\n    this.toolName = options.toolName;\n    this.tripIndex = options.tripIndex;\n  }\n}\n"],"mappings":";;;;;;;;;;;;;;;;;AA0BA,IAAa,qBAAb,cAAwC,QAAQ;;yBACU;;CAKxD,AAAO,YAAY,SAAiB,SAAoC;EACtE,MAAM,oBAAoB,SAAS,OAAO;EAC1C,KAAK,OAAO;EACZ,KAAK,WAAW,QAAQ;EACxB,KAAK,YAAY,QAAQ;CAC3B;AACF"}

package/esm/ai/src/errors/workflow-cancelled-error.mjs

@@ -1,23 +0,0 @@
-import { WorkflowError } from "./workflow-error.mjs";
-
-//#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
-* `controller.abort(reason)` payload when provided.
-*/
-var WorkflowCancelledError = class extends WorkflowError {
-	static {
-		this.defaultCategory = "cancelled";
-	}
-	constructor(message, options) {
-		super(message, options, "WORKFLOW_CANCELLED");
-		this.name = "WorkflowCancelledError";
-		this.cancelledAt = options.cancelledAt;
-		this.reason = options.reason;
-	}
-};
-
-//#endregion
-export { WorkflowCancelledError };
-//# sourceMappingURL=workflow-cancelled-error.mjs.map

package/esm/ai/src/errors/workflow-cancelled-error.mjs.map

@@ -1 +0,0 @@
-{"version":3,"file":"workflow-cancelled-error.mjs","names":[],"sources":["../../../../../../../../../@warlock.js/ai/src/errors/workflow-cancelled-error.ts"],"sourcesContent":["import type { AIErrorOptions } from \"./ai-error\";\nimport type { ErrorCategory } from \"./error-category.type\";\nimport { WorkflowError } from \"./workflow-error\";\n\nexport type WorkflowCancelledErrorOptions = AIErrorOptions & {\n  cancelledAt: string;\n  reason?: string;\n};\n\n/**\n * Workflow was cancelled via `AbortSignal` before it could finish.\n * `cancelledAt` is ISO timestamp at abort; `reason` carries the\n * `controller.abort(reason)` payload when provided.\n */\nexport class WorkflowCancelledError extends WorkflowError {\n  public static readonly defaultCategory: ErrorCategory = \"cancelled\";\n\n  public readonly cancelledAt: string;\n  public readonly reason?: string;\n\n  public constructor(message: string, options: WorkflowCancelledErrorOptions) {\n    super(message, options, \"WORKFLOW_CANCELLED\");\n    this.name = \"WorkflowCancelledError\";\n    this.cancelledAt = options.cancelledAt;\n    this.reason = options.reason;\n  }\n}\n"],"mappings":";;;;;;;;AAcA,IAAa,yBAAb,cAA4C,cAAc;;yBACA;;CAKxD,AAAO,YAAY,SAAiB,SAAwC;EAC1E,MAAM,SAAS,SAAS,oBAAoB;EAC5C,KAAK,OAAO;EACZ,KAAK,cAAc,QAAQ;EAC3B,KAAK,SAAS,QAAQ;CACxB;AACF"}

package/esm/ai/src/errors/workflow-drift-error.mjs

@@ -1,24 +0,0 @@
-import { WorkflowError } from "./workflow-error.mjs";
-
-//#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
-* executing anything. User must discard, force, or migrate manually.
-*/
-var WorkflowDriftError = class extends WorkflowError {
-	static {
-		this.defaultCategory = "drift";
-	}
-	constructor(message, options) {
-		super(message, options, "WORKFLOW_DRIFT");
-		this.name = "WorkflowDriftError";
-		this.savedSignature = options.savedSignature;
-		this.currentSignature = options.currentSignature;
-		this.runId = options.runId;
-	}
-};
-
-//#endregion
-export { WorkflowDriftError };
-//# sourceMappingURL=workflow-drift-error.mjs.map

package/esm/ai/src/errors/workflow-drift-error.mjs.map

@@ -1 +0,0 @@
-{"version":3,"file":"workflow-drift-error.mjs","names":[],"sources":["../../../../../../../../../@warlock.js/ai/src/errors/workflow-drift-error.ts"],"sourcesContent":["import type { AIErrorOptions } from \"./ai-error\";\nimport type { ErrorCategory } from \"./error-category.type\";\nimport { WorkflowError } from \"./workflow-error\";\n\nexport type WorkflowDriftErrorOptions = AIErrorOptions & {\n  savedSignature: string;\n  currentSignature: string;\n  runId: string;\n};\n\n/**\n * `workflow.resume(runId)` found a snapshot whose structural signature\n * doesn't match the current workflow definition. Thrown without\n * executing anything. User must discard, force, or migrate manually.\n */\nexport class WorkflowDriftError extends WorkflowError {\n  public static readonly defaultCategory: ErrorCategory = \"drift\";\n\n  public readonly savedSignature: string;\n  public readonly currentSignature: string;\n  public readonly runId: string;\n\n  public constructor(message: string, options: WorkflowDriftErrorOptions) {\n    super(message, options, \"WORKFLOW_DRIFT\");\n    this.name = \"WorkflowDriftError\";\n    this.savedSignature = options.savedSignature;\n    this.currentSignature = options.currentSignature;\n    this.runId = options.runId;\n  }\n}\n"],"mappings":";;;;;;;;AAeA,IAAa,qBAAb,cAAwC,cAAc;;yBACI;;CAMxD,AAAO,YAAY,SAAiB,SAAoC;EACtE,MAAM,SAAS,SAAS,gBAAgB;EACxC,KAAK,OAAO;EACZ,KAAK,iBAAiB,QAAQ;EAC9B,KAAK,mBAAmB,QAAQ;EAChC,KAAK,QAAQ,QAAQ;CACvB;AACF"}

package/esm/ai/src/errors/workflow-error.mjs

@@ -1,18 +0,0 @@
-import { AIError } from "./ai-error.mjs";
-
-//#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()`
-* can produce beyond agent/tool/provider errors.
-*/
-var WorkflowError = class extends AIError {
-	constructor(message, options, code = "WORKFLOW_ERROR") {
-		super(code, message, options);
-		this.name = "WorkflowError";
-	}
-};
-
-//#endregion
-export { WorkflowError };
-//# sourceMappingURL=workflow-error.mjs.map

package/esm/ai/src/errors/workflow-error.mjs.map

@@ -1 +0,0 @@
-{"version":3,"file":"workflow-error.mjs","names":[],"sources":["../../../../../../../../../@warlock.js/ai/src/errors/workflow-error.ts"],"sourcesContent":["import { AIError, type AIErrorOptions } from \"./ai-error\";\nimport type { AIErrorCode } from \"./error-code.type\";\n\n/**\n * Base class for all workflow-specific failures. Subclasses carry\n * precise codes; this base catches everything `workflow.execute()`\n * can produce beyond agent/tool/provider errors.\n */\nexport class WorkflowError extends AIError {\n  public constructor(\n    message: string,\n    options?: AIErrorOptions,\n    code: AIErrorCode = \"WORKFLOW_ERROR\",\n  ) {\n    super(code, message, options);\n    this.name = \"WorkflowError\";\n  }\n}\n"],"mappings":";;;;;;;;AAQA,IAAa,gBAAb,cAAmC,QAAQ;CACzC,AAAO,YACL,SACA,SACA,OAAoB,kBACpB;EACA,MAAM,MAAM,SAAS,OAAO;EAC5B,KAAK,OAAO;CACd;AACF"}

package/esm/ai/src/eval/dataset.mjs

@@ -1,112 +0,0 @@
-import { InvalidRequestError } from "../errors/invalid-request-error.mjs";
-import "../errors/index.mjs";
-import { readFileSync } from "node:fs";
-
-//#region ../@warlock.js/ai/src/eval/dataset.ts
-/**
-* Parse a JSONL file's contents into {@link DatasetEntry} rows. Blank
-* lines (and trailing whitespace-only lines) are skipped; every other
-* line must be a JSON object. A malformed line throws an
-* `InvalidRequestError` naming the 1-based line number — failing loud at
-* construction, like `SystemPrompt.fromFile`.
-*/
-function parseJsonl(path, contents) {
-	const entries = [];
-	const lines = contents.split(/\r?\n/);
-	for (let index = 0; index < lines.length; index++) {
-		const line = lines[index].trim();
-		if (line === "") continue;
-		let parsed;
-		try {
-			parsed = JSON.parse(line);
-		} catch (error) {
-			throw new InvalidRequestError(`Failed to parse dataset file "${path}" — line ${index + 1} is not valid JSON: ${error instanceof Error ? error.message : String(error)}`, {
-				context: {
-					path,
-					line: index + 1
-				},
-				cause: error
-			});
-		}
-		if (parsed === null || typeof parsed !== "object" || Array.isArray(parsed)) throw new InvalidRequestError(`Failed to parse dataset file "${path}" — line ${index + 1} is not a JSON object`, { context: {
-			path,
-			line: index + 1
-		} });
-		entries.push(parsed);
-	}
-	return entries;
-}
-/**
-* Read a JSONL dataset file once, synchronously, at construction.
-* Mirrors `SystemPrompt.fromFile`: a read failure (missing path,
-* permission denied) throws an `InvalidRequestError` surfacing the
-* underlying cause.
-*/
-function readDatasetFile(path) {
-	let contents;
-	try {
-		contents = readFileSync(path, "utf8");
-	} catch (error) {
-		throw new InvalidRequestError(`Failed to read dataset file "${path}" — ${error instanceof Error ? error.message : String(error)}`, {
-			context: { path },
-			cause: error
-		});
-	}
-	return parseJsonl(path, contents);
-}
-/**
-* Build an immutable {@link DatasetContract} over the given entries.
-* Shared by the {@link dataset} factory and by `filter` / `shard`, which
-* each return a fresh dataset built from a derived case list.
-*/
-function makeDataset(name, cases) {
-	return {
-		name,
-		cases,
-		filter(predicate) {
-			return makeDataset(name, cases.filter(predicate));
-		},
-		shard(index, total) {
-			if (!Number.isInteger(total) || total <= 0) throw new InvalidRequestError(`dataset.shard: "total" must be a positive integer, received ${total}`, { context: {
-				name,
-				total
-			} });
-			if (!Number.isInteger(index) || index < 0 || index >= total) throw new InvalidRequestError(`dataset.shard: "index" must be an integer in [0, ${total}), received ${index}`, { context: {
-				name,
-				index,
-				total
-			} });
-			return makeDataset(name, cases.filter((_, position) => position % total === index));
-		}
-	};
-}
-/**
-* Create an immutable evaluation dataset that feeds `agent.eval({ cases })`
-* directly.
-*
-* **Role.** A taggable, filterable, shardable wrapper around a list of
-* {@link DatasetEntry} rows. `agent.eval` accepts a `DatasetContract` in
-* place of a raw `EvalCase[]`, reading `.cases` off it.
-*
-* Sources (combinable — file entries append after inline `cases`):
-* - `cases` → inline entries.
-* - `fromFile` → a JSONL file read once, synchronously, at construction
-*   (one JSON object per line). A malformed line throws an
-*   `InvalidRequestError` naming the 1-based line number.
-*
-* @example
-* const ds = dataset({ name: "support", fromFile: "./eval/support.jsonl" });
-* const smoke = ds.filter((entry) => entry.tags?.includes("smoke"));
-* const shard = ds.shard(0, 4); // first of four parallel CI shards
-*
-* const report = await agent.eval({ cases: ds, scorers: [contains()] });
-*/
-function dataset(options) {
-	const cases = [...options.cases ?? []];
-	if (options.fromFile !== void 0) cases.push(...readDatasetFile(options.fromFile));
-	return makeDataset(options.name, cases);
-}
-
-//#endregion
-export { dataset };
-//# sourceMappingURL=dataset.mjs.map

package/esm/ai/src/eval/dataset.mjs.map

@@ -1 +0,0 @@
-{"version":3,"file":"dataset.mjs","names":[],"sources":["../../../../../../../../../@warlock.js/ai/src/eval/dataset.ts"],"sourcesContent":["import { readFileSync } from \"node:fs\";\nimport type { DatasetContract, DatasetEntry, DatasetOptions } from \"./dataset.type\";\nimport { InvalidRequestError } from \"../errors\";\n\n/**\n * Parse a JSONL file's contents into {@link DatasetEntry} rows. Blank\n * lines (and trailing whitespace-only lines) are skipped; every other\n * line must be a JSON object. A malformed line throws an\n * `InvalidRequestError` naming the 1-based line number — failing loud at\n * construction, like `SystemPrompt.fromFile`.\n */\nfunction parseJsonl<TOutput>(path: string, contents: string): DatasetEntry<TOutput>[] {\n  const entries: DatasetEntry<TOutput>[] = [];\n  const lines = contents.split(/\\r?\\n/);\n\n  for (let index = 0; index < lines.length; index++) {\n    const line = lines[index].trim();\n\n    if (line === \"\") {\n      continue;\n    }\n\n    let parsed: unknown;\n\n    try {\n      parsed = JSON.parse(line);\n    } catch (error) {\n      throw new InvalidRequestError(\n        `Failed to parse dataset file \"${path}\" — line ${index + 1} is not valid JSON: ${\n          error instanceof Error ? error.message : String(error)\n        }`,\n        { context: { path, line: index + 1 }, cause: error },\n      );\n    }\n\n    if (parsed === null || typeof parsed !== \"object\" || Array.isArray(parsed)) {\n      throw new InvalidRequestError(\n        `Failed to parse dataset file \"${path}\" — line ${index + 1} is not a JSON object`,\n        { context: { path, line: index + 1 } },\n      );\n    }\n\n    entries.push(parsed as DatasetEntry<TOutput>);\n  }\n\n  return entries;\n}\n\n/**\n * Read a JSONL dataset file once, synchronously, at construction.\n * Mirrors `SystemPrompt.fromFile`: a read failure (missing path,\n * permission denied) throws an `InvalidRequestError` surfacing the\n * underlying cause.\n */\nfunction readDatasetFile<TOutput>(path: string): DatasetEntry<TOutput>[] {\n  let contents: string;\n\n  try {\n    contents = readFileSync(path, \"utf8\");\n  } catch (error) {\n    throw new InvalidRequestError(\n      `Failed to read dataset file \"${path}\" — ${\n        error instanceof Error ? error.message : String(error)\n      }`,\n      { context: { path }, cause: error },\n    );\n  }\n\n  return parseJsonl<TOutput>(path, contents);\n}\n\n/**\n * Build an immutable {@link DatasetContract} over the given entries.\n * Shared by the {@link dataset} factory and by `filter` / `shard`, which\n * each return a fresh dataset built from a derived case list.\n */\nfunction makeDataset<TOutput>(\n  name: string,\n  cases: DatasetEntry<TOutput>[],\n): DatasetContract<TOutput> {\n  return {\n    name,\n    cases,\n    filter(predicate) {\n      return makeDataset(name, cases.filter(predicate));\n    },\n    shard(index, total) {\n      if (!Number.isInteger(total) || total <= 0) {\n        throw new InvalidRequestError(\n          `dataset.shard: \"total\" must be a positive integer, received ${total}`,\n          { context: { name, total } },\n        );\n      }\n\n      if (!Number.isInteger(index) || index < 0 || index >= total) {\n        throw new InvalidRequestError(\n          `dataset.shard: \"index\" must be an integer in [0, ${total}), received ${index}`,\n          { context: { name, index, total } },\n        );\n      }\n\n      return makeDataset(\n        name,\n        cases.filter((_, position) => position % total === index),\n      );\n    },\n  };\n}\n\n/**\n * Create an immutable evaluation dataset that feeds `agent.eval({ cases })`\n * directly.\n *\n * **Role.** A taggable, filterable, shardable wrapper around a list of\n * {@link DatasetEntry} rows. `agent.eval` accepts a `DatasetContract` in\n * place of a raw `EvalCase[]`, reading `.cases` off it.\n *\n * Sources (combinable — file entries append after inline `cases`):\n * - `cases` → inline entries.\n * - `fromFile` → a JSONL file read once, synchronously, at construction\n *   (one JSON object per line). A malformed line throws an\n *   `InvalidRequestError` naming the 1-based line number.\n *\n * @example\n * const ds = dataset({ name: \"support\", fromFile: \"./eval/support.jsonl\" });\n * const smoke = ds.filter((entry) => entry.tags?.includes(\"smoke\"));\n * const shard = ds.shard(0, 4); // first of four parallel CI shards\n *\n * const report = await agent.eval({ cases: ds, scorers: [contains()] });\n */\nexport function dataset<TOutput = unknown>(\n  options: DatasetOptions<TOutput>,\n): DatasetContract<TOutput> {\n  const cases: DatasetEntry<TOutput>[] = [...(options.cases ?? [])];\n\n  if (options.fromFile !== undefined) {\n    cases.push(...readDatasetFile<TOutput>(options.fromFile));\n  }\n\n  return makeDataset(options.name, cases);\n}\n"],"mappings":";;;;;;;;;;;;AAWA,SAAS,WAAoB,MAAc,UAA2C;CACpF,MAAM,UAAmC,CAAC;CAC1C,MAAM,QAAQ,SAAS,MAAM,OAAO;CAEpC,KAAK,IAAI,QAAQ,GAAG,QAAQ,MAAM,QAAQ,SAAS;EACjD,MAAM,OAAO,MAAM,MAAM,CAAC,KAAK;EAE/B,IAAI,SAAS,IACX;EAGF,IAAI;EAEJ,IAAI;GACF,SAAS,KAAK,MAAM,IAAI;EAC1B,SAAS,OAAO;GACd,MAAM,IAAI,oBACR,iCAAiC,KAAK,WAAW,QAAQ,EAAE,sBACzD,iBAAiB,QAAQ,MAAM,UAAU,OAAO,KAAK,KAEvD;IAAE,SAAS;KAAE;KAAM,MAAM,QAAQ;IAAE;IAAG,OAAO;GAAM,CACrD;EACF;EAEA,IAAI,WAAW,QAAQ,OAAO,WAAW,YAAY,MAAM,QAAQ,MAAM,GACvE,MAAM,IAAI,oBACR,iCAAiC,KAAK,WAAW,QAAQ,EAAE,wBAC3D,EAAE,SAAS;GAAE;GAAM,MAAM,QAAQ;EAAE,EAAE,CACvC;EAGF,QAAQ,KAAK,MAA+B;CAC9C;CAEA,OAAO;AACT;;;;;;;AAQA,SAAS,gBAAyB,MAAuC;CACvE,IAAI;CAEJ,IAAI;EACF,WAAW,aAAa,MAAM,MAAM;CACtC,SAAS,OAAO;EACd,MAAM,IAAI,oBACR,gCAAgC,KAAK,MACnC,iBAAiB,QAAQ,MAAM,UAAU,OAAO,KAAK,KAEvD;GAAE,SAAS,EAAE,KAAK;GAAG,OAAO;EAAM,CACpC;CACF;CAEA,OAAO,WAAoB,MAAM,QAAQ;AAC3C;;;;;;AAOA,SAAS,YACP,MACA,OAC0B;CAC1B,OAAO;EACL;EACA;EACA,OAAO,WAAW;GAChB,OAAO,YAAY,MAAM,MAAM,OAAO,SAAS,CAAC;EAClD;EACA,MAAM,OAAO,OAAO;GAClB,IAAI,CAAC,OAAO,UAAU,KAAK,KAAK,SAAS,GACvC,MAAM,IAAI,oBACR,+DAA+D,SAC/D,EAAE,SAAS;IAAE;IAAM;GAAM,EAAE,CAC7B;GAGF,IAAI,CAAC,OAAO,UAAU,KAAK,KAAK,QAAQ,KAAK,SAAS,OACpD,MAAM,IAAI,oBACR,oDAAoD,MAAM,cAAc,SACxE,EAAE,SAAS;IAAE;IAAM;IAAO;GAAM,EAAE,CACpC;GAGF,OAAO,YACL,MACA,MAAM,QAAQ,GAAG,aAAa,WAAW,UAAU,KAAK,CAC1D;EACF;CACF;AACF;;;;;;;;;;;;;;;;;;;;;;AAuBA,SAAgB,QACd,SAC0B;CAC1B,MAAM,QAAiC,CAAC,GAAI,QAAQ,SAAS,CAAC,CAAE;CAEhE,IAAI,QAAQ,aAAa,QACvB,MAAM,KAAK,GAAG,gBAAyB,QAAQ,QAAQ,CAAC;CAG1D,OAAO,YAAY,QAAQ,MAAM,KAAK;AACxC"}

package/esm/ai/src/eval/eval-runner.mjs

@@ -1,135 +0,0 @@
-import { AgentExecutionError } from "../errors/agent-execution-error.mjs";
-import "../errors/index.mjs";
-import { judge } from "./judge-scorer.mjs";
-import { diff } from "./regression.mjs";
-import { log } from "@warlock.js/logger";
-
-//#region ../@warlock.js/ai/src/eval/eval-runner.ts
-/**
-* Narrow `EvalOptions.cases` to the underlying `EvalCase[]`. A
-* `DatasetContract` is identified structurally by its `cases` property
-* (an array carried alongside `name` / `filter` / `shard`); a raw
-* `EvalCase[]` is used as-is.
-*/
-function resolveCases(cases) {
-	if (Array.isArray(cases)) return cases;
-	return cases.cases;
-}
-const LOG_MODULE = "ai.eval";
-const DEFAULT_PASS_THRESHOLD = .5;
-/**
-* Resolve the scorer list for a single case. Precedence: the case's
-* own `scorers` → the suite `scorers` → a synthesized judge scorer
-* when `judge` is configured. Throws an authoring-time
-* `AgentExecutionError` when a case can resolve none — an eval suite
-* with no way to score a case is a config bug worth surfacing at the
-* call site, not a silent pass.
-*/
-function resolveScorers(evalCase, options, passThreshold) {
-	if (evalCase.scorers && evalCase.scorers.length > 0) return evalCase.scorers;
-	if (options.scorers && options.scorers.length > 0) return options.scorers;
-	if (options.judge) return [judge(options.judge, passThreshold)];
-	throw new AgentExecutionError(`eval case "${evalCase.name}" has no scorer — supply per-case "scorers", suite "scorers", or a "judge"`, { context: {
-		authoring: true,
-		case: evalCase.name
-	} });
-}
-/**
-* Decide a single scorer verdict's pass/fail. Honors an explicit
-* `passed` from the scorer; otherwise derives it from
-* `score >= passThreshold`.
-*/
-function isScorePassing(score, passThreshold) {
-	if (typeof score.passed === "boolean") return score.passed;
-	return score.score >= passThreshold;
-}
-/**
-* Merge suite-level execute options with the case's own override.
-* Per-case wins on conflict (shallow merge).
-*/
-function mergeOptions(suite, perCase) {
-	if (!suite) return perCase;
-	if (!perCase) return suite;
-	return {
-		...suite,
-		...perCase
-	};
-}
-/**
-* Run one case end-to-end: execute the agent, run every resolved
-* scorer, aggregate into an {@link EvalCaseResult}. A case passes only
-* when the agent did not error AND every scorer passed.
-*/
-async function runCase(agent, evalCase, options, passThreshold) {
-	const scorers = resolveScorers(evalCase, options, passThreshold);
-	const executeOptions = mergeOptions(options.executeOptions, evalCase.options);
-	const start = performance.now();
-	const result = await agent.execute(evalCase.input, executeOptions);
-	const duration = performance.now() - start;
-	const context = {
-		case: evalCase,
-		result,
-		output: result.data,
-		text: result.text
-	};
-	const scores = [];
-	for (const scorer of scorers) scores.push(await scorer(context));
-	const meanScore = scores.length > 0 ? scores.reduce((sum, score) => sum + score.score, 0) / scores.length : 0;
-	const allScorersPassed = scores.every((score) => isScorePassing(score, passThreshold));
-	return {
-		case: evalCase,
-		result,
-		scores,
-		score: meanScore,
-		passed: result.error === void 0 && allScorersPassed,
-		duration
-	};
-}
-/**
-* Core implementation of `agent.eval`. Runs every case sequentially
-* (cases share the agent and may carry side effects — ordering must be
-* deterministic), scores each, fires `onFailure` for failed cases, and
-* assembles the aggregate {@link EvalReport}.
-*
-* Never throws on a case-level failure; the only throw is the
-* authoring-time "no scorer" guard from {@link resolveScorers}.
-*/
-async function runEval(agent, options) {
-	const passThreshold = options.passThreshold ?? DEFAULT_PASS_THRESHOLD;
-	const start = performance.now();
-	const suiteCases = resolveCases(options.cases);
-	const cases = [];
-	for (const evalCase of suiteCases) {
-		const caseResult = await runCase(agent, evalCase, options, passThreshold);
-		cases.push(caseResult);
-		if (!caseResult.passed && options.onFailure) try {
-			await options.onFailure(caseResult);
-		} catch (error) {
-			log.warn(LOG_MODULE, "onFailure.hook.error", "eval onFailure handler threw", {
-				agent: agent.name,
-				case: evalCase.name,
-				error: error instanceof Error ? error.message : String(error)
-			});
-		}
-	}
-	const passedCount = cases.filter((entry) => entry.passed).length;
-	const total = cases.length;
-	const meanScore = total > 0 ? cases.reduce((sum, entry) => sum + entry.score, 0) / total : 0;
-	const report = {
-		agentName: agent.name,
-		total,
-		passedCount,
-		failedCount: total - passedCount,
-		passRate: total > 0 ? passedCount / total : 0,
-		meanScore,
-		passed: total > 0 && passedCount === total,
-		cases,
-		duration: performance.now() - start
-	};
-	if (options.baseline) report.regression = diff(report, options.baseline, options.tolerance);
-	return report;
-}
-
-//#endregion
-export { runEval };
-//# sourceMappingURL=eval-runner.mjs.map

package/esm/ai/src/eval/eval-runner.mjs.map

@@ -1 +0,0 @@
-{"version":3,"file":"eval-runner.mjs","names":["judgeScorer"],"sources":["../../../../../../../../../@warlock.js/ai/src/eval/eval-runner.ts"],"sourcesContent":["import type { AgentContract } from \"../contracts/agent/agent.contract\";\nimport type { AgentExecuteOptions } from \"../contracts/agent/agent-options.type\";\nimport type {\n  EvalCase,\n  EvalCaseResult,\n  EvalOptions,\n  EvalReport,\n  EvalScore,\n  EvalScorer,\n  EvalScorerContext,\n} from \"../contracts/agent/eval.type\";\nimport type { EvalCase as EvalCaseType } from \"../contracts/agent/eval.type\";\nimport { AgentExecutionError } from \"../errors\";\nimport { log } from \"@warlock.js/logger\";\nimport { judge as judgeScorer } from \"./judge-scorer\";\nimport { diff } from \"./regression\";\n\n/**\n * Narrow `EvalOptions.cases` to the underlying `EvalCase[]`. A\n * `DatasetContract` is identified structurally by its `cases` property\n * (an array carried alongside `name` / `filter` / `shard`); a raw\n * `EvalCase[]` is used as-is.\n */\nfunction resolveCases<TOutput>(\n  cases: EvalOptions<TOutput>[\"cases\"],\n): EvalCaseType<TOutput>[] {\n  if (Array.isArray(cases)) {\n    return cases;\n  }\n\n  return cases.cases;\n}\n\nconst LOG_MODULE = \"ai.eval\";\nconst DEFAULT_PASS_THRESHOLD = 0.5;\n\n/**\n * Resolve the scorer list for a single case. Precedence: the case's\n * own `scorers` → the suite `scorers` → a synthesized judge scorer\n * when `judge` is configured. Throws an authoring-time\n * `AgentExecutionError` when a case can resolve none — an eval suite\n * with no way to score a case is a config bug worth surfacing at the\n * call site, not a silent pass.\n */\nfunction resolveScorers<TOutput>(\n  evalCase: EvalCase<TOutput>,\n  options: EvalOptions<TOutput>,\n  passThreshold: number,\n): EvalScorer<TOutput>[] {\n  if (evalCase.scorers && evalCase.scorers.length > 0) {\n    return evalCase.scorers;\n  }\n\n  if (options.scorers && options.scorers.length > 0) {\n    return options.scorers;\n  }\n\n  if (options.judge) {\n    return [judgeScorer<TOutput>(options.judge, passThreshold)];\n  }\n\n  throw new AgentExecutionError(\n    `eval case \"${evalCase.name}\" has no scorer — supply per-case \"scorers\", suite \"scorers\", or a \"judge\"`,\n    { context: { authoring: true, case: evalCase.name } },\n  );\n}\n\n/**\n * Decide a single scorer verdict's pass/fail. Honors an explicit\n * `passed` from the scorer; otherwise derives it from\n * `score >= passThreshold`.\n */\nfunction isScorePassing(score: EvalScore, passThreshold: number): boolean {\n  if (typeof score.passed === \"boolean\") {\n    return score.passed;\n  }\n\n  return score.score >= passThreshold;\n}\n\n/**\n * Merge suite-level execute options with the case's own override.\n * Per-case wins on conflict (shallow merge).\n */\nfunction mergeOptions<TOutput>(\n  suite: AgentExecuteOptions<TOutput> | undefined,\n  perCase: AgentExecuteOptions<TOutput> | undefined,\n): AgentExecuteOptions<TOutput> | undefined {\n  if (!suite) return perCase;\n  if (!perCase) return suite;\n  return { ...suite, ...perCase };\n}\n\n/**\n * Run one case end-to-end: execute the agent, run every resolved\n * scorer, aggregate into an {@link EvalCaseResult}. A case passes only\n * when the agent did not error AND every scorer passed.\n */\nasync function runCase<TOutput>(\n  agent: AgentContract<TOutput>,\n  evalCase: EvalCase<TOutput>,\n  options: EvalOptions<TOutput>,\n  passThreshold: number,\n): Promise<EvalCaseResult<TOutput>> {\n  const scorers = resolveScorers(evalCase, options, passThreshold);\n  const executeOptions = mergeOptions(options.executeOptions, evalCase.options);\n\n  const start = performance.now();\n  const result = await agent.execute(evalCase.input, executeOptions);\n  const duration = performance.now() - start;\n\n  const context: EvalScorerContext<TOutput> = {\n    case: evalCase,\n    result,\n    output: result.data,\n    text: result.text,\n  };\n\n  const scores: EvalScore[] = [];\n\n  for (const scorer of scorers) {\n    scores.push(await scorer(context));\n  }\n\n  const meanScore =\n    scores.length > 0 ? scores.reduce((sum, score) => sum + score.score, 0) / scores.length : 0;\n\n  const allScorersPassed = scores.every((score) => isScorePassing(score, passThreshold));\n  const passed = result.error === undefined && allScorersPassed;\n\n  return {\n    case: evalCase,\n    result,\n    scores,\n    score: meanScore,\n    passed,\n    duration,\n  };\n}\n\n/**\n * Core implementation of `agent.eval`. Runs every case sequentially\n * (cases share the agent and may carry side effects — ordering must be\n * deterministic), scores each, fires `onFailure` for failed cases, and\n * assembles the aggregate {@link EvalReport}.\n *\n * Never throws on a case-level failure; the only throw is the\n * authoring-time \"no scorer\" guard from {@link resolveScorers}.\n */\nexport async function runEval<TOutput>(\n  agent: AgentContract<TOutput>,\n  options: EvalOptions<TOutput>,\n): Promise<EvalReport<TOutput>> {\n  const passThreshold = options.passThreshold ?? DEFAULT_PASS_THRESHOLD;\n  const start = performance.now();\n\n  const suiteCases = resolveCases(options.cases);\n  const cases: EvalCaseResult<TOutput>[] = [];\n\n  for (const evalCase of suiteCases) {\n    const caseResult = await runCase(agent, evalCase, options, passThreshold);\n\n    cases.push(caseResult);\n\n    if (!caseResult.passed && options.onFailure) {\n      try {\n        await options.onFailure(caseResult);\n      } catch (error) {\n        log.warn(LOG_MODULE, \"onFailure.hook.error\", \"eval onFailure handler threw\", {\n          agent: agent.name,\n          case: evalCase.name,\n          error: error instanceof Error ? error.message : String(error),\n        });\n      }\n    }\n  }\n\n  const passedCount = cases.filter((entry) => entry.passed).length;\n  const total = cases.length;\n  const meanScore =\n    total > 0 ? cases.reduce((sum, entry) => sum + entry.score, 0) / total : 0;\n\n  const report: EvalReport<TOutput> = {\n    agentName: agent.name,\n    total,\n    passedCount,\n    failedCount: total - passedCount,\n    passRate: total > 0 ? passedCount / total : 0,\n    meanScore,\n    passed: total > 0 && passedCount === total,\n    cases,\n    duration: performance.now() - start,\n  };\n\n  if (options.baseline) {\n    report.regression = diff(report, options.baseline, options.tolerance);\n  }\n\n  return report;\n}\n"],"mappings":"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"}