@sleep2agi/commhub-server 0.9.0-preview.28 → 0.9.0-preview.280

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 (479) hide show
  1. package/README.md +120 -3
  2. package/bin/commhub.ts +93 -9
  3. package/build-info.json +7 -0
  4. package/package.json +10 -8
  5. package/src/ack-create-request-transport.test.ts +182 -0
  6. package/src/ack-create-request.test.ts +52 -8
  7. package/src/admin-delete-network-http.test.ts +229 -0
  8. package/src/admin-networks-http.test.ts +88 -0
  9. package/src/adoption-candidates-http.test.ts +140 -0
  10. package/src/adoption-candidates.ts +158 -0
  11. package/src/agent-access-batch.test.ts +215 -0
  12. package/src/agent-access.ts +585 -0
  13. package/src/agent-acl-groups-http.test.ts +247 -0
  14. package/src/agent-acl-http.test.ts +691 -0
  15. package/src/agent-acl-slice3-http.test.ts +888 -0
  16. package/src/agent-department-grants.test.ts +129 -0
  17. package/src/agent-department-http.test.ts +215 -0
  18. package/src/agent-groups-perf.test.ts +228 -0
  19. package/src/agent-notice.ts +48 -0
  20. package/src/agent-team-whoami-http.test.ts +98 -0
  21. package/src/agent-teams-http.test.ts +330 -0
  22. package/src/agent-teams.ts +244 -0
  23. package/src/alias-baseline-2571.test.ts +162 -0
  24. package/src/alias-baseline.ts +113 -0
  25. package/src/alias-filter.test.ts +72 -0
  26. package/src/alias-filter.ts +42 -0
  27. package/src/all-status-cache.test.ts +31 -0
  28. package/src/all-status-cache.ts +37 -0
  29. package/src/anet-variant-real-daemon-http.test.ts +184 -0
  30. package/src/api-host-supervisors-can-create-nodes.test.ts +350 -0
  31. package/src/api-host-supervisors-fallback.test.ts +6 -7
  32. package/src/api-host-supervisors-runtime-readiness.test.ts +195 -0
  33. package/src/api-nodes-shape.test.ts +131 -4
  34. package/src/auth-abuse-counters.test.ts +144 -0
  35. package/src/auth-abuse-counters.ts +122 -0
  36. package/src/auth-layer-shape.test.ts +105 -0
  37. package/src/auth-password-change-cli-tokens-http.test.ts +423 -0
  38. package/src/auth-sessions-http.test.ts +260 -0
  39. package/src/auth-validate.test.ts +5 -1
  40. package/src/auth-weak-password-login.test.ts +176 -0
  41. package/src/auth.ts +641 -68
  42. package/src/backfill-node-ids-2664.test.ts +128 -0
  43. package/src/binding-generation-http.test.ts +141 -0
  44. package/src/blocked-exit-on-reply.test.ts +122 -0
  45. package/src/broadcast-fanout-2721.test.ts +149 -0
  46. package/src/broadcast-fanout.ts +117 -0
  47. package/src/build-commit-report-http.test.ts +218 -0
  48. package/src/build-info.test.ts +60 -0
  49. package/src/build-info.ts +85 -0
  50. package/src/chain-attempt-dedup.test.ts +447 -0
  51. package/src/clip.test.ts +36 -0
  52. package/src/clip.ts +48 -0
  53. package/src/clone-node.test.ts +269 -0
  54. package/src/clone-node.ts +289 -0
  55. package/src/codex-config-flags.ts +77 -0
  56. package/src/codex-fork-contract.ts +23 -0
  57. package/src/codex-fork-migration.test.ts +38 -0
  58. package/src/commhub-bin-args.test.ts +85 -0
  59. package/src/config-apply-sec1.test.ts +37 -0
  60. package/src/config-apply-validate.test.ts +188 -1
  61. package/src/config-apply-validate.ts +226 -3
  62. package/src/contracts/session-project-create.ts +14 -0
  63. package/src/contracts/session-source-delivery.ts +16 -0
  64. package/src/contracts/session-source-directory.ts +54 -0
  65. package/src/contracts/session-source-evidence.ts +72 -0
  66. package/src/contracts/session-source-execution.ts +24 -0
  67. package/src/contracts/session-source-transport.ts +18 -0
  68. package/src/cors-origins.test.ts +73 -0
  69. package/src/create-node-blocked-gate.test.ts +365 -0
  70. package/src/create-node-error-domain.test.ts +127 -0
  71. package/src/create-node-network-id.test.ts +91 -0
  72. package/src/create-node-tool-schema.test.ts +59 -0
  73. package/src/create-node-unicode-name.test.ts +126 -0
  74. package/src/create-node-validate.test.ts +199 -7
  75. package/src/create-node-validate.ts +232 -15
  76. package/src/create-node-workdir.test.ts +298 -0
  77. package/src/create-node.ts +88 -23
  78. package/src/daemon-provider-snapshots.test.ts +453 -0
  79. package/src/daemon-provider-snapshots.ts +327 -0
  80. package/src/daemon-token-owner-http.test.ts +346 -0
  81. package/src/dashboard-slash-routing-http.test.ts +109 -0
  82. package/src/db-adapter-guard.test.ts +148 -0
  83. package/src/db-adapter-translate.test.ts +128 -0
  84. package/src/db-adapter.ts +377 -91
  85. package/src/db-timestamp.test.ts +38 -0
  86. package/src/db-timestamp.ts +15 -0
  87. package/src/db.ts +1334 -154
  88. package/src/delivered-without-push.test.ts +140 -0
  89. package/src/department-groups-http.test.ts +209 -0
  90. package/src/department-groups-sync-http.test.ts +328 -0
  91. package/src/department-groups.ts +434 -0
  92. package/src/department-heads-http.test.ts +350 -0
  93. package/src/department-heads.ts +226 -0
  94. package/src/departments-agent-count.test.ts +139 -0
  95. package/src/departments-http.test.ts +185 -0
  96. package/src/departments-mcp-error-domain.test.ts +135 -0
  97. package/src/departments-mcp.test.ts +128 -0
  98. package/src/departments.ts +318 -0
  99. package/src/desktop-message-seam.test.ts +150 -0
  100. package/src/desktop-message.test.ts +368 -0
  101. package/src/dm-file-scope-http.test.ts +227 -0
  102. package/src/empty-node-sweeper.test.ts +104 -0
  103. package/src/empty-node-sweeper.ts +88 -0
  104. package/src/env-transport-gate-http.test.ts +240 -0
  105. package/src/env-transport-gate.ts +80 -0
  106. package/src/env-transport-policy.ts +56 -0
  107. package/src/etag-of.test.ts +57 -0
  108. package/src/event-loop-lag.test.ts +180 -0
  109. package/src/event-loop-lag.ts +201 -0
  110. package/src/expiry-counters.test.ts +187 -0
  111. package/src/expiry-counters.ts +227 -0
  112. package/src/expiry-evidence-db.test.ts +103 -0
  113. package/src/ext-token-shared.test.ts +60 -0
  114. package/src/ext-validation-regression.test.ts +10 -17
  115. package/src/external-schedule-edits-http.test.ts +321 -0
  116. package/src/external-schedule-edits-timestamps.test.ts +64 -0
  117. package/src/external-schedule-edits.ts +327 -0
  118. package/src/file-download-authz-dev-open.test.ts +1 -1
  119. package/src/file-download-authz.test.ts +25 -4
  120. package/src/file-download-date-bucket.test.ts +1 -1
  121. package/src/file-network-scope-dev-open.test.ts +1 -1
  122. package/src/file-network-scope.test.ts +7 -6
  123. package/src/group-membership-events-http.test.ts +264 -0
  124. package/src/group-messages-http.test.ts +483 -0
  125. package/src/group-messages.ts +297 -0
  126. package/src/health-anon-readers.ts +67 -0
  127. package/src/health-host-disk-2756.test.ts +71 -0
  128. package/src/health-identity-root.test.ts +98 -0
  129. package/src/health-redaction.test.ts +1599 -7
  130. package/src/health-status-reasons.test.ts +84 -0
  131. package/src/host-supervisor-identity-http.test.ts +152 -0
  132. package/src/host-supervisor-identity.ts +92 -0
  133. package/src/host-supervisors-daemon-version.test.ts +137 -0
  134. package/src/http-gzip.test.ts +94 -0
  135. package/src/http-gzip.ts +112 -0
  136. package/src/hub-catalog-read-http.test.ts +664 -0
  137. package/src/hub-provider-config.test.ts +166 -0
  138. package/src/hub-provider-config.ts +202 -0
  139. package/src/hub-timestamp.test.ts +38 -0
  140. package/src/hub-timestamp.ts +27 -0
  141. package/src/human-dm.ts +215 -0
  142. package/src/human-inbox.ts +42 -0
  143. package/src/inbox-caller.ts +49 -0
  144. package/src/inbox-count-sse.test.ts +318 -0
  145. package/src/inbox-count.ts +29 -0
  146. package/src/index.ts +6 -2
  147. package/src/license-state.test.ts +105 -0
  148. package/src/license-state.ts +48 -0
  149. package/src/lifecycle-error-domain.test.ts +149 -0
  150. package/src/list-ack-error-domain.test.ts +108 -0
  151. package/src/list-host-supervisors.test.ts +15 -4
  152. package/src/list-tasks-omit-default.test.ts +84 -0
  153. package/src/list-tasks-since-last.test.ts +100 -0
  154. package/src/list-tasks-since.test.ts +104 -0
  155. package/src/mcp-context-cost-http.test.ts +127 -0
  156. package/src/mcp-inflight.test.ts +92 -0
  157. package/src/mcp-inflight.ts +38 -0
  158. package/src/mcp-projects-events-http.test.ts +168 -0
  159. package/src/mcp-route-label-http.test.ts +120 -0
  160. package/src/mcp-write-network-resolution.test.ts +21 -0
  161. package/src/member-audit-network-id-http.test.ts +93 -0
  162. package/src/member-presence-http.test.ts +210 -0
  163. package/src/messages-ack-by-agent-http.test.ts +142 -0
  164. package/src/migrate-sqlite-to-pg.test.ts +47 -0
  165. package/src/migrate-sqlite-to-pg.ts +263 -0
  166. package/src/model-auth-notify-http.test.ts +181 -0
  167. package/src/model-auth-notify.ts +116 -0
  168. package/src/network-name-http.test.ts +75 -0
  169. package/src/network-quota-config.test.ts +100 -0
  170. package/src/network-rules-http.test.ts +169 -0
  171. package/src/network-rules.ts +129 -0
  172. package/src/network-scope.ts +222 -3
  173. package/src/network-token-membership-http.test.ts +186 -0
  174. package/src/node-alias-control.ts +12 -0
  175. package/src/node-attrs.test.ts +47 -2
  176. package/src/node-caller-identity-http.test.ts +1108 -0
  177. package/src/node-config-last-update.test.ts +126 -0
  178. package/src/node-config-last-update.ts +107 -0
  179. package/src/node-create-request-status-http.test.ts +105 -0
  180. package/src/node-daemon-bindings.test.ts +142 -0
  181. package/src/node-daemon-bindings.ts +135 -0
  182. package/src/node-failure-alert.test.ts +150 -0
  183. package/src/node-failure-alert.ts +177 -0
  184. package/src/node-files-transport.test.ts +350 -0
  185. package/src/node-health-codex-login.test.ts +120 -0
  186. package/src/node-health-dispatch-http.test.ts +373 -0
  187. package/src/node-health-guard-origin.test.ts +98 -0
  188. package/src/node-health-guard.ts +121 -0
  189. package/src/node-health-passthrough.test.ts +115 -0
  190. package/src/node-health-store.ts +101 -0
  191. package/src/node-id-alias.test.ts +190 -0
  192. package/src/node-identity-conflict-http.test.ts +269 -0
  193. package/src/node-identity-conflict.ts +142 -0
  194. package/src/node-identity-mismatch.test.ts +74 -0
  195. package/src/node-in-flight-tasks.ts +31 -0
  196. package/src/node-lifecycle-controllable.test.ts +64 -0
  197. package/src/node-lifecycle-controllable.ts +53 -0
  198. package/src/node-lifecycle-read-http.test.ts +257 -0
  199. package/src/node-lifecycle-read.ts +126 -0
  200. package/src/node-logs-transport.test.ts +266 -0
  201. package/src/node-peer-allowlist.test.ts +114 -0
  202. package/src/node-permissions-http.test.ts +901 -0
  203. package/src/node-permissions.ts +496 -0
  204. package/src/node-request-retention.test.ts +281 -0
  205. package/src/node-request-retention.ts +120 -0
  206. package/src/node-secret-rest-http.test.ts +190 -0
  207. package/src/node-secret-vault-inject.test.ts +132 -0
  208. package/src/node-security-write-gate.test.ts +72 -0
  209. package/src/node-serviceability.test.ts +86 -0
  210. package/src/node-serviceability.ts +124 -0
  211. package/src/node-session-control-http.test.ts +398 -0
  212. package/src/node-session-control.ts +316 -0
  213. package/src/node-skills-transport.test.ts +212 -0
  214. package/src/node-token-identity.ts +35 -0
  215. package/src/node-token-ownership.ts +51 -0
  216. package/src/node-token-privilege-http.test.ts +224 -0
  217. package/src/node-token-usage.test.ts +128 -0
  218. package/src/node-token-usage.ts +228 -0
  219. package/src/not-found-api-http.test.ts +67 -0
  220. package/src/observer-avatar-http.test.ts +103 -10
  221. package/src/observer-push.test.ts +76 -0
  222. package/src/opencode-catalog-report-http.test.ts +139 -0
  223. package/src/opencode-v2-catalog.test.ts +282 -0
  224. package/src/opencode-v2-catalog.ts +357 -0
  225. package/src/package-self-contained.test.ts +32 -0
  226. package/src/package-version-consistency.test.ts +25 -0
  227. package/src/parent-infer.test.ts +82 -0
  228. package/src/parent-infer.ts +110 -0
  229. package/src/parent-source-marker.test.ts +70 -0
  230. package/src/parent-source-orphan.test.ts +121 -0
  231. package/src/password-network-tokens.ts +25 -0
  232. package/src/peer-reply-atomic.test.ts +462 -0
  233. package/src/peer-reply-capability.test.ts +70 -0
  234. package/src/pg-worker.ts +87 -0
  235. package/src/poll-pacing.test.ts +74 -0
  236. package/src/poll-pacing.ts +123 -0
  237. package/src/probe-provider-error-domain.test.ts +145 -0
  238. package/src/project-dir-warn-clear-http.test.ts +132 -0
  239. package/src/project-viewer-can-http.test.ts +116 -0
  240. package/src/provider-skill-error-domain.test.ts +130 -0
  241. package/src/provider-tools-shape.test.ts +165 -0
  242. package/src/push.test.ts +20 -10
  243. package/src/push.ts +373 -9
  244. package/src/redact-tokens.test.ts +86 -0
  245. package/src/redact-tokens.ts +43 -0
  246. package/src/rejection-counters.test.ts +72 -0
  247. package/src/rejection-counters.ts +173 -0
  248. package/src/rename.ts +38 -10
  249. package/src/reply-target-derivation.test.ts +96 -0
  250. package/src/report-status-handover-capabilities-http.test.ts +124 -0
  251. package/src/report-status-host-schema.test.ts +272 -0
  252. package/src/report-status-resume-id-handover.test.ts +184 -0
  253. package/src/report-status-secret-keys.test.ts +140 -0
  254. package/src/require-explicit-test-db.ts +9 -0
  255. package/src/requirement-due-reminders-http.test.ts +620 -0
  256. package/src/requirement-due-reminders.ts +416 -0
  257. package/src/requirement-events-http.test.ts +318 -0
  258. package/src/requirement-events.test.ts +45 -0
  259. package/src/requirement-events.ts +144 -0
  260. package/src/requirement-notify.ts +165 -0
  261. package/src/requirement-participant-notify-http.test.ts +313 -0
  262. package/src/requirement-tag-ops-http.test.ts +454 -0
  263. package/src/requirement-tag-tree-http.test.ts +275 -0
  264. package/src/requirement-tag-tree.ts +127 -0
  265. package/src/requirement-tags.ts +102 -0
  266. package/src/requirements-abandoned-http.test.ts +236 -0
  267. package/src/requirements-assignee-drift.test.ts +154 -0
  268. package/src/requirements-comment-http.test.ts +174 -0
  269. package/src/requirements-completed-at-migration.test.ts +70 -0
  270. package/src/requirements-errors-mcp-http.test.ts +164 -0
  271. package/src/requirements-errors.ts +158 -0
  272. package/src/requirements-etag-http.test.ts +91 -0
  273. package/src/requirements-http.test.ts +709 -0
  274. package/src/requirements-last-event-http.test.ts +349 -0
  275. package/src/requirements-list-mcp-slim-http.test.ts +155 -0
  276. package/src/requirements-list-slim-http.test.ts +324 -0
  277. package/src/requirements-mcp.test.ts +180 -0
  278. package/src/requirements-migrate.ts +283 -0
  279. package/src/requirements-owner-strict-mcp-http.test.ts +145 -0
  280. package/src/requirements-people-http.test.ts +114 -0
  281. package/src/requirements-people-mcp-http.test.ts +231 -0
  282. package/src/requirements-people.ts +196 -0
  283. package/src/requirements-priority-lowest.test.ts +114 -0
  284. package/src/requirements-projects-network-echo.test.ts +57 -0
  285. package/src/requirements-projects-parent-http.test.ts +123 -0
  286. package/src/requirements-search-http.test.ts +182 -0
  287. package/src/requirements-search.test.ts +32 -0
  288. package/src/requirements-search.ts +145 -0
  289. package/src/requirements-seq-http.test.ts +193 -0
  290. package/src/requirements-seq-migration.test.ts +63 -0
  291. package/src/requirements-start-date.test.ts +125 -0
  292. package/src/requirements-stats-http.test.ts +357 -0
  293. package/src/requirements-stats.ts +195 -0
  294. package/src/requirements-status-participants-http.test.ts +222 -0
  295. package/src/requirements-upgrade-e2e.test.ts +126 -0
  296. package/src/requirements-upgrade-migration.test.ts +98 -0
  297. package/src/requirements.ts +2205 -0
  298. package/src/resolve-port.test.ts +57 -0
  299. package/src/resolve-port.ts +44 -0
  300. package/src/rest-alias-network-fallback-http.test.ts +123 -0
  301. package/src/rest-alias-network-fallback.test.ts +60 -0
  302. package/src/rest-alias-network-fallback.ts +65 -0
  303. package/src/rest-explicit-columns-http.test.ts +266 -0
  304. package/src/rest-identity.test.ts +130 -0
  305. package/src/rest-identity.ts +141 -0
  306. package/src/rest-projections.ts +72 -0
  307. package/src/rest-read-network-real-chain.test.ts +97 -0
  308. package/src/rest-write-network-resolution.test.ts +133 -0
  309. package/src/restart-readiness-http.test.ts +121 -0
  310. package/src/restricted-files.ts +76 -0
  311. package/src/retention-first-sweep-quiet.test.ts +31 -0
  312. package/src/retention.test.ts +100 -40
  313. package/src/retention.ts +423 -104
  314. package/src/route-callers-http.test.ts +120 -0
  315. package/src/route-timing.test.ts +218 -0
  316. package/src/route-timing.ts +262 -0
  317. package/src/rules-file-duplicate-alias.test.ts +234 -0
  318. package/src/rules-file-session-target.test.ts +207 -0
  319. package/src/rules-file-transport.test.ts +280 -0
  320. package/src/runtime-label.test.ts +22 -0
  321. package/src/runtime-label.ts +21 -0
  322. package/src/runtime-readiness.ts +90 -0
  323. package/src/schedule-agent-mcp-http.test.ts +486 -0
  324. package/src/schedule-agent.ts +252 -0
  325. package/src/schedule-starved.test.ts +92 -0
  326. package/src/schedule-starved.ts +114 -0
  327. package/src/scheduled-backoff-http.test.ts +203 -0
  328. package/src/scheduled-backoff.ts +64 -0
  329. package/src/scheduled-doorbell-nodeless-session.test.ts +134 -0
  330. package/src/scheduled-failure-backoff-2622.test.ts +145 -0
  331. package/src/scheduled-failure-code.test.ts +73 -0
  332. package/src/scheduled-failure-code.ts +105 -0
  333. package/src/scheduled-failures-http.test.ts +279 -0
  334. package/src/scheduled-failures.ts +425 -0
  335. package/src/scheduled-noprogress-backoff-2622.test.ts +163 -0
  336. package/src/scheduled-offline-backoff-probe.test.ts +56 -0
  337. package/src/scheduled-offline.test.ts +131 -0
  338. package/src/scheduled-offline.ts +66 -0
  339. package/src/scheduled-outcome-guidance-http.test.ts +139 -0
  340. package/src/scheduled-outcome-guidance.ts +9 -0
  341. package/src/scheduled-reply-unread-http.test.ts +212 -0
  342. package/src/scheduled-requirement-wake-http.test.ts +289 -0
  343. package/src/scheduled-requirement-wake.ts +125 -0
  344. package/src/scheduled-run-terminal.test.ts +290 -0
  345. package/src/scheduled-skip-blocking-task.test.ts +120 -0
  346. package/src/scheduled-skip-path-backoff-2622.test.ts +98 -0
  347. package/src/scheduled-stuck-http.test.ts +316 -0
  348. package/src/scheduled-stuck-notice-cap.test.ts +80 -0
  349. package/src/scheduled-stuck.ts +219 -0
  350. package/src/scheduled-tasks-http.test.ts +679 -0
  351. package/src/scheduled-tasks.ts +964 -0
  352. package/src/scheduled-work-outcome-http.test.ts +154 -0
  353. package/src/scheduled-work-outcome.ts +50 -0
  354. package/src/scoped-secrets.ts +167 -0
  355. package/src/secret-echo-negative-control.test.ts +118 -0
  356. package/src/send-dedup-request-id.test.ts +229 -0
  357. package/src/send-reply-agent-warning.test.ts +38 -38
  358. package/src/send-reply-alias-optional.test.ts +131 -0
  359. package/src/send-reply-attachments.test.ts +28 -7
  360. package/src/send_dedup.test.ts +54 -0
  361. package/src/send_dedup.ts +52 -6
  362. package/src/serve-error.test.ts +73 -0
  363. package/src/serve-error.ts +56 -0
  364. package/src/server.ts +5033 -377
  365. package/src/session-fork-store.test.ts +43 -0
  366. package/src/session-fork-store.ts +51 -0
  367. package/src/session-project-attach-migration.test.ts +22 -0
  368. package/src/session-project-attach-native.test.ts +121 -0
  369. package/src/session-project-create-http.test.ts +407 -0
  370. package/src/session-project-create-native.test.ts +290 -0
  371. package/src/session-project-create.ts +159 -0
  372. package/src/session-source-admission-store.ts +58 -0
  373. package/src/session-source-create.test.ts +155 -0
  374. package/src/session-source-create.ts +97 -0
  375. package/src/session-source-delivery.ts +109 -0
  376. package/src/session-source-directory-http.test.ts +192 -0
  377. package/src/session-source-evidence.test.ts +898 -0
  378. package/src/session-source-evidence.ts +191 -0
  379. package/src/session-source-execution.ts +87 -0
  380. package/src/session-source-grant.test.ts +117 -0
  381. package/src/session-source-grant.ts +78 -0
  382. package/src/session-source-issuer.test.ts +250 -0
  383. package/src/session-source-issuer.ts +164 -0
  384. package/src/session-source-transport.ts +375 -0
  385. package/src/session-task-on-dispatch.ts +14 -0
  386. package/src/session-token-ownership-http.test.ts +122 -0
  387. package/src/shared/codex-inventory.ts +41 -0
  388. package/src/shared/daemon-provider-login.ts +31 -0
  389. package/src/shared/daemon-provider-snapshot.ts +52 -0
  390. package/src/shared/external-schedule-contract.ts +60 -0
  391. package/src/shared/node-name.test.ts +62 -0
  392. package/src/shared/node-name.ts +161 -0
  393. package/src/shared/probe-host-allowlist-drift.test.ts +45 -0
  394. package/src/shared/provider-application.ts +29 -0
  395. package/src/shared/provider-collection.ts +14 -0
  396. package/src/shared/provider-initialization.ts +8 -0
  397. package/src/shared/reserved-env-drift.test.ts +10 -0
  398. package/src/shared/scoped-secret-contract.ts +5 -0
  399. package/src/shared/task-content-limit-drift.test.ts +28 -0
  400. package/src/shared/task-content-limit.ts +25 -0
  401. package/src/side-thread-command-transport.test.ts +312 -0
  402. package/src/side-thread-command-transport.ts +318 -0
  403. package/src/side-thread-http-integration.test.ts +233 -0
  404. package/src/side-thread-http.ts +504 -0
  405. package/src/side-thread-production.test.ts +72 -0
  406. package/src/side-thread-production.ts +118 -0
  407. package/src/side-thread.test.ts +1067 -0
  408. package/src/side-thread.ts +2499 -0
  409. package/src/skillhub-http.test.ts +144 -0
  410. package/src/sqlite-close-checkpoint.test.ts +78 -0
  411. package/src/start-node.test.ts +265 -0
  412. package/src/start-request-error-domain.test.ts +182 -0
  413. package/src/start-skill-error-domain.test.ts +122 -0
  414. package/src/stats-versions-http.test.ts +65 -0
  415. package/src/status-alias-filter-http.test.ts +106 -0
  416. package/src/status-alias-resolver-http.test.ts +163 -0
  417. package/src/status-alias-resolver.ts +19 -0
  418. package/src/status-node-id-filter-http.test.ts +161 -0
  419. package/src/status-node-secrets-capable-http.test.ts +44 -0
  420. package/src/status-read-cache-http.test.ts +229 -0
  421. package/src/status-read-cache.ts +129 -0
  422. package/src/stop-delete-node.test.ts +567 -1
  423. package/src/task-access-http.test.ts +407 -0
  424. package/src/task-access.ts +420 -0
  425. package/src/task-activity.ts +60 -0
  426. package/src/task-auth-origin-http.test.ts +93 -0
  427. package/src/task-auth-origin.test.ts +24 -0
  428. package/src/task-auth-origin.ts +7 -0
  429. package/src/task-consumption.test.ts +512 -0
  430. package/src/task-diagnostic-http.test.ts +149 -0
  431. package/src/task-diagnostic.test.ts +115 -0
  432. package/src/task-diagnostic.ts +118 -0
  433. package/src/task-expiry-notice-http.test.ts +298 -0
  434. package/src/task-expiry-notice.ts +318 -0
  435. package/src/task-idempotency-mcp.test.ts +148 -0
  436. package/src/task-idempotency.test.ts +76 -0
  437. package/src/task-idempotency.ts +81 -0
  438. package/src/task-late-replies.ts +54 -0
  439. package/src/task-late-reply-http.test.ts +227 -0
  440. package/src/task-lifecycle-watcher-busy.test.ts +114 -0
  441. package/src/task-lifecycle-watcher.test.ts +209 -0
  442. package/src/task-lifecycle-watcher.ts +109 -0
  443. package/src/task-network-resolution-http.test.ts +140 -0
  444. package/src/task-not-found-error-domain.test.ts +117 -0
  445. package/src/task-offline-delivery-2668.test.ts +119 -0
  446. package/src/task-offline-delivery.ts +81 -0
  447. package/src/task-orphan-http.test.ts +287 -0
  448. package/src/task-orphan.ts +119 -0
  449. package/src/task-queue-ahead-http.test.ts +309 -0
  450. package/src/task-queue-ahead-scale.test.ts +236 -0
  451. package/src/task-queue-ahead.ts +186 -0
  452. package/src/task-rejection-log-http.test.ts +160 -0
  453. package/src/task-rejection-log.ts +61 -0
  454. package/src/task-sender-http.test.ts +143 -0
  455. package/src/task-stale-open-http.test.ts +292 -0
  456. package/src/task-stale-open.ts +103 -0
  457. package/src/tasks-pagination-http.test.ts +141 -0
  458. package/src/team-rules-status-http.test.ts +90 -0
  459. package/src/team-rules-status.test.ts +59 -0
  460. package/src/team-rules-status.ts +72 -0
  461. package/src/tmux-allowlist.test.ts +48 -0
  462. package/src/token-usage-http.test.ts +156 -0
  463. package/src/tool-audience-http.test.ts +266 -0
  464. package/src/tool-audience.ts +130 -0
  465. package/src/tools-list-json-schema.test.ts +94 -0
  466. package/src/tools.ts +4530 -471
  467. package/src/update-node-config-error-domain.test.ts +107 -0
  468. package/src/uploads-http.test.ts +6 -4
  469. package/src/uploads.ts +23 -4
  470. package/src/user-avatar-http.test.ts +74 -0
  471. package/src/user-avatar-image.ts +160 -0
  472. package/src/user-avatar-migration.test.ts +25 -0
  473. package/src/user-avatar-upload-http.test.ts +353 -0
  474. package/src/user-inbox-by-agent-http.test.ts +189 -0
  475. package/src/user-inbox-netid-notnull.test.ts +122 -0
  476. package/src/user-inbox-read-http.test.ts +223 -0
  477. package/src/user-inbox-schema.test.ts +54 -0
  478. package/src/version-stats.test.ts +66 -0
  479. package/src/version-stats.ts +109 -0
@@ -0,0 +1,585 @@
1
+ // 多用户账号与 Agent 权限 —— 「这个人在这个网络里能看见 / 能联系哪些 Agent」的唯一实现。
2
+ //
3
+ // 受限成员(restricted member):网络里 role 为 member/viewer、agent_access 不是 'all'、
4
+ // 且不是 Hub 管理员的用户。他只能看见 network_member_agent_grants 里授权给他的 Agent,
5
+ // 只能给其中 can_message=1 的发任务/消息;人类之间的私信不受影响。
6
+ //
7
+ // 判定是 fail-closed 的:agent_access 只有字面 'all' 才放开;role 只有 owner/admin 才豁免。
8
+ // 读到任何别的值(包括未来新增的角色)都按受限处理。
9
+ //
10
+ // 这里只回答「能不能」,不管「是不是成员」——非成员返回 false(不受限),
11
+ // 成员资格仍由调用方原有的 getUserNetworkRole 判定。两件事分开,别合并成一个判据。
12
+
13
+ import { db } from "./db.js";
14
+ import { departmentSubtree } from "./department-heads.js";
15
+
16
+ const UNRESTRICTED_ROLES = new Set(["owner", "admin"]);
17
+
18
+ export type AgentAccessMode = "all" | "granted";
19
+
20
+ export type AgentGrant = {
21
+ node_id: string | null;
22
+ alias: string | null;
23
+ can_message: boolean;
24
+ };
25
+
26
+ /** 某受限成员在某网络里能看见 / 能联系的 Agent,已经展开成 alias 与 node_id 两份清单。 */
27
+ export type VisibleAgents = {
28
+ aliases: string[];
29
+ nodeIds: string[];
30
+ messageAliases: string[];
31
+ messageNodeIds: string[];
32
+ };
33
+
34
+ export function isHubAdmin(userId: string): boolean {
35
+ return db.get<{ role: string | null }>("SELECT role FROM users WHERE user_id = ?1", userId)?.role === "admin";
36
+ }
37
+
38
+ function restrictedRow(row: { member_role: string | null; agent_access: string | null; user_role: string | null } | null | undefined): boolean {
39
+ if (!row) return false;
40
+ if (row.user_role === "admin") return false;
41
+ if (UNRESTRICTED_ROLES.has(String(row.member_role))) return false;
42
+ return row.agent_access !== "all";
43
+ }
44
+
45
+ export function isAgentRestricted(userId: string, networkId: string | null | undefined): boolean {
46
+ if (!userId || !networkId) return false;
47
+ const row = db.get<{ member_role: string | null; agent_access: string | null; user_role: string | null }>(
48
+ `SELECT nm.role AS member_role, nm.agent_access, u.role AS user_role
49
+ FROM network_members nm JOIN users u ON u.user_id = nm.user_id
50
+ WHERE nm.network_id = ?1 AND nm.user_id = ?2`,
51
+ networkId, userId,
52
+ );
53
+ return restrictedRow(row);
54
+ }
55
+
56
+ /** 该用户所有「只看授权 Agent」的网络。Hub 管理员恒为空。 */
57
+ export function restrictedNetworkIds(userId: string): string[] {
58
+ if (!userId) return [];
59
+ return db.all<{ network_id: string; member_role: string | null; agent_access: string | null; user_role: string | null }>(
60
+ `SELECT nm.network_id, nm.role AS member_role, nm.agent_access, u.role AS user_role
61
+ FROM network_members nm
62
+ JOIN users u ON u.user_id = nm.user_id
63
+ JOIN networks n ON n.network_id = nm.network_id
64
+ WHERE nm.user_id = ?1`,
65
+ userId,
66
+ ).filter(restrictedRow).map((row) => row.network_id);
67
+ }
68
+
69
+ export function getAgentAccessMode(networkId: string, userId: string): AgentAccessMode | null {
70
+ const row = db.get<{ agent_access: string | null }>(
71
+ "SELECT agent_access FROM network_members WHERE network_id = ?1 AND user_id = ?2",
72
+ networkId, userId,
73
+ );
74
+ if (!row) return null;
75
+ return row.agent_access === "all" ? "all" : "granted";
76
+ }
77
+
78
+ export function listAgentGrants(networkId: string, userId: string): AgentGrant[] {
79
+ return db.all<{ node_id: string | null; alias: string | null; can_message: number }>(
80
+ `SELECT node_id, alias, can_message FROM network_member_agent_grants
81
+ WHERE network_id = ?1 AND user_id = ?2
82
+ ORDER BY COALESCE(node_id, alias)`,
83
+ networkId, userId,
84
+ ).map((row) => ({ node_id: row.node_id, alias: row.alias, can_message: row.can_message === 1 }));
85
+ }
86
+
87
+ /**
88
+ * 把授权展开成 alias / node_id 两份清单。
89
+ * node_id 授权同时带出:nodes 表里这个节点的 alias、sessions 表里同 node_id 的会话 alias
90
+ * (改名后 sessions 先于 nodes 更新的窗口里两者可能不同,两个都算)。都限定在同一网络。
91
+ */
92
+ /** visibleAgents 一次查询里最多放多少个节点 id(绑定参数上限;1000 个授权节点 = 2 次查询)。 */
93
+ export const VISIBLE_AGENTS_CHUNK = 500;
94
+
95
+ export function visibleAgents(userId: string, networkId: string): VisibleAgents {
96
+ const aliases = new Set<string>();
97
+ const nodeIds = new Set<string>();
98
+ const messageAliases = new Set<string>();
99
+ const messageNodeIds = new Set<string>();
100
+ // RFC-038 §8:组授权展开成「该组此刻的成员节点」—— 每次现算,组里新加的节点下一次请求就可见。
101
+ // 只并同网络、且 nodes 表里还在的节点;可对话取并集(直接授权或任一组给了就算)。
102
+ const grants: AgentGrant[] = [...listAgentGrants(networkId, userId), ...groupGrantNodes(networkId, userId), ...departmentGrantNodes(networkId, userId)];
103
+ // #2133:所有授权节点的 alias 一次查完(原来每个节点单独查一次 nodes ∪ sessions:300 条授权 ≈ 300 次查询,
104
+ // 而受限成员的每次 /api/status 轮询都走这里)。结果与原实现逐字一致:授权按上面数组的顺序,
105
+ // 同一节点内的 alias 按 UNION 的去重升序 —— agent-access-batch.test.ts 在随机夹具上逐字比对。
106
+ // 分块只为绑定参数个数的上限;同一节点的所有 alias 必在同一块里,顺序不受分块影响。
107
+ const grantedNodeIds = [...new Set(grants.map((grant) => grant.node_id).filter((id): id is string => !!id))];
108
+ const aliasesByNode = new Map<string, string[]>();
109
+ for (let start = 0; start < grantedNodeIds.length; start += VISIBLE_AGENTS_CHUNK) {
110
+ const chunk = grantedNodeIds.slice(start, start + VISIBLE_AGENTS_CHUNK);
111
+ const inList = chunk.map((_, i) => `?${i + 2}`).join(", ");
112
+ for (const row of db.all<{ node_id: string; alias: string | null }>(
113
+ `SELECT node_id, alias FROM nodes WHERE network_id = ?1 AND node_id IN (${inList})
114
+ UNION SELECT node_id, alias FROM sessions WHERE network_id = ?1 AND node_id IN (${inList})
115
+ ORDER BY node_id, alias`,
116
+ networkId, ...chunk,
117
+ )) {
118
+ if (!row.alias) continue;
119
+ const list = aliasesByNode.get(row.node_id);
120
+ if (list) list.push(row.alias); else aliasesByNode.set(row.node_id, [row.alias]);
121
+ }
122
+ }
123
+ for (const grant of grants) {
124
+ let grantAliases: readonly string[] = [];
125
+ if (grant.node_id) {
126
+ nodeIds.add(grant.node_id);
127
+ if (grant.can_message) messageNodeIds.add(grant.node_id);
128
+ grantAliases = aliasesByNode.get(grant.node_id) ?? [];
129
+ } else if (grant.alias) {
130
+ grantAliases = [grant.alias];
131
+ }
132
+ for (const alias of grantAliases) {
133
+ aliases.add(alias);
134
+ if (grant.can_message) messageAliases.add(alias);
135
+ }
136
+ }
137
+ return {
138
+ aliases: [...aliases],
139
+ nodeIds: [...nodeIds],
140
+ messageAliases: [...messageAliases],
141
+ messageNodeIds: [...messageNodeIds],
142
+ };
143
+ }
144
+
145
+ // ══════════════ Agent 分组(RFC-038 §8) ══════════════
146
+
147
+ export type AgentGroupGrant = { group_id: string; name: string; can_message: boolean };
148
+ export type AgentGroup = { group_id: string; network_id: string; name: string; description: string | null; node_ids: string[]; member_count: number; granted_user_count: number; created_at: string; updated_at: string | null };
149
+
150
+ /** 该成员被授权的组,展开成节点级授权(只取同网络、仍存在的节点)。 */
151
+ function groupGrantNodes(networkId: string, userId: string): AgentGrant[] {
152
+ return db.all<{ node_id: string; can_message: number }>(
153
+ `SELECT m.node_id, g.can_message
154
+ FROM network_member_group_grants g
155
+ JOIN agent_groups ag ON ag.group_id = g.group_id AND ag.network_id = g.network_id
156
+ JOIN agent_group_members m ON m.group_id = g.group_id
157
+ JOIN nodes n ON n.node_id = m.node_id AND n.network_id = g.network_id
158
+ WHERE g.network_id = ?1 AND g.user_id = ?2`,
159
+ networkId, userId,
160
+ ).map((row) => ({ node_id: row.node_id, alias: null, can_message: row.can_message === 1 }));
161
+ }
162
+
163
+ export function listGroupGrants(networkId: string, userId: string): AgentGroupGrant[] {
164
+ return db.all<{ group_id: string; name: string; can_message: number }>(
165
+ `SELECT g.group_id, ag.name, g.can_message
166
+ FROM network_member_group_grants g JOIN agent_groups ag ON ag.group_id = g.group_id
167
+ WHERE g.network_id = ?1 AND g.user_id = ?2 ORDER BY ag.name`,
168
+ networkId, userId,
169
+ ).map((row) => ({ group_id: row.group_id, name: row.name, can_message: row.can_message === 1 }));
170
+ }
171
+
172
+ // ══════════════ 部门维度授权(admin 2026-11-05) ══════════════
173
+ //
174
+ // 用户问的是「给某个用户授权,让他看到**某个组织架构下**的所有节点」。
175
+ // Agent 组授权(RFC-038 §8)回答的是 Agent 侧的树;人的组织架构是另一条轴
176
+ // (network_departments + nodes.department_id),此前**没有**这一档。
177
+ //
178
+ // 语义与组授权完全同构,只有展开源不同:
179
+ // 组 ⇒ agent_group_members
180
+ // 部门 ⇒ departmentSubtree(dept) 里的所有部门 → nodes.department_id ∈ 该集合
181
+ // 同样是**每次现算**:部门里新挂的节点,下一次请求就可见,不需要重新授权。
182
+ //
183
+ // 已知边界(必须让调用方看见,否则会静默少人):
184
+ // 没有填 department_id 的节点**永远**不会因为部门授权而可见。
185
+ // ⇒ 接口把它作为 `coverage` 一起返回,而不是让人以为「授权了就应该全看见」。
186
+
187
+ export type DepartmentGrant = { department_id: string; name: string; can_message: boolean };
188
+
189
+ export function departmentGrantNodes(networkId: string, userId: string): AgentGrant[] {
190
+ const rows = db.all<{ department_id: string; can_message: number }>(
191
+ "SELECT department_id, can_message FROM network_member_department_grants WHERE network_id = ?1 AND user_id = ?2",
192
+ networkId, userId,
193
+ );
194
+ if (rows.length === 0) return [];
195
+ const canMessage = new Map<string, boolean>();
196
+ for (const row of rows) {
197
+ for (const deptId of departmentSubtree(networkId, row.department_id)) {
198
+ // 任一授权允许对话即允许(与组授权「取并集」一致)。
199
+ canMessage.set(deptId, (canMessage.get(deptId) ?? false) || row.can_message === 1);
200
+ }
201
+ }
202
+ if (canMessage.size === 0) return [];
203
+ const deptIds = [...canMessage.keys()];
204
+ const inList = deptIds.map((_, i) => `?${i + 2}`).join(", ");
205
+ return db.all<{ node_id: string; department_id: string }>(
206
+ `SELECT node_id, department_id FROM nodes WHERE network_id = ?1 AND department_id IN (${inList}) ORDER BY node_id`,
207
+ networkId, ...deptIds,
208
+ ).map((row) => ({ node_id: row.node_id, alias: null, can_message: canMessage.get(row.department_id) === true }));
209
+ }
210
+
211
+ export function listDepartmentGrants(networkId: string, userId: string): DepartmentGrant[] {
212
+ return db.all<{ department_id: string; name: string | null; can_message: number }>(
213
+ `SELECT g.department_id, d.name, g.can_message
214
+ FROM network_member_department_grants g
215
+ LEFT JOIN network_departments d ON d.department_id = g.department_id AND d.network_id = g.network_id
216
+ WHERE g.network_id = ?1 AND g.user_id = ?2 ORDER BY d.name, g.department_id`,
217
+ networkId, userId,
218
+ ).map((row) => ({ department_id: row.department_id, name: row.name ?? row.department_id, can_message: row.can_message === 1 }));
219
+ }
220
+
221
+ /** 覆盖率:网络里有多少节点填了部门、有多少没填(没填的永远不可能被部门授权覆盖)。 */
222
+ export function departmentCoverage(networkId: string): { nodes_total: number; nodes_with_department: number; nodes_without_department: number } {
223
+ const row = db.get<{ total: number; with_dept: number }>(
224
+ `SELECT COUNT(*) AS total,
225
+ SUM(CASE WHEN department_id IS NOT NULL AND department_id <> '' THEN 1 ELSE 0 END) AS with_dept
226
+ FROM nodes WHERE network_id = ?1`,
227
+ networkId,
228
+ );
229
+ const total = row?.total ?? 0;
230
+ const withDept = row?.with_dept ?? 0;
231
+ return { nodes_total: total, nodes_with_department: withDept, nodes_without_department: total - withDept };
232
+ }
233
+
234
+ export function listAgentGroups(networkId: string): AgentGroup[] {
235
+ const groups = db.all<{ group_id: string; network_id: string; name: string; description: string | null; created_at: string; updated_at: string | null }>(
236
+ "SELECT group_id, network_id, name, description, created_at, updated_at FROM agent_groups WHERE network_id = ?1 ORDER BY name",
237
+ networkId,
238
+ );
239
+ return groups.map((g) => {
240
+ const nodeIds = db.all<{ node_id: string }>(
241
+ `SELECT m.node_id FROM agent_group_members m JOIN nodes n ON n.node_id = m.node_id AND n.network_id = ?2
242
+ WHERE m.group_id = ?1 ORDER BY m.node_id`,
243
+ g.group_id, networkId,
244
+ ).map((row) => row.node_id);
245
+ const granted = db.get<{ c: number }>("SELECT COUNT(*) AS c FROM network_member_group_grants WHERE group_id = ?1", g.group_id)?.c ?? 0;
246
+ return { ...g, node_ids: nodeIds, member_count: nodeIds.length, granted_user_count: granted };
247
+ });
248
+ }
249
+
250
+ export function getAgentGroup(networkId: string, groupId: string): AgentGroup | null {
251
+ return listAgentGroups(networkId).find((g) => g.group_id === groupId) ?? null;
252
+ }
253
+
254
+ /** 这个组上有授权的成员(组变化时要断开他们的实时流,让其按新权限重连)。 */
255
+ export function usersGrantedGroup(groupId: string): string[] {
256
+ return db.all<{ user_id: string }>("SELECT user_id FROM network_member_group_grants WHERE group_id = ?1", groupId).map((r) => r.user_id);
257
+ }
258
+
259
+ const MAX_GROUP_NAME = 64;
260
+ const MAX_GROUP_MEMBERS = 1000;
261
+
262
+ export type GroupResult = { ok: true; group: AgentGroup } | { ok: false; error: string; status: number; detail?: unknown };
263
+
264
+ function normalizeName(raw: unknown): string | null {
265
+ if (typeof raw !== "string") return null;
266
+ const name = raw.trim();
267
+ if (!name || name.length > MAX_GROUP_NAME) return null;
268
+ return name;
269
+ }
270
+
271
+ /** node_ids 必须都是本网络里存在的节点;任何一个不合格 ⇒ 整批拒绝。去重。 */
272
+ function validateNodeIds(networkId: string, raw: unknown): { ok: true; ids: string[] } | { ok: false; error: string; status: number; detail?: unknown } {
273
+ if (!Array.isArray(raw)) return { ok: false, error: "node_ids_must_be_array", status: 400 };
274
+ if (raw.length > MAX_GROUP_MEMBERS) return { ok: false, error: "too_many_members", status: 400, detail: { limit: MAX_GROUP_MEMBERS } };
275
+ const ids: string[] = [];
276
+ const seen = new Set<string>();
277
+ for (const [index, item] of raw.entries()) {
278
+ const id = typeof item === "string" ? item.trim() : "";
279
+ if (!id) return { ok: false, error: "invalid_node_id", status: 400, detail: { index } };
280
+ if (!db.get("SELECT 1 FROM nodes WHERE node_id = ?1 AND network_id = ?2", id, networkId)) {
281
+ return { ok: false, error: "agent_not_in_network", status: 400, detail: { index, node_id: id } };
282
+ }
283
+ if (!seen.has(id)) { seen.add(id); ids.push(id); }
284
+ }
285
+ return { ok: true, ids };
286
+ }
287
+
288
+ export function createAgentGroup(input: { networkId: string; name: unknown; description?: unknown; nodeIds?: unknown; actorUserId: string }): GroupResult {
289
+ const name = normalizeName(input.name);
290
+ if (!name) return { ok: false, error: "invalid_group_name", status: 400, detail: { max_length: MAX_GROUP_NAME } };
291
+ if (db.get("SELECT 1 FROM agent_groups WHERE network_id = ?1 AND name = ?2", input.networkId, name)) {
292
+ return { ok: false, error: "group_name_taken", status: 409 };
293
+ }
294
+ let ids: string[] = [];
295
+ if (input.nodeIds !== undefined) {
296
+ const v = validateNodeIds(input.networkId, input.nodeIds);
297
+ if (!v.ok) return v;
298
+ ids = v.ids;
299
+ }
300
+ const description = typeof input.description === "string" ? input.description.trim().slice(0, 500) || null : null;
301
+ const groupId = `agrp_${crypto.randomUUID().replace(/-/g, "")}`;
302
+ db.transaction(() => {
303
+ db.run("INSERT INTO agent_groups (group_id, network_id, name, description, created_by) VALUES (?1, ?2, ?3, ?4, ?5)",
304
+ [groupId, input.networkId, name, description, input.actorUserId]);
305
+ for (const id of ids) db.run("INSERT INTO agent_group_members (group_id, node_id, added_by) VALUES (?1, ?2, ?3)", [groupId, id, input.actorUserId]);
306
+ });
307
+ return { ok: true, group: getAgentGroup(input.networkId, groupId)! };
308
+ }
309
+
310
+ export function updateAgentGroup(input: { networkId: string; groupId: string; name?: unknown; description?: unknown }): GroupResult {
311
+ if (!db.get("SELECT 1 FROM agent_groups WHERE group_id = ?1 AND network_id = ?2", input.groupId, input.networkId)) {
312
+ return { ok: false, error: "group_not_found", status: 404 };
313
+ }
314
+ if (input.name !== undefined) {
315
+ const name = normalizeName(input.name);
316
+ if (!name) return { ok: false, error: "invalid_group_name", status: 400, detail: { max_length: MAX_GROUP_NAME } };
317
+ if (db.get("SELECT 1 FROM agent_groups WHERE network_id = ?1 AND name = ?2 AND group_id != ?3", input.networkId, name, input.groupId)) {
318
+ return { ok: false, error: "group_name_taken", status: 409 };
319
+ }
320
+ db.run("UPDATE agent_groups SET name = ?1, updated_at = datetime('now') WHERE group_id = ?2", [name, input.groupId]);
321
+ }
322
+ if (input.description !== undefined) {
323
+ const description = typeof input.description === "string" ? input.description.trim().slice(0, 500) || null : null;
324
+ db.run("UPDATE agent_groups SET description = ?1, updated_at = datetime('now') WHERE group_id = ?2", [description, input.groupId]);
325
+ }
326
+ return { ok: true, group: getAgentGroup(input.networkId, input.groupId)! };
327
+ }
328
+
329
+ /** 整体替换组成员;返回增删 diff(审计只记 diff)。 */
330
+ export function replaceAgentGroupMembers(input: { networkId: string; groupId: string; nodeIds: unknown; actorUserId: string }):
331
+ { ok: true; group: AgentGroup; added: string[]; removed: string[] } | { ok: false; error: string; status: number; detail?: unknown } {
332
+ if (!db.get("SELECT 1 FROM agent_groups WHERE group_id = ?1 AND network_id = ?2", input.groupId, input.networkId)) {
333
+ return { ok: false, error: "group_not_found", status: 404 };
334
+ }
335
+ const v = validateNodeIds(input.networkId, input.nodeIds);
336
+ if (!v.ok) return v;
337
+ const before = new Set(db.all<{ node_id: string }>("SELECT node_id FROM agent_group_members WHERE group_id = ?1", input.groupId).map((r) => r.node_id));
338
+ const after = new Set(v.ids);
339
+ const added = v.ids.filter((id) => !before.has(id));
340
+ const removed = [...before].filter((id) => !after.has(id));
341
+ db.transaction(() => {
342
+ for (const id of removed) db.run("DELETE FROM agent_group_members WHERE group_id = ?1 AND node_id = ?2", [input.groupId, id]);
343
+ for (const id of added) db.run("INSERT INTO agent_group_members (group_id, node_id, added_by) VALUES (?1, ?2, ?3)", [input.groupId, id, input.actorUserId]);
344
+ db.run("UPDATE agent_groups SET updated_at = datetime('now') WHERE group_id = ?1", [input.groupId]);
345
+ });
346
+ return { ok: true, group: getAgentGroup(input.networkId, input.groupId)!, added, removed };
347
+ }
348
+
349
+ /** 删组:连同组成员与组上的全部授权。返回受影响的成员(调用方断开其实时流、写审计)。 */
350
+ export function deleteAgentGroup(networkId: string, groupId: string): { ok: true; affected_user_ids: string[] } | { ok: false; error: string; status: number } {
351
+ if (!db.get("SELECT 1 FROM agent_groups WHERE group_id = ?1 AND network_id = ?2", groupId, networkId)) {
352
+ return { ok: false, error: "group_not_found", status: 404 };
353
+ }
354
+ const affected = usersGrantedGroup(groupId);
355
+ db.transaction(() => {
356
+ db.run("DELETE FROM network_member_group_grants WHERE group_id = ?1", [groupId]);
357
+ db.run("DELETE FROM agent_group_members WHERE group_id = ?1", [groupId]);
358
+ db.run("DELETE FROM agent_groups WHERE group_id = ?1", [groupId]);
359
+ });
360
+ return { ok: true, affected_user_ids: affected };
361
+ }
362
+
363
+ /** 这个用户名在该网络里是否同时是某个 Agent 的 alias(sessions 或 nodes)。 */
364
+ export function usernameIsAgentAlias(networkId: string, username: string): boolean {
365
+ if (!username) return false;
366
+ return !!db.get(
367
+ `SELECT 1 WHERE EXISTS (SELECT 1 FROM sessions WHERE network_id = ?1 AND alias = ?2)
368
+ OR EXISTS (SELECT 1 FROM nodes WHERE network_id = ?1 AND alias = ?2)`,
369
+ networkId, username,
370
+ );
371
+ }
372
+
373
+ export type AgentRef = { alias?: string | null; nodeId?: string | null };
374
+
375
+ function refMatches(ref: AgentRef, aliases: string[], nodeIds: string[]): boolean {
376
+ if (ref.nodeId && nodeIds.includes(ref.nodeId)) return true;
377
+ if (ref.alias && aliases.includes(ref.alias)) return true;
378
+ return false;
379
+ }
380
+
381
+ /** 不受限的成员恒为 true;受限成员只对授权的 Agent 为 true。不判断成员资格。 */
382
+ export function canSeeAgent(userId: string, networkId: string | null | undefined, ref: AgentRef): boolean {
383
+ if (!networkId || !isAgentRestricted(userId, networkId)) return true;
384
+ const visible = visibleAgents(userId, networkId);
385
+ return refMatches(ref, visible.aliases, visible.nodeIds);
386
+ }
387
+
388
+ export function canMessageAgent(userId: string, networkId: string | null | undefined, ref: AgentRef): boolean {
389
+ if (!networkId || !isAgentRestricted(userId, networkId)) return true;
390
+ const visible = visibleAgents(userId, networkId);
391
+ return refMatches(ref, visible.messageAliases, visible.messageNodeIds);
392
+ }
393
+
394
+ export type AgentGrantInput = { node_id?: unknown; alias?: unknown; can_message?: unknown };
395
+
396
+ export type ReplaceGrantsResult =
397
+ | { ok: true; agent_access: AgentAccessMode; grants: AgentGrant[]; group_grants: AgentGroupGrant[]; department_grants: DepartmentGrant[] }
398
+ | { ok: false; error: string; status: number; detail?: unknown };
399
+
400
+ const MAX_GRANTS = 1000;
401
+
402
+ /**
403
+ * 整体替换某成员的授权(PUT 语义)。node_id 必须是本网络里存在的节点;alias 只用于没有
404
+ * node_id 的旧会话,也必须是本网络里存在的会话。任何一条不合法 ⇒ 整批拒绝,不做部分写入。
405
+ */
406
+ export function replaceAgentGrants(input: {
407
+ networkId: string;
408
+ userId: string;
409
+ grants: unknown;
410
+ agentAccess?: unknown;
411
+ /** RFC-038 §8:组授权。undefined = 保持原样(旧 app 的 PUT 不带它,不能把组授权清掉)。 */
412
+ groupGrants?: unknown;
413
+ /** 部门维度授权。undefined = 保持原样(旧客户端的 PUT 不带它,不能把部门授权清掉)。 */
414
+ departmentGrants?: unknown;
415
+ actorUserId: string;
416
+ }): ReplaceGrantsResult {
417
+ const member = db.get<{ role: string }>(
418
+ "SELECT role FROM network_members WHERE network_id = ?1 AND user_id = ?2",
419
+ input.networkId, input.userId,
420
+ );
421
+ if (!member) return { ok: false, error: "member_not_found", status: 404 };
422
+
423
+ let mode: AgentAccessMode | undefined;
424
+ if (input.agentAccess !== undefined) {
425
+ if (input.agentAccess !== "all" && input.agentAccess !== "granted") {
426
+ return { ok: false, error: "invalid_agent_access", status: 400 };
427
+ }
428
+ mode = input.agentAccess;
429
+ }
430
+
431
+ let rows: Array<{ node_id: string | null; alias: string | null; can_message: number }> | undefined;
432
+ if (input.grants !== undefined) {
433
+ if (!Array.isArray(input.grants)) return { ok: false, error: "grants_must_be_array", status: 400 };
434
+ if (input.grants.length > MAX_GRANTS) return { ok: false, error: "too_many_grants", status: 400, detail: { limit: MAX_GRANTS } };
435
+ const seen = new Set<string>();
436
+ rows = [];
437
+ for (const [index, raw] of input.grants.entries()) {
438
+ // 兼容直接传 node_id 字符串数组。
439
+ const item: AgentGrantInput = typeof raw === "string" ? { node_id: raw } : (raw && typeof raw === "object" && !Array.isArray(raw) ? raw as AgentGrantInput : {});
440
+ const nodeId = typeof item.node_id === "string" && item.node_id.trim() ? item.node_id.trim() : null;
441
+ const alias = typeof item.alias === "string" && item.alias.trim() ? item.alias.trim() : null;
442
+ if ((nodeId === null) === (alias === null)) {
443
+ return { ok: false, error: "grant_needs_exactly_one_of_node_id_or_alias", status: 400, detail: { index } };
444
+ }
445
+ if (item.can_message !== undefined && typeof item.can_message !== "boolean") {
446
+ return { ok: false, error: "can_message_must_be_boolean", status: 400, detail: { index } };
447
+ }
448
+ const exists = nodeId
449
+ ? db.get("SELECT 1 FROM nodes WHERE node_id = ?1 AND network_id = ?2", nodeId, input.networkId)
450
+ : db.get("SELECT 1 FROM sessions WHERE alias = ?1 AND network_id = ?2", alias, input.networkId);
451
+ if (!exists) {
452
+ return { ok: false, error: "agent_not_in_network", status: 400, detail: { index, ...(nodeId ? { node_id: nodeId } : { alias }) } };
453
+ }
454
+ const key = nodeId ? `n:${nodeId}` : `a:${alias}`;
455
+ if (seen.has(key)) continue;
456
+ seen.add(key);
457
+ rows.push({ node_id: nodeId, alias, can_message: item.can_message === false ? 0 : 1 });
458
+ }
459
+ }
460
+
461
+ let groupRows: Array<{ group_id: string; can_message: number }> | undefined;
462
+ if (input.groupGrants !== undefined) {
463
+ if (!Array.isArray(input.groupGrants)) return { ok: false, error: "group_grants_must_be_array", status: 400 };
464
+ if (input.groupGrants.length > MAX_GRANTS) return { ok: false, error: "too_many_grants", status: 400, detail: { limit: MAX_GRANTS } };
465
+ const seenGroups = new Set<string>();
466
+ groupRows = [];
467
+ for (const [index, raw] of input.groupGrants.entries()) {
468
+ const item = typeof raw === "string" ? { group_id: raw } : (raw && typeof raw === "object" && !Array.isArray(raw) ? raw as { group_id?: unknown; can_message?: unknown } : {});
469
+ const groupId = typeof item.group_id === "string" ? item.group_id.trim() : "";
470
+ if (!groupId) return { ok: false, error: "group_grant_needs_group_id", status: 400, detail: { index } };
471
+ if (item.can_message !== undefined && typeof item.can_message !== "boolean") {
472
+ return { ok: false, error: "can_message_must_be_boolean", status: 400, detail: { index } };
473
+ }
474
+ if (!db.get("SELECT 1 FROM agent_groups WHERE group_id = ?1 AND network_id = ?2", groupId, input.networkId)) {
475
+ return { ok: false, error: "group_not_in_network", status: 400, detail: { index, group_id: groupId } };
476
+ }
477
+ if (seenGroups.has(groupId)) continue;
478
+ seenGroups.add(groupId);
479
+ groupRows.push({ group_id: groupId, can_message: item.can_message === false ? 0 : 1 });
480
+ }
481
+ }
482
+
483
+ let departmentRows: Array<{ department_id: string; can_message: number }> | undefined;
484
+ if (input.departmentGrants !== undefined) {
485
+ if (!Array.isArray(input.departmentGrants)) return { ok: false, error: "department_grants_must_be_array", status: 400 };
486
+ if (input.departmentGrants.length > MAX_GRANTS) return { ok: false, error: "too_many_grants", status: 400, detail: { limit: MAX_GRANTS } };
487
+ const seenDepts = new Set<string>();
488
+ departmentRows = [];
489
+ for (const [index, raw] of input.departmentGrants.entries()) {
490
+ const item = typeof raw === "string" ? { department_id: raw } : (raw && typeof raw === "object" && !Array.isArray(raw) ? raw as { department_id?: unknown; can_message?: unknown } : {});
491
+ const deptId = typeof item.department_id === "string" ? item.department_id.trim() : "";
492
+ if (!deptId) return { ok: false, error: "department_grant_needs_department_id", status: 400, detail: { index } };
493
+ if (item.can_message !== undefined && typeof item.can_message !== "boolean") {
494
+ return { ok: false, error: "can_message_must_be_boolean", status: 400, detail: { index } };
495
+ }
496
+ if (!db.get("SELECT 1 FROM network_departments WHERE department_id = ?1 AND network_id = ?2", deptId, input.networkId)) {
497
+ return { ok: false, error: "department_not_in_network", status: 400, detail: { index, department_id: deptId } };
498
+ }
499
+ if (seenDepts.has(deptId)) continue;
500
+ seenDepts.add(deptId);
501
+ departmentRows.push({ department_id: deptId, can_message: item.can_message === false ? 0 : 1 });
502
+ }
503
+ }
504
+
505
+ db.transaction(() => {
506
+ if (departmentRows) {
507
+ db.run("DELETE FROM network_member_department_grants WHERE network_id = ?1 AND user_id = ?2", [input.networkId, input.userId]);
508
+ for (const row of departmentRows) {
509
+ db.run(
510
+ `INSERT INTO network_member_department_grants (network_id, user_id, department_id, can_message, created_by) VALUES (?1, ?2, ?3, ?4, ?5)`,
511
+ [input.networkId, input.userId, row.department_id, row.can_message, input.actorUserId],
512
+ );
513
+ }
514
+ }
515
+ if (groupRows) {
516
+ db.run("DELETE FROM network_member_group_grants WHERE network_id = ?1 AND user_id = ?2", [input.networkId, input.userId]);
517
+ for (const row of groupRows) {
518
+ db.run(
519
+ `INSERT INTO network_member_group_grants (network_id, user_id, group_id, can_message, created_by) VALUES (?1, ?2, ?3, ?4, ?5)`,
520
+ [input.networkId, input.userId, row.group_id, row.can_message, input.actorUserId],
521
+ );
522
+ }
523
+ }
524
+ if (mode) {
525
+ db.run("UPDATE network_members SET agent_access = ?1 WHERE network_id = ?2 AND user_id = ?3", [mode, input.networkId, input.userId]);
526
+ }
527
+ if (rows) {
528
+ db.run("DELETE FROM network_member_agent_grants WHERE network_id = ?1 AND user_id = ?2", [input.networkId, input.userId]);
529
+ for (const row of rows) {
530
+ db.run(
531
+ `INSERT INTO network_member_agent_grants (network_id, user_id, node_id, alias, can_message, created_by)
532
+ VALUES (?1, ?2, ?3, ?4, ?5, ?6)`,
533
+ [input.networkId, input.userId, row.node_id, row.alias, row.can_message, input.actorUserId],
534
+ );
535
+ }
536
+ }
537
+ });
538
+
539
+ return {
540
+ ok: true,
541
+ agent_access: getAgentAccessMode(input.networkId, input.userId) ?? "granted",
542
+ grants: listAgentGrants(input.networkId, input.userId),
543
+ group_grants: listGroupGrants(input.networkId, input.userId),
544
+ department_grants: listDepartmentGrants(input.networkId, input.userId),
545
+ };
546
+ }
547
+
548
+ /** 成员被移出网络时一并清掉授权,重新加入时从零开始。 */
549
+ export function deleteAgentGrants(networkId: string, userId: string): void {
550
+ db.run("DELETE FROM network_member_agent_grants WHERE network_id = ?1 AND user_id = ?2", [networkId, userId]);
551
+ db.run("DELETE FROM network_member_group_grants WHERE network_id = ?1 AND user_id = ?2", [networkId, userId]);
552
+ db.run("DELETE FROM network_member_department_grants WHERE network_id = ?1 AND user_id = ?2", [networkId, userId]);
553
+ }
554
+
555
+ // 多用户 Agent 权限 —— 受限成员(只看授权 Agent 的成员)能调的 MCP 工具。每一个都逐条审过:
556
+ // 要么自己按授权过滤 / 准入(get_all_status、get_session_status、get_task、list_tasks、send_task、
557
+ // send_message),要么是人类侧(send_desktop_message、需求看板),要么只读且对受限网络 fail-closed
558
+ // (get_completions)。其余工具:受限成员只能在**不受限的**网络里调(必须显式传 network_id),
559
+ // 在受限网络里、或没说是哪个网络时一律拒绝 —— 新增的工具默认落在拒绝这边。
560
+ export const RESTRICTED_MEMBER_TOOLS: ReadonlySet<string> = new Set([
561
+ "get_all_status",
562
+ "get_session_status",
563
+ "get_task",
564
+ "list_tasks",
565
+ "get_completions",
566
+ "send_task",
567
+ "send_message",
568
+ "send_desktop_message",
569
+ "requirements_list",
570
+ "requirements_get",
571
+ "requirements_create",
572
+ "requirements_update",
573
+ "requirements_checklist_toggle",
574
+ "requirements_upsert_by_external_ref",
575
+ "projects_list",
576
+ // 2026-10-02(app 任务页审计 M3):和 app「管理项目」/「动态」同一个 REST 处理,权限也同一套 —— 项目管理对仅相关任务的
577
+ // 成员和 viewer 一律 403;动态按任务可见性过滤,受限成员看不见的节点在里面隐去(listEvents 的 hiddenNodeFilter)。
578
+ "projects_create",
579
+ "projects_update",
580
+ "requirements_events",
581
+ // #474:评论走同一个 REST 处理 —— 看不见的任务 404、只读角色 403;受限成员的评论和他的其他任务写一样按可见性准入。
582
+ "requirements_comment",
583
+ // #473:通讯录同 /api/requirements/people 的可见范围 —— 受限成员看不见的 Agent 不出现(hiddenNodeFilter)。
584
+ "requirements_people",
585
+ ]);