octoflow-core 1.0.0

package/dist/domain/errors/task.js

@@ -0,0 +1,101 @@
+import {
+  ctxNumber,
+  ctxString,
+  OctoFlowError,
+  registerErrorClass
+} from "./base.js";
+class TaskNotFoundError extends OctoFlowError {
+  constructor(taskId, reason) {
+    super(
+      "TASK_NOT_FOUND",
+      reason ? `Task not found: "${taskId}" \u2014 ${reason}` : `Task not found: "${taskId}"`,
+      { taskId, ...reason ? { reason } : {} }
+    );
+    this.name = "TaskNotFoundError";
+  }
+}
+registerErrorClass(
+  "TASK_NOT_FOUND",
+  (p) => new TaskNotFoundError(
+    ctxString(p.context, "taskId"),
+    ctxString(p.context, "reason") || void 0
+  )
+);
+class TaskTerminalError extends OctoFlowError {
+  constructor(taskId, state) {
+    super(
+      "TASK_TERMINAL",
+      `Task "${taskId}" is already terminal (state: ${state}).`,
+      { taskId, state }
+    );
+    this.name = "TaskTerminalError";
+  }
+}
+registerErrorClass(
+  "TASK_TERMINAL",
+  (p) => new TaskTerminalError(
+    ctxString(p.context, "taskId"),
+    ctxString(p.context, "state")
+  )
+);
+class QueueFullError extends OctoFlowError {
+  constructor(contextId, depth) {
+    super(
+      "QUEUE_FULL",
+      `Context "${contextId}" queue is full (depth: ${depth}). Apply backpressure.`,
+      { contextId, depth }
+    );
+    this.name = "QueueFullError";
+  }
+}
+registerErrorClass(
+  "QUEUE_FULL",
+  (p) => new QueueFullError(
+    ctxString(p.context, "contextId"),
+    ctxNumber(p.context, "depth")
+  )
+);
+class SessionNotFoundError extends OctoFlowError {
+  constructor(sessionId) {
+    super("SESSION_NOT_FOUND", `Session not found: "${sessionId}"`, {
+      sessionId
+    });
+    this.name = "SessionNotFoundError";
+  }
+}
+registerErrorClass(
+  "SESSION_NOT_FOUND",
+  (p) => new SessionNotFoundError(ctxString(p.context, "sessionId"))
+);
+class BudgetExhaustedError extends OctoFlowError {
+  contextId;
+  spentUsd;
+  limitUsd;
+  constructor(contextId, spentUsd, limitUsd) {
+    super(
+      "BUDGET_EXHAUSTED",
+      `Context "${contextId}" budget exhausted: $${spentUsd.toFixed(4)} spent of $${limitUsd.toFixed(4)} limit.`,
+      { contextId, spentUsd, limitUsd }
+    );
+    this.name = "BudgetExhaustedError";
+    this.contextId = contextId;
+    this.spentUsd = spentUsd;
+    this.limitUsd = limitUsd;
+  }
+}
+registerErrorClass(
+  "BUDGET_EXHAUSTED",
+  (p) => new BudgetExhaustedError(
+    ctxString(p.context, "contextId"),
+    ctxNumber(p.context, "spentUsd"),
+    ctxNumber(p.context, "limitUsd")
+  )
+);
+export {
+  BudgetExhaustedError,
+  QueueFullError,
+  SessionNotFoundError,
+  TaskNotFoundError,
+  TaskTerminalError
+};
+//# sourceMappingURL=task.js.map

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

@@ -0,0 +1,7 @@
+{
+  "version": 3,
+  "sources": ["../../../src/domain/errors/task.ts"],
+  "sourcesContent": ["import {\n  ctxNumber,\n  ctxString,\n  OctoFlowError,\n  registerErrorClass,\n} from './base.js';\n\n/** Thrown when a task is not found, or does not belong to the caller's context/tenant. */\nexport class TaskNotFoundError extends OctoFlowError {\n  constructor(taskId: string, reason?: string) {\n    super(\n      'TASK_NOT_FOUND',\n      reason\n        ? `Task not found: \"${taskId}\" \u2014 ${reason}`\n        : `Task not found: \"${taskId}\"`,\n      { taskId, ...(reason ? { reason } : {}) }\n    );\n    this.name = 'TaskNotFoundError';\n  }\n}\nregisterErrorClass(\n  'TASK_NOT_FOUND',\n  (p) =>\n    new TaskNotFoundError(\n      ctxString(p.context, 'taskId'),\n      ctxString(p.context, 'reason') || undefined\n    )\n);\n\n/** Thrown when an operation is attempted on a task that has already reached a terminal state. */\nexport class TaskTerminalError extends OctoFlowError {\n  constructor(taskId: string, state: string) {\n    super(\n      'TASK_TERMINAL',\n      `Task \"${taskId}\" is already terminal (state: ${state}).`,\n      { taskId, state }\n    );\n    this.name = 'TaskTerminalError';\n  }\n}\nregisterErrorClass(\n  'TASK_TERMINAL',\n  (p) =>\n    new TaskTerminalError(\n      ctxString(p.context, 'taskId'),\n      ctxString(p.context, 'state')\n    )\n);\n\n/** Thrown when a context's task queue is at capacity and a new task is rejected. */\nexport class QueueFullError extends OctoFlowError {\n  constructor(contextId: string, depth: number) {\n    super(\n      'QUEUE_FULL',\n      `Context \"${contextId}\" queue is full (depth: ${depth}). Apply backpressure.`,\n      { contextId, depth }\n    );\n    this.name = 'QueueFullError';\n  }\n}\nregisterErrorClass(\n  'QUEUE_FULL',\n  (p) =>\n    new QueueFullError(\n      ctxString(p.context, 'contextId'),\n      ctxNumber(p.context, 'depth')\n    )\n);\n\n/** Thrown when a session ID is not found in the session store. */\nexport class SessionNotFoundError extends OctoFlowError {\n  constructor(sessionId: string) {\n    super('SESSION_NOT_FOUND', `Session not found: \"${sessionId}\"`, {\n      sessionId,\n    });\n    this.name = 'SessionNotFoundError';\n  }\n}\nregisterErrorClass(\n  'SESSION_NOT_FOUND',\n  (p) => new SessionNotFoundError(ctxString(p.context, 'sessionId'))\n);\n\n/** Thrown when a context's cost budget hard limit has been reached. */\nexport class BudgetExhaustedError extends OctoFlowError {\n  readonly contextId: string;\n  readonly spentUsd: number;\n  readonly limitUsd: number;\n\n  constructor(contextId: string, spentUsd: number, limitUsd: number) {\n    super(\n      'BUDGET_EXHAUSTED',\n      `Context \"${contextId}\" budget exhausted: $${spentUsd.toFixed(4)} spent of $${limitUsd.toFixed(4)} limit.`,\n      { contextId, spentUsd, limitUsd }\n    );\n    this.name = 'BudgetExhaustedError';\n    this.contextId = contextId;\n    this.spentUsd = spentUsd;\n    this.limitUsd = limitUsd;\n  }\n}\nregisterErrorClass(\n  'BUDGET_EXHAUSTED',\n  (p) =>\n    new BudgetExhaustedError(\n      ctxString(p.context, 'contextId'),\n      ctxNumber(p.context, 'spentUsd'),\n      ctxNumber(p.context, 'limitUsd')\n    )\n);\n"],
+  "mappings": "AAAA;AAAA,EACE;AAAA,EACA;AAAA,EACA;AAAA,EACA;AAAA,OACK;AAGA,MAAM,0BAA0B,cAAc;AAAA,EACnD,YAAY,QAAgB,QAAiB;AAC3C;AAAA,MACE;AAAA,MACA,SACI,oBAAoB,MAAM,YAAO,MAAM,KACvC,oBAAoB,MAAM;AAAA,MAC9B,EAAE,QAAQ,GAAI,SAAS,EAAE,OAAO,IAAI,CAAC,EAAG;AAAA,IAC1C;AACA,SAAK,OAAO;AAAA,EACd;AACF;AACA;AAAA,EACE;AAAA,EACA,CAAC,MACC,IAAI;AAAA,IACF,UAAU,EAAE,SAAS,QAAQ;AAAA,IAC7B,UAAU,EAAE,SAAS,QAAQ,KAAK;AAAA,EACpC;AACJ;AAGO,MAAM,0BAA0B,cAAc;AAAA,EACnD,YAAY,QAAgB,OAAe;AACzC;AAAA,MACE;AAAA,MACA,SAAS,MAAM,iCAAiC,KAAK;AAAA,MACrD,EAAE,QAAQ,MAAM;AAAA,IAClB;AACA,SAAK,OAAO;AAAA,EACd;AACF;AACA;AAAA,EACE;AAAA,EACA,CAAC,MACC,IAAI;AAAA,IACF,UAAU,EAAE,SAAS,QAAQ;AAAA,IAC7B,UAAU,EAAE,SAAS,OAAO;AAAA,EAC9B;AACJ;AAGO,MAAM,uBAAuB,cAAc;AAAA,EAChD,YAAY,WAAmB,OAAe;AAC5C;AAAA,MACE;AAAA,MACA,YAAY,SAAS,2BAA2B,KAAK;AAAA,MACrD,EAAE,WAAW,MAAM;AAAA,IACrB;AACA,SAAK,OAAO;AAAA,EACd;AACF;AACA;AAAA,EACE;AAAA,EACA,CAAC,MACC,IAAI;AAAA,IACF,UAAU,EAAE,SAAS,WAAW;AAAA,IAChC,UAAU,EAAE,SAAS,OAAO;AAAA,EAC9B;AACJ;AAGO,MAAM,6BAA6B,cAAc;AAAA,EACtD,YAAY,WAAmB;AAC7B,UAAM,qBAAqB,uBAAuB,SAAS,KAAK;AAAA,MAC9D;AAAA,IACF,CAAC;AACD,SAAK,OAAO;AAAA,EACd;AACF;AACA;AAAA,EACE;AAAA,EACA,CAAC,MAAM,IAAI,qBAAqB,UAAU,EAAE,SAAS,WAAW,CAAC;AACnE;AAGO,MAAM,6BAA6B,cAAc;AAAA,EAC7C;AAAA,EACA;AAAA,EACA;AAAA,EAET,YAAY,WAAmB,UAAkB,UAAkB;AACjE;AAAA,MACE;AAAA,MACA,YAAY,SAAS,wBAAwB,SAAS,QAAQ,CAAC,CAAC,cAAc,SAAS,QAAQ,CAAC,CAAC;AAAA,MACjG,EAAE,WAAW,UAAU,SAAS;AAAA,IAClC;AACA,SAAK,OAAO;AACZ,SAAK,YAAY;AACjB,SAAK,WAAW;AAChB,SAAK,WAAW;AAAA,EAClB;AACF;AACA;AAAA,EACE;AAAA,EACA,CAAC,MACC,IAAI;AAAA,IACF,UAAU,EAAE,SAAS,WAAW;AAAA,IAChC,UAAU,EAAE,SAAS,UAAU;AAAA,IAC/B,UAAU,EAAE,SAAS,UAAU;AAAA,EACjC;AACJ;",
+  "names": []
+}

package/dist/domain/harness-shared.d.ts

@@ -0,0 +1,59 @@
+import type { ResolvedOctoFlowProfile } from './config-contracts.js';
+export interface ExtractedToolCall {
+    id: string;
+    name: string;
+    args: Record<string, unknown>;
+}
+export interface McpServerConfig {
+    command?: string;
+    args?: string[];
+    env?: Record<string, string>;
+    url?: string;
+    transport?: 'stdio' | 'http' | 'sse';
+}
+export interface McpLoadOptions {
+    prefixToolNameWithServerName?: boolean;
+    throwOnLoadError?: boolean;
+    onConnectionError?: 'throw' | 'ignore';
+    /** Connection timeout in ms for MCP servers. */
+    timeoutMs?: number;
+    /**
+     * Controls how child process env is built.
+     * - 'allowlist' (default): inherits only safe system vars + per-server config.env
+     * - 'profile': uses resolveChildEnv() with the given profile (full parity with CLI)
+     * - 'inherit': passes full process.env (opt-in escape hatch)
+     */
+    envMode?: 'allowlist' | 'profile' | 'inherit';
+    /** Required when envMode is 'profile'. Provides the resolved security profile for resolveChildEnv() filtering. */
+    profile?: ResolvedOctoFlowProfile;
+    /** Workspace path, required when envMode is 'profile'. */
+    workspace?: string;
+}
+export type TokenEstimator = (text: string) => number;
+export interface MessageLike {
+    _getType(): string;
+    content: string | Array<{
+        type: string;
+        text?: string;
+        [key: string]: unknown;
+    }>;
+    additional_kwargs?: Record<string, unknown>;
+    tool_calls?: ExtractedToolCall[];
+    [key: string]: unknown;
+}
+export interface AIMessageLike {
+    _getType(): string;
+    content: string;
+    tool_calls?: ExtractedToolCall[];
+    additional_kwargs?: Record<string, unknown>;
+    response_metadata?: Record<string, unknown>;
+}
+export interface ToolSchemaDef {
+    name: string;
+    description?: string;
+    schema?: Record<string, unknown>;
+}
+export interface ToolLike extends ToolSchemaDef {
+    invoke(input: Record<string, unknown>): Promise<unknown>;
+}
+//# sourceMappingURL=harness-shared.d.ts.map

package/dist/domain/harness-shared.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"harness-shared.d.ts","sourceRoot":"","sources":["../../src/domain/harness-shared.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,uBAAuB,EAAE,MAAM,uBAAuB,CAAC;AAErE,MAAM,WAAW,iBAAiB;IAChC,EAAE,EAAE,MAAM,CAAC;IACX,IAAI,EAAE,MAAM,CAAC;IACb,IAAI,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;CAC/B;AAED,MAAM,WAAW,eAAe;IAC9B,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,IAAI,CAAC,EAAE,MAAM,EAAE,CAAC;IAChB,GAAG,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;IAC7B,GAAG,CAAC,EAAE,MAAM,CAAC;IACb,SAAS,CAAC,EAAE,OAAO,GAAG,MAAM,GAAG,KAAK,CAAC;CACtC;AAED,MAAM,WAAW,cAAc;IAC7B,4BAA4B,CAAC,EAAE,OAAO,CAAC;IACvC,gBAAgB,CAAC,EAAE,OAAO,CAAC;IAC3B,iBAAiB,CAAC,EAAE,OAAO,GAAG,QAAQ,CAAC;IACvC,gDAAgD;IAChD,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB;;;;;OAKG;IACH,OAAO,CAAC,EAAE,WAAW,GAAG,SAAS,GAAG,SAAS,CAAC;IAC9C,kHAAkH;IAClH,OAAO,CAAC,EAAE,uBAAuB,CAAC;IAClC,0DAA0D;IAC1D,SAAS,CAAC,EAAE,MAAM,CAAC;CACpB;AAED,MAAM,MAAM,cAAc,GAAG,CAAC,IAAI,EAAE,MAAM,KAAK,MAAM,CAAC;AAEtD,MAAM,WAAW,WAAW;IAC1B,QAAQ,IAAI,MAAM,CAAC;IACnB,OAAO,EACH,MAAM,GACN,KAAK,CAAC;QAAE,IAAI,EAAE,MAAM,CAAC;QAAC,IAAI,CAAC,EAAE,MAAM,CAAC;QAAC,CAAC,GAAG,EAAE,MAAM,GAAG,OAAO,CAAA;KAAE,CAAC,CAAC;IACnE,iBAAiB,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;IAC5C,UAAU,CAAC,EAAE,iBAAiB,EAAE,CAAC;IACjC,CAAC,GAAG,EAAE,MAAM,GAAG,OAAO,CAAC;CACxB;AAED,MAAM,WAAW,aAAa;IAC5B,QAAQ,IAAI,MAAM,CAAC;IACnB,OAAO,EAAE,MAAM,CAAC;IAChB,UAAU,CAAC,EAAE,iBAAiB,EAAE,CAAC;IACjC,iBAAiB,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;IAC5C,iBAAiB,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;CAC7C;AAED,MAAM,WAAW,aAAa;IAC5B,IAAI,EAAE,MAAM,CAAC;IACb,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,MAAM,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;CAClC;AAED,MAAM,WAAW,QAAS,SAAQ,aAAa;IAC7C,MAAM,CAAC,KAAK,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,GAAG,OAAO,CAAC,OAAO,CAAC,CAAC;CAC1D"}

package/dist/domain/harness-shared.js

@@ -0,0 +1 @@
+//# sourceMappingURL=harness-shared.js.map

package/dist/domain/harness-shared.js.map

@@ -0,0 +1,7 @@
+{
+  "version": 3,
+  "sources": [],
+  "sourcesContent": [],
+  "mappings": "",
+  "names": []
+}

package/dist/domain/index.cjs

@@ -0,0 +1,19 @@
+"use strict";
+var __defProp = Object.defineProperty;
+var __getOwnPropDesc = Object.getOwnPropertyDescriptor;
+var __getOwnPropNames = Object.getOwnPropertyNames;
+var __hasOwnProp = Object.prototype.hasOwnProperty;
+var __copyProps = (to, from, except, desc) => {
+  if (from && typeof from === "object" || typeof from === "function") {
+    for (let key of __getOwnPropNames(from))
+      if (!__hasOwnProp.call(to, key) && key !== except)
+        __defProp(to, key, { get: () => from[key], enumerable: !(desc = __getOwnPropDesc(from, key)) || desc.enumerable });
+  }
+  return to;
+};
+var __toCommonJS = (mod) => __copyProps(__defProp({}, "__esModule", { value: true }), mod);
+
+// src/domain/index.ts
+var domain_exports = {};
+module.exports = __toCommonJS(domain_exports);
+//# sourceMappingURL=index.cjs.map

package/dist/domain/index.cjs.map

@@ -0,0 +1,7 @@
+{
+  "version": 3,
+  "sources": ["../../src/domain/index.ts"],
+  "sourcesContent": ["export type { AgentEvent, StreamCallback } from './agent-event.js';\nexport type {\n  AssistantUserTurn,\n  ConversationTurn,\n  OllamaToolTurn,\n} from './conversation.js';\n// Public `octoflow-core/domain` barrel \u2014 types only, no runtime code, no side effects.\nexport type {\n  AgentDefinition,\n  AgentDefinitionSource,\n  AgentIsolationStrategy,\n  AgentLineage,\n  AgentNodeStatus,\n  AgentTreeNode,\n  RegistryMemoryScope,\n} from './agent-registry.js';\nexport type {\n  AfterSendArgs,\n  AfterSendMiddleware,\n  BackendInspection,\n  BackendSwitchInfo,\n  BackendSwitchRequest,\n  BridgeConversation,\n  BridgeConversationSnapshotOptions,\n  BridgeFallbackOptions,\n  BridgeHistoryStrategy,\n  BridgeListConversationsOptions,\n  BridgeListConversationsResult,\n  BridgeListTasksOptions,\n  BridgeListTasksResult,\n  BridgeMcpServer,\n  BridgeMiddleware,\n  BridgePreset,\n  BridgeSendMessageParams,\n  BridgeSendResult,\n  BridgeSubscriptionEvent,\n  BridgeTaskSnapshotOptions,\n  BridgeTaskSubscriptionOptions,\n  BridgeToolConfig,\n  BridgeToolDefinition,\n  GetAllSessionsOptions,\n  MiddlewareContext,\n  SessionBackendMobilityOptions,\n  SessionGcOptions,\n  SessionMessage,\n  SessionSummary,\n  ToolApprovalCallback,\n  ToolCallApprovalRequest,\n  ToolDeliveryStrategy,\n} from './bridge-api.js';\nexport type {\n  BackendOverrides,\n  OctoFlowConfig,\n  SerializedMcpOptions,\n  SerializedMcpServer,\n  SerializedMcpServerConfig,\n  SerializedSkillConfig,\n  SerializedToolConfig,\n  SerializedToolDefinition,\n} from './config-contracts.js';\nexport type {\n  AnthropicApiBackendConfig,\n  ApiBackendConfig,\n  Backend,\n  BackendCapabilities,\n  BackendExecuteOptions,\n  BackendExecutionPlan,\n  BackendRunRequest,\n  BackendToolDef,\n  EffortLevel,\n  ExecutionRuntimePolicy,\n  OpenAiApiBackendConfig,\n} from './contracts/backends.js';\nexport type {\n  AgentEventType,\n  ParsedEvent,\n  StreamParser,\n  UsageStats,\n} from './contracts/messages.js';\nexport type {\n  AgentClientOptions,\n  BackendClassification,\n  BackendType,\n  Client,\n  ClientSession,\n  ProxyOptions,\n  RunOptions,\n  RunResult,\n  SessionOptions,\n  SessionSendOptions,\n} from './core-client.js';\nexport type {\n  AgentCard,\n  AgentRole,\n  Artifact,\n  BackendName,\n  BridgeApprovalMode,\n  BridgeCacheControl,\n  BridgeCacheOptions,\n  BridgeExecutionMode,\n  BridgeMetadata,\n  CacheControl,\n  DataPart,\n  ErrorInfo,\n  FallbackInfo,\n  FilePart,\n  GoalRef,\n  Message,\n  MessageMetadata,\n  Part,\n  ProjectRef,\n  RetryInfo,\n  Task,\n  TaskArtifactUpdateEvent,\n  TaskState,\n  TaskStatus,\n  TaskStatusUpdateEvent,\n  TextPart,\n  ToolCallPart,\n  ToolCallRef,\n  ToolResultPart,\n} from './core-task.js';\nexport type {\n  CostEstimate,\n  CostSource,\n  TokenCostRates,\n  TokenCostTable,\n} from './cost-estimation.js';\nexport type {\n  OctoFlowError,\n  SerializedCause,\n  SerializedError,\n} from './errors/base.js';\nexport type {\n  AgentRunError,\n  AgentTimeoutError,\n  ApiHttpError,\n  ApiKeyError,\n  ApiStreamError,\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 './errors/domain.js';\nexport type {\n  AIMessageLike,\n  ExtractedToolCall,\n  McpLoadOptions,\n  McpServerConfig,\n  MessageLike,\n  TokenEstimator,\n  ToolLike,\n  ToolSchemaDef,\n} from './harness-shared.js';\nexport type { MemoryScope } from './memory-scope.js';\nexport type {\n  PermissionConfig,\n  PermissionDecision,\n  PermissionOptions,\n  PermissionPreset,\n} from './permission.js';\nexport type {\n  AgentProcessRunner,\n  ParsedEventCallback,\n  RunExecutionResult,\n} from './process-runner.js';\nexport type {\n  PromptCacheInputTokenMode,\n  PromptCachePrefixDiagnostics,\n  PromptCacheUsage,\n  PromptCacheUsageSource,\n  PromptCacheWriteTokensByTtl,\n} from './prompt-cache.js';\nexport type {\n  BackendCachingCapabilities,\n  BackendInfo,\n  BackendInfoCapabilities,\n  BackendInfoType,\n  BridgeProtocol,\n} from './protocol.js';\nexport type {\n  BackendHistoryEntry,\n  BackendSwitchReason,\n} from './session-history.js';\nexport type {\n  ErrorSummary,\n  SkillRef,\n  StructuredHistoryEntry,\n} from './shared.js';\n"],
+  "mappings": ";;;;;;;;;;;;;;;;AAAA;AAAA;",
+  "names": []
+}

package/dist/domain/index.d.ts

@@ -0,0 +1,21 @@
+export type { AgentEvent, StreamCallback } from './agent-event.js';
+export type { AssistantUserTurn, ConversationTurn, OllamaToolTurn, } from './conversation.js';
+export type { AgentDefinition, AgentDefinitionSource, AgentIsolationStrategy, AgentLineage, AgentNodeStatus, AgentTreeNode, RegistryMemoryScope, } from './agent-registry.js';
+export type { AfterSendArgs, AfterSendMiddleware, BackendInspection, BackendSwitchInfo, BackendSwitchRequest, BridgeConversation, BridgeConversationSnapshotOptions, BridgeFallbackOptions, BridgeHistoryStrategy, BridgeListConversationsOptions, BridgeListConversationsResult, BridgeListTasksOptions, BridgeListTasksResult, BridgeMcpServer, BridgeMiddleware, BridgePreset, BridgeSendMessageParams, BridgeSendResult, BridgeSubscriptionEvent, BridgeTaskSnapshotOptions, BridgeTaskSubscriptionOptions, BridgeToolConfig, BridgeToolDefinition, GetAllSessionsOptions, MiddlewareContext, SessionBackendMobilityOptions, SessionGcOptions, SessionMessage, SessionSummary, ToolApprovalCallback, ToolCallApprovalRequest, ToolDeliveryStrategy, } from './bridge-api.js';
+export type { BackendOverrides, OctoFlowConfig, SerializedMcpOptions, SerializedMcpServer, SerializedMcpServerConfig, SerializedSkillConfig, SerializedToolConfig, SerializedToolDefinition, } from './config-contracts.js';
+export type { AnthropicApiBackendConfig, ApiBackendConfig, Backend, BackendCapabilities, BackendExecuteOptions, BackendExecutionPlan, BackendRunRequest, BackendToolDef, EffortLevel, ExecutionRuntimePolicy, OpenAiApiBackendConfig, } from './contracts/backends.js';
+export type { AgentEventType, ParsedEvent, StreamParser, UsageStats, } from './contracts/messages.js';
+export type { AgentClientOptions, BackendClassification, BackendType, Client, ClientSession, ProxyOptions, RunOptions, RunResult, SessionOptions, SessionSendOptions, } from './core-client.js';
+export type { AgentCard, AgentRole, Artifact, BackendName, BridgeApprovalMode, BridgeCacheControl, BridgeCacheOptions, BridgeExecutionMode, BridgeMetadata, CacheControl, DataPart, ErrorInfo, FallbackInfo, FilePart, GoalRef, Message, MessageMetadata, Part, ProjectRef, RetryInfo, Task, TaskArtifactUpdateEvent, TaskState, TaskStatus, TaskStatusUpdateEvent, TextPart, ToolCallPart, ToolCallRef, ToolResultPart, } from './core-task.js';
+export type { CostEstimate, CostSource, TokenCostRates, TokenCostTable, } from './cost-estimation.js';
+export type { OctoFlowError, SerializedCause, SerializedError, } from './errors/base.js';
+export type { AgentRunError, AgentTimeoutError, ApiHttpError, ApiKeyError, ApiStreamError, ApprovalNotFoundError, ApprovalStateError, BackendNotAvailableError, BackendSwitchLimitError, BackendSwitchRejectedError, BackendSwitchUnsupportedError, BudgetExhaustedError, NoBackendAvailableError, OllamaAuthError, OllamaModelNotFoundError, OllamaNoModelsError, OllamaNotRunningError, OllamaToolResultMissingNameError, OllamaWebToolsAuthError, QueueFullError, SessionNotFoundError, SshConnectionError, SubagentConcurrencyLimitError, SubagentDepthExceededError, SubagentRoleNotFoundError, TaskNotFoundError, TaskTerminalError, UnsafeCommandError, } from './errors/domain.js';
+export type { AIMessageLike, ExtractedToolCall, McpLoadOptions, McpServerConfig, MessageLike, TokenEstimator, ToolLike, ToolSchemaDef, } from './harness-shared.js';
+export type { MemoryScope } from './memory-scope.js';
+export type { PermissionConfig, PermissionDecision, PermissionOptions, PermissionPreset, } from './permission.js';
+export type { AgentProcessRunner, ParsedEventCallback, RunExecutionResult, } from './process-runner.js';
+export type { PromptCacheInputTokenMode, PromptCachePrefixDiagnostics, PromptCacheUsage, PromptCacheUsageSource, PromptCacheWriteTokensByTtl, } from './prompt-cache.js';
+export type { BackendCachingCapabilities, BackendInfo, BackendInfoCapabilities, BackendInfoType, BridgeProtocol, } from './protocol.js';
+export type { BackendHistoryEntry, BackendSwitchReason, } from './session-history.js';
+export type { ErrorSummary, SkillRef, StructuredHistoryEntry, } from './shared.js';
+//# sourceMappingURL=index.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/domain/index.ts"],"names":[],"mappings":"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"}

package/dist/domain/index.js

@@ -0,0 +1 @@
+//# sourceMappingURL=index.js.map

package/dist/domain/index.js.map

@@ -0,0 +1,7 @@
+{
+  "version": 3,
+  "sources": [],
+  "sourcesContent": [],
+  "mappings": "",
+  "names": []
+}

package/dist/domain/llm-option.d.ts

@@ -0,0 +1,113 @@
+import type { BACKEND_RUNTIME_METADATA } from './backend-runtime.js';
+import type { BackendName } from './core-task.js';
+import type { BackendType, BridgeProtocol } from './protocol.js';
+import type { ProviderId } from './provider-profile.js';
+/**
+ * Typed LLM selector for `createAgent({ llm })`.
+ *
+ * `llm` is the canonical user-facing selector. Use:
+ * - `provider` for named hosted model providers (`groq`, `openrouter`, ...).
+ * - `backend` for a concrete OctoFlow adapter (`gemini-api`, `codex-cli`, ...).
+ * - `type` for a broad runtime family (`api`, `cli`, `local`, `sdk`).
+ * - `custom` for one-off API or CLI integrations.
+ *
+ * Protocol is inferred from provider/backend metadata. Set `protocol` only under
+ * `custom` when an endpoint or CLI wraps a known wire shape.
+ *
+ * @example
+ * createAgent({ llm: { provider: 'groq', model: 'llama-3.3-70b-versatile' } })
+ * createAgent({ llm: { backend: 'gemini-api', type: 'api', model: 'gemini-2.5-flash' } })
+ * createAgent({ llm: { type: 'api', model: 'gpt-4o' } })
+ * createAgent({ llm: [{ backend: 'anthropic-api' }, { backend: 'gemini-api' }] })
+ * createAgent({ llm: { type: 'api', custom: { url: 'https://llm.example/v1/chat/completions', protocol: 'openai-chat' }, model: 'custom-model' } })
+ */
+/** Known Anthropic model IDs (API + vercel-ai:anthropic). */
+export type AnthropicModelId = 'claude-opus-4-6' | 'claude-sonnet-4-6' | 'claude-opus-4-5' | 'claude-sonnet-4-5' | 'claude-haiku-4-5' | 'claude-sonnet-4-20250514' | 'claude-opus-4-20250514';
+/** Short aliases accepted by the Claude Code CLI (`--model`). */
+export type ClaudeCliModelId = 'opus' | 'sonnet' | 'haiku';
+/** Known OpenAI model IDs (API + vercel-ai:openai). */
+export type OpenAIModelId = 'gpt-4o' | 'gpt-4o-mini' | 'o3' | 'o4-mini';
+/** Codex CLI model IDs. */
+export type CodexModelId = 'default' | 'gpt-5-codex';
+/** Cursor Desktop CLI model IDs. */
+export type CursorModelId = 'auto' | 'opus-4.6-thinking' | 'opus-4.5' | 'sonnet-4.5' | 'sonnet-4.6' | 'gpt-5.3-codex';
+/** Known Google Gemini model IDs (Gemini API/CLI + vercel-ai:google). */
+export type GoogleModelId = 'gemini-2.5-pro' | 'gemini-2.5-flash' | 'gemini-3-flash-preview' | 'gemini-2.0-flash';
+export type LlmRuntimeType = BackendType;
+type ApiKeyHostFields = {
+    apiKey?: string;
+    host?: string;
+};
+type ModelFields<TModel extends string = string> = {
+    model?: TModel | (string & {});
+};
+type LlmConcreteBackendName = Exclude<BackendName, 'a2a' | 'custom' | 'custom-api'>;
+type BackendRuntimeTypeFor<TBackend extends LlmConcreteBackendName> = (typeof BACKEND_RUNTIME_METADATA)[TBackend]['backendType'];
+export type LlmProviderOption = ApiKeyHostFields & ModelFields & {
+    /** Named provider profile. Infers `backend: 'openai-api'` and protocol. */
+    provider: ProviderId;
+    /** Optional runtime-family hint; provider profiles are API-backed today. */
+    type?: Extract<BackendType, 'api'>;
+};
+export type LlmBackendOption<TBackend extends LlmConcreteBackendName = LlmConcreteBackendName> = {
+    [Backend in TBackend]: ApiKeyHostFields & ModelFields & {
+        /** Concrete OctoFlow adapter. Infers runtime type and protocol. */
+        backend: Backend;
+        /** Optional readability hint. Must match the selected backend family. */
+        type?: BackendRuntimeTypeFor<Backend>;
+    };
+}[TBackend];
+export type LlmCustomApiOption = ApiKeyHostFields & ModelFields & {
+    type: 'api';
+    /** Smart one-off API integration. Defaults to OpenAI chat semantics. */
+    custom: {
+        url: string;
+        authScheme?: 'bearer' | 'basic' | 'custom';
+        headers?: Record<string, string>;
+        protocol?: BridgeProtocol;
+        provider?: string;
+        promptCacheKey?: boolean | 'auto';
+        retries?: number;
+        timeoutMs?: number;
+    };
+};
+export type LlmCustomCliParser = 'claude' | 'openai' | 'anthropic' | 'codex' | 'cursor' | 'gemini' | 'ollama';
+export type LlmCustomCliOption = ModelFields & {
+    type: 'cli';
+    /** Smart one-off CLI integration. Protocol is inferred from parser unless set. */
+    custom: {
+        command: string;
+        args?: string[];
+        promptMode?: 'stdin' | 'arg';
+        parser?: LlmCustomCliParser;
+        env?: Record<string, string>;
+        cwd?: string;
+        protocol?: BridgeProtocol;
+        provider?: string;
+        retries?: number;
+        skipInstallCheck?: boolean;
+        timeoutMs?: number;
+    };
+};
+export type LlmTypeOption = 
+/** Any API backend, auto-selected from priority list. */
+({
+    type: 'api';
+} & ModelFields)
+/** Any CLI backend, auto-selected from priority list. Auth managed by the CLI tool itself. */
+ | ({
+    type: 'cli';
+} & ModelFields)
+/** Any local backend, auto-selected from priority list. */
+ | ({
+    type: 'local';
+} & ModelFields)
+/** Any SDK backend, auto-selected from priority list. */
+ | ({
+    type: 'sdk';
+} & ModelFields);
+export type LlmOption = LlmTypeOption | LlmProviderOption | LlmBackendOption | LlmCustomApiOption | LlmCustomCliOption;
+/** Single LLM selection or ordered fallback list. */
+export type LlmSelection = LlmOption | readonly LlmOption[];
+export {};
+//# sourceMappingURL=llm-option.d.ts.map

package/dist/domain/llm-option.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"llm-option.d.ts","sourceRoot":"","sources":["../../src/domain/llm-option.ts"],"names":[],"mappings":"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"}

package/dist/domain/llm-option.js

@@ -0,0 +1 @@
+//# sourceMappingURL=llm-option.js.map

package/dist/domain/llm-option.js.map

@@ -0,0 +1,7 @@
+{
+  "version": 3,
+  "sources": [],
+  "sourcesContent": [],
+  "mappings": "",
+  "names": []
+}

package/dist/domain/memory-scope.d.ts

@@ -0,0 +1,2 @@
+export type MemoryScope = 'global' | 'context' | 'tenant';
+//# sourceMappingURL=memory-scope.d.ts.map

package/dist/domain/memory-scope.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"memory-scope.d.ts","sourceRoot":"","sources":["../../src/domain/memory-scope.ts"],"names":[],"mappings":"AAAA,MAAM,MAAM,WAAW,GAAG,QAAQ,GAAG,SAAS,GAAG,QAAQ,CAAC"}

package/dist/domain/memory-scope.js

@@ -0,0 +1 @@
+//# sourceMappingURL=memory-scope.js.map

package/dist/domain/memory-scope.js.map

@@ -0,0 +1,7 @@
+{
+  "version": 3,
+  "sources": [],
+  "sourcesContent": [],
+  "mappings": "",
+  "names": []
+}

package/dist/domain/permission.d.ts

@@ -0,0 +1,52 @@
+/**
+ * Public permission preset types — the unified surface for "allow all",
+ * "allow this session", "ask", "deny all", and "deny this session".
+ *
+ * Types live in `domain/` so they can be referenced from `BridgeOptions`
+ * and `BridgeSendMessageParams` without pulling in the runtime resolver.
+ * The runtime translation lives in
+ * `runtime/bridge/permission-resolver.ts`.
+ */
+/** Tag treated as "destructive" by the default `alwaysAskTags` safety net. */
+export declare const PERMISSION_DESTRUCTIVE_TAG = "destructive";
+export type PermissionDecision = 'allow' | 'ask' | 'deny';
+/**
+ * Common UX presets:
+ *
+ *   - `'allow-all'`           — auto-approve every action (persistent
+ *                               default when set on `BridgeOptions`).
+ *   - `'allow-this-session'`  — auto-approve every action for this send
+ *                               only (when set on `BridgeSendMessageParams`).
+ *   - `'ask'`                 — current default: host callback / approval
+ *                               store flow.
+ *   - `'deny-all'`            — auto-reject every action.
+ *   - `'deny-this-session'`   — auto-reject every action for this send only.
+ *
+ * Scope is implicit by where the value is set — `BridgeOptions.permission`
+ * is persistent for the lifetime of the bridge; `BridgeSendMessageParams.
+ * permission` is session-scoped to that one send.
+ */
+export type PermissionPreset = 'allow-all' | 'allow-this-session' | 'ask' | 'deny-all' | 'deny-this-session';
+export interface PermissionOptions {
+    /** Default decision for every action. */
+    decision: PermissionDecision;
+    /**
+     * Action names that override `decision` back to `'ask'`. Useful as
+     * targeted exceptions to a blanket `'allow'`.
+     */
+    alwaysAsk?: readonly string[];
+    /**
+     * Action tags that override `decision` back to `'ask'`. Defaults to
+     * `['destructive']` for the `allow-*` presets so destructive built-ins
+     * (e.g. `auth_logout`) keep their guard. Pass `[]` to opt out.
+     */
+    alwaysAskTags?: readonly string[];
+    /**
+     * `decidedBy` label stamped on auto-resolved approval records.
+     * Defaults to `permission:<decision>-all`. Surfaced through
+     * `approval:updated` events for audit.
+     */
+    decidedBy?: string;
+}
+export type PermissionConfig = PermissionPreset | PermissionOptions;
+//# sourceMappingURL=permission.d.ts.map

package/dist/domain/permission.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"permission.d.ts","sourceRoot":"","sources":["../../src/domain/permission.ts"],"names":[],"mappings":"AAAA;;;;;;;;GAQG;AAEH,8EAA8E;AAC9E,eAAO,MAAM,0BAA0B,gBAAgB,CAAC;AAExD,MAAM,MAAM,kBAAkB,GAAG,OAAO,GAAG,KAAK,GAAG,MAAM,CAAC;AAE1D;;;;;;;;;;;;;;;GAeG;AACH,MAAM,MAAM,gBAAgB,GACxB,WAAW,GACX,oBAAoB,GACpB,KAAK,GACL,UAAU,GACV,mBAAmB,CAAC;AAExB,MAAM,WAAW,iBAAiB;IAChC,yCAAyC;IACzC,QAAQ,EAAE,kBAAkB,CAAC;IAC7B;;;OAGG;IACH,SAAS,CAAC,EAAE,SAAS,MAAM,EAAE,CAAC;IAC9B;;;;OAIG;IACH,aAAa,CAAC,EAAE,SAAS,MAAM,EAAE,CAAC;IAClC;;;;OAIG;IACH,SAAS,CAAC,EAAE,MAAM,CAAC;CACpB;AAED,MAAM,MAAM,gBAAgB,GAAG,gBAAgB,GAAG,iBAAiB,CAAC"}

package/dist/domain/permission.js

@@ -0,0 +1,5 @@
+const PERMISSION_DESTRUCTIVE_TAG = "destructive";
+export {
+  PERMISSION_DESTRUCTIVE_TAG
+};
+//# sourceMappingURL=permission.js.map

package/dist/domain/permission.js.map

@@ -0,0 +1,7 @@
+{
+  "version": 3,
+  "sources": ["../../src/domain/permission.ts"],
+  "sourcesContent": ["/**\n * Public permission preset types \u2014 the unified surface for \"allow all\",\n * \"allow this session\", \"ask\", \"deny all\", and \"deny this session\".\n *\n * Types live in `domain/` so they can be referenced from `BridgeOptions`\n * and `BridgeSendMessageParams` without pulling in the runtime resolver.\n * The runtime translation lives in\n * `runtime/bridge/permission-resolver.ts`.\n */\n\n/** Tag treated as \"destructive\" by the default `alwaysAskTags` safety net. */\nexport const PERMISSION_DESTRUCTIVE_TAG = 'destructive';\n\nexport type PermissionDecision = 'allow' | 'ask' | 'deny';\n\n/**\n * Common UX presets:\n *\n *   - `'allow-all'`           \u2014 auto-approve every action (persistent\n *                               default when set on `BridgeOptions`).\n *   - `'allow-this-session'`  \u2014 auto-approve every action for this send\n *                               only (when set on `BridgeSendMessageParams`).\n *   - `'ask'`                 \u2014 current default: host callback / approval\n *                               store flow.\n *   - `'deny-all'`            \u2014 auto-reject every action.\n *   - `'deny-this-session'`   \u2014 auto-reject every action for this send only.\n *\n * Scope is implicit by where the value is set \u2014 `BridgeOptions.permission`\n * is persistent for the lifetime of the bridge; `BridgeSendMessageParams.\n * permission` is session-scoped to that one send.\n */\nexport type PermissionPreset =\n  | 'allow-all'\n  | 'allow-this-session'\n  | 'ask'\n  | 'deny-all'\n  | 'deny-this-session';\n\nexport interface PermissionOptions {\n  /** Default decision for every action. */\n  decision: PermissionDecision;\n  /**\n   * Action names that override `decision` back to `'ask'`. Useful as\n   * targeted exceptions to a blanket `'allow'`.\n   */\n  alwaysAsk?: readonly string[];\n  /**\n   * Action tags that override `decision` back to `'ask'`. Defaults to\n   * `['destructive']` for the `allow-*` presets so destructive built-ins\n   * (e.g. `auth_logout`) keep their guard. Pass `[]` to opt out.\n   */\n  alwaysAskTags?: readonly string[];\n  /**\n   * `decidedBy` label stamped on auto-resolved approval records.\n   * Defaults to `permission:<decision>-all`. Surfaced through\n   * `approval:updated` events for audit.\n   */\n  decidedBy?: string;\n}\n\nexport type PermissionConfig = PermissionPreset | PermissionOptions;\n"],
+  "mappings": "AAWO,MAAM,6BAA6B;",
+  "names": []
+}

package/dist/domain/process-runner.d.ts

@@ -0,0 +1,20 @@
+import type { BackendExecutionPlan } from './contracts/backends.js';
+import type { ParsedEvent } from './contracts/messages.js';
+export interface RunExecutionResult {
+    exitCode: number;
+    stdout: string;
+    stderr: string;
+    events: ParsedEvent[];
+    finalText: string;
+    sessionId: string | null;
+    runnerSessionName?: string | null;
+}
+export type ParsedEventCallback = (event: ParsedEvent) => void | Promise<void>;
+/**
+ * Domain-facing process execution contract. Concrete process runners live in
+ * ports/adapters and are structurally assignable to this interface.
+ */
+export interface AgentProcessRunner {
+    run(plan: BackendExecutionPlan, onEvent?: ParsedEventCallback, signal?: AbortSignal): Promise<RunExecutionResult>;
+}
+//# sourceMappingURL=process-runner.d.ts.map

package/dist/domain/process-runner.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"process-runner.d.ts","sourceRoot":"","sources":["../../src/domain/process-runner.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,oBAAoB,EAAE,MAAM,yBAAyB,CAAC;AACpE,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,yBAAyB,CAAC;AAE3D,MAAM,WAAW,kBAAkB;IACjC,QAAQ,EAAE,MAAM,CAAC;IACjB,MAAM,EAAE,MAAM,CAAC;IACf,MAAM,EAAE,MAAM,CAAC;IACf,MAAM,EAAE,WAAW,EAAE,CAAC;IACtB,SAAS,EAAE,MAAM,CAAC;IAClB,SAAS,EAAE,MAAM,GAAG,IAAI,CAAC;IACzB,iBAAiB,CAAC,EAAE,MAAM,GAAG,IAAI,CAAC;CACnC;AAED,MAAM,MAAM,mBAAmB,GAAG,CAAC,KAAK,EAAE,WAAW,KAAK,IAAI,GAAG,OAAO,CAAC,IAAI,CAAC,CAAC;AAE/E;;;GAGG;AACH,MAAM,WAAW,kBAAkB;IACjC,GAAG,CACD,IAAI,EAAE,oBAAoB,EAC1B,OAAO,CAAC,EAAE,mBAAmB,EAC7B,MAAM,CAAC,EAAE,WAAW,GACnB,OAAO,CAAC,kBAAkB,CAAC,CAAC;CAChC"}

package/dist/domain/process-runner.js

@@ -0,0 +1 @@
+//# sourceMappingURL=process-runner.js.map

package/dist/domain/process-runner.js.map

@@ -0,0 +1,7 @@
+{
+  "version": 3,
+  "sources": [],
+  "sourcesContent": [],
+  "mappings": "",
+  "names": []
+}

package/dist/domain/prompt-cache.d.ts

@@ -0,0 +1,38 @@
+import type { Part } from './core-task.js';
+export type PromptCacheUsageSource = 'anthropic' | 'gemini' | 'openai' | 'vercel-ai';
+export type PromptCacheInputTokenMode = 'total' | 'uncached';
+export type PromptCacheWriteTokensByTtl = {
+    ephemeral5mInputTokens?: number;
+    ephemeral1hInputTokens?: number;
+};
+export type PromptCacheUsage = {
+    source: PromptCacheUsageSource;
+    inputTokenMode: PromptCacheInputTokenMode;
+    totalInputTokens: number;
+    uncachedInputTokens: number;
+    cachedInputTokens: number;
+    cacheWriteTokens: number;
+    cacheHitRatio: number;
+    cacheWriteTokensByTtl?: PromptCacheWriteTokensByTtl;
+    promptCacheKey?: string;
+};
+export type PromptCachePrefixDiagnostics = {
+    cacheablePrefixParts: number;
+    cacheableTotalParts: number;
+    hasUnstableCacheMarks: boolean;
+    prefixKey: string;
+    unstableCachePartIndexes: number[];
+};
+export declare function createPromptCacheUsage(input: {
+    source: PromptCacheUsageSource;
+    inputTokenMode: PromptCacheInputTokenMode;
+    inputTokens: number;
+    outputTokens: number;
+    cachedInputTokens?: number;
+    cacheWriteTokens?: number;
+    cacheWriteTokensByTtl?: PromptCacheWriteTokensByTtl;
+    promptCacheKey?: string;
+}): PromptCacheUsage;
+export declare function analyzePromptCachePrefix(parts: readonly Part[]): PromptCachePrefixDiagnostics;
+export declare function derivePromptCachePrefixKey(parts: readonly Part[]): string;
+//# sourceMappingURL=prompt-cache.d.ts.map

package/dist/domain/prompt-cache.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"prompt-cache.d.ts","sourceRoot":"","sources":["../../src/domain/prompt-cache.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,IAAI,EAAE,MAAM,gBAAgB,CAAC;AAE3C,MAAM,MAAM,sBAAsB,GAC9B,WAAW,GACX,QAAQ,GACR,QAAQ,GACR,WAAW,CAAC;AAEhB,MAAM,MAAM,yBAAyB,GAAG,OAAO,GAAG,UAAU,CAAC;AAE7D,MAAM,MAAM,2BAA2B,GAAG;IACxC,sBAAsB,CAAC,EAAE,MAAM,CAAC;IAChC,sBAAsB,CAAC,EAAE,MAAM,CAAC;CACjC,CAAC;AAEF,MAAM,MAAM,gBAAgB,GAAG;IAC7B,MAAM,EAAE,sBAAsB,CAAC;IAC/B,cAAc,EAAE,yBAAyB,CAAC;IAC1C,gBAAgB,EAAE,MAAM,CAAC;IACzB,mBAAmB,EAAE,MAAM,CAAC;IAC5B,iBAAiB,EAAE,MAAM,CAAC;IAC1B,gBAAgB,EAAE,MAAM,CAAC;IACzB,aAAa,EAAE,MAAM,CAAC;IACtB,qBAAqB,CAAC,EAAE,2BAA2B,CAAC;IACpD,cAAc,CAAC,EAAE,MAAM,CAAC;CACzB,CAAC;AAEF,MAAM,MAAM,4BAA4B,GAAG;IACzC,oBAAoB,EAAE,MAAM,CAAC;IAC7B,mBAAmB,EAAE,MAAM,CAAC;IAC5B,qBAAqB,EAAE,OAAO,CAAC;IAC/B,SAAS,EAAE,MAAM,CAAC;IAClB,wBAAwB,EAAE,MAAM,EAAE,CAAC;CACpC,CAAC;AAEF,wBAAgB,sBAAsB,CAAC,KAAK,EAAE;IAC5C,MAAM,EAAE,sBAAsB,CAAC;IAC/B,cAAc,EAAE,yBAAyB,CAAC;IAC1C,WAAW,EAAE,MAAM,CAAC;IACpB,YAAY,EAAE,MAAM,CAAC;IACrB,iBAAiB,CAAC,EAAE,MAAM,CAAC;IAC3B,gBAAgB,CAAC,EAAE,MAAM,CAAC;IAC1B,qBAAqB,CAAC,EAAE,2BAA2B,CAAC;IACpD,cAAc,CAAC,EAAE,MAAM,CAAC;CACzB,GAAG,gBAAgB,CA4BnB;AAED,wBAAgB,wBAAwB,CACtC,KAAK,EAAE,SAAS,IAAI,EAAE,GACrB,4BAA4B,CA6B9B;AAED,wBAAgB,0BAA0B,CAAC,KAAK,EAAE,SAAS,IAAI,EAAE,GAAG,MAAM,CAEzE"}