octoflow-core 1.0.0

package/dist/domain/core-task.d.ts

@@ -0,0 +1,335 @@
+import type { AgentEvent } from './agent-event.js';
+import type { AgentLineage } from './agent-registry.js';
+import type { UsageStats } from './contracts/messages.js';
+import type { CacheControl } from './core-cache-types.js';
+import type { CostSource } from './cost-estimation.js';
+import type { ErrorSummary } from './shared.js';
+export type BridgeExecutionMode = 'host-full-access' | 'sandbox' | 'remote-sandbox' | 'api';
+export type BridgeApprovalMode = 'inherit' | 'manual' | 'off';
+/**
+ * Cache boundary hint for prompt-cache-aware backends (Anthropic, OpenAI Responses).
+ * Consumed by native-message builders when is landed.
+ */
+export type { BridgeCacheControl, BridgeCacheOptions, CacheControl, } from './core-cache-types.js';
+export interface TextPart {
+    kind: 'text';
+    metadata?: Record<string, unknown>;
+    text: string;
+    /**
+     * Cache boundary hint consumed by cache-aware native builders.
+     * Additive — unaware builders ignore it.
+     */
+    cacheControl?: CacheControl;
+}
+export interface FilePart {
+    kind: 'file';
+    file: {
+        name?: string;
+        mimeType?: string;
+        uri?: string;
+        bytes?: string;
+    };
+    metadata?: Record<string, unknown>;
+}
+export interface DataPart {
+    kind: 'data';
+    data: unknown;
+    metadata?: Record<string, unknown>;
+}
+/**
+ * Structured tool invocation emitted by an assistant turn.
+ * Paired by `id` with a later `ToolResultPart`.
+ */
+export interface ToolCallPart {
+    kind: 'tool_call';
+    id: string;
+    name: string;
+    input: unknown;
+    metadata?: Record<string, unknown>;
+}
+/**
+ * Result of a previously issued tool call. Produced by the tool executor and
+ * persisted into `Task.history` as a `role: 'tool'` message.
+ */
+export interface ToolResultPart {
+    kind: 'tool_result';
+    callId: string;
+    output: unknown;
+    isError?: boolean;
+    metadata?: Record<string, unknown>;
+}
+export type Part = TextPart | FilePart | DataPart | ToolCallPart | ToolResultPart;
+/**
+ * Lifecycle status of a tool call issued by an assistant message. Tracked on
+ * `Message.toolCalls[*].status` so restart/resume logic can tell
+ * which calls were in flight when the bridge went down.
+ *
+ * - `'pending'` — call issued, result not yet appended to `Task.history`
+ * - `'succeeded'` — matching `ToolResultPart` landed with no error
+ * - `'failed'` — matching `ToolResultPart` landed with `isError: true`
+ * - `'timeout'` — tool did not return within the configured timeout
+ */
+export type ToolCallStatus = 'pending' | 'succeeded' | 'failed' | 'timeout';
+/**
+ * Light reference to a tool call produced by this message. The call detail
+ * lives in a `ToolCallPart` on the same message; this is a convenience index
+ * plus a cheap place to carry status/timing for resumability.
+ */
+export interface ToolCallRef {
+    id: string;
+    name: string;
+    /** Current lifecycle status. Absent = treat as `'succeeded'` for records predating the field. */
+    status?: ToolCallStatus;
+    /** ISO timestamp when the tool call was issued. */
+    startedAt?: string;
+    /** ISO timestamp when the tool call settled. */
+    completedAt?: string;
+}
+/**
+ * Typed metadata bag for a `Message`.
+ *
+ * `timestamp` is the ISO-8601 wall time when the message was finalized. It is
+ * read by history strategies (e.g. `{ kind: 'since' }`) to filter messages by
+ * age. `createMessage()` auto-stamps it unless `stamp: false` is passed.
+ *
+ * All fields are optional. The index signature preserves the escape hatch for
+ * custom keys — existing callers using arbitrary keys continue to compile.
+ */
+export interface MessageMetadata {
+    /** ISO-8601 wall time when this message was finalized. */
+    timestamp?: string;
+    /**
+     * LLM model name that produced this message (e.g. `"gpt-4o"`,
+     * `"claude-opus-4-5"`). Not set for CLI backends — the underlying model is
+     * opaque to the bridge when a CLI manages its own context.
+     */
+    model?: string;
+    /**
+     * Logical name / identifier of the agent that produced this message.
+     * Populated from the agent lineage in multi-agent (Pack) scenarios; falls
+     * back to the bridge profile name in single-agent contexts.
+     */
+    agentName?: string;
+    /** Backend that produced this message (informational). */
+    backend?: string;
+    /** Distributed trace / span correlation ID. */
+    traceId?: string;
+    [key: string]: unknown;
+}
+export interface Message {
+    /**
+     * Required on the wire (every A2A server and persisted DTO carries one).
+     * Optional only at the "start of a turn" where the caller has not yet
+     * allocated one — the bridge populates it before any Message is stored.
+     */
+    contextId?: string;
+    extensions?: string[];
+    kind: 'message';
+    messageId: string;
+    metadata?: MessageMetadata;
+    parts: Part[];
+    referenceTaskIds?: string[];
+    role: 'agent' | 'user' | 'system' | 'tool';
+    taskId?: string;
+    /**
+     * Tool calls issued by this message (assistant role). The structured call
+     * payload lives in matching `ToolCallPart` entries within `parts`.
+     */
+    toolCalls?: ToolCallRef[];
+}
+export interface Artifact {
+    artifactId: string;
+    description?: string;
+    extensions?: string[];
+    metadata?: Record<string, unknown>;
+    name?: string;
+    parts: Part[];
+}
+export type TaskState = 'submitted' | 'working' | 'tool-pending' | 'input-required' | 'completed' | 'canceled' | 'failed' | 'rejected' | 'auth-required' | 'approval-required' | 'budget-exhausted' | 'unknown';
+export interface TaskStatus {
+    message?: Message;
+    state: TaskState;
+    timestamp?: string;
+}
+export interface Task {
+    artifacts?: Artifact[];
+    contextId: string;
+    createdAt?: string;
+    history?: Message[];
+    id: string;
+    kind: 'task';
+    lastModified?: string;
+    /**
+     * Bridge-typed metadata bag. The bridge populates `metadata.bridge`,
+     * `metadata.context`, `metadata.error`, `metadata.fallback`, and
+     * `metadata.retry`. Custom keys are still allowed via the index signature.
+     */
+    metadata?: BridgeMetadata;
+    status: TaskStatus;
+    tenant?: string;
+}
+export interface TaskStatusUpdateEvent {
+    contextId: string;
+    final: boolean;
+    kind: 'status-update';
+    metadata?: BridgeMetadata;
+    status: TaskStatus;
+    taskId: string;
+}
+export interface TaskArtifactUpdateEvent {
+    append?: boolean;
+    artifact: Artifact;
+    contextId: string;
+    kind: 'artifact-update';
+    lastChunk?: boolean;
+    metadata?: BridgeMetadata;
+    taskId: string;
+}
+export interface AgentCard {
+    additionalInterfaces?: Array<{
+        transport: string;
+        url: string;
+    }>;
+    capabilities?: {
+        extensions?: Array<{
+            description?: string;
+            params?: Record<string, unknown>;
+            required?: boolean;
+            uri: string;
+        }>;
+        extendedAgentCard?: boolean;
+        pushNotifications?: boolean;
+        stateTransitionHistory?: boolean;
+        streaming?: boolean;
+    };
+    defaultInputModes?: string[];
+    defaultOutputModes?: string[];
+    description?: string;
+    documentationUrl?: string;
+    iconUrl?: string;
+    name: string;
+    preferredTransport?: string;
+    protocolVersion?: string;
+    provider?: {
+        organization: string;
+        url: string;
+    };
+    securityRequirements?: Array<{
+        schemes: Record<string, string[]>;
+    }>;
+    securitySchemes?: Record<string, Record<string, unknown>>;
+    skills?: Array<{
+        description?: string;
+        id: string;
+        name: string;
+        tags?: string[];
+    }>;
+    supportedInterfaces?: Array<{
+        protocolBinding: string;
+        protocolVersion: string;
+        tenant?: string;
+        url: string;
+    }>;
+    supportsAuthenticatedExtendedCard?: boolean;
+    url?: string;
+    version?: string;
+}
+export interface RetryInfo {
+    attempt: number;
+    backend: BackendName | null;
+    delayMs: number;
+    error: ErrorSummary;
+    maxRetries: number;
+}
+export interface ErrorInfo {
+    backend: BackendName | null;
+    error: ErrorSummary;
+    phase: 'selection' | 'run' | 'stream' | 'session';
+}
+export interface FallbackInfo {
+    attempt: number;
+    error: ErrorSummary;
+    fromBackend: BackendName | null;
+    maxBackends: number;
+    phase: ErrorInfo['phase'];
+    toBackend: BackendName;
+}
+export interface BridgeMetadata {
+    bridge?: {
+        approvalMode?: BridgeApprovalMode;
+        backend?: BackendName;
+        costUsd?: number;
+        costSource?: CostSource;
+        executionMode?: BridgeExecutionMode;
+        pendingApprovalId?: string;
+        sessionId?: string | null;
+        sourceEvent?: AgentEvent;
+        transparentProxy?: true;
+        usage?: UsageStats;
+        agentRole?: AgentRole;
+        packId?: string;
+        parentTaskId?: string;
+        lineage?: AgentLineage;
+        goal?: GoalRef;
+        project?: ProjectRef;
+    };
+    context?: {
+        approvalMode: BridgeApprovalMode;
+        createdAt: string;
+        executionMode: BridgeExecutionMode;
+        filesystem: {
+            denyPaths: string[];
+            readableRoots: string[];
+            writableRoots: string[];
+        };
+        network: string;
+        profile: string;
+        runtimeTarget: string;
+        sandbox: string;
+        workspace: string | null;
+    };
+    backendSwitch?: {
+        fromBackend: BackendName;
+        toBackend: BackendName;
+        reason: string;
+        switchCount: number;
+        timestamp: string;
+        noChange?: boolean;
+    };
+    error?: ErrorInfo;
+    fallback?: FallbackInfo & {
+        status: 'scheduled' | 'completed' | 'failed';
+    };
+    retry?: RetryInfo & {
+        status: 'exhausted' | 'scheduled';
+    };
+    session?: {
+        sessionId: string;
+        cliSessionId?: string;
+    };
+    [key: string]: unknown;
+}
+export interface GoalRef {
+    id: string;
+    description: string;
+    parent?: GoalRef;
+}
+export interface ProjectRef {
+    id: string;
+    name: string;
+    description?: string;
+}
+export type BackendName = 'claude-code-cli' | 'codex-cli' | 'cursor-cli' | 'gemini-cli' | 'gemini-api' | 'ollama' | 'openai-api' | 'anthropic-api' | 'vercel-ai:anthropic' | 'vercel-ai:openai' | 'vercel-ai:google' | 'custom' | 'custom-api' | 'a2a' | 'acp-cli';
+/**
+ * Canonical value-level list of every {@link BackendName}. The
+ * `satisfies readonly BackendName[]` clause makes TypeScript fail to compile
+ * if a new variant is added to the union without being listed here, so the
+ * type and the runtime list stay in lock-step.
+ */
+export declare const BACKEND_NAMES: readonly ["claude-code-cli", "codex-cli", "cursor-cli", "gemini-cli", "gemini-api", "ollama", "openai-api", "anthropic-api", "vercel-ai:anthropic", "vercel-ai:openai", "vercel-ai:google", "custom", "custom-api", "a2a", "acp-cli"];
+/** `Set` form of {@link BACKEND_NAMES} for O(1) membership checks. */
+export declare const BACKEND_NAME_SET: ReadonlySet<BackendName>;
+/** Type guard for {@link BackendName}. */
+export declare const isBackendName: (value: string) => value is BackendName;
+export type AgentRole = 'leader' | 'worker';
+//# sourceMappingURL=core-task.d.ts.map

package/dist/domain/core-task.d.ts.map

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

package/dist/domain/core-task.js

@@ -0,0 +1,27 @@
+const BACKEND_NAMES = [
+  "claude-code-cli",
+  "codex-cli",
+  "cursor-cli",
+  "gemini-cli",
+  "gemini-api",
+  "ollama",
+  "openai-api",
+  "anthropic-api",
+  "vercel-ai:anthropic",
+  "vercel-ai:openai",
+  "vercel-ai:google",
+  "custom",
+  "custom-api",
+  "a2a",
+  "acp-cli"
+];
+const BACKEND_NAME_SET = new Set(
+  BACKEND_NAMES
+);
+const isBackendName = (value) => BACKEND_NAME_SET.has(value);
+export {
+  BACKEND_NAMES,
+  BACKEND_NAME_SET,
+  isBackendName
+};
+//# sourceMappingURL=core-task.js.map

package/dist/domain/core-task.js.map

@@ -0,0 +1,7 @@
+{
+  "version": 3,
+  "sources": ["../../src/domain/core-task.ts"],
+  "sourcesContent": ["import type { AgentEvent } from './agent-event.js';\nimport type { AgentLineage } from './agent-registry.js';\nimport type { UsageStats } from './contracts/messages.js';\nimport type { CacheControl } from './core-cache-types.js';\nimport type { CostSource } from './cost-estimation.js';\nimport type { ErrorSummary } from './shared.js';\nexport type BridgeExecutionMode =\n  | 'host-full-access'\n  | 'sandbox'\n  | 'remote-sandbox'\n  | 'api';\n\nexport type BridgeApprovalMode = 'inherit' | 'manual' | 'off';\n\n/**\n * Cache boundary hint for prompt-cache-aware backends (Anthropic, OpenAI Responses).\n * Consumed by native-message builders when is landed.\n */\nexport type {\n  BridgeCacheControl,\n  BridgeCacheOptions,\n  CacheControl,\n} from './core-cache-types.js';\nexport interface TextPart {\n  kind: 'text';\n  metadata?: Record<string, unknown>;\n  text: string;\n  /**\n   * Cache boundary hint consumed by cache-aware native builders.\n   * Additive \u2014 unaware builders ignore it.\n   */\n  cacheControl?: CacheControl;\n}\n\nexport interface FilePart {\n  kind: 'file';\n  file: {\n    name?: string;\n    mimeType?: string;\n    uri?: string;\n    bytes?: string;\n  };\n  metadata?: Record<string, unknown>;\n}\n\nexport interface DataPart {\n  kind: 'data';\n  data: unknown;\n  metadata?: Record<string, unknown>;\n}\n\n/**\n * Structured tool invocation emitted by an assistant turn.\n * Paired by `id` with a later `ToolResultPart`.\n */\nexport interface ToolCallPart {\n  kind: 'tool_call';\n  id: string;\n  name: string;\n  input: unknown;\n  metadata?: Record<string, unknown>;\n}\n\n/**\n * Result of a previously issued tool call. Produced by the tool executor and\n * persisted into `Task.history` as a `role: 'tool'` message.\n */\nexport interface ToolResultPart {\n  kind: 'tool_result';\n  callId: string;\n  output: unknown;\n  isError?: boolean;\n  metadata?: Record<string, unknown>;\n}\n\nexport type Part =\n  | TextPart\n  | FilePart\n  | DataPart\n  | ToolCallPart\n  | ToolResultPart;\n\n/**\n * Lifecycle status of a tool call issued by an assistant message. Tracked on\n * `Message.toolCalls[*].status` so restart/resume logic can tell\n * which calls were in flight when the bridge went down.\n *\n * - `'pending'` \u2014 call issued, result not yet appended to `Task.history`\n * - `'succeeded'` \u2014 matching `ToolResultPart` landed with no error\n * - `'failed'` \u2014 matching `ToolResultPart` landed with `isError: true`\n * - `'timeout'` \u2014 tool did not return within the configured timeout\n */\nexport type ToolCallStatus = 'pending' | 'succeeded' | 'failed' | 'timeout';\n\n/**\n * Light reference to a tool call produced by this message. The call detail\n * lives in a `ToolCallPart` on the same message; this is a convenience index\n * plus a cheap place to carry status/timing for resumability.\n */\nexport interface ToolCallRef {\n  id: string;\n  name: string;\n  /** Current lifecycle status. Absent = treat as `'succeeded'` for records predating the field. */\n  status?: ToolCallStatus;\n  /** ISO timestamp when the tool call was issued. */\n  startedAt?: string;\n  /** ISO timestamp when the tool call settled. */\n  completedAt?: string;\n}\n\n/**\n * Typed metadata bag for a `Message`.\n *\n * `timestamp` is the ISO-8601 wall time when the message was finalized. It is\n * read by history strategies (e.g. `{ kind: 'since' }`) to filter messages by\n * age. `createMessage()` auto-stamps it unless `stamp: false` is passed.\n *\n * All fields are optional. The index signature preserves the escape hatch for\n * custom keys \u2014 existing callers using arbitrary keys continue to compile.\n */\nexport interface MessageMetadata {\n  /** ISO-8601 wall time when this message was finalized. */\n  timestamp?: string;\n  /**\n   * LLM model name that produced this message (e.g. `\"gpt-4o\"`,\n   * `\"claude-opus-4-5\"`). Not set for CLI backends \u2014 the underlying model is\n   * opaque to the bridge when a CLI manages its own context.\n   */\n  model?: string;\n  /**\n   * Logical name / identifier of the agent that produced this message.\n   * Populated from the agent lineage in multi-agent (Pack) scenarios; falls\n   * back to the bridge profile name in single-agent contexts.\n   */\n  agentName?: string;\n  /** Backend that produced this message (informational). */\n  backend?: string;\n  /** Distributed trace / span correlation ID. */\n  traceId?: string;\n  [key: string]: unknown;\n}\n\nexport interface Message {\n  /**\n   * Required on the wire (every A2A server and persisted DTO carries one).\n   * Optional only at the \"start of a turn\" where the caller has not yet\n   * allocated one \u2014 the bridge populates it before any Message is stored.\n   */\n  contextId?: string;\n  extensions?: string[];\n  kind: 'message';\n  messageId: string;\n  metadata?: MessageMetadata;\n  parts: Part[];\n  referenceTaskIds?: string[];\n  role: 'agent' | 'user' | 'system' | 'tool';\n  taskId?: string;\n  /**\n   * Tool calls issued by this message (assistant role). The structured call\n   * payload lives in matching `ToolCallPart` entries within `parts`.\n   */\n  toolCalls?: ToolCallRef[];\n}\n\nexport interface Artifact {\n  artifactId: string;\n  description?: string;\n  extensions?: string[];\n  metadata?: Record<string, unknown>;\n  name?: string;\n  parts: Part[];\n}\n\nexport type TaskState =\n  | 'submitted'\n  | 'working'\n  | 'tool-pending'\n  | 'input-required'\n  | 'completed'\n  | 'canceled'\n  | 'failed'\n  | 'rejected'\n  | 'auth-required'\n  | 'approval-required'\n  | 'budget-exhausted'\n  | 'unknown';\n\nexport interface TaskStatus {\n  message?: Message;\n  state: TaskState;\n  timestamp?: string;\n}\n\nexport interface Task {\n  artifacts?: Artifact[];\n  contextId: string;\n  createdAt?: string;\n  history?: Message[];\n  id: string;\n  kind: 'task';\n  lastModified?: string;\n  /**\n   * Bridge-typed metadata bag. The bridge populates `metadata.bridge`,\n   * `metadata.context`, `metadata.error`, `metadata.fallback`, and\n   * `metadata.retry`. Custom keys are still allowed via the index signature.\n   */\n  metadata?: BridgeMetadata;\n  status: TaskStatus;\n  tenant?: string;\n}\n\nexport interface TaskStatusUpdateEvent {\n  contextId: string;\n  final: boolean;\n  kind: 'status-update';\n  metadata?: BridgeMetadata;\n  status: TaskStatus;\n  taskId: string;\n}\n\nexport interface TaskArtifactUpdateEvent {\n  append?: boolean;\n  artifact: Artifact;\n  contextId: string;\n  kind: 'artifact-update';\n  lastChunk?: boolean;\n  metadata?: BridgeMetadata;\n  taskId: string;\n}\n\nexport interface AgentCard {\n  additionalInterfaces?: Array<{\n    transport: string;\n    url: string;\n  }>;\n  capabilities?: {\n    extensions?: Array<{\n      description?: string;\n      params?: Record<string, unknown>;\n      required?: boolean;\n      uri: string;\n    }>;\n    extendedAgentCard?: boolean;\n    pushNotifications?: boolean;\n    stateTransitionHistory?: boolean;\n    streaming?: boolean;\n  };\n  defaultInputModes?: string[];\n  defaultOutputModes?: string[];\n  description?: string;\n  documentationUrl?: string;\n  iconUrl?: string;\n  name: string;\n  preferredTransport?: string;\n  protocolVersion?: string;\n  provider?: {\n    organization: string;\n    url: string;\n  };\n  securityRequirements?: Array<{\n    schemes: Record<string, string[]>;\n  }>;\n  securitySchemes?: Record<string, Record<string, unknown>>;\n  skills?: Array<{\n    description?: string;\n    id: string;\n    name: string;\n    tags?: string[];\n  }>;\n  supportedInterfaces?: Array<{\n    protocolBinding: string;\n    protocolVersion: string;\n    tenant?: string;\n    url: string;\n  }>;\n  supportsAuthenticatedExtendedCard?: boolean;\n  url?: string;\n  version?: string;\n}\n\nexport interface RetryInfo {\n  attempt: number;\n  backend: BackendName | null;\n  delayMs: number;\n  error: ErrorSummary;\n  maxRetries: number;\n}\n\nexport interface ErrorInfo {\n  backend: BackendName | null;\n  error: ErrorSummary;\n  phase: 'selection' | 'run' | 'stream' | 'session';\n}\n\nexport interface FallbackInfo {\n  attempt: number;\n  error: ErrorSummary;\n  fromBackend: BackendName | null;\n  maxBackends: number;\n  phase: ErrorInfo['phase'];\n  toBackend: BackendName;\n}\n\nexport interface BridgeMetadata {\n  bridge?: {\n    approvalMode?: BridgeApprovalMode;\n    backend?: BackendName;\n    costUsd?: number;\n    costSource?: CostSource;\n    executionMode?: BridgeExecutionMode;\n    pendingApprovalId?: string;\n    sessionId?: string | null;\n    sourceEvent?: AgentEvent;\n    transparentProxy?: true;\n    usage?: UsageStats;\n    agentRole?: AgentRole;\n    packId?: string;\n    parentTaskId?: string;\n    lineage?: AgentLineage;\n    goal?: GoalRef;\n    project?: ProjectRef;\n  };\n  context?: {\n    approvalMode: BridgeApprovalMode;\n    createdAt: string;\n    executionMode: BridgeExecutionMode;\n    filesystem: {\n      denyPaths: string[];\n      readableRoots: string[];\n      writableRoots: string[];\n    };\n    network: string;\n    profile: string;\n    runtimeTarget: string;\n    sandbox: string;\n    workspace: string | null;\n  };\n  backendSwitch?: {\n    fromBackend: BackendName;\n    toBackend: BackendName;\n    reason: string;\n    switchCount: number;\n    timestamp: string;\n    noChange?: boolean;\n  };\n  error?: ErrorInfo;\n  fallback?: FallbackInfo & {\n    status: 'scheduled' | 'completed' | 'failed';\n  };\n  retry?: RetryInfo & {\n    status: 'exhausted' | 'scheduled';\n  };\n  session?: {\n    sessionId: string;\n    cliSessionId?: string;\n  };\n  [key: string]: unknown;\n}\nexport interface GoalRef {\n  id: string;\n  description: string;\n  parent?: GoalRef;\n}\n\nexport interface ProjectRef {\n  id: string;\n  name: string;\n  description?: string;\n}\nexport type BackendName =\n  | 'claude-code-cli'\n  | 'codex-cli'\n  | 'cursor-cli'\n  | 'gemini-cli'\n  | 'gemini-api'\n  | 'ollama'\n  | 'openai-api'\n  | 'anthropic-api'\n  | 'vercel-ai:anthropic'\n  | 'vercel-ai:openai'\n  | 'vercel-ai:google'\n  | 'custom'\n  | 'custom-api'\n  | 'a2a'\n  | 'acp-cli';\n\n/**\n * Canonical value-level list of every {@link BackendName}. The\n * `satisfies readonly BackendName[]` clause makes TypeScript fail to compile\n * if a new variant is added to the union without being listed here, so the\n * type and the runtime list stay in lock-step.\n */\nexport const BACKEND_NAMES = [\n  'claude-code-cli',\n  'codex-cli',\n  'cursor-cli',\n  'gemini-cli',\n  'gemini-api',\n  'ollama',\n  'openai-api',\n  'anthropic-api',\n  'vercel-ai:anthropic',\n  'vercel-ai:openai',\n  'vercel-ai:google',\n  'custom',\n  'custom-api',\n  'a2a',\n  'acp-cli',\n] as const satisfies readonly BackendName[];\n\n/** `Set` form of {@link BACKEND_NAMES} for O(1) membership checks. */\nexport const BACKEND_NAME_SET: ReadonlySet<BackendName> = new Set(\n  BACKEND_NAMES\n);\n\n/** Type guard for {@link BackendName}. */\nexport const isBackendName = (value: string): value is BackendName =>\n  BACKEND_NAME_SET.has(value as BackendName);\n\nexport type AgentRole = 'leader' | 'worker';\n"],
+  "mappings": "AAwYO,MAAM,gBAAgB;AAAA,EAC3B;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;AACF;AAGO,MAAM,mBAA6C,IAAI;AAAA,EAC5D;AACF;AAGO,MAAM,gBAAgB,CAAC,UAC5B,iBAAiB,IAAI,KAAoB;",
+  "names": []
+}

package/dist/domain/cost-estimation.d.ts

@@ -0,0 +1,22 @@
+import type { UsageStats } from './contracts/messages.js';
+export type CostSource = 'reported' | 'estimated' | 'unknown';
+export interface TokenCostRates {
+    inputPer1k: number;
+    outputPer1k: number;
+    cachedInputPer1k?: number;
+    cacheWritePer1k?: number;
+    cacheWrite1hPer1k?: number;
+}
+export interface TokenCostTable {
+    [model: string]: TokenCostRates;
+}
+export interface CostEstimate {
+    usd: number;
+    inputTokens: number;
+    outputTokens: number;
+    source: CostSource;
+}
+export declare const DEFAULT_TOKEN_COSTS: TokenCostTable;
+export declare function estimateTokenCost(costUsd: number | null, usage: UsageStats | null, model: string | undefined, tokenCosts?: TokenCostTable): CostEstimate;
+export declare function findTokenCostRates(model: string, tokenCosts?: TokenCostTable): TokenCostRates | null;
+//# sourceMappingURL=cost-estimation.d.ts.map

package/dist/domain/cost-estimation.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"cost-estimation.d.ts","sourceRoot":"","sources":["../../src/domain/cost-estimation.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,yBAAyB,CAAC;AAE1D,MAAM,MAAM,UAAU,GAAG,UAAU,GAAG,WAAW,GAAG,SAAS,CAAC;AAE9D,MAAM,WAAW,cAAc;IAC7B,UAAU,EAAE,MAAM,CAAC;IACnB,WAAW,EAAE,MAAM,CAAC;IACpB,gBAAgB,CAAC,EAAE,MAAM,CAAC;IAC1B,eAAe,CAAC,EAAE,MAAM,CAAC;IACzB,iBAAiB,CAAC,EAAE,MAAM,CAAC;CAC5B;AAED,MAAM,WAAW,cAAc;IAC7B,CAAC,KAAK,EAAE,MAAM,GAAG,cAAc,CAAC;CACjC;AAED,MAAM,WAAW,YAAY;IAC3B,GAAG,EAAE,MAAM,CAAC;IACZ,WAAW,EAAE,MAAM,CAAC;IACpB,YAAY,EAAE,MAAM,CAAC;IACrB,MAAM,EAAE,UAAU,CAAC;CACpB;AAED,eAAO,MAAM,mBAAmB,EAAE,cA+DjC,CAAC;AAEF,wBAAgB,iBAAiB,CAC/B,OAAO,EAAE,MAAM,GAAG,IAAI,EACtB,KAAK,EAAE,UAAU,GAAG,IAAI,EACxB,KAAK,EAAE,MAAM,GAAG,SAAS,EACzB,UAAU,GAAE,cAAoC,GAC/C,YAAY,CAoDd;AAED,wBAAgB,kBAAkB,CAChC,KAAK,EAAE,MAAM,EACb,UAAU,GAAE,cAAoC,GAC/C,cAAc,GAAG,IAAI,CAMvB"}

package/dist/domain/cost-estimation.js

@@ -0,0 +1,107 @@
+const DEFAULT_TOKEN_COSTS = {
+  "claude-opus-4": {
+    inputPer1k: 0.015,
+    outputPer1k: 0.075,
+    cachedInputPer1k: 15e-4,
+    cacheWritePer1k: 0.01875,
+    cacheWrite1hPer1k: 0.03
+  },
+  "claude-sonnet-4": {
+    inputPer1k: 3e-3,
+    outputPer1k: 0.015,
+    cachedInputPer1k: 3e-4,
+    cacheWritePer1k: 375e-5,
+    cacheWrite1hPer1k: 6e-3
+  },
+  "claude-haiku-4": {
+    inputPer1k: 1e-3,
+    outputPer1k: 5e-3,
+    cachedInputPer1k: 1e-4,
+    cacheWritePer1k: 125e-5,
+    cacheWrite1hPer1k: 2e-3
+  },
+  "claude-sonnet": {
+    inputPer1k: 3e-3,
+    outputPer1k: 0.015,
+    cachedInputPer1k: 3e-4,
+    cacheWritePer1k: 375e-5,
+    cacheWrite1hPer1k: 6e-3
+  },
+  "claude-opus": {
+    inputPer1k: 0.015,
+    outputPer1k: 0.075,
+    cachedInputPer1k: 15e-4,
+    cacheWritePer1k: 0.01875,
+    cacheWrite1hPer1k: 0.03
+  },
+  "claude-haiku": {
+    inputPer1k: 1e-3,
+    outputPer1k: 5e-3,
+    cachedInputPer1k: 1e-4,
+    cacheWritePer1k: 125e-5,
+    cacheWrite1hPer1k: 2e-3
+  },
+  "gpt-4o-mini": {
+    inputPer1k: 15e-5,
+    outputPer1k: 6e-4,
+    cachedInputPer1k: 75e-6
+  },
+  "gpt-4o": {
+    inputPer1k: 25e-4,
+    outputPer1k: 0.01,
+    cachedInputPer1k: 125e-5
+  },
+  "o4-mini": {
+    inputPer1k: 11e-4,
+    outputPer1k: 44e-4,
+    cachedInputPer1k: 275e-6
+  },
+  o3: {
+    inputPer1k: 2e-3,
+    outputPer1k: 8e-3,
+    cachedInputPer1k: 5e-4
+  }
+};
+function estimateTokenCost(costUsd, usage, model, tokenCosts = DEFAULT_TOKEN_COSTS) {
+  const inputTokens = usage?.inputTokens ?? 0;
+  const outputTokens = usage?.outputTokens ?? 0;
+  if (costUsd != null && costUsd > 0) {
+    return { usd: costUsd, inputTokens, outputTokens, source: "reported" };
+  }
+  if (!usage || inputTokens === 0 && outputTokens === 0 || !model) {
+    return { usd: 0, inputTokens, outputTokens, source: "unknown" };
+  }
+  const rates = findTokenCostRates(model, tokenCosts);
+  if (!rates) {
+    return { usd: 0, inputTokens, outputTokens, source: "unknown" };
+  }
+  const cachedInputTokens = usage.cache?.cachedInputTokens ?? usage.cachedInputTokens ?? 0;
+  const cacheWriteTokens = usage.cache?.cacheWriteTokens ?? usage.cacheWriteTokens ?? 0;
+  const uncachedInputTokens = usage.cache?.uncachedInputTokens ?? Math.max(0, inputTokens - cachedInputTokens);
+  const writesByTtl = usage.cache?.cacheWriteTokensByTtl;
+  const oneHourWriteTokens = writesByTtl?.ephemeral1hInputTokens ?? 0;
+  const fiveMinuteWriteTokens = writesByTtl?.ephemeral5mInputTokens ?? 0;
+  const defaultWriteTokens = Math.max(
+    0,
+    cacheWriteTokens - oneHourWriteTokens - fiveMinuteWriteTokens
+  );
+  const inputCost = uncachedInputTokens / 1e3 * rates.inputPer1k + cachedInputTokens / 1e3 * (rates.cachedInputPer1k ?? rates.inputPer1k) + fiveMinuteWriteTokens / 1e3 * (rates.cacheWritePer1k ?? rates.inputPer1k) + oneHourWriteTokens / 1e3 * (rates.cacheWrite1hPer1k ?? rates.cacheWritePer1k ?? rates.inputPer1k) + defaultWriteTokens / 1e3 * (rates.cacheWritePer1k ?? rates.inputPer1k);
+  const outputCost = outputTokens / 1e3 * rates.outputPer1k;
+  return {
+    usd: inputCost + outputCost,
+    inputTokens,
+    outputTokens,
+    source: "estimated"
+  };
+}
+function findTokenCostRates(model, tokenCosts = DEFAULT_TOKEN_COSTS) {
+  const lower = model.toLowerCase();
+  const matches = Object.entries(tokenCosts).filter(([key]) => lower.includes(key.toLowerCase())).sort(([a], [b]) => b.length - a.length);
+  return matches[0]?.[1] ?? null;
+}
+export {
+  DEFAULT_TOKEN_COSTS,
+  estimateTokenCost,
+  findTokenCostRates
+};
+//# sourceMappingURL=cost-estimation.js.map

package/dist/domain/cost-estimation.js.map

@@ -0,0 +1,7 @@
+{
+  "version": 3,
+  "sources": ["../../src/domain/cost-estimation.ts"],
+  "sourcesContent": ["import type { UsageStats } from './contracts/messages.js';\n\nexport type CostSource = 'reported' | 'estimated' | 'unknown';\n\nexport interface TokenCostRates {\n  inputPer1k: number;\n  outputPer1k: number;\n  cachedInputPer1k?: number;\n  cacheWritePer1k?: number;\n  cacheWrite1hPer1k?: number;\n}\n\nexport interface TokenCostTable {\n  [model: string]: TokenCostRates;\n}\n\nexport interface CostEstimate {\n  usd: number;\n  inputTokens: number;\n  outputTokens: number;\n  source: CostSource;\n}\n\nexport const DEFAULT_TOKEN_COSTS: TokenCostTable = {\n  'claude-opus-4': {\n    inputPer1k: 0.015,\n    outputPer1k: 0.075,\n    cachedInputPer1k: 0.0015,\n    cacheWritePer1k: 0.01875,\n    cacheWrite1hPer1k: 0.03,\n  },\n  'claude-sonnet-4': {\n    inputPer1k: 0.003,\n    outputPer1k: 0.015,\n    cachedInputPer1k: 0.0003,\n    cacheWritePer1k: 0.00375,\n    cacheWrite1hPer1k: 0.006,\n  },\n  'claude-haiku-4': {\n    inputPer1k: 0.001,\n    outputPer1k: 0.005,\n    cachedInputPer1k: 0.0001,\n    cacheWritePer1k: 0.00125,\n    cacheWrite1hPer1k: 0.002,\n  },\n  'claude-sonnet': {\n    inputPer1k: 0.003,\n    outputPer1k: 0.015,\n    cachedInputPer1k: 0.0003,\n    cacheWritePer1k: 0.00375,\n    cacheWrite1hPer1k: 0.006,\n  },\n  'claude-opus': {\n    inputPer1k: 0.015,\n    outputPer1k: 0.075,\n    cachedInputPer1k: 0.0015,\n    cacheWritePer1k: 0.01875,\n    cacheWrite1hPer1k: 0.03,\n  },\n  'claude-haiku': {\n    inputPer1k: 0.001,\n    outputPer1k: 0.005,\n    cachedInputPer1k: 0.0001,\n    cacheWritePer1k: 0.00125,\n    cacheWrite1hPer1k: 0.002,\n  },\n  'gpt-4o-mini': {\n    inputPer1k: 0.00015,\n    outputPer1k: 0.0006,\n    cachedInputPer1k: 0.000075,\n  },\n  'gpt-4o': {\n    inputPer1k: 0.0025,\n    outputPer1k: 0.01,\n    cachedInputPer1k: 0.00125,\n  },\n  'o4-mini': {\n    inputPer1k: 0.0011,\n    outputPer1k: 0.0044,\n    cachedInputPer1k: 0.000275,\n  },\n  o3: {\n    inputPer1k: 0.002,\n    outputPer1k: 0.008,\n    cachedInputPer1k: 0.0005,\n  },\n};\n\nexport function estimateTokenCost(\n  costUsd: number | null,\n  usage: UsageStats | null,\n  model: string | undefined,\n  tokenCosts: TokenCostTable = DEFAULT_TOKEN_COSTS\n): CostEstimate {\n  const inputTokens = usage?.inputTokens ?? 0;\n  const outputTokens = usage?.outputTokens ?? 0;\n\n  if (costUsd != null && costUsd > 0) {\n    return { usd: costUsd, inputTokens, outputTokens, source: 'reported' };\n  }\n  if (!usage || (inputTokens === 0 && outputTokens === 0) || !model) {\n    return { usd: 0, inputTokens, outputTokens, source: 'unknown' };\n  }\n\n  const rates = findTokenCostRates(model, tokenCosts);\n  if (!rates) {\n    return { usd: 0, inputTokens, outputTokens, source: 'unknown' };\n  }\n\n  const cachedInputTokens =\n    usage.cache?.cachedInputTokens ?? usage.cachedInputTokens ?? 0;\n  const cacheWriteTokens =\n    usage.cache?.cacheWriteTokens ?? usage.cacheWriteTokens ?? 0;\n  const uncachedInputTokens =\n    usage.cache?.uncachedInputTokens ??\n    Math.max(0, inputTokens - cachedInputTokens);\n\n  const writesByTtl = usage.cache?.cacheWriteTokensByTtl;\n  const oneHourWriteTokens = writesByTtl?.ephemeral1hInputTokens ?? 0;\n  const fiveMinuteWriteTokens = writesByTtl?.ephemeral5mInputTokens ?? 0;\n  const defaultWriteTokens = Math.max(\n    0,\n    cacheWriteTokens - oneHourWriteTokens - fiveMinuteWriteTokens\n  );\n\n  const inputCost =\n    (uncachedInputTokens / 1000) * rates.inputPer1k +\n    (cachedInputTokens / 1000) *\n      (rates.cachedInputPer1k ?? rates.inputPer1k) +\n    (fiveMinuteWriteTokens / 1000) *\n      (rates.cacheWritePer1k ?? rates.inputPer1k) +\n    (oneHourWriteTokens / 1000) *\n      (rates.cacheWrite1hPer1k ??\n        rates.cacheWritePer1k ??\n        rates.inputPer1k) +\n    (defaultWriteTokens / 1000) *\n      (rates.cacheWritePer1k ?? rates.inputPer1k);\n  const outputCost = (outputTokens / 1000) * rates.outputPer1k;\n\n  return {\n    usd: inputCost + outputCost,\n    inputTokens,\n    outputTokens,\n    source: 'estimated',\n  };\n}\n\nexport function findTokenCostRates(\n  model: string,\n  tokenCosts: TokenCostTable = DEFAULT_TOKEN_COSTS\n): TokenCostRates | null {\n  const lower = model.toLowerCase();\n  const matches = Object.entries(tokenCosts)\n    .filter(([key]) => lower.includes(key.toLowerCase()))\n    .sort(([a], [b]) => b.length - a.length);\n  return matches[0]?.[1] ?? null;\n}\n"],
+  "mappings": "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",
+  "names": []
+}

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

@@ -0,0 +1,24 @@
+import { OctoFlowError } from './base.js';
+/** Thrown when the agent returns an error result (is_error: true). */
+export declare class AgentRunError extends OctoFlowError {
+    readonly text: string;
+    readonly exitCode: number;
+    readonly backendName: string;
+    constructor(text: string, exitCode: number, backendName: string);
+}
+/** Thrown when the CLI process exceeds the configured timeoutMs. */
+export declare class AgentTimeoutError extends OctoFlowError {
+    readonly timeoutMs: number;
+    constructor(timeoutMs: number);
+}
+/** Thrown when a direct host command is blocked by the bridge safety policy. */
+export declare class UnsafeCommandError extends OctoFlowError {
+    readonly command: string;
+    readonly reason: string;
+    constructor(command: string, reason: string);
+}
+/** Thrown when an SSH connection or remote exec channel fails. */
+export declare class SshConnectionError extends OctoFlowError {
+    constructor(message: string);
+}
+//# sourceMappingURL=agent.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"agent.d.ts","sourceRoot":"","sources":["../../../src/domain/errors/agent.ts"],"names":[],"mappings":"AAAA,OAAO,EAGL,aAAa,EAEd,MAAM,WAAW,CAAC;AAEnB,sEAAsE;AACtE,qBAAa,aAAc,SAAQ,aAAa;IAC9C,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAC;IACtB,QAAQ,CAAC,QAAQ,EAAE,MAAM,CAAC;IAC1B,QAAQ,CAAC,WAAW,EAAE,MAAM,CAAC;gBAEjB,IAAI,EAAE,MAAM,EAAE,QAAQ,EAAE,MAAM,EAAE,WAAW,EAAE,MAAM;CAWhE;AAWD,oEAAoE;AACpE,qBAAa,iBAAkB,SAAQ,aAAa;IAClD,QAAQ,CAAC,SAAS,EAAE,MAAM,CAAC;gBAEf,SAAS,EAAE,MAAM;CAO9B;AAMD,gFAAgF;AAChF,qBAAa,kBAAmB,SAAQ,aAAa;IACnD,QAAQ,CAAC,OAAO,EAAE,MAAM,CAAC;IACzB,QAAQ,CAAC,MAAM,EAAE,MAAM,CAAC;gBAEZ,OAAO,EAAE,MAAM,EAAE,MAAM,EAAE,MAAM;CAS5C;AAUD,kEAAkE;AAClE,qBAAa,kBAAmB,SAAQ,aAAa;gBACvC,OAAO,EAAE,MAAM;CAI5B"}