@sleep2agi/commhub-server 0.9.0-preview.26 → 0.9.0-preview.261

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 (431) hide show
  1. package/README.md +120 -3
  2. package/bin/commhub.ts +93 -9
  3. package/build-info.json +7 -0
  4. package/package.json +10 -8
  5. package/src/ack-create-request-transport.test.ts +182 -0
  6. package/src/ack-create-request.test.ts +52 -8
  7. package/src/admin-delete-network-http.test.ts +228 -0
  8. package/src/admin-networks-http.test.ts +88 -0
  9. package/src/adoption-candidates-http.test.ts +140 -0
  10. package/src/adoption-candidates.ts +158 -0
  11. package/src/agent-access-batch.test.ts +210 -0
  12. package/src/agent-access.ts +487 -0
  13. package/src/agent-acl-groups-http.test.ts +247 -0
  14. package/src/agent-acl-http.test.ts +680 -0
  15. package/src/agent-acl-slice3-http.test.ts +885 -0
  16. package/src/agent-department-http.test.ts +215 -0
  17. package/src/agent-groups-perf.test.ts +223 -0
  18. package/src/agent-notice.ts +48 -0
  19. package/src/agent-team-whoami-http.test.ts +98 -0
  20. package/src/agent-teams-http.test.ts +330 -0
  21. package/src/agent-teams.ts +244 -0
  22. package/src/alias-baseline-2571.test.ts +162 -0
  23. package/src/alias-baseline.ts +113 -0
  24. package/src/alias-filter.test.ts +72 -0
  25. package/src/alias-filter.ts +42 -0
  26. package/src/api-host-supervisors-can-create-nodes.test.ts +350 -0
  27. package/src/api-host-supervisors-fallback.test.ts +6 -7
  28. package/src/api-host-supervisors-runtime-readiness.test.ts +195 -0
  29. package/src/api-nodes-shape.test.ts +131 -4
  30. package/src/auth-abuse-counters.test.ts +144 -0
  31. package/src/auth-abuse-counters.ts +122 -0
  32. package/src/auth-password-change-cli-tokens-http.test.ts +423 -0
  33. package/src/auth-sessions-http.test.ts +260 -0
  34. package/src/auth-validate.test.ts +5 -1
  35. package/src/auth-weak-password-login.test.ts +176 -0
  36. package/src/auth.ts +609 -56
  37. package/src/backfill-node-ids-2664.test.ts +128 -0
  38. package/src/binding-generation-http.test.ts +141 -0
  39. package/src/blocked-exit-on-reply.test.ts +122 -0
  40. package/src/broadcast-fanout-2721.test.ts +149 -0
  41. package/src/broadcast-fanout.ts +117 -0
  42. package/src/build-commit-report-http.test.ts +128 -0
  43. package/src/build-info.test.ts +60 -0
  44. package/src/build-info.ts +85 -0
  45. package/src/chain-attempt-dedup.test.ts +447 -0
  46. package/src/clip.test.ts +36 -0
  47. package/src/clip.ts +48 -0
  48. package/src/clone-node.test.ts +269 -0
  49. package/src/clone-node.ts +289 -0
  50. package/src/codex-config-flags.ts +77 -0
  51. package/src/codex-fork-contract.ts +23 -0
  52. package/src/codex-fork-migration.test.ts +38 -0
  53. package/src/commhub-bin-args.test.ts +85 -0
  54. package/src/config-apply-validate.test.ts +188 -1
  55. package/src/config-apply-validate.ts +222 -3
  56. package/src/cors-origins.test.ts +73 -0
  57. package/src/create-node-blocked-gate.test.ts +365 -0
  58. package/src/create-node-error-domain.test.ts +127 -0
  59. package/src/create-node-network-id.test.ts +91 -0
  60. package/src/create-node-tool-schema.test.ts +49 -0
  61. package/src/create-node-unicode-name.test.ts +126 -0
  62. package/src/create-node-validate.test.ts +199 -7
  63. package/src/create-node-validate.ts +232 -15
  64. package/src/create-node-workdir.test.ts +298 -0
  65. package/src/create-node.ts +88 -23
  66. package/src/daemon-provider-snapshots.test.ts +453 -0
  67. package/src/daemon-provider-snapshots.ts +327 -0
  68. package/src/daemon-token-owner-http.test.ts +346 -0
  69. package/src/dashboard-slash-routing-http.test.ts +109 -0
  70. package/src/db-adapter-guard.test.ts +148 -0
  71. package/src/db-adapter-translate.test.ts +128 -0
  72. package/src/db-adapter.ts +377 -91
  73. package/src/db-timestamp.test.ts +38 -0
  74. package/src/db-timestamp.ts +15 -0
  75. package/src/db.ts +1269 -153
  76. package/src/delivered-without-push.test.ts +140 -0
  77. package/src/department-groups-http.test.ts +209 -0
  78. package/src/department-groups-sync-http.test.ts +328 -0
  79. package/src/department-groups.ts +434 -0
  80. package/src/department-heads-http.test.ts +350 -0
  81. package/src/department-heads.ts +226 -0
  82. package/src/departments-agent-count.test.ts +139 -0
  83. package/src/departments-http.test.ts +185 -0
  84. package/src/departments-mcp-error-domain.test.ts +135 -0
  85. package/src/departments-mcp.test.ts +128 -0
  86. package/src/departments.ts +318 -0
  87. package/src/desktop-message-seam.test.ts +150 -0
  88. package/src/desktop-message.test.ts +368 -0
  89. package/src/dm-file-scope-http.test.ts +178 -0
  90. package/src/empty-node-sweeper.test.ts +104 -0
  91. package/src/empty-node-sweeper.ts +88 -0
  92. package/src/env-transport-gate-http.test.ts +240 -0
  93. package/src/env-transport-gate.ts +80 -0
  94. package/src/env-transport-policy.ts +56 -0
  95. package/src/etag-of.test.ts +57 -0
  96. package/src/event-loop-lag.test.ts +180 -0
  97. package/src/event-loop-lag.ts +201 -0
  98. package/src/expiry-counters.test.ts +187 -0
  99. package/src/expiry-counters.ts +227 -0
  100. package/src/expiry-evidence-db.test.ts +103 -0
  101. package/src/ext-token-shared.test.ts +60 -0
  102. package/src/ext-validation-regression.test.ts +10 -17
  103. package/src/external-schedule-edits-http.test.ts +321 -0
  104. package/src/external-schedule-edits-timestamps.test.ts +64 -0
  105. package/src/external-schedule-edits.ts +327 -0
  106. package/src/file-download-authz-dev-open.test.ts +1 -1
  107. package/src/file-download-authz.test.ts +25 -4
  108. package/src/file-download-date-bucket.test.ts +1 -1
  109. package/src/file-network-scope-dev-open.test.ts +1 -1
  110. package/src/file-network-scope.test.ts +7 -6
  111. package/src/group-membership-events-http.test.ts +264 -0
  112. package/src/group-messages-http.test.ts +483 -0
  113. package/src/group-messages.ts +297 -0
  114. package/src/health-anon-readers.ts +67 -0
  115. package/src/health-host-disk-2756.test.ts +71 -0
  116. package/src/health-redaction.test.ts +1576 -7
  117. package/src/host-supervisor-identity-http.test.ts +152 -0
  118. package/src/host-supervisor-identity.ts +92 -0
  119. package/src/host-supervisors-daemon-version.test.ts +137 -0
  120. package/src/http-gzip.test.ts +94 -0
  121. package/src/http-gzip.ts +112 -0
  122. package/src/hub-catalog-read-http.test.ts +641 -0
  123. package/src/hub-provider-config.test.ts +166 -0
  124. package/src/hub-provider-config.ts +202 -0
  125. package/src/hub-timestamp.test.ts +38 -0
  126. package/src/hub-timestamp.ts +27 -0
  127. package/src/human-dm.ts +215 -0
  128. package/src/human-inbox.ts +42 -0
  129. package/src/inbox-caller.ts +49 -0
  130. package/src/inbox-count-sse.test.ts +318 -0
  131. package/src/inbox-count.ts +29 -0
  132. package/src/index.ts +6 -2
  133. package/src/license-state.test.ts +56 -0
  134. package/src/license-state.ts +48 -0
  135. package/src/lifecycle-error-domain.test.ts +149 -0
  136. package/src/list-ack-error-domain.test.ts +108 -0
  137. package/src/list-host-supervisors.test.ts +15 -4
  138. package/src/mcp-context-cost-http.test.ts +127 -0
  139. package/src/mcp-inflight.test.ts +92 -0
  140. package/src/mcp-inflight.ts +38 -0
  141. package/src/mcp-projects-events-http.test.ts +168 -0
  142. package/src/mcp-route-label-http.test.ts +120 -0
  143. package/src/mcp-write-network-resolution.test.ts +21 -0
  144. package/src/member-audit-network-id-http.test.ts +93 -0
  145. package/src/member-presence-http.test.ts +210 -0
  146. package/src/messages-ack-by-agent-http.test.ts +142 -0
  147. package/src/migrate-sqlite-to-pg.test.ts +47 -0
  148. package/src/migrate-sqlite-to-pg.ts +263 -0
  149. package/src/model-auth-notify-http.test.ts +181 -0
  150. package/src/model-auth-notify.ts +116 -0
  151. package/src/network-name-http.test.ts +75 -0
  152. package/src/network-rules-http.test.ts +169 -0
  153. package/src/network-rules.ts +129 -0
  154. package/src/network-scope.ts +222 -3
  155. package/src/network-token-membership-http.test.ts +186 -0
  156. package/src/node-alias-control.ts +12 -0
  157. package/src/node-attrs.test.ts +47 -2
  158. package/src/node-caller-identity-http.test.ts +1108 -0
  159. package/src/node-create-request-status-http.test.ts +105 -0
  160. package/src/node-daemon-bindings.test.ts +142 -0
  161. package/src/node-daemon-bindings.ts +135 -0
  162. package/src/node-failure-alert.test.ts +150 -0
  163. package/src/node-failure-alert.ts +177 -0
  164. package/src/node-files-transport.test.ts +350 -0
  165. package/src/node-health-codex-login.test.ts +120 -0
  166. package/src/node-health-dispatch-http.test.ts +373 -0
  167. package/src/node-health-guard.ts +121 -0
  168. package/src/node-health-passthrough.test.ts +115 -0
  169. package/src/node-health-store.ts +101 -0
  170. package/src/node-id-alias.test.ts +190 -0
  171. package/src/node-identity-conflict-http.test.ts +269 -0
  172. package/src/node-identity-conflict.ts +142 -0
  173. package/src/node-identity-mismatch.test.ts +74 -0
  174. package/src/node-in-flight-tasks.ts +31 -0
  175. package/src/node-lifecycle-controllable.test.ts +64 -0
  176. package/src/node-lifecycle-controllable.ts +53 -0
  177. package/src/node-lifecycle-read-http.test.ts +257 -0
  178. package/src/node-lifecycle-read.ts +124 -0
  179. package/src/node-logs-transport.test.ts +266 -0
  180. package/src/node-peer-allowlist.test.ts +114 -0
  181. package/src/node-permissions-http.test.ts +728 -0
  182. package/src/node-permissions.ts +494 -0
  183. package/src/node-request-retention.test.ts +281 -0
  184. package/src/node-request-retention.ts +120 -0
  185. package/src/node-secret-rest-http.test.ts +190 -0
  186. package/src/node-security-write-gate.test.ts +72 -0
  187. package/src/node-serviceability.test.ts +86 -0
  188. package/src/node-serviceability.ts +124 -0
  189. package/src/node-session-control-http.test.ts +310 -0
  190. package/src/node-session-control.ts +258 -0
  191. package/src/node-skills-transport.test.ts +212 -0
  192. package/src/node-token-identity.ts +35 -0
  193. package/src/node-token-ownership.ts +51 -0
  194. package/src/node-token-privilege-http.test.ts +158 -0
  195. package/src/not-found-api-http.test.ts +67 -0
  196. package/src/observer-avatar-http.test.ts +103 -10
  197. package/src/observer-push.test.ts +76 -0
  198. package/src/opencode-catalog-report-http.test.ts +139 -0
  199. package/src/opencode-v2-catalog.test.ts +268 -0
  200. package/src/opencode-v2-catalog.ts +356 -0
  201. package/src/package-version-consistency.test.ts +25 -0
  202. package/src/parent-infer.test.ts +82 -0
  203. package/src/parent-infer.ts +110 -0
  204. package/src/parent-source-marker.test.ts +70 -0
  205. package/src/password-network-tokens.ts +25 -0
  206. package/src/peer-reply-atomic.test.ts +462 -0
  207. package/src/peer-reply-capability.test.ts +70 -0
  208. package/src/pg-worker.ts +87 -0
  209. package/src/poll-pacing.test.ts +74 -0
  210. package/src/poll-pacing.ts +123 -0
  211. package/src/probe-provider-error-domain.test.ts +145 -0
  212. package/src/project-dir-warn-clear-http.test.ts +132 -0
  213. package/src/project-viewer-can-http.test.ts +116 -0
  214. package/src/provider-skill-error-domain.test.ts +130 -0
  215. package/src/provider-tools-shape.test.ts +165 -0
  216. package/src/push.test.ts +20 -10
  217. package/src/push.ts +373 -9
  218. package/src/redact-tokens.test.ts +86 -0
  219. package/src/redact-tokens.ts +43 -0
  220. package/src/rejection-counters.test.ts +72 -0
  221. package/src/rejection-counters.ts +173 -0
  222. package/src/rename.ts +38 -10
  223. package/src/reply-target-derivation.test.ts +96 -0
  224. package/src/report-status-handover-capabilities-http.test.ts +124 -0
  225. package/src/report-status-host-schema.test.ts +235 -0
  226. package/src/report-status-resume-id-handover.test.ts +184 -0
  227. package/src/report-status-secret-keys.test.ts +140 -0
  228. package/src/require-explicit-test-db.ts +9 -0
  229. package/src/requirement-due-reminders-http.test.ts +620 -0
  230. package/src/requirement-due-reminders.ts +416 -0
  231. package/src/requirement-events-http.test.ts +318 -0
  232. package/src/requirement-events.test.ts +45 -0
  233. package/src/requirement-events.ts +144 -0
  234. package/src/requirement-notify.ts +165 -0
  235. package/src/requirement-participant-notify-http.test.ts +313 -0
  236. package/src/requirement-tag-ops-http.test.ts +454 -0
  237. package/src/requirement-tag-tree-http.test.ts +275 -0
  238. package/src/requirement-tag-tree.ts +127 -0
  239. package/src/requirement-tags.ts +102 -0
  240. package/src/requirements-abandoned-http.test.ts +236 -0
  241. package/src/requirements-assignee-drift.test.ts +154 -0
  242. package/src/requirements-comment-http.test.ts +174 -0
  243. package/src/requirements-completed-at-migration.test.ts +70 -0
  244. package/src/requirements-errors-mcp-http.test.ts +164 -0
  245. package/src/requirements-errors.ts +158 -0
  246. package/src/requirements-etag-http.test.ts +91 -0
  247. package/src/requirements-http.test.ts +709 -0
  248. package/src/requirements-last-event-http.test.ts +349 -0
  249. package/src/requirements-list-mcp-slim-http.test.ts +155 -0
  250. package/src/requirements-list-slim-http.test.ts +324 -0
  251. package/src/requirements-mcp.test.ts +180 -0
  252. package/src/requirements-migrate.ts +283 -0
  253. package/src/requirements-owner-strict-mcp-http.test.ts +145 -0
  254. package/src/requirements-people-http.test.ts +114 -0
  255. package/src/requirements-people-mcp-http.test.ts +231 -0
  256. package/src/requirements-people.ts +196 -0
  257. package/src/requirements-priority-lowest.test.ts +114 -0
  258. package/src/requirements-projects-network-echo.test.ts +57 -0
  259. package/src/requirements-projects-parent-http.test.ts +123 -0
  260. package/src/requirements-search-http.test.ts +182 -0
  261. package/src/requirements-search.test.ts +32 -0
  262. package/src/requirements-search.ts +145 -0
  263. package/src/requirements-seq-http.test.ts +193 -0
  264. package/src/requirements-seq-migration.test.ts +63 -0
  265. package/src/requirements-start-date.test.ts +125 -0
  266. package/src/requirements-stats-http.test.ts +357 -0
  267. package/src/requirements-stats.ts +195 -0
  268. package/src/requirements-status-participants-http.test.ts +222 -0
  269. package/src/requirements-upgrade-e2e.test.ts +126 -0
  270. package/src/requirements-upgrade-migration.test.ts +98 -0
  271. package/src/requirements.ts +2205 -0
  272. package/src/resolve-port.test.ts +57 -0
  273. package/src/resolve-port.ts +44 -0
  274. package/src/rest-alias-network-fallback-http.test.ts +123 -0
  275. package/src/rest-alias-network-fallback.test.ts +60 -0
  276. package/src/rest-alias-network-fallback.ts +65 -0
  277. package/src/rest-explicit-columns-http.test.ts +266 -0
  278. package/src/rest-identity.test.ts +130 -0
  279. package/src/rest-identity.ts +141 -0
  280. package/src/rest-projections.ts +72 -0
  281. package/src/rest-read-network-real-chain.test.ts +97 -0
  282. package/src/rest-write-network-resolution.test.ts +133 -0
  283. package/src/restart-readiness-http.test.ts +121 -0
  284. package/src/restricted-files.ts +76 -0
  285. package/src/retention-first-sweep-quiet.test.ts +31 -0
  286. package/src/retention.test.ts +100 -40
  287. package/src/retention.ts +423 -104
  288. package/src/route-callers-http.test.ts +120 -0
  289. package/src/route-timing.test.ts +218 -0
  290. package/src/route-timing.ts +262 -0
  291. package/src/rules-file-duplicate-alias.test.ts +234 -0
  292. package/src/rules-file-session-target.test.ts +207 -0
  293. package/src/rules-file-transport.test.ts +271 -0
  294. package/src/runtime-label.test.ts +22 -0
  295. package/src/runtime-label.ts +21 -0
  296. package/src/runtime-readiness.ts +90 -0
  297. package/src/schedule-agent-mcp-http.test.ts +486 -0
  298. package/src/schedule-agent.ts +252 -0
  299. package/src/schedule-starved.test.ts +92 -0
  300. package/src/schedule-starved.ts +114 -0
  301. package/src/scheduled-backoff-http.test.ts +203 -0
  302. package/src/scheduled-backoff.ts +64 -0
  303. package/src/scheduled-doorbell-nodeless-session.test.ts +134 -0
  304. package/src/scheduled-failure-backoff-2622.test.ts +145 -0
  305. package/src/scheduled-failure-code.test.ts +73 -0
  306. package/src/scheduled-failure-code.ts +105 -0
  307. package/src/scheduled-failures-http.test.ts +279 -0
  308. package/src/scheduled-failures.ts +425 -0
  309. package/src/scheduled-noprogress-backoff-2622.test.ts +163 -0
  310. package/src/scheduled-offline-backoff-probe.test.ts +56 -0
  311. package/src/scheduled-offline.test.ts +131 -0
  312. package/src/scheduled-offline.ts +66 -0
  313. package/src/scheduled-outcome-guidance-http.test.ts +139 -0
  314. package/src/scheduled-outcome-guidance.ts +9 -0
  315. package/src/scheduled-reply-unread-http.test.ts +212 -0
  316. package/src/scheduled-requirement-wake-http.test.ts +289 -0
  317. package/src/scheduled-requirement-wake.ts +125 -0
  318. package/src/scheduled-run-terminal.test.ts +290 -0
  319. package/src/scheduled-skip-blocking-task.test.ts +120 -0
  320. package/src/scheduled-skip-path-backoff-2622.test.ts +98 -0
  321. package/src/scheduled-stuck-http.test.ts +316 -0
  322. package/src/scheduled-stuck-notice-cap.test.ts +80 -0
  323. package/src/scheduled-stuck.ts +219 -0
  324. package/src/scheduled-tasks-http.test.ts +679 -0
  325. package/src/scheduled-tasks.ts +959 -0
  326. package/src/scheduled-work-outcome-http.test.ts +154 -0
  327. package/src/scheduled-work-outcome.ts +50 -0
  328. package/src/scoped-secrets.ts +141 -0
  329. package/src/secret-echo-negative-control.test.ts +118 -0
  330. package/src/send-dedup-request-id.test.ts +229 -0
  331. package/src/send-reply-agent-warning.test.ts +38 -38
  332. package/src/send-reply-alias-optional.test.ts +131 -0
  333. package/src/send-reply-attachments.test.ts +28 -7
  334. package/src/send_dedup.test.ts +54 -0
  335. package/src/send_dedup.ts +52 -6
  336. package/src/serve-error.test.ts +73 -0
  337. package/src/serve-error.ts +56 -0
  338. package/src/server.ts +4846 -325
  339. package/src/session-task-on-dispatch.ts +14 -0
  340. package/src/session-token-ownership-http.test.ts +122 -0
  341. package/src/shared/codex-inventory.ts +41 -0
  342. package/src/shared/daemon-provider-login.ts +31 -0
  343. package/src/shared/daemon-provider-snapshot.ts +52 -0
  344. package/src/shared/external-schedule-contract.ts +60 -0
  345. package/src/shared/node-name.test.ts +62 -0
  346. package/src/shared/node-name.ts +161 -0
  347. package/src/shared/probe-host-allowlist-drift.test.ts +45 -0
  348. package/src/shared/provider-application.ts +29 -0
  349. package/src/shared/provider-collection.ts +14 -0
  350. package/src/shared/provider-initialization.ts +8 -0
  351. package/src/shared/reserved-env-drift.test.ts +10 -0
  352. package/src/shared/scoped-secret-contract.ts +5 -0
  353. package/src/shared/task-content-limit-drift.test.ts +28 -0
  354. package/src/shared/task-content-limit.ts +25 -0
  355. package/src/side-thread-command-transport.test.ts +312 -0
  356. package/src/side-thread-command-transport.ts +318 -0
  357. package/src/side-thread-http-integration.test.ts +233 -0
  358. package/src/side-thread-http.ts +504 -0
  359. package/src/side-thread-production.test.ts +72 -0
  360. package/src/side-thread-production.ts +118 -0
  361. package/src/side-thread.test.ts +1067 -0
  362. package/src/side-thread.ts +2499 -0
  363. package/src/skillhub-http.test.ts +144 -0
  364. package/src/sqlite-close-checkpoint.test.ts +78 -0
  365. package/src/start-node.test.ts +265 -0
  366. package/src/start-request-error-domain.test.ts +182 -0
  367. package/src/start-skill-error-domain.test.ts +122 -0
  368. package/src/stats-versions-http.test.ts +65 -0
  369. package/src/status-alias-filter-http.test.ts +106 -0
  370. package/src/status-alias-resolver-http.test.ts +163 -0
  371. package/src/status-alias-resolver.ts +19 -0
  372. package/src/status-node-id-filter-http.test.ts +161 -0
  373. package/src/status-read-cache-http.test.ts +229 -0
  374. package/src/status-read-cache.ts +129 -0
  375. package/src/stop-delete-node.test.ts +567 -1
  376. package/src/task-access-http.test.ts +402 -0
  377. package/src/task-access.ts +420 -0
  378. package/src/task-activity.ts +60 -0
  379. package/src/task-auth-origin-http.test.ts +93 -0
  380. package/src/task-auth-origin.test.ts +24 -0
  381. package/src/task-auth-origin.ts +7 -0
  382. package/src/task-consumption.test.ts +508 -0
  383. package/src/task-diagnostic-http.test.ts +149 -0
  384. package/src/task-diagnostic.test.ts +115 -0
  385. package/src/task-diagnostic.ts +118 -0
  386. package/src/task-expiry-notice-http.test.ts +298 -0
  387. package/src/task-expiry-notice.ts +318 -0
  388. package/src/task-idempotency-mcp.test.ts +148 -0
  389. package/src/task-idempotency.test.ts +76 -0
  390. package/src/task-idempotency.ts +81 -0
  391. package/src/task-late-replies.ts +54 -0
  392. package/src/task-late-reply-http.test.ts +227 -0
  393. package/src/task-lifecycle-watcher-busy.test.ts +114 -0
  394. package/src/task-lifecycle-watcher.test.ts +209 -0
  395. package/src/task-lifecycle-watcher.ts +109 -0
  396. package/src/task-network-resolution-http.test.ts +140 -0
  397. package/src/task-not-found-error-domain.test.ts +114 -0
  398. package/src/task-offline-delivery-2668.test.ts +119 -0
  399. package/src/task-offline-delivery.ts +81 -0
  400. package/src/task-orphan-http.test.ts +287 -0
  401. package/src/task-orphan.ts +119 -0
  402. package/src/task-queue-ahead-http.test.ts +309 -0
  403. package/src/task-queue-ahead-scale.test.ts +236 -0
  404. package/src/task-queue-ahead.ts +186 -0
  405. package/src/task-rejection-log-http.test.ts +160 -0
  406. package/src/task-rejection-log.ts +61 -0
  407. package/src/task-sender-http.test.ts +143 -0
  408. package/src/task-stale-open-http.test.ts +292 -0
  409. package/src/task-stale-open.ts +103 -0
  410. package/src/tasks-pagination-http.test.ts +141 -0
  411. package/src/team-rules-status-http.test.ts +90 -0
  412. package/src/team-rules-status.test.ts +59 -0
  413. package/src/team-rules-status.ts +72 -0
  414. package/src/tmux-allowlist.test.ts +48 -0
  415. package/src/tool-audience-http.test.ts +248 -0
  416. package/src/tool-audience.ts +127 -0
  417. package/src/tools-list-json-schema.test.ts +94 -0
  418. package/src/tools.ts +4229 -397
  419. package/src/update-node-config-error-domain.test.ts +107 -0
  420. package/src/uploads-http.test.ts +6 -4
  421. package/src/uploads.ts +23 -4
  422. package/src/user-avatar-http.test.ts +74 -0
  423. package/src/user-avatar-image.ts +160 -0
  424. package/src/user-avatar-migration.test.ts +25 -0
  425. package/src/user-avatar-upload-http.test.ts +348 -0
  426. package/src/user-inbox-by-agent-http.test.ts +165 -0
  427. package/src/user-inbox-netid-notnull.test.ts +122 -0
  428. package/src/user-inbox-read-http.test.ts +223 -0
  429. package/src/user-inbox-schema.test.ts +54 -0
  430. package/src/version-stats.test.ts +66 -0
  431. package/src/version-stats.ts +109 -0
@@ -0,0 +1,101 @@
1
+ // #448 —— agent-node 上报的分层健康(`report_status.health`)的 Hub 侧透传。
2
+ //
3
+ // 「在线」只说明桥进程还活着:现场 ~40 台 codex 共存节点里,有的在 Hub 上 idle / in_flight=0,
4
+ // 实际 app-server 端口没人监听、TUI pane 变成 `sleep infinity`、或登录态 "refresh token revoked"。
5
+ // 节点把这几层分开报上来;这里只负责**收下、按节点存最新一份、在 /api/status 和 status_update 里带出去**。
6
+ //
7
+ // 刻意只放内存,不加列:它是**几秒钟一变的观测值**,不是需要跨重启保留的状态 —— Hub 重启后下一次
8
+ // 心跳(≤3 分钟,翻转时立即)就会补上;持久化一份旧观测值反而会在节点死掉后继续说「app_server ok」。
9
+ // 同理,超过 TTL 的那份按「没报」处理(null),不按「健康」处理。
10
+
11
+ import { z } from "zod/v4";
12
+
13
+ export const NODE_HEALTH_TTL_MS = 10 * 60_000;
14
+
15
+ // 🔴 `.catch(undefined)`:这一格是纯诊断信息,**任何形状都不许拒掉整份 report_status**
16
+ // (zod 对象里一个已知字段验证失败 = 整份被拒 = 节点在 Hub 上失联,#1225 的形状)。
17
+ // 合法的透传,其余一律当没报。子对象不 strict:新节点多报的键丢掉即可。
18
+ export const nodeHealthSchema = z.object({
19
+ bridge: z.literal("ok").optional(),
20
+ app_server: z.object({
21
+ ok: z.boolean(),
22
+ rtt_ms: z.number().nullable().catch(null),
23
+ last_error: z.string().max(200).nullable().catch(null),
24
+ }).optional().catch(undefined),
25
+ tui: z.object({
26
+ ok: z.boolean(),
27
+ reason: z.string().max(40),
28
+ }).optional().catch(undefined),
29
+ model_auth: z.enum(["ok", "revoked", "expired", "unknown"]).optional().catch(undefined),
30
+ // #594 —— codex 节点的登录指纹 + 本机另有几台节点持有同一份登录(见下方 codexLoginSchema)。
31
+ // 🔴 线上 schema 故意是 unknown:report_status 的 JSON schema 每个节点每次 tools/list 都要下发,
32
+ // #476 给它定了字节上限(tool-audience-http.test.ts)。严格校验在 recordNodeHealth 里做,效果相同:
33
+ // 不合规 → 这一格当没报,整份 report 照收。
34
+ codex_login: z.unknown().optional(),
35
+ }).optional().catch(undefined);
36
+
37
+ // #594 —— health.codex_login 的严格形状。纯展示/提示,**不是** degraded 层:共用登录今天还能跑,
38
+ // 只是迟早互相顶掉(#1918);派发不因它拒绝。fingerprint 必须是 8 位小写 hex(sha256(refresh_token)
39
+ // 截断,不是凭据)—— 节点误把 token 塞进来也存不下;计数是小的非负整数;codex_home 是节点自己的路径
40
+ // (给客户端拼 `CODEX_HOME=<codex_home> codex login --device-auth`),拒控制字符。
41
+ // 可选格各自降级;必需格(fingerprint / shared_with)不合规 → 整格丢弃。
42
+ export const codexLoginSchema = z.object({
43
+ fingerprint: z.string().regex(/^[0-9a-f]{8}$/),
44
+ shared_with: z.number().int().min(0).max(100_000),
45
+ shared_home_with: z.number().int().min(0).max(100_000).optional().catch(undefined),
46
+ codex_home: z.string().max(1024).regex(/^[^\u0000-\u001f\u007f]*$/).optional().catch(undefined),
47
+ });
48
+ export type CodexLoginHealth = z.infer<typeof codexLoginSchema>;
49
+
50
+ export type NodeHealth = Omit<NonNullable<z.infer<typeof nodeHealthSchema>>, "codex_login"> & { codex_login?: CodexLoginHealth };
51
+
52
+ /** 线上收到的 health → 存的那份:codex_login 按严格形状过一遍,不合规就去掉这一格。 */
53
+ export function normalizeNodeHealth(raw: NonNullable<z.infer<typeof nodeHealthSchema>>): NodeHealth {
54
+ const { codex_login: rawLogin, ...rest } = raw;
55
+ if (rawLogin === undefined) return rest;
56
+ const parsed = codexLoginSchema.safeParse(rawLogin);
57
+ return parsed.success ? { ...rest, codex_login: parsed.data } : rest;
58
+ }
59
+
60
+ const store = new Map<string, { health: NodeHealth; at: number }>();
61
+ const keyOf = (networkId: string | null | undefined, alias: string) => `${networkId ?? "default"}\0${alias}`;
62
+
63
+ // #431 —— /api/status 的记忆化(status-read-cache.ts)按这两样判断正文还对不对:任何一次上报 → 版本 +1;
64
+ // 任何一份报告过 TTL 的那一刻(degraded / health 字段会消失)→ 由 nodeHealthNextExpiryAt 给出的时刻失效。
65
+ let version = 0;
66
+ export function nodeHealthVersion(): number { return version; }
67
+ /** 最早一份还没过期的报告的过期时刻(ms);一份都没有 → Infinity。 */
68
+ export function nodeHealthNextExpiryAt(now = Date.now()): number {
69
+ let next = Infinity;
70
+ for (const v of store.values()) {
71
+ const at = v.at + NODE_HEALTH_TTL_MS;
72
+ if (at >= now && at < next) next = at;
73
+ }
74
+ return next;
75
+ }
76
+
77
+ export function recordNodeHealth(
78
+ networkId: string | null | undefined, alias: string,
79
+ health: NodeHealth | NonNullable<z.infer<typeof nodeHealthSchema>>, now = Date.now(),
80
+ ): void {
81
+ version++;
82
+ store.set(keyOf(networkId, alias), { health: normalizeNodeHealth(health), at: now });
83
+ // 有界:按 TTL 顺手清掉过期的,别让改过名/删掉的节点在内存里攒着。
84
+ if (store.size > 256) {
85
+ for (const [k, v] of store) if (now - v.at > NODE_HEALTH_TTL_MS) store.delete(k);
86
+ }
87
+ }
88
+
89
+ /** 最新一份;没有或已过 TTL → null(读的人必须把它当「不知道」,而不是「健康」)。 */
90
+ export function readNodeHealth(
91
+ networkId: string | null | undefined, alias: string, now = Date.now(),
92
+ ): { health: NodeHealth; observed_ms_ago: number } | null {
93
+ const hit = store.get(keyOf(networkId, alias));
94
+ if (!hit) return null;
95
+ const age = now - hit.at;
96
+ if (age > NODE_HEALTH_TTL_MS) { store.delete(keyOf(networkId, alias)); return null; }
97
+ return { health: hit.health, observed_ms_ago: Math.max(0, age) };
98
+ }
99
+
100
+ /** 测试用。 */
101
+ export function clearNodeHealthStore(): void { store.clear(); version++; }
@@ -0,0 +1,190 @@
1
+ // #1281 — 子节点生命周期工具的参数名统一(node_id ⇄ child_node_id)。
2
+ //
3
+ // 分叉现状(origin/main 2976adb2):stop_node / start_node / delete_node 用
4
+ // `child_node_id`,restart_node / update_node_config 用 `node_id`,指向同一个
5
+ // 子节点。调用方按一个工具的习惯给另一个传就吃 -32602。修复:5 个工具都同时
6
+ // 接受两个名字(canonical = node_id,child_node_id 兼容 alias),解析收敛到一个
7
+ // 模块级 helper resolveNodeIdArg。
8
+ //
9
+ // 两向 witnessed-red(本文件即判据):
10
+ // · schema 层:每个工具的**历史用名**始终 parse 成功(证明没破已发布契约),
11
+ // **新增别名**在修复前 parse 失败(缺必填字段)、修复后成功。
12
+ // · handler 层:resolveNodeIdArg 纯函数 —— 二选一至少一必填、都传须相等。
13
+ // · 真实 handler 路径:stop_node 用 node_id / child_node_id 都能穿到
14
+ // resolveDaemonForChild(不再被 node_id_required 挡),都传冲突 → node_id_conflict。
15
+ //
16
+ // 对 pre-fix 见红的证明方式(评审可复现):把 tools.ts 里任一工具的
17
+ // `...NODE_ID_ALIAS_FIELDS` 还原成原来的单名字段(如 stop_node 的
18
+ // `child_node_id: z.string()...regex(...)`),本文件对应工具的「新增别名 parse 成功」
19
+ // 断言立即变红 —— 证明该断言有判别力,不是恒真。
20
+
21
+ import { describe, expect, test, beforeAll } from "bun:test";
22
+ import { mkdtempSync } from "fs";
23
+ import { join } from "path";
24
+ import { tmpdir } from "os";
25
+
26
+ process.env.COMMHUB_DB = process.env.COMMHUB_DB || (mkdtempSync(join(tmpdir(), "anet-1281-")) + "/commhub.db");
27
+
28
+ import { z } from "zod/v4";
29
+ import { McpServer } from "@modelcontextprotocol/sdk/server/mcp.js";
30
+ import { registerTools, resolveNodeIdArg } from "./tools.js";
31
+
32
+ type ToolHandler = (args: any) => Promise<{ content: { type: "text"; text: string }[] }>;
33
+
34
+ // Capture BOTH the raw zod shape and the handler for every tool, so the
35
+ // schema-layer assertions run against the exact object server.tool received.
36
+ function buildCaptured() {
37
+ const schemas: Record<string, any> = {};
38
+ const handlers: Record<string, ToolHandler> = {};
39
+ const server = new McpServer({ name: "t1281", version: "0" }) as any;
40
+ const origTool = server.tool.bind(server);
41
+ server.tool = (name: string, _desc: string, schema: any, handler: ToolHandler) => {
42
+ schemas[name] = schema; handlers[name] = handler;
43
+ return origTool(name, _desc, schema, handler);
44
+ };
45
+ const origRegisterTool = server.registerTool?.bind(server);
46
+ if (origRegisterTool) {
47
+ server.registerTool = (name: string, cfg: any, handler: ToolHandler) => {
48
+ schemas[name] = cfg?.inputSchema ?? cfg; handlers[name] = handler;
49
+ return origRegisterTool(name, cfg, handler);
50
+ };
51
+ }
52
+ registerTools(server, undefined, null, "user_1281", null, false, null);
53
+ return { schemas, handlers };
54
+ }
55
+
56
+ let SCHEMAS: Record<string, any> = {};
57
+ let HANDLERS: Record<string, ToolHandler> = {};
58
+ beforeAll(() => { const c = buildCaptured(); SCHEMAS = c.schemas; HANDLERS = c.handlers; });
59
+
60
+ async function call(name: string, args: any) {
61
+ const r = await HANDLERS[name](args);
62
+ return JSON.parse(r.content[0].text);
63
+ }
64
+
65
+ // Per tool: the historically-required id name, the newly-added alias, and
66
+ // the OTHER required fields the shape needs so a safeParse isolates the id
67
+ // field rather than tripping on an unrelated missing field.
68
+ const TOOLS = [
69
+ { name: "stop_node", historic: "child_node_id", added: "node_id", extra: {} },
70
+ { name: "start_node", historic: "child_node_id", added: "node_id", extra: {} },
71
+ { name: "delete_node", historic: "child_node_id", added: "node_id", extra: { confirm_alias: "some-alias" } },
72
+ { name: "restart_node", historic: "node_id", added: "child_node_id", extra: {} },
73
+ { name: "update_node_config", historic: "node_id", added: "child_node_id", extra: { base_revision: 0, patch: {} } },
74
+ ];
75
+
76
+ const VALID_ID = "node_test_1281";
77
+
78
+ describe("#1281 schema layer — every lifecycle tool accepts BOTH node_id and child_node_id", () => {
79
+ for (const t of TOOLS) {
80
+ test(`${t.name}: historic name '${t.historic}' still parses (published contract intact)`, () => {
81
+ const shape = z.object(SCHEMAS[t.name]);
82
+ const r = shape.safeParse({ [t.historic]: VALID_ID, ...t.extra });
83
+ expect(r.success).toBe(true);
84
+ });
85
+
86
+ test(`${t.name}: added alias '${t.added}' parses (was -32602 pre-#1281 → RED without the fix)`, () => {
87
+ const shape = z.object(SCHEMAS[t.name]);
88
+ const r = shape.safeParse({ [t.added]: VALID_ID, ...t.extra });
89
+ expect(r.success).toBe(true);
90
+ });
91
+
92
+ test(`${t.name}: both names present + equal parses (schema layer permissive; conflict caught in handler)`, () => {
93
+ const shape = z.object(SCHEMAS[t.name]);
94
+ const r = shape.safeParse({ node_id: VALID_ID, child_node_id: VALID_ID, ...t.extra });
95
+ expect(r.success).toBe(true);
96
+ });
97
+ }
98
+ });
99
+
100
+ describe("#1281 resolveNodeIdArg — the single resolution helper", () => {
101
+ test("node_id only → resolves to node_id", () => {
102
+ expect(resolveNodeIdArg({ node_id: "node_a" })).toEqual({ ok: true, node_id: "node_a" });
103
+ });
104
+ test("child_node_id only → resolves to it (back-compat)", () => {
105
+ expect(resolveNodeIdArg({ child_node_id: "node_b" })).toEqual({ ok: true, node_id: "node_b" });
106
+ });
107
+ test("both present + EQUAL → resolves (no conflict)", () => {
108
+ expect(resolveNodeIdArg({ node_id: "node_c", child_node_id: "node_c" })).toEqual({ ok: true, node_id: "node_c" });
109
+ });
110
+ test("both present + DIFFERENT → node_id_conflict (catches A/B fat-finger)", () => {
111
+ const r = resolveNodeIdArg({ node_id: "node_a", child_node_id: "node_b" });
112
+ expect(r.ok).toBe(false);
113
+ expect((r as any).error).toBe("node_id_conflict");
114
+ });
115
+ test("neither present → node_id_required", () => {
116
+ const r = resolveNodeIdArg({});
117
+ expect(r.ok).toBe(false);
118
+ expect((r as any).error).toBe("node_id_required");
119
+ });
120
+ });
121
+
122
+ describe("#1281 real handler path — stop_node routes both names to the same place", () => {
123
+ // stop_node calls resolveNodeIdArg FIRST, then resolveDaemonForChild. A
124
+ // fabricated id has no create-request row → daemon_not_resolvable. The
125
+ // point is that BOTH names get PAST the id gate to that same downstream
126
+ // error (proving the alias flows through), and the two error branches fire.
127
+ test("node_id (new name) flows through → daemon_not_resolvable, NOT node_id_required", async () => {
128
+ const r = await call("stop_node", { node_id: VALID_ID });
129
+ expect(r.ok).toBe(false);
130
+ expect(r.error).toBe("daemon_not_resolvable");
131
+ });
132
+ test("child_node_id (old name) flows through → daemon_not_resolvable (back-compat intact)", async () => {
133
+ const r = await call("stop_node", { child_node_id: VALID_ID });
134
+ expect(r.ok).toBe(false);
135
+ expect(r.error).toBe("daemon_not_resolvable");
136
+ });
137
+ test("neither → node_id_required (before any daemon resolution)", async () => {
138
+ const r = await call("stop_node", { force: true });
139
+ expect(r.ok).toBe(false);
140
+ expect(r.error).toBe("node_id_required");
141
+ });
142
+ test("both differ → node_id_conflict (before any daemon resolution)", async () => {
143
+ const r = await call("stop_node", { node_id: "node_a", child_node_id: "node_b" });
144
+ expect(r.ok).toBe(false);
145
+ expect(r.error).toBe("node_id_conflict");
146
+ });
147
+ });
148
+
149
+ describe("app#196 —— 「解析不到 daemon」的两种情况必须给不同的话", () => {
150
+ // 🔴 生产实测(2026-08-28):218 个节点里 207 个是 `n_…`(有人直接
151
+ // `anet node start` 起的),它们**根本没有 daemon**。原先这两种情况
152
+ // 打印同一句 `pass daemon_node_id explicitly` —— 对那 207 个来说,
153
+ // **这句建议的前提是假的**,照着做只会走进死路。
154
+ const HAND_STARTED = "n_73687f17"; // 手工起的节点,真实形状
155
+ const DAEMON_CHILD = "node_test_1281"; // daemon 建的子节点
156
+
157
+ test("手工起的节点 → not_daemon_managed,并且**不**建议传 daemon_node_id", async () => {
158
+ const r = await call("stop_node", { node_id: HAND_STARTED });
159
+ expect(r.ok).toBe(false);
160
+ expect(r.error).toBe("not_daemon_managed");
161
+ // 🔴 这一条是本组的核心:旧文案的那句建议**不能**再出现在这条路径上。
162
+ expect(r.message).not.toContain("pass daemon_node_id explicitly");
163
+ // 而且要告诉他真正能走的那条路。
164
+ expect(r.message).toContain("anet node stop");
165
+ });
166
+
167
+ test("daemon 建的子节点(无 create-request 行) → 仍是 daemon_not_resolvable", async () => {
168
+ const r = await call("stop_node", { node_id: DAEMON_CHILD });
169
+ expect(r.ok).toBe(false);
170
+ expect(r.error).toBe("daemon_not_resolvable");
171
+ // Board #625: an explicit daemon id no longer substitutes for authority.
172
+ expect(r.message).not.toContain("pass daemon_node_id explicitly");
173
+ expect(r.message).toContain("adopt this node");
174
+ });
175
+
176
+ test("delete_node 走同一条判别(两个调用点不能只改一个)", async () => {
177
+ const r = await call("delete_node", { node_id: HAND_STARTED, confirm_alias: "x" });
178
+ expect(r.ok).toBe(false);
179
+ expect(r.error).toBe("not_daemon_managed");
180
+ });
181
+
182
+ // 🔴 反向见证:两种情况必须**真的不同**。若有人把判别改成恒定一支,
183
+ // 上面三条里至少一条会红 —— 但那还不够明显,所以这里直接断言两者不等。
184
+ test("两种情况的 error 与 message 都不相同", async () => {
185
+ const a = await call("stop_node", { node_id: HAND_STARTED });
186
+ const b = await call("stop_node", { node_id: DAEMON_CHILD });
187
+ expect(a.error).not.toBe(b.error);
188
+ expect(a.message).not.toBe(b.message);
189
+ });
190
+ });
@@ -0,0 +1,269 @@
1
+ // #507 — two live copies of one node (directory copied verbatim: same node token,
2
+ // same alias) used to hold two SSE subscriptions on `${net}:${alias}`. Every new
3
+ // task was pushed to BOTH (each copy ran it), and either copy's shutdown
4
+ // report_status(offline) took the node offline under the other → alias_offline.
5
+ //
6
+ // Pinned here, through the real HTTP entrances (GET /events/:alias with the node
7
+ // token, POST /mcp report_status, POST /api/task, GET /api/stats/sse):
8
+ // 1. newest connection wins: the older node stream gets node_connection_superseded
9
+ // (reason superseded_by_new_connection) and is closed; /api/stats/sse shows 1.
10
+ // 2. a new task reaches exactly ONE node subscriber; a dashboard monitor on the
11
+ // same channel is untouched and still sees it.
12
+ // 3. node_identity_conflict reaches the network observer stream and
13
+ // /api/stats/sse.identity_conflicts, with both remotes and no token.
14
+ // 4. offline only when the last node connection leaves; tasks in between are
15
+ // delivered, not alias_offline.
16
+ // 5. same instance id = a reconnect (replaced_by_reconnect, no conflict);
17
+ // different ids = instance_match "different"; another node's token watching
18
+ // this alias never supersedes it; a plain single-node stop is offline at once.
19
+ //
20
+ // 跑法:cd server && COMMHUB_DB=/tmp/x.db bun test src/node-identity-conflict-http.test.ts
21
+ // PG:COMMHUB_TEST_PG_URL=… COMMHUB_PG_EXPERIMENTAL=1(tests/test2123-hub-postgres-ladder 里注册)
22
+ import { afterAll, beforeAll, describe, expect, test } from "bun:test";
23
+ import { mkdtempSync, rmSync } from "node:fs";
24
+ import { join } from "node:path";
25
+ import { tmpdir } from "node:os";
26
+ import { createNetworkTokenForNode, register } from "./auth.js";
27
+ import { db } from "./db.js";
28
+
29
+ const dir = mkdtempSync(join(tmpdir(), "anet-node-conflict-"));
30
+ const activeDbPath = process.env.COMMHUB_DB ?? (process.env.COMMHUB_TEST_PG_URL ? "postgres" : undefined);
31
+ if (!activeDbPath) throw new Error("node-identity-conflict requires COMMHUB_DB (or COMMHUB_TEST_PG_URL) before module import");
32
+
33
+ const stamp = Date.now();
34
+ let server: any;
35
+ let base = "";
36
+ let ownerToken = "", ownerId = "", NET = "";
37
+ const nodes: Record<string, { alias: string; nodeId: string; token: string }> = {};
38
+
39
+ type Sub = { events: any[]; done: boolean; abort: () => void; ready: Promise<void> };
40
+
41
+ function subscribe(path: string, token: string, headers: Record<string, string> = {}): Sub {
42
+ const ctrl = new AbortController();
43
+ const sub: Sub = { events: [], done: false, abort: () => ctrl.abort(), ready: Promise.resolve() };
44
+ let markReady!: () => void;
45
+ sub.ready = new Promise<void>((r) => { markReady = r; });
46
+ (async () => {
47
+ try {
48
+ const res = await fetch(`${base}${path}`, { headers: { Authorization: `Bearer ${token}`, Accept: "text/event-stream", ...headers }, signal: ctrl.signal });
49
+ if (!res.ok || !res.body) throw new Error(`subscribe ${path} → ${res.status}`);
50
+ const reader = res.body.getReader();
51
+ const dec = new TextDecoder();
52
+ let buf = "";
53
+ while (true) {
54
+ const { done, value } = await reader.read();
55
+ if (done) break;
56
+ buf += dec.decode(value, { stream: true });
57
+ const lines = buf.split("\n"); buf = lines.pop() || "";
58
+ for (const line of lines) {
59
+ if (!line.startsWith("data: ")) continue;
60
+ const ev = JSON.parse(line.slice(6));
61
+ sub.events.push(ev);
62
+ if (ev.type === "connected") markReady();
63
+ }
64
+ }
65
+ } catch { /* aborted */ }
66
+ sub.done = true;
67
+ markReady();
68
+ })();
69
+ return sub;
70
+ }
71
+
72
+ async function until(cond: () => boolean, what: string, ms = 3000) {
73
+ const t0 = Date.now();
74
+ while (!cond()) {
75
+ if (Date.now() - t0 > ms) throw new Error(`timed out waiting for: ${what}`);
76
+ await new Promise((r) => setTimeout(r, 20));
77
+ }
78
+ }
79
+ const settle = () => new Promise((r) => setTimeout(r, 150));
80
+
81
+ async function api(token: string, method: string, path: string, body?: unknown) {
82
+ const res = await fetch(`${base}${path}`, {
83
+ method,
84
+ headers: { Authorization: `Bearer ${token}`, "Content-Type": "application/json" },
85
+ body: body === undefined ? undefined : JSON.stringify(body),
86
+ });
87
+ return { status: res.status, body: await res.json().catch(() => null) as any };
88
+ }
89
+
90
+ async function tool(token: string, name: string, args: Record<string, unknown>) {
91
+ const res = await fetch(`${base}/mcp`, {
92
+ method: "POST",
93
+ headers: { Authorization: `Bearer ${token}`, "Content-Type": "application/json", Accept: "application/json, text/event-stream", "MCP-Protocol-Version": "2025-03-26" },
94
+ body: JSON.stringify({ jsonrpc: "2.0", id: 1, method: "tools/call", params: { name, arguments: args } }),
95
+ });
96
+ const raw = await res.text();
97
+ const data = raw.split("\n").filter((x) => x.startsWith("data:"));
98
+ const payload = data.length ? JSON.parse(data.at(-1)!.slice(5).trim()) : JSON.parse(raw);
99
+ const text = payload.result.content[0].text;
100
+ if (!text.startsWith("{")) throw new Error(`${name}: ${text}`);
101
+ return JSON.parse(text);
102
+ }
103
+
104
+ const reportStatus = (n: { alias: string; nodeId: string; token: string }, status: string) =>
105
+ tool(n.token, "report_status", { resume_id: `sdk-${n.nodeId}`, alias: n.alias, status, node_id: n.nodeId, network_id: NET });
106
+ const storedStatus = (alias: string) =>
107
+ db.get<{ status: string }>("SELECT status FROM sessions WHERE alias = ?1 AND network_id = ?2", alias, NET)?.status;
108
+ let seq = 0;
109
+ const sendTask = (alias: string) => api(ownerToken, "POST", "/api/task", { alias, task: `conflict task ${stamp} #${++seq}`, network_id: NET });
110
+ const nodeStream = (n: { alias: string; token: string }, headers: Record<string, string> = {}) =>
111
+ subscribe(`/events/${encodeURIComponent(n.alias)}`, n.token, headers);
112
+ const newTasks = (s: Sub) => s.events.filter((e) => e.type === "new_task");
113
+ const sseCount = async (alias: string) => (await api(nodes.a.token, "GET", "/api/stats/sse")).body.sessions[`${NET}:${alias}`] ?? 0;
114
+
115
+ beforeAll(async () => {
116
+ process.env.COMMHUB_UPLOADS_DIR = join(dir, "uploads");
117
+ process.env.HOST = "127.0.0.1";
118
+ const owner = register(`nic_owner_${stamp}`, "NodeConflictOwner123!", undefined, "seed");
119
+ ownerToken = owner.token!; ownerId = owner.user!.user_id; NET = owner.network_id!;
120
+ for (const key of ["a", "b", "c", "d", "e"]) {
121
+ const alias = `nic-${key}-${stamp}`;
122
+ const nodeId = `n_nic_${key}_${stamp}`;
123
+ const minted = createNetworkTokenForNode(ownerId, NET, alias, nodeId);
124
+ expect(minted.ok).toBe(true);
125
+ nodes[key] = { alias, nodeId, token: minted.token! };
126
+ }
127
+ const mod: any = await import("./server.js");
128
+ server = mod.bootServer({ port: 0, hostname: "127.0.0.1" });
129
+ base = `http://127.0.0.1:${server.port}`;
130
+ for (const n of Object.values(nodes)) expect((await reportStatus(n, "idle")).ok).toBe(true);
131
+ }, 30_000);
132
+
133
+ afterAll(() => {
134
+ try { server?.stop?.(true); } catch {}
135
+ try { rmSync(dir, { recursive: true, force: true }); } catch {}
136
+ });
137
+
138
+ describe("#507 two copies of one node (same token, same alias)", () => {
139
+ const subs: Record<string, Sub> = {};
140
+
141
+ test("newest connection wins: the older node stream is told why and closed", async () => {
142
+ const n = nodes.a;
143
+ subs.observer = subscribe(`/events/network/${NET}`, ownerToken);
144
+ subs.monitor = subscribe(`/events/${encodeURIComponent(n.alias)}?network_id=${NET}`, ownerToken);
145
+ await subs.observer.ready; await subs.monitor.ready;
146
+ subs.copyA = nodeStream(n, { "User-Agent": "copy-A" });
147
+ await subs.copyA.ready;
148
+ expect(await sseCount(n.alias)).toBe(2); // copy A + dashboard monitor
149
+
150
+ subs.copyB = nodeStream(n, { "User-Agent": "copy-B" });
151
+ await subs.copyB.ready;
152
+ await until(() => subs.copyA.done, "copy A's stream to be closed");
153
+ const notice = subs.copyA.events.find((e) => e.type === "node_connection_superseded");
154
+ expect(notice).toBeTruthy();
155
+ expect(notice.reason).toBe("superseded_by_new_connection");
156
+ expect(notice.instance_match).toBe("unknown");
157
+ expect(subs.copyB.done).toBe(false);
158
+ expect(subs.monitor.done).toBe(false); // a monitor is never superseded
159
+ expect(await sseCount(n.alias)).toBe(2); // copy B + monitor
160
+ });
161
+
162
+ test("a new task reaches exactly one node subscriber (the monitor still sees it)", async () => {
163
+ const r = await sendTask(nodes.a.alias);
164
+ expect(r.status).toBe(200);
165
+ expect(r.body.ok).toBe(true);
166
+ await until(() => newTasks(subs.copyB).length >= 1 && newTasks(subs.monitor).length >= 1, "new_task on copy B + monitor");
167
+ await settle();
168
+ expect(newTasks(subs.copyB).length).toBe(1);
169
+ expect(newTasks(subs.copyA).length).toBe(0);
170
+ expect(newTasks(subs.monitor).length).toBe(1);
171
+ });
172
+
173
+ test("node_identity_conflict reaches the observer stream and /api/stats/sse, with remotes and no token", async () => {
174
+ await until(() => subs.observer.events.some((e) => e.type === "node_identity_conflict"), "observer conflict event");
175
+ const ev = subs.observer.events.find((e) => e.type === "node_identity_conflict");
176
+ expect(ev.alias).toBe(nodes.a.alias);
177
+ expect(ev.node_id).toBe(nodes.a.nodeId);
178
+ expect(ev.policy).toBe("newest_connection_wins");
179
+ expect(ev.superseded.user_agent).toBe("copy-A");
180
+ expect(ev.current.user_agent).toBe("copy-B");
181
+ expect(ev.superseded.remote).toMatch(/^127\.0\.0\.1:\d+$/);
182
+ expect(ev.current.remote).toMatch(/^127\.0\.0\.1:\d+$/);
183
+ expect(ev.superseded.remote).not.toBe(ev.current.remote);
184
+ const stats = await api(nodes.a.token, "GET", "/api/stats/sse");
185
+ const mine = stats.body.identity_conflicts.filter((c: any) => c.alias === nodes.a.alias);
186
+ expect(mine.length).toBe(1);
187
+ expect(mine[0].network_id).toBe(NET);
188
+ const raw = JSON.stringify(stats.body) + JSON.stringify(ev);
189
+ expect(raw).not.toContain("ntok_");
190
+ expect(raw).not.toContain(nodes.a.token);
191
+ const audit = db.get<{ n: number }>("SELECT COUNT(*) AS n FROM audit_log WHERE action = 'node_identity_conflict' AND target_id = ?1", nodes.a.nodeId);
192
+ expect(audit?.n).toBe(1);
193
+ });
194
+
195
+ test("offline only when the last node connection leaves; tasks in between are delivered", async () => {
196
+ const n = nodes.a;
197
+ // Copy A (the superseded one) shuts down and says so.
198
+ const fromA = await reportStatus(n, "offline");
199
+ expect(fromA.ok).toBe(true);
200
+ expect(fromA.offline_deferred).toBe(true);
201
+ expect(storedStatus(n.alias)).not.toBe("offline");
202
+ const r = await sendTask(n.alias);
203
+ expect(r.status).toBe(200);
204
+ expect(r.body.ok).toBe(true);
205
+ expect(r.body.error).toBeUndefined();
206
+ await until(() => newTasks(subs.copyB).length >= 2, "second new_task on copy B");
207
+
208
+ // Copy B stops too: it reports offline while its stream is still open, then exits.
209
+ const fromB = await reportStatus(n, "offline");
210
+ expect(fromB.offline_deferred).toBe(true);
211
+ expect(storedStatus(n.alias)).not.toBe("offline");
212
+ subs.copyB.abort();
213
+ await until(() => storedStatus(n.alias) === "offline", "deferred offline applied once the last node stream closed");
214
+ expect((await sendTask(n.alias)).body.error).toBe("alias_offline");
215
+ subs.monitor.abort(); subs.observer.abort();
216
+ });
217
+ });
218
+
219
+ describe("#507 what is and is not a conflict", () => {
220
+ test("same instance id = a reconnect of the same process: replaced, no conflict recorded", async () => {
221
+ const n = nodes.b;
222
+ const first = nodeStream(n, { "X-Anet-Instance-Id": "inst-b-1" });
223
+ await first.ready;
224
+ const second = nodeStream(n, { "X-Anet-Instance-Id": "inst-b-1" });
225
+ await second.ready;
226
+ await until(() => first.done, "old stream replaced");
227
+ expect(first.events.find((e) => e.type === "node_connection_superseded")?.reason).toBe("replaced_by_reconnect");
228
+ const stats = await api(n.token, "GET", "/api/stats/sse");
229
+ expect(stats.body.identity_conflicts.filter((c: any) => c.alias === n.alias)).toEqual([]);
230
+ // No conflict → a stop is exactly as before: offline at once.
231
+ const r = await reportStatus(n, "offline");
232
+ expect(r.offline_deferred).toBeUndefined();
233
+ expect(storedStatus(n.alias)).toBe("offline");
234
+ second.abort();
235
+ });
236
+
237
+ test("different instance ids are reported as instance_match=different", async () => {
238
+ const n = nodes.c;
239
+ const first = nodeStream(n, { "X-Anet-Instance-Id": "inst-c-host1" });
240
+ await first.ready;
241
+ const second = subscribe(`/events/${encodeURIComponent(n.alias)}?instance_id=inst-c-host2`, n.token);
242
+ await second.ready;
243
+ await until(() => first.done, "old stream superseded");
244
+ const stats = await api(n.token, "GET", "/api/stats/sse");
245
+ const mine = stats.body.identity_conflicts.filter((c: any) => c.alias === n.alias);
246
+ expect(mine.length).toBe(1);
247
+ expect(mine[0].instance_match).toBe("different");
248
+ expect(mine[0].superseded.instance_id).toBe("inst-c-host1");
249
+ expect(mine[0].current.instance_id).toBe("inst-c-host2");
250
+ second.abort();
251
+ });
252
+
253
+ test("another node's token watching this alias never supersedes the node", async () => {
254
+ const n = nodes.d;
255
+ const own = nodeStream(n);
256
+ await own.ready;
257
+ const watcher = subscribe(`/events/${encodeURIComponent(n.alias)}`, nodes.e.token);
258
+ await watcher.ready;
259
+ await settle();
260
+ expect(own.done).toBe(false);
261
+ expect(own.events.some((e) => e.type === "node_connection_superseded")).toBe(false);
262
+ watcher.abort();
263
+ // And a plain single-node stop (no conflict) is offline immediately, as before.
264
+ const r = await reportStatus(n, "offline");
265
+ expect(r.offline_deferred).toBeUndefined();
266
+ expect(storedStatus(n.alias)).toBe("offline");
267
+ own.abort();
268
+ });
269
+ });