@sleep2agi/commhub-server 0.9.0-preview.28 → 0.9.0-preview.280

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 (479) 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 +229 -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 +215 -0
  12. package/src/agent-access.ts +585 -0
  13. package/src/agent-acl-groups-http.test.ts +247 -0
  14. package/src/agent-acl-http.test.ts +691 -0
  15. package/src/agent-acl-slice3-http.test.ts +888 -0
  16. package/src/agent-department-grants.test.ts +129 -0
  17. package/src/agent-department-http.test.ts +215 -0
  18. package/src/agent-groups-perf.test.ts +228 -0
  19. package/src/agent-notice.ts +48 -0
  20. package/src/agent-team-whoami-http.test.ts +98 -0
  21. package/src/agent-teams-http.test.ts +330 -0
  22. package/src/agent-teams.ts +244 -0
  23. package/src/alias-baseline-2571.test.ts +162 -0
  24. package/src/alias-baseline.ts +113 -0
  25. package/src/alias-filter.test.ts +72 -0
  26. package/src/alias-filter.ts +42 -0
  27. package/src/all-status-cache.test.ts +31 -0
  28. package/src/all-status-cache.ts +37 -0
  29. package/src/anet-variant-real-daemon-http.test.ts +184 -0
  30. package/src/api-host-supervisors-can-create-nodes.test.ts +350 -0
  31. package/src/api-host-supervisors-fallback.test.ts +6 -7
  32. package/src/api-host-supervisors-runtime-readiness.test.ts +195 -0
  33. package/src/api-nodes-shape.test.ts +131 -4
  34. package/src/auth-abuse-counters.test.ts +144 -0
  35. package/src/auth-abuse-counters.ts +122 -0
  36. package/src/auth-layer-shape.test.ts +105 -0
  37. package/src/auth-password-change-cli-tokens-http.test.ts +423 -0
  38. package/src/auth-sessions-http.test.ts +260 -0
  39. package/src/auth-validate.test.ts +5 -1
  40. package/src/auth-weak-password-login.test.ts +176 -0
  41. package/src/auth.ts +641 -68
  42. package/src/backfill-node-ids-2664.test.ts +128 -0
  43. package/src/binding-generation-http.test.ts +141 -0
  44. package/src/blocked-exit-on-reply.test.ts +122 -0
  45. package/src/broadcast-fanout-2721.test.ts +149 -0
  46. package/src/broadcast-fanout.ts +117 -0
  47. package/src/build-commit-report-http.test.ts +218 -0
  48. package/src/build-info.test.ts +60 -0
  49. package/src/build-info.ts +85 -0
  50. package/src/chain-attempt-dedup.test.ts +447 -0
  51. package/src/clip.test.ts +36 -0
  52. package/src/clip.ts +48 -0
  53. package/src/clone-node.test.ts +269 -0
  54. package/src/clone-node.ts +289 -0
  55. package/src/codex-config-flags.ts +77 -0
  56. package/src/codex-fork-contract.ts +23 -0
  57. package/src/codex-fork-migration.test.ts +38 -0
  58. package/src/commhub-bin-args.test.ts +85 -0
  59. package/src/config-apply-sec1.test.ts +37 -0
  60. package/src/config-apply-validate.test.ts +188 -1
  61. package/src/config-apply-validate.ts +226 -3
  62. package/src/contracts/session-project-create.ts +14 -0
  63. package/src/contracts/session-source-delivery.ts +16 -0
  64. package/src/contracts/session-source-directory.ts +54 -0
  65. package/src/contracts/session-source-evidence.ts +72 -0
  66. package/src/contracts/session-source-execution.ts +24 -0
  67. package/src/contracts/session-source-transport.ts +18 -0
  68. package/src/cors-origins.test.ts +73 -0
  69. package/src/create-node-blocked-gate.test.ts +365 -0
  70. package/src/create-node-error-domain.test.ts +127 -0
  71. package/src/create-node-network-id.test.ts +91 -0
  72. package/src/create-node-tool-schema.test.ts +59 -0
  73. package/src/create-node-unicode-name.test.ts +126 -0
  74. package/src/create-node-validate.test.ts +199 -7
  75. package/src/create-node-validate.ts +232 -15
  76. package/src/create-node-workdir.test.ts +298 -0
  77. package/src/create-node.ts +88 -23
  78. package/src/daemon-provider-snapshots.test.ts +453 -0
  79. package/src/daemon-provider-snapshots.ts +327 -0
  80. package/src/daemon-token-owner-http.test.ts +346 -0
  81. package/src/dashboard-slash-routing-http.test.ts +109 -0
  82. package/src/db-adapter-guard.test.ts +148 -0
  83. package/src/db-adapter-translate.test.ts +128 -0
  84. package/src/db-adapter.ts +377 -91
  85. package/src/db-timestamp.test.ts +38 -0
  86. package/src/db-timestamp.ts +15 -0
  87. package/src/db.ts +1334 -154
  88. package/src/delivered-without-push.test.ts +140 -0
  89. package/src/department-groups-http.test.ts +209 -0
  90. package/src/department-groups-sync-http.test.ts +328 -0
  91. package/src/department-groups.ts +434 -0
  92. package/src/department-heads-http.test.ts +350 -0
  93. package/src/department-heads.ts +226 -0
  94. package/src/departments-agent-count.test.ts +139 -0
  95. package/src/departments-http.test.ts +185 -0
  96. package/src/departments-mcp-error-domain.test.ts +135 -0
  97. package/src/departments-mcp.test.ts +128 -0
  98. package/src/departments.ts +318 -0
  99. package/src/desktop-message-seam.test.ts +150 -0
  100. package/src/desktop-message.test.ts +368 -0
  101. package/src/dm-file-scope-http.test.ts +227 -0
  102. package/src/empty-node-sweeper.test.ts +104 -0
  103. package/src/empty-node-sweeper.ts +88 -0
  104. package/src/env-transport-gate-http.test.ts +240 -0
  105. package/src/env-transport-gate.ts +80 -0
  106. package/src/env-transport-policy.ts +56 -0
  107. package/src/etag-of.test.ts +57 -0
  108. package/src/event-loop-lag.test.ts +180 -0
  109. package/src/event-loop-lag.ts +201 -0
  110. package/src/expiry-counters.test.ts +187 -0
  111. package/src/expiry-counters.ts +227 -0
  112. package/src/expiry-evidence-db.test.ts +103 -0
  113. package/src/ext-token-shared.test.ts +60 -0
  114. package/src/ext-validation-regression.test.ts +10 -17
  115. package/src/external-schedule-edits-http.test.ts +321 -0
  116. package/src/external-schedule-edits-timestamps.test.ts +64 -0
  117. package/src/external-schedule-edits.ts +327 -0
  118. package/src/file-download-authz-dev-open.test.ts +1 -1
  119. package/src/file-download-authz.test.ts +25 -4
  120. package/src/file-download-date-bucket.test.ts +1 -1
  121. package/src/file-network-scope-dev-open.test.ts +1 -1
  122. package/src/file-network-scope.test.ts +7 -6
  123. package/src/group-membership-events-http.test.ts +264 -0
  124. package/src/group-messages-http.test.ts +483 -0
  125. package/src/group-messages.ts +297 -0
  126. package/src/health-anon-readers.ts +67 -0
  127. package/src/health-host-disk-2756.test.ts +71 -0
  128. package/src/health-identity-root.test.ts +98 -0
  129. package/src/health-redaction.test.ts +1599 -7
  130. package/src/health-status-reasons.test.ts +84 -0
  131. package/src/host-supervisor-identity-http.test.ts +152 -0
  132. package/src/host-supervisor-identity.ts +92 -0
  133. package/src/host-supervisors-daemon-version.test.ts +137 -0
  134. package/src/http-gzip.test.ts +94 -0
  135. package/src/http-gzip.ts +112 -0
  136. package/src/hub-catalog-read-http.test.ts +664 -0
  137. package/src/hub-provider-config.test.ts +166 -0
  138. package/src/hub-provider-config.ts +202 -0
  139. package/src/hub-timestamp.test.ts +38 -0
  140. package/src/hub-timestamp.ts +27 -0
  141. package/src/human-dm.ts +215 -0
  142. package/src/human-inbox.ts +42 -0
  143. package/src/inbox-caller.ts +49 -0
  144. package/src/inbox-count-sse.test.ts +318 -0
  145. package/src/inbox-count.ts +29 -0
  146. package/src/index.ts +6 -2
  147. package/src/license-state.test.ts +105 -0
  148. package/src/license-state.ts +48 -0
  149. package/src/lifecycle-error-domain.test.ts +149 -0
  150. package/src/list-ack-error-domain.test.ts +108 -0
  151. package/src/list-host-supervisors.test.ts +15 -4
  152. package/src/list-tasks-omit-default.test.ts +84 -0
  153. package/src/list-tasks-since-last.test.ts +100 -0
  154. package/src/list-tasks-since.test.ts +104 -0
  155. package/src/mcp-context-cost-http.test.ts +127 -0
  156. package/src/mcp-inflight.test.ts +92 -0
  157. package/src/mcp-inflight.ts +38 -0
  158. package/src/mcp-projects-events-http.test.ts +168 -0
  159. package/src/mcp-route-label-http.test.ts +120 -0
  160. package/src/mcp-write-network-resolution.test.ts +21 -0
  161. package/src/member-audit-network-id-http.test.ts +93 -0
  162. package/src/member-presence-http.test.ts +210 -0
  163. package/src/messages-ack-by-agent-http.test.ts +142 -0
  164. package/src/migrate-sqlite-to-pg.test.ts +47 -0
  165. package/src/migrate-sqlite-to-pg.ts +263 -0
  166. package/src/model-auth-notify-http.test.ts +181 -0
  167. package/src/model-auth-notify.ts +116 -0
  168. package/src/network-name-http.test.ts +75 -0
  169. package/src/network-quota-config.test.ts +100 -0
  170. package/src/network-rules-http.test.ts +169 -0
  171. package/src/network-rules.ts +129 -0
  172. package/src/network-scope.ts +222 -3
  173. package/src/network-token-membership-http.test.ts +186 -0
  174. package/src/node-alias-control.ts +12 -0
  175. package/src/node-attrs.test.ts +47 -2
  176. package/src/node-caller-identity-http.test.ts +1108 -0
  177. package/src/node-config-last-update.test.ts +126 -0
  178. package/src/node-config-last-update.ts +107 -0
  179. package/src/node-create-request-status-http.test.ts +105 -0
  180. package/src/node-daemon-bindings.test.ts +142 -0
  181. package/src/node-daemon-bindings.ts +135 -0
  182. package/src/node-failure-alert.test.ts +150 -0
  183. package/src/node-failure-alert.ts +177 -0
  184. package/src/node-files-transport.test.ts +350 -0
  185. package/src/node-health-codex-login.test.ts +120 -0
  186. package/src/node-health-dispatch-http.test.ts +373 -0
  187. package/src/node-health-guard-origin.test.ts +98 -0
  188. package/src/node-health-guard.ts +121 -0
  189. package/src/node-health-passthrough.test.ts +115 -0
  190. package/src/node-health-store.ts +101 -0
  191. package/src/node-id-alias.test.ts +190 -0
  192. package/src/node-identity-conflict-http.test.ts +269 -0
  193. package/src/node-identity-conflict.ts +142 -0
  194. package/src/node-identity-mismatch.test.ts +74 -0
  195. package/src/node-in-flight-tasks.ts +31 -0
  196. package/src/node-lifecycle-controllable.test.ts +64 -0
  197. package/src/node-lifecycle-controllable.ts +53 -0
  198. package/src/node-lifecycle-read-http.test.ts +257 -0
  199. package/src/node-lifecycle-read.ts +126 -0
  200. package/src/node-logs-transport.test.ts +266 -0
  201. package/src/node-peer-allowlist.test.ts +114 -0
  202. package/src/node-permissions-http.test.ts +901 -0
  203. package/src/node-permissions.ts +496 -0
  204. package/src/node-request-retention.test.ts +281 -0
  205. package/src/node-request-retention.ts +120 -0
  206. package/src/node-secret-rest-http.test.ts +190 -0
  207. package/src/node-secret-vault-inject.test.ts +132 -0
  208. package/src/node-security-write-gate.test.ts +72 -0
  209. package/src/node-serviceability.test.ts +86 -0
  210. package/src/node-serviceability.ts +124 -0
  211. package/src/node-session-control-http.test.ts +398 -0
  212. package/src/node-session-control.ts +316 -0
  213. package/src/node-skills-transport.test.ts +212 -0
  214. package/src/node-token-identity.ts +35 -0
  215. package/src/node-token-ownership.ts +51 -0
  216. package/src/node-token-privilege-http.test.ts +224 -0
  217. package/src/node-token-usage.test.ts +128 -0
  218. package/src/node-token-usage.ts +228 -0
  219. package/src/not-found-api-http.test.ts +67 -0
  220. package/src/observer-avatar-http.test.ts +103 -10
  221. package/src/observer-push.test.ts +76 -0
  222. package/src/opencode-catalog-report-http.test.ts +139 -0
  223. package/src/opencode-v2-catalog.test.ts +282 -0
  224. package/src/opencode-v2-catalog.ts +357 -0
  225. package/src/package-self-contained.test.ts +32 -0
  226. package/src/package-version-consistency.test.ts +25 -0
  227. package/src/parent-infer.test.ts +82 -0
  228. package/src/parent-infer.ts +110 -0
  229. package/src/parent-source-marker.test.ts +70 -0
  230. package/src/parent-source-orphan.test.ts +121 -0
  231. package/src/password-network-tokens.ts +25 -0
  232. package/src/peer-reply-atomic.test.ts +462 -0
  233. package/src/peer-reply-capability.test.ts +70 -0
  234. package/src/pg-worker.ts +87 -0
  235. package/src/poll-pacing.test.ts +74 -0
  236. package/src/poll-pacing.ts +123 -0
  237. package/src/probe-provider-error-domain.test.ts +145 -0
  238. package/src/project-dir-warn-clear-http.test.ts +132 -0
  239. package/src/project-viewer-can-http.test.ts +116 -0
  240. package/src/provider-skill-error-domain.test.ts +130 -0
  241. package/src/provider-tools-shape.test.ts +165 -0
  242. package/src/push.test.ts +20 -10
  243. package/src/push.ts +373 -9
  244. package/src/redact-tokens.test.ts +86 -0
  245. package/src/redact-tokens.ts +43 -0
  246. package/src/rejection-counters.test.ts +72 -0
  247. package/src/rejection-counters.ts +173 -0
  248. package/src/rename.ts +38 -10
  249. package/src/reply-target-derivation.test.ts +96 -0
  250. package/src/report-status-handover-capabilities-http.test.ts +124 -0
  251. package/src/report-status-host-schema.test.ts +272 -0
  252. package/src/report-status-resume-id-handover.test.ts +184 -0
  253. package/src/report-status-secret-keys.test.ts +140 -0
  254. package/src/require-explicit-test-db.ts +9 -0
  255. package/src/requirement-due-reminders-http.test.ts +620 -0
  256. package/src/requirement-due-reminders.ts +416 -0
  257. package/src/requirement-events-http.test.ts +318 -0
  258. package/src/requirement-events.test.ts +45 -0
  259. package/src/requirement-events.ts +144 -0
  260. package/src/requirement-notify.ts +165 -0
  261. package/src/requirement-participant-notify-http.test.ts +313 -0
  262. package/src/requirement-tag-ops-http.test.ts +454 -0
  263. package/src/requirement-tag-tree-http.test.ts +275 -0
  264. package/src/requirement-tag-tree.ts +127 -0
  265. package/src/requirement-tags.ts +102 -0
  266. package/src/requirements-abandoned-http.test.ts +236 -0
  267. package/src/requirements-assignee-drift.test.ts +154 -0
  268. package/src/requirements-comment-http.test.ts +174 -0
  269. package/src/requirements-completed-at-migration.test.ts +70 -0
  270. package/src/requirements-errors-mcp-http.test.ts +164 -0
  271. package/src/requirements-errors.ts +158 -0
  272. package/src/requirements-etag-http.test.ts +91 -0
  273. package/src/requirements-http.test.ts +709 -0
  274. package/src/requirements-last-event-http.test.ts +349 -0
  275. package/src/requirements-list-mcp-slim-http.test.ts +155 -0
  276. package/src/requirements-list-slim-http.test.ts +324 -0
  277. package/src/requirements-mcp.test.ts +180 -0
  278. package/src/requirements-migrate.ts +283 -0
  279. package/src/requirements-owner-strict-mcp-http.test.ts +145 -0
  280. package/src/requirements-people-http.test.ts +114 -0
  281. package/src/requirements-people-mcp-http.test.ts +231 -0
  282. package/src/requirements-people.ts +196 -0
  283. package/src/requirements-priority-lowest.test.ts +114 -0
  284. package/src/requirements-projects-network-echo.test.ts +57 -0
  285. package/src/requirements-projects-parent-http.test.ts +123 -0
  286. package/src/requirements-search-http.test.ts +182 -0
  287. package/src/requirements-search.test.ts +32 -0
  288. package/src/requirements-search.ts +145 -0
  289. package/src/requirements-seq-http.test.ts +193 -0
  290. package/src/requirements-seq-migration.test.ts +63 -0
  291. package/src/requirements-start-date.test.ts +125 -0
  292. package/src/requirements-stats-http.test.ts +357 -0
  293. package/src/requirements-stats.ts +195 -0
  294. package/src/requirements-status-participants-http.test.ts +222 -0
  295. package/src/requirements-upgrade-e2e.test.ts +126 -0
  296. package/src/requirements-upgrade-migration.test.ts +98 -0
  297. package/src/requirements.ts +2205 -0
  298. package/src/resolve-port.test.ts +57 -0
  299. package/src/resolve-port.ts +44 -0
  300. package/src/rest-alias-network-fallback-http.test.ts +123 -0
  301. package/src/rest-alias-network-fallback.test.ts +60 -0
  302. package/src/rest-alias-network-fallback.ts +65 -0
  303. package/src/rest-explicit-columns-http.test.ts +266 -0
  304. package/src/rest-identity.test.ts +130 -0
  305. package/src/rest-identity.ts +141 -0
  306. package/src/rest-projections.ts +72 -0
  307. package/src/rest-read-network-real-chain.test.ts +97 -0
  308. package/src/rest-write-network-resolution.test.ts +133 -0
  309. package/src/restart-readiness-http.test.ts +121 -0
  310. package/src/restricted-files.ts +76 -0
  311. package/src/retention-first-sweep-quiet.test.ts +31 -0
  312. package/src/retention.test.ts +100 -40
  313. package/src/retention.ts +423 -104
  314. package/src/route-callers-http.test.ts +120 -0
  315. package/src/route-timing.test.ts +218 -0
  316. package/src/route-timing.ts +262 -0
  317. package/src/rules-file-duplicate-alias.test.ts +234 -0
  318. package/src/rules-file-session-target.test.ts +207 -0
  319. package/src/rules-file-transport.test.ts +280 -0
  320. package/src/runtime-label.test.ts +22 -0
  321. package/src/runtime-label.ts +21 -0
  322. package/src/runtime-readiness.ts +90 -0
  323. package/src/schedule-agent-mcp-http.test.ts +486 -0
  324. package/src/schedule-agent.ts +252 -0
  325. package/src/schedule-starved.test.ts +92 -0
  326. package/src/schedule-starved.ts +114 -0
  327. package/src/scheduled-backoff-http.test.ts +203 -0
  328. package/src/scheduled-backoff.ts +64 -0
  329. package/src/scheduled-doorbell-nodeless-session.test.ts +134 -0
  330. package/src/scheduled-failure-backoff-2622.test.ts +145 -0
  331. package/src/scheduled-failure-code.test.ts +73 -0
  332. package/src/scheduled-failure-code.ts +105 -0
  333. package/src/scheduled-failures-http.test.ts +279 -0
  334. package/src/scheduled-failures.ts +425 -0
  335. package/src/scheduled-noprogress-backoff-2622.test.ts +163 -0
  336. package/src/scheduled-offline-backoff-probe.test.ts +56 -0
  337. package/src/scheduled-offline.test.ts +131 -0
  338. package/src/scheduled-offline.ts +66 -0
  339. package/src/scheduled-outcome-guidance-http.test.ts +139 -0
  340. package/src/scheduled-outcome-guidance.ts +9 -0
  341. package/src/scheduled-reply-unread-http.test.ts +212 -0
  342. package/src/scheduled-requirement-wake-http.test.ts +289 -0
  343. package/src/scheduled-requirement-wake.ts +125 -0
  344. package/src/scheduled-run-terminal.test.ts +290 -0
  345. package/src/scheduled-skip-blocking-task.test.ts +120 -0
  346. package/src/scheduled-skip-path-backoff-2622.test.ts +98 -0
  347. package/src/scheduled-stuck-http.test.ts +316 -0
  348. package/src/scheduled-stuck-notice-cap.test.ts +80 -0
  349. package/src/scheduled-stuck.ts +219 -0
  350. package/src/scheduled-tasks-http.test.ts +679 -0
  351. package/src/scheduled-tasks.ts +964 -0
  352. package/src/scheduled-work-outcome-http.test.ts +154 -0
  353. package/src/scheduled-work-outcome.ts +50 -0
  354. package/src/scoped-secrets.ts +167 -0
  355. package/src/secret-echo-negative-control.test.ts +118 -0
  356. package/src/send-dedup-request-id.test.ts +229 -0
  357. package/src/send-reply-agent-warning.test.ts +38 -38
  358. package/src/send-reply-alias-optional.test.ts +131 -0
  359. package/src/send-reply-attachments.test.ts +28 -7
  360. package/src/send_dedup.test.ts +54 -0
  361. package/src/send_dedup.ts +52 -6
  362. package/src/serve-error.test.ts +73 -0
  363. package/src/serve-error.ts +56 -0
  364. package/src/server.ts +5033 -377
  365. package/src/session-fork-store.test.ts +43 -0
  366. package/src/session-fork-store.ts +51 -0
  367. package/src/session-project-attach-migration.test.ts +22 -0
  368. package/src/session-project-attach-native.test.ts +121 -0
  369. package/src/session-project-create-http.test.ts +407 -0
  370. package/src/session-project-create-native.test.ts +290 -0
  371. package/src/session-project-create.ts +159 -0
  372. package/src/session-source-admission-store.ts +58 -0
  373. package/src/session-source-create.test.ts +155 -0
  374. package/src/session-source-create.ts +97 -0
  375. package/src/session-source-delivery.ts +109 -0
  376. package/src/session-source-directory-http.test.ts +192 -0
  377. package/src/session-source-evidence.test.ts +898 -0
  378. package/src/session-source-evidence.ts +191 -0
  379. package/src/session-source-execution.ts +87 -0
  380. package/src/session-source-grant.test.ts +117 -0
  381. package/src/session-source-grant.ts +78 -0
  382. package/src/session-source-issuer.test.ts +250 -0
  383. package/src/session-source-issuer.ts +164 -0
  384. package/src/session-source-transport.ts +375 -0
  385. package/src/session-task-on-dispatch.ts +14 -0
  386. package/src/session-token-ownership-http.test.ts +122 -0
  387. package/src/shared/codex-inventory.ts +41 -0
  388. package/src/shared/daemon-provider-login.ts +31 -0
  389. package/src/shared/daemon-provider-snapshot.ts +52 -0
  390. package/src/shared/external-schedule-contract.ts +60 -0
  391. package/src/shared/node-name.test.ts +62 -0
  392. package/src/shared/node-name.ts +161 -0
  393. package/src/shared/probe-host-allowlist-drift.test.ts +45 -0
  394. package/src/shared/provider-application.ts +29 -0
  395. package/src/shared/provider-collection.ts +14 -0
  396. package/src/shared/provider-initialization.ts +8 -0
  397. package/src/shared/reserved-env-drift.test.ts +10 -0
  398. package/src/shared/scoped-secret-contract.ts +5 -0
  399. package/src/shared/task-content-limit-drift.test.ts +28 -0
  400. package/src/shared/task-content-limit.ts +25 -0
  401. package/src/side-thread-command-transport.test.ts +312 -0
  402. package/src/side-thread-command-transport.ts +318 -0
  403. package/src/side-thread-http-integration.test.ts +233 -0
  404. package/src/side-thread-http.ts +504 -0
  405. package/src/side-thread-production.test.ts +72 -0
  406. package/src/side-thread-production.ts +118 -0
  407. package/src/side-thread.test.ts +1067 -0
  408. package/src/side-thread.ts +2499 -0
  409. package/src/skillhub-http.test.ts +144 -0
  410. package/src/sqlite-close-checkpoint.test.ts +78 -0
  411. package/src/start-node.test.ts +265 -0
  412. package/src/start-request-error-domain.test.ts +182 -0
  413. package/src/start-skill-error-domain.test.ts +122 -0
  414. package/src/stats-versions-http.test.ts +65 -0
  415. package/src/status-alias-filter-http.test.ts +106 -0
  416. package/src/status-alias-resolver-http.test.ts +163 -0
  417. package/src/status-alias-resolver.ts +19 -0
  418. package/src/status-node-id-filter-http.test.ts +161 -0
  419. package/src/status-node-secrets-capable-http.test.ts +44 -0
  420. package/src/status-read-cache-http.test.ts +229 -0
  421. package/src/status-read-cache.ts +129 -0
  422. package/src/stop-delete-node.test.ts +567 -1
  423. package/src/task-access-http.test.ts +407 -0
  424. package/src/task-access.ts +420 -0
  425. package/src/task-activity.ts +60 -0
  426. package/src/task-auth-origin-http.test.ts +93 -0
  427. package/src/task-auth-origin.test.ts +24 -0
  428. package/src/task-auth-origin.ts +7 -0
  429. package/src/task-consumption.test.ts +512 -0
  430. package/src/task-diagnostic-http.test.ts +149 -0
  431. package/src/task-diagnostic.test.ts +115 -0
  432. package/src/task-diagnostic.ts +118 -0
  433. package/src/task-expiry-notice-http.test.ts +298 -0
  434. package/src/task-expiry-notice.ts +318 -0
  435. package/src/task-idempotency-mcp.test.ts +148 -0
  436. package/src/task-idempotency.test.ts +76 -0
  437. package/src/task-idempotency.ts +81 -0
  438. package/src/task-late-replies.ts +54 -0
  439. package/src/task-late-reply-http.test.ts +227 -0
  440. package/src/task-lifecycle-watcher-busy.test.ts +114 -0
  441. package/src/task-lifecycle-watcher.test.ts +209 -0
  442. package/src/task-lifecycle-watcher.ts +109 -0
  443. package/src/task-network-resolution-http.test.ts +140 -0
  444. package/src/task-not-found-error-domain.test.ts +117 -0
  445. package/src/task-offline-delivery-2668.test.ts +119 -0
  446. package/src/task-offline-delivery.ts +81 -0
  447. package/src/task-orphan-http.test.ts +287 -0
  448. package/src/task-orphan.ts +119 -0
  449. package/src/task-queue-ahead-http.test.ts +309 -0
  450. package/src/task-queue-ahead-scale.test.ts +236 -0
  451. package/src/task-queue-ahead.ts +186 -0
  452. package/src/task-rejection-log-http.test.ts +160 -0
  453. package/src/task-rejection-log.ts +61 -0
  454. package/src/task-sender-http.test.ts +143 -0
  455. package/src/task-stale-open-http.test.ts +292 -0
  456. package/src/task-stale-open.ts +103 -0
  457. package/src/tasks-pagination-http.test.ts +141 -0
  458. package/src/team-rules-status-http.test.ts +90 -0
  459. package/src/team-rules-status.test.ts +59 -0
  460. package/src/team-rules-status.ts +72 -0
  461. package/src/tmux-allowlist.test.ts +48 -0
  462. package/src/token-usage-http.test.ts +156 -0
  463. package/src/tool-audience-http.test.ts +266 -0
  464. package/src/tool-audience.ts +130 -0
  465. package/src/tools-list-json-schema.test.ts +94 -0
  466. package/src/tools.ts +4530 -471
  467. package/src/update-node-config-error-domain.test.ts +107 -0
  468. package/src/uploads-http.test.ts +6 -4
  469. package/src/uploads.ts +23 -4
  470. package/src/user-avatar-http.test.ts +74 -0
  471. package/src/user-avatar-image.ts +160 -0
  472. package/src/user-avatar-migration.test.ts +25 -0
  473. package/src/user-avatar-upload-http.test.ts +353 -0
  474. package/src/user-inbox-by-agent-http.test.ts +189 -0
  475. package/src/user-inbox-netid-notnull.test.ts +122 -0
  476. package/src/user-inbox-read-http.test.ts +223 -0
  477. package/src/user-inbox-schema.test.ts +54 -0
  478. package/src/version-stats.test.ts +66 -0
  479. package/src/version-stats.ts +109 -0
@@ -0,0 +1,263 @@
1
+ /**
2
+ * RFC-039 S5 — offline copy of a Hub's SQLite database into an EMPTY
3
+ * PostgreSQL database.
4
+ *
5
+ * commhub-server migrate-to-pg --from <sqlite file> --to <postgres url>
6
+ * [--dry-run] [--i-know-this-is-a-copy]
7
+ *
8
+ * Contract:
9
+ * - offline: no running process may have the source (or its -wal/-shm)
10
+ * open (checked through /proc on Linux). A stopped Hub normally leaves a
11
+ * -wal behind — that is expected, and its contents are included: the
12
+ * source is opened read-only and read through a `VACUUM INTO` snapshot in
13
+ * a private temp dir.
14
+ * - never the live Hub's database: a source whose real path is under
15
+ * ~/.commhub is refused unless --i-know-this-is-a-copy is given.
16
+ * - empty target only: the target's `public` schema must hold no tables,
17
+ * views, sequences or functions. The schema is then built by the Hub's
18
+ * own module graph (no second copy of the DDL).
19
+ * - one transaction: every table is copied and verified — row counts plus
20
+ * a SHA-256 over canonicalised rows — before COMMIT; any mismatch or
21
+ * error rolls everything back.
22
+ * - --dry-run does all of the above, rolls back, and drops what it created,
23
+ * leaving the target as it found it.
24
+ * - the target URL is printed with credentials removed.
25
+ */
26
+ import { Database } from "bun:sqlite";
27
+ import { createHash } from "node:crypto";
28
+ import { existsSync, mkdtempSync, readdirSync, readlinkSync, realpathSync, rmSync, statSync } from "node:fs";
29
+ import { tmpdir } from "node:os";
30
+ import { join, resolve, sep } from "node:path";
31
+ import { PgAdapter, redactPgUrl, type DbAdapter } from "./db-adapter.js";
32
+
33
+ export type MigrateOptions = {
34
+ from: string;
35
+ to: string;
36
+ dryRun?: boolean;
37
+ allowCommhubCopy?: boolean;
38
+ home?: string;
39
+ log?: (line: string) => void;
40
+ };
41
+
42
+ export type TableReport = { table: string; rows: number; sha256: string };
43
+ export type MigrateReport = { ok: true; dryRun: boolean; tables: TableReport[] };
44
+
45
+ class DryRunRollback extends Error {}
46
+
47
+ /** Refusals are thrown as MigrateRefused so the CLI can print them without a stack. */
48
+ export class MigrateRefused extends Error {}
49
+
50
+ function refuse(message: string): never {
51
+ throw new MigrateRefused(`[migrate-to-pg] REFUSING: ${message}`);
52
+ }
53
+
54
+ const quoteIdent = (name: string) => `"${name.replace(/"/g, '""')}"`;
55
+
56
+ /** One canonical text per value, identical for bun:sqlite and PgAdapter output. */
57
+ function canonical(value: unknown): unknown {
58
+ if (value === null || value === undefined) return null;
59
+ if (typeof value === "bigint") return `i:${value.toString()}`;
60
+ if (typeof value === "number") return Number.isInteger(value) ? `i:${value}` : `f:${value}`;
61
+ if (value instanceof Uint8Array) return `b:${Buffer.from(value).toString("hex")}`;
62
+ if (typeof value === "string" && /^-?\d+$/.test(value) && value.length > 15) return `i:${value}`; // unsafe int8 comes back as text
63
+ return `s:${String(value)}`;
64
+ }
65
+
66
+ /** Order-independent digest: hash each row, sort the row hashes, hash the list. */
67
+ function tableDigest(rows: Iterable<Record<string, unknown>>, cols: string[]): { rows: number; sha256: string } {
68
+ const rowHashes: string[] = [];
69
+ for (const row of rows) {
70
+ rowHashes.push(createHash("sha256").update(JSON.stringify(cols.map((c) => canonical(row[c])))).digest("hex"));
71
+ }
72
+ rowHashes.sort();
73
+ return { rows: rowHashes.length, sha256: createHash("sha256").update(rowHashes.join("\n")).digest("hex") };
74
+ }
75
+
76
+ function bindValue(value: unknown): unknown {
77
+ if (typeof value === "bigint") {
78
+ const n = Number(value);
79
+ return Number.isSafeInteger(n) ? n : value.toString();
80
+ }
81
+ return value;
82
+ }
83
+
84
+ function checkSource(from: string, home: string, allowCommhubCopy: boolean): string {
85
+ const abs = resolve(from);
86
+ if (!existsSync(abs)) refuse(`source ${abs} does not exist`);
87
+ const real = realpathSync(abs);
88
+ if (!statSync(real).isFile()) refuse(`source ${real} is not a file`);
89
+ const commhubDir = join(home, ".commhub");
90
+ const guarded = existsSync(commhubDir) ? realpathSync(commhubDir) : resolve(commhubDir);
91
+ if ((real === guarded || real.startsWith(guarded + sep)) && !allowCommhubCopy) {
92
+ refuse(`source ${real} is under ${guarded}, the live Hub's directory. Stop the Hub, copy the database elsewhere, ` +
93
+ "and migrate the copy — or pass --i-know-this-is-a-copy if this file already is one");
94
+ }
95
+ const holders = processesHolding([real, `${real}-wal`, `${real}-shm`]);
96
+ if (holders === null) {
97
+ console.warn("[migrate-to-pg] cannot inspect open files on this platform — make sure the Hub using this database is stopped");
98
+ } else if (holders.length) {
99
+ refuse(`${real} is open in running process(es) ${holders.join(", ")} — stop the Hub first`);
100
+ }
101
+ return real;
102
+ }
103
+
104
+ /** PIDs (other than ours) with any of `paths` open; null where /proc is unavailable. */
105
+ function processesHolding(paths: string[]): number[] | null {
106
+ if (!existsSync("/proc/self/fd")) return null;
107
+ const wanted = new Set(paths);
108
+ const holders: number[] = [];
109
+ for (const entry of readdirSync("/proc")) {
110
+ const pid = Number(entry);
111
+ if (!Number.isInteger(pid) || pid === process.pid) continue;
112
+ let fds: string[];
113
+ try { fds = readdirSync(`/proc/${pid}/fd`); } catch { continue; } // gone, or another user's
114
+ for (const fd of fds) {
115
+ let target = "";
116
+ try { target = readlinkSync(`/proc/${pid}/fd/${fd}`); } catch { continue; }
117
+ if (wanted.has(target.replace(/ \(deleted\)$/, ""))) { holders.push(pid); break; }
118
+ }
119
+ }
120
+ return holders;
121
+ }
122
+
123
+ function publicObjectCount(pg: PgAdapter): number {
124
+ const row = pg.get<{ n: number }>(
125
+ `SELECT (SELECT COUNT(*) FROM information_schema.tables WHERE table_schema = 'public')
126
+ + (SELECT COUNT(*) FROM information_schema.sequences WHERE sequence_schema = 'public')
127
+ + (SELECT COUNT(*) FROM information_schema.routines WHERE routine_schema = 'public') AS n`,
128
+ );
129
+ return Number(row?.n ?? 0);
130
+ }
131
+
132
+ function dropEverythingInPublic(pg: DbAdapter) {
133
+ // Only ever called on a target that was verified empty before we started,
134
+ // so everything here was created by this run.
135
+ pg.exec(`DO $$ DECLARE r record; BEGIN
136
+ FOR r IN SELECT tablename FROM pg_tables WHERE schemaname = 'public' LOOP
137
+ EXECUTE 'DROP TABLE IF EXISTS public.' || quote_ident(r.tablename) || ' CASCADE';
138
+ END LOOP;
139
+ FOR r IN SELECT p.oid::regprocedure AS sig FROM pg_proc p JOIN pg_namespace n ON n.oid = p.pronamespace WHERE n.nspname = 'public' LOOP
140
+ EXECUTE 'DROP FUNCTION IF EXISTS ' || r.sig || ' CASCADE';
141
+ END LOOP;
142
+ FOR r IN SELECT sequencename FROM pg_sequences WHERE schemaname = 'public' LOOP
143
+ EXECUTE 'DROP SEQUENCE IF EXISTS public.' || quote_ident(r.sequencename) || ' CASCADE';
144
+ END LOOP;
145
+ END $$`);
146
+ }
147
+
148
+ export async function migrateSqliteToPg(opts: MigrateOptions): Promise<MigrateReport> {
149
+ const log = opts.log ?? ((line: string) => console.log(line));
150
+ const home = opts.home ?? process.env.HOME ?? "";
151
+ if (!/^postgres(ql)?:\/\//.test(opts.to)) refuse("--to must be a postgres:// or postgresql:// URL");
152
+ const source = checkSource(opts.from, home, !!opts.allowCommhubCopy);
153
+ log(`[migrate-to-pg] source ${source}`);
154
+ log(`[migrate-to-pg] target ${redactPgUrl(opts.to)}${opts.dryRun ? " (dry run)" : ""}`);
155
+
156
+ // Empty-target check on a connection of our own, before the schema exists.
157
+ const probe = new PgAdapter(opts.to);
158
+ const existing = publicObjectCount(probe);
159
+ probe.close();
160
+ if (existing > 0) refuse(`target schema "public" is not empty (${existing} tables/sequences/functions). Migrate only into a new, empty database`);
161
+
162
+ // Snapshot the source: a consistent read that cannot touch the original.
163
+ const snapDir = mkdtempSync(join(tmpdir(), "anet-migrate-"));
164
+ const snapshot = join(snapDir, "snapshot.db");
165
+ try {
166
+ const original = new Database(source, { readonly: true });
167
+ original.exec(`VACUUM INTO '${snapshot.replace(/'/g, "''")}'`);
168
+ original.close();
169
+ const src = new Database(snapshot, { readonly: true, safeIntegers: true });
170
+
171
+ // Build the target schema exactly as the Hub does: import its module graph
172
+ // with DATABASE_URL pointing at the target.
173
+ delete process.env.COMMHUB_DB;
174
+ process.env.DATABASE_URL = opts.to;
175
+ await import("./server.js");
176
+ const { db } = await import("./db.js");
177
+ if (db.dialect !== "postgres") throw new Error("schema build did not select PostgreSQL");
178
+
179
+ const tables = (src.query("SELECT name FROM sqlite_master WHERE type = 'table' AND name NOT LIKE 'sqlite_%' ORDER BY name").all() as { name: string }[])
180
+ .map((r) => r.name);
181
+ const report: TableReport[] = [];
182
+
183
+ try {
184
+ db.transaction(() => {
185
+ for (const table of tables) {
186
+ const srcCols = (src.query(`PRAGMA table_info(${quoteIdent(table)})`).all() as { name: string }[]).map((c) => c.name);
187
+ const tgtCols = new Set(db.all<{ column_name: string }>(
188
+ "SELECT column_name FROM information_schema.columns WHERE table_schema = 'public' AND table_name = ?1", table,
189
+ ).map((c) => c.column_name));
190
+ const srcCount = Number((src.query(`SELECT COUNT(*) AS n FROM ${quoteIdent(table)}`).get() as { n: bigint | number }).n);
191
+ if (tgtCols.size === 0) {
192
+ if (srcCount > 0) throw new Error(`table ${table} (${srcCount} rows) does not exist in the Hub's PostgreSQL schema`);
193
+ log(`[migrate-to-pg] skip ${table}: not in the PostgreSQL schema, and empty in the source`);
194
+ continue;
195
+ }
196
+ const missing = srcCols.filter((c) => !tgtCols.has(c));
197
+ if (missing.length && srcCount > 0) throw new Error(`table ${table}: column(s) ${missing.join(", ")} do not exist in PostgreSQL`);
198
+ const cols = srcCols.filter((c) => tgtCols.has(c));
199
+ // SQLite's implicit rowid carries insertion order; PostgreSQL keeps it
200
+ // in a real `rowid` column on the tables that sort by it (RFC-039 F3).
201
+ const copyRowid = tgtCols.has("rowid") && !srcCols.includes("rowid");
202
+ const selectCols = [...(copyRowid ? ["rowid AS rowid"] : []), ...cols.map(quoteIdent)].join(", ");
203
+ const insertCols = [...(copyRowid ? ["rowid"] : []), ...cols];
204
+
205
+ // Triggers are off only while this table is being filled. Re-enabled
206
+ // in `finally` so no path — including a failed batch — leaves them
207
+ // off; a rollback also restores them (DDL is transactional in PG).
208
+ db.exec(`ALTER TABLE ${quoteIdent(table)} DISABLE TRIGGER USER`);
209
+ try {
210
+ db.run(`DELETE FROM ${quoteIdent(table)}`); // rows the schema bootstrap seeded; the source is authoritative
211
+ const perBatch = Math.max(1, Math.floor(30000 / insertCols.length));
212
+ const stmt = src.query(`SELECT ${selectCols} FROM ${quoteIdent(table)} ORDER BY rowid LIMIT ?1 OFFSET ?2`);
213
+ for (let offset = 0; offset < srcCount; offset += perBatch) {
214
+ const rows = stmt.all(perBatch, offset) as Record<string, unknown>[];
215
+ if (!rows.length) break;
216
+ const params: unknown[] = [];
217
+ const tuples = rows.map((row) => `(${insertCols.map((c) => { params.push(bindValue(row[c])); return `?${params.length}`; }).join(", ")})`);
218
+ db.run(`INSERT INTO ${quoteIdent(table)} (${insertCols.map(quoteIdent).join(", ")}) VALUES ${tuples.join(", ")}`, params);
219
+ }
220
+ } finally {
221
+ db.exec(`ALTER TABLE ${quoteIdent(table)} ENABLE TRIGGER USER`);
222
+ }
223
+
224
+ // Sequences behind BIGSERIAL columns continue after the copied ids.
225
+ for (const seq of db.all<{ column_name: string }>(
226
+ "SELECT column_name FROM information_schema.columns WHERE table_schema = 'public' AND table_name = ?1 AND column_default LIKE 'nextval(%'", table,
227
+ )) {
228
+ db.get(`SELECT setval(pg_get_serial_sequence(?1, ?2), COALESCE((SELECT MAX(${quoteIdent(seq.column_name)}) FROM ${quoteIdent(table)}), 0) + 1, false)`,
229
+ table, seq.column_name);
230
+ }
231
+
232
+ // Verify before COMMIT.
233
+ const hashCols = copyRowid ? ["rowid", ...cols] : cols;
234
+ const srcDigest = tableDigest(src.query(`SELECT ${selectCols} FROM ${quoteIdent(table)}`).all() as Record<string, unknown>[], hashCols);
235
+ const tgtDigest = tableDigest(db.all(`SELECT ${hashCols.map(quoteIdent).join(", ")} FROM ${quoteIdent(table)}`), hashCols);
236
+ if (srcDigest.rows !== tgtDigest.rows || srcDigest.sha256 !== tgtDigest.sha256) {
237
+ throw new Error(`verification failed for ${table}: source ${srcDigest.rows} rows ${srcDigest.sha256.slice(0, 12)}, ` +
238
+ `target ${tgtDigest.rows} rows ${tgtDigest.sha256.slice(0, 12)}`);
239
+ }
240
+ report.push({ table, rows: srcDigest.rows, sha256: srcDigest.sha256 });
241
+ log(`[migrate-to-pg] ${table}: ${srcDigest.rows} rows, sha256 ${srcDigest.sha256.slice(0, 16)} ✓`);
242
+ }
243
+ if (opts.dryRun) throw new DryRunRollback("dry run");
244
+ });
245
+ } catch (e) {
246
+ const rows = report.reduce((n, t) => n + t.rows, 0);
247
+ dropEverythingInPublic(db);
248
+ src.close();
249
+ if (!(e instanceof DryRunRollback)) {
250
+ const verify = e instanceof Error && e.message.startsWith("verification failed") ? "MISMATCH" : "NOT-REACHED";
251
+ log(`[migrate-to-pg] SUMMARY result=FAILED tables_verified=${report.length}/${tables.length} rows=${rows} verify=${verify} — rolled back, target left empty`);
252
+ throw e;
253
+ }
254
+ log(`[migrate-to-pg] SUMMARY result=DRY-RUN tables=${report.length} rows=${rows} verify=OK — rolled back, target left empty`);
255
+ return { ok: true, dryRun: true, tables: report };
256
+ }
257
+ src.close();
258
+ log(`[migrate-to-pg] SUMMARY result=COMMITTED tables=${report.length} rows=${report.reduce((n, t) => n + t.rows, 0)} verify=OK`);
259
+ return { ok: true, dryRun: false, tables: report };
260
+ } finally {
261
+ rmSync(snapDir, { recursive: true, force: true });
262
+ }
263
+ }
@@ -0,0 +1,181 @@
1
+ // #462 —— 节点模型登录失效 → 通知节点主人一次。
2
+ //
3
+ // 钉住:
4
+ // 1. 翻转判定(纯函数):进入 revoked/expired 发一次;坏→坏不再发(含 revoked⇄expired);回到 ok 才重新上膛;
5
+ // unknown / 没报既不发也不上膛。
6
+ // 2. 真 report_status(节点令牌):ok→expired→expired→ok→expired = 恰好 2 条,只给节点主人;
7
+ // 网络 owner 和别的成员 0 条。正文带别名、原因、`codex login` 修法,不教人拷别人的 auth.json。
8
+ // 3. 别的节点 / 用户令牌替它报坏状态 → 不发(与 #448 同一条「只有本节点令牌能替自己说健康」)。
9
+ // 4. Hub 重启(内存标记清空)后第一眼看到坏状态:主人还有没读的同类消息 → 不再发;读过了 → 发。
10
+ //
11
+ // 跑法:cd server && COMMHUB_DB=/tmp/x.db bun test src/model-auth-notify-http.test.ts
12
+ // PG:COMMHUB_TEST_PG_URL=… COMMHUB_PG_EXPERIMENTAL=1(tests/test2123-hub-postgres-ladder 里注册)
13
+ import { afterAll, beforeAll, beforeEach, describe, expect, test } from "bun:test";
14
+ import { mkdtempSync } from "node:fs";
15
+ import { join } from "node:path";
16
+ import { tmpdir } from "node:os";
17
+ import { Client } from "@modelcontextprotocol/sdk/client/index.js";
18
+ import { InMemoryTransport } from "@modelcontextprotocol/sdk/inMemory.js";
19
+ import { McpServer } from "@modelcontextprotocol/sdk/server/mcp.js";
20
+ import { addNetworkMember, createNetworkTokenForNode, register } from "./auth.js";
21
+ import { db } from "./db.js";
22
+ import { registerTools } from "./tools.js";
23
+ import { clearNodeHealthStore } from "./node-health-store.js";
24
+ import { __resetModelAuthNoticesForTest, decideModelAuthNotice, MODEL_AUTH_NOTICE_KIND, modelAuthNoticeText } from "./model-auth-notify.js";
25
+
26
+ const dir = mkdtempSync(join(tmpdir(), "anet-model-auth-notify-"));
27
+ const activeDbPath = process.env.COMMHUB_DB ?? (process.env.COMMHUB_TEST_PG_URL ? "postgres" : undefined);
28
+ if (!activeDbPath) throw new Error("model-auth-notify requires COMMHUB_DB (or COMMHUB_TEST_PG_URL) before module import");
29
+
30
+ const PW = "ModelAuthNotify123!";
31
+ const stamp = Date.now();
32
+ const NODE = `ma-node-${stamp}`;
33
+ const NODE_ID = `n_ma_node_${stamp}`;
34
+ const PEER = `ma-peer-${stamp}`;
35
+ const PEER_ID = `n_ma_peer_${stamp}`;
36
+ let netId = "";
37
+ let bossId = "", noraId = "", ottoId = "";
38
+ let nodeTokenId = "", peerTokenId = "";
39
+
40
+ async function connectAs(alias: string, userId: string, tokenId: string, isNetworkToken = true) {
41
+ const s = new McpServer({ name: "model-auth-notify", version: "1" });
42
+ registerTools(s, undefined, netId, userId, alias, isNetworkToken, tokenId);
43
+ const client = new Client({ name: "model-auth-notify-client", version: "1" });
44
+ const [ct, st] = InMemoryTransport.createLinkedPair();
45
+ await s.connect(st);
46
+ await client.connect(ct);
47
+ const report = async (model_auth: string | undefined, asAlias = NODE, nodeId = NODE_ID) => {
48
+ const r: any = await client.callTool({
49
+ name: "report_status",
50
+ arguments: { resume_id: `sdk-${nodeId}`, alias: asAlias, status: "idle", node_id: nodeId, network_id: netId, health: { bridge: "ok", ...(model_auth ? { model_auth } : {}) } },
51
+ });
52
+ expect(r.isError === true).toBe(false);
53
+ };
54
+ return { report, close: async () => { await client.close(); await s.close(); } };
55
+ }
56
+
57
+ const notices = (userId: string) => db.all<{ message_id: string; from_session: string; title: string; content: string; severity: string; meta_json: string; acked: number }>(
58
+ "SELECT message_id, from_session, title, content, severity, meta_json, acked FROM user_inbox WHERE user_id = ?1 AND network_id = ?2 AND kind = ?3 ORDER BY created_at, message_id",
59
+ userId, netId, MODEL_AUTH_NOTICE_KIND,
60
+ );
61
+ const clearNotices = () => db.run("DELETE FROM user_inbox WHERE network_id = ?1 AND kind = ?2", [netId, MODEL_AUTH_NOTICE_KIND]);
62
+
63
+ beforeAll(() => {
64
+ process.env.COMMHUB_UPLOADS_DIR = join(dir, "uploads");
65
+ const boss = register(`ma_boss_${stamp}`, PW);
66
+ expect(boss.ok).toBe(true);
67
+ bossId = boss.user!.user_id; netId = boss.network_id!;
68
+ const nora = register(`ma_nora_${stamp}`, PW);
69
+ const otto = register(`ma_otto_${stamp}`, PW);
70
+ noraId = nora.user!.user_id; ottoId = otto.user!.user_id;
71
+ addNetworkMember(netId, noraId, "member", bossId, { agentAccess: "all" });
72
+ addNetworkMember(netId, ottoId, "member", bossId, { agentAccess: "all" });
73
+ // 节点主人是 nora(她铸的节点令牌 → nodes.owner_user_id),不是网络 owner boss。
74
+ const minted = createNetworkTokenForNode(noraId, netId, NODE, NODE_ID);
75
+ expect(minted.ok).toBe(true);
76
+ nodeTokenId = minted.token_id!;
77
+ const peer = createNetworkTokenForNode(ottoId, netId, PEER, PEER_ID);
78
+ expect(peer.ok).toBe(true);
79
+ peerTokenId = peer.token_id!;
80
+ });
81
+ beforeEach(() => { __resetModelAuthNoticesForTest(); clearNodeHealthStore(); clearNotices(); });
82
+ afterAll(() => { clearNotices(); __resetModelAuthNoticesForTest(); clearNodeHealthStore(); });
83
+
84
+ describe("#462 transition logic", () => {
85
+ test("bad once per entry, re-armed only by ok", () => {
86
+ const seq: Array<Parameters<typeof decideModelAuthNotice>[1]> = ["ok", "expired", "expired", "revoked", "unknown", undefined, "expired", "ok", "unknown", "revoked", "revoked"];
87
+ let mark: ReturnType<typeof decideModelAuthNotice>["mark"];
88
+ const fired: boolean[] = [];
89
+ for (const s of seq) { const d = decideModelAuthNotice(mark, s); fired.push(d.notify); mark = d.mark; }
90
+ expect(fired).toEqual([false, true, false, false, false, false, false, false, false, true, false]);
91
+ });
92
+
93
+ test("first sight is bad → notify; unknown/missing never arms", () => {
94
+ expect(decideModelAuthNotice(undefined, "revoked")).toEqual({ notify: true, mark: "notified" });
95
+ expect(decideModelAuthNotice(undefined, "unknown")).toEqual({ notify: false, mark: undefined });
96
+ expect(decideModelAuthNotice("notified", "unknown")).toEqual({ notify: false, mark: "notified" });
97
+ expect(decideModelAuthNotice("notified", undefined)).toEqual({ notify: false, mark: "notified" });
98
+ expect(decideModelAuthNotice("notified", "ok")).toEqual({ notify: false, mark: "armed" });
99
+ });
100
+
101
+ test("text names the node, the cause and the per-node re-login; never says to copy credentials", () => {
102
+ for (const s of ["revoked", "expired"] as const) {
103
+ const { title, text } = modelAuthNoticeText("node-a", s);
104
+ expect(title).toBe("节点登录失效");
105
+ expect(text).toContain("节点 node-a");
106
+ expect(text).toContain("codex login");
107
+ expect(text).toContain("CODEX_HOME=");
108
+ expect(text).toContain("不要拷别的节点的 auth.json");
109
+ }
110
+ expect(modelAuthNoticeText("node-a", "revoked").text).toContain("作废");
111
+ expect(modelAuthNoticeText("node-a", "expired").text).toContain("过期");
112
+ });
113
+ });
114
+
115
+ describe("#462 report_status → owner notice", () => {
116
+ test("ok → expired → expired → ok → expired = exactly 2 notices, owner only", async () => {
117
+ const n = await connectAs(NODE, noraId, nodeTokenId);
118
+ try {
119
+ for (const s of ["ok", "expired", "expired", "ok", "expired"]) await n.report(s);
120
+ } finally { await n.close(); }
121
+ const mine = notices(noraId);
122
+ expect(mine.length).toBe(2);
123
+ for (const m of mine) {
124
+ expect(m.from_session).toBe(NODE);
125
+ expect(m.title).toBe("节点登录失效");
126
+ expect(m.severity).toBe("warning");
127
+ expect(m.content).toContain(`节点 ${NODE}`);
128
+ expect(m.content).toContain("codex login");
129
+ expect(JSON.parse(m.meta_json)).toEqual({ model_auth_notice: { alias: NODE, state: "expired" } });
130
+ }
131
+ expect(notices(bossId).length).toBe(0);
132
+ expect(notices(ottoId).length).toBe(0);
133
+ });
134
+
135
+ test("a node that only ever reports ok / unknown / nothing gets no notice", async () => {
136
+ const n = await connectAs(NODE, noraId, nodeTokenId);
137
+ try {
138
+ for (const s of ["unknown", "ok", undefined, "unknown", "ok"]) await n.report(s);
139
+ } finally { await n.close(); }
140
+ expect(notices(noraId).length).toBe(0);
141
+ });
142
+
143
+ test("another node or a user login cannot trigger a notice for this node", async () => {
144
+ const p = await connectAs(PEER, ottoId, peerTokenId);
145
+ try { await p.report("revoked", NODE, NODE_ID); } finally { await p.close(); }
146
+ const u = await connectAs("", bossId, "", false);
147
+ try { await u.report("revoked", NODE, NODE_ID); } finally { await u.close(); }
148
+ expect(notices(noraId).length).toBe(0);
149
+ expect(notices(bossId).length).toBe(0);
150
+ expect(notices(ottoId).length).toBe(0);
151
+ });
152
+
153
+ test("hub restart: an unread notice suppresses the repeat; once read, the next sight notifies", async () => {
154
+ const n = await connectAs(NODE, noraId, nodeTokenId);
155
+ try {
156
+ await n.report("revoked");
157
+ expect(notices(noraId).length).toBe(1);
158
+ __resetModelAuthNoticesForTest(); // = Hub 重启,内存标记没了
159
+ await n.report("revoked");
160
+ expect(notices(noraId).length).toBe(1);
161
+ db.run("UPDATE user_inbox SET acked = 1 WHERE user_id = ?1 AND network_id = ?2 AND kind = ?3", [noraId, netId, MODEL_AUTH_NOTICE_KIND]);
162
+ __resetModelAuthNoticesForTest();
163
+ await n.report("revoked");
164
+ expect(notices(noraId).length).toBe(2);
165
+ await n.report("revoked");
166
+ expect(notices(noraId).length).toBe(2);
167
+ } finally { await n.close(); }
168
+ });
169
+
170
+ test("owner no longer in the network → nobody is notified", async () => {
171
+ db.run("DELETE FROM network_members WHERE network_id = ?1 AND user_id = ?2", [netId, noraId]);
172
+ try {
173
+ const n = await connectAs(NODE, noraId, nodeTokenId);
174
+ try { await n.report("expired"); } finally { await n.close(); }
175
+ expect(notices(noraId).length).toBe(0);
176
+ expect(notices(bossId).length).toBe(0);
177
+ } finally {
178
+ addNetworkMember(netId, noraId, "member", bossId, { agentAccess: "all" });
179
+ }
180
+ });
181
+ });
@@ -0,0 +1,116 @@
1
+ // #462(#448 的子项)—— 节点模型登录失效时通知节点主人。
2
+ //
3
+ // 现场:codex 节点的 refresh token 被作废 / 过期后,节点自己知道(report_status.health.model_auth),
4
+ // Hub 也会拒绝给它派活(#460 node-health-guard.ts),但**没有人被告诉** —— 主人要等到某次派活被 409
5
+ // 才发现。这里在 report_status 收下健康报告的那一刻看 model_auth 的翻转:进入 revoked / expired 时
6
+ // 给节点主人发**一条**消息,说是哪个节点、出了什么事、怎么重新登录。
7
+ //
8
+ // 🔴 只检测 + 通知。不自动换号、不拷别的节点的 auth.json、不重新 stage 凭据(owner 定的边界)。
9
+ //
10
+ // 去重:每次「进入坏状态」只发一条;回到 ok 才重新上膛。unknown / 没报 model_auth 既不发也不上膛
11
+ // (一次模型调用都还没跑的节点报 unknown,不能把它当「恢复了」,否则 expired→unknown→expired 会刷屏)。
12
+ // revoked ⇄ expired 互相切换不算新的翻转 —— 修法是同一条命令。
13
+ // 状态在内存里(同 node-health-store.ts);Hub 重启后第一次看到坏状态时,先查收件人有没有**还没读**的同类
14
+ // 消息,有就不再发 —— 否则每次升级 Hub 都会给还没修好的节点主人再发一遍。
15
+ //
16
+ // 收件人 = 节点主人:上报令牌绑定的 nodes.owner_user_id(RFC-036,建节点时定死),没有绑定(老令牌)就取
17
+ // 铸这个节点令牌的用户(api_tokens.user_id —— 新令牌里两者相同)。只发给这一个人;不在本网络了就不发。
18
+ // 怎么送:agent-notice.ts(user_inbox + /events/users/me,from_session = 节点别名)。
19
+
20
+ import { db } from "./db.js";
21
+ import { getUserNetworkRole } from "./auth.js";
22
+ import { sendAgentNotice } from "./agent-notice.js";
23
+ import { degradedLayers } from "./node-health-guard.js";
24
+ import type { NodeHealth } from "./node-health-store.js";
25
+
26
+ export const MODEL_AUTH_NOTICE_KIND = "node_model_auth";
27
+ const MAX_TRACKED = 5_000;
28
+
29
+ type ModelAuth = NodeHealth["model_auth"];
30
+ /** armed = 下一次进入坏状态要发;notified = 这一段坏状态已经发过。 */
31
+ export type NoticeMark = "armed" | "notified";
32
+
33
+ export const isBadModelAuth = (s: ModelAuth): s is "revoked" | "expired" => s === "revoked" || s === "expired";
34
+
35
+ /**
36
+ * 纯函数:上一份标记 + 这一份 model_auth → 发不发、新标记。
37
+ * prev = undefined 表示这个 Hub 进程还没见过这个节点(调用方另查库里有没有未读的旧通知)。
38
+ */
39
+ export function decideModelAuthNotice(prev: NoticeMark | undefined, state: ModelAuth): { notify: boolean; mark: NoticeMark | undefined } {
40
+ if (state === "ok") return { notify: false, mark: "armed" };
41
+ if (isBadModelAuth(state)) {
42
+ if (prev === "notified") return { notify: false, mark: "notified" };
43
+ return { notify: true, mark: "notified" };
44
+ }
45
+ return { notify: false, mark: prev }; // unknown / 没报:保持原样
46
+ }
47
+
48
+ export function modelAuthNoticeText(alias: string, state: "revoked" | "expired"): { title: string; text: string } {
49
+ const what = state === "revoked"
50
+ ? "模型登录凭据已被作废(refresh token revoked),需要重新登录"
51
+ : "模型登录已过期,且没能自动刷新";
52
+ // 修法与派发被拒时(#460)给的同一句,别出现两套说法。
53
+ const hint = degradedLayers({ model_auth: state })[0]?.hint ?? "";
54
+ return {
55
+ title: "节点登录失效",
56
+ text: `节点 ${alias} 的${what}。在它恢复之前,派给它的任务会被拒绝。\n\n怎么修:${hint}。\n登录好之后节点会自动报告恢复,不用再做别的。`,
57
+ };
58
+ }
59
+
60
+ const marks = new Map<string, NoticeMark>();
61
+ const keyOf = (networkId: string, alias: string) => `${networkId}\0${alias}`;
62
+
63
+ export function __resetModelAuthNoticesForTest(): void { marks.clear(); }
64
+
65
+ /** 上报令牌对应的节点主人。 */
66
+ function ownerOfNodeToken(tokenId: string, networkId: string): string | null {
67
+ const row = db.get<{ user_id: string | null; owner_user_id: string | null }>(
68
+ `SELECT t.user_id, n.owner_user_id FROM api_tokens t LEFT JOIN nodes n ON n.node_id = t.bound_node_id
69
+ WHERE t.token_id = ?1 AND t.network_id = ?2`,
70
+ tokenId, networkId,
71
+ );
72
+ return row?.owner_user_id || row?.user_id || null;
73
+ }
74
+
75
+ function hasUnreadNotice(userId: string, networkId: string, alias: string): boolean {
76
+ return !!db.get(
77
+ "SELECT 1 AS hit FROM user_inbox WHERE user_id = ?1 AND network_id = ?2 AND from_session = ?3 AND kind = ?4 AND acked = 0 LIMIT 1",
78
+ userId, networkId, alias, MODEL_AUTH_NOTICE_KIND,
79
+ );
80
+ }
81
+
82
+ /**
83
+ * report_status 收下一份(已验过是本节点令牌报的)健康报告之后调用。返回这次通知到的 user_id(测试用;没发 = [])。
84
+ * 任何异常都吞掉:这是附带的通知,不能让一份正常的 report_status 失败。
85
+ */
86
+ export function noteModelAuthHealth(input: { networkId: string; alias: string; tokenId: string; health: NodeHealth }): string[] {
87
+ try {
88
+ const { networkId, alias, tokenId, health } = input;
89
+ const state = health.model_auth;
90
+ const key = keyOf(networkId, alias);
91
+ const prev = marks.get(key);
92
+ const { notify, mark } = decideModelAuthNotice(prev, state);
93
+ if (mark) {
94
+ marks.delete(key);
95
+ marks.set(key, mark);
96
+ if (marks.size > MAX_TRACKED) marks.delete(marks.keys().next().value!);
97
+ }
98
+ if (!notify || !isBadModelAuth(state)) return [];
99
+
100
+ const owner = ownerOfNodeToken(tokenId, networkId);
101
+ if (!owner || !getUserNetworkRole(owner, networkId)) return [];
102
+ // Hub 重启后的第一眼:主人还有一条没读的同类消息 → 这是同一段坏状态,不再发。
103
+ if (prev === undefined && hasUnreadNotice(owner, networkId, alias)) return [];
104
+
105
+ const { title, text } = modelAuthNoticeText(alias, state);
106
+ const sent = sendAgentNotice({
107
+ networkId, userId: owner, fromAlias: alias, kind: MODEL_AUTH_NOTICE_KIND, title, text,
108
+ meta: { model_auth_notice: { alias, state } }, idPrefix: "dm_auth_",
109
+ });
110
+ if (!sent) return [];
111
+ return [owner];
112
+ } catch (e: any) {
113
+ console.error(`[model-auth-notify] ${input.alias}: ${e?.message ?? e}`);
114
+ return [];
115
+ }
116
+ }
@@ -0,0 +1,75 @@
1
+ import { afterAll, beforeAll, describe, expect, test } from "bun:test";
2
+ import { mkdtempSync, rmSync } from "fs";
3
+ import { join } from "path";
4
+ import { tmpdir } from "os";
5
+ import { createNetworkTokenForNode, register } from "./auth.js";
6
+ import { db } from "./db.js";
7
+
8
+ const PRIVATE_DB_DIR = mkdtempSync(join(tmpdir(), "anet-network-name-http-"));
9
+ let server: any;
10
+ let base = "";
11
+ let userToken = "";
12
+ let nodeToken = "";
13
+ let networkId = "";
14
+ let username = "";
15
+
16
+ // 30s 而不是 bun 默认的 5s:这个 hook 跑 register()(KDF)+bootServer(),
17
+ // 本机空载基线 ~620ms,而 2026-08-17 与 2026-08-31 两次 CI 上它被 5s 上限打死
18
+ // (0 pass / 1 fail / Ran 1 test —— 见 #928、#1627)。5247ms 是**被截断的下界**,
19
+ // 不是测量值,所以余量按基线的 ~48x 取,而不是按那个数取。
20
+ beforeAll(async () => {
21
+ process.env.COMMHUB_DB = process.env.COMMHUB_DB || join(PRIVATE_DB_DIR, "hub.db");
22
+ username = `network_name_${Date.now()}_${process.pid}`;
23
+ const registered = register(username, "NetworkName123!", undefined, "seed");
24
+ expect(registered.ok).toBe(true);
25
+ userToken = registered.token!;
26
+ networkId = registered.network_id!;
27
+ const userId = db.get<{ user_id: string }>(
28
+ "SELECT user_id FROM users WHERE username = ?1",
29
+ [username],
30
+ )!.user_id;
31
+ const minted = createNetworkTokenForNode(userId, networkId, "network-name-node");
32
+ expect(minted.ok).toBe(true);
33
+ nodeToken = minted.token!;
34
+ const mod: any = await import("./server.js");
35
+ server = mod.bootServer({ port: 0, hostname: "127.0.0.1" });
36
+ base = `http://127.0.0.1:${server.port}`;
37
+ }, 30_000);
38
+
39
+ afterAll(() => {
40
+ try { server?.stop?.(true); } catch {}
41
+ try { rmSync(PRIVATE_DB_DIR, { recursive: true, force: true }); } catch {}
42
+ });
43
+
44
+ async function networks(token: string): Promise<any[]> {
45
+ const response = await fetch(`${base}/api/networks`, {
46
+ headers: { Authorization: `Bearer ${token}` },
47
+ });
48
+ expect(response.status).toBe(200);
49
+ const body = await response.json() as any;
50
+ expect(body.ok).toBe(true);
51
+ return body.networks;
52
+ }
53
+
54
+ describe("GET /api/networks name compatibility (#449)", () => {
55
+ test("utok rows expose equal non-null name and network_name", async () => {
56
+ const rows = await networks(userToken);
57
+ expect(rows).toHaveLength(1);
58
+ expect(rows[0].network_id).toBe(networkId);
59
+ // #449 is about `name` and `network_name` agreeing and being non-null.
60
+ // Pin them to the registered username rather than the literal "default":
61
+ // the auto-created network is named after its owner, so hardcoding the
62
+ // old literal would test the naming scheme instead of the compat shim.
63
+ expect(rows[0].network_name).toBe(username);
64
+ expect(rows[0].name).toBe(username);
65
+ });
66
+
67
+ test("network-bound ntok rows expose the same alias", async () => {
68
+ const rows = await networks(nodeToken);
69
+ expect(rows).toHaveLength(1);
70
+ expect(rows[0].network_id).toBe(networkId);
71
+ expect(rows[0].network_name).toBe(username);
72
+ expect(rows[0].name).toBe(rows[0].network_name);
73
+ expect(rows[0].name).not.toBeNull();
74
+ });
75
+ });