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

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
Files changed (417) hide show
  1. package/README.md +129 -9
  2. package/bin/commhub.ts +93 -9
  3. package/build-info.json +7 -0
  4. package/package.json +10 -8
  5. package/src/ack-create-request-transport.test.ts +182 -0
  6. package/src/ack-create-request.test.ts +52 -8
  7. package/src/admin-delete-network-http.test.ts +228 -0
  8. package/src/admin-networks-http.test.ts +88 -0
  9. package/src/adoption-candidates-http.test.ts +140 -0
  10. package/src/adoption-candidates.ts +158 -0
  11. package/src/agent-access-batch.test.ts +210 -0
  12. package/src/agent-access.ts +487 -0
  13. package/src/agent-acl-groups-http.test.ts +247 -0
  14. package/src/agent-acl-http.test.ts +675 -0
  15. package/src/agent-acl-slice3-http.test.ts +717 -0
  16. package/src/agent-department-http.test.ts +215 -0
  17. package/src/agent-groups-perf.test.ts +223 -0
  18. package/src/agent-notice.ts +48 -0
  19. package/src/agent-team-whoami-http.test.ts +98 -0
  20. package/src/agent-teams-http.test.ts +330 -0
  21. package/src/agent-teams.ts +244 -0
  22. package/src/alias-baseline-2571.test.ts +162 -0
  23. package/src/alias-baseline.ts +113 -0
  24. package/src/alias-filter.test.ts +72 -0
  25. package/src/alias-filter.ts +42 -0
  26. package/src/api-host-supervisors-can-create-nodes.test.ts +350 -0
  27. package/src/api-host-supervisors-fallback.test.ts +6 -7
  28. package/src/api-host-supervisors-runtime-readiness.test.ts +195 -0
  29. package/src/api-nodes-shape.test.ts +95 -4
  30. package/src/auth-password-change-cli-tokens-http.test.ts +423 -0
  31. package/src/auth-sessions-http.test.ts +260 -0
  32. package/src/auth-validate.test.ts +5 -1
  33. package/src/auth-weak-password-login.test.ts +176 -0
  34. package/src/auth.ts +609 -51
  35. package/src/avatar-validate.test.ts +52 -2
  36. package/src/avatar-validate.ts +35 -1
  37. package/src/backfill-node-ids-2664.test.ts +128 -0
  38. package/src/binding-generation-http.test.ts +132 -0
  39. package/src/blocked-exit-on-reply.test.ts +122 -0
  40. package/src/broadcast-fanout-2721.test.ts +149 -0
  41. package/src/broadcast-fanout.ts +117 -0
  42. package/src/build-info.test.ts +60 -0
  43. package/src/build-info.ts +85 -0
  44. package/src/chain-attempt-dedup.test.ts +447 -0
  45. package/src/clip.test.ts +36 -0
  46. package/src/clip.ts +48 -0
  47. package/src/clone-node.test.ts +262 -0
  48. package/src/clone-node.ts +289 -0
  49. package/src/codex-config-flags.ts +77 -0
  50. package/src/codex-fork-contract.ts +23 -0
  51. package/src/codex-fork-migration.test.ts +38 -0
  52. package/src/commhub-bin-args.test.ts +85 -0
  53. package/src/config-apply-validate.test.ts +188 -1
  54. package/src/config-apply-validate.ts +222 -3
  55. package/src/cors-origins.test.ts +73 -0
  56. package/src/create-node-blocked-gate.test.ts +356 -0
  57. package/src/create-node-network-id.test.ts +91 -0
  58. package/src/create-node-tool-schema.test.ts +49 -0
  59. package/src/create-node-unicode-name.test.ts +126 -0
  60. package/src/create-node-validate.test.ts +199 -7
  61. package/src/create-node-validate.ts +232 -15
  62. package/src/create-node-workdir.test.ts +298 -0
  63. package/src/create-node.ts +88 -23
  64. package/src/daemon-provider-snapshots.test.ts +445 -0
  65. package/src/daemon-provider-snapshots.ts +327 -0
  66. package/src/daemon-token-owner-http.test.ts +292 -0
  67. package/src/dashboard-slash-routing-http.test.ts +109 -0
  68. package/src/db-adapter-guard.test.ts +148 -0
  69. package/src/db-adapter-translate.test.ts +128 -0
  70. package/src/db-adapter.ts +377 -91
  71. package/src/db-timestamp.test.ts +38 -0
  72. package/src/db-timestamp.ts +15 -0
  73. package/src/db.ts +1264 -153
  74. package/src/delivered-without-push.test.ts +140 -0
  75. package/src/department-groups-http.test.ts +209 -0
  76. package/src/department-groups-sync-http.test.ts +328 -0
  77. package/src/department-groups.ts +434 -0
  78. package/src/department-heads-http.test.ts +350 -0
  79. package/src/department-heads.ts +226 -0
  80. package/src/departments-agent-count.test.ts +132 -0
  81. package/src/departments-http.test.ts +185 -0
  82. package/src/departments-mcp.test.ts +128 -0
  83. package/src/departments.ts +318 -0
  84. package/src/desktop-message-seam.test.ts +150 -0
  85. package/src/desktop-message.test.ts +368 -0
  86. package/src/dm-file-scope-http.test.ts +178 -0
  87. package/src/empty-node-sweeper.test.ts +104 -0
  88. package/src/empty-node-sweeper.ts +88 -0
  89. package/src/env-transport-gate-http.test.ts +240 -0
  90. package/src/env-transport-gate.ts +80 -0
  91. package/src/env-transport-policy.ts +56 -0
  92. package/src/etag-of.test.ts +57 -0
  93. package/src/event-loop-lag.test.ts +180 -0
  94. package/src/event-loop-lag.ts +201 -0
  95. package/src/expiry-counters.test.ts +111 -0
  96. package/src/expiry-counters.ts +93 -0
  97. package/src/ext-token-shared.test.ts +60 -0
  98. package/src/ext-validation-regression.test.ts +131 -0
  99. package/src/external-schedule-edits-http.test.ts +321 -0
  100. package/src/external-schedule-edits-timestamps.test.ts +64 -0
  101. package/src/external-schedule-edits.ts +327 -0
  102. package/src/file-download-authz-dev-open.test.ts +1 -1
  103. package/src/file-download-authz.test.ts +73 -18
  104. package/src/file-download-date-bucket.test.ts +8 -26
  105. package/src/file-network-scope-dev-open.test.ts +97 -0
  106. package/src/file-network-scope.test.ts +732 -0
  107. package/src/group-membership-events-http.test.ts +264 -0
  108. package/src/group-messages-http.test.ts +483 -0
  109. package/src/group-messages.ts +297 -0
  110. package/src/health-anon-readers.ts +60 -0
  111. package/src/health-host-disk-2756.test.ts +71 -0
  112. package/src/health-redaction.test.ts +1541 -7
  113. package/src/host-supervisor-identity-http.test.ts +152 -0
  114. package/src/host-supervisor-identity.ts +92 -0
  115. package/src/host-supervisors-daemon-version.test.ts +137 -0
  116. package/src/http-gzip.test.ts +94 -0
  117. package/src/http-gzip.ts +112 -0
  118. package/src/hub-catalog-read-http.test.ts +641 -0
  119. package/src/hub-provider-config.test.ts +166 -0
  120. package/src/hub-provider-config.ts +202 -0
  121. package/src/hub-timestamp.test.ts +38 -0
  122. package/src/hub-timestamp.ts +27 -0
  123. package/src/human-dm.ts +215 -0
  124. package/src/human-inbox.ts +42 -0
  125. package/src/inbox-caller.ts +49 -0
  126. package/src/inbox-count-sse.test.ts +310 -0
  127. package/src/inbox-count.ts +29 -0
  128. package/src/index.ts +6 -2
  129. package/src/license-state.test.ts +56 -0
  130. package/src/license-state.ts +48 -0
  131. package/src/list-host-supervisors.test.ts +15 -4
  132. package/src/mcp-context-cost-http.test.ts +127 -0
  133. package/src/mcp-inflight.test.ts +92 -0
  134. package/src/mcp-inflight.ts +38 -0
  135. package/src/mcp-projects-events-http.test.ts +165 -0
  136. package/src/mcp-route-label-http.test.ts +120 -0
  137. package/src/mcp-write-network-resolution.test.ts +435 -0
  138. package/src/member-audit-network-id-http.test.ts +93 -0
  139. package/src/member-presence-http.test.ts +210 -0
  140. package/src/messages-ack-by-agent-http.test.ts +142 -0
  141. package/src/migrate-sqlite-to-pg.test.ts +47 -0
  142. package/src/migrate-sqlite-to-pg.ts +263 -0
  143. package/src/model-auth-notify-http.test.ts +181 -0
  144. package/src/model-auth-notify.ts +116 -0
  145. package/src/network-name-http.test.ts +75 -0
  146. package/src/network-rules-http.test.ts +169 -0
  147. package/src/network-rules.ts +129 -0
  148. package/src/network-scope.ts +276 -0
  149. package/src/network-token-membership-http.test.ts +186 -0
  150. package/src/node-alias-control.ts +12 -0
  151. package/src/node-attrs.test.ts +47 -2
  152. package/src/node-caller-identity-http.test.ts +1108 -0
  153. package/src/node-create-request-status-http.test.ts +105 -0
  154. package/src/node-daemon-bindings.test.ts +132 -0
  155. package/src/node-daemon-bindings.ts +135 -0
  156. package/src/node-failure-alert.test.ts +150 -0
  157. package/src/node-failure-alert.ts +177 -0
  158. package/src/node-files-transport.test.ts +347 -0
  159. package/src/node-health-codex-login.test.ts +120 -0
  160. package/src/node-health-dispatch-http.test.ts +373 -0
  161. package/src/node-health-guard.ts +121 -0
  162. package/src/node-health-passthrough.test.ts +115 -0
  163. package/src/node-health-store.ts +101 -0
  164. package/src/node-id-alias.test.ts +190 -0
  165. package/src/node-identity-conflict-http.test.ts +269 -0
  166. package/src/node-identity-conflict.ts +142 -0
  167. package/src/node-identity-mismatch.test.ts +74 -0
  168. package/src/node-in-flight-tasks.ts +31 -0
  169. package/src/node-lifecycle-controllable.test.ts +64 -0
  170. package/src/node-lifecycle-controllable.ts +53 -0
  171. package/src/node-lifecycle-read-http.test.ts +257 -0
  172. package/src/node-lifecycle-read.ts +124 -0
  173. package/src/node-logs-transport.test.ts +263 -0
  174. package/src/node-peer-allowlist.test.ts +114 -0
  175. package/src/node-permissions-http.test.ts +728 -0
  176. package/src/node-permissions.ts +494 -0
  177. package/src/node-request-retention.test.ts +281 -0
  178. package/src/node-request-retention.ts +120 -0
  179. package/src/node-secret-rest-http.test.ts +190 -0
  180. package/src/node-serviceability.test.ts +86 -0
  181. package/src/node-serviceability.ts +124 -0
  182. package/src/node-session-control-http.test.ts +310 -0
  183. package/src/node-session-control.ts +258 -0
  184. package/src/node-skills-transport.test.ts +212 -0
  185. package/src/node-token-identity.ts +35 -0
  186. package/src/node-token-ownership.ts +51 -0
  187. package/src/node-token-privilege-http.test.ts +158 -0
  188. package/src/not-found-api-http.test.ts +67 -0
  189. package/src/observer-avatar-http.test.ts +102 -9
  190. package/src/observer-push.test.ts +76 -0
  191. package/src/opencode-catalog-report-http.test.ts +139 -0
  192. package/src/opencode-v2-catalog.test.ts +268 -0
  193. package/src/opencode-v2-catalog.ts +356 -0
  194. package/src/package-version-consistency.test.ts +25 -0
  195. package/src/parent-source-marker.test.ts +50 -0
  196. package/src/password-network-tokens.ts +25 -0
  197. package/src/peer-reply-atomic.test.ts +462 -0
  198. package/src/peer-reply-capability.test.ts +70 -0
  199. package/src/pg-worker.ts +87 -0
  200. package/src/poll-pacing.test.ts +74 -0
  201. package/src/poll-pacing.ts +123 -0
  202. package/src/project-dir-warn-clear-http.test.ts +132 -0
  203. package/src/project-viewer-can-http.test.ts +116 -0
  204. package/src/provider-tools-shape.test.ts +150 -0
  205. package/src/push.test.ts +20 -10
  206. package/src/push.ts +373 -9
  207. package/src/redact-tokens.test.ts +86 -0
  208. package/src/redact-tokens.ts +43 -0
  209. package/src/rejection-counters.test.ts +72 -0
  210. package/src/rejection-counters.ts +173 -0
  211. package/src/rename.ts +38 -10
  212. package/src/reply-target-derivation.test.ts +96 -0
  213. package/src/report-status-handover-capabilities-http.test.ts +124 -0
  214. package/src/report-status-host-schema.test.ts +235 -0
  215. package/src/report-status-resume-id-handover.test.ts +184 -0
  216. package/src/report-status-secret-keys.test.ts +140 -0
  217. package/src/require-explicit-test-db.ts +9 -0
  218. package/src/requirement-due-reminders-http.test.ts +620 -0
  219. package/src/requirement-due-reminders.ts +416 -0
  220. package/src/requirement-events-http.test.ts +318 -0
  221. package/src/requirement-events.test.ts +45 -0
  222. package/src/requirement-events.ts +144 -0
  223. package/src/requirement-notify.ts +165 -0
  224. package/src/requirement-participant-notify-http.test.ts +309 -0
  225. package/src/requirement-tag-ops-http.test.ts +454 -0
  226. package/src/requirement-tag-tree-http.test.ts +275 -0
  227. package/src/requirement-tag-tree.ts +127 -0
  228. package/src/requirement-tags.ts +102 -0
  229. package/src/requirements-abandoned-http.test.ts +236 -0
  230. package/src/requirements-assignee-drift.test.ts +154 -0
  231. package/src/requirements-comment-http.test.ts +174 -0
  232. package/src/requirements-completed-at-migration.test.ts +70 -0
  233. package/src/requirements-errors-mcp-http.test.ts +164 -0
  234. package/src/requirements-errors.ts +158 -0
  235. package/src/requirements-etag-http.test.ts +91 -0
  236. package/src/requirements-http.test.ts +709 -0
  237. package/src/requirements-last-event-http.test.ts +349 -0
  238. package/src/requirements-list-mcp-slim-http.test.ts +155 -0
  239. package/src/requirements-list-slim-http.test.ts +324 -0
  240. package/src/requirements-mcp.test.ts +164 -0
  241. package/src/requirements-migrate.ts +283 -0
  242. package/src/requirements-owner-strict-mcp-http.test.ts +145 -0
  243. package/src/requirements-people-http.test.ts +114 -0
  244. package/src/requirements-people-mcp-http.test.ts +231 -0
  245. package/src/requirements-people.ts +196 -0
  246. package/src/requirements-priority-lowest.test.ts +114 -0
  247. package/src/requirements-projects-network-echo.test.ts +57 -0
  248. package/src/requirements-projects-parent-http.test.ts +123 -0
  249. package/src/requirements-search-http.test.ts +182 -0
  250. package/src/requirements-search.test.ts +32 -0
  251. package/src/requirements-search.ts +145 -0
  252. package/src/requirements-seq-http.test.ts +193 -0
  253. package/src/requirements-seq-migration.test.ts +63 -0
  254. package/src/requirements-start-date.test.ts +125 -0
  255. package/src/requirements-stats-http.test.ts +357 -0
  256. package/src/requirements-stats.ts +195 -0
  257. package/src/requirements-status-participants-http.test.ts +222 -0
  258. package/src/requirements-upgrade-e2e.test.ts +126 -0
  259. package/src/requirements-upgrade-migration.test.ts +98 -0
  260. package/src/requirements.ts +2205 -0
  261. package/src/resolve-port.test.ts +57 -0
  262. package/src/resolve-port.ts +44 -0
  263. package/src/rest-alias-network-fallback-http.test.ts +123 -0
  264. package/src/rest-alias-network-fallback.test.ts +60 -0
  265. package/src/rest-alias-network-fallback.ts +65 -0
  266. package/src/rest-explicit-columns-http.test.ts +266 -0
  267. package/src/rest-identity.test.ts +130 -0
  268. package/src/rest-identity.ts +141 -0
  269. package/src/rest-projections.ts +72 -0
  270. package/src/rest-read-network-real-chain.test.ts +97 -0
  271. package/src/rest-write-network-resolution.test.ts +133 -0
  272. package/src/restart-readiness-http.test.ts +121 -0
  273. package/src/restricted-files.ts +76 -0
  274. package/src/retention-first-sweep-quiet.test.ts +31 -0
  275. package/src/retention.test.ts +100 -40
  276. package/src/retention.ts +423 -104
  277. package/src/route-callers-http.test.ts +120 -0
  278. package/src/route-timing.test.ts +218 -0
  279. package/src/route-timing.ts +262 -0
  280. package/src/rules-file-duplicate-alias.test.ts +234 -0
  281. package/src/rules-file-session-target.test.ts +207 -0
  282. package/src/rules-file-transport.test.ts +237 -0
  283. package/src/runtime-label.test.ts +22 -0
  284. package/src/runtime-label.ts +21 -0
  285. package/src/runtime-readiness.ts +90 -0
  286. package/src/schedule-agent-mcp-http.test.ts +475 -0
  287. package/src/schedule-agent.ts +252 -0
  288. package/src/schedule-starved.test.ts +92 -0
  289. package/src/schedule-starved.ts +114 -0
  290. package/src/scheduled-backoff-http.test.ts +203 -0
  291. package/src/scheduled-backoff.ts +64 -0
  292. package/src/scheduled-doorbell-nodeless-session.test.ts +134 -0
  293. package/src/scheduled-failure-backoff-2622.test.ts +145 -0
  294. package/src/scheduled-failure-code.test.ts +73 -0
  295. package/src/scheduled-failure-code.ts +105 -0
  296. package/src/scheduled-failures-http.test.ts +279 -0
  297. package/src/scheduled-failures.ts +425 -0
  298. package/src/scheduled-noprogress-backoff-2622.test.ts +163 -0
  299. package/src/scheduled-offline-backoff-probe.test.ts +56 -0
  300. package/src/scheduled-offline.test.ts +131 -0
  301. package/src/scheduled-offline.ts +66 -0
  302. package/src/scheduled-outcome-guidance-http.test.ts +139 -0
  303. package/src/scheduled-outcome-guidance.ts +9 -0
  304. package/src/scheduled-reply-unread-http.test.ts +212 -0
  305. package/src/scheduled-requirement-wake-http.test.ts +285 -0
  306. package/src/scheduled-requirement-wake.ts +125 -0
  307. package/src/scheduled-run-terminal.test.ts +290 -0
  308. package/src/scheduled-skip-blocking-task.test.ts +120 -0
  309. package/src/scheduled-skip-path-backoff-2622.test.ts +98 -0
  310. package/src/scheduled-stuck-http.test.ts +316 -0
  311. package/src/scheduled-stuck-notice-cap.test.ts +80 -0
  312. package/src/scheduled-stuck.ts +219 -0
  313. package/src/scheduled-tasks-http.test.ts +679 -0
  314. package/src/scheduled-tasks.ts +959 -0
  315. package/src/scheduled-work-outcome-http.test.ts +154 -0
  316. package/src/scheduled-work-outcome.ts +50 -0
  317. package/src/scoped-secrets.ts +141 -0
  318. package/src/secret-echo-negative-control.test.ts +118 -0
  319. package/src/send-dedup-request-id.test.ts +229 -0
  320. package/src/send-reply-agent-warning.test.ts +38 -38
  321. package/src/send-reply-alias-optional.test.ts +131 -0
  322. package/src/send-reply-attachments.test.ts +458 -0
  323. package/src/send_dedup.test.ts +54 -0
  324. package/src/send_dedup.ts +52 -6
  325. package/src/serve-error.test.ts +73 -0
  326. package/src/serve-error.ts +56 -0
  327. package/src/server.ts +5134 -503
  328. package/src/session-task-on-dispatch.ts +14 -0
  329. package/src/session-token-ownership-http.test.ts +122 -0
  330. package/src/shared/codex-inventory.ts +41 -0
  331. package/src/shared/daemon-provider-login.ts +31 -0
  332. package/src/shared/daemon-provider-snapshot.ts +52 -0
  333. package/src/shared/external-schedule-contract.ts +60 -0
  334. package/src/shared/node-name.test.ts +62 -0
  335. package/src/shared/node-name.ts +161 -0
  336. package/src/shared/probe-host-allowlist-drift.test.ts +45 -0
  337. package/src/shared/provider-application.ts +29 -0
  338. package/src/shared/provider-collection.ts +14 -0
  339. package/src/shared/provider-initialization.ts +8 -0
  340. package/src/shared/reserved-env-drift.test.ts +10 -0
  341. package/src/shared/scoped-secret-contract.ts +5 -0
  342. package/src/shared/task-content-limit-drift.test.ts +28 -0
  343. package/src/shared/task-content-limit.ts +25 -0
  344. package/src/side-thread-command-transport.test.ts +312 -0
  345. package/src/side-thread-command-transport.ts +318 -0
  346. package/src/side-thread-http-integration.test.ts +233 -0
  347. package/src/side-thread-http.ts +504 -0
  348. package/src/side-thread-production.test.ts +72 -0
  349. package/src/side-thread-production.ts +118 -0
  350. package/src/side-thread.test.ts +1067 -0
  351. package/src/side-thread.ts +2499 -0
  352. package/src/skillhub-http.test.ts +142 -0
  353. package/src/sqlite-close-checkpoint.test.ts +78 -0
  354. package/src/start-node.test.ts +265 -0
  355. package/src/stats-versions-http.test.ts +65 -0
  356. package/src/status-alias-filter-http.test.ts +106 -0
  357. package/src/status-alias-resolver-http.test.ts +163 -0
  358. package/src/status-alias-resolver.ts +19 -0
  359. package/src/status-node-id-filter-http.test.ts +161 -0
  360. package/src/status-read-cache-http.test.ts +229 -0
  361. package/src/status-read-cache.ts +129 -0
  362. package/src/stop-delete-node.test.ts +567 -1
  363. package/src/task-access-http.test.ts +402 -0
  364. package/src/task-access.ts +420 -0
  365. package/src/task-activity.ts +60 -0
  366. package/src/task-auth-origin-http.test.ts +93 -0
  367. package/src/task-auth-origin.test.ts +24 -0
  368. package/src/task-auth-origin.ts +7 -0
  369. package/src/task-consumption.test.ts +498 -0
  370. package/src/task-diagnostic-http.test.ts +149 -0
  371. package/src/task-diagnostic.test.ts +115 -0
  372. package/src/task-diagnostic.ts +118 -0
  373. package/src/task-expiry-notice-http.test.ts +287 -0
  374. package/src/task-expiry-notice.ts +318 -0
  375. package/src/task-idempotency-mcp.test.ts +142 -0
  376. package/src/task-idempotency.test.ts +76 -0
  377. package/src/task-idempotency.ts +81 -0
  378. package/src/task-late-replies.ts +54 -0
  379. package/src/task-late-reply-http.test.ts +227 -0
  380. package/src/task-lifecycle-watcher-busy.test.ts +114 -0
  381. package/src/task-lifecycle-watcher.test.ts +209 -0
  382. package/src/task-lifecycle-watcher.ts +109 -0
  383. package/src/task-network-resolution-http.test.ts +140 -0
  384. package/src/task-offline-delivery-2668.test.ts +119 -0
  385. package/src/task-offline-delivery.ts +81 -0
  386. package/src/task-orphan-http.test.ts +287 -0
  387. package/src/task-orphan.ts +119 -0
  388. package/src/task-queue-ahead-http.test.ts +309 -0
  389. package/src/task-queue-ahead-scale.test.ts +236 -0
  390. package/src/task-queue-ahead.ts +186 -0
  391. package/src/task-rejection-log-http.test.ts +160 -0
  392. package/src/task-rejection-log.ts +61 -0
  393. package/src/task-sender-http.test.ts +143 -0
  394. package/src/task-stale-open-http.test.ts +292 -0
  395. package/src/task-stale-open.ts +103 -0
  396. package/src/tasks-pagination-http.test.ts +141 -0
  397. package/src/team-rules-status-http.test.ts +90 -0
  398. package/src/team-rules-status.test.ts +59 -0
  399. package/src/team-rules-status.ts +72 -0
  400. package/src/tmux-allowlist.test.ts +48 -0
  401. package/src/tool-audience-http.test.ts +230 -0
  402. package/src/tool-audience.ts +127 -0
  403. package/src/tools-list-json-schema.test.ts +94 -0
  404. package/src/tools.ts +4326 -420
  405. package/src/upload-early-reject-guard.test.ts +155 -0
  406. package/src/uploads-http.test.ts +86 -7
  407. package/src/uploads.ts +38 -4
  408. package/src/user-avatar-http.test.ts +74 -0
  409. package/src/user-avatar-image.ts +160 -0
  410. package/src/user-avatar-migration.test.ts +25 -0
  411. package/src/user-avatar-upload-http.test.ts +348 -0
  412. package/src/user-inbox-by-agent-http.test.ts +165 -0
  413. package/src/user-inbox-netid-notnull.test.ts +122 -0
  414. package/src/user-inbox-read-http.test.ts +223 -0
  415. package/src/user-inbox-schema.test.ts +54 -0
  416. package/src/version-stats.test.ts +66 -0
  417. package/src/version-stats.ts +109 -0
@@ -0,0 +1,86 @@
1
+ // #2880 —— 节点级「不可服务」检测(默认关闭,只记录)。
2
+ import { describe, expect, test, beforeAll, afterAll } from "bun:test";
3
+ import { db } from "./db.js";
4
+ import { isNotServing, scanNodeBusyCircuit, nodeCanAcceptDispatch, circuitEnabled } from "./node-serviceability.js";
5
+
6
+ const NET = "net_circuit";
7
+
8
+ // 🔴 scheduled_task_runs 上有 UNIQUE(schedule_id, scheduled_for):
9
+ // 用 INSERT OR REPLACE 且 scheduled_for 相同 ⇒ 后一行会**替换**前一行,
10
+ // 于是 6 条「忙类失败」最后只剩 1 条,判据永远不成立。每条用不同的 minute 偏移。
11
+ function mkTaskAndRun(taskId: string, alias: string, status: string, result: string | null, runStatus: string, errorCode: string | null, minuteOffset = 0) {
12
+ db.run(
13
+ `INSERT OR REPLACE INTO tasks (task_id, content, from_name, to_name, network_id, status, result, created_at, completed_at)
14
+ VALUES (?1, 'x', 'hub', ?2, ?3, ?4, ?5, datetime('now'), datetime('now'))`,
15
+ [taskId, alias, NET, status, result],
16
+ );
17
+ db.run(
18
+ `INSERT OR REPLACE INTO scheduled_task_runs (run_id, schedule_id, network_id, scheduled_for, task_id, status, error_code, created_at)
19
+ VALUES (?1, 'sched_x', ?2, datetime('now', ?3), ?4, ?5, ?6, datetime('now'))`,
20
+ [`run_${taskId}`, NET, `-${minuteOffset + 1} minutes`, taskId, runStatus, errorCode],
21
+ );
22
+ }
23
+
24
+ const BUSY = "[n] opencode 任务未提交:共享会话在 30 分钟 内一直处于忙碌状态";
25
+
26
+ describe("节点忙熔断:三项判据", () => {
27
+ beforeAll(() => {
28
+ db.run("DELETE FROM scheduled_task_runs WHERE network_id = ?1", [NET]);
29
+ db.run("DELETE FROM tasks WHERE network_id = ?1", [NET]);
30
+ });
31
+ afterAll(() => {
32
+ db.run("DELETE FROM scheduled_task_runs WHERE network_id = ?1", [NET]);
33
+ db.run("DELETE FROM tasks WHERE network_id = ?1", [NET]);
34
+ delete process.env.COMMHUB_NODE_BUSY_CIRCUIT;
35
+ });
36
+
37
+ test("纯判定:忙类失败够多 + 零成功 + 有投递 ⇒ 不可服务", () => {
38
+ expect(isNotServing({ delivered: 10, replied: 0, busy_failed: 5 }, 5)).toBe(true);
39
+ expect(isNotServing({ delivered: 10, replied: 1, busy_failed: 9 }, 5)).toBe(false); // 成功过 = 等得到
40
+ expect(isNotServing({ delivered: 4, replied: 0, busy_failed: 4 }, 5)).toBe(false); // 证据不够
41
+ expect(isNotServing({ delivered: 0, replied: 0, busy_failed: 0 }, 5)).toBe(false); // 没投递过 ≠ 不可服务
42
+ });
43
+
44
+ test("扫描能把「零产出节点」挑出来,且有成功的节点不受影响", () => {
45
+ for (let i = 0; i < 6; i++) mkTaskAndRun(`t_bh_${i}`, "黑洞节点", "failed", BUSY, "failed", null, i);
46
+ for (let i = 0; i < 6; i++) mkTaskAndRun(`t_ok_${i}`, "正常节点", i < 3 ? "replied" : "failed", i < 3 ? "done" : BUSY, i < 3 ? "replied" : "failed", null, i + 10);
47
+ const r = scanNodeBusyCircuit();
48
+ expect(r.tripped).toContain("黑洞节点");
49
+ expect(r.tripped).not.toContain("正常节点");
50
+ expect(r.enabled).toBe(false); // 默认关闭
51
+ });
52
+
53
+ // 熔断后不能「永不投递」:否则节点拿不到成功记录 ⇒ 永远解不开(死锁)。
54
+ test("熔断期间按探针间隔放行一条(自愈通道)", () => {
55
+ process.env.COMMHUB_NODE_BUSY_CIRCUIT = "1";
56
+ // 黑洞节点:刚投递过 ⇒ 拦
57
+ db.run(`INSERT INTO tasks (task_id, content, from_name, to_name, network_id, status, created_at)
58
+ VALUES ('t_probe_now','x','hub','黑洞节点',?1,'failed',datetime('now'))`, [NET]);
59
+ const blocked = nodeCanAcceptDispatch("黑洞节点", NET);
60
+ expect(blocked.ok).toBe(false);
61
+ expect(blocked.probe).toBeUndefined();
62
+ // 把最近投递推到 2 小时前(默认探针间隔 1h)⇒ 放行,且标记 probe
63
+ // 注意:前面的用例也给这个节点插过 created_at=now 的任务,MAX(created_at) 会取到它们
64
+ db.run("UPDATE tasks SET created_at = datetime('now','-2 hours') WHERE to_name = '黑洞节点'");
65
+ const probe = nodeCanAcceptDispatch("黑洞节点", NET);
66
+ expect(probe.ok).toBe(true);
67
+ expect(probe.probe).toBe(true);
68
+ // 还原,避免影响后续用例(它们依赖「最近刚投递过」这个前态)
69
+ db.run("UPDATE tasks SET created_at = datetime('now') WHERE to_name = '黑洞节点'");
70
+ });
71
+
72
+ test("默认关闭时投递判断恒放行(不改任何既有行为)", () => {
73
+ delete process.env.COMMHUB_NODE_BUSY_CIRCUIT;
74
+ expect(circuitEnabled()).toBe(false);
75
+ expect(nodeCanAcceptDispatch("黑洞节点", NET).ok).toBe(true);
76
+ });
77
+
78
+ test("开启后才拦:黑洞节点被拒,正常节点仍放行", () => {
79
+ process.env.COMMHUB_NODE_BUSY_CIRCUIT = "1";
80
+ const bad = nodeCanAcceptDispatch("黑洞节点", NET);
81
+ expect(bad.ok).toBe(false);
82
+ expect(bad.reason ?? "").toContain("忙类失败");
83
+ expect(nodeCanAcceptDispatch("正常节点", NET).ok).toBe(true);
84
+ expect(nodeCanAcceptDispatch("不存在的节点", NET).ok).toBe(true); // 没数据就不拦
85
+ });
86
+ });
@@ -0,0 +1,124 @@
1
+ // #2880 —— 节点级「不可服务」检测。
2
+ //
3
+ // 生产 24h(2026-10-28 按节点统计定时任务产出):
4
+ // TMA云盘欧 ok= 0 busy=35 ← 全天零产出
5
+ // 通信客户端欧 ok= 22 busy=17 ← 等得到
6
+ // TMA需求欧 ok=140 busy=13 ← 等得到
7
+ // 通信欧 ok=192 busy= 0
8
+ //
9
+ // 结论:**「忙就快速失败」不能全局开**(会打掉别人等得到的那批成功),
10
+ // 但**节点级**的判断是安全的 —— 一个节点在窗口内「忙类失败很多、成功为零」,
11
+ // 才是「现在投进去必然白等 30 分钟」。
12
+ //
13
+ // 判据(三项同时成立,缺一不可):
14
+ // 1. 窗口内忙类失败 >= MIN_FAILS(默认 5)—— 证据量够
15
+ // 2. 窗口内成功 == 0 —— 不是「忙但能干成」
16
+ // 3. 窗口内至少有一次投递 —— 不会把「今天没排程」误判成不可服务
17
+ //
18
+ // 默认只记录(不改变任何派发行为)。开启 COMMHUB_NODE_BUSY_CIRCUIT=1 才把
19
+ // 「暂不投递」用于排程派发 —— 这一步是行为变更,所以留给人开。
20
+ import { db } from "./db.js";
21
+
22
+ function envInt(name: string, fallback: number, min: number): number {
23
+ const raw = process.env[name];
24
+ if (raw === undefined || raw.trim() === "") return fallback;
25
+ const n = Number(raw);
26
+ return Number.isFinite(n) && n >= min ? Math.floor(n) : fallback;
27
+ }
28
+
29
+ export function circuitEnabled(): boolean {
30
+ return String(process.env.COMMHUB_NODE_BUSY_CIRCUIT ?? "").trim() === "1";
31
+ }
32
+ export function circuitWindowHours(): number { return envInt("COMMHUB_NODE_BUSY_CIRCUIT_HOURS", 6, 1); }
33
+ export function circuitMinFails(): number { return envInt("COMMHUB_NODE_BUSY_CIRCUIT_FAILS", 5, 1); }
34
+ /**
35
+ * 熔断期间**放探针**的间隔(小时)。
36
+ *
37
+ * 🔴 为什么必须有:熔断后完全不再投递 ⇒ 节点永远拿不到成功记录 ⇒ 永远解不开(死锁)。
38
+ * 所以每 N 小时放一条探针任务:它若成功,replied 计数不再为 0,熔断自动解除。
39
+ */
40
+ export function circuitProbeHours(): number { return envInt("COMMHUB_NODE_BUSY_CIRCUIT_PROBE_HOURS", 1, 1); }
41
+
42
+ /** 该节点最近一次**被投递**的时刻(ms)。没有投递过返回 null。 */
43
+ function lastDeliveryMs(alias: string, networkId: string | null): number | null {
44
+ try {
45
+ const row = db.get<{ t: string | null }>(
46
+ "SELECT MAX(created_at) AS t FROM tasks WHERE to_name = ?1 AND (?2 IS NULL OR network_id = ?2)",
47
+ alias, networkId,
48
+ );
49
+ if (!row?.t) return null;
50
+ const ms = Date.parse(String(row.t).replace(" ", "T") + "Z");
51
+ return Number.isFinite(ms) ? ms : null;
52
+ } catch {
53
+ return null;
54
+ }
55
+ }
56
+
57
+ export type NodeServingStats = { alias: string; network_id: string | null; delivered: number; replied: number; busy_failed: number };
58
+
59
+ /** 纯函数:三项判据同时成立才算「不可服务」。 */
60
+ export function isNotServing(
61
+ s: { delivered: number; replied: number; busy_failed: number },
62
+ minFails = circuitMinFails(),
63
+ ): boolean {
64
+ return s.busy_failed >= minFails && s.replied === 0 && s.delivered > 0;
65
+ }
66
+
67
+ export type CircuitScanResult = { tripped: string[]; enabled: boolean; windowHours: number };
68
+
69
+ export function scanNodeBusyCircuit(now = new Date()): CircuitScanResult {
70
+ const windowHours = circuitWindowHours();
71
+ const since = new Date(now.getTime() - windowHours * 3_600_000).toISOString().slice(0, 19).replace("T", " ");
72
+ const rows = db.all<{ alias: string; network_id: string | null; delivered: number; replied: number; busy_failed: number }>(
73
+ `SELECT t.to_name AS alias,
74
+ t.network_id AS network_id,
75
+ COUNT(*) AS delivered,
76
+ SUM(CASE WHEN r.status = 'replied' THEN 1 ELSE 0 END) AS replied,
77
+ SUM(CASE WHEN r.status = 'failed'
78
+ AND (r.error_code = 'task_failed_busy' OR t.result LIKE '%共享会话%')
79
+ THEN 1 ELSE 0 END) AS busy_failed
80
+ FROM scheduled_task_runs r
81
+ JOIN tasks t ON t.task_id = r.task_id
82
+ WHERE r.created_at >= ?1 AND t.to_name IS NOT NULL
83
+ GROUP BY t.to_name, t.network_id`,
84
+ since,
85
+ );
86
+ const tripped = rows.filter((r) => isNotServing(r)).map((r) => r.alias);
87
+ return { tripped, enabled: circuitEnabled(), windowHours };
88
+ }
89
+
90
+ /**
91
+ * 这个节点现在能不能投递。默认永远 true(未开启 = 不拦截)。
92
+ * 供排程派发判断;纯读,不改任何状态。
93
+ */
94
+ export function nodeCanAcceptDispatch(alias: string, networkId: string | null): { ok: boolean; reason?: string; busy_failed?: number; probe?: boolean } {
95
+ if (!circuitEnabled()) return { ok: true };
96
+ const windowHours = circuitWindowHours();
97
+ const since = new Date(Date.now() - windowHours * 3_600_000).toISOString().slice(0, 19).replace("T", " ");
98
+ const row = db.get<{ delivered: number; replied: number; busy_failed: number }>(
99
+ `SELECT COUNT(*) AS delivered,
100
+ SUM(CASE WHEN r.status = 'replied' THEN 1 ELSE 0 END) AS replied,
101
+ SUM(CASE WHEN r.status = 'failed'
102
+ AND (r.error_code = 'task_failed_busy' OR t.result LIKE '%共享会话%')
103
+ THEN 1 ELSE 0 END) AS busy_failed
104
+ FROM scheduled_task_runs r
105
+ JOIN tasks t ON t.task_id = r.task_id
106
+ WHERE r.created_at >= ?1 AND t.to_name = ?2
107
+ AND (?3 IS NULL OR t.network_id = ?3)`,
108
+ since, alias, networkId,
109
+ );
110
+ if (!row) return { ok: true };
111
+ const stats = { delivered: Number(row.delivered ?? 0), replied: Number(row.replied ?? 0), busy_failed: Number(row.busy_failed ?? 0) };
112
+ if (!isNotServing(stats)) return { ok: true };
113
+ // 熔断期间每 N 小时放一条探针,否则节点永远拿不到成功记录、永远解不开。
114
+ const probeHours = circuitProbeHours();
115
+ const last = lastDeliveryMs(alias, networkId);
116
+ if (last === null || Date.now() - last >= probeHours * 3_600_000) {
117
+ return { ok: true, probe: true, busy_failed: stats.busy_failed };
118
+ }
119
+ return {
120
+ ok: false,
121
+ reason: `节点近 ${windowHours}h 内 ${stats.busy_failed} 次忙类失败、0 次成功(投递也只会白等),已跳过`,
122
+ busy_failed: stats.busy_failed,
123
+ };
124
+ }
@@ -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
+ });