@deepseek-ai/dsh-tool-ralph 0.1.5-rc.2 → 0.1.6-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 +9 -9
  4. package/package.json +21 -21
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/workflow/tool-ralph/README.md
5
- README.md: c32a04258f6ef399f2346fad0b11cc7417a209aa
6
- README.zh.md: 5e5ddd2ef94d9622ea0e5428797201fbccfde383
5
+ README.md: d94d3a6ca9b74e65a386b3ca43c8dd34ce8781a0
6
+ README.zh.md: bb7b3bd81d1b72a501a687dc92e5f2ce49ac7969
package/README.md CHANGED
@@ -44,7 +44,7 @@ Each child receives only the immutable objective, its current round and cap, a s
44
44
  | `maxHandoffChars` | `16384` | Maximum serialized characters in one round report. |
45
45
  | `maxResultChars` | `16384` | Maximum characters in the complete successful parent result. |
46
46
 
47
- The generated [configuration catalog](../../../docs/config-catalog.md#deepseek-aidsh-tool-ralph) is the exhaustive source for every accepted field. The configured provider must exist, support structured output, and report `inheritsParentContext: false`; a call against a provider that violates this fails loud before any round starts.
47
+ The generated [configuration catalog](../../../docs/config-catalog.md#deepseek-aidsh-tool-ralph) is the exhaustive source for every accepted field. The configured provider must exist, support structured output, and report `inheritsParentContext: false`; a call against a provider that violates this fails loudly before any round starts.
48
48
 
49
49
  -----
50
50
 
@@ -70,7 +70,7 @@ Status-specific semantics and the serialized `maxHandoffChars` ceiling are valid
70
70
 
71
71
  ### Lifecycle and cancellation
72
72
 
73
- The caller's agent is the parent of every fresh child, preserving cwd and lineage without copying its conversation. `exec.signal` enters the workflow engine and is also bridged to `run.cancel()` for implementation independence. The tool awaits `run.result` and calls `run.dispose()` in `finally`, so a cancelled parent step waits for the engine's bounded termination and child quiescence before returning.
73
+ The caller's agent is the parent of every fresh child, preserving cwd and lineage without copying its conversation. `exec.signal` enters the workflow engine and is also bridged to `run.cancel()` for implementation independence. The tool awaits `run.result` and calls `run.dispose()` in `finally`, so a cancelled parent step waits for process and child cleanup before returning. The PTC engine sets no overall workflow elapsed deadline; caller cancellation still applies.
74
74
 
75
75
  ### Render intent
76
76
 
@@ -94,7 +94,7 @@ Read these pages when the tool-level contract is not enough. They move from the
94
94
 
95
95
  - [Workflow subsystem](../../../docs/subsystems/workflow.md) — the seam contract behind the fixed loop.
96
96
  - [Workflow seam](../workflow/README.md) — the run and result vocabulary.
97
- - [Worker-thread engine](../workflow-worker-thread/README.md) — the engine that executes the fixed script.
97
+ - [PTC workflow engine](../workflow-ptc/README.md) — the engine that executes the fixed script.
98
98
  - [subagent seam](../../subagent/subagent/README.md) — the fresh-child provider contract.
99
99
  - [Goal group](../../goal/goal/README.md) — same-session goal tools for ordinary long-running objectives.
100
100
  - [Harness-level goal-based execution Agent Note](../../../.agents/notes/implemented/feature/2026-07-16-harness-level-loop.md) — the policy, provider requirements, and deferred work.
package/README.zh.md CHANGED
@@ -1,5 +1,5 @@
1
1
  ---
2
- description: "面向模型的 ralph 工具：面向一个不可变目标的固定前台全新 agent 循环，供选择或配置全新 agent 迭代的用户与维护者阅读。"
2
+ description: "面向模型的 ralph 工具：固定前台 agent loop（智能体循环），让全新 agent 围绕一个不可变目标迭代，供选择或配置此类迭代的用户与维护者阅读。"
3
3
  kind: "package-reference"
4
4
  ---
5
5
 
@@ -9,7 +9,7 @@ kind: "package-reference"
9
9
 
10
10
  ## 概述
11
11
 
12
- `ralph` 针对一个不可变目标运行由多个全新子 agent（智能体）组成的前台序列，每个 Round 只接收上一份有界报告与共享工作区状态。它会在 worker 报告完成或具体阻塞，或达到配置的 Round 上限时返回；这些报告不会得到独立验证。父级对话与先前子 agent 会话绝不会复制到新的 Round。仅当直接用户明确要求 Ralph 式全新 agent 迭代时使用它；普通的长期工作请使用 goal 工具，有界委派请使用 subagent 或工作流。
12
+ `ralph` 针对一个不可变目标运行由多个全新子 agent 组成的前台序列，每个 Round 只接收上一份有界报告与共享工作区状态。它会在 worker 报告完成或具体阻塞，或达到配置的 Round 上限时返回；这些报告不会得到独立验证。父级对话与先前子 agent 会话绝不会复制到新的 Round。仅当直接用户明确要求 Ralph 式全新 agent 迭代时使用它；普通的长期工作请使用 goal 工具，有界委派请使用 subagent 或工作流。
13
13
 
14
14
  ## 目录
15
15
 
@@ -44,7 +44,7 @@ kind: "package-reference"
44
44
  | `maxHandoffChars` | `16384` | 一份 Round 报告序列化后的最大字符数。 |
45
45
  | `maxResultChars` | `16384` | 返回给父级的完整成功结果最大字符数。 |
46
46
 
47
- 生成的[配置目录](../../../docs/config-catalog.zh.md#deepseek-aidsh-tool-ralph)是每个受支持字段的穷尽式真源。配置的提供方必须存在、支持结构化输出，并报告 `inheritsParentContext: false`；针对违反此要求的提供方的调用会在任何 Round 开始前响亮失败。
47
+ 生成的[配置目录](../../../docs/config-catalog.zh.md#deepseek-aidsh-tool-ralph)是每个受支持字段的穷尽式真源。配置的提供方必须存在、支持结构化输出，并报告 `inheritsParentContext: false`；针对违反此要求的提供方发起调用时，会在任何 Round 开始前直接报错。
48
48
 
49
49
  -----
50
50
 
@@ -70,7 +70,7 @@ kind: "package-reference"
70
70
 
71
71
  ### 生命周期与取消
72
72
 
73
- 调用方 agent 是每个全新子 agent 的父级，因此会保留 cwd 与谱系，但不会复制其对话。`exec.signal` 进入工作流引擎，同时也桥接到 `run.cancel()`，以便不依赖具体实现。工具等待 `run.result` 并在 `finally` 中调用 `run.dispose()`，因此被取消的父级步骤会等到引擎完成有界终止且子 agent 完全停稳后才返回。
73
+ 调用方 agent 是每个全新子 agent 的父级，因此会保留 cwd 与谱系，但不会复制其对话。`exec.signal` 进入工作流引擎，同时也桥接到 `run.cancel()`，以便不依赖具体实现。工具等待 `run.result` 并在 `finally` 中调用 `run.dispose()`，因此被取消的父级步骤会等到进程与子 agent 清理完成后才返回。PTC 引擎不设整体工作流经过时间截止；调用方取消仍然生效。
74
74
 
75
75
  ### 渲染意图
76
76
 
@@ -81,7 +81,7 @@ kind: "package-reference"
81
81
  | 文件 | 职责 |
82
82
  |---|---|
83
83
  | [`src/index.ts`](src/index.ts) | 插件入口：固定脚本、提供方路由、报告校验、工具注册 |
84
- | — | 不发布运行时不变式伴生入口；工作流与 subagent 归属方校验它启动的运行与子 agent。 |
84
+ | — | 不发布运行时不变式伴生入口；该面向模型的编排适配器不拥有独立事件流；工作流与 subagent 归属方会校验该适配器启动的运行及其子 agent 生命周期。 |
85
85
 
86
86
  </details>
87
87
 
@@ -92,10 +92,10 @@ kind: "package-reference"
92
92
 
93
93
  当工具级契约不够用时阅读以下页面。它们从共享工作流模型逐步进入引擎、subagent seam 与相邻的 goal 领域。
94
94
 
95
- - [工作流子系统](../../../docs/subsystems/workflow.zh.md)——固定循环背后的 seam 契约。
95
+ - [工作流子系统](../../../docs/subsystems/workflow.zh.md)——固定循环背后的 seam 约定。
96
96
  - [工作流 seam](../workflow/README.zh.md)——运行与结果词汇。
97
- - [worker-thread 引擎](../workflow-worker-thread/README.zh.md)——执行固定脚本的引擎。
98
- - [subagent seam](../../subagent/subagent/README.zh.md)——全新子 agent 的提供方契约。
97
+ - [PTC 工作流引擎](../workflow-ptc/README.zh.md)——执行固定脚本的引擎。
98
+ - [subagent seam](../../subagent/subagent/README.zh.md)——全新子 agent 的提供方约定。
99
99
  - [goal 组](../../goal/goal/README.zh.md)——面向普通长期目标的同会话 goal 工具。
100
100
  - [Harness 层目标式执行 Agent Note](../../../.agents/notes/implemented/feature/2026-07-16-harness-level-loop.zh.md)——策略、提供方要求与暂缓事项。
101
101
 
@@ -142,7 +142,7 @@ Use the ralph tool ONLY when the direct human explicitly asks for a Ralph loop o
142
142
 
143
143
  #### 模型看到什么
144
144
 
145
- 每个子 agent 都会看到独立的固定 Round 提示词与结构化输出捕获契约。父级只看到原始调用与一个终态结果，其中包含 worker 报告的状态、Round 数量与美化打印的最终报告；中间子 agent 消息与报告不会进入父级对话。普通子 agent 失败时改为产生错误，其中包含对应 Round 编号；从第二个 Round 起，还会包含上一次成功交接。
145
+ 每个子 agent 都会看到独立的固定 Round 提示词与结构化输出捕获约定。父级只看到原始调用与一个终态结果，其中包含 worker 报告的状态、Round 数量与美化打印的最终报告；中间子 agent 消息与报告不会进入父级对话。普通子 agent 失败时改为产生错误，其中包含对应 Round 编号；从第二个 Round 起，还会包含上一次成功交接。
146
146
 
147
147
  #### Token 影响
148
148
 
package/package.json CHANGED
@@ -1,7 +1,7 @@
1
1
  {
2
2
  "name": "@deepseek-ai/dsh-tool-ralph",
3
3
  "description": "Model-facing fresh-agent Ralph loop over the workflow and subagent seams",
4
- "version": "0.1.5-rc.2",
4
+ "version": "0.1.6-alpha.1",
5
5
  "publishConfig": {
6
6
  "access": "public"
7
7
  },
@@ -27,32 +27,32 @@
27
27
  ],
28
28
  "license": "MIT",
29
29
  "peerDependencies": {
30
- "@deepseek-ai/dsh-llm": "^0.1.5-rc.2",
31
- "@deepseek-ai/dsh-agent": "^0.1.5-rc.2",
32
- "@deepseek-ai/dsh-subagent": "^0.1.5-rc.2",
33
- "@deepseek-ai/dsh-tools": "^0.1.5-rc.2",
34
- "@deepseek-ai/dsh-system-prompt": "^0.1.5-rc.2",
35
- "@deepseek-ai/cordis": "^4.0.2",
36
- "@deepseek-ai/dsh-workflow": "^0.1.5-rc.2"
30
+ "@deepseek-ai/dsh-agent": "^0.1.6-alpha.1",
31
+ "@deepseek-ai/dsh-llm": "^0.1.6-alpha.1",
32
+ "@deepseek-ai/dsh-system-prompt": "^0.1.6-alpha.1",
33
+ "@deepseek-ai/dsh-workflow": "^0.1.6-alpha.1",
34
+ "@deepseek-ai/dsh-subagent": "^0.1.6-alpha.1",
35
+ "@deepseek-ai/dsh-tools": "^0.1.6-alpha.1",
36
+ "@deepseek-ai/cordis": "^4.0.2"
37
37
  },
38
38
  "dependencies": {
39
39
  "@deepseek-ai/schemastery": "^3.18.2"
40
40
  },
41
41
  "devDependencies": {
42
42
  "@deepseek-ai/cordis-plugin-loader": "^1.0.3",
43
- "@deepseek-ai/dsh-agent": "^0.1.5-rc.2",
44
- "@deepseek-ai/dsh-agent-loop": "^0.1.5-rc.2",
45
- "@deepseek-ai/dsh-agent-loop-testkit": "^0.1.5-rc.2",
46
- "@deepseek-ai/dsh-llm": "^0.1.5-rc.2",
47
- "@deepseek-ai/dsh-session": "^0.1.5-rc.2",
48
- "@deepseek-ai/dsh-subagent": "^0.1.5-rc.2",
49
- "@deepseek-ai/dsh-subagent-in-process-driver": "^0.1.5-rc.2",
50
- "@deepseek-ai/dsh-subagent-spawn-in-process": "^0.1.5-rc.2",
51
- "@deepseek-ai/dsh-system-prompt": "^0.1.5-rc.2",
52
- "@deepseek-ai/dsh-tools": "^0.1.5-rc.2",
53
- "@deepseek-ai/dsh-workflow": "^0.1.5-rc.2",
43
+ "@deepseek-ai/dsh-agent": "^0.1.6-alpha.1",
44
+ "@deepseek-ai/dsh-agent-loop": "^0.1.6-alpha.1",
45
+ "@deepseek-ai/dsh-agent-loop-testkit": "^0.1.6-alpha.1",
46
+ "@deepseek-ai/dsh-llm": "^0.1.6-alpha.1",
47
+ "@deepseek-ai/dsh-session": "^0.1.6-alpha.1",
48
+ "@deepseek-ai/dsh-subagent": "^0.1.6-alpha.1",
49
+ "@deepseek-ai/dsh-subagent-in-process-driver": "^0.1.6-alpha.1",
50
+ "@deepseek-ai/dsh-subagent-spawn-in-process": "^0.1.6-alpha.1",
51
+ "@deepseek-ai/dsh-tools": "^0.1.6-alpha.1",
52
+ "@deepseek-ai/dsh-workflow": "^0.1.6-alpha.1",
53
+ "@deepseek-ai/dsh-system-prompt": "^0.1.6-alpha.1",
54
54
  "@deepseek-ai/cordis": "^4.0.2",
55
- "@deepseek-ai/dsh-session-projection": "^0.1.5-rc.2",
56
- "@deepseek-ai/dsh-workflow-worker-thread": "^0.1.5-rc.2"
55
+ "@deepseek-ai/dsh-session-projection": "^0.1.6-alpha.1",
56
+ "@deepseek-ai/dsh-workflow-ptc": "^0.1.6-alpha.1"
57
57
  }
58
58
  }