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

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 (444) 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 +494 -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/not-found-api-http.test.ts +67 -0
  208. package/src/observer-avatar-http.test.ts +103 -10
  209. package/src/observer-push.test.ts +76 -0
  210. package/src/opencode-catalog-report-http.test.ts +139 -0
  211. package/src/opencode-v2-catalog.test.ts +268 -0
  212. package/src/opencode-v2-catalog.ts +356 -0
  213. package/src/package-version-consistency.test.ts +25 -0
  214. package/src/parent-infer.test.ts +82 -0
  215. package/src/parent-infer.ts +110 -0
  216. package/src/parent-source-marker.test.ts +70 -0
  217. package/src/parent-source-orphan.test.ts +121 -0
  218. package/src/password-network-tokens.ts +25 -0
  219. package/src/peer-reply-atomic.test.ts +462 -0
  220. package/src/peer-reply-capability.test.ts +70 -0
  221. package/src/pg-worker.ts +87 -0
  222. package/src/poll-pacing.test.ts +74 -0
  223. package/src/poll-pacing.ts +123 -0
  224. package/src/probe-provider-error-domain.test.ts +145 -0
  225. package/src/project-dir-warn-clear-http.test.ts +132 -0
  226. package/src/project-viewer-can-http.test.ts +116 -0
  227. package/src/provider-skill-error-domain.test.ts +130 -0
  228. package/src/provider-tools-shape.test.ts +165 -0
  229. package/src/push.test.ts +20 -10
  230. package/src/push.ts +373 -9
  231. package/src/redact-tokens.test.ts +86 -0
  232. package/src/redact-tokens.ts +43 -0
  233. package/src/rejection-counters.test.ts +72 -0
  234. package/src/rejection-counters.ts +173 -0
  235. package/src/rename.ts +38 -10
  236. package/src/reply-target-derivation.test.ts +96 -0
  237. package/src/report-status-handover-capabilities-http.test.ts +124 -0
  238. package/src/report-status-host-schema.test.ts +235 -0
  239. package/src/report-status-resume-id-handover.test.ts +184 -0
  240. package/src/report-status-secret-keys.test.ts +140 -0
  241. package/src/require-explicit-test-db.ts +9 -0
  242. package/src/requirement-due-reminders-http.test.ts +620 -0
  243. package/src/requirement-due-reminders.ts +416 -0
  244. package/src/requirement-events-http.test.ts +318 -0
  245. package/src/requirement-events.test.ts +45 -0
  246. package/src/requirement-events.ts +144 -0
  247. package/src/requirement-notify.ts +165 -0
  248. package/src/requirement-participant-notify-http.test.ts +313 -0
  249. package/src/requirement-tag-ops-http.test.ts +454 -0
  250. package/src/requirement-tag-tree-http.test.ts +275 -0
  251. package/src/requirement-tag-tree.ts +127 -0
  252. package/src/requirement-tags.ts +102 -0
  253. package/src/requirements-abandoned-http.test.ts +236 -0
  254. package/src/requirements-assignee-drift.test.ts +154 -0
  255. package/src/requirements-comment-http.test.ts +174 -0
  256. package/src/requirements-completed-at-migration.test.ts +70 -0
  257. package/src/requirements-errors-mcp-http.test.ts +164 -0
  258. package/src/requirements-errors.ts +158 -0
  259. package/src/requirements-etag-http.test.ts +91 -0
  260. package/src/requirements-http.test.ts +709 -0
  261. package/src/requirements-last-event-http.test.ts +349 -0
  262. package/src/requirements-list-mcp-slim-http.test.ts +155 -0
  263. package/src/requirements-list-slim-http.test.ts +324 -0
  264. package/src/requirements-mcp.test.ts +180 -0
  265. package/src/requirements-migrate.ts +283 -0
  266. package/src/requirements-owner-strict-mcp-http.test.ts +145 -0
  267. package/src/requirements-people-http.test.ts +114 -0
  268. package/src/requirements-people-mcp-http.test.ts +231 -0
  269. package/src/requirements-people.ts +196 -0
  270. package/src/requirements-priority-lowest.test.ts +114 -0
  271. package/src/requirements-projects-network-echo.test.ts +57 -0
  272. package/src/requirements-projects-parent-http.test.ts +123 -0
  273. package/src/requirements-search-http.test.ts +182 -0
  274. package/src/requirements-search.test.ts +32 -0
  275. package/src/requirements-search.ts +145 -0
  276. package/src/requirements-seq-http.test.ts +193 -0
  277. package/src/requirements-seq-migration.test.ts +63 -0
  278. package/src/requirements-start-date.test.ts +125 -0
  279. package/src/requirements-stats-http.test.ts +357 -0
  280. package/src/requirements-stats.ts +195 -0
  281. package/src/requirements-status-participants-http.test.ts +222 -0
  282. package/src/requirements-upgrade-e2e.test.ts +126 -0
  283. package/src/requirements-upgrade-migration.test.ts +98 -0
  284. package/src/requirements.ts +2205 -0
  285. package/src/resolve-port.test.ts +57 -0
  286. package/src/resolve-port.ts +44 -0
  287. package/src/rest-alias-network-fallback-http.test.ts +123 -0
  288. package/src/rest-alias-network-fallback.test.ts +60 -0
  289. package/src/rest-alias-network-fallback.ts +65 -0
  290. package/src/rest-explicit-columns-http.test.ts +266 -0
  291. package/src/rest-identity.test.ts +130 -0
  292. package/src/rest-identity.ts +141 -0
  293. package/src/rest-projections.ts +72 -0
  294. package/src/rest-read-network-real-chain.test.ts +97 -0
  295. package/src/rest-write-network-resolution.test.ts +133 -0
  296. package/src/restart-readiness-http.test.ts +121 -0
  297. package/src/restricted-files.ts +76 -0
  298. package/src/retention-first-sweep-quiet.test.ts +31 -0
  299. package/src/retention.test.ts +100 -40
  300. package/src/retention.ts +423 -104
  301. package/src/route-callers-http.test.ts +120 -0
  302. package/src/route-timing.test.ts +218 -0
  303. package/src/route-timing.ts +262 -0
  304. package/src/rules-file-duplicate-alias.test.ts +234 -0
  305. package/src/rules-file-session-target.test.ts +207 -0
  306. package/src/rules-file-transport.test.ts +271 -0
  307. package/src/runtime-label.test.ts +22 -0
  308. package/src/runtime-label.ts +21 -0
  309. package/src/runtime-readiness.ts +90 -0
  310. package/src/schedule-agent-mcp-http.test.ts +486 -0
  311. package/src/schedule-agent.ts +252 -0
  312. package/src/schedule-starved.test.ts +92 -0
  313. package/src/schedule-starved.ts +114 -0
  314. package/src/scheduled-backoff-http.test.ts +203 -0
  315. package/src/scheduled-backoff.ts +64 -0
  316. package/src/scheduled-doorbell-nodeless-session.test.ts +134 -0
  317. package/src/scheduled-failure-backoff-2622.test.ts +145 -0
  318. package/src/scheduled-failure-code.test.ts +73 -0
  319. package/src/scheduled-failure-code.ts +105 -0
  320. package/src/scheduled-failures-http.test.ts +279 -0
  321. package/src/scheduled-failures.ts +425 -0
  322. package/src/scheduled-noprogress-backoff-2622.test.ts +163 -0
  323. package/src/scheduled-offline-backoff-probe.test.ts +56 -0
  324. package/src/scheduled-offline.test.ts +131 -0
  325. package/src/scheduled-offline.ts +66 -0
  326. package/src/scheduled-outcome-guidance-http.test.ts +139 -0
  327. package/src/scheduled-outcome-guidance.ts +9 -0
  328. package/src/scheduled-reply-unread-http.test.ts +212 -0
  329. package/src/scheduled-requirement-wake-http.test.ts +289 -0
  330. package/src/scheduled-requirement-wake.ts +125 -0
  331. package/src/scheduled-run-terminal.test.ts +290 -0
  332. package/src/scheduled-skip-blocking-task.test.ts +120 -0
  333. package/src/scheduled-skip-path-backoff-2622.test.ts +98 -0
  334. package/src/scheduled-stuck-http.test.ts +316 -0
  335. package/src/scheduled-stuck-notice-cap.test.ts +80 -0
  336. package/src/scheduled-stuck.ts +219 -0
  337. package/src/scheduled-tasks-http.test.ts +679 -0
  338. package/src/scheduled-tasks.ts +959 -0
  339. package/src/scheduled-work-outcome-http.test.ts +154 -0
  340. package/src/scheduled-work-outcome.ts +50 -0
  341. package/src/scoped-secrets.ts +167 -0
  342. package/src/secret-echo-negative-control.test.ts +118 -0
  343. package/src/send-dedup-request-id.test.ts +229 -0
  344. package/src/send-reply-agent-warning.test.ts +38 -38
  345. package/src/send-reply-alias-optional.test.ts +131 -0
  346. package/src/send-reply-attachments.test.ts +28 -7
  347. package/src/send_dedup.test.ts +54 -0
  348. package/src/send_dedup.ts +52 -6
  349. package/src/serve-error.test.ts +73 -0
  350. package/src/serve-error.ts +56 -0
  351. package/src/server.ts +4930 -377
  352. package/src/session-task-on-dispatch.ts +14 -0
  353. package/src/session-token-ownership-http.test.ts +122 -0
  354. package/src/shared/codex-inventory.ts +41 -0
  355. package/src/shared/daemon-provider-login.ts +31 -0
  356. package/src/shared/daemon-provider-snapshot.ts +52 -0
  357. package/src/shared/external-schedule-contract.ts +60 -0
  358. package/src/shared/node-name.test.ts +62 -0
  359. package/src/shared/node-name.ts +161 -0
  360. package/src/shared/probe-host-allowlist-drift.test.ts +45 -0
  361. package/src/shared/provider-application.ts +29 -0
  362. package/src/shared/provider-collection.ts +14 -0
  363. package/src/shared/provider-initialization.ts +8 -0
  364. package/src/shared/reserved-env-drift.test.ts +10 -0
  365. package/src/shared/scoped-secret-contract.ts +5 -0
  366. package/src/shared/task-content-limit-drift.test.ts +28 -0
  367. package/src/shared/task-content-limit.ts +25 -0
  368. package/src/side-thread-command-transport.test.ts +312 -0
  369. package/src/side-thread-command-transport.ts +318 -0
  370. package/src/side-thread-http-integration.test.ts +233 -0
  371. package/src/side-thread-http.ts +504 -0
  372. package/src/side-thread-production.test.ts +72 -0
  373. package/src/side-thread-production.ts +118 -0
  374. package/src/side-thread.test.ts +1067 -0
  375. package/src/side-thread.ts +2499 -0
  376. package/src/skillhub-http.test.ts +144 -0
  377. package/src/sqlite-close-checkpoint.test.ts +78 -0
  378. package/src/start-node.test.ts +265 -0
  379. package/src/start-request-error-domain.test.ts +182 -0
  380. package/src/start-skill-error-domain.test.ts +122 -0
  381. package/src/stats-versions-http.test.ts +65 -0
  382. package/src/status-alias-filter-http.test.ts +106 -0
  383. package/src/status-alias-resolver-http.test.ts +163 -0
  384. package/src/status-alias-resolver.ts +19 -0
  385. package/src/status-node-id-filter-http.test.ts +161 -0
  386. package/src/status-read-cache-http.test.ts +229 -0
  387. package/src/status-read-cache.ts +129 -0
  388. package/src/stop-delete-node.test.ts +567 -1
  389. package/src/task-access-http.test.ts +407 -0
  390. package/src/task-access.ts +420 -0
  391. package/src/task-activity.ts +60 -0
  392. package/src/task-auth-origin-http.test.ts +93 -0
  393. package/src/task-auth-origin.test.ts +24 -0
  394. package/src/task-auth-origin.ts +7 -0
  395. package/src/task-consumption.test.ts +508 -0
  396. package/src/task-diagnostic-http.test.ts +149 -0
  397. package/src/task-diagnostic.test.ts +115 -0
  398. package/src/task-diagnostic.ts +118 -0
  399. package/src/task-expiry-notice-http.test.ts +298 -0
  400. package/src/task-expiry-notice.ts +318 -0
  401. package/src/task-idempotency-mcp.test.ts +148 -0
  402. package/src/task-idempotency.test.ts +76 -0
  403. package/src/task-idempotency.ts +81 -0
  404. package/src/task-late-replies.ts +54 -0
  405. package/src/task-late-reply-http.test.ts +227 -0
  406. package/src/task-lifecycle-watcher-busy.test.ts +114 -0
  407. package/src/task-lifecycle-watcher.test.ts +209 -0
  408. package/src/task-lifecycle-watcher.ts +109 -0
  409. package/src/task-network-resolution-http.test.ts +140 -0
  410. package/src/task-not-found-error-domain.test.ts +114 -0
  411. package/src/task-offline-delivery-2668.test.ts +119 -0
  412. package/src/task-offline-delivery.ts +81 -0
  413. package/src/task-orphan-http.test.ts +287 -0
  414. package/src/task-orphan.ts +119 -0
  415. package/src/task-queue-ahead-http.test.ts +309 -0
  416. package/src/task-queue-ahead-scale.test.ts +236 -0
  417. package/src/task-queue-ahead.ts +186 -0
  418. package/src/task-rejection-log-http.test.ts +160 -0
  419. package/src/task-rejection-log.ts +61 -0
  420. package/src/task-sender-http.test.ts +143 -0
  421. package/src/task-stale-open-http.test.ts +292 -0
  422. package/src/task-stale-open.ts +103 -0
  423. package/src/tasks-pagination-http.test.ts +141 -0
  424. package/src/team-rules-status-http.test.ts +90 -0
  425. package/src/team-rules-status.test.ts +59 -0
  426. package/src/team-rules-status.ts +72 -0
  427. package/src/tmux-allowlist.test.ts +48 -0
  428. package/src/tool-audience-http.test.ts +248 -0
  429. package/src/tool-audience.ts +127 -0
  430. package/src/tools-list-json-schema.test.ts +94 -0
  431. package/src/tools.ts +4314 -392
  432. package/src/update-node-config-error-domain.test.ts +107 -0
  433. package/src/uploads-http.test.ts +6 -4
  434. package/src/uploads.ts +23 -4
  435. package/src/user-avatar-http.test.ts +74 -0
  436. package/src/user-avatar-image.ts +160 -0
  437. package/src/user-avatar-migration.test.ts +25 -0
  438. package/src/user-avatar-upload-http.test.ts +353 -0
  439. package/src/user-inbox-by-agent-http.test.ts +189 -0
  440. package/src/user-inbox-netid-notnull.test.ts +122 -0
  441. package/src/user-inbox-read-http.test.ts +223 -0
  442. package/src/user-inbox-schema.test.ts +54 -0
  443. package/src/version-stats.test.ts +66 -0
  444. package/src/version-stats.ts +109 -0
@@ -0,0 +1,126 @@
1
+ // #3146 —— 「上一次切模型的结局」必须能被读到,而不是只能靠 revision 没涨推断成超时。
2
+ //
3
+ // 生产证据(2026-11-01,通信欧 n_28e6b2c2):库里两行
4
+ // status='rejected' error='OpenCode V2 session is not running; model was not changed'
5
+ // 而界面写的是「已下发 xai/grok-4.7,但 90s 内节点没有以新模型回来,请去看日志」。
6
+ // 答案在库里,读者拿不到 —— 这个文件钉住「拿得到」与「拿到的形状对」。
7
+ import { describe, expect, test } from "bun:test";
8
+ import { readFileSync } from "node:fs";
9
+ import { join } from "node:path";
10
+ import {
11
+ CONFIG_UPDATE_STATUSES,
12
+ projectLastConfigUpdate,
13
+ readLastConfigUpdate,
14
+ } from "./node-config-last-update.js";
15
+
16
+ const row = (over: Partial<Parameters<typeof projectLastConfigUpdate>[0]> = {}) => ({
17
+ update_id: "cu_1",
18
+ status: "rejected",
19
+ patch_json: JSON.stringify({ model: "xai/grok-4.7", flags: {} }),
20
+ error: "OpenCode V2 session is not running; model was not changed",
21
+ created_at: "1793519656437",
22
+ acked_at: "1793519656466",
23
+ ...over,
24
+ });
25
+
26
+ describe("#3146 上一次配置下发的投影", () => {
27
+ test("rejected ⇒ 原因原样带出(不是变成 timeout)", () => {
28
+ const v = projectLastConfigUpdate(row());
29
+ expect(v.status).toBe("rejected");
30
+ expect(v.error).toBe("OpenCode V2 session is not running; model was not changed");
31
+ expect(v.requested_model).toBe("xai/grok-4.7");
32
+ expect(v.terminal).toBe(true);
33
+ });
34
+
35
+ test("时间列是 TEXT 存的 ms epoch ⇒ 转成 ISO;转不出就 null(不出现 Invalid Date)", () => {
36
+ const v = projectLastConfigUpdate(row());
37
+ expect(v.created_at).toBe(new Date(1793519656437).toISOString());
38
+ expect(v.acked_at).toBe(new Date(1793519656466).toISOString());
39
+ for (const bad of ["", "not-a-number", "0", "-5", null]) {
40
+ expect(projectLastConfigUpdate(row({ created_at: bad as any })).created_at).toBeNull();
41
+ }
42
+ expect(JSON.stringify(projectLastConfigUpdate(row({ acked_at: "x" as any })))).not.toContain("Invalid Date");
43
+ });
44
+
45
+ test("闭集外的 status ⇒ unknown + 原值带出,且**不**当成终点(不折叠成最乐观那一档)", () => {
46
+ const v = projectLastConfigUpdate(row({ status: "cancelled" }));
47
+ expect(v.status).toBe("unknown");
48
+ expect(v.observed_status).toBe("cancelled");
49
+ expect(v.terminal).toBe(false);
50
+ });
51
+
52
+ test("闭集内的每一档都有明确的 terminal 取值(枚举与映射不许脱节)", () => {
53
+ const terminal = Object.fromEntries(
54
+ CONFIG_UPDATE_STATUSES.map((s) => [s, projectLastConfigUpdate(row({ status: s })).terminal]),
55
+ );
56
+ expect(terminal).toEqual({ pending: false, restarting: false, applied: true, rejected: true, timeout: true });
57
+ });
58
+
59
+ test("applied ⇒ error 为 null(成功时不许带一条陈旧原因)", () => {
60
+ const v = projectLastConfigUpdate(row({ status: "applied", error: null }));
61
+ expect(v.status).toBe("applied");
62
+ expect(v.error).toBeNull();
63
+ });
64
+
65
+ test("patch_json 没有 model 或不是 JSON ⇒ requested_model 为 null(不猜)", () => {
66
+ expect(projectLastConfigUpdate(row({ patch_json: "{}" })).requested_model).toBeNull();
67
+ expect(projectLastConfigUpdate(row({ patch_json: "{oops" })).requested_model).toBeNull();
68
+ expect(projectLastConfigUpdate(row({ patch_json: null })).requested_model).toBeNull();
69
+ });
70
+
71
+ test("不投影 created_by_token(凭据标识不是界面信息)", () => {
72
+ const v: any = projectLastConfigUpdate(row() as any);
73
+ expect(Object.keys(v).sort()).toEqual([
74
+ "acked_at", "created_at", "error", "observed_status", "requested_model", "status", "terminal", "update_id",
75
+ ]);
76
+ expect(JSON.stringify(v)).not.toContain("created_by_token");
77
+ });
78
+
79
+ test("readLastConfigUpdate:从未下发 ⇒ null;多行取最新(created_at 降序)", () => {
80
+ const rows: Record<string, any> = {
81
+ cu_old: row({ update_id: "cu_old", status: "applied", created_at: "1000", error: null }),
82
+ cu_new: row({ update_id: "cu_new", status: "rejected", created_at: "2000" }),
83
+ };
84
+ let seenSql = "";
85
+ const get = (sql: string, _nodeId: string) => {
86
+ seenSql = sql;
87
+ return rows.cu_new;
88
+ };
89
+ expect(readLastConfigUpdate(get, "n_x")?.update_id).toBe("cu_new");
90
+ expect(seenSql).toContain("ORDER BY created_at DESC");
91
+ expect(readLastConfigUpdate(() => null, "n_x")).toBeNull();
92
+ });
93
+
94
+ test("镜像:读到的 rejected 里必须**同时**有 error 与 requested_model(缺一个就说不清失败在哪一层)", () => {
95
+ const v = projectLastConfigUpdate(row());
96
+ expect(v.error).not.toBeNull();
97
+ expect(v.requested_model).not.toBeNull();
98
+ });
99
+ });
100
+
101
+ // ── 接线:投影写对了,但如果 handler 没把它放进响应里,客户端仍然拿不到 ──
102
+ //
103
+ // 纯函数测试管不住这一层(`readLastConfigUpdate` 全绿而响应里没有 last_update 是完全可能的)。
104
+ // 判据用**守卫位置**:这一格必须出现在 「GET /api/nodes/:id/config」那段 handler 的响应对象里,
105
+ // 而不是文件里任何一处。判据域只到「文本级 + 一次变量解析」,不假装运行期全覆盖。
106
+ const serverSrc = readFileSync(join(import.meta.dir, "server.ts"), "utf8");
107
+
108
+ function configGetHandler(): string {
109
+ const start = serverSrc.indexOf("const nodeConfigMatch = url.pathname.match(");
110
+ expect(start).toBeGreaterThan(-1);
111
+ const end = serverSrc.indexOf("// ── #462", start);
112
+ expect(end).toBeGreaterThan(start);
113
+ return serverSrc.slice(start, end);
114
+ }
115
+
116
+ describe("#3146 GET /api/nodes/:id/config 的接线", () => {
117
+ test("响应对象里有 last_update(读的是 node_config_updates 的最近一行)", () => {
118
+ const block = configGetHandler();
119
+ expect(block).toContain("readLastConfigUpdate(");
120
+ expect(block).toContain("last_update: lastUpdate");
121
+ });
122
+
123
+ test("镜像否定:不投影 created_by_token(凭据标识不进响应)", () => {
124
+ expect(configGetHandler()).not.toContain("created_by_token");
125
+ });
126
+ });
@@ -0,0 +1,107 @@
1
+ // #3146 —— 客户端「切模型」失败时,Hub 明明已经知道原因,界面上却只显示「90s 内没回来,
2
+ // 请到机器上看日志」。
3
+ //
4
+ // 原因不是客户端乱写:`GET /api/nodes/:id/config` 原来只回 config_revision / model / flags /
5
+ // config_update_capable —— 没有一处能读到**上一次下发的结局**。于是客户端只能靠
6
+ // 「revision 有没有涨」推断,涨不了就只能是 timeout。而生产上(2026-11-01 通信欧)
7
+ // 真实结局是 rejected,Hub 库里写着:
8
+ //
9
+ // status = 'rejected'
10
+ // error = 'OpenCode V2 session is not running; model was not changed'
11
+ // acked_at 也写了
12
+ //
13
+ // —— 一条「答案已经在库里、但读者拿不到」的缺口。
14
+ //
15
+ // 这个模块只做**投影**:把 node_config_updates 最近一行翻译成客户端能直接渲染的形状。
16
+ // 三条规矩:
17
+ // ① 状态是闭集。不在表里的值报 unknown 并把原值带出去(不折叠成最乐观的那一档)。
18
+ // ② 时间列是 **TEXT 存 ms epoch**,不是 hub 那种无时区标记的字符串;解析不出就 null,
19
+ // 不允许出现 "Invalid Date"。
20
+ // ③ 不投影 `created_by_token`:那是凭据标识,不是界面信息。
21
+
22
+ export const CONFIG_UPDATE_STATUSES = ["pending", "restarting", "applied", "rejected", "timeout"] as const;
23
+ export type ConfigUpdateStatus = (typeof CONFIG_UPDATE_STATUSES)[number];
24
+
25
+ /** 闭集显式映射。pending/restarting 是「还在路上」,其余三个是终点。 */
26
+ const TERMINAL: Record<ConfigUpdateStatus, boolean> = {
27
+ pending: false,
28
+ restarting: false,
29
+ applied: true,
30
+ rejected: true,
31
+ timeout: true,
32
+ };
33
+
34
+ export interface LastConfigUpdate {
35
+ update_id: string;
36
+ /** 闭集内就是它自己;闭集外是 `unknown`(并把原值放在 observed_status)。 */
37
+ status: ConfigUpdateStatus | "unknown";
38
+ /** 原始 status 字符串(永远给,便于排查;闭集内与 status 相同)。 */
39
+ observed_status: string;
40
+ /** 已知是终点才 true;unknown 一律 false —— 「不知道结没结束」不等于「结束了」。 */
41
+ terminal: boolean;
42
+ /** 这次下发要的模型(来自 patch_json.model);patch 里没有就是 null。 */
43
+ requested_model: string | null;
44
+ /** 节点自报的失败原因(rejected/timeout 才有;applied 是 null)。 */
45
+ error: string | null;
46
+ /** ISO;TEXT 存的是 ms epoch,转不出来就是 null。 */
47
+ created_at: string | null;
48
+ acked_at: string | null;
49
+ }
50
+
51
+ type Row = {
52
+ update_id: string;
53
+ status: string;
54
+ patch_json: string | null;
55
+ error: string | null;
56
+ created_at: string | number | null;
57
+ acked_at: string | number | null;
58
+ };
59
+
60
+ /** ms epoch(TEXT 或数字)→ ISO。非有限数、非正数一律 null。 */
61
+ function msToIso(value: string | number | null | undefined): string | null {
62
+ if (value === null || value === undefined) return null;
63
+ const ms = typeof value === "number" ? value : Number(value);
64
+ if (!Number.isFinite(ms) || ms <= 0) return null;
65
+ return new Date(ms).toISOString();
66
+ }
67
+
68
+ /** patch_json 里的 model。解析失败或没有 model ⇒ null(不猜)。 */
69
+ function requestedModel(patchJson: string | null): string | null {
70
+ if (!patchJson) return null;
71
+ try {
72
+ const parsed = JSON.parse(patchJson) as { model?: unknown };
73
+ return typeof parsed?.model === "string" && parsed.model ? parsed.model : null;
74
+ } catch {
75
+ return null;
76
+ }
77
+ }
78
+
79
+ /** 纯函数:一行 → 对外形状。抽出来是为了能单独钉住「闭集外不折叠」那条。 */
80
+ export function projectLastConfigUpdate(row: Row): LastConfigUpdate {
81
+ const observed = typeof row.status === "string" ? row.status : "";
82
+ const known = (CONFIG_UPDATE_STATUSES as readonly string[]).includes(observed);
83
+ return {
84
+ update_id: row.update_id,
85
+ status: known ? (observed as ConfigUpdateStatus) : "unknown",
86
+ observed_status: observed,
87
+ terminal: known ? TERMINAL[observed as ConfigUpdateStatus] : false,
88
+ requested_model: requestedModel(row.patch_json),
89
+ error: typeof row.error === "string" && row.error ? row.error : null,
90
+ created_at: msToIso(row.created_at),
91
+ acked_at: msToIso(row.acked_at),
92
+ };
93
+ }
94
+
95
+ export const LAST_CONFIG_UPDATE_SQL =
96
+ `SELECT update_id, status, patch_json, error, created_at, acked_at
97
+ FROM node_config_updates WHERE node_id = ?1
98
+ ORDER BY created_at DESC, rowid DESC LIMIT 1`;
99
+
100
+ /** 读这个节点最近一次配置下发。从未下发过 ⇒ null(不是空对象:两者在界面上不同)。 */
101
+ export function readLastConfigUpdate(
102
+ get: (sql: string, ...params: any[]) => Row | null,
103
+ nodeId: string,
104
+ ): LastConfigUpdate | null {
105
+ const row = get(LAST_CONFIG_UPDATE_SQL, nodeId);
106
+ return row ? projectLastConfigUpdate(row) : null;
107
+ }
@@ -0,0 +1,105 @@
1
+ // 桌面向导要看得到 daemon 回的失败原因:GET /api/node-create-requests?request_id=…
2
+ // 承重:① 只在调用者的网络作用域里能读到(别的网络 → 404,与不存在同形);② 无用户上下文 401;③ 缺参 400;
3
+ // ④ 回的是 daemon ack 写进去的 status/error 原文。
4
+ import { afterAll, beforeAll, describe, expect, test } from "bun:test";
5
+ import { mkdtempSync, rmSync } from "node:fs";
6
+ import { tmpdir } from "node:os";
7
+ import { join } from "node:path";
8
+
9
+ const PRIVATE_DB_DIR = mkdtempSync(join(tmpdir(), "anet-create-request-status-"));
10
+ process.env.COMMHUB_DB ||= join(PRIVATE_DB_DIR, "hub.db");
11
+
12
+ let server: ReturnType<typeof Bun.serve>;
13
+ let base = "";
14
+ let aToken = "", bToken = "", aNet = "", bNet = "";
15
+ const MASTER_TOKEN = "legacy-master-token-for-test";
16
+
17
+ const get = async (path: string, token: string) => {
18
+ const r = await fetch(`${base}${path}`, { headers: { Authorization: `Bearer ${token}` } });
19
+ return { status: r.status, body: await r.json() as any };
20
+ };
21
+
22
+ beforeAll(async () => {
23
+ process.env.COMMHUB_AUTH_TOKEN ||= MASTER_TOKEN;
24
+ const { db } = await import("./db.js");
25
+ const { register } = await import("./auth.js");
26
+ const stamp = Date.now();
27
+ const admin = register(`cr_admin_${stamp}`, "CrAdmin-Strong-1!");
28
+ expect(admin.ok).toBe(true);
29
+ const a = register(`cr_a_${stamp}`, "CrA-Strong-1!");
30
+ const b = register(`cr_b_${stamp}`, "CrB-Strong-1!");
31
+ expect(a.ok && b.ok).toBe(true);
32
+ aToken = a.token!; bToken = b.token!; aNet = a.network_id!; bNet = b.network_id!;
33
+ const uid = (name: string) => db.get<{ user_id: string }>("SELECT user_id FROM users WHERE username = ?1", name)!.user_id;
34
+ for (const id of [uid(`cr_a_${stamp}`), uid(`cr_b_${stamp}`)]) {
35
+ expect(db.get<{ role: string }>("SELECT role FROM users WHERE user_id = ?1", id)?.role).toBe("user");
36
+ }
37
+ db.run(
38
+ `INSERT INTO node_create_requests
39
+ (request_id, daemon_node_id, child_name, network_id, runtime, model, flags_json, env_keys, status, child_token_id, created_at, created_by_token, acked_at, error)
40
+ VALUES ('cr_a_failed', 'node_daemon_a', 'vansin-go', ?1, 'opencode-cli', NULL, '{}', '[]', 'failed', NULL, ?2, 'tok', ?2,
41
+ 'opencode-cli package entrypoint verification currently requires Linux')`,
42
+ [aNet, Date.now()],
43
+ );
44
+ db.run(
45
+ `INSERT INTO node_create_requests
46
+ (request_id, daemon_node_id, child_name, network_id, runtime, model, flags_json, env_keys, status, child_token_id, created_at, created_by_token)
47
+ VALUES ('cr_b_pending', 'node_daemon_b', 'other', ?1, 'codex-app-server', NULL, '{}', '[]', 'pending', NULL, ?2, 'tok')`,
48
+ [bNet, Date.now()],
49
+ );
50
+ const mod = await import("./server.js");
51
+ server = mod.bootServer({ port: 0, hostname: "127.0.0.1" });
52
+ base = `http://127.0.0.1:${server.port}`;
53
+ });
54
+
55
+ afterAll(() => {
56
+ try { server?.stop(true); } catch {}
57
+ try { rmSync(PRIVATE_DB_DIR, { recursive: true, force: true }); } catch {}
58
+ });
59
+
60
+ describe("GET /api/node-create-requests?request_id=", () => {
61
+ test("A reads her own failed request with the daemon's error verbatim", async () => {
62
+ const { status, body } = await get("/api/node-create-requests?request_id=cr_a_failed", aToken);
63
+ expect(status).toBe(200);
64
+ expect(body.ok).toBe(true);
65
+ expect(body.request).toMatchObject({
66
+ request_id: "cr_a_failed", child_name: "vansin-go", runtime: "opencode-cli", status: "failed",
67
+ error: "opencode-cli package entrypoint verification currently requires Linux",
68
+ });
69
+ });
70
+ test("🔴 B cannot read A's request — 404, same shape as nonexistent", async () => {
71
+ const other = await get("/api/node-create-requests?request_id=cr_a_failed", bToken);
72
+ const missing = await get("/api/node-create-requests?request_id=cr_nope", bToken);
73
+ expect(other.status).toBe(404);
74
+ expect(missing.status).toBe(404);
75
+ expect(other.body).toEqual(missing.body);
76
+ });
77
+ test("pending request reads as pending with no error", async () => {
78
+ const { body } = await get("/api/node-create-requests?request_id=cr_b_pending", bToken);
79
+ expect(body.request.status).toBe("pending");
80
+ expect(body.request.error).toBeNull();
81
+ expect(body.request.child_node_id).toBeNull();
82
+ expect(body.request.launch_verified_at).toBeNull();
83
+ });
84
+ test("registration timestamp is not launch proof; explicit proof and identity round-trip", async () => {
85
+ const { db } = await import('./db.js');
86
+ db.run(`UPDATE node_create_requests SET status='succeeded', child_node_id='node_verified', acked_at=1234 WHERE request_id='cr_b_pending'`);
87
+ const registered = await get('/api/node-create-requests?request_id=cr_b_pending', bToken);
88
+ expect(registered.body.request.acked_at).toBe(1234);
89
+ expect(registered.body.request.launch_verified_at).toBeNull();
90
+ db.run(`UPDATE node_create_requests SET launch_verified_at=5678 WHERE request_id='cr_b_pending'`);
91
+ const verified = await get('/api/node-create-requests?request_id=cr_b_pending', bToken);
92
+ expect(verified.body.request).toMatchObject({ child_node_id: 'node_verified', launch_verified_at: 5678 });
93
+ expect((await get('/api/node-create-requests?request_id=cr_b_pending', aToken)).status).toBe(404);
94
+ });
95
+ test("missing request_id → 400", async () => {
96
+ const { status, body } = await get("/api/node-create-requests", aToken);
97
+ expect(status).toBe(400);
98
+ expect(body.error).toBe("request_id_required");
99
+ });
100
+ test("legacy master token (no user context) → 401", async () => {
101
+ const { status, body } = await get("/api/node-create-requests?request_id=cr_a_failed", MASTER_TOKEN);
102
+ expect(status).toBe(401);
103
+ expect(body.error).toBe("auth_required");
104
+ });
105
+ });
@@ -0,0 +1,142 @@
1
+ import { beforeEach, afterAll, expect, test } from "bun:test";
2
+ import { McpServer } from "@modelcontextprotocol/sdk/server/mcp.js";
3
+ import { db } from "./db.js";
4
+ import { registerTools } from "./tools.js";
5
+ import { buildControllableMap } from "./node-lifecycle-controllable.js";
6
+
7
+ const NET = "net_adoption_test", USER = "u_adoption_test", CHILD = "n_adoption_child", DAEMON = "node_adoption_daemon";
8
+ function cleanup() {
9
+ for (const table of ["node_daemon_bindings", "node_stop_requests", "node_start_requests", "node_create_requests", "audit_log", "sessions", "nodes", "api_tokens", "network_members", "networks"])
10
+ db.run(`DELETE FROM ${table} WHERE network_id=?1`, [NET]);
11
+ db.run("DELETE FROM users WHERE user_id=?1", [USER]);
12
+ }
13
+ beforeEach(() => {
14
+ cleanup();
15
+ db.run("INSERT INTO users(user_id,username,password_hash,role) VALUES(?1,?1,'x','user')", [USER]);
16
+ db.run("INSERT INTO networks(network_id,network_name,owner_id) VALUES(?1,?1,?2)", [NET, USER]);
17
+ db.run("INSERT INTO network_members(user_id,network_id,role) VALUES(?1,?2,'owner')", [USER, NET]);
18
+ for (const [id, alias, snap] of [[DAEMON, "adoption-daemon", { role: "host_supervisor", daemon_capabilities: { adopt_capable: true } }], [CHILD, "adoption-child", {}]] as const) {
19
+ db.run(`INSERT INTO nodes(node_id,node_name,alias,network_id,owner_user_id,hostname,config_snapshot,lifecycle_state) VALUES(?1,?2,?2,?3,?4,'test-host',?5,'active')`, [id, alias, NET, USER, JSON.stringify(snap)]);
20
+ }
21
+ db.run("INSERT INTO sessions(resume_id,session_id,alias,network_id,status,last_seen_at) VALUES('adoption-session','adoption-session','adoption-daemon',?1,'idle',datetime('now'))", [NET]);
22
+ db.run("INSERT INTO api_tokens(token_id,user_id,network_id,scope,name,token_hash) VALUES('adoption-token',?1,?2,'network','node:adoption-daemon','adoption-hash')", [USER, NET]);
23
+ });
24
+ afterAll(cleanup);
25
+ function handlers(kind: "user" | "daemon" | "stranger" = "user") {
26
+ const server = new McpServer({ name: "adoption-test", version: "0" }) as any;
27
+ const out: any = {}, original = server.tool.bind(server);
28
+ server.tool = (name: string, desc: string, schema: any, handler: any) => { out[name] = handler; return original(name, desc, schema, handler); };
29
+ registerTools(server, undefined, kind === "daemon" ? NET : null, kind === "user" ? USER : null, null, kind === "daemon", kind === "daemon" ? "adoption-token" : null);
30
+ return out;
31
+ }
32
+ const call = async (handler: any, args: any = {}) => JSON.parse((await handler(args)).content[0].text);
33
+ const request = () => call(handlers().request_adopt_node, { node_id: CHILD, daemon_node_id: DAEMON, workdir: "/workspace/project" });
34
+ async function adopt() {
35
+ const r = await request(); expect(r.ok).toBe(true);
36
+ expect(await call(handlers("daemon").ack_adopt_request, { request_id: r.request_id, status: "adopted" })).toMatchObject({ ok: true, status: "active" });
37
+ return r.request_id;
38
+ }
39
+
40
+ test("unbound node_ cannot use an explicitly supplied daemon (witnessed red on main)", async () => {
41
+ db.run("UPDATE nodes SET node_id='node_unbound_child' WHERE node_id=?1", [CHILD]);
42
+ expect(await call(handlers().stop_node, { child_node_id: "node_unbound_child", daemon_node_id: DAEMON, network_id: NET })).toMatchObject({ ok: false, error: "daemon_not_resolvable" });
43
+ expect(db.all("SELECT * FROM node_stop_requests WHERE network_id=?1", NET)).toHaveLength(0);
44
+ });
45
+ test("two-phase binding, daemon-bound pull, controllable map, adopted delete refused", async () => {
46
+ const r = await request(); expect(r.ok).toBe(true);
47
+ expect(await call(handlers().stop_node, { child_node_id: CHILD, daemon_node_id: DAEMON, network_id: NET })).toMatchObject({ ok: false });
48
+ expect(await call(handlers("daemon").get_adopt_request, { request_id: r.request_id })).toMatchObject({ ok: true, node_id: CHILD, alias: "adoption-child", workdir: "/workspace/project" });
49
+ expect(await call(handlers().get_adopt_request, { request_id: r.request_id })).toMatchObject({ ok: false });
50
+ expect(await call(handlers("daemon").ack_adopt_request, { request_id: r.request_id, status: "adopted" })).toMatchObject({ ok: true });
51
+ expect((await call(handlers("daemon").list_my_children)).children).toContainEqual({ child_node_id: CHILD, alias: "adoption-child", lifecycle_state: "active", managed: "adopted", binding_request_id: r.request_id });
52
+ expect(buildControllableMap([], [{ node_id: CHILD, daemon_node_id: DAEMON }]).get(CHILD)).toBe(DAEMON);
53
+ expect(await call(handlers().delete_node, { child_node_id: CHILD, confirm_alias: "adoption-child", network_id: NET })).toMatchObject({ ok: false, error: "adopted_node_delete_unsupported" });
54
+ expect(db.get<any>("SELECT lifecycle_state FROM nodes WHERE node_id=?1", CHILD).lifecycle_state).toBe("active");
55
+ });
56
+ test("adopted stop/start complete through existing protocol; revocation removes authority", async () => {
57
+ await adopt(); const u = handlers(), d = handlers("daemon");
58
+ const stop = await call(u.stop_node, { child_node_id: CHILD, network_id: NET }); expect(stop.ok).toBe(true);
59
+ expect((await call(d.get_stop_request, { request_id: stop.request_id })).ok).toBe(true);
60
+ expect((await call(d.ack_stop_request, { request_id: stop.request_id, status: "stopped" })).ok).toBe(true);
61
+ expect((await call(d.list_my_children)).children[0].lifecycle_state).toBe("stopped");
62
+ const start = await call(u.start_node, { child_node_id: CHILD, network_id: NET }); expect(start.ok).toBe(true);
63
+ expect((await call(d.get_start_request, { request_id: start.request_id })).ok).toBe(true);
64
+ // #3309 分支 —— ack_start_request 的**成功出口**(此前只钉了它的三条失败分支:
65
+ // request_not_found / not_your_request / cross_network_request)。
66
+ // 先接住再断言,形状由这次真实调用给出。
67
+ const startedAck = await call(d.ack_start_request, { request_id: start.request_id, status: "started", child_pid: 4321 });
68
+ expect(startedAck.ok).toBe(true);
69
+ expect(Object.keys(startedAck).sort()).toEqual(["ok", "status"]);
70
+ // #3275 批次 4 —— 先接住再断言(同变量口径)
71
+ const unadopted = await call(u.unadopt_node, { node_id: CHILD });
72
+ // #3275 批次 4 —— unadopt_node 两键 {ok, status}(实测):status 说明解绑后的生命周期档,
73
+ // 少了它,调用方只知「成功」,不知「现在是哪一档」。
74
+ expect(Object.keys(unadopted).sort()).toEqual(["ok", "status"]);
75
+ expect(unadopted.ok).toBe(true);
76
+ expect((await call(d.list_my_children)).children).toHaveLength(0);
77
+ expect((await call(u.stop_node, { child_node_id: CHILD, daemon_node_id: DAEMON, network_id: NET })).ok).toBe(false);
78
+ });
79
+ test("pending cancellation cannot be resurrected; duplicate pending refuses", async () => {
80
+ const r = await request(); expect(r.ok).toBe(true);
81
+ expect((await request()).error).toBe("node_already_managed");
82
+ expect((await call(handlers().unadopt_node, { node_id: CHILD })).ok).toBe(true);
83
+ expect((await call(handlers("daemon").ack_adopt_request, { request_id: r.request_id, status: "adopted" })).error).toBe("request_not_pending");
84
+ });
85
+ test("human-only and owner/admin fail closed; admin exception audited", async () => {
86
+ const args = { node_id: CHILD, daemon_node_id: DAEMON, workdir: "/workspace/project" };
87
+ expect((await call(handlers("daemon").request_adopt_node, args)).ok).toBe(false);
88
+ expect((await call(handlers("stranger").request_adopt_node, args)).ok).toBe(false);
89
+ db.run("UPDATE network_members SET role='member' WHERE network_id=?1", [NET]);
90
+ db.run("UPDATE nodes SET owner_user_id=NULL WHERE node_id=?1", [CHILD]);
91
+ expect((await request()).error).toBe("adopt_forbidden");
92
+ db.run("UPDATE network_members SET role='owner' WHERE network_id=?1", [NET]);
93
+ expect((await request()).ok).toBe(true);
94
+ expect(db.get("SELECT action FROM audit_log WHERE action='adopt_by_admin' AND network_id=?1", NET)).not.toBeNull();
95
+ });
96
+ test("viewer owner cannot request; membership loss before ack cannot activate", async () => {
97
+ db.run("UPDATE network_members SET role='viewer' WHERE network_id=?1", [NET]);
98
+ expect((await request()).error).toBe("adopt_forbidden");
99
+ db.run("UPDATE network_members SET role='owner' WHERE network_id=?1", [NET]);
100
+ const r = await request(); expect(r.ok).toBe(true);
101
+ db.run("DELETE FROM network_members WHERE network_id=?1", [NET]);
102
+ expect((await call(handlers("daemon").ack_adopt_request, { request_id: r.request_id, status: "adopted" })).error).toBe("adopt_forbidden");
103
+ });
104
+ test("wrong daemon cannot pull/ack; refusal releases reservation; in-flight unadopt is refused", async () => {
105
+ const r = await request(); expect(r.ok).toBe(true);
106
+ db.run("UPDATE node_daemon_bindings SET daemon_node_id='other-daemon' WHERE request_id=?1", [r.request_id]);
107
+ const d = handlers("daemon");
108
+ expect((await call(d.get_adopt_request, { request_id: r.request_id })).error).toBe("request_not_found");
109
+ expect((await call(d.ack_adopt_request, { request_id: r.request_id, status: "adopted" })).error).toBe("request_not_found");
110
+ db.run("UPDATE node_daemon_bindings SET daemon_node_id=?1 WHERE request_id=?2", [DAEMON, r.request_id]);
111
+ expect((await call(d.ack_adopt_request, { request_id: r.request_id, status: "refused", error: "adopt_roots_not_configured" })).status).toBe("refused");
112
+ await adopt();
113
+ expect((await call(handlers().stop_node, { child_node_id: CHILD, network_id: NET })).ok).toBe(true);
114
+ expect((await call(handlers().unadopt_node, { node_id: CHILD })).error).toBe("node_lifecycle_in_flight");
115
+ });
116
+ test("old daemon, hostname mismatch, stale heartbeat and cross-network daemon rejected", async () => {
117
+ db.run("UPDATE nodes SET config_snapshot='null' WHERE node_id=?1", [DAEMON]);
118
+ expect((await request()).error).toBe("daemon_not_adopt_capable");
119
+ db.run("UPDATE nodes SET config_snapshot='{}' WHERE node_id=?1", [DAEMON]);
120
+ expect((await request()).error).toBe("daemon_not_adopt_capable");
121
+ db.run("UPDATE nodes SET config_snapshot=?1,hostname='different' WHERE node_id=?2", [JSON.stringify({ role: "host_supervisor", daemon_capabilities: { adopt_capable: true } }), DAEMON]);
122
+ expect((await request()).error).toBe("hostname_mismatch");
123
+ db.run("UPDATE nodes SET hostname='test-host' WHERE node_id=?1", [DAEMON]);
124
+ db.run("UPDATE sessions SET last_seen_at='2000-01-01 00:00:00' WHERE network_id=?1", [NET]);
125
+ expect((await request()).error).toBe("daemon_offline");
126
+ expect((await call(handlers().request_adopt_node, { node_id: CHILD, daemon_node_id: "other_network_daemon", workdir: "/workspace/project" })).error).toBe("daemon_not_found");
127
+ });
128
+ test("network boundaries apply to both human request and daemon pull/ack", async () => {
129
+ const r = await request(); expect(r.ok).toBe(true);
130
+ db.run("UPDATE node_daemon_bindings SET network_id='net_other_adoption_test' WHERE request_id=?1", [r.request_id]);
131
+ try {
132
+ const d = handlers("daemon");
133
+ expect((await call(d.get_adopt_request, { request_id: r.request_id })).error).toBe("request_not_found");
134
+ expect((await call(d.ack_adopt_request, { request_id: r.request_id, status: "adopted" })).error).toBe("request_not_found");
135
+ } finally { db.run("UPDATE node_daemon_bindings SET network_id=?1 WHERE request_id=?2", [NET, r.request_id]); }
136
+ db.run("UPDATE nodes SET network_id='net_other_adoption_test' WHERE node_id=?1", [DAEMON]);
137
+ try { expect((await request()).error).toBe("daemon_not_found"); }
138
+ finally { db.run("UPDATE nodes SET network_id=?1 WHERE node_id=?2", [NET, DAEMON]); }
139
+ db.run("UPDATE nodes SET network_id='net_other_adoption_test' WHERE node_id=?1", [CHILD]);
140
+ try { expect((await request()).error).toBe("adopt_forbidden"); }
141
+ finally { db.run("UPDATE nodes SET network_id=?1 WHERE node_id=?2", [NET, CHILD]); }
142
+ });
@@ -0,0 +1,135 @@
1
+ import { db, uuidv4 } from "./db.js";
2
+ import { getUserNetworkRole } from "./auth.js";
3
+ import { pushEvent } from "./push.js";
4
+ import { canRestWriteNetwork } from "./network-scope.js";
5
+ import { parseDbTimestampMs } from "./db-timestamp.js";
6
+ import { activeNodeTokenIds } from "./node-token-identity.js";
7
+
8
+ type Node = { node_id: string; alias: string; network_id: string; owner_user_id: string | null; hostname: string | null; config_snapshot: string | null };
9
+ type Binding = { request_id: string; network_id: string; node_id: string; daemon_node_id: string; workdir: string; requested_by: string; status: string; error: string | null };
10
+ type Human = { userId?: string | null; networkId?: string | null; isNode: boolean; canWrite: (networkId: string) => boolean };
11
+ type Daemon = { ok: true; daemonNodeId: string; networkId: string } | { ok: false; error: string };
12
+ const fail = (error: string) => ({ ok: false as const, error });
13
+ const snapshot = (node: Node) => {
14
+ try { const value = JSON.parse(node.config_snapshot || "{}"); return value && typeof value === "object" && !Array.isArray(value) ? value : {}; }
15
+ catch { return {}; }
16
+ };
17
+
18
+ export function createdDaemon(nodeId: string): string | null {
19
+ if (!nodeId.startsWith("node_")) return null;
20
+ return db.get<{ daemon_node_id: string }>("SELECT daemon_node_id FROM node_create_requests WHERE request_id=?1", `cr_${nodeId.slice(5)}`)?.daemon_node_id ?? null;
21
+ }
22
+ export function activeBinding(nodeId: string): Binding | null {
23
+ return db.get<Binding>("SELECT * FROM node_daemon_bindings WHERE node_id=?1 AND status='active'", nodeId);
24
+ }
25
+ export function resolveManagedDaemon(nodeId: string): string | null {
26
+ return createdDaemon(nodeId) ?? activeBinding(nodeId)?.daemon_node_id ?? null;
27
+ }
28
+ function humanNode(ctx: Human, nodeId: string): Node | null {
29
+ if (ctx.isNode || !ctx.userId) return null;
30
+ const node = db.get<Node>("SELECT * FROM nodes WHERE node_id=?1", nodeId);
31
+ if (!node || (ctx.networkId && ctx.networkId !== node.network_id) || !ctx.canWrite(node.network_id)) return null;
32
+ const role = getUserNetworkRole(ctx.userId, node.network_id);
33
+ return node.owner_user_id === ctx.userId || role === "owner" || role === "admin" ? node : null;
34
+ }
35
+ function audit(binding: Binding, action: string, actor: string) {
36
+ db.run(`INSERT INTO audit_log(user_id,action,target_type,target_id,detail,network_id)
37
+ VALUES(?1,?2,'node_daemon_binding',?3,?4,?5)`,
38
+ [actor, action, binding.request_id, JSON.stringify({ node_id: binding.node_id, daemon_node_id: binding.daemon_node_id }), binding.network_id]);
39
+ }
40
+ function daemonReady(daemon: Node | null, node: Node): string | null {
41
+ if (!daemon || daemon.network_id !== node.network_id) return "daemon_not_found";
42
+ const snap = snapshot(daemon);
43
+ if (snap.role !== "host_supervisor" || snap.daemon_capabilities?.adopt_capable !== true) return "daemon_not_adopt_capable";
44
+ if (!node.hostname || daemon.hostname !== node.hostname) return "hostname_mismatch";
45
+ const session = db.get<{ last_seen_at: string }>(
46
+ `SELECT last_seen_at FROM sessions WHERE alias=?1 AND network_id=?2
47
+ AND (node_id=?3 OR (node_id IS NULL AND NOT EXISTS (
48
+ SELECT 1 FROM nodes n WHERE n.network_id=?2 AND n.alias=?1 AND n.node_id!=?3)))`,
49
+ daemon.alias, daemon.network_id, daemon.node_id,
50
+ );
51
+ const seen = parseDbTimestampMs(session?.last_seen_at ?? "");
52
+ if (!Number.isFinite(seen) || Date.now() - seen > 300_000) return "daemon_offline";
53
+ return activeNodeTokenIds(daemon.node_id, daemon.network_id).length ? null : "daemon_offline";
54
+ }
55
+
56
+ export function requestAdopt(ctx: Human, args: { node_id: string; daemon_node_id: string; workdir: string }) {
57
+ if (ctx.isNode || !ctx.userId) return fail("user_token_required");
58
+ if (db.transactionalFeaturesRefusal) return fail("atomic_transactions_required");
59
+ const node = humanNode(ctx, args.node_id);
60
+ if (!node) return fail("adopt_forbidden");
61
+ if (snapshot(node).role === "host_supervisor") return fail("cannot_adopt_daemon");
62
+ if (createdDaemon(node.node_id)) return fail("node_already_managed");
63
+ if (!args.workdir.trim() || /[\x00-\x1f]/.test(args.workdir)) return fail("invalid_workdir");
64
+ const daemon = db.get<Node>("SELECT * FROM nodes WHERE node_id=?1", args.daemon_node_id);
65
+ const refused = daemonReady(daemon, node);
66
+ if (refused) return fail(refused);
67
+ const now = Date.now();
68
+ const binding: Binding = { ...args, request_id: `adopt_${uuidv4()}`, network_id: node.network_id, requested_by: ctx.userId, status: "pending", error: null };
69
+ const inserted = db.transaction(() => {
70
+ const result = db.run(`INSERT INTO node_daemon_bindings(request_id,network_id,node_id,daemon_node_id,workdir,requested_by,status,created_at,updated_at)
71
+ VALUES(?1,?2,?3,?4,?5,?6,'pending',?7,?7) ON CONFLICT DO NOTHING`,
72
+ [binding.request_id, binding.network_id, node.node_id, args.daemon_node_id, args.workdir, ctx.userId, now]);
73
+ if (!result.changes) return false;
74
+ audit(binding, node.owner_user_id === ctx.userId ? "adopt_requested" : "adopt_by_admin", ctx.userId!);
75
+ return true;
76
+ });
77
+ if (!inserted) return fail("node_already_managed");
78
+ pushEvent(daemon!.alias, { type: "adopt_node", request_id: binding.request_id }, node.network_id);
79
+ return { ok: true, request_id: binding.request_id, status: "pending" };
80
+ }
81
+
82
+ function daemonBinding(caller: Daemon, requestId: string): Binding | null {
83
+ if (!caller.ok) return null;
84
+ return db.get<Binding>(`SELECT * FROM node_daemon_bindings WHERE request_id=?1 AND daemon_node_id=?2 AND network_id=?3`, requestId, caller.daemonNodeId, caller.networkId);
85
+ }
86
+ export function getAdopt(caller: Daemon, requestId: string) {
87
+ if (!caller.ok) return fail(caller.error);
88
+ const binding = daemonBinding(caller, requestId);
89
+ if (!binding) return fail("request_not_found");
90
+ if (binding.status !== "pending") return fail("request_not_pending");
91
+ const node = db.get<Node>("SELECT * FROM nodes WHERE node_id=?1 AND network_id=?2", binding.node_id, binding.network_id);
92
+ if (!node) return fail("node_not_found");
93
+ return { ok: true, ...binding, alias: node.alias };
94
+ }
95
+ export function ackAdopt(caller: Daemon, args: { request_id: string; status: "adopted" | "refused"; error?: string }) {
96
+ if (!caller.ok) return fail(caller.error);
97
+ if (db.transactionalFeaturesRefusal) return fail("atomic_transactions_required");
98
+ const binding = daemonBinding(caller, args.request_id);
99
+ if (!binding) return fail("request_not_found");
100
+ return db.transaction(() => {
101
+ // Ownership/membership can change while local verification is in flight.
102
+ if (args.status === "adopted") {
103
+ const requester: Human = { userId: binding.requested_by, networkId: binding.network_id, isNode: false,
104
+ canWrite: networkId => canRestWriteNetwork({ userId: binding.requested_by, networkId: null }, networkId, false) };
105
+ const node = humanNode(requester, binding.node_id);
106
+ if (!node || createdDaemon(binding.node_id)) return fail("adopt_forbidden");
107
+ const refusal = daemonReady(db.get<Node>("SELECT * FROM nodes WHERE node_id=?1", binding.daemon_node_id), node);
108
+ if (refusal) return fail(refusal);
109
+ }
110
+ const changed = db.run(`UPDATE node_daemon_bindings SET status=?1,error=?2,updated_at=?3 WHERE request_id=?4 AND status='pending'`,
111
+ [args.status === "adopted" ? "active" : "refused", args.error ?? null, Date.now(), args.request_id]);
112
+ if (!changed.changes) return fail("request_not_pending");
113
+ audit(binding, `adopt_${args.status}`, caller.daemonNodeId);
114
+ return { ok: true, status: args.status === "adopted" ? "active" : "refused" };
115
+ });
116
+ }
117
+ export function unadopt(ctx: Human, nodeId: string) {
118
+ if (ctx.isNode || !ctx.userId) return fail("user_token_required");
119
+ if (db.transactionalFeaturesRefusal) return fail("atomic_transactions_required");
120
+ const node = humanNode(ctx, nodeId);
121
+ if (!node) return fail("adopt_forbidden");
122
+ const binding = db.get<Binding>("SELECT * FROM node_daemon_bindings WHERE node_id=?1 AND status IN ('pending','active')", nodeId);
123
+ if (!binding) return fail("binding_not_found");
124
+ // Do not reassign authority while a daemon may already be executing a lifecycle command.
125
+ for (const table of ["node_stop_requests", "node_start_requests"]) {
126
+ if (db.get(`SELECT request_id FROM ${table} WHERE child_node_id=?1 AND network_id=?2 AND status IN ('pending','delivered')`, nodeId, node.network_id)) return fail("node_lifecycle_in_flight");
127
+ }
128
+ db.transaction(() => {
129
+ db.run("UPDATE node_daemon_bindings SET status='revoked',updated_at=?1 WHERE request_id=?2", [Date.now(), binding.request_id]);
130
+ audit(binding, "unadopted", ctx.userId!);
131
+ });
132
+ const daemon = db.get<Node>("SELECT * FROM nodes WHERE node_id=?1 AND network_id=?2", binding.daemon_node_id, node.network_id);
133
+ if (daemon) pushEvent(daemon.alias, { type: "unadopt_node", node_id: nodeId, request_id: binding.request_id }, node.network_id);
134
+ return { ok: true, status: "revoked" };
135
+ }