@sleep2agi/commhub-server 0.9.0-preview.25 → 0.9.0-preview.250

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 (417) hide show
  1. package/README.md +129 -9
  2. package/bin/commhub.ts +93 -9
  3. package/build-info.json +7 -0
  4. package/package.json +10 -8
  5. package/src/ack-create-request-transport.test.ts +182 -0
  6. package/src/ack-create-request.test.ts +52 -8
  7. package/src/admin-delete-network-http.test.ts +228 -0
  8. package/src/admin-networks-http.test.ts +88 -0
  9. package/src/adoption-candidates-http.test.ts +140 -0
  10. package/src/adoption-candidates.ts +158 -0
  11. package/src/agent-access-batch.test.ts +210 -0
  12. package/src/agent-access.ts +487 -0
  13. package/src/agent-acl-groups-http.test.ts +247 -0
  14. package/src/agent-acl-http.test.ts +675 -0
  15. package/src/agent-acl-slice3-http.test.ts +717 -0
  16. package/src/agent-department-http.test.ts +215 -0
  17. package/src/agent-groups-perf.test.ts +223 -0
  18. package/src/agent-notice.ts +48 -0
  19. package/src/agent-team-whoami-http.test.ts +98 -0
  20. package/src/agent-teams-http.test.ts +330 -0
  21. package/src/agent-teams.ts +244 -0
  22. package/src/alias-baseline-2571.test.ts +162 -0
  23. package/src/alias-baseline.ts +113 -0
  24. package/src/alias-filter.test.ts +72 -0
  25. package/src/alias-filter.ts +42 -0
  26. package/src/api-host-supervisors-can-create-nodes.test.ts +350 -0
  27. package/src/api-host-supervisors-fallback.test.ts +6 -7
  28. package/src/api-host-supervisors-runtime-readiness.test.ts +195 -0
  29. package/src/api-nodes-shape.test.ts +95 -4
  30. package/src/auth-password-change-cli-tokens-http.test.ts +423 -0
  31. package/src/auth-sessions-http.test.ts +260 -0
  32. package/src/auth-validate.test.ts +5 -1
  33. package/src/auth-weak-password-login.test.ts +176 -0
  34. package/src/auth.ts +609 -51
  35. package/src/avatar-validate.test.ts +52 -2
  36. package/src/avatar-validate.ts +35 -1
  37. package/src/backfill-node-ids-2664.test.ts +128 -0
  38. package/src/binding-generation-http.test.ts +132 -0
  39. package/src/blocked-exit-on-reply.test.ts +122 -0
  40. package/src/broadcast-fanout-2721.test.ts +149 -0
  41. package/src/broadcast-fanout.ts +117 -0
  42. package/src/build-info.test.ts +60 -0
  43. package/src/build-info.ts +85 -0
  44. package/src/chain-attempt-dedup.test.ts +447 -0
  45. package/src/clip.test.ts +36 -0
  46. package/src/clip.ts +48 -0
  47. package/src/clone-node.test.ts +262 -0
  48. package/src/clone-node.ts +289 -0
  49. package/src/codex-config-flags.ts +77 -0
  50. package/src/codex-fork-contract.ts +23 -0
  51. package/src/codex-fork-migration.test.ts +38 -0
  52. package/src/commhub-bin-args.test.ts +85 -0
  53. package/src/config-apply-validate.test.ts +188 -1
  54. package/src/config-apply-validate.ts +222 -3
  55. package/src/cors-origins.test.ts +73 -0
  56. package/src/create-node-blocked-gate.test.ts +356 -0
  57. package/src/create-node-network-id.test.ts +91 -0
  58. package/src/create-node-tool-schema.test.ts +49 -0
  59. package/src/create-node-unicode-name.test.ts +126 -0
  60. package/src/create-node-validate.test.ts +199 -7
  61. package/src/create-node-validate.ts +232 -15
  62. package/src/create-node-workdir.test.ts +298 -0
  63. package/src/create-node.ts +88 -23
  64. package/src/daemon-provider-snapshots.test.ts +445 -0
  65. package/src/daemon-provider-snapshots.ts +327 -0
  66. package/src/daemon-token-owner-http.test.ts +292 -0
  67. package/src/dashboard-slash-routing-http.test.ts +109 -0
  68. package/src/db-adapter-guard.test.ts +148 -0
  69. package/src/db-adapter-translate.test.ts +128 -0
  70. package/src/db-adapter.ts +377 -91
  71. package/src/db-timestamp.test.ts +38 -0
  72. package/src/db-timestamp.ts +15 -0
  73. package/src/db.ts +1264 -153
  74. package/src/delivered-without-push.test.ts +140 -0
  75. package/src/department-groups-http.test.ts +209 -0
  76. package/src/department-groups-sync-http.test.ts +328 -0
  77. package/src/department-groups.ts +434 -0
  78. package/src/department-heads-http.test.ts +350 -0
  79. package/src/department-heads.ts +226 -0
  80. package/src/departments-agent-count.test.ts +132 -0
  81. package/src/departments-http.test.ts +185 -0
  82. package/src/departments-mcp.test.ts +128 -0
  83. package/src/departments.ts +318 -0
  84. package/src/desktop-message-seam.test.ts +150 -0
  85. package/src/desktop-message.test.ts +368 -0
  86. package/src/dm-file-scope-http.test.ts +178 -0
  87. package/src/empty-node-sweeper.test.ts +104 -0
  88. package/src/empty-node-sweeper.ts +88 -0
  89. package/src/env-transport-gate-http.test.ts +240 -0
  90. package/src/env-transport-gate.ts +80 -0
  91. package/src/env-transport-policy.ts +56 -0
  92. package/src/etag-of.test.ts +57 -0
  93. package/src/event-loop-lag.test.ts +180 -0
  94. package/src/event-loop-lag.ts +201 -0
  95. package/src/expiry-counters.test.ts +111 -0
  96. package/src/expiry-counters.ts +93 -0
  97. package/src/ext-token-shared.test.ts +60 -0
  98. package/src/ext-validation-regression.test.ts +131 -0
  99. package/src/external-schedule-edits-http.test.ts +321 -0
  100. package/src/external-schedule-edits-timestamps.test.ts +64 -0
  101. package/src/external-schedule-edits.ts +327 -0
  102. package/src/file-download-authz-dev-open.test.ts +1 -1
  103. package/src/file-download-authz.test.ts +73 -18
  104. package/src/file-download-date-bucket.test.ts +8 -26
  105. package/src/file-network-scope-dev-open.test.ts +97 -0
  106. package/src/file-network-scope.test.ts +732 -0
  107. package/src/group-membership-events-http.test.ts +264 -0
  108. package/src/group-messages-http.test.ts +483 -0
  109. package/src/group-messages.ts +297 -0
  110. package/src/health-anon-readers.ts +60 -0
  111. package/src/health-host-disk-2756.test.ts +71 -0
  112. package/src/health-redaction.test.ts +1541 -7
  113. package/src/host-supervisor-identity-http.test.ts +152 -0
  114. package/src/host-supervisor-identity.ts +92 -0
  115. package/src/host-supervisors-daemon-version.test.ts +137 -0
  116. package/src/http-gzip.test.ts +94 -0
  117. package/src/http-gzip.ts +112 -0
  118. package/src/hub-catalog-read-http.test.ts +641 -0
  119. package/src/hub-provider-config.test.ts +166 -0
  120. package/src/hub-provider-config.ts +202 -0
  121. package/src/hub-timestamp.test.ts +38 -0
  122. package/src/hub-timestamp.ts +27 -0
  123. package/src/human-dm.ts +215 -0
  124. package/src/human-inbox.ts +42 -0
  125. package/src/inbox-caller.ts +49 -0
  126. package/src/inbox-count-sse.test.ts +310 -0
  127. package/src/inbox-count.ts +29 -0
  128. package/src/index.ts +6 -2
  129. package/src/license-state.test.ts +56 -0
  130. package/src/license-state.ts +48 -0
  131. package/src/list-host-supervisors.test.ts +15 -4
  132. package/src/mcp-context-cost-http.test.ts +127 -0
  133. package/src/mcp-inflight.test.ts +92 -0
  134. package/src/mcp-inflight.ts +38 -0
  135. package/src/mcp-projects-events-http.test.ts +165 -0
  136. package/src/mcp-route-label-http.test.ts +120 -0
  137. package/src/mcp-write-network-resolution.test.ts +435 -0
  138. package/src/member-audit-network-id-http.test.ts +93 -0
  139. package/src/member-presence-http.test.ts +210 -0
  140. package/src/messages-ack-by-agent-http.test.ts +142 -0
  141. package/src/migrate-sqlite-to-pg.test.ts +47 -0
  142. package/src/migrate-sqlite-to-pg.ts +263 -0
  143. package/src/model-auth-notify-http.test.ts +181 -0
  144. package/src/model-auth-notify.ts +116 -0
  145. package/src/network-name-http.test.ts +75 -0
  146. package/src/network-rules-http.test.ts +169 -0
  147. package/src/network-rules.ts +129 -0
  148. package/src/network-scope.ts +276 -0
  149. package/src/network-token-membership-http.test.ts +186 -0
  150. package/src/node-alias-control.ts +12 -0
  151. package/src/node-attrs.test.ts +47 -2
  152. package/src/node-caller-identity-http.test.ts +1108 -0
  153. package/src/node-create-request-status-http.test.ts +105 -0
  154. package/src/node-daemon-bindings.test.ts +132 -0
  155. package/src/node-daemon-bindings.ts +135 -0
  156. package/src/node-failure-alert.test.ts +150 -0
  157. package/src/node-failure-alert.ts +177 -0
  158. package/src/node-files-transport.test.ts +347 -0
  159. package/src/node-health-codex-login.test.ts +120 -0
  160. package/src/node-health-dispatch-http.test.ts +373 -0
  161. package/src/node-health-guard.ts +121 -0
  162. package/src/node-health-passthrough.test.ts +115 -0
  163. package/src/node-health-store.ts +101 -0
  164. package/src/node-id-alias.test.ts +190 -0
  165. package/src/node-identity-conflict-http.test.ts +269 -0
  166. package/src/node-identity-conflict.ts +142 -0
  167. package/src/node-identity-mismatch.test.ts +74 -0
  168. package/src/node-in-flight-tasks.ts +31 -0
  169. package/src/node-lifecycle-controllable.test.ts +64 -0
  170. package/src/node-lifecycle-controllable.ts +53 -0
  171. package/src/node-lifecycle-read-http.test.ts +257 -0
  172. package/src/node-lifecycle-read.ts +124 -0
  173. package/src/node-logs-transport.test.ts +263 -0
  174. package/src/node-peer-allowlist.test.ts +114 -0
  175. package/src/node-permissions-http.test.ts +728 -0
  176. package/src/node-permissions.ts +494 -0
  177. package/src/node-request-retention.test.ts +281 -0
  178. package/src/node-request-retention.ts +120 -0
  179. package/src/node-secret-rest-http.test.ts +190 -0
  180. package/src/node-serviceability.test.ts +86 -0
  181. package/src/node-serviceability.ts +124 -0
  182. package/src/node-session-control-http.test.ts +310 -0
  183. package/src/node-session-control.ts +258 -0
  184. package/src/node-skills-transport.test.ts +212 -0
  185. package/src/node-token-identity.ts +35 -0
  186. package/src/node-token-ownership.ts +51 -0
  187. package/src/node-token-privilege-http.test.ts +158 -0
  188. package/src/not-found-api-http.test.ts +67 -0
  189. package/src/observer-avatar-http.test.ts +102 -9
  190. package/src/observer-push.test.ts +76 -0
  191. package/src/opencode-catalog-report-http.test.ts +139 -0
  192. package/src/opencode-v2-catalog.test.ts +268 -0
  193. package/src/opencode-v2-catalog.ts +356 -0
  194. package/src/package-version-consistency.test.ts +25 -0
  195. package/src/parent-source-marker.test.ts +50 -0
  196. package/src/password-network-tokens.ts +25 -0
  197. package/src/peer-reply-atomic.test.ts +462 -0
  198. package/src/peer-reply-capability.test.ts +70 -0
  199. package/src/pg-worker.ts +87 -0
  200. package/src/poll-pacing.test.ts +74 -0
  201. package/src/poll-pacing.ts +123 -0
  202. package/src/project-dir-warn-clear-http.test.ts +132 -0
  203. package/src/project-viewer-can-http.test.ts +116 -0
  204. package/src/provider-tools-shape.test.ts +150 -0
  205. package/src/push.test.ts +20 -10
  206. package/src/push.ts +373 -9
  207. package/src/redact-tokens.test.ts +86 -0
  208. package/src/redact-tokens.ts +43 -0
  209. package/src/rejection-counters.test.ts +72 -0
  210. package/src/rejection-counters.ts +173 -0
  211. package/src/rename.ts +38 -10
  212. package/src/reply-target-derivation.test.ts +96 -0
  213. package/src/report-status-handover-capabilities-http.test.ts +124 -0
  214. package/src/report-status-host-schema.test.ts +235 -0
  215. package/src/report-status-resume-id-handover.test.ts +184 -0
  216. package/src/report-status-secret-keys.test.ts +140 -0
  217. package/src/require-explicit-test-db.ts +9 -0
  218. package/src/requirement-due-reminders-http.test.ts +620 -0
  219. package/src/requirement-due-reminders.ts +416 -0
  220. package/src/requirement-events-http.test.ts +318 -0
  221. package/src/requirement-events.test.ts +45 -0
  222. package/src/requirement-events.ts +144 -0
  223. package/src/requirement-notify.ts +165 -0
  224. package/src/requirement-participant-notify-http.test.ts +309 -0
  225. package/src/requirement-tag-ops-http.test.ts +454 -0
  226. package/src/requirement-tag-tree-http.test.ts +275 -0
  227. package/src/requirement-tag-tree.ts +127 -0
  228. package/src/requirement-tags.ts +102 -0
  229. package/src/requirements-abandoned-http.test.ts +236 -0
  230. package/src/requirements-assignee-drift.test.ts +154 -0
  231. package/src/requirements-comment-http.test.ts +174 -0
  232. package/src/requirements-completed-at-migration.test.ts +70 -0
  233. package/src/requirements-errors-mcp-http.test.ts +164 -0
  234. package/src/requirements-errors.ts +158 -0
  235. package/src/requirements-etag-http.test.ts +91 -0
  236. package/src/requirements-http.test.ts +709 -0
  237. package/src/requirements-last-event-http.test.ts +349 -0
  238. package/src/requirements-list-mcp-slim-http.test.ts +155 -0
  239. package/src/requirements-list-slim-http.test.ts +324 -0
  240. package/src/requirements-mcp.test.ts +164 -0
  241. package/src/requirements-migrate.ts +283 -0
  242. package/src/requirements-owner-strict-mcp-http.test.ts +145 -0
  243. package/src/requirements-people-http.test.ts +114 -0
  244. package/src/requirements-people-mcp-http.test.ts +231 -0
  245. package/src/requirements-people.ts +196 -0
  246. package/src/requirements-priority-lowest.test.ts +114 -0
  247. package/src/requirements-projects-network-echo.test.ts +57 -0
  248. package/src/requirements-projects-parent-http.test.ts +123 -0
  249. package/src/requirements-search-http.test.ts +182 -0
  250. package/src/requirements-search.test.ts +32 -0
  251. package/src/requirements-search.ts +145 -0
  252. package/src/requirements-seq-http.test.ts +193 -0
  253. package/src/requirements-seq-migration.test.ts +63 -0
  254. package/src/requirements-start-date.test.ts +125 -0
  255. package/src/requirements-stats-http.test.ts +357 -0
  256. package/src/requirements-stats.ts +195 -0
  257. package/src/requirements-status-participants-http.test.ts +222 -0
  258. package/src/requirements-upgrade-e2e.test.ts +126 -0
  259. package/src/requirements-upgrade-migration.test.ts +98 -0
  260. package/src/requirements.ts +2205 -0
  261. package/src/resolve-port.test.ts +57 -0
  262. package/src/resolve-port.ts +44 -0
  263. package/src/rest-alias-network-fallback-http.test.ts +123 -0
  264. package/src/rest-alias-network-fallback.test.ts +60 -0
  265. package/src/rest-alias-network-fallback.ts +65 -0
  266. package/src/rest-explicit-columns-http.test.ts +266 -0
  267. package/src/rest-identity.test.ts +130 -0
  268. package/src/rest-identity.ts +141 -0
  269. package/src/rest-projections.ts +72 -0
  270. package/src/rest-read-network-real-chain.test.ts +97 -0
  271. package/src/rest-write-network-resolution.test.ts +133 -0
  272. package/src/restart-readiness-http.test.ts +121 -0
  273. package/src/restricted-files.ts +76 -0
  274. package/src/retention-first-sweep-quiet.test.ts +31 -0
  275. package/src/retention.test.ts +100 -40
  276. package/src/retention.ts +423 -104
  277. package/src/route-callers-http.test.ts +120 -0
  278. package/src/route-timing.test.ts +218 -0
  279. package/src/route-timing.ts +262 -0
  280. package/src/rules-file-duplicate-alias.test.ts +234 -0
  281. package/src/rules-file-session-target.test.ts +207 -0
  282. package/src/rules-file-transport.test.ts +237 -0
  283. package/src/runtime-label.test.ts +22 -0
  284. package/src/runtime-label.ts +21 -0
  285. package/src/runtime-readiness.ts +90 -0
  286. package/src/schedule-agent-mcp-http.test.ts +475 -0
  287. package/src/schedule-agent.ts +252 -0
  288. package/src/schedule-starved.test.ts +92 -0
  289. package/src/schedule-starved.ts +114 -0
  290. package/src/scheduled-backoff-http.test.ts +203 -0
  291. package/src/scheduled-backoff.ts +64 -0
  292. package/src/scheduled-doorbell-nodeless-session.test.ts +134 -0
  293. package/src/scheduled-failure-backoff-2622.test.ts +145 -0
  294. package/src/scheduled-failure-code.test.ts +73 -0
  295. package/src/scheduled-failure-code.ts +105 -0
  296. package/src/scheduled-failures-http.test.ts +279 -0
  297. package/src/scheduled-failures.ts +425 -0
  298. package/src/scheduled-noprogress-backoff-2622.test.ts +163 -0
  299. package/src/scheduled-offline-backoff-probe.test.ts +56 -0
  300. package/src/scheduled-offline.test.ts +131 -0
  301. package/src/scheduled-offline.ts +66 -0
  302. package/src/scheduled-outcome-guidance-http.test.ts +139 -0
  303. package/src/scheduled-outcome-guidance.ts +9 -0
  304. package/src/scheduled-reply-unread-http.test.ts +212 -0
  305. package/src/scheduled-requirement-wake-http.test.ts +285 -0
  306. package/src/scheduled-requirement-wake.ts +125 -0
  307. package/src/scheduled-run-terminal.test.ts +290 -0
  308. package/src/scheduled-skip-blocking-task.test.ts +120 -0
  309. package/src/scheduled-skip-path-backoff-2622.test.ts +98 -0
  310. package/src/scheduled-stuck-http.test.ts +316 -0
  311. package/src/scheduled-stuck-notice-cap.test.ts +80 -0
  312. package/src/scheduled-stuck.ts +219 -0
  313. package/src/scheduled-tasks-http.test.ts +679 -0
  314. package/src/scheduled-tasks.ts +959 -0
  315. package/src/scheduled-work-outcome-http.test.ts +154 -0
  316. package/src/scheduled-work-outcome.ts +50 -0
  317. package/src/scoped-secrets.ts +141 -0
  318. package/src/secret-echo-negative-control.test.ts +118 -0
  319. package/src/send-dedup-request-id.test.ts +229 -0
  320. package/src/send-reply-agent-warning.test.ts +38 -38
  321. package/src/send-reply-alias-optional.test.ts +131 -0
  322. package/src/send-reply-attachments.test.ts +458 -0
  323. package/src/send_dedup.test.ts +54 -0
  324. package/src/send_dedup.ts +52 -6
  325. package/src/serve-error.test.ts +73 -0
  326. package/src/serve-error.ts +56 -0
  327. package/src/server.ts +5134 -503
  328. package/src/session-task-on-dispatch.ts +14 -0
  329. package/src/session-token-ownership-http.test.ts +122 -0
  330. package/src/shared/codex-inventory.ts +41 -0
  331. package/src/shared/daemon-provider-login.ts +31 -0
  332. package/src/shared/daemon-provider-snapshot.ts +52 -0
  333. package/src/shared/external-schedule-contract.ts +60 -0
  334. package/src/shared/node-name.test.ts +62 -0
  335. package/src/shared/node-name.ts +161 -0
  336. package/src/shared/probe-host-allowlist-drift.test.ts +45 -0
  337. package/src/shared/provider-application.ts +29 -0
  338. package/src/shared/provider-collection.ts +14 -0
  339. package/src/shared/provider-initialization.ts +8 -0
  340. package/src/shared/reserved-env-drift.test.ts +10 -0
  341. package/src/shared/scoped-secret-contract.ts +5 -0
  342. package/src/shared/task-content-limit-drift.test.ts +28 -0
  343. package/src/shared/task-content-limit.ts +25 -0
  344. package/src/side-thread-command-transport.test.ts +312 -0
  345. package/src/side-thread-command-transport.ts +318 -0
  346. package/src/side-thread-http-integration.test.ts +233 -0
  347. package/src/side-thread-http.ts +504 -0
  348. package/src/side-thread-production.test.ts +72 -0
  349. package/src/side-thread-production.ts +118 -0
  350. package/src/side-thread.test.ts +1067 -0
  351. package/src/side-thread.ts +2499 -0
  352. package/src/skillhub-http.test.ts +142 -0
  353. package/src/sqlite-close-checkpoint.test.ts +78 -0
  354. package/src/start-node.test.ts +265 -0
  355. package/src/stats-versions-http.test.ts +65 -0
  356. package/src/status-alias-filter-http.test.ts +106 -0
  357. package/src/status-alias-resolver-http.test.ts +163 -0
  358. package/src/status-alias-resolver.ts +19 -0
  359. package/src/status-node-id-filter-http.test.ts +161 -0
  360. package/src/status-read-cache-http.test.ts +229 -0
  361. package/src/status-read-cache.ts +129 -0
  362. package/src/stop-delete-node.test.ts +567 -1
  363. package/src/task-access-http.test.ts +402 -0
  364. package/src/task-access.ts +420 -0
  365. package/src/task-activity.ts +60 -0
  366. package/src/task-auth-origin-http.test.ts +93 -0
  367. package/src/task-auth-origin.test.ts +24 -0
  368. package/src/task-auth-origin.ts +7 -0
  369. package/src/task-consumption.test.ts +498 -0
  370. package/src/task-diagnostic-http.test.ts +149 -0
  371. package/src/task-diagnostic.test.ts +115 -0
  372. package/src/task-diagnostic.ts +118 -0
  373. package/src/task-expiry-notice-http.test.ts +287 -0
  374. package/src/task-expiry-notice.ts +318 -0
  375. package/src/task-idempotency-mcp.test.ts +142 -0
  376. package/src/task-idempotency.test.ts +76 -0
  377. package/src/task-idempotency.ts +81 -0
  378. package/src/task-late-replies.ts +54 -0
  379. package/src/task-late-reply-http.test.ts +227 -0
  380. package/src/task-lifecycle-watcher-busy.test.ts +114 -0
  381. package/src/task-lifecycle-watcher.test.ts +209 -0
  382. package/src/task-lifecycle-watcher.ts +109 -0
  383. package/src/task-network-resolution-http.test.ts +140 -0
  384. package/src/task-offline-delivery-2668.test.ts +119 -0
  385. package/src/task-offline-delivery.ts +81 -0
  386. package/src/task-orphan-http.test.ts +287 -0
  387. package/src/task-orphan.ts +119 -0
  388. package/src/task-queue-ahead-http.test.ts +309 -0
  389. package/src/task-queue-ahead-scale.test.ts +236 -0
  390. package/src/task-queue-ahead.ts +186 -0
  391. package/src/task-rejection-log-http.test.ts +160 -0
  392. package/src/task-rejection-log.ts +61 -0
  393. package/src/task-sender-http.test.ts +143 -0
  394. package/src/task-stale-open-http.test.ts +292 -0
  395. package/src/task-stale-open.ts +103 -0
  396. package/src/tasks-pagination-http.test.ts +141 -0
  397. package/src/team-rules-status-http.test.ts +90 -0
  398. package/src/team-rules-status.test.ts +59 -0
  399. package/src/team-rules-status.ts +72 -0
  400. package/src/tmux-allowlist.test.ts +48 -0
  401. package/src/tool-audience-http.test.ts +230 -0
  402. package/src/tool-audience.ts +127 -0
  403. package/src/tools-list-json-schema.test.ts +94 -0
  404. package/src/tools.ts +4326 -420
  405. package/src/upload-early-reject-guard.test.ts +155 -0
  406. package/src/uploads-http.test.ts +86 -7
  407. package/src/uploads.ts +38 -4
  408. package/src/user-avatar-http.test.ts +74 -0
  409. package/src/user-avatar-image.ts +160 -0
  410. package/src/user-avatar-migration.test.ts +25 -0
  411. package/src/user-avatar-upload-http.test.ts +348 -0
  412. package/src/user-inbox-by-agent-http.test.ts +165 -0
  413. package/src/user-inbox-netid-notnull.test.ts +122 -0
  414. package/src/user-inbox-read-http.test.ts +223 -0
  415. package/src/user-inbox-schema.test.ts +54 -0
  416. package/src/version-stats.test.ts +66 -0
  417. package/src/version-stats.ts +109 -0
@@ -0,0 +1,158 @@
1
+ // 节点令牌不继承签发者的账号权限与 Hub 管理员身份。
2
+ //
3
+ // 生产上几乎所有节点令牌(ntok_)都由管理员签发,resolveToken 把它解析成那个管理员用户。
4
+ // 以前一部分端点直接看 `resolved.user.role === "admin"` 或把令牌当成用户本人,于是任何一个节点
5
+ // 都能:列全部用户、读服务端日志与审计日志、给签发者再签用户令牌 / 节点令牌、改签发者资料与密码、
6
+ // 建 / 改 / 删网络、管成员与邀请、读别的网络详情、看全部网络的 SSE 拓扑。
7
+ // 这里每一条在修复前(main)都是红的;管理员自己的用户令牌作为正控,照常可用。
8
+
9
+ import { describe, expect, test, beforeAll, afterAll } from "bun:test";
10
+ import { mkdtempSync, rmSync } from "fs";
11
+ import { join } from "path";
12
+ import { tmpdir } from "os";
13
+ import { register, createNetwork, createNetworkTokenForNode } from "./auth.js";
14
+ import { db } from "./db.js";
15
+
16
+ const DIR = mkdtempSync(join(tmpdir(), "anet-ntok-priv-"));
17
+ let BASE = "";
18
+ let hub: any = null;
19
+ const PW = "NtokPrivPassw0rd!";
20
+ let adminToken = "", adminId = "", NET = "", OTHER_NET = "", ntok = "";
21
+
22
+ const auth = (t: string) => ({ Authorization: `Bearer ${t}` });
23
+ async function call(token: string, method: string, path: string, body?: unknown) {
24
+ const res = await fetch(`${BASE}${path}`, {
25
+ method,
26
+ headers: { ...auth(token), ...(body === undefined ? {} : { "Content-Type": "application/json" }) },
27
+ body: body === undefined ? undefined : JSON.stringify(body),
28
+ });
29
+ return { status: res.status, body: await res.json().catch(() => null) as any };
30
+ }
31
+
32
+ beforeAll(async () => {
33
+ process.env.COMMHUB_DB ||= join(DIR, "hub.db");
34
+ process.env.COMMHUB_UPLOADS_DIR = join(DIR, "uploads");
35
+ process.env.HOST = "127.0.0.1";
36
+ const admin = register(`ntok_admin_${Date.now()}`, PW);
37
+ adminToken = admin.token!; adminId = admin.user!.user_id; NET = admin.network_id!;
38
+ db.run("UPDATE users SET role = 'admin' WHERE user_id = ?1", [adminId]);
39
+ const other = createNetwork(adminId, "ntok-other");
40
+ OTHER_NET = (other as any).network_id;
41
+ const minted = createNetworkTokenForNode(adminId, NET, "ntok-node", "node_ntok_priv");
42
+ expect(minted.ok).toBe(true);
43
+ ntok = minted.token!;
44
+ register(`ntok_someone_${Date.now()}`, PW);
45
+ const mod: any = await import("./server.js");
46
+ hub = mod.bootServer({ port: 0, hostname: "127.0.0.1" });
47
+ BASE = `http://127.0.0.1:${hub.port}`;
48
+ }, 30_000);
49
+
50
+ afterAll(() => {
51
+ try { hub?.stop?.(true); } catch {}
52
+ try { rmSync(DIR, { recursive: true, force: true }); } catch {}
53
+ });
54
+
55
+ describe("hub-admin powers need a user token", () => {
56
+ test("GET /api/users", async () => {
57
+ expect((await call(ntok, "GET", "/api/users")).status).toBe(403);
58
+ expect((await call(adminToken, "GET", "/api/users")).status).toBe(200);
59
+ });
60
+ test("GET /api/server-logs", async () => {
61
+ expect((await call(ntok, "GET", "/api/server-logs")).status).toBe(403);
62
+ expect((await call(adminToken, "GET", "/api/server-logs")).status).toBe(200);
63
+ });
64
+ test("GET /api/audit-log", async () => {
65
+ expect((await call(ntok, "GET", "/api/audit-log")).status).toBe(403);
66
+ expect((await call(adminToken, "GET", "/api/audit-log")).status).toBe(200);
67
+ });
68
+ test("GET /api/networks/:id of a network the token is not bound to", async () => {
69
+ expect((await call(ntok, "GET", `/api/networks/${OTHER_NET}`)).status).toBe(403);
70
+ expect((await call(ntok, "GET", `/api/networks/${NET}`)).status).toBe(200);
71
+ });
72
+ test("GET /api/stats/sse is limited to the bound network", async () => {
73
+ const ctrl = new AbortController();
74
+ const sub = await fetch(`${BASE}/events/some-agent?network_id=${OTHER_NET}`, { headers: auth(adminToken), signal: ctrl.signal }).catch(() => null);
75
+ const r = await call(ntok, "GET", "/api/stats/sse");
76
+ ctrl.abort();
77
+ expect(r.status).toBe(200);
78
+ expect(Object.keys(r.body.sessions).every((k) => k.split(":").includes(NET))).toBe(true);
79
+ expect(JSON.stringify(r.body)).not.toContain(OTHER_NET);
80
+ void sub;
81
+ });
82
+ test("POST /api/admin/users and agent-grants", async () => {
83
+ expect((await call(ntok, "POST", "/api/admin/users", { username: "ntok_made", password: PW })).status).toBe(403);
84
+ expect((await call(ntok, "GET", `/api/networks/${NET}/members/${adminId}/agent-grants`)).status).toBe(403);
85
+ });
86
+ });
87
+
88
+ describe("account and network management need a user token", () => {
89
+ test("token management: cannot list, mint user tokens, mint node tokens or revoke", async () => {
90
+ expect((await call(ntok, "GET", "/api/auth/tokens")).status).toBe(403);
91
+ const minted = await call(ntok, "POST", "/api/auth/tokens", { name: "escalate" });
92
+ expect(minted.status).toBe(403);
93
+ expect(minted.body.token).toBeUndefined();
94
+ expect((await call(ntok, "POST", "/api/auth/node-token", { network_id: OTHER_NET, node_name: "x" })).status).toBe(403);
95
+ expect((await call(ntok, "DELETE", "/api/auth/tokens/tok_whatever")).status).toBe(403);
96
+ expect((await call(adminToken, "GET", "/api/auth/tokens")).status).toBe(200);
97
+ });
98
+ test("cannot edit the owner's profile or password", async () => {
99
+ expect((await call(ntok, "PUT", "/api/auth/me", { display_name: "pwned" })).status).toBe(403);
100
+ expect(db.get<{ display_name: string }>("SELECT display_name FROM users WHERE user_id = ?1", adminId)?.display_name).not.toBe("pwned");
101
+ expect((await call(ntok, "POST", "/api/auth/password", { old_password: PW, new_password: "AnotherPassw0rd!" })).status).toBe(403);
102
+ });
103
+ test("cannot create, rename or delete networks", async () => {
104
+ expect((await call(ntok, "POST", "/api/networks", { name: "ntok-made" })).status).toBe(403);
105
+ expect((await call(ntok, "PUT", `/api/networks/${OTHER_NET}`, { name: "renamed" })).status).toBe(403);
106
+ expect((await call(ntok, "DELETE", `/api/networks/${OTHER_NET}`)).status).toBe(403);
107
+ expect(db.get("SELECT 1 FROM networks WHERE network_id = ?1", OTHER_NET)).toBeTruthy();
108
+ });
109
+ test("cannot manage members, invites or join", async () => {
110
+ expect((await call(ntok, "GET", `/api/networks/${NET}/members`)).status).toBe(403);
111
+ expect((await call(ntok, "POST", `/api/networks/${NET}/members`, { user_id: "u_x" })).status).toBe(403);
112
+ expect((await call(ntok, "POST", `/api/networks/${NET}/invite`, { role: "admin" })).status).toBe(403);
113
+ expect((await call(ntok, "POST", "/api/networks/join", { invite_code: "inv_x" })).status).toBe(403);
114
+ expect((await call(adminToken, "GET", `/api/networks/${NET}/members`)).status).toBe(200);
115
+ });
116
+ test("renames: a node token may only rename ITSELF in its bound network", async () => {
117
+ // 别的网络 / 别的节点 → user_token_required
118
+ expect((await call(ntok, "POST", "/api/node-rename/prepare", { network_id: OTHER_NET, old_alias: "ntok-node", new_alias: "b" })).status).toBe(403);
119
+ db.run(`INSERT INTO sessions (resume_id, alias, status, network_id) VALUES ('r_other_node', 'other-node', 'idle', ?1)`, [NET]);
120
+ expect((await call(ntok, "POST", "/api/node-rename/prepare", { network_id: NET, old_alias: "other-node", new_alias: "b" })).status).toBe(403);
121
+ // 另一个节点(管理员用户令牌)开的事务,本节点不能提交
122
+ const foreign = await call(adminToken, "POST", "/api/node-rename/prepare", { network_id: NET, old_alias: "other-node", new_alias: "other-node-2" });
123
+ expect(foreign.body.ok).toBe(true);
124
+ expect((await call(ntok, "POST", "/api/node-rename/commit", { txn_id: foreign.body.txn_id })).status).toBe(403);
125
+ expect((await call(adminToken, "POST", "/api/node-rename/abort", { txn_id: foreign.body.txn_id })).body.ok).toBe(true);
126
+ // 自己:照常(anet node rename 就是这么用的)
127
+ db.run(`INSERT INTO sessions (resume_id, alias, status, network_id) VALUES ('r_self_node', 'ntok-node', 'idle', ?1)`, [NET]);
128
+ const mine = await call(ntok, "POST", "/api/node-rename/prepare", { network_id: NET, old_alias: "ntok-node", new_alias: "ntok-node-2" });
129
+ expect(mine.body.ok).toBe(true);
130
+ expect((await call(ntok, "POST", "/api/node-rename/abort", { txn_id: mine.body.txn_id })).body.ok).toBe(true);
131
+ });
132
+ test("rename rejects line breaks, tabs and other control characters before reserving an alias", async () => {
133
+ for (const newAlias of ["hidden\nnode", "hidden\tnode", "hidden\u001fnode", "hidden\u007fnode", "hidden\u2028node", "hidden\u2029node"]) {
134
+ const r = await call(ntok, "POST", "/api/node-rename/prepare", { network_id: NET, old_alias: "ntok-node", new_alias: newAlias });
135
+ expect(r.status).toBe(400);
136
+ expect(r.body).toMatchObject({ ok: false, error: "node_alias_invalid", code: "node_alias_invalid", reason: "control_character" });
137
+ expect(r.body.message).toContain("control character U+");
138
+ }
139
+ expect(db.get<{ n: number }>("SELECT COUNT(*) AS n FROM rename_txn WHERE network_id = ?1 AND status = 'prepared'", NET)?.n).toBe(0);
140
+ });
141
+ });
142
+
143
+ describe("/api/auth/me says what the credential is", () => {
144
+ test("node token: owner user for compatibility, but credential.kind=node and only the bound network", async () => {
145
+ const r = await call(ntok, "GET", "/api/auth/me");
146
+ expect(r.status).toBe(200);
147
+ expect(r.body.credential).toMatchObject({ kind: "node", network_id: NET, node_alias: "ntok-node", acts_as_owner: false });
148
+ expect(r.body.current_network).toBe(NET);
149
+ expect(r.body.networks.map((n: any) => n.network_id)).toEqual([NET]);
150
+ const u = await call(adminToken, "GET", "/api/auth/me");
151
+ expect(u.body.credential).toEqual({ kind: "user" });
152
+ expect(u.body.networks.map((n: any) => n.network_id).sort()).toEqual([NET, OTHER_NET].sort());
153
+ });
154
+ test("node token keeps its own network powers (still a member): status and tasks read fine", async () => {
155
+ expect((await call(ntok, "GET", "/api/status")).status).toBe(200);
156
+ expect((await call(ntok, "GET", "/api/tasks")).status).toBe(200);
157
+ });
158
+ });
@@ -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 {}
@@ -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") || "").toContain("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
+ });