@sleep2agi/commhub-server 0.9.0-preview.24 → 0.9.0-preview.241

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 (409) 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 +48 -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 +434 -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 +1443 -3
  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 +582 -0
  114. package/src/hub-provider-config.test.ts +156 -0
  115. package/src/hub-provider-config.ts +202 -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 +373 -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-assignee-drift.test.ts +122 -0
  225. package/src/requirements-comment-http.test.ts +167 -0
  226. package/src/requirements-completed-at-migration.test.ts +70 -0
  227. package/src/requirements-errors-mcp-http.test.ts +164 -0
  228. package/src/requirements-errors.ts +158 -0
  229. package/src/requirements-etag-http.test.ts +91 -0
  230. package/src/requirements-http.test.ts +709 -0
  231. package/src/requirements-last-event-http.test.ts +349 -0
  232. package/src/requirements-list-mcp-slim-http.test.ts +155 -0
  233. package/src/requirements-list-slim-http.test.ts +324 -0
  234. package/src/requirements-mcp.test.ts +163 -0
  235. package/src/requirements-migrate.ts +283 -0
  236. package/src/requirements-owner-strict-mcp-http.test.ts +145 -0
  237. package/src/requirements-people-http.test.ts +114 -0
  238. package/src/requirements-people-mcp-http.test.ts +231 -0
  239. package/src/requirements-people.ts +196 -0
  240. package/src/requirements-priority-lowest.test.ts +114 -0
  241. package/src/requirements-projects-network-echo.test.ts +57 -0
  242. package/src/requirements-projects-parent-http.test.ts +123 -0
  243. package/src/requirements-search-http.test.ts +182 -0
  244. package/src/requirements-search.test.ts +32 -0
  245. package/src/requirements-search.ts +145 -0
  246. package/src/requirements-seq-http.test.ts +193 -0
  247. package/src/requirements-seq-migration.test.ts +63 -0
  248. package/src/requirements-start-date.test.ts +125 -0
  249. package/src/requirements-stats-http.test.ts +357 -0
  250. package/src/requirements-stats.ts +195 -0
  251. package/src/requirements-status-participants-http.test.ts +222 -0
  252. package/src/requirements-upgrade-e2e.test.ts +126 -0
  253. package/src/requirements-upgrade-migration.test.ts +98 -0
  254. package/src/requirements.ts +2116 -0
  255. package/src/resolve-port.test.ts +57 -0
  256. package/src/resolve-port.ts +44 -0
  257. package/src/rest-alias-network-fallback-http.test.ts +123 -0
  258. package/src/rest-alias-network-fallback.test.ts +60 -0
  259. package/src/rest-alias-network-fallback.ts +65 -0
  260. package/src/rest-explicit-columns-http.test.ts +266 -0
  261. package/src/rest-identity.test.ts +130 -0
  262. package/src/rest-identity.ts +141 -0
  263. package/src/rest-projections.ts +72 -0
  264. package/src/rest-read-network-real-chain.test.ts +97 -0
  265. package/src/rest-write-network-resolution.test.ts +133 -0
  266. package/src/restart-readiness-http.test.ts +121 -0
  267. package/src/restricted-files.ts +76 -0
  268. package/src/retention-first-sweep-quiet.test.ts +31 -0
  269. package/src/retention.test.ts +100 -40
  270. package/src/retention.ts +423 -104
  271. package/src/route-callers-http.test.ts +120 -0
  272. package/src/route-timing.test.ts +218 -0
  273. package/src/route-timing.ts +262 -0
  274. package/src/rules-file-duplicate-alias.test.ts +234 -0
  275. package/src/rules-file-session-target.test.ts +207 -0
  276. package/src/rules-file-transport.test.ts +237 -0
  277. package/src/runtime-label.test.ts +22 -0
  278. package/src/runtime-label.ts +21 -0
  279. package/src/runtime-readiness.ts +90 -0
  280. package/src/schedule-agent-mcp-http.test.ts +432 -0
  281. package/src/schedule-agent.ts +252 -0
  282. package/src/schedule-starved.test.ts +92 -0
  283. package/src/schedule-starved.ts +114 -0
  284. package/src/scheduled-backoff-http.test.ts +193 -0
  285. package/src/scheduled-backoff.ts +64 -0
  286. package/src/scheduled-doorbell-nodeless-session.test.ts +134 -0
  287. package/src/scheduled-failure-backoff-2622.test.ts +145 -0
  288. package/src/scheduled-failure-code.test.ts +73 -0
  289. package/src/scheduled-failure-code.ts +105 -0
  290. package/src/scheduled-failures-http.test.ts +279 -0
  291. package/src/scheduled-failures.ts +425 -0
  292. package/src/scheduled-noprogress-backoff-2622.test.ts +163 -0
  293. package/src/scheduled-offline-backoff-probe.test.ts +56 -0
  294. package/src/scheduled-offline.test.ts +131 -0
  295. package/src/scheduled-offline.ts +66 -0
  296. package/src/scheduled-outcome-guidance-http.test.ts +139 -0
  297. package/src/scheduled-outcome-guidance.ts +9 -0
  298. package/src/scheduled-reply-unread-http.test.ts +212 -0
  299. package/src/scheduled-requirement-wake-http.test.ts +279 -0
  300. package/src/scheduled-requirement-wake.ts +125 -0
  301. package/src/scheduled-run-terminal.test.ts +268 -0
  302. package/src/scheduled-skip-blocking-task.test.ts +120 -0
  303. package/src/scheduled-skip-path-backoff-2622.test.ts +98 -0
  304. package/src/scheduled-stuck-http.test.ts +316 -0
  305. package/src/scheduled-stuck-notice-cap.test.ts +80 -0
  306. package/src/scheduled-stuck.ts +219 -0
  307. package/src/scheduled-tasks-http.test.ts +679 -0
  308. package/src/scheduled-tasks.ts +959 -0
  309. package/src/scheduled-work-outcome-http.test.ts +154 -0
  310. package/src/scheduled-work-outcome.ts +50 -0
  311. package/src/scoped-secrets.ts +141 -0
  312. package/src/send-dedup-request-id.test.ts +229 -0
  313. package/src/send-reply-agent-warning.test.ts +38 -38
  314. package/src/send-reply-alias-optional.test.ts +131 -0
  315. package/src/send-reply-attachments.test.ts +458 -0
  316. package/src/send_dedup.test.ts +54 -0
  317. package/src/send_dedup.ts +52 -6
  318. package/src/serve-error.test.ts +73 -0
  319. package/src/serve-error.ts +56 -0
  320. package/src/server.ts +5025 -435
  321. package/src/session-task-on-dispatch.ts +14 -0
  322. package/src/session-token-ownership-http.test.ts +122 -0
  323. package/src/shared/codex-inventory.ts +41 -0
  324. package/src/shared/daemon-provider-login.ts +31 -0
  325. package/src/shared/daemon-provider-snapshot.ts +52 -0
  326. package/src/shared/external-schedule-contract.ts +60 -0
  327. package/src/shared/node-name.test.ts +62 -0
  328. package/src/shared/node-name.ts +161 -0
  329. package/src/shared/probe-host-allowlist-drift.test.ts +45 -0
  330. package/src/shared/provider-application.ts +29 -0
  331. package/src/shared/provider-collection.ts +14 -0
  332. package/src/shared/provider-initialization.ts +8 -0
  333. package/src/shared/reserved-env-drift.test.ts +10 -0
  334. package/src/shared/scoped-secret-contract.ts +5 -0
  335. package/src/shared/task-content-limit-drift.test.ts +28 -0
  336. package/src/shared/task-content-limit.ts +25 -0
  337. package/src/side-thread-command-transport.test.ts +312 -0
  338. package/src/side-thread-command-transport.ts +318 -0
  339. package/src/side-thread-http-integration.test.ts +233 -0
  340. package/src/side-thread-http.ts +504 -0
  341. package/src/side-thread-production.test.ts +72 -0
  342. package/src/side-thread-production.ts +118 -0
  343. package/src/side-thread.test.ts +1067 -0
  344. package/src/side-thread.ts +2499 -0
  345. package/src/skillhub-http.test.ts +142 -0
  346. package/src/sqlite-close-checkpoint.test.ts +78 -0
  347. package/src/start-node.test.ts +264 -0
  348. package/src/status-alias-filter-http.test.ts +106 -0
  349. package/src/status-alias-resolver-http.test.ts +163 -0
  350. package/src/status-alias-resolver.ts +19 -0
  351. package/src/status-node-id-filter-http.test.ts +161 -0
  352. package/src/status-read-cache-http.test.ts +229 -0
  353. package/src/status-read-cache.ts +129 -0
  354. package/src/stop-delete-node.test.ts +567 -1
  355. package/src/task-access-http.test.ts +402 -0
  356. package/src/task-access.ts +420 -0
  357. package/src/task-activity.ts +60 -0
  358. package/src/task-auth-origin-http.test.ts +93 -0
  359. package/src/task-auth-origin.test.ts +24 -0
  360. package/src/task-auth-origin.ts +7 -0
  361. package/src/task-consumption.test.ts +490 -0
  362. package/src/task-diagnostic-http.test.ts +149 -0
  363. package/src/task-diagnostic.test.ts +115 -0
  364. package/src/task-diagnostic.ts +118 -0
  365. package/src/task-expiry-notice-http.test.ts +287 -0
  366. package/src/task-expiry-notice.ts +315 -0
  367. package/src/task-idempotency-mcp.test.ts +142 -0
  368. package/src/task-idempotency.test.ts +76 -0
  369. package/src/task-idempotency.ts +81 -0
  370. package/src/task-late-replies.ts +54 -0
  371. package/src/task-late-reply-http.test.ts +227 -0
  372. package/src/task-lifecycle-watcher-busy.test.ts +114 -0
  373. package/src/task-lifecycle-watcher.test.ts +204 -0
  374. package/src/task-lifecycle-watcher.ts +109 -0
  375. package/src/task-network-resolution-http.test.ts +140 -0
  376. package/src/task-offline-delivery-2668.test.ts +119 -0
  377. package/src/task-offline-delivery.ts +81 -0
  378. package/src/task-orphan-http.test.ts +287 -0
  379. package/src/task-orphan.ts +119 -0
  380. package/src/task-queue-ahead-http.test.ts +309 -0
  381. package/src/task-queue-ahead-scale.test.ts +236 -0
  382. package/src/task-queue-ahead.ts +186 -0
  383. package/src/task-rejection-log-http.test.ts +160 -0
  384. package/src/task-rejection-log.ts +61 -0
  385. package/src/task-sender-http.test.ts +143 -0
  386. package/src/task-stale-open-http.test.ts +292 -0
  387. package/src/task-stale-open.ts +103 -0
  388. package/src/tasks-pagination-http.test.ts +141 -0
  389. package/src/team-rules-status-http.test.ts +90 -0
  390. package/src/team-rules-status.test.ts +59 -0
  391. package/src/team-rules-status.ts +72 -0
  392. package/src/tmux-allowlist.test.ts +48 -0
  393. package/src/tool-audience-http.test.ts +230 -0
  394. package/src/tool-audience.ts +127 -0
  395. package/src/tools-list-json-schema.test.ts +94 -0
  396. package/src/tools.ts +4310 -419
  397. package/src/upload-early-reject-guard.test.ts +155 -0
  398. package/src/uploads-http.test.ts +86 -7
  399. package/src/uploads.ts +103 -6
  400. package/src/user-avatar-http.test.ts +74 -0
  401. package/src/user-avatar-image.ts +160 -0
  402. package/src/user-avatar-migration.test.ts +25 -0
  403. package/src/user-avatar-upload-http.test.ts +348 -0
  404. package/src/user-inbox-by-agent-http.test.ts +161 -0
  405. package/src/user-inbox-netid-notnull.test.ts +122 -0
  406. package/src/user-inbox-read-http.test.ts +223 -0
  407. package/src/user-inbox-schema.test.ts +54 -0
  408. package/src/version-stats.test.ts +66 -0
  409. package/src/version-stats.ts +109 -0
@@ -3,25 +3,17 @@ import { db } from "./db.js";
3
3
  import { McpServer } from "@modelcontextprotocol/sdk/server/mcp.js";
4
4
  import { registerTools } from "./tools.js";
5
5
 
6
- // #498 regression — the send_reply hub response gains a `warning` field
7
- // pointing at commhub_send_task ONLY when the target alias resolves to
8
- // a real agent node (i.e. not hub / not api / not an unbound alias).
9
- // Silence-affirms the Dashboard path.
10
- //
11
- // Why this test exists (通信龙 2026-07-30 裁定): the warning is a pure
12
- // hint — deleting it doesn't break any behavior, so it's exactly the
13
- // kind of code a future refactor drops silently. This test is the
14
- // tripwire: if the branch goes away, this test turns red.
15
- //
16
- // witnessed-red methodology (`feedback_witnessed_red_before_witnessed_green`):
17
- // I confirmed both assertions fail cleanly when the `warning` branch is
18
- // reverted (see docs/tests/p-498-reply-warning/witnessed-red.txt), so
19
- // this suite genuinely catches regressions rather than green-when-empty.
6
+ // #498 compatibility warning remains load-bearing during the mixed-version
7
+ // rollout. Capability-negotiated agents use send_peer_reply; old send_reply
8
+ // callers targeting an agent get explicit migration guidance while Dashboard
9
+ // targets stay quiet.
20
10
 
21
11
  const NET_ID = "net_498_warn";
22
12
  const USER_ID = "u_498_warn";
23
13
  const NODE_ID = "node_498_warn";
24
14
  const AGENT_ALIAS = "peer-agent-498";
15
+ const DISPATCHER_NODE_ID = "node_498_dispatcher";
16
+ const DISPATCHER_ALIAS = "dispatcher";
25
17
  const AGENT_TOK_ID = "tok_498_warn";
26
18
 
27
19
  interface ToolHandler {
@@ -57,11 +49,21 @@ function seed() {
57
49
  VALUES (?1, ?2, 'x', 'user', datetime('now'))`,
58
50
  [USER_ID, USER_ID],
59
51
  );
52
+ db.run(
53
+ `INSERT INTO nodes (node_id, node_name, alias, network_id, hostname, created_at, updated_at, lifecycle_state)
54
+ VALUES (?1, ?2, ?3, ?4, ?5, datetime('now'), datetime('now'), 'active')`,
55
+ [DISPATCHER_NODE_ID, DISPATCHER_ALIAS, DISPATCHER_ALIAS, NET_ID, `host-${DISPATCHER_ALIAS}`],
56
+ );
60
57
  db.run(
61
58
  `INSERT INTO networks (network_id, network_name, owner_id, created_at)
62
59
  VALUES (?1, ?2, ?3, datetime('now'))`,
63
60
  [NET_ID, NET_ID, USER_ID],
64
61
  );
62
+ db.run(
63
+ `INSERT INTO sessions (resume_id, alias, status, node_id, network_id, updated_at, last_seen_at)
64
+ VALUES (?1, ?2, 'idle', ?3, ?4, datetime('now'), datetime('now'))`,
65
+ [`res_${DISPATCHER_ALIAS}`, DISPATCHER_ALIAS, DISPATCHER_NODE_ID, NET_ID],
66
+ );
65
67
  db.run(
66
68
  `INSERT INTO network_members (user_id, network_id, role, joined_at)
67
69
  VALUES (?1, ?2, 'owner', datetime('now'))`,
@@ -84,12 +86,12 @@ function seed() {
84
86
  );
85
87
  }
86
88
 
87
- function makeTask(to: string): string {
89
+ function makeTask(from: string): string {
88
90
  const id = "t_" + Math.random().toString(36).slice(2, 14);
89
91
  db.run(
90
- `INSERT INTO tasks (task_id, from_name, to_name, priority, status, content, requires_response, created_at, network_id)
91
- VALUES (?1, ?2, ?3, 'normal', 'delivered', 'test', 'reply', datetime('now'), ?4)`,
92
- [id, "dispatcher", to, NET_ID],
92
+ `INSERT INTO tasks (task_id, from_name, to_name, to_node_id, priority, status, content, requires_response, created_at, network_id)
93
+ VALUES (?1, ?2, ?3, ?4, 'normal', 'delivered', 'test', 'reply', datetime('now'), ?5)`,
94
+ [id, from, AGENT_ALIAS, NODE_ID, NET_ID],
93
95
  );
94
96
  return id;
95
97
  }
@@ -127,38 +129,36 @@ async function call(handler: ToolHandler, args: any): Promise<Reply> {
127
129
  return JSON.parse(r.content[0].text) as Reply;
128
130
  }
129
131
 
130
- describe("send_reply warning field (#498)", () => {
131
- test("target alias resolves to a real agent → response includes `warning` field", async () => {
132
+ describe("send_reply legacy/Dashboard compatibility (#698)", () => {
133
+ test("legacy call still closes the original and enqueues one no-response result", async () => {
132
134
  seed();
133
135
  const tools = buildHandlers();
134
136
  const sendReply = tools["send_reply"];
135
137
  expect(sendReply).toBeDefined();
136
138
 
137
- const taskId = makeTask(AGENT_ALIAS);
139
+ const taskId = makeTask(DISPATCHER_ALIAS);
138
140
  const reply = await call(sendReply, {
139
- alias: AGENT_ALIAS,
140
- text: "peer reply (should trigger warning)",
141
+ alias: DISPATCHER_ALIAS,
142
+ text: "peer reply (atomic)",
141
143
  in_reply_to: taskId,
142
144
  status: "replied",
143
145
  from_session: AGENT_ALIAS,
144
146
  });
145
147
 
146
148
  expect(reply.ok).toBe(true);
147
- expect(reply.warning).toBeDefined();
148
- expect(typeof reply.warning).toBe("string");
149
- const w = reply.warning as string;
150
- // Action-pointing content — witnessed-red methodology means each
151
- // assertion here must be one a future revert would break, not a
152
- // shape-only check that passes on empty string.
153
- expect(w).toContain("commhub_send_task");
154
- // Alias value is INLINED (not just "<alias>") so the LLM has a
155
- // copy-pasteable next command. This is the specific design 通信龙
156
- // called out on 2026-07-30.
157
- expect(w).toContain(`alias="${AGENT_ALIAS}"`);
158
- expect(w).toContain("agent peers");
159
- expect(w).toContain("not see this reply in real time");
160
- expect(w).toContain("RFC-030");
161
- expect(w).toContain("全网规则");
149
+ expect(reply.warning).toContain("commhub_send_peer_reply");
150
+ expect(reply.warning).toContain("terminalized the original task");
151
+ expect(reply.warning).not.toContain("commhub_send_task");
152
+ expect(reply.warning).toContain("mixed-version");
153
+ expect(db.get<{ status: string; result: string }>(
154
+ "SELECT status, result FROM tasks WHERE task_id = ?1", taskId,
155
+ )).toEqual(expect.objectContaining({ status: "replied", result: "peer reply (atomic)" }));
156
+ expect(db.all<{ type: string; requires_response: string; session_name: string }>(
157
+ "SELECT type, requires_response, session_name FROM inbox WHERE in_reply_to = ?1", taskId,
158
+ )).toEqual([{ type: "reply", requires_response: "none", session_name: DISPATCHER_ALIAS }]);
159
+ expect(db.get<{ n: number }>(
160
+ "SELECT COUNT(*) AS n FROM tasks WHERE parent_task_id = ?1", taskId,
161
+ )?.n).toBe(0);
162
162
  });
163
163
 
164
164
  test("target alias is `hub` (Dashboard path) → NO warning field", async () => {
@@ -0,0 +1,131 @@
1
+ // #1085 — send_reply must not require `alias` when `in_reply_to` is set.
2
+ //
3
+ // Symptom (deployed SDK-runtime nodes): `mcp__commhub__send_reply(task_id,
4
+ // text)` → `-32602 Invalid input: expected string, received undefined at
5
+ // alias`. That is the HUB's Zod schema rejecting a required `alias` the
6
+ // client never sent — the request dies before the handler runs, so the
7
+ // original task is never terminalized and its inbox row stays unacked
8
+ // (pending inflation).
9
+ //
10
+ // Fix (two parts, both in tools.ts):
11
+ // 1. `replyToolSchema.alias` → optional (stops the MCP-layer Zod -32602).
12
+ // 2. `handleReply` derives the target from the in_reply_to task's
13
+ // `from_name` when alias is omitted — the target was always knowable
14
+ // from the task the hub already looks up, so the param was redundant.
15
+ //
16
+ // This suite drives the registered handler directly (MCP Zod layer is
17
+ // exercised separately by the framework), so it pins part (2): omit alias
18
+ // → derive → reply lands on the original sender; omit both → clean error.
19
+ //
20
+ // 改坏报红 gate: revert the derive block (require alias again) and
21
+ // "alias omitted → derives to original sender" flips to a resolve failure.
22
+
23
+ import { afterAll, beforeEach, describe, expect, test } from "bun:test";
24
+ import { db } from "./db.js";
25
+ import { McpServer } from "@modelcontextprotocol/sdk/server/mcp.js";
26
+ import { registerTools } from "./tools.js";
27
+
28
+ const NET_ID = "net_1085";
29
+ const USER_ID = "u_1085";
30
+ const NODE_ID = "node_1085";
31
+ const AGENT_ALIAS = "worker-1085";
32
+ const ORIGIN_ALIAS = "boss-1085"; // the task's from_name — the derive target
33
+ const AGENT_TOK_ID = "tok_1085";
34
+
35
+ interface ToolHandler {
36
+ (args: any, extra?: any): Promise<{ content: Array<{ type: "text"; text: string }> }>;
37
+ }
38
+ interface Reply { ok?: boolean; message_id?: string; error?: string; message?: string; [k: string]: unknown; }
39
+
40
+ function cleanup() {
41
+ for (const t of ["tasks", "inbox", "task_events", "sessions", "nodes", "api_tokens", "network_members", "networks"]) {
42
+ try { db.run(`DELETE FROM ${t} WHERE network_id = ?1`, [NET_ID]); } catch {}
43
+ }
44
+ try { db.run("DELETE FROM users WHERE user_id = ?1", [USER_ID]); } catch {}
45
+ }
46
+ beforeEach(cleanup);
47
+ afterAll(cleanup);
48
+
49
+ function seed(): { taskId: string } {
50
+ db.run(`INSERT INTO users (user_id, username, password_hash, role, created_at) VALUES (?1, ?2, 'x', 'user', datetime('now'))`, [USER_ID, USER_ID]);
51
+ db.run(`INSERT INTO networks (network_id, network_name, owner_id, created_at) VALUES (?1, ?2, ?3, datetime('now'))`, [NET_ID, NET_ID, USER_ID]);
52
+ db.run(`INSERT INTO network_members (user_id, network_id, role, joined_at) VALUES (?1, ?2, 'owner', datetime('now'))`, [USER_ID, NET_ID]);
53
+ db.run(`INSERT INTO nodes (node_id, node_name, alias, network_id, hostname, created_at, updated_at, lifecycle_state) VALUES (?1, ?2, ?3, ?4, ?5, datetime('now'), datetime('now'), 'active')`, [NODE_ID, AGENT_ALIAS, AGENT_ALIAS, NET_ID, `host-${AGENT_ALIAS}`]);
54
+ db.run(`INSERT INTO sessions (resume_id, alias, status, node_id, network_id, updated_at, last_seen_at) VALUES (?1, ?2, 'idle', ?3, ?4, datetime('now'), datetime('now'))`, [`res_${AGENT_ALIAS}`, AGENT_ALIAS, NODE_ID, NET_ID]);
55
+ // The reply TARGET session (the task originator). Its alias is what the
56
+ // handler must derive from the task's from_name.
57
+ db.run(`INSERT INTO sessions (resume_id, alias, status, network_id, updated_at, last_seen_at) VALUES (?1, ?2, 'idle', ?3, datetime('now'), datetime('now'))`, [`res_${ORIGIN_ALIAS}`, ORIGIN_ALIAS, NET_ID]);
58
+ // A task from ORIGIN_ALIAS → the worker. Replying to it should land on
59
+ // ORIGIN_ALIAS even when the caller omits alias.
60
+ const taskId = `task_1085_${Date.now()}${Math.floor(Math.random() * 1000)}`;
61
+ db.run(`INSERT INTO tasks (task_id, from_name, to_name, status, content, requires_response, created_at, delivered_at, expires_at, network_id, priority) VALUES (?1, ?2, ?3, 'delivered', 'do the thing', 'reply', datetime('now'), datetime('now'), datetime('now', '+1 hour'), ?4, 'normal')`, [taskId, ORIGIN_ALIAS, AGENT_ALIAS, NET_ID]);
62
+ return { taskId };
63
+ }
64
+
65
+ async function getHandler(): Promise<ToolHandler> {
66
+ const server = new McpServer({ name: "test", version: "0" });
67
+ const tools: Record<string, ToolHandler> = {};
68
+ const originalTool = (server as any).tool.bind(server);
69
+ (server as any).tool = (name: string, ...rest: any[]) => {
70
+ const handler = rest[rest.length - 1];
71
+ if (typeof handler === "function") tools[name] = handler;
72
+ return originalTool(name, ...rest);
73
+ };
74
+ registerTools(server, {
75
+ enforceNetworkId: NET_ID,
76
+ enforceUserId: USER_ID,
77
+ callerAlias: AGENT_ALIAS,
78
+ callerTokenIsNetwork: true,
79
+ callerTokenId: AGENT_TOK_ID,
80
+ } as any);
81
+ const handler = tools.send_reply;
82
+ if (!handler) throw new Error("send_reply handler not registered");
83
+ return handler;
84
+ }
85
+
86
+ async function call(h: ToolHandler, args: any): Promise<Reply> {
87
+ return JSON.parse((await h(args)).content[0].text) as Reply;
88
+ }
89
+
90
+ describe("#1085 send_reply — alias optional, derived from in_reply_to", () => {
91
+ test("alias OMITTED + in_reply_to set → derives target from task from_name, reply lands on originator", async () => {
92
+ const { taskId } = seed();
93
+ const h = await getHandler();
94
+ const r = await call(h, { in_reply_to: taskId, text: "done", status: "replied", from_session: AGENT_ALIAS });
95
+ expect(r.ok).toBe(true);
96
+ // The reply inbox row must be addressed to the derived originator.
97
+ const row = db.get<{ session_name: string; in_reply_to: string }>(
98
+ "SELECT session_name, in_reply_to FROM inbox WHERE id = ?1", [r.message_id],
99
+ );
100
+ expect(row?.session_name).toBe(ORIGIN_ALIAS);
101
+ expect(row?.in_reply_to).toBe(taskId);
102
+ // And the original task is terminalized (no longer pending).
103
+ const task = db.get<{ status: string }>("SELECT status FROM tasks WHERE task_id = ?1", [taskId]);
104
+ expect(task?.status).toBe("replied");
105
+ });
106
+
107
+ test("alias EXPLICIT still works (unchanged path)", async () => {
108
+ const { taskId } = seed();
109
+ const h = await getHandler();
110
+ const r = await call(h, { alias: ORIGIN_ALIAS, in_reply_to: taskId, text: "done", from_session: AGENT_ALIAS });
111
+ expect(r.ok).toBe(true);
112
+ const row = db.get<{ session_name: string }>("SELECT session_name FROM inbox WHERE id = ?1", [r.message_id]);
113
+ expect(row?.session_name).toBe(ORIGIN_ALIAS);
114
+ });
115
+
116
+ test("alias OMITTED + no in_reply_to → clean error, not a crash", async () => {
117
+ seed();
118
+ const h = await getHandler();
119
+ const r = await call(h, { text: "orphan reply", from_session: AGENT_ALIAS });
120
+ expect(r.ok).toBe(false);
121
+ expect(r.error).toBe("reply_target_required");
122
+ });
123
+
124
+ test("alias OMITTED + in_reply_to points at nonexistent task → resolve error", async () => {
125
+ seed();
126
+ const h = await getHandler();
127
+ const r = await call(h, { in_reply_to: "task_does_not_exist_1085", text: "x", from_session: AGENT_ALIAS });
128
+ expect(r.ok).toBe(false);
129
+ expect(r.error).toBe("reply_target_unresolved");
130
+ });
131
+ });