@sleep2agi/commhub-server 0.9.0-preview.2 → 0.9.0-preview.200

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 (412) hide show
  1. package/README.md +130 -10
  2. package/bin/commhub.ts +99 -11
  3. package/package.json +7 -7
  4. package/src/ack-create-request-transport.test.ts +182 -0
  5. package/src/ack-create-request.test.ts +374 -0
  6. package/src/admin-delete-network-http.test.ts +228 -0
  7. package/src/admin-networks-http.test.ts +88 -0
  8. package/src/adoption-candidates-http.test.ts +137 -0
  9. package/src/adoption-candidates.ts +158 -0
  10. package/src/agent-access-batch.test.ts +210 -0
  11. package/src/agent-access.ts +487 -0
  12. package/src/agent-acl-groups-http.test.ts +247 -0
  13. package/src/agent-acl-http.test.ts +659 -0
  14. package/src/agent-acl-slice3-http.test.ts +267 -0
  15. package/src/agent-department-http.test.ts +215 -0
  16. package/src/agent-groups-perf.test.ts +223 -0
  17. package/src/agent-notice.ts +48 -0
  18. package/src/agent-team-whoami-http.test.ts +98 -0
  19. package/src/agent-teams-http.test.ts +330 -0
  20. package/src/agent-teams.ts +244 -0
  21. package/src/alias-baseline-2571.test.ts +162 -0
  22. package/src/alias-baseline.ts +113 -0
  23. package/src/alias-filter.test.ts +72 -0
  24. package/src/alias-filter.ts +42 -0
  25. package/src/api-host-supervisors-can-create-nodes.test.ts +350 -0
  26. package/src/api-host-supervisors-fallback.test.ts +271 -0
  27. package/src/api-host-supervisors-runtime-readiness.test.ts +195 -0
  28. package/src/api-nodes-shape.test.ts +279 -0
  29. package/src/auth-password-change-cli-tokens-http.test.ts +423 -0
  30. package/src/auth-sessions-http.test.ts +250 -0
  31. package/src/auth-validate.test.ts +5 -1
  32. package/src/auth-weak-password-login.test.ts +176 -0
  33. package/src/auth.ts +611 -51
  34. package/src/avatar-validate.test.ts +163 -0
  35. package/src/avatar-validate.ts +103 -0
  36. package/src/backfill-node-ids-2664.test.ts +128 -0
  37. package/src/binding-generation-http.test.ts +121 -0
  38. package/src/blocked-exit-on-reply.test.ts +122 -0
  39. package/src/boot-side-effect.test.ts +124 -0
  40. package/src/broadcast-fanout-2721.test.ts +118 -0
  41. package/src/broadcast-fanout.ts +98 -0
  42. package/src/chain-attempt-dedup.test.ts +447 -0
  43. package/src/clone-node.test.ts +248 -0
  44. package/src/clone-node.ts +289 -0
  45. package/src/codex-config-flags.ts +77 -0
  46. package/src/codex-fork-contract.ts +23 -0
  47. package/src/codex-fork-migration.test.ts +38 -0
  48. package/src/commhub-bin-args.test.ts +85 -0
  49. package/src/config-apply-sec1.test.ts +107 -0
  50. package/src/config-apply-validate.test.ts +134 -1
  51. package/src/config-apply-validate.ts +111 -5
  52. package/src/create-node-blocked-gate.test.ts +356 -0
  53. package/src/create-node-network-id.test.ts +79 -0
  54. package/src/create-node-tool-schema.test.ts +49 -0
  55. package/src/create-node-unicode-name.test.ts +120 -0
  56. package/src/create-node-validate.test.ts +379 -0
  57. package/src/create-node-validate.ts +423 -0
  58. package/src/create-node-workdir.test.ts +289 -0
  59. package/src/create-node.test.ts +354 -0
  60. package/src/create-node.ts +411 -0
  61. package/src/daemon-provider-snapshots.test.ts +421 -0
  62. package/src/daemon-provider-snapshots.ts +327 -0
  63. package/src/daemon-token-owner-http.test.ts +236 -0
  64. package/src/dashboard-slash-routing-http.test.ts +109 -0
  65. package/src/db-adapter-guard.test.ts +148 -0
  66. package/src/db-adapter-translate.test.ts +128 -0
  67. package/src/db-adapter.ts +377 -91
  68. package/src/db-timestamp.test.ts +38 -0
  69. package/src/db-timestamp.ts +15 -0
  70. package/src/db.ts +1501 -152
  71. package/src/delivered-without-push.test.ts +140 -0
  72. package/src/department-groups-http.test.ts +209 -0
  73. package/src/department-groups-sync-http.test.ts +328 -0
  74. package/src/department-groups.ts +434 -0
  75. package/src/department-heads-http.test.ts +330 -0
  76. package/src/department-heads.ts +226 -0
  77. package/src/departments-agent-count.test.ts +129 -0
  78. package/src/departments-http.test.ts +185 -0
  79. package/src/departments-mcp.test.ts +128 -0
  80. package/src/departments.ts +318 -0
  81. package/src/desktop-message-seam.test.ts +150 -0
  82. package/src/desktop-message.test.ts +368 -0
  83. package/src/dm-file-scope-http.test.ts +178 -0
  84. package/src/empty-node-sweeper.test.ts +104 -0
  85. package/src/empty-node-sweeper.ts +88 -0
  86. package/src/env-transport-gate-http.test.ts +177 -0
  87. package/src/env-transport-gate.ts +74 -0
  88. package/src/env-transport-policy.ts +21 -0
  89. package/src/event-loop-lag.test.ts +139 -0
  90. package/src/event-loop-lag.ts +150 -0
  91. package/src/ext-token-shared.test.ts +60 -0
  92. package/src/ext-validation-regression.test.ts +131 -0
  93. package/src/external-schedule-edits-http.test.ts +321 -0
  94. package/src/external-schedule-edits-timestamps.test.ts +64 -0
  95. package/src/external-schedule-edits.ts +327 -0
  96. package/src/file-download-authz-dev-open.test.ts +135 -0
  97. package/src/file-download-authz.test.ts +404 -0
  98. package/src/file-download-date-bucket.test.ts +436 -0
  99. package/src/file-network-scope-dev-open.test.ts +97 -0
  100. package/src/file-network-scope.test.ts +732 -0
  101. package/src/group-membership-events-http.test.ts +264 -0
  102. package/src/group-messages-http.test.ts +482 -0
  103. package/src/group-messages.ts +297 -0
  104. package/src/health-host-disk-2756.test.ts +49 -0
  105. package/src/health-redaction.test.ts +685 -0
  106. package/src/host-supervisor-identity-http.test.ts +152 -0
  107. package/src/host-supervisor-identity.ts +92 -0
  108. package/src/host-supervisors-daemon-version.test.ts +137 -0
  109. package/src/http-gzip.test.ts +94 -0
  110. package/src/http-gzip.ts +112 -0
  111. package/src/hub-catalog-read-http.test.ts +187 -0
  112. package/src/hub-provider-config.test.ts +139 -0
  113. package/src/hub-provider-config.ts +105 -0
  114. package/src/hub-timestamp.test.ts +38 -0
  115. package/src/hub-timestamp.ts +27 -0
  116. package/src/human-dm.ts +215 -0
  117. package/src/human-inbox.ts +42 -0
  118. package/src/inbox-caller.ts +49 -0
  119. package/src/inbox-count-sse.test.ts +310 -0
  120. package/src/inbox-count.ts +29 -0
  121. package/src/index.ts +15 -2172
  122. package/src/lifecycle-guard.ts +50 -0
  123. package/src/list-host-supervisors.test.ts +315 -0
  124. package/src/mcp-context-cost-http.test.ts +127 -0
  125. package/src/mcp-inflight.test.ts +92 -0
  126. package/src/mcp-inflight.ts +38 -0
  127. package/src/mcp-projects-events-http.test.ts +162 -0
  128. package/src/mcp-route-label-http.test.ts +120 -0
  129. package/src/mcp-write-network-resolution.test.ts +432 -0
  130. package/src/member-audit-network-id-http.test.ts +93 -0
  131. package/src/member-presence-http.test.ts +210 -0
  132. package/src/messages-ack-by-agent-http.test.ts +142 -0
  133. package/src/migrate-sqlite-to-pg.test.ts +47 -0
  134. package/src/migrate-sqlite-to-pg.ts +263 -0
  135. package/src/model-auth-notify-http.test.ts +181 -0
  136. package/src/model-auth-notify.ts +116 -0
  137. package/src/network-name-http.test.ts +75 -0
  138. package/src/network-rules-http.test.ts +169 -0
  139. package/src/network-rules.ts +129 -0
  140. package/src/network-scope.ts +276 -0
  141. package/src/network-token-membership-http.test.ts +139 -0
  142. package/src/node-alias-control.ts +12 -0
  143. package/src/node-attrs-validate.ts +88 -0
  144. package/src/node-attrs.test.ts +258 -0
  145. package/src/node-caller-identity-http.test.ts +1083 -0
  146. package/src/node-create-request-status-http.test.ts +105 -0
  147. package/src/node-daemon-bindings.test.ts +132 -0
  148. package/src/node-daemon-bindings.ts +135 -0
  149. package/src/node-failure-alert.test.ts +150 -0
  150. package/src/node-failure-alert.ts +177 -0
  151. package/src/node-files-transport.test.ts +344 -0
  152. package/src/node-health-codex-login.test.ts +120 -0
  153. package/src/node-health-dispatch-http.test.ts +279 -0
  154. package/src/node-health-guard.ts +105 -0
  155. package/src/node-health-passthrough.test.ts +115 -0
  156. package/src/node-health-store.ts +101 -0
  157. package/src/node-id-alias.test.ts +190 -0
  158. package/src/node-identity-conflict-http.test.ts +269 -0
  159. package/src/node-identity-conflict.ts +142 -0
  160. package/src/node-identity-mismatch.test.ts +74 -0
  161. package/src/node-in-flight-tasks.ts +31 -0
  162. package/src/node-lifecycle-controllable.test.ts +64 -0
  163. package/src/node-lifecycle-controllable.ts +53 -0
  164. package/src/node-lifecycle-read-http.test.ts +250 -0
  165. package/src/node-lifecycle-read.ts +124 -0
  166. package/src/node-logs-transport.test.ts +263 -0
  167. package/src/node-peer-allowlist.test.ts +79 -0
  168. package/src/node-permissions-http.test.ts +345 -0
  169. package/src/node-permissions.ts +393 -0
  170. package/src/node-request-retention.test.ts +281 -0
  171. package/src/node-request-retention.ts +120 -0
  172. package/src/node-secret-rest-http.test.ts +190 -0
  173. package/src/node-serviceability.test.ts +86 -0
  174. package/src/node-serviceability.ts +124 -0
  175. package/src/node-session-control-http.test.ts +310 -0
  176. package/src/node-session-control.ts +258 -0
  177. package/src/node-skills-transport.test.ts +209 -0
  178. package/src/node-token-identity.ts +35 -0
  179. package/src/node-token-ownership.ts +51 -0
  180. package/src/node-token-privilege-http.test.ts +158 -0
  181. package/src/not-found-api-http.test.ts +67 -0
  182. package/src/observer-avatar-http.test.ts +442 -0
  183. package/src/observer-push.test.ts +252 -0
  184. package/src/opencode-catalog-report-http.test.ts +139 -0
  185. package/src/opencode-v2-catalog.test.ts +268 -0
  186. package/src/opencode-v2-catalog.ts +352 -0
  187. package/src/package-version-consistency.test.ts +25 -0
  188. package/src/parent-source-marker.test.ts +50 -0
  189. package/src/password-network-tokens.ts +25 -0
  190. package/src/peer-reply-atomic.test.ts +455 -0
  191. package/src/peer-reply-capability.test.ts +70 -0
  192. package/src/pg-worker.ts +87 -0
  193. package/src/probe-validate.test.ts +221 -0
  194. package/src/probe-validate.ts +104 -0
  195. package/src/probe.test.ts +80 -0
  196. package/src/probe.ts +200 -0
  197. package/src/project-dir-warn-clear-http.test.ts +132 -0
  198. package/src/project-viewer-can-http.test.ts +116 -0
  199. package/src/push.test.ts +20 -10
  200. package/src/push.ts +466 -13
  201. package/src/redact-tokens.test.ts +65 -0
  202. package/src/redact-tokens.ts +40 -0
  203. package/src/rename.ts +38 -10
  204. package/src/reply-target-derivation.test.ts +96 -0
  205. package/src/report-status-handover-capabilities-http.test.ts +124 -0
  206. package/src/report-status-host-schema.test.ts +235 -0
  207. package/src/report-status-resume-id-handover.test.ts +184 -0
  208. package/src/report-status-secret-keys.test.ts +140 -0
  209. package/src/require-explicit-test-db.ts +9 -0
  210. package/src/requirement-due-reminders-http.test.ts +620 -0
  211. package/src/requirement-due-reminders.ts +416 -0
  212. package/src/requirement-events-http.test.ts +268 -0
  213. package/src/requirement-events.test.ts +45 -0
  214. package/src/requirement-events.ts +144 -0
  215. package/src/requirement-notify.ts +165 -0
  216. package/src/requirement-participant-notify-http.test.ts +309 -0
  217. package/src/requirement-tag-ops-http.test.ts +425 -0
  218. package/src/requirement-tag-tree-http.test.ts +275 -0
  219. package/src/requirement-tag-tree.ts +127 -0
  220. package/src/requirement-tags.ts +102 -0
  221. package/src/requirements-abandoned-http.test.ts +236 -0
  222. package/src/requirements-comment-http.test.ts +167 -0
  223. package/src/requirements-completed-at-migration.test.ts +70 -0
  224. package/src/requirements-errors-mcp-http.test.ts +164 -0
  225. package/src/requirements-errors.ts +158 -0
  226. package/src/requirements-etag-http.test.ts +91 -0
  227. package/src/requirements-http.test.ts +709 -0
  228. package/src/requirements-last-event-http.test.ts +349 -0
  229. package/src/requirements-list-mcp-slim-http.test.ts +155 -0
  230. package/src/requirements-list-slim-http.test.ts +324 -0
  231. package/src/requirements-mcp.test.ts +163 -0
  232. package/src/requirements-migrate.ts +283 -0
  233. package/src/requirements-owner-strict-mcp-http.test.ts +145 -0
  234. package/src/requirements-people-http.test.ts +114 -0
  235. package/src/requirements-people-mcp-http.test.ts +231 -0
  236. package/src/requirements-people.ts +196 -0
  237. package/src/requirements-priority-lowest.test.ts +114 -0
  238. package/src/requirements-projects-parent-http.test.ts +123 -0
  239. package/src/requirements-search-http.test.ts +182 -0
  240. package/src/requirements-search.test.ts +32 -0
  241. package/src/requirements-search.ts +145 -0
  242. package/src/requirements-seq-http.test.ts +193 -0
  243. package/src/requirements-seq-migration.test.ts +63 -0
  244. package/src/requirements-start-date.test.ts +125 -0
  245. package/src/requirements-stats-http.test.ts +357 -0
  246. package/src/requirements-stats.ts +195 -0
  247. package/src/requirements-status-participants-http.test.ts +222 -0
  248. package/src/requirements-upgrade-e2e.test.ts +126 -0
  249. package/src/requirements-upgrade-migration.test.ts +98 -0
  250. package/src/requirements.ts +2027 -0
  251. package/src/resolve-port.test.ts +57 -0
  252. package/src/resolve-port.ts +44 -0
  253. package/src/response-charset.test.ts +130 -0
  254. package/src/rest-alias-network-fallback-http.test.ts +123 -0
  255. package/src/rest-alias-network-fallback.test.ts +60 -0
  256. package/src/rest-alias-network-fallback.ts +65 -0
  257. package/src/rest-explicit-columns-http.test.ts +266 -0
  258. package/src/rest-identity.test.ts +130 -0
  259. package/src/rest-identity.ts +141 -0
  260. package/src/rest-projections.ts +72 -0
  261. package/src/rest-read-network-real-chain.test.ts +97 -0
  262. package/src/rest-write-network-resolution.test.ts +133 -0
  263. package/src/restart-readiness-http.test.ts +121 -0
  264. package/src/restricted-files.ts +76 -0
  265. package/src/retention-first-sweep-quiet.test.ts +31 -0
  266. package/src/retention.test.ts +100 -40
  267. package/src/retention.ts +423 -104
  268. package/src/route-callers-http.test.ts +120 -0
  269. package/src/route-timing.test.ts +211 -0
  270. package/src/route-timing.ts +262 -0
  271. package/src/rules-file-duplicate-alias.test.ts +234 -0
  272. package/src/rules-file-session-target.test.ts +207 -0
  273. package/src/rules-file-transport.test.ts +237 -0
  274. package/src/runtime-label.test.ts +22 -0
  275. package/src/runtime-label.ts +21 -0
  276. package/src/runtime-readiness.ts +90 -0
  277. package/src/schedule-agent-mcp-http.test.ts +391 -0
  278. package/src/schedule-agent.ts +192 -0
  279. package/src/schedule-starved.test.ts +92 -0
  280. package/src/schedule-starved.ts +114 -0
  281. package/src/scheduled-backoff-http.test.ts +193 -0
  282. package/src/scheduled-backoff.ts +64 -0
  283. package/src/scheduled-doorbell-nodeless-session.test.ts +134 -0
  284. package/src/scheduled-failure-backoff-2622.test.ts +145 -0
  285. package/src/scheduled-failure-code.test.ts +73 -0
  286. package/src/scheduled-failure-code.ts +105 -0
  287. package/src/scheduled-failures-http.test.ts +279 -0
  288. package/src/scheduled-failures.ts +377 -0
  289. package/src/scheduled-noprogress-backoff-2622.test.ts +133 -0
  290. package/src/scheduled-offline-backoff-probe.test.ts +56 -0
  291. package/src/scheduled-offline.test.ts +131 -0
  292. package/src/scheduled-offline.ts +66 -0
  293. package/src/scheduled-outcome-guidance-http.test.ts +139 -0
  294. package/src/scheduled-outcome-guidance.ts +9 -0
  295. package/src/scheduled-reply-unread-http.test.ts +212 -0
  296. package/src/scheduled-requirement-wake-http.test.ts +279 -0
  297. package/src/scheduled-requirement-wake.ts +125 -0
  298. package/src/scheduled-run-terminal.test.ts +268 -0
  299. package/src/scheduled-skip-blocking-task.test.ts +120 -0
  300. package/src/scheduled-skip-path-backoff-2622.test.ts +98 -0
  301. package/src/scheduled-stuck-http.test.ts +312 -0
  302. package/src/scheduled-stuck-notice-cap.test.ts +80 -0
  303. package/src/scheduled-stuck.ts +219 -0
  304. package/src/scheduled-tasks-http.test.ts +679 -0
  305. package/src/scheduled-tasks.ts +959 -0
  306. package/src/scheduled-work-outcome-http.test.ts +154 -0
  307. package/src/scheduled-work-outcome.ts +50 -0
  308. package/src/scoped-secrets.ts +139 -0
  309. package/src/send-dedup-request-id.test.ts +229 -0
  310. package/src/send-reply-agent-warning.test.ts +202 -0
  311. package/src/send-reply-alias-optional.test.ts +131 -0
  312. package/src/send-reply-attachments.test.ts +458 -0
  313. package/src/send_dedup.test.ts +54 -0
  314. package/src/send_dedup.ts +52 -6
  315. package/src/serve-error.test.ts +38 -0
  316. package/src/serve-error.ts +27 -0
  317. package/src/server.ts +5997 -0
  318. package/src/session-task-on-dispatch.ts +14 -0
  319. package/src/session-token-ownership-http.test.ts +122 -0
  320. package/src/shared/codex-inventory.ts +41 -0
  321. package/src/shared/daemon-provider-login.ts +31 -0
  322. package/src/shared/daemon-provider-snapshot.ts +52 -0
  323. package/src/shared/external-schedule-contract.ts +60 -0
  324. package/src/shared/node-name.test.ts +62 -0
  325. package/src/shared/node-name.ts +161 -0
  326. package/src/shared/probe-host-allowlist-drift.test.ts +54 -0
  327. package/src/shared/probe-host-allowlist.ts +128 -0
  328. package/src/shared/provider-application.ts +29 -0
  329. package/src/shared/provider-collection.ts +14 -0
  330. package/src/shared/provider-initialization.ts +8 -0
  331. package/src/shared/reserved-env-drift.test.ts +53 -0
  332. package/src/shared/reserved-env.test.ts +35 -0
  333. package/src/shared/reserved-env.ts +31 -0
  334. package/src/shared/scoped-secret-contract.ts +5 -0
  335. package/src/shared/task-content-limit-drift.test.ts +28 -0
  336. package/src/shared/task-content-limit.ts +25 -0
  337. package/src/side-thread-command-transport.test.ts +312 -0
  338. package/src/side-thread-command-transport.ts +318 -0
  339. package/src/side-thread-http-integration.test.ts +233 -0
  340. package/src/side-thread-http.ts +504 -0
  341. package/src/side-thread-production.test.ts +72 -0
  342. package/src/side-thread-production.ts +118 -0
  343. package/src/side-thread.test.ts +1067 -0
  344. package/src/side-thread.ts +2499 -0
  345. package/src/skillhub-http.test.ts +108 -0
  346. package/src/sqlite-close-checkpoint.test.ts +78 -0
  347. package/src/start-node.test.ts +264 -0
  348. package/src/status-alias-filter-http.test.ts +106 -0
  349. package/src/status-alias-resolver-http.test.ts +163 -0
  350. package/src/status-alias-resolver.ts +19 -0
  351. package/src/status-node-id-filter-http.test.ts +161 -0
  352. package/src/status-read-cache-http.test.ts +229 -0
  353. package/src/status-read-cache.ts +122 -0
  354. package/src/stop-delete-node.test.ts +1286 -0
  355. package/src/task-access-http.test.ts +402 -0
  356. package/src/task-access.ts +420 -0
  357. package/src/task-activity.ts +60 -0
  358. package/src/task-auth-origin-http.test.ts +93 -0
  359. package/src/task-auth-origin.test.ts +24 -0
  360. package/src/task-auth-origin.ts +7 -0
  361. package/src/task-consumption.test.ts +482 -0
  362. package/src/task-diagnostic-http.test.ts +149 -0
  363. package/src/task-diagnostic.test.ts +115 -0
  364. package/src/task-diagnostic.ts +118 -0
  365. package/src/task-expiry-notice-http.test.ts +287 -0
  366. package/src/task-expiry-notice.ts +315 -0
  367. package/src/task-idempotency-mcp.test.ts +142 -0
  368. package/src/task-idempotency.test.ts +76 -0
  369. package/src/task-idempotency.ts +81 -0
  370. package/src/task-late-replies.ts +54 -0
  371. package/src/task-late-reply-http.test.ts +152 -0
  372. package/src/task-lifecycle-watcher-busy.test.ts +114 -0
  373. package/src/task-lifecycle-watcher.test.ts +204 -0
  374. package/src/task-lifecycle-watcher.ts +109 -0
  375. package/src/task-network-resolution-http.test.ts +140 -0
  376. package/src/task-offline-delivery-2668.test.ts +119 -0
  377. package/src/task-offline-delivery.ts +81 -0
  378. package/src/task-orphan-http.test.ts +287 -0
  379. package/src/task-orphan.ts +119 -0
  380. package/src/task-queue-ahead-http.test.ts +309 -0
  381. package/src/task-queue-ahead-scale.test.ts +236 -0
  382. package/src/task-queue-ahead.ts +186 -0
  383. package/src/task-rejection-log-http.test.ts +160 -0
  384. package/src/task-rejection-log.ts +49 -0
  385. package/src/task-sender-http.test.ts +143 -0
  386. package/src/task-stale-open-http.test.ts +290 -0
  387. package/src/task-stale-open.ts +103 -0
  388. package/src/tasks-pagination-http.test.ts +141 -0
  389. package/src/team-rules-status-http.test.ts +90 -0
  390. package/src/team-rules-status.test.ts +59 -0
  391. package/src/team-rules-status.ts +72 -0
  392. package/src/tool-audience-http.test.ts +230 -0
  393. package/src/tool-audience.ts +120 -0
  394. package/src/tools-list-json-schema.test.ts +94 -0
  395. package/src/tools.ts +5815 -348
  396. package/src/update-provider.test.ts +234 -0
  397. package/src/upload-early-reject-guard.test.ts +155 -0
  398. package/src/uploads-http.test.ts +97 -15
  399. package/src/uploads.test.ts +66 -0
  400. package/src/uploads.ts +138 -5
  401. package/src/user-avatar-http.test.ts +74 -0
  402. package/src/user-avatar-image.ts +160 -0
  403. package/src/user-avatar-migration.test.ts +25 -0
  404. package/src/user-avatar-upload-http.test.ts +348 -0
  405. package/src/user-inbox-by-agent-http.test.ts +161 -0
  406. package/src/user-inbox-netid-notnull.test.ts +122 -0
  407. package/src/user-inbox-read-http.test.ts +223 -0
  408. package/src/user-inbox-schema.test.ts +54 -0
  409. package/src/vault.test.ts +200 -0
  410. package/src/vault.ts +156 -0
  411. package/src/version-stats.test.ts +66 -0
  412. package/src/version-stats.ts +109 -0
@@ -0,0 +1,128 @@
1
+ // RFC-028 P1 §4.4 — shared probe SSRF guards.
2
+ // Host allowlist + private IP block + validateBaseUrl.
3
+ //
4
+ // MUST be byte-identical between hub (server/src/shared/) and daemon
5
+ // (agent-node/src/shared/). Enforced by probe-host-allowlist-drift.test.ts
6
+ // (same pattern as reserved-env.ts G9 drift guard, RFC-026 §4.4.7).
7
+ //
8
+ // Why mirror not symlink: hub and daemon are separate npm packages
9
+ // installed independently on different machines. A drift-checked source
10
+ // copy survives `npm pack` + global install; a symlink does not.
11
+ //
12
+ // Threat model the daemon re-check defends against:
13
+ // - Compromised hub records a malicious base_url in providers/spec
14
+ // - Hub bypassed validateBaseUrl (regression / different code path)
15
+ // - On-wire injection between hub→daemon SSE
16
+ // Daemon trusts process.execPath + this file's content, NOT what
17
+ // `get_probe_request` claims. If hub-side check is identical, daemon
18
+ // re-check is a no-op; if hub-side ever loosens, daemon stays strict.
19
+
20
+ export class ProbeValidationError extends Error {
21
+ constructor(public code: string, public detail?: Record<string, unknown>) {
22
+ super(`${code}${detail ? ` ${JSON.stringify(detail)}` : ""}`);
23
+ this.name = "ProbeValidationError";
24
+ }
25
+ }
26
+
27
+ // ── §4.4.1 per-vendor host allowlist ──────────────────────────────
28
+ // `anthropic` vendor accepts Anthropic + curated 3rd-party Anthropic-
29
+ // compatible endpoints that Vincent / N站马 ship live providers
30
+ // against (DeepSeek + MiniMax both expose `/v1/messages` with the
31
+ // Anthropic protocol surface). Whitelist semantics preserved — NOT
32
+ // allow-any. New entries land here via PR with security review
33
+ // (network-admin-configurable allowlist is backlog: needs strong
34
+ // IP-range / shape guard before admins can edit).
35
+ //
36
+ // Per 通信龙 (RFC-028 P1.5+): the host whitelist is defense layer 1;
37
+ // layer 2 is the DNS-resolved IP block (FORBIDDEN_IPV{4,6}_RE below),
38
+ // applied AFTER allowlist passes. Any new host gets BOTH layers
39
+ // automatically — host in allowlist + DNS resolves to private/metadata
40
+ // IP still surfaces `probe_resolve_unsafe_ip`.
41
+ //
42
+ // P2 will add vendors (openai/zai/openrouter/qwen) as separate keys.
43
+ export const VENDOR_HOST_ALLOWLIST: Record<string, ReadonlyArray<RegExp>> = {
44
+ anthropic: [
45
+ /^api\.anthropic\.com$/,
46
+ /^api\.deepseek\.com$/, // Anthropic-compatible /v1/messages
47
+ /^api\.minimax\.chat$/, // MiniMax legacy domain
48
+ /^api\.minimax\.io$/, // MiniMax new domain (Vincent live use)
49
+ ],
50
+ // P2:
51
+ // openai: [/^api\.openai\.com$/],
52
+ // zai: [/^api\.z\.ai$/, /^open\.bigmodel\.cn$/],
53
+ // openrouter: [/^openrouter\.ai$/],
54
+ // qwen: [/^dashscope(-intl)?\.aliyuncs\.com$/],
55
+ };
56
+ export const SUPPORTED_VENDORS = Object.keys(VENDOR_HOST_ALLOWLIST);
57
+
58
+ // ── §4.4.2 private/reserved IP block (anti SSRF) ──────────────────
59
+ export const FORBIDDEN_IPV4_RE: ReadonlyArray<RegExp> = [
60
+ /^10\./,
61
+ /^127\./,
62
+ /^172\.(1[6-9]|2[0-9]|3[0-1])\./,
63
+ /^192\.168\./,
64
+ /^169\.254\./, // link-local + 169.254.169.254 cloud metadata
65
+ /^100\.(6[4-9]|[7-9][0-9]|1[01][0-9]|12[0-7])\./, // CGNAT
66
+ /^0\./,
67
+ /^22[4-9]\./, /^23[0-9]\./, // multicast
68
+ /^24[0-9]\./, /^25[0-5]\./, // experimental
69
+ ];
70
+ export const FORBIDDEN_IPV6_RE: ReadonlyArray<RegExp> = [
71
+ /^::1$/,
72
+ /^::$/,
73
+ /^fe80:/i, /^fc00:/i, /^fd00:/i,
74
+ ];
75
+
76
+ export function isLoopbackHost(host: string): boolean {
77
+ return host === "localhost" || host === "127.0.0.1" || host === "::1";
78
+ }
79
+
80
+ export function isForbiddenIp(ip: string): boolean {
81
+ // IPv4-mapped IPv6: ::ffff:10.0.0.1 — recurse on inner v4
82
+ if (ip.toLowerCase().startsWith("::ffff:")) {
83
+ return isForbiddenIp(ip.slice(7));
84
+ }
85
+ // Simple v4/v6 distinction by presence of '.' / ':'
86
+ if (ip.includes(":") && !ip.includes(".")) {
87
+ return FORBIDDEN_IPV6_RE.some(re => re.test(ip));
88
+ }
89
+ return FORBIDDEN_IPV4_RE.some(re => re.test(ip));
90
+ }
91
+
92
+ // ── §4.4.3 validateBaseUrl — boot/pre-fetch URL+host+vendor check ─
93
+ /** Pure, no I/O. Called by hub (upsert_provider write path) AND
94
+ * daemon (handleProbeDoorbell re-check after get_probe_request).
95
+ * allowLoopback: dev-only opt-in honoring http://localhost / 127.0.0.1.
96
+ * Production daemon MUST NOT set allowLoopback=true. */
97
+ export function validateBaseUrl(
98
+ vendor: string,
99
+ baseUrl: string,
100
+ opts: { allowLoopback?: boolean } = {},
101
+ ): void {
102
+ let u: URL;
103
+ try { u = new URL(baseUrl); }
104
+ catch {
105
+ throw new ProbeValidationError("probe_base_url_invalid", {
106
+ reason: "not a valid URL", baseUrl: baseUrl.slice(0, 100),
107
+ });
108
+ }
109
+
110
+ if (u.protocol !== "https:") {
111
+ if (!opts.allowLoopback || !isLoopbackHost(u.hostname) || u.protocol !== "http:") {
112
+ throw new ProbeValidationError("probe_base_url_invalid", {
113
+ reason: "must be https (or http+loopback with dev opt-in)",
114
+ });
115
+ }
116
+ }
117
+ const allowed = VENDOR_HOST_ALLOWLIST[vendor];
118
+ if (!allowed) {
119
+ throw new ProbeValidationError("vendor_not_supported", {
120
+ vendor, supported: SUPPORTED_VENDORS,
121
+ });
122
+ }
123
+ if (!allowed.some(re => re.test(u.hostname))) {
124
+ throw new ProbeValidationError("probe_target_forbidden", {
125
+ vendor, host: u.hostname, allowed: allowed.map(r => r.source),
126
+ });
127
+ }
128
+ }
@@ -0,0 +1,29 @@
1
+ // #906 public application protocol. No paths, endpoints or credentials.
2
+ export type ProviderApplicationSelection = {
3
+ node_id: string; node_revision: string; provider_id: string; auth_id: string;
4
+ model: string; confirm_restart: true;
5
+ account_id?: string;
6
+ };
7
+ const fields = (v: any, names: string[]) => v && typeof v === 'object' && !Array.isArray(v)
8
+ && Object.keys(v).length === names.length && Object.keys(v).every(k => names.includes(k));
9
+ const id = (v: any) => typeof v === 'string' && /^[A-Za-z0-9][A-Za-z0-9._:/-]{0,199}$/.test(v);
10
+ const hash = (v: any) => typeof v === 'string' && /^[a-f0-9]{64}$/.test(v);
11
+ const account = (v: any) => typeof v === 'string' && /^[a-f0-9]{8}-[a-f0-9]{4}-[a-f0-9]{4}-[a-f0-9]{4}-[a-f0-9]{12}$/i.test(v);
12
+ export function validProviderApplicationSelection(v: any): v is ProviderApplicationSelection {
13
+ return fields(v, ['node_id', 'node_revision', 'provider_id', 'auth_id', 'model', 'confirm_restart',
14
+ ...(v?.account_id !== undefined ? ['account_id'] : [])])
15
+ && (v.account_id === undefined || (v.provider_id === 'openai' && account(v.account_id)))
16
+ && id(v.node_id) && hash(v.node_revision) && id(v.provider_id) && id(v.auth_id) && id(v.model)
17
+ && v.confirm_restart === true;
18
+ }
19
+ export function validProviderApplicationReceipt(v: any, requestId: string, revision: number,
20
+ selection: ProviderApplicationSelection): boolean {
21
+ return fields(v, ['status', 'request_id', 'node_id', 'provider_id', 'auth_id', 'model', 'runtime_provider',
22
+ 'node_revision', 'provider_revision', 'verification', 'applied_at', ...(selection.account_id ? ['account_id'] : [])])
23
+ && v.status === 'applied' && v.request_id === requestId && v.node_id === selection.node_id
24
+ && v.provider_id === selection.provider_id && v.auth_id === selection.auth_id && v.model === selection.model
25
+ && (selection.account_id ? v.runtime_provider === 'openai' && v.account_id === selection.account_id
26
+ : typeof v.runtime_provider === 'string' && /^anet_[a-f0-9]{20}$/.test(v.runtime_provider))
27
+ && hash(v.node_revision) && v.provider_revision === revision && v.verification === 'runtime_confirmed'
28
+ && Number.isSafeInteger(v.applied_at) && v.applied_at > 0 && v.applied_at <= Date.now() + 30_000;
29
+ }
@@ -0,0 +1,14 @@
1
+ // #906 intent contains identifiers only. API keys remain on the owning daemon.
2
+ export type ProviderCollection = {
3
+ node_id: string; alias: string; node_revision: string;
4
+ provider_id: string; auth_id: string; label: string;
5
+ };
6
+ const id = (v: unknown) => typeof v === 'string' && /^[A-Za-z0-9][A-Za-z0-9_-]{0,63}$/.test(v);
7
+ export function validProviderCollection(v: any): v is ProviderCollection {
8
+ return !!v && typeof v === 'object' && !Array.isArray(v)
9
+ && Object.keys(v).every(k => ['node_id', 'alias', 'node_revision', 'provider_id', 'auth_id', 'label'].includes(k))
10
+ && id(v.node_id) && id(v.provider_id) && id(v.auth_id)
11
+ && typeof v.alias === 'string' && /^[\p{L}\p{N}][\p{L}\p{N}_.-]{0,99}$/u.test(v.alias)
12
+ && typeof v.node_revision === 'string' && /^[a-f0-9]{64}$/.test(v.node_revision)
13
+ && typeof v.label === 'string' && !!v.label.trim() && v.label.length <= 100 && !/[\x00-\x1f\x7f]/.test(v.label);
14
+ }
@@ -0,0 +1,8 @@
1
+ export type ProviderInitialization = { revision: number; provider_id: string; auth_id: string; model: string };
2
+ export function validProviderInitialization(value: any): value is ProviderInitialization {
3
+ const id = (v: unknown) => typeof v === 'string' && /^[A-Za-z0-9][A-Za-z0-9_-]{0,63}$/.test(v);
4
+ return !!value && typeof value === 'object' && !Array.isArray(value)
5
+ && Object.keys(value).every(key => ['revision', 'provider_id', 'auth_id', 'model'].includes(key))
6
+ && Number.isSafeInteger(value.revision) && value.revision >= 0 && id(value.provider_id) && id(value.auth_id)
7
+ && typeof value.model === 'string' && /^[A-Za-z0-9][A-Za-z0-9._:-]{0,99}$/.test(value.model);
8
+ }
@@ -0,0 +1,53 @@
1
+ import { describe, expect, test } from "bun:test";
2
+ import { readFileSync } from "node:fs";
3
+ import { join } from "node:path";
4
+ import {
5
+ RESERVED_ENV_KEYS_EXACT as HUB_EXACT,
6
+ RESERVED_ENV_PREFIXES as HUB_PREFIXES,
7
+ } from "./reserved-env.js";
8
+
9
+ // RFC-026 v4 §4.4.7 G9 drift guard — denylist MUST be hub-and-daemon
10
+ // identical, or attacker walks the looser layer. Two enforcement modes:
11
+ //
12
+ // 1. byte-identical source files (this test)
13
+ // 2. runtime set-equality of the imported constants
14
+ //
15
+ // We assert both. If a future contributor edits one side without the
16
+ // other, this test breaks the merge.
17
+
18
+ const HUB_PATH = join(import.meta.dir, "reserved-env.ts");
19
+ const DAEMON_PATH = join(import.meta.dir, "..", "..", "..", "agent-node", "src", "shared", "reserved-env.ts");
20
+ const CLI_PATH = join(import.meta.dir, "..", "..", "..", "agent-network", "src", "shared", "reserved-env.ts");
21
+
22
+ describe("RFC-026 v4 §4.4.7 G9 — hub/daemon reserved-env drift guard", () => {
23
+ test("byte-identical source files", () => {
24
+ const hub = readFileSync(HUB_PATH, "utf-8");
25
+ const daemon = readFileSync(DAEMON_PATH, "utf-8");
26
+ const cli = readFileSync(CLI_PATH, "utf-8");
27
+ expect(daemon).toBe(hub);
28
+ expect(cli).toBe(hub);
29
+ });
30
+
31
+ test("imported constants are set-equal at runtime", async () => {
32
+ // Use a dynamic file import path so this test breaks if the file
33
+ // moves but still references the daemon copy.
34
+ const daemonMod = await import(DAEMON_PATH);
35
+ const cliMod = await import(CLI_PATH);
36
+ const daemonExact = daemonMod.RESERVED_ENV_KEYS_EXACT as Set<string>;
37
+ const daemonPrefixes = daemonMod.RESERVED_ENV_PREFIXES as ReadonlyArray<string>;
38
+ const cliExact = cliMod.RESERVED_ENV_KEYS_EXACT as Set<string>;
39
+ const cliPrefixes = cliMod.RESERVED_ENV_PREFIXES as ReadonlyArray<string>;
40
+
41
+ // EXACT set equality
42
+ expect(daemonExact.size).toBe(HUB_EXACT.size);
43
+ for (const k of HUB_EXACT) expect(daemonExact.has(k)).toBe(true);
44
+ for (const k of daemonExact) expect(HUB_EXACT.has(k)).toBe(true);
45
+ expect(cliExact.size).toBe(HUB_EXACT.size);
46
+ for (const k of HUB_EXACT) expect(cliExact.has(k)).toBe(true);
47
+ for (const k of cliExact) expect(HUB_EXACT.has(k)).toBe(true);
48
+
49
+ // PREFIX array order-independent equality
50
+ expect(new Set(daemonPrefixes)).toEqual(new Set(HUB_PREFIXES));
51
+ expect(new Set(cliPrefixes)).toEqual(new Set(HUB_PREFIXES));
52
+ });
53
+ });
@@ -0,0 +1,35 @@
1
+ import { describe, expect, test } from "bun:test";
2
+ import { RESERVED_ENV_KEYS_EXACT, RESERVED_ENV_PREFIXES, isReservedEnvKey } from "./reserved-env.js";
3
+
4
+ describe("RFC-026 v4 §4.4.7 reserved env denylist (B1)", () => {
5
+ test("exact PATH/HOME/LANG/NODE_OPTIONS blocked", () => {
6
+ for (const k of ["PATH", "HOME", "LANG", "LC_ALL", "SHELL", "USER", "LOGNAME", "NODE_OPTIONS", "IFS", "TMPDIR"]) {
7
+ expect(isReservedEnvKey(k)).toBe(true);
8
+ }
9
+ });
10
+ test("LD_ prefix family blocked (Linux dynamic loader)", () => {
11
+ for (const k of ["LD_PRELOAD", "LD_LIBRARY_PATH", "LD_AUDIT", "LD_"]) {
12
+ expect(isReservedEnvKey(k)).toBe(true);
13
+ }
14
+ });
15
+ test("DYLD_ prefix blocked (macOS)", () => {
16
+ expect(isReservedEnvKey("DYLD_INSERT_LIBRARIES")).toBe(true);
17
+ expect(isReservedEnvKey("DYLD_LIBRARY_PATH")).toBe(true);
18
+ });
19
+ test("BUN_/NPM_/NPM_CONFIG_/NODE_ prefix blocked", () => {
20
+ expect(isReservedEnvKey("BUN_INSTALL")).toBe(true);
21
+ expect(isReservedEnvKey("NPM_TOKEN")).toBe(true);
22
+ expect(isReservedEnvKey("NPM_CONFIG_REGISTRY")).toBe(true);
23
+ expect(isReservedEnvKey("NODE_PATH")).toBe(true);
24
+ expect(isReservedEnvKey("NODE_TLS_REJECT_UNAUTHORIZED")).toBe(true);
25
+ });
26
+ test("legitimate API key style is NOT blocked", () => {
27
+ for (const k of ["ANTHROPIC_API_KEY", "OPENAI_API_KEY", "TELEGRAM_BOT_TOKEN", "DEEPSEEK_API_KEY", "MY_APP_CONFIG"]) {
28
+ expect(isReservedEnvKey(k)).toBe(false);
29
+ }
30
+ });
31
+ test("set shape sanity — both EXACT and PREFIX non-empty + frozen-ish", () => {
32
+ expect(RESERVED_ENV_KEYS_EXACT.size).toBeGreaterThan(10);
33
+ expect(RESERVED_ENV_PREFIXES.length).toBeGreaterThan(3);
34
+ });
35
+ });
@@ -0,0 +1,31 @@
1
+ // RFC-026 v4 §4.4.7 B1 — reserved env-key denylist (single source of
2
+ // truth for hub + daemon).
3
+ //
4
+ // Scope: env_refs naming a system/process-model sensitive key (PATH /
5
+ // LD_PRELOAD / NODE_OPTIONS / BUN_* / NPM_* / ...) MUST be rejected
6
+ // before the secret value ever reaches fork(), because such a key in
7
+ // the child env is effectively arbitrary code execution.
8
+ //
9
+ // G9 (drift guard): this module is the ONE source. Daemon-side runtime
10
+ // imports the same constants. A divergence between hub and daemon would
11
+ // let attacker target the looser layer; CI test asserts set equality.
12
+
13
+ export const RESERVED_ENV_KEYS_EXACT = new Set<string>([
14
+ "PATH", "HOME", "LANG", "LC_ALL", "SHELL", "USER", "LOGNAME",
15
+ "NODE_OPTIONS", "IFS", "PS1", "PS4", "ENV", "BASH_ENV",
16
+ "CDPATH", "PROMPT_COMMAND", "TMPDIR",
17
+ ]);
18
+
19
+ // Prefix-match denied. Order matters only for clarity (LD_ catches
20
+ // LD_PRELOAD / LD_LIBRARY_PATH / LD_AUDIT; DYLD_ catches DYLD_INSERT_
21
+ // LIBRARIES; BUN_ / NPM_ / NPM_CONFIG_ / NODE_ catch ecosystem-level
22
+ // runtime config).
23
+ export const RESERVED_ENV_PREFIXES: ReadonlyArray<string> = [
24
+ "LD_", "DYLD_", "BUN_", "NPM_", "NPM_CONFIG_", "NODE_",
25
+ ];
26
+
27
+ export function isReservedEnvKey(k: string): boolean {
28
+ if (RESERVED_ENV_KEYS_EXACT.has(k)) return true;
29
+ for (const p of RESERVED_ENV_PREFIXES) if (k.startsWith(p)) return true;
30
+ return false;
31
+ }
@@ -0,0 +1,5 @@
1
+ import { isReservedEnvKey } from './reserved-env';
2
+ export const validScopedSecretKey = (key: unknown): key is string => typeof key === 'string'
3
+ && /^[A-Z_][A-Z0-9_]{0,127}$/.test(key) && !isReservedEnvKey(key)
4
+ && !['CODEX_HOME','CLAUDE_CONFIG_DIR','XDG_CONFIG_HOME','XDG_DATA_HOME','TMUX','TMUX_PANE','TEMP','TMP'].includes(key)
5
+ && !['COMMHUB_','ANET_','CLAUDE_CODE_'].some(p => key.startsWith(p));
@@ -0,0 +1,28 @@
1
+ import { describe, expect, test } from "bun:test";
2
+ import { readFileSync } from "node:fs";
3
+ import { join } from "node:path";
4
+ import { SESSION_TASK_PREVIEW_MAX, TASK_CONTENT_MAX, sessionTaskPreview } from "./task-content-limit.js";
5
+
6
+ // Board #668 — the node reports the whole task so the hub can match it
7
+ // against tasks.content. Both sides must agree on the cap.
8
+ const HUB_PATH = join(import.meta.dir, "task-content-limit.ts");
9
+ const NODE_PATH = join(import.meta.dir, "..", "..", "..", "agent-node", "src", "shared", "task-content-limit.ts");
10
+
11
+ describe("#668 — hub/node task-content-limit drift guard", () => {
12
+ test("byte-identical source files", () => {
13
+ expect(readFileSync(NODE_PATH, "utf-8")).toBe(readFileSync(HUB_PATH, "utf-8"));
14
+ });
15
+
16
+ test("constants equal at runtime", async () => {
17
+ const node = await import(NODE_PATH);
18
+ expect(node.TASK_CONTENT_MAX).toBe(TASK_CONTENT_MAX);
19
+ expect(node.SESSION_TASK_PREVIEW_MAX).toBe(SESSION_TASK_PREVIEW_MAX);
20
+ });
21
+
22
+ test("preview is the first 200 chars", () => {
23
+ expect(SESSION_TASK_PREVIEW_MAX).toBe(200);
24
+ const long = "字".repeat(TASK_CONTENT_MAX);
25
+ expect(sessionTaskPreview(long)).toBe(long.slice(0, 200));
26
+ expect(sessionTaskPreview("short")).toBe("short");
27
+ });
28
+ });
@@ -0,0 +1,25 @@
1
+ // Board #668 — task text limits shared by hub and node.
2
+ //
3
+ // This file is byte-identical in server/src/shared/task-content-limit.ts and
4
+ // agent-node/src/shared/task-content-limit.ts (task-content-limit-drift.test.ts
5
+ // fails the build on any difference).
6
+ //
7
+ // TASK_CONTENT_MAX is the cap every dispatch entry (send_task, REST /api/task,
8
+ // scheduled tasks) and report_status.task accept. The node reports the whole
9
+ // task text so the hub can match it against tasks.content and write
10
+ // started_at. If the dispatch cap grew without the node and report_status
11
+ // following, long tasks would silently stop matching again.
12
+ //
13
+ // SESSION_TASK_PREVIEW_MAX is what the hub keeps in sessions.task. That column
14
+ // is readable by get_all_status, the full /api/status and members who may see
15
+ // the agent but not its conversations, so only a short preview is stored —
16
+ // the full text is used for matching, never persisted on the session row.
17
+
18
+ export const TASK_CONTENT_MAX = 10_000;
19
+
20
+ export const SESSION_TASK_PREVIEW_MAX = 200;
21
+
22
+ /** The preview stored in sessions.task — same cut as the dispatch preview. */
23
+ export function sessionTaskPreview(task: string): string {
24
+ return task.slice(0, SESSION_TASK_PREVIEW_MAX);
25
+ }