dsh-bash-terminal-ts 0.6.3 → 0.7.0

package/src/client.tsx

@@ -1,207 +1,201 @@
-// dsh-bash-terminal client plugin: a "Default terminal" preference row in the
-// Web UI General settings, mirroring the shipped EnterBehaviorRow grammar
-// (row layout, capsule selector with chevron, --dsw-* tokens).
-//
-// The row offers one entry per host shell id — powershell / gitbash / msys2 /
-// wsl — in the same order as SHELLS in ./index.ts.
-//
-// DSH >= 0.1.5: the browser module table (PLATFORM_MODULES) seeds react,
-// @deepseek-ai/cordis, @deepseek-ai/dsh-client-store, @deepseek-ai/dsh-client-ui-slots,
-// @deepseek-ai/dsh-client-ui-primitives and @deepseek-ai/dsh-client-ui-dockkit by
-// exact bare specifier. The old dsh-client-runtime name is gone from that table
-// (and so is its /client subpath), so this bundle requests dsh-client-store.
-
-import { useState } from "react";
-import { defineStore } from "@deepseek-ai/dsh-client-store";
-import { IconChevronDownOutlineMedium, Menu } from "@deepseek-ai/dsh-client-ui-primitives";
-
-const SETTINGS_NS = "settings.bash-terminal";
-/** Entry id of this plugin in the active profile (cordis.patch.yml). */
-const ENTRY_ID = "tool-bash-terminal";
-const SHELLS = ["powershell", "gitbash", "msys2", "wsl"] as const;
-
-type ShellOption = (typeof SHELLS)[number];
-
-// Injected once when the browser loads the bundle (node tests guard on document).
-const 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}";
-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";
-  tag.dataset.pluginCss = "bash-terminal-row";
-  tag.textContent = ROW_CSS;
-  document.head.appendChild(tag);
-}
-
-const zh: Record<string, string> = {
-  "shell.title": "默认终端",
-  "shell.description": "shell 工具执行命令时使用的终端",
-  "shell.powershell": "PowerShell",
-  "shell.gitbash": "Git Bash",
-  "shell.msys2": "MSYS2",
-  "shell.wsl": "WSL",
-  "shell.unavailable": "设置面不可用：宿主未提供本插件的 configForms 条目（检查 cordis.patch.yml 的 entry id）"
-};
-const en: Record<string, string> = {
-  "shell.title": "Default terminal",
-  "shell.description": "Terminal used by the shell tool",
-  "shell.powershell": "PowerShell",
-  "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)"
-};
-
-export const inject = ["slots", "locale", "configForms"];
-
-/** Row state snapshot served through the settings store. */
-interface RowState {
-  shell: string;
-  revision: number;
-  writable: boolean;
-  status: "loading" | "ready" | "unavailable";
-}
-
-interface ShellPreferenceRowProps {
-  t: (key: string) => string;
-  useStore: <S>(selector: (state: RowState) => S) => S;
-  setShell: (id: string) => void;
-}
-
-function ShellPreferenceRow({ t, useStore, setShell }: ShellPreferenceRowProps) {
-  const shell = useStore((s) => s.shell);
-  const writable = useStore((s) => s.writable);
-  const status = useStore((s) => s.status);
-  const [open, setOpen] = useState(false);
-  const items = SHELLS.map((id) => ({ id, label: t("shell." + id) }));
-  if (status === "unavailable") {
-    return (
-      <div className="btRow">
-        <div className="btRowText">
-          <div className="btTitle">{t("shell.title")}</div>
-          <div className="btDesc">{t("shell.unavailable")}</div>
-        </div>
-      </div>
-    );
-  }
-  return (
-    <div className="btRow">
-      <div className="btRowText">
-        <div className="btTitle">{t("shell.title")}</div>
-        <div className="btDesc">{t("shell.description")}</div>
-      </div>
-      <Menu
-        open={open}
-        onClose={() => setOpen(false)}
-        items={items}
-        selectedId={shell}
-        onSelect={(id) => {
-          setOpen(false);
-          setShell(id);
-        }}
-        align="end"
-        portal
-        anchor={
-          <button
-            type="button"
-            className="btSelector"
-            aria-haspopup="menu"
-            aria-expanded={open}
-            disabled={!writable}
-            onClick={() => setOpen(!open)}
-            style={!writable ? { opacity: 0.5, cursor: "not-allowed" } : undefined}
-          >
-            {t("shell." + shell)}
-            <IconChevronDownOutlineMedium className="btChevron" />
-          </button>
-        }
-      />
-    </div>
-  );
-}
-
-interface SettingsSnapshot {
-  status: "loading" | "ready" | "unavailable";
-  value?: { defaultShell?: string };
-  revision: number | undefined;
-  writable: boolean;
-}
-
-interface ConfigFormBinding {
-  getSnapshot(): SettingsSnapshot;
-  subscribe(fn: () => void): () => void;
-  set(field: string, value: string): Promise<boolean>;
-  unset(field: string): Promise<boolean>;
-}
-
-interface ClientContext {
-  effect(fn: () => unknown, name?: string): unknown;
-  locale: { register(ns: string, dicts: Record<string, Record<string, string>>): unknown };
-  configForms: { get(entryId: string): ConfigFormBinding };
-  slots: {
-    inject(slot: string, fn: () => unknown, name?: string): void;
-    register(options: Record<string, unknown>, Component: unknown): Record<string, unknown>;
-  };
-}
-
-interface RowStoreActions {
-  sync(shell?: string, revision?: number, writable?: boolean, status?: RowState["status"]): void;
-}
-
-interface RowStore {
-  actions: RowStoreActions;
-}
-
-/** 账本 label：从 zh/en 字典取「默认终端」标题（无宿主 locale 依赖）。 */
-const zhDictTitle = (): string => (zh as Record<string, string>)["shell.title"] ?? "终端";
-
-export function apply(ctx: ClientContext): void {
-  ctx.effect(() => ctx.locale.register(SETTINGS_NS, { zh, en }), "bash-terminal: settings dictionaries");
-  const scope = ctx.configForms.get(ENTRY_ID);
-  const store = defineStore<RowState, { sync: (draft: RowState, shell?: string, revision?: number, writable?: boolean, status?: RowState["status"]) => void }>({
-    init: (): RowState => ({ shell: "powershell", revision: -1, writable: false, status: "loading" }),
-    actions: {
-      sync: (d, shell, revision, writable, status) => {
-        if (revision !== undefined && revision <= d.revision) return;
-        if (shell !== undefined) d.shell = shell;
-        if (revision !== undefined) d.revision = revision;
-        if (writable !== undefined) d.writable = writable;
-        if (status !== undefined) d.status = status;
-      }
-    }
-  });
-  let bound: RowStoreActions | undefined;
-  const push = (snap: SettingsSnapshot): void => {
-    bound?.sync(snap.value?.defaultShell, snap.revision, snap.writable, snap.status);
-  };
-  // 插件族共用设置 tab（dsh-thinking-levels 顶级「起子插件设置」节声明该子席位）。
-  // thinking-levels 缺席时本 inject 静默等待，不阻塞客户端半。
-  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: unknown) => {
-            bound = actions as RowStoreActions;
-            push(scope.getSnapshot());
-            return { setShell: (value: string) => void scope.set("defaultShell", value) };
-          }
-        },
-        ShellPreferenceRow
-      ),
-    "bash-terminal: settings row"
-  );
-  ctx.effect(() => scope.subscribe(() => push(scope.getSnapshot())), "bash-terminal: settings watch");
-}
+// dsh-bash-terminal-ts client plugin: a "Default terminal" preference row in the
+// Web UI General settings, mirroring the shipped EnterBehaviorRow grammar
+// (row layout, capsule selector with chevron, --dsw-* tokens).
+//
+// The row offers one entry per host shell id — powershell / gitbash / msys2 /
+// wsl — in the same order as SHELLS in ./index.ts.
+//
+// DSH >= 0.1.5: the browser module table (PLATFORM_MODULES) seeds react,
+// @deepseek-ai/cordis, @deepseek-ai/dsh-client-store, @deepseek-ai/dsh-client-ui-slots,
+// @deepseek-ai/dsh-client-ui-primitives and @deepseek-ai/dsh-client-ui-dockkit by
+// exact bare specifier. The old dsh-client-runtime name is gone from that table
+// (and so is its /client subpath), so this bundle requests dsh-client-store.
+
+import { useState } from "react";
+import { defineStore } from "@deepseek-ai/dsh-client-store";
+import { IconChevronDownOutlineMedium, Menu } from "@deepseek-ai/dsh-client-ui-primitives";
+
+const SETTINGS_NS = "settings.bash-terminal";
+/** Entry id of this plugin in the active profile (cordis.patch.yml). */
+const ENTRY_ID = "tool-bash-terminal";
+const SHELLS = ["powershell", "gitbash", "msys2", "wsl"] as const;
+
+// Injected once when the browser loads the bundle (node tests guard on document).
+const 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}";
+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";
+  tag.dataset.pluginCss = "bash-terminal-row";
+  tag.textContent = ROW_CSS;
+  document.head.appendChild(tag);
+}
+
+const zh: Record<string, string> = {
+  "shell.title": "默认终端",
+  "shell.description": "shell 工具执行命令时使用的终端",
+  "shell.powershell": "PowerShell",
+  "shell.gitbash": "Git Bash",
+  "shell.msys2": "MSYS2",
+  "shell.wsl": "WSL",
+  "shell.unavailable": "设置面不可用：宿主未提供本插件的 configForms 条目（检查 cordis.patch.yml 的 entry id）"
+};
+const en: Record<string, string> = {
+  "shell.title": "Default terminal",
+  "shell.description": "Terminal used by the shell tool",
+  "shell.powershell": "PowerShell",
+  "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)"
+};
+
+export const inject = ["slots", "locale", "configForms"];
+
+/** Row state snapshot served through the settings store. */
+interface RowState {
+  shell: string;
+  revision: number;
+  writable: boolean;
+  status: "loading" | "ready" | "unavailable";
+}
+
+interface ShellPreferenceRowProps {
+  t: (key: string) => string;
+  useStore: <S>(selector: (state: RowState) => S) => S;
+  setShell: (id: string) => void;
+}
+
+function ShellPreferenceRow({ t, useStore, setShell }: ShellPreferenceRowProps) {
+  const shell = useStore((s) => s.shell);
+  const writable = useStore((s) => s.writable);
+  const status = useStore((s) => s.status);
+  const [open, setOpen] = useState(false);
+  const items = SHELLS.map((id) => ({ id, label: t("shell." + id) }));
+  if (status === "unavailable") {
+    return (
+      <div className="btRow">
+        <div className="btRowText">
+          <div className="btTitle">{t("shell.title")}</div>
+          <div className="btDesc">{t("shell.unavailable")}</div>
+        </div>
+      </div>
+    );
+  }
+  return (
+    <div className="btRow">
+      <div className="btRowText">
+        <div className="btTitle">{t("shell.title")}</div>
+        <div className="btDesc">{t("shell.description")}</div>
+      </div>
+      <Menu
+        open={open}
+        onClose={() => setOpen(false)}
+        items={items}
+        selectedId={shell}
+        onSelect={(id) => {
+          setOpen(false);
+          setShell(id);
+        }}
+        align="end"
+        portal
+        anchor={
+          <button
+            type="button"
+            className="btSelector"
+            aria-haspopup="menu"
+            aria-expanded={open}
+            disabled={!writable}
+            onClick={() => setOpen(!open)}
+            style={!writable ? { opacity: 0.5, cursor: "not-allowed" } : undefined}
+          >
+            {t("shell." + shell)}
+            <IconChevronDownOutlineMedium className="btChevron" />
+          </button>
+        }
+      />
+    </div>
+  );
+}
+
+interface SettingsSnapshot {
+  status: "loading" | "ready" | "unavailable";
+  value?: { defaultShell?: string };
+  revision: number | undefined;
+  writable: boolean;
+}
+
+interface ConfigFormBinding {
+  getSnapshot(): SettingsSnapshot;
+  subscribe(fn: () => void): () => void;
+  set(field: string, value: string): Promise<boolean>;
+  unset(field: string): Promise<boolean>;
+}
+
+interface ClientContext {
+  effect(fn: () => unknown, name?: string): unknown;
+  locale: { register(ns: string, dicts: Record<string, Record<string, string>>): unknown };
+  configForms: { get(entryId: string): ConfigFormBinding };
+  slots: {
+    inject(slot: string, fn: () => unknown, name?: string): void;
+    register(options: Record<string, unknown>, Component: unknown): Record<string, unknown>;
+  };
+}
+
+interface RowStoreActions {
+  sync(shell?: string, revision?: number, writable?: boolean, status?: RowState["status"]): void;
+}
+
+/** 账本 label：从 zh/en 字典取「默认终端」标题（无宿主 locale 依赖）。 */
+const zhDictTitle = (): string => (zh as Record<string, string>)["shell.title"] ?? "终端";
+
+export function apply(ctx: ClientContext): void {
+  ctx.effect(() => ctx.locale.register(SETTINGS_NS, { zh, en }), "bash-terminal: settings dictionaries");
+  const scope = ctx.configForms.get(ENTRY_ID);
+  const store = defineStore<RowState, { sync: (draft: RowState, shell?: string, revision?: number, writable?: boolean, status?: RowState["status"]) => void }>({
+    init: (): RowState => ({ shell: "powershell", revision: -1, writable: false, status: "loading" }),
+    actions: {
+      sync: (d, shell, revision, writable, status) => {
+        if (revision !== undefined && revision <= d.revision) return;
+        if (shell !== undefined) d.shell = shell;
+        if (revision !== undefined) d.revision = revision;
+        if (writable !== undefined) d.writable = writable;
+        if (status !== undefined) d.status = status;
+      }
+    }
+  });
+  let bound: RowStoreActions | undefined;
+  const push = (snap: SettingsSnapshot): void => {
+    bound?.sync(snap.value?.defaultShell, snap.revision, snap.writable, snap.status);
+  };
+  // 插件族共用设置 tab（dsh-thinking-levels 顶级「起子插件设置」节声明该子席位）。
+  // thinking-levels 缺席时本 inject 静默等待，不阻塞客户端半。
+  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: unknown) => {
+            bound = actions as RowStoreActions;
+            push(scope.getSnapshot());
+            return { setShell: (value: string) => void scope.set("defaultShell", value) };
+          }
+        },
+        ShellPreferenceRow
+      ),
+    "bash-terminal: settings row"
+  );
+  ctx.effect(() => scope.subscribe(() => push(scope.getSnapshot())), "bash-terminal: settings watch");
+}

package/src/dsh-types.ts

@@ -294,7 +294,7 @@ export interface ApprovalSeam {
 // ---- plugin context (server side) ----------------------------------------------
 
 /**
- * The structural context face dsh-bash-terminal programs against: the union
+ * The structural context face dsh-bash-terminal-ts programs against: the union
  * of every `ctx.*` member touched by src/index.ts and src/terminal.ts.
  */
 export interface BashTerminalContext {

package/src/index.ts

@@ -1,4 +1,4 @@
-// dsh-bash-terminal - one shell tool, four Windows terminals.
+// dsh-bash-terminal-ts - one shell tool, four Windows terminals.
 //
 // Registers a model-facing shell tool. The terminal backend (powershell /
 // gitbash / msys2 / wsl) is chosen by the USER in the Web UI settings (default
@@ -324,7 +324,7 @@ function spawnSpec(resolved: SpawnResolution, argv: string[], env: Record<string
 function collectedOutput(handle: { collected: { stdout: unknown; stderr: unknown } }) {
   const { stdout, stderr } = handle.collected;
   if (!isCollectedStream(stdout) || !isCollectedStream(stderr)) {
-    throw new Error("dsh-bash-terminal: subprocess implementation dropped a requested collect stream");
+    throw new Error("dsh-bash-terminal-ts: subprocess implementation dropped a requested collect stream");
   }
   return { stdout, stderr };
 }
@@ -395,7 +395,7 @@ async function runForeground(
 function requireSubprocess(ctx: BashTerminalContext) {
   const subprocess = ctx.subprocess;
   if (subprocess === null) {
-    throw new Error("dsh-bash-terminal: ctx.subprocess seam unavailable (missing inject service)");
+    throw new Error("dsh-bash-terminal-ts: ctx.subprocess seam unavailable (missing inject service)");
   }
   return subprocess;
 }
@@ -669,7 +669,7 @@ const BACKGROUND_OUTPUT_PROPERTIES: Record<string, JsonSchemaNode> = {
 
 export function apply(ctx: BashTerminalContext, config: Partial<ConfigValues> = {}): void {
   if (process.platform !== "win32") {
-    ctx.logger?.info?.("dsh-bash-terminal: only meaningful on win32; skipping tool registration");
+    ctx.logger?.info?.("dsh-bash-terminal-ts: only meaningful on win32; skipping tool registration");
     return;
   }
   const backgroundEnabled = true;
@@ -684,7 +684,7 @@ export function apply(ctx: BashTerminalContext, config: Partial<ConfigValues> =
     return typeof got === "string" ? got : DEFAULT_SHELL;
   };
   if (!(SHELLS as readonly string[]).includes(currentShell())) {
-    throw new Error(`dsh-bash-terminal: invalid defaultShell ${JSON.stringify(currentShell())}`);
+    throw new Error(`dsh-bash-terminal-ts: invalid defaultShell ${JSON.stringify(currentShell())}`);
   }
   /** Official sandbox-escalation surface (mirrors tool-bash): advertise the
    * escalation modes whenever the deployment confines. */
@@ -835,7 +835,7 @@ export function apply(ctx: BashTerminalContext, config: Partial<ConfigValues> =
       const shell = currentShell();
       const argv0 = buildArgv(shell, v.command, paths, v.distro);
       if (argv0[0] === undefined) {
-        throw new Error(`dsh-bash-terminal: ${shell} backend unavailable - executable not found. Install it or set the corresponding *Path config.`);
+        throw new Error(`dsh-bash-terminal-ts: ${shell} backend unavailable - executable not found. Install it or set the corresponding *Path config.`);
       }
       // Only element 0 (the resolved executable) can be undefined; guarded above.
       const argv = argv0 as string[];

package/src/terminal.ts

@@ -1,4 +1,4 @@
-// dsh-bash-terminal: interactive terminal tool over the official PTY seam.
+// dsh-bash-terminal-ts: interactive terminal tool over the official PTY seam.
 // ctx.subprocess.spawnTerminal (node-pty under the hood) allocates a real
 // terminal; this module owns model-facing sessions: open / send / read /
 // signal (Ctrl+C etc.) / close. The backend follows the user's default
@@ -22,8 +22,7 @@ import type {
   JobsRegistry,
   ResolvedPaths,
   TerminalHandle,
-  TerminalSpawnSpec,
-  ToolRunContext
+  TerminalSpawnSpec
 } from "./dsh-types.js";
 
 const MAX_BUFFER_BYTES = 1024 * 1024;