@sleep2agi/commhub-server 0.9.0-preview.23 → 0.9.0-preview.230

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 (408) hide show
  1. package/README.md +129 -9
  2. package/bin/commhub.ts +93 -9
  3. package/package.json +7 -7
  4. package/src/ack-create-request-transport.test.ts +182 -0
  5. package/src/ack-create-request.test.ts +50 -7
  6. package/src/admin-delete-network-http.test.ts +228 -0
  7. package/src/admin-networks-http.test.ts +88 -0
  8. package/src/adoption-candidates-http.test.ts +137 -0
  9. package/src/adoption-candidates.ts +158 -0
  10. package/src/agent-access-batch.test.ts +210 -0
  11. package/src/agent-access.ts +487 -0
  12. package/src/agent-acl-groups-http.test.ts +247 -0
  13. package/src/agent-acl-http.test.ts +659 -0
  14. package/src/agent-acl-slice3-http.test.ts +654 -0
  15. package/src/agent-department-http.test.ts +215 -0
  16. package/src/agent-groups-perf.test.ts +223 -0
  17. package/src/agent-notice.ts +48 -0
  18. package/src/agent-team-whoami-http.test.ts +98 -0
  19. package/src/agent-teams-http.test.ts +330 -0
  20. package/src/agent-teams.ts +244 -0
  21. package/src/alias-baseline-2571.test.ts +162 -0
  22. package/src/alias-baseline.ts +113 -0
  23. package/src/alias-filter.test.ts +72 -0
  24. package/src/alias-filter.ts +42 -0
  25. package/src/api-host-supervisors-can-create-nodes.test.ts +350 -0
  26. package/src/api-host-supervisors-fallback.test.ts +6 -7
  27. package/src/api-host-supervisors-runtime-readiness.test.ts +195 -0
  28. package/src/api-nodes-shape.test.ts +95 -4
  29. package/src/auth-password-change-cli-tokens-http.test.ts +423 -0
  30. package/src/auth-sessions-http.test.ts +250 -0
  31. package/src/auth-validate.test.ts +5 -1
  32. package/src/auth-weak-password-login.test.ts +176 -0
  33. package/src/auth.ts +609 -51
  34. package/src/avatar-validate.test.ts +52 -2
  35. package/src/avatar-validate.ts +35 -1
  36. package/src/backfill-node-ids-2664.test.ts +128 -0
  37. package/src/binding-generation-http.test.ts +121 -0
  38. package/src/blocked-exit-on-reply.test.ts +122 -0
  39. package/src/broadcast-fanout-2721.test.ts +149 -0
  40. package/src/broadcast-fanout.ts +117 -0
  41. package/src/chain-attempt-dedup.test.ts +447 -0
  42. package/src/clip.test.ts +36 -0
  43. package/src/clip.ts +46 -0
  44. package/src/clone-node.test.ts +248 -0
  45. package/src/clone-node.ts +289 -0
  46. package/src/codex-config-flags.ts +77 -0
  47. package/src/codex-fork-contract.ts +23 -0
  48. package/src/codex-fork-migration.test.ts +38 -0
  49. package/src/commhub-bin-args.test.ts +85 -0
  50. package/src/config-apply-validate.test.ts +188 -1
  51. package/src/config-apply-validate.ts +222 -3
  52. package/src/cors-origins.test.ts +73 -0
  53. package/src/create-node-blocked-gate.test.ts +356 -0
  54. package/src/create-node-network-id.test.ts +91 -0
  55. package/src/create-node-tool-schema.test.ts +49 -0
  56. package/src/create-node-unicode-name.test.ts +120 -0
  57. package/src/create-node-validate.test.ts +199 -7
  58. package/src/create-node-validate.ts +232 -15
  59. package/src/create-node-workdir.test.ts +289 -0
  60. package/src/create-node.ts +88 -23
  61. package/src/daemon-provider-snapshots.test.ts +421 -0
  62. package/src/daemon-provider-snapshots.ts +327 -0
  63. package/src/daemon-token-owner-http.test.ts +236 -0
  64. package/src/dashboard-slash-routing-http.test.ts +109 -0
  65. package/src/db-adapter-guard.test.ts +148 -0
  66. package/src/db-adapter-translate.test.ts +128 -0
  67. package/src/db-adapter.ts +377 -91
  68. package/src/db-timestamp.test.ts +38 -0
  69. package/src/db-timestamp.ts +15 -0
  70. package/src/db.ts +1264 -153
  71. package/src/delivered-without-push.test.ts +140 -0
  72. package/src/department-groups-http.test.ts +209 -0
  73. package/src/department-groups-sync-http.test.ts +328 -0
  74. package/src/department-groups.ts +434 -0
  75. package/src/department-heads-http.test.ts +350 -0
  76. package/src/department-heads.ts +226 -0
  77. package/src/departments-agent-count.test.ts +132 -0
  78. package/src/departments-http.test.ts +185 -0
  79. package/src/departments-mcp.test.ts +128 -0
  80. package/src/departments.ts +318 -0
  81. package/src/desktop-message-seam.test.ts +150 -0
  82. package/src/desktop-message.test.ts +368 -0
  83. package/src/dm-file-scope-http.test.ts +178 -0
  84. package/src/empty-node-sweeper.test.ts +104 -0
  85. package/src/empty-node-sweeper.ts +88 -0
  86. package/src/env-transport-gate-http.test.ts +240 -0
  87. package/src/env-transport-gate.ts +80 -0
  88. package/src/env-transport-policy.ts +56 -0
  89. package/src/etag-of.test.ts +57 -0
  90. package/src/event-loop-lag.test.ts +180 -0
  91. package/src/event-loop-lag.ts +201 -0
  92. package/src/ext-token-shared.test.ts +60 -0
  93. package/src/ext-validation-regression.test.ts +131 -0
  94. package/src/external-schedule-edits-http.test.ts +321 -0
  95. package/src/external-schedule-edits-timestamps.test.ts +64 -0
  96. package/src/external-schedule-edits.ts +327 -0
  97. package/src/file-download-authz-dev-open.test.ts +1 -1
  98. package/src/file-download-authz.test.ts +73 -18
  99. package/src/file-download-date-bucket.test.ts +436 -0
  100. package/src/file-network-scope-dev-open.test.ts +97 -0
  101. package/src/file-network-scope.test.ts +732 -0
  102. package/src/group-membership-events-http.test.ts +264 -0
  103. package/src/group-messages-http.test.ts +482 -0
  104. package/src/group-messages.ts +297 -0
  105. package/src/health-anon-readers.ts +60 -0
  106. package/src/health-host-disk-2756.test.ts +71 -0
  107. package/src/health-redaction.test.ts +1721 -2
  108. package/src/host-supervisor-identity-http.test.ts +152 -0
  109. package/src/host-supervisor-identity.ts +92 -0
  110. package/src/host-supervisors-daemon-version.test.ts +137 -0
  111. package/src/http-gzip.test.ts +94 -0
  112. package/src/http-gzip.ts +112 -0
  113. package/src/hub-catalog-read-http.test.ts +409 -0
  114. package/src/hub-provider-config.test.ts +156 -0
  115. package/src/hub-provider-config.ts +170 -0
  116. package/src/hub-timestamp.test.ts +38 -0
  117. package/src/hub-timestamp.ts +27 -0
  118. package/src/human-dm.ts +215 -0
  119. package/src/human-inbox.ts +42 -0
  120. package/src/inbox-caller.ts +49 -0
  121. package/src/inbox-count-sse.test.ts +310 -0
  122. package/src/inbox-count.ts +29 -0
  123. package/src/index.ts +6 -2
  124. package/src/license-state.test.ts +56 -0
  125. package/src/license-state.ts +48 -0
  126. package/src/list-host-supervisors.test.ts +15 -4
  127. package/src/mcp-context-cost-http.test.ts +127 -0
  128. package/src/mcp-inflight.test.ts +92 -0
  129. package/src/mcp-inflight.ts +38 -0
  130. package/src/mcp-projects-events-http.test.ts +165 -0
  131. package/src/mcp-route-label-http.test.ts +120 -0
  132. package/src/mcp-write-network-resolution.test.ts +435 -0
  133. package/src/member-audit-network-id-http.test.ts +93 -0
  134. package/src/member-presence-http.test.ts +210 -0
  135. package/src/messages-ack-by-agent-http.test.ts +142 -0
  136. package/src/migrate-sqlite-to-pg.test.ts +47 -0
  137. package/src/migrate-sqlite-to-pg.ts +263 -0
  138. package/src/model-auth-notify-http.test.ts +181 -0
  139. package/src/model-auth-notify.ts +116 -0
  140. package/src/network-name-http.test.ts +75 -0
  141. package/src/network-rules-http.test.ts +169 -0
  142. package/src/network-rules.ts +129 -0
  143. package/src/network-scope.ts +276 -0
  144. package/src/network-token-membership-http.test.ts +139 -0
  145. package/src/node-alias-control.ts +12 -0
  146. package/src/node-attrs.test.ts +47 -2
  147. package/src/node-caller-identity-http.test.ts +1091 -0
  148. package/src/node-create-request-status-http.test.ts +105 -0
  149. package/src/node-daemon-bindings.test.ts +132 -0
  150. package/src/node-daemon-bindings.ts +135 -0
  151. package/src/node-failure-alert.test.ts +150 -0
  152. package/src/node-failure-alert.ts +177 -0
  153. package/src/node-files-transport.test.ts +344 -0
  154. package/src/node-health-codex-login.test.ts +120 -0
  155. package/src/node-health-dispatch-http.test.ts +335 -0
  156. package/src/node-health-guard.ts +121 -0
  157. package/src/node-health-passthrough.test.ts +115 -0
  158. package/src/node-health-store.ts +101 -0
  159. package/src/node-id-alias.test.ts +190 -0
  160. package/src/node-identity-conflict-http.test.ts +269 -0
  161. package/src/node-identity-conflict.ts +142 -0
  162. package/src/node-identity-mismatch.test.ts +74 -0
  163. package/src/node-in-flight-tasks.ts +31 -0
  164. package/src/node-lifecycle-controllable.test.ts +64 -0
  165. package/src/node-lifecycle-controllable.ts +53 -0
  166. package/src/node-lifecycle-read-http.test.ts +250 -0
  167. package/src/node-lifecycle-read.ts +124 -0
  168. package/src/node-logs-transport.test.ts +263 -0
  169. package/src/node-peer-allowlist.test.ts +114 -0
  170. package/src/node-permissions-http.test.ts +728 -0
  171. package/src/node-permissions.ts +494 -0
  172. package/src/node-request-retention.test.ts +281 -0
  173. package/src/node-request-retention.ts +120 -0
  174. package/src/node-secret-rest-http.test.ts +190 -0
  175. package/src/node-serviceability.test.ts +86 -0
  176. package/src/node-serviceability.ts +124 -0
  177. package/src/node-session-control-http.test.ts +310 -0
  178. package/src/node-session-control.ts +258 -0
  179. package/src/node-skills-transport.test.ts +212 -0
  180. package/src/node-token-identity.ts +35 -0
  181. package/src/node-token-ownership.ts +51 -0
  182. package/src/node-token-privilege-http.test.ts +158 -0
  183. package/src/not-found-api-http.test.ts +67 -0
  184. package/src/observer-avatar-http.test.ts +102 -9
  185. package/src/observer-push.test.ts +76 -0
  186. package/src/opencode-catalog-report-http.test.ts +139 -0
  187. package/src/opencode-v2-catalog.test.ts +268 -0
  188. package/src/opencode-v2-catalog.ts +356 -0
  189. package/src/package-version-consistency.test.ts +25 -0
  190. package/src/parent-source-marker.test.ts +50 -0
  191. package/src/password-network-tokens.ts +25 -0
  192. package/src/peer-reply-atomic.test.ts +457 -0
  193. package/src/peer-reply-capability.test.ts +70 -0
  194. package/src/pg-worker.ts +87 -0
  195. package/src/poll-pacing.test.ts +74 -0
  196. package/src/poll-pacing.ts +123 -0
  197. package/src/project-dir-warn-clear-http.test.ts +132 -0
  198. package/src/project-viewer-can-http.test.ts +116 -0
  199. package/src/push.test.ts +20 -10
  200. package/src/push.ts +382 -9
  201. package/src/redact-tokens.test.ts +86 -0
  202. package/src/redact-tokens.ts +43 -0
  203. package/src/rejection-counters.test.ts +72 -0
  204. package/src/rejection-counters.ts +173 -0
  205. package/src/rename.ts +38 -10
  206. package/src/reply-target-derivation.test.ts +96 -0
  207. package/src/report-status-handover-capabilities-http.test.ts +124 -0
  208. package/src/report-status-host-schema.test.ts +235 -0
  209. package/src/report-status-resume-id-handover.test.ts +184 -0
  210. package/src/report-status-secret-keys.test.ts +140 -0
  211. package/src/require-explicit-test-db.ts +9 -0
  212. package/src/requirement-due-reminders-http.test.ts +620 -0
  213. package/src/requirement-due-reminders.ts +416 -0
  214. package/src/requirement-events-http.test.ts +295 -0
  215. package/src/requirement-events.test.ts +45 -0
  216. package/src/requirement-events.ts +144 -0
  217. package/src/requirement-notify.ts +165 -0
  218. package/src/requirement-participant-notify-http.test.ts +309 -0
  219. package/src/requirement-tag-ops-http.test.ts +443 -0
  220. package/src/requirement-tag-tree-http.test.ts +275 -0
  221. package/src/requirement-tag-tree.ts +127 -0
  222. package/src/requirement-tags.ts +102 -0
  223. package/src/requirements-abandoned-http.test.ts +236 -0
  224. package/src/requirements-comment-http.test.ts +167 -0
  225. package/src/requirements-completed-at-migration.test.ts +70 -0
  226. package/src/requirements-errors-mcp-http.test.ts +164 -0
  227. package/src/requirements-errors.ts +158 -0
  228. package/src/requirements-etag-http.test.ts +91 -0
  229. package/src/requirements-http.test.ts +709 -0
  230. package/src/requirements-last-event-http.test.ts +349 -0
  231. package/src/requirements-list-mcp-slim-http.test.ts +155 -0
  232. package/src/requirements-list-slim-http.test.ts +324 -0
  233. package/src/requirements-mcp.test.ts +163 -0
  234. package/src/requirements-migrate.ts +283 -0
  235. package/src/requirements-owner-strict-mcp-http.test.ts +145 -0
  236. package/src/requirements-people-http.test.ts +114 -0
  237. package/src/requirements-people-mcp-http.test.ts +231 -0
  238. package/src/requirements-people.ts +196 -0
  239. package/src/requirements-priority-lowest.test.ts +114 -0
  240. package/src/requirements-projects-network-echo.test.ts +57 -0
  241. package/src/requirements-projects-parent-http.test.ts +123 -0
  242. package/src/requirements-search-http.test.ts +182 -0
  243. package/src/requirements-search.test.ts +32 -0
  244. package/src/requirements-search.ts +145 -0
  245. package/src/requirements-seq-http.test.ts +193 -0
  246. package/src/requirements-seq-migration.test.ts +63 -0
  247. package/src/requirements-start-date.test.ts +125 -0
  248. package/src/requirements-stats-http.test.ts +357 -0
  249. package/src/requirements-stats.ts +195 -0
  250. package/src/requirements-status-participants-http.test.ts +222 -0
  251. package/src/requirements-upgrade-e2e.test.ts +126 -0
  252. package/src/requirements-upgrade-migration.test.ts +98 -0
  253. package/src/requirements.ts +2064 -0
  254. package/src/resolve-port.test.ts +57 -0
  255. package/src/resolve-port.ts +44 -0
  256. package/src/rest-alias-network-fallback-http.test.ts +123 -0
  257. package/src/rest-alias-network-fallback.test.ts +60 -0
  258. package/src/rest-alias-network-fallback.ts +65 -0
  259. package/src/rest-explicit-columns-http.test.ts +266 -0
  260. package/src/rest-identity.test.ts +130 -0
  261. package/src/rest-identity.ts +141 -0
  262. package/src/rest-projections.ts +72 -0
  263. package/src/rest-read-network-real-chain.test.ts +97 -0
  264. package/src/rest-write-network-resolution.test.ts +133 -0
  265. package/src/restart-readiness-http.test.ts +121 -0
  266. package/src/restricted-files.ts +76 -0
  267. package/src/retention-first-sweep-quiet.test.ts +31 -0
  268. package/src/retention.test.ts +100 -40
  269. package/src/retention.ts +423 -104
  270. package/src/route-callers-http.test.ts +120 -0
  271. package/src/route-timing.test.ts +218 -0
  272. package/src/route-timing.ts +262 -0
  273. package/src/rules-file-duplicate-alias.test.ts +234 -0
  274. package/src/rules-file-session-target.test.ts +207 -0
  275. package/src/rules-file-transport.test.ts +237 -0
  276. package/src/runtime-label.test.ts +22 -0
  277. package/src/runtime-label.ts +21 -0
  278. package/src/runtime-readiness.ts +90 -0
  279. package/src/schedule-agent-mcp-http.test.ts +432 -0
  280. package/src/schedule-agent.ts +252 -0
  281. package/src/schedule-starved.test.ts +92 -0
  282. package/src/schedule-starved.ts +114 -0
  283. package/src/scheduled-backoff-http.test.ts +193 -0
  284. package/src/scheduled-backoff.ts +64 -0
  285. package/src/scheduled-doorbell-nodeless-session.test.ts +134 -0
  286. package/src/scheduled-failure-backoff-2622.test.ts +145 -0
  287. package/src/scheduled-failure-code.test.ts +73 -0
  288. package/src/scheduled-failure-code.ts +105 -0
  289. package/src/scheduled-failures-http.test.ts +279 -0
  290. package/src/scheduled-failures.ts +425 -0
  291. package/src/scheduled-noprogress-backoff-2622.test.ts +163 -0
  292. package/src/scheduled-offline-backoff-probe.test.ts +56 -0
  293. package/src/scheduled-offline.test.ts +131 -0
  294. package/src/scheduled-offline.ts +66 -0
  295. package/src/scheduled-outcome-guidance-http.test.ts +139 -0
  296. package/src/scheduled-outcome-guidance.ts +9 -0
  297. package/src/scheduled-reply-unread-http.test.ts +212 -0
  298. package/src/scheduled-requirement-wake-http.test.ts +279 -0
  299. package/src/scheduled-requirement-wake.ts +125 -0
  300. package/src/scheduled-run-terminal.test.ts +268 -0
  301. package/src/scheduled-skip-blocking-task.test.ts +120 -0
  302. package/src/scheduled-skip-path-backoff-2622.test.ts +98 -0
  303. package/src/scheduled-stuck-http.test.ts +316 -0
  304. package/src/scheduled-stuck-notice-cap.test.ts +80 -0
  305. package/src/scheduled-stuck.ts +219 -0
  306. package/src/scheduled-tasks-http.test.ts +679 -0
  307. package/src/scheduled-tasks.ts +959 -0
  308. package/src/scheduled-work-outcome-http.test.ts +154 -0
  309. package/src/scheduled-work-outcome.ts +50 -0
  310. package/src/scoped-secrets.ts +141 -0
  311. package/src/send-dedup-request-id.test.ts +229 -0
  312. package/src/send-reply-agent-warning.test.ts +38 -38
  313. package/src/send-reply-alias-optional.test.ts +131 -0
  314. package/src/send-reply-attachments.test.ts +458 -0
  315. package/src/send_dedup.test.ts +54 -0
  316. package/src/send_dedup.ts +52 -6
  317. package/src/serve-error.test.ts +73 -0
  318. package/src/serve-error.ts +56 -0
  319. package/src/server.ts +5035 -457
  320. package/src/session-task-on-dispatch.ts +14 -0
  321. package/src/session-token-ownership-http.test.ts +122 -0
  322. package/src/shared/codex-inventory.ts +41 -0
  323. package/src/shared/daemon-provider-login.ts +31 -0
  324. package/src/shared/daemon-provider-snapshot.ts +52 -0
  325. package/src/shared/external-schedule-contract.ts +60 -0
  326. package/src/shared/node-name.test.ts +62 -0
  327. package/src/shared/node-name.ts +161 -0
  328. package/src/shared/probe-host-allowlist-drift.test.ts +45 -0
  329. package/src/shared/provider-application.ts +29 -0
  330. package/src/shared/provider-collection.ts +14 -0
  331. package/src/shared/provider-initialization.ts +8 -0
  332. package/src/shared/reserved-env-drift.test.ts +10 -0
  333. package/src/shared/scoped-secret-contract.ts +5 -0
  334. package/src/shared/task-content-limit-drift.test.ts +28 -0
  335. package/src/shared/task-content-limit.ts +25 -0
  336. package/src/side-thread-command-transport.test.ts +312 -0
  337. package/src/side-thread-command-transport.ts +318 -0
  338. package/src/side-thread-http-integration.test.ts +233 -0
  339. package/src/side-thread-http.ts +504 -0
  340. package/src/side-thread-production.test.ts +72 -0
  341. package/src/side-thread-production.ts +118 -0
  342. package/src/side-thread.test.ts +1067 -0
  343. package/src/side-thread.ts +2499 -0
  344. package/src/skillhub-http.test.ts +142 -0
  345. package/src/sqlite-close-checkpoint.test.ts +78 -0
  346. package/src/start-node.test.ts +264 -0
  347. package/src/status-alias-filter-http.test.ts +106 -0
  348. package/src/status-alias-resolver-http.test.ts +163 -0
  349. package/src/status-alias-resolver.ts +19 -0
  350. package/src/status-node-id-filter-http.test.ts +161 -0
  351. package/src/status-read-cache-http.test.ts +229 -0
  352. package/src/status-read-cache.ts +129 -0
  353. package/src/stop-delete-node.test.ts +567 -1
  354. package/src/task-access-http.test.ts +402 -0
  355. package/src/task-access.ts +420 -0
  356. package/src/task-activity.ts +60 -0
  357. package/src/task-auth-origin-http.test.ts +93 -0
  358. package/src/task-auth-origin.test.ts +24 -0
  359. package/src/task-auth-origin.ts +7 -0
  360. package/src/task-consumption.test.ts +490 -0
  361. package/src/task-diagnostic-http.test.ts +149 -0
  362. package/src/task-diagnostic.test.ts +115 -0
  363. package/src/task-diagnostic.ts +118 -0
  364. package/src/task-expiry-notice-http.test.ts +287 -0
  365. package/src/task-expiry-notice.ts +315 -0
  366. package/src/task-idempotency-mcp.test.ts +142 -0
  367. package/src/task-idempotency.test.ts +76 -0
  368. package/src/task-idempotency.ts +81 -0
  369. package/src/task-late-replies.ts +54 -0
  370. package/src/task-late-reply-http.test.ts +227 -0
  371. package/src/task-lifecycle-watcher-busy.test.ts +114 -0
  372. package/src/task-lifecycle-watcher.test.ts +204 -0
  373. package/src/task-lifecycle-watcher.ts +109 -0
  374. package/src/task-network-resolution-http.test.ts +140 -0
  375. package/src/task-offline-delivery-2668.test.ts +119 -0
  376. package/src/task-offline-delivery.ts +81 -0
  377. package/src/task-orphan-http.test.ts +287 -0
  378. package/src/task-orphan.ts +119 -0
  379. package/src/task-queue-ahead-http.test.ts +309 -0
  380. package/src/task-queue-ahead-scale.test.ts +236 -0
  381. package/src/task-queue-ahead.ts +186 -0
  382. package/src/task-rejection-log-http.test.ts +160 -0
  383. package/src/task-rejection-log.ts +61 -0
  384. package/src/task-sender-http.test.ts +143 -0
  385. package/src/task-stale-open-http.test.ts +292 -0
  386. package/src/task-stale-open.ts +103 -0
  387. package/src/tasks-pagination-http.test.ts +141 -0
  388. package/src/team-rules-status-http.test.ts +90 -0
  389. package/src/team-rules-status.test.ts +59 -0
  390. package/src/team-rules-status.ts +72 -0
  391. package/src/tmux-allowlist.test.ts +48 -0
  392. package/src/tool-audience-http.test.ts +230 -0
  393. package/src/tool-audience.ts +127 -0
  394. package/src/tools-list-json-schema.test.ts +94 -0
  395. package/src/tools.ts +4310 -419
  396. package/src/upload-early-reject-guard.test.ts +155 -0
  397. package/src/uploads-http.test.ts +86 -7
  398. package/src/uploads.ts +103 -6
  399. package/src/user-avatar-http.test.ts +74 -0
  400. package/src/user-avatar-image.ts +160 -0
  401. package/src/user-avatar-migration.test.ts +25 -0
  402. package/src/user-avatar-upload-http.test.ts +348 -0
  403. package/src/user-inbox-by-agent-http.test.ts +161 -0
  404. package/src/user-inbox-netid-notnull.test.ts +122 -0
  405. package/src/user-inbox-read-http.test.ts +223 -0
  406. package/src/user-inbox-schema.test.ts +54 -0
  407. package/src/version-stats.test.ts +66 -0
  408. package/src/version-stats.ts +109 -0
@@ -0,0 +1,310 @@
1
+ // SSE `inbox_count` contract for the message-shaped events.
2
+ //
3
+ // Background: `new_task` has shipped a real unacked count since #1304,
4
+ // but `new_message` / `new_reply` carried NO count at all and
5
+ // `broadcast` carried a hardcoded `inbox_count: 1`. A client that
6
+ // renders "N new" from the SSE payload therefore never moved for plain
7
+ // messages and replies, and showed a constant 1 for broadcasts.
8
+ //
9
+ // Gate discipline: every assertion below expects a count that is NOT 1
10
+ // (pre-seeded unacked rows push the expected value to 2 or 3). A
11
+ // hardcoded `1` — the exact defect being fixed — fails these tests
12
+ // rather than passing them. Asserting `=== 1` would have been a fake
13
+ // gate that the old code satisfied.
14
+ //
15
+ // Run: COMMHUB_DB=/tmp/inbox-count-sse.db bun test src/inbox-count-sse.test.ts
16
+
17
+ import { afterAll, beforeEach, afterEach, describe, expect, test } from "bun:test";
18
+ import { db, uuidv4 } from "./db.js";
19
+ import { McpServer } from "@modelcontextprotocol/sdk/server/mcp.js";
20
+ import { registerTools } from "./tools.js";
21
+ import { __resetSSEClientsForTest, createSSEStream } from "./push.js";
22
+ import { pendingInboxCount } from "./inbox-count.js";
23
+
24
+ const NET = "net_inboxcount";
25
+ const OWNER = "u_inboxcount_owner";
26
+ const RECV = "peer-inboxcount-recv"; // receives messages/replies
27
+ const OTHER = "peer-inboxcount-other"; // second broadcast recipient
28
+ const SENDER = "peer-inboxcount-send";
29
+ // #1440 ① — a broadcast target the lifecycle guard skips.
30
+ const STOPPED = "peer-inboxcount-stopped";
31
+ const ALIASES = [RECV, OTHER, SENDER];
32
+
33
+ type ToolHandler = (args: any, extra?: any) => Promise<{ content: Array<{ type: "text"; text: string }> }>;
34
+
35
+ function cleanup() {
36
+ for (const t of ["tasks", "inbox", "task_events"]) {
37
+ try { db.run(`DELETE FROM ${t} WHERE network_id = ?1`, [NET]); } catch {}
38
+ }
39
+ try { db.run("DELETE FROM sessions WHERE network_id = ?1", [NET]); } catch {}
40
+ try { db.run("DELETE FROM nodes WHERE network_id = ?1", [NET]); } catch {}
41
+ try { db.run("DELETE FROM network_members WHERE network_id = ?1", [NET]); } catch {}
42
+ try { db.run("DELETE FROM networks WHERE network_id = ?1", [NET]); } catch {}
43
+ try { db.run("DELETE FROM users WHERE user_id = ?1", [OWNER]); } catch {}
44
+ }
45
+
46
+ function seed() {
47
+ db.run(
48
+ `INSERT INTO users (user_id, username, password_hash, role, created_at)
49
+ VALUES (?1, ?1, 'x', 'user', datetime('now'))`,
50
+ [OWNER],
51
+ );
52
+ db.run(`INSERT INTO networks (network_id, network_name, owner_id, created_at) VALUES (?1, ?1, ?2, datetime('now'))`, [NET, OWNER]);
53
+ db.run(`INSERT INTO network_members (user_id, network_id, role, joined_at) VALUES (?1, ?2, 'owner', datetime('now'))`, [OWNER, NET]);
54
+ for (const alias of ALIASES) {
55
+ db.run(
56
+ `INSERT INTO nodes (node_id, node_name, alias, network_id, hostname, created_at, updated_at, lifecycle_state)
57
+ VALUES (?1, ?2, ?2, ?3, ?4, datetime('now'), datetime('now'), 'active')`,
58
+ [`node_${alias}`, alias, NET, `host-${alias}`],
59
+ );
60
+ db.run(
61
+ `INSERT INTO sessions (resume_id, alias, status, node_id, network_id, updated_at, last_seen_at)
62
+ VALUES (?1, ?2, 'idle', ?3, ?4, datetime('now'), datetime('now'))`,
63
+ [`res_${alias}`, alias, `node_${alias}`, NET],
64
+ );
65
+ }
66
+ // A session that broadcast will select as a target, but whose node is
67
+ // NOT active — assertNodeActive skips it, so it gets no inbox row.
68
+ db.run(
69
+ `INSERT INTO nodes (node_id, node_name, alias, network_id, hostname, created_at, updated_at, lifecycle_state)
70
+ VALUES (?1, ?2, ?2, ?3, ?4, datetime('now'), datetime('now'), 'stopped')`,
71
+ [`node_${STOPPED}`, STOPPED, NET, `host-${STOPPED}`],
72
+ );
73
+ db.run(
74
+ `INSERT INTO sessions (resume_id, alias, status, node_id, network_id, updated_at, last_seen_at)
75
+ VALUES (?1, ?2, 'idle', ?3, ?4, datetime('now'), datetime('now'))`,
76
+ [`res_${STOPPED}`, STOPPED, `node_${STOPPED}`, NET],
77
+ );
78
+ }
79
+
80
+ beforeEach(() => { cleanup(); seed(); });
81
+ afterEach(() => { __resetSSEClientsForTest(); });
82
+ afterAll(cleanup);
83
+
84
+ function buildHandlers(alias: string): Record<string, ToolHandler> {
85
+ const server = new McpServer({ name: "test", version: "0" }) as any;
86
+ const tools: Record<string, ToolHandler> = {};
87
+ const origTool = server.tool.bind(server);
88
+ server.tool = (name: string, _desc: string, schema: any, handler: ToolHandler) => {
89
+ tools[name] = handler;
90
+ return origTool(name, _desc, schema, handler);
91
+ };
92
+ registerTools(server, undefined, NET, OWNER, alias, true, null);
93
+ return tools;
94
+ }
95
+
96
+ async function call(handler: ToolHandler, args: any): Promise<Record<string, any>> {
97
+ const r = await handler(args);
98
+ return JSON.parse(r.content[0].text);
99
+ }
100
+
101
+ /** Read the next SSE data frame, with a hard timeout so a silent stream
102
+ * fails instead of hanging. Skips keepalive comment frames. */
103
+ async function readFrame(
104
+ reader: ReadableStreamDefaultReader<Uint8Array>,
105
+ timeoutMs = 2_000,
106
+ ): Promise<Record<string, any>> {
107
+ const decoder = new TextDecoder();
108
+ let buf = "";
109
+ const deadline = Date.now() + timeoutMs;
110
+ while (Date.now() < deadline) {
111
+ const result = await Promise.race([
112
+ reader.read(),
113
+ new Promise<never>((_, rej) =>
114
+ setTimeout(() => rej(new Error(`no SSE frame within ${timeoutMs}ms`)), deadline - Date.now()),
115
+ ),
116
+ ]);
117
+ if (result.done) throw new Error("SSE stream ended unexpectedly");
118
+ buf += decoder.decode(result.value, { stream: true });
119
+ const sep = buf.indexOf("\n\n");
120
+ if (sep === -1) continue;
121
+ const rawFrame = buf.slice(0, sep);
122
+ buf = buf.slice(sep + 2);
123
+ const dataLine = rawFrame.split("\n").find((l) => l.startsWith("data: "));
124
+ if (!dataLine) continue;
125
+ return JSON.parse(dataLine.slice(6));
126
+ }
127
+ throw new Error(`no SSE frame within ${timeoutMs}ms`);
128
+ }
129
+
130
+ /** Subscribe and swallow the initial `connected` frame. */
131
+ async function subscribe(alias: string) {
132
+ const reader = createSSEStream(alias, NET).body!.getReader();
133
+ await readFrame(reader);
134
+ return reader;
135
+ }
136
+
137
+ /** Pre-existing unacked inbox rows, so the expected count is never 1. */
138
+ function seedUnacked(alias: string, n: number, type = "message") {
139
+ for (let i = 0; i < n; i++) {
140
+ db.run(
141
+ `INSERT INTO inbox (id, session_name, node_id, type, priority, content, from_session, network_id)
142
+ VALUES (?1, ?2, ?3, ?4, 'normal', ?5, ?6, ?7)`,
143
+ [uuidv4(), alias, `node_${alias}`, type, `backlog ${i}`, SENDER, NET],
144
+ );
145
+ }
146
+ }
147
+
148
+ function makeTask(from: string, to: string, content: string, status = "delivered"): string {
149
+ const id = uuidv4();
150
+ db.run(
151
+ `INSERT INTO tasks (task_id, from_name, to_name, priority, status, content, requires_response, created_at, network_id)
152
+ VALUES (?1, ?2, ?3, 'normal', ?4, ?5, 'reply', datetime('now'), ?6)`,
153
+ [id, from, to, status, content, NET],
154
+ );
155
+ return id;
156
+ }
157
+
158
+ describe("SSE inbox_count", () => {
159
+ test("new_message carries the recipient's real unacked count, not a hardcoded 1", async () => {
160
+ seedUnacked(RECV, 2);
161
+ const reader = await subscribe(RECV);
162
+
163
+ const tools = buildHandlers(SENDER);
164
+ const res = await call(tools.send_message, { alias: RECV, message: "hello", network_id: NET });
165
+ expect(res.ok ?? true).not.toBe(false);
166
+
167
+ const evt = await readFrame(reader);
168
+ expect(evt.type).toBe("new_message");
169
+ // 2 seeded + this one. A hardcoded 1 — or a missing field — fails here.
170
+ expect(evt.inbox_count).toBe(3);
171
+ expect(evt.inbox_count).toBe(pendingInboxCount(RECV, NET));
172
+ });
173
+
174
+ test("new_reply carries the reply target's real unacked count", async () => {
175
+ seedUnacked(RECV, 1);
176
+ const taskId = makeTask(RECV, SENDER, "please do the thing");
177
+ const reader = await subscribe(RECV);
178
+
179
+ const tools = buildHandlers(SENDER);
180
+ const res = await call(tools.send_reply, {
181
+ alias: RECV,
182
+ text: "done",
183
+ in_reply_to: taskId,
184
+ status: "completed",
185
+ network_id: NET,
186
+ });
187
+ expect(res.ok).toBe(true);
188
+
189
+ const evt = await readFrame(reader);
190
+ expect(evt.type).toBe("new_reply");
191
+ // 1 seeded + the reply row. Not 1, and not absent.
192
+ expect(evt.inbox_count).toBe(2);
193
+ expect(evt.inbox_count).toBe(pendingInboxCount(RECV, NET));
194
+ });
195
+
196
+ test("broadcast counts per recipient instead of shipping a constant 1", async () => {
197
+ // Asymmetric backlogs: if the payload were hardcoded, both
198
+ // recipients would report the same number. They must not.
199
+ seedUnacked(RECV, 2);
200
+ const recvReader = await subscribe(RECV);
201
+ const otherReader = await subscribe(OTHER);
202
+
203
+ const tools = buildHandlers(SENDER);
204
+ await call(tools.broadcast, { message: "all hands", network_id: NET });
205
+
206
+ const recvEvt = await readFrame(recvReader);
207
+ const otherEvt = await readFrame(otherReader);
208
+ expect(recvEvt.type).toBe("broadcast");
209
+ expect(otherEvt.type).toBe("broadcast");
210
+
211
+ // RECV: 2 seeded + the broadcast row. OTHER: only the broadcast row.
212
+ expect(recvEvt.inbox_count).toBe(3);
213
+ expect(otherEvt.inbox_count).toBe(1);
214
+ expect(recvEvt.inbox_count).not.toBe(otherEvt.inbox_count);
215
+ });
216
+
217
+ test("acked rows are excluded — the count tracks what is still unread", async () => {
218
+ seedUnacked(RECV, 3);
219
+ db.run("UPDATE inbox SET acked = 1 WHERE session_name = ?1 AND network_id = ?2", [RECV, NET]);
220
+ const reader = await subscribe(RECV);
221
+
222
+ const tools = buildHandlers(SENDER);
223
+ await call(tools.send_message, { alias: RECV, message: "after the catch-up", network_id: NET });
224
+
225
+ const evt = await readFrame(reader);
226
+ // 3 acked rows contribute nothing; only the new one is outstanding.
227
+ expect(evt.inbox_count).toBe(1);
228
+ });
229
+ });
230
+
231
+ // #1440 ② — `retry_task` and `reassign_task` re-queue a task and push
232
+ // `new_task`, but both shipped a hardcoded `inbox_count: 1` while the
233
+ // hub already knew the real number. Same defect family as the
234
+ // `broadcast` case above; same gate discipline — the expected counts
235
+ // here are 3, so a hardcoded 1 cannot satisfy them.
236
+ describe("#1440 new_task inbox_count on requeue paths", () => {
237
+ test("retry_task carries the real unacked count, not a hardcoded 1", async () => {
238
+ seedUnacked(RECV, 2);
239
+ const taskId = makeTask(SENDER, RECV, "flaky job", "failed");
240
+ const reader = await subscribe(RECV);
241
+
242
+ const tools = buildHandlers(SENDER);
243
+ const res = await call(tools.retry_task, { task_id: taskId, network_id: NET });
244
+ expect(res.ok).toBe(true);
245
+
246
+ const evt = await readFrame(reader);
247
+ expect(evt.type).toBe("new_task");
248
+ // 2 seeded + the re-queued task row.
249
+ expect(evt.inbox_count).toBe(3);
250
+ expect(evt.inbox_count).toBe(pendingInboxCount(RECV, NET));
251
+ });
252
+
253
+ test("reassign_task carries the NEW assignee's real unacked count", async () => {
254
+ seedUnacked(RECV, 2);
255
+ const taskId = makeTask(SENDER, OTHER, "moved job");
256
+ const reader = await subscribe(RECV);
257
+
258
+ const tools = buildHandlers(SENDER);
259
+ const res = await call(tools.reassign_task, { task_id: taskId, new_alias: RECV, network_id: NET });
260
+ expect(res.ok).toBe(true);
261
+ expect(res.reassigned_to).toBe(RECV);
262
+
263
+ const evt = await readFrame(reader);
264
+ expect(evt.type).toBe("new_task");
265
+ // 2 seeded on the new assignee + the row reassign just wrote.
266
+ expect(evt.inbox_count).toBe(3);
267
+ expect(evt.inbox_count).toBe(pendingInboxCount(RECV, NET));
268
+ });
269
+ });
270
+
271
+ // #1440 ① — the broadcast push loop walked every candidate target,
272
+ // including the ones assertNodeActive had just skipped. Those nodes
273
+ // were told "you have a broadcast" while their inbox got no row for it.
274
+ // Before #1439 the hardcoded `inbox_count: 1` hid this: everyone got
275
+ // the same digit, so a spurious event was indistinguishable from a real
276
+ // one.
277
+ describe("#1440 broadcast delivery set", () => {
278
+ test("a lifecycle-skipped node gets no inbox row AND no broadcast event", async () => {
279
+ const activeReader = await subscribe(OTHER);
280
+ const stoppedReader = await subscribe(STOPPED);
281
+
282
+ const tools = buildHandlers(SENDER);
283
+ const res = await call(tools.broadcast, { message: "all hands", network_id: NET });
284
+
285
+ // The active recipient is served — this proves the broadcast ran, so
286
+ // the absence checked below is "not sent", not "not yet sent"
287
+ // (pushEvent is synchronous inside the handler).
288
+ const activeEvt = await readFrame(activeReader);
289
+ expect(activeEvt.type).toBe("broadcast");
290
+
291
+ // The skipped node has no row...
292
+ const rows = db.get<{ cnt: number }>(
293
+ "SELECT COUNT(*) AS cnt FROM inbox WHERE session_name = ?1 AND type = 'broadcast'",
294
+ STOPPED,
295
+ );
296
+ expect(rows?.cnt).toBe(0);
297
+ // ...and must therefore receive no event announcing one.
298
+ await expect(readFrame(stoppedReader, 300)).rejects.toThrow(/no SSE frame/);
299
+
300
+ // message_ids covers only the recipients that actually got a row:
301
+ // RECV + OTHER + SENDER, never STOPPED.
302
+ expect(res.message_ids).toHaveLength(3);
303
+ // #1440 ③ — `recipients` counted candidates, not deliveries, so it
304
+ // disagreed with the documented invariant
305
+ // ("message_ids.length === recipients", docs-site/docs/api/rest-data.md)
306
+ // exactly when a node was skipped. 4 sessions, 3 delivered.
307
+ expect(res.recipients).toBe(res.message_ids.length);
308
+ expect(res.recipients).toBe(3);
309
+ });
310
+ });
@@ -0,0 +1,29 @@
1
+ import { db } from "./db.js";
2
+
3
+ /**
4
+ * Unacked inbox rows for `alias` — the number a client should show as
5
+ * "new". This is the count `new_task` has shipped since #1304; it is
6
+ * lifted here verbatim so every SSE event that carries `inbox_count`
7
+ * derives it the same way instead of hardcoding a digit.
8
+ *
9
+ * The SQL and its network scoping are unchanged from the `new_task`
10
+ * sites (tools.ts / server.ts): falsy `networkId` means "no network
11
+ * filter", matching both `addScope()` and the inline `if (taskNetId)`
12
+ * guard those sites already use.
13
+ *
14
+ * The `?? 1` fallback only fires if the COUNT itself returns no row,
15
+ * which SQLite does not do. It is not a default count: it is the
16
+ * fail-closed direction for this gate. Every caller pushes right after
17
+ * inserting an inbox row, so the floor is genuinely 1, and under-
18
+ * reporting an unread (badge says 0, a message is sitting there) is the
19
+ * failure this event exists to prevent.
20
+ */
21
+ export function pendingInboxCount(alias: string, networkId?: string | null): number {
22
+ const params: any[] = [alias];
23
+ let sql = "SELECT COUNT(*) as cnt FROM inbox WHERE session_name = ?1 AND acked = 0";
24
+ if (networkId) {
25
+ sql += " AND network_id = ?2";
26
+ params.push(networkId);
27
+ }
28
+ return db.get<{ cnt: number }>(sql, ...params)?.cnt ?? 1;
29
+ }
package/src/index.ts CHANGED
@@ -6,6 +6,10 @@
6
6
  // tests and tooling import "./server.js" and get bootServer/startHub
7
7
  // without binding any port. Do NOT add logic here, and do NOT import
8
8
  // this module to "get at the server" — that starts one.
9
- import { startHub } from "./server.js";
10
-
9
+ // The default production DB path is deliberately unavailable to ordinary
10
+ // imports / bun -e probes. This run-entry is one of the two canonical places
11
+ // allowed to opt in, and it must do so before dynamically importing server.ts
12
+ // (whose dependency graph constructs the DB adapter at module evaluation).
13
+ process.env.COMMHUB_SERVER = "1";
14
+ const { startHub } = await import("./server.js");
11
15
  startHub();
@@ -0,0 +1,56 @@
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
+ });
@@ -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
+ }
@@ -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,127 @@
1
+ // #476(#469 MCP 审计的最后一项)—— Hub MCP 面的上下文成本。
2
+ //
3
+ // 钉住:
4
+ // 1. tools/list 的总字节有上限(TOOLS_LIST_MAX_BYTES):描述 / 参数说明不能悄悄长回去。每个工具也有上限,
5
+ // 单条工具描述有上限。要加新工具 / 新说明,改这里的数字 —— 改的时候就会被看见。
6
+ // 2. requirements_events 不带 requirement_id(全网动态)默认 50 条、从新到旧、next_cursor 翻更早的;
7
+ // 带 requirement_id 的单卡调用不变(默认 200);REST /api/requirements/events 不变(默认 200,App 用它)。
8
+ // 3. requirements_events 参数严格:不认识的参数 → -32602,列出能用的参数。
9
+ //
10
+ // 跑法:cd server && COMMHUB_DB=/tmp/x.db bun test src/mcp-context-cost-http.test.ts
11
+ // PG:COMMHUB_TEST_PG_URL=… COMMHUB_PG_EXPERIMENTAL=1(tests/test2123-hub-postgres-ladder 里注册)
12
+ import { afterAll, beforeAll, describe, expect, test } from "bun:test";
13
+ import { Client } from "@modelcontextprotocol/sdk/client/index.js";
14
+ import { InMemoryTransport } from "@modelcontextprotocol/sdk/inMemory.js";
15
+ import { McpServer } from "@modelcontextprotocol/sdk/server/mcp.js";
16
+ import { register } from "./auth.js";
17
+ import { registerTools } from "./tools.js";
18
+
19
+ const activeDbPath = process.env.COMMHUB_DB ?? (process.env.COMMHUB_TEST_PG_URL ? "postgres" : undefined);
20
+ if (!activeDbPath) throw new Error("mcp-context-cost requires COMMHUB_DB (or COMMHUB_TEST_PG_URL) before module import");
21
+
22
+ /**
23
+ * tools/list 整份 JSON 的字节上限。#476 之前(main,含 #475)74 个工具 76,824 B;修剪后 71,399 B。
24
+ * #478 起 tools/list 按调用者给:这里的调用者是用户令牌,看到 56 个工具 54,780 B(不含节点 / 协议工具)。
25
+ * 上限跟着收到用户这一档(~1.7 KB 余量);节点 / 全部工具的上限在 tool-audience-http.test.ts。
26
+ * 加工具或加说明超过它,就在这里改数字并在 PR 里说为什么。
27
+ */
28
+ // Board #625: two human adoption tools; measured 58 tools / 56,615 B.
29
+ // Hub #938 clone_node is audience both (60 tools / 58,169 B). OpenCode V2
30
+ // catalog adds read_opencode_catalog and get_opencode_catalog on that user
31
+ // list. Measured together: 62 tools / 59,409 B. Ceiling keeps ~401 B.
32
+ // #1894(2026-10-23):新增 `departments` 一个工具(组织架构的 list/create/update/
33
+ // delete/assign_agent 合并成一个,避免 5 个工具把上下文顶穿)。实测 63 个工具
34
+ // 60,089 B,比原上限高 279 B —— 这是**有意的功能增长**,不是描述悄悄变长,
35
+ // 所以显式抬到 60_500(留 411 B 余量)并在同一行写清理由。
36
+ const TOOLS_LIST_MAX_BYTES = 60_500;
37
+ /** 单个工具(名字 + 描述 + 输入 schema)的上限;最大的是 report_status(节点心跳,~8.4 KB 的遥测结构)。 */
38
+ const TOOL_MAX_BYTES = 9_000;
39
+ /** 单条工具描述的上限(说明写进参数的 describe,或者拆短)。 */
40
+ const DESCRIPTION_MAX_BYTES = 1_000;
41
+ const NETWORK_EVENTS = 80;
42
+
43
+ let server: any;
44
+ let base = "";
45
+ let token = "", netId = "";
46
+ let close: () => Promise<void>;
47
+ let client: Client;
48
+ const call = async (name: string, args: Record<string, unknown>) => {
49
+ const r: any = await client.callTool({ name, arguments: args });
50
+ const text = String(r.content?.[0]?.text ?? "");
51
+ return r.isError ? { mcpError: true, text } : { ...JSON.parse(text), _bytes: Buffer.byteLength(text, "utf8") };
52
+ };
53
+ let busyId = "";
54
+
55
+ beforeAll(async () => {
56
+ const u = register(`ctx_${Date.now()}`, "CtxCost123!", undefined, "seed");
57
+ token = u.token!; netId = u.network_id!;
58
+ const s = new McpServer({ name: "ctx", version: "1" });
59
+ registerTools(s, undefined, null, u.user!.user_id, u.user!.username, false, "tok_user");
60
+ client = new Client({ name: "ctx-client", version: "1" });
61
+ const [ct, st] = InMemoryTransport.createLinkedPair();
62
+ await s.connect(st);
63
+ await client.connect(ct);
64
+ close = async () => { await client.close(); await s.close(); };
65
+ const mod: any = await import("./server.js");
66
+ server = mod.bootServer({ port: 0, hostname: "127.0.0.1" });
67
+ base = `http://127.0.0.1:${server.port}`;
68
+ // 一张卡上 60 条评论(单卡调用要能拿到 > 50 条),再加 20 张卡各一条
69
+ const busy = await call("requirements_create", { network_id: netId, name: "busy task" });
70
+ busyId = busy.requirement.id;
71
+ for (let i = 0; i < 60; i++) expect((await call("requirements_comment", { network_id: netId, id: busyId, text: `进展 ${i}:这一步完成了` })).ok).toBe(true);
72
+ for (let i = 0; i < NETWORK_EVENTS - 60; i++) {
73
+ const r = await call("requirements_create", { network_id: netId, name: `task ${i}` });
74
+ await call("requirements_comment", { network_id: netId, id: r.requirement.id, text: "已开始" });
75
+ }
76
+ }, 120_000);
77
+ afterAll(async () => { await close?.(); server?.stop?.(true); });
78
+
79
+ describe("#476 tools/list size", () => {
80
+ test("total, per tool and per description stay under their ceilings", async () => {
81
+ const { tools } = await client.listTools();
82
+ const total = Buffer.byteLength(JSON.stringify({ tools }), "utf8");
83
+ const sizes = tools.map((t: any) => ({ name: t.name, all: Buffer.byteLength(JSON.stringify(t)), desc: Buffer.byteLength(t.description ?? "") }));
84
+ sizes.sort((a, b) => b.all - a.all);
85
+ console.log(`tools/list: ${tools.length} tools, ${total} B; largest ${sizes.slice(0, 3).map(x => `${x.name}=${x.all}`).join(", ")}`);
86
+ expect(total).toBeLessThanOrEqual(TOOLS_LIST_MAX_BYTES);
87
+ for (const x of sizes) {
88
+ expect(x.all, x.name).toBeLessThanOrEqual(TOOL_MAX_BYTES);
89
+ expect(x.desc, x.name).toBeLessThanOrEqual(DESCRIPTION_MAX_BYTES);
90
+ }
91
+ });
92
+ });
93
+
94
+ describe("#476 requirements_events defaults", () => {
95
+ test("network-wide: 50 newest by default, next_cursor pages older events", async () => {
96
+ const p1 = await call("requirements_events", { network_id: netId });
97
+ expect(p1.events.length).toBe(50);
98
+ expect(typeof p1.next_cursor).toBe("string");
99
+ const times = p1.events.map((e: any) => e.at ?? e.created_at);
100
+ expect([...times].sort().reverse()).toEqual(times);
101
+ const p2 = await call("requirements_events", { network_id: netId, cursor: p1.next_cursor });
102
+ const ids = new Set([...p1.events, ...p2.events].map((e: any) => e.id));
103
+ expect(ids.size).toBe(p1.events.length + p2.events.length);
104
+ console.log(`network events page of 50: ${p1._bytes} B`);
105
+ expect(p1._bytes).toBeLessThan(25_000);
106
+ });
107
+
108
+ test("an explicit limit still wins; one task's timeline keeps its old default (200)", async () => {
109
+ expect((await call("requirements_events", { network_id: netId, limit: 70 })).events.length).toBe(70);
110
+ const one = await call("requirements_events", { network_id: netId, requirement_id: busyId });
111
+ expect(one.events.filter((e: any) => e.kind === "comment").length).toBe(60);
112
+ });
113
+
114
+ test("REST GET /api/requirements/events is unchanged (default 200)", async () => {
115
+ const res = await fetch(`${base}/api/requirements/events?network_id=${netId}`, { headers: { Authorization: `Bearer ${token}` } });
116
+ const body = await res.json() as any;
117
+ expect(res.status).toBe(200);
118
+ expect(body.events.length).toBeGreaterThan(50);
119
+ });
120
+
121
+ test("unknown parameters → -32602 listing the valid ones", async () => {
122
+ const r = await call("requirements_events", { network_id: netId, task_id: busyId });
123
+ expect(r.mcpError).toBe(true);
124
+ expect(r.text).toContain("-32602");
125
+ expect(r.text).toContain("unknown parameter(s): task_id; valid parameters: network_id, requirement_id, since, limit, cursor");
126
+ });
127
+ });