@deepseek-ai/dsh-terminal-bash 0.1.7-rc.2 → 0.2.0-rc.1

package/README.i18n.yaml

@@ -24,11 +24,11 @@
   en: 71449ef1985b2f1b
   zh: 562e9b5ef73cd5e1
 /deepseek-ai-dsh-terminal-bash/use-this-package/configuration:
-  en: 229375735e02e80a
-  zh: 347c617ae312643a
+  en: 2a10fc681cee698d
+  zh: ac60c8918bae3c85
 /deepseek-ai-dsh-terminal-bash/use-this-package/shell-dialects-and-readiness:
-  en: bab340c3347f1794
-  zh: a4c32b651fea000d
+  en: 2cab01d85f524e3d
+  zh: 0d00b3e399a935b1
 /deepseek-ai-dsh-terminal-bash/use-this-package/sandboxing-and-safe-operation:
   en: 39e0f0b429b024a7
   zh: 440171193664d13b

package/README.md

@@ -57,11 +57,11 @@ Mount the terminal service, a subprocess provider, the sandbox and policy servic
 | `timeoutMs` | `30000` | Absolute bound on one send wait |
 | `disposeGraceMs` | `3000` | Grace before teardown escalates to `SIGKILL` |
 
-The generated [configuration catalog](../../../docs/config-catalog.md#deepseek-aidsh-terminal-bash) is the exhaustive source for every field, including the readiness timings (`pollIntervalMs`, `exactProbeAfterMs`, `idleSilenceMs`, `handoffGraceMs`), terminal size (`rows`, `cols`), and scrollback bounds (`scrollbackLines`, `scrollbackMaxBytes`).
+The generated [configuration catalog](../../../docs/config-catalog.md#deepseek-aidsh-terminal-bash) is the exhaustive source for every field, including the readiness timings (`pollIntervalMs`, `exactProbeAfterMs`, `idleSilenceMs`, `handoffGraceMs`, `promptTailGraceMs`), terminal size (`rows`, `cols`), and scrollback bounds (`scrollbackLines`, `scrollbackMaxBytes`).
 
 ### Shell dialects and readiness
 
-Both dialects expose the same readiness contract, so consumers are dialect-agnostic. A send settles when the shell is ready again: after the controlled prompt is verified, after the foreground process group provably waits on stdin (Linux), after output silence (`inferred_idle`), or at the absolute `timeoutMs`. An `inferred_idle` or `timeout` result does not prove the foreground command exited.
+Both dialects expose the same readiness contract, so consumers are dialect-agnostic. A send settles when the shell is ready again: after the controlled prompt is verified, after the foreground process group provably waits on stdin (Linux), after output silence (`inferred_idle`), or at the absolute `timeoutMs`. A prompt marker whose printable tail has not arrived yet holds the send on the exact path for `promptTailGraceMs` beyond `idleSilenceMs + handoffGraceMs`, because the marker and its tail are written by the same prompt render. An `inferred_idle` or `timeout` result does not prove the foreground command exited.
 
 ### Sandboxing and safe operation
 

package/README.zh.md

@@ -57,11 +57,11 @@ kind: "package-reference"
 | `timeoutMs` | `30000` | 一次发送等待的绝对上限 |
 | `disposeGraceMs` | `3000` | 清理升级到 `SIGKILL` 前的宽限时间 |
 
-生成的[配置目录](../../../docs/config-catalog.zh.md#deepseek-aidsh-terminal-bash)是每个字段的穷尽式真源，包括就绪计时（`pollIntervalMs`、`exactProbeAfterMs`、`idleSilenceMs`、`handoffGraceMs`）、终端尺寸（`rows`、`cols`）与 scrollback 上限（`scrollbackLines`、`scrollbackMaxBytes`）。
+生成的[配置目录](../../../docs/config-catalog.zh.md#deepseek-aidsh-terminal-bash)是每个字段的穷尽式真源，包括就绪计时（`pollIntervalMs`、`exactProbeAfterMs`、`idleSilenceMs`、`handoffGraceMs`、`promptTailGraceMs`）、终端尺寸（`rows`、`cols`）与 scrollback 上限（`scrollbackLines`、`scrollbackMaxBytes`）。
 
 ### shell 方言与就绪
 
-两种方言暴露相同的就绪约定，因此消费方与方言无关。当 shell 再次就绪时发送即结算：受控提示符被验证之后、前台进程组被证明在等待 stdin（Linux）之后、输出静默（`inferred_idle`）之后，或到达绝对 `timeoutMs`。`inferred_idle` 或 `timeout` 结果并不证明前台命令已退出。
+两种方言暴露相同的就绪约定，因此消费方与方言无关。当 shell 再次就绪时发送即结算：受控提示符被验证之后、前台进程组被证明在等待 stdin（Linux）之后、输出静默（`inferred_idle`）之后，或到达绝对 `timeoutMs`。若提示符标记已到达而其可打印尾部尚未到达，send 会在 `idleSilenceMs + handoffGraceMs` 之外继续等待 `promptTailGraceMs`，因为标记与尾部由同一次提示符渲染写出。`inferred_idle` 或 `timeout` 结果并不证明前台命令已退出。
 
 ### 沙箱与安全运行
 

package/lib/index.js

@@ -48,11 +48,14 @@ const Config = z.object({
 	exactProbeAfterMs: z.number().default(150),
 	idleSilenceMs: z.number().default(3e3),
 	handoffGraceMs: z.number().default(500),
+	promptTailGraceMs: z.number().default(0),
 	timeoutMs: z.number().default(3e4),
 	disposeGraceMs: z.number().default(3e3)
 });
 /**
-* Assert every effective numeric config field is a positive safe integer and bounds compose.
+* Assert every effective numeric config field is a positive safe integer — except
+* `promptTailGraceMs`, whose zero is the documented "no extension" value — and that bounds
+* compose.
 * @param config - Schemastery-resolved plugin configuration.
 * @returns Narrows the input to the fully resolved configuration.
 */
@@ -60,9 +63,14 @@ function validateConfig(config) {
 	const resolved = config;
 	if (resolved.backendType.length === 0) throw new Error("terminal-bash: backendType must be non-empty");
 	if (resolved.shellPath.length === 0) throw new Error("terminal-bash: shellPath must be non-empty");
-	for (const [name, value] of Object.entries(resolved)) if (typeof value === "number" && (!Number.isSafeInteger(value) || value <= 0)) throw new Error(`terminal-bash: ${name} must be a positive safe integer`);
+	for (const [name, value] of Object.entries(resolved)) {
+		if (name === "promptTailGraceMs") continue;
+		if (typeof value === "number" && (!Number.isSafeInteger(value) || value <= 0)) throw new Error(`terminal-bash: ${name} must be a positive safe integer`);
+	}
+	if (typeof resolved.promptTailGraceMs === "number" && (!Number.isSafeInteger(resolved.promptTailGraceMs) || resolved.promptTailGraceMs < 0)) throw new Error("terminal-bash: promptTailGraceMs must be a non-negative safe integer");
 	if (resolved.maxReadBytes > resolved.scrollbackMaxBytes) throw new Error("terminal-bash: maxReadBytes must not exceed scrollbackMaxBytes");
 	if (resolved.handoffGraceMs < resolved.pollIntervalMs) throw new Error("terminal-bash: handoffGraceMs must be at least pollIntervalMs so one readiness poll runs inside the grace window");
+	if (resolved.promptTailGraceMs !== 0 && resolved.promptTailGraceMs < resolved.pollIntervalMs) throw new Error("terminal-bash: promptTailGraceMs must be zero or at least pollIntervalMs so a nonzero tolerance contains one readiness poll");
 }
 /** Exact printable prompt emitted after the private marker. */
 const CONTROLLED_PROMPT = "dsh> ";
@@ -714,7 +722,8 @@ var LocalPtySession = class {
 				return;
 			}
 			const handoffGrace = this.promptSeen ? this.config.handoffGraceMs : 0;
-			if (startupHasOutput && idleFor >= this.config.idleSilenceMs + handoffGrace) this.settleActive("inferred_idle");
+			const tailGrace = this.promptSeen && !this.promptTextSeen && "dsh> ".startsWith(this.promptTail) ? this.config.promptTailGraceMs : 0;
+			if (startupHasOutput && idleFor >= this.config.idleSilenceMs + handoffGrace + tailGrace) this.settleActive("inferred_idle");
 		} catch (error) {
 			if (this.protocolWorkPending()) await this.drainTerminalProtocol();
 			if (this.active === operation && !this.closing && this.interrupting !== operation) this.failActive(error);

package/lib/types/config.d.ts

@@ -33,6 +33,15 @@ export interface Config {
      * regain the foreground before `inferred_idle` settles; at least one `pollIntervalMs`.
      */
     handoffGraceMs?: number;
+    /**
+     * Extra wait beyond `idleSilenceMs` and `handoffGraceMs`, once a prompt marker was seen but
+     * its printable tail has not arrived, before `inferred_idle` settles. The marker is written
+     * by the shell's own prompt function and the tail by the same render, so a missing tail is a
+     * delivery delay on a contended host rather than an absent prompt. Zero keeps the bound at
+     * `idleSilenceMs + handoffGraceMs`; any other value covers at least one `pollIntervalMs`, so a
+     * nonzero tolerance always contains a readiness poll.
+     */
+    promptTailGraceMs?: number;
     /** Absolute bound for one send and the complete pwsh startup sequence. */
     timeoutMs?: number;
     /** Grace before teardown escalates to `SIGKILL`. */
@@ -63,7 +72,9 @@ export declare function resolveConfig(config: Config): ResolvedConfig;
 /** Schemastery config exposed by the plugin. */
 export declare const Config: z<Config>;
 /**
- * Assert every effective numeric config field is a positive safe integer and bounds compose.
+ * Assert every effective numeric config field is a positive safe integer — except
+ * `promptTailGraceMs`, whose zero is the documented "no extension" value — and that bounds
+ * compose.
  * @param config - Schemastery-resolved plugin configuration.
  * @returns Narrows the input to the fully resolved configuration.
  */

package/package.json

@@ -1,7 +1,7 @@
 {
   "name": "@deepseek-ai/dsh-terminal-bash",
   "description": "Persistent shell PTY backend over the DeepSeek Harness subprocess terminal primitive",
-  "version": "0.1.7-rc.2",
+  "version": "0.2.0-rc.1",
   "publishConfig": {
     "access": "public"
   },
@@ -27,30 +27,30 @@
   ],
   "license": "MIT",
   "peerDependencies": {
-    "@deepseek-ai/dsh-agent": "0.1.7-rc.2",
-    "@deepseek-ai/dsh-terminal": "0.1.7-rc.2",
-    "@deepseek-ai/dsh-sandbox": "0.1.7-rc.2",
-    "@deepseek-ai/dsh-sandbox-policy": "0.1.7-rc.2",
-    "@deepseek-ai/dsh-session": "0.1.7-rc.2",
-    "@deepseek-ai/dsh-subprocess": "0.1.7-rc.2",
-    "@deepseek-ai/cordis": "~4.0.4",
-    "@deepseek-ai/dsh-session-projection": "0.1.7-rc.2"
+    "@deepseek-ai/dsh-agent": "0.2.0-rc.1",
+    "@deepseek-ai/dsh-terminal": "0.2.0-rc.1",
+    "@deepseek-ai/dsh-sandbox": "0.2.0-rc.1",
+    "@deepseek-ai/dsh-sandbox-policy": "0.2.0-rc.1",
+    "@deepseek-ai/dsh-session": "0.2.0-rc.1",
+    "@deepseek-ai/dsh-subprocess": "0.2.0-rc.1",
+    "@deepseek-ai/dsh-session-projection": "0.2.0-rc.1",
+    "@deepseek-ai/cordis": "~4.0.4"
   },
   "dependencies": {
     "@xterm/headless": "^6.0.0",
-    "@deepseek-ai/dsh-lazy-require": "0.1.7-rc.2",
-    "@deepseek-ai/dsh-pwsh-local": "0.1.7-rc.2",
+    "@deepseek-ai/dsh-lazy-require": "0.2.0-rc.1",
+    "@deepseek-ai/dsh-pwsh-local": "0.2.0-rc.1",
     "@deepseek-ai/schemastery": "~3.18.4"
   },
   "devDependencies": {
-    "@deepseek-ai/dsh-agent": "0.1.7-rc.2",
-    "@deepseek-ai/dsh-agent-loop-testkit": "0.1.7-rc.2",
-    "@deepseek-ai/dsh-terminal": "0.1.7-rc.2",
-    "@deepseek-ai/dsh-sandbox-policy": "0.1.7-rc.2",
-    "@deepseek-ai/dsh-session": "0.1.7-rc.2",
-    "@deepseek-ai/dsh-sandbox": "0.1.7-rc.2",
-    "@deepseek-ai/dsh-subprocess": "0.1.7-rc.2",
-    "@deepseek-ai/dsh-subprocess-local": "0.1.7-rc.2",
+    "@deepseek-ai/dsh-agent": "0.2.0-rc.1",
+    "@deepseek-ai/dsh-terminal": "0.2.0-rc.1",
+    "@deepseek-ai/dsh-agent-loop-testkit": "0.2.0-rc.1",
+    "@deepseek-ai/dsh-sandbox": "0.2.0-rc.1",
+    "@deepseek-ai/dsh-sandbox-policy": "0.2.0-rc.1",
+    "@deepseek-ai/dsh-session": "0.2.0-rc.1",
+    "@deepseek-ai/dsh-subprocess-local": "0.2.0-rc.1",
+    "@deepseek-ai/dsh-subprocess": "0.2.0-rc.1",
     "@deepseek-ai/cordis": "~4.0.4"
   }
 }