@sleep2agi/commhub-server 0.9.0-preview.27 → 0.9.0-preview.271

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 (446) 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 +210 -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 +885 -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 +223 -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/api-host-supervisors-can-create-nodes.test.ts +350 -0
  28. package/src/api-host-supervisors-fallback.test.ts +6 -7
  29. package/src/api-host-supervisors-runtime-readiness.test.ts +195 -0
  30. package/src/api-nodes-shape.test.ts +131 -4
  31. package/src/auth-abuse-counters.test.ts +144 -0
  32. package/src/auth-abuse-counters.ts +122 -0
  33. package/src/auth-layer-shape.test.ts +105 -0
  34. package/src/auth-password-change-cli-tokens-http.test.ts +423 -0
  35. package/src/auth-sessions-http.test.ts +260 -0
  36. package/src/auth-validate.test.ts +5 -1
  37. package/src/auth-weak-password-login.test.ts +176 -0
  38. package/src/auth.ts +641 -68
  39. package/src/backfill-node-ids-2664.test.ts +128 -0
  40. package/src/binding-generation-http.test.ts +141 -0
  41. package/src/blocked-exit-on-reply.test.ts +122 -0
  42. package/src/broadcast-fanout-2721.test.ts +149 -0
  43. package/src/broadcast-fanout.ts +117 -0
  44. package/src/build-commit-report-http.test.ts +128 -0
  45. package/src/build-info.test.ts +60 -0
  46. package/src/build-info.ts +85 -0
  47. package/src/chain-attempt-dedup.test.ts +447 -0
  48. package/src/clip.test.ts +36 -0
  49. package/src/clip.ts +48 -0
  50. package/src/clone-node.test.ts +269 -0
  51. package/src/clone-node.ts +289 -0
  52. package/src/codex-config-flags.ts +77 -0
  53. package/src/codex-fork-contract.ts +23 -0
  54. package/src/codex-fork-migration.test.ts +38 -0
  55. package/src/commhub-bin-args.test.ts +85 -0
  56. package/src/config-apply-validate.test.ts +188 -1
  57. package/src/config-apply-validate.ts +222 -3
  58. package/src/cors-origins.test.ts +73 -0
  59. package/src/create-node-blocked-gate.test.ts +365 -0
  60. package/src/create-node-error-domain.test.ts +127 -0
  61. package/src/create-node-network-id.test.ts +91 -0
  62. package/src/create-node-tool-schema.test.ts +49 -0
  63. package/src/create-node-unicode-name.test.ts +126 -0
  64. package/src/create-node-validate.test.ts +199 -7
  65. package/src/create-node-validate.ts +232 -15
  66. package/src/create-node-workdir.test.ts +298 -0
  67. package/src/create-node.ts +88 -23
  68. package/src/daemon-provider-snapshots.test.ts +453 -0
  69. package/src/daemon-provider-snapshots.ts +327 -0
  70. package/src/daemon-token-owner-http.test.ts +346 -0
  71. package/src/dashboard-slash-routing-http.test.ts +109 -0
  72. package/src/db-adapter-guard.test.ts +148 -0
  73. package/src/db-adapter-translate.test.ts +128 -0
  74. package/src/db-adapter.ts +377 -91
  75. package/src/db-timestamp.test.ts +38 -0
  76. package/src/db-timestamp.ts +15 -0
  77. package/src/db.ts +1298 -153
  78. package/src/delivered-without-push.test.ts +140 -0
  79. package/src/department-groups-http.test.ts +209 -0
  80. package/src/department-groups-sync-http.test.ts +328 -0
  81. package/src/department-groups.ts +434 -0
  82. package/src/department-heads-http.test.ts +350 -0
  83. package/src/department-heads.ts +226 -0
  84. package/src/departments-agent-count.test.ts +139 -0
  85. package/src/departments-http.test.ts +185 -0
  86. package/src/departments-mcp-error-domain.test.ts +135 -0
  87. package/src/departments-mcp.test.ts +128 -0
  88. package/src/departments.ts +318 -0
  89. package/src/desktop-message-seam.test.ts +150 -0
  90. package/src/desktop-message.test.ts +368 -0
  91. package/src/dm-file-scope-http.test.ts +227 -0
  92. package/src/empty-node-sweeper.test.ts +104 -0
  93. package/src/empty-node-sweeper.ts +88 -0
  94. package/src/env-transport-gate-http.test.ts +240 -0
  95. package/src/env-transport-gate.ts +80 -0
  96. package/src/env-transport-policy.ts +56 -0
  97. package/src/etag-of.test.ts +57 -0
  98. package/src/event-loop-lag.test.ts +180 -0
  99. package/src/event-loop-lag.ts +201 -0
  100. package/src/expiry-counters.test.ts +187 -0
  101. package/src/expiry-counters.ts +227 -0
  102. package/src/expiry-evidence-db.test.ts +103 -0
  103. package/src/ext-token-shared.test.ts +60 -0
  104. package/src/ext-validation-regression.test.ts +10 -17
  105. package/src/external-schedule-edits-http.test.ts +321 -0
  106. package/src/external-schedule-edits-timestamps.test.ts +64 -0
  107. package/src/external-schedule-edits.ts +327 -0
  108. package/src/file-download-authz-dev-open.test.ts +1 -1
  109. package/src/file-download-authz.test.ts +25 -4
  110. package/src/file-download-date-bucket.test.ts +1 -1
  111. package/src/file-network-scope-dev-open.test.ts +1 -1
  112. package/src/file-network-scope.test.ts +7 -6
  113. package/src/group-membership-events-http.test.ts +264 -0
  114. package/src/group-messages-http.test.ts +483 -0
  115. package/src/group-messages.ts +297 -0
  116. package/src/health-anon-readers.ts +67 -0
  117. package/src/health-host-disk-2756.test.ts +71 -0
  118. package/src/health-identity-root.test.ts +98 -0
  119. package/src/health-redaction.test.ts +1599 -7
  120. package/src/health-status-reasons.test.ts +84 -0
  121. package/src/host-supervisor-identity-http.test.ts +152 -0
  122. package/src/host-supervisor-identity.ts +92 -0
  123. package/src/host-supervisors-daemon-version.test.ts +137 -0
  124. package/src/http-gzip.test.ts +94 -0
  125. package/src/http-gzip.ts +112 -0
  126. package/src/hub-catalog-read-http.test.ts +664 -0
  127. package/src/hub-provider-config.test.ts +166 -0
  128. package/src/hub-provider-config.ts +202 -0
  129. package/src/hub-timestamp.test.ts +38 -0
  130. package/src/hub-timestamp.ts +27 -0
  131. package/src/human-dm.ts +215 -0
  132. package/src/human-inbox.ts +42 -0
  133. package/src/inbox-caller.ts +49 -0
  134. package/src/inbox-count-sse.test.ts +318 -0
  135. package/src/inbox-count.ts +29 -0
  136. package/src/index.ts +6 -2
  137. package/src/license-state.test.ts +105 -0
  138. package/src/license-state.ts +48 -0
  139. package/src/lifecycle-error-domain.test.ts +149 -0
  140. package/src/list-ack-error-domain.test.ts +108 -0
  141. package/src/list-host-supervisors.test.ts +15 -4
  142. package/src/list-tasks-omit-default.test.ts +84 -0
  143. package/src/list-tasks-since-last.test.ts +100 -0
  144. package/src/list-tasks-since.test.ts +104 -0
  145. package/src/mcp-context-cost-http.test.ts +127 -0
  146. package/src/mcp-inflight.test.ts +92 -0
  147. package/src/mcp-inflight.ts +38 -0
  148. package/src/mcp-projects-events-http.test.ts +168 -0
  149. package/src/mcp-route-label-http.test.ts +120 -0
  150. package/src/mcp-write-network-resolution.test.ts +21 -0
  151. package/src/member-audit-network-id-http.test.ts +93 -0
  152. package/src/member-presence-http.test.ts +210 -0
  153. package/src/messages-ack-by-agent-http.test.ts +142 -0
  154. package/src/migrate-sqlite-to-pg.test.ts +47 -0
  155. package/src/migrate-sqlite-to-pg.ts +263 -0
  156. package/src/model-auth-notify-http.test.ts +181 -0
  157. package/src/model-auth-notify.ts +116 -0
  158. package/src/network-name-http.test.ts +75 -0
  159. package/src/network-quota-config.test.ts +100 -0
  160. package/src/network-rules-http.test.ts +169 -0
  161. package/src/network-rules.ts +129 -0
  162. package/src/network-scope.ts +222 -3
  163. package/src/network-token-membership-http.test.ts +186 -0
  164. package/src/node-alias-control.ts +12 -0
  165. package/src/node-attrs.test.ts +47 -2
  166. package/src/node-caller-identity-http.test.ts +1108 -0
  167. package/src/node-config-last-update.test.ts +126 -0
  168. package/src/node-config-last-update.ts +107 -0
  169. package/src/node-create-request-status-http.test.ts +105 -0
  170. package/src/node-daemon-bindings.test.ts +142 -0
  171. package/src/node-daemon-bindings.ts +135 -0
  172. package/src/node-failure-alert.test.ts +150 -0
  173. package/src/node-failure-alert.ts +177 -0
  174. package/src/node-files-transport.test.ts +350 -0
  175. package/src/node-health-codex-login.test.ts +120 -0
  176. package/src/node-health-dispatch-http.test.ts +373 -0
  177. package/src/node-health-guard-origin.test.ts +98 -0
  178. package/src/node-health-guard.ts +121 -0
  179. package/src/node-health-passthrough.test.ts +115 -0
  180. package/src/node-health-store.ts +101 -0
  181. package/src/node-id-alias.test.ts +190 -0
  182. package/src/node-identity-conflict-http.test.ts +269 -0
  183. package/src/node-identity-conflict.ts +142 -0
  184. package/src/node-identity-mismatch.test.ts +74 -0
  185. package/src/node-in-flight-tasks.ts +31 -0
  186. package/src/node-lifecycle-controllable.test.ts +64 -0
  187. package/src/node-lifecycle-controllable.ts +53 -0
  188. package/src/node-lifecycle-read-http.test.ts +257 -0
  189. package/src/node-lifecycle-read.ts +124 -0
  190. package/src/node-logs-transport.test.ts +266 -0
  191. package/src/node-peer-allowlist.test.ts +114 -0
  192. package/src/node-permissions-http.test.ts +901 -0
  193. package/src/node-permissions.ts +496 -0
  194. package/src/node-request-retention.test.ts +281 -0
  195. package/src/node-request-retention.ts +120 -0
  196. package/src/node-secret-rest-http.test.ts +190 -0
  197. package/src/node-secret-vault-inject.test.ts +132 -0
  198. package/src/node-security-write-gate.test.ts +72 -0
  199. package/src/node-serviceability.test.ts +86 -0
  200. package/src/node-serviceability.ts +124 -0
  201. package/src/node-session-control-http.test.ts +310 -0
  202. package/src/node-session-control.ts +258 -0
  203. package/src/node-skills-transport.test.ts +212 -0
  204. package/src/node-token-identity.ts +35 -0
  205. package/src/node-token-ownership.ts +51 -0
  206. package/src/node-token-privilege-http.test.ts +224 -0
  207. package/src/node-token-usage.test.ts +90 -0
  208. package/src/node-token-usage.ts +164 -0
  209. package/src/not-found-api-http.test.ts +67 -0
  210. package/src/observer-avatar-http.test.ts +103 -10
  211. package/src/observer-push.test.ts +76 -0
  212. package/src/opencode-catalog-report-http.test.ts +139 -0
  213. package/src/opencode-v2-catalog.test.ts +268 -0
  214. package/src/opencode-v2-catalog.ts +356 -0
  215. package/src/package-version-consistency.test.ts +25 -0
  216. package/src/parent-infer.test.ts +82 -0
  217. package/src/parent-infer.ts +110 -0
  218. package/src/parent-source-marker.test.ts +70 -0
  219. package/src/parent-source-orphan.test.ts +121 -0
  220. package/src/password-network-tokens.ts +25 -0
  221. package/src/peer-reply-atomic.test.ts +462 -0
  222. package/src/peer-reply-capability.test.ts +70 -0
  223. package/src/pg-worker.ts +87 -0
  224. package/src/poll-pacing.test.ts +74 -0
  225. package/src/poll-pacing.ts +123 -0
  226. package/src/probe-provider-error-domain.test.ts +145 -0
  227. package/src/project-dir-warn-clear-http.test.ts +132 -0
  228. package/src/project-viewer-can-http.test.ts +116 -0
  229. package/src/provider-skill-error-domain.test.ts +130 -0
  230. package/src/provider-tools-shape.test.ts +165 -0
  231. package/src/push.test.ts +20 -10
  232. package/src/push.ts +373 -9
  233. package/src/redact-tokens.test.ts +86 -0
  234. package/src/redact-tokens.ts +43 -0
  235. package/src/rejection-counters.test.ts +72 -0
  236. package/src/rejection-counters.ts +173 -0
  237. package/src/rename.ts +38 -10
  238. package/src/reply-target-derivation.test.ts +96 -0
  239. package/src/report-status-handover-capabilities-http.test.ts +124 -0
  240. package/src/report-status-host-schema.test.ts +235 -0
  241. package/src/report-status-resume-id-handover.test.ts +184 -0
  242. package/src/report-status-secret-keys.test.ts +140 -0
  243. package/src/require-explicit-test-db.ts +9 -0
  244. package/src/requirement-due-reminders-http.test.ts +620 -0
  245. package/src/requirement-due-reminders.ts +416 -0
  246. package/src/requirement-events-http.test.ts +318 -0
  247. package/src/requirement-events.test.ts +45 -0
  248. package/src/requirement-events.ts +144 -0
  249. package/src/requirement-notify.ts +165 -0
  250. package/src/requirement-participant-notify-http.test.ts +313 -0
  251. package/src/requirement-tag-ops-http.test.ts +454 -0
  252. package/src/requirement-tag-tree-http.test.ts +275 -0
  253. package/src/requirement-tag-tree.ts +127 -0
  254. package/src/requirement-tags.ts +102 -0
  255. package/src/requirements-abandoned-http.test.ts +236 -0
  256. package/src/requirements-assignee-drift.test.ts +154 -0
  257. package/src/requirements-comment-http.test.ts +174 -0
  258. package/src/requirements-completed-at-migration.test.ts +70 -0
  259. package/src/requirements-errors-mcp-http.test.ts +164 -0
  260. package/src/requirements-errors.ts +158 -0
  261. package/src/requirements-etag-http.test.ts +91 -0
  262. package/src/requirements-http.test.ts +709 -0
  263. package/src/requirements-last-event-http.test.ts +349 -0
  264. package/src/requirements-list-mcp-slim-http.test.ts +155 -0
  265. package/src/requirements-list-slim-http.test.ts +324 -0
  266. package/src/requirements-mcp.test.ts +180 -0
  267. package/src/requirements-migrate.ts +283 -0
  268. package/src/requirements-owner-strict-mcp-http.test.ts +145 -0
  269. package/src/requirements-people-http.test.ts +114 -0
  270. package/src/requirements-people-mcp-http.test.ts +231 -0
  271. package/src/requirements-people.ts +196 -0
  272. package/src/requirements-priority-lowest.test.ts +114 -0
  273. package/src/requirements-projects-network-echo.test.ts +57 -0
  274. package/src/requirements-projects-parent-http.test.ts +123 -0
  275. package/src/requirements-search-http.test.ts +182 -0
  276. package/src/requirements-search.test.ts +32 -0
  277. package/src/requirements-search.ts +145 -0
  278. package/src/requirements-seq-http.test.ts +193 -0
  279. package/src/requirements-seq-migration.test.ts +63 -0
  280. package/src/requirements-start-date.test.ts +125 -0
  281. package/src/requirements-stats-http.test.ts +357 -0
  282. package/src/requirements-stats.ts +195 -0
  283. package/src/requirements-status-participants-http.test.ts +222 -0
  284. package/src/requirements-upgrade-e2e.test.ts +126 -0
  285. package/src/requirements-upgrade-migration.test.ts +98 -0
  286. package/src/requirements.ts +2205 -0
  287. package/src/resolve-port.test.ts +57 -0
  288. package/src/resolve-port.ts +44 -0
  289. package/src/rest-alias-network-fallback-http.test.ts +123 -0
  290. package/src/rest-alias-network-fallback.test.ts +60 -0
  291. package/src/rest-alias-network-fallback.ts +65 -0
  292. package/src/rest-explicit-columns-http.test.ts +266 -0
  293. package/src/rest-identity.test.ts +130 -0
  294. package/src/rest-identity.ts +141 -0
  295. package/src/rest-projections.ts +72 -0
  296. package/src/rest-read-network-real-chain.test.ts +97 -0
  297. package/src/rest-write-network-resolution.test.ts +133 -0
  298. package/src/restart-readiness-http.test.ts +121 -0
  299. package/src/restricted-files.ts +76 -0
  300. package/src/retention-first-sweep-quiet.test.ts +31 -0
  301. package/src/retention.test.ts +100 -40
  302. package/src/retention.ts +423 -104
  303. package/src/route-callers-http.test.ts +120 -0
  304. package/src/route-timing.test.ts +218 -0
  305. package/src/route-timing.ts +262 -0
  306. package/src/rules-file-duplicate-alias.test.ts +234 -0
  307. package/src/rules-file-session-target.test.ts +207 -0
  308. package/src/rules-file-transport.test.ts +271 -0
  309. package/src/runtime-label.test.ts +22 -0
  310. package/src/runtime-label.ts +21 -0
  311. package/src/runtime-readiness.ts +90 -0
  312. package/src/schedule-agent-mcp-http.test.ts +486 -0
  313. package/src/schedule-agent.ts +252 -0
  314. package/src/schedule-starved.test.ts +92 -0
  315. package/src/schedule-starved.ts +114 -0
  316. package/src/scheduled-backoff-http.test.ts +203 -0
  317. package/src/scheduled-backoff.ts +64 -0
  318. package/src/scheduled-doorbell-nodeless-session.test.ts +134 -0
  319. package/src/scheduled-failure-backoff-2622.test.ts +145 -0
  320. package/src/scheduled-failure-code.test.ts +73 -0
  321. package/src/scheduled-failure-code.ts +105 -0
  322. package/src/scheduled-failures-http.test.ts +279 -0
  323. package/src/scheduled-failures.ts +425 -0
  324. package/src/scheduled-noprogress-backoff-2622.test.ts +163 -0
  325. package/src/scheduled-offline-backoff-probe.test.ts +56 -0
  326. package/src/scheduled-offline.test.ts +131 -0
  327. package/src/scheduled-offline.ts +66 -0
  328. package/src/scheduled-outcome-guidance-http.test.ts +139 -0
  329. package/src/scheduled-outcome-guidance.ts +9 -0
  330. package/src/scheduled-reply-unread-http.test.ts +212 -0
  331. package/src/scheduled-requirement-wake-http.test.ts +289 -0
  332. package/src/scheduled-requirement-wake.ts +125 -0
  333. package/src/scheduled-run-terminal.test.ts +290 -0
  334. package/src/scheduled-skip-blocking-task.test.ts +120 -0
  335. package/src/scheduled-skip-path-backoff-2622.test.ts +98 -0
  336. package/src/scheduled-stuck-http.test.ts +316 -0
  337. package/src/scheduled-stuck-notice-cap.test.ts +80 -0
  338. package/src/scheduled-stuck.ts +219 -0
  339. package/src/scheduled-tasks-http.test.ts +679 -0
  340. package/src/scheduled-tasks.ts +959 -0
  341. package/src/scheduled-work-outcome-http.test.ts +154 -0
  342. package/src/scheduled-work-outcome.ts +50 -0
  343. package/src/scoped-secrets.ts +167 -0
  344. package/src/secret-echo-negative-control.test.ts +118 -0
  345. package/src/send-dedup-request-id.test.ts +229 -0
  346. package/src/send-reply-agent-warning.test.ts +38 -38
  347. package/src/send-reply-alias-optional.test.ts +131 -0
  348. package/src/send-reply-attachments.test.ts +28 -7
  349. package/src/send_dedup.test.ts +54 -0
  350. package/src/send_dedup.ts +52 -6
  351. package/src/serve-error.test.ts +73 -0
  352. package/src/serve-error.ts +56 -0
  353. package/src/server.ts +4963 -377
  354. package/src/session-task-on-dispatch.ts +14 -0
  355. package/src/session-token-ownership-http.test.ts +122 -0
  356. package/src/shared/codex-inventory.ts +41 -0
  357. package/src/shared/daemon-provider-login.ts +31 -0
  358. package/src/shared/daemon-provider-snapshot.ts +52 -0
  359. package/src/shared/external-schedule-contract.ts +60 -0
  360. package/src/shared/node-name.test.ts +62 -0
  361. package/src/shared/node-name.ts +161 -0
  362. package/src/shared/probe-host-allowlist-drift.test.ts +45 -0
  363. package/src/shared/provider-application.ts +29 -0
  364. package/src/shared/provider-collection.ts +14 -0
  365. package/src/shared/provider-initialization.ts +8 -0
  366. package/src/shared/reserved-env-drift.test.ts +10 -0
  367. package/src/shared/scoped-secret-contract.ts +5 -0
  368. package/src/shared/task-content-limit-drift.test.ts +28 -0
  369. package/src/shared/task-content-limit.ts +25 -0
  370. package/src/side-thread-command-transport.test.ts +312 -0
  371. package/src/side-thread-command-transport.ts +318 -0
  372. package/src/side-thread-http-integration.test.ts +233 -0
  373. package/src/side-thread-http.ts +504 -0
  374. package/src/side-thread-production.test.ts +72 -0
  375. package/src/side-thread-production.ts +118 -0
  376. package/src/side-thread.test.ts +1067 -0
  377. package/src/side-thread.ts +2499 -0
  378. package/src/skillhub-http.test.ts +144 -0
  379. package/src/sqlite-close-checkpoint.test.ts +78 -0
  380. package/src/start-node.test.ts +265 -0
  381. package/src/start-request-error-domain.test.ts +182 -0
  382. package/src/start-skill-error-domain.test.ts +122 -0
  383. package/src/stats-versions-http.test.ts +65 -0
  384. package/src/status-alias-filter-http.test.ts +106 -0
  385. package/src/status-alias-resolver-http.test.ts +163 -0
  386. package/src/status-alias-resolver.ts +19 -0
  387. package/src/status-node-id-filter-http.test.ts +161 -0
  388. package/src/status-read-cache-http.test.ts +229 -0
  389. package/src/status-read-cache.ts +129 -0
  390. package/src/stop-delete-node.test.ts +567 -1
  391. package/src/task-access-http.test.ts +407 -0
  392. package/src/task-access.ts +420 -0
  393. package/src/task-activity.ts +60 -0
  394. package/src/task-auth-origin-http.test.ts +93 -0
  395. package/src/task-auth-origin.test.ts +24 -0
  396. package/src/task-auth-origin.ts +7 -0
  397. package/src/task-consumption.test.ts +508 -0
  398. package/src/task-diagnostic-http.test.ts +149 -0
  399. package/src/task-diagnostic.test.ts +115 -0
  400. package/src/task-diagnostic.ts +118 -0
  401. package/src/task-expiry-notice-http.test.ts +298 -0
  402. package/src/task-expiry-notice.ts +318 -0
  403. package/src/task-idempotency-mcp.test.ts +148 -0
  404. package/src/task-idempotency.test.ts +76 -0
  405. package/src/task-idempotency.ts +81 -0
  406. package/src/task-late-replies.ts +54 -0
  407. package/src/task-late-reply-http.test.ts +227 -0
  408. package/src/task-lifecycle-watcher-busy.test.ts +114 -0
  409. package/src/task-lifecycle-watcher.test.ts +209 -0
  410. package/src/task-lifecycle-watcher.ts +109 -0
  411. package/src/task-network-resolution-http.test.ts +140 -0
  412. package/src/task-not-found-error-domain.test.ts +114 -0
  413. package/src/task-offline-delivery-2668.test.ts +119 -0
  414. package/src/task-offline-delivery.ts +81 -0
  415. package/src/task-orphan-http.test.ts +287 -0
  416. package/src/task-orphan.ts +119 -0
  417. package/src/task-queue-ahead-http.test.ts +309 -0
  418. package/src/task-queue-ahead-scale.test.ts +236 -0
  419. package/src/task-queue-ahead.ts +186 -0
  420. package/src/task-rejection-log-http.test.ts +160 -0
  421. package/src/task-rejection-log.ts +61 -0
  422. package/src/task-sender-http.test.ts +143 -0
  423. package/src/task-stale-open-http.test.ts +292 -0
  424. package/src/task-stale-open.ts +103 -0
  425. package/src/tasks-pagination-http.test.ts +141 -0
  426. package/src/team-rules-status-http.test.ts +90 -0
  427. package/src/team-rules-status.test.ts +59 -0
  428. package/src/team-rules-status.ts +72 -0
  429. package/src/tmux-allowlist.test.ts +48 -0
  430. package/src/tool-audience-http.test.ts +248 -0
  431. package/src/tool-audience.ts +130 -0
  432. package/src/tools-list-json-schema.test.ts +94 -0
  433. package/src/tools.ts +4340 -386
  434. package/src/update-node-config-error-domain.test.ts +107 -0
  435. package/src/uploads-http.test.ts +6 -4
  436. package/src/uploads.ts +23 -4
  437. package/src/user-avatar-http.test.ts +74 -0
  438. package/src/user-avatar-image.ts +160 -0
  439. package/src/user-avatar-migration.test.ts +25 -0
  440. package/src/user-avatar-upload-http.test.ts +353 -0
  441. package/src/user-inbox-by-agent-http.test.ts +189 -0
  442. package/src/user-inbox-netid-notnull.test.ts +122 -0
  443. package/src/user-inbox-read-http.test.ts +223 -0
  444. package/src/user-inbox-schema.test.ts +54 -0
  445. package/src/version-stats.test.ts +66 -0
  446. package/src/version-stats.ts +109 -0
@@ -0,0 +1,186 @@
1
+ // #488 —— 网络令牌只在它的用户还是这个网络的成员时有效(RFC-041 §1)。
2
+ //
3
+ // 以前:被移出网络的成员留下的节点令牌照样解析 —— MCP 每个工具都拒(not a member),REST 读却拿得到整个网络
4
+ // (GET /api/status 返回全部名册)。受限成员的令牌本来就在 resolveToken 被拒,但 401 只写 unauthorized。
5
+ //
6
+ // 钉住:
7
+ // (i) 非成员的网络令牌:每个 REST GET 与 /mcp 都 401,reason = not_network_member(下面 GETS 是逐条探过的读路径)。
8
+ // (ii) removeNetworkMember 在同一个事务里吊销这个人在该网络的令牌(revoked_at),别的网络的令牌不动。
9
+ // (iii) 受限成员的节点令牌:401 带 reason = node_owner_restricted + hint;不认识的令牌只有 unauthorized。
10
+ // 成员的节点令牌、不受限的情况与以前完全一样。
11
+ //
12
+ // 跑法:cd server && COMMHUB_DB=/tmp/x.db bun test src/network-token-membership-http.test.ts
13
+ // PG:COMMHUB_TEST_PG_URL=… COMMHUB_PG_EXPERIMENTAL=1(tests/test2123-hub-postgres-ladder 里注册)
14
+ import { afterAll, beforeAll, describe, expect, test } from "bun:test";
15
+ import { addNetworkMember, createNetworkTokenForNode, createNetwork, register, removeNetworkMember } from "./auth.js";
16
+ import { replaceAgentGrants } from "./agent-access.js";
17
+ import { db } from "./db.js";
18
+
19
+ const activeDbPath = process.env.COMMHUB_DB ?? (process.env.COMMHUB_TEST_PG_URL ? "postgres" : undefined);
20
+ if (!activeDbPath) throw new Error("network-token-membership requires COMMHUB_DB (or COMMHUB_TEST_PG_URL) before module import");
21
+
22
+ const stamp = Date.now();
23
+ const PW = "TokenMember123!";
24
+ const OTHER = `other-${stamp}`; // 网络里别人的 Agent —— 出现在响应里 = 读到了不该读的
25
+ let server: any, base = "", net = "", net2 = "", taskId = "";
26
+ const tok: Record<string, string> = {};
27
+ const ids: Record<string, string> = {};
28
+
29
+ const get = (t: string, path: string) =>
30
+ fetch(`${base}${path}`, { headers: { Authorization: `Bearer ${t}` } })
31
+ .then(async (r) => ({ status: r.status, text: await r.text() }));
32
+ const mcp = (t: string, name: string, args: Record<string, unknown>) =>
33
+ fetch(`${base}/mcp`, {
34
+ method: "POST",
35
+ headers: { Authorization: `Bearer ${t}`, "Content-Type": "application/json", Accept: "application/json, text/event-stream" },
36
+ body: JSON.stringify({ jsonrpc: "2.0", id: 1, method: "tools/call", params: { name, arguments: args } }),
37
+ }).then(async (r) => ({ status: r.status, text: await r.text() }));
38
+
39
+ // 拿网络令牌能调的 REST GET 读路径(server.ts 里 restScope 之后的每个 GET,加上之前自己解析令牌的 /api/auth/me、/api/networks)。
40
+ const GETS = () => [
41
+ "/api/auth/me", "/api/networks",
42
+ `/api/status?network_id=${net}`, `/api/status?light=1`, "/api/servers", "/api/server/unknown/health", "/api/server/unknown/agents",
43
+ "/api/messages", "/api/messages?scope=user", "/api/stats", "/api/stats/sse", "/api/stats/routes", "/api/server-logs", "/api/audit-log",
44
+ "/api/task_events", "/api/nodes", `/api/nodes/${ids.other}/config`, "/api/node-create-requests", "/api/host-supervisors",
45
+ `/api/task/${taskId}`, "/api/tasks", "/api/completions", "/api/dm/threads", "/api/requirements",
46
+ ];
47
+
48
+ // 2026-10-31 —— #3214:上面那张 GETS 清单把这些端点**打过一遍**(只看状态码),
49
+ // 但成功体的形状从未被钉。这里挑一个结构最简单的先钉住:
50
+ // GET /api/completions ⇒ {completions, ok},且 completions 是数组(客户端按此分页/渲染)
51
+ // 2026-10-31 —— #3214 续:同一张 GETS 清单里的另外两个读面,形状也从未被钉。
52
+ describe("GET /api/servers 与 /api/host-supervisors: shape", () => {
53
+ test("/api/servers ⇒ {ok, servers} 且每台机器字段固定", async () => {
54
+ const r = await fetch(`${base}/api/servers?network_id=${net}`, {
55
+ headers: { Authorization: `Bearer ${tok.bossUser}` },
56
+ });
57
+ expect(r.status).toBe(200);
58
+ const b = await r.json() as any;
59
+ // ⚠️ 实测:这个端点返回**裸数组**,不是 {ok, servers}(我按同族猜错了 —— 本卡第 N 次)
60
+ expect(Array.isArray(b)).toBe(true);
61
+ for (const srv of b as any[]) {
62
+ expect(Object.keys(srv).sort()).toEqual([
63
+ "agent_count", "cpu_cores", "cpu_load_1min", "hostname", "ip",
64
+ "last_seen", "mem_avail_gb", "mem_used_gb",
65
+ ]);
66
+ expect(typeof srv.hostname).toBe("string");
67
+ expect(Number.isInteger(srv.agent_count)).toBe(true);
68
+ }
69
+ });
70
+
71
+ test("/api/host-supervisors ⇒ {count, daemons, ok};受限成员拿到空列表也算读数", async () => {
72
+ const r = await fetch(`${base}/api/host-supervisors?network_id=${net}`, {
73
+ headers: { Authorization: `Bearer ${tok.bossUser}` },
74
+ });
75
+ expect(r.status).toBe(200);
76
+ const b = await r.json() as any;
77
+ expect(Object.keys(b).sort()).toEqual(["count", "daemons", "ok"]);
78
+ expect(Array.isArray(b.daemons)).toBe(true);
79
+ expect(b.count).toBe(b.daemons.length); // 计数与数组同源
80
+ });
81
+ });
82
+
83
+ describe("GET /api/completions: shape", () => {
84
+ test("⇒ {completions, ok} 且 completions 为数组", async () => {
85
+ const r = await fetch(`${base}/api/completions?network_id=${net}`, {
86
+ headers: { Authorization: `Bearer ${tok.bossUser}` },
87
+ });
88
+ expect(r.status).toBe(200);
89
+ const b = await r.json() as any;
90
+ expect(Object.keys(b).sort()).toEqual(["completions", "ok"]);
91
+ expect(Array.isArray(b.completions)).toBe(true);
92
+ });
93
+ });
94
+
95
+ beforeAll(async () => {
96
+ const boss = register(`tm_boss_${stamp}`, PW); net = boss.network_id!; ids.boss = boss.user!.user_id; tok.bossUser = boss.token!;
97
+ for (const k of ["exm", "rem", "mia", "stay"]) {
98
+ const u = register(`tm_${k}_${stamp}`, PW); ids[k] = u.user!.user_id;
99
+ expect(addNetworkMember(net, ids[k], "member", ids.boss, { agentAccess: "all" }).ok).toBe(true);
100
+ const t = createNetworkTokenForNode(ids[k], net, `${k}-${stamp}`, `n_tm_${k}_${stamp}`);
101
+ expect(t.ok).toBe(true);
102
+ tok[k] = t.token!;
103
+ }
104
+ // rem 在另一个网络里也有令牌 —— 被移出 net 时那枚不能被一起吊销。
105
+ const n2 = createNetwork(ids.rem, `tm-net2-${stamp}`); expect(n2.ok).toBe(true); net2 = n2.network_id!;
106
+ const t2 = createNetworkTokenForNode(ids.rem, net2, `rem2-${stamp}`, `n_tm_rem2_${stamp}`); tok.rem2 = t2.token!;
107
+
108
+ ids.other = `n_tm_other_${stamp}`;
109
+ db.run("INSERT INTO nodes (node_id, node_name, alias, network_id, owner_user_id) VALUES (?1, ?2, ?2, ?3, ?4)", [ids.other, OTHER, net, ids.boss]);
110
+ db.run("INSERT INTO sessions (resume_id, alias, status, node_id, network_id, server) VALUES (?1, ?2, 'idle', ?3, ?4, 'unknown')", [`r_${ids.other}`, OTHER, ids.other, net]);
111
+ taskId = `task_tm_${stamp}`;
112
+ db.run("INSERT INTO tasks (task_id, from_name, to_name, to_node_id, content, status, network_id) VALUES (?1, 'boss', ?2, ?3, 'secret plan', 'pending', ?4)", [taskId, OTHER, ids.other, net]);
113
+
114
+ // exm:老数据 —— 成员行没了,令牌还在(移出前的版本不吊销)。rem:走真实的 removeNetworkMember。
115
+ db.run("DELETE FROM network_members WHERE network_id = ?1 AND user_id = ?2", [net, ids.exm]);
116
+ expect(removeNetworkMember(net, ids.rem).ok).toBe(true);
117
+ // mia:铸完令牌后被收窄成只看授权的 Agent。
118
+ expect(replaceAgentGrants({ networkId: net, userId: ids.mia, grants: [], agentAccess: "granted", actorUserId: ids.boss }).ok).toBe(true);
119
+
120
+ const mod: any = await import("./server.js");
121
+ server = mod.bootServer({ port: 0, hostname: "127.0.0.1" });
122
+ base = `http://127.0.0.1:${server.port}`;
123
+ }, 60_000);
124
+ afterAll(() => { server?.stop?.(true); });
125
+
126
+ describe("#488 (i) a network token whose user left the network", () => {
127
+ test("every REST GET read is 401 not_network_member and leaks nothing", async () => {
128
+ const leaks: string[] = [];
129
+ for (const path of GETS()) {
130
+ const r = await get(tok.exm, path);
131
+ if (r.status !== 401 || r.text.includes(OTHER) || r.text.includes("secret plan")) leaks.push(`${path} → ${r.status}`);
132
+ else expect(JSON.parse(r.text).reason).toBe("not_network_member");
133
+ }
134
+ expect(leaks).toEqual([]);
135
+ });
136
+
137
+ test("/mcp is 401 too, with the reason", async () => {
138
+ const r = await mcp(tok.exm, "get_all_status", {});
139
+ expect(r.status).toBe(401);
140
+ expect(JSON.parse(r.text).reason).toBe("not_network_member");
141
+ expect(JSON.parse(r.text).hint).toContain("no longer a member");
142
+ });
143
+ });
144
+
145
+ describe("#488 (ii) removeNetworkMember revokes the member's tokens for that network", () => {
146
+ test("revoked_at is set for that network only, and the token is rejected", async () => {
147
+ const rows = db.all<{ network_id: string; revoked_at: string | null }>("SELECT network_id, revoked_at FROM api_tokens WHERE user_id = ?1 AND network_id IS NOT NULL", ids.rem);
148
+ expect(rows.filter((r) => r.network_id === net).length).toBeGreaterThan(0);
149
+ expect(rows.filter((r) => r.network_id === net).every((r) => !!r.revoked_at)).toBe(true);
150
+ expect(rows.filter((r) => r.network_id === net2).every((r) => !r.revoked_at)).toBe(true);
151
+ expect((await get(tok.rem, `/api/status?network_id=${net}`)).status).toBe(401);
152
+ expect((await get(tok.rem2, "/api/status")).status).toBe(200);
153
+ });
154
+ });
155
+
156
+ describe("#488 (iii) a restricted owner's node token says why it is refused", () => {
157
+ test("401 with reason node_owner_restricted + hint on REST and /mcp", async () => {
158
+ for (const r of [await get(tok.mia, "/api/status"), await mcp(tok.mia, "report_status", { resume_id: "r", alias: `mia-${stamp}`, status: "idle" })]) {
159
+ expect(r.status).toBe(401);
160
+ const body = JSON.parse(r.text);
161
+ expect(body.reason).toBe("node_owner_restricted");
162
+ expect(body.hint).toContain("Agent access");
163
+ }
164
+ const me = await get(tok.mia, "/api/auth/me");
165
+ expect(me.status).toBe(401);
166
+ expect(JSON.parse(me.text).reason).toBe("node_owner_restricted");
167
+ });
168
+
169
+ test("an unknown token gets no reason (nothing to explain, nothing leaked)", async () => {
170
+ const r = await get("ntok_doesnotexist", "/api/status");
171
+ expect(r.status).toBe(401);
172
+ expect(JSON.parse(r.text)).toEqual({ error: "unauthorized" });
173
+ });
174
+ });
175
+
176
+ describe("#488 unchanged for members", () => {
177
+ test("an all-access member's node token reads and heartbeats as before", async () => {
178
+ const st = await get(tok.stay, `/api/status?network_id=${net}`);
179
+ expect(st.status).toBe(200);
180
+ expect(st.text).toContain(OTHER);
181
+ const hb = await mcp(tok.stay, "report_status", { resume_id: `r_stay_${stamp}`, alias: `stay-${stamp}`, status: "idle" });
182
+ expect(hb.status).toBe(200);
183
+ expect(hb.text).toContain('\\"ok\\":true');
184
+ expect((await get(tok.bossUser, `/api/task/${taskId}`)).status).toBe(200);
185
+ });
186
+ });
@@ -0,0 +1,12 @@
1
+ // C0/C1 controls plus Unicode's two dedicated line separators. The latter are
2
+ // not General_Category=Cc, but they still split log/source-prefix lines.
3
+ const CONTROL_CHARACTER = /[\p{Cc}\u2028\u2029]/u;
4
+
5
+ export function aliasControlCharacter(alias: string): string | null {
6
+ return [...alias].find((char) => CONTROL_CHARACTER.test(char)) ?? null;
7
+ }
8
+
9
+ export function describeAliasControlCharacter(char: string): string {
10
+ const codePoint = char.codePointAt(0) ?? 0;
11
+ return `U+${codePoint.toString(16).toUpperCase().padStart(4, "0")}`;
12
+ }
@@ -25,7 +25,7 @@ import { tmpdir } from "os";
25
25
  import { join } from "path";
26
26
 
27
27
  const tmpDb = join(mkdtempSync(join(tmpdir(), "anet-attrs-")), "commhub.db");
28
- process.env.COMMHUB_DB = tmpDb;
28
+ process.env.COMMHUB_DB ||= tmpDb;
29
29
  const PORT = 23000 + Math.floor(Math.random() * 1500);
30
30
  process.env.PORT = String(PORT);
31
31
  process.env.HOST = "127.0.0.1";
@@ -45,6 +45,10 @@ const LEGACY_ALIAS = "attrs-legacy-node";
45
45
  let token = "";
46
46
  let server: { stop: (force?: boolean) => void } | null = null;
47
47
 
48
+ // 30s 而不是 bun 默认的 5s:这个 hook 跑 register()(KDF)+bootServer(),
49
+ // 本机空载基线 ~620ms,而 2026-08-17 与 2026-08-31 两次 CI 上它被 5s 上限打死
50
+ // (0 pass / 1 fail / Ran 1 test —— 见 #928、#1627)。5247ms 是**被截断的下界**,
51
+ // 不是测量值,所以余量按基线的 ~48x 取,而不是按那个数取。
48
52
  beforeAll(async () => {
49
53
  db.run(`INSERT INTO users (user_id, username, password_hash, role) VALUES (?1, 'attrs-user', 'x', 'user')`, [USER]);
50
54
  db.run(`INSERT INTO networks (network_id, network_name, owner_id) VALUES (?1, 'attrs-net', ?2)`, [NET, USER]);
@@ -58,7 +62,7 @@ beforeAll(async () => {
58
62
  token = issueUserToken(USER, "attrs-test").token;
59
63
  server = bootServer({ port: PORT, hostname: "127.0.0.1" }) as never;
60
64
  await new Promise((r) => setTimeout(r, 120));
61
- });
65
+ }, 30_000);
62
66
 
63
67
  afterAll(() => {
64
68
  try { server?.stop(true); } catch { /* already down */ }
@@ -211,3 +215,44 @@ describe("node display attrs — auth + scope", () => {
211
215
  expect(r.status).toBe(404);
212
216
  });
213
217
  });
218
+
219
+ // #2293(admin 2026-10-25)—— 走**真正**的 HTTP,不镜像 handler:
220
+ // 客户端「Runtime · V2」「OpenCode Server」和「模型可选列表」要的三样东西
221
+ // (代际 / 模式 / loopback 端点)与「这台机器上报的模型 id 清单」都在 /api/nodes 上,
222
+ // 而整个 config_snapshot 仍然不外泄(终端 #312 的约定)。
223
+ describe("#2293 opencode bits on GET /api/nodes (real HTTP)", () => {
224
+ const OC_NODE = "node_attrs_opencode";
225
+ const OC_ALIAS = "attrs-opencode-node";
226
+
227
+ test("generation / mode / server / catalog are projected; config_snapshot is not", async () => {
228
+ db.run(`DELETE FROM nodes WHERE node_id = ?1`, [OC_NODE]);
229
+ db.run(
230
+ `INSERT INTO nodes (node_id, node_name, alias, runtime, model, network_id, config_snapshot)
231
+ VALUES (?1, 'attrs-oc', ?2, 'opencode-sdk', 'deepseek/deepseek-flash', ?3, ?4)`,
232
+ [OC_NODE, OC_ALIAS, NET, JSON.stringify({
233
+ model: "deepseek/deepseek-flash",
234
+ flags: { opencodeGeneration: "v2", opencodeMode: "copresence", daemonSideSecret: "must-not-leak" },
235
+ opencode_server: "http://127.0.0.1:4096",
236
+ opencode_catalog: ["deepseek/deepseek-flash", "opencode/mimo-v2.6-flash-free"],
237
+ })],
238
+ );
239
+ const row = (await listNodes()).find((r) => r.node_id === OC_NODE)!;
240
+ expect(row).toBeDefined();
241
+ expect(row.opencode_generation).toBe("v2");
242
+ expect(row.opencode_mode).toBe("copresence");
243
+ expect(row.opencode_server).toBe("http://127.0.0.1:4096");
244
+ expect(row.opencode_catalog).toEqual(["deepseek/deepseek-flash", "opencode/mimo-v2.6-flash-free"]);
245
+ // 整个快照仍然不出现,且 flags 里的其它键不外泄。
246
+ expect(row).not.toHaveProperty("config_snapshot");
247
+ expect(JSON.stringify(row)).not.toContain("must-not-leak");
248
+ db.run(`DELETE FROM nodes WHERE node_id = ?1`, [OC_NODE]);
249
+ });
250
+
251
+ test("a node that never reported them reads as null / [] (old node, no invented values)", async () => {
252
+ const row = (await listNodes()).find((r) => r.node_id === LEGACY_NODE)!;
253
+ expect(row.opencode_generation ?? null).toBeNull();
254
+ expect(row.opencode_mode ?? null).toBeNull();
255
+ expect(row.opencode_server ?? null).toBeNull();
256
+ expect(row.opencode_catalog ?? null).toBeNull();
257
+ });
258
+ });