better-dsh 0.3.4-c → 0.3.4-d

package/lib/remote/plugin.js

@@ -4851,7 +4851,7 @@ const NO_SESSION_KEY$1 = "remote:no-session";
 * interact-able stdin / managed output / persistent env——回执形状与 oneshot 相同、只增状态，
 * 运行中的命令可分步观察后再补输（input 动作）；多步与交互任务默认进 PTY。
 */
-const REMOTE_TOOL_DESCRIPTION = `Remote shell (SSH, Docker, Incus, Hub): 1 default interactive PTY per machine (retains cwd/env). \`mode:"oneshot"\` = isolated, stateless.
+const REMOTE_TOOL_DESCRIPTION = `Remote shell (SSH, Docker, Incus, Hub): Default PTY, stateful one-shot, persistent cwd/env, interactive stdin, managed bounded terminal output, exact exit/cwd/env-delta receipts, both stdout/stderr in output. \`mode:"oneshot"\` = isolated, stateless.
 
 Actions:
 - exec {target, cmd? | scriptPath?, stdin?, mode?:"pty"|"oneshot"="pty", timeout?, run_in_background?:boolean, commandId?:string}: run command / script / raw stdin write. Machine target = default PTY. PTY \`stdin\` alone = raw write into running command (optional \`commandId\` guard). \`run_in_background:true\` = async job, returns handle instantly, PTY handed off automatically.
@@ -4868,11 +4868,26 @@ Targets & Semantics:
 - Stdin: oneshot = \`fd0 → pipe\`; PTY = \`fd0 → pty slave\`, line disciplines. Literal bytes (\`\\n\`, \`\\u0003\` = Ctrl-C, \`\\u0004\` = Ctrl-D). Retention: 4M chars/stream (Hub oneshot 4MiB).
 
 Examples:
-remote {"action":"exec","target":"ssh:dev4","cmd":"cd /srv/app && pwd"}
+Examples:
+
+# Repeated exploratory work: PTY.
+remote {"action":"exec","target":"ssh:dev4","cmd":"cd /srv/app && export STAGE=dev && pwd"}
+/srv/app
+[pty:pty-irsq · conn ssh:dev4 · cmd remote-a1 · cwd /srv/app · env +STAGE · idle-left ~15m · exit 0 · 0.1s]
+
+# cwd/env survive; PTY presents stdout and stderr together, followed by the exact exit receipt.
+remote {"action":"exec","target":"ssh:dev4","cmd":"printf 'stage=%s\\\\n' \\"$STAGE\\"; printf 'bad config\\\\n' >&2; exit 23"}
+stage=dev
+bad config
+[pty:pty-irsq · conn ssh:dev4 · cmd remote-a2 · cwd /srv/app · idle-left ~15m · exit 23 · 0.1s]
+
 remote {"action":"exec","target":"ssh:dev4","cmd":"make test","run_in_background":true}
 remote {"action":"handoff","target":"ssh:dev4"}
 remote {"action":"exec","target":"pty:pty-irsq","stdin":"yes\\n","commandId":"remote-47676dff2c6443e8"}
+
+# Use oneshot only when isolation is intentional.
 remote {"action":"exec","target":"ssh:dev4","mode":"oneshot","cmd":"uname -a"}
+
 remote {"action":"add","spawn":"ssh -t pc ssh -t dev4","target":"pty:dev4via"}
 remote {"action":"exec","target":"pty:dev4via","cmd":"hostname"}
 remote {"action":"add","ssh":{"host":"10.0.0.8","user":"u1","port":22,"key":"~/.ssh/id_key4"},"target":"ssh:lab"}

package/lib/url-schemes/index.d.ts

@@ -1,6 +1,6 @@
 import { Context } from "@deepseek-ai/cordis";
 import { ToolDefinition } from "@deepseek-ai/dsh-tools";
-import * as _deepseek_ai_schemastery17 from "@deepseek-ai/schemastery";
+import * as _deepseek_ai_schemastery11 from "@deepseek-ai/schemastery";
 
 //#region src/url-schemes/tools/write.d.ts
 
@@ -50,12 +50,12 @@ declare const inject: string[];
  * real patch-line config. Schema-level defaults (both ON — the service is
  * opt-out) survive every overlay layer, per the v0.2.2a ruling.
  */
-declare const Config: _deepseek_ai_schemastery17.default<Schemastery.ObjectS<NoInfer<{
-  urlSchemes: _deepseek_ai_schemastery17.default<boolean, boolean, "defined">;
-  hashline: _deepseek_ai_schemastery17.default<boolean, boolean, "defined">;
+declare const Config: _deepseek_ai_schemastery11.default<Schemastery.ObjectS<NoInfer<{
+  urlSchemes: _deepseek_ai_schemastery11.default<boolean, boolean, "defined">;
+  hashline: _deepseek_ai_schemastery11.default<boolean, boolean, "defined">;
 }>>, Schemastery.ObjectT<NoInfer<{
-  urlSchemes: _deepseek_ai_schemastery17.default<boolean, boolean, "defined">;
-  hashline: _deepseek_ai_schemastery17.default<boolean, boolean, "defined">;
+  urlSchemes: _deepseek_ai_schemastery11.default<boolean, boolean, "defined">;
+  hashline: _deepseek_ai_schemastery11.default<boolean, boolean, "defined">;
 }>>, "plain">;
 /** Register the four URL-aware tools on one agent's own scope layer. */
 /**
@@ -75,12 +75,12 @@ declare function apply(ctx: Context, config: UrlSchemesConfig | undefined): void
 declare const _default: {
   name: string;
   inject: string[];
-  Config: _deepseek_ai_schemastery17.default<Schemastery.ObjectS<NoInfer<{
-    urlSchemes: _deepseek_ai_schemastery17.default<boolean, boolean, "defined">;
-    hashline: _deepseek_ai_schemastery17.default<boolean, boolean, "defined">;
+  Config: _deepseek_ai_schemastery11.default<Schemastery.ObjectS<NoInfer<{
+    urlSchemes: _deepseek_ai_schemastery11.default<boolean, boolean, "defined">;
+    hashline: _deepseek_ai_schemastery11.default<boolean, boolean, "defined">;
   }>>, Schemastery.ObjectT<NoInfer<{
-    urlSchemes: _deepseek_ai_schemastery17.default<boolean, boolean, "defined">;
-    hashline: _deepseek_ai_schemastery17.default<boolean, boolean, "defined">;
+    urlSchemes: _deepseek_ai_schemastery11.default<boolean, boolean, "defined">;
+    hashline: _deepseek_ai_schemastery11.default<boolean, boolean, "defined">;
   }>>, "plain">;
   apply: typeof apply;
 };

package/lib/web-password.d.ts

@@ -1,7 +1,7 @@
 import { Context } from "@deepseek-ai/cordis";
 import { IncomingMessage } from "node:http";
 import { CredentialRecord } from "@deepseek-ai/dsh-credentials";
-import * as _deepseek_ai_schemastery11 from "@deepseek-ai/schemastery";
+import * as _deepseek_ai_schemastery21 from "@deepseek-ai/schemastery";
 
 //#region src/web-password.d.ts
 
@@ -123,10 +123,10 @@ interface WebPasswordConfig {
   /** Absolute browser-session lifetime in days. Default: 30 (the native default). */
   cookieMaxAgeDays?: number;
 }
-declare const Config: _deepseek_ai_schemastery11.default<Schemastery.ObjectS<NoInfer<{
-  cookieMaxAgeDays: _deepseek_ai_schemastery11.default<number, number, "defined">;
+declare const Config: _deepseek_ai_schemastery21.default<Schemastery.ObjectS<NoInfer<{
+  cookieMaxAgeDays: _deepseek_ai_schemastery21.default<number, number, "defined">;
 }>>, Schemastery.ObjectT<NoInfer<{
-  cookieMaxAgeDays: _deepseek_ai_schemastery11.default<number, number, "defined">;
+  cookieMaxAgeDays: _deepseek_ai_schemastery21.default<number, number, "defined">;
 }>>, "plain">;
 /** Cordis plugin name; also the scope of this row's credential record. */
 declare const name = "dashr-web-password";
@@ -145,10 +145,10 @@ declare function apply(ctx: Context, config?: WebPasswordConfig): void;
 declare const _default: {
   name: string;
   inject: string[];
-  Config: _deepseek_ai_schemastery11.default<Schemastery.ObjectS<NoInfer<{
-    cookieMaxAgeDays: _deepseek_ai_schemastery11.default<number, number, "defined">;
+  Config: _deepseek_ai_schemastery21.default<Schemastery.ObjectS<NoInfer<{
+    cookieMaxAgeDays: _deepseek_ai_schemastery21.default<number, number, "defined">;
   }>>, Schemastery.ObjectT<NoInfer<{
-    cookieMaxAgeDays: _deepseek_ai_schemastery11.default<number, number, "defined">;
+    cookieMaxAgeDays: _deepseek_ai_schemastery21.default<number, number, "defined">;
   }>>, "plain">;
   apply: typeof apply;
 };

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "better-dsh",
-  "version": "0.3.4-c",
+  "version": "0.3.4-d",
   "description": "Make your dsh ready for serious coding tasks. (Tools x Schemas)^REPL. `skill://`, `ctx://`, `agent://`, `dvc://`, `dsh://`, Python REPL, Context as Variables, cross compactions recallable, full context revive. `hash-edit`, `dvc://browser`, subagent as function, workflow as function.",
   "type": "module",
   "main": "lib/index.js",