dsh-superagent-ptc 0.1.1 → 0.1.3

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/NOTICE.md CHANGED
@@ -45,3 +45,10 @@ The upstream MIT notice is preserved below:
45
45
  - Local `dsh-codeflow` (MIT): reference for narrowing the slots interface structurally instead of importing the unrelated hoisted pre-rc.3 slots declarations. `scripts/build-client.mjs` adapts its MIT esbuild CJS + `window.__ModuleLoader__.load` recipe for this package. No CodeGraph implementation is copied.
46
46
 
47
47
  No implementation is copied from the UNLICENSED dsh-task-supervisor reference.
48
+
49
+
50
+ ## Community references (no code redistributed)
51
+
52
+ - `dsh-plugin-antidrift` plugin source shared by community member **CC** in a 2026-11-17 group chat; reviewed read-only for design inspiration. Not installed, not executed, not copied.
53
+ - Group discussion on long-running supervision in the same chat (桉, Electron, CC, KOLA 2) informed the work-item, audit cadence, and evidence-gate design.
54
+ - Upstream `zouyuanqing/dsh-super-ptc-mode` (MIT) is credited above.
package/README.md CHANGED
@@ -69,6 +69,8 @@ SuperAgent PTC turns "the agent says it is done" into "an independent reviewer p
69
69
 
70
70
  ## 双层架构
71
71
 
72
+ **一句话定位**:SuperAgent PTC 在宿主原生 Agent/Session 机制之上叠加一层监管状态机(`Run → Anchor → Mandate → Evidence → Decision`),把原生 agent 会话按角色(Lead / Worker / Reviewer)绑定进这条监管链;**PTC 的原生事件链**(`run_code` 调用与工具回执)**是整条链的证据底座**——监管层自己不产生第二套事件流。
73
+
72
74
  监管面(Control Plane)只回答"能不能放行",执行面(Execution Plane)只回答"实际做了什么",两者之间只有一条契约膜:`super_*` 工具是状态与证据的唯一写入口。
73
75
 
74
76
  ![Dual-layer architecture](docs/images/architecture-dual.png)
@@ -221,6 +223,19 @@ pnpm typecheck && pnpm build && pnpm test
221
223
  - 提交前请保持 `typecheck`、`build`、`test` 全绿;核心状态机改动需补正反例。
222
224
  - 欢迎 Issue / PR:https://github.com/BioAIEvolu/dsh-superagent-ptc/issues
223
225
 
226
+ ## 致谢
227
+
228
+ 这个插件的方向不是凭空想出来的,来自 2026-11-17 一次真实的群聊讨论与源码分享:
229
+
230
+ - **群友 CC**:分享了 `dsh-plugin-antidrift` 插件源码,并给出真实的长任务经验——用 `/goal` 设置长期目标、单次跑过 30+ 小时、一次开 10 个 agent 并行写。本项目对其源码只做取证阅读(未安装、未运行、未复制代码),其“锚点 + 委派 + 审计”的思路是重要的早期启发。
231
+ - **桉**:提出“一次性部署多条指令、每几条插入一次小审计、不紧急就继续”的节奏,直接对应本项目“工作项 + 证据门 + 失败预算”的取舍。
232
+ - **Electron**:在讨论中把这种形态认作 PTC 模式的延伸,促使我们确认“PTC 只有 `run_code`,监管必须建立在其原生事件链之上”。
233
+ - **KOLA 2**:提出“定时轮询检查进度、完成就释放下一条命令与审计”,以及“主 router 控制 worker 干活”的 SuperAgent 思路,这两点分别影响了 Mandate 的解锁语义与 Lead/Worker/Reviewer 的角色划分。
234
+
235
+ 另外感谢上游参考 `zouyuanqing/dsh-super-ptc-mode`(MIT):本项目参考了其轻量 preset 组合方式与 Lead 委派理念,persona 与组合已按当前 DSH 契约重写,许可与出处保留在 [NOTICE.md](NOTICE.md)。
236
+
237
+ 以及所有在群里继续讨论、提问和纠正的人——这些对话让“证据放行”从一句口号变成了可验证的状态机。
238
+
224
239
  ## 许可
225
240
 
226
241
  MIT License,见 [LICENSE](LICENSE)。上游 DSH 组件版权与来源见 [NOTICE.md](NOTICE.md)。
@@ -4,7 +4,7 @@
4
4
 
5
5
  ## 1. 架构决策
6
6
 
7
- SuperAgent PTC 是 **Preset-first、宿主原生执行、插件增量监管**:
7
+ SuperAgent PTC 是 **Preset-first、宿主原生执行、插件增量监管**:在宿主原生 Agent/Session 机制之上叠加一层监管状态机(`Run → Anchor → Mandate → Evidence → Decision`),把原生 agent 会话按角色绑定进这条监管链;PTC 的原生事件链是整条链的证据底座,监管层不产生第二套事件流。
8
8
 
9
9
  - 包名 `dsh-superagent-ptc`(npm 公开包,仓库与安装方式见 README);预设显示名 **SuperAgent PTC**,与标准、创造、PTC、极简完整并列。
10
10
  - 稳定内部 ID 不随显示名/包名改变:preset ID `super-agent`、既有 `super_*` 工具、storageDomain `super_agent_mode`、SnapshotProof record 等持久标识保持兼容;名称变化不构成状态迁移。新增 `super_route` 是能力扩展,不改变原有 ID。
Binary file
@@ -32,7 +32,7 @@
32
32
  <text x="366" y="277" font-size="11" fill="#0C447C" opacity="0.8">read-only classification, fail-closed</text>
33
33
  <rect x="56" y="300" width="280" height="54" rx="8" fill="#B5D4F4" stroke="#85B7EB"/>
34
34
  <text x="70" y="322" font-size="13" font-weight="600" fill="#0C447C">Core state machine</text>
35
- <text x="70" y="341" font-size="11" fill="#0C447C" opacity="0.8">Anchor, Mandate, Evidence, Decision</text>
35
+ <text x="70" y="341" font-size="10" fill="#0C447C" opacity="0.8">Run → Anchor → Mandate → Evidence → Decision</text>
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>
package/package.json CHANGED
@@ -1,6 +1,6 @@
1
1
  {
2
2
  "name": "dsh-superagent-ptc",
3
- "version": "0.1.1",
3
+ "version": "0.1.3",
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",