octoflow-core 1.0.0

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

@@ -0,0 +1,285 @@
+import fs from "node:fs";
+import path from "node:path";
+const HANDSHAKE_TIMEOUT_MS = 3e4;
+function withAcpTimeout(promise, ms) {
+  return Promise.race([
+    promise,
+    new Promise(
+      (_, reject) => setTimeout(
+        () => reject(new Error(`ACP operation timed out after ${ms}ms`)),
+        ms
+      )
+    )
+  ]);
+}
+const ACP_AGENT_REGISTRY = {
+  pi: "npx pi-acp@^0.0.26",
+  openclaw: "openclaw acp",
+  codex: "npx @zed-industries/codex-acp@^0.12.0",
+  claude: "npx -y @agentclientprotocol/claude-agent-acp@^0.31.0",
+  gemini: "gemini --acp",
+  cursor: "cursor-agent acp",
+  copilot: "copilot --acp --stdio",
+  droid: "droid exec --output-format acp",
+  "factory-droid": "droid exec --output-format acp",
+  factorydroid: "droid exec --output-format acp",
+  iflow: "iflow --experimental-acp",
+  kilocode: "npx -y @kilocode/cli acp",
+  kimi: "kimi acp",
+  kiro: "kiro-cli-chat acp",
+  opencode: "npx -y opencode-ai acp",
+  qoder: "qodercli --acp",
+  qwen: "qwen --acp",
+  trae: "traecli acp serve"
+};
+function resolveAcpAgentCommand(agent, overrides) {
+  const normalized = agent.trim().toLowerCase();
+  const registry = overrides ? { ...ACP_AGENT_REGISTRY, ...overrides } : ACP_AGENT_REGISTRY;
+  const launchString = registry[normalized] ?? normalized;
+  const parts = launchString.split(" ");
+  return { command: parts[0] ?? normalized, args: parts.slice(1) };
+}
+function isRecord(value) {
+  return typeof value === "object" && value !== null && !Array.isArray(value);
+}
+function toNameValueList(values) {
+  if (!values) return void 0;
+  const out = Object.entries(values).filter((entry) => typeof entry[1] === "string").map(([name, value]) => ({ name, value }));
+  return out.length > 0 ? out : void 0;
+}
+function toAbsolutePath(filePath, cwd) {
+  return path.isAbsolute(filePath) ? filePath : path.resolve(cwd, filePath);
+}
+function resolveAcpAgentCapabilities(initializeResult) {
+  const fallback = {
+    protocolVersion: null,
+    canLoadSession: false,
+    canResumeSession: false,
+    canListSessions: false,
+    canCloseSession: false,
+    canForkSession: false,
+    supportsMcpHttp: false,
+    supportsMcpSse: false
+  };
+  if (!isRecord(initializeResult)) return fallback;
+  const agentCapabilities = isRecord(initializeResult.agentCapabilities) ? initializeResult.agentCapabilities : null;
+  if (!agentCapabilities) return fallback;
+  const loadSession = agentCapabilities.loadSession === true;
+  const sessionCaps = isRecord(agentCapabilities.sessionCapabilities) ? agentCapabilities.sessionCapabilities : null;
+  const mcpCaps = isRecord(agentCapabilities.mcpCapabilities) ? agentCapabilities.mcpCapabilities : null;
+  return {
+    protocolVersion: typeof initializeResult.protocolVersion === "number" ? initializeResult.protocolVersion : null,
+    canLoadSession: loadSession,
+    canResumeSession: sessionCaps ? isRecord(sessionCaps.resume) : false,
+    canListSessions: sessionCaps ? isRecord(sessionCaps.list) : false,
+    canCloseSession: sessionCaps ? isRecord(sessionCaps.close) : false,
+    canForkSession: sessionCaps ? isRecord(sessionCaps.fork) : false,
+    supportsMcpHttp: mcpCaps?.http === true,
+    supportsMcpSse: mcpCaps?.sse === true
+  };
+}
+function toAcpMcpServers(servers, cwd) {
+  if (!servers) return [];
+  const out = [];
+  for (const [name, server] of Object.entries(servers)) {
+    if (!server || typeof server !== "object") continue;
+    const transport = server.transport ?? (server.url ? "http" : "stdio");
+    if (server.command && (transport === "stdio" || transport === "http")) {
+      out.push({
+        name,
+        command: toAbsolutePath(server.command, cwd),
+        ...server.args ? { args: server.args } : {},
+        ...server.env ? { env: toNameValueList(server.env) } : {}
+      });
+      continue;
+    }
+    if (!server.url) continue;
+    const authHeader = server.auth?.type === "bearer" && typeof server.auth.token === "string" ? { Authorization: `Bearer ${server.auth.token}` } : void 0;
+    const headers = toNameValueList(authHeader);
+    if (transport === "sse") {
+      out.push({
+        type: "sse",
+        name,
+        url: server.url,
+        ...headers ? { headers } : {}
+      });
+    } else {
+      out.push({
+        type: "http",
+        name,
+        url: server.url,
+        ...headers ? { headers } : {}
+      });
+    }
+  }
+  return out;
+}
+function toAcpToolLocations(raw) {
+  if (!raw || raw.length === 0) return void 0;
+  const mapped = raw.filter((loc) => Boolean(loc.path)).map((loc) => {
+    const location = { uri: loc.path };
+    if (loc.line !== void 0 && loc.line !== null) {
+      location.range = { start: { line: loc.line, character: 0 } };
+    }
+    return location;
+  });
+  return mapped.length > 0 ? mapped : void 0;
+}
+function mapAcpSessionUpdate(update, push) {
+  switch (update.sessionUpdate) {
+    case "agent_message_chunk":
+      if (update.content.type === "text") {
+        push({ type: "text", text: update.content.text, stream: "output" });
+      }
+      break;
+    case "agent_thought_chunk":
+      if (update.content.type === "text") {
+        push({ type: "thinking", text: update.content.text, stream: "thought" });
+      }
+      break;
+    case "tool_call":
+      push({
+        type: "tool",
+        name: update.title,
+        toolCallId: update.toolCallId,
+        args: update.rawInput,
+        locations: toAcpToolLocations(update.locations)
+      });
+      break;
+    case "tool_call_update":
+      if (update.status === "completed") {
+        push({ type: "tool_call_result", toolCallId: update.toolCallId ?? void 0 });
+      } else if (update.status === "failed") {
+        push({ type: "tool_call_result", isError: true, toolCallId: update.toolCallId ?? void 0 });
+      }
+      break;
+    case "usage_update":
+      push({
+        type: "result",
+        usage: { inputTokens: update.size - update.used, outputTokens: update.used }
+      });
+      break;
+    case "plan": {
+      const first = update.entries[0];
+      if (first) push({ type: "thinking", text: first.content, stream: "thought" });
+      break;
+    }
+    case "session_info_update":
+      if (update.title) push({ type: "thinking", text: update.title, stream: "thought" });
+      break;
+    case "available_commands_update":
+    case "current_mode_update":
+      break;
+    case "config_option_update": {
+      const opts = (update.configOptions ?? []).map((o) => sdkOptionToAcpConfigOption(o)).filter((o) => o !== null).map(({ category: _cat, ...rest }) => rest);
+      push({ type: "agent-config-update", configOptions: opts });
+      break;
+    }
+    default:
+      break;
+  }
+}
+function filterMcpServersByCapabilities(servers, capabilities) {
+  return servers.filter((server) => {
+    if (!("type" in server)) return true;
+    if (server.type === "http") return capabilities.supportsMcpHttp;
+    if (server.type === "sse") return capabilities.supportsMcpSse;
+    return false;
+  });
+}
+function assertAcpProtocolCompatible(capabilities, expectedProtocolVersion) {
+  if (capabilities.protocolVersion !== null && capabilities.protocolVersion !== expectedProtocolVersion) {
+    throw new Error(
+      `ACP protocol mismatch: client=${expectedProtocolVersion} agent=${capabilities.protocolVersion}`
+    );
+  }
+}
+async function closeAcpSessionIfSupported(connection, sessionId, canCloseSession) {
+  if (!canCloseSession || !sessionId) return;
+  const maybeClose = connection.closeSession;
+  if (!maybeClose) return;
+  await maybeClose({ sessionId }).catch(() => void 0);
+}
+function readAcpMcpServers(mcpConfigPath, cwd) {
+  if (!mcpConfigPath) return [];
+  const absolute = toAbsolutePath(mcpConfigPath, cwd);
+  const parsed = JSON.parse(fs.readFileSync(absolute, "utf8"));
+  const candidate = isRecord(parsed) && isRecord(parsed.mcpServers) ? parsed.mcpServers : parsed;
+  if (!isRecord(candidate)) return [];
+  return toAcpMcpServers(candidate, cwd);
+}
+function sdkInfoToAcpSessionInfo(raw) {
+  return {
+    sessionId: raw.sessionId,
+    cwd: raw.cwd,
+    ...raw.title ? { title: raw.title } : {},
+    ...raw.updatedAt ? { updatedAt: raw.updatedAt } : {}
+  };
+}
+function sdkOptionToAcpConfigOption(raw) {
+  const rawRecord = raw;
+  const type = rawRecord["type"];
+  if (type !== "select" && type !== "boolean") return null;
+  const currentValueRaw = rawRecord["currentValue"];
+  const currentValue = typeof currentValueRaw === "string" ? currentValueRaw : "";
+  const rawOptions = rawRecord["options"];
+  const options = Array.isArray(rawOptions) ? rawOptions.filter((o) => isRecord(o)).map((o) => ({
+    value: typeof o["value"] === "string" ? o["value"] : "",
+    name: typeof o["name"] === "string" ? o["name"] : "",
+    description: typeof o["description"] === "string" ? o["description"] : null
+  })) : [];
+  const configType = type === "select" ? "select" : "boolean";
+  return {
+    id: raw.id,
+    name: raw.name,
+    description: raw.description ?? null,
+    category: raw.category ?? null,
+    type: configType,
+    currentValue,
+    options
+  };
+}
+async function listAcpSessionsViaConnection(connection, opts) {
+  const resp = await connection.listSessions({
+    ...opts?.cwd ? { cwd: opts.cwd } : {},
+    ...opts?.cursor ? { cursor: opts.cursor } : {}
+  });
+  const sessions = resp.sessions ?? [];
+  return {
+    sessions: sessions.map(sdkInfoToAcpSessionInfo),
+    ...resp.nextCursor ? { nextCursor: resp.nextCursor } : {}
+  };
+}
+async function setAcpConfigOptionViaConnection(connection, sessionId, configId, value) {
+  const resp = await connection.setSessionConfigOption({
+    sessionId,
+    configId,
+    value
+  });
+  const rawOpts = resp.configOptions ?? [];
+  return rawOpts.map((o) => sdkOptionToAcpConfigOption(o)).filter((o) => o !== null);
+}
+function parseAcpConfigOptions(response) {
+  if (!isRecord(response)) return [];
+  const raw = response["configOptions"];
+  if (!Array.isArray(raw)) return [];
+  return raw.map((o) => sdkOptionToAcpConfigOption(o)).filter((o) => o !== null);
+}
+export {
+  ACP_AGENT_REGISTRY,
+  HANDSHAKE_TIMEOUT_MS,
+  assertAcpProtocolCompatible,
+  closeAcpSessionIfSupported,
+  filterMcpServersByCapabilities,
+  listAcpSessionsViaConnection,
+  mapAcpSessionUpdate,
+  parseAcpConfigOptions,
+  readAcpMcpServers,
+  resolveAcpAgentCapabilities,
+  resolveAcpAgentCommand,
+  setAcpConfigOptionViaConnection,
+  toAcpMcpServers,
+  toAcpToolLocations,
+  withAcpTimeout
+};
+//# sourceMappingURL=acp-cli-helpers.js.map

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

@@ -0,0 +1,7 @@
+{
+  "version": 3,
+  "sources": ["../../../../src/adapters/agents/backends/acp-cli-helpers.ts"],
+  "sourcesContent": ["import fs from 'node:fs';\nimport path from 'node:path';\n\nimport type { ClientSideConnection } from '@agentclientprotocol/sdk';\nimport type {\n  ListSessionsResponse as SdkListSessionsResponse,\n  SessionConfigOption as SdkSessionConfigOption,\n  SessionInfo as SdkSessionInfo,\n  SessionUpdate,\n  SetSessionConfigOptionResponse as SdkSetSessionConfigOptionResponse,\n  ToolCallLocation as AcpToolCallLocation,\n} from '@agentclientprotocol/sdk';\n\nimport type { BridgeMcpServerConfig } from '../../../capabilities/types.js';\nimport type {\n  ParsedConfigOption,\n  ParsedEvent,\n  ToolCallLocation,\n} from '../../../domain/contracts/messages.js';\nimport type { AcpElicitationRequest, AcpElicitationResponse } from './acp-cli-elicitation.js';\n\n/** Session entry returned by `session/list`. */\nexport type AcpSessionInfo = {\n  sessionId: string;\n  cwd: string;\n  title?: string;\n  updatedAt?: string;\n};\n\n/** A single select-type config option returned by the agent. */\nexport type AcpConfigOption = {\n  id: string;\n  name: string;\n  description?: string | null;\n  category?: string | null;\n  type: 'select' | 'boolean';\n  currentValue: string;\n  options: { value: string; name: string; description?: string | null }[];\n};\n\n// \u2500\u2500\u2500 Shared utilities \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\u2500\u2500\u2500\u2500\u2500\n\nexport const HANDSHAKE_TIMEOUT_MS = 30_000;\n\nexport function withAcpTimeout<T>(promise: Promise<T>, ms: number): Promise<T> {\n  return Promise.race([\n    promise,\n    new Promise<never>((_, reject) =>\n      setTimeout(\n        () => reject(new Error(`ACP operation timed out after ${ms}ms`)),\n        ms\n      )\n    ),\n  ]);\n}\n\n/** Registry of well-known ACP agent names \u2192 launch commands. */\nexport const ACP_AGENT_REGISTRY: Record<string, string> = {\n  pi: 'npx pi-acp@^0.0.26',\n  openclaw: 'openclaw acp',\n  codex: 'npx @zed-industries/codex-acp@^0.12.0',\n  claude: 'npx -y @agentclientprotocol/claude-agent-acp@^0.31.0',\n  gemini: 'gemini --acp',\n  cursor: 'cursor-agent acp',\n  copilot: 'copilot --acp --stdio',\n  droid: 'droid exec --output-format acp',\n  'factory-droid': 'droid exec --output-format acp',\n  factorydroid: 'droid exec --output-format acp',\n  iflow: 'iflow --experimental-acp',\n  kilocode: 'npx -y @kilocode/cli acp',\n  kimi: 'kimi acp',\n  kiro: 'kiro-cli-chat acp',\n  opencode: 'npx -y opencode-ai acp',\n  qoder: 'qodercli --acp',\n  qwen: 'qwen --acp',\n  trae: 'traecli acp serve',\n};\n\nexport function resolveAcpAgentCommand(\n  agent: string,\n  overrides?: Record<string, string>\n): { command: string; args: string[] } {\n  const normalized = agent.trim().toLowerCase();\n  const registry = overrides\n    ? { ...ACP_AGENT_REGISTRY, ...overrides }\n    : ACP_AGENT_REGISTRY;\n  const launchString = registry[normalized] ?? normalized;\n  const parts = launchString.split(' ');\n  return { command: parts[0] ?? normalized, args: parts.slice(1) };\n}\n\n/** Config for an ACP CLI backend. */\nexport type AcpCliBackendConfig = {\n  /**\n   * Logical agent name resolved via the built-in ACP registry.\n   * Defaults to `'claude'`. Set `command`/`args` for a fully custom launch.\n   */\n  agent?: string;\n  /** Per-agent registry overrides merged on top of the built-in registry. */\n  agentOverrides?: Record<string, string>;\n  /** Raw executable, bypassing the agent registry entirely. */\n  command?: string;\n  /** Arguments forwarded to `command`. Ignored when `agent` is used. */\n  args?: string[];\n  /**\n   * Override the model list for this backend. Pass `model` via\n   * `sendMessage` to route through `session/set_model` on the agent.\n   */\n  models?: string[];\n  /**\n   * Callback invoked when the ACP agent requests user input via\n   * `unstable_createElicitation` (form fields, OAuth URLs, permission dialogs).\n   * Return `{ action: 'accept', values }`, `'decline'`, or `'cancel'` (default).\n   * When set, OctoFlow advertises elicitation support in `clientCapabilities`.\n   */\n  onElicitation?: (req: AcpElicitationRequest) => Promise<AcpElicitationResponse>;\n};\n\n// \u2500\u2500\u2500 Internal \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\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\n\ntype AcpMcpEnvVar = { name: string; value: string };\ntype AcpMcpHttpHeader = { name: string; value: string };\nexport type AcpMcpServerSpec =\n  | { name: string; command: string; args?: string[]; env?: AcpMcpEnvVar[] }\n  | {\n    type: 'http' | 'sse';\n    name: string;\n    url: string;\n    headers?: AcpMcpHttpHeader[];\n  };\n\nexport type AcpAgentCapabilities = {\n  protocolVersion: number | null;\n  canLoadSession: boolean;\n  canResumeSession: boolean;\n  canListSessions: boolean;\n  canCloseSession: boolean;\n  canForkSession: boolean;\n  supportsMcpHttp: boolean;\n  supportsMcpSse: boolean;\n};\n\nfunction isRecord(value: unknown): value is Record<string, unknown> {\n  return typeof value === 'object' && value !== null && !Array.isArray(value);\n}\n\nfunction toNameValueList(\n  values: Record<string, string> | undefined\n): { name: string; value: string }[] | undefined {\n  if (!values) return undefined;\n  const out = Object.entries(values)\n    .filter((entry): entry is [string, string] => typeof entry[1] === 'string')\n    .map(([name, value]) => ({ name, value }));\n  return out.length > 0 ? out : undefined;\n}\n\nfunction toAbsolutePath(filePath: string, cwd: string): string {\n  return path.isAbsolute(filePath) ? filePath : path.resolve(cwd, filePath);\n}\n\nexport function resolveAcpAgentCapabilities(\n  initializeResult: unknown\n): AcpAgentCapabilities {\n  const fallback: AcpAgentCapabilities = {\n    protocolVersion: null,\n    canLoadSession: false,\n    canResumeSession: false,\n    canListSessions: false,\n    canCloseSession: false,\n    canForkSession: false,\n    supportsMcpHttp: false,\n    supportsMcpSse: false,\n  };\n  if (!isRecord(initializeResult)) return fallback;\n  const agentCapabilities = isRecord(initializeResult.agentCapabilities)\n    ? initializeResult.agentCapabilities\n    : null;\n  if (!agentCapabilities) return fallback;\n\n  const loadSession = agentCapabilities.loadSession === true;\n  const sessionCaps = isRecord(agentCapabilities.sessionCapabilities)\n    ? agentCapabilities.sessionCapabilities\n    : null;\n  const mcpCaps = isRecord(agentCapabilities.mcpCapabilities)\n    ? agentCapabilities.mcpCapabilities\n    : null;\n\n  return {\n    protocolVersion:\n      typeof initializeResult.protocolVersion === 'number'\n        ? initializeResult.protocolVersion\n        : null,\n    canLoadSession: loadSession,\n    canResumeSession: sessionCaps ? isRecord(sessionCaps.resume) : false,\n    canListSessions: sessionCaps ? isRecord(sessionCaps.list) : false,\n    canCloseSession: sessionCaps ? isRecord(sessionCaps.close) : false,\n    canForkSession: sessionCaps ? isRecord(sessionCaps.fork) : false,\n    supportsMcpHttp: mcpCaps?.http === true,\n    supportsMcpSse: mcpCaps?.sse === true,\n  };\n}\n\nexport function toAcpMcpServers(\n  servers: Record<string, BridgeMcpServerConfig> | undefined,\n  cwd: string\n): AcpMcpServerSpec[] {\n  if (!servers) return [];\n  const out: AcpMcpServerSpec[] = [];\n\n  for (const [name, server] of Object.entries(servers)) {\n    if (!server || typeof server !== 'object') continue;\n    const transport = server.transport ?? (server.url ? 'http' : 'stdio');\n\n    if (server.command && (transport === 'stdio' || transport === 'http')) {\n      out.push({\n        name,\n        command: toAbsolutePath(server.command, cwd),\n        ...(server.args ? { args: server.args } : {}),\n        ...(server.env ? { env: toNameValueList(server.env) } : {}),\n      });\n      continue;\n    }\n\n    if (!server.url) continue;\n    const authHeader =\n      server.auth?.type === 'bearer' && typeof server.auth.token === 'string'\n        ? { Authorization: `Bearer ${server.auth.token}` }\n        : undefined;\n    const headers = toNameValueList(authHeader);\n    if (transport === 'sse') {\n      out.push({\n        type: 'sse',\n        name,\n        url: server.url,\n        ...(headers ? { headers } : {}),\n      });\n    } else {\n      out.push({\n        type: 'http',\n        name,\n        url: server.url,\n        ...(headers ? { headers } : {}),\n      });\n    }\n  }\n\n  return out;\n}\n\nexport function toAcpToolLocations(\n  raw: AcpToolCallLocation[] | null | undefined\n): ToolCallLocation[] | undefined {\n  if (!raw || raw.length === 0) return undefined;\n  const mapped = raw\n    .filter((loc) => Boolean(loc.path))\n    .map((loc): ToolCallLocation => {\n      const location: ToolCallLocation = { uri: loc.path };\n      if (loc.line !== undefined && loc.line !== null) {\n        location.range = { start: { line: loc.line, character: 0 } };\n      }\n      return location;\n    });\n  return mapped.length > 0 ? mapped : undefined;\n}\n\nexport function mapAcpSessionUpdate(\n  update: SessionUpdate,\n  push: (e: ParsedEvent) => void\n): void {\n  switch (update.sessionUpdate) {\n    case 'agent_message_chunk':\n      if (update.content.type === 'text') {\n        push({ type: 'text', text: update.content.text, stream: 'output' });\n      }\n      break;\n    case 'agent_thought_chunk':\n      if (update.content.type === 'text') {\n        push({ type: 'thinking', text: update.content.text, stream: 'thought' });\n      }\n      break;\n    case 'tool_call':\n      push({\n        type: 'tool',\n        name: update.title,\n        toolCallId: update.toolCallId,\n        args: update.rawInput as Record<string, unknown> | undefined,\n        locations: toAcpToolLocations(update.locations),\n      });\n      break;\n    case 'tool_call_update':\n      if (update.status === 'completed') {\n        push({ type: 'tool_call_result', toolCallId: update.toolCallId ?? undefined });\n      } else if (update.status === 'failed') {\n        push({ type: 'tool_call_result', isError: true, toolCallId: update.toolCallId ?? undefined });\n      }\n      break;\n    case 'usage_update':\n      push({\n        type: 'result',\n        usage: { inputTokens: update.size - update.used, outputTokens: update.used },\n      });\n      break;\n    case 'plan': {\n      const first = update.entries[0];\n      if (first) push({ type: 'thinking', text: first.content, stream: 'thought' });\n      break;\n    }\n    case 'session_info_update':\n      if (update.title) push({ type: 'thinking', text: update.title, stream: 'thought' });\n      break;\n    case 'available_commands_update':\n    case 'current_mode_update':\n      break;\n    case 'config_option_update': {\n      const opts: ParsedConfigOption[] = (update.configOptions ?? [])\n        .map((o) => sdkOptionToAcpConfigOption(o))\n        .filter((o): o is AcpConfigOption => o !== null)\n        .map(({ category: _cat, ...rest }) => rest);\n      push({ type: 'agent-config-update', configOptions: opts });\n      break;\n    }\n    default:\n      break;\n  }\n}\n\nexport function filterMcpServersByCapabilities(\n  servers: AcpMcpServerSpec[],\n  capabilities: AcpAgentCapabilities\n): AcpMcpServerSpec[] {\n  return servers.filter((server) => {\n    if (!('type' in server)) return true; // stdio/default\n    if (server.type === 'http') return capabilities.supportsMcpHttp;\n    if (server.type === 'sse') return capabilities.supportsMcpSse;\n    return false;\n  });\n}\n\nexport function assertAcpProtocolCompatible(\n  capabilities: AcpAgentCapabilities,\n  expectedProtocolVersion: number\n): void {\n  if (\n    capabilities.protocolVersion !== null &&\n    capabilities.protocolVersion !== expectedProtocolVersion\n  ) {\n    throw new Error(\n      `ACP protocol mismatch: client=${expectedProtocolVersion} agent=${capabilities.protocolVersion}`\n    );\n  }\n}\n\nexport async function closeAcpSessionIfSupported(\n  connection: ClientSideConnection,\n  sessionId: string,\n  canCloseSession: boolean\n): Promise<void> {\n  if (!canCloseSession || !sessionId) return;\n  type MaybeCloseSession = ClientSideConnection & {\n    closeSession?: (params: { sessionId: string }) => Promise<unknown>;\n  };\n  const maybeClose = (connection as MaybeCloseSession).closeSession;\n  if (!maybeClose) return;\n  await maybeClose({ sessionId }).catch(() => undefined);\n}\n\nexport function readAcpMcpServers(\n  mcpConfigPath: string | null | undefined,\n  cwd: string\n): AcpMcpServerSpec[] {\n  if (!mcpConfigPath) return [];\n  const absolute = toAbsolutePath(mcpConfigPath, cwd);\n  const parsed = JSON.parse(fs.readFileSync(absolute, 'utf8')) as unknown;\n  const candidate =\n    isRecord(parsed) && isRecord(parsed.mcpServers)\n      ? (parsed.mcpServers as Record<string, BridgeMcpServerConfig>)\n      : (parsed as Record<string, BridgeMcpServerConfig>);\n  if (!isRecord(candidate)) return [];\n  return toAcpMcpServers(candidate, cwd);\n}\n\nfunction sdkInfoToAcpSessionInfo(raw: SdkSessionInfo): AcpSessionInfo {\n  return {\n    sessionId: raw.sessionId,\n    cwd: raw.cwd,\n    ...(raw.title ? { title: raw.title } : {}),\n    ...(raw.updatedAt ? { updatedAt: raw.updatedAt } : {}),\n  };\n}\n\nfunction sdkOptionToAcpConfigOption(raw: SdkSessionConfigOption): AcpConfigOption | null {\n  const rawRecord = raw as Record<string, unknown>;\n  const type = rawRecord['type'];\n  if (type !== 'select' && type !== 'boolean') return null;\n  const currentValueRaw = rawRecord['currentValue'];\n  const currentValue = typeof currentValueRaw === 'string' ? currentValueRaw : '';\n  const rawOptions = rawRecord['options'];\n  const options: AcpConfigOption['options'] = Array.isArray(rawOptions)\n    ? rawOptions\n        .filter((o): o is Record<string, unknown> => isRecord(o))\n        .map((o) => ({\n          value: typeof o['value'] === 'string' ? o['value'] : '',\n          name: typeof o['name'] === 'string' ? o['name'] : '',\n          description: typeof o['description'] === 'string' ? o['description'] : null,\n        }))\n    : [];\n  const configType: 'select' | 'boolean' = type === 'select' ? 'select' : 'boolean';\n  return {\n    id: raw.id,\n    name: raw.name,\n    description: raw.description ?? null,\n    category: raw.category ?? null,\n    type: configType,\n    currentValue,\n    options,\n  };\n}\n\n/** Calls `session/list` on an already-initialized connection. */\nexport async function listAcpSessionsViaConnection(\n  connection: ClientSideConnection,\n  opts?: { cwd?: string; cursor?: string }\n): Promise<{ sessions: AcpSessionInfo[]; nextCursor?: string }> {\n  const resp = (await connection.listSessions({\n    ...(opts?.cwd ? { cwd: opts.cwd } : {}),\n    ...(opts?.cursor ? { cursor: opts.cursor } : {}),\n  })) as SdkListSessionsResponse;\n  const sessions: SdkSessionInfo[] = resp.sessions ?? [];\n  return {\n    sessions: sessions.map(sdkInfoToAcpSessionInfo),\n    ...(resp.nextCursor ? { nextCursor: resp.nextCursor } : {}),\n  };\n}\n\n/** Calls `session/set_config_option` on an already-initialized connection. */\nexport async function setAcpConfigOptionViaConnection(\n  connection: ClientSideConnection,\n  sessionId: string,\n  configId: string,\n  value: string\n): Promise<AcpConfigOption[]> {\n  const resp = (await connection.setSessionConfigOption({\n    sessionId,\n    configId,\n    value,\n  })) as SdkSetSessionConfigOptionResponse;\n  const rawOpts: SdkSessionConfigOption[] = resp.configOptions ?? [];\n  return rawOpts\n    .map((o: SdkSessionConfigOption) => sdkOptionToAcpConfigOption(o))\n    .filter((o: AcpConfigOption | null): o is AcpConfigOption => o !== null);\n}\n\n/** Parses `configOptions` from any session setup response (newSession / loadSession / resumeSession). */\nexport function parseAcpConfigOptions(response: unknown): AcpConfigOption[] {\n  if (!isRecord(response)) return [];\n  const raw = response['configOptions'];\n  if (!Array.isArray(raw)) return [];\n  return raw\n    .map((o) => sdkOptionToAcpConfigOption(o as SdkSessionConfigOption))\n    .filter((o): o is AcpConfigOption => o !== null);\n}\n"],
+  "mappings": "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",
+  "names": []
+}

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

@@ -0,0 +1,66 @@
+import { ClientSideConnection } from '@agentclientprotocol/sdk';
+import { type AcpCliBackendConfig, type AcpConfigOption, type AcpMcpServerSpec, type AcpSessionInfo } from './acp-cli-helpers.js';
+export type { AcpConfigOption, AcpSessionInfo };
+/** Result of a successful `session/fork` operation. */
+export type AcpForkedSession = {
+    /** ID of the newly forked session. */
+    sessionId: string;
+    /** Config options reported by the agent for the forked session, if any. */
+    configOptions?: AcpConfigOption[];
+};
+/**
+ * Calls the unstable `session/fork` on an already-initialized connection.
+ * Throws if the agent does not implement `unstable_forkSession`.
+ */
+export declare function forkAcpSessionViaConnection(connection: ClientSideConnection, sessionId: string, opts?: {
+    cwd?: string;
+    mcpServers?: AcpMcpServerSpec[];
+}): Promise<AcpForkedSession>;
+/**
+ * Result of a full ACP capability probe against a running agent.
+ * Each surface is either `'supported'` or `'unsupported'`.
+ */
+export type AcpCapabilityMatrix = {
+    protocolVersion: number | null;
+    sessionList: 'supported' | 'unsupported';
+    sessionClose: 'supported' | 'unsupported';
+    sessionResume: 'supported' | 'unsupported';
+    /** Whether the agent supports `session/fork` (unstable). */
+    sessionFork: 'supported' | 'unsupported';
+    configOptions: 'supported' | 'unsupported';
+    mcpHttp: 'supported' | 'unsupported';
+    mcpSse: 'supported' | 'unsupported';
+    /** Sessions returned by `session/list` (only when `sessionList === 'supported'`). */
+    sessions?: AcpSessionInfo[];
+    sessionNextCursor?: string;
+    /** Config options returned by `session/new` (only when `configOptions === 'supported'`). */
+    options?: AcpConfigOption[];
+};
+/**
+ * Spawns the ACP agent, runs a full capability probe, and returns a
+ * {@link AcpCapabilityMatrix} describing which optional protocol surfaces
+ * the agent supports.  No prompts are sent; the probe only calls
+ * `initialize`, optionally `session/list`, `session/new` (to read
+ * `configOptions`), and `session/close`.
+ */
+export declare function probeAcpCapabilities(config?: AcpCliBackendConfig, opts?: {
+    cwd?: string;
+    timeoutMs?: number;
+}): Promise<AcpCapabilityMatrix>;
+/**
+ * Lists sessions known to the ACP agent.  Spawns a fresh process, calls
+ * `initialize` + `session/list`, then terminates it.
+ *
+ * Returns `{ supported: false }` when the agent does not advertise the
+ * `session/list` capability.
+ */
+export declare function listAcpSessions(config?: AcpCliBackendConfig, opts?: {
+    cwd?: string;
+    cursor?: string;
+    timeoutMs?: number;
+}): Promise<{
+    sessions: AcpSessionInfo[];
+    nextCursor?: string;
+    supported: boolean;
+}>;
+//# sourceMappingURL=acp-cli-probe.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"acp-cli-probe.d.ts","sourceRoot":"","sources":["../../../../src/adapters/agents/backends/acp-cli-probe.ts"],"names":[],"mappings":"AAIA,OAAO,EACL,oBAAoB,EAGrB,MAAM,0BAA0B,CAAC;AAElC,OAAO,EACL,KAAK,mBAAmB,EACxB,KAAK,eAAe,EACpB,KAAK,gBAAgB,EACrB,KAAK,cAAc,EAQpB,MAAM,sBAAsB,CAAC;AAE9B,YAAY,EAAE,eAAe,EAAE,cAAc,EAAE,CAAC;AAEhD,uDAAuD;AACvD,MAAM,MAAM,gBAAgB,GAAG;IAC7B,sCAAsC;IACtC,SAAS,EAAE,MAAM,CAAC;IAClB,2EAA2E;IAC3E,aAAa,CAAC,EAAE,eAAe,EAAE,CAAC;CACnC,CAAC;AAMF;;;GAGG;AACH,wBAAsB,2BAA2B,CAC/C,UAAU,EAAE,oBAAoB,EAChC,SAAS,EAAE,MAAM,EACjB,IAAI,CAAC,EAAE;IAAE,GAAG,CAAC,EAAE,MAAM,CAAC;IAAC,UAAU,CAAC,EAAE,gBAAgB,EAAE,CAAA;CAAE,GACvD,OAAO,CAAC,gBAAgB,CAAC,CAqB3B;AAED;;;GAGG;AACH,MAAM,MAAM,mBAAmB,GAAG;IAChC,eAAe,EAAE,MAAM,GAAG,IAAI,CAAC;IAC/B,WAAW,EAAE,WAAW,GAAG,aAAa,CAAC;IACzC,YAAY,EAAE,WAAW,GAAG,aAAa,CAAC;IAC1C,aAAa,EAAE,WAAW,GAAG,aAAa,CAAC;IAC3C,4DAA4D;IAC5D,WAAW,EAAE,WAAW,GAAG,aAAa,CAAC;IACzC,aAAa,EAAE,WAAW,GAAG,aAAa,CAAC;IAC3C,OAAO,EAAE,WAAW,GAAG,aAAa,CAAC;IACrC,MAAM,EAAE,WAAW,GAAG,aAAa,CAAC;IACpC,qFAAqF;IACrF,QAAQ,CAAC,EAAE,cAAc,EAAE,CAAC;IAC5B,iBAAiB,CAAC,EAAE,MAAM,CAAC;IAC3B,4FAA4F;IAC5F,OAAO,CAAC,EAAE,eAAe,EAAE,CAAC;CAC7B,CAAC;AAiBF;;;;;;GAMG;AACH,wBAAsB,oBAAoB,CACxC,MAAM,GAAE,mBAAwB,EAChC,IAAI,CAAC,EAAE;IAAE,GAAG,CAAC,EAAE,MAAM,CAAC;IAAC,SAAS,CAAC,EAAE,MAAM,CAAA;CAAE,GAC1C,OAAO,CAAC,mBAAmB,CAAC,CA2E9B;AAED;;;;;;GAMG;AACH,wBAAsB,eAAe,CACnC,MAAM,GAAE,mBAAwB,EAChC,IAAI,CAAC,EAAE;IAAE,GAAG,CAAC,EAAE,MAAM,CAAC;IAAC,MAAM,CAAC,EAAE,MAAM,CAAC;IAAC,SAAS,CAAC,EAAE,MAAM,CAAA;CAAE,GAC3D,OAAO,CAAC;IAAE,QAAQ,EAAE,cAAc,EAAE,CAAC;IAAC,UAAU,CAAC,EAAE,MAAM,CAAC;IAAC,SAAS,EAAE,OAAO,CAAA;CAAE,CAAC,CAoClF"}

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

@@ -0,0 +1,150 @@
+import { spawn } from "node:child_process";
+import { Readable, Writable } from "node:stream";
+import {
+  ClientSideConnection,
+  ndJsonStream,
+  PROTOCOL_VERSION
+} from "@agentclientprotocol/sdk";
+import {
+  closeAcpSessionIfSupported,
+  HANDSHAKE_TIMEOUT_MS,
+  listAcpSessionsViaConnection,
+  parseAcpConfigOptions,
+  resolveAcpAgentCapabilities,
+  resolveAcpAgentCommand,
+  withAcpTimeout
+} from "./acp-cli-helpers.js";
+function isRecord(value) {
+  return typeof value === "object" && value !== null && !Array.isArray(value);
+}
+async function forkAcpSessionViaConnection(connection, sessionId, opts) {
+  const maybeFork = connection.unstable_forkSession;
+  if (!maybeFork) throw new Error("session/fork is not supported by this agent");
+  const resp = await maybeFork.call(connection, {
+    sessionId,
+    cwd: opts?.cwd ?? process.cwd(),
+    ...opts?.mcpServers ? { mcpServers: opts.mcpServers } : {}
+  });
+  const rawId = isRecord(resp) && typeof resp["sessionId"] === "string" ? resp["sessionId"] : "";
+  const configOptions = parseAcpConfigOptions(resp);
+  return {
+    sessionId: rawId,
+    ...configOptions.length > 0 ? { configOptions } : {}
+  };
+}
+function resolveCommand(config) {
+  if (config.command) return { cmd: config.command, cmdArgs: config.args ?? [] };
+  const agent = config.agent ?? process.env.ACP_AGENT ?? "claude";
+  const { command: cmd, args: cmdArgs } = resolveAcpAgentCommand(agent, config.agentOverrides);
+  return { cmd, cmdArgs };
+}
+function makeNullClient() {
+  return {
+    sessionUpdate: () => Promise.resolve(),
+    requestPermission: () => Promise.resolve({ outcome: { outcome: "cancelled" } })
+  };
+}
+async function probeAcpCapabilities(config = {}, opts) {
+  const { cmd, cmdArgs } = resolveCommand(config);
+  const timeoutMs = opts?.timeoutMs ?? HANDSHAKE_TIMEOUT_MS;
+  const sessionCwd = opts?.cwd ?? process.cwd();
+  const child = spawn(cmd, cmdArgs, {
+    stdio: ["pipe", "pipe", "inherit"],
+    env: process.env
+  });
+  try {
+    const stream = ndJsonStream(
+      Writable.toWeb(child.stdin),
+      Readable.toWeb(child.stdout)
+    );
+    const connection = new ClientSideConnection(makeNullClient, stream);
+    const initResult = await withAcpTimeout(
+      connection.initialize({
+        protocolVersion: PROTOCOL_VERSION,
+        clientCapabilities: {},
+        clientInfo: { name: "octoflow-core", title: "OctoFlow", version: "1.0.0" }
+      }),
+      timeoutMs
+    );
+    const caps = resolveAcpAgentCapabilities(initResult);
+    const matrix = {
+      protocolVersion: caps.protocolVersion,
+      sessionList: caps.canListSessions ? "supported" : "unsupported",
+      sessionClose: caps.canCloseSession ? "supported" : "unsupported",
+      sessionResume: caps.canResumeSession ? "supported" : "unsupported",
+      sessionFork: caps.canForkSession ? "supported" : "unsupported",
+      configOptions: "unsupported",
+      mcpHttp: caps.supportsMcpHttp ? "supported" : "unsupported",
+      mcpSse: caps.supportsMcpSse ? "supported" : "unsupported"
+    };
+    if (caps.canListSessions) {
+      const listed = await withAcpTimeout(
+        listAcpSessionsViaConnection(connection, { cwd: sessionCwd }),
+        timeoutMs
+      ).catch(() => null);
+      if (listed) {
+        matrix.sessions = listed.sessions;
+        if (listed.nextCursor) matrix.sessionNextCursor = listed.nextCursor;
+      }
+    }
+    const sessionResp = await withAcpTimeout(
+      connection.newSession({ cwd: sessionCwd, mcpServers: [] }),
+      timeoutMs
+    ).catch(() => null);
+    if (sessionResp) {
+      const sessionId = sessionResp.sessionId ?? "";
+      const rawOptions = parseAcpConfigOptions(sessionResp);
+      if (rawOptions.length > 0) {
+        matrix.configOptions = "supported";
+        matrix.options = rawOptions;
+      }
+      if (caps.canCloseSession && sessionId) {
+        await withAcpTimeout(
+          closeAcpSessionIfSupported(connection, sessionId, true),
+          2e3
+        ).catch(() => void 0);
+      }
+    }
+    return matrix;
+  } finally {
+    if (!child.killed) child.kill();
+  }
+}
+async function listAcpSessions(config = {}, opts) {
+  const { cmd, cmdArgs } = resolveCommand(config);
+  const timeoutMs = opts?.timeoutMs ?? HANDSHAKE_TIMEOUT_MS;
+  const child = spawn(cmd, cmdArgs, {
+    stdio: ["pipe", "pipe", "inherit"],
+    env: process.env
+  });
+  try {
+    const stream = ndJsonStream(
+      Writable.toWeb(child.stdin),
+      Readable.toWeb(child.stdout)
+    );
+    const connection = new ClientSideConnection(makeNullClient, stream);
+    const initResult = await withAcpTimeout(
+      connection.initialize({
+        protocolVersion: PROTOCOL_VERSION,
+        clientCapabilities: {},
+        clientInfo: { name: "octoflow-core", title: "OctoFlow", version: "1.0.0" }
+      }),
+      timeoutMs
+    );
+    const caps = resolveAcpAgentCapabilities(initResult);
+    if (!caps.canListSessions) return { sessions: [], supported: false };
+    const result = await withAcpTimeout(
+      listAcpSessionsViaConnection(connection, { cwd: opts?.cwd, cursor: opts?.cursor }),
+      timeoutMs
+    );
+    return { ...result, supported: true };
+  } finally {
+    if (!child.killed) child.kill();
+  }
+}
+export {
+  forkAcpSessionViaConnection,
+  listAcpSessions,
+  probeAcpCapabilities
+};
+//# sourceMappingURL=acp-cli-probe.js.map

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

@@ -0,0 +1,7 @@
+{
+  "version": 3,
+  "sources": ["../../../../src/adapters/agents/backends/acp-cli-probe.ts"],
+  "sourcesContent": ["import { spawn } from 'node:child_process';\nimport { Readable, Writable } from 'node:stream';\n\nimport type { NewSessionResponse } from '@agentclientprotocol/sdk';\nimport {\n  ClientSideConnection,\n  ndJsonStream,\n  PROTOCOL_VERSION,\n} from '@agentclientprotocol/sdk';\n\nimport {\n  type AcpCliBackendConfig,\n  type AcpConfigOption,\n  type AcpMcpServerSpec,\n  type AcpSessionInfo,\n  closeAcpSessionIfSupported,\n  HANDSHAKE_TIMEOUT_MS,\n  listAcpSessionsViaConnection,\n  parseAcpConfigOptions,\n  resolveAcpAgentCapabilities,\n  resolveAcpAgentCommand,\n  withAcpTimeout,\n} from './acp-cli-helpers.js';\n\nexport type { AcpConfigOption, AcpSessionInfo };\n\n/** Result of a successful `session/fork` operation. */\nexport type AcpForkedSession = {\n  /** ID of the newly forked session. */\n  sessionId: string;\n  /** Config options reported by the agent for the forked session, if any. */\n  configOptions?: AcpConfigOption[];\n};\n\nfunction isRecord(value: unknown): value is Record<string, unknown> {\n  return typeof value === 'object' && value !== null && !Array.isArray(value);\n}\n\n/**\n * Calls the unstable `session/fork` on an already-initialized connection.\n * Throws if the agent does not implement `unstable_forkSession`.\n */\nexport async function forkAcpSessionViaConnection(\n  connection: ClientSideConnection,\n  sessionId: string,\n  opts?: { cwd?: string; mcpServers?: AcpMcpServerSpec[] }\n): Promise<AcpForkedSession> {\n  type MaybeFork = ClientSideConnection & {\n    unstable_forkSession?: (params: {\n      sessionId: string;\n      cwd: string;\n      mcpServers?: AcpMcpServerSpec[];\n    }) => Promise<unknown>;\n  };\n  const maybeFork = (connection as MaybeFork).unstable_forkSession;\n  if (!maybeFork) throw new Error('session/fork is not supported by this agent');\n  const resp = await maybeFork.call(connection, {\n    sessionId,\n    cwd: opts?.cwd ?? process.cwd(),\n    ...(opts?.mcpServers ? { mcpServers: opts.mcpServers } : {}),\n  });\n  const rawId = isRecord(resp) && typeof resp['sessionId'] === 'string' ? resp['sessionId'] : '';\n  const configOptions = parseAcpConfigOptions(resp);\n  return {\n    sessionId: rawId,\n    ...(configOptions.length > 0 ? { configOptions } : {}),\n  };\n}\n\n/**\n * Result of a full ACP capability probe against a running agent.\n * Each surface is either `'supported'` or `'unsupported'`.\n */\nexport type AcpCapabilityMatrix = {\n  protocolVersion: number | null;\n  sessionList: 'supported' | 'unsupported';\n  sessionClose: 'supported' | 'unsupported';\n  sessionResume: 'supported' | 'unsupported';\n  /** Whether the agent supports `session/fork` (unstable). */\n  sessionFork: 'supported' | 'unsupported';\n  configOptions: 'supported' | 'unsupported';\n  mcpHttp: 'supported' | 'unsupported';\n  mcpSse: 'supported' | 'unsupported';\n  /** Sessions returned by `session/list` (only when `sessionList === 'supported'`). */\n  sessions?: AcpSessionInfo[];\n  sessionNextCursor?: string;\n  /** Config options returned by `session/new` (only when `configOptions === 'supported'`). */\n  options?: AcpConfigOption[];\n};\n\nfunction resolveCommand(config: AcpCliBackendConfig): { cmd: string; cmdArgs: string[] } {\n  if (config.command) return { cmd: config.command, cmdArgs: config.args ?? [] };\n  const agent = config.agent ?? process.env.ACP_AGENT ?? 'claude';\n  const { command: cmd, args: cmdArgs } = resolveAcpAgentCommand(agent, config.agentOverrides);\n  return { cmd, cmdArgs };\n}\n\nfunction makeNullClient() {\n  return {\n    sessionUpdate: () => Promise.resolve(),\n    requestPermission: () =>\n      Promise.resolve({ outcome: { outcome: 'cancelled' as const } }),\n  };\n}\n\n/**\n * Spawns the ACP agent, runs a full capability probe, and returns a\n * {@link AcpCapabilityMatrix} describing which optional protocol surfaces\n * the agent supports.  No prompts are sent; the probe only calls\n * `initialize`, optionally `session/list`, `session/new` (to read\n * `configOptions`), and `session/close`.\n */\nexport async function probeAcpCapabilities(\n  config: AcpCliBackendConfig = {},\n  opts?: { cwd?: string; timeoutMs?: number }\n): Promise<AcpCapabilityMatrix> {\n  const { cmd, cmdArgs } = resolveCommand(config);\n  const timeoutMs = opts?.timeoutMs ?? HANDSHAKE_TIMEOUT_MS;\n  const sessionCwd = opts?.cwd ?? process.cwd();\n\n  const child = spawn(cmd, cmdArgs, {\n    stdio: ['pipe', 'pipe', 'inherit'],\n    env: process.env,\n  });\n\n  try {\n    const stream = ndJsonStream(\n      Writable.toWeb(child.stdin) as WritableStream<Uint8Array>,\n      Readable.toWeb(child.stdout) as ReadableStream<Uint8Array>\n    );\n    const connection = new ClientSideConnection(makeNullClient, stream);\n\n    const initResult: unknown = await withAcpTimeout<unknown>(\n      connection.initialize({\n        protocolVersion: PROTOCOL_VERSION,\n        clientCapabilities: {},\n        clientInfo: { name: 'octoflow-core', title: 'OctoFlow', version: '1.0.0' },\n      }),\n      timeoutMs\n    );\n\n    const caps = resolveAcpAgentCapabilities(initResult);\n\n    const matrix: AcpCapabilityMatrix = {\n      protocolVersion: caps.protocolVersion,\n      sessionList: caps.canListSessions ? 'supported' : 'unsupported',\n      sessionClose: caps.canCloseSession ? 'supported' : 'unsupported',\n      sessionResume: caps.canResumeSession ? 'supported' : 'unsupported',\n      sessionFork: caps.canForkSession ? 'supported' : 'unsupported',\n      configOptions: 'unsupported',\n      mcpHttp: caps.supportsMcpHttp ? 'supported' : 'unsupported',\n      mcpSse: caps.supportsMcpSse ? 'supported' : 'unsupported',\n    };\n\n    if (caps.canListSessions) {\n      const listed = await withAcpTimeout(\n        listAcpSessionsViaConnection(connection, { cwd: sessionCwd }),\n        timeoutMs\n      ).catch(() => null);\n      if (listed) {\n        matrix.sessions = listed.sessions;\n        if (listed.nextCursor) matrix.sessionNextCursor = listed.nextCursor;\n      }\n    }\n\n    const sessionResp: unknown = await withAcpTimeout<unknown>(\n      connection.newSession({ cwd: sessionCwd, mcpServers: [] }),\n      timeoutMs\n    ).catch(() => null);\n\n    if (sessionResp) {\n      const sessionId = (sessionResp as NewSessionResponse).sessionId ?? '';\n      const rawOptions = parseAcpConfigOptions(sessionResp);\n      if (rawOptions.length > 0) {\n        matrix.configOptions = 'supported';\n        matrix.options = rawOptions;\n      }\n\n      if (caps.canCloseSession && sessionId) {\n        await withAcpTimeout(\n          closeAcpSessionIfSupported(connection, sessionId, true),\n          2_000\n        ).catch(() => undefined);\n      }\n    }\n\n    return matrix;\n  } finally {\n    if (!child.killed) child.kill();\n  }\n}\n\n/**\n * Lists sessions known to the ACP agent.  Spawns a fresh process, calls\n * `initialize` + `session/list`, then terminates it.\n *\n * Returns `{ supported: false }` when the agent does not advertise the\n * `session/list` capability.\n */\nexport async function listAcpSessions(\n  config: AcpCliBackendConfig = {},\n  opts?: { cwd?: string; cursor?: string; timeoutMs?: number }\n): Promise<{ sessions: AcpSessionInfo[]; nextCursor?: string; supported: boolean }> {\n  const { cmd, cmdArgs } = resolveCommand(config);\n  const timeoutMs = opts?.timeoutMs ?? HANDSHAKE_TIMEOUT_MS;\n\n  const child = spawn(cmd, cmdArgs, {\n    stdio: ['pipe', 'pipe', 'inherit'],\n    env: process.env,\n  });\n\n  try {\n    const stream = ndJsonStream(\n      Writable.toWeb(child.stdin) as WritableStream<Uint8Array>,\n      Readable.toWeb(child.stdout) as ReadableStream<Uint8Array>\n    );\n    const connection = new ClientSideConnection(makeNullClient, stream);\n\n    const initResult: unknown = await withAcpTimeout<unknown>(\n      connection.initialize({\n        protocolVersion: PROTOCOL_VERSION,\n        clientCapabilities: {},\n        clientInfo: { name: 'octoflow-core', title: 'OctoFlow', version: '1.0.0' },\n      }),\n      timeoutMs\n    );\n\n    const caps = resolveAcpAgentCapabilities(initResult);\n    if (!caps.canListSessions) return { sessions: [], supported: false };\n\n    const result = await withAcpTimeout(\n      listAcpSessionsViaConnection(connection, { cwd: opts?.cwd, cursor: opts?.cursor }),\n      timeoutMs\n    );\n    return { ...result, supported: true };\n  } finally {\n    if (!child.killed) child.kill();\n  }\n}\n"],
+  "mappings": "AAAA,SAAS,aAAa;AACtB,SAAS,UAAU,gBAAgB;AAGnC;AAAA,EACE;AAAA,EACA;AAAA,EACA;AAAA,OACK;AAEP;AAAA,EAKE;AAAA,EACA;AAAA,EACA;AAAA,EACA;AAAA,EACA;AAAA,EACA;AAAA,EACA;AAAA,OACK;AAYP,SAAS,SAAS,OAAkD;AAClE,SAAO,OAAO,UAAU,YAAY,UAAU,QAAQ,CAAC,MAAM,QAAQ,KAAK;AAC5E;AAMA,eAAsB,4BACpB,YACA,WACA,MAC2B;AAQ3B,QAAM,YAAa,WAAyB;AAC5C,MAAI,CAAC,UAAW,OAAM,IAAI,MAAM,6CAA6C;AAC7E,QAAM,OAAO,MAAM,UAAU,KAAK,YAAY;AAAA,IAC5C;AAAA,IACA,KAAK,MAAM,OAAO,QAAQ,IAAI;AAAA,IAC9B,GAAI,MAAM,aAAa,EAAE,YAAY,KAAK,WAAW,IAAI,CAAC;AAAA,EAC5D,CAAC;AACD,QAAM,QAAQ,SAAS,IAAI,KAAK,OAAO,KAAK,WAAW,MAAM,WAAW,KAAK,WAAW,IAAI;AAC5F,QAAM,gBAAgB,sBAAsB,IAAI;AAChD,SAAO;AAAA,IACL,WAAW;AAAA,IACX,GAAI,cAAc,SAAS,IAAI,EAAE,cAAc,IAAI,CAAC;AAAA,EACtD;AACF;AAuBA,SAAS,eAAe,QAAiE;AACvF,MAAI,OAAO,QAAS,QAAO,EAAE,KAAK,OAAO,SAAS,SAAS,OAAO,QAAQ,CAAC,EAAE;AAC7E,QAAM,QAAQ,OAAO,SAAS,QAAQ,IAAI,aAAa;AACvD,QAAM,EAAE,SAAS,KAAK,MAAM,QAAQ,IAAI,uBAAuB,OAAO,OAAO,cAAc;AAC3F,SAAO,EAAE,KAAK,QAAQ;AACxB;AAEA,SAAS,iBAAiB;AACxB,SAAO;AAAA,IACL,eAAe,MAAM,QAAQ,QAAQ;AAAA,IACrC,mBAAmB,MACjB,QAAQ,QAAQ,EAAE,SAAS,EAAE,SAAS,YAAqB,EAAE,CAAC;AAAA,EAClE;AACF;AASA,eAAsB,qBACpB,SAA8B,CAAC,GAC/B,MAC8B;AAC9B,QAAM,EAAE,KAAK,QAAQ,IAAI,eAAe,MAAM;AAC9C,QAAM,YAAY,MAAM,aAAa;AACrC,QAAM,aAAa,MAAM,OAAO,QAAQ,IAAI;AAE5C,QAAM,QAAQ,MAAM,KAAK,SAAS;AAAA,IAChC,OAAO,CAAC,QAAQ,QAAQ,SAAS;AAAA,IACjC,KAAK,QAAQ;AAAA,EACf,CAAC;AAED,MAAI;AACF,UAAM,SAAS;AAAA,MACb,SAAS,MAAM,MAAM,KAAK;AAAA,MAC1B,SAAS,MAAM,MAAM,MAAM;AAAA,IAC7B;AACA,UAAM,aAAa,IAAI,qBAAqB,gBAAgB,MAAM;AAElE,UAAM,aAAsB,MAAM;AAAA,MAChC,WAAW,WAAW;AAAA,QACpB,iBAAiB;AAAA,QACjB,oBAAoB,CAAC;AAAA,QACrB,YAAY,EAAE,MAAM,iBAAiB,OAAO,YAAY,SAAS,QAAQ;AAAA,MAC3E,CAAC;AAAA,MACD;AAAA,IACF;AAEA,UAAM,OAAO,4BAA4B,UAAU;AAEnD,UAAM,SAA8B;AAAA,MAClC,iBAAiB,KAAK;AAAA,MACtB,aAAa,KAAK,kBAAkB,cAAc;AAAA,MAClD,cAAc,KAAK,kBAAkB,cAAc;AAAA,MACnD,eAAe,KAAK,mBAAmB,cAAc;AAAA,MACrD,aAAa,KAAK,iBAAiB,cAAc;AAAA,MACjD,eAAe;AAAA,MACf,SAAS,KAAK,kBAAkB,cAAc;AAAA,MAC9C,QAAQ,KAAK,iBAAiB,cAAc;AAAA,IAC9C;AAEA,QAAI,KAAK,iBAAiB;AACxB,YAAM,SAAS,MAAM;AAAA,QACnB,6BAA6B,YAAY,EAAE,KAAK,WAAW,CAAC;AAAA,QAC5D;AAAA,MACF,EAAE,MAAM,MAAM,IAAI;AAClB,UAAI,QAAQ;AACV,eAAO,WAAW,OAAO;AACzB,YAAI,OAAO,WAAY,QAAO,oBAAoB,OAAO;AAAA,MAC3D;AAAA,IACF;AAEA,UAAM,cAAuB,MAAM;AAAA,MACjC,WAAW,WAAW,EAAE,KAAK,YAAY,YAAY,CAAC,EAAE,CAAC;AAAA,MACzD;AAAA,IACF,EAAE,MAAM,MAAM,IAAI;AAElB,QAAI,aAAa;AACf,YAAM,YAAa,YAAmC,aAAa;AACnE,YAAM,aAAa,sBAAsB,WAAW;AACpD,UAAI,WAAW,SAAS,GAAG;AACzB,eAAO,gBAAgB;AACvB,eAAO,UAAU;AAAA,MACnB;AAEA,UAAI,KAAK,mBAAmB,WAAW;AACrC,cAAM;AAAA,UACJ,2BAA2B,YAAY,WAAW,IAAI;AAAA,UACtD;AAAA,QACF,EAAE,MAAM,MAAM,MAAS;AAAA,MACzB;AAAA,IACF;AAEA,WAAO;AAAA,EACT,UAAE;AACA,QAAI,CAAC,MAAM,OAAQ,OAAM,KAAK;AAAA,EAChC;AACF;AASA,eAAsB,gBACpB,SAA8B,CAAC,GAC/B,MACkF;AAClF,QAAM,EAAE,KAAK,QAAQ,IAAI,eAAe,MAAM;AAC9C,QAAM,YAAY,MAAM,aAAa;AAErC,QAAM,QAAQ,MAAM,KAAK,SAAS;AAAA,IAChC,OAAO,CAAC,QAAQ,QAAQ,SAAS;AAAA,IACjC,KAAK,QAAQ;AAAA,EACf,CAAC;AAED,MAAI;AACF,UAAM,SAAS;AAAA,MACb,SAAS,MAAM,MAAM,KAAK;AAAA,MAC1B,SAAS,MAAM,MAAM,MAAM;AAAA,IAC7B;AACA,UAAM,aAAa,IAAI,qBAAqB,gBAAgB,MAAM;AAElE,UAAM,aAAsB,MAAM;AAAA,MAChC,WAAW,WAAW;AAAA,QACpB,iBAAiB;AAAA,QACjB,oBAAoB,CAAC;AAAA,QACrB,YAAY,EAAE,MAAM,iBAAiB,OAAO,YAAY,SAAS,QAAQ;AAAA,MAC3E,CAAC;AAAA,MACD;AAAA,IACF;AAEA,UAAM,OAAO,4BAA4B,UAAU;AACnD,QAAI,CAAC,KAAK,gBAAiB,QAAO,EAAE,UAAU,CAAC,GAAG,WAAW,MAAM;AAEnE,UAAM,SAAS,MAAM;AAAA,MACnB,6BAA6B,YAAY,EAAE,KAAK,MAAM,KAAK,QAAQ,MAAM,OAAO,CAAC;AAAA,MACjF;AAAA,IACF;AACA,WAAO,EAAE,GAAG,QAAQ,WAAW,KAAK;AAAA,EACtC,UAAE;AACA,QAAI,CAAC,MAAM,OAAQ,OAAM,KAAK;AAAA,EAChC;AACF;",
+  "names": []
+}

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

@@ -0,0 +1,9 @@
+import type { Backend } from '../../../domain/contracts/backends.js';
+import { ACP_AGENT_REGISTRY, type AcpCliBackendConfig, type AcpConfigOption, type AcpSessionInfo, listAcpSessionsViaConnection, mapAcpSessionUpdate, parseAcpConfigOptions, resolveAcpAgentCommand, setAcpConfigOptionViaConnection, toAcpToolLocations } from './acp-cli-helpers.js';
+export type { AcpElicitationField, AcpElicitationRequest, AcpElicitationResponse } from './acp-cli-elicitation.js';
+export type { AcpCapabilityMatrix, AcpForkedSession } from './acp-cli-probe.js';
+export type { AcpCliBackendConfig, AcpConfigOption, AcpSessionInfo };
+export { ACP_AGENT_REGISTRY, listAcpSessionsViaConnection, mapAcpSessionUpdate, parseAcpConfigOptions, resolveAcpAgentCommand, setAcpConfigOptionViaConnection, toAcpToolLocations, };
+export { forkAcpSessionViaConnection, listAcpSessions, probeAcpCapabilities } from './acp-cli-probe.js';
+export declare function createAcpCliBackend(config?: AcpCliBackendConfig): Backend;
+//# sourceMappingURL=acp-cli.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"acp-cli.d.ts","sourceRoot":"","sources":["../../../../src/adapters/agents/backends/acp-cli.ts"],"names":[],"mappings":"AAkBA,OAAO,KAAK,EACV,OAAO,EAKR,MAAM,uCAAuC,CAAC;AAS/C,OAAO,EACL,kBAAkB,EAClB,KAAK,mBAAmB,EACxB,KAAK,eAAe,EAEpB,KAAK,cAAc,EAKnB,4BAA4B,EAC5B,mBAAmB,EACnB,qBAAqB,EAGrB,sBAAsB,EACtB,+BAA+B,EAC/B,kBAAkB,EAEnB,MAAM,sBAAsB,CAAC;AAO9B,YAAY,EAAE,mBAAmB,EAAE,qBAAqB,EAAE,sBAAsB,EAAE,MAAM,0BAA0B,CAAC;AACnH,YAAY,EAAE,mBAAmB,EAAE,gBAAgB,EAAE,MAAM,oBAAoB,CAAC;AAChF,YAAY,EAAE,mBAAmB,EAAE,eAAe,EAAE,cAAc,EAAE,CAAC;AACrE,OAAO,EACL,kBAAkB,EAClB,4BAA4B,EAC5B,mBAAmB,EACnB,qBAAqB,EACrB,sBAAsB,EACtB,+BAA+B,EAC/B,kBAAkB,GACnB,CAAC;AACF,OAAO,EAAE,2BAA2B,EAAE,eAAe,EAAE,oBAAoB,EAAE,MAAM,oBAAoB,CAAC;AAkPxG,wBAAgB,mBAAmB,CAAC,MAAM,GAAE,mBAAwB,GAAG,OAAO,CAiE7E"}