@sleep2agi/commhub-server 0.9.0-preview.20 → 0.9.0-preview.201

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 (398) hide show
  1. package/README.md +130 -10
  2. package/bin/commhub.ts +99 -11
  3. package/package.json +7 -7
  4. package/src/ack-create-request-transport.test.ts +182 -0
  5. package/src/ack-create-request.test.ts +50 -7
  6. package/src/admin-delete-network-http.test.ts +228 -0
  7. package/src/admin-networks-http.test.ts +88 -0
  8. package/src/adoption-candidates-http.test.ts +137 -0
  9. package/src/adoption-candidates.ts +158 -0
  10. package/src/agent-access-batch.test.ts +210 -0
  11. package/src/agent-access.ts +487 -0
  12. package/src/agent-acl-groups-http.test.ts +247 -0
  13. package/src/agent-acl-http.test.ts +659 -0
  14. package/src/agent-acl-slice3-http.test.ts +267 -0
  15. package/src/agent-department-http.test.ts +215 -0
  16. package/src/agent-groups-perf.test.ts +223 -0
  17. package/src/agent-notice.ts +48 -0
  18. package/src/agent-team-whoami-http.test.ts +98 -0
  19. package/src/agent-teams-http.test.ts +330 -0
  20. package/src/agent-teams.ts +244 -0
  21. package/src/alias-baseline-2571.test.ts +162 -0
  22. package/src/alias-baseline.ts +113 -0
  23. package/src/alias-filter.test.ts +72 -0
  24. package/src/alias-filter.ts +42 -0
  25. package/src/api-host-supervisors-can-create-nodes.test.ts +350 -0
  26. package/src/api-host-supervisors-fallback.test.ts +21 -12
  27. package/src/api-host-supervisors-runtime-readiness.test.ts +195 -0
  28. package/src/api-nodes-shape.test.ts +120 -13
  29. package/src/auth-password-change-cli-tokens-http.test.ts +423 -0
  30. package/src/auth-sessions-http.test.ts +250 -0
  31. package/src/auth-validate.test.ts +5 -1
  32. package/src/auth-weak-password-login.test.ts +176 -0
  33. package/src/auth.ts +609 -51
  34. package/src/avatar-validate.test.ts +163 -0
  35. package/src/avatar-validate.ts +103 -0
  36. package/src/backfill-node-ids-2664.test.ts +128 -0
  37. package/src/binding-generation-http.test.ts +121 -0
  38. package/src/blocked-exit-on-reply.test.ts +122 -0
  39. package/src/boot-side-effect.test.ts +124 -0
  40. package/src/broadcast-fanout-2721.test.ts +118 -0
  41. package/src/broadcast-fanout.ts +98 -0
  42. package/src/chain-attempt-dedup.test.ts +447 -0
  43. package/src/clone-node.test.ts +248 -0
  44. package/src/clone-node.ts +289 -0
  45. package/src/codex-config-flags.ts +77 -0
  46. package/src/codex-fork-contract.ts +23 -0
  47. package/src/codex-fork-migration.test.ts +38 -0
  48. package/src/commhub-bin-args.test.ts +85 -0
  49. package/src/config-apply-sec1.test.ts +107 -0
  50. package/src/config-apply-validate.test.ts +134 -1
  51. package/src/config-apply-validate.ts +111 -5
  52. package/src/create-node-blocked-gate.test.ts +356 -0
  53. package/src/create-node-network-id.test.ts +79 -0
  54. package/src/create-node-tool-schema.test.ts +49 -0
  55. package/src/create-node-unicode-name.test.ts +120 -0
  56. package/src/create-node-validate.test.ts +199 -7
  57. package/src/create-node-validate.ts +232 -15
  58. package/src/create-node-workdir.test.ts +289 -0
  59. package/src/create-node.ts +88 -23
  60. package/src/daemon-provider-snapshots.test.ts +421 -0
  61. package/src/daemon-provider-snapshots.ts +327 -0
  62. package/src/daemon-token-owner-http.test.ts +236 -0
  63. package/src/dashboard-slash-routing-http.test.ts +109 -0
  64. package/src/db-adapter-guard.test.ts +148 -0
  65. package/src/db-adapter-translate.test.ts +128 -0
  66. package/src/db-adapter.ts +377 -91
  67. package/src/db-timestamp.test.ts +38 -0
  68. package/src/db-timestamp.ts +15 -0
  69. package/src/db.ts +1306 -153
  70. package/src/delivered-without-push.test.ts +140 -0
  71. package/src/department-groups-http.test.ts +209 -0
  72. package/src/department-groups-sync-http.test.ts +328 -0
  73. package/src/department-groups.ts +434 -0
  74. package/src/department-heads-http.test.ts +330 -0
  75. package/src/department-heads.ts +226 -0
  76. package/src/departments-agent-count.test.ts +129 -0
  77. package/src/departments-http.test.ts +185 -0
  78. package/src/departments-mcp.test.ts +128 -0
  79. package/src/departments.ts +318 -0
  80. package/src/desktop-message-seam.test.ts +150 -0
  81. package/src/desktop-message.test.ts +368 -0
  82. package/src/dm-file-scope-http.test.ts +178 -0
  83. package/src/empty-node-sweeper.test.ts +104 -0
  84. package/src/empty-node-sweeper.ts +88 -0
  85. package/src/env-transport-gate-http.test.ts +177 -0
  86. package/src/env-transport-gate.ts +74 -0
  87. package/src/env-transport-policy.ts +21 -0
  88. package/src/event-loop-lag.test.ts +139 -0
  89. package/src/event-loop-lag.ts +150 -0
  90. package/src/ext-token-shared.test.ts +60 -0
  91. package/src/ext-validation-regression.test.ts +131 -0
  92. package/src/external-schedule-edits-http.test.ts +321 -0
  93. package/src/external-schedule-edits-timestamps.test.ts +64 -0
  94. package/src/external-schedule-edits.ts +327 -0
  95. package/src/file-download-authz-dev-open.test.ts +135 -0
  96. package/src/file-download-authz.test.ts +404 -0
  97. package/src/file-download-date-bucket.test.ts +436 -0
  98. package/src/file-network-scope-dev-open.test.ts +97 -0
  99. package/src/file-network-scope.test.ts +732 -0
  100. package/src/group-membership-events-http.test.ts +264 -0
  101. package/src/group-messages-http.test.ts +482 -0
  102. package/src/group-messages.ts +297 -0
  103. package/src/health-host-disk-2756.test.ts +49 -0
  104. package/src/health-redaction.test.ts +685 -0
  105. package/src/host-supervisor-identity-http.test.ts +152 -0
  106. package/src/host-supervisor-identity.ts +92 -0
  107. package/src/host-supervisors-daemon-version.test.ts +137 -0
  108. package/src/http-gzip.test.ts +94 -0
  109. package/src/http-gzip.ts +112 -0
  110. package/src/hub-catalog-read-http.test.ts +187 -0
  111. package/src/hub-provider-config.test.ts +139 -0
  112. package/src/hub-provider-config.ts +105 -0
  113. package/src/hub-timestamp.test.ts +38 -0
  114. package/src/hub-timestamp.ts +27 -0
  115. package/src/human-dm.ts +215 -0
  116. package/src/human-inbox.ts +42 -0
  117. package/src/inbox-caller.ts +49 -0
  118. package/src/inbox-count-sse.test.ts +310 -0
  119. package/src/inbox-count.ts +29 -0
  120. package/src/index.ts +15 -2380
  121. package/src/list-host-supervisors.test.ts +5 -4
  122. package/src/mcp-context-cost-http.test.ts +127 -0
  123. package/src/mcp-inflight.test.ts +92 -0
  124. package/src/mcp-inflight.ts +38 -0
  125. package/src/mcp-projects-events-http.test.ts +162 -0
  126. package/src/mcp-route-label-http.test.ts +120 -0
  127. package/src/mcp-write-network-resolution.test.ts +432 -0
  128. package/src/member-audit-network-id-http.test.ts +93 -0
  129. package/src/member-presence-http.test.ts +210 -0
  130. package/src/messages-ack-by-agent-http.test.ts +142 -0
  131. package/src/migrate-sqlite-to-pg.test.ts +47 -0
  132. package/src/migrate-sqlite-to-pg.ts +263 -0
  133. package/src/model-auth-notify-http.test.ts +181 -0
  134. package/src/model-auth-notify.ts +116 -0
  135. package/src/network-name-http.test.ts +75 -0
  136. package/src/network-rules-http.test.ts +169 -0
  137. package/src/network-rules.ts +129 -0
  138. package/src/network-scope.ts +276 -0
  139. package/src/network-token-membership-http.test.ts +139 -0
  140. package/src/node-alias-control.ts +12 -0
  141. package/src/node-attrs-validate.ts +88 -0
  142. package/src/node-attrs.test.ts +258 -0
  143. package/src/node-caller-identity-http.test.ts +1083 -0
  144. package/src/node-create-request-status-http.test.ts +105 -0
  145. package/src/node-daemon-bindings.test.ts +132 -0
  146. package/src/node-daemon-bindings.ts +135 -0
  147. package/src/node-failure-alert.test.ts +150 -0
  148. package/src/node-failure-alert.ts +177 -0
  149. package/src/node-files-transport.test.ts +344 -0
  150. package/src/node-health-codex-login.test.ts +120 -0
  151. package/src/node-health-dispatch-http.test.ts +279 -0
  152. package/src/node-health-guard.ts +105 -0
  153. package/src/node-health-passthrough.test.ts +115 -0
  154. package/src/node-health-store.ts +101 -0
  155. package/src/node-id-alias.test.ts +190 -0
  156. package/src/node-identity-conflict-http.test.ts +269 -0
  157. package/src/node-identity-conflict.ts +142 -0
  158. package/src/node-identity-mismatch.test.ts +74 -0
  159. package/src/node-in-flight-tasks.ts +31 -0
  160. package/src/node-lifecycle-controllable.test.ts +64 -0
  161. package/src/node-lifecycle-controllable.ts +53 -0
  162. package/src/node-lifecycle-read-http.test.ts +250 -0
  163. package/src/node-lifecycle-read.ts +124 -0
  164. package/src/node-logs-transport.test.ts +263 -0
  165. package/src/node-peer-allowlist.test.ts +114 -0
  166. package/src/node-permissions-http.test.ts +345 -0
  167. package/src/node-permissions.ts +420 -0
  168. package/src/node-request-retention.test.ts +281 -0
  169. package/src/node-request-retention.ts +120 -0
  170. package/src/node-secret-rest-http.test.ts +190 -0
  171. package/src/node-serviceability.test.ts +86 -0
  172. package/src/node-serviceability.ts +124 -0
  173. package/src/node-session-control-http.test.ts +310 -0
  174. package/src/node-session-control.ts +258 -0
  175. package/src/node-skills-transport.test.ts +209 -0
  176. package/src/node-token-identity.ts +35 -0
  177. package/src/node-token-ownership.ts +51 -0
  178. package/src/node-token-privilege-http.test.ts +158 -0
  179. package/src/not-found-api-http.test.ts +67 -0
  180. package/src/observer-avatar-http.test.ts +442 -0
  181. package/src/observer-push.test.ts +252 -0
  182. package/src/opencode-catalog-report-http.test.ts +139 -0
  183. package/src/opencode-v2-catalog.test.ts +268 -0
  184. package/src/opencode-v2-catalog.ts +352 -0
  185. package/src/package-version-consistency.test.ts +25 -0
  186. package/src/parent-source-marker.test.ts +50 -0
  187. package/src/password-network-tokens.ts +25 -0
  188. package/src/peer-reply-atomic.test.ts +455 -0
  189. package/src/peer-reply-capability.test.ts +70 -0
  190. package/src/pg-worker.ts +87 -0
  191. package/src/project-dir-warn-clear-http.test.ts +132 -0
  192. package/src/project-viewer-can-http.test.ts +116 -0
  193. package/src/push.test.ts +20 -10
  194. package/src/push.ts +466 -13
  195. package/src/redact-tokens.test.ts +65 -0
  196. package/src/redact-tokens.ts +40 -0
  197. package/src/rename.ts +38 -10
  198. package/src/reply-target-derivation.test.ts +96 -0
  199. package/src/report-status-handover-capabilities-http.test.ts +124 -0
  200. package/src/report-status-host-schema.test.ts +235 -0
  201. package/src/report-status-resume-id-handover.test.ts +184 -0
  202. package/src/report-status-secret-keys.test.ts +140 -0
  203. package/src/require-explicit-test-db.ts +9 -0
  204. package/src/requirement-due-reminders-http.test.ts +620 -0
  205. package/src/requirement-due-reminders.ts +416 -0
  206. package/src/requirement-events-http.test.ts +268 -0
  207. package/src/requirement-events.test.ts +45 -0
  208. package/src/requirement-events.ts +144 -0
  209. package/src/requirement-notify.ts +165 -0
  210. package/src/requirement-participant-notify-http.test.ts +309 -0
  211. package/src/requirement-tag-ops-http.test.ts +425 -0
  212. package/src/requirement-tag-tree-http.test.ts +275 -0
  213. package/src/requirement-tag-tree.ts +127 -0
  214. package/src/requirement-tags.ts +102 -0
  215. package/src/requirements-abandoned-http.test.ts +236 -0
  216. package/src/requirements-comment-http.test.ts +167 -0
  217. package/src/requirements-completed-at-migration.test.ts +70 -0
  218. package/src/requirements-errors-mcp-http.test.ts +164 -0
  219. package/src/requirements-errors.ts +158 -0
  220. package/src/requirements-etag-http.test.ts +91 -0
  221. package/src/requirements-http.test.ts +709 -0
  222. package/src/requirements-last-event-http.test.ts +349 -0
  223. package/src/requirements-list-mcp-slim-http.test.ts +155 -0
  224. package/src/requirements-list-slim-http.test.ts +324 -0
  225. package/src/requirements-mcp.test.ts +163 -0
  226. package/src/requirements-migrate.ts +283 -0
  227. package/src/requirements-owner-strict-mcp-http.test.ts +145 -0
  228. package/src/requirements-people-http.test.ts +114 -0
  229. package/src/requirements-people-mcp-http.test.ts +231 -0
  230. package/src/requirements-people.ts +196 -0
  231. package/src/requirements-priority-lowest.test.ts +114 -0
  232. package/src/requirements-projects-parent-http.test.ts +123 -0
  233. package/src/requirements-search-http.test.ts +182 -0
  234. package/src/requirements-search.test.ts +32 -0
  235. package/src/requirements-search.ts +145 -0
  236. package/src/requirements-seq-http.test.ts +193 -0
  237. package/src/requirements-seq-migration.test.ts +63 -0
  238. package/src/requirements-start-date.test.ts +125 -0
  239. package/src/requirements-stats-http.test.ts +357 -0
  240. package/src/requirements-stats.ts +195 -0
  241. package/src/requirements-status-participants-http.test.ts +222 -0
  242. package/src/requirements-upgrade-e2e.test.ts +126 -0
  243. package/src/requirements-upgrade-migration.test.ts +98 -0
  244. package/src/requirements.ts +2027 -0
  245. package/src/resolve-port.test.ts +57 -0
  246. package/src/resolve-port.ts +44 -0
  247. package/src/response-charset.test.ts +130 -0
  248. package/src/rest-alias-network-fallback-http.test.ts +123 -0
  249. package/src/rest-alias-network-fallback.test.ts +60 -0
  250. package/src/rest-alias-network-fallback.ts +65 -0
  251. package/src/rest-explicit-columns-http.test.ts +266 -0
  252. package/src/rest-identity.test.ts +130 -0
  253. package/src/rest-identity.ts +141 -0
  254. package/src/rest-projections.ts +72 -0
  255. package/src/rest-read-network-real-chain.test.ts +97 -0
  256. package/src/rest-write-network-resolution.test.ts +133 -0
  257. package/src/restart-readiness-http.test.ts +121 -0
  258. package/src/restricted-files.ts +76 -0
  259. package/src/retention-first-sweep-quiet.test.ts +31 -0
  260. package/src/retention.test.ts +100 -40
  261. package/src/retention.ts +423 -104
  262. package/src/route-callers-http.test.ts +120 -0
  263. package/src/route-timing.test.ts +211 -0
  264. package/src/route-timing.ts +262 -0
  265. package/src/rules-file-duplicate-alias.test.ts +234 -0
  266. package/src/rules-file-session-target.test.ts +207 -0
  267. package/src/rules-file-transport.test.ts +237 -0
  268. package/src/runtime-label.test.ts +22 -0
  269. package/src/runtime-label.ts +21 -0
  270. package/src/runtime-readiness.ts +90 -0
  271. package/src/schedule-agent-mcp-http.test.ts +391 -0
  272. package/src/schedule-agent.ts +192 -0
  273. package/src/schedule-starved.test.ts +92 -0
  274. package/src/schedule-starved.ts +114 -0
  275. package/src/scheduled-backoff-http.test.ts +193 -0
  276. package/src/scheduled-backoff.ts +64 -0
  277. package/src/scheduled-doorbell-nodeless-session.test.ts +134 -0
  278. package/src/scheduled-failure-backoff-2622.test.ts +145 -0
  279. package/src/scheduled-failure-code.test.ts +73 -0
  280. package/src/scheduled-failure-code.ts +105 -0
  281. package/src/scheduled-failures-http.test.ts +279 -0
  282. package/src/scheduled-failures.ts +377 -0
  283. package/src/scheduled-noprogress-backoff-2622.test.ts +133 -0
  284. package/src/scheduled-offline-backoff-probe.test.ts +56 -0
  285. package/src/scheduled-offline.test.ts +131 -0
  286. package/src/scheduled-offline.ts +66 -0
  287. package/src/scheduled-outcome-guidance-http.test.ts +139 -0
  288. package/src/scheduled-outcome-guidance.ts +9 -0
  289. package/src/scheduled-reply-unread-http.test.ts +212 -0
  290. package/src/scheduled-requirement-wake-http.test.ts +279 -0
  291. package/src/scheduled-requirement-wake.ts +125 -0
  292. package/src/scheduled-run-terminal.test.ts +268 -0
  293. package/src/scheduled-skip-blocking-task.test.ts +120 -0
  294. package/src/scheduled-skip-path-backoff-2622.test.ts +98 -0
  295. package/src/scheduled-stuck-http.test.ts +312 -0
  296. package/src/scheduled-stuck-notice-cap.test.ts +80 -0
  297. package/src/scheduled-stuck.ts +219 -0
  298. package/src/scheduled-tasks-http.test.ts +679 -0
  299. package/src/scheduled-tasks.ts +959 -0
  300. package/src/scheduled-work-outcome-http.test.ts +154 -0
  301. package/src/scheduled-work-outcome.ts +50 -0
  302. package/src/scoped-secrets.ts +139 -0
  303. package/src/send-dedup-request-id.test.ts +229 -0
  304. package/src/send-reply-agent-warning.test.ts +202 -0
  305. package/src/send-reply-alias-optional.test.ts +131 -0
  306. package/src/send-reply-attachments.test.ts +458 -0
  307. package/src/send_dedup.test.ts +54 -0
  308. package/src/send_dedup.ts +52 -6
  309. package/src/serve-error.test.ts +38 -0
  310. package/src/serve-error.ts +27 -0
  311. package/src/server.ts +6028 -0
  312. package/src/session-task-on-dispatch.ts +14 -0
  313. package/src/session-token-ownership-http.test.ts +122 -0
  314. package/src/shared/codex-inventory.ts +41 -0
  315. package/src/shared/daemon-provider-login.ts +31 -0
  316. package/src/shared/daemon-provider-snapshot.ts +52 -0
  317. package/src/shared/external-schedule-contract.ts +60 -0
  318. package/src/shared/node-name.test.ts +62 -0
  319. package/src/shared/node-name.ts +161 -0
  320. package/src/shared/provider-application.ts +29 -0
  321. package/src/shared/provider-collection.ts +14 -0
  322. package/src/shared/provider-initialization.ts +8 -0
  323. package/src/shared/reserved-env-drift.test.ts +10 -0
  324. package/src/shared/scoped-secret-contract.ts +5 -0
  325. package/src/shared/task-content-limit-drift.test.ts +28 -0
  326. package/src/shared/task-content-limit.ts +25 -0
  327. package/src/side-thread-command-transport.test.ts +312 -0
  328. package/src/side-thread-command-transport.ts +318 -0
  329. package/src/side-thread-http-integration.test.ts +233 -0
  330. package/src/side-thread-http.ts +504 -0
  331. package/src/side-thread-production.test.ts +72 -0
  332. package/src/side-thread-production.ts +118 -0
  333. package/src/side-thread.test.ts +1067 -0
  334. package/src/side-thread.ts +2499 -0
  335. package/src/skillhub-http.test.ts +108 -0
  336. package/src/sqlite-close-checkpoint.test.ts +78 -0
  337. package/src/start-node.test.ts +264 -0
  338. package/src/status-alias-filter-http.test.ts +106 -0
  339. package/src/status-alias-resolver-http.test.ts +163 -0
  340. package/src/status-alias-resolver.ts +19 -0
  341. package/src/status-node-id-filter-http.test.ts +161 -0
  342. package/src/status-read-cache-http.test.ts +229 -0
  343. package/src/status-read-cache.ts +122 -0
  344. package/src/stop-delete-node.test.ts +567 -1
  345. package/src/task-access-http.test.ts +402 -0
  346. package/src/task-access.ts +420 -0
  347. package/src/task-activity.ts +60 -0
  348. package/src/task-auth-origin-http.test.ts +93 -0
  349. package/src/task-auth-origin.test.ts +24 -0
  350. package/src/task-auth-origin.ts +7 -0
  351. package/src/task-consumption.test.ts +482 -0
  352. package/src/task-diagnostic-http.test.ts +149 -0
  353. package/src/task-diagnostic.test.ts +115 -0
  354. package/src/task-diagnostic.ts +118 -0
  355. package/src/task-expiry-notice-http.test.ts +287 -0
  356. package/src/task-expiry-notice.ts +315 -0
  357. package/src/task-idempotency-mcp.test.ts +142 -0
  358. package/src/task-idempotency.test.ts +76 -0
  359. package/src/task-idempotency.ts +81 -0
  360. package/src/task-late-replies.ts +54 -0
  361. package/src/task-late-reply-http.test.ts +152 -0
  362. package/src/task-lifecycle-watcher-busy.test.ts +114 -0
  363. package/src/task-lifecycle-watcher.test.ts +204 -0
  364. package/src/task-lifecycle-watcher.ts +109 -0
  365. package/src/task-network-resolution-http.test.ts +140 -0
  366. package/src/task-offline-delivery-2668.test.ts +119 -0
  367. package/src/task-offline-delivery.ts +81 -0
  368. package/src/task-orphan-http.test.ts +287 -0
  369. package/src/task-orphan.ts +119 -0
  370. package/src/task-queue-ahead-http.test.ts +309 -0
  371. package/src/task-queue-ahead-scale.test.ts +236 -0
  372. package/src/task-queue-ahead.ts +186 -0
  373. package/src/task-rejection-log-http.test.ts +160 -0
  374. package/src/task-rejection-log.ts +49 -0
  375. package/src/task-sender-http.test.ts +143 -0
  376. package/src/task-stale-open-http.test.ts +290 -0
  377. package/src/task-stale-open.ts +103 -0
  378. package/src/tasks-pagination-http.test.ts +141 -0
  379. package/src/team-rules-status-http.test.ts +90 -0
  380. package/src/team-rules-status.test.ts +59 -0
  381. package/src/team-rules-status.ts +72 -0
  382. package/src/tool-audience-http.test.ts +230 -0
  383. package/src/tool-audience.ts +120 -0
  384. package/src/tools-list-json-schema.test.ts +94 -0
  385. package/src/tools.ts +4226 -405
  386. package/src/upload-early-reject-guard.test.ts +155 -0
  387. package/src/uploads-http.test.ts +97 -15
  388. package/src/uploads.ts +103 -6
  389. package/src/user-avatar-http.test.ts +74 -0
  390. package/src/user-avatar-image.ts +160 -0
  391. package/src/user-avatar-migration.test.ts +25 -0
  392. package/src/user-avatar-upload-http.test.ts +348 -0
  393. package/src/user-inbox-by-agent-http.test.ts +161 -0
  394. package/src/user-inbox-netid-notnull.test.ts +122 -0
  395. package/src/user-inbox-read-http.test.ts +223 -0
  396. package/src/user-inbox-schema.test.ts +54 -0
  397. package/src/version-stats.test.ts +66 -0
  398. package/src/version-stats.ts +109 -0
@@ -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,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
+ }
@@ -0,0 +1,287 @@
1
+ // #758 —— 孤儿任务:acked / running 超过阈值,接收节点在开工之后回到 idle / offline 却没回复。
2
+ // HTTP 集成测试(真实 Bun.serve,私有端口,临时库);test2123 在真实 PostgreSQL 上原样再跑一遍。
3
+ //
4
+ // 任务经真入口 POST /api/task 派出,目标用自己的节点令牌经 /mcp ack_inbox / report_status 推进;
5
+ // 只把任务的时间戳往前拨,然后调巡检(server.ts patrolOrphanTasks,5 分钟定时器调的就是它)。
6
+ //
7
+ // 钉住:
8
+ // 1. 孤儿(agent 派的)→ 记一条 task.orphan_suspected、发一条 inbox reply 给派活节点,任务状态不变;第二次巡检不重发。
9
+ // 2. 人派的孤儿 → user_inbox 一条。
10
+ // 3. 节点 working → 不标。
11
+ // 4. 不到阈值 → 不标;阈值可由 COMMHUB_ORPHAN_TASK_MINUTES 改,0 = 关。
12
+ // 5. 节点开工之后没再报过状态 → 不标。
13
+ // 6. scheduler 派的孤儿 → 标,但不通知。
14
+ // 7. TTL 巡检(patrolExpiredTasks)不碰孤儿阶段:不写 orphan 事件。
15
+ //
16
+ // 跑法:cd server && bun test src/task-orphan-http.test.ts
17
+
18
+ import { afterAll, beforeAll, beforeEach, describe, expect, test } from "bun:test";
19
+ import { mkdtempSync, rmSync } from "node:fs";
20
+ import { tmpdir } from "node:os";
21
+ import { join } from "node:path";
22
+
23
+ const DIR = mkdtempSync(join(tmpdir(), "anet-orphan-"));
24
+ process.env.COMMHUB_DB ||= join(DIR, "hub.db");
25
+ process.env.COMMHUB_UPLOADS_DIR = join(DIR, "uploads");
26
+ process.env.HOST = "127.0.0.1";
27
+ const ENV = "COMMHUB_ORPHAN_TASK_MINUTES";
28
+ const LOOKBACK_ENV = "COMMHUB_ORPHAN_TASK_LOOKBACK_HOURS";
29
+ delete process.env[ENV];
30
+ delete process.env[LOOKBACK_ENV];
31
+ const PW = "Orphan123!xyz";
32
+ const stamp = Date.now();
33
+
34
+ let db: any;
35
+ let patrol: () => void;
36
+ let ttlPatrol: () => void;
37
+ let flag: (o?: { minutes?: number | null }) => Array<{ task_id: string; notified: string | null }>;
38
+ let hub: any = null;
39
+ let BASE = "";
40
+ let NET = "";
41
+ let umaToken = "", umaId = "";
42
+ let EVENT = "";
43
+ type Node = { alias: string; nodeId: string; token: string };
44
+ const nodes: Record<"sender" | "target", Node> = {} as any;
45
+
46
+ async function send(token: string, method: string, path: string, payload?: unknown) {
47
+ const res = await fetch(`${BASE}${path}`, {
48
+ method,
49
+ headers: { Authorization: `Bearer ${token}`, "Content-Type": "application/json" },
50
+ body: payload === undefined ? undefined : JSON.stringify(payload),
51
+ });
52
+ return { status: res.status, body: await res.json().catch(() => null) as any };
53
+ }
54
+ async function tool(token: string, name: string, args: Record<string, unknown>) {
55
+ const res = await fetch(`${BASE}/mcp`, {
56
+ method: "POST",
57
+ headers: { Authorization: `Bearer ${token}`, "Content-Type": "application/json", Accept: "application/json, text/event-stream", "MCP-Protocol-Version": "2025-03-26" },
58
+ body: JSON.stringify({ jsonrpc: "2.0", id: 1, method: "tools/call", params: { name, arguments: args } }),
59
+ });
60
+ const raw = await res.text();
61
+ const data = raw.split("\n").filter((x) => x.startsWith("data:"));
62
+ const payload = data.length ? JSON.parse(data.at(-1)!.slice(5).trim()) : JSON.parse(raw);
63
+ return JSON.parse(payload.result.content[0].text);
64
+ }
65
+
66
+ let seq = 0;
67
+ async function dispatch(token: string): Promise<{ id: string; content: string }> {
68
+ const content = `orphan case ${stamp} #${++seq}`;
69
+ const r = await send(token, "POST", "/api/task", { alias: nodes.target.alias, task: content, network_id: NET });
70
+ expect(r.status).toBe(200);
71
+ expect(r.body.ok).toBe(true);
72
+ return { id: r.body.task_id, content };
73
+ }
74
+ async function ack(taskId: string) {
75
+ const r = await tool(nodes.target.token, "ack_inbox", { alias: nodes.target.alias, message_id: taskId, network_id: NET });
76
+ expect(r.ok).toBe(true);
77
+ expect(taskRow(taskId).status).toBe("acked");
78
+ }
79
+ async function targetStatus(status: string, task?: string) {
80
+ const r = await tool(nodes.target.token, "report_status", { resume_id: `sdk-${nodes.target.nodeId}`, alias: nodes.target.alias, status, task, node_id: nodes.target.nodeId, network_id: NET });
81
+ expect(r.ok).toBe(true);
82
+ }
83
+ /** 任务的时间戳拨到 `minutes` 分钟前(节点的 last_seen_at 不动 = 「之后还报过状态」)。 */
84
+ function age(taskId: string, minutes: number) {
85
+ const off = `-${minutes * 60} seconds`;
86
+ db.run(
87
+ `UPDATE tasks SET created_at = datetime('now', ?2),
88
+ delivered_at = CASE WHEN delivered_at IS NULL THEN NULL ELSE datetime('now', ?2) END,
89
+ started_at = CASE WHEN started_at IS NULL THEN NULL ELSE datetime('now', ?2) END,
90
+ consumed_at = CASE WHEN consumed_at IS NULL THEN NULL ELSE datetime('now', ?2) END
91
+ WHERE task_id = ?1`,
92
+ [taskId, off],
93
+ );
94
+ }
95
+ const taskRow = (taskId: string) => db.get("SELECT status, result, completed_at FROM tasks WHERE task_id = ?1", taskId) as { status: string; result: string | null; completed_at: string | null };
96
+ const orphanEvents = (taskId: string) => db.all("SELECT from_status, to_status, event_type, event_key, actor, detail FROM task_events WHERE task_id = ?1 AND event_type = ?2", taskId, EVENT) as any[];
97
+ const agentNotices = () => db.all("SELECT in_reply_to, type, requires_response, content FROM inbox WHERE network_id = ?1 AND session_name = ?2 AND from_session = 'hub'", NET, nodes.sender.alias) as any[];
98
+ const userNotices = () => db.all("SELECT kind, from_session, content FROM user_inbox WHERE network_id = ?1 AND user_id = ?2", NET, umaId) as any[];
99
+
100
+ function withMinutes<T>(value: string | undefined, fn: () => T): T {
101
+ const prev = process.env[ENV];
102
+ if (value === undefined) delete process.env[ENV]; else process.env[ENV] = value;
103
+ try { return fn(); } finally { if (prev === undefined) delete process.env[ENV]; else process.env[ENV] = prev; }
104
+ }
105
+
106
+ beforeAll(async () => {
107
+ ({ db } = await import("./db.js"));
108
+ const { addNetworkMember, createNetworkTokenForNode, register } = await import("./auth.js");
109
+ const orphan: any = await import("./task-orphan.js");
110
+ EVENT = orphan.ORPHAN_EVENT_TYPE;
111
+ flag = orphan.flagOrphanTasks;
112
+ const boss = register(`orphan_boss_${stamp}`, PW);
113
+ expect(boss.ok).toBe(true);
114
+ NET = boss.network_id!;
115
+ const bossId = boss.user!.user_id;
116
+ const uma = register(`orphan_uma_${stamp}`, PW);
117
+ umaToken = uma.token!; umaId = uma.user!.user_id;
118
+ expect(addNetworkMember(NET, umaId, "member", bossId, { agentAccess: "all" }).ok).toBe(true);
119
+ for (const key of ["sender", "target"] as const) {
120
+ const alias = `orphan-${key}-${stamp}`;
121
+ const nodeId = `n_orphan_${key}_${stamp}`;
122
+ const minted = createNetworkTokenForNode(bossId, NET, alias, nodeId);
123
+ expect(minted.ok).toBe(true);
124
+ nodes[key] = { alias, nodeId, token: minted.token! };
125
+ }
126
+ const mod: any = await import("./server.js");
127
+ patrol = mod.patrolOrphanTasks;
128
+ ttlPatrol = mod.patrolExpiredTasks;
129
+ hub = mod.bootServer({ port: 0, hostname: "127.0.0.1" });
130
+ BASE = `http://127.0.0.1:${hub.port}`;
131
+ for (const n of Object.values(nodes)) {
132
+ const r = await tool(n.token, "report_status", { resume_id: `sdk-${n.nodeId}`, alias: n.alias, status: "idle", node_id: n.nodeId, network_id: NET });
133
+ expect(r.ok).toBe(true);
134
+ }
135
+ }, 30_000);
136
+
137
+ beforeEach(() => {
138
+ db.run("UPDATE tasks SET status = 'replied', completed_at = datetime('now') WHERE network_id = ?1 AND status IN ('created', 'delivered', 'acked', 'running')", [NET]);
139
+ db.run("DELETE FROM inbox WHERE network_id = ?1 AND from_session = 'hub'", [NET]);
140
+ db.run("DELETE FROM user_inbox WHERE network_id = ?1", [NET]);
141
+ // 上一条用例可能把目标留在 offline / working:派活前先让它回到 idle(否则 /api/task 回 202 排队)。
142
+ db.run("UPDATE sessions SET status = 'idle' WHERE alias = ?1 AND network_id = ?2", [nodes.target.alias, NET]);
143
+ });
144
+
145
+ afterAll(() => {
146
+ try { hub?.stop?.(true); } catch {}
147
+ try { rmSync(DIR, { recursive: true, force: true }); } catch {}
148
+ });
149
+
150
+ describe("#758 orphan detected", () => {
151
+ test("acked 2h, node idle since → one event + one inbox reply to the sending agent; status unchanged; second pass silent", async () => {
152
+ const t = await dispatch(nodes.sender.token);
153
+ await ack(t.id);
154
+ age(t.id, 120);
155
+ await targetStatus("idle");
156
+
157
+ withMinutes(undefined, () => patrol());
158
+
159
+ expect(taskRow(t.id)).toMatchObject({ status: "acked", result: null, completed_at: null });
160
+ const ev = orphanEvents(t.id);
161
+ expect(ev.length).toBe(1);
162
+ expect(ev[0]).toMatchObject({ from_status: "acked", to_status: "acked", event_key: EVENT, actor: "patrol" });
163
+ expect(ev[0].detail).toContain(`notify: agent ${nodes.sender.alias}`);
164
+ const n = agentNotices();
165
+ expect(n.length).toBe(1);
166
+ expect(n[0]).toMatchObject({ in_reply_to: t.id, type: "reply", requires_response: "none" });
167
+ expect(n[0].content).toContain(nodes.target.alias);
168
+ expect(n[0].content).toContain("没有改这条任务的状态");
169
+
170
+ // 第二、三次巡检:不重发、不重记。
171
+ withMinutes(undefined, () => { patrol(); patrol(); });
172
+ expect(orphanEvents(t.id).length).toBe(1);
173
+ expect(agentNotices().length).toBe(1);
174
+ expect(taskRow(t.id).status).toBe("acked");
175
+ });
176
+
177
+ test("running task, node went offline afterwards → flagged; a human sender gets one user_inbox notice", async () => {
178
+ const t = await dispatch(umaToken);
179
+ await ack(t.id);
180
+ await targetStatus("working", t.content);
181
+ expect(taskRow(t.id).status).toBe("running");
182
+ age(t.id, 90);
183
+ await targetStatus("idle");
184
+ db.run("UPDATE sessions SET status = 'offline' WHERE alias = ?1 AND network_id = ?2", [nodes.target.alias, NET]);
185
+
186
+ const out = withMinutes(undefined, () => flag());
187
+ expect(out).toEqual([{ task_id: t.id, notified: "user" }]);
188
+ expect(taskRow(t.id).status).toBe("running");
189
+ const u = userNotices();
190
+ expect(u.length).toBe(1);
191
+ expect(u[0]).toMatchObject({ kind: "task_orphan_suspected", from_session: nodes.target.alias });
192
+ expect(withMinutes(undefined, () => flag())).toEqual([]);
193
+ expect(userNotices().length).toBe(1);
194
+ });
195
+ });
196
+
197
+ describe("#758 not orphans", () => {
198
+ test("node is working (busy) → not flagged", async () => {
199
+ const t = await dispatch(nodes.sender.token);
200
+ await ack(t.id);
201
+ age(t.id, 120);
202
+ await targetStatus("working", "something else");
203
+ withMinutes(undefined, () => patrol());
204
+ expect(orphanEvents(t.id).length).toBe(0);
205
+ expect(agentNotices().length).toBe(0);
206
+ });
207
+
208
+ test("younger than the threshold → not flagged; env lowers it; 0 turns it off", async () => {
209
+ const t = await dispatch(nodes.sender.token);
210
+ await ack(t.id);
211
+ age(t.id, 45);
212
+ await targetStatus("idle");
213
+ withMinutes(undefined, () => patrol());
214
+ expect(orphanEvents(t.id).length).toBe(0);
215
+ withMinutes("0", () => patrol());
216
+ expect(orphanEvents(t.id).length).toBe(0);
217
+ withMinutes("30", () => patrol());
218
+ expect(orphanEvents(t.id).length).toBe(1);
219
+ expect(agentNotices().length).toBe(1);
220
+ });
221
+
222
+ test("node has not reported any status since the task started → not flagged", async () => {
223
+ const t = await dispatch(nodes.sender.token);
224
+ await ack(t.id);
225
+ age(t.id, 120);
226
+ await targetStatus("idle");
227
+ db.run("UPDATE sessions SET last_seen_at = datetime('now', '-180 minutes'), updated_at = datetime('now', '-180 minutes') WHERE alias = ?1 AND network_id = ?2", [nodes.target.alias, NET]);
228
+ withMinutes(undefined, () => patrol());
229
+ expect(orphanEvents(t.id).length).toBe(0);
230
+ expect(agentNotices().length).toBe(0);
231
+ });
232
+ });
233
+
234
+ describe("#758 lookback cap", () => {
235
+ test("a 10-day-old orphan is not flagged by default (72h cap) but is with lookback 0", async () => {
236
+ // 10 天前的那条直接写库(目标上已有开着的任务时 /api/task 回 202 排队,而这里要两条同时开着)。
237
+ const t = { id: `orphan_old_${stamp}` };
238
+ db.run(
239
+ `INSERT INTO tasks (task_id, from_name, from_node_id, to_name, to_node_id, priority, status, content, requires_response, created_at, delivered_at, network_id)
240
+ VALUES (?1, ?2, ?3, ?4, ?5, 'normal', 'acked', 'ten days old', 'reply', datetime('now', '-240 hours'), datetime('now', '-240 hours'), ?6)`,
241
+ [t.id, nodes.sender.alias, nodes.sender.nodeId, nodes.target.alias, nodes.target.nodeId, NET],
242
+ );
243
+ await targetStatus("idle");
244
+ withMinutes(undefined, () => patrol());
245
+ expect(orphanEvents(t.id).length).toBe(0);
246
+ expect(agentNotices().length).toBe(0);
247
+ // 71 小时的照常标出:上限只挡更老的。
248
+ const recent = await dispatch(nodes.sender.token);
249
+ await ack(recent.id);
250
+ age(recent.id, 71 * 60);
251
+ await targetStatus("idle");
252
+ withMinutes(undefined, () => patrol());
253
+ expect(orphanEvents(recent.id).length).toBe(1);
254
+ expect(orphanEvents(t.id).length).toBe(0);
255
+ process.env[LOOKBACK_ENV] = "0";
256
+ try { withMinutes(undefined, () => patrol()); } finally { delete process.env[LOOKBACK_ENV]; }
257
+ expect(orphanEvents(t.id).length).toBe(1);
258
+ expect(agentNotices().map((n) => n.in_reply_to).sort()).toEqual([recent.id, t.id].sort());
259
+ });
260
+ });
261
+
262
+ describe("#758 scheduler and regression", () => {
263
+ test("scheduler-sent orphan → flagged, sender not notified", async () => {
264
+ const id = `orphan_sched_${stamp}`;
265
+ db.run(
266
+ `INSERT INTO tasks (task_id, from_name, to_name, to_node_id, priority, status, content, requires_response, created_at, delivered_at, network_id)
267
+ VALUES (?1, 'scheduler', ?2, ?3, 'normal', 'acked', 'scheduled run', 'reply', datetime('now', '-120 minutes'), datetime('now', '-120 minutes'), ?4)`,
268
+ [id, nodes.target.alias, nodes.target.nodeId, NET],
269
+ );
270
+ await targetStatus("idle");
271
+ const out = withMinutes(undefined, () => flag());
272
+ expect(out).toEqual([{ task_id: id, notified: null }]);
273
+ expect(orphanEvents(id)[0].detail).toContain("notify: none (scheduler)");
274
+ expect(agentNotices().length).toBe(0);
275
+ expect(userNotices().length).toBe(0);
276
+ });
277
+
278
+ test("the TTL patrol alone does not run the orphan phase", async () => {
279
+ const t = await dispatch(nodes.sender.token);
280
+ await ack(t.id);
281
+ age(t.id, 120);
282
+ await targetStatus("idle");
283
+ withMinutes(undefined, () => ttlPatrol());
284
+ expect(orphanEvents(t.id).length).toBe(0);
285
+ expect(taskRow(t.id).status).toBe("acked");
286
+ });
287
+ });