dsh-superagent-ptc 0.1.0 → 0.1.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.md +14 -4
- package/docs/images/architecture-dual.png +0 -0
- package/docs/images/architecture-dual.svg +6 -6
- package/docs/images/architecture-layers.png +0 -0
- package/docs/images/architecture-layers.svg +10 -10
- package/docs/images/icon.svg +8 -0
- package/docs/images/lifecycle.png +0 -0
- package/docs/images/lifecycle.svg +30 -37
- package/docs/images/panel-mockup.png +0 -0
- package/docs/images/panel-mockup.svg +1 -1
- package/package.json +1 -1
package/README.md
CHANGED
|
@@ -17,7 +17,7 @@ SuperAgent PTC turns "the agent says it is done" into "an independent reviewer p
|
|
|
17
17
|
→ 证据通过才放行 → super_snapshot 给出可验证的 revision/proof
|
|
18
18
|
```
|
|
19
19
|
|
|
20
|
-

|
|
21
21
|
|
|
22
22
|
## 目录
|
|
23
23
|
|
|
@@ -71,7 +71,7 @@ SuperAgent PTC turns "the agent says it is done" into "an independent reviewer p
|
|
|
71
71
|
|
|
72
72
|
监管面(Control Plane)只回答"能不能放行",执行面(Execution Plane)只回答"实际做了什么",两者之间只有一条契约膜:`super_*` 工具是状态与证据的唯一写入口。
|
|
73
73
|
|
|
74
|
-

|
|
75
75
|
|
|
76
76
|
- **A 监督面**:Lead 维护 Anchor 与义务账本;Mandate 冻结工作项、写域、路由与 attempt;证据门与预算决定放行。
|
|
77
77
|
- **契约膜**:任何状态变更都必须穿过 `super_*` 的 CAS 校验,双层之间没有第二套写路径。
|
|
@@ -80,7 +80,7 @@ SuperAgent PTC turns "the agent says it is done" into "an independent reviewer p
|
|
|
80
80
|
|
|
81
81
|
## 监督循环
|
|
82
82
|
|
|
83
|
-

|
|
84
84
|
|
|
85
85
|
```text
|
|
86
86
|
super_run create # 目标 + 完成定义 + 门禁策略
|
|
@@ -109,6 +109,16 @@ dsh plugin --profile desktop add npm:dsh-superagent-ptc
|
|
|
109
109
|
|
|
110
110
|
安装后**完全退出并重新启动 DSH**,然后新建会话,在预设选择器里选择 **SuperAgent PTC**。
|
|
111
111
|
|
|
112
|
+
### 通过 DSH 插件市场索引安装
|
|
113
|
+
|
|
114
|
+
在 DSH → 设置 → 插件 → 发现 中添加索引 URL,然后搜索 `SuperAgent PTC`:
|
|
115
|
+
|
|
116
|
+
```text
|
|
117
|
+
https://raw.githubusercontent.com/BioAIEvolu/dsh-superagent-ptc/main/market-index.json
|
|
118
|
+
```
|
|
119
|
+
|
|
120
|
+
该索引已通过 DSH 官方 `parseMarketIndex` 校验,安装规格为 `dsh-superagent-ptc@0.1.0`。
|
|
121
|
+
|
|
112
122
|
想先本地试用?把仓库 clone 下来用 `link:` 安装:
|
|
113
123
|
|
|
114
124
|
```bash
|
|
@@ -147,7 +157,7 @@ prepare/bind/bindReviewer 后由 Reviewer 独立记录 coverage 证据并 evalua
|
|
|
147
157
|
|
|
148
158
|
## 右栏监管面板
|
|
149
159
|
|
|
150
|
-

|
|
151
161
|
|
|
152
162
|
- 面板是**只读投影**:`目标/Anchor`、`模型策略与路由审计`、`工作项`、`Mandate`、`证据与门禁`、`审计时间线`、`议程/attempt`。
|
|
153
163
|
- 面板不写状态;所有变更只能由 `super_*` 工具穿过 Host 的 CAS 校验完成。
|
|
Binary file
|
|
@@ -1,4 +1,4 @@
|
|
|
1
|
-
<svg viewBox="0 0 680 592" width="100%" font-family="system-ui,sans-serif">
|
|
1
|
+
<svg xmlns="http://www.w3.org/2000/svg" viewBox="0 0 680 592" width="100%" font-family="system-ui,sans-serif">
|
|
2
2
|
<title>SuperAgent PTC dual-layer architecture</title>
|
|
3
3
|
<defs>
|
|
4
4
|
<marker id="a1" viewBox="0 0 10 10" refX="9" refY="5" markerWidth="7" markerHeight="7" orient="auto-start-reverse"><path d="M0,0 L10,5 L0,10 Z" fill="#85B7EB"/></marker>
|
|
@@ -40,13 +40,13 @@
|
|
|
40
40
|
<rect x="348" y="452" width="276" height="50" rx="8" fill="#CECBF6" stroke="#AFA9EC"/>
|
|
41
41
|
<text x="362" y="474" font-size="13" font-weight="600" fill="#3C3489">Execution receipts</text>
|
|
42
42
|
<text x="362" y="493" font-size="11" fill="#3C3489" opacity="0.8">reported_done, tool results, evidence raw</text>
|
|
43
|
-
<rect x="40" y="
|
|
44
|
-
<text x="54" y="
|
|
45
|
-
<text x="54" y="
|
|
43
|
+
<rect x="40" y="522" width="600" height="56" rx="8" fill="#9FE1CB" stroke="#5DCAA5"/>
|
|
44
|
+
<text x="54" y="546" font-size="13" font-weight="600" fill="#085041">Native runtime: Session, Agent, Teams + storageDomain and SnapshotProof</text>
|
|
45
|
+
<text x="54" y="565" font-size="11" fill="#085041" opacity="0.8">shared foundation for both planes</text>
|
|
46
46
|
<line x1="460" y1="264" x2="460" y2="356" stroke="#85B7EB" stroke-width="2" marker-end="url(#a1)"/>
|
|
47
47
|
<line x1="560" y1="356" x2="560" y2="268" stroke="#5DCAA5" stroke-width="2" marker-end="url(#a3)"/>
|
|
48
48
|
<line x1="196" y1="502" x2="196" y2="526" stroke="#AFA9EC" stroke-width="2" stroke-dasharray="6 4" marker-end="url(#a2)"/>
|
|
49
|
-
<text x="
|
|
50
|
-
<text x="
|
|
49
|
+
<text x="494" y="352" font-size="10" text-anchor="end" fill="#1F2937" opacity="0.75">delegate: mandate</text>
|
|
50
|
+
<text x="566" y="352" font-size="10" fill="#1F2937" opacity="0.75">return: evidence</text>
|
|
51
51
|
<text x="204" y="520" font-size="11" fill="#1F2937" opacity="0.75">native tools and subagent</text>
|
|
52
52
|
</svg>
|
|
Binary file
|
|
@@ -1,4 +1,4 @@
|
|
|
1
|
-
<svg viewBox="0 0 680 560" width="100%" font-family="system-ui,sans-serif">
|
|
1
|
+
<svg xmlns="http://www.w3.org/2000/svg" viewBox="0 0 680 560" width="100%" font-family="system-ui,sans-serif">
|
|
2
2
|
<title>SuperAgent PTC layered architecture</title>
|
|
3
3
|
<defs>
|
|
4
4
|
<marker id="a1" viewBox="0 0 10 10" refX="9" refY="5" markerWidth="7" markerHeight="7" orient="auto-start-reverse"><path d="M0,0 L10,5 L0,10 Z" fill="#85B7EB"/></marker>
|
|
@@ -36,9 +36,9 @@
|
|
|
36
36
|
<rect x="352" y="300" width="272" height="54" rx="8" fill="#B5D4F4" stroke="#85B7EB"/>
|
|
37
37
|
<text x="366" y="322" font-size="13" font-weight="600" fill="#0C447C">Client</text>
|
|
38
38
|
<text x="366" y="341" font-size="11" fill="#0C447C" opacity="0.8">right panel plus composer entry</text>
|
|
39
|
-
<rect x="56" y="364" width="568" height="
|
|
39
|
+
<rect x="56" y="364" width="568" height="40" rx="8" fill="#9FE1CB" stroke="#5DCAA5"/>
|
|
40
40
|
<text x="70" y="386" font-size="13" font-weight="600" fill="#085041">storageDomain RunState v2 + SnapshotProof</text>
|
|
41
|
-
<text x="70" y="
|
|
41
|
+
<text x="70" y="400" font-size="11" fill="#085041" opacity="0.8">proof, then storage, then live core</text>
|
|
42
42
|
<rect x="40" y="426" width="600" height="88" rx="10" fill="#F6F8FA" stroke="#D0D7DE"/>
|
|
43
43
|
<text x="52" y="444" font-size="12" fill="#1F2937" opacity="0.7">3 Native DSH runtime (execution authority)</text>
|
|
44
44
|
<rect x="56" y="452" width="280" height="50" rx="8" fill="#CECBF6" stroke="#AFA9EC"/>
|
|
@@ -47,14 +47,14 @@
|
|
|
47
47
|
<rect x="352" y="452" width="272" height="50" rx="8" fill="#CECBF6" stroke="#AFA9EC"/>
|
|
48
48
|
<text x="366" y="474" font-size="13" font-weight="600" fill="#3C3489">PTC run_code, native subagent</text>
|
|
49
49
|
<text x="366" y="493" font-size="11" fill="#3C3489" opacity="0.8">sendMessage wake, session log</text>
|
|
50
|
-
<line x1="149" y1="
|
|
51
|
-
<line x1="527" y1="
|
|
50
|
+
<line x1="149" y1="184" x2="149" y2="210" stroke="#85B7EB" stroke-width="2" marker-end="url(#a1)"/>
|
|
51
|
+
<line x1="527" y1="184" x2="527" y2="210" stroke="#AFA9EC" stroke-width="2" stroke-dasharray="6 4" marker-end="url(#a2)"/>
|
|
52
52
|
<line x1="196" y1="290" x2="196" y2="298" stroke="#85B7EB" stroke-width="2" marker-end="url(#a1)"/>
|
|
53
|
-
|
|
53
|
+
|
|
54
54
|
<line x1="340" y1="327" x2="350" y2="327" stroke="#AFA9EC" stroke-width="2" stroke-dasharray="6 4" marker-end="url(#a2)"/>
|
|
55
|
-
<line x1="196" y1="
|
|
56
|
-
<text x="156" y="
|
|
57
|
-
<text x="534" y="
|
|
58
|
-
<text x="204" y="
|
|
55
|
+
<line x1="196" y1="404" x2="196" y2="424" stroke="#AFA9EC" stroke-width="2" stroke-dasharray="6 4" marker-end="url(#a2)"/>
|
|
56
|
+
<text x="156" y="202" font-size="11" fill="#1F2937" opacity="0.75">super_*</text>
|
|
57
|
+
<text x="534" y="202" font-size="11" fill="#1F2937" opacity="0.75">read-only</text>
|
|
58
|
+
<text x="204" y="418" font-size="10" fill="#1F2937" opacity="0.75">proof to native session</text>
|
|
59
59
|
<text x="40" y="544" font-size="12" fill="#1F2937" opacity="0.6">Ordinary sessions get no tools and no panel; Reviewer read-only is enforced by the guard</text>
|
|
60
60
|
</svg>
|
|
@@ -0,0 +1,8 @@
|
|
|
1
|
+
<svg xmlns="http://www.w3.org/2000/svg" viewBox="0 0 128 128" width="128" height="128">
|
|
2
|
+
<rect width="128" height="128" rx="28" fill="#0C447C"/>
|
|
3
|
+
<rect x="24" y="30" width="80" height="16" rx="8" fill="#B5D4F4"/>
|
|
4
|
+
<rect x="24" y="56" width="56" height="16" rx="8" fill="#9FE1CB"/>
|
|
5
|
+
<rect x="24" y="82" width="72" height="16" rx="8" fill="#FAC775"/>
|
|
6
|
+
<circle cx="98" cy="90" r="12" fill="#9FE1CB"/>
|
|
7
|
+
<path d="M92 90 l5 5 l10 -11" stroke="#0C447C" stroke-width="3" fill="none" stroke-linecap="round" stroke-linejoin="round"/>
|
|
8
|
+
</svg>
|
|
Binary file
|
|
@@ -1,41 +1,34 @@
|
|
|
1
|
-
<svg viewBox="0 0 680
|
|
2
|
-
<title>Supervision loop</title>
|
|
1
|
+
<svg xmlns="http://www.w3.org/2000/svg" viewBox="0 0 680 400" width="100%" font-family="system-ui,sans-serif">
|
|
2
|
+
<title>Supervision loop: from objective to accepted evidence</title>
|
|
3
3
|
<defs>
|
|
4
|
-
<marker id="
|
|
5
|
-
<marker id="a2" viewBox="0 0 10 10" refX="9" refY="5" markerWidth="7" markerHeight="7" orient="auto-start-reverse"><path d="M0,0 L10,5 L0,10 Z" fill="#AFA9EC"/></marker>
|
|
6
|
-
<marker id="a3" viewBox="0 0 10 10" refX="9" refY="5" markerWidth="7" markerHeight="7" orient="auto-start-reverse"><path d="M0,0 L10,5 L0,10 Z" fill="#5DCAA5"/></marker>
|
|
4
|
+
<marker id="lc1" viewBox="0 0 10 10" refX="9" refY="5" markerWidth="7" markerHeight="7" orient="auto-start-reverse"><path d="M0,0 L10,5 L0,10 Z" fill="#85B7EB"/></marker>
|
|
7
5
|
</defs>
|
|
8
6
|
<text x="40" y="26" font-size="15" font-weight="600" fill="#1F2937">Supervision loop: from objective to accepted evidence</text>
|
|
9
|
-
<text x="40" y="44" font-size="12"
|
|
10
|
-
<rect x="40" y="58" width="12" height="12" rx="3" fill="#B5D4F4"/><text x="58" y="68" font-size="12"
|
|
11
|
-
<rect x="
|
|
12
|
-
<rect x="
|
|
13
|
-
<text x="
|
|
14
|
-
<text x="
|
|
15
|
-
<rect x="
|
|
16
|
-
<text x="
|
|
17
|
-
<text x="
|
|
18
|
-
<rect x="
|
|
19
|
-
<text x="
|
|
20
|
-
<text x="
|
|
21
|
-
<rect x="
|
|
22
|
-
<text x="
|
|
23
|
-
<text x="
|
|
24
|
-
<rect x="
|
|
25
|
-
<text x="
|
|
26
|
-
<text x="
|
|
27
|
-
<rect x="
|
|
28
|
-
<text x="
|
|
29
|
-
<text x="
|
|
30
|
-
<
|
|
31
|
-
<
|
|
32
|
-
<
|
|
33
|
-
<line x1="216" y1="
|
|
34
|
-
<line x1="
|
|
35
|
-
<
|
|
36
|
-
<line x1="440" y1="240" x2="416" y2="240" stroke="#85B7EB" stroke-width="2" marker-end="url(#a1)"/>
|
|
37
|
-
<line x1="216" y1="240" x2="240" y2="240" stroke="#85B7EB" stroke-width="2" marker-end="url(#a1)"/>
|
|
38
|
-
<line x1="128" y1="194" x2="128" y2="216" stroke="#85B7EB" stroke-width="2" marker-end="url(#a1)"/>
|
|
39
|
-
<line x1="528" y1="337" x2="528" y2="374" stroke="#AFA9EC" stroke-width="2" stroke-dasharray="6 4" marker-end="url(#a2)"/>
|
|
40
|
-
<text x="40" y="440" font-size="12" fill="#1F2937" opacity="0.6">Reviewer records its own coverage evidence, then decide and release; the Lead never proxies the review</text>
|
|
7
|
+
<text x="40" y="44" font-size="12" fill="#1F2937" opacity="0.65">Every step is a real tool call with CAS protection; no step can be skipped</text>
|
|
8
|
+
<rect x="40" y="58" width="12" height="12" rx="3" fill="#B5D4F4"/><text x="58" y="68" font-size="12" fill="#1F2937">Supervision step</text>
|
|
9
|
+
<rect x="176" y="58" width="12" height="12" rx="3" fill="#FAC775"/><text x="194" y="68" font-size="12" fill="#1F2937">Independent gate</text>
|
|
10
|
+
<rect x="56" y="120" width="160" height="64" rx="8" fill="#B5D4F4" stroke="#85B7EB"/>
|
|
11
|
+
<text x="70" y="150" font-size="13" font-weight="600" fill="#0C447C">1 create</text>
|
|
12
|
+
<text x="70" y="170" font-size="11" fill="#0C447C" opacity="0.8">objective + DoD</text>
|
|
13
|
+
<rect x="236" y="120" width="160" height="64" rx="8" fill="#B5D4F4" stroke="#85B7EB"/>
|
|
14
|
+
<text x="250" y="150" font-size="13" font-weight="600" fill="#0C447C">2 plan</text>
|
|
15
|
+
<text x="250" y="170" font-size="11" fill="#0C447C" opacity="0.8">items + obligations</text>
|
|
16
|
+
<rect x="416" y="120" width="160" height="64" rx="8" fill="#B5D4F4" stroke="#85B7EB"/>
|
|
17
|
+
<text x="430" y="150" font-size="13" font-weight="600" fill="#0C447C">3 Mandate</text>
|
|
18
|
+
<text x="430" y="170" font-size="11" fill="#0C447C" opacity="0.8">prepare + bind</text>
|
|
19
|
+
<rect x="56" y="232" width="160" height="64" rx="8" fill="#B5D4F4" stroke="#85B7EB"/>
|
|
20
|
+
<text x="70" y="262" font-size="13" font-weight="600" fill="#0C447C">4 Worker</text>
|
|
21
|
+
<text x="70" y="282" font-size="11" fill="#0C447C" opacity="0.8">report: not accepted</text>
|
|
22
|
+
<rect x="236" y="232" width="160" height="64" rx="8" fill="#FAC775" stroke="#EF9F27"/>
|
|
23
|
+
<text x="250" y="262" font-size="13" font-weight="600" fill="#633806">5 Reviewer</text>
|
|
24
|
+
<text x="250" y="282" font-size="11" fill="#633806" opacity="0.85">evidence + decide</text>
|
|
25
|
+
<rect x="416" y="232" width="160" height="64" rx="8" fill="#B5D4F4" stroke="#85B7EB"/>
|
|
26
|
+
<text x="430" y="262" font-size="13" font-weight="600" fill="#0C447C">6 Snapshot</text>
|
|
27
|
+
<text x="430" y="282" font-size="11" fill="#0C447C" opacity="0.8">proof + recovery</text>
|
|
28
|
+
<line x1="216" y1="152" x2="232" y2="152" stroke="#85B7EB" stroke-width="2" marker-end="url(#lc1)"/>
|
|
29
|
+
<line x1="396" y1="152" x2="412" y2="152" stroke="#85B7EB" stroke-width="2" marker-end="url(#lc1)"/>
|
|
30
|
+
<line x1="496" y1="184" x2="496" y2="228" stroke="#85B7EB" stroke-width="2" marker-end="url(#lc1)"/>
|
|
31
|
+
<line x1="216" y1="264" x2="232" y2="264" stroke="#85B7EB" stroke-width="2" marker-end="url(#lc1)"/>
|
|
32
|
+
<line x1="396" y1="264" x2="412" y2="264" stroke="#85B7EB" stroke-width="2" marker-end="url(#lc1)"/>
|
|
33
|
+
<text x="40" y="356" font-size="12" fill="#1F2937" opacity="0.6">Reviewer records its own coverage evidence, then decide and release; the Lead never proxies the review</text>
|
|
41
34
|
</svg>
|
|
Binary file
|
|
@@ -1,4 +1,4 @@
|
|
|
1
|
-
<svg viewBox="0 0 680 444" width="100%" font-family="system-ui,sans-serif">
|
|
1
|
+
<svg xmlns="http://www.w3.org/2000/svg" viewBox="0 0 680 444" width="100%" font-family="system-ui,sans-serif">
|
|
2
2
|
<title>Right panel anatomy</title>
|
|
3
3
|
<defs>
|
|
4
4
|
<marker id="a1" viewBox="0 0 10 10" refX="9" refY="5" markerWidth="7" markerHeight="7" orient="auto-start-reverse"><path d="M0,0 L10,5 L0,10 Z" fill="#85B7EB"/></marker>
|
package/package.json
CHANGED
|
@@ -1,6 +1,6 @@
|
|
|
1
1
|
{
|
|
2
2
|
"name": "dsh-superagent-ptc",
|
|
3
|
-
"version": "0.1.
|
|
3
|
+
"version": "0.1.1",
|
|
4
4
|
"description": "SuperAgent PTC: long-task supervision for DeepSeek Harness. Versioned goal anchors, bounded delegation (Mandate), independent read-only Reviewer acceptance, typed evidence gates and crash-safe proof/recovery. Native PTC execution, preset-first, no second agent loop. 中文:为 DSH 长任务提供目标锚点、有界委派、独立验收与证据放行的监督层。",
|
|
5
5
|
"type": "module",
|
|
6
6
|
"license": "MIT",
|