@jjh32456/dsh-longlive 1.6.8 → 1.8.0

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 (288) hide show
  1. package/CHANGELOG.md +69 -1539
  2. package/LICENSE +1 -1
  3. package/QUICKSTART.md +33 -12
  4. package/README.en.md +17 -7
  5. package/README.md +29 -10
  6. package/SPEC.md +5 -5
  7. package/cordis.patch.yml +17 -12
  8. package/docs/ANSWER-GUARD.md +92 -0
  9. package/docs/ARCHITECTURE.md +3 -3
  10. package/docs/AUTO-RECALL-WIRING.md +1 -1
  11. package/docs/AUTO-RECALL.md +15 -9
  12. package/docs/CONFIG.md +143 -37
  13. package/docs/ERRORS.md +17 -5
  14. package/docs/FAQ.md +7 -7
  15. package/docs/FEATURES.md +66 -29
  16. package/docs/MIGRATION-1.6.0.md +2 -2
  17. package/docs/OPERATIONS.md +6 -6
  18. package/docs/PANEL-INTEGRATION.md +6 -0
  19. package/docs/PRIVACY.md +88 -0
  20. package/docs/QUICKSTART.md +5 -5
  21. package/docs/README.en.md +3 -2
  22. package/docs/RESIDENT-WATCHER.md +1 -1
  23. package/docs/SESSION-WATCH.md +6 -6
  24. package/docs/TROUBLESHOOTING.md +4 -4
  25. package/package.json +42 -117
  26. package/runbook.md +2 -2
  27. package/scripts/backfill-auto-cards.mjs +98 -0
  28. package/scripts/install-surgery-task.ps1 +5 -2
  29. package/scripts/lib/session-watch-fixture.mjs +1 -1
  30. package/scripts/longlive-doctor.mjs +6 -0
  31. package/scripts/migrate-180.mjs +163 -0
  32. package/scripts/recall-index-build.mjs +128 -0
  33. package/scripts/session-watch-drill.mjs +1 -1
  34. package/scripts/surgery-run.cmd +1 -1
  35. package/scripts/unattended-surgery.ps1 +5 -2
  36. package/scripts/verify-card-anchors.mjs +138 -0
  37. package/src/actions/audit.js +125 -0
  38. package/src/actions/evidence.js +122 -0
  39. package/src/actions/fs.js +162 -0
  40. package/src/activity/index.js +129 -18
  41. package/src/activity/model.js +11 -1
  42. package/src/activity/store.js +22 -3
  43. package/src/activity/thinking.js +176 -0
  44. package/src/adapters/constants.js +11 -0
  45. package/src/adapters/engram/data/aliases.json +51 -0
  46. package/src/adapters/engram/data/policy.json +8 -0
  47. package/src/adapters/engram/data/routing-rules.json +546 -0
  48. package/src/adapters/engram/index.js +235 -0
  49. package/src/adapters/registry.js +315 -0
  50. package/src/answer/audit.js +193 -0
  51. package/src/answer/evidence.js +30 -0
  52. package/src/answer/guard.js +1370 -0
  53. package/src/answer/index.js +1067 -0
  54. package/src/answer/query.js +111 -0
  55. package/src/answer/second-hop.mjs +101 -0
  56. package/src/auto-truncate.js +1 -1
  57. package/src/config.js +145 -48
  58. package/src/deps.js +6 -4
  59. package/src/features.js +158 -8
  60. package/src/identity/index.js +13 -5
  61. package/src/identity/inject-position.js +2 -2
  62. package/src/index.js +97 -7
  63. package/src/lifecycle/gap-clocks.js +328 -0
  64. package/src/lifecycle/index.js +269 -0
  65. package/src/memory/activity-capture.js +229 -0
  66. package/src/memory/anchors.js +194 -0
  67. package/src/memory/audit-records.js +222 -0
  68. package/src/memory/auto-cards.js +401 -0
  69. package/src/memory/capture.js +442 -0
  70. package/src/memory/card-anchors.js +203 -0
  71. package/src/memory/conflicts.js +106 -0
  72. package/src/memory/decay.js +311 -0
  73. package/src/memory/distill.js +471 -0
  74. package/src/memory/event-index.js +917 -0
  75. package/src/memory/evidence-chain.js +295 -0
  76. package/src/memory/evidence.js +145 -0
  77. package/src/memory/filter-runner.js +1 -1
  78. package/src/memory/filter.js +5 -1
  79. package/src/memory/forget-v2.js +410 -0
  80. package/src/memory/forget.js +71 -0
  81. package/src/memory/frames-activation.js +247 -0
  82. package/src/memory/fts-query.js +174 -0
  83. package/src/memory/governance.js +604 -0
  84. package/src/memory/index.js +1 -0
  85. package/src/memory/l2-gate.js +169 -0
  86. package/src/memory/lock.js +121 -0
  87. package/src/memory/migrate.js +139 -0
  88. package/src/memory/recall-v2.js +223 -0
  89. package/src/memory/recall.js +65 -2
  90. package/src/memory/records.js +425 -0
  91. package/src/memory/retention.js +128 -0
  92. package/src/memory/review.js +124 -0
  93. package/src/memory/trust.js +88 -0
  94. package/src/memory/version-chain.js +264 -0
  95. package/src/memory/wal.js +137 -0
  96. package/src/memory/working-frame.js +516 -0
  97. package/src/metrics/classify.mjs +5 -3
  98. package/src/metrics/index.mjs +21 -1
  99. package/src/metrics/prestep-latency.mjs +300 -0
  100. package/src/metrics/store.mjs +25 -0
  101. package/src/policy-profile.js +18 -3
  102. package/src/recall/anaphora.mjs +87 -0
  103. package/src/recall/cards.mjs +7 -0
  104. package/src/recall/embedding.mjs +8 -8
  105. package/src/recall/entities.mjs +112 -0
  106. package/src/recall/index.js +235 -19
  107. package/src/recall/inject-order.mjs +10 -8
  108. package/src/recall/privacy.mjs +1 -1
  109. package/src/recall/recall-core.mjs +116 -10
  110. package/src/recall/shared-visibility.js +302 -0
  111. package/src/recall/time-normalizer.mjs +196 -0
  112. package/src/role/activation.js +191 -0
  113. package/src/role/attention.js +318 -0
  114. package/src/role/base.js +36 -0
  115. package/src/role/channels.js +423 -0
  116. package/src/role/index.js +425 -0
  117. package/src/role/interfaces.js +115 -0
  118. package/src/role/personality.js +370 -0
  119. package/src/role/readers.js +151 -0
  120. package/src/role/relationships.js +477 -0
  121. package/src/role/store.js +202 -0
  122. package/src/role/writeprotect.js +373 -0
  123. package/src/router/aliases.json +176 -25
  124. package/src/router/background/agent-runner.mjs +1 -1
  125. package/src/router/background/anchor.mjs +1 -1
  126. package/src/router/background/audit.mjs +2 -2
  127. package/src/router/background/budget-ledger.mjs +2 -2
  128. package/src/router/background/host-sim.mjs +1 -1
  129. package/src/router/background/memory.mjs +4 -4
  130. package/src/router/background/queue.mjs +1 -1
  131. package/src/router/background/retry.mjs +1 -1
  132. package/src/router/background/router.mjs +1 -1
  133. package/src/router/background/stream.mjs +1 -1
  134. package/src/router/background/tool-policy.mjs +1 -1
  135. package/src/router/design-headings.json +5 -5
  136. package/src/router/face/config.mjs +1 -1
  137. package/src/router/face/identity.mjs +3 -3
  138. package/src/router/judge.mjs +8 -7
  139. package/src/router/policies/generic.json +21 -4
  140. package/src/router/route.js +109 -22
  141. package/src/router/router.mjs +10 -6
  142. package/src/router/routing-rules.json +260 -445
  143. package/src/router/run-sim.mjs +8 -8
  144. package/src/router/runtime.js +23 -12
  145. package/src/router/service/config.mjs +5 -5
  146. package/src/router/service/context.mjs +1 -1
  147. package/src/router/service/queue.mjs +1 -1
  148. package/src/router/shadow.mjs +4 -3
  149. package/src/surgery-recovery.js +2 -2
  150. package/src/tool-output.js +2 -2
  151. package/src/tools.js +39 -7
  152. package/src/truncate-visible.js +2 -2
  153. package/src/ui/actions.js +1312 -0
  154. package/src/ui/panel-api.js +367 -0
  155. package/src/ui/panel-auth.js +251 -0
  156. package/src/ui/panel-integrity.js +243 -0
  157. package/src/ui/routes-readonly.js +695 -0
  158. package/src/ui/routes.js +3 -0
  159. package/docs/DEV.md +0 -279
  160. package/docs/PRESENCE-BUS-WIRING.md +0 -491
  161. package/docs/PRESENCE-BUS.md +0 -694
  162. package/docs/SURGERY.md +0 -186
  163. package/scripts/mark-core-cards.mjs +0 -289
  164. package/scripts/pack.mjs +0 -392
  165. package/scripts/router-proposals.mjs +0 -386
  166. package/src/router/fixtures/M1.json +0 -16
  167. package/src/router/fixtures/M2.json +0 -16
  168. package/src/router/fixtures/M3.json +0 -20
  169. package/src/router/fixtures/M4.json +0 -20
  170. package/src/router/fixtures/M5.json +0 -45
  171. package/src/router/fixtures/M6.json +0 -53
  172. package/src/router/fixtures/M7.json +0 -46
  173. package/src/router/fixtures/S1.json +0 -20
  174. package/src/router/fixtures/S2.json +0 -23
  175. package/src/router/fixtures/S3.json +0 -20
  176. package/src/router/fixtures/S4.json +0 -34
  177. package/src/router/fixtures/S5.json +0 -43
  178. package/src/router/fixtures/S6.json +0 -47
  179. package/src/router/fixtures/T1.json +0 -23
  180. package/src/router/fixtures/T2.json +0 -16
  181. package/src/router/fixtures/T3.json +0 -19
  182. package/src/router/fixtures/T4.json +0 -16
  183. package/src/router/fixtures/X1.json +0 -17
  184. package/src/router/fixtures/X2.json +0 -20
  185. package/src/router/gen-design-headings.mjs +0 -107
  186. package/src/router/policies/owner-rulings-2026-11-03.json +0 -62
  187. package/test/activity-realtime.test.mjs +0 -959
  188. package/test/activity-stream.test.mjs +0 -512
  189. package/test/auto-recall.test.mjs +0 -474
  190. package/test/auto-truncate.test.mjs +0 -931
  191. package/test/autobind.test.mjs +0 -399
  192. package/test/bus.test.mjs +0 -1572
  193. package/test/cli-guard.test.mjs +0 -198
  194. package/test/conclusion.test.mjs +0 -408
  195. package/test/config-schema.test.mjs +0 -210
  196. package/test/d6-output.test.mjs +0 -194
  197. package/test/d6.test.mjs +0 -395
  198. package/test/deps.test.mjs +0 -342
  199. package/test/doctor-setup.test.mjs +0 -297
  200. package/test/embedding-recall.test.mjs +0 -347
  201. package/test/feature-flags.test.mjs +0 -585
  202. package/test/filter-shadow.test.mjs +0 -170
  203. package/test/fixtures/activity-append-child.mjs +0 -29
  204. package/test/fixtures/baseline-0.8.0-registration.json +0 -556
  205. package/test/fixtures/d6-header-tools.json +0 -1
  206. package/test/fixtures/lock-child.mjs +0 -67
  207. package/test/fixtures/pre-step-container.mjs +0 -100
  208. package/test/fixtures/privacy-memory/topics/pii-unmarked.md +0 -9
  209. package/test/fixtures/privacy-memory/topics/secret-local-only.md +0 -11
  210. package/test/fixtures/profile-session-longlive-config.json +0 -20
  211. package/test/fixtures/proposal-cas-child.mjs +0 -66
  212. package/test/host-engine-status.test.mjs +0 -307
  213. package/test/hot-truncate.test.mjs +0 -1349
  214. package/test/identity-card-marker.test.mjs +0 -307
  215. package/test/identity-router/run.mjs +0 -721
  216. package/test/integration-pre-step.test.mjs +0 -553
  217. package/test/live.test.mjs +0 -1023
  218. package/test/maintenance-schedule.test.mjs +0 -538
  219. package/test/memory.test.mjs +0 -2828
  220. package/test/metrics.test.mjs +0 -478
  221. package/test/orchestrator.test.mjs +0 -266
  222. package/test/p1_probe.mjs +0 -97
  223. package/test/packaging.test.mjs +0 -184
  224. package/test/portability.test.mjs +0 -343
  225. package/test/rc4-regressions.test.mjs +0 -562
  226. package/test/rc5-regressions.test.mjs +0 -197
  227. package/test/rc6-chinese.test.mjs +0 -394
  228. package/test/router-1100/apply-off.test.mjs +0 -175
  229. package/test/router-1100/budget-reconcile.test.mjs +0 -215
  230. package/test/router-1100/config-context.test.mjs +0 -211
  231. package/test/router-1100/helpers.mjs +0 -129
  232. package/test/router-1100/hint-envelope.test.mjs +0 -150
  233. package/test/router-1100/lock-crossproc.test.mjs +0 -206
  234. package/test/router-1100/proposal-cas-crossproc.test.mjs +0 -184
  235. package/test/router-1100/router-apply.test.mjs +0 -372
  236. package/test/router-1100/router-fixb.test.mjs +0 -602
  237. package/test/router-1100/router-proposals.test.mjs +0 -405
  238. package/test/router-1100/router-queue-lease-wal.test.mjs +0 -355
  239. package/test/router-1100/router-security-cr.test.mjs +0 -333
  240. package/test/router-1100/service-lifecycle.test.mjs +0 -220
  241. package/test/router-1100/tools-contract.test.mjs +0 -164
  242. package/test/router-1100/turn-reflect-tick.test.mjs +0 -89
  243. package/test/router-1100/v6-contract.test.mjs +0 -158
  244. package/test/router-1100/v6b-contract.test.mjs +0 -293
  245. package/test/router-1100/v6c-contract.test.mjs +0 -249
  246. package/test/router-1100/wal-rotation.test.mjs +0 -375
  247. package/test/router-1100/wp1-config.test.mjs +0 -170
  248. package/test/router-1100/wp1-default-off.test.mjs +0 -77
  249. package/test/router-1100/wp1-model-status.test.mjs +0 -90
  250. package/test/router-1100/wp1-status.test.mjs +0 -220
  251. package/test/router-1100/wp1-tools.test.mjs +0 -146
  252. package/test/router-1100/wp5-cli.test.mjs +0 -240
  253. package/test/router-1100/wp5-model-auto.test.mjs +0 -418
  254. package/test/router-1100/wp6-merge.test.mjs +0 -386
  255. package/test/router-1100/wp6-wake.test.mjs +0 -502
  256. package/test/router-background/audit.test.mjs +0 -37
  257. package/test/router-background/budget-ledger.test.mjs +0 -330
  258. package/test/router-background/cross-process.test.mjs +0 -222
  259. package/test/router-background/fixtures/cross-child.mjs +0 -85
  260. package/test/router-background/fixtures/real-shapes.mjs +0 -239
  261. package/test/router-background/router.test.mjs +0 -1076
  262. package/test/router-background/stream-retry.test.mjs +0 -358
  263. package/test/router-background/tool-agent.test.mjs +0 -384
  264. package/test/router-face/bridge.test.mjs +0 -169
  265. package/test/router-face/face.test.mjs +0 -316
  266. package/test/router-failclosed.test.mjs +0 -466
  267. package/test/router-identity.test.mjs +0 -384
  268. package/test/router-l1-l2.contract.test.mjs +0 -1075
  269. package/test/router-memory-tools.test.mjs +0 -262
  270. package/test/router-policy.test.mjs +0 -225
  271. package/test/router-runtime.test.mjs +0 -438
  272. package/test/router-shadow.test.mjs +0 -287
  273. package/test/router.test.mjs +0 -903
  274. package/test/run-rc.mjs +0 -315
  275. package/test/run.mjs +0 -2469
  276. package/test/safety-defaults.test.mjs +0 -181
  277. package/test/seeded-load.test.mjs +0 -436
  278. package/test/session-original.test.mjs +0 -338
  279. package/test/state-truth.test.mjs +0 -937
  280. package/test/surgery-recovery.test.mjs +0 -936
  281. package/test/t7_drive.mjs +0 -151
  282. package/test/tool-output.test.mjs +0 -393
  283. package/test/tool-schema.test.mjs +0 -177
  284. package/test/tools_contract.test.mjs +0 -716
  285. package/test/truncate-visible.test.mjs +0 -1150
  286. package/test/ui-flags.test.mjs +0 -477
  287. package/test/v4-hardening.test.mjs +0 -427
  288. package/test/version-consistency.test.mjs +0 -286
@@ -1,239 +0,0 @@
1
- // test/fixtures/real-shapes.mjs — 从真宿主源码抽出的对象形状
2
- //
3
- // 这些 fixture 不是「另一个 sim」:字段名、类型、可调用位置都按
4
- // 宿主 checkout 下的真实实现来:
5
- // - dsh-tools: view(scope).restrictableNames 是 Set;service 无该属性;
6
- // restrict({allow?, deny?});execute(exec) 收单个对象
7
- // - dsh-agent-loop / dsh-agent: agents.create() -> { agent, dispose };
8
- // agent.followup(durableMessage) / agent.whenIdle() / agent.cancel(cause)
9
- // - dsh-llm: createUserMessage 产出带 id 的 durable message
10
- //
11
- // 测试里凡是「断言 router 不依赖 sim 私有形状」的地方都用这里。
12
-
13
- import { randomUUID } from 'node:crypto';
14
- import assert from 'node:assert/strict';
15
-
16
- /** 真实 register() 需要的完整定义(output.render 必填)。 */
17
- export function tool(name, execute = () => `ok:${name}`) {
18
- return {
19
- name,
20
- description: `${name} fixture`,
21
- parameters: { type: 'object', properties: {} },
22
- output: { schema: { type: 'object' }, render: () => 'ok' },
23
- execute,
24
- };
25
- }
26
-
27
- /** 与 dsh-llm createUserMessage 同形状:content 是 block 数组,且带 id。 */
28
- export function durableUserMessage(text, source = { kind: 'user' }) {
29
- return {
30
- id: `msg-${randomUUID()}`,
31
- role: 'user',
32
- content: [{ type: 'text', text: String(text ?? '') }],
33
- source,
34
- };
35
- }
36
-
37
- /**
38
- * tools 服务的真实表面:restrictableNames 只在 view(scope) 上,是 Set。
39
- * 传入 names 时会被当作「可 restrict 的已注册工具」全集(run_code 除外)。
40
- */
41
- export function realToolSurface({ names = [], scope = null } = {}) {
42
- const known = new Set(names.filter((name) => name !== 'run_code'));
43
- const state = { filter: null, guards: [], calls: [], restrictCalls: 0, disposers: 0 };
44
- const visible = new Map(names.map((name) => [name, { name, execute: () => `ok:${name}` }]));
45
-
46
- const surface = {
47
- state,
48
- view(requested) {
49
- if (scope !== null) assert.equal(requested, scope, 'view() must be called with the agent scope');
50
- return {
51
- visible: new Map(visible),
52
- knownNames: new Set(names),
53
- restrictableNames: new Set(known),
54
- };
55
- },
56
- restrict(filter) {
57
- // 真宿主 :2996-2999:两个都不给才报错;空 deny 合法。
58
- assert.ok(filter && (filter.allow !== undefined || filter.deny !== undefined),
59
- 'restrict() needs allow and/or deny');
60
- for (const name of [...(filter.allow ?? []), ...(filter.deny ?? [])]) {
61
- assert.notEqual(name, 'run_code', 'run_code cannot be named in restrict()');
62
- assert.ok(known.has(name), `restrict() got unknown name ${name}`);
63
- }
64
- state.restrictCalls += 1;
65
- state.filter = {
66
- allow: filter.allow === undefined ? null : new Set(filter.allow),
67
- deny: filter.deny === undefined ? null : new Set(filter.deny),
68
- };
69
- let disposed = false;
70
- return () => {
71
- if (disposed) return;
72
- disposed = true;
73
- state.disposers += 1;
74
- state.filter = null;
75
- };
76
- },
77
- guard(fn) {
78
- assert.equal(typeof fn, 'function');
79
- state.guards.push(fn);
80
- return () => {
81
- const index = state.guards.indexOf(fn);
82
- if (index >= 0) state.guards.splice(index, 1);
83
- state.disposers += 1;
84
- };
85
- },
86
- guardReason(exec) {
87
- for (const fn of state.guards) {
88
- const reason = fn(exec);
89
- if (typeof reason === 'string' && reason.length > 0) return reason;
90
- }
91
- return undefined;
92
- },
93
- execute(exec) {
94
- assert.equal(typeof exec, 'object');
95
- assert.equal(typeof exec.name, 'string', 'execute(exec) takes a single object with name/args/agent');
96
- const filter = state.filter;
97
- if (filter?.allow && !filter.allow.has(exec.name)) {
98
- throw Object.assign(new Error(`restricted: ${exec.name}`), { code: 'E_TOOL_DENIED' });
99
- }
100
- if (filter?.deny?.has(exec.name)) {
101
- throw Object.assign(new Error(`restricted: ${exec.name}`), { code: 'E_TOOL_DENIED' });
102
- }
103
- const reason = surface.guardReason(exec);
104
- if (reason) throw Object.assign(new Error(reason), { code: 'E_TOOL_DENIED' });
105
- state.calls.push(exec.name);
106
- return `ok:${exec.name}`;
107
- },
108
- };
109
- return surface;
110
- }
111
-
112
- /** 真宿主的降级形状:service 上既没有 view() 也没有 restrictableNames。 */
113
- export function realToolSurfaceWithoutNames() {
114
- const state = { filter: null, guards: [], calls: [] };
115
- return {
116
- state,
117
- restrict(filter) {
118
- assert.ok(filter && (filter.allow !== undefined || filter.deny !== undefined));
119
- state.filter = { allow: filter.allow ?? null, deny: filter.deny ?? null };
120
- return () => { state.filter = null; };
121
- },
122
- guard(fn) {
123
- state.guards.push(fn);
124
- return () => {};
125
- },
126
- guardReason(exec) {
127
- for (const fn of state.guards) {
128
- const reason = fn(exec);
129
- if (typeof reason === 'string' && reason.length > 0) return reason;
130
- }
131
- return undefined;
132
- },
133
- execute(exec) {
134
- if (state.filter?.deny?.includes(exec.name)) {
135
- throw Object.assign(new Error(`restricted: ${exec.name}`), { code: 'E_TOOL_DENIED' });
136
- }
137
- state.calls.push(exec.name);
138
- return `ok:${exec.name}`;
139
- },
140
- };
141
- }
142
-
143
- /**
144
- * 真宿主 agents 服务的最小形状:create() -> { agent, dispose }。
145
- * agent.status 只有 idle|running;没有 result;回答从 session.deriveMessages() 取。
146
- */
147
- export function makeRealAgents({ behavior = null, disposeDelayMs = 0, disposeNever = false } = {}) {
148
- let seq = 0;
149
- const entries = [];
150
- const announcements = [];
151
- const agents = {
152
- announcements,
153
- entries,
154
- created: [],
155
- createCalls: 0,
156
- async create({ sessionId = `real-${++seq}`, agentOptions = {}, setup = null, signal = null } = {}) {
157
- agents.createCalls += 1;
158
- const id = `real-agent-${++seq}`;
159
- const session = {
160
- messages: [],
161
- deriveMessages() { return this.messages.map((message) => ({ ...message })); },
162
- };
163
- const agent = {
164
- id,
165
- sessionId,
166
- agentOptions,
167
- status: 'idle',
168
- session,
169
- cancelled: null,
170
- followupCalls: 0,
171
- disposed: false,
172
- };
173
- agent.ctx = { agent, tools: null, sessions: { announce: (event) => announcements.push(event) } };
174
-
175
- if (typeof setup === 'function') await setup(agent.ctx, agent);
176
-
177
- agent.followup = async (input) => {
178
- assert.equal(typeof input, 'object');
179
- assert.equal(typeof input.id, 'string', 'followup() requires a durable message with id');
180
- assert.ok(Array.isArray(input.content), 'followup() requires block content');
181
- agent.followupCalls += 1;
182
- agent.status = 'running';
183
- session.messages.push(input);
184
- try {
185
- if (typeof behavior === 'function') await behavior({ agent, ctx: agent.ctx, input });
186
- } finally {
187
- agent.status = 'idle';
188
- }
189
- return undefined;
190
- };
191
- agent.whenIdle = async () => {
192
- while (agent.status !== 'idle') await new Promise((resolve) => setTimeout(resolve, 1));
193
- };
194
- agent.cancel = async (cause = 'cancelled') => {
195
- agent.cancelled = cause;
196
- agent.status = 'idle';
197
- return true;
198
- };
199
-
200
- const dispose = async () => {
201
- if (agent.disposed) return;
202
- if (disposeNever) return new Promise(() => {});
203
- if (disposeDelayMs > 0) await new Promise((resolve) => setTimeout(resolve, disposeDelayMs));
204
- agents.finish(agent);
205
- };
206
-
207
- agents.created.push(agent);
208
- announcements.push({ type: 'agent.created', agentId: id });
209
- return { agent, dispose };
210
- },
211
- finish(agent) {
212
- agent.disposed = true;
213
- agent.status = 'idle';
214
- },
215
- forceDispose(agentOrId) {
216
- const agent = typeof agentOrId === 'string'
217
- ? agents.created.find((item) => item.id === agentOrId)
218
- : agentOrId;
219
- if (!agent) return { ok: false, code: 'E_AGENT_UNKNOWN' };
220
- // 和 host-sim 一样留下可观察的痕迹:调用方要能看见「它曾经卡在 dispose」。
221
- agent.stuck = true;
222
- agents.finish(agent);
223
- return { ok: true, agentId: agent.id };
224
- },
225
- reap() {
226
- const reaped = [];
227
- for (const agent of agents.created) {
228
- if (!agent.disposed) {
229
- agents.finish(agent);
230
- reaped.push(agent.id);
231
- }
232
- }
233
- return { ok: true, reaped };
234
- },
235
- get(id) { return agents.created.find((agent) => agent.id === id); },
236
- list() { return agents.created.filter((agent) => !agent.disposed); },
237
- };
238
- return agents;
239
- }