@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,250 @@
1
+ import { afterAll, beforeAll, beforeEach, expect, test } from "bun:test";
2
+ import { db } from "./db";
3
+ import { register, createNetworkTokenForNode } from "./auth";
4
+ import { createSessionSourceIssuer, SourceIssuerError, type SourceSelection } from "./session-source-issuer";
5
+ import { createSessionSourceGrantStore } from "./session-source-grant";
6
+ import { McpServer } from "@modelcontextprotocol/sdk/server/mcp.js";
7
+ import { registerTools } from "./tools";
8
+ import { createSessionSourceTransport } from "./session-source-transport";
9
+ import { buildConfigSnapshot } from "../../agent-node/src/runtime/config-apply";
10
+ import { SOURCE_FORK_CAPABILITY } from "../../contracts/session-source-transport";
11
+ import { SOURCE_DELIVERY_CAPABILITY } from "../../contracts/session-source-delivery";
12
+
13
+ const v2Snapshot = () => buildConfigSnapshot({ runtime: "opencode-cli", opencodeGeneration: "v2", opencodeMode: "copresence" }, false, 0);
14
+
15
+ const issuer = createSessionSourceIssuer();
16
+ let owner: ReturnType<typeof register>, member: ReturnType<typeof register>, bootstrap: ReturnType<typeof register>;
17
+ let sourceToken: ReturnType<typeof createNetworkTokenForNode>, daemonToken: ReturnType<typeof createNetworkTokenForNode>;
18
+ let selection: SourceSelection;
19
+ const request = (token?: string) => new Request("http://isolated.invalid/internal-only", {
20
+ headers: token ? { authorization: `Bearer ${token}` } : {},
21
+ });
22
+ const counts = () => ["session_source_grants", "node_create_requests"].map(table => db.get<{ n: number }>(`SELECT COUNT(*) AS n FROM ${table}`)!.n);
23
+ const inspect = () => issuer.inspect(request(owner.token), selection);
24
+ beforeAll(() => {
25
+ bootstrap = register("issuer_bootstrap", "Fixture-Strong-4150!");
26
+ owner = register("issuer_owner", "Fixture-Strong-4150!");
27
+ member = register("issuer_member", "Fixture-Strong-4150!");
28
+ expect(bootstrap.ok && owner.ok && member.ok).toBe(true);
29
+ const net = owner.network_id!, uid = owner.user!.user_id;
30
+ selection = { network_id: net, source_node_id: "n_source", daemon_node_id: "n_daemon", mode: "attach_existing" };
31
+ sourceToken = createNetworkTokenForNode(uid, net, "source", "n_source");
32
+ daemonToken = createNetworkTokenForNode(uid, net, "daemon", "n_daemon");
33
+ expect(sourceToken.ok && daemonToken.ok).toBe(true);
34
+ db.run(`INSERT INTO network_members (network_id,user_id,role,agent_access) VALUES (?1,?2,'member','granted')`, [net, member.user!.user_id]);
35
+ db.run(`INSERT INTO sessions (resume_id,alias,node_id,network_id,last_seen_at) VALUES
36
+ ('issuer_source','source','n_source',?1,datetime('now')),('issuer_daemon','daemon','n_daemon',?1,datetime('now'))`, [net]);
37
+ db.run(`INSERT INTO node_create_requests
38
+ (request_id,daemon_node_id,child_name,network_id,runtime,flags_json,env_keys,status,child_node_id,created_at,created_by_token,workdir)
39
+ VALUES ('cr_original','n_daemon','source',?1,'opencode-cli','{}','[]','succeeded','n_source',1000,?2,'/reported/path')`, [net, owner.token_id!]);
40
+ });
41
+ beforeEach(() => {
42
+ db.run("UPDATE users SET role='user' WHERE user_id=?1", [owner.user!.user_id]);
43
+ db.run("UPDATE network_members SET role='owner',agent_access='all' WHERE user_id=?1 AND network_id=?2", [owner.user!.user_id, owner.network_id!]);
44
+ db.run("UPDATE network_members SET role='member',agent_access='granted' WHERE user_id=?1 AND network_id=?2", [member.user!.user_id, owner.network_id!]);
45
+ db.run("DELETE FROM network_member_agent_grants WHERE user_id=?1", [member.user!.user_id]);
46
+ db.run("UPDATE api_tokens SET revoked_at=NULL,expires_at=NULL,last_used_at=datetime('now') WHERE user_id=?1", [owner.user!.user_id]);
47
+ db.run("UPDATE api_tokens SET bound_node_id='n_source' WHERE token_id=?1", [sourceToken.token_id!]);
48
+ db.run("UPDATE nodes SET network_id=?1 WHERE node_id IN ('n_source','n_daemon')", [owner.network_id!]);
49
+ db.run("UPDATE nodes SET runtime='opencode-cli',config_snapshot=?1 WHERE node_id='n_source'", [JSON.stringify(v2Snapshot())]);
50
+ db.run("UPDATE nodes SET config_snapshot=?1 WHERE node_id='n_daemon'", [JSON.stringify({ role: "host_supervisor", daemon_capabilities: { can_create_nodes: true } })]);
51
+ db.run("UPDATE sessions SET last_seen_at=datetime('now') WHERE resume_id IN ('issuer_source','issuer_daemon')");
52
+ db.run("UPDATE node_create_requests SET status='succeeded',daemon_node_id='n_daemon' WHERE request_id='cr_original'");
53
+ db.run("DELETE FROM node_daemon_bindings WHERE node_id='n_source'");
54
+ db.run("DELETE FROM session_project_creates WHERE request_id='issuer_project'");
55
+ });
56
+ afterAll(() => db.close());
57
+
58
+ test("actual CLI registration: explicit V2 copresence admits; SDK/V1/unknown/host and foreign scope refuse", async () => {
59
+ const server = new McpServer({ name: "source-guard-diagnosis", version: "0" }) as any;
60
+ let report: any;
61
+ const original = server.tool.bind(server);
62
+ server.tool = (name: string, desc: string, schema: any, handler: any) => {
63
+ if (name === "report_status") report = handler;
64
+ return original(name, desc, schema, handler);
65
+ };
66
+ registerTools(server, undefined, owner.network_id!, owner.user!.user_id, "source", true, sourceToken.token_id!);
67
+ // project-new mints a bound credential but does not precreate a nodes row.
68
+ db.run("DELETE FROM nodes WHERE node_id='n_source'");
69
+ const registerSnapshot = async (config_snapshot: any, agent = "agent-node:opencode") => report({
70
+ resume_id: "issuer_source", alias: "source", node_id: "n_source", network_id: owner.network_id!,
71
+ status: "idle", agent, session_id: "ses_DiagnosticOnly", config_snapshot });
72
+ const registration = await registerSnapshot(v2Snapshot());
73
+ expect(JSON.parse(registration.content[0].text).error).toBeUndefined();
74
+ const stored = db.get<{ runtime: string }>("SELECT runtime FROM nodes WHERE node_id='n_source'")!;
75
+ expect(stored.runtime).toBe("opencode-sdk");
76
+ expect(inspect()).toMatchObject({ permissions_verified: true });
77
+ const url = new URL("http://isolated.invalid/api/node-session-control/source");
78
+ const transport = createSessionSourceTransport({ enabled: true });
79
+ const post = async (suffix: string, token: string, body: any) => transport(new Request(url + suffix, { method: "POST",
80
+ headers: { authorization: `Bearer ${token}`, "content-type": "application/json" }, body: JSON.stringify(body) }), new URL(url + suffix));
81
+ db.run("UPDATE nodes SET config_snapshot=?1 WHERE node_id='n_daemon'", [JSON.stringify({ role: "host_supervisor", daemon_capabilities: {
82
+ source_fork_transport: SOURCE_FORK_CAPABILITY, source_node_delivery: SOURCE_DELIVERY_CAPABILITY } })]);
83
+ db.run("UPDATE sessions SET env_transport='loopback' WHERE node_id='n_daemon'");
84
+ expect((await post("/daemon", daemonToken.token!, { expected: { node_id: "n_daemon", network_id: owner.network_id! },
85
+ capability: SOURCE_FORK_CAPABILITY, instance_id: "11111111-1111-4111-8111-111111111111" }))!.status).toBe(200);
86
+ const input = { network_id: owner.network_id!, source_node_id: "n_source", session_id: "ses_DiagnosticOnly",
87
+ mode: "fork_independent", child_name: "diagnostic-fork", intent_id: "diagnostic-fork" };
88
+ const admitted = await post("", owner.token!, input);
89
+ expect(admitted!.status).toBe(200); expect(await admitted!.json()).toMatchObject({ status: "evidence_pending" });
90
+ for (const config of [{ runtime: "opencode-cli" }, { runtime: "opencode-cli", opencodeGeneration: "v1", opencodeMode: "copresence" },
91
+ { runtime: "opencode-cli", opencodeGeneration: "v2", opencodeMode: "headless" },
92
+ { runtime: "opencode-cli", opencodeGeneration: "v9", opencodeMode: "copresence" },
93
+ { runtime: "opencode-cli", opencodeGeneration: "v2", opencodeMode: "copresence", role: "host_supervisor" }]) {
94
+ await registerSnapshot(buildConfigSnapshot(config, false, 0));
95
+ expect(inspect()).toEqual({ ok: false, error: "source_runtime_unsupported" });
96
+ expect((await post("", owner.token!, input))!.status).toBe(403);
97
+ }
98
+ await registerSnapshot(v2Snapshot(), "agent-node:claude");
99
+ expect(inspect()).toEqual({ ok: false, error: "source_runtime_unsupported" });
100
+ await registerSnapshot(v2Snapshot());
101
+ expect((await post("", bootstrap.token!, input))!.status).toBe(403);
102
+ db.run("UPDATE node_create_requests SET daemon_node_id='other' WHERE request_id='cr_original'");
103
+ expect((await post("", owner.token!, input))!.status).not.toBe(200);
104
+ });
105
+
106
+ test("project-new historical registration is management only, pending/unknown and conflicting daemon refuse", () => {
107
+ db.run("UPDATE node_create_requests SET status='failed' WHERE request_id='cr_original'");
108
+ db.run(`INSERT INTO session_project_creates(request_id,user_id,requester_token_id,network_id,source_node_id,daemon_node_id,
109
+ daemon_token_id,daemon_instance_id,intent_id,selection_scope,snapshot_id,project_id,child_name,accepted_at,expires_at,state,child_node_id)
110
+ VALUES ('issuer_project',?1,?2,?3,'anchor','n_daemon',?4,'instance','issuer_project','scope','snap','project','source',1,2,'delivery_claimed','n_source')`,
111
+ [owner.user!.user_id, owner.token_id!, owner.network_id!, daemonToken.token_id!]);
112
+ expect(inspect()).toEqual({ ok: false, error: "source_daemon_unverified" });
113
+ db.run("UPDATE session_project_creates SET state='registration_confirmed' WHERE request_id='issuer_project'");
114
+ expect(inspect()).toMatchObject({ error: "source_evidence_unavailable", management: "created" });
115
+ db.run("UPDATE node_create_requests SET status='succeeded',daemon_node_id='other' WHERE request_id='cr_original'");
116
+ expect(inspect()).toEqual({ ok: false, error: "source_daemon_mismatch" });
117
+ db.run("UPDATE node_create_requests SET status='failed' WHERE request_id='cr_original'");
118
+ db.run("UPDATE session_project_creates SET state='unknown_rotation_required' WHERE request_id='issuer_project'");
119
+ expect(inspect()).toEqual({ ok: false, error: "source_daemon_unverified" });
120
+ });
121
+
122
+ test("real persisted bearer auth: missing, fabricated, network, expired, revoked and idle tokens refuse", () => {
123
+ const before = counts();
124
+ for (const token of [undefined, "tok_owner_id_is_not_auth", owner.network_token, sourceToken.token]) {
125
+ expect(issuer.issue(request(token), selection)).toEqual({ ok: false, error: "source_auth_required" });
126
+ }
127
+ for (const assignment of ["revoked_at=datetime('now')", "expires_at=datetime('now','-1 minute')",
128
+ "last_used_at=datetime('now','-400 days'),created_at=datetime('now','-400 days')"]) {
129
+ db.run(`UPDATE api_tokens SET ${assignment} WHERE token_id=?1`, [owner.token_id!]);
130
+ expect(inspect()).toEqual({ ok: false, error: "source_auth_required" });
131
+ db.run("UPDATE api_tokens SET revoked_at=NULL,expires_at=NULL,last_used_at=datetime('now') WHERE token_id=?1", [owner.token_id!]);
132
+ }
133
+ expect(counts()).toEqual(before);
134
+ });
135
+
136
+ test("current network membership and source visibility are checked before creation permission", () => {
137
+ expect(issuer.issue(request(bootstrap.token), selection)).toEqual({ ok: false, error: "source_network_forbidden" });
138
+ expect(issuer.issue(request(owner.token), { ...selection, network_id: member.network_id! }))
139
+ .toEqual({ ok: false, error: "source_network_forbidden" });
140
+ expect(issuer.issue(request(member.token), selection)).toEqual({ ok: false, error: "source_read_forbidden" });
141
+ db.run("INSERT INTO network_member_agent_grants (network_id,user_id,node_id,can_message) VALUES (?1,?2,'n_source',0)", [owner.network_id!, member.user!.user_id]);
142
+ expect(issuer.issue(request(member.token), selection)).toEqual({ ok: false, error: "insufficient_role_for_create_node" });
143
+ db.run("UPDATE nodes SET network_id=?1 WHERE node_id='n_source'", [member.network_id!]);
144
+ expect(inspect()).toEqual({ ok: false, error: "source_read_forbidden" });
145
+ });
146
+
147
+ test("create_node role rules recheck demotion and do not infer create permission from source ownership", () => {
148
+ for (const role of ["member", "viewer"]) {
149
+ db.run("UPDATE network_members SET role=?1 WHERE user_id=?2 AND network_id=?3", [role, owner.user!.user_id, owner.network_id!]);
150
+ expect(inspect()).toEqual({ ok: false, error: "insufficient_role_for_create_node" });
151
+ }
152
+ db.run("UPDATE network_members SET role='admin' WHERE user_id=?1 AND network_id=?2", [owner.user!.user_id, owner.network_id!]);
153
+ expect(inspect().error).toBe("source_evidence_unavailable");
154
+ db.run("DELETE FROM network_members WHERE user_id=?1 AND network_id=?2", [owner.user!.user_id, owner.network_id!]);
155
+ expect(inspect()).toEqual({ ok: false, error: "source_network_forbidden" });
156
+ db.run("INSERT INTO network_members (network_id,user_id,role) VALUES (?1,?2,'owner')", [owner.network_id!, owner.user!.user_id]);
157
+ });
158
+
159
+ test("target daemon network/capability and actual managed-source relation are mandatory", () => {
160
+ db.run("UPDATE nodes SET network_id=?1 WHERE node_id='n_daemon'", [member.network_id!]);
161
+ expect(inspect()).toEqual({ ok: false, error: "daemon_not_found" });
162
+ db.run("UPDATE nodes SET network_id=?1,config_snapshot=?2 WHERE node_id='n_daemon'", [owner.network_id!, JSON.stringify({ role: "host_supervisor", daemon_capabilities: { can_create_nodes: false } })]);
163
+ expect(inspect()).toEqual({ ok: false, error: "daemon_cannot_create_nodes" });
164
+ db.run("UPDATE nodes SET config_snapshot=?1 WHERE node_id='n_daemon'", [JSON.stringify({ role: "host_supervisor" })]);
165
+ db.run("UPDATE node_create_requests SET daemon_node_id='other_daemon' WHERE request_id='cr_original'");
166
+ expect(inspect()).toEqual({ ok: false, error: "source_daemon_mismatch" });
167
+ db.run("UPDATE node_create_requests SET status='pending' WHERE request_id='cr_original'");
168
+ expect(inspect()).toEqual({ ok: false, error: "source_daemon_unverified" });
169
+ });
170
+
171
+ test("malformed/ordinary daemon snapshots and non-OpenCode sources are not source authority", () => {
172
+ for (const raw of ["not-json", "[]", "{}", JSON.stringify({ role: "ordinary" }),
173
+ JSON.stringify({ role: "host_supervisor", daemon_capabilities: { runtimes_supported: ["codex-sdk"] } })]) {
174
+ db.run("UPDATE nodes SET config_snapshot=?1 WHERE node_id='n_daemon'", [raw]);
175
+ expect(inspect()).toEqual({ ok: false, error: "daemon_cannot_create_nodes" });
176
+ }
177
+ db.run("UPDATE nodes SET config_snapshot=?1 WHERE node_id='n_daemon'", [JSON.stringify({ role: "host_supervisor" })]);
178
+ db.run("UPDATE nodes SET runtime='codex-app-server' WHERE node_id='n_source'");
179
+ expect(inspect()).toEqual({ ok: false, error: "source_runtime_unsupported" });
180
+ });
181
+
182
+ test("acknowledged adoption is a management relation, not canonical-directory or Server authority", () => {
183
+ db.run("UPDATE node_create_requests SET status='failed' WHERE request_id='cr_original'");
184
+ db.run(`INSERT INTO node_daemon_bindings
185
+ (request_id,node_id,network_id,daemon_node_id,workdir,requested_by,status,created_at,updated_at)
186
+ VALUES ('adopt_source','n_source',?1,'n_daemon','http://untrusted.invalid/path',?2,'active',1000,1000)`, [owner.network_id!, owner.user!.user_id]);
187
+ expect(inspect()).toEqual({ ok: false, error: "source_evidence_unavailable", permissions_verified: true,
188
+ management: "adopted", missing: ["server_session_generation", "canonical_directory_ownership"] });
189
+ db.run("UPDATE node_daemon_bindings SET daemon_node_id='other_daemon' WHERE request_id='adopt_source'");
190
+ db.run("UPDATE node_create_requests SET status='succeeded' WHERE request_id='cr_original'");
191
+ expect(inspect()).toEqual({ ok: false, error: "source_daemon_mismatch" });
192
+ });
193
+
194
+ test("freshness uses Hub receipt times and currently valid immutable node credentials", () => {
195
+ for (const offset of ["-5 minutes", "+2 minutes"]) {
196
+ db.run("UPDATE sessions SET last_seen_at=datetime('now',?1) WHERE resume_id='issuer_source'", [offset]);
197
+ expect(inspect()).toEqual({ ok: false, error: "source_evidence_stale" });
198
+ }
199
+ // Within one 3-minute status heartbeat: alive (75 s used to call this stale).
200
+ db.run("UPDATE sessions SET last_seen_at=datetime('now','-2 minutes') WHERE resume_id='issuer_source'");
201
+ expect((inspect() as any).error).not.toBe("source_evidence_stale");
202
+ db.run("UPDATE sessions SET last_seen_at=datetime('now') WHERE resume_id='issuer_source'");
203
+ for (const tokenId of [sourceToken.token_id!, daemonToken.token_id!]) {
204
+ db.run("UPDATE api_tokens SET revoked_at=datetime('now') WHERE token_id=?1", [tokenId]);
205
+ expect(inspect()).toEqual({ ok: false, error: "source_evidence_stale" });
206
+ db.run("UPDATE api_tokens SET revoked_at=NULL WHERE token_id=?1", [tokenId]);
207
+ }
208
+ db.run("UPDATE api_tokens SET expires_at=datetime('now','-1 minute') WHERE token_id=?1", [sourceToken.token_id!]);
209
+ expect(inspect()).toEqual({ ok: false, error: "source_evidence_stale" });
210
+ db.run("UPDATE api_tokens SET expires_at=NULL,bound_node_id=NULL WHERE token_id=?1", [sourceToken.token_id!]);
211
+ expect(inspect()).toEqual({ ok: false, error: "source_evidence_stale" });
212
+ });
213
+
214
+ test("reported binding, directory and URL never become verified proof; issue adds no grant", () => {
215
+ const before = counts();
216
+ db.run("UPDATE nodes SET config_snapshot=?1 WHERE node_id='n_source'", [JSON.stringify({
217
+ ...v2Snapshot(),
218
+ session_id: "ses_Forged", binding_id: "claimed_binding", server_generation: "claimed_generation",
219
+ canonical_directory: "/reported/canonical", server_url: "http://untrusted.invalid" })]);
220
+ for (const mode of ["attach_existing", "fork_independent"] as const) {
221
+ expect(issuer.issue(request(owner.token), { ...selection, mode })).toEqual({ ok: false, error: "source_evidence_unavailable",
222
+ permissions_verified: true, management: "created", missing: ["server_session_generation", "canonical_directory_ownership"] });
223
+ }
224
+ for (const extra of [{ binding: {} }, { canonical_directory: "/client/path" }, { server_url: "http://untrusted.invalid" }, { user_id: owner.user!.user_id }]) {
225
+ expect(issuer.issue(request(owner.token), { ...selection, ...extra })).toEqual({ ok: false, error: "source_selection_invalid" });
226
+ }
227
+ expect(counts()).toEqual(before);
228
+ });
229
+
230
+ test("real revalidation composes with existing admission/store but never consumes an unproven grant", () => {
231
+ // Test-only pre-existing store row, NOT claimed as an issuer-produced proof.
232
+ const store = createSessionSourceGrantStore(db), now = Date.now();
233
+ const ref = store.issue({ ...selection, user_id: owner.user!.user_id, session_id: "ses_Fixture",
234
+ binding_id: "test_only", server_generation: "test_only", canonical_directory: "/test-only" }, now, now + 60_000);
235
+ const before = counts(), callback = issuer.revalidation(request(owner.token), selection);
236
+ expect(() => callback()).toThrow(SourceIssuerError);
237
+ expect(() => issuer.reserve(request(owner.token), selection, ref, "never-launched")).toThrow("source_evidence_unavailable");
238
+ expect(() => issuer.recover(request(owner.token), selection, ref)).toThrow("source_evidence_unavailable");
239
+ db.run("UPDATE network_members SET role='viewer' WHERE user_id=?1 AND network_id=?2", [owner.user!.user_id, owner.network_id!]);
240
+ expect(() => callback()).toThrow("insufficient_role_for_create_node");
241
+ db.run("UPDATE network_members SET role='owner' WHERE user_id=?1 AND network_id=?2", [owner.user!.user_id, owner.network_id!]);
242
+ db.run("UPDATE nodes SET network_id=?1 WHERE node_id='n_source'", [member.network_id!]);
243
+ expect(() => callback()).toThrow("source_read_forbidden");
244
+ db.run("UPDATE nodes SET network_id=?1 WHERE node_id='n_source'", [owner.network_id!]);
245
+ db.run("UPDATE api_tokens SET revoked_at=datetime('now') WHERE token_id=?1", [owner.token_id!]);
246
+ expect(() => callback()).toThrow("source_auth_required");
247
+ expect(counts()).toEqual(before);
248
+ expect(db.get("SELECT state,create_request_id FROM session_source_grants WHERE source_ref=?1", ref))
249
+ .toEqual({ state: "issued", create_request_id: null });
250
+ });
@@ -0,0 +1,164 @@
1
+ import { db } from "./db";
2
+ import { resolveToken, getUserNetworkRole } from "./auth";
3
+ import { canSeeAgent } from "./agent-access";
4
+ import { canRestWriteNetwork, getUserNetworkIds } from "./network-scope";
5
+ import { resolveNodeCaller } from "./create-node";
6
+ import { parseDbTimestampMs } from "./db-timestamp";
7
+ import { createSessionSourceCreateAdapter, type VerifiedSourceCreateContext } from "./session-source-create";
8
+ import type { SessionSourceBinding } from "./session-source-grant";
9
+ import { readSessionControlCredential, isHumanCredential } from "./node-session-control";
10
+ import { isOpenCodeV2CopresenceRuntime, readOpencodeSnapshotFlags } from "./config-apply-validate";
11
+
12
+ /** Routing assertions only. No binding, session, directory, URL or user proof. */
13
+ export type SourceSelection = {
14
+ network_id: string; source_node_id: string; daemon_node_id: string;
15
+ mode: SessionSourceBinding["mode"];
16
+ };
17
+ export type SourceIssuerCode = "source_selection_invalid" | "source_auth_required" | "source_network_forbidden"
18
+ | "source_read_forbidden" | "insufficient_role_for_create_node" | "daemon_not_found"
19
+ | "daemon_cannot_create_nodes" | "source_runtime_unsupported" | "source_daemon_unverified"
20
+ | "source_daemon_mismatch" | "source_evidence_stale" | "source_evidence_unavailable";
21
+ /** Liveness window for source and daemon Hub receipt times. Nodes and daemons report
22
+ * status every 3 min (STATUS_HEARTBEAT_MS / node-server heartbeat), so the former
23
+ * 75 s window made a healthy pair look stale for ~60% of each cycle and the app's
24
+ * fork returned 403 almost always. One heartbeat + jitter. Still liveness only,
25
+ * not a generation lease (the daemon's live evidence read is the proof). */
26
+ export const SOURCE_LIVENESS_MS = 4 * 60_000;
27
+ export type SourceIssuerRefusal = { ok: false; error: SourceIssuerCode };
28
+ export class SourceIssuerError extends Error {
29
+ constructor(public readonly code: SourceIssuerCode) { super(code); this.name = "SourceIssuerError"; }
30
+ }
31
+ type NodeRow = { node_id: string; alias: string; network_id: string; runtime: string | null; config_snapshot: string | null };
32
+ type Permissions = { selection: SourceSelection };
33
+ const fail = (error: SourceIssuerCode): SourceIssuerRefusal => ({ ok: false, error });
34
+ const object = (v: unknown): v is Record<string, any> => !!v && typeof v === "object" && !Array.isArray(v);
35
+ const snapshot = (n: NodeRow): Record<string, any> => {
36
+ try { const v = JSON.parse(n.config_snapshot || "{}"); return object(v) ? v : {}; } catch { return {}; }
37
+ };
38
+ function selectionValid(s: SourceSelection): boolean {
39
+ return object(s) && Object.keys(s).every(k => ["network_id", "source_node_id", "daemon_node_id", "mode"].includes(k))
40
+ && [s.network_id, s.source_node_id, s.daemon_node_id].every(v => typeof v === "string" && /^[A-Za-z0-9_-]{1,200}$/.test(v))
41
+ && (s.mode === "attach_existing" || s.mode === "fork_independent");
42
+ }
43
+
44
+ function permissions(req: Request, selection: SourceSelection): Permissions | SourceIssuerRefusal {
45
+ if (!selectionValid(selection)) return fail("source_selection_invalid");
46
+ // Same persisted-token authentication as session-control, without master/dev
47
+ // fallbacks. Re-resolve on every call; no caller-supplied user/token-id proof.
48
+ const raw = req.headers.get("authorization")?.match(/^Bearer (\S+)$/)?.[1] ?? "";
49
+ if (!raw) return fail("source_auth_required");
50
+ const auth = resolveToken(raw);
51
+ if (!auth?.tokenId) return fail("source_auth_required");
52
+ return storedPermissions(auth.tokenId, auth.user.user_id, selection);
53
+ }
54
+ function storedPermissions(tokenId: string, userId: string, selection: SourceSelection): Permissions | SourceIssuerRefusal {
55
+ if (!selectionValid(selection)) return fail("source_selection_invalid");
56
+ const token = readSessionControlCredential(tokenId);
57
+ if (!isHumanCredential(token) || token.user_id !== userId) return fail("source_auth_required");
58
+ const net = selection.network_id;
59
+ if (!getUserNetworkIds(userId).includes(net)) return fail("source_network_forbidden");
60
+ const source = db.get<NodeRow>("SELECT node_id,alias,network_id,runtime,config_snapshot FROM nodes WHERE node_id=?1 AND network_id=?2",
61
+ selection.source_node_id, net);
62
+ if (!source || !canSeeAgent(userId, net, { nodeId: source.node_id, alias: source.alias })) return fail("source_read_forbidden");
63
+ // create_node's shared write gate + exact network admin/owner rule. A Hub
64
+ // admin outside the network does not receive a new bypass here.
65
+ const role = getUserNetworkRole(userId, net);
66
+ if (!canRestWriteNetwork({ userId, networkId: token.network_id }, net, false)
67
+ || (role !== "owner" && role !== "admin")) return fail("insufficient_role_for_create_node");
68
+ const daemon = db.get<NodeRow>("SELECT node_id,alias,network_id,runtime,config_snapshot FROM nodes WHERE node_id=?1 AND network_id=?2",
69
+ selection.daemon_node_id, net);
70
+ if (!daemon) return fail("daemon_not_found");
71
+ const snap = snapshot(daemon);
72
+ // A reported host role is necessary, not proof of Server or local ownership.
73
+ const runtimes = snap.daemon_capabilities?.runtimes_supported;
74
+ if (snap.role !== "host_supervisor" || snap.daemon_capabilities?.can_create_nodes === false
75
+ || (Array.isArray(runtimes) && !runtimes.includes("opencode-cli"))) return fail("daemon_cannot_create_nodes");
76
+ const flags = readOpencodeSnapshotFlags(source.config_snapshot);
77
+ if (!isOpenCodeV2CopresenceRuntime(source.runtime, flags.opencodeGeneration, flags.opencodeMode)
78
+ || snapshot(source).role === "host_supervisor") return fail("source_runtime_unsupported");
79
+ return { selection };
80
+ }
81
+
82
+ export type SourceEvidenceRead = {
83
+ ok: false; error: "source_evidence_unavailable";
84
+ permissions_verified: true;
85
+ management: "created" | "adopted";
86
+ missing: readonly ["server_session_generation", "canonical_directory_ownership"];
87
+ };
88
+ function readEvidence(p: Permissions): SourceEvidenceRead | SourceIssuerRefusal {
89
+ const { selection: s } = p;
90
+ // Read actual server journal relations, not hostname, node-id prefix, profile
91
+ // paths or client claims. Fail closed on ambiguous/conflicting management.
92
+ const created = db.all<{ daemon_node_id: string }>(`SELECT DISTINCT daemon_node_id FROM node_create_requests
93
+ WHERE child_node_id=?1 AND network_id=?2 AND status='succeeded' AND source_ref IS NULL
94
+ UNION SELECT daemon_node_id FROM session_project_creates
95
+ WHERE child_node_id=?1 AND network_id=?2 AND state='registration_confirmed'`, s.source_node_id, s.network_id);
96
+ const adopted = db.all<{ daemon_node_id: string }>(`SELECT daemon_node_id FROM node_daemon_bindings
97
+ WHERE node_id=?1 AND network_id=?2 AND status='active'`, s.source_node_id, s.network_id);
98
+ const owners = new Set([...created, ...adopted].map(r => r.daemon_node_id));
99
+ if (!owners.size) return fail("source_daemon_unverified");
100
+ if (owners.size !== 1 || !owners.has(s.daemon_node_id)) return fail("source_daemon_mismatch");
101
+ // Hub receipt time is a liveness prerequisite only, NOT a generation lease.
102
+ // Immutable token binding is deliberately stricter than legacy alias fallback.
103
+ for (const nodeId of [s.source_node_id, s.daemon_node_id]) {
104
+ const seen = db.get<{ last_seen_at: string | null }>(`SELECT last_seen_at FROM sessions
105
+ WHERE node_id=?1 AND network_id=?2 ORDER BY last_seen_at DESC LIMIT 1`, nodeId, s.network_id);
106
+ const time = parseDbTimestampMs(seen?.last_seen_at ?? "");
107
+ const age = Date.now() - time;
108
+ if (!Number.isFinite(time) || age < 0 || age > SOURCE_LIVENESS_MS) return fail("source_evidence_stale");
109
+ const tokens = db.all<{ token_id: string; user_id: string }>(`SELECT t.token_id,t.user_id FROM api_tokens t JOIN users u ON u.user_id=t.user_id
110
+ JOIN network_members m ON m.user_id=t.user_id AND m.network_id=t.network_id
111
+ WHERE t.bound_node_id=?1 AND t.network_id=?2 AND t.scope='network' AND t.revoked_at IS NULL
112
+ AND (t.expires_at IS NULL OR t.expires_at>datetime('now'))`, nodeId, s.network_id);
113
+ if (!tokens.some(t => {
114
+ const caller = resolveNodeCaller(t.token_id);
115
+ return caller.ok && caller.kind === "node" && caller.nodeId === nodeId && caller.networkId === s.network_id
116
+ && canRestWriteNetwork({ userId: t.user_id, networkId: s.network_id }, s.network_id, false);
117
+ })) return fail("source_evidence_stale");
118
+ }
119
+ // node-session-control's node-reported process-local session/binding lease
120
+ // has neither Server-generation authorization nor canonical directory proof.
121
+ // Adoption workdir and config_snapshot/project_dir are not substitutes.
122
+ return { ok: false, error: "source_evidence_unavailable", permissions_verified: true,
123
+ management: created.length ? "created" : "adopted",
124
+ missing: ["server_session_generation", "canonical_directory_ownership"] };
125
+ }
126
+
127
+ /** Real authentication/permission/evidence reader. No public endpoint, injectable
128
+ * proof provider or successful fake-binding branch. Currently cannot issue a
129
+ * grant: the daemon's independent Server/session/directory proof is absent. */
130
+ export function createSessionSourceIssuer() {
131
+ const adapter = createSessionSourceCreateAdapter(db);
132
+ const inspect = (req: Request, selection: SourceSelection): SourceIssuerRefusal | SourceEvidenceRead => {
133
+ const p = permissions(req, selection);
134
+ return "ok" in p ? p : readEvidence(p);
135
+ };
136
+ const revalidation = (req: Request, selection: SourceSelection): (() => VerifiedSourceCreateContext) => () => {
137
+ const refusal = inspect(req, selection);
138
+ throw new SourceIssuerError(refusal.error);
139
+ };
140
+ return {
141
+ inspect,
142
+ // Directory grants are explicit daemon-local authorities, not evidence that
143
+ // this source owns any Server. Reuse only human/network/create/read gates.
144
+ directoryPermissions(tokenId: string, userId: string, selection: SourceSelection): boolean {
145
+ return !("ok" in storedPermissions(tokenId, userId, selection));
146
+ },
147
+ /** Only for a requester authenticated and frozen by an internal queue.
148
+ * A token ID itself is NOT authentication; never expose this as an endpoint. */
149
+ inspectStoredRequester(tokenId: string, userId: string, selection: SourceSelection) {
150
+ const p = storedPermissions(tokenId, userId, selection);
151
+ return "ok" in p ? p : readEvidence(p);
152
+ },
153
+ // No store.issue call until a real evidence reader can return an authorized
154
+ // binding. This method returns a typed refusal rather than a bogus grant.
155
+ issue: inspect,
156
+ revalidation,
157
+ reserve(req: Request, selection: SourceSelection, sourceRef: string, name: string) {
158
+ return adapter.reserve(sourceRef, name, revalidation(req, selection));
159
+ },
160
+ recover(req: Request, selection: SourceSelection, sourceRef: string) {
161
+ return adapter.recover(sourceRef, revalidation(req, selection));
162
+ },
163
+ };
164
+ }