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

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
Files changed (398) hide show
  1. package/README.md +130 -10
  2. package/bin/commhub.ts +99 -11
  3. package/package.json +7 -7
  4. package/src/ack-create-request-transport.test.ts +182 -0
  5. package/src/ack-create-request.test.ts +50 -7
  6. package/src/admin-delete-network-http.test.ts +228 -0
  7. package/src/admin-networks-http.test.ts +88 -0
  8. package/src/adoption-candidates-http.test.ts +137 -0
  9. package/src/adoption-candidates.ts +158 -0
  10. package/src/agent-access-batch.test.ts +210 -0
  11. package/src/agent-access.ts +487 -0
  12. package/src/agent-acl-groups-http.test.ts +247 -0
  13. package/src/agent-acl-http.test.ts +659 -0
  14. package/src/agent-acl-slice3-http.test.ts +267 -0
  15. package/src/agent-department-http.test.ts +215 -0
  16. package/src/agent-groups-perf.test.ts +223 -0
  17. package/src/agent-notice.ts +48 -0
  18. package/src/agent-team-whoami-http.test.ts +98 -0
  19. package/src/agent-teams-http.test.ts +330 -0
  20. package/src/agent-teams.ts +244 -0
  21. package/src/alias-baseline-2571.test.ts +162 -0
  22. package/src/alias-baseline.ts +113 -0
  23. package/src/alias-filter.test.ts +72 -0
  24. package/src/alias-filter.ts +42 -0
  25. package/src/api-host-supervisors-can-create-nodes.test.ts +350 -0
  26. package/src/api-host-supervisors-fallback.test.ts +21 -12
  27. package/src/api-host-supervisors-runtime-readiness.test.ts +195 -0
  28. package/src/api-nodes-shape.test.ts +120 -13
  29. package/src/auth-password-change-cli-tokens-http.test.ts +423 -0
  30. package/src/auth-sessions-http.test.ts +250 -0
  31. package/src/auth-validate.test.ts +5 -1
  32. package/src/auth-weak-password-login.test.ts +176 -0
  33. package/src/auth.ts +609 -51
  34. package/src/avatar-validate.test.ts +163 -0
  35. package/src/avatar-validate.ts +103 -0
  36. package/src/backfill-node-ids-2664.test.ts +128 -0
  37. package/src/binding-generation-http.test.ts +121 -0
  38. package/src/blocked-exit-on-reply.test.ts +122 -0
  39. package/src/boot-side-effect.test.ts +124 -0
  40. package/src/broadcast-fanout-2721.test.ts +118 -0
  41. package/src/broadcast-fanout.ts +98 -0
  42. package/src/chain-attempt-dedup.test.ts +447 -0
  43. package/src/clone-node.test.ts +248 -0
  44. package/src/clone-node.ts +289 -0
  45. package/src/codex-config-flags.ts +77 -0
  46. package/src/codex-fork-contract.ts +23 -0
  47. package/src/codex-fork-migration.test.ts +38 -0
  48. package/src/commhub-bin-args.test.ts +85 -0
  49. package/src/config-apply-sec1.test.ts +107 -0
  50. package/src/config-apply-validate.test.ts +134 -1
  51. package/src/config-apply-validate.ts +111 -5
  52. package/src/create-node-blocked-gate.test.ts +356 -0
  53. package/src/create-node-network-id.test.ts +79 -0
  54. package/src/create-node-tool-schema.test.ts +49 -0
  55. package/src/create-node-unicode-name.test.ts +120 -0
  56. package/src/create-node-validate.test.ts +199 -7
  57. package/src/create-node-validate.ts +232 -15
  58. package/src/create-node-workdir.test.ts +289 -0
  59. package/src/create-node.ts +88 -23
  60. package/src/daemon-provider-snapshots.test.ts +421 -0
  61. package/src/daemon-provider-snapshots.ts +327 -0
  62. package/src/daemon-token-owner-http.test.ts +236 -0
  63. package/src/dashboard-slash-routing-http.test.ts +109 -0
  64. package/src/db-adapter-guard.test.ts +148 -0
  65. package/src/db-adapter-translate.test.ts +128 -0
  66. package/src/db-adapter.ts +377 -91
  67. package/src/db-timestamp.test.ts +38 -0
  68. package/src/db-timestamp.ts +15 -0
  69. package/src/db.ts +1306 -153
  70. package/src/delivered-without-push.test.ts +140 -0
  71. package/src/department-groups-http.test.ts +209 -0
  72. package/src/department-groups-sync-http.test.ts +328 -0
  73. package/src/department-groups.ts +434 -0
  74. package/src/department-heads-http.test.ts +330 -0
  75. package/src/department-heads.ts +226 -0
  76. package/src/departments-agent-count.test.ts +129 -0
  77. package/src/departments-http.test.ts +185 -0
  78. package/src/departments-mcp.test.ts +128 -0
  79. package/src/departments.ts +318 -0
  80. package/src/desktop-message-seam.test.ts +150 -0
  81. package/src/desktop-message.test.ts +368 -0
  82. package/src/dm-file-scope-http.test.ts +178 -0
  83. package/src/empty-node-sweeper.test.ts +104 -0
  84. package/src/empty-node-sweeper.ts +88 -0
  85. package/src/env-transport-gate-http.test.ts +177 -0
  86. package/src/env-transport-gate.ts +74 -0
  87. package/src/env-transport-policy.ts +21 -0
  88. package/src/event-loop-lag.test.ts +139 -0
  89. package/src/event-loop-lag.ts +150 -0
  90. package/src/ext-token-shared.test.ts +60 -0
  91. package/src/ext-validation-regression.test.ts +131 -0
  92. package/src/external-schedule-edits-http.test.ts +321 -0
  93. package/src/external-schedule-edits-timestamps.test.ts +64 -0
  94. package/src/external-schedule-edits.ts +327 -0
  95. package/src/file-download-authz-dev-open.test.ts +135 -0
  96. package/src/file-download-authz.test.ts +404 -0
  97. package/src/file-download-date-bucket.test.ts +436 -0
  98. package/src/file-network-scope-dev-open.test.ts +97 -0
  99. package/src/file-network-scope.test.ts +732 -0
  100. package/src/group-membership-events-http.test.ts +264 -0
  101. package/src/group-messages-http.test.ts +482 -0
  102. package/src/group-messages.ts +297 -0
  103. package/src/health-host-disk-2756.test.ts +49 -0
  104. package/src/health-redaction.test.ts +685 -0
  105. package/src/host-supervisor-identity-http.test.ts +152 -0
  106. package/src/host-supervisor-identity.ts +92 -0
  107. package/src/host-supervisors-daemon-version.test.ts +137 -0
  108. package/src/http-gzip.test.ts +94 -0
  109. package/src/http-gzip.ts +112 -0
  110. package/src/hub-catalog-read-http.test.ts +187 -0
  111. package/src/hub-provider-config.test.ts +139 -0
  112. package/src/hub-provider-config.ts +105 -0
  113. package/src/hub-timestamp.test.ts +38 -0
  114. package/src/hub-timestamp.ts +27 -0
  115. package/src/human-dm.ts +215 -0
  116. package/src/human-inbox.ts +42 -0
  117. package/src/inbox-caller.ts +49 -0
  118. package/src/inbox-count-sse.test.ts +310 -0
  119. package/src/inbox-count.ts +29 -0
  120. package/src/index.ts +15 -2380
  121. package/src/list-host-supervisors.test.ts +5 -4
  122. package/src/mcp-context-cost-http.test.ts +127 -0
  123. package/src/mcp-inflight.test.ts +92 -0
  124. package/src/mcp-inflight.ts +38 -0
  125. package/src/mcp-projects-events-http.test.ts +162 -0
  126. package/src/mcp-route-label-http.test.ts +120 -0
  127. package/src/mcp-write-network-resolution.test.ts +432 -0
  128. package/src/member-audit-network-id-http.test.ts +93 -0
  129. package/src/member-presence-http.test.ts +210 -0
  130. package/src/messages-ack-by-agent-http.test.ts +142 -0
  131. package/src/migrate-sqlite-to-pg.test.ts +47 -0
  132. package/src/migrate-sqlite-to-pg.ts +263 -0
  133. package/src/model-auth-notify-http.test.ts +181 -0
  134. package/src/model-auth-notify.ts +116 -0
  135. package/src/network-name-http.test.ts +75 -0
  136. package/src/network-rules-http.test.ts +169 -0
  137. package/src/network-rules.ts +129 -0
  138. package/src/network-scope.ts +276 -0
  139. package/src/network-token-membership-http.test.ts +139 -0
  140. package/src/node-alias-control.ts +12 -0
  141. package/src/node-attrs-validate.ts +88 -0
  142. package/src/node-attrs.test.ts +258 -0
  143. package/src/node-caller-identity-http.test.ts +1083 -0
  144. package/src/node-create-request-status-http.test.ts +105 -0
  145. package/src/node-daemon-bindings.test.ts +132 -0
  146. package/src/node-daemon-bindings.ts +135 -0
  147. package/src/node-failure-alert.test.ts +150 -0
  148. package/src/node-failure-alert.ts +177 -0
  149. package/src/node-files-transport.test.ts +344 -0
  150. package/src/node-health-codex-login.test.ts +120 -0
  151. package/src/node-health-dispatch-http.test.ts +279 -0
  152. package/src/node-health-guard.ts +105 -0
  153. package/src/node-health-passthrough.test.ts +115 -0
  154. package/src/node-health-store.ts +101 -0
  155. package/src/node-id-alias.test.ts +190 -0
  156. package/src/node-identity-conflict-http.test.ts +269 -0
  157. package/src/node-identity-conflict.ts +142 -0
  158. package/src/node-identity-mismatch.test.ts +74 -0
  159. package/src/node-in-flight-tasks.ts +31 -0
  160. package/src/node-lifecycle-controllable.test.ts +64 -0
  161. package/src/node-lifecycle-controllable.ts +53 -0
  162. package/src/node-lifecycle-read-http.test.ts +250 -0
  163. package/src/node-lifecycle-read.ts +124 -0
  164. package/src/node-logs-transport.test.ts +263 -0
  165. package/src/node-peer-allowlist.test.ts +114 -0
  166. package/src/node-permissions-http.test.ts +345 -0
  167. package/src/node-permissions.ts +420 -0
  168. package/src/node-request-retention.test.ts +281 -0
  169. package/src/node-request-retention.ts +120 -0
  170. package/src/node-secret-rest-http.test.ts +190 -0
  171. package/src/node-serviceability.test.ts +86 -0
  172. package/src/node-serviceability.ts +124 -0
  173. package/src/node-session-control-http.test.ts +310 -0
  174. package/src/node-session-control.ts +258 -0
  175. package/src/node-skills-transport.test.ts +209 -0
  176. package/src/node-token-identity.ts +35 -0
  177. package/src/node-token-ownership.ts +51 -0
  178. package/src/node-token-privilege-http.test.ts +158 -0
  179. package/src/not-found-api-http.test.ts +67 -0
  180. package/src/observer-avatar-http.test.ts +442 -0
  181. package/src/observer-push.test.ts +252 -0
  182. package/src/opencode-catalog-report-http.test.ts +139 -0
  183. package/src/opencode-v2-catalog.test.ts +268 -0
  184. package/src/opencode-v2-catalog.ts +352 -0
  185. package/src/package-version-consistency.test.ts +25 -0
  186. package/src/parent-source-marker.test.ts +50 -0
  187. package/src/password-network-tokens.ts +25 -0
  188. package/src/peer-reply-atomic.test.ts +455 -0
  189. package/src/peer-reply-capability.test.ts +70 -0
  190. package/src/pg-worker.ts +87 -0
  191. package/src/project-dir-warn-clear-http.test.ts +132 -0
  192. package/src/project-viewer-can-http.test.ts +116 -0
  193. package/src/push.test.ts +20 -10
  194. package/src/push.ts +466 -13
  195. package/src/redact-tokens.test.ts +65 -0
  196. package/src/redact-tokens.ts +40 -0
  197. package/src/rename.ts +38 -10
  198. package/src/reply-target-derivation.test.ts +96 -0
  199. package/src/report-status-handover-capabilities-http.test.ts +124 -0
  200. package/src/report-status-host-schema.test.ts +235 -0
  201. package/src/report-status-resume-id-handover.test.ts +184 -0
  202. package/src/report-status-secret-keys.test.ts +140 -0
  203. package/src/require-explicit-test-db.ts +9 -0
  204. package/src/requirement-due-reminders-http.test.ts +620 -0
  205. package/src/requirement-due-reminders.ts +416 -0
  206. package/src/requirement-events-http.test.ts +268 -0
  207. package/src/requirement-events.test.ts +45 -0
  208. package/src/requirement-events.ts +144 -0
  209. package/src/requirement-notify.ts +165 -0
  210. package/src/requirement-participant-notify-http.test.ts +309 -0
  211. package/src/requirement-tag-ops-http.test.ts +425 -0
  212. package/src/requirement-tag-tree-http.test.ts +275 -0
  213. package/src/requirement-tag-tree.ts +127 -0
  214. package/src/requirement-tags.ts +102 -0
  215. package/src/requirements-abandoned-http.test.ts +236 -0
  216. package/src/requirements-comment-http.test.ts +167 -0
  217. package/src/requirements-completed-at-migration.test.ts +70 -0
  218. package/src/requirements-errors-mcp-http.test.ts +164 -0
  219. package/src/requirements-errors.ts +158 -0
  220. package/src/requirements-etag-http.test.ts +91 -0
  221. package/src/requirements-http.test.ts +709 -0
  222. package/src/requirements-last-event-http.test.ts +349 -0
  223. package/src/requirements-list-mcp-slim-http.test.ts +155 -0
  224. package/src/requirements-list-slim-http.test.ts +324 -0
  225. package/src/requirements-mcp.test.ts +163 -0
  226. package/src/requirements-migrate.ts +283 -0
  227. package/src/requirements-owner-strict-mcp-http.test.ts +145 -0
  228. package/src/requirements-people-http.test.ts +114 -0
  229. package/src/requirements-people-mcp-http.test.ts +231 -0
  230. package/src/requirements-people.ts +196 -0
  231. package/src/requirements-priority-lowest.test.ts +114 -0
  232. package/src/requirements-projects-parent-http.test.ts +123 -0
  233. package/src/requirements-search-http.test.ts +182 -0
  234. package/src/requirements-search.test.ts +32 -0
  235. package/src/requirements-search.ts +145 -0
  236. package/src/requirements-seq-http.test.ts +193 -0
  237. package/src/requirements-seq-migration.test.ts +63 -0
  238. package/src/requirements-start-date.test.ts +125 -0
  239. package/src/requirements-stats-http.test.ts +357 -0
  240. package/src/requirements-stats.ts +195 -0
  241. package/src/requirements-status-participants-http.test.ts +222 -0
  242. package/src/requirements-upgrade-e2e.test.ts +126 -0
  243. package/src/requirements-upgrade-migration.test.ts +98 -0
  244. package/src/requirements.ts +2027 -0
  245. package/src/resolve-port.test.ts +57 -0
  246. package/src/resolve-port.ts +44 -0
  247. package/src/response-charset.test.ts +130 -0
  248. package/src/rest-alias-network-fallback-http.test.ts +123 -0
  249. package/src/rest-alias-network-fallback.test.ts +60 -0
  250. package/src/rest-alias-network-fallback.ts +65 -0
  251. package/src/rest-explicit-columns-http.test.ts +266 -0
  252. package/src/rest-identity.test.ts +130 -0
  253. package/src/rest-identity.ts +141 -0
  254. package/src/rest-projections.ts +72 -0
  255. package/src/rest-read-network-real-chain.test.ts +97 -0
  256. package/src/rest-write-network-resolution.test.ts +133 -0
  257. package/src/restart-readiness-http.test.ts +121 -0
  258. package/src/restricted-files.ts +76 -0
  259. package/src/retention-first-sweep-quiet.test.ts +31 -0
  260. package/src/retention.test.ts +100 -40
  261. package/src/retention.ts +423 -104
  262. package/src/route-callers-http.test.ts +120 -0
  263. package/src/route-timing.test.ts +211 -0
  264. package/src/route-timing.ts +262 -0
  265. package/src/rules-file-duplicate-alias.test.ts +234 -0
  266. package/src/rules-file-session-target.test.ts +207 -0
  267. package/src/rules-file-transport.test.ts +237 -0
  268. package/src/runtime-label.test.ts +22 -0
  269. package/src/runtime-label.ts +21 -0
  270. package/src/runtime-readiness.ts +90 -0
  271. package/src/schedule-agent-mcp-http.test.ts +391 -0
  272. package/src/schedule-agent.ts +192 -0
  273. package/src/schedule-starved.test.ts +92 -0
  274. package/src/schedule-starved.ts +114 -0
  275. package/src/scheduled-backoff-http.test.ts +193 -0
  276. package/src/scheduled-backoff.ts +64 -0
  277. package/src/scheduled-doorbell-nodeless-session.test.ts +134 -0
  278. package/src/scheduled-failure-backoff-2622.test.ts +145 -0
  279. package/src/scheduled-failure-code.test.ts +73 -0
  280. package/src/scheduled-failure-code.ts +105 -0
  281. package/src/scheduled-failures-http.test.ts +279 -0
  282. package/src/scheduled-failures.ts +377 -0
  283. package/src/scheduled-noprogress-backoff-2622.test.ts +133 -0
  284. package/src/scheduled-offline-backoff-probe.test.ts +56 -0
  285. package/src/scheduled-offline.test.ts +131 -0
  286. package/src/scheduled-offline.ts +66 -0
  287. package/src/scheduled-outcome-guidance-http.test.ts +139 -0
  288. package/src/scheduled-outcome-guidance.ts +9 -0
  289. package/src/scheduled-reply-unread-http.test.ts +212 -0
  290. package/src/scheduled-requirement-wake-http.test.ts +279 -0
  291. package/src/scheduled-requirement-wake.ts +125 -0
  292. package/src/scheduled-run-terminal.test.ts +268 -0
  293. package/src/scheduled-skip-blocking-task.test.ts +120 -0
  294. package/src/scheduled-skip-path-backoff-2622.test.ts +98 -0
  295. package/src/scheduled-stuck-http.test.ts +312 -0
  296. package/src/scheduled-stuck-notice-cap.test.ts +80 -0
  297. package/src/scheduled-stuck.ts +219 -0
  298. package/src/scheduled-tasks-http.test.ts +679 -0
  299. package/src/scheduled-tasks.ts +959 -0
  300. package/src/scheduled-work-outcome-http.test.ts +154 -0
  301. package/src/scheduled-work-outcome.ts +50 -0
  302. package/src/scoped-secrets.ts +139 -0
  303. package/src/send-dedup-request-id.test.ts +229 -0
  304. package/src/send-reply-agent-warning.test.ts +202 -0
  305. package/src/send-reply-alias-optional.test.ts +131 -0
  306. package/src/send-reply-attachments.test.ts +458 -0
  307. package/src/send_dedup.test.ts +54 -0
  308. package/src/send_dedup.ts +52 -6
  309. package/src/serve-error.test.ts +38 -0
  310. package/src/serve-error.ts +27 -0
  311. package/src/server.ts +6028 -0
  312. package/src/session-task-on-dispatch.ts +14 -0
  313. package/src/session-token-ownership-http.test.ts +122 -0
  314. package/src/shared/codex-inventory.ts +41 -0
  315. package/src/shared/daemon-provider-login.ts +31 -0
  316. package/src/shared/daemon-provider-snapshot.ts +52 -0
  317. package/src/shared/external-schedule-contract.ts +60 -0
  318. package/src/shared/node-name.test.ts +62 -0
  319. package/src/shared/node-name.ts +161 -0
  320. package/src/shared/provider-application.ts +29 -0
  321. package/src/shared/provider-collection.ts +14 -0
  322. package/src/shared/provider-initialization.ts +8 -0
  323. package/src/shared/reserved-env-drift.test.ts +10 -0
  324. package/src/shared/scoped-secret-contract.ts +5 -0
  325. package/src/shared/task-content-limit-drift.test.ts +28 -0
  326. package/src/shared/task-content-limit.ts +25 -0
  327. package/src/side-thread-command-transport.test.ts +312 -0
  328. package/src/side-thread-command-transport.ts +318 -0
  329. package/src/side-thread-http-integration.test.ts +233 -0
  330. package/src/side-thread-http.ts +504 -0
  331. package/src/side-thread-production.test.ts +72 -0
  332. package/src/side-thread-production.ts +118 -0
  333. package/src/side-thread.test.ts +1067 -0
  334. package/src/side-thread.ts +2499 -0
  335. package/src/skillhub-http.test.ts +108 -0
  336. package/src/sqlite-close-checkpoint.test.ts +78 -0
  337. package/src/start-node.test.ts +264 -0
  338. package/src/status-alias-filter-http.test.ts +106 -0
  339. package/src/status-alias-resolver-http.test.ts +163 -0
  340. package/src/status-alias-resolver.ts +19 -0
  341. package/src/status-node-id-filter-http.test.ts +161 -0
  342. package/src/status-read-cache-http.test.ts +229 -0
  343. package/src/status-read-cache.ts +122 -0
  344. package/src/stop-delete-node.test.ts +567 -1
  345. package/src/task-access-http.test.ts +402 -0
  346. package/src/task-access.ts +420 -0
  347. package/src/task-activity.ts +60 -0
  348. package/src/task-auth-origin-http.test.ts +93 -0
  349. package/src/task-auth-origin.test.ts +24 -0
  350. package/src/task-auth-origin.ts +7 -0
  351. package/src/task-consumption.test.ts +482 -0
  352. package/src/task-diagnostic-http.test.ts +149 -0
  353. package/src/task-diagnostic.test.ts +115 -0
  354. package/src/task-diagnostic.ts +118 -0
  355. package/src/task-expiry-notice-http.test.ts +287 -0
  356. package/src/task-expiry-notice.ts +315 -0
  357. package/src/task-idempotency-mcp.test.ts +142 -0
  358. package/src/task-idempotency.test.ts +76 -0
  359. package/src/task-idempotency.ts +81 -0
  360. package/src/task-late-replies.ts +54 -0
  361. package/src/task-late-reply-http.test.ts +152 -0
  362. package/src/task-lifecycle-watcher-busy.test.ts +114 -0
  363. package/src/task-lifecycle-watcher.test.ts +204 -0
  364. package/src/task-lifecycle-watcher.ts +109 -0
  365. package/src/task-network-resolution-http.test.ts +140 -0
  366. package/src/task-offline-delivery-2668.test.ts +119 -0
  367. package/src/task-offline-delivery.ts +81 -0
  368. package/src/task-orphan-http.test.ts +287 -0
  369. package/src/task-orphan.ts +119 -0
  370. package/src/task-queue-ahead-http.test.ts +309 -0
  371. package/src/task-queue-ahead-scale.test.ts +236 -0
  372. package/src/task-queue-ahead.ts +186 -0
  373. package/src/task-rejection-log-http.test.ts +160 -0
  374. package/src/task-rejection-log.ts +49 -0
  375. package/src/task-sender-http.test.ts +143 -0
  376. package/src/task-stale-open-http.test.ts +290 -0
  377. package/src/task-stale-open.ts +103 -0
  378. package/src/tasks-pagination-http.test.ts +141 -0
  379. package/src/team-rules-status-http.test.ts +90 -0
  380. package/src/team-rules-status.test.ts +59 -0
  381. package/src/team-rules-status.ts +72 -0
  382. package/src/tool-audience-http.test.ts +230 -0
  383. package/src/tool-audience.ts +120 -0
  384. package/src/tools-list-json-schema.test.ts +94 -0
  385. package/src/tools.ts +4226 -405
  386. package/src/upload-early-reject-guard.test.ts +155 -0
  387. package/src/uploads-http.test.ts +97 -15
  388. package/src/uploads.ts +103 -6
  389. package/src/user-avatar-http.test.ts +74 -0
  390. package/src/user-avatar-image.ts +160 -0
  391. package/src/user-avatar-migration.test.ts +25 -0
  392. package/src/user-avatar-upload-http.test.ts +348 -0
  393. package/src/user-inbox-by-agent-http.test.ts +161 -0
  394. package/src/user-inbox-netid-notnull.test.ts +122 -0
  395. package/src/user-inbox-read-http.test.ts +223 -0
  396. package/src/user-inbox-schema.test.ts +54 -0
  397. package/src/version-stats.test.ts +66 -0
  398. package/src/version-stats.ts +109 -0
@@ -0,0 +1,420 @@
1
+ // RFC-041 第一阶段(board #487):节点(Agent)自己的权限 —— 先记录、后执行。
2
+ //
3
+ // 节点的权限 = 主人的权限 ∩ 节点的模式(nodes.permission_mode:normal 正常 / readonly 只读 / restricted 受限)。
4
+ //
5
+ // • 模式是主人主动设的,**设了就立刻生效**(不看开关):只读的节点写什么都拒(mode_readonly);
6
+ // 受限的节点只碰派给它的任务、派活只给主人授权的 Agent(mode_restricted_not_assigned / agent_not_granted_to_owner)。
7
+ // • 正常模式下的收紧(超出主人可见范围 beyond_owner_visibility、主人没被授权的 Agent agent_not_granted_to_owner、
8
+ // 只有人能做的事 human_only)由 Hub 开关 COMMHUB_NODE_PERMISSIONS 决定:
9
+ // log(默认)—— 照常放行,只把「本来会被拒」按 (节点, 路由, 原因, 小时) 合并记进 node_permission_log;
10
+ // enforce —— 记录并拒绝(REST 403 / MCP 错误 node_permission_denied + reason + hint);
11
+ // off —— 不判也不记(显式模式仍然生效)。
12
+ //
13
+ // 判定的入口:REST(requirements.ts、/api/task、/api/broadcast、/api/nodes/:id 写)、MCP(tools.ts 按工具名包一层)、
14
+ // SSE(/events/:session、/events/network/:id)。只对节点令牌(ntok_)生效;用户令牌一条不变。
15
+ // 只增不改:nodes 多一列 permission_mode(默认 normal),新表 node_permission_log。回滚到上一版安全:旧代码不读它们。
16
+
17
+ import { db } from "./db.js";
18
+ import { canMessageAgent, type AgentRef } from "./agent-access.js";
19
+ import { resolveNodeCaller } from "./create-node.js";
20
+
21
+ export type NodePermissionMode = "normal" | "readonly" | "restricted";
22
+ export const NODE_PERMISSION_MODES: readonly NodePermissionMode[] = ["normal", "readonly", "restricted"];
23
+ export type NodePermissionsFlag = "log" | "off" | "enforce";
24
+ export type NodePermissionReason =
25
+ | "beyond_owner_visibility"
26
+ | "agent_not_granted_to_owner"
27
+ | "mode_readonly"
28
+ | "mode_restricted_not_assigned"
29
+ | "human_only"
30
+ | "owner_unknown"
31
+ /** #2969 —— 主人给这个节点设了对端白名单,目标不在名单里。 */
32
+ | "peer_not_allowed"
33
+ /** #2969 后半 —— 主人在这个节点的接口白名单里没有列这个工具/路由。 */
34
+ | "tool_not_allowed";
35
+
36
+ /** 显式模式的原因:不看开关,永远拒。 */
37
+ // 白名单和 readonly/restricted 同类:**主人主动设的,设了就立刻生效**,不看开关。
38
+ const MODE_REASONS: ReadonlySet<NodePermissionReason> = new Set(["mode_readonly", "mode_restricted_not_assigned", "peer_not_allowed", "tool_not_allowed"]);
39
+
40
+ // #2969 —— 节点级对端白名单:JSON 数组(alias 或 node_id);NULL = 不限制。
41
+ // 只增不改:旧代码不读这一列;设为 NULL 时行为与现在完全一致。
42
+ // #2969 后半 —— 接口白名单:JSON 数组(MCP 工具名);NULL = 不限制。
43
+ try { db.exec("ALTER TABLE nodes ADD COLUMN tool_allowlist TEXT"); } catch (e: any) {
44
+ if (!/duplicate column|already exists/i.test(e?.message || "")) throw e;
45
+ }
46
+ try { db.exec("ALTER TABLE nodes ADD COLUMN peer_allowlist TEXT"); } catch (e: any) {
47
+ if (!/duplicate column|already exists/i.test(e?.message || "")) throw e;
48
+ }
49
+ try { db.exec("ALTER TABLE nodes ADD COLUMN permission_mode TEXT NOT NULL DEFAULT 'normal'"); } catch (e: any) {
50
+ if (!/duplicate column|already exists/i.test(e?.message || "")) throw e;
51
+ }
52
+ db.exec(`
53
+ CREATE TABLE IF NOT EXISTS node_permission_log (
54
+ network_id TEXT NOT NULL,
55
+ node_id TEXT NOT NULL,
56
+ route TEXT NOT NULL,
57
+ reason TEXT NOT NULL,
58
+ hour TEXT NOT NULL,
59
+ hits INTEGER NOT NULL DEFAULT 1,
60
+ sample TEXT,
61
+ PRIMARY KEY (network_id, node_id, route, reason, hour)
62
+ );
63
+ CREATE INDEX IF NOT EXISTS idx_node_permission_log_hour ON node_permission_log(network_id, hour);
64
+ `);
65
+
66
+ // #2823 —— 调用面计数。
67
+ //
68
+ // 为什么需要第二张表:`node_permission_log` 只记 **would-be denial**(`if (!verdict) return false`),
69
+ // 所以它回答不了「节点到底有没有在调这些受限工具」。生产实测 30 天 0 行,
70
+ // 分不清「没人越界」和「几乎没人碰过」——而这两者的结论完全相反(#525 的切 enforce 决策就卡在这)。
71
+ //
72
+ // 设计取舍:
73
+ // · 只记**到达闸的调用**(nodeDecide 的入参就是 classified 工具),不记全部 MCP 调用;
74
+ // · 与拒绝日志同一条纪律:按 (网络, 节点, 工具, 小时) 合并成一行 + hits,不逐次插行;
75
+ // · 同样的 30 天保留期与 20000 行上限,超限后只加已有的行;
76
+ // · 与 `node_permission_log` **分开**,绝不把放行样本混进拒绝统计(那会把既有报表口径改坏)。
77
+ db.exec(`
78
+ CREATE TABLE IF NOT EXISTS node_tool_calls (
79
+ network_id TEXT NOT NULL,
80
+ node_id TEXT NOT NULL,
81
+ tool TEXT NOT NULL,
82
+ hour TEXT NOT NULL,
83
+ hits INTEGER NOT NULL DEFAULT 1,
84
+ PRIMARY KEY (network_id, node_id, tool, hour)
85
+ );
86
+ CREATE INDEX IF NOT EXISTS idx_node_tool_calls_hour ON node_tool_calls(network_id, hour);
87
+ `);
88
+
89
+ let callLogFull = false;
90
+ /**
91
+ * 行数上限。**刻意比 `LOG_MAX_ROWS`(20 000) 高一个数量级**。
92
+ *
93
+ * 为什么不能沿用 20 000:这张表的键是 `(network, node, tool, hour)` —— 每过一个小时
94
+ * 就是一整批新键。生产实测(.184 上线 1 小时):75 行/小时 ⇒ 1 800 行/天,
95
+ * 20 000 ÷ 1 800 ≈ **11 天**,而保留期是 30 天。
96
+ *
97
+ * 撞上限的后果不是「变慢」,而是 `callLogFull` 只给已有行加次数、**不再插新行**,
98
+ * 于是新的一小时一行都写不进去 —— 计数**静默归零**,不报错、不告警。
99
+ * 而这张表正是 #525「要不要切 enforce」的判据,读到归零会把「没人调用」当成结论。
100
+ *
101
+ * 200 000 行 ≈ 26 MB(实测 91 行 = 12 KB),对这张表完全可接受;
102
+ * 按当前速率可覆盖 30 天保留期且留 2 倍余量。
103
+ */
104
+ export const TOOL_CALL_MAX_ROWS = 200_000;
105
+
106
+ /** 计一次「到达权限闸」的工具调用。绝不影响请求本身 —— 出错只写日志。 */
107
+ export function recordNodeToolCall(id: NodeIdentity, tool: string): void {
108
+ try {
109
+ const now = new Date();
110
+ if (now.getTime() - lastPrune > PRUNE_EVERY_MS) {
111
+ pruneNodePermissionLog(now);
112
+ const calls = Number(db.get<{ n: number | string }>("SELECT COUNT(*) AS n FROM node_tool_calls")?.n ?? 0);
113
+ callLogFull = calls >= TOOL_CALL_MAX_ROWS;
114
+ db.run("DELETE FROM node_tool_calls WHERE hour < ?1", [hourOf(new Date(now.getTime() - LOG_RETENTION_DAYS * 86_400_000))]);
115
+ }
116
+ const hour = hourOf(now);
117
+ const name = tool.slice(0, 120);
118
+ const updated = db.run(
119
+ "UPDATE node_tool_calls SET hits = hits + 1 WHERE network_id = ?1 AND node_id = ?2 AND tool = ?3 AND hour = ?4",
120
+ [id.networkId, id.logKey, name, hour],
121
+ );
122
+ if (Number(updated?.changes ?? 0) > 0 || callLogFull) return;
123
+ db.run(
124
+ `INSERT INTO node_tool_calls (network_id, node_id, tool, hour, hits) VALUES (?1, ?2, ?3, ?4, 1)
125
+ ON CONFLICT(network_id, node_id, tool, hour) DO UPDATE SET hits = node_tool_calls.hits + 1`,
126
+ [id.networkId, id.logKey, name, hour],
127
+ );
128
+ } catch (e) {
129
+ console.error(`[node-permissions] tool-call counter failed: ${(e as Error).message}`);
130
+ }
131
+ }
132
+
133
+ /** 开关。未设 / 写错 → log(安全的默认:只记不拦)。每次现读:测试和运维改环境变量后无需重启模块。 */
134
+ export function nodePermissionsFlag(): NodePermissionsFlag {
135
+ const raw = (process.env.COMMHUB_NODE_PERMISSIONS ?? "").trim().toLowerCase();
136
+ return raw === "off" || raw === "enforce" ? raw : "log";
137
+ }
138
+
139
+ export type NodeIdentity = {
140
+ networkId: string;
141
+ /** 绑定的节点;老的未绑定令牌 = null(按「正常」判,记录时用 token:<token_id>)。 */
142
+ nodeId: string | null;
143
+ logKey: string;
144
+ aliases: string[];
145
+ ownerUserId: string | null;
146
+ mode: NodePermissionMode;
147
+ /** #2969 —— 对端白名单(alias / node_id 都算命中)。null = 不限制。 */
148
+ peerAllowlist: string[] | null;
149
+ /** #2969 后半 —— 接口白名单(MCP 工具名)。null = 不限制。 */
150
+ toolAllowlist: string[] | null;
151
+ };
152
+
153
+ function normalizePeerAllowlist(raw: unknown): string[] | null {
154
+ if (typeof raw !== "string" || !raw.trim()) return null;
155
+ try {
156
+ const parsed = JSON.parse(raw);
157
+ if (!Array.isArray(parsed)) return null;
158
+ const out = parsed.filter((x): x is string => typeof x === "string" && x.trim().length > 0).map(x => x.trim());
159
+ return out.length ? out : null;
160
+ } catch { return null; }
161
+ }
162
+
163
+ const normalizeToolAllowlist = normalizePeerAllowlist;
164
+
165
+ function normalizeMode(raw: unknown): NodePermissionMode {
166
+ return raw === "readonly" || raw === "restricted" ? raw : "normal";
167
+ }
168
+
169
+ /** 节点令牌 → 节点身份(一次带索引的查询)。不是节点令牌 / 查不到 → null。 */
170
+ export function nodeIdentity(tokenId: string | null | undefined, networkId: string | null | undefined): NodeIdentity | null {
171
+ if (!tokenId || !networkId) return null;
172
+ const row = db.get<{ user_id: string | null; name: string | null }>(
173
+ `SELECT user_id, name FROM api_tokens WHERE token_id = ?1 AND network_id = ?2`,
174
+ tokenId, networkId,
175
+ );
176
+ if (!row) return null;
177
+ const resolved = resolveNodeCaller(tokenId);
178
+ // Revoked or not node-shaped: this lookup is not a second revocation gate.
179
+ if (!resolved.ok && resolved.reason === "not_a_node_token") {
180
+ const aliases = row.name?.startsWith("node:") ? [row.name.slice(5)] : [];
181
+ return {
182
+ networkId,
183
+ nodeId: null,
184
+ logKey: `token:${tokenId}`,
185
+ aliases,
186
+ ownerUserId: row.user_id,
187
+ mode: "normal",
188
+ peerAllowlist: null,
189
+ toolAllowlist: null,
190
+ };
191
+ }
192
+ if (!resolved.ok || resolved.networkId !== networkId) {
193
+ return {
194
+ networkId,
195
+ nodeId: null,
196
+ logKey: `token:${tokenId}`,
197
+ aliases: [],
198
+ ownerUserId: row.user_id,
199
+ mode: "normal",
200
+ peerAllowlist: null,
201
+ toolAllowlist: null,
202
+ };
203
+ }
204
+ if (resolved.kind === "unregistered") {
205
+ return {
206
+ networkId,
207
+ nodeId: null,
208
+ logKey: `token:${tokenId}`,
209
+ aliases: resolved.alias ? [resolved.alias] : [],
210
+ ownerUserId: row.user_id,
211
+ mode: "normal",
212
+ peerAllowlist: null,
213
+ toolAllowlist: null,
214
+ };
215
+ }
216
+ const node = db.get<{ owner_user_id: string | null; permission_mode: string | null; peer_allowlist: string | null; tool_allowlist: string | null }>(
217
+ `SELECT owner_user_id, permission_mode, peer_allowlist, tool_allowlist FROM nodes WHERE node_id = ?1 AND network_id = ?2`,
218
+ resolved.nodeId, networkId,
219
+ );
220
+ return {
221
+ networkId,
222
+ nodeId: resolved.nodeId,
223
+ logKey: resolved.nodeId,
224
+ aliases: [resolved.alias],
225
+ ownerUserId: node?.owner_user_id || row.user_id || null,
226
+ mode: normalizeMode(node?.permission_mode),
227
+ peerAllowlist: normalizePeerAllowlist(node?.peer_allowlist),
228
+ toolAllowlist: normalizeToolAllowlist(node?.tool_allowlist),
229
+ };
230
+ }
231
+
232
+ export type Verdict = { reason: NodePermissionReason; sample?: string } | null;
233
+
234
+ /**
235
+ * 判一次:verdict=null → 放行;否则按原因和开关决定拒不拒,并记一行(off 时正常模式的原因不记)。
236
+ * 返回 true = 拒绝。
237
+ */
238
+ export function nodeDecide(id: NodeIdentity, route: string, verdict: Verdict): boolean {
239
+ // #2823 —— 先计数,再判定。放行与拒绝都算一次「到达闸的调用」,
240
+ // 这样「受限工具被调了 N 次、其中本来会被拒 M 次」才可测;否则分母永远是 0。
241
+ recordNodeToolCall(id, route);
242
+ if (!verdict) return false;
243
+ const explicit = MODE_REASONS.has(verdict.reason);
244
+ const flag = nodePermissionsFlag();
245
+ if (!explicit && flag === "off") return false;
246
+ recordNodePermission(id, route, verdict.reason, verdict.sample);
247
+ return explicit || flag === "enforce";
248
+ }
249
+
250
+ const HINTS: Record<NodePermissionReason, string> = {
251
+ beyond_owner_visibility: "this node acts with its owner's permissions, and its owner cannot see or edit this; ask the owner for access, or assign the task to this node",
252
+ agent_not_granted_to_owner: "this Agent has not been granted to this node's owner; ask a network admin to grant it",
253
+ mode_readonly: "this node is in read-only mode; the node's owner can switch it to normal in the app",
254
+ mode_restricted_not_assigned: "this node is in restricted mode and only touches tasks assigned to it; assign the task to this node, or have the owner switch it to normal",
255
+ human_only: "only people can do this (members, projects, permissions, providers, secrets, other nodes); use a user token",
256
+ owner_unknown: "this node's owner is unknown; recreate the node token from the owner's account",
257
+ peer_not_allowed: "this node is limited to an explicit peer allowlist; the target is not on it — ask the node's owner to add it, or clear the allowlist",
258
+ tool_not_allowed: "this node is limited to an explicit tool allowlist; this tool is not on it — ask the node's owner to add it, or clear the allowlist",
259
+ };
260
+
261
+ export function nodePermissionDeniedBody(reason: NodePermissionReason, route: string): { ok: false; error: "node_permission_denied"; reason: NodePermissionReason; route: string; hint: string } {
262
+ return { ok: false, error: "node_permission_denied", reason, route, hint: HINTS[reason] };
263
+ }
264
+
265
+ // ── 记录:按 (网络, 节点, 路由, 原因, 小时) 合并;有上限、会清理 ──
266
+ export const LOG_RETENTION_DAYS = 30;
267
+ export const LOG_MAX_ROWS = 20_000;
268
+ const PRUNE_EVERY_MS = 60 * 60 * 1000;
269
+ let lastPrune = 0;
270
+ let logFull = false;
271
+
272
+ function hourOf(now = new Date()): string {
273
+ return now.toISOString().slice(0, 13); // 2026-10-03T08
274
+ }
275
+
276
+ /** 清掉保留期外的行,并重新判断是否到了上限(到上限后只给已有的行加次数,不再新开行)。 */
277
+ export function pruneNodePermissionLog(now = new Date()): void {
278
+ const cutoff = hourOf(new Date(now.getTime() - LOG_RETENTION_DAYS * 86_400_000));
279
+ db.run("DELETE FROM node_permission_log WHERE hour < ?1", [cutoff]);
280
+ const n = Number(db.get<{ n: number | string }>("SELECT COUNT(*) AS n FROM node_permission_log")?.n ?? 0);
281
+ logFull = n >= LOG_MAX_ROWS;
282
+ lastPrune = now.getTime();
283
+ }
284
+
285
+ export function recordNodePermission(id: NodeIdentity, route: string, reason: NodePermissionReason, sample?: string): void {
286
+ try {
287
+ const now = new Date();
288
+ if (now.getTime() - lastPrune > PRUNE_EVERY_MS) pruneNodePermissionLog(now);
289
+ const hour = hourOf(now);
290
+ const s = sample ? sample.slice(0, 200) : null;
291
+ const updated = db.run(
292
+ "UPDATE node_permission_log SET hits = hits + 1, sample = COALESCE(?6, sample) WHERE network_id = ?1 AND node_id = ?2 AND route = ?3 AND reason = ?4 AND hour = ?5",
293
+ [id.networkId, id.logKey, route.slice(0, 120), reason, hour, s],
294
+ );
295
+ if (Number(updated?.changes ?? 0) > 0 || logFull) return;
296
+ db.run(
297
+ `INSERT INTO node_permission_log (network_id, node_id, route, reason, hour, hits, sample) VALUES (?1, ?2, ?3, ?4, ?5, 1, ?6)
298
+ ON CONFLICT(network_id, node_id, route, reason, hour) DO UPDATE SET hits = node_permission_log.hits + 1`,
299
+ [id.networkId, id.logKey, route.slice(0, 120), reason, hour, s],
300
+ );
301
+ } catch (e) {
302
+ // 记录失败绝不影响请求本身。
303
+ console.error(`[node-permissions] log failed: ${(e as Error).message}`);
304
+ }
305
+ }
306
+
307
+ /** Test-only:让下一次记录先清理一遍,并可改上限判断。 */
308
+ export function __resetNodePermissionLogStateForTest(): void { lastPrune = 0; logFull = false; }
309
+
310
+ // ── 规则 ──
311
+
312
+ /** 派活 / 发消息 / 重派给 target。发给自己永远可以。 */
313
+ export function dispatchVerdict(id: NodeIdentity, target: AgentRef): Verdict {
314
+ if ((target.alias && id.aliases.includes(target.alias)) || (target.nodeId && id.nodeId && target.nodeId === id.nodeId)) return null;
315
+ const sample = target.alias ?? target.nodeId ?? undefined;
316
+ // #2969 —— 主人设了对端白名单:不在名单上的一律拒(显式原因,不看开关)。
317
+ // 命中判定用 alias 或 node_id 任一即可 —— 主人按 alias 写、节点按 node_id 找,两边都要认。
318
+ if (id.peerAllowlist) {
319
+ const hit = (target.alias && id.peerAllowlist.includes(target.alias))
320
+ || (target.nodeId && id.peerAllowlist.includes(target.nodeId));
321
+ if (!hit) return { reason: "peer_not_allowed", sample };
322
+ }
323
+ if (id.mode === "readonly") return { reason: "mode_readonly", sample };
324
+ if (!id.ownerUserId) return id.mode === "restricted" ? { reason: "mode_restricted_not_assigned", sample } : { reason: "owner_unknown" };
325
+ if (!canMessageAgent(id.ownerUserId, id.networkId, target)) {
326
+ // 受限是主人设的 → 必拒(模式原因);正常下是开关管的收紧。
327
+ return { reason: id.mode === "restricted" ? "mode_restricted_not_assigned" : "agent_not_granted_to_owner", sample };
328
+ }
329
+ return null;
330
+ }
331
+
332
+ /**
333
+ * #2969 后半 —— 接口白名单判定。
334
+ *
335
+ * 🔴 `always` 类**永远放行**:get_inbox / ack_inbox / send_reply / report_status 这些是节点
336
+ * 自己的生命周期协议。把它们也挡掉,节点既不能干活、也不能报告自己干不了 —— 那会变成
337
+ * 一个比"没受限"更隐蔽的假活节点。
338
+ */
339
+ export function toolAllowlistVerdict(id: NodeIdentity, tool: string, alwaysClass: boolean): Verdict {
340
+ if (!id.toolAllowlist || alwaysClass) return null;
341
+ return id.toolAllowlist.includes(tool) ? null : { reason: "tool_not_allowed", sample: tool };
342
+ }
343
+
344
+ /** 广播:只读 / 受限都不行(会发给没派给它、也未必授权的 Agent)。 */
345
+ export function broadcastVerdict(id: NodeIdentity): Verdict {
346
+ // #2969 —— 设了对端白名单的节点不能广播:广播的收件人是「任意对端」,
347
+ // 与白名单的语义直接冲突(名单说「只能找这几个」,广播说「发给所有人」)。
348
+ if (id.peerAllowlist) return { reason: "peer_not_allowed" };
349
+ if (id.mode === "readonly") return { reason: "mode_readonly" };
350
+ if (id.mode === "restricted") return { reason: "mode_restricted_not_assigned" };
351
+ if (!id.ownerUserId) return { reason: "owner_unknown" };
352
+ return null;
353
+ }
354
+
355
+ /** 一般的写(管节点、提交技能、探测模型…):只读 / 受限拒;正常放行(由各自的既有规则管)。 */
356
+ export function writeVerdict(id: NodeIdentity, sample?: string): Verdict {
357
+ if (id.mode === "readonly") return { reason: "mode_readonly", sample };
358
+ if (id.mode === "restricted") return { reason: "mode_restricted_not_assigned", sample };
359
+ return null;
360
+ }
361
+
362
+ /** 只有人能做的事。只读 / 受限下报模式原因(那是主人设的、必拒);正常下报 human_only。 */
363
+ export function humanOnlyVerdict(id: NodeIdentity, sample?: string): Verdict {
364
+ return writeVerdict(id, sample) ?? { reason: "human_only", sample };
365
+ }
366
+
367
+ /** 订阅别的会话 / 整个网络的推送流:受限不行;正常按主人能不能看到那个 Agent。 */
368
+ export function streamVerdict(id: NodeIdentity, target: AgentRef | "network"): Verdict {
369
+ if (target !== "network" && ((target.alias && id.aliases.includes(target.alias)) || (target.nodeId && target.nodeId === id.nodeId))) return null;
370
+ if (id.mode === "restricted") return { reason: "mode_restricted_not_assigned", sample: target === "network" ? "network" : target.alias ?? undefined };
371
+ if (!id.ownerUserId) return { reason: "owner_unknown" };
372
+ if (target !== "network" && !canMessageAgent(id.ownerUserId, id.networkId, target)) {
373
+ return { reason: "beyond_owner_visibility", sample: target.alias ?? undefined };
374
+ }
375
+ return null;
376
+ }
377
+
378
+ // ── MCP:每个工具归一类(test 钉住「每个注册的工具都归了类」,新工具忘了归类会红) ──
379
+ export type ToolClass = "always" | "read" | "dispatch" | "broadcast" | "requirements" | "schedule" | "node_write" | "human_only";
380
+ export const NODE_TOOL_CLASS: Readonly<Record<string, ToolClass>> = {
381
+ daemon_provider_snapshot: "human_only",
382
+ pull_daemon_provider_snapshots: "always", ack_daemon_provider_snapshot: "always",
383
+ // 回复 / 上报 / 自己的收件箱 / 生命周期协议(节点自己的请求)—— 任何模式都能做
384
+ report_status: "always", report_completion: "always", get_inbox: "always", ack_inbox: "always",
385
+ mark_tasks_runtime_submitted: "always", mark_tasks_consumed: "always", send_reply: "always", send_peer_reply: "always", send_ack: "always",
386
+ get_config_update: "always", ack_config_update: "always", get_rules_file_request: "always", ack_rules_file_request: "always", get_rules_file_result: "always",
387
+ get_create_request: "always", ack_create_request: "always", get_stop_request: "always", ack_stop_request: "always",
388
+ get_start_request: "always", ack_start_request: "always", get_probe_request: "always", ack_probe_request: "always",
389
+ get_opencode_catalog_request: "always", ack_opencode_catalog: "always",
390
+ list_my_pending_create_requests: "always", list_my_pending_lifecycle_requests: "always", list_my_children: "always",
391
+ request_adopt_node: "human_only", unadopt_node: "human_only",
392
+ get_adopt_request: "always", ack_adopt_request: "always",
393
+ send_desktop_message: "always", // 发给人的私信,不是派活
394
+ requirement_tags: "requirements",
395
+ // 读
396
+ get_all_status: "read", get_session_status: "read", get_task: "read", list_tasks: "read", get_completions: "read", org_whoami: "read",
397
+ list_skills: "read", get_skill: "read", list_host_supervisors: "read", list_network_secrets: "read", list_providers: "read",
398
+ get_probe_results: "read", read_node_rules_file: "read", list_node_skills: "read", read_node_skill: "read", list_node_files: "read",
399
+ read_node_file: "read", tail_node_logs: "read",
400
+ // 派活
401
+ send_task: "dispatch", send_message: "dispatch", retry_task: "dispatch", reassign_task: "dispatch", cancel_task: "dispatch",
402
+ broadcast: "broadcast",
403
+ // 任务看板:在 requirements.ts 里按卡判(REST 与 MCP 同一处)
404
+ requirements_list: "requirements", requirements_people: "requirements", requirements_get: "requirements", requirements_create: "requirements",
405
+ // #1894 —— 组织架构:读是常规读,写由工具内部再判网络 owner/admin(普通成员/节点写会被拒并 audit)。
406
+ departments: "requirements",
407
+ requirements_update: "requirements", requirements_checklist_toggle: "requirements", requirements_upsert_by_external_ref: "requirements",
408
+ requirements_events: "requirements", requirements_comment: "requirements", projects_list: "requirements",
409
+ // 定时任务(#733):在 schedule-agent.ts 里按排程判(范围 / 目标 = send_task 的 dispatchVerdict / 配额)
410
+ schedule_list: "read", schedule_get: "read", schedule_runs: "read",
411
+ schedule_create: "schedule", schedule_update: "schedule", schedule_cancel: "schedule", schedule_run_now: "schedule",
412
+ schedule_batch_interval: "schedule",
413
+ // 写节点 / 技能 / 探测:只读、受限不行;正常由 RFC-036 等既有规则管
414
+ update_node_config: "node_write", write_node_rules_file: "node_write", restart_node: "node_write", create_node: "node_write", clone_node: "node_write",
415
+ stop_node: "node_write", delete_node: "node_write", start_node: "node_write", submit_skill: "node_write", probe_provider_model: "node_write",
416
+ // 只有人能做
417
+ upsert_network_secret: "human_only", upsert_provider: "human_only", update_provider: "human_only",
418
+ projects_create: "human_only", projects_update: "human_only", review_skill: "human_only",
419
+ read_opencode_catalog: "human_only", get_opencode_catalog: "human_only",
420
+ };