@sleep2agi/commhub-server 0.9.0-preview.25 → 0.9.0-preview.250

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 (417) hide show
  1. package/README.md +129 -9
  2. package/bin/commhub.ts +93 -9
  3. package/build-info.json +7 -0
  4. package/package.json +10 -8
  5. package/src/ack-create-request-transport.test.ts +182 -0
  6. package/src/ack-create-request.test.ts +52 -8
  7. package/src/admin-delete-network-http.test.ts +228 -0
  8. package/src/admin-networks-http.test.ts +88 -0
  9. package/src/adoption-candidates-http.test.ts +140 -0
  10. package/src/adoption-candidates.ts +158 -0
  11. package/src/agent-access-batch.test.ts +210 -0
  12. package/src/agent-access.ts +487 -0
  13. package/src/agent-acl-groups-http.test.ts +247 -0
  14. package/src/agent-acl-http.test.ts +675 -0
  15. package/src/agent-acl-slice3-http.test.ts +717 -0
  16. package/src/agent-department-http.test.ts +215 -0
  17. package/src/agent-groups-perf.test.ts +223 -0
  18. package/src/agent-notice.ts +48 -0
  19. package/src/agent-team-whoami-http.test.ts +98 -0
  20. package/src/agent-teams-http.test.ts +330 -0
  21. package/src/agent-teams.ts +244 -0
  22. package/src/alias-baseline-2571.test.ts +162 -0
  23. package/src/alias-baseline.ts +113 -0
  24. package/src/alias-filter.test.ts +72 -0
  25. package/src/alias-filter.ts +42 -0
  26. package/src/api-host-supervisors-can-create-nodes.test.ts +350 -0
  27. package/src/api-host-supervisors-fallback.test.ts +6 -7
  28. package/src/api-host-supervisors-runtime-readiness.test.ts +195 -0
  29. package/src/api-nodes-shape.test.ts +95 -4
  30. package/src/auth-password-change-cli-tokens-http.test.ts +423 -0
  31. package/src/auth-sessions-http.test.ts +260 -0
  32. package/src/auth-validate.test.ts +5 -1
  33. package/src/auth-weak-password-login.test.ts +176 -0
  34. package/src/auth.ts +609 -51
  35. package/src/avatar-validate.test.ts +52 -2
  36. package/src/avatar-validate.ts +35 -1
  37. package/src/backfill-node-ids-2664.test.ts +128 -0
  38. package/src/binding-generation-http.test.ts +132 -0
  39. package/src/blocked-exit-on-reply.test.ts +122 -0
  40. package/src/broadcast-fanout-2721.test.ts +149 -0
  41. package/src/broadcast-fanout.ts +117 -0
  42. package/src/build-info.test.ts +60 -0
  43. package/src/build-info.ts +85 -0
  44. package/src/chain-attempt-dedup.test.ts +447 -0
  45. package/src/clip.test.ts +36 -0
  46. package/src/clip.ts +48 -0
  47. package/src/clone-node.test.ts +262 -0
  48. package/src/clone-node.ts +289 -0
  49. package/src/codex-config-flags.ts +77 -0
  50. package/src/codex-fork-contract.ts +23 -0
  51. package/src/codex-fork-migration.test.ts +38 -0
  52. package/src/commhub-bin-args.test.ts +85 -0
  53. package/src/config-apply-validate.test.ts +188 -1
  54. package/src/config-apply-validate.ts +222 -3
  55. package/src/cors-origins.test.ts +73 -0
  56. package/src/create-node-blocked-gate.test.ts +356 -0
  57. package/src/create-node-network-id.test.ts +91 -0
  58. package/src/create-node-tool-schema.test.ts +49 -0
  59. package/src/create-node-unicode-name.test.ts +126 -0
  60. package/src/create-node-validate.test.ts +199 -7
  61. package/src/create-node-validate.ts +232 -15
  62. package/src/create-node-workdir.test.ts +298 -0
  63. package/src/create-node.ts +88 -23
  64. package/src/daemon-provider-snapshots.test.ts +445 -0
  65. package/src/daemon-provider-snapshots.ts +327 -0
  66. package/src/daemon-token-owner-http.test.ts +292 -0
  67. package/src/dashboard-slash-routing-http.test.ts +109 -0
  68. package/src/db-adapter-guard.test.ts +148 -0
  69. package/src/db-adapter-translate.test.ts +128 -0
  70. package/src/db-adapter.ts +377 -91
  71. package/src/db-timestamp.test.ts +38 -0
  72. package/src/db-timestamp.ts +15 -0
  73. package/src/db.ts +1264 -153
  74. package/src/delivered-without-push.test.ts +140 -0
  75. package/src/department-groups-http.test.ts +209 -0
  76. package/src/department-groups-sync-http.test.ts +328 -0
  77. package/src/department-groups.ts +434 -0
  78. package/src/department-heads-http.test.ts +350 -0
  79. package/src/department-heads.ts +226 -0
  80. package/src/departments-agent-count.test.ts +132 -0
  81. package/src/departments-http.test.ts +185 -0
  82. package/src/departments-mcp.test.ts +128 -0
  83. package/src/departments.ts +318 -0
  84. package/src/desktop-message-seam.test.ts +150 -0
  85. package/src/desktop-message.test.ts +368 -0
  86. package/src/dm-file-scope-http.test.ts +178 -0
  87. package/src/empty-node-sweeper.test.ts +104 -0
  88. package/src/empty-node-sweeper.ts +88 -0
  89. package/src/env-transport-gate-http.test.ts +240 -0
  90. package/src/env-transport-gate.ts +80 -0
  91. package/src/env-transport-policy.ts +56 -0
  92. package/src/etag-of.test.ts +57 -0
  93. package/src/event-loop-lag.test.ts +180 -0
  94. package/src/event-loop-lag.ts +201 -0
  95. package/src/expiry-counters.test.ts +111 -0
  96. package/src/expiry-counters.ts +93 -0
  97. package/src/ext-token-shared.test.ts +60 -0
  98. package/src/ext-validation-regression.test.ts +131 -0
  99. package/src/external-schedule-edits-http.test.ts +321 -0
  100. package/src/external-schedule-edits-timestamps.test.ts +64 -0
  101. package/src/external-schedule-edits.ts +327 -0
  102. package/src/file-download-authz-dev-open.test.ts +1 -1
  103. package/src/file-download-authz.test.ts +73 -18
  104. package/src/file-download-date-bucket.test.ts +8 -26
  105. package/src/file-network-scope-dev-open.test.ts +97 -0
  106. package/src/file-network-scope.test.ts +732 -0
  107. package/src/group-membership-events-http.test.ts +264 -0
  108. package/src/group-messages-http.test.ts +483 -0
  109. package/src/group-messages.ts +297 -0
  110. package/src/health-anon-readers.ts +60 -0
  111. package/src/health-host-disk-2756.test.ts +71 -0
  112. package/src/health-redaction.test.ts +1541 -7
  113. package/src/host-supervisor-identity-http.test.ts +152 -0
  114. package/src/host-supervisor-identity.ts +92 -0
  115. package/src/host-supervisors-daemon-version.test.ts +137 -0
  116. package/src/http-gzip.test.ts +94 -0
  117. package/src/http-gzip.ts +112 -0
  118. package/src/hub-catalog-read-http.test.ts +641 -0
  119. package/src/hub-provider-config.test.ts +166 -0
  120. package/src/hub-provider-config.ts +202 -0
  121. package/src/hub-timestamp.test.ts +38 -0
  122. package/src/hub-timestamp.ts +27 -0
  123. package/src/human-dm.ts +215 -0
  124. package/src/human-inbox.ts +42 -0
  125. package/src/inbox-caller.ts +49 -0
  126. package/src/inbox-count-sse.test.ts +310 -0
  127. package/src/inbox-count.ts +29 -0
  128. package/src/index.ts +6 -2
  129. package/src/license-state.test.ts +56 -0
  130. package/src/license-state.ts +48 -0
  131. package/src/list-host-supervisors.test.ts +15 -4
  132. package/src/mcp-context-cost-http.test.ts +127 -0
  133. package/src/mcp-inflight.test.ts +92 -0
  134. package/src/mcp-inflight.ts +38 -0
  135. package/src/mcp-projects-events-http.test.ts +165 -0
  136. package/src/mcp-route-label-http.test.ts +120 -0
  137. package/src/mcp-write-network-resolution.test.ts +435 -0
  138. package/src/member-audit-network-id-http.test.ts +93 -0
  139. package/src/member-presence-http.test.ts +210 -0
  140. package/src/messages-ack-by-agent-http.test.ts +142 -0
  141. package/src/migrate-sqlite-to-pg.test.ts +47 -0
  142. package/src/migrate-sqlite-to-pg.ts +263 -0
  143. package/src/model-auth-notify-http.test.ts +181 -0
  144. package/src/model-auth-notify.ts +116 -0
  145. package/src/network-name-http.test.ts +75 -0
  146. package/src/network-rules-http.test.ts +169 -0
  147. package/src/network-rules.ts +129 -0
  148. package/src/network-scope.ts +276 -0
  149. package/src/network-token-membership-http.test.ts +186 -0
  150. package/src/node-alias-control.ts +12 -0
  151. package/src/node-attrs.test.ts +47 -2
  152. package/src/node-caller-identity-http.test.ts +1108 -0
  153. package/src/node-create-request-status-http.test.ts +105 -0
  154. package/src/node-daemon-bindings.test.ts +132 -0
  155. package/src/node-daemon-bindings.ts +135 -0
  156. package/src/node-failure-alert.test.ts +150 -0
  157. package/src/node-failure-alert.ts +177 -0
  158. package/src/node-files-transport.test.ts +347 -0
  159. package/src/node-health-codex-login.test.ts +120 -0
  160. package/src/node-health-dispatch-http.test.ts +373 -0
  161. package/src/node-health-guard.ts +121 -0
  162. package/src/node-health-passthrough.test.ts +115 -0
  163. package/src/node-health-store.ts +101 -0
  164. package/src/node-id-alias.test.ts +190 -0
  165. package/src/node-identity-conflict-http.test.ts +269 -0
  166. package/src/node-identity-conflict.ts +142 -0
  167. package/src/node-identity-mismatch.test.ts +74 -0
  168. package/src/node-in-flight-tasks.ts +31 -0
  169. package/src/node-lifecycle-controllable.test.ts +64 -0
  170. package/src/node-lifecycle-controllable.ts +53 -0
  171. package/src/node-lifecycle-read-http.test.ts +257 -0
  172. package/src/node-lifecycle-read.ts +124 -0
  173. package/src/node-logs-transport.test.ts +263 -0
  174. package/src/node-peer-allowlist.test.ts +114 -0
  175. package/src/node-permissions-http.test.ts +728 -0
  176. package/src/node-permissions.ts +494 -0
  177. package/src/node-request-retention.test.ts +281 -0
  178. package/src/node-request-retention.ts +120 -0
  179. package/src/node-secret-rest-http.test.ts +190 -0
  180. package/src/node-serviceability.test.ts +86 -0
  181. package/src/node-serviceability.ts +124 -0
  182. package/src/node-session-control-http.test.ts +310 -0
  183. package/src/node-session-control.ts +258 -0
  184. package/src/node-skills-transport.test.ts +212 -0
  185. package/src/node-token-identity.ts +35 -0
  186. package/src/node-token-ownership.ts +51 -0
  187. package/src/node-token-privilege-http.test.ts +158 -0
  188. package/src/not-found-api-http.test.ts +67 -0
  189. package/src/observer-avatar-http.test.ts +102 -9
  190. package/src/observer-push.test.ts +76 -0
  191. package/src/opencode-catalog-report-http.test.ts +139 -0
  192. package/src/opencode-v2-catalog.test.ts +268 -0
  193. package/src/opencode-v2-catalog.ts +356 -0
  194. package/src/package-version-consistency.test.ts +25 -0
  195. package/src/parent-source-marker.test.ts +50 -0
  196. package/src/password-network-tokens.ts +25 -0
  197. package/src/peer-reply-atomic.test.ts +462 -0
  198. package/src/peer-reply-capability.test.ts +70 -0
  199. package/src/pg-worker.ts +87 -0
  200. package/src/poll-pacing.test.ts +74 -0
  201. package/src/poll-pacing.ts +123 -0
  202. package/src/project-dir-warn-clear-http.test.ts +132 -0
  203. package/src/project-viewer-can-http.test.ts +116 -0
  204. package/src/provider-tools-shape.test.ts +150 -0
  205. package/src/push.test.ts +20 -10
  206. package/src/push.ts +373 -9
  207. package/src/redact-tokens.test.ts +86 -0
  208. package/src/redact-tokens.ts +43 -0
  209. package/src/rejection-counters.test.ts +72 -0
  210. package/src/rejection-counters.ts +173 -0
  211. package/src/rename.ts +38 -10
  212. package/src/reply-target-derivation.test.ts +96 -0
  213. package/src/report-status-handover-capabilities-http.test.ts +124 -0
  214. package/src/report-status-host-schema.test.ts +235 -0
  215. package/src/report-status-resume-id-handover.test.ts +184 -0
  216. package/src/report-status-secret-keys.test.ts +140 -0
  217. package/src/require-explicit-test-db.ts +9 -0
  218. package/src/requirement-due-reminders-http.test.ts +620 -0
  219. package/src/requirement-due-reminders.ts +416 -0
  220. package/src/requirement-events-http.test.ts +318 -0
  221. package/src/requirement-events.test.ts +45 -0
  222. package/src/requirement-events.ts +144 -0
  223. package/src/requirement-notify.ts +165 -0
  224. package/src/requirement-participant-notify-http.test.ts +309 -0
  225. package/src/requirement-tag-ops-http.test.ts +454 -0
  226. package/src/requirement-tag-tree-http.test.ts +275 -0
  227. package/src/requirement-tag-tree.ts +127 -0
  228. package/src/requirement-tags.ts +102 -0
  229. package/src/requirements-abandoned-http.test.ts +236 -0
  230. package/src/requirements-assignee-drift.test.ts +154 -0
  231. package/src/requirements-comment-http.test.ts +174 -0
  232. package/src/requirements-completed-at-migration.test.ts +70 -0
  233. package/src/requirements-errors-mcp-http.test.ts +164 -0
  234. package/src/requirements-errors.ts +158 -0
  235. package/src/requirements-etag-http.test.ts +91 -0
  236. package/src/requirements-http.test.ts +709 -0
  237. package/src/requirements-last-event-http.test.ts +349 -0
  238. package/src/requirements-list-mcp-slim-http.test.ts +155 -0
  239. package/src/requirements-list-slim-http.test.ts +324 -0
  240. package/src/requirements-mcp.test.ts +164 -0
  241. package/src/requirements-migrate.ts +283 -0
  242. package/src/requirements-owner-strict-mcp-http.test.ts +145 -0
  243. package/src/requirements-people-http.test.ts +114 -0
  244. package/src/requirements-people-mcp-http.test.ts +231 -0
  245. package/src/requirements-people.ts +196 -0
  246. package/src/requirements-priority-lowest.test.ts +114 -0
  247. package/src/requirements-projects-network-echo.test.ts +57 -0
  248. package/src/requirements-projects-parent-http.test.ts +123 -0
  249. package/src/requirements-search-http.test.ts +182 -0
  250. package/src/requirements-search.test.ts +32 -0
  251. package/src/requirements-search.ts +145 -0
  252. package/src/requirements-seq-http.test.ts +193 -0
  253. package/src/requirements-seq-migration.test.ts +63 -0
  254. package/src/requirements-start-date.test.ts +125 -0
  255. package/src/requirements-stats-http.test.ts +357 -0
  256. package/src/requirements-stats.ts +195 -0
  257. package/src/requirements-status-participants-http.test.ts +222 -0
  258. package/src/requirements-upgrade-e2e.test.ts +126 -0
  259. package/src/requirements-upgrade-migration.test.ts +98 -0
  260. package/src/requirements.ts +2205 -0
  261. package/src/resolve-port.test.ts +57 -0
  262. package/src/resolve-port.ts +44 -0
  263. package/src/rest-alias-network-fallback-http.test.ts +123 -0
  264. package/src/rest-alias-network-fallback.test.ts +60 -0
  265. package/src/rest-alias-network-fallback.ts +65 -0
  266. package/src/rest-explicit-columns-http.test.ts +266 -0
  267. package/src/rest-identity.test.ts +130 -0
  268. package/src/rest-identity.ts +141 -0
  269. package/src/rest-projections.ts +72 -0
  270. package/src/rest-read-network-real-chain.test.ts +97 -0
  271. package/src/rest-write-network-resolution.test.ts +133 -0
  272. package/src/restart-readiness-http.test.ts +121 -0
  273. package/src/restricted-files.ts +76 -0
  274. package/src/retention-first-sweep-quiet.test.ts +31 -0
  275. package/src/retention.test.ts +100 -40
  276. package/src/retention.ts +423 -104
  277. package/src/route-callers-http.test.ts +120 -0
  278. package/src/route-timing.test.ts +218 -0
  279. package/src/route-timing.ts +262 -0
  280. package/src/rules-file-duplicate-alias.test.ts +234 -0
  281. package/src/rules-file-session-target.test.ts +207 -0
  282. package/src/rules-file-transport.test.ts +237 -0
  283. package/src/runtime-label.test.ts +22 -0
  284. package/src/runtime-label.ts +21 -0
  285. package/src/runtime-readiness.ts +90 -0
  286. package/src/schedule-agent-mcp-http.test.ts +475 -0
  287. package/src/schedule-agent.ts +252 -0
  288. package/src/schedule-starved.test.ts +92 -0
  289. package/src/schedule-starved.ts +114 -0
  290. package/src/scheduled-backoff-http.test.ts +203 -0
  291. package/src/scheduled-backoff.ts +64 -0
  292. package/src/scheduled-doorbell-nodeless-session.test.ts +134 -0
  293. package/src/scheduled-failure-backoff-2622.test.ts +145 -0
  294. package/src/scheduled-failure-code.test.ts +73 -0
  295. package/src/scheduled-failure-code.ts +105 -0
  296. package/src/scheduled-failures-http.test.ts +279 -0
  297. package/src/scheduled-failures.ts +425 -0
  298. package/src/scheduled-noprogress-backoff-2622.test.ts +163 -0
  299. package/src/scheduled-offline-backoff-probe.test.ts +56 -0
  300. package/src/scheduled-offline.test.ts +131 -0
  301. package/src/scheduled-offline.ts +66 -0
  302. package/src/scheduled-outcome-guidance-http.test.ts +139 -0
  303. package/src/scheduled-outcome-guidance.ts +9 -0
  304. package/src/scheduled-reply-unread-http.test.ts +212 -0
  305. package/src/scheduled-requirement-wake-http.test.ts +285 -0
  306. package/src/scheduled-requirement-wake.ts +125 -0
  307. package/src/scheduled-run-terminal.test.ts +290 -0
  308. package/src/scheduled-skip-blocking-task.test.ts +120 -0
  309. package/src/scheduled-skip-path-backoff-2622.test.ts +98 -0
  310. package/src/scheduled-stuck-http.test.ts +316 -0
  311. package/src/scheduled-stuck-notice-cap.test.ts +80 -0
  312. package/src/scheduled-stuck.ts +219 -0
  313. package/src/scheduled-tasks-http.test.ts +679 -0
  314. package/src/scheduled-tasks.ts +959 -0
  315. package/src/scheduled-work-outcome-http.test.ts +154 -0
  316. package/src/scheduled-work-outcome.ts +50 -0
  317. package/src/scoped-secrets.ts +141 -0
  318. package/src/secret-echo-negative-control.test.ts +118 -0
  319. package/src/send-dedup-request-id.test.ts +229 -0
  320. package/src/send-reply-agent-warning.test.ts +38 -38
  321. package/src/send-reply-alias-optional.test.ts +131 -0
  322. package/src/send-reply-attachments.test.ts +458 -0
  323. package/src/send_dedup.test.ts +54 -0
  324. package/src/send_dedup.ts +52 -6
  325. package/src/serve-error.test.ts +73 -0
  326. package/src/serve-error.ts +56 -0
  327. package/src/server.ts +5134 -503
  328. package/src/session-task-on-dispatch.ts +14 -0
  329. package/src/session-token-ownership-http.test.ts +122 -0
  330. package/src/shared/codex-inventory.ts +41 -0
  331. package/src/shared/daemon-provider-login.ts +31 -0
  332. package/src/shared/daemon-provider-snapshot.ts +52 -0
  333. package/src/shared/external-schedule-contract.ts +60 -0
  334. package/src/shared/node-name.test.ts +62 -0
  335. package/src/shared/node-name.ts +161 -0
  336. package/src/shared/probe-host-allowlist-drift.test.ts +45 -0
  337. package/src/shared/provider-application.ts +29 -0
  338. package/src/shared/provider-collection.ts +14 -0
  339. package/src/shared/provider-initialization.ts +8 -0
  340. package/src/shared/reserved-env-drift.test.ts +10 -0
  341. package/src/shared/scoped-secret-contract.ts +5 -0
  342. package/src/shared/task-content-limit-drift.test.ts +28 -0
  343. package/src/shared/task-content-limit.ts +25 -0
  344. package/src/side-thread-command-transport.test.ts +312 -0
  345. package/src/side-thread-command-transport.ts +318 -0
  346. package/src/side-thread-http-integration.test.ts +233 -0
  347. package/src/side-thread-http.ts +504 -0
  348. package/src/side-thread-production.test.ts +72 -0
  349. package/src/side-thread-production.ts +118 -0
  350. package/src/side-thread.test.ts +1067 -0
  351. package/src/side-thread.ts +2499 -0
  352. package/src/skillhub-http.test.ts +142 -0
  353. package/src/sqlite-close-checkpoint.test.ts +78 -0
  354. package/src/start-node.test.ts +265 -0
  355. package/src/stats-versions-http.test.ts +65 -0
  356. package/src/status-alias-filter-http.test.ts +106 -0
  357. package/src/status-alias-resolver-http.test.ts +163 -0
  358. package/src/status-alias-resolver.ts +19 -0
  359. package/src/status-node-id-filter-http.test.ts +161 -0
  360. package/src/status-read-cache-http.test.ts +229 -0
  361. package/src/status-read-cache.ts +129 -0
  362. package/src/stop-delete-node.test.ts +567 -1
  363. package/src/task-access-http.test.ts +402 -0
  364. package/src/task-access.ts +420 -0
  365. package/src/task-activity.ts +60 -0
  366. package/src/task-auth-origin-http.test.ts +93 -0
  367. package/src/task-auth-origin.test.ts +24 -0
  368. package/src/task-auth-origin.ts +7 -0
  369. package/src/task-consumption.test.ts +498 -0
  370. package/src/task-diagnostic-http.test.ts +149 -0
  371. package/src/task-diagnostic.test.ts +115 -0
  372. package/src/task-diagnostic.ts +118 -0
  373. package/src/task-expiry-notice-http.test.ts +287 -0
  374. package/src/task-expiry-notice.ts +318 -0
  375. package/src/task-idempotency-mcp.test.ts +142 -0
  376. package/src/task-idempotency.test.ts +76 -0
  377. package/src/task-idempotency.ts +81 -0
  378. package/src/task-late-replies.ts +54 -0
  379. package/src/task-late-reply-http.test.ts +227 -0
  380. package/src/task-lifecycle-watcher-busy.test.ts +114 -0
  381. package/src/task-lifecycle-watcher.test.ts +209 -0
  382. package/src/task-lifecycle-watcher.ts +109 -0
  383. package/src/task-network-resolution-http.test.ts +140 -0
  384. package/src/task-offline-delivery-2668.test.ts +119 -0
  385. package/src/task-offline-delivery.ts +81 -0
  386. package/src/task-orphan-http.test.ts +287 -0
  387. package/src/task-orphan.ts +119 -0
  388. package/src/task-queue-ahead-http.test.ts +309 -0
  389. package/src/task-queue-ahead-scale.test.ts +236 -0
  390. package/src/task-queue-ahead.ts +186 -0
  391. package/src/task-rejection-log-http.test.ts +160 -0
  392. package/src/task-rejection-log.ts +61 -0
  393. package/src/task-sender-http.test.ts +143 -0
  394. package/src/task-stale-open-http.test.ts +292 -0
  395. package/src/task-stale-open.ts +103 -0
  396. package/src/tasks-pagination-http.test.ts +141 -0
  397. package/src/team-rules-status-http.test.ts +90 -0
  398. package/src/team-rules-status.test.ts +59 -0
  399. package/src/team-rules-status.ts +72 -0
  400. package/src/tmux-allowlist.test.ts +48 -0
  401. package/src/tool-audience-http.test.ts +230 -0
  402. package/src/tool-audience.ts +127 -0
  403. package/src/tools-list-json-schema.test.ts +94 -0
  404. package/src/tools.ts +4326 -420
  405. package/src/upload-early-reject-guard.test.ts +155 -0
  406. package/src/uploads-http.test.ts +86 -7
  407. package/src/uploads.ts +38 -4
  408. package/src/user-avatar-http.test.ts +74 -0
  409. package/src/user-avatar-image.ts +160 -0
  410. package/src/user-avatar-migration.test.ts +25 -0
  411. package/src/user-avatar-upload-http.test.ts +348 -0
  412. package/src/user-inbox-by-agent-http.test.ts +165 -0
  413. package/src/user-inbox-netid-notnull.test.ts +122 -0
  414. package/src/user-inbox-read-http.test.ts +223 -0
  415. package/src/user-inbox-schema.test.ts +54 -0
  416. package/src/version-stats.test.ts +66 -0
  417. package/src/version-stats.ts +109 -0
@@ -0,0 +1,50 @@
1
+ // #669 —— parent_task_id 的来源必须可区分(显式 / 推断)。
2
+ //
3
+ // 没有这个标记时,那张卡要求的前置统计做不出来:tasks 表只存 parent_task_id,
4
+ // 不记它是怎么来的(实测近 7 天 949 条里 0 条可区分)。
5
+ //
6
+ // 这里不测完整派发链路,只钉住「来源判定 + 写进 meta」这一段的行为:
7
+ // · 显式带了 parent_task_id → parent_source = "explicit"
8
+ // · 没带但被推断命中最近 delivered → parent_source = "inferred"
9
+ // · 两者都没有 → meta 里没有 parent_source
10
+ import { describe, expect, test } from "bun:test";
11
+ import { readFileSync } from "node:fs";
12
+
13
+ const src = readFileSync(new URL("./tools.ts", import.meta.url), "utf8");
14
+
15
+ describe("#669 parent source marker", () => {
16
+ test("显式 parent 记为 explicit,推断命中时改写为 inferred", () => {
17
+ expect(src).toContain('let parentSource: "explicit" | "inferred" | null = parentIn ? "explicit" : null;');
18
+ expect(src).toContain('if (recent?.task_id) { parentTaskId = recent.task_id; parentSource = "inferred"; }');
19
+ });
20
+
21
+ test("来源只在确实有 parent 时写进 meta,且序列化失败不影响派发", () => {
22
+ const block = src.slice(src.indexOf("let metaJsonWithParent = metaJson;"), src.indexOf("// round5 F2 fix"));
23
+ expect(block).toContain("if (parentSource && parentTaskId)");
24
+ expect(block).toContain("try {");
25
+ expect(block).toContain("parent_source: parentSource");
26
+ expect(block).toContain("catch {}");
27
+ });
28
+
29
+ test("两条 INSERT(inbox / tasks)都用合并后的 meta", () => {
30
+ const inserts = src.split("\n").filter((l) => l.includes("targetAlias, priority, task") || l.includes("effectiveNetId ?? null, parentTaskId"));
31
+ expect(inserts.some((l) => l.includes("metaJsonWithParent"))).toBe(true);
32
+ });
33
+
34
+ // 这条原本断言「REST 里根本没有 parent_source」——理由是「REST 不走推断,
35
+ // 不要造第二真相」。方向对,但结论错了一半:REST 确实**不该推断**,
36
+ // 可它建的子任务同样是显式父子关系,不标就会被统计漏掉。
37
+ //
38
+ // 实测(2026-10-29,.195 上线后 90 分钟):3 条带 parent 的任务全部走 REST、
39
+ // 全部没有 parent_source。而 MCP 那条路是标的 ⇒ 分母只含 MCP,
40
+ // explicit 占比会被系统性压低。#669 要统计的正是这个比例。
41
+ test("REST /api/task 标「显式」,但不推断", () => {
42
+ const rest = readFileSync(new URL("./server.ts", import.meta.url), "utf8");
43
+ expect(rest).toContain("body.parent_task_id ?? null");
44
+ expect(rest).toContain('parent_source: "explicit"');
45
+ // 不能出现第二份推断:REST 里没有「找最近 delivered」这种 SQL。
46
+ const restBlock = rest.slice(rest.indexOf("const metaWithParent"), rest.indexOf("const metaWithParent") + 400);
47
+ expect(restBlock.toLowerCase()).not.toContain("delivered");
48
+ expect(rest).not.toContain('parentSource = "inferred"');
49
+ });
50
+ });
@@ -0,0 +1,25 @@
1
+ import { db } from "./db.js";
2
+
3
+ export type KeptNetworkToken = {
4
+ token_id: string;
5
+ name: string;
6
+ network_id: string;
7
+ created_at: string;
8
+ last_used_at: string | null;
9
+ };
10
+
11
+ /** Only user-created named network tokens. Node credentials have a different scope or binding. */
12
+ export function passwordNetworkTokens(userId: string, currentTokenId: string | null | undefined, revoke: boolean) {
13
+ const where = `user_id = ?1 AND network_id IS NOT NULL AND scope = 'full'
14
+ AND bound_node_id IS NULL AND revoked_at IS NULL
15
+ AND (expires_at IS NULL OR expires_at > datetime('now'))${currentTokenId ? " AND token_id != ?2" : ""}`;
16
+ const params = currentTokenId ? [userId, currentTokenId] : [userId];
17
+ if (revoke) {
18
+ return { revoked: db.run(`DELETE FROM api_tokens WHERE ${where}`, params).changes, kept: [] as KeptNetworkToken[] };
19
+ }
20
+ const kept = db.all<KeptNetworkToken>(
21
+ `SELECT token_id, name, network_id, created_at, last_used_at FROM api_tokens WHERE ${where} ORDER BY created_at DESC, token_id`,
22
+ ...params,
23
+ );
24
+ return { revoked: 0, kept };
25
+ }
@@ -0,0 +1,462 @@
1
+ import { afterAll, beforeEach, describe, expect, test } from "bun:test";
2
+ import { McpServer } from "@modelcontextprotocol/sdk/server/mcp.js";
3
+ import { db } from "./db.js";
4
+ import { registerTools } from "./tools.js";
5
+ import { CommHubError } from "../../agent-node/src/reply-reliability.js";
6
+ import { sendPeerReplyCompatible } from "../../agent-node/src/peer-reply-send.js";
7
+ import { __resetSSEClientsForTest, createSSEStream } from "./push.js";
8
+ import { eventBus } from "./event_bus.js";
9
+
10
+ const NET = "net_peer_reply_698";
11
+ const USER = "user_peer_reply_698";
12
+ const A = "peer-a-698";
13
+ const B = "peer-b-698";
14
+ const A_ID = "node-peer-a-698";
15
+ const B_ID = "node-peer-b-698";
16
+
17
+ type ToolHandler = (args: any) => Promise<{ content: Array<{ type: "text"; text: string }> }>;
18
+
19
+ function cleanup() {
20
+ __resetSSEClientsForTest();
21
+ try { db.exec("DROP TRIGGER IF EXISTS test698_abort_terminal"); } catch {}
22
+ try { db.exec("DROP TRIGGER IF EXISTS test698_abort_run"); } catch {}
23
+ for (const table of ["scheduled_task_runs", "scheduled_tasks", "tasks", "inbox", "task_events", "sessions", "api_tokens", "nodes", "rename_txn"]) {
24
+ try { db.run(`DELETE FROM ${table} WHERE network_id = ?1`, [NET]); } catch {}
25
+ }
26
+ try { db.run("DELETE FROM network_members WHERE network_id = ?1", [NET]); } catch {}
27
+ try { db.run("DELETE FROM networks WHERE network_id = ?1", [NET]); } catch {}
28
+ try { db.run("DELETE FROM users WHERE user_id = ?1", [USER]); } catch {}
29
+ }
30
+
31
+ function seed() {
32
+ db.run("INSERT INTO users (user_id, username, password_hash, role, created_at) VALUES (?1, ?1, 'x', 'user', datetime('now'))", [USER]);
33
+ db.run("INSERT INTO networks (network_id, network_name, owner_id, created_at) VALUES (?1, ?1, ?2, datetime('now'))", [NET, USER]);
34
+ db.run("INSERT INTO network_members (user_id, network_id, role, joined_at) VALUES (?1, ?2, 'owner', datetime('now'))", [USER, NET]);
35
+ for (const [alias, nodeId] of [[A, A_ID], [B, B_ID]] as const) {
36
+ db.run(
37
+ "INSERT INTO nodes (node_id, node_name, alias, network_id, hostname, config_snapshot, created_at, updated_at, lifecycle_state) VALUES (?1, ?2, ?2, ?3, 'host', ?4, datetime('now'), datetime('now'), 'active')",
38
+ [nodeId, alias, NET, JSON.stringify({ peer_reply_inbox_capable: true })],
39
+ );
40
+ db.run(
41
+ "INSERT INTO sessions (resume_id, alias, status, node_id, network_id, peer_reply_inbox_capable, updated_at, last_seen_at) VALUES (?1, ?2, 'idle', ?3, ?4, 1, datetime('now'), datetime('now'))",
42
+ [`resume-${alias}`, alias, nodeId, NET],
43
+ );
44
+ createSSEStream(alias, NET);
45
+ db.run(
46
+ "INSERT INTO api_tokens (token_id, token_hash, user_id, network_id, name, scope, bound_node_id) VALUES (?1, ?2, ?3, ?4, ?5, 'network', ?6)",
47
+ [`token-${alias}`, `hash-token-${alias}`, USER, NET, `node:${alias}`, nodeId],
48
+ );
49
+ }
50
+ }
51
+
52
+ function toolsFor(alias: string): Record<string, ToolHandler> {
53
+ const server = new McpServer({ name: "peer-reply-698", version: "0" }) as any;
54
+ const tools: Record<string, ToolHandler> = {};
55
+ const original = server.tool.bind(server);
56
+ server.tool = (name: string, description: string, schema: any, handler: ToolHandler) => {
57
+ tools[name] = handler;
58
+ return original(name, description, schema, handler);
59
+ };
60
+ registerTools(server, undefined, NET, USER, alias, true, `token-${alias}`);
61
+ return tools;
62
+ }
63
+
64
+ async function call(handler: ToolHandler, args: any) {
65
+ const result = await handler(args);
66
+ return JSON.parse(result.content[0].text);
67
+ }
68
+
69
+ async function callOrThrow(handler: ToolHandler, args: any) {
70
+ const payload = await call(handler, args);
71
+ if (payload?.ok === false) {
72
+ throw new CommHubError(`app-level rejection: ${payload.error}`, {
73
+ code: payload.error,
74
+ payload,
75
+ appLevel: true,
76
+ });
77
+ }
78
+ return payload;
79
+ }
80
+
81
+ async function dispatch(from: string, to: string, content: string): Promise<string> {
82
+ const sent = await call(toolsFor(from).send_task, { alias: to, task: content, priority: "normal" });
83
+ expect(sent.ok).toBe(true);
84
+ return sent.task_id ?? sent.message_id;
85
+ }
86
+
87
+ function task(taskId: string) {
88
+ return db.get<any>("SELECT * FROM tasks WHERE task_id = ?1", taskId);
89
+ }
90
+
91
+ function replies(taskId: string) {
92
+ return db.all<any>("SELECT * FROM inbox WHERE in_reply_to = ?1 ORDER BY rowid", taskId);
93
+ }
94
+
95
+ function bindScheduledRun(taskId: string): { runId: string; scheduleId: string } {
96
+ const suffix = crypto.randomUUID();
97
+ const runId = `srun_${suffix}`;
98
+ const scheduleId = `sched_${suffix}`;
99
+ db.run(
100
+ `INSERT INTO scheduled_tasks
101
+ (schedule_id, network_id, name, target_node_id, target_alias, task_content, priority,
102
+ schedule_type, schedule_json, timezone, status, next_run_at)
103
+ VALUES (?1, ?2, 'peer reply schedule', ?3, ?4, 'scheduled peer task', 'normal',
104
+ 'interval', '{"type":"interval","every_seconds":3600}', 'UTC', 'active', datetime('now', '+1 hour'))`,
105
+ [scheduleId, NET, B_ID, B],
106
+ );
107
+ db.run(
108
+ `INSERT INTO scheduled_task_runs
109
+ (run_id, schedule_id, network_id, scheduled_for, task_id, status, completed_at)
110
+ VALUES (?1, ?2, ?3, datetime('now'), ?4, 'delivered', NULL)`,
111
+ [runId, scheduleId, NET, taskId],
112
+ );
113
+ return { runId, scheduleId };
114
+ }
115
+
116
+ beforeEach(() => { cleanup(); seed(); });
117
+ afterAll(cleanup);
118
+
119
+ describe("#698 atomic peer reply", () => {
120
+ test("exact bound token works even when sessions.node_id is NULL", async () => {
121
+ const taskId = await dispatch(A, B, "session row is not identity");
122
+ db.run("UPDATE sessions SET node_id = NULL WHERE alias = ?1 AND network_id = ?2", [B, NET]);
123
+ const result = await call(toolsFor(B).send_peer_reply, {
124
+ alias: A, text: "bound-token wins", in_reply_to: taskId, status: "replied",
125
+ });
126
+ // 2026-10-31 —— #3275:send_peer_reply 的形状(此前只断言 ok)。
127
+ // 三键各有用处:message_id 是这条回复的收据;session_status 让调用方不必再查一次
128
+ // 「我这边的会话现在是什么状态」——原子性就体现在这里:回复落库与会话状态是同一次写。
129
+ expect(Object.keys(result).sort()).toEqual(["message_id", "ok", "session_status"]);
130
+ expect(result.session_status).toBe("idle");
131
+ expect(result.ok).toBe(true);
132
+ expect(task(taskId).status).toBe("replied");
133
+ });
134
+
135
+ test("a rollback heartbeat clears the current-session capability before any peer write", async () => {
136
+ const tools = toolsFor(A);
137
+ await call(tools.report_status, {
138
+ resume_id: `resume-${A}`, alias: A, status: "idle", node_id: A_ID,
139
+ config_snapshot: { config_update_capable: true, peer_reply_inbox_capable: true },
140
+ });
141
+ expect(db.get<any>(
142
+ "SELECT peer_reply_inbox_capable FROM sessions WHERE alias = ?1 AND network_id = ?2",
143
+ A, NET,
144
+ ).peer_reply_inbox_capable).toBe(1);
145
+ await call(tools.report_status, {
146
+ resume_id: `resume-${A}`, alias: A, status: "idle", node_id: A_ID,
147
+ config_snapshot: { config_update_capable: true },
148
+ });
149
+ expect(db.get<any>(
150
+ "SELECT peer_reply_inbox_capable FROM sessions WHERE alias = ?1 AND network_id = ?2",
151
+ A, NET,
152
+ ).peer_reply_inbox_capable).toBe(0);
153
+
154
+ const taskId = await dispatch(A, B, "recipient rolled back");
155
+ const result = await call(toolsFor(B).send_peer_reply, {
156
+ alias: A, text: "must use legacy", in_reply_to: taskId, status: "replied",
157
+ });
158
+ expect(result).toEqual(expect.objectContaining({ ok: false, error: "peer_reply_unsupported" }));
159
+ expect(task(taskId).status).toBe("delivered");
160
+ expect(replies(taskId)).toHaveLength(0);
161
+ });
162
+
163
+ test("a capable but disconnected recipient commits atomically for reconnect drain", async () => {
164
+ const taskId = await dispatch(A, B, "recipient disconnected");
165
+ __resetSSEClientsForTest();
166
+ const result = await call(toolsFor(B).send_peer_reply, {
167
+ alias: A, text: "stored for reconnect", in_reply_to: taskId, status: "replied",
168
+ });
169
+ expect(result).toEqual(expect.objectContaining({ ok: true }));
170
+ expect(task(taskId)).toEqual(expect.objectContaining({ status: "replied", result: "stored for reconnect" }));
171
+ expect(replies(taskId)).toHaveLength(1);
172
+ });
173
+
174
+ test("recipient capability is bound to the exact canonical alias, not another session on the same node", async () => {
175
+ const taskId = await dispatch(A, B, "same node must not lend capability across aliases");
176
+ db.run(
177
+ "UPDATE sessions SET peer_reply_inbox_capable = 0 WHERE alias = ?1 AND network_id = ?2",
178
+ [A, NET],
179
+ );
180
+ db.run(
181
+ `INSERT INTO sessions
182
+ (resume_id, alias, status, node_id, network_id, peer_reply_inbox_capable, updated_at, last_seen_at)
183
+ VALUES ('resume-wrong-alias-698', 'wrong-alias-698', 'idle', ?1, ?2, 1,
184
+ datetime('now', '+1 minute'), datetime('now', '+1 minute'))`,
185
+ [A_ID, NET],
186
+ );
187
+ const result = await call(toolsFor(B).send_peer_reply, {
188
+ alias: A, text: "must not borrow wrong alias capability", in_reply_to: taskId, status: "replied",
189
+ });
190
+ expect(result).toEqual(expect.objectContaining({ ok: false, error: "peer_reply_unsupported" }));
191
+ expect(task(taskId)).toEqual(expect.objectContaining({ status: "delivered", result: null }));
192
+ expect(replies(taskId)).toHaveLength(0);
193
+ });
194
+
195
+ test("origin rename during work routes the terminal reply to the canonical alias and stable node", async () => {
196
+ const taskId = await dispatch(A, B, "origin will rename");
197
+ const renamed = `${A}-renamed`;
198
+ db.run(
199
+ `INSERT INTO rename_txn (txn_id, network_id, old_alias, new_alias, status, committed_at)
200
+ VALUES (?1, ?2, ?3, ?4, 'committed', datetime('now'))`,
201
+ [`rtxn-${crypto.randomUUID()}`, NET, A, renamed],
202
+ );
203
+ db.run("UPDATE nodes SET alias = ?1 WHERE node_id = ?2 AND network_id = ?3", [renamed, A_ID, NET]);
204
+ db.run("UPDATE sessions SET alias = ?1 WHERE node_id = ?2 AND network_id = ?3", [renamed, A_ID, NET]);
205
+ eventBus.emit("rename-committed", {
206
+ networkId: NET, old_alias: A, new_alias: renamed, node_id: A_ID,
207
+ });
208
+ const result = await call(toolsFor(B).send_peer_reply, {
209
+ alias: A, text: "reply after rename", in_reply_to: taskId, status: "replied",
210
+ });
211
+ expect(result.ok).toBe(true);
212
+ expect(task(taskId).status).toBe("replied");
213
+ expect(replies(taskId)).toEqual([
214
+ expect.objectContaining({ session_name: renamed, node_id: A_ID, requires_response: "none" }),
215
+ ]);
216
+ });
217
+
218
+ test("legacy caller or recipient capability downgrade returns unsupported with zero writes", async () => {
219
+ for (const mode of ["caller-unbound", "recipient-downgraded", "legacy-task-origin"] as const) {
220
+ cleanup(); seed();
221
+ const taskId = await dispatch(A, B, `compat-${mode}`);
222
+ if (mode === "caller-unbound") {
223
+ db.run("UPDATE api_tokens SET bound_node_id = NULL WHERE token_id = ?1", `token-${B}`);
224
+ } else if (mode === "recipient-downgraded") {
225
+ db.run("UPDATE sessions SET peer_reply_inbox_capable = 0 WHERE node_id = ?1 AND network_id = ?2", [A_ID, NET]);
226
+ } else {
227
+ db.run("UPDATE tasks SET from_node_id = NULL WHERE task_id = ?1", taskId);
228
+ }
229
+ const result = await call(toolsFor(B).send_peer_reply, {
230
+ alias: A, text: "must fall back", in_reply_to: taskId, status: "replied",
231
+ });
232
+ expect(result).toEqual(expect.objectContaining({
233
+ ok: false,
234
+ error: mode === "legacy-task-origin" ? "peer_reply_origin_not_node" : "peer_reply_unsupported",
235
+ reply_queued: false,
236
+ }));
237
+ expect(task(taskId)).toEqual(expect.objectContaining({ status: "delivered", result: null }));
238
+ expect(replies(taskId)).toHaveLength(0);
239
+ }
240
+ });
241
+
242
+ test("old Hub or legacy recipient falls back once and terminalizes the original", async () => {
243
+ for (const mode of ["old-hub", "legacy-recipient"] as const) {
244
+ cleanup(); seed();
245
+ const taskId = await dispatch(A, B, `mixed-${mode}`);
246
+ if (mode === "legacy-recipient") {
247
+ db.run("UPDATE sessions SET peer_reply_inbox_capable = 0 WHERE node_id = ?1 AND network_id = ?2", [A_ID, NET]);
248
+ }
249
+ const tools = toolsFor(B);
250
+ let atomicCalls = 0;
251
+ let legacyReplyCalls = 0;
252
+ const routed = await sendPeerReplyCompatible({
253
+ target: A, text: `fallback-${mode}`, taskId, failed: false, fromAlias: B,
254
+ }, {
255
+ sendAtomic: async (args) => {
256
+ atomicCalls++;
257
+ if (mode === "old-hub") {
258
+ throw new CommHubError("JSON-RPC error: -32601: unknown tool send_peer_reply", { code: -32601 });
259
+ }
260
+ return callOrThrow(tools.send_peer_reply, {
261
+ alias: args.target, text: args.text, in_reply_to: args.taskId, status: "replied",
262
+ });
263
+ },
264
+ sendLegacyReply: async (args) => {
265
+ legacyReplyCalls++;
266
+ return callOrThrow(tools.send_reply, {
267
+ alias: args.target, text: args.text, in_reply_to: args.taskId, status: "replied",
268
+ });
269
+ },
270
+ });
271
+ expect(routed.route).toBe("legacy-reply");
272
+ expect([atomicCalls, legacyReplyCalls]).toEqual([1, 1]);
273
+ expect(task(taskId)).toEqual(expect.objectContaining({ status: "replied", result: `fallback-${mode}` }));
274
+ expect(replies(taskId)).toHaveLength(1);
275
+ expect(db.get<{ n: number }>(
276
+ "SELECT COUNT(*) AS n FROM tasks WHERE parent_task_id = ?1 AND requires_response = 'reply'",
277
+ taskId,
278
+ )?.n).toBe(0);
279
+ }
280
+ });
281
+
282
+ test("node-id rotation falls back to alias-bound terminal send_reply", async () => {
283
+ const taskId = await dispatch(A, B, "rotate B after dispatch");
284
+ const rotatedNodeId = `${B_ID}-rotated`;
285
+ db.run(
286
+ "INSERT INTO nodes (node_id, node_name, alias, network_id, hostname, config_snapshot, created_at, updated_at, lifecycle_state) VALUES (?1, ?2, ?2, ?3, 'host-rotated', ?4, datetime('now'), datetime('now'), 'active')",
287
+ [rotatedNodeId, B, NET, JSON.stringify({ peer_reply_inbox_capable: true })],
288
+ );
289
+ db.run("UPDATE api_tokens SET bound_node_id = ?1 WHERE token_id = ?2", [rotatedNodeId, `token-${B}`]);
290
+ db.run("UPDATE sessions SET node_id = ?1 WHERE alias = ?2 AND network_id = ?3", [rotatedNodeId, B, NET]);
291
+
292
+ const tools = toolsFor(B);
293
+ let atomicCalls = 0;
294
+ let legacyReplyCalls = 0;
295
+ const routed = await sendPeerReplyCompatible({
296
+ target: A, text: "result after identity rotation", taskId, failed: false, fromAlias: B,
297
+ }, {
298
+ sendAtomic: async (args) => {
299
+ atomicCalls++;
300
+ return callOrThrow(tools.send_peer_reply, {
301
+ alias: args.target, text: args.text, in_reply_to: args.taskId, status: "replied",
302
+ });
303
+ },
304
+ sendLegacyReply: async (args) => {
305
+ legacyReplyCalls++;
306
+ return callOrThrow(tools.send_reply, {
307
+ alias: args.target, text: args.text, in_reply_to: args.taskId, status: "replied",
308
+ });
309
+ },
310
+ });
311
+
312
+ expect(routed.route).toBe("legacy-reply");
313
+ expect([atomicCalls, legacyReplyCalls]).toEqual([1, 1]);
314
+ expect(task(taskId)).toEqual(expect.objectContaining({ status: "replied", result: "result after identity rotation" }));
315
+ expect(replies(taskId)).toHaveLength(1);
316
+ expect(db.get<{ n: number }>("SELECT COUNT(*) AS n FROM tasks WHERE parent_task_id = ?1", taskId)?.n).toBe(0);
317
+ });
318
+
319
+ test("compatibility send_reply cannot terminalize another node's task or target a third party", async () => {
320
+ const taskId = await dispatch(A, B, "compatibility ownership boundary");
321
+
322
+ const foreign = await call(toolsFor(A).send_reply, {
323
+ alias: A, text: "foreign close attempt", in_reply_to: taskId, status: "replied",
324
+ });
325
+ expect(foreign).toEqual(expect.objectContaining({ ok: false, error: "reply_task_not_owned" }));
326
+ expect(task(taskId)).toEqual(expect.objectContaining({ status: "delivered", result: null }));
327
+ expect(replies(taskId)).toHaveLength(0);
328
+
329
+ const wrongTarget = await call(toolsFor(B).send_reply, {
330
+ alias: B, text: "wrong target attempt", in_reply_to: taskId, status: "replied",
331
+ });
332
+ expect(wrongTarget).toEqual(expect.objectContaining({ ok: false, error: "reply_target_mismatch" }));
333
+ expect(task(taskId)).toEqual(expect.objectContaining({ status: "delivered", result: null }));
334
+ expect(replies(taskId)).toHaveLength(0);
335
+
336
+ const valid = await call(toolsFor(B).send_reply, {
337
+ alias: A, text: "valid compatibility close", in_reply_to: taskId, status: "replied",
338
+ });
339
+ expect(valid.ok).toBe(true);
340
+ expect(task(taskId)).toEqual(expect.objectContaining({ status: "replied", result: "valid compatibility close" }));
341
+ expect(replies(taskId)).toHaveLength(1);
342
+ });
343
+
344
+ test("owner node terminalizes exact original and emits one no-response reply without a task row", async () => {
345
+ const taskId = await dispatch(A, B, "do work");
346
+ const result = await call(toolsFor(B).send_peer_reply, {
347
+ alias: A,
348
+ text: "done exactly once",
349
+ in_reply_to: taskId,
350
+ status: "replied",
351
+ });
352
+ expect(result.ok).toBe(true);
353
+ expect(task(taskId)).toEqual(expect.objectContaining({ status: "replied", result: "done exactly once" }));
354
+ expect(task(taskId).completed_at).toBeTruthy();
355
+ expect(replies(taskId)).toHaveLength(1);
356
+ expect(replies(taskId)[0]).toEqual(expect.objectContaining({
357
+ session_name: A,
358
+ node_id: A_ID,
359
+ type: "reply",
360
+ requires_response: "none",
361
+ content: "done exactly once",
362
+ }));
363
+ expect(db.get<{ n: number }>("SELECT COUNT(*) AS n FROM tasks WHERE parent_task_id = ?1", taskId)?.n).toBe(0);
364
+ });
365
+
366
+ // #3259 收口 —— 迟到通道只对「终态但没成功交付过回复」的任务开放;
367
+ // `replied` 的任务再补就是重复投递,仍然必须以 reply_task_terminal 拒绝。
368
+ test("terminal replay is rejected and cannot deliver twice", async () => {
369
+ const taskId = await dispatch(A, B, "idempotent work");
370
+ const handler = toolsFor(B).send_peer_reply;
371
+ expect((await call(handler, { alias: A, text: "first", in_reply_to: taskId, status: "replied" })).ok).toBe(true);
372
+ const replay = await call(handler, { alias: A, text: "second", in_reply_to: taskId, status: "replied" });
373
+ expect(replay).toEqual(expect.objectContaining({ ok: false, error: "reply_task_terminal", reply_queued: false }));
374
+ expect(task(taskId).result).toBe("first");
375
+ expect(replies(taskId)).toHaveLength(1);
376
+ });
377
+
378
+ test("all declared peer reply outcomes become exact terminal task states", async () => {
379
+ for (const status of ["replied", "failed", "cancelled"] as const) {
380
+ const taskId = await dispatch(A, B, `terminal-${status}`);
381
+ const result = await call(toolsFor(B).send_peer_reply, {
382
+ alias: A,
383
+ text: `result-${status}`,
384
+ in_reply_to: taskId,
385
+ status,
386
+ });
387
+ expect(result.ok).toBe(true);
388
+ expect(task(taskId)).toEqual(expect.objectContaining({
389
+ status,
390
+ result: `result-${status}`,
391
+ }));
392
+ expect(task(taskId).completed_at).toBeTruthy();
393
+ expect(replies(taskId)).toHaveLength(1);
394
+ expect(replies(taskId)[0].requires_response).toBe("none");
395
+ }
396
+ });
397
+
398
+ test("foreign node and wrong origin target are rejected with zero writes", async () => {
399
+ const taskId = await dispatch(A, B, "owned by B");
400
+ const foreign = await call(toolsFor(A).send_peer_reply, { alias: A, text: "forge", in_reply_to: taskId, status: "replied" });
401
+ expect(foreign).toEqual(expect.objectContaining({ ok: false, error: "reply_task_not_owned" }));
402
+ const wrongTarget = await call(toolsFor(B).send_peer_reply, { alias: B, text: "misroute", in_reply_to: taskId, status: "replied" });
403
+ expect(wrongTarget).toEqual(expect.objectContaining({ ok: false, error: "reply_target_mismatch" }));
404
+ expect(task(taskId).status).toBe("delivered");
405
+ expect(replies(taskId)).toHaveLength(0);
406
+ });
407
+
408
+ test("task update failure rolls back the reply inbox insert", async () => {
409
+ const taskId = await dispatch(A, B, "atomic failure");
410
+ db.exec(`CREATE TRIGGER test698_abort_terminal BEFORE UPDATE OF status ON tasks
411
+ WHEN OLD.task_id = '${taskId}' BEGIN SELECT RAISE(ABORT, 'test698 injected'); END`);
412
+ await expect(call(toolsFor(B).send_peer_reply, {
413
+ alias: A,
414
+ text: "must rollback",
415
+ in_reply_to: taskId,
416
+ status: "replied",
417
+ })).rejects.toThrow("test698 injected");
418
+ expect(task(taskId).status).toBe("delivered");
419
+ expect(task(taskId).result).toBeNull();
420
+ expect(replies(taskId)).toHaveLength(0);
421
+ });
422
+
423
+ test("node-token peer reply terminalizes the exact scheduled run in the same transaction", async () => {
424
+ const taskId = await dispatch(A, B, "scheduled work");
425
+ const { runId } = bindScheduledRun(taskId);
426
+ const result = await call(toolsFor(B).send_peer_reply, {
427
+ alias: A, text: "scheduled done", in_reply_to: taskId, status: "replied",
428
+ });
429
+ expect(result.ok).toBe(true);
430
+ expect(task(taskId).status).toBe("replied");
431
+ expect(db.get<any>("SELECT status, completed_at FROM scheduled_task_runs WHERE run_id = ?1", runId))
432
+ .toEqual(expect.objectContaining({ status: "replied" }));
433
+ });
434
+
435
+ test("scheduled-run write failure rolls back task and reply inbox together", async () => {
436
+ const taskId = await dispatch(A, B, "scheduled rollback");
437
+ const { runId } = bindScheduledRun(taskId);
438
+ db.exec(`CREATE TRIGGER test698_abort_run BEFORE UPDATE OF status ON scheduled_task_runs
439
+ WHEN OLD.run_id = '${runId}' BEGIN SELECT RAISE(ABORT, 'test698 injected run'); END`);
440
+ await expect(call(toolsFor(B).send_peer_reply, {
441
+ alias: A, text: "must all roll back", in_reply_to: taskId, status: "replied",
442
+ })).rejects.toThrow("test698 injected run");
443
+ expect(task(taskId).status).toBe("delivered");
444
+ expect(db.get<any>("SELECT status FROM scheduled_task_runs WHERE run_id = ?1", runId)?.status).toBe("delivered");
445
+ expect(replies(taskId)).toHaveLength(0);
446
+ });
447
+
448
+ test("three exchanges leave only dispatched work rows and no open tasks", async () => {
449
+ for (let i = 0; i < 3; i++) {
450
+ const taskId = await dispatch(A, B, `work-${i}`);
451
+ expect((await call(toolsFor(B).send_peer_reply, {
452
+ alias: A,
453
+ text: `result-${i}`,
454
+ in_reply_to: taskId,
455
+ status: "replied",
456
+ })).ok).toBe(true);
457
+ }
458
+ expect(db.get<{ n: number }>("SELECT COUNT(*) AS n FROM tasks WHERE network_id = ?1", NET)?.n).toBe(3);
459
+ expect(db.get<{ n: number }>("SELECT COUNT(*) AS n FROM tasks WHERE network_id = ?1 AND status IN ('created','delivered','acked','running')", NET)?.n).toBe(0);
460
+ expect(db.get<{ n: number }>("SELECT COUNT(*) AS n FROM inbox WHERE network_id = ?1 AND type = 'reply' AND requires_response = 'none'", NET)?.n).toBe(3);
461
+ });
462
+ });
@@ -0,0 +1,70 @@
1
+ import { beforeEach, describe, expect, test } from "bun:test";
2
+ import { db } from "./db.js";
3
+ import { trustedConfigSnapshotForNode, upsertNodeWithSec1Guard } from "./tools.js";
4
+
5
+ const NET = "net_peer_cap_698";
6
+ const USER = "user_peer_cap_698";
7
+
8
+ function seedToken(tokenId: string, nodeId: string | null) {
9
+ db.run(
10
+ "INSERT OR IGNORE INTO users (user_id, username, password_hash, role, created_at) VALUES (?1, ?2, 'x', 'user', datetime('now'))",
11
+ [USER, USER],
12
+ );
13
+ db.run(
14
+ "INSERT OR IGNORE INTO networks (network_id, network_name, owner_id, created_at) VALUES (?1, ?2, ?3, datetime('now'))",
15
+ [NET, NET, USER],
16
+ );
17
+ db.run(
18
+ `INSERT INTO api_tokens (token_id, token_hash, user_id, network_id, name, scope, bound_node_id)
19
+ VALUES (?1, ?2, ?3, ?4, ?5, 'network', ?6)`,
20
+ [tokenId, `hash_${tokenId}`, USER, NET, `node:${tokenId}`, nodeId],
21
+ );
22
+ }
23
+
24
+ beforeEach(() => {
25
+ db.run("DELETE FROM nodes WHERE network_id = ?1", NET);
26
+ db.run("DELETE FROM api_tokens WHERE network_id = ?1", NET);
27
+ });
28
+
29
+ describe("peer reply inbox capability provenance", () => {
30
+ test("exact token-bound node retains the capability", () => {
31
+ seedToken("tok_cap_exact", "node_cap_exact");
32
+ const snapshot = trustedConfigSnapshotForNode(
33
+ { model: "m", peer_reply_inbox_capable: true },
34
+ "tok_cap_exact",
35
+ "node_cap_exact",
36
+ ) as any;
37
+ expect(snapshot.peer_reply_inbox_capable).toBe(true);
38
+ });
39
+
40
+ test("legacy unbound and wrong-node tokens cannot advertise it", () => {
41
+ seedToken("tok_cap_legacy", null);
42
+ seedToken("tok_cap_wrong", "node_other");
43
+ for (const tokenId of ["tok_cap_legacy", "tok_cap_wrong", null]) {
44
+ const snapshot = trustedConfigSnapshotForNode(
45
+ { model: "m", peer_reply_inbox_capable: true },
46
+ tokenId,
47
+ "node_target",
48
+ ) as any;
49
+ expect(snapshot.peer_reply_inbox_capable).toBeUndefined();
50
+ expect(snapshot.model).toBe("m");
51
+ }
52
+ });
53
+
54
+ test("stored node snapshot is stripped for an unbound legacy token", () => {
55
+ seedToken("tok_cap_store_legacy", null);
56
+ expect(upsertNodeWithSec1Guard({
57
+ node_id: "node_cap_store_legacy",
58
+ callerNetworkId: NET,
59
+ callerUserId: USER,
60
+ callerTokenId: "tok_cap_store_legacy",
61
+ alias: "legacy-cap-node",
62
+ config_snapshot: { peer_reply_inbox_capable: true, model: "m" },
63
+ }).result).toBe("inserted");
64
+ const row = db.get<{ config_snapshot: string }>(
65
+ "SELECT config_snapshot FROM nodes WHERE node_id = ?1",
66
+ "node_cap_store_legacy",
67
+ );
68
+ expect(JSON.parse(row!.config_snapshot).peer_reply_inbox_capable).toBeUndefined();
69
+ });
70
+ });