@sleep2agi/commhub-server 0.9.0-preview.23 → 0.9.0-preview.230

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 (408) hide show
  1. package/README.md +129 -9
  2. package/bin/commhub.ts +93 -9
  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 +654 -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 +6 -7
  27. package/src/api-host-supervisors-runtime-readiness.test.ts +195 -0
  28. package/src/api-nodes-shape.test.ts +95 -4
  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 +52 -2
  35. package/src/avatar-validate.ts +35 -1
  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/broadcast-fanout-2721.test.ts +149 -0
  40. package/src/broadcast-fanout.ts +117 -0
  41. package/src/chain-attempt-dedup.test.ts +447 -0
  42. package/src/clip.test.ts +36 -0
  43. package/src/clip.ts +46 -0
  44. package/src/clone-node.test.ts +248 -0
  45. package/src/clone-node.ts +289 -0
  46. package/src/codex-config-flags.ts +77 -0
  47. package/src/codex-fork-contract.ts +23 -0
  48. package/src/codex-fork-migration.test.ts +38 -0
  49. package/src/commhub-bin-args.test.ts +85 -0
  50. package/src/config-apply-validate.test.ts +188 -1
  51. package/src/config-apply-validate.ts +222 -3
  52. package/src/cors-origins.test.ts +73 -0
  53. package/src/create-node-blocked-gate.test.ts +356 -0
  54. package/src/create-node-network-id.test.ts +91 -0
  55. package/src/create-node-tool-schema.test.ts +49 -0
  56. package/src/create-node-unicode-name.test.ts +120 -0
  57. package/src/create-node-validate.test.ts +199 -7
  58. package/src/create-node-validate.ts +232 -15
  59. package/src/create-node-workdir.test.ts +289 -0
  60. package/src/create-node.ts +88 -23
  61. package/src/daemon-provider-snapshots.test.ts +421 -0
  62. package/src/daemon-provider-snapshots.ts +327 -0
  63. package/src/daemon-token-owner-http.test.ts +236 -0
  64. package/src/dashboard-slash-routing-http.test.ts +109 -0
  65. package/src/db-adapter-guard.test.ts +148 -0
  66. package/src/db-adapter-translate.test.ts +128 -0
  67. package/src/db-adapter.ts +377 -91
  68. package/src/db-timestamp.test.ts +38 -0
  69. package/src/db-timestamp.ts +15 -0
  70. package/src/db.ts +1264 -153
  71. package/src/delivered-without-push.test.ts +140 -0
  72. package/src/department-groups-http.test.ts +209 -0
  73. package/src/department-groups-sync-http.test.ts +328 -0
  74. package/src/department-groups.ts +434 -0
  75. package/src/department-heads-http.test.ts +350 -0
  76. package/src/department-heads.ts +226 -0
  77. package/src/departments-agent-count.test.ts +132 -0
  78. package/src/departments-http.test.ts +185 -0
  79. package/src/departments-mcp.test.ts +128 -0
  80. package/src/departments.ts +318 -0
  81. package/src/desktop-message-seam.test.ts +150 -0
  82. package/src/desktop-message.test.ts +368 -0
  83. package/src/dm-file-scope-http.test.ts +178 -0
  84. package/src/empty-node-sweeper.test.ts +104 -0
  85. package/src/empty-node-sweeper.ts +88 -0
  86. package/src/env-transport-gate-http.test.ts +240 -0
  87. package/src/env-transport-gate.ts +80 -0
  88. package/src/env-transport-policy.ts +56 -0
  89. package/src/etag-of.test.ts +57 -0
  90. package/src/event-loop-lag.test.ts +180 -0
  91. package/src/event-loop-lag.ts +201 -0
  92. package/src/ext-token-shared.test.ts +60 -0
  93. package/src/ext-validation-regression.test.ts +131 -0
  94. package/src/external-schedule-edits-http.test.ts +321 -0
  95. package/src/external-schedule-edits-timestamps.test.ts +64 -0
  96. package/src/external-schedule-edits.ts +327 -0
  97. package/src/file-download-authz-dev-open.test.ts +1 -1
  98. package/src/file-download-authz.test.ts +73 -18
  99. package/src/file-download-date-bucket.test.ts +436 -0
  100. package/src/file-network-scope-dev-open.test.ts +97 -0
  101. package/src/file-network-scope.test.ts +732 -0
  102. package/src/group-membership-events-http.test.ts +264 -0
  103. package/src/group-messages-http.test.ts +482 -0
  104. package/src/group-messages.ts +297 -0
  105. package/src/health-anon-readers.ts +60 -0
  106. package/src/health-host-disk-2756.test.ts +71 -0
  107. package/src/health-redaction.test.ts +1721 -2
  108. package/src/host-supervisor-identity-http.test.ts +152 -0
  109. package/src/host-supervisor-identity.ts +92 -0
  110. package/src/host-supervisors-daemon-version.test.ts +137 -0
  111. package/src/http-gzip.test.ts +94 -0
  112. package/src/http-gzip.ts +112 -0
  113. package/src/hub-catalog-read-http.test.ts +409 -0
  114. package/src/hub-provider-config.test.ts +156 -0
  115. package/src/hub-provider-config.ts +170 -0
  116. package/src/hub-timestamp.test.ts +38 -0
  117. package/src/hub-timestamp.ts +27 -0
  118. package/src/human-dm.ts +215 -0
  119. package/src/human-inbox.ts +42 -0
  120. package/src/inbox-caller.ts +49 -0
  121. package/src/inbox-count-sse.test.ts +310 -0
  122. package/src/inbox-count.ts +29 -0
  123. package/src/index.ts +6 -2
  124. package/src/license-state.test.ts +56 -0
  125. package/src/license-state.ts +48 -0
  126. package/src/list-host-supervisors.test.ts +15 -4
  127. package/src/mcp-context-cost-http.test.ts +127 -0
  128. package/src/mcp-inflight.test.ts +92 -0
  129. package/src/mcp-inflight.ts +38 -0
  130. package/src/mcp-projects-events-http.test.ts +165 -0
  131. package/src/mcp-route-label-http.test.ts +120 -0
  132. package/src/mcp-write-network-resolution.test.ts +435 -0
  133. package/src/member-audit-network-id-http.test.ts +93 -0
  134. package/src/member-presence-http.test.ts +210 -0
  135. package/src/messages-ack-by-agent-http.test.ts +142 -0
  136. package/src/migrate-sqlite-to-pg.test.ts +47 -0
  137. package/src/migrate-sqlite-to-pg.ts +263 -0
  138. package/src/model-auth-notify-http.test.ts +181 -0
  139. package/src/model-auth-notify.ts +116 -0
  140. package/src/network-name-http.test.ts +75 -0
  141. package/src/network-rules-http.test.ts +169 -0
  142. package/src/network-rules.ts +129 -0
  143. package/src/network-scope.ts +276 -0
  144. package/src/network-token-membership-http.test.ts +139 -0
  145. package/src/node-alias-control.ts +12 -0
  146. package/src/node-attrs.test.ts +47 -2
  147. package/src/node-caller-identity-http.test.ts +1091 -0
  148. package/src/node-create-request-status-http.test.ts +105 -0
  149. package/src/node-daemon-bindings.test.ts +132 -0
  150. package/src/node-daemon-bindings.ts +135 -0
  151. package/src/node-failure-alert.test.ts +150 -0
  152. package/src/node-failure-alert.ts +177 -0
  153. package/src/node-files-transport.test.ts +344 -0
  154. package/src/node-health-codex-login.test.ts +120 -0
  155. package/src/node-health-dispatch-http.test.ts +335 -0
  156. package/src/node-health-guard.ts +121 -0
  157. package/src/node-health-passthrough.test.ts +115 -0
  158. package/src/node-health-store.ts +101 -0
  159. package/src/node-id-alias.test.ts +190 -0
  160. package/src/node-identity-conflict-http.test.ts +269 -0
  161. package/src/node-identity-conflict.ts +142 -0
  162. package/src/node-identity-mismatch.test.ts +74 -0
  163. package/src/node-in-flight-tasks.ts +31 -0
  164. package/src/node-lifecycle-controllable.test.ts +64 -0
  165. package/src/node-lifecycle-controllable.ts +53 -0
  166. package/src/node-lifecycle-read-http.test.ts +250 -0
  167. package/src/node-lifecycle-read.ts +124 -0
  168. package/src/node-logs-transport.test.ts +263 -0
  169. package/src/node-peer-allowlist.test.ts +114 -0
  170. package/src/node-permissions-http.test.ts +728 -0
  171. package/src/node-permissions.ts +494 -0
  172. package/src/node-request-retention.test.ts +281 -0
  173. package/src/node-request-retention.ts +120 -0
  174. package/src/node-secret-rest-http.test.ts +190 -0
  175. package/src/node-serviceability.test.ts +86 -0
  176. package/src/node-serviceability.ts +124 -0
  177. package/src/node-session-control-http.test.ts +310 -0
  178. package/src/node-session-control.ts +258 -0
  179. package/src/node-skills-transport.test.ts +212 -0
  180. package/src/node-token-identity.ts +35 -0
  181. package/src/node-token-ownership.ts +51 -0
  182. package/src/node-token-privilege-http.test.ts +158 -0
  183. package/src/not-found-api-http.test.ts +67 -0
  184. package/src/observer-avatar-http.test.ts +102 -9
  185. package/src/observer-push.test.ts +76 -0
  186. package/src/opencode-catalog-report-http.test.ts +139 -0
  187. package/src/opencode-v2-catalog.test.ts +268 -0
  188. package/src/opencode-v2-catalog.ts +356 -0
  189. package/src/package-version-consistency.test.ts +25 -0
  190. package/src/parent-source-marker.test.ts +50 -0
  191. package/src/password-network-tokens.ts +25 -0
  192. package/src/peer-reply-atomic.test.ts +457 -0
  193. package/src/peer-reply-capability.test.ts +70 -0
  194. package/src/pg-worker.ts +87 -0
  195. package/src/poll-pacing.test.ts +74 -0
  196. package/src/poll-pacing.ts +123 -0
  197. package/src/project-dir-warn-clear-http.test.ts +132 -0
  198. package/src/project-viewer-can-http.test.ts +116 -0
  199. package/src/push.test.ts +20 -10
  200. package/src/push.ts +382 -9
  201. package/src/redact-tokens.test.ts +86 -0
  202. package/src/redact-tokens.ts +43 -0
  203. package/src/rejection-counters.test.ts +72 -0
  204. package/src/rejection-counters.ts +173 -0
  205. package/src/rename.ts +38 -10
  206. package/src/reply-target-derivation.test.ts +96 -0
  207. package/src/report-status-handover-capabilities-http.test.ts +124 -0
  208. package/src/report-status-host-schema.test.ts +235 -0
  209. package/src/report-status-resume-id-handover.test.ts +184 -0
  210. package/src/report-status-secret-keys.test.ts +140 -0
  211. package/src/require-explicit-test-db.ts +9 -0
  212. package/src/requirement-due-reminders-http.test.ts +620 -0
  213. package/src/requirement-due-reminders.ts +416 -0
  214. package/src/requirement-events-http.test.ts +295 -0
  215. package/src/requirement-events.test.ts +45 -0
  216. package/src/requirement-events.ts +144 -0
  217. package/src/requirement-notify.ts +165 -0
  218. package/src/requirement-participant-notify-http.test.ts +309 -0
  219. package/src/requirement-tag-ops-http.test.ts +443 -0
  220. package/src/requirement-tag-tree-http.test.ts +275 -0
  221. package/src/requirement-tag-tree.ts +127 -0
  222. package/src/requirement-tags.ts +102 -0
  223. package/src/requirements-abandoned-http.test.ts +236 -0
  224. package/src/requirements-comment-http.test.ts +167 -0
  225. package/src/requirements-completed-at-migration.test.ts +70 -0
  226. package/src/requirements-errors-mcp-http.test.ts +164 -0
  227. package/src/requirements-errors.ts +158 -0
  228. package/src/requirements-etag-http.test.ts +91 -0
  229. package/src/requirements-http.test.ts +709 -0
  230. package/src/requirements-last-event-http.test.ts +349 -0
  231. package/src/requirements-list-mcp-slim-http.test.ts +155 -0
  232. package/src/requirements-list-slim-http.test.ts +324 -0
  233. package/src/requirements-mcp.test.ts +163 -0
  234. package/src/requirements-migrate.ts +283 -0
  235. package/src/requirements-owner-strict-mcp-http.test.ts +145 -0
  236. package/src/requirements-people-http.test.ts +114 -0
  237. package/src/requirements-people-mcp-http.test.ts +231 -0
  238. package/src/requirements-people.ts +196 -0
  239. package/src/requirements-priority-lowest.test.ts +114 -0
  240. package/src/requirements-projects-network-echo.test.ts +57 -0
  241. package/src/requirements-projects-parent-http.test.ts +123 -0
  242. package/src/requirements-search-http.test.ts +182 -0
  243. package/src/requirements-search.test.ts +32 -0
  244. package/src/requirements-search.ts +145 -0
  245. package/src/requirements-seq-http.test.ts +193 -0
  246. package/src/requirements-seq-migration.test.ts +63 -0
  247. package/src/requirements-start-date.test.ts +125 -0
  248. package/src/requirements-stats-http.test.ts +357 -0
  249. package/src/requirements-stats.ts +195 -0
  250. package/src/requirements-status-participants-http.test.ts +222 -0
  251. package/src/requirements-upgrade-e2e.test.ts +126 -0
  252. package/src/requirements-upgrade-migration.test.ts +98 -0
  253. package/src/requirements.ts +2064 -0
  254. package/src/resolve-port.test.ts +57 -0
  255. package/src/resolve-port.ts +44 -0
  256. package/src/rest-alias-network-fallback-http.test.ts +123 -0
  257. package/src/rest-alias-network-fallback.test.ts +60 -0
  258. package/src/rest-alias-network-fallback.ts +65 -0
  259. package/src/rest-explicit-columns-http.test.ts +266 -0
  260. package/src/rest-identity.test.ts +130 -0
  261. package/src/rest-identity.ts +141 -0
  262. package/src/rest-projections.ts +72 -0
  263. package/src/rest-read-network-real-chain.test.ts +97 -0
  264. package/src/rest-write-network-resolution.test.ts +133 -0
  265. package/src/restart-readiness-http.test.ts +121 -0
  266. package/src/restricted-files.ts +76 -0
  267. package/src/retention-first-sweep-quiet.test.ts +31 -0
  268. package/src/retention.test.ts +100 -40
  269. package/src/retention.ts +423 -104
  270. package/src/route-callers-http.test.ts +120 -0
  271. package/src/route-timing.test.ts +218 -0
  272. package/src/route-timing.ts +262 -0
  273. package/src/rules-file-duplicate-alias.test.ts +234 -0
  274. package/src/rules-file-session-target.test.ts +207 -0
  275. package/src/rules-file-transport.test.ts +237 -0
  276. package/src/runtime-label.test.ts +22 -0
  277. package/src/runtime-label.ts +21 -0
  278. package/src/runtime-readiness.ts +90 -0
  279. package/src/schedule-agent-mcp-http.test.ts +432 -0
  280. package/src/schedule-agent.ts +252 -0
  281. package/src/schedule-starved.test.ts +92 -0
  282. package/src/schedule-starved.ts +114 -0
  283. package/src/scheduled-backoff-http.test.ts +193 -0
  284. package/src/scheduled-backoff.ts +64 -0
  285. package/src/scheduled-doorbell-nodeless-session.test.ts +134 -0
  286. package/src/scheduled-failure-backoff-2622.test.ts +145 -0
  287. package/src/scheduled-failure-code.test.ts +73 -0
  288. package/src/scheduled-failure-code.ts +105 -0
  289. package/src/scheduled-failures-http.test.ts +279 -0
  290. package/src/scheduled-failures.ts +425 -0
  291. package/src/scheduled-noprogress-backoff-2622.test.ts +163 -0
  292. package/src/scheduled-offline-backoff-probe.test.ts +56 -0
  293. package/src/scheduled-offline.test.ts +131 -0
  294. package/src/scheduled-offline.ts +66 -0
  295. package/src/scheduled-outcome-guidance-http.test.ts +139 -0
  296. package/src/scheduled-outcome-guidance.ts +9 -0
  297. package/src/scheduled-reply-unread-http.test.ts +212 -0
  298. package/src/scheduled-requirement-wake-http.test.ts +279 -0
  299. package/src/scheduled-requirement-wake.ts +125 -0
  300. package/src/scheduled-run-terminal.test.ts +268 -0
  301. package/src/scheduled-skip-blocking-task.test.ts +120 -0
  302. package/src/scheduled-skip-path-backoff-2622.test.ts +98 -0
  303. package/src/scheduled-stuck-http.test.ts +316 -0
  304. package/src/scheduled-stuck-notice-cap.test.ts +80 -0
  305. package/src/scheduled-stuck.ts +219 -0
  306. package/src/scheduled-tasks-http.test.ts +679 -0
  307. package/src/scheduled-tasks.ts +959 -0
  308. package/src/scheduled-work-outcome-http.test.ts +154 -0
  309. package/src/scheduled-work-outcome.ts +50 -0
  310. package/src/scoped-secrets.ts +141 -0
  311. package/src/send-dedup-request-id.test.ts +229 -0
  312. package/src/send-reply-agent-warning.test.ts +38 -38
  313. package/src/send-reply-alias-optional.test.ts +131 -0
  314. package/src/send-reply-attachments.test.ts +458 -0
  315. package/src/send_dedup.test.ts +54 -0
  316. package/src/send_dedup.ts +52 -6
  317. package/src/serve-error.test.ts +73 -0
  318. package/src/serve-error.ts +56 -0
  319. package/src/server.ts +5035 -457
  320. package/src/session-task-on-dispatch.ts +14 -0
  321. package/src/session-token-ownership-http.test.ts +122 -0
  322. package/src/shared/codex-inventory.ts +41 -0
  323. package/src/shared/daemon-provider-login.ts +31 -0
  324. package/src/shared/daemon-provider-snapshot.ts +52 -0
  325. package/src/shared/external-schedule-contract.ts +60 -0
  326. package/src/shared/node-name.test.ts +62 -0
  327. package/src/shared/node-name.ts +161 -0
  328. package/src/shared/probe-host-allowlist-drift.test.ts +45 -0
  329. package/src/shared/provider-application.ts +29 -0
  330. package/src/shared/provider-collection.ts +14 -0
  331. package/src/shared/provider-initialization.ts +8 -0
  332. package/src/shared/reserved-env-drift.test.ts +10 -0
  333. package/src/shared/scoped-secret-contract.ts +5 -0
  334. package/src/shared/task-content-limit-drift.test.ts +28 -0
  335. package/src/shared/task-content-limit.ts +25 -0
  336. package/src/side-thread-command-transport.test.ts +312 -0
  337. package/src/side-thread-command-transport.ts +318 -0
  338. package/src/side-thread-http-integration.test.ts +233 -0
  339. package/src/side-thread-http.ts +504 -0
  340. package/src/side-thread-production.test.ts +72 -0
  341. package/src/side-thread-production.ts +118 -0
  342. package/src/side-thread.test.ts +1067 -0
  343. package/src/side-thread.ts +2499 -0
  344. package/src/skillhub-http.test.ts +142 -0
  345. package/src/sqlite-close-checkpoint.test.ts +78 -0
  346. package/src/start-node.test.ts +264 -0
  347. package/src/status-alias-filter-http.test.ts +106 -0
  348. package/src/status-alias-resolver-http.test.ts +163 -0
  349. package/src/status-alias-resolver.ts +19 -0
  350. package/src/status-node-id-filter-http.test.ts +161 -0
  351. package/src/status-read-cache-http.test.ts +229 -0
  352. package/src/status-read-cache.ts +129 -0
  353. package/src/stop-delete-node.test.ts +567 -1
  354. package/src/task-access-http.test.ts +402 -0
  355. package/src/task-access.ts +420 -0
  356. package/src/task-activity.ts +60 -0
  357. package/src/task-auth-origin-http.test.ts +93 -0
  358. package/src/task-auth-origin.test.ts +24 -0
  359. package/src/task-auth-origin.ts +7 -0
  360. package/src/task-consumption.test.ts +490 -0
  361. package/src/task-diagnostic-http.test.ts +149 -0
  362. package/src/task-diagnostic.test.ts +115 -0
  363. package/src/task-diagnostic.ts +118 -0
  364. package/src/task-expiry-notice-http.test.ts +287 -0
  365. package/src/task-expiry-notice.ts +315 -0
  366. package/src/task-idempotency-mcp.test.ts +142 -0
  367. package/src/task-idempotency.test.ts +76 -0
  368. package/src/task-idempotency.ts +81 -0
  369. package/src/task-late-replies.ts +54 -0
  370. package/src/task-late-reply-http.test.ts +227 -0
  371. package/src/task-lifecycle-watcher-busy.test.ts +114 -0
  372. package/src/task-lifecycle-watcher.test.ts +204 -0
  373. package/src/task-lifecycle-watcher.ts +109 -0
  374. package/src/task-network-resolution-http.test.ts +140 -0
  375. package/src/task-offline-delivery-2668.test.ts +119 -0
  376. package/src/task-offline-delivery.ts +81 -0
  377. package/src/task-orphan-http.test.ts +287 -0
  378. package/src/task-orphan.ts +119 -0
  379. package/src/task-queue-ahead-http.test.ts +309 -0
  380. package/src/task-queue-ahead-scale.test.ts +236 -0
  381. package/src/task-queue-ahead.ts +186 -0
  382. package/src/task-rejection-log-http.test.ts +160 -0
  383. package/src/task-rejection-log.ts +61 -0
  384. package/src/task-sender-http.test.ts +143 -0
  385. package/src/task-stale-open-http.test.ts +292 -0
  386. package/src/task-stale-open.ts +103 -0
  387. package/src/tasks-pagination-http.test.ts +141 -0
  388. package/src/team-rules-status-http.test.ts +90 -0
  389. package/src/team-rules-status.test.ts +59 -0
  390. package/src/team-rules-status.ts +72 -0
  391. package/src/tmux-allowlist.test.ts +48 -0
  392. package/src/tool-audience-http.test.ts +230 -0
  393. package/src/tool-audience.ts +127 -0
  394. package/src/tools-list-json-schema.test.ts +94 -0
  395. package/src/tools.ts +4310 -419
  396. package/src/upload-early-reject-guard.test.ts +155 -0
  397. package/src/uploads-http.test.ts +86 -7
  398. package/src/uploads.ts +103 -6
  399. package/src/user-avatar-http.test.ts +74 -0
  400. package/src/user-avatar-image.ts +160 -0
  401. package/src/user-avatar-migration.test.ts +25 -0
  402. package/src/user-avatar-upload-http.test.ts +348 -0
  403. package/src/user-inbox-by-agent-http.test.ts +161 -0
  404. package/src/user-inbox-netid-notnull.test.ts +122 -0
  405. package/src/user-inbox-read-http.test.ts +223 -0
  406. package/src/user-inbox-schema.test.ts +54 -0
  407. package/src/version-stats.test.ts +66 -0
  408. package/src/version-stats.ts +109 -0
@@ -0,0 +1,132 @@
1
+ // #2822 —— 部门 → Agent 计数(轴2)必须是接口直接给出的,而且要和客户端同一口径。
2
+ //
3
+ // 背景:admin 看到 Dashboard 部门盘「未分组 105 / TMAI 1 / 其余 0」,客户端同一棵树却是
4
+ // 「TMWork 15 / TM智能体空间 2」。根因是**两个轴**被混成了一个:
5
+ // 轴1 人 network_members.department_id
6
+ // 轴2 Agent nodes.department_id ← 权威
7
+ // 本测试钉住:HTTP `GET …/departments` 与 MCP `departments list` 都直接用 nodes.department_id,
8
+ // 并且按 #2596 的口径去重(同 alias 只算一个,保留 updated_at 最新的那一行)。
9
+
10
+ import { describe, expect, test, beforeAll, afterAll } from "bun:test";
11
+ import { mkdtempSync, rmSync } from "fs";
12
+ import { join } from "path";
13
+ import { tmpdir } from "os";
14
+ import { Client } from "@modelcontextprotocol/sdk/client/index.js";
15
+ import { InMemoryTransport } from "@modelcontextprotocol/sdk/inMemory.js";
16
+ import { McpServer } from "@modelcontextprotocol/sdk/server/mcp.js";
17
+ import { register } from "./auth.js";
18
+ import { db } from "./db.js";
19
+ import { registerTools } from "./tools.js";
20
+
21
+ const DIR = mkdtempSync(join(tmpdir(), "anet-dept-agent-count-"));
22
+ let BASE = "";
23
+ let hub: any = null;
24
+ const PW = "DeptAgentCountPassw0rd!";
25
+ let NET = "";
26
+ let TOKEN = "";
27
+ const UID: string[] = [];
28
+
29
+ async function send(token: string, method: string, path: string, body?: unknown) {
30
+ const res = await fetch(`${BASE}${path}`, { method, headers: { ...(token ? { Authorization: `Bearer ${token}` } : {}), "Content-Type": "application/json" }, body: body === undefined ? undefined : JSON.stringify(body) });
31
+ const text = await res.text();
32
+ let json: any = null;
33
+ try { json = JSON.parse(text); } catch {}
34
+ return { status: res.status, body: json };
35
+ }
36
+ const D = () => `/api/networks/${NET}/departments`;
37
+
38
+ function mkDept(name: string): string {
39
+ const id = `dept_${name.toLowerCase().replace(/[^a-z0-9]/g, "")}_${Math.random().toString(36).slice(2, 8)}`;
40
+ db.run("INSERT INTO network_departments (network_id, department_id, name) VALUES (?1, ?2, ?3)", [NET, id, name]);
41
+ return id;
42
+ }
43
+ let seq = 0;
44
+ function mkNode(alias: string | null, departmentId: string | null, updatedAt: string) {
45
+ const nodeId = `n_c_${Date.now()}_${seq++}`;
46
+ db.run(
47
+ "INSERT INTO nodes (node_id, node_name, alias, runtime, network_id, department_id, updated_at) VALUES (?1, ?2, ?3, 'codex', ?4, ?5, ?6)",
48
+ [nodeId, alias || nodeId, alias, NET, departmentId, updatedAt],
49
+ );
50
+ return nodeId;
51
+ }
52
+
53
+ beforeAll(async () => {
54
+ process.env.COMMHUB_DB ||= join(DIR, "hub.db");
55
+ process.env.COMMHUB_UPLOADS_DIR = join(DIR, "uploads");
56
+ process.env.HOST = "127.0.0.1";
57
+ const a = register(`dca_owner_${Date.now()}`, PW, undefined, "Owner");
58
+ expect(a.ok).toBe(true);
59
+ TOKEN = a.token!;
60
+ UID.push(a.user!.user_id);
61
+ NET = a.network_id!;
62
+ db.run("UPDATE users SET role = 'admin' WHERE user_id = ?1", [a.user!.user_id]);
63
+ const mod: any = await import("./server.js");
64
+ hub = mod.bootServer({ port: 0, hostname: "127.0.0.1" });
65
+ BASE = `http://127.0.0.1:${hub.port}`;
66
+ }, 30_000);
67
+
68
+ afterAll(() => {
69
+ try { hub?.stop?.(true); } catch {}
70
+ try { rmSync(DIR, { recursive: true, force: true }); } catch {}
71
+ });
72
+
73
+ describe("#2822 部门 → Agent 计数走 nodes.department_id(轴2)", () => {
74
+ test("agent_count 只数显式归属的 Agent;agents_unassigned 单独给;人的部门不参与", async () => {
75
+ const work = mkDept("TMWork");
76
+ const space = mkDept("TM智能体空间");
77
+ const infra = mkDept("TM基建");
78
+
79
+ // 轴2:TMWork 3 个(其中两个同 alias,旧的应被去重掉)→ 期望 2
80
+ mkNode("alice", work, "2026-10-01 00:00:00");
81
+ mkNode("alice", work, "2026-10-20 00:00:00"); // 更新 ⇒ 保留这一行
82
+ mkNode("bob", work, "2026-10-20 00:00:00");
83
+ // TM智能体空间 1 个
84
+ mkNode("carol", space, "2026-10-20 00:00:00");
85
+ // TM基建:同 alias 但更新的一行被移到了别的部门 ⇒ 计数要跟着最新那一行走
86
+ mkNode("dave", infra, "2026-10-01 00:00:00");
87
+ mkNode("dave", space, "2026-10-25 00:00:00");
88
+ // 未归属 2 个
89
+ mkNode("eve", null, "2026-10-20 00:00:00");
90
+ mkNode("frank", "", "2026-10-20 00:00:00");
91
+ // 把负责人放进 TM基建(轴1)—— 轴1 有任何值都不能影响轴2 的计数
92
+ db.run("UPDATE network_members SET department_id = ?2 WHERE network_id = ?1 AND user_id = ?3", [NET, infra, UID[0]]);
93
+
94
+ const r = await send(TOKEN, "GET", D());
95
+ expect(r.status).toBe(200);
96
+ const byName = new Map<string, any>((r.body.departments as any[]).map((d) => [d.name, d]));
97
+
98
+ expect(byName.get("TMWork").agent_count).toBe(2); // alice 去重后 + bob
99
+ expect(byName.get("TM智能体空间").agent_count).toBe(2); // carol + dave(最新那一行在这里)
100
+ expect(byName.get("TM基建").agent_count).toBe(0); // dave 已被移走;人的部门不算
101
+ expect(r.body.agents_unassigned).toBe(2); // eve + frank(domain: department_id 空)
102
+
103
+ // 轴1 仍然是直属人数,不受影响
104
+ expect(byName.get("TM基建").member_count).toBe(1);
105
+ expect(byName.get("TMWork").member_count).toBe(0);
106
+ });
107
+
108
+ test("MCP departments list 与 HTTP 同一口径(不再各自算一遍)", async () => {
109
+ // 真的走 in-process MCP transport(不是直调函数):要验的正是「工具返回的就是同一份口径」。
110
+ const server = new McpServer({ name: "dept-agent-count", version: "1" });
111
+ registerTools(server, undefined, NET, UID[0], "owner-agent", true, null);
112
+ const client = new Client({ name: "dept-agent-count-client", version: "1" });
113
+ const [ct, st] = InMemoryTransport.createLinkedPair();
114
+ await server.connect(st);
115
+ await client.connect(ct);
116
+ try {
117
+ const raw: any = await client.callTool({ name: "departments", arguments: { action: "list" } });
118
+ const mcp = JSON.parse(String(raw.content?.[0]?.text ?? "{}"));
119
+ // 2026-10-31 —— **精确键集**(#3171):紧挨调用写,且单行(键集断言被任何换行拆开时,
120
+ // 静态计数器就读不到它 —— 而读不到与没写同形)。实际五键,我第一版只写了三个。
121
+ expect(Object.keys(mcp).sort()).toEqual(["agents", "departments", "network_id", "ok", "unassigned_agents"]);
122
+ const http = (await send(TOKEN, "GET", D())).body;
123
+ const httpByName = new Map<string, any>((http.departments as any[]).map((d) => [d.name, d]));
124
+ expect(mcp.departments.length).toBeGreaterThan(0);
125
+ for (const d of mcp.departments as any[]) expect(d.agent_count).toBe(httpByName.get(d.name).agent_count);
126
+ expect(mcp.unassigned_agents).toBe(http.agents_unassigned);
127
+ } finally {
128
+ await client.close();
129
+ await server.close();
130
+ }
131
+ });
132
+ });
@@ -0,0 +1,185 @@
1
+ // 组织架构(board #419):GET/POST/PATCH/DELETE /api/networks/:id/departments、PUT …/members/:uid/department。
2
+ // HTTP 集成测试(真实 Bun.serve,私有端口,临时库)。钉住:谁能读 / 谁能写、部门规则(同级不重名、不成环、最多 10 层、
3
+ // 只删空部门、负责人必须是成员)、成员所在部门,以及只增不改(/humans、/members 只多一个 department_id)。
4
+
5
+ import { describe, expect, test, beforeAll, afterAll } from "bun:test";
6
+ import { mkdtempSync, rmSync } from "fs";
7
+ import { join } from "path";
8
+ import { tmpdir } from "os";
9
+ import { register, createNetworkTokenForNode } from "./auth.js";
10
+ import { db } from "./db.js";
11
+
12
+ const DIR = mkdtempSync(join(tmpdir(), "anet-departments-"));
13
+ let BASE = "";
14
+ let hub: any = null;
15
+ const PW = "DepartmentsPassw0rd!x";
16
+ let NET = "", OTHER_NET = "";
17
+ const U: Record<string, { token: string; id: string }> = {};
18
+
19
+ async function send(token: string, method: string, path: string, body?: unknown) {
20
+ const res = await fetch(`${BASE}${path}`, { method, headers: { ...(token ? { Authorization: `Bearer ${token}` } : {}), "Content-Type": "application/json" }, body: body === undefined ? undefined : JSON.stringify(body) });
21
+ const text = await res.text();
22
+ let json: any = null;
23
+ try { json = JSON.parse(text); } catch {}
24
+ return { status: res.status, body: json };
25
+ }
26
+ const D = () => `/api/networks/${NET}/departments`;
27
+ const list = async (who = "owner") => (await send(U[who].token, "GET", D())).body;
28
+ const mk = async (name: string, extra: Record<string, unknown> = {}) => {
29
+ const r = await send(U.owner.token, "POST", D(), { name, ...extra });
30
+ expect(r.status).toBe(201);
31
+ return r.body.department as { id: string; name: string; parent_id: string | null };
32
+ };
33
+
34
+ beforeAll(async () => {
35
+ process.env.COMMHUB_DB ||= join(DIR, "hub.db");
36
+ process.env.COMMHUB_UPLOADS_DIR = join(DIR, "uploads");
37
+ process.env.HOST = "127.0.0.1";
38
+ const a = register(`dep_owner_${Date.now()}`, PW, undefined, "Owner");
39
+ expect(a.ok).toBe(true);
40
+ U.owner = { token: a.token!, id: a.user!.user_id };
41
+ NET = a.network_id!;
42
+ db.run("UPDATE users SET role = 'admin' WHERE user_id = ?1", [U.owner.id]);
43
+ const mod: any = await import("./server.js");
44
+ hub = mod.bootServer({ port: 0, hostname: "127.0.0.1" });
45
+ BASE = `http://127.0.0.1:${hub.port}`;
46
+ const add = async (username: string, role: string) => {
47
+ expect((await send(U.owner.token, "POST", "/api/admin/users", { username, password: PW, network_id: NET, role })).status).toBe(200);
48
+ const login = await send("", "POST", "/api/auth/login", { username, password: PW });
49
+ expect(login.status).toBe(200);
50
+ return { token: login.body.token as string, id: login.body.user.user_id as string };
51
+ };
52
+ const stamp = Date.now();
53
+ U.admin = await add(`dep_admin_${stamp}`, "admin");
54
+ U.member = await add(`dep_member_${stamp}`, "member");
55
+ U.viewer = await add(`dep_viewer_${stamp}`, "viewer");
56
+ U.node = { token: createNetworkTokenForNode(U.owner.id, NET, "dep-node", "node_dep").token!, id: "node_dep" };
57
+ const o = register(`dep_outsider_${stamp}`, PW);
58
+ U.outsider = { token: o.token!, id: o.user!.user_id };
59
+ OTHER_NET = o.network_id!;
60
+ }, 30_000);
61
+
62
+ afterAll(() => {
63
+ try { hub?.stop?.(true); } catch {}
64
+ try { rmSync(DIR, { recursive: true, force: true }); } catch {}
65
+ });
66
+
67
+ describe("who can read / write", () => {
68
+ test("every member, a node token of this network and a hub admin can read; outsiders and other networks' nodes can't", async () => {
69
+ for (const who of ["owner", "admin", "member", "viewer", "node"]) expect((await send(U[who].token, "GET", D())).status).toBe(200);
70
+ expect((await send(U.outsider.token, "GET", D())).status).toBe(403);
71
+ expect((await send("", "GET", D())).status).toBe(401);
72
+ const otherNode = createNetworkTokenForNode(U.outsider.id, OTHER_NET, "dep-other", "node_dep_other").token!;
73
+ expect((await send(otherNode, "GET", D())).status).toBe(403);
74
+ });
75
+
76
+ test("only network owner / admin (and hub admin) can write", async () => {
77
+ expect((await send(U.admin.token, "POST", D(), { name: "管理员建的" })).status).toBe(201);
78
+ for (const who of ["member", "viewer", "node", "outsider"]) {
79
+ expect((await send(U[who].token, "POST", D(), { name: `不该建-${who}` })).status).toBe(403);
80
+ }
81
+ const anyDept = (await list()).departments[0].id;
82
+ expect((await send(U.member.token, "PATCH", `${D()}/${anyDept}`, { name: "x" })).status).toBe(403);
83
+ expect((await send(U.member.token, "DELETE", `${D()}/${anyDept}`)).status).toBe(403);
84
+ expect((await send(U.member.token, "PUT", `/api/networks/${NET}/members/${U.member.id}/department`, { department_id: anyDept })).status).toBe(403);
85
+ });
86
+ });
87
+
88
+ describe("departments", () => {
89
+ test("create: top level and child, auto id and custom id, sibling names unique, validation", async () => {
90
+ const top = await mk("军团基建");
91
+ expect(top.id).toMatch(/^dept_/);
92
+ expect(top.parent_id).toBeNull();
93
+ const child = await mk("前端组", { parent_id: top.id, id: "fe-team" });
94
+ expect(child.id).toBe("fe-team");
95
+ expect(child.parent_id).toBe(top.id);
96
+ expect((await send(U.owner.token, "POST", D(), { name: "前端组", parent_id: top.id })).status).toBe(409);
97
+ expect((await send(U.owner.token, "POST", D(), { name: "前端组" })).status).toBe(201); // same name under another parent is fine
98
+ expect((await send(U.owner.token, "POST", D(), { name: "另一个", id: "fe-team" })).body.error).toBe("department_id_taken");
99
+ expect((await send(U.owner.token, "POST", D(), { name: " " })).body.error).toBe("invalid_department_name");
100
+ expect((await send(U.owner.token, "POST", D(), { name: "x".repeat(41) })).body.error).toBe("invalid_department_name");
101
+ expect((await send(U.owner.token, "POST", D(), { name: "坏 id", id: "has space" })).body.error).toBe("invalid_department_id");
102
+ expect((await send(U.owner.token, "POST", D(), { name: "孤儿", parent_id: "nope" })).body.error).toBe("parent_not_found");
103
+ expect((await send(U.owner.token, "POST", D(), { name: "外人负责", leader_user_id: U.outsider.id })).body.error).toBe("leader_not_member");
104
+ });
105
+
106
+ test("rename, move (no cycles, depth ≤ 10), set / clear leader, sort", async () => {
107
+ const a = await mk("移动甲");
108
+ const b = await mk("移动乙", { parent_id: a.id });
109
+ const c = await mk("移动丙", { parent_id: b.id });
110
+ expect((await send(U.owner.token, "PATCH", `${D()}/${a.id}`, { parent_id: c.id })).body.error).toBe("department_cycle");
111
+ expect((await send(U.owner.token, "PATCH", `${D()}/${a.id}`, { parent_id: a.id })).body.error).toBe("department_cycle");
112
+ const moved = await send(U.owner.token, "PATCH", `${D()}/${c.id}`, { parent_id: null, name: "移动丙(顶层)" });
113
+ expect(moved.status).toBe(200);
114
+ expect(moved.body.department.parent_id).toBeNull();
115
+ expect(moved.body.department.name).toBe("移动丙(顶层)");
116
+ const led = await send(U.owner.token, "PATCH", `${D()}/${b.id}`, { leader_user_id: U.member.id, sort: 5 });
117
+ expect(led.body.department.leader_user_id).toBe(U.member.id);
118
+ expect(led.body.department.sort).toBe(5);
119
+ expect((await send(U.owner.token, "PATCH", `${D()}/${b.id}`, { leader_user_id: null })).body.department.leader_user_id).toBeNull();
120
+ expect((await send(U.owner.token, "PATCH", `${D()}/${b.id}`, {})).body.error).toBe("empty_patch");
121
+ expect((await send(U.owner.token, "PATCH", `${D()}/missing`, { name: "x" })).status).toBe(404);
122
+ // depth: a chain of 10 is fine, the 11th level is refused (create and move)
123
+ let parent: string | null = null;
124
+ const chain: string[] = [];
125
+ for (let i = 0; i < 10; i++) { const d = await mk(`层${i}`, parent ? { parent_id: parent } : {}); chain.push(d.id); parent = d.id; }
126
+ expect((await send(U.owner.token, "POST", D(), { name: "第11层", parent_id: parent })).body.error).toBe("department_too_deep");
127
+ const two = await mk("两层");
128
+ await mk("两层的子", { parent_id: two.id });
129
+ expect((await send(U.owner.token, "PATCH", `${D()}/${two.id}`, { parent_id: chain[8] })).body.error).toBe("department_too_deep");
130
+ });
131
+
132
+ test("members: put into a department, counts, unassign; /members (admin list) carries department_id, /humans unchanged", async () => {
133
+ const team = await mk("成员测试部");
134
+ expect((await send(U.owner.token, "PUT", `/api/networks/${NET}/members/${U.member.id}/department`, { department_id: team.id })).body.department_id).toBe(team.id);
135
+ expect((await send(U.owner.token, "PUT", `/api/networks/${NET}/members/${U.viewer.id}/department`, { department_id: team.id })).status).toBe(200);
136
+ const l = await list("member");
137
+ expect(l.departments.find((d: any) => d.id === team.id).member_count).toBe(2);
138
+ expect(l.members.find((m: any) => m.user_id === U.member.id).department_id).toBe(team.id);
139
+ expect(l.members.find((m: any) => m.user_id === U.owner.id).department_id).toBeNull();
140
+ // /humans stays identity-only (its key set is pinned by member-presence / agent-acl tests): who sits where comes
141
+ // from GET …/departments (members[]), which every member can read.
142
+ const humans = await send(U.viewer.token, "GET", `/api/networks/${NET}/humans`);
143
+ expect(humans.body.humans.find((h: any) => h.user_id === U.member.id).department_id).toBeUndefined();
144
+ const members = await send(U.owner.token, "GET", `/api/networks/${NET}/members`);
145
+ const row = members.body.members.find((m: any) => m.user_id === U.member.id);
146
+ expect(row.department_id).toBe(team.id);
147
+ for (const k of ["user_id", "role", "username", "agent_access", "task_access"]) expect(row).toHaveProperty(k); // old fields unchanged
148
+ expect((await send(U.owner.token, "PUT", `/api/networks/${NET}/members/${U.outsider.id}/department`, { department_id: team.id })).status).toBe(404);
149
+ expect((await send(U.owner.token, "PUT", `/api/networks/${NET}/members/${U.member.id}/department`, { department_id: "nope" })).body.error).toBe("department_not_found");
150
+ expect((await send(U.owner.token, "PUT", `/api/networks/${NET}/members/${U.viewer.id}/department`, { department_id: null })).body.department_id).toBeNull();
151
+ });
152
+
153
+ test("delete only when empty (no sub-departments, no members), with the counts", async () => {
154
+ const parent = await mk("删除测试部");
155
+ const kid = await mk("删除测试子部", { parent_id: parent.id });
156
+ await send(U.owner.token, "PUT", `/api/networks/${NET}/members/${U.admin.id}/department`, { department_id: parent.id });
157
+ const blocked = await send(U.owner.token, "DELETE", `${D()}/${parent.id}`);
158
+ expect(blocked.status).toBe(409);
159
+ expect(blocked.body).toMatchObject({ error: "department_not_empty", children: 1, members: 1 });
160
+ expect((await send(U.owner.token, "DELETE", `${D()}/${kid.id}`)).status).toBe(200);
161
+ await send(U.owner.token, "PUT", `/api/networks/${NET}/members/${U.admin.id}/department`, { department_id: null });
162
+ expect((await send(U.owner.token, "DELETE", `${D()}/${parent.id}`)).status).toBe(200);
163
+ expect((await list()).departments.some((d: any) => d.id === parent.id)).toBe(false);
164
+ expect((await send(U.owner.token, "DELETE", `${D()}/${parent.id}`)).status).toBe(404);
165
+ });
166
+
167
+ test("a leader who leaves the network reads as no leader", async () => {
168
+ const stamp = Date.now();
169
+ expect((await send(U.owner.token, "POST", "/api/admin/users", { username: `dep_leaver_${stamp}`, password: PW, network_id: NET, role: "member" })).status).toBe(200);
170
+ const leaver = (await send("", "POST", "/api/auth/login", { username: `dep_leaver_${stamp}`, password: PW })).body.user.user_id as string;
171
+ const d = await mk("负责人会走", { leader_user_id: leaver });
172
+ expect(d).toBeTruthy();
173
+ expect((await send(U.owner.token, "DELETE", `/api/networks/${NET}/members/${leaver}`)).status).toBe(200);
174
+ expect((await list()).departments.find((x: any) => x.id === d.id).leader_user_id).toBeNull();
175
+ });
176
+
177
+ test("deleting a network removes its departments", async () => {
178
+ const r = register(`dep_gone_${Date.now()}`, PW);
179
+ const net = r.network_id!;
180
+ expect((await send(r.token!, "POST", `/api/networks/${net}/departments`, { name: "会被删" })).status).toBe(201);
181
+ expect(db.get("SELECT 1 AS x FROM network_departments WHERE network_id = ?1", net)).toBeTruthy();
182
+ expect((await send(r.token!, "DELETE", `/api/networks/${net}`)).status).toBe(200);
183
+ expect(db.get("SELECT 1 AS x FROM network_departments WHERE network_id = ?1", net)).toBeFalsy();
184
+ });
185
+ });
@@ -0,0 +1,128 @@
1
+ // #1894 —— 组织架构的 MCP 面:Agent 用 API 就能建部门、把 Agent 归进去,
2
+ // 不用人手动点。这里跑的是真实的 in-process MCP transport(不是直接调函数),
3
+ // 因为要验的正是「工具真的注册上、参数真的能过 schema、权限真的按 caller 判」。
4
+ import { afterAll, beforeEach, describe, expect, test } from "bun:test";
5
+ import { Client } from "@modelcontextprotocol/sdk/client/index.js";
6
+ import { InMemoryTransport } from "@modelcontextprotocol/sdk/inMemory.js";
7
+ import { McpServer } from "@modelcontextprotocol/sdk/server/mcp.js";
8
+ import { db } from "./db.js";
9
+ import { registerTools } from "./tools.js";
10
+
11
+ const NET = "net_dept_mcp";
12
+ const OWNER = "u_dept_mcp_owner";
13
+ const OTHER = "u_dept_mcp_other";
14
+ const AGENT_A = "n_dept_mcp_a";
15
+ const AGENT_B = "n_dept_mcp_b";
16
+
17
+ function cleanup() {
18
+ for (const [table, col] of [
19
+ ["audit_log", "network_id"], ["nodes", "network_id"], ["network_departments", "network_id"],
20
+ ["network_members", "network_id"], ["networks", "network_id"],
21
+ ] as const) {
22
+ try { db.run(`DELETE FROM ${table} WHERE ${col} = ?1`, [NET]); } catch {}
23
+ }
24
+ try { db.run("DELETE FROM users WHERE user_id IN (?1, ?2)", [OWNER, OTHER]); } catch {}
25
+ }
26
+
27
+ function seed() {
28
+ cleanup();
29
+ db.run("INSERT INTO users (user_id, username, password_hash, role, created_at) VALUES (?1, ?2, 'x', 'user', datetime('now'))", [OWNER, OWNER]);
30
+ db.run("INSERT INTO users (user_id, username, password_hash, role, created_at) VALUES (?1, ?2, 'x', 'user', datetime('now'))", [OTHER, OTHER]);
31
+ db.run("INSERT INTO networks (network_id, network_name, owner_id, created_at) VALUES (?1, ?2, ?3, datetime('now'))", [NET, NET, OWNER]);
32
+ db.run("INSERT INTO network_members (user_id, network_id, role, joined_at) VALUES (?1, ?2, 'owner', datetime('now'))", [OWNER, NET]);
33
+ db.run("INSERT INTO network_members (user_id, network_id, role, joined_at) VALUES (?1, ?2, 'member', datetime('now'))", [OTHER, NET]);
34
+ for (const [id, alias] of [[AGENT_A, "dept-agent-a"], [AGENT_B, "dept-agent-b"]] as const) {
35
+ db.run("INSERT INTO nodes (node_id, node_name, alias, network_id, created_at, updated_at) VALUES (?1, ?2, ?2, ?3, datetime('now'), datetime('now'))", [id, alias, NET]);
36
+ }
37
+ }
38
+
39
+ async function connect(callerUserId: string, alias = "dept-agent-a") {
40
+ const server = new McpServer({ name: "dept-mcp-test", version: "1" });
41
+ registerTools(server, undefined, NET, callerUserId, alias, true, null);
42
+ const client = new Client({ name: "dept-mcp-client", version: "1" });
43
+ const [ct, st] = InMemoryTransport.createLinkedPair();
44
+ await server.connect(st);
45
+ await client.connect(ct);
46
+ return { client, server };
47
+ }
48
+
49
+ type Result = { content: Array<{ type: string; text?: string }>; isError?: boolean };
50
+ const json = (r: Result) => JSON.parse(String(r.content[0]?.text ?? "{}"));
51
+
52
+ beforeEach(seed);
53
+ afterAll(cleanup);
54
+
55
+ describe("#1894 departments over MCP", () => {
56
+ test("owner can list, create, assign and read back the counts", async () => {
57
+ const { client, server } = await connect(OWNER);
58
+ try {
59
+ const before = json(await client.callTool({ name: "departments", arguments: { action: "list" } }) as Result);
60
+ expect(before.ok).toBe(true);
61
+ expect(before.unassigned_agents).toBe(2);
62
+
63
+ const created = json(await client.callTool({
64
+ name: "departments", arguments: { action: "create", name: "TMAI", department_id: "dept_test_tmai" },
65
+ }) as Result);
66
+ expect(created.ok).toBe(true);
67
+ expect(created.department.id).toBe("dept_test_tmai");
68
+
69
+ const child = json(await client.callTool({
70
+ name: "departments", arguments: { action: "create", name: "TMAI-内容", parent_id: "dept_test_tmai" },
71
+ }) as Result);
72
+ expect(child.ok).toBe(true);
73
+ expect(child.department.parent_id).toBe("dept_test_tmai");
74
+
75
+ const assigned = json(await client.callTool({
76
+ name: "departments", arguments: { action: "assign_agent", alias: "dept-agent-a", department_id: "dept_test_tmai" },
77
+ }) as Result);
78
+ expect(assigned.ok).toBe(true);
79
+ expect(assigned.node_id).toBe(AGENT_A);
80
+
81
+ const after = json(await client.callTool({ name: "departments", arguments: { action: "list" } }) as Result);
82
+ expect(after.unassigned_agents).toBe(1);
83
+ const tmai = after.departments.find((d: any) => d.id === "dept_test_tmai");
84
+ expect(tmai.agent_count).toBe(1);
85
+ const agent = after.agents.find((a: any) => a.node_id === AGENT_A);
86
+ expect(agent.department_id).toBe("dept_test_tmai");
87
+
88
+ // 清空归属同样要能通过 API 做
89
+ const cleared = json(await client.callTool({
90
+ name: "departments", arguments: { action: "assign_agent", node_id: AGENT_A, department_id: null },
91
+ }) as Result);
92
+ expect(cleared.ok).toBe(true);
93
+ expect(cleared.department_id).toBeNull();
94
+ } finally {
95
+ await server.close();
96
+ }
97
+ });
98
+
99
+ test("a plain member cannot write departments", async () => {
100
+ const { client, server } = await connect(OTHER, "dept-agent-b");
101
+ try {
102
+ const read = json(await client.callTool({ name: "departments", arguments: { action: "list" } }) as Result);
103
+ expect(read.ok).toBe(true);
104
+ const created = json(await client.callTool({
105
+ name: "departments", arguments: { action: "create", name: "不该被建出来" },
106
+ }) as Result);
107
+ expect(created.ok).toBe(false);
108
+ const assigned = json(await client.callTool({
109
+ name: "departments", arguments: { action: "assign_agent", node_id: AGENT_B, department_id: null },
110
+ }) as Result);
111
+ expect(assigned.ok).toBe(false);
112
+ } finally {
113
+ await server.close();
114
+ }
115
+ });
116
+
117
+ test("deleting a department that still has agents is refused", async () => {
118
+ const { client, server } = await connect(OWNER);
119
+ try {
120
+ json(await client.callTool({ name: "departments", arguments: { action: "create", name: "B 站", department_id: "dept_test_b" } }) as Result);
121
+ json(await client.callTool({ name: "departments", arguments: { action: "assign_agent", node_id: AGENT_B, department_id: "dept_test_b" } }) as Result);
122
+ const refused = json(await client.callTool({ name: "departments", arguments: { action: "delete", department_id: "dept_test_b" } }) as Result);
123
+ expect(refused.ok).toBe(false);
124
+ } finally {
125
+ await server.close();
126
+ }
127
+ });
128
+ });