octoflow-core 1.0.0

package/dist/domain/errors/domain.js

@@ -0,0 +1,71 @@
+import {
+  AgentRunError,
+  AgentTimeoutError,
+  SshConnectionError,
+  UnsafeCommandError
+} from "./agent.js";
+import { ApiHttpError, ApiKeyError, ApiStreamError } from "./api.js";
+import {
+  ApprovalConcurrencyError,
+  ApprovalNotFoundError,
+  ApprovalStateError
+} from "./approval.js";
+import {
+  BackendNotAvailableError,
+  BackendSwitchLimitError,
+  BackendSwitchRejectedError,
+  BackendSwitchUnsupportedError,
+  NoBackendAvailableError
+} from "./backend.js";
+import {
+  OllamaAuthError,
+  OllamaModelNotFoundError,
+  OllamaNoModelsError,
+  OllamaNotRunningError,
+  OllamaToolResultMissingNameError,
+  OllamaWebToolsAuthError
+} from "./ollama.js";
+import {
+  SubagentConcurrencyLimitError,
+  SubagentDepthExceededError,
+  SubagentRoleNotFoundError
+} from "./subagent.js";
+import {
+  BudgetExhaustedError,
+  QueueFullError,
+  SessionNotFoundError,
+  TaskNotFoundError,
+  TaskTerminalError
+} from "./task.js";
+export {
+  AgentRunError,
+  AgentTimeoutError,
+  ApiHttpError,
+  ApiKeyError,
+  ApiStreamError,
+  ApprovalConcurrencyError,
+  ApprovalNotFoundError,
+  ApprovalStateError,
+  BackendNotAvailableError,
+  BackendSwitchLimitError,
+  BackendSwitchRejectedError,
+  BackendSwitchUnsupportedError,
+  BudgetExhaustedError,
+  NoBackendAvailableError,
+  OllamaAuthError,
+  OllamaModelNotFoundError,
+  OllamaNoModelsError,
+  OllamaNotRunningError,
+  OllamaToolResultMissingNameError,
+  OllamaWebToolsAuthError,
+  QueueFullError,
+  SessionNotFoundError,
+  SshConnectionError,
+  SubagentConcurrencyLimitError,
+  SubagentDepthExceededError,
+  SubagentRoleNotFoundError,
+  TaskNotFoundError,
+  TaskTerminalError,
+  UnsafeCommandError
+};
+//# sourceMappingURL=domain.js.map

package/dist/domain/errors/domain.js.map

@@ -0,0 +1,7 @@
+{
+  "version": 3,
+  "sources": ["../../../src/domain/errors/domain.ts"],
+  "sourcesContent": ["/**\n * Aggregator of every domain error class. Split from a single 511-LOC file\n * into seven cohesive modules \u2014 one per ownership area \u2014 to make the\n * AGENTS.md \u2264 400-LOC source-budget enforceable. Importers can keep using\n * `octoflow-core/domain/errors/domain.js` as-is, or import directly\n * from the per-area files for narrower scopes.\n */\nexport {\n  AgentRunError,\n  AgentTimeoutError,\n  SshConnectionError,\n  UnsafeCommandError,\n} from './agent.js';\nexport { ApiHttpError, ApiKeyError, ApiStreamError } from './api.js';\nexport {\n  ApprovalConcurrencyError,\n  ApprovalNotFoundError,\n  ApprovalStateError,\n} from './approval.js';\nexport {\n  BackendNotAvailableError,\n  BackendSwitchLimitError,\n  BackendSwitchRejectedError,\n  BackendSwitchUnsupportedError,\n  NoBackendAvailableError,\n} from './backend.js';\nexport {\n  OllamaAuthError,\n  OllamaModelNotFoundError,\n  OllamaNoModelsError,\n  OllamaNotRunningError,\n  OllamaToolResultMissingNameError,\n  OllamaWebToolsAuthError,\n} from './ollama.js';\nexport {\n  SubagentConcurrencyLimitError,\n  SubagentDepthExceededError,\n  SubagentRoleNotFoundError,\n} from './subagent.js';\nexport {\n  BudgetExhaustedError,\n  QueueFullError,\n  SessionNotFoundError,\n  TaskNotFoundError,\n  TaskTerminalError,\n} from './task.js';\n"],
+  "mappings": "AAOA;AAAA,EACE;AAAA,EACA;AAAA,EACA;AAAA,EACA;AAAA,OACK;AACP,SAAS,cAAc,aAAa,sBAAsB;AAC1D;AAAA,EACE;AAAA,EACA;AAAA,EACA;AAAA,OACK;AACP;AAAA,EACE;AAAA,EACA;AAAA,EACA;AAAA,EACA;AAAA,EACA;AAAA,OACK;AACP;AAAA,EACE;AAAA,EACA;AAAA,EACA;AAAA,EACA;AAAA,EACA;AAAA,EACA;AAAA,OACK;AACP;AAAA,EACE;AAAA,EACA;AAAA,EACA;AAAA,OACK;AACP;AAAA,EACE;AAAA,EACA;AAAA,EACA;AAAA,EACA;AAAA,EACA;AAAA,OACK;",
+  "names": []
+}

package/dist/domain/errors/env-limits.d.ts

@@ -0,0 +1,2 @@
+export declare function isEnvLimitedErrorMessage(message: string | null | undefined): boolean;
+//# sourceMappingURL=env-limits.d.ts.map

package/dist/domain/errors/env-limits.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"env-limits.d.ts","sourceRoot":"","sources":["../../../src/domain/errors/env-limits.ts"],"names":[],"mappings":"AAqBA,wBAAgB,wBAAwB,CACtC,OAAO,EAAE,MAAM,GAAG,IAAI,GAAG,SAAS,GACjC,OAAO,CAGT"}

package/dist/domain/errors/env-limits.js

@@ -0,0 +1,21 @@
+const ENV_LIMIT_PATTERNS = [
+  /you'?ve hit your limit/i,
+  /quota exceeded/i,
+  /exceeded your current quota/i,
+  /rate limit/i,
+  /\b429\b/i,
+  /billing details/i,
+  /invalid api key/i,
+  /expired_api_key/i,
+  /subscription not active/i,
+  /insufficient[_\s-]?quota/i,
+  /failed to record rollout items/i
+];
+function isEnvLimitedErrorMessage(message) {
+  if (!message) return false;
+  return ENV_LIMIT_PATTERNS.some((pattern) => pattern.test(message));
+}
+export {
+  isEnvLimitedErrorMessage
+};
+//# sourceMappingURL=env-limits.js.map

package/dist/domain/errors/env-limits.js.map

@@ -0,0 +1,7 @@
+{
+  "version": 3,
+  "sources": ["../../../src/domain/errors/env-limits.ts"],
+  "sourcesContent": ["/**\n * Heuristics for account / quota / auth limits that are external to bridge wiring.\n *\n * These messages appear across CLI stderr and API error payloads. Consumers can\n * use this helper to mark checks as \"env-limited\" (skip/warn) instead of hard\n * failures when the runtime is blocked by provider state.\n */\nconst ENV_LIMIT_PATTERNS: readonly RegExp[] = [\n  /you'?ve hit your limit/i,\n  /quota exceeded/i,\n  /exceeded your current quota/i,\n  /rate limit/i,\n  /\\b429\\b/i,\n  /billing details/i,\n  /invalid api key/i,\n  /expired_api_key/i,\n  /subscription not active/i,\n  /insufficient[_\\s-]?quota/i,\n  /failed to record rollout items/i,\n];\n\nexport function isEnvLimitedErrorMessage(\n  message: string | null | undefined\n): boolean {\n  if (!message) return false;\n  return ENV_LIMIT_PATTERNS.some((pattern) => pattern.test(message));\n}\n"],
+  "mappings": "AAOA,MAAM,qBAAwC;AAAA,EAC5C;AAAA,EACA;AAAA,EACA;AAAA,EACA;AAAA,EACA;AAAA,EACA;AAAA,EACA;AAAA,EACA;AAAA,EACA;AAAA,EACA;AAAA,EACA;AACF;AAEO,SAAS,yBACd,SACS;AACT,MAAI,CAAC,QAAS,QAAO;AACrB,SAAO,mBAAmB,KAAK,CAAC,YAAY,QAAQ,KAAK,OAAO,CAAC;AACnE;",
+  "names": []
+}

package/dist/domain/errors/index.d.ts

@@ -0,0 +1,6 @@
+export type { SerializedCause, SerializedError } from './base.js';
+export { deserializeError, OctoFlowError, registeredErrorCodes, setExposeStacks, } from './base.js';
+export { AgentRunError, AgentTimeoutError, ApiHttpError, ApiKeyError, ApiStreamError, ApprovalConcurrencyError, ApprovalNotFoundError, ApprovalStateError, BackendNotAvailableError, BackendSwitchLimitError, BackendSwitchRejectedError, BackendSwitchUnsupportedError, BudgetExhaustedError, NoBackendAvailableError, OllamaAuthError, OllamaModelNotFoundError, OllamaNoModelsError, OllamaNotRunningError, OllamaToolResultMissingNameError, OllamaWebToolsAuthError, QueueFullError, SessionNotFoundError, SshConnectionError, SubagentConcurrencyLimitError, SubagentDepthExceededError, SubagentRoleNotFoundError, TaskNotFoundError, TaskTerminalError, UnsafeCommandError, } from './domain.js';
+export { isEnvLimitedErrorMessage } from './env-limits.js';
+export { PolicyDeniedError } from './policy.js';
+//# sourceMappingURL=index.d.ts.map

package/dist/domain/errors/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../src/domain/errors/index.ts"],"names":[],"mappings":"AAAA,YAAY,EAAE,eAAe,EAAE,eAAe,EAAE,MAAM,WAAW,CAAC;AAClE,OAAO,EACL,gBAAgB,EAChB,aAAa,EACb,oBAAoB,EACpB,eAAe,GAChB,MAAM,WAAW,CAAC;AACnB,OAAO,EACL,aAAa,EACb,iBAAiB,EACjB,YAAY,EACZ,WAAW,EACX,cAAc,EACd,wBAAwB,EACxB,qBAAqB,EACrB,kBAAkB,EAClB,wBAAwB,EACxB,uBAAuB,EACvB,0BAA0B,EAC1B,6BAA6B,EAC7B,oBAAoB,EACpB,uBAAuB,EACvB,eAAe,EACf,wBAAwB,EACxB,mBAAmB,EACnB,qBAAqB,EACrB,gCAAgC,EAChC,uBAAuB,EACvB,cAAc,EACd,oBAAoB,EACpB,kBAAkB,EAClB,6BAA6B,EAC7B,0BAA0B,EAC1B,yBAAyB,EACzB,iBAAiB,EACjB,iBAAiB,EACjB,kBAAkB,GACnB,MAAM,aAAa,CAAC;AACrB,OAAO,EAAE,wBAAwB,EAAE,MAAM,iBAAiB,CAAC;AAC3D,OAAO,EAAE,iBAAiB,EAAE,MAAM,aAAa,CAAC"}

package/dist/domain/errors/index.js

@@ -0,0 +1,77 @@
+import {
+  deserializeError,
+  OctoFlowError,
+  registeredErrorCodes,
+  setExposeStacks
+} from "./base.js";
+import {
+  AgentRunError,
+  AgentTimeoutError,
+  ApiHttpError,
+  ApiKeyError,
+  ApiStreamError,
+  ApprovalConcurrencyError,
+  ApprovalNotFoundError,
+  ApprovalStateError,
+  BackendNotAvailableError,
+  BackendSwitchLimitError,
+  BackendSwitchRejectedError,
+  BackendSwitchUnsupportedError,
+  BudgetExhaustedError,
+  NoBackendAvailableError,
+  OllamaAuthError,
+  OllamaModelNotFoundError,
+  OllamaNoModelsError,
+  OllamaNotRunningError,
+  OllamaToolResultMissingNameError,
+  OllamaWebToolsAuthError,
+  QueueFullError,
+  SessionNotFoundError,
+  SshConnectionError,
+  SubagentConcurrencyLimitError,
+  SubagentDepthExceededError,
+  SubagentRoleNotFoundError,
+  TaskNotFoundError,
+  TaskTerminalError,
+  UnsafeCommandError
+} from "./domain.js";
+import { isEnvLimitedErrorMessage } from "./env-limits.js";
+import { PolicyDeniedError } from "./policy.js";
+export {
+  AgentRunError,
+  AgentTimeoutError,
+  ApiHttpError,
+  ApiKeyError,
+  ApiStreamError,
+  ApprovalConcurrencyError,
+  ApprovalNotFoundError,
+  ApprovalStateError,
+  BackendNotAvailableError,
+  BackendSwitchLimitError,
+  BackendSwitchRejectedError,
+  BackendSwitchUnsupportedError,
+  BudgetExhaustedError,
+  NoBackendAvailableError,
+  OctoFlowError,
+  OllamaAuthError,
+  OllamaModelNotFoundError,
+  OllamaNoModelsError,
+  OllamaNotRunningError,
+  OllamaToolResultMissingNameError,
+  OllamaWebToolsAuthError,
+  PolicyDeniedError,
+  QueueFullError,
+  SessionNotFoundError,
+  SshConnectionError,
+  SubagentConcurrencyLimitError,
+  SubagentDepthExceededError,
+  SubagentRoleNotFoundError,
+  TaskNotFoundError,
+  TaskTerminalError,
+  UnsafeCommandError,
+  deserializeError,
+  isEnvLimitedErrorMessage,
+  registeredErrorCodes,
+  setExposeStacks
+};
+//# sourceMappingURL=index.js.map

package/dist/domain/errors/index.js.map

@@ -0,0 +1,7 @@
+{
+  "version": 3,
+  "sources": ["../../../src/domain/errors/index.ts"],
+  "sourcesContent": ["export type { SerializedCause, SerializedError } from './base.js';\nexport {\n  deserializeError,\n  OctoFlowError,\n  registeredErrorCodes,\n  setExposeStacks,\n} from './base.js';\nexport {\n  AgentRunError,\n  AgentTimeoutError,\n  ApiHttpError,\n  ApiKeyError,\n  ApiStreamError,\n  ApprovalConcurrencyError,\n  ApprovalNotFoundError,\n  ApprovalStateError,\n  BackendNotAvailableError,\n  BackendSwitchLimitError,\n  BackendSwitchRejectedError,\n  BackendSwitchUnsupportedError,\n  BudgetExhaustedError,\n  NoBackendAvailableError,\n  OllamaAuthError,\n  OllamaModelNotFoundError,\n  OllamaNoModelsError,\n  OllamaNotRunningError,\n  OllamaToolResultMissingNameError,\n  OllamaWebToolsAuthError,\n  QueueFullError,\n  SessionNotFoundError,\n  SshConnectionError,\n  SubagentConcurrencyLimitError,\n  SubagentDepthExceededError,\n  SubagentRoleNotFoundError,\n  TaskNotFoundError,\n  TaskTerminalError,\n  UnsafeCommandError,\n} from './domain.js';\nexport { isEnvLimitedErrorMessage } from './env-limits.js';\nexport { PolicyDeniedError } from './policy.js';\n"],
+  "mappings": "AACA;AAAA,EACE;AAAA,EACA;AAAA,EACA;AAAA,EACA;AAAA,OACK;AACP;AAAA,EACE;AAAA,EACA;AAAA,EACA;AAAA,EACA;AAAA,EACA;AAAA,EACA;AAAA,EACA;AAAA,EACA;AAAA,EACA;AAAA,EACA;AAAA,EACA;AAAA,EACA;AAAA,EACA;AAAA,EACA;AAAA,EACA;AAAA,EACA;AAAA,EACA;AAAA,EACA;AAAA,EACA;AAAA,EACA;AAAA,EACA;AAAA,EACA;AAAA,EACA;AAAA,EACA;AAAA,EACA;AAAA,EACA;AAAA,EACA;AAAA,EACA;AAAA,EACA;AAAA,OACK;AACP,SAAS,gCAAgC;AACzC,SAAS,yBAAyB;",
+  "names": []
+}

package/dist/domain/errors/ollama.d.ts

@@ -0,0 +1,49 @@
+import { OctoFlowError } from './base.js';
+/**
+ * Thrown when the Ollama server is not reachable at the configured host.
+ * Common causes: `ollama serve` is not running, wrong OLLAMA_HOST, firewall.
+ */
+export declare class OllamaNotRunningError extends OctoFlowError {
+    readonly host: string;
+    constructor(host: string, cause?: string);
+}
+/**
+ * Thrown when a requested model is not installed locally.
+ */
+export declare class OllamaModelNotFoundError extends OctoFlowError {
+    readonly model: string;
+    constructor(model: string);
+}
+/**
+ * Thrown when no models are installed on the Ollama server and auto-detection
+ * was requested (model: 'auto'). The user needs to pull at least one model.
+ */
+export declare class OllamaNoModelsError extends OctoFlowError {
+    constructor();
+}
+/**
+ * Thrown when the Ollama host rejects an authenticated request (401/403).
+ * Typically surfaces when talking to https://ollama.com hosted instances with
+ * a missing or invalid `OLLAMA_API_KEY`.
+ */
+export declare class OllamaAuthError extends OctoFlowError {
+    readonly host: string;
+    constructor(host: string, cause?: string);
+}
+/**
+ * Thrown when a `tool` role message is about to be sent to Ollama without a
+ * `tool_name`/`toolName` metadata field. Ollama pairs tool results to calls by
+ * name; an empty string risks mispaired results on multi-tool turns.
+ */
+export declare class OllamaToolResultMissingNameError extends OctoFlowError {
+    constructor();
+}
+/**
+ * Thrown when {@link OllamaClient.webSearch} or {@link OllamaClient.webFetch}
+ * are invoked without a valid API key. Ollama's hosted web tools require
+ * `OLLAMA_API_KEY` — there is no local fallback.
+ */
+export declare class OllamaWebToolsAuthError extends OctoFlowError {
+    constructor(cause?: string);
+}
+//# sourceMappingURL=ollama.d.ts.map

package/dist/domain/errors/ollama.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"ollama.d.ts","sourceRoot":"","sources":["../../../src/domain/errors/ollama.ts"],"names":[],"mappings":"AAAA,OAAO,EAAa,aAAa,EAAsB,MAAM,WAAW,CAAC;AAEzE;;;GAGG;AACH,qBAAa,qBAAsB,SAAQ,aAAa;IACtD,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAC;gBAEV,IAAI,EAAE,MAAM,EAAE,KAAK,CAAC,EAAE,MAAM;CAWzC;AAUD;;GAEG;AACH,qBAAa,wBAAyB,SAAQ,aAAa;IACzD,QAAQ,CAAC,KAAK,EAAE,MAAM,CAAC;gBAEX,KAAK,EAAE,MAAM;CAU1B;AAMD;;;GAGG;AACH,qBAAa,mBAAoB,SAAQ,aAAa;;CAUrD;AAGD;;;;GAIG;AACH,qBAAa,eAAgB,SAAQ,aAAa;IAChD,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAC;gBAEV,IAAI,EAAE,MAAM,EAAE,KAAK,CAAC,EAAE,MAAM;CAWzC;AAUD;;;;GAIG;AACH,qBAAa,gCAAiC,SAAQ,aAAa;;CAUlE;AAMD;;;;GAIG;AACH,qBAAa,uBAAwB,SAAQ,aAAa;gBAC5C,KAAK,CAAC,EAAE,MAAM;CAU3B"}

package/dist/domain/errors/ollama.js

@@ -0,0 +1,103 @@
+import { ctxString, OctoFlowError, registerErrorClass } from "./base.js";
+class OllamaNotRunningError extends OctoFlowError {
+  host;
+  constructor(host, cause) {
+    super(
+      "OLLAMA_NOT_RUNNING",
+      `Ollama server is not reachable at ${host}. Make sure \`ollama serve\` is running or set OLLAMA_HOST to the correct address.` + (cause ? ` (${cause})` : ""),
+      { host, ...cause ? { cause } : {} }
+    );
+    this.name = "OllamaNotRunningError";
+    this.host = host;
+  }
+}
+registerErrorClass(
+  "OLLAMA_NOT_RUNNING",
+  (p) => new OllamaNotRunningError(
+    ctxString(p.context, "host"),
+    ctxString(p.context, "cause") || void 0
+  )
+);
+class OllamaModelNotFoundError extends OctoFlowError {
+  model;
+  constructor(model) {
+    super(
+      "OLLAMA_MODEL_NOT_FOUND",
+      `Model "${model}" is not installed. Run \`ollama pull ${model}\` to download it, or browse available models at https://ollama.com/library`,
+      { model }
+    );
+    this.name = "OllamaModelNotFoundError";
+    this.model = model;
+  }
+}
+registerErrorClass(
+  "OLLAMA_MODEL_NOT_FOUND",
+  (p) => new OllamaModelNotFoundError(ctxString(p.context, "model"))
+);
+class OllamaNoModelsError extends OctoFlowError {
+  constructor() {
+    super(
+      "OLLAMA_NO_MODELS",
+      "No models are installed on the Ollama server. Pull a model first: `ollama pull llama3.2:3b` (or any model from https://ollama.com/library)",
+      {}
+    );
+    this.name = "OllamaNoModelsError";
+  }
+}
+registerErrorClass("OLLAMA_NO_MODELS", () => new OllamaNoModelsError());
+class OllamaAuthError extends OctoFlowError {
+  host;
+  constructor(host, cause) {
+    super(
+      "OLLAMA_AUTH",
+      `Ollama host ${host} rejected the request (authentication failed). Set OLLAMA_API_KEY (or \`apiKey\` on the client) to a valid token for this host.` + (cause ? ` (${cause})` : ""),
+      { host, ...cause ? { cause } : {} }
+    );
+    this.name = "OllamaAuthError";
+    this.host = host;
+  }
+}
+registerErrorClass(
+  "OLLAMA_AUTH",
+  (p) => new OllamaAuthError(
+    ctxString(p.context, "host"),
+    ctxString(p.context, "cause") || void 0
+  )
+);
+class OllamaToolResultMissingNameError extends OctoFlowError {
+  constructor() {
+    super(
+      "OLLAMA_TOOL_RESULT_MISSING_NAME",
+      "Cannot forward a tool-result message to Ollama without a `toolName` (originating tool's name). Set `metadata.toolName` on the `tool_result` part, or pass `strictToolNames: false` to fall back to the legacy empty-string behavior.",
+      {}
+    );
+    this.name = "OllamaToolResultMissingNameError";
+  }
+}
+registerErrorClass(
+  "OLLAMA_TOOL_RESULT_MISSING_NAME",
+  () => new OllamaToolResultMissingNameError()
+);
+class OllamaWebToolsAuthError extends OctoFlowError {
+  constructor(cause) {
+    super(
+      "OLLAMA_WEB_TOOLS_AUTH",
+      "Ollama web tools (webSearch / webFetch) require an API key. Set OLLAMA_API_KEY or pass `apiKey` to the client." + (cause ? ` (${cause})` : ""),
+      cause ? { cause } : {}
+    );
+    this.name = "OllamaWebToolsAuthError";
+  }
+}
+registerErrorClass(
+  "OLLAMA_WEB_TOOLS_AUTH",
+  (p) => new OllamaWebToolsAuthError(ctxString(p.context, "cause") || void 0)
+);
+export {
+  OllamaAuthError,
+  OllamaModelNotFoundError,
+  OllamaNoModelsError,
+  OllamaNotRunningError,
+  OllamaToolResultMissingNameError,
+  OllamaWebToolsAuthError
+};
+//# sourceMappingURL=ollama.js.map

package/dist/domain/errors/ollama.js.map

@@ -0,0 +1,7 @@
+{
+  "version": 3,
+  "sources": ["../../../src/domain/errors/ollama.ts"],
+  "sourcesContent": ["import { ctxString, OctoFlowError, registerErrorClass } from './base.js';\n\n/**\n * Thrown when the Ollama server is not reachable at the configured host.\n * Common causes: `ollama serve` is not running, wrong OLLAMA_HOST, firewall.\n */\nexport class OllamaNotRunningError extends OctoFlowError {\n  readonly host: string;\n\n  constructor(host: string, cause?: string) {\n    super(\n      'OLLAMA_NOT_RUNNING',\n      `Ollama server is not reachable at ${host}. ` +\n        'Make sure `ollama serve` is running or set OLLAMA_HOST to the correct address.' +\n        (cause ? ` (${cause})` : ''),\n      { host, ...(cause ? { cause } : {}) }\n    );\n    this.name = 'OllamaNotRunningError';\n    this.host = host;\n  }\n}\nregisterErrorClass(\n  'OLLAMA_NOT_RUNNING',\n  (p) =>\n    new OllamaNotRunningError(\n      ctxString(p.context, 'host'),\n      ctxString(p.context, 'cause') || undefined\n    )\n);\n\n/**\n * Thrown when a requested model is not installed locally.\n */\nexport class OllamaModelNotFoundError extends OctoFlowError {\n  readonly model: string;\n\n  constructor(model: string) {\n    super(\n      'OLLAMA_MODEL_NOT_FOUND',\n      `Model \"${model}\" is not installed. ` +\n        `Run \\`ollama pull ${model}\\` to download it, or browse available models at https://ollama.com/library`,\n      { model }\n    );\n    this.name = 'OllamaModelNotFoundError';\n    this.model = model;\n  }\n}\nregisterErrorClass(\n  'OLLAMA_MODEL_NOT_FOUND',\n  (p) => new OllamaModelNotFoundError(ctxString(p.context, 'model'))\n);\n\n/**\n * Thrown when no models are installed on the Ollama server and auto-detection\n * was requested (model: 'auto'). The user needs to pull at least one model.\n */\nexport class OllamaNoModelsError extends OctoFlowError {\n  constructor() {\n    super(\n      'OLLAMA_NO_MODELS',\n      'No models are installed on the Ollama server. ' +\n        'Pull a model first: `ollama pull llama3.2:3b` (or any model from https://ollama.com/library)',\n      {}\n    );\n    this.name = 'OllamaNoModelsError';\n  }\n}\nregisterErrorClass('OLLAMA_NO_MODELS', () => new OllamaNoModelsError());\n\n/**\n * Thrown when the Ollama host rejects an authenticated request (401/403).\n * Typically surfaces when talking to https://ollama.com hosted instances with\n * a missing or invalid `OLLAMA_API_KEY`.\n */\nexport class OllamaAuthError extends OctoFlowError {\n  readonly host: string;\n\n  constructor(host: string, cause?: string) {\n    super(\n      'OLLAMA_AUTH',\n      `Ollama host ${host} rejected the request (authentication failed). ` +\n        'Set OLLAMA_API_KEY (or `apiKey` on the client) to a valid token for this host.' +\n        (cause ? ` (${cause})` : ''),\n      { host, ...(cause ? { cause } : {}) }\n    );\n    this.name = 'OllamaAuthError';\n    this.host = host;\n  }\n}\nregisterErrorClass(\n  'OLLAMA_AUTH',\n  (p) =>\n    new OllamaAuthError(\n      ctxString(p.context, 'host'),\n      ctxString(p.context, 'cause') || undefined\n    )\n);\n\n/**\n * Thrown when a `tool` role message is about to be sent to Ollama without a\n * `tool_name`/`toolName` metadata field. Ollama pairs tool results to calls by\n * name; an empty string risks mispaired results on multi-tool turns.\n */\nexport class OllamaToolResultMissingNameError extends OctoFlowError {\n  constructor() {\n    super(\n      'OLLAMA_TOOL_RESULT_MISSING_NAME',\n      \"Cannot forward a tool-result message to Ollama without a `toolName` (originating tool's name). \" +\n        'Set `metadata.toolName` on the `tool_result` part, or pass `strictToolNames: false` to fall back to the legacy empty-string behavior.',\n      {}\n    );\n    this.name = 'OllamaToolResultMissingNameError';\n  }\n}\nregisterErrorClass(\n  'OLLAMA_TOOL_RESULT_MISSING_NAME',\n  () => new OllamaToolResultMissingNameError()\n);\n\n/**\n * Thrown when {@link OllamaClient.webSearch} or {@link OllamaClient.webFetch}\n * are invoked without a valid API key. Ollama's hosted web tools require\n * `OLLAMA_API_KEY` \u2014 there is no local fallback.\n */\nexport class OllamaWebToolsAuthError extends OctoFlowError {\n  constructor(cause?: string) {\n    super(\n      'OLLAMA_WEB_TOOLS_AUTH',\n      'Ollama web tools (webSearch / webFetch) require an API key. ' +\n        'Set OLLAMA_API_KEY or pass `apiKey` to the client.' +\n        (cause ? ` (${cause})` : ''),\n      cause ? { cause } : {}\n    );\n    this.name = 'OllamaWebToolsAuthError';\n  }\n}\nregisterErrorClass(\n  'OLLAMA_WEB_TOOLS_AUTH',\n  (p) => new OllamaWebToolsAuthError(ctxString(p.context, 'cause') || undefined)\n);\n"],
+  "mappings": "AAAA,SAAS,WAAW,eAAe,0BAA0B;AAMtD,MAAM,8BAA8B,cAAc;AAAA,EAC9C;AAAA,EAET,YAAY,MAAc,OAAgB;AACxC;AAAA,MACE;AAAA,MACA,qCAAqC,IAAI,wFAEtC,QAAQ,KAAK,KAAK,MAAM;AAAA,MAC3B,EAAE,MAAM,GAAI,QAAQ,EAAE,MAAM,IAAI,CAAC,EAAG;AAAA,IACtC;AACA,SAAK,OAAO;AACZ,SAAK,OAAO;AAAA,EACd;AACF;AACA;AAAA,EACE;AAAA,EACA,CAAC,MACC,IAAI;AAAA,IACF,UAAU,EAAE,SAAS,MAAM;AAAA,IAC3B,UAAU,EAAE,SAAS,OAAO,KAAK;AAAA,EACnC;AACJ;AAKO,MAAM,iCAAiC,cAAc;AAAA,EACjD;AAAA,EAET,YAAY,OAAe;AACzB;AAAA,MACE;AAAA,MACA,UAAU,KAAK,yCACQ,KAAK;AAAA,MAC5B,EAAE,MAAM;AAAA,IACV;AACA,SAAK,OAAO;AACZ,SAAK,QAAQ;AAAA,EACf;AACF;AACA;AAAA,EACE;AAAA,EACA,CAAC,MAAM,IAAI,yBAAyB,UAAU,EAAE,SAAS,OAAO,CAAC;AACnE;AAMO,MAAM,4BAA4B,cAAc;AAAA,EACrD,cAAc;AACZ;AAAA,MACE;AAAA,MACA;AAAA,MAEA,CAAC;AAAA,IACH;AACA,SAAK,OAAO;AAAA,EACd;AACF;AACA,mBAAmB,oBAAoB,MAAM,IAAI,oBAAoB,CAAC;AAO/D,MAAM,wBAAwB,cAAc;AAAA,EACxC;AAAA,EAET,YAAY,MAAc,OAAgB;AACxC;AAAA,MACE;AAAA,MACA,eAAe,IAAI,qIAEhB,QAAQ,KAAK,KAAK,MAAM;AAAA,MAC3B,EAAE,MAAM,GAAI,QAAQ,EAAE,MAAM,IAAI,CAAC,EAAG;AAAA,IACtC;AACA,SAAK,OAAO;AACZ,SAAK,OAAO;AAAA,EACd;AACF;AACA;AAAA,EACE;AAAA,EACA,CAAC,MACC,IAAI;AAAA,IACF,UAAU,EAAE,SAAS,MAAM;AAAA,IAC3B,UAAU,EAAE,SAAS,OAAO,KAAK;AAAA,EACnC;AACJ;AAOO,MAAM,yCAAyC,cAAc;AAAA,EAClE,cAAc;AACZ;AAAA,MACE;AAAA,MACA;AAAA,MAEA,CAAC;AAAA,IACH;AACA,SAAK,OAAO;AAAA,EACd;AACF;AACA;AAAA,EACE;AAAA,EACA,MAAM,IAAI,iCAAiC;AAC7C;AAOO,MAAM,gCAAgC,cAAc;AAAA,EACzD,YAAY,OAAgB;AAC1B;AAAA,MACE;AAAA,MACA,oHAEG,QAAQ,KAAK,KAAK,MAAM;AAAA,MAC3B,QAAQ,EAAE,MAAM,IAAI,CAAC;AAAA,IACvB;AACA,SAAK,OAAO;AAAA,EACd;AACF;AACA;AAAA,EACE;AAAA,EACA,CAAC,MAAM,IAAI,wBAAwB,UAAU,EAAE,SAAS,OAAO,KAAK,MAAS;AAC/E;",
+  "names": []
+}

package/dist/domain/errors/policy.d.ts

@@ -0,0 +1,8 @@
+import { OctoFlowError } from './base.js';
+/** Thrown when RBAC or tenant policy denies an operation. */
+export declare class PolicyDeniedError extends OctoFlowError {
+    readonly action: string;
+    readonly resourceKind: string;
+    constructor(action: string, resourceKind: string, reason?: string, context?: Record<string, unknown>);
+}
+//# sourceMappingURL=policy.d.ts.map

package/dist/domain/errors/policy.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"policy.d.ts","sourceRoot":"","sources":["../../../src/domain/errors/policy.ts"],"names":[],"mappings":"AAAA,OAAO,EAAa,aAAa,EAAsB,MAAM,WAAW,CAAC;AAEzE,6DAA6D;AAC7D,qBAAa,iBAAkB,SAAQ,aAAa;IAClD,QAAQ,CAAC,MAAM,EAAE,MAAM,CAAC;IACxB,QAAQ,CAAC,YAAY,EAAE,MAAM,CAAC;gBAG5B,MAAM,EAAE,MAAM,EACd,YAAY,EAAE,MAAM,EACpB,MAAM,SAAgC,EACtC,OAAO,GAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAM;CAYxC"}

package/dist/domain/errors/policy.js

@@ -0,0 +1,28 @@
+import { ctxString, OctoFlowError, registerErrorClass } from "./base.js";
+class PolicyDeniedError extends OctoFlowError {
+  action;
+  resourceKind;
+  constructor(action, resourceKind, reason = "Policy denied the operation", context = {}) {
+    super(
+      "POLICY_DENIED",
+      `Policy denied ${action} on ${resourceKind}` + (reason ? `: ${reason}` : ""),
+      { action, resourceKind, reason, ...context }
+    );
+    this.name = "PolicyDeniedError";
+    this.action = action;
+    this.resourceKind = resourceKind;
+  }
+}
+registerErrorClass(
+  "POLICY_DENIED",
+  (p) => new PolicyDeniedError(
+    ctxString(p.context, "action"),
+    ctxString(p.context, "resourceKind"),
+    ctxString(p.context, "reason") || void 0,
+    p.context ? { ...p.context } : {}
+  )
+);
+export {
+  PolicyDeniedError
+};
+//# sourceMappingURL=policy.js.map

package/dist/domain/errors/policy.js.map

@@ -0,0 +1,7 @@
+{
+  "version": 3,
+  "sources": ["../../../src/domain/errors/policy.ts"],
+  "sourcesContent": ["import { ctxString, OctoFlowError, registerErrorClass } from './base.js';\n\n/** Thrown when RBAC or tenant policy denies an operation. */\nexport class PolicyDeniedError extends OctoFlowError {\n  readonly action: string;\n  readonly resourceKind: string;\n\n  constructor(\n    action: string,\n    resourceKind: string,\n    reason = 'Policy denied the operation',\n    context: Record<string, unknown> = {}\n  ) {\n    super(\n      'POLICY_DENIED',\n      `Policy denied ${action} on ${resourceKind}` +\n        (reason ? `: ${reason}` : ''),\n      { action, resourceKind, reason, ...context }\n    );\n    this.name = 'PolicyDeniedError';\n    this.action = action;\n    this.resourceKind = resourceKind;\n  }\n}\nregisterErrorClass(\n  'POLICY_DENIED',\n  (p) =>\n    new PolicyDeniedError(\n      ctxString(p.context, 'action'),\n      ctxString(p.context, 'resourceKind'),\n      ctxString(p.context, 'reason') || undefined,\n      p.context ? { ...p.context } : {}\n    )\n);\n"],
+  "mappings": "AAAA,SAAS,WAAW,eAAe,0BAA0B;AAGtD,MAAM,0BAA0B,cAAc;AAAA,EAC1C;AAAA,EACA;AAAA,EAET,YACE,QACA,cACA,SAAS,+BACT,UAAmC,CAAC,GACpC;AACA;AAAA,MACE;AAAA,MACA,iBAAiB,MAAM,OAAO,YAAY,MACvC,SAAS,KAAK,MAAM,KAAK;AAAA,MAC5B,EAAE,QAAQ,cAAc,QAAQ,GAAG,QAAQ;AAAA,IAC7C;AACA,SAAK,OAAO;AACZ,SAAK,SAAS;AACd,SAAK,eAAe;AAAA,EACtB;AACF;AACA;AAAA,EACE;AAAA,EACA,CAAC,MACC,IAAI;AAAA,IACF,UAAU,EAAE,SAAS,QAAQ;AAAA,IAC7B,UAAU,EAAE,SAAS,cAAc;AAAA,IACnC,UAAU,EAAE,SAAS,QAAQ,KAAK;AAAA,IAClC,EAAE,UAAU,EAAE,GAAG,EAAE,QAAQ,IAAI,CAAC;AAAA,EAClC;AACJ;",
+  "names": []
+}

package/dist/domain/errors/subagent.d.ts

@@ -0,0 +1,31 @@
+import { OctoFlowError } from './base.js';
+/**
+ * Thrown when the LLM calls the `task` subagent tool with a `subagent_role`
+ * that is not present in the configured {@link AgentRegistry}, or is blocked
+ * by the action's `allowedRoles` whitelist.
+ */
+export declare class SubagentRoleNotFoundError extends OctoFlowError {
+    readonly requestedRole: string;
+    readonly availableRoles: readonly string[];
+    constructor(requestedRole: string, availableRoles: readonly string[]);
+}
+/**
+ * Thrown by `createSubagentAction` when a call would spawn a child beyond the
+ * configured `maxDepth`. Prevents runaway recursion and cost blow-up.
+ */
+export declare class SubagentDepthExceededError extends OctoFlowError {
+    readonly attemptedDepth: number;
+    readonly maxDepth: number;
+    constructor(attemptedDepth: number, maxDepth: number);
+}
+/**
+ * Thrown by `createSubagentAction` when the number of in-flight subagent
+ * invocations on this action instance has reached `maxConcurrent`. The caller
+ * (typically the LLM tool loop) should retry or sequence the request.
+ */
+export declare class SubagentConcurrencyLimitError extends OctoFlowError {
+    readonly inFlight: number;
+    readonly maxConcurrent: number;
+    constructor(inFlight: number, maxConcurrent: number);
+}
+//# sourceMappingURL=subagent.d.ts.map

package/dist/domain/errors/subagent.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"subagent.d.ts","sourceRoot":"","sources":["../../../src/domain/errors/subagent.ts"],"names":[],"mappings":"AAAA,OAAO,EAGL,aAAa,EAEd,MAAM,WAAW,CAAC;AAEnB;;;;GAIG;AACH,qBAAa,yBAA0B,SAAQ,aAAa;IAC1D,QAAQ,CAAC,aAAa,EAAE,MAAM,CAAC;IAC/B,QAAQ,CAAC,cAAc,EAAE,SAAS,MAAM,EAAE,CAAC;gBAE/B,aAAa,EAAE,MAAM,EAAE,cAAc,EAAE,SAAS,MAAM,EAAE;CAUrE;AAYD;;;GAGG;AACH,qBAAa,0BAA2B,SAAQ,aAAa;IAC3D,QAAQ,CAAC,cAAc,EAAE,MAAM,CAAC;IAChC,QAAQ,CAAC,QAAQ,EAAE,MAAM,CAAC;gBAEd,cAAc,EAAE,MAAM,EAAE,QAAQ,EAAE,MAAM;CAUrD;AAUD;;;;GAIG;AACH,qBAAa,6BAA8B,SAAQ,aAAa;IAC9D,QAAQ,CAAC,QAAQ,EAAE,MAAM,CAAC;IAC1B,QAAQ,CAAC,aAAa,EAAE,MAAM,CAAC;gBAEnB,QAAQ,EAAE,MAAM,EAAE,aAAa,EAAE,MAAM;CAUpD"}

package/dist/domain/errors/subagent.js

@@ -0,0 +1,76 @@
+import {
+  ctxNumber,
+  ctxString,
+  OctoFlowError,
+  registerErrorClass
+} from "./base.js";
+class SubagentRoleNotFoundError extends OctoFlowError {
+  requestedRole;
+  availableRoles;
+  constructor(requestedRole, availableRoles) {
+    super(
+      "SUBAGENT_ROLE_NOT_FOUND",
+      `Unknown subagent_role "${requestedRole}". Available: ${availableRoles.join(", ") || "(none)"}.`,
+      { requestedRole, availableRoles: [...availableRoles] }
+    );
+    this.name = "SubagentRoleNotFoundError";
+    this.requestedRole = requestedRole;
+    this.availableRoles = availableRoles;
+  }
+}
+registerErrorClass("SUBAGENT_ROLE_NOT_FOUND", (p) => {
+  const raw = p.context?.["availableRoles"];
+  const list = Array.isArray(raw) ? raw.filter((v) => typeof v === "string") : [];
+  return new SubagentRoleNotFoundError(
+    ctxString(p.context, "requestedRole"),
+    list
+  );
+});
+class SubagentDepthExceededError extends OctoFlowError {
+  attemptedDepth;
+  maxDepth;
+  constructor(attemptedDepth, maxDepth) {
+    super(
+      "SUBAGENT_DEPTH_EXCEEDED",
+      `Subagent spawn rejected: attempted depth ${attemptedDepth} exceeds maxDepth ${maxDepth}.`,
+      { attemptedDepth, maxDepth }
+    );
+    this.name = "SubagentDepthExceededError";
+    this.attemptedDepth = attemptedDepth;
+    this.maxDepth = maxDepth;
+  }
+}
+registerErrorClass(
+  "SUBAGENT_DEPTH_EXCEEDED",
+  (p) => new SubagentDepthExceededError(
+    ctxNumber(p.context, "attemptedDepth"),
+    ctxNumber(p.context, "maxDepth")
+  )
+);
+class SubagentConcurrencyLimitError extends OctoFlowError {
+  inFlight;
+  maxConcurrent;
+  constructor(inFlight, maxConcurrent) {
+    super(
+      "SUBAGENT_CONCURRENCY_LIMIT",
+      `Subagent concurrency limit reached: ${inFlight} in-flight, max ${maxConcurrent}.`,
+      { inFlight, maxConcurrent }
+    );
+    this.name = "SubagentConcurrencyLimitError";
+    this.inFlight = inFlight;
+    this.maxConcurrent = maxConcurrent;
+  }
+}
+registerErrorClass(
+  "SUBAGENT_CONCURRENCY_LIMIT",
+  (p) => new SubagentConcurrencyLimitError(
+    ctxNumber(p.context, "inFlight"),
+    ctxNumber(p.context, "maxConcurrent")
+  )
+);
+export {
+  SubagentConcurrencyLimitError,
+  SubagentDepthExceededError,
+  SubagentRoleNotFoundError
+};
+//# sourceMappingURL=subagent.js.map

package/dist/domain/errors/subagent.js.map

@@ -0,0 +1,7 @@
+{
+  "version": 3,
+  "sources": ["../../../src/domain/errors/subagent.ts"],
+  "sourcesContent": ["import {\n  ctxNumber,\n  ctxString,\n  OctoFlowError,\n  registerErrorClass,\n} from './base.js';\n\n/**\n * Thrown when the LLM calls the `task` subagent tool with a `subagent_role`\n * that is not present in the configured {@link AgentRegistry}, or is blocked\n * by the action's `allowedRoles` whitelist.\n */\nexport class SubagentRoleNotFoundError extends OctoFlowError {\n  readonly requestedRole: string;\n  readonly availableRoles: readonly string[];\n\n  constructor(requestedRole: string, availableRoles: readonly string[]) {\n    super(\n      'SUBAGENT_ROLE_NOT_FOUND',\n      `Unknown subagent_role \"${requestedRole}\". Available: ${availableRoles.join(', ') || '(none)'}.`,\n      { requestedRole, availableRoles: [...availableRoles] }\n    );\n    this.name = 'SubagentRoleNotFoundError';\n    this.requestedRole = requestedRole;\n    this.availableRoles = availableRoles;\n  }\n}\nregisterErrorClass('SUBAGENT_ROLE_NOT_FOUND', (p) => {\n  const raw = p.context?.['availableRoles'];\n  const list = Array.isArray(raw)\n    ? raw.filter((v): v is string => typeof v === 'string')\n    : [];\n  return new SubagentRoleNotFoundError(\n    ctxString(p.context, 'requestedRole'),\n    list\n  );\n});\n\n/**\n * Thrown by `createSubagentAction` when a call would spawn a child beyond the\n * configured `maxDepth`. Prevents runaway recursion and cost blow-up.\n */\nexport class SubagentDepthExceededError extends OctoFlowError {\n  readonly attemptedDepth: number;\n  readonly maxDepth: number;\n\n  constructor(attemptedDepth: number, maxDepth: number) {\n    super(\n      'SUBAGENT_DEPTH_EXCEEDED',\n      `Subagent spawn rejected: attempted depth ${attemptedDepth} exceeds maxDepth ${maxDepth}.`,\n      { attemptedDepth, maxDepth }\n    );\n    this.name = 'SubagentDepthExceededError';\n    this.attemptedDepth = attemptedDepth;\n    this.maxDepth = maxDepth;\n  }\n}\nregisterErrorClass(\n  'SUBAGENT_DEPTH_EXCEEDED',\n  (p) =>\n    new SubagentDepthExceededError(\n      ctxNumber(p.context, 'attemptedDepth'),\n      ctxNumber(p.context, 'maxDepth')\n    )\n);\n\n/**\n * Thrown by `createSubagentAction` when the number of in-flight subagent\n * invocations on this action instance has reached `maxConcurrent`. The caller\n * (typically the LLM tool loop) should retry or sequence the request.\n */\nexport class SubagentConcurrencyLimitError extends OctoFlowError {\n  readonly inFlight: number;\n  readonly maxConcurrent: number;\n\n  constructor(inFlight: number, maxConcurrent: number) {\n    super(\n      'SUBAGENT_CONCURRENCY_LIMIT',\n      `Subagent concurrency limit reached: ${inFlight} in-flight, max ${maxConcurrent}.`,\n      { inFlight, maxConcurrent }\n    );\n    this.name = 'SubagentConcurrencyLimitError';\n    this.inFlight = inFlight;\n    this.maxConcurrent = maxConcurrent;\n  }\n}\nregisterErrorClass(\n  'SUBAGENT_CONCURRENCY_LIMIT',\n  (p) =>\n    new SubagentConcurrencyLimitError(\n      ctxNumber(p.context, 'inFlight'),\n      ctxNumber(p.context, 'maxConcurrent')\n    )\n);\n"],
+  "mappings": "AAAA;AAAA,EACE;AAAA,EACA;AAAA,EACA;AAAA,EACA;AAAA,OACK;AAOA,MAAM,kCAAkC,cAAc;AAAA,EAClD;AAAA,EACA;AAAA,EAET,YAAY,eAAuB,gBAAmC;AACpE;AAAA,MACE;AAAA,MACA,0BAA0B,aAAa,iBAAiB,eAAe,KAAK,IAAI,KAAK,QAAQ;AAAA,MAC7F,EAAE,eAAe,gBAAgB,CAAC,GAAG,cAAc,EAAE;AAAA,IACvD;AACA,SAAK,OAAO;AACZ,SAAK,gBAAgB;AACrB,SAAK,iBAAiB;AAAA,EACxB;AACF;AACA,mBAAmB,2BAA2B,CAAC,MAAM;AACnD,QAAM,MAAM,EAAE,UAAU,gBAAgB;AACxC,QAAM,OAAO,MAAM,QAAQ,GAAG,IAC1B,IAAI,OAAO,CAAC,MAAmB,OAAO,MAAM,QAAQ,IACpD,CAAC;AACL,SAAO,IAAI;AAAA,IACT,UAAU,EAAE,SAAS,eAAe;AAAA,IACpC;AAAA,EACF;AACF,CAAC;AAMM,MAAM,mCAAmC,cAAc;AAAA,EACnD;AAAA,EACA;AAAA,EAET,YAAY,gBAAwB,UAAkB;AACpD;AAAA,MACE;AAAA,MACA,4CAA4C,cAAc,qBAAqB,QAAQ;AAAA,MACvF,EAAE,gBAAgB,SAAS;AAAA,IAC7B;AACA,SAAK,OAAO;AACZ,SAAK,iBAAiB;AACtB,SAAK,WAAW;AAAA,EAClB;AACF;AACA;AAAA,EACE;AAAA,EACA,CAAC,MACC,IAAI;AAAA,IACF,UAAU,EAAE,SAAS,gBAAgB;AAAA,IACrC,UAAU,EAAE,SAAS,UAAU;AAAA,EACjC;AACJ;AAOO,MAAM,sCAAsC,cAAc;AAAA,EACtD;AAAA,EACA;AAAA,EAET,YAAY,UAAkB,eAAuB;AACnD;AAAA,MACE;AAAA,MACA,uCAAuC,QAAQ,mBAAmB,aAAa;AAAA,MAC/E,EAAE,UAAU,cAAc;AAAA,IAC5B;AACA,SAAK,OAAO;AACZ,SAAK,WAAW;AAChB,SAAK,gBAAgB;AAAA,EACvB;AACF;AACA;AAAA,EACE;AAAA,EACA,CAAC,MACC,IAAI;AAAA,IACF,UAAU,EAAE,SAAS,UAAU;AAAA,IAC/B,UAAU,EAAE,SAAS,eAAe;AAAA,EACtC;AACJ;",
+  "names": []
+}

package/dist/domain/errors/task.d.ts

@@ -0,0 +1,25 @@
+import { OctoFlowError } from './base.js';
+/** Thrown when a task is not found, or does not belong to the caller's context/tenant. */
+export declare class TaskNotFoundError extends OctoFlowError {
+    constructor(taskId: string, reason?: string);
+}
+/** Thrown when an operation is attempted on a task that has already reached a terminal state. */
+export declare class TaskTerminalError extends OctoFlowError {
+    constructor(taskId: string, state: string);
+}
+/** Thrown when a context's task queue is at capacity and a new task is rejected. */
+export declare class QueueFullError extends OctoFlowError {
+    constructor(contextId: string, depth: number);
+}
+/** Thrown when a session ID is not found in the session store. */
+export declare class SessionNotFoundError extends OctoFlowError {
+    constructor(sessionId: string);
+}
+/** Thrown when a context's cost budget hard limit has been reached. */
+export declare class BudgetExhaustedError extends OctoFlowError {
+    readonly contextId: string;
+    readonly spentUsd: number;
+    readonly limitUsd: number;
+    constructor(contextId: string, spentUsd: number, limitUsd: number);
+}
+//# sourceMappingURL=task.d.ts.map

package/dist/domain/errors/task.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"task.d.ts","sourceRoot":"","sources":["../../../src/domain/errors/task.ts"],"names":[],"mappings":"AAAA,OAAO,EAGL,aAAa,EAEd,MAAM,WAAW,CAAC;AAEnB,0FAA0F;AAC1F,qBAAa,iBAAkB,SAAQ,aAAa;gBACtC,MAAM,EAAE,MAAM,EAAE,MAAM,CAAC,EAAE,MAAM;CAU5C;AAUD,iGAAiG;AACjG,qBAAa,iBAAkB,SAAQ,aAAa;gBACtC,MAAM,EAAE,MAAM,EAAE,KAAK,EAAE,MAAM;CAQ1C;AAUD,oFAAoF;AACpF,qBAAa,cAAe,SAAQ,aAAa;gBACnC,SAAS,EAAE,MAAM,EAAE,KAAK,EAAE,MAAM;CAQ7C;AAUD,kEAAkE;AAClE,qBAAa,oBAAqB,SAAQ,aAAa;gBACzC,SAAS,EAAE,MAAM;CAM9B;AAMD,uEAAuE;AACvE,qBAAa,oBAAqB,SAAQ,aAAa;IACrD,QAAQ,CAAC,SAAS,EAAE,MAAM,CAAC;IAC3B,QAAQ,CAAC,QAAQ,EAAE,MAAM,CAAC;IAC1B,QAAQ,CAAC,QAAQ,EAAE,MAAM,CAAC;gBAEd,SAAS,EAAE,MAAM,EAAE,QAAQ,EAAE,MAAM,EAAE,QAAQ,EAAE,MAAM;CAWlE"}