@tunnelbox/core 0.1.26 → 0.1.28

package/locales/de-DE.json

@@ -369,5 +369,38 @@
   "hermes.logRegisterAskFailed": "tunnelbox: Registrierung von tunnelbox_ask fehlgeschlagen: {err}",
   "hermes.logRegisterSystemPromptFailed": "tunnelbox: Registrierung des System-Prompt-Abschnitts fehlgeschlagen: {err}",
   "hermes.logBackgroundBridgeFailed": "tunnelbox: Start der Hintergrund-Bridge fehlgeschlagen: {err}",
-  "hermes.systemPromptAsk": "Wenn Sie eine Entscheidung, Klärung oder Auswahl vom Nutzer benötigen und ein tunnelbox-Telefon verbunden ist, verwenden Sie das Tool `tunnelbox_ask`, um auf dessen Telefon zu fragen, statt zu raten. Warten Sie auf die Antwort, bevor Sie fortfahren."
+  "hermes.systemPromptAsk": "Wenn Sie eine Entscheidung, Klärung oder Auswahl vom Nutzer benötigen und ein tunnelbox-Telefon verbunden ist, verwenden Sie das Tool `tunnelbox_ask`, um auf dessen Telefon zu fragen, statt zu raten. Warten Sie auf die Antwort, bevor Sie fortfahren.",
+  "adapter.warnCodebuddyCliMissing": "CodeBuddy-CLI-Programm \"{bin}\" nicht gefunden; installieren (npm i -g @tencent-ai/codebuddy-code) oder TUNNELBOX_CODEBUDDY_BIN auf den Pfad setzen",
+  "adapter.checkCodebuddyHeader": "tunnelbox-codebuddy Umgebungsprüfung",
+  "adapter.checkCodebuddyCliMissing": "CodeBuddy-CLI-Programm nicht gefunden ({bin}); installieren mit: npm i -g @tencent-ai/codebuddy-code",
+  "adapter.checkCodebuddyAcpHint": "CodeBuddy CLI erkannt; der ACP-Modus (`codebuddy --acp`) bietet Streaming/Freigabe/Auswahl",
+  "adapter.errCodebuddyAcpSpawn": "Start von CodeBuddy `--acp` fehlgeschlagen: {message} (sicherstellen, dass die CodeBuddy CLI `--acp` unterstützt)",
+  "adapter.errCodebuddyAcpNoSession": "CodeBuddy ACP hat keine Sitzungs-ID zurückgegeben",
+  "adapter.codebuddySessionTitle": "CodeBuddy-Sitzung",
+  "adapter.logElicitationNative": "Auswahl-/Bestätigungsanfrage -> Telefonkarte id={id} (Sitzung={session})",
+  "adapter.logCodebuddyAuthSkipped": "CodeBuddy ist nicht über ACP authentifiziert; melden Sie sich einmal mit `codebuddy` an (oder setzen Sie CODEBUDDY_API_KEY), oder setzen Sie TUNNELBOX_CODEBUDDY_AUTH=<methodId>, um über ACP zu authentifizieren",
+  "adapter.warnKimiCliMissing": "Kimi-CLI-Programm \"{bin}\" nicht gefunden; installieren (https://moonshotai.github.io/kimi-code/) oder TUNNELBOX_KIMI_BIN auf den Pfad setzen",
+  "adapter.checkKimiHeader": "tunnelbox-kimi Umgebungsprüfung",
+  "adapter.checkKimiCliMissing": "Kimi-CLI-Programm nicht gefunden ({bin}); installieren von https://moonshotai.github.io/kimi-code/",
+  "adapter.checkKimiAcpHint": "Kimi CLI erkannt; der ACP-Modus (`kimi acp`) bietet Streaming/Freigabe/Auswahl",
+  "adapter.errKimiAcpSpawn": "Start von Kimi `acp` fehlgeschlagen: {message} (sicherstellen, dass die Kimi CLI `kimi acp` unterstützt)",
+  "adapter.errKimiAcpNoSession": "Kimi ACP hat keine Sitzungs-ID zurückgegeben",
+  "adapter.kimiSessionTitle": "Kimi-Sitzung",
+  "adapter.logKimiAuthRequired": "Kimi ist nicht angemeldet: `kimi` einmal ausführen und /login senden (oder einen API-Schlüssel konfigurieren) — {message}",
+  "adapter.warnTraeCliMissing": "TraeCode-CLI-Programm \"{bin}\" nicht gefunden; installieren (https://docs.trae.cn/cli_what-is-trae-cli) oder TUNNELBOX_TRAE_BIN auf den Pfad setzen",
+  "adapter.checkTraeHeader": "tunnelbox-trae Umgebungsprüfung",
+  "adapter.checkTraeCliMissing": "TraeCode-CLI-Programm nicht gefunden ({bin}); installieren von https://docs.trae.cn/cli_what-is-trae-cli",
+  "adapter.checkTraeAcpHint": "TraeCode CLI erkannt; der ACP-Modus (`traecli acp serve`) bietet Streaming/Freigabe/Auswahl",
+  "adapter.errTraeAcpSpawn": "Start von TraeCode `acp serve` fehlgeschlagen: {message} (sicherstellen, dass die TraeCode CLI ACP unterstützt)",
+  "adapter.errTraeAcpNoSession": "TraeCode ACP hat keine Sitzungs-ID zurückgegeben",
+  "adapter.traeSessionTitle": "Trae-Sitzung",
+  "adapter.logTraeAuthSkipped": "TraeCode ACP-Authentifizierung übersprungen; melden Sie sich mit `traecli login` an (TraeCode CLI erfordert einen TRAE Enterprise Flagship-Plan)",
+  "adapter.warnQoderCliMissing": "Qoder-CLI-Programm \"{bin}\" nicht gefunden; installieren (npm i -g @qoder-ai/qodercli) oder TUNNELBOX_QODER_BIN auf den Pfad setzen",
+  "adapter.checkQoderHeader": "tunnelbox-qoder Umgebungsprüfung",
+  "adapter.checkQoderCliMissing": "Qoder-CLI-Programm nicht gefunden ({bin}); installieren mit: npm i -g @qoder-ai/qodercli",
+  "adapter.checkQoderAcpHint": "Qoder CLI erkannt; der ACP-Modus (`qoder --acp`) bietet Streaming/Freigabe/Auswahl",
+  "adapter.errQoderAcpSpawn": "Start von Qoder `--acp` fehlgeschlagen: {message} (sicherstellen, dass die Qoder CLI `--acp` unterstützt)",
+  "adapter.errQoderAcpNoSession": "Qoder ACP hat keine Sitzungs-ID zurückgegeben",
+  "adapter.qoderSessionTitle": "Qoder-Sitzung",
+  "adapter.logQoderAuthSkipped": "Qoder ACP-Authentifizierung übersprungen; melden Sie sich mit `qoder login` an oder setzen Sie QODER_PERSONAL_ACCESS_TOKEN"
 }

package/locales/en-US.json

@@ -369,5 +369,38 @@
   "hermes.logRegisterAskFailed": "tunnelbox: failed to register tunnelbox_ask: {err}",
   "hermes.logRegisterSystemPromptFailed": "tunnelbox: failed to register system prompt section: {err}",
   "hermes.logBackgroundBridgeFailed": "tunnelbox: background bridge failed to start: {err}",
-  "hermes.systemPromptAsk": "When you need a decision, clarification, or choice from the user and a tunnelbox phone is attached, use the `tunnelbox_ask` tool to ask on their phone instead of guessing. Wait for their answer before proceeding."
+  "hermes.systemPromptAsk": "When you need a decision, clarification, or choice from the user and a tunnelbox phone is attached, use the `tunnelbox_ask` tool to ask on their phone instead of guessing. Wait for their answer before proceeding.",
+  "adapter.warnCodebuddyCliMissing": "CodeBuddy CLI executable \"{bin}\" not found; install it (npm i -g @tencent-ai/codebuddy-code) or set TUNNELBOX_CODEBUDDY_BIN to its path",
+  "adapter.checkCodebuddyHeader": "tunnelbox-codebuddy environment check",
+  "adapter.checkCodebuddyCliMissing": "CodeBuddy CLI executable not found ({bin}); install it with: npm i -g @tencent-ai/codebuddy-code",
+  "adapter.checkCodebuddyAcpHint": "CodeBuddy CLI detected; ACP mode (`codebuddy --acp`) will provide streaming/approval/selection",
+  "adapter.errCodebuddyAcpSpawn": "Failed to start CodeBuddy `--acp`: {message} (make sure CodeBuddy CLI supports `--acp`)",
+  "adapter.errCodebuddyAcpNoSession": "CodeBuddy ACP did not return a session id",
+  "adapter.codebuddySessionTitle": "CodeBuddy session",
+  "adapter.logElicitationNative": "elicitation request -> phone card id={id} (session={session})",
+  "adapter.logCodebuddyAuthSkipped": "CodeBuddy ACP is not authenticated; log in once with `codebuddy` (or set CODEBUDDY_API_KEY), or set TUNNELBOX_CODEBUDDY_AUTH=<methodId> to authenticate over ACP",
+  "adapter.warnKimiCliMissing": "Kimi CLI executable \"{bin}\" not found; install it (https://moonshotai.github.io/kimi-code/) or set TUNNELBOX_KIMI_BIN to its path",
+  "adapter.checkKimiHeader": "tunnelbox-kimi environment check",
+  "adapter.checkKimiCliMissing": "Kimi CLI executable not found ({bin}); install it from https://moonshotai.github.io/kimi-code/",
+  "adapter.checkKimiAcpHint": "Kimi CLI detected; ACP mode (`kimi acp`) will provide streaming/approval/selection",
+  "adapter.errKimiAcpSpawn": "Failed to start Kimi `acp`: {message} (make sure the Kimi CLI supports `kimi acp`)",
+  "adapter.errKimiAcpNoSession": "Kimi ACP did not return a session id",
+  "adapter.kimiSessionTitle": "Kimi session",
+  "adapter.logKimiAuthRequired": "Kimi is not logged in: run `kimi` once and send /login (or configure an API key) — {message}",
+  "adapter.warnTraeCliMissing": "TraeCode CLI executable \"{bin}\" not found; install it (https://docs.trae.cn/cli_what-is-trae-cli) or set TUNNELBOX_TRAE_BIN to its path",
+  "adapter.checkTraeHeader": "tunnelbox-trae environment check",
+  "adapter.checkTraeCliMissing": "TraeCode CLI executable not found ({bin}); install it from https://docs.trae.cn/cli_what-is-trae-cli",
+  "adapter.checkTraeAcpHint": "TraeCode CLI detected; ACP mode (`traecli acp serve`) will provide streaming/approval/selection",
+  "adapter.errTraeAcpSpawn": "Failed to start TraeCode `acp serve`: {message} (make sure the TraeCode CLI supports ACP)",
+  "adapter.errTraeAcpNoSession": "TraeCode ACP did not return a session id",
+  "adapter.traeSessionTitle": "Trae session",
+  "adapter.logTraeAuthSkipped": "TraeCode ACP authenticate skipped; log in with `traecli login` (TraeCode CLI requires a TRAE Enterprise Flagship plan)",
+  "adapter.warnQoderCliMissing": "Qoder CLI executable \"{bin}\" not found; install it (npm i -g @qoder-ai/qodercli) or set TUNNELBOX_QODER_BIN to its path",
+  "adapter.checkQoderHeader": "tunnelbox-qoder environment check",
+  "adapter.checkQoderCliMissing": "Qoder CLI executable not found ({bin}); install it with: npm i -g @qoder-ai/qodercli",
+  "adapter.checkQoderAcpHint": "Qoder CLI detected; ACP mode (`qoder --acp`) will provide streaming/approval/selection",
+  "adapter.errQoderAcpSpawn": "Failed to start Qoder `--acp`: {message} (make sure the Qoder CLI supports `--acp`)",
+  "adapter.errQoderAcpNoSession": "Qoder ACP did not return a session id",
+  "adapter.qoderSessionTitle": "Qoder session",
+  "adapter.logQoderAuthSkipped": "Qoder ACP authenticate skipped; log in with `qoder login` or set QODER_PERSONAL_ACCESS_TOKEN"
 }

package/locales/es-ES.json

@@ -369,5 +369,38 @@
   "hermes.logRegisterAskFailed": "tunnelbox: falló el registro de tunnelbox_ask: {err}",
   "hermes.logRegisterSystemPromptFailed": "tunnelbox: falló el registro de la sección del prompt del sistema: {err}",
   "hermes.logBackgroundBridgeFailed": "tunnelbox: falló el inicio del puente en segundo plano: {err}",
-  "hermes.systemPromptAsk": "Cuando necesites una decisión, aclaración o elección del usuario y haya un teléfono tunnelbox vinculado, usa la herramienta `tunnelbox_ask` para preguntar en su teléfono en lugar de adivinar. Espera su respuesta antes de continuar."
+  "hermes.systemPromptAsk": "Cuando necesites una decisión, aclaración o elección del usuario y haya un teléfono tunnelbox vinculado, usa la herramienta `tunnelbox_ask` para preguntar en su teléfono en lugar de adivinar. Espera su respuesta antes de continuar.",
+  "adapter.warnCodebuddyCliMissing": "No se encontró el ejecutable de CodeBuddy CLI \"{bin}\"; instálalo (npm i -g @tencent-ai/codebuddy-code) o define TUNNELBOX_CODEBUDDY_BIN con su ruta",
+  "adapter.checkCodebuddyHeader": "Comprobación de entorno de tunnelbox-codebuddy",
+  "adapter.checkCodebuddyCliMissing": "No se encontró el ejecutable de CodeBuddy CLI ({bin}); instálalo con: npm i -g @tencent-ai/codebuddy-code",
+  "adapter.checkCodebuddyAcpHint": "CodeBuddy CLI detectado; el modo ACP (`codebuddy --acp`) proporcionará streaming/aprobación/selección",
+  "adapter.errCodebuddyAcpSpawn": "No se pudo iniciar CodeBuddy `--acp`: {message} (asegúrate de que CodeBuddy CLI admite `--acp`)",
+  "adapter.errCodebuddyAcpNoSession": "CodeBuddy ACP no devolvió un id de sesión",
+  "adapter.codebuddySessionTitle": "Sesión de CodeBuddy",
+  "adapter.logElicitationNative": "Solicitud de selección/confirmación -> tarjeta del teléfono id={id} (sesión={session})",
+  "adapter.logCodebuddyAuthSkipped": "CodeBuddy no está autenticado por ACP; inicia sesión una vez con `codebuddy` (o define CODEBUDDY_API_KEY), o define TUNNELBOX_CODEBUDDY_AUTH=<methodId> para autenticarte por ACP",
+  "adapter.warnKimiCliMissing": "No se encontró el ejecutable de Kimi CLI \"{bin}\"; instálalo (https://moonshotai.github.io/kimi-code/) o define TUNNELBOX_KIMI_BIN con su ruta",
+  "adapter.checkKimiHeader": "Comprobación de entorno de tunnelbox-kimi",
+  "adapter.checkKimiCliMissing": "No se encontró el ejecutable de Kimi CLI ({bin}); instálalo desde https://moonshotai.github.io/kimi-code/",
+  "adapter.checkKimiAcpHint": "Kimi CLI detectado; el modo ACP (`kimi acp`) proporcionará streaming/aprobación/selección",
+  "adapter.errKimiAcpSpawn": "No se pudo iniciar Kimi `acp`: {message} (asegúrate de que Kimi CLI admite `kimi acp`)",
+  "adapter.errKimiAcpNoSession": "Kimi ACP no devolvió un id de sesión",
+  "adapter.kimiSessionTitle": "Sesión de Kimi",
+  "adapter.logKimiAuthRequired": "Kimi no ha iniciado sesión: ejecuta `kimi` una vez y envía /login (o configura una clave API) — {message}",
+  "adapter.warnTraeCliMissing": "No se encontró el ejecutable de TraeCode CLI \"{bin}\"; instálalo (https://docs.trae.cn/cli_what-is-trae-cli) o define TUNNELBOX_TRAE_BIN con su ruta",
+  "adapter.checkTraeHeader": "Comprobación de entorno de tunnelbox-trae",
+  "adapter.checkTraeCliMissing": "No se encontró el ejecutable de TraeCode CLI ({bin}); instálalo desde https://docs.trae.cn/cli_what-is-trae-cli",
+  "adapter.checkTraeAcpHint": "TraeCode CLI detectado; el modo ACP (`traecli acp serve`) proporcionará streaming/aprobación/selección",
+  "adapter.errTraeAcpSpawn": "No se pudo iniciar TraeCode `acp serve`: {message} (asegúrate de que TraeCode CLI admite ACP)",
+  "adapter.errTraeAcpNoSession": "TraeCode ACP no devolvió un id de sesión",
+  "adapter.traeSessionTitle": "Sesión de Trae",
+  "adapter.logTraeAuthSkipped": "Se omitió la autenticación ACP de TraeCode; inicia sesión con `traecli login` (TraeCode CLI requiere un plan TRAE Enterprise Flagship)",
+  "adapter.warnQoderCliMissing": "No se encontró el ejecutable de Qoder CLI \"{bin}\"; instálalo (npm i -g @qoder-ai/qodercli) o define TUNNELBOX_QODER_BIN con su ruta",
+  "adapter.checkQoderHeader": "Comprobación de entorno de tunnelbox-qoder",
+  "adapter.checkQoderCliMissing": "No se encontró el ejecutable de Qoder CLI ({bin}); instálalo con: npm i -g @qoder-ai/qodercli",
+  "adapter.checkQoderAcpHint": "Qoder CLI detectado; el modo ACP (`qoder --acp`) proporcionará streaming/aprobación/selección",
+  "adapter.errQoderAcpSpawn": "No se pudo iniciar Qoder `--acp`: {message} (asegúrate de que Qoder CLI admite `--acp`)",
+  "adapter.errQoderAcpNoSession": "Qoder ACP no devolvió un id de sesión",
+  "adapter.qoderSessionTitle": "Sesión de Qoder",
+  "adapter.logQoderAuthSkipped": "Se omitió la autenticación ACP de Qoder; inicia sesión con `qoder login` o define QODER_PERSONAL_ACCESS_TOKEN"
 }

package/locales/fr-FR.json

@@ -369,5 +369,38 @@
   "hermes.logRegisterAskFailed": "tunnelbox : échec d'enregistrement de tunnelbox_ask : {err}",
   "hermes.logRegisterSystemPromptFailed": "tunnelbox : échec d'enregistrement de la section du prompt système : {err}",
   "hermes.logBackgroundBridgeFailed": "tunnelbox : échec du démarrage du pont en arrière-plan : {err}",
-  "hermes.systemPromptAsk": "Lorsque vous avez besoin d'une décision, d'une clarification ou d'un choix de l'utilisateur et qu'un téléphone tunnelbox est associé, utilisez l'outil `tunnelbox_ask` pour poser la question sur son téléphone au lieu de deviner. Attendez sa réponse avant de continuer."
+  "hermes.systemPromptAsk": "Lorsque vous avez besoin d'une décision, d'une clarification ou d'un choix de l'utilisateur et qu'un téléphone tunnelbox est associé, utilisez l'outil `tunnelbox_ask` pour poser la question sur son téléphone au lieu de deviner. Attendez sa réponse avant de continuer.",
+  "adapter.warnCodebuddyCliMissing": "Exécutable CodeBuddy CLI \"{bin}\" introuvable ; installez-le (npm i -g @tencent-ai/codebuddy-code) ou définissez TUNNELBOX_CODEBUDDY_BIN sur son chemin",
+  "adapter.checkCodebuddyHeader": "Vérification de l'environnement tunnelbox-codebuddy",
+  "adapter.checkCodebuddyCliMissing": "Exécutable CodeBuddy CLI introuvable ({bin}) ; installez-le avec : npm i -g @tencent-ai/codebuddy-code",
+  "adapter.checkCodebuddyAcpHint": "CodeBuddy CLI détecté ; le mode ACP (`codebuddy --acp`) fournira le streaming/l'approbation/la sélection",
+  "adapter.errCodebuddyAcpSpawn": "Échec du démarrage de CodeBuddy `--acp` : {message} (vérifiez que le CodeBuddy CLI prend en charge `--acp`)",
+  "adapter.errCodebuddyAcpNoSession": "CodeBuddy ACP n'a pas renvoyé d'id de session",
+  "adapter.codebuddySessionTitle": "Session CodeBuddy",
+  "adapter.logElicitationNative": "Demande de sélection/confirmation -> carte téléphone id={id} (session={session})",
+  "adapter.logCodebuddyAuthSkipped": "CodeBuddy n'est pas authentifié via ACP ; connectez-vous une fois avec `codebuddy` (ou définissez CODEBUDDY_API_KEY), ou définissez TUNNELBOX_CODEBUDDY_AUTH=<methodId> pour vous authentifier via ACP",
+  "adapter.warnKimiCliMissing": "Exécutable Kimi CLI \"{bin}\" introuvable ; installez-le (https://moonshotai.github.io/kimi-code/) ou définissez TUNNELBOX_KIMI_BIN sur son chemin",
+  "adapter.checkKimiHeader": "Vérification de l'environnement tunnelbox-kimi",
+  "adapter.checkKimiCliMissing": "Exécutable Kimi CLI introuvable ({bin}) ; installez-le depuis https://moonshotai.github.io/kimi-code/",
+  "adapter.checkKimiAcpHint": "Kimi CLI détecté ; le mode ACP (`kimi acp`) fournira le streaming/l'approbation/la sélection",
+  "adapter.errKimiAcpSpawn": "Échec du démarrage de Kimi `acp` : {message} (vérifiez que le Kimi CLI prend en charge `kimi acp`)",
+  "adapter.errKimiAcpNoSession": "Kimi ACP n'a pas renvoyé d'id de session",
+  "adapter.kimiSessionTitle": "Session Kimi",
+  "adapter.logKimiAuthRequired": "Kimi n'est pas connecté : exécutez `kimi` une fois et envoyez /login (ou configurez une clé API) — {message}",
+  "adapter.warnTraeCliMissing": "Exécutable TraeCode CLI \"{bin}\" introuvable ; installez-le (https://docs.trae.cn/cli_what-is-trae-cli) ou définissez TUNNELBOX_TRAE_BIN sur son chemin",
+  "adapter.checkTraeHeader": "Vérification de l'environnement tunnelbox-trae",
+  "adapter.checkTraeCliMissing": "Exécutable TraeCode CLI introuvable ({bin}) ; installez-le depuis https://docs.trae.cn/cli_what-is-trae-cli",
+  "adapter.checkTraeAcpHint": "TraeCode CLI détecté ; le mode ACP (`traecli acp serve`) fournira le streaming/l'approbation/la sélection",
+  "adapter.errTraeAcpSpawn": "Échec du démarrage de TraeCode `acp serve` : {message} (vérifiez que le TraeCode CLI prend en charge ACP)",
+  "adapter.errTraeAcpNoSession": "TraeCode ACP n'a pas renvoyé d'id de session",
+  "adapter.traeSessionTitle": "Session Trae",
+  "adapter.logTraeAuthSkipped": "Authentification ACP TraeCode ignorée ; connectez-vous avec `traecli login` (TraeCode CLI nécessite un forfait TRAE Enterprise Flagship)",
+  "adapter.warnQoderCliMissing": "Exécutable Qoder CLI \"{bin}\" introuvable ; installez-le (npm i -g @qoder-ai/qodercli) ou définissez TUNNELBOX_QODER_BIN sur son chemin",
+  "adapter.checkQoderHeader": "Vérification de l'environnement tunnelbox-qoder",
+  "adapter.checkQoderCliMissing": "Exécutable Qoder CLI introuvable ({bin}) ; installez-le avec : npm i -g @qoder-ai/qodercli",
+  "adapter.checkQoderAcpHint": "Qoder CLI détecté ; le mode ACP (`qoder --acp`) fournira le streaming/l'approbation/la sélection",
+  "adapter.errQoderAcpSpawn": "Échec du démarrage de Qoder `--acp` : {message} (vérifiez que le Qoder CLI prend en charge `--acp`)",
+  "adapter.errQoderAcpNoSession": "Qoder ACP n'a pas renvoyé d'id de session",
+  "adapter.qoderSessionTitle": "Session Qoder",
+  "adapter.logQoderAuthSkipped": "Authentification ACP Qoder ignorée ; connectez-vous avec `qoder login` ou définissez QODER_PERSONAL_ACCESS_TOKEN"
 }

package/locales/ja-JP.json

@@ -369,5 +369,38 @@
   "hermes.logRegisterAskFailed": "tunnelbox: tunnelbox_ask の登録に失敗: {err}",
   "hermes.logRegisterSystemPromptFailed": "tunnelbox: system prompt セクションの登録に失敗: {err}",
   "hermes.logBackgroundBridgeFailed": "tunnelbox: バックグラウンドブリッジの起動に失敗: {err}",
-  "hermes.systemPromptAsk": "ユーザーに決定/確認/選択を求める必要があり、tunnelbox スマホが接続されている場合は、推測せず `tunnelbox_ask` ツールでスマホに質問してください。回答があるまで待ってから続行します。"
+  "hermes.systemPromptAsk": "ユーザーに決定/確認/選択を求める必要があり、tunnelbox スマホが接続されている場合は、推測せず `tunnelbox_ask` ツールでスマホに質問してください。回答があるまで待ってから続行します。",
+  "adapter.warnCodebuddyCliMissing": "CodeBuddy CLI の実行ファイル \"{bin}\" が見つかりません。インストールする（npm i -g @tencent-ai/codebuddy-code）か、TUNNELBOX_CODEBUDDY_BIN にパスを設定してください",
+  "adapter.checkCodebuddyHeader": "tunnelbox-codebuddy 環境チェック",
+  "adapter.checkCodebuddyCliMissing": "CodeBuddy CLI の実行ファイルが見つかりません（{bin}）。次でインストールしてください: npm i -g @tencent-ai/codebuddy-code",
+  "adapter.checkCodebuddyAcpHint": "CodeBuddy CLI を検出しました。ACP モード（`codebuddy --acp`）でストリーミング/承認/選択が利用できます",
+  "adapter.errCodebuddyAcpSpawn": "CodeBuddy `--acp` の起動に失敗しました: {message}（CodeBuddy CLI が `--acp` に対応しているか確認してください）",
+  "adapter.errCodebuddyAcpNoSession": "CodeBuddy ACP がセッション id を返しませんでした",
+  "adapter.codebuddySessionTitle": "CodeBuddy セッション",
+  "adapter.logElicitationNative": "選択/確認リクエスト -> スマホのカード id={id}（セッション={session}）",
+  "adapter.logCodebuddyAuthSkipped": "CodeBuddy は ACP で認証されていません。一度 `codebuddy` でログインする（または CODEBUDDY_API_KEY を設定する）か、TUNNELBOX_CODEBUDDY_AUTH=<methodId> で ACP 認証を行ってください",
+  "adapter.warnKimiCliMissing": "Kimi CLI の実行ファイル \"{bin}\" が見つかりません。インストールする（https://moonshotai.github.io/kimi-code/）か、TUNNELBOX_KIMI_BIN にパスを設定してください",
+  "adapter.checkKimiHeader": "tunnelbox-kimi 環境チェック",
+  "adapter.checkKimiCliMissing": "Kimi CLI の実行ファイルが見つかりません（{bin}）。https://moonshotai.github.io/kimi-code/ からインストールしてください",
+  "adapter.checkKimiAcpHint": "Kimi CLI を検出しました。ACP モード（`kimi acp`）でストリーミング/承認/選択が利用できます",
+  "adapter.errKimiAcpSpawn": "Kimi `acp` の起動に失敗しました: {message}（Kimi CLI が `kimi acp` に対応しているか確認してください）",
+  "adapter.errKimiAcpNoSession": "Kimi ACP がセッション id を返しませんでした",
+  "adapter.kimiSessionTitle": "Kimi セッション",
+  "adapter.logKimiAuthRequired": "Kimi がログインしていません。一度 `kimi` を実行して /login を送信する（または API キーを設定する）してください — {message}",
+  "adapter.warnTraeCliMissing": "TraeCode CLI の実行ファイル \"{bin}\" が見つかりません。インストールする（https://docs.trae.cn/cli_what-is-trae-cli）か、TUNNELBOX_TRAE_BIN にパスを設定してください",
+  "adapter.checkTraeHeader": "tunnelbox-trae 環境チェック",
+  "adapter.checkTraeCliMissing": "TraeCode CLI の実行ファイルが見つかりません（{bin}）。https://docs.trae.cn/cli_what-is-trae-cli からインストールしてください",
+  "adapter.checkTraeAcpHint": "TraeCode CLI を検出しました。ACP モード（`traecli acp serve`）でストリーミング/承認/選択が利用できます",
+  "adapter.errTraeAcpSpawn": "TraeCode `acp serve` の起動に失敗しました: {message}（TraeCode CLI が ACP に対応しているか確認してください）",
+  "adapter.errTraeAcpNoSession": "TraeCode ACP がセッション id を返しませんでした",
+  "adapter.traeSessionTitle": "Trae セッション",
+  "adapter.logTraeAuthSkipped": "TraeCode ACP 認証をスキップしました。`traecli login` でログインしてください（TraeCode CLI は TRAE エンタープライズ最上位プラン限定）",
+  "adapter.warnQoderCliMissing": "Qoder CLI の実行ファイル \"{bin}\" が見つかりません。インストールする（npm i -g @qoder-ai/qodercli）か、TUNNELBOX_QODER_BIN にパスを設定してください",
+  "adapter.checkQoderHeader": "tunnelbox-qoder 環境チェック",
+  "adapter.checkQoderCliMissing": "Qoder CLI の実行ファイルが見つかりません（{bin}）。次でインストールしてください: npm i -g @qoder-ai/qodercli",
+  "adapter.checkQoderAcpHint": "Qoder CLI を検出しました。ACP モード（`qoder --acp`）でストリーミング/承認/選択が利用できます",
+  "adapter.errQoderAcpSpawn": "Qoder `--acp` の起動に失敗しました: {message}（Qoder CLI が `--acp` に対応しているか確認してください）",
+  "adapter.errQoderAcpNoSession": "Qoder ACP がセッション id を返しませんでした",
+  "adapter.qoderSessionTitle": "Qoder セッション",
+  "adapter.logQoderAuthSkipped": "Qoder ACP 認証をスキップしました。`qoder login` でログインするか、QODER_PERSONAL_ACCESS_TOKEN を設定してください"
 }

package/locales/ko-KR.json

@@ -369,5 +369,38 @@
   "hermes.logRegisterAskFailed": "tunnelbox: tunnelbox_ask 등록 실패: {err}",
   "hermes.logRegisterSystemPromptFailed": "tunnelbox: system prompt 섹션 등록 실패: {err}",
   "hermes.logBackgroundBridgeFailed": "tunnelbox: 백그라운드 브리지 시작 실패: {err}",
-  "hermes.systemPromptAsk": "사용자에게 결정/확인/선택이 필요하고 tunnelbox 휴대폰이 연결되어 있으면 추측하지 말고 `tunnelbox_ask` 도구로 휴대폰에서 질문하세요. 사용자가 답할 때까지 기다린 후 진행하세요."
+  "hermes.systemPromptAsk": "사용자에게 결정/확인/선택이 필요하고 tunnelbox 휴대폰이 연결되어 있으면 추측하지 말고 `tunnelbox_ask` 도구로 휴대폰에서 질문하세요. 사용자가 답할 때까지 기다린 후 진행하세요.",
+  "adapter.warnCodebuddyCliMissing": "CodeBuddy CLI 실행 파일 \"{bin}\"을(를) 찾을 수 없습니다. 설치하거나(npm i -g @tencent-ai/codebuddy-code) TUNNELBOX_CODEBUDDY_BIN에 경로를 설정하세요",
+  "adapter.checkCodebuddyHeader": "tunnelbox-codebuddy 환경 점검",
+  "adapter.checkCodebuddyCliMissing": "CodeBuddy CLI 실행 파일을 찾을 수 없습니다({bin}). 다음으로 설치하세요: npm i -g @tencent-ai/codebuddy-code",
+  "adapter.checkCodebuddyAcpHint": "CodeBuddy CLI를 감지했습니다. ACP 모드(`codebuddy --acp`)에서 스트리밍/승인/선택을 제공합니다",
+  "adapter.errCodebuddyAcpSpawn": "CodeBuddy `--acp` 시작 실패: {message} (CodeBuddy CLI가 `--acp`를 지원하는지 확인하세요)",
+  "adapter.errCodebuddyAcpNoSession": "CodeBuddy ACP가 세션 id를 반환하지 않았습니다",
+  "adapter.codebuddySessionTitle": "CodeBuddy 세션",
+  "adapter.logElicitationNative": "선택/확인 요청 -> 휴대폰 카드 id={id} (세션={session})",
+  "adapter.logCodebuddyAuthSkipped": "CodeBuddy가 ACP로 인증되지 않았습니다. `codebuddy`로 한 번 로그인하거나 CODEBUDDY_API_KEY를 설정하세요. 또는 TUNNELBOX_CODEBUDDY_AUTH=<methodId>로 ACP 인증을 사용할 수 있습니다",
+  "adapter.warnKimiCliMissing": "Kimi CLI 실행 파일 \"{bin}\"을(를) 찾을 수 없습니다. 설치하거나(https://moonshotai.github.io/kimi-code/) TUNNELBOX_KIMI_BIN에 경로를 설정하세요",
+  "adapter.checkKimiHeader": "tunnelbox-kimi 환경 점검",
+  "adapter.checkKimiCliMissing": "Kimi CLI 실행 파일을 찾을 수 없습니다({bin}). https://moonshotai.github.io/kimi-code/ 에서 설치하세요",
+  "adapter.checkKimiAcpHint": "Kimi CLI를 감지했습니다. ACP 모드(`kimi acp`)에서 스트리밍/승인/선택을 제공합니다",
+  "adapter.errKimiAcpSpawn": "Kimi `acp` 시작 실패: {message} (Kimi CLI가 `kimi acp`를 지원하는지 확인하세요)",
+  "adapter.errKimiAcpNoSession": "Kimi ACP가 세션 id를 반환하지 않았습니다",
+  "adapter.kimiSessionTitle": "Kimi 세션",
+  "adapter.logKimiAuthRequired": "Kimi에 로그인되어 있지 않습니다. `kimi`를 한 번 실행해 /login을 보내거나 API 키를 설정하세요 — {message}",
+  "adapter.warnTraeCliMissing": "TraeCode CLI 실행 파일 \"{bin}\"을(를) 찾을 수 없습니다. 설치하거나(https://docs.trae.cn/cli_what-is-trae-cli) TUNNELBOX_TRAE_BIN에 경로를 설정하세요",
+  "adapter.checkTraeHeader": "tunnelbox-trae 환경 점검",
+  "adapter.checkTraeCliMissing": "TraeCode CLI 실행 파일을 찾을 수 없습니다({bin}). https://docs.trae.cn/cli_what-is-trae-cli 에서 설치하세요",
+  "adapter.checkTraeAcpHint": "TraeCode CLI를 감지했습니다. ACP 모드(`traecli acp serve`)에서 스트리밍/승인/선택을 제공합니다",
+  "adapter.errTraeAcpSpawn": "TraeCode `acp serve` 시작 실패: {message} (TraeCode CLI가 ACP를 지원하는지 확인하세요)",
+  "adapter.errTraeAcpNoSession": "TraeCode ACP가 세션 id를 반환하지 않았습니다",
+  "adapter.traeSessionTitle": "Trae 세션",
+  "adapter.logTraeAuthSkipped": "TraeCode ACP 인증을 건너뛰었습니다. `traecli login`으로 로그인하세요 (TraeCode CLI는 TRAE 엔터프라이즈 플래그십 플랜 전용)",
+  "adapter.warnQoderCliMissing": "Qoder CLI 실행 파일 \"{bin}\"을(를) 찾을 수 없습니다. 설치하거나(npm i -g @qoder-ai/qodercli) TUNNELBOX_QODER_BIN에 경로를 설정하세요",
+  "adapter.checkQoderHeader": "tunnelbox-qoder 환경 점검",
+  "adapter.checkQoderCliMissing": "Qoder CLI 실행 파일을 찾을 수 없습니다({bin}). 다음으로 설치하세요: npm i -g @qoder-ai/qodercli",
+  "adapter.checkQoderAcpHint": "Qoder CLI를 감지했습니다. ACP 모드(`qoder --acp`)에서 스트리밍/승인/선택을 제공합니다",
+  "adapter.errQoderAcpSpawn": "Qoder `--acp` 시작 실패: {message} (Qoder CLI가 `--acp`를 지원하는지 확인하세요)",
+  "adapter.errQoderAcpNoSession": "Qoder ACP가 세션 id를 반환하지 않았습니다",
+  "adapter.qoderSessionTitle": "Qoder 세션",
+  "adapter.logQoderAuthSkipped": "Qoder ACP 인증을 건너뛰었습니다. `qoder login`으로 로그인하거나 QODER_PERSONAL_ACCESS_TOKEN을 설정하세요"
 }

package/locales/zh-CN.json

@@ -369,5 +369,38 @@
   "hermes.logRegisterAskFailed": "tunnelbox: 注册 tunnelbox_ask 失败: {err}",
   "hermes.logRegisterSystemPromptFailed": "tunnelbox: 注册 system prompt 段失败: {err}",
   "hermes.logBackgroundBridgeFailed": "tunnelbox: 后台桥启动失败: {err}",
-  "hermes.systemPromptAsk": "当你需要用户做决定/澄清/选择，且已连接 tunnelbox 手机时，请用 `tunnelbox_ask` 工具在手机上提问，而不是自行猜测；等到用户作答后再继续。"
+  "hermes.systemPromptAsk": "当你需要用户做决定/澄清/选择，且已连接 tunnelbox 手机时，请用 `tunnelbox_ask` 工具在手机上提问，而不是自行猜测；等到用户作答后再继续。",
+  "adapter.warnCodebuddyCliMissing": "找不到 CodeBuddy CLI 可执行文件 \"{bin}\"；请安装（npm i -g @tencent-ai/codebuddy-code），或将 TUNNELBOX_CODEBUDDY_BIN 设为其路径",
+  "adapter.checkCodebuddyHeader": "tunnelbox-codebuddy 环境自检",
+  "adapter.checkCodebuddyCliMissing": "找不到 CodeBuddy CLI 可执行文件（{bin}）；请安装：npm i -g @tencent-ai/codebuddy-code",
+  "adapter.checkCodebuddyAcpHint": "已检测到 CodeBuddy CLI；ACP 模式（`codebuddy --acp`）将提供流式/审批/选择",
+  "adapter.errCodebuddyAcpSpawn": "无法启动 CodeBuddy `--acp`：{message}（请确认 CodeBuddy CLI 支持 `--acp`）",
+  "adapter.errCodebuddyAcpNoSession": "CodeBuddy ACP 未返回会话 id",
+  "adapter.codebuddySessionTitle": "CodeBuddy 会话",
+  "adapter.logElicitationNative": "选择/确认请求 -> 手机卡片 id={id}（会话={session}）",
+  "adapter.logCodebuddyAuthSkipped": "CodeBuddy 尚未通过 ACP 认证；请先运行一次 `codebuddy` 登录（或设置 CODEBUDDY_API_KEY），也可设置 TUNNELBOX_CODEBUDDY_AUTH=<methodId> 走 ACP 认证",
+  "adapter.warnKimiCliMissing": "找不到 Kimi CLI 可执行文件 \"{bin}\"；请安装（https://moonshotai.github.io/kimi-code/），或将 TUNNELBOX_KIMI_BIN 设为其路径",
+  "adapter.checkKimiHeader": "tunnelbox-kimi 环境自检",
+  "adapter.checkKimiCliMissing": "找不到 Kimi CLI 可执行文件（{bin}）；请从 https://moonshotai.github.io/kimi-code/ 安装",
+  "adapter.checkKimiAcpHint": "已检测到 Kimi CLI；ACP 模式（`kimi acp`）将提供流式/审批/选择",
+  "adapter.errKimiAcpSpawn": "无法启动 Kimi `acp`：{message}（请确认 Kimi CLI 支持 `kimi acp`）",
+  "adapter.errKimiAcpNoSession": "Kimi ACP 未返回会话 id",
+  "adapter.kimiSessionTitle": "Kimi 会话",
+  "adapter.logKimiAuthRequired": "Kimi 未登录：请先运行一次 `kimi` 并发送 /login（或配置 API Key）—— {message}",
+  "adapter.warnTraeCliMissing": "找不到 TraeCode CLI 可执行文件 \"{bin}\"；请安装（https://docs.trae.cn/cli_what-is-trae-cli），或将 TUNNELBOX_TRAE_BIN 设为其路径",
+  "adapter.checkTraeHeader": "tunnelbox-trae 环境自检",
+  "adapter.checkTraeCliMissing": "找不到 TraeCode CLI 可执行文件（{bin}）；请从 https://docs.trae.cn/cli_what-is-trae-cli 安装",
+  "adapter.checkTraeAcpHint": "已检测到 TraeCode CLI；ACP 模式（`traecli acp serve`）将提供流式/审批/选择",
+  "adapter.errTraeAcpSpawn": "无法启动 TraeCode `acp serve`：{message}（请确认 TraeCode CLI 支持 ACP）",
+  "adapter.errTraeAcpNoSession": "TraeCode ACP 未返回会话 id",
+  "adapter.traeSessionTitle": "Trae 会话",
+  "adapter.logTraeAuthSkipped": "已跳过 TraeCode ACP 认证；请用 `traecli login` 登录（TraeCode CLI 仅 TRAE 企业版旗舰版可用）",
+  "adapter.warnQoderCliMissing": "找不到 Qoder CLI 可执行文件 \"{bin}\"；请安装（npm i -g @qoder-ai/qodercli），或将 TUNNELBOX_QODER_BIN 设为其路径",
+  "adapter.checkQoderHeader": "tunnelbox-qoder 环境自检",
+  "adapter.checkQoderCliMissing": "找不到 Qoder CLI 可执行文件（{bin}）；请安装：npm i -g @qoder-ai/qodercli",
+  "adapter.checkQoderAcpHint": "已检测到 Qoder CLI；ACP 模式（`qoder --acp`）将提供流式/审批/选择",
+  "adapter.errQoderAcpSpawn": "无法启动 Qoder `--acp`：{message}（请确认 Qoder CLI 支持 `--acp`）",
+  "adapter.errQoderAcpNoSession": "Qoder ACP 未返回会话 id",
+  "adapter.qoderSessionTitle": "Qoder 会话",
+  "adapter.logQoderAuthSkipped": "已跳过 Qoder ACP 认证；请用 `qoder login` 登录，或设置 QODER_PERSONAL_ACCESS_TOKEN"
 }

package/locales/zh-TW.json

@@ -369,5 +369,38 @@
   "hermes.logRegisterAskFailed": "tunnelbox: 註冊 tunnelbox_ask 失敗: {err}",
   "hermes.logRegisterSystemPromptFailed": "tunnelbox: 註冊 system prompt 段失敗: {err}",
   "hermes.logBackgroundBridgeFailed": "tunnelbox: 背景橋啟動失敗: {err}",
-  "hermes.systemPromptAsk": "當你需要使用者做決定/澄清/選擇，且已連接 tunnelbox 手機時，請用 `tunnelbox_ask` 工具在手機上提問，而不是自行猜測；等到使用者作答後再繼續。"
+  "hermes.systemPromptAsk": "當你需要使用者做決定/澄清/選擇，且已連接 tunnelbox 手機時，請用 `tunnelbox_ask` 工具在手機上提問，而不是自行猜測；等到使用者作答後再繼續。",
+  "adapter.warnCodebuddyCliMissing": "找不到 CodeBuddy CLI 可執行檔 \"{bin}\"；請安裝（npm i -g @tencent-ai/codebuddy-code），或將 TUNNELBOX_CODEBUDDY_BIN 設為其路徑",
+  "adapter.checkCodebuddyHeader": "tunnelbox-codebuddy 環境自檢",
+  "adapter.checkCodebuddyCliMissing": "找不到 CodeBuddy CLI 可執行檔（{bin}）；請安裝：npm i -g @tencent-ai/codebuddy-code",
+  "adapter.checkCodebuddyAcpHint": "已偵測到 CodeBuddy CLI；ACP 模式（`codebuddy --acp`）將提供串流/審批/選擇",
+  "adapter.errCodebuddyAcpSpawn": "無法啟動 CodeBuddy `--acp`：{message}（請確認 CodeBuddy CLI 支援 `--acp`）",
+  "adapter.errCodebuddyAcpNoSession": "CodeBuddy ACP 未回傳工作階段 id",
+  "adapter.codebuddySessionTitle": "CodeBuddy 工作階段",
+  "adapter.logElicitationNative": "選擇/確認請求 -> 手機卡片 id={id}（工作階段={session}）",
+  "adapter.logCodebuddyAuthSkipped": "CodeBuddy 尚未透過 ACP 認證；請先執行一次 `codebuddy` 登入（或設定 CODEBUDDY_API_KEY），也可設定 TUNNELBOX_CODEBUDDY_AUTH=<methodId> 走 ACP 認證",
+  "adapter.warnKimiCliMissing": "找不到 Kimi CLI 可執行檔 \"{bin}\"；請安裝（https://moonshotai.github.io/kimi-code/），或將 TUNNELBOX_KIMI_BIN 設為其路徑",
+  "adapter.checkKimiHeader": "tunnelbox-kimi 環境自檢",
+  "adapter.checkKimiCliMissing": "找不到 Kimi CLI 可執行檔（{bin}）；請從 https://moonshotai.github.io/kimi-code/ 安裝",
+  "adapter.checkKimiAcpHint": "已偵測到 Kimi CLI；ACP 模式（`kimi acp`）將提供串流/審批/選擇",
+  "adapter.errKimiAcpSpawn": "無法啟動 Kimi `acp`：{message}（請確認 Kimi CLI 支援 `kimi acp`）",
+  "adapter.errKimiAcpNoSession": "Kimi ACP 未回傳工作階段 id",
+  "adapter.kimiSessionTitle": "Kimi 工作階段",
+  "adapter.logKimiAuthRequired": "Kimi 未登入：請先執行一次 `kimi` 並傳送 /login（或設定 API Key）—— {message}",
+  "adapter.warnTraeCliMissing": "找不到 TraeCode CLI 可執行檔 \"{bin}\"；請安裝（https://docs.trae.cn/cli_what-is-trae-cli），或將 TUNNELBOX_TRAE_BIN 設為其路徑",
+  "adapter.checkTraeHeader": "tunnelbox-trae 環境自檢",
+  "adapter.checkTraeCliMissing": "找不到 TraeCode CLI 可執行檔（{bin}）；請從 https://docs.trae.cn/cli_what-is-trae-cli 安裝",
+  "adapter.checkTraeAcpHint": "已偵測到 TraeCode CLI；ACP 模式（`traecli acp serve`）將提供串流/審批/選擇",
+  "adapter.errTraeAcpSpawn": "無法啟動 TraeCode `acp serve`：{message}（請確認 TraeCode CLI 支援 ACP）",
+  "adapter.errTraeAcpNoSession": "TraeCode ACP 未回傳工作階段 id",
+  "adapter.traeSessionTitle": "Trae 工作階段",
+  "adapter.logTraeAuthSkipped": "已略過 TraeCode ACP 認證；請用 `traecli login` 登入（TraeCode CLI 僅 TRAE 企業版旗艦版可用）",
+  "adapter.warnQoderCliMissing": "找不到 Qoder CLI 可執行檔 \"{bin}\"；請安裝（npm i -g @qoder-ai/qodercli），或將 TUNNELBOX_QODER_BIN 設為其路徑",
+  "adapter.checkQoderHeader": "tunnelbox-qoder 環境自檢",
+  "adapter.checkQoderCliMissing": "找不到 Qoder CLI 可執行檔（{bin}）；請安裝：npm i -g @qoder-ai/qodercli",
+  "adapter.checkQoderAcpHint": "已偵測到 Qoder CLI；ACP 模式（`qoder --acp`）將提供串流/審批/選擇",
+  "adapter.errQoderAcpSpawn": "無法啟動 Qoder `--acp`：{message}（請確認 Qoder CLI 支援 `--acp`）",
+  "adapter.errQoderAcpNoSession": "Qoder ACP 未回傳工作階段 id",
+  "adapter.qoderSessionTitle": "Qoder 工作階段",
+  "adapter.logQoderAuthSkipped": "已略過 Qoder ACP 認證；請用 `qoder login` 登入，或設定 QODER_PERSONAL_ACCESS_TOKEN"
 }

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@tunnelbox/core",
-  "version": "0.1.26",
+  "version": "0.1.28",
   "description": "tunnelbox 共享核心：协议类型、中继客户端、状态持久化、二维码配对",
   "type": "module",
   "main": "./dist/index.js",

package/src/acp/client.ts

@@ -0,0 +1,187 @@
+/**
+ * ACP 子进程的 stdio 客户端：JSON-RPC 2.0（NDJSON，每行一条消息）。
+ *
+ * 分发：
+ *  - `method` + `id`      → 服务端请求（需应答，交 `onServerRequest`）
+ *  - `method`（无 id）    → 通知（交 `onNotification`）
+ *  - `id` + result/error  → 我方请求的响应
+ */
+import { spawn, type ChildProcess, type SpawnOptions } from "node:child_process";
+import { cmdLineFor, resolveCliBinary } from "../cli";
+import type { JsonRpcError, RequestId } from "./protocol";
+
+export interface AcpHandlers {
+  onNotification?: (method: string, params: unknown) => void;
+  onServerRequest?: (id: RequestId, method: string, params: unknown) => void;
+  onStderr?: (line: string) => void;
+  onExit?: (code: number | null, signal: string | null) => void;
+}
+
+interface Pending {
+  resolve: (v: unknown) => void;
+  reject: (e: Error) => void;
+  timer: NodeJS.Timeout | null;
+}
+
+const DEFAULT_REQUEST_TIMEOUT_MS = 30_000;
+
+export class AcpClient {
+  private child: ChildProcess | null = null;
+  private buf = "";
+  private seq = 0;
+  private pending = new Map<RequestId, Pending>();
+  private exited = false;
+
+  constructor(
+    private bin: string,
+    private args: string[] = [],
+    private handlers: AcpHandlers = {},
+    private label = "acp",
+  ) {}
+
+  get alive(): boolean {
+    return !!this.child && !this.exited;
+  }
+
+  /** 启动 ACP 子进程（stdio 传输）。 */
+  start(cwd?: string): Promise<void> {
+    return new Promise<void>((resolve, reject) => {
+      const resolved = resolveCliBinary(this.bin);
+      const opts: SpawnOptions = { cwd, env: process.env, stdio: ["pipe", "pipe", "pipe"] };
+      let child: ChildProcess;
+      try {
+        child = resolved?.viaShell
+          ? spawn(cmdLineFor(resolved.path, this.args), [], { ...opts, shell: true })
+          : spawn(resolved?.path ?? this.bin, this.args, opts);
+      } catch (e) {
+        reject(e as Error);
+        return;
+      }
+      this.child = child;
+      this.exited = false;
+
+      child.stdout?.setEncoding("utf8");
+      child.stdout?.on("data", (chunk: string) => this.onChunk(chunk));
+      child.stderr?.setEncoding("utf8");
+      child.stderr?.on("data", (chunk: string) => {
+        for (const l of chunk.split("\n")) {
+          const s = l.trim();
+          if (s) this.handlers.onStderr?.(s);
+        }
+      });
+      child.on("error", (e) => {
+        this.failAll(e as Error);
+        reject(e as Error);
+      });
+      child.on("close", (code, signal) => {
+        this.exited = true;
+        this.child = null;
+        this.failAll(new Error(`${this.label} exited (code=${code ?? "null"} signal=${signal ?? "null"})`));
+        this.handlers.onExit?.(code, signal);
+      });
+      resolve();
+    });
+  }
+
+  /**
+   * 发送请求并等待响应。`timeoutMs <= 0` 表示不设超时（如 `session/prompt` 持续整轮）。
+   */
+  request<T = unknown>(method: string, params?: unknown, timeoutMs = DEFAULT_REQUEST_TIMEOUT_MS): Promise<T> {
+    if (!this.alive) return Promise.reject(new Error(`${this.label} not running`));
+    const id = ++this.seq;
+    return new Promise<T>((resolve, reject) => {
+      const timer =
+        timeoutMs > 0
+          ? setTimeout(() => {
+              this.pending.delete(id);
+              reject(new Error(`${this.label} request timeout: ${method}`));
+            }, timeoutMs)
+          : null;
+      this.pending.set(id, { resolve: resolve as (v: unknown) => void, reject, timer });
+      this.write({ jsonrpc: "2.0", id, method, ...(params === undefined ? {} : { params }) });
+    });
+  }
+
+  /** 应答服务端请求（成功）。 */
+  respond(id: RequestId, result: unknown): void {
+    this.write({ jsonrpc: "2.0", id, result });
+  }
+
+  /** 应答服务端请求（失败）。 */
+  respondError(id: RequestId, code: number, message: string): void {
+    this.write({ jsonrpc: "2.0", id, error: { code, message } });
+  }
+
+  /** 发送通知。 */
+  notify(method: string, params?: unknown): void {
+    this.write({ jsonrpc: "2.0", method, ...(params === undefined ? {} : { params }) });
+  }
+
+  stop(): void {
+    this.exited = true;
+    this.failAll(new Error(`${this.label} client stopped`));
+    try {
+      this.child?.kill();
+    } catch {
+      /* ignore */
+    }
+    this.child = null;
+  }
+
+  private write(obj: unknown): void {
+    try {
+      this.child?.stdin?.write(JSON.stringify(obj) + "\n");
+    } catch {
+      /* ignore */
+    }
+  }
+
+  private onChunk(chunk: string): void {
+    this.buf += chunk;
+    let idx: number;
+    while ((idx = this.buf.indexOf("\n")) >= 0) {
+      const line = this.buf.slice(0, idx).trim();
+      this.buf = this.buf.slice(idx + 1);
+      if (line) this.onLine(line);
+    }
+  }
+
+  private onLine(line: string): void {
+    let msg: Record<string, unknown>;
+    try {
+      msg = JSON.parse(line) as Record<string, unknown>;
+    } catch {
+      this.handlers.onStderr?.(`non-json line: ${line.slice(0, 200)}`);
+      return;
+    }
+    const method = typeof msg.method === "string" ? msg.method : "";
+    const id = msg.id as RequestId | undefined;
+    if (method && id !== undefined) {
+      this.handlers.onServerRequest?.(id, method, msg.params);
+      return;
+    }
+    if (method) {
+      this.handlers.onNotification?.(method, msg.params);
+      return;
+    }
+    if (id === undefined) return;
+    const p = this.pending.get(id);
+    if (!p) return;
+    this.pending.delete(id);
+    if (p.timer) clearTimeout(p.timer);
+    if (msg.error) {
+      const err = msg.error as JsonRpcError["error"];
+      p.reject(new Error(`${err?.message || `${this.label} error`}${err?.code !== undefined ? ` (${err.code})` : ""}`));
+    } else {
+      p.resolve(msg.result);
+    }
+  }
+
+  private failAll(e: Error): void {
+    for (const p of this.pending.values()) {
+      if (p.timer) clearTimeout(p.timer);
+      p.reject(e);
+    }
+    this.pending.clear();
+  }
+}

package/src/acp/index.ts

@@ -0,0 +1,11 @@
+/**
+ * @tunnelbox/core —— ACP（Agent Client Protocol）共享层。
+ * 供各 ACP 适配器（cursor/codebuddy/kimi/trae…）复用：协议类型、stdio 客户端、
+ * 常驻进程监督器、session/update 映射、权限选择辅助、会话镜像工厂。
+ */
+export * from "./protocol";
+export * from "./client";
+export * from "./map";
+export * from "./supervisor";
+export * from "./permissions";
+export * from "./mirror";

package/src/acp/map.ts

@@ -0,0 +1,45 @@
+/**
+ * ACP `session/update` → tunnelbox 协议（`Part` / `ChatMessage`）的映射辅助。
+ */
+import type { ChatMessage, Part } from "../types";
+import type { ContentBlock, PlanEntry, ToolCall } from "./protocol";
+
+/** 取 content block 的文本（仅 text 块）。 */
+export function textOf(content: ContentBlock | undefined): string {
+  if (content && typeof content === "object" && (content as { type?: string }).type === "text") {
+    return String((content as { text?: unknown }).text ?? "");
+  }
+  return "";
+}
+
+export function safeJson(v: unknown): string {
+  if (v === undefined || v === null) return "";
+  try {
+    return typeof v === "string" ? v : JSON.stringify(v, null, 2);
+  } catch {
+    return String(v);
+  }
+}
+
+/** 工具调用 → `Part`（messageID/part.id 均用 toolCallId，保证同一工具卡的流式更新归并）。 */
+export function toolPart(tc: ToolCall, complete: boolean): Part {
+  const name = tc.title || tc.kind || "tool";
+  return { id: tc.toolCallId, type: "tool", tool: name, args: safeJson(tc.rawInput), complete };
+}
+
+/** plan 条目 → 可读文本（用于 text 部件展示）。 */
+export function planText(entries: PlanEntry[] | undefined): string {
+  if (!Array.isArray(entries)) return "";
+  return entries
+    .map((e) => {
+      const mark = e.status === "completed" ? "x" : e.status === "in_progress" ? "~" : " ";
+      return `- [${mark}] ${e.content ?? ""}`.trim();
+    })
+    .filter(Boolean)
+    .join("\n");
+}
+
+/** 由 ACP 会话事件拼出的历史消息（本地镜像兜底时用）。 */
+export function partMessage(id: string, role: "user" | "assistant", part: Part, created = Date.now()): ChatMessage {
+  return { id, role, parts: [part], created };
+}