@deepseek-ai/dsh-tool-pwsh-persistent 0.1.2-rc.1 → 0.1.5-alpha.1

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
Files changed (4) hide show
  1. package/README.i18n.yaml +2 -2
  2. package/README.md +3 -3
  3. package/README.zh.md +3 -3
  4. package/package.json +20 -19
package/README.i18n.yaml CHANGED
@@ -2,5 +2,5 @@
2
2
  # side as of the last confirmed-consistent state. Both languages carry equal authority;
3
3
  # after editing either side, bring the other along and re-record with:
4
4
  # pnpm run verify-translation-pairing --write packages/shell/tool-pwsh-persistent/README.md
5
- README.md: 4865c7482d29369f65c2c41323f69a3145bb2536
6
- README.zh.md: 92826668173c5ba7a1588bba8ba13078937d3d9d
5
+ README.md: 6b347dfbf8745a7bc56e2c62a5040e873bc1d8e2
6
+ README.zh.md: e6317bb7088b6e1e753eda2074d83ff2f2948a60
package/README.md CHANGED
@@ -9,7 +9,7 @@ English | [中文](README.zh.md)
9
9
 
10
10
  ## Summary
11
11
 
12
- `dsh-tool-pwsh-persistent` gives the agent a `pwsh` tool whose PowerShell state persists across calls for the owning agent: cwd, `$env:` variables, functions, and background jobs survive between commands. It is the Windows counterpart of `dsh-tool-bash-persistent` — the same persistent-state contract in PowerShell dialect. Each agent gets its own shell backed by an owner-scoped PTY session with a pwsh-dialect backend, and commands for the same agent run one at a time. Configuration selects the backend and the wall-clock limit for one command; a timeout or an explicit `exit` closes the shell, and the next call starts fresh. Mount it with a pwsh-dialect terminal backend (Windows ConPTY or a POSIX pwsh) and the `ctx.terminals` service.
12
+ `dsh-tool-pwsh-persistent` gives each agent a `pwsh` tool that preserves its current directory, environment variables, functions, and background jobs across calls. Commands for one agent run sequentially, while different agents keep separate shell state. Choose it for multi-step PowerShell work; use `dsh-tool-pwsh` when every command should start clean, and use a terminal tool when commands require interactive stdin. Configure a pwsh-capable backend and per-command timeout; timeout or explicit `exit` discards the shell, so the next call starts fresh.
13
13
 
14
14
  ## Table of Contents
15
15
 
@@ -72,7 +72,7 @@ This section explains the design decisions behind the tool and points at the cod
72
72
 
73
73
  ### Design philosophy
74
74
 
75
- - **A deliberate twin of `dsh-tool-bash-persistent`.** The session registry, polling loop, and reset contract mirror the persistent bash tool by design ([pwsh persistent PTY Agent Note](../../../.agents/notes/implemented/architecture/2026-08-11-pwsh-persistent-pty.md)).
75
+ - **A deliberate twin of `dsh-tool-bash-persistent`.** The session registry, polling loop, and reset contract mirror the persistent bash tool by design ([pwsh persistent PTY Agent Note](../../../.agents/notes/archived/architecture/2026-08-11-pwsh-persistent-pty.md)).
76
76
  - **Prompt-function readiness.** The tool installs its own `prompt` function that prints a BEL-terminated OSC marker plus a printable prompt; the OSC marker carries the last exit code and the printable prompt settles every command, so a model redefinition of `prompt` degrades readiness to the silence tier.
77
77
  - **PSReadLine echo stripped by anchoring.** PowerShell renders submitted input back into the stream; the marker-anchored extraction and a wrapper-source strip remove the echo, and a wrapper that wraps across the terminal width may leave a partial echo in partial-output results.
78
78
  - **Reset, never repair.** Any uncertain state — an explicit `exit`, a timeout, a send failure, an abort — closes the shell and starts the next call fresh.
@@ -100,7 +100,7 @@ Read these pages when the package-level contract is not enough. They move from t
100
100
  - [terminal package map](../../terminal/README.md) — the persistent PTY capability family.
101
101
  - [terminal seam](../../terminal/terminal/README.md) — the `ctx.terminals` service behind the tool.
102
102
  - [terminal-bash backend](../../terminal/terminal-bash/README.md) — the default backend, configured with `shellDialect: pwsh`.
103
- - [pwsh persistent PTY Agent Note](../../../.agents/notes/implemented/architecture/2026-08-11-pwsh-persistent-pty.md) — the pwsh-side session design and its rationale.
103
+ - [pwsh persistent PTY Agent Note](../../../.agents/notes/archived/architecture/2026-08-11-pwsh-persistent-pty.md) — the pwsh-side session design and its rationale.
104
104
  - [Persistent PTY sessions Agent Note](../../../.agents/notes/implemented/feature/2026-07-16-persistent-pty-sessions.md) — the owner-scoped session design and its rationale.
105
105
  - [Generated tool catalog](../../../docs/tool-catalog.md#deepseek-aidsh-tool-pwsh-persistent) — the exact `pwsh` argument schema.
106
106
  - [Generated configuration catalog](../../../docs/config-catalog.md#deepseek-aidsh-tool-pwsh-persistent) — every accepted config field and its source declaration.
package/README.zh.md CHANGED
@@ -9,7 +9,7 @@ kind: "package-reference"
9
9
 
10
10
  ## 概述
11
11
 
12
- `dsh-tool-pwsh-persistent` 为 agent 提供 `pwsh` 工具，其 PowerShell 状态对拥有它的 agent 跨调用保留：cwd、`$env:` 变量、函数与后台任务都会在命令之间存活。它是 `dsh-tool-bash-persistent` 的 Windows 对应物——相同的持久状态契约，PowerShell 方言。每个 agent 都有自己由按所有者隔离、带 pwsh 方言后端的 PTY 会话支撑的 shell，同一 agent 的命令逐个串行执行。配置选择后端与单条命令的墙钟上限；超时或显式 `exit` 会关闭 shell，下一次调用从全新状态开始。请与 pwsh 方言 terminal 后端（Windows ConPTY 或 POSIX pwsh）以及 `ctx.terminals` 服务一起挂载。
12
+ `dsh-tool-pwsh-persistent` 为每个 agent 提供 `pwsh` 工具，跨调用保留其当前目录、环境变量、函数与后台任务。同一 agent 的命令串行运行，不同 agent 维护相互隔离的 shell 状态。多步 PowerShell 工作应选择本包；若每条命令都应从干净状态开始，请使用 `dsh-tool-pwsh`，需要交互 stdin 时则使用 terminal 工具。请配置支持 pwsh 的后端和单条命令超时；超时或显式 `exit` 会丢弃 shell，因此下次调用从全新状态开始。
13
13
 
14
14
  ## 目录
15
15
 
@@ -72,7 +72,7 @@ kind: "package-reference"
72
72
 
73
73
  ### 设计理念
74
74
 
75
- - **`dsh-tool-bash-persistent` 的刻意孪生。** 会话注册表、轮询循环与重置约定按设计镜像持久 bash 工具（[pwsh 持久 PTY Agent Note](../../../.agents/notes/implemented/architecture/2026-08-11-pwsh-persistent-pty.zh.md)）。
75
+ - **`dsh-tool-bash-persistent` 的刻意孪生。** 会话注册表、轮询循环与重置约定按设计镜像持久 bash 工具（[pwsh 持久 PTY Agent Note](../../../.agents/notes/archived/architecture/2026-08-11-pwsh-persistent-pty.md)）。
76
76
  - **prompt 函数就绪。** 工具安装自己的 `prompt` 函数，打印 BEL 结尾的 OSC 标记加可打印提示词；OSC 标记携带最后的退出码，可打印提示词让每条命令都能结算，因此模型重定义 `prompt` 会把就绪降级到静默层级。
77
77
  - **PSReadLine 回显靠锚定剥离。** PowerShell 会把提交的输入渲染回流中；标记锚定提取与包装源码剥离移除回显，而跨终端宽度换行的包装可能在部分输出结果中留下部分回显。
78
78
  - **重置，而非修复。** 任何不确定状态——显式 `exit`、超时、发送失败、中止——都会关闭 shell 并让下一次调用从全新状态开始。
@@ -100,7 +100,7 @@ kind: "package-reference"
100
100
  - [terminal 包映射](../../terminal/README.zh.md)——持久 PTY 能力家族。
101
101
  - [terminal seam](../../terminal/terminal/README.zh.md)——工具背后的 `ctx.terminals` 服务。
102
102
  - [terminal-bash 后端](../../terminal/terminal-bash/README.zh.md)——默认后端，配置 `shellDialect: pwsh`。
103
- - [pwsh 持久 PTY Agent Note](../../../.agents/notes/implemented/architecture/2026-08-11-pwsh-persistent-pty.zh.md)——pwsh 侧会话设计及其理由。
103
+ - [pwsh 持久 PTY Agent Note](../../../.agents/notes/archived/architecture/2026-08-11-pwsh-persistent-pty.md)——pwsh 侧会话设计及其理由。
104
104
  - [持久 PTY 会话 Agent Note](../../../.agents/notes/implemented/feature/2026-07-16-persistent-pty-sessions.zh.md)——按所有者会话的设计及其理由。
105
105
  - [生成的工具目录](../../../docs/tool-catalog.zh.md#deepseek-aidsh-tool-pwsh-persistent)——`pwsh` 参数 schema 的确切内容。
106
106
  - [生成的配置目录](../../../docs/config-catalog.zh.md#deepseek-aidsh-tool-pwsh-persistent)——每个受支持配置字段及其源声明。
package/package.json CHANGED
@@ -1,7 +1,7 @@
1
1
  {
2
2
  "name": "@deepseek-ai/dsh-tool-pwsh-persistent",
3
3
  "description": "Model-facing owner-scoped persistent PowerShell tool backed by the Harness PTY service",
4
- "version": "0.1.2-rc.1",
4
+ "version": "0.1.5-alpha.1",
5
5
  "publishConfig": {
6
6
  "access": "public"
7
7
  },
@@ -26,10 +26,10 @@
26
26
  ],
27
27
  "license": "MIT",
28
28
  "peerDependencies": {
29
- "@deepseek-ai/dsh-agent": "^0.1.2-rc.1",
30
- "@deepseek-ai/dsh-terminal": "^0.1.2-rc.1",
31
- "@deepseek-ai/dsh-timeout": "^0.1.2-rc.1",
32
- "@deepseek-ai/dsh-tools": "^0.1.2-rc.1",
29
+ "@deepseek-ai/dsh-agent": "^0.1.5-alpha.1",
30
+ "@deepseek-ai/dsh-terminal": "^0.1.5-alpha.1",
31
+ "@deepseek-ai/dsh-timeout": "^0.1.5-alpha.1",
32
+ "@deepseek-ai/dsh-tools": "^0.1.5-alpha.1",
33
33
  "@deepseek-ai/cordis": "^4.0.2"
34
34
  },
35
35
  "dependencies": {
@@ -38,19 +38,20 @@
38
38
  "devDependencies": {
39
39
  "@deepseek-ai/cordis-plugin-include": "^1.0.7",
40
40
  "@deepseek-ai/cordis-plugin-loader": "^1.0.3",
41
- "@deepseek-ai/dsh-agent": "^0.1.2-rc.1",
42
- "@deepseek-ai/dsh-llm": "^0.1.2-rc.1",
43
- "@deepseek-ai/dsh-terminal": "^0.1.2-rc.1",
44
- "@deepseek-ai/dsh-terminal-bash": "^0.1.2-rc.1",
45
- "@deepseek-ai/dsh-pwsh-local": "^0.1.2-rc.1",
46
- "@deepseek-ai/dsh-session": "^0.1.2-rc.1",
47
- "@deepseek-ai/dsh-session-projection": "^0.1.2-rc.1",
48
- "@deepseek-ai/dsh-subprocess-local": "^0.1.2-rc.1",
49
- "@deepseek-ai/dsh-system-prompt": "^0.1.2-rc.1",
50
- "@deepseek-ai/dsh-timeout": "^0.1.2-rc.1",
51
- "@deepseek-ai/dsh-tools": "^0.1.2-rc.1",
52
- "@deepseek-ai/cordis": "^4.0.2",
53
- "@deepseek-ai/dsh-sandbox": "^0.1.2-rc.1",
54
- "@deepseek-ai/dsh-sandbox-policy": "^0.1.2-rc.1"
41
+ "@deepseek-ai/dsh-agent": "^0.1.5-alpha.1",
42
+ "@deepseek-ai/dsh-llm": "^0.1.5-alpha.1",
43
+ "@deepseek-ai/dsh-agent-loop-testkit": "^0.1.5-alpha.1",
44
+ "@deepseek-ai/dsh-terminal-bash": "^0.1.5-alpha.1",
45
+ "@deepseek-ai/dsh-pwsh-local": "^0.1.5-alpha.1",
46
+ "@deepseek-ai/dsh-sandbox": "^0.1.5-alpha.1",
47
+ "@deepseek-ai/dsh-terminal": "^0.1.5-alpha.1",
48
+ "@deepseek-ai/dsh-sandbox-policy": "^0.1.5-alpha.1",
49
+ "@deepseek-ai/dsh-session": "^0.1.5-alpha.1",
50
+ "@deepseek-ai/dsh-session-projection": "^0.1.5-alpha.1",
51
+ "@deepseek-ai/dsh-subprocess-local": "^0.1.5-alpha.1",
52
+ "@deepseek-ai/dsh-system-prompt": "^0.1.5-alpha.1",
53
+ "@deepseek-ai/dsh-timeout": "^0.1.5-alpha.1",
54
+ "@deepseek-ai/dsh-tools": "^0.1.5-alpha.1",
55
+ "@deepseek-ai/cordis": "^4.0.2"
55
56
  }
56
57
  }