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

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 (446) hide show
  1. package/README.md +120 -3
  2. package/bin/commhub.ts +93 -9
  3. package/build-info.json +7 -0
  4. package/package.json +10 -8
  5. package/src/ack-create-request-transport.test.ts +182 -0
  6. package/src/ack-create-request.test.ts +52 -8
  7. package/src/admin-delete-network-http.test.ts +229 -0
  8. package/src/admin-networks-http.test.ts +88 -0
  9. package/src/adoption-candidates-http.test.ts +140 -0
  10. package/src/adoption-candidates.ts +158 -0
  11. package/src/agent-access-batch.test.ts +210 -0
  12. package/src/agent-access.ts +585 -0
  13. package/src/agent-acl-groups-http.test.ts +247 -0
  14. package/src/agent-acl-http.test.ts +691 -0
  15. package/src/agent-acl-slice3-http.test.ts +885 -0
  16. package/src/agent-department-grants.test.ts +129 -0
  17. package/src/agent-department-http.test.ts +215 -0
  18. package/src/agent-groups-perf.test.ts +223 -0
  19. package/src/agent-notice.ts +48 -0
  20. package/src/agent-team-whoami-http.test.ts +98 -0
  21. package/src/agent-teams-http.test.ts +330 -0
  22. package/src/agent-teams.ts +244 -0
  23. package/src/alias-baseline-2571.test.ts +162 -0
  24. package/src/alias-baseline.ts +113 -0
  25. package/src/alias-filter.test.ts +72 -0
  26. package/src/alias-filter.ts +42 -0
  27. package/src/api-host-supervisors-can-create-nodes.test.ts +350 -0
  28. package/src/api-host-supervisors-fallback.test.ts +6 -7
  29. package/src/api-host-supervisors-runtime-readiness.test.ts +195 -0
  30. package/src/api-nodes-shape.test.ts +131 -4
  31. package/src/auth-abuse-counters.test.ts +144 -0
  32. package/src/auth-abuse-counters.ts +122 -0
  33. package/src/auth-layer-shape.test.ts +105 -0
  34. package/src/auth-password-change-cli-tokens-http.test.ts +423 -0
  35. package/src/auth-sessions-http.test.ts +260 -0
  36. package/src/auth-validate.test.ts +5 -1
  37. package/src/auth-weak-password-login.test.ts +176 -0
  38. package/src/auth.ts +641 -68
  39. package/src/backfill-node-ids-2664.test.ts +128 -0
  40. package/src/binding-generation-http.test.ts +141 -0
  41. package/src/blocked-exit-on-reply.test.ts +122 -0
  42. package/src/broadcast-fanout-2721.test.ts +149 -0
  43. package/src/broadcast-fanout.ts +117 -0
  44. package/src/build-commit-report-http.test.ts +128 -0
  45. package/src/build-info.test.ts +60 -0
  46. package/src/build-info.ts +85 -0
  47. package/src/chain-attempt-dedup.test.ts +447 -0
  48. package/src/clip.test.ts +36 -0
  49. package/src/clip.ts +48 -0
  50. package/src/clone-node.test.ts +269 -0
  51. package/src/clone-node.ts +289 -0
  52. package/src/codex-config-flags.ts +77 -0
  53. package/src/codex-fork-contract.ts +23 -0
  54. package/src/codex-fork-migration.test.ts +38 -0
  55. package/src/commhub-bin-args.test.ts +85 -0
  56. package/src/config-apply-validate.test.ts +188 -1
  57. package/src/config-apply-validate.ts +222 -3
  58. package/src/cors-origins.test.ts +73 -0
  59. package/src/create-node-blocked-gate.test.ts +365 -0
  60. package/src/create-node-error-domain.test.ts +127 -0
  61. package/src/create-node-network-id.test.ts +91 -0
  62. package/src/create-node-tool-schema.test.ts +49 -0
  63. package/src/create-node-unicode-name.test.ts +126 -0
  64. package/src/create-node-validate.test.ts +199 -7
  65. package/src/create-node-validate.ts +232 -15
  66. package/src/create-node-workdir.test.ts +298 -0
  67. package/src/create-node.ts +88 -23
  68. package/src/daemon-provider-snapshots.test.ts +453 -0
  69. package/src/daemon-provider-snapshots.ts +327 -0
  70. package/src/daemon-token-owner-http.test.ts +346 -0
  71. package/src/dashboard-slash-routing-http.test.ts +109 -0
  72. package/src/db-adapter-guard.test.ts +148 -0
  73. package/src/db-adapter-translate.test.ts +128 -0
  74. package/src/db-adapter.ts +377 -91
  75. package/src/db-timestamp.test.ts +38 -0
  76. package/src/db-timestamp.ts +15 -0
  77. package/src/db.ts +1298 -153
  78. package/src/delivered-without-push.test.ts +140 -0
  79. package/src/department-groups-http.test.ts +209 -0
  80. package/src/department-groups-sync-http.test.ts +328 -0
  81. package/src/department-groups.ts +434 -0
  82. package/src/department-heads-http.test.ts +350 -0
  83. package/src/department-heads.ts +226 -0
  84. package/src/departments-agent-count.test.ts +139 -0
  85. package/src/departments-http.test.ts +185 -0
  86. package/src/departments-mcp-error-domain.test.ts +135 -0
  87. package/src/departments-mcp.test.ts +128 -0
  88. package/src/departments.ts +318 -0
  89. package/src/desktop-message-seam.test.ts +150 -0
  90. package/src/desktop-message.test.ts +368 -0
  91. package/src/dm-file-scope-http.test.ts +227 -0
  92. package/src/empty-node-sweeper.test.ts +104 -0
  93. package/src/empty-node-sweeper.ts +88 -0
  94. package/src/env-transport-gate-http.test.ts +240 -0
  95. package/src/env-transport-gate.ts +80 -0
  96. package/src/env-transport-policy.ts +56 -0
  97. package/src/etag-of.test.ts +57 -0
  98. package/src/event-loop-lag.test.ts +180 -0
  99. package/src/event-loop-lag.ts +201 -0
  100. package/src/expiry-counters.test.ts +187 -0
  101. package/src/expiry-counters.ts +227 -0
  102. package/src/expiry-evidence-db.test.ts +103 -0
  103. package/src/ext-token-shared.test.ts +60 -0
  104. package/src/ext-validation-regression.test.ts +10 -17
  105. package/src/external-schedule-edits-http.test.ts +321 -0
  106. package/src/external-schedule-edits-timestamps.test.ts +64 -0
  107. package/src/external-schedule-edits.ts +327 -0
  108. package/src/file-download-authz-dev-open.test.ts +1 -1
  109. package/src/file-download-authz.test.ts +25 -4
  110. package/src/file-download-date-bucket.test.ts +1 -1
  111. package/src/file-network-scope-dev-open.test.ts +1 -1
  112. package/src/file-network-scope.test.ts +7 -6
  113. package/src/group-membership-events-http.test.ts +264 -0
  114. package/src/group-messages-http.test.ts +483 -0
  115. package/src/group-messages.ts +297 -0
  116. package/src/health-anon-readers.ts +67 -0
  117. package/src/health-host-disk-2756.test.ts +71 -0
  118. package/src/health-identity-root.test.ts +98 -0
  119. package/src/health-redaction.test.ts +1599 -7
  120. package/src/health-status-reasons.test.ts +84 -0
  121. package/src/host-supervisor-identity-http.test.ts +152 -0
  122. package/src/host-supervisor-identity.ts +92 -0
  123. package/src/host-supervisors-daemon-version.test.ts +137 -0
  124. package/src/http-gzip.test.ts +94 -0
  125. package/src/http-gzip.ts +112 -0
  126. package/src/hub-catalog-read-http.test.ts +664 -0
  127. package/src/hub-provider-config.test.ts +166 -0
  128. package/src/hub-provider-config.ts +202 -0
  129. package/src/hub-timestamp.test.ts +38 -0
  130. package/src/hub-timestamp.ts +27 -0
  131. package/src/human-dm.ts +215 -0
  132. package/src/human-inbox.ts +42 -0
  133. package/src/inbox-caller.ts +49 -0
  134. package/src/inbox-count-sse.test.ts +318 -0
  135. package/src/inbox-count.ts +29 -0
  136. package/src/index.ts +6 -2
  137. package/src/license-state.test.ts +105 -0
  138. package/src/license-state.ts +48 -0
  139. package/src/lifecycle-error-domain.test.ts +149 -0
  140. package/src/list-ack-error-domain.test.ts +108 -0
  141. package/src/list-host-supervisors.test.ts +15 -4
  142. package/src/list-tasks-omit-default.test.ts +84 -0
  143. package/src/list-tasks-since-last.test.ts +100 -0
  144. package/src/list-tasks-since.test.ts +104 -0
  145. package/src/mcp-context-cost-http.test.ts +127 -0
  146. package/src/mcp-inflight.test.ts +92 -0
  147. package/src/mcp-inflight.ts +38 -0
  148. package/src/mcp-projects-events-http.test.ts +168 -0
  149. package/src/mcp-route-label-http.test.ts +120 -0
  150. package/src/mcp-write-network-resolution.test.ts +21 -0
  151. package/src/member-audit-network-id-http.test.ts +93 -0
  152. package/src/member-presence-http.test.ts +210 -0
  153. package/src/messages-ack-by-agent-http.test.ts +142 -0
  154. package/src/migrate-sqlite-to-pg.test.ts +47 -0
  155. package/src/migrate-sqlite-to-pg.ts +263 -0
  156. package/src/model-auth-notify-http.test.ts +181 -0
  157. package/src/model-auth-notify.ts +116 -0
  158. package/src/network-name-http.test.ts +75 -0
  159. package/src/network-quota-config.test.ts +100 -0
  160. package/src/network-rules-http.test.ts +169 -0
  161. package/src/network-rules.ts +129 -0
  162. package/src/network-scope.ts +222 -3
  163. package/src/network-token-membership-http.test.ts +186 -0
  164. package/src/node-alias-control.ts +12 -0
  165. package/src/node-attrs.test.ts +47 -2
  166. package/src/node-caller-identity-http.test.ts +1108 -0
  167. package/src/node-config-last-update.test.ts +126 -0
  168. package/src/node-config-last-update.ts +107 -0
  169. package/src/node-create-request-status-http.test.ts +105 -0
  170. package/src/node-daemon-bindings.test.ts +142 -0
  171. package/src/node-daemon-bindings.ts +135 -0
  172. package/src/node-failure-alert.test.ts +150 -0
  173. package/src/node-failure-alert.ts +177 -0
  174. package/src/node-files-transport.test.ts +350 -0
  175. package/src/node-health-codex-login.test.ts +120 -0
  176. package/src/node-health-dispatch-http.test.ts +373 -0
  177. package/src/node-health-guard-origin.test.ts +98 -0
  178. package/src/node-health-guard.ts +121 -0
  179. package/src/node-health-passthrough.test.ts +115 -0
  180. package/src/node-health-store.ts +101 -0
  181. package/src/node-id-alias.test.ts +190 -0
  182. package/src/node-identity-conflict-http.test.ts +269 -0
  183. package/src/node-identity-conflict.ts +142 -0
  184. package/src/node-identity-mismatch.test.ts +74 -0
  185. package/src/node-in-flight-tasks.ts +31 -0
  186. package/src/node-lifecycle-controllable.test.ts +64 -0
  187. package/src/node-lifecycle-controllable.ts +53 -0
  188. package/src/node-lifecycle-read-http.test.ts +257 -0
  189. package/src/node-lifecycle-read.ts +124 -0
  190. package/src/node-logs-transport.test.ts +266 -0
  191. package/src/node-peer-allowlist.test.ts +114 -0
  192. package/src/node-permissions-http.test.ts +901 -0
  193. package/src/node-permissions.ts +496 -0
  194. package/src/node-request-retention.test.ts +281 -0
  195. package/src/node-request-retention.ts +120 -0
  196. package/src/node-secret-rest-http.test.ts +190 -0
  197. package/src/node-secret-vault-inject.test.ts +132 -0
  198. package/src/node-security-write-gate.test.ts +72 -0
  199. package/src/node-serviceability.test.ts +86 -0
  200. package/src/node-serviceability.ts +124 -0
  201. package/src/node-session-control-http.test.ts +310 -0
  202. package/src/node-session-control.ts +258 -0
  203. package/src/node-skills-transport.test.ts +212 -0
  204. package/src/node-token-identity.ts +35 -0
  205. package/src/node-token-ownership.ts +51 -0
  206. package/src/node-token-privilege-http.test.ts +224 -0
  207. package/src/node-token-usage.test.ts +90 -0
  208. package/src/node-token-usage.ts +164 -0
  209. package/src/not-found-api-http.test.ts +67 -0
  210. package/src/observer-avatar-http.test.ts +103 -10
  211. package/src/observer-push.test.ts +76 -0
  212. package/src/opencode-catalog-report-http.test.ts +139 -0
  213. package/src/opencode-v2-catalog.test.ts +268 -0
  214. package/src/opencode-v2-catalog.ts +356 -0
  215. package/src/package-version-consistency.test.ts +25 -0
  216. package/src/parent-infer.test.ts +82 -0
  217. package/src/parent-infer.ts +110 -0
  218. package/src/parent-source-marker.test.ts +70 -0
  219. package/src/parent-source-orphan.test.ts +121 -0
  220. package/src/password-network-tokens.ts +25 -0
  221. package/src/peer-reply-atomic.test.ts +462 -0
  222. package/src/peer-reply-capability.test.ts +70 -0
  223. package/src/pg-worker.ts +87 -0
  224. package/src/poll-pacing.test.ts +74 -0
  225. package/src/poll-pacing.ts +123 -0
  226. package/src/probe-provider-error-domain.test.ts +145 -0
  227. package/src/project-dir-warn-clear-http.test.ts +132 -0
  228. package/src/project-viewer-can-http.test.ts +116 -0
  229. package/src/provider-skill-error-domain.test.ts +130 -0
  230. package/src/provider-tools-shape.test.ts +165 -0
  231. package/src/push.test.ts +20 -10
  232. package/src/push.ts +373 -9
  233. package/src/redact-tokens.test.ts +86 -0
  234. package/src/redact-tokens.ts +43 -0
  235. package/src/rejection-counters.test.ts +72 -0
  236. package/src/rejection-counters.ts +173 -0
  237. package/src/rename.ts +38 -10
  238. package/src/reply-target-derivation.test.ts +96 -0
  239. package/src/report-status-handover-capabilities-http.test.ts +124 -0
  240. package/src/report-status-host-schema.test.ts +235 -0
  241. package/src/report-status-resume-id-handover.test.ts +184 -0
  242. package/src/report-status-secret-keys.test.ts +140 -0
  243. package/src/require-explicit-test-db.ts +9 -0
  244. package/src/requirement-due-reminders-http.test.ts +620 -0
  245. package/src/requirement-due-reminders.ts +416 -0
  246. package/src/requirement-events-http.test.ts +318 -0
  247. package/src/requirement-events.test.ts +45 -0
  248. package/src/requirement-events.ts +144 -0
  249. package/src/requirement-notify.ts +165 -0
  250. package/src/requirement-participant-notify-http.test.ts +313 -0
  251. package/src/requirement-tag-ops-http.test.ts +454 -0
  252. package/src/requirement-tag-tree-http.test.ts +275 -0
  253. package/src/requirement-tag-tree.ts +127 -0
  254. package/src/requirement-tags.ts +102 -0
  255. package/src/requirements-abandoned-http.test.ts +236 -0
  256. package/src/requirements-assignee-drift.test.ts +154 -0
  257. package/src/requirements-comment-http.test.ts +174 -0
  258. package/src/requirements-completed-at-migration.test.ts +70 -0
  259. package/src/requirements-errors-mcp-http.test.ts +164 -0
  260. package/src/requirements-errors.ts +158 -0
  261. package/src/requirements-etag-http.test.ts +91 -0
  262. package/src/requirements-http.test.ts +709 -0
  263. package/src/requirements-last-event-http.test.ts +349 -0
  264. package/src/requirements-list-mcp-slim-http.test.ts +155 -0
  265. package/src/requirements-list-slim-http.test.ts +324 -0
  266. package/src/requirements-mcp.test.ts +180 -0
  267. package/src/requirements-migrate.ts +283 -0
  268. package/src/requirements-owner-strict-mcp-http.test.ts +145 -0
  269. package/src/requirements-people-http.test.ts +114 -0
  270. package/src/requirements-people-mcp-http.test.ts +231 -0
  271. package/src/requirements-people.ts +196 -0
  272. package/src/requirements-priority-lowest.test.ts +114 -0
  273. package/src/requirements-projects-network-echo.test.ts +57 -0
  274. package/src/requirements-projects-parent-http.test.ts +123 -0
  275. package/src/requirements-search-http.test.ts +182 -0
  276. package/src/requirements-search.test.ts +32 -0
  277. package/src/requirements-search.ts +145 -0
  278. package/src/requirements-seq-http.test.ts +193 -0
  279. package/src/requirements-seq-migration.test.ts +63 -0
  280. package/src/requirements-start-date.test.ts +125 -0
  281. package/src/requirements-stats-http.test.ts +357 -0
  282. package/src/requirements-stats.ts +195 -0
  283. package/src/requirements-status-participants-http.test.ts +222 -0
  284. package/src/requirements-upgrade-e2e.test.ts +126 -0
  285. package/src/requirements-upgrade-migration.test.ts +98 -0
  286. package/src/requirements.ts +2205 -0
  287. package/src/resolve-port.test.ts +57 -0
  288. package/src/resolve-port.ts +44 -0
  289. package/src/rest-alias-network-fallback-http.test.ts +123 -0
  290. package/src/rest-alias-network-fallback.test.ts +60 -0
  291. package/src/rest-alias-network-fallback.ts +65 -0
  292. package/src/rest-explicit-columns-http.test.ts +266 -0
  293. package/src/rest-identity.test.ts +130 -0
  294. package/src/rest-identity.ts +141 -0
  295. package/src/rest-projections.ts +72 -0
  296. package/src/rest-read-network-real-chain.test.ts +97 -0
  297. package/src/rest-write-network-resolution.test.ts +133 -0
  298. package/src/restart-readiness-http.test.ts +121 -0
  299. package/src/restricted-files.ts +76 -0
  300. package/src/retention-first-sweep-quiet.test.ts +31 -0
  301. package/src/retention.test.ts +100 -40
  302. package/src/retention.ts +423 -104
  303. package/src/route-callers-http.test.ts +120 -0
  304. package/src/route-timing.test.ts +218 -0
  305. package/src/route-timing.ts +262 -0
  306. package/src/rules-file-duplicate-alias.test.ts +234 -0
  307. package/src/rules-file-session-target.test.ts +207 -0
  308. package/src/rules-file-transport.test.ts +271 -0
  309. package/src/runtime-label.test.ts +22 -0
  310. package/src/runtime-label.ts +21 -0
  311. package/src/runtime-readiness.ts +90 -0
  312. package/src/schedule-agent-mcp-http.test.ts +486 -0
  313. package/src/schedule-agent.ts +252 -0
  314. package/src/schedule-starved.test.ts +92 -0
  315. package/src/schedule-starved.ts +114 -0
  316. package/src/scheduled-backoff-http.test.ts +203 -0
  317. package/src/scheduled-backoff.ts +64 -0
  318. package/src/scheduled-doorbell-nodeless-session.test.ts +134 -0
  319. package/src/scheduled-failure-backoff-2622.test.ts +145 -0
  320. package/src/scheduled-failure-code.test.ts +73 -0
  321. package/src/scheduled-failure-code.ts +105 -0
  322. package/src/scheduled-failures-http.test.ts +279 -0
  323. package/src/scheduled-failures.ts +425 -0
  324. package/src/scheduled-noprogress-backoff-2622.test.ts +163 -0
  325. package/src/scheduled-offline-backoff-probe.test.ts +56 -0
  326. package/src/scheduled-offline.test.ts +131 -0
  327. package/src/scheduled-offline.ts +66 -0
  328. package/src/scheduled-outcome-guidance-http.test.ts +139 -0
  329. package/src/scheduled-outcome-guidance.ts +9 -0
  330. package/src/scheduled-reply-unread-http.test.ts +212 -0
  331. package/src/scheduled-requirement-wake-http.test.ts +289 -0
  332. package/src/scheduled-requirement-wake.ts +125 -0
  333. package/src/scheduled-run-terminal.test.ts +290 -0
  334. package/src/scheduled-skip-blocking-task.test.ts +120 -0
  335. package/src/scheduled-skip-path-backoff-2622.test.ts +98 -0
  336. package/src/scheduled-stuck-http.test.ts +316 -0
  337. package/src/scheduled-stuck-notice-cap.test.ts +80 -0
  338. package/src/scheduled-stuck.ts +219 -0
  339. package/src/scheduled-tasks-http.test.ts +679 -0
  340. package/src/scheduled-tasks.ts +959 -0
  341. package/src/scheduled-work-outcome-http.test.ts +154 -0
  342. package/src/scheduled-work-outcome.ts +50 -0
  343. package/src/scoped-secrets.ts +167 -0
  344. package/src/secret-echo-negative-control.test.ts +118 -0
  345. package/src/send-dedup-request-id.test.ts +229 -0
  346. package/src/send-reply-agent-warning.test.ts +38 -38
  347. package/src/send-reply-alias-optional.test.ts +131 -0
  348. package/src/send-reply-attachments.test.ts +28 -7
  349. package/src/send_dedup.test.ts +54 -0
  350. package/src/send_dedup.ts +52 -6
  351. package/src/serve-error.test.ts +73 -0
  352. package/src/serve-error.ts +56 -0
  353. package/src/server.ts +4963 -377
  354. package/src/session-task-on-dispatch.ts +14 -0
  355. package/src/session-token-ownership-http.test.ts +122 -0
  356. package/src/shared/codex-inventory.ts +41 -0
  357. package/src/shared/daemon-provider-login.ts +31 -0
  358. package/src/shared/daemon-provider-snapshot.ts +52 -0
  359. package/src/shared/external-schedule-contract.ts +60 -0
  360. package/src/shared/node-name.test.ts +62 -0
  361. package/src/shared/node-name.ts +161 -0
  362. package/src/shared/probe-host-allowlist-drift.test.ts +45 -0
  363. package/src/shared/provider-application.ts +29 -0
  364. package/src/shared/provider-collection.ts +14 -0
  365. package/src/shared/provider-initialization.ts +8 -0
  366. package/src/shared/reserved-env-drift.test.ts +10 -0
  367. package/src/shared/scoped-secret-contract.ts +5 -0
  368. package/src/shared/task-content-limit-drift.test.ts +28 -0
  369. package/src/shared/task-content-limit.ts +25 -0
  370. package/src/side-thread-command-transport.test.ts +312 -0
  371. package/src/side-thread-command-transport.ts +318 -0
  372. package/src/side-thread-http-integration.test.ts +233 -0
  373. package/src/side-thread-http.ts +504 -0
  374. package/src/side-thread-production.test.ts +72 -0
  375. package/src/side-thread-production.ts +118 -0
  376. package/src/side-thread.test.ts +1067 -0
  377. package/src/side-thread.ts +2499 -0
  378. package/src/skillhub-http.test.ts +144 -0
  379. package/src/sqlite-close-checkpoint.test.ts +78 -0
  380. package/src/start-node.test.ts +265 -0
  381. package/src/start-request-error-domain.test.ts +182 -0
  382. package/src/start-skill-error-domain.test.ts +122 -0
  383. package/src/stats-versions-http.test.ts +65 -0
  384. package/src/status-alias-filter-http.test.ts +106 -0
  385. package/src/status-alias-resolver-http.test.ts +163 -0
  386. package/src/status-alias-resolver.ts +19 -0
  387. package/src/status-node-id-filter-http.test.ts +161 -0
  388. package/src/status-read-cache-http.test.ts +229 -0
  389. package/src/status-read-cache.ts +129 -0
  390. package/src/stop-delete-node.test.ts +567 -1
  391. package/src/task-access-http.test.ts +407 -0
  392. package/src/task-access.ts +420 -0
  393. package/src/task-activity.ts +60 -0
  394. package/src/task-auth-origin-http.test.ts +93 -0
  395. package/src/task-auth-origin.test.ts +24 -0
  396. package/src/task-auth-origin.ts +7 -0
  397. package/src/task-consumption.test.ts +508 -0
  398. package/src/task-diagnostic-http.test.ts +149 -0
  399. package/src/task-diagnostic.test.ts +115 -0
  400. package/src/task-diagnostic.ts +118 -0
  401. package/src/task-expiry-notice-http.test.ts +298 -0
  402. package/src/task-expiry-notice.ts +318 -0
  403. package/src/task-idempotency-mcp.test.ts +148 -0
  404. package/src/task-idempotency.test.ts +76 -0
  405. package/src/task-idempotency.ts +81 -0
  406. package/src/task-late-replies.ts +54 -0
  407. package/src/task-late-reply-http.test.ts +227 -0
  408. package/src/task-lifecycle-watcher-busy.test.ts +114 -0
  409. package/src/task-lifecycle-watcher.test.ts +209 -0
  410. package/src/task-lifecycle-watcher.ts +109 -0
  411. package/src/task-network-resolution-http.test.ts +140 -0
  412. package/src/task-not-found-error-domain.test.ts +114 -0
  413. package/src/task-offline-delivery-2668.test.ts +119 -0
  414. package/src/task-offline-delivery.ts +81 -0
  415. package/src/task-orphan-http.test.ts +287 -0
  416. package/src/task-orphan.ts +119 -0
  417. package/src/task-queue-ahead-http.test.ts +309 -0
  418. package/src/task-queue-ahead-scale.test.ts +236 -0
  419. package/src/task-queue-ahead.ts +186 -0
  420. package/src/task-rejection-log-http.test.ts +160 -0
  421. package/src/task-rejection-log.ts +61 -0
  422. package/src/task-sender-http.test.ts +143 -0
  423. package/src/task-stale-open-http.test.ts +292 -0
  424. package/src/task-stale-open.ts +103 -0
  425. package/src/tasks-pagination-http.test.ts +141 -0
  426. package/src/team-rules-status-http.test.ts +90 -0
  427. package/src/team-rules-status.test.ts +59 -0
  428. package/src/team-rules-status.ts +72 -0
  429. package/src/tmux-allowlist.test.ts +48 -0
  430. package/src/tool-audience-http.test.ts +248 -0
  431. package/src/tool-audience.ts +130 -0
  432. package/src/tools-list-json-schema.test.ts +94 -0
  433. package/src/tools.ts +4340 -386
  434. package/src/update-node-config-error-domain.test.ts +107 -0
  435. package/src/uploads-http.test.ts +6 -4
  436. package/src/uploads.ts +23 -4
  437. package/src/user-avatar-http.test.ts +74 -0
  438. package/src/user-avatar-image.ts +160 -0
  439. package/src/user-avatar-migration.test.ts +25 -0
  440. package/src/user-avatar-upload-http.test.ts +353 -0
  441. package/src/user-inbox-by-agent-http.test.ts +189 -0
  442. package/src/user-inbox-netid-notnull.test.ts +122 -0
  443. package/src/user-inbox-read-http.test.ts +223 -0
  444. package/src/user-inbox-schema.test.ts +54 -0
  445. package/src/version-stats.test.ts +66 -0
  446. package/src/version-stats.ts +109 -0
@@ -0,0 +1,257 @@
1
+ import { beforeAll, afterAll, expect, test } from "bun:test";
2
+ import { mkdtempSync } from "node:fs";
3
+ import { join } from "node:path";
4
+ import { tmpdir } from "node:os";
5
+
6
+ const dir = mkdtempSync(join(tmpdir(), "lifecycle-read-"));
7
+ process.env.COMMHUB_DB ||= join(dir, "hub.db");
8
+ process.env.COMMHUB_AUTH_TOKEN ||= "lifecycle-read-master-fixture";
9
+ let hub: ReturnType<typeof Bun.serve>, base: string;
10
+ let db: any, a: any, b: any, limited: any, daemonToken: string;
11
+ const ids = { active: "n_read_active", created: "node_read_created", manual: "node_read_manual", daemon: "n_read_daemon" };
12
+ const get = async (path: string, token = a.token) => {
13
+ const res = await fetch(base + path, { headers: { Authorization: `Bearer ${token}` } });
14
+ return { status: res.status, body: await res.json() as any };
15
+ };
16
+ const query = (kind: string, selector: string) => `/api/node-lifecycle-requests?kind=${kind}&${selector}`;
17
+
18
+ beforeAll(async () => {
19
+ ({ db } = await import("./db.js"));
20
+ const { register } = await import("./auth.js");
21
+ const suffix = Date.now();
22
+ a = register(`read_owner_${suffix}`, "ReadFixture-Strong1!");
23
+ b = register(`read_other_${suffix}`, "ReadFixture-Strong1!");
24
+ limited = register(`read_limited_${suffix}`, "ReadFixture-Strong1!");
25
+ expect(a.ok && b.ok && limited.ok).toBe(true);
26
+ for (const user of [a, b, limited]) db.run("UPDATE users SET role='user' WHERE user_id=?1", [user.user.user_id]);
27
+ db.run("INSERT INTO network_members(network_id,user_id,role,agent_access) VALUES(?1,?2,'viewer','granted')", [a.network_id, limited.user.user_id]);
28
+ for (const [key, id] of Object.entries(ids)) db.run(
29
+ "INSERT INTO nodes(node_id,node_name,alias,network_id,owner_user_id,hostname,config_snapshot) VALUES(?1,?2,?2,?3,?4,'fixture-host',?5)",
30
+ [id, `read-${key}`, a.network_id, a.user.user_id, key === "daemon" ? JSON.stringify({ role: "host_supervisor", daemon_capabilities: { adopt_capable: true } }) : "{}"]);
31
+ for (const status of ["active", "pending", "refused", "revoked"]) {
32
+ const id = status === "active" ? ids.active : `n_read_${status}`;
33
+ if (status !== "active") db.run("INSERT INTO nodes(node_id,node_name,alias,network_id) VALUES(?1,?1,?2,?3)", [id, `read-${status}`, a.network_id]);
34
+ db.run(`INSERT INTO node_daemon_bindings(request_id,network_id,node_id,daemon_node_id,workdir,requested_by,status,error,created_at,updated_at)
35
+ VALUES(?1,?2,?3,?4,'/private/fixture',?5,?6,?7,1,2)`,
36
+ [`adopt_read_${status}`, a.network_id, id, ids.daemon, a.user.user_id, status, status === "refused" ? "adopt_start_evidence_missing" : null]);
37
+ }
38
+ db.run(`INSERT INTO node_create_requests(request_id,daemon_node_id,child_name,network_id,runtime,flags_json,env_keys,status,created_at,created_by_token)
39
+ VALUES('cr_read_created',?1,'created',?2,'codex-sdk','{}','[]','succeeded',1,'private-token')`, [ids.daemon, a.network_id]);
40
+ db.run(`INSERT INTO node_stop_requests(request_id,network_id,daemon_node_id,child_node_id,child_alias,action,created_by_token,status,error,created_at,acked_at)
41
+ VALUES('stop_read_failed',?1,?2,?3,'read-active','stop','private-token','stop_failed','adopt_explicit_private_socket_required',3,4)`, [a.network_id, ids.daemon, ids.active]);
42
+ db.run(`INSERT INTO node_start_requests(request_id,network_id,daemon_node_id,child_node_id,child_alias,created_by_token,status,error,created_at,acked_at)
43
+ VALUES('start_read_failed',?1,?2,?3,'read-active','private-token','start_failed','adopt_start_evidence_missing',5,6)`, [a.network_id, ids.daemon, ids.active]);
44
+ db.run("INSERT INTO sessions(resume_id,alias,node_id,network_id,status,last_seen_at) VALUES('read-daemon-session','read-daemon',?1,?2,'idle',datetime('now'))", [ids.daemon, a.network_id]);
45
+ const { generateNetworkToken, hashToken } = await import("./db.js");
46
+ daemonToken = generateNetworkToken();
47
+ db.run("INSERT INTO api_tokens(token_id,user_id,network_id,scope,name,token_hash) VALUES('read-daemon-token',?1,?2,'network','node:read-daemon',?3)", [a.user.user_id, a.network_id, hashToken(daemonToken)]);
48
+ const { bootServer } = await import("./server.js");
49
+ hub = bootServer({ port: 0, hostname: "127.0.0.1" });
50
+ base = `http://127.0.0.1:${hub.port}`;
51
+ }, 30_000);
52
+ afterAll(() => hub?.stop(true));
53
+
54
+ test("public errors redact free text for granted viewers on every projection", async () => {
55
+ db.run("INSERT INTO network_member_agent_grants(network_id,user_id,node_id,can_message) VALUES(?1,?2,?3,0)", [a.network_id, limited.user.user_id, ids.active]);
56
+ try {
57
+ for (const error of [
58
+ "/private/fixture/secret on fixture-host",
59
+ "not_my_child: daemon has no local record of fixture-node (fixture-id) — no children-map entry and no config at /private/fixture/fixture-node/config.json; refusing to signal processes by alias.",
60
+ "bin: ENOENT: /private/fixture/bin/anet on fixture-host",
61
+ "adopt_unknown_secret", "adopt_start_timeout: /private/fixture", "", "adopt_start_timeout", null,
62
+ "adopted_node_delete_unsupported", "adopt_codex_readopt_required", "adopt_stop_receipt_changed",
63
+ "adopt_codex_external_start_unproven", "adopt_codex_launch_failed", "adopt_codex_launch_timeout",
64
+ "adopt_codex_port_unproven", "adopt_codex_start_superseded", "adopt_codex_binding_generation_unproven",
65
+ "adopt_codex_start_evidence_missing", "adopt_codex_start_evidence_changed",
66
+ "adopt_codex_session_conflict", "adopt_codex_port_unavailable", "adopt_codex_stage_still_running",
67
+ "adopt_codex_identity_unproven",
68
+ "TUI session mismatch", "opencode_launch_health:TUI session mismatch", "opencode_tui_session_mismatch",
69
+ // #2012:daemon 明确拒绝的固定安全码,必须原样投影给用户,而不是退化成 lifecycle_error。
70
+ "copresence_adopt_v2",
71
+ // 负控:带后缀/路径/空白的形状仍必须清成 lifecycle_error(只精确放行这一串)。
72
+ "copresence_adopt_v2: /private/fixture", "copresence_adopt_v2x", " copresence_adopt_v2",
73
+ ]) {
74
+ const publicCodes = ["adopt_start_timeout", "adopted_node_delete_unsupported", "adopt_codex_readopt_required", "adopt_stop_receipt_changed", "opencode_tui_session_mismatch",
75
+ "copresence_adopt_v2",
76
+ "adopt_codex_external_start_unproven", "adopt_codex_launch_failed", "adopt_codex_launch_timeout",
77
+ "adopt_codex_port_unproven", "adopt_codex_start_superseded", "adopt_codex_binding_generation_unproven",
78
+ "adopt_codex_start_evidence_missing", "adopt_codex_start_evidence_changed",
79
+ "adopt_codex_session_conflict", "adopt_codex_port_unavailable", "adopt_codex_stage_still_running",
80
+ "adopt_codex_identity_unproven"];
81
+ const expected = error === null || publicCodes.includes(error) ? error : "lifecycle_error";
82
+ for (const [kind, table, request] of [
83
+ ["adopt", "node_daemon_bindings", "adopt_read_active"],
84
+ ["start", "node_start_requests", "start_read_failed"],
85
+ ["stop", "node_stop_requests", "stop_read_failed"],
86
+ ]) {
87
+ db.run(`UPDATE ${table} SET error=?1 WHERE request_id=?2`, [error, request]);
88
+ for (const selector of [`request_id=${request}`, `node_id=${ids.active}`]) {
89
+ const r = await get(query(kind, selector), limited.token);
90
+ expect(r.status).toBe(200);
91
+ expect(r.body.request.error).toBe(expected);
92
+ }
93
+ }
94
+ const nodes = (await get(`/api/nodes?network_id=${a.network_id}`, limited.token)).body.nodes;
95
+ expect(nodes[0].adoption.error).toBe(expected);
96
+ }
97
+ } finally {
98
+ db.run("DELETE FROM network_member_agent_grants WHERE user_id=?1 AND node_id=?2", [limited.user.user_id, ids.active]);
99
+ db.run("UPDATE node_daemon_bindings SET error=NULL WHERE request_id='adopt_read_active'");
100
+ db.run("UPDATE node_start_requests SET error='adopt_start_evidence_missing' WHERE request_id='start_read_failed'");
101
+ db.run("UPDATE node_stop_requests SET error='adopt_explicit_private_socket_required' WHERE request_id='stop_read_failed'");
102
+ }
103
+ });
104
+
105
+ test("created projection prefers recorded child id and only falls back for legacy null", async () => {
106
+ const read = async () => (await get(`/api/nodes?network_id=${a.network_id}`)).body.nodes;
107
+ try {
108
+ expect((await read()).find((n: any) => n.node_id === ids.created).managed).toBe("created");
109
+ db.run("UPDATE node_create_requests SET child_node_id=?1 WHERE request_id='cr_read_created'", [ids.manual]);
110
+ let nodes = await read();
111
+ expect(nodes.find((n: any) => n.node_id === ids.manual).managed).toBe("created");
112
+ expect(nodes.find((n: any) => n.node_id === ids.created).managed).toBe("none");
113
+ db.run("UPDATE node_create_requests SET child_node_id='missing-child' WHERE request_id='cr_read_created'");
114
+ expect((await read()).find((n: any) => n.node_id === ids.created).managed).toBe("none");
115
+ db.run("UPDATE node_create_requests SET child_node_id=?1,network_id=?2 WHERE request_id='cr_read_created'", [ids.manual, b.network_id]);
116
+ nodes = await read();
117
+ expect(nodes.find((n: any) => n.node_id === ids.manual).managed).toBe("none");
118
+ } finally {
119
+ db.run("UPDATE node_create_requests SET child_node_id=NULL,network_id=?1 WHERE request_id='cr_read_created'", [a.network_id]);
120
+ }
121
+ });
122
+
123
+ test("authenticated port-0 HTTP projects actual authority, never an id prefix", async () => {
124
+ const { status, body } = await get(`/api/nodes?network_id=${a.network_id}`);
125
+ expect(status).toBe(200);
126
+ const rows = body.nodes;
127
+ expect(rows.find((r: any) => r.node_id === ids.created)).toMatchObject({ managed: "created", adoption: null, lifecycle_controllable: true });
128
+ expect(rows.find((r: any) => r.node_id === ids.manual)).toMatchObject({ managed: "none", adoption: null, lifecycle_controllable: false });
129
+ expect(rows.find((r: any) => r.node_id === ids.active)).toMatchObject({ managed: "adopted", adoption: { status: "active", request_id: "adopt_read_active" }, lifecycle_controllable: true });
130
+ for (const status of ["pending", "refused", "revoked"]) expect(rows.find((r: any) => r.node_id === `n_read_${status}`)).toMatchObject({ managed: "none", adoption: { status } });
131
+ });
132
+ test("adopt query preserves all persisted states, request id and bounded projection", async () => {
133
+ for (const status of ["pending", "active", "refused", "revoked"]) {
134
+ const r = await get(query("adopt", `request_id=adopt_read_${status}`));
135
+ expect(r.status).toBe(200);
136
+ console.log("LIFE_KEYS=" + JSON.stringify(Object.keys(r.body).sort()) + " REQ_KEYS=" + JSON.stringify(Object.keys(r.body.request).sort()));
137
+ // 2026-10-31 —— #3214:外层与 request 的键集都由真实调用给出(此前只断言了值)
138
+ expect(Object.keys(r.body).sort()).toEqual(["ok", "request"]);
139
+ expect(Object.keys(r.body.request).sort()).toEqual([
140
+ "created_at", "daemon_node_id", "error", "kind", "network_id",
141
+ "node_id", "request_id", "status", "updated_at",
142
+ ]);
143
+ expect(r.body.request).toMatchObject({ kind: "adopt", status, request_id: `adopt_read_${status}` });
144
+ expect(r.body.request.workdir).toBeUndefined();
145
+ expect(r.body.request.requested_by).toBeUndefined();
146
+ }
147
+ });
148
+ test("start/stop returns daemon failure codes; node selector returns latest, not success fiction", async () => {
149
+ for (const [kind, error] of [["start", "adopt_start_evidence_missing"], ["stop", "adopt_explicit_private_socket_required"]]) {
150
+ const r = await get(query(kind, `node_id=${ids.active}`));
151
+ expect(r.status).toBe(200);
152
+ expect(r.body.request).toMatchObject({ status: `${kind}_failed`, error, node_id: ids.active });
153
+ expect(r.body.request.created_by_token).toBeUndefined();
154
+ }
155
+ expect((await get(query("start", `node_id=${ids.manual}`))).body.request).toBeNull();
156
+ });
157
+ test("cross-network request and node guesses do not disclose data", async () => {
158
+ for (const kind of ["adopt", "start", "stop"]) {
159
+ const id = kind === "adopt" ? "adopt_read_active" : `${kind}_read_failed`;
160
+ const denied = await get(query(kind, `request_id=${id}`), b.token);
161
+ expect(denied.status).toBe(404);
162
+ expect(denied.body).toEqual((await get(query(kind, "request_id=nonexistent"), b.token)).body);
163
+ expect((await get(query(kind, `node_id=${ids.active}`), b.token)).status).toBe(404);
164
+ expect((await get(query(kind, `request_id=${id}&network_id=${a.network_id}`), b.token)).status).toBe(403);
165
+ }
166
+ });
167
+ test("fork receipt uses the same authenticated node visibility and redacts corrupt storage", async () => {
168
+ const receipt = { state: "forked", old_thread_id: "01a11846-d796-72f1-af68-8d9215a65dc8", new_thread_id: "01a11900-0000-7000-8000-000000000001" };
169
+ const path = query("start", "request_id=start_read_failed");
170
+ try {
171
+ db.run("UPDATE node_start_requests SET fork_recovery_json=?1,fork_result_json=?2 WHERE request_id='start_read_failed'",
172
+ [JSON.stringify({ kind: "fork_on_missing_ordinal", confirmed: true }), JSON.stringify(receipt)]);
173
+ expect((await get(path)).body.request.fork_recovery).toEqual({ requested: true, result: receipt });
174
+ expect((await get(path, b.token)).status).toBe(404);
175
+ expect((await get(path, limited.token)).status).toBe(404);
176
+ expect((await get(path, daemonToken)).status).toBe(403);
177
+ db.run("INSERT INTO network_member_agent_grants(network_id,user_id,node_id,can_message) VALUES(?1,?2,?3,0)", [a.network_id, limited.user.user_id, ids.active]);
178
+ expect((await get(path, limited.token)).body.request.fork_recovery.result).toEqual(receipt);
179
+ db.run("UPDATE node_start_requests SET fork_result_json=?1 WHERE request_id='start_read_failed'", [JSON.stringify({ ...receipt, snapshot: "/private/secret" })]);
180
+ const corrupted = await get(path, limited.token);
181
+ expect(corrupted.body.request.fork_recovery.result).toEqual({ state: "unknown", reason: "result_invalid" });
182
+ expect(JSON.stringify(corrupted)).not.toContain("/private");
183
+ // Corrupt confirmation cannot assert requested:true, but must not erase an
184
+ // independently valid recorded fork (nor make the request look ordinary).
185
+ for (const raw of ["broken /private/secret", "null", "{}", JSON.stringify({ kind: "fork_on_missing_ordinal", confirmed: false }),
186
+ JSON.stringify({ kind: "fork_on_missing_ordinal", confirmed: true, snapshot: "/private/secret" })]) {
187
+ db.run("UPDATE node_start_requests SET fork_recovery_json=?1,fork_result_json=?2 WHERE request_id='start_read_failed'", [raw, JSON.stringify(receipt)]);
188
+ const invalid = await get(path, limited.token);
189
+ expect(invalid.body.request.fork_recovery).toEqual({ requested: null, result: receipt });
190
+ expect(JSON.stringify(invalid)).not.toContain("/private");
191
+ }
192
+ } finally {
193
+ db.run("DELETE FROM network_member_agent_grants WHERE user_id=?1 AND node_id=?2", [limited.user.user_id, ids.active]);
194
+ db.run("UPDATE node_start_requests SET fork_recovery_json=NULL,fork_result_json=NULL WHERE request_id='start_read_failed'");
195
+ }
196
+ });
197
+ test("same-network restricted viewer without node grants cannot read requests", async () => {
198
+ for (const kind of ["adopt", "start", "stop"]) {
199
+ expect((await get(query(kind, `node_id=${ids.active}&network_id=${a.network_id}`), limited.token)).status).toBe(404);
200
+ const id = kind === "adopt" ? "adopt_read_active" : `${kind}_read_failed`;
201
+ expect((await get(query(kind, `request_id=${id}&network_id=${a.network_id}`), limited.token)).status).toBe(404);
202
+ }
203
+ expect((await get(`/api/nodes?network_id=${a.network_id}`, limited.token)).body.nodes).toEqual([]);
204
+ });
205
+ test("current node grant allows reads; revocation immediately closes them", async () => {
206
+ db.run("INSERT INTO network_member_agent_grants(network_id,user_id,node_id,can_message) VALUES(?1,?2,?3,0)", [a.network_id, limited.user.user_id, ids.active]);
207
+ try {
208
+ expect((await get(query("adopt", "request_id=adopt_read_active"), limited.token)).status).toBe(200);
209
+ const nodes = (await get(`/api/nodes?network_id=${a.network_id}`, limited.token)).body.nodes;
210
+ expect(nodes).toHaveLength(1);
211
+ expect(nodes[0].managed).toBe("adopted");
212
+ } finally { db.run("DELETE FROM network_member_agent_grants WHERE user_id=?1 AND node_id=?2", [limited.user.user_id, ids.active]); }
213
+ expect((await get(query("adopt", "request_id=adopt_read_active"), limited.token)).status).toBe(404);
214
+ });
215
+ test("daemon and legacy master do not gain the new user read surface", async () => {
216
+ for (const token of [daemonToken, process.env.COMMHUB_AUTH_TOKEN!]) {
217
+ expect((await get(query("adopt", "request_id=adopt_read_active"), token)).status).toBe(403);
218
+ const nodes = (await get(`/api/nodes?network_id=${a.network_id}`, token)).body.nodes;
219
+ expect(nodes.length).toBeGreaterThan(0);
220
+ expect(nodes.every((n: any) => !("managed" in n) && !("adoption" in n))).toBe(true);
221
+ }
222
+ expect((await get(query("adopt", "request_id=adopt_read_active"), "invalid")).status).toBe(401);
223
+ const queryOnly = await fetch(base + query("adopt", `request_id=adopt_read_active&token=${encodeURIComponent(a.token)}`));
224
+ expect([401, 403]).toContain(queryOnly.status);
225
+ });
226
+ test("host-supervisors capability respects user token and node visibility; absent stays absent", async () => {
227
+ const path = `/api/host-supervisors?network_id=${a.network_id}`;
228
+ expect((await get(path)).body.daemons.find((d: any) => d.daemon_node_id === ids.daemon).adopt_capable).toBe(true);
229
+ for (const token of [limited.token, daemonToken]) {
230
+ const r = await get(path, token);
231
+ expect((r.body.daemons ?? []).every((d: any) => !("adopt_capable" in d))).toBe(true);
232
+ }
233
+ db.run("UPDATE nodes SET config_snapshot=?1 WHERE node_id=?2", [JSON.stringify({ role: "host_supervisor", daemon_capabilities: { adopt_capable: false } }), ids.daemon]);
234
+ expect((await get(path)).body.daemons[0].adopt_capable).toBe(false);
235
+ db.run("UPDATE nodes SET config_snapshot=?1 WHERE node_id=?2", [JSON.stringify({ role: "host_supervisor" }), ids.daemon]);
236
+ expect((await get(path)).body.daemons[0].adopt_capable).toBeUndefined();
237
+ });
238
+ test("invalid selectors rejected rather than listing every lifecycle request", async () => {
239
+ for (const suffix of ["", "kind=adopt", "kind=other&node_id=x", "kind=start&request_id=x&node_id=y", "kind=stop&node_id=x&node_id=y", "kind=start&request_id=x&node_id=", "kind=adopt&node_id=%20"])
240
+ expect((await get(`/api/node-lifecycle-requests?${suffix}`)).status).toBe(400);
241
+ });
242
+ test("request state refresh exposes pending, completion and binding-missing failure without caching", async () => {
243
+ for (const [kind, statuses] of [["start", ["pending", "delivered", "started", "start_failed", "timeout"]], ["stop", ["pending", "delivered", "stopped", "stop_failed", "noop_not_my_child"]]] as const) {
244
+ for (const status of statuses) {
245
+ const error = status.endsWith("failed") ? "adopt_active_binding_required" : null;
246
+ db.run(`UPDATE node_${kind}_requests SET status=?1,error=?2 WHERE request_id=?3`, [status, error, `${kind}_read_failed`]);
247
+ expect((await get(query(kind, `request_id=${kind}_read_failed`))).body.request).toMatchObject({ status, error });
248
+ }
249
+ }
250
+ });
251
+ test("join refuses a request whose stored network disagrees with its target node", async () => {
252
+ db.run("UPDATE node_start_requests SET network_id=?1 WHERE request_id='start_read_failed'", [b.network_id]);
253
+ try {
254
+ expect((await get(query("start", "request_id=start_read_failed"))).status).toBe(404);
255
+ expect((await get(query("start", "request_id=start_read_failed"), b.token)).status).toBe(404);
256
+ } finally { db.run("UPDATE node_start_requests SET network_id=?1 WHERE request_id='start_read_failed'", [a.network_id]); }
257
+ });
@@ -0,0 +1,124 @@
1
+ import { db } from "./db.js";
2
+ import { addAgentNetworkScope, type RestNetworkScope } from "./network-scope.js";
3
+ import { forkRecoveryRequestSchema, publicForkResult } from "./codex-fork-contract.js";
4
+
5
+ // Exact public codes only; daemon exception text must never reach node viewers.
6
+ const publicLifecycleErrors = new Set([
7
+ "codex_fork_confirmation_invalid", "codex_fork_recovery_unsupported", "codex_fork_cli_unsupported",
8
+ "codex_fork_result_invalid", "codex_fork_outcome_unknown",
9
+ "adopted_node_delete_unsupported", "adopt_codex_readopt_required", "adopt_stop_receipt_changed",
10
+ "adopt_codex_external_start_unproven", "adopt_codex_launch_failed", "adopt_codex_launch_timeout",
11
+ "adopt_codex_port_unproven", "adopt_codex_start_superseded", "adopt_codex_binding_generation_unproven",
12
+ "adopt_codex_start_evidence_missing", "adopt_codex_start_evidence_changed",
13
+ "adopt_codex_session_conflict", "adopt_codex_port_unavailable", "adopt_codex_stage_still_running",
14
+ "adopt_codex_identity_unproven",
15
+ "adopt_active_binding_required", "adopt_binding_unavailable",
16
+ "adopt_binding_revoked_during_start", "adopt_explicit_private_socket_required",
17
+ "adopt_start_evidence_missing", "adopt_stop_evidence_missing",
18
+ "adopt_launch_mode_mismatch", "adopt_lifecycle_verification_failed",
19
+ "adopt_process_generation_changed", "adopt_process_still_running",
20
+ "adopt_process_stop_timeout", "adopt_process_tree_unstable",
21
+ "adopt_registry_identity_mismatch", "adopt_self_process_refused",
22
+ "adopt_start_timeout", "adopt_tmux_session_still_exists",
23
+ "adopt_local_verification_failed", "adopt_roots_not_configured",
24
+ "adopt_workdir_outside_roots", "adopt_workdir_not_absolute",
25
+ "adopt_alias_invalid", "adopt_alias_mismatch", "adopt_config_invalid",
26
+ "adopt_config_network_mismatch", "adopt_network_mismatch",
27
+ "adopt_hub_invalid", "adopt_hub_missing", "adopt_hub_mismatch",
28
+ "adopt_identity_ambiguous", "adopt_identity_not_found", "adopt_identity_changed",
29
+ "adopt_path_not_regular", "adopt_path_owner_mismatch", "adopt_path_writable_by_others",
30
+ "adopt_process_argv_mismatch", "adopt_process_home_mismatch",
31
+ "adopt_process_identity_mismatch", "adopt_process_changed",
32
+ "adopt_tmux_socket_mismatch", "adopt_pane_invalid", "adopt_pane_unverified",
33
+ "adopt_pane_process_mismatch", "adopt_socket_directory_unsafe", "adopt_socket_unsafe",
34
+ "adopt_pid_changed", "adopt_pid_invalid", "adopt_pidfile_unsafe",
35
+ "opencode_tui_session_mismatch",
36
+ // #2012 —— daemon 的 copresence_adopt_v2 拒绝是固定安全码(无路径/无异常文本),
37
+ // 不放行会让用户投影退化成 lifecycle_error,看不到「为什么被拒绝」。
38
+ "copresence_adopt_v2",
39
+ "adopt_proc_invalid", "adopt_proc_unreadable", "adopt_platform_unsupported",
40
+ "adopt_registry_conflict", "adopt_registry_entry_invalid", "adopt_registry_invalid",
41
+ "adopt_registry_unsafe", "adopt_config_env_invalid", "adopt_env_file_invalid",
42
+ "adopt_env_file_unsafe", "adopt_request_mismatch", "adopt_ack_rejected",
43
+ ]);
44
+ function publicLifecycleError(error: unknown): string | null {
45
+ return error == null ? null
46
+ : typeof error === "string" && publicLifecycleErrors.has(error) ? error : "lifecycle_error";
47
+ }
48
+
49
+ type Adoption = { request_id: string; daemon_node_id: string; status: string; error: string | null };
50
+ export type LifecycleProjection = { managed: "created" | "adopted" | "none"; adoption: Adoption | null };
51
+ const scopeNodes = (sql: string, params: any[], scope: RestNetworkScope) =>
52
+ addAgentNetworkScope(sql, params, scope, { network: "n.network_id", nodeId: "n.node_id", alias: "n.alias" });
53
+
54
+ /** Called only for authenticated human readers. Same visibility as /api/nodes;
55
+ * constant query count, no id-prefix or host-name inference of authority. */
56
+ export function lifecycleProjections(scope: RestNetworkScope): Map<string, LifecycleProjection> {
57
+ const result = new Map<string, LifecycleProjection>();
58
+ const bp: any[] = [];
59
+ const bindings = db.all<Adoption & { node_id: string }>(scopeNodes(
60
+ `SELECT b.node_id,b.request_id,b.daemon_node_id,b.status,b.error
61
+ FROM node_daemon_bindings b JOIN nodes n ON n.node_id=b.node_id AND n.network_id=b.network_id
62
+ WHERE 1=1`, bp, scope) + " ORDER BY b.created_at DESC,b.request_id DESC", ...bp);
63
+ for (const b of bindings) {
64
+ let projection = result.get(b.node_id);
65
+ if (!projection) {
66
+ projection = { managed: "none", adoption: { request_id: b.request_id, daemon_node_id: b.daemon_node_id, status: b.status, error: publicLifecycleError(b.error) } };
67
+ result.set(b.node_id, projection);
68
+ }
69
+ if (b.status === "active") projection.managed = "adopted";
70
+ }
71
+ const cp: any[] = [];
72
+ const created = db.all<{ node_id: string }>(scopeNodes(
73
+ `SELECT n.node_id FROM node_create_requests c JOIN nodes n
74
+ ON n.node_id=COALESCE(c.child_node_id, CASE WHEN substr(c.request_id,1,3)='cr_'
75
+ THEN 'node_' || substr(c.request_id,4) END) AND n.network_id=c.network_id
76
+ WHERE 1=1`, cp, scope), ...cp);
77
+ for (const n of created) result.set(n.node_id, { managed: "created", adoption: result.get(n.node_id)?.adoption ?? null });
78
+ return result;
79
+ }
80
+
81
+ /** Read-only, selector-bound lookup. Join the live node in the SAME network,
82
+ * then apply its current visibility (including restricted member grants).
83
+ * Result fields exclude credentials, PID and config; error values separately
84
+ * use the exact public-code allowlist (daemon text may contain workdir paths). */
85
+ export function lifecycleRequestResponse(url: URL, scope: RestNetworkScope): Response {
86
+ const kind = url.searchParams.get("kind");
87
+ const requestId = url.searchParams.get("request_id"), nodeId = url.searchParams.get("node_id");
88
+ const fail = (error: string, status: number) => Response.json({ ok: false, error }, { status });
89
+ if (!["adopt", "start", "stop"].includes(kind ?? "")
90
+ || url.searchParams.has("request_id") === url.searchParams.has("node_id")
91
+ || !(requestId ?? nodeId ?? "").trim()
92
+ || ["kind", "request_id", "node_id"].some(k => url.searchParams.getAll(k).length > 1)
93
+ || (requestId ?? nodeId ?? "").length > 200) return fail("invalid_lifecycle_query", 400);
94
+ // The table and column names below come only from this closed enum.
95
+ const table = kind === "adopt" ? "node_daemon_bindings" : kind === "start" ? "node_start_requests" : "node_stop_requests";
96
+ const nodeColumn = kind === "adopt" ? "node_id" : "child_node_id";
97
+ // A node lookup with no request must distinguish 'no requests' from 'not visible'.
98
+ if (nodeId) {
99
+ const params: any[] = [nodeId];
100
+ if (!db.get(scopeNodes("SELECT n.node_id FROM nodes n WHERE n.node_id=?1", params, scope), ...params))
101
+ return fail("node_not_found", 404);
102
+ }
103
+ const params: any[] = [requestId ?? nodeId];
104
+ const sql = scopeNodes(`SELECT r.request_id,r.${nodeColumn} AS node_id,r.network_id,r.daemon_node_id,
105
+ r.status,r.error,r.created_at,${kind === "adopt" ? "r.updated_at" : "r.acked_at,r.delivered_at"}
106
+ ${kind === "start" ? ",r.fork_recovery_json,r.fork_result_json" : ""}
107
+ FROM ${table} r JOIN nodes n ON n.node_id=r.${nodeColumn} AND n.network_id=r.network_id
108
+ WHERE r.${requestId ? "request_id" : nodeColumn}=?1${kind === "stop" ? " AND r.action='stop'" : ""}`, params, scope);
109
+ const row = db.get<Record<string, unknown>>(sql + " ORDER BY r.created_at DESC,r.request_id DESC LIMIT 1", ...params);
110
+ if (!row && requestId) return fail("request_not_found", 404);
111
+ if (!row) return Response.json({ ok: true, request: null });
112
+ const { fork_recovery_json, fork_result_json, ...publicRow } = row;
113
+ let confirmed: true | null = null;
114
+ if (kind === "start" && typeof fork_recovery_json === "string") {
115
+ try {
116
+ if (forkRecoveryRequestSchema.safeParse(JSON.parse(fork_recovery_json)).success) confirmed = true;
117
+ } catch { /* damaged confirmation is unknown; keep any independently valid fork evidence */ }
118
+ }
119
+ return Response.json({ ok: true, request: { kind, ...publicRow, error: publicLifecycleError(row.error),
120
+ ...(kind === "start" && fork_recovery_json != null ? { fork_recovery: {
121
+ requested: confirmed, result: publicForkResult(fork_result_json),
122
+ } } : {}),
123
+ } });
124
+ }