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

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 (444) 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 +494 -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/not-found-api-http.test.ts +67 -0
  208. package/src/observer-avatar-http.test.ts +103 -10
  209. package/src/observer-push.test.ts +76 -0
  210. package/src/opencode-catalog-report-http.test.ts +139 -0
  211. package/src/opencode-v2-catalog.test.ts +268 -0
  212. package/src/opencode-v2-catalog.ts +356 -0
  213. package/src/package-version-consistency.test.ts +25 -0
  214. package/src/parent-infer.test.ts +82 -0
  215. package/src/parent-infer.ts +110 -0
  216. package/src/parent-source-marker.test.ts +70 -0
  217. package/src/parent-source-orphan.test.ts +121 -0
  218. package/src/password-network-tokens.ts +25 -0
  219. package/src/peer-reply-atomic.test.ts +462 -0
  220. package/src/peer-reply-capability.test.ts +70 -0
  221. package/src/pg-worker.ts +87 -0
  222. package/src/poll-pacing.test.ts +74 -0
  223. package/src/poll-pacing.ts +123 -0
  224. package/src/probe-provider-error-domain.test.ts +145 -0
  225. package/src/project-dir-warn-clear-http.test.ts +132 -0
  226. package/src/project-viewer-can-http.test.ts +116 -0
  227. package/src/provider-skill-error-domain.test.ts +130 -0
  228. package/src/provider-tools-shape.test.ts +165 -0
  229. package/src/push.test.ts +20 -10
  230. package/src/push.ts +373 -9
  231. package/src/redact-tokens.test.ts +86 -0
  232. package/src/redact-tokens.ts +43 -0
  233. package/src/rejection-counters.test.ts +72 -0
  234. package/src/rejection-counters.ts +173 -0
  235. package/src/rename.ts +38 -10
  236. package/src/reply-target-derivation.test.ts +96 -0
  237. package/src/report-status-handover-capabilities-http.test.ts +124 -0
  238. package/src/report-status-host-schema.test.ts +235 -0
  239. package/src/report-status-resume-id-handover.test.ts +184 -0
  240. package/src/report-status-secret-keys.test.ts +140 -0
  241. package/src/require-explicit-test-db.ts +9 -0
  242. package/src/requirement-due-reminders-http.test.ts +620 -0
  243. package/src/requirement-due-reminders.ts +416 -0
  244. package/src/requirement-events-http.test.ts +318 -0
  245. package/src/requirement-events.test.ts +45 -0
  246. package/src/requirement-events.ts +144 -0
  247. package/src/requirement-notify.ts +165 -0
  248. package/src/requirement-participant-notify-http.test.ts +313 -0
  249. package/src/requirement-tag-ops-http.test.ts +454 -0
  250. package/src/requirement-tag-tree-http.test.ts +275 -0
  251. package/src/requirement-tag-tree.ts +127 -0
  252. package/src/requirement-tags.ts +102 -0
  253. package/src/requirements-abandoned-http.test.ts +236 -0
  254. package/src/requirements-assignee-drift.test.ts +154 -0
  255. package/src/requirements-comment-http.test.ts +174 -0
  256. package/src/requirements-completed-at-migration.test.ts +70 -0
  257. package/src/requirements-errors-mcp-http.test.ts +164 -0
  258. package/src/requirements-errors.ts +158 -0
  259. package/src/requirements-etag-http.test.ts +91 -0
  260. package/src/requirements-http.test.ts +709 -0
  261. package/src/requirements-last-event-http.test.ts +349 -0
  262. package/src/requirements-list-mcp-slim-http.test.ts +155 -0
  263. package/src/requirements-list-slim-http.test.ts +324 -0
  264. package/src/requirements-mcp.test.ts +180 -0
  265. package/src/requirements-migrate.ts +283 -0
  266. package/src/requirements-owner-strict-mcp-http.test.ts +145 -0
  267. package/src/requirements-people-http.test.ts +114 -0
  268. package/src/requirements-people-mcp-http.test.ts +231 -0
  269. package/src/requirements-people.ts +196 -0
  270. package/src/requirements-priority-lowest.test.ts +114 -0
  271. package/src/requirements-projects-network-echo.test.ts +57 -0
  272. package/src/requirements-projects-parent-http.test.ts +123 -0
  273. package/src/requirements-search-http.test.ts +182 -0
  274. package/src/requirements-search.test.ts +32 -0
  275. package/src/requirements-search.ts +145 -0
  276. package/src/requirements-seq-http.test.ts +193 -0
  277. package/src/requirements-seq-migration.test.ts +63 -0
  278. package/src/requirements-start-date.test.ts +125 -0
  279. package/src/requirements-stats-http.test.ts +357 -0
  280. package/src/requirements-stats.ts +195 -0
  281. package/src/requirements-status-participants-http.test.ts +222 -0
  282. package/src/requirements-upgrade-e2e.test.ts +126 -0
  283. package/src/requirements-upgrade-migration.test.ts +98 -0
  284. package/src/requirements.ts +2205 -0
  285. package/src/resolve-port.test.ts +57 -0
  286. package/src/resolve-port.ts +44 -0
  287. package/src/rest-alias-network-fallback-http.test.ts +123 -0
  288. package/src/rest-alias-network-fallback.test.ts +60 -0
  289. package/src/rest-alias-network-fallback.ts +65 -0
  290. package/src/rest-explicit-columns-http.test.ts +266 -0
  291. package/src/rest-identity.test.ts +130 -0
  292. package/src/rest-identity.ts +141 -0
  293. package/src/rest-projections.ts +72 -0
  294. package/src/rest-read-network-real-chain.test.ts +97 -0
  295. package/src/rest-write-network-resolution.test.ts +133 -0
  296. package/src/restart-readiness-http.test.ts +121 -0
  297. package/src/restricted-files.ts +76 -0
  298. package/src/retention-first-sweep-quiet.test.ts +31 -0
  299. package/src/retention.test.ts +100 -40
  300. package/src/retention.ts +423 -104
  301. package/src/route-callers-http.test.ts +120 -0
  302. package/src/route-timing.test.ts +218 -0
  303. package/src/route-timing.ts +262 -0
  304. package/src/rules-file-duplicate-alias.test.ts +234 -0
  305. package/src/rules-file-session-target.test.ts +207 -0
  306. package/src/rules-file-transport.test.ts +271 -0
  307. package/src/runtime-label.test.ts +22 -0
  308. package/src/runtime-label.ts +21 -0
  309. package/src/runtime-readiness.ts +90 -0
  310. package/src/schedule-agent-mcp-http.test.ts +486 -0
  311. package/src/schedule-agent.ts +252 -0
  312. package/src/schedule-starved.test.ts +92 -0
  313. package/src/schedule-starved.ts +114 -0
  314. package/src/scheduled-backoff-http.test.ts +203 -0
  315. package/src/scheduled-backoff.ts +64 -0
  316. package/src/scheduled-doorbell-nodeless-session.test.ts +134 -0
  317. package/src/scheduled-failure-backoff-2622.test.ts +145 -0
  318. package/src/scheduled-failure-code.test.ts +73 -0
  319. package/src/scheduled-failure-code.ts +105 -0
  320. package/src/scheduled-failures-http.test.ts +279 -0
  321. package/src/scheduled-failures.ts +425 -0
  322. package/src/scheduled-noprogress-backoff-2622.test.ts +163 -0
  323. package/src/scheduled-offline-backoff-probe.test.ts +56 -0
  324. package/src/scheduled-offline.test.ts +131 -0
  325. package/src/scheduled-offline.ts +66 -0
  326. package/src/scheduled-outcome-guidance-http.test.ts +139 -0
  327. package/src/scheduled-outcome-guidance.ts +9 -0
  328. package/src/scheduled-reply-unread-http.test.ts +212 -0
  329. package/src/scheduled-requirement-wake-http.test.ts +289 -0
  330. package/src/scheduled-requirement-wake.ts +125 -0
  331. package/src/scheduled-run-terminal.test.ts +290 -0
  332. package/src/scheduled-skip-blocking-task.test.ts +120 -0
  333. package/src/scheduled-skip-path-backoff-2622.test.ts +98 -0
  334. package/src/scheduled-stuck-http.test.ts +316 -0
  335. package/src/scheduled-stuck-notice-cap.test.ts +80 -0
  336. package/src/scheduled-stuck.ts +219 -0
  337. package/src/scheduled-tasks-http.test.ts +679 -0
  338. package/src/scheduled-tasks.ts +959 -0
  339. package/src/scheduled-work-outcome-http.test.ts +154 -0
  340. package/src/scheduled-work-outcome.ts +50 -0
  341. package/src/scoped-secrets.ts +167 -0
  342. package/src/secret-echo-negative-control.test.ts +118 -0
  343. package/src/send-dedup-request-id.test.ts +229 -0
  344. package/src/send-reply-agent-warning.test.ts +38 -38
  345. package/src/send-reply-alias-optional.test.ts +131 -0
  346. package/src/send-reply-attachments.test.ts +28 -7
  347. package/src/send_dedup.test.ts +54 -0
  348. package/src/send_dedup.ts +52 -6
  349. package/src/serve-error.test.ts +73 -0
  350. package/src/serve-error.ts +56 -0
  351. package/src/server.ts +4930 -377
  352. package/src/session-task-on-dispatch.ts +14 -0
  353. package/src/session-token-ownership-http.test.ts +122 -0
  354. package/src/shared/codex-inventory.ts +41 -0
  355. package/src/shared/daemon-provider-login.ts +31 -0
  356. package/src/shared/daemon-provider-snapshot.ts +52 -0
  357. package/src/shared/external-schedule-contract.ts +60 -0
  358. package/src/shared/node-name.test.ts +62 -0
  359. package/src/shared/node-name.ts +161 -0
  360. package/src/shared/probe-host-allowlist-drift.test.ts +45 -0
  361. package/src/shared/provider-application.ts +29 -0
  362. package/src/shared/provider-collection.ts +14 -0
  363. package/src/shared/provider-initialization.ts +8 -0
  364. package/src/shared/reserved-env-drift.test.ts +10 -0
  365. package/src/shared/scoped-secret-contract.ts +5 -0
  366. package/src/shared/task-content-limit-drift.test.ts +28 -0
  367. package/src/shared/task-content-limit.ts +25 -0
  368. package/src/side-thread-command-transport.test.ts +312 -0
  369. package/src/side-thread-command-transport.ts +318 -0
  370. package/src/side-thread-http-integration.test.ts +233 -0
  371. package/src/side-thread-http.ts +504 -0
  372. package/src/side-thread-production.test.ts +72 -0
  373. package/src/side-thread-production.ts +118 -0
  374. package/src/side-thread.test.ts +1067 -0
  375. package/src/side-thread.ts +2499 -0
  376. package/src/skillhub-http.test.ts +144 -0
  377. package/src/sqlite-close-checkpoint.test.ts +78 -0
  378. package/src/start-node.test.ts +265 -0
  379. package/src/start-request-error-domain.test.ts +182 -0
  380. package/src/start-skill-error-domain.test.ts +122 -0
  381. package/src/stats-versions-http.test.ts +65 -0
  382. package/src/status-alias-filter-http.test.ts +106 -0
  383. package/src/status-alias-resolver-http.test.ts +163 -0
  384. package/src/status-alias-resolver.ts +19 -0
  385. package/src/status-node-id-filter-http.test.ts +161 -0
  386. package/src/status-read-cache-http.test.ts +229 -0
  387. package/src/status-read-cache.ts +129 -0
  388. package/src/stop-delete-node.test.ts +567 -1
  389. package/src/task-access-http.test.ts +407 -0
  390. package/src/task-access.ts +420 -0
  391. package/src/task-activity.ts +60 -0
  392. package/src/task-auth-origin-http.test.ts +93 -0
  393. package/src/task-auth-origin.test.ts +24 -0
  394. package/src/task-auth-origin.ts +7 -0
  395. package/src/task-consumption.test.ts +508 -0
  396. package/src/task-diagnostic-http.test.ts +149 -0
  397. package/src/task-diagnostic.test.ts +115 -0
  398. package/src/task-diagnostic.ts +118 -0
  399. package/src/task-expiry-notice-http.test.ts +298 -0
  400. package/src/task-expiry-notice.ts +318 -0
  401. package/src/task-idempotency-mcp.test.ts +148 -0
  402. package/src/task-idempotency.test.ts +76 -0
  403. package/src/task-idempotency.ts +81 -0
  404. package/src/task-late-replies.ts +54 -0
  405. package/src/task-late-reply-http.test.ts +227 -0
  406. package/src/task-lifecycle-watcher-busy.test.ts +114 -0
  407. package/src/task-lifecycle-watcher.test.ts +209 -0
  408. package/src/task-lifecycle-watcher.ts +109 -0
  409. package/src/task-network-resolution-http.test.ts +140 -0
  410. package/src/task-not-found-error-domain.test.ts +114 -0
  411. package/src/task-offline-delivery-2668.test.ts +119 -0
  412. package/src/task-offline-delivery.ts +81 -0
  413. package/src/task-orphan-http.test.ts +287 -0
  414. package/src/task-orphan.ts +119 -0
  415. package/src/task-queue-ahead-http.test.ts +309 -0
  416. package/src/task-queue-ahead-scale.test.ts +236 -0
  417. package/src/task-queue-ahead.ts +186 -0
  418. package/src/task-rejection-log-http.test.ts +160 -0
  419. package/src/task-rejection-log.ts +61 -0
  420. package/src/task-sender-http.test.ts +143 -0
  421. package/src/task-stale-open-http.test.ts +292 -0
  422. package/src/task-stale-open.ts +103 -0
  423. package/src/tasks-pagination-http.test.ts +141 -0
  424. package/src/team-rules-status-http.test.ts +90 -0
  425. package/src/team-rules-status.test.ts +59 -0
  426. package/src/team-rules-status.ts +72 -0
  427. package/src/tmux-allowlist.test.ts +48 -0
  428. package/src/tool-audience-http.test.ts +248 -0
  429. package/src/tool-audience.ts +127 -0
  430. package/src/tools-list-json-schema.test.ts +94 -0
  431. package/src/tools.ts +4314 -392
  432. package/src/update-node-config-error-domain.test.ts +107 -0
  433. package/src/uploads-http.test.ts +6 -4
  434. package/src/uploads.ts +23 -4
  435. package/src/user-avatar-http.test.ts +74 -0
  436. package/src/user-avatar-image.ts +160 -0
  437. package/src/user-avatar-migration.test.ts +25 -0
  438. package/src/user-avatar-upload-http.test.ts +353 -0
  439. package/src/user-inbox-by-agent-http.test.ts +189 -0
  440. package/src/user-inbox-netid-notnull.test.ts +122 -0
  441. package/src/user-inbox-read-http.test.ts +223 -0
  442. package/src/user-inbox-schema.test.ts +54 -0
  443. package/src/version-stats.test.ts +66 -0
  444. package/src/version-stats.ts +109 -0
@@ -0,0 +1,266 @@
1
+ // Node run-log view — tail_node_logs rides the rules-file queue + doorbell (op logs_tail).
2
+ //
3
+ // Hub-side contract verified here:
4
+ // 1. report_status { logs_capable: true } is sticky and set only by the node's
5
+ // own token; /api/status-shaped rows expose it.
6
+ // 2. The pulled request carries only the normalised filter JSON — no path field
7
+ // exists anywhere in the tool schema; unknown args are dropped.
8
+ // 3. Who may ask: user logins only (node tokens refused); the network owner/admin,
9
+ // or the node's owner (nodes.owner_user_id). A member who does not own the
10
+ // node, a viewer, and a user of another network are refused before any row.
11
+ // 4. Who may read: only the token that asked (like the project folder).
12
+ // 5. Storage: the result is handed out ONCE — the first terminal read purges
13
+ // result_content and the filter JSON; the second read says content_purged.
14
+ // An unread terminal result is purged by the sweep after LOGS_CONTENT_TTL_MS.
15
+ // 6. Own single-flight lane; logs acks may carry up to 1 MiB.
16
+ //
17
+ // 跑法:cd server && COMMHUB_DB=/tmp/logs-transport.db bun test src/node-logs-transport.test.ts
18
+ import { afterAll, beforeEach, describe, expect, test } from "bun:test";
19
+ import { Client } from "@modelcontextprotocol/sdk/client/index.js";
20
+ import { InMemoryTransport } from "@modelcontextprotocol/sdk/inMemory.js";
21
+ import { McpServer } from "@modelcontextprotocol/sdk/server/mcp.js";
22
+ import { db } from "./db.js";
23
+ import { registerTools } from "./tools.js";
24
+ import { LOGS_CONTENT_TTL_MS, sweepNodeRequestContent } from "./node-request-retention.js";
25
+
26
+ const NET = "net_logs_t";
27
+ const OTHER_NET = "net_logs_t_other";
28
+ const OWNER = "u_logs_net_owner";
29
+ const MEMBER = "u_logs_member_owns_a";
30
+ const MEMBER2 = "u_logs_member_plain";
31
+ const VIEWER = "u_logs_viewer";
32
+ const OUTSIDER = "u_logs_outsider";
33
+ const NODE_A = "logs-node-a";
34
+ const NODE_B = "logs-node-b";
35
+ const NODE_A_ID = "node_logs_a";
36
+ const NODE_B_ID = "node_logs_b";
37
+ const T_A = "tok_logs_node_a";
38
+ const T_B = "tok_logs_node_b";
39
+
40
+ function cleanup() {
41
+ for (const net of [NET, OTHER_NET]) {
42
+ for (const t of ["node_rules_requests", "sessions", "nodes", "api_tokens", "network_members", "networks"]) {
43
+ try { db.run(`DELETE FROM ${t} WHERE network_id = ?1`, [net]); } catch {}
44
+ }
45
+ }
46
+ for (const u of [OWNER, MEMBER, MEMBER2, VIEWER, OUTSIDER]) {
47
+ try { db.run("DELETE FROM users WHERE user_id = ?1", [u]); } catch {}
48
+ }
49
+ }
50
+
51
+ function seedWorld() {
52
+ for (const u of [OWNER, MEMBER, MEMBER2, VIEWER, OUTSIDER]) {
53
+ db.run(`INSERT INTO users (user_id, username, password_hash, role, created_at) VALUES (?1, ?2, 'x', 'user', datetime('now'))`, [u, u]);
54
+ }
55
+ db.run(`INSERT INTO networks (network_id, network_name, owner_id, created_at) VALUES (?1, ?2, ?3, datetime('now'))`, [NET, NET, OWNER]);
56
+ db.run(`INSERT INTO networks (network_id, network_name, owner_id, created_at) VALUES (?1, ?2, ?3, datetime('now'))`, [OTHER_NET, OTHER_NET, OUTSIDER]);
57
+ const member = (u: string, net: string, role: string) =>
58
+ db.run(`INSERT INTO network_members (user_id, network_id, role, joined_at) VALUES (?1, ?2, ?3, datetime('now'))`, [u, net, role]);
59
+ member(OWNER, NET, "owner");
60
+ member(MEMBER, NET, "member");
61
+ member(MEMBER2, NET, "member");
62
+ member(VIEWER, NET, "viewer");
63
+ member(OUTSIDER, OTHER_NET, "owner");
64
+ const node = (id: string, alias: string, owner: string | null) => db.run(
65
+ `INSERT INTO nodes (node_id, node_name, alias, network_id, owner_user_id, created_at, updated_at) VALUES (?1, ?2, ?3, ?4, ?5, datetime('now'), datetime('now'))`,
66
+ [id, alias, alias, NET, owner],
67
+ );
68
+ node(NODE_A_ID, NODE_A, MEMBER);
69
+ node(NODE_B_ID, NODE_B, OWNER);
70
+ const tok = (id: string, alias: string, bound: string) => db.run(
71
+ `INSERT INTO api_tokens (token_id, user_id, network_id, scope, name, token_hash, expires_at, revoked_at, bound_node_id) VALUES (?1, ?2, ?3, 'network', ?4, ?5, NULL, NULL, ?6)`,
72
+ [id, OWNER, NET, `node:${alias}`, `hash_${id}`, bound],
73
+ );
74
+ tok(T_A, NODE_A, NODE_A_ID);
75
+ tok(T_B, NODE_B, NODE_B_ID);
76
+ }
77
+
78
+ type Identity = { net: string | null; user: string; alias: string; isNetworkToken: boolean; tokenId: string };
79
+ const asOwner: Identity = { net: null, user: OWNER, alias: OWNER, isNetworkToken: false, tokenId: "tok_logs_owner_login" };
80
+ const asOwnerOtherLogin: Identity = { ...asOwner, tokenId: "tok_logs_owner_login_2" };
81
+ const asMember: Identity = { net: null, user: MEMBER, alias: MEMBER, isNetworkToken: false, tokenId: "tok_logs_member_login" };
82
+ const asMember2: Identity = { net: null, user: MEMBER2, alias: MEMBER2, isNetworkToken: false, tokenId: "tok_logs_member2_login" };
83
+ const asViewer: Identity = { net: null, user: VIEWER, alias: VIEWER, isNetworkToken: false, tokenId: "tok_logs_viewer_login" };
84
+ const asOutsider: Identity = { net: null, user: OUTSIDER, alias: OUTSIDER, isNetworkToken: false, tokenId: "tok_logs_outsider_login" };
85
+ const asA: Identity = { net: NET, user: OWNER, alias: NODE_A, isNetworkToken: true, tokenId: T_A };
86
+ const asB: Identity = { net: NET, user: OWNER, alias: NODE_B, isNetworkToken: true, tokenId: T_B };
87
+
88
+ async function connect(id: Identity) {
89
+ const server = new McpServer({ name: "logs-test", version: "1" });
90
+ registerTools(server, undefined, id.net, id.user, id.alias, id.isNetworkToken, id.tokenId);
91
+ const client = new Client({ name: "logs-client", version: "1" });
92
+ const [ct, st] = InMemoryTransport.createLinkedPair();
93
+ await server.connect(st);
94
+ await client.connect(ct);
95
+ const call = async (name: string, args: Record<string, unknown>) => {
96
+ const r: any = await client.callTool({ name, arguments: args });
97
+ const first = r.content?.[0];
98
+ if (!first || first.type !== "text") throw new Error(`no text result from ${name}: ${JSON.stringify(r).slice(0, 300)}`);
99
+ try { return JSON.parse(first.text); } catch { return { raw: first.text, isError: r.isError === true }; }
100
+ };
101
+ const close = async () => { await client.close(); await server.close(); };
102
+ return { call, close };
103
+ }
104
+
105
+ const rowCount = () => db.get<{ n: number }>("SELECT COUNT(*) AS n FROM node_rules_requests WHERE network_id = ?1", NET)!.n;
106
+ const row = (id: string) => db.get<any>("SELECT op, content, result_content, content_purged_at FROM node_rules_requests WHERE request_id = ?1", id);
107
+ const SAMPLE = JSON.stringify({ files: ["2026-09-29.log"], lines: [{ ts: 1, level: "info", text: "[10:00:00] [INFO ] [x] hello", key: "2026-09-29.log:0" }], truncated: false, matched: 1, now_ts: 2 });
108
+
109
+ beforeEach(() => { cleanup(); seedWorld(); });
110
+ afterAll(cleanup);
111
+
112
+ describe("logs_capable", () => {
113
+ test("set by the node's own token, sticky, not settable by a user login", async () => {
114
+ const a = await connect(asA);
115
+ try {
116
+ await a.call("report_status", { resume_id: `sdk-${NODE_A_ID}`, alias: NODE_A, status: "idle", node_id: NODE_A_ID, logs_capable: true });
117
+ await a.call("report_status", { resume_id: `sdk-${NODE_A_ID}`, alias: NODE_A, status: "idle", node_id: NODE_A_ID });
118
+ } finally { await a.close(); }
119
+ expect(db.get<{ c: number }>("SELECT logs_capable AS c FROM sessions WHERE alias = ?1 AND network_id = ?2", NODE_A, NET)?.c).toBe(1);
120
+ const u = await connect(asOwner);
121
+ try {
122
+ await u.call("report_status", { resume_id: "user-logs-report", alias: NODE_B, status: "idle", network_id: NET, logs_capable: true });
123
+ } finally { await u.close(); }
124
+ expect(db.get<{ c: number }>("SELECT logs_capable AS c FROM sessions WHERE alias = ?1 AND network_id = ?2", NODE_B, NET)?.c ?? 0).toBe(0);
125
+ }, 20_000);
126
+ });
127
+
128
+ describe("round trip", () => {
129
+ test("the node pulls only the normalised filter JSON (no path), acks, the asker reads it once", async () => {
130
+ const u = await connect(asOwner);
131
+ const a = await connect(asA);
132
+ try {
133
+ const enq = await u.call("tail_node_logs", { node_id: NODE_A_ID, network_id: NET, lines: 99999 > 2000 ? 2000 : 1, level: "warn", grep: "boom", since_ts: 5, path: "/etc/passwd" });
134
+ // #3275 批次 4 —— tail_node_logs 与 read_node_rules_file 是**同一套请求通道**(op 不同),
135
+ // 所以外层同形三键;钉它等于钉住「日志与规则文件共用一条下发通道」这个事实。
136
+ expect(Object.keys(enq).sort()).toEqual(["ok", "op", "request_id"]);
137
+ expect(enq).toMatchObject({ ok: true, op: "logs_tail" });
138
+ const pulled = (await a.call("get_rules_file_request", {})).request;
139
+ expect(pulled.op).toBe("logs_tail");
140
+ expect(JSON.parse(pulled.content)).toEqual({ lines: 2000, level: "warn", grep: "boom", since_ts: 5 });
141
+ expect(pulled.content).not.toContain("passwd");
142
+ expect(await a.call("ack_rules_file_request", { request_id: enq.request_id, status: "done", file_name: "logs", exists: true, content: SAMPLE })).toMatchObject({ ok: true, status: "done" });
143
+
144
+ const first = await u.call("get_rules_file_result", { request_id: enq.request_id, network_id: NET });
145
+ expect(first).toMatchObject({ ok: true, op: "logs_tail", status: "done", content: SAMPLE });
146
+ // Read-once: purged in the same call, including the filter JSON.
147
+ expect(row(enq.request_id)).toMatchObject({ result_content: null, content: null });
148
+ expect(row(enq.request_id).content_purged_at).toBeGreaterThan(0);
149
+ const second = await u.call("get_rules_file_result", { request_id: enq.request_id, network_id: NET });
150
+ expect(second.content).toBeUndefined();
151
+ expect(second.content_purged).toBe(true);
152
+ } finally { await u.close(); await a.close(); }
153
+ }, 20_000);
154
+
155
+ test("lines above 2000 are refused by the schema; bad level refused", async () => {
156
+ const u = await connect(asOwner);
157
+ try {
158
+ expect((await u.call("tail_node_logs", { node_id: NODE_A_ID, network_id: NET, lines: 2001 })).ok).not.toBe(true);
159
+ expect((await u.call("tail_node_logs", { node_id: NODE_A_ID, network_id: NET, level: "debug" })).ok).not.toBe(true);
160
+ expect(rowCount()).toBe(0);
161
+ } finally { await u.close(); }
162
+ }, 20_000);
163
+ });
164
+
165
+ describe("who may ask", () => {
166
+ test("node tokens are refused — for other nodes and for themselves", async () => {
167
+ const a = await connect(asA);
168
+ try {
169
+ expect(await a.call("tail_node_logs", { node_id: NODE_B_ID })).toMatchObject({ ok: false, error: "node_token_cannot_read_logs" });
170
+ expect(await a.call("tail_node_logs", { node_id: NODE_A_ID })).toMatchObject({ ok: false, error: "node_token_cannot_read_logs" });
171
+ expect(rowCount()).toBe(0);
172
+ } finally { await a.close(); }
173
+ }, 20_000);
174
+
175
+ test("node owner yes; plain member no; viewer no; network owner yes", async () => {
176
+ const m = await connect(asMember);
177
+ const m2 = await connect(asMember2);
178
+ const v = await connect(asViewer);
179
+ const o = await connect(asOwner);
180
+ try {
181
+ expect(await m.call("tail_node_logs", { node_id: NODE_A_ID, network_id: NET })).toMatchObject({ ok: true });
182
+ expect(await m.call("tail_node_logs", { node_id: NODE_B_ID, network_id: NET })).toMatchObject({ ok: false, error: "logs_permission_denied" });
183
+ expect(await m2.call("tail_node_logs", { node_id: NODE_A_ID, network_id: NET })).toMatchObject({ ok: false, error: "logs_permission_denied" });
184
+ expect((await v.call("tail_node_logs", { node_id: NODE_B_ID, network_id: NET })).ok).toBe(false);
185
+ expect(await o.call("tail_node_logs", { node_id: NODE_B_ID, network_id: NET })).toMatchObject({ ok: true });
186
+ expect(rowCount()).toBe(2);
187
+ } finally { await m.close(); await m2.close(); await v.close(); await o.close(); }
188
+ }, 20_000);
189
+
190
+ test("a user of another network is refused (cross network)", async () => {
191
+ const x = await connect(asOutsider);
192
+ try {
193
+ const r1 = await x.call("tail_node_logs", { node_id: NODE_A_ID, network_id: NET });
194
+ expect(r1.ok).toBe(false);
195
+ const r2 = await x.call("tail_node_logs", { node_id: NODE_A_ID, network_id: OTHER_NET });
196
+ expect(r2).toMatchObject({ ok: false, error: "cross_network_node" });
197
+ expect(rowCount()).toBe(0);
198
+ } finally { await x.close(); }
199
+ }, 20_000);
200
+ });
201
+
202
+ describe("who may read", () => {
203
+ test("only the login that asked; another login of the same user, node tokens and the serving node cannot", async () => {
204
+ const u = await connect(asOwner);
205
+ const other = await connect(asOwnerOtherLogin);
206
+ const b = await connect(asB);
207
+ const a = await connect(asA);
208
+ try {
209
+ const enq = await u.call("tail_node_logs", { node_id: NODE_A_ID, network_id: NET });
210
+ await a.call("get_rules_file_request", {});
211
+ await a.call("ack_rules_file_request", { request_id: enq.request_id, status: "done", content: SAMPLE });
212
+ expect(await other.call("get_rules_file_result", { request_id: enq.request_id, network_id: NET })).toMatchObject({ ok: false, error: "request_not_found" });
213
+ expect(await b.call("get_rules_file_result", { request_id: enq.request_id })).toMatchObject({ ok: false, error: "request_not_found" });
214
+ expect(await a.call("get_rules_file_result", { request_id: enq.request_id })).toMatchObject({ ok: false, error: "request_not_found" });
215
+ // Those refusals did not consume the read-once result.
216
+ expect(await u.call("get_rules_file_result", { request_id: enq.request_id, network_id: NET })).toMatchObject({ status: "done", content: SAMPLE });
217
+ } finally { await u.close(); await other.close(); await b.close(); await a.close(); }
218
+ }, 20_000);
219
+
220
+ test("node B never pulls or acks node A's logs request", async () => {
221
+ const u = await connect(asOwner);
222
+ const a = await connect(asA);
223
+ const b = await connect(asB);
224
+ try {
225
+ const enq = await u.call("tail_node_logs", { node_id: NODE_A_ID, network_id: NET });
226
+ expect((await b.call("get_rules_file_request", {})).request).toBeNull();
227
+ expect(await b.call("ack_rules_file_request", { request_id: enq.request_id, status: "done", content: "{\"forged\":true}" })).toMatchObject({ ignored: "unknown_or_foreign_request" });
228
+ expect((await a.call("get_rules_file_request", {})).request.request_id).toBe(enq.request_id);
229
+ } finally { await u.close(); await a.close(); await b.close(); }
230
+ }, 20_000);
231
+ });
232
+
233
+ describe("storage and lanes", () => {
234
+ test("an unread terminal result is purged by the sweep after the logs TTL; other ops keep theirs", async () => {
235
+ const u = await connect(asOwner);
236
+ const a = await connect(asA);
237
+ try {
238
+ const enq = await u.call("tail_node_logs", { node_id: NODE_A_ID, network_id: NET });
239
+ const rules = await u.call("read_node_rules_file", { node_id: NODE_A_ID, network_id: NET });
240
+ await a.call("get_rules_file_request", {});
241
+ await a.call("get_rules_file_request", {});
242
+ await a.call("ack_rules_file_request", { request_id: enq.request_id, status: "done", content: SAMPLE });
243
+ await a.call("ack_rules_file_request", { request_id: rules.request_id, status: "done", content: "# rules" });
244
+ sweepNodeRequestContent(Date.now() + LOGS_CONTENT_TTL_MS - 5_000);
245
+ expect(row(enq.request_id).result_content).toBe(SAMPLE);
246
+ sweepNodeRequestContent(Date.now() + LOGS_CONTENT_TTL_MS + 5_000);
247
+ expect(row(enq.request_id)).toMatchObject({ result_content: null, content: null });
248
+ expect(row(rules.request_id).result_content).toBe("# rules");
249
+ } finally { await u.close(); await a.close(); }
250
+ }, 20_000);
251
+
252
+ test("own single-flight lane; a 1 MiB-class ack is accepted", async () => {
253
+ const u = await connect(asOwner);
254
+ const a = await connect(asA);
255
+ try {
256
+ expect(await u.call("list_node_files", { node_id: NODE_A_ID, network_id: NET })).toMatchObject({ ok: true });
257
+ const first = await u.call("tail_node_logs", { node_id: NODE_A_ID, network_id: NET });
258
+ expect(first).toMatchObject({ ok: true });
259
+ expect(await u.call("tail_node_logs", { node_id: NODE_A_ID, network_id: NET })).toMatchObject({ ok: false, error: "request_in_flight", existing_request_id: first.request_id });
260
+ await a.call("get_rules_file_request", {});
261
+ await a.call("get_rules_file_request", {});
262
+ const big = "x".repeat(700 * 1024);
263
+ expect(await a.call("ack_rules_file_request", { request_id: first.request_id, status: "done", content: big })).toMatchObject({ ok: true, status: "done" });
264
+ } finally { await u.close(); await a.close(); }
265
+ }, 20_000);
266
+ });
@@ -0,0 +1,114 @@
1
+ // #2969 —— 节点级对端白名单。
2
+ //
3
+ // 需求(admin 2026-10-29):「限制他能和哪些节点通信」。
4
+ // 现有能力只有「人这一层」的 agent_access=granted(授权一个 Agent = 它能找**所有**被授权对端),
5
+ // 做不到「只许 A 找 B,不许 A 找 C」。
6
+ //
7
+ // 这一列是**主人主动设的**,因此与 readonly / restricted 同类:设了就立刻生效、不看开关。
8
+ // NULL = 不限制 ⇒ 对现有 300+ 节点行为零变化。
9
+ import { describe, expect, test, beforeAll } from "bun:test";
10
+ import { mkdtempSync } from "node:fs";
11
+ import { tmpdir } from "node:os";
12
+ import { join } from "node:path";
13
+
14
+ const DIR = mkdtempSync(join(tmpdir(), "anet-peer-allow-"));
15
+ process.env.COMMHUB_DB ||= join(DIR, "hub.db");
16
+
17
+ let mod: typeof import("./node-permissions.js");
18
+ beforeAll(async () => { mod = await import("./node-permissions.js"); });
19
+
20
+ const id = (peerAllowlist: string[] | null, mode: "normal" | "readonly" | "restricted" = "normal", toolAllowlist: string[] | null = null) => ({
21
+ networkId: "net_test",
22
+ nodeId: "n_self",
23
+ logKey: "n_self",
24
+ aliases: ["self-alias"],
25
+ ownerUserId: "u_owner",
26
+ mode,
27
+ peerAllowlist,
28
+ toolAllowlist,
29
+ });
30
+
31
+ describe("#2969 对端白名单", () => {
32
+ test("null ⇒ 完全不受限(与今天的行为一致)", () => {
33
+ expect(mod.dispatchVerdict(id(null), { alias: "anyone", nodeId: "n_any" })).toBeNull();
34
+ });
35
+
36
+ test("名单命中(按 alias)⇒ 放行", () => {
37
+ expect(mod.dispatchVerdict(id(["alice"]), { alias: "alice", nodeId: "n_alice" })).toBeNull();
38
+ });
39
+
40
+ test("名单命中(按 node_id)⇒ 放行 —— 主人可能只写 id", () => {
41
+ expect(mod.dispatchVerdict(id(["n_alice"]), { alias: "alice", nodeId: "n_alice" })).toBeNull();
42
+ });
43
+
44
+ test("不在名单上 ⇒ peer_not_allowed", () => {
45
+ expect(mod.dispatchVerdict(id(["alice"]), { alias: "bob", nodeId: "n_bob" }))
46
+ .toEqual({ reason: "peer_not_allowed", sample: "bob" });
47
+ });
48
+
49
+ test("发给自己的另一个 alias 仍然放行(白名单不该挡住自派)", () => {
50
+ // dispatchVerdict 的第一条早退:目标是自己的 alias / node_id ⇒ null
51
+ expect(mod.dispatchVerdict(id(["alice"]), { alias: "self-alias", nodeId: "n_self" })).toBeNull();
52
+ });
53
+
54
+ test("白名单是显式原因:开关为 off 也照拒(与 readonly 同类)", () => {
55
+ const saved = process.env.COMMHUB_NODE_PERMISSIONS;
56
+ process.env.COMMHUB_NODE_PERMISSIONS = "off";
57
+ try {
58
+ expect(mod.nodeDecide(id(["alice"]), "mcp:send_task", { reason: "peer_not_allowed" })).toBe(true);
59
+ } finally {
60
+ if (saved === undefined) delete process.env.COMMHUB_NODE_PERMISSIONS;
61
+ else process.env.COMMHUB_NODE_PERMISSIONS = saved;
62
+ }
63
+ });
64
+
65
+ test("设了白名单 ⇒ 不能广播(广播的收件人是任意对端)", () => {
66
+ expect(mod.broadcastVerdict(id(["alice"]))).toEqual({ reason: "peer_not_allowed" });
67
+ expect(mod.broadcastVerdict(id(null))).toBeNull();
68
+ });
69
+
70
+ test("正常模式下的人类专属写操作,开关为 off 时仍放行(对照,防止把一切都变显式)", () => {
71
+ const saved = process.env.COMMHUB_NODE_PERMISSIONS;
72
+ process.env.COMMHUB_NODE_PERMISSIONS = "off";
73
+ try {
74
+ expect(mod.nodeDecide(id(null), "mcp:projects_create", { reason: "human_only" })).toBe(false);
75
+ } finally {
76
+ if (saved === undefined) delete process.env.COMMHUB_NODE_PERMISSIONS;
77
+ else process.env.COMMHUB_NODE_PERMISSIONS = saved;
78
+ }
79
+ });
80
+ });
81
+
82
+ // #2969 后半 —— 接口白名单。
83
+ describe("#2969 接口白名单", () => {
84
+ test("null ⇒ 不限制(与今天一致)", () => {
85
+ expect(mod.toolAllowlistVerdict(id(null, "normal", null), "send_task", false)).toBeNull();
86
+ });
87
+
88
+ test("名单内的工具 ⇒ 放行", () => {
89
+ expect(mod.toolAllowlistVerdict(id(null, "normal", ["send_task"]), "send_task", false)).toBeNull();
90
+ });
91
+
92
+ test("名单外的工具 ⇒ tool_not_allowed", () => {
93
+ expect(mod.toolAllowlistVerdict(id(null, "normal", ["send_task"]), "broadcast", false))
94
+ .toEqual({ reason: "tool_not_allowed", sample: "broadcast" });
95
+ });
96
+
97
+ test("always 类永远放行 —— 否则节点连回报都做不了", () => {
98
+ const listed = id(null, "normal", ["send_task"]);
99
+ for (const t of ["get_inbox", "ack_inbox", "send_reply", "report_status"]) {
100
+ expect(mod.toolAllowlistVerdict(listed, t, true)).toBeNull();
101
+ }
102
+ });
103
+
104
+ test("它是显式原因:开关 off 也照拒", () => {
105
+ const saved = process.env.COMMHUB_NODE_PERMISSIONS;
106
+ process.env.COMMHUB_NODE_PERMISSIONS = "off";
107
+ try {
108
+ expect(mod.nodeDecide(id(null, "normal", ["send_task"]), "mcp:broadcast", { reason: "tool_not_allowed" })).toBe(true);
109
+ } finally {
110
+ if (saved === undefined) delete process.env.COMMHUB_NODE_PERMISSIONS;
111
+ else process.env.COMMHUB_NODE_PERMISSIONS = saved;
112
+ }
113
+ });
114
+ });