@bitkyc08/opencodex 2.100.2 → 2.100.4

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 (644) hide show
  1. package/AGENTS_INSTALL.md +23 -1
  2. package/README.md +1 -1
  3. package/bin/ocx.mjs +40 -19
  4. package/gui/dist/assets/{App-COo8Yopd.css → App-BGP8I0V4.css} +1 -1
  5. package/gui/dist/assets/App-DcpyI78f.js +60 -0
  6. package/gui/dist/assets/{Tray-BcaI-VCr.js → Tray-CzjPJprT.js} +1 -1
  7. package/gui/dist/assets/brand-mark-BTIi7e69.js +1 -0
  8. package/gui/dist/assets/index-DJxM-imn.css +2 -0
  9. package/gui/dist/assets/index-DVgU6S3y.js +138 -0
  10. package/gui/dist/assets/{segment-thumb-features-e9A_FogJ.js → segment-thumb-features-Bn6Y-g3R.js} +1 -1
  11. package/gui/dist/classic/assets/App-eYJAyNHM.js +59 -0
  12. package/gui/dist/classic/assets/{Tray-DT146AhS.js → Tray-xHMYxLkV.js} +1 -1
  13. package/gui/dist/classic/assets/index-DSaVRW4F.js +138 -0
  14. package/gui/dist/classic/assets/quota-summary-DyzHlkFl.js +1 -0
  15. package/gui/dist/classic/index.html +1 -1
  16. package/gui/dist/index.html +2 -2
  17. package/native/ocx-child/Cargo.toml +9 -0
  18. package/native/ocx-child/src/cli.rs +404 -20
  19. package/native/ocx-child/src/codex_home.rs +99 -14
  20. package/native/ocx-child/src/daemon.rs +2 -1
  21. package/native/ocx-child/src/lib.rs +3 -0
  22. package/native/ocx-child/src/link_ws.rs +2598 -0
  23. package/native/ocx-child/src/link_ws_advert.rs +346 -0
  24. package/native/ocx-child/src/link_ws_frame.rs +749 -0
  25. package/native/ocx-child/src/parity.rs +5 -1
  26. package/native/ocx-child/src/platform.rs +152 -6
  27. package/native/ocx-child/src/relay.rs +150 -19
  28. package/package.json +3 -3
  29. package/src/adapters/anthropic/advisor-tool.ts +176 -0
  30. package/src/adapters/anthropic/beta-body-pairs.ts +6 -0
  31. package/src/adapters/anthropic/client-identity.ts +3 -1
  32. package/src/adapters/anthropic/passthrough.ts +9 -3
  33. package/src/adapters/anthropic/per-message-effort.ts +296 -0
  34. package/src/adapters/anthropic.ts +34 -14
  35. package/src/adapters/claude-cli/adapter.ts +1 -0
  36. package/src/adapters/client-fingerprint.ts +3 -3
  37. package/src/adapters/cursor/discovery.ts +17 -0
  38. package/src/adapters/cursor/native-exec-desktop.ts +2 -1
  39. package/src/adapters/cursor/native-exec-shell.ts +2 -1
  40. package/src/adapters/cursor/protobuf-request.ts +8 -8
  41. package/src/adapters/cursor.ts +7 -6
  42. package/src/adapters/devin/cloud-direct/chat.ts +71 -14
  43. package/src/adapters/google-antigravity-wire.ts +7 -5
  44. package/src/adapters/google-errors.ts +14 -2
  45. package/src/adapters/google-wire-compiler.ts +2 -2
  46. package/src/adapters/google.ts +9 -2
  47. package/src/adapters/kiro/payload.ts +7 -4
  48. package/src/adapters/kiro/reasoning.ts +44 -1
  49. package/src/adapters/kiro/structured-output.ts +10 -8
  50. package/src/adapters/kiro-tools.ts +61 -15
  51. package/src/adapters/openai-chat/destination-policy.ts +16 -0
  52. package/src/adapters/openai-chat/reasoning-replay.ts +4 -1
  53. package/src/adapters/qoder/adapter.ts +9 -1
  54. package/src/adapters/zed.ts +7 -2
  55. package/src/advisor/consult.ts +15 -4
  56. package/src/advisor/context.ts +12 -3
  57. package/src/advisor/runtime.ts +35 -5
  58. package/src/advisor/settings.ts +8 -0
  59. package/src/advisor/synthetic-tool.ts +21 -8
  60. package/src/bridge/response-json.ts +11 -2
  61. package/src/bridge/sse.ts +43 -8
  62. package/src/claude/auth-detect.ts +21 -33
  63. package/src/claude/desktop-3p.ts +11 -5
  64. package/src/claude/desktop-gateway-state.ts +2 -0
  65. package/src/claude/desktop-remote-store-artifact.ts +14 -3
  66. package/src/claude/desktop-remote-store.ts +82 -12
  67. package/src/claude/inbound-content-options.ts +31 -16
  68. package/src/claude/outbound.ts +13 -3
  69. package/src/cli/account-api.ts +21 -1
  70. package/src/cli/account-auth.ts +83 -22
  71. package/src/cli/account-extended.ts +33 -2
  72. package/src/cli/account-key-quota.ts +34 -5
  73. package/src/cli/account.ts +4 -2
  74. package/src/cli/advisor.ts +7 -4
  75. package/src/cli/alias.ts +38 -1
  76. package/src/cli/capabilities-access-remote.ts +128 -3
  77. package/src/cli/capabilities-accounts.ts +6 -6
  78. package/src/cli/capabilities-agents-routing.ts +17 -10
  79. package/src/cli/capabilities-base.ts +49 -19
  80. package/src/cli/capabilities-integrations.ts +2 -2
  81. package/src/cli/capabilities-observe-system.ts +2 -2
  82. package/src/cli/capabilities-provider-models.ts +18 -2
  83. package/src/cli/capabilities-route-to.ts +43 -0
  84. package/src/cli/capabilities.ts +2 -0
  85. package/src/cli/capability-contracts.ts +1 -1
  86. package/src/cli/claude-desktop.ts +30 -11
  87. package/src/cli/claude.ts +17 -3
  88. package/src/cli/codex-launcher.ts +3 -1
  89. package/src/cli/codex-shim-autorestore.ts +5 -42
  90. package/src/cli/config-command.ts +14 -1
  91. package/src/cli/config-root-startup.ts +34 -0
  92. package/src/cli/connect.ts +88 -16
  93. package/src/cli/desktop-runtime-guidance.ts +1 -1
  94. package/src/cli/disconnect-runtime.ts +178 -0
  95. package/src/cli/dispatch.ts +61 -13
  96. package/src/cli/export-command.ts +1 -1
  97. package/src/cli/gui-pair-client.ts +6 -3
  98. package/src/cli/gui.ts +10 -5
  99. package/src/cli/help-catalog.ts +11 -0
  100. package/src/cli/help.ts +4 -3
  101. package/src/cli/index.ts +85 -94
  102. package/src/cli/inspect.ts +11 -2
  103. package/src/cli/integrations.ts +26 -1
  104. package/src/cli/link-apply-restart.ts +4 -2
  105. package/src/cli/link-capture.ts +64 -0
  106. package/src/cli/link-child-ops.ts +218 -40
  107. package/src/cli/link-cleanup.ts +8 -5
  108. package/src/cli/link-diagnostics.ts +67 -0
  109. package/src/cli/link-enrollment.ts +158 -12
  110. package/src/cli/link-operations.ts +52 -0
  111. package/src/cli/link-recover.ts +152 -0
  112. package/src/cli/link-routes.ts +90 -0
  113. package/src/cli/link-status-child.ts +44 -1
  114. package/src/cli/link-status-traffic.ts +34 -0
  115. package/src/cli/link.ts +315 -37
  116. package/src/cli/message-command.ts +1 -1
  117. package/src/cli/message-mcp-command.ts +23 -10
  118. package/src/cli/models-runtime.ts +3 -3
  119. package/src/cli/opencode.ts +3 -1
  120. package/src/cli/pi-sync.ts +35 -0
  121. package/src/cli/preflight-exemptions.ts +49 -0
  122. package/src/cli/registry.ts +33 -14
  123. package/src/cli/resolve.ts +23 -8
  124. package/src/cli/restart-failure.ts +15 -2
  125. package/src/cli/root.ts +5 -1
  126. package/src/cli/route-to.ts +172 -0
  127. package/src/cli/runtime-api.ts +9 -8
  128. package/src/cli/status.ts +7 -2
  129. package/src/cli/stop-approval.ts +66 -19
  130. package/src/cli/stop-report.ts +23 -0
  131. package/src/cli/stop-windows-checked.ts +304 -0
  132. package/src/cli/sync-command.ts +70 -15
  133. package/src/cli/sync-fanout.ts +74 -19
  134. package/src/cli/sync-flags.ts +40 -3
  135. package/src/cli/sync-link-status.ts +18 -2
  136. package/src/cli/sync-update-guard.ts +7 -2
  137. package/src/cli/system-command.ts +1 -1
  138. package/src/cli/system-restart-client.ts +10 -3
  139. package/src/cli/system-settings-parity.ts +2 -1
  140. package/src/cli/uninstall-plan.ts +77 -5
  141. package/src/cli/uninstall-stop.ts +152 -0
  142. package/src/cli/v2-input.ts +10 -6
  143. package/src/cli/v2-local-output.ts +3 -2
  144. package/src/cli/v2-runtime.ts +10 -3
  145. package/src/cli/v2.ts +22 -7
  146. package/src/client/connect.ts +376 -35
  147. package/src/client/desktop-refusal.ts +38 -0
  148. package/src/client/lifecycle-lock.ts +29 -4
  149. package/src/client/link-home-features.ts +27 -0
  150. package/src/client/link-home.ts +92 -4
  151. package/src/client/link-ingress.ts +21 -3
  152. package/src/client/link-join.ts +12 -2
  153. package/src/client/link-parity-reporter.ts +60 -6
  154. package/src/client/link-relay-transport.ts +161 -36
  155. package/src/client/link-relay.ts +150 -6
  156. package/src/client/link-request-compression.ts +84 -0
  157. package/src/client/link-state.ts +11 -5
  158. package/src/client/link-status.ts +39 -1
  159. package/src/client/link-teardown.ts +1 -0
  160. package/src/client/link-tunnel.ts +56 -5
  161. package/src/client/link-websocket-limits.ts +89 -0
  162. package/src/client/link-websocket.ts +586 -0
  163. package/src/client/link-ws-advertisement.ts +100 -0
  164. package/src/client/link-ws-framer.ts +241 -0
  165. package/src/client/link-ws-transport.ts +177 -0
  166. package/src/client/machine-api.ts +13 -2
  167. package/src/client/machine-listener.ts +48 -7
  168. package/src/client/route-intent-apply.ts +293 -0
  169. package/src/client/route-intent-file-originals.ts +97 -0
  170. package/src/client/route-intent-native-originals.ts +201 -0
  171. package/src/client/route-intent-watch.ts +141 -0
  172. package/src/client/runtime-restart.ts +141 -7
  173. package/src/client/runtime.ts +63 -15
  174. package/src/client/state.ts +44 -0
  175. package/src/client/sync-expectation.ts +36 -2
  176. package/src/client/sync-runtime.ts +7 -0
  177. package/src/clients/config-export/alias-selectors.ts +63 -40
  178. package/src/clients/config-export/contracts.ts +2 -0
  179. package/src/clients/config-export/nested-selectors.ts +42 -0
  180. package/src/clients/config-export.ts +22 -3
  181. package/src/codex/account-pause.ts +4 -0
  182. package/src/codex/account-runtime-state.ts +4 -0
  183. package/src/codex/account-store.ts +12 -3
  184. package/src/codex/account-usability.ts +13 -0
  185. package/src/codex/auth-api/account-list.ts +29 -3
  186. package/src/codex/auth-api/main-account-probe.ts +3 -1
  187. package/src/codex/auth-api/main-hard-lock-refusal-read.ts +172 -0
  188. package/src/codex/auth-collision.ts +23 -22
  189. package/src/codex/auth-context.ts +61 -8
  190. package/src/codex/catalog/build-entries.ts +10 -0
  191. package/src/codex/catalog/derive-entry.ts +7 -0
  192. package/src/codex/catalog/gather-capture.ts +8 -2
  193. package/src/codex/catalog/parsing.ts +7 -3
  194. package/src/codex/catalog/provider-models.ts +54 -15
  195. package/src/codex/catalog/reserve-warn.ts +7 -5
  196. package/src/codex/catalog/reserve.ts +4 -3
  197. package/src/codex/catalog/retained-sync.ts +4 -1
  198. package/src/codex/catalog/routed-defaults.ts +35 -0
  199. package/src/codex/catalog/routed-gather.ts +1 -1
  200. package/src/codex/catalog-auto-refresh.ts +11 -0
  201. package/src/codex/cli-update-job.ts +35 -13
  202. package/src/codex/convergence.ts +4 -2
  203. package/src/codex/desktop-compatibility/native-identity.ts +4 -8
  204. package/src/codex/features.ts +2 -2
  205. package/src/codex/history-provider.ts +31 -0
  206. package/src/codex/inject/multi-agent-v2.ts +9 -3
  207. package/src/codex/inject/paginated-openai-compat.ts +54 -1
  208. package/src/codex/inject/plan.ts +20 -2
  209. package/src/codex/inject.ts +2 -0
  210. package/src/codex/journal-config-restore.ts +217 -0
  211. package/src/codex/journal.ts +75 -6
  212. package/src/codex/loopback-target.ts +22 -8
  213. package/src/codex/main-account.ts +109 -57
  214. package/src/codex/native-main-auth-file.ts +118 -0
  215. package/src/codex/native-main-credentials.ts +270 -0
  216. package/src/codex/native-main-owner.ts +3 -0
  217. package/src/codex/native-main-refresh-mode.ts +14 -1
  218. package/src/codex/native-profile-manager.ts +4 -3
  219. package/src/codex/native-profile-store.ts +3 -61
  220. package/src/codex/orca-import.ts +10 -1
  221. package/src/codex/quota-history.ts +13 -0
  222. package/src/codex/quota-window-conflict.ts +103 -0
  223. package/src/codex/quota.ts +86 -15
  224. package/src/codex/subagent-model-fallback.ts +3 -1
  225. package/src/codex/websocket-activity.ts +171 -16
  226. package/src/codex/websocket-registry.ts +11 -4
  227. package/src/combos/cooldown-store.ts +25 -5
  228. package/src/combos/failover.ts +342 -3
  229. package/src/combos/index.ts +5 -0
  230. package/src/combos/resolve.ts +115 -19
  231. package/src/config/dashboard-trusted-proxy.ts +83 -0
  232. package/src/config/diagnostics.ts +31 -0
  233. package/src/config/feature-flags.ts +9 -0
  234. package/src/config/live-reconcile.ts +16 -4
  235. package/src/config/load-degrade.ts +14 -1
  236. package/src/config/multi-agent-surface.ts +28 -5
  237. package/src/config/pending-teardown.ts +60 -3
  238. package/src/config/persisted-mutation.ts +2 -2
  239. package/src/config/persisted-projections.ts +18 -0
  240. package/src/config/process-state.ts +176 -4
  241. package/src/config/provider-validation.ts +4 -4
  242. package/src/config/reserve-capability.ts +96 -0
  243. package/src/config/schema/config-schema.ts +12 -0
  244. package/src/config/schema/leaf-validators.ts +11 -2
  245. package/src/config/schema/routed-catalog-defaults.ts +49 -0
  246. package/src/config/windows-process-command-line.ts +107 -0
  247. package/src/config.ts +7 -7
  248. package/src/desktop-update/acquire.ts +202 -0
  249. package/src/desktop-update/cli.ts +168 -0
  250. package/src/desktop-update/drain.ts +40 -0
  251. package/src/desktop-update/headless.ts +285 -0
  252. package/src/desktop-update/image.ts +85 -0
  253. package/src/desktop-update/install.ts +53 -0
  254. package/src/desktop-update/msi.ts +72 -0
  255. package/src/desktop-update/release.ts +128 -0
  256. package/src/desktop-update/runtime.ts +155 -0
  257. package/src/desktop-update/staging.ts +118 -0
  258. package/src/desktop-update/trust.ts +45 -0
  259. package/src/generated/compatibility-version.json +1114 -442
  260. package/src/generated/model-metadata.ts +1 -1
  261. package/src/images/fulfill-video.ts +3 -3
  262. package/src/images/loop.ts +9 -2
  263. package/src/images/plan.ts +147 -11
  264. package/src/images/types.ts +13 -4
  265. package/src/images/xai-video-client.ts +72 -10
  266. package/src/integrations/model-name-guard.ts +25 -0
  267. package/src/integrations/route-intent-catalog.ts +26 -0
  268. package/src/integrations/route-intent-connected.ts +262 -0
  269. package/src/integrations/route-intent-contract.ts +55 -0
  270. package/src/integrations/route-intent-disconnect.ts +109 -0
  271. package/src/integrations/route-intent-initial.ts +64 -0
  272. package/src/integrations/route-intent-state.ts +117 -0
  273. package/src/integrations/route-intent-tick.ts +65 -0
  274. package/src/integrations/route-intent.ts +212 -0
  275. package/src/integrations/writer.ts +44 -11
  276. package/src/lib/client-retry-after.ts +29 -0
  277. package/src/lib/config-ownership.ts +13 -0
  278. package/src/lib/desktop-gui-origin.ts +28 -0
  279. package/src/lib/errors.ts +1 -1
  280. package/src/lib/gcp-adc.ts +48 -4
  281. package/src/lib/gui-pair-capability.ts +2 -1
  282. package/src/lib/messages-error-body.ts +4 -1
  283. package/src/lib/offline-resend.ts +150 -0
  284. package/src/lib/outbound-credential-registry.ts +362 -4
  285. package/src/lib/paced-stream.ts +34 -0
  286. package/src/lib/passive-key-fetch-proof.ts +30 -0
  287. package/src/lib/passive-read.ts +5 -0
  288. package/src/lib/process-control.ts +76 -12
  289. package/src/lib/provider-outbound.ts +17 -6
  290. package/src/lib/redact.ts +84 -8
  291. package/src/lib/request-failure-model.ts +2 -0
  292. package/src/lib/response-body-inactivity.ts +23 -1
  293. package/src/lib/state-store-registrations.ts +11 -0
  294. package/src/lib/state-store-sweeper.ts +4 -0
  295. package/src/lib/supervisor-markers.ts +18 -0
  296. package/src/lib/terminal-safe-text.ts +58 -0
  297. package/src/lib/translator-budget.ts +3 -2
  298. package/src/lib/upstream-retry.ts +52 -9
  299. package/src/link/alias-lock.ts +119 -0
  300. package/src/link/child-activity.ts +28 -2
  301. package/src/link/child-binary-cache-fill.d.mts +50 -0
  302. package/src/link/child-binary-cache-fill.mjs +494 -0
  303. package/src/link/child-binary-cache-start.ts +73 -0
  304. package/src/link/child-binary-source.ts +12 -5
  305. package/src/link/child-gated-ocx.ts +29 -11
  306. package/src/link/child-observations.ts +2 -1
  307. package/src/link/child-observe.ts +2 -2
  308. package/src/link/child-ops-engine.ts +159 -91
  309. package/src/link/child-ops-host.ts +138 -0
  310. package/src/link/child-ops-runners.ts +319 -0
  311. package/src/link/child-ops-scheduler.ts +207 -0
  312. package/src/link/child-ops-types.ts +89 -0
  313. package/src/link/child-parity.ts +23 -4
  314. package/src/link/child-policy.ts +93 -0
  315. package/src/link/child-update-contract.ts +12 -3
  316. package/src/link/codex-settings.ts +1 -1
  317. package/src/link/compatibility.ts +18 -1
  318. package/src/link/diagnostics-read.ts +163 -0
  319. package/src/link/diagnostics.ts +20 -7
  320. package/src/link/explicit-route.ts +209 -0
  321. package/src/link/link-recover.ts +113 -0
  322. package/src/link/management-routes.ts +3 -1
  323. package/src/link/operation-recovery-slot.ts +44 -0
  324. package/src/link/operations-journal.ts +408 -0
  325. package/src/link/peer-report.ts +1 -1
  326. package/src/link/relay-auth.ts +14 -0
  327. package/src/link/remote-plant.ts +152 -14
  328. package/src/link/remote-platform.ts +21 -10
  329. package/src/link/remote-probe.ts +11 -3
  330. package/src/link/remote-windows.ts +124 -36
  331. package/src/link/request-compression.ts +30 -0
  332. package/src/link/residual-recovery.ts +66 -0
  333. package/src/link/retirement.ts +128 -0
  334. package/src/link/route-intent-watch.ts +41 -0
  335. package/src/link/route-intent.ts +209 -0
  336. package/src/link/route-proof.ts +82 -0
  337. package/src/link/route-rounds.ts +579 -0
  338. package/src/link/route-select.ts +95 -0
  339. package/src/link/route-trust.ts +96 -0
  340. package/src/link/ssh-argv.ts +172 -24
  341. package/src/link/ssh-capture-redact.ts +253 -0
  342. package/src/link/ssh-capture.ts +497 -0
  343. package/src/link/ssh-runner.ts +141 -14
  344. package/src/link/status-projection.ts +87 -0
  345. package/src/link/store.ts +54 -1
  346. package/src/link/supervisor.ts +543 -55
  347. package/src/link/sync-fanout-classify.ts +16 -0
  348. package/src/link/sync-then-restart.ts +65 -0
  349. package/src/link/tombstones.ts +209 -0
  350. package/src/link/traffic.ts +178 -0
  351. package/src/link/ws-activity-holds.ts +474 -0
  352. package/src/local-credentials/publication-fence.ts +20 -1
  353. package/src/messaging/budget.ts +23 -5
  354. package/src/messaging/mcp-queue-rpc.ts +1 -1
  355. package/src/messaging/mcp-queue-server.ts +16 -1
  356. package/src/messaging/mcp-resume-tools.ts +25 -0
  357. package/src/messaging/remote-enrollment.ts +3 -3
  358. package/src/messaging/remote-tunnels.ts +2 -2
  359. package/src/messaging/resume-permissions.ts +27 -0
  360. package/src/messaging/rpc.ts +50 -6
  361. package/src/oauth/anthropic-continuity.ts +23 -7
  362. package/src/oauth/anthropic-routing.ts +5 -2
  363. package/src/oauth/anthropic.ts +22 -2
  364. package/src/oauth/antigravity-risk.ts +126 -0
  365. package/src/oauth/claude-keychain-read.ts +78 -68
  366. package/src/oauth/generic-account-failover.ts +89 -18
  367. package/src/oauth/generic-session-affinity.ts +10 -3
  368. package/src/oauth/index.ts +24 -6
  369. package/src/oauth/local-token-detect.ts +8 -29
  370. package/src/oauth/login-cli-errors.ts +5 -1
  371. package/src/oauth/login-cli.ts +68 -19
  372. package/src/oauth/login-flow-state.ts +26 -3
  373. package/src/oauth/meta-muse.ts +1 -1
  374. package/src/oauth/pool-kernel.ts +3 -3
  375. package/src/oauth/store.ts +7 -0
  376. package/src/oauth/xai.ts +248 -14
  377. package/src/protocols/contract.ts +4 -0
  378. package/src/protocols/encoders/messages.ts +1 -0
  379. package/src/providers/alias-template.ts +48 -0
  380. package/src/providers/anthropic-billing-ownership.ts +2 -0
  381. package/src/providers/anthropic-billing-refusal.ts +27 -3
  382. package/src/providers/anthropic-output-caps.ts +46 -0
  383. package/src/providers/anthropic-reset-grant-ledger.ts +9 -3
  384. package/src/providers/antigravity-effort-families.ts +11 -3
  385. package/src/providers/antigravity-models.ts +32 -9
  386. package/src/providers/antigravity-wire-snapshot.ts +3 -2
  387. package/src/providers/api-key-pause.ts +3 -0
  388. package/src/providers/api-key-resolve.ts +49 -7
  389. package/src/providers/api-key-response-ownership.ts +2 -0
  390. package/src/providers/api-key-selection.ts +51 -9
  391. package/src/providers/api-keys.ts +6 -2
  392. package/src/providers/cache-affinity-identity.ts +73 -0
  393. package/src/providers/cache-affinity.ts +256 -0
  394. package/src/providers/default-aliases.ts +98 -20
  395. package/src/providers/google-vertex-model-discovery.ts +515 -0
  396. package/src/providers/key-failover.ts +123 -8
  397. package/src/providers/key-store.ts +3 -3
  398. package/src/providers/kiro-models.ts +3 -5
  399. package/src/providers/label.ts +31 -5
  400. package/src/providers/mistral-transport.ts +17 -4
  401. package/src/providers/model-rename-fields.ts +5 -0
  402. package/src/providers/muse-key-quota.ts +14 -6
  403. package/src/providers/new-model-policy-runtime.ts +17 -4
  404. package/src/providers/new-model-policy.ts +30 -4
  405. package/src/providers/passive-key-observation.ts +252 -0
  406. package/src/providers/quota/account-cache.ts +2 -1
  407. package/src/providers/quota/anthropic-cooldown-recovery-worker.ts +121 -0
  408. package/src/providers/quota/passive-key-limits.ts +272 -0
  409. package/src/providers/quota/passive-wire-model.ts +126 -0
  410. package/src/providers/quota/report-cache.ts +61 -2
  411. package/src/providers/quota/workbuddy.ts +6 -2
  412. package/src/providers/quota-key-accounts.ts +11 -6
  413. package/src/providers/quota-types.ts +18 -0
  414. package/src/providers/quota.ts +11 -12
  415. package/src/providers/registry/entries-core.ts +34 -16
  416. package/src/providers/registry/entries-extended.ts +32 -0
  417. package/src/providers/registry/model-seeds.ts +35 -0
  418. package/src/providers/resolved-model-policy.ts +7 -0
  419. package/src/providers/routed-config.ts +8 -3
  420. package/src/providers/workbuddy-credit-balance.ts +125 -16
  421. package/src/providers/xai-transport.ts +3 -0
  422. package/src/remote/features.ts +17 -0
  423. package/src/responses/anthropic-progress.ts +10 -4
  424. package/src/responses/citation-markers.ts +231 -0
  425. package/src/responses/effort-history.ts +732 -0
  426. package/src/responses/spill-store.ts +5 -1
  427. package/src/responses/state/replay-input.ts +50 -0
  428. package/src/responses/state/replay-owner.ts +24 -0
  429. package/src/responses/state/snapshot-codec.ts +9 -0
  430. package/src/responses/state/spill-queue.ts +1 -0
  431. package/src/responses/state.ts +42 -60
  432. package/src/router.ts +2 -2
  433. package/src/routing/history/integrity.ts +41 -4
  434. package/src/routing/home-route-capture.ts +123 -0
  435. package/src/routing/home-route-intent.ts +200 -0
  436. package/src/routing/route-intent-state.ts +178 -0
  437. package/src/routing/route-to-live-settings.ts +35 -0
  438. package/src/routing/route-to-local.ts +145 -0
  439. package/src/routing/route-to-status.ts +94 -0
  440. package/src/routing/route-to-sync-child.ts +32 -0
  441. package/src/server/adapter-resolve.ts +21 -1
  442. package/src/server/admitted-http-turn.ts +3 -0
  443. package/src/server/auth-cors.ts +111 -3
  444. package/src/server/bare-upstream-error.ts +220 -0
  445. package/src/server/chat-native.ts +14 -5
  446. package/src/server/claude-messages.ts +6 -4
  447. package/src/server/codex-model-list.ts +4 -2
  448. package/src/server/configured-credentials.ts +37 -5
  449. package/src/server/direct-local-http.ts +26 -3
  450. package/src/server/gui-desktop-authorization.ts +36 -0
  451. package/src/server/gui-pair-delivery.ts +6 -3
  452. package/src/server/gui-session.ts +10 -1
  453. package/src/server/inbound-body-admission.ts +17 -4
  454. package/src/server/index/link-listener.ts +196 -12
  455. package/src/server/index/link-management.ts +15 -1
  456. package/src/server/index/link-relay-sessions.ts +87 -8
  457. package/src/server/index/link-websocket-limits.ts +136 -0
  458. package/src/server/index/link-websocket.ts +692 -0
  459. package/src/server/index/optional-listeners.ts +97 -7
  460. package/src/server/index/route-intent-watch.ts +47 -0
  461. package/src/server/index/serve-contract.ts +86 -0
  462. package/src/server/index/serve-options.ts +36 -86
  463. package/src/server/index/startup-warnings.ts +8 -2
  464. package/src/server/index/websocket-handler.ts +26 -4
  465. package/src/server/index.ts +15 -4
  466. package/src/server/inference/client-encoder-delivery.ts +2 -0
  467. package/src/server/inspection-tee.ts +39 -2
  468. package/src/server/lifecycle.ts +2 -0
  469. package/src/server/link-turn.ts +149 -0
  470. package/src/server/management/advisor-routes.ts +10 -2
  471. package/src/server/management/agent-settings-routes.ts +50 -16
  472. package/src/server/management/anthropic-reset-grant-routes.ts +1 -1
  473. package/src/server/management/config-routes.ts +39 -3
  474. package/src/server/management/context.ts +9 -2
  475. package/src/server/management/desktop-authorization.ts +41 -0
  476. package/src/server/management/desktop-compatibility-routes.ts +9 -8
  477. package/src/server/management/desktop-compatibility-runtime-routes.ts +3 -2
  478. package/src/server/management/desktop-compatibility-settings-routes.ts +5 -3
  479. package/src/server/management/home-integration-decision.ts +89 -0
  480. package/src/server/management/integration-routes.ts +208 -81
  481. package/src/server/management/link-child-ops-routes.ts +145 -43
  482. package/src/server/management/link-child-preflight.ts +31 -0
  483. package/src/server/management/link-diagnostics-route.ts +29 -0
  484. package/src/server/management/link-enrollment.ts +199 -47
  485. package/src/server/management/link-operation.ts +609 -0
  486. package/src/server/management/link-recover-route.ts +103 -0
  487. package/src/server/management/link-route-edit.ts +192 -0
  488. package/src/server/management/link-route-request.ts +62 -0
  489. package/src/server/management/link-route-state.ts +83 -7
  490. package/src/server/management/link-routes.ts +553 -51
  491. package/src/server/management/link-traffic-status.ts +13 -0
  492. package/src/server/management/model-routes.ts +122 -36
  493. package/src/server/management/model-rows.ts +2 -1
  494. package/src/server/management/native-integration-routes.ts +176 -70
  495. package/src/server/management/oauth-account-routes.ts +58 -18
  496. package/src/server/management/protocol-routes.ts +7 -0
  497. package/src/server/management/provider-completion-test.ts +4 -4
  498. package/src/server/management/provider-overwrite-carry.ts +14 -0
  499. package/src/server/management/provider-routes.ts +68 -65
  500. package/src/server/management/provider-routing-quota.ts +45 -0
  501. package/src/server/management/route-registry.ts +22 -3
  502. package/src/server/management/route-to-routes.ts +257 -0
  503. package/src/server/management/static-catalog-probe.ts +33 -0
  504. package/src/server/management/system-restart.ts +4 -2
  505. package/src/server/management/usage-aggregate-cache.ts +101 -66
  506. package/src/server/management-api.ts +17 -3
  507. package/src/server/management-auth.ts +13 -1
  508. package/src/server/messages-native-preflight.ts +27 -4
  509. package/src/server/messages-native.ts +17 -5
  510. package/src/server/persistent-gui-session.ts +6 -3
  511. package/src/server/proxy-liveness.ts +87 -15
  512. package/src/server/relay-eager.ts +36 -12
  513. package/src/server/relay.ts +189 -117
  514. package/src/server/request-body-facts.ts +48 -0
  515. package/src/server/request-decompress.ts +65 -2
  516. package/src/server/request-log-account-rotation.ts +6 -0
  517. package/src/server/request-log-attempt-usage.ts +69 -0
  518. package/src/server/request-log-cache-affinity.ts +60 -0
  519. package/src/server/request-log-conversation.ts +45 -2
  520. package/src/server/request-log-terminal-status.ts +210 -24
  521. package/src/server/request-log.ts +76 -80
  522. package/src/server/reserve-capability-startup.ts +32 -0
  523. package/src/server/responses/adapter-continuation.ts +2 -1
  524. package/src/server/responses/adapter-delivery.ts +4 -0
  525. package/src/server/responses/adapter-dispatch.ts +36 -17
  526. package/src/server/responses/advisor-plan-slot.ts +33 -1
  527. package/src/server/responses/advisor-question.ts +21 -0
  528. package/src/server/responses/advisor-slot.ts +10 -3
  529. package/src/server/responses/antigravity-fault-rotation.ts +24 -0
  530. package/src/server/responses/antigravity-validation-refusal.ts +43 -6
  531. package/src/server/responses/bare-namespace-aliases.ts +18 -0
  532. package/src/server/responses/buffered-sse-json.ts +9 -3
  533. package/src/server/responses/code-mode-collab-surface.ts +11 -0
  534. package/src/server/responses/codex-tool-catalog.ts +156 -0
  535. package/src/server/responses/combo-required-tool-fulfillments.ts +4 -2
  536. package/src/server/responses/combo-selection-keepalive.ts +254 -0
  537. package/src/server/responses/combo-stream-preflight.ts +557 -54
  538. package/src/server/responses/compact.ts +32 -8
  539. package/src/server/responses/core-codex-account.ts +17 -3
  540. package/src/server/responses/core-combo-failure.ts +8 -0
  541. package/src/server/responses/core-combo.ts +55 -12
  542. package/src/server/responses/core-errors.ts +13 -7
  543. package/src/server/responses/core-lifetime.ts +3 -2
  544. package/src/server/responses/core-normalize.ts +3 -1
  545. package/src/server/responses/core-options.ts +14 -0
  546. package/src/server/responses/core.ts +23 -0
  547. package/src/server/responses/estimated-usage.ts +115 -0
  548. package/src/server/responses/fetch-helpers.ts +15 -10
  549. package/src/server/responses/jev-model-invoke.ts +7 -2
  550. package/src/server/responses/native-replay-guard.ts +57 -0
  551. package/src/server/responses/opengateway-completion-guard.ts +10 -4
  552. package/src/server/responses/outbound-request-body.ts +29 -0
  553. package/src/server/responses/passthrough-completion.ts +109 -9
  554. package/src/server/responses/passthrough-delivery.ts +77 -18
  555. package/src/server/responses/passthrough-dispatch.ts +77 -73
  556. package/src/server/responses/policy-fallback.ts +13 -1
  557. package/src/server/responses/request-prepare.ts +59 -11
  558. package/src/server/responses/request-transport.ts +10 -3
  559. package/src/server/responses/reset-replay.ts +46 -2
  560. package/src/server/responses/run-turn-execution.ts +2 -0
  561. package/src/server/responses/sidecar-execution.ts +19 -0
  562. package/src/server/responses/terminal-error-redaction.ts +222 -25
  563. package/src/server/responses/ws-upstream.ts +2 -2
  564. package/src/server/sse-payload-rewrite.ts +3 -2
  565. package/src/server/stop-service-route.ts +85 -0
  566. package/src/server/system-env-shell.ts +12 -1
  567. package/src/server/system-env.ts +5 -3
  568. package/src/server/windows-tcp-drop.ts +21 -4
  569. package/src/server/workflow-refusal.ts +8 -0
  570. package/src/server/ws-bridge.ts +191 -12
  571. package/src/service/cli-windows-stop.ts +189 -0
  572. package/src/service/cli.ts +41 -12
  573. package/src/service/desktop-supervision.d.mts +2 -0
  574. package/src/service/desktop-supervision.mjs +5 -0
  575. package/src/service/disconnected-client-restart.ts +60 -0
  576. package/src/service/guarded-manager-target.ts +18 -1
  577. package/src/service/health.ts +99 -6
  578. package/src/service/launchd.ts +84 -31
  579. package/src/service/orchestration.ts +418 -91
  580. package/src/service/repair.ts +223 -6
  581. package/src/service/restart-proxy-stop.ts +79 -0
  582. package/src/service/service-child-ownership.ts +6 -2
  583. package/src/service/windows-checked-stop-live.ts +467 -0
  584. package/src/service/windows-checked-stop.ts +435 -0
  585. package/src/service/windows-command-line-token.ts +23 -0
  586. package/src/service/windows-guarded-manager.ts +77 -34
  587. package/src/service/windows-ops.ts +38 -56
  588. package/src/service/windows-process-evidence.ts +292 -0
  589. package/src/service/windows-process-native.ts +262 -0
  590. package/src/service/windows-service-stop.ts +321 -0
  591. package/src/service/windows-stop-binding.ts +187 -0
  592. package/src/service/windows-stop-budget.ts +123 -0
  593. package/src/service/windows-stop-confirm.ts +158 -0
  594. package/src/service/windows-stop-deadline.ts +56 -0
  595. package/src/service.ts +2 -2
  596. package/src/stall-timeout.ts +11 -0
  597. package/src/types/config.ts +57 -110
  598. package/src/types/link.ts +20 -0
  599. package/src/types/multi-agent.ts +13 -0
  600. package/src/types/provider.ts +60 -2
  601. package/src/types/request.ts +23 -0
  602. package/src/types/routed-catalog-defaults.ts +17 -0
  603. package/src/types/routing-profile.ts +90 -0
  604. package/src/types.ts +4 -0
  605. package/src/update/guarded-runtime-ops.ts +5 -7
  606. package/src/update/index.ts +26 -11
  607. package/src/update/install-detection.mjs +3 -1
  608. package/src/update/job-pinned-start.ts +2 -0
  609. package/src/update/job-windows-restart.ts +19 -32
  610. package/src/update/job.ts +12 -5
  611. package/src/update/npm-install.d.mts +11 -0
  612. package/src/update/npm-install.mjs +44 -7
  613. package/src/update/orchestrated-entry.ts +1 -1
  614. package/src/update/orchestrated-node-driver.mjs +3 -2
  615. package/src/update/orchestrated-pnpm.d.mts +4 -0
  616. package/src/update/orchestrated-pnpm.mjs +50 -6
  617. package/src/update/orchestrated-session.d.mts +3 -1
  618. package/src/update/orchestrated-session.mjs +21 -6
  619. package/src/update/pnpm-global-install.d.mts +21 -3
  620. package/src/update/pnpm-global-install.mjs +322 -19
  621. package/src/update/pnpm-store-layout.mjs +46 -0
  622. package/src/update/sync-update-mutex.d.mts +3 -2
  623. package/src/update/sync-update-mutex.mjs +57 -8
  624. package/src/update/transactional-install.d.mts +3 -1
  625. package/src/update/transactional-install.mjs +545 -12
  626. package/src/update/windows-installer-marker.d.mts +1 -0
  627. package/src/update/windows-installer-marker.mjs +44 -0
  628. package/src/usage/expected-prices.ts +8 -0
  629. package/src/usage/filter-index.ts +326 -77
  630. package/src/usage/ledger-scanner.ts +15 -0
  631. package/src/usage/link-log-fields.ts +48 -0
  632. package/src/usage/log.ts +57 -6
  633. package/src/usage/request-body.ts +37 -0
  634. package/src/usage/telemetry-contract.ts +1 -0
  635. package/src/web-search/loop.ts +3 -0
  636. package/src/web-search/passthrough-bridge.ts +7 -0
  637. package/gui/dist/assets/App-BpJOzw4F.js +0 -59
  638. package/gui/dist/assets/brand-mark-DU-0Vdkr.js +0 -1
  639. package/gui/dist/assets/index-Bbor_y80.js +0 -94
  640. package/gui/dist/assets/index-DJEkIDAi.css +0 -2
  641. package/gui/dist/classic/assets/App-BrIlUiLc.js +0 -58
  642. package/gui/dist/classic/assets/index-DyJHagvT.js +0 -94
  643. package/gui/dist/classic/assets/quota-summary-CakPe9Ni.js +0 -1
  644. package/src/server/management/desktop-compatibility-authorization.ts +0 -12
@@ -1,5 +1,7 @@
1
1
  import { execFileSync } from "node:child_process";
2
- import { existsSync, mkdirSync, readFileSync, unlinkSync } from "node:fs";
2
+ import { createHash, randomUUID } from "node:crypto";
3
+ import { existsSync, mkdirSync, readFileSync, readlinkSync, unlinkSync } from "node:fs";
4
+ import { hostname } from "node:os";
3
5
  import { join } from "node:path";
4
6
  import { isLocalAttestationSecret } from "../lib/local-management-attestation";
5
7
  import { assertNotRealHomeUnderTest } from "../lib/test-home-guard";
@@ -8,6 +10,7 @@ import {
8
10
  resolveTrustedWindowsSystemDirectory,
9
11
  } from "../lib/windows-elevation";
10
12
  import { atomicWriteFile } from "./atomic-write";
13
+ import { readWindowsProcessCommandLineNative } from "./windows-process-command-line";
11
14
  import { getConfigDir, hardenConfigDir } from "./paths";
12
15
  import { registerOwnHome, unregisterOwnerRegistryHome } from "./owner-registry";
13
16
 
@@ -26,8 +29,122 @@ function ensureProcessStateDir(): void {
26
29
  else hardenConfigDir();
27
30
  }
28
31
 
32
+ /**
33
+ * Whether this process has written `ocx.pid` or `runtime-port.json` in its own lifetime (#8552).
34
+ *
35
+ * Set before the write, deliberately even when the write then throws, and never cleared: a record
36
+ * this process wrote (or may have written) and later removed still means its PID once named a live
37
+ * owner of this home, so it can never be told apart from an earlier lifetime of the same PID number.
38
+ * Moving the assignment after the write would let a failed write fail open.
39
+ */
40
+ let publishedOwnershipRecords = false;
41
+
42
+ export function hasPublishedOwnershipRecords(): boolean {
43
+ return publishedOwnershipRecords;
44
+ }
45
+
46
+ /**
47
+ * Where the owner of a runtime record ran, as digests that store none of their inputs (#8552).
48
+ *
49
+ * Every container runs the proxy as PID 1, so a PID alone cannot say whether a record came from
50
+ * this container's previous run or from another container serving the same state volume. The
51
+ * `host` name must match, and on Linux at least one of two stronger facts as well
52
+ * ({@link sameRuntimeOwnerScope}):
53
+ *
54
+ * - `network` with `boot`, the network namespace within one boot: a container restarted inside
55
+ * its Kubernetes pod keeps it, because the pod sandbox owns it. Namespace inode numbers repeat
56
+ * across machines and boots, so the boot id has to match too;
57
+ * - `container`, the writable layer of the overlay mounted at `/` (its `upperdir`), counted only
58
+ * when its path carries a random 64-hex layer id (Docker's `overlay2` driver, containers/storage
59
+ * for Podman and CRI-O): a container started again keeps it, across a host reboot as well, and
60
+ * no other container ever mounts it, not even one sharing its network (`--network container:`)
61
+ * or its pod. A layer named by a sequence number (containerd's overlayfs snapshotter, which
62
+ * nodes built alike hand out identically) or a host whose own root is an overlay proves nothing
63
+ * beyond one machine, so it is not used; nor is a container id, which a container joined to
64
+ * another's network sees in mountinfo.
65
+ *
66
+ * A replacement pod, a second container with a fixed `hostname`, or another node matches neither.
67
+ * Processes that share one network namespace (host networking, pod sidecars, WSL distros, which
68
+ * share one VM) can match on `network`; for them the loopback probe still finds a listening owner.
69
+ * Elsewhere the PID space is the whole machine and the host name suffices. Linux evidence that
70
+ * cannot be read yields a per-process value that matches no other lifetime, so the self-record
71
+ * proof fails closed.
72
+ */
73
+ export interface RuntimeOwnerScope {
74
+ host: string;
75
+ boot?: string;
76
+ network?: string;
77
+ container?: string;
78
+ }
79
+
80
+ let cachedRuntimeOwnerScope: RuntimeOwnerScope | undefined;
81
+
82
+ export function runtimeOwnerScope(): RuntimeOwnerScope {
83
+ cachedRuntimeOwnerScope ??= computeRuntimeOwnerScope();
84
+ return cachedRuntimeOwnerScope;
85
+ }
86
+
87
+ function scopeDigest(...parts: string[]): string {
88
+ return createHash("sha256").update(parts.join("\0")).digest("hex").slice(0, 32);
89
+ }
90
+
91
+ /**
92
+ * The `upperdir` of the overlay mounted at `/` when it names a randomly identified writable layer
93
+ * (a `/<64 hex>/` path segment): a container's own layer, unique across machines. The last root
94
+ * mount wins, as it is the one visible. Any other root filesystem (bare host, btrfs/zfs/vfs drivers,
95
+ * fuse-overlayfs, an overlay host root, containerd's sequence-numbered snapshots) yields nothing.
96
+ */
97
+ export function rootOverlayUpperdirFromMountinfo(mountinfo: string): string | undefined {
98
+ let upperdir: string | undefined;
99
+ for (const line of mountinfo.split("\n")) {
100
+ const separator = line.indexOf(" - ");
101
+ if (separator < 0) continue;
102
+ const fields = line.slice(0, separator).split(" ");
103
+ if (fields[4] !== "/") continue;
104
+ const [fstype, , superOptions = ""] = line.slice(separator + 3).split(" ");
105
+ const match = fstype === "overlay" ? /(?:^|,)upperdir=([^,]+)/.exec(superOptions) : null;
106
+ upperdir = match && /\/[0-9a-f]{64}\//.test(match[1]) ? match[1] : undefined;
107
+ }
108
+ return upperdir;
109
+ }
110
+
111
+ function readOptional(read: () => string): string | undefined {
112
+ try { return read(); } catch { return undefined; }
113
+ }
114
+
115
+ function computeRuntimeOwnerScope(): RuntimeOwnerScope {
116
+ if (process.platform !== "linux") return { host: scopeDigest(process.platform, hostname()) };
117
+ const boot = readOptional(() => readFileSync("/proc/sys/kernel/random/boot_id", "utf8").trim());
118
+ const network = readOptional(() => readlinkSync("/proc/self/ns/net"));
119
+ const container = readOptional(() => rootOverlayUpperdirFromMountinfo(readFileSync("/proc/self/mountinfo", "utf8")) ?? "");
120
+ const scope: RuntimeOwnerScope = { host: scopeDigest("linux", hostname()) };
121
+ if (boot && /^[0-9a-f-]{36}$/.test(boot) && network && /^net:\[\d+\]$/.test(network)) {
122
+ scope.boot = scopeDigest("boot", boot);
123
+ scope.network = scopeDigest("net", network);
124
+ }
125
+ if (container) scope.container = scopeDigest("container", container);
126
+ if (!scope.network && !scope.container) return { host: scopeDigest("unverifiable", randomUUID()) };
127
+ return scope;
128
+ }
129
+
130
+ /**
131
+ * Whether a recorded owner scope proves the record was written where this process runs. Only an
132
+ * exact, well-formed match counts; anything else (absent, malformed, partial) is "no".
133
+ */
134
+ export function sameRuntimeOwnerScope(recorded: unknown, own: RuntimeOwnerScope): boolean {
135
+ if (!recorded || typeof recorded !== "object" || Array.isArray(recorded)) return false;
136
+ const record = recorded as Record<string, unknown>;
137
+ if (typeof record.host !== "string" || record.host !== own.host) return false;
138
+ if (own.network === undefined && own.container === undefined) {
139
+ return record.boot === undefined && record.network === undefined && record.container === undefined;
140
+ }
141
+ return (own.network !== undefined && record.network === own.network && own.boot !== undefined && record.boot === own.boot)
142
+ || (own.container !== undefined && record.container === own.container);
143
+ }
144
+
29
145
  export function writePid(pid: number): void {
30
146
  ensureProcessStateDir();
147
+ publishedOwnershipRecords = true;
31
148
  atomicWriteFile(getPidPath(), String(pid));
32
149
  }
33
150
 
@@ -41,12 +158,33 @@ export type RuntimePortState = {
41
158
  attestationSecret?: string;
42
159
  /** A Link runtime is draining; new and in-flight sync commits must stand down. */
43
160
  clientStopping?: true;
161
+ /**
162
+ * Fresh for every publication of a client runtime, including the rollback of a failed restart.
163
+ * A sync compares the whole record before each commit, so one captured before a restart cannot
164
+ * commit into the runtime that serves again afterwards (src/client/sync-runtime.ts).
165
+ */
166
+ servingGeneration?: string;
167
+ /**
168
+ * The owner a client runtime classified from positive evidence (src/client/runtime-restart.ts
169
+ * recordedRestartOwner: desktop, service-manager or none), or legacy-flag for a bare OCX_SERVICE=1
170
+ * (#8545). Absent for runtimes older than this field; `ocx disconnect` restarts only a runtime whose
171
+ * record states a proven owner, and gives the re-register advice for legacy-flag. Any string is
172
+ * accepted here so a later value never invalidates the record.
173
+ */
174
+ restartOwner?: string;
44
175
  /**
45
176
  * The live proxy's port when this runtime is a sibling instance started beside it
46
177
  * (`src/codex/sibling-start.ts`). `ocx stop` reads it to leave shared client routing alone.
47
- * Absent for every other runtime, so those records keep their bytes.
178
+ * Absent for every other runtime.
48
179
  */
49
180
  siblingOfPort?: number;
181
+ /**
182
+ * {@link runtimeOwnerScope} of the owner, stamped by {@link writeRuntimePort} when this process
183
+ * writes its own record. Not validated here: a malformed value must not hide a live owner from
184
+ * status, stop or liveness, and the one reader that uses it (`observeProxyLiveness`) accepts
185
+ * only an exact match ({@link sameRuntimeOwnerScope}).
186
+ */
187
+ ownerScope?: RuntimeOwnerScope;
50
188
  };
51
189
 
52
190
  export function isValidRuntimePortState(value: unknown): value is RuntimePortState {
@@ -64,12 +202,19 @@ export function isValidRuntimePortState(value: unknown): value is RuntimePortSta
64
202
  && hostnameOk
65
203
  && attestationOk
66
204
  && (state.clientStopping === undefined || state.clientStopping === true)
205
+ && (state.servingGeneration === undefined || (typeof state.servingGeneration === "string" && state.servingGeneration.length <= 64))
206
+ && (state.restartOwner === undefined || (typeof state.restartOwner === "string" && state.restartOwner.length <= 64))
67
207
  && siblingOk;
68
208
  }
69
209
 
70
210
  export function writeRuntimePort(state: RuntimePortState): void {
71
211
  ensureProcessStateDir();
72
- atomicWriteFile(getRuntimePortPath(), JSON.stringify(state, null, 2) + "\n");
212
+ publishedOwnershipRecords = true;
213
+ // Only the owner can say where it runs; a record written on another process's behalf keeps
214
+ // whatever identity it already carried.
215
+ const ownerScope = state.pid === process.pid ? runtimeOwnerScope() : state.ownerScope;
216
+ const record = { ...state, ...(ownerScope === undefined ? {} : { ownerScope }) };
217
+ atomicWriteFile(getRuntimePortPath(), JSON.stringify(record, null, 2) + "\n");
73
218
  // The record proves this home's owner only to a reader that knows where it lives.
74
219
  // One pointer in the shared registry makes the record findable from every home;
75
220
  // it is best-effort because ownership never depends on the registry write landing.
@@ -328,6 +473,28 @@ export function setProcessCommandLinePlatformForTests(next: NodeJS.Platform | nu
328
473
  processCommandLinePlatformForTests = next;
329
474
  }
330
475
 
476
+ type ProcessCommandLineNative = (pid: number) => string | undefined;
477
+ let processCommandLineNativeForTests: ProcessCommandLineNative | null = null;
478
+
479
+ /** Replace the in-process Windows command-line read; null restores the real one. */
480
+ export function setProcessCommandLineNativeForTests(next: ProcessCommandLineNative | null): void {
481
+ processCommandLineNativeForTests = next;
482
+ }
483
+
484
+ /** The in-process Windows read, or undefined so the spawned probes take their turn. */
485
+ function readNativeWindowsCommandLine(pid: number): string | undefined {
486
+ try {
487
+ if (processCommandLineNativeForTests) return processCommandLineNativeForTests(pid);
488
+ // A platform override means a test drives the spawned probes with fakes; the real native
489
+ // read would answer about this machine's process instead and bypass them.
490
+ if (processCommandLinePlatformForTests !== null) return undefined;
491
+ return readWindowsProcessCommandLineNative(pid);
492
+ } catch {
493
+ // A failed native read must leave the spawned probes their turn, not end the lookup.
494
+ return undefined;
495
+ }
496
+ }
497
+
331
498
  export function readProcessCommandLine(pid: number): string | undefined {
332
499
  if (!Number.isSafeInteger(pid) || pid <= 0) return undefined;
333
500
  const platform = processCommandLinePlatformForTests ?? process.platform;
@@ -342,7 +509,12 @@ export function readProcessCommandLine(pid: number): string | undefined {
342
509
  }
343
510
  }
344
511
  if (platform === "win32") {
345
- // WMIC is the fast path. Newer Windows images may omit it, so fall back to
512
+ // The in-process read answers in milliseconds. Get-CimInstance Win32_Process has been
513
+ // measured at 3.6-5.3 s on a busy machine, past the 3 s bound below, so without it a
514
+ // live runtime reads as unverified wherever WMIC is gone.
515
+ const native = readNativeWindowsCommandLine(pid);
516
+ if (native) return native;
517
+ // WMIC is the next path. Newer Windows images may omit it, so fall back to
346
518
  // the trusted fixed PowerShell binary without consulting PATH or env roots.
347
519
  const wmic = join(resolveTrustedWindowsSystemDirectory(), "wbem", "WMIC.exe");
348
520
  try {
@@ -507,7 +507,7 @@ export function modelCapabilitiesConfigError(value: unknown, allowTombstones = f
507
507
  if (allowTombstones && row === null) continue;
508
508
  if (!capabilityRecord(row)) return "modelCapabilities rows must be plain objects";
509
509
  for (const [axis, declaration] of Object.entries(row)) {
510
- if (!["inputModalities", "contextTier", "video", "deepseekImageFiles", "mistralMaxImages", "supportsReasoning", "supportsThinkingToggle", "supportsReasoningEffort", "defaultThinkingEnabled"].includes(axis)) return "modelCapabilities contains an unknown axis";
510
+ if (!["inputModalities", "contextTier", "video", "deepseekImageFiles", "mistralMaxImages", "responsesCustomTools", "supportsReasoning", "supportsThinkingToggle", "supportsReasoningEffort", "defaultThinkingEnabled"].includes(axis)) return "modelCapabilities contains an unknown axis";
511
511
  if (allowTombstones && declaration === null) continue;
512
512
  if (axis === "inputModalities") {
513
513
  if (!Array.isArray(declaration) || declaration.length === 0
@@ -520,7 +520,7 @@ export function modelCapabilitiesConfigError(value: unknown, allowTombstones = f
520
520
  if (typeof declaration !== "number" || !Number.isSafeInteger(declaration) || declaration < 1 || declaration > 1000) {
521
521
  return "modelCapabilities mistralMaxImages must be an integer from 1 to 1000";
522
522
  }
523
- } else if (["deepseekImageFiles", "supportsReasoning", "supportsThinkingToggle", "supportsReasoningEffort", "defaultThinkingEnabled"].includes(axis)) {
523
+ } else if (["deepseekImageFiles", "responsesCustomTools", "supportsReasoning", "supportsThinkingToggle", "supportsReasoningEffort", "defaultThinkingEnabled"].includes(axis)) {
524
524
  if (typeof declaration !== "boolean") return `modelCapabilities ${axis} must be a boolean`;
525
525
  } else {
526
526
  if (!capabilityRecord(declaration) || Object.keys(declaration).some(key => key !== "processing")) {
@@ -557,7 +557,7 @@ export function mergeModelCapabilities(
557
557
  } else if (axis === "mistralMaxImages") {
558
558
  if (value === null) delete row.mistralMaxImages;
559
559
  else row.mistralMaxImages = value as number;
560
- } else if (axis === "supportsReasoning" || axis === "supportsThinkingToggle" || axis === "supportsReasoningEffort" || axis === "defaultThinkingEnabled") {
560
+ } else if (axis === "responsesCustomTools" || axis === "supportsReasoning" || axis === "supportsThinkingToggle" || axis === "supportsReasoningEffort" || axis === "defaultThinkingEnabled") {
561
561
  if (value === null) delete row[axis];
562
562
  else row[axis] = value as boolean;
563
563
  } else if (axis === "video") {
@@ -587,7 +587,7 @@ export function sanitizeModelCapabilitiesForLoad(value: unknown): Record<string,
587
587
  for (const [id, raw] of Object.entries(value).slice(0, MODEL_DISCOVERY_MAX_MODELS)) {
588
588
  if (!capabilityRecord(raw) || !isValidModelDiscoveryModelId(id) || ["__proto__", "prototype", "constructor"].includes(id)) continue;
589
589
  const row: Record<string, unknown> = {};
590
- for (const axis of ["inputModalities", "contextTier", "video", "deepseekImageFiles", "mistralMaxImages", "supportsReasoning", "supportsThinkingToggle", "supportsReasoningEffort", "defaultThinkingEnabled"] as const) {
590
+ for (const axis of ["inputModalities", "contextTier", "video", "deepseekImageFiles", "mistralMaxImages", "responsesCustomTools", "supportsReasoning", "supportsThinkingToggle", "supportsReasoningEffort", "defaultThinkingEnabled"] as const) {
591
591
  if (!Object.hasOwn(raw, axis)) continue;
592
592
  const declaration = raw[axis];
593
593
  if (modelCapabilitiesConfigError({ [id]: { [axis]: declaration } }) === null) row[axis] = declaration;
@@ -0,0 +1,96 @@
1
+ import type { OcxConfig } from "../types";
2
+
3
+ /**
4
+ * Luna Reserve's own capability switch (#4961).
5
+ *
6
+ * Reserve used to ride `codexDesktopAuthless`, a flag documented as controlling whether the Codex app
7
+ * asks for a sign-in. It is now `codexReserveEnabled`, seeded once from that flag and independent of
8
+ * it afterwards. `codexReserveMigration` records that the seed happened.
9
+ *
10
+ * Until a document carries the marker, Reserve reads the legacy flag, which is exactly the value the
11
+ * migration persists. Startup records the seed for every unmarked file once, so after the first start
12
+ * on this version a hand edit of authless cannot move Reserve. Writers record it only when it matters:
13
+ * when a write changes authless (the seed then comes from the persisted pre-write document, so the
14
+ * change cannot move Reserve), when Reserve is set explicitly, or when a new document is created with
15
+ * authless on (new documents start disabled). Other writes leave an unmarked document byte-for-byte
16
+ * alone. Once the marker exists, an absent `codexReserveEnabled` means off, so deleting the field
17
+ * cannot bring the inheritance back.
18
+ *
19
+ * Enabling the capability never manufactures permission: every Reserve request still needs the
20
+ * upstream, credential-bound Reserve allowance, a non-client role and a loopback admission.
21
+ */
22
+ export const RESERVE_CAPABILITY_MIGRATION_VERSION = 1;
23
+
24
+ /**
25
+ * The two Reserve fields. A live save always rebases them against disk, even when the live config and
26
+ * its baseline both omit them: after the marker an absent value reads as off, so skipping a value only
27
+ * another process wrote would silently turn Reserve off. Explicit live edits still win the merge.
28
+ */
29
+ export const RESERVE_CAPABILITY_KEYS: readonly string[] = ["codexReserveEnabled", "codexReserveMigration"];
30
+
31
+ type ReserveCapabilityFields = Pick<OcxConfig, "codexReserveEnabled" | "codexReserveMigration" | "codexDesktopAuthless">;
32
+
33
+ function configRecord(value: unknown): Record<string, unknown> | undefined {
34
+ return value !== null && typeof value === "object" && !Array.isArray(value) ? value as Record<string, unknown> : undefined;
35
+ }
36
+
37
+ function isMigratedMarker(value: unknown): value is number {
38
+ return typeof value === "number" && Number.isInteger(value) && value >= RESERVE_CAPABILITY_MIGRATION_VERSION;
39
+ }
40
+
41
+ export function isReserveCapabilityMigrated(config: unknown): boolean {
42
+ return isMigratedMarker(configRecord(config)?.codexReserveMigration);
43
+ }
44
+
45
+ /** Whether the operator enabled Luna Reserve. Runtime role and listener admission are checked separately. */
46
+ export function isCodexReserveEnabled(config: Partial<ReserveCapabilityFields> | undefined): boolean {
47
+ if (!config) return false;
48
+ if (typeof config.codexReserveEnabled === "boolean") return config.codexReserveEnabled;
49
+ if (isMigratedMarker(config.codexReserveMigration)) return false;
50
+ return config.codexDesktopAuthless === true;
51
+ }
52
+
53
+ /** Seed this document from its own legacy flag, in place. Returns whether anything changed. */
54
+ export function migrateReserveCapability(config: OcxConfig): boolean {
55
+ if (isMigratedMarker(config.codexReserveMigration)) return false;
56
+ if (typeof config.codexReserveEnabled !== "boolean") config.codexReserveEnabled = config.codexDesktopAuthless === true;
57
+ config.codexReserveMigration = RESERVE_CAPABILITY_MIGRATION_VERSION;
58
+ return true;
59
+ }
60
+
61
+ /**
62
+ * Carry the migration onto a whole-config write. `persisted` is the document on disk before the
63
+ * write (undefined when none exists yet) and is the only authority for the legacy seed; a candidate
64
+ * without the marker is a snapshot taken before migration and never decides the seed itself.
65
+ */
66
+ export function projectReserveCapabilityMigration(persisted: unknown, candidate: OcxConfig): OcxConfig {
67
+ if (isMigratedMarker(candidate.codexReserveMigration)) return candidate;
68
+ const prior = configRecord(persisted);
69
+ if (prior && isMigratedMarker(prior.codexReserveMigration)) {
70
+ const projected = { ...candidate };
71
+ if (typeof projected.codexReserveEnabled !== "boolean") {
72
+ if (typeof prior.codexReserveEnabled === "boolean") projected.codexReserveEnabled = prior.codexReserveEnabled;
73
+ else delete projected.codexReserveEnabled;
74
+ }
75
+ // Same key order as the seed below, so carrying an unchanged state rewrites identical bytes.
76
+ projected.codexReserveMigration = prior.codexReserveMigration;
77
+ return projected;
78
+ }
79
+ const explicit = typeof candidate.codexReserveEnabled === "boolean";
80
+ // A new document has no earlier authless value to carry: it starts disabled.
81
+ const legacy = prior ? prior.codexDesktopAuthless === true : false;
82
+ // Nothing to record while authless keeps its persisted value: the reading is unchanged.
83
+ if (!explicit && (candidate.codexDesktopAuthless === true) === legacy) return candidate;
84
+ const projected = { ...candidate };
85
+ if (!explicit) projected.codexReserveEnabled = legacy;
86
+ projected.codexReserveMigration = RESERVE_CAPABILITY_MIGRATION_VERSION;
87
+ return projected;
88
+ }
89
+
90
+ /** After the projected write succeeds, the live object holds what was written. */
91
+ export function adoptReserveCapabilityMigration(target: OcxConfig, projected: OcxConfig): void {
92
+ if (projected.codexReserveMigration === undefined) delete target.codexReserveMigration;
93
+ else target.codexReserveMigration = projected.codexReserveMigration;
94
+ if (projected.codexReserveEnabled === undefined) delete target.codexReserveEnabled;
95
+ else target.codexReserveEnabled = projected.codexReserveEnabled;
96
+ }
@@ -1,3 +1,4 @@
1
+ import { dashboardTrustedProxySchema } from "../dashboard-trusted-proxy";
1
2
  import { MAIN_ACCOUNT_HARD_LOCK_MIN_PERCENT } from "../../codex/quota-types";
2
3
  import { validRemainingQuotaAccountIds } from "../../codex/account-use-remaining";
3
4
  import * as z from "zod/v4";
@@ -7,6 +8,7 @@ import { anthropicAccountPoolSchema } from "./anthropic-account-pool";
7
8
  import { compactionRecoverySchema } from "./compaction-recovery";
8
9
  import { nativeReasoningRetentionSchema } from "./native-reasoning-retention";
9
10
  import { workflowBudgetSchema } from "./workflow-budget";
11
+ import { routedCatalogDefaultsSchema } from "./routed-catalog-defaults";
10
12
  import { desktopCompatibilitySchema } from "./desktop-compatibility";
11
13
  import { blockedModelRedirectsSchema } from "./blocked-model-redirects";
12
14
  import { mainAccountHardLockFallbackSchema } from "./main-account-hard-lock-fallback";
@@ -116,6 +118,9 @@ export const configSchema = z.object({
116
118
  // Malformed optional remote blocks disable only remote GUI behavior. Live
117
119
  // candidates are rejected explicitly by remoteGuiConfigError below.
118
120
  hub: hubConfigSchema.optional().catch(undefined),
121
+ // #8338: a malformed hand edit disables only the trusted-proxy opt-in (Remember then stays direct
122
+ // HTTPS or loopback only); live writes get the exact reason from diagnostics.ts.
123
+ dashboardTrustedProxy: dashboardTrustedProxySchema.optional().catch(undefined),
119
124
  remoteGui: remoteGuiConfigSchema.optional().catch(undefined),
120
125
  // A malformed privacy block must never be read as "unmask": .catch(undefined) drops it and
121
126
  // emailMaskingEnabled then falls back to masked, which is also what an absent block means.
@@ -189,6 +194,8 @@ export const configSchema = z.object({
189
194
  // Match the per-body load/degrade contract: malformed hand edits retain providers.
190
195
  // The shared resolver clamps runtime admission to 512 MiB..2 GiB even when the
191
196
  // caller bypasses this schema; omission and zero retain the 512 MiB default.
197
+ // Home-side per-body zstd advertisement on Remote Links (#3023); anything but a boolean reads as unset, which is on.
198
+ linkRequestCompression: z.boolean().optional().catch(undefined),
192
199
  maxConcurrentInboundBodyBytes: z.number().int()
193
200
  .min(0)
194
201
  .optional()
@@ -228,6 +235,8 @@ export const configSchema = z.object({
228
235
  nativeReasoningRetention: nativeReasoningRetentionSchema.optional().catch(undefined),
229
236
  // A bad hand edit falls back to the built-in ceilings; it never turns the guard off.
230
237
  workflowBudget: workflowBudgetSchema.optional().catch(undefined),
238
+ // A bad hand edit drops the whole block, so routed rows keep today's derivation (#6872).
239
+ routedCatalogDefaults: routedCatalogDefaultsSchema.optional().catch(undefined),
231
240
  desktopCompatibility: desktopCompatibilitySchema.optional().catch(undefined),
232
241
  // A hand-edited malformed phase disables only that phase instead of rejecting
233
242
  // providers/apiKeys, matching the load-time degradation notice; the management write
@@ -338,6 +347,9 @@ export const configSchema = z.object({
338
347
  }).strict().optional().catch(undefined)),
339
348
  codexShimAutoRestore: z.boolean().optional(),
340
349
  codexDesktopAuthless: z.boolean().optional().catch(undefined),
350
+ codexReserveEnabled: z.boolean().optional().catch(undefined),
351
+ // A malformed marker degrades to unmigrated, which reseeds from the persisted authless flag.
352
+ codexReserveMigration: z.number().int().positive().optional().catch(undefined),
341
353
  codexClientCompaction: z.boolean().optional().catch(undefined),
342
354
  // Presentation-only label for the injected provider. A malformed value degrades to undefined
343
355
  // and the default label is emitted, rather than failing the parse or writing a config Codex
@@ -1,4 +1,5 @@
1
1
  import * as z from "zod/v4";
2
+ import { EXPORT_CLIENT_IDS } from "../../clients/client-ids";
2
3
  import { accountAutoPausePolicySchema, accountPauseDetailsSchema } from "./account-auto-pause";
3
4
  import { anthropicAccountPoolSchema } from "./anthropic-account-pool";
4
5
  import { join } from "node:path";
@@ -343,6 +344,8 @@ export const providerConfigSchema = z.object({
343
344
  // load silently and then be ignored at selection time, which reads as a broken feature
344
345
  // rather than a rejected setting.
345
346
  apiKeyPoolStrategy: z.enum(["round-robin", "fill-first", "quota"]).optional(),
347
+ // Strict writes reject invalid modes; load degradation removes invalid hand edits.
348
+ cacheAffinity: z.enum(["auto", "session", "turn", "off"]).optional(),
346
349
  autoReviewModel: autoReviewModelSchema.optional(),
347
350
  autoReviewModelOverrides: autoReviewModelOverridesSchema.optional(),
348
351
  adapter: z.string().min(1),
@@ -350,6 +353,8 @@ export const providerConfigSchema = z.object({
350
353
  tlsProfile: z.literal("antigravity-browser").optional(),
351
354
  alias: z.string().optional(),
352
355
  modelAliases: z.record(z.string(), z.string()).optional(),
356
+ // Grammar is checked by sanitizeAliasesForLoad and the alias-template route (#7705).
357
+ aliasTemplate: z.string().optional(),
353
358
  modelDisplayNames: modelDisplayNamesSchema.optional(),
354
359
  defaultAliases: z.boolean().optional(),
355
360
  initialModelSelection: z.object({
@@ -453,7 +458,10 @@ export const providerConfigSchema = z.object({
453
458
  }).strict().optional(),
454
459
  responsesSnapshotRepair: z.boolean().optional(),
455
460
  messagePhaseInference: z.boolean().optional(),
461
+ estimateMissingUsage: z.boolean().optional(),
456
462
  hideRawReasoning: z.boolean().optional(),
463
+ forwardAdvisorTool: z.boolean().optional(),
464
+ perMessageEffort: z.boolean().optional(),
457
465
  // Invalid blocks degrade to "absent" rather than failing the whole config load: an unusable
458
466
  // bridge block must never send an operator through invalid-config recovery for an opt-in
459
467
  // feature that is off by default. The management write boundary still rejects it loudly.
@@ -985,7 +993,7 @@ export const remoteGuiConfigSchema = z.object({
985
993
  allowInsecureHttp: z.boolean().optional(),
986
994
  }).strict();
987
995
 
988
- const connectedClientIdSchema = z.enum(["codex", "claude"]);
996
+ const connectedClientIdSchema = z.enum(["codex", "claude", "claude-desktop", "grok", ...EXPORT_CLIENT_IDS]);
989
997
  const clientTimestampSchema = z.string().datetime({ offset: true });
990
998
  const clientTransportSchema = z.enum(["hub", "link"]);
991
999
  const linkTransportSchema = z.object({
@@ -1008,7 +1016,7 @@ export const clientConnectionSchema = z.object({
1008
1016
  managementTransport: z.enum(["direct", "relay"]),
1009
1017
  transport: clientTransportSchema.optional(),
1010
1018
  link: linkTransportSchema.optional(),
1011
- selectedClients: z.array(connectedClientIdSchema).min(1).max(2).superRefine((clients, ctx) => {
1019
+ selectedClients: z.array(connectedClientIdSchema).superRefine((clients, ctx) => {
1012
1020
  if (new Set(clients).size !== clients.length) {
1013
1021
  ctx.addIssue({ code: "custom", message: "must contain unique client ids" });
1014
1022
  }
@@ -1074,6 +1082,7 @@ export const codexPoolSchema = z.object({
1074
1082
  excludedPlans: z.array(z.string().trim().min(1)).optional(),
1075
1083
  startIdleWindows: z.boolean().optional(),
1076
1084
  requestOwnedAffinity: z.boolean().optional(),
1085
+ poolOnly: z.boolean().optional(),
1077
1086
  lowQuotaProtection: z.object({
1078
1087
  enabled: z.boolean(),
1079
1088
  threshold: z.number().finite().min(1).max(100),
@@ -0,0 +1,49 @@
1
+ import * as z from "zod/v4";
2
+ import type { OcxConfig } from "../../types";
3
+ import type { OcxRoutedCatalogDefaultsConfig } from "../../types/routed-catalog-defaults";
4
+
5
+ /**
6
+ * Operator defaults for routed Codex catalog rows (#6872), stored as top-level
7
+ * `routedCatalogDefaults` in config.json.
8
+ *
9
+ * The allowlist is the owner's decision: the three `include_*_usage_instructions` prompt-block
10
+ * flags plus `default_verbosity`. Nothing else is accepted, because the
11
+ * neighbouring row fields (tool mode, search, truncation, auto review, identity) carry execution or
12
+ * protocol contracts that an operator default must not be able to undo. Every field is optional;
13
+ * an omitted field keeps today's derivation, and explicit `false` stays `false`.
14
+ */
15
+ export const ROUTED_CATALOG_VERBOSITIES = ["low", "medium", "high"] as const;
16
+
17
+ export const routedCatalogDefaultsSchema = z.object({
18
+ includeSkillsUsageInstructions: z.boolean().optional(),
19
+ includeAppsUsageInstructions: z.boolean().optional(),
20
+ includePluginUsageInstructions: z.boolean().optional(),
21
+ defaultVerbosity: z.enum(ROUTED_CATALOG_VERBOSITIES).optional(),
22
+ }).strict() satisfies z.ZodType<OcxRoutedCatalogDefaultsConfig>;
23
+
24
+ export type RoutedCatalogDefaults = OcxRoutedCatalogDefaultsConfig;
25
+
26
+ export const ROUTED_CATALOG_DEFAULTS_SHAPE_HINT = "accepts only optional boolean includeSkillsUsageInstructions,"
27
+ + " includeAppsUsageInstructions and includePluginUsageInstructions, and an optional"
28
+ + " defaultVerbosity of \"low\", \"medium\" or \"high\"";
29
+
30
+ /** Write-boundary check; also drives the load-time and diagnostics warnings for a degraded block. */
31
+ export function routedCatalogDefaultsConfigError(value: unknown): string | null {
32
+ if (!value || typeof value !== "object" || Array.isArray(value)) return null;
33
+ const block = (value as Record<string, unknown>).routedCatalogDefaults;
34
+ return block === undefined || routedCatalogDefaultsSchema.safeParse(block).success
35
+ ? null : "schema_invalid: routedCatalogDefaults: " + ROUTED_CATALOG_DEFAULTS_SHAPE_HINT;
36
+ }
37
+
38
+ /**
39
+ * Capture the defaults once per catalog build. Catalog derivation receives this frozen snapshot as
40
+ * an input instead of reading mutable config while it derives rows. A malformed synthetic value
41
+ * resolves the same way as a degraded disk block, and an empty block is the same as no block.
42
+ */
43
+ export function resolveRoutedCatalogDefaults(
44
+ config: Pick<OcxConfig, "routedCatalogDefaults">,
45
+ ): Readonly<RoutedCatalogDefaults> | undefined {
46
+ const parsed = routedCatalogDefaultsSchema.safeParse(config.routedCatalogDefaults);
47
+ if (!parsed.success || Object.keys(parsed.data).length === 0) return undefined;
48
+ return Object.freeze({ ...parsed.data });
49
+ }
@@ -0,0 +1,107 @@
1
+ import { join } from "node:path";
2
+ import { resolveTrustedWindowsSystemDirectory } from "../lib/windows-elevation";
3
+
4
+ // NtQueryInformationProcess(ProcessCommandLineInformation) fills the buffer with a
5
+ // UNICODE_STRING header (x64: USHORT Length, USHORT MaximumLength, four bytes of padding,
6
+ // PWSTR Buffer) whose Buffer points at the UTF-16 text later in the same allocation.
7
+ const PROCESS_QUERY_LIMITED_INFORMATION = 0x1000;
8
+ const PROCESS_COMMAND_LINE_INFORMATION = 60;
9
+ const UNICODE_STRING_BYTES = 16;
10
+ // A Windows command line is at most 32767 UTF-16 units, so this always fits on the retry.
11
+ const MAX_BUFFER_BYTES = UNICODE_STRING_BYTES + 65_536;
12
+ const INITIAL_BUFFER_BYTES = 4_096;
13
+ const STATUS_INFO_LENGTH_MISMATCH = 0xc0000004;
14
+ const STATUS_BUFFER_OVERFLOW = 0x80000005;
15
+ const STATUS_BUFFER_TOO_SMALL = 0xc0000023;
16
+
17
+ type NativeReader = (pid: number) => string | undefined;
18
+ let nativeReader: NativeReader | null | undefined;
19
+
20
+ /**
21
+ * Decode a ProcessCommandLineInformation result. `bufferAddress` is the native address of
22
+ * `buffer`; a text pointer or length that leaves the buffer is refused rather than trusted.
23
+ */
24
+ export function decodeProcessCommandLineInformation(
25
+ buffer: Uint8Array,
26
+ bufferAddress: bigint,
27
+ ): string | undefined {
28
+ if (buffer.byteLength < UNICODE_STRING_BYTES) return undefined;
29
+ const view = new DataView(buffer.buffer, buffer.byteOffset, buffer.byteLength);
30
+ const length = view.getUint16(0, true);
31
+ if (length === 0 || length % 2 !== 0) return undefined;
32
+ const offset = view.getBigUint64(8, true) - bufferAddress;
33
+ if (offset < BigInt(UNICODE_STRING_BYTES) || offset + BigInt(length) > BigInt(buffer.byteLength)) {
34
+ return undefined;
35
+ }
36
+ const start = Number(offset);
37
+ const value = new TextDecoder("utf-16le").decode(buffer.subarray(start, start + length)).trim();
38
+ return value || undefined;
39
+ }
40
+
41
+ /**
42
+ * In-process read of another process's command line. Windows PowerShell's
43
+ * Get-CimInstance Win32_Process takes seconds on a busy machine and WMIC is gone from
44
+ * current Windows images, so the spawned probes could not answer inside their bound and
45
+ * a live, unchanged runtime read as unverified. The DLLs load from the GetSystemDirectoryW
46
+ * path so the search order cannot substitute them. Returns null where Bun's FFI cannot run
47
+ * (non-Windows, Windows ARM64), leaving the spawned probes as the only path. bun:ffi is
48
+ * required lazily because every process-state importer loads this module on every platform.
49
+ */
50
+ function loadNativeReader(): NativeReader | null {
51
+ if (nativeReader !== undefined) return nativeReader;
52
+ nativeReader = null;
53
+ if (process.platform !== "win32" || process.arch !== "x64") return null;
54
+ let ptr: typeof import("bun:ffi").ptr;
55
+ let kernel32;
56
+ let ntdll;
57
+ try {
58
+ const ffi = require("bun:ffi") as typeof import("bun:ffi");
59
+ const { dlopen } = ffi;
60
+ ptr = ffi.ptr;
61
+ const systemDirectory = resolveTrustedWindowsSystemDirectory();
62
+ kernel32 = dlopen(join(systemDirectory, "kernel32.dll"), {
63
+ OpenProcess: { args: ["u32", "i32", "u32"], returns: "u64" },
64
+ CloseHandle: { args: ["u64"], returns: "i32" },
65
+ }).symbols;
66
+ ntdll = dlopen(join(systemDirectory, "ntdll.dll"), {
67
+ NtQueryInformationProcess: { args: ["u64", "i32", "ptr", "u32", "ptr"], returns: "i32" },
68
+ }).symbols;
69
+ } catch {
70
+ return null;
71
+ }
72
+ const { OpenProcess, CloseHandle } = kernel32;
73
+ const { NtQueryInformationProcess } = ntdll;
74
+ nativeReader = pid => {
75
+ const handle = OpenProcess(PROCESS_QUERY_LIMITED_INFORMATION, 0, pid);
76
+ if (!handle) return undefined;
77
+ try {
78
+ let size = INITIAL_BUFFER_BYTES;
79
+ for (let attempt = 0; attempt < 2; attempt += 1) {
80
+ const buffer = new Uint8Array(size);
81
+ const returned = new Uint32Array(1);
82
+ const status = NtQueryInformationProcess(
83
+ handle, PROCESS_COMMAND_LINE_INFORMATION, ptr(buffer), size, ptr(returned),
84
+ ) >>> 0;
85
+ if (status === 0) return decodeProcessCommandLineInformation(buffer, BigInt(ptr(buffer)));
86
+ if (status !== STATUS_INFO_LENGTH_MISMATCH && status !== STATUS_BUFFER_OVERFLOW
87
+ && status !== STATUS_BUFFER_TOO_SMALL) return undefined;
88
+ const needed = returned[0]!;
89
+ if (needed <= size || needed > MAX_BUFFER_BYTES) return undefined;
90
+ size = needed;
91
+ }
92
+ return undefined;
93
+ } finally {
94
+ CloseHandle(handle);
95
+ }
96
+ };
97
+ return nativeReader;
98
+ }
99
+
100
+ /** The command line of `pid`, or undefined whenever the native read cannot answer. */
101
+ export function readWindowsProcessCommandLineNative(pid: number): string | undefined {
102
+ try {
103
+ return loadNativeReader()?.(pid);
104
+ } catch {
105
+ return undefined;
106
+ }
107
+ }