octoflow-core 1.0.0

package/dist/adapters/agents/agent-session-client.js

@@ -0,0 +1 @@
+//# sourceMappingURL=agent-session-client.js.map

package/dist/adapters/agents/agent-session-client.js.map

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

package/dist/adapters/agents/agent-session.d.ts

@@ -0,0 +1,66 @@
+import type { ClientSession, RunResult, SessionOptions, SessionSendOptions, StreamCallback } from '../../domain/core-client.js';
+import type { AgentSessionClient } from './agent-session-client.js';
+import { type InjectableHistoryEntry } from './session-history.js';
+/**
+ * Stateful multi-turn conversation session.
+ * Created via `client.session()` — do not instantiate directly.
+ *
+ * Backends with native session persistence (`sessionPersistence: true`,
+ * e.g. claude-code-cli, codex-cli, cursor-cli) thread context
+ * server-side via `sessionId` + `--resume`.
+ *
+ * Backends without native session persistence (`sessionPersistence: false`,
+ * e.g. anthropic-api, openai-api) are stateless per request. For those this
+ * session keeps an in-memory transcript and replays it as `structuredHistory`
+ * on every turn so that conversations remain coherent.
+ *
+ * @example
+ * const session = client.session();
+ * const r1 = await session.send('What is 2+2?');
+ * const r2 = await session.send('Multiply that by 3'); // resumes same context
+ * session.reset();
+ *
+ * @example
+ * // Restore a previously saved session across requests/processes:
+ * const resumed = client.session({ resumeFrom: savedSessionId });
+ * await resumed.send('Continue from where we left off'); // isResume=true
+ */
+export declare class AgentSession implements ClientSession {
+    private readonly client;
+    private readonly defaultOpts?;
+    private _sessionId;
+    private _turnCount;
+    private _wasRestored;
+    private _history;
+    private _replayHistory;
+    private readonly maxHistory;
+    /** @internal */
+    constructor(client: AgentSessionClient, defaultOpts?: SessionOptions | undefined);
+    /**
+     * Send a message. First call starts a new session; subsequent calls resume it.
+     * On a restored session the first send is also treated as a resume.
+     */
+    send(prompt: string, opts?: SessionSendOptions): Promise<RunResult>;
+    /**
+     * Convenience alias — stream this turn's events in real time.
+     */
+    stream(prompt: string, onEvent: StreamCallback, opts?: SessionOptions): Promise<RunResult>;
+    /** Current session ID. Null before the first send() on a fresh session. */
+    get id(): string | null;
+    /** Number of turns sent so far. */
+    get turns(): number;
+    /** True if this session was restored via `resumeFrom`. */
+    get isRestored(): boolean;
+    /** Reset — the next send() will start a fresh session. */
+    reset(): void;
+    /**
+     * Seed this session with prior conversation history. Useful when restoring
+     * a transcript across processes for stateless API backends. A no-op on
+     * backends with native session persistence (`sessionPersistence: true`),
+     * which thread context server-side via `resumeFrom`.
+     */
+    injectHistory(messages: InjectableHistoryEntry[]): void;
+    private trimHistory;
+    private _shouldReplayHistory;
+}
+//# sourceMappingURL=agent-session.d.ts.map

package/dist/adapters/agents/agent-session.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"agent-session.d.ts","sourceRoot":"","sources":["../../../src/adapters/agents/agent-session.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EACV,aAAa,EACb,SAAS,EACT,cAAc,EACd,kBAAkB,EAClB,cAAc,EACf,MAAM,6BAA6B,CAAC;AAErC,OAAO,KAAK,EAAE,kBAAkB,EAAE,MAAM,2BAA2B,CAAC;AACpE,OAAO,EACL,KAAK,sBAAsB,EAE5B,MAAM,sBAAsB,CAAC;AAE9B;;;;;;;;;;;;;;;;;;;;;;;GAuBG;AACH,qBAAa,YAAa,YAAW,aAAa;IAU9C,OAAO,CAAC,QAAQ,CAAC,MAAM;IACvB,OAAO,CAAC,QAAQ,CAAC,WAAW,CAAC;IAV/B,OAAO,CAAC,UAAU,CAAuB;IACzC,OAAO,CAAC,UAAU,CAAK;IACvB,OAAO,CAAC,YAAY,CAAS;IAC7B,OAAO,CAAC,QAAQ,CAAgC;IAChD,OAAO,CAAC,cAAc,CAAwB;IAC9C,OAAO,CAAC,QAAQ,CAAC,UAAU,CAAqB;IAEhD,gBAAgB;gBAEG,MAAM,EAAE,kBAAkB,EAC1B,WAAW,CAAC,EAAE,cAAc,YAAA;IAS/C;;;OAGG;IACG,IAAI,CAAC,MAAM,EAAE,MAAM,EAAE,IAAI,CAAC,EAAE,kBAAkB,GAAG,OAAO,CAAC,SAAS,CAAC;IAkCzE;;OAEG;IACG,MAAM,CACV,MAAM,EAAE,MAAM,EACd,OAAO,EAAE,cAAc,EACvB,IAAI,CAAC,EAAE,cAAc,GACpB,OAAO,CAAC,SAAS,CAAC;IAIrB,2EAA2E;IAC3E,IAAI,EAAE,IAAI,MAAM,GAAG,IAAI,CAEtB;IAED,mCAAmC;IACnC,IAAI,KAAK,IAAI,MAAM,CAElB;IAED,0DAA0D;IAC1D,IAAI,UAAU,IAAI,OAAO,CAExB;IAED,0DAA0D;IAC1D,KAAK,IAAI,IAAI;IAOb;;;;;OAKG;IACH,aAAa,CAAC,QAAQ,EAAE,sBAAsB,EAAE,GAAG,IAAI;IAOvD,OAAO,CAAC,WAAW;YAML,oBAAoB;CAUnC"}

package/dist/adapters/agents/agent-session.js

@@ -0,0 +1,111 @@
+import {
+  injectedHistoryToTurns
+} from "./session-history.js";
+class AgentSession {
+  /** @internal */
+  constructor(client, defaultOpts) {
+    this.client = client;
+    this.defaultOpts = defaultOpts;
+    this.maxHistory = defaultOpts?.maxHistory;
+    if (defaultOpts?.resumeFrom) {
+      this._sessionId = defaultOpts.resumeFrom;
+      this._wasRestored = true;
+    }
+  }
+  client;
+  defaultOpts;
+  _sessionId = null;
+  _turnCount = 0;
+  _wasRestored = false;
+  _history = [];
+  _replayHistory = null;
+  maxHistory;
+  /**
+   * Send a message. First call starts a new session; subsequent calls resume it.
+   * On a restored session the first send is also treated as a resume.
+   */
+  async send(prompt, opts) {
+    const isResume = this._wasRestored || this._turnCount > 0;
+    const merged = { ...this.defaultOpts, ...opts };
+    const replay = await this._shouldReplayHistory();
+    if (replay) {
+      const userPrefix = merged.structuredHistory ?? [];
+      merged.structuredHistory = [...userPrefix, ...this._history];
+    }
+    const result = await this.client._runWithSession(
+      prompt,
+      this._sessionId,
+      isResume,
+      opts?.onEvent,
+      merged
+    );
+    if (!isResume && result.sessionId) {
+      this._sessionId = result.sessionId;
+    }
+    if (replay) {
+      this._history.push(
+        { role: "user", content: prompt },
+        { role: "assistant", content: result.text }
+      );
+      this.trimHistory();
+    }
+    this._turnCount++;
+    return result;
+  }
+  /**
+   * Convenience alias — stream this turn's events in real time.
+   */
+  async stream(prompt, onEvent, opts) {
+    return this.send(prompt, { ...opts, onEvent });
+  }
+  /** Current session ID. Null before the first send() on a fresh session. */
+  get id() {
+    return this._sessionId;
+  }
+  /** Number of turns sent so far. */
+  get turns() {
+    return this._turnCount;
+  }
+  /** True if this session was restored via `resumeFrom`. */
+  get isRestored() {
+    return this._wasRestored;
+  }
+  /** Reset — the next send() will start a fresh session. */
+  reset() {
+    this._sessionId = null;
+    this._turnCount = 0;
+    this._wasRestored = false;
+    this._history = [];
+  }
+  /**
+   * Seed this session with prior conversation history. Useful when restoring
+   * a transcript across processes for stateless API backends. A no-op on
+   * backends with native session persistence (`sessionPersistence: true`),
+   * which thread context server-side via `resumeFrom`.
+   */
+  injectHistory(messages) {
+    for (const turn of injectedHistoryToTurns(messages)) {
+      this._history.push({ role: turn.role, content: turn.content });
+    }
+    this.trimHistory();
+  }
+  trimHistory() {
+    if (this.maxHistory != null && this._history.length > this.maxHistory * 2) {
+      this._history = this._history.slice(-this.maxHistory * 2);
+    }
+  }
+  async _shouldReplayHistory() {
+    if (this._replayHistory !== null) return this._replayHistory;
+    try {
+      const capabilities = await this.client._capabilities();
+      this._replayHistory = capabilities.sessionPersistence === false;
+    } catch {
+      this._replayHistory = false;
+    }
+    return this._replayHistory;
+  }
+}
+export {
+  AgentSession
+};
+//# sourceMappingURL=agent-session.js.map

package/dist/adapters/agents/agent-session.js.map

@@ -0,0 +1,7 @@
+{
+  "version": 3,
+  "sources": ["../../../src/adapters/agents/agent-session.ts"],
+  "sourcesContent": ["import type {\n  ClientSession,\n  RunResult,\n  SessionOptions,\n  SessionSendOptions,\n  StreamCallback,\n} from '../../domain/core-client.js';\nimport type { StructuredHistoryEntry } from '../../domain/shared.js';\nimport type { AgentSessionClient } from './agent-session-client.js';\nimport {\n  type InjectableHistoryEntry,\n  injectedHistoryToTurns,\n} from './session-history.js';\n\n/**\n * Stateful multi-turn conversation session.\n * Created via `client.session()` \u2014 do not instantiate directly.\n *\n * Backends with native session persistence (`sessionPersistence: true`,\n * e.g. claude-code-cli, codex-cli, cursor-cli) thread context\n * server-side via `sessionId` + `--resume`.\n *\n * Backends without native session persistence (`sessionPersistence: false`,\n * e.g. anthropic-api, openai-api) are stateless per request. For those this\n * session keeps an in-memory transcript and replays it as `structuredHistory`\n * on every turn so that conversations remain coherent.\n *\n * @example\n * const session = client.session();\n * const r1 = await session.send('What is 2+2?');\n * const r2 = await session.send('Multiply that by 3'); // resumes same context\n * session.reset();\n *\n * @example\n * // Restore a previously saved session across requests/processes:\n * const resumed = client.session({ resumeFrom: savedSessionId });\n * await resumed.send('Continue from where we left off'); // isResume=true\n */\nexport class AgentSession implements ClientSession {\n  private _sessionId: string | null = null;\n  private _turnCount = 0;\n  private _wasRestored = false;\n  private _history: StructuredHistoryEntry[] = [];\n  private _replayHistory: boolean | null = null;\n  private readonly maxHistory: number | undefined;\n\n  /** @internal */\n  constructor(\n    private readonly client: AgentSessionClient,\n    private readonly defaultOpts?: SessionOptions\n  ) {\n    this.maxHistory = defaultOpts?.maxHistory;\n    if (defaultOpts?.resumeFrom) {\n      this._sessionId = defaultOpts.resumeFrom;\n      this._wasRestored = true;\n    }\n  }\n\n  /**\n   * Send a message. First call starts a new session; subsequent calls resume it.\n   * On a restored session the first send is also treated as a resume.\n   */\n  async send(prompt: string, opts?: SessionSendOptions): Promise<RunResult> {\n    const isResume = this._wasRestored || this._turnCount > 0;\n    const merged: SessionOptions = { ...this.defaultOpts, ...opts };\n\n    const replay = await this._shouldReplayHistory();\n    if (replay) {\n      const userPrefix = merged.structuredHistory ?? [];\n      merged.structuredHistory = [...userPrefix, ...this._history];\n    }\n\n    const result = await this.client._runWithSession(\n      prompt,\n      this._sessionId,\n      isResume,\n      opts?.onEvent,\n      merged\n    );\n\n    if (!isResume && result.sessionId) {\n      this._sessionId = result.sessionId;\n    }\n\n    if (replay) {\n      this._history.push(\n        { role: 'user', content: prompt },\n        { role: 'assistant', content: result.text }\n      );\n      this.trimHistory();\n    }\n\n    this._turnCount++;\n    return result;\n  }\n\n  /**\n   * Convenience alias \u2014 stream this turn's events in real time.\n   */\n  async stream(\n    prompt: string,\n    onEvent: StreamCallback,\n    opts?: SessionOptions\n  ): Promise<RunResult> {\n    return this.send(prompt, { ...opts, onEvent });\n  }\n\n  /** Current session ID. Null before the first send() on a fresh session. */\n  get id(): string | null {\n    return this._sessionId;\n  }\n\n  /** Number of turns sent so far. */\n  get turns(): number {\n    return this._turnCount;\n  }\n\n  /** True if this session was restored via `resumeFrom`. */\n  get isRestored(): boolean {\n    return this._wasRestored;\n  }\n\n  /** Reset \u2014 the next send() will start a fresh session. */\n  reset(): void {\n    this._sessionId = null;\n    this._turnCount = 0;\n    this._wasRestored = false;\n    this._history = [];\n  }\n\n  /**\n   * Seed this session with prior conversation history. Useful when restoring\n   * a transcript across processes for stateless API backends. A no-op on\n   * backends with native session persistence (`sessionPersistence: true`),\n   * which thread context server-side via `resumeFrom`.\n   */\n  injectHistory(messages: InjectableHistoryEntry[]): void {\n    for (const turn of injectedHistoryToTurns(messages)) {\n      this._history.push({ role: turn.role, content: turn.content });\n    }\n    this.trimHistory();\n  }\n\n  private trimHistory(): void {\n    if (this.maxHistory != null && this._history.length > this.maxHistory * 2) {\n      this._history = this._history.slice(-this.maxHistory * 2);\n    }\n  }\n\n  private async _shouldReplayHistory(): Promise<boolean> {\n    if (this._replayHistory !== null) return this._replayHistory;\n    try {\n      const capabilities = await this.client._capabilities();\n      this._replayHistory = capabilities.sessionPersistence === false;\n    } catch {\n      this._replayHistory = false;\n    }\n    return this._replayHistory;\n  }\n}\n"],
+  "mappings": "AASA;AAAA,EAEE;AAAA,OACK;AA0BA,MAAM,aAAsC;AAAA;AAAA,EASjD,YACmB,QACA,aACjB;AAFiB;AACA;AAEjB,SAAK,aAAa,aAAa;AAC/B,QAAI,aAAa,YAAY;AAC3B,WAAK,aAAa,YAAY;AAC9B,WAAK,eAAe;AAAA,IACtB;AAAA,EACF;AAAA,EARmB;AAAA,EACA;AAAA,EAVX,aAA4B;AAAA,EAC5B,aAAa;AAAA,EACb,eAAe;AAAA,EACf,WAAqC,CAAC;AAAA,EACtC,iBAAiC;AAAA,EACxB;AAAA;AAAA;AAAA;AAAA;AAAA,EAkBjB,MAAM,KAAK,QAAgB,MAA+C;AACxE,UAAM,WAAW,KAAK,gBAAgB,KAAK,aAAa;AACxD,UAAM,SAAyB,EAAE,GAAG,KAAK,aAAa,GAAG,KAAK;AAE9D,UAAM,SAAS,MAAM,KAAK,qBAAqB;AAC/C,QAAI,QAAQ;AACV,YAAM,aAAa,OAAO,qBAAqB,CAAC;AAChD,aAAO,oBAAoB,CAAC,GAAG,YAAY,GAAG,KAAK,QAAQ;AAAA,IAC7D;AAEA,UAAM,SAAS,MAAM,KAAK,OAAO;AAAA,MAC/B;AAAA,MACA,KAAK;AAAA,MACL;AAAA,MACA,MAAM;AAAA,MACN;AAAA,IACF;AAEA,QAAI,CAAC,YAAY,OAAO,WAAW;AACjC,WAAK,aAAa,OAAO;AAAA,IAC3B;AAEA,QAAI,QAAQ;AACV,WAAK,SAAS;AAAA,QACZ,EAAE,MAAM,QAAQ,SAAS,OAAO;AAAA,QAChC,EAAE,MAAM,aAAa,SAAS,OAAO,KAAK;AAAA,MAC5C;AACA,WAAK,YAAY;AAAA,IACnB;AAEA,SAAK;AACL,WAAO;AAAA,EACT;AAAA;AAAA;AAAA;AAAA,EAKA,MAAM,OACJ,QACA,SACA,MACoB;AACpB,WAAO,KAAK,KAAK,QAAQ,EAAE,GAAG,MAAM,QAAQ,CAAC;AAAA,EAC/C;AAAA;AAAA,EAGA,IAAI,KAAoB;AACtB,WAAO,KAAK;AAAA,EACd;AAAA;AAAA,EAGA,IAAI,QAAgB;AAClB,WAAO,KAAK;AAAA,EACd;AAAA;AAAA,EAGA,IAAI,aAAsB;AACxB,WAAO,KAAK;AAAA,EACd;AAAA;AAAA,EAGA,QAAc;AACZ,SAAK,aAAa;AAClB,SAAK,aAAa;AAClB,SAAK,eAAe;AACpB,SAAK,WAAW,CAAC;AAAA,EACnB;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA,EAQA,cAAc,UAA0C;AACtD,eAAW,QAAQ,uBAAuB,QAAQ,GAAG;AACnD,WAAK,SAAS,KAAK,EAAE,MAAM,KAAK,MAAM,SAAS,KAAK,QAAQ,CAAC;AAAA,IAC/D;AACA,SAAK,YAAY;AAAA,EACnB;AAAA,EAEQ,cAAoB;AAC1B,QAAI,KAAK,cAAc,QAAQ,KAAK,SAAS,SAAS,KAAK,aAAa,GAAG;AACzE,WAAK,WAAW,KAAK,SAAS,MAAM,CAAC,KAAK,aAAa,CAAC;AAAA,IAC1D;AAAA,EACF;AAAA,EAEA,MAAc,uBAAyC;AACrD,QAAI,KAAK,mBAAmB,KAAM,QAAO,KAAK;AAC9C,QAAI;AACF,YAAM,eAAe,MAAM,KAAK,OAAO,cAAc;AACrD,WAAK,iBAAiB,aAAa,uBAAuB;AAAA,IAC5D,QAAQ;AACN,WAAK,iBAAiB;AAAA,IACxB;AACA,WAAO,KAAK;AAAA,EACd;AACF;",
+  "names": []
+}

package/dist/adapters/agents/approval-posture.d.ts

@@ -0,0 +1,49 @@
+/**
+ * Single source of truth for each built-in backend's
+ * `approvalCallback` posture.
+ *
+ * Both sides consume these constants:
+ *
+ *   1. Backend declarations — every built-in backend imports its own
+ *      posture constant into its `BackendCapabilities.approvalCallback`
+ *      literal, so the declared capability cannot drift from the lookup.
+ *   2. Warning lookup — `maybeWarnApprovalCallbackGap()` in
+ *      `selection-checks.ts` resolves a backend name through {@link resolveBuiltInApprovalPosture}.
+ *
+ * There is deliberately no runtime registration API: every value is known at
+ * module load time. Extending `octoflow-core` with a new built-in backend
+ * means adding the name here and wiring its `CAPABILITIES` to the constant.
+ */
+export type ApprovalCallbackPosture = 'supported' | 'safety-gate' | 'flag-only' | 'transparent';
+export declare const APPROVAL_POSTURE_ANTHROPIC_API: ApprovalCallbackPosture;
+export declare const APPROVAL_POSTURE_GEMINI_API: ApprovalCallbackPosture;
+export declare const APPROVAL_POSTURE_OPENAI_API: ApprovalCallbackPosture;
+export declare const APPROVAL_POSTURE_OLLAMA: ApprovalCallbackPosture;
+export declare const APPROVAL_POSTURE_CUSTOM_API: ApprovalCallbackPosture;
+export declare const APPROVAL_POSTURE_VERCEL_AI: ApprovalCallbackPosture;
+export declare const APPROVAL_POSTURE_CLAUDE_CODE_CLI: ApprovalCallbackPosture;
+export declare const APPROVAL_POSTURE_CODEX_CLI: ApprovalCallbackPosture;
+export declare const APPROVAL_POSTURE_CURSOR_CLI: ApprovalCallbackPosture;
+export declare const APPROVAL_POSTURE_GEMINI_CLI: ApprovalCallbackPosture;
+export declare const APPROVAL_POSTURE_CUSTOM_CLI: ApprovalCallbackPosture;
+/**
+ * ACP auto-accepts the first permission option in-process — the host
+ * `onToolApproval` callback fires as an observe-only signal after the fact,
+ * same as `'flag-only'` CLI backends.
+ */
+export declare const APPROVAL_POSTURE_ACP_CLI: ApprovalCallbackPosture;
+export declare const APPROVAL_POSTURE_A2A: ApprovalCallbackPosture;
+/**
+ * Frozen name → posture map. Each entry MUST point at the same constant the
+ * corresponding backend module uses for its own `CAPABILITIES` declaration.
+ * The `approval-posture-consistency.test.ts` test pins the invariant.
+ */
+export declare const BUILT_IN_APPROVAL_POSTURE: Readonly<Record<string, ApprovalCallbackPosture>>;
+/**
+ * Resolve a built-in backend name to its declared posture, or `undefined`
+ * if the name is not a recognised built-in (external custom `Backend`
+ * objects, future names, typos). Callers must treat `undefined` as
+ * "no declaration" and fall back to safe behaviour.
+ */
+export declare function resolveBuiltInApprovalPosture(name: string): ApprovalCallbackPosture | undefined;
+//# sourceMappingURL=approval-posture.d.ts.map

package/dist/adapters/agents/approval-posture.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"approval-posture.d.ts","sourceRoot":"","sources":["../../../src/adapters/agents/approval-posture.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;GAeG;AAEH,MAAM,MAAM,uBAAuB,GAC/B,WAAW,GACX,aAAa,GACb,WAAW,GACX,aAAa,CAAC;AAClB,eAAO,MAAM,8BAA8B,EAAE,uBAChC,CAAC;AACd,eAAO,MAAM,2BAA2B,EAAE,uBAAqC,CAAC;AAChF,eAAO,MAAM,2BAA2B,EAAE,uBAAqC,CAAC;AAChF,eAAO,MAAM,uBAAuB,EAAE,uBAAqC,CAAC;AAC5E,eAAO,MAAM,2BAA2B,EAAE,uBAAqC,CAAC;AAChF,eAAO,MAAM,0BAA0B,EAAE,uBAAqC,CAAC;AAE/E,eAAO,MAAM,gCAAgC,EAAE,uBAClC,CAAC;AACd,eAAO,MAAM,0BAA0B,EAAE,uBAAqC,CAAC;AAC/E,eAAO,MAAM,2BAA2B,EAAE,uBAAqC,CAAC;AAChF,eAAO,MAAM,2BAA2B,EAAE,uBAAqC,CAAC;AAEhF,eAAO,MAAM,2BAA2B,EAAE,uBAC3B,CAAC;AAEhB;;;;GAIG;AACH,eAAO,MAAM,wBAAwB,EAAE,uBAAqC,CAAC;AAE7E,eAAO,MAAM,oBAAoB,EAAE,uBAAuC,CAAC;AAC3E;;;;GAIG;AACH,eAAO,MAAM,yBAAyB,EAAE,QAAQ,CAC9C,MAAM,CAAC,MAAM,EAAE,uBAAuB,CAAC,CAiBvC,CAAC;AAEH;;;;;GAKG;AACH,wBAAgB,6BAA6B,CAC3C,IAAI,EAAE,MAAM,GACX,uBAAuB,GAAG,SAAS,CAErC"}

package/dist/adapters/agents/approval-posture.js

@@ -0,0 +1,51 @@
+const APPROVAL_POSTURE_ANTHROPIC_API = "supported";
+const APPROVAL_POSTURE_GEMINI_API = "supported";
+const APPROVAL_POSTURE_OPENAI_API = "supported";
+const APPROVAL_POSTURE_OLLAMA = "supported";
+const APPROVAL_POSTURE_CUSTOM_API = "supported";
+const APPROVAL_POSTURE_VERCEL_AI = "supported";
+const APPROVAL_POSTURE_CLAUDE_CODE_CLI = "flag-only";
+const APPROVAL_POSTURE_CODEX_CLI = "flag-only";
+const APPROVAL_POSTURE_CURSOR_CLI = "flag-only";
+const APPROVAL_POSTURE_GEMINI_CLI = "flag-only";
+const APPROVAL_POSTURE_CUSTOM_CLI = "safety-gate";
+const APPROVAL_POSTURE_ACP_CLI = "flag-only";
+const APPROVAL_POSTURE_A2A = "transparent";
+const BUILT_IN_APPROVAL_POSTURE = Object.freeze({
+  "anthropic-api": APPROVAL_POSTURE_ANTHROPIC_API,
+  "gemini-api": APPROVAL_POSTURE_GEMINI_API,
+  "openai-api": APPROVAL_POSTURE_OPENAI_API,
+  ollama: APPROVAL_POSTURE_OLLAMA,
+  "custom-api": APPROVAL_POSTURE_CUSTOM_API,
+  "vercel-ai:anthropic": APPROVAL_POSTURE_VERCEL_AI,
+  "vercel-ai:openai": APPROVAL_POSTURE_VERCEL_AI,
+  "vercel-ai:google": APPROVAL_POSTURE_VERCEL_AI,
+  "claude-code-cli": APPROVAL_POSTURE_CLAUDE_CODE_CLI,
+  "codex-cli": APPROVAL_POSTURE_CODEX_CLI,
+  "cursor-cli": APPROVAL_POSTURE_CURSOR_CLI,
+  "gemini-cli": APPROVAL_POSTURE_GEMINI_CLI,
+  "acp-cli": APPROVAL_POSTURE_ACP_CLI,
+  custom: APPROVAL_POSTURE_CUSTOM_CLI,
+  a2a: APPROVAL_POSTURE_A2A
+});
+function resolveBuiltInApprovalPosture(name) {
+  return BUILT_IN_APPROVAL_POSTURE[name];
+}
+export {
+  APPROVAL_POSTURE_A2A,
+  APPROVAL_POSTURE_ACP_CLI,
+  APPROVAL_POSTURE_ANTHROPIC_API,
+  APPROVAL_POSTURE_CLAUDE_CODE_CLI,
+  APPROVAL_POSTURE_CODEX_CLI,
+  APPROVAL_POSTURE_CURSOR_CLI,
+  APPROVAL_POSTURE_CUSTOM_API,
+  APPROVAL_POSTURE_CUSTOM_CLI,
+  APPROVAL_POSTURE_GEMINI_API,
+  APPROVAL_POSTURE_GEMINI_CLI,
+  APPROVAL_POSTURE_OLLAMA,
+  APPROVAL_POSTURE_OPENAI_API,
+  APPROVAL_POSTURE_VERCEL_AI,
+  BUILT_IN_APPROVAL_POSTURE,
+  resolveBuiltInApprovalPosture
+};
+//# sourceMappingURL=approval-posture.js.map

package/dist/adapters/agents/approval-posture.js.map

@@ -0,0 +1,7 @@
+{
+  "version": 3,
+  "sources": ["../../../src/adapters/agents/approval-posture.ts"],
+  "sourcesContent": ["/**\n * Single source of truth for each built-in backend's\n * `approvalCallback` posture.\n *\n * Both sides consume these constants:\n *\n *   1. Backend declarations \u2014 every built-in backend imports its own\n *      posture constant into its `BackendCapabilities.approvalCallback`\n *      literal, so the declared capability cannot drift from the lookup.\n *   2. Warning lookup \u2014 `maybeWarnApprovalCallbackGap()` in\n *      `selection-checks.ts` resolves a backend name through {@link resolveBuiltInApprovalPosture}.\n *\n * There is deliberately no runtime registration API: every value is known at\n * module load time. Extending `octoflow-core` with a new built-in backend\n * means adding the name here and wiring its `CAPABILITIES` to the constant.\n */\n\nexport type ApprovalCallbackPosture =\n  | 'supported'\n  | 'safety-gate'\n  | 'flag-only'\n  | 'transparent';\nexport const APPROVAL_POSTURE_ANTHROPIC_API: ApprovalCallbackPosture =\n  'supported';\nexport const APPROVAL_POSTURE_GEMINI_API: ApprovalCallbackPosture = 'supported';\nexport const APPROVAL_POSTURE_OPENAI_API: ApprovalCallbackPosture = 'supported';\nexport const APPROVAL_POSTURE_OLLAMA: ApprovalCallbackPosture = 'supported';\nexport const APPROVAL_POSTURE_CUSTOM_API: ApprovalCallbackPosture = 'supported';\nexport const APPROVAL_POSTURE_VERCEL_AI: ApprovalCallbackPosture = 'supported';\n\nexport const APPROVAL_POSTURE_CLAUDE_CODE_CLI: ApprovalCallbackPosture =\n  'flag-only';\nexport const APPROVAL_POSTURE_CODEX_CLI: ApprovalCallbackPosture = 'flag-only';\nexport const APPROVAL_POSTURE_CURSOR_CLI: ApprovalCallbackPosture = 'flag-only';\nexport const APPROVAL_POSTURE_GEMINI_CLI: ApprovalCallbackPosture = 'flag-only';\n\nexport const APPROVAL_POSTURE_CUSTOM_CLI: ApprovalCallbackPosture =\n  'safety-gate';\n\n/**\n * ACP auto-accepts the first permission option in-process \u2014 the host\n * `onToolApproval` callback fires as an observe-only signal after the fact,\n * same as `'flag-only'` CLI backends.\n */\nexport const APPROVAL_POSTURE_ACP_CLI: ApprovalCallbackPosture = 'flag-only';\n\nexport const APPROVAL_POSTURE_A2A: ApprovalCallbackPosture = 'transparent';\n/**\n * Frozen name \u2192 posture map. Each entry MUST point at the same constant the\n * corresponding backend module uses for its own `CAPABILITIES` declaration.\n * The `approval-posture-consistency.test.ts` test pins the invariant.\n */\nexport const BUILT_IN_APPROVAL_POSTURE: Readonly<\n  Record<string, ApprovalCallbackPosture>\n> = Object.freeze({\n  'anthropic-api': APPROVAL_POSTURE_ANTHROPIC_API,\n  'gemini-api': APPROVAL_POSTURE_GEMINI_API,\n  'openai-api': APPROVAL_POSTURE_OPENAI_API,\n  ollama: APPROVAL_POSTURE_OLLAMA,\n  'custom-api': APPROVAL_POSTURE_CUSTOM_API,\n  'vercel-ai:anthropic': APPROVAL_POSTURE_VERCEL_AI,\n  'vercel-ai:openai': APPROVAL_POSTURE_VERCEL_AI,\n  'vercel-ai:google': APPROVAL_POSTURE_VERCEL_AI,\n  'claude-code-cli': APPROVAL_POSTURE_CLAUDE_CODE_CLI,\n  'codex-cli': APPROVAL_POSTURE_CODEX_CLI,\n  'cursor-cli': APPROVAL_POSTURE_CURSOR_CLI,\n  'gemini-cli': APPROVAL_POSTURE_GEMINI_CLI,\n  'acp-cli': APPROVAL_POSTURE_ACP_CLI,\n  custom: APPROVAL_POSTURE_CUSTOM_CLI,\n  a2a: APPROVAL_POSTURE_A2A,\n});\n\n/**\n * Resolve a built-in backend name to its declared posture, or `undefined`\n * if the name is not a recognised built-in (external custom `Backend`\n * objects, future names, typos). Callers must treat `undefined` as\n * \"no declaration\" and fall back to safe behaviour.\n */\nexport function resolveBuiltInApprovalPosture(\n  name: string\n): ApprovalCallbackPosture | undefined {\n  return BUILT_IN_APPROVAL_POSTURE[name];\n}\n"],
+  "mappings": "AAsBO,MAAM,iCACX;AACK,MAAM,8BAAuD;AAC7D,MAAM,8BAAuD;AAC7D,MAAM,0BAAmD;AACzD,MAAM,8BAAuD;AAC7D,MAAM,6BAAsD;AAE5D,MAAM,mCACX;AACK,MAAM,6BAAsD;AAC5D,MAAM,8BAAuD;AAC7D,MAAM,8BAAuD;AAE7D,MAAM,8BACX;AAOK,MAAM,2BAAoD;AAE1D,MAAM,uBAAgD;AAMtD,MAAM,4BAET,OAAO,OAAO;AAAA,EAChB,iBAAiB;AAAA,EACjB,cAAc;AAAA,EACd,cAAc;AAAA,EACd,QAAQ;AAAA,EACR,cAAc;AAAA,EACd,uBAAuB;AAAA,EACvB,oBAAoB;AAAA,EACpB,oBAAoB;AAAA,EACpB,mBAAmB;AAAA,EACnB,aAAa;AAAA,EACb,cAAc;AAAA,EACd,cAAc;AAAA,EACd,WAAW;AAAA,EACX,QAAQ;AAAA,EACR,KAAK;AACP,CAAC;AAQM,SAAS,8BACd,MACqC;AACrC,SAAO,0BAA0B,IAAI;AACvC;",
+  "names": []
+}

package/dist/adapters/agents/backends/acp-cli-elicitation.d.ts

@@ -0,0 +1,30 @@
+import type { CreateElicitationRequest, CreateElicitationResponse, ElicitationCapabilities } from '@agentclientprotocol/sdk';
+import type { AcpElicitationField, AcpElicitationRequest, AcpElicitationResponse } from '../../../domain/acp-elicitation.js';
+import type { ParsedEvent } from '../../../domain/contracts/messages.js';
+export type { AcpElicitationField, AcpElicitationRequest, AcpElicitationResponse };
+/**
+ * Convert the raw SDK `CreateElicitationRequest` into the stable OctoFlow type.
+ * @internal exported for unit testing
+ */
+export declare function parseAcpElicitationRequest(raw: CreateElicitationRequest): AcpElicitationRequest;
+/**
+ * Convert an `AcpElicitationResponse` back to the SDK `CreateElicitationResponse`.
+ * @internal exported for unit testing
+ */
+export declare function toSdkElicitationResponse(resp: AcpElicitationResponse): CreateElicitationResponse;
+/**
+ * Build the `ElicitationCapabilities` block for `clientCapabilities.elicitation`.
+ * Returns `undefined` when no handler is registered so the agent won't attempt
+ * elicitation if the client can't handle it.
+ * @internal exported for unit testing
+ */
+export declare function buildElicitationCapabilities(hasHandler: boolean): ElicitationCapabilities | undefined;
+/**
+ * Dispatch a raw `CreateElicitationRequest` to the user-supplied callback.
+ * Always emits an `input-required` ParsedEvent so event subscribers can observe
+ * the elicitation. Falls back to `{ action: 'cancel' }` when no handler is
+ * registered or when the handler throws.
+ * @internal exported for unit testing
+ */
+export declare function dispatchElicitation(params: CreateElicitationRequest, onElicitation: ((req: AcpElicitationRequest) => Promise<AcpElicitationResponse>) | undefined, push: (e: ParsedEvent) => void): Promise<CreateElicitationResponse>;
+//# sourceMappingURL=acp-cli-elicitation.d.ts.map

package/dist/adapters/agents/backends/acp-cli-elicitation.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"acp-cli-elicitation.d.ts","sourceRoot":"","sources":["../../../../src/adapters/agents/backends/acp-cli-elicitation.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EACV,wBAAwB,EACxB,yBAAyB,EACzB,uBAAuB,EACxB,MAAM,0BAA0B,CAAC;AAElC,OAAO,KAAK,EACV,mBAAmB,EACnB,qBAAqB,EACrB,sBAAsB,EACvB,MAAM,oCAAoC,CAAC;AAC5C,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,uCAAuC,CAAC;AAEzE,YAAY,EAAE,mBAAmB,EAAE,qBAAqB,EAAE,sBAAsB,EAAE,CAAC;AA2BnF;;;GAGG;AACH,wBAAgB,0BAA0B,CAAC,GAAG,EAAE,wBAAwB,GAAG,qBAAqB,CA0B/F;AAED;;;GAGG;AACH,wBAAgB,wBAAwB,CACtC,IAAI,EAAE,sBAAsB,GAC3B,yBAAyB,CAK3B;AAED;;;;;GAKG;AACH,wBAAgB,4BAA4B,CAC1C,UAAU,EAAE,OAAO,GAClB,uBAAuB,GAAG,SAAS,CAGrC;AAED;;;;;;GAMG;AACH,wBAAsB,mBAAmB,CACvC,MAAM,EAAE,wBAAwB,EAChC,aAAa,EAAE,CAAC,CAAC,GAAG,EAAE,qBAAqB,KAAK,OAAO,CAAC,sBAAsB,CAAC,CAAC,GAAG,SAAS,EAC5F,IAAI,EAAE,CAAC,CAAC,EAAE,WAAW,KAAK,IAAI,GAC7B,OAAO,CAAC,yBAAyB,CAAC,CAcpC"}

package/dist/adapters/agents/backends/acp-cli-elicitation.js

@@ -0,0 +1,68 @@
+function parseField(key, raw, requiredKeys) {
+  const field = {
+    key,
+    type: raw.type ?? "string",
+    required: requiredKeys.includes(key)
+  };
+  if (raw.title) field.title = raw.title;
+  if (raw.description) field.description = raw.description;
+  if (raw.enum) field.options = raw.enum;
+  if (raw.items?.enum) field.multiOptions = raw.items.enum;
+  return field;
+}
+function parseAcpElicitationRequest(raw) {
+  const sessionId = "sessionId" in raw && typeof raw.sessionId === "string" ? raw.sessionId : void 0;
+  if (raw.mode === "form") {
+    const schema = raw.requestedSchema;
+    const requiredKeys = Array.isArray(schema.required) ? schema.required : [];
+    const rawProps = schema.properties ?? {};
+    const fields = Object.entries(rawProps).map(([k, v]) => parseField(k, v, requiredKeys));
+    return {
+      mode: "form",
+      sessionId,
+      title: schema.title ?? void 0,
+      description: schema.description ?? void 0,
+      message: raw.message,
+      fields
+    };
+  }
+  return {
+    mode: "url",
+    sessionId,
+    url: raw.url,
+    elicitationId: raw.elicitationId,
+    message: raw.message
+  };
+}
+function toSdkElicitationResponse(resp) {
+  if (resp.action === "accept") {
+    return { action: "accept", content: resp.values ?? {} };
+  }
+  return { action: resp.action };
+}
+function buildElicitationCapabilities(hasHandler) {
+  if (!hasHandler) return void 0;
+  return { form: {}, url: {} };
+}
+async function dispatchElicitation(params, onElicitation, push) {
+  const req = parseAcpElicitationRequest(params);
+  push({
+    type: "input-required",
+    text: req.message,
+    sessionId: "sessionId" in req ? req.sessionId : void 0
+  });
+  if (!onElicitation) return { action: "cancel" };
+  try {
+    const resp = await onElicitation(req);
+    return toSdkElicitationResponse(resp);
+  } catch {
+    return { action: "cancel" };
+  }
+}
+export {
+  buildElicitationCapabilities,
+  dispatchElicitation,
+  parseAcpElicitationRequest,
+  toSdkElicitationResponse
+};
+//# sourceMappingURL=acp-cli-elicitation.js.map

package/dist/adapters/agents/backends/acp-cli-elicitation.js.map

@@ -0,0 +1,7 @@
+{
+  "version": 3,
+  "sources": ["../../../../src/adapters/agents/backends/acp-cli-elicitation.ts"],
+  "sourcesContent": ["import type {\n  CreateElicitationRequest,\n  CreateElicitationResponse,\n  ElicitationCapabilities,\n} from '@agentclientprotocol/sdk';\n\nimport type {\n  AcpElicitationField,\n  AcpElicitationRequest,\n  AcpElicitationResponse,\n} from '../../../domain/acp-elicitation.js';\nimport type { ParsedEvent } from '../../../domain/contracts/messages.js';\n\nexport type { AcpElicitationField, AcpElicitationRequest, AcpElicitationResponse };\n\n// \u2500\u2500\u2500 Internal parse helpers \u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\n\ntype RawPropSchema = {\n  type?: string;\n  title?: string;\n  description?: string;\n  enum?: string[];\n  items?: { type?: string; enum?: string[] };\n};\n\nfunction parseField(key: string, raw: RawPropSchema, requiredKeys: string[]): AcpElicitationField {\n  const field: AcpElicitationField = {\n    key,\n    type: (raw.type ?? 'string') as AcpElicitationField['type'],\n    required: requiredKeys.includes(key),\n  };\n  if (raw.title) field.title = raw.title;\n  if (raw.description) field.description = raw.description;\n  if (raw.enum) field.options = raw.enum;\n  if (raw.items?.enum) field.multiOptions = raw.items.enum;\n  return field;\n}\n\n// \u2500\u2500\u2500 Exported parse / convert helpers (exported for unit testing) \u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\n\n/**\n * Convert the raw SDK `CreateElicitationRequest` into the stable OctoFlow type.\n * @internal exported for unit testing\n */\nexport function parseAcpElicitationRequest(raw: CreateElicitationRequest): AcpElicitationRequest {\n  const sessionId =\n    'sessionId' in raw && typeof raw.sessionId === 'string' ? raw.sessionId : undefined;\n\n  if (raw.mode === 'form') {\n    const schema = raw.requestedSchema;\n    const requiredKeys: string[] = Array.isArray(schema.required) ? schema.required : [];\n    const rawProps = (schema.properties ?? {}) as Record<string, RawPropSchema>;\n    const fields = Object.entries(rawProps).map(([k, v]) => parseField(k, v, requiredKeys));\n    return {\n      mode: 'form',\n      sessionId,\n      title: schema.title ?? undefined,\n      description: schema.description ?? undefined,\n      message: raw.message,\n      fields,\n    };\n  }\n\n  return {\n    mode: 'url',\n    sessionId,\n    url: raw.url,\n    elicitationId: raw.elicitationId,\n    message: raw.message,\n  };\n}\n\n/**\n * Convert an `AcpElicitationResponse` back to the SDK `CreateElicitationResponse`.\n * @internal exported for unit testing\n */\nexport function toSdkElicitationResponse(\n  resp: AcpElicitationResponse\n): CreateElicitationResponse {\n  if (resp.action === 'accept') {\n    return { action: 'accept', content: resp.values ?? {} };\n  }\n  return { action: resp.action };\n}\n\n/**\n * Build the `ElicitationCapabilities` block for `clientCapabilities.elicitation`.\n * Returns `undefined` when no handler is registered so the agent won't attempt\n * elicitation if the client can't handle it.\n * @internal exported for unit testing\n */\nexport function buildElicitationCapabilities(\n  hasHandler: boolean\n): ElicitationCapabilities | undefined {\n  if (!hasHandler) return undefined;\n  return { form: {}, url: {} };\n}\n\n/**\n * Dispatch a raw `CreateElicitationRequest` to the user-supplied callback.\n * Always emits an `input-required` ParsedEvent so event subscribers can observe\n * the elicitation. Falls back to `{ action: 'cancel' }` when no handler is\n * registered or when the handler throws.\n * @internal exported for unit testing\n */\nexport async function dispatchElicitation(\n  params: CreateElicitationRequest,\n  onElicitation: ((req: AcpElicitationRequest) => Promise<AcpElicitationResponse>) | undefined,\n  push: (e: ParsedEvent) => void\n): Promise<CreateElicitationResponse> {\n  const req = parseAcpElicitationRequest(params);\n  push({\n    type: 'input-required',\n    text: req.message,\n    sessionId: 'sessionId' in req ? req.sessionId : undefined,\n  });\n  if (!onElicitation) return { action: 'cancel' };\n  try {\n    const resp = await onElicitation(req);\n    return toSdkElicitationResponse(resp);\n  } catch {\n    return { action: 'cancel' };\n  }\n}\n"],
+  "mappings": "AAyBA,SAAS,WAAW,KAAa,KAAoB,cAA6C;AAChG,QAAM,QAA6B;AAAA,IACjC;AAAA,IACA,MAAO,IAAI,QAAQ;AAAA,IACnB,UAAU,aAAa,SAAS,GAAG;AAAA,EACrC;AACA,MAAI,IAAI,MAAO,OAAM,QAAQ,IAAI;AACjC,MAAI,IAAI,YAAa,OAAM,cAAc,IAAI;AAC7C,MAAI,IAAI,KAAM,OAAM,UAAU,IAAI;AAClC,MAAI,IAAI,OAAO,KAAM,OAAM,eAAe,IAAI,MAAM;AACpD,SAAO;AACT;AAQO,SAAS,2BAA2B,KAAsD;AAC/F,QAAM,YACJ,eAAe,OAAO,OAAO,IAAI,cAAc,WAAW,IAAI,YAAY;AAE5E,MAAI,IAAI,SAAS,QAAQ;AACvB,UAAM,SAAS,IAAI;AACnB,UAAM,eAAyB,MAAM,QAAQ,OAAO,QAAQ,IAAI,OAAO,WAAW,CAAC;AACnF,UAAM,WAAY,OAAO,cAAc,CAAC;AACxC,UAAM,SAAS,OAAO,QAAQ,QAAQ,EAAE,IAAI,CAAC,CAAC,GAAG,CAAC,MAAM,WAAW,GAAG,GAAG,YAAY,CAAC;AACtF,WAAO;AAAA,MACL,MAAM;AAAA,MACN;AAAA,MACA,OAAO,OAAO,SAAS;AAAA,MACvB,aAAa,OAAO,eAAe;AAAA,MACnC,SAAS,IAAI;AAAA,MACb;AAAA,IACF;AAAA,EACF;AAEA,SAAO;AAAA,IACL,MAAM;AAAA,IACN;AAAA,IACA,KAAK,IAAI;AAAA,IACT,eAAe,IAAI;AAAA,IACnB,SAAS,IAAI;AAAA,EACf;AACF;AAMO,SAAS,yBACd,MAC2B;AAC3B,MAAI,KAAK,WAAW,UAAU;AAC5B,WAAO,EAAE,QAAQ,UAAU,SAAS,KAAK,UAAU,CAAC,EAAE;AAAA,EACxD;AACA,SAAO,EAAE,QAAQ,KAAK,OAAO;AAC/B;AAQO,SAAS,6BACd,YACqC;AACrC,MAAI,CAAC,WAAY,QAAO;AACxB,SAAO,EAAE,MAAM,CAAC,GAAG,KAAK,CAAC,EAAE;AAC7B;AASA,eAAsB,oBACpB,QACA,eACA,MACoC;AACpC,QAAM,MAAM,2BAA2B,MAAM;AAC7C,OAAK;AAAA,IACH,MAAM;AAAA,IACN,MAAM,IAAI;AAAA,IACV,WAAW,eAAe,MAAM,IAAI,YAAY;AAAA,EAClD,CAAC;AACD,MAAI,CAAC,cAAe,QAAO,EAAE,QAAQ,SAAS;AAC9C,MAAI;AACF,UAAM,OAAO,MAAM,cAAc,GAAG;AACpC,WAAO,yBAAyB,IAAI;AAAA,EACtC,QAAQ;AACN,WAAO,EAAE,QAAQ,SAAS;AAAA,EAC5B;AACF;",
+  "names": []
+}

package/dist/adapters/agents/backends/acp-cli-helpers.d.ts

@@ -0,0 +1,111 @@
+import type { ClientSideConnection } from '@agentclientprotocol/sdk';
+import type { SessionUpdate, ToolCallLocation as AcpToolCallLocation } from '@agentclientprotocol/sdk';
+import type { BridgeMcpServerConfig } from '../../../capabilities/types.js';
+import type { ParsedEvent, ToolCallLocation } from '../../../domain/contracts/messages.js';
+import type { AcpElicitationRequest, AcpElicitationResponse } from './acp-cli-elicitation.js';
+/** Session entry returned by `session/list`. */
+export type AcpSessionInfo = {
+    sessionId: string;
+    cwd: string;
+    title?: string;
+    updatedAt?: string;
+};
+/** A single select-type config option returned by the agent. */
+export type AcpConfigOption = {
+    id: string;
+    name: string;
+    description?: string | null;
+    category?: string | null;
+    type: 'select' | 'boolean';
+    currentValue: string;
+    options: {
+        value: string;
+        name: string;
+        description?: string | null;
+    }[];
+};
+export declare const HANDSHAKE_TIMEOUT_MS = 30000;
+export declare function withAcpTimeout<T>(promise: Promise<T>, ms: number): Promise<T>;
+/** Registry of well-known ACP agent names → launch commands. */
+export declare const ACP_AGENT_REGISTRY: Record<string, string>;
+export declare function resolveAcpAgentCommand(agent: string, overrides?: Record<string, string>): {
+    command: string;
+    args: string[];
+};
+/** Config for an ACP CLI backend. */
+export type AcpCliBackendConfig = {
+    /**
+     * Logical agent name resolved via the built-in ACP registry.
+     * Defaults to `'claude'`. Set `command`/`args` for a fully custom launch.
+     */
+    agent?: string;
+    /** Per-agent registry overrides merged on top of the built-in registry. */
+    agentOverrides?: Record<string, string>;
+    /** Raw executable, bypassing the agent registry entirely. */
+    command?: string;
+    /** Arguments forwarded to `command`. Ignored when `agent` is used. */
+    args?: string[];
+    /**
+     * Override the model list for this backend. Pass `model` via
+     * `sendMessage` to route through `session/set_model` on the agent.
+     */
+    models?: string[];
+    /**
+     * Callback invoked when the ACP agent requests user input via
+     * `unstable_createElicitation` (form fields, OAuth URLs, permission dialogs).
+     * Return `{ action: 'accept', values }`, `'decline'`, or `'cancel'` (default).
+     * When set, OctoFlow advertises elicitation support in `clientCapabilities`.
+     */
+    onElicitation?: (req: AcpElicitationRequest) => Promise<AcpElicitationResponse>;
+};
+type AcpMcpEnvVar = {
+    name: string;
+    value: string;
+};
+type AcpMcpHttpHeader = {
+    name: string;
+    value: string;
+};
+export type AcpMcpServerSpec = {
+    name: string;
+    command: string;
+    args?: string[];
+    env?: AcpMcpEnvVar[];
+} | {
+    type: 'http' | 'sse';
+    name: string;
+    url: string;
+    headers?: AcpMcpHttpHeader[];
+};
+export type AcpAgentCapabilities = {
+    protocolVersion: number | null;
+    canLoadSession: boolean;
+    canResumeSession: boolean;
+    canListSessions: boolean;
+    canCloseSession: boolean;
+    canForkSession: boolean;
+    supportsMcpHttp: boolean;
+    supportsMcpSse: boolean;
+};
+export declare function resolveAcpAgentCapabilities(initializeResult: unknown): AcpAgentCapabilities;
+export declare function toAcpMcpServers(servers: Record<string, BridgeMcpServerConfig> | undefined, cwd: string): AcpMcpServerSpec[];
+export declare function toAcpToolLocations(raw: AcpToolCallLocation[] | null | undefined): ToolCallLocation[] | undefined;
+export declare function mapAcpSessionUpdate(update: SessionUpdate, push: (e: ParsedEvent) => void): void;
+export declare function filterMcpServersByCapabilities(servers: AcpMcpServerSpec[], capabilities: AcpAgentCapabilities): AcpMcpServerSpec[];
+export declare function assertAcpProtocolCompatible(capabilities: AcpAgentCapabilities, expectedProtocolVersion: number): void;
+export declare function closeAcpSessionIfSupported(connection: ClientSideConnection, sessionId: string, canCloseSession: boolean): Promise<void>;
+export declare function readAcpMcpServers(mcpConfigPath: string | null | undefined, cwd: string): AcpMcpServerSpec[];
+/** Calls `session/list` on an already-initialized connection. */
+export declare function listAcpSessionsViaConnection(connection: ClientSideConnection, opts?: {
+    cwd?: string;
+    cursor?: string;
+}): Promise<{
+    sessions: AcpSessionInfo[];
+    nextCursor?: string;
+}>;
+/** Calls `session/set_config_option` on an already-initialized connection. */
+export declare function setAcpConfigOptionViaConnection(connection: ClientSideConnection, sessionId: string, configId: string, value: string): Promise<AcpConfigOption[]>;
+/** Parses `configOptions` from any session setup response (newSession / loadSession / resumeSession). */
+export declare function parseAcpConfigOptions(response: unknown): AcpConfigOption[];
+export {};
+//# sourceMappingURL=acp-cli-helpers.d.ts.map

package/dist/adapters/agents/backends/acp-cli-helpers.d.ts.map

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