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

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
Files changed (444) hide show
  1. package/README.md +120 -3
  2. package/bin/commhub.ts +93 -9
  3. package/build-info.json +7 -0
  4. package/package.json +10 -8
  5. package/src/ack-create-request-transport.test.ts +182 -0
  6. package/src/ack-create-request.test.ts +52 -8
  7. package/src/admin-delete-network-http.test.ts +229 -0
  8. package/src/admin-networks-http.test.ts +88 -0
  9. package/src/adoption-candidates-http.test.ts +140 -0
  10. package/src/adoption-candidates.ts +158 -0
  11. package/src/agent-access-batch.test.ts +210 -0
  12. package/src/agent-access.ts +585 -0
  13. package/src/agent-acl-groups-http.test.ts +247 -0
  14. package/src/agent-acl-http.test.ts +691 -0
  15. package/src/agent-acl-slice3-http.test.ts +885 -0
  16. package/src/agent-department-grants.test.ts +129 -0
  17. package/src/agent-department-http.test.ts +215 -0
  18. package/src/agent-groups-perf.test.ts +223 -0
  19. package/src/agent-notice.ts +48 -0
  20. package/src/agent-team-whoami-http.test.ts +98 -0
  21. package/src/agent-teams-http.test.ts +330 -0
  22. package/src/agent-teams.ts +244 -0
  23. package/src/alias-baseline-2571.test.ts +162 -0
  24. package/src/alias-baseline.ts +113 -0
  25. package/src/alias-filter.test.ts +72 -0
  26. package/src/alias-filter.ts +42 -0
  27. package/src/api-host-supervisors-can-create-nodes.test.ts +350 -0
  28. package/src/api-host-supervisors-fallback.test.ts +6 -7
  29. package/src/api-host-supervisors-runtime-readiness.test.ts +195 -0
  30. package/src/api-nodes-shape.test.ts +131 -4
  31. package/src/auth-abuse-counters.test.ts +144 -0
  32. package/src/auth-abuse-counters.ts +122 -0
  33. package/src/auth-layer-shape.test.ts +105 -0
  34. package/src/auth-password-change-cli-tokens-http.test.ts +423 -0
  35. package/src/auth-sessions-http.test.ts +260 -0
  36. package/src/auth-validate.test.ts +5 -1
  37. package/src/auth-weak-password-login.test.ts +176 -0
  38. package/src/auth.ts +641 -68
  39. package/src/backfill-node-ids-2664.test.ts +128 -0
  40. package/src/binding-generation-http.test.ts +141 -0
  41. package/src/blocked-exit-on-reply.test.ts +122 -0
  42. package/src/broadcast-fanout-2721.test.ts +149 -0
  43. package/src/broadcast-fanout.ts +117 -0
  44. package/src/build-commit-report-http.test.ts +128 -0
  45. package/src/build-info.test.ts +60 -0
  46. package/src/build-info.ts +85 -0
  47. package/src/chain-attempt-dedup.test.ts +447 -0
  48. package/src/clip.test.ts +36 -0
  49. package/src/clip.ts +48 -0
  50. package/src/clone-node.test.ts +269 -0
  51. package/src/clone-node.ts +289 -0
  52. package/src/codex-config-flags.ts +77 -0
  53. package/src/codex-fork-contract.ts +23 -0
  54. package/src/codex-fork-migration.test.ts +38 -0
  55. package/src/commhub-bin-args.test.ts +85 -0
  56. package/src/config-apply-validate.test.ts +188 -1
  57. package/src/config-apply-validate.ts +222 -3
  58. package/src/cors-origins.test.ts +73 -0
  59. package/src/create-node-blocked-gate.test.ts +365 -0
  60. package/src/create-node-error-domain.test.ts +127 -0
  61. package/src/create-node-network-id.test.ts +91 -0
  62. package/src/create-node-tool-schema.test.ts +49 -0
  63. package/src/create-node-unicode-name.test.ts +126 -0
  64. package/src/create-node-validate.test.ts +199 -7
  65. package/src/create-node-validate.ts +232 -15
  66. package/src/create-node-workdir.test.ts +298 -0
  67. package/src/create-node.ts +88 -23
  68. package/src/daemon-provider-snapshots.test.ts +453 -0
  69. package/src/daemon-provider-snapshots.ts +327 -0
  70. package/src/daemon-token-owner-http.test.ts +346 -0
  71. package/src/dashboard-slash-routing-http.test.ts +109 -0
  72. package/src/db-adapter-guard.test.ts +148 -0
  73. package/src/db-adapter-translate.test.ts +128 -0
  74. package/src/db-adapter.ts +377 -91
  75. package/src/db-timestamp.test.ts +38 -0
  76. package/src/db-timestamp.ts +15 -0
  77. package/src/db.ts +1298 -153
  78. package/src/delivered-without-push.test.ts +140 -0
  79. package/src/department-groups-http.test.ts +209 -0
  80. package/src/department-groups-sync-http.test.ts +328 -0
  81. package/src/department-groups.ts +434 -0
  82. package/src/department-heads-http.test.ts +350 -0
  83. package/src/department-heads.ts +226 -0
  84. package/src/departments-agent-count.test.ts +139 -0
  85. package/src/departments-http.test.ts +185 -0
  86. package/src/departments-mcp-error-domain.test.ts +135 -0
  87. package/src/departments-mcp.test.ts +128 -0
  88. package/src/departments.ts +318 -0
  89. package/src/desktop-message-seam.test.ts +150 -0
  90. package/src/desktop-message.test.ts +368 -0
  91. package/src/dm-file-scope-http.test.ts +227 -0
  92. package/src/empty-node-sweeper.test.ts +104 -0
  93. package/src/empty-node-sweeper.ts +88 -0
  94. package/src/env-transport-gate-http.test.ts +240 -0
  95. package/src/env-transport-gate.ts +80 -0
  96. package/src/env-transport-policy.ts +56 -0
  97. package/src/etag-of.test.ts +57 -0
  98. package/src/event-loop-lag.test.ts +180 -0
  99. package/src/event-loop-lag.ts +201 -0
  100. package/src/expiry-counters.test.ts +187 -0
  101. package/src/expiry-counters.ts +227 -0
  102. package/src/expiry-evidence-db.test.ts +103 -0
  103. package/src/ext-token-shared.test.ts +60 -0
  104. package/src/ext-validation-regression.test.ts +10 -17
  105. package/src/external-schedule-edits-http.test.ts +321 -0
  106. package/src/external-schedule-edits-timestamps.test.ts +64 -0
  107. package/src/external-schedule-edits.ts +327 -0
  108. package/src/file-download-authz-dev-open.test.ts +1 -1
  109. package/src/file-download-authz.test.ts +25 -4
  110. package/src/file-download-date-bucket.test.ts +1 -1
  111. package/src/file-network-scope-dev-open.test.ts +1 -1
  112. package/src/file-network-scope.test.ts +7 -6
  113. package/src/group-membership-events-http.test.ts +264 -0
  114. package/src/group-messages-http.test.ts +483 -0
  115. package/src/group-messages.ts +297 -0
  116. package/src/health-anon-readers.ts +67 -0
  117. package/src/health-host-disk-2756.test.ts +71 -0
  118. package/src/health-identity-root.test.ts +98 -0
  119. package/src/health-redaction.test.ts +1599 -7
  120. package/src/health-status-reasons.test.ts +84 -0
  121. package/src/host-supervisor-identity-http.test.ts +152 -0
  122. package/src/host-supervisor-identity.ts +92 -0
  123. package/src/host-supervisors-daemon-version.test.ts +137 -0
  124. package/src/http-gzip.test.ts +94 -0
  125. package/src/http-gzip.ts +112 -0
  126. package/src/hub-catalog-read-http.test.ts +664 -0
  127. package/src/hub-provider-config.test.ts +166 -0
  128. package/src/hub-provider-config.ts +202 -0
  129. package/src/hub-timestamp.test.ts +38 -0
  130. package/src/hub-timestamp.ts +27 -0
  131. package/src/human-dm.ts +215 -0
  132. package/src/human-inbox.ts +42 -0
  133. package/src/inbox-caller.ts +49 -0
  134. package/src/inbox-count-sse.test.ts +318 -0
  135. package/src/inbox-count.ts +29 -0
  136. package/src/index.ts +6 -2
  137. package/src/license-state.test.ts +105 -0
  138. package/src/license-state.ts +48 -0
  139. package/src/lifecycle-error-domain.test.ts +149 -0
  140. package/src/list-ack-error-domain.test.ts +108 -0
  141. package/src/list-host-supervisors.test.ts +15 -4
  142. package/src/list-tasks-omit-default.test.ts +84 -0
  143. package/src/list-tasks-since-last.test.ts +100 -0
  144. package/src/list-tasks-since.test.ts +104 -0
  145. package/src/mcp-context-cost-http.test.ts +127 -0
  146. package/src/mcp-inflight.test.ts +92 -0
  147. package/src/mcp-inflight.ts +38 -0
  148. package/src/mcp-projects-events-http.test.ts +168 -0
  149. package/src/mcp-route-label-http.test.ts +120 -0
  150. package/src/mcp-write-network-resolution.test.ts +21 -0
  151. package/src/member-audit-network-id-http.test.ts +93 -0
  152. package/src/member-presence-http.test.ts +210 -0
  153. package/src/messages-ack-by-agent-http.test.ts +142 -0
  154. package/src/migrate-sqlite-to-pg.test.ts +47 -0
  155. package/src/migrate-sqlite-to-pg.ts +263 -0
  156. package/src/model-auth-notify-http.test.ts +181 -0
  157. package/src/model-auth-notify.ts +116 -0
  158. package/src/network-name-http.test.ts +75 -0
  159. package/src/network-quota-config.test.ts +100 -0
  160. package/src/network-rules-http.test.ts +169 -0
  161. package/src/network-rules.ts +129 -0
  162. package/src/network-scope.ts +222 -3
  163. package/src/network-token-membership-http.test.ts +186 -0
  164. package/src/node-alias-control.ts +12 -0
  165. package/src/node-attrs.test.ts +47 -2
  166. package/src/node-caller-identity-http.test.ts +1108 -0
  167. package/src/node-config-last-update.test.ts +126 -0
  168. package/src/node-config-last-update.ts +107 -0
  169. package/src/node-create-request-status-http.test.ts +105 -0
  170. package/src/node-daemon-bindings.test.ts +142 -0
  171. package/src/node-daemon-bindings.ts +135 -0
  172. package/src/node-failure-alert.test.ts +150 -0
  173. package/src/node-failure-alert.ts +177 -0
  174. package/src/node-files-transport.test.ts +350 -0
  175. package/src/node-health-codex-login.test.ts +120 -0
  176. package/src/node-health-dispatch-http.test.ts +373 -0
  177. package/src/node-health-guard-origin.test.ts +98 -0
  178. package/src/node-health-guard.ts +121 -0
  179. package/src/node-health-passthrough.test.ts +115 -0
  180. package/src/node-health-store.ts +101 -0
  181. package/src/node-id-alias.test.ts +190 -0
  182. package/src/node-identity-conflict-http.test.ts +269 -0
  183. package/src/node-identity-conflict.ts +142 -0
  184. package/src/node-identity-mismatch.test.ts +74 -0
  185. package/src/node-in-flight-tasks.ts +31 -0
  186. package/src/node-lifecycle-controllable.test.ts +64 -0
  187. package/src/node-lifecycle-controllable.ts +53 -0
  188. package/src/node-lifecycle-read-http.test.ts +257 -0
  189. package/src/node-lifecycle-read.ts +124 -0
  190. package/src/node-logs-transport.test.ts +266 -0
  191. package/src/node-peer-allowlist.test.ts +114 -0
  192. package/src/node-permissions-http.test.ts +901 -0
  193. package/src/node-permissions.ts +494 -0
  194. package/src/node-request-retention.test.ts +281 -0
  195. package/src/node-request-retention.ts +120 -0
  196. package/src/node-secret-rest-http.test.ts +190 -0
  197. package/src/node-secret-vault-inject.test.ts +132 -0
  198. package/src/node-security-write-gate.test.ts +72 -0
  199. package/src/node-serviceability.test.ts +86 -0
  200. package/src/node-serviceability.ts +124 -0
  201. package/src/node-session-control-http.test.ts +310 -0
  202. package/src/node-session-control.ts +258 -0
  203. package/src/node-skills-transport.test.ts +212 -0
  204. package/src/node-token-identity.ts +35 -0
  205. package/src/node-token-ownership.ts +51 -0
  206. package/src/node-token-privilege-http.test.ts +224 -0
  207. package/src/not-found-api-http.test.ts +67 -0
  208. package/src/observer-avatar-http.test.ts +103 -10
  209. package/src/observer-push.test.ts +76 -0
  210. package/src/opencode-catalog-report-http.test.ts +139 -0
  211. package/src/opencode-v2-catalog.test.ts +268 -0
  212. package/src/opencode-v2-catalog.ts +356 -0
  213. package/src/package-version-consistency.test.ts +25 -0
  214. package/src/parent-infer.test.ts +82 -0
  215. package/src/parent-infer.ts +110 -0
  216. package/src/parent-source-marker.test.ts +70 -0
  217. package/src/parent-source-orphan.test.ts +121 -0
  218. package/src/password-network-tokens.ts +25 -0
  219. package/src/peer-reply-atomic.test.ts +462 -0
  220. package/src/peer-reply-capability.test.ts +70 -0
  221. package/src/pg-worker.ts +87 -0
  222. package/src/poll-pacing.test.ts +74 -0
  223. package/src/poll-pacing.ts +123 -0
  224. package/src/probe-provider-error-domain.test.ts +145 -0
  225. package/src/project-dir-warn-clear-http.test.ts +132 -0
  226. package/src/project-viewer-can-http.test.ts +116 -0
  227. package/src/provider-skill-error-domain.test.ts +130 -0
  228. package/src/provider-tools-shape.test.ts +165 -0
  229. package/src/push.test.ts +20 -10
  230. package/src/push.ts +373 -9
  231. package/src/redact-tokens.test.ts +86 -0
  232. package/src/redact-tokens.ts +43 -0
  233. package/src/rejection-counters.test.ts +72 -0
  234. package/src/rejection-counters.ts +173 -0
  235. package/src/rename.ts +38 -10
  236. package/src/reply-target-derivation.test.ts +96 -0
  237. package/src/report-status-handover-capabilities-http.test.ts +124 -0
  238. package/src/report-status-host-schema.test.ts +235 -0
  239. package/src/report-status-resume-id-handover.test.ts +184 -0
  240. package/src/report-status-secret-keys.test.ts +140 -0
  241. package/src/require-explicit-test-db.ts +9 -0
  242. package/src/requirement-due-reminders-http.test.ts +620 -0
  243. package/src/requirement-due-reminders.ts +416 -0
  244. package/src/requirement-events-http.test.ts +318 -0
  245. package/src/requirement-events.test.ts +45 -0
  246. package/src/requirement-events.ts +144 -0
  247. package/src/requirement-notify.ts +165 -0
  248. package/src/requirement-participant-notify-http.test.ts +313 -0
  249. package/src/requirement-tag-ops-http.test.ts +454 -0
  250. package/src/requirement-tag-tree-http.test.ts +275 -0
  251. package/src/requirement-tag-tree.ts +127 -0
  252. package/src/requirement-tags.ts +102 -0
  253. package/src/requirements-abandoned-http.test.ts +236 -0
  254. package/src/requirements-assignee-drift.test.ts +154 -0
  255. package/src/requirements-comment-http.test.ts +174 -0
  256. package/src/requirements-completed-at-migration.test.ts +70 -0
  257. package/src/requirements-errors-mcp-http.test.ts +164 -0
  258. package/src/requirements-errors.ts +158 -0
  259. package/src/requirements-etag-http.test.ts +91 -0
  260. package/src/requirements-http.test.ts +709 -0
  261. package/src/requirements-last-event-http.test.ts +349 -0
  262. package/src/requirements-list-mcp-slim-http.test.ts +155 -0
  263. package/src/requirements-list-slim-http.test.ts +324 -0
  264. package/src/requirements-mcp.test.ts +180 -0
  265. package/src/requirements-migrate.ts +283 -0
  266. package/src/requirements-owner-strict-mcp-http.test.ts +145 -0
  267. package/src/requirements-people-http.test.ts +114 -0
  268. package/src/requirements-people-mcp-http.test.ts +231 -0
  269. package/src/requirements-people.ts +196 -0
  270. package/src/requirements-priority-lowest.test.ts +114 -0
  271. package/src/requirements-projects-network-echo.test.ts +57 -0
  272. package/src/requirements-projects-parent-http.test.ts +123 -0
  273. package/src/requirements-search-http.test.ts +182 -0
  274. package/src/requirements-search.test.ts +32 -0
  275. package/src/requirements-search.ts +145 -0
  276. package/src/requirements-seq-http.test.ts +193 -0
  277. package/src/requirements-seq-migration.test.ts +63 -0
  278. package/src/requirements-start-date.test.ts +125 -0
  279. package/src/requirements-stats-http.test.ts +357 -0
  280. package/src/requirements-stats.ts +195 -0
  281. package/src/requirements-status-participants-http.test.ts +222 -0
  282. package/src/requirements-upgrade-e2e.test.ts +126 -0
  283. package/src/requirements-upgrade-migration.test.ts +98 -0
  284. package/src/requirements.ts +2205 -0
  285. package/src/resolve-port.test.ts +57 -0
  286. package/src/resolve-port.ts +44 -0
  287. package/src/rest-alias-network-fallback-http.test.ts +123 -0
  288. package/src/rest-alias-network-fallback.test.ts +60 -0
  289. package/src/rest-alias-network-fallback.ts +65 -0
  290. package/src/rest-explicit-columns-http.test.ts +266 -0
  291. package/src/rest-identity.test.ts +130 -0
  292. package/src/rest-identity.ts +141 -0
  293. package/src/rest-projections.ts +72 -0
  294. package/src/rest-read-network-real-chain.test.ts +97 -0
  295. package/src/rest-write-network-resolution.test.ts +133 -0
  296. package/src/restart-readiness-http.test.ts +121 -0
  297. package/src/restricted-files.ts +76 -0
  298. package/src/retention-first-sweep-quiet.test.ts +31 -0
  299. package/src/retention.test.ts +100 -40
  300. package/src/retention.ts +423 -104
  301. package/src/route-callers-http.test.ts +120 -0
  302. package/src/route-timing.test.ts +218 -0
  303. package/src/route-timing.ts +262 -0
  304. package/src/rules-file-duplicate-alias.test.ts +234 -0
  305. package/src/rules-file-session-target.test.ts +207 -0
  306. package/src/rules-file-transport.test.ts +271 -0
  307. package/src/runtime-label.test.ts +22 -0
  308. package/src/runtime-label.ts +21 -0
  309. package/src/runtime-readiness.ts +90 -0
  310. package/src/schedule-agent-mcp-http.test.ts +486 -0
  311. package/src/schedule-agent.ts +252 -0
  312. package/src/schedule-starved.test.ts +92 -0
  313. package/src/schedule-starved.ts +114 -0
  314. package/src/scheduled-backoff-http.test.ts +203 -0
  315. package/src/scheduled-backoff.ts +64 -0
  316. package/src/scheduled-doorbell-nodeless-session.test.ts +134 -0
  317. package/src/scheduled-failure-backoff-2622.test.ts +145 -0
  318. package/src/scheduled-failure-code.test.ts +73 -0
  319. package/src/scheduled-failure-code.ts +105 -0
  320. package/src/scheduled-failures-http.test.ts +279 -0
  321. package/src/scheduled-failures.ts +425 -0
  322. package/src/scheduled-noprogress-backoff-2622.test.ts +163 -0
  323. package/src/scheduled-offline-backoff-probe.test.ts +56 -0
  324. package/src/scheduled-offline.test.ts +131 -0
  325. package/src/scheduled-offline.ts +66 -0
  326. package/src/scheduled-outcome-guidance-http.test.ts +139 -0
  327. package/src/scheduled-outcome-guidance.ts +9 -0
  328. package/src/scheduled-reply-unread-http.test.ts +212 -0
  329. package/src/scheduled-requirement-wake-http.test.ts +289 -0
  330. package/src/scheduled-requirement-wake.ts +125 -0
  331. package/src/scheduled-run-terminal.test.ts +290 -0
  332. package/src/scheduled-skip-blocking-task.test.ts +120 -0
  333. package/src/scheduled-skip-path-backoff-2622.test.ts +98 -0
  334. package/src/scheduled-stuck-http.test.ts +316 -0
  335. package/src/scheduled-stuck-notice-cap.test.ts +80 -0
  336. package/src/scheduled-stuck.ts +219 -0
  337. package/src/scheduled-tasks-http.test.ts +679 -0
  338. package/src/scheduled-tasks.ts +959 -0
  339. package/src/scheduled-work-outcome-http.test.ts +154 -0
  340. package/src/scheduled-work-outcome.ts +50 -0
  341. package/src/scoped-secrets.ts +167 -0
  342. package/src/secret-echo-negative-control.test.ts +118 -0
  343. package/src/send-dedup-request-id.test.ts +229 -0
  344. package/src/send-reply-agent-warning.test.ts +38 -38
  345. package/src/send-reply-alias-optional.test.ts +131 -0
  346. package/src/send-reply-attachments.test.ts +28 -7
  347. package/src/send_dedup.test.ts +54 -0
  348. package/src/send_dedup.ts +52 -6
  349. package/src/serve-error.test.ts +73 -0
  350. package/src/serve-error.ts +56 -0
  351. package/src/server.ts +4930 -377
  352. package/src/session-task-on-dispatch.ts +14 -0
  353. package/src/session-token-ownership-http.test.ts +122 -0
  354. package/src/shared/codex-inventory.ts +41 -0
  355. package/src/shared/daemon-provider-login.ts +31 -0
  356. package/src/shared/daemon-provider-snapshot.ts +52 -0
  357. package/src/shared/external-schedule-contract.ts +60 -0
  358. package/src/shared/node-name.test.ts +62 -0
  359. package/src/shared/node-name.ts +161 -0
  360. package/src/shared/probe-host-allowlist-drift.test.ts +45 -0
  361. package/src/shared/provider-application.ts +29 -0
  362. package/src/shared/provider-collection.ts +14 -0
  363. package/src/shared/provider-initialization.ts +8 -0
  364. package/src/shared/reserved-env-drift.test.ts +10 -0
  365. package/src/shared/scoped-secret-contract.ts +5 -0
  366. package/src/shared/task-content-limit-drift.test.ts +28 -0
  367. package/src/shared/task-content-limit.ts +25 -0
  368. package/src/side-thread-command-transport.test.ts +312 -0
  369. package/src/side-thread-command-transport.ts +318 -0
  370. package/src/side-thread-http-integration.test.ts +233 -0
  371. package/src/side-thread-http.ts +504 -0
  372. package/src/side-thread-production.test.ts +72 -0
  373. package/src/side-thread-production.ts +118 -0
  374. package/src/side-thread.test.ts +1067 -0
  375. package/src/side-thread.ts +2499 -0
  376. package/src/skillhub-http.test.ts +144 -0
  377. package/src/sqlite-close-checkpoint.test.ts +78 -0
  378. package/src/start-node.test.ts +265 -0
  379. package/src/start-request-error-domain.test.ts +182 -0
  380. package/src/start-skill-error-domain.test.ts +122 -0
  381. package/src/stats-versions-http.test.ts +65 -0
  382. package/src/status-alias-filter-http.test.ts +106 -0
  383. package/src/status-alias-resolver-http.test.ts +163 -0
  384. package/src/status-alias-resolver.ts +19 -0
  385. package/src/status-node-id-filter-http.test.ts +161 -0
  386. package/src/status-read-cache-http.test.ts +229 -0
  387. package/src/status-read-cache.ts +129 -0
  388. package/src/stop-delete-node.test.ts +567 -1
  389. package/src/task-access-http.test.ts +407 -0
  390. package/src/task-access.ts +420 -0
  391. package/src/task-activity.ts +60 -0
  392. package/src/task-auth-origin-http.test.ts +93 -0
  393. package/src/task-auth-origin.test.ts +24 -0
  394. package/src/task-auth-origin.ts +7 -0
  395. package/src/task-consumption.test.ts +508 -0
  396. package/src/task-diagnostic-http.test.ts +149 -0
  397. package/src/task-diagnostic.test.ts +115 -0
  398. package/src/task-diagnostic.ts +118 -0
  399. package/src/task-expiry-notice-http.test.ts +298 -0
  400. package/src/task-expiry-notice.ts +318 -0
  401. package/src/task-idempotency-mcp.test.ts +148 -0
  402. package/src/task-idempotency.test.ts +76 -0
  403. package/src/task-idempotency.ts +81 -0
  404. package/src/task-late-replies.ts +54 -0
  405. package/src/task-late-reply-http.test.ts +227 -0
  406. package/src/task-lifecycle-watcher-busy.test.ts +114 -0
  407. package/src/task-lifecycle-watcher.test.ts +209 -0
  408. package/src/task-lifecycle-watcher.ts +109 -0
  409. package/src/task-network-resolution-http.test.ts +140 -0
  410. package/src/task-not-found-error-domain.test.ts +114 -0
  411. package/src/task-offline-delivery-2668.test.ts +119 -0
  412. package/src/task-offline-delivery.ts +81 -0
  413. package/src/task-orphan-http.test.ts +287 -0
  414. package/src/task-orphan.ts +119 -0
  415. package/src/task-queue-ahead-http.test.ts +309 -0
  416. package/src/task-queue-ahead-scale.test.ts +236 -0
  417. package/src/task-queue-ahead.ts +186 -0
  418. package/src/task-rejection-log-http.test.ts +160 -0
  419. package/src/task-rejection-log.ts +61 -0
  420. package/src/task-sender-http.test.ts +143 -0
  421. package/src/task-stale-open-http.test.ts +292 -0
  422. package/src/task-stale-open.ts +103 -0
  423. package/src/tasks-pagination-http.test.ts +141 -0
  424. package/src/team-rules-status-http.test.ts +90 -0
  425. package/src/team-rules-status.test.ts +59 -0
  426. package/src/team-rules-status.ts +72 -0
  427. package/src/tmux-allowlist.test.ts +48 -0
  428. package/src/tool-audience-http.test.ts +248 -0
  429. package/src/tool-audience.ts +127 -0
  430. package/src/tools-list-json-schema.test.ts +94 -0
  431. package/src/tools.ts +4314 -392
  432. package/src/update-node-config-error-domain.test.ts +107 -0
  433. package/src/uploads-http.test.ts +6 -4
  434. package/src/uploads.ts +23 -4
  435. package/src/user-avatar-http.test.ts +74 -0
  436. package/src/user-avatar-image.ts +160 -0
  437. package/src/user-avatar-migration.test.ts +25 -0
  438. package/src/user-avatar-upload-http.test.ts +353 -0
  439. package/src/user-inbox-by-agent-http.test.ts +189 -0
  440. package/src/user-inbox-netid-notnull.test.ts +122 -0
  441. package/src/user-inbox-read-http.test.ts +223 -0
  442. package/src/user-inbox-schema.test.ts +54 -0
  443. package/src/version-stats.test.ts +66 -0
  444. package/src/version-stats.ts +109 -0
@@ -0,0 +1,212 @@
1
+ // Node skills view — list_node_skills / read_node_skill ride the rules-file
2
+ // queue + doorbell (ops skills_list / skill_read).
3
+ //
4
+ // Hub-side contract verified here:
5
+ // 1. report_status { skills_capable: true } is sticky and set only by the
6
+ // session's own bound node token.
7
+ // 2. list_node_skills / read_node_skill reach a session with no nodes row by
8
+ // alias; the node pulls with its own token; read carries the skill NAME
9
+ // (never a path) in the pulled request; results come back through
10
+ // get_rules_file_result for both ops.
11
+ // 3. Bad skill names are refused before any request row exists.
12
+ // 4. A session that can serve rules files but did not report skills_capable is
13
+ // refused up front for skills ops (skills_target_not_found).
14
+ // 5. Separate single-flight lanes: a pending rules read does not block a skills
15
+ // list and vice versa; a second skills request while one is pending is refused.
16
+ // 6. Network isolation and foreign acks are ignored.
17
+ //
18
+ // 跑法:cd server && COMMHUB_DB=/tmp/skills-session.db bun test src/node-skills-transport.test.ts
19
+ import { afterAll, beforeEach, describe, expect, test } from "bun:test";
20
+ import { Client } from "@modelcontextprotocol/sdk/client/index.js";
21
+ import { InMemoryTransport } from "@modelcontextprotocol/sdk/inMemory.js";
22
+ import { McpServer } from "@modelcontextprotocol/sdk/server/mcp.js";
23
+ import { db } from "./db.js";
24
+ import { registerTools } from "./tools.js";
25
+
26
+ const NET = "net_skills_session";
27
+ const OTHER_NET = "net_skills_session_other";
28
+ const USER = "u_skills_session_owner";
29
+ const SESSION_ALIAS = "skills-session-cc";
30
+ const SESSION_RESUME = "cc-skills-session-1";
31
+ const OTHER_ALIAS = "skills-session-peer";
32
+ const NODE_ROW_ALIAS = "skills-session-noderow";
33
+ const NODE_ROW_ID = "node_skills_session_noderow";
34
+ const T_SESSION = "tok_skills_session_cc";
35
+ const T_PEER = "tok_skills_session_peer";
36
+ const T_OTHER_NET_SAME_ALIAS = "tok_skills_session_other_net";
37
+ const T_NODE_ROW = "tok_skills_session_noderow";
38
+
39
+ function cleanup() {
40
+ for (const net of [NET, OTHER_NET]) {
41
+ try { db.run("DELETE FROM node_rules_requests WHERE network_id = ?1", [net]); } catch {}
42
+ try { db.run("DELETE FROM sessions WHERE network_id = ?1", [net]); } catch {}
43
+ try { db.run("DELETE FROM nodes WHERE network_id = ?1", [net]); } catch {}
44
+ try { db.run("DELETE FROM api_tokens WHERE network_id = ?1", [net]); } catch {}
45
+ try { db.run("DELETE FROM network_members WHERE network_id = ?1", [net]); } catch {}
46
+ try { db.run("DELETE FROM networks WHERE network_id = ?1", [net]); } catch {}
47
+ }
48
+ try { db.run("DELETE FROM users WHERE user_id = ?1", [USER]); } catch {}
49
+ }
50
+
51
+ function seedWorld() {
52
+ db.run(`INSERT INTO users (user_id, username, password_hash, role, created_at) VALUES (?1, ?2, 'x', 'user', datetime('now'))`, [USER, USER]);
53
+ for (const net of [NET, OTHER_NET]) {
54
+ db.run(`INSERT INTO networks (network_id, network_name, owner_id, created_at) VALUES (?1, ?2, ?3, datetime('now'))`, [net, net, USER]);
55
+ db.run(`INSERT INTO network_members (user_id, network_id, role, joined_at) VALUES (?1, ?2, 'owner', datetime('now'))`, [USER, net]);
56
+ }
57
+ const tok = (id: string, net: string, alias: string) => db.run(
58
+ `INSERT INTO api_tokens (token_id, user_id, network_id, scope, name, token_hash, expires_at, revoked_at) VALUES (?1, ?2, ?3, 'network', ?4, ?5, NULL, NULL)`,
59
+ [id, USER, net, `node:${alias}`, `hash_${id}`],
60
+ );
61
+ tok(T_SESSION, NET, SESSION_ALIAS);
62
+ tok(T_PEER, NET, OTHER_ALIAS);
63
+ tok(T_OTHER_NET_SAME_ALIAS, OTHER_NET, SESSION_ALIAS);
64
+ tok(T_NODE_ROW, NET, NODE_ROW_ALIAS);
65
+ db.run(
66
+ `INSERT INTO nodes (node_id, node_name, alias, network_id, created_at, updated_at) VALUES (?1, ?2, ?3, ?4, datetime('now'), datetime('now'))`,
67
+ [NODE_ROW_ID, NODE_ROW_ALIAS, NODE_ROW_ALIAS, NET],
68
+ );
69
+ }
70
+
71
+ type Identity = { net: string; alias: string; isNetworkToken: boolean; tokenId: string };
72
+ const asUser: Identity = { net: NET, alias: USER, isNetworkToken: false, tokenId: "tok_skills_session_user" };
73
+ const asOtherNetUser: Identity = { net: OTHER_NET, alias: USER, isNetworkToken: false, tokenId: "tok_skills_session_user2" };
74
+ const asSession: Identity = { net: NET, alias: SESSION_ALIAS, isNetworkToken: true, tokenId: T_SESSION };
75
+ const asPeer: Identity = { net: NET, alias: OTHER_ALIAS, isNetworkToken: true, tokenId: T_PEER };
76
+ const asOtherNetSameAlias: Identity = { net: OTHER_NET, alias: SESSION_ALIAS, isNetworkToken: true, tokenId: T_OTHER_NET_SAME_ALIAS };
77
+ const asNodeRow: Identity = { net: NET, alias: NODE_ROW_ALIAS, isNetworkToken: true, tokenId: T_NODE_ROW };
78
+
79
+ async function connect(id: Identity) {
80
+ const server = new McpServer({ name: "skills-session-test", version: "1" });
81
+ registerTools(server, undefined, id.net, USER, id.alias, id.isNetworkToken, id.tokenId);
82
+ const client = new Client({ name: "skills-session-client", version: "1" });
83
+ const [ct, st] = InMemoryTransport.createLinkedPair();
84
+ await server.connect(st);
85
+ await client.connect(ct);
86
+ const call = async (name: string, args: Record<string, unknown>) => {
87
+ const r: any = await client.callTool({ name, arguments: args });
88
+ const first = r.content?.[0];
89
+ if (!first || first.type !== "text") throw new Error(`no text result from ${name}: ${JSON.stringify(r).slice(0, 300)}`);
90
+ return JSON.parse(first.text);
91
+ };
92
+ const close = async () => { await client.close(); await server.close(); };
93
+ return { call, close };
94
+ }
95
+
96
+ const capable = (alias: string, net = NET) =>
97
+ db.get<{ c: number }>("SELECT skills_capable AS c FROM sessions WHERE alias = ?1 AND network_id = ?2", alias, net)?.c;
98
+ const rowCount = () => db.get<{ n: number }>("SELECT COUNT(*) AS n FROM node_rules_requests WHERE network_id = ?1", NET)!.n;
99
+
100
+ async function registerSession(id: Identity, alias: string, resume: string, flag: boolean) {
101
+ const c = await connect(id);
102
+ try {
103
+ return await c.call("report_status", { resume_id: resume, alias, status: "idle", agent: "claude-code", ...(flag ? { rules_file_capable: true, skills_capable: true } : {}) });
104
+ } finally { await c.close(); }
105
+ }
106
+
107
+ beforeEach(() => { cleanup(); seedWorld(); });
108
+ afterAll(cleanup);
109
+
110
+ async function reportRulesOnly(id: Identity, alias: string, resume: string) {
111
+ const c = await connect(id);
112
+ try { return await c.call("report_status", { resume_id: resume, alias, status: "idle", agent: "claude-code", rules_file_capable: true }); }
113
+ finally { await c.close(); }
114
+ }
115
+
116
+ describe("skills_capable is set only by the session's own node token", () => {
117
+ test("bound token sets it; a report without it does not clear it; a peer cannot set it", async () => {
118
+ await registerSession(asSession, SESSION_ALIAS, SESSION_RESUME, true);
119
+ expect(capable(SESSION_ALIAS)).toBe(1);
120
+ await registerSession(asSession, SESSION_ALIAS, SESSION_RESUME, false);
121
+ expect(capable(SESSION_ALIAS)).toBe(1);
122
+ const r = await registerSession(asPeer, SESSION_ALIAS, SESSION_RESUME, true);
123
+ expect(r).toMatchObject({ ok: false });
124
+ }, 20_000);
125
+ });
126
+
127
+ describe("list / read by alias reach a session with no nodes row", () => {
128
+ test("list round trip: enqueue → pull (no content) → ack JSON → result carries it", async () => {
129
+ await registerSession(asSession, SESSION_ALIAS, SESSION_RESUME, true);
130
+ const u = await connect(asUser);
131
+ const s = await connect(asSession);
132
+ try {
133
+ const enq = await u.call("list_node_skills", { alias: SESSION_ALIAS });
134
+ expect(enq).toMatchObject({ ok: true, op: "skills_list" });
135
+ const pulled = await s.call("get_rules_file_request", {});
136
+ expect(pulled.request).toEqual({ request_id: enq.request_id, op: "skills_list" });
137
+ const payload = JSON.stringify({ skills: [{ name: "ship", scope: "project", path_rel: ".claude/skills/ship/SKILL.md", description: "d" }] });
138
+ expect(await s.call("ack_rules_file_request", { request_id: enq.request_id, status: "done", file_name: "skills", exists: true, content: payload })).toMatchObject({ ok: true, status: "done" });
139
+ const res = await u.call("get_rules_file_result", { request_id: enq.request_id });
140
+ expect(res).toMatchObject({ ok: true, op: "skills_list", status: "done", content: payload });
141
+ } finally { await u.close(); await s.close(); }
142
+ }, 20_000);
143
+
144
+ test("read round trip: the pulled request carries the skill name only", async () => {
145
+ await registerSession(asSession, SESSION_ALIAS, SESSION_RESUME, true);
146
+ const u = await connect(asUser);
147
+ const s = await connect(asSession);
148
+ try {
149
+ const enq = await u.call("read_node_skill", { alias: SESSION_ALIAS, name: "ship" });
150
+ expect(enq).toMatchObject({ ok: true, op: "skill_read" });
151
+ // 2026-10-31 —— **精确键集**(#3171):此前只 matchObject 了两个字段。
152
+ // 这条响应是「入队回执」,多一个键就意味着回执开始夹带请求内容(那是另一条通道)。
153
+ expect(Object.keys(enq).sort()).toEqual(["ok", "op", "request_id"]);
154
+ const pulled = await s.call("get_rules_file_request", {});
155
+ expect(pulled.request).toEqual({ request_id: enq.request_id, op: "skill_read", content: "ship" });
156
+ const payload = JSON.stringify({ name: "ship", scope: "project", path_rel: ".claude/skills/ship/SKILL.md", description: "d", content: "# ship" });
157
+ await s.call("ack_rules_file_request", { request_id: enq.request_id, status: "done", file_name: "ship", exists: true, content: payload });
158
+ expect(await u.call("get_rules_file_result", { request_id: enq.request_id })).toMatchObject({ status: "done", content: payload });
159
+ } finally { await u.close(); await s.close(); }
160
+ }, 20_000);
161
+
162
+ test("bad names are refused before any row is written", async () => {
163
+ await registerSession(asSession, SESSION_ALIAS, SESSION_RESUME, true);
164
+ const u = await connect(asUser);
165
+ try {
166
+ for (const name of ["..", ".", "../CLAUDE.md", "a/b", "a b"]) {
167
+ expect(await u.call("read_node_skill", { alias: SESSION_ALIAS, name })).toMatchObject({ ok: false, error: "invalid_skill_name" });
168
+ }
169
+ expect(rowCount()).toBe(0);
170
+ } finally { await u.close(); }
171
+ }, 20_000);
172
+
173
+ test("rules-capable but not skills-capable → skills_target_not_found, no row", async () => {
174
+ await reportRulesOnly(asSession, SESSION_ALIAS, SESSION_RESUME);
175
+ const u = await connect(asUser);
176
+ try {
177
+ expect(await u.call("list_node_skills", { alias: SESSION_ALIAS })).toMatchObject({ ok: false, error: "skills_target_not_found" });
178
+ expect(rowCount()).toBe(0);
179
+ expect(await u.call("read_node_rules_file", { alias: SESSION_ALIAS })).toMatchObject({ ok: true });
180
+ } finally { await u.close(); }
181
+ }, 20_000);
182
+ });
183
+
184
+ describe("single-flight lanes", () => {
185
+ test("a pending rules read does not block a skills list; a second skills request is refused", async () => {
186
+ await registerSession(asSession, SESSION_ALIAS, SESSION_RESUME, true);
187
+ const u = await connect(asUser);
188
+ try {
189
+ expect(await u.call("read_node_rules_file", { alias: SESSION_ALIAS })).toMatchObject({ ok: true });
190
+ const list = await u.call("list_node_skills", { alias: SESSION_ALIAS });
191
+ expect(list).toMatchObject({ ok: true });
192
+ expect(await u.call("read_node_skill", { alias: SESSION_ALIAS, name: "ship" })).toMatchObject({ ok: false, error: "request_in_flight", existing_request_id: list.request_id });
193
+ expect(await u.call("read_node_rules_file", { alias: SESSION_ALIAS })).toMatchObject({ ok: false, error: "request_in_flight" });
194
+ } finally { await u.close(); }
195
+ }, 20_000);
196
+ });
197
+
198
+ describe("isolation", () => {
199
+ test("same alias in another network neither pulls nor acks; a peer's ack is ignored", async () => {
200
+ await registerSession(asSession, SESSION_ALIAS, SESSION_RESUME, true);
201
+ const u = await connect(asUser);
202
+ const other = await connect(asOtherNetSameAlias);
203
+ const peer = await connect(asPeer);
204
+ try {
205
+ const enq = await u.call("list_node_skills", { alias: SESSION_ALIAS });
206
+ expect((await other.call("get_rules_file_request", {})).request).toBeNull();
207
+ expect(await other.call("ack_rules_file_request", { request_id: enq.request_id, status: "done", content: "{}" })).toMatchObject({ ok: true, ignored: "unknown_or_foreign_request" });
208
+ expect(await peer.call("ack_rules_file_request", { request_id: enq.request_id, status: "done", content: "{}" })).toMatchObject({ ok: true, ignored: "unknown_or_foreign_request" });
209
+ expect(await u.call("get_rules_file_result", { request_id: enq.request_id })).toMatchObject({ status: "pending" });
210
+ } finally { await u.close(); await other.close(); await peer.close(); }
211
+ }, 20_000);
212
+ });
@@ -0,0 +1,35 @@
1
+ import { db } from "./db.js";
2
+ import { resolveNodeCaller } from "./create-node.js";
3
+
4
+ /** Active credentials belonging to an immutable node, including verified legacy unbound tokens. */
5
+ export function activeNodeTokenIds(nodeId: string, networkId: string): string[] {
6
+ const node = db.get<{ alias: string }>("SELECT alias FROM nodes WHERE node_id=?1 AND network_id=?2", nodeId, networkId);
7
+ if (!node) return [];
8
+ const tokens = db.all<{ token_id: string }>(
9
+ `SELECT token_id FROM api_tokens WHERE network_id=?1 AND scope='network' AND revoked_at IS NULL
10
+ AND (bound_node_id=?2 OR (bound_node_id IS NULL AND name=?3)) ORDER BY token_id`,
11
+ networkId, nodeId, `node:${node.alias}`,
12
+ );
13
+ return tokens.filter(token => {
14
+ const caller = resolveNodeCaller(token.token_id);
15
+ return caller.ok && caller.kind === "node" && caller.nodeId === nodeId && caller.networkId === networkId;
16
+ }).map(token => token.token_id);
17
+ }
18
+
19
+ /** Preserve the dispatch-time freeze; old requests without it use verified node identity. */
20
+ export function revokeNodeTokens(nodeId: string, networkId: string, frozenTokenId: string | null): void {
21
+ let ids: string[];
22
+ if (frozenTokenId) {
23
+ const token = db.get<{ bound_node_id: string | null }>(
24
+ "SELECT bound_node_id FROM api_tokens WHERE token_id=?1 AND network_id=?2 AND scope='network' AND revoked_at IS NULL",
25
+ frozenTokenId, networkId,
26
+ );
27
+ // An immutable binding remains sufficient for revocation even after its node row was removed.
28
+ const caller = token && !token.bound_node_id ? resolveNodeCaller(frozenTokenId) : null;
29
+ ids = token?.bound_node_id === nodeId || (caller?.ok && caller.kind === "node" && caller.nodeId === nodeId && caller.networkId === networkId)
30
+ ? [frozenTokenId] : activeNodeTokenIds(nodeId, networkId);
31
+ } else {
32
+ ids = activeNodeTokenIds(nodeId, networkId);
33
+ }
34
+ for (const id of ids) db.run("UPDATE api_tokens SET revoked_at=datetime('now') WHERE token_id=?1 AND network_id=?2 AND revoked_at IS NULL", [id, networkId]);
35
+ }
@@ -0,0 +1,51 @@
1
+ import { db } from "./db.js";
2
+
3
+ // Call inside the caller's transaction. Serialize registration and issuance for
4
+ // this alias on PG; SQLite already serializes writes on its single connection.
5
+ export function lockNodeAlias(network: string, alias: string, nodeId?: string): void {
6
+ if (db.dialect !== "postgres") return;
7
+ db.get("SELECT pg_advisory_xact_lock(hashtext(?1))", JSON.stringify([network, "alias", alias]));
8
+ if (nodeId) db.get("SELECT pg_advisory_xact_lock(hashtext(?1))", JSON.stringify([network, "id", nodeId]));
9
+ }
10
+
11
+ export function legacyNodeHolder(user: string, network: string, alias: string, nodeId: string): boolean {
12
+ return !!db.get(`SELECT token_id FROM api_tokens WHERE user_id=?1 AND network_id=?2
13
+ AND name=?3 AND revoked_at IS NULL AND (expires_at IS NULL OR expires_at > datetime('now'))
14
+ AND (bound_node_id=?4 OR (bound_node_id IS NULL AND node_identity_epoch=0)) LIMIT 1`,
15
+ user, network, `node:${alias}`, nodeId);
16
+ }
17
+
18
+ /** Resolve a name-only refresh to the existing identity, never claim its owner. */
19
+ export function checkNodeTokenClaim(user: string, network: string, alias: string, nodeId?: string): string | undefined {
20
+ lockNodeAlias(network, alias, nodeId);
21
+ const rows = db.all<{node_id: string; owner_user_id: string | null}>(
22
+ "SELECT node_id, owner_user_id FROM nodes WHERE network_id=?1 AND alias=?2", network, alias);
23
+ if (rows.length > 1 || rows.some(row => nodeId && row.node_id !== nodeId)) throw Error("node_owner_mismatch");
24
+ const row = rows[0];
25
+ // Explicit-ID ownerless claims retain auth.ts's node_owner_unclaimed error;
26
+ // name-only requests need holder evidence before resolving to that ID.
27
+ if (row && (row.owner_user_id ? row.owner_user_id !== user : !nodeId && !legacyNodeHolder(user, network, alias, row.node_id))) {
28
+ throw Error("node_owner_mismatch");
29
+ }
30
+ // Old clients can register a session without ever creating a nodes row.
31
+ // That name is already in use. Sessions have no owner column, so only
32
+ // an administrator or the unique active node-token holder may refresh it.
33
+ // A general token renamed by a heartbeat is not holder evidence (epoch 1).
34
+ if (!row && db.get("SELECT resume_id FROM sessions WHERE network_id=?1 AND alias=?2 LIMIT 1", network, alias)) {
35
+ const actor = db.get<{ role: string; hub_role: string }>(
36
+ `SELECT nm.role, u.role AS hub_role FROM network_members nm JOIN users u ON u.user_id=nm.user_id
37
+ WHERE nm.network_id=?1 AND nm.user_id=?2`, network, user);
38
+ const admin = actor && (actor.role === "owner" || actor.role === "admin" || actor.hub_role === "admin");
39
+ const holders = db.all<{ user_id: string }>(
40
+ `SELECT DISTINCT user_id FROM api_tokens WHERE network_id=?1 AND name=?2 AND scope='network'
41
+ AND bound_node_id IS NULL AND node_identity_epoch IN (0,2) AND revoked_at IS NULL
42
+ AND (expires_at IS NULL OR expires_at > datetime('now'))`, network, `node:${alias}`);
43
+ if (!admin && (holders.length !== 1 || holders[0].user_id !== user)) throw Error("node_owner_mismatch");
44
+ }
45
+ if (!row && db.get(`SELECT token_id FROM api_tokens WHERE network_id=?1 AND name=?2
46
+ AND user_id<>?3 AND node_identity_epoch=2 AND revoked_at IS NULL
47
+ AND (expires_at IS NULL OR expires_at > datetime('now')) LIMIT 1`, network, `node:${alias}`, user)) {
48
+ throw Error("node_owner_mismatch");
49
+ }
50
+ return nodeId ?? row?.node_id;
51
+ }
@@ -0,0 +1,224 @@
1
+ // 节点令牌不继承签发者的账号权限与 Hub 管理员身份。
2
+ //
3
+ // 生产上几乎所有节点令牌(ntok_)都由管理员签发,resolveToken 把它解析成那个管理员用户。
4
+ // 以前一部分端点直接看 `resolved.user.role === "admin"` 或把令牌当成用户本人,于是任何一个节点
5
+ // 都能:列全部用户、读服务端日志与审计日志、给签发者再签用户令牌 / 节点令牌、改签发者资料与密码、
6
+ // 建 / 改 / 删网络、管成员与邀请、读别的网络详情、看全部网络的 SSE 拓扑。
7
+ // 这里每一条在修复前(main)都是红的;管理员自己的用户令牌作为正控,照常可用。
8
+
9
+ import { describe, expect, test, beforeAll, afterAll } from "bun:test";
10
+ import { mkdtempSync, rmSync } from "fs";
11
+ import { join } from "path";
12
+ import { tmpdir } from "os";
13
+ import { register, createNetwork, createNetworkTokenForNode } from "./auth.js";
14
+ import { db } from "./db.js";
15
+
16
+ const DIR = mkdtempSync(join(tmpdir(), "anet-ntok-priv-"));
17
+ let BASE = "";
18
+ let hub: any = null;
19
+ const PW = "NtokPrivPassw0rd!";
20
+ let adminToken = "", adminId = "", NET = "", OTHER_NET = "", ntok = "", adminUsername = "";
21
+
22
+ const auth = (t: string) => ({ Authorization: `Bearer ${t}` });
23
+ async function call(token: string, method: string, path: string, body?: unknown) {
24
+ const res = await fetch(`${BASE}${path}`, {
25
+ method,
26
+ headers: { ...auth(token), ...(body === undefined ? {} : { "Content-Type": "application/json" }) },
27
+ body: body === undefined ? undefined : JSON.stringify(body),
28
+ });
29
+ return { status: res.status, body: await res.json().catch(() => null) as any };
30
+ }
31
+
32
+ beforeAll(async () => {
33
+ process.env.COMMHUB_DB ||= join(DIR, "hub.db");
34
+ process.env.COMMHUB_UPLOADS_DIR = join(DIR, "uploads");
35
+ process.env.HOST = "127.0.0.1";
36
+ adminUsername = `ntok_admin_${Date.now()}`;
37
+ const admin = register(adminUsername, PW);
38
+ adminToken = admin.token!; adminId = admin.user!.user_id; NET = admin.network_id!;
39
+ db.run("UPDATE users SET role = 'admin' WHERE user_id = ?1", [adminId]);
40
+ const other = createNetwork(adminId, "ntok-other");
41
+ OTHER_NET = (other as any).network_id;
42
+ const minted = createNetworkTokenForNode(adminId, NET, "ntok-node", "node_ntok_priv");
43
+ expect(minted.ok).toBe(true);
44
+ ntok = minted.token!;
45
+ register(`ntok_someone_${Date.now()}`, PW);
46
+ const mod: any = await import("./server.js");
47
+ hub = mod.bootServer({ port: 0, hostname: "127.0.0.1" });
48
+ BASE = `http://127.0.0.1:${hub.port}`;
49
+ }, 30_000);
50
+
51
+ afterAll(() => {
52
+ try { hub?.stop?.(true); } catch {}
53
+ try { rmSync(DIR, { recursive: true, force: true }); } catch {}
54
+ });
55
+
56
+ describe("hub-admin powers need a user token", () => {
57
+ test("GET /api/users", async () => {
58
+ expect((await call(ntok, "GET", "/api/users")).status).toBe(403);
59
+ expect((await call(adminToken, "GET", "/api/users")).status).toBe(200);
60
+ });
61
+ test("GET /api/server-logs", async () => {
62
+ expect((await call(ntok, "GET", "/api/server-logs")).status).toBe(403);
63
+ expect((await call(adminToken, "GET", "/api/server-logs")).status).toBe(200);
64
+ });
65
+ test("GET /api/audit-log", async () => {
66
+ expect((await call(ntok, "GET", "/api/audit-log")).status).toBe(403);
67
+ expect((await call(adminToken, "GET", "/api/audit-log")).status).toBe(200);
68
+ });
69
+ test("GET /api/networks/:id of a network the token is not bound to", async () => {
70
+ expect((await call(ntok, "GET", `/api/networks/${OTHER_NET}`)).status).toBe(403);
71
+ expect((await call(ntok, "GET", `/api/networks/${NET}`)).status).toBe(200);
72
+ });
73
+ test("GET /api/stats/sse is limited to the bound network", async () => {
74
+ const ctrl = new AbortController();
75
+ const sub = await fetch(`${BASE}/events/some-agent?network_id=${OTHER_NET}`, { headers: auth(adminToken), signal: ctrl.signal }).catch(() => null);
76
+ const r = await call(ntok, "GET", "/api/stats/sse");
77
+ ctrl.abort();
78
+ expect(r.status).toBe(200);
79
+ expect(Object.keys(r.body.sessions).every((k) => k.split(":").includes(NET))).toBe(true);
80
+ expect(JSON.stringify(r.body)).not.toContain(OTHER_NET);
81
+ void sub;
82
+ });
83
+ test("POST /api/admin/users and agent-grants", async () => {
84
+ // #3354 —— 拒绝之外钉「没有建出用户」:建用户的副作用是**多一行 users**。
85
+ const userRows = () => db.get<{ n: number }>("SELECT COUNT(*) AS n FROM users")!.n;
86
+ const beforeUsers = userRows();
87
+ expect((await call(ntok, "POST", "/api/admin/users", { username: "ntok_made", password: PW })).status).toBe(403);
88
+ expect(userRows()).toBe(beforeUsers);
89
+ expect(db.get("SELECT 1 FROM users WHERE username = 'ntok_made'")).toBeFalsy();
90
+ // #3354 —— 写 side:节点令牌不能改 agent-grants(读的 403 上面已有)。
91
+ // 副作用是**多一条授权**(那意味着一个 Agent 对这个人可见)。
92
+ const grants = () => db.get<{ n: number }>(
93
+ "SELECT COUNT(*) AS n FROM network_member_agent_grants WHERE network_id = ?1", NET)!.n;
94
+ const beforeGrants = grants();
95
+ expect((await call(ntok, "GET", `/api/networks/${NET}/members/${adminId}/agent-grants`)).status).toBe(403);
96
+ expect((await call(ntok, "PUT", `/api/networks/${NET}/members/${adminId}/agent-grants`, { node_ids: ["n_x"] })).status).toBe(403);
97
+ expect(grants()).toBe(beforeGrants);
98
+ });
99
+ });
100
+
101
+ describe("account and network management need a user token", () => {
102
+ test("token management: cannot list, mint user tokens, mint node tokens or revoke", async () => {
103
+ // #3354 —— 拒绝之外还要钉「没有新令牌」:发令牌的副作用是**多一行 api_tokens**。
104
+ // 只断 403 时,「拒了但令牌已经发出来了」也会绿 —— 而那一枚令牌是能真的用的。
105
+ const tokenRows = () => db.get<{ n: number }>(
106
+ "SELECT COUNT(*) AS n FROM api_tokens WHERE user_id = ?1", adminId)!.n;
107
+ const beforeTokens = tokenRows();
108
+ expect((await call(ntok, "GET", "/api/auth/tokens")).status).toBe(403);
109
+ const minted = await call(ntok, "POST", "/api/auth/tokens", { name: "escalate" });
110
+ expect(minted.status).toBe(403);
111
+ expect(minted.body.token).toBeUndefined();
112
+ expect((await call(ntok, "POST", "/api/auth/node-token", { network_id: OTHER_NET, node_name: "x" })).status).toBe(403);
113
+ // 两条被拒的发放都不许留下任何一行
114
+ expect(tokenRows()).toBe(beforeTokens);
115
+ expect(db.get("SELECT 1 FROM api_tokens WHERE name = 'escalate'")).toBeFalsy();
116
+ expect((await call(ntok, "DELETE", "/api/auth/tokens/tok_whatever")).status).toBe(403);
117
+ expect((await call(adminToken, "GET", "/api/auth/tokens")).status).toBe(200);
118
+ });
119
+ // #3354 —— DELETE /api/auth/tokens/:id:拒绝之后**那一行必须还在**。
120
+ // 吊销是不可逆的副作用(令牌一旦删掉,用户的脚本当场断掉),所以拒绝时更不能碰它。
121
+ test("节点令牌不能吊销用户令牌:403 且目标行仍在", async () => {
122
+ const mint = await call(adminToken, "POST", "/api/auth/tokens", { name: "revoke-target" });
123
+ expect(mint.status).toBe(200);
124
+ const targetId = mint.body.token_id as string;
125
+ expect(db.get("SELECT 1 FROM api_tokens WHERE token_id = ?1", targetId)).toBeTruthy();
126
+ const denied = await call(ntok, "DELETE", `/api/auth/tokens/${targetId}`);
127
+ expect(denied.status).toBe(403);
128
+ // 拒绝的第二半:那一行还在(只断 403 时,「拒了但已经吊销了」也会绿)
129
+ expect(db.get("SELECT 1 FROM api_tokens WHERE token_id = ?1", targetId)).toBeTruthy();
130
+ });
131
+
132
+ test("cannot edit the owner's profile or password", async () => {
133
+ expect((await call(ntok, "PUT", "/api/auth/me", { display_name: "pwned" })).status).toBe(403);
134
+ expect(db.get<{ display_name: string }>("SELECT display_name FROM users WHERE user_id = ?1", adminId)?.display_name).not.toBe("pwned");
135
+ expect((await call(ntok, "POST", "/api/auth/password", { old_password: PW, new_password: "AnotherPassw0rd!" })).status).toBe(403);
136
+ // #3354 —— 拒绝的第二半:**旧密码仍然可用**(改密的副作用是旧密码立刻失效)。
137
+ // 只断 403 时,「拒了但密码已经被改掉」也会绿 —— 那会让主人当场登不进来。
138
+ const relogin = await call("", "POST", "/api/auth/login", { username: adminUsername, password: PW });
139
+ expect(relogin.status).toBe(200);
140
+ });
141
+ test("cannot create, rename or delete networks", async () => {
142
+ // #3354 —— 拒绝之外还要钉「没有副作用」:建网络的副作用是**多一行 networks**。
143
+ // 只断 403 时,「拒了但已经建出来了」也会绿 —— 而那是一个节点令牌自己开了租户。
144
+ const netCount = () => db.get<{ n: number }>("SELECT COUNT(*) AS n FROM networks")!.n;
145
+ const beforeNets = netCount();
146
+ expect((await call(ntok, "POST", "/api/networks", { name: "ntok-made" })).status).toBe(403);
147
+ expect(netCount()).toBe(beforeNets);
148
+ expect(db.get("SELECT 1 FROM networks WHERE network_name = 'ntok-made'")).toBeFalsy();
149
+ expect((await call(ntok, "PUT", `/api/networks/${OTHER_NET}`, { name: "renamed" })).status).toBe(403);
150
+ expect((await call(ntok, "DELETE", `/api/networks/${OTHER_NET}`)).status).toBe(403);
151
+ expect(db.get("SELECT 1 FROM networks WHERE network_id = ?1", OTHER_NET)).toBeTruthy();
152
+ });
153
+ test("cannot manage members, invites or join", async () => {
154
+ expect((await call(ntok, "GET", `/api/networks/${NET}/members`)).status).toBe(403);
155
+ expect((await call(ntok, "POST", `/api/networks/${NET}/members`, { user_id: "u_x" })).status).toBe(403);
156
+ // #3354 —— 邀请的副作用是**多一行 invite**(那行能换出一个新成员)。
157
+ const invites = () => db.get<{ n: number }>("SELECT COUNT(*) AS n FROM network_invites")!.n;
158
+ const beforeInvites = invites();
159
+ expect((await call(ntok, "POST", `/api/networks/${NET}/invite`, { role: "admin" })).status).toBe(403);
160
+ expect(invites()).toBe(beforeInvites);
161
+ // #3354 —— 拒绝之外还要钉「没加入任何网络」:join 的副作用是**多一行 network_members**。
162
+ // 只断 403 时,「拒了但已经加进去了」也会绿 —— 而那意味着节点令牌借邀请码混进了别人的租户。
163
+ const memberships = () => db.get<{ n: number }>(
164
+ "SELECT COUNT(*) AS n FROM network_members WHERE user_id = ?1", adminId)!.n;
165
+ const beforeJoin = memberships();
166
+ expect((await call(ntok, "POST", "/api/networks/join", { invite_code: "inv_x" })).status).toBe(403);
167
+ expect(memberships()).toBe(beforeJoin);
168
+ expect((await call(adminToken, "GET", `/api/networks/${NET}/members`)).status).toBe(200);
169
+ });
170
+ test("renames: a node token may only rename ITSELF in its bound network", async () => {
171
+ // 别的网络 / 别的节点 → user_token_required
172
+ // #3354 —— 拒绝之外钉「没有开出事务」:prepare 的副作用是多一行 rename_txn。
173
+ const txns = () => db.get<{ n: number }>("SELECT COUNT(*) AS n FROM rename_txn")!.n;
174
+ const beforeTxns = txns();
175
+ expect((await call(ntok, "POST", "/api/node-rename/prepare", { network_id: OTHER_NET, old_alias: "ntok-node", new_alias: "b" })).status).toBe(403);
176
+ expect(txns()).toBe(beforeTxns);
177
+ db.run(`INSERT INTO sessions (resume_id, alias, status, network_id) VALUES ('r_other_node', 'other-node', 'idle', ?1)`, [NET]);
178
+ expect((await call(ntok, "POST", "/api/node-rename/prepare", { network_id: NET, old_alias: "other-node", new_alias: "b" })).status).toBe(403);
179
+ // 另一个节点(管理员用户令牌)开的事务,本节点不能提交
180
+ const foreign = await call(adminToken, "POST", "/api/node-rename/prepare", { network_id: NET, old_alias: "other-node", new_alias: "other-node-2" });
181
+ expect(foreign.body.ok).toBe(true);
182
+ expect((await call(ntok, "POST", "/api/node-rename/commit", { txn_id: foreign.body.txn_id })).status).toBe(403);
183
+ // #3354 —— 同理,abort 别人的事务也要被拒,且**拒绝之后那行事务还在**(状态仍是 prepared)。
184
+ // 只断 403 时,「拒了但已经把事务作废」也会绿 —— 而那会让真正的事务主人 abort 时拿到「已结束」。
185
+ const txnStatus = () => db.get<{ status: string }>(
186
+ "SELECT status FROM rename_txn WHERE txn_id = ?1", foreign.body.txn_id)?.status;
187
+ const statusBefore = txnStatus();
188
+ expect((await call(ntok, "POST", "/api/node-rename/abort", { txn_id: foreign.body.txn_id })).status).toBe(403);
189
+ expect(txnStatus()).toBe(statusBefore);
190
+ // 事务仍可被它的主人 abort(拒绝不许消耗掉它)
191
+ expect((await call(adminToken, "POST", "/api/node-rename/abort", { txn_id: foreign.body.txn_id })).body.ok).toBe(true);
192
+ // 自己:照常(anet node rename 就是这么用的)
193
+ db.run(`INSERT INTO sessions (resume_id, alias, status, network_id) VALUES ('r_self_node', 'ntok-node', 'idle', ?1)`, [NET]);
194
+ const mine = await call(ntok, "POST", "/api/node-rename/prepare", { network_id: NET, old_alias: "ntok-node", new_alias: "ntok-node-2" });
195
+ expect(mine.body.ok).toBe(true);
196
+ expect((await call(ntok, "POST", "/api/node-rename/abort", { txn_id: mine.body.txn_id })).body.ok).toBe(true);
197
+ });
198
+ test("rename rejects line breaks, tabs and other control characters before reserving an alias", async () => {
199
+ for (const newAlias of ["hidden\nnode", "hidden\tnode", "hidden\u001fnode", "hidden\u007fnode", "hidden\u2028node", "hidden\u2029node"]) {
200
+ const r = await call(ntok, "POST", "/api/node-rename/prepare", { network_id: NET, old_alias: "ntok-node", new_alias: newAlias });
201
+ expect(r.status).toBe(400);
202
+ expect(r.body).toMatchObject({ ok: false, error: "node_alias_invalid", code: "node_alias_invalid", reason: "control_character" });
203
+ expect(r.body.message).toContain("control character U+");
204
+ }
205
+ expect(db.get<{ n: number }>("SELECT COUNT(*) AS n FROM rename_txn WHERE network_id = ?1 AND status = 'prepared'", NET)?.n).toBe(0);
206
+ });
207
+ });
208
+
209
+ describe("/api/auth/me says what the credential is", () => {
210
+ test("node token: owner user for compatibility, but credential.kind=node and only the bound network", async () => {
211
+ const r = await call(ntok, "GET", "/api/auth/me");
212
+ expect(r.status).toBe(200);
213
+ expect(r.body.credential).toMatchObject({ kind: "node", network_id: NET, node_alias: "ntok-node", acts_as_owner: false });
214
+ expect(r.body.current_network).toBe(NET);
215
+ expect(r.body.networks.map((n: any) => n.network_id)).toEqual([NET]);
216
+ const u = await call(adminToken, "GET", "/api/auth/me");
217
+ expect(u.body.credential).toEqual({ kind: "user" });
218
+ expect(u.body.networks.map((n: any) => n.network_id).sort()).toEqual([NET, OTHER_NET].sort());
219
+ });
220
+ test("node token keeps its own network powers (still a member): status and tasks read fine", async () => {
221
+ expect((await call(ntok, "GET", "/api/status")).status).toBe(200);
222
+ expect((await call(ntok, "GET", "/api/tasks")).status).toBe(200);
223
+ });
224
+ });
@@ -0,0 +1,67 @@
1
+ // #2946 —— 未匹配的 /api/* 必须 404,而不是 200 + 帮助页。
2
+ //
3
+ // 现场(.193):带 token 打 /api/lang/status /api/hub/profile /api/nodes/department
4
+ // /api/schedules/failures(四个都不存在)→ 全部 200 + 652B 的帮助页文本,
5
+ // 字节数完全相同。探针会把「端点改名/拼错」读成「正常」—— 假绿。
6
+ // 这与 #2559(401 被伪装成空数据)同类:错误被伪装成成功。
7
+ //
8
+ // 根路径 `/` 仍然返回帮助页(那是给人/curl 看的入口说明),这条也要钉住,
9
+ // 否则修 #2946 时很容易把根路径一起改成 404。
10
+ import { afterAll, beforeAll, expect, test } from "bun:test";
11
+ import { mkdtempSync } from "node:fs";
12
+ import { join } from "node:path";
13
+ import { tmpdir } from "node:os";
14
+
15
+ const dir = mkdtempSync(join(tmpdir(), "notfound-2946-"));
16
+ process.env.COMMHUB_DB ||= join(dir, "hub.db");
17
+ process.env.COMMHUB_AUTH_TOKEN ||= "notfound-2946-master-fixture";
18
+
19
+ let hub: { stop: (closeActiveConnections?: boolean) => void; port: number } | null = null;
20
+ let base = "";
21
+ let token = "";
22
+
23
+ beforeAll(async () => {
24
+ const { register } = await import("./auth.js");
25
+ const { bootServer } = await import("./server.js");
26
+ const a = register(`nf_owner_${Date.now()}`, "NotFou-2946-Strong1!");
27
+ expect(a.ok).toBe(true);
28
+ token = a.token!;
29
+ hub = bootServer({ port: 0, hostname: "127.0.0.1" }) as any;
30
+ base = `http://127.0.0.1:${hub!.port}`;
31
+ });
32
+
33
+ afterAll(() => { try { hub?.stop?.(true); } catch {} });
34
+
35
+ const call = async (path: string, withToken = true) => {
36
+ const res = await fetch(base + path, {
37
+ headers: withToken ? { Authorization: `Bearer ${token}` } : {},
38
+ });
39
+ const text = await res.text();
40
+ return { status: res.status, text };
41
+ };
42
+
43
+ test("不存在的 /api/* 路径返回 404 not_found(不再 200 + 帮助页)", async () => {
44
+ for (const path of ["/api/definitely-not-a-route", "/api/lang/status", "/api/hub/profile"]) {
45
+ const r = await call(path);
46
+ expect(r.status).toBe(404);
47
+ const body = JSON.parse(r.text);
48
+ expect(body.ok).toBe(false);
49
+ expect(body.error).toBe("not_found");
50
+ expect(body.path).toBe(path);
51
+ // 关键:不再把帮助页伪装成这个端点的返回
52
+ expect(r.text).not.toContain("Streamable HTTP");
53
+ }
54
+ });
55
+
56
+ test("已存在的端点不受影响", async () => {
57
+ const r = await call("/health", false);
58
+ expect(r.status).toBe(200);
59
+ expect(JSON.parse(r.text).ok).toBe(true);
60
+ });
61
+
62
+ test("根路径仍然返回帮助页(不能一起改成 404)", async () => {
63
+ // 认证门在路由之前:/ 也要带 token 才看得到帮助页(不带是 401,本就不变)
64
+ const r = await call("/", true);
65
+ expect(r.status).toBe(200);
66
+ expect(r.text).toContain("CommHub MCP Server");
67
+ });