@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,399 +0,0 @@
1
- // Auto-binding + auto-heartbeat tests (AB*).
2
- //
3
- // These cases pin the two behaviours added in 0.5.1:
4
- // - identity resolution from the explicit caller Agent (`exec.agent`) with
5
- // every fallback source independent of the host;
6
- // - a heartbeat that only ever refreshes rows this writer bound, preserves
7
- // the row's meaning, and is switchable off with `heartbeatMs: 0`.
8
- //
9
- // Every fixture lives under the harness tmp directory; nothing here writes
10
- // inside the package tree (P6 checks that afterwards).
11
-
12
- import fs from 'node:fs';
13
- import os from 'node:os';
14
- import path from 'node:path';
15
-
16
- import {
17
- resolveCurrentSessionId,
18
- sessionIdOfAgent,
19
- sessionIdOfExec,
20
- } from '../src/identity.js';
21
- import {
22
- LIVE_SCHEMA_VERSION,
23
- LIVE_RECORD_FIELDS,
24
- liveUpdate,
25
- liveTouch,
26
- } from '../src/live.js';
27
- import { createAutoHeartbeat, DEFAULT_HEARTBEAT_MS, MAX_BOUND_SESSIONS } from '../src/heartbeat.js';
28
-
29
- const NOW = Date.parse('2026-05-06T07:08:09.000Z');
30
- const HOST = os.hostname();
31
-
32
- function newRoot(TMP, name) {
33
- const root = fs.mkdtempSync(path.join(TMP, `autobind-${name}-`));
34
- return root;
35
- }
36
-
37
- function rowPath(root, id) {
38
- return path.join(root, '.longlive', 'live', `${id}.json`);
39
- }
40
-
41
- function readRow(root, id) {
42
- return JSON.parse(fs.readFileSync(rowPath(root, id), 'utf8'));
43
- }
44
-
45
- function fileSha(file) {
46
- return fs.readFileSync(file).toString('base64');
47
- }
48
-
49
- /** A complete, realistic row created through the public writer. */
50
- function seedRow(root, id, extra = {}) {
51
- liveUpdate({
52
- sessionId: id,
53
- state: 'blocked',
54
- blocked_on: '等待用户确认',
55
- goal: '验证自动绑定',
56
- queued: ['step-1', 'step-2'],
57
- ...extra,
58
- }, { memoryRoot: root, now: new Date(NOW) });
59
- return readRow(root, id);
60
- }
61
-
62
- function agent(id, { header = true } = {}) {
63
- return header
64
- ? { id, session: { header: { id }, id } }
65
- : { id, session: { id } };
66
- }
67
-
68
- export async function runAutoBindSuite({ runCase, assert, TMP }) {
69
- // ------------------------------------------------------------ identity
70
- runCase('AB1', '身份优先级:exec.agent.session.header.id 压过 initiator / ctx / env', () => {
71
- const ctx = {
72
- get: (name) => (name === 'agents'
73
- ? { currentInitiator: () => agent('initiator-id') }
74
- : null),
75
- agent: agent('ctx-agent-id'),
76
- };
77
- const exec = { agent: agent('exec-id') };
78
- const found = resolveCurrentSessionId({ ctx, exec, env: { DSH_SESSION_ID: 'env-id' } });
79
- assert(found.id === 'exec-id', `id=${found.id}`);
80
- assert(found.source === 'exec.agent', `source=${found.source}`);
81
- return 'exec.agent.session.header.id → exec-id';
82
- });
83
-
84
- runCase('AB2', '身份链:header 缺失时用 agent.session.id,再退到 agent.id', () => {
85
- const sessionOnly = resolveCurrentSessionId({
86
- exec: { agent: { id: 'agent-id', session: { id: 'session-id' } } },
87
- env: {},
88
- });
89
- assert(sessionOnly.id === 'session-id', `session=${sessionOnly.id}`);
90
- assert(sessionOnly.source === 'exec.agent', sessionOnly.source);
91
- const agentOnly = resolveCurrentSessionId({
92
- exec: { agent: { id: 'agent-id-only' } },
93
- env: {},
94
- });
95
- assert(agentOnly.id === 'agent-id-only', `agent=${agentOnly.id}`);
96
- assert(agentOnly.source === 'exec.agent', agentOnly.source);
97
- // Direct helpers must agree with the resolver.
98
- assert(sessionIdOfAgent(agent('a1')) === 'a1', 'sessionIdOfAgent');
99
- assert(sessionIdOfExec({ agent: agent('a2') }) === 'a2', 'sessionIdOfExec');
100
- assert(sessionIdOfAgent(null) === null && sessionIdOfExec(undefined) === null, 'null tolerance');
101
- return 'header → session.id → agent.id';
102
- });
103
-
104
- runCase('AB3', '身份链:无 exec 时用 agents.currentInitiator()', () => {
105
- const ctx = {
106
- get: (name) => (name === 'agents'
107
- ? { currentInitiator: () => agent('initiator-id') }
108
- : null),
109
- };
110
- const found = resolveCurrentSessionId({ ctx, exec: null, env: { DSH_SESSION_ID: 'env-id' } });
111
- assert(found.id === 'initiator-id', `id=${found.id}`);
112
- assert(found.source === 'agents.currentInitiator', `source=${found.source}`);
113
- return 'currentInitiator → initiator-id';
114
- });
115
-
116
- runCase('AB4', '身份链:没有 agents 服务时退到 ctx.agent / ctx.session,再退到 env', () => {
117
- const ctxAgent = { agent: agent('ctx-agent-id') };
118
- const a = resolveCurrentSessionId({ ctx: ctxAgent, env: { DSH_SESSION_ID: 'env-id' } });
119
- assert(a.id === 'ctx-agent-id' && a.source === 'ctx.agent', `${a.id}/${a.source}`);
120
- const ctxSession = { session: { id: 'ctx-session-id' } };
121
- const b = resolveCurrentSessionId({ ctx: ctxSession, env: { DSH_SESSION_ID: 'env-id' } });
122
- assert(b.id === 'ctx-session-id' && b.source === 'ctx.agent', `${b.id}/${b.source}`);
123
- const envOnly = resolveCurrentSessionId({ ctx: null, exec: null, env: { DSH_SESSION_ID: ' env-id ' } });
124
- assert(envOnly.id === 'env-id' && envOnly.source === 'env.DSH_SESSION_ID', `${envOnly.id}/${envOnly.source}`);
125
- const none = resolveCurrentSessionId({ ctx: null, exec: null, env: {} });
126
- assert(none.id === null && none.source === 'none', `${none.id}/${none.source}`);
127
- return 'ctx.agent → ctx.session → env → none';
128
- });
129
-
130
- runCase('AB5', '身份链:坏来源(抛错 / 非字符串 / 纯空白)一律降级,不抛异常', () => {
131
- const ctx = {
132
- get: () => { throw new Error('service disposed'); },
133
- agent: { id: 42, session: { header: { id: 7 } } },
134
- };
135
- const found = resolveCurrentSessionId({
136
- ctx,
137
- exec: { agent: { id: null, session: { header: { id: ' ' } } } },
138
- env: { DSH_SESSION_ID: 'fallback-id' },
139
- });
140
- assert(found.id === 'fallback-id', `id=${found.id}`);
141
- assert(found.source === 'env.DSH_SESSION_ID', found.source);
142
- return 'throwing get() and non-string ids fall through to env';
143
- });
144
-
145
- runCase('AB6', 'live_touch:刷新已存在的行,state/goal/queued/startedAt 原样保留', () => {
146
- const root = newRoot(TMP, 'touch');
147
- seedRow(root, 'row-a');
148
- const before = readRow(root, 'row-a');
149
- const result = liveTouch('row-a', {
150
- memoryRoot: root,
151
- now: new Date(NOW + 5000),
152
- kind: 'tool',
153
- detail: 'longlive 工具调用:session_live_list',
154
- });
155
- assert(result.ok === true && result.status === 'touched', JSON.stringify(result.status));
156
- const after = readRow(root, 'row-a');
157
- assert(after.heartbeatAt === new Date(NOW + 5000).toISOString(), after.heartbeatAt);
158
- assert(after.updatedAt === after.heartbeatAt, 'updatedAt follows heartbeatAt');
159
- assert(after.startedAt === before.startedAt, 'startedAt preserved');
160
- assert(after.state === 'blocked' && after.blocked_on === '等待用户确认', 'state preserved');
161
- assert(after.goal === '验证自动绑定', 'goal preserved');
162
- assert(after.queued.join(',') === 'step-1,step-2', 'queued preserved');
163
- assert(after.last_action.at === after.heartbeatAt, 'last_action.at refreshed');
164
- assert(after.last_action.kind === 'tool', after.last_action.kind);
165
- assert(Object.keys(after).sort().join(',') === LIVE_RECORD_FIELDS.slice().sort().join(','), 'field set stable');
166
- assert(after.schemaVersion === LIVE_SCHEMA_VERSION, 'schema version stable');
167
- return `${after.heartbeatAt} / state=${after.state}`;
168
- });
169
-
170
- runCase('AB7', 'live_touch:行不存在时绝不新建(absent)', () => {
171
- const root = newRoot(TMP, 'absent');
172
- const result = liveTouch('ghost-row', { memoryRoot: root, now: new Date(NOW) });
173
- assert(result.ok === false && result.status === 'absent', JSON.stringify(result));
174
- assert(!fs.existsSync(rowPath(root, 'ghost-row')), 'no file created');
175
- return 'absent, no file';
176
- });
177
-
178
- runCase('AB8', 'live_touch:损坏行原样不动(corrupt,不“修好”也不删)', () => {
179
- const root = newRoot(TMP, 'corrupt');
180
- const file = rowPath(root, 'broken-row');
181
- fs.mkdirSync(path.dirname(file), { recursive: true });
182
- fs.writeFileSync(file, '{ this is not json\n');
183
- const before = fileSha(file);
184
- const result = liveTouch('broken-row', { memoryRoot: root, now: new Date(NOW + 1000) });
185
- assert(result.ok === false && result.status === 'corrupt', JSON.stringify(result));
186
- assert(fileSha(file) === before, 'bytes unchanged');
187
- return 'corrupt, untouched';
188
- });
189
-
190
- runCase('AB9', 'live_touch:lastAction:false 只动心跳时间,last_action 原样', () => {
191
- const root = newRoot(TMP, 'keep-action');
192
- seedRow(root, 'row-b');
193
- const before = readRow(root, 'row-b');
194
- const result = liveTouch('row-b', {
195
- memoryRoot: root,
196
- now: new Date(NOW + 9000),
197
- lastAction: false,
198
- });
199
- assert(result.ok === true, JSON.stringify(result));
200
- const after = readRow(root, 'row-b');
201
- assert(after.heartbeatAt === new Date(NOW + 9000).toISOString(), after.heartbeatAt);
202
- assert(JSON.stringify(after.last_action) === JSON.stringify(before.last_action), 'last_action unchanged');
203
- return 'heartbeat only';
204
- });
205
-
206
- runCase('AB10', 'live_update 无 sessionId:用 exec.agent 自动解析并登记绑定', () => {
207
- const root = newRoot(TMP, 'auto-id');
208
- const boundIds = [];
209
- const result = liveUpdate({ state: 'running', goal: '自动绑定' }, {
210
- memoryRoot: root,
211
- now: new Date(NOW),
212
- exec: { agent: agent('auto-session-id') },
213
- currentSessionId: (exec) => resolveCurrentSessionId({ ctx: null, exec }).id,
214
- onAutoSessionId: (id) => boundIds.push(id),
215
- });
216
- assert(result.ok === true && result.sessionId === 'auto-session-id', `${result.sessionId}`);
217
- assert(fs.existsSync(rowPath(root, 'auto-session-id')), 'row written');
218
- assert(boundIds.join(',') === 'auto-session-id', `bound=${boundIds.join(',')}`);
219
- return 'written + bound';
220
- });
221
-
222
- runCase('AB11', '显式 sessionId 仍优先,且不被当成“当前会话”登记', () => {
223
- const root = newRoot(TMP, 'explicit');
224
- const boundIds = [];
225
- const result = liveUpdate({ sessionId: 'someone-else', state: 'running' }, {
226
- memoryRoot: root,
227
- now: new Date(NOW),
228
- exec: { agent: agent('my-session') },
229
- currentSessionId: (exec) => resolveCurrentSessionId({ ctx: null, exec }).id,
230
- onAutoSessionId: (id) => boundIds.push(id),
231
- });
232
- assert(result.sessionId === 'someone-else', result.sessionId);
233
- assert(boundIds.length === 0, `bound=${boundIds.join(',')}`);
234
- assert(!fs.existsSync(rowPath(root, 'my-session')), 'no row for the caller');
235
- return 'explicit wins, no bind';
236
- });
237
-
238
- // ----------------------------------------------------------- heartbeat
239
- runCase('AB12', '自动心跳:工具调用刷新已绑定行;首次调用自动登记;身份不明不写文件', () => {
240
- const root = newRoot(TMP, 'hb-touch');
241
- seedRow(root, 'mine');
242
- const beat = createAutoHeartbeat({
243
- memoryRoot: root,
244
- now: () => NOW + 1500,
245
- ctx: null,
246
- resolve: () => ({ id: 'mine', source: 'exec.agent' }),
247
- });
248
- const touched = beat.autoTouch({}, 'memory_index');
249
- assert(touched.ok === true && touched.status === 'touched', JSON.stringify(touched));
250
- assert(beat.boundIds().join(',') === 'mine', beat.boundIds().join(','));
251
- const after = readRow(root, 'mine');
252
- assert(after.last_action.kind === 'tool', after.last_action.kind);
253
- assert(after.heartbeatAt === new Date(NOW + 1500).toISOString(), after.heartbeatAt);
254
-
255
- // No row yet: the first tool call is the session's self-registration, so
256
- // `session_live_list` can show "this is me" without a sessionId argument.
257
- const beat2 = createAutoHeartbeat({
258
- memoryRoot: root,
259
- now: () => NOW + 2500,
260
- ctx: null,
261
- resolve: () => ({ id: 'ghost', source: 'exec.agent' }),
262
- });
263
- const ghost = beat2.autoTouch({}, 'session_live_list');
264
- assert(ghost.ok === true && ghost.created === true, JSON.stringify(ghost));
265
- const row = readRow(root, 'ghost');
266
- assert(row.sessionId === 'ghost', row.sessionId);
267
- assert(row.state === 'running', row.state);
268
- assert(row.pid === process.pid, String(row.pid));
269
- assert(row.last_action.kind === 'tool', row.last_action.kind);
270
- assert(row.last_action.detail.includes('session_live_list'), row.last_action.detail);
271
-
272
- // An identity that cannot be resolved writes nothing (no guessed rows).
273
- const beat3 = createAutoHeartbeat({
274
- memoryRoot: root,
275
- ctx: null,
276
- resolve: () => ({ id: null, source: 'none' }),
277
- });
278
- const none = beat3.autoTouch({}, 'memory_index');
279
- assert(none === null, JSON.stringify(none));
280
- assert(fs.readdirSync(path.join(root, '.longlive', 'live')).sort().join(',') === 'ghost.json,mine.json',
281
- 'no row for an unknown caller');
282
- return 'tool touch refreshes; first call registers; unknown identity writes nothing';
283
- });
284
-
285
- runCase('AB13', 'turn 边界:按事件会话维护任意行(含未绑定);tick 仍只刷绑定行', () => {
286
- const root = newRoot(TMP, 'turns');
287
- seedRow(root, 'mine');
288
- seedRow(root, 'other');
289
- const beat = createAutoHeartbeat({
290
- memoryRoot: root,
291
- heartbeatMs: 0,
292
- ctx: null,
293
- resolve: () => ({ id: 'mine', source: 'exec.agent' }),
294
- });
295
- beat.bind('mine');
296
- // heartbeatMs:0 disables the timer/tool touches; turn boundaries are an
297
- // event-driven state machine and keep working for both bound and unbound
298
- // sessions (R4.5: the event itself carries the session id).
299
- const live = createAutoHeartbeat({
300
- memoryRoot: root,
301
- heartbeatMs: DEFAULT_HEARTBEAT_MS,
302
- ctx: null,
303
- now: () => NOW + 2000,
304
- });
305
- live.bind('mine');
306
- const mineBefore = fileSha(rowPath(root, 'mine'));
307
- live.onSessionEvent({ id: 'other' }, { type: 'turn/start', data: { turn: 4 } });
308
- const otherStart = readRow(root, 'other');
309
- assert(otherStart.state === 'running' && otherStart.turn === 4,
310
- `unbound session row must follow turn/start, got ${otherStart.state}/${otherStart.turn}`);
311
- assert(fileSha(rowPath(root, 'mine')) === mineBefore, 'another session event must not touch this row');
312
- live.onSessionEvent({ id: 'mine' }, { type: 'turn/start', data: { turn: 4 } });
313
- const afterStart = readRow(root, 'mine');
314
- assert(afterStart.last_action.detail === 'turn/start #4', afterStart.last_action.detail);
315
- live.onSessionEvent({ id: 'mine' }, { type: 'turn/end', data: { turn: 4 } });
316
- const afterEnd = readRow(root, 'mine');
317
- assert(afterEnd.last_action.detail === 'turn/end #4', afterEnd.last_action.detail);
318
- assert(beat.boundIds().join(',') === 'mine', 'disabled manager still binds');
319
- assert(live.boundIds().join(',') === 'mine', 'turn events maintain rows without binding them');
320
- return 'turn boundaries maintain bound + unbound rows without binding';
321
- });
322
-
323
- runCase('AB14', '兜底定时器:默认 15s、unref、只刷心跳不动 last_action、stop 后清掉', () => {
324
- const root = newRoot(TMP, 'timer');
325
- seedRow(root, 'mine');
326
- const before = readRow(root, 'mine');
327
- let captured = null;
328
- let capturedMs = 0;
329
- let cleared = null;
330
- let unrefCalled = false;
331
- const listeners = [];
332
- const fakeCtx = {
333
- on: (name, fn) => { listeners.push({ name, fn }); return () => { cleared = 'listener'; }; },
334
- };
335
- const beat = createAutoHeartbeat({
336
- memoryRoot: root,
337
- ctx: fakeCtx,
338
- now: () => NOW + 30_000,
339
- setInterval: (fn, ms) => {
340
- captured = fn;
341
- capturedMs = ms;
342
- return { unref: () => { unrefCalled = true; } };
343
- },
344
- clearInterval: (timer) => { cleared = timer; },
345
- });
346
- assert(beat.intervalMs() === DEFAULT_HEARTBEAT_MS, `${beat.intervalMs()}`);
347
- const started = beat.start();
348
- assert(started === true, 'started');
349
- assert(capturedMs === DEFAULT_HEARTBEAT_MS, `ms=${capturedMs}`);
350
- assert(unrefCalled === true, 'timer.unref() called');
351
- assert(listeners.length === 1 && listeners[0].name === 'session/event', 'session/event subscribed');
352
- beat.bind('mine');
353
- captured();
354
- const after = readRow(root, 'mine');
355
- assert(after.heartbeatAt === new Date(NOW + 30_000).toISOString(), after.heartbeatAt);
356
- assert(JSON.stringify(after.last_action) === JSON.stringify(before.last_action), 'timer keeps last_action');
357
- const timer = beat.stop();
358
- assert(timer === true && cleared != null, 'stop clears timer');
359
- assert(beat.start() === false, 'cannot restart after stop');
360
- return `${capturedMs}ms, unref, one tick, stop`;
361
- });
362
-
363
- runCase('AB15', 'heartbeatMs:0 关闭定时心跳与工具写;turn 边界仍维护 state/turn;绑定上限有界', () => {
364
- const root = newRoot(TMP, 'off');
365
- seedRow(root, 'mine');
366
- let timerCalls = 0;
367
- const beat = createAutoHeartbeat({
368
- memoryRoot: root,
369
- heartbeatMs: 0,
370
- now: () => NOW + 3000,
371
- ctx: { on: () => () => {} },
372
- setInterval: () => { timerCalls += 1; return { unref() {} }; },
373
- resolve: () => ({ id: 'mine', source: 'exec.agent' }),
374
- });
375
- assert(beat.isEnabled() === false, 'disabled');
376
- beat.start();
377
- assert(timerCalls === 0, 'no timer when disabled');
378
- assert(beat.autoTouch({}, 'session_live_list') === null, 'no tool touch when disabled');
379
- // R4.3/R4.5: turn boundaries are event driven, so "no fallback timer" must
380
- // not also mean "no live state machine" — and the row does not even need a
381
- // prior bind, because the event itself names the session.
382
- beat.onSessionEvent({ id: 'mine' }, { type: 'turn/start', data: { turn: 1 } });
383
- const afterStart = readRow(root, 'mine');
384
- assert(afterStart.state === 'running' && afterStart.turn === 1,
385
- `turn/start must switch state/turn, got ${afterStart.state}/${afterStart.turn}`);
386
- beat.onSessionEvent({ id: 'mine' }, { type: 'turn/end', data: { turn: 1 } });
387
- const afterEnd = readRow(root, 'mine');
388
- assert(afterEnd.state === 'idle' && afterEnd.turn === 1,
389
- `turn/end must land idle + turn, got ${afterEnd.state}/${afterEnd.turn}`);
390
- for (let i = 0; i < MAX_BOUND_SESSIONS + 10; i += 1) beat.bind(`s-${i}`);
391
- assert(beat.boundIds().length === MAX_BOUND_SESSIONS, `bound=${beat.boundIds().length}`);
392
- return '0 disables timer/tool writes; turn state machine still runs; bound set capped';
393
- });
394
- }
395
-
396
- export const AUTOBIND_CASES = [
397
- 'AB1', 'AB2', 'AB3', 'AB4', 'AB5', 'AB6', 'AB7', 'AB8',
398
- 'AB9', 'AB10', 'AB11', 'AB12', 'AB13', 'AB14', 'AB15',
399
- ];