dsh-bash-terminal-ts 0.7.1 → 0.7.2-compat.2

package/dsh.plugin.json

@@ -1,22 +1,22 @@
-{
-  "id": "dsh-bash-terminal-ts",
-  "name": "dsh-bash-terminal-ts",
-  "version": "0.7.1",
-  "description": {
-    "en": "One shell tool that runs commands through PowerShell, Git Bash, MSYS2 or WSL on Windows, with a user-chosen default terminal in the Web UI settings.",
-    "zh": "一个 shell 工具，可在 Windows 上通过 PowerShell / Git Bash / MSYS2 / WSL 执行命令，默认终端在 Web UI 设置中选择。"
-  },
-  "homepage": "https://github.com/drscrewdriver/dsh-bash-terminal-ts",
-  "repository": {
-    "type": "git",
-    "url": "https://github.com/drscrewdriver/dsh-bash-terminal-ts.git"
-  },
-  "license": "MIT",
-  "engines": {
-    "dsh": ">=0.2.0-rc.1 <0.2.1-0"
-  },
-  "components": {
-    "host": "lib/index.js",
-    "client": "dist/client.js"
-  }
-}
+{
+  "id": "dsh-bash-terminal-ts",
+  "name": "dsh-bash-terminal-ts",
+  "version": "0.7.2-compat.2",
+  "description": {
+    "en": "One shell tool that runs commands through PowerShell, Git Bash, MSYS2 or WSL on Windows, with a user-chosen default terminal in the Web UI settings.",
+    "zh": "一个 shell 工具，可在 Windows 上通过 PowerShell / Git Bash / MSYS2 / WSL 执行命令，默认终端在 Web UI 设置中选择。"
+  },
+  "homepage": "https://github.com/drscrewdriver/dsh-bash-terminal-ts",
+  "repository": {
+    "type": "git",
+    "url": "https://github.com/drscrewdriver/dsh-bash-terminal-ts.git"
+  },
+  "license": "MIT",
+  "engines": {
+    "dsh": ">=0.1.0-rc.8 <0.2.1-0"
+  },
+  "components": {
+    "host": "lib/index.js",
+    "client": "dist/client.js"
+  }
+}

package/lib/client.js

@@ -24,18 +24,14 @@ var __toCommonJS = (mod) => __copyProps(__defProp({}, "__esModule", { value: tru
 // src/client.tsx
 var client_exports = {};
 __export(client_exports, {
-  apply: () => apply,
-  inject: () => inject
+  apply: () => apply
 });
 module.exports = __toCommonJS(client_exports);
 var import_react = require("react");
-var import_dsh_client_store = require("@deepseek-ai/dsh-client-store");
-var import_dsh_client_ui_primitives = require("@deepseek-ai/dsh-client-ui-primitives");
 var import_jsx_runtime = require("react/jsx-runtime");
 var SETTINGS_NS = "settings.bash-terminal";
-var ENTRY_ID = "tool-bash-terminal";
 var SHELLS = ["powershell", "gitbash", "msys2", "wsl"];
-var ROW_CSS = ".btRow{border-bottom:1px solid var(--dsw-alias-border-l2);align-items:center;gap:8px;padding:16px 0;display:flex}.btRowText{flex-direction:column;flex:1;gap:4px;min-width:0;padding-right:48px;display:flex}.btTitle{color:var(--dsw-alias-label-primary);font-size:14px;font-weight:400;line-height:22px}.btDesc{color:var(--dsw-alias-label-tertiary);font-size:12px;font-weight:400;line-height:18px}.btSelector{background:var(--dsw-alias-bg-module-platform);height:36px;font:inherit;color:var(--dsw-alias-label-primary);cursor:pointer;border:none;border-radius:18px;align-items:center;gap:12px;padding:0 14px;font-size:14px;line-height:22px;display:inline-flex}.btSelector:hover{background:var(--dsw-alias-interactive-bg-hover)}.btChevron{flex:none}";
+var ROW_CSS = ".btRow{border-bottom:1px solid var(--dsw-alias-border-l2);align-items:center;gap:8px;padding:16px 0;display:flex}.btRowText{flex-direction:column;flex:1;gap:4px;min-width:0;padding-right:48px;display:flex}.btTitle{color:var(--dsw-alias-label-primary);font-size:14px;font-weight:400;line-height:22px}.btDesc{color:var(--dsw-alias-label-tertiary);font-size:12px;font-weight:400;line-height:18px}.btSelector{background:var(--dsw-alias-bg-module-platform);height:36px;font:inherit;color:var(--dsw-alias-label-primary);cursor:pointer;border:none;border-radius:18px;align-items:center;gap:12px;padding:0 14px;font-size:14px;line-height:22px;display:inline-flex}.btSelector:hover{background:var(--dsw-alias-interactive-bg-hover)}.btGear{position:fixed;right:16px;bottom:110px;z-index:10000;width:40px;height:40px;border-radius:50%;border:1px solid rgba(127,127,127,.4);background:rgba(30,30,32,.85);color:inherit;cursor:pointer;font-size:17px;box-shadow:0 4px 16px rgba(0,0,0,.35)}.btOverlay{position:fixed;inset:0;z-index:10000;background:rgba(0,0,0,.45)}.btPanel{position:fixed;top:6vh;left:50%;transform:translateX(-50%);width:min(760px,92vw);max-height:84vh;overflow-y:auto;z-index:10001;background:var(--dsw-alias-bg-module-platform,rgba(30,30,32,.92));border:1px solid var(--dsw-alias-border-l2,rgba(127,127,127,.3));border-radius:14px;padding:20px;color:var(--dsw-alias-label-primary)}";
 if (typeof document !== "undefined" && document.querySelector('style[data-plugin-css="bash-terminal-row"]') === null) {
   const tag = document.createElement("style");
   tag.dataset.plugin = "dsh-bash-terminal-ts";
@@ -50,7 +46,7 @@ var zh = {
   "shell.gitbash": "Git Bash",
   "shell.msys2": "MSYS2",
   "shell.wsl": "WSL",
-  "shell.unavailable": "\u8BBE\u7F6E\u9762\u4E0D\u53EF\u7528\uFF1A\u5BBF\u4E3B\u672A\u63D0\u4F9B\u672C\u63D2\u4EF6\u7684 configForms \u6761\u76EE\uFF08\u68C0\u67E5 cordis.patch.yml \u7684 entry id\uFF09"
+  "shell.unavailable": "\u8BBE\u7F6E\u9762\u4E0D\u53EF\u7528:\u5BBF\u4E3B\u914D\u7F6E\u6865\u672A\u54CD\u5E94(\u68C0\u67E5\u5BBF\u4E3B\u662F\u5426\u4E3A compat \u7248)"
 };
 var en = {
   "shell.title": "Default terminal",
@@ -59,7 +55,7 @@ var en = {
   "shell.gitbash": "Git Bash",
   "shell.msys2": "MSYS2",
   "shell.wsl": "WSL",
-  "shell.unavailable": "Settings unavailable: the host exposes no configForms entry for this plugin (check the cordis.patch.yml entry id)"
+  "shell.unavailable": "Settings unavailable: the host config bridge did not respond (is the host a compat build?)"
 };
 var fr = {
   "shell.title": "Terminal par d\xE9faut",
@@ -68,136 +64,172 @@ var fr = {
   "shell.gitbash": "Git Bash",
   "shell.msys2": "MSYS2",
   "shell.wsl": "WSL",
-  "shell.unavailable": "Param\xE8tres indisponibles : l'h\xF4te n'expose aucune entr\xE9e configForms pour ce plugin (v\xE9rifiez l'entry id du cordis.patch.yml)"
+  "shell.unavailable": "Param\xE8tres indisponibles: le pont de configuration de l'h\xF4te n'a pas r\xE9pondu"
 };
 var de = {
-  "shell.title": "Standard-Terminal",
-  "shell.description": "Terminal, das vom Shell-Tool verwendet wird",
+  "shell.title": "Standardterminal",
+  "shell.description": "Terminal f\xFCr den Shell-Befehl",
   "shell.powershell": "PowerShell",
   "shell.gitbash": "Git Bash",
   "shell.msys2": "MSYS2",
   "shell.wsl": "WSL",
-  "shell.unavailable": "Einstellungen nicht verf\xFCgbar: Der Host stellt keinen configForms-Eintrag f\xFCr dieses Plugin bereit (Entry-ID in cordis.patch.yml pr\xFCfen)"
+  "shell.unavailable": "Einstellungen nicht verf\xFCgbar: Die Konfigurationsbr\xFCcke des Hosts hat nicht geantwortet"
 };
 var it = {
   "shell.title": "Terminale predefinito",
-  "shell.description": "Terminale usato dallo strumento shell",
+  "shell.description": "Terminale usato dal comando shell",
   "shell.powershell": "PowerShell",
   "shell.gitbash": "Git Bash",
   "shell.msys2": "MSYS2",
   "shell.wsl": "WSL",
-  "shell.unavailable": "Impostazioni non disponibili: l'host non espone alcuna voce configForms per questo plugin (verifica l'entry id in cordis.patch.yml)"
+  "shell.unavailable": "Impostazioni non disponibili: il bridge di configurazione dell'host non ha risposto"
 };
 var ru = {
   "shell.title": "\u0422\u0435\u0440\u043C\u0438\u043D\u0430\u043B \u043F\u043E \u0443\u043C\u043E\u043B\u0447\u0430\u043D\u0438\u044E",
-  "shell.description": "\u0422\u0435\u0440\u043C\u0438\u043D\u0430\u043B, \u0438\u0441\u043F\u043E\u043B\u044C\u0437\u0443\u0435\u043C\u044B\u0439 \u0438\u043D\u0441\u0442\u0440\u0443\u043C\u0435\u043D\u0442\u043E\u043C shell",
+  "shell.description": "\u0422\u0435\u0440\u043C\u0438\u043D\u0430\u043B \u0434\u043B\u044F \u043A\u043E\u043C\u0430\u043D\u0434 \u043E\u0431\u043E\u043B\u043E\u0447\u043A\u0438",
   "shell.powershell": "PowerShell",
   "shell.gitbash": "Git Bash",
   "shell.msys2": "MSYS2",
   "shell.wsl": "WSL",
-  "shell.unavailable": "\u041D\u0430\u0441\u0442\u0440\u043E\u0439\u043A\u0438 \u043D\u0435\u0434\u043E\u0441\u0442\u0443\u043F\u043D\u044B: \u0445\u043E\u0441\u0442 \u043D\u0435 \u043F\u0440\u0435\u0434\u043E\u0441\u0442\u0430\u0432\u043B\u044F\u0435\u0442 \u0437\u0430\u043F\u0438\u0441\u044C configForms \u0434\u043B\u044F \u044D\u0442\u043E\u0433\u043E \u043F\u043B\u0430\u0433\u0438\u043D\u0430 (\u043F\u0440\u043E\u0432\u0435\u0440\u044C\u0442\u0435 entry id \u0432 cordis.patch.yml)"
+  "shell.unavailable": "\u041D\u0430\u0441\u0442\u0440\u043E\u0439\u043A\u0438 \u043D\u0435\u0434\u043E\u0441\u0442\u0443\u043F\u043D\u044B: \u043C\u043E\u0441\u0442 \u043A\u043E\u043D\u0444\u0438\u0433\u0443\u0440\u0430\u0446\u0438\u0438 \u0445\u043E\u0441\u0442\u0430 \u043D\u0435 \u043E\u0442\u0432\u0435\u0442\u0438\u043B"
 };
 var es = {
-  "shell.title": "Terminal predeterminado",
-  "shell.description": "Terminal que usa la herramienta shell",
+  "shell.title": "Terminal predeterminada",
+  "shell.description": "Terminal usada por el comando shell",
   "shell.powershell": "PowerShell",
   "shell.gitbash": "Git Bash",
   "shell.msys2": "MSYS2",
   "shell.wsl": "WSL",
-  "shell.unavailable": "Configuraci\xF3n no disponible: el host no expone ninguna entrada configForms para este plugin (comprueba el entry id de cordis.patch.yml)"
+  "shell.unavailable": "Configuraci\xF3n no disponible: el puente de configuraci\xF3n del host no respondi\xF3"
 };
-var inject = ["slots", "locale", "configForms"];
-function ShellPreferenceRow({ t, useStore, setShell }) {
-  const shell = useStore((s) => s.shell);
-  const writable = useStore((s) => s.writable);
-  const status = useStore((s) => s.status);
-  const [open, setOpen] = (0, import_react.useState)(false);
-  const items = SHELLS.map((id) => ({ id, label: t("shell." + id) }));
+var zhDictTitle = () => zh["shell.title"] ?? "Terminal";
+async function bridgeConfig() {
+  try {
+    const r = await fetch("/api/bash-terminal/config", {
+      method: "POST",
+      headers: { "content-type": "application/json" },
+      body: "{}"
+    });
+    const d = await r.json();
+    return d && d.ok ? d.value : null;
+  } catch {
+    return null;
+  }
+}
+async function bridgeWrite(value) {
+  try {
+    const r = await fetch("/api/bash-terminal/config", {
+      method: "POST",
+      headers: { "content-type": "application/json" },
+      body: JSON.stringify({ defaultShell: value })
+    });
+    const d = await r.json();
+    return !!(d && d.ok);
+  } catch {
+    return false;
+  }
+}
+function ShellPreferenceRow() {
+  const [shell, setShell] = (0, import_react.useState)("powershell");
+  const [status, setStatus] = (0, import_react.useState)("loading");
+  (0, import_react.useEffect)(() => {
+    let alive = true;
+    bridgeConfig().then((v) => {
+      if (!alive) return;
+      if (v && v.defaultShell) {
+        setShell(v.defaultShell);
+        setStatus("ready");
+      } else {
+        setStatus("unavailable");
+      }
+    });
+    return () => {
+      alive = false;
+    };
+  }, []);
+  const change = (value) => {
+    setShell(value);
+    void bridgeWrite(value);
+  };
   if (status === "unavailable") {
     return /* @__PURE__ */ (0, import_jsx_runtime.jsx)("div", { className: "btRow", children: /* @__PURE__ */ (0, import_jsx_runtime.jsxs)("div", { className: "btRowText", children: [
-      /* @__PURE__ */ (0, import_jsx_runtime.jsx)("div", { className: "btTitle", children: t("shell.title") }),
-      /* @__PURE__ */ (0, import_jsx_runtime.jsx)("div", { className: "btDesc", children: t("shell.unavailable") })
+      /* @__PURE__ */ (0, import_jsx_runtime.jsx)("div", { className: "btTitle", children: zh["shell.title"] }),
+      /* @__PURE__ */ (0, import_jsx_runtime.jsx)("div", { className: "btDesc", children: zh["shell.unavailable"] })
     ] }) });
   }
   return /* @__PURE__ */ (0, import_jsx_runtime.jsxs)("div", { className: "btRow", children: [
     /* @__PURE__ */ (0, import_jsx_runtime.jsxs)("div", { className: "btRowText", children: [
-      /* @__PURE__ */ (0, import_jsx_runtime.jsx)("div", { className: "btTitle", children: t("shell.title") }),
-      /* @__PURE__ */ (0, import_jsx_runtime.jsx)("div", { className: "btDesc", children: t("shell.description") })
+      /* @__PURE__ */ (0, import_jsx_runtime.jsx)("div", { className: "btTitle", children: zh["shell.title"] }),
+      /* @__PURE__ */ (0, import_jsx_runtime.jsx)("div", { className: "btDesc", children: zh["shell.description"] })
     ] }),
     /* @__PURE__ */ (0, import_jsx_runtime.jsx)(
-      import_dsh_client_ui_primitives.Menu,
+      "select",
       {
-        open,
-        onClose: () => setOpen(false),
-        items,
-        selectedId: shell,
-        onSelect: (id) => {
-          setOpen(false);
-          setShell(id);
-        },
-        align: "end",
-        portal: true,
-        anchor: /* @__PURE__ */ (0, import_jsx_runtime.jsxs)(
-          "button",
-          {
-            type: "button",
-            className: "btSelector",
-            "aria-haspopup": "menu",
-            "aria-expanded": open,
-            disabled: !writable,
-            onClick: () => setOpen(!open),
-            style: !writable ? { opacity: 0.5, cursor: "not-allowed" } : void 0,
-            children: [
-              t("shell." + shell),
-              /* @__PURE__ */ (0, import_jsx_runtime.jsx)(import_dsh_client_ui_primitives.IconChevronDownOutlineMedium, { className: "btChevron" })
-            ]
-          }
-        )
+        className: "btSelector",
+        value: shell,
+        onChange: (e) => change(e.target.value),
+        children: SHELLS.map((id) => /* @__PURE__ */ (0, import_jsx_runtime.jsx)("option", { value: id, children: zh["shell." + id] ?? id }, id))
       }
     )
   ] });
 }
-var zhDictTitle = () => zh["shell.title"] ?? "\u7EC8\u7AEF";
+function SettingsOverlayEntry() {
+  const [open, setOpen] = (0, import_react.useState)(false);
+  return /* @__PURE__ */ (0, import_jsx_runtime.jsxs)("div", { style: { position: "fixed", right: "16px", bottom: "110px", zIndex: 1e4 }, children: [
+    open ? /* @__PURE__ */ (0, import_jsx_runtime.jsx)("div", { className: "btOverlay", onClick: () => setOpen(false) }) : null,
+    open ? /* @__PURE__ */ (0, import_jsx_runtime.jsxs)("div", { className: "btPanel", children: [
+      /* @__PURE__ */ (0, import_jsx_runtime.jsx)(
+        "button",
+        {
+          type: "button",
+          className: "btSelector",
+          style: { float: "right", height: "30px", fontSize: "12px", marginBottom: "8px" },
+          onClick: () => setOpen(false),
+          children: "\u2715"
+        }
+      ),
+      /* @__PURE__ */ (0, import_jsx_runtime.jsx)(ShellPreferenceRow, {})
+    ] }) : null,
+    /* @__PURE__ */ (0, import_jsx_runtime.jsx)("button", { type: "button", className: "btGear", title: zhDictTitle(), onClick: () => setOpen(!open), children: "\u2699" })
+  ] });
+}
 function apply(ctx) {
-  ctx.effect(() => ctx.locale.register(SETTINGS_NS, { zh, en, fr, de, it, ru, es }), "bash-terminal: settings dictionaries");
-  const scope = ctx.configForms.get(ENTRY_ID);
-  const store = (0, import_dsh_client_store.defineStore)({
-    init: () => ({ shell: "powershell", revision: -1, writable: false, status: "loading" }),
-    actions: {
-      sync: (d, shell, revision, writable, status) => {
-        if (revision !== void 0 && revision <= d.revision) return;
-        if (shell !== void 0) d.shell = shell;
-        if (revision !== void 0) d.revision = revision;
-        if (writable !== void 0) d.writable = writable;
-        if (status !== void 0) d.status = status;
-      }
+  const safe = (tag, fn) => {
+    try {
+      fn();
+    } catch (e) {
+      console.warn(`[dsh-bash-terminal-ts] client surface '${tag}' failed:`, e);
     }
-  });
-  let bound;
-  const push = (snap) => {
-    bound?.sync(snap.value?.defaultShell, snap.revision, snap.writable, snap.status);
   };
-  ctx.slots.inject(
-    "dsh-family.tab",
-    () => ctx.slots.register(
-      {
-        name: "dsh-family.tab",
-        id: "bash-terminal-shell",
-        order: 60,
-        label: () => zhDictTitle(),
-        store,
-        locale: SETTINGS_NS,
-        inject: (actions) => {
-          bound = actions;
-          push(scope.getSnapshot());
-          return { setShell: (value) => void scope.set("defaultShell", value) };
-        }
-      },
-      ShellPreferenceRow
-    ),
-    "bash-terminal: settings row"
-  );
-  ctx.effect(() => scope.subscribe(() => push(scope.getSnapshot())), "bash-terminal: settings watch");
+  safe("locale", () => {
+    ctx.effect(
+      () => ctx.locale.register(SETTINGS_NS, { zh, en, fr, de, it, ru, es }),
+      "bash-terminal: settings dictionaries"
+    );
+  });
+  safe("dsh-family.tab", () => {
+    ctx.slots.inject(
+      "dsh-family.tab",
+      () => ctx.slots.register(
+        {
+          name: "dsh-family.tab",
+          id: "bash-terminal-shell",
+          order: 60,
+          label: zhDictTitle,
+          locale: SETTINGS_NS,
+          inject: () => ({})
+        },
+        () => /* @__PURE__ */ (0, import_jsx_runtime.jsx)(ShellPreferenceRow, {})
+      ),
+      "bash-terminal: settings row"
+    );
+  });
+  safe("shell.overlay", () => {
+    ctx.slots.inject(
+      "shell.overlay",
+      () => ctx.slots.register({ name: "shell.overlay", id: "bash-terminal-settings" }, () => /* @__PURE__ */ (0, import_jsx_runtime.jsx)(SettingsOverlayEntry, {}))
+    );
+  });
 }
 
 		return module.exports;

package/lib/index.js

@@ -27,6 +27,8 @@ import { ESCALATION_TARGETS, TOOL_ABORTED, approveEscalation, defineTool, escala
 import { createTerminalRegistry, terminalTool } from "./terminal.js";
 /** Stable Cordis plugin name. */
 export const name = "bash-terminal";
+/** Composition entry id (the `tool-bash-terminal` row the bundle patch declares). */
+const ENTRY_ID = "tool-bash-terminal";
 /** Services required before the tool can register. */
 export const inject = ["tools", "systemPrompt", "shellEnv", "subprocess", "settings", "sandbox", "sandboxPolicy"];
 /** The terminal backends this tool exposes, in catalog order. */
@@ -501,7 +503,13 @@ export function apply(ctx, config = {}) {
     // 0.1.7: `defaultShell` is a `.volatile()` config field — the loader hands
     // `apply` a live ref and the latest value is resolved on every read; there
     // is no settings registration call anymore (removed with the 0.1.7 host).
+    // compat-legacy: ≤0.1.6 的宿主没有配置热重载,bridge 写入走这个覆盖值
+    // (rc.1+ 上 volatile 与覆盖值同源同写,二者一致)。
+    let shellOverride;
     const currentShell = () => {
+        if (typeof shellOverride === "string" && SHELLS.includes(shellOverride)) {
+            return shellOverride;
+        }
         const v = config.defaultShell;
         if (typeof v === "string")
             return v;
@@ -533,6 +541,99 @@ export function apply(ctx, config = {}) {
         order: 105,
         text: "Use the shell tool for terminal commands: it runs in the terminal the user chose in Settings -> General -> Default terminal (PowerShell, Git Bash, MSYS2, or WSL) and honors the DSH sandbox. Prefer it over the pwsh tool for everyday commands; keep the pwsh tool for cases that specifically need the sandboxed PowerShell surface."
     });
+    // compat-legacy: 六线统一配置通道(≤0.1.6 无 client-store 模块表,client 走本
+    // bridge 读写 defaultShell)。写路径 = settings.mutate;≤0.1.6 的 loader 不会自动
+    // 注册命名空间,复用 perm-gate 自门控(not registered → register → 重试);
+    // rc.1+ 命名空间由 loader 占用,该分支自然不命中。GET 带回当前值与可选集。
+    // 宿主 context 类型未收录 inject/局部服务形状,compat 桥按宽化面调用。
+    const compatCtx = ctx;
+    compatCtx.inject(["webServer", "settings"], (svcCtx) => {
+        const svc = svcCtx.settings;
+        const writeShell = async (value) => {
+            if (typeof svc.mutate !== "function") {
+                // 显式降级:该线 settings 服务无 mutate(理论仅最老线),覆盖值仅本进程
+                // 生效;持久化请改 cordis.patch.yml 的 defaultShell。
+                throw new Error("settings service exposes no mutate on this host line - defaultShell applies for this process only; persist via cordis.patch.yml");
+            }
+            shellOverride = value;
+            try {
+                await svc.mutate(ENTRY_ID, [{ op: "set", path: ["defaultShell"], value }]);
+            }
+            catch (e) {
+                const message = e instanceof Error ? e.message : String(e);
+                if (!/not registered/i.test(message) || typeof svc.register !== "function") {
+                    throw e;
+                }
+                console.warn(`[dsh-bash-terminal-ts] legacy line: registering settings namespace ${ENTRY_ID}`);
+                svc.register(ENTRY_ID, Config, { base: { defaultShell: value } });
+                await svc.mutate(ENTRY_ID, [{ op: "set", path: ["defaultShell"], value }]);
+                console.warn("[dsh-bash-terminal-ts] legacy settings namespace registered");
+            }
+        };
+        svcCtx.effect(() => {
+            const json = (res, status, body) => {
+                res.writeHead(status, { "content-type": "application/json; charset=utf-8" });
+                res.end(JSON.stringify(body));
+            };
+            const handler = (req, res) => {
+                const addr = req.socket?.remoteAddress ?? "";
+                if (addr !== "127.0.0.1" && addr !== "::1" && addr !== "::ffff:127.0.0.1") {
+                    json(res, 403, { ok: false, code: "loopback-only" });
+                    return;
+                }
+                if (req.method === "GET") {
+                    // 缝内省:compat 验证用——当前线 ctx.subprocess 的真实能力面
+                    const seam = ctx;
+                    const sp = seam.subprocess;
+                    json(res, 200, {
+                        ok: true,
+                        value: {
+                            defaultShell: currentShell(),
+                            shells: SHELLS,
+                            seam: { spawn: typeof sp?.spawn, spawnTerminal: typeof sp?.spawnTerminal },
+                        },
+                    });
+                    return;
+                }
+                if (req.method !== "POST") {
+                    json(res, 405, { ok: false, code: "method-not-allowed" });
+                    return;
+                }
+                const chunks = [];
+                let size = 0;
+                req.on("data", (c) => {
+                    size += c.length;
+                    if (size <= 65536)
+                        chunks.push(c);
+                });
+                req.on("end", () => {
+                    let body = {};
+                    try {
+                        body = JSON.parse(Buffer.concat(chunks).toString("utf8") || "{}");
+                    }
+                    catch {
+                        json(res, 400, { ok: false, code: "bad-json" });
+                        return;
+                    }
+                    const value = typeof body.defaultShell === "string" ? body.defaultShell : "";
+                    if (!SHELLS.includes(value)) {
+                        json(res, 400, { ok: false, code: "invalid-shell" });
+                        return;
+                    }
+                    void writeShell(value)
+                        .then(() => json(res, 200, { ok: true, value: { defaultShell: value } }))
+                        .catch((e) => json(res, 500, { ok: false, code: "write-failed", message: e instanceof Error ? e.message : String(e) }));
+                });
+            };
+            const registered = [
+                svcCtx.webServer.register({ kind: "exact", path: "/api/bash-terminal/config", handler }),
+            ];
+            return () => {
+                for (const dispose of registered)
+                    dispose();
+            };
+        }, "bash-terminal: compat config bridge");
+    });
     const toolName = "shell";
     const terminalRegistry = createTerminalRegistry(ctx);
     ctx.tools.register(terminalTool(ctx, terminalRegistry, paths, () => currentShell()));