@sleep2agi/commhub-server 0.9.0-preview.28 → 0.9.0-preview.280

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 (479) hide show
  1. package/README.md +120 -3
  2. package/bin/commhub.ts +93 -9
  3. package/build-info.json +7 -0
  4. package/package.json +10 -8
  5. package/src/ack-create-request-transport.test.ts +182 -0
  6. package/src/ack-create-request.test.ts +52 -8
  7. package/src/admin-delete-network-http.test.ts +229 -0
  8. package/src/admin-networks-http.test.ts +88 -0
  9. package/src/adoption-candidates-http.test.ts +140 -0
  10. package/src/adoption-candidates.ts +158 -0
  11. package/src/agent-access-batch.test.ts +215 -0
  12. package/src/agent-access.ts +585 -0
  13. package/src/agent-acl-groups-http.test.ts +247 -0
  14. package/src/agent-acl-http.test.ts +691 -0
  15. package/src/agent-acl-slice3-http.test.ts +888 -0
  16. package/src/agent-department-grants.test.ts +129 -0
  17. package/src/agent-department-http.test.ts +215 -0
  18. package/src/agent-groups-perf.test.ts +228 -0
  19. package/src/agent-notice.ts +48 -0
  20. package/src/agent-team-whoami-http.test.ts +98 -0
  21. package/src/agent-teams-http.test.ts +330 -0
  22. package/src/agent-teams.ts +244 -0
  23. package/src/alias-baseline-2571.test.ts +162 -0
  24. package/src/alias-baseline.ts +113 -0
  25. package/src/alias-filter.test.ts +72 -0
  26. package/src/alias-filter.ts +42 -0
  27. package/src/all-status-cache.test.ts +31 -0
  28. package/src/all-status-cache.ts +37 -0
  29. package/src/anet-variant-real-daemon-http.test.ts +184 -0
  30. package/src/api-host-supervisors-can-create-nodes.test.ts +350 -0
  31. package/src/api-host-supervisors-fallback.test.ts +6 -7
  32. package/src/api-host-supervisors-runtime-readiness.test.ts +195 -0
  33. package/src/api-nodes-shape.test.ts +131 -4
  34. package/src/auth-abuse-counters.test.ts +144 -0
  35. package/src/auth-abuse-counters.ts +122 -0
  36. package/src/auth-layer-shape.test.ts +105 -0
  37. package/src/auth-password-change-cli-tokens-http.test.ts +423 -0
  38. package/src/auth-sessions-http.test.ts +260 -0
  39. package/src/auth-validate.test.ts +5 -1
  40. package/src/auth-weak-password-login.test.ts +176 -0
  41. package/src/auth.ts +641 -68
  42. package/src/backfill-node-ids-2664.test.ts +128 -0
  43. package/src/binding-generation-http.test.ts +141 -0
  44. package/src/blocked-exit-on-reply.test.ts +122 -0
  45. package/src/broadcast-fanout-2721.test.ts +149 -0
  46. package/src/broadcast-fanout.ts +117 -0
  47. package/src/build-commit-report-http.test.ts +218 -0
  48. package/src/build-info.test.ts +60 -0
  49. package/src/build-info.ts +85 -0
  50. package/src/chain-attempt-dedup.test.ts +447 -0
  51. package/src/clip.test.ts +36 -0
  52. package/src/clip.ts +48 -0
  53. package/src/clone-node.test.ts +269 -0
  54. package/src/clone-node.ts +289 -0
  55. package/src/codex-config-flags.ts +77 -0
  56. package/src/codex-fork-contract.ts +23 -0
  57. package/src/codex-fork-migration.test.ts +38 -0
  58. package/src/commhub-bin-args.test.ts +85 -0
  59. package/src/config-apply-sec1.test.ts +37 -0
  60. package/src/config-apply-validate.test.ts +188 -1
  61. package/src/config-apply-validate.ts +226 -3
  62. package/src/contracts/session-project-create.ts +14 -0
  63. package/src/contracts/session-source-delivery.ts +16 -0
  64. package/src/contracts/session-source-directory.ts +54 -0
  65. package/src/contracts/session-source-evidence.ts +72 -0
  66. package/src/contracts/session-source-execution.ts +24 -0
  67. package/src/contracts/session-source-transport.ts +18 -0
  68. package/src/cors-origins.test.ts +73 -0
  69. package/src/create-node-blocked-gate.test.ts +365 -0
  70. package/src/create-node-error-domain.test.ts +127 -0
  71. package/src/create-node-network-id.test.ts +91 -0
  72. package/src/create-node-tool-schema.test.ts +59 -0
  73. package/src/create-node-unicode-name.test.ts +126 -0
  74. package/src/create-node-validate.test.ts +199 -7
  75. package/src/create-node-validate.ts +232 -15
  76. package/src/create-node-workdir.test.ts +298 -0
  77. package/src/create-node.ts +88 -23
  78. package/src/daemon-provider-snapshots.test.ts +453 -0
  79. package/src/daemon-provider-snapshots.ts +327 -0
  80. package/src/daemon-token-owner-http.test.ts +346 -0
  81. package/src/dashboard-slash-routing-http.test.ts +109 -0
  82. package/src/db-adapter-guard.test.ts +148 -0
  83. package/src/db-adapter-translate.test.ts +128 -0
  84. package/src/db-adapter.ts +377 -91
  85. package/src/db-timestamp.test.ts +38 -0
  86. package/src/db-timestamp.ts +15 -0
  87. package/src/db.ts +1334 -154
  88. package/src/delivered-without-push.test.ts +140 -0
  89. package/src/department-groups-http.test.ts +209 -0
  90. package/src/department-groups-sync-http.test.ts +328 -0
  91. package/src/department-groups.ts +434 -0
  92. package/src/department-heads-http.test.ts +350 -0
  93. package/src/department-heads.ts +226 -0
  94. package/src/departments-agent-count.test.ts +139 -0
  95. package/src/departments-http.test.ts +185 -0
  96. package/src/departments-mcp-error-domain.test.ts +135 -0
  97. package/src/departments-mcp.test.ts +128 -0
  98. package/src/departments.ts +318 -0
  99. package/src/desktop-message-seam.test.ts +150 -0
  100. package/src/desktop-message.test.ts +368 -0
  101. package/src/dm-file-scope-http.test.ts +227 -0
  102. package/src/empty-node-sweeper.test.ts +104 -0
  103. package/src/empty-node-sweeper.ts +88 -0
  104. package/src/env-transport-gate-http.test.ts +240 -0
  105. package/src/env-transport-gate.ts +80 -0
  106. package/src/env-transport-policy.ts +56 -0
  107. package/src/etag-of.test.ts +57 -0
  108. package/src/event-loop-lag.test.ts +180 -0
  109. package/src/event-loop-lag.ts +201 -0
  110. package/src/expiry-counters.test.ts +187 -0
  111. package/src/expiry-counters.ts +227 -0
  112. package/src/expiry-evidence-db.test.ts +103 -0
  113. package/src/ext-token-shared.test.ts +60 -0
  114. package/src/ext-validation-regression.test.ts +10 -17
  115. package/src/external-schedule-edits-http.test.ts +321 -0
  116. package/src/external-schedule-edits-timestamps.test.ts +64 -0
  117. package/src/external-schedule-edits.ts +327 -0
  118. package/src/file-download-authz-dev-open.test.ts +1 -1
  119. package/src/file-download-authz.test.ts +25 -4
  120. package/src/file-download-date-bucket.test.ts +1 -1
  121. package/src/file-network-scope-dev-open.test.ts +1 -1
  122. package/src/file-network-scope.test.ts +7 -6
  123. package/src/group-membership-events-http.test.ts +264 -0
  124. package/src/group-messages-http.test.ts +483 -0
  125. package/src/group-messages.ts +297 -0
  126. package/src/health-anon-readers.ts +67 -0
  127. package/src/health-host-disk-2756.test.ts +71 -0
  128. package/src/health-identity-root.test.ts +98 -0
  129. package/src/health-redaction.test.ts +1599 -7
  130. package/src/health-status-reasons.test.ts +84 -0
  131. package/src/host-supervisor-identity-http.test.ts +152 -0
  132. package/src/host-supervisor-identity.ts +92 -0
  133. package/src/host-supervisors-daemon-version.test.ts +137 -0
  134. package/src/http-gzip.test.ts +94 -0
  135. package/src/http-gzip.ts +112 -0
  136. package/src/hub-catalog-read-http.test.ts +664 -0
  137. package/src/hub-provider-config.test.ts +166 -0
  138. package/src/hub-provider-config.ts +202 -0
  139. package/src/hub-timestamp.test.ts +38 -0
  140. package/src/hub-timestamp.ts +27 -0
  141. package/src/human-dm.ts +215 -0
  142. package/src/human-inbox.ts +42 -0
  143. package/src/inbox-caller.ts +49 -0
  144. package/src/inbox-count-sse.test.ts +318 -0
  145. package/src/inbox-count.ts +29 -0
  146. package/src/index.ts +6 -2
  147. package/src/license-state.test.ts +105 -0
  148. package/src/license-state.ts +48 -0
  149. package/src/lifecycle-error-domain.test.ts +149 -0
  150. package/src/list-ack-error-domain.test.ts +108 -0
  151. package/src/list-host-supervisors.test.ts +15 -4
  152. package/src/list-tasks-omit-default.test.ts +84 -0
  153. package/src/list-tasks-since-last.test.ts +100 -0
  154. package/src/list-tasks-since.test.ts +104 -0
  155. package/src/mcp-context-cost-http.test.ts +127 -0
  156. package/src/mcp-inflight.test.ts +92 -0
  157. package/src/mcp-inflight.ts +38 -0
  158. package/src/mcp-projects-events-http.test.ts +168 -0
  159. package/src/mcp-route-label-http.test.ts +120 -0
  160. package/src/mcp-write-network-resolution.test.ts +21 -0
  161. package/src/member-audit-network-id-http.test.ts +93 -0
  162. package/src/member-presence-http.test.ts +210 -0
  163. package/src/messages-ack-by-agent-http.test.ts +142 -0
  164. package/src/migrate-sqlite-to-pg.test.ts +47 -0
  165. package/src/migrate-sqlite-to-pg.ts +263 -0
  166. package/src/model-auth-notify-http.test.ts +181 -0
  167. package/src/model-auth-notify.ts +116 -0
  168. package/src/network-name-http.test.ts +75 -0
  169. package/src/network-quota-config.test.ts +100 -0
  170. package/src/network-rules-http.test.ts +169 -0
  171. package/src/network-rules.ts +129 -0
  172. package/src/network-scope.ts +222 -3
  173. package/src/network-token-membership-http.test.ts +186 -0
  174. package/src/node-alias-control.ts +12 -0
  175. package/src/node-attrs.test.ts +47 -2
  176. package/src/node-caller-identity-http.test.ts +1108 -0
  177. package/src/node-config-last-update.test.ts +126 -0
  178. package/src/node-config-last-update.ts +107 -0
  179. package/src/node-create-request-status-http.test.ts +105 -0
  180. package/src/node-daemon-bindings.test.ts +142 -0
  181. package/src/node-daemon-bindings.ts +135 -0
  182. package/src/node-failure-alert.test.ts +150 -0
  183. package/src/node-failure-alert.ts +177 -0
  184. package/src/node-files-transport.test.ts +350 -0
  185. package/src/node-health-codex-login.test.ts +120 -0
  186. package/src/node-health-dispatch-http.test.ts +373 -0
  187. package/src/node-health-guard-origin.test.ts +98 -0
  188. package/src/node-health-guard.ts +121 -0
  189. package/src/node-health-passthrough.test.ts +115 -0
  190. package/src/node-health-store.ts +101 -0
  191. package/src/node-id-alias.test.ts +190 -0
  192. package/src/node-identity-conflict-http.test.ts +269 -0
  193. package/src/node-identity-conflict.ts +142 -0
  194. package/src/node-identity-mismatch.test.ts +74 -0
  195. package/src/node-in-flight-tasks.ts +31 -0
  196. package/src/node-lifecycle-controllable.test.ts +64 -0
  197. package/src/node-lifecycle-controllable.ts +53 -0
  198. package/src/node-lifecycle-read-http.test.ts +257 -0
  199. package/src/node-lifecycle-read.ts +126 -0
  200. package/src/node-logs-transport.test.ts +266 -0
  201. package/src/node-peer-allowlist.test.ts +114 -0
  202. package/src/node-permissions-http.test.ts +901 -0
  203. package/src/node-permissions.ts +496 -0
  204. package/src/node-request-retention.test.ts +281 -0
  205. package/src/node-request-retention.ts +120 -0
  206. package/src/node-secret-rest-http.test.ts +190 -0
  207. package/src/node-secret-vault-inject.test.ts +132 -0
  208. package/src/node-security-write-gate.test.ts +72 -0
  209. package/src/node-serviceability.test.ts +86 -0
  210. package/src/node-serviceability.ts +124 -0
  211. package/src/node-session-control-http.test.ts +398 -0
  212. package/src/node-session-control.ts +316 -0
  213. package/src/node-skills-transport.test.ts +212 -0
  214. package/src/node-token-identity.ts +35 -0
  215. package/src/node-token-ownership.ts +51 -0
  216. package/src/node-token-privilege-http.test.ts +224 -0
  217. package/src/node-token-usage.test.ts +128 -0
  218. package/src/node-token-usage.ts +228 -0
  219. package/src/not-found-api-http.test.ts +67 -0
  220. package/src/observer-avatar-http.test.ts +103 -10
  221. package/src/observer-push.test.ts +76 -0
  222. package/src/opencode-catalog-report-http.test.ts +139 -0
  223. package/src/opencode-v2-catalog.test.ts +282 -0
  224. package/src/opencode-v2-catalog.ts +357 -0
  225. package/src/package-self-contained.test.ts +32 -0
  226. package/src/package-version-consistency.test.ts +25 -0
  227. package/src/parent-infer.test.ts +82 -0
  228. package/src/parent-infer.ts +110 -0
  229. package/src/parent-source-marker.test.ts +70 -0
  230. package/src/parent-source-orphan.test.ts +121 -0
  231. package/src/password-network-tokens.ts +25 -0
  232. package/src/peer-reply-atomic.test.ts +462 -0
  233. package/src/peer-reply-capability.test.ts +70 -0
  234. package/src/pg-worker.ts +87 -0
  235. package/src/poll-pacing.test.ts +74 -0
  236. package/src/poll-pacing.ts +123 -0
  237. package/src/probe-provider-error-domain.test.ts +145 -0
  238. package/src/project-dir-warn-clear-http.test.ts +132 -0
  239. package/src/project-viewer-can-http.test.ts +116 -0
  240. package/src/provider-skill-error-domain.test.ts +130 -0
  241. package/src/provider-tools-shape.test.ts +165 -0
  242. package/src/push.test.ts +20 -10
  243. package/src/push.ts +373 -9
  244. package/src/redact-tokens.test.ts +86 -0
  245. package/src/redact-tokens.ts +43 -0
  246. package/src/rejection-counters.test.ts +72 -0
  247. package/src/rejection-counters.ts +173 -0
  248. package/src/rename.ts +38 -10
  249. package/src/reply-target-derivation.test.ts +96 -0
  250. package/src/report-status-handover-capabilities-http.test.ts +124 -0
  251. package/src/report-status-host-schema.test.ts +272 -0
  252. package/src/report-status-resume-id-handover.test.ts +184 -0
  253. package/src/report-status-secret-keys.test.ts +140 -0
  254. package/src/require-explicit-test-db.ts +9 -0
  255. package/src/requirement-due-reminders-http.test.ts +620 -0
  256. package/src/requirement-due-reminders.ts +416 -0
  257. package/src/requirement-events-http.test.ts +318 -0
  258. package/src/requirement-events.test.ts +45 -0
  259. package/src/requirement-events.ts +144 -0
  260. package/src/requirement-notify.ts +165 -0
  261. package/src/requirement-participant-notify-http.test.ts +313 -0
  262. package/src/requirement-tag-ops-http.test.ts +454 -0
  263. package/src/requirement-tag-tree-http.test.ts +275 -0
  264. package/src/requirement-tag-tree.ts +127 -0
  265. package/src/requirement-tags.ts +102 -0
  266. package/src/requirements-abandoned-http.test.ts +236 -0
  267. package/src/requirements-assignee-drift.test.ts +154 -0
  268. package/src/requirements-comment-http.test.ts +174 -0
  269. package/src/requirements-completed-at-migration.test.ts +70 -0
  270. package/src/requirements-errors-mcp-http.test.ts +164 -0
  271. package/src/requirements-errors.ts +158 -0
  272. package/src/requirements-etag-http.test.ts +91 -0
  273. package/src/requirements-http.test.ts +709 -0
  274. package/src/requirements-last-event-http.test.ts +349 -0
  275. package/src/requirements-list-mcp-slim-http.test.ts +155 -0
  276. package/src/requirements-list-slim-http.test.ts +324 -0
  277. package/src/requirements-mcp.test.ts +180 -0
  278. package/src/requirements-migrate.ts +283 -0
  279. package/src/requirements-owner-strict-mcp-http.test.ts +145 -0
  280. package/src/requirements-people-http.test.ts +114 -0
  281. package/src/requirements-people-mcp-http.test.ts +231 -0
  282. package/src/requirements-people.ts +196 -0
  283. package/src/requirements-priority-lowest.test.ts +114 -0
  284. package/src/requirements-projects-network-echo.test.ts +57 -0
  285. package/src/requirements-projects-parent-http.test.ts +123 -0
  286. package/src/requirements-search-http.test.ts +182 -0
  287. package/src/requirements-search.test.ts +32 -0
  288. package/src/requirements-search.ts +145 -0
  289. package/src/requirements-seq-http.test.ts +193 -0
  290. package/src/requirements-seq-migration.test.ts +63 -0
  291. package/src/requirements-start-date.test.ts +125 -0
  292. package/src/requirements-stats-http.test.ts +357 -0
  293. package/src/requirements-stats.ts +195 -0
  294. package/src/requirements-status-participants-http.test.ts +222 -0
  295. package/src/requirements-upgrade-e2e.test.ts +126 -0
  296. package/src/requirements-upgrade-migration.test.ts +98 -0
  297. package/src/requirements.ts +2205 -0
  298. package/src/resolve-port.test.ts +57 -0
  299. package/src/resolve-port.ts +44 -0
  300. package/src/rest-alias-network-fallback-http.test.ts +123 -0
  301. package/src/rest-alias-network-fallback.test.ts +60 -0
  302. package/src/rest-alias-network-fallback.ts +65 -0
  303. package/src/rest-explicit-columns-http.test.ts +266 -0
  304. package/src/rest-identity.test.ts +130 -0
  305. package/src/rest-identity.ts +141 -0
  306. package/src/rest-projections.ts +72 -0
  307. package/src/rest-read-network-real-chain.test.ts +97 -0
  308. package/src/rest-write-network-resolution.test.ts +133 -0
  309. package/src/restart-readiness-http.test.ts +121 -0
  310. package/src/restricted-files.ts +76 -0
  311. package/src/retention-first-sweep-quiet.test.ts +31 -0
  312. package/src/retention.test.ts +100 -40
  313. package/src/retention.ts +423 -104
  314. package/src/route-callers-http.test.ts +120 -0
  315. package/src/route-timing.test.ts +218 -0
  316. package/src/route-timing.ts +262 -0
  317. package/src/rules-file-duplicate-alias.test.ts +234 -0
  318. package/src/rules-file-session-target.test.ts +207 -0
  319. package/src/rules-file-transport.test.ts +280 -0
  320. package/src/runtime-label.test.ts +22 -0
  321. package/src/runtime-label.ts +21 -0
  322. package/src/runtime-readiness.ts +90 -0
  323. package/src/schedule-agent-mcp-http.test.ts +486 -0
  324. package/src/schedule-agent.ts +252 -0
  325. package/src/schedule-starved.test.ts +92 -0
  326. package/src/schedule-starved.ts +114 -0
  327. package/src/scheduled-backoff-http.test.ts +203 -0
  328. package/src/scheduled-backoff.ts +64 -0
  329. package/src/scheduled-doorbell-nodeless-session.test.ts +134 -0
  330. package/src/scheduled-failure-backoff-2622.test.ts +145 -0
  331. package/src/scheduled-failure-code.test.ts +73 -0
  332. package/src/scheduled-failure-code.ts +105 -0
  333. package/src/scheduled-failures-http.test.ts +279 -0
  334. package/src/scheduled-failures.ts +425 -0
  335. package/src/scheduled-noprogress-backoff-2622.test.ts +163 -0
  336. package/src/scheduled-offline-backoff-probe.test.ts +56 -0
  337. package/src/scheduled-offline.test.ts +131 -0
  338. package/src/scheduled-offline.ts +66 -0
  339. package/src/scheduled-outcome-guidance-http.test.ts +139 -0
  340. package/src/scheduled-outcome-guidance.ts +9 -0
  341. package/src/scheduled-reply-unread-http.test.ts +212 -0
  342. package/src/scheduled-requirement-wake-http.test.ts +289 -0
  343. package/src/scheduled-requirement-wake.ts +125 -0
  344. package/src/scheduled-run-terminal.test.ts +290 -0
  345. package/src/scheduled-skip-blocking-task.test.ts +120 -0
  346. package/src/scheduled-skip-path-backoff-2622.test.ts +98 -0
  347. package/src/scheduled-stuck-http.test.ts +316 -0
  348. package/src/scheduled-stuck-notice-cap.test.ts +80 -0
  349. package/src/scheduled-stuck.ts +219 -0
  350. package/src/scheduled-tasks-http.test.ts +679 -0
  351. package/src/scheduled-tasks.ts +964 -0
  352. package/src/scheduled-work-outcome-http.test.ts +154 -0
  353. package/src/scheduled-work-outcome.ts +50 -0
  354. package/src/scoped-secrets.ts +167 -0
  355. package/src/secret-echo-negative-control.test.ts +118 -0
  356. package/src/send-dedup-request-id.test.ts +229 -0
  357. package/src/send-reply-agent-warning.test.ts +38 -38
  358. package/src/send-reply-alias-optional.test.ts +131 -0
  359. package/src/send-reply-attachments.test.ts +28 -7
  360. package/src/send_dedup.test.ts +54 -0
  361. package/src/send_dedup.ts +52 -6
  362. package/src/serve-error.test.ts +73 -0
  363. package/src/serve-error.ts +56 -0
  364. package/src/server.ts +5033 -377
  365. package/src/session-fork-store.test.ts +43 -0
  366. package/src/session-fork-store.ts +51 -0
  367. package/src/session-project-attach-migration.test.ts +22 -0
  368. package/src/session-project-attach-native.test.ts +121 -0
  369. package/src/session-project-create-http.test.ts +407 -0
  370. package/src/session-project-create-native.test.ts +290 -0
  371. package/src/session-project-create.ts +159 -0
  372. package/src/session-source-admission-store.ts +58 -0
  373. package/src/session-source-create.test.ts +155 -0
  374. package/src/session-source-create.ts +97 -0
  375. package/src/session-source-delivery.ts +109 -0
  376. package/src/session-source-directory-http.test.ts +192 -0
  377. package/src/session-source-evidence.test.ts +898 -0
  378. package/src/session-source-evidence.ts +191 -0
  379. package/src/session-source-execution.ts +87 -0
  380. package/src/session-source-grant.test.ts +117 -0
  381. package/src/session-source-grant.ts +78 -0
  382. package/src/session-source-issuer.test.ts +250 -0
  383. package/src/session-source-issuer.ts +164 -0
  384. package/src/session-source-transport.ts +375 -0
  385. package/src/session-task-on-dispatch.ts +14 -0
  386. package/src/session-token-ownership-http.test.ts +122 -0
  387. package/src/shared/codex-inventory.ts +41 -0
  388. package/src/shared/daemon-provider-login.ts +31 -0
  389. package/src/shared/daemon-provider-snapshot.ts +52 -0
  390. package/src/shared/external-schedule-contract.ts +60 -0
  391. package/src/shared/node-name.test.ts +62 -0
  392. package/src/shared/node-name.ts +161 -0
  393. package/src/shared/probe-host-allowlist-drift.test.ts +45 -0
  394. package/src/shared/provider-application.ts +29 -0
  395. package/src/shared/provider-collection.ts +14 -0
  396. package/src/shared/provider-initialization.ts +8 -0
  397. package/src/shared/reserved-env-drift.test.ts +10 -0
  398. package/src/shared/scoped-secret-contract.ts +5 -0
  399. package/src/shared/task-content-limit-drift.test.ts +28 -0
  400. package/src/shared/task-content-limit.ts +25 -0
  401. package/src/side-thread-command-transport.test.ts +312 -0
  402. package/src/side-thread-command-transport.ts +318 -0
  403. package/src/side-thread-http-integration.test.ts +233 -0
  404. package/src/side-thread-http.ts +504 -0
  405. package/src/side-thread-production.test.ts +72 -0
  406. package/src/side-thread-production.ts +118 -0
  407. package/src/side-thread.test.ts +1067 -0
  408. package/src/side-thread.ts +2499 -0
  409. package/src/skillhub-http.test.ts +144 -0
  410. package/src/sqlite-close-checkpoint.test.ts +78 -0
  411. package/src/start-node.test.ts +265 -0
  412. package/src/start-request-error-domain.test.ts +182 -0
  413. package/src/start-skill-error-domain.test.ts +122 -0
  414. package/src/stats-versions-http.test.ts +65 -0
  415. package/src/status-alias-filter-http.test.ts +106 -0
  416. package/src/status-alias-resolver-http.test.ts +163 -0
  417. package/src/status-alias-resolver.ts +19 -0
  418. package/src/status-node-id-filter-http.test.ts +161 -0
  419. package/src/status-node-secrets-capable-http.test.ts +44 -0
  420. package/src/status-read-cache-http.test.ts +229 -0
  421. package/src/status-read-cache.ts +129 -0
  422. package/src/stop-delete-node.test.ts +567 -1
  423. package/src/task-access-http.test.ts +407 -0
  424. package/src/task-access.ts +420 -0
  425. package/src/task-activity.ts +60 -0
  426. package/src/task-auth-origin-http.test.ts +93 -0
  427. package/src/task-auth-origin.test.ts +24 -0
  428. package/src/task-auth-origin.ts +7 -0
  429. package/src/task-consumption.test.ts +512 -0
  430. package/src/task-diagnostic-http.test.ts +149 -0
  431. package/src/task-diagnostic.test.ts +115 -0
  432. package/src/task-diagnostic.ts +118 -0
  433. package/src/task-expiry-notice-http.test.ts +298 -0
  434. package/src/task-expiry-notice.ts +318 -0
  435. package/src/task-idempotency-mcp.test.ts +148 -0
  436. package/src/task-idempotency.test.ts +76 -0
  437. package/src/task-idempotency.ts +81 -0
  438. package/src/task-late-replies.ts +54 -0
  439. package/src/task-late-reply-http.test.ts +227 -0
  440. package/src/task-lifecycle-watcher-busy.test.ts +114 -0
  441. package/src/task-lifecycle-watcher.test.ts +209 -0
  442. package/src/task-lifecycle-watcher.ts +109 -0
  443. package/src/task-network-resolution-http.test.ts +140 -0
  444. package/src/task-not-found-error-domain.test.ts +117 -0
  445. package/src/task-offline-delivery-2668.test.ts +119 -0
  446. package/src/task-offline-delivery.ts +81 -0
  447. package/src/task-orphan-http.test.ts +287 -0
  448. package/src/task-orphan.ts +119 -0
  449. package/src/task-queue-ahead-http.test.ts +309 -0
  450. package/src/task-queue-ahead-scale.test.ts +236 -0
  451. package/src/task-queue-ahead.ts +186 -0
  452. package/src/task-rejection-log-http.test.ts +160 -0
  453. package/src/task-rejection-log.ts +61 -0
  454. package/src/task-sender-http.test.ts +143 -0
  455. package/src/task-stale-open-http.test.ts +292 -0
  456. package/src/task-stale-open.ts +103 -0
  457. package/src/tasks-pagination-http.test.ts +141 -0
  458. package/src/team-rules-status-http.test.ts +90 -0
  459. package/src/team-rules-status.test.ts +59 -0
  460. package/src/team-rules-status.ts +72 -0
  461. package/src/tmux-allowlist.test.ts +48 -0
  462. package/src/token-usage-http.test.ts +156 -0
  463. package/src/tool-audience-http.test.ts +266 -0
  464. package/src/tool-audience.ts +130 -0
  465. package/src/tools-list-json-schema.test.ts +94 -0
  466. package/src/tools.ts +4530 -471
  467. package/src/update-node-config-error-domain.test.ts +107 -0
  468. package/src/uploads-http.test.ts +6 -4
  469. package/src/uploads.ts +23 -4
  470. package/src/user-avatar-http.test.ts +74 -0
  471. package/src/user-avatar-image.ts +160 -0
  472. package/src/user-avatar-migration.test.ts +25 -0
  473. package/src/user-avatar-upload-http.test.ts +353 -0
  474. package/src/user-inbox-by-agent-http.test.ts +189 -0
  475. package/src/user-inbox-netid-notnull.test.ts +122 -0
  476. package/src/user-inbox-read-http.test.ts +223 -0
  477. package/src/user-inbox-schema.test.ts +54 -0
  478. package/src/version-stats.test.ts +66 -0
  479. package/src/version-stats.ts +109 -0
@@ -0,0 +1,191 @@
1
+ import { randomBytes, randomUUID } from "node:crypto";
2
+ import { db } from "./db";
3
+ import { resolveToken } from "./auth";
4
+ import { readSessionControlCredential } from "./node-session-control";
5
+ import { resolveNodeCaller } from "./create-node";
6
+ import { canRestWriteNetwork } from "./network-scope";
7
+ import { createSessionSourceIssuer, type SourceSelection } from "./session-source-issuer";
8
+ import { createSessionSourceCreateAdapter, type SourceCreateReceipt, type VerifiedSourceCreateContext } from "./session-source-create";
9
+ import { createSessionSourceGrantStore, type SessionSourceBinding } from "./session-source-grant";
10
+ import { validateName } from "./create-node-validate";
11
+ import { isSourceReadEvidence, sameSourceChallenge, isSourceLeaseConfirmation, sameSourceRecheck,
12
+ type SourceLeaseRecheck, type SourceReadChallenge, type SourceReadEvidence } from "./contracts/session-source-evidence";
13
+
14
+ export type SourceAdmissionReceipt = SourceCreateReceipt & {
15
+ source_ref: string; scope: "admission_only"; intent_id: string;
16
+ execution: { protocol: "source-aware-v1-required"; guard: "daemon_recheck_in_execution_context_required";
17
+ lease_kind: "process_local_lease"; lease_id: string; evidence_request_id: string; recheck_request_id: string;
18
+ authorized_until: number; mode: SourceSelection["mode"]; dispatchable: false };
19
+ };
20
+
21
+ // Internal, explicitly opt-in, process-local queue. No HTTP/MCP registration or
22
+ // SSE doorbell. No secret/config path is in a challenge. Restart loses all rows.
23
+ export function createSessionSourceEvidenceQueue(options: { enabled?: boolean } = {}) {
24
+ const issuer = createSessionSourceIssuer();
25
+ type Entry = { q: SourceReadChallenge; selection: SourceSelection; userId: string; tokenId: string;
26
+ daemonTokenId?: string; evidence?: SourceReadEvidence;
27
+ recheck?: { q: SourceLeaseRecheck; taken: boolean; confirmed: boolean } };
28
+ const entries = new Map<string, Entry>();
29
+ const available = (id: string) => {
30
+ const e = entries.get(id);
31
+ if (!options.enabled || !e || Date.now() >= e.q.expires_at) { entries.delete(id); return null; }
32
+ const current = issuer.inspectStoredRequester(e.tokenId, e.userId, e.selection);
33
+ const source = db.get<{ alias: string }>("SELECT alias FROM nodes WHERE node_id=?1 AND network_id=?2", e.q.source_node_id, e.q.network_id);
34
+ if (!("permissions_verified" in current) || source?.alias !== e.q.alias) { entries.delete(id); return null; }
35
+ return e;
36
+ };
37
+ const daemon = (req: Request, e: Entry): string | null => {
38
+ const auth = resolveToken(req.headers.get("authorization")?.match(/^Bearer (\S+)$/)?.[1] ?? "");
39
+ if (!auth?.tokenId || auth.networkId !== e.q.network_id) return null;
40
+ const c = readSessionControlCredential(auth.tokenId), n = resolveNodeCaller(auth.tokenId);
41
+ return c?.scope === "network" && c.bound_node_id === e.q.daemon_node_id
42
+ && n.ok && n.kind === "node" && n.nodeId === e.q.daemon_node_id && n.networkId === e.q.network_id
43
+ && canRestWriteNetwork({ userId: c.user_id, networkId: c.network_id }, e.q.network_id, false) ? auth.tokenId : null;
44
+ };
45
+ const api = {
46
+ /** Authenticated admission lookup for the source-aware execution queue only.
47
+ * Reads immutable rows; a caller cannot provide a receipt/binding payload. */
48
+ executionSource(req: Request, admissionId: string) {
49
+ const row = db.get<SessionSourceBinding & { evidence_request_id: string; lease_id: string; recheck_request_id: string; authorized_until: number }>(`SELECT g.*,i.evidence_request_id,i.lease_id,i.recheck_request_id,i.authorized_until
50
+ FROM session_source_admission_intents i JOIN node_create_requests n ON n.request_id=i.create_request_id AND n.source_ref=i.source_ref
51
+ JOIN session_source_grants g ON g.source_ref=n.source_ref AND g.create_request_id=n.request_id
52
+ WHERE n.request_id=?1 AND n.status='source_reserved' AND i.state='reserved' AND g.state='claimed'
53
+ AND g.binding_id=i.recheck_request_id AND g.server_generation='process_local:' || i.lease_id
54
+ AND n.network_id=g.network_id AND n.daemon_node_id=g.daemon_node_id AND n.workdir=g.canonical_directory
55
+ AND i.user_id=g.user_id AND i.network_id=g.network_id
56
+ AND i.execution_guard='daemon_recheck_in_execution_context_required'`, admissionId);
57
+ if (!row || Date.now() >= row.authorized_until) return null;
58
+ const evidence = api.result(req, row.evidence_request_id), e = available(row.evidence_request_id);
59
+ if (!e?.daemonTokenId || !evidence || evidence.lease_id !== row.lease_id || row.user_id !== evidence.request.user_id
60
+ || row.network_id !== evidence.request.network_id || row.source_node_id !== evidence.request.source_node_id
61
+ || row.daemon_node_id !== evidence.request.daemon_node_id || row.session_id !== evidence.request.session_id
62
+ || row.mode !== evidence.request.mode || row.canonical_directory !== evidence.canonical_directory) return null;
63
+ return { evidence, daemonTokenId: e.daemonTokenId, authorized_until: row.authorized_until };
64
+ },
65
+ queue(req: Request, selection: SourceSelection, sessionId: string): SourceReadChallenge | null {
66
+ if (!options.enabled || !/^ses_[A-Za-z0-9]{1,190}$/.test(sessionId)) return null;
67
+ for (const [id, e] of entries) if (Date.now() >= e.q.expires_at) entries.delete(id);
68
+ if (entries.size >= 128 || !("permissions_verified" in issuer.inspect(req, selection))) return null;
69
+ const auth = resolveToken(req.headers.get("authorization")?.match(/^Bearer (\S+)$/)?.[1] ?? "");
70
+ if (!auth?.tokenId) return null;
71
+ const source = db.get<{ alias: string }>("SELECT alias FROM nodes WHERE node_id=?1 AND network_id=?2", selection.source_node_id, selection.network_id);
72
+ if (!source?.alias) return null;
73
+ const q: SourceReadChallenge = { request_id: `srcq_${randomUUID()}`, challenge: randomBytes(32).toString("base64url"),
74
+ network_id: selection.network_id, daemon_node_id: selection.daemon_node_id, source_node_id: selection.source_node_id,
75
+ alias: source.alias, session_id: sessionId, expires_at: Date.now() + 15000,
76
+ user_id: auth.user.user_id, requester_token_id: auth.tokenId, mode: selection.mode };
77
+ entries.set(q.request_id, { q, selection: structuredClone(selection), userId: auth.user.user_id, tokenId: auth.tokenId });
78
+ return structuredClone(q);
79
+ },
80
+ take(req: Request, id: string): SourceReadChallenge | null {
81
+ const e = available(id); if (!e || e.daemonTokenId) return null;
82
+ const tokenId = daemon(req, e); if (!tokenId) return null;
83
+ e.daemonTokenId = tokenId;
84
+ return structuredClone(e.q);
85
+ },
86
+ ack(req: Request, value: unknown): boolean {
87
+ if (!isSourceReadEvidence(value)) return false;
88
+ const e = available(value.request.request_id);
89
+ if (!e || e.evidence || !e.daemonTokenId || daemon(req, e) !== e.daemonTokenId
90
+ || !sameSourceChallenge(e.q, value.request)) return false;
91
+ e.evidence = structuredClone(value); return true;
92
+ },
93
+ result(req: Request, id: string): SourceReadEvidence | null {
94
+ const e = available(id); if (!e?.evidence) return null;
95
+ const c = e.daemonTokenId ? readSessionControlCredential(e.daemonTokenId) : null;
96
+ const n = e.daemonTokenId ? resolveNodeCaller(e.daemonTokenId) : null;
97
+ if (!c || c.scope !== "network" || c.bound_node_id !== e.q.daemon_node_id || c.network_id !== e.q.network_id
98
+ || !n?.ok || n.kind !== "node" || n.nodeId !== e.q.daemon_node_id || n.networkId !== e.q.network_id
99
+ || !canRestWriteNetwork({ userId: c.user_id, networkId: c.network_id }, e.q.network_id, false)) return null;
100
+ const auth = resolveToken(req.headers.get("authorization")?.match(/^Bearer (\S+)$/)?.[1] ?? "");
101
+ return auth?.user.user_id === e.userId && auth.tokenId === e.tokenId ? structuredClone(e.evidence) : null;
102
+ },
103
+ takeRecheck(req: Request, evidenceRequestId: string): SourceLeaseRecheck | null {
104
+ const e = available(evidenceRequestId), r = e?.recheck;
105
+ if (!e || !r || r.taken || Date.now() >= r.q.expires_at || daemon(req, e) !== e.daemonTokenId) return null;
106
+ r.taken = true; return structuredClone(r.q);
107
+ },
108
+ ackRecheck(req: Request, value: unknown): boolean {
109
+ if (!isSourceLeaseConfirmation(value)) return false;
110
+ const e = available(value.request.evidence.request.request_id), r = e?.recheck;
111
+ if (!e || !r || !r.taken || r.confirmed || Date.now() >= r.q.expires_at
112
+ || daemon(req, e) !== e.daemonTokenId || !sameSourceRecheck(r.q, value.request)) return false;
113
+ r.confirmed = true; return true;
114
+ },
115
+ /** Internal async issuer + admission. dispatchRecheck only wakes the private
116
+ * authenticated pull/ack transport; its return value is never evidence.
117
+ * No await, HTTP, credential mint or SSE occurs in the SQL transaction. */
118
+ async admit(req: Request, id: string, intentId: string, name: string,
119
+ dispatchRecheck: (evidenceRequestId: string) => Promise<void>): Promise<SourceAdmissionReceipt> {
120
+ if (db.dialect !== "sqlite" || db.atomicTransactions !== true || db.transactionalFeaturesRefusal !== null)
121
+ throw Error("source_create_transactions_unsupported");
122
+ if (!/^[A-Za-z0-9_-]{1,200}$/.test(intentId)) throw Error("source_intent_invalid");
123
+ const childName = validateName(name), evidence = api.result(req, id), e = available(id);
124
+ if (!e || !evidence) throw Error("source_evidence_unavailable");
125
+ const r = { q: { request_id: `srcr_${randomUUID()}`, challenge: randomBytes(32).toString("base64url"), evidence,
126
+ intent_id: intentId, child_name: childName, expires_at: Math.min(e.q.expires_at, Date.now() + 5000) }, taken: false, confirmed: false };
127
+ // Persist the intent before awaiting. Conflict is an explicit refusal,
128
+ // including retries with a new evidence request or another queue instance.
129
+ try {
130
+ db.run(`INSERT INTO session_source_admission_intents
131
+ (user_id,network_id,intent_id,evidence_request_id,requester_token_id,child_name,lease_id,recheck_request_id,authorized_until,execution_guard,state)
132
+ VALUES (?1,?2,?3,?4,?5,?6,?7,?8,?9,'daemon_recheck_in_execution_context_required','checking')`,
133
+ [e.userId, e.q.network_id, intentId, id, e.tokenId, childName, evidence.lease_id, r.q.request_id, r.q.expires_at]);
134
+ } catch { throw Error("source_intent_already_associated"); }
135
+ e.recheck = r;
136
+ try {
137
+ await dispatchRecheck(id);
138
+ const revalidate = (): VerifiedSourceCreateContext => {
139
+ const current = api.result(req, id);
140
+ if (entries.get(id) !== e || e.recheck !== r || !r.confirmed || Date.now() >= r.q.expires_at || !current
141
+ || !sameSourceRecheck(r.q, { ...r.q, evidence: current })) throw Error("source_lease_recheck_required");
142
+ // This is an expiring process-local observation, not durable generation.
143
+ return { requesterTokenId: e.tokenId, binding: { user_id: e.userId, network_id: e.q.network_id,
144
+ daemon_node_id: e.q.daemon_node_id, source_node_id: e.q.source_node_id, session_id: e.q.session_id,
145
+ mode: e.selection.mode, canonical_directory: evidence.canonical_directory,
146
+ binding_id: r.q.request_id, server_generation: `process_local:${evidence.lease_id}` } };
147
+ };
148
+ return db.transaction(() => {
149
+ const context = revalidate(), now = Date.now();
150
+ const row = db.get<{ state: string }>(`SELECT state FROM session_source_admission_intents
151
+ WHERE user_id=?1 AND network_id=?2 AND intent_id=?3 AND evidence_request_id=?4 AND requester_token_id=?5 AND child_name=?6
152
+ AND lease_id=?7 AND recheck_request_id=?8 AND authorized_until=?9
153
+ AND execution_guard='daemon_recheck_in_execution_context_required'`,
154
+ e.userId, e.q.network_id, intentId, id, e.tokenId, childName, evidence.lease_id, r.q.request_id, r.q.expires_at);
155
+ if (row?.state !== "checking") throw Error("source_intent_already_associated");
156
+ const ref = createSessionSourceGrantStore(db).issue(context.binding, now, r.q.expires_at);
157
+ const receipt = createSessionSourceCreateAdapter(db).reserve(ref, childName, revalidate, now);
158
+ db.run(`UPDATE session_source_admission_intents SET state='reserved',source_ref=?1,create_request_id=?2
159
+ WHERE evidence_request_id=?3 AND state='checking'`, [ref, receipt.request_id, id]);
160
+ if (Date.now() >= r.q.expires_at) throw Error("source_lease_expired");
161
+ return { ...receipt, source_ref: ref, scope: "admission_only" as const, intent_id: intentId,
162
+ execution: { protocol: "source-aware-v1-required" as const, guard: "daemon_recheck_in_execution_context_required" as const,
163
+ lease_kind: "process_local_lease" as const, lease_id: evidence.lease_id, evidence_request_id: id,
164
+ recheck_request_id: r.q.request_id, authorized_until: r.q.expires_at, mode: e.selection.mode, dispatchable: false as const } };
165
+ });
166
+ } catch (error) {
167
+ db.run("UPDATE session_source_admission_intents SET state='refused' WHERE evidence_request_id=?1 AND state='checking'", [id]);
168
+ throw error;
169
+ } finally { e.recheck = undefined; }
170
+ },
171
+ /** Historical, read-only lost-response recovery. No lease continuation and
172
+ * deliberately no execution authorization, even while a daemon is live. */
173
+ recoverAdmission(req: Request, selection: SourceSelection, intentId: string) {
174
+ if (!options.enabled || !("permissions_verified" in issuer.inspect(req, selection))) return null;
175
+ const auth = resolveToken(req.headers.get("authorization")?.match(/^Bearer (\S+)$/)?.[1] ?? "");
176
+ if (!auth?.tokenId) return null;
177
+ const row = db.get<SessionSourceBinding & { source_ref: string }>(`SELECT g.* FROM session_source_admission_intents i
178
+ JOIN session_source_grants g ON g.source_ref=i.source_ref AND g.create_request_id=i.create_request_id
179
+ WHERE i.user_id=?1 AND i.network_id=?2 AND i.intent_id=?3 AND i.requester_token_id=?4 AND i.state='reserved'
180
+ AND g.source_node_id=?5 AND g.daemon_node_id=?6 AND g.mode=?7`, auth.user.user_id, selection.network_id, intentId,
181
+ auth.tokenId, selection.source_node_id, selection.daemon_node_id, selection.mode);
182
+ if (!row) return null;
183
+ const receipt = createSessionSourceCreateAdapter(db).recover(row.source_ref, () => {
184
+ if (!("permissions_verified" in issuer.inspect(req, selection))) throw Error("source_auth_required");
185
+ return { requesterTokenId: auth.tokenId!, binding: row };
186
+ });
187
+ return receipt ? { ...receipt, scope: "historical_admission_only" as const, execution: "not_authorized" as const, dispatchable: false as const } : null;
188
+ },
189
+ };
190
+ return api;
191
+ }
@@ -0,0 +1,87 @@
1
+ import { randomUUID } from "node:crypto";
2
+ import { db } from "./db";
3
+ import { resolveToken } from "./auth";
4
+ import { readSessionControlCredential } from "./node-session-control";
5
+ import { resolveNodeCaller } from "./create-node";
6
+ import { canRestWriteNetwork } from "./network-scope";
7
+ import { createSessionSourceIssuer } from "./session-source-issuer";
8
+ import type { createSessionSourceEvidenceQueue } from "./session-source-evidence";
9
+ import { isSourceExecutionTask, isSourceExecutionResult, type SourceExecutionTask, type SourceExecutionResult } from "./contracts/session-source-execution";
10
+
11
+ type Row = { execution_id: string; admission_request_id: string; task_json: string; user_id: string;
12
+ requester_token_id: string; daemon_token_id: string; state: string; result_json: string | null };
13
+ const auth = (req: Request) => resolveToken(req.headers.get("authorization")?.match(/^Bearer (\S+)$/)?.[1] ?? "");
14
+ /** Separate source-aware journal. No mutation of source_reserved, no ordinary
15
+ * daemon event/fallback. Constructor remains opt-in and no endpoints register. */
16
+ export function createSessionSourceExecutionQueue(evidenceQueue: ReturnType<typeof createSessionSourceEvidenceQueue>, options: { enabled?: boolean } = {}) {
17
+ const issuer = createSessionSourceIssuer();
18
+ const row = (id: string) => db.get<Row>("SELECT * FROM session_source_executions WHERE execution_id=?1", id);
19
+ const task = (r: Row): SourceExecutionTask | null => {
20
+ try { const v = JSON.parse(r.task_json); return isSourceExecutionTask(v) ? v : null; } catch { return null; }
21
+ };
22
+ const permissions = (r: Row, t: SourceExecutionTask) => {
23
+ const q = t.evidence.request;
24
+ return "permissions_verified" in issuer.inspectStoredRequester(r.requester_token_id, r.user_id,
25
+ { network_id: q.network_id, daemon_node_id: q.daemon_node_id, source_node_id: q.source_node_id, mode: q.mode });
26
+ };
27
+ const daemon = (req: Request, r: Row, t: SourceExecutionTask) => {
28
+ const a = auth(req), c = a?.tokenId ? readSessionControlCredential(a.tokenId) : null;
29
+ const n = a?.tokenId ? resolveNodeCaller(a.tokenId) : null, q = t.evidence.request;
30
+ return a?.tokenId === r.daemon_token_id && c?.bound_node_id === q.daemon_node_id && c.network_id === q.network_id
31
+ && c.scope === "network" && n?.ok && n.kind === "node" && n.nodeId === q.daemon_node_id && n.networkId === q.network_id
32
+ && canRestWriteNetwork({ userId: c.user_id, networkId: c.network_id }, q.network_id, false);
33
+ };
34
+ return {
35
+ deliverySource(req: Request, id: string) {
36
+ if (!options.enabled) return null;
37
+ const r = row(id), t = r ? task(r) : null, a = auth(req);
38
+ if (!r || !t || !r.result_json || r.state !== "session_ready" || a?.tokenId !== r.requester_token_id
39
+ || a.user.user_id !== r.user_id || !permissions(r, t)) return null;
40
+ const v = JSON.parse(r.result_json);
41
+ if (!isSourceExecutionResult(v, t) || v.status !== "session_ready") return null;
42
+ if (!evidenceQueue.executionSource(req, r.admission_request_id)) return null;
43
+ const intent = db.get<{ child_name: string }>("SELECT child_name FROM session_source_admission_intents WHERE create_request_id=?1 AND state='reserved'", r.admission_request_id);
44
+ return intent ? { task: t, result: v, child_name: intent.child_name, daemonTokenId: r.daemon_token_id } : null;
45
+ },
46
+ queue(req: Request, admissionId: string): string | null {
47
+ if (!options.enabled || db.dialect !== "sqlite" || db.atomicTransactions !== true) return null;
48
+ const source = evidenceQueue.executionSource(req, admissionId), a = auth(req);
49
+ if (!source || !a?.tokenId) return null;
50
+ const t: SourceExecutionTask = { execution_id: `srcx_${randomUUID()}`, admission_request_id: admissionId,
51
+ evidence: source.evidence, authorized_until: source.authorized_until, owner_policy: "retain_existing_bridge_only" };
52
+ try {
53
+ db.run(`INSERT INTO session_source_executions (execution_id,admission_request_id,task_json,user_id,requester_token_id,daemon_token_id,state)
54
+ VALUES (?1,?2,?3,?4,?5,?6,'pending')`, [t.execution_id, admissionId, JSON.stringify(t), a.user.user_id, a.tokenId, source.daemonTokenId]);
55
+ return t.execution_id;
56
+ } catch { return null; } // one execution association per immutable admission
57
+ },
58
+ take(req: Request, id: string): SourceExecutionTask | null {
59
+ if (!options.enabled) return null;
60
+ return db.transaction(() => {
61
+ const r = row(id), t = r ? task(r) : null;
62
+ if (!r || !t || r.state !== "pending" || Date.now() >= t.authorized_until || !daemon(req, r, t) || !permissions(r, t)) return null;
63
+ // Durable BEFORE any daemon API. Lost delivery never permits re-take.
64
+ if (db.run("UPDATE session_source_executions SET state='claimed' WHERE execution_id=?1 AND state='pending'", [id]).changes !== 1) return null;
65
+ return structuredClone(t);
66
+ });
67
+ },
68
+ ack(req: Request, value: unknown): boolean {
69
+ if (!options.enabled || !value || typeof value !== "object") return false;
70
+ const r = row((value as any).execution_id), t = r ? task(r) : null;
71
+ if (!r || !t || !isSourceExecutionResult(value, t) || !daemon(req, r, t)) return false;
72
+ // Completion may arrive after observation expiry. Record an outcome, not
73
+ // authorization; it cannot dispatch another operation or regain a lease.
74
+ return db.run(`UPDATE session_source_executions SET state=?1,session_id=?2,result_json=?3
75
+ WHERE execution_id=?4 AND state='claimed'`, [value.status, value.session_id ?? null, JSON.stringify(value), r.execution_id]).changes === 1;
76
+ },
77
+ recover(req: Request, id: string): SourceExecutionResult | null {
78
+ if (!options.enabled) return null;
79
+ const r = row(id), t = r ? task(r) : null, a = auth(req);
80
+ if (!r || !t || a?.tokenId !== r.requester_token_id || a.user.user_id !== r.user_id || !permissions(r, t)) return null;
81
+ if (r.result_json) { const v = JSON.parse(r.result_json); return isSourceExecutionResult(v, t) ? v : null; }
82
+ // Read-only uncertain outcome: no reset, requeue or second POST, including
83
+ // after Hub process restart. Claimed state itself permanently blocks take.
84
+ return r.state === "claimed" ? { execution_id: id, admission_request_id: r.admission_request_id, status: "unknown", bridge: "not_created" } : null;
85
+ },
86
+ };
87
+ }
@@ -0,0 +1,117 @@
1
+ import { expect, test } from "bun:test";
2
+ import { Database } from "bun:sqlite";
3
+ import { mkdtempSync, rmSync } from "node:fs";
4
+ import { join } from "node:path";
5
+ import { tmpdir } from "node:os";
6
+ import { SQLiteAdapter } from "./db-adapter";
7
+ import type { DbAdapter } from "./db-adapter";
8
+ import { createSessionSourceGrantStore, sessionSourceGrantSchema, type SessionSourceBinding } from "./session-source-grant";
9
+
10
+ test("source grant binds every authority dimension and claims once across connections and reopen", () => {
11
+ const root = mkdtempSync(join(tmpdir(), "source4150-")), file = join(root, "grants.db");
12
+ const a = new SQLiteAdapter(new Database(file));
13
+ let b = new SQLiteAdapter(new Database(file));
14
+ try {
15
+ a.exec(sessionSourceGrantSchema);
16
+ const first = createSessionSourceGrantStore(a), second = createSessionSourceGrantStore(b);
17
+ const source: SessionSourceBinding = { user_id: "user_a", network_id: "net_a", source_node_id: "node_source",
18
+ daemon_node_id: "daemon_a", session_id: "ses_Source", binding_id: "binding_a",
19
+ server_generation: "generation_proof_a", canonical_directory: "/workspace/source", mode: "attach_existing" };
20
+ const ref = first.issue(source, 1000, 2000);
21
+ expect(ref).toMatch(/^src_[A-Za-z0-9_-]{43}$/);
22
+ expect(first.claimedRequest(ref, source)).toBeNull();
23
+ for (const field of Object.keys(source) as (keyof SessionSourceBinding)[]) {
24
+ const changed = { ...source, [field]: field === "mode" ? "fork_independent" : `${source[field]}_other` };
25
+ expect(second.claim(ref, changed as SessionSourceBinding, "cr_wrong", 1500)).toBe(false);
26
+ }
27
+ expect(second.claim(ref, source, "cr_early", 999)).toBe(false);
28
+ expect(second.claim(ref, source, "cr_expired", 2000)).toBe(false);
29
+ expect(first.claim(ref, source, "cr_first", 1500)).toBe(true);
30
+ expect(second.claimedRequest(ref, source)).toBe("cr_first");
31
+ for (const field of Object.keys(source) as (keyof SessionSourceBinding)[]) {
32
+ const changed = { ...source, [field]: field === "mode" ? "fork_independent" : `${source[field]}_other` };
33
+ expect(second.claimedRequest(ref, changed as SessionSourceBinding)).toBeNull();
34
+ }
35
+ expect(second.claim(ref, source, "cr_second", 1500)).toBe(false);
36
+ expect(second.claim(ref, source, "cr_first", 1500)).toBe(false);
37
+ b.close(); b = new SQLiteAdapter(new Database(file));
38
+ expect(createSessionSourceGrantStore(b).claimedRequest(ref, source)).toBe("cr_first");
39
+ expect(createSessionSourceGrantStore(b).claim(ref, source, "cr_late_replay", 3000)).toBe(false);
40
+ expect(createSessionSourceGrantStore(b).claimedRequest(ref, source)).toBe("cr_first");
41
+ expect(createSessionSourceGrantStore(b).claim(ref, source, "cr_after_restart", 1500)).toBe(false);
42
+ const other = first.issue(source, 1000, 2000);
43
+ expect(first.claim(other, source, "cr_first", 1500)).toBe(false);
44
+ expect(first.revoke(other)).toBe(true);
45
+ expect(first.claimedRequest(other, source)).toBeNull();
46
+ expect(first.claim(other, source, "cr_revoked", 1500)).toBe(false);
47
+ expect(first.revoke(ref)).toBe(false);
48
+ expect(() => first.issue(source, 1000, 61_001)).toThrow("session_source_grant_invalid");
49
+ expect(() => first.issue({ ...source, canonical_directory: "bad\npath" }, 1000, 2000)).toThrow();
50
+ expect(() => first.issue({ ...source, session_id: "latest" }, 1000, 2000)).toThrow();
51
+ expect(first.claim("not_a_ref", source, "cr_test", 1500)).toBe(false);
52
+ expect(first.claimedRequest("not_a_ref", source)).toBeNull();
53
+ const forkSource = { ...source, mode: "fork_independent" as const };
54
+ const forkRef = first.issue(forkSource, 1000, 2000);
55
+ const reopened = createSessionSourceGrantStore(b);
56
+ expect(reopened.claim(forkRef, forkSource, "cr_fork", 1500)).toBe(true);
57
+ expect(reopened.claim(forkRef, forkSource, "cr_fork", 1500)).toBe(false);
58
+ } finally { a.close(); b.close(); rmSync(root, { recursive: true, force: true }); }
59
+ });
60
+
61
+ test("source grants refuse unsupported adapters before issuing any SQL", () => {
62
+ const db = { dialect: "postgres", transactionalFeaturesRefusal: null,
63
+ run: () => { throw Error("SQL must not execute"); } } as unknown as DbAdapter;
64
+ const store = createSessionSourceGrantStore(db);
65
+ const source: SessionSourceBinding = { user_id: "u", network_id: "n", source_node_id: "s", daemon_node_id: "d",
66
+ session_id: "ses_Source", binding_id: "b", server_generation: "g", canonical_directory: "/work", mode: "attach_existing" };
67
+ expect(() => store.issue(source, 1000, 2000)).toThrow("session_source_grant_invalid");
68
+ expect(store.claim(`src_${"a".repeat(43)}`, source, "cr_test", 1500)).toBe(false);
69
+ expect(store.revoke(`src_${"a".repeat(43)}`)).toBe(false);
70
+ expect(store.claimedRequest(`src_${"a".repeat(43)}`, source)).toBeNull();
71
+ });
72
+
73
+ test("source grants require affirmative atomic transaction support", () => {
74
+ const source: SessionSourceBinding = { user_id: "u", network_id: "n", source_node_id: "s", daemon_node_id: "d",
75
+ session_id: "ses_Source", binding_id: "b", server_generation: "g", canonical_directory: "/work", mode: "attach_existing" };
76
+ for (const atomicTransactions of [false, undefined]) {
77
+ const db = { dialect: "sqlite", atomicTransactions, transactionalFeaturesRefusal: null,
78
+ run: () => { throw Error("SQL must not execute"); } } as unknown as DbAdapter;
79
+ const store = createSessionSourceGrantStore(db);
80
+ expect(() => store.issue(source, 1000, 2000)).toThrow("session_source_grant_invalid");
81
+ expect(store.claim(`src_${"a".repeat(43)}`, source, "cr_test", 1500)).toBe(false);
82
+ expect(store.revoke(`src_${"a".repeat(43)}`)).toBe(false);
83
+ expect(store.claimedRequest(`src_${"a".repeat(43)}`, source)).toBeNull();
84
+ }
85
+ });
86
+
87
+ test("source claim composes with same-connection intent insertion without partial admission", () => {
88
+ const db = new SQLiteAdapter(new Database(":memory:"));
89
+ try {
90
+ db.exec(sessionSourceGrantSchema);
91
+ // Storage composition fixture, NOT the production create-node adapter.
92
+ db.exec("CREATE TABLE admission_fixture (request_id TEXT PRIMARY KEY, name TEXT NOT NULL UNIQUE)");
93
+ const store = createSessionSourceGrantStore(db);
94
+ const source: SessionSourceBinding = { user_id: "u", network_id: "n", source_node_id: "s", daemon_node_id: "d",
95
+ session_id: "ses_Source", binding_id: "b", server_generation: "g", canonical_directory: "/work", mode: "attach_existing" };
96
+ const ref = store.issue(source, 1000, 2000);
97
+ db.run("INSERT INTO admission_fixture VALUES (?1,?2)", ["cr_existing", "taken"]);
98
+ expect(() => db.transaction(() => {
99
+ expect(store.claim(ref, source, "cr_new", 1500)).toBe(true);
100
+ db.run("INSERT INTO admission_fixture VALUES (?1,?2)", ["cr_new", "taken"]);
101
+ })).toThrow();
102
+ expect(db.get("SELECT state,create_request_id FROM session_source_grants WHERE source_ref=?1", ref))
103
+ .toEqual({ state: "issued", create_request_id: null });
104
+ expect(db.get("SELECT request_id FROM admission_fixture WHERE request_id=?1", "cr_new")).toBeNull();
105
+ db.transaction(() => {
106
+ expect(store.claim(ref, source, "cr_new", 1500)).toBe(true);
107
+ db.run("INSERT INTO admission_fixture VALUES (?1,?2)", ["cr_new", "available"]);
108
+ });
109
+ expect(db.get("SELECT state,create_request_id FROM session_source_grants WHERE source_ref=?1", ref))
110
+ .toEqual({ state: "claimed", create_request_id: "cr_new" });
111
+ expect(db.get("SELECT request_id FROM admission_fixture WHERE request_id=?1", "cr_new"))
112
+ .toEqual({ request_id: "cr_new" });
113
+ // A lost response after commit must not reopen the grant or replay creation.
114
+ expect(store.claim(ref, source, "cr_new", 1500)).toBe(false);
115
+ expect(db.get<{ count: number }>("SELECT count(*) AS count FROM admission_fixture")?.count).toBe(2);
116
+ } finally { db.close(); }
117
+ });
@@ -0,0 +1,78 @@
1
+ import { randomBytes } from "node:crypto";
2
+ import type { DbAdapter } from "./db-adapter";
3
+
4
+ /** Internal storage only. No HTTP/MCP issuer is enabled. A caller must obtain
5
+ * these fields from authenticated live daemon evidence, not client input, and
6
+ * independently enforce create_node and source-session access on every claim. */
7
+ export type SessionSourceBinding = {
8
+ user_id: string; network_id: string; source_node_id: string; daemon_node_id: string;
9
+ session_id: string; binding_id: string; server_generation: string; canonical_directory: string;
10
+ mode: "attach_existing" | "fork_independent";
11
+ };
12
+ // server_generation is a legacy storage key, NOT automatically incarnation
13
+ // proof. Internal async admission uses process_local:<opaque lease> explicitly;
14
+ // such grants only reserve admission, never authorize daemon execution/restart.
15
+ const fields = ["user_id", "network_id", "source_node_id", "daemon_node_id", "session_id",
16
+ "binding_id", "server_generation", "canonical_directory", "mode"] as const;
17
+ export const sessionSourceGrantSchema = `CREATE TABLE IF NOT EXISTS session_source_grants (
18
+ source_ref TEXT PRIMARY KEY,
19
+ user_id TEXT NOT NULL, network_id TEXT NOT NULL, source_node_id TEXT NOT NULL,
20
+ daemon_node_id TEXT NOT NULL, session_id TEXT NOT NULL, binding_id TEXT NOT NULL,
21
+ server_generation TEXT NOT NULL, canonical_directory TEXT NOT NULL, mode TEXT NOT NULL
22
+ CHECK(mode IN ('attach_existing','fork_independent')),
23
+ issued_at INTEGER NOT NULL, expires_at INTEGER NOT NULL,
24
+ state TEXT NOT NULL CHECK(state IN ('issued','claimed','revoked')),
25
+ create_request_id TEXT UNIQUE
26
+ );`;
27
+
28
+ const valid = (b: SessionSourceBinding) => fields.every(f => typeof b[f] === "string"
29
+ && b[f].length > 0 && b[f].length <= (f === "canonical_directory" ? 4096 : 200)
30
+ && !/[\x00-\x1f\x7f]/.test(b[f])) && /^ses_[A-Za-z0-9]+$/.test(b.session_id)
31
+ && (b.mode === "attach_existing" || b.mode === "fork_independent");
32
+ const refValid = (ref: string) => /^src_[A-Za-z0-9_-]{43}$/.test(ref);
33
+
34
+ export function createSessionSourceGrantStore(db: DbAdapter) {
35
+ const supported = () => db.dialect === "sqlite" && db.atomicTransactions === true
36
+ && db.transactionalFeaturesRefusal === null;
37
+ return {
38
+ issue(binding: SessionSourceBinding, now: number, expiresAt: number): string {
39
+ if (!supported() || !valid(binding) || !Number.isSafeInteger(now) || now < 0
40
+ || !Number.isSafeInteger(expiresAt) || expiresAt <= now || expiresAt - now > 60_000) {
41
+ throw Error("session_source_grant_invalid");
42
+ }
43
+ const ref = `src_${randomBytes(32).toString("base64url")}`;
44
+ db.run(`INSERT INTO session_source_grants (source_ref,${fields.join(",")},issued_at,expires_at,state)
45
+ VALUES (?1,?2,?3,?4,?5,?6,?7,?8,?9,?10,?11,?12,'issued')`,
46
+ [ref, ...fields.map(f => binding[f]), now, expiresAt]);
47
+ return ref;
48
+ },
49
+ /** CAS consumes before dispatch; never unclaim on timeout/ACK loss. An
50
+ * identical retry is also refused: recover the creation receipt separately.
51
+ * Binding must be freshly revalidated at launch, not just when issued. */
52
+ claim(ref: string, binding: SessionSourceBinding, createRequestId: string, now: number): boolean {
53
+ if (!supported() || !refValid(ref) || !valid(binding) || !Number.isSafeInteger(now)
54
+ || !/^cr_[A-Za-z0-9_-]{1,190}$/.test(createRequestId)) return false;
55
+ return db.run(`UPDATE session_source_grants SET state='claimed',create_request_id=?1
56
+ WHERE source_ref=?2 AND state='issued' AND issued_at<=?3 AND expires_at>?3
57
+ AND ${fields.map((f, i) => `${f}=?${i + 4}`).join(" AND ")}
58
+ AND NOT EXISTS (SELECT 1 FROM session_source_grants WHERE create_request_id=?1)`,
59
+ [createRequestId, ref, now, ...fields.map(f => binding[f])]).changes === 1;
60
+ },
61
+ /** Read-only recovery after a lost admission response, including after the
62
+ * grant deadline. The caller must reauthenticate and reauthorize access;
63
+ * possession of ref or a client-supplied binding is not authority. This ID
64
+ * is not creation/launch success and must never cause a second dispatch. */
65
+ claimedRequest(ref: string, binding: SessionSourceBinding): string | null {
66
+ if (!supported() || !refValid(ref) || !valid(binding)) return null;
67
+ const row = db.get<{ create_request_id: string | null }>(
68
+ `SELECT create_request_id FROM session_source_grants WHERE source_ref=?1 AND state='claimed'
69
+ AND ${fields.map((f, i) => `${f}=?${i + 2}`).join(" AND ")}`,
70
+ ref, ...fields.map(f => binding[f]));
71
+ return row?.create_request_id ?? null;
72
+ },
73
+ revoke(ref: string): boolean {
74
+ if (!supported() || !refValid(ref)) return false;
75
+ return db.run(`UPDATE session_source_grants SET state='revoked' WHERE source_ref=?1 AND state='issued'`, [ref]).changes === 1;
76
+ },
77
+ };
78
+ }