@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,327 @@
1
+ import { db } from "./db.js";
2
+ import { getUserNetworkRole } from "./auth.js";
3
+ import { pushEvent } from "./push.js";
4
+ import { parseExternalSchedulePatch, type ExternalSchedulePatch } from "./shared/external-schedule-contract.js";
5
+ import { parseHubTimestamp } from "./hub-timestamp";
6
+
7
+ type Auth = {
8
+ userId: string;
9
+ networkId: string | null;
10
+ username: string;
11
+ tokenId: string | null;
12
+ } | null;
13
+
14
+ export type ExternalScheduleEditContext = {
15
+ req: Request;
16
+ url: URL;
17
+ auth: Auth;
18
+ isUserToken: boolean;
19
+ isNodeToken: boolean;
20
+ };
21
+
22
+ type NodeRow = {
23
+ node_id: string;
24
+ alias: string | null;
25
+ network_id: string | null;
26
+ owner_user_id: string | null;
27
+ };
28
+
29
+ type EditRow = {
30
+ intent_id: string;
31
+ network_id: string;
32
+ node_id: string;
33
+ schedule_id: string;
34
+ base_revision: number;
35
+ patch_json: string;
36
+ status: string;
37
+ expires_at: number;
38
+ created_at: number;
39
+ delivered_at: number | null;
40
+ acked_at: number | null;
41
+ created_by_user: string;
42
+ created_by_token: string;
43
+ consumed_by_token: string | null;
44
+ result_revision: number | null;
45
+ error_code: string | null;
46
+ };
47
+
48
+ const INTENT_TTL_MS = 5 * 60_000;
49
+ const NODE_ID_RE = /^[A-Za-z0-9][A-Za-z0-9._-]{0,199}$/;
50
+ const SCHEDULE_ID_RE = /^[A-Za-z0-9][A-Za-z0-9._-]{0,127}$/;
51
+
52
+ function error(error: string, status: number, extra: Record<string, unknown> = {}): Response {
53
+ return Response.json({ ok: false, error, ...extra }, { status });
54
+ }
55
+
56
+ async function bodyObject(req: Request): Promise<Record<string, unknown>> {
57
+ const value = await req.json();
58
+ if (!value || typeof value !== "object" || Array.isArray(value)) throw new Error("invalid_json");
59
+ return value as Record<string, unknown>;
60
+ }
61
+
62
+ function exactKeys(obj: Record<string, unknown>, allowed: readonly string[]): boolean {
63
+ const set = new Set(allowed);
64
+ return Object.keys(obj).every((key) => set.has(key));
65
+ }
66
+
67
+ function nodeRow(nodeId: string): NodeRow | null {
68
+ return db.get<NodeRow>(
69
+ "SELECT node_id, alias, network_id, owner_user_id FROM nodes WHERE node_id = ?1",
70
+ nodeId,
71
+ ) ?? null;
72
+ }
73
+
74
+ function requireOwner(ctx: ExternalScheduleEditContext, node: NodeRow, networkId: unknown): Response | null {
75
+ if (!ctx.isUserToken || !ctx.auth?.tokenId) return error("user_token_required", 403);
76
+ if (!node.owner_user_id) return error("node_owner_unclaimed", 409);
77
+ if (ctx.auth.userId !== node.owner_user_id) return error("node_owner_required", 403);
78
+ if (typeof networkId !== "string" || networkId !== node.network_id) return error("cross_network_node", 403);
79
+ if (!getUserNetworkRole(ctx.auth.userId, networkId)) return error("network_membership_required", 403);
80
+ return null;
81
+ }
82
+
83
+ function requireBoundNode(ctx: ExternalScheduleEditContext, node: NodeRow): Response | null {
84
+ if (!ctx.isNodeToken || !ctx.auth?.tokenId) return error("network_token_required", 403);
85
+ const token = db.get<{ token_id: string; user_id: string; network_id: string | null; name: string; bound_node_id: string | null }>(
86
+ "SELECT token_id, user_id, network_id, name, bound_node_id FROM api_tokens WHERE token_id = ?1",
87
+ ctx.auth.tokenId,
88
+ );
89
+ if (!token || token.bound_node_id !== node.node_id || token.network_id !== node.network_id || token.user_id !== node.owner_user_id) {
90
+ return error("node_token_binding_required", 403);
91
+ }
92
+ return null;
93
+ }
94
+
95
+ function reportedSchedule(node: NodeRow, scheduleId: string): Record<string, unknown> | null {
96
+ const row = db.get<{ external_schedules: string }>(
97
+ `SELECT external_schedules FROM sessions
98
+ WHERE node_id = ?1 AND network_id = ?2 AND external_schedules IS NOT NULL
99
+ ORDER BY updated_at DESC LIMIT 1`,
100
+ node.node_id,
101
+ node.network_id,
102
+ );
103
+ if (!row) return null;
104
+ try {
105
+ const snapshot = JSON.parse(row.external_schedules) as any;
106
+ if (!Array.isArray(snapshot?.schedules)) return null;
107
+ return snapshot.schedules.find((entry: any) => entry?.id === scheduleId) ?? null;
108
+ } catch {
109
+ return null;
110
+ }
111
+ }
112
+
113
+ // 🔴 #1650 —— 这些列是 SQLite `datetime('now')` 家族:**UTC 但不带时区标记**。
114
+ // `new Date("2026-08-30 21:04:11")` 会按**本机时区**解析(ES 规范:带时间且无偏移
115
+ // 的形式视为本地时间),而且不报错 —— 于是发给 API 消费方的是一个错的时刻,
116
+ // 误差就是这台机器的 offset。
117
+ // 另外原写法在字段是垃圾串时 `new Date(x).toISOString()` 会**抛 RangeError**,
118
+ // 足以把这个接口打成 500;`parseHubTimestamp` 解析失败返回 null,这里也返回 null。
119
+ // 复用 server.ts:1010 已在用的那个 helper,不自造第二套判据。
120
+ function hubIso(raw: unknown): string | null {
121
+ const ms = parseHubTimestamp(raw);
122
+ return ms === null ? null : new Date(ms).toISOString();
123
+ }
124
+
125
+ function publicEdit(row: EditRow): Record<string, unknown> {
126
+ let patch: ExternalSchedulePatch = {};
127
+ try { patch = JSON.parse(row.patch_json); } catch {}
128
+ return {
129
+ intent_id: row.intent_id,
130
+ node_id: row.node_id,
131
+ schedule_id: row.schedule_id,
132
+ base_revision: row.base_revision,
133
+ patch,
134
+ status: row.status,
135
+ expires_at: hubIso(row.expires_at),
136
+ created_at: hubIso(row.created_at),
137
+ delivered_at: hubIso(row.delivered_at),
138
+ acked_at: hubIso(row.acked_at),
139
+ result_revision: row.result_revision,
140
+ error_code: row.error_code,
141
+ };
142
+ }
143
+
144
+ function audit(
145
+ userId: string | null,
146
+ username: string | null,
147
+ action: string,
148
+ intentId: string,
149
+ networkId: string,
150
+ detail: Record<string, unknown>,
151
+ ): void {
152
+ db.run(
153
+ `INSERT INTO audit_log (user_id, username, action, target_type, target_id, detail, network_id)
154
+ VALUES (?1, ?2, ?3, 'external_schedule_edit', ?4, ?5, ?6)`,
155
+ [userId, username, action, intentId, JSON.stringify(detail), networkId],
156
+ );
157
+ }
158
+
159
+ function expireOpenIntents(node: NodeRow, now: number): void {
160
+ const expired = db.all<EditRow>(
161
+ "SELECT * FROM external_schedule_edits WHERE node_id = ?1 AND network_id = ?2 AND status IN ('pending', 'delivered') AND expires_at <= ?3",
162
+ node.node_id,
163
+ node.network_id,
164
+ now,
165
+ );
166
+ for (const row of expired) {
167
+ const changed = db.run(
168
+ "UPDATE external_schedule_edits SET status = 'expired', acked_at = ?1, error_code = 'intent_expired' WHERE intent_id = ?2 AND status IN ('pending', 'delivered') AND expires_at <= ?1",
169
+ [now, row.intent_id],
170
+ );
171
+ if (changed.changes === 1) {
172
+ audit(row.created_by_user, null, "external_schedule.edit_expired", row.intent_id, row.network_id, {
173
+ node_id: row.node_id, schedule_id: row.schedule_id, base_revision: row.base_revision, error_code: "intent_expired",
174
+ });
175
+ }
176
+ }
177
+ }
178
+
179
+ export async function handleExternalScheduleEditRequest(ctx: ExternalScheduleEditContext): Promise<Response | null> {
180
+ const match = ctx.url.pathname.match(/^\/api\/nodes\/([^/]+)\/external-schedule-edits(?:\/(pending|[^/]+)(?:\/(ack))?)?$/);
181
+ if (!match) return null;
182
+ const nodeId = decodeURIComponent(match[1]);
183
+ if (!NODE_ID_RE.test(nodeId)) return error("invalid_node_id", 400);
184
+ const tail = match[2] || null;
185
+ const ack = match[3] === "ack";
186
+ const node = nodeRow(nodeId);
187
+ if (!node) return error("node_not_found", 404);
188
+
189
+ if (tail === "pending" && ctx.req.method === "GET") {
190
+ const denied = requireBoundNode(ctx, node);
191
+ if (denied) return denied;
192
+ const now = Date.now();
193
+ const intent = db.transaction(() => {
194
+ expireOpenIntents(node, now);
195
+ const already = db.get<EditRow>(
196
+ `SELECT * FROM external_schedule_edits
197
+ WHERE node_id = ?1 AND network_id = ?2 AND status = 'delivered' AND consumed_by_token = ?3
198
+ ORDER BY delivered_at ASC LIMIT 1`,
199
+ node.node_id, node.network_id, ctx.auth!.tokenId,
200
+ );
201
+ if (already) return already;
202
+ const pending = db.get<EditRow>(
203
+ `SELECT * FROM external_schedule_edits
204
+ WHERE node_id = ?1 AND network_id = ?2 AND status = 'pending' AND expires_at > ?3
205
+ ORDER BY created_at ASC LIMIT 1`,
206
+ node.node_id, node.network_id, now,
207
+ );
208
+ if (!pending) return null;
209
+ const claimed = db.run(
210
+ `UPDATE external_schedule_edits SET status = 'delivered', delivered_at = ?1, consumed_by_token = ?2
211
+ WHERE intent_id = ?3 AND status = 'pending' AND expires_at > ?1`,
212
+ [now, ctx.auth!.tokenId, pending.intent_id],
213
+ );
214
+ if (claimed.changes !== 1) return null;
215
+ audit(pending.created_by_user, null, "external_schedule.edit_delivered", pending.intent_id, pending.network_id, {
216
+ node_id: pending.node_id, schedule_id: pending.schedule_id, base_revision: pending.base_revision,
217
+ });
218
+ return { ...pending, status: "delivered", delivered_at: now, consumed_by_token: ctx.auth!.tokenId };
219
+ });
220
+ return Response.json({ ok: true, intent: intent ? publicEdit(intent) : null });
221
+ }
222
+
223
+ if (tail && tail !== "pending" && ack && ctx.req.method === "POST") {
224
+ const denied = requireBoundNode(ctx, node);
225
+ if (denied) return denied;
226
+ let body: Record<string, unknown>;
227
+ try { body = await bodyObject(ctx.req); } catch { return error("invalid_json", 400); }
228
+ if (!exactKeys(body, ["status", "result_revision", "error_code"])) return error("invalid_ack", 400);
229
+ if (body.status !== "applied" && body.status !== "rejected") return error("invalid_ack", 400);
230
+ if (body.status === "applied" && !Number.isSafeInteger(body.result_revision)) return error("invalid_result_revision", 400);
231
+ if (body.status === "rejected" && body.result_revision !== undefined) return error("invalid_ack", 400);
232
+ if (body.error_code !== undefined && (typeof body.error_code !== "string" || !/^[a-z0-9_]{1,64}$/.test(body.error_code))) return error("invalid_error_code", 400);
233
+ const now = Date.now();
234
+ const result = db.transaction(() => {
235
+ const row = db.get<EditRow>("SELECT * FROM external_schedule_edits WHERE intent_id = ?1", tail);
236
+ if (!row || row.node_id !== node.node_id || row.network_id !== node.network_id || row.consumed_by_token !== ctx.auth!.tokenId) {
237
+ return { error: "intent_not_found", status: 404 } as const;
238
+ }
239
+ if (row.status === "applied" || row.status === "rejected") {
240
+ const requestedRevision = body.status === "applied" ? Number(body.result_revision) : null;
241
+ const requestedError = body.error_code ?? null;
242
+ if (row.status === body.status && row.result_revision === requestedRevision && row.error_code === requestedError) {
243
+ return { row, idempotent: true } as const;
244
+ }
245
+ return { error: "intent_already_terminal", status: 409 } as const;
246
+ }
247
+ if (row.status !== "delivered") return { error: "intent_not_delivered", status: 409 } as const;
248
+ if (body.status === "applied" && Number(body.result_revision) !== row.base_revision + 1) {
249
+ return { error: "invalid_result_revision", status: 409 } as const;
250
+ }
251
+ const changed = db.run(
252
+ `UPDATE external_schedule_edits SET status = ?1, acked_at = ?2, result_revision = ?3, error_code = ?4
253
+ WHERE intent_id = ?5 AND status = 'delivered' AND consumed_by_token = ?6`,
254
+ [body.status, now, body.status === "applied" ? Number(body.result_revision) : null, body.error_code ?? null, row.intent_id, ctx.auth!.tokenId],
255
+ );
256
+ if (changed.changes !== 1) return { error: "intent_state_conflict", status: 409 } as const;
257
+ audit(row.created_by_user, null, `external_schedule.edit_${body.status}`, row.intent_id, row.network_id, {
258
+ node_id: row.node_id, schedule_id: row.schedule_id, base_revision: row.base_revision,
259
+ result_revision: body.status === "applied" ? Number(body.result_revision) : null,
260
+ error_code: body.error_code ?? null,
261
+ });
262
+ return { row: { ...row, status: String(body.status), acked_at: now, result_revision: body.status === "applied" ? Number(body.result_revision) : null, error_code: body.error_code ?? null } } as const;
263
+ });
264
+ if ("error" in result) return error(result.error, result.status);
265
+ return Response.json({ ok: true, intent: publicEdit(result.row), ...(result.idempotent ? { idempotent: true } : {}) });
266
+ }
267
+
268
+ if (tail) return error("not_found", 404);
269
+
270
+ if (ctx.req.method === "GET") {
271
+ const denied = requireOwner(ctx, node, ctx.url.searchParams.get("network_id"));
272
+ if (denied) return denied;
273
+ const rows = db.all<EditRow>(
274
+ "SELECT * FROM external_schedule_edits WHERE node_id = ?1 AND network_id = ?2 AND created_by_user = ?3 ORDER BY created_at DESC LIMIT 100",
275
+ node.node_id, node.network_id, ctx.auth!.userId,
276
+ );
277
+ return Response.json({ ok: true, edits: rows.map(publicEdit) });
278
+ }
279
+
280
+ if (ctx.req.method !== "POST") return error("method_not_allowed", 405);
281
+ let body: Record<string, unknown>;
282
+ try { body = await bodyObject(ctx.req); } catch { return error("invalid_json", 400); }
283
+ if (!exactKeys(body, ["network_id", "schedule_id", "base_revision", "patch"])) return error("invalid_request", 400);
284
+ const denied = requireOwner(ctx, node, body.network_id);
285
+ if (denied) return denied;
286
+ if (typeof body.schedule_id !== "string" || !SCHEDULE_ID_RE.test(body.schedule_id)) return error("invalid_schedule_id", 400);
287
+ if (!Number.isSafeInteger(body.base_revision) || Number(body.base_revision) < 0) return error("invalid_revision", 400);
288
+ let patch: ExternalSchedulePatch;
289
+ try { patch = parseExternalSchedulePatch(body.patch); } catch (e: any) { return error(String(e?.message || "invalid_patch"), 400); }
290
+ const schedule = reportedSchedule(node, body.schedule_id);
291
+ if (!schedule) return error("schedule_not_found", 404);
292
+ if (schedule.kind !== "cron" || schedule.editable !== true || !Number.isSafeInteger(schedule.revision)) return error("schedule_read_only", 409);
293
+ if (Number(schedule.revision) !== Number(body.base_revision)) return error("revision_conflict", 409, { current_revision: schedule.revision });
294
+
295
+ const intentId = `sei_${crypto.randomUUID()}`;
296
+ const now = Date.now();
297
+ try {
298
+ db.transaction(() => {
299
+ // Re-read ownership + snapshot inside the write transaction so a
300
+ // concurrent owner/snapshot change cannot slip between preflight and INSERT.
301
+ const currentNode = nodeRow(node.node_id);
302
+ if (!currentNode || currentNode.owner_user_id !== ctx.auth!.userId || currentNode.network_id !== node.network_id) throw new Error("node_owner_changed");
303
+ const current = reportedSchedule(currentNode, body.schedule_id as string);
304
+ if (!current || current.editable !== true || current.kind !== "cron") throw new Error("schedule_read_only");
305
+ if (Number(current.revision) !== Number(body.base_revision)) throw new Error("revision_conflict");
306
+ db.run(
307
+ `INSERT INTO external_schedule_edits
308
+ (intent_id, network_id, node_id, schedule_id, base_revision, patch_json, status, expires_at, created_at, created_by_user, created_by_token)
309
+ VALUES (?1, ?2, ?3, ?4, ?5, ?6, 'pending', ?7, ?8, ?9, ?10)`,
310
+ [intentId, node.network_id, node.node_id, body.schedule_id, body.base_revision, JSON.stringify(patch), now + INTENT_TTL_MS, now, ctx.auth!.userId, ctx.auth!.tokenId],
311
+ );
312
+ audit(ctx.auth!.userId, ctx.auth!.username, "external_schedule.edit_requested", intentId, node.network_id!, {
313
+ node_id: node.node_id, schedule_id: body.schedule_id, base_revision: body.base_revision, fields: Object.keys(patch).sort(),
314
+ });
315
+ });
316
+ } catch (e: any) {
317
+ const code = String(e?.message || "edit_create_failed");
318
+ if (/UNIQUE|duplicate key/i.test(code)) return error("edit_in_flight", 409);
319
+ if (code === "revision_conflict") return error(code, 409);
320
+ if (code === "schedule_read_only") return error(code, 409);
321
+ if (code === "node_owner_changed") return error(code, 409);
322
+ throw e;
323
+ }
324
+ try { pushEvent(node.alias || node.node_id, { type: "external_schedule_edit", intent_id: intentId }, node.network_id); } catch {}
325
+ const created = db.get<EditRow>("SELECT * FROM external_schedule_edits WHERE intent_id = ?1", intentId)!;
326
+ return Response.json({ ok: true, intent: publicEdit(created) }, { status: 202 });
327
+ }
@@ -27,7 +27,7 @@ const UPLOADS_DIR = mkdtempSync(join(tmpdir(), "anet-495-devopen-fs-"));
27
27
 
28
28
  // Set env BEFORE importing anything that touches db-adapter.ts or
29
29
  // server.ts (both capture env at module load).
30
- process.env.COMMHUB_DB = SERVER_DB;
30
+ process.env.COMMHUB_DB ||= SERVER_DB;
31
31
  process.env.COMMHUB_UPLOADS_DIR = UPLOADS_DIR;
32
32
  process.env.HOST = "127.0.0.1";
33
33
  process.env.COMMHUB_DEV_OPEN = "1";
@@ -34,7 +34,7 @@ const MASTER_TOKEN = process.env.COMMHUB_AUTH_TOKEN ?? `master-495-${Date.now()}
34
34
  // Set env BEFORE importing anything that pulls in db-adapter.ts (which
35
35
  // refuses to open a default DB under NODE_ENV=test) or server.ts (which
36
36
  // captures DEV_OPEN + AUTH_TOKEN at module load).
37
- process.env.COMMHUB_DB = SERVER_DB;
37
+ process.env.COMMHUB_DB ||= SERVER_DB;
38
38
  process.env.COMMHUB_UPLOADS_DIR = UPLOADS_DIR;
39
39
  process.env.HOST = "127.0.0.1";
40
40
  process.env.COMMHUB_AUTH_TOKEN = MASTER_TOKEN;
@@ -104,7 +104,8 @@ if (!userBNetworkId) throw new Error("userB default network not found");
104
104
  // Add userA as a member of userB's default network. This is what makes
105
105
  // the "same-network non-owner" test cell meaningful — without it, that
106
106
  // test would only prove cross-network denial, which is a weaker claim.
107
- const addMember = addNetworkMember(userBNetworkId, userAUserId, "member", userBUserId);
107
+ // 多用户 Agent 权限:新成员默认只看授权 Agent;本测试测的是「完全信任的成员」旧语义,显式 agent_access=all。
108
+ const addMember = addNetworkMember(userBNetworkId, userAUserId, "member", userBUserId, { agentAccess: "all" });
108
109
  if (!addMember.ok) throw new Error(`add userA to userB network failed: ${addMember.error}`);
109
110
 
110
111
  const { bootServer } = await import("./server.js");
@@ -168,6 +169,10 @@ async function downloadAs(token: string | null, fileId: string): Promise<Respons
168
169
  return fetch(`${BASE}/api/files/${fileId}`, { headers });
169
170
  }
170
171
 
172
+ async function downloadWithQueryToken(token: string, fileId: string): Promise<Response> {
173
+ return fetch(`${BASE}/api/files/${fileId}?token=${encodeURIComponent(token)}`);
174
+ }
175
+
171
176
  describe.skipIf(!isProdMode)("#495 — GET /api/files/:file_id authorization (owner-only staged)", () => {
172
177
  let userBFileId = "";
173
178
 
@@ -238,6 +243,13 @@ describe.skipIf(!isProdMode)("#495 — GET /api/files/:file_id authorization (ow
238
243
  expect(res.status).toBe(401);
239
244
  });
240
245
 
246
+ test("🔴 valid query token is refused on file GET (credential must stay out of URLs)", async () => {
247
+ const res = await downloadWithQueryToken(userBToken, userBFileId);
248
+ expect(res.status).toBe(401);
249
+ const body: any = await res.json();
250
+ expect(body.error).toBe("unauthorized");
251
+ });
252
+
241
253
  test("non-owner request for an UNKNOWN file_id → 404 with same shape as owner-denied (no enumeration signal)", async () => {
242
254
  const res = await downloadAs(userAToken, "0123456789abcdef0123456789abcdef");
243
255
  expect(res.status).toBe(404);
@@ -257,6 +269,10 @@ async function headAs(token: string | null, fileId: string): Promise<Response> {
257
269
  return fetch(`${BASE}/api/files/${fileId}`, { method: "HEAD", headers });
258
270
  }
259
271
 
272
+ async function headWithQueryToken(token: string, fileId: string): Promise<Response> {
273
+ return fetch(`${BASE}/api/files/${fileId}?token=${encodeURIComponent(token)}`, { method: "HEAD" });
274
+ }
275
+
260
276
  describe.skipIf(!isProdMode)("#500 CR2 — HEAD /api/files/:file_id authorization (parity with GET)", () => {
261
277
  let userBFileId = "";
262
278
 
@@ -282,13 +298,13 @@ describe.skipIf(!isProdMode)("#500 CR2 — HEAD /api/files/:file_id authorizatio
282
298
  // — check Content-Type so a future fallback rewrite (e.g. adding
283
299
  // "requested resource type: X") does not silently form an oracle
284
300
  // while HEAD still returns 200 from that page.
285
- expect(res.headers.get("content-type")?.toLowerCase()).toContain("application/json");
301
+ expect((res.headers.get("content-type") || "").toLowerCase().split(";")[0].trim()).toBe("application/json");
286
302
  });
287
303
 
288
304
  test("HEAD unknown file_id → 404 with same shape as cross-owner (no enumeration signal)", async () => {
289
305
  const res = await headAs(userAToken, "0123456789abcdef0123456789abcdef");
290
306
  expect(res.status).toBe(404);
291
- expect(res.headers.get("content-type")?.toLowerCase()).toContain("application/json");
307
+ expect((res.headers.get("content-type") || "").toLowerCase().split(";")[0].trim()).toBe("application/json");
292
308
  });
293
309
 
294
310
  test("HEAD anonymous → 401 (auth still required, symmetric with GET)", async () => {
@@ -296,6 +312,11 @@ describe.skipIf(!isProdMode)("#500 CR2 — HEAD /api/files/:file_id authorizatio
296
312
  expect(res.status).toBe(401);
297
313
  });
298
314
 
315
+ test("🔴 valid query token is refused on file HEAD (same gate as GET)", async () => {
316
+ const res = await headWithQueryToken(userBToken, userBFileId);
317
+ expect(res.status).toBe(401);
318
+ });
319
+
299
320
  test("admin HEAD any file → 200 (operational access preserved on HEAD)", async () => {
300
321
  const res = await headAs(adminToken, userBFileId);
301
322
  expect(res.status).toBe(200);
@@ -34,7 +34,7 @@ const UPLOADS_DIR = mkdtempSync(join(tmpdir(), "anet-509-fs-"));
34
34
 
35
35
  // Set env BEFORE importing anything that pulls in db-adapter.ts or
36
36
  // server.ts (which capture DEV_OPEN + AUTH_TOKEN at module load).
37
- process.env.COMMHUB_DB = SERVER_DB;
37
+ process.env.COMMHUB_DB ||= SERVER_DB;
38
38
  process.env.COMMHUB_UPLOADS_DIR = UPLOADS_DIR;
39
39
  process.env.HOST = "127.0.0.1";
40
40
  delete process.env.COMMHUB_DEV_OPEN;
@@ -20,7 +20,7 @@ import { tmpdir } from "os";
20
20
  const SERVER_DB = mkdtempSync(join(tmpdir(), "anet-503-devopen-db-")) + "/commhub.db";
21
21
  const UPLOADS_DIR = mkdtempSync(join(tmpdir(), "anet-503-devopen-fs-"));
22
22
 
23
- process.env.COMMHUB_DB = SERVER_DB;
23
+ process.env.COMMHUB_DB ||= SERVER_DB;
24
24
  process.env.COMMHUB_UPLOADS_DIR = UPLOADS_DIR;
25
25
  process.env.HOST = "127.0.0.1";
26
26
  process.env.COMMHUB_DEV_OPEN = "1";
@@ -39,7 +39,7 @@ const MASTER_TOKEN = `master-503-${Date.now()}-${Math.floor(Math.random() * 1000
39
39
  // Env must be set before anything pulls in db-adapter.ts (which refuses
40
40
  // the default DB under NODE_ENV=test) or server.ts (which freezes
41
41
  // DEV_OPEN + AUTH_TOKEN at module load).
42
- process.env.COMMHUB_DB = SERVER_DB;
42
+ process.env.COMMHUB_DB ||= SERVER_DB;
43
43
  process.env.COMMHUB_UPLOADS_DIR = UPLOADS_DIR;
44
44
  process.env.HOST = "127.0.0.1";
45
45
  process.env.COMMHUB_AUTH_TOKEN = MASTER_TOKEN;
@@ -108,13 +108,14 @@ const N2 = nonAdminUserB.networkId;
108
108
  const N3 = seedUser.networkId;
109
109
  const N_FAKE = `net_503fake${STAMP}`;
110
110
 
111
- if (!addNetworkMember(N1, nonAdminUserB.userId, "member", nonAdminUserA.userId).ok) {
111
+ // 多用户 Agent 权限:新成员默认只看授权 Agent;本测试测的是「完全信任的成员」旧语义,显式 agent_access=all。
112
+ if (!addNetworkMember(N1, nonAdminUserB.userId, "member", nonAdminUserA.userId, { agentAccess: "all" }).ok) {
112
113
  throw new Error("fixture: userB → N1 member failed");
113
114
  }
114
115
  // The admin needs write access to N1 to be issued a node ntok_ there
115
116
  // (createNetworkTokenForNode refuses non-members and viewers). That
116
117
  // token is the D15 probe: a ntok_ ISSUED BY an admin.
117
- if (!addNetworkMember(N1, adminUser.userId, "member", nonAdminUserA.userId).ok) {
118
+ if (!addNetworkMember(N1, adminUser.userId, "member", nonAdminUserA.userId, { agentAccess: "all" }).ok) {
118
119
  throw new Error("fixture: admin → N1 member failed");
119
120
  }
120
121
  // viewerOnlyUser must hold exactly one network, with role viewer, so the
@@ -122,15 +123,15 @@ if (!addNetworkMember(N1, adminUser.userId, "member", nonAdminUserA.userId).ok)
122
123
  // reachable. register() makes everyone owner of a default network, so
123
124
  // that membership is dropped here.
124
125
  db.run("DELETE FROM network_members WHERE user_id = ?1", [viewerOnlyUser.userId]);
125
- if (!addNetworkMember(N1, viewerOnlyUser.userId, "viewer", nonAdminUserA.userId).ok) {
126
+ if (!addNetworkMember(N1, viewerOnlyUser.userId, "viewer", nonAdminUserA.userId, { agentAccess: "all" }).ok) {
126
127
  throw new Error("fixture: viewerOnly → N1 viewer failed");
127
128
  }
128
129
  // mixedUser can write in N1 but only read in N2 — U14 asserts that an
129
130
  // explicit param pointing at the viewer network is refused.
130
- if (!addNetworkMember(N1, mixedUser.userId, "member", nonAdminUserA.userId).ok) {
131
+ if (!addNetworkMember(N1, mixedUser.userId, "member", nonAdminUserA.userId, { agentAccess: "all" }).ok) {
131
132
  throw new Error("fixture: mixed → N1 member failed");
132
133
  }
133
- if (!addNetworkMember(N2, mixedUser.userId, "viewer", nonAdminUserB.userId).ok) {
134
+ if (!addNetworkMember(N2, mixedUser.userId, "viewer", nonAdminUserB.userId, { agentAccess: "all" }).ok) {
134
135
  throw new Error("fixture: mixed → N2 viewer failed");
135
136
  }
136
137