@ycodium-ai/agent-acp 0.2.2167 → 0.2.2510

package/README.md

@@ -1,31 +1,18 @@
 # @ycodium-ai/agent-acp
 
 Generic ACP executor plugin. The user supplies the CLI (`binaryPath` + `launchArgs`); this package
-spawns it over stdio and runs `ycodium-acp-executor` against `ycodium-acp-protocol`.
+spawns it over stdio and runs the shared `ycodium-acp-executor` state machine.
 
 - `driverKind` is `acp`, matching the existing generic ACP envelope (`driver: "acp"` plus
   `config.binaryPath` / `config.launchArgs`). Disk format is unchanged.
 - `createInstance` reads that envelope (or a bare settings object) and `startSession` spawns via
   lease-scoped `host.process.spawn`.
 - Manifest permission is `{ kind: "executor" }`.
-- Vendor differences go through `AcpVendorHooks`, never through a second state machine. Today that
-  is Kimi Code (`src/kimi.ts`): its `AskUserQuestion` / `ExitPlanMode` ride on
-  `session/request_permission` and must stay structured user input, and its context usage is read
-  from the CLI's own session log. The instance is recognised by `config.providerId === "kimiCode"`
-  or `homeEnvVar === "KIMI_CODE_HOME"` — both are prefilled by the provider table and hidden from
-  the form, so they beat the user-editable program path.
-
-One card, six grid cells: the five ACP vendor rows in the provider table
-(`kimiCode` / `githubCopilot` / `geminiCli` / `qwenCode` / `hermesAgent`) plus the user-filled
-"Other agent (ACP)" all create `driver: "acp"` instances and are served by this package.
+- There are no vendor presets. A CLI that needs its own behaviour (sign-in, model listing, session
+  logs) gets its own executor plugin built on the same shared ACP machinery, as `agent-kimi` does.
 
 Shipped pre-installed as `core.agent-acp`; the host's built-in `acp` driver was deleted on
-2026-09-18 (contract table `executorPlugin`).
-
-Golden replay (`src/replay.test.ts`) runs the real bytes recorded from `kimi acp` 2.0.1 through
-`test/wireReplayPeer.mjs`. Re-record with
-`apps/server/scripts/record-acp-session.ts`; provenance and what is **not** capturable on this
-machine are in `docs/internals/provider-recordings.md`.
+2026-09-18.
 
 Develop with `vp run --filter @ycodium-ai/agent-acp typecheck`, `build`, and `test`.
 

package/dist/index.js

@@ -9,12 +9,8 @@ import { definePlugin } from "@ycodium-ai/plugin-api";
 
 // src/acpInstance.ts
 import * as NodeOS2 from "node:os";
-import * as NodePath3 from "node:path";
-import {
-  mergeLaunchEnv,
-  modelSelectionStringOption,
-  brainSlotEnvKeys
-} from "@ycodium-ai/plugin-api/executor";
+import * as NodePath2 from "node:path";
+import { mergeLaunchEnv, modelSelectionStringOption } from "@ycodium-ai/plugin-api/executor";
 import { nodeStreamsFromHandle as nodeStreamsFromHandle2 } from "@ycodium-ai/plugin-api/process-stdin";
 
 // ../../packages/ycodium-acp-executor/src/executor.ts
@@ -23405,10 +23401,44 @@ var legacyClientNotificationMethods = /* @__PURE__ */ new Set([
   CLIENT_METHODS.elicitation_complete
 ]);
 
-// ../../packages/ycodium-acp-protocol/src/connection.ts
+// ../../packages/ycodium-acp-executor/src/connection.ts
 import * as NodeStream from "node:stream";
 
-// ../../packages/ycodium-acp-protocol/src/errors.ts
+// ../../packages/ycodium-acp-executor/src/errors.ts
+var AcpExecutorError = class extends Error {
+  code;
+  constructor(code, message) {
+    super(message);
+    this.name = "AcpExecutorError";
+    this.code = code;
+  }
+};
+var AcpExecutorDisposedError = class extends AcpExecutorError {
+  constructor(message = "ACP executor has been disposed") {
+    super("disposed", message);
+    this.name = "AcpExecutorDisposedError";
+  }
+};
+var AcpExecutorNotStartedError = class extends AcpExecutorError {
+  constructor(message = "ACP session has not been started") {
+    super("not-started", message);
+    this.name = "AcpExecutorNotStartedError";
+  }
+};
+var AcpExecutorCancelTimeoutError = class extends AcpExecutorError {
+  constructor(message = "Timed out waiting for session/prompt to finish after cancellation") {
+    super("cancel-timeout", message);
+    this.name = "AcpExecutorCancelTimeoutError";
+  }
+};
+var AcpExecutorRequestError = class extends AcpExecutorError {
+  method;
+  constructor(method, message) {
+    super("request-failed", message);
+    this.name = "AcpExecutorRequestError";
+    this.method = method;
+  }
+};
 var AcpConnectionClosedError = class extends Error {
   constructor(message = "ACP connection closed") {
     super(message);
@@ -23416,7 +23446,7 @@ var AcpConnectionClosedError = class extends Error {
   }
 };
 
-// ../../packages/ycodium-acp-protocol/src/jsonrpc.ts
+// ../../packages/ycodium-acp-executor/src/jsonrpc.ts
 function isRecord2(value) {
   return typeof value === "object" && value !== null;
 }
@@ -23454,7 +23484,7 @@ function readJsonRpcError(value) {
   };
 }
 
-// ../../packages/ycodium-acp-protocol/src/line-buffer.ts
+// ../../packages/ycodium-acp-executor/src/line-buffer.ts
 var newline2 = 10;
 var LineBuffer2 = class {
   #pending = [];
@@ -23498,7 +23528,7 @@ var LineBuffer2 = class {
   }
 };
 
-// ../../packages/ycodium-acp-protocol/src/session-update.ts
+// ../../packages/ycodium-acp-executor/src/session-update.ts
 var KNOWN_SESSION_UPDATES = /* @__PURE__ */ new Set([
   "user_message_chunk",
   "agent_message_chunk",
@@ -23543,7 +23573,7 @@ function decodeSessionUpdate(payload) {
   return { status: "raw", params: payload };
 }
 
-// ../../packages/ycodium-acp-protocol/src/connection.ts
+// ../../packages/ycodium-acp-executor/src/connection.ts
 var textDecoder = new TextDecoder();
 var textEncoder = new TextEncoder();
 function asBytes(chunk) {
@@ -24068,42 +24098,6 @@ var UnboundedEventStream = class {
   }
 };
 
-// ../../packages/ycodium-acp-executor/src/errors.ts
-var AcpExecutorError = class extends Error {
-  code;
-  constructor(code, message) {
-    super(message);
-    this.name = "AcpExecutorError";
-    this.code = code;
-  }
-};
-var AcpExecutorDisposedError = class extends AcpExecutorError {
-  constructor(message = "ACP executor has been disposed") {
-    super("disposed", message);
-    this.name = "AcpExecutorDisposedError";
-  }
-};
-var AcpExecutorNotStartedError = class extends AcpExecutorError {
-  constructor(message = "ACP session has not been started") {
-    super("not-started", message);
-    this.name = "AcpExecutorNotStartedError";
-  }
-};
-var AcpExecutorCancelTimeoutError = class extends AcpExecutorError {
-  constructor(message = "Timed out waiting for session/prompt to finish after cancellation") {
-    super("cancel-timeout", message);
-    this.name = "AcpExecutorCancelTimeoutError";
-  }
-};
-var AcpExecutorRequestError = class extends AcpExecutorError {
-  method;
-  constructor(method, message) {
-    super("request-failed", message);
-    this.name = "AcpExecutorRequestError";
-    this.method = method;
-  }
-};
-
 // ../../packages/ycodium-acp-executor/src/events.ts
 function canonicalRequestTypeFromAcpKind(kind) {
   switch (kind) {
@@ -26399,57 +26393,7 @@ function acpAgentVersion(initializeResult) {
   const agentInfo = initializeResult["agentInfo"];
   return isRecord5(agentInfo) ? asTrimmedString(agentInfo["version"]) ?? null : null;
 }
-var CLI_VERSION_PATTERN = /(?<![\d.])(\d+\.\d+\.\d+(?:-[0-9A-Za-z-]+(?:\.[0-9A-Za-z-]+)*)?)/;
-function parseCliVersion(output2) {
-  return CLI_VERSION_PATTERN.exec(output2)?.[1] ?? null;
-}
-async function collectCappedText(stream, maxBytes) {
-  const decoder = new TextDecoder();
-  let text = "";
-  let total = 0;
-  for await (const chunk of stream) {
-    total += chunk.byteLength;
-    if (total <= maxBytes) text += decoder.decode(chunk, { stream: true });
-  }
-  return { text: text + decoder.decode(), overflowed: total > maxBytes };
-}
-async function collectProbeProcess(child, input2) {
-  try {
-    await child.closeStdin().catch(() => void 0);
-    const [stdout, stderr, exitCode] = await withProbeTimeout(
-      Promise.all([
-        collectCappedText(child.stdout, input2.maxOutputBytes),
-        collectCappedText(child.stderr, input2.maxOutputBytes),
-        child.exited
-      ]),
-      input2.timeoutMs,
-      input2.what
-    );
-    return { stdout: stdout.overflowed ? void 0 : stdout.text, stderr: stderr.text, exitCode };
-  } finally {
-    await child.kill("SIGTERM").catch(() => void 0);
-  }
-}
 var MAX_VERSION_OUTPUT_BYTES = 64 * 1024;
-async function probeCliVersion(input2) {
-  let child;
-  try {
-    child = await input2.spawn();
-  } catch {
-    return null;
-  }
-  try {
-    const run = await collectProbeProcess(child, {
-      timeoutMs: input2.timeoutMs,
-      maxOutputBytes: MAX_VERSION_OUTPUT_BYTES,
-      what: "--version"
-    });
-    if (run.exitCode !== 0) return null;
-    return parseCliVersion(run.stdout ?? "") ?? parseCliVersion(run.stderr);
-  } catch {
-    return null;
-  }
-}
 
 // src/card.ts
 var ACP_DRIVER_KIND = "acp";
@@ -26473,9 +26417,6 @@ var ACP_CARD = {
   defaultTextGenerationModel: "",
   customModelIdExample: "",
   modelSlugAliases: null,
-  modelsDevProviderIds: [],
-  modelsDevSlugPrefixed: false,
-  modelSlugPrefix: "",
   mcpTransports: ["stdio", "http", "sse"],
   pluginManaged: true,
   verifiedSkills: false,
@@ -26500,15 +26441,38 @@ var ACP_CARD = {
   },
   credentialSources: [],
   diagnostics: [],
+  // 设置表单照这份画：带 x-ycodium-form 的属性才进表单（enabled、customModels 等另有入口，不在此列），
+  // 顺序看 x-ycodium-form-order；文案键在本插件 locales/<locale>.json 里解析，宿主不兜底。
   configSchema: {
     type: "object",
+    "x-ycodium-form-order": ["binaryPath", "launchArgs", "homePath"],
     properties: {
-      binaryPath: { type: "string" },
-      launchArgs: { type: "string" },
-      homePath: { type: "string" },
+      binaryPath: {
+        type: "string",
+        "x-ycodium-form": {
+          titleKey: "form.binaryPath.title",
+          descriptionKey: "form.binaryPath.description",
+          placeholderKey: "form.binaryPath.placeholder",
+          control: "executable-path"
+        }
+      },
+      launchArgs: {
+        type: "string",
+        "x-ycodium-form": {
+          titleKey: "form.launchArgs.title",
+          descriptionKey: "form.launchArgs.description",
+          placeholderKey: "form.launchArgs.placeholder"
+        }
+      },
+      homePath: {
+        type: "string",
+        "x-ycodium-form": {
+          titleKey: "form.homePath.title",
+          descriptionKey: "form.homePath.description",
+          placeholderKey: "form.homePath.placeholder"
+        }
+      },
       homeEnvVar: { type: "string" },
-      providerId: { type: "string" },
-      packageName: { type: "string" },
       enabled: { type: "boolean" },
       customModels: { type: "array" },
       driver: { type: "string" },
@@ -26519,14 +26483,10 @@ var ACP_CARD = {
   },
   modelConnectivity: {
     dialects: ["anthropic-messages", "openai-responses", "openai-chat-completions"],
-    // **通用 ACP 这张名片接不了外部端点，而且接不了是对的。** ACP 协议本身没有端点
-    // 概念，地址与钥匙全靠各家 CLI 自己的环境变量，五家各不相同（kimi 的
-    // `KIMI_MODEL_*`、qwen 的 `OPENAI_*`、gemini 的 `GOOGLE_GEMINI_*`……）。这张名片
-    // 是认不出是哪一家时的兜底，它不知道该注什么。
-    //
-    // 原来这里写着 `true` 却一栏开关都不给——名片对外宣称能接，实际绑定时报一个含糊
-    // 的 `driver-unknown`，而提案 0025 的进度表据此把 kimi 记成「通」。哪家要接，就为
-    // 那一家单出一张名片（`resolveByLocator` 按启动命令认家），别回来改这一张。
+    // **通用 ACP 这张名片说不出怎么接外部地址，而且说不出是对的。** ACP 协议本身没有
+    // 端点概念，地址与钥匙全靠各家 CLI 自己的环境变量，各家各不相同。用户按那家 CLI
+    // 自己的文档在实例上设变量。哪家要写清楚，就为那一家单出一个插件（像 `agent-kimi`），
+    // 别回来改这一张。
     acceptsExternalEndpoints: false
   }
 };
@@ -26560,8 +26520,7 @@ function parseAcpInstanceConfig(config2) {
       homePath: "",
       homeEnvVar: "",
       environment: {},
-      envelopeDriver: void 0,
-      providerId: ""
+      envelopeDriver: void 0
     };
   }
   const nested = isRecord6(config2["config"]) ? config2["config"] : void 0;
@@ -26572,8 +26531,7 @@ function parseAcpInstanceConfig(config2) {
     homePath: readTrimmed(settings["homePath"]) || readTrimmed(config2["homePath"]),
     homeEnvVar: readTrimmed(settings["homeEnvVar"]) || readTrimmed(config2["homeEnvVar"]),
     environment: readEnvironment(config2["environment"]),
-    envelopeDriver: readTrimmed(config2["driver"]) || void 0,
-    providerId: readTrimmed(settings["providerId"]) || readTrimmed(config2["providerId"])
+    envelopeDriver: readTrimmed(config2["driver"]) || void 0
   };
 }
 function tokenizeLaunchArgs(value) {
@@ -26628,136 +26586,30 @@ function tokenizeLaunchArgs(value) {
   return tokens;
 }
 
-// src/kimi.ts
-import * as NodeFS from "node:fs";
-import * as NodePath from "node:path";
-var KIMI_PROVIDER_ID = "kimiCode";
-var KIMI_HOME_ENV_VAR = "KIMI_CODE_HOME";
-var KIMI_USER_INPUT_TITLES = /* @__PURE__ */ new Set(["AskUserQuestion", "ExitPlanMode"]);
-var isRecord7 = (value) => typeof value === "object" && value !== null && !Array.isArray(value);
-function questionTextFromContent(content) {
-  if (!Array.isArray(content)) return "";
-  const parts = [];
-  for (const entry of content) {
-    if (!isRecord7(entry) || entry["type"] !== "content") continue;
-    const inner = entry["content"];
-    if (!isRecord7(inner) || inner["type"] !== "text") continue;
-    const text = inner["text"];
-    if (typeof text === "string") parts.push(text);
-  }
-  return parts.join("\n\n").trim();
-}
-function kimiPermissionUserInput(request) {
-  const title = request.toolCall.title;
-  if (typeof title !== "string" || !KIMI_USER_INPUT_TITLES.has(title)) return void 0;
-  const ids = new Set(request.options.map((option) => option.optionId));
-  if (request.options.length === 0 || ids.size !== request.options.length) {
-    throw new Error("Kimi interaction must provide distinct response options.");
-  }
-  const question = questionTextFromContent(request.toolCall.content);
-  if (question.length === 0) {
-    throw new Error("Kimi interaction is missing a question or plan.");
-  }
-  return {
-    id: request.toolCall.toolCallId,
-    header: title,
-    question,
-    kind: title === "ExitPlanMode" ? "plan" : "question",
-    allowFreeform: false,
-    multiSelect: false,
-    options: request.options.map((option) => ({
-      id: option.optionId,
-      label: option.name,
-      description: ""
-    }))
-  };
-}
-var WIRE_LOG_SEGMENTS = ["agents", "main", "wire.jsonl"];
-var SESSIONS_DIR = "sessions";
-var TAIL_SCAN_BYTES = 256 * 1024;
-var positiveInt = (value) => typeof value === "number" && Number.isFinite(value) && value > 0 ? Math.trunc(value) : void 0;
-function parseKimiContextWindow(contents) {
-  let usedTokens;
-  let maxTokens;
-  for (const line of contents.split("\n")) {
-    const trimmed = line.trim();
-    if (trimmed.length === 0) continue;
-    let record2;
-    try {
-      record2 = JSON.parse(trimmed);
-    } catch {
-      continue;
-    }
-    if (!isRecord7(record2)) continue;
-    const type = record2["type"];
-    if (type === "token_counting.turn_recorded" || type === "token_counting.measured") {
-      usedTokens = positiveInt(record2["tokens"]) ?? usedTokens;
-      continue;
-    }
-    if (type === "llm.request") {
-      maxTokens = positiveInt(record2["maxTokens"]) ?? maxTokens;
-    }
-  }
-  if (usedTokens === void 0) return void 0;
-  return maxTokens === void 0 ? { usedTokens } : { usedTokens, maxTokens };
-}
-function readTail(filePath) {
-  let handle;
-  try {
-    const size = NodeFS.statSync(filePath).size;
-    if (!Number.isFinite(size) || size <= 0) return void 0;
-    const length = size > TAIL_SCAN_BYTES ? TAIL_SCAN_BYTES : size;
-    const buffer = Buffer.alloc(length);
-    handle = NodeFS.openSync(filePath, "r");
-    NodeFS.readSync(handle, buffer, 0, length, size - length);
-    return buffer.toString("utf8");
-  } catch {
-    return void 0;
-  } finally {
-    if (handle !== void 0) {
-      try {
-        NodeFS.closeSync(handle);
-      } catch {
-      }
+// src/mcpServers.ts
+function toAcpMcpServers(entries) {
+  return (entries ?? []).map(
+    (entry) => entry.transport.type === "stdio" ? {
+      name: entry.name,
+      command: entry.transport.command,
+      args: [...entry.transport.args ?? []],
+      env: Object.entries(entry.transport.env ?? {}).map(([name, value]) => ({ name, value }))
+    } : {
+      type: entry.transport.type,
+      name: entry.name,
+      url: entry.transport.url,
+      headers: Object.entries(entry.transport.headers ?? {}).map(([name, value]) => ({
+        name,
+        value
+      }))
     }
-  }
-}
-function findKimiSessionWireLog(input2) {
-  const sessionsRoot = NodePath.join(input2.homePath, SESSIONS_DIR);
-  let workspaces;
-  try {
-    workspaces = NodeFS.readdirSync(sessionsRoot);
-  } catch {
-    return void 0;
-  }
-  for (const workspace of workspaces) {
-    const candidate = NodePath.join(
-      sessionsRoot,
-      workspace,
-      input2.acpSessionId,
-      ...WIRE_LOG_SEGMENTS
-    );
-    if (NodeFS.existsSync(candidate)) return candidate;
-  }
-  return void 0;
-}
-function readKimiContextWindow(input2) {
-  if (input2.homePath.trim().length === 0) return void 0;
-  const wireLog = findKimiSessionWireLog(input2);
-  if (wireLog === void 0) return void 0;
-  const contents = readTail(wireLog);
-  return contents === void 0 ? void 0 : parseKimiContextWindow(contents);
+  );
 }
 
-// src/kimiModels.ts
-import {
-  ExecutorSpawnRefusedError as ExecutorSpawnRefusedError2
-} from "@ycodium-ai/plugin-api/executor";
-
 // src/probeModels.ts
-import * as NodeFS2 from "node:fs";
+import * as NodeFS from "node:fs";
 import * as NodeOS from "node:os";
-import * as NodePath2 from "node:path";
+import * as NodePath from "node:path";
 import {
   ExecutorSpawnRefusedError
 } from "@ycodium-ai/plugin-api/executor";
@@ -26767,18 +26619,18 @@ var CLIENT_INFO = { name: "ycodium-agent-acp-probe", version: "0.2.0" };
 var ACP_EFFORT_OPTION_ID = "reasoning";
 function acpProbeSessionCwd(instanceId) {
   const safe = instanceId.replace(/[^a-zA-Z0-9_-]/g, "_");
-  return NodePath2.join(NodeOS.tmpdir(), `ycodium-acp-probe-${safe}`);
+  return NodePath.join(NodeOS.tmpdir(), `ycodium-acp-probe-${safe}`);
 }
-function isRecord8(value) {
+function isRecord7(value) {
   return typeof value === "object" && value !== null && !Array.isArray(value);
 }
 function asString3(value) {
   return typeof value === "string" ? value : void 0;
 }
 function findAcpProbeSessionId(listed, probeCwd) {
-  if (!isRecord8(listed) || !Array.isArray(listed["sessions"])) return void 0;
+  if (!isRecord7(listed) || !Array.isArray(listed["sessions"])) return void 0;
   for (const entry of listed["sessions"]) {
-    if (!isRecord8(entry)) continue;
+    if (!isRecord7(entry)) continue;
     if (asString3(entry["cwd"]) !== probeCwd) continue;
     const sessionId = asString3(entry["sessionId"]);
     if (sessionId !== void 0) return sessionId;
@@ -26795,7 +26647,7 @@ async function probeSessionSetup(handshake, probeCwd) {
   return handshake.request("session/new", { cwd: probeCwd, mcpServers: [] });
 }
 function acpProbeModels(setup) {
-  if (!isRecord8(setup)) return void 0;
+  if (!isRecord7(setup)) return void 0;
   const rawOptions = setup["configOptions"];
   const choices = acpModelChoicesFromConfigOptions(rawOptions) ?? acpModelChoicesFromSessionModels(setup["models"]);
   if (choices === void 0 || choices.length === 0) return void 0;
@@ -26830,7 +26682,7 @@ async function probeAcpModelsViaSession(input2) {
   const { recipe, host, env } = input2;
   const probeCwd = acpProbeSessionCwd(host.instanceId);
   try {
-    NodeFS2.mkdirSync(probeCwd, { recursive: true });
+    NodeFS.mkdirSync(probeCwd, { recursive: true });
   } catch (error62) {
     return { kind: "failed", detail: probeFailureDetail(error62), version: null };
   }
@@ -26882,113 +26734,6 @@ async function probeAcpModelsViaSession(input2) {
   }
 }
 
-// src/kimiModels.ts
-var PROBE_TIMEOUT_MS = 15e3;
-var MAX_OUTPUT_BYTES = 1024 * 1024;
-var KIMI_MODEL_LIST_ARGS = ["provider", "list", "--json"];
-function isRecord9(value) {
-  return typeof value === "object" && value !== null && !Array.isArray(value);
-}
-function asString4(value) {
-  return typeof value === "string" && value.trim().length > 0 ? value.trim() : void 0;
-}
-function positiveInt2(value) {
-  return typeof value === "number" && Number.isFinite(value) && value > 0 ? Math.trunc(value) : void 0;
-}
-function kimiProbeModels(stdout) {
-  let parsed;
-  try {
-    parsed = JSON.parse(stdout);
-  } catch {
-    return void 0;
-  }
-  if (!isRecord9(parsed)) return void 0;
-  const models = parsed["models"];
-  if (!isRecord9(models)) return void 0;
-  const out = [];
-  for (const [slug, entry] of Object.entries(models)) {
-    const trimmed = slug.trim();
-    if (trimmed.length === 0 || !isRecord9(entry)) continue;
-    const name = asString4(entry["displayName"]);
-    const contextWindow = positiveInt2(entry["maxContextSize"]);
-    out.push({
-      slug: trimmed,
-      ...name === void 0 ? {} : { name },
-      ...contextWindow === void 0 ? {} : { contextWindow }
-    });
-  }
-  return out;
-}
-async function probeKimiModels(input2) {
-  const { recipe, host, env } = input2;
-  let handle;
-  try {
-    handle = await host.process.spawn({
-      program: recipe.binaryPath,
-      // 实例信封里的启动参数（Kimi 那行预填 `acp`）在这一栏用不上：读配置要换成
-      // `provider list --json`，留着 `acp` 就等于让它起 ACP 服务然后什么都不问。
-      args: KIMI_MODEL_LIST_ARGS,
-      cwd: process.cwd(),
-      owner: { bindingId: host.bindingId },
-      ...Object.keys(env).length > 0 ? { env } : {}
-    });
-  } catch (error62) {
-    if (error62 instanceof ExecutorSpawnRefusedError2) throw error62;
-    return { kind: "not-started", detail: probeFailureDetail(error62) };
-  }
-  try {
-    const run = await collectProbeProcess(handle, {
-      timeoutMs: input2.timeoutMs ?? PROBE_TIMEOUT_MS,
-      // 这份 JSON 实测 1.7KB；封顶是防 CLI 抽风刷日志把内存吃掉。
-      maxOutputBytes: MAX_OUTPUT_BYTES,
-      what: "kimi provider list"
-    });
-    if (run.exitCode !== 0) {
-      const stderr = run.stderr.trim();
-      return {
-        kind: "failed",
-        detail: stderr.length > 0 ? stderr : run.exitCode === null ? "kimi provider list was killed by a signal" : `kimi provider list exited with code ${run.exitCode}`
-      };
-    }
-    return {
-      kind: "answered",
-      models: run.stdout === void 0 ? void 0 : kimiProbeModels(run.stdout)
-    };
-  } catch (error62) {
-    return { kind: "failed", detail: probeFailureDetail(error62) };
-  }
-}
-async function probeKimiVersion(input2) {
-  const { recipe, host, env } = input2;
-  return probeCliVersion({
-    spawn: () => host.process.spawn({
-      program: recipe.binaryPath,
-      args: ["--version"],
-      cwd: process.cwd(),
-      owner: { bindingId: host.bindingId },
-      ...Object.keys(env).length > 0 ? { env } : {}
-    }),
-    timeoutMs: PROBE_TIMEOUT_MS
-  });
-}
-async function probeKimi(input2) {
-  const [listed, version2] = await Promise.all([probeKimiModels(input2), probeKimiVersion(input2)]);
-  switch (listed.kind) {
-    case "not-started":
-      return { kind: "not-started", detail: listed.detail };
-    case "failed":
-      return { kind: "failed", detail: listed.detail, version: version2 };
-    case "answered":
-      return {
-        kind: "answered",
-        version: version2,
-        models: listed.models,
-        nativeModes: [],
-        currentNativeModeId: void 0
-      };
-  }
-}
-
 // src/runtimeModeApproval.ts
 function acpRuntimeModeAutoApproves(runtimeMode, toolKind) {
   switch (runtimeMode) {
@@ -27046,7 +26791,7 @@ var EventBus = class {
 function expandHomePath(value) {
   if (value === "~") return NodeOS2.homedir();
   if (value.startsWith("~/") || value.startsWith("~\\")) {
-    return NodePath3.join(NodeOS2.homedir(), value.slice(2));
+    return NodePath2.join(NodeOS2.homedir(), value.slice(2));
   }
   return value;
 }
@@ -27057,15 +26802,13 @@ function modelIdFromSelection(selection) {
   const model = selection["model"];
   return typeof model === "string" ? model.trim() || void 0 : void 0;
 }
-function buildSpawnEnv(recipe, configuredHomePath, launchEnv = {}) {
+function buildSpawnEnv(recipe, configuredHomePath) {
   const homePath = configuredHomePath.trim();
   const homeEnvVar = recipe.homeEnvVar.trim();
   const homeInjection = homePath.length > 0 && homeEnvVar.length > 0 ? { [homeEnvVar]: expandHomePath(homePath) } : {};
   return mergeLaunchEnv({
-    brainSlots: brainSlotEnvKeys(ACP_CARD),
     accountHome: homeInjection,
-    instanceTable: recipe.environment,
-    launch: launchEnv
+    instanceTable: recipe.environment
   });
 }
 function nowIso() {
@@ -27073,31 +26816,9 @@ function nowIso() {
 }
 function acpContinuationKey(recipe) {
   const homePath = recipe.homePath.trim();
-  const resolvedHomePath = homePath.length > 0 ? NodePath3.resolve(expandHomePath(homePath)) : "";
+  const resolvedHomePath = homePath.length > 0 ? NodePath2.resolve(expandHomePath(homePath)) : "";
   return `acp:home:${recipe.binaryPath.trim()}\0${resolvedHomePath}`;
 }
-function resolveHomePath(recipe, launchHomePath) {
-  const envVar = recipe.homeEnvVar.trim();
-  const fromEnvironment = envVar.length > 0 ? recipe.environment[envVar]?.trim() : void 0;
-  if (fromEnvironment !== void 0 && fromEnvironment.length > 0) {
-    return expandHomePath(fromEnvironment);
-  }
-  const configured = (launchHomePath?.trim() || recipe.homePath).trim();
-  return configured.length > 0 ? expandHomePath(configured) : "";
-}
-function isKimiInstance(recipe) {
-  return recipe.providerId === KIMI_PROVIDER_ID || recipe.homeEnvVar.trim() === KIMI_HOME_ENV_VAR;
-}
-function vendorHooksFor(recipe, launchHomePath) {
-  if (!isKimiInstance(recipe)) return void 0;
-  const homePath = resolveHomePath(recipe, launchHomePath);
-  return {
-    permissionUserInput: kimiPermissionUserInput,
-    // ACP 的 `usage_update` 我们这边不消费，进度圈只能从各家自己写在磁盘上的
-    // 记录里读。目前只有 Kimi 的格式核实过。
-    readContextWindow: ({ sessionId }) => readKimiContextWindow({ homePath, acpSessionId: sessionId })
-  };
-}
 async function stopBooked(booked) {
   await booked.executor.dispose().catch(() => void 0);
   await booked.handle.kill("SIGTERM").catch(() => void 0);
@@ -27125,7 +26846,7 @@ var createAcpInstance = (config2, host) => {
         };
       }
       const env = buildSpawnEnv(recipe, recipe.homePath);
-      const outcome = isKimiInstance(recipe) ? await probeKimi({ recipe, host, env }) : await probeAcpModelsViaSession({ recipe, host, env });
+      const outcome = await probeAcpModelsViaSession({ recipe, host, env });
       switch (outcome.kind) {
         case "not-started":
           return {
@@ -27165,6 +26886,8 @@ var createAcpInstance = (config2, host) => {
           };
       }
     },
+    // 暂不处理 input.readOnlyDirectories（有意为之）：acp 经共享的 ycodium-acp-executor 起会话，
+    // 还没用真机确认这家 CLI 对 cwd 之外的读怎么处理、要不要放行。确认之后再接这一栏。
     startSession: async (input2, signal) => {
       if (disposed) throw new Error("instance disposed");
       if (signal?.aborted) throw new Error("aborted");
@@ -27178,11 +26901,7 @@ var createAcpInstance = (config2, host) => {
         await stopBooked(existing);
         threads.delete(input2.threadId);
       }
-      const env = buildSpawnEnv(
-        recipe,
-        input2.launch.homePath?.trim() || recipe.homePath,
-        input2.launch.processEnv
-      );
+      const env = buildSpawnEnv(recipe, recipe.homePath);
       const handle = await host.process.spawn({
         program: recipe.binaryPath,
         args: tokenizeLaunchArgs(recipe.launchArgs),
@@ -27192,12 +26911,11 @@ var createAcpInstance = (config2, host) => {
       });
       const { readable, writable } = nodeStreamsFromHandle2(handle);
       const resume = input2.discardResumeCursor === true ? void 0 : parseAcpResumeCursor(input2.resumeCursor, RESUME_SCHEMA_VERSION);
-      const requestedModelId = input2.launch.requestedModelId?.trim() || modelIdFromSelection(input2.modelSelection);
+      const requestedModelId = modelIdFromSelection(input2.modelSelection);
       const requestedEffort = modelSelectionStringOption(
         input2.modelSelection,
         ACP_EFFORT_OPTION_ID
       );
-      const hooks = vendorHooksFor(recipe, input2.launch.homePath);
       const autoApprove = input2.nativeModeId === void 0 ? (request) => acpRuntimeModeAutoApproves(
         threads.get(input2.threadId)?.session.runtimeMode ?? input2.runtimeMode,
         request.kind
@@ -27214,9 +26932,11 @@ var createAcpInstance = (config2, host) => {
         log: host.log,
         ...requestedModelId === void 0 ? {} : { requestedModelId },
         ...input2.bindingGeneration === void 0 ? {} : { originBindingGeneration: input2.bindingGeneration },
-        ...hooks === void 0 ? {} : { hooks },
         ...autoApprove === void 0 ? {} : { autoApprove },
-        ...resume === void 0 ? {} : { resumeSessionId: resume.sessionId }
+        ...resume === void 0 ? {} : { resumeSessionId: resume.sessionId },
+        // 内置编排那一条排第一，后面跟用户在插件中心配的；缺了 `mcpServers` 这一栏，
+        // `mcp__ycodium__*` 整套工具在通用 ACP 会话里都不存在。
+        ...input2.mcpServers === void 0 || input2.mcpServers.length === 0 ? {} : { mcpServers: toAcpMcpServers(input2.mcpServers) }
       });
       const forwarding = (async () => {
         for await (const event of executor.events) {

package/locales/en.json

@@ -0,0 +1,19 @@
+{
+  "form": {
+    "binaryPath": {
+      "title": "Program path",
+      "description": "The ACP program this provider launches.",
+      "placeholder": "e.g. my-agent"
+    },
+    "launchArgs": {
+      "title": "Launch arguments",
+      "description": "Arguments that put the CLI into ACP stdio mode.",
+      "placeholder": "e.g. acp or --acp"
+    },
+    "homePath": {
+      "title": "Account directory",
+      "description": "Where this account's login and history live. Leave empty to use the CLI's default.",
+      "placeholder": "e.g. ~/.my-agent-work"
+    }
+  }
+}

package/locales/zh-CN.json

@@ -0,0 +1,19 @@
+{
+  "form": {
+    "binaryPath": {
+      "title": "程序路径",
+      "description": "此 provider 启动的 ACP 程序。",
+      "placeholder": "例如 my-agent"
+    },
+    "launchArgs": {
+      "title": "启动参数",
+      "description": "让命令行工具进入 ACP stdio 模式的参数。",
+      "placeholder": "例如 acp 或 --acp"
+    },
+    "homePath": {
+      "title": "账户目录",
+      "description": "此账户的登录信息与历史记录所在的目录。留空则使用该命令行工具的默认目录。",
+      "placeholder": "例如 ~/.my-agent-work"
+    }
+  }
+}

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@ycodium-ai/agent-acp",
-  "version": "0.2.2167",
+  "version": "0.2.2510",
   "description": "Generic ACP executor: user-supplied CLI over Agent Client Protocol stdio.",
   "keywords": [
     "ycodium",
@@ -10,6 +10,7 @@
   "files": [
     "dist",
     "assets",
+    "locales",
     "README.md"
   ],
   "type": "module",
@@ -20,10 +21,9 @@
     "@types/node": "24.12.4",
     "esbuild": "0.28.1",
     "vite-plus": "0.2.2",
-    "@ycodium-ai/plugin-api": "0.2.2167",
+    "@ycodium-ai/plugin-api": "0.2.2510",
     "ycodium-executor-testing": "0.0.0",
-    "ycodium-acp-executor": "0.0.0",
-    "ycodium-acp-protocol": "0.0.0"
+    "ycodium-acp-executor": "0.2.2510"
   },
   "ycodium": {
     "plugin": "./dist/index.js",