octoflow-core 1.0.0

package/dist/domain/contracts/messages.js.map

@@ -0,0 +1,7 @@
+{
+  "version": 3,
+  "sources": ["../../../src/domain/contracts/messages.ts"],
+  "sourcesContent": ["import type { PromptCacheUsage } from '../prompt-cache.js';\n\nexport type UsageStats = {\n  inputTokens: number;\n  outputTokens: number;\n  cachedInputTokens?: number;\n  cacheWriteTokens?: number;\n  cache?: PromptCacheUsage;\n};\n\nexport function createUsage(\n  inputTokens: number,\n  outputTokens: number,\n  opts?: {\n    cachedInputTokens?: number;\n    cacheWriteTokens?: number;\n    cache?: PromptCacheUsage;\n  }\n): UsageStats {\n  return {\n    inputTokens,\n    outputTokens,\n    ...(opts?.cachedInputTokens\n      ? { cachedInputTokens: opts.cachedInputTokens }\n      : {}),\n    ...(opts?.cacheWriteTokens\n      ? { cacheWriteTokens: opts.cacheWriteTokens }\n      : {}),\n    ...(opts?.cache ? { cache: opts.cache } : {}),\n  };\n}\nexport type AgentEventType =\n  | 'text'\n  | 'thinking'\n  | 'thinking_start'\n  | 'tool'\n  | 'tool_call_result'\n  | 'tool_call_stop'\n  | 'result'\n  | 'init'\n  | 'input-required'\n  | 'auth-required'\n  /**\n   * Emitted by ACP backends when the agent sends a `config_option_update`\n   * notification mid-session (e.g. mode switch, new options unlocked).\n   * `ParsedEvent.configOptions` carries the full updated option list.\n   */\n  | 'agent-config-update'\n  /** Surfaced when a parser fails to decode an upstream chunk. */\n  | 'parse_error';\n\n/**\n * A single configuration option surfaced by an ACP agent.\n * Matches the structure returned by `session/new` `configOptions` and\n * live `config_option_update` notifications.\n */\nexport type ParsedConfigOption = {\n  id: string;\n  name: string;\n  description?: string | null;\n  type: 'select' | 'boolean';\n  currentValue: string;\n  options: { value: string; name: string }[];\n};\n\n/** A single file/line citation attached to a tool-call event. */\nexport type ToolCallLocation = {\n  /** Absolute or workspace-relative URI of the file being referenced. */\n  uri: string;\n  range?: {\n    start: { line: number; character: number };\n    end?: { line: number; character: number };\n  };\n};\n\nexport type ParsedEvent = {\n  type: AgentEventType;\n  text?: string;\n  name?: string;\n  icon?: string;\n  isError?: boolean;\n  usage?: UsageStats | null;\n  costUsd?: number | null;\n  sessionId?: string;\n  /**\n   * Identifier of the tool call this event refers to. Populated on\n   * `tool`, `tool_call_result`, and `tool_call_stop` events so UIs can\n   * correlate the request with its outcome. Optional for back-compat.\n   */\n  toolCallId?: string;\n  /**\n   * Parameters of the tool call, when `type === 'tool'` and the native\n   * backend payload carries them. Surfaces native arguments to MCP / A2A\n   * consumers without forcing a round-trip.\n   */\n  args?: Record<string, unknown>;\n  /** Raw upstream line that failed to parse. Present on `parse_error`. */\n  raw?: string;\n  /** Human-readable reason the parser bailed. Present on `parse_error`. */\n  reason?: string;\n  /** Backend name emitting this event. Present on `parse_error`. */\n  backend?: string;\n  /**\n   * Text stream classification for ACP/acpx backends.\n   * - `'output'`  \u2014 main agent reply (maps to `agent_message_chunk`)\n   * - `'thought'` \u2014 internal reasoning (maps to `agent_thought_chunk`)\n   * Present on `text` and `thinking` events emitted by protocol-aware backends.\n   */\n  stream?: 'output' | 'thought';\n  /**\n   * When `true` on a `parse_error` event, the upstream error is transient\n   * and the caller may safely retry the request. Populated by ACP/acpx\n   * backends from the wire `error.retryable` field.\n   */\n  retryable?: boolean;\n  /**\n   * File/line citations associated with a `tool` event.\n   * ACP/acpx backends populate this from `ToolCallLocation[]` emitted\n   * by the agent alongside tool-call notifications.\n   */\n  locations?: ToolCallLocation[];\n  /**\n   * Agent's declared reason for ending the turn. Present on `result`\n   * events from ACP/acpx backends (e.g. `'end_turn'`, `'max_tokens'`,\n   * `'tool_use'`, `'stop_sequence'`).\n   */\n  stopReason?: string;\n  /**\n   * Full updated config option list. Present on `agent-config-update` events\n   * emitted by ACP backends when the agent sends a `config_option_update`\n   * notification during a live session.\n   */\n  configOptions?: ParsedConfigOption[];\n};\n\nexport interface StreamParser {\n  name: string;\n  toolIcons: Record<string, string>;\n  parseLine(line: string): ParsedEvent | null;\n  getToolIcon(name: string): string;\n}\n\n/** Build a `parse_error` event consistently across parsers. */\nexport function parseError(\n  backend: string,\n  line: string,\n  err: unknown\n): ParsedEvent {\n  return {\n    type: 'parse_error',\n    backend,\n    raw: line,\n    reason: err instanceof Error ? err.message : String(err),\n  };\n}\n"],
+  "mappings": "AAUO,SAAS,YACd,aACA,cACA,MAKY;AACZ,SAAO;AAAA,IACL;AAAA,IACA;AAAA,IACA,GAAI,MAAM,oBACN,EAAE,mBAAmB,KAAK,kBAAkB,IAC5C,CAAC;AAAA,IACL,GAAI,MAAM,mBACN,EAAE,kBAAkB,KAAK,iBAAiB,IAC1C,CAAC;AAAA,IACL,GAAI,MAAM,QAAQ,EAAE,OAAO,KAAK,MAAM,IAAI,CAAC;AAAA,EAC7C;AACF;AAiHO,SAAS,WACd,SACA,MACA,KACa;AACb,SAAO;AAAA,IACL,MAAM;AAAA,IACN;AAAA,IACA,KAAK;AAAA,IACL,QAAQ,eAAe,QAAQ,IAAI,UAAU,OAAO,GAAG;AAAA,EACzD;AACF;",
+  "names": []
+}

package/dist/domain/conversation.d.ts

@@ -0,0 +1,18 @@
+/** Canonical in-process conversation turn shapes shared by clients and sessions. */
+export interface AssistantUserTurn {
+    role: 'user' | 'assistant';
+    content: string;
+}
+export interface OllamaToolTurn {
+    role: 'user' | 'assistant' | 'tool';
+    content: string;
+    tool_calls?: Array<{
+        function: {
+            name: string;
+            arguments: unknown;
+        };
+    }>;
+    tool_name?: string;
+}
+export type ConversationTurn = AssistantUserTurn | OllamaToolTurn;
+//# sourceMappingURL=conversation.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"conversation.d.ts","sourceRoot":"","sources":["../../src/domain/conversation.ts"],"names":[],"mappings":"AAAA,oFAAoF;AACpF,MAAM,WAAW,iBAAiB;IAChC,IAAI,EAAE,MAAM,GAAG,WAAW,CAAC;IAC3B,OAAO,EAAE,MAAM,CAAC;CACjB;AAED,MAAM,WAAW,cAAc;IAC7B,IAAI,EAAE,MAAM,GAAG,WAAW,GAAG,MAAM,CAAC;IACpC,OAAO,EAAE,MAAM,CAAC;IAChB,UAAU,CAAC,EAAE,KAAK,CAAC;QAAE,QAAQ,EAAE;YAAE,IAAI,EAAE,MAAM,CAAC;YAAC,SAAS,EAAE,OAAO,CAAA;SAAE,CAAA;KAAE,CAAC,CAAC;IACvE,SAAS,CAAC,EAAE,MAAM,CAAC;CACpB;AAED,MAAM,MAAM,gBAAgB,GAAG,iBAAiB,GAAG,cAAc,CAAC"}

package/dist/domain/conversation.js

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

package/dist/domain/conversation.js.map

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

package/dist/domain/core-cache-types.d.ts

@@ -0,0 +1,36 @@
+export type CacheControl = {
+    type: 'ephemeral';
+    ttl?: '5m' | '1h';
+} | {
+    type: 'static';
+};
+/**
+ * Unified prompt-cache configuration. Enables cache markers on the
+ * stable prefix of the system prompt so cache-aware backends (Anthropic,
+ * OpenAI, Gemini) can reuse the prefix across turns.
+ */
+export interface BridgeCacheOptions {
+    /** Master switch. Default: `true`. */
+    enabled?: boolean;
+    /** Time-to-live for ephemeral cache entries. Default: `'5m'`. */
+    ttl?: '5m' | '1h';
+    /** OpenAI prompt-cache retention policy. Ignored by other backends. */
+    retention?: 'in_memory' | '24h';
+    /** Minimum characters a part must contain before it is cache-marked. Default: `1024`. */
+    minPartChars?: number;
+    /** Pack-only: include the leader/worker playbook in the cached prefix. Default: `true`. */
+    includePlaybooks?: boolean;
+    /** Include the tool-schema block in the cached prefix. Default: `true`. */
+    includeToolSchemas?: boolean;
+}
+/**
+ * Per-send override for cache scope. Overrides the bridge-level
+ * `cache` config for one request only.
+ */
+export interface BridgeCacheControl {
+    /** Scope to apply to the system prompt block. */
+    system?: 'ephemeral' | 'static';
+    /** Scope to apply to the tool-schema block. */
+    tools?: 'ephemeral' | 'static';
+}
+//# sourceMappingURL=core-cache-types.d.ts.map

package/dist/domain/core-cache-types.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"core-cache-types.d.ts","sourceRoot":"","sources":["../../src/domain/core-cache-types.ts"],"names":[],"mappings":"AAAA,MAAM,MAAM,YAAY,GACpB;IAAE,IAAI,EAAE,WAAW,CAAC;IAAC,GAAG,CAAC,EAAE,IAAI,GAAG,IAAI,CAAA;CAAE,GACxC;IAAE,IAAI,EAAE,QAAQ,CAAA;CAAE,CAAC;AAEvB;;;;GAIG;AACH,MAAM,WAAW,kBAAkB;IACjC,sCAAsC;IACtC,OAAO,CAAC,EAAE,OAAO,CAAC;IAClB,iEAAiE;IACjE,GAAG,CAAC,EAAE,IAAI,GAAG,IAAI,CAAC;IAClB,uEAAuE;IACvE,SAAS,CAAC,EAAE,WAAW,GAAG,KAAK,CAAC;IAChC,yFAAyF;IACzF,YAAY,CAAC,EAAE,MAAM,CAAC;IACtB,2FAA2F;IAC3F,gBAAgB,CAAC,EAAE,OAAO,CAAC;IAC3B,2EAA2E;IAC3E,kBAAkB,CAAC,EAAE,OAAO,CAAC;CAC9B;AAED;;;GAGG;AACH,MAAM,WAAW,kBAAkB;IACjC,iDAAiD;IACjD,MAAM,CAAC,EAAE,WAAW,GAAG,QAAQ,CAAC;IAChC,+CAA+C;IAC/C,KAAK,CAAC,EAAE,WAAW,GAAG,QAAQ,CAAC;CAChC"}

package/dist/domain/core-cache-types.js

@@ -0,0 +1 @@
+//# sourceMappingURL=core-cache-types.js.map

package/dist/domain/core-cache-types.js.map

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

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

@@ -0,0 +1,296 @@
+import type { AcpElicitationRequest, AcpElicitationResponse } from './acp-elicitation.js';
+import type { AgentEvent, StreamCallback } from './agent-event.js';
+import type { BackendOverrides, OctoFlowConfig, SerializedMcpOptions, SerializedMcpServerConfig, SerializedRoutingConfig, SerializedSkillConfig, SerializedToolConfig } from './config-contracts.js';
+import type { BackendToolDef, EffortLevel, ManagedWorktreeOptions } from './contracts/backends.js';
+import type { UsageStats } from './contracts/messages.js';
+import type { BackendName, BridgeApprovalMode, BridgeCacheControl, BridgeCacheOptions, BridgeExecutionMode, ErrorInfo, Message, Part, RetryInfo } from './core-task.js';
+import type { CostSource } from './cost-estimation.js';
+import type { AgentProcessRunner } from './process-runner.js';
+import type { BackendInfo, BackendType, LlmProvider } from './protocol.js';
+import type { StructuredHistoryEntry } from './shared.js';
+export type { AgentEvent, StreamCallback } from './agent-event.js';
+export type { EffortLevel, ManagedWorktreeOptions } from './contracts/backends.js';
+export type { AgentEventType } from './contracts/messages.js';
+/** Everything returned from a single non-streaming run. */
+export interface RunResult {
+    /** The final assistant text. */
+    text: string;
+    /** All parsed events in order. */
+    events: AgentEvent[];
+    /** Session ID returned by the CLI. Null if the backend doesn't expose one. */
+    sessionId: string | null;
+    /** Token counts if the backend reported them. */
+    usage: UsageStats | null;
+    /** Cost in USD if the backend reported it or OctoFlow estimated it. */
+    costUsd: number | null;
+    /** Whether `costUsd` came from the backend, OctoFlow estimation, or neither. */
+    costSource?: CostSource;
+    /** Raw exit code of the CLI process. */
+    exitCode: number;
+    /** Which backend was actually used. */
+    backend: BackendName;
+    /** Effective runtime policy for this execution. */
+    runtime?: {
+        approvalMode: BridgeApprovalMode;
+        executionMode: BridgeExecutionMode;
+        profile: string;
+        workspace: string | null;
+    } | null;
+}
+export type { UsageStats } from './contracts/messages.js';
+export interface AgentClientOptions {
+    backend: BackendName;
+    approvalMode?: BridgeApprovalMode;
+    config?: OctoFlowConfig;
+    model?: string;
+    systemPrompt?: string;
+    cwd?: string;
+    profile?: string;
+    timeoutMs?: number;
+    apiKey?: string;
+    /**
+     * Extra HTTP headers sent with every API request (e.g. gateway routing headers).
+     * Merged after the default Authorization / Content-Type headers; values here win on collision.
+     */
+    headers?: Record<string, string>;
+    /**
+     * Custom base URL for API backends (e.g. an OpenAI-compatible proxy).
+     * Maps to `OPENAI_BASE_URL` for openai-api or `ANTHROPIC_BASE_URL` for anthropic-api.
+     */
+    host?: string;
+    mcpConfigPath?: string;
+    skipInstallCheck?: boolean;
+    /** Retry failed runs up to N times with exponential back-off (default 0). */
+    retries?: number;
+    /**
+     * Pre-compaction input-token budget for this client (RFC-05). For
+     * `claude-code-cli` this is exported as `CLAUDE_CODE_MAX_CONTEXT_TOKENS`
+     * to the child process; other CLI/API backends ignore it. Per-call
+     * `RunOptions.maxContext` overrides this. `0` disables injection.
+     */
+    maxContext?: number;
+    /**
+     * Custom process runner for remote or sandboxed execution.
+     * Defaults to the local SpawnProcessRunner.
+     * Pass an SshProcessRunner to execute CLI agents on a remote host over SSH.
+     */
+    runner?: AgentProcessRunner;
+    /** Extra environment variables passed to backend processes. */
+    env?: Record<string, string>;
+    /** Default managed git worktree policy for runs that do not pass RunOptions.worktree. */
+    worktree?: boolean | string | ManagedWorktreeOptions;
+    /**
+     * Callback threaded into the `acp-cli` backend for interactive elicitation.
+     * Only relevant when `backend === 'acp-cli'`; ignored by all other backends.
+     */
+    onAcpElicitation?: (req: AcpElicitationRequest) => Promise<AcpElicitationResponse>;
+}
+export interface RunOptions {
+    approvalMode?: BridgeApprovalMode;
+    model?: string;
+    /**
+     * Per-call override of the pre-compaction input-token budget (RFC-05).
+     * Wins over the client/bridge-level `maxContext`. `0` disables injection.
+     */
+    maxContext?: number;
+    /**
+     * Per-call soft cap on the composed system-prompt sections (identity,
+     * instructions, MCP, tools, custom, …). When the total exceeds this
+     * cap, lower-priority non-protected sections are trimmed and a
+     * `bridge:warn` event with code `CONTEXT_SECTIONS_OVERFLOW` is emitted.
+     * Identity, instructions, tools, and guardrails are never trimmed.
+     * Wins over the client/bridge-level `maxSectionTokens`. `0` disables.
+     */
+    maxSectionTokens?: number;
+    maxOutputTokens?: number;
+    systemPrompt?: string;
+    cwd?: string;
+    onError?: (info: ErrorInfo) => void | Promise<void>;
+    onRetry?: (info: RetryInfo) => void | Promise<void>;
+    profile?: string;
+    signal?: AbortSignal;
+    timeoutMs?: number;
+    mcpConfigPath?: string;
+    retries?: number;
+    /** Base delay in ms for exponential back-off between retries. Default: 500. Per-call override of the bridge-level default. */
+    retryDelay?: number;
+    /** Max dollar budget for this run. Forwarded to backends that support native budget caps (e.g. claude --max-budget-usd). */
+    maxBudgetUsd?: number;
+    /** Effort level hint. Only Claude Code CLI supports this natively via `--effort`. */
+    effort?: EffortLevel;
+    /**
+     * Run this request in an isolated git worktree.
+     *
+     * `true` creates a temporary detached worktree, a string uses that value as
+     * the worktree directory name, and an object customizes base ref, location,
+     * cleanup, or reuse behavior.
+     */
+    worktree?: boolean | string | ManagedWorktreeOptions;
+    /** Tool names the CLI is allowed to use. Supported by Claude Code CLI (`--allowedTools`). */
+    allowedTools?: string[];
+    /** Tool names the CLI must not use. Supported by Claude Code CLI (`--disallowedTools`). */
+    disallowedTools?: string[];
+    /**
+     * Structured conversation history for API backends.
+     * When present, API clients prepend these messages to the request
+     * instead of injecting a plain-text transcript into the prompt.
+     */
+    structuredHistory?: StructuredHistoryEntry[];
+    /** Per-call environment variable overrides for the backend process. */
+    env?: Record<string, string>;
+    /**
+     * Force read-only / planning mode at the CLI layer. Cross-CLI shortcut:
+     *   - Claude:  --permission-mode plan
+     *   - Cursor:  --mode plan
+     *   - Codex:   --sandbox read-only
+     */
+    readOnly?: boolean;
+    /**
+     * JSON Schema for the agent's final response shape. Forwarded to:
+     *   - Claude:  --json-schema
+     *   - Codex:   --output-schema (written to a tempfile)
+     * Other CLIs ignore this.
+     */
+    outputSchema?: object | string;
+    /**
+     * Claude-only: --append-system-prompt (additional system prompt
+     * appended to the existing system prompt).
+     */
+    appendSystemPrompt?: string;
+    /**
+     * Claude-only: --strict-mcp-config (only use MCP servers from --mcp-config).
+     */
+    strictMcpConfig?: boolean;
+    /**
+     * Claude-only: --exclude-dynamic-system-prompt-sections (boost prompt
+     * cache reuse).
+     */
+    excludeDynamicSystemPromptSections?: boolean;
+    /**
+     * Structured system-prompt parts. Forwarded to cache-aware API
+     * backends; ignored by CLI backends that only accept the flat string.
+     */
+    systemPromptParts?: Part[];
+    /** Prompt-cache configuration. */
+    cache?: BridgeCacheOptions;
+    /** Per-call cache override. */
+    cacheControl?: BridgeCacheControl;
+    /**
+     * structured user-turn parts for multimodal content. API backends
+     * emit native content blocks (images, audio, documents) from `FilePart`
+     * entries. CLI backends ignore this and use the flattened prompt string.
+     */
+    parts?: Part[];
+    /**
+     * When `true`, signals to the backend that this prompt originates from the
+     * orchestrator (bridge action loop, Pack worker continuation) rather than
+     * a direct human turn. ACP/acpx backends forward this as `mode: 'steer'`
+     * on the `prompt` call; other backends ignore it.
+     */
+    isOrchestration?: boolean;
+}
+export interface SessionSendOptions extends RunOptions {
+    onEvent?: StreamCallback;
+    tools?: BackendToolDef[];
+}
+/**
+ * Options for creating a session via `client.session()`.
+ * Pass `resumeFrom` to restore a previously saved session by ID.
+ */
+export interface SessionOptions extends RunOptions {
+    /** Maximum number of conversation turns (user/assistant pairs) to keep for stateless history replay. */
+    maxHistory?: number;
+    /** Resume an existing backend session by ID (e.g. persisted to Redis, DB, or cookie). */
+    resumeFrom?: string;
+}
+/**
+ * Minimal interface satisfied by all octoflow client classes.
+ * Use this for polymorphic code that works with any backend.
+ */
+export interface Client {
+    run(prompt: string, opts?: RunOptions): Promise<RunResult>;
+    stream(prompt: string, onEvent: StreamCallback, opts?: RunOptions): Promise<RunResult>;
+    session(opts?: SessionOptions): ClientSession;
+    isReady(): Promise<boolean>;
+    /**
+     * : self-describing snapshot of this client's declared protocol,
+     * provider, resolved model/host, and capabilities. Async because some
+     * clients (e.g. `AgentClient`) need to resolve the underlying backend
+     * registry first. Optional for backwards compatibility — prefer `true` on
+     * all new clients.
+     */
+    info?(): Promise<BackendInfo> | BackendInfo;
+}
+/**
+ * Minimal interface satisfied by all session types (AgentSession, VercelAiSession, OllamaSession, CustomApiSession).
+ */
+export interface ClientSession {
+    send(prompt: string, opts?: SessionSendOptions): Promise<RunResult>;
+    stream(prompt: string, onEvent: StreamCallback, opts?: RunOptions): Promise<RunResult>;
+    readonly turns: number;
+    /** Current session ID. Null before the first send(). Not all implementations expose this. */
+    readonly id?: string | null;
+    /** True if this session was restored from a previously saved session ID. */
+    readonly isRestored?: boolean;
+    reset(): void;
+    injectHistory?(messages: Message[]): void;
+}
+export type { BackendName } from './core-task.js';
+export { BACKEND_NAME_SET, BACKEND_NAMES, isBackendName } from './core-task.js';
+export type { BackendType, LlmProvider } from './protocol.js';
+export interface BackendClassification {
+    backendType: BackendType;
+    nativeTools: boolean;
+    nativeMcp: boolean;
+    needsWrapper: boolean;
+}
+/**
+ * Options for local backend selection and config resolution.
+ */
+export interface ProxyOptions {
+    config?: OctoFlowConfig;
+    /** Skip loading OCTOFLOW_CONFIG, project config, and ~/.octoflow/config.json. */
+    ignoreFileConfig?: boolean;
+    /** Config-selected architecture. `createAgent()` consumes this; `createBridge()` ignores it. */
+    agentType?: string;
+    /**
+     * Ordered priority list. First ready backend wins.
+     * Default: ['claude-code-cli', 'codex-cli', 'cursor-cli', 'anthropic-api', 'openai-api', 'vercel-ai:anthropic', 'vercel-ai:openai', 'vercel-ai:google', 'ollama']
+     */
+    priority?: BackendName[];
+    /** Smart routing shortcut used when `priority` is absent. */
+    llmProvider?: LlmProvider;
+    /** Smart runtime-family shortcut used when `priority` is absent. */
+    backendType?: BackendType;
+    /** API keys per backend or provider alias (`openai`, `anthropic`), alternative to env vars. */
+    apiKeys?: Partial<Record<BackendName | 'anthropic' | 'google' | 'openai', string>>;
+    profile?: string;
+    model?: string;
+    systemPrompt?: string;
+    cwd?: string;
+    timeoutMs?: number;
+    retries?: number;
+    /** Default managed git worktree policy from config file. Per-call worktree wins. */
+    worktree?: boolean | string | ManagedWorktreeOptions;
+    /** Default loop configuration from config file. Serializable subset of LoopConfig. */
+    loop?: Record<string, unknown>;
+    /** Default task configuration from config file. Serializable subset of TaskConfig. */
+    tasks?: Record<string, unknown>;
+    /** Serialized routing config from config file. */
+    routing?: SerializedRoutingConfig;
+    /** Environment variables forwarded to all backend executions. */
+    env?: Record<string, string>;
+    /** Path to an MCP config JSON file for CLI backends that support it. */
+    mcpConfigPath?: string;
+    /** MCP servers resolved from config file. Merged into BridgeOptions.mcpServers at bridge creation. */
+    mcpServers?: Record<string, SerializedMcpServerConfig>;
+    /** MCP loading options resolved from config file. */
+    mcpOptions?: SerializedMcpOptions;
+    /** Tool definitions, MCP servers for tool delivery, and allowedTools from config file. */
+    tools?: SerializedToolConfig;
+    /** Skill definitions resolved from config file. */
+    skills?: SerializedSkillConfig[];
+    /** Per-backend overrides from the active profile. */
+    backends?: Partial<Record<BackendName, BackendOverrides>>;
+}
+//# sourceMappingURL=core-client.d.ts.map

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

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

package/dist/domain/core-client.js

@@ -0,0 +1,7 @@
+import { BACKEND_NAME_SET, BACKEND_NAMES, isBackendName } from "./core-task.js";
+export {
+  BACKEND_NAMES,
+  BACKEND_NAME_SET,
+  isBackendName
+};
+//# sourceMappingURL=core-client.js.map

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

@@ -0,0 +1,7 @@
+{
+  "version": 3,
+  "sources": ["../../src/domain/core-client.ts"],
+  "sourcesContent": ["import type { AcpElicitationRequest, AcpElicitationResponse } from './acp-elicitation.js';\nimport type { AgentEvent, StreamCallback } from './agent-event.js';\nimport type {\n  BackendOverrides,\n  OctoFlowConfig,\n  SerializedMcpOptions,\n  SerializedMcpServerConfig,\n  SerializedRoutingConfig,\n  SerializedSkillConfig,\n  SerializedToolConfig,\n} from './config-contracts.js';\nimport type {\n  BackendToolDef,\n  EffortLevel,\n  ManagedWorktreeOptions,\n} from './contracts/backends.js';\nimport type { UsageStats } from './contracts/messages.js';\nimport type {\n  BackendName,\n  BridgeApprovalMode,\n  BridgeCacheControl,\n  BridgeCacheOptions,\n  BridgeExecutionMode,\n  ErrorInfo,\n  Message,\n  Part,\n  RetryInfo,\n} from './core-task.js';\nimport type { CostSource } from './cost-estimation.js';\nimport type { AgentProcessRunner } from './process-runner.js';\nimport type { BackendInfo, BackendType, LlmProvider } from './protocol.js';\nimport type { StructuredHistoryEntry } from './shared.js';\n\nexport type { AgentEvent, StreamCallback } from './agent-event.js';\nexport type { EffortLevel, ManagedWorktreeOptions } from './contracts/backends.js';\nexport type { AgentEventType } from './contracts/messages.js';\n\n/** Everything returned from a single non-streaming run. */\nexport interface RunResult {\n  /** The final assistant text. */\n  text: string;\n  /** All parsed events in order. */\n  events: AgentEvent[];\n  /** Session ID returned by the CLI. Null if the backend doesn't expose one. */\n  sessionId: string | null;\n  /** Token counts if the backend reported them. */\n  usage: UsageStats | null;\n  /** Cost in USD if the backend reported it or OctoFlow estimated it. */\n  costUsd: number | null;\n  /** Whether `costUsd` came from the backend, OctoFlow estimation, or neither. */\n  costSource?: CostSource;\n  /** Raw exit code of the CLI process. */\n  exitCode: number;\n  /** Which backend was actually used. */\n  backend: BackendName;\n  /** Effective runtime policy for this execution. */\n  runtime?: {\n    approvalMode: BridgeApprovalMode;\n    executionMode: BridgeExecutionMode;\n    profile: string;\n    workspace: string | null;\n  } | null;\n}\nexport type { UsageStats } from './contracts/messages.js';\nexport interface AgentClientOptions {\n  backend: BackendName;\n  approvalMode?: BridgeApprovalMode;\n  config?: OctoFlowConfig;\n  model?: string;\n  systemPrompt?: string;\n  cwd?: string;\n  profile?: string;\n  timeoutMs?: number;\n  apiKey?: string;\n  /**\n   * Extra HTTP headers sent with every API request (e.g. gateway routing headers).\n   * Merged after the default Authorization / Content-Type headers; values here win on collision.\n   */\n  headers?: Record<string, string>;\n  /**\n   * Custom base URL for API backends (e.g. an OpenAI-compatible proxy).\n   * Maps to `OPENAI_BASE_URL` for openai-api or `ANTHROPIC_BASE_URL` for anthropic-api.\n   */\n  host?: string;\n  mcpConfigPath?: string;\n  skipInstallCheck?: boolean;\n  /** Retry failed runs up to N times with exponential back-off (default 0). */\n  retries?: number;\n  /**\n   * Pre-compaction input-token budget for this client (RFC-05). For\n   * `claude-code-cli` this is exported as `CLAUDE_CODE_MAX_CONTEXT_TOKENS`\n   * to the child process; other CLI/API backends ignore it. Per-call\n   * `RunOptions.maxContext` overrides this. `0` disables injection.\n   */\n  maxContext?: number;\n  /**\n   * Custom process runner for remote or sandboxed execution.\n   * Defaults to the local SpawnProcessRunner.\n   * Pass an SshProcessRunner to execute CLI agents on a remote host over SSH.\n   */\n  runner?: AgentProcessRunner;\n  /** Extra environment variables passed to backend processes. */\n  env?: Record<string, string>;\n  /** Default managed git worktree policy for runs that do not pass RunOptions.worktree. */\n  worktree?: boolean | string | ManagedWorktreeOptions;\n  /**\n   * Callback threaded into the `acp-cli` backend for interactive elicitation.\n   * Only relevant when `backend === 'acp-cli'`; ignored by all other backends.\n   */\n  onAcpElicitation?: (req: AcpElicitationRequest) => Promise<AcpElicitationResponse>;\n}\n\nexport interface RunOptions {\n  approvalMode?: BridgeApprovalMode;\n  model?: string;\n  /**\n   * Per-call override of the pre-compaction input-token budget (RFC-05).\n   * Wins over the client/bridge-level `maxContext`. `0` disables injection.\n   */\n  maxContext?: number;\n  /**\n   * Per-call soft cap on the composed system-prompt sections (identity,\n   * instructions, MCP, tools, custom, \u2026). When the total exceeds this\n   * cap, lower-priority non-protected sections are trimmed and a\n   * `bridge:warn` event with code `CONTEXT_SECTIONS_OVERFLOW` is emitted.\n   * Identity, instructions, tools, and guardrails are never trimmed.\n   * Wins over the client/bridge-level `maxSectionTokens`. `0` disables.\n   */\n  maxSectionTokens?: number;\n  maxOutputTokens?: number;\n  systemPrompt?: string;\n  cwd?: string;\n  onError?: (info: ErrorInfo) => void | Promise<void>;\n  onRetry?: (info: RetryInfo) => void | Promise<void>;\n  profile?: string;\n  signal?: AbortSignal;\n  timeoutMs?: number;\n  mcpConfigPath?: string;\n  retries?: number;\n  /** Base delay in ms for exponential back-off between retries. Default: 500. Per-call override of the bridge-level default. */\n  retryDelay?: number;\n  /** Max dollar budget for this run. Forwarded to backends that support native budget caps (e.g. claude --max-budget-usd). */\n  maxBudgetUsd?: number;\n  /** Effort level hint. Only Claude Code CLI supports this natively via `--effort`. */\n  effort?: EffortLevel;\n  /**\n   * Run this request in an isolated git worktree.\n   *\n   * `true` creates a temporary detached worktree, a string uses that value as\n   * the worktree directory name, and an object customizes base ref, location,\n   * cleanup, or reuse behavior.\n   */\n  worktree?: boolean | string | ManagedWorktreeOptions;\n  /** Tool names the CLI is allowed to use. Supported by Claude Code CLI (`--allowedTools`). */\n  allowedTools?: string[];\n  /** Tool names the CLI must not use. Supported by Claude Code CLI (`--disallowedTools`). */\n  disallowedTools?: string[];\n  /**\n   * Structured conversation history for API backends.\n   * When present, API clients prepend these messages to the request\n   * instead of injecting a plain-text transcript into the prompt.\n   */\n  structuredHistory?: StructuredHistoryEntry[];\n  /** Per-call environment variable overrides for the backend process. */\n  env?: Record<string, string>;\n  /**\n   * Force read-only / planning mode at the CLI layer. Cross-CLI shortcut:\n   *   - Claude:  --permission-mode plan\n   *   - Cursor:  --mode plan\n   *   - Codex:   --sandbox read-only\n   */\n  readOnly?: boolean;\n  /**\n   * JSON Schema for the agent's final response shape. Forwarded to:\n   *   - Claude:  --json-schema\n   *   - Codex:   --output-schema (written to a tempfile)\n   * Other CLIs ignore this.\n   */\n  outputSchema?: object | string;\n  /**\n   * Claude-only: --append-system-prompt (additional system prompt\n   * appended to the existing system prompt).\n   */\n  appendSystemPrompt?: string;\n  /**\n   * Claude-only: --strict-mcp-config (only use MCP servers from --mcp-config).\n   */\n  strictMcpConfig?: boolean;\n  /**\n   * Claude-only: --exclude-dynamic-system-prompt-sections (boost prompt\n   * cache reuse).\n   */\n  excludeDynamicSystemPromptSections?: boolean;\n  /**\n   * Structured system-prompt parts. Forwarded to cache-aware API\n   * backends; ignored by CLI backends that only accept the flat string.\n   */\n  systemPromptParts?: Part[];\n  /** Prompt-cache configuration. */\n  cache?: BridgeCacheOptions;\n  /** Per-call cache override. */\n  cacheControl?: BridgeCacheControl;\n  /**\n   * structured user-turn parts for multimodal content. API backends\n   * emit native content blocks (images, audio, documents) from `FilePart`\n   * entries. CLI backends ignore this and use the flattened prompt string.\n   */\n  parts?: Part[];\n  /**\n   * When `true`, signals to the backend that this prompt originates from the\n   * orchestrator (bridge action loop, Pack worker continuation) rather than\n   * a direct human turn. ACP/acpx backends forward this as `mode: 'steer'`\n   * on the `prompt` call; other backends ignore it.\n   */\n  isOrchestration?: boolean;\n}\n\nexport interface SessionSendOptions extends RunOptions {\n  onEvent?: StreamCallback;\n  tools?: BackendToolDef[];\n}\n\n/**\n * Options for creating a session via `client.session()`.\n * Pass `resumeFrom` to restore a previously saved session by ID.\n */\nexport interface SessionOptions extends RunOptions {\n  /** Maximum number of conversation turns (user/assistant pairs) to keep for stateless history replay. */\n  maxHistory?: number;\n\n  /** Resume an existing backend session by ID (e.g. persisted to Redis, DB, or cookie). */\n  resumeFrom?: string;\n}\n/**\n * Minimal interface satisfied by all octoflow client classes.\n * Use this for polymorphic code that works with any backend.\n */\nexport interface Client {\n  run(prompt: string, opts?: RunOptions): Promise<RunResult>;\n  stream(\n    prompt: string,\n    onEvent: StreamCallback,\n    opts?: RunOptions\n  ): Promise<RunResult>;\n  session(opts?: SessionOptions): ClientSession;\n  isReady(): Promise<boolean>;\n  /**\n   * : self-describing snapshot of this client's declared protocol,\n   * provider, resolved model/host, and capabilities. Async because some\n   * clients (e.g. `AgentClient`) need to resolve the underlying backend\n   * registry first. Optional for backwards compatibility \u2014 prefer `true` on\n   * all new clients.\n   */\n  info?(): Promise<BackendInfo> | BackendInfo;\n}\n\n/**\n * Minimal interface satisfied by all session types (AgentSession, VercelAiSession, OllamaSession, CustomApiSession).\n */\nexport interface ClientSession {\n  send(prompt: string, opts?: SessionSendOptions): Promise<RunResult>;\n  stream(\n    prompt: string,\n    onEvent: StreamCallback,\n    opts?: RunOptions\n  ): Promise<RunResult>;\n  readonly turns: number;\n  /** Current session ID. Null before the first send(). Not all implementations expose this. */\n  readonly id?: string | null;\n  /** True if this session was restored from a previously saved session ID. */\n  readonly isRestored?: boolean;\n  reset(): void;\n  injectHistory?(messages: Message[]): void;\n}\nexport type { BackendName } from './core-task.js';\nexport { BACKEND_NAME_SET, BACKEND_NAMES, isBackendName } from './core-task.js';\nexport type { BackendType, LlmProvider } from './protocol.js';\n\nexport interface BackendClassification {\n  backendType: BackendType;\n  nativeTools: boolean;\n  nativeMcp: boolean;\n  needsWrapper: boolean;\n}\n/**\n * Options for local backend selection and config resolution.\n */\nexport interface ProxyOptions {\n  config?: OctoFlowConfig;\n  /** Skip loading OCTOFLOW_CONFIG, project config, and ~/.octoflow/config.json. */\n  ignoreFileConfig?: boolean;\n  /** Config-selected architecture. `createAgent()` consumes this; `createBridge()` ignores it. */\n  agentType?: string;\n  /**\n   * Ordered priority list. First ready backend wins.\n   * Default: ['claude-code-cli', 'codex-cli', 'cursor-cli', 'anthropic-api', 'openai-api', 'vercel-ai:anthropic', 'vercel-ai:openai', 'vercel-ai:google', 'ollama']\n   */\n  priority?: BackendName[];\n  /** Smart routing shortcut used when `priority` is absent. */\n  llmProvider?: LlmProvider;\n  /** Smart runtime-family shortcut used when `priority` is absent. */\n  backendType?: BackendType;\n  /** API keys per backend or provider alias (`openai`, `anthropic`), alternative to env vars. */\n  apiKeys?: Partial<\n    Record<BackendName | 'anthropic' | 'google' | 'openai', string>\n  >;\n  profile?: string;\n  model?: string;\n  systemPrompt?: string;\n  cwd?: string;\n  timeoutMs?: number;\n  retries?: number;\n  /** Default managed git worktree policy from config file. Per-call worktree wins. */\n  worktree?: boolean | string | ManagedWorktreeOptions;\n  /** Default loop configuration from config file. Serializable subset of LoopConfig. */\n  loop?: Record<string, unknown>;\n  /** Default task configuration from config file. Serializable subset of TaskConfig. */\n  tasks?: Record<string, unknown>;\n  /** Serialized routing config from config file. */\n  routing?: SerializedRoutingConfig;\n  /** Environment variables forwarded to all backend executions. */\n  env?: Record<string, string>;\n  /** Path to an MCP config JSON file for CLI backends that support it. */\n  mcpConfigPath?: string;\n  /** MCP servers resolved from config file. Merged into BridgeOptions.mcpServers at bridge creation. */\n  mcpServers?: Record<string, SerializedMcpServerConfig>;\n  /** MCP loading options resolved from config file. */\n  mcpOptions?: SerializedMcpOptions;\n  /** Tool definitions, MCP servers for tool delivery, and allowedTools from config file. */\n  tools?: SerializedToolConfig;\n  /** Skill definitions resolved from config file. */\n  skills?: SerializedSkillConfig[];\n  /** Per-backend overrides from the active profile. */\n  backends?: Partial<Record<BackendName, BackendOverrides>>;\n}\n"],
+  "mappings": "AAmRA,SAAS,kBAAkB,eAAe,qBAAqB;",
+  "names": []
+}