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

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
Files changed (482) hide show
  1. package/README.md +120 -3
  2. package/bin/commhub.ts +93 -9
  3. package/build-info.json +7 -0
  4. package/package.json +10 -8
  5. package/src/ack-create-request-transport.test.ts +182 -0
  6. package/src/ack-create-request.test.ts +52 -8
  7. package/src/admin-delete-network-http.test.ts +229 -0
  8. package/src/admin-networks-http.test.ts +88 -0
  9. package/src/adoption-candidates-http.test.ts +140 -0
  10. package/src/adoption-candidates.ts +158 -0
  11. package/src/agent-access-batch.test.ts +215 -0
  12. package/src/agent-access.ts +585 -0
  13. package/src/agent-acl-groups-http.test.ts +247 -0
  14. package/src/agent-acl-http.test.ts +691 -0
  15. package/src/agent-acl-slice3-http.test.ts +888 -0
  16. package/src/agent-department-grants.test.ts +129 -0
  17. package/src/agent-department-http.test.ts +215 -0
  18. package/src/agent-groups-perf.test.ts +228 -0
  19. package/src/agent-notice.ts +48 -0
  20. package/src/agent-team-whoami-http.test.ts +98 -0
  21. package/src/agent-teams-http.test.ts +330 -0
  22. package/src/agent-teams.ts +244 -0
  23. package/src/alias-baseline-2571.test.ts +162 -0
  24. package/src/alias-baseline.ts +113 -0
  25. package/src/alias-filter.test.ts +72 -0
  26. package/src/alias-filter.ts +42 -0
  27. package/src/all-status-cache.test.ts +31 -0
  28. package/src/all-status-cache.ts +37 -0
  29. package/src/anet-variant-real-daemon-http.test.ts +185 -0
  30. package/src/api-host-supervisors-can-create-nodes.test.ts +350 -0
  31. package/src/api-host-supervisors-fallback.test.ts +6 -7
  32. package/src/api-host-supervisors-runtime-readiness.test.ts +195 -0
  33. package/src/api-nodes-shape.test.ts +131 -4
  34. package/src/auth-abuse-counters.test.ts +144 -0
  35. package/src/auth-abuse-counters.ts +122 -0
  36. package/src/auth-layer-shape.test.ts +105 -0
  37. package/src/auth-password-change-cli-tokens-http.test.ts +423 -0
  38. package/src/auth-sessions-http.test.ts +260 -0
  39. package/src/auth-validate.test.ts +5 -1
  40. package/src/auth-weak-password-login.test.ts +176 -0
  41. package/src/auth.ts +641 -68
  42. package/src/backfill-node-ids-2664.test.ts +128 -0
  43. package/src/binding-generation-http.test.ts +141 -0
  44. package/src/blocked-exit-on-reply.test.ts +122 -0
  45. package/src/broadcast-fanout-2721.test.ts +149 -0
  46. package/src/broadcast-fanout.ts +117 -0
  47. package/src/build-commit-report-http.test.ts +219 -0
  48. package/src/build-info.test.ts +60 -0
  49. package/src/build-info.ts +85 -0
  50. package/src/chain-attempt-dedup.test.ts +447 -0
  51. package/src/clip.test.ts +36 -0
  52. package/src/clip.ts +48 -0
  53. package/src/clone-node.test.ts +269 -0
  54. package/src/clone-node.ts +289 -0
  55. package/src/codex-config-flags.ts +77 -0
  56. package/src/codex-fork-contract.ts +23 -0
  57. package/src/codex-fork-migration.test.ts +38 -0
  58. package/src/commhub-bin-args.test.ts +85 -0
  59. package/src/config-apply-sec1.test.ts +37 -0
  60. package/src/config-apply-validate.test.ts +188 -1
  61. package/src/config-apply-validate.ts +226 -3
  62. package/src/contracts/session-project-create.ts +14 -0
  63. package/src/contracts/session-source-delivery.ts +16 -0
  64. package/src/contracts/session-source-directory.ts +54 -0
  65. package/src/contracts/session-source-evidence.ts +72 -0
  66. package/src/contracts/session-source-execution.ts +24 -0
  67. package/src/contracts/session-source-transport.ts +18 -0
  68. package/src/cors-origins.test.ts +73 -0
  69. package/src/create-node-blocked-gate.test.ts +365 -0
  70. package/src/create-node-error-domain.test.ts +127 -0
  71. package/src/create-node-network-id.test.ts +91 -0
  72. package/src/create-node-tool-schema.test.ts +59 -0
  73. package/src/create-node-unicode-name.test.ts +126 -0
  74. package/src/create-node-validate.test.ts +199 -7
  75. package/src/create-node-validate.ts +232 -15
  76. package/src/create-node-workdir.test.ts +298 -0
  77. package/src/create-node.ts +88 -23
  78. package/src/daemon-provider-snapshots.test.ts +453 -0
  79. package/src/daemon-provider-snapshots.ts +327 -0
  80. package/src/daemon-token-owner-http.test.ts +346 -0
  81. package/src/dashboard-slash-routing-http.test.ts +109 -0
  82. package/src/db-adapter-guard.test.ts +148 -0
  83. package/src/db-adapter-translate.test.ts +128 -0
  84. package/src/db-adapter.ts +377 -91
  85. package/src/db-timestamp.test.ts +38 -0
  86. package/src/db-timestamp.ts +15 -0
  87. package/src/db.ts +1334 -154
  88. package/src/delivered-without-push.test.ts +140 -0
  89. package/src/department-groups-http.test.ts +209 -0
  90. package/src/department-groups-sync-http.test.ts +328 -0
  91. package/src/department-groups.ts +434 -0
  92. package/src/department-heads-http.test.ts +350 -0
  93. package/src/department-heads.ts +226 -0
  94. package/src/departments-agent-count.test.ts +139 -0
  95. package/src/departments-http.test.ts +185 -0
  96. package/src/departments-mcp-error-domain.test.ts +135 -0
  97. package/src/departments-mcp.test.ts +128 -0
  98. package/src/departments.ts +318 -0
  99. package/src/desktop-message-seam.test.ts +150 -0
  100. package/src/desktop-message.test.ts +368 -0
  101. package/src/dm-file-scope-http.test.ts +227 -0
  102. package/src/empty-node-sweeper.test.ts +104 -0
  103. package/src/empty-node-sweeper.ts +88 -0
  104. package/src/env-transport-gate-http.test.ts +240 -0
  105. package/src/env-transport-gate.ts +80 -0
  106. package/src/env-transport-policy.ts +56 -0
  107. package/src/etag-of.test.ts +57 -0
  108. package/src/event-loop-lag.test.ts +180 -0
  109. package/src/event-loop-lag.ts +201 -0
  110. package/src/expiry-counters.test.ts +187 -0
  111. package/src/expiry-counters.ts +227 -0
  112. package/src/expiry-evidence-db.test.ts +103 -0
  113. package/src/ext-token-shared.test.ts +60 -0
  114. package/src/ext-validation-regression.test.ts +10 -17
  115. package/src/external-schedule-edits-http.test.ts +321 -0
  116. package/src/external-schedule-edits-timestamps.test.ts +64 -0
  117. package/src/external-schedule-edits.ts +327 -0
  118. package/src/file-download-authz-dev-open.test.ts +1 -1
  119. package/src/file-download-authz.test.ts +25 -4
  120. package/src/file-download-date-bucket.test.ts +1 -1
  121. package/src/file-network-scope-dev-open.test.ts +1 -1
  122. package/src/file-network-scope.test.ts +7 -6
  123. package/src/group-membership-events-http.test.ts +264 -0
  124. package/src/group-messages-http.test.ts +483 -0
  125. package/src/group-messages.ts +297 -0
  126. package/src/health-anon-readers.ts +67 -0
  127. package/src/health-host-disk-2756.test.ts +71 -0
  128. package/src/health-identity-root.test.ts +98 -0
  129. package/src/health-redaction.test.ts +1603 -7
  130. package/src/health-status-reasons.test.ts +84 -0
  131. package/src/host-supervisor-identity-http.test.ts +152 -0
  132. package/src/host-supervisor-identity.ts +92 -0
  133. package/src/host-supervisors-daemon-version.test.ts +137 -0
  134. package/src/http-gzip.test.ts +94 -0
  135. package/src/http-gzip.ts +112 -0
  136. package/src/hub-catalog-read-http.test.ts +664 -0
  137. package/src/hub-provider-config.test.ts +166 -0
  138. package/src/hub-provider-config.ts +202 -0
  139. package/src/hub-timestamp.test.ts +38 -0
  140. package/src/hub-timestamp.ts +27 -0
  141. package/src/human-dm.ts +215 -0
  142. package/src/human-inbox.ts +42 -0
  143. package/src/inbox-caller.ts +49 -0
  144. package/src/inbox-count-sse.test.ts +318 -0
  145. package/src/inbox-count.ts +29 -0
  146. package/src/index.ts +6 -2
  147. package/src/launched-by-cli-report-http.test.ts +155 -0
  148. package/src/license-state.test.ts +105 -0
  149. package/src/license-state.ts +48 -0
  150. package/src/lifecycle-error-domain.test.ts +149 -0
  151. package/src/list-ack-error-domain.test.ts +108 -0
  152. package/src/list-host-supervisors.test.ts +15 -4
  153. package/src/list-tasks-omit-default.test.ts +84 -0
  154. package/src/list-tasks-since-last.test.ts +100 -0
  155. package/src/list-tasks-since.test.ts +104 -0
  156. package/src/mcp-context-cost-http.test.ts +127 -0
  157. package/src/mcp-inflight.test.ts +92 -0
  158. package/src/mcp-inflight.ts +38 -0
  159. package/src/mcp-projects-events-http.test.ts +168 -0
  160. package/src/mcp-route-label-http.test.ts +120 -0
  161. package/src/mcp-write-network-resolution.test.ts +21 -0
  162. package/src/member-audit-network-id-http.test.ts +93 -0
  163. package/src/member-presence-http.test.ts +210 -0
  164. package/src/messages-ack-by-agent-http.test.ts +142 -0
  165. package/src/migrate-sqlite-to-pg.test.ts +47 -0
  166. package/src/migrate-sqlite-to-pg.ts +263 -0
  167. package/src/model-auth-notify-http.test.ts +181 -0
  168. package/src/model-auth-notify.ts +116 -0
  169. package/src/network-name-http.test.ts +75 -0
  170. package/src/network-quota-config.test.ts +100 -0
  171. package/src/network-rules-http.test.ts +169 -0
  172. package/src/network-rules.ts +129 -0
  173. package/src/network-scope.ts +222 -3
  174. package/src/network-token-membership-http.test.ts +186 -0
  175. package/src/node-alias-control.ts +12 -0
  176. package/src/node-attrs.test.ts +47 -2
  177. package/src/node-caller-identity-http.test.ts +1108 -0
  178. package/src/node-config-last-update.test.ts +126 -0
  179. package/src/node-config-last-update.ts +107 -0
  180. package/src/node-create-request-status-http.test.ts +105 -0
  181. package/src/node-daemon-bindings.test.ts +142 -0
  182. package/src/node-daemon-bindings.ts +135 -0
  183. package/src/node-failure-alert.test.ts +150 -0
  184. package/src/node-failure-alert.ts +177 -0
  185. package/src/node-files-transport.test.ts +350 -0
  186. package/src/node-health-codex-login.test.ts +120 -0
  187. package/src/node-health-dispatch-http.test.ts +373 -0
  188. package/src/node-health-guard-origin.test.ts +98 -0
  189. package/src/node-health-guard.ts +121 -0
  190. package/src/node-health-passthrough.test.ts +115 -0
  191. package/src/node-health-store.ts +101 -0
  192. package/src/node-id-alias.test.ts +190 -0
  193. package/src/node-identity-conflict-http.test.ts +269 -0
  194. package/src/node-identity-conflict.ts +142 -0
  195. package/src/node-identity-mismatch.test.ts +74 -0
  196. package/src/node-in-flight-tasks.ts +31 -0
  197. package/src/node-inbox-allowlist-http.test.ts +320 -0
  198. package/src/node-lifecycle-controllable.test.ts +64 -0
  199. package/src/node-lifecycle-controllable.ts +53 -0
  200. package/src/node-lifecycle-read-http.test.ts +257 -0
  201. package/src/node-lifecycle-read.ts +126 -0
  202. package/src/node-logs-transport.test.ts +266 -0
  203. package/src/node-peer-allowlist.test.ts +114 -0
  204. package/src/node-permissions-http.test.ts +901 -0
  205. package/src/node-permissions.ts +627 -0
  206. package/src/node-request-retention.test.ts +281 -0
  207. package/src/node-request-retention.ts +120 -0
  208. package/src/node-secret-rest-http.test.ts +190 -0
  209. package/src/node-secret-vault-inject.test.ts +132 -0
  210. package/src/node-security-write-gate.test.ts +72 -0
  211. package/src/node-serviceability.test.ts +86 -0
  212. package/src/node-serviceability.ts +124 -0
  213. package/src/node-session-control-http.test.ts +398 -0
  214. package/src/node-session-control.ts +316 -0
  215. package/src/node-skills-transport.test.ts +212 -0
  216. package/src/node-token-identity.ts +35 -0
  217. package/src/node-token-ownership.ts +51 -0
  218. package/src/node-token-privilege-http.test.ts +224 -0
  219. package/src/node-token-usage.test.ts +128 -0
  220. package/src/node-token-usage.ts +228 -0
  221. package/src/not-found-api-http.test.ts +67 -0
  222. package/src/observer-avatar-http.test.ts +103 -10
  223. package/src/observer-push.test.ts +76 -0
  224. package/src/opencode-catalog-report-http.test.ts +139 -0
  225. package/src/opencode-v2-catalog.test.ts +282 -0
  226. package/src/opencode-v2-catalog.ts +357 -0
  227. package/src/package-self-contained.test.ts +32 -0
  228. package/src/package-version-consistency.test.ts +25 -0
  229. package/src/parent-infer.test.ts +82 -0
  230. package/src/parent-infer.ts +110 -0
  231. package/src/parent-source-marker.test.ts +70 -0
  232. package/src/parent-source-orphan.test.ts +121 -0
  233. package/src/password-network-tokens.ts +25 -0
  234. package/src/peer-reply-atomic.test.ts +462 -0
  235. package/src/peer-reply-capability.test.ts +70 -0
  236. package/src/pg-worker.ts +87 -0
  237. package/src/poll-pacing.test.ts +74 -0
  238. package/src/poll-pacing.ts +123 -0
  239. package/src/probe-provider-error-domain.test.ts +145 -0
  240. package/src/project-dir-warn-clear-http.test.ts +132 -0
  241. package/src/project-viewer-can-http.test.ts +116 -0
  242. package/src/provider-skill-error-domain.test.ts +130 -0
  243. package/src/provider-tools-shape.test.ts +165 -0
  244. package/src/push.test.ts +20 -10
  245. package/src/push.ts +373 -9
  246. package/src/redact-tokens.test.ts +86 -0
  247. package/src/redact-tokens.ts +43 -0
  248. package/src/rejection-counters.test.ts +72 -0
  249. package/src/rejection-counters.ts +173 -0
  250. package/src/rename.ts +38 -10
  251. package/src/reply-target-derivation.test.ts +96 -0
  252. package/src/report-status-handover-capabilities-http.test.ts +124 -0
  253. package/src/report-status-host-schema.test.ts +272 -0
  254. package/src/report-status-resume-id-handover.test.ts +184 -0
  255. package/src/report-status-secret-keys.test.ts +140 -0
  256. package/src/require-explicit-test-db.ts +9 -0
  257. package/src/requirement-due-reminders-http.test.ts +620 -0
  258. package/src/requirement-due-reminders.ts +416 -0
  259. package/src/requirement-events-http.test.ts +318 -0
  260. package/src/requirement-events.test.ts +45 -0
  261. package/src/requirement-events.ts +144 -0
  262. package/src/requirement-notify.ts +165 -0
  263. package/src/requirement-participant-notify-http.test.ts +313 -0
  264. package/src/requirement-tag-ops-http.test.ts +454 -0
  265. package/src/requirement-tag-tree-http.test.ts +275 -0
  266. package/src/requirement-tag-tree.ts +127 -0
  267. package/src/requirement-tags.ts +102 -0
  268. package/src/requirements-abandoned-http.test.ts +236 -0
  269. package/src/requirements-assignee-drift.test.ts +154 -0
  270. package/src/requirements-comment-http.test.ts +174 -0
  271. package/src/requirements-completed-at-migration.test.ts +70 -0
  272. package/src/requirements-errors-mcp-http.test.ts +164 -0
  273. package/src/requirements-errors.ts +158 -0
  274. package/src/requirements-etag-http.test.ts +91 -0
  275. package/src/requirements-http.test.ts +709 -0
  276. package/src/requirements-last-event-http.test.ts +349 -0
  277. package/src/requirements-list-mcp-slim-http.test.ts +155 -0
  278. package/src/requirements-list-slim-http.test.ts +324 -0
  279. package/src/requirements-mcp.test.ts +180 -0
  280. package/src/requirements-migrate.ts +283 -0
  281. package/src/requirements-owner-strict-mcp-http.test.ts +145 -0
  282. package/src/requirements-people-http.test.ts +114 -0
  283. package/src/requirements-people-mcp-http.test.ts +231 -0
  284. package/src/requirements-people.ts +196 -0
  285. package/src/requirements-priority-lowest.test.ts +114 -0
  286. package/src/requirements-projects-network-echo.test.ts +57 -0
  287. package/src/requirements-projects-parent-http.test.ts +123 -0
  288. package/src/requirements-search-http.test.ts +182 -0
  289. package/src/requirements-search.test.ts +32 -0
  290. package/src/requirements-search.ts +145 -0
  291. package/src/requirements-seq-http.test.ts +193 -0
  292. package/src/requirements-seq-migration.test.ts +63 -0
  293. package/src/requirements-start-date.test.ts +125 -0
  294. package/src/requirements-stats-http.test.ts +357 -0
  295. package/src/requirements-stats.ts +195 -0
  296. package/src/requirements-status-participants-http.test.ts +222 -0
  297. package/src/requirements-upgrade-e2e.test.ts +126 -0
  298. package/src/requirements-upgrade-migration.test.ts +98 -0
  299. package/src/requirements.ts +2205 -0
  300. package/src/resolve-port.test.ts +57 -0
  301. package/src/resolve-port.ts +44 -0
  302. package/src/rest-alias-network-fallback-http.test.ts +123 -0
  303. package/src/rest-alias-network-fallback.test.ts +60 -0
  304. package/src/rest-alias-network-fallback.ts +65 -0
  305. package/src/rest-explicit-columns-http.test.ts +266 -0
  306. package/src/rest-identity.test.ts +130 -0
  307. package/src/rest-identity.ts +141 -0
  308. package/src/rest-projections.ts +72 -0
  309. package/src/rest-read-network-real-chain.test.ts +97 -0
  310. package/src/rest-write-network-resolution.test.ts +133 -0
  311. package/src/restart-readiness-http.test.ts +121 -0
  312. package/src/restricted-files.ts +76 -0
  313. package/src/retention-first-sweep-quiet.test.ts +31 -0
  314. package/src/retention.test.ts +100 -40
  315. package/src/retention.ts +423 -104
  316. package/src/route-callers-http.test.ts +120 -0
  317. package/src/route-timing.test.ts +218 -0
  318. package/src/route-timing.ts +262 -0
  319. package/src/rules-file-duplicate-alias.test.ts +234 -0
  320. package/src/rules-file-session-target.test.ts +207 -0
  321. package/src/rules-file-transport.test.ts +280 -0
  322. package/src/runtime-label.test.ts +22 -0
  323. package/src/runtime-label.ts +21 -0
  324. package/src/runtime-readiness.ts +90 -0
  325. package/src/schedule-agent-mcp-http.test.ts +486 -0
  326. package/src/schedule-agent.ts +252 -0
  327. package/src/schedule-starved.test.ts +92 -0
  328. package/src/schedule-starved.ts +114 -0
  329. package/src/scheduled-backoff-http.test.ts +203 -0
  330. package/src/scheduled-backoff.ts +64 -0
  331. package/src/scheduled-doorbell-nodeless-session.test.ts +134 -0
  332. package/src/scheduled-failure-backoff-2622.test.ts +145 -0
  333. package/src/scheduled-failure-code.test.ts +73 -0
  334. package/src/scheduled-failure-code.ts +105 -0
  335. package/src/scheduled-failures-http.test.ts +279 -0
  336. package/src/scheduled-failures.ts +425 -0
  337. package/src/scheduled-noprogress-backoff-2622.test.ts +163 -0
  338. package/src/scheduled-offline-backoff-probe.test.ts +56 -0
  339. package/src/scheduled-offline.test.ts +131 -0
  340. package/src/scheduled-offline.ts +66 -0
  341. package/src/scheduled-outcome-guidance-http.test.ts +139 -0
  342. package/src/scheduled-outcome-guidance.ts +9 -0
  343. package/src/scheduled-reply-unread-http.test.ts +212 -0
  344. package/src/scheduled-requirement-wake-http.test.ts +289 -0
  345. package/src/scheduled-requirement-wake.ts +125 -0
  346. package/src/scheduled-run-terminal.test.ts +290 -0
  347. package/src/scheduled-skip-blocking-task.test.ts +120 -0
  348. package/src/scheduled-skip-path-backoff-2622.test.ts +98 -0
  349. package/src/scheduled-stuck-http.test.ts +316 -0
  350. package/src/scheduled-stuck-notice-cap.test.ts +80 -0
  351. package/src/scheduled-stuck.ts +219 -0
  352. package/src/scheduled-tasks-http.test.ts +679 -0
  353. package/src/scheduled-tasks.ts +980 -0
  354. package/src/scheduled-work-outcome-http.test.ts +154 -0
  355. package/src/scheduled-work-outcome.ts +50 -0
  356. package/src/scoped-secrets.ts +167 -0
  357. package/src/secret-echo-negative-control.test.ts +118 -0
  358. package/src/send-dedup-request-id.test.ts +229 -0
  359. package/src/send-reply-agent-warning.test.ts +38 -38
  360. package/src/send-reply-alias-optional.test.ts +131 -0
  361. package/src/send-reply-attachments.test.ts +28 -7
  362. package/src/send_dedup.test.ts +54 -0
  363. package/src/send_dedup.ts +52 -6
  364. package/src/serve-error.test.ts +73 -0
  365. package/src/serve-error.ts +56 -0
  366. package/src/server.ts +5103 -377
  367. package/src/session-fork-store.test.ts +43 -0
  368. package/src/session-fork-store.ts +51 -0
  369. package/src/session-project-attach-migration.test.ts +23 -0
  370. package/src/session-project-attach-native.test.ts +123 -0
  371. package/src/session-project-create-http.test.ts +408 -0
  372. package/src/session-project-create-native.test.ts +292 -0
  373. package/src/session-project-create.ts +159 -0
  374. package/src/session-source-admission-store.ts +58 -0
  375. package/src/session-source-create.test.ts +155 -0
  376. package/src/session-source-create.ts +97 -0
  377. package/src/session-source-delivery.ts +114 -0
  378. package/src/session-source-directory-http.test.ts +196 -0
  379. package/src/session-source-evidence.test.ts +905 -0
  380. package/src/session-source-evidence.ts +191 -0
  381. package/src/session-source-execution.ts +87 -0
  382. package/src/session-source-grant.test.ts +117 -0
  383. package/src/session-source-grant.ts +78 -0
  384. package/src/session-source-issuer.test.ts +250 -0
  385. package/src/session-source-issuer.ts +164 -0
  386. package/src/session-source-transport.ts +381 -0
  387. package/src/session-task-on-dispatch.ts +14 -0
  388. package/src/session-token-ownership-http.test.ts +122 -0
  389. package/src/shared/codex-inventory.ts +41 -0
  390. package/src/shared/daemon-provider-login.ts +31 -0
  391. package/src/shared/daemon-provider-snapshot.ts +52 -0
  392. package/src/shared/external-schedule-contract.ts +60 -0
  393. package/src/shared/node-name.test.ts +62 -0
  394. package/src/shared/node-name.ts +161 -0
  395. package/src/shared/probe-host-allowlist-drift.test.ts +45 -0
  396. package/src/shared/provider-application.ts +29 -0
  397. package/src/shared/provider-collection.ts +14 -0
  398. package/src/shared/provider-initialization.ts +8 -0
  399. package/src/shared/reserved-env-drift.test.ts +10 -0
  400. package/src/shared/scoped-secret-contract.ts +5 -0
  401. package/src/shared/task-content-limit-drift.test.ts +28 -0
  402. package/src/shared/task-content-limit.ts +25 -0
  403. package/src/side-thread-command-transport.test.ts +312 -0
  404. package/src/side-thread-command-transport.ts +318 -0
  405. package/src/side-thread-http-integration.test.ts +233 -0
  406. package/src/side-thread-http.ts +504 -0
  407. package/src/side-thread-production.test.ts +72 -0
  408. package/src/side-thread-production.ts +118 -0
  409. package/src/side-thread.test.ts +1067 -0
  410. package/src/side-thread.ts +2499 -0
  411. package/src/skillhub-http.test.ts +144 -0
  412. package/src/sqlite-close-checkpoint.test.ts +78 -0
  413. package/src/start-node.test.ts +265 -0
  414. package/src/start-request-error-domain.test.ts +182 -0
  415. package/src/start-skill-error-domain.test.ts +122 -0
  416. package/src/stats-versions-http.test.ts +65 -0
  417. package/src/status-alias-filter-http.test.ts +106 -0
  418. package/src/status-alias-resolver-http.test.ts +163 -0
  419. package/src/status-alias-resolver.ts +19 -0
  420. package/src/status-node-id-filter-http.test.ts +161 -0
  421. package/src/status-node-secrets-capable-http.test.ts +44 -0
  422. package/src/status-read-cache-http.test.ts +229 -0
  423. package/src/status-read-cache.ts +129 -0
  424. package/src/stop-delete-node.test.ts +567 -1
  425. package/src/task-access-http.test.ts +407 -0
  426. package/src/task-access.ts +420 -0
  427. package/src/task-activity.ts +60 -0
  428. package/src/task-auth-origin-http.test.ts +93 -0
  429. package/src/task-auth-origin.test.ts +24 -0
  430. package/src/task-auth-origin.ts +7 -0
  431. package/src/task-consumption.test.ts +512 -0
  432. package/src/task-diagnostic-http.test.ts +149 -0
  433. package/src/task-diagnostic.test.ts +115 -0
  434. package/src/task-diagnostic.ts +118 -0
  435. package/src/task-expiry-notice-http.test.ts +298 -0
  436. package/src/task-expiry-notice.ts +318 -0
  437. package/src/task-idempotency-mcp.test.ts +148 -0
  438. package/src/task-idempotency.test.ts +76 -0
  439. package/src/task-idempotency.ts +81 -0
  440. package/src/task-late-replies.ts +54 -0
  441. package/src/task-late-reply-http.test.ts +227 -0
  442. package/src/task-lifecycle-watcher-busy.test.ts +114 -0
  443. package/src/task-lifecycle-watcher.test.ts +209 -0
  444. package/src/task-lifecycle-watcher.ts +109 -0
  445. package/src/task-network-resolution-http.test.ts +140 -0
  446. package/src/task-not-found-error-domain.test.ts +117 -0
  447. package/src/task-offline-delivery-2668.test.ts +119 -0
  448. package/src/task-offline-delivery.ts +81 -0
  449. package/src/task-orphan-http.test.ts +287 -0
  450. package/src/task-orphan.ts +119 -0
  451. package/src/task-queue-ahead-http.test.ts +309 -0
  452. package/src/task-queue-ahead-scale.test.ts +236 -0
  453. package/src/task-queue-ahead.ts +186 -0
  454. package/src/task-rejection-log-http.test.ts +160 -0
  455. package/src/task-rejection-log.ts +61 -0
  456. package/src/task-sender-http.test.ts +143 -0
  457. package/src/task-stale-open-http.test.ts +292 -0
  458. package/src/task-stale-open.ts +103 -0
  459. package/src/tasks-pagination-http.test.ts +141 -0
  460. package/src/team-rules-status-http.test.ts +90 -0
  461. package/src/team-rules-status.test.ts +59 -0
  462. package/src/team-rules-status.ts +72 -0
  463. package/src/test-work-root.ts +18 -0
  464. package/src/tmux-allowlist.test.ts +48 -0
  465. package/src/token-usage-http.test.ts +156 -0
  466. package/src/tool-audience-http.test.ts +266 -0
  467. package/src/tool-audience.ts +130 -0
  468. package/src/tools-list-json-schema.test.ts +94 -0
  469. package/src/tools.ts +4557 -472
  470. package/src/update-node-config-error-domain.test.ts +107 -0
  471. package/src/uploads-http.test.ts +6 -4
  472. package/src/uploads.ts +23 -4
  473. package/src/user-avatar-http.test.ts +74 -0
  474. package/src/user-avatar-image.ts +160 -0
  475. package/src/user-avatar-migration.test.ts +25 -0
  476. package/src/user-avatar-upload-http.test.ts +353 -0
  477. package/src/user-inbox-by-agent-http.test.ts +189 -0
  478. package/src/user-inbox-netid-notnull.test.ts +122 -0
  479. package/src/user-inbox-read-http.test.ts +223 -0
  480. package/src/user-inbox-schema.test.ts +54 -0
  481. package/src/version-stats.test.ts +66 -0
  482. package/src/version-stats.ts +109 -0
@@ -0,0 +1,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
+ });
@@ -0,0 +1,104 @@
1
+ // #3119 —— list_tasks 的增量与「省掉 stats」。
2
+ //
3
+ // 生产实测(2026-11-05 近 6h):list_tasks 占全部工具调用 **35.7%**,是最大的一格;
4
+ // 提示词只能劝,改不了接口成本。这里补两个参数,让轮询本身变便宜:
5
+ // created_since 只取这之后创建的(空窗口回极短体)
6
+ // omit_stats 跳过按状态的全表 GROUP BY(轮询时它比任务列表还贵)
7
+ // server_time 服务端给水位,客户端别用本地时钟(差几秒就漏活或重复)
8
+ //
9
+ // 判据分四格,缺一格都只是「加了个参数」:
10
+ // ① created_since 真的过滤(旧的看不见、新的看得见)
11
+ // ② 镜像:不传 created_since ⇒ 行为与以前一致(旧调用方零影响)
12
+ // ③ omit_stats 真的不返回 stats,且返回值里明确写着 stats_omitted
13
+ // ④ server_time 一定在(两种分支都有),否则客户端拿不到水位
14
+ import './require-explicit-test-db';
15
+ import { afterAll, beforeEach, describe, expect, test } from 'bun:test';
16
+ import { db } from './db';
17
+ import { registerTools } from './tools';
18
+ import { McpServer } from '@modelcontextprotocol/sdk/server/mcp.js';
19
+
20
+ const net = 'net_list_tasks_since';
21
+ const user = 'u_list_tasks_since';
22
+ // username 必须等于某个 nodes/sessions 的 alias,否则受限成员过滤会把任务全挡掉
23
+ const alias = user;
24
+
25
+ function client() {
26
+ const handlers: Record<string, any> = {};
27
+ const server = new McpServer({ name: 't-since', version: '0' }) as any;
28
+ const tool = server.tool.bind(server);
29
+ server.tool = (name: string, desc: any, shape: any, handler: any) => { handlers[name] = handler; return tool(name, desc, shape, handler); };
30
+ registerTools(server, undefined, null, user, alias, false, null);
31
+ return async (name: string, args: any = {}) => JSON.parse((await handlers[name](args)).content[0].text);
32
+ }
33
+
34
+ function cleanup() {
35
+ db.run('DELETE FROM tasks WHERE task_id LIKE ?1', ['t_since_%']);
36
+ db.run('DELETE FROM nodes WHERE network_id=?1', [net]);
37
+ db.run('DELETE FROM network_members WHERE network_id=?1', [net]);
38
+ db.run('DELETE FROM networks WHERE network_id=?1', [net]);
39
+ db.run('DELETE FROM users WHERE user_id=?1', [user]);
40
+ }
41
+
42
+ beforeEach(() => {
43
+ cleanup();
44
+ db.run("INSERT INTO users(user_id,username,password_hash,role) VALUES(?1,?1,'x','user')", [user]);
45
+ db.run('INSERT INTO networks(network_id,network_name,owner_id) VALUES(?1,?1,?2)', [net, user]);
46
+ db.run("INSERT INTO network_members(user_id,network_id,role) VALUES(?1,?2,'owner')", [user, net]);
47
+ // caller 的 username 必须能被认成「本网络的 Agent」,否则 addAgentTimelineScope 会按
48
+ // 受限成员把任务全过滤掉(那是安全边界,不是 bug)。建一行 nodes 让它认得出。
49
+ db.run('INSERT INTO nodes(node_id,node_name,alias,network_id) VALUES(?1,?2,?2,?3)', ['n_since', alias, net]);
50
+ // 两条任务:一条旧、一条新(时间列是 TEXT,字典序即时间序)
51
+ db.run(`INSERT INTO tasks(task_id, from_name, to_name, status, content, created_at, network_id)
52
+ VALUES ('t_since_old', 'peer', ?1, 'delivered', 'old work', '2026-11-05 01:00:00', ?2)`, [alias, net]);
53
+ db.run(`INSERT INTO tasks(task_id, from_name, to_name, status, content, created_at, network_id)
54
+ VALUES ('t_since_new', 'peer', ?1, 'delivered', 'new work', '2026-11-05 09:00:00', ?2)`, [alias, net]);
55
+ });
56
+ afterAll(cleanup);
57
+
58
+ describe("#3119 list_tasks 的增量与水印", () => {
59
+ test("① created_since 生效:旧的看不见、新的看得见", async () => {
60
+ const call = client();
61
+ const r = await call('list_tasks', { alias, network_id: net, created_since: '2026-11-05 08:00:00', omit_stats: true, limit: 20 });
62
+ expect(r.ok).toBe(true);
63
+ expect(r.tasks.map((t: any) => t.task_id)).toEqual(['t_since_new']);
64
+ });
65
+
66
+ test("①b ISO 带 T/Z 传参也必须生效(字符串比较会在第 11 个字符判错)", async () => {
67
+ const call = client();
68
+ // 同一天的午夜:用 ISO 传,库里是 'YYYY-MM-DD HH:MM:SS'(空格)。
69
+ // 直接字符串比较 ⇒ ' ' < 'T' ⇒ 库里那条被判成"更早" ⇒ 返回空。
70
+ const r = await call('list_tasks', { alias, network_id: net, created_since: '2026-11-05T00:00:00Z', omit_stats: true, limit: 20 });
71
+ expect(r.tasks.map((t: any) => t.task_id).sort()).toEqual(['t_since_new', 't_since_old']);
72
+ });
73
+
74
+ test("② 镜像:不传 created_since ⇒ 两条都在(旧调用方零影响)", async () => {
75
+ const call = client();
76
+ const r = await call('list_tasks', { alias, network_id: net, limit: 20 });
77
+ expect(r.tasks.map((t: any) => t.task_id).sort()).toEqual(['t_since_new', 't_since_old']);
78
+ expect(r.stats).toBeDefined();
79
+ });
80
+
81
+ test("③ omit_stats ⇒ 不返回 stats,并明确写 stats_omitted(不是静默少一格)", async () => {
82
+ const call = client();
83
+ const r = await call('list_tasks', { alias, network_id: net, omit_stats: true, limit: 20 });
84
+ expect(r.stats).toBeUndefined();
85
+ expect(r.stats_omitted).toBe(true);
86
+ });
87
+
88
+ test("④ 两种分支都带 server_time(客户端的水位来源)", async () => {
89
+ const call = client();
90
+ const a = await call('list_tasks', { alias, network_id: net, limit: 20 });
91
+ const b = await call('list_tasks', { alias, network_id: net, omit_stats: true, limit: 20 });
92
+ expect(typeof a.server_time).toBe('string');
93
+ expect(typeof b.server_time).toBe('string');
94
+ expect(Number.isNaN(Date.parse(a.server_time))).toBe(false);
95
+ });
96
+
97
+ test("空窗口 ⇒ 短响应(tasks 空、无 stats、仍有 server_time)", async () => {
98
+ const call = client();
99
+ const r = await call('list_tasks', { alias, network_id: net, created_since: '2099-01-01 00:00:00', omit_stats: true, limit: 20 });
100
+ expect(r.tasks).toEqual([]);
101
+ expect(r.count).toBe(0);
102
+ expect(typeof r.server_time).toBe('string');
103
+ });
104
+ });
@@ -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
+ });
@@ -0,0 +1,92 @@
1
+ // #2363 —— MCP 在飞计数的单测 + 源码断言。
2
+ //
3
+ // 计数值本身很小,但它是“RSS 尖峰能不能被解释”的唯一在线指标:`sse_connections`
4
+ // 只反映长连接,看不到同秒打进来的一批短请求。这里钉住三件事:
5
+ // 1. enter/leave 必须配平(含重复 leave 不把计数打成负数);
6
+ // 2. 峰值要能记住高水位,并能被显式重置;
7
+ // 3. server.ts 必须在**任何 await 之前**进入计数,并且在“正常关闭 / 抛异常”
8
+ // 两条路径上都退出计数——少一条就会让指标永远偏高,比没有指标更糟。
9
+
10
+ import { describe, expect, test, beforeEach } from "bun:test";
11
+ import { readFileSync } from "node:fs";
12
+ import { join } from "node:path";
13
+ import {
14
+ enterMcpInflight,
15
+ leaveMcpInflight,
16
+ getMcpInflightStats,
17
+ resetMcpInflightPeak,
18
+ } from "./mcp-inflight.js";
19
+
20
+ beforeEach(() => {
21
+ // 模块级单例:每个用例从 0 开始,避免用例顺序影响。
22
+ while (getMcpInflightStats().inflight > 0) leaveMcpInflight();
23
+ resetMcpInflightPeak();
24
+ });
25
+
26
+ describe("#2363 mcp inflight counter", () => {
27
+ test("enter/leave 配平,peak 记住高水位且不自己回落", () => {
28
+ expect(getMcpInflightStats()).toEqual({ inflight: 0, peak: 0 });
29
+ enterMcpInflight();
30
+ enterMcpInflight();
31
+ enterMcpInflight();
32
+ expect(getMcpInflightStats()).toEqual({ inflight: 3, peak: 3 });
33
+ leaveMcpInflight();
34
+ leaveMcpInflight();
35
+ // 当前只有 1 条在飞,但峰值仍是 3 —— 峰值是“撞过悬崖没有”的证据。
36
+ expect(getMcpInflightStats()).toEqual({ inflight: 1, peak: 3 });
37
+ leaveMcpInflight();
38
+ expect(getMcpInflightStats()).toEqual({ inflight: 0, peak: 3 });
39
+ });
40
+
41
+ test("多余的 leave 不会把计数打成负数", () => {
42
+ leaveMcpInflight();
43
+ leaveMcpInflight();
44
+ expect(getMcpInflightStats().inflight).toBe(0);
45
+ });
46
+
47
+ test("reset 把峰值对齐到当前在飞数(不会把峰值压到低于现况)", () => {
48
+ enterMcpInflight();
49
+ enterMcpInflight();
50
+ expect(getMcpInflightStats().peak).toBe(2);
51
+ leaveMcpInflight();
52
+ resetMcpInflightPeak();
53
+ expect(getMcpInflightStats()).toEqual({ inflight: 1, peak: 1 });
54
+ });
55
+ });
56
+
57
+ describe("#2363 server wiring (source assertions)", () => {
58
+ const src = readFileSync(join(import.meta.dir, "server.ts"), "utf8");
59
+
60
+ test("进入计数发生在创建 transport 之前(请求体解析阶段也要计入)", () => {
61
+ const enterAt = src.indexOf("enterMcpInflight();");
62
+ const transportAt = src.indexOf("new WebStandardStreamableHTTPServerTransport({", enterAt);
63
+ expect(enterAt).toBeGreaterThan(0);
64
+ expect(transportAt).toBeGreaterThan(enterAt);
65
+ });
66
+
67
+ test("两条退出路径都在:handleRequest 抛异常时、以及 MCP server 关闭后", () => {
68
+ // 抛异常路径
69
+ expect(src).toContain("settleMcpInflight();\n throw e;");
70
+ // 正常路径(setImmediate 里 close 完成后结算,且重复调用安全)
71
+ expect(src).toContain("mcpServer.close().catch(() => {}).finally(settleMcpInflight)");
72
+ // 幂等闸门:只允许真正减一次
73
+ expect(src).toContain("if (mcpInflightSettled) return;");
74
+ });
75
+
76
+ test("/health 暴露的是聚合值(匿名也安全),且没有 new 的按会话明细", () => {
77
+ expect(src).toContain("mcp_inflight: getMcpInflightStats().inflight,");
78
+ expect(src).toContain("mcp_inflight_peak: getMcpInflightStats().peak,");
79
+ expect(src).not.toContain("mcp_inflight_sessions");
80
+ });
81
+
82
+ test("这一版只观测:/mcp 入口不得出现 429 / 拒绝分支", () => {
83
+ const mcpStart = src.indexOf('if (url.pathname === "/mcp") {');
84
+ const mcpEnd = src.indexOf("// ── #461 SSE network observer stream ──", mcpStart);
85
+ expect(mcpStart).toBeGreaterThan(0);
86
+ expect(mcpEnd).toBeGreaterThan(mcpStart);
87
+ const block = src.slice(mcpStart, mcpEnd);
88
+ expect(block).not.toContain("429");
89
+ expect(block).not.toContain("hub_busy");
90
+ expect(block).not.toContain("Retry-After");
91
+ });
92
+ });
@@ -0,0 +1,38 @@
1
+ // #2363 —— MCP 在飞计数(先只观测,不拦请求)。
2
+ //
3
+ // 为什么需要它:隔离 Hub 上用**生产库副本**实测,RSS 与“同时在飞的 MCP 请求数”
4
+ // 成正比(≈1.2–1.4 MB/条;`send_message` 与 `get_inbox` 同形),而与吞吐无关——
5
+ // 顺序发 3,255 条/60s(≈54 条/秒)时 RSS 稳定在 151–156 MB,而 50/100/200 并发
6
+ // 的峰值是 249/446/689 MB。`/health` 里的 `sse_connections` 只反映长连接,看不到
7
+ // 这个量,所以生产上“为什么 RSS 突然抬到 450 MB”一直只能事后猜。
8
+ //
9
+ // 本模块只做计数与峰值,**不拒绝、不排队、不改任何响应**——限流(有界队列 + 429)
10
+ // 是另一步,需要先有一天的真实分布再定上限。见 docs/runbooks/hub-memory-and-sse.md。
11
+
12
+ let inflight = 0;
13
+ let peak = 0;
14
+
15
+ /** /mcp 进入时调用(在任何 await 之前,保证计入请求体解析阶段)。 */
16
+ export function enterMcpInflight(): void {
17
+ inflight += 1;
18
+ if (inflight > peak) peak = inflight;
19
+ }
20
+
21
+ /** /mcp 结束时调用(响应对象产出且 MCP server 已关闭);重复调用安全。 */
22
+ export function leaveMcpInflight(): void {
23
+ if (inflight > 0) inflight -= 1;
24
+ }
25
+
26
+ /**
27
+ * 当前在飞数与**自上次 reset 以来的峰值**。
28
+ * 峰值是“滚动高水位”,不会自己回落——运维看它判断是否撞到过悬崖,
29
+ * 看 `inflight` 判断现在是否还在里面。
30
+ */
31
+ export function getMcpInflightStats(): { inflight: number; peak: number } {
32
+ return { inflight, peak };
33
+ }
34
+
35
+ /** 把峰值重置为当前在飞数(运维定位完一次尖峰后调用,或测试用)。 */
36
+ export function resetMcpInflightPeak(): void {
37
+ peak = inflight;
38
+ }