@sleep2agi/commhub-server 0.9.0-preview.21 → 0.9.0-preview.210

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 (397) hide show
  1. package/README.md +130 -10
  2. package/bin/commhub.ts +99 -11
  3. package/package.json +7 -7
  4. package/src/ack-create-request-transport.test.ts +182 -0
  5. package/src/ack-create-request.test.ts +50 -7
  6. package/src/admin-delete-network-http.test.ts +228 -0
  7. package/src/admin-networks-http.test.ts +88 -0
  8. package/src/adoption-candidates-http.test.ts +137 -0
  9. package/src/adoption-candidates.ts +158 -0
  10. package/src/agent-access-batch.test.ts +210 -0
  11. package/src/agent-access.ts +487 -0
  12. package/src/agent-acl-groups-http.test.ts +247 -0
  13. package/src/agent-acl-http.test.ts +659 -0
  14. package/src/agent-acl-slice3-http.test.ts +267 -0
  15. package/src/agent-department-http.test.ts +215 -0
  16. package/src/agent-groups-perf.test.ts +223 -0
  17. package/src/agent-notice.ts +48 -0
  18. package/src/agent-team-whoami-http.test.ts +98 -0
  19. package/src/agent-teams-http.test.ts +330 -0
  20. package/src/agent-teams.ts +244 -0
  21. package/src/alias-baseline-2571.test.ts +162 -0
  22. package/src/alias-baseline.ts +113 -0
  23. package/src/alias-filter.test.ts +72 -0
  24. package/src/alias-filter.ts +42 -0
  25. package/src/api-host-supervisors-can-create-nodes.test.ts +350 -0
  26. package/src/api-host-supervisors-fallback.test.ts +21 -12
  27. package/src/api-host-supervisors-runtime-readiness.test.ts +195 -0
  28. package/src/api-nodes-shape.test.ts +120 -13
  29. package/src/auth-password-change-cli-tokens-http.test.ts +423 -0
  30. package/src/auth-sessions-http.test.ts +250 -0
  31. package/src/auth-validate.test.ts +5 -1
  32. package/src/auth-weak-password-login.test.ts +176 -0
  33. package/src/auth.ts +609 -51
  34. package/src/avatar-validate.test.ts +163 -0
  35. package/src/avatar-validate.ts +103 -0
  36. package/src/backfill-node-ids-2664.test.ts +128 -0
  37. package/src/binding-generation-http.test.ts +121 -0
  38. package/src/blocked-exit-on-reply.test.ts +122 -0
  39. package/src/boot-side-effect.test.ts +124 -0
  40. package/src/broadcast-fanout-2721.test.ts +118 -0
  41. package/src/broadcast-fanout.ts +98 -0
  42. package/src/chain-attempt-dedup.test.ts +447 -0
  43. package/src/clone-node.test.ts +248 -0
  44. package/src/clone-node.ts +289 -0
  45. package/src/codex-config-flags.ts +77 -0
  46. package/src/codex-fork-contract.ts +23 -0
  47. package/src/codex-fork-migration.test.ts +38 -0
  48. package/src/commhub-bin-args.test.ts +85 -0
  49. package/src/config-apply-validate.test.ts +42 -1
  50. package/src/config-apply-validate.ts +30 -2
  51. package/src/create-node-blocked-gate.test.ts +356 -0
  52. package/src/create-node-network-id.test.ts +79 -0
  53. package/src/create-node-tool-schema.test.ts +49 -0
  54. package/src/create-node-unicode-name.test.ts +120 -0
  55. package/src/create-node-validate.test.ts +199 -7
  56. package/src/create-node-validate.ts +232 -15
  57. package/src/create-node-workdir.test.ts +289 -0
  58. package/src/create-node.ts +88 -23
  59. package/src/daemon-provider-snapshots.test.ts +421 -0
  60. package/src/daemon-provider-snapshots.ts +327 -0
  61. package/src/daemon-token-owner-http.test.ts +236 -0
  62. package/src/dashboard-slash-routing-http.test.ts +109 -0
  63. package/src/db-adapter-guard.test.ts +148 -0
  64. package/src/db-adapter-translate.test.ts +128 -0
  65. package/src/db-adapter.ts +377 -91
  66. package/src/db-timestamp.test.ts +38 -0
  67. package/src/db-timestamp.ts +15 -0
  68. package/src/db.ts +1306 -153
  69. package/src/delivered-without-push.test.ts +140 -0
  70. package/src/department-groups-http.test.ts +209 -0
  71. package/src/department-groups-sync-http.test.ts +328 -0
  72. package/src/department-groups.ts +434 -0
  73. package/src/department-heads-http.test.ts +330 -0
  74. package/src/department-heads.ts +226 -0
  75. package/src/departments-agent-count.test.ts +129 -0
  76. package/src/departments-http.test.ts +185 -0
  77. package/src/departments-mcp.test.ts +128 -0
  78. package/src/departments.ts +318 -0
  79. package/src/desktop-message-seam.test.ts +150 -0
  80. package/src/desktop-message.test.ts +368 -0
  81. package/src/dm-file-scope-http.test.ts +178 -0
  82. package/src/empty-node-sweeper.test.ts +104 -0
  83. package/src/empty-node-sweeper.ts +88 -0
  84. package/src/env-transport-gate-http.test.ts +240 -0
  85. package/src/env-transport-gate.ts +80 -0
  86. package/src/env-transport-policy.ts +56 -0
  87. package/src/event-loop-lag.test.ts +180 -0
  88. package/src/event-loop-lag.ts +181 -0
  89. package/src/ext-token-shared.test.ts +60 -0
  90. package/src/ext-validation-regression.test.ts +131 -0
  91. package/src/external-schedule-edits-http.test.ts +321 -0
  92. package/src/external-schedule-edits-timestamps.test.ts +64 -0
  93. package/src/external-schedule-edits.ts +327 -0
  94. package/src/file-download-authz-dev-open.test.ts +135 -0
  95. package/src/file-download-authz.test.ts +404 -0
  96. package/src/file-download-date-bucket.test.ts +436 -0
  97. package/src/file-network-scope-dev-open.test.ts +97 -0
  98. package/src/file-network-scope.test.ts +732 -0
  99. package/src/group-membership-events-http.test.ts +264 -0
  100. package/src/group-messages-http.test.ts +482 -0
  101. package/src/group-messages.ts +297 -0
  102. package/src/health-host-disk-2756.test.ts +49 -0
  103. package/src/health-redaction.test.ts +685 -0
  104. package/src/host-supervisor-identity-http.test.ts +152 -0
  105. package/src/host-supervisor-identity.ts +92 -0
  106. package/src/host-supervisors-daemon-version.test.ts +137 -0
  107. package/src/http-gzip.test.ts +94 -0
  108. package/src/http-gzip.ts +112 -0
  109. package/src/hub-catalog-read-http.test.ts +187 -0
  110. package/src/hub-provider-config.test.ts +139 -0
  111. package/src/hub-provider-config.ts +105 -0
  112. package/src/hub-timestamp.test.ts +38 -0
  113. package/src/hub-timestamp.ts +27 -0
  114. package/src/human-dm.ts +215 -0
  115. package/src/human-inbox.ts +42 -0
  116. package/src/inbox-caller.ts +49 -0
  117. package/src/inbox-count-sse.test.ts +310 -0
  118. package/src/inbox-count.ts +29 -0
  119. package/src/index.ts +15 -2385
  120. package/src/list-host-supervisors.test.ts +5 -4
  121. package/src/mcp-context-cost-http.test.ts +127 -0
  122. package/src/mcp-inflight.test.ts +92 -0
  123. package/src/mcp-inflight.ts +38 -0
  124. package/src/mcp-projects-events-http.test.ts +162 -0
  125. package/src/mcp-route-label-http.test.ts +120 -0
  126. package/src/mcp-write-network-resolution.test.ts +432 -0
  127. package/src/member-audit-network-id-http.test.ts +93 -0
  128. package/src/member-presence-http.test.ts +210 -0
  129. package/src/messages-ack-by-agent-http.test.ts +142 -0
  130. package/src/migrate-sqlite-to-pg.test.ts +47 -0
  131. package/src/migrate-sqlite-to-pg.ts +263 -0
  132. package/src/model-auth-notify-http.test.ts +181 -0
  133. package/src/model-auth-notify.ts +116 -0
  134. package/src/network-name-http.test.ts +75 -0
  135. package/src/network-rules-http.test.ts +169 -0
  136. package/src/network-rules.ts +129 -0
  137. package/src/network-scope.ts +276 -0
  138. package/src/network-token-membership-http.test.ts +139 -0
  139. package/src/node-alias-control.ts +12 -0
  140. package/src/node-attrs-validate.ts +88 -0
  141. package/src/node-attrs.test.ts +258 -0
  142. package/src/node-caller-identity-http.test.ts +1083 -0
  143. package/src/node-create-request-status-http.test.ts +105 -0
  144. package/src/node-daemon-bindings.test.ts +132 -0
  145. package/src/node-daemon-bindings.ts +135 -0
  146. package/src/node-failure-alert.test.ts +150 -0
  147. package/src/node-failure-alert.ts +177 -0
  148. package/src/node-files-transport.test.ts +344 -0
  149. package/src/node-health-codex-login.test.ts +120 -0
  150. package/src/node-health-dispatch-http.test.ts +279 -0
  151. package/src/node-health-guard.ts +105 -0
  152. package/src/node-health-passthrough.test.ts +115 -0
  153. package/src/node-health-store.ts +101 -0
  154. package/src/node-id-alias.test.ts +190 -0
  155. package/src/node-identity-conflict-http.test.ts +269 -0
  156. package/src/node-identity-conflict.ts +142 -0
  157. package/src/node-identity-mismatch.test.ts +74 -0
  158. package/src/node-in-flight-tasks.ts +31 -0
  159. package/src/node-lifecycle-controllable.test.ts +64 -0
  160. package/src/node-lifecycle-controllable.ts +53 -0
  161. package/src/node-lifecycle-read-http.test.ts +250 -0
  162. package/src/node-lifecycle-read.ts +124 -0
  163. package/src/node-logs-transport.test.ts +263 -0
  164. package/src/node-peer-allowlist.test.ts +114 -0
  165. package/src/node-permissions-http.test.ts +648 -0
  166. package/src/node-permissions.ts +494 -0
  167. package/src/node-request-retention.test.ts +281 -0
  168. package/src/node-request-retention.ts +120 -0
  169. package/src/node-secret-rest-http.test.ts +190 -0
  170. package/src/node-serviceability.test.ts +86 -0
  171. package/src/node-serviceability.ts +124 -0
  172. package/src/node-session-control-http.test.ts +310 -0
  173. package/src/node-session-control.ts +258 -0
  174. package/src/node-skills-transport.test.ts +209 -0
  175. package/src/node-token-identity.ts +35 -0
  176. package/src/node-token-ownership.ts +51 -0
  177. package/src/node-token-privilege-http.test.ts +158 -0
  178. package/src/not-found-api-http.test.ts +67 -0
  179. package/src/observer-avatar-http.test.ts +442 -0
  180. package/src/observer-push.test.ts +252 -0
  181. package/src/opencode-catalog-report-http.test.ts +139 -0
  182. package/src/opencode-v2-catalog.test.ts +268 -0
  183. package/src/opencode-v2-catalog.ts +352 -0
  184. package/src/package-version-consistency.test.ts +25 -0
  185. package/src/parent-source-marker.test.ts +50 -0
  186. package/src/password-network-tokens.ts +25 -0
  187. package/src/peer-reply-atomic.test.ts +455 -0
  188. package/src/peer-reply-capability.test.ts +70 -0
  189. package/src/pg-worker.ts +87 -0
  190. package/src/project-dir-warn-clear-http.test.ts +132 -0
  191. package/src/project-viewer-can-http.test.ts +116 -0
  192. package/src/push.test.ts +20 -10
  193. package/src/push.ts +466 -13
  194. package/src/redact-tokens.test.ts +65 -0
  195. package/src/redact-tokens.ts +40 -0
  196. package/src/rename.ts +38 -10
  197. package/src/reply-target-derivation.test.ts +96 -0
  198. package/src/report-status-handover-capabilities-http.test.ts +124 -0
  199. package/src/report-status-host-schema.test.ts +235 -0
  200. package/src/report-status-resume-id-handover.test.ts +184 -0
  201. package/src/report-status-secret-keys.test.ts +140 -0
  202. package/src/require-explicit-test-db.ts +9 -0
  203. package/src/requirement-due-reminders-http.test.ts +620 -0
  204. package/src/requirement-due-reminders.ts +416 -0
  205. package/src/requirement-events-http.test.ts +268 -0
  206. package/src/requirement-events.test.ts +45 -0
  207. package/src/requirement-events.ts +144 -0
  208. package/src/requirement-notify.ts +165 -0
  209. package/src/requirement-participant-notify-http.test.ts +309 -0
  210. package/src/requirement-tag-ops-http.test.ts +425 -0
  211. package/src/requirement-tag-tree-http.test.ts +275 -0
  212. package/src/requirement-tag-tree.ts +127 -0
  213. package/src/requirement-tags.ts +102 -0
  214. package/src/requirements-abandoned-http.test.ts +236 -0
  215. package/src/requirements-comment-http.test.ts +167 -0
  216. package/src/requirements-completed-at-migration.test.ts +70 -0
  217. package/src/requirements-errors-mcp-http.test.ts +164 -0
  218. package/src/requirements-errors.ts +158 -0
  219. package/src/requirements-etag-http.test.ts +91 -0
  220. package/src/requirements-http.test.ts +709 -0
  221. package/src/requirements-last-event-http.test.ts +349 -0
  222. package/src/requirements-list-mcp-slim-http.test.ts +155 -0
  223. package/src/requirements-list-slim-http.test.ts +324 -0
  224. package/src/requirements-mcp.test.ts +163 -0
  225. package/src/requirements-migrate.ts +283 -0
  226. package/src/requirements-owner-strict-mcp-http.test.ts +145 -0
  227. package/src/requirements-people-http.test.ts +114 -0
  228. package/src/requirements-people-mcp-http.test.ts +231 -0
  229. package/src/requirements-people.ts +196 -0
  230. package/src/requirements-priority-lowest.test.ts +114 -0
  231. package/src/requirements-projects-parent-http.test.ts +123 -0
  232. package/src/requirements-search-http.test.ts +182 -0
  233. package/src/requirements-search.test.ts +32 -0
  234. package/src/requirements-search.ts +145 -0
  235. package/src/requirements-seq-http.test.ts +193 -0
  236. package/src/requirements-seq-migration.test.ts +63 -0
  237. package/src/requirements-start-date.test.ts +125 -0
  238. package/src/requirements-stats-http.test.ts +357 -0
  239. package/src/requirements-stats.ts +195 -0
  240. package/src/requirements-status-participants-http.test.ts +222 -0
  241. package/src/requirements-upgrade-e2e.test.ts +126 -0
  242. package/src/requirements-upgrade-migration.test.ts +98 -0
  243. package/src/requirements.ts +2027 -0
  244. package/src/resolve-port.test.ts +57 -0
  245. package/src/resolve-port.ts +44 -0
  246. package/src/response-charset.test.ts +130 -0
  247. package/src/rest-alias-network-fallback-http.test.ts +123 -0
  248. package/src/rest-alias-network-fallback.test.ts +60 -0
  249. package/src/rest-alias-network-fallback.ts +65 -0
  250. package/src/rest-explicit-columns-http.test.ts +266 -0
  251. package/src/rest-identity.test.ts +130 -0
  252. package/src/rest-identity.ts +141 -0
  253. package/src/rest-projections.ts +72 -0
  254. package/src/rest-read-network-real-chain.test.ts +97 -0
  255. package/src/rest-write-network-resolution.test.ts +133 -0
  256. package/src/restart-readiness-http.test.ts +121 -0
  257. package/src/restricted-files.ts +76 -0
  258. package/src/retention-first-sweep-quiet.test.ts +31 -0
  259. package/src/retention.test.ts +100 -40
  260. package/src/retention.ts +423 -104
  261. package/src/route-callers-http.test.ts +120 -0
  262. package/src/route-timing.test.ts +211 -0
  263. package/src/route-timing.ts +262 -0
  264. package/src/rules-file-duplicate-alias.test.ts +234 -0
  265. package/src/rules-file-session-target.test.ts +207 -0
  266. package/src/rules-file-transport.test.ts +237 -0
  267. package/src/runtime-label.test.ts +22 -0
  268. package/src/runtime-label.ts +21 -0
  269. package/src/runtime-readiness.ts +90 -0
  270. package/src/schedule-agent-mcp-http.test.ts +391 -0
  271. package/src/schedule-agent.ts +192 -0
  272. package/src/schedule-starved.test.ts +92 -0
  273. package/src/schedule-starved.ts +114 -0
  274. package/src/scheduled-backoff-http.test.ts +193 -0
  275. package/src/scheduled-backoff.ts +64 -0
  276. package/src/scheduled-doorbell-nodeless-session.test.ts +134 -0
  277. package/src/scheduled-failure-backoff-2622.test.ts +145 -0
  278. package/src/scheduled-failure-code.test.ts +73 -0
  279. package/src/scheduled-failure-code.ts +105 -0
  280. package/src/scheduled-failures-http.test.ts +279 -0
  281. package/src/scheduled-failures.ts +377 -0
  282. package/src/scheduled-noprogress-backoff-2622.test.ts +133 -0
  283. package/src/scheduled-offline-backoff-probe.test.ts +56 -0
  284. package/src/scheduled-offline.test.ts +131 -0
  285. package/src/scheduled-offline.ts +66 -0
  286. package/src/scheduled-outcome-guidance-http.test.ts +139 -0
  287. package/src/scheduled-outcome-guidance.ts +9 -0
  288. package/src/scheduled-reply-unread-http.test.ts +212 -0
  289. package/src/scheduled-requirement-wake-http.test.ts +279 -0
  290. package/src/scheduled-requirement-wake.ts +125 -0
  291. package/src/scheduled-run-terminal.test.ts +268 -0
  292. package/src/scheduled-skip-blocking-task.test.ts +120 -0
  293. package/src/scheduled-skip-path-backoff-2622.test.ts +98 -0
  294. package/src/scheduled-stuck-http.test.ts +312 -0
  295. package/src/scheduled-stuck-notice-cap.test.ts +80 -0
  296. package/src/scheduled-stuck.ts +219 -0
  297. package/src/scheduled-tasks-http.test.ts +679 -0
  298. package/src/scheduled-tasks.ts +959 -0
  299. package/src/scheduled-work-outcome-http.test.ts +154 -0
  300. package/src/scheduled-work-outcome.ts +50 -0
  301. package/src/scoped-secrets.ts +141 -0
  302. package/src/send-dedup-request-id.test.ts +229 -0
  303. package/src/send-reply-agent-warning.test.ts +202 -0
  304. package/src/send-reply-alias-optional.test.ts +131 -0
  305. package/src/send-reply-attachments.test.ts +458 -0
  306. package/src/send_dedup.test.ts +54 -0
  307. package/src/send_dedup.ts +52 -6
  308. package/src/serve-error.test.ts +38 -0
  309. package/src/serve-error.ts +27 -0
  310. package/src/server.ts +6220 -0
  311. package/src/session-task-on-dispatch.ts +14 -0
  312. package/src/session-token-ownership-http.test.ts +122 -0
  313. package/src/shared/codex-inventory.ts +41 -0
  314. package/src/shared/daemon-provider-login.ts +31 -0
  315. package/src/shared/daemon-provider-snapshot.ts +52 -0
  316. package/src/shared/external-schedule-contract.ts +60 -0
  317. package/src/shared/node-name.test.ts +62 -0
  318. package/src/shared/node-name.ts +161 -0
  319. package/src/shared/provider-application.ts +29 -0
  320. package/src/shared/provider-collection.ts +14 -0
  321. package/src/shared/provider-initialization.ts +8 -0
  322. package/src/shared/reserved-env-drift.test.ts +10 -0
  323. package/src/shared/scoped-secret-contract.ts +5 -0
  324. package/src/shared/task-content-limit-drift.test.ts +28 -0
  325. package/src/shared/task-content-limit.ts +25 -0
  326. package/src/side-thread-command-transport.test.ts +312 -0
  327. package/src/side-thread-command-transport.ts +318 -0
  328. package/src/side-thread-http-integration.test.ts +233 -0
  329. package/src/side-thread-http.ts +504 -0
  330. package/src/side-thread-production.test.ts +72 -0
  331. package/src/side-thread-production.ts +118 -0
  332. package/src/side-thread.test.ts +1067 -0
  333. package/src/side-thread.ts +2499 -0
  334. package/src/skillhub-http.test.ts +108 -0
  335. package/src/sqlite-close-checkpoint.test.ts +78 -0
  336. package/src/start-node.test.ts +264 -0
  337. package/src/status-alias-filter-http.test.ts +106 -0
  338. package/src/status-alias-resolver-http.test.ts +163 -0
  339. package/src/status-alias-resolver.ts +19 -0
  340. package/src/status-node-id-filter-http.test.ts +161 -0
  341. package/src/status-read-cache-http.test.ts +229 -0
  342. package/src/status-read-cache.ts +122 -0
  343. package/src/stop-delete-node.test.ts +567 -1
  344. package/src/task-access-http.test.ts +402 -0
  345. package/src/task-access.ts +420 -0
  346. package/src/task-activity.ts +60 -0
  347. package/src/task-auth-origin-http.test.ts +93 -0
  348. package/src/task-auth-origin.test.ts +24 -0
  349. package/src/task-auth-origin.ts +7 -0
  350. package/src/task-consumption.test.ts +482 -0
  351. package/src/task-diagnostic-http.test.ts +149 -0
  352. package/src/task-diagnostic.test.ts +115 -0
  353. package/src/task-diagnostic.ts +118 -0
  354. package/src/task-expiry-notice-http.test.ts +287 -0
  355. package/src/task-expiry-notice.ts +315 -0
  356. package/src/task-idempotency-mcp.test.ts +142 -0
  357. package/src/task-idempotency.test.ts +76 -0
  358. package/src/task-idempotency.ts +81 -0
  359. package/src/task-late-replies.ts +54 -0
  360. package/src/task-late-reply-http.test.ts +152 -0
  361. package/src/task-lifecycle-watcher-busy.test.ts +114 -0
  362. package/src/task-lifecycle-watcher.test.ts +204 -0
  363. package/src/task-lifecycle-watcher.ts +109 -0
  364. package/src/task-network-resolution-http.test.ts +140 -0
  365. package/src/task-offline-delivery-2668.test.ts +119 -0
  366. package/src/task-offline-delivery.ts +81 -0
  367. package/src/task-orphan-http.test.ts +287 -0
  368. package/src/task-orphan.ts +119 -0
  369. package/src/task-queue-ahead-http.test.ts +309 -0
  370. package/src/task-queue-ahead-scale.test.ts +236 -0
  371. package/src/task-queue-ahead.ts +186 -0
  372. package/src/task-rejection-log-http.test.ts +160 -0
  373. package/src/task-rejection-log.ts +49 -0
  374. package/src/task-sender-http.test.ts +143 -0
  375. package/src/task-stale-open-http.test.ts +290 -0
  376. package/src/task-stale-open.ts +103 -0
  377. package/src/tasks-pagination-http.test.ts +141 -0
  378. package/src/team-rules-status-http.test.ts +90 -0
  379. package/src/team-rules-status.test.ts +59 -0
  380. package/src/team-rules-status.ts +72 -0
  381. package/src/tool-audience-http.test.ts +230 -0
  382. package/src/tool-audience.ts +120 -0
  383. package/src/tools-list-json-schema.test.ts +94 -0
  384. package/src/tools.ts +4119 -391
  385. package/src/upload-early-reject-guard.test.ts +155 -0
  386. package/src/uploads-http.test.ts +97 -15
  387. package/src/uploads.ts +103 -6
  388. package/src/user-avatar-http.test.ts +74 -0
  389. package/src/user-avatar-image.ts +160 -0
  390. package/src/user-avatar-migration.test.ts +25 -0
  391. package/src/user-avatar-upload-http.test.ts +348 -0
  392. package/src/user-inbox-by-agent-http.test.ts +161 -0
  393. package/src/user-inbox-netid-notnull.test.ts +122 -0
  394. package/src/user-inbox-read-http.test.ts +223 -0
  395. package/src/user-inbox-schema.test.ts +54 -0
  396. package/src/version-stats.test.ts +66 -0
  397. package/src/version-stats.ts +109 -0
@@ -0,0 +1,252 @@
1
+ // #461 — unit tests for the network observer SSE channel (push.ts).
2
+ //
3
+ // These tests read REAL bytes off the observer stream, so they are a
4
+ // live gate: stub pushNetworkObserverEvent out to a no-op and every
5
+ // "receives …" test below times out red. (Per 通信龙 2026-07-28 rule:
6
+ // a test that stays green when the core function is emptied is a fake
7
+ // gate.)
8
+
9
+ import { afterEach, describe, expect, test } from "bun:test";
10
+ import {
11
+ __resetSSEClientsForTest,
12
+ createNetworkObserverStream,
13
+ createSSEStream,
14
+ createUserEventStream,
15
+ pushEvent,
16
+ pushNetworkObserverEvent,
17
+ pushUserEvent,
18
+ } from "./push";
19
+
20
+ afterEach(() => {
21
+ __resetSSEClientsForTest();
22
+ });
23
+
24
+ type Frame = Record<string, any>;
25
+
26
+ /** Read the next SSE data frame (skipping keepalive comments), with a
27
+ * hard timeout so a silent stream fails the test instead of hanging. */
28
+ async function readFrame(
29
+ reader: ReadableStreamDefaultReader<Uint8Array>,
30
+ timeoutMs = 2_000,
31
+ ): Promise<Frame> {
32
+ const decoder = new TextDecoder();
33
+ let buf = "";
34
+ const deadline = Date.now() + timeoutMs;
35
+ while (Date.now() < deadline) {
36
+ const remaining = deadline - Date.now();
37
+ const result = await Promise.race([
38
+ reader.read(),
39
+ new Promise<never>((_, rej) =>
40
+ setTimeout(() => rej(new Error(`no SSE frame within ${timeoutMs}ms`)), remaining),
41
+ ),
42
+ ]);
43
+ if (result.done) throw new Error("stream ended before a data frame arrived");
44
+ buf += decoder.decode(result.value, { stream: true });
45
+ const sep = buf.indexOf("\n\n");
46
+ if (sep === -1) continue;
47
+ const rawFrame = buf.slice(0, sep);
48
+ buf = buf.slice(sep + 2);
49
+ const dataLine = rawFrame.split("\n").find((l) => l.startsWith("data: "));
50
+ if (!dataLine) continue; // keepalive comment frame — keep reading
51
+ return JSON.parse(dataLine.slice(6));
52
+ }
53
+ throw new Error(`no SSE frame within ${timeoutMs}ms`);
54
+ }
55
+
56
+ describe("#461 network observer stream", () => {
57
+ test("observer receives connected frame, then new_task summary with metadata only", async () => {
58
+ const res = createNetworkObserverStream("net_obs_a");
59
+ const reader = res.body!.getReader();
60
+
61
+ const connected = await readFrame(reader);
62
+ expect(connected.type).toBe("connected");
63
+ expect(connected.observer).toBe(true);
64
+ expect(connected.network_id).toBe("net_obs_a");
65
+
66
+ pushNetworkObserverEvent("net_obs_a", {
67
+ type: "new_task",
68
+ task_id: "task-123",
69
+ from: "sender-agent",
70
+ to: "receiver-agent",
71
+ status: "delivered",
72
+ priority: "high",
73
+ });
74
+
75
+ const evt = await readFrame(reader);
76
+ expect(evt.type).toBe("new_task");
77
+ expect(evt.task_id).toBe("task-123");
78
+ expect(evt.from).toBe("sender-agent");
79
+ expect(evt.to).toBe("receiver-agent");
80
+ expect(evt.status).toBe("delivered");
81
+ expect(evt.priority).toBe("high");
82
+ expect(evt.network_id).toBe("net_obs_a");
83
+ expect(evt.scope).toBe("network");
84
+ // Summary contract: NO content field, ever.
85
+ expect("content" in evt).toBe(false);
86
+ expect("task" in evt).toBe(false);
87
+ await reader.cancel();
88
+ });
89
+
90
+ test("observer receives new_reply summary", async () => {
91
+ const res = createNetworkObserverStream("net_obs_reply");
92
+ const reader = res.body!.getReader();
93
+ await readFrame(reader); // connected
94
+
95
+ pushNetworkObserverEvent("net_obs_reply", {
96
+ type: "new_reply",
97
+ task_id: "parent-task",
98
+ message_id: "msg-9",
99
+ from: "worker",
100
+ to: "boss",
101
+ status: "completed",
102
+ });
103
+
104
+ const evt = await readFrame(reader);
105
+ expect(evt.type).toBe("new_reply");
106
+ expect(evt.task_id).toBe("parent-task");
107
+ expect(evt.message_id).toBe("msg-9");
108
+ expect(evt.status).toBe("completed");
109
+ expect("content" in evt).toBe(false);
110
+ expect("text" in evt).toBe(false);
111
+ await reader.cancel();
112
+ });
113
+
114
+ test("events are network-isolated: observer on net B never sees net A traffic", async () => {
115
+ const resB = createNetworkObserverStream("net_obs_b");
116
+ const readerB = resB.body!.getReader();
117
+ await readFrame(readerB); // connected
118
+
119
+ // Push to A first, then a marker to B. Delivery per key is
120
+ // synchronous and ordered, so if B's next frame is the marker,
121
+ // the A event provably never reached B.
122
+ pushNetworkObserverEvent("net_obs_a2", { type: "new_task", task_id: "leaked" });
123
+ pushNetworkObserverEvent("net_obs_b", { type: "new_task", task_id: "marker-b" });
124
+
125
+ const evt = await readFrame(readerB);
126
+ expect(evt.task_id).toBe("marker-b");
127
+ await readerB.cancel();
128
+ });
129
+
130
+ test("observer stream is isolated from session channels (both directions)", async () => {
131
+ const sessionRes = createSSEStream("agent-x", "net_obs_c");
132
+ const sessionReader = sessionRes.body!.getReader();
133
+ await readFrame(sessionReader); // connected
134
+
135
+ const obsRes = createNetworkObserverStream("net_obs_c");
136
+ const obsReader = obsRes.body!.getReader();
137
+ await readFrame(obsReader); // connected
138
+
139
+ // Session push must NOT hit the observer; observer push must NOT
140
+ // hit the session. Marker technique as above.
141
+ pushEvent("agent-x", { type: "new_task", inbox_count: 1, marker: "to-session" }, "net_obs_c");
142
+ pushNetworkObserverEvent("net_obs_c", { type: "new_task", task_id: "to-observer" });
143
+
144
+ const sessionEvt = await readFrame(sessionReader);
145
+ expect(sessionEvt.marker).toBe("to-session");
146
+ expect("task_id" in sessionEvt).toBe(false);
147
+
148
+ const obsEvt = await readFrame(obsReader);
149
+ expect(obsEvt.task_id).toBe("to-observer");
150
+ expect("marker" in obsEvt).toBe(false);
151
+
152
+ await sessionReader.cancel();
153
+ await obsReader.cancel();
154
+ });
155
+
156
+ test("null / undefined networkId is a silent no-op", () => {
157
+ // Must not throw — legacy null-network traffic has no observer
158
+ // stream by design (documented in #461 / the PR).
159
+ expect(() => pushNetworkObserverEvent(null, { type: "new_task" })).not.toThrow();
160
+ expect(() => pushNetworkObserverEvent(undefined, { type: "new_task" })).not.toThrow();
161
+ });
162
+
163
+ test("multiple observers on the same network all receive the event", async () => {
164
+ const r1 = createNetworkObserverStream("net_obs_multi");
165
+ const r2 = createNetworkObserverStream("net_obs_multi");
166
+ const reader1 = r1.body!.getReader();
167
+ const reader2 = r2.body!.getReader();
168
+ await readFrame(reader1);
169
+ await readFrame(reader2);
170
+
171
+ pushNetworkObserverEvent("net_obs_multi", { type: "new_task", task_id: "fanout" });
172
+
173
+ expect((await readFrame(reader1)).task_id).toBe("fanout");
174
+ expect((await readFrame(reader2)).task_id).toBe("fanout");
175
+ await reader1.cancel();
176
+ await reader2.cancel();
177
+ });
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
+ });
@@ -0,0 +1,268 @@
1
+ import { afterAll, beforeEach, describe, expect, test } from "bun:test";
2
+ import "./require-explicit-test-db.js";
3
+ import { mkdtempSync, rmSync } from "node:fs";
4
+ import { tmpdir } from "node:os";
5
+ import { join, resolve } from "node:path";
6
+ import { McpServer } from "@modelcontextprotocol/sdk/server/mcp.js";
7
+ import { db } from "./db.js";
8
+ import { registerTools } from "./tools.js";
9
+ import {
10
+ ackOpenCodeCatalog,
11
+ expireOpenCodeCatalogForTest,
12
+ getOpenCodeCatalogResult,
13
+ queueOpenCodeCatalogRead,
14
+ resetOpenCodeCatalogForTest,
15
+ takeOpenCodeCatalogRequest,
16
+ } from "./opencode-v2-catalog.js";
17
+ import { readOwnedOpenCodeV2Catalog } from "../../agent-node/src/runtime/opencode-v2-catalog-daemon.ts";
18
+ import { readOpenCodeV2CatalogEndpoint, writeOpenCodeV2CatalogEndpoint } from "../../agent-node/src/runtime/opencode-v2-catalog-endpoint.ts";
19
+
20
+ const NET = "net_oc_catalog";
21
+ const OTHER = "net_oc_catalog_other";
22
+ const USER = "u_oc_catalog";
23
+ const VIEWER = "u_oc_catalog_viewer";
24
+ const OUTSIDER = "u_oc_catalog_out";
25
+ const DAEMON = "node_oc_daemon";
26
+ const DAEMON_ALIAS = "oc-daemon";
27
+ const DAEMON_TOK = "tok_oc_daemon";
28
+ const V2_REQ = "cr_ocv2child";
29
+ const V2 = "node_ocv2child";
30
+ const V1 = "node_ocv1child";
31
+ const UNSAFE = "node_ocunsafechild";
32
+ const NULLDIR = "node_ocnullchild";
33
+ const PROJECT = resolve(mkdtempSync(join(tmpdir(), "oc-hub-proj-")));
34
+
35
+ function cleanup() {
36
+ resetOpenCodeCatalogForTest();
37
+ for (const net of [NET, OTHER]) {
38
+ for (const table of ["node_create_requests", "audit_log", "nodes", "sessions", "api_tokens", "network_members"]) {
39
+ try { db.run(`DELETE FROM ${table} WHERE network_id = ?1`, [net]); } catch {}
40
+ }
41
+ try { db.run("DELETE FROM networks WHERE network_id = ?1", [net]); } catch {}
42
+ }
43
+ for (const user of [USER, VIEWER, OUTSIDER]) {
44
+ try { db.run("DELETE FROM users WHERE user_id = ?1", [user]); } catch {}
45
+ }
46
+ }
47
+ beforeEach(cleanup);
48
+ afterAll(() => { cleanup(); rmSync(PROJECT, { recursive: true, force: true }); });
49
+
50
+ function userRow(id: string) {
51
+ db.run(`INSERT INTO users (user_id, username, password_hash, role, created_at) VALUES (?1, ?1, 'x', 'user', datetime('now'))`, [id]);
52
+ }
53
+ function member(id: string, net: string, role: string) {
54
+ db.run(`INSERT INTO network_members (user_id, network_id, role, joined_at) VALUES (?1, ?2, ?3, datetime('now'))`, [id, net, role]);
55
+ }
56
+ function node(id: string, alias: string, snapshot: unknown) {
57
+ db.run(
58
+ `INSERT INTO nodes (node_id, node_name, alias, network_id, config_snapshot, hostname, created_at, updated_at, lifecycle_state)
59
+ VALUES (?1, ?2, ?2, ?3, ?4, 'host-x', datetime('now'), datetime('now'), 'active')`,
60
+ [id, alias, NET, JSON.stringify(snapshot)],
61
+ );
62
+ }
63
+ function created(requestId: string, nodeId: string, flags: unknown, workdir: string | null) {
64
+ node(nodeId, nodeId, {});
65
+ db.run(
66
+ `INSERT INTO node_create_requests
67
+ (request_id, daemon_node_id, child_name, network_id, runtime, model, flags_json, env_keys, status, created_at, created_by_token, workdir)
68
+ VALUES (?1, ?2, ?3, ?4, 'opencode-cli', 'fixture/fixture-model', ?5, '[]', 'succeeded', ?6, 'tok', ?7)`,
69
+ [requestId, DAEMON, nodeId, NET, JSON.stringify(flags), Date.now(), workdir],
70
+ );
71
+ }
72
+
73
+ function seed() {
74
+ userRow(USER); userRow(VIEWER); userRow(OUTSIDER);
75
+ db.run(`INSERT OR REPLACE INTO networks (network_id, network_name, owner_id, created_at) VALUES (?1, ?1, ?2, datetime('now'))`, [NET, USER]);
76
+ db.run(`INSERT OR REPLACE INTO networks (network_id, network_name, owner_id, created_at) VALUES (?1, ?1, ?2, datetime('now'))`, [OTHER, OUTSIDER]);
77
+ member(USER, NET, "admin");
78
+ member(VIEWER, NET, "viewer");
79
+ member(OUTSIDER, OTHER, "admin");
80
+ node(DAEMON, DAEMON_ALIAS, { role: "host_supervisor" });
81
+ db.run(
82
+ `INSERT INTO api_tokens (token_id, user_id, network_id, scope, name, token_hash, expires_at, revoked_at)
83
+ VALUES (?1, ?2, ?3, 'network', ?4, ?5, NULL, NULL)`,
84
+ [DAEMON_TOK, USER, NET, `node:${DAEMON_ALIAS}`, `hash_${DAEMON_TOK}`],
85
+ );
86
+ created(V2_REQ, V2, { opencodeGeneration: "v2", opencodeUnsafeTools: true }, PROJECT);
87
+ created("cr_ocv1child", V1, { opencodeGeneration: "v1" }, PROJECT);
88
+ created("cr_ocunsafechild", UNSAFE, { opencodeGeneration: "v2", opencodeUnsafeTools: false }, PROJECT);
89
+ created("cr_ocnullchild", NULLDIR, { opencodeGeneration: "v2", opencodeUnsafeTools: true }, null);
90
+ }
91
+
92
+ function queue(userId: string, nodeId: string, networkId: string | null = NET, callerIsNode = false) {
93
+ return queueOpenCodeCatalogRead({ callerUserId: userId, callerIsNode, networkId, daemonNodeId: DAEMON, nodeId });
94
+ }
95
+
96
+ function handlers(userId: string, isNode: boolean, tokenId: string | null) {
97
+ const server = new McpServer({ name: "oc-catalog-test", version: "0" }) as any;
98
+ const out: Record<string, (args: any) => Promise<{ content: Array<{ text: string }> }>> = {};
99
+ const origTool = server.tool.bind(server);
100
+ server.tool = (name: string, d: string, schema: any, handler: any) => { out[name] = handler; return origTool(name, d, schema, handler); };
101
+ const origRegister = server.registerTool.bind(server);
102
+ server.registerTool = (name: string, cfg: any, handler: any) => { out[name] = handler; return origRegister(name, cfg, handler); };
103
+ registerTools(server, undefined, NET, userId, isNode ? DAEMON_ALIAS : null, isNode, tokenId);
104
+ return { out, server };
105
+ }
106
+ async function call(handler: (args: any) => Promise<{ content: Array<{ text: string }> }>, args: any) {
107
+ return JSON.parse((await handler(args)).content[0]!.text);
108
+ }
109
+
110
+ function snapshot(directory = PROJECT, overrides: Record<string, unknown> = {}) {
111
+ return {
112
+ scope: { networkId: NET, daemonId: DAEMON, directory },
113
+ source: "opencode-v2-api",
114
+ state: "snapshot",
115
+ invocationVerified: false,
116
+ completeness: "unknown",
117
+ observedAt: "2026-10-11T00:00:00.000Z",
118
+ providers: [{ id: "custom", activation: "enabled" }],
119
+ models: [{ providerId: "custom", id: "nested/model" }],
120
+ defaultModel: { providerId: "custom", id: "nested/model" },
121
+ ...overrides,
122
+ };
123
+ }
124
+
125
+ describe("hub authorizes an owned OpenCode V2 catalog read", () => {
126
+ test("member queues, daemon reads the owned loopback, ready snapshot stays unverified", async () => {
127
+ seed();
128
+ const user = handlers(USER, false, null);
129
+ const queued = await call(user.out.read_opencode_catalog!, { daemon_node_id: DAEMON, node_id: V2 });
130
+ expect(queued).toEqual({ ok: true, status: "pending", request_id: queued.request_id });
131
+ expect(JSON.stringify(queued)).not.toContain("daemon_alias");
132
+ const strict = await (user.server as any)._registeredTools.read_opencode_catalog.inputSchema.safeParseAsync({
133
+ daemon_node_id: DAEMON, node_id: V2, settings: { apiKey: "sk-FAKE" }, headers: {}, body: {},
134
+ });
135
+ expect(strict.success).toBe(false);
136
+
137
+ expect(takeOpenCodeCatalogRequest(queued.request_id, "node_other")).toEqual({ ok: false, error: "catalog_request_unavailable" });
138
+ const daemon = handlers(USER, true, DAEMON_TOK);
139
+ const pulled = await call(daemon.out.get_opencode_catalog_request!, { request_id: queued.request_id });
140
+ expect(pulled.ok).toBe(true);
141
+ expect(pulled.directory).toBe(PROJECT);
142
+ for (const key of ["url", "authorization", "settings", "headers", "body"]) expect(pulled[key]).toBeUndefined();
143
+
144
+ let requests = 0;
145
+ const server = Bun.serve({ port: 0, hostname: "127.0.0.1", fetch(req) {
146
+ requests++;
147
+ const url = new URL(req.url);
148
+ const row = url.pathname === "/api/provider"
149
+ ? [{ id: "custom", activation: "enabled", settings: { apiKey: "sk-FAKE" } }]
150
+ : [{ providerID: "custom", id: "nested/model", headers: { Authorization: "sk-FAKE" } }];
151
+ return Response.json({ location: { directory: PROJECT }, data: url.pathname === "/api/model/default" ? row[0] : row });
152
+ } });
153
+ const nodeDir = mkdtempSync(join(tmpdir(), "oc-hub-node-"));
154
+ try {
155
+ writeOpenCodeV2CatalogEndpoint(nodeDir, { url: `http://127.0.0.1:${server.port}`, authorization: "Basic fake", directory: PROJECT });
156
+ const read = await readOwnedOpenCodeV2Catalog({
157
+ networkId: NET, daemonId: DAEMON, authorizedDirectory: pulled.directory,
158
+ ownedProjectDirectory: PROJECT, endpoint: readOpenCodeV2CatalogEndpoint(nodeDir),
159
+ });
160
+ expect(read.ok).toBe(true);
161
+ if (!read.ok) return;
162
+ const acked = await call(daemon.out.ack_opencode_catalog!, { request_id: queued.request_id, snapshot: read.snapshot });
163
+ expect(acked).toEqual({ ok: true, status: "ready" });
164
+ const got = await call(user.out.get_opencode_catalog!, { request_id: queued.request_id });
165
+ expect(got.status).toBe("ready");
166
+ expect(got.snapshot.invocationVerified).toBe(false);
167
+ expect(got.snapshot.completeness).toBe("unknown");
168
+ expect(JSON.stringify(got.snapshot)).not.toContain("sk-FAKE");
169
+ expect(requests).toBe(3);
170
+ } finally {
171
+ server.stop(true);
172
+ rmSync(nodeDir, { recursive: true, force: true });
173
+ }
174
+ });
175
+
176
+ test("viewer may queue; outsider, node token, and non-v2 children may not", () => {
177
+ seed();
178
+ expect(queue(VIEWER, V2).ok).toBe(true);
179
+ expect(queue(OUTSIDER, V2, NET)).toEqual({ ok: false, error: "access_denied" });
180
+ expect(queue(OUTSIDER, V2, OTHER)).toEqual({ ok: false, error: "daemon_not_found" });
181
+ expect(queue(USER, V2, NET, true)).toEqual({ ok: false, error: "user_token_required" });
182
+ expect(queue(USER, V1)).toEqual({ ok: false, error: "not_opencode_v2" });
183
+ expect(queue(USER, UNSAFE)).toEqual({ ok: false, error: "not_opencode_v2" });
184
+ expect(queue(USER, "node_missing")).toEqual({ ok: false, error: "node_not_found" });
185
+ });
186
+
187
+ test("pending is not a snapshot; expiry, bad acks, and a missing endpoint stay closed", async () => {
188
+ seed();
189
+ const queued = queue(USER, V2);
190
+ expect(queued.ok).toBe(true);
191
+ if (!queued.ok) return;
192
+ expect(getOpenCodeCatalogResult({ callerUserId: USER, callerIsNode: false, networkId: NET, requestId: queued.request_id })).toEqual({
193
+ ok: true, status: "pending", request_id: queued.request_id,
194
+ });
195
+ const pulled = takeOpenCodeCatalogRequest(queued.request_id, DAEMON);
196
+ expect(pulled.ok).toBe(true);
197
+
198
+ expect(ackOpenCodeCatalog(DAEMON, { request_id: queued.request_id, snapshot: snapshot(), settings: { apiKey: "sk-FAKE" } })).toEqual({ ok: false, error: "invalid_ack" });
199
+ expect(ackOpenCodeCatalog(DAEMON, { request_id: queued.request_id, snapshot: snapshot(PROJECT, { invocationVerified: true }) })).toEqual({ ok: false, error: "invalid_ack" });
200
+ expect(getOpenCodeCatalogResult({ callerUserId: USER, callerIsNode: false, networkId: NET, requestId: queued.request_id }).status).toBe("pending");
201
+
202
+ const wrongDir = ackOpenCodeCatalog(DAEMON, { request_id: queued.request_id, snapshot: snapshot("/tmp/other-project") });
203
+ expect(wrongDir).toEqual({ ok: true, status: "failed", error: "invalid_response" });
204
+ expect(getOpenCodeCatalogResult({ callerUserId: USER, callerIsNode: false, networkId: NET, requestId: queued.request_id })).toMatchObject({
205
+ ok: false, status: "failed", error: "invalid_response",
206
+ });
207
+
208
+ const again = queue(USER, V2);
209
+ expect(again.ok).toBe(true);
210
+ if (!again.ok) return;
211
+ takeOpenCodeCatalogRequest(again.request_id, DAEMON);
212
+ expect(ackOpenCodeCatalog(DAEMON, { request_id: again.request_id, error: "unavailable" })).toEqual({ ok: true, status: "failed", error: "unavailable" });
213
+ expect(getOpenCodeCatalogResult({ callerUserId: USER, callerIsNode: false, networkId: NET, requestId: again.request_id })).toMatchObject({
214
+ ok: false, status: "failed", error: "unavailable",
215
+ });
216
+
217
+ const waiting = queue(USER, NULLDIR);
218
+ expect(waiting.ok).toBe(true);
219
+ if (!waiting.ok) return;
220
+ expireOpenCodeCatalogForTest(waiting.request_id);
221
+ expect(getOpenCodeCatalogResult({ callerUserId: USER, callerIsNode: false, networkId: NET, requestId: waiting.request_id })).toMatchObject({
222
+ ok: false, status: "expired", error: "unavailable",
223
+ });
224
+ });
225
+
226
+ test("acks a Windows absolute directory without Hub path.resolve", () => {
227
+ seed();
228
+ db.run(`UPDATE node_create_requests SET workdir = ?1 WHERE request_id = ?2`, ["C:\\project", V2_REQ]);
229
+ const queued = queue(USER, V2);
230
+ expect(queued.ok).toBe(true);
231
+ if (!queued.ok) return;
232
+ takeOpenCodeCatalogRequest(queued.request_id, DAEMON);
233
+ expect(ackOpenCodeCatalog(DAEMON, { request_id: queued.request_id, snapshot: snapshot("project") })).toEqual({ ok: false, error: "invalid_ack" });
234
+ expect(ackOpenCodeCatalog(DAEMON, { request_id: queued.request_id, snapshot: snapshot("C:relative") })).toEqual({ ok: false, error: "invalid_ack" });
235
+ expect(getOpenCodeCatalogResult({ callerUserId: USER, callerIsNode: false, networkId: NET, requestId: queued.request_id }).status).toBe("pending");
236
+ expect(ackOpenCodeCatalog(DAEMON, { request_id: queued.request_id, snapshot: snapshot("C:/project") })).toEqual({ ok: true, status: "ready" });
237
+ const got = getOpenCodeCatalogResult({ callerUserId: USER, callerIsNode: false, networkId: NET, requestId: queued.request_id });
238
+ expect(got.ok).toBe(true);
239
+ if (!got.ok || got.status !== "ready") return;
240
+ expect(got.snapshot.scope.directory).toBe("C:/project");
241
+
242
+ const other = queue(USER, V2);
243
+ expect(other.ok).toBe(true);
244
+ if (!other.ok) return;
245
+ takeOpenCodeCatalogRequest(other.request_id, DAEMON);
246
+ expect(ackOpenCodeCatalog(DAEMON, { request_id: other.request_id, snapshot: snapshot("D:\\other") })).toEqual({
247
+ ok: true, status: "failed", error: "invalid_response",
248
+ });
249
+ });
250
+
251
+ test("a tilde workdir matches a native absolute report, and lexical .. collapses", () => {
252
+ seed();
253
+ db.run(`UPDATE node_create_requests SET workdir = ?1 WHERE request_id = ?2`, ["~/project", V2_REQ]);
254
+ const queued = queue(USER, V2);
255
+ expect(queued.ok).toBe(true);
256
+ if (!queued.ok) return;
257
+ takeOpenCodeCatalogRequest(queued.request_id, DAEMON);
258
+ expect(ackOpenCodeCatalog(DAEMON, { request_id: queued.request_id, snapshot: snapshot("/home/user/project") })).toEqual({ ok: true, status: "ready" });
259
+
260
+ db.run(`UPDATE node_create_requests SET workdir = ?1 WHERE request_id = ?2`, ["/tmp/foo/../bar", V2_REQ]);
261
+ const lexical = queue(USER, V2);
262
+ expect(lexical.ok).toBe(true);
263
+ if (!lexical.ok) return;
264
+ takeOpenCodeCatalogRequest(lexical.request_id, DAEMON);
265
+ expect(ackOpenCodeCatalog(DAEMON, { request_id: lexical.request_id, snapshot: snapshot("/tmp/foo/../bar") })).toEqual({ ok: false, error: "invalid_ack" });
266
+ expect(ackOpenCodeCatalog(DAEMON, { request_id: lexical.request_id, snapshot: snapshot("/tmp/bar") })).toEqual({ ok: true, status: "ready" });
267
+ });
268
+ });