@warlock.js/ai 4.1.1

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

@@ -0,0 +1,32 @@
+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/errors/tool-execution-error.mjs.map

@@ -0,0 +1 @@
+{"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/errors/workflow-cancelled-error.d.mts

@@ -0,0 +1,23 @@
+import { ErrorCategory } from "./error-category.type.mjs";
+import { AIErrorOptions } from "./ai-error.mjs";
+import { WorkflowError } from "./workflow-error.mjs";
+
+//#region ../../@warlock.js/ai/src/errors/workflow-cancelled-error.d.ts
+type WorkflowCancelledErrorOptions = AIErrorOptions & {
+  cancelledAt: string;
+  reason?: string;
+};
+/**
+ * Workflow was cancelled via `AbortSignal` before it could finish.
+ * `cancelledAt` is ISO timestamp at abort; `reason` carries the
+ * `controller.abort(reason)` payload when provided.
+ */
+declare class WorkflowCancelledError extends WorkflowError {
+  static readonly defaultCategory: ErrorCategory;
+  readonly cancelledAt: string;
+  readonly reason?: string;
+  constructor(message: string, options: WorkflowCancelledErrorOptions);
+}
+//#endregion
+export { WorkflowCancelledError, WorkflowCancelledErrorOptions };
+//# sourceMappingURL=workflow-cancelled-error.d.mts.map

package/esm/errors/workflow-cancelled-error.d.mts.map

@@ -0,0 +1 @@
+{"version":3,"file":"workflow-cancelled-error.d.mts","names":[],"sources":["../../../../../../@warlock.js/ai/src/errors/workflow-cancelled-error.ts"],"mappings":";;;;;KAIY,6BAAA,GAAgC,cAAc;EACxD,WAAA;EACA,MAAA;AAAA;;;;;;cAQW,sBAAA,SAA+B,aAAA;EAAA,gBACnB,eAAA,EAAiB,aAAA;EAAA,SAExB,WAAA;EAAA,SACA,MAAA;cAEG,OAAA,UAAiB,OAAA,EAAS,6BAAA;AAAA"}

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

@@ -0,0 +1,23 @@
+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/errors/workflow-cancelled-error.mjs.map

@@ -0,0 +1 @@
+{"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/errors/workflow-drift-error.d.mts

@@ -0,0 +1,25 @@
+import { ErrorCategory } from "./error-category.type.mjs";
+import { AIErrorOptions } from "./ai-error.mjs";
+import { WorkflowError } from "./workflow-error.mjs";
+
+//#region ../../@warlock.js/ai/src/errors/workflow-drift-error.d.ts
+type WorkflowDriftErrorOptions = AIErrorOptions & {
+  savedSignature: string;
+  currentSignature: string;
+  runId: string;
+};
+/**
+ * `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.
+ */
+declare class WorkflowDriftError extends WorkflowError {
+  static readonly defaultCategory: ErrorCategory;
+  readonly savedSignature: string;
+  readonly currentSignature: string;
+  readonly runId: string;
+  constructor(message: string, options: WorkflowDriftErrorOptions);
+}
+//#endregion
+export { WorkflowDriftError, WorkflowDriftErrorOptions };
+//# sourceMappingURL=workflow-drift-error.d.mts.map

package/esm/errors/workflow-drift-error.d.mts.map

@@ -0,0 +1 @@
+{"version":3,"file":"workflow-drift-error.d.mts","names":[],"sources":["../../../../../../@warlock.js/ai/src/errors/workflow-drift-error.ts"],"mappings":";;;;;KAIY,yBAAA,GAA4B,cAAc;EACpD,cAAA;EACA,gBAAA;EACA,KAAA;AAAA;;;;;;cAQW,kBAAA,SAA2B,aAAA;EAAA,gBACf,eAAA,EAAiB,aAAA;EAAA,SAExB,cAAA;EAAA,SACA,gBAAA;EAAA,SACA,KAAA;cAEG,OAAA,UAAiB,OAAA,EAAS,yBAAA;AAAA"}

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

@@ -0,0 +1,24 @@
+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/errors/workflow-drift-error.mjs.map

@@ -0,0 +1 @@
+{"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/errors/workflow-error.d.mts

@@ -0,0 +1,15 @@
+import { AIErrorCode } from "./error-code.type.mjs";
+import { AIError, AIErrorOptions } from "./ai-error.mjs";
+
+//#region ../../@warlock.js/ai/src/errors/workflow-error.d.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.
+ */
+declare class WorkflowError extends AIError {
+  constructor(message: string, options?: AIErrorOptions, code?: AIErrorCode);
+}
+//#endregion
+export { WorkflowError };
+//# sourceMappingURL=workflow-error.d.mts.map

package/esm/errors/workflow-error.d.mts.map

@@ -0,0 +1 @@
+{"version":3,"file":"workflow-error.d.mts","names":[],"sources":["../../../../../../@warlock.js/ai/src/errors/workflow-error.ts"],"mappings":";;;;;;AAQA;;;cAAa,aAAA,SAAsB,OAAA;cAE/B,OAAA,UACA,OAAA,GAAU,cAAA,EACV,IAAA,GAAM,WAAA;AAAA"}

package/esm/errors/workflow-error.mjs

@@ -0,0 +1,18 @@
+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/errors/workflow-error.mjs.map

@@ -0,0 +1 @@
+{"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/index.d.mts

@@ -0,0 +1,137 @@
+import { Attachment, AttachmentSource, ResolvedAttachment, StorageFileShape } from "./contracts/attachment.type.mjs";
+import { ContentPart, ImageSource } from "./contracts/content-part.type.mjs";
+import { ModelToolCallRequest } from "./contracts/model-tool-call-request.type.mjs";
+import { Message } from "./contracts/conversation-message.type.mjs";
+import { ErrorCategory } from "./errors/error-category.type.mjs";
+import { AIErrorCode } from "./errors/error-code.type.mjs";
+import { AIError, AIErrorOptions } from "./errors/ai-error.mjs";
+import { ModelPricing } from "./contracts/result/model-pricing.type.mjs";
+import { Usage } from "./contracts/result/usage.type.mjs";
+import { BaseResult } from "./contracts/result/base-result.type.mjs";
+import { AttemptEntry } from "./contracts/result/attempt-entry.type.mjs";
+import { BaseReport, REPORT_SCHEMA_VERSION, ReportStatus, ReportType } from "./contracts/result/base-report.type.mjs";
+import { FinishReason } from "./contracts/finish-reason.type.mjs";
+import { ToolCall } from "./contracts/result/tool-call.type.mjs";
+import { LLMTrip } from "./contracts/result/llm-trip.type.mjs";
+import { AgentReport, ExecutionReport, ExecutionStatus } from "./contracts/result/execution-report.type.mjs";
+import { AgentResult } from "./contracts/result/agent-result.type.mjs";
+import { AgentCompletedPayload, AgentErrorPayload, AgentStartingPayload, AgentStreamingPayload, AgentToolCalledPayload, AgentToolCallingFailedPayload, AgentToolCallingPayload, AgentTripCompletedPayload, AgentTripStartedPayload, ToolEventMeta } from "./contracts/events/agent-events.type.mjs";
+import { EventIdentity, WithoutIdentity } from "./contracts/events/event-identity.type.mjs";
+import { ExecuteResult } from "./contracts/result/execute-result.type.mjs";
+import { ExecutableContract } from "./contracts/executable.contract.mjs";
+import { StreamEvent, StreamEventBody } from "./contracts/stream/stream-event.type.mjs";
+import { StreamContract } from "./contracts/stream/stream.contract.mjs";
+import { AgentContract, AgentEventHandler } from "./contracts/agent/agent.contract.mjs";
+import { END, EndSentinel } from "./contracts/end.type.mjs";
+import { StepSnapshot } from "./contracts/result/step-result.type.mjs";
+import { WorkflowReport, WorkflowResult } from "./contracts/result/workflow-result.type.mjs";
+import { ToolConfig, ToolContext, ToolMeta, ToolMode } from "./contracts/tool.contract.mjs";
+import { AgentExecutionError } from "./errors/agent-execution-error.mjs";
+import { AgentCancelledError, AgentCancelledErrorOptions } from "./errors/agent-cancelled-error.mjs";
+import { AgentMaxTripsError, AgentMaxTripsErrorOptions } from "./errors/agent-max-trips-error.mjs";
+import { BudgetExceededError, BudgetExceededErrorOptions, BudgetUnit } from "./errors/budget-exceeded-error.mjs";
+import { ProviderError } from "./errors/provider-error.mjs";
+import { ContentFilterError, ContentFilterErrorOptions } from "./errors/content-filter-error.mjs";
+import { ContextLengthExceededError, ContextLengthExceededErrorOptions } from "./errors/context-length-exceeded-error.mjs";
+import { GuardrailPhase, GuardrailViolationError, GuardrailViolationErrorOptions } from "./errors/guardrail-violation-error.mjs";
+import { InvalidRequestError } from "./errors/invalid-request-error.mjs";
+import { SupervisorFailedError } from "./errors/supervisor-failed-error.mjs";
+import { MaxIterationsError, MaxIterationsErrorOptions } from "./errors/max-iterations-error.mjs";
+import { WorkflowError } from "./errors/workflow-error.mjs";
+import { MaxStepsExceededError, MaxStepsExceededErrorOptions } from "./errors/max-steps-exceeded-error.mjs";
+import { ProviderAuthError } from "./errors/provider-auth-error.mjs";
+import { ProviderRateLimitError, ProviderRateLimitErrorOptions } from "./errors/provider-rate-limit-error.mjs";
+import { ProviderTimeoutError } from "./errors/provider-timeout-error.mjs";
+import { QuotaExceededError } from "./errors/quota-exceeded-error.mjs";
+import { RoutingError, RoutingErrorOptions } from "./errors/routing-error.mjs";
+import { SchemaValidationError, SchemaValidationErrorOptions } from "./errors/schema-validation-error.mjs";
+import { StepFailedError, StepFailedErrorOptions } from "./errors/step-failed-error.mjs";
+import { SupervisorCancelledError, SupervisorCancelledErrorOptions } from "./errors/supervisor-cancelled-error.mjs";
+import { SupervisorDriftError, SupervisorDriftErrorOptions } from "./errors/supervisor-drift-error.mjs";
+import { SupervisorRoutingError, SupervisorRoutingErrorOptions } from "./errors/supervisor-routing-error.mjs";
+import { ToolExecutionError, ToolExecutionErrorOptions } from "./errors/tool-execution-error.mjs";
+import { WorkflowCancelledError, WorkflowCancelledErrorOptions } from "./errors/workflow-cancelled-error.mjs";
+import { WorkflowDriftError, WorkflowDriftErrorOptions } from "./errors/workflow-drift-error.mjs";
+import { ToolContract, ToolInvokeResult, tool } from "./tool/tool.mjs";
+import { NextStepResult } from "./contracts/workflow/next-step-result.type.mjs";
+import { RetryBackoff, RetryConfig } from "./contracts/workflow/retry-config.type.mjs";
+import { WorkflowContext } from "./contracts/workflow/workflow-context.type.mjs";
+import { StepAgentInput, StepDefinition, StepLocalEvents, StepOutputSpec } from "./contracts/workflow/step.contract.mjs";
+import { WorkflowDefinition, WorkflowEventHandler, WorkflowEventHandlers, WorkflowExecuteOptions, WorkflowInstance, WorkflowResumeOptions, WorkflowRunOptions } from "./contracts/workflow/workflow.contract.mjs";
+import { Placeholders } from "./contracts/placeholders.type.mjs";
+import { InstructionContract, PersonaContract, SystemPromptBlockContract, SystemPromptContract } from "./contracts/system-prompt.contract.mjs";
+import { Next } from "./contracts/supervisor/next.type.mjs";
+import { AckSnapshot, AgentBranchSnapshot, DecisionSource, IterationDecision, IterationSnapshot } from "./contracts/supervisor/iteration-snapshot.type.mjs";
+import { SupervisorInput } from "./contracts/supervisor/supervisor-input.type.mjs";
+import { EvaluateBranchResult, EvaluateContext, EvaluateResult } from "./contracts/supervisor/evaluate-context.type.mjs";
+import { RouteContext } from "./contracts/supervisor/route-context.type.mjs";
+import { AckCallback, AckConfig, AckEntry, AckRunEntry } from "./contracts/supervisor/ack-entry.type.mjs";
+import { DispatchRawResult, IntentCallback, IntentEntry, IntentRunEntry, SupervisorIntentValue } from "./contracts/supervisor/intent-entry.type.mjs";
+import { RouterEntry } from "./contracts/supervisor/router-entry.type.mjs";
+import { SupervisorConfig, SupervisorEventHandler, SupervisorEventHandlers } from "./contracts/supervisor/supervisor-config.type.mjs";
+import { SupervisorExecuteOptions, SupervisorResumeOptions } from "./contracts/supervisor/supervisor-execute-options.type.mjs";
+import { SupervisorStreamEvent } from "./contracts/supervisor/supervisor-stream-event.type.mjs";
+import { SupervisorAsToolOptions, SupervisorContract } from "./contracts/supervisor/supervisor.contract.mjs";
+import { DispatchContext, IntentRunner, IntentRunnerMap } from "./contracts/supervisor/dispatch-context.type.mjs";
+import { ClassifierAgentEntry, ClassifierCallback, ClassifierConfig, ClassifierContext, ClassifierOutput, ClassifierRefineContext, ClassifierRefineResult, ClassifierRunEntry, ClassifierSnapshot } from "./contracts/supervisor/classifier-context.type.mjs";
+import { SupervisorReport, SupervisorResult, SupervisorTerminatedBy } from "./contracts/result/supervisor-result.type.mjs";
+import { SessionSendResult } from "./contracts/result/session-send-result.type.mjs";
+import { SupervisorSnapshot, SupervisorSnapshotStatus } from "./contracts/supervisor/supervisor-snapshot.type.mjs";
+import { SupervisorAgentCompletedPayload, SupervisorAgentFailedPayload, SupervisorAgentStartingPayload, SupervisorAgentStreamingPayload, SupervisorCancelledPayload, SupervisorCompletedPayload, SupervisorErrorPayload, SupervisorEvaluateVerdictPayload, SupervisorIterationCompletedPayload, SupervisorIterationStartingPayload, SupervisorRouterDecidedPayload, SupervisorRouterDecidingPayload, SupervisorStartingPayload } from "./contracts/events/supervisor-events.type.mjs";
+import { WorkflowCancelledPayload, WorkflowCompletedPayload, WorkflowErrorPayload, WorkflowLoopWarningPayload, WorkflowStartingPayload, WorkflowStepCompletedPayload, WorkflowStepFailedPayload, WorkflowStepRetryingPayload, WorkflowStepSkippedPayload, WorkflowStepStartingPayload, WorkflowStepStreamingPayload } from "./contracts/events/workflow-events.type.mjs";
+import { AgentEventMap, SupervisorEventMap, WorkflowEventMap } from "./contracts/events/event-map.type.mjs";
+import { StreamingToolGuardConfig } from "./contracts/streaming-tool-guard-config.type.mjs";
+import { AgentExecuteOptions } from "./contracts/agent/agent-options.type.mjs";
+import { EmbedderConfig, EmbedderContract, EmbeddingBatchResult, EmbeddingResult, EmbeddingUsage } from "./contracts/embedder.contract.mjs";
+import { MiddlewareState } from "./contracts/middleware/middleware-state.type.mjs";
+import { MiddlewareAgentRef, MiddlewareExecuteContext, MiddlewareModelRef, MiddlewareToolContext, MiddlewareTripContext } from "./contracts/middleware/middleware-context.type.mjs";
+import { ModelCallOptions, ModelCapabilities, ModelContract, ModelResponse, ModelStreamChunk } from "./contracts/model.contract.mjs";
+import { AgentMiddleware, AgentMiddlewareExecuteHooks, AgentMiddlewareToolHooks, AgentMiddlewareTripHooks } from "./contracts/middleware/middleware.contract.mjs";
+import { ModelConfig, SDKAdapterContract } from "./contracts/sdk-adapter.contract.mjs";
+import { WorkflowSnapshot } from "./contracts/workflow/workflow-snapshot.type.mjs";
+import { CompleteEvent } from "./contracts/events/complete-event.type.mjs";
+import { UsageEvent } from "./contracts/events/usage-event.type.mjs";
+import { AgentConfig } from "./agent/agent-config.type.mjs";
+import { agent } from "./agent/agent.mjs";
+import { StreamController, createAgentStream } from "./agent/agent-stream.mjs";
+import { AIConfig, getAIConfig, resolveDefaultStore, setAIConfig } from "./config.mjs";
+import { BudgetOptions, BudgetPricing, budget } from "./middleware/builtins/budget.mjs";
+import { GuardrailCheck, GuardrailCheckResult, GuardrailOptions, guardrail } from "./middleware/builtins/guardrail.mjs";
+import { SemanticCacheOptions, semanticCache } from "./middleware/builtins/semantic-cache.mjs";
+import { composeMiddleware } from "./middleware/helpers/compose.mjs";
+import { forTool } from "./middleware/helpers/for-tool.mjs";
+import { supervisor } from "./supervisor/supervisor.mjs";
+import { Instruction, instruction } from "./system-prompt/instruction.mjs";
+import { Persona, persona } from "./system-prompt/persona.mjs";
+import { SystemPrompt, systemPrompt } from "./system-prompt/system-prompt.mjs";
+import { step } from "./workflow/step.mjs";
+import { workflow } from "./workflow/workflow.mjs";
+import { ai } from "./ai.mjs";
+import { MiddlewareContextByLevel, MiddlewareLevel, runPipeline } from "./middleware/pipeline.mjs";
+import { extractUserText } from "./middleware/utils/extract-user-text.mjs";
+import { NamespacedStateAccessor, namespacedState } from "./middleware/utils/namespaced-state.mjs";
+import { MockModelResponse, MockSDKConfig } from "./mock/mock-config.type.mjs";
+import { mockAgent } from "./mock/mock-agent.mjs";
+import { MockModel } from "./mock/mock-model.mjs";
+import { MockSDK } from "./mock/mock-sdk.mjs";
+import { asTool } from "./supervisor/as-tool.mjs";
+import { createCancelledError } from "./supervisor/cancellation.mjs";
+import { SupervisorEmitter } from "./supervisor/emitter.mjs";
+import { ResolvedIntentEntry, resolveIntentEntries } from "./supervisor/entries.mjs";
+import { SupervisorStreamController, createSupervisorStream } from "./supervisor/supervisor-stream.mjs";
+import { SupervisorExecution } from "./supervisor/execution.mjs";
+import { buildRouterContextMessage } from "./supervisor/router-prompt.mjs";
+import { computeSignature as computeSignature$1 } from "./supervisor/signature.mjs";
+import { loadSnapshotForResume, persistSupervisorSnapshot, snapshotKey } from "./supervisor/snapshot.mjs";
+import { renderPlaceholders } from "./system-prompt/render-placeholders.mjs";
+import { accumulateCost, computeCost } from "./utils/compute-cost.mjs";
+import { extractJsonPayload } from "./utils/extract-json-payload.mjs";
+import { generateRunId } from "./utils/generate-run-id.mjs";
+import { extractJsonSchema } from "./utils/json-schema.mjs";
+import { prepareAttachmentPart } from "./utils/prepare-attachment-part.mjs";
+import { resolveAttachment } from "./utils/resolve-attachment.mjs";
+import { safeJsonParse } from "./utils/safe-json-parse.mjs";
+import { LineageStamp, stampReportLineage } from "./utils/stamp-report-lineage.mjs";
+import { approximateTokenCount } from "./utils/token-count.mjs";
+import { computeSignature } from "./workflow/signature.mjs";
+export { AIConfig, AIError, type AIErrorCode, type AIErrorOptions, type AckCallback, type AckConfig, type AckEntry, type AckRunEntry, type AckSnapshot, type AgentBranchSnapshot, AgentCancelledError, type AgentCancelledErrorOptions, type AgentCompletedPayload, type AgentConfig, type AgentContract, type AgentErrorPayload, type AgentEventHandler, type AgentEventMap, type AgentExecuteOptions, AgentExecutionError, AgentMaxTripsError, type AgentMaxTripsErrorOptions, type AgentMiddleware, type AgentMiddlewareExecuteHooks, type AgentMiddlewareToolHooks, type AgentMiddlewareTripHooks, type AgentReport, type AgentResult, type AgentStartingPayload, type AgentStreamingPayload, type AgentToolCalledPayload, type AgentToolCallingFailedPayload, type AgentToolCallingPayload, type AgentTripCompletedPayload, type AgentTripStartedPayload, Attachment, AttachmentSource, type AttemptEntry, type BaseReport, type BaseResult, BudgetExceededError, type BudgetExceededErrorOptions, type BudgetOptions, type BudgetPricing, type BudgetUnit, type ClassifierAgentEntry, type ClassifierCallback, type ClassifierConfig, type ClassifierContext, type ClassifierOutput, type ClassifierRefineContext, type ClassifierRefineResult, type ClassifierRunEntry, type ClassifierSnapshot, type CompleteEvent, ContentFilterError, type ContentFilterErrorOptions, ContentPart, ContextLengthExceededError, type ContextLengthExceededErrorOptions, type DecisionSource, type DispatchContext, type DispatchRawResult, END, EmbedderConfig, EmbedderContract, EmbeddingBatchResult, EmbeddingResult, EmbeddingUsage, EndSentinel, type ErrorCategory, type EvaluateBranchResult, type EvaluateContext, type EvaluateResult, type EventIdentity, ExecutableContract, type ExecuteResult, type ExecutionReport, type ExecutionStatus, FinishReason, type GuardrailCheck, type GuardrailCheckResult, type GuardrailOptions, type GuardrailPhase, GuardrailViolationError, type GuardrailViolationErrorOptions, ImageSource, Instruction, InstructionContract, type IntentCallback, type IntentEntry, type IntentRunEntry, type IntentRunner, type IntentRunnerMap, InvalidRequestError, type IterationDecision, type IterationSnapshot, type LLMTrip, type LineageStamp, MaxIterationsError, type MaxIterationsErrorOptions, MaxStepsExceededError, type MaxStepsExceededErrorOptions, Message, type MiddlewareAgentRef, type MiddlewareContextByLevel, type MiddlewareExecuteContext, type MiddlewareLevel, type MiddlewareModelRef, type MiddlewareState, type MiddlewareToolContext, type MiddlewareTripContext, MockModel, type MockModelResponse, MockSDK, type MockSDKConfig, ModelCallOptions, ModelCapabilities, ModelConfig, ModelContract, type ModelPricing, ModelResponse, ModelStreamChunk, ModelToolCallRequest, type NamespacedStateAccessor, type Next, type NextStepResult, Persona, PersonaContract, Placeholders, ProviderAuthError, ProviderError, ProviderRateLimitError, type ProviderRateLimitErrorOptions, ProviderTimeoutError, QuotaExceededError, REPORT_SCHEMA_VERSION, type ReportStatus, type ReportType, ResolvedAttachment, type ResolvedIntentEntry, type RetryBackoff, type RetryConfig, type RouteContext, type RouterEntry, RoutingError, type RoutingErrorOptions, SDKAdapterContract, SchemaValidationError, type SchemaValidationErrorOptions, type SemanticCacheOptions, type SessionSendResult, type StepAgentInput, type StepDefinition, StepFailedError, type StepFailedErrorOptions, type StepLocalEvents, type StepOutputSpec, type StepSnapshot, StorageFileShape, type StreamContract, type StreamController, type StreamEvent, type StreamEventBody, StreamingToolGuardConfig, type SupervisorAgentCompletedPayload, type SupervisorAgentFailedPayload, type SupervisorAgentStartingPayload, type SupervisorAgentStreamingPayload, type SupervisorAsToolOptions, SupervisorCancelledError, type SupervisorCancelledErrorOptions, type SupervisorCancelledPayload, type SupervisorCompletedPayload, type SupervisorConfig, type SupervisorContract, SupervisorDriftError, type SupervisorDriftErrorOptions, SupervisorEmitter, type SupervisorErrorPayload, type SupervisorEvaluateVerdictPayload, type SupervisorEventHandler, type SupervisorEventHandlers, type SupervisorEventMap, type SupervisorExecuteOptions, SupervisorExecution, SupervisorFailedError, type SupervisorInput, type SupervisorIntentValue, type SupervisorIterationCompletedPayload, type SupervisorIterationStartingPayload, type SupervisorReport, type SupervisorResult, type SupervisorResumeOptions, type SupervisorRouterDecidedPayload, type SupervisorRouterDecidingPayload, SupervisorRoutingError, type SupervisorRoutingErrorOptions, type SupervisorSnapshot, type SupervisorSnapshotStatus, type SupervisorStartingPayload, type SupervisorStreamController, type SupervisorStreamEvent, type SupervisorTerminatedBy, SystemPrompt, SystemPromptBlockContract, SystemPromptContract, type ToolCall, ToolConfig, ToolContext, type ToolContract, type ToolEventMeta, ToolExecutionError, type ToolExecutionErrorOptions, type ToolInvokeResult, ToolMeta, ToolMode, type Usage, type UsageEvent, type WithoutIdentity, WorkflowCancelledError, type WorkflowCancelledErrorOptions, type WorkflowCancelledPayload, type WorkflowCompletedPayload, type WorkflowContext, type WorkflowDefinition, WorkflowDriftError, type WorkflowDriftErrorOptions, WorkflowError, type WorkflowErrorPayload, type WorkflowEventHandler, type WorkflowEventHandlers, type WorkflowEventMap, type WorkflowExecuteOptions, type WorkflowInstance, type WorkflowLoopWarningPayload, type WorkflowReport, type WorkflowResult, type WorkflowResumeOptions, type WorkflowRunOptions, type WorkflowSnapshot, type WorkflowStartingPayload, type WorkflowStepCompletedPayload, type WorkflowStepFailedPayload, type WorkflowStepRetryingPayload, type WorkflowStepSkippedPayload, type WorkflowStepStartingPayload, type WorkflowStepStreamingPayload, accumulateCost, agent, ai, approximateTokenCount, budget, buildRouterContextMessage, composeMiddleware, computeCost, computeSignature, computeSignature$1 as computeSupervisorSignature, createAgentStream, createCancelledError as createSupervisorCancelledError, createSupervisorStream, extractJsonPayload, extractJsonSchema, extractUserText, forTool, generateRunId, getAIConfig, guardrail, instruction, loadSnapshotForResume as loadSupervisorSnapshotForResume, mockAgent, namespacedState, persistSupervisorSnapshot, persona, prepareAttachmentPart, renderPlaceholders, resolveAttachment, resolveDefaultStore, resolveIntentEntries, runPipeline, safeJsonParse, semanticCache, setAIConfig, stampReportLineage, step, supervisor, asTool as supervisorAsTool, snapshotKey as supervisorSnapshotKey, systemPrompt, tool, workflow };

package/esm/index.mjs

@@ -0,0 +1,81 @@
+import { AIError } from "./errors/ai-error.mjs";
+import { AgentExecutionError } from "./errors/agent-execution-error.mjs";
+import { AgentCancelledError } from "./errors/agent-cancelled-error.mjs";
+import { AgentMaxTripsError } from "./errors/agent-max-trips-error.mjs";
+import { BudgetExceededError } from "./errors/budget-exceeded-error.mjs";
+import { ProviderError } from "./errors/provider-error.mjs";
+import { ContentFilterError } from "./errors/content-filter-error.mjs";
+import { ContextLengthExceededError } from "./errors/context-length-exceeded-error.mjs";
+import { GuardrailViolationError } from "./errors/guardrail-violation-error.mjs";
+import { InvalidRequestError } from "./errors/invalid-request-error.mjs";
+import { SupervisorFailedError } from "./errors/supervisor-failed-error.mjs";
+import { MaxIterationsError } from "./errors/max-iterations-error.mjs";
+import { WorkflowError } from "./errors/workflow-error.mjs";
+import { MaxStepsExceededError } from "./errors/max-steps-exceeded-error.mjs";
+import { ProviderAuthError } from "./errors/provider-auth-error.mjs";
+import { ProviderRateLimitError } from "./errors/provider-rate-limit-error.mjs";
+import { ProviderTimeoutError } from "./errors/provider-timeout-error.mjs";
+import { QuotaExceededError } from "./errors/quota-exceeded-error.mjs";
+import { RoutingError } from "./errors/routing-error.mjs";
+import { SchemaValidationError } from "./errors/schema-validation-error.mjs";
+import { StepFailedError } from "./errors/step-failed-error.mjs";
+import { SupervisorCancelledError } from "./errors/supervisor-cancelled-error.mjs";
+import { SupervisorDriftError } from "./errors/supervisor-drift-error.mjs";
+import { SupervisorRoutingError } from "./errors/supervisor-routing-error.mjs";
+import { ToolExecutionError } from "./errors/tool-execution-error.mjs";
+import { WorkflowCancelledError } from "./errors/workflow-cancelled-error.mjs";
+import { WorkflowDriftError } from "./errors/workflow-drift-error.mjs";
+import "./errors/index.mjs";
+import { extractUserText } from "./middleware/utils/extract-user-text.mjs";
+import { namespacedState } from "./middleware/utils/namespaced-state.mjs";
+import { budget } from "./middleware/builtins/budget.mjs";
+import { guardrail } from "./middleware/builtins/guardrail.mjs";
+import { getAIConfig, resolveDefaultStore, setAIConfig } from "./config.mjs";
+import { semanticCache } from "./middleware/builtins/semantic-cache.mjs";
+import { composeMiddleware } from "./middleware/helpers/compose.mjs";
+import { forTool } from "./middleware/helpers/for-tool.mjs";
+import { runPipeline } from "./middleware/pipeline.mjs";
+import "./middleware/index.mjs";
+import { accumulateCost, computeCost } from "./utils/compute-cost.mjs";
+import { extractJsonPayload } from "./utils/extract-json-payload.mjs";
+import { generateRunId } from "./utils/generate-run-id.mjs";
+import { extractJsonSchema } from "./utils/json-schema.mjs";
+import { resolveAttachment } from "./utils/resolve-attachment.mjs";
+import { prepareAttachmentPart } from "./utils/prepare-attachment-part.mjs";
+import { safeJsonParse } from "./utils/safe-json-parse.mjs";
+import { REPORT_SCHEMA_VERSION } from "./contracts/result/base-report.type.mjs";
+import { stampReportLineage } from "./utils/stamp-report-lineage.mjs";
+import { approximateTokenCount } from "./utils/token-count.mjs";
+import "./utils/index.mjs";
+import { createAgentStream } from "./agent/agent-stream.mjs";
+import { agent } from "./agent/agent.mjs";
+import "./agent/index.mjs";
+import { tool } from "./tool/tool.mjs";
+import { asTool } from "./supervisor/as-tool.mjs";
+import { SupervisorEmitter } from "./supervisor/emitter.mjs";
+import { resolveIntentEntries } from "./supervisor/entries.mjs";
+import { END } from "./contracts/end.type.mjs";
+import { createCancelledError } from "./supervisor/cancellation.mjs";
+import { buildRouterContextMessage } from "./supervisor/router-prompt.mjs";
+import { loadSnapshotForResume, persistSupervisorSnapshot, snapshotKey } from "./supervisor/snapshot.mjs";
+import { SupervisorExecution } from "./supervisor/execution.mjs";
+import { computeSignature as computeSignature$1 } from "./supervisor/signature.mjs";
+import { createSupervisorStream } from "./supervisor/supervisor-stream.mjs";
+import { supervisor } from "./supervisor/supervisor.mjs";
+import { renderPlaceholders } from "./system-prompt/render-placeholders.mjs";
+import { Instruction, instruction } from "./system-prompt/instruction.mjs";
+import { Persona, persona } from "./system-prompt/persona.mjs";
+import { SystemPrompt, systemPrompt } from "./system-prompt/system-prompt.mjs";
+import { step } from "./workflow/step.mjs";
+import { computeSignature } from "./workflow/signature.mjs";
+import { workflow } from "./workflow/workflow.mjs";
+import { ai } from "./ai.mjs";
+import { MockModel } from "./mock/mock-model.mjs";
+import { MockSDK } from "./mock/mock-sdk.mjs";
+import { mockAgent } from "./mock/mock-agent.mjs";
+import "./mock/index.mjs";
+import "./supervisor/index.mjs";
+import "./tool/index.mjs";
+import "./workflow/index.mjs";
+
+export { AIError, AgentCancelledError, AgentExecutionError, AgentMaxTripsError, BudgetExceededError, ContentFilterError, ContextLengthExceededError, END, GuardrailViolationError, Instruction, InvalidRequestError, MaxIterationsError, MaxStepsExceededError, MockModel, MockSDK, Persona, ProviderAuthError, ProviderError, ProviderRateLimitError, ProviderTimeoutError, QuotaExceededError, REPORT_SCHEMA_VERSION, RoutingError, SchemaValidationError, StepFailedError, SupervisorCancelledError, SupervisorDriftError, SupervisorEmitter, SupervisorExecution, SupervisorFailedError, SupervisorRoutingError, SystemPrompt, ToolExecutionError, WorkflowCancelledError, WorkflowDriftError, WorkflowError, accumulateCost, agent, ai, approximateTokenCount, budget, buildRouterContextMessage, composeMiddleware, computeCost, computeSignature, computeSignature$1 as computeSupervisorSignature, createAgentStream, createCancelledError as createSupervisorCancelledError, createSupervisorStream, extractJsonPayload, extractJsonSchema, extractUserText, forTool, generateRunId, getAIConfig, guardrail, instruction, loadSnapshotForResume as loadSupervisorSnapshotForResume, mockAgent, namespacedState, persistSupervisorSnapshot, persona, prepareAttachmentPart, renderPlaceholders, resolveAttachment, resolveDefaultStore, resolveIntentEntries, runPipeline, safeJsonParse, semanticCache, setAIConfig, stampReportLineage, step, supervisor, asTool as supervisorAsTool, snapshotKey as supervisorSnapshotKey, systemPrompt, tool, workflow };

package/esm/middleware/builtins/budget.d.mts

@@ -0,0 +1,103 @@
+import { AgentMiddleware } from "../../contracts/middleware/middleware.contract.mjs";
+//#region ../../@warlock.js/ai/src/middleware/builtins/budget.d.ts
+/**
+ * Per-model pricing used to compute USD cost from token counts.
+ * Caller-supplied — no bundled table. Keys are model names (the
+ * `ModelContract.name` value); values are input / output token
+ * prices expressed as **USD per 1K tokens** to match every major
+ * provider's published pricing sheet.
+ */
+type BudgetPricing = Record<string, {
+  /** USD per 1,000 input tokens. */inputPer1K: number; /** USD per 1,000 output tokens. */
+  outputPer1K: number;
+}>;
+/**
+ * Configuration for `budget()`. At least one of `maxTokens` or
+ * `maxCostUSD` must be supplied — a budget with no cap is a no-op.
+ */
+type BudgetOptions = {
+  /**
+   * Hard cap on cumulative total tokens (input + output, summed
+   * across every trip of the run). Inclusive — exceeding triggers
+   * the configured `onExceeded`.
+   */
+  maxTokens?: number;
+  /**
+   * Hard cap on cumulative USD cost. Requires `pricing` for the
+   * agent's configured model — without a pricing entry the USD check
+   * silently skips (tokens-only enforcement still applies).
+   */
+  maxCostUSD?: number;
+  /**
+   * Per-model pricing table used to compute USD cost. Only consulted
+   * when `maxCostUSD` is set. Model names must match the running
+   * agent's `ModelContract.name` exactly.
+   */
+  pricing?: BudgetPricing;
+  /**
+   * Behavior when a cap is breached. `"abort"` throws
+   * `BudgetExceededError` — surfaces on `result.error`, stops the
+   * run at the next trip boundary. `"warn"` logs a warning and
+   * lets the run continue (useful for observability-first rollouts
+   * before flipping the switch to abort). Default `"abort"`.
+   */
+  onExceeded?: "abort" | "warn";
+  /**
+   * Override the middleware name. Useful when two budgets coexist
+   * (e.g. a per-request cap plus a session-wide cap via different
+   * instances). Default `"budget"`.
+   */
+  name?: string;
+};
+/**
+ * Enforced token and / or USD budget for an agent run.
+ *
+ * **Role.** Guards against runaway tool loops, misconfigured
+ * prompts, and unexpected provider price swings by capping
+ * cumulative usage across every LLM trip of a single execution.
+ * Aborts the run with a typed `BudgetExceededError` the moment a cap
+ * is breached, rather than letting the damage grow trip by trip.
+ *
+ * **Scope.** Per-execution. A fresh counter is created at
+ * `execute.before` and lives in the middleware state bag until the
+ * run ends. Two concurrent `agent.execute()` calls on the same
+ * agent therefore enforce the cap independently.
+ *
+ * **Token accounting.** After each successful trip, the middleware
+ * adds `response.usage.total` to its running total and checks
+ * against `maxTokens`. Synthetic trips (cache hits) contribute
+ * `usage.total` as returned by the cache — cache middleware is
+ * expected to surface zero usage on a hit, which naturally excludes
+ * those trips from the budget.
+ *
+ * **USD accounting.** When `maxCostUSD` + `pricing[modelName]` are
+ * both present, the middleware converts per-trip input / output
+ * tokens to USD and accumulates. Missing pricing silently degrades
+ * to tokens-only — explicit rather than guessing.
+ *
+ * **Warn mode.** `onExceeded: "warn"` logs a single warning the first
+ * time a cap is breached and lets the run continue. Useful for
+ * measuring real-world traffic against a proposed cap before flipping
+ * to `"abort"` in production.
+ *
+ * @example
+ * const budgetMiddleware = budget({ maxTokens: 50_000 });
+ *
+ * const myAgent = agent({
+ *   model,
+ *   middleware: [budgetMiddleware],
+ * });
+ *
+ * @example
+ * // With USD cap and custom pricing
+ * const guard = budget({
+ *   maxCostUSD: 0.5,
+ *   pricing: {
+ *     "gpt-4o": { inputPer1K: 0.005, outputPer1K: 0.015 },
+ *   },
+ * });
+ */
+declare function budget(options: BudgetOptions): AgentMiddleware;
+//#endregion
+export { BudgetOptions, BudgetPricing, budget };
+//# sourceMappingURL=budget.d.mts.map

package/esm/middleware/builtins/budget.d.mts.map

@@ -0,0 +1 @@
+{"version":3,"file":"budget.d.mts","names":[],"sources":["../../../../../../../@warlock.js/ai/src/middleware/builtins/budget.ts"],"mappings":";;;;;AAWA;;;;KAAY,aAAA,GAAgB,MAAM;EAI9B,kCAAA,UAAA,UAEW;EAAX,WAAA;AAAA;;;;;KAQQ,aAAA;EAkBV;;;;;EAZA,SAAA;EA+Fc;;;;;EAzFd,UAAA;EAyF8C;;AAAe;;;EAnF7D,OAAA,GAAU,aAAa;;;;;;;;EAQvB,UAAA;;;;;;EAMA,IAAA;AAAA;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;iBAqEc,MAAA,CAAO,OAAA,EAAS,aAAA,GAAgB,eAAe"}