octoflow-core 1.0.0

package/dist/domain/contracts/backends.d.ts

@@ -0,0 +1,360 @@
+import type { BackendCachingCapabilities, BackendInfo, BridgeProtocol } from '../protocol.js';
+import type { StructuredHistoryEntry } from '../shared.js';
+export type ExecutionRuntimePolicy = {
+    approvalMode: string;
+    backend: string;
+    executionMode: string;
+    filesystem: {
+        denyPaths: string[];
+        readableRoots: string[];
+        writableRoots: string[];
+    };
+    network: string;
+    profile: string;
+    sandbox: string;
+    workspace: string;
+};
+export type BackendCapabilities = {
+    streaming: boolean;
+    sessionPersistence: boolean;
+    workingDirectory: boolean;
+    forceMode: boolean;
+    systemPrompt: boolean;
+    planning: boolean;
+    tools: boolean;
+    /**
+     * Backend can enforce a final JSON-schema / structured-output contract for
+     * an agent response. Missing/false means callers should validate output in
+     * OctoFlow after the model responds instead of assuming provider enforcement.
+     */
+    structuredOutput?: boolean;
+    /**
+     * `true` means the CLI tool has native MCP awareness via its own config file
+     * (e.g. `~/.codex/config.toml` for Codex, the Cursor settings file for Cursor).
+     * It does NOT mean the bridge can inject a per-run MCP config via `mcpConfigPath`.
+     * Only `claude-code-cli` supports per-run injection through `--mcp-config`.
+     * For all other CLI backends, configure MCP servers in the tool's own config file.
+     */
+    mcp: boolean;
+    /**
+     * Backend accepts native structured message arrays (Anthropic/OpenAI-style
+     * `messages[]` with role + content parts). When `true`, callers should pass
+     * structured history instead of a text-stuffed replay prompt. Missing/false
+     * means the backend only consumes a flat prompt string.
+     */
+    structuredHistory?: boolean;
+    /**
+     * multimodal content support. When `true`, the backend supports all
+     * modalities the model handles. When a `string[]`, lists supported MIME
+     * prefixes (e.g. `['image/*', 'audio/*']`). Missing/false = text-only.
+     */
+    multimodal?: boolean | string[];
+    /**
+     * : prompt-cache markers the backend can emit given its declared
+     * protocol. Missing means "no caching declared" — callers treat it as the
+     * {@link BackendCachingCapabilities} default for the backend's protocol.
+     */
+    caching?: BackendCachingCapabilities;
+    /**
+     * Does this backend surface tool-approval decisions to the
+     * host `onToolApproval` callback? Missing is treated as `'flag-only'` (safe
+     * default — matches existing CLI backends without a programmatic channel).
+     *
+     * - `'supported'`    — in-process tool loop invokes `requestApproval`; the
+     *                      host callback has full decision authority.
+     * - `'safety-gate'`  — no callback; a deny-pattern pre-check runs on the
+     *                      spawned command (see `runtime/runner.ts` → `checkCommandSafety`).
+     *                      Conditionally active: only when `runtimePolicy.approvalMode !== 'off'`
+     *                      AND `runtimePolicy.backend === 'custom'`.
+     * - `'flag-only'`    — the real approval decision happens inside the
+     *                      child process via a vendor flag (e.g.
+     *                      `--permission-mode`, `--ask-for-approval`,
+     *                      `--approval-mode`). The host `onToolApproval`
+     *                      callback still fires on emitted `tool` events, but
+     *                      only as an OBSERVE-ONLY post-execution signal —
+     *                      returning `false` cannot prevent the tool from
+     *                      having already run.
+     * - `'transparent'`  — value is whatever the remote backend reports. `a2a`
+     *                      clients default to `'flag-only'` until the remote
+     *                      `BackendInfo` carries an explicit value.
+     */
+    approvalCallback?: 'supported' | 'safety-gate' | 'flag-only' | 'transparent';
+};
+import type { BridgeCacheControl, BridgeCacheOptions, Message, Part } from '../core-task.js';
+export type ApiJsonPrimitive = string | number | boolean | null;
+export type ApiJsonValue = ApiJsonPrimitive | ApiJsonValue[] | ApiJsonObject;
+export type ApiJsonObject = {
+    [key: string]: unknown;
+};
+export interface ManagedWorktreeOptions {
+    readonly name?: string;
+    readonly baseRef?: string;
+    readonly root?: string;
+    readonly cleanup?: 'always' | 'never';
+    readonly dirty?: 'copy' | 'fail' | 'ignore';
+    readonly reuse?: boolean;
+}
+export type BackendToolDef = {
+    name: string;
+    description?: string;
+    schema?: ApiJsonObject;
+};
+export type ApiBackendConfig = {
+    EXTRA_HEADERS?: Record<string, string>;
+};
+export type OpenAiApiBackendConfig = ApiBackendConfig & {
+    OPENAI_API_KEY?: string;
+    OPENAI_BASE_URL?: string;
+};
+export type GeminiApiBackendConfig = ApiBackendConfig & {
+    GEMINI_API_KEY?: string;
+    GEMINI_BASE_URL?: string;
+};
+export type AnthropicApiBackendConfig = ApiBackendConfig & {
+    ANTHROPIC_API_KEY?: string;
+    ANTHROPIC_BASE_URL?: string;
+    max_tokens?: number;
+    stop_sequences?: string[];
+    temperature?: number;
+    thinking?: ApiJsonObject;
+    top_k?: number;
+    top_p?: number;
+};
+export type EffortLevel = 'low' | 'medium' | 'high' | 'max';
+export type BackendRunCommonRequest = {
+    prompt: string;
+    /**
+     * structured user-turn parts for API backends that support multimodal
+     * content (images, audio, documents). When present, native builders should
+     * emit backend-specific content blocks from `FilePart` entries instead of
+     * relying solely on the flattened `prompt` string.
+     */
+    parts?: Part[];
+    sessionId?: string | null;
+    isResume?: boolean;
+    model?: string | null;
+    /**
+     * The model name as explicitly requested by the caller (`createAgent({ model })` or
+     * `sendMessage({ model })`). Undefined when the caller did not specify a model — the
+     * backend's own `defaultModel` was used to populate `model` above.
+     *
+     * CLI feature handlers should use this to decide whether to forward a `--model`
+     * flag: if undefined the CLI's own account-level default should be respected.
+     */
+    requestedModel?: string | null;
+    /**
+     * The model name read from the CLI's user-level config file at backend
+     * creation time (e.g. `model = "gpt-5.5"` in `~/.codex/config.toml`).
+     * Populated by the bridge only when such a config entry was found; otherwise
+     * null.
+     *
+     * CLI feature handlers may use this alongside `requestedModel` to decide
+     * which model flag to emit. Priority: `requestedModel` > `configModel` >
+     * backend hard-coded default.
+     */
+    configModel?: string | null;
+    maxOutputTokens?: number;
+    systemPrompt?: string | null;
+    mcpConfigPath?: string | null;
+    cwd?: string | null;
+    timeoutMs?: number;
+    signal?: AbortSignal;
+    runtimePolicy?: ExecutionRuntimePolicy | null;
+    /**
+     * Structured conversation history for API backends that support native
+     * `messages[]` arrays. When present, backends should prefer this over
+     * prompt-stuffing the conversation into the prompt string.
+     */
+    messages?: Message[];
+    /**
+     * Pre-normalized structured history as role/content pairs for API backends.
+     * API backends should prepend these to their messages array when present.
+     */
+    structuredHistory?: StructuredHistoryEntry[];
+};
+export type BackendRunCliFeatureRequest = {
+    /** Max dollar budget for this run. Backends that support native budget caps (e.g. claude --max-budget-usd) will enforce it. */
+    maxBudgetUsd?: number;
+    /** Effort level hint. Claude Code CLI maps this to `--effort`. Other CLIs ignore it. */
+    effort?: EffortLevel;
+    /** Run in an isolated git worktree. Boolean enables default name; string sets a custom worktree name. */
+    worktree?: boolean | string | ManagedWorktreeOptions;
+    /** Tool names the CLI is allowed to use. Claude Code CLI maps to `--allowedTools`. */
+    allowedTools?: string[];
+    /** Tool names the CLI must not use. Claude Code CLI maps to `--disallowedTools`. */
+    disallowedTools?: string[];
+    /** User-supplied env vars to include in the execution plan. */
+    env?: Record<string, string>;
+    /**
+     * Force read-only / planning mode at the CLI layer. Maps to:
+     *   - Claude:  --permission-mode plan
+     *   - Cursor:  --mode plan
+     *   - Codex:   --sandbox read-only
+     * API backends ignore this.
+     */
+    readOnly?: boolean;
+    /**
+     * JSON Schema describing the agent's final response shape. Maps to:
+     *   - Claude:  --json-schema <stringified>
+     *   - Codex:   --output-schema <tempfile>
+     * Object form will be JSON.stringify'd; pass a string to send as-is.
+     */
+    outputSchema?: object | string;
+    /**
+     * Claude-only: --append-system-prompt forwarded to the CLI in addition
+     * to (not replacing) the main 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 (improves prompt
+     * cache reuse across users by moving cwd/env/git into the first user msg).
+     */
+    excludeDynamicSystemPromptSections?: boolean;
+    /**
+     * Claude-only: --bare — minimal headless mode. Disables hooks, LSP, plugin
+     * sync, auto-memory, background prefetches, and keychain reads. Ideal for CI
+     * and scripted runs where startup speed matters more than full IDE features.
+     */
+    bare?: boolean;
+    /**
+     * When `true`, the prompt originates from the orchestrator (bridge action
+     * loop, Pack worker continuation) rather than a human turn. ACP/acpx backends
+     * forward this as `mode: 'steer'` on the prompt request, signalling to the
+     * agent that it should skip human-acknowledgement behavior.
+     */
+    isOrchestration?: boolean;
+    /**
+     * Codex-only: --ephemeral — run without persisting session files to disk.
+     * The session cannot be resumed after the run completes.
+     */
+    ephemeral?: boolean;
+    /**
+     * Codex-only: --skip-git-repo-check — allow running outside a git repository.
+     * Useful when the workspace is not a git repo.
+     */
+    skipGitRepoCheck?: boolean;
+    /**
+     * Gemini CLI: --policy — additional policy files or directories for the
+     * Gemini policy engine. Paths to `.policy` files or directories containing
+     * policy files. Multiple paths are each passed as separate `--policy` args.
+     */
+    policyFiles?: string[];
+    /**
+     * Gemini CLI: --allowed-mcp-server-names — restricts which MCP servers are
+     * activated for this run. Names must match the keys in `mcpServers` in the
+     * Gemini settings file.
+     */
+    allowedMcpServerNames?: string[];
+};
+export type BackendRunToolRequest = {
+    /**
+     * Tool definitions for API backends that support native `tools[]` in the
+     * request body. When present and the backend has `capabilities.tools: true`,
+     * the backend should include these in the API request instead of relying
+     * on prompt-based tool injection.
+     */
+    tools?: BackendToolDef[];
+};
+export type BackendRunCacheRequest = {
+    /**
+     * Structured system-prompt parts. When present, cache-aware
+     * builders emit a cache marker per part; backends that consume only the
+     * flat `systemPrompt` string ignore this field.
+     */
+    systemPromptParts?: Part[];
+    /**
+     * Prompt-cache configuration. Consumed by cache-aware native
+     * builders to decide which parts to mark and with what TTL.
+     */
+    cache?: BridgeCacheOptions;
+    /**
+     * Per-send cache override. Overrides the `cache` config for
+     * this single request.
+     */
+    cacheControl?: BridgeCacheControl;
+};
+export type BackendRunRequest = BackendRunCommonRequest & BackendRunCliFeatureRequest & BackendRunToolRequest & BackendRunCacheRequest;
+import type { ParsedEvent } from './messages.js';
+export type BackendExecuteOptions = {
+    onEvent?: (event: ParsedEvent) => void | Promise<void>;
+    signal?: AbortSignal;
+    env: Record<string, string>;
+    cwd?: string;
+    timeoutMs?: number;
+};
+export type BackendExecutionPlan = {
+    command?: string;
+    args?: string[];
+    env: Record<string, string>;
+    stdin: string;
+    cwd?: string;
+    parser: string;
+    /**
+     * Maximum ms to wait before killing the CLI process. When omitted, falls
+     * back to the bridge-level `timeoutMs` option and finally to the runner
+     * default (600_000 ms / 10 minutes).
+     */
+    timeoutMs?: number;
+    /**
+     * Used as a fallback when the stream parser does not emit an 'init' event
+     * (e.g. claude-code passes --session-id as a CLI arg, not in the output stream).
+     */
+    sessionId?: string;
+    runtimePolicy?: ExecutionRuntimePolicy;
+    execute?: (options: BackendExecuteOptions) => AsyncIterable<ParsedEvent>;
+    /**
+     * Optional post-execution cleanup. Implementations use this to delete
+     * temporary files written before spawning the CLI process (e.g. schema
+     * files written for --output-schema). Called in a finally block by
+     * runPreparedExecutionPlan after every run — success or failure.
+     */
+    cleanup?: () => Promise<void>;
+};
+export interface Backend {
+    name: string;
+    displayName: string;
+    /**
+     * : wire protocol spoken by this backend. Drives native-messages
+     * dispatch, cache-marker strategy, and telemetry labels. Required.
+     */
+    protocol: BridgeProtocol;
+    /**
+     * : free-form provider label for telemetry/logs (e.g. `'anthropic'`,
+     * `'openai'`, `'groq'`, `'xai'`, `'nebius'`). Optional — not used for
+     * dispatch.
+     */
+    provider?: string;
+    models: string[];
+    defaultModel: string;
+    /**
+     * Model discovered from the CLI's user config file (e.g. `~/.codex/config.toml`).
+     * Set by CLI backends only; undefined for API backends. Used by
+     * `buildAgentBackendRunRequest` to populate `BackendRunRequest.configModel`
+     * so CLI feature handlers can emit the right `--model` flag without
+     * confusing "user explicit" with "config-file default".
+     */
+    configModel?: string | null;
+    /** Context window size in tokens for the default model. */
+    contextWindow: number;
+    /** Max output tokens per request for the default model. */
+    maxOutputTokens: number;
+    canResume: boolean;
+    streamParserName: string;
+    capabilities: BackendCapabilities;
+    isInstalled(): Promise<boolean>;
+    getVersion(): Promise<string | null>;
+    validateModel(model: string): boolean;
+    generateSessionId(): string;
+    buildExecutionPlan(request: BackendRunRequest): BackendExecutionPlan;
+    extractSessionId(output: string): string | null;
+    /**
+     * : pure, synchronous snapshot of this backend's declared protocol,
+     * provider, resolved host/model, and capabilities. No I/O.
+     */
+    info(): BackendInfo;
+}
+//# sourceMappingURL=backends.d.ts.map

package/dist/domain/contracts/backends.d.ts.map

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

package/dist/domain/contracts/backends.js

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

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

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

package/dist/domain/contracts/cli-backends.d.ts

@@ -0,0 +1,77 @@
+import type { BackendCapabilities, BackendRunRequest, ExecutionRuntimePolicy } from './backends.js';
+/**
+ * Feature keys consumed by CLI backend descriptors. One key per neutral
+ * `BackendRunRequest` / policy concern; descriptors register a handler per
+ * feature they support. Missing key means the backend silently ignores that
+ * feature today — the matrix introspection turns those into warnings.
+ */
+export type CliFeatureKey = 'permission' | 'sandbox' | 'workspace' | 'extraDirs' | 'session' | 'streamFormat' | 'appendSystemPrompt' | 'excludeDynamicSystemPromptSections' | 'structuredSystemPrompt' | 'promptCache' | 'model' | 'effort' | 'worktree' | 'allowedTools' | 'disallowedTools' | 'mcp' | 'strictMcp' | 'outputSchema' | 'maxBudgetUsd' | 'webSearchHint' | 'stdinMarker' | 'bare' | 'ephemeral' | 'skipGitRepoCheck' | 'policy';
+/**
+ * Order in which the runner walks features. Codex relies on `--sandbox` being
+ * emitted before the `exec` subcommand — ordering is part of the contract.
+ */
+export declare const CLI_FEATURE_ORDER: readonly CliFeatureKey[];
+export interface CliFeatureContext {
+    request: BackendRunRequest;
+    policy: ExecutionRuntimePolicy | null | undefined;
+    /** Pre-resolved sanitized workspace (policy.workspace ?? request.cwd, sanitized). */
+    workspace: string | undefined;
+    /** Pre-resolved session id (request.sessionId ?? freshly generated). */
+    sessionId: string;
+    /** Pre-resolved sanitized cwd from request (independent of workspace). */
+    cwd: string | undefined;
+}
+/**
+ * What a feature handler may contribute to the final execution plan.
+ *
+ * - `globalArgs` are appended *before* the descriptor's optional subcommand
+ *   (Codex needs `--sandbox` etc. before `exec`).
+ * - `args` are appended *after* the subcommand.
+ * - `cwdOverride` lets a handler redirect the spawn cwd (Cursor's temp
+ *   workspace becomes the effective cwd).
+ * - `stdinOverride` replaces the default prompt envelope (Claude's initial
+ *   run sends the raw prompt as stdin; resume uses the envelope).
+ * - `cleanup` is appended to the plan's cleanup chain.
+ */
+export interface CliFeatureEmission {
+    globalArgs?: string[];
+    args?: string[];
+    cwdOverride?: string;
+    stdinOverride?: string;
+    cleanup?: () => Promise<void>;
+}
+export type CliFeatureHandler = (ctx: CliFeatureContext) => CliFeatureEmission | undefined;
+export interface CliBackendDescriptor {
+    /** Backend key — e.g. `'claude-code-cli'`. */
+    name: string;
+    /** Stream parser identifier (`'claude' | 'cursor' | 'codex'`). */
+    streamParserName: string;
+    /** Tokens emitted before any handler output. Cursor: `['-p','--trust','--approve-mcps']`. */
+    prelude?: readonly string[];
+    /** Subcommand inserted between globalArgs and args. Codex: `'exec'`. */
+    subcommand?: string;
+    /** Tokens emitted after all handler output. Stream-format flags live here. */
+    tail?: readonly string[];
+    /**
+     * If true, the prompt envelope (system + user) is the default stdin.
+     * If false, the raw `request.prompt` is the default stdin (Claude's initial run).
+     * A handler's `stdinOverride` always wins.
+     */
+    defaultStdinIsEnvelope: boolean;
+    /**
+     * Whether the returned `BackendExecutionPlan` carries a `sessionId`.
+     *
+     * - `'preserve-on-resume'`: on resume, return `request.sessionId ?? undefined`;
+     *   on a new run, return the freshly generated session id. Claude-like.
+     * - `'never'`: omit `sessionId` from the plan. Cursor/Codex generate session
+     *   ids inside the child process, so the plan does not surface one.
+     *
+     * Defaults to `'never'` when omitted.
+     */
+    planSessionIdStrategy?: 'preserve-on-resume' | 'never';
+    /** Static capability declaration — must agree with `features` keys (contract test). */
+    capabilities: BackendCapabilities;
+    /** Per-feature handlers. Omitted keys are silently ignored. */
+    features: Partial<Record<CliFeatureKey, CliFeatureHandler>>;
+}
+//# sourceMappingURL=cli-backends.d.ts.map

package/dist/domain/contracts/cli-backends.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"cli-backends.d.ts","sourceRoot":"","sources":["../../../src/domain/contracts/cli-backends.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EACV,mBAAmB,EACnB,iBAAiB,EACjB,sBAAsB,EACvB,MAAM,eAAe,CAAC;AAEvB;;;;;GAKG;AACH,MAAM,MAAM,aAAa,GACrB,YAAY,GACZ,SAAS,GACT,WAAW,GACX,WAAW,GACX,SAAS,GACT,cAAc,GACd,oBAAoB,GACpB,oCAAoC,GACpC,wBAAwB,GACxB,aAAa,GACb,OAAO,GACP,QAAQ,GACR,UAAU,GACV,cAAc,GACd,iBAAiB,GACjB,KAAK,GACL,WAAW,GACX,cAAc,GACd,cAAc,GACd,eAAe,GACf,aAAa,GACb,MAAM,GACN,WAAW,GACX,kBAAkB,GAClB,QAAQ,CAAC;AAEb;;;GAGG;AACH,eAAO,MAAM,iBAAiB,EAAE,SAAS,aAAa,EA0B5C,CAAC;AAEX,MAAM,WAAW,iBAAiB;IAChC,OAAO,EAAE,iBAAiB,CAAC;IAC3B,MAAM,EAAE,sBAAsB,GAAG,IAAI,GAAG,SAAS,CAAC;IAClD,qFAAqF;IACrF,SAAS,EAAE,MAAM,GAAG,SAAS,CAAC;IAC9B,wEAAwE;IACxE,SAAS,EAAE,MAAM,CAAC;IAClB,0EAA0E;IAC1E,GAAG,EAAE,MAAM,GAAG,SAAS,CAAC;CACzB;AAED;;;;;;;;;;;GAWG;AACH,MAAM,WAAW,kBAAkB;IACjC,UAAU,CAAC,EAAE,MAAM,EAAE,CAAC;IACtB,IAAI,CAAC,EAAE,MAAM,EAAE,CAAC;IAChB,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,aAAa,CAAC,EAAE,MAAM,CAAC;IACvB,OAAO,CAAC,EAAE,MAAM,OAAO,CAAC,IAAI,CAAC,CAAC;CAC/B;AAED,MAAM,MAAM,iBAAiB,GAAG,CAC9B,GAAG,EAAE,iBAAiB,KACnB,kBAAkB,GAAG,SAAS,CAAC;AAEpC,MAAM,WAAW,oBAAoB;IACnC,8CAA8C;IAC9C,IAAI,EAAE,MAAM,CAAC;IACb,kEAAkE;IAClE,gBAAgB,EAAE,MAAM,CAAC;IACzB,6FAA6F;IAC7F,OAAO,CAAC,EAAE,SAAS,MAAM,EAAE,CAAC;IAC5B,wEAAwE;IACxE,UAAU,CAAC,EAAE,MAAM,CAAC;IACpB,8EAA8E;IAC9E,IAAI,CAAC,EAAE,SAAS,MAAM,EAAE,CAAC;IACzB;;;;OAIG;IACH,sBAAsB,EAAE,OAAO,CAAC;IAChC;;;;;;;;;OASG;IACH,qBAAqB,CAAC,EAAE,oBAAoB,GAAG,OAAO,CAAC;IACvD,uFAAuF;IACvF,YAAY,EAAE,mBAAmB,CAAC;IAClC,+DAA+D;IAC/D,QAAQ,EAAE,OAAO,CAAC,MAAM,CAAC,aAAa,EAAE,iBAAiB,CAAC,CAAC,CAAC;CAC7D"}

package/dist/domain/contracts/cli-backends.js

@@ -0,0 +1,31 @@
+const CLI_FEATURE_ORDER = [
+  "permission",
+  "sandbox",
+  "workspace",
+  "extraDirs",
+  "webSearchHint",
+  "session",
+  "streamFormat",
+  "appendSystemPrompt",
+  "excludeDynamicSystemPromptSections",
+  "structuredSystemPrompt",
+  "promptCache",
+  "model",
+  "effort",
+  "worktree",
+  "allowedTools",
+  "disallowedTools",
+  "mcp",
+  "strictMcp",
+  "outputSchema",
+  "maxBudgetUsd",
+  "bare",
+  "ephemeral",
+  "skipGitRepoCheck",
+  "policy",
+  "stdinMarker"
+];
+export {
+  CLI_FEATURE_ORDER
+};
+//# sourceMappingURL=cli-backends.js.map

package/dist/domain/contracts/cli-backends.js.map

@@ -0,0 +1,7 @@
+{
+  "version": 3,
+  "sources": ["../../../src/domain/contracts/cli-backends.ts"],
+  "sourcesContent": ["import type {\n  BackendCapabilities,\n  BackendRunRequest,\n  ExecutionRuntimePolicy,\n} from './backends.js';\n\n/**\n * Feature keys consumed by CLI backend descriptors. One key per neutral\n * `BackendRunRequest` / policy concern; descriptors register a handler per\n * feature they support. Missing key means the backend silently ignores that\n * feature today \u2014 the matrix introspection turns those into warnings.\n */\nexport type CliFeatureKey =\n  | 'permission'\n  | 'sandbox'\n  | 'workspace'\n  | 'extraDirs'\n  | 'session'\n  | 'streamFormat'\n  | 'appendSystemPrompt'\n  | 'excludeDynamicSystemPromptSections'\n  | 'structuredSystemPrompt'\n  | 'promptCache'\n  | 'model'\n  | 'effort'\n  | 'worktree'\n  | 'allowedTools'\n  | 'disallowedTools'\n  | 'mcp'\n  | 'strictMcp'\n  | 'outputSchema'\n  | 'maxBudgetUsd'\n  | 'webSearchHint'\n  | 'stdinMarker'\n  | 'bare'\n  | 'ephemeral'\n  | 'skipGitRepoCheck'\n  | 'policy';\n\n/**\n * Order in which the runner walks features. Codex relies on `--sandbox` being\n * emitted before the `exec` subcommand \u2014 ordering is part of the contract.\n */\nexport const CLI_FEATURE_ORDER: readonly CliFeatureKey[] = [\n  'permission',\n  'sandbox',\n  'workspace',\n  'extraDirs',\n  'webSearchHint',\n  'session',\n  'streamFormat',\n  'appendSystemPrompt',\n  'excludeDynamicSystemPromptSections',\n  'structuredSystemPrompt',\n  'promptCache',\n  'model',\n  'effort',\n  'worktree',\n  'allowedTools',\n  'disallowedTools',\n  'mcp',\n  'strictMcp',\n  'outputSchema',\n  'maxBudgetUsd',\n  'bare',\n  'ephemeral',\n  'skipGitRepoCheck',\n  'policy',\n  'stdinMarker',\n] as const;\n\nexport interface CliFeatureContext {\n  request: BackendRunRequest;\n  policy: ExecutionRuntimePolicy | null | undefined;\n  /** Pre-resolved sanitized workspace (policy.workspace ?? request.cwd, sanitized). */\n  workspace: string | undefined;\n  /** Pre-resolved session id (request.sessionId ?? freshly generated). */\n  sessionId: string;\n  /** Pre-resolved sanitized cwd from request (independent of workspace). */\n  cwd: string | undefined;\n}\n\n/**\n * What a feature handler may contribute to the final execution plan.\n *\n * - `globalArgs` are appended *before* the descriptor's optional subcommand\n *   (Codex needs `--sandbox` etc. before `exec`).\n * - `args` are appended *after* the subcommand.\n * - `cwdOverride` lets a handler redirect the spawn cwd (Cursor's temp\n *   workspace becomes the effective cwd).\n * - `stdinOverride` replaces the default prompt envelope (Claude's initial\n *   run sends the raw prompt as stdin; resume uses the envelope).\n * - `cleanup` is appended to the plan's cleanup chain.\n */\nexport interface CliFeatureEmission {\n  globalArgs?: string[];\n  args?: string[];\n  cwdOverride?: string;\n  stdinOverride?: string;\n  cleanup?: () => Promise<void>;\n}\n\nexport type CliFeatureHandler = (\n  ctx: CliFeatureContext\n) => CliFeatureEmission | undefined;\n\nexport interface CliBackendDescriptor {\n  /** Backend key \u2014 e.g. `'claude-code-cli'`. */\n  name: string;\n  /** Stream parser identifier (`'claude' | 'cursor' | 'codex'`). */\n  streamParserName: string;\n  /** Tokens emitted before any handler output. Cursor: `['-p','--trust','--approve-mcps']`. */\n  prelude?: readonly string[];\n  /** Subcommand inserted between globalArgs and args. Codex: `'exec'`. */\n  subcommand?: string;\n  /** Tokens emitted after all handler output. Stream-format flags live here. */\n  tail?: readonly string[];\n  /**\n   * If true, the prompt envelope (system + user) is the default stdin.\n   * If false, the raw `request.prompt` is the default stdin (Claude's initial run).\n   * A handler's `stdinOverride` always wins.\n   */\n  defaultStdinIsEnvelope: boolean;\n  /**\n   * Whether the returned `BackendExecutionPlan` carries a `sessionId`.\n   *\n   * - `'preserve-on-resume'`: on resume, return `request.sessionId ?? undefined`;\n   *   on a new run, return the freshly generated session id. Claude-like.\n   * - `'never'`: omit `sessionId` from the plan. Cursor/Codex generate session\n   *   ids inside the child process, so the plan does not surface one.\n   *\n   * Defaults to `'never'` when omitted.\n   */\n  planSessionIdStrategy?: 'preserve-on-resume' | 'never';\n  /** Static capability declaration \u2014 must agree with `features` keys (contract test). */\n  capabilities: BackendCapabilities;\n  /** Per-feature handlers. Omitted keys are silently ignored. */\n  features: Partial<Record<CliFeatureKey, CliFeatureHandler>>;\n}\n"],
+  "mappings": "AA2CO,MAAM,oBAA8C;AAAA,EACzD;AAAA,EACA;AAAA,EACA;AAAA,EACA;AAAA,EACA;AAAA,EACA;AAAA,EACA;AAAA,EACA;AAAA,EACA;AAAA,EACA;AAAA,EACA;AAAA,EACA;AAAA,EACA;AAAA,EACA;AAAA,EACA;AAAA,EACA;AAAA,EACA;AAAA,EACA;AAAA,EACA;AAAA,EACA;AAAA,EACA;AAAA,EACA;AAAA,EACA;AAAA,EACA;AAAA,EACA;AACF;",
+  "names": []
+}

package/dist/domain/contracts/messages.d.ts

@@ -0,0 +1,121 @@
+import type { PromptCacheUsage } from '../prompt-cache.js';
+export type UsageStats = {
+    inputTokens: number;
+    outputTokens: number;
+    cachedInputTokens?: number;
+    cacheWriteTokens?: number;
+    cache?: PromptCacheUsage;
+};
+export declare function createUsage(inputTokens: number, outputTokens: number, opts?: {
+    cachedInputTokens?: number;
+    cacheWriteTokens?: number;
+    cache?: PromptCacheUsage;
+}): UsageStats;
+export type AgentEventType = 'text' | 'thinking' | 'thinking_start' | 'tool' | 'tool_call_result' | 'tool_call_stop' | 'result' | 'init' | 'input-required' | 'auth-required'
+/**
+ * Emitted by ACP backends when the agent sends a `config_option_update`
+ * notification mid-session (e.g. mode switch, new options unlocked).
+ * `ParsedEvent.configOptions` carries the full updated option list.
+ */
+ | 'agent-config-update'
+/** Surfaced when a parser fails to decode an upstream chunk. */
+ | 'parse_error';
+/**
+ * A single configuration option surfaced by an ACP agent.
+ * Matches the structure returned by `session/new` `configOptions` and
+ * live `config_option_update` notifications.
+ */
+export type ParsedConfigOption = {
+    id: string;
+    name: string;
+    description?: string | null;
+    type: 'select' | 'boolean';
+    currentValue: string;
+    options: {
+        value: string;
+        name: string;
+    }[];
+};
+/** A single file/line citation attached to a tool-call event. */
+export type ToolCallLocation = {
+    /** Absolute or workspace-relative URI of the file being referenced. */
+    uri: string;
+    range?: {
+        start: {
+            line: number;
+            character: number;
+        };
+        end?: {
+            line: number;
+            character: number;
+        };
+    };
+};
+export type ParsedEvent = {
+    type: AgentEventType;
+    text?: string;
+    name?: string;
+    icon?: string;
+    isError?: boolean;
+    usage?: UsageStats | null;
+    costUsd?: number | null;
+    sessionId?: string;
+    /**
+     * Identifier of the tool call this event refers to. Populated on
+     * `tool`, `tool_call_result`, and `tool_call_stop` events so UIs can
+     * correlate the request with its outcome. Optional for back-compat.
+     */
+    toolCallId?: string;
+    /**
+     * Parameters of the tool call, when `type === 'tool'` and the native
+     * backend payload carries them. Surfaces native arguments to MCP / A2A
+     * consumers without forcing a round-trip.
+     */
+    args?: Record<string, unknown>;
+    /** Raw upstream line that failed to parse. Present on `parse_error`. */
+    raw?: string;
+    /** Human-readable reason the parser bailed. Present on `parse_error`. */
+    reason?: string;
+    /** Backend name emitting this event. Present on `parse_error`. */
+    backend?: string;
+    /**
+     * Text stream classification for ACP/acpx backends.
+     * - `'output'`  — main agent reply (maps to `agent_message_chunk`)
+     * - `'thought'` — internal reasoning (maps to `agent_thought_chunk`)
+     * Present on `text` and `thinking` events emitted by protocol-aware backends.
+     */
+    stream?: 'output' | 'thought';
+    /**
+     * When `true` on a `parse_error` event, the upstream error is transient
+     * and the caller may safely retry the request. Populated by ACP/acpx
+     * backends from the wire `error.retryable` field.
+     */
+    retryable?: boolean;
+    /**
+     * File/line citations associated with a `tool` event.
+     * ACP/acpx backends populate this from `ToolCallLocation[]` emitted
+     * by the agent alongside tool-call notifications.
+     */
+    locations?: ToolCallLocation[];
+    /**
+     * Agent's declared reason for ending the turn. Present on `result`
+     * events from ACP/acpx backends (e.g. `'end_turn'`, `'max_tokens'`,
+     * `'tool_use'`, `'stop_sequence'`).
+     */
+    stopReason?: string;
+    /**
+     * Full updated config option list. Present on `agent-config-update` events
+     * emitted by ACP backends when the agent sends a `config_option_update`
+     * notification during a live session.
+     */
+    configOptions?: ParsedConfigOption[];
+};
+export interface StreamParser {
+    name: string;
+    toolIcons: Record<string, string>;
+    parseLine(line: string): ParsedEvent | null;
+    getToolIcon(name: string): string;
+}
+/** Build a `parse_error` event consistently across parsers. */
+export declare function parseError(backend: string, line: string, err: unknown): ParsedEvent;
+//# sourceMappingURL=messages.d.ts.map

package/dist/domain/contracts/messages.d.ts.map

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

package/dist/domain/contracts/messages.js

@@ -0,0 +1,22 @@
+function createUsage(inputTokens, outputTokens, opts) {
+  return {
+    inputTokens,
+    outputTokens,
+    ...opts?.cachedInputTokens ? { cachedInputTokens: opts.cachedInputTokens } : {},
+    ...opts?.cacheWriteTokens ? { cacheWriteTokens: opts.cacheWriteTokens } : {},
+    ...opts?.cache ? { cache: opts.cache } : {}
+  };
+}
+function parseError(backend, line, err) {
+  return {
+    type: "parse_error",
+    backend,
+    raw: line,
+    reason: err instanceof Error ? err.message : String(err)
+  };
+}
+export {
+  createUsage,
+  parseError
+};
+//# sourceMappingURL=messages.js.map