dsh-bash-terminal-ts 0.5.1 → 0.5.2

package/README.en.md

@@ -1,4 +1,4 @@
-# dsh-bash-terminal
+# dsh-bash-terminal-ts
 
 > Community: [LINUX DO](https://linux.do) · [GitHub](https://github.com/drscrewdriver/dsh-bash-terminal-ts)
 
@@ -10,7 +10,7 @@ A DeepSeek Harness (DSH) plugin: one `shell` tool that runs commands through **P
 >
 > | Branch | DSH segment | Package name | Status |
 > |--------|-------------|--------------|--------|
-> | `ts/0.1.5` | 0.1.5-alpha.1 – 0.1.5-rc.x | `dsh-bash-terminal` | this branch; `build` / `unit` / `apply` / `client` / `terminal` green locally |
+> | `ts/0.1.5` | 0.1.5-alpha.1 – 0.1.5-rc.x | `dsh-bash-terminal-ts` | this branch; `build` / `unit` / `apply` / `client` / `terminal` green locally |
 > | `main` | 0.1.2-alpha.1 – 0.1.2-rc.x | `dsh-bash-terminal-ts` | the TypeScript rewrite's mainline |
 >
 > The two lines **deliberately use different package names**, so they install side by side without overwriting each other. Pick the branch that covers your DSH build.
@@ -37,11 +37,11 @@ The **Default terminal** row in Settings -> General: the user picks PowerShell /
 
 ## Install
 
-The package ships the official `dsh.bundle` manifest (its own `cordis.patch.yml`): listing `dsh-bash-terminal` in a profile's `dsh.profile.bundles` auto-applies the mount — no manual profile edits.
+The package ships the official `dsh.bundle` manifest (its own `cordis.patch.yml`): listing `dsh-bash-terminal-ts` in a profile's `dsh.profile.bundles` auto-applies the mount — no manual profile edits.
 
 ```powershell
-npm install -g dsh-bash-terminal
-dsh plugin --profile web add dsh-bash-terminal        # adds to profile bundles + applies the patch
+npm install -g dsh-bash-terminal-ts
+dsh plugin --profile web add dsh-bash-terminal-ts        # adds to profile bundles + applies the patch
 powershell -ExecutionPolicy Bypass -File install.ps1 install   # patches the DSH settings-UI allowlist (see below)
 # restart dsh web
 ```

package/README.md

@@ -1,4 +1,4 @@
-# dsh-bash-terminal
+# dsh-bash-terminal-ts
 
 > 🌐 [English](README.en.md) · 社区交流：[LINUX DO](https://linux.do) · [GitHub](https://github.com/drscrewdriver/dsh-bash-terminal-ts)
 
@@ -10,7 +10,7 @@ DSH（DeepSeek Harness）插件：一个 `shell` 工具，在 Windows 上统一
 >
 > | 分支 | DSH 段 | 包名 | 状态 |
 > |------|--------|------|------|
-> | `ts/0.1.5` | 0.1.5-alpha.1 – 0.1.5-rc.x | `dsh-bash-terminal` | 本分支；`build` / `unit` / `apply` / `client` / `terminal` 本机全绿 |
+> | `ts/0.1.5` | 0.1.5-alpha.1 – 0.1.5-rc.x | `dsh-bash-terminal-ts` | 本分支；`build` / `unit` / `apply` / `client` / `terminal` 本机全绿 |
 > | `main` | 0.1.2-alpha.1 – 0.1.2-rc.x | `dsh-bash-terminal-ts` | TypeScript 重写主线 |
 >
 > **两条线刻意使用不同包名**，因此可以并存安装、互不覆盖。请按你的 DSH 版本选分支。
@@ -46,8 +46,8 @@ DSH（DeepSeek Harness）插件：一个 `shell` 工具，在 Windows 上统一
 
 ```powershell
 # 1. 安装插件包
-npm install -g dsh-bash-terminal
-dsh plugin --profile web add dsh-bash-terminal   # 自动加进 profile 的 bundles 并应用 patch
+npm install -g dsh-bash-terminal-ts
+dsh plugin --profile web add dsh-bash-terminal-ts   # 自动加进 profile 的 bundles 并应用 patch
 
 # 2. patch DSH 设置白名单（DSH 限制，见下方说明）
 powershell -ExecutionPolicy Bypass -File install.ps1 install
@@ -55,21 +55,21 @@ powershell -ExecutionPolicy Bypass -File install.ps1 install
 # 3. 重启 dsh web
 ```
 
-> 已用临时 profile 实测：`bundles: [dsh-bash-terminal]` → dump-config 自动出现 `tool-bash-terminal` entry。
+> 已用临时 profile 实测：`bundles: [dsh-bash-terminal-ts]` → dump-config 自动出现 `tool-bash-terminal` entry。
 
 ### 本地开发安装（junction 直连，改源码即时生效）
 
 ```powershell
 # 1. 链接插件包到 profile 的 node_modules（junction，改源码即时生效）
 $profile = "$env:USERPROFILE\.dsh\profiles\web"
-New-Item -ItemType Junction -Path "$profile\node_modules\dsh-bash-terminal" -Target "D:\workspace\projects\dsh-bash-terminal" | Out-Null
+New-Item -ItemType Junction -Path "$profile\node_modules\dsh-bash-terminal-ts" -Target "D:\workspace\projects\dsh-bash-terminal-ts" | Out-Null
 
 # 2. 让插件能解析 @deepseek-ai/* 依赖（junction 到 profile 的依赖树，插件与宿主共用同一份模块实例）
-New-Item -ItemType Junction -Path "D:\workspace\projects\dsh-bash-terminal\node_modules\@deepseek-ai" -Target "$profile\..\node_modules\@deepseek-ai" | Out-Null
+New-Item -ItemType Junction -Path "D:\workspace\projects\dsh-bash-terminal-ts\node_modules\@deepseek-ai" -Target "$profile\..\node_modules\@deepseek-ai" | Out-Null
 
-# 3. 让 profile 通过官方 bundle 挂载插件（install.ps1 install 会自动做；等价于在 dsh.profile.bundles 加 "dsh-bash-terminal"）
+# 3. 让 profile 通过官方 bundle 挂载插件（install.ps1 install 会自动做；等价于在 dsh.profile.bundles 加 "dsh-bash-terminal-ts"）
 # 4. （仅修改前端源码后）重新打包 client bundle:
-#    cd D:\workspace\projects\dsh-bash-terminal && node scripts/build-client.mjs
+#    cd D:\workspace\projects\dsh-bash-terminal-ts && node scripts/build-client.mjs
 # 5. 重启 dsh web
 ```
 
@@ -84,12 +84,12 @@ New-Item -ItemType Junction -Path "D:\workspace\projects\dsh-bash-terminal\node_
 > 另：0.1.5 的 Web 设置面改为 `settings.describe()` 动态枚举，**不再有 namespace 白名单**
 > （`settings-not-exposed` 已不存在），`install.ps1` 里的白名单 patch 只是历史遗留、可忽略。
 
-> 当前已不再需要手动改 profile 的 `cordis.patch.yml`：插件包内自带 `dsh.bundle.patch`（包内 `cordis.patch.yml`），只要 profile 的 `dsh.profile.bundles` 里有 `dsh-bash-terminal`，DSH 就会自动挂载。
+> 当前已不再需要手动改 profile 的 `cordis.patch.yml`：插件包内自带 `dsh.bundle.patch`（包内 `cordis.patch.yml`），只要 profile 的 `dsh.profile.bundles` 里有 `dsh-bash-terminal-ts`，DSH 就会自动挂载。
 
 验证组合树（无需重启）：
 
 ```powershell
-node "$env:APPDATA\nvm\<node-version>\node_modules\@deepseek-ai\dsh\lib\bin.js" --profile web --dump-config | Select-String dsh-bash-terminal
+node "$env:APPDATA\nvm\<node-version>\node_modules\@deepseek-ai\dsh\lib\bin.js" --profile web --dump-config | Select-String dsh-bash-terminal-ts
 ```
 
 ## 使用
@@ -132,7 +132,7 @@ node "$env:APPDATA\nvm\<node-version>\node_modules\@deepseek-ai\dsh\lib\bin.js"
 npm 账号已启用 2FA 发布验证，需一次性验证码：
 
 ```powershell
-cd D:\workspace\projects\dsh-bash-terminal
+cd D:\workspace\projects\dsh-bash-terminal-ts
 npm publish --otp <验证码>   # 验证码来自你的认证器
 ```
 
@@ -146,9 +146,9 @@ npm publish --otp <验证码>   # 验证码来自你的认证器
 powershell -ExecutionPolicy Bypass -File install.ps1 uninstall
 ```
 
-它会删除 junction、恢复设置白名单、清理旧版遗留的 `cordis.patch.yml` 挂载块，并从 `dsh.profile.bundles` 移除 `dsh-bash-terminal`。之后重启 dsh web 即可。
+它会删除 junction、恢复设置白名单、清理旧版遗留的 `cordis.patch.yml` 挂载块，并从 `dsh.profile.bundles` 移除 `dsh-bash-terminal-ts`。之后重启 dsh web 即可。
 
-手动卸载时，除了删除 `node_modules\dsh-bash-terminal`，还要记得从 profile `package.json` 的 `dsh.profile.bundles` 中移除 `dsh-bash-terminal`。
+手动卸载时，除了删除 `node_modules\dsh-bash-terminal-ts`，还要记得从 profile `package.json` 的 `dsh.profile.bundles` 中移除 `dsh-bash-terminal-ts`。
 
 ## 交互式终端（terminal 工具）
 
@@ -194,7 +194,7 @@ powershell -ExecutionPolicy Bypass -File install.ps1 uninstall
 ## 测试
 
 ```powershell
-cd D:\workspace\projects\dsh-bash-terminal
+cd D:\workspace\projects\dsh-bash-terminal-ts
 npm install          # 安装依赖（含 typescript）
 npm run build        # tsc 编译 src/*.ts → lib/*.js；client.tsx → lib/client.js + dist/client.js；test/*.ts → test-dist/
 npm test             # node test-dist/unit.js → apply.js → client.js → terminal.js

package/cordis.patch.yml

@@ -1,5 +1,5 @@
-# dsh-bash-terminal bundle layer — applied automatically when a profile lists
+# dsh-bash-terminal-ts bundle layer — applied automatically when a profile lists
 # this package in dsh.profile.bundles (dsh.bundle.patch declaration).
 - insert:
     - id: tool-bash-terminal
-      name: 'dsh-bash-terminal'
+      name: 'dsh-bash-terminal-ts'

package/dist/client.core.js

@@ -33,7 +33,7 @@ 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}";
 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.plugin = "dsh-bash-terminal-ts";
   tag.dataset.pluginCss = "bash-terminal-row";
   tag.textContent = ROW_CSS;
   document.head.appendChild(tag);

package/dist/client.js

@@ -1,5 +1,5 @@
 window.__ModuleLoader__.load({
-	id: "dsh-bash-terminal",
+	id: "dsh-bash-terminal-ts",
 	factory: (require) => {
 		var module = { exports: {} };
 		var exports = module.exports;
@@ -38,7 +38,7 @@ 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}";
 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.plugin = "dsh-bash-terminal-ts";
   tag.dataset.pluginCss = "bash-terminal-row";
   tag.textContent = ROW_CSS;
   document.head.appendChild(tag);

package/dsh.plugin.json

@@ -1,7 +1,7 @@
 {
-  "id": "dsh-bash-terminal",
-  "name": "dsh-bash-terminal",
-  "version": "0.5.1",
+  "id": "dsh-bash-terminal-ts",
+  "name": "dsh-bash-terminal-ts",
+  "version": "0.5.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 设置中选择。"

package/lib/client.js

@@ -1,5 +1,5 @@
 window.__ModuleLoader__.load({
-	id: "dsh-bash-terminal",
+	id: "dsh-bash-terminal-ts",
 	factory: (require) => {
 		var module = { exports: {} };
 		var exports = module.exports;
@@ -38,7 +38,7 @@ 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}";
 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.plugin = "dsh-bash-terminal-ts";
   tag.dataset.pluginCss = "bash-terminal-row";
   tag.textContent = ROW_CSS;
   document.head.appendChild(tag);

package/lib/dsh-types.d.ts

@@ -241,7 +241,7 @@ export interface ApprovalSeam {
     request(input: unknown): Promise<unknown>;
 }
 /**
- * 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/lib/dsh-types.js

@@ -1,9 +1,9 @@
-// Hand-written boundary types for the DSH seams this plugin consumes.
-//
-// The @deepseek-ai/* packages ship their own .d.ts, but their full generic
-// surface (cordis Context augmentation, agent/session graphs) is far wider
-// than what a plugin touches. These structural types describe exactly the
-// face this plugin programs against — call them the plugin's side of the
-// contract. Value imports stay on the real packages (see ./dsh.ts); only
-// the shapes live here, so peer version drift cannot ripple into this tree.
-export {};
+// Hand-written boundary types for the DSH seams this plugin consumes.
+//
+// The @deepseek-ai/* packages ship their own .d.ts, but their full generic
+// surface (cordis Context augmentation, agent/session graphs) is far wider
+// than what a plugin touches. These structural types describe exactly the
+// face this plugin programs against — call them the plugin's side of the
+// contract. Value imports stay on the real packages (see ./dsh.ts); only
+// the shapes live here, so peer version drift cannot ripple into this tree.
+export {};

package/lib/dsh.js

@@ -1,29 +1,29 @@
-// Value bridge to the @deepseek-ai/* peer packages.
-//
-// Peer packages ship their own .d.ts, but this plugin's contract with them is
-// a narrow, stable face (see ./dsh-types.ts). Every import passes through one
-// narrow cast here, so the plugin compiles against any 0.1.x peer whose
-// runtime behavior matches the face — no deep generic coupling, no version
-// drift leaking into the rewrite.
-import * as toolsNs from "@deepseek-ai/dsh-tools";
-import * as sandboxNs from "@deepseek-ai/dsh-sandbox";
-import { HarnessError } from "@deepseek-ai/dsh-llm";
-import { parseExitStatus } from "@deepseek-ai/dsh-shell";
-import { clampTimeout, deadline, timeoutOf } from "@deepseek-ai/dsh-timeout";
-import zDefault from "@deepseek-ai/schemastery";
-export { HarnessError, parseExitStatus, clampTimeout, deadline, timeoutOf };
-/** Wrap a fully specified tool spec into a registrable tool definition. */
-export const defineTool = toolsNs.defineTool;
-/** Sentinel code stamped on aborted tool calls. */
-export const TOOL_ABORTED = toolsNs.TOOL_ABORTED;
-/** Escalation modes advertised by the official sandbox seam. */
-export const ESCALATION_TARGETS = sandboxNs.ESCALATION_TARGETS;
-/** Official sandbox escalation (mirrors dsh-tool-bash / dsh-tool-pwsh). */
-export const approveEscalation = sandboxNs.approveEscalation;
-/** Fail-closed validation of the sandbox_permissions / justification pair. */
-export const validateEscalationArgs = sandboxNs.validateEscalationArgs;
-/** Marker appended to denied results so the UI can offer escalation. */
-export const sandboxDenialMarker = sandboxNs.sandboxDenialMarker;
-/** Marker appended to denied results pointing at the escalation affordance. */
-export const escalationHintMarker = sandboxNs.escalationHintMarker;
-export const z = zDefault;
+// Value bridge to the @deepseek-ai/* peer packages.
+//
+// Peer packages ship their own .d.ts, but this plugin's contract with them is
+// a narrow, stable face (see ./dsh-types.ts). Every import passes through one
+// narrow cast here, so the plugin compiles against any 0.1.x peer whose
+// runtime behavior matches the face — no deep generic coupling, no version
+// drift leaking into the rewrite.
+import * as toolsNs from "@deepseek-ai/dsh-tools";
+import * as sandboxNs from "@deepseek-ai/dsh-sandbox";
+import { HarnessError } from "@deepseek-ai/dsh-llm";
+import { parseExitStatus } from "@deepseek-ai/dsh-shell";
+import { clampTimeout, deadline, timeoutOf } from "@deepseek-ai/dsh-timeout";
+import zDefault from "@deepseek-ai/schemastery";
+export { HarnessError, parseExitStatus, clampTimeout, deadline, timeoutOf };
+/** Wrap a fully specified tool spec into a registrable tool definition. */
+export const defineTool = toolsNs.defineTool;
+/** Sentinel code stamped on aborted tool calls. */
+export const TOOL_ABORTED = toolsNs.TOOL_ABORTED;
+/** Escalation modes advertised by the official sandbox seam. */
+export const ESCALATION_TARGETS = sandboxNs.ESCALATION_TARGETS;
+/** Official sandbox escalation (mirrors dsh-tool-bash / dsh-tool-pwsh). */
+export const approveEscalation = sandboxNs.approveEscalation;
+/** Fail-closed validation of the sandbox_permissions / justification pair. */
+export const validateEscalationArgs = sandboxNs.validateEscalationArgs;
+/** Marker appended to denied results so the UI can offer escalation. */
+export const sandboxDenialMarker = sandboxNs.sandboxDenialMarker;
+/** Marker appended to denied results pointing at the escalation affordance. */
+export const escalationHintMarker = sandboxNs.escalationHintMarker;
+export const z = zDefault;

package/lib/index.js

@@ -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
@@ -251,7 +251,7 @@ function spawnSpec(resolved, argv, env, signal) {
 function collectedOutput(handle) {
     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 };
 }
@@ -292,7 +292,7 @@ async function runForeground(ctx, argv, resolved, env, signal, timeoutMs) {
 function requireSubprocess(ctx) {
     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;
 }
@@ -495,14 +495,14 @@ const BACKGROUND_OUTPUT_PROPERTIES = {
 // ---- plugin -------------------------------------------------------------------
 export function apply(ctx, config = {}) {
     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;
     const paths = resolveAllPaths(config);
     const defaultShell = config.defaultShell ?? DEFAULT_SHELL;
     if (!SHELLS.includes(defaultShell)) {
-        throw new Error(`dsh-bash-terminal: invalid defaultShell ${JSON.stringify(defaultShell)}`);
+        throw new Error(`dsh-bash-terminal-ts: invalid defaultShell ${JSON.stringify(defaultShell)}`);
     }
     const settingsScope = ctx.settings.register(SETTINGS_NAMESPACE, z.object({ defaultShell: z.union(SHELLS.map((s) => z.const(s))).default(defaultShell) }), { base: { defaultShell } });
     /** Official sandbox-escalation surface (mirrors tool-bash): advertise the
@@ -647,7 +647,7 @@ export function apply(ctx, config = {}) {
             const shell = settingsScope.get().defaultShell;
             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;

package/lib/terminal.d.ts

@@ -1,110 +1,110 @@
-import type { BashTerminalContext, ResolvedPaths, TerminalHandle } from "./dsh-types.js";
-declare const TERMINAL_SIGNALS: readonly ["SIGINT", "SIGTERM", "SIGKILL", "SIGTSTP", "SIGHUP"];
-export type TerminalSignal = (typeof TERMINAL_SIGNALS)[number];
-interface TerminalBufferRead {
-    delta: string;
-    nextOffset: number;
-    truncated: boolean;
-}
-interface TerminalBuffer {
-    append(chunk: string): void;
-    readFrom(offset: number): TerminalBufferRead;
-    snapshot(): string;
-    wasTruncated(): boolean;
-    lastAppendAt(): number;
-}
-/** Interactive-shell argv (no -c: the terminal itself is the session). */
-export declare function terminalArgv(shell: string, paths: ResolvedPaths, distro?: string): Array<string | undefined>;
-export interface TerminalSessionInfo {
-    sessionId: string;
-    shell: string;
-    pid: number;
-    closed: boolean;
-}
-interface TerminalSession {
-    id: string;
-    handle: TerminalHandle;
-    buffer: TerminalBuffer;
-    shell: string;
-    distro?: string;
-    closed: boolean;
-    idleMs: number;
-    idleTimer?: NodeJS.Timeout;
-    touch: () => void;
-}
-export interface TerminalOpenOptions {
-    argv: string[];
-    shell: string;
-    cwd: string;
-    env: Record<string, string | undefined>;
-    rows: number;
-    cols: number;
-    distro?: string;
-    initial?: string;
-    idleMs?: number;
-}
-export interface TerminalRegistry {
-    open(options: TerminalOpenOptions): Promise<TerminalSession>;
-    get(id: string): TerminalSession;
-    send(id: string, input: string): Promise<TerminalBufferRead>;
-    read(id: string): TerminalBufferRead;
-    signal(id: string, sig: string): Promise<TerminalBufferRead>;
-    close(id: string): Promise<boolean>;
-    list(): TerminalSessionInfo[];
-}
-/**
- * Terminal-session registry owned by the plugin fiber: opens PTYs through
- * the official seam, forwards output into a capped buffer, and tears every
- * session down on plugin disposal.
- */
-export declare function createTerminalRegistry(ctx: BashTerminalContext): TerminalRegistry;
-/** The terminal tool's arguments after runtime validation (discriminated by action). */
-export type ValidatedTerminalArgs = {
-    action: "open";
-    sessionId?: string;
-    command?: string;
-    distro?: string;
-    workdir?: string;
-    idleMs?: number;
-} | {
-    action: "send";
-    sessionId: string;
-    input: string;
-} | {
-    action: "read";
-    sessionId: string;
-} | {
-    action: "signal";
-    sessionId: string;
-    signal: TerminalSignal;
-} | {
-    action: "close";
-    sessionId: string;
-} | {
-    action: "list";
-};
-export declare function validateArgs(args: Record<string, unknown>): asserts args is ValidatedTerminalArgs;
-export interface TerminalOpenResult {
-    kind: "open";
-    sessionId: string;
-    jobId?: string;
-    pid: number;
-    shell: string;
-    output: string;
-}
-export interface TerminalSessionResult {
-    kind: "session";
-    output: string;
-    truncated?: boolean;
-}
-export interface TerminalClosedResult {
-    kind: "closed";
-    sessionId: string;
-}
-export interface TerminalListResult {
-    kind: "list";
-    sessions: TerminalSessionInfo[];
-}
-export type TerminalToolResult = TerminalOpenResult | TerminalSessionResult | TerminalClosedResult | TerminalListResult;
-export declare function terminalTool(ctx: BashTerminalContext, registry: TerminalRegistry, paths: ResolvedPaths, defaultShell: () => string): import("./dsh-types.js").ToolDefinition;
-export {};
+import type { BashTerminalContext, ResolvedPaths, TerminalHandle } from "./dsh-types.js";
+declare const TERMINAL_SIGNALS: readonly ["SIGINT", "SIGTERM", "SIGKILL", "SIGTSTP", "SIGHUP"];
+export type TerminalSignal = (typeof TERMINAL_SIGNALS)[number];
+interface TerminalBufferRead {
+    delta: string;
+    nextOffset: number;
+    truncated: boolean;
+}
+interface TerminalBuffer {
+    append(chunk: string): void;
+    readFrom(offset: number): TerminalBufferRead;
+    snapshot(): string;
+    wasTruncated(): boolean;
+    lastAppendAt(): number;
+}
+/** Interactive-shell argv (no -c: the terminal itself is the session). */
+export declare function terminalArgv(shell: string, paths: ResolvedPaths, distro?: string): Array<string | undefined>;
+export interface TerminalSessionInfo {
+    sessionId: string;
+    shell: string;
+    pid: number;
+    closed: boolean;
+}
+interface TerminalSession {
+    id: string;
+    handle: TerminalHandle;
+    buffer: TerminalBuffer;
+    shell: string;
+    distro?: string;
+    closed: boolean;
+    idleMs: number;
+    idleTimer?: NodeJS.Timeout;
+    touch: () => void;
+}
+export interface TerminalOpenOptions {
+    argv: string[];
+    shell: string;
+    cwd: string;
+    env: Record<string, string | undefined>;
+    rows: number;
+    cols: number;
+    distro?: string;
+    initial?: string;
+    idleMs?: number;
+}
+export interface TerminalRegistry {
+    open(options: TerminalOpenOptions): Promise<TerminalSession>;
+    get(id: string): TerminalSession;
+    send(id: string, input: string): Promise<TerminalBufferRead>;
+    read(id: string): TerminalBufferRead;
+    signal(id: string, sig: string): Promise<TerminalBufferRead>;
+    close(id: string): Promise<boolean>;
+    list(): TerminalSessionInfo[];
+}
+/**
+ * Terminal-session registry owned by the plugin fiber: opens PTYs through
+ * the official seam, forwards output into a capped buffer, and tears every
+ * session down on plugin disposal.
+ */
+export declare function createTerminalRegistry(ctx: BashTerminalContext): TerminalRegistry;
+/** The terminal tool's arguments after runtime validation (discriminated by action). */
+export type ValidatedTerminalArgs = {
+    action: "open";
+    sessionId?: string;
+    command?: string;
+    distro?: string;
+    workdir?: string;
+    idleMs?: number;
+} | {
+    action: "send";
+    sessionId: string;
+    input: string;
+} | {
+    action: "read";
+    sessionId: string;
+} | {
+    action: "signal";
+    sessionId: string;
+    signal: TerminalSignal;
+} | {
+    action: "close";
+    sessionId: string;
+} | {
+    action: "list";
+};
+export declare function validateArgs(args: Record<string, unknown>): asserts args is ValidatedTerminalArgs;
+export interface TerminalOpenResult {
+    kind: "open";
+    sessionId: string;
+    jobId?: string;
+    pid: number;
+    shell: string;
+    output: string;
+}
+export interface TerminalSessionResult {
+    kind: "session";
+    output: string;
+    truncated?: boolean;
+}
+export interface TerminalClosedResult {
+    kind: "closed";
+    sessionId: string;
+}
+export interface TerminalListResult {
+    kind: "list";
+    sessions: TerminalSessionInfo[];
+}
+export type TerminalToolResult = TerminalOpenResult | TerminalSessionResult | TerminalClosedResult | TerminalListResult;
+export declare function terminalTool(ctx: BashTerminalContext, registry: TerminalRegistry, paths: ResolvedPaths, defaultShell: () => string): import("./dsh-types.js").ToolDefinition;
+export {};