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

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 (444) hide show
  1. package/README.md +120 -3
  2. package/bin/commhub.ts +93 -9
  3. package/build-info.json +7 -0
  4. package/package.json +10 -8
  5. package/src/ack-create-request-transport.test.ts +182 -0
  6. package/src/ack-create-request.test.ts +52 -8
  7. package/src/admin-delete-network-http.test.ts +229 -0
  8. package/src/admin-networks-http.test.ts +88 -0
  9. package/src/adoption-candidates-http.test.ts +140 -0
  10. package/src/adoption-candidates.ts +158 -0
  11. package/src/agent-access-batch.test.ts +210 -0
  12. package/src/agent-access.ts +585 -0
  13. package/src/agent-acl-groups-http.test.ts +247 -0
  14. package/src/agent-acl-http.test.ts +691 -0
  15. package/src/agent-acl-slice3-http.test.ts +885 -0
  16. package/src/agent-department-grants.test.ts +129 -0
  17. package/src/agent-department-http.test.ts +215 -0
  18. package/src/agent-groups-perf.test.ts +223 -0
  19. package/src/agent-notice.ts +48 -0
  20. package/src/agent-team-whoami-http.test.ts +98 -0
  21. package/src/agent-teams-http.test.ts +330 -0
  22. package/src/agent-teams.ts +244 -0
  23. package/src/alias-baseline-2571.test.ts +162 -0
  24. package/src/alias-baseline.ts +113 -0
  25. package/src/alias-filter.test.ts +72 -0
  26. package/src/alias-filter.ts +42 -0
  27. package/src/api-host-supervisors-can-create-nodes.test.ts +350 -0
  28. package/src/api-host-supervisors-fallback.test.ts +6 -7
  29. package/src/api-host-supervisors-runtime-readiness.test.ts +195 -0
  30. package/src/api-nodes-shape.test.ts +131 -4
  31. package/src/auth-abuse-counters.test.ts +144 -0
  32. package/src/auth-abuse-counters.ts +122 -0
  33. package/src/auth-layer-shape.test.ts +105 -0
  34. package/src/auth-password-change-cli-tokens-http.test.ts +423 -0
  35. package/src/auth-sessions-http.test.ts +260 -0
  36. package/src/auth-validate.test.ts +5 -1
  37. package/src/auth-weak-password-login.test.ts +176 -0
  38. package/src/auth.ts +641 -68
  39. package/src/backfill-node-ids-2664.test.ts +128 -0
  40. package/src/binding-generation-http.test.ts +141 -0
  41. package/src/blocked-exit-on-reply.test.ts +122 -0
  42. package/src/broadcast-fanout-2721.test.ts +149 -0
  43. package/src/broadcast-fanout.ts +117 -0
  44. package/src/build-commit-report-http.test.ts +128 -0
  45. package/src/build-info.test.ts +60 -0
  46. package/src/build-info.ts +85 -0
  47. package/src/chain-attempt-dedup.test.ts +447 -0
  48. package/src/clip.test.ts +36 -0
  49. package/src/clip.ts +48 -0
  50. package/src/clone-node.test.ts +269 -0
  51. package/src/clone-node.ts +289 -0
  52. package/src/codex-config-flags.ts +77 -0
  53. package/src/codex-fork-contract.ts +23 -0
  54. package/src/codex-fork-migration.test.ts +38 -0
  55. package/src/commhub-bin-args.test.ts +85 -0
  56. package/src/config-apply-validate.test.ts +188 -1
  57. package/src/config-apply-validate.ts +222 -3
  58. package/src/cors-origins.test.ts +73 -0
  59. package/src/create-node-blocked-gate.test.ts +365 -0
  60. package/src/create-node-error-domain.test.ts +127 -0
  61. package/src/create-node-network-id.test.ts +91 -0
  62. package/src/create-node-tool-schema.test.ts +49 -0
  63. package/src/create-node-unicode-name.test.ts +126 -0
  64. package/src/create-node-validate.test.ts +199 -7
  65. package/src/create-node-validate.ts +232 -15
  66. package/src/create-node-workdir.test.ts +298 -0
  67. package/src/create-node.ts +88 -23
  68. package/src/daemon-provider-snapshots.test.ts +453 -0
  69. package/src/daemon-provider-snapshots.ts +327 -0
  70. package/src/daemon-token-owner-http.test.ts +346 -0
  71. package/src/dashboard-slash-routing-http.test.ts +109 -0
  72. package/src/db-adapter-guard.test.ts +148 -0
  73. package/src/db-adapter-translate.test.ts +128 -0
  74. package/src/db-adapter.ts +377 -91
  75. package/src/db-timestamp.test.ts +38 -0
  76. package/src/db-timestamp.ts +15 -0
  77. package/src/db.ts +1298 -153
  78. package/src/delivered-without-push.test.ts +140 -0
  79. package/src/department-groups-http.test.ts +209 -0
  80. package/src/department-groups-sync-http.test.ts +328 -0
  81. package/src/department-groups.ts +434 -0
  82. package/src/department-heads-http.test.ts +350 -0
  83. package/src/department-heads.ts +226 -0
  84. package/src/departments-agent-count.test.ts +139 -0
  85. package/src/departments-http.test.ts +185 -0
  86. package/src/departments-mcp-error-domain.test.ts +135 -0
  87. package/src/departments-mcp.test.ts +128 -0
  88. package/src/departments.ts +318 -0
  89. package/src/desktop-message-seam.test.ts +150 -0
  90. package/src/desktop-message.test.ts +368 -0
  91. package/src/dm-file-scope-http.test.ts +227 -0
  92. package/src/empty-node-sweeper.test.ts +104 -0
  93. package/src/empty-node-sweeper.ts +88 -0
  94. package/src/env-transport-gate-http.test.ts +240 -0
  95. package/src/env-transport-gate.ts +80 -0
  96. package/src/env-transport-policy.ts +56 -0
  97. package/src/etag-of.test.ts +57 -0
  98. package/src/event-loop-lag.test.ts +180 -0
  99. package/src/event-loop-lag.ts +201 -0
  100. package/src/expiry-counters.test.ts +187 -0
  101. package/src/expiry-counters.ts +227 -0
  102. package/src/expiry-evidence-db.test.ts +103 -0
  103. package/src/ext-token-shared.test.ts +60 -0
  104. package/src/ext-validation-regression.test.ts +10 -17
  105. package/src/external-schedule-edits-http.test.ts +321 -0
  106. package/src/external-schedule-edits-timestamps.test.ts +64 -0
  107. package/src/external-schedule-edits.ts +327 -0
  108. package/src/file-download-authz-dev-open.test.ts +1 -1
  109. package/src/file-download-authz.test.ts +25 -4
  110. package/src/file-download-date-bucket.test.ts +1 -1
  111. package/src/file-network-scope-dev-open.test.ts +1 -1
  112. package/src/file-network-scope.test.ts +7 -6
  113. package/src/group-membership-events-http.test.ts +264 -0
  114. package/src/group-messages-http.test.ts +483 -0
  115. package/src/group-messages.ts +297 -0
  116. package/src/health-anon-readers.ts +67 -0
  117. package/src/health-host-disk-2756.test.ts +71 -0
  118. package/src/health-identity-root.test.ts +98 -0
  119. package/src/health-redaction.test.ts +1599 -7
  120. package/src/health-status-reasons.test.ts +84 -0
  121. package/src/host-supervisor-identity-http.test.ts +152 -0
  122. package/src/host-supervisor-identity.ts +92 -0
  123. package/src/host-supervisors-daemon-version.test.ts +137 -0
  124. package/src/http-gzip.test.ts +94 -0
  125. package/src/http-gzip.ts +112 -0
  126. package/src/hub-catalog-read-http.test.ts +664 -0
  127. package/src/hub-provider-config.test.ts +166 -0
  128. package/src/hub-provider-config.ts +202 -0
  129. package/src/hub-timestamp.test.ts +38 -0
  130. package/src/hub-timestamp.ts +27 -0
  131. package/src/human-dm.ts +215 -0
  132. package/src/human-inbox.ts +42 -0
  133. package/src/inbox-caller.ts +49 -0
  134. package/src/inbox-count-sse.test.ts +318 -0
  135. package/src/inbox-count.ts +29 -0
  136. package/src/index.ts +6 -2
  137. package/src/license-state.test.ts +105 -0
  138. package/src/license-state.ts +48 -0
  139. package/src/lifecycle-error-domain.test.ts +149 -0
  140. package/src/list-ack-error-domain.test.ts +108 -0
  141. package/src/list-host-supervisors.test.ts +15 -4
  142. package/src/list-tasks-omit-default.test.ts +84 -0
  143. package/src/list-tasks-since-last.test.ts +100 -0
  144. package/src/list-tasks-since.test.ts +104 -0
  145. package/src/mcp-context-cost-http.test.ts +127 -0
  146. package/src/mcp-inflight.test.ts +92 -0
  147. package/src/mcp-inflight.ts +38 -0
  148. package/src/mcp-projects-events-http.test.ts +168 -0
  149. package/src/mcp-route-label-http.test.ts +120 -0
  150. package/src/mcp-write-network-resolution.test.ts +21 -0
  151. package/src/member-audit-network-id-http.test.ts +93 -0
  152. package/src/member-presence-http.test.ts +210 -0
  153. package/src/messages-ack-by-agent-http.test.ts +142 -0
  154. package/src/migrate-sqlite-to-pg.test.ts +47 -0
  155. package/src/migrate-sqlite-to-pg.ts +263 -0
  156. package/src/model-auth-notify-http.test.ts +181 -0
  157. package/src/model-auth-notify.ts +116 -0
  158. package/src/network-name-http.test.ts +75 -0
  159. package/src/network-quota-config.test.ts +100 -0
  160. package/src/network-rules-http.test.ts +169 -0
  161. package/src/network-rules.ts +129 -0
  162. package/src/network-scope.ts +222 -3
  163. package/src/network-token-membership-http.test.ts +186 -0
  164. package/src/node-alias-control.ts +12 -0
  165. package/src/node-attrs.test.ts +47 -2
  166. package/src/node-caller-identity-http.test.ts +1108 -0
  167. package/src/node-config-last-update.test.ts +126 -0
  168. package/src/node-config-last-update.ts +107 -0
  169. package/src/node-create-request-status-http.test.ts +105 -0
  170. package/src/node-daemon-bindings.test.ts +142 -0
  171. package/src/node-daemon-bindings.ts +135 -0
  172. package/src/node-failure-alert.test.ts +150 -0
  173. package/src/node-failure-alert.ts +177 -0
  174. package/src/node-files-transport.test.ts +350 -0
  175. package/src/node-health-codex-login.test.ts +120 -0
  176. package/src/node-health-dispatch-http.test.ts +373 -0
  177. package/src/node-health-guard-origin.test.ts +98 -0
  178. package/src/node-health-guard.ts +121 -0
  179. package/src/node-health-passthrough.test.ts +115 -0
  180. package/src/node-health-store.ts +101 -0
  181. package/src/node-id-alias.test.ts +190 -0
  182. package/src/node-identity-conflict-http.test.ts +269 -0
  183. package/src/node-identity-conflict.ts +142 -0
  184. package/src/node-identity-mismatch.test.ts +74 -0
  185. package/src/node-in-flight-tasks.ts +31 -0
  186. package/src/node-lifecycle-controllable.test.ts +64 -0
  187. package/src/node-lifecycle-controllable.ts +53 -0
  188. package/src/node-lifecycle-read-http.test.ts +257 -0
  189. package/src/node-lifecycle-read.ts +124 -0
  190. package/src/node-logs-transport.test.ts +266 -0
  191. package/src/node-peer-allowlist.test.ts +114 -0
  192. package/src/node-permissions-http.test.ts +901 -0
  193. package/src/node-permissions.ts +494 -0
  194. package/src/node-request-retention.test.ts +281 -0
  195. package/src/node-request-retention.ts +120 -0
  196. package/src/node-secret-rest-http.test.ts +190 -0
  197. package/src/node-secret-vault-inject.test.ts +132 -0
  198. package/src/node-security-write-gate.test.ts +72 -0
  199. package/src/node-serviceability.test.ts +86 -0
  200. package/src/node-serviceability.ts +124 -0
  201. package/src/node-session-control-http.test.ts +310 -0
  202. package/src/node-session-control.ts +258 -0
  203. package/src/node-skills-transport.test.ts +212 -0
  204. package/src/node-token-identity.ts +35 -0
  205. package/src/node-token-ownership.ts +51 -0
  206. package/src/node-token-privilege-http.test.ts +224 -0
  207. package/src/not-found-api-http.test.ts +67 -0
  208. package/src/observer-avatar-http.test.ts +103 -10
  209. package/src/observer-push.test.ts +76 -0
  210. package/src/opencode-catalog-report-http.test.ts +139 -0
  211. package/src/opencode-v2-catalog.test.ts +268 -0
  212. package/src/opencode-v2-catalog.ts +356 -0
  213. package/src/package-version-consistency.test.ts +25 -0
  214. package/src/parent-infer.test.ts +82 -0
  215. package/src/parent-infer.ts +110 -0
  216. package/src/parent-source-marker.test.ts +70 -0
  217. package/src/parent-source-orphan.test.ts +121 -0
  218. package/src/password-network-tokens.ts +25 -0
  219. package/src/peer-reply-atomic.test.ts +462 -0
  220. package/src/peer-reply-capability.test.ts +70 -0
  221. package/src/pg-worker.ts +87 -0
  222. package/src/poll-pacing.test.ts +74 -0
  223. package/src/poll-pacing.ts +123 -0
  224. package/src/probe-provider-error-domain.test.ts +145 -0
  225. package/src/project-dir-warn-clear-http.test.ts +132 -0
  226. package/src/project-viewer-can-http.test.ts +116 -0
  227. package/src/provider-skill-error-domain.test.ts +130 -0
  228. package/src/provider-tools-shape.test.ts +165 -0
  229. package/src/push.test.ts +20 -10
  230. package/src/push.ts +373 -9
  231. package/src/redact-tokens.test.ts +86 -0
  232. package/src/redact-tokens.ts +43 -0
  233. package/src/rejection-counters.test.ts +72 -0
  234. package/src/rejection-counters.ts +173 -0
  235. package/src/rename.ts +38 -10
  236. package/src/reply-target-derivation.test.ts +96 -0
  237. package/src/report-status-handover-capabilities-http.test.ts +124 -0
  238. package/src/report-status-host-schema.test.ts +235 -0
  239. package/src/report-status-resume-id-handover.test.ts +184 -0
  240. package/src/report-status-secret-keys.test.ts +140 -0
  241. package/src/require-explicit-test-db.ts +9 -0
  242. package/src/requirement-due-reminders-http.test.ts +620 -0
  243. package/src/requirement-due-reminders.ts +416 -0
  244. package/src/requirement-events-http.test.ts +318 -0
  245. package/src/requirement-events.test.ts +45 -0
  246. package/src/requirement-events.ts +144 -0
  247. package/src/requirement-notify.ts +165 -0
  248. package/src/requirement-participant-notify-http.test.ts +313 -0
  249. package/src/requirement-tag-ops-http.test.ts +454 -0
  250. package/src/requirement-tag-tree-http.test.ts +275 -0
  251. package/src/requirement-tag-tree.ts +127 -0
  252. package/src/requirement-tags.ts +102 -0
  253. package/src/requirements-abandoned-http.test.ts +236 -0
  254. package/src/requirements-assignee-drift.test.ts +154 -0
  255. package/src/requirements-comment-http.test.ts +174 -0
  256. package/src/requirements-completed-at-migration.test.ts +70 -0
  257. package/src/requirements-errors-mcp-http.test.ts +164 -0
  258. package/src/requirements-errors.ts +158 -0
  259. package/src/requirements-etag-http.test.ts +91 -0
  260. package/src/requirements-http.test.ts +709 -0
  261. package/src/requirements-last-event-http.test.ts +349 -0
  262. package/src/requirements-list-mcp-slim-http.test.ts +155 -0
  263. package/src/requirements-list-slim-http.test.ts +324 -0
  264. package/src/requirements-mcp.test.ts +180 -0
  265. package/src/requirements-migrate.ts +283 -0
  266. package/src/requirements-owner-strict-mcp-http.test.ts +145 -0
  267. package/src/requirements-people-http.test.ts +114 -0
  268. package/src/requirements-people-mcp-http.test.ts +231 -0
  269. package/src/requirements-people.ts +196 -0
  270. package/src/requirements-priority-lowest.test.ts +114 -0
  271. package/src/requirements-projects-network-echo.test.ts +57 -0
  272. package/src/requirements-projects-parent-http.test.ts +123 -0
  273. package/src/requirements-search-http.test.ts +182 -0
  274. package/src/requirements-search.test.ts +32 -0
  275. package/src/requirements-search.ts +145 -0
  276. package/src/requirements-seq-http.test.ts +193 -0
  277. package/src/requirements-seq-migration.test.ts +63 -0
  278. package/src/requirements-start-date.test.ts +125 -0
  279. package/src/requirements-stats-http.test.ts +357 -0
  280. package/src/requirements-stats.ts +195 -0
  281. package/src/requirements-status-participants-http.test.ts +222 -0
  282. package/src/requirements-upgrade-e2e.test.ts +126 -0
  283. package/src/requirements-upgrade-migration.test.ts +98 -0
  284. package/src/requirements.ts +2205 -0
  285. package/src/resolve-port.test.ts +57 -0
  286. package/src/resolve-port.ts +44 -0
  287. package/src/rest-alias-network-fallback-http.test.ts +123 -0
  288. package/src/rest-alias-network-fallback.test.ts +60 -0
  289. package/src/rest-alias-network-fallback.ts +65 -0
  290. package/src/rest-explicit-columns-http.test.ts +266 -0
  291. package/src/rest-identity.test.ts +130 -0
  292. package/src/rest-identity.ts +141 -0
  293. package/src/rest-projections.ts +72 -0
  294. package/src/rest-read-network-real-chain.test.ts +97 -0
  295. package/src/rest-write-network-resolution.test.ts +133 -0
  296. package/src/restart-readiness-http.test.ts +121 -0
  297. package/src/restricted-files.ts +76 -0
  298. package/src/retention-first-sweep-quiet.test.ts +31 -0
  299. package/src/retention.test.ts +100 -40
  300. package/src/retention.ts +423 -104
  301. package/src/route-callers-http.test.ts +120 -0
  302. package/src/route-timing.test.ts +218 -0
  303. package/src/route-timing.ts +262 -0
  304. package/src/rules-file-duplicate-alias.test.ts +234 -0
  305. package/src/rules-file-session-target.test.ts +207 -0
  306. package/src/rules-file-transport.test.ts +271 -0
  307. package/src/runtime-label.test.ts +22 -0
  308. package/src/runtime-label.ts +21 -0
  309. package/src/runtime-readiness.ts +90 -0
  310. package/src/schedule-agent-mcp-http.test.ts +486 -0
  311. package/src/schedule-agent.ts +252 -0
  312. package/src/schedule-starved.test.ts +92 -0
  313. package/src/schedule-starved.ts +114 -0
  314. package/src/scheduled-backoff-http.test.ts +203 -0
  315. package/src/scheduled-backoff.ts +64 -0
  316. package/src/scheduled-doorbell-nodeless-session.test.ts +134 -0
  317. package/src/scheduled-failure-backoff-2622.test.ts +145 -0
  318. package/src/scheduled-failure-code.test.ts +73 -0
  319. package/src/scheduled-failure-code.ts +105 -0
  320. package/src/scheduled-failures-http.test.ts +279 -0
  321. package/src/scheduled-failures.ts +425 -0
  322. package/src/scheduled-noprogress-backoff-2622.test.ts +163 -0
  323. package/src/scheduled-offline-backoff-probe.test.ts +56 -0
  324. package/src/scheduled-offline.test.ts +131 -0
  325. package/src/scheduled-offline.ts +66 -0
  326. package/src/scheduled-outcome-guidance-http.test.ts +139 -0
  327. package/src/scheduled-outcome-guidance.ts +9 -0
  328. package/src/scheduled-reply-unread-http.test.ts +212 -0
  329. package/src/scheduled-requirement-wake-http.test.ts +289 -0
  330. package/src/scheduled-requirement-wake.ts +125 -0
  331. package/src/scheduled-run-terminal.test.ts +290 -0
  332. package/src/scheduled-skip-blocking-task.test.ts +120 -0
  333. package/src/scheduled-skip-path-backoff-2622.test.ts +98 -0
  334. package/src/scheduled-stuck-http.test.ts +316 -0
  335. package/src/scheduled-stuck-notice-cap.test.ts +80 -0
  336. package/src/scheduled-stuck.ts +219 -0
  337. package/src/scheduled-tasks-http.test.ts +679 -0
  338. package/src/scheduled-tasks.ts +959 -0
  339. package/src/scheduled-work-outcome-http.test.ts +154 -0
  340. package/src/scheduled-work-outcome.ts +50 -0
  341. package/src/scoped-secrets.ts +167 -0
  342. package/src/secret-echo-negative-control.test.ts +118 -0
  343. package/src/send-dedup-request-id.test.ts +229 -0
  344. package/src/send-reply-agent-warning.test.ts +38 -38
  345. package/src/send-reply-alias-optional.test.ts +131 -0
  346. package/src/send-reply-attachments.test.ts +28 -7
  347. package/src/send_dedup.test.ts +54 -0
  348. package/src/send_dedup.ts +52 -6
  349. package/src/serve-error.test.ts +73 -0
  350. package/src/serve-error.ts +56 -0
  351. package/src/server.ts +4930 -377
  352. package/src/session-task-on-dispatch.ts +14 -0
  353. package/src/session-token-ownership-http.test.ts +122 -0
  354. package/src/shared/codex-inventory.ts +41 -0
  355. package/src/shared/daemon-provider-login.ts +31 -0
  356. package/src/shared/daemon-provider-snapshot.ts +52 -0
  357. package/src/shared/external-schedule-contract.ts +60 -0
  358. package/src/shared/node-name.test.ts +62 -0
  359. package/src/shared/node-name.ts +161 -0
  360. package/src/shared/probe-host-allowlist-drift.test.ts +45 -0
  361. package/src/shared/provider-application.ts +29 -0
  362. package/src/shared/provider-collection.ts +14 -0
  363. package/src/shared/provider-initialization.ts +8 -0
  364. package/src/shared/reserved-env-drift.test.ts +10 -0
  365. package/src/shared/scoped-secret-contract.ts +5 -0
  366. package/src/shared/task-content-limit-drift.test.ts +28 -0
  367. package/src/shared/task-content-limit.ts +25 -0
  368. package/src/side-thread-command-transport.test.ts +312 -0
  369. package/src/side-thread-command-transport.ts +318 -0
  370. package/src/side-thread-http-integration.test.ts +233 -0
  371. package/src/side-thread-http.ts +504 -0
  372. package/src/side-thread-production.test.ts +72 -0
  373. package/src/side-thread-production.ts +118 -0
  374. package/src/side-thread.test.ts +1067 -0
  375. package/src/side-thread.ts +2499 -0
  376. package/src/skillhub-http.test.ts +144 -0
  377. package/src/sqlite-close-checkpoint.test.ts +78 -0
  378. package/src/start-node.test.ts +265 -0
  379. package/src/start-request-error-domain.test.ts +182 -0
  380. package/src/start-skill-error-domain.test.ts +122 -0
  381. package/src/stats-versions-http.test.ts +65 -0
  382. package/src/status-alias-filter-http.test.ts +106 -0
  383. package/src/status-alias-resolver-http.test.ts +163 -0
  384. package/src/status-alias-resolver.ts +19 -0
  385. package/src/status-node-id-filter-http.test.ts +161 -0
  386. package/src/status-read-cache-http.test.ts +229 -0
  387. package/src/status-read-cache.ts +129 -0
  388. package/src/stop-delete-node.test.ts +567 -1
  389. package/src/task-access-http.test.ts +407 -0
  390. package/src/task-access.ts +420 -0
  391. package/src/task-activity.ts +60 -0
  392. package/src/task-auth-origin-http.test.ts +93 -0
  393. package/src/task-auth-origin.test.ts +24 -0
  394. package/src/task-auth-origin.ts +7 -0
  395. package/src/task-consumption.test.ts +508 -0
  396. package/src/task-diagnostic-http.test.ts +149 -0
  397. package/src/task-diagnostic.test.ts +115 -0
  398. package/src/task-diagnostic.ts +118 -0
  399. package/src/task-expiry-notice-http.test.ts +298 -0
  400. package/src/task-expiry-notice.ts +318 -0
  401. package/src/task-idempotency-mcp.test.ts +148 -0
  402. package/src/task-idempotency.test.ts +76 -0
  403. package/src/task-idempotency.ts +81 -0
  404. package/src/task-late-replies.ts +54 -0
  405. package/src/task-late-reply-http.test.ts +227 -0
  406. package/src/task-lifecycle-watcher-busy.test.ts +114 -0
  407. package/src/task-lifecycle-watcher.test.ts +209 -0
  408. package/src/task-lifecycle-watcher.ts +109 -0
  409. package/src/task-network-resolution-http.test.ts +140 -0
  410. package/src/task-not-found-error-domain.test.ts +114 -0
  411. package/src/task-offline-delivery-2668.test.ts +119 -0
  412. package/src/task-offline-delivery.ts +81 -0
  413. package/src/task-orphan-http.test.ts +287 -0
  414. package/src/task-orphan.ts +119 -0
  415. package/src/task-queue-ahead-http.test.ts +309 -0
  416. package/src/task-queue-ahead-scale.test.ts +236 -0
  417. package/src/task-queue-ahead.ts +186 -0
  418. package/src/task-rejection-log-http.test.ts +160 -0
  419. package/src/task-rejection-log.ts +61 -0
  420. package/src/task-sender-http.test.ts +143 -0
  421. package/src/task-stale-open-http.test.ts +292 -0
  422. package/src/task-stale-open.ts +103 -0
  423. package/src/tasks-pagination-http.test.ts +141 -0
  424. package/src/team-rules-status-http.test.ts +90 -0
  425. package/src/team-rules-status.test.ts +59 -0
  426. package/src/team-rules-status.ts +72 -0
  427. package/src/tmux-allowlist.test.ts +48 -0
  428. package/src/tool-audience-http.test.ts +248 -0
  429. package/src/tool-audience.ts +127 -0
  430. package/src/tools-list-json-schema.test.ts +94 -0
  431. package/src/tools.ts +4314 -392
  432. package/src/update-node-config-error-domain.test.ts +107 -0
  433. package/src/uploads-http.test.ts +6 -4
  434. package/src/uploads.ts +23 -4
  435. package/src/user-avatar-http.test.ts +74 -0
  436. package/src/user-avatar-image.ts +160 -0
  437. package/src/user-avatar-migration.test.ts +25 -0
  438. package/src/user-avatar-upload-http.test.ts +353 -0
  439. package/src/user-inbox-by-agent-http.test.ts +189 -0
  440. package/src/user-inbox-netid-notnull.test.ts +122 -0
  441. package/src/user-inbox-read-http.test.ts +223 -0
  442. package/src/user-inbox-schema.test.ts +54 -0
  443. package/src/version-stats.test.ts +66 -0
  444. package/src/version-stats.ts +109 -0
@@ -0,0 +1,310 @@
1
+ import { afterAll, afterEach, beforeAll, beforeEach, describe, expect, setSystemTime, test } from "bun:test";
2
+ import { mkdtempSync, rmSync } from "node:fs";
3
+ import { tmpdir } from "node:os";
4
+ import { join } from "node:path";
5
+
6
+ const dir = mkdtempSync(join(tmpdir(), "anet-session-control-"));
7
+ process.env.COMMHUB_DB ||= join(dir, "hub.db");
8
+ const root = "/api/node-session-control";
9
+ let server: any, base: string, db: any, net: string, otherNet: string;
10
+ let owner: any, admin: any, member: any, outsider: any, ntok: any, peer: any;
11
+ let legacyOwner: any, legacyAdmin: any, legacyMember: any, legacyOutsider: any, legacyFull: any, legacyNetwork: any;
12
+ let binding = { session_id: "session_1", binding_id: "binding_1" }, serial = 0;
13
+ const nodeId = "n_session_control", peerId = "n_session_control_peer";
14
+ async function api(token: string, path: string, value?: unknown, method?: string) {
15
+ const res = await fetch(`${base}${path}`, { method: method ?? (value === undefined ? "GET" : "POST"),
16
+ headers: { authorization: `Bearer ${token}`, "content-type": "application/json" },
17
+ ...(value === undefined ? {} : { body: JSON.stringify(value) }) });
18
+ return { status: res.status, body: await res.json() as any };
19
+ }
20
+ const registerBridge = (v = binding, token = ntok.token!) => api(token, `${root}/bridge`,
21
+ { ...v, expected: { node_id: nodeId, network_id: net } });
22
+ const enqueue = (operation = "background", extra = {}) => api(owner.token!, root,
23
+ { network_id: net, node_id: nodeId, operation, expected: binding, ...extra });
24
+ const pull = (token = ntok.token!, v = binding) => api(token, `${root}/pull`, v);
25
+ const read = (request: string, token = owner.token!, network = net) => api(token, `${root}/${request}?network_id=${network}`);
26
+ const state = () => ({ ...binding, supported: true, active: true, can_request_background: true, observed_at: Date.now() });
27
+ const ack = (request: string, result: unknown, extra = {}) => api(ntok.token!, `${root}/${request}/ack`,
28
+ { ...binding, status: "done", result, ...extra });
29
+
30
+ beforeAll(async () => {
31
+ ({ db } = await import("./db.js"));
32
+ const { register, addNetworkMember, createNetworkTokenForNode, createToken } = await import("./auth.js");
33
+ const stamp = Date.now();
34
+ admin = register(`sc_admin_${stamp}`, "SessionControl-Test-1!");
35
+ owner = register(`sc_owner_${stamp}`, "SessionControl-Test-2!");
36
+ member = register(`sc_member_${stamp}`, "SessionControl-Test-3!");
37
+ outsider = register(`sc_other_${stamp}`, "SessionControl-Test-4!");
38
+ expect(admin.ok && owner.ok && member.ok && outsider.ok).toBe(true);
39
+ net = admin.network_id!; otherNet = outsider.network_id!;
40
+ for (const u of [owner, member]) expect(addNetworkMember(net, u.user.user_id, "member", admin.user.user_id, { agentAccess: "all" }).ok).toBe(true);
41
+ // Real atok hashes via the legacy issuer; only fixture rows are converted
42
+ // to the historical global scope=user shape. No prefix-based authority.
43
+ const legacyUser = (u: any) => {
44
+ const t = createToken(u.user.user_id, "sc-legacy-user");
45
+ expect(t.ok).toBe(true);
46
+ expect(t.token).toMatch(/^atok_/);
47
+ db.run("UPDATE api_tokens SET scope='user' WHERE token_id=?1", t.token_id);
48
+ return t;
49
+ };
50
+ legacyOwner = legacyUser(owner); legacyAdmin = legacyUser(admin);
51
+ legacyMember = legacyUser(member); legacyOutsider = legacyUser(outsider);
52
+ legacyFull = createToken(owner.user.user_id, "sc-legacy-global-full");
53
+ legacyNetwork = createToken(owner.user.user_id, "sc-legacy-network", net);
54
+ expect(legacyFull.ok && legacyNetwork.ok).toBe(true);
55
+ ntok = createNetworkTokenForNode(owner.user.user_id, net, "sc-target", nodeId);
56
+ peer = createNetworkTokenForNode(owner.user.user_id, net, "sc-peer", peerId);
57
+ expect(ntok.ok && peer.ok).toBe(true);
58
+ db.run("INSERT INTO sessions(resume_id,alias,node_id,network_id,status) VALUES (?1,?2,?3,?4,'idle')", ["r_sc_target", "sc-target", nodeId, net]);
59
+ const { bootServer } = await import("./server.js");
60
+ server = bootServer({ port: 0, hostname: "127.0.0.1" });
61
+ base = `http://127.0.0.1:${server.port}`;
62
+ }, 30_000);
63
+ beforeEach(async () => {
64
+ binding = { session_id: `session_${++serial}`, binding_id: `binding_${serial}` };
65
+ expect((await registerBridge()).status).toBe(200);
66
+ });
67
+ afterEach(() => setSystemTime());
68
+ afterAll(() => { server?.stop(true); rmSync(dir, { recursive: true, force: true }); });
69
+
70
+ describe("#2017 human-to-exact-Bridge HTTP relay", () => {
71
+ test("[2017 identity] missing or malformed expected is refused without fallback", async () => {
72
+ for (const expected of [undefined, {}, { node_id: nodeId }, { node_id: nodeId, network_id: net, token_id: ntok.token_id }]) {
73
+ const rejected = await api(ntok.token!, `${root}/bridge`, { ...binding, expected });
74
+ expect(rejected.status).toBe(400);
75
+ expect(rejected.body.error).toBe("session_control_request_invalid");
76
+ }
77
+ expect((await registerBridge()).status).toBe(200);
78
+ });
79
+ test("[2017 identity] A credential expected B cannot sweep, replace or retire the valid binding", async () => {
80
+ const made = await enqueue("state"), clock = Date.now();
81
+ const tokenBefore = db.get("SELECT token_id,bound_node_id,network_id FROM api_tokens WHERE token_id=?1", ntok.token_id);
82
+ const nodeBefore = db.get("SELECT node_id,network_id,owner_user_id FROM nodes WHERE node_id=?1", nodeId);
83
+ // Advancing beyond the request deadline exposes an accidental sweep before
84
+ // rejecting expected. Restore only the clock, never the authoritative queue.
85
+ setSystemTime(new Date(clock + 16_000));
86
+ for (const expected of [{ node_id: peerId, network_id: net }, { node_id: nodeId, network_id: otherNet }]) {
87
+ const rejected = await api(ntok.token!, `${root}/bridge`, {
88
+ session_id: "would_replace_session", binding_id: "would_retire_binding", expected,
89
+ });
90
+ expect(rejected.status).toBe(409);
91
+ expect(rejected.body.error).toBe("session_control_changed");
92
+ }
93
+ setSystemTime(new Date(clock));
94
+ expect((await read(made.body.request_id)).body.status).toBe("pending");
95
+ expect((await registerBridge()).status).toBe(200); // Original generation was not retired.
96
+ expect((await pull()).body.request).toMatchObject({ request_id: made.body.request_id, ...binding });
97
+ expect(db.get("SELECT token_id,bound_node_id,network_id FROM api_tokens WHERE token_id=?1", ntok.token_id)).toEqual(tokenBefore);
98
+ expect(db.get("SELECT node_id,network_id,owner_user_id FROM nodes WHERE node_id=?1", nodeId)).toEqual(nodeBefore);
99
+ });
100
+ test("[2017 identity] success carries the authenticated token row identity, never credential material", async () => {
101
+ const response = await registerBridge();
102
+ const row = db.get("SELECT token_id,bound_node_id,network_id FROM api_tokens WHERE token_id=?1", ntok.token_id);
103
+ expect(response.status).toBe(200);
104
+ expect(response.body.identity).toEqual({ node_id: row.bound_node_id, network_id: row.network_id, token_id: row.token_id });
105
+ expect(Object.keys(response.body).sort()).toEqual(["expires_at", "identity", "ok"]);
106
+ expect(JSON.stringify(response.body)).not.toContain(ntok.token);
107
+ });
108
+ test("normal state and background receipts are separate from actual tool completion", async () => {
109
+ const s = await enqueue("state");
110
+ expect(s.body).toMatchObject({ ok: true, status: "pending" });
111
+ expect(s.body.request_id).toMatch(/^sc_\d{13}_[A-Za-z0-9_-]{8,64}$/);
112
+ expect((await pull()).body.request).toMatchObject({ request_id: s.body.request_id, operation: "state", ...binding });
113
+ const observed = state();
114
+ expect((await ack(s.body.request_id, observed)).body.status).toBe("done");
115
+ expect((await read(s.body.request_id)).body.result).toEqual(observed);
116
+ const b = await enqueue();
117
+ expect(b.body.request_id).toMatch(/^bg_\d{13}_[A-Za-z0-9_-]{8,64}$/);
118
+ expect(b.body.expires_at).toBeGreaterThan(Date.now());
119
+ await pull();
120
+ const result = { outcome: "request_processed", state: state() };
121
+ expect((await ack(b.body.request_id, result)).body.status).toBe("done");
122
+ expect((await read(b.body.request_id)).body).toMatchObject({ ok: true, status: "done", result });
123
+ });
124
+ test("[2017 review] already_idle cannot confirm an active or background-capable state", async () => {
125
+ for (const flags of [
126
+ { active: true, can_request_background: true },
127
+ { active: true, can_request_background: false },
128
+ { active: false, can_request_background: true },
129
+ ]) {
130
+ const made = await enqueue(); await pull();
131
+ const reply = await ack(made.body.request_id, { outcome: "already_idle", state: { ...state(), ...flags } });
132
+ expect(reply.status).toBe(400);
133
+ expect(reply.body.error).toBe("session_control_invalid_response");
134
+ expect((await read(made.body.request_id)).body).toMatchObject({ status: "unknown", error: "session_control_invalid_response" });
135
+ }
136
+ });
137
+ test("[2017 review] legacy user atok owner/admin and global full can create and read control", async () => {
138
+ for (const t of [legacyOwner, legacyAdmin, legacyFull]) {
139
+ for (const operation of ["state", "background"]) {
140
+ const made = await api(t.token, root, { network_id: net, node_id: nodeId, operation, expected: binding });
141
+ expect(made.status).toBe(200);
142
+ expect((await read(made.body.request_id, t.token)).body.status).toBe("pending");
143
+ expect((await pull()).body.request.request_id).toBe(made.body.request_id);
144
+ const result = operation === "state" ? state() : { outcome: "request_processed", state: state() };
145
+ expect((await ack(made.body.request_id, result)).body.status).toBe("done");
146
+ expect((await read(made.body.request_id, t.token)).body.result).toEqual(result);
147
+ }
148
+ }
149
+ });
150
+ test("[2017 review] legacy atok still requires current target ownership and exact network", async () => {
151
+ for (const t of [legacyMember, legacyOutsider]) {
152
+ expect((await api(t.token, root, { network_id: net, node_id: nodeId, operation: "state" })).status).toBe(403);
153
+ }
154
+ expect((await api(legacyOwner.token, root, { network_id: otherNet, node_id: nodeId, operation: "state" })).status).toBe(403);
155
+ const made = await enqueue("state");
156
+ for (const t of [legacyMember, legacyOutsider]) expect((await read(made.body.request_id, t.token)).status).toBe(403);
157
+ expect((await read(made.body.request_id, legacyOwner.token, otherNet)).status).toBe(403);
158
+ });
159
+ test("[2017 review] legacy atok user and unbound network credentials cannot impersonate Bridge", async () => {
160
+ const made = await enqueue("state");
161
+ for (const t of [legacyOwner, legacyAdmin, legacyFull, legacyNetwork]) {
162
+ expect((await registerBridge(binding, t.token)).status).toBe(403);
163
+ expect((await pull(t.token)).status).toBe(403);
164
+ expect((await api(t.token, `${root}/${made.body.request_id}/ack`, { ...binding, status: "done", result: state() })).status).toBe(403);
165
+ }
166
+ expect((await read(made.body.request_id)).body.status).toBe("pending");
167
+ expect((await pull()).body.request.request_id).toBe(made.body.request_id);
168
+ });
169
+ test("[2017 review] unknown, revoked, expired or unsupported-scope credentials stay refused", async () => {
170
+ const request = () => api(legacyOwner.token, root, { network_id: net, node_id: nodeId, operation: "state" });
171
+ expect((await api("atok_00000000000000000000000000000000", root, {})).status).toBe(401);
172
+ for (const patch of ["revoked_at=datetime('now')", "expires_at=datetime('now','-1 day')", "scope='unsupported'"]) {
173
+ db.run(`UPDATE api_tokens SET ${patch} WHERE token_id=?1`, legacyOwner.token_id);
174
+ try { expect((await request()).status).toBeGreaterThanOrEqual(400); }
175
+ finally { db.run("UPDATE api_tokens SET revoked_at=NULL,expires_at=NULL,scope='user' WHERE token_id=?1", legacyOwner.token_id); }
176
+ }
177
+ expect((await request()).status).toBe(200);
178
+ });
179
+ test("SSE is a scoped doorbell only; the request lives in pull", async () => {
180
+ const abort = new AbortController();
181
+ const response = await fetch(`${base}/events/sc-target`, { headers: { authorization: `Bearer ${ntok.token}` }, signal: abort.signal });
182
+ expect(response.status).toBe(200);
183
+ const reader = response.body!.getReader();
184
+ try {
185
+ const made = await enqueue();
186
+ let data = "";
187
+ for (let i = 0; i < 4 && !data.includes('"type":"session_control"'); i++) {
188
+ const next = await reader.read(); data += new TextDecoder().decode(next.value);
189
+ }
190
+ const event = data.split("\n").filter(s => s.startsWith("data: ")).map(s => JSON.parse(s.slice(6))).find(s => s.type === "session_control");
191
+ expect(event).toEqual({ type: "session_control", request_id: made.body.request_id });
192
+ expect((await pull()).body.request.request_id).toBe(made.body.request_id);
193
+ } finally { abort.abort(); await reader.cancel().catch(() => {}); }
194
+ });
195
+ test("node, peer, anonymous, master and member cannot impersonate human owner/admin", async () => {
196
+ for (const token of [ntok.token, peer.token, "", "legacy-test-only", member.token, outsider.token]) {
197
+ expect((await api(token, root, { network_id: net, node_id: nodeId, operation: "state" })).status).toBeGreaterThanOrEqual(400);
198
+ }
199
+ const adminMade = await api(admin.token!, root, { network_id: net, node_id: nodeId, operation: "state" });
200
+ expect(adminMade.status).toBe(200);
201
+ expect((await read(adminMade.body.request_id, member.token!)).status).toBe(403);
202
+ expect((await read(adminMade.body.request_id, ntok.token!)).status).toBe(403);
203
+ expect((await read(adminMade.body.request_id, owner.token!, otherNet)).status).toBe(403);
204
+ });
205
+ test("cross-network, wrong expected, absent expected and command/path keys are refused", async () => {
206
+ expect((await enqueue("background", { network_id: otherNet })).status).toBe(403);
207
+ expect((await enqueue("background", { expected: { ...binding, session_id: "other_session" } })).body.error).toBe("session_control_changed");
208
+ expect((await api(owner.token!, root, { network_id: net, node_id: nodeId, operation: "background" })).status).toBe(400);
209
+ for (const key of ["url", "path", "keys", "shell"]) expect((await enqueue("state", { [key]: "unsafe" })).status).toBe(400);
210
+ expect((await registerBridge({ ...binding, node_id: peerId } as any)).status).toBe(400);
211
+ });
212
+ test("peer token and legacy unbound token never receive target requests", async () => {
213
+ const { createNetworkTokenForNode } = await import("./auth.js");
214
+ const legacy = createNetworkTokenForNode(owner.user.user_id, net, "sc-unbound");
215
+ expect(legacy.ok).toBe(true);
216
+ // Same-holder refreshes now bind existing rows. Construct an actual old
217
+ // unbound credential whose name only hints at this target instead.
218
+ db.run("UPDATE api_tokens SET name='node:sc-target' WHERE token_id=?1", legacy.token_id);
219
+ expect(db.get("SELECT bound_node_id FROM api_tokens WHERE token_id=?1", legacy.token_id).bound_node_id).toBeNull();
220
+ expect((await registerBridge(binding, legacy.token!)).status).toBe(403);
221
+ expect((await registerBridge(binding, owner.token!)).status).toBe(403);
222
+ const made = await enqueue();
223
+ expect((await pull(peer.token!)).body.request).toBeUndefined();
224
+ expect((await pull()).body.request.request_id).toBe(made.body.request_id);
225
+ expect((await api(peer.token!, `${root}/${made.body.request_id}/ack`, { ...binding, status: "done", result: state() })).status).toBe(409);
226
+ });
227
+ test("concurrent claims yield exactly one delivery and do not replay", async () => {
228
+ const made = await enqueue();
229
+ expect((await enqueue()).status).toBe(429);
230
+ const claims = await Promise.all([pull(), pull(), pull()]);
231
+ expect(claims.filter(r => r.body.request?.request_id === made.body.request_id)).toHaveLength(1);
232
+ expect((await read(made.body.request_id)).body.status).toBe("in_progress");
233
+ expect((await pull()).body.request).toBeNull();
234
+ });
235
+ test("expired pending request is never delivered", async () => {
236
+ const made = await enqueue();
237
+ setSystemTime(new Date(Date.now() + 16_000));
238
+ expect((await pull()).body.request).toBeNull();
239
+ expect((await read(made.body.request_id)).body.status).toBe("expired");
240
+ });
241
+ test("lost ACK becomes unknown, never success; late ACK and repeated pull cannot replay", async () => {
242
+ const made = await enqueue(); await pull();
243
+ setSystemTime(new Date(Date.now() + 16_000));
244
+ expect((await read(made.body.request_id)).body).toMatchObject({ status: "unknown", error: "session_background_outcome_unknown" });
245
+ expect((await ack(made.body.request_id, { outcome: "request_processed", state: state() })).status).toBe(409);
246
+ expect((await pull()).body.request).toBeNull();
247
+ });
248
+ test("new generation invalidates pending and cannot be overwritten by delayed old Bridge", async () => {
249
+ const old = { ...binding }, made = await enqueue();
250
+ binding = { session_id: "new_session", binding_id: `new_binding_${serial}` };
251
+ expect((await registerBridge()).status).toBe(200);
252
+ expect((await registerBridge(old)).body.error).toBe("session_control_changed");
253
+ expect((await pull(ntok.token!, old)).body.error).toBe("session_control_changed");
254
+ expect((await read(made.body.request_id)).body).toMatchObject({ status: "failed", error: "session_control_changed" });
255
+ expect((await pull()).body.request).toBeNull();
256
+ });
257
+ test("handle change after claim is unknown and old-session ACK cannot complete", async () => {
258
+ const old = { ...binding }, made = await enqueue(); await pull();
259
+ binding = { ...binding, binding_id: `changed_${serial}` }; await registerBridge();
260
+ expect((await api(ntok.token!, `${root}/${made.body.request_id}/ack`, { ...old, status: "done", result: { outcome: "already_idle", state: { ...state(), ...old } } })).status).toBe(409);
261
+ expect((await read(made.body.request_id)).body.status).toBe("unknown");
262
+ });
263
+ test("requester revocation before pull prevents delivery and current read permission is rechecked", async () => {
264
+ const made = await enqueue();
265
+ db.run("UPDATE network_members SET role='member' WHERE network_id=?1 AND user_id=?2", [net, owner.user.user_id]);
266
+ db.run("UPDATE nodes SET owner_user_id=?1 WHERE node_id=?2", [member.user.user_id, nodeId]);
267
+ try {
268
+ expect((await pull()).body.request).toBeNull();
269
+ expect((await read(made.body.request_id)).status).toBe(403);
270
+ expect((await read(made.body.request_id, admin.token!)).body.status).toBe("failed");
271
+ } finally { db.run("UPDATE nodes SET owner_user_id=?1 WHERE node_id=?2", [owner.user.user_id, nodeId]); }
272
+ });
273
+ test("target token revocation is checked at pull, not only registration", async () => {
274
+ const made = await enqueue();
275
+ db.run("UPDATE api_tokens SET revoked_at=datetime('now') WHERE token_id=?1", ntok.token_id);
276
+ try {
277
+ expect((await pull()).status).toBeGreaterThanOrEqual(400);
278
+ expect((await read(made.body.request_id)).body.status).toBe("failed");
279
+ } finally { db.run("UPDATE api_tokens SET revoked_at=NULL WHERE token_id=?1", ntok.token_id); }
280
+ });
281
+ test("malformed runtime results and raw exception strings never become success or leak", async () => {
282
+ const made = await enqueue(); await pull();
283
+ const reply = await ack(made.body.request_id, { outcome: "request_processed", state: { ...state(), binding_id: "wrong" } });
284
+ expect(reply.status).toBe(400);
285
+ expect((await read(made.body.request_id)).body).toMatchObject({ status: "unknown", error: "session_control_invalid_response" });
286
+ const next = await enqueue(); await pull();
287
+ const secret = "http://secret-host/?token=ntok_secret";
288
+ expect((await api(ntok.token!, `${root}/${next.body.request_id}/ack`, { ...binding, status: "failed", error: secret })).body.error).toBe("session_control_invalid_response");
289
+ expect(JSON.stringify((await read(next.body.request_id)).body)).not.toContain(secret);
290
+ });
291
+ test("known runtime refusal is failed; already_idle receipt is accepted", async () => {
292
+ const made = await enqueue(); await pull();
293
+ expect((await api(ntok.token!, `${root}/${made.body.request_id}/ack`, { ...binding, status: "failed", error: "session_control_unsupported" })).body.status).toBe("failed");
294
+ const next = await enqueue(); await pull();
295
+ expect((await ack(next.body.request_id, { outcome: "already_idle", state: { ...state(), active: false, can_request_background: false } })).body.status).toBe("done");
296
+ });
297
+ test("lease expiry refuses new work and Hub restart loses IDs without replay", async () => {
298
+ const made = await enqueue();
299
+ setSystemTime(new Date(Date.now() + 76_000));
300
+ // #2014: no live bridge is its own code, so a client can tell "this node has no
301
+ // bridge (upgrade / start it)" from a permission refusal.
302
+ expect((await enqueue()).body.error).toBe("session_control_bridge_missing");
303
+ setSystemTime();
304
+ server.stop(true);
305
+ const { bootServer } = await import("./server.js");
306
+ server = bootServer({ port: 0, hostname: "127.0.0.1" }); base = `http://127.0.0.1:${server.port}`;
307
+ expect((await read(made.body.request_id)).status).toBe(404);
308
+ expect((await pull()).body.error).toBe("session_control_changed");
309
+ });
310
+ });
@@ -0,0 +1,258 @@
1
+ import { randomBytes } from "node:crypto";
2
+ import { db } from "./db.js";
3
+ import { getUserNetworkRole, resolveToken, sessionIdleDays } from "./auth.js";
4
+ import { isAgentRestricted } from "./agent-access.js";
5
+ import { resolveNodeCaller } from "./create-node.js";
6
+ import { pushEvent } from "./push.js";
7
+
8
+ type Identity = { session_id: string; binding_id: string };
9
+ type Credential = { token_id: string; user_id: string; network_id: string | null;
10
+ bound_node_id: string | null; scope: string; role: string };
11
+ type Node = { node_id: string; network_id: string; owner_user_id: string | null; alias: string };
12
+ type Bridge = Identity & { tokenId: string; expires: number; retired: Set<string> };
13
+ type Entry = Identity & { request_id: string; operation: "state" | "background";
14
+ networkId: string; nodeId: string; tokenId: string; requester: string; expires_at: number;
15
+ status: "pending" | "in_progress" | "done" | "failed" | "unknown" | "expired";
16
+ result?: unknown; error?: string };
17
+ const TTL = 15_000, LEASE = 75_000, CAP = 1024, HISTORY = 64;
18
+ const ROOT = "/api/node-session-control";
19
+ const ID = /^[A-Za-z0-9][A-Za-z0-9_.:-]{0,199}$/;
20
+ const ERRORS = new Set(["unavailable", "changed", "unsupported", "invalid_response", "request_invalid",
21
+ "request_expired", "request_limit"].map(s => `session_control_${s}`).concat("session_background_outcome_unknown"));
22
+ const keys = (o: Record<string, unknown>, allowed: string[]) => Object.keys(o).every(k => allowed.includes(k));
23
+ const object = (v: unknown): v is Record<string, unknown> => !!v && typeof v === "object" && !Array.isArray(v);
24
+ const id = (v: unknown): v is string => typeof v === "string" && ID.test(v);
25
+ const identity = (v: unknown): v is Identity => object(v) && keys(v, ["session_id", "binding_id"])
26
+ && id(v.session_id) && id(v.binding_id);
27
+ const same = (a: Identity, b: Identity) => a.session_id === b.session_id && a.binding_id === b.binding_id;
28
+ const generation = (token: string, v: Identity) => JSON.stringify([token, v.session_id, v.binding_id]);
29
+ const fail = (error: string, status = 409) => Response.json({ ok: false, error }, { status });
30
+ const ok = (value: object) => Response.json({ ok: true, ...value });
31
+
32
+ // Recheck stored identities without storing plaintext bearer tokens. The SQL
33
+ // mirrors resolveToken's expiry/revoke/idle rules; membership is checked below.
34
+ function credential(tokenId: string): Credential | null {
35
+ const days = sessionIdleDays();
36
+ return db.get<Credential>(`SELECT t.token_id,t.user_id,t.network_id,t.bound_node_id,t.scope,u.role
37
+ FROM api_tokens t JOIN users u ON u.user_id=t.user_id WHERE t.token_id=?1
38
+ AND t.revoked_at IS NULL AND (t.expires_at IS NULL OR t.expires_at>datetime('now'))
39
+ AND NOT (t.scope='user' AND t.network_id IS NULL AND ?2>0
40
+ AND COALESCE(t.last_used_at,t.created_at)<datetime('now',?3))`,
41
+ tokenId, days, `-${Math.round(days * 86400)} seconds`) ?? null;
42
+ }
43
+ function node(nodeId: string): Node | null {
44
+ return db.get<Node>("SELECT node_id,network_id,owner_user_id,alias FROM nodes WHERE node_id=?1", nodeId) ?? null;
45
+ }
46
+ function isHumanCredential(c: Credential | null): c is Credential {
47
+ return !!c && c.network_id === null && c.bound_node_id === null
48
+ && (c.scope === "user" || c.scope === "full");
49
+ }
50
+ function human(tokenId: string, n: Node): boolean {
51
+ const c = credential(tokenId);
52
+ if (!isHumanCredential(c) || !n.network_id) return false;
53
+ const role = getUserNetworkRole(c.user_id, n.network_id);
54
+ return !!role && role !== "viewer" && !isAgentRestricted(c.user_id, n.network_id)
55
+ && (c.user_id === n.owner_user_id || role === "owner" || role === "admin" || c.role === "admin");
56
+ }
57
+ function bound(tokenId: string, n?: Node | null): Node | null {
58
+ const c = credential(tokenId);
59
+ if (!c?.bound_node_id || !c.network_id || c.scope !== "network") return null;
60
+ const target = n ?? node(c.bound_node_id);
61
+ if (!target || c.bound_node_id !== target.node_id || c.network_id !== target.network_id
62
+ || !getUserNetworkRole(c.user_id, c.network_id) || isAgentRestricted(c.user_id, c.network_id)) return null;
63
+ const caller = resolveNodeCaller(tokenId);
64
+ return caller.ok && caller.kind === "node" && caller.nodeId === target.node_id
65
+ && caller.networkId === target.network_id ? target : null;
66
+ }
67
+ async function body(req: Request): Promise<Record<string, unknown> | null> {
68
+ const reader = req.body?.getReader();
69
+ if (!reader) return null;
70
+ const chunks: Uint8Array[] = []; let size = 0;
71
+ try {
72
+ for (;;) {
73
+ const part = await reader.read(); if (part.done) break;
74
+ size += part.value.byteLength;
75
+ if (size > 8192) { await reader.cancel(); return null; }
76
+ chunks.push(part.value);
77
+ }
78
+ const v: unknown = JSON.parse(Buffer.concat(chunks).toString("utf8"));
79
+ return object(v) ? v : null;
80
+ } catch { return null; }
81
+ }
82
+ function state(value: unknown, e: Entry): boolean {
83
+ return object(value) && keys(value, ["session_id", "binding_id", "supported", "active", "can_request_background", "observed_at"])
84
+ && same(value as Identity, e) && typeof value.supported === "boolean" && typeof value.active === "boolean"
85
+ && typeof value.can_request_background === "boolean" && typeof value.observed_at === "number"
86
+ && Number.isFinite(value.observed_at) && value.observed_at > 0
87
+ && (!value.can_request_background || (value.supported && value.active));
88
+ }
89
+ function validResult(v: unknown, e: Entry): boolean {
90
+ if (e.operation === "state") return state(v, e);
91
+ return object(v) && keys(v, ["outcome", "state"])
92
+ && (v.outcome === "request_processed" || v.outcome === "already_idle") && state(v.state, e)
93
+ && (v.outcome !== "already_idle" || (object(v.state)
94
+ && v.state.active === false && v.state.can_request_background === false));
95
+ }
96
+
97
+ /** One finite, process-local relay per Hub boot. Restart loses requests (404),
98
+ * never replays them. Multi-worker deployments require process affinity.
99
+ * A claim authorizes one delivery, not proof that any tool moved to background.
100
+ */
101
+ export function createNodeSessionControlRelay() {
102
+ const bridges = new Map<string, Bridge>();
103
+ const entries = new Map<string, Entry>();
104
+ const key = (n: Node) => JSON.stringify([n.network_id, n.node_id]);
105
+ function close(e: Entry, error: string) {
106
+ e.status = e.status === "in_progress" ? "unknown" : "failed";
107
+ e.error = e.status === "unknown" ? "session_background_outcome_unknown" : error;
108
+ }
109
+ function refresh(e: Entry, now: number) {
110
+ if (e.status !== "pending" && e.status !== "in_progress") return;
111
+ if (now >= e.expires_at) {
112
+ e.status = e.status === "in_progress" ? "unknown" : "expired";
113
+ e.error = e.status === "unknown" ? "session_background_outcome_unknown" : "session_control_request_expired";
114
+ return;
115
+ }
116
+ const n = node(e.nodeId), b = n && bridges.get(key(n));
117
+ if (!n || n.network_id !== e.networkId || !human(e.requester, n) || !bound(e.tokenId, n)) {
118
+ close(e, "session_control_unavailable");
119
+ } else if (!b || b.expires <= now || b.tokenId !== e.tokenId || !same(b, e)) {
120
+ close(e, "session_control_changed");
121
+ }
122
+ }
123
+ function sweep(now: number) {
124
+ for (const [k, e] of entries) {
125
+ refresh(e, now);
126
+ if (now > e.expires_at + 60_000) entries.delete(k);
127
+ }
128
+ }
129
+ return async function handle(req: Request, url: URL): Promise<Response | null> {
130
+ if (url.pathname !== ROOT && !url.pathname.startsWith(`${ROOT}/`)) return null;
131
+ try {
132
+ // Header-only, persisted credential authority; no master/dev-open fallback.
133
+ const raw = req.headers.get("authorization")?.match(/^Bearer (\S+)$/)?.[1] ?? "";
134
+ const auth = resolveToken(raw);
135
+ if (!auth?.tokenId) return fail("session_control_unavailable", 401);
136
+ const tokenId = auth.tokenId;
137
+ const c = credential(tokenId);
138
+ if (!c) return fail("session_control_unavailable", 401);
139
+ const isHuman = isHumanCredential(c);
140
+ const isNode = c.scope === "network" && !!c.network_id;
141
+ const suffix = url.pathname.slice(ROOT.length);
142
+ if (req.method === "GET" && /^\/(bg|sc)_\d{13}_[A-Za-z0-9_-]{8,64}$/.test(suffix)) {
143
+ const e = entries.get(suffix.slice(1));
144
+ // Unknown/restarted Hub and unauthorized reads reveal no request data.
145
+ if (!isHuman) return fail("session_control_unavailable", 403);
146
+ if (!e) return fail("session_control_unavailable", 404);
147
+ const n = node(e.nodeId);
148
+ if (!n || url.searchParams.get("network_id") !== e.networkId || n.network_id !== e.networkId || !human(tokenId, n)) {
149
+ return fail("session_control_unavailable", 403);
150
+ }
151
+ refresh(e, Date.now());
152
+ return ok({ request_id: e.request_id, status: e.status,
153
+ ...(e.result === undefined ? {} : { result: e.result }), ...(e.error ? { error: e.error } : {}) });
154
+ }
155
+ if (req.method !== "POST") return fail("session_control_request_invalid", 405);
156
+ const v = await body(req);
157
+ if (!v) return fail("session_control_request_invalid", 400);
158
+ const now = Date.now();
159
+ if (suffix === "/bridge") {
160
+ if (!isNode) return fail("session_control_unavailable", 403);
161
+ if (!keys(v, ["session_id", "binding_id", "expected"]) || !id(v.session_id) || !id(v.binding_id)
162
+ || !object(v.expected) || !keys(v.expected, ["node_id", "network_id"])
163
+ || !id(v.expected.node_id) || !id(v.expected.network_id)) return fail("session_control_request_invalid", 400);
164
+ // Body reading is complete. This synchronous section rechecks authority
165
+ // and expected identity BEFORE sweep, retirement, or registration writes.
166
+ // expected is an assertion, never a source for binding or proof fields.
167
+ const c = credential(tokenId), n = bound(tokenId);
168
+ if (!c || !n) return fail("session_control_unavailable", 403);
169
+ if (c.bound_node_id !== n.node_id || c.network_id !== n.network_id
170
+ || v.expected.node_id !== c.bound_node_id || v.expected.network_id !== c.network_id) {
171
+ return fail("session_control_changed");
172
+ }
173
+ const registration = { session_id: v.session_id, binding_id: v.binding_id };
174
+ const k = key(n), b = bridges.get(k), g = generation(tokenId, registration);
175
+ if (b?.retired.has(g)) return fail("session_control_changed");
176
+ const replacing = b && (b.tokenId !== tokenId || !same(b, registration));
177
+ if ((replacing && b.retired.size >= HISTORY) || (!b && bridges.size >= CAP)) {
178
+ return fail("session_control_request_limit", 429);
179
+ }
180
+ sweep(now);
181
+ if (replacing) {
182
+ b.retired.add(generation(b.tokenId, b));
183
+ for (const e of entries.values()) if (e.nodeId === n.node_id && e.networkId === n.network_id
184
+ && (e.status === "pending" || e.status === "in_progress")) close(e, "session_control_changed");
185
+ }
186
+ bridges.set(k, { ...registration, tokenId, expires: now + LEASE, retired: b?.retired ?? new Set() });
187
+ return ok({ expires_at: now + LEASE,
188
+ identity: { node_id: c.bound_node_id, network_id: c.network_id, token_id: c.token_id } });
189
+ }
190
+ sweep(now);
191
+ if (!suffix) {
192
+ if (!isHuman) return fail("session_control_unavailable", 403);
193
+ if (!keys(v, ["network_id", "node_id", "operation", "expected"]) || !id(v.network_id) || !id(v.node_id)
194
+ || (v.operation !== "state" && v.operation !== "background")
195
+ || (v.expected !== undefined && !identity(v.expected)) || (v.operation === "background" && !identity(v.expected))) {
196
+ return fail("session_control_request_invalid", 400);
197
+ }
198
+ const n = node(v.node_id);
199
+ if (!n || n.network_id !== v.network_id || !human(tokenId, n)) return fail("session_control_unavailable", 403);
200
+ const b = bridges.get(key(n));
201
+ // A distinct code for "this node has no live bridge" (never registered, or
202
+ // its 75 s lease expired). #2014 needs it: the client can then say "upgrade
203
+ // the node / start it" instead of the generic "refresh later" it shows for
204
+ // `session_control_unavailable` (which also covers permission refusals).
205
+ if (!b || b.expires <= now || !bound(b.tokenId, n)) return fail("session_control_bridge_missing");
206
+ if (v.expected && !same(v.expected as Identity, b)) return fail("session_control_changed");
207
+ if (entries.size >= CAP || [...entries.values()].some(e => e.nodeId === n.node_id
208
+ && e.networkId === n.network_id && (e.status === "pending" || e.status === "in_progress"))) {
209
+ return fail("session_control_request_limit", 429);
210
+ }
211
+ const request_id = `${v.operation === "background" ? "bg" : "sc"}_${now}_${randomBytes(18).toString("base64url")}`;
212
+ entries.set(request_id, { session_id: b.session_id, binding_id: b.binding_id, request_id,
213
+ operation: v.operation, networkId: n.network_id, nodeId: n.node_id, tokenId: b.tokenId,
214
+ requester: tokenId, expires_at: now + TTL, status: "pending" });
215
+ pushEvent(n.alias, { type: "session_control", request_id }, n.network_id);
216
+ return ok({ request_id, status: "pending", expires_at: now + TTL });
217
+ }
218
+ if (!isNode) return fail("session_control_unavailable", 403);
219
+ const n = bound(tokenId);
220
+ if (!n) return fail("session_control_unavailable", 403);
221
+ const k = key(n), b = bridges.get(k);
222
+ if (!b || b.expires <= now || b.tokenId !== tokenId) return fail("session_control_changed");
223
+ if (suffix === "/pull") {
224
+ if (!identity(v)) return fail("session_control_request_invalid", 400);
225
+ if (!same(b, v)) return fail("session_control_changed");
226
+ const e = [...entries.values()].find(e => e.nodeId === n.node_id && e.networkId === n.network_id && e.status === "pending");
227
+ if (!e) return ok({ request: null });
228
+ refresh(e, now);
229
+ if (e.status !== "pending") return ok({ request: null });
230
+ // No await between authority recheck, claim, and response. Never requeue.
231
+ e.status = "in_progress";
232
+ return ok({ request: { request_id: e.request_id, operation: e.operation,
233
+ session_id: e.session_id, binding_id: e.binding_id, expires_at: e.expires_at } });
234
+ }
235
+ if (/^\/(bg|sc)_\d{13}_[A-Za-z0-9_-]{8,64}\/ack$/.test(suffix)) {
236
+ if (!keys(v, ["session_id", "binding_id", "status", "result", "error"]) || !id(v.session_id) || !id(v.binding_id)
237
+ || (v.status !== "done" && v.status !== "failed")) return fail("session_control_request_invalid", 400);
238
+ const e = entries.get(suffix.split("/")[1]);
239
+ if (!e) return fail("session_control_unavailable", 404);
240
+ if (e.nodeId !== n.node_id || e.networkId !== n.network_id || e.tokenId !== tokenId || !same(e, v as Identity)
241
+ || !same(b, e)) return fail("session_control_changed");
242
+ refresh(e, now);
243
+ if (e.status !== "in_progress") return fail("session_control_request_expired");
244
+ if (v.status === "done" && validResult(v.result, e) && v.error === undefined) {
245
+ e.status = "done"; e.result = v.result;
246
+ } else if (v.status === "failed" && typeof v.error === "string" && ERRORS.has(v.error) && v.result === undefined) {
247
+ e.status = "failed"; e.error = v.error;
248
+ } else {
249
+ // Invalid/untrusted runtime replies never become success or leak raw errors.
250
+ e.status = "unknown"; e.error = "session_control_invalid_response";
251
+ return fail(e.error, 400);
252
+ }
253
+ return ok({ request_id: e.request_id, status: e.status });
254
+ }
255
+ return fail("session_control_request_invalid", 404);
256
+ } catch { return fail("session_control_unavailable", 503); }
257
+ };
258
+ }