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

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 +1740 -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 +437 -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,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
+ }
@@ -0,0 +1,165 @@
1
+ // MCP projects_create / projects_update / requirements_events(app 任务页审计 2026-10-02 M3:Agent 能做人能做的)。
2
+ // HTTP 集成测试(真实 Bun.serve,私有端口,临时库)。三个工具都走 app 用的同一套 REST 处理(handleRequirementsRequest),
3
+ // 所以这里不另抄一份权限规则:对每类调用者(网络 owner、全部任务成员、仅相关任务成员、viewer、节点令牌)都同时调
4
+ // MCP 和 REST,断言状态码 / 结果逐项一致。再钉住正向行为(建 / 改名 / 归档 / 取消归档、读流水、"#N")和工具出现在 tools/list 里。
5
+
6
+ import { describe, expect, test, beforeAll, afterAll } from "bun:test";
7
+ import { mkdtempSync, rmSync } from "fs";
8
+ import { join } from "path";
9
+ import { tmpdir } from "os";
10
+ import { register, createNetworkTokenForNode } from "./auth.js";
11
+ import { db } from "./db.js";
12
+
13
+ const DIR = mkdtempSync(join(tmpdir(), "anet-mcp-projects-events-"));
14
+ let BASE = "";
15
+ let hub: any = null;
16
+ const PW = "McpProjectsEventsPassw0rd!x";
17
+ let NET = "";
18
+ const U: Record<string, { token: string; id: string }> = {};
19
+
20
+ async function rest(token: string, method: string, path: string, body?: unknown) {
21
+ const res = await fetch(`${BASE}${path}`, { method, headers: { Authorization: `Bearer ${token}`, "Content-Type": "application/json" }, body: body === undefined ? undefined : JSON.stringify(body) });
22
+ const text = await res.text();
23
+ let json: any = null;
24
+ try { json = JSON.parse(text); } catch {}
25
+ return { status: res.status, body: json };
26
+ }
27
+ async function rpc(token: string, method: string, params?: unknown): Promise<any> {
28
+ const res = await fetch(`${BASE}/mcp`, {
29
+ method: "POST",
30
+ headers: { Authorization: `Bearer ${token}`, "Content-Type": "application/json", Accept: "application/json, text/event-stream", "MCP-Protocol-Version": "2025-03-26" },
31
+ body: JSON.stringify({ jsonrpc: "2.0", id: 1, method, ...(params === undefined ? {} : { params }) }),
32
+ });
33
+ const raw = await res.text();
34
+ const lines = raw.split("\n").filter(x => x.startsWith("data:"));
35
+ return lines.length ? JSON.parse(lines.at(-1)!.slice(5).trim()) : JSON.parse(raw);
36
+ }
37
+ async function mcp(token: string, name: string, args: Record<string, unknown>): Promise<any> {
38
+ const out = await rpc(token, "tools/call", { name, arguments: args });
39
+ return JSON.parse(out.result.content[0].text);
40
+ }
41
+ // MCP error bodies from the REST handler carry its status (requirementsCall). Anything else that isn't ok (e.g. a tool-level
42
+ // gate) is NOT a success — a body without `status` must never be read as the 2xx (that hid a gate in the first draft).
43
+ const mcpStatus = (r: any, okStatus: number) => (r?.ok === true || (r && r.ok === undefined && (r.project || r.events)) ? okStatus : typeof r?.status === "number" ? r.status : -1);
44
+
45
+ beforeAll(async () => {
46
+ process.env.COMMHUB_DB ||= join(DIR, "hub.db");
47
+ process.env.COMMHUB_UPLOADS_DIR = join(DIR, "uploads");
48
+ process.env.HOST = "127.0.0.1";
49
+ const a = register(`mpe_owner_${Date.now()}`, PW, undefined, "Owner");
50
+ expect(a.ok).toBe(true);
51
+ U.owner = { token: a.token!, id: a.user!.user_id };
52
+ NET = a.network_id!;
53
+ db.run("UPDATE users SET role = 'admin' WHERE user_id = ?1", [U.owner.id]);
54
+ const mod: any = await import("./server.js");
55
+ hub = mod.bootServer({ port: 0, hostname: "127.0.0.1" });
56
+ BASE = `http://127.0.0.1:${hub.port}`;
57
+ const mk = async (username: string, role: string) => {
58
+ expect((await rest(U.owner.token, "POST", "/api/admin/users", { username, password: PW, network_id: NET, role })).status).toBe(200);
59
+ const login = await rest("", "POST", "/api/auth/login", { username, password: PW });
60
+ expect(login.status).toBe(200);
61
+ return { token: login.body.token as string, id: login.body.user.user_id as string };
62
+ };
63
+ const stamp = Date.now();
64
+ U.member = await mk(`mpe_member_${stamp}`, "member");
65
+ U.scoped = await mk(`mpe_scoped_${stamp}`, "member");
66
+ U.viewer = await mk(`mpe_viewer_${stamp}`, "viewer");
67
+ db.run("UPDATE network_members SET task_access = 'all' WHERE network_id = ?1 AND user_id = ?2", [NET, U.member.id]);
68
+ expect((await rest(U.owner.token, "PUT", `/api/networks/${NET}/members/${U.scoped.id}/task-grants`, { task_access: "scoped", project_grants: [] })).status).toBe(200);
69
+ const node = createNetworkTokenForNode(U.owner.id, NET, "mpe-node", "node_mpe");
70
+ U.node = { token: node.token!, id: "node_mpe" };
71
+ }, 30_000);
72
+
73
+ afterAll(() => {
74
+ try { hub?.stop?.(true); } catch {}
75
+ try { rmSync(DIR, { recursive: true, force: true }); } catch {}
76
+ });
77
+
78
+ describe("discoverable", () => {
79
+ test("tools/list carries the three tools with descriptions", async () => {
80
+ const list = await rpc(U.owner.token, "tools/list");
81
+ const byName = new Map((list.result.tools as any[]).map(t => [t.name, t]));
82
+ for (const n of ["projects_create", "projects_update", "requirements_events"]) {
83
+ expect(byName.has(n)).toBe(true);
84
+ expect(String(byName.get(n).description).length).toBeGreaterThan(40);
85
+ }
86
+ expect(String(byName.get("projects_list").description)).toContain("projects_create");
87
+ });
88
+ });
89
+
90
+ describe("projects_create / projects_update", () => {
91
+ test("owner: create, rename, recolour, archive, unarchive — same rows the app sees", async () => {
92
+ const created = await mcp(U.owner.token, "projects_create", { network_id: NET, name: "mpe-项目甲" });
93
+ expect(created.ok).toBe(true);
94
+ const id = created.project.id as string;
95
+ expect(created.project.name).toBe("mpe-项目甲");
96
+ const renamed = await mcp(U.owner.token, "projects_update", { network_id: NET, id, name: "mpe-项目乙", color: "#16a34a" });
97
+ // 2026-10-31 —— **精确键集**(#3171):项目更新回执是 `{ok, project}` 两键;
98
+ // 多给一格(比如回显整个项目集合)会让「一次更新」变成「一次列表」。
99
+ expect(Object.keys(renamed).sort()).toEqual(["ok", "project"]);
100
+ expect(renamed.project.name).toBe("mpe-项目乙");
101
+ expect(renamed.project.color).toBe("#16a34a");
102
+ expect((await mcp(U.owner.token, "projects_update", { network_id: NET, id, archived: true })).project.archived).toBe(true);
103
+ const seen = await rest(U.owner.token, "GET", `/api/requirements/projects?network_id=${NET}`);
104
+ expect(seen.body.projects.find((p: any) => p.id === id).archived).toBe(true);
105
+ expect((await mcp(U.owner.token, "projects_update", { network_id: NET, id, archived: false })).project.archived).toBe(false);
106
+ });
107
+
108
+ test("validation comes from the REST handler: duplicate name 409, unknown id 404", async () => {
109
+ await mcp(U.owner.token, "projects_create", { network_id: NET, name: "mpe-重名" });
110
+ const dup = await mcp(U.owner.token, "projects_create", { network_id: NET, name: "mpe-重名" });
111
+ expect(dup.ok).toBe(false);
112
+ expect(dup.status).toBe(409);
113
+ const missing = await mcp(U.owner.token, "projects_update", { network_id: NET, id: "proj_nobody", name: "x" });
114
+ expect(missing.status).toBe(404);
115
+ });
116
+
117
+ test("permission parity with the app's REST path, for every kind of caller", async () => {
118
+ const results: Record<string, { mcp: number; rest: number }> = {};
119
+ for (const who of ["owner", "member", "scoped", "viewer", "node"]) {
120
+ const name = `mpe-parity-${who}`;
121
+ const viaMcp = await mcp(U[who].token, "projects_create", { network_id: NET, name: `${name}-mcp` });
122
+ const viaRest = await rest(U[who].token, "POST", `/api/requirements/projects?network_id=${NET}`, { name: `${name}-rest` });
123
+ results[who] = { mcp: mcpStatus(viaMcp, 201), rest: viaRest.status };
124
+ }
125
+ for (const r of Object.values(results)) expect(r.mcp).toBe(r.rest);
126
+ // the rule itself (RFC-038 §9): task-scoped members and viewers can't manage projects; the others can
127
+ expect(results.owner.rest).toBe(201);
128
+ expect(results.member.rest).toBe(201);
129
+ expect(results.scoped.rest).toBe(403);
130
+ expect(results.viewer.rest).toBe(403);
131
+ });
132
+ });
133
+
134
+ describe("requirements_events", () => {
135
+ test("one task's timeline by id and by #N, same rows as GET /api/requirements/events", async () => {
136
+ const card = await rest(U.owner.token, "POST", "/api/requirements", { network_id: NET, name: "mpe-流水示例" });
137
+ expect(card.status).toBe(201);
138
+ const id = card.body.requirement.id as string, seq = card.body.requirement.seq as number;
139
+ expect((await rest(U.owner.token, "PATCH", `/api/requirements/${id}?network_id=${NET}`, { priority: "high" })).status).toBe(200);
140
+ const viaMcp = await mcp(U.owner.token, "requirements_events", { network_id: NET, requirement_id: id });
141
+ const viaRest = await rest(U.owner.token, "GET", `/api/requirements/events?network_id=${NET}&requirement_id=${id}`);
142
+ expect(viaMcp.ok).toBe(true);
143
+ expect(viaMcp.events.length).toBeGreaterThan(0);
144
+ expect(viaMcp.events.map((e: any) => e.id)).toEqual(viaRest.body.events.map((e: any) => e.id));
145
+ expect(viaMcp.events.every((e: any) => e.requirement_id === id)).toBe(true);
146
+ const bySeq = await mcp(U.owner.token, "requirements_events", { network_id: NET, requirement_id: `#${seq}` });
147
+ expect(bySeq.events.map((e: any) => e.id)).toEqual(viaMcp.events.map((e: any) => e.id));
148
+ // paging / bad input come from the REST handler too
149
+ expect((await mcp(U.owner.token, "requirements_events", { network_id: NET, since: "not-a-date" })).status).toBe(400);
150
+ expect((await mcp(U.owner.token, "requirements_events", { network_id: NET, requirement_id: "#999999" })).status).toBe(404);
151
+ });
152
+
153
+ test("visibility parity: a task-scoped member doesn't get events for a task they can't see", async () => {
154
+ const hidden = await rest(U.owner.token, "POST", "/api/requirements", { network_id: NET, name: "mpe-看不见的" });
155
+ const id = hidden.body.requirement.id as string;
156
+ await rest(U.owner.token, "PATCH", `/api/requirements/${id}?network_id=${NET}`, { priority: "low" });
157
+ for (const who of ["scoped", "member", "node"]) {
158
+ const viaMcp = await mcp(U[who].token, "requirements_events", { network_id: NET, requirement_id: id });
159
+ const viaRest = await rest(U[who].token, "GET", `/api/requirements/events?network_id=${NET}&requirement_id=${id}`);
160
+ expect((viaMcp.events ?? []).map((e: any) => e.id)).toEqual((viaRest.body?.events ?? []).map((e: any) => e.id));
161
+ }
162
+ expect((await mcp(U.scoped.token, "requirements_events", { network_id: NET, requirement_id: id })).events ?? []).toHaveLength(0);
163
+ expect((await mcp(U.member.token, "requirements_events", { network_id: NET, requirement_id: id })).events.length).toBeGreaterThan(0);
164
+ });
165
+ });
@@ -0,0 +1,120 @@
1
+ // POST /mcp in /api/stats/routes carries the JSON-RPC method and, for tools/call, the tool name
2
+ // ("POST /mcp tools/call report_status"). Production showed POST /mcp as the biggest route (15 req/s,
3
+ // ~13% of a core) with no way to tell which tool. This suite pins, over real HTTP:
4
+ // - the labels (tools/call <name>, tools/list, batch) and that MCP responses are unchanged in kind;
5
+ // - arguments never reach the stats (a marker in arguments / a hostile tool name never shows up);
6
+ // - odd bodies still get the transport's own answers (invalid JSON → -32700, oversized → parsed by
7
+ // the transport itself) and are labelled "?";
8
+ // - unauthenticated /mcp stays plain "POST /mcp" (the body is never read before auth).
9
+
10
+ import { afterAll, beforeAll, describe, expect, test } from "bun:test";
11
+ import { mkdtempSync, rmSync } from "node:fs";
12
+ import { tmpdir } from "node:os";
13
+ import { join } from "node:path";
14
+
15
+ const DIR = mkdtempSync(join(tmpdir(), "anet-mcp-route-label-"));
16
+ process.env.COMMHUB_DB ||= join(DIR, "hub.db");
17
+ process.env.COMMHUB_UPLOADS_DIR = join(DIR, "uploads");
18
+
19
+ const PW = "McpRouteLabelPassw0rd!";
20
+ const MARKER = "zz-argument-marker-7f3a";
21
+ let BASE = "";
22
+ let hub: any = null;
23
+ let admin = "";
24
+
25
+ const MCP_HEADERS = { "Content-Type": "application/json", Accept: "application/json, text/event-stream", "MCP-Protocol-Version": "2025-03-26" };
26
+ async function mcpRaw(token: string, body: string): Promise<{ status: number; text: string }> {
27
+ const res = await fetch(`${BASE}/mcp`, { method: "POST", headers: { ...(token ? { Authorization: `Bearer ${token}` } : {}), ...MCP_HEADERS }, body });
28
+ return { status: res.status, text: await res.text() };
29
+ }
30
+ function rpc(text: string): any {
31
+ const lines = text.split("\n").filter(x => x.startsWith("data:"));
32
+ return lines.length ? JSON.parse(lines.at(-1)!.slice(5).trim()) : JSON.parse(text);
33
+ }
34
+ async function routes(): Promise<{ text: string; keys: string[]; rows: any[] }> {
35
+ const res = await fetch(`${BASE}/api/stats/routes?minutes=5`, { headers: { Authorization: `Bearer ${admin}` } });
36
+ const text = await res.text();
37
+ const rows = JSON.parse(text).routes as any[];
38
+ return { text, keys: rows.map(r => r.route), rows };
39
+ }
40
+
41
+ beforeAll(async () => {
42
+ process.env.HOST = "127.0.0.1";
43
+ const { register } = await import("./auth.js");
44
+ const { db } = await import("./db.js");
45
+ const a = register(`mrl_admin_${Date.now()}`, PW);
46
+ admin = a.token!;
47
+ db.run("UPDATE users SET role = 'admin' WHERE user_id = ?1", [a.user!.user_id]);
48
+ const mod: any = await import("./server.js");
49
+ hub = mod.bootServer({ port: 0, hostname: "127.0.0.1" });
50
+ BASE = `http://127.0.0.1:${hub.port}`;
51
+ }, 30_000);
52
+
53
+ afterAll(() => {
54
+ try { hub?.stop?.(true); } catch {}
55
+ try { rmSync(DIR, { recursive: true, force: true }); } catch {}
56
+ });
57
+
58
+ describe("POST /mcp route label", () => {
59
+ test("tools/call is labelled with the tool name and still answers normally", async () => {
60
+ const r = await mcpRaw(admin, JSON.stringify({ jsonrpc: "2.0", id: 1, method: "tools/call", params: { name: "get_all_status", arguments: { note: MARKER } } }));
61
+ expect(r.status).toBe(200);
62
+ expect(rpc(r.text).result).toBeDefined();
63
+ const { keys } = await routes();
64
+ expect(keys).toContain("POST /mcp tools/call get_all_status");
65
+ });
66
+
67
+ test("tools/list and a batch get their own labels", async () => {
68
+ const list = await mcpRaw(admin, JSON.stringify({ jsonrpc: "2.0", id: 2, method: "tools/list" }));
69
+ expect(list.status).toBe(200);
70
+ expect(rpc(list.text).result.tools.length).toBeGreaterThan(10);
71
+ await mcpRaw(admin, JSON.stringify([{ jsonrpc: "2.0", id: 3, method: "tools/list" }]));
72
+ const { keys } = await routes();
73
+ expect(keys).toContain("POST /mcp tools/list");
74
+ expect(keys).toContain("POST /mcp batch");
75
+ });
76
+
77
+ test("arguments and hostile tool names never reach the stats", async () => {
78
+ await mcpRaw(admin, JSON.stringify({ jsonrpc: "2.0", id: 4, method: "tools/call", params: { name: `x ${MARKER}`, arguments: { a: MARKER } } }));
79
+ await mcpRaw(admin, JSON.stringify({ jsonrpc: "2.0", id: 5, method: "tools/call", params: { name: "n".repeat(500), arguments: {} } }));
80
+ await mcpRaw(admin, JSON.stringify({ jsonrpc: "2.0", id: 6, method: `tools/${MARKER} with spaces` }));
81
+ const { text, keys } = await routes();
82
+ expect(text).not.toContain(MARKER);
83
+ expect(text).not.toContain("n".repeat(65));
84
+ expect(keys).toContain("POST /mcp tools/call ?");
85
+ expect(keys).toContain("POST /mcp ?");
86
+ for (const k of keys) expect(k.length).toBeLessThan(200);
87
+ });
88
+
89
+ test("invalid JSON still gets the transport's parse error, labelled ?", async () => {
90
+ const r = await mcpRaw(admin, `{"jsonrpc":"2.0","method":"tools/list",`);
91
+ expect(r.status).toBe(400);
92
+ expect(rpc(r.text).error.code).toBe(-32700);
93
+ expect(rpc(r.text).error.message).toBe("Parse error: Invalid JSON");
94
+ const notRpc = await mcpRaw(admin, "null");
95
+ expect(notRpc.status).toBe(400);
96
+ expect(rpc(notRpc.text).error.code).toBe(-32700);
97
+ });
98
+
99
+ test("a body over the label limit is left to the transport and still works, labelled ?", async () => {
100
+ const { __resetRouteTimingForTest } = await import("./route-timing.js");
101
+ __resetRouteTimingForTest();
102
+ const padded = JSON.stringify({ jsonrpc: "2.0", id: 7, method: "tools/list" }).replace("{", "{" + " ".repeat(1024 * 1024 + 10));
103
+ const r = await mcpRaw(admin, padded);
104
+ expect(r.status).toBe(200);
105
+ expect(rpc(r.text).result.tools.length).toBeGreaterThan(10);
106
+ const { keys } = await routes();
107
+ expect(keys).toContain("POST /mcp ?");
108
+ expect(keys).not.toContain("POST /mcp tools/list");
109
+ });
110
+
111
+ test("unauthenticated /mcp is refused as before and not labelled", async () => {
112
+ const { __resetRouteTimingForTest } = await import("./route-timing.js");
113
+ __resetRouteTimingForTest();
114
+ const r = await mcpRaw("", JSON.stringify({ jsonrpc: "2.0", id: 8, method: "tools/list" }));
115
+ expect(r.status).toBe(401);
116
+ const { keys } = await routes();
117
+ expect(keys).toContain("POST /mcp");
118
+ expect(keys.filter(k => k.startsWith("POST /mcp "))).toEqual([]);
119
+ });
120
+ });