@sleep2agi/commhub-server 0.9.0-preview.25 → 0.9.0-preview.250

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 (417) hide show
  1. package/README.md +129 -9
  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 +228 -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 +487 -0
  13. package/src/agent-acl-groups-http.test.ts +247 -0
  14. package/src/agent-acl-http.test.ts +675 -0
  15. package/src/agent-acl-slice3-http.test.ts +717 -0
  16. package/src/agent-department-http.test.ts +215 -0
  17. package/src/agent-groups-perf.test.ts +223 -0
  18. package/src/agent-notice.ts +48 -0
  19. package/src/agent-team-whoami-http.test.ts +98 -0
  20. package/src/agent-teams-http.test.ts +330 -0
  21. package/src/agent-teams.ts +244 -0
  22. package/src/alias-baseline-2571.test.ts +162 -0
  23. package/src/alias-baseline.ts +113 -0
  24. package/src/alias-filter.test.ts +72 -0
  25. package/src/alias-filter.ts +42 -0
  26. package/src/api-host-supervisors-can-create-nodes.test.ts +350 -0
  27. package/src/api-host-supervisors-fallback.test.ts +6 -7
  28. package/src/api-host-supervisors-runtime-readiness.test.ts +195 -0
  29. package/src/api-nodes-shape.test.ts +95 -4
  30. package/src/auth-password-change-cli-tokens-http.test.ts +423 -0
  31. package/src/auth-sessions-http.test.ts +260 -0
  32. package/src/auth-validate.test.ts +5 -1
  33. package/src/auth-weak-password-login.test.ts +176 -0
  34. package/src/auth.ts +609 -51
  35. package/src/avatar-validate.test.ts +52 -2
  36. package/src/avatar-validate.ts +35 -1
  37. package/src/backfill-node-ids-2664.test.ts +128 -0
  38. package/src/binding-generation-http.test.ts +132 -0
  39. package/src/blocked-exit-on-reply.test.ts +122 -0
  40. package/src/broadcast-fanout-2721.test.ts +149 -0
  41. package/src/broadcast-fanout.ts +117 -0
  42. package/src/build-info.test.ts +60 -0
  43. package/src/build-info.ts +85 -0
  44. package/src/chain-attempt-dedup.test.ts +447 -0
  45. package/src/clip.test.ts +36 -0
  46. package/src/clip.ts +48 -0
  47. package/src/clone-node.test.ts +262 -0
  48. package/src/clone-node.ts +289 -0
  49. package/src/codex-config-flags.ts +77 -0
  50. package/src/codex-fork-contract.ts +23 -0
  51. package/src/codex-fork-migration.test.ts +38 -0
  52. package/src/commhub-bin-args.test.ts +85 -0
  53. package/src/config-apply-validate.test.ts +188 -1
  54. package/src/config-apply-validate.ts +222 -3
  55. package/src/cors-origins.test.ts +73 -0
  56. package/src/create-node-blocked-gate.test.ts +356 -0
  57. package/src/create-node-network-id.test.ts +91 -0
  58. package/src/create-node-tool-schema.test.ts +49 -0
  59. package/src/create-node-unicode-name.test.ts +126 -0
  60. package/src/create-node-validate.test.ts +199 -7
  61. package/src/create-node-validate.ts +232 -15
  62. package/src/create-node-workdir.test.ts +298 -0
  63. package/src/create-node.ts +88 -23
  64. package/src/daemon-provider-snapshots.test.ts +445 -0
  65. package/src/daemon-provider-snapshots.ts +327 -0
  66. package/src/daemon-token-owner-http.test.ts +292 -0
  67. package/src/dashboard-slash-routing-http.test.ts +109 -0
  68. package/src/db-adapter-guard.test.ts +148 -0
  69. package/src/db-adapter-translate.test.ts +128 -0
  70. package/src/db-adapter.ts +377 -91
  71. package/src/db-timestamp.test.ts +38 -0
  72. package/src/db-timestamp.ts +15 -0
  73. package/src/db.ts +1264 -153
  74. package/src/delivered-without-push.test.ts +140 -0
  75. package/src/department-groups-http.test.ts +209 -0
  76. package/src/department-groups-sync-http.test.ts +328 -0
  77. package/src/department-groups.ts +434 -0
  78. package/src/department-heads-http.test.ts +350 -0
  79. package/src/department-heads.ts +226 -0
  80. package/src/departments-agent-count.test.ts +132 -0
  81. package/src/departments-http.test.ts +185 -0
  82. package/src/departments-mcp.test.ts +128 -0
  83. package/src/departments.ts +318 -0
  84. package/src/desktop-message-seam.test.ts +150 -0
  85. package/src/desktop-message.test.ts +368 -0
  86. package/src/dm-file-scope-http.test.ts +178 -0
  87. package/src/empty-node-sweeper.test.ts +104 -0
  88. package/src/empty-node-sweeper.ts +88 -0
  89. package/src/env-transport-gate-http.test.ts +240 -0
  90. package/src/env-transport-gate.ts +80 -0
  91. package/src/env-transport-policy.ts +56 -0
  92. package/src/etag-of.test.ts +57 -0
  93. package/src/event-loop-lag.test.ts +180 -0
  94. package/src/event-loop-lag.ts +201 -0
  95. package/src/expiry-counters.test.ts +111 -0
  96. package/src/expiry-counters.ts +93 -0
  97. package/src/ext-token-shared.test.ts +60 -0
  98. package/src/ext-validation-regression.test.ts +131 -0
  99. package/src/external-schedule-edits-http.test.ts +321 -0
  100. package/src/external-schedule-edits-timestamps.test.ts +64 -0
  101. package/src/external-schedule-edits.ts +327 -0
  102. package/src/file-download-authz-dev-open.test.ts +1 -1
  103. package/src/file-download-authz.test.ts +73 -18
  104. package/src/file-download-date-bucket.test.ts +8 -26
  105. package/src/file-network-scope-dev-open.test.ts +97 -0
  106. package/src/file-network-scope.test.ts +732 -0
  107. package/src/group-membership-events-http.test.ts +264 -0
  108. package/src/group-messages-http.test.ts +483 -0
  109. package/src/group-messages.ts +297 -0
  110. package/src/health-anon-readers.ts +60 -0
  111. package/src/health-host-disk-2756.test.ts +71 -0
  112. package/src/health-redaction.test.ts +1541 -7
  113. package/src/host-supervisor-identity-http.test.ts +152 -0
  114. package/src/host-supervisor-identity.ts +92 -0
  115. package/src/host-supervisors-daemon-version.test.ts +137 -0
  116. package/src/http-gzip.test.ts +94 -0
  117. package/src/http-gzip.ts +112 -0
  118. package/src/hub-catalog-read-http.test.ts +641 -0
  119. package/src/hub-provider-config.test.ts +166 -0
  120. package/src/hub-provider-config.ts +202 -0
  121. package/src/hub-timestamp.test.ts +38 -0
  122. package/src/hub-timestamp.ts +27 -0
  123. package/src/human-dm.ts +215 -0
  124. package/src/human-inbox.ts +42 -0
  125. package/src/inbox-caller.ts +49 -0
  126. package/src/inbox-count-sse.test.ts +310 -0
  127. package/src/inbox-count.ts +29 -0
  128. package/src/index.ts +6 -2
  129. package/src/license-state.test.ts +56 -0
  130. package/src/license-state.ts +48 -0
  131. package/src/list-host-supervisors.test.ts +15 -4
  132. package/src/mcp-context-cost-http.test.ts +127 -0
  133. package/src/mcp-inflight.test.ts +92 -0
  134. package/src/mcp-inflight.ts +38 -0
  135. package/src/mcp-projects-events-http.test.ts +165 -0
  136. package/src/mcp-route-label-http.test.ts +120 -0
  137. package/src/mcp-write-network-resolution.test.ts +435 -0
  138. package/src/member-audit-network-id-http.test.ts +93 -0
  139. package/src/member-presence-http.test.ts +210 -0
  140. package/src/messages-ack-by-agent-http.test.ts +142 -0
  141. package/src/migrate-sqlite-to-pg.test.ts +47 -0
  142. package/src/migrate-sqlite-to-pg.ts +263 -0
  143. package/src/model-auth-notify-http.test.ts +181 -0
  144. package/src/model-auth-notify.ts +116 -0
  145. package/src/network-name-http.test.ts +75 -0
  146. package/src/network-rules-http.test.ts +169 -0
  147. package/src/network-rules.ts +129 -0
  148. package/src/network-scope.ts +276 -0
  149. package/src/network-token-membership-http.test.ts +186 -0
  150. package/src/node-alias-control.ts +12 -0
  151. package/src/node-attrs.test.ts +47 -2
  152. package/src/node-caller-identity-http.test.ts +1108 -0
  153. package/src/node-create-request-status-http.test.ts +105 -0
  154. package/src/node-daemon-bindings.test.ts +132 -0
  155. package/src/node-daemon-bindings.ts +135 -0
  156. package/src/node-failure-alert.test.ts +150 -0
  157. package/src/node-failure-alert.ts +177 -0
  158. package/src/node-files-transport.test.ts +347 -0
  159. package/src/node-health-codex-login.test.ts +120 -0
  160. package/src/node-health-dispatch-http.test.ts +373 -0
  161. package/src/node-health-guard.ts +121 -0
  162. package/src/node-health-passthrough.test.ts +115 -0
  163. package/src/node-health-store.ts +101 -0
  164. package/src/node-id-alias.test.ts +190 -0
  165. package/src/node-identity-conflict-http.test.ts +269 -0
  166. package/src/node-identity-conflict.ts +142 -0
  167. package/src/node-identity-mismatch.test.ts +74 -0
  168. package/src/node-in-flight-tasks.ts +31 -0
  169. package/src/node-lifecycle-controllable.test.ts +64 -0
  170. package/src/node-lifecycle-controllable.ts +53 -0
  171. package/src/node-lifecycle-read-http.test.ts +257 -0
  172. package/src/node-lifecycle-read.ts +124 -0
  173. package/src/node-logs-transport.test.ts +263 -0
  174. package/src/node-peer-allowlist.test.ts +114 -0
  175. package/src/node-permissions-http.test.ts +728 -0
  176. package/src/node-permissions.ts +494 -0
  177. package/src/node-request-retention.test.ts +281 -0
  178. package/src/node-request-retention.ts +120 -0
  179. package/src/node-secret-rest-http.test.ts +190 -0
  180. package/src/node-serviceability.test.ts +86 -0
  181. package/src/node-serviceability.ts +124 -0
  182. package/src/node-session-control-http.test.ts +310 -0
  183. package/src/node-session-control.ts +258 -0
  184. package/src/node-skills-transport.test.ts +212 -0
  185. package/src/node-token-identity.ts +35 -0
  186. package/src/node-token-ownership.ts +51 -0
  187. package/src/node-token-privilege-http.test.ts +158 -0
  188. package/src/not-found-api-http.test.ts +67 -0
  189. package/src/observer-avatar-http.test.ts +102 -9
  190. package/src/observer-push.test.ts +76 -0
  191. package/src/opencode-catalog-report-http.test.ts +139 -0
  192. package/src/opencode-v2-catalog.test.ts +268 -0
  193. package/src/opencode-v2-catalog.ts +356 -0
  194. package/src/package-version-consistency.test.ts +25 -0
  195. package/src/parent-source-marker.test.ts +50 -0
  196. package/src/password-network-tokens.ts +25 -0
  197. package/src/peer-reply-atomic.test.ts +462 -0
  198. package/src/peer-reply-capability.test.ts +70 -0
  199. package/src/pg-worker.ts +87 -0
  200. package/src/poll-pacing.test.ts +74 -0
  201. package/src/poll-pacing.ts +123 -0
  202. package/src/project-dir-warn-clear-http.test.ts +132 -0
  203. package/src/project-viewer-can-http.test.ts +116 -0
  204. package/src/provider-tools-shape.test.ts +150 -0
  205. package/src/push.test.ts +20 -10
  206. package/src/push.ts +373 -9
  207. package/src/redact-tokens.test.ts +86 -0
  208. package/src/redact-tokens.ts +43 -0
  209. package/src/rejection-counters.test.ts +72 -0
  210. package/src/rejection-counters.ts +173 -0
  211. package/src/rename.ts +38 -10
  212. package/src/reply-target-derivation.test.ts +96 -0
  213. package/src/report-status-handover-capabilities-http.test.ts +124 -0
  214. package/src/report-status-host-schema.test.ts +235 -0
  215. package/src/report-status-resume-id-handover.test.ts +184 -0
  216. package/src/report-status-secret-keys.test.ts +140 -0
  217. package/src/require-explicit-test-db.ts +9 -0
  218. package/src/requirement-due-reminders-http.test.ts +620 -0
  219. package/src/requirement-due-reminders.ts +416 -0
  220. package/src/requirement-events-http.test.ts +318 -0
  221. package/src/requirement-events.test.ts +45 -0
  222. package/src/requirement-events.ts +144 -0
  223. package/src/requirement-notify.ts +165 -0
  224. package/src/requirement-participant-notify-http.test.ts +309 -0
  225. package/src/requirement-tag-ops-http.test.ts +454 -0
  226. package/src/requirement-tag-tree-http.test.ts +275 -0
  227. package/src/requirement-tag-tree.ts +127 -0
  228. package/src/requirement-tags.ts +102 -0
  229. package/src/requirements-abandoned-http.test.ts +236 -0
  230. package/src/requirements-assignee-drift.test.ts +154 -0
  231. package/src/requirements-comment-http.test.ts +174 -0
  232. package/src/requirements-completed-at-migration.test.ts +70 -0
  233. package/src/requirements-errors-mcp-http.test.ts +164 -0
  234. package/src/requirements-errors.ts +158 -0
  235. package/src/requirements-etag-http.test.ts +91 -0
  236. package/src/requirements-http.test.ts +709 -0
  237. package/src/requirements-last-event-http.test.ts +349 -0
  238. package/src/requirements-list-mcp-slim-http.test.ts +155 -0
  239. package/src/requirements-list-slim-http.test.ts +324 -0
  240. package/src/requirements-mcp.test.ts +164 -0
  241. package/src/requirements-migrate.ts +283 -0
  242. package/src/requirements-owner-strict-mcp-http.test.ts +145 -0
  243. package/src/requirements-people-http.test.ts +114 -0
  244. package/src/requirements-people-mcp-http.test.ts +231 -0
  245. package/src/requirements-people.ts +196 -0
  246. package/src/requirements-priority-lowest.test.ts +114 -0
  247. package/src/requirements-projects-network-echo.test.ts +57 -0
  248. package/src/requirements-projects-parent-http.test.ts +123 -0
  249. package/src/requirements-search-http.test.ts +182 -0
  250. package/src/requirements-search.test.ts +32 -0
  251. package/src/requirements-search.ts +145 -0
  252. package/src/requirements-seq-http.test.ts +193 -0
  253. package/src/requirements-seq-migration.test.ts +63 -0
  254. package/src/requirements-start-date.test.ts +125 -0
  255. package/src/requirements-stats-http.test.ts +357 -0
  256. package/src/requirements-stats.ts +195 -0
  257. package/src/requirements-status-participants-http.test.ts +222 -0
  258. package/src/requirements-upgrade-e2e.test.ts +126 -0
  259. package/src/requirements-upgrade-migration.test.ts +98 -0
  260. package/src/requirements.ts +2205 -0
  261. package/src/resolve-port.test.ts +57 -0
  262. package/src/resolve-port.ts +44 -0
  263. package/src/rest-alias-network-fallback-http.test.ts +123 -0
  264. package/src/rest-alias-network-fallback.test.ts +60 -0
  265. package/src/rest-alias-network-fallback.ts +65 -0
  266. package/src/rest-explicit-columns-http.test.ts +266 -0
  267. package/src/rest-identity.test.ts +130 -0
  268. package/src/rest-identity.ts +141 -0
  269. package/src/rest-projections.ts +72 -0
  270. package/src/rest-read-network-real-chain.test.ts +97 -0
  271. package/src/rest-write-network-resolution.test.ts +133 -0
  272. package/src/restart-readiness-http.test.ts +121 -0
  273. package/src/restricted-files.ts +76 -0
  274. package/src/retention-first-sweep-quiet.test.ts +31 -0
  275. package/src/retention.test.ts +100 -40
  276. package/src/retention.ts +423 -104
  277. package/src/route-callers-http.test.ts +120 -0
  278. package/src/route-timing.test.ts +218 -0
  279. package/src/route-timing.ts +262 -0
  280. package/src/rules-file-duplicate-alias.test.ts +234 -0
  281. package/src/rules-file-session-target.test.ts +207 -0
  282. package/src/rules-file-transport.test.ts +237 -0
  283. package/src/runtime-label.test.ts +22 -0
  284. package/src/runtime-label.ts +21 -0
  285. package/src/runtime-readiness.ts +90 -0
  286. package/src/schedule-agent-mcp-http.test.ts +475 -0
  287. package/src/schedule-agent.ts +252 -0
  288. package/src/schedule-starved.test.ts +92 -0
  289. package/src/schedule-starved.ts +114 -0
  290. package/src/scheduled-backoff-http.test.ts +203 -0
  291. package/src/scheduled-backoff.ts +64 -0
  292. package/src/scheduled-doorbell-nodeless-session.test.ts +134 -0
  293. package/src/scheduled-failure-backoff-2622.test.ts +145 -0
  294. package/src/scheduled-failure-code.test.ts +73 -0
  295. package/src/scheduled-failure-code.ts +105 -0
  296. package/src/scheduled-failures-http.test.ts +279 -0
  297. package/src/scheduled-failures.ts +425 -0
  298. package/src/scheduled-noprogress-backoff-2622.test.ts +163 -0
  299. package/src/scheduled-offline-backoff-probe.test.ts +56 -0
  300. package/src/scheduled-offline.test.ts +131 -0
  301. package/src/scheduled-offline.ts +66 -0
  302. package/src/scheduled-outcome-guidance-http.test.ts +139 -0
  303. package/src/scheduled-outcome-guidance.ts +9 -0
  304. package/src/scheduled-reply-unread-http.test.ts +212 -0
  305. package/src/scheduled-requirement-wake-http.test.ts +285 -0
  306. package/src/scheduled-requirement-wake.ts +125 -0
  307. package/src/scheduled-run-terminal.test.ts +290 -0
  308. package/src/scheduled-skip-blocking-task.test.ts +120 -0
  309. package/src/scheduled-skip-path-backoff-2622.test.ts +98 -0
  310. package/src/scheduled-stuck-http.test.ts +316 -0
  311. package/src/scheduled-stuck-notice-cap.test.ts +80 -0
  312. package/src/scheduled-stuck.ts +219 -0
  313. package/src/scheduled-tasks-http.test.ts +679 -0
  314. package/src/scheduled-tasks.ts +959 -0
  315. package/src/scheduled-work-outcome-http.test.ts +154 -0
  316. package/src/scheduled-work-outcome.ts +50 -0
  317. package/src/scoped-secrets.ts +141 -0
  318. package/src/secret-echo-negative-control.test.ts +118 -0
  319. package/src/send-dedup-request-id.test.ts +229 -0
  320. package/src/send-reply-agent-warning.test.ts +38 -38
  321. package/src/send-reply-alias-optional.test.ts +131 -0
  322. package/src/send-reply-attachments.test.ts +458 -0
  323. package/src/send_dedup.test.ts +54 -0
  324. package/src/send_dedup.ts +52 -6
  325. package/src/serve-error.test.ts +73 -0
  326. package/src/serve-error.ts +56 -0
  327. package/src/server.ts +5134 -503
  328. package/src/session-task-on-dispatch.ts +14 -0
  329. package/src/session-token-ownership-http.test.ts +122 -0
  330. package/src/shared/codex-inventory.ts +41 -0
  331. package/src/shared/daemon-provider-login.ts +31 -0
  332. package/src/shared/daemon-provider-snapshot.ts +52 -0
  333. package/src/shared/external-schedule-contract.ts +60 -0
  334. package/src/shared/node-name.test.ts +62 -0
  335. package/src/shared/node-name.ts +161 -0
  336. package/src/shared/probe-host-allowlist-drift.test.ts +45 -0
  337. package/src/shared/provider-application.ts +29 -0
  338. package/src/shared/provider-collection.ts +14 -0
  339. package/src/shared/provider-initialization.ts +8 -0
  340. package/src/shared/reserved-env-drift.test.ts +10 -0
  341. package/src/shared/scoped-secret-contract.ts +5 -0
  342. package/src/shared/task-content-limit-drift.test.ts +28 -0
  343. package/src/shared/task-content-limit.ts +25 -0
  344. package/src/side-thread-command-transport.test.ts +312 -0
  345. package/src/side-thread-command-transport.ts +318 -0
  346. package/src/side-thread-http-integration.test.ts +233 -0
  347. package/src/side-thread-http.ts +504 -0
  348. package/src/side-thread-production.test.ts +72 -0
  349. package/src/side-thread-production.ts +118 -0
  350. package/src/side-thread.test.ts +1067 -0
  351. package/src/side-thread.ts +2499 -0
  352. package/src/skillhub-http.test.ts +142 -0
  353. package/src/sqlite-close-checkpoint.test.ts +78 -0
  354. package/src/start-node.test.ts +265 -0
  355. package/src/stats-versions-http.test.ts +65 -0
  356. package/src/status-alias-filter-http.test.ts +106 -0
  357. package/src/status-alias-resolver-http.test.ts +163 -0
  358. package/src/status-alias-resolver.ts +19 -0
  359. package/src/status-node-id-filter-http.test.ts +161 -0
  360. package/src/status-read-cache-http.test.ts +229 -0
  361. package/src/status-read-cache.ts +129 -0
  362. package/src/stop-delete-node.test.ts +567 -1
  363. package/src/task-access-http.test.ts +402 -0
  364. package/src/task-access.ts +420 -0
  365. package/src/task-activity.ts +60 -0
  366. package/src/task-auth-origin-http.test.ts +93 -0
  367. package/src/task-auth-origin.test.ts +24 -0
  368. package/src/task-auth-origin.ts +7 -0
  369. package/src/task-consumption.test.ts +498 -0
  370. package/src/task-diagnostic-http.test.ts +149 -0
  371. package/src/task-diagnostic.test.ts +115 -0
  372. package/src/task-diagnostic.ts +118 -0
  373. package/src/task-expiry-notice-http.test.ts +287 -0
  374. package/src/task-expiry-notice.ts +318 -0
  375. package/src/task-idempotency-mcp.test.ts +142 -0
  376. package/src/task-idempotency.test.ts +76 -0
  377. package/src/task-idempotency.ts +81 -0
  378. package/src/task-late-replies.ts +54 -0
  379. package/src/task-late-reply-http.test.ts +227 -0
  380. package/src/task-lifecycle-watcher-busy.test.ts +114 -0
  381. package/src/task-lifecycle-watcher.test.ts +209 -0
  382. package/src/task-lifecycle-watcher.ts +109 -0
  383. package/src/task-network-resolution-http.test.ts +140 -0
  384. package/src/task-offline-delivery-2668.test.ts +119 -0
  385. package/src/task-offline-delivery.ts +81 -0
  386. package/src/task-orphan-http.test.ts +287 -0
  387. package/src/task-orphan.ts +119 -0
  388. package/src/task-queue-ahead-http.test.ts +309 -0
  389. package/src/task-queue-ahead-scale.test.ts +236 -0
  390. package/src/task-queue-ahead.ts +186 -0
  391. package/src/task-rejection-log-http.test.ts +160 -0
  392. package/src/task-rejection-log.ts +61 -0
  393. package/src/task-sender-http.test.ts +143 -0
  394. package/src/task-stale-open-http.test.ts +292 -0
  395. package/src/task-stale-open.ts +103 -0
  396. package/src/tasks-pagination-http.test.ts +141 -0
  397. package/src/team-rules-status-http.test.ts +90 -0
  398. package/src/team-rules-status.test.ts +59 -0
  399. package/src/team-rules-status.ts +72 -0
  400. package/src/tmux-allowlist.test.ts +48 -0
  401. package/src/tool-audience-http.test.ts +230 -0
  402. package/src/tool-audience.ts +127 -0
  403. package/src/tools-list-json-schema.test.ts +94 -0
  404. package/src/tools.ts +4326 -420
  405. package/src/upload-early-reject-guard.test.ts +155 -0
  406. package/src/uploads-http.test.ts +86 -7
  407. package/src/uploads.ts +38 -4
  408. package/src/user-avatar-http.test.ts +74 -0
  409. package/src/user-avatar-image.ts +160 -0
  410. package/src/user-avatar-migration.test.ts +25 -0
  411. package/src/user-avatar-upload-http.test.ts +348 -0
  412. package/src/user-inbox-by-agent-http.test.ts +165 -0
  413. package/src/user-inbox-netid-notnull.test.ts +122 -0
  414. package/src/user-inbox-read-http.test.ts +223 -0
  415. package/src/user-inbox-schema.test.ts +54 -0
  416. package/src/version-stats.test.ts +66 -0
  417. package/src/version-stats.ts +109 -0
@@ -0,0 +1,124 @@
1
+ import { db } from "./db.js";
2
+ import { addAgentNetworkScope, type RestNetworkScope } from "./network-scope.js";
3
+ import { forkRecoveryRequestSchema, publicForkResult } from "./codex-fork-contract.js";
4
+
5
+ // Exact public codes only; daemon exception text must never reach node viewers.
6
+ const publicLifecycleErrors = new Set([
7
+ "codex_fork_confirmation_invalid", "codex_fork_recovery_unsupported", "codex_fork_cli_unsupported",
8
+ "codex_fork_result_invalid", "codex_fork_outcome_unknown",
9
+ "adopted_node_delete_unsupported", "adopt_codex_readopt_required", "adopt_stop_receipt_changed",
10
+ "adopt_codex_external_start_unproven", "adopt_codex_launch_failed", "adopt_codex_launch_timeout",
11
+ "adopt_codex_port_unproven", "adopt_codex_start_superseded", "adopt_codex_binding_generation_unproven",
12
+ "adopt_codex_start_evidence_missing", "adopt_codex_start_evidence_changed",
13
+ "adopt_codex_session_conflict", "adopt_codex_port_unavailable", "adopt_codex_stage_still_running",
14
+ "adopt_codex_identity_unproven",
15
+ "adopt_active_binding_required", "adopt_binding_unavailable",
16
+ "adopt_binding_revoked_during_start", "adopt_explicit_private_socket_required",
17
+ "adopt_start_evidence_missing", "adopt_stop_evidence_missing",
18
+ "adopt_launch_mode_mismatch", "adopt_lifecycle_verification_failed",
19
+ "adopt_process_generation_changed", "adopt_process_still_running",
20
+ "adopt_process_stop_timeout", "adopt_process_tree_unstable",
21
+ "adopt_registry_identity_mismatch", "adopt_self_process_refused",
22
+ "adopt_start_timeout", "adopt_tmux_session_still_exists",
23
+ "adopt_local_verification_failed", "adopt_roots_not_configured",
24
+ "adopt_workdir_outside_roots", "adopt_workdir_not_absolute",
25
+ "adopt_alias_invalid", "adopt_alias_mismatch", "adopt_config_invalid",
26
+ "adopt_config_network_mismatch", "adopt_network_mismatch",
27
+ "adopt_hub_invalid", "adopt_hub_missing", "adopt_hub_mismatch",
28
+ "adopt_identity_ambiguous", "adopt_identity_not_found", "adopt_identity_changed",
29
+ "adopt_path_not_regular", "adopt_path_owner_mismatch", "adopt_path_writable_by_others",
30
+ "adopt_process_argv_mismatch", "adopt_process_home_mismatch",
31
+ "adopt_process_identity_mismatch", "adopt_process_changed",
32
+ "adopt_tmux_socket_mismatch", "adopt_pane_invalid", "adopt_pane_unverified",
33
+ "adopt_pane_process_mismatch", "adopt_socket_directory_unsafe", "adopt_socket_unsafe",
34
+ "adopt_pid_changed", "adopt_pid_invalid", "adopt_pidfile_unsafe",
35
+ "opencode_tui_session_mismatch",
36
+ // #2012 —— daemon 的 copresence_adopt_v2 拒绝是固定安全码(无路径/无异常文本),
37
+ // 不放行会让用户投影退化成 lifecycle_error,看不到「为什么被拒绝」。
38
+ "copresence_adopt_v2",
39
+ "adopt_proc_invalid", "adopt_proc_unreadable", "adopt_platform_unsupported",
40
+ "adopt_registry_conflict", "adopt_registry_entry_invalid", "adopt_registry_invalid",
41
+ "adopt_registry_unsafe", "adopt_config_env_invalid", "adopt_env_file_invalid",
42
+ "adopt_env_file_unsafe", "adopt_request_mismatch", "adopt_ack_rejected",
43
+ ]);
44
+ function publicLifecycleError(error: unknown): string | null {
45
+ return error == null ? null
46
+ : typeof error === "string" && publicLifecycleErrors.has(error) ? error : "lifecycle_error";
47
+ }
48
+
49
+ type Adoption = { request_id: string; daemon_node_id: string; status: string; error: string | null };
50
+ export type LifecycleProjection = { managed: "created" | "adopted" | "none"; adoption: Adoption | null };
51
+ const scopeNodes = (sql: string, params: any[], scope: RestNetworkScope) =>
52
+ addAgentNetworkScope(sql, params, scope, { network: "n.network_id", nodeId: "n.node_id", alias: "n.alias" });
53
+
54
+ /** Called only for authenticated human readers. Same visibility as /api/nodes;
55
+ * constant query count, no id-prefix or host-name inference of authority. */
56
+ export function lifecycleProjections(scope: RestNetworkScope): Map<string, LifecycleProjection> {
57
+ const result = new Map<string, LifecycleProjection>();
58
+ const bp: any[] = [];
59
+ const bindings = db.all<Adoption & { node_id: string }>(scopeNodes(
60
+ `SELECT b.node_id,b.request_id,b.daemon_node_id,b.status,b.error
61
+ FROM node_daemon_bindings b JOIN nodes n ON n.node_id=b.node_id AND n.network_id=b.network_id
62
+ WHERE 1=1`, bp, scope) + " ORDER BY b.created_at DESC,b.request_id DESC", ...bp);
63
+ for (const b of bindings) {
64
+ let projection = result.get(b.node_id);
65
+ if (!projection) {
66
+ projection = { managed: "none", adoption: { request_id: b.request_id, daemon_node_id: b.daemon_node_id, status: b.status, error: publicLifecycleError(b.error) } };
67
+ result.set(b.node_id, projection);
68
+ }
69
+ if (b.status === "active") projection.managed = "adopted";
70
+ }
71
+ const cp: any[] = [];
72
+ const created = db.all<{ node_id: string }>(scopeNodes(
73
+ `SELECT n.node_id FROM node_create_requests c JOIN nodes n
74
+ ON n.node_id=COALESCE(c.child_node_id, CASE WHEN substr(c.request_id,1,3)='cr_'
75
+ THEN 'node_' || substr(c.request_id,4) END) AND n.network_id=c.network_id
76
+ WHERE 1=1`, cp, scope), ...cp);
77
+ for (const n of created) result.set(n.node_id, { managed: "created", adoption: result.get(n.node_id)?.adoption ?? null });
78
+ return result;
79
+ }
80
+
81
+ /** Read-only, selector-bound lookup. Join the live node in the SAME network,
82
+ * then apply its current visibility (including restricted member grants).
83
+ * Result fields exclude credentials, PID and config; error values separately
84
+ * use the exact public-code allowlist (daemon text may contain workdir paths). */
85
+ export function lifecycleRequestResponse(url: URL, scope: RestNetworkScope): Response {
86
+ const kind = url.searchParams.get("kind");
87
+ const requestId = url.searchParams.get("request_id"), nodeId = url.searchParams.get("node_id");
88
+ const fail = (error: string, status: number) => Response.json({ ok: false, error }, { status });
89
+ if (!["adopt", "start", "stop"].includes(kind ?? "")
90
+ || url.searchParams.has("request_id") === url.searchParams.has("node_id")
91
+ || !(requestId ?? nodeId ?? "").trim()
92
+ || ["kind", "request_id", "node_id"].some(k => url.searchParams.getAll(k).length > 1)
93
+ || (requestId ?? nodeId ?? "").length > 200) return fail("invalid_lifecycle_query", 400);
94
+ // The table and column names below come only from this closed enum.
95
+ const table = kind === "adopt" ? "node_daemon_bindings" : kind === "start" ? "node_start_requests" : "node_stop_requests";
96
+ const nodeColumn = kind === "adopt" ? "node_id" : "child_node_id";
97
+ // A node lookup with no request must distinguish 'no requests' from 'not visible'.
98
+ if (nodeId) {
99
+ const params: any[] = [nodeId];
100
+ if (!db.get(scopeNodes("SELECT n.node_id FROM nodes n WHERE n.node_id=?1", params, scope), ...params))
101
+ return fail("node_not_found", 404);
102
+ }
103
+ const params: any[] = [requestId ?? nodeId];
104
+ const sql = scopeNodes(`SELECT r.request_id,r.${nodeColumn} AS node_id,r.network_id,r.daemon_node_id,
105
+ r.status,r.error,r.created_at,${kind === "adopt" ? "r.updated_at" : "r.acked_at,r.delivered_at"}
106
+ ${kind === "start" ? ",r.fork_recovery_json,r.fork_result_json" : ""}
107
+ FROM ${table} r JOIN nodes n ON n.node_id=r.${nodeColumn} AND n.network_id=r.network_id
108
+ WHERE r.${requestId ? "request_id" : nodeColumn}=?1${kind === "stop" ? " AND r.action='stop'" : ""}`, params, scope);
109
+ const row = db.get<Record<string, unknown>>(sql + " ORDER BY r.created_at DESC,r.request_id DESC LIMIT 1", ...params);
110
+ if (!row && requestId) return fail("request_not_found", 404);
111
+ if (!row) return Response.json({ ok: true, request: null });
112
+ const { fork_recovery_json, fork_result_json, ...publicRow } = row;
113
+ let confirmed: true | null = null;
114
+ if (kind === "start" && typeof fork_recovery_json === "string") {
115
+ try {
116
+ if (forkRecoveryRequestSchema.safeParse(JSON.parse(fork_recovery_json)).success) confirmed = true;
117
+ } catch { /* damaged confirmation is unknown; keep any independently valid fork evidence */ }
118
+ }
119
+ return Response.json({ ok: true, request: { kind, ...publicRow, error: publicLifecycleError(row.error),
120
+ ...(kind === "start" && fork_recovery_json != null ? { fork_recovery: {
121
+ requested: confirmed, result: publicForkResult(fork_result_json),
122
+ } } : {}),
123
+ } });
124
+ }
@@ -0,0 +1,263 @@
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
+ expect(enq).toMatchObject({ ok: true, op: "logs_tail" });
135
+ const pulled = (await a.call("get_rules_file_request", {})).request;
136
+ expect(pulled.op).toBe("logs_tail");
137
+ expect(JSON.parse(pulled.content)).toEqual({ lines: 2000, level: "warn", grep: "boom", since_ts: 5 });
138
+ expect(pulled.content).not.toContain("passwd");
139
+ 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" });
140
+
141
+ const first = await u.call("get_rules_file_result", { request_id: enq.request_id, network_id: NET });
142
+ expect(first).toMatchObject({ ok: true, op: "logs_tail", status: "done", content: SAMPLE });
143
+ // Read-once: purged in the same call, including the filter JSON.
144
+ expect(row(enq.request_id)).toMatchObject({ result_content: null, content: null });
145
+ expect(row(enq.request_id).content_purged_at).toBeGreaterThan(0);
146
+ const second = await u.call("get_rules_file_result", { request_id: enq.request_id, network_id: NET });
147
+ expect(second.content).toBeUndefined();
148
+ expect(second.content_purged).toBe(true);
149
+ } finally { await u.close(); await a.close(); }
150
+ }, 20_000);
151
+
152
+ test("lines above 2000 are refused by the schema; bad level refused", async () => {
153
+ const u = await connect(asOwner);
154
+ try {
155
+ expect((await u.call("tail_node_logs", { node_id: NODE_A_ID, network_id: NET, lines: 2001 })).ok).not.toBe(true);
156
+ expect((await u.call("tail_node_logs", { node_id: NODE_A_ID, network_id: NET, level: "debug" })).ok).not.toBe(true);
157
+ expect(rowCount()).toBe(0);
158
+ } finally { await u.close(); }
159
+ }, 20_000);
160
+ });
161
+
162
+ describe("who may ask", () => {
163
+ test("node tokens are refused — for other nodes and for themselves", async () => {
164
+ const a = await connect(asA);
165
+ try {
166
+ expect(await a.call("tail_node_logs", { node_id: NODE_B_ID })).toMatchObject({ ok: false, error: "node_token_cannot_read_logs" });
167
+ expect(await a.call("tail_node_logs", { node_id: NODE_A_ID })).toMatchObject({ ok: false, error: "node_token_cannot_read_logs" });
168
+ expect(rowCount()).toBe(0);
169
+ } finally { await a.close(); }
170
+ }, 20_000);
171
+
172
+ test("node owner yes; plain member no; viewer no; network owner yes", async () => {
173
+ const m = await connect(asMember);
174
+ const m2 = await connect(asMember2);
175
+ const v = await connect(asViewer);
176
+ const o = await connect(asOwner);
177
+ try {
178
+ expect(await m.call("tail_node_logs", { node_id: NODE_A_ID, network_id: NET })).toMatchObject({ ok: true });
179
+ expect(await m.call("tail_node_logs", { node_id: NODE_B_ID, network_id: NET })).toMatchObject({ ok: false, error: "logs_permission_denied" });
180
+ expect(await m2.call("tail_node_logs", { node_id: NODE_A_ID, network_id: NET })).toMatchObject({ ok: false, error: "logs_permission_denied" });
181
+ expect((await v.call("tail_node_logs", { node_id: NODE_B_ID, network_id: NET })).ok).toBe(false);
182
+ expect(await o.call("tail_node_logs", { node_id: NODE_B_ID, network_id: NET })).toMatchObject({ ok: true });
183
+ expect(rowCount()).toBe(2);
184
+ } finally { await m.close(); await m2.close(); await v.close(); await o.close(); }
185
+ }, 20_000);
186
+
187
+ test("a user of another network is refused (cross network)", async () => {
188
+ const x = await connect(asOutsider);
189
+ try {
190
+ const r1 = await x.call("tail_node_logs", { node_id: NODE_A_ID, network_id: NET });
191
+ expect(r1.ok).toBe(false);
192
+ const r2 = await x.call("tail_node_logs", { node_id: NODE_A_ID, network_id: OTHER_NET });
193
+ expect(r2).toMatchObject({ ok: false, error: "cross_network_node" });
194
+ expect(rowCount()).toBe(0);
195
+ } finally { await x.close(); }
196
+ }, 20_000);
197
+ });
198
+
199
+ describe("who may read", () => {
200
+ test("only the login that asked; another login of the same user, node tokens and the serving node cannot", async () => {
201
+ const u = await connect(asOwner);
202
+ const other = await connect(asOwnerOtherLogin);
203
+ const b = await connect(asB);
204
+ const a = await connect(asA);
205
+ try {
206
+ const enq = await u.call("tail_node_logs", { node_id: NODE_A_ID, network_id: NET });
207
+ await a.call("get_rules_file_request", {});
208
+ await a.call("ack_rules_file_request", { request_id: enq.request_id, status: "done", content: SAMPLE });
209
+ expect(await other.call("get_rules_file_result", { request_id: enq.request_id, network_id: NET })).toMatchObject({ ok: false, error: "request_not_found" });
210
+ expect(await b.call("get_rules_file_result", { request_id: enq.request_id })).toMatchObject({ ok: false, error: "request_not_found" });
211
+ expect(await a.call("get_rules_file_result", { request_id: enq.request_id })).toMatchObject({ ok: false, error: "request_not_found" });
212
+ // Those refusals did not consume the read-once result.
213
+ expect(await u.call("get_rules_file_result", { request_id: enq.request_id, network_id: NET })).toMatchObject({ status: "done", content: SAMPLE });
214
+ } finally { await u.close(); await other.close(); await b.close(); await a.close(); }
215
+ }, 20_000);
216
+
217
+ test("node B never pulls or acks node A's logs request", async () => {
218
+ const u = await connect(asOwner);
219
+ const a = await connect(asA);
220
+ const b = await connect(asB);
221
+ try {
222
+ const enq = await u.call("tail_node_logs", { node_id: NODE_A_ID, network_id: NET });
223
+ expect((await b.call("get_rules_file_request", {})).request).toBeNull();
224
+ expect(await b.call("ack_rules_file_request", { request_id: enq.request_id, status: "done", content: "{\"forged\":true}" })).toMatchObject({ ignored: "unknown_or_foreign_request" });
225
+ expect((await a.call("get_rules_file_request", {})).request.request_id).toBe(enq.request_id);
226
+ } finally { await u.close(); await a.close(); await b.close(); }
227
+ }, 20_000);
228
+ });
229
+
230
+ describe("storage and lanes", () => {
231
+ test("an unread terminal result is purged by the sweep after the logs TTL; other ops keep theirs", async () => {
232
+ const u = await connect(asOwner);
233
+ const a = await connect(asA);
234
+ try {
235
+ const enq = await u.call("tail_node_logs", { node_id: NODE_A_ID, network_id: NET });
236
+ const rules = await u.call("read_node_rules_file", { node_id: NODE_A_ID, network_id: NET });
237
+ await a.call("get_rules_file_request", {});
238
+ await a.call("get_rules_file_request", {});
239
+ await a.call("ack_rules_file_request", { request_id: enq.request_id, status: "done", content: SAMPLE });
240
+ await a.call("ack_rules_file_request", { request_id: rules.request_id, status: "done", content: "# rules" });
241
+ sweepNodeRequestContent(Date.now() + LOGS_CONTENT_TTL_MS - 5_000);
242
+ expect(row(enq.request_id).result_content).toBe(SAMPLE);
243
+ sweepNodeRequestContent(Date.now() + LOGS_CONTENT_TTL_MS + 5_000);
244
+ expect(row(enq.request_id)).toMatchObject({ result_content: null, content: null });
245
+ expect(row(rules.request_id).result_content).toBe("# rules");
246
+ } finally { await u.close(); await a.close(); }
247
+ }, 20_000);
248
+
249
+ test("own single-flight lane; a 1 MiB-class ack is accepted", async () => {
250
+ const u = await connect(asOwner);
251
+ const a = await connect(asA);
252
+ try {
253
+ expect(await u.call("list_node_files", { node_id: NODE_A_ID, network_id: NET })).toMatchObject({ ok: true });
254
+ const first = await u.call("tail_node_logs", { node_id: NODE_A_ID, network_id: NET });
255
+ expect(first).toMatchObject({ ok: true });
256
+ 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 });
257
+ await a.call("get_rules_file_request", {});
258
+ await a.call("get_rules_file_request", {});
259
+ const big = "x".repeat(700 * 1024);
260
+ expect(await a.call("ack_rules_file_request", { request_id: first.request_id, status: "done", content: big })).toMatchObject({ ok: true, status: "done" });
261
+ } finally { await u.close(); await a.close(); }
262
+ }, 20_000);
263
+ });
@@ -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
+ });