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

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 (482) hide show
  1. package/README.md +120 -3
  2. package/bin/commhub.ts +93 -9
  3. package/build-info.json +7 -0
  4. package/package.json +10 -8
  5. package/src/ack-create-request-transport.test.ts +182 -0
  6. package/src/ack-create-request.test.ts +52 -8
  7. package/src/admin-delete-network-http.test.ts +229 -0
  8. package/src/admin-networks-http.test.ts +88 -0
  9. package/src/adoption-candidates-http.test.ts +140 -0
  10. package/src/adoption-candidates.ts +158 -0
  11. package/src/agent-access-batch.test.ts +215 -0
  12. package/src/agent-access.ts +585 -0
  13. package/src/agent-acl-groups-http.test.ts +247 -0
  14. package/src/agent-acl-http.test.ts +691 -0
  15. package/src/agent-acl-slice3-http.test.ts +888 -0
  16. package/src/agent-department-grants.test.ts +129 -0
  17. package/src/agent-department-http.test.ts +215 -0
  18. package/src/agent-groups-perf.test.ts +228 -0
  19. package/src/agent-notice.ts +48 -0
  20. package/src/agent-team-whoami-http.test.ts +98 -0
  21. package/src/agent-teams-http.test.ts +330 -0
  22. package/src/agent-teams.ts +244 -0
  23. package/src/alias-baseline-2571.test.ts +162 -0
  24. package/src/alias-baseline.ts +113 -0
  25. package/src/alias-filter.test.ts +72 -0
  26. package/src/alias-filter.ts +42 -0
  27. package/src/all-status-cache.test.ts +31 -0
  28. package/src/all-status-cache.ts +37 -0
  29. package/src/anet-variant-real-daemon-http.test.ts +185 -0
  30. package/src/api-host-supervisors-can-create-nodes.test.ts +350 -0
  31. package/src/api-host-supervisors-fallback.test.ts +6 -7
  32. package/src/api-host-supervisors-runtime-readiness.test.ts +195 -0
  33. package/src/api-nodes-shape.test.ts +131 -4
  34. package/src/auth-abuse-counters.test.ts +144 -0
  35. package/src/auth-abuse-counters.ts +122 -0
  36. package/src/auth-layer-shape.test.ts +105 -0
  37. package/src/auth-password-change-cli-tokens-http.test.ts +423 -0
  38. package/src/auth-sessions-http.test.ts +260 -0
  39. package/src/auth-validate.test.ts +5 -1
  40. package/src/auth-weak-password-login.test.ts +176 -0
  41. package/src/auth.ts +641 -68
  42. package/src/backfill-node-ids-2664.test.ts +128 -0
  43. package/src/binding-generation-http.test.ts +141 -0
  44. package/src/blocked-exit-on-reply.test.ts +122 -0
  45. package/src/broadcast-fanout-2721.test.ts +149 -0
  46. package/src/broadcast-fanout.ts +117 -0
  47. package/src/build-commit-report-http.test.ts +219 -0
  48. package/src/build-info.test.ts +60 -0
  49. package/src/build-info.ts +85 -0
  50. package/src/chain-attempt-dedup.test.ts +447 -0
  51. package/src/clip.test.ts +36 -0
  52. package/src/clip.ts +48 -0
  53. package/src/clone-node.test.ts +269 -0
  54. package/src/clone-node.ts +289 -0
  55. package/src/codex-config-flags.ts +77 -0
  56. package/src/codex-fork-contract.ts +23 -0
  57. package/src/codex-fork-migration.test.ts +38 -0
  58. package/src/commhub-bin-args.test.ts +85 -0
  59. package/src/config-apply-sec1.test.ts +37 -0
  60. package/src/config-apply-validate.test.ts +188 -1
  61. package/src/config-apply-validate.ts +226 -3
  62. package/src/contracts/session-project-create.ts +14 -0
  63. package/src/contracts/session-source-delivery.ts +16 -0
  64. package/src/contracts/session-source-directory.ts +54 -0
  65. package/src/contracts/session-source-evidence.ts +72 -0
  66. package/src/contracts/session-source-execution.ts +24 -0
  67. package/src/contracts/session-source-transport.ts +18 -0
  68. package/src/cors-origins.test.ts +73 -0
  69. package/src/create-node-blocked-gate.test.ts +365 -0
  70. package/src/create-node-error-domain.test.ts +127 -0
  71. package/src/create-node-network-id.test.ts +91 -0
  72. package/src/create-node-tool-schema.test.ts +59 -0
  73. package/src/create-node-unicode-name.test.ts +126 -0
  74. package/src/create-node-validate.test.ts +199 -7
  75. package/src/create-node-validate.ts +232 -15
  76. package/src/create-node-workdir.test.ts +298 -0
  77. package/src/create-node.ts +88 -23
  78. package/src/daemon-provider-snapshots.test.ts +453 -0
  79. package/src/daemon-provider-snapshots.ts +327 -0
  80. package/src/daemon-token-owner-http.test.ts +346 -0
  81. package/src/dashboard-slash-routing-http.test.ts +109 -0
  82. package/src/db-adapter-guard.test.ts +148 -0
  83. package/src/db-adapter-translate.test.ts +128 -0
  84. package/src/db-adapter.ts +377 -91
  85. package/src/db-timestamp.test.ts +38 -0
  86. package/src/db-timestamp.ts +15 -0
  87. package/src/db.ts +1334 -154
  88. package/src/delivered-without-push.test.ts +140 -0
  89. package/src/department-groups-http.test.ts +209 -0
  90. package/src/department-groups-sync-http.test.ts +328 -0
  91. package/src/department-groups.ts +434 -0
  92. package/src/department-heads-http.test.ts +350 -0
  93. package/src/department-heads.ts +226 -0
  94. package/src/departments-agent-count.test.ts +139 -0
  95. package/src/departments-http.test.ts +185 -0
  96. package/src/departments-mcp-error-domain.test.ts +135 -0
  97. package/src/departments-mcp.test.ts +128 -0
  98. package/src/departments.ts +318 -0
  99. package/src/desktop-message-seam.test.ts +150 -0
  100. package/src/desktop-message.test.ts +368 -0
  101. package/src/dm-file-scope-http.test.ts +227 -0
  102. package/src/empty-node-sweeper.test.ts +104 -0
  103. package/src/empty-node-sweeper.ts +88 -0
  104. package/src/env-transport-gate-http.test.ts +240 -0
  105. package/src/env-transport-gate.ts +80 -0
  106. package/src/env-transport-policy.ts +56 -0
  107. package/src/etag-of.test.ts +57 -0
  108. package/src/event-loop-lag.test.ts +180 -0
  109. package/src/event-loop-lag.ts +201 -0
  110. package/src/expiry-counters.test.ts +187 -0
  111. package/src/expiry-counters.ts +227 -0
  112. package/src/expiry-evidence-db.test.ts +103 -0
  113. package/src/ext-token-shared.test.ts +60 -0
  114. package/src/ext-validation-regression.test.ts +10 -17
  115. package/src/external-schedule-edits-http.test.ts +321 -0
  116. package/src/external-schedule-edits-timestamps.test.ts +64 -0
  117. package/src/external-schedule-edits.ts +327 -0
  118. package/src/file-download-authz-dev-open.test.ts +1 -1
  119. package/src/file-download-authz.test.ts +25 -4
  120. package/src/file-download-date-bucket.test.ts +1 -1
  121. package/src/file-network-scope-dev-open.test.ts +1 -1
  122. package/src/file-network-scope.test.ts +7 -6
  123. package/src/group-membership-events-http.test.ts +264 -0
  124. package/src/group-messages-http.test.ts +483 -0
  125. package/src/group-messages.ts +297 -0
  126. package/src/health-anon-readers.ts +67 -0
  127. package/src/health-host-disk-2756.test.ts +71 -0
  128. package/src/health-identity-root.test.ts +98 -0
  129. package/src/health-redaction.test.ts +1603 -7
  130. package/src/health-status-reasons.test.ts +84 -0
  131. package/src/host-supervisor-identity-http.test.ts +152 -0
  132. package/src/host-supervisor-identity.ts +92 -0
  133. package/src/host-supervisors-daemon-version.test.ts +137 -0
  134. package/src/http-gzip.test.ts +94 -0
  135. package/src/http-gzip.ts +112 -0
  136. package/src/hub-catalog-read-http.test.ts +664 -0
  137. package/src/hub-provider-config.test.ts +166 -0
  138. package/src/hub-provider-config.ts +202 -0
  139. package/src/hub-timestamp.test.ts +38 -0
  140. package/src/hub-timestamp.ts +27 -0
  141. package/src/human-dm.ts +215 -0
  142. package/src/human-inbox.ts +42 -0
  143. package/src/inbox-caller.ts +49 -0
  144. package/src/inbox-count-sse.test.ts +318 -0
  145. package/src/inbox-count.ts +29 -0
  146. package/src/index.ts +6 -2
  147. package/src/launched-by-cli-report-http.test.ts +155 -0
  148. package/src/license-state.test.ts +105 -0
  149. package/src/license-state.ts +48 -0
  150. package/src/lifecycle-error-domain.test.ts +149 -0
  151. package/src/list-ack-error-domain.test.ts +108 -0
  152. package/src/list-host-supervisors.test.ts +15 -4
  153. package/src/list-tasks-omit-default.test.ts +84 -0
  154. package/src/list-tasks-since-last.test.ts +100 -0
  155. package/src/list-tasks-since.test.ts +104 -0
  156. package/src/mcp-context-cost-http.test.ts +127 -0
  157. package/src/mcp-inflight.test.ts +92 -0
  158. package/src/mcp-inflight.ts +38 -0
  159. package/src/mcp-projects-events-http.test.ts +168 -0
  160. package/src/mcp-route-label-http.test.ts +120 -0
  161. package/src/mcp-write-network-resolution.test.ts +21 -0
  162. package/src/member-audit-network-id-http.test.ts +93 -0
  163. package/src/member-presence-http.test.ts +210 -0
  164. package/src/messages-ack-by-agent-http.test.ts +142 -0
  165. package/src/migrate-sqlite-to-pg.test.ts +47 -0
  166. package/src/migrate-sqlite-to-pg.ts +263 -0
  167. package/src/model-auth-notify-http.test.ts +181 -0
  168. package/src/model-auth-notify.ts +116 -0
  169. package/src/network-name-http.test.ts +75 -0
  170. package/src/network-quota-config.test.ts +100 -0
  171. package/src/network-rules-http.test.ts +169 -0
  172. package/src/network-rules.ts +129 -0
  173. package/src/network-scope.ts +222 -3
  174. package/src/network-token-membership-http.test.ts +186 -0
  175. package/src/node-alias-control.ts +12 -0
  176. package/src/node-attrs.test.ts +47 -2
  177. package/src/node-caller-identity-http.test.ts +1108 -0
  178. package/src/node-config-last-update.test.ts +126 -0
  179. package/src/node-config-last-update.ts +107 -0
  180. package/src/node-create-request-status-http.test.ts +105 -0
  181. package/src/node-daemon-bindings.test.ts +142 -0
  182. package/src/node-daemon-bindings.ts +135 -0
  183. package/src/node-failure-alert.test.ts +150 -0
  184. package/src/node-failure-alert.ts +177 -0
  185. package/src/node-files-transport.test.ts +350 -0
  186. package/src/node-health-codex-login.test.ts +120 -0
  187. package/src/node-health-dispatch-http.test.ts +373 -0
  188. package/src/node-health-guard-origin.test.ts +98 -0
  189. package/src/node-health-guard.ts +121 -0
  190. package/src/node-health-passthrough.test.ts +115 -0
  191. package/src/node-health-store.ts +101 -0
  192. package/src/node-id-alias.test.ts +190 -0
  193. package/src/node-identity-conflict-http.test.ts +269 -0
  194. package/src/node-identity-conflict.ts +142 -0
  195. package/src/node-identity-mismatch.test.ts +74 -0
  196. package/src/node-in-flight-tasks.ts +31 -0
  197. package/src/node-inbox-allowlist-http.test.ts +320 -0
  198. package/src/node-lifecycle-controllable.test.ts +64 -0
  199. package/src/node-lifecycle-controllable.ts +53 -0
  200. package/src/node-lifecycle-read-http.test.ts +257 -0
  201. package/src/node-lifecycle-read.ts +126 -0
  202. package/src/node-logs-transport.test.ts +266 -0
  203. package/src/node-peer-allowlist.test.ts +114 -0
  204. package/src/node-permissions-http.test.ts +901 -0
  205. package/src/node-permissions.ts +627 -0
  206. package/src/node-request-retention.test.ts +281 -0
  207. package/src/node-request-retention.ts +120 -0
  208. package/src/node-secret-rest-http.test.ts +190 -0
  209. package/src/node-secret-vault-inject.test.ts +132 -0
  210. package/src/node-security-write-gate.test.ts +72 -0
  211. package/src/node-serviceability.test.ts +86 -0
  212. package/src/node-serviceability.ts +124 -0
  213. package/src/node-session-control-http.test.ts +398 -0
  214. package/src/node-session-control.ts +316 -0
  215. package/src/node-skills-transport.test.ts +212 -0
  216. package/src/node-token-identity.ts +35 -0
  217. package/src/node-token-ownership.ts +51 -0
  218. package/src/node-token-privilege-http.test.ts +224 -0
  219. package/src/node-token-usage.test.ts +128 -0
  220. package/src/node-token-usage.ts +228 -0
  221. package/src/not-found-api-http.test.ts +67 -0
  222. package/src/observer-avatar-http.test.ts +103 -10
  223. package/src/observer-push.test.ts +76 -0
  224. package/src/opencode-catalog-report-http.test.ts +139 -0
  225. package/src/opencode-v2-catalog.test.ts +282 -0
  226. package/src/opencode-v2-catalog.ts +357 -0
  227. package/src/package-self-contained.test.ts +32 -0
  228. package/src/package-version-consistency.test.ts +25 -0
  229. package/src/parent-infer.test.ts +82 -0
  230. package/src/parent-infer.ts +110 -0
  231. package/src/parent-source-marker.test.ts +70 -0
  232. package/src/parent-source-orphan.test.ts +121 -0
  233. package/src/password-network-tokens.ts +25 -0
  234. package/src/peer-reply-atomic.test.ts +462 -0
  235. package/src/peer-reply-capability.test.ts +70 -0
  236. package/src/pg-worker.ts +87 -0
  237. package/src/poll-pacing.test.ts +74 -0
  238. package/src/poll-pacing.ts +123 -0
  239. package/src/probe-provider-error-domain.test.ts +145 -0
  240. package/src/project-dir-warn-clear-http.test.ts +132 -0
  241. package/src/project-viewer-can-http.test.ts +116 -0
  242. package/src/provider-skill-error-domain.test.ts +130 -0
  243. package/src/provider-tools-shape.test.ts +165 -0
  244. package/src/push.test.ts +20 -10
  245. package/src/push.ts +373 -9
  246. package/src/redact-tokens.test.ts +86 -0
  247. package/src/redact-tokens.ts +43 -0
  248. package/src/rejection-counters.test.ts +72 -0
  249. package/src/rejection-counters.ts +173 -0
  250. package/src/rename.ts +38 -10
  251. package/src/reply-target-derivation.test.ts +96 -0
  252. package/src/report-status-handover-capabilities-http.test.ts +124 -0
  253. package/src/report-status-host-schema.test.ts +272 -0
  254. package/src/report-status-resume-id-handover.test.ts +184 -0
  255. package/src/report-status-secret-keys.test.ts +140 -0
  256. package/src/require-explicit-test-db.ts +9 -0
  257. package/src/requirement-due-reminders-http.test.ts +620 -0
  258. package/src/requirement-due-reminders.ts +416 -0
  259. package/src/requirement-events-http.test.ts +318 -0
  260. package/src/requirement-events.test.ts +45 -0
  261. package/src/requirement-events.ts +144 -0
  262. package/src/requirement-notify.ts +165 -0
  263. package/src/requirement-participant-notify-http.test.ts +313 -0
  264. package/src/requirement-tag-ops-http.test.ts +454 -0
  265. package/src/requirement-tag-tree-http.test.ts +275 -0
  266. package/src/requirement-tag-tree.ts +127 -0
  267. package/src/requirement-tags.ts +102 -0
  268. package/src/requirements-abandoned-http.test.ts +236 -0
  269. package/src/requirements-assignee-drift.test.ts +154 -0
  270. package/src/requirements-comment-http.test.ts +174 -0
  271. package/src/requirements-completed-at-migration.test.ts +70 -0
  272. package/src/requirements-errors-mcp-http.test.ts +164 -0
  273. package/src/requirements-errors.ts +158 -0
  274. package/src/requirements-etag-http.test.ts +91 -0
  275. package/src/requirements-http.test.ts +709 -0
  276. package/src/requirements-last-event-http.test.ts +349 -0
  277. package/src/requirements-list-mcp-slim-http.test.ts +155 -0
  278. package/src/requirements-list-slim-http.test.ts +324 -0
  279. package/src/requirements-mcp.test.ts +180 -0
  280. package/src/requirements-migrate.ts +283 -0
  281. package/src/requirements-owner-strict-mcp-http.test.ts +145 -0
  282. package/src/requirements-people-http.test.ts +114 -0
  283. package/src/requirements-people-mcp-http.test.ts +231 -0
  284. package/src/requirements-people.ts +196 -0
  285. package/src/requirements-priority-lowest.test.ts +114 -0
  286. package/src/requirements-projects-network-echo.test.ts +57 -0
  287. package/src/requirements-projects-parent-http.test.ts +123 -0
  288. package/src/requirements-search-http.test.ts +182 -0
  289. package/src/requirements-search.test.ts +32 -0
  290. package/src/requirements-search.ts +145 -0
  291. package/src/requirements-seq-http.test.ts +193 -0
  292. package/src/requirements-seq-migration.test.ts +63 -0
  293. package/src/requirements-start-date.test.ts +125 -0
  294. package/src/requirements-stats-http.test.ts +357 -0
  295. package/src/requirements-stats.ts +195 -0
  296. package/src/requirements-status-participants-http.test.ts +222 -0
  297. package/src/requirements-upgrade-e2e.test.ts +126 -0
  298. package/src/requirements-upgrade-migration.test.ts +98 -0
  299. package/src/requirements.ts +2205 -0
  300. package/src/resolve-port.test.ts +57 -0
  301. package/src/resolve-port.ts +44 -0
  302. package/src/rest-alias-network-fallback-http.test.ts +123 -0
  303. package/src/rest-alias-network-fallback.test.ts +60 -0
  304. package/src/rest-alias-network-fallback.ts +65 -0
  305. package/src/rest-explicit-columns-http.test.ts +266 -0
  306. package/src/rest-identity.test.ts +130 -0
  307. package/src/rest-identity.ts +141 -0
  308. package/src/rest-projections.ts +72 -0
  309. package/src/rest-read-network-real-chain.test.ts +97 -0
  310. package/src/rest-write-network-resolution.test.ts +133 -0
  311. package/src/restart-readiness-http.test.ts +121 -0
  312. package/src/restricted-files.ts +76 -0
  313. package/src/retention-first-sweep-quiet.test.ts +31 -0
  314. package/src/retention.test.ts +100 -40
  315. package/src/retention.ts +423 -104
  316. package/src/route-callers-http.test.ts +120 -0
  317. package/src/route-timing.test.ts +218 -0
  318. package/src/route-timing.ts +262 -0
  319. package/src/rules-file-duplicate-alias.test.ts +234 -0
  320. package/src/rules-file-session-target.test.ts +207 -0
  321. package/src/rules-file-transport.test.ts +280 -0
  322. package/src/runtime-label.test.ts +22 -0
  323. package/src/runtime-label.ts +21 -0
  324. package/src/runtime-readiness.ts +90 -0
  325. package/src/schedule-agent-mcp-http.test.ts +486 -0
  326. package/src/schedule-agent.ts +252 -0
  327. package/src/schedule-starved.test.ts +92 -0
  328. package/src/schedule-starved.ts +114 -0
  329. package/src/scheduled-backoff-http.test.ts +203 -0
  330. package/src/scheduled-backoff.ts +64 -0
  331. package/src/scheduled-doorbell-nodeless-session.test.ts +134 -0
  332. package/src/scheduled-failure-backoff-2622.test.ts +145 -0
  333. package/src/scheduled-failure-code.test.ts +73 -0
  334. package/src/scheduled-failure-code.ts +105 -0
  335. package/src/scheduled-failures-http.test.ts +279 -0
  336. package/src/scheduled-failures.ts +425 -0
  337. package/src/scheduled-noprogress-backoff-2622.test.ts +163 -0
  338. package/src/scheduled-offline-backoff-probe.test.ts +56 -0
  339. package/src/scheduled-offline.test.ts +131 -0
  340. package/src/scheduled-offline.ts +66 -0
  341. package/src/scheduled-outcome-guidance-http.test.ts +139 -0
  342. package/src/scheduled-outcome-guidance.ts +9 -0
  343. package/src/scheduled-reply-unread-http.test.ts +212 -0
  344. package/src/scheduled-requirement-wake-http.test.ts +289 -0
  345. package/src/scheduled-requirement-wake.ts +125 -0
  346. package/src/scheduled-run-terminal.test.ts +290 -0
  347. package/src/scheduled-skip-blocking-task.test.ts +120 -0
  348. package/src/scheduled-skip-path-backoff-2622.test.ts +98 -0
  349. package/src/scheduled-stuck-http.test.ts +316 -0
  350. package/src/scheduled-stuck-notice-cap.test.ts +80 -0
  351. package/src/scheduled-stuck.ts +219 -0
  352. package/src/scheduled-tasks-http.test.ts +679 -0
  353. package/src/scheduled-tasks.ts +980 -0
  354. package/src/scheduled-work-outcome-http.test.ts +154 -0
  355. package/src/scheduled-work-outcome.ts +50 -0
  356. package/src/scoped-secrets.ts +167 -0
  357. package/src/secret-echo-negative-control.test.ts +118 -0
  358. package/src/send-dedup-request-id.test.ts +229 -0
  359. package/src/send-reply-agent-warning.test.ts +38 -38
  360. package/src/send-reply-alias-optional.test.ts +131 -0
  361. package/src/send-reply-attachments.test.ts +28 -7
  362. package/src/send_dedup.test.ts +54 -0
  363. package/src/send_dedup.ts +52 -6
  364. package/src/serve-error.test.ts +73 -0
  365. package/src/serve-error.ts +56 -0
  366. package/src/server.ts +5103 -377
  367. package/src/session-fork-store.test.ts +43 -0
  368. package/src/session-fork-store.ts +51 -0
  369. package/src/session-project-attach-migration.test.ts +23 -0
  370. package/src/session-project-attach-native.test.ts +123 -0
  371. package/src/session-project-create-http.test.ts +408 -0
  372. package/src/session-project-create-native.test.ts +292 -0
  373. package/src/session-project-create.ts +159 -0
  374. package/src/session-source-admission-store.ts +58 -0
  375. package/src/session-source-create.test.ts +155 -0
  376. package/src/session-source-create.ts +97 -0
  377. package/src/session-source-delivery.ts +114 -0
  378. package/src/session-source-directory-http.test.ts +196 -0
  379. package/src/session-source-evidence.test.ts +905 -0
  380. package/src/session-source-evidence.ts +191 -0
  381. package/src/session-source-execution.ts +87 -0
  382. package/src/session-source-grant.test.ts +117 -0
  383. package/src/session-source-grant.ts +78 -0
  384. package/src/session-source-issuer.test.ts +250 -0
  385. package/src/session-source-issuer.ts +164 -0
  386. package/src/session-source-transport.ts +381 -0
  387. package/src/session-task-on-dispatch.ts +14 -0
  388. package/src/session-token-ownership-http.test.ts +122 -0
  389. package/src/shared/codex-inventory.ts +41 -0
  390. package/src/shared/daemon-provider-login.ts +31 -0
  391. package/src/shared/daemon-provider-snapshot.ts +52 -0
  392. package/src/shared/external-schedule-contract.ts +60 -0
  393. package/src/shared/node-name.test.ts +62 -0
  394. package/src/shared/node-name.ts +161 -0
  395. package/src/shared/probe-host-allowlist-drift.test.ts +45 -0
  396. package/src/shared/provider-application.ts +29 -0
  397. package/src/shared/provider-collection.ts +14 -0
  398. package/src/shared/provider-initialization.ts +8 -0
  399. package/src/shared/reserved-env-drift.test.ts +10 -0
  400. package/src/shared/scoped-secret-contract.ts +5 -0
  401. package/src/shared/task-content-limit-drift.test.ts +28 -0
  402. package/src/shared/task-content-limit.ts +25 -0
  403. package/src/side-thread-command-transport.test.ts +312 -0
  404. package/src/side-thread-command-transport.ts +318 -0
  405. package/src/side-thread-http-integration.test.ts +233 -0
  406. package/src/side-thread-http.ts +504 -0
  407. package/src/side-thread-production.test.ts +72 -0
  408. package/src/side-thread-production.ts +118 -0
  409. package/src/side-thread.test.ts +1067 -0
  410. package/src/side-thread.ts +2499 -0
  411. package/src/skillhub-http.test.ts +144 -0
  412. package/src/sqlite-close-checkpoint.test.ts +78 -0
  413. package/src/start-node.test.ts +265 -0
  414. package/src/start-request-error-domain.test.ts +182 -0
  415. package/src/start-skill-error-domain.test.ts +122 -0
  416. package/src/stats-versions-http.test.ts +65 -0
  417. package/src/status-alias-filter-http.test.ts +106 -0
  418. package/src/status-alias-resolver-http.test.ts +163 -0
  419. package/src/status-alias-resolver.ts +19 -0
  420. package/src/status-node-id-filter-http.test.ts +161 -0
  421. package/src/status-node-secrets-capable-http.test.ts +44 -0
  422. package/src/status-read-cache-http.test.ts +229 -0
  423. package/src/status-read-cache.ts +129 -0
  424. package/src/stop-delete-node.test.ts +567 -1
  425. package/src/task-access-http.test.ts +407 -0
  426. package/src/task-access.ts +420 -0
  427. package/src/task-activity.ts +60 -0
  428. package/src/task-auth-origin-http.test.ts +93 -0
  429. package/src/task-auth-origin.test.ts +24 -0
  430. package/src/task-auth-origin.ts +7 -0
  431. package/src/task-consumption.test.ts +512 -0
  432. package/src/task-diagnostic-http.test.ts +149 -0
  433. package/src/task-diagnostic.test.ts +115 -0
  434. package/src/task-diagnostic.ts +118 -0
  435. package/src/task-expiry-notice-http.test.ts +298 -0
  436. package/src/task-expiry-notice.ts +318 -0
  437. package/src/task-idempotency-mcp.test.ts +148 -0
  438. package/src/task-idempotency.test.ts +76 -0
  439. package/src/task-idempotency.ts +81 -0
  440. package/src/task-late-replies.ts +54 -0
  441. package/src/task-late-reply-http.test.ts +227 -0
  442. package/src/task-lifecycle-watcher-busy.test.ts +114 -0
  443. package/src/task-lifecycle-watcher.test.ts +209 -0
  444. package/src/task-lifecycle-watcher.ts +109 -0
  445. package/src/task-network-resolution-http.test.ts +140 -0
  446. package/src/task-not-found-error-domain.test.ts +117 -0
  447. package/src/task-offline-delivery-2668.test.ts +119 -0
  448. package/src/task-offline-delivery.ts +81 -0
  449. package/src/task-orphan-http.test.ts +287 -0
  450. package/src/task-orphan.ts +119 -0
  451. package/src/task-queue-ahead-http.test.ts +309 -0
  452. package/src/task-queue-ahead-scale.test.ts +236 -0
  453. package/src/task-queue-ahead.ts +186 -0
  454. package/src/task-rejection-log-http.test.ts +160 -0
  455. package/src/task-rejection-log.ts +61 -0
  456. package/src/task-sender-http.test.ts +143 -0
  457. package/src/task-stale-open-http.test.ts +292 -0
  458. package/src/task-stale-open.ts +103 -0
  459. package/src/tasks-pagination-http.test.ts +141 -0
  460. package/src/team-rules-status-http.test.ts +90 -0
  461. package/src/team-rules-status.test.ts +59 -0
  462. package/src/team-rules-status.ts +72 -0
  463. package/src/test-work-root.ts +18 -0
  464. package/src/tmux-allowlist.test.ts +48 -0
  465. package/src/token-usage-http.test.ts +156 -0
  466. package/src/tool-audience-http.test.ts +266 -0
  467. package/src/tool-audience.ts +130 -0
  468. package/src/tools-list-json-schema.test.ts +94 -0
  469. package/src/tools.ts +4557 -472
  470. package/src/update-node-config-error-domain.test.ts +107 -0
  471. package/src/uploads-http.test.ts +6 -4
  472. package/src/uploads.ts +23 -4
  473. package/src/user-avatar-http.test.ts +74 -0
  474. package/src/user-avatar-image.ts +160 -0
  475. package/src/user-avatar-migration.test.ts +25 -0
  476. package/src/user-avatar-upload-http.test.ts +353 -0
  477. package/src/user-inbox-by-agent-http.test.ts +189 -0
  478. package/src/user-inbox-netid-notnull.test.ts +122 -0
  479. package/src/user-inbox-read-http.test.ts +223 -0
  480. package/src/user-inbox-schema.test.ts +54 -0
  481. package/src/version-stats.test.ts +66 -0
  482. package/src/version-stats.ts +109 -0
@@ -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,128 @@
1
+ // #3952 —— 节点 Token 审计:记账能累加、读账按节点聚合、且**只收计数不收内容**。
2
+ //
3
+ // admin 原话:「要对节点进行 Token 审计了,能看到节点消耗了多少 Token」。
4
+ // 现状是 Hub 里一行都没有(api_tokens 是鉴权令牌 id,不是用量),
5
+ // 而节点侧其实看得到(claude/codex 每轮都有 input/output tokens,只是打进了日志)。
6
+ //
7
+ // 判据四格:
8
+ // ① 累加:同一小时同一 model 报两次 ⇒ 相加(一轮一报是常态,不是覆盖)
9
+ // ② 读账:按节点聚合、按 total 降序(审计第一眼看"谁最多")
10
+ // ③ 口径:hour 是 UTC 小时桶;sinceHours 用它比较,与写入同口径
11
+ // ④ 形状:表里**没有**任何内容列(prompt / message / credential)—— 由列清单钉住
12
+ import { describe, expect, test } from 'bun:test';
13
+ import './require-explicit-test-db';
14
+ import { db } from './db';
15
+ import {
16
+ currentHourUtc,
17
+ normalizeUsage,
18
+ readTokenUsage,
19
+ reportTokenUsage,
20
+ NODE_TOKEN_USAGE_COLUMNS,
21
+ } from './node-token-usage';
22
+
23
+ const net = 'net_tok_usage';
24
+ const nodeA = 'n_tok_a';
25
+ const nodeB = 'n_tok_b';
26
+
27
+ function cleanup() {
28
+ db.run('DELETE FROM node_token_usage WHERE network_id = ?1', [net]);
29
+ db.run('DELETE FROM nodes WHERE network_id = ?1', [net]);
30
+ }
31
+
32
+ describe("#3952 节点 Token 审计", () => {
33
+ test("① 同一小时同一 model 报两次 ⇒ 累加", () => {
34
+ cleanup();
35
+ const hour = '2026-11-05T10';
36
+ expect(reportTokenUsage({ networkId: net, nodeId: nodeA, hour, model: 'deepseek/flash', inputTokens: 100, outputTokens: 20 }).ok).toBe(true);
37
+ expect(reportTokenUsage({ networkId: net, nodeId: nodeA, hour, model: 'deepseek/flash', inputTokens: 50, outputTokens: 10 }).ok).toBe(true);
38
+ const row = db.get<any>('SELECT input_tokens, output_tokens FROM node_token_usage WHERE network_id=?1 AND node_id=?2 AND hour=?3', net, nodeA, hour);
39
+ expect(row.input_tokens).toBe(150);
40
+ expect(row.output_tokens).toBe(30);
41
+ });
42
+
43
+ test("② 读账按节点聚合、按 total 降序", () => {
44
+ cleanup();
45
+ const hour = currentHourUtc();
46
+ db.run('INSERT INTO nodes(node_id,node_name,alias,network_id) VALUES(?1,?2,?2,?3)', [nodeA, 'aliasA', net]);
47
+ db.run('INSERT INTO nodes(node_id,node_name,alias,network_id) VALUES(?1,?2,?2,?3)', [nodeB, 'aliasB', net]);
48
+ reportTokenUsage({ networkId: net, nodeId: nodeA, hour, model: 'm', inputTokens: 10, outputTokens: 5 });
49
+ reportTokenUsage({ networkId: net, nodeId: nodeB, hour, model: 'm', inputTokens: 900, outputTokens: 100 });
50
+ const rows = readTokenUsage(net, 24);
51
+ expect(rows.map((r) => r.node_id)).toEqual([nodeB, nodeA]);
52
+ expect(rows[0].total_tokens).toBe(1000);
53
+ expect(rows[0].alias).toBe('aliasB');
54
+ });
55
+
56
+ test("③ 口径:窗口外的行不出现(hour 是 UTC 小时桶)", () => {
57
+ cleanup();
58
+ const now = currentHourUtc();
59
+ const old = currentHourUtc(Date.now() - 48 * 3600_000);
60
+ reportTokenUsage({ networkId: net, nodeId: nodeA, hour: now, model: 'm', inputTokens: 1, outputTokens: 1 });
61
+ reportTokenUsage({ networkId: net, nodeId: nodeA, hour: old, model: 'm', inputTokens: 999, outputTokens: 999 });
62
+ const rows = readTokenUsage(net, 24);
63
+ expect(rows.length).toBe(1);
64
+ expect(rows[0].total_tokens).toBe(2);
65
+ });
66
+
67
+ test("cache 单列:报进去不进 total(它是 input 的几百倍,混算会把排行变成「谁最老」)", () => {
68
+ cleanup();
69
+ const hour = currentHourUtc();
70
+ reportTokenUsage({ networkId: net, nodeId: nodeA, hour, model: 'm', inputTokens: 100, outputTokens: 10, cacheReadTokens: 50_000 });
71
+ const rows = readTokenUsage(net, 24);
72
+ expect(rows[0].total_tokens).toBe(110);
73
+ expect(rows[0].cache_read_tokens).toBe(50_000);
74
+ });
75
+
76
+ test("④ 形状:表里没有任何内容列(prompt / message / credential 一律不存在)", () => {
77
+ const shape = [...NODE_TOKEN_USAGE_COLUMNS].join(",");
78
+ expect(shape).not.toMatch(/prompt|message|content|credential|secret|token_value/i);
79
+ const cols = db.all<{ name: string }>("PRAGMA table_info(node_token_usage)").map((c) => c.name);
80
+ expect(cols.sort()).toEqual([...NODE_TOKEN_USAGE_COLUMNS].sort());
81
+ });
82
+
83
+ test("什么都不报 ⇒ 拒绝,且不写全 0 行(0 与「没上报」不能同形)", () => {
84
+ cleanup();
85
+ expect(reportTokenUsage({ networkId: net, nodeId: nodeA }).ok).toBe(false);
86
+ const n = db.get<{ c: number }>('SELECT COUNT(*) AS c FROM node_token_usage WHERE network_id=?1', net)?.c;
87
+ expect(n).toBe(0);
88
+ });
89
+
90
+ test("hour 形状不对 ⇒ 拒绝(不做「猜一个」)", () => {
91
+ expect(normalizeUsage({ networkId: net, nodeId: nodeA, hour: '2026-11-05 10:00:00', inputTokens: 1 })).toBeNull();
92
+ });
93
+
94
+ test("镜像:turns / cost 没给就留空(不填 0 冒充「知道」)", () => {
95
+ const norm = normalizeUsage({ networkId: net, nodeId: nodeA, hour: '2026-11-05T10', inputTokens: 5 });
96
+ expect(norm?.turns).toBeNull();
97
+ expect(norm?.costUsd).toBeNull();
98
+ });
99
+ });
100
+
101
+ // #3950 —— 覆盖率分母:让「只有一行」不被读成「只有一个节点在干活」。
102
+ import { reportsTokenUsage, tokenUsageCoverage } from "./node-token-usage";
103
+
104
+ describe("#3950 覆盖率分母", () => {
105
+ test("版本判定:>= .180 会报;旧版本不会;解析不出返回 null(不猜)", () => {
106
+ expect(reportsTokenUsage("2.5.0-preview.181")).toBe(true);
107
+ expect(reportsTokenUsage("2.5.0-preview.180")).toBe(true);
108
+ expect(reportsTokenUsage("2.5.0-preview.164")).toBe(false);
109
+ expect(reportsTokenUsage("2.4.1-preview.9")).toBeNull();
110
+ expect(reportsTokenUsage("")).toBeNull();
111
+ expect(reportsTokenUsage(null)).toBeNull();
112
+ });
113
+
114
+ test("分母三数:reporting / capable / 未知版本各自独立", () => {
115
+ const rows = [
116
+ { version: "2.5.0-preview.181" }, { version: "2.5.0-preview.164" },
117
+ { version: "2.5.0-preview.146" }, { version: "codex-app-server" },
118
+ { version: null },
119
+ ];
120
+ const cov = tokenUsageCoverage("net_x", 1, () => rows);
121
+ expect(cov.reporting_nodes).toBe(1);
122
+ expect(cov.capable_nodes).toBe(1);
123
+ expect(cov.sessions_with_version).toBe(3);
124
+ expect(cov.sessions_without_known_version).toBe(2);
125
+ // 镜像:capable 只统计「能解析且 >= 阈值」,不等于 sessions_with_version
126
+ expect(cov.capable_nodes).toBeLessThan(cov.sessions_with_version);
127
+ });
128
+ });
@@ -0,0 +1,228 @@
1
+ // #3952(admin 2026-11-05「要对节点进行 Token 审计,能看到节点消耗了多少 Token」)
2
+ //
3
+ // 现状:Hub 里**没有任何** token 用量记账 —— 只有 api_tokens(那是鉴权用的令牌 id,
4
+ // 和"消耗了多少 token"是两回事)。节点侧其实**看得到**用量(claude/codex 的每轮结果里
5
+ // 都有 input_tokens / output_tokens,只是打进了日志),但从来没有上报。
6
+ //
7
+ // 本模块只做「记账 + 读账」,不做采集:
8
+ // 写 reportTokenUsage() 节点令牌专用,按 (network, node, hour, model) 累加
9
+ // 读 readTokenUsage() 人(成员/owner/admin)按节点聚合
10
+ //
11
+ // 已知边界:turns / cost_usd 列 NOT NULL DEFAULT 0 ⇒ 「没报」与「报了 0」在存储上同形。
12
+ // 要区分得再加一列 has_turns;当前不值这个复杂度(谁要区分,读 normalizeUsage 的返回值)。
13
+ //
14
+ // 三条口径(写死,避免以后各说各话):
15
+ // ① hour 是 **UTC 小时桶**('YYYY-MM-DDTHH'),与 node_tool_calls 同口径。
16
+ // ② 累加而不是覆盖:同一小时同一 model 多次上报要相加 —— 一轮一报是常态。
17
+ // ③ **只收计数,不收内容**:没有 prompt、没有消息 id、没有凭据。
18
+ // 这一点由 schema 的形状保证(列就那几个),也由测试钉住。
19
+
20
+ import { db } from './db';
21
+
22
+ // 建表放在**本模块**而不是别处的 schema 大块:那样只要 import 了本模块,表就一定在。
23
+ // (2026-11-05 踩过:放 node-permissions.ts 的 exec 块里,单测没 import 它 ⇒ no such table。)
24
+ db.exec(`
25
+ CREATE TABLE IF NOT EXISTS node_token_usage (
26
+ network_id TEXT NOT NULL,
27
+ node_id TEXT NOT NULL,
28
+ hour TEXT NOT NULL,
29
+ model TEXT NOT NULL DEFAULT 'unknown',
30
+ input_tokens INTEGER NOT NULL DEFAULT 0,
31
+ output_tokens INTEGER NOT NULL DEFAULT 0,
32
+ cache_read_tokens INTEGER NOT NULL DEFAULT 0,
33
+ turns INTEGER NOT NULL DEFAULT 0,
34
+ cost_usd REAL NOT NULL DEFAULT 0,
35
+ updated_at TEXT NOT NULL DEFAULT (datetime('now')),
36
+ PRIMARY KEY (network_id, node_id, hour, model)
37
+ );
38
+ CREATE INDEX IF NOT EXISTS idx_node_token_usage_hour ON node_token_usage(network_id, hour);
39
+ `);
40
+ // 已存在的库补列(SQLite 没有 IF NOT EXISTS for ADD COLUMN)
41
+ try { db.exec("ALTER TABLE node_token_usage ADD COLUMN cache_read_tokens INTEGER NOT NULL DEFAULT 0"); } catch {}
42
+
43
+ export interface TokenUsageInput {
44
+ networkId: string;
45
+ nodeId: string;
46
+ /** 'YYYY-MM-DDTHH'(UTC);缺省 = 现在这一小时 */
47
+ hour?: string | null;
48
+ /** provider/model 或运行时的自有标识;缺省 'unknown' —— 不假装知道 */
49
+ model?: string | null;
50
+ inputTokens?: number | null;
51
+ outputTokens?: number | null;
52
+ /** 缓存命中的读入量。**必须单列**:opencode 实测 cache.read 是 input+output 的 289 倍,
53
+ * 混进去算会让「谁用得多」变成「谁用得久」。 */
54
+ cacheReadTokens?: number | null;
55
+ /** 有的运行时只给总轮数/费用;没有就留空,**不填 0**(0 与"不知道"是两件事) */
56
+ turns?: number | null;
57
+ costUsd?: number | null;
58
+ }
59
+
60
+ const HOUR_RE = /^\d{4}-\d{2}-\d{2}T\d{2}$/;
61
+ const MODEL_MAX = 100;
62
+
63
+ export function currentHourUtc(now = Date.now()): string {
64
+ return new Date(now).toISOString().slice(0, 13);
65
+ }
66
+
67
+ function nonNegativeInt(value: unknown): number | null {
68
+ if (typeof value !== 'number' || !Number.isFinite(value) || value < 0) return null;
69
+ if (!Number.isSafeInteger(Math.round(value))) return null;
70
+ return Math.round(value);
71
+ }
72
+
73
+ /** 校验 + 归一。返回 null 表示「这一份上报不合规」——调用方负责拒绝,不静默丢。 */
74
+ export function normalizeUsage(input: TokenUsageInput): {
75
+ hour: string; model: string;
76
+ inputTokens: number; outputTokens: number; cacheReadTokens: number;
77
+ turns: number | null; costUsd: number | null;
78
+ } | null {
79
+ const hour = typeof input.hour === 'string' && input.hour ? input.hour : currentHourUtc();
80
+ if (!HOUR_RE.test(hour)) return null;
81
+ const rawModel = typeof input.model === 'string' ? input.model.trim() : '';
82
+ if (rawModel.length > MODEL_MAX) return null;
83
+ const model = rawModel || 'unknown';
84
+ const inputTokens = nonNegativeInt(input.inputTokens) ?? 0;
85
+ const outputTokens = nonNegativeInt(input.outputTokens) ?? 0;
86
+ const cacheReadTokens = nonNegativeInt(input.cacheReadTokens) ?? 0;
87
+ if (inputTokens === 0 && outputTokens === 0 && cacheReadTokens === 0 && input.turns == null && input.costUsd == null) {
88
+ // 什么都没报:不写一行全 0 的记录(那会让"没有用量"和"没上报"在报表上同形)。
89
+ return null;
90
+ }
91
+ const turns = nonNegativeInt(input.turns);
92
+ const costRaw = input.costUsd;
93
+ const costUsd = typeof costRaw === 'number' && Number.isFinite(costRaw) && costRaw >= 0 ? costRaw : null;
94
+ return { hour, model, inputTokens, outputTokens, cacheReadTokens, turns, costUsd };
95
+ }
96
+
97
+ /** 记账:同一 (network, node, hour, model) 累加。turns/cost 可空,空则保持原值。 */
98
+ export function reportTokenUsage(input: TokenUsageInput): { ok: true; hour: string; model: string } | { ok: false; error: string } {
99
+ const norm = normalizeUsage(input);
100
+ if (!norm) return { ok: false, error: 'invalid_token_usage' };
101
+ db.run(
102
+ `INSERT INTO node_token_usage(network_id, node_id, hour, model, input_tokens, output_tokens, cache_read_tokens, turns, cost_usd, updated_at)
103
+ VALUES(?1, ?2, ?3, ?4, ?5, ?6, ?7, COALESCE(?8, 0), COALESCE(?9, 0), datetime('now'))
104
+ ON CONFLICT(network_id, node_id, hour, model) DO UPDATE SET
105
+ input_tokens = input_tokens + excluded.input_tokens,
106
+ output_tokens = output_tokens + excluded.output_tokens,
107
+ cache_read_tokens = cache_read_tokens + excluded.cache_read_tokens,
108
+ turns = COALESCE(turns, 0) + COALESCE(excluded.turns, 0),
109
+ cost_usd = COALESCE(cost_usd, 0) + COALESCE(excluded.cost_usd, 0),
110
+ updated_at = datetime('now')`,
111
+ // turns / cost_usd 这里存 0 = 「没有这一项」。**存储层不区分「0 轮」与「没报轮数」**,
112
+ // 这是已知偏差(见文件头「已知边界」);要区分得加一列 has_turns,成本不值。
113
+ [input.networkId, input.nodeId, norm.hour, norm.model, norm.inputTokens, norm.outputTokens,
114
+ norm.cacheReadTokens, norm.turns, norm.costUsd],
115
+ );
116
+ return { ok: true, hour: norm.hour, model: norm.model };
117
+ }
118
+
119
+ export interface NodeTokenUsageRow {
120
+ node_id: string;
121
+ alias: string | null;
122
+ input_tokens: number;
123
+ output_tokens: number;
124
+ /** input+output(**不含 cache**)—— 报表默认看这个 */
125
+ total_tokens: number;
126
+ /** 单列;opencode 上它可能是 total 的几百倍 */
127
+ cache_read_tokens: number;
128
+ turns: number;
129
+ cost_usd: number;
130
+ models: number;
131
+ first_hour: string | null;
132
+ last_hour: string | null;
133
+ }
134
+
135
+ /**
136
+ * 读账:按节点聚合。`sinceHours` 用 UTC 小时桶比较(与写入同口径)。
137
+ *
138
+ * 排序:total_tokens 降序 —— 审计第一眼要看"谁最多",而不是按名字排。
139
+ */
140
+ export function readTokenUsage(networkId: string, sinceHours = 24): NodeTokenUsageRow[] {
141
+ const hours = Math.max(1, Math.min(24 * 90, Math.floor(sinceHours)));
142
+ const since = currentHourUtc(Date.now() - hours * 3600_000);
143
+ const rows = db.all<{
144
+ node_id: string; alias: string | null;
145
+ input_tokens: number; output_tokens: number;
146
+ // #3950 —— SELECT 里已经有 SUM(cache_read_tokens),类型漏了它时
147
+ // `r.cache_read_tokens` 在 TS 上是错的,而运行期是 undefined ⇒ totals 变成 NaN。
148
+ cache_read_tokens: number | null;
149
+ turns: number; cost_usd: number; models: number;
150
+ first_hour: string | null; last_hour: string | null;
151
+ }>(
152
+ `SELECT u.node_id,
153
+ COALESCE(n.alias, s.alias) AS alias,
154
+ SUM(u.input_tokens) AS input_tokens,
155
+ SUM(u.output_tokens) AS output_tokens,
156
+ SUM(u.cache_read_tokens) AS cache_read_tokens,
157
+ SUM(u.turns) AS turns,
158
+ SUM(u.cost_usd) AS cost_usd,
159
+ COUNT(DISTINCT u.model) AS models,
160
+ MIN(u.hour) AS first_hour,
161
+ MAX(u.hour) AS last_hour
162
+ FROM node_token_usage u
163
+ LEFT JOIN nodes n ON n.node_id = u.node_id AND n.network_id = u.network_id
164
+ LEFT JOIN sessions s ON s.node_id = u.node_id AND s.network_id = u.network_id
165
+ WHERE u.network_id = ?1 AND u.hour >= ?2
166
+ GROUP BY u.node_id
167
+ ORDER BY (SUM(u.input_tokens) + SUM(u.output_tokens)) DESC`,
168
+ networkId, since,
169
+ );
170
+ return rows.map((r) => ({
171
+ ...r,
172
+ cache_read_tokens: r.cache_read_tokens ?? 0,
173
+ total_tokens: (r.input_tokens ?? 0) + (r.output_tokens ?? 0),
174
+ }));
175
+ }
176
+
177
+ /** 记账表与读账口径都只认这几个列 —— 形状就是「不收内容」的保证。 */
178
+ export const NODE_TOKEN_USAGE_COLUMNS = [
179
+ 'network_id', 'node_id', 'hour', 'model',
180
+ 'input_tokens', 'output_tokens', 'cache_read_tokens', 'turns', 'cost_usd', 'updated_at',
181
+ ] as const;
182
+
183
+ // ── 覆盖率:让「只有一行」不被读成「只有一个节点在干活」 ──
184
+ //
185
+ // 生产实测(2026-11-06):203 个 agent-node 里只有 1 个 >= .180(会报 token),
186
+ // 其余停在 .164 / .146。于是 /api/token-usage 只返回 1 行 —— 那不是"系统没工作",
187
+ // 是"几乎没有节点拥有这个能力"。这两个解释在报表上同形,分母必须一起给。
188
+
189
+ /** agent-node 从哪一版开始上报 token(.180 加 claude/codex,.181 加 opencode 增量)。 */
190
+ export const TOKEN_USAGE_MIN_PREVIEW = 180;
191
+
192
+ /** 这个 version 字符串会不会上报 token:true / false / null(解析不出,不猜)。 */
193
+ export function reportsTokenUsage(version: string | null | undefined): boolean | null {
194
+ const raw = typeof version === "string" ? version.trim() : "";
195
+ const m = /^2\.5\.0-preview\.(\d+)$/.exec(raw);
196
+ if (!m) return null; // 换版本线 / 旧格式 ⇒ 不知道,不猜
197
+ return Number(m[1]) >= TOKEN_USAGE_MIN_PREVIEW;
198
+ }
199
+
200
+ export interface TokenUsageCoverage {
201
+ reporting_nodes: number;
202
+ /** 会话里能解析出版本、且版本 >= 阈值的数量(能力分母) */
203
+ capable_nodes: number;
204
+ sessions_with_version: number;
205
+ /** 解析不出版本线的会话数(不含在 capable 里,也不假装它们不能报) */
206
+ sessions_without_known_version: number;
207
+ }
208
+
209
+ export function tokenUsageCoverage(
210
+ networkId: string,
211
+ reportingNodes: number,
212
+ get: (sql: string, ...params: any[]) => Array<{ version: string | null }>,
213
+ ): TokenUsageCoverage {
214
+ const rows = get("SELECT version FROM sessions WHERE network_id = ?1", networkId);
215
+ let capable = 0, known = 0;
216
+ for (const r of rows) {
217
+ const verdict = reportsTokenUsage(r.version);
218
+ if (verdict === null) continue;
219
+ known += 1;
220
+ if (verdict) capable += 1;
221
+ }
222
+ return {
223
+ reporting_nodes: reportingNodes,
224
+ capable_nodes: capable,
225
+ sessions_with_version: known,
226
+ sessions_without_known_version: rows.length - known,
227
+ };
228
+ }
@@ -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
+ });