@sleep2agi/commhub-server 0.9.0-preview.27 → 0.9.0-preview.271

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 (446) 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 +210 -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 +885 -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 +223 -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/api-host-supervisors-can-create-nodes.test.ts +350 -0
  28. package/src/api-host-supervisors-fallback.test.ts +6 -7
  29. package/src/api-host-supervisors-runtime-readiness.test.ts +195 -0
  30. package/src/api-nodes-shape.test.ts +131 -4
  31. package/src/auth-abuse-counters.test.ts +144 -0
  32. package/src/auth-abuse-counters.ts +122 -0
  33. package/src/auth-layer-shape.test.ts +105 -0
  34. package/src/auth-password-change-cli-tokens-http.test.ts +423 -0
  35. package/src/auth-sessions-http.test.ts +260 -0
  36. package/src/auth-validate.test.ts +5 -1
  37. package/src/auth-weak-password-login.test.ts +176 -0
  38. package/src/auth.ts +641 -68
  39. package/src/backfill-node-ids-2664.test.ts +128 -0
  40. package/src/binding-generation-http.test.ts +141 -0
  41. package/src/blocked-exit-on-reply.test.ts +122 -0
  42. package/src/broadcast-fanout-2721.test.ts +149 -0
  43. package/src/broadcast-fanout.ts +117 -0
  44. package/src/build-commit-report-http.test.ts +128 -0
  45. package/src/build-info.test.ts +60 -0
  46. package/src/build-info.ts +85 -0
  47. package/src/chain-attempt-dedup.test.ts +447 -0
  48. package/src/clip.test.ts +36 -0
  49. package/src/clip.ts +48 -0
  50. package/src/clone-node.test.ts +269 -0
  51. package/src/clone-node.ts +289 -0
  52. package/src/codex-config-flags.ts +77 -0
  53. package/src/codex-fork-contract.ts +23 -0
  54. package/src/codex-fork-migration.test.ts +38 -0
  55. package/src/commhub-bin-args.test.ts +85 -0
  56. package/src/config-apply-validate.test.ts +188 -1
  57. package/src/config-apply-validate.ts +222 -3
  58. package/src/cors-origins.test.ts +73 -0
  59. package/src/create-node-blocked-gate.test.ts +365 -0
  60. package/src/create-node-error-domain.test.ts +127 -0
  61. package/src/create-node-network-id.test.ts +91 -0
  62. package/src/create-node-tool-schema.test.ts +49 -0
  63. package/src/create-node-unicode-name.test.ts +126 -0
  64. package/src/create-node-validate.test.ts +199 -7
  65. package/src/create-node-validate.ts +232 -15
  66. package/src/create-node-workdir.test.ts +298 -0
  67. package/src/create-node.ts +88 -23
  68. package/src/daemon-provider-snapshots.test.ts +453 -0
  69. package/src/daemon-provider-snapshots.ts +327 -0
  70. package/src/daemon-token-owner-http.test.ts +346 -0
  71. package/src/dashboard-slash-routing-http.test.ts +109 -0
  72. package/src/db-adapter-guard.test.ts +148 -0
  73. package/src/db-adapter-translate.test.ts +128 -0
  74. package/src/db-adapter.ts +377 -91
  75. package/src/db-timestamp.test.ts +38 -0
  76. package/src/db-timestamp.ts +15 -0
  77. package/src/db.ts +1298 -153
  78. package/src/delivered-without-push.test.ts +140 -0
  79. package/src/department-groups-http.test.ts +209 -0
  80. package/src/department-groups-sync-http.test.ts +328 -0
  81. package/src/department-groups.ts +434 -0
  82. package/src/department-heads-http.test.ts +350 -0
  83. package/src/department-heads.ts +226 -0
  84. package/src/departments-agent-count.test.ts +139 -0
  85. package/src/departments-http.test.ts +185 -0
  86. package/src/departments-mcp-error-domain.test.ts +135 -0
  87. package/src/departments-mcp.test.ts +128 -0
  88. package/src/departments.ts +318 -0
  89. package/src/desktop-message-seam.test.ts +150 -0
  90. package/src/desktop-message.test.ts +368 -0
  91. package/src/dm-file-scope-http.test.ts +227 -0
  92. package/src/empty-node-sweeper.test.ts +104 -0
  93. package/src/empty-node-sweeper.ts +88 -0
  94. package/src/env-transport-gate-http.test.ts +240 -0
  95. package/src/env-transport-gate.ts +80 -0
  96. package/src/env-transport-policy.ts +56 -0
  97. package/src/etag-of.test.ts +57 -0
  98. package/src/event-loop-lag.test.ts +180 -0
  99. package/src/event-loop-lag.ts +201 -0
  100. package/src/expiry-counters.test.ts +187 -0
  101. package/src/expiry-counters.ts +227 -0
  102. package/src/expiry-evidence-db.test.ts +103 -0
  103. package/src/ext-token-shared.test.ts +60 -0
  104. package/src/ext-validation-regression.test.ts +10 -17
  105. package/src/external-schedule-edits-http.test.ts +321 -0
  106. package/src/external-schedule-edits-timestamps.test.ts +64 -0
  107. package/src/external-schedule-edits.ts +327 -0
  108. package/src/file-download-authz-dev-open.test.ts +1 -1
  109. package/src/file-download-authz.test.ts +25 -4
  110. package/src/file-download-date-bucket.test.ts +1 -1
  111. package/src/file-network-scope-dev-open.test.ts +1 -1
  112. package/src/file-network-scope.test.ts +7 -6
  113. package/src/group-membership-events-http.test.ts +264 -0
  114. package/src/group-messages-http.test.ts +483 -0
  115. package/src/group-messages.ts +297 -0
  116. package/src/health-anon-readers.ts +67 -0
  117. package/src/health-host-disk-2756.test.ts +71 -0
  118. package/src/health-identity-root.test.ts +98 -0
  119. package/src/health-redaction.test.ts +1599 -7
  120. package/src/health-status-reasons.test.ts +84 -0
  121. package/src/host-supervisor-identity-http.test.ts +152 -0
  122. package/src/host-supervisor-identity.ts +92 -0
  123. package/src/host-supervisors-daemon-version.test.ts +137 -0
  124. package/src/http-gzip.test.ts +94 -0
  125. package/src/http-gzip.ts +112 -0
  126. package/src/hub-catalog-read-http.test.ts +664 -0
  127. package/src/hub-provider-config.test.ts +166 -0
  128. package/src/hub-provider-config.ts +202 -0
  129. package/src/hub-timestamp.test.ts +38 -0
  130. package/src/hub-timestamp.ts +27 -0
  131. package/src/human-dm.ts +215 -0
  132. package/src/human-inbox.ts +42 -0
  133. package/src/inbox-caller.ts +49 -0
  134. package/src/inbox-count-sse.test.ts +318 -0
  135. package/src/inbox-count.ts +29 -0
  136. package/src/index.ts +6 -2
  137. package/src/license-state.test.ts +105 -0
  138. package/src/license-state.ts +48 -0
  139. package/src/lifecycle-error-domain.test.ts +149 -0
  140. package/src/list-ack-error-domain.test.ts +108 -0
  141. package/src/list-host-supervisors.test.ts +15 -4
  142. package/src/list-tasks-omit-default.test.ts +84 -0
  143. package/src/list-tasks-since-last.test.ts +100 -0
  144. package/src/list-tasks-since.test.ts +104 -0
  145. package/src/mcp-context-cost-http.test.ts +127 -0
  146. package/src/mcp-inflight.test.ts +92 -0
  147. package/src/mcp-inflight.ts +38 -0
  148. package/src/mcp-projects-events-http.test.ts +168 -0
  149. package/src/mcp-route-label-http.test.ts +120 -0
  150. package/src/mcp-write-network-resolution.test.ts +21 -0
  151. package/src/member-audit-network-id-http.test.ts +93 -0
  152. package/src/member-presence-http.test.ts +210 -0
  153. package/src/messages-ack-by-agent-http.test.ts +142 -0
  154. package/src/migrate-sqlite-to-pg.test.ts +47 -0
  155. package/src/migrate-sqlite-to-pg.ts +263 -0
  156. package/src/model-auth-notify-http.test.ts +181 -0
  157. package/src/model-auth-notify.ts +116 -0
  158. package/src/network-name-http.test.ts +75 -0
  159. package/src/network-quota-config.test.ts +100 -0
  160. package/src/network-rules-http.test.ts +169 -0
  161. package/src/network-rules.ts +129 -0
  162. package/src/network-scope.ts +222 -3
  163. package/src/network-token-membership-http.test.ts +186 -0
  164. package/src/node-alias-control.ts +12 -0
  165. package/src/node-attrs.test.ts +47 -2
  166. package/src/node-caller-identity-http.test.ts +1108 -0
  167. package/src/node-config-last-update.test.ts +126 -0
  168. package/src/node-config-last-update.ts +107 -0
  169. package/src/node-create-request-status-http.test.ts +105 -0
  170. package/src/node-daemon-bindings.test.ts +142 -0
  171. package/src/node-daemon-bindings.ts +135 -0
  172. package/src/node-failure-alert.test.ts +150 -0
  173. package/src/node-failure-alert.ts +177 -0
  174. package/src/node-files-transport.test.ts +350 -0
  175. package/src/node-health-codex-login.test.ts +120 -0
  176. package/src/node-health-dispatch-http.test.ts +373 -0
  177. package/src/node-health-guard-origin.test.ts +98 -0
  178. package/src/node-health-guard.ts +121 -0
  179. package/src/node-health-passthrough.test.ts +115 -0
  180. package/src/node-health-store.ts +101 -0
  181. package/src/node-id-alias.test.ts +190 -0
  182. package/src/node-identity-conflict-http.test.ts +269 -0
  183. package/src/node-identity-conflict.ts +142 -0
  184. package/src/node-identity-mismatch.test.ts +74 -0
  185. package/src/node-in-flight-tasks.ts +31 -0
  186. package/src/node-lifecycle-controllable.test.ts +64 -0
  187. package/src/node-lifecycle-controllable.ts +53 -0
  188. package/src/node-lifecycle-read-http.test.ts +257 -0
  189. package/src/node-lifecycle-read.ts +124 -0
  190. package/src/node-logs-transport.test.ts +266 -0
  191. package/src/node-peer-allowlist.test.ts +114 -0
  192. package/src/node-permissions-http.test.ts +901 -0
  193. package/src/node-permissions.ts +496 -0
  194. package/src/node-request-retention.test.ts +281 -0
  195. package/src/node-request-retention.ts +120 -0
  196. package/src/node-secret-rest-http.test.ts +190 -0
  197. package/src/node-secret-vault-inject.test.ts +132 -0
  198. package/src/node-security-write-gate.test.ts +72 -0
  199. package/src/node-serviceability.test.ts +86 -0
  200. package/src/node-serviceability.ts +124 -0
  201. package/src/node-session-control-http.test.ts +310 -0
  202. package/src/node-session-control.ts +258 -0
  203. package/src/node-skills-transport.test.ts +212 -0
  204. package/src/node-token-identity.ts +35 -0
  205. package/src/node-token-ownership.ts +51 -0
  206. package/src/node-token-privilege-http.test.ts +224 -0
  207. package/src/node-token-usage.test.ts +90 -0
  208. package/src/node-token-usage.ts +164 -0
  209. package/src/not-found-api-http.test.ts +67 -0
  210. package/src/observer-avatar-http.test.ts +103 -10
  211. package/src/observer-push.test.ts +76 -0
  212. package/src/opencode-catalog-report-http.test.ts +139 -0
  213. package/src/opencode-v2-catalog.test.ts +268 -0
  214. package/src/opencode-v2-catalog.ts +356 -0
  215. package/src/package-version-consistency.test.ts +25 -0
  216. package/src/parent-infer.test.ts +82 -0
  217. package/src/parent-infer.ts +110 -0
  218. package/src/parent-source-marker.test.ts +70 -0
  219. package/src/parent-source-orphan.test.ts +121 -0
  220. package/src/password-network-tokens.ts +25 -0
  221. package/src/peer-reply-atomic.test.ts +462 -0
  222. package/src/peer-reply-capability.test.ts +70 -0
  223. package/src/pg-worker.ts +87 -0
  224. package/src/poll-pacing.test.ts +74 -0
  225. package/src/poll-pacing.ts +123 -0
  226. package/src/probe-provider-error-domain.test.ts +145 -0
  227. package/src/project-dir-warn-clear-http.test.ts +132 -0
  228. package/src/project-viewer-can-http.test.ts +116 -0
  229. package/src/provider-skill-error-domain.test.ts +130 -0
  230. package/src/provider-tools-shape.test.ts +165 -0
  231. package/src/push.test.ts +20 -10
  232. package/src/push.ts +373 -9
  233. package/src/redact-tokens.test.ts +86 -0
  234. package/src/redact-tokens.ts +43 -0
  235. package/src/rejection-counters.test.ts +72 -0
  236. package/src/rejection-counters.ts +173 -0
  237. package/src/rename.ts +38 -10
  238. package/src/reply-target-derivation.test.ts +96 -0
  239. package/src/report-status-handover-capabilities-http.test.ts +124 -0
  240. package/src/report-status-host-schema.test.ts +235 -0
  241. package/src/report-status-resume-id-handover.test.ts +184 -0
  242. package/src/report-status-secret-keys.test.ts +140 -0
  243. package/src/require-explicit-test-db.ts +9 -0
  244. package/src/requirement-due-reminders-http.test.ts +620 -0
  245. package/src/requirement-due-reminders.ts +416 -0
  246. package/src/requirement-events-http.test.ts +318 -0
  247. package/src/requirement-events.test.ts +45 -0
  248. package/src/requirement-events.ts +144 -0
  249. package/src/requirement-notify.ts +165 -0
  250. package/src/requirement-participant-notify-http.test.ts +313 -0
  251. package/src/requirement-tag-ops-http.test.ts +454 -0
  252. package/src/requirement-tag-tree-http.test.ts +275 -0
  253. package/src/requirement-tag-tree.ts +127 -0
  254. package/src/requirement-tags.ts +102 -0
  255. package/src/requirements-abandoned-http.test.ts +236 -0
  256. package/src/requirements-assignee-drift.test.ts +154 -0
  257. package/src/requirements-comment-http.test.ts +174 -0
  258. package/src/requirements-completed-at-migration.test.ts +70 -0
  259. package/src/requirements-errors-mcp-http.test.ts +164 -0
  260. package/src/requirements-errors.ts +158 -0
  261. package/src/requirements-etag-http.test.ts +91 -0
  262. package/src/requirements-http.test.ts +709 -0
  263. package/src/requirements-last-event-http.test.ts +349 -0
  264. package/src/requirements-list-mcp-slim-http.test.ts +155 -0
  265. package/src/requirements-list-slim-http.test.ts +324 -0
  266. package/src/requirements-mcp.test.ts +180 -0
  267. package/src/requirements-migrate.ts +283 -0
  268. package/src/requirements-owner-strict-mcp-http.test.ts +145 -0
  269. package/src/requirements-people-http.test.ts +114 -0
  270. package/src/requirements-people-mcp-http.test.ts +231 -0
  271. package/src/requirements-people.ts +196 -0
  272. package/src/requirements-priority-lowest.test.ts +114 -0
  273. package/src/requirements-projects-network-echo.test.ts +57 -0
  274. package/src/requirements-projects-parent-http.test.ts +123 -0
  275. package/src/requirements-search-http.test.ts +182 -0
  276. package/src/requirements-search.test.ts +32 -0
  277. package/src/requirements-search.ts +145 -0
  278. package/src/requirements-seq-http.test.ts +193 -0
  279. package/src/requirements-seq-migration.test.ts +63 -0
  280. package/src/requirements-start-date.test.ts +125 -0
  281. package/src/requirements-stats-http.test.ts +357 -0
  282. package/src/requirements-stats.ts +195 -0
  283. package/src/requirements-status-participants-http.test.ts +222 -0
  284. package/src/requirements-upgrade-e2e.test.ts +126 -0
  285. package/src/requirements-upgrade-migration.test.ts +98 -0
  286. package/src/requirements.ts +2205 -0
  287. package/src/resolve-port.test.ts +57 -0
  288. package/src/resolve-port.ts +44 -0
  289. package/src/rest-alias-network-fallback-http.test.ts +123 -0
  290. package/src/rest-alias-network-fallback.test.ts +60 -0
  291. package/src/rest-alias-network-fallback.ts +65 -0
  292. package/src/rest-explicit-columns-http.test.ts +266 -0
  293. package/src/rest-identity.test.ts +130 -0
  294. package/src/rest-identity.ts +141 -0
  295. package/src/rest-projections.ts +72 -0
  296. package/src/rest-read-network-real-chain.test.ts +97 -0
  297. package/src/rest-write-network-resolution.test.ts +133 -0
  298. package/src/restart-readiness-http.test.ts +121 -0
  299. package/src/restricted-files.ts +76 -0
  300. package/src/retention-first-sweep-quiet.test.ts +31 -0
  301. package/src/retention.test.ts +100 -40
  302. package/src/retention.ts +423 -104
  303. package/src/route-callers-http.test.ts +120 -0
  304. package/src/route-timing.test.ts +218 -0
  305. package/src/route-timing.ts +262 -0
  306. package/src/rules-file-duplicate-alias.test.ts +234 -0
  307. package/src/rules-file-session-target.test.ts +207 -0
  308. package/src/rules-file-transport.test.ts +271 -0
  309. package/src/runtime-label.test.ts +22 -0
  310. package/src/runtime-label.ts +21 -0
  311. package/src/runtime-readiness.ts +90 -0
  312. package/src/schedule-agent-mcp-http.test.ts +486 -0
  313. package/src/schedule-agent.ts +252 -0
  314. package/src/schedule-starved.test.ts +92 -0
  315. package/src/schedule-starved.ts +114 -0
  316. package/src/scheduled-backoff-http.test.ts +203 -0
  317. package/src/scheduled-backoff.ts +64 -0
  318. package/src/scheduled-doorbell-nodeless-session.test.ts +134 -0
  319. package/src/scheduled-failure-backoff-2622.test.ts +145 -0
  320. package/src/scheduled-failure-code.test.ts +73 -0
  321. package/src/scheduled-failure-code.ts +105 -0
  322. package/src/scheduled-failures-http.test.ts +279 -0
  323. package/src/scheduled-failures.ts +425 -0
  324. package/src/scheduled-noprogress-backoff-2622.test.ts +163 -0
  325. package/src/scheduled-offline-backoff-probe.test.ts +56 -0
  326. package/src/scheduled-offline.test.ts +131 -0
  327. package/src/scheduled-offline.ts +66 -0
  328. package/src/scheduled-outcome-guidance-http.test.ts +139 -0
  329. package/src/scheduled-outcome-guidance.ts +9 -0
  330. package/src/scheduled-reply-unread-http.test.ts +212 -0
  331. package/src/scheduled-requirement-wake-http.test.ts +289 -0
  332. package/src/scheduled-requirement-wake.ts +125 -0
  333. package/src/scheduled-run-terminal.test.ts +290 -0
  334. package/src/scheduled-skip-blocking-task.test.ts +120 -0
  335. package/src/scheduled-skip-path-backoff-2622.test.ts +98 -0
  336. package/src/scheduled-stuck-http.test.ts +316 -0
  337. package/src/scheduled-stuck-notice-cap.test.ts +80 -0
  338. package/src/scheduled-stuck.ts +219 -0
  339. package/src/scheduled-tasks-http.test.ts +679 -0
  340. package/src/scheduled-tasks.ts +959 -0
  341. package/src/scheduled-work-outcome-http.test.ts +154 -0
  342. package/src/scheduled-work-outcome.ts +50 -0
  343. package/src/scoped-secrets.ts +167 -0
  344. package/src/secret-echo-negative-control.test.ts +118 -0
  345. package/src/send-dedup-request-id.test.ts +229 -0
  346. package/src/send-reply-agent-warning.test.ts +38 -38
  347. package/src/send-reply-alias-optional.test.ts +131 -0
  348. package/src/send-reply-attachments.test.ts +28 -7
  349. package/src/send_dedup.test.ts +54 -0
  350. package/src/send_dedup.ts +52 -6
  351. package/src/serve-error.test.ts +73 -0
  352. package/src/serve-error.ts +56 -0
  353. package/src/server.ts +4963 -377
  354. package/src/session-task-on-dispatch.ts +14 -0
  355. package/src/session-token-ownership-http.test.ts +122 -0
  356. package/src/shared/codex-inventory.ts +41 -0
  357. package/src/shared/daemon-provider-login.ts +31 -0
  358. package/src/shared/daemon-provider-snapshot.ts +52 -0
  359. package/src/shared/external-schedule-contract.ts +60 -0
  360. package/src/shared/node-name.test.ts +62 -0
  361. package/src/shared/node-name.ts +161 -0
  362. package/src/shared/probe-host-allowlist-drift.test.ts +45 -0
  363. package/src/shared/provider-application.ts +29 -0
  364. package/src/shared/provider-collection.ts +14 -0
  365. package/src/shared/provider-initialization.ts +8 -0
  366. package/src/shared/reserved-env-drift.test.ts +10 -0
  367. package/src/shared/scoped-secret-contract.ts +5 -0
  368. package/src/shared/task-content-limit-drift.test.ts +28 -0
  369. package/src/shared/task-content-limit.ts +25 -0
  370. package/src/side-thread-command-transport.test.ts +312 -0
  371. package/src/side-thread-command-transport.ts +318 -0
  372. package/src/side-thread-http-integration.test.ts +233 -0
  373. package/src/side-thread-http.ts +504 -0
  374. package/src/side-thread-production.test.ts +72 -0
  375. package/src/side-thread-production.ts +118 -0
  376. package/src/side-thread.test.ts +1067 -0
  377. package/src/side-thread.ts +2499 -0
  378. package/src/skillhub-http.test.ts +144 -0
  379. package/src/sqlite-close-checkpoint.test.ts +78 -0
  380. package/src/start-node.test.ts +265 -0
  381. package/src/start-request-error-domain.test.ts +182 -0
  382. package/src/start-skill-error-domain.test.ts +122 -0
  383. package/src/stats-versions-http.test.ts +65 -0
  384. package/src/status-alias-filter-http.test.ts +106 -0
  385. package/src/status-alias-resolver-http.test.ts +163 -0
  386. package/src/status-alias-resolver.ts +19 -0
  387. package/src/status-node-id-filter-http.test.ts +161 -0
  388. package/src/status-read-cache-http.test.ts +229 -0
  389. package/src/status-read-cache.ts +129 -0
  390. package/src/stop-delete-node.test.ts +567 -1
  391. package/src/task-access-http.test.ts +407 -0
  392. package/src/task-access.ts +420 -0
  393. package/src/task-activity.ts +60 -0
  394. package/src/task-auth-origin-http.test.ts +93 -0
  395. package/src/task-auth-origin.test.ts +24 -0
  396. package/src/task-auth-origin.ts +7 -0
  397. package/src/task-consumption.test.ts +508 -0
  398. package/src/task-diagnostic-http.test.ts +149 -0
  399. package/src/task-diagnostic.test.ts +115 -0
  400. package/src/task-diagnostic.ts +118 -0
  401. package/src/task-expiry-notice-http.test.ts +298 -0
  402. package/src/task-expiry-notice.ts +318 -0
  403. package/src/task-idempotency-mcp.test.ts +148 -0
  404. package/src/task-idempotency.test.ts +76 -0
  405. package/src/task-idempotency.ts +81 -0
  406. package/src/task-late-replies.ts +54 -0
  407. package/src/task-late-reply-http.test.ts +227 -0
  408. package/src/task-lifecycle-watcher-busy.test.ts +114 -0
  409. package/src/task-lifecycle-watcher.test.ts +209 -0
  410. package/src/task-lifecycle-watcher.ts +109 -0
  411. package/src/task-network-resolution-http.test.ts +140 -0
  412. package/src/task-not-found-error-domain.test.ts +114 -0
  413. package/src/task-offline-delivery-2668.test.ts +119 -0
  414. package/src/task-offline-delivery.ts +81 -0
  415. package/src/task-orphan-http.test.ts +287 -0
  416. package/src/task-orphan.ts +119 -0
  417. package/src/task-queue-ahead-http.test.ts +309 -0
  418. package/src/task-queue-ahead-scale.test.ts +236 -0
  419. package/src/task-queue-ahead.ts +186 -0
  420. package/src/task-rejection-log-http.test.ts +160 -0
  421. package/src/task-rejection-log.ts +61 -0
  422. package/src/task-sender-http.test.ts +143 -0
  423. package/src/task-stale-open-http.test.ts +292 -0
  424. package/src/task-stale-open.ts +103 -0
  425. package/src/tasks-pagination-http.test.ts +141 -0
  426. package/src/team-rules-status-http.test.ts +90 -0
  427. package/src/team-rules-status.test.ts +59 -0
  428. package/src/team-rules-status.ts +72 -0
  429. package/src/tmux-allowlist.test.ts +48 -0
  430. package/src/tool-audience-http.test.ts +248 -0
  431. package/src/tool-audience.ts +130 -0
  432. package/src/tools-list-json-schema.test.ts +94 -0
  433. package/src/tools.ts +4340 -386
  434. package/src/update-node-config-error-domain.test.ts +107 -0
  435. package/src/uploads-http.test.ts +6 -4
  436. package/src/uploads.ts +23 -4
  437. package/src/user-avatar-http.test.ts +74 -0
  438. package/src/user-avatar-image.ts +160 -0
  439. package/src/user-avatar-migration.test.ts +25 -0
  440. package/src/user-avatar-upload-http.test.ts +353 -0
  441. package/src/user-inbox-by-agent-http.test.ts +189 -0
  442. package/src/user-inbox-netid-notnull.test.ts +122 -0
  443. package/src/user-inbox-read-http.test.ts +223 -0
  444. package/src/user-inbox-schema.test.ts +54 -0
  445. package/src/version-stats.test.ts +66 -0
  446. package/src/version-stats.ts +109 -0
@@ -0,0 +1,164 @@
1
+ // #3952(admin 2026-11-05「要对节点进行 Token 审计,能看到节点消耗了多少 Token」)
2
+ //
3
+ // 现状:Hub 里**没有任何** token 用量记账 —— 只有 api_tokens(那是鉴权用的令牌 id,
4
+ // 和"消耗了多少 token"是两回事)。节点侧其实**看得到**用量(claude/codex 的每轮结果里
5
+ // 都有 input_tokens / output_tokens,只是打进了日志),但从来没有上报。
6
+ //
7
+ // 本模块只做「记账 + 读账」,不做采集:
8
+ // 写 reportTokenUsage() 节点令牌专用,按 (network, node, hour, model) 累加
9
+ // 读 readTokenUsage() 人(成员/owner/admin)按节点聚合
10
+ //
11
+ // 已知边界:turns / cost_usd 列 NOT NULL DEFAULT 0 ⇒ 「没报」与「报了 0」在存储上同形。
12
+ // 要区分得再加一列 has_turns;当前不值这个复杂度(谁要区分,读 normalizeUsage 的返回值)。
13
+ //
14
+ // 三条口径(写死,避免以后各说各话):
15
+ // ① hour 是 **UTC 小时桶**('YYYY-MM-DDTHH'),与 node_tool_calls 同口径。
16
+ // ② 累加而不是覆盖:同一小时同一 model 多次上报要相加 —— 一轮一报是常态。
17
+ // ③ **只收计数,不收内容**:没有 prompt、没有消息 id、没有凭据。
18
+ // 这一点由 schema 的形状保证(列就那几个),也由测试钉住。
19
+
20
+ import { db } from './db';
21
+
22
+ // 建表放在**本模块**而不是别处的 schema 大块:那样只要 import 了本模块,表就一定在。
23
+ // (2026-11-05 踩过:放 node-permissions.ts 的 exec 块里,单测没 import 它 ⇒ no such table。)
24
+ db.exec(`
25
+ CREATE TABLE IF NOT EXISTS node_token_usage (
26
+ network_id TEXT NOT NULL,
27
+ node_id TEXT NOT NULL,
28
+ hour TEXT NOT NULL,
29
+ model TEXT NOT NULL DEFAULT 'unknown',
30
+ input_tokens INTEGER NOT NULL DEFAULT 0,
31
+ output_tokens INTEGER NOT NULL DEFAULT 0,
32
+ turns INTEGER NOT NULL DEFAULT 0,
33
+ cost_usd REAL NOT NULL DEFAULT 0,
34
+ updated_at TEXT NOT NULL DEFAULT (datetime('now')),
35
+ PRIMARY KEY (network_id, node_id, hour, model)
36
+ );
37
+ CREATE INDEX IF NOT EXISTS idx_node_token_usage_hour ON node_token_usage(network_id, hour);
38
+ `);
39
+
40
+ export interface TokenUsageInput {
41
+ networkId: string;
42
+ nodeId: string;
43
+ /** 'YYYY-MM-DDTHH'(UTC);缺省 = 现在这一小时 */
44
+ hour?: string | null;
45
+ /** provider/model 或运行时的自有标识;缺省 'unknown' —— 不假装知道 */
46
+ model?: string | null;
47
+ inputTokens?: number | null;
48
+ outputTokens?: number | null;
49
+ /** 有的运行时只给总轮数/费用;没有就留空,**不填 0**(0 与"不知道"是两件事) */
50
+ turns?: number | null;
51
+ costUsd?: number | null;
52
+ }
53
+
54
+ const HOUR_RE = /^\d{4}-\d{2}-\d{2}T\d{2}$/;
55
+ const MODEL_MAX = 100;
56
+
57
+ export function currentHourUtc(now = Date.now()): string {
58
+ return new Date(now).toISOString().slice(0, 13);
59
+ }
60
+
61
+ function nonNegativeInt(value: unknown): number | null {
62
+ if (typeof value !== 'number' || !Number.isFinite(value) || value < 0) return null;
63
+ if (!Number.isSafeInteger(Math.round(value))) return null;
64
+ return Math.round(value);
65
+ }
66
+
67
+ /** 校验 + 归一。返回 null 表示「这一份上报不合规」——调用方负责拒绝,不静默丢。 */
68
+ export function normalizeUsage(input: TokenUsageInput): {
69
+ hour: string; model: string;
70
+ inputTokens: number; outputTokens: number;
71
+ turns: number | null; costUsd: number | null;
72
+ } | null {
73
+ const hour = typeof input.hour === 'string' && input.hour ? input.hour : currentHourUtc();
74
+ if (!HOUR_RE.test(hour)) return null;
75
+ const rawModel = typeof input.model === 'string' ? input.model.trim() : '';
76
+ if (rawModel.length > MODEL_MAX) return null;
77
+ const model = rawModel || 'unknown';
78
+ const inputTokens = nonNegativeInt(input.inputTokens) ?? 0;
79
+ const outputTokens = nonNegativeInt(input.outputTokens) ?? 0;
80
+ if (inputTokens === 0 && outputTokens === 0 && input.turns == null && input.costUsd == null) {
81
+ // 什么都没报:不写一行全 0 的记录(那会让"没有用量"和"没上报"在报表上同形)。
82
+ return null;
83
+ }
84
+ const turns = nonNegativeInt(input.turns);
85
+ const costRaw = input.costUsd;
86
+ const costUsd = typeof costRaw === 'number' && Number.isFinite(costRaw) && costRaw >= 0 ? costRaw : null;
87
+ return { hour, model, inputTokens, outputTokens, turns, costUsd };
88
+ }
89
+
90
+ /** 记账:同一 (network, node, hour, model) 累加。turns/cost 可空,空则保持原值。 */
91
+ export function reportTokenUsage(input: TokenUsageInput): { ok: true; hour: string; model: string } | { ok: false; error: string } {
92
+ const norm = normalizeUsage(input);
93
+ if (!norm) return { ok: false, error: 'invalid_token_usage' };
94
+ db.run(
95
+ `INSERT INTO node_token_usage(network_id, node_id, hour, model, input_tokens, output_tokens, turns, cost_usd, updated_at)
96
+ VALUES(?1, ?2, ?3, ?4, ?5, ?6, COALESCE(?7, 0), COALESCE(?8, 0), datetime('now'))
97
+ ON CONFLICT(network_id, node_id, hour, model) DO UPDATE SET
98
+ input_tokens = input_tokens + excluded.input_tokens,
99
+ output_tokens = output_tokens + excluded.output_tokens,
100
+ turns = COALESCE(turns, 0) + COALESCE(excluded.turns, 0),
101
+ cost_usd = COALESCE(cost_usd, 0) + COALESCE(excluded.cost_usd, 0),
102
+ updated_at = datetime('now')`,
103
+ // turns / cost_usd 这里存 0 = 「没有这一项」。**存储层不区分「0 轮」与「没报轮数」**,
104
+ // 这是已知偏差(见文件头「已知边界」);要区分得加一列 has_turns,成本不值。
105
+ [input.networkId, input.nodeId, norm.hour, norm.model, norm.inputTokens, norm.outputTokens, norm.turns, norm.costUsd],
106
+ );
107
+ return { ok: true, hour: norm.hour, model: norm.model };
108
+ }
109
+
110
+ export interface NodeTokenUsageRow {
111
+ node_id: string;
112
+ alias: string | null;
113
+ input_tokens: number;
114
+ output_tokens: number;
115
+ total_tokens: number;
116
+ turns: number;
117
+ cost_usd: number;
118
+ models: number;
119
+ first_hour: string | null;
120
+ last_hour: string | null;
121
+ }
122
+
123
+ /**
124
+ * 读账:按节点聚合。`sinceHours` 用 UTC 小时桶比较(与写入同口径)。
125
+ *
126
+ * 排序:total_tokens 降序 —— 审计第一眼要看"谁最多",而不是按名字排。
127
+ */
128
+ export function readTokenUsage(networkId: string, sinceHours = 24): NodeTokenUsageRow[] {
129
+ const hours = Math.max(1, Math.min(24 * 90, Math.floor(sinceHours)));
130
+ const since = currentHourUtc(Date.now() - hours * 3600_000);
131
+ const rows = db.all<{
132
+ node_id: string; alias: string | null;
133
+ input_tokens: number; output_tokens: number;
134
+ turns: number; cost_usd: number; models: number;
135
+ first_hour: string | null; last_hour: string | null;
136
+ }>(
137
+ `SELECT u.node_id,
138
+ COALESCE(n.alias, s.alias) AS alias,
139
+ SUM(u.input_tokens) AS input_tokens,
140
+ SUM(u.output_tokens) AS output_tokens,
141
+ SUM(u.turns) AS turns,
142
+ SUM(u.cost_usd) AS cost_usd,
143
+ COUNT(DISTINCT u.model) AS models,
144
+ MIN(u.hour) AS first_hour,
145
+ MAX(u.hour) AS last_hour
146
+ FROM node_token_usage u
147
+ LEFT JOIN nodes n ON n.node_id = u.node_id AND n.network_id = u.network_id
148
+ LEFT JOIN sessions s ON s.node_id = u.node_id AND s.network_id = u.network_id
149
+ WHERE u.network_id = ?1 AND u.hour >= ?2
150
+ GROUP BY u.node_id
151
+ ORDER BY (SUM(u.input_tokens) + SUM(u.output_tokens)) DESC`,
152
+ networkId, since,
153
+ );
154
+ return rows.map((r) => ({
155
+ ...r,
156
+ total_tokens: (r.input_tokens ?? 0) + (r.output_tokens ?? 0),
157
+ }));
158
+ }
159
+
160
+ /** 记账表与读账口径都只认这几个列 —— 形状就是「不收内容」的保证。 */
161
+ export const NODE_TOKEN_USAGE_COLUMNS = [
162
+ 'network_id', 'node_id', 'hour', 'model',
163
+ 'input_tokens', 'output_tokens', 'turns', 'cost_usd', 'updated_at',
164
+ ] as const;
@@ -0,0 +1,67 @@
1
+ // #2946 —— 未匹配的 /api/* 必须 404,而不是 200 + 帮助页。
2
+ //
3
+ // 现场(.193):带 token 打 /api/lang/status /api/hub/profile /api/nodes/department
4
+ // /api/schedules/failures(四个都不存在)→ 全部 200 + 652B 的帮助页文本,
5
+ // 字节数完全相同。探针会把「端点改名/拼错」读成「正常」—— 假绿。
6
+ // 这与 #2559(401 被伪装成空数据)同类:错误被伪装成成功。
7
+ //
8
+ // 根路径 `/` 仍然返回帮助页(那是给人/curl 看的入口说明),这条也要钉住,
9
+ // 否则修 #2946 时很容易把根路径一起改成 404。
10
+ import { afterAll, beforeAll, expect, test } from "bun:test";
11
+ import { mkdtempSync } from "node:fs";
12
+ import { join } from "node:path";
13
+ import { tmpdir } from "node:os";
14
+
15
+ const dir = mkdtempSync(join(tmpdir(), "notfound-2946-"));
16
+ process.env.COMMHUB_DB ||= join(dir, "hub.db");
17
+ process.env.COMMHUB_AUTH_TOKEN ||= "notfound-2946-master-fixture";
18
+
19
+ let hub: { stop: (closeActiveConnections?: boolean) => void; port: number } | null = null;
20
+ let base = "";
21
+ let token = "";
22
+
23
+ beforeAll(async () => {
24
+ const { register } = await import("./auth.js");
25
+ const { bootServer } = await import("./server.js");
26
+ const a = register(`nf_owner_${Date.now()}`, "NotFou-2946-Strong1!");
27
+ expect(a.ok).toBe(true);
28
+ token = a.token!;
29
+ hub = bootServer({ port: 0, hostname: "127.0.0.1" }) as any;
30
+ base = `http://127.0.0.1:${hub!.port}`;
31
+ });
32
+
33
+ afterAll(() => { try { hub?.stop?.(true); } catch {} });
34
+
35
+ const call = async (path: string, withToken = true) => {
36
+ const res = await fetch(base + path, {
37
+ headers: withToken ? { Authorization: `Bearer ${token}` } : {},
38
+ });
39
+ const text = await res.text();
40
+ return { status: res.status, text };
41
+ };
42
+
43
+ test("不存在的 /api/* 路径返回 404 not_found(不再 200 + 帮助页)", async () => {
44
+ for (const path of ["/api/definitely-not-a-route", "/api/lang/status", "/api/hub/profile"]) {
45
+ const r = await call(path);
46
+ expect(r.status).toBe(404);
47
+ const body = JSON.parse(r.text);
48
+ expect(body.ok).toBe(false);
49
+ expect(body.error).toBe("not_found");
50
+ expect(body.path).toBe(path);
51
+ // 关键:不再把帮助页伪装成这个端点的返回
52
+ expect(r.text).not.toContain("Streamable HTTP");
53
+ }
54
+ });
55
+
56
+ test("已存在的端点不受影响", async () => {
57
+ const r = await call("/health", false);
58
+ expect(r.status).toBe(200);
59
+ expect(JSON.parse(r.text).ok).toBe(true);
60
+ });
61
+
62
+ test("根路径仍然返回帮助页(不能一起改成 404)", async () => {
63
+ // 认证门在路由之前:/ 也要带 token 才看得到帮助页(不带是 401,本就不变)
64
+ const r = await call("/", true);
65
+ expect(r.status).toBe(200);
66
+ expect(r.text).toContain("CommHub MCP Server");
67
+ });
@@ -36,6 +36,10 @@ let outsiderUserId = "";
36
36
  const TARGET_ALIAS = "obs-target-agent";
37
37
  const AVATAR_NODE_ID = "node_avatar_test_1";
38
38
 
39
+ // 30s 而不是 bun 默认的 5s:这个 hook 跑 register()(KDF)+bootServer(),
40
+ // 本机空载基线 ~620ms,而 2026-08-17 与 2026-08-31 两次 CI 上它被 5s 上限打死
41
+ // (0 pass / 1 fail / Ran 1 test —— 见 #928、#1627)。5247ms 是**被截断的下界**,
42
+ // 不是测量值,所以余量按基线的 ~48x 取,而不是按那个数取。
39
43
  beforeAll(async () => {
40
44
  // Kept for per-file runs launched without an external COMMHUB_DB (the
41
45
  // documented contract still is to set it externally; see db-adapter.ts).
@@ -88,7 +92,7 @@ beforeAll(async () => {
88
92
  const mod: any = await import("./server.js");
89
93
  privateServer = mod.bootServer({ port: 0, hostname: "127.0.0.1" });
90
94
  BASE = `http://127.0.0.1:${privateServer.port}`;
91
- });
95
+ }, 30_000);
92
96
 
93
97
  afterAll(() => {
94
98
  try { privateServer?.stop?.(true); } catch {}
@@ -143,7 +147,7 @@ describe("#461 GET /events/network/:id — auth", () => {
143
147
  test("member user token → SSE stream with observer connected frame", async () => {
144
148
  const res = await fetch(`${BASE}/events/network/${memberNetworkId}`, { headers: auth(memberToken) });
145
149
  expect(res.status).toBe(200);
146
- expect(res.headers.get("content-type") || "").toContain("text/event-stream");
150
+ expect((res.headers.get("content-type") || "").split(";")[0].trim()).toBe("text/event-stream");
147
151
  const reader = res.body!.getReader();
148
152
  const connected = await readFrame(reader);
149
153
  expect(connected.type).toBe("connected");
@@ -155,14 +159,15 @@ describe("#461 GET /events/network/:id — auth", () => {
155
159
  test("membership removal revokes observer access — ntok exploit repro (通信龙 review finding 1)", async () => {
156
160
  // Exact repro of the review's exploit: add user C to network A, mint
157
161
  // an ntok BOUND to A, remove C from A — the same live ntok must lose
158
- // the stream. network_members IS the revocation mechanism because
159
- // removeNetworkMember does not revoke the user's tokens; the old
162
+ // the stream. (Before #488 network_members was the only revocation
163
+ // mechanism — removeNetworkMember did not revoke tokens; the old
160
164
  // `!role && authCtx.networkId !== observedNetId` OR-form let the
161
165
  // token's network binding bypass the membership check (utok would
162
166
  // not catch this: its authCtx.networkId is null, so only ntok
163
167
  // exercises the vulnerable branch — verified by stubbing the OR
164
168
  // back in: THIS test goes red, the utok variants stay green).
165
- const added = addNetworkMember(memberNetworkId, outsiderUserId, "member");
169
+ // 多用户 Agent 权限:新成员默认只看授权 Agent;本测试测的是「完全信任的成员」旧语义,显式 agent_access=all。
170
+ const added = addNetworkMember(memberNetworkId, outsiderUserId, "member", undefined, { agentAccess: "all" });
166
171
  expect(added.ok).toBe(true);
167
172
  const minted = createNetworkTokenForNode(outsiderUserId, memberNetworkId, "revocation-probe");
168
173
  expect(minted.ok).toBe(true);
@@ -177,16 +182,93 @@ describe("#461 GET /events/network/:id — auth", () => {
177
182
 
178
183
  const removed = removeNetworkMember(memberNetworkId, outsiderUserId);
179
184
  expect(removed.ok).toBe(true);
180
- // The review's failing probe: /events/network/A with the still-live
181
- // network-bound token → must now be 403, not 200.
185
+ // The review's failing probe: /events/network/A with the network-bound
186
+ // token → must no longer be 200. Since #488 removeNetworkMember revokes
187
+ // the user's tokens for that network and resolveToken rejects a
188
+ // non-member's network token, so the token itself is refused (401).
182
189
  const afterRemoval = await fetch(`${BASE}/events/network/${memberNetworkId}`, { headers: auth(ntok) });
183
- expect(afterRemoval.status).toBe(403);
190
+ expect(afterRemoval.status).toBe(401);
184
191
  // utok of the removed user is denied too.
185
192
  const utokAfter = await fetch(`${BASE}/events/network/${memberNetworkId}`, { headers: auth(outsiderToken) });
186
193
  expect(utokAfter.status).toBe(403);
187
194
  });
188
195
  });
189
196
 
197
+ describe("GET /events/users/me — Desktop user stream auth", () => {
198
+ test("anonymous → 401", async () => {
199
+ const res = await fetch(`${BASE}/events/users/me?network_id=${encodeURIComponent(memberNetworkId)}`);
200
+ expect(res.status).toBe(401);
201
+ });
202
+
203
+ test("ntok is refused for user stream", async () => {
204
+ const minted = createNetworkTokenForNode(memberUserId, memberNetworkId, "desktop-ntok-probe");
205
+ expect(minted.ok).toBe(true);
206
+ const res = await fetch(`${BASE}/events/users/me?network_id=${encodeURIComponent(memberNetworkId)}`, { headers: auth(minted.token!) });
207
+ expect(res.status).toBe(403);
208
+ const body = await res.json() as any;
209
+ expect(body.error).toBe("user_token_required");
210
+ });
211
+
212
+ test("utok without network_id → 400", async () => {
213
+ const res = await fetch(`${BASE}/events/users/me`, { headers: auth(memberToken) });
214
+ expect(res.status).toBe(400);
215
+ const body = await res.json() as any;
216
+ expect(body.error).toBe("network_id required");
217
+ });
218
+
219
+ test("non-member utok → 403", async () => {
220
+ const res = await fetch(`${BASE}/events/users/me?network_id=${encodeURIComponent(memberNetworkId)}`, { headers: auth(outsiderToken) });
221
+ expect(res.status).toBe(403);
222
+ const body = await res.json() as any;
223
+ expect(body.error).toBe("not a member of this network");
224
+ });
225
+
226
+ test("member utok → user stream connected frame keyed to authenticated user", async () => {
227
+ const res = await fetch(`${BASE}/events/users/me?network_id=${encodeURIComponent(memberNetworkId)}`, { headers: auth(memberToken) });
228
+ expect(res.status).toBe(200);
229
+ expect((res.headers.get("content-type") || "").split(";")[0].trim()).toBe("text/event-stream");
230
+ const reader = res.body!.getReader();
231
+ const connected = await readFrame(reader);
232
+ expect(connected.type).toBe("connected");
233
+ expect(connected.user).toBe(true);
234
+ expect(connected.network_id).toBe(memberNetworkId);
235
+ expect(connected.user_id).toBe(memberUserId);
236
+ await reader.cancel();
237
+ });
238
+ });
239
+
240
+ describe("GET /api/messages — client inbox count", () => {
241
+ test("alias filter returns only that inbox and pending_count for unacked rows", async () => {
242
+ const selfAlias = `user-${memberUserId}`;
243
+ db.run(
244
+ `INSERT INTO inbox (id, session_name, type, priority, content, from_session, acked, network_id, created_at)
245
+ VALUES (?1, ?2, 'task', 'normal', 'unread self', 'agent-a', 0, ?3, datetime('now'))`,
246
+ [`msg_self_unread_${Date.now()}`, selfAlias, memberNetworkId],
247
+ );
248
+ db.run(
249
+ `INSERT INTO inbox (id, session_name, type, priority, content, from_session, acked, network_id, created_at)
250
+ VALUES (?1, ?2, 'task', 'normal', 'read self', 'agent-a', 1, ?3, datetime('now'))`,
251
+ [`msg_self_read_${Date.now()}`, selfAlias, memberNetworkId],
252
+ );
253
+ db.run(
254
+ `INSERT INTO inbox (id, session_name, type, priority, content, from_session, acked, network_id, created_at)
255
+ VALUES (?1, 'other-alias', 'task', 'normal', 'other inbox', 'agent-b', 0, ?2, datetime('now'))`,
256
+ [`msg_other_${Date.now()}`, memberNetworkId],
257
+ );
258
+
259
+ const res = await fetch(`${BASE}/api/messages?alias=${encodeURIComponent(selfAlias)}&network_id=${encodeURIComponent(memberNetworkId)}&limit=20`, {
260
+ headers: auth(memberToken),
261
+ });
262
+ expect(res.status).toBe(200);
263
+ const body = await res.json() as any;
264
+ expect(body.ok).toBe(true);
265
+ expect(body.pending_count).toBe(1);
266
+ expect(body.messages.length).toBeGreaterThanOrEqual(2);
267
+ expect(body.messages.every((m: any) => m.to_alias === selfAlias)).toBe(true);
268
+ expect(body.messages.some((m: any) => m.content === "other inbox")).toBe(false);
269
+ });
270
+ });
271
+
190
272
  describe("#461 observer receives third-party traffic summaries", () => {
191
273
  test("REST /api/task dispatch → observer gets new_task summary, no content", async () => {
192
274
  const res = await fetch(`${BASE}/events/network/${memberNetworkId}`, { headers: auth(memberToken) });
@@ -194,10 +276,21 @@ describe("#461 observer receives third-party traffic summaries", () => {
194
276
  await readFrame(reader); // connected
195
277
 
196
278
  const secret = `SECRET-TASK-CONTENT-${Date.now()}`;
279
+ const body = { alias: TARGET_ALIAS, task: secret, priority: "high", from: "third-party-sender", network_id: memberNetworkId };
280
+ // Human tokens send as their authenticated username; they cannot stand
281
+ // in for an Agent. Keep that refusal and exercise the observer with an
282
+ // actual bound sender token instead of weakening the identity contract.
283
+ const spoof = await fetch(`${BASE}/api/task`, {
284
+ method: "POST", headers: { ...auth(memberToken), "Content-Type": "application/json" }, body: JSON.stringify(body),
285
+ });
286
+ expect(spoof.status).toBe(403);
287
+ expect((await spoof.json() as any).error).toBe("from_session_identity_mismatch");
288
+ const sender = createNetworkTokenForNode(memberUserId, memberNetworkId, "third-party-sender", `node_obs_sender_${Date.now()}`);
289
+ expect(sender.ok).toBe(true);
197
290
  const dispatch = await fetch(`${BASE}/api/task`, {
198
291
  method: "POST",
199
- headers: { ...auth(memberToken), "Content-Type": "application/json" },
200
- body: JSON.stringify({ alias: TARGET_ALIAS, task: secret, priority: "high", from: "third-party-sender", network_id: memberNetworkId }),
292
+ headers: { ...auth(sender.token!), "Content-Type": "application/json" },
293
+ body: JSON.stringify(body),
201
294
  });
202
295
  expect([200, 202]).toContain(dispatch.status);
203
296
  const dispatched = await dispatch.json() as any;
@@ -11,8 +11,10 @@ import {
11
11
  __resetSSEClientsForTest,
12
12
  createNetworkObserverStream,
13
13
  createSSEStream,
14
+ createUserEventStream,
14
15
  pushEvent,
15
16
  pushNetworkObserverEvent,
17
+ pushUserEvent,
16
18
  } from "./push";
17
19
 
18
20
  afterEach(() => {
@@ -174,3 +176,77 @@ describe("#461 network observer stream", () => {
174
176
  await reader2.cancel();
175
177
  });
176
178
  });
179
+
180
+ describe("Desktop user SSE stream", () => {
181
+ test("user stream receives connected frame, then desktop_message", async () => {
182
+ const res = createUserEventStream("net_user_a", "u_user_a");
183
+ const reader = res.body!.getReader();
184
+
185
+ const connected = await readFrame(reader);
186
+ expect(connected.type).toBe("connected");
187
+ expect(connected.user).toBe(true);
188
+ expect(connected.network_id).toBe("net_user_a");
189
+ expect(connected.user_id).toBe("u_user_a");
190
+
191
+ pushUserEvent("net_user_a", "u_user_a", {
192
+ type: "desktop_message",
193
+ message_id: "dm_one",
194
+ from: "agent-a",
195
+ message: "hello",
196
+ });
197
+
198
+ const evt = await readFrame(reader);
199
+ expect(evt.type).toBe("desktop_message");
200
+ expect(evt.message_id).toBe("dm_one");
201
+ expect(evt.from).toBe("agent-a");
202
+ expect(evt.message).toBe("hello");
203
+ expect(evt.network_id).toBe("net_user_a");
204
+ expect(evt.user_id).toBe("u_user_a");
205
+ expect(evt.scope).toBe("user");
206
+ await reader.cancel();
207
+ });
208
+
209
+ test("user stream is isolated from alias and observer key spaces", async () => {
210
+ const userRes = createUserEventStream("net_user_iso", "u_iso");
211
+ const userReader = userRes.body!.getReader();
212
+ await readFrame(userReader);
213
+
214
+ const sessionRes = createSSEStream("u_iso", "net_user_iso");
215
+ const sessionReader = sessionRes.body!.getReader();
216
+ await readFrame(sessionReader);
217
+
218
+ const observerRes = createNetworkObserverStream("net_user_iso");
219
+ const observerReader = observerRes.body!.getReader();
220
+ await readFrame(observerReader);
221
+
222
+ pushEvent("u_iso", { type: "alias_marker", marker: "alias" }, "net_user_iso");
223
+ pushNetworkObserverEvent("net_user_iso", { type: "observer_marker", marker: "observer" });
224
+ pushUserEvent("net_user_iso", "u_iso", { type: "desktop_message", marker: "user" });
225
+
226
+ expect((await readFrame(sessionReader)).marker).toBe("alias");
227
+ expect((await readFrame(observerReader)).marker).toBe("observer");
228
+ expect((await readFrame(userReader)).marker).toBe("user");
229
+
230
+ await userReader.cancel();
231
+ await sessionReader.cancel();
232
+ await observerReader.cancel();
233
+ });
234
+
235
+ test("same user and network fan out to multiple live clients; cancelling one leaves the other live", async () => {
236
+ const r1 = createUserEventStream("net_user_multi", "u_multi");
237
+ const r2 = createUserEventStream("net_user_multi", "u_multi");
238
+ const reader1 = r1.body!.getReader();
239
+ const reader2 = r2.body!.getReader();
240
+ await readFrame(reader1);
241
+ await readFrame(reader2);
242
+
243
+ pushUserEvent("net_user_multi", "u_multi", { type: "desktop_message", message_id: "dm_fanout_1" });
244
+ expect((await readFrame(reader1)).message_id).toBe("dm_fanout_1");
245
+ expect((await readFrame(reader2)).message_id).toBe("dm_fanout_1");
246
+
247
+ await reader1.cancel();
248
+ pushUserEvent("net_user_multi", "u_multi", { type: "desktop_message", message_id: "dm_fanout_2" });
249
+ expect((await readFrame(reader2)).message_id).toBe("dm_fanout_2");
250
+ await reader2.cancel();
251
+ });
252
+ });
@@ -0,0 +1,139 @@
1
+ // #2293(admin 2026-10-25)—— 从**节点的真实上报**一路走到 `/api/nodes` 的投影。
2
+ //
3
+ // 为什么这条要单独写:`api-nodes-shape.test.ts` 是**镜像 handler** 的(文件里自己声明会漂),
4
+ // `node-attrs.test.ts` 是直接往库里塞一行快照。两者都没有走 `report_status` 的 zod schema ——
5
+ // 而 schema 恰恰是「节点发了、Hub 上却什么都没有」最容易出事的地方(#1545:往非 strict 对象里
6
+ // 加键会被静默丢弃)。这里用真 node 令牌 + 真 MCP `tools/call` + 真 `GET /api/nodes`。
7
+ //
8
+ // 断言三件事:
9
+ // 1. `opencode_catalog` / `opencode_server` / flags 里的代际·模式,经 schema 后**落到库里**;
10
+ // 2. `/api/nodes` 把它们投影出来,且**整个 config_snapshot 不外泄**;
11
+ // 3. 形状不对(嵌对象、混非字符串)时**心跳照收**,只是这一格没有 —— 不许拒整份上报。
12
+
13
+ import { afterAll, beforeAll, describe, expect, test } from "bun:test";
14
+ import { mkdtempSync, rmSync } from "node:fs";
15
+ import { tmpdir } from "node:os";
16
+ import { join } from "node:path";
17
+ import { createNetworkTokenForNode, register } from "./auth.js";
18
+ import { db } from "./db.js";
19
+
20
+ const DIR = mkdtempSync(join(tmpdir(), "anet-catalog-report-"));
21
+ process.env.COMMHUB_DB ||= join(DIR, "commhub.db");
22
+
23
+ const stamp = `${process.pid}_${Date.now()}`;
24
+ const NET_ALIAS = `catalog-${stamp}`;
25
+ let hub: any;
26
+ let base = "";
27
+ let adminToken = "";
28
+ let nodeToken = "";
29
+ let networkId = "";
30
+ let nodeId = "";
31
+
32
+ async function send(token: string, method: string, path: string, body?: unknown) {
33
+ const r = await fetch(`${base}${path}`, {
34
+ method,
35
+ headers: { Authorization: `Bearer ${token}`, "Content-Type": "application/json" },
36
+ body: body === undefined ? undefined : JSON.stringify(body),
37
+ });
38
+ const text = await r.text();
39
+ let json: any = null;
40
+ try { json = text ? JSON.parse(text) : null; } catch { /* MCP may answer as SSE */ }
41
+ return { status: r.status, body: json, text };
42
+ }
43
+
44
+ /** 真 MCP `tools/call report_status`,和 agent-node 心跳走同一条入参路径。 */
45
+ async function reportStatus(snapshot: Record<string, unknown>) {
46
+ const r = await fetch(`${base}/mcp`, {
47
+ method: "POST",
48
+ headers: { Authorization: `Bearer ${nodeToken}`, "Content-Type": "application/json", Accept: "application/json, text/event-stream" },
49
+ body: JSON.stringify({
50
+ jsonrpc: "2.0", id: 1, method: "tools/call",
51
+ params: {
52
+ name: "report_status",
53
+ arguments: {
54
+ resume_id: `r_catalog_${stamp}`, alias: NET_ALIAS, status: "idle", node_id: nodeId,
55
+ runtime: "opencode-sdk",
56
+ config_snapshot: { model: "deepseek/deepseek-flash", ...snapshot },
57
+ },
58
+ },
59
+ }),
60
+ });
61
+ await r.text();
62
+ return r.status;
63
+ }
64
+
65
+ async function listNodes() {
66
+ const r = await send(adminToken, "GET", `/api/nodes?network_id=${networkId}`);
67
+ expect(r.status).toBe(200);
68
+ return (r.body?.nodes ?? []) as Array<Record<string, unknown>>;
69
+ }
70
+
71
+ beforeAll(async () => {
72
+ const admin = register(`catalog_admin_${stamp}`, "CatalogAdmin123!", undefined, "Catalog Admin");
73
+ expect(admin.ok).toBe(true);
74
+ adminToken = admin.token!;
75
+ networkId = admin.network_id!;
76
+ const ownerId = admin.user!.user_id;
77
+ nodeId = `n_catalog_${stamp}`;
78
+ const minted = createNetworkTokenForNode(ownerId, networkId, NET_ALIAS, nodeId);
79
+ expect(minted.ok).toBe(true);
80
+ nodeToken = minted.token!;
81
+ const mod: any = await import("./server.js");
82
+ hub = mod.bootServer({ port: 0, hostname: "127.0.0.1" });
83
+ base = `http://127.0.0.1:${hub.port}`;
84
+ }, 30_000);
85
+
86
+ afterAll(() => {
87
+ try { hub?.stop?.(true); } catch { /* already down */ }
88
+ try { rmSync(DIR, { recursive: true, force: true }); } catch { /* best effort */ }
89
+ });
90
+
91
+ describe("#2293 node-reported OpenCode catalog reaches GET /api/nodes", () => {
92
+ test("a real report_status lands the catalog and the scalars on the node row", async () => {
93
+ expect(await reportStatus({
94
+ flags: { opencodeGeneration: "v2", opencodeMode: "copresence", daemonSideSecret: "must-not-leak" },
95
+ opencode_catalog: ["deepseek/deepseek-flash", "opencode/mimo-v2.6-flash-free"],
96
+ opencode_server: "http://127.0.0.1:4096",
97
+ })).toBe(200);
98
+
99
+ const stored = db.get<{ config_snapshot: string }>("SELECT config_snapshot FROM nodes WHERE node_id = ?1", nodeId)!;
100
+ expect(JSON.parse(stored.config_snapshot).opencode_catalog).toEqual([
101
+ "deepseek/deepseek-flash", "opencode/mimo-v2.6-flash-free",
102
+ ]);
103
+
104
+ const row = (await listNodes()).find(r => r.node_id === nodeId)!;
105
+ expect(row).toBeDefined();
106
+ expect(row.opencode_catalog).toEqual(["deepseek/deepseek-flash", "opencode/mimo-v2.6-flash-free"]);
107
+ expect(row.opencode_generation).toBe("v2");
108
+ expect(row.opencode_mode).toBe("copresence");
109
+ expect(row.opencode_server).toBe("http://127.0.0.1:4096");
110
+ // 整个快照仍然不出现在这一行里;flags 中的其它键也不外泄。
111
+ expect(row).not.toHaveProperty("config_snapshot");
112
+ expect(JSON.stringify(row)).not.toContain("must-not-leak");
113
+ });
114
+
115
+ test("a malformed catalog drops that field only — the heartbeat is still accepted", async () => {
116
+ expect(await reportStatus({
117
+ flags: { opencodeGeneration: "v2" },
118
+ // 嵌对象 + 混入数字:形状不对,schema 的 `.catch(undefined)` 应当只丢这一格。
119
+ opencode_catalog: { models: ["deepseek/deepseek-flash"] },
120
+ opencode_server: 12345,
121
+ })).toBe(200);
122
+
123
+ const row = (await listNodes()).find(r => r.node_id === nodeId)!;
124
+ expect(row).toBeDefined();
125
+ expect(row.opencode_catalog).toBeNull();
126
+ expect(row.opencode_server).toBeNull();
127
+ // 代际这一格仍然照常投影(没被同一条错误连带丢掉)。
128
+ expect(row.opencode_generation).toBe("v2");
129
+ });
130
+
131
+ test("a node that never reported the fields reads as null on every one of them", async () => {
132
+ const other = (await listNodes()).find(r => r.node_id !== nodeId);
133
+ if (!other) return; // 该网络里只有一个节点时无需断言(不是失败)
134
+ expect(other.opencode_catalog ?? null).toBeNull();
135
+ expect(other.opencode_generation ?? null).toBeNull();
136
+ expect(other.opencode_mode ?? null).toBeNull();
137
+ expect(other.opencode_server ?? null).toBeNull();
138
+ });
139
+ });