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

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
Files changed (482) hide show
  1. package/README.md +120 -3
  2. package/bin/commhub.ts +93 -9
  3. package/build-info.json +7 -0
  4. package/package.json +10 -8
  5. package/src/ack-create-request-transport.test.ts +182 -0
  6. package/src/ack-create-request.test.ts +52 -8
  7. package/src/admin-delete-network-http.test.ts +229 -0
  8. package/src/admin-networks-http.test.ts +88 -0
  9. package/src/adoption-candidates-http.test.ts +140 -0
  10. package/src/adoption-candidates.ts +158 -0
  11. package/src/agent-access-batch.test.ts +215 -0
  12. package/src/agent-access.ts +585 -0
  13. package/src/agent-acl-groups-http.test.ts +247 -0
  14. package/src/agent-acl-http.test.ts +691 -0
  15. package/src/agent-acl-slice3-http.test.ts +888 -0
  16. package/src/agent-department-grants.test.ts +129 -0
  17. package/src/agent-department-http.test.ts +215 -0
  18. package/src/agent-groups-perf.test.ts +228 -0
  19. package/src/agent-notice.ts +48 -0
  20. package/src/agent-team-whoami-http.test.ts +98 -0
  21. package/src/agent-teams-http.test.ts +330 -0
  22. package/src/agent-teams.ts +244 -0
  23. package/src/alias-baseline-2571.test.ts +162 -0
  24. package/src/alias-baseline.ts +113 -0
  25. package/src/alias-filter.test.ts +72 -0
  26. package/src/alias-filter.ts +42 -0
  27. package/src/all-status-cache.test.ts +31 -0
  28. package/src/all-status-cache.ts +37 -0
  29. package/src/anet-variant-real-daemon-http.test.ts +185 -0
  30. package/src/api-host-supervisors-can-create-nodes.test.ts +350 -0
  31. package/src/api-host-supervisors-fallback.test.ts +6 -7
  32. package/src/api-host-supervisors-runtime-readiness.test.ts +195 -0
  33. package/src/api-nodes-shape.test.ts +131 -4
  34. package/src/auth-abuse-counters.test.ts +144 -0
  35. package/src/auth-abuse-counters.ts +122 -0
  36. package/src/auth-layer-shape.test.ts +105 -0
  37. package/src/auth-password-change-cli-tokens-http.test.ts +423 -0
  38. package/src/auth-sessions-http.test.ts +260 -0
  39. package/src/auth-validate.test.ts +5 -1
  40. package/src/auth-weak-password-login.test.ts +176 -0
  41. package/src/auth.ts +641 -68
  42. package/src/backfill-node-ids-2664.test.ts +128 -0
  43. package/src/binding-generation-http.test.ts +141 -0
  44. package/src/blocked-exit-on-reply.test.ts +122 -0
  45. package/src/broadcast-fanout-2721.test.ts +149 -0
  46. package/src/broadcast-fanout.ts +117 -0
  47. package/src/build-commit-report-http.test.ts +219 -0
  48. package/src/build-info.test.ts +60 -0
  49. package/src/build-info.ts +85 -0
  50. package/src/chain-attempt-dedup.test.ts +447 -0
  51. package/src/clip.test.ts +36 -0
  52. package/src/clip.ts +48 -0
  53. package/src/clone-node.test.ts +269 -0
  54. package/src/clone-node.ts +289 -0
  55. package/src/codex-config-flags.ts +77 -0
  56. package/src/codex-fork-contract.ts +23 -0
  57. package/src/codex-fork-migration.test.ts +38 -0
  58. package/src/commhub-bin-args.test.ts +85 -0
  59. package/src/config-apply-sec1.test.ts +37 -0
  60. package/src/config-apply-validate.test.ts +188 -1
  61. package/src/config-apply-validate.ts +226 -3
  62. package/src/contracts/session-project-create.ts +14 -0
  63. package/src/contracts/session-source-delivery.ts +16 -0
  64. package/src/contracts/session-source-directory.ts +54 -0
  65. package/src/contracts/session-source-evidence.ts +72 -0
  66. package/src/contracts/session-source-execution.ts +24 -0
  67. package/src/contracts/session-source-transport.ts +18 -0
  68. package/src/cors-origins.test.ts +73 -0
  69. package/src/create-node-blocked-gate.test.ts +365 -0
  70. package/src/create-node-error-domain.test.ts +127 -0
  71. package/src/create-node-network-id.test.ts +91 -0
  72. package/src/create-node-tool-schema.test.ts +59 -0
  73. package/src/create-node-unicode-name.test.ts +126 -0
  74. package/src/create-node-validate.test.ts +199 -7
  75. package/src/create-node-validate.ts +232 -15
  76. package/src/create-node-workdir.test.ts +298 -0
  77. package/src/create-node.ts +88 -23
  78. package/src/daemon-provider-snapshots.test.ts +453 -0
  79. package/src/daemon-provider-snapshots.ts +327 -0
  80. package/src/daemon-token-owner-http.test.ts +346 -0
  81. package/src/dashboard-slash-routing-http.test.ts +109 -0
  82. package/src/db-adapter-guard.test.ts +148 -0
  83. package/src/db-adapter-translate.test.ts +128 -0
  84. package/src/db-adapter.ts +377 -91
  85. package/src/db-timestamp.test.ts +38 -0
  86. package/src/db-timestamp.ts +15 -0
  87. package/src/db.ts +1334 -154
  88. package/src/delivered-without-push.test.ts +140 -0
  89. package/src/department-groups-http.test.ts +209 -0
  90. package/src/department-groups-sync-http.test.ts +328 -0
  91. package/src/department-groups.ts +434 -0
  92. package/src/department-heads-http.test.ts +350 -0
  93. package/src/department-heads.ts +226 -0
  94. package/src/departments-agent-count.test.ts +139 -0
  95. package/src/departments-http.test.ts +185 -0
  96. package/src/departments-mcp-error-domain.test.ts +135 -0
  97. package/src/departments-mcp.test.ts +128 -0
  98. package/src/departments.ts +318 -0
  99. package/src/desktop-message-seam.test.ts +150 -0
  100. package/src/desktop-message.test.ts +368 -0
  101. package/src/dm-file-scope-http.test.ts +227 -0
  102. package/src/empty-node-sweeper.test.ts +104 -0
  103. package/src/empty-node-sweeper.ts +88 -0
  104. package/src/env-transport-gate-http.test.ts +240 -0
  105. package/src/env-transport-gate.ts +80 -0
  106. package/src/env-transport-policy.ts +56 -0
  107. package/src/etag-of.test.ts +57 -0
  108. package/src/event-loop-lag.test.ts +180 -0
  109. package/src/event-loop-lag.ts +201 -0
  110. package/src/expiry-counters.test.ts +187 -0
  111. package/src/expiry-counters.ts +227 -0
  112. package/src/expiry-evidence-db.test.ts +103 -0
  113. package/src/ext-token-shared.test.ts +60 -0
  114. package/src/ext-validation-regression.test.ts +10 -17
  115. package/src/external-schedule-edits-http.test.ts +321 -0
  116. package/src/external-schedule-edits-timestamps.test.ts +64 -0
  117. package/src/external-schedule-edits.ts +327 -0
  118. package/src/file-download-authz-dev-open.test.ts +1 -1
  119. package/src/file-download-authz.test.ts +25 -4
  120. package/src/file-download-date-bucket.test.ts +1 -1
  121. package/src/file-network-scope-dev-open.test.ts +1 -1
  122. package/src/file-network-scope.test.ts +7 -6
  123. package/src/group-membership-events-http.test.ts +264 -0
  124. package/src/group-messages-http.test.ts +483 -0
  125. package/src/group-messages.ts +297 -0
  126. package/src/health-anon-readers.ts +67 -0
  127. package/src/health-host-disk-2756.test.ts +71 -0
  128. package/src/health-identity-root.test.ts +98 -0
  129. package/src/health-redaction.test.ts +1603 -7
  130. package/src/health-status-reasons.test.ts +84 -0
  131. package/src/host-supervisor-identity-http.test.ts +152 -0
  132. package/src/host-supervisor-identity.ts +92 -0
  133. package/src/host-supervisors-daemon-version.test.ts +137 -0
  134. package/src/http-gzip.test.ts +94 -0
  135. package/src/http-gzip.ts +112 -0
  136. package/src/hub-catalog-read-http.test.ts +664 -0
  137. package/src/hub-provider-config.test.ts +166 -0
  138. package/src/hub-provider-config.ts +202 -0
  139. package/src/hub-timestamp.test.ts +38 -0
  140. package/src/hub-timestamp.ts +27 -0
  141. package/src/human-dm.ts +215 -0
  142. package/src/human-inbox.ts +42 -0
  143. package/src/inbox-caller.ts +49 -0
  144. package/src/inbox-count-sse.test.ts +318 -0
  145. package/src/inbox-count.ts +29 -0
  146. package/src/index.ts +6 -2
  147. package/src/launched-by-cli-report-http.test.ts +155 -0
  148. package/src/license-state.test.ts +105 -0
  149. package/src/license-state.ts +48 -0
  150. package/src/lifecycle-error-domain.test.ts +149 -0
  151. package/src/list-ack-error-domain.test.ts +108 -0
  152. package/src/list-host-supervisors.test.ts +15 -4
  153. package/src/list-tasks-omit-default.test.ts +84 -0
  154. package/src/list-tasks-since-last.test.ts +100 -0
  155. package/src/list-tasks-since.test.ts +104 -0
  156. package/src/mcp-context-cost-http.test.ts +127 -0
  157. package/src/mcp-inflight.test.ts +92 -0
  158. package/src/mcp-inflight.ts +38 -0
  159. package/src/mcp-projects-events-http.test.ts +168 -0
  160. package/src/mcp-route-label-http.test.ts +120 -0
  161. package/src/mcp-write-network-resolution.test.ts +21 -0
  162. package/src/member-audit-network-id-http.test.ts +93 -0
  163. package/src/member-presence-http.test.ts +210 -0
  164. package/src/messages-ack-by-agent-http.test.ts +142 -0
  165. package/src/migrate-sqlite-to-pg.test.ts +47 -0
  166. package/src/migrate-sqlite-to-pg.ts +263 -0
  167. package/src/model-auth-notify-http.test.ts +181 -0
  168. package/src/model-auth-notify.ts +116 -0
  169. package/src/network-name-http.test.ts +75 -0
  170. package/src/network-quota-config.test.ts +100 -0
  171. package/src/network-rules-http.test.ts +169 -0
  172. package/src/network-rules.ts +129 -0
  173. package/src/network-scope.ts +222 -3
  174. package/src/network-token-membership-http.test.ts +186 -0
  175. package/src/node-alias-control.ts +12 -0
  176. package/src/node-attrs.test.ts +47 -2
  177. package/src/node-caller-identity-http.test.ts +1108 -0
  178. package/src/node-config-last-update.test.ts +126 -0
  179. package/src/node-config-last-update.ts +107 -0
  180. package/src/node-create-request-status-http.test.ts +105 -0
  181. package/src/node-daemon-bindings.test.ts +142 -0
  182. package/src/node-daemon-bindings.ts +135 -0
  183. package/src/node-failure-alert.test.ts +150 -0
  184. package/src/node-failure-alert.ts +177 -0
  185. package/src/node-files-transport.test.ts +350 -0
  186. package/src/node-health-codex-login.test.ts +120 -0
  187. package/src/node-health-dispatch-http.test.ts +373 -0
  188. package/src/node-health-guard-origin.test.ts +98 -0
  189. package/src/node-health-guard.ts +121 -0
  190. package/src/node-health-passthrough.test.ts +115 -0
  191. package/src/node-health-store.ts +101 -0
  192. package/src/node-id-alias.test.ts +190 -0
  193. package/src/node-identity-conflict-http.test.ts +269 -0
  194. package/src/node-identity-conflict.ts +142 -0
  195. package/src/node-identity-mismatch.test.ts +74 -0
  196. package/src/node-in-flight-tasks.ts +31 -0
  197. package/src/node-inbox-allowlist-http.test.ts +320 -0
  198. package/src/node-lifecycle-controllable.test.ts +64 -0
  199. package/src/node-lifecycle-controllable.ts +53 -0
  200. package/src/node-lifecycle-read-http.test.ts +257 -0
  201. package/src/node-lifecycle-read.ts +126 -0
  202. package/src/node-logs-transport.test.ts +266 -0
  203. package/src/node-peer-allowlist.test.ts +114 -0
  204. package/src/node-permissions-http.test.ts +901 -0
  205. package/src/node-permissions.ts +627 -0
  206. package/src/node-request-retention.test.ts +281 -0
  207. package/src/node-request-retention.ts +120 -0
  208. package/src/node-secret-rest-http.test.ts +190 -0
  209. package/src/node-secret-vault-inject.test.ts +132 -0
  210. package/src/node-security-write-gate.test.ts +72 -0
  211. package/src/node-serviceability.test.ts +86 -0
  212. package/src/node-serviceability.ts +124 -0
  213. package/src/node-session-control-http.test.ts +398 -0
  214. package/src/node-session-control.ts +316 -0
  215. package/src/node-skills-transport.test.ts +212 -0
  216. package/src/node-token-identity.ts +35 -0
  217. package/src/node-token-ownership.ts +51 -0
  218. package/src/node-token-privilege-http.test.ts +224 -0
  219. package/src/node-token-usage.test.ts +128 -0
  220. package/src/node-token-usage.ts +228 -0
  221. package/src/not-found-api-http.test.ts +67 -0
  222. package/src/observer-avatar-http.test.ts +103 -10
  223. package/src/observer-push.test.ts +76 -0
  224. package/src/opencode-catalog-report-http.test.ts +139 -0
  225. package/src/opencode-v2-catalog.test.ts +282 -0
  226. package/src/opencode-v2-catalog.ts +357 -0
  227. package/src/package-self-contained.test.ts +32 -0
  228. package/src/package-version-consistency.test.ts +25 -0
  229. package/src/parent-infer.test.ts +82 -0
  230. package/src/parent-infer.ts +110 -0
  231. package/src/parent-source-marker.test.ts +70 -0
  232. package/src/parent-source-orphan.test.ts +121 -0
  233. package/src/password-network-tokens.ts +25 -0
  234. package/src/peer-reply-atomic.test.ts +462 -0
  235. package/src/peer-reply-capability.test.ts +70 -0
  236. package/src/pg-worker.ts +87 -0
  237. package/src/poll-pacing.test.ts +74 -0
  238. package/src/poll-pacing.ts +123 -0
  239. package/src/probe-provider-error-domain.test.ts +145 -0
  240. package/src/project-dir-warn-clear-http.test.ts +132 -0
  241. package/src/project-viewer-can-http.test.ts +116 -0
  242. package/src/provider-skill-error-domain.test.ts +130 -0
  243. package/src/provider-tools-shape.test.ts +165 -0
  244. package/src/push.test.ts +20 -10
  245. package/src/push.ts +373 -9
  246. package/src/redact-tokens.test.ts +86 -0
  247. package/src/redact-tokens.ts +43 -0
  248. package/src/rejection-counters.test.ts +72 -0
  249. package/src/rejection-counters.ts +173 -0
  250. package/src/rename.ts +38 -10
  251. package/src/reply-target-derivation.test.ts +96 -0
  252. package/src/report-status-handover-capabilities-http.test.ts +124 -0
  253. package/src/report-status-host-schema.test.ts +272 -0
  254. package/src/report-status-resume-id-handover.test.ts +184 -0
  255. package/src/report-status-secret-keys.test.ts +140 -0
  256. package/src/require-explicit-test-db.ts +9 -0
  257. package/src/requirement-due-reminders-http.test.ts +620 -0
  258. package/src/requirement-due-reminders.ts +416 -0
  259. package/src/requirement-events-http.test.ts +318 -0
  260. package/src/requirement-events.test.ts +45 -0
  261. package/src/requirement-events.ts +144 -0
  262. package/src/requirement-notify.ts +165 -0
  263. package/src/requirement-participant-notify-http.test.ts +313 -0
  264. package/src/requirement-tag-ops-http.test.ts +454 -0
  265. package/src/requirement-tag-tree-http.test.ts +275 -0
  266. package/src/requirement-tag-tree.ts +127 -0
  267. package/src/requirement-tags.ts +102 -0
  268. package/src/requirements-abandoned-http.test.ts +236 -0
  269. package/src/requirements-assignee-drift.test.ts +154 -0
  270. package/src/requirements-comment-http.test.ts +174 -0
  271. package/src/requirements-completed-at-migration.test.ts +70 -0
  272. package/src/requirements-errors-mcp-http.test.ts +164 -0
  273. package/src/requirements-errors.ts +158 -0
  274. package/src/requirements-etag-http.test.ts +91 -0
  275. package/src/requirements-http.test.ts +709 -0
  276. package/src/requirements-last-event-http.test.ts +349 -0
  277. package/src/requirements-list-mcp-slim-http.test.ts +155 -0
  278. package/src/requirements-list-slim-http.test.ts +324 -0
  279. package/src/requirements-mcp.test.ts +180 -0
  280. package/src/requirements-migrate.ts +283 -0
  281. package/src/requirements-owner-strict-mcp-http.test.ts +145 -0
  282. package/src/requirements-people-http.test.ts +114 -0
  283. package/src/requirements-people-mcp-http.test.ts +231 -0
  284. package/src/requirements-people.ts +196 -0
  285. package/src/requirements-priority-lowest.test.ts +114 -0
  286. package/src/requirements-projects-network-echo.test.ts +57 -0
  287. package/src/requirements-projects-parent-http.test.ts +123 -0
  288. package/src/requirements-search-http.test.ts +182 -0
  289. package/src/requirements-search.test.ts +32 -0
  290. package/src/requirements-search.ts +145 -0
  291. package/src/requirements-seq-http.test.ts +193 -0
  292. package/src/requirements-seq-migration.test.ts +63 -0
  293. package/src/requirements-start-date.test.ts +125 -0
  294. package/src/requirements-stats-http.test.ts +357 -0
  295. package/src/requirements-stats.ts +195 -0
  296. package/src/requirements-status-participants-http.test.ts +222 -0
  297. package/src/requirements-upgrade-e2e.test.ts +126 -0
  298. package/src/requirements-upgrade-migration.test.ts +98 -0
  299. package/src/requirements.ts +2205 -0
  300. package/src/resolve-port.test.ts +57 -0
  301. package/src/resolve-port.ts +44 -0
  302. package/src/rest-alias-network-fallback-http.test.ts +123 -0
  303. package/src/rest-alias-network-fallback.test.ts +60 -0
  304. package/src/rest-alias-network-fallback.ts +65 -0
  305. package/src/rest-explicit-columns-http.test.ts +266 -0
  306. package/src/rest-identity.test.ts +130 -0
  307. package/src/rest-identity.ts +141 -0
  308. package/src/rest-projections.ts +72 -0
  309. package/src/rest-read-network-real-chain.test.ts +97 -0
  310. package/src/rest-write-network-resolution.test.ts +133 -0
  311. package/src/restart-readiness-http.test.ts +121 -0
  312. package/src/restricted-files.ts +76 -0
  313. package/src/retention-first-sweep-quiet.test.ts +31 -0
  314. package/src/retention.test.ts +100 -40
  315. package/src/retention.ts +423 -104
  316. package/src/route-callers-http.test.ts +120 -0
  317. package/src/route-timing.test.ts +218 -0
  318. package/src/route-timing.ts +262 -0
  319. package/src/rules-file-duplicate-alias.test.ts +234 -0
  320. package/src/rules-file-session-target.test.ts +207 -0
  321. package/src/rules-file-transport.test.ts +280 -0
  322. package/src/runtime-label.test.ts +22 -0
  323. package/src/runtime-label.ts +21 -0
  324. package/src/runtime-readiness.ts +90 -0
  325. package/src/schedule-agent-mcp-http.test.ts +486 -0
  326. package/src/schedule-agent.ts +252 -0
  327. package/src/schedule-starved.test.ts +92 -0
  328. package/src/schedule-starved.ts +114 -0
  329. package/src/scheduled-backoff-http.test.ts +203 -0
  330. package/src/scheduled-backoff.ts +64 -0
  331. package/src/scheduled-doorbell-nodeless-session.test.ts +134 -0
  332. package/src/scheduled-failure-backoff-2622.test.ts +145 -0
  333. package/src/scheduled-failure-code.test.ts +73 -0
  334. package/src/scheduled-failure-code.ts +105 -0
  335. package/src/scheduled-failures-http.test.ts +279 -0
  336. package/src/scheduled-failures.ts +425 -0
  337. package/src/scheduled-noprogress-backoff-2622.test.ts +163 -0
  338. package/src/scheduled-offline-backoff-probe.test.ts +56 -0
  339. package/src/scheduled-offline.test.ts +131 -0
  340. package/src/scheduled-offline.ts +66 -0
  341. package/src/scheduled-outcome-guidance-http.test.ts +139 -0
  342. package/src/scheduled-outcome-guidance.ts +9 -0
  343. package/src/scheduled-reply-unread-http.test.ts +212 -0
  344. package/src/scheduled-requirement-wake-http.test.ts +289 -0
  345. package/src/scheduled-requirement-wake.ts +125 -0
  346. package/src/scheduled-run-terminal.test.ts +290 -0
  347. package/src/scheduled-skip-blocking-task.test.ts +120 -0
  348. package/src/scheduled-skip-path-backoff-2622.test.ts +98 -0
  349. package/src/scheduled-stuck-http.test.ts +316 -0
  350. package/src/scheduled-stuck-notice-cap.test.ts +80 -0
  351. package/src/scheduled-stuck.ts +219 -0
  352. package/src/scheduled-tasks-http.test.ts +679 -0
  353. package/src/scheduled-tasks.ts +980 -0
  354. package/src/scheduled-work-outcome-http.test.ts +154 -0
  355. package/src/scheduled-work-outcome.ts +50 -0
  356. package/src/scoped-secrets.ts +167 -0
  357. package/src/secret-echo-negative-control.test.ts +118 -0
  358. package/src/send-dedup-request-id.test.ts +229 -0
  359. package/src/send-reply-agent-warning.test.ts +38 -38
  360. package/src/send-reply-alias-optional.test.ts +131 -0
  361. package/src/send-reply-attachments.test.ts +28 -7
  362. package/src/send_dedup.test.ts +54 -0
  363. package/src/send_dedup.ts +52 -6
  364. package/src/serve-error.test.ts +73 -0
  365. package/src/serve-error.ts +56 -0
  366. package/src/server.ts +5103 -377
  367. package/src/session-fork-store.test.ts +43 -0
  368. package/src/session-fork-store.ts +51 -0
  369. package/src/session-project-attach-migration.test.ts +23 -0
  370. package/src/session-project-attach-native.test.ts +123 -0
  371. package/src/session-project-create-http.test.ts +408 -0
  372. package/src/session-project-create-native.test.ts +292 -0
  373. package/src/session-project-create.ts +159 -0
  374. package/src/session-source-admission-store.ts +58 -0
  375. package/src/session-source-create.test.ts +155 -0
  376. package/src/session-source-create.ts +97 -0
  377. package/src/session-source-delivery.ts +114 -0
  378. package/src/session-source-directory-http.test.ts +196 -0
  379. package/src/session-source-evidence.test.ts +905 -0
  380. package/src/session-source-evidence.ts +191 -0
  381. package/src/session-source-execution.ts +87 -0
  382. package/src/session-source-grant.test.ts +117 -0
  383. package/src/session-source-grant.ts +78 -0
  384. package/src/session-source-issuer.test.ts +250 -0
  385. package/src/session-source-issuer.ts +164 -0
  386. package/src/session-source-transport.ts +381 -0
  387. package/src/session-task-on-dispatch.ts +14 -0
  388. package/src/session-token-ownership-http.test.ts +122 -0
  389. package/src/shared/codex-inventory.ts +41 -0
  390. package/src/shared/daemon-provider-login.ts +31 -0
  391. package/src/shared/daemon-provider-snapshot.ts +52 -0
  392. package/src/shared/external-schedule-contract.ts +60 -0
  393. package/src/shared/node-name.test.ts +62 -0
  394. package/src/shared/node-name.ts +161 -0
  395. package/src/shared/probe-host-allowlist-drift.test.ts +45 -0
  396. package/src/shared/provider-application.ts +29 -0
  397. package/src/shared/provider-collection.ts +14 -0
  398. package/src/shared/provider-initialization.ts +8 -0
  399. package/src/shared/reserved-env-drift.test.ts +10 -0
  400. package/src/shared/scoped-secret-contract.ts +5 -0
  401. package/src/shared/task-content-limit-drift.test.ts +28 -0
  402. package/src/shared/task-content-limit.ts +25 -0
  403. package/src/side-thread-command-transport.test.ts +312 -0
  404. package/src/side-thread-command-transport.ts +318 -0
  405. package/src/side-thread-http-integration.test.ts +233 -0
  406. package/src/side-thread-http.ts +504 -0
  407. package/src/side-thread-production.test.ts +72 -0
  408. package/src/side-thread-production.ts +118 -0
  409. package/src/side-thread.test.ts +1067 -0
  410. package/src/side-thread.ts +2499 -0
  411. package/src/skillhub-http.test.ts +144 -0
  412. package/src/sqlite-close-checkpoint.test.ts +78 -0
  413. package/src/start-node.test.ts +265 -0
  414. package/src/start-request-error-domain.test.ts +182 -0
  415. package/src/start-skill-error-domain.test.ts +122 -0
  416. package/src/stats-versions-http.test.ts +65 -0
  417. package/src/status-alias-filter-http.test.ts +106 -0
  418. package/src/status-alias-resolver-http.test.ts +163 -0
  419. package/src/status-alias-resolver.ts +19 -0
  420. package/src/status-node-id-filter-http.test.ts +161 -0
  421. package/src/status-node-secrets-capable-http.test.ts +44 -0
  422. package/src/status-read-cache-http.test.ts +229 -0
  423. package/src/status-read-cache.ts +129 -0
  424. package/src/stop-delete-node.test.ts +567 -1
  425. package/src/task-access-http.test.ts +407 -0
  426. package/src/task-access.ts +420 -0
  427. package/src/task-activity.ts +60 -0
  428. package/src/task-auth-origin-http.test.ts +93 -0
  429. package/src/task-auth-origin.test.ts +24 -0
  430. package/src/task-auth-origin.ts +7 -0
  431. package/src/task-consumption.test.ts +512 -0
  432. package/src/task-diagnostic-http.test.ts +149 -0
  433. package/src/task-diagnostic.test.ts +115 -0
  434. package/src/task-diagnostic.ts +118 -0
  435. package/src/task-expiry-notice-http.test.ts +298 -0
  436. package/src/task-expiry-notice.ts +318 -0
  437. package/src/task-idempotency-mcp.test.ts +148 -0
  438. package/src/task-idempotency.test.ts +76 -0
  439. package/src/task-idempotency.ts +81 -0
  440. package/src/task-late-replies.ts +54 -0
  441. package/src/task-late-reply-http.test.ts +227 -0
  442. package/src/task-lifecycle-watcher-busy.test.ts +114 -0
  443. package/src/task-lifecycle-watcher.test.ts +209 -0
  444. package/src/task-lifecycle-watcher.ts +109 -0
  445. package/src/task-network-resolution-http.test.ts +140 -0
  446. package/src/task-not-found-error-domain.test.ts +117 -0
  447. package/src/task-offline-delivery-2668.test.ts +119 -0
  448. package/src/task-offline-delivery.ts +81 -0
  449. package/src/task-orphan-http.test.ts +287 -0
  450. package/src/task-orphan.ts +119 -0
  451. package/src/task-queue-ahead-http.test.ts +309 -0
  452. package/src/task-queue-ahead-scale.test.ts +236 -0
  453. package/src/task-queue-ahead.ts +186 -0
  454. package/src/task-rejection-log-http.test.ts +160 -0
  455. package/src/task-rejection-log.ts +61 -0
  456. package/src/task-sender-http.test.ts +143 -0
  457. package/src/task-stale-open-http.test.ts +292 -0
  458. package/src/task-stale-open.ts +103 -0
  459. package/src/tasks-pagination-http.test.ts +141 -0
  460. package/src/team-rules-status-http.test.ts +90 -0
  461. package/src/team-rules-status.test.ts +59 -0
  462. package/src/team-rules-status.ts +72 -0
  463. package/src/test-work-root.ts +18 -0
  464. package/src/tmux-allowlist.test.ts +48 -0
  465. package/src/token-usage-http.test.ts +156 -0
  466. package/src/tool-audience-http.test.ts +266 -0
  467. package/src/tool-audience.ts +130 -0
  468. package/src/tools-list-json-schema.test.ts +94 -0
  469. package/src/tools.ts +4557 -472
  470. package/src/update-node-config-error-domain.test.ts +107 -0
  471. package/src/uploads-http.test.ts +6 -4
  472. package/src/uploads.ts +23 -4
  473. package/src/user-avatar-http.test.ts +74 -0
  474. package/src/user-avatar-image.ts +160 -0
  475. package/src/user-avatar-migration.test.ts +25 -0
  476. package/src/user-avatar-upload-http.test.ts +353 -0
  477. package/src/user-inbox-by-agent-http.test.ts +189 -0
  478. package/src/user-inbox-netid-notnull.test.ts +122 -0
  479. package/src/user-inbox-read-http.test.ts +223 -0
  480. package/src/user-inbox-schema.test.ts +54 -0
  481. package/src/version-stats.test.ts +66 -0
  482. package/src/version-stats.ts +109 -0
@@ -0,0 +1,109 @@
1
+ import { db } from "./db.js";
2
+ import { ALIAS_BASELINE_TABLE, BASELINE_MAX_SECONDS, BASELINE_P99_FACTOR, ensureAliasBaselineTable } from "./alias-baseline.js";
3
+
4
+ export const DELIVERED_STALE_THRESHOLDS = [600, 1800] as const;
5
+
6
+ export type DeliveredStalePatrolResult = {
7
+ inserted: number;
8
+ by_threshold_seconds: Record<(typeof DELIVERED_STALE_THRESHOLDS)[number], number>;
9
+ };
10
+
11
+ function sqliteUtcTimestamp(date: Date): string {
12
+ return date.toISOString().slice(0, 19).replace("T", " ");
13
+ }
14
+
15
+ // #2571(第二轮)—— 阈值从 30s/60s 提到 10min/30min。
16
+ //
17
+ // 第一轮只做了“按目标忙/闲分流”,上线后(19:45–22:30)实测**告警量反而翻倍**
18
+ // (33/h → 73/h,33/h → 104/h),因为同一个任务会先在忙时写 busy、目标转闲后
19
+ // 再写一次 stale(46 个任务两类都出现)。而被标 stale 的任务里仍有 73.5%
20
+ // 最终成功。真正的病因不是“忙 vs 闲”,是**阈值本身离真实分布太远**:
21
+ // 7 天 11877 个成功任务,delivered → 首次活动 p50 = 1 秒、p90 = 6 秒、
22
+ // p95 = 57 秒、p99 = 12 分钟。
23
+ // ⇒ 30 秒的判据会命中 6.4% 的**正常**任务,60 秒命中 4.9%,等于把 p95–p99
24
+ // 的长尾全报警。改成 10 分钟(p99 之下)才有意义:超过它的比例 1.2%,
25
+ // 30 分钟是 0.2%,只留真异常。
26
+ //
27
+ // event_key 里带秒数 ⇒ 改阈值会产生新的 key,历史事件不受影响、可并存对比。
28
+ /**
29
+ * Persist Hub-authoritative warnings for tasks which are still delivered.
30
+ *
31
+ * The task row, not an agent-local timer, is the source of truth. event_key is
32
+ * equal to the stable event name and protected by a unique index, so every
33
+ * threshold is write-once across restarts, patrols, and multiple Hub workers.
34
+ */
35
+ /**
36
+ * #2571 —— 把「慢」和「坏」分开:目标正在跑别的任务时,事件写成 `queued_behind_busy_*`;
37
+ * 目标空闲/离线/未知时,才写成 `delivered_stale_*`。
38
+ *
39
+ * 为什么是一条 SQL(而不是两条 INSERT):`test683` 的 mutation 门用**字符串锚点**钉住
40
+ * “write-once 冲突门”“只认 delivered”“网络字段透传”三件事;拆成两条 INSERT 会让锚点
41
+ * 命中次数变成 0 或让 mutation 只命中一半 —— 那就把“可被变异测试覆盖”这条性质弄丢了。
42
+ * 因此这里仍然只保留**一条** INSERT,用 CASE 选择事件名与文案。
43
+ */
44
+ function thresholdLabel(thresholdSeconds: 600 | 1800): string {
45
+ return thresholdSeconds === 600 ? "10m" : "30m";
46
+ }
47
+
48
+ function recordStale(thresholdSeconds: 600 | 1800, cutoff: string, referenceIso: string): number {
49
+ const busyType = `task.warning.queued_behind_busy_${thresholdSeconds}s`;
50
+ const staleType = `task.warning.delivered_stale_${thresholdSeconds}s`;
51
+ const label = thresholdLabel(thresholdSeconds);
52
+ const busyDetail = `queued after ${label}; target is working on another task`;
53
+ const staleDetail = thresholdSeconds === 600
54
+ ? `still delivered after ${label}; target is not working on another task and has not started`
55
+ : `still delivered after ${label}; target is idle or offline and not consuming`;
56
+ const result = db.run(
57
+ `INSERT INTO task_events
58
+ (task_id, from_status, to_status, event_type, event_key, actor, detail, network_id)
59
+ SELECT task_id, 'delivered', 'delivered',
60
+ CASE WHEN COALESCE((SELECT s.status FROM sessions s
61
+ WHERE s.alias = tasks.to_name AND s.network_id = tasks.network_id), 'unknown') = 'working'
62
+ THEN ?4 ELSE ?5 END,
63
+ CASE WHEN COALESCE((SELECT s.status FROM sessions s
64
+ WHERE s.alias = tasks.to_name AND s.network_id = tasks.network_id), 'unknown') = 'working'
65
+ THEN ?4 ELSE ?5 END,
66
+ 'patrol',
67
+ CASE WHEN COALESCE((SELECT s.status FROM sessions s
68
+ WHERE s.alias = tasks.to_name AND s.network_id = tasks.network_id), 'unknown') = 'working'
69
+ THEN ?6 ELSE ?7 END,
70
+ network_id
71
+ FROM tasks
72
+ -- 这个子查询把列名改成 b_* 前缀:SELECT 列表里的 network_id 必须继续是 tasks 的
73
+ -- (test683 的 L9 变异门用 network_id + FROM tasks 相邻两行当锚点,裸列名一改锚点就失效)。
74
+ LEFT JOIN (SELECT alias AS b_alias, network_id AS b_network, p99_seconds AS b_p99
75
+ FROM alias_latency_baseline) b
76
+ ON b.b_alias = tasks.to_name AND b.b_network = tasks.network_id
77
+ WHERE status = 'delivered'
78
+ AND delivered_at IS NOT NULL
79
+ AND delivered_at <= ?3
80
+ -- #2571 第三轮:目标自己的 p99 基线比全局下限更宽时,用它(全队变慢不炸屏,
81
+ -- 单节点卡住仍会显形)。没有基线行 ⇒ 与 .163 行为完全一致。
82
+ AND (
83
+ b.b_p99 IS NULL
84
+ OR delivered_at <= datetime(?8, '-' || CAST(b.b_p99 * 1.5 AS INTEGER) || ' seconds')
85
+ -- 上限:再慢的节点,等满 30 分钟也必须报(否则 p99=50min 的节点永远不响)。
86
+ OR delivered_at <= datetime(?8, '-' || CAST(?9 AS INTEGER) || ' seconds')
87
+ )
88
+ ON CONFLICT(task_id, event_key) DO NOTHING`,
89
+ [staleType, staleDetail, cutoff, busyType, staleType, busyDetail, staleDetail, referenceIso, BASELINE_MAX_SECONDS],
90
+ );
91
+ return result.changes;
92
+ }
93
+
94
+ export function recordDeliveredStaleEvents(now = new Date()): DeliveredStalePatrolResult {
95
+ if (!Number.isFinite(now.getTime())) throw new Error("invalid lifecycle patrol time");
96
+
97
+ ensureAliasBaselineTable();
98
+ const byThreshold = { 600: 0, 1800: 0 };
99
+ let inserted = 0;
100
+
101
+ for (const thresholdSeconds of DELIVERED_STALE_THRESHOLDS) {
102
+ const cutoff = sqliteUtcTimestamp(new Date(now.getTime() - thresholdSeconds * 1000));
103
+ const changes = recordStale(thresholdSeconds, cutoff, now.toISOString());
104
+ byThreshold[thresholdSeconds] = changes;
105
+ inserted += changes;
106
+ }
107
+
108
+ return { inserted, by_threshold_seconds: byThreshold };
109
+ }
@@ -0,0 +1,140 @@
1
+ import { afterAll, beforeAll, describe, expect, test } from "bun:test";
2
+ import { mkdtempSync, rmSync } from "fs";
3
+ import { join } from "path";
4
+ import { tmpdir } from "os";
5
+ import { register } from "./auth.js";
6
+ import { db } from "./db.js";
7
+
8
+ const PRIVATE_DB_DIR = mkdtempSync(join(tmpdir(), "anet-task-network-resolution-"));
9
+ let server: any;
10
+ let base = "";
11
+
12
+ type Principal = { token: string; userId: string; networkId: string; target: string };
13
+ let adminSingle: Principal;
14
+ let userSingle: Principal;
15
+ let adminMulti: Principal;
16
+ let adminZero: Principal;
17
+
18
+ function registerPrincipal(label: string, admin: boolean): Principal {
19
+ const username = `task_net_${label}_${Date.now()}_${Math.random().toString(16).slice(2)}`;
20
+ const registered = register(username, "TaskNetwork123!", undefined, "seed");
21
+ expect(registered.ok).toBe(true);
22
+ const userId = db.get<{ user_id: string }>(
23
+ "SELECT user_id FROM users WHERE username = ?1",
24
+ [username],
25
+ )!.user_id;
26
+ if (admin) db.run("UPDATE users SET role = 'admin' WHERE user_id = ?1", [userId]);
27
+ return {
28
+ token: registered.token!,
29
+ userId,
30
+ networkId: registered.network_id!,
31
+ target: `task-net-${label}-${process.pid}`,
32
+ };
33
+ }
34
+
35
+ function seedTarget(principal: Principal): void {
36
+ const nodeId = `node_${principal.target}`;
37
+ db.run(
38
+ `INSERT INTO sessions (resume_id, alias, status, node_id, network_id, updated_at, last_seen_at)
39
+ VALUES (?1, ?2, 'idle', ?3, ?4, datetime('now'), datetime('now'))`,
40
+ [`resume_${principal.target}`, principal.target, nodeId, principal.networkId],
41
+ );
42
+ db.run(
43
+ `INSERT INTO nodes (node_id, node_name, alias, network_id, created_at, updated_at, lifecycle_state)
44
+ VALUES (?1, ?2, ?2, ?3, datetime('now'), datetime('now'), 'active')`,
45
+ [nodeId, principal.target, principal.networkId],
46
+ );
47
+ }
48
+
49
+ // 30s 而不是 bun 默认的 5s:这个 hook 跑 register()(KDF)+bootServer(),
50
+ // 本机空载基线 ~620ms,而 2026-08-17 与 2026-08-31 两次 CI 上它被 5s 上限打死
51
+ // (0 pass / 1 fail / Ran 1 test —— 见 #928、#1627)。5247ms 是**被截断的下界**,
52
+ // 不是测量值,所以余量按基线的 ~48x 取,而不是按那个数取。
53
+ beforeAll(async () => {
54
+ process.env.COMMHUB_DB = process.env.COMMHUB_DB || join(PRIVATE_DB_DIR, "hub.db");
55
+ adminSingle = registerPrincipal("admin_single", true);
56
+ userSingle = registerPrincipal("user_single", false);
57
+ adminMulti = registerPrincipal("admin_multi", true);
58
+ adminZero = registerPrincipal("admin_zero", true);
59
+ seedTarget(adminSingle);
60
+ seedTarget(userSingle);
61
+ seedTarget(adminMulti);
62
+
63
+ const secondNetwork = `net_task_second_${process.pid}`;
64
+ db.run(
65
+ "INSERT INTO networks (network_id, network_name, owner_id, created_at) VALUES (?1, 'second', ?2, datetime('now'))",
66
+ [secondNetwork, adminMulti.userId],
67
+ );
68
+ db.run(
69
+ "INSERT INTO network_members (user_id, network_id, role, joined_at) VALUES (?1, ?2, 'owner', datetime('now'))",
70
+ [adminMulti.userId, secondNetwork],
71
+ );
72
+ db.run("DELETE FROM network_members WHERE user_id = ?1", [adminZero.userId]);
73
+
74
+ const mod: any = await import("./server.js");
75
+ server = mod.bootServer({ port: 0, hostname: "127.0.0.1" });
76
+ base = `http://127.0.0.1:${server.port}`;
77
+ }, 30_000);
78
+
79
+ afterAll(() => {
80
+ try { server?.stop?.(true); } catch {}
81
+ try { rmSync(PRIVATE_DB_DIR, { recursive: true, force: true }); } catch {}
82
+ });
83
+
84
+ async function post(principal: Principal, marker: string, networkId?: string) {
85
+ const response = await fetch(`${base}/api/task`, {
86
+ method: "POST",
87
+ headers: { Authorization: `Bearer ${principal.token}`, "Content-Type": "application/json" },
88
+ body: JSON.stringify({
89
+ alias: principal.target,
90
+ task: marker,
91
+ priority: "high",
92
+ ...(networkId ? { network_id: networkId } : {}),
93
+ }),
94
+ });
95
+ return { response, body: await response.json() as any };
96
+ }
97
+
98
+ describe("POST /api/task single-network resolution (#448)", () => {
99
+ test("admin with exactly one membership may omit network_id", async () => {
100
+ const marker = `x448-admin-single-${Date.now()}`;
101
+ const { response, body } = await post(adminSingle, marker);
102
+ expect([200, 202]).toContain(response.status);
103
+ expect(body.ok).toBe(true);
104
+ expect(db.get<{ network_id: string }>("SELECT network_id FROM tasks WHERE content = ?1", [marker])?.network_id)
105
+ .toBe(adminSingle.networkId);
106
+ });
107
+
108
+ test("ordinary single-network user behavior remains unchanged", async () => {
109
+ const marker = `x448-user-single-${Date.now()}`;
110
+ const { response, body } = await post(userSingle, marker);
111
+ expect([200, 202]).toContain(response.status);
112
+ expect(body.ok).toBe(true);
113
+ expect(db.get<{ network_id: string }>("SELECT network_id FROM tasks WHERE content = ?1", [marker])?.network_id)
114
+ .toBe(userSingle.networkId);
115
+ });
116
+
117
+ test("multi-network admin must select a network explicitly", async () => {
118
+ const { response, body } = await post(adminMulti, `x448-admin-multi-${Date.now()}`);
119
+ expect(response.status).toBe(400);
120
+ expect(body).toEqual({
121
+ ok: false,
122
+ error: "network_id_required",
123
+ message: "network_id is required when the user token has zero or multiple network memberships",
124
+ });
125
+ });
126
+
127
+ test("zero-membership admin gets the same accurate error", async () => {
128
+ const { response, body } = await post(adminZero, `x448-admin-zero-${Date.now()}`);
129
+ expect(response.status).toBe(400);
130
+ expect(body.error).toBe("network_id_required");
131
+ expect(body.message).toContain("zero or multiple network memberships");
132
+ });
133
+
134
+ test("multi-network admin can still select an explicit member network", async () => {
135
+ const marker = `x448-admin-explicit-${Date.now()}`;
136
+ const { response, body } = await post(adminMulti, marker, adminMulti.networkId);
137
+ expect([200, 202]).toContain(response.status);
138
+ expect(body.ok).toBe(true);
139
+ });
140
+ });
@@ -0,0 +1,117 @@
1
+ // #3309 读数覆盖第九批 —— 一个错误字面量,三个工具共用:
2
+ //
3
+ // "task not found" ← retry_task / get_task / reassign_task
4
+ //
5
+ // 它此前在测试里一次都没出现过。而它正是最容易一直没人断言的那一类:
6
+ // **一句读起来像文案的英文短语**。所有人都会以为它「肯定被测过」,
7
+ // 而按字符串去找,一次都没有。
8
+ //
9
+ // 为什么值得单独钉:这三个工具在「id 打错了」时都落到同一句话,
10
+ // 而它们的补救完全不同(重试另一个 id / 查另一个 id / 把它派给别人)。
11
+ // 一旦有人为了「更友好」把其中一处改成 `task_not_found`,只有断言能发现。
12
+ import { afterAll, beforeEach, describe, expect, test } from "bun:test";
13
+ import { db } from "./db.js";
14
+ import { McpServer } from "@modelcontextprotocol/sdk/server/mcp.js";
15
+ import { registerTools } from "./tools.js";
16
+
17
+ const NET = "net_9th_err";
18
+ const USER = "u_9th_owner";
19
+ const ALIAS = "9th-node";
20
+
21
+ type ToolHandler = (args: any) => Promise<{ content: Array<{ type: "text"; text: string }> }>;
22
+
23
+ function handlers(): Record<string, ToolHandler> {
24
+ const server = new McpServer({ name: "t", version: "0" }) as any;
25
+ const out: Record<string, ToolHandler> = {};
26
+ const orig = server.tool.bind(server);
27
+ server.tool = (n: string, d: string, s: any, h: ToolHandler) => { out[n] = h; return orig(n, d, s, h); };
28
+ registerTools(server, undefined, NET, USER, ALIAS, false, null);
29
+ return out;
30
+ }
31
+
32
+ async function call(name: string, args: Record<string, unknown>) {
33
+ const r = await handlers()[name](args);
34
+ return JSON.parse(r.content[0].text) as { ok?: boolean; error?: string; [k: string]: unknown };
35
+ }
36
+
37
+ function cleanup() {
38
+ try { db.run("DELETE FROM network_members WHERE network_id = ?1", [NET]); } catch {}
39
+ try { db.run("DELETE FROM networks WHERE network_id = ?1", [NET]); } catch {}
40
+ try { db.run("DELETE FROM users WHERE user_id = ?1", [USER]); } catch {}
41
+ }
42
+
43
+ function seed() {
44
+ cleanup();
45
+ db.run("INSERT INTO users (user_id, username, password_hash, role, created_at) VALUES (?1, ?1, 'x', 'user', datetime('now'))", [USER]);
46
+ db.run("INSERT INTO networks (network_id, network_name, owner_id, created_at) VALUES (?1, ?1, ?2, datetime('now'))", [NET, USER]);
47
+ db.run("INSERT INTO network_members (user_id, network_id, role, joined_at) VALUES (?1, ?2, 'owner', datetime('now'))", [USER, NET]);
48
+ }
49
+
50
+ beforeEach(seed);
51
+ afterAll(cleanup);
52
+
53
+ // #3325 第一格运行时对照 —— 静态口径说「断言写了什么」,这一条说「它实际返回什么」。
54
+ // 只做**键集**比较(不比对值):值的语义要另一套夹具,而键集已经有静态期望可对照。
55
+ describe("#3325 运行时键集(list_tasks 成功路径)", () => {
56
+ test("list_tasks 成功响应的键集 == 静态期望(两者不符即有一侧是缺陷)", async () => {
57
+ const r = await call("list_tasks", { limit: 20 });
58
+ expect(r.ok).toBe(true);
59
+ // 这个期望来自**一次真实调用**(先跑出来,再抄进来),因此它同时是:
60
+ // ① 运行时事实(它刚刚确实这么返回)
61
+ // ② 变更探测器(实现改了键 ← 会红)
62
+ // 它**不是**契约读数:指不出一份独立于实现的书面来源。
63
+ // 🔴 我第一次写的是四个键(count/ok/stats/tasks)—— 真实调用给出 **五个**:
64
+ // `next_cursor` 也在里面。这就是这一格存在的理由:静态读代码得到的键集是
65
+ // 「我以为它返回什么」,而运行时对照得到的是「它实际返回什么」。
66
+ // 🔴 2026-11-06 第三次被真实调用纠正(#3119 since_last 水位):多了 `server_time`。
67
+ // 它不是"顺手加的一个字段":调用方要靠它做下一次增量(`since_last` / `created_since`
68
+ // 都拿它当入参),所以"键集变了"在这里等于"契约变了",值得红一次。
69
+ expect(Object.keys(r).sort()).toEqual([
70
+ "count", "next_cursor", "ok", "server_time", "stats", "tasks",
71
+ ].sort());
72
+ // 空库时这几格的具体形态也钉住(**第二次被真实调用纠正**:我写「stats 是对象」,
73
+ // 实测它是**数组** —— 源码里 stats 来自 `GROUP BY status` 的 db.all(...),本来就是行数组)。
74
+ expect(r.count).toBe(0);
75
+ expect(r.tasks).toEqual([]);
76
+ expect(Array.isArray(r.stats)).toBe(true);
77
+ });
78
+ });
79
+
80
+ describe("#3325 运行时键集(get_task 失败路径)", () => {
81
+ test("get_task 的失败载荷**只有两个键**(运行时,不是从代码读出来的)", async () => {
82
+ // 我原本想钉 get_task 的**成功**键集,插了一行 tasks 之后仍回 "task not found"
83
+ // (它的可见性不看 from_name/to_name,我这里没构造出能被看见的那一行)。
84
+ // 于是改成钉失败载荷 —— 它同样是运行时读数,且这条**碰巧**是可判的:
85
+ // 失败体若哪天多带了 `task_id` 之类的定位信息,这条会红。
86
+ const r = await call("get_task", { task_id: "task_rt_missing" });
87
+ expect(r.ok).toBe(false);
88
+ expect(Object.keys(r).sort()).toEqual(["error", "ok"].sort());
89
+ // 成功路径的那一格**没做成**,记在这里而不是假装有:
90
+ // 需要一份「调用者视角可见」的 task 行(其可见性不由 from/to 决定),未构造出来。
91
+ });
92
+ });
93
+
94
+ describe('#3309 「task not found」:三个工具共用同一句话', () => {
95
+ test("三个工具在不存在的 id 上给出**同一句**(逐字相同)", async () => {
96
+ const missing = "task_9th_does_not_exist";
97
+ const got = [
98
+ await call("get_task", { task_id: missing }),
99
+ await call("retry_task", { task_id: missing }),
100
+ await call("reassign_task", { task_id: missing, to_name: "someone-else" }),
101
+ ];
102
+ for (const [i, r] of got.entries()) {
103
+ expect(r.ok, `第 ${i + 1} 个工具应当拒绝`).toBe(false);
104
+ // 逐字相同是**故意的**:调用方按这一句分支;改一处就多出一种拼写。
105
+ expect(r.error, `第 ${i + 1} 个工具的 error 应当是同一句`).toBe("task not found");
106
+ }
107
+ // 三处必须真的同一个字符串 —— 任何一个被「统一成 code」都会让这条红。
108
+ expect(new Set(got.map((r) => r.error)).size, "三个工具不该给出不同拼写").toBe(1);
109
+ });
110
+
111
+ test("这句话**带空格**(不是 code 风格)—— 现状,记下来", async () => {
112
+ const r = await call("get_task", { task_id: "task_9th_missing" });
113
+ // 带空格的值最容易被当成文案而没人断言;这条测试存在的理由是把它钉成契约。
114
+ expect(String(r.error)).toContain(" ");
115
+ expect(String(r.error)).not.toMatch(/^[a-z0-9_]+$/);
116
+ });
117
+ });
@@ -0,0 +1,119 @@
1
+ // #2668 —— 投给已离线节点的任务,超过 TTL(默认 30 分钟)就过期,而不是躺满 24 小时的 TTL。
2
+ //
3
+ // 现场:任务 3b3c63e0 投给 TM基建鲸 后目标立刻 offline,`delivered` 状态挂了 **2 小时 56 分**,
4
+ // 10/30 分钟两档告警都报了但没有处置;`expires_at` 是创建后 24 小时。
5
+ //
6
+ // 这个文件钉住五件事:
7
+ // 1. 目标 offline ⇒ 超时后过期;
8
+ // 2. 目标没有 session 行(未知)⇒ 同样按 offline 处理;
9
+ // 3. 目标忙(working)⇒ **不处置**(那是 queued_behind_busy 的语义);
10
+ // 4. 节点已经取走(consumed_at 有值)⇒ 不处置(交给 #758 orphan 判据);
11
+ // 5. TTL 可配且可关(COMMHUB_OFFLINE_DELIVERY_TTL_MINUTES,0 = 关闭)。
12
+
13
+ import { afterAll, afterEach, beforeAll, describe, expect, test } from "bun:test";
14
+ import { db } from "./db.js";
15
+ import {
16
+ OFFLINE_DELIVERY_TTL_ENV,
17
+ expireDeliveredToOfflineTargets,
18
+ offlineDeliveryTtlMinutes,
19
+ } from "./task-offline-delivery.js";
20
+
21
+ const stamp = `${Date.now()}`;
22
+ let NET = "";
23
+ const NOW = new Date("2026-10-27T03:30:00.000Z");
24
+ const savedEnv = process.env[OFFLINE_DELIVERY_TTL_ENV];
25
+
26
+ function deliveredAgo(minutes: number): string {
27
+ return new Date(NOW.getTime() - minutes * 60_000).toISOString().slice(0, 19).replace("T", " ");
28
+ }
29
+
30
+ function seedSession(alias: string, status: string) {
31
+ db.run(
32
+ `INSERT INTO sessions (resume_id, alias, node_id, status, network_id, registered_at)
33
+ VALUES (?1, ?2, ?3, ?4, ?5, datetime('now'))`,
34
+ [`res_${alias}_${stamp}`, alias, `n_${alias}_${stamp}`, status, NET],
35
+ );
36
+ }
37
+
38
+ function seedTask(id: string, toName: string, deliveredMinutesAgo: number, extra: { consumed?: string } = {}) {
39
+ db.run(
40
+ `INSERT INTO tasks (task_id, from_name, to_name, status, content, delivered_at, consumed_at, expires_at, network_id)
41
+ VALUES (?1, 'sender', ?2, 'delivered', 'offline fixture', ?3, ?4, datetime('now','+1 day'), ?5)`,
42
+ [id, toName, deliveredAgo(deliveredMinutesAgo), extra.consumed ?? null, NET],
43
+ );
44
+ }
45
+
46
+ const statusOf = (id: string) => db.get<{ status: string }>("SELECT status FROM tasks WHERE task_id = ?1", [id])!.status;
47
+
48
+ beforeAll(async () => {
49
+ const { register } = await import("./auth.js");
50
+ const auth = register(`offl_owner_${stamp}`, "Offl-Owner-Strong-1!", undefined, "tester");
51
+ expect(auth.ok).toBe(true);
52
+ NET = auth.network_id!;
53
+ process.env[OFFLINE_DELIVERY_TTL_ENV] = "30";
54
+
55
+ seedSession(`offl-off-${stamp}`, "offline");
56
+ seedSession(`offl-busy-${stamp}`, "working");
57
+
58
+ seedTask(`offl-1-${stamp}`, `offl-off-${stamp}`, 45); // 离线 + 45 分钟 ⇒ 过期
59
+ seedTask(`offl-2-${stamp}`, `offl-off-${stamp}`, 10); // 离线但只 10 分钟 ⇒ 不动
60
+ seedTask(`offl-3-${stamp}`, `offl-busy-${stamp}`, 45); // 目标忙 ⇒ 不动
61
+ seedTask(`offl-4-${stamp}`, `offl-missing-${stamp}`, 45); // 没有 session 行 ⇒ 视为离线 ⇒ 过期
62
+ seedTask(`offl-5-${stamp}`, `offl-off-${stamp}`, 45, { consumed: deliveredAgo(46) }); // 已被取走 ⇒ 不动
63
+ });
64
+
65
+ afterEach(() => { process.env[OFFLINE_DELIVERY_TTL_ENV] = "30"; });
66
+
67
+ afterAll(() => {
68
+ try { db.run(`DELETE FROM tasks WHERE task_id LIKE ?1`, [`offl-%-${stamp}`]); } catch {}
69
+ try { db.run(`DELETE FROM sessions WHERE alias LIKE ?1`, [`offl-%-${stamp}`]); } catch {}
70
+ if (savedEnv === undefined) delete process.env[OFFLINE_DELIVERY_TTL_ENV];
71
+ else process.env[OFFLINE_DELIVERY_TTL_ENV] = savedEnv;
72
+ });
73
+
74
+ describe("#2668 delivered-to-offline expiry", () => {
75
+ test("默认 TTL 30 分钟,可配、可关", () => {
76
+ delete process.env[OFFLINE_DELIVERY_TTL_ENV];
77
+ expect(offlineDeliveryTtlMinutes()).toBe(30);
78
+ process.env[OFFLINE_DELIVERY_TTL_ENV] = "10";
79
+ expect(offlineDeliveryTtlMinutes()).toBe(10);
80
+ process.env[OFFLINE_DELIVERY_TTL_ENV] = "0";
81
+ expect(offlineDeliveryTtlMinutes()).toBe(0);
82
+ });
83
+
84
+ test("目标离线且超过 TTL ⇒ 过期;未超时/目标忙/已取走 ⇒ 都不动", () => {
85
+ const dropped = expireDeliveredToOfflineTargets(NOW);
86
+ const ids = dropped.map(d => d.task_id);
87
+ expect(ids).toContain(`offl-1-${stamp}`);
88
+ expect(ids).toContain(`offl-4-${stamp}`);
89
+ expect(ids).not.toContain(`offl-2-${stamp}`);
90
+ expect(ids).not.toContain(`offl-3-${stamp}`);
91
+ expect(ids).not.toContain(`offl-5-${stamp}`);
92
+
93
+ expect(statusOf(`offl-1-${stamp}`)).toBe("expired");
94
+ expect(statusOf(`offl-4-${stamp}`)).toBe("expired");
95
+ expect(statusOf(`offl-2-${stamp}`)).toBe("delivered");
96
+ expect(statusOf(`offl-3-${stamp}`)).toBe("delivered");
97
+ expect(statusOf(`offl-5-${stamp}`)).toBe("delivered");
98
+ });
99
+
100
+ test("返回行带 waited_minutes(通知文案要用)", () => {
101
+ seedTask(`offl-6-${stamp}`, `offl-off-${stamp}`, 90);
102
+ const dropped = expireDeliveredToOfflineTargets(NOW);
103
+ const row = dropped.find(d => d.task_id === `offl-6-${stamp}`);
104
+ expect(row).toBeTruthy();
105
+ expect(row!.waited_minutes).toBeGreaterThanOrEqual(89);
106
+ });
107
+
108
+ test("第二次调用幂等(已过期的不再出现)", () => {
109
+ const again = expireDeliveredToOfflineTargets(NOW);
110
+ expect(again.map(d => d.task_id)).not.toContain(`offl-1-${stamp}`);
111
+ });
112
+
113
+ test("TTL=0 时整个阶段关闭", () => {
114
+ seedTask(`offl-7-${stamp}`, `offl-off-${stamp}`, 999);
115
+ process.env[OFFLINE_DELIVERY_TTL_ENV] = "0";
116
+ expect(expireDeliveredToOfflineTargets(NOW)).toEqual([]);
117
+ expect(statusOf(`offl-7-${stamp}`)).toBe("delivered");
118
+ });
119
+ });
@@ -0,0 +1,81 @@
1
+ // #2668 —— 投给**已离线**节点的任务不该躺满 24 小时。
2
+ //
3
+ // 现场(2026-10-27,生产):
4
+ // 任务 3b3c63e0 → TM基建鲸,投递后目标 session 立刻 offline,任务以 `delivered` 状态挂了 **2 小时 56 分**;
5
+ // 10 分钟 / 30 分钟两档告警都按时报了,然后**没有任何处置**;`expires_at` 是创建后 24 小时。
6
+ // 同期队列里还有几个同类任务。
7
+ //
8
+ // 为什么这是问题(三条,都实测过):
9
+ // 1. 队列里挂着**不可能被执行**的任务(目标不在),却计入“在途/积压”;与 #2363 的 in-flight 判读混在一起;
10
+ // 2. 发送方(常常是另一个 Agent)在自己 30 分钟超时后早已放弃,Hub 侧看起来还在“投递中”;
11
+ // 3. 目标重新上线后会消费这个陈旧任务 —— 可能做三小时前的工作。
12
+ //
13
+ // 本模块只做一件最小的事:**目标明确不在(session=offline 或没有 session 行)且投递已超过 TTL** ⇒ 过期。
14
+ // 「目标忙」不算(那走 queued_behind_busy,不做处置);`created` 状态不算(还没投递);
15
+ // 已经被节点取走(`consumed_at` 有值)的不算(那是节点在处理,交给 #758 的 orphan 判据)。
16
+
17
+ import { db } from "./db.js";
18
+
19
+ export const OFFLINE_DELIVERY_TTL_ENV = "COMMHUB_OFFLINE_DELIVERY_TTL_MINUTES";
20
+ export const OFFLINE_DELIVERY_TTL_DEFAULT_MINUTES = 30;
21
+
22
+ export function offlineDeliveryTtlMinutes(): number {
23
+ const raw = process.env[OFFLINE_DELIVERY_TTL_ENV];
24
+ if (raw === undefined || raw.trim() === "") return OFFLINE_DELIVERY_TTL_DEFAULT_MINUTES;
25
+ const n = Number(raw);
26
+ return Number.isFinite(n) && n >= 0 ? Math.floor(n) : OFFLINE_DELIVERY_TTL_DEFAULT_MINUTES;
27
+ }
28
+
29
+ export type OfflineDroppedTask = {
30
+ task_id: string;
31
+ network_id: string | null;
32
+ from_name: string | null;
33
+ from_node_id: string | null;
34
+ to_name: string | null;
35
+ content: string;
36
+ created_at: string;
37
+ expires_at: string | null;
38
+ parent_task_id: string | null;
39
+ meta_json: string | null;
40
+ waited_minutes: number;
41
+ };
42
+
43
+ /**
44
+ * 找出并过期「投给离线目标的陈年投递」。返回被过期的行(调用方负责发事件与通知,与 TTL 那条路径一致)。
45
+ * 同步执行:调用点在 5 分钟一次的 patrol 里,单次量级是几十行。
46
+ */
47
+ export function expireDeliveredToOfflineTargets(now = new Date()): OfflineDroppedTask[] {
48
+ const ttl = offlineDeliveryTtlMinutes();
49
+ if (ttl <= 0) return [];
50
+ const nowIso = now.toISOString();
51
+ const ageClause = `datetime(delivered_at) <= datetime(?1, '-${ttl} minutes')`;
52
+
53
+ const due = db.all<OfflineDroppedTask>(
54
+ `SELECT t.task_id, t.network_id, t.from_name, t.from_node_id, t.to_name, t.content,
55
+ t.created_at, t.expires_at, t.parent_task_id, t.meta_json,
56
+ CAST((julianday(?1) - julianday(t.delivered_at)) * 1440 AS INTEGER) AS waited_minutes
57
+ FROM tasks t
58
+ WHERE t.status = 'delivered'
59
+ AND t.delivered_at IS NOT NULL
60
+ AND t.consumed_at IS NULL
61
+ AND ${ageClause}
62
+ AND COALESCE((SELECT s.status FROM sessions s
63
+ WHERE s.alias = t.to_name AND s.network_id = t.network_id), 'offline') = 'offline'`,
64
+ [nowIso],
65
+ );
66
+ if (due.length === 0) return [];
67
+
68
+ const dropped: OfflineDroppedTask[] = [];
69
+ for (const task of due) {
70
+ const changed = db.run(
71
+ `UPDATE tasks SET status = 'expired', completed_at = datetime('now')
72
+ WHERE task_id = ?1 AND status = 'delivered' AND consumed_at IS NULL`,
73
+ [task.task_id],
74
+ );
75
+ if (changed.changes < 1) continue;
76
+ // 与 TTL 过期一致:把 inbox 行 ack 掉,否则 unread 徽标与 stop/delete 门会一直看到它。
77
+ db.run(`UPDATE inbox SET acked = 1 WHERE COALESCE(task_id, id) = ?1 AND acked = 0`, [task.task_id]);
78
+ dropped.push(task);
79
+ }
80
+ return dropped;
81
+ }