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

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 (482) hide show
  1. package/README.md +120 -3
  2. package/bin/commhub.ts +93 -9
  3. package/build-info.json +7 -0
  4. package/package.json +10 -8
  5. package/src/ack-create-request-transport.test.ts +182 -0
  6. package/src/ack-create-request.test.ts +52 -8
  7. package/src/admin-delete-network-http.test.ts +229 -0
  8. package/src/admin-networks-http.test.ts +88 -0
  9. package/src/adoption-candidates-http.test.ts +140 -0
  10. package/src/adoption-candidates.ts +158 -0
  11. package/src/agent-access-batch.test.ts +215 -0
  12. package/src/agent-access.ts +585 -0
  13. package/src/agent-acl-groups-http.test.ts +247 -0
  14. package/src/agent-acl-http.test.ts +691 -0
  15. package/src/agent-acl-slice3-http.test.ts +888 -0
  16. package/src/agent-department-grants.test.ts +129 -0
  17. package/src/agent-department-http.test.ts +215 -0
  18. package/src/agent-groups-perf.test.ts +228 -0
  19. package/src/agent-notice.ts +48 -0
  20. package/src/agent-team-whoami-http.test.ts +98 -0
  21. package/src/agent-teams-http.test.ts +330 -0
  22. package/src/agent-teams.ts +244 -0
  23. package/src/alias-baseline-2571.test.ts +162 -0
  24. package/src/alias-baseline.ts +113 -0
  25. package/src/alias-filter.test.ts +72 -0
  26. package/src/alias-filter.ts +42 -0
  27. package/src/all-status-cache.test.ts +31 -0
  28. package/src/all-status-cache.ts +37 -0
  29. package/src/anet-variant-real-daemon-http.test.ts +185 -0
  30. package/src/api-host-supervisors-can-create-nodes.test.ts +350 -0
  31. package/src/api-host-supervisors-fallback.test.ts +6 -7
  32. package/src/api-host-supervisors-runtime-readiness.test.ts +195 -0
  33. package/src/api-nodes-shape.test.ts +131 -4
  34. package/src/auth-abuse-counters.test.ts +144 -0
  35. package/src/auth-abuse-counters.ts +122 -0
  36. package/src/auth-layer-shape.test.ts +105 -0
  37. package/src/auth-password-change-cli-tokens-http.test.ts +423 -0
  38. package/src/auth-sessions-http.test.ts +260 -0
  39. package/src/auth-validate.test.ts +5 -1
  40. package/src/auth-weak-password-login.test.ts +176 -0
  41. package/src/auth.ts +641 -68
  42. package/src/backfill-node-ids-2664.test.ts +128 -0
  43. package/src/binding-generation-http.test.ts +141 -0
  44. package/src/blocked-exit-on-reply.test.ts +122 -0
  45. package/src/broadcast-fanout-2721.test.ts +149 -0
  46. package/src/broadcast-fanout.ts +117 -0
  47. package/src/build-commit-report-http.test.ts +219 -0
  48. package/src/build-info.test.ts +60 -0
  49. package/src/build-info.ts +85 -0
  50. package/src/chain-attempt-dedup.test.ts +447 -0
  51. package/src/clip.test.ts +36 -0
  52. package/src/clip.ts +48 -0
  53. package/src/clone-node.test.ts +269 -0
  54. package/src/clone-node.ts +289 -0
  55. package/src/codex-config-flags.ts +77 -0
  56. package/src/codex-fork-contract.ts +23 -0
  57. package/src/codex-fork-migration.test.ts +38 -0
  58. package/src/commhub-bin-args.test.ts +85 -0
  59. package/src/config-apply-sec1.test.ts +37 -0
  60. package/src/config-apply-validate.test.ts +188 -1
  61. package/src/config-apply-validate.ts +226 -3
  62. package/src/contracts/session-project-create.ts +14 -0
  63. package/src/contracts/session-source-delivery.ts +16 -0
  64. package/src/contracts/session-source-directory.ts +54 -0
  65. package/src/contracts/session-source-evidence.ts +72 -0
  66. package/src/contracts/session-source-execution.ts +24 -0
  67. package/src/contracts/session-source-transport.ts +18 -0
  68. package/src/cors-origins.test.ts +73 -0
  69. package/src/create-node-blocked-gate.test.ts +365 -0
  70. package/src/create-node-error-domain.test.ts +127 -0
  71. package/src/create-node-network-id.test.ts +91 -0
  72. package/src/create-node-tool-schema.test.ts +59 -0
  73. package/src/create-node-unicode-name.test.ts +126 -0
  74. package/src/create-node-validate.test.ts +199 -7
  75. package/src/create-node-validate.ts +232 -15
  76. package/src/create-node-workdir.test.ts +298 -0
  77. package/src/create-node.ts +88 -23
  78. package/src/daemon-provider-snapshots.test.ts +453 -0
  79. package/src/daemon-provider-snapshots.ts +327 -0
  80. package/src/daemon-token-owner-http.test.ts +346 -0
  81. package/src/dashboard-slash-routing-http.test.ts +109 -0
  82. package/src/db-adapter-guard.test.ts +148 -0
  83. package/src/db-adapter-translate.test.ts +128 -0
  84. package/src/db-adapter.ts +377 -91
  85. package/src/db-timestamp.test.ts +38 -0
  86. package/src/db-timestamp.ts +15 -0
  87. package/src/db.ts +1334 -154
  88. package/src/delivered-without-push.test.ts +140 -0
  89. package/src/department-groups-http.test.ts +209 -0
  90. package/src/department-groups-sync-http.test.ts +328 -0
  91. package/src/department-groups.ts +434 -0
  92. package/src/department-heads-http.test.ts +350 -0
  93. package/src/department-heads.ts +226 -0
  94. package/src/departments-agent-count.test.ts +139 -0
  95. package/src/departments-http.test.ts +185 -0
  96. package/src/departments-mcp-error-domain.test.ts +135 -0
  97. package/src/departments-mcp.test.ts +128 -0
  98. package/src/departments.ts +318 -0
  99. package/src/desktop-message-seam.test.ts +150 -0
  100. package/src/desktop-message.test.ts +368 -0
  101. package/src/dm-file-scope-http.test.ts +227 -0
  102. package/src/empty-node-sweeper.test.ts +104 -0
  103. package/src/empty-node-sweeper.ts +88 -0
  104. package/src/env-transport-gate-http.test.ts +240 -0
  105. package/src/env-transport-gate.ts +80 -0
  106. package/src/env-transport-policy.ts +56 -0
  107. package/src/etag-of.test.ts +57 -0
  108. package/src/event-loop-lag.test.ts +180 -0
  109. package/src/event-loop-lag.ts +201 -0
  110. package/src/expiry-counters.test.ts +187 -0
  111. package/src/expiry-counters.ts +227 -0
  112. package/src/expiry-evidence-db.test.ts +103 -0
  113. package/src/ext-token-shared.test.ts +60 -0
  114. package/src/ext-validation-regression.test.ts +10 -17
  115. package/src/external-schedule-edits-http.test.ts +321 -0
  116. package/src/external-schedule-edits-timestamps.test.ts +64 -0
  117. package/src/external-schedule-edits.ts +327 -0
  118. package/src/file-download-authz-dev-open.test.ts +1 -1
  119. package/src/file-download-authz.test.ts +25 -4
  120. package/src/file-download-date-bucket.test.ts +1 -1
  121. package/src/file-network-scope-dev-open.test.ts +1 -1
  122. package/src/file-network-scope.test.ts +7 -6
  123. package/src/group-membership-events-http.test.ts +264 -0
  124. package/src/group-messages-http.test.ts +483 -0
  125. package/src/group-messages.ts +297 -0
  126. package/src/health-anon-readers.ts +67 -0
  127. package/src/health-host-disk-2756.test.ts +71 -0
  128. package/src/health-identity-root.test.ts +98 -0
  129. package/src/health-redaction.test.ts +1603 -7
  130. package/src/health-status-reasons.test.ts +84 -0
  131. package/src/host-supervisor-identity-http.test.ts +152 -0
  132. package/src/host-supervisor-identity.ts +92 -0
  133. package/src/host-supervisors-daemon-version.test.ts +137 -0
  134. package/src/http-gzip.test.ts +94 -0
  135. package/src/http-gzip.ts +112 -0
  136. package/src/hub-catalog-read-http.test.ts +664 -0
  137. package/src/hub-provider-config.test.ts +166 -0
  138. package/src/hub-provider-config.ts +202 -0
  139. package/src/hub-timestamp.test.ts +38 -0
  140. package/src/hub-timestamp.ts +27 -0
  141. package/src/human-dm.ts +215 -0
  142. package/src/human-inbox.ts +42 -0
  143. package/src/inbox-caller.ts +49 -0
  144. package/src/inbox-count-sse.test.ts +318 -0
  145. package/src/inbox-count.ts +29 -0
  146. package/src/index.ts +6 -2
  147. package/src/launched-by-cli-report-http.test.ts +155 -0
  148. package/src/license-state.test.ts +105 -0
  149. package/src/license-state.ts +48 -0
  150. package/src/lifecycle-error-domain.test.ts +149 -0
  151. package/src/list-ack-error-domain.test.ts +108 -0
  152. package/src/list-host-supervisors.test.ts +15 -4
  153. package/src/list-tasks-omit-default.test.ts +84 -0
  154. package/src/list-tasks-since-last.test.ts +100 -0
  155. package/src/list-tasks-since.test.ts +104 -0
  156. package/src/mcp-context-cost-http.test.ts +127 -0
  157. package/src/mcp-inflight.test.ts +92 -0
  158. package/src/mcp-inflight.ts +38 -0
  159. package/src/mcp-projects-events-http.test.ts +168 -0
  160. package/src/mcp-route-label-http.test.ts +120 -0
  161. package/src/mcp-write-network-resolution.test.ts +21 -0
  162. package/src/member-audit-network-id-http.test.ts +93 -0
  163. package/src/member-presence-http.test.ts +210 -0
  164. package/src/messages-ack-by-agent-http.test.ts +142 -0
  165. package/src/migrate-sqlite-to-pg.test.ts +47 -0
  166. package/src/migrate-sqlite-to-pg.ts +263 -0
  167. package/src/model-auth-notify-http.test.ts +181 -0
  168. package/src/model-auth-notify.ts +116 -0
  169. package/src/network-name-http.test.ts +75 -0
  170. package/src/network-quota-config.test.ts +100 -0
  171. package/src/network-rules-http.test.ts +169 -0
  172. package/src/network-rules.ts +129 -0
  173. package/src/network-scope.ts +222 -3
  174. package/src/network-token-membership-http.test.ts +186 -0
  175. package/src/node-alias-control.ts +12 -0
  176. package/src/node-attrs.test.ts +47 -2
  177. package/src/node-caller-identity-http.test.ts +1108 -0
  178. package/src/node-config-last-update.test.ts +126 -0
  179. package/src/node-config-last-update.ts +107 -0
  180. package/src/node-create-request-status-http.test.ts +105 -0
  181. package/src/node-daemon-bindings.test.ts +142 -0
  182. package/src/node-daemon-bindings.ts +135 -0
  183. package/src/node-failure-alert.test.ts +150 -0
  184. package/src/node-failure-alert.ts +177 -0
  185. package/src/node-files-transport.test.ts +350 -0
  186. package/src/node-health-codex-login.test.ts +120 -0
  187. package/src/node-health-dispatch-http.test.ts +373 -0
  188. package/src/node-health-guard-origin.test.ts +98 -0
  189. package/src/node-health-guard.ts +121 -0
  190. package/src/node-health-passthrough.test.ts +115 -0
  191. package/src/node-health-store.ts +101 -0
  192. package/src/node-id-alias.test.ts +190 -0
  193. package/src/node-identity-conflict-http.test.ts +269 -0
  194. package/src/node-identity-conflict.ts +142 -0
  195. package/src/node-identity-mismatch.test.ts +74 -0
  196. package/src/node-in-flight-tasks.ts +31 -0
  197. package/src/node-inbox-allowlist-http.test.ts +320 -0
  198. package/src/node-lifecycle-controllable.test.ts +64 -0
  199. package/src/node-lifecycle-controllable.ts +53 -0
  200. package/src/node-lifecycle-read-http.test.ts +257 -0
  201. package/src/node-lifecycle-read.ts +126 -0
  202. package/src/node-logs-transport.test.ts +266 -0
  203. package/src/node-peer-allowlist.test.ts +114 -0
  204. package/src/node-permissions-http.test.ts +901 -0
  205. package/src/node-permissions.ts +627 -0
  206. package/src/node-request-retention.test.ts +281 -0
  207. package/src/node-request-retention.ts +120 -0
  208. package/src/node-secret-rest-http.test.ts +190 -0
  209. package/src/node-secret-vault-inject.test.ts +132 -0
  210. package/src/node-security-write-gate.test.ts +72 -0
  211. package/src/node-serviceability.test.ts +86 -0
  212. package/src/node-serviceability.ts +124 -0
  213. package/src/node-session-control-http.test.ts +398 -0
  214. package/src/node-session-control.ts +316 -0
  215. package/src/node-skills-transport.test.ts +212 -0
  216. package/src/node-token-identity.ts +35 -0
  217. package/src/node-token-ownership.ts +51 -0
  218. package/src/node-token-privilege-http.test.ts +224 -0
  219. package/src/node-token-usage.test.ts +128 -0
  220. package/src/node-token-usage.ts +228 -0
  221. package/src/not-found-api-http.test.ts +67 -0
  222. package/src/observer-avatar-http.test.ts +103 -10
  223. package/src/observer-push.test.ts +76 -0
  224. package/src/opencode-catalog-report-http.test.ts +139 -0
  225. package/src/opencode-v2-catalog.test.ts +282 -0
  226. package/src/opencode-v2-catalog.ts +357 -0
  227. package/src/package-self-contained.test.ts +32 -0
  228. package/src/package-version-consistency.test.ts +25 -0
  229. package/src/parent-infer.test.ts +82 -0
  230. package/src/parent-infer.ts +110 -0
  231. package/src/parent-source-marker.test.ts +70 -0
  232. package/src/parent-source-orphan.test.ts +121 -0
  233. package/src/password-network-tokens.ts +25 -0
  234. package/src/peer-reply-atomic.test.ts +462 -0
  235. package/src/peer-reply-capability.test.ts +70 -0
  236. package/src/pg-worker.ts +87 -0
  237. package/src/poll-pacing.test.ts +74 -0
  238. package/src/poll-pacing.ts +123 -0
  239. package/src/probe-provider-error-domain.test.ts +145 -0
  240. package/src/project-dir-warn-clear-http.test.ts +132 -0
  241. package/src/project-viewer-can-http.test.ts +116 -0
  242. package/src/provider-skill-error-domain.test.ts +130 -0
  243. package/src/provider-tools-shape.test.ts +165 -0
  244. package/src/push.test.ts +20 -10
  245. package/src/push.ts +373 -9
  246. package/src/redact-tokens.test.ts +86 -0
  247. package/src/redact-tokens.ts +43 -0
  248. package/src/rejection-counters.test.ts +72 -0
  249. package/src/rejection-counters.ts +173 -0
  250. package/src/rename.ts +38 -10
  251. package/src/reply-target-derivation.test.ts +96 -0
  252. package/src/report-status-handover-capabilities-http.test.ts +124 -0
  253. package/src/report-status-host-schema.test.ts +272 -0
  254. package/src/report-status-resume-id-handover.test.ts +184 -0
  255. package/src/report-status-secret-keys.test.ts +140 -0
  256. package/src/require-explicit-test-db.ts +9 -0
  257. package/src/requirement-due-reminders-http.test.ts +620 -0
  258. package/src/requirement-due-reminders.ts +416 -0
  259. package/src/requirement-events-http.test.ts +318 -0
  260. package/src/requirement-events.test.ts +45 -0
  261. package/src/requirement-events.ts +144 -0
  262. package/src/requirement-notify.ts +165 -0
  263. package/src/requirement-participant-notify-http.test.ts +313 -0
  264. package/src/requirement-tag-ops-http.test.ts +454 -0
  265. package/src/requirement-tag-tree-http.test.ts +275 -0
  266. package/src/requirement-tag-tree.ts +127 -0
  267. package/src/requirement-tags.ts +102 -0
  268. package/src/requirements-abandoned-http.test.ts +236 -0
  269. package/src/requirements-assignee-drift.test.ts +154 -0
  270. package/src/requirements-comment-http.test.ts +174 -0
  271. package/src/requirements-completed-at-migration.test.ts +70 -0
  272. package/src/requirements-errors-mcp-http.test.ts +164 -0
  273. package/src/requirements-errors.ts +158 -0
  274. package/src/requirements-etag-http.test.ts +91 -0
  275. package/src/requirements-http.test.ts +709 -0
  276. package/src/requirements-last-event-http.test.ts +349 -0
  277. package/src/requirements-list-mcp-slim-http.test.ts +155 -0
  278. package/src/requirements-list-slim-http.test.ts +324 -0
  279. package/src/requirements-mcp.test.ts +180 -0
  280. package/src/requirements-migrate.ts +283 -0
  281. package/src/requirements-owner-strict-mcp-http.test.ts +145 -0
  282. package/src/requirements-people-http.test.ts +114 -0
  283. package/src/requirements-people-mcp-http.test.ts +231 -0
  284. package/src/requirements-people.ts +196 -0
  285. package/src/requirements-priority-lowest.test.ts +114 -0
  286. package/src/requirements-projects-network-echo.test.ts +57 -0
  287. package/src/requirements-projects-parent-http.test.ts +123 -0
  288. package/src/requirements-search-http.test.ts +182 -0
  289. package/src/requirements-search.test.ts +32 -0
  290. package/src/requirements-search.ts +145 -0
  291. package/src/requirements-seq-http.test.ts +193 -0
  292. package/src/requirements-seq-migration.test.ts +63 -0
  293. package/src/requirements-start-date.test.ts +125 -0
  294. package/src/requirements-stats-http.test.ts +357 -0
  295. package/src/requirements-stats.ts +195 -0
  296. package/src/requirements-status-participants-http.test.ts +222 -0
  297. package/src/requirements-upgrade-e2e.test.ts +126 -0
  298. package/src/requirements-upgrade-migration.test.ts +98 -0
  299. package/src/requirements.ts +2205 -0
  300. package/src/resolve-port.test.ts +57 -0
  301. package/src/resolve-port.ts +44 -0
  302. package/src/rest-alias-network-fallback-http.test.ts +123 -0
  303. package/src/rest-alias-network-fallback.test.ts +60 -0
  304. package/src/rest-alias-network-fallback.ts +65 -0
  305. package/src/rest-explicit-columns-http.test.ts +266 -0
  306. package/src/rest-identity.test.ts +130 -0
  307. package/src/rest-identity.ts +141 -0
  308. package/src/rest-projections.ts +72 -0
  309. package/src/rest-read-network-real-chain.test.ts +97 -0
  310. package/src/rest-write-network-resolution.test.ts +133 -0
  311. package/src/restart-readiness-http.test.ts +121 -0
  312. package/src/restricted-files.ts +76 -0
  313. package/src/retention-first-sweep-quiet.test.ts +31 -0
  314. package/src/retention.test.ts +100 -40
  315. package/src/retention.ts +423 -104
  316. package/src/route-callers-http.test.ts +120 -0
  317. package/src/route-timing.test.ts +218 -0
  318. package/src/route-timing.ts +262 -0
  319. package/src/rules-file-duplicate-alias.test.ts +234 -0
  320. package/src/rules-file-session-target.test.ts +207 -0
  321. package/src/rules-file-transport.test.ts +280 -0
  322. package/src/runtime-label.test.ts +22 -0
  323. package/src/runtime-label.ts +21 -0
  324. package/src/runtime-readiness.ts +90 -0
  325. package/src/schedule-agent-mcp-http.test.ts +486 -0
  326. package/src/schedule-agent.ts +252 -0
  327. package/src/schedule-starved.test.ts +92 -0
  328. package/src/schedule-starved.ts +114 -0
  329. package/src/scheduled-backoff-http.test.ts +203 -0
  330. package/src/scheduled-backoff.ts +64 -0
  331. package/src/scheduled-doorbell-nodeless-session.test.ts +134 -0
  332. package/src/scheduled-failure-backoff-2622.test.ts +145 -0
  333. package/src/scheduled-failure-code.test.ts +73 -0
  334. package/src/scheduled-failure-code.ts +105 -0
  335. package/src/scheduled-failures-http.test.ts +279 -0
  336. package/src/scheduled-failures.ts +425 -0
  337. package/src/scheduled-noprogress-backoff-2622.test.ts +163 -0
  338. package/src/scheduled-offline-backoff-probe.test.ts +56 -0
  339. package/src/scheduled-offline.test.ts +131 -0
  340. package/src/scheduled-offline.ts +66 -0
  341. package/src/scheduled-outcome-guidance-http.test.ts +139 -0
  342. package/src/scheduled-outcome-guidance.ts +9 -0
  343. package/src/scheduled-reply-unread-http.test.ts +212 -0
  344. package/src/scheduled-requirement-wake-http.test.ts +289 -0
  345. package/src/scheduled-requirement-wake.ts +125 -0
  346. package/src/scheduled-run-terminal.test.ts +290 -0
  347. package/src/scheduled-skip-blocking-task.test.ts +120 -0
  348. package/src/scheduled-skip-path-backoff-2622.test.ts +98 -0
  349. package/src/scheduled-stuck-http.test.ts +316 -0
  350. package/src/scheduled-stuck-notice-cap.test.ts +80 -0
  351. package/src/scheduled-stuck.ts +219 -0
  352. package/src/scheduled-tasks-http.test.ts +679 -0
  353. package/src/scheduled-tasks.ts +980 -0
  354. package/src/scheduled-work-outcome-http.test.ts +154 -0
  355. package/src/scheduled-work-outcome.ts +50 -0
  356. package/src/scoped-secrets.ts +167 -0
  357. package/src/secret-echo-negative-control.test.ts +118 -0
  358. package/src/send-dedup-request-id.test.ts +229 -0
  359. package/src/send-reply-agent-warning.test.ts +38 -38
  360. package/src/send-reply-alias-optional.test.ts +131 -0
  361. package/src/send-reply-attachments.test.ts +28 -7
  362. package/src/send_dedup.test.ts +54 -0
  363. package/src/send_dedup.ts +52 -6
  364. package/src/serve-error.test.ts +73 -0
  365. package/src/serve-error.ts +56 -0
  366. package/src/server.ts +5103 -377
  367. package/src/session-fork-store.test.ts +43 -0
  368. package/src/session-fork-store.ts +51 -0
  369. package/src/session-project-attach-migration.test.ts +23 -0
  370. package/src/session-project-attach-native.test.ts +123 -0
  371. package/src/session-project-create-http.test.ts +408 -0
  372. package/src/session-project-create-native.test.ts +292 -0
  373. package/src/session-project-create.ts +159 -0
  374. package/src/session-source-admission-store.ts +58 -0
  375. package/src/session-source-create.test.ts +155 -0
  376. package/src/session-source-create.ts +97 -0
  377. package/src/session-source-delivery.ts +114 -0
  378. package/src/session-source-directory-http.test.ts +196 -0
  379. package/src/session-source-evidence.test.ts +905 -0
  380. package/src/session-source-evidence.ts +191 -0
  381. package/src/session-source-execution.ts +87 -0
  382. package/src/session-source-grant.test.ts +117 -0
  383. package/src/session-source-grant.ts +78 -0
  384. package/src/session-source-issuer.test.ts +250 -0
  385. package/src/session-source-issuer.ts +164 -0
  386. package/src/session-source-transport.ts +381 -0
  387. package/src/session-task-on-dispatch.ts +14 -0
  388. package/src/session-token-ownership-http.test.ts +122 -0
  389. package/src/shared/codex-inventory.ts +41 -0
  390. package/src/shared/daemon-provider-login.ts +31 -0
  391. package/src/shared/daemon-provider-snapshot.ts +52 -0
  392. package/src/shared/external-schedule-contract.ts +60 -0
  393. package/src/shared/node-name.test.ts +62 -0
  394. package/src/shared/node-name.ts +161 -0
  395. package/src/shared/probe-host-allowlist-drift.test.ts +45 -0
  396. package/src/shared/provider-application.ts +29 -0
  397. package/src/shared/provider-collection.ts +14 -0
  398. package/src/shared/provider-initialization.ts +8 -0
  399. package/src/shared/reserved-env-drift.test.ts +10 -0
  400. package/src/shared/scoped-secret-contract.ts +5 -0
  401. package/src/shared/task-content-limit-drift.test.ts +28 -0
  402. package/src/shared/task-content-limit.ts +25 -0
  403. package/src/side-thread-command-transport.test.ts +312 -0
  404. package/src/side-thread-command-transport.ts +318 -0
  405. package/src/side-thread-http-integration.test.ts +233 -0
  406. package/src/side-thread-http.ts +504 -0
  407. package/src/side-thread-production.test.ts +72 -0
  408. package/src/side-thread-production.ts +118 -0
  409. package/src/side-thread.test.ts +1067 -0
  410. package/src/side-thread.ts +2499 -0
  411. package/src/skillhub-http.test.ts +144 -0
  412. package/src/sqlite-close-checkpoint.test.ts +78 -0
  413. package/src/start-node.test.ts +265 -0
  414. package/src/start-request-error-domain.test.ts +182 -0
  415. package/src/start-skill-error-domain.test.ts +122 -0
  416. package/src/stats-versions-http.test.ts +65 -0
  417. package/src/status-alias-filter-http.test.ts +106 -0
  418. package/src/status-alias-resolver-http.test.ts +163 -0
  419. package/src/status-alias-resolver.ts +19 -0
  420. package/src/status-node-id-filter-http.test.ts +161 -0
  421. package/src/status-node-secrets-capable-http.test.ts +44 -0
  422. package/src/status-read-cache-http.test.ts +229 -0
  423. package/src/status-read-cache.ts +129 -0
  424. package/src/stop-delete-node.test.ts +567 -1
  425. package/src/task-access-http.test.ts +407 -0
  426. package/src/task-access.ts +420 -0
  427. package/src/task-activity.ts +60 -0
  428. package/src/task-auth-origin-http.test.ts +93 -0
  429. package/src/task-auth-origin.test.ts +24 -0
  430. package/src/task-auth-origin.ts +7 -0
  431. package/src/task-consumption.test.ts +512 -0
  432. package/src/task-diagnostic-http.test.ts +149 -0
  433. package/src/task-diagnostic.test.ts +115 -0
  434. package/src/task-diagnostic.ts +118 -0
  435. package/src/task-expiry-notice-http.test.ts +298 -0
  436. package/src/task-expiry-notice.ts +318 -0
  437. package/src/task-idempotency-mcp.test.ts +148 -0
  438. package/src/task-idempotency.test.ts +76 -0
  439. package/src/task-idempotency.ts +81 -0
  440. package/src/task-late-replies.ts +54 -0
  441. package/src/task-late-reply-http.test.ts +227 -0
  442. package/src/task-lifecycle-watcher-busy.test.ts +114 -0
  443. package/src/task-lifecycle-watcher.test.ts +209 -0
  444. package/src/task-lifecycle-watcher.ts +109 -0
  445. package/src/task-network-resolution-http.test.ts +140 -0
  446. package/src/task-not-found-error-domain.test.ts +117 -0
  447. package/src/task-offline-delivery-2668.test.ts +119 -0
  448. package/src/task-offline-delivery.ts +81 -0
  449. package/src/task-orphan-http.test.ts +287 -0
  450. package/src/task-orphan.ts +119 -0
  451. package/src/task-queue-ahead-http.test.ts +309 -0
  452. package/src/task-queue-ahead-scale.test.ts +236 -0
  453. package/src/task-queue-ahead.ts +186 -0
  454. package/src/task-rejection-log-http.test.ts +160 -0
  455. package/src/task-rejection-log.ts +61 -0
  456. package/src/task-sender-http.test.ts +143 -0
  457. package/src/task-stale-open-http.test.ts +292 -0
  458. package/src/task-stale-open.ts +103 -0
  459. package/src/tasks-pagination-http.test.ts +141 -0
  460. package/src/team-rules-status-http.test.ts +90 -0
  461. package/src/team-rules-status.test.ts +59 -0
  462. package/src/team-rules-status.ts +72 -0
  463. package/src/test-work-root.ts +18 -0
  464. package/src/tmux-allowlist.test.ts +48 -0
  465. package/src/token-usage-http.test.ts +156 -0
  466. package/src/tool-audience-http.test.ts +266 -0
  467. package/src/tool-audience.ts +130 -0
  468. package/src/tools-list-json-schema.test.ts +94 -0
  469. package/src/tools.ts +4557 -472
  470. package/src/update-node-config-error-domain.test.ts +107 -0
  471. package/src/uploads-http.test.ts +6 -4
  472. package/src/uploads.ts +23 -4
  473. package/src/user-avatar-http.test.ts +74 -0
  474. package/src/user-avatar-image.ts +160 -0
  475. package/src/user-avatar-migration.test.ts +25 -0
  476. package/src/user-avatar-upload-http.test.ts +353 -0
  477. package/src/user-inbox-by-agent-http.test.ts +189 -0
  478. package/src/user-inbox-netid-notnull.test.ts +122 -0
  479. package/src/user-inbox-read-http.test.ts +223 -0
  480. package/src/user-inbox-schema.test.ts +54 -0
  481. package/src/version-stats.test.ts +66 -0
  482. package/src/version-stats.ts +109 -0
@@ -0,0 +1,155 @@
1
+ // 2026-11-10 —— 「起这份 agent-node 的 anet CLI 版本」必须真的走到 `/api/nodes`。
2
+ //
3
+ // 为什么不是「加一列就完了」:Hub 的 report_status schema 对**不认识的键是静默丢弃**的
4
+ // (tools.ts 里那段 #1545 注释写得很清楚)。这条链路必须三处同时成立:
5
+ // ① schema 里有这个键(否则 zod 丢掉)
6
+ // ② 写路径把它落库(JSON.stringify 会连 `undefined` 一起吞掉)
7
+ // ③ 读路径把它投影出来(否则界面上看不见)
8
+ // 少任何一处,现场表现都是「节点明明发了、hub 上什么都没有」—— 本仓库已经吃过两次
9
+ // (#3294 的 build_commit、#2293 的 opencode_catalog)。
10
+ //
11
+ // 所以这里走**真** HTTP:真 node 令牌 + 真 MCP `tools/call report_status` + 真 `GET /api/nodes`,
12
+ // 不做镜像 handler(镜像会与真实 handler 各自漂移)。
13
+ import { afterAll, beforeAll, describe, expect, test } from "bun:test";
14
+ import { mkdtempSync, rmSync } from "node:fs";
15
+ import { tmpdir } from "node:os";
16
+ import { join } from "node:path";
17
+ import { createNetworkTokenForNode, register } from "./auth.js";
18
+ import { db } from "./db.js";
19
+
20
+ const DIR = mkdtempSync(join(tmpdir(), "anet-launched-by-"));
21
+ process.env.COMMHUB_DB ||= join(DIR, "commhub.db");
22
+
23
+ const stamp = `${process.pid}_${Date.now()}`;
24
+ const NET_ALIAS = `launchedby-${stamp}`;
25
+ let hub: any;
26
+ let base = "";
27
+ let adminToken = "";
28
+ let nodeToken = "";
29
+ let networkId = "";
30
+ let nodeId = "";
31
+
32
+ /** CLI 侧真实会上报的版本形态(npm 预发布版)。 */
33
+ const CLI_VERSION = "2.3.0-preview.226";
34
+
35
+ async function send(token: string, method: string, path: string, body?: unknown) {
36
+ const r = await fetch(`${base}${path}`, {
37
+ method,
38
+ headers: { Authorization: `Bearer ${token}`, "Content-Type": "application/json" },
39
+ body: body === undefined ? undefined : JSON.stringify(body),
40
+ });
41
+ const text = await r.text();
42
+ let json: any = null;
43
+ try { json = text ? JSON.parse(text) : null; } catch { /* MCP may answer as SSE */ }
44
+ return { status: r.status, body: json, text };
45
+ }
46
+
47
+ /** 真 MCP `tools/call report_status`,与 agent-node 心跳同一条入参路径。 */
48
+ async function reportStatus(snapshot: Record<string, unknown>) {
49
+ const r = await fetch(`${base}/mcp`, {
50
+ method: "POST",
51
+ headers: {
52
+ Authorization: `Bearer ${nodeToken}`,
53
+ "Content-Type": "application/json",
54
+ Accept: "application/json, text/event-stream",
55
+ },
56
+ body: JSON.stringify({
57
+ jsonrpc: "2.0", id: 1, method: "tools/call",
58
+ params: {
59
+ name: "report_status",
60
+ arguments: {
61
+ resume_id: `r_launchedby_${stamp}`, alias: NET_ALIAS, status: "idle", node_id: nodeId,
62
+ runtime: "opencode-sdk",
63
+ config_snapshot: { model: "deepseek/deepseek-flash", ...snapshot },
64
+ },
65
+ },
66
+ }),
67
+ });
68
+ await r.text();
69
+ return r.status;
70
+ }
71
+
72
+ async function nodeRow() {
73
+ const r = await send(adminToken, "GET", `/api/nodes?network_id=${networkId}`);
74
+ expect(r.status).toBe(200);
75
+ return ((r.body?.nodes ?? []) as Array<Record<string, unknown>>).find(n => n.node_id === nodeId)!;
76
+ }
77
+
78
+ function storedSnapshot(): Record<string, unknown> {
79
+ const stored = db.get<{ config_snapshot: string }>(
80
+ "SELECT config_snapshot FROM nodes WHERE node_id = ?1", nodeId,
81
+ )!;
82
+ return JSON.parse(stored.config_snapshot);
83
+ }
84
+
85
+ beforeAll(async () => {
86
+ const admin = register(`launchedby_admin_${stamp}`, "LaunchedByAdmin123!", undefined, "LaunchedBy Admin");
87
+ expect(admin.ok).toBe(true);
88
+ adminToken = admin.token!;
89
+ networkId = admin.network_id!;
90
+ const ownerId = admin.user!.user_id;
91
+ nodeId = `n_launchedby_${stamp}`;
92
+ const minted = createNetworkTokenForNode(ownerId, networkId, NET_ALIAS, nodeId);
93
+ expect(minted.ok).toBe(true);
94
+ nodeToken = minted.token!;
95
+ const mod: any = await import("./server.js");
96
+ hub = mod.bootServer({ port: 0, hostname: "127.0.0.1" });
97
+ base = `http://127.0.0.1:${hub.port}`;
98
+ }, 30_000);
99
+
100
+ afterAll(() => {
101
+ try { hub?.stop?.(true); } catch { /* already down */ }
102
+ try { rmSync(DIR, { recursive: true, force: true }); } catch { /* best effort */ }
103
+ });
104
+
105
+ describe("launched_by_cli_version 从真上报走到 GET /api/nodes", () => {
106
+ test("schema 不吞这个键:落库 + /api/nodes 投影都看得见", async () => {
107
+ expect(await reportStatus({ launched_by_cli_version: CLI_VERSION })).toBe(200);
108
+
109
+ // ② 写路径
110
+ expect(storedSnapshot().launched_by_cli_version).toBe(CLI_VERSION);
111
+
112
+ // ③ 读路径
113
+ const row = await nodeRow();
114
+ expect(row.launched_by_cli_version).toBe(CLI_VERSION);
115
+ // 整个快照仍然不外泄(这一格只是快照里的一个标量)。
116
+ expect(row).not.toHaveProperty("config_snapshot");
117
+ });
118
+
119
+ test("没有这一格时投影是 null —— 不是 undefined 缺席,也不回退成占位版本", async () => {
120
+ expect(await reportStatus({})).toBe(200);
121
+ expect(storedSnapshot()).not.toHaveProperty("launched_by_cli_version");
122
+ const row = await nodeRow();
123
+ expect(row.launched_by_cli_version).toBeNull();
124
+ });
125
+
126
+ test("形状不对(超过 64 字符)只丢这一格,整份心跳照收", async () => {
127
+ const tooLong = `1.0.0${"0".repeat(60)}`;
128
+ expect(tooLong.length).toBeGreaterThan(64);
129
+ expect(await reportStatus({ launched_by_cli_version: tooLong })).toBe(200);
130
+ // `.catch(undefined)` ⇒ 落库时被 JSON.stringify 吞掉(不是存一个半截值)
131
+ expect(storedSnapshot()).not.toHaveProperty("launched_by_cli_version");
132
+ expect((await nodeRow()).launched_by_cli_version).toBeNull();
133
+ });
134
+
135
+ test("类型不对(对象/数字)同样只丢这一格", async () => {
136
+ expect(await reportStatus({ launched_by_cli_version: { v: CLI_VERSION } })).toBe(200);
137
+ expect((await nodeRow()).launched_by_cli_version).toBeNull();
138
+ expect(await reportStatus({ launched_by_cli_version: 42 })).toBe(200);
139
+ expect((await nodeRow()).launched_by_cli_version).toBeNull();
140
+ });
141
+ });
142
+
143
+ describe("per-node config 端点:刻意不加这一格(说明理由,不是忘了)", () => {
144
+ // `GET /api/nodes/:id/config` 的白名单只装**可编辑/可门控**的配置项
145
+ // (model / modelVariant / flags / agent / *_config_capable …),
146
+ // 溯源类只读标量(build_commit、opencode_catalog、role)一律不出现在那里。
147
+ // launched_by_cli_version 属于后者 ⇒ 只走 /api/nodes,与邻居保持一致。
148
+ test("该端点仍然只回配置项,不带这一格", async () => {
149
+ expect(await reportStatus({ launched_by_cli_version: CLI_VERSION })).toBe(200);
150
+ const r = await send(adminToken, "GET", `/api/nodes/${nodeId}/config`);
151
+ expect(r.status).toBe(200);
152
+ expect(r.body).not.toHaveProperty("launched_by_cli_version");
153
+ expect(r.body).toHaveProperty("model");
154
+ });
155
+ });
@@ -0,0 +1,105 @@
1
+ // 2026-10-31 —— license 三态契约。
2
+ //
3
+ // 四条断言对应四种输入,第四种(查询失败)在旧实现里会直接 500 掉整个 /health:
4
+ // known : 有行且有 type
5
+ // absent : 查询成功、无行
6
+ // unknown: 有行但 type 空(数据不全)—— 修法与 absent 不同
7
+ // unknown: 查询失败 —— 修法与 absent 不同,且**不许拖垮 /health**
8
+
9
+ import { describe, expect, test } from "bun:test";
10
+ import { legacyLicenseField, licenseStateOf } from "./license-state";
11
+
12
+ describe("licenseStateOf", () => {
13
+ test("known: a row with a non-empty type", () => {
14
+ expect(licenseStateOf({ type: "pro" })).toEqual({ kind: "known", type: "pro" });
15
+ expect(licenseStateOf({ type: " team " })).toEqual({ kind: "known", type: "team" });
16
+ });
17
+
18
+ test("absent: query succeeded and there is no row", () => {
19
+ expect(licenseStateOf(null)).toEqual({ kind: "absent" });
20
+ expect(licenseStateOf(undefined)).toEqual({ kind: "absent" });
21
+ });
22
+
23
+ test("unknown(row_without_type): a row exists but the type is empty — different fix from absent", () => {
24
+ expect(licenseStateOf({ type: "" })).toEqual({ kind: "unknown", reason: "license_row_without_type" });
25
+ expect(licenseStateOf({ type: " " })).toEqual({ kind: "unknown", reason: "license_row_without_type" });
26
+ expect(licenseStateOf({})).toEqual({ kind: "unknown", reason: "license_row_without_type" });
27
+ expect(licenseStateOf({ type: 42 })).toEqual({ kind: "unknown", reason: "license_row_without_type" });
28
+ });
29
+
30
+ test("unknown(query_failed) wins over the row — a failed query tells us nothing about the row", () => {
31
+ expect(licenseStateOf({ type: "pro" }, true)).toEqual({ kind: "unknown", reason: "license_query_failed" });
32
+ expect(licenseStateOf(null, true)).toEqual({ kind: "unknown", reason: "license_query_failed" });
33
+ });
34
+
35
+ test("the three states are mutually exclusive — no input yields two of them", () => {
36
+ const kinds = new Set([
37
+ licenseStateOf({ type: "pro" }).kind,
38
+ licenseStateOf(null).kind,
39
+ licenseStateOf({ type: "" }).kind,
40
+ licenseStateOf(null, true).kind,
41
+ ]);
42
+ // known / absent / unknown —— 只有三种 kind,且 unknown 有两条不同 reason
43
+ expect([...kinds].sort()).toEqual(["absent", "known", "unknown"]);
44
+ });
45
+ });
46
+
47
+ describe("legacyLicenseField", () => {
48
+ test("stays byte-identical to the old expression for every input", () => {
49
+ expect(legacyLicenseField({ type: "pro" })).toBe("pro");
50
+ expect(legacyLicenseField({ type: "" })).toBe("none");
51
+ expect(legacyLicenseField({})).toBe("none");
52
+ expect(legacyLicenseField(null)).toBe("none");
53
+ // 非字符串 type 旧实现也回 "none"(`license?.type || "none"` 的真值语义)
54
+ expect(legacyLicenseField({ type: 0 as unknown })).toBe("none");
55
+ });
56
+ });
57
+
58
+ // 2026-11-01 —— 值域 == 生产者集合,**用穷举**而不是用声明。
59
+ //
60
+ // `LicenseState` 是一个联合类型:它声明了 {known, absent, unknown} 与两个 reason。
61
+ // 声明本身不会红 —— 有人加了第四个分支(例如 expired)而忘了改类型时,
62
+ // TypeScript 会红,但**改类型而不加分支**(往联合里加一个没人产生的成员)不会红,
63
+ // 于是「值域里有它、但没人会产生它」这一格没有任何断言。
64
+ //
65
+ // 这里的域是有限的(failed × 5 种 row)⇒ 可以穷举:
66
+ // ① 产生的 kind 集合 == 声明的 kind 集合
67
+ // ② 产生的 reason 集合 == 声明的 reason 集合
68
+ // ③ 每个输入恰好落在一格里(互斥)
69
+ describe("值域 == 生产者集合(穷举有限域)", () => {
70
+ const ROWS: unknown[] = [
71
+ null, undefined, {}, { type: "" }, { type: " " }, { type: 42 }, { type: "pro" }, { type: " team " },
72
+ ];
73
+ const OUT = ROWS.flatMap((r) => [false, true].map((failed) => licenseStateOf(r as any, failed)));
74
+
75
+ test("① kind 集合恰好是 known / absent / unknown 三个", () => {
76
+ expect([...new Set(OUT.map((o) => o.kind))].sort()).toEqual(["absent", "known", "unknown"]);
77
+ });
78
+
79
+ test("② reason 集合恰好是两个(多一个 ⇒ 有值没有生产者;少一个 ⇒ 有生产者没有值)", () => {
80
+ const reasons = OUT.flatMap((o) => (o.kind === "unknown" ? [o.reason] : [])).sort();
81
+ expect([...new Set(reasons)]).toEqual(["license_query_failed", "license_row_without_type"]);
82
+ });
83
+
84
+ // ④ 声明的值域 vs 产生的值域:只比「产生的」抓不到「声明了但没人产生」。
85
+ // 这一条读源码里的联合类型字面量,与上面 ② 的产出集合对账。
86
+ test("④ 类型里声明的 reason 集合 == 实际产出的集合(无声明无生产者)", async () => {
87
+ const { licenseStateOf: fn } = await import("./license-state.js");
88
+ const src = (await import("node:fs")).readFileSync(new URL("./license-state.ts", import.meta.url), "utf8");
89
+ // 注意结尾:联合类型的**最后一个**成员后面是 ` }` 而不是 `|`,
90
+ // 只写 `(?=\||;)` 会漏掉它 —— 而漏掉的那一个正好是「最后加进去的那个」,
91
+ // 也就是这条断言最该抓到的那一个。
92
+ const declared = [...src.matchAll(/"([a-z_]+)"\s*(?=[|;}])/g)].map((m) => m[1])
93
+ .filter((x) => x.startsWith("license_"));
94
+ const produced = [...new Set(OUT.flatMap((o) => (o.kind === "unknown" ? [o.reason] : [])))].sort();
95
+ expect([...new Set(declared)].sort()).toEqual(produced);
96
+ expect(typeof fn).toBe("function");
97
+ });
98
+
99
+ test("③ 每个输入恰好落在一格里(互斥,不重叠)", () => {
100
+ for (const o of OUT) {
101
+ const hits = [o.kind === "known", o.kind === "absent", o.kind === "unknown"].filter(Boolean).length;
102
+ expect(hits).toBe(1);
103
+ }
104
+ });
105
+ });
@@ -0,0 +1,48 @@
1
+ // 2026-10-31 —— `license` 字段的三值化。
2
+ //
3
+ // 现状:`/health` 只给 `license: license?.type || "none"`。
4
+ // 而 "none" 同时覆盖三种不同的事:
5
+ // · 查询成功、确实没有 license 行 → 去授权能修
6
+ // · 查询成功、有行但 type 为空/缺失 → 数据不全,补行能修
7
+ // · 查询失败 → 补一次取数能修
8
+ //
9
+ // ⇒ 三种的**修法不同**,却共用一个字符串。这正是那条:
10
+ // 「空值折叠的方向,总是朝着『让你继续往下走』」—— 这里的方向是「当成没有授权」。
11
+ //
12
+ // 🔴 absent 与 unknown 的区别是**谁能修**:
13
+ // absent = 我们知道它不在(改配置/去授权)
14
+ // unknown = 没人去看 / 看失败了(补一次取数)
15
+ // 混成一个值之后,修法也一起混了。
16
+ //
17
+ // 兼容:`license` 字段保留一个版本(语义不精确,勿用于判据),
18
+ // 判据请用 `license_state`。等外部读者迁移完再下线旧字段。
19
+
20
+ export type LicenseState =
21
+ | { kind: "known"; type: string }
22
+ | { kind: "absent" }
23
+ | { kind: "unknown"; reason: "license_query_failed" | "license_row_without_type" };
24
+
25
+ export interface LicenseRow {
26
+ type?: unknown;
27
+ expires_at?: unknown;
28
+ }
29
+
30
+ /**
31
+ * 纯函数:把「一次查询的结果」映射成三态。
32
+ *
33
+ * @param row 查询到的行;null/undefined 表示查询成功但没有行
34
+ * @param failed 查询是否抛错(抛错时 row 无意义)
35
+ */
36
+ export function licenseStateOf(row: LicenseRow | null | undefined, failed = false): LicenseState {
37
+ if (failed) return { kind: "unknown", reason: "license_query_failed" };
38
+ if (!row) return { kind: "absent" };
39
+ const type = typeof row.type === "string" ? row.type.trim() : "";
40
+ if (!type) return { kind: "unknown", reason: "license_row_without_type" };
41
+ return { kind: "known", type };
42
+ }
43
+
44
+ /** 兼容字段的渲染(保持与旧行为逐字相同,便于逐步下线)。 */
45
+ export function legacyLicenseField(row: LicenseRow | null | undefined): string {
46
+ const type = row && typeof row.type === "string" ? row.type : "";
47
+ return type || "none";
48
+ }
@@ -0,0 +1,149 @@
1
+ // #3309 读数覆盖第十批 —— 两条此前在测试里一次都没出现过的 error:
2
+ //
3
+ // restart_node : adopted_restart_requires_daemon
4
+ // start_node : forbidden_cross_tenant
5
+ //
6
+ // 第一条是「adopted 节点不能被 restart」:binding 证明的是 stop/start 授权,
7
+ // 不是 exit-75 supervisor 能力 —— 代码里这段注释写得很清楚,但此前没有任何测试走过它。
8
+ // 这条特别值得钉住,因为它是**「有权限做 A 不等于有权限做 B」**的一个具体实例:
9
+ // 同一个 binding 让 stop/start 可用,却让 restart 必须拒绝。
10
+ //
11
+ // ⚠ 没测 daemon_cross_tenant:那需要「daemon 与 child 分属不同网络」的夹具,
12
+ // 而 resolveTargetNode 本身会在采到那种行之前就按网络拦掉 —— 要造出来只能伪造
13
+ // 一个正常路径不会产生的状态。留在待补清单里,不在这里假装覆盖。
14
+ import { afterAll, beforeEach, describe, expect, test } from "bun:test";
15
+ import { db } from "./db.js";
16
+ import { McpServer } from "@modelcontextprotocol/sdk/server/mcp.js";
17
+ import { registerTools } from "./tools.js";
18
+
19
+ const NET = "net_10th_err";
20
+ const NET_OTHER = "net_10th_other"; // 调用者**不在**里面的网络(用来触发 scope.denied)
21
+ const NET_DAEMON = "net_10th_daemon"; // daemon 所在的另一个网络(用来触发 daemon_cross_tenant)
22
+ const OWNER = "u_10th_owner";
23
+ const DAEMON = "node_10th_daemon";
24
+ const ADOPTED = "node_10th_adopted";
25
+ const DAEMON_OTHER_NET = "node_10th_daemon_other";
26
+
27
+ type ToolHandler = (args: any) => Promise<{ content: Array<{ type: "text"; text: string }> }>;
28
+
29
+ function handlers(): Record<string, ToolHandler> {
30
+ const server = new McpServer({ name: "t", version: "0" }) as any;
31
+ const out: Record<string, ToolHandler> = {};
32
+ const orig = server.tool.bind(server);
33
+ server.tool = (n: string, d: string, s: any, h: ToolHandler) => { out[n] = h; return orig(n, d, s, h); };
34
+ registerTools(server, undefined, NET, OWNER, null, false, null);
35
+ return out;
36
+ }
37
+
38
+ async function call(name: string, args: Record<string, unknown>) {
39
+ const r = await handlers()[name](args);
40
+ return JSON.parse(r.content[0].text) as { ok?: boolean; error?: string; [k: string]: unknown };
41
+ }
42
+
43
+ function cleanup() {
44
+ for (const t of ["node_daemon_bindings", "node_create_requests", "nodes", "network_members"]) {
45
+ try { db.run(`DELETE FROM ${t} WHERE network_id = ?1`, [NET]); } catch {}
46
+ }
47
+ for (const n of [NET, NET_OTHER, NET_DAEMON]) {
48
+ try { db.run("DELETE FROM networks WHERE network_id = ?1", [n]); } catch {}
49
+ }
50
+ try { db.run("DELETE FROM users WHERE user_id = ?1", [OWNER]); } catch {}
51
+ }
52
+
53
+ function node(node_id: string, alias: string, snapshot: Record<string, unknown> | null) {
54
+ db.run(
55
+ `INSERT INTO nodes (node_id, node_name, alias, network_id, runtime, model, channels, config_snapshot,
56
+ hostname, created_at, updated_at, lifecycle_state)
57
+ VALUES (?1, ?2, ?2, ?3, 'opencode-cli', 'm', '[]', ?4, 'host-x', datetime('now'), datetime('now'), 'active')`,
58
+ [node_id, alias, NET, snapshot ? JSON.stringify(snapshot) : null],
59
+ );
60
+ }
61
+
62
+ function seed() {
63
+ cleanup();
64
+ db.run("INSERT INTO users (user_id, username, password_hash, role, created_at) VALUES (?1, ?1, 'x', 'user', datetime('now'))", [OWNER]);
65
+ db.run("INSERT INTO networks (network_id, network_name, owner_id, created_at) VALUES (?1, ?1, ?2, datetime('now'))", [NET, OWNER]);
66
+ db.run("INSERT INTO network_members (user_id, network_id, role, joined_at) VALUES (?1, ?2, 'owner', datetime('now'))", [OWNER, NET]);
67
+ // 两个「不属于我」的网络:NET_OTHER 我完全不在里面;NET_DAEMON 里放一台别的网络的 daemon
68
+ for (const n of [NET_OTHER, NET_DAEMON]) {
69
+ db.run("INSERT INTO networks (network_id, network_name, owner_id, created_at) VALUES (?1, ?1, ?2, datetime('now'))", [n, OWNER]);
70
+ }
71
+ node(DAEMON, "10th-daemon", { role: "host_supervisor" });
72
+ node(ADOPTED, "10th-adopted", null);
73
+ // adopted 的判据:有 **active** binding,且不是 created(没有 cr_ 记录)
74
+ db.run(
75
+ `INSERT INTO node_daemon_bindings (request_id, network_id, node_id, daemon_node_id, workdir,
76
+ requested_by, status, created_at, updated_at)
77
+ VALUES ('ndb_10th', ?1, ?2, ?3, '/tmp', ?4, 'active', ?5, ?5)`,
78
+ [NET, ADOPTED, DAEMON, OWNER, Date.now()],
79
+ );
80
+ }
81
+
82
+ beforeEach(seed);
83
+ afterAll(cleanup);
84
+
85
+ describe("#3309 restart_node / start_node 的两条拒绝", () => {
86
+ test("adopted 节点(binding 证明的是 stop/start 授权)⇒ restart 必须拒", async () => {
87
+ const r = await call("restart_node", { node_id: ADOPTED });
88
+ expect(r.ok).toBe(false);
89
+ expect(r.error).toBe("adopted_restart_requires_daemon");
90
+ // 提示必须给出**替代动作**(Stop → Start),否则读的人只知道被拒。
91
+ expect(String(r.message)).toContain("Stop");
92
+ });
93
+
94
+ test("反向:supervisor 节点(created/role=host_supervisor)不会被这条挡", async () => {
95
+ const r = await call("restart_node", { node_id: DAEMON });
96
+ // 会不会成功取决于后续的生命周期校验,但**不该**是 adopted 这条。
97
+ expect(r.error).not.toBe("adopted_restart_requires_daemon");
98
+ });
99
+
100
+ test("start_node 传一个我不属于的 network_id ⇒ forbidden_cross_tenant(scope.denied)", async () => {
101
+ // 先让 child→daemon 可解析,否则会先撞 daemon_not_resolvable(我上一轮就撞过)。
102
+ db.run(
103
+ `INSERT INTO node_create_requests (request_id, daemon_node_id, child_name, network_id, runtime, model,
104
+ flags_json, env_keys, status, created_at, created_by_token)
105
+ VALUES ('cr_lc_child_x', ?1, 'lc-child-x', ?2, 'opencode-cli', NULL, '{}', '[]', 'succeeded', ?3, 'tok_x')`,
106
+ [DAEMON, NET, Date.now()],
107
+ );
108
+ const r = await call("start_node", { node_id: "node_lc_child_x", network_id: NET_OTHER });
109
+ expect(r.ok).toBe(false);
110
+ expect(r.error).toBe("forbidden_cross_tenant");
111
+ });
112
+
113
+ test("stop_node:daemon 与 child 分属不同网络 ⇒ daemon_cross_tenant(SEC-1 加固)", async () => {
114
+ // 这个状态正常流程造不出来(代码注释也这么写:shouldn't be possible in normal flow),
115
+ // 所以这条测的是**加固分支本身**:库被写坏时它必须拒绝,而不是跨租户操作。
116
+ // 夹具:child 在 NET,daemon 在 NET_DAEMON,且 create 记录把两者绑在一起。
117
+ node(DAEMON_OTHER_NET, "10th-daemon-other", null);
118
+ db.run("UPDATE nodes SET network_id = ?1 WHERE node_id = ?2", [NET_DAEMON, DAEMON_OTHER_NET]);
119
+ node("node_lc_child_2", "10th-child-2", null);
120
+ db.run(
121
+ `INSERT INTO node_create_requests (request_id, daemon_node_id, child_name, network_id, runtime, model,
122
+ flags_json, env_keys, status, created_at, created_by_token)
123
+ VALUES ('cr_lc_child_2', ?1, 'lc-child-2', ?2, 'opencode-cli', NULL, '{}', '[]', 'succeeded', ?3, 'tok_x')`,
124
+ [DAEMON_OTHER_NET, NET, Date.now()],
125
+ );
126
+ const r = await call("stop_node", { node_id: "node_lc_child_2" });
127
+ expect(r.ok).toBe(false);
128
+ expect(r.error).toBe("daemon_cross_tenant");
129
+ });
130
+
131
+ test("start_node 对不存在的 node ⇒ **第三次值** daemon_not_resolvable(不是我猜的两个)", async () => {
132
+ // 我原本以为这里是 forbidden_cross_tenant 或 node_not_found —— 实测都不是。
133
+ // 这是本组测试里唯一一次「期望值被真实调用纠正」:猜错的那个值(daemon_not_resolvable)
134
+ // 是一个此前没人写过的形状,而它恰好说明 start_node 的**第一道**门是「能不能解析出 daemon」,
135
+ // 而不是「这个 node 存不存在」。
136
+ const r = await call("start_node", { node_id: "node_not_in_my_networks" });
137
+ expect(r.ok).toBe(false);
138
+ expect(r.error).toBe("daemon_not_resolvable");
139
+ expect(r.error).not.toBe("node_not_found");
140
+ });
141
+
142
+ test("两条载荷都没有 code 字段(现状,不是契约)", async () => {
143
+ const replies = [await call("restart_node", { node_id: ADOPTED }), await call("start_node", { node_id: "node_nope" })];
144
+ for (const r of replies) {
145
+ expect(r.ok).toBe(false);
146
+ expect(Object.prototype.hasOwnProperty.call(r, "code")).toBe(false);
147
+ }
148
+ });
149
+ });
@@ -0,0 +1,108 @@
1
+ // #3309 读数覆盖第七批 —— 两个 error 字面量此前在测试里一次都没出现过:
2
+ //
3
+ // list_tasks : durable_cursor_required
4
+ // ack_inbox : message not found or already acknowledged
5
+ //
6
+ // 两条都是「调用协议用错了」,而不是「权限/状态不对」:
7
+ // durable_cursor_required ⇒ 打开了「按序号读终态日志」这个模式,却没给游标
8
+ // (这只在 durable_terminal_cursor=true 时才要求,
9
+ // 所以它是一条**条件性必需参数**的错误)
10
+ // already acknowledged ⇒ 这条消息已经被 ack 过(或 id 根本不在你的待办里)
11
+ //
12
+ // ⚠ 故意没测 `ack_inbox` 的第二个出口 "message not found or not yours":
13
+ // 它只在「SELECT 找到了、UPDATE 影响 0 行」时发生,也就是**并发**下另一个
14
+ // ack 抢先提交的那一刻。本仓没有可注入的并发点,造一个不算真。
15
+ import { afterAll, beforeEach, describe, expect, test } from "bun:test";
16
+ import { db } from "./db.js";
17
+ import { McpServer } from "@modelcontextprotocol/sdk/server/mcp.js";
18
+ import { registerTools } from "./tools.js";
19
+
20
+ const NET = "net_7th_err";
21
+ const USER = "u_7th_user";
22
+ const ALIAS = "7th-node";
23
+
24
+ type ToolHandler = (args: any) => Promise<{ content: Array<{ type: "text"; text: string }> }>;
25
+
26
+ function handlers(): Record<string, ToolHandler> {
27
+ const server = new McpServer({ name: "t", version: "0" }) as any;
28
+ const out: Record<string, ToolHandler> = {};
29
+ const orig = server.tool.bind(server);
30
+ server.tool = (n: string, d: string, s: any, h: ToolHandler) => { out[n] = h; return orig(n, d, s, h); };
31
+ registerTools(server, undefined, NET, USER, ALIAS, false, null);
32
+ return out;
33
+ }
34
+
35
+ async function call(name: string, args: Record<string, unknown>) {
36
+ const r = await handlers()[name](args);
37
+ return JSON.parse(r.content[0].text) as { ok?: boolean; error?: string; [k: string]: unknown };
38
+ }
39
+
40
+ function cleanup() {
41
+ try { db.run("DELETE FROM inbox WHERE network_id = ?1", [NET]); } catch {}
42
+ try { db.run("DELETE FROM network_members WHERE network_id = ?1", [NET]); } catch {}
43
+ try { db.run("DELETE FROM networks WHERE network_id = ?1", [NET]); } catch {}
44
+ try { db.run("DELETE FROM users WHERE user_id = ?1", [USER]); } catch {}
45
+ }
46
+
47
+ function seed() {
48
+ cleanup();
49
+ db.run("INSERT INTO users (user_id, username, password_hash, role, created_at) VALUES (?1, ?1, 'x', 'user', datetime('now'))", [USER]);
50
+ db.run("INSERT INTO networks (network_id, network_name, owner_id, created_at) VALUES (?1, ?1, ?2, datetime('now'))", [NET, USER]);
51
+ db.run("INSERT INTO network_members (user_id, network_id, role, joined_at) VALUES (?1, ?2, 'owner', datetime('now'))", [USER, NET]);
52
+ }
53
+
54
+ function seedInbox(acked: number) {
55
+ db.run(
56
+ `INSERT INTO inbox (id, session_name, type, content, created_at, acked, network_id)
57
+ VALUES ('inbox_7th_1', ?1, 'message', 'hello', ?2, ?3, ?4)`,
58
+ [ALIAS, Date.now(), acked, NET],
59
+ );
60
+ }
61
+
62
+ beforeEach(seed);
63
+ afterAll(cleanup);
64
+
65
+ describe("#3309 list_tasks / ack_inbox 的错误值域", () => {
66
+ test("durable_terminal_cursor=true 但没给 durable_cursor ⇒ durable_cursor_required", async () => {
67
+ const r = await call("list_tasks", { durable_terminal_cursor: true });
68
+ expect(r.ok).toBe(false);
69
+ expect(r.error).toBe("durable_cursor_required");
70
+ });
71
+
72
+ test("不给 durable_terminal_cursor 时不要求游标(条件性必需)", async () => {
73
+ // ⚠ 本 harness 直接调 handler,**绕过了 zod** ⇒ `.default(20)` 不会生效。
74
+ // 第一次没给 limit,SQL 里 `LIMIT ?` 绑到 undefined ⇒ SQLITE_MISMATCH。
75
+ // 那是夹具的事,不是产品的事 —— 所以这里显式补上默认值。
76
+ const r = await call("list_tasks", { limit: 20 });
77
+ // 这条不是为了「成功」,而是为了证明上一条是**条件**触发的:
78
+ // 若改成无条件要求游标,这条会红。
79
+ expect(r.ok).toBe(true);
80
+ });
81
+
82
+ test("ack 一条已 ack 过的消息 ⇒ message not found or already acknowledged", async () => {
83
+ seedInbox(1);
84
+ const r = await call("ack_inbox", { alias: ALIAS, message_id: "inbox_7th_1" });
85
+ expect(r.ok).toBe(false);
86
+ expect(r.error).toBe("message not found or already acknowledged");
87
+ });
88
+
89
+ test("ack 一个根本不存在的 id ⇒ 同一句(两种成因**故意**不区分)", async () => {
90
+ seedInbox(0);
91
+ const r = await call("ack_inbox", { alias: ALIAS, message_id: "inbox_7th_does_not_exist" });
92
+ expect(r.ok).toBe(false);
93
+ // 「没见过这个 id」与「已经 ack 过」对调用方是同一种处置:不要重试。
94
+ // 而服务端**不区分**它们是有意的(避免用错误码探测别人有没有这条消息)。
95
+ expect(r.error).toBe("message not found or already acknowledged");
96
+ });
97
+
98
+ test("两条载荷都没有 code 字段(现状,不是契约)", async () => {
99
+ const replies = [
100
+ await call("list_tasks", { durable_terminal_cursor: true, limit: 20 }),
101
+ await call("ack_inbox", { alias: ALIAS, message_id: "inbox_7th_nope" }),
102
+ ];
103
+ for (const r of replies) {
104
+ expect(r.ok).toBe(false);
105
+ expect(Object.prototype.hasOwnProperty.call(r, "code")).toBe(false);
106
+ }
107
+ });
108
+ });
@@ -40,6 +40,7 @@ function cleanup() {
40
40
  try { db.run("DELETE FROM users WHERE user_id LIKE 'u_lhs_%'"); } catch {}
41
41
  }
42
42
 
43
+ // Each case starts empty; plain INSERT keeps these fixtures portable to PostgreSQL.
43
44
  beforeEach(cleanup);
44
45
  afterAll(cleanup);
45
46
 
@@ -52,7 +53,7 @@ function seedUser(user_id: string) {
52
53
  }
53
54
  function seedNetwork(net_id: string, owner_id = "u_lhs_owner") {
54
55
  db.run(
55
- `INSERT OR REPLACE INTO networks (network_id, network_name, owner_id, created_at)
56
+ `INSERT INTO networks (network_id, network_name, owner_id, created_at)
56
57
  VALUES (?1, ?2, ?3, datetime('now'))`,
57
58
  [net_id, net_id, owner_id],
58
59
  );
@@ -81,7 +82,7 @@ function seedDaemon(opts: {
81
82
  allowed_secret_keys: opts.secrets ?? [],
82
83
  });
83
84
  db.run(
84
- `INSERT OR REPLACE INTO nodes (
85
+ `INSERT INTO nodes (
85
86
  node_id, node_name, alias, network_id,
86
87
  runtimes_supported, allowed_secret_keys,
87
88
  config_snapshot, hostname,
@@ -95,14 +96,14 @@ function seedDaemon(opts: {
95
96
  if (opts.sessionAgeMs !== undefined) {
96
97
  const ts = new Date(Date.now() - opts.sessionAgeMs).toISOString().replace("T", " ").replace(/\..+/, "");
97
98
  db.run(
98
- `INSERT OR REPLACE INTO sessions (resume_id, alias, network_id, last_seen_at, status, cpu_cores, mem_total_gb, ip)
99
+ `INSERT INTO sessions (resume_id, alias, network_id, last_seen_at, status, cpu_cores, mem_total_gb, ip)
99
100
  VALUES (?1, ?2, ?3, ?4, 'idle', 8, 16, '10.0.0.5')`,
100
101
  [`s_${node_id}`, opts.alias, opts.network_id, ts],
101
102
  );
102
103
  }
103
104
  if (opts.mintToken !== false && !opts.tokenDeleted) {
104
105
  db.run(
105
- `INSERT OR REPLACE INTO api_tokens (token_id, user_id, network_id, scope, name, token_hash, expires_at, revoked_at)
106
+ `INSERT INTO api_tokens (token_id, user_id, network_id, scope, name, token_hash, expires_at, revoked_at)
106
107
  VALUES (?1, ?2, ?3, 'network', ?4, ?5, NULL, ?6)`,
107
108
  [`tok_${node_id}`, `u_seed_${node_id}`, opts.network_id, `node:${opts.alias}`,
108
109
  `hash_${node_id}`,
@@ -180,6 +181,16 @@ describe("list_host_supervisors HANDLER tests (RFC-026 §9.2, PR2 v2)", () => {
180
181
  const handler = buildToolHandler(userA);
181
182
  const reply = await callList(handler, { network_id: NET_ALPHA });
182
183
  expect(reply.ok).toBe(true);
184
+ // 2026-10-31 —— **精确键集**(#3171):这条响应此前只断言了 daemons[].alias,
185
+ // 于是「多给一个顶层键」不会被发现 —— 而这是个按网络隔离的列表,多给一格就是泄露。
186
+ // 实际三键(我第一版漏了 count —— 断言当场纠正)。
187
+ // ⚠️ 这条预期值来自**实现**(读实际响应),不是来自规格 —— 它是变更探测器,不是契约。
188
+ // 契约来源是 RFC-026 §P2-A 的验收行(`count=2`)与它的示例;
189
+ // 2026-10-31 实测发现**两份不一致**(示例漏了 count),已把示例补上。
190
+ // ⇒ 判据:一条键集断言的依据必须能指到「哪一份规格/哪一次观测」;
191
+ // 指不到,它只能防变化,不能证明正确。
192
+ expect(Object.keys(reply).sort()).toEqual(["count", "daemons", "ok"]);
193
+ expect((reply as any).count).toBe(2); // 与 RFC §P2-A 的验收行同值
183
194
  const aliases = (reply.daemons ?? []).map(d => d.alias).sort();
184
195
  expect(aliases).toEqual(["alpha-daemon-1", "alpha-daemon-2"]);
185
196
  });