@deepseek-ai/dsh-tool-ralph 0.2.0-rc.1 → 0.2.1-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.
- package/README.i18n.yaml +8 -8
- package/README.md +4 -4
- package/README.zh.md +4 -4
- package/package.json +24 -24
package/README.i18n.yaml
CHANGED
|
@@ -30,8 +30,8 @@
|
|
|
30
30
|
en: 0999ea3a4c9da48c
|
|
31
31
|
zh: 83013ee36a8689af
|
|
32
32
|
/deepseek-ai-dsh-tool-ralph/understand-the-implementation/design-concept:
|
|
33
|
-
en:
|
|
34
|
-
zh:
|
|
33
|
+
en: 3777bac0215c7366
|
|
34
|
+
zh: 18240f47506c67bd
|
|
35
35
|
/deepseek-ai-dsh-tool-ralph/understand-the-implementation/fixed-script-and-routing:
|
|
36
36
|
en: fa2cfda2d9d121e6
|
|
37
37
|
zh: 75720bd6244a2c96
|
|
@@ -45,11 +45,11 @@
|
|
|
45
45
|
en: 07e071bd44b1df65
|
|
46
46
|
zh: 26f1cb2eab8c25b0
|
|
47
47
|
/deepseek-ai-dsh-tool-ralph/understand-the-implementation/source-map:
|
|
48
|
-
en:
|
|
49
|
-
zh:
|
|
48
|
+
en: 1bc11234792b4e3f
|
|
49
|
+
zh: 872d2c5f8df37b72
|
|
50
50
|
/deepseek-ai-dsh-tool-ralph/further-exploration:
|
|
51
|
-
en:
|
|
52
|
-
zh:
|
|
51
|
+
en: 966417f5c0659ef9
|
|
52
|
+
zh: 6c95a000db46ce0f
|
|
53
53
|
/deepseek-ai-dsh-tool-ralph/model-experience:
|
|
54
54
|
en: 215e7ba838619b7b
|
|
55
55
|
zh: a311da3843709f90
|
|
@@ -93,8 +93,8 @@
|
|
|
93
93
|
en: 8f28959dc87d1f2f
|
|
94
94
|
zh: c034c5c0bdaf9bba
|
|
95
95
|
/deepseek-ai-dsh-tool-ralph/known-limitations-and-deferred-work:
|
|
96
|
-
en:
|
|
97
|
-
zh:
|
|
96
|
+
en: 4e3629e8de05fe18
|
|
97
|
+
zh: 5b33af22079a2ca7
|
|
98
98
|
/deepseek-ai-dsh-tool-ralph/known-limitations-and-deferred-work/dev-note:
|
|
99
99
|
en: 8f24c317039e1974
|
|
100
100
|
zh: c6209969ad21f16c
|
package/README.md
CHANGED
|
@@ -58,7 +58,7 @@ This section explains the fixed-script design and the validation and lifecycle m
|
|
|
58
58
|
|
|
59
59
|
### Design concept
|
|
60
60
|
|
|
61
|
-
The loop is a deployment-owned fixed script: the model supplies data only and cannot alter the loop, provider route, schema, or handoff validation. The tool is an ordinary plugin over `ctx.workflowEngine` and `ctx.subagents` — no Ralph mode or fresh-agent loop is added to `agent-loop`, and the same-session goal domain stays independent.
|
|
61
|
+
The loop is a deployment-owned fixed script: the model supplies data only and cannot alter the loop, provider route, schema, or handoff validation. The tool is an ordinary plugin over `ctx.workflowEngine` and `ctx.subagents` — no Ralph mode or fresh-agent loop is added to `agent-loop`, and the same-session goal domain stays independent.
|
|
62
62
|
|
|
63
63
|
### Fixed script and routing
|
|
64
64
|
|
|
@@ -81,7 +81,6 @@ The pending call is a `generic` card titled `ralph` with the immutable objective
|
|
|
81
81
|
| File | Role |
|
|
82
82
|
|---|---|
|
|
83
83
|
| [`src/index.ts`](src/index.ts) | Plugin entry: fixed script, provider routing, report validation, tool registration |
|
|
84
|
-
| — | No runtime invariant companion is published; this model-facing orchestration adapter owns no independent event stream; workflow and subagent owners validate the runs and child lifecycles it starts. |
|
|
85
84
|
|
|
86
85
|
</details>
|
|
87
86
|
|
|
@@ -97,7 +96,7 @@ Read these pages when the tool-level contract is not enough. They move from the
|
|
|
97
96
|
- [PTC workflow engine](../workflow-ptc/README.md) — the engine that executes the fixed script.
|
|
98
97
|
- [subagent seam](../../subagent/subagent/README.md) — the fresh-child provider contract.
|
|
99
98
|
- [Goal group](../../goal/goal/README.md) — same-session goal tools for ordinary long-running objectives.
|
|
100
|
-
- [Harness-level goal-based execution Agent Note](../../../.agents/notes/
|
|
99
|
+
- [historical Harness-level goal-based execution Agent Note](../../../.agents/notes/archived/feature/2026-07-16-harness-level-loop.md) — the policy, provider requirements, and deferred work.
|
|
101
100
|
|
|
102
101
|
-----
|
|
103
102
|
|
|
@@ -159,10 +158,11 @@ Each fresh child has an independent request cache. The parent result appends aft
|
|
|
159
158
|
|
|
160
159
|
These limits define what the tool does not yet support. They are current constraints, not a task backlog.
|
|
161
160
|
|
|
162
|
-
- **Completion is worker self-declaration** — there is no independent evaluator or verifier deciding whether the objective is complete; evaluator policy and evaluator-driven continuation are deferred.
|
|
161
|
+
- **Completion is worker self-declaration** — there is no independent evaluator or verifier deciding whether the objective is complete; evaluator policy and evaluator-driven continuation are deferred. An evaluator needs separately defined inputs, tool access, deterministic checks, provider choice, isolation, and authority before it can certify completion or drive continuation.
|
|
163
162
|
- **Foreground only** — there is no job id, background collection, process-resume checkpoint, scheduler, or wall-clock start policy.
|
|
164
163
|
- **The workspace is the only cross-round long-term memory** — one bounded report is the explicit handoff, and uncommitted conversational reasoning disappears with each child.
|
|
165
164
|
- **One round is one fresh child** — there is no within-round fan-out, model or provider switching, fork context, or model-call-selected provider.
|
|
165
|
+
- **No enforced recursive-Ralph denial** — structural denial is not implemented; prompt guidance does not enforce a recursion ban.
|
|
166
166
|
- **Ordinary child failure is terminal for the run** — the fixed script reports the failed round and last successful handoff but does not retry; fatal workflow infrastructure failures can end before that state is returned.
|
|
167
167
|
- **Only round count bounds aggregate effort** — token, price, and elapsed-time budgets are deferred.
|
|
168
168
|
|
package/README.zh.md
CHANGED
|
@@ -58,7 +58,7 @@ kind: "package-reference"
|
|
|
58
58
|
|
|
59
59
|
### 设计理念
|
|
60
60
|
|
|
61
|
-
循环是部署方拥有的固定脚本：模型只提供数据，无法改变循环、提供方路由、schema 或交接校验。该工具是基于 `ctx.workflowEngine` 与 `ctx.subagents` 的普通插件——不会向 `agent-loop` 添加 Ralph 模式或全新 agent loop，同会话的 goal 领域也保持独立。
|
|
61
|
+
循环是部署方拥有的固定脚本：模型只提供数据，无法改变循环、提供方路由、schema 或交接校验。该工具是基于 `ctx.workflowEngine` 与 `ctx.subagents` 的普通插件——不会向 `agent-loop` 添加 Ralph 模式或全新 agent loop，同会话的 goal 领域也保持独立。
|
|
62
62
|
|
|
63
63
|
### 固定脚本与路由
|
|
64
64
|
|
|
@@ -81,7 +81,6 @@ kind: "package-reference"
|
|
|
81
81
|
| 文件 | 职责 |
|
|
82
82
|
|---|---|
|
|
83
83
|
| [`src/index.ts`](src/index.ts) | 插件入口：固定脚本、提供方路由、报告校验、工具注册 |
|
|
84
|
-
| — | 不发布运行时不变式伴生入口；该面向模型的编排适配器不拥有独立事件流；工作流与 subagent 归属方会校验该适配器启动的运行及其子 agent 生命周期。 |
|
|
85
84
|
|
|
86
85
|
</details>
|
|
87
86
|
|
|
@@ -97,7 +96,7 @@ kind: "package-reference"
|
|
|
97
96
|
- [PTC 工作流引擎](../workflow-ptc/README.zh.md)——执行固定脚本的引擎。
|
|
98
97
|
- [subagent seam](../../subagent/subagent/README.zh.md)——全新子 agent 的提供方约定。
|
|
99
98
|
- [goal 组](../../goal/goal/README.zh.md)——面向普通长期目标的同会话 goal 工具。
|
|
100
|
-
- [Harness 层目标式执行 Agent Note](../../../.agents/notes/
|
|
99
|
+
- [历史Harness 层目标式执行 Agent Note](../../../.agents/notes/archived/feature/2026-07-16-harness-level-loop.md)——策略、提供方要求与暂缓事项。
|
|
101
100
|
|
|
102
101
|
-----
|
|
103
102
|
|
|
@@ -159,10 +158,11 @@ Use the ralph tool ONLY when the direct human explicitly asks for a Ralph loop o
|
|
|
159
158
|
|
|
160
159
|
这些限制说明该工具尚未支持什么。它们是当前约束，不是任务积压。
|
|
161
160
|
|
|
162
|
-
- **完成由 worker
|
|
161
|
+
- **完成由 worker 自行声明**——没有独立评估器或验证器判断目标是否完成；评估器策略与评估器驱动的延续均暂缓。评估器须先单独定义输入、工具访问、确定性检查、提供方选择、隔离与授权规则，才能认证完成或驱动延续。
|
|
163
162
|
- **仅支持前台**——没有 job id、后台收集、进程恢复检查点、调度器或基于挂钟时间的启动策略。
|
|
164
163
|
- **工作区是唯一的跨 Round 长期记忆**——一份有界报告作为显式交接，每个子 agent 结束后，未提交的对话推理都会消失。
|
|
165
164
|
- **一个 Round 对应一个全新子 agent**——Round 内没有扇出、模型或提供方切换、fork 上下文或由模型调用选择的提供方。
|
|
165
|
+
- **没有强制拒绝递归 Ralph**——结构性拒绝尚未实现；提示词引导不能强制禁止递归。
|
|
166
166
|
- **普通子 agent 失败会终止运行**——固定脚本报告失败的 Round 与上一次成功交接，但不会重试；致命的工作流基础设施失败可能在该状态返回前结束。
|
|
167
167
|
- **聚合工作量仅受 Round 数量限制**——token、价格与耗时预算均暂缓。
|
|
168
168
|
|
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.2.
|
|
4
|
+
"version": "0.2.1-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-agent": "0.2.
|
|
31
|
-
"@deepseek-ai/dsh-llm": "0.2.
|
|
32
|
-
"@deepseek-ai/dsh-
|
|
33
|
-
"@deepseek-ai/dsh-
|
|
34
|
-
"@deepseek-ai/dsh-tools": "0.2.
|
|
35
|
-
"@deepseek-ai/dsh-workflow": "0.2.
|
|
36
|
-
"@deepseek-ai/cordis": "~4.0.
|
|
30
|
+
"@deepseek-ai/dsh-agent": "0.2.1-alpha.1",
|
|
31
|
+
"@deepseek-ai/dsh-llm": "0.2.1-alpha.1",
|
|
32
|
+
"@deepseek-ai/dsh-system-prompt": "0.2.1-alpha.1",
|
|
33
|
+
"@deepseek-ai/dsh-subagent": "0.2.1-alpha.1",
|
|
34
|
+
"@deepseek-ai/dsh-tools": "0.2.1-alpha.1",
|
|
35
|
+
"@deepseek-ai/dsh-workflow": "0.2.1-alpha.1",
|
|
36
|
+
"@deepseek-ai/cordis": "~4.0.5-alpha.1"
|
|
37
37
|
},
|
|
38
38
|
"dependencies": {
|
|
39
|
-
"@deepseek-ai/schemastery": "~3.18.
|
|
39
|
+
"@deepseek-ai/schemastery": "~3.18.5-alpha.1"
|
|
40
40
|
},
|
|
41
41
|
"devDependencies": {
|
|
42
|
-
"@deepseek-ai/cordis-plugin-loader": "~1.0.
|
|
43
|
-
"@deepseek-ai/dsh-agent": "0.2.
|
|
44
|
-
"@deepseek-ai/dsh-agent-loop": "0.2.
|
|
45
|
-
"@deepseek-ai/dsh-agent-loop-testkit": "0.2.
|
|
46
|
-
"@deepseek-ai/dsh-llm": "0.2.
|
|
47
|
-
"@deepseek-ai/dsh-session": "0.2.
|
|
48
|
-
"@deepseek-ai/dsh-subagent
|
|
49
|
-
"@deepseek-ai/dsh-
|
|
50
|
-
"@deepseek-ai/dsh-subagent-
|
|
51
|
-
"@deepseek-ai/dsh-
|
|
52
|
-
"@deepseek-ai/dsh-
|
|
53
|
-
"@deepseek-ai/dsh-workflow
|
|
54
|
-
"@deepseek-ai/
|
|
55
|
-
"@deepseek-ai/
|
|
56
|
-
"@deepseek-ai/dsh-
|
|
42
|
+
"@deepseek-ai/cordis-plugin-loader": "~1.0.6-alpha.1",
|
|
43
|
+
"@deepseek-ai/dsh-agent": "0.2.1-alpha.1",
|
|
44
|
+
"@deepseek-ai/dsh-agent-loop": "0.2.1-alpha.1",
|
|
45
|
+
"@deepseek-ai/dsh-agent-loop-testkit": "0.2.1-alpha.1",
|
|
46
|
+
"@deepseek-ai/dsh-llm": "0.2.1-alpha.1",
|
|
47
|
+
"@deepseek-ai/dsh-session": "0.2.1-alpha.1",
|
|
48
|
+
"@deepseek-ai/dsh-subagent": "0.2.1-alpha.1",
|
|
49
|
+
"@deepseek-ai/dsh-subagent-spawn-in-process": "0.2.1-alpha.1",
|
|
50
|
+
"@deepseek-ai/dsh-subagent-in-process-driver": "0.2.1-alpha.1",
|
|
51
|
+
"@deepseek-ai/dsh-system-prompt": "0.2.1-alpha.1",
|
|
52
|
+
"@deepseek-ai/dsh-tools": "0.2.1-alpha.1",
|
|
53
|
+
"@deepseek-ai/dsh-workflow": "0.2.1-alpha.1",
|
|
54
|
+
"@deepseek-ai/dsh-workflow-ptc": "0.2.1-alpha.1",
|
|
55
|
+
"@deepseek-ai/cordis": "~4.0.5-alpha.1",
|
|
56
|
+
"@deepseek-ai/dsh-session-projection": "0.2.1-alpha.1"
|
|
57
57
|
}
|
|
58
58
|
}
|