@sleep2agi/commhub-server 0.9.0-preview.2 → 0.9.0-preview.200

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 (412) hide show
  1. package/README.md +130 -10
  2. package/bin/commhub.ts +99 -11
  3. package/package.json +7 -7
  4. package/src/ack-create-request-transport.test.ts +182 -0
  5. package/src/ack-create-request.test.ts +374 -0
  6. package/src/admin-delete-network-http.test.ts +228 -0
  7. package/src/admin-networks-http.test.ts +88 -0
  8. package/src/adoption-candidates-http.test.ts +137 -0
  9. package/src/adoption-candidates.ts +158 -0
  10. package/src/agent-access-batch.test.ts +210 -0
  11. package/src/agent-access.ts +487 -0
  12. package/src/agent-acl-groups-http.test.ts +247 -0
  13. package/src/agent-acl-http.test.ts +659 -0
  14. package/src/agent-acl-slice3-http.test.ts +267 -0
  15. package/src/agent-department-http.test.ts +215 -0
  16. package/src/agent-groups-perf.test.ts +223 -0
  17. package/src/agent-notice.ts +48 -0
  18. package/src/agent-team-whoami-http.test.ts +98 -0
  19. package/src/agent-teams-http.test.ts +330 -0
  20. package/src/agent-teams.ts +244 -0
  21. package/src/alias-baseline-2571.test.ts +162 -0
  22. package/src/alias-baseline.ts +113 -0
  23. package/src/alias-filter.test.ts +72 -0
  24. package/src/alias-filter.ts +42 -0
  25. package/src/api-host-supervisors-can-create-nodes.test.ts +350 -0
  26. package/src/api-host-supervisors-fallback.test.ts +271 -0
  27. package/src/api-host-supervisors-runtime-readiness.test.ts +195 -0
  28. package/src/api-nodes-shape.test.ts +279 -0
  29. package/src/auth-password-change-cli-tokens-http.test.ts +423 -0
  30. package/src/auth-sessions-http.test.ts +250 -0
  31. package/src/auth-validate.test.ts +5 -1
  32. package/src/auth-weak-password-login.test.ts +176 -0
  33. package/src/auth.ts +611 -51
  34. package/src/avatar-validate.test.ts +163 -0
  35. package/src/avatar-validate.ts +103 -0
  36. package/src/backfill-node-ids-2664.test.ts +128 -0
  37. package/src/binding-generation-http.test.ts +121 -0
  38. package/src/blocked-exit-on-reply.test.ts +122 -0
  39. package/src/boot-side-effect.test.ts +124 -0
  40. package/src/broadcast-fanout-2721.test.ts +118 -0
  41. package/src/broadcast-fanout.ts +98 -0
  42. package/src/chain-attempt-dedup.test.ts +447 -0
  43. package/src/clone-node.test.ts +248 -0
  44. package/src/clone-node.ts +289 -0
  45. package/src/codex-config-flags.ts +77 -0
  46. package/src/codex-fork-contract.ts +23 -0
  47. package/src/codex-fork-migration.test.ts +38 -0
  48. package/src/commhub-bin-args.test.ts +85 -0
  49. package/src/config-apply-sec1.test.ts +107 -0
  50. package/src/config-apply-validate.test.ts +134 -1
  51. package/src/config-apply-validate.ts +111 -5
  52. package/src/create-node-blocked-gate.test.ts +356 -0
  53. package/src/create-node-network-id.test.ts +79 -0
  54. package/src/create-node-tool-schema.test.ts +49 -0
  55. package/src/create-node-unicode-name.test.ts +120 -0
  56. package/src/create-node-validate.test.ts +379 -0
  57. package/src/create-node-validate.ts +423 -0
  58. package/src/create-node-workdir.test.ts +289 -0
  59. package/src/create-node.test.ts +354 -0
  60. package/src/create-node.ts +411 -0
  61. package/src/daemon-provider-snapshots.test.ts +421 -0
  62. package/src/daemon-provider-snapshots.ts +327 -0
  63. package/src/daemon-token-owner-http.test.ts +236 -0
  64. package/src/dashboard-slash-routing-http.test.ts +109 -0
  65. package/src/db-adapter-guard.test.ts +148 -0
  66. package/src/db-adapter-translate.test.ts +128 -0
  67. package/src/db-adapter.ts +377 -91
  68. package/src/db-timestamp.test.ts +38 -0
  69. package/src/db-timestamp.ts +15 -0
  70. package/src/db.ts +1501 -152
  71. package/src/delivered-without-push.test.ts +140 -0
  72. package/src/department-groups-http.test.ts +209 -0
  73. package/src/department-groups-sync-http.test.ts +328 -0
  74. package/src/department-groups.ts +434 -0
  75. package/src/department-heads-http.test.ts +330 -0
  76. package/src/department-heads.ts +226 -0
  77. package/src/departments-agent-count.test.ts +129 -0
  78. package/src/departments-http.test.ts +185 -0
  79. package/src/departments-mcp.test.ts +128 -0
  80. package/src/departments.ts +318 -0
  81. package/src/desktop-message-seam.test.ts +150 -0
  82. package/src/desktop-message.test.ts +368 -0
  83. package/src/dm-file-scope-http.test.ts +178 -0
  84. package/src/empty-node-sweeper.test.ts +104 -0
  85. package/src/empty-node-sweeper.ts +88 -0
  86. package/src/env-transport-gate-http.test.ts +177 -0
  87. package/src/env-transport-gate.ts +74 -0
  88. package/src/env-transport-policy.ts +21 -0
  89. package/src/event-loop-lag.test.ts +139 -0
  90. package/src/event-loop-lag.ts +150 -0
  91. package/src/ext-token-shared.test.ts +60 -0
  92. package/src/ext-validation-regression.test.ts +131 -0
  93. package/src/external-schedule-edits-http.test.ts +321 -0
  94. package/src/external-schedule-edits-timestamps.test.ts +64 -0
  95. package/src/external-schedule-edits.ts +327 -0
  96. package/src/file-download-authz-dev-open.test.ts +135 -0
  97. package/src/file-download-authz.test.ts +404 -0
  98. package/src/file-download-date-bucket.test.ts +436 -0
  99. package/src/file-network-scope-dev-open.test.ts +97 -0
  100. package/src/file-network-scope.test.ts +732 -0
  101. package/src/group-membership-events-http.test.ts +264 -0
  102. package/src/group-messages-http.test.ts +482 -0
  103. package/src/group-messages.ts +297 -0
  104. package/src/health-host-disk-2756.test.ts +49 -0
  105. package/src/health-redaction.test.ts +685 -0
  106. package/src/host-supervisor-identity-http.test.ts +152 -0
  107. package/src/host-supervisor-identity.ts +92 -0
  108. package/src/host-supervisors-daemon-version.test.ts +137 -0
  109. package/src/http-gzip.test.ts +94 -0
  110. package/src/http-gzip.ts +112 -0
  111. package/src/hub-catalog-read-http.test.ts +187 -0
  112. package/src/hub-provider-config.test.ts +139 -0
  113. package/src/hub-provider-config.ts +105 -0
  114. package/src/hub-timestamp.test.ts +38 -0
  115. package/src/hub-timestamp.ts +27 -0
  116. package/src/human-dm.ts +215 -0
  117. package/src/human-inbox.ts +42 -0
  118. package/src/inbox-caller.ts +49 -0
  119. package/src/inbox-count-sse.test.ts +310 -0
  120. package/src/inbox-count.ts +29 -0
  121. package/src/index.ts +15 -2172
  122. package/src/lifecycle-guard.ts +50 -0
  123. package/src/list-host-supervisors.test.ts +315 -0
  124. package/src/mcp-context-cost-http.test.ts +127 -0
  125. package/src/mcp-inflight.test.ts +92 -0
  126. package/src/mcp-inflight.ts +38 -0
  127. package/src/mcp-projects-events-http.test.ts +162 -0
  128. package/src/mcp-route-label-http.test.ts +120 -0
  129. package/src/mcp-write-network-resolution.test.ts +432 -0
  130. package/src/member-audit-network-id-http.test.ts +93 -0
  131. package/src/member-presence-http.test.ts +210 -0
  132. package/src/messages-ack-by-agent-http.test.ts +142 -0
  133. package/src/migrate-sqlite-to-pg.test.ts +47 -0
  134. package/src/migrate-sqlite-to-pg.ts +263 -0
  135. package/src/model-auth-notify-http.test.ts +181 -0
  136. package/src/model-auth-notify.ts +116 -0
  137. package/src/network-name-http.test.ts +75 -0
  138. package/src/network-rules-http.test.ts +169 -0
  139. package/src/network-rules.ts +129 -0
  140. package/src/network-scope.ts +276 -0
  141. package/src/network-token-membership-http.test.ts +139 -0
  142. package/src/node-alias-control.ts +12 -0
  143. package/src/node-attrs-validate.ts +88 -0
  144. package/src/node-attrs.test.ts +258 -0
  145. package/src/node-caller-identity-http.test.ts +1083 -0
  146. package/src/node-create-request-status-http.test.ts +105 -0
  147. package/src/node-daemon-bindings.test.ts +132 -0
  148. package/src/node-daemon-bindings.ts +135 -0
  149. package/src/node-failure-alert.test.ts +150 -0
  150. package/src/node-failure-alert.ts +177 -0
  151. package/src/node-files-transport.test.ts +344 -0
  152. package/src/node-health-codex-login.test.ts +120 -0
  153. package/src/node-health-dispatch-http.test.ts +279 -0
  154. package/src/node-health-guard.ts +105 -0
  155. package/src/node-health-passthrough.test.ts +115 -0
  156. package/src/node-health-store.ts +101 -0
  157. package/src/node-id-alias.test.ts +190 -0
  158. package/src/node-identity-conflict-http.test.ts +269 -0
  159. package/src/node-identity-conflict.ts +142 -0
  160. package/src/node-identity-mismatch.test.ts +74 -0
  161. package/src/node-in-flight-tasks.ts +31 -0
  162. package/src/node-lifecycle-controllable.test.ts +64 -0
  163. package/src/node-lifecycle-controllable.ts +53 -0
  164. package/src/node-lifecycle-read-http.test.ts +250 -0
  165. package/src/node-lifecycle-read.ts +124 -0
  166. package/src/node-logs-transport.test.ts +263 -0
  167. package/src/node-peer-allowlist.test.ts +79 -0
  168. package/src/node-permissions-http.test.ts +345 -0
  169. package/src/node-permissions.ts +393 -0
  170. package/src/node-request-retention.test.ts +281 -0
  171. package/src/node-request-retention.ts +120 -0
  172. package/src/node-secret-rest-http.test.ts +190 -0
  173. package/src/node-serviceability.test.ts +86 -0
  174. package/src/node-serviceability.ts +124 -0
  175. package/src/node-session-control-http.test.ts +310 -0
  176. package/src/node-session-control.ts +258 -0
  177. package/src/node-skills-transport.test.ts +209 -0
  178. package/src/node-token-identity.ts +35 -0
  179. package/src/node-token-ownership.ts +51 -0
  180. package/src/node-token-privilege-http.test.ts +158 -0
  181. package/src/not-found-api-http.test.ts +67 -0
  182. package/src/observer-avatar-http.test.ts +442 -0
  183. package/src/observer-push.test.ts +252 -0
  184. package/src/opencode-catalog-report-http.test.ts +139 -0
  185. package/src/opencode-v2-catalog.test.ts +268 -0
  186. package/src/opencode-v2-catalog.ts +352 -0
  187. package/src/package-version-consistency.test.ts +25 -0
  188. package/src/parent-source-marker.test.ts +50 -0
  189. package/src/password-network-tokens.ts +25 -0
  190. package/src/peer-reply-atomic.test.ts +455 -0
  191. package/src/peer-reply-capability.test.ts +70 -0
  192. package/src/pg-worker.ts +87 -0
  193. package/src/probe-validate.test.ts +221 -0
  194. package/src/probe-validate.ts +104 -0
  195. package/src/probe.test.ts +80 -0
  196. package/src/probe.ts +200 -0
  197. package/src/project-dir-warn-clear-http.test.ts +132 -0
  198. package/src/project-viewer-can-http.test.ts +116 -0
  199. package/src/push.test.ts +20 -10
  200. package/src/push.ts +466 -13
  201. package/src/redact-tokens.test.ts +65 -0
  202. package/src/redact-tokens.ts +40 -0
  203. package/src/rename.ts +38 -10
  204. package/src/reply-target-derivation.test.ts +96 -0
  205. package/src/report-status-handover-capabilities-http.test.ts +124 -0
  206. package/src/report-status-host-schema.test.ts +235 -0
  207. package/src/report-status-resume-id-handover.test.ts +184 -0
  208. package/src/report-status-secret-keys.test.ts +140 -0
  209. package/src/require-explicit-test-db.ts +9 -0
  210. package/src/requirement-due-reminders-http.test.ts +620 -0
  211. package/src/requirement-due-reminders.ts +416 -0
  212. package/src/requirement-events-http.test.ts +268 -0
  213. package/src/requirement-events.test.ts +45 -0
  214. package/src/requirement-events.ts +144 -0
  215. package/src/requirement-notify.ts +165 -0
  216. package/src/requirement-participant-notify-http.test.ts +309 -0
  217. package/src/requirement-tag-ops-http.test.ts +425 -0
  218. package/src/requirement-tag-tree-http.test.ts +275 -0
  219. package/src/requirement-tag-tree.ts +127 -0
  220. package/src/requirement-tags.ts +102 -0
  221. package/src/requirements-abandoned-http.test.ts +236 -0
  222. package/src/requirements-comment-http.test.ts +167 -0
  223. package/src/requirements-completed-at-migration.test.ts +70 -0
  224. package/src/requirements-errors-mcp-http.test.ts +164 -0
  225. package/src/requirements-errors.ts +158 -0
  226. package/src/requirements-etag-http.test.ts +91 -0
  227. package/src/requirements-http.test.ts +709 -0
  228. package/src/requirements-last-event-http.test.ts +349 -0
  229. package/src/requirements-list-mcp-slim-http.test.ts +155 -0
  230. package/src/requirements-list-slim-http.test.ts +324 -0
  231. package/src/requirements-mcp.test.ts +163 -0
  232. package/src/requirements-migrate.ts +283 -0
  233. package/src/requirements-owner-strict-mcp-http.test.ts +145 -0
  234. package/src/requirements-people-http.test.ts +114 -0
  235. package/src/requirements-people-mcp-http.test.ts +231 -0
  236. package/src/requirements-people.ts +196 -0
  237. package/src/requirements-priority-lowest.test.ts +114 -0
  238. package/src/requirements-projects-parent-http.test.ts +123 -0
  239. package/src/requirements-search-http.test.ts +182 -0
  240. package/src/requirements-search.test.ts +32 -0
  241. package/src/requirements-search.ts +145 -0
  242. package/src/requirements-seq-http.test.ts +193 -0
  243. package/src/requirements-seq-migration.test.ts +63 -0
  244. package/src/requirements-start-date.test.ts +125 -0
  245. package/src/requirements-stats-http.test.ts +357 -0
  246. package/src/requirements-stats.ts +195 -0
  247. package/src/requirements-status-participants-http.test.ts +222 -0
  248. package/src/requirements-upgrade-e2e.test.ts +126 -0
  249. package/src/requirements-upgrade-migration.test.ts +98 -0
  250. package/src/requirements.ts +2027 -0
  251. package/src/resolve-port.test.ts +57 -0
  252. package/src/resolve-port.ts +44 -0
  253. package/src/response-charset.test.ts +130 -0
  254. package/src/rest-alias-network-fallback-http.test.ts +123 -0
  255. package/src/rest-alias-network-fallback.test.ts +60 -0
  256. package/src/rest-alias-network-fallback.ts +65 -0
  257. package/src/rest-explicit-columns-http.test.ts +266 -0
  258. package/src/rest-identity.test.ts +130 -0
  259. package/src/rest-identity.ts +141 -0
  260. package/src/rest-projections.ts +72 -0
  261. package/src/rest-read-network-real-chain.test.ts +97 -0
  262. package/src/rest-write-network-resolution.test.ts +133 -0
  263. package/src/restart-readiness-http.test.ts +121 -0
  264. package/src/restricted-files.ts +76 -0
  265. package/src/retention-first-sweep-quiet.test.ts +31 -0
  266. package/src/retention.test.ts +100 -40
  267. package/src/retention.ts +423 -104
  268. package/src/route-callers-http.test.ts +120 -0
  269. package/src/route-timing.test.ts +211 -0
  270. package/src/route-timing.ts +262 -0
  271. package/src/rules-file-duplicate-alias.test.ts +234 -0
  272. package/src/rules-file-session-target.test.ts +207 -0
  273. package/src/rules-file-transport.test.ts +237 -0
  274. package/src/runtime-label.test.ts +22 -0
  275. package/src/runtime-label.ts +21 -0
  276. package/src/runtime-readiness.ts +90 -0
  277. package/src/schedule-agent-mcp-http.test.ts +391 -0
  278. package/src/schedule-agent.ts +192 -0
  279. package/src/schedule-starved.test.ts +92 -0
  280. package/src/schedule-starved.ts +114 -0
  281. package/src/scheduled-backoff-http.test.ts +193 -0
  282. package/src/scheduled-backoff.ts +64 -0
  283. package/src/scheduled-doorbell-nodeless-session.test.ts +134 -0
  284. package/src/scheduled-failure-backoff-2622.test.ts +145 -0
  285. package/src/scheduled-failure-code.test.ts +73 -0
  286. package/src/scheduled-failure-code.ts +105 -0
  287. package/src/scheduled-failures-http.test.ts +279 -0
  288. package/src/scheduled-failures.ts +377 -0
  289. package/src/scheduled-noprogress-backoff-2622.test.ts +133 -0
  290. package/src/scheduled-offline-backoff-probe.test.ts +56 -0
  291. package/src/scheduled-offline.test.ts +131 -0
  292. package/src/scheduled-offline.ts +66 -0
  293. package/src/scheduled-outcome-guidance-http.test.ts +139 -0
  294. package/src/scheduled-outcome-guidance.ts +9 -0
  295. package/src/scheduled-reply-unread-http.test.ts +212 -0
  296. package/src/scheduled-requirement-wake-http.test.ts +279 -0
  297. package/src/scheduled-requirement-wake.ts +125 -0
  298. package/src/scheduled-run-terminal.test.ts +268 -0
  299. package/src/scheduled-skip-blocking-task.test.ts +120 -0
  300. package/src/scheduled-skip-path-backoff-2622.test.ts +98 -0
  301. package/src/scheduled-stuck-http.test.ts +312 -0
  302. package/src/scheduled-stuck-notice-cap.test.ts +80 -0
  303. package/src/scheduled-stuck.ts +219 -0
  304. package/src/scheduled-tasks-http.test.ts +679 -0
  305. package/src/scheduled-tasks.ts +959 -0
  306. package/src/scheduled-work-outcome-http.test.ts +154 -0
  307. package/src/scheduled-work-outcome.ts +50 -0
  308. package/src/scoped-secrets.ts +139 -0
  309. package/src/send-dedup-request-id.test.ts +229 -0
  310. package/src/send-reply-agent-warning.test.ts +202 -0
  311. package/src/send-reply-alias-optional.test.ts +131 -0
  312. package/src/send-reply-attachments.test.ts +458 -0
  313. package/src/send_dedup.test.ts +54 -0
  314. package/src/send_dedup.ts +52 -6
  315. package/src/serve-error.test.ts +38 -0
  316. package/src/serve-error.ts +27 -0
  317. package/src/server.ts +5997 -0
  318. package/src/session-task-on-dispatch.ts +14 -0
  319. package/src/session-token-ownership-http.test.ts +122 -0
  320. package/src/shared/codex-inventory.ts +41 -0
  321. package/src/shared/daemon-provider-login.ts +31 -0
  322. package/src/shared/daemon-provider-snapshot.ts +52 -0
  323. package/src/shared/external-schedule-contract.ts +60 -0
  324. package/src/shared/node-name.test.ts +62 -0
  325. package/src/shared/node-name.ts +161 -0
  326. package/src/shared/probe-host-allowlist-drift.test.ts +54 -0
  327. package/src/shared/probe-host-allowlist.ts +128 -0
  328. package/src/shared/provider-application.ts +29 -0
  329. package/src/shared/provider-collection.ts +14 -0
  330. package/src/shared/provider-initialization.ts +8 -0
  331. package/src/shared/reserved-env-drift.test.ts +53 -0
  332. package/src/shared/reserved-env.test.ts +35 -0
  333. package/src/shared/reserved-env.ts +31 -0
  334. package/src/shared/scoped-secret-contract.ts +5 -0
  335. package/src/shared/task-content-limit-drift.test.ts +28 -0
  336. package/src/shared/task-content-limit.ts +25 -0
  337. package/src/side-thread-command-transport.test.ts +312 -0
  338. package/src/side-thread-command-transport.ts +318 -0
  339. package/src/side-thread-http-integration.test.ts +233 -0
  340. package/src/side-thread-http.ts +504 -0
  341. package/src/side-thread-production.test.ts +72 -0
  342. package/src/side-thread-production.ts +118 -0
  343. package/src/side-thread.test.ts +1067 -0
  344. package/src/side-thread.ts +2499 -0
  345. package/src/skillhub-http.test.ts +108 -0
  346. package/src/sqlite-close-checkpoint.test.ts +78 -0
  347. package/src/start-node.test.ts +264 -0
  348. package/src/status-alias-filter-http.test.ts +106 -0
  349. package/src/status-alias-resolver-http.test.ts +163 -0
  350. package/src/status-alias-resolver.ts +19 -0
  351. package/src/status-node-id-filter-http.test.ts +161 -0
  352. package/src/status-read-cache-http.test.ts +229 -0
  353. package/src/status-read-cache.ts +122 -0
  354. package/src/stop-delete-node.test.ts +1286 -0
  355. package/src/task-access-http.test.ts +402 -0
  356. package/src/task-access.ts +420 -0
  357. package/src/task-activity.ts +60 -0
  358. package/src/task-auth-origin-http.test.ts +93 -0
  359. package/src/task-auth-origin.test.ts +24 -0
  360. package/src/task-auth-origin.ts +7 -0
  361. package/src/task-consumption.test.ts +482 -0
  362. package/src/task-diagnostic-http.test.ts +149 -0
  363. package/src/task-diagnostic.test.ts +115 -0
  364. package/src/task-diagnostic.ts +118 -0
  365. package/src/task-expiry-notice-http.test.ts +287 -0
  366. package/src/task-expiry-notice.ts +315 -0
  367. package/src/task-idempotency-mcp.test.ts +142 -0
  368. package/src/task-idempotency.test.ts +76 -0
  369. package/src/task-idempotency.ts +81 -0
  370. package/src/task-late-replies.ts +54 -0
  371. package/src/task-late-reply-http.test.ts +152 -0
  372. package/src/task-lifecycle-watcher-busy.test.ts +114 -0
  373. package/src/task-lifecycle-watcher.test.ts +204 -0
  374. package/src/task-lifecycle-watcher.ts +109 -0
  375. package/src/task-network-resolution-http.test.ts +140 -0
  376. package/src/task-offline-delivery-2668.test.ts +119 -0
  377. package/src/task-offline-delivery.ts +81 -0
  378. package/src/task-orphan-http.test.ts +287 -0
  379. package/src/task-orphan.ts +119 -0
  380. package/src/task-queue-ahead-http.test.ts +309 -0
  381. package/src/task-queue-ahead-scale.test.ts +236 -0
  382. package/src/task-queue-ahead.ts +186 -0
  383. package/src/task-rejection-log-http.test.ts +160 -0
  384. package/src/task-rejection-log.ts +49 -0
  385. package/src/task-sender-http.test.ts +143 -0
  386. package/src/task-stale-open-http.test.ts +290 -0
  387. package/src/task-stale-open.ts +103 -0
  388. package/src/tasks-pagination-http.test.ts +141 -0
  389. package/src/team-rules-status-http.test.ts +90 -0
  390. package/src/team-rules-status.test.ts +59 -0
  391. package/src/team-rules-status.ts +72 -0
  392. package/src/tool-audience-http.test.ts +230 -0
  393. package/src/tool-audience.ts +120 -0
  394. package/src/tools-list-json-schema.test.ts +94 -0
  395. package/src/tools.ts +5815 -348
  396. package/src/update-provider.test.ts +234 -0
  397. package/src/upload-early-reject-guard.test.ts +155 -0
  398. package/src/uploads-http.test.ts +97 -15
  399. package/src/uploads.test.ts +66 -0
  400. package/src/uploads.ts +138 -5
  401. package/src/user-avatar-http.test.ts +74 -0
  402. package/src/user-avatar-image.ts +160 -0
  403. package/src/user-avatar-migration.test.ts +25 -0
  404. package/src/user-avatar-upload-http.test.ts +348 -0
  405. package/src/user-inbox-by-agent-http.test.ts +161 -0
  406. package/src/user-inbox-netid-notnull.test.ts +122 -0
  407. package/src/user-inbox-read-http.test.ts +223 -0
  408. package/src/user-inbox-schema.test.ts +54 -0
  409. package/src/vault.test.ts +200 -0
  410. package/src/vault.ts +156 -0
  411. package/src/version-stats.test.ts +66 -0
  412. package/src/version-stats.ts +109 -0
@@ -0,0 +1,411 @@
1
+ // RFC-026 v4 hub-side runtime — pendingEnvBlobs Map (F1 mint-stream-
2
+ // evict) + sweeper (C4 orphan ntok revoke) + content-match finalize
3
+ // helper (called from report_status when a child first registers).
4
+ //
5
+ // The actual MCP tools (create_node / get_create_request /
6
+ // ack_create_request) are registered in tools.ts and call into this
7
+ // module. Keeping the heavy state + sweeper here makes the tool layer
8
+ // thin + this module independently testable.
9
+
10
+ import { db, uuidv4 } from "./db.js";
11
+
12
+ // ── §4.4 F1 — pendingEnvBlobs Map ─────────────────────────────────
13
+ // In-memory ONLY. Never touches disk / never enters the SQL store.
14
+ // Daemon `get_create_request(request_id)` consumes + evicts. Untaken
15
+ // blobs are GC'd at TTL expiry.
16
+
17
+ export interface PendingEnvBlob {
18
+ request_id: string;
19
+ daemon_node_id: string; // hub uses this for C2 cross-daemon check
20
+ env_blob: Record<string, string>; // KEY → secret value (plaintext, never logged)
21
+ child_token: string; // freshly minted ntok_ for the child
22
+ child_token_id: string; // tokens.token_id for sweeper revoke
23
+ expires_at: number; // ms epoch
24
+ }
25
+
26
+ const TTL_MS = 60_000; // 60s per RFC-026 v4 §4.4
27
+ const SWEEPER_INTERVAL_MS = 30_000; // 30s per RFC-026 v4 §4.4.8
28
+ const REAPER_TTL_MS = 60_000; // 60s timeout for pending/delivered rows
29
+
30
+ const pendingEnvBlobs = new Map<string, PendingEnvBlob>();
31
+ let gcTimer: ReturnType<typeof setInterval> | null = null;
32
+ let sweeperTimer: ReturnType<typeof setInterval> | null = null;
33
+
34
+ export function putPendingEnvBlob(b: Omit<PendingEnvBlob, "expires_at">): void {
35
+ pendingEnvBlobs.set(b.request_id, { ...b, expires_at: Date.now() + TTL_MS });
36
+ }
37
+
38
+ /** Get the pending env_blob for daemon. Returns null if not found OR
39
+ * if caller's daemon_node_id doesn't match (C2 cross-daemon guard).
40
+ * Atomically deletes the entry from the Map (one-shot consume). */
41
+ export function takePendingEnvBlob(
42
+ request_id: string,
43
+ callerDaemonNodeId: string,
44
+ ): PendingEnvBlob | null {
45
+ const b = pendingEnvBlobs.get(request_id);
46
+ if (!b) return null;
47
+ if (b.daemon_node_id !== callerDaemonNodeId) return null;
48
+ if (Date.now() > b.expires_at) {
49
+ pendingEnvBlobs.delete(request_id);
50
+ return null;
51
+ }
52
+ pendingEnvBlobs.delete(request_id); // §4.4 evict immediately
53
+ return b;
54
+ }
55
+
56
+ /** Test/diagnostic helper — does NOT consume. */
57
+ export function peekPendingEnvBlob(request_id: string): PendingEnvBlob | null {
58
+ return pendingEnvBlobs.get(request_id) || null;
59
+ }
60
+
61
+ export function evictExpired(now = Date.now()): number {
62
+ let evicted = 0;
63
+ for (const [k, v] of pendingEnvBlobs) {
64
+ if (now > v.expires_at) {
65
+ pendingEnvBlobs.delete(k);
66
+ evicted++;
67
+ }
68
+ }
69
+ return evicted;
70
+ }
71
+
72
+ export function startPendingEnvGcTimer(): void {
73
+ if (gcTimer) return;
74
+ gcTimer = setInterval(() => {
75
+ const n = evictExpired();
76
+ if (n > 0) console.log(`[create-node] GC: evicted ${n} expired env_blob(s)`);
77
+ }, 5_000);
78
+ (gcTimer as any).unref?.();
79
+ }
80
+
81
+ // ── §4.4.8 C4 — orphan ntok revoke sweeper ────────────────────────
82
+ // Scans `node_create_requests` for non-terminal rows older than
83
+ // REAPER_TTL_MS. Atomically marks request as failed/expired AND
84
+ // revokes the matching api_tokens.row (via request_id link) so the
85
+ // orphan child-ntok cannot be used by anyone who scraped it.
86
+
87
+ export function runOrphanSweepOnce(now = Date.now()): { swept: number; revoked: number } {
88
+ const cutoffAge = REAPER_TTL_MS;
89
+ const cutoffMs = now - cutoffAge;
90
+ // Two cohorts (per RFC §4.4.8 case table):
91
+ // F-1 status='pending' age > TTL → hub crashed before daemon get
92
+ // F-2 status='delivered' age > TTL → daemon got blob but never ack'd
93
+ const stale = db.all<{ request_id: string; status: string; child_token_id: string | null }>(
94
+ `SELECT request_id, status, child_token_id
95
+ FROM node_create_requests
96
+ WHERE status IN ('pending', 'delivered')
97
+ AND created_at < ?1`,
98
+ cutoffMs,
99
+ );
100
+ if (stale.length === 0) return { swept: 0, revoked: 0 };
101
+
102
+ let swept = 0; let revoked = 0;
103
+ // SQLite Bun driver doesn't expose BEGIN/COMMIT cleanly across the
104
+ // wrapper here; fold per-row into a transaction.
105
+ try {
106
+ db.exec("BEGIN");
107
+ for (const row of stale) {
108
+ // Revoke the child-ntok first (sweeper is server-side ground
109
+ // truth per §4.4.8). If child_token_id null somehow, skip
110
+ // revoke (request never made it that far) but still mark
111
+ // failed.
112
+ if (row.child_token_id) {
113
+ // db.run returns the SQLite adapter's RunResult (changes counter
114
+ // if driver-supported). Only count a revoke when the UPDATE
115
+ // actually touched a row — under the bun:sqlite adapter the
116
+ // changes prop is reliable; on adapters returning undefined we
117
+ // fall back to a post-UPDATE SELECT to confirm revoked_at IS
118
+ // NOT NULL (DB is ground truth). Avoids over-counting when
119
+ // child_token_id is stale or already revoked. (通信龙 nit 2)
120
+ const r = db.run(
121
+ `UPDATE api_tokens SET revoked_at = datetime('now') WHERE token_id = ?1 AND revoked_at IS NULL`,
122
+ [row.child_token_id],
123
+ );
124
+ const changes = (r as any)?.changes;
125
+ if (typeof changes === "number") {
126
+ if (changes > 0) revoked++;
127
+ } else {
128
+ // Adapter didn't report; verify via SELECT
129
+ const after = db.get<{ revoked_at: string | null }>(
130
+ `SELECT revoked_at FROM api_tokens WHERE token_id = ?1`, row.child_token_id,
131
+ );
132
+ if (after?.revoked_at) revoked++;
133
+ }
134
+ }
135
+ const newStatus = row.status === "pending" ? "failed" : "expired";
136
+ const err = row.status === "pending" ? "sweeper_revoked_before_delivery" : "sweeper_revoked_after_delivery_no_ack";
137
+ db.run(
138
+ `UPDATE node_create_requests SET status = ?1, error = ?2, acked_at = ?3 WHERE request_id = ?4 AND status IN ('pending', 'delivered')`,
139
+ [newStatus, err, now, row.request_id],
140
+ );
141
+ // Also drop any lingering env_blob (defense; should already be
142
+ // gone for delivered, but pending could leak if GC hasn't run).
143
+ pendingEnvBlobs.delete(row.request_id);
144
+ swept++;
145
+ }
146
+ db.exec("COMMIT");
147
+ } catch (e: any) {
148
+ try { db.exec("ROLLBACK"); } catch { /* swallow */ }
149
+ console.warn(`[create-node] sweeper transaction failed: ${e?.message || e}`);
150
+ return { swept: 0, revoked: 0 };
151
+ }
152
+ if (swept > 0) {
153
+ console.log(`[commhub] ✓ create-node sweeper: swept ${swept} stale request(s), revoked ${revoked} child-ntok(s)`);
154
+ auditCreateNode({
155
+ action: "create_node_sweeper_revoked",
156
+ detail: { swept, revoked, sweeper_run_at_ms: now },
157
+ });
158
+ }
159
+ return { swept, revoked };
160
+ }
161
+
162
+ export function startSweeperTimer(): void {
163
+ if (sweeperTimer) return;
164
+ // Boot-time sweep: catch any rows left over from a prior process
165
+ // crash (case F-1: hub crashed after mint, before daemon get).
166
+ try { runOrphanSweepOnce(); } catch (e: any) {
167
+ console.warn(`[create-node] boot sweeper failed: ${e?.message || e}`);
168
+ }
169
+ sweeperTimer = setInterval(() => {
170
+ try { runOrphanSweepOnce(); }
171
+ catch (e: any) { console.warn(`[create-node] periodic sweeper failed: ${e?.message || e}`); }
172
+ }, SWEEPER_INTERVAL_MS);
173
+ (sweeperTimer as any).unref?.();
174
+ }
175
+
176
+ export function stopBackgroundTimersForTest(): void {
177
+ if (gcTimer) { clearInterval(gcTimer); gcTimer = null; }
178
+ if (sweeperTimer) { clearInterval(sweeperTimer); sweeperTimer = null; }
179
+ pendingEnvBlobs.clear();
180
+ }
181
+
182
+ // ── content-match finalize on child first register ────────────────
183
+ // Called from tools.ts report_status handler when a node registers (or
184
+ // re-registers). If there's a pending node_create_requests row whose
185
+ // `child_name` matches the incoming alias AND the daemon_node_id is
186
+ // in caller's network, mark it succeeded and stamp the real
187
+ // child_node_id. Mirrors RFC-024 finalizePendingMatchingUpdates.
188
+
189
+ export function finalizeCreateOnFirstRegister(
190
+ incoming: { node_id: string; alias: string; network_id: string | null },
191
+ ): { finalized: number; matchedIds: string[] } {
192
+ if (!incoming.node_id || !incoming.alias) return { finalized: 0, matchedIds: [] };
193
+ const net = incoming.network_id ?? "default";
194
+ const pending = db.all<{ request_id: string; daemon_node_id: string }>(
195
+ `SELECT request_id, daemon_node_id FROM node_create_requests
196
+ WHERE child_name = ?1 AND network_id = ?2 AND status IN ('delivered', 'pending')
197
+ ORDER BY created_at ASC`,
198
+ incoming.alias, net,
199
+ );
200
+ if (pending.length === 0) return { finalized: 0, matchedIds: [] };
201
+
202
+ const matchedIds: string[] = [];
203
+ for (const row of pending) {
204
+ const r = db.run(
205
+ `UPDATE node_create_requests
206
+ SET status = 'succeeded', child_node_id = ?1, acked_at = ?2
207
+ WHERE request_id = ?3 AND status IN ('delivered', 'pending')`,
208
+ [incoming.node_id, Date.now(), row.request_id],
209
+ );
210
+ matchedIds.push(row.request_id);
211
+ console.log(`[commhub] ✓ create-node finalize: request=${row.request_id} child=${incoming.alias} (${incoming.node_id}) daemon=${row.daemon_node_id}`);
212
+ auditCreateNode({
213
+ action: "create_node_succeeded",
214
+ network_id: net,
215
+ target_id: row.request_id,
216
+ detail: { child_node_id: incoming.node_id, child_alias: incoming.alias, daemon_node_id: row.daemon_node_id },
217
+ });
218
+ }
219
+ return { finalized: matchedIds.length, matchedIds };
220
+ }
221
+
222
+ export function newRequestId(): string {
223
+ return `cr_${uuidv4()}`;
224
+ }
225
+
226
+ // §4.1.4 C2 — resolve the caller daemon's node row by **token-bound
227
+ // identity** (PR #299 BLOCKER #1). Module-level so unit tests can
228
+ // import + call directly (per 通信龙 nit 1 — don't inline-mirror SQL
229
+ // in tests; that's exactly the helper-drift anti-pattern the tools.ts
230
+ // comment warns against).
231
+ export type DaemonResolveResult =
232
+ | { ok: true; daemonNodeId: string; daemonAlias: string; networkId: string }
233
+ | { ok: false; error: string };
234
+
235
+ export type NodeCallerResolution =
236
+ | { ok: true; kind: "node"; nodeId: string; alias: string; networkId: string }
237
+ | { ok: true; kind: "unregistered"; alias: string; networkId: string }
238
+ | { ok: false; reason: "not_a_node_token" | "bound_node_missing" | "ambiguous" | "not_owner" };
239
+
240
+ export type NodeCallerRow = { node_id: string; alias: string; network_id: string; owner_user_id: string | null };
241
+ export type NodeCallerToken = { name: string; network_id: string | null; user_id: string | null; bound_node_id: string | null; node_identity_epoch: number };
242
+
243
+ // nodes has no unique (network, alias). An unbound token that hits several
244
+ // rows is not rejected outright: the row owned by the token's issuer wins;
245
+ // if that is still not unique, the node_id on the latest session for the
246
+ // alias wins. Still not unique, then refuse.
247
+ function disambiguateUnboundAlias(
248
+ rows: NodeCallerRow[],
249
+ userId: string | null,
250
+ recentNodeId: string | null,
251
+ ): NodeCallerRow | undefined {
252
+ const owned = userId ? rows.filter((row) => row.owner_user_id === userId) : [];
253
+ if (owned.length === 1) return owned[0]; // board679-unbound-dup
254
+ const pool = owned.length > 1 ? owned : rows;
255
+ const hit = recentNodeId ? pool.filter((row) => row.node_id === recentNodeId) : [];
256
+ return hit.length === 1 ? hit[0] : undefined;
257
+ }
258
+
259
+ // One lookup for every caller-identity entry. The token name is a hint.
260
+ // bound_node_id is the row: if that row is gone, refuse — do not look up by name.
261
+ // An unbound token with no row in its network stays the token name. First
262
+ // registration (report_status) still depends on that; sending and subscribing
263
+ // do not get a second exception.
264
+ export function resolveNodeCaller(tokenId: string | null | undefined): NodeCallerResolution {
265
+ if (!tokenId) return { ok: false, reason: "not_a_node_token" };
266
+ const tokRow = db.get<NodeCallerToken>(
267
+ `SELECT name, network_id, user_id, bound_node_id, node_identity_epoch FROM api_tokens WHERE token_id = ?1 AND revoked_at IS NULL`,
268
+ tokenId,
269
+ );
270
+ if (!tokRow || !tokRow.name || !tokRow.name.startsWith("node:") || !tokRow.network_id) {
271
+ return { ok: false, reason: "not_a_node_token" };
272
+ }
273
+ const tokenAlias = tokRow.name.slice(5);
274
+ type DaemonRow = { node_id: string; alias: string; network_id: string; owner_user_id: string | null };
275
+ const rows = tokRow.bound_node_id
276
+ ? db.all<DaemonRow>(`SELECT node_id, alias, network_id, owner_user_id FROM nodes WHERE node_id = ?1 AND network_id = ?2`, tokRow.bound_node_id, tokRow.network_id)
277
+ : db.all<DaemonRow>(`SELECT node_id, alias, network_id, owner_user_id FROM nodes WHERE alias = ?1 AND network_id = ?2`, tokenAlias, tokRow.network_id);
278
+ const recent = !tokRow.bound_node_id && rows.length > 1
279
+ ? db.get<{ node_id: string | null }>(
280
+ `SELECT node_id FROM sessions WHERE alias = ?1 AND network_id = ?2 AND node_id IS NOT NULL ORDER BY updated_at DESC LIMIT 1`,
281
+ tokenAlias, tokRow.network_id,
282
+ ) : null;
283
+ return resolveNodeCallerFromRows(tokRow, rows, recent?.node_id ?? null);
284
+ }
285
+
286
+ /** Shared identity contract for individual callers and scoped, batched list reads. */
287
+ export function resolveNodeCallerFromRows(
288
+ tokRow: NodeCallerToken, rows: NodeCallerRow[], recentNodeId: string | null,
289
+ ): NodeCallerResolution {
290
+ if (!tokRow.name?.startsWith("node:") || !tokRow.network_id) {
291
+ return { ok: false, reason: "not_a_node_token" };
292
+ }
293
+ const tokenAlias = tokRow.name.slice(5);
294
+ const nodeRow = rows.length === 1
295
+ ? rows[0]
296
+ : (!tokRow.bound_node_id && rows.length > 1
297
+ ? disambiguateUnboundAlias(rows, tokRow.user_id, recentNodeId)
298
+ : undefined);
299
+ // board679-bound-row-missing: a bound token with no row is refused. Do not look up by name.
300
+ if (tokRow.bound_node_id && !nodeRow) return { ok: false, reason: "bound_node_missing" };
301
+ if (!nodeRow && rows.length === 0) {
302
+ return { ok: true, kind: "unregistered", alias: tokenAlias, networkId: tokRow.network_id };
303
+ }
304
+ if (!nodeRow) return { ok: false, reason: "ambiguous" };
305
+ // Legacy unbound tokens keep their owner's authority. A token name is only a hint.
306
+ const ownsNode = !!tokRow.user_id && tokRow.user_id === nodeRow.owner_user_id;
307
+ const boundToNode = tokRow.bound_node_id === nodeRow.node_id;
308
+ const legacyOwnerless = nodeRow.owner_user_id === null && tokRow.node_identity_epoch === 0;
309
+ if (!ownsNode && !boundToNode && !legacyOwnerless) return { ok: false, reason: "not_owner" };
310
+ return { ok: true, kind: "node", nodeId: nodeRow.node_id, alias: nodeRow.alias, networkId: nodeRow.network_id };
311
+ }
312
+
313
+ export function resolveCallerDaemonTokenBound(opts: {
314
+ callerTokenIsNetwork: boolean;
315
+ callerTokenId: string | null | undefined;
316
+ enforceNetworkId: string | null | undefined;
317
+ }): DaemonResolveResult {
318
+ if (!opts.callerTokenIsNetwork || !opts.callerTokenId || !opts.enforceNetworkId) {
319
+ return { ok: false, error: "caller_not_a_daemon" };
320
+ }
321
+ const resolved = resolveNodeCaller(opts.callerTokenId);
322
+ // No row yet is not a daemon. First registration stays on report_status.
323
+ if (!resolved.ok || resolved.kind !== "node" || resolved.networkId !== opts.enforceNetworkId) {
324
+ return { ok: false, error: "caller_not_a_daemon" };
325
+ }
326
+ return {
327
+ ok: true,
328
+ daemonNodeId: resolved.nodeId,
329
+ daemonAlias: resolved.alias,
330
+ networkId: resolved.networkId,
331
+ };
332
+ }
333
+
334
+ // RFC-026 §4.5 — append a row to audit_log for every create_node
335
+ // lifecycle event. Best-effort: never throw out (calling tool should
336
+ // continue even if audit insert fails for any reason).
337
+ /** RFC-027 §4.5 D8 — tx-aware variant. Identical SQL to auditCreateNode
338
+ * but RE-THROWS on failure so a BEGIN..COMMIT around lifecycle UPDATE +
339
+ * audit INSERT can ROLLBACK if the audit row would have been lost.
340
+ * Required for the "no audit-but state changed" window that §4.5 / D8
341
+ * explicitly closes (PR1 SF-2 review catch — auditCreateNode's
342
+ * swallow-and-warn defeats atomicity).
343
+ *
344
+ * Callers in a non-transaction context should keep using auditCreateNode
345
+ * (best-effort, never throws). */
346
+ export function auditCreateNodeStrict(input: {
347
+ action: Parameters<typeof auditCreateNode>[0]["action"];
348
+ user_id?: string | null;
349
+ username?: string | null;
350
+ network_id?: string | null;
351
+ target_id?: string | null;
352
+ detail: Record<string, unknown>;
353
+ }): void {
354
+ db.run(
355
+ `INSERT INTO audit_log (user_id, username, action, target_type, target_id, detail, network_id)
356
+ VALUES (?1, ?2, ?3, 'node_create_request', ?4, ?5, ?6)`,
357
+ [
358
+ input.user_id || null,
359
+ input.username || null,
360
+ input.action,
361
+ input.target_id || null,
362
+ JSON.stringify(input.detail),
363
+ input.network_id || null,
364
+ ],
365
+ );
366
+ }
367
+
368
+ export function auditCreateNode(input: {
369
+ action:
370
+ | "create_node_dispatched"
371
+ | "create_node_dispatch_attempted"
372
+ | "create_node_rejected"
373
+ | "create_node_succeeded"
374
+ | "create_node_sweeper_revoked"
375
+ | "daemon_capability_lied" // RFC-026 §9.3 D2 — daemon declared runtime support, child died before serving
376
+ // RFC-027 §4.5 — stop/delete lifecycle audit action enum extension.
377
+ // Re-using auditCreateNode is fine: the action column carries the
378
+ // discriminator; target_type stays 'node_create_request' which is a
379
+ // misnomer for stop/delete rows but updating the schema would force a
380
+ // wider migration (see P1.1 issue).
381
+ | "stop_node_dispatched"
382
+ | "stop_node_completed"
383
+ | "start_node_dispatched"
384
+ | "start_node_completed"
385
+ | "delete_node_dispatched"
386
+ | "delete_node_completed"
387
+ | "forced_stop_with_in_flight"
388
+ | "backup_purged";
389
+ user_id?: string | null;
390
+ username?: string | null;
391
+ network_id?: string | null;
392
+ target_id?: string | null; // request_id
393
+ detail: Record<string, unknown>;
394
+ }): void {
395
+ try {
396
+ db.run(
397
+ `INSERT INTO audit_log (user_id, username, action, target_type, target_id, detail, network_id)
398
+ VALUES (?1, ?2, ?3, 'node_create_request', ?4, ?5, ?6)`,
399
+ [
400
+ input.user_id || null,
401
+ input.username || null,
402
+ input.action,
403
+ input.target_id || null,
404
+ JSON.stringify(input.detail),
405
+ input.network_id || null,
406
+ ],
407
+ );
408
+ } catch (e: any) {
409
+ console.warn(`[commhub] audit_log insert (create_node) failed: ${e?.message || e}`);
410
+ }
411
+ }