@sleep2agi/commhub-server 0.9.0-preview.26 → 0.9.0-preview.260

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 (429) 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 +228 -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 +487 -0
  13. package/src/agent-acl-groups-http.test.ts +247 -0
  14. package/src/agent-acl-http.test.ts +680 -0
  15. package/src/agent-acl-slice3-http.test.ts +885 -0
  16. package/src/agent-department-http.test.ts +215 -0
  17. package/src/agent-groups-perf.test.ts +223 -0
  18. package/src/agent-notice.ts +48 -0
  19. package/src/agent-team-whoami-http.test.ts +98 -0
  20. package/src/agent-teams-http.test.ts +330 -0
  21. package/src/agent-teams.ts +244 -0
  22. package/src/alias-baseline-2571.test.ts +162 -0
  23. package/src/alias-baseline.ts +113 -0
  24. package/src/alias-filter.test.ts +72 -0
  25. package/src/alias-filter.ts +42 -0
  26. package/src/api-host-supervisors-can-create-nodes.test.ts +350 -0
  27. package/src/api-host-supervisors-fallback.test.ts +6 -7
  28. package/src/api-host-supervisors-runtime-readiness.test.ts +195 -0
  29. package/src/api-nodes-shape.test.ts +131 -4
  30. package/src/auth-abuse-counters.test.ts +125 -0
  31. package/src/auth-abuse-counters.ts +122 -0
  32. package/src/auth-password-change-cli-tokens-http.test.ts +423 -0
  33. package/src/auth-sessions-http.test.ts +260 -0
  34. package/src/auth-validate.test.ts +5 -1
  35. package/src/auth-weak-password-login.test.ts +176 -0
  36. package/src/auth.ts +609 -56
  37. package/src/backfill-node-ids-2664.test.ts +128 -0
  38. package/src/binding-generation-http.test.ts +141 -0
  39. package/src/blocked-exit-on-reply.test.ts +122 -0
  40. package/src/broadcast-fanout-2721.test.ts +149 -0
  41. package/src/broadcast-fanout.ts +117 -0
  42. package/src/build-commit-report-http.test.ts +128 -0
  43. package/src/build-info.test.ts +60 -0
  44. package/src/build-info.ts +85 -0
  45. package/src/chain-attempt-dedup.test.ts +447 -0
  46. package/src/clip.test.ts +36 -0
  47. package/src/clip.ts +48 -0
  48. package/src/clone-node.test.ts +269 -0
  49. package/src/clone-node.ts +289 -0
  50. package/src/codex-config-flags.ts +77 -0
  51. package/src/codex-fork-contract.ts +23 -0
  52. package/src/codex-fork-migration.test.ts +38 -0
  53. package/src/commhub-bin-args.test.ts +85 -0
  54. package/src/config-apply-validate.test.ts +188 -1
  55. package/src/config-apply-validate.ts +222 -3
  56. package/src/cors-origins.test.ts +73 -0
  57. package/src/create-node-blocked-gate.test.ts +365 -0
  58. package/src/create-node-error-domain.test.ts +124 -0
  59. package/src/create-node-network-id.test.ts +91 -0
  60. package/src/create-node-tool-schema.test.ts +49 -0
  61. package/src/create-node-unicode-name.test.ts +126 -0
  62. package/src/create-node-validate.test.ts +199 -7
  63. package/src/create-node-validate.ts +232 -15
  64. package/src/create-node-workdir.test.ts +298 -0
  65. package/src/create-node.ts +88 -23
  66. package/src/daemon-provider-snapshots.test.ts +453 -0
  67. package/src/daemon-provider-snapshots.ts +327 -0
  68. package/src/daemon-token-owner-http.test.ts +346 -0
  69. package/src/dashboard-slash-routing-http.test.ts +109 -0
  70. package/src/db-adapter-guard.test.ts +148 -0
  71. package/src/db-adapter-translate.test.ts +128 -0
  72. package/src/db-adapter.ts +377 -91
  73. package/src/db-timestamp.test.ts +38 -0
  74. package/src/db-timestamp.ts +15 -0
  75. package/src/db.ts +1269 -153
  76. package/src/delivered-without-push.test.ts +140 -0
  77. package/src/department-groups-http.test.ts +209 -0
  78. package/src/department-groups-sync-http.test.ts +328 -0
  79. package/src/department-groups.ts +434 -0
  80. package/src/department-heads-http.test.ts +350 -0
  81. package/src/department-heads.ts +226 -0
  82. package/src/departments-agent-count.test.ts +139 -0
  83. package/src/departments-http.test.ts +185 -0
  84. package/src/departments-mcp-error-domain.test.ts +135 -0
  85. package/src/departments-mcp.test.ts +128 -0
  86. package/src/departments.ts +318 -0
  87. package/src/desktop-message-seam.test.ts +150 -0
  88. package/src/desktop-message.test.ts +368 -0
  89. package/src/dm-file-scope-http.test.ts +178 -0
  90. package/src/empty-node-sweeper.test.ts +104 -0
  91. package/src/empty-node-sweeper.ts +88 -0
  92. package/src/env-transport-gate-http.test.ts +240 -0
  93. package/src/env-transport-gate.ts +80 -0
  94. package/src/env-transport-policy.ts +56 -0
  95. package/src/etag-of.test.ts +57 -0
  96. package/src/event-loop-lag.test.ts +180 -0
  97. package/src/event-loop-lag.ts +201 -0
  98. package/src/expiry-counters.test.ts +187 -0
  99. package/src/expiry-counters.ts +227 -0
  100. package/src/expiry-evidence-db.test.ts +103 -0
  101. package/src/ext-token-shared.test.ts +60 -0
  102. package/src/ext-validation-regression.test.ts +10 -17
  103. package/src/external-schedule-edits-http.test.ts +321 -0
  104. package/src/external-schedule-edits-timestamps.test.ts +64 -0
  105. package/src/external-schedule-edits.ts +327 -0
  106. package/src/file-download-authz-dev-open.test.ts +1 -1
  107. package/src/file-download-authz.test.ts +25 -4
  108. package/src/file-download-date-bucket.test.ts +1 -1
  109. package/src/file-network-scope-dev-open.test.ts +1 -1
  110. package/src/file-network-scope.test.ts +7 -6
  111. package/src/group-membership-events-http.test.ts +264 -0
  112. package/src/group-messages-http.test.ts +483 -0
  113. package/src/group-messages.ts +297 -0
  114. package/src/health-anon-readers.ts +67 -0
  115. package/src/health-host-disk-2756.test.ts +71 -0
  116. package/src/health-redaction.test.ts +1576 -7
  117. package/src/host-supervisor-identity-http.test.ts +152 -0
  118. package/src/host-supervisor-identity.ts +92 -0
  119. package/src/host-supervisors-daemon-version.test.ts +137 -0
  120. package/src/http-gzip.test.ts +94 -0
  121. package/src/http-gzip.ts +112 -0
  122. package/src/hub-catalog-read-http.test.ts +641 -0
  123. package/src/hub-provider-config.test.ts +166 -0
  124. package/src/hub-provider-config.ts +202 -0
  125. package/src/hub-timestamp.test.ts +38 -0
  126. package/src/hub-timestamp.ts +27 -0
  127. package/src/human-dm.ts +215 -0
  128. package/src/human-inbox.ts +42 -0
  129. package/src/inbox-caller.ts +49 -0
  130. package/src/inbox-count-sse.test.ts +318 -0
  131. package/src/inbox-count.ts +29 -0
  132. package/src/index.ts +6 -2
  133. package/src/license-state.test.ts +56 -0
  134. package/src/license-state.ts +48 -0
  135. package/src/lifecycle-error-domain.test.ts +109 -0
  136. package/src/list-ack-error-domain.test.ts +108 -0
  137. package/src/list-host-supervisors.test.ts +15 -4
  138. package/src/mcp-context-cost-http.test.ts +127 -0
  139. package/src/mcp-inflight.test.ts +92 -0
  140. package/src/mcp-inflight.ts +38 -0
  141. package/src/mcp-projects-events-http.test.ts +168 -0
  142. package/src/mcp-route-label-http.test.ts +120 -0
  143. package/src/mcp-write-network-resolution.test.ts +21 -0
  144. package/src/member-audit-network-id-http.test.ts +93 -0
  145. package/src/member-presence-http.test.ts +210 -0
  146. package/src/messages-ack-by-agent-http.test.ts +142 -0
  147. package/src/migrate-sqlite-to-pg.test.ts +47 -0
  148. package/src/migrate-sqlite-to-pg.ts +263 -0
  149. package/src/model-auth-notify-http.test.ts +181 -0
  150. package/src/model-auth-notify.ts +116 -0
  151. package/src/network-name-http.test.ts +75 -0
  152. package/src/network-rules-http.test.ts +169 -0
  153. package/src/network-rules.ts +129 -0
  154. package/src/network-scope.ts +222 -3
  155. package/src/network-token-membership-http.test.ts +186 -0
  156. package/src/node-alias-control.ts +12 -0
  157. package/src/node-attrs.test.ts +47 -2
  158. package/src/node-caller-identity-http.test.ts +1108 -0
  159. package/src/node-create-request-status-http.test.ts +105 -0
  160. package/src/node-daemon-bindings.test.ts +142 -0
  161. package/src/node-daemon-bindings.ts +135 -0
  162. package/src/node-failure-alert.test.ts +150 -0
  163. package/src/node-failure-alert.ts +177 -0
  164. package/src/node-files-transport.test.ts +350 -0
  165. package/src/node-health-codex-login.test.ts +120 -0
  166. package/src/node-health-dispatch-http.test.ts +373 -0
  167. package/src/node-health-guard.ts +121 -0
  168. package/src/node-health-passthrough.test.ts +115 -0
  169. package/src/node-health-store.ts +101 -0
  170. package/src/node-id-alias.test.ts +190 -0
  171. package/src/node-identity-conflict-http.test.ts +269 -0
  172. package/src/node-identity-conflict.ts +142 -0
  173. package/src/node-identity-mismatch.test.ts +74 -0
  174. package/src/node-in-flight-tasks.ts +31 -0
  175. package/src/node-lifecycle-controllable.test.ts +64 -0
  176. package/src/node-lifecycle-controllable.ts +53 -0
  177. package/src/node-lifecycle-read-http.test.ts +257 -0
  178. package/src/node-lifecycle-read.ts +124 -0
  179. package/src/node-logs-transport.test.ts +266 -0
  180. package/src/node-peer-allowlist.test.ts +114 -0
  181. package/src/node-permissions-http.test.ts +728 -0
  182. package/src/node-permissions.ts +494 -0
  183. package/src/node-request-retention.test.ts +281 -0
  184. package/src/node-request-retention.ts +120 -0
  185. package/src/node-secret-rest-http.test.ts +190 -0
  186. package/src/node-security-write-gate.test.ts +72 -0
  187. package/src/node-serviceability.test.ts +86 -0
  188. package/src/node-serviceability.ts +124 -0
  189. package/src/node-session-control-http.test.ts +310 -0
  190. package/src/node-session-control.ts +258 -0
  191. package/src/node-skills-transport.test.ts +212 -0
  192. package/src/node-token-identity.ts +35 -0
  193. package/src/node-token-ownership.ts +51 -0
  194. package/src/node-token-privilege-http.test.ts +158 -0
  195. package/src/not-found-api-http.test.ts +67 -0
  196. package/src/observer-avatar-http.test.ts +103 -10
  197. package/src/observer-push.test.ts +76 -0
  198. package/src/opencode-catalog-report-http.test.ts +139 -0
  199. package/src/opencode-v2-catalog.test.ts +268 -0
  200. package/src/opencode-v2-catalog.ts +356 -0
  201. package/src/package-version-consistency.test.ts +25 -0
  202. package/src/parent-source-marker.test.ts +50 -0
  203. package/src/password-network-tokens.ts +25 -0
  204. package/src/peer-reply-atomic.test.ts +462 -0
  205. package/src/peer-reply-capability.test.ts +70 -0
  206. package/src/pg-worker.ts +87 -0
  207. package/src/poll-pacing.test.ts +74 -0
  208. package/src/poll-pacing.ts +123 -0
  209. package/src/probe-provider-error-domain.test.ts +141 -0
  210. package/src/project-dir-warn-clear-http.test.ts +132 -0
  211. package/src/project-viewer-can-http.test.ts +116 -0
  212. package/src/provider-skill-error-domain.test.ts +130 -0
  213. package/src/provider-tools-shape.test.ts +165 -0
  214. package/src/push.test.ts +20 -10
  215. package/src/push.ts +373 -9
  216. package/src/redact-tokens.test.ts +86 -0
  217. package/src/redact-tokens.ts +43 -0
  218. package/src/rejection-counters.test.ts +72 -0
  219. package/src/rejection-counters.ts +173 -0
  220. package/src/rename.ts +38 -10
  221. package/src/reply-target-derivation.test.ts +96 -0
  222. package/src/report-status-handover-capabilities-http.test.ts +124 -0
  223. package/src/report-status-host-schema.test.ts +235 -0
  224. package/src/report-status-resume-id-handover.test.ts +184 -0
  225. package/src/report-status-secret-keys.test.ts +140 -0
  226. package/src/require-explicit-test-db.ts +9 -0
  227. package/src/requirement-due-reminders-http.test.ts +620 -0
  228. package/src/requirement-due-reminders.ts +416 -0
  229. package/src/requirement-events-http.test.ts +318 -0
  230. package/src/requirement-events.test.ts +45 -0
  231. package/src/requirement-events.ts +144 -0
  232. package/src/requirement-notify.ts +165 -0
  233. package/src/requirement-participant-notify-http.test.ts +313 -0
  234. package/src/requirement-tag-ops-http.test.ts +454 -0
  235. package/src/requirement-tag-tree-http.test.ts +275 -0
  236. package/src/requirement-tag-tree.ts +127 -0
  237. package/src/requirement-tags.ts +102 -0
  238. package/src/requirements-abandoned-http.test.ts +236 -0
  239. package/src/requirements-assignee-drift.test.ts +154 -0
  240. package/src/requirements-comment-http.test.ts +174 -0
  241. package/src/requirements-completed-at-migration.test.ts +70 -0
  242. package/src/requirements-errors-mcp-http.test.ts +164 -0
  243. package/src/requirements-errors.ts +158 -0
  244. package/src/requirements-etag-http.test.ts +91 -0
  245. package/src/requirements-http.test.ts +709 -0
  246. package/src/requirements-last-event-http.test.ts +349 -0
  247. package/src/requirements-list-mcp-slim-http.test.ts +155 -0
  248. package/src/requirements-list-slim-http.test.ts +324 -0
  249. package/src/requirements-mcp.test.ts +180 -0
  250. package/src/requirements-migrate.ts +283 -0
  251. package/src/requirements-owner-strict-mcp-http.test.ts +145 -0
  252. package/src/requirements-people-http.test.ts +114 -0
  253. package/src/requirements-people-mcp-http.test.ts +231 -0
  254. package/src/requirements-people.ts +196 -0
  255. package/src/requirements-priority-lowest.test.ts +114 -0
  256. package/src/requirements-projects-network-echo.test.ts +57 -0
  257. package/src/requirements-projects-parent-http.test.ts +123 -0
  258. package/src/requirements-search-http.test.ts +182 -0
  259. package/src/requirements-search.test.ts +32 -0
  260. package/src/requirements-search.ts +145 -0
  261. package/src/requirements-seq-http.test.ts +193 -0
  262. package/src/requirements-seq-migration.test.ts +63 -0
  263. package/src/requirements-start-date.test.ts +125 -0
  264. package/src/requirements-stats-http.test.ts +357 -0
  265. package/src/requirements-stats.ts +195 -0
  266. package/src/requirements-status-participants-http.test.ts +222 -0
  267. package/src/requirements-upgrade-e2e.test.ts +126 -0
  268. package/src/requirements-upgrade-migration.test.ts +98 -0
  269. package/src/requirements.ts +2205 -0
  270. package/src/resolve-port.test.ts +57 -0
  271. package/src/resolve-port.ts +44 -0
  272. package/src/rest-alias-network-fallback-http.test.ts +123 -0
  273. package/src/rest-alias-network-fallback.test.ts +60 -0
  274. package/src/rest-alias-network-fallback.ts +65 -0
  275. package/src/rest-explicit-columns-http.test.ts +266 -0
  276. package/src/rest-identity.test.ts +130 -0
  277. package/src/rest-identity.ts +141 -0
  278. package/src/rest-projections.ts +72 -0
  279. package/src/rest-read-network-real-chain.test.ts +97 -0
  280. package/src/rest-write-network-resolution.test.ts +133 -0
  281. package/src/restart-readiness-http.test.ts +121 -0
  282. package/src/restricted-files.ts +76 -0
  283. package/src/retention-first-sweep-quiet.test.ts +31 -0
  284. package/src/retention.test.ts +100 -40
  285. package/src/retention.ts +423 -104
  286. package/src/route-callers-http.test.ts +120 -0
  287. package/src/route-timing.test.ts +218 -0
  288. package/src/route-timing.ts +262 -0
  289. package/src/rules-file-duplicate-alias.test.ts +234 -0
  290. package/src/rules-file-session-target.test.ts +207 -0
  291. package/src/rules-file-transport.test.ts +271 -0
  292. package/src/runtime-label.test.ts +22 -0
  293. package/src/runtime-label.ts +21 -0
  294. package/src/runtime-readiness.ts +90 -0
  295. package/src/schedule-agent-mcp-http.test.ts +486 -0
  296. package/src/schedule-agent.ts +252 -0
  297. package/src/schedule-starved.test.ts +92 -0
  298. package/src/schedule-starved.ts +114 -0
  299. package/src/scheduled-backoff-http.test.ts +203 -0
  300. package/src/scheduled-backoff.ts +64 -0
  301. package/src/scheduled-doorbell-nodeless-session.test.ts +134 -0
  302. package/src/scheduled-failure-backoff-2622.test.ts +145 -0
  303. package/src/scheduled-failure-code.test.ts +73 -0
  304. package/src/scheduled-failure-code.ts +105 -0
  305. package/src/scheduled-failures-http.test.ts +279 -0
  306. package/src/scheduled-failures.ts +425 -0
  307. package/src/scheduled-noprogress-backoff-2622.test.ts +163 -0
  308. package/src/scheduled-offline-backoff-probe.test.ts +56 -0
  309. package/src/scheduled-offline.test.ts +131 -0
  310. package/src/scheduled-offline.ts +66 -0
  311. package/src/scheduled-outcome-guidance-http.test.ts +139 -0
  312. package/src/scheduled-outcome-guidance.ts +9 -0
  313. package/src/scheduled-reply-unread-http.test.ts +212 -0
  314. package/src/scheduled-requirement-wake-http.test.ts +289 -0
  315. package/src/scheduled-requirement-wake.ts +125 -0
  316. package/src/scheduled-run-terminal.test.ts +290 -0
  317. package/src/scheduled-skip-blocking-task.test.ts +120 -0
  318. package/src/scheduled-skip-path-backoff-2622.test.ts +98 -0
  319. package/src/scheduled-stuck-http.test.ts +316 -0
  320. package/src/scheduled-stuck-notice-cap.test.ts +80 -0
  321. package/src/scheduled-stuck.ts +219 -0
  322. package/src/scheduled-tasks-http.test.ts +679 -0
  323. package/src/scheduled-tasks.ts +959 -0
  324. package/src/scheduled-work-outcome-http.test.ts +154 -0
  325. package/src/scheduled-work-outcome.ts +50 -0
  326. package/src/scoped-secrets.ts +141 -0
  327. package/src/secret-echo-negative-control.test.ts +118 -0
  328. package/src/send-dedup-request-id.test.ts +229 -0
  329. package/src/send-reply-agent-warning.test.ts +38 -38
  330. package/src/send-reply-alias-optional.test.ts +131 -0
  331. package/src/send-reply-attachments.test.ts +28 -7
  332. package/src/send_dedup.test.ts +54 -0
  333. package/src/send_dedup.ts +52 -6
  334. package/src/serve-error.test.ts +73 -0
  335. package/src/serve-error.ts +56 -0
  336. package/src/server.ts +4842 -325
  337. package/src/session-task-on-dispatch.ts +14 -0
  338. package/src/session-token-ownership-http.test.ts +122 -0
  339. package/src/shared/codex-inventory.ts +41 -0
  340. package/src/shared/daemon-provider-login.ts +31 -0
  341. package/src/shared/daemon-provider-snapshot.ts +52 -0
  342. package/src/shared/external-schedule-contract.ts +60 -0
  343. package/src/shared/node-name.test.ts +62 -0
  344. package/src/shared/node-name.ts +161 -0
  345. package/src/shared/probe-host-allowlist-drift.test.ts +45 -0
  346. package/src/shared/provider-application.ts +29 -0
  347. package/src/shared/provider-collection.ts +14 -0
  348. package/src/shared/provider-initialization.ts +8 -0
  349. package/src/shared/reserved-env-drift.test.ts +10 -0
  350. package/src/shared/scoped-secret-contract.ts +5 -0
  351. package/src/shared/task-content-limit-drift.test.ts +28 -0
  352. package/src/shared/task-content-limit.ts +25 -0
  353. package/src/side-thread-command-transport.test.ts +312 -0
  354. package/src/side-thread-command-transport.ts +318 -0
  355. package/src/side-thread-http-integration.test.ts +233 -0
  356. package/src/side-thread-http.ts +504 -0
  357. package/src/side-thread-production.test.ts +72 -0
  358. package/src/side-thread-production.ts +118 -0
  359. package/src/side-thread.test.ts +1067 -0
  360. package/src/side-thread.ts +2499 -0
  361. package/src/skillhub-http.test.ts +144 -0
  362. package/src/sqlite-close-checkpoint.test.ts +78 -0
  363. package/src/start-node.test.ts +265 -0
  364. package/src/start-request-error-domain.test.ts +182 -0
  365. package/src/start-skill-error-domain.test.ts +122 -0
  366. package/src/stats-versions-http.test.ts +65 -0
  367. package/src/status-alias-filter-http.test.ts +106 -0
  368. package/src/status-alias-resolver-http.test.ts +163 -0
  369. package/src/status-alias-resolver.ts +19 -0
  370. package/src/status-node-id-filter-http.test.ts +161 -0
  371. package/src/status-read-cache-http.test.ts +229 -0
  372. package/src/status-read-cache.ts +129 -0
  373. package/src/stop-delete-node.test.ts +567 -1
  374. package/src/task-access-http.test.ts +402 -0
  375. package/src/task-access.ts +420 -0
  376. package/src/task-activity.ts +60 -0
  377. package/src/task-auth-origin-http.test.ts +93 -0
  378. package/src/task-auth-origin.test.ts +24 -0
  379. package/src/task-auth-origin.ts +7 -0
  380. package/src/task-consumption.test.ts +508 -0
  381. package/src/task-diagnostic-http.test.ts +149 -0
  382. package/src/task-diagnostic.test.ts +115 -0
  383. package/src/task-diagnostic.ts +118 -0
  384. package/src/task-expiry-notice-http.test.ts +298 -0
  385. package/src/task-expiry-notice.ts +318 -0
  386. package/src/task-idempotency-mcp.test.ts +148 -0
  387. package/src/task-idempotency.test.ts +76 -0
  388. package/src/task-idempotency.ts +81 -0
  389. package/src/task-late-replies.ts +54 -0
  390. package/src/task-late-reply-http.test.ts +227 -0
  391. package/src/task-lifecycle-watcher-busy.test.ts +114 -0
  392. package/src/task-lifecycle-watcher.test.ts +209 -0
  393. package/src/task-lifecycle-watcher.ts +109 -0
  394. package/src/task-network-resolution-http.test.ts +140 -0
  395. package/src/task-not-found-error-domain.test.ts +76 -0
  396. package/src/task-offline-delivery-2668.test.ts +119 -0
  397. package/src/task-offline-delivery.ts +81 -0
  398. package/src/task-orphan-http.test.ts +287 -0
  399. package/src/task-orphan.ts +119 -0
  400. package/src/task-queue-ahead-http.test.ts +309 -0
  401. package/src/task-queue-ahead-scale.test.ts +236 -0
  402. package/src/task-queue-ahead.ts +186 -0
  403. package/src/task-rejection-log-http.test.ts +160 -0
  404. package/src/task-rejection-log.ts +61 -0
  405. package/src/task-sender-http.test.ts +143 -0
  406. package/src/task-stale-open-http.test.ts +292 -0
  407. package/src/task-stale-open.ts +103 -0
  408. package/src/tasks-pagination-http.test.ts +141 -0
  409. package/src/team-rules-status-http.test.ts +90 -0
  410. package/src/team-rules-status.test.ts +59 -0
  411. package/src/team-rules-status.ts +72 -0
  412. package/src/tmux-allowlist.test.ts +48 -0
  413. package/src/tool-audience-http.test.ts +248 -0
  414. package/src/tool-audience.ts +127 -0
  415. package/src/tools-list-json-schema.test.ts +94 -0
  416. package/src/tools.ts +4215 -397
  417. package/src/update-node-config-error-domain.test.ts +107 -0
  418. package/src/uploads-http.test.ts +6 -4
  419. package/src/uploads.ts +23 -4
  420. package/src/user-avatar-http.test.ts +74 -0
  421. package/src/user-avatar-image.ts +160 -0
  422. package/src/user-avatar-migration.test.ts +25 -0
  423. package/src/user-avatar-upload-http.test.ts +348 -0
  424. package/src/user-inbox-by-agent-http.test.ts +165 -0
  425. package/src/user-inbox-netid-notnull.test.ts +122 -0
  426. package/src/user-inbox-read-http.test.ts +223 -0
  427. package/src/user-inbox-schema.test.ts +54 -0
  428. package/src/version-stats.test.ts +66 -0
  429. package/src/version-stats.ts +109 -0
@@ -0,0 +1,116 @@
1
+ // GET /api/requirements/projects 的每行 viewer_can.edit(app 任务页审计 L13)—— HTTP 集成测试(真实 Bun.serve,私有端口,临时库)。
2
+ //
3
+ // 客户端据此只在新建 / 挪卡的项目下拉里列「能编辑」的项目。判据必须与真写卡时一致,所以这里对每个项目
4
+ // 都真建一张卡,断言「viewer_can.edit === 建卡成功」,而不是另抄一份规则来比。
5
+ // admin —— Hub 管理员 + 网络 owner:未归档项目全 true,归档的 false(projectRef 拒归档)
6
+ // alice —— scoped 成员:P1 只看 → false,P2 可改 → true(只列得到这两个)
7
+ // carol —— task_access='all' 的成员:未归档全 true
8
+ // vic —— scoped viewer,P3 只看:false(viewer 本来就不能写卡)
9
+
10
+ import { describe, expect, test, beforeAll, afterAll } from "bun:test";
11
+ import { mkdtempSync, rmSync } from "fs";
12
+ import { join } from "path";
13
+ import { tmpdir } from "os";
14
+ import { register } from "./auth.js";
15
+ import { db } from "./db.js";
16
+
17
+ const DIR = mkdtempSync(join(tmpdir(), "anet-project-viewer-can-"));
18
+ let BASE = "";
19
+ let hub: any = null;
20
+ const PW = "ProjViewerCanPassw0rd!x";
21
+ let NET = "";
22
+ const U: Record<string, { token: string; id: string }> = {};
23
+ const P: Record<string, string> = {};
24
+
25
+ type R = { status: number; body: any };
26
+ async function send(token: string, method: string, path: string, payload?: unknown): Promise<R> {
27
+ const res = await fetch(`${BASE}${path}`, {
28
+ method,
29
+ headers: { ...(token ? { Authorization: `Bearer ${token}` } : {}), "Content-Type": "application/json" },
30
+ body: payload === undefined ? undefined : JSON.stringify(payload),
31
+ });
32
+ const text = await res.text();
33
+ let body: any = null;
34
+ try { body = JSON.parse(text); } catch {}
35
+ return { status: res.status, body };
36
+ }
37
+ const projects = async (who: string) => {
38
+ const r = await send(U[who].token, "GET", `/api/requirements/projects?network_id=${NET}`);
39
+ expect(r.status).toBe(200);
40
+ return Object.fromEntries((r.body.projects as any[]).map((p) => [p.name, p]));
41
+ };
42
+
43
+ beforeAll(async () => {
44
+ process.env.COMMHUB_DB ||= join(DIR, "hub.db");
45
+ process.env.COMMHUB_UPLOADS_DIR = join(DIR, "uploads");
46
+ process.env.HOST = "127.0.0.1";
47
+ const a = register(`pvc_admin_${Date.now()}`, PW, undefined, "Admin");
48
+ expect(a.ok).toBe(true);
49
+ U.admin = { token: a.token!, id: a.user!.user_id };
50
+ NET = a.network_id!;
51
+ db.run("UPDATE users SET role = 'admin' WHERE user_id = ?1", [U.admin.id]);
52
+ const mod: any = await import("./server.js");
53
+ hub = mod.bootServer({ port: 0, hostname: "127.0.0.1" });
54
+ BASE = `http://127.0.0.1:${hub.port}`;
55
+
56
+ const mk = async (username: string, role: string) => {
57
+ expect((await send(U.admin.token, "POST", "/api/admin/users", { username, password: PW, network_id: NET, role })).status).toBe(200);
58
+ const login = await send("", "POST", "/api/auth/login", { username, password: PW });
59
+ expect(login.status).toBe(200);
60
+ return { token: login.body.token as string, id: login.body.user.user_id as string };
61
+ };
62
+ const stamp = Date.now();
63
+ U.alice = await mk(`pvc_alice_${stamp}`, "member");
64
+ U.carol = await mk(`pvc_carol_${stamp}`, "member");
65
+ U.vic = await mk(`pvc_vic_${stamp}`, "viewer");
66
+ db.run("UPDATE network_members SET task_access = 'all' WHERE network_id = ?1 AND user_id = ?2", [NET, U.carol.id]);
67
+
68
+ for (const name of ["pvc-P1", "pvc-P2", "pvc-P3", "pvc-P4"]) {
69
+ const r = await send(U.admin.token, "POST", "/api/requirements/projects", { network_id: NET, name });
70
+ expect(r.status).toBe(201);
71
+ P[name] = r.body.project.id;
72
+ }
73
+ expect((await send(U.admin.token, "PATCH", `/api/requirements/projects/${P["pvc-P4"]}?network_id=${NET}`, { archived: true })).status).toBe(200);
74
+ expect((await send(U.admin.token, "PUT", `/api/networks/${NET}/members/${U.alice.id}/task-grants`, { task_access: "scoped", project_grants: [{ project_id: P["pvc-P1"] }, { project_id: P["pvc-P2"], can_edit: true }] })).status).toBe(200);
75
+ expect((await send(U.admin.token, "PUT", `/api/networks/${NET}/members/${U.vic.id}/task-grants`, { task_access: "scoped", project_grants: [P["pvc-P3"]] })).status).toBe(200);
76
+ }, 30_000);
77
+
78
+ afterAll(() => {
79
+ try { hub?.stop?.(true); } catch {}
80
+ try { rmSync(DIR, { recursive: true, force: true }); } catch {}
81
+ });
82
+
83
+ describe("GET /api/requirements/projects 的 viewer_can.edit", () => {
84
+ test("每个调用者的取值", async () => {
85
+ const edit = (rows: Record<string, any>) => Object.fromEntries(Object.entries(rows).map(([n, p]) => [n, p.viewer_can?.edit]));
86
+ expect(edit(await projects("admin"))).toEqual({ "pvc-P1": true, "pvc-P2": true, "pvc-P3": true, "pvc-P4": false });
87
+ expect(edit(await projects("carol"))).toEqual({ "pvc-P1": true, "pvc-P2": true, "pvc-P3": true, "pvc-P4": false });
88
+ expect(edit(await projects("alice"))).toEqual({ "pvc-P1": false, "pvc-P2": true });
89
+ expect(edit(await projects("vic"))).toEqual({ "pvc-P3": false });
90
+ });
91
+
92
+ test("只加字段:其余键与之前逐字相同", async () => {
93
+ const row = (await projects("alice"))["pvc-P2"];
94
+ // parentId 是 2026-10-24 加的「子项目」字段(admin:管理项目里看不到层级);
95
+ // 它同样是加法式的:这里钉的是「已知键一个不多一个不少」,新键必须显式加进这个清单。
96
+ expect(Object.keys(row).sort()).toEqual(["archived", "color", "createdAt", "id", "name", "parentId", "sort", "viewer_can"]);
97
+ expect(Object.keys(row.viewer_can)).toEqual(["edit"]);
98
+ });
99
+
100
+ test("与真写卡一致:edit === 往这个项目建卡成功", async () => {
101
+ let checked = 0;
102
+ for (const who of ["admin", "carol", "alice", "vic"]) {
103
+ for (const [name, p] of Object.entries(await projects(who))) {
104
+ const r = await send(U[who].token, "POST", "/api/requirements", { network_id: NET, name: `pvc-card-${who}-${name}`, project_id: p.id });
105
+ expect({ who, name, created: r.status === 201 }).toEqual({ who, name, created: p.viewer_can.edit });
106
+ checked++;
107
+ }
108
+ }
109
+ expect(checked).toBe(11);
110
+ });
111
+
112
+ test("授权改成可编辑后立即反映", async () => {
113
+ expect((await send(U.admin.token, "PUT", `/api/networks/${NET}/members/${U.alice.id}/task-grants`, { project_grants: [{ project_id: P["pvc-P1"], can_edit: true }, { project_id: P["pvc-P2"], can_edit: true }] })).status).toBe(200);
114
+ expect((await projects("alice"))["pvc-P1"].viewer_can.edit).toBe(true);
115
+ });
116
+ });
@@ -0,0 +1,130 @@
1
+ // #3309 读数覆盖第六批 —— 四个 error 字面量此前在测试里一次都没出现过:
2
+ //
3
+ // upsert_provider : insufficient_role_for_provider / provider_name_conflict
4
+ // review_skill : skill_review_admin_required / skill_not_pending
5
+ //
6
+ // 两对各有一个「只差一层」的近邻,而处置完全不同:
7
+ // insufficient_role_for_provider ↔ provider_name_conflict
8
+ // 换人提权 ↔ 换个名字(或先删旧的)
9
+ // skill_review_admin_required ↔ skill_not_pending
10
+ // 换人提权 ↔ 这个技能已经被审过,不必再审
11
+ //
12
+ // 只断言 ok===false 时,四条与「网络不通」「id 不存在」同形。
13
+ import { afterAll, beforeEach, describe, expect, test } from "bun:test";
14
+ import { McpServer } from "@modelcontextprotocol/sdk/server/mcp.js";
15
+ import { db } from "./db.js";
16
+ import { registerTools } from "./tools.js";
17
+
18
+ // vault 根密钥必须存在,否则 upsert_network_secret 直接失败(与 provider-tools-shape.test.ts 同一做法)。
19
+ process.env.ANET_HUB_SECRET_VAULT_KEY ||= "44".repeat(32);
20
+
21
+ const NET = "net_6th_err";
22
+ const ADMIN = "u_6th_admin";
23
+ const MEMBER = "u_6th_member";
24
+ const SKILL = "skill_6th_pending";
25
+
26
+ type ToolHandler = (args: any) => Promise<{ content: Array<{ type: "text"; text: string }> }>;
27
+
28
+ function handlers(userId: string): Record<string, ToolHandler> {
29
+ const server = new McpServer({ name: "t", version: "0" }) as any;
30
+ const out: Record<string, ToolHandler> = {};
31
+ const orig = server.tool.bind(server);
32
+ server.tool = (n: string, d: string, s: any, h: ToolHandler) => { out[n] = h; return orig(n, d, s, h); };
33
+ registerTools(server, undefined, NET, userId, null, false, null);
34
+ return out;
35
+ }
36
+
37
+ async function call(userId: string, name: string, args: Record<string, unknown>) {
38
+ const r = await handlers(userId)[name](args as any);
39
+ return JSON.parse(r.content[0].text) as { ok?: boolean; error?: string; [k: string]: unknown };
40
+ }
41
+
42
+ function cleanup() {
43
+ try { db.run("DELETE FROM provider_models WHERE provider_id IN (SELECT provider_id FROM providers WHERE network_id = ?1)", [NET]); } catch {}
44
+ try { db.run("DELETE FROM providers WHERE network_id = ?1", [NET]); } catch {}
45
+ try { db.run("DELETE FROM skillhub_skills WHERE network_id = ?1", [NET]); } catch {}
46
+ try { db.run("DELETE FROM network_secrets WHERE network_id = ?1", [NET]); } catch {}
47
+ try { db.run("DELETE FROM network_members WHERE network_id = ?1", [NET]); } catch {}
48
+ try { db.run("DELETE FROM networks WHERE network_id = ?1", [NET]); } catch {}
49
+ try { db.run("DELETE FROM users WHERE user_id IN (?1, ?2)", [ADMIN, MEMBER]); } catch {}
50
+ }
51
+
52
+ function seed() {
53
+ cleanup();
54
+ db.run("INSERT INTO users (user_id, username, password_hash, role, created_at) VALUES (?1, ?1, 'x', 'user', datetime('now'))", [ADMIN]);
55
+ db.run("INSERT INTO users (user_id, username, password_hash, role, created_at) VALUES (?1, ?1, 'x', 'user', datetime('now'))", [MEMBER]);
56
+ db.run("INSERT INTO networks (network_id, network_name, owner_id, created_at) VALUES (?1, ?1, ?2, datetime('now'))", [NET, ADMIN]);
57
+ db.run("INSERT INTO network_members (user_id, network_id, role, joined_at) VALUES (?1, ?2, 'owner', datetime('now'))", [ADMIN, NET]);
58
+ db.run("INSERT INTO network_members (user_id, network_id, role, joined_at) VALUES (?1, ?2, 'member', datetime('now'))", [MEMBER, NET]);
59
+ db.run(
60
+ `INSERT INTO skillhub_skills (skill_id, network_id, slug, name, description, content, content_hash, version,
61
+ status, source_type, created_at, updated_at)
62
+ VALUES (?1, ?2, 'sixth', 'Sixth', 'd', 'body', 'h', '1.0.0', 'published', 'user',
63
+ datetime('now'), datetime('now'))`,
64
+ [SKILL, NET],
65
+ );
66
+ }
67
+
68
+ beforeEach(seed);
69
+ afterAll(cleanup);
70
+
71
+ describe("#3309 upsert_provider / review_skill 的错误值域", () => {
72
+ test("成员建 provider ⇒ insufficient_role_for_provider(带 required_role / caller_role)", async () => {
73
+ const r = await call(MEMBER, "upsert_provider", {
74
+ name: "sixth-provider", vendor: "anthropic", base_url: "https://api.anthropic.com",
75
+ secret_key_ref: "SIXTH_KEY", models: [],
76
+ });
77
+ expect(r.ok).toBe(false);
78
+ expect(r.error).toBe("insufficient_role_for_provider");
79
+ expect(r.required_role).toBe("admin");
80
+ expect(r.caller_role).toBe("member");
81
+ });
82
+
83
+ test("同名 provider 第二次入库 ⇒ provider_name_conflict(带 name)", async () => {
84
+ // 先把 vault key 备好,否则会先撞 secret_not_in_vault,走不到 UNIQUE 那一步。
85
+ const sec = await call(ADMIN, "upsert_network_secret", { key: "SIXTH_KEY", value: "sk-sixth-not-real" });
86
+ expect(sec.ok).toBe(true);
87
+ const args = {
88
+ name: "sixth-dup", vendor: "anthropic", base_url: "https://api.anthropic.com",
89
+ secret_key_ref: "SIXTH_KEY", models: [],
90
+ };
91
+ const first = await call(ADMIN, "upsert_provider", args);
92
+ expect(first.ok).toBe(true);
93
+ const second = await call(ADMIN, "upsert_provider", args);
94
+ expect(second.ok).toBe(false);
95
+ expect(second.error).toBe("provider_name_conflict");
96
+ expect(second.name).toBe("sixth-dup");
97
+ // 与 insufficient_role 的区别:这不是权限问题,换个名字就好。
98
+ expect(second.error).not.toBe("insufficient_role_for_provider");
99
+ });
100
+
101
+ test("成员审技能 ⇒ skill_review_admin_required", async () => {
102
+ const r = await call(MEMBER, "review_skill", { skill_id: SKILL, decision: "published" });
103
+ expect(r.ok).toBe(false);
104
+ expect(r.error).toBe("skill_review_admin_required");
105
+ });
106
+
107
+ test("审一个已发布的技能 ⇒ skill_not_pending(带当前 status)", async () => {
108
+ const r = await call(ADMIN, "review_skill", { skill_id: SKILL, decision: "rejected" });
109
+ expect(r.ok).toBe(false);
110
+ expect(r.error).toBe("skill_not_pending");
111
+ expect(r.status).toBe("published");
112
+ // 与 skill_review_admin_required 的区别:权限没问题,是这个对象的状态不该再审。
113
+ expect(r.error).not.toBe("skill_review_admin_required");
114
+ });
115
+
116
+ test("四条载荷都没有 code 字段(现状,不是契约)", async () => {
117
+ const replies = [
118
+ await call(MEMBER, "upsert_provider", {
119
+ name: "x", vendor: "anthropic", base_url: "https://api.anthropic.com",
120
+ secret_key_ref: "K", models: [],
121
+ }),
122
+ await call(MEMBER, "review_skill", { skill_id: SKILL, decision: "published" }),
123
+ await call(ADMIN, "review_skill", { skill_id: SKILL, decision: "published" }),
124
+ ];
125
+ for (const r of replies) {
126
+ expect(r.ok).toBe(false);
127
+ expect(Object.prototype.hasOwnProperty.call(r, "code")).toBe(false);
128
+ }
129
+ });
130
+ });
@@ -0,0 +1,165 @@
1
+ // #3275 —— provider 三件工具的形状:upsert_provider / probe_provider_model / get_probe_results。
2
+ //
3
+ // 为什么单独一个文件:这三件是**唯一三个在 server/src/*.test.ts 里没有任何调用点**的 MCP 工具
4
+ // (覆盖率报告里长期挂在 uncovered)。它们都要「先有 provider + model + daemon」才有东西可返回,
5
+ // 借用别人的夹具会把两个结论绑在一起 —— 所以自建最小种子。
6
+ //
7
+ // 判据:形状一律来自**真实调用**;跑不通的分支不写断言,而不是按名字猜一个(今天已经三次栽在这上面)。
8
+ import { afterAll, beforeEach, describe, expect, test } from "bun:test";
9
+ import { McpServer } from "@modelcontextprotocol/sdk/server/mcp.js";
10
+ import { db } from "./db.js";
11
+ import { registerTools } from "./tools.js";
12
+ import { stopBackgroundProbeTimersForTest } from "./probe.js";
13
+
14
+ // 金库根密钥必须存在,否则 upsert_network_secret 直接失败(实测:第一次跑就是栽在这里)。
15
+ // 用固定测试值,且只在本进程内 —— 与 daemon-provider-snapshots.test.ts 同一做法。
16
+ process.env.ANET_HUB_SECRET_VAULT_KEY ||= "42".repeat(32);
17
+
18
+ const USER = "u_probe_shape";
19
+ const NET = "net_probe_shape";
20
+ const PROVIDER = "prov_shape";
21
+ const DAEMON = "node_probe_daemon";
22
+ const SECRET_KEY = "PROBE_SHAPE_KEY";
23
+
24
+ type ToolHandler = (args: any) => Promise<any>;
25
+ const REPLY = (body: unknown) => ({ content: [{ type: "text" as const, text: JSON.stringify(body) }] });
26
+
27
+ function handlers(): Record<string, ToolHandler> {
28
+ const server = new McpServer({ name: "test", version: "0" }) as any;
29
+ const tools: Record<string, ToolHandler> = {};
30
+ const orig = server.tool.bind(server);
31
+ server.tool = (name: string, desc: string, schema: any, handler: ToolHandler) => {
32
+ tools[name] = handler;
33
+ return orig(name, desc, schema, handler);
34
+ };
35
+ registerTools(server, undefined, NET, USER, null, false, null);
36
+ return tools;
37
+ }
38
+
39
+ async function call(handler: ToolHandler, args: any): Promise<any> {
40
+ const r = await handler(args);
41
+ return JSON.parse(r.content[0].text);
42
+ }
43
+
44
+ function seed(opts: { withProvider?: boolean } = {}) {
45
+ db.run(`INSERT INTO users (user_id, username, password_hash, role, created_at)
46
+ VALUES (?1, ?1, 'x', 'user', datetime('now'))`, [USER]);
47
+ db.run(`INSERT INTO networks (network_id, network_name, owner_id, created_at)
48
+ VALUES (?1, ?1, ?2, datetime('now'))`, [NET, USER]);
49
+ // 角色必须是 **owner**:`upsert_network_secret` 的拒绝体实测是
50
+ // { ok:false, error:"secret_owner_only", required_role:"owner", caller_role:"admin" }
51
+ // ⇒ admin 不够。这条也是真实调用给出的,不是从权限表读来的。
52
+ db.run(`INSERT INTO network_members (user_id, network_id, role, joined_at)
53
+ VALUES (?1, ?2, 'owner', datetime('now'))`, [USER, NET]);
54
+ db.run(`INSERT INTO nodes (node_id, node_name, alias, network_id, runtime, model, channels, config_snapshot,
55
+ hostname, created_at, updated_at, lifecycle_state)
56
+ VALUES (?1, 'probe-daemon', 'probe-daemon', ?2, 'claude-agent-sdk', 'm', '[]', '{}', 'host-p',
57
+ datetime('now'), datetime('now'), 'active')`, [DAEMON, NET]);
58
+ if (opts.withProvider !== false) {
59
+ db.run(`INSERT INTO providers (provider_id, network_id, name, vendor, base_url, secret_key_ref, created_at, created_by, enabled)
60
+ VALUES (?1, ?2, 'shape-provider', 'anthropic', 'https://api.anthropic.com', ?3, ?4, ?5, 1)`,
61
+ [PROVIDER, NET, SECRET_KEY, Date.now(), USER]);
62
+ db.run(`INSERT INTO provider_models (model_id, provider_id, model_name, display_name, created_at)
63
+ VALUES ('pm_shape', ?1, 'shape-model', 'Shape Model', ?2)`, [PROVIDER, Date.now()]);
64
+ }
65
+ }
66
+
67
+ function cleanup() {
68
+ for (const t of ["provider_models", "providers", "network_members", "nodes", "networks", "users"]) {
69
+ if (t === "provider_models") db.run("DELETE FROM provider_models WHERE provider_id = ?1", [PROVIDER]);
70
+ else if (t === "providers") db.run("DELETE FROM providers WHERE network_id = ?1", [NET]);
71
+ else if (t === "network_members") db.run("DELETE FROM network_members WHERE network_id = ?1", [NET]);
72
+ else if (t === "nodes") db.run("DELETE FROM nodes WHERE network_id = ?1", [NET]);
73
+ else if (t === "networks") db.run("DELETE FROM networks WHERE network_id = ?1", [NET]);
74
+ else db.run("DELETE FROM users WHERE user_id = ?1", [USER]);
75
+ }
76
+ }
77
+
78
+ beforeEach(() => { cleanup(); });
79
+ afterAll(() => { stopBackgroundProbeTimersForTest(); cleanup(); });
80
+
81
+ describe("provider 三件工具的形状", () => {
82
+ test("upsert_provider 成功体的键集(真实调用给出)", async () => {
83
+ seed({ withProvider: false });
84
+ const tools = handlers();
85
+ // provider 的 secret 必须先在金库里 —— 这是工具自己的前置(实测第一次跑就撞上
86
+ // `secret_not_in_vault`,提示原话是「upsert_network_secret first」)。
87
+ // #3309 否定维度 —— 唯一哨兵值:它出现一次以上就说明有回显。
88
+ // 用随机后缀而不是字面量:字面量可能恰好在别处存在,会让「没回声」的断言因别的原因成立。
89
+ const SENTINEL = `SK-${Math.random().toString(36).slice(2)}-${Date.now()}`;
90
+ const secret = await call(tools.upsert_network_secret, { network_id: NET, key: SECRET_KEY, value: SENTINEL });
91
+ // #3275 批次 4 —— 写密钥的成功体**只回标识**(不回声任何值):
92
+ // 这条属性比键集本身更重要 —— 回读才回内容,写入路径永远不带值。
93
+ // 实测(首次写入):["key","ok"] —— 我按族推断多写了一个 `overwrote`,当场红。
94
+ // ⇒ 覆盖写入那条分支可能多一个字段,但**本夹具没走到,所以不声称**。
95
+ expect(Object.keys(secret).sort()).toEqual(["key", "ok"]);
96
+ expect(JSON.stringify(secret)).not.toContain(SENTINEL);
97
+ expect(secret.ok).toBe(true);
98
+ const up = await call(tools.upsert_provider, {
99
+ name: "shape-provider", vendor: "anthropic", base_url: "https://api.anthropic.com",
100
+ secret_key_ref: SECRET_KEY, network_id: NET,
101
+ models: [{ model_name: "shape-model", display_name: "Shape Model" }],
102
+ });
103
+ // 形状来自真实调用 —— 而且**纠了我一次**:我先把成功体写成 { ok, provider:{…}, models:[…] },
104
+ // 实际是三键 { ok, provider_id, model_ids }(不回声任何配置内容)。
105
+ // 这个形状是对的:写入路径回**标识**,回读才回内容 —— 两件事分开,密钥那条线才不会被顺手带出来。
106
+ expect(Object.keys(up).sort()).toEqual(["model_ids", "ok", "provider_id"]);
107
+ expect(up.provider_id).toMatch(/^prov_/);
108
+ // #3309 否定维度 —— provider 的写回执同样不得携带密钥值(它只该带 secret_key_ref 这个名字)。
109
+ expect(JSON.stringify(up)).not.toContain(SENTINEL);
110
+ expect(Array.isArray(up.model_ids)).toBe(true);
111
+ expect(up.model_ids).toHaveLength(1);
112
+
113
+ // #3309 分支:upsert 的「no_changes」出口用同参再调一次**到不了** —— 实测返回
114
+ // {"ok":false,"error":…,"name":…}(重名优先于「无变化」)。要到达它需要一次以 provider_id
115
+ // 定位的更新,而本夹具没有那条路径 ⇒ **这里不声称覆盖**,登记在卡上。
116
+ expect(up.model_ids[0]).toMatch(/^pm_/);
117
+ });
118
+
119
+ test("probe_provider_model 缺 model 时的拒绝体({ok,error,...})", async () => {
120
+ seed();
121
+ const tools = handlers();
122
+ const r = await call(tools.probe_provider_model, {
123
+ provider_id: PROVIDER, model_name: "no-such-model", daemon_node_id: DAEMON, network_id: NET,
124
+ });
125
+ expect(Object.keys(r).sort()).toEqual(["error", "model_name", "ok"]);
126
+ expect(r).toMatchObject({ ok: false, error: "model_not_found" });
127
+ });
128
+
129
+ test("probe_provider_model 缺 daemon 时的拒绝体", async () => {
130
+ seed();
131
+ const tools = handlers();
132
+ const r = await call(tools.probe_provider_model, {
133
+ provider_id: PROVIDER, model_name: "shape-model", daemon_node_id: "node_nope", network_id: NET,
134
+ });
135
+ expect(Object.keys(r).sort()).toEqual(["error", "ok"]);
136
+ expect(r).toMatchObject({ ok: false, error: "daemon_not_found" });
137
+ });
138
+
139
+ test("probe_provider_model 派发成功体的键集(真实调用给出)", async () => {
140
+ seed();
141
+ const tools = handlers();
142
+ const vault = await call(tools.upsert_network_secret, { network_id: NET, key: SECRET_KEY, value: "TEST-ONLY-probe-shape" });
143
+ expect(vault.ok).toBe(true);
144
+ const r = await call(tools.probe_provider_model, {
145
+ provider_id: PROVIDER, model_name: "shape-model", daemon_node_id: DAEMON, network_id: NET,
146
+ });
147
+ // 成功体是**派发凭据**,不是结果 —— 结果要去 get_probe_results 取。
148
+ // 两键:{ ok, probe_id }。与「一次调用直接返回结果」的设计相比,这个形状把
149
+ // 「下发」与「收结果」分成两次读,probe_id 是它们之间唯一的锚。
150
+ expect(Object.keys(r).sort()).toEqual(["ok", "probe_id"]);
151
+ expect(r.ok).toBe(true);
152
+ expect(r.probe_id).toMatch(/^pr_/);
153
+ });
154
+
155
+ test("get_probe_results 空历史的键集(真实调用给出)", async () => {
156
+ seed();
157
+ const tools = handlers();
158
+ const r = await call(tools.get_probe_results, { provider_id: PROVIDER, network_id: NET });
159
+ // 两键:{ ok, results }。results 是**数组**(空历史给空数组,不是 null)——
160
+ // 「没有历史」与「查不到」在这一层同形,所以判据是「ok 为真且 results 是数组」。
161
+ expect(Object.keys(r).sort()).toEqual(["ok", "results"]);
162
+ expect(r.ok).toBe(true);
163
+ expect(Array.isArray(r.results)).toBe(true);
164
+ });
165
+ });
package/src/push.test.ts CHANGED
@@ -351,26 +351,36 @@ describe("real ReadableStream — byte-level backpressure (round-2 fix)", () =>
351
351
  await res.body!.cancel();
352
352
  });
353
353
 
354
- test("non-reading consumer past MAX bytes triggers hard ceiling close", async () => {
354
+ test("non-reading consumer stops growing at COALESCE_AT and is reaped by the stuck timeout", async () => {
355
+ // #2363 —— 语义变更:落后超过 COALESCE_AT_BYTES 后**跳过非关键事件**,不再一路排队到
356
+ // 1 MB 硬顶。这样 150 条慢订阅者不会把内存放大到 连接数 × 1 MB(实测 2 GB 尖峰)。
357
+ // 兜底仍然存在:硬顶对这一帧的**关键帧**生效;长期不读的由 STUCK_CLOSE_MS 回收。
358
+ const coalesce = __SSE_INTERNALS_FOR_TEST.COALESCE_AT_BYTES;
355
359
  const ceiling = __SSE_INTERNALS_FOR_TEST.MAX_QUEUE_BACKPRESSURE_BYTES;
356
360
  const res = createSSEStream("byte-cap-probe", "net-bcp");
357
361
  const key = "net-bcp:byte-cap-probe";
358
362
  const c = __SSE_INTERNALS_FOR_TEST.clientsMap.get(key)![0];
359
363
 
360
- // Push events whose total byte size exceeds the hard ceiling.
361
- // With chunk-count strategy this would NOT close (each event is 1
362
- // chunk; desiredSize would be at -N for N events, never -1M).
363
- // With byte strategy this SHOULD close once accumulated bytes
364
- // exceed ceiling.
365
- const chunkSize = 100_000; // 100KB per push
366
- const needed = Math.ceil(ceiling / chunkSize) + 2; // overshoot a bit
364
+ const chunkSize = 100_000; // 100KB per push, larger than COALESCE_AT
367
365
  const big = "x".repeat(chunkSize);
368
- for (let i = 0; i < needed; i++) {
366
+ const before = __SSE_INTERNALS_FOR_TEST.degradedDropCount();
367
+ for (let i = 0; i < Math.ceil(ceiling / chunkSize) + 2; i++) {
369
368
  if (c.closed) break;
370
369
  pushEvent("byte-cap-probe", { type: "big", payload: big }, "net-bcp");
371
370
  }
371
+ // 关键断言 1:**没有被立刻关闭**(跳过的语义是“不排队”,不是“断开”)
372
+ expect(c.closed).toBe(false);
373
+ // 关键断言 2:队列没有一路涨到硬顶 —— 落后量被 COALESCE_AT 挡住
374
+ const desired = c.controller.desiredSize ?? 0;
375
+ expect(-desired).toBeLessThan(ceiling);
376
+ expect(-desired).toBeLessThanOrEqual(coalesce + chunkSize * 2);
377
+ // 关键断言 3:跳过被**计数**(不静默)
378
+ expect(__SSE_INTERNALS_FOR_TEST.degradedDropCount()).toBeGreaterThan(before);
379
+
380
+ // 关键断言 4:长期不读仍会被收回(沿用原有 stuck 回收)
381
+ c.stuckSince = Date.now() - (__SSE_INTERNALS_FOR_TEST.STUCK_CLOSE_MS + 1);
382
+ __SSE_INTERNALS_FOR_TEST.tryEnqueueBytes(c, new Uint8Array(1), { critical: true });
372
383
  expect(c.closed).toBe(true);
373
- expect(__SSE_INTERNALS_FOR_TEST.clientsMap.has(key)).toBe(false);
374
384
 
375
385
  try { await res.body!.cancel(); } catch { /* already closed */ }
376
386
  });