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

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
Files changed (446) hide show
  1. package/README.md +120 -3
  2. package/bin/commhub.ts +93 -9
  3. package/build-info.json +7 -0
  4. package/package.json +10 -8
  5. package/src/ack-create-request-transport.test.ts +182 -0
  6. package/src/ack-create-request.test.ts +52 -8
  7. package/src/admin-delete-network-http.test.ts +229 -0
  8. package/src/admin-networks-http.test.ts +88 -0
  9. package/src/adoption-candidates-http.test.ts +140 -0
  10. package/src/adoption-candidates.ts +158 -0
  11. package/src/agent-access-batch.test.ts +210 -0
  12. package/src/agent-access.ts +585 -0
  13. package/src/agent-acl-groups-http.test.ts +247 -0
  14. package/src/agent-acl-http.test.ts +691 -0
  15. package/src/agent-acl-slice3-http.test.ts +885 -0
  16. package/src/agent-department-grants.test.ts +129 -0
  17. package/src/agent-department-http.test.ts +215 -0
  18. package/src/agent-groups-perf.test.ts +223 -0
  19. package/src/agent-notice.ts +48 -0
  20. package/src/agent-team-whoami-http.test.ts +98 -0
  21. package/src/agent-teams-http.test.ts +330 -0
  22. package/src/agent-teams.ts +244 -0
  23. package/src/alias-baseline-2571.test.ts +162 -0
  24. package/src/alias-baseline.ts +113 -0
  25. package/src/alias-filter.test.ts +72 -0
  26. package/src/alias-filter.ts +42 -0
  27. package/src/api-host-supervisors-can-create-nodes.test.ts +350 -0
  28. package/src/api-host-supervisors-fallback.test.ts +6 -7
  29. package/src/api-host-supervisors-runtime-readiness.test.ts +195 -0
  30. package/src/api-nodes-shape.test.ts +131 -4
  31. package/src/auth-abuse-counters.test.ts +144 -0
  32. package/src/auth-abuse-counters.ts +122 -0
  33. package/src/auth-layer-shape.test.ts +105 -0
  34. package/src/auth-password-change-cli-tokens-http.test.ts +423 -0
  35. package/src/auth-sessions-http.test.ts +260 -0
  36. package/src/auth-validate.test.ts +5 -1
  37. package/src/auth-weak-password-login.test.ts +176 -0
  38. package/src/auth.ts +641 -68
  39. package/src/backfill-node-ids-2664.test.ts +128 -0
  40. package/src/binding-generation-http.test.ts +141 -0
  41. package/src/blocked-exit-on-reply.test.ts +122 -0
  42. package/src/broadcast-fanout-2721.test.ts +149 -0
  43. package/src/broadcast-fanout.ts +117 -0
  44. package/src/build-commit-report-http.test.ts +128 -0
  45. package/src/build-info.test.ts +60 -0
  46. package/src/build-info.ts +85 -0
  47. package/src/chain-attempt-dedup.test.ts +447 -0
  48. package/src/clip.test.ts +36 -0
  49. package/src/clip.ts +48 -0
  50. package/src/clone-node.test.ts +269 -0
  51. package/src/clone-node.ts +289 -0
  52. package/src/codex-config-flags.ts +77 -0
  53. package/src/codex-fork-contract.ts +23 -0
  54. package/src/codex-fork-migration.test.ts +38 -0
  55. package/src/commhub-bin-args.test.ts +85 -0
  56. package/src/config-apply-validate.test.ts +188 -1
  57. package/src/config-apply-validate.ts +222 -3
  58. package/src/cors-origins.test.ts +73 -0
  59. package/src/create-node-blocked-gate.test.ts +365 -0
  60. package/src/create-node-error-domain.test.ts +127 -0
  61. package/src/create-node-network-id.test.ts +91 -0
  62. package/src/create-node-tool-schema.test.ts +49 -0
  63. package/src/create-node-unicode-name.test.ts +126 -0
  64. package/src/create-node-validate.test.ts +199 -7
  65. package/src/create-node-validate.ts +232 -15
  66. package/src/create-node-workdir.test.ts +298 -0
  67. package/src/create-node.ts +88 -23
  68. package/src/daemon-provider-snapshots.test.ts +453 -0
  69. package/src/daemon-provider-snapshots.ts +327 -0
  70. package/src/daemon-token-owner-http.test.ts +346 -0
  71. package/src/dashboard-slash-routing-http.test.ts +109 -0
  72. package/src/db-adapter-guard.test.ts +148 -0
  73. package/src/db-adapter-translate.test.ts +128 -0
  74. package/src/db-adapter.ts +377 -91
  75. package/src/db-timestamp.test.ts +38 -0
  76. package/src/db-timestamp.ts +15 -0
  77. package/src/db.ts +1298 -153
  78. package/src/delivered-without-push.test.ts +140 -0
  79. package/src/department-groups-http.test.ts +209 -0
  80. package/src/department-groups-sync-http.test.ts +328 -0
  81. package/src/department-groups.ts +434 -0
  82. package/src/department-heads-http.test.ts +350 -0
  83. package/src/department-heads.ts +226 -0
  84. package/src/departments-agent-count.test.ts +139 -0
  85. package/src/departments-http.test.ts +185 -0
  86. package/src/departments-mcp-error-domain.test.ts +135 -0
  87. package/src/departments-mcp.test.ts +128 -0
  88. package/src/departments.ts +318 -0
  89. package/src/desktop-message-seam.test.ts +150 -0
  90. package/src/desktop-message.test.ts +368 -0
  91. package/src/dm-file-scope-http.test.ts +227 -0
  92. package/src/empty-node-sweeper.test.ts +104 -0
  93. package/src/empty-node-sweeper.ts +88 -0
  94. package/src/env-transport-gate-http.test.ts +240 -0
  95. package/src/env-transport-gate.ts +80 -0
  96. package/src/env-transport-policy.ts +56 -0
  97. package/src/etag-of.test.ts +57 -0
  98. package/src/event-loop-lag.test.ts +180 -0
  99. package/src/event-loop-lag.ts +201 -0
  100. package/src/expiry-counters.test.ts +187 -0
  101. package/src/expiry-counters.ts +227 -0
  102. package/src/expiry-evidence-db.test.ts +103 -0
  103. package/src/ext-token-shared.test.ts +60 -0
  104. package/src/ext-validation-regression.test.ts +10 -17
  105. package/src/external-schedule-edits-http.test.ts +321 -0
  106. package/src/external-schedule-edits-timestamps.test.ts +64 -0
  107. package/src/external-schedule-edits.ts +327 -0
  108. package/src/file-download-authz-dev-open.test.ts +1 -1
  109. package/src/file-download-authz.test.ts +25 -4
  110. package/src/file-download-date-bucket.test.ts +1 -1
  111. package/src/file-network-scope-dev-open.test.ts +1 -1
  112. package/src/file-network-scope.test.ts +7 -6
  113. package/src/group-membership-events-http.test.ts +264 -0
  114. package/src/group-messages-http.test.ts +483 -0
  115. package/src/group-messages.ts +297 -0
  116. package/src/health-anon-readers.ts +67 -0
  117. package/src/health-host-disk-2756.test.ts +71 -0
  118. package/src/health-identity-root.test.ts +98 -0
  119. package/src/health-redaction.test.ts +1599 -7
  120. package/src/health-status-reasons.test.ts +84 -0
  121. package/src/host-supervisor-identity-http.test.ts +152 -0
  122. package/src/host-supervisor-identity.ts +92 -0
  123. package/src/host-supervisors-daemon-version.test.ts +137 -0
  124. package/src/http-gzip.test.ts +94 -0
  125. package/src/http-gzip.ts +112 -0
  126. package/src/hub-catalog-read-http.test.ts +664 -0
  127. package/src/hub-provider-config.test.ts +166 -0
  128. package/src/hub-provider-config.ts +202 -0
  129. package/src/hub-timestamp.test.ts +38 -0
  130. package/src/hub-timestamp.ts +27 -0
  131. package/src/human-dm.ts +215 -0
  132. package/src/human-inbox.ts +42 -0
  133. package/src/inbox-caller.ts +49 -0
  134. package/src/inbox-count-sse.test.ts +318 -0
  135. package/src/inbox-count.ts +29 -0
  136. package/src/index.ts +6 -2
  137. package/src/license-state.test.ts +105 -0
  138. package/src/license-state.ts +48 -0
  139. package/src/lifecycle-error-domain.test.ts +149 -0
  140. package/src/list-ack-error-domain.test.ts +108 -0
  141. package/src/list-host-supervisors.test.ts +15 -4
  142. package/src/list-tasks-omit-default.test.ts +84 -0
  143. package/src/list-tasks-since-last.test.ts +100 -0
  144. package/src/list-tasks-since.test.ts +104 -0
  145. package/src/mcp-context-cost-http.test.ts +127 -0
  146. package/src/mcp-inflight.test.ts +92 -0
  147. package/src/mcp-inflight.ts +38 -0
  148. package/src/mcp-projects-events-http.test.ts +168 -0
  149. package/src/mcp-route-label-http.test.ts +120 -0
  150. package/src/mcp-write-network-resolution.test.ts +21 -0
  151. package/src/member-audit-network-id-http.test.ts +93 -0
  152. package/src/member-presence-http.test.ts +210 -0
  153. package/src/messages-ack-by-agent-http.test.ts +142 -0
  154. package/src/migrate-sqlite-to-pg.test.ts +47 -0
  155. package/src/migrate-sqlite-to-pg.ts +263 -0
  156. package/src/model-auth-notify-http.test.ts +181 -0
  157. package/src/model-auth-notify.ts +116 -0
  158. package/src/network-name-http.test.ts +75 -0
  159. package/src/network-quota-config.test.ts +100 -0
  160. package/src/network-rules-http.test.ts +169 -0
  161. package/src/network-rules.ts +129 -0
  162. package/src/network-scope.ts +222 -3
  163. package/src/network-token-membership-http.test.ts +186 -0
  164. package/src/node-alias-control.ts +12 -0
  165. package/src/node-attrs.test.ts +47 -2
  166. package/src/node-caller-identity-http.test.ts +1108 -0
  167. package/src/node-config-last-update.test.ts +126 -0
  168. package/src/node-config-last-update.ts +107 -0
  169. package/src/node-create-request-status-http.test.ts +105 -0
  170. package/src/node-daemon-bindings.test.ts +142 -0
  171. package/src/node-daemon-bindings.ts +135 -0
  172. package/src/node-failure-alert.test.ts +150 -0
  173. package/src/node-failure-alert.ts +177 -0
  174. package/src/node-files-transport.test.ts +350 -0
  175. package/src/node-health-codex-login.test.ts +120 -0
  176. package/src/node-health-dispatch-http.test.ts +373 -0
  177. package/src/node-health-guard-origin.test.ts +98 -0
  178. package/src/node-health-guard.ts +121 -0
  179. package/src/node-health-passthrough.test.ts +115 -0
  180. package/src/node-health-store.ts +101 -0
  181. package/src/node-id-alias.test.ts +190 -0
  182. package/src/node-identity-conflict-http.test.ts +269 -0
  183. package/src/node-identity-conflict.ts +142 -0
  184. package/src/node-identity-mismatch.test.ts +74 -0
  185. package/src/node-in-flight-tasks.ts +31 -0
  186. package/src/node-lifecycle-controllable.test.ts +64 -0
  187. package/src/node-lifecycle-controllable.ts +53 -0
  188. package/src/node-lifecycle-read-http.test.ts +257 -0
  189. package/src/node-lifecycle-read.ts +124 -0
  190. package/src/node-logs-transport.test.ts +266 -0
  191. package/src/node-peer-allowlist.test.ts +114 -0
  192. package/src/node-permissions-http.test.ts +901 -0
  193. package/src/node-permissions.ts +496 -0
  194. package/src/node-request-retention.test.ts +281 -0
  195. package/src/node-request-retention.ts +120 -0
  196. package/src/node-secret-rest-http.test.ts +190 -0
  197. package/src/node-secret-vault-inject.test.ts +132 -0
  198. package/src/node-security-write-gate.test.ts +72 -0
  199. package/src/node-serviceability.test.ts +86 -0
  200. package/src/node-serviceability.ts +124 -0
  201. package/src/node-session-control-http.test.ts +310 -0
  202. package/src/node-session-control.ts +258 -0
  203. package/src/node-skills-transport.test.ts +212 -0
  204. package/src/node-token-identity.ts +35 -0
  205. package/src/node-token-ownership.ts +51 -0
  206. package/src/node-token-privilege-http.test.ts +224 -0
  207. package/src/node-token-usage.test.ts +90 -0
  208. package/src/node-token-usage.ts +164 -0
  209. package/src/not-found-api-http.test.ts +67 -0
  210. package/src/observer-avatar-http.test.ts +103 -10
  211. package/src/observer-push.test.ts +76 -0
  212. package/src/opencode-catalog-report-http.test.ts +139 -0
  213. package/src/opencode-v2-catalog.test.ts +268 -0
  214. package/src/opencode-v2-catalog.ts +356 -0
  215. package/src/package-version-consistency.test.ts +25 -0
  216. package/src/parent-infer.test.ts +82 -0
  217. package/src/parent-infer.ts +110 -0
  218. package/src/parent-source-marker.test.ts +70 -0
  219. package/src/parent-source-orphan.test.ts +121 -0
  220. package/src/password-network-tokens.ts +25 -0
  221. package/src/peer-reply-atomic.test.ts +462 -0
  222. package/src/peer-reply-capability.test.ts +70 -0
  223. package/src/pg-worker.ts +87 -0
  224. package/src/poll-pacing.test.ts +74 -0
  225. package/src/poll-pacing.ts +123 -0
  226. package/src/probe-provider-error-domain.test.ts +145 -0
  227. package/src/project-dir-warn-clear-http.test.ts +132 -0
  228. package/src/project-viewer-can-http.test.ts +116 -0
  229. package/src/provider-skill-error-domain.test.ts +130 -0
  230. package/src/provider-tools-shape.test.ts +165 -0
  231. package/src/push.test.ts +20 -10
  232. package/src/push.ts +373 -9
  233. package/src/redact-tokens.test.ts +86 -0
  234. package/src/redact-tokens.ts +43 -0
  235. package/src/rejection-counters.test.ts +72 -0
  236. package/src/rejection-counters.ts +173 -0
  237. package/src/rename.ts +38 -10
  238. package/src/reply-target-derivation.test.ts +96 -0
  239. package/src/report-status-handover-capabilities-http.test.ts +124 -0
  240. package/src/report-status-host-schema.test.ts +235 -0
  241. package/src/report-status-resume-id-handover.test.ts +184 -0
  242. package/src/report-status-secret-keys.test.ts +140 -0
  243. package/src/require-explicit-test-db.ts +9 -0
  244. package/src/requirement-due-reminders-http.test.ts +620 -0
  245. package/src/requirement-due-reminders.ts +416 -0
  246. package/src/requirement-events-http.test.ts +318 -0
  247. package/src/requirement-events.test.ts +45 -0
  248. package/src/requirement-events.ts +144 -0
  249. package/src/requirement-notify.ts +165 -0
  250. package/src/requirement-participant-notify-http.test.ts +313 -0
  251. package/src/requirement-tag-ops-http.test.ts +454 -0
  252. package/src/requirement-tag-tree-http.test.ts +275 -0
  253. package/src/requirement-tag-tree.ts +127 -0
  254. package/src/requirement-tags.ts +102 -0
  255. package/src/requirements-abandoned-http.test.ts +236 -0
  256. package/src/requirements-assignee-drift.test.ts +154 -0
  257. package/src/requirements-comment-http.test.ts +174 -0
  258. package/src/requirements-completed-at-migration.test.ts +70 -0
  259. package/src/requirements-errors-mcp-http.test.ts +164 -0
  260. package/src/requirements-errors.ts +158 -0
  261. package/src/requirements-etag-http.test.ts +91 -0
  262. package/src/requirements-http.test.ts +709 -0
  263. package/src/requirements-last-event-http.test.ts +349 -0
  264. package/src/requirements-list-mcp-slim-http.test.ts +155 -0
  265. package/src/requirements-list-slim-http.test.ts +324 -0
  266. package/src/requirements-mcp.test.ts +180 -0
  267. package/src/requirements-migrate.ts +283 -0
  268. package/src/requirements-owner-strict-mcp-http.test.ts +145 -0
  269. package/src/requirements-people-http.test.ts +114 -0
  270. package/src/requirements-people-mcp-http.test.ts +231 -0
  271. package/src/requirements-people.ts +196 -0
  272. package/src/requirements-priority-lowest.test.ts +114 -0
  273. package/src/requirements-projects-network-echo.test.ts +57 -0
  274. package/src/requirements-projects-parent-http.test.ts +123 -0
  275. package/src/requirements-search-http.test.ts +182 -0
  276. package/src/requirements-search.test.ts +32 -0
  277. package/src/requirements-search.ts +145 -0
  278. package/src/requirements-seq-http.test.ts +193 -0
  279. package/src/requirements-seq-migration.test.ts +63 -0
  280. package/src/requirements-start-date.test.ts +125 -0
  281. package/src/requirements-stats-http.test.ts +357 -0
  282. package/src/requirements-stats.ts +195 -0
  283. package/src/requirements-status-participants-http.test.ts +222 -0
  284. package/src/requirements-upgrade-e2e.test.ts +126 -0
  285. package/src/requirements-upgrade-migration.test.ts +98 -0
  286. package/src/requirements.ts +2205 -0
  287. package/src/resolve-port.test.ts +57 -0
  288. package/src/resolve-port.ts +44 -0
  289. package/src/rest-alias-network-fallback-http.test.ts +123 -0
  290. package/src/rest-alias-network-fallback.test.ts +60 -0
  291. package/src/rest-alias-network-fallback.ts +65 -0
  292. package/src/rest-explicit-columns-http.test.ts +266 -0
  293. package/src/rest-identity.test.ts +130 -0
  294. package/src/rest-identity.ts +141 -0
  295. package/src/rest-projections.ts +72 -0
  296. package/src/rest-read-network-real-chain.test.ts +97 -0
  297. package/src/rest-write-network-resolution.test.ts +133 -0
  298. package/src/restart-readiness-http.test.ts +121 -0
  299. package/src/restricted-files.ts +76 -0
  300. package/src/retention-first-sweep-quiet.test.ts +31 -0
  301. package/src/retention.test.ts +100 -40
  302. package/src/retention.ts +423 -104
  303. package/src/route-callers-http.test.ts +120 -0
  304. package/src/route-timing.test.ts +218 -0
  305. package/src/route-timing.ts +262 -0
  306. package/src/rules-file-duplicate-alias.test.ts +234 -0
  307. package/src/rules-file-session-target.test.ts +207 -0
  308. package/src/rules-file-transport.test.ts +271 -0
  309. package/src/runtime-label.test.ts +22 -0
  310. package/src/runtime-label.ts +21 -0
  311. package/src/runtime-readiness.ts +90 -0
  312. package/src/schedule-agent-mcp-http.test.ts +486 -0
  313. package/src/schedule-agent.ts +252 -0
  314. package/src/schedule-starved.test.ts +92 -0
  315. package/src/schedule-starved.ts +114 -0
  316. package/src/scheduled-backoff-http.test.ts +203 -0
  317. package/src/scheduled-backoff.ts +64 -0
  318. package/src/scheduled-doorbell-nodeless-session.test.ts +134 -0
  319. package/src/scheduled-failure-backoff-2622.test.ts +145 -0
  320. package/src/scheduled-failure-code.test.ts +73 -0
  321. package/src/scheduled-failure-code.ts +105 -0
  322. package/src/scheduled-failures-http.test.ts +279 -0
  323. package/src/scheduled-failures.ts +425 -0
  324. package/src/scheduled-noprogress-backoff-2622.test.ts +163 -0
  325. package/src/scheduled-offline-backoff-probe.test.ts +56 -0
  326. package/src/scheduled-offline.test.ts +131 -0
  327. package/src/scheduled-offline.ts +66 -0
  328. package/src/scheduled-outcome-guidance-http.test.ts +139 -0
  329. package/src/scheduled-outcome-guidance.ts +9 -0
  330. package/src/scheduled-reply-unread-http.test.ts +212 -0
  331. package/src/scheduled-requirement-wake-http.test.ts +289 -0
  332. package/src/scheduled-requirement-wake.ts +125 -0
  333. package/src/scheduled-run-terminal.test.ts +290 -0
  334. package/src/scheduled-skip-blocking-task.test.ts +120 -0
  335. package/src/scheduled-skip-path-backoff-2622.test.ts +98 -0
  336. package/src/scheduled-stuck-http.test.ts +316 -0
  337. package/src/scheduled-stuck-notice-cap.test.ts +80 -0
  338. package/src/scheduled-stuck.ts +219 -0
  339. package/src/scheduled-tasks-http.test.ts +679 -0
  340. package/src/scheduled-tasks.ts +959 -0
  341. package/src/scheduled-work-outcome-http.test.ts +154 -0
  342. package/src/scheduled-work-outcome.ts +50 -0
  343. package/src/scoped-secrets.ts +167 -0
  344. package/src/secret-echo-negative-control.test.ts +118 -0
  345. package/src/send-dedup-request-id.test.ts +229 -0
  346. package/src/send-reply-agent-warning.test.ts +38 -38
  347. package/src/send-reply-alias-optional.test.ts +131 -0
  348. package/src/send-reply-attachments.test.ts +28 -7
  349. package/src/send_dedup.test.ts +54 -0
  350. package/src/send_dedup.ts +52 -6
  351. package/src/serve-error.test.ts +73 -0
  352. package/src/serve-error.ts +56 -0
  353. package/src/server.ts +4963 -377
  354. package/src/session-task-on-dispatch.ts +14 -0
  355. package/src/session-token-ownership-http.test.ts +122 -0
  356. package/src/shared/codex-inventory.ts +41 -0
  357. package/src/shared/daemon-provider-login.ts +31 -0
  358. package/src/shared/daemon-provider-snapshot.ts +52 -0
  359. package/src/shared/external-schedule-contract.ts +60 -0
  360. package/src/shared/node-name.test.ts +62 -0
  361. package/src/shared/node-name.ts +161 -0
  362. package/src/shared/probe-host-allowlist-drift.test.ts +45 -0
  363. package/src/shared/provider-application.ts +29 -0
  364. package/src/shared/provider-collection.ts +14 -0
  365. package/src/shared/provider-initialization.ts +8 -0
  366. package/src/shared/reserved-env-drift.test.ts +10 -0
  367. package/src/shared/scoped-secret-contract.ts +5 -0
  368. package/src/shared/task-content-limit-drift.test.ts +28 -0
  369. package/src/shared/task-content-limit.ts +25 -0
  370. package/src/side-thread-command-transport.test.ts +312 -0
  371. package/src/side-thread-command-transport.ts +318 -0
  372. package/src/side-thread-http-integration.test.ts +233 -0
  373. package/src/side-thread-http.ts +504 -0
  374. package/src/side-thread-production.test.ts +72 -0
  375. package/src/side-thread-production.ts +118 -0
  376. package/src/side-thread.test.ts +1067 -0
  377. package/src/side-thread.ts +2499 -0
  378. package/src/skillhub-http.test.ts +144 -0
  379. package/src/sqlite-close-checkpoint.test.ts +78 -0
  380. package/src/start-node.test.ts +265 -0
  381. package/src/start-request-error-domain.test.ts +182 -0
  382. package/src/start-skill-error-domain.test.ts +122 -0
  383. package/src/stats-versions-http.test.ts +65 -0
  384. package/src/status-alias-filter-http.test.ts +106 -0
  385. package/src/status-alias-resolver-http.test.ts +163 -0
  386. package/src/status-alias-resolver.ts +19 -0
  387. package/src/status-node-id-filter-http.test.ts +161 -0
  388. package/src/status-read-cache-http.test.ts +229 -0
  389. package/src/status-read-cache.ts +129 -0
  390. package/src/stop-delete-node.test.ts +567 -1
  391. package/src/task-access-http.test.ts +407 -0
  392. package/src/task-access.ts +420 -0
  393. package/src/task-activity.ts +60 -0
  394. package/src/task-auth-origin-http.test.ts +93 -0
  395. package/src/task-auth-origin.test.ts +24 -0
  396. package/src/task-auth-origin.ts +7 -0
  397. package/src/task-consumption.test.ts +508 -0
  398. package/src/task-diagnostic-http.test.ts +149 -0
  399. package/src/task-diagnostic.test.ts +115 -0
  400. package/src/task-diagnostic.ts +118 -0
  401. package/src/task-expiry-notice-http.test.ts +298 -0
  402. package/src/task-expiry-notice.ts +318 -0
  403. package/src/task-idempotency-mcp.test.ts +148 -0
  404. package/src/task-idempotency.test.ts +76 -0
  405. package/src/task-idempotency.ts +81 -0
  406. package/src/task-late-replies.ts +54 -0
  407. package/src/task-late-reply-http.test.ts +227 -0
  408. package/src/task-lifecycle-watcher-busy.test.ts +114 -0
  409. package/src/task-lifecycle-watcher.test.ts +209 -0
  410. package/src/task-lifecycle-watcher.ts +109 -0
  411. package/src/task-network-resolution-http.test.ts +140 -0
  412. package/src/task-not-found-error-domain.test.ts +114 -0
  413. package/src/task-offline-delivery-2668.test.ts +119 -0
  414. package/src/task-offline-delivery.ts +81 -0
  415. package/src/task-orphan-http.test.ts +287 -0
  416. package/src/task-orphan.ts +119 -0
  417. package/src/task-queue-ahead-http.test.ts +309 -0
  418. package/src/task-queue-ahead-scale.test.ts +236 -0
  419. package/src/task-queue-ahead.ts +186 -0
  420. package/src/task-rejection-log-http.test.ts +160 -0
  421. package/src/task-rejection-log.ts +61 -0
  422. package/src/task-sender-http.test.ts +143 -0
  423. package/src/task-stale-open-http.test.ts +292 -0
  424. package/src/task-stale-open.ts +103 -0
  425. package/src/tasks-pagination-http.test.ts +141 -0
  426. package/src/team-rules-status-http.test.ts +90 -0
  427. package/src/team-rules-status.test.ts +59 -0
  428. package/src/team-rules-status.ts +72 -0
  429. package/src/tmux-allowlist.test.ts +48 -0
  430. package/src/tool-audience-http.test.ts +248 -0
  431. package/src/tool-audience.ts +130 -0
  432. package/src/tools-list-json-schema.test.ts +94 -0
  433. package/src/tools.ts +4340 -386
  434. package/src/update-node-config-error-domain.test.ts +107 -0
  435. package/src/uploads-http.test.ts +6 -4
  436. package/src/uploads.ts +23 -4
  437. package/src/user-avatar-http.test.ts +74 -0
  438. package/src/user-avatar-image.ts +160 -0
  439. package/src/user-avatar-migration.test.ts +25 -0
  440. package/src/user-avatar-upload-http.test.ts +353 -0
  441. package/src/user-inbox-by-agent-http.test.ts +189 -0
  442. package/src/user-inbox-netid-notnull.test.ts +122 -0
  443. package/src/user-inbox-read-http.test.ts +223 -0
  444. package/src/user-inbox-schema.test.ts +54 -0
  445. package/src/version-stats.test.ts +66 -0
  446. package/src/version-stats.ts +109 -0
@@ -0,0 +1,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
  });
@@ -0,0 +1,84 @@
1
+ // #3119 —— 节点令牌没传 omit_stats 时,默认省略 stats。
2
+ //
3
+ // 为什么不给 since_last 设默认(同样重要,写在这里免得后来人"顺手"加上):
4
+ // list_tasks 同时被用来回答「我手上有哪些活」—— 那是个**全集**问题。
5
+ // 默认 since_last 会让「早就派给我、一直没动」的任务消失,节点据此得出「没活」。
6
+ // 那是把一个成本问题换成一个正确性问题,不划算。
7
+ //
8
+ // 判据三格:
9
+ // ① 节点令牌 + 不传 omit_stats ⇒ 没有 stats,且 stats_omitted:true
10
+ // ② 节点令牌 + 显式 false ⇒ stats 回来(默认不是强制)
11
+ // ③ 用户令牌 + 不传 ⇒ 与以前一致(有 stats)—— 看板要计数
12
+ import './require-explicit-test-db';
13
+ import { afterAll, beforeEach, describe, expect, test } from 'bun:test';
14
+ import { db } from './db';
15
+ import { registerTools } from './tools';
16
+ import { McpServer } from '@modelcontextprotocol/sdk/server/mcp.js';
17
+
18
+ const net = 'net_omit_defaults';
19
+ const nodeUser = 'u_omit_node';
20
+ const humanUser = 'u_omit_human';
21
+
22
+ function client(opts: { username: string; isNode: boolean }) {
23
+ const handlers: Record<string, any> = {};
24
+ const server = new McpServer({ name: 't-omit', version: '0' }) as any;
25
+ const tool = server.tool.bind(server);
26
+ server.tool = (name: string, desc: any, shape: any, handler: any) => { handlers[name] = handler; return tool(name, desc, shape, handler); };
27
+ registerTools(server, undefined, opts.isNode ? net : null, opts.username, opts.username, opts.isNode, opts.isNode ? 'tok_omit' : null);
28
+ return async (name: string, args: any = {}) => JSON.parse((await handlers[name](args)).content[0].text);
29
+ }
30
+
31
+ function cleanup() {
32
+ db.run("DELETE FROM tasks WHERE task_id LIKE 't_omit_%'");
33
+ db.run('DELETE FROM list_tasks_watermarks WHERE network_id=?1', [net]);
34
+ db.run('DELETE FROM nodes WHERE network_id=?1', [net]);
35
+ db.run('DELETE FROM network_members WHERE network_id=?1', [net]);
36
+ db.run('DELETE FROM api_tokens WHERE network_id=?1', [net]);
37
+ db.run('DELETE FROM networks WHERE network_id=?1', [net]);
38
+ db.run('DELETE FROM users WHERE user_id IN (?1, ?2)', [nodeUser, humanUser]);
39
+ }
40
+
41
+ beforeEach(() => {
42
+ cleanup();
43
+ for (const u of [nodeUser, humanUser]) {
44
+ db.run("INSERT INTO users(user_id,username,password_hash,role) VALUES(?1,?1,'x','user')", [u]);
45
+ db.run("INSERT INTO network_members(user_id,network_id,role) VALUES(?1,?2,'owner')", [u, net]);
46
+ db.run('INSERT INTO nodes(node_id,node_name,alias,network_id) VALUES(?1,?2,?2,?3)', [`n_${u}`, u, net]);
47
+ }
48
+ db.run('INSERT INTO networks(network_id,network_name,owner_id) VALUES(?1,?1,?2)', [net, humanUser]);
49
+ // 节点令牌:network token + bound_node_id,这样 callerTokenIsNetwork 路径成立
50
+ db.run("INSERT INTO api_tokens(token_id,user_id,network_id,scope,name,token_hash,bound_node_id) VALUES('tok_omit',?1,?2,'network','node',?3,?4)",
51
+ [nodeUser, net, 'hash_omit', `n_${nodeUser}`]);
52
+ db.run(`INSERT INTO tasks(task_id, from_name, to_name, status, content, created_at, network_id)
53
+ VALUES ('t_omit_1', 'peer', ?1, 'delivered', 'work', '2026-11-05 01:00:00', ?2)`, [nodeUser, net]);
54
+ });
55
+ afterAll(cleanup);
56
+
57
+ describe("#3119 节点令牌默认省略 stats", () => {
58
+ test("① 节点令牌 + 不传 ⇒ 无 stats,且明确 stats_omitted", async () => {
59
+ const call = client({ username: nodeUser, isNode: true });
60
+ const r = await call('list_tasks', { alias: nodeUser, network_id: net, limit: 20 });
61
+ expect(r.ok).toBe(true);
62
+ expect(r.stats).toBeUndefined();
63
+ expect(r.stats_omitted).toBe(true);
64
+ });
65
+
66
+ test("② 节点令牌 + 显式 false ⇒ stats 回来(默认不是强制)", async () => {
67
+ const call = client({ username: nodeUser, isNode: true });
68
+ const r = await call('list_tasks', { alias: nodeUser, network_id: net, limit: 20, omit_stats: false });
69
+ expect(Array.isArray(r.stats)).toBe(true);
70
+ });
71
+
72
+ test("③ 用户令牌 + 不传 ⇒ 与以前一致(有 stats)", async () => {
73
+ const call = client({ username: humanUser, isNode: false });
74
+ const r = await call('list_tasks', { alias: humanUser, network_id: net, limit: 20 });
75
+ expect(Array.isArray(r.stats)).toBe(true);
76
+ });
77
+
78
+ test("镜像否定:节点令牌默认**不**启用 since_last(否则「早就派给我」的任务会消失)", async () => {
79
+ const call = client({ username: nodeUser, isNode: true });
80
+ const r = await call('list_tasks', { alias: nodeUser, network_id: net, limit: 20 });
81
+ expect(r.since_from).toBeUndefined();
82
+ expect(r.tasks.map((t: any) => t.task_id)).toContain('t_omit_1');
83
+ });
84
+ });
@@ -0,0 +1,100 @@
1
+ // #3943 —— since_last:服务端水位,让「自上次以来新增」不需要客户端记时间。
2
+ //
3
+ // 为什么在服务端存而不是让调用方传:提示词那一招对本项无效(实测占比 19.1% → 50.3%),
4
+ // 而「记住上次返回的 server_time」是个状态,让每个调用方各自记,就必然有人记错或忘。
5
+ //
6
+ // 判据五格:
7
+ // ① 首次调用无水位 ⇒ 全量,且 since_from=null(不假装有水位)
8
+ // ② 再调一次 + 中间插入一条 ⇒ 只回那一条
9
+ // ③ 镜像:不传 since_last ⇒ 行为与 .268 逐字一致,且**不写**水位
10
+ // ④ 水位按 (network, caller) 隔离:A 调用者的水位不影响 B
11
+ // ⑤ since_last 与 created_since 同时给 ⇒ 明确报错(两个下界不混用)
12
+ import './require-explicit-test-db';
13
+ import { afterAll, beforeEach, describe, expect, test } from 'bun:test';
14
+ import { db } from './db';
15
+ import { registerTools } from './tools';
16
+ import { McpServer } from '@modelcontextprotocol/sdk/server/mcp.js';
17
+
18
+ const net = 'net_wm';
19
+ const userA = 'u_wm_a';
20
+ const userB = 'u_wm_b';
21
+
22
+ function client(username: string) {
23
+ const handlers: Record<string, any> = {};
24
+ const server = new McpServer({ name: 't-wm', version: '0' }) as any;
25
+ const tool = server.tool.bind(server);
26
+ server.tool = (name: string, desc: any, shape: any, handler: any) => { handlers[name] = handler; return tool(name, desc, shape, handler); };
27
+ registerTools(server, undefined, null, username, username, false, null);
28
+ return async (name: string, args: any = {}) => JSON.parse((await handlers[name](args)).content[0].text);
29
+ }
30
+
31
+ const insertTask = (id: string, toName: string, createdAt: string) => db.run(
32
+ `INSERT INTO tasks(task_id, from_name, to_name, status, content, created_at, network_id)
33
+ VALUES (?1, 'peer', ?2, 'delivered', 'work', ?3, ?4)`, [id, toName, createdAt, net]);
34
+
35
+ function cleanup() {
36
+ db.run("DELETE FROM tasks WHERE task_id LIKE 't_wm_%'");
37
+ db.run('DELETE FROM list_tasks_watermarks WHERE network_id=?1', [net]);
38
+ db.run('DELETE FROM nodes WHERE network_id=?1', [net]);
39
+ db.run('DELETE FROM network_members WHERE network_id=?1', [net]);
40
+ db.run('DELETE FROM networks WHERE network_id=?1', [net]);
41
+ db.run('DELETE FROM users WHERE user_id IN (?1, ?2)', [userA, userB]);
42
+ }
43
+
44
+ beforeEach(() => {
45
+ cleanup();
46
+ for (const u of [userA, userB]) {
47
+ db.run("INSERT INTO users(user_id,username,password_hash,role) VALUES(?1,?1,'x','user')", [u]);
48
+ db.run("INSERT INTO network_members(user_id,network_id,role) VALUES(?1,?2,'owner')", [u, net]);
49
+ // username 必须等于某 nodes/sessions 的 alias,否则受限成员过滤会把任务全挡掉
50
+ db.run('INSERT INTO nodes(node_id,node_name,alias,network_id) VALUES(?1,?2,?2,?3)', [`n_${u}`, u, net]);
51
+ }
52
+ db.run('INSERT INTO networks(network_id,network_name,owner_id) VALUES(?1,?1,?2)', [net, userA]);
53
+ insertTask('t_wm_1', userA, '2026-11-05 01:00:00');
54
+ insertTask('t_wm_2', userB, '2026-11-05 01:00:00');
55
+ });
56
+ afterAll(cleanup);
57
+
58
+ describe("#3943 list_tasks since_last(服务端水位)", () => {
59
+ test("① 首次调用无水位 ⇒ 全量,且 since_from=null", async () => {
60
+ const call = client(userA);
61
+ const r = await call('list_tasks', { alias: userA, network_id: net, since_last: true, omit_stats: true, limit: 20 });
62
+ expect(r.ok).toBe(true);
63
+ expect(r.tasks.map((t: any) => t.task_id)).toEqual(['t_wm_1']);
64
+ expect(r.since_from).toBeNull();
65
+ expect(typeof r.since_to).toBe('string');
66
+ });
67
+
68
+ test("② 中间插入一条 ⇒ 第二次只回它(旧的不再出现)", async () => {
69
+ const call = client(userA);
70
+ await call('list_tasks', { alias: userA, network_id: net, since_last: true, omit_stats: true, limit: 20 });
71
+ insertTask('t_wm_new', userA, '2099-01-01 00:00:00');
72
+ const r = await call('list_tasks', { alias: userA, network_id: net, since_last: true, omit_stats: true, limit: 20 });
73
+ expect(r.tasks.map((t: any) => t.task_id)).toEqual(['t_wm_new']);
74
+ expect(typeof r.since_from).toBe('string');
75
+ });
76
+
77
+ test("③ 镜像:不传 since_last ⇒ 全量、且**不写**水位", async () => {
78
+ const call = client(userA);
79
+ const r = await call('list_tasks', { alias: userA, network_id: net, omit_stats: true, limit: 20 });
80
+ expect(r.since_from).toBeUndefined();
81
+ const rows = db.all("SELECT network_id FROM list_tasks_watermarks WHERE network_id=?1", [net]);
82
+ expect(rows.length).toBe(0);
83
+ });
84
+
85
+ test("④ 水位按 (network, caller) 隔离:B 的水位不影响 A", async () => {
86
+ const a = client(userA), b = client(userB);
87
+ await a('list_tasks', { alias: userA, network_id: net, since_last: true, omit_stats: true, limit: 20 });
88
+ const rb = await b('list_tasks', { alias: userB, network_id: net, since_last: true, omit_stats: true, limit: 20 });
89
+ // B 是首次 ⇒ 全量(自己的任务),不能因为 A 已经有了水位就变成空
90
+ expect(rb.tasks.map((t: any) => t.task_id)).toEqual(['t_wm_2']);
91
+ expect(rb.since_from).toBeNull();
92
+ });
93
+
94
+ test("⑤ since_last 与 created_since 同时给 ⇒ 明确报错(两个下界不混用)", async () => {
95
+ const call = client(userA);
96
+ const r = await call('list_tasks', { alias: userA, network_id: net, since_last: true, created_since: '2026-11-05 00:00:00', omit_stats: true, limit: 20 });
97
+ expect(r.ok).toBe(false);
98
+ expect(r.error).toBe('created_since_and_since_last_are_exclusive');
99
+ });
100
+ });