@jjh32456/dsh-longlive 1.6.7 → 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 (289) hide show
  1. package/CHANGELOG.md +70 -1508
  2. package/LICENSE +1 -1
  3. package/QUICKSTART.md +34 -13
  4. package/README.en.md +18 -7
  5. package/README.md +34 -9
  6. package/SPEC.md +5 -5
  7. package/cordis.patch.yml +23 -9
  8. package/docs/ANSWER-GUARD.md +92 -0
  9. package/docs/ARCHITECTURE.md +4 -3
  10. package/docs/AUTO-RECALL-WIRING.md +1 -1
  11. package/docs/AUTO-RECALL.md +15 -9
  12. package/docs/CONFIG.md +168 -35
  13. package/docs/ERRORS.md +17 -5
  14. package/docs/FAQ.md +7 -7
  15. package/docs/FEATURES.md +96 -28
  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 +4 -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 +47 -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 +760 -0
  41. package/src/activity/model.js +351 -0
  42. package/src/activity/store.js +644 -0
  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 +171 -47
  58. package/src/deps.js +6 -4
  59. package/src/features.js +182 -6
  60. package/src/heartbeat.js +156 -23
  61. package/src/identity/handover.js +52 -1
  62. package/src/identity/index.js +13 -5
  63. package/src/identity/inject-position.js +2 -2
  64. package/src/index.js +97 -7
  65. package/src/lifecycle/gap-clocks.js +328 -0
  66. package/src/lifecycle/index.js +269 -0
  67. package/src/live.js +22 -2
  68. package/src/memory/activity-capture.js +229 -0
  69. package/src/memory/anchors.js +194 -0
  70. package/src/memory/audit-records.js +222 -0
  71. package/src/memory/auto-cards.js +401 -0
  72. package/src/memory/capture.js +442 -0
  73. package/src/memory/card-anchors.js +203 -0
  74. package/src/memory/conflicts.js +106 -0
  75. package/src/memory/decay.js +311 -0
  76. package/src/memory/distill.js +471 -0
  77. package/src/memory/event-index.js +917 -0
  78. package/src/memory/evidence-chain.js +295 -0
  79. package/src/memory/evidence.js +145 -0
  80. package/src/memory/filter-runner.js +1 -1
  81. package/src/memory/filter.js +5 -1
  82. package/src/memory/forget-v2.js +410 -0
  83. package/src/memory/forget.js +71 -0
  84. package/src/memory/frames-activation.js +247 -0
  85. package/src/memory/fts-query.js +174 -0
  86. package/src/memory/governance.js +604 -0
  87. package/src/memory/index.js +1 -0
  88. package/src/memory/l2-gate.js +169 -0
  89. package/src/memory/lock.js +121 -0
  90. package/src/memory/migrate.js +139 -0
  91. package/src/memory/recall-v2.js +223 -0
  92. package/src/memory/recall.js +65 -2
  93. package/src/memory/records.js +425 -0
  94. package/src/memory/retention.js +128 -0
  95. package/src/memory/review.js +124 -0
  96. package/src/memory/trust.js +88 -0
  97. package/src/memory/version-chain.js +264 -0
  98. package/src/memory/wal.js +137 -0
  99. package/src/memory/working-frame.js +516 -0
  100. package/src/metrics/classify.mjs +5 -3
  101. package/src/metrics/index.mjs +21 -1
  102. package/src/metrics/prestep-latency.mjs +300 -0
  103. package/src/metrics/store.mjs +25 -0
  104. package/src/policy-profile.js +18 -3
  105. package/src/recall/anaphora.mjs +87 -0
  106. package/src/recall/cards.mjs +7 -0
  107. package/src/recall/embedding.mjs +8 -8
  108. package/src/recall/entities.mjs +112 -0
  109. package/src/recall/index.js +235 -19
  110. package/src/recall/inject-order.mjs +10 -8
  111. package/src/recall/privacy.mjs +105 -16
  112. package/src/recall/recall-core.mjs +116 -10
  113. package/src/recall/shared-visibility.js +302 -0
  114. package/src/recall/time-normalizer.mjs +196 -0
  115. package/src/role/activation.js +191 -0
  116. package/src/role/attention.js +318 -0
  117. package/src/role/base.js +36 -0
  118. package/src/role/channels.js +423 -0
  119. package/src/role/index.js +425 -0
  120. package/src/role/interfaces.js +115 -0
  121. package/src/role/personality.js +370 -0
  122. package/src/role/readers.js +151 -0
  123. package/src/role/relationships.js +477 -0
  124. package/src/role/store.js +202 -0
  125. package/src/role/writeprotect.js +373 -0
  126. package/src/router/aliases.json +176 -25
  127. package/src/router/background/agent-runner.mjs +1 -1
  128. package/src/router/background/anchor.mjs +1 -1
  129. package/src/router/background/audit.mjs +2 -2
  130. package/src/router/background/budget-ledger.mjs +2 -2
  131. package/src/router/background/host-sim.mjs +1 -1
  132. package/src/router/background/memory.mjs +4 -4
  133. package/src/router/background/queue.mjs +1 -1
  134. package/src/router/background/retry.mjs +1 -1
  135. package/src/router/background/router.mjs +1 -1
  136. package/src/router/background/stream.mjs +1 -1
  137. package/src/router/background/tool-policy.mjs +1 -1
  138. package/src/router/design-headings.json +5 -5
  139. package/src/router/face/config.mjs +1 -1
  140. package/src/router/face/identity.mjs +3 -3
  141. package/src/router/judge.mjs +8 -7
  142. package/src/router/policies/generic.json +21 -4
  143. package/src/router/route.js +109 -22
  144. package/src/router/router.mjs +10 -6
  145. package/src/router/routing-rules.json +260 -445
  146. package/src/router/run-sim.mjs +8 -8
  147. package/src/router/runtime.js +23 -12
  148. package/src/router/service/board.mjs +95 -15
  149. package/src/router/service/config.mjs +5 -5
  150. package/src/router/service/context.mjs +1 -1
  151. package/src/router/service/hint.mjs +14 -0
  152. package/src/router/service/queue.mjs +1 -1
  153. package/src/router/service/service.mjs +27 -11
  154. package/src/router/shadow.mjs +4 -3
  155. package/src/surgery-recovery.js +2 -2
  156. package/src/tool-output.js +2 -2
  157. package/src/tools.js +39 -7
  158. package/src/truncate-visible.js +2 -2
  159. package/src/ui/actions.js +1312 -0
  160. package/src/ui/panel-api.js +367 -0
  161. package/src/ui/panel-auth.js +251 -0
  162. package/src/ui/panel-integrity.js +243 -0
  163. package/src/ui/routes-readonly.js +695 -0
  164. package/src/ui/routes.js +3 -0
  165. package/docs/DEV.md +0 -279
  166. package/docs/PRESENCE-BUS-WIRING.md +0 -491
  167. package/docs/PRESENCE-BUS.md +0 -694
  168. package/docs/SURGERY.md +0 -186
  169. package/scripts/mark-core-cards.mjs +0 -289
  170. package/scripts/pack.mjs +0 -392
  171. package/scripts/router-proposals.mjs +0 -386
  172. package/src/router/fixtures/M1.json +0 -16
  173. package/src/router/fixtures/M2.json +0 -16
  174. package/src/router/fixtures/M3.json +0 -20
  175. package/src/router/fixtures/M4.json +0 -20
  176. package/src/router/fixtures/M5.json +0 -45
  177. package/src/router/fixtures/M6.json +0 -53
  178. package/src/router/fixtures/M7.json +0 -46
  179. package/src/router/fixtures/S1.json +0 -20
  180. package/src/router/fixtures/S2.json +0 -23
  181. package/src/router/fixtures/S3.json +0 -20
  182. package/src/router/fixtures/S4.json +0 -34
  183. package/src/router/fixtures/S5.json +0 -43
  184. package/src/router/fixtures/S6.json +0 -47
  185. package/src/router/fixtures/T1.json +0 -23
  186. package/src/router/fixtures/T2.json +0 -16
  187. package/src/router/fixtures/T3.json +0 -19
  188. package/src/router/fixtures/T4.json +0 -16
  189. package/src/router/fixtures/X1.json +0 -17
  190. package/src/router/fixtures/X2.json +0 -20
  191. package/src/router/gen-design-headings.mjs +0 -107
  192. package/src/router/policies/owner-rulings-2026-11-03.json +0 -62
  193. package/test/auto-recall.test.mjs +0 -474
  194. package/test/auto-truncate.test.mjs +0 -931
  195. package/test/autobind.test.mjs +0 -385
  196. package/test/bus.test.mjs +0 -1572
  197. package/test/cli-guard.test.mjs +0 -198
  198. package/test/conclusion.test.mjs +0 -408
  199. package/test/config-schema.test.mjs +0 -204
  200. package/test/d6-output.test.mjs +0 -194
  201. package/test/d6.test.mjs +0 -395
  202. package/test/deps.test.mjs +0 -342
  203. package/test/doctor-setup.test.mjs +0 -297
  204. package/test/embedding-recall.test.mjs +0 -347
  205. package/test/feature-flags.test.mjs +0 -568
  206. package/test/filter-shadow.test.mjs +0 -170
  207. package/test/fixtures/baseline-0.8.0-registration.json +0 -556
  208. package/test/fixtures/d6-header-tools.json +0 -1
  209. package/test/fixtures/lock-child.mjs +0 -67
  210. package/test/fixtures/pre-step-container.mjs +0 -100
  211. package/test/fixtures/privacy-memory/topics/pii-unmarked.md +0 -9
  212. package/test/fixtures/privacy-memory/topics/secret-local-only.md +0 -11
  213. package/test/fixtures/profile-session-longlive-config.json +0 -20
  214. package/test/fixtures/proposal-cas-child.mjs +0 -66
  215. package/test/host-engine-status.test.mjs +0 -307
  216. package/test/hot-truncate.test.mjs +0 -1349
  217. package/test/identity-card-marker.test.mjs +0 -307
  218. package/test/identity-router/run.mjs +0 -721
  219. package/test/integration-pre-step.test.mjs +0 -553
  220. package/test/live.test.mjs +0 -1020
  221. package/test/maintenance-schedule.test.mjs +0 -538
  222. package/test/memory.test.mjs +0 -2828
  223. package/test/metrics.test.mjs +0 -478
  224. package/test/orchestrator.test.mjs +0 -266
  225. package/test/p1_probe.mjs +0 -97
  226. package/test/packaging.test.mjs +0 -182
  227. package/test/portability.test.mjs +0 -343
  228. package/test/rc4-regressions.test.mjs +0 -562
  229. package/test/rc5-regressions.test.mjs +0 -197
  230. package/test/rc6-chinese.test.mjs +0 -394
  231. package/test/router-1100/apply-off.test.mjs +0 -175
  232. package/test/router-1100/budget-reconcile.test.mjs +0 -215
  233. package/test/router-1100/config-context.test.mjs +0 -211
  234. package/test/router-1100/helpers.mjs +0 -129
  235. package/test/router-1100/hint-envelope.test.mjs +0 -150
  236. package/test/router-1100/lock-crossproc.test.mjs +0 -206
  237. package/test/router-1100/proposal-cas-crossproc.test.mjs +0 -184
  238. package/test/router-1100/router-apply.test.mjs +0 -372
  239. package/test/router-1100/router-fixb.test.mjs +0 -602
  240. package/test/router-1100/router-proposals.test.mjs +0 -405
  241. package/test/router-1100/router-queue-lease-wal.test.mjs +0 -355
  242. package/test/router-1100/router-security-cr.test.mjs +0 -333
  243. package/test/router-1100/service-lifecycle.test.mjs +0 -220
  244. package/test/router-1100/tools-contract.test.mjs +0 -164
  245. package/test/router-1100/turn-reflect-tick.test.mjs +0 -89
  246. package/test/router-1100/v6-contract.test.mjs +0 -158
  247. package/test/router-1100/v6b-contract.test.mjs +0 -293
  248. package/test/router-1100/v6c-contract.test.mjs +0 -249
  249. package/test/router-1100/wal-rotation.test.mjs +0 -375
  250. package/test/router-1100/wp1-config.test.mjs +0 -170
  251. package/test/router-1100/wp1-default-off.test.mjs +0 -77
  252. package/test/router-1100/wp1-model-status.test.mjs +0 -90
  253. package/test/router-1100/wp1-status.test.mjs +0 -220
  254. package/test/router-1100/wp1-tools.test.mjs +0 -146
  255. package/test/router-1100/wp5-cli.test.mjs +0 -240
  256. package/test/router-1100/wp5-model-auto.test.mjs +0 -418
  257. package/test/router-1100/wp6-merge.test.mjs +0 -386
  258. package/test/router-1100/wp6-wake.test.mjs +0 -502
  259. package/test/router-background/audit.test.mjs +0 -37
  260. package/test/router-background/budget-ledger.test.mjs +0 -330
  261. package/test/router-background/cross-process.test.mjs +0 -222
  262. package/test/router-background/fixtures/cross-child.mjs +0 -85
  263. package/test/router-background/fixtures/real-shapes.mjs +0 -239
  264. package/test/router-background/router.test.mjs +0 -1044
  265. package/test/router-background/stream-retry.test.mjs +0 -358
  266. package/test/router-background/tool-agent.test.mjs +0 -384
  267. package/test/router-face/bridge.test.mjs +0 -169
  268. package/test/router-face/face.test.mjs +0 -316
  269. package/test/router-failclosed.test.mjs +0 -466
  270. package/test/router-identity.test.mjs +0 -384
  271. package/test/router-l1-l2.contract.test.mjs +0 -1075
  272. package/test/router-memory-tools.test.mjs +0 -262
  273. package/test/router-policy.test.mjs +0 -225
  274. package/test/router-runtime.test.mjs +0 -438
  275. package/test/router-shadow.test.mjs +0 -287
  276. package/test/router.test.mjs +0 -903
  277. package/test/run-rc.mjs +0 -299
  278. package/test/run.mjs +0 -2469
  279. package/test/safety-defaults.test.mjs +0 -179
  280. package/test/seeded-load.test.mjs +0 -436
  281. package/test/session-original.test.mjs +0 -338
  282. package/test/surgery-recovery.test.mjs +0 -936
  283. package/test/t7_drive.mjs +0 -151
  284. package/test/tool-output.test.mjs +0 -393
  285. package/test/tool-schema.test.mjs +0 -177
  286. package/test/tools_contract.test.mjs +0 -716
  287. package/test/truncate-visible.test.mjs +0 -1150
  288. package/test/ui-flags.test.mjs +0 -477
  289. package/test/v4-hardening.test.mjs +0 -427
@@ -1,385 +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/start 与 turn/end:只刷新已绑定行,其他会话一律忽略', () => {
286
- const root = newRoot(TMP, 'turns');
287
- seedRow(root, 'mine');
288
- seedRow(root, 'other');
289
- const beforeOther = fileSha(rowPath(root, 'other'));
290
- const beat = createAutoHeartbeat({
291
- memoryRoot: root,
292
- heartbeatMs: 0,
293
- ctx: null,
294
- resolve: () => ({ id: 'mine', source: 'exec.agent' }),
295
- });
296
- beat.bind('mine');
297
- // heartbeatMs:0 disables writes by contract; flip it on for this case by
298
- // rebuilding with a real interval but no timer (start() not called).
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
- live.onSessionEvent({ id: 'other' }, { type: 'turn/end', data: { turn: 3 } });
307
- assert(fileSha(rowPath(root, 'other')) === beforeOther, 'other row untouched');
308
- live.onSessionEvent({ id: 'mine' }, { type: 'turn/start', data: { turn: 4 } });
309
- const afterStart = readRow(root, 'mine');
310
- assert(afterStart.last_action.detail === 'turn/start #4', afterStart.last_action.detail);
311
- live.onSessionEvent({ id: 'mine' }, { type: 'turn/end', data: { turn: 4 } });
312
- const afterEnd = readRow(root, 'mine');
313
- assert(afterEnd.last_action.detail === 'turn/end #4', afterEnd.last_action.detail);
314
- assert(beat.boundIds().join(',') === 'mine', 'disabled manager still binds');
315
- return 'turn boundaries refresh only the bound row';
316
- });
317
-
318
- runCase('AB14', '兜底定时器:默认 15s、unref、只刷心跳不动 last_action、stop 后清掉', () => {
319
- const root = newRoot(TMP, 'timer');
320
- seedRow(root, 'mine');
321
- const before = readRow(root, 'mine');
322
- let captured = null;
323
- let capturedMs = 0;
324
- let cleared = null;
325
- let unrefCalled = false;
326
- const listeners = [];
327
- const fakeCtx = {
328
- on: (name, fn) => { listeners.push({ name, fn }); return () => { cleared = 'listener'; }; },
329
- };
330
- const beat = createAutoHeartbeat({
331
- memoryRoot: root,
332
- ctx: fakeCtx,
333
- now: () => NOW + 30_000,
334
- setInterval: (fn, ms) => {
335
- captured = fn;
336
- capturedMs = ms;
337
- return { unref: () => { unrefCalled = true; } };
338
- },
339
- clearInterval: (timer) => { cleared = timer; },
340
- });
341
- assert(beat.intervalMs() === DEFAULT_HEARTBEAT_MS, `${beat.intervalMs()}`);
342
- const started = beat.start();
343
- assert(started === true, 'started');
344
- assert(capturedMs === DEFAULT_HEARTBEAT_MS, `ms=${capturedMs}`);
345
- assert(unrefCalled === true, 'timer.unref() called');
346
- assert(listeners.length === 1 && listeners[0].name === 'session/event', 'session/event subscribed');
347
- beat.bind('mine');
348
- captured();
349
- const after = readRow(root, 'mine');
350
- assert(after.heartbeatAt === new Date(NOW + 30_000).toISOString(), after.heartbeatAt);
351
- assert(JSON.stringify(after.last_action) === JSON.stringify(before.last_action), 'timer keeps last_action');
352
- const timer = beat.stop();
353
- assert(timer === true && cleared != null, 'stop clears timer');
354
- assert(beat.start() === false, 'cannot restart after stop');
355
- return `${capturedMs}ms, unref, one tick, stop`;
356
- });
357
-
358
- runCase('AB15', 'heartbeatMs:0 关闭全部自动写;绑定上限有界', () => {
359
- const root = newRoot(TMP, 'off');
360
- seedRow(root, 'mine');
361
- const before = fileSha(rowPath(root, 'mine'));
362
- let timerCalls = 0;
363
- const beat = createAutoHeartbeat({
364
- memoryRoot: root,
365
- heartbeatMs: 0,
366
- ctx: { on: () => () => {} },
367
- setInterval: () => { timerCalls += 1; return { unref() {} }; },
368
- resolve: () => ({ id: 'mine', source: 'exec.agent' }),
369
- });
370
- assert(beat.isEnabled() === false, 'disabled');
371
- beat.start();
372
- assert(timerCalls === 0, 'no timer when disabled');
373
- assert(beat.autoTouch({}, 'session_live_list') === null, 'no tool touch when disabled');
374
- beat.onSessionEvent({ id: 'mine' }, { type: 'turn/start', data: { turn: 1 } });
375
- assert(fileSha(rowPath(root, 'mine')) === before, 'row bytes unchanged');
376
- for (let i = 0; i < MAX_BOUND_SESSIONS + 10; i += 1) beat.bind(`s-${i}`);
377
- assert(beat.boundIds().length === MAX_BOUND_SESSIONS, `bound=${beat.boundIds().length}`);
378
- return '0 disables writes; bound set capped';
379
- });
380
- }
381
-
382
- export const AUTOBIND_CASES = [
383
- 'AB1', 'AB2', 'AB3', 'AB4', 'AB5', 'AB6', 'AB7', 'AB8',
384
- 'AB9', 'AB10', 'AB11', 'AB12', 'AB13', 'AB14', 'AB15',
385
- ];