@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,162 @@
1
+ // #2571(第三轮)—— 告警阈值从「全局常数」改成「每个目标自己的 p99 基线」。
2
+ //
3
+ // 现场(2026-10-27):同一个 `10 分钟没消费就报警` 的判据,在两种节奏下表现相反 ——
4
+ // 7 天基线:delivered→首次活动 p90=6s、p99=12min ⇒ 超过 600s 只占 1.2%
5
+ // 某一晚: p90=411s、p99=1573s ⇒ 超过 600s 占 5.4%,其中 43% 最终成功
6
+ // 全队一起变慢时,全局常数会炸一屏;而单个节点卡死时,又必须能显形。
7
+ //
8
+ // 这个文件钉住四件事:
9
+ // 1. 没有基线(样本不足/老库)⇒ **与 .163 完全一致**(沿用全局下限,不漏报不误报);
10
+ // 2. 基线比全局更宽(慢节点)⇒ 更晚才报;
11
+ // 3. 基线比全局更窄(快节点)⇒ **仍然不早于全局下限**(不允许比 600s 更敏感);
12
+ // 4. 基线只由**成功且已进 runtime** 的样本算出来,且样本不足不写行。
13
+
14
+ import { afterAll, beforeAll, describe, expect, test } from "bun:test";
15
+ import { db } from "./db.js";
16
+ import {
17
+ ALIAS_BASELINE_TABLE,
18
+ BASELINE_MIN_SAMPLES,
19
+ aliasBaseline,
20
+ aliasBaselineRefreshState,
21
+ ensureAliasBaselineTable,
22
+ refreshAliasBaseline,
23
+ } from "./alias-baseline.js";
24
+ import { recordDeliveredStaleEvents } from "./task-lifecycle-watcher.js";
25
+
26
+ const stamp = `${Date.now()}`;
27
+ let NET = "";
28
+ const NOW = new Date("2026-10-27T03:00:00.000Z");
29
+
30
+ function iso(secondsAgo: number): string {
31
+ return new Date(NOW.getTime() - secondsAgo * 1000).toISOString().slice(0, 19).replace("T", " ");
32
+ }
33
+
34
+ function seedTask(id: string, toName: string, deliveredSecondsAgo: number) {
35
+ db.run(
36
+ `INSERT INTO tasks (task_id, from_name, to_name, status, content, delivered_at, network_id)
37
+ VALUES (?1, 'sender', ?2, 'delivered', 'baseline fixture', ?3, ?4)`,
38
+ [id, toName, iso(deliveredSecondsAgo), NET],
39
+ );
40
+ }
41
+
42
+ function seedSession(alias: string, status: string) {
43
+ db.run(
44
+ `INSERT INTO sessions (resume_id, alias, node_id, status, network_id, registered_at)
45
+ VALUES (?1, ?2, ?3, ?4, ?5, datetime('now'))`,
46
+ [`res_${alias}_${stamp}`, alias, `n_${alias}_${stamp}`, status, NET],
47
+ );
48
+ }
49
+
50
+ function setBaseline(alias: string, p99: number, samples = 100) {
51
+ ensureAliasBaselineTable();
52
+ db.run(
53
+ `INSERT INTO ${ALIAS_BASELINE_TABLE} (alias, network_id, p99_seconds, samples, computed_at)
54
+ VALUES (?1, ?2, ?3, ?4, ?5)
55
+ ON CONFLICT(alias, network_id) DO UPDATE SET p99_seconds = excluded.p99_seconds, samples = excluded.samples`,
56
+ [alias, NET, p99, samples, NOW.toISOString()],
57
+ );
58
+ }
59
+
60
+ const eventsFor = (taskId: string) =>
61
+ db.all<{ event_type: string }>("SELECT event_type FROM task_events WHERE task_id = ?1", [taskId]).map(r => r.event_type);
62
+
63
+ beforeAll(async () => {
64
+ const { register } = await import("./auth.js");
65
+ const auth = register(`baseline_owner_${stamp}`, "Baseline-Owner-Strong-1!", undefined, "tester");
66
+ expect(auth.ok).toBe(true);
67
+ NET = auth.network_id!;
68
+ ensureAliasBaselineTable();
69
+ });
70
+
71
+ afterAll(() => {
72
+ try {
73
+ db.run(`DELETE FROM task_events WHERE task_id LIKE ?1`, [`bl-%-${stamp}`]);
74
+ db.run(`DELETE FROM tasks WHERE task_id LIKE ?1`, [`bl-%-${stamp}`]);
75
+ db.run(`DELETE FROM sessions WHERE alias LIKE ?1`, [`bl-%-${stamp}`]);
76
+ db.run(`DELETE FROM ${ALIAS_BASELINE_TABLE} WHERE alias LIKE ?1`, [`bl-%-${stamp}`]);
77
+ } catch {}
78
+ });
79
+
80
+ describe("#2571 alias p99 baseline", () => {
81
+ test("没有基线 ⇒ 沿用全局下限(与 .163 行为一致)", () => {
82
+ seedSession(`bl-nobase-${stamp}`, "idle");
83
+ seedTask(`bl-nobase-task-${stamp}`, `bl-nobase-${stamp}`, 700);
84
+ recordDeliveredStaleEvents(NOW);
85
+ expect(eventsFor(`bl-nobase-task-${stamp}`)).toContain("task.warning.delivered_stale_600s");
86
+ });
87
+
88
+ test("基线更宽(慢节点):700 秒不报,超过 p99×1.5 才报", () => {
89
+ seedSession(`bl-slow-${stamp}`, "idle");
90
+ setBaseline(`bl-slow-${stamp}`, 3600); // 阈值 5400s
91
+ seedTask(`bl-slow-700-${stamp}`, `bl-slow-${stamp}`, 700);
92
+ seedTask(`bl-slow-6000-${stamp}`, `bl-slow-${stamp}`, 6000);
93
+ recordDeliveredStaleEvents(NOW);
94
+ expect(eventsFor(`bl-slow-700-${stamp}`)).toEqual([]);
95
+ expect(eventsFor(`bl-slow-6000-${stamp}`)).toContain("task.warning.delivered_stale_600s");
96
+ });
97
+
98
+ test("基线极大(p99=50min)时,等满 30 分钟仍然报(上限兜底)", () => {
99
+ seedSession(`bl-very-slow-${stamp}`, "idle");
100
+ setBaseline(`bl-very-slow-${stamp}`, 3017); // ×1.5 = 4525s,若无上限就永远不报
101
+ seedTask(`bl-very-slow-1900-${stamp}`, `bl-very-slow-${stamp}`, 1900);
102
+ seedTask(`bl-very-slow-1700-${stamp}`, `bl-very-slow-${stamp}`, 1700);
103
+ recordDeliveredStaleEvents(NOW);
104
+ expect(eventsFor(`bl-very-slow-1900-${stamp}`)).toContain("task.warning.delivered_stale_600s");
105
+ expect(eventsFor(`bl-very-slow-1700-${stamp}`)).toEqual([]);
106
+ });
107
+
108
+ test("基线更窄(快节点):不允许比全局下限更敏感", () => {
109
+ seedSession(`bl-fast-${stamp}`, "idle");
110
+ setBaseline(`bl-fast-${stamp}`, 2); // 阈值 max(600, 3) = 600
111
+ seedTask(`bl-fast-120-${stamp}`, `bl-fast-${stamp}`, 120);
112
+ recordDeliveredStaleEvents(NOW);
113
+ expect(eventsFor(`bl-fast-120-${stamp}`)).toEqual([]);
114
+ });
115
+
116
+ test("refresh 只用成功且已进 runtime 的样本", () => {
117
+ const alias = `bl-refresh-${stamp}`;
118
+ // 20 条成功的(delivered→started 各 10s),2 条失败的(不应计入)
119
+ for (let i = 0; i < BASELINE_MIN_SAMPLES; i++) {
120
+ db.run(
121
+ `INSERT INTO tasks (task_id, from_name, to_name, status, content, delivered_at, started_at, completed_at, network_id)
122
+ VALUES (?1, 'sender', ?2, 'replied', 'x', ?3, ?4, ?5, ?6)`,
123
+ [`bl-ref-ok-${i}-${stamp}`, alias, iso(1000 - i), iso(990 - i), iso(985 - i), NET],
124
+ );
125
+ }
126
+ for (let i = 0; i < 5; i++) {
127
+ db.run(
128
+ `INSERT INTO tasks (task_id, from_name, to_name, status, content, delivered_at, completed_at, network_id)
129
+ VALUES (?1, 'sender', ?2, 'failed', 'x', ?3, ?4, ?5)`,
130
+ [`bl-ref-bad-${i}-${stamp}`, alias, iso(5000 - i), iso(1000), NET],
131
+ );
132
+ }
133
+ refreshAliasBaseline(NOW);
134
+ const row = aliasBaseline(alias, NET);
135
+ expect(row).not.toBeNull();
136
+ expect(row!.samples).toBe(BASELINE_MIN_SAMPLES); // 失败的不算
137
+ expect(row!.p99Seconds).toBeGreaterThanOrEqual(9); // 10s 左右的样本
138
+ expect(row!.p99Seconds).toBeLessThanOrEqual(11);
139
+ });
140
+
141
+ test("刷新状态可读(/health 用):时间 / 写入行数 / 当前总行数", () => {
142
+ refreshAliasBaseline(NOW);
143
+ const state = aliasBaselineRefreshState();
144
+ expect(state).not.toBeNull();
145
+ expect(typeof state!.at).toBe("string");
146
+ expect(state!.rows).toBeGreaterThanOrEqual(0);
147
+ expect(state!.aliases).toBeGreaterThanOrEqual(1); // 前面用例已写入若干 alias
148
+ });
149
+
150
+ test("样本不足不写基线行(退回全局)", () => {
151
+ const alias = `bl-thin-${stamp}`;
152
+ for (let i = 0; i < BASELINE_MIN_SAMPLES - 1; i++) {
153
+ db.run(
154
+ `INSERT INTO tasks (task_id, from_name, to_name, status, content, delivered_at, started_at, completed_at, network_id)
155
+ VALUES (?1, 'sender', ?2, 'replied', 'x', ?3, ?4, ?5, ?6)`,
156
+ [`bl-thin-${i}-${stamp}`, alias, iso(1000 - i), iso(995 - i), iso(990 - i), NET],
157
+ );
158
+ }
159
+ refreshAliasBaseline(NOW);
160
+ expect(aliasBaseline(alias, NET)).toBeNull();
161
+ });
162
+ });
@@ -0,0 +1,113 @@
1
+ // #2571(第三轮)—— 每个目标自己的「投递→首次活动」p99 基线。
2
+ //
3
+ // 为什么需要(2026-10-27 实测):
4
+ // 同一个「10 分钟没消费就报警」的判据,在两种节奏下表现完全相反 ——
5
+ // 7 天基线:delivered→首次活动 p50=1s p90=6s p99=12min ⇒ >600s 只占 1.2%
6
+ // 某一晚: p50=32s p90=411s p99=1573s ⇒ >600s 占 5.4%,其中 43% 最终成功
7
+ // 全局常数不可能同时适配“全员都在跑长 turn”和“某个节点单独卡死”。
8
+ // ⇒ 判据改成 **age > max(全局下限, 该 alias 自己的 p99 × 1.5)**:
9
+ // 全队一起变慢 ⇒ 各自基线一起抬高,不炸屏;单个节点变慢 ⇒ 它自己的基线没高,立刻显形。
10
+ //
11
+ // 这张表只是**缓存**(派生数据):算错了重算即可,不影响投递/回复语义。
12
+ // 样本不足(< MIN_SAMPLES)的 alias 不写行 ⇒ 巡逻退回全局阈值(行为与 .163 完全一致)。
13
+
14
+ import { db } from "./db.js";
15
+
16
+ export const ALIAS_BASELINE_TABLE = "alias_latency_baseline";
17
+ export const BASELINE_WINDOW_DAYS = 7;
18
+ export const BASELINE_MIN_SAMPLES = 20;
19
+ /** 阈值 = max(全局下限, p99 × 这个倍数)。1.5 是“比它自己最慢的 1% 再宽 50%”。 */
20
+ export const BASELINE_P99_FACTOR = 1.5;
21
+
22
+ /**
23
+ * 基线的**上限**:再慢的节点,等满 30 分钟也必须报。
24
+ *
25
+ * 没有这条上限时,p99=3017s(50 分钟)的节点会把自己的阈值推到 75 分钟 —— 它卡死时永远不报。
26
+ * 生产实测(2026-10-27 用最近 24h 数据回溯模拟):加基线后 46 条 → 8 条(-83%),
27
+ * 但被抑制的样本里出现了 `TMA设计师` 两条最终 **failed** 的任务(它的 p99 是 50 分钟)
28
+ * ⇒ 慢节点需要一条“无论如何都要响”的底线。
29
+ */
30
+ export const BASELINE_MAX_SECONDS = 1800;
31
+
32
+ // #2571 —— 最近一次刷新的结果,供 /health 暴露(只读、聚合,不含 alias 明细)。
33
+ // 为什么需要:告警阈值依赖这张缓存表;「为什么这条没报/为什么报了」第一个要看的就是
34
+ // 「基线最近一次什么时候算的、算出来几行」。否则只能进机器 sqlite。
35
+ let lastRefresh: { at: string; rows: number; aliases: number } | null = null;
36
+
37
+ export function aliasBaselineRefreshState(): { at: string; rows: number; aliases: number } | null {
38
+ return lastRefresh;
39
+ }
40
+
41
+ export function ensureAliasBaselineTable(): void {
42
+ db.exec(`
43
+ CREATE TABLE IF NOT EXISTS ${ALIAS_BASELINE_TABLE} (
44
+ alias TEXT NOT NULL,
45
+ network_id TEXT NOT NULL,
46
+ p99_seconds INTEGER NOT NULL,
47
+ samples INTEGER NOT NULL,
48
+ computed_at TEXT NOT NULL,
49
+ PRIMARY KEY (alias, network_id)
50
+ );
51
+ CREATE INDEX IF NOT EXISTS idx_alias_baseline_computed
52
+ ON ${ALIAS_BASELINE_TABLE}(computed_at);
53
+ `);
54
+ }
55
+
56
+ /**
57
+ * 重新计算基线。只统计**成功任务**(replied)且已经进过 runtime 的样本:
58
+ * 失败/未开始的任务会把“没消费”混进“消费慢”,两者不是一回事。
59
+ */
60
+ export function refreshAliasBaseline(now = new Date()): { rows: number } {
61
+ ensureAliasBaselineTable();
62
+ const iso = now.toISOString();
63
+ const since = new Date(now.getTime() - BASELINE_WINDOW_DAYS * 86_400_000).toISOString();
64
+ const result = db.run(
65
+ `INSERT INTO ${ALIAS_BASELINE_TABLE} (alias, network_id, p99_seconds, samples, computed_at)
66
+ SELECT alias, network_id, CAST(seconds AS INTEGER), samples, ?2
67
+ FROM (
68
+ SELECT to_name AS alias,
69
+ network_id,
70
+ seconds,
71
+ samples,
72
+ ROW_NUMBER() OVER (PARTITION BY to_name, network_id ORDER BY seconds) AS rn,
73
+ CAST(samples * 0.99 AS INTEGER) AS p99_rank
74
+ FROM (
75
+ SELECT to_name,
76
+ network_id,
77
+ (julianday(COALESCE(started_at, runtime_submitted_at, completed_at)) - julianday(delivered_at)) * 86400.0 AS seconds,
78
+ COUNT(*) OVER (PARTITION BY to_name, network_id) AS samples
79
+ FROM tasks
80
+ WHERE status = 'replied'
81
+ AND delivered_at IS NOT NULL
82
+ AND COALESCE(started_at, runtime_submitted_at, completed_at) IS NOT NULL
83
+ AND created_at >= ?1
84
+ )
85
+ )
86
+ WHERE samples >= ?3
87
+ AND rn = MAX(1, p99_rank)
88
+ ON CONFLICT(alias, network_id) DO UPDATE SET
89
+ p99_seconds = excluded.p99_seconds,
90
+ samples = excluded.samples,
91
+ computed_at = excluded.computed_at`,
92
+ [since, iso, BASELINE_MIN_SAMPLES],
93
+ );
94
+ // 窗口内没有样本的 alias(长期不活跃)不该继续用旧基线兜着。
95
+ db.run(`DELETE FROM ${ALIAS_BASELINE_TABLE} WHERE computed_at < ?1`, [since]);
96
+ const aliases = db.get<{ n: number }>(`SELECT COUNT(*) AS n FROM ${ALIAS_BASELINE_TABLE}`)?.n ?? 0;
97
+ lastRefresh = { at: iso, rows: result.changes, aliases: Number(aliases) };
98
+ return { rows: result.changes };
99
+ }
100
+
101
+ /** 只读查询(排障 / 测试用)。 */
102
+ export function aliasBaseline(alias: string, networkId: string): { p99Seconds: number; samples: number } | null {
103
+ try {
104
+ const row = db.get<{ p99_seconds: number; samples: number }>(
105
+ `SELECT p99_seconds, samples FROM ${ALIAS_BASELINE_TABLE} WHERE alias = ?1 AND network_id = ?2`,
106
+ alias, networkId,
107
+ );
108
+ return row ? { p99Seconds: Number(row.p99_seconds), samples: Number(row.samples) } : null;
109
+ } catch {
110
+ // 表还没建(老库/单测里没跑过 refresh)⇒ 当作没有基线。
111
+ return null;
112
+ }
113
+ }
@@ -0,0 +1,72 @@
1
+ import { expect, test } from "bun:test";
2
+ import { parseAliasFilter } from "./alias-filter";
3
+
4
+ test("no filter given means no filtering, not an empty match", () => {
5
+ for (const raw of [undefined, null, "", " ", ",", " , , "]) {
6
+ const f = parseAliasFilter(raw as any);
7
+ expect(f.aliases).toEqual([]);
8
+ expect(f.sql).toBe("");
9
+ }
10
+ });
11
+
12
+ test("a single alias produces one placeholder", () => {
13
+ const f = parseAliasFilter("节点甲");
14
+ expect(f.aliases).toEqual(["节点甲"]);
15
+ expect(f.sql).toBe(" AND alias IN (?)");
16
+ });
17
+
18
+ test("several aliases keep their order and count", () => {
19
+ const f = parseAliasFilter("A站内容,A站内容牛,hub");
20
+ expect(f.aliases).toEqual(["A站内容", "A站内容牛", "hub"]);
21
+ expect(f.sql).toBe(" AND alias IN (?,?,?)");
22
+ });
23
+
24
+ test("surrounding whitespace is trimmed", () => {
25
+ expect(parseAliasFilter(" a , b ").aliases).toEqual(["a", "b"]);
26
+ });
27
+
28
+ // The point of the module. A trailing comma must not become `alias = ''`,
29
+ // which matches nothing and reads exactly like "those nodes do not exist".
30
+ test("blank entries are dropped, never turned into a match-nothing term", () => {
31
+ const f = parseAliasFilter("a,,b,");
32
+ expect(f.aliases).toEqual(["a", "b"]);
33
+ expect(f.sql).toBe(" AND alias IN (?,?)");
34
+ expect(f.aliases).not.toContain("");
35
+ });
36
+
37
+ test("a filter of only commas is the same as no filter — it must not silently match zero rows", () => {
38
+ const f = parseAliasFilter(",,,");
39
+ expect(f.sql).toBe("");
40
+ });
41
+
42
+ test("placeholder count always equals alias count, so params can never misalign", () => {
43
+ for (const raw of ["a", "a,b", "a,,b", " a , b , c ", ",x,"]) {
44
+ const f = parseAliasFilter(raw);
45
+ expect((f.sql.match(/\?/g) ?? []).length).toBe(f.aliases.length);
46
+ }
47
+ });
48
+
49
+ test("aliases are passed through verbatim — no globbing, no case folding", () => {
50
+ const f = parseAliasFilter("A站内容,a站内容");
51
+ expect(f.aliases).toEqual(["A站内容", "a站内容"]);
52
+ expect(f.sql).not.toContain("LIKE");
53
+ });
54
+
55
+ // Wiring: the tool must actually use this module, and must say what its
56
+ // `summary` counted — a caller who asked about three aliases and gets back
57
+ // "idle: 96" can easily read the 96 as being about their three.
58
+ import { readFileSync } from "fs";
59
+ import { join } from "path";
60
+
61
+ test("get_all_status uses parseAliasFilter and declares what summary counted", () => {
62
+ const source = readFileSync(join(import.meta.dir, "tools.ts"), "utf8");
63
+ const a = source.indexOf('"get_all_status"');
64
+ expect(a).toBeGreaterThan(-1);
65
+ const body = source.slice(a, source.indexOf('server.tool(', a + 10));
66
+ expect(body).toContain("filter_alias");
67
+ expect(body).toContain("parseAliasFilter(filter_alias)");
68
+ expect(body).toContain("summary_scope");
69
+ expect(body).toContain("sessions_returned");
70
+ // The alias list must go through parameters, never be interpolated.
71
+ expect(body).not.toMatch(/alias IN \(\$\{/);
72
+ });
@@ -0,0 +1,42 @@
1
+ // Parse the `filter_alias` argument of `get_all_status` into an exact-match
2
+ // IN list.
3
+ //
4
+ // Why this exists at all: on a 222-session hub the unfiltered response is about
5
+ // 259 KB — past what an MCP client accepts in one result. A caller who wanted
6
+ // the status of three specific nodes could not get it from the tool, and had to
7
+ // go around it to the REST API. The filter is the fix; this module is the part
8
+ // of it worth pinning, because the interesting behaviour is what happens to the
9
+ // inputs that are not a clean alias.
10
+ //
11
+ // Blank entries are DROPPED rather than matched. A trailing comma would
12
+ // otherwise produce `alias = ''`, which matches no row — and "no rows" reads
13
+ // exactly like "those nodes do not exist". The failure and the true answer
14
+ // would be indistinguishable to the caller, which is the thing to avoid.
15
+
16
+ export interface AliasFilter {
17
+ /** Exact aliases to match. Empty means "no alias filtering". */
18
+ aliases: string[];
19
+ /** SQL fragment to append, or "" when there is nothing to filter on. */
20
+ sql: string;
21
+ }
22
+
23
+ export function parseAliasFilter(raw: string | undefined | null): AliasFilter {
24
+ const aliases = (raw ?? "")
25
+ .split(",")
26
+ .map(a => a.trim())
27
+ .filter(Boolean);
28
+ return {
29
+ aliases,
30
+ sql: aliases.length > 0 ? ` AND alias IN (${aliases.map(() => "?").join(",")})` : "",
31
+ };
32
+ }
33
+
34
+ /**
35
+ * The same `alias IN (…)` clause with numbered placeholders, starting after `paramsSoFar` already-bound
36
+ * parameters. Use it when the query already carries numbered `?N` placeholders: the PG adapter numbers a bare
37
+ * `?` from $1 again, so mixing the two binds the aliases to the wrong slots (SQLite happens to number them right).
38
+ */
39
+ export function numberedAliasInClause(aliases: string[], paramsSoFar: number): string {
40
+ if (aliases.length === 0) return "";
41
+ return ` AND alias IN (${aliases.map((_, i) => `?${paramsSoFar + i + 1}`).join(",")})`;
42
+ }