@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,195 @@
1
+ // #622 —— daemon 逐 runtime 自检(runtime_readiness)从 report_status 一路走到
2
+ // /api/host-supervisors。三件事:
3
+ // 1. report_status 的 zod 形状收得宽:坏的 runtime_readiness 只丢它自己,
4
+ // 绝不拒掉整份 report(否则一台 daemon 发了个奇怪的诊断字段就在 hub 上失联);
5
+ // 2. 新字段会被**保留**(daemon_capabilities 不是 strict,schema 里没声明的键会被
6
+ // 静默剥掉 —— 不加 schema 就永远到不了 REST);
7
+ // 3. REST 只在 daemon 报了时输出,旧 daemon 的行里**没有**这个键;
8
+ // can_create_nodes 语义不变。
9
+
10
+ import { describe, expect, test, beforeAll, afterAll } from "bun:test";
11
+ import "./require-explicit-test-db.js";
12
+ import { McpServer } from "@modelcontextprotocol/sdk/server/mcp.js";
13
+ import { register, login } from "./auth.js";
14
+ import { db } from "./db.js";
15
+ import { registerTools } from "./tools.js";
16
+ import { sanitizeRuntimeReadiness } from "./runtime-readiness.js";
17
+
18
+ function captureToolSchemas(): Record<string, any> {
19
+ const mcp = new McpServer({ name: "schema-probe", version: "0" }) as any;
20
+ const schemas: Record<string, any> = {};
21
+ const origTool = mcp.tool.bind(mcp);
22
+ mcp.tool = (name: string, desc: string, schema: any, handler: any) => {
23
+ schemas[name] = schema;
24
+ return origTool(name, desc, schema, handler);
25
+ };
26
+ registerTools(mcp, undefined, null, null, null, false, "tok_schema_probe");
27
+ return schemas;
28
+ }
29
+ const schemas = captureToolSchemas();
30
+ const snapSchema = () => schemas.report_status.config_snapshot;
31
+ const base = { flags: {}, config_update_capable: false, peer_reply_inbox_capable: true };
32
+
33
+ const READY = {
34
+ ok: true, state: "ready", reason: "可以创建", version: "2.1.290",
35
+ checked_at: "2026-10-06T03:00:00.000Z", cli: "found", auth: "present", network: "reachable",
36
+ };
37
+ const MISSING = {
38
+ ok: false, state: "missing_cli", reason: "新节点的 PATH 上找不到可用的 grok 命令", checked_at: "2026-10-06T03:00:00.000Z",
39
+ cli: "missing", auth: "present", network: "skipped",
40
+ };
41
+
42
+ describe("#622 report_status schema —— runtime_readiness", () => {
43
+ test("合法值透传(没被 daemon_capabilities 的非 strict 剥掉)", () => {
44
+ const parsed = snapSchema().parse({ ...base, daemon_capabilities: {
45
+ can_create_nodes: true,
46
+ runtime_readiness: { "claude-code-cli": READY, "grok-build-acp": MISSING, "codex-sdk": { ...READY, shared_login_count: 27 } },
47
+ } });
48
+ expect(parsed.daemon_capabilities.runtime_readiness["claude-code-cli"].state).toBe("ready");
49
+ expect(parsed.daemon_capabilities.runtime_readiness["grok-build-acp"].state).toBe("missing_cli");
50
+ expect(parsed.daemon_capabilities.runtime_readiness["codex-sdk"].shared_login_count).toBe(27);
51
+ expect(parsed.daemon_capabilities.can_create_nodes).toBe(true);
52
+ });
53
+
54
+ test("🔴 坏形状绝不拒整份 report —— 只丢这一格", () => {
55
+ for (const bad of [
56
+ "string", 42, null, [], { x: "notobj" },
57
+ Object.fromEntries(Array.from({ length: 40 }, (_, i) => [`rt${i}`, READY])),
58
+ ]) {
59
+ const parsed = snapSchema().parse({ ...base, daemon_capabilities: { can_create_nodes: true, runtime_readiness: bad } });
60
+ expect(parsed.daemon_capabilities.can_create_nodes).toBe(true);
61
+ expect(parsed.daemon_capabilities.runtime_readiness).toBeUndefined();
62
+ }
63
+ });
64
+
65
+ test("单个字段坏:schema 不拒整份;读取侧消毒把它兜成 unknown", () => {
66
+ const parsed = snapSchema().parse({ ...base, daemon_capabilities: {
67
+ can_create_nodes: true,
68
+ runtime_readiness: { a: { ok: "yes", state: 7, reason: "x".repeat(5000), shared_login_count: -3 } },
69
+ } });
70
+ expect(parsed.daemon_capabilities.can_create_nodes).toBe(true);
71
+ const a = sanitizeRuntimeReadiness(parsed.daemon_capabilities.runtime_readiness)!.a;
72
+ expect(a.ok).toBe(false);
73
+ expect(a.state).toBe("unknown");
74
+ expect(a.reason.length).toBe(600);
75
+ expect(a.shared_login_count).toBeUndefined();
76
+ });
77
+
78
+ test("总字节超 16 KB:整格丢掉(异常 daemon 不能往库里塞大对象)", () => {
79
+ const big = { a: { ...READY, reason: "x".repeat(20_000) } };
80
+ const parsed = snapSchema().parse({ ...base, daemon_capabilities: { can_create_nodes: true, runtime_readiness: big } });
81
+ expect(parsed.daemon_capabilities.runtime_readiness).toBeUndefined();
82
+ expect(parsed.daemon_capabilities.can_create_nodes).toBe(true);
83
+ });
84
+ });
85
+
86
+ describe("#622 sanitizeRuntimeReadiness(读取侧)", () => {
87
+ test("不认识的 state → unknown;ok 只有 ready 时才可能为真", () => {
88
+ const s = sanitizeRuntimeReadiness({
89
+ a: { ok: true, state: "something_new", reason: "r" },
90
+ b: { ok: true, state: "no_network", reason: "r" },
91
+ })!;
92
+ expect(s.a.state).toBe("unknown");
93
+ expect(s.a.ok).toBe(false);
94
+ expect(s.b.ok).toBe(false);
95
+ });
96
+ test("没报 / 空 → undefined(调用方据此不输出键)", () => {
97
+ expect(sanitizeRuntimeReadiness(undefined)).toBeUndefined();
98
+ expect(sanitizeRuntimeReadiness({})).toBeUndefined();
99
+ expect(sanitizeRuntimeReadiness([])).toBeUndefined();
100
+ });
101
+ test("未知枚举值的 cli/auth/network 被丢掉", () => {
102
+ const s = sanitizeRuntimeReadiness({ a: { ...READY, cli: "/home/x/bin/claude", network: "maybe" } })!;
103
+ expect(s.a.cli).toBeUndefined();
104
+ expect(s.a.network).toBeUndefined();
105
+ expect(s.a.auth).toBe("present");
106
+ });
107
+ test("generation and accepted stay only on opencode-cli", () => {
108
+ const s = sanitizeRuntimeReadiness({
109
+ "opencode-cli": { ...READY, state: "unknown", ok: false, generation: "v2", accepted: false },
110
+ "claude-code-cli": { ...READY, generation: "v2", accepted: true },
111
+ })!;
112
+ expect(s["opencode-cli"].generation).toBe("v2");
113
+ expect(s["opencode-cli"].accepted).toBe(false);
114
+ expect(s["claude-code-cli"].generation).toBeUndefined();
115
+ expect(s["claude-code-cli"].accepted).toBeUndefined();
116
+ const lone = sanitizeRuntimeReadiness({ "opencode-cli": { ...READY, accepted: true, generation: "nope" } })!;
117
+ expect(lone["opencode-cli"].generation).toBeUndefined();
118
+ expect(lone["opencode-cli"].accepted).toBeUndefined();
119
+ });
120
+ });
121
+
122
+ let BASE = "";
123
+ let server: any = null;
124
+ let userToken = "";
125
+ let userNetworkId = "";
126
+ let userId = "";
127
+
128
+ beforeAll(async () => {
129
+ process.env.HOST = "127.0.0.1";
130
+ const suffix = `${Date.now()}_${Math.floor(Math.random() * 1000)}`;
131
+ const password = "BootstrapPw123Aa!";
132
+ const seed = register(`rr_seed_${suffix}`, password, undefined, "seed");
133
+ if (!seed.ok) throw new Error("seed failed");
134
+ db.run("UPDATE users SET role = 'admin' WHERE username = ?1", [`rr_seed_${suffix}`]);
135
+ const u = register(`rr_u_${suffix}`, password, undefined, "seed");
136
+ if (!u.ok || !u.token) throw new Error("user register failed");
137
+ userToken = u.token;
138
+ userNetworkId = u.network_id ?? "";
139
+ userId = login(`rr_u_${suffix}`, password).user!.user_id;
140
+ const { bootServer } = await import("./server.js");
141
+ server = bootServer({ port: 0, hostname: "127.0.0.1" });
142
+ BASE = `http://127.0.0.1:${server.port}`;
143
+ await new Promise((r) => setTimeout(r, 100));
144
+ });
145
+
146
+ afterAll(() => {
147
+ try { server?.stop?.(true); } catch {}
148
+ });
149
+
150
+ function seedDaemon(alias: string, snapshot: object): void {
151
+ db.run(
152
+ `INSERT OR REPLACE INTO nodes (
153
+ node_id, node_name, alias, runtime, model, config_path,
154
+ channels, server, hostname, network_id, config_revision, config_snapshot
155
+ ) VALUES (?1, ?2, ?3, ?4, ?5, ?6, ?7, ?8, ?9, ?10, ?11, ?12)`,
156
+ [`rr_n_${alias}`, alias, alias, "claude-agent-sdk", null, "/tmp/cfg.json", "[]", "test-host", "test-host",
157
+ userNetworkId, 0, JSON.stringify(snapshot)],
158
+ );
159
+ db.run(
160
+ `INSERT OR REPLACE INTO api_tokens (token_id, token_hash, user_id, network_id, name, scope)
161
+ VALUES (?1, ?2, ?3, ?4, ?5, ?6)`,
162
+ [`rr_t_${alias}`, `hash_rr_${alias}`, userId, userNetworkId, `node:${alias}`, "network"],
163
+ );
164
+ }
165
+
166
+ async function listDaemons(): Promise<any[]> {
167
+ const res = await fetch(`${BASE}/api/host-supervisors`, { headers: { Authorization: `Bearer ${userToken}` } });
168
+ const body = await res.json();
169
+ if (!body.ok) throw new Error("list failed: " + JSON.stringify(body));
170
+ return body.daemons;
171
+ }
172
+
173
+ describe("#622 /api/host-supervisors 输出 runtime_readiness", () => {
174
+ test("新 daemon:逐 runtime 透传;can_create_nodes 不受影响", async () => {
175
+ db.run("DELETE FROM nodes WHERE network_id = ?1", [userNetworkId]);
176
+ seedDaemon("rr-new", { role: "host_supervisor", daemon_capabilities: {
177
+ runtimes_supported: ["claude-code-cli", "grok-build-acp"],
178
+ can_create_nodes: true,
179
+ runtime_readiness: { "claude-code-cli": READY, "grok-build-acp": MISSING },
180
+ } });
181
+ const d = (await listDaemons()).find((x) => x.alias === "rr-new");
182
+ expect(d.can_create_nodes).toBe(true);
183
+ expect(d.runtime_readiness["claude-code-cli"]).toEqual(READY);
184
+ expect(d.runtime_readiness["grok-build-acp"].state).toBe("missing_cli");
185
+ expect(d.runtime_readiness["grok-build-acp"].ok).toBe(false);
186
+ });
187
+
188
+ test("🔴 旧 daemon(不报):响应里没有这个键 —— 不是 {}、不是 null", async () => {
189
+ db.run("DELETE FROM nodes WHERE network_id = ?1", [userNetworkId]);
190
+ seedDaemon("rr-old", { role: "host_supervisor", daemon_capabilities: { runtimes_supported: ["claude-agent-sdk"], can_create_nodes: true } });
191
+ const d = (await listDaemons()).find((x) => x.alias === "rr-old");
192
+ expect(d.can_create_nodes).toBe(true);
193
+ expect("runtime_readiness" in d).toBe(false);
194
+ });
195
+ });
@@ -0,0 +1,279 @@
1
+ import { afterAll, beforeEach, describe, expect, test } from "bun:test";
2
+ import { db } from "./db.js";
3
+ import { parseStoredTags } from "./node-attrs-validate.js";
4
+
5
+ // Regression test for SELECT * fragility on GET /api/nodes.
6
+ //
7
+ // Prior behavior: `SELECT * FROM nodes` returned whatever columns the
8
+ // table happened to have. When RFC-024 added config_revision +
9
+ // config_snapshot columns (read by the per-node GET /api/nodes/:id/config
10
+ // endpoint, NOT meant for the list endpoint), they silently leaked into
11
+ // the list response and broke V3 Networks tests that asserted on the
12
+ // nodes-list row shape.
13
+ //
14
+ // Current behavior: explicit column list — the response contract is:
15
+ // node_id, node_name, alias, runtime, model, config_path, channels,
16
+ // server, hostname, network_id, created_at, updated_at
17
+ // This test runs the same SQL the handler uses, on a row that DOES have
18
+ // config_revision + config_snapshot populated, and asserts those fields
19
+ // do NOT appear in the returned row. If anyone reverts the handler to
20
+ // SELECT *, or adds an internal column to the SELECT, this test breaks.
21
+
22
+ const TEST_NETWORK = "net_test_shape";
23
+ const TEST_NODE = "node_test_shape_abc";
24
+
25
+ beforeEach(() => {
26
+ // Best-effort cleanup (test runs in shared test DB; rows are isolated by id)
27
+ try { db.run("DELETE FROM nodes WHERE node_id = ?1", [TEST_NODE]); } catch {}
28
+ });
29
+ afterAll(() => {
30
+ try { db.run("DELETE FROM nodes WHERE node_id = ?1", [TEST_NODE]); } catch {}
31
+ });
32
+
33
+ // Helper: mirror handler's role-extraction pass to mimic the production
34
+ // response shape exactly. Keeps the test the source of truth for the
35
+ // contract; if the handler changes, the assertions still lock what
36
+ // the dashboard / external clients see.
37
+ function mapRow(r: Record<string, unknown>): Record<string, unknown> {
38
+ let role: string | null = null;
39
+ // #2293 —— 与 handler 同一套读法:快照可能是文本或对象;解析失败/形状不对 = 这一格没有。
40
+ let opencodeCatalog: string[] | null = null;
41
+ let opencodeGeneration: "v1" | "v2" | null = null;
42
+ let opencodeMode: string | null = null;
43
+ let opencodeServer: string | null = null;
44
+ const snap = r.config_snapshot;
45
+ if (snap) {
46
+ let parsed: any = null;
47
+ try { parsed = typeof snap === "string" ? JSON.parse(snap) : snap; }
48
+ catch { parsed = null; }
49
+ role = parsed?.role ?? null;
50
+ const raw = parsed?.opencode_catalog;
51
+ if (Array.isArray(raw) && raw.every((m: unknown) => typeof m === "string" && m.length <= 400)) {
52
+ opencodeCatalog = raw.slice(0, 400);
53
+ }
54
+ const flags = parsed?.flags;
55
+ if (flags?.opencodeGeneration === "v1" || flags?.opencodeGeneration === "v2") opencodeGeneration = flags.opencodeGeneration;
56
+ if (typeof flags?.opencodeMode === "string" && flags.opencodeMode.length <= 32) opencodeMode = flags.opencodeMode;
57
+ if (typeof parsed?.opencode_server === "string" && parsed.opencode_server.length <= 200) opencodeServer = parsed.opencode_server;
58
+ }
59
+ const { config_snapshot, ...rest } = r;
60
+ return {
61
+ ...rest,
62
+ tags: parseStoredTags(r.tags),
63
+ attrs_revision: Number(r.attrs_revision ?? 0),
64
+ role,
65
+ opencode_catalog: opencodeCatalog,
66
+ opencode_generation: opencodeGeneration,
67
+ opencode_mode: opencodeMode,
68
+ opencode_server: opencodeServer,
69
+ };
70
+ }
71
+
72
+ describe("RFC-024 regression — GET /api/nodes response shape (no SELECT *)", () => {
73
+ test("explicit columns + role extracted: config_snapshot NOT in response, role IS", () => {
74
+ // Insert a row with the leak-prone columns populated. Use INSERT OR
75
+ // REPLACE so concurrent test runs don't trip on PRIMARY KEY.
76
+ db.run(
77
+ `INSERT OR REPLACE INTO nodes (
78
+ node_id, node_name, alias, runtime, model, config_path,
79
+ channels, server, hostname, network_id,
80
+ config_revision, config_snapshot
81
+ ) VALUES (
82
+ ?1, ?2, ?3, ?4, ?5, ?6, ?7, ?8, ?9, ?10, ?11, ?12
83
+ )`,
84
+ [TEST_NODE, "test-shape", "test-shape", "claude-agent-sdk", "claude-opus",
85
+ "/tmp/cfg.json", "[]", "localhost", "test-host", TEST_NETWORK,
86
+ 7, JSON.stringify({ model: "claude-opus", flags: { x: true }, role: "host_supervisor" })],
87
+ );
88
+
89
+ // Mirror handler SQL + mapping
90
+ const raw = db.all<Record<string, unknown>>(
91
+ `SELECT node_id, node_name, alias, runtime, model,
92
+ config_path, channels, server, hostname,
93
+ network_id, created_at, updated_at,
94
+ config_snapshot, display_name, team, tags, attrs_revision
95
+ FROM nodes WHERE node_id = ?1`,
96
+ TEST_NODE,
97
+ );
98
+ const rows = raw.map(mapRow);
99
+
100
+ expect(rows).toHaveLength(1);
101
+ const row = rows[0]!;
102
+ // Expected fields present (13 = 12 contract + new role)
103
+ for (const k of ["node_id", "node_name", "alias", "runtime", "model",
104
+ "config_path", "channels", "server", "hostname",
105
+ "network_id", "created_at", "updated_at", "role", "opencode_catalog"]) {
106
+ expect(row).toHaveProperty(k);
107
+ }
108
+ // Internal fields NOT present
109
+ expect(row).not.toHaveProperty("config_revision");
110
+ expect(row).not.toHaveProperty("config_snapshot");
111
+ // role is EXTRACTED from config_snapshot JSON, not the raw blob
112
+ expect(row.role).toBe("host_supervisor");
113
+ // Belt: the key set is exactly the dashboard-facing contract.
114
+ // NOTE: this file MIRRORS the handler's SQL rather than calling it, so
115
+ // it can drift — it already lagged behind `lifecycle_state` /
116
+ // `avatar_url`, which the handler selects but this mirror does not.
117
+ // Treat a diff here as "re-read the handler", not as proof of the wire
118
+ // shape; node-attrs.test.ts asserts the real HTTP response.
119
+ expect(Object.keys(row).sort()).toEqual([
120
+ "alias", "attrs_revision", "channels", "config_path", "created_at",
121
+ "display_name", "hostname", "model", "network_id", "node_id",
122
+ "node_name", "opencode_catalog", "opencode_generation", "opencode_mode",
123
+ "opencode_server", "role", "runtime", "server", "tags", "team",
124
+ "updated_at",
125
+ ]);
126
+ });
127
+
128
+ test("role is null when config_snapshot is empty / missing / malformed", () => {
129
+ // Empty snapshot → null
130
+ db.run(
131
+ `INSERT OR REPLACE INTO nodes (node_id, node_name, alias, network_id, config_snapshot)
132
+ VALUES (?1, ?2, ?3, ?4, NULL)`,
133
+ [TEST_NODE, "test-shape", "test-shape", TEST_NETWORK],
134
+ );
135
+ let row = mapRow(db.get<Record<string, unknown>>(
136
+ `SELECT node_id, node_name, alias, runtime, model, config_path, channels,
137
+ server, hostname, network_id, created_at, updated_at, config_snapshot,
138
+ display_name, team, tags, attrs_revision
139
+ FROM nodes WHERE node_id = ?1`,
140
+ TEST_NODE,
141
+ )!);
142
+ expect(row.role).toBeNull();
143
+ expect(row).not.toHaveProperty("config_snapshot");
144
+
145
+ // Malformed JSON → null (handler doesn't throw, just leaves role null)
146
+ db.run(`UPDATE nodes SET config_snapshot = ?1 WHERE node_id = ?2`, ["not-json{", TEST_NODE]);
147
+ row = mapRow(db.get<Record<string, unknown>>(
148
+ `SELECT node_id, node_name, alias, runtime, model, config_path, channels,
149
+ server, hostname, network_id, created_at, updated_at, config_snapshot,
150
+ display_name, team, tags, attrs_revision
151
+ FROM nodes WHERE node_id = ?1`,
152
+ TEST_NODE,
153
+ )!);
154
+ expect(row.role).toBeNull();
155
+
156
+ // Snapshot without role key → null
157
+ db.run(`UPDATE nodes SET config_snapshot = ?1 WHERE node_id = ?2`,
158
+ [JSON.stringify({ model: "x", flags: {} }), TEST_NODE]);
159
+ row = mapRow(db.get<Record<string, unknown>>(
160
+ `SELECT node_id, node_name, alias, runtime, model, config_path, channels,
161
+ server, hostname, network_id, created_at, updated_at, config_snapshot,
162
+ display_name, team, tags, attrs_revision
163
+ FROM nodes WHERE node_id = ?1`,
164
+ TEST_NODE,
165
+ )!);
166
+ expect(row.role).toBeNull();
167
+ });
168
+
169
+ test("daemon discovery use-case: dashboard finds role=host_supervisor without prefix heuristic", () => {
170
+ // Daemon registered with arbitrary node_id (NO `node_daemon_` prefix)
171
+ db.run(
172
+ `INSERT OR REPLACE INTO nodes (node_id, node_name, alias, network_id, config_snapshot)
173
+ VALUES (?1, ?2, ?3, ?4, ?5)`,
174
+ [TEST_NODE, "my-daemon", "my-daemon", TEST_NETWORK,
175
+ JSON.stringify({ role: "host_supervisor", runtime: "claude-agent-sdk" })],
176
+ );
177
+ const rows = db.all<Record<string, unknown>>(
178
+ `SELECT node_id, node_name, alias, runtime, model, config_path, channels,
179
+ server, hostname, network_id, created_at, updated_at, config_snapshot,
180
+ display_name, team, tags, attrs_revision
181
+ FROM nodes WHERE network_id = ?1`,
182
+ TEST_NETWORK,
183
+ ).map(mapRow);
184
+ // Dashboard's lookup: find first node with role==='host_supervisor'
185
+ const daemon = rows.find(r => r.role === "host_supervisor");
186
+ expect(daemon).toBeTruthy();
187
+ expect(daemon!.node_id).toBe(TEST_NODE);
188
+ // Even though node_id does NOT start with `node_daemon_` (the prior heuristic)
189
+ expect(String(daemon!.node_id).startsWith("node_daemon_")).toBe(false);
190
+ });
191
+
192
+ test("internal columns are still readable via dedicated query (config snapshot endpoint path)", () => {
193
+ db.run(
194
+ `INSERT OR REPLACE INTO nodes (node_id, node_name, alias, network_id,
195
+ config_revision, config_snapshot)
196
+ VALUES (?1, ?2, ?3, ?4, ?5, ?6)`,
197
+ [TEST_NODE, "test-shape", "test-shape", TEST_NETWORK,
198
+ 42, JSON.stringify({ model: "claude-opus" })],
199
+ );
200
+ // Mirrors the SELECT in GET /api/nodes/:id/config (server/src/index.ts):
201
+ const cfgRow = db.get<{ config_revision: number; config_snapshot: string }>(
202
+ "SELECT config_revision, config_snapshot FROM nodes WHERE node_id = ?1",
203
+ TEST_NODE,
204
+ );
205
+ expect(cfgRow?.config_revision).toBe(42);
206
+ expect(cfgRow?.config_snapshot).toContain("claude-opus");
207
+ });
208
+ });
209
+
210
+ // #2293(admin 2026-10-25)—— 节点自报的模型清单必须能到 /api/nodes:
211
+ // 「没有 daemon 绑定」的节点,客户端就是靠这一格给建议列表(否则只能手填)。
212
+ describe("#2293 opencode_catalog projection", () => {
213
+ const insert = (snapshot: unknown) => db.run(
214
+ `INSERT OR REPLACE INTO nodes (node_id, node_name, alias, network_id, config_snapshot)
215
+ VALUES (?1, ?2, ?3, ?4, ?5)`,
216
+ [TEST_NODE, "test-shape", "test-shape", TEST_NETWORK, typeof snapshot === "string" ? snapshot : JSON.stringify(snapshot)],
217
+ );
218
+ const read = () => mapRow(db.get<Record<string, unknown>>(
219
+ `SELECT node_id, node_name, alias, network_id, config_snapshot FROM nodes WHERE node_id = ?1`,
220
+ TEST_NODE,
221
+ )!);
222
+
223
+ test("valid list reaches the row, order kept", () => {
224
+ insert({ opencode_catalog: ["deepseek/deepseek-flash", "opencode/mimo-v2.6-flash-free"] });
225
+ expect(read().opencode_catalog).toEqual(["deepseek/deepseek-flash", "opencode/mimo-v2.6-flash-free"]);
226
+ });
227
+
228
+ test("absent / malformed / wrong shape → null, row still served", () => {
229
+ insert({ model: "x" });
230
+ expect(read().opencode_catalog).toBeNull();
231
+ insert("not-json{");
232
+ expect(read().opencode_catalog).toBeNull();
233
+ // 混了非字符串 → 整格作废(不猜、不部分展示)
234
+ insert({ opencode_catalog: ["a/b", 7] });
235
+ expect(read().opencode_catalog).toBeNull();
236
+ // 空列表是合法但无意义 → 照原样给出(客户端自己判断要不要建列表)
237
+ insert({ opencode_catalog: [] });
238
+ expect(read().opencode_catalog).toEqual([]);
239
+ });
240
+ });
241
+
242
+ // #2293(PR #1092 在真机上拿不到值的原因)—— /api/nodes 不带整个 config_snapshot,
243
+ // 但「Runtime · V2」「OpenCode Server」两行只要三个标量:代际、模式、loopback 端点。
244
+ describe("#2293 opencode_* scalars", () => {
245
+ test("generation / mode / server come from the snapshot, nothing else leaks", () => {
246
+ db.run(
247
+ `INSERT OR REPLACE INTO nodes (node_id, node_name, alias, network_id, config_snapshot)
248
+ VALUES (?1, ?2, ?3, ?4, ?5)`,
249
+ [TEST_NODE, "test-shape", "test-shape", TEST_NETWORK, JSON.stringify({
250
+ flags: { opencodeGeneration: "v2", opencodeMode: "copresence", secretOther: "must-not-leak" },
251
+ opencode_server: "http://127.0.0.1:4096",
252
+ })],
253
+ );
254
+ const row = mapRow(db.get<Record<string, unknown>>(
255
+ `SELECT node_id, node_name, alias, network_id, config_snapshot FROM nodes WHERE node_id = ?1`,
256
+ TEST_NODE,
257
+ )!);
258
+ expect(row.opencode_generation).toBe("v2");
259
+ expect(row.opencode_mode).toBe("copresence");
260
+ expect(row.opencode_server).toBe("http://127.0.0.1:4096");
261
+ expect(row).not.toHaveProperty("config_snapshot");
262
+ expect(JSON.stringify(row)).not.toContain("must-not-leak");
263
+ });
264
+
265
+ test("unknown generation / absent fields → null (old nodes keep rendering)", () => {
266
+ db.run(
267
+ `INSERT OR REPLACE INTO nodes (node_id, node_name, alias, network_id, config_snapshot)
268
+ VALUES (?1, ?2, ?3, ?4, ?5)`,
269
+ [TEST_NODE, "test-shape", "test-shape", TEST_NETWORK, JSON.stringify({ flags: { opencodeGeneration: "v9" } })],
270
+ );
271
+ const row = mapRow(db.get<Record<string, unknown>>(
272
+ `SELECT node_id, node_name, alias, network_id, config_snapshot FROM nodes WHERE node_id = ?1`,
273
+ TEST_NODE,
274
+ )!);
275
+ expect(row.opencode_generation).toBeNull();
276
+ expect(row.opencode_mode).toBeNull();
277
+ expect(row.opencode_server).toBeNull();
278
+ });
279
+ });