@bitkyc08/opencodex 2.93.0 → 2.95.0

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 (582) hide show
  1. package/README.md +27 -8
  2. package/bin/ocx.mjs +215 -63
  3. package/gui/dist/assets/App-8yedBkhm.js +58 -0
  4. package/gui/dist/assets/App-B4j-Txmb.css +1 -0
  5. package/gui/dist/assets/Tray-erSMzxPG.js +1 -0
  6. package/gui/dist/assets/index-CHWwDo9L.css +1 -0
  7. package/gui/dist/assets/index-D7DCm5eQ.js +94 -0
  8. package/gui/dist/assets/quota-summary-BK4VuQNc.js +1 -0
  9. package/gui/dist/index.html +2 -2
  10. package/gui/dist/provider-icons/t3code.svg +4 -0
  11. package/package.json +7 -4
  12. package/src/adapters/anthropic/account-metadata.ts +34 -3
  13. package/src/adapters/anthropic/beta-allowlist.ts +5 -5
  14. package/src/adapters/anthropic/passthrough.ts +5 -2
  15. package/src/adapters/anthropic.ts +27 -7
  16. package/src/adapters/antigravity-refusal.ts +29 -0
  17. package/src/adapters/base.ts +11 -1
  18. package/src/adapters/client-fingerprint.ts +43 -9
  19. package/src/adapters/coding-agent/protocol.ts +19 -9
  20. package/src/adapters/command-code-project-context.ts +3 -3
  21. package/src/adapters/command-code.ts +4 -5
  22. package/src/adapters/cursor/catalog.ts +5 -3
  23. package/src/adapters/cursor/claude-id.ts +30 -19
  24. package/src/adapters/cursor/cursor-errors.ts +5 -2
  25. package/src/adapters/cursor/h2-pool.ts +9 -7
  26. package/src/adapters/cursor/http1-bidi.ts +1 -0
  27. package/src/adapters/cursor/live-models.ts +4 -2
  28. package/src/adapters/cursor.ts +4 -1
  29. package/src/adapters/devin/cloud-direct/chat.ts +18 -2
  30. package/src/adapters/google-antigravity-replay.ts +13 -2
  31. package/src/adapters/google-antigravity-wire.ts +8 -3
  32. package/src/adapters/google-errors.ts +33 -0
  33. package/src/adapters/google-http.ts +41 -16
  34. package/src/adapters/google-wire-compiler.ts +4 -0
  35. package/src/adapters/google.ts +21 -10
  36. package/src/adapters/kiro/adapter.ts +7 -1
  37. package/src/adapters/kiro/stream.ts +19 -13
  38. package/src/adapters/kiro-events.ts +1 -0
  39. package/src/adapters/openai-chat/completed-tool-blocks.ts +65 -0
  40. package/src/adapters/openai-chat/messages.ts +42 -17
  41. package/src/adapters/openai-chat/passthrough.ts +4 -2
  42. package/src/adapters/openai-chat/required-tool-result.ts +3 -3
  43. package/src/adapters/openai-chat/serialized-tool-call-content.ts +5 -0
  44. package/src/adapters/openai-chat/single-system.ts +24 -0
  45. package/src/adapters/openai-chat/wire.ts +9 -0
  46. package/src/adapters/openai-chat.ts +18 -17
  47. package/src/adapters/openai-responses/image-gen.ts +15 -1
  48. package/src/adapters/openai-responses/muse-tool-catalog.ts +87 -0
  49. package/src/adapters/openai-responses/passthrough.ts +53 -41
  50. package/src/adapters/openai-responses/prompt-cache.ts +3 -1
  51. package/src/adapters/openai-responses/request-strips.ts +23 -4
  52. package/src/adapters/openai-responses/tool-output-recovery.ts +21 -8
  53. package/src/adapters/openai-responses/tool-schema.ts +20 -8
  54. package/src/adapters/openai-responses/transport.ts +20 -2
  55. package/src/adapters/openai-responses/usage.ts +34 -0
  56. package/src/adapters/opencode-go-additional-tools.ts +39 -6
  57. package/src/adapters/qoder/adapter.ts +9 -15
  58. package/src/adapters/qoder/image-input.ts +52 -0
  59. package/src/adapters/routed-agent-messages.ts +3 -0
  60. package/src/adapters/unique-tool-call-ids.ts +2 -2
  61. package/src/adapters/xai-web-search.ts +6 -3
  62. package/src/adapters/zed-additional-tools.ts +51 -0
  63. package/src/adapters/zed-diagnostic-usage.ts +22 -0
  64. package/src/adapters/zed-json-tokens.ts +166 -0
  65. package/src/adapters/zed-openai-stream.ts +723 -0
  66. package/src/adapters/zed-tool-arguments.ts +79 -0
  67. package/src/adapters/zed.ts +48 -3
  68. package/src/advisor/consult.ts +39 -5
  69. package/src/advisor/runtime.ts +12 -3
  70. package/src/bridge/errors.ts +22 -1
  71. package/src/bridge/max-output-completion.ts +41 -0
  72. package/src/bridge/response-json.ts +13 -5
  73. package/src/bridge/sse.ts +34 -14
  74. package/src/chat/inbound.ts +13 -2
  75. package/src/chatgpt/app-server-shim/bundle-trust-async.ts +111 -0
  76. package/src/chatgpt/app-server-shim/bundle-trust-policy.ts +88 -0
  77. package/src/chatgpt/app-server-shim/bundle-trust.ts +15 -72
  78. package/src/chatgpt/app-server-shim/launcher.ts +40 -6
  79. package/src/claude/compatibility.ts +5 -1
  80. package/src/claude/desktop-3p.ts +27 -6
  81. package/src/claude/desktop-first-party.ts +16 -5
  82. package/src/claude/desktop-gateway-state.ts +4 -0
  83. package/src/claude/desktop-model-visibility.ts +141 -0
  84. package/src/claude/desktop-remote-store-io.ts +8 -8
  85. package/src/claude/inbound-content-options.ts +11 -1
  86. package/src/claude/inbound-tool-loading.ts +93 -0
  87. package/src/claude/intercept/picker-listener.ts +33 -1
  88. package/src/claude/intercept/proxy-auth.ts +16 -16
  89. package/src/claude/model-info.ts +29 -4
  90. package/src/claude/outbound.ts +33 -13
  91. package/src/cli/account-main.ts +44 -5
  92. package/src/cli/capabilities-base.ts +22 -5
  93. package/src/cli/capabilities-integrations.ts +4 -4
  94. package/src/cli/capabilities-provider-models.ts +7 -0
  95. package/src/cli/chatgpt-command.ts +1 -1
  96. package/src/cli/claude-desktop.ts +139 -98
  97. package/src/cli/codex-cli-update.ts +102 -48
  98. package/src/cli/codex-launch-auth.ts +93 -0
  99. package/src/cli/codex-launch-command.ts +32 -0
  100. package/src/cli/codex-launch-diagnostics.ts +37 -0
  101. package/src/cli/codex-launch-ownership.ts +307 -0
  102. package/src/cli/codex-launch-policy.ts +84 -0
  103. package/src/cli/codex-launcher.ts +322 -0
  104. package/src/cli/codex-shim-autorestore.ts +21 -1
  105. package/src/cli/config-command.ts +9 -4
  106. package/src/cli/config-mutation.ts +13 -0
  107. package/src/cli/dispatch.ts +19 -13
  108. package/src/cli/doctor.ts +5 -5
  109. package/src/cli/effort.ts +19 -14
  110. package/src/cli/ensure-desired-integrations.ts +21 -14
  111. package/src/cli/ensure-desktop-cold-start.ts +41 -10
  112. package/src/cli/export-command.ts +8 -4
  113. package/src/cli/help.ts +3 -1
  114. package/src/cli/index.ts +62 -73
  115. package/src/cli/init.ts +2 -2
  116. package/src/cli/integration-input.ts +12 -0
  117. package/src/cli/integration-plan-dto.ts +2 -0
  118. package/src/cli/integration-preview.ts +6 -3
  119. package/src/cli/integrations.ts +2 -1
  120. package/src/cli/internal-command.ts +29 -2
  121. package/src/cli/link-cleanup.ts +8 -23
  122. package/src/cli/link-enrollment.ts +1 -4
  123. package/src/cli/link.ts +1 -1
  124. package/src/cli/loopback-family.ts +2 -31
  125. package/src/cli/models.ts +62 -49
  126. package/src/cli/provider-cc-switch-import.ts +185 -0
  127. package/src/cli/provider.ts +151 -139
  128. package/src/cli/registry.ts +35 -3
  129. package/src/cli/restart-scope.ts +2 -2
  130. package/src/cli/root.ts +8 -6
  131. package/src/cli/start-owner-fence.ts +22 -3
  132. package/src/cli/status-link.ts +28 -0
  133. package/src/cli/status.ts +15 -0
  134. package/src/cli/stop-approval.ts +15 -1
  135. package/src/cli/stop-restore-guard.ts +48 -0
  136. package/src/cli/stop-restore.ts +117 -36
  137. package/src/cli/system-command.ts +2 -0
  138. package/src/cli/v2.ts +86 -23
  139. package/src/client/lifecycle-lock.ts +1 -1
  140. package/src/client/link-connection.ts +19 -0
  141. package/src/client/link-relay-transport.ts +25 -3
  142. package/src/client/link-tunnel.ts +10 -0
  143. package/src/client/machine-api.ts +2 -2
  144. package/src/client/machine-listener.ts +7 -1
  145. package/src/client/restore-ownership.ts +45 -0
  146. package/src/client/runtime.ts +13 -1
  147. package/src/client/state.ts +1 -1
  148. package/src/clients/client-ids.ts +7 -0
  149. package/src/clients/client-path.ts +13 -5
  150. package/src/clients/config-export/agent-clients.ts +3 -6
  151. package/src/clients/config-export/alias-selectors.ts +85 -0
  152. package/src/clients/config-export/contracts.ts +6 -25
  153. package/src/clients/config-export/dsh.ts +8 -1
  154. package/src/clients/config-export/model-metadata.ts +19 -0
  155. package/src/clients/config-export/model-names.ts +31 -0
  156. package/src/clients/config-export/qoder.ts +3 -11
  157. package/src/clients/config-export/t3code.ts +141 -0
  158. package/src/clients/config-export.ts +65 -18
  159. package/src/clients/gentle-shell-path.ts +3 -3
  160. package/src/codex/account-cooldown-response.ts +18 -0
  161. package/src/codex/account-lifecycle.ts +27 -13
  162. package/src/codex/account-store.ts +32 -6
  163. package/src/codex/app-server-processes.ts +84 -1
  164. package/src/codex/app-server-restart-service.ts +2 -2
  165. package/src/codex/auth-api/login-flow.ts +2 -2
  166. package/src/codex/auth-api/main-account-probe.ts +50 -11
  167. package/src/codex/auth-api/pool-mode-gate.ts +16 -8
  168. package/src/codex/auth-api/pool-quota-probe.ts +2 -2
  169. package/src/codex/auth-context.ts +49 -8
  170. package/src/codex/catalog/antigravity-discovery.ts +59 -0
  171. package/src/codex/catalog/build-entries.ts +12 -13
  172. package/src/codex/catalog/bundled.ts +67 -10
  173. package/src/codex/catalog/derive-entry.ts +2 -0
  174. package/src/codex/catalog/gather-capture.ts +3 -0
  175. package/src/codex/catalog/metadata.ts +10 -10
  176. package/src/codex/catalog/model-hints.ts +36 -4
  177. package/src/codex/catalog/native-omission.ts +28 -0
  178. package/src/codex/catalog/native-priority.ts +63 -0
  179. package/src/codex/catalog/native-template.ts +58 -0
  180. package/src/codex/catalog/parsing.ts +3 -29
  181. package/src/codex/catalog/provider-models.ts +22 -5
  182. package/src/codex/catalog/retained-sync.ts +16 -6
  183. package/src/codex/catalog/write-audit.ts +18 -18
  184. package/src/codex/chatgpt-refresh-failure.ts +2 -2
  185. package/src/codex/cli-install-provenance.ts +103 -74
  186. package/src/codex/cli-installation-identity.ts +1 -1
  187. package/src/codex/cli-installation-limits.ts +7 -0
  188. package/src/codex/cli-update-apply.ts +391 -0
  189. package/src/codex/cli-update-artifacts.ts +259 -0
  190. package/src/codex/cli-update-files.ts +100 -0
  191. package/src/codex/cli-update-inspection-context.ts +49 -0
  192. package/src/codex/cli-update-job-execution.ts +77 -0
  193. package/src/codex/cli-update-job-store-windows.ts +1082 -0
  194. package/src/codex/cli-update-job-worker.ts +385 -0
  195. package/src/codex/cli-update-job.ts +369 -0
  196. package/src/codex/cli-update-lease.ts +71 -0
  197. package/src/codex/cli-update-paths.ts +76 -0
  198. package/src/codex/cli-update-plan.ts +180 -47
  199. package/src/codex/cli-update-recovery.ts +282 -0
  200. package/src/codex/cli-update-selection-gate.ts +305 -0
  201. package/src/codex/cli-update-windows-apply.ts +308 -0
  202. package/src/codex/cli-update-windows-layout.ts +110 -0
  203. package/src/codex/cli-update-windows-observation.ts +91 -0
  204. package/src/codex/cli-update-windows-paths.ts +26 -0
  205. package/src/codex/cli-update-worker-recovery.ts +32 -0
  206. package/src/codex/cli-update-worker.ts +185 -0
  207. package/src/codex/cli-windows-plan-provenance.ts +268 -0
  208. package/src/codex/codex-home-owner.ts +9 -8
  209. package/src/codex/convergence.ts +13 -3
  210. package/src/codex/coordinator-doctor.ts +14 -8
  211. package/src/codex/desktop-app/handoff.ts +1 -1
  212. package/src/codex/desktop-app-restart.ts +32 -3
  213. package/src/codex/exec-boundary.ts +229 -0
  214. package/src/codex/forward-transport-headers.ts +80 -0
  215. package/src/codex/history-job.ts +7 -0
  216. package/src/codex/history-provider.ts +16 -12
  217. package/src/codex/history-worker.ts +20 -1
  218. package/src/codex/inject/bounded-config-reader.ts +14 -13
  219. package/src/codex/inject/restore.ts +57 -25
  220. package/src/codex/internal/history-writer.ts +2 -1
  221. package/src/codex/mac-app-bundle.ts +52 -0
  222. package/src/codex/main-account.ts +167 -29
  223. package/src/codex/native-main-auth-temp.ts +3 -2
  224. package/src/codex/native-main-lock-file.ts +13 -12
  225. package/src/codex/native-main-refresh-mode.ts +18 -3
  226. package/src/codex/native-profile-manager.ts +8 -6
  227. package/src/codex/native-profile-store.ts +9 -0
  228. package/src/codex/native-residue.ts +18 -14
  229. package/src/codex/ocx-compaction-history.ts +3 -2
  230. package/src/codex/orca-auth-source.ts +8 -7
  231. package/src/codex/prompt-text-probe.ts +211 -69
  232. package/src/codex/quota-types.ts +5 -0
  233. package/src/codex/quota.ts +58 -7
  234. package/src/codex/role-auto-assign.ts +50 -26
  235. package/src/codex/role-capability.ts +160 -0
  236. package/src/codex/role-model-history.ts +253 -0
  237. package/src/codex/role-sizing.ts +24 -6
  238. package/src/codex/routing/cooldown-math.ts +3 -2
  239. package/src/codex/runtime.ts +161 -72
  240. package/src/codex/shim-fingerprint.ts +11 -9
  241. package/src/codex/shim-inspect.ts +3 -2
  242. package/src/codex/shim-overlay.ts +22 -3
  243. package/src/codex/shim-restore-lock.ts +11 -14
  244. package/src/codex/shim-state-file.ts +22 -14
  245. package/src/codex/shim-templates.ts +5 -2
  246. package/src/codex/shim-wrapper-write.ts +137 -0
  247. package/src/codex/shim.ts +48 -126
  248. package/src/codex/transition-state.ts +5 -4
  249. package/src/codex/windows-cli-child-native.ts +119 -0
  250. package/src/codex/windows-cli-child-pipe.ts +87 -0
  251. package/src/codex/windows-cli-child.ts +260 -0
  252. package/src/codex/windows-cli-recovery-guardian.ts +89 -0
  253. package/src/codex/windows-cli-recovery.ts +39 -0
  254. package/src/codex/windows-installation-files.ts +52 -6
  255. package/src/codex/windows-npm-execution.ts +25 -0
  256. package/src/combos/failover.ts +127 -9
  257. package/src/combos/index.ts +1 -0
  258. package/src/combos/resolve.ts +60 -22
  259. package/src/config/atomic-write.ts +113 -29
  260. package/src/config/diagnostics.ts +21 -10
  261. package/src/config/initialize.ts +6 -6
  262. package/src/config/live-reconcile.ts +11 -3
  263. package/src/config/load-degrade.ts +2 -0
  264. package/src/config/owner-registry.ts +5 -4
  265. package/src/config/persist-unlocked.ts +34 -8
  266. package/src/config/persisted-mutation.ts +7 -0
  267. package/src/config/process-state.ts +32 -10
  268. package/src/config/removed-opencode-free-backup.ts +99 -0
  269. package/src/config/removed-opencode-free.ts +4 -8
  270. package/src/config/salvage.ts +2 -0
  271. package/src/config/schema/config-schema.ts +44 -1
  272. package/src/config/schema/leaf-validators.ts +22 -0
  273. package/src/config/schema/workflow-budget.ts +43 -0
  274. package/src/config/tracked-runtime-inspection.ts +188 -0
  275. package/src/config.ts +4 -4
  276. package/src/generated/compatibility-version.json +962 -434
  277. package/src/grok/inject.ts +2 -1
  278. package/src/grok/sync.ts +5 -2
  279. package/src/images/loop.ts +14 -5
  280. package/src/integrations/aside-profile-context.ts +1 -1
  281. package/src/integrations/catalog-refresh.ts +1 -1
  282. package/src/integrations/droid-settings.ts +4 -4
  283. package/src/integrations/hermes-profiles.ts +3 -3
  284. package/src/integrations/hermes-refresh.ts +28 -0
  285. package/src/integrations/model-name-guard.ts +31 -0
  286. package/src/integrations/mutation-plan.ts +17 -4
  287. package/src/integrations/ownership.ts +3 -0
  288. package/src/integrations/registry.ts +10 -1
  289. package/src/integrations/state.ts +6 -0
  290. package/src/integrations/writer.ts +64 -59
  291. package/src/lib/abort.ts +8 -4
  292. package/src/lib/bounded-body.ts +7 -1
  293. package/src/lib/bounded-file-read.ts +3 -9
  294. package/src/lib/bun-runtime-preflight.ts +9 -8
  295. package/src/lib/config-ownership.ts +4 -0
  296. package/src/lib/errors.ts +2 -0
  297. package/src/lib/eventstream-decoder.ts +3 -2
  298. package/src/lib/file-identity.ts +15 -0
  299. package/src/lib/http-response-semantics.ts +9 -6
  300. package/src/lib/inbound-body-policy.ts +11 -0
  301. package/src/lib/jsonc.ts +7 -2
  302. package/src/lib/local-chat-completion.ts +8 -6
  303. package/src/lib/local-destinations.ts +32 -3
  304. package/src/lib/local-management-capability.ts +3 -1
  305. package/src/lib/local-upstream.ts +22 -26
  306. package/src/lib/loopback-family.ts +31 -0
  307. package/src/lib/plain-data.ts +7 -5
  308. package/src/lib/process-control.ts +30 -5
  309. package/src/lib/redact-folding.ts +9 -0
  310. package/src/lib/shadow-call.ts +55 -1
  311. package/src/lib/spend-pool-alias-validation.ts +6 -6
  312. package/src/lib/state-store-registrations.ts +2 -0
  313. package/src/lib/test-home-guard.ts +37 -9
  314. package/src/lib/tool-argument-integers.ts +99 -7
  315. package/src/lib/upstream-retry.ts +6 -1
  316. package/src/lib/windows-elevation.ts +34 -11
  317. package/src/lib/windows-owner-acl.ts +272 -32
  318. package/src/lib/windows-secret-acl.ts +328 -44
  319. package/src/lib/windows-service-wrappers.ts +10 -7
  320. package/src/lib/winsw.ts +8 -4
  321. package/src/lib/workflow-budget-config.ts +39 -0
  322. package/src/link/relay-auth.ts +38 -1
  323. package/src/link/remote-platform.ts +11 -23
  324. package/src/link/remote-probe.ts +3 -1
  325. package/src/link/remote-windows.ts +150 -0
  326. package/src/link/ssh-argv.ts +13 -5
  327. package/src/link/store.ts +4 -1
  328. package/src/link/supervisor.ts +9 -0
  329. package/src/local-credentials/generation.ts +242 -0
  330. package/src/local-credentials/inventory.ts +405 -0
  331. package/src/local-credentials/observation-lease.ts +83 -0
  332. package/src/local-credentials/publication-fence.ts +81 -0
  333. package/src/local-credentials/references.ts +36 -0
  334. package/src/local-credentials/runtime-observation.ts +28 -0
  335. package/src/messaging/remote-forward-failure.ts +35 -0
  336. package/src/messaging/remote-ports.ts +27 -5
  337. package/src/messaging/remote-process.ts +30 -4
  338. package/src/messaging/remote-tunnels.ts +80 -15
  339. package/src/oauth/account-auto-pause-policy.ts +11 -0
  340. package/src/oauth/anthropic-account-refusal.ts +1 -0
  341. package/src/oauth/anthropic-rate-limit-policy.ts +26 -2
  342. package/src/oauth/anthropic-routing.ts +34 -44
  343. package/src/oauth/anthropic-session-affinity-store.ts +177 -0
  344. package/src/oauth/antigravity-discovery-diagnostics.ts +65 -0
  345. package/src/oauth/chatgpt.ts +11 -9
  346. package/src/oauth/cursor.ts +8 -2
  347. package/src/oauth/generic-account-failover.ts +33 -2
  348. package/src/oauth/generic-session-affinity.ts +7 -0
  349. package/src/oauth/google-antigravity.ts +49 -12
  350. package/src/oauth/index.ts +3 -0
  351. package/src/oauth/kiro-device-login.ts +87 -30
  352. package/src/oauth/kiro-iam-identity-center.ts +107 -0
  353. package/src/oauth/store.ts +41 -11
  354. package/src/protocols/encoders/adapter-events.ts +7 -4
  355. package/src/protocols/encoders/messages.ts +1 -1
  356. package/src/providers/account-quota-disk.ts +18 -4
  357. package/src/providers/antigravity-account-roster.ts +73 -7
  358. package/src/providers/antigravity-models.ts +8 -4
  359. package/src/providers/api-key-resolve.ts +16 -3
  360. package/src/providers/cc-switch-import-bytes.ts +991 -0
  361. package/src/providers/cc-switch-import-source.ts +1083 -0
  362. package/src/providers/cc-switch-import.ts +942 -0
  363. package/src/providers/claude-cli-identity.ts +2 -0
  364. package/src/providers/codex-capacity.ts +3 -2
  365. package/src/providers/derive.ts +6 -0
  366. package/src/providers/free-directory.ts +10 -2
  367. package/src/providers/key-store.ts +7 -2
  368. package/src/providers/model-discovery-diagnostic.ts +4 -0
  369. package/src/providers/model-discovery.ts +4 -4
  370. package/src/providers/model-rename-fields.ts +2 -0
  371. package/src/providers/model-rename-migration.ts +41 -6
  372. package/src/providers/provider-id-rewrite.ts +3 -0
  373. package/src/providers/quota/antigravity.ts +6 -4
  374. package/src/providers/quota/report-cache.ts +17 -4
  375. package/src/providers/quota/vendor-probes-oauth.ts +0 -1
  376. package/src/providers/quota.ts +2 -2
  377. package/src/providers/reasoning-metadata.ts +31 -15
  378. package/src/providers/registry/entries-core.ts +1 -1
  379. package/src/providers/registry/entries-extended.ts +1 -1
  380. package/src/providers/registry/model-ids.ts +1 -0
  381. package/src/providers/registry/model-seeds.ts +2 -1
  382. package/src/providers/registry/types.ts +3 -1
  383. package/src/providers/resolved-model-policy.ts +2 -2
  384. package/src/providers/routed-config.ts +2 -0
  385. package/src/providers/stale-model-roster-migration.ts +8 -1
  386. package/src/providers/xai-transport.ts +4 -4
  387. package/src/quota-pool/assemble.ts +51 -21
  388. package/src/quota-pool/pooled.ts +162 -0
  389. package/src/remote-control/workspace-codex-runtime.ts +63 -20
  390. package/src/remote-control/workspace-executor.ts +14 -13
  391. package/src/responses/apply-patch-envelope.ts +35 -0
  392. package/src/responses/compaction-history-framing.ts +15 -4
  393. package/src/responses/custom-tool-compat.ts +2 -1
  394. package/src/responses/item-provenance.ts +79 -0
  395. package/src/responses/namespace-tool-compat.ts +21 -3
  396. package/src/responses/turn-membership.ts +111 -0
  397. package/src/router.ts +21 -2
  398. package/src/routing/analytics.ts +3 -5
  399. package/src/routing/fallback-policy.ts +7 -3
  400. package/src/routing/health.ts +5 -3
  401. package/src/routing/history/build-file.ts +6 -0
  402. package/src/routing/history/indexer.ts +158 -31
  403. package/src/routing/history/ingest.ts +1 -1
  404. package/src/routing/history/integrity.ts +208 -0
  405. package/src/routing/history/rebuild-job.ts +20 -6
  406. package/src/routing/history/rebuild-protocol.ts +2 -1
  407. package/src/routing/history/rebuild-worker.ts +18 -0
  408. package/src/routing/history/sqlite-errors.ts +9 -0
  409. package/src/server/admission-model-scope.ts +21 -4
  410. package/src/server/advisor-admission-scope.ts +72 -0
  411. package/src/server/audio-upstream.ts +10 -2
  412. package/src/server/auth-cors.ts +28 -2
  413. package/src/server/bind-host.ts +5 -0
  414. package/src/server/capture-admission-policy.ts +91 -0
  415. package/src/server/chat-completions.ts +47 -6
  416. package/src/server/chat-native.ts +16 -11
  417. package/src/server/claude-messages.ts +99 -3
  418. package/src/server/codex-model-list.ts +47 -0
  419. package/src/server/configured-credentials.ts +5 -0
  420. package/src/server/gui-session.ts +5 -2
  421. package/src/server/inbound-body-admission.ts +21 -13
  422. package/src/server/inbound-body-budget.ts +128 -0
  423. package/src/server/index/link-listener.ts +3 -1
  424. package/src/server/index/link-relay-sessions.ts +9 -2
  425. package/src/server/index/optional-listeners.ts +1 -0
  426. package/src/server/index/serve-options.ts +21 -45
  427. package/src/server/index/websocket-handler.ts +10 -0
  428. package/src/server/index.ts +6 -5
  429. package/src/server/inference/client-encoder-delivery.ts +3 -1
  430. package/src/server/lifecycle.ts +8 -1
  431. package/src/server/management/advisor-routes.ts +26 -9
  432. package/src/server/management/agent-settings-routes.ts +455 -549
  433. package/src/server/management/anthropic-reset-grant-routes.ts +2 -1
  434. package/src/server/management/claude-code-settings-patch.ts +211 -0
  435. package/src/server/management/claude-desktop-config-writers.ts +78 -0
  436. package/src/server/management/codex-agent-role-routes.ts +80 -2
  437. package/src/server/management/codex-cli-update-routes.ts +55 -0
  438. package/src/server/management/codex-prompt-routes.ts +2 -1
  439. package/src/server/management/codex-role-auto-assign.ts +50 -6
  440. package/src/server/management/config-routes.ts +459 -384
  441. package/src/server/management/consent-session.ts +6 -0
  442. package/src/server/management/context.ts +3 -0
  443. package/src/server/management/desktop-compatibility-authorization.ts +12 -0
  444. package/src/server/management/desktop-compatibility-routes.ts +3 -2
  445. package/src/server/management/desktop-compatibility-runtime-routes.ts +2 -1
  446. package/src/server/management/desktop-compatibility-settings-routes.ts +2 -1
  447. package/src/server/management/integration-routes.ts +45 -5
  448. package/src/server/management/link-enrollment.ts +21 -32
  449. package/src/server/management/link-route-state.ts +1 -0
  450. package/src/server/management/link-routes.ts +4 -1
  451. package/src/server/management/model-routes.ts +22 -6
  452. package/src/server/management/model-rows.ts +3 -1
  453. package/src/server/management/native-integration-routes.ts +112 -38
  454. package/src/server/management/oauth-account-routes.ts +28 -11
  455. package/src/server/management/provider-overwrite-carry.ts +21 -0
  456. package/src/server/management/provider-routes.ts +3 -1
  457. package/src/server/management/route-registry.ts +10 -3
  458. package/src/server/management/session-routes.ts +20 -2
  459. package/src/server/management/shadow-call-validation.ts +43 -2
  460. package/src/server/management/shared.ts +17 -1
  461. package/src/server/management/sidebar-routes.ts +2 -1
  462. package/src/server/management/system-restart.ts +47 -7
  463. package/src/server/management/workflow-budget-routes.ts +70 -3
  464. package/src/server/management-api.ts +61 -51
  465. package/src/server/management-auth.ts +11 -3
  466. package/src/server/messages-native-eligibility.ts +6 -5
  467. package/src/server/messages-native-scope.ts +6 -1
  468. package/src/server/messages-native.ts +21 -7
  469. package/src/server/messages-shared.ts +161 -29
  470. package/src/server/persistent-gui-session.ts +155 -0
  471. package/src/server/port-reclaim.ts +29 -5
  472. package/src/server/proxy-liveness.ts +110 -33
  473. package/src/server/request-decompress.ts +5 -1
  474. package/src/server/request-log.ts +30 -2
  475. package/src/server/responses/account-change-state.ts +14 -2
  476. package/src/server/responses/adapter-continuation.ts +5 -4
  477. package/src/server/responses/adapter-delivery.ts +24 -5
  478. package/src/server/responses/adapter-dispatch.ts +39 -45
  479. package/src/server/responses/advisor-plan-slot.ts +7 -0
  480. package/src/server/responses/advisor-slot.ts +77 -48
  481. package/src/server/responses/antigravity-model-denial-recovery.ts +70 -0
  482. package/src/server/responses/antigravity-validation-refusal.ts +6 -0
  483. package/src/server/responses/codex-auth-error.ts +5 -1
  484. package/src/server/responses/combo-required-tool-contract.ts +29 -1
  485. package/src/server/responses/combo-required-tool-fulfillments.ts +58 -0
  486. package/src/server/responses/combo-required-tool-stream.ts +119 -0
  487. package/src/server/responses/combo-stream-preflight.ts +47 -7
  488. package/src/server/responses/compact.ts +18 -8
  489. package/src/server/responses/compaction-recovery.ts +2 -1
  490. package/src/server/responses/core-auth.ts +2 -1
  491. package/src/server/responses/core-codex-account.ts +1 -0
  492. package/src/server/responses/core-combo-failure.ts +13 -6
  493. package/src/server/responses/core-combo-native.ts +6 -5
  494. package/src/server/responses/core-combo.ts +159 -25
  495. package/src/server/responses/core-lifetime.ts +4 -0
  496. package/src/server/responses/core-options.ts +16 -0
  497. package/src/server/responses/core.ts +2 -0
  498. package/src/server/responses/fetch-helpers.ts +5 -1
  499. package/src/server/responses/jev-model-invoke.ts +10 -3
  500. package/src/server/responses/memory-models.ts +3 -2
  501. package/src/server/responses/passthrough-delivery.ts +36 -8
  502. package/src/server/responses/passthrough-dispatch.ts +17 -16
  503. package/src/server/responses/policy-fallback.ts +2 -0
  504. package/src/server/responses/request-prepare.ts +14 -6
  505. package/src/server/responses/request-send-budget.ts +2 -1
  506. package/src/server/responses/request-sidecar-auth.ts +1 -0
  507. package/src/server/responses/request-transport.ts +43 -9
  508. package/src/server/responses/run-turn-execution.ts +15 -3
  509. package/src/server/responses/sidecar-execution.ts +26 -5
  510. package/src/server/responses/turn-membership.ts +30 -0
  511. package/src/server/responses-custom-tool-repair.ts +86 -11
  512. package/src/server/responses-image-gen-repair.ts +1 -1
  513. package/src/server/responses-snapshot-repair.ts +18 -4
  514. package/src/server/responses-undeclared-tool-guard.ts +4 -0
  515. package/src/server/restart-parent-ownership.ts +49 -0
  516. package/src/server/stop-teardown.ts +46 -9
  517. package/src/server/windows-tcp-drop.ts +4 -2
  518. package/src/server/workflow-refusal.ts +2 -1
  519. package/src/service/desktop-recovery-process.ts +341 -0
  520. package/src/service/desktop-recovery.ts +172 -0
  521. package/src/service/state-lock.ts +12 -11
  522. package/src/service/windows-ops.ts +6 -3
  523. package/src/service/windows-scheduler.ts +29 -6
  524. package/src/service-manager-probe.ts +53 -8
  525. package/src/stall-timeout.ts +47 -0
  526. package/src/tray/windows.ts +6 -4
  527. package/src/types/admission-policy.ts +13 -0
  528. package/src/types/config.ts +86 -10
  529. package/src/types/provider.ts +10 -0
  530. package/src/types/request.ts +8 -1
  531. package/src/types.ts +2 -0
  532. package/src/update/async-check.ts +4 -3
  533. package/src/update/bind-probe.ts +2 -2
  534. package/src/update/codex-cli-update-launch-policy.mjs +9 -0
  535. package/src/update/guarded-port-reclaim.ts +14 -0
  536. package/src/update/guarded-runtime-ops.ts +58 -0
  537. package/src/update/guarded-tray-ops.ts +9 -0
  538. package/src/update/index.ts +196 -58
  539. package/src/update/job-pinned-start.ts +53 -0
  540. package/src/update/job-supervised-restart.ts +23 -6
  541. package/src/update/job-update-home.ts +62 -0
  542. package/src/update/job-update-tray.ts +29 -0
  543. package/src/update/job-windows-restart.ts +39 -0
  544. package/src/update/job.ts +199 -193
  545. package/src/update/mutation-guard.d.mts +30 -0
  546. package/src/update/mutation-guard.mjs +103 -0
  547. package/src/update/notify.ts +2 -2
  548. package/src/update/npm-cache-preflight.mjs +4 -4
  549. package/src/update/npm-install.mjs +5 -3
  550. package/src/update/pnpm-read-policy.mjs +3 -2
  551. package/src/update/proxy-liveness-probe.mjs +2 -2
  552. package/src/update/service-home-authority.ts +35 -0
  553. package/src/update/service-home-package-only-protocol.json +1 -0
  554. package/src/update/service-home-policy.d.mts +25 -0
  555. package/src/update/service-home-policy.mjs +112 -0
  556. package/src/update/service-home-probe-entry.ts +9 -0
  557. package/src/update/service-home-probe.d.mts +15 -0
  558. package/src/update/service-home-probe.mjs +79 -0
  559. package/src/update/service-home-protocol.json +1 -0
  560. package/src/update/supervised-recovery.d.mts +2 -2
  561. package/src/update/supervised-recovery.mjs +14 -7
  562. package/src/update/transactional-install.d.mts +3 -1
  563. package/src/update/transactional-install.mjs +29 -19
  564. package/src/update/update-failure-guidance.mjs +1 -1
  565. package/src/update/worker-launch.ts +74 -4
  566. package/src/usage/log.ts +25 -4
  567. package/src/vision/anthropic-describe.ts +2 -1
  568. package/src/vision/index.ts +2 -0
  569. package/src/vision/plan.ts +4 -0
  570. package/src/vision/routed-describe.ts +38 -23
  571. package/src/web-search/anthropic-executor.ts +2 -1
  572. package/src/web-search/anthropic-history.ts +1 -0
  573. package/src/web-search/format-result.ts +3 -2
  574. package/src/web-search/header-deadline.ts +3 -2
  575. package/src/web-search/loop.ts +113 -12
  576. package/src/web-search/parse.ts +201 -40
  577. package/gui/dist/assets/App-CizjBqyk.js +0 -58
  578. package/gui/dist/assets/App-DMps4OLk.css +0 -1
  579. package/gui/dist/assets/Tray-DamiMqcX.js +0 -1
  580. package/gui/dist/assets/index-DQsht3vH.js +0 -94
  581. package/gui/dist/assets/index-DRe8Hhfz.css +0 -1
  582. package/gui/dist/assets/quota-summary-BXu4zE8H.js +0 -1
@@ -0,0 +1,322 @@
1
+ /**
2
+ * `ocx codex [codex args...]` — launch Codex wired to the local proxy's routing,
3
+ * passing through untouched when Codex routing is disabled or foreign.
4
+ *
5
+ * Mirrors `ocx claude` (src/cli/claude.ts) and `ocx opencode` (src/cli/opencode.ts):
6
+ * ensures the proxy is running, then execs the client with stdio inherited. The wiring
7
+ * channel differs again — Codex routing is config-owned (the injected `openai_base_url`
8
+ * and model catalog in `~/.codex/config.toml`), so a launch never rewrites a config
9
+ * file. What the launcher owns instead is the two add-ons `plain codex` lacks:
10
+ *
11
+ * - launch-time autostart: the same detached `ocx start` + health poll that
12
+ * `ocx ensure` gives service- and shim-less setups, attempted before every routed launch;
13
+ * - an honest route verdict before exec: native and foreign-gateway configs are
14
+ * announced (and NOT ensured) instead of silently benefiting or fighting them,
15
+ * reusing the routing classification the shim and doctor share
16
+ * (src/codex/inject/routing-classify.ts).
17
+ *
18
+ * The admission token is re-exported from `~/.opencodex/service-api-token` when the
19
+ * environment does not carry it — the same injection the generated Codex autostart
20
+ * shim performs (src/codex/shim-templates.ts), whose argv fast-path grammar
21
+ * (--help/-h, --version/-V, internal subcommands, global options with values) is
22
+ * mirrored here so both `codex` entry points behave identically for the same argv.
23
+ */
24
+ import { spawn } from "node:child_process";
25
+ import { loadConfig } from "../config";
26
+ import { getCodexRoutingKind, type CodexRoutingKind } from "../codex/inject";
27
+ import { inspectCodexShimBackingForCommand } from "../codex/shim";
28
+ import { validatedCodexExecInvocationAsync, type CodexExecBoundaryAsyncDeps } from "../codex/exec-boundary";
29
+ import { CODEX_GLOBAL_OPTIONS_WITH_VALUE, CODEX_INTERNAL_COMMANDS, CODEX_SHIM_ENSURE_FAILED_DIAGNOSTIC } from "../codex/shim-templates";
30
+ import { withoutSiblingMarker } from "../codex/sibling-start";
31
+ import { withProcessRuntimeProvenance } from "../lib/bun-runtime";
32
+ import { tokenCollidesWithAdmin } from "../lib/admin-secrets";
33
+ import { selfLaunchArgv } from "../lib/self-launch-argv";
34
+ import { loadServiceTokenFromFile, serviceApiTokenFilePath } from "../lib/service-secrets";
35
+ import { findExecutableOnPath } from "../remote-control/workspace-executable";
36
+ import { findLiveProxy, type LiveProxy } from "../server/proxy-liveness";
37
+ import { codexCredentialDestinationIsTrusted, resolveCodexLaunchHome } from "./codex-launch-auth";
38
+ import { codexCommandCanBypass, CODEX_UNVERIFIED_SHIM } from "./codex-launch-command";
39
+ import { codexTokenArgsAreSafe, codexTokenEnvironmentIsSafe } from "./codex-launch-policy";
40
+ import { codexTokenWithheldDiagnostic, type CodexTokenRefusal, type CodexTokenRefusalReporter } from "./codex-launch-diagnostics";
41
+
42
+ export interface CodexLaunchEnv {
43
+ [key: string]: string | undefined;
44
+ }
45
+
46
+ type FastPathReason = "help" | "version" | "internal";
47
+
48
+ /**
49
+ * Mirrors the generated shim wrapper's argv grammar (src/codex/shim-templates.ts):
50
+ * an invocation whose first positional operand is a Codex-internal subcommand, or
51
+ * which only asks for help/version, never needs the proxy. The shell scanners
52
+ * inline these sets — the exported constants here are the single source they are
53
+ * read from — while the option-value rules (`--model x`, `-c k=v`, ...) stay in
54
+ * this scanner in sync with the same templates.
55
+ */
56
+ export function codexFastPathReason(args: readonly string[]): FastPathReason | null {
57
+ let skipNext = false;
58
+ for (const arg of args) {
59
+ if (skipNext) { skipNext = false; continue; }
60
+ if (arg === "--") return null; // the shim's `break`: rest is operands, ensure runs
61
+ const options = CODEX_GLOBAL_OPTIONS_WITH_VALUE;
62
+ if (options.includes(arg)) { skipNext = true; continue; }
63
+ if (arg === "--help" || arg === "-h") return "help";
64
+ if (arg === "--version" || arg === "-V") return "version";
65
+ if (arg.startsWith("-")) continue;
66
+ const value = arg;
67
+ return (CODEX_INTERNAL_COMMANDS.includes(value)) ? "internal" : null;
68
+ }
69
+ return null;
70
+ }
71
+
72
+ export const CODEX_ROUTING_NATIVE_NOTICE =
73
+ "ℹ️ Codex does not route through OpenCodex (no injected routing in ~/.codex/config.toml). Launching `codex` unchanged. Run `ocx ensure` to start the proxy and sync Codex config.";
74
+
75
+ export const CODEX_ROUTING_UNKNOWN_NOTICE =
76
+ "⚠️ Codex routing could not be verified. Ensuring the proxy is up, but the launch may not be redirected; run `ocx doctor` before relying on it.";
77
+
78
+ export const CODEX_ROUTING_CUSTOM_LOCAL_NOTICE =
79
+ "⚠️ Codex routes through a user-owned local gateway. OpenCodex does not own that route; launching `codex` unchanged. Run `ocx doctor` to verify that gateway.";
80
+
81
+ export const CODEX_ROUTING_CUSTOM_REMOTE_NOTICE =
82
+ "⚠️ Codex routes through a remote gateway. OpenCodex does not own that route; launching `codex` unchanged.";
83
+
84
+ export type CodexLaunchPlan =
85
+ | { kind: "routed" }
86
+ | { kind: "passthrough"; notice?: string; ensureProxy: boolean };
87
+
88
+ /**
89
+ * Pure launch decision from the shared routing classification:
90
+ *
91
+ * - `opencodex-local` → ensure + exec (the config this launcher exists for);
92
+ * - `native` / `custom-*` → exec unchanged, no proxy side effects;
93
+ * - `unknown` (unreadable/ambiguous config) → name it out loud and still attempt
94
+ * the ensure, because a routed session that starts without its proxy hits the
95
+ * configured URL's dead port and every request fails.
96
+ */
97
+ export function codexLaunchPlan(routingKind: CodexRoutingKind): CodexLaunchPlan {
98
+ switch (routingKind) {
99
+ case "opencodex-local":
100
+ return { kind: "routed" };
101
+ case "native":
102
+ return { kind: "passthrough", ensureProxy: false, notice: CODEX_ROUTING_NATIVE_NOTICE };
103
+ case "custom-local":
104
+ return { kind: "passthrough", ensureProxy: false, notice: CODEX_ROUTING_CUSTOM_LOCAL_NOTICE };
105
+ case "custom-remote":
106
+ return { kind: "passthrough", ensureProxy: false, notice: CODEX_ROUTING_CUSTOM_REMOTE_NOTICE };
107
+ case "unknown":
108
+ return { kind: "passthrough", ensureProxy: true, notice: CODEX_ROUTING_UNKNOWN_NOTICE };
109
+ }
110
+ }
111
+
112
+ /** Env the detached `ocx start` child inherits (service-owned admission ladder). */
113
+ export function codexProxyStartEnv(base: CodexLaunchEnv = process.env): CodexLaunchEnv {
114
+ const stripped = withoutSiblingMarker(base) as CodexLaunchEnv;
115
+ const withTokenFile = stripped.OPENCODEX_API_AUTH_TOKEN?.trim()
116
+ ? stripped
117
+ : { ...stripped, OCX_API_TOKEN_FILE: serviceApiTokenFilePath() };
118
+ return { ...withTokenFile, OCX_SERVICE: "1" } as CodexLaunchEnv;
119
+ }
120
+
121
+ export type CodexProxyEnsureDeps = {
122
+ findLiveProxy?: typeof findLiveProxy;
123
+ };
124
+
125
+ /**
126
+ * Mirrors ensureProxyForClaude (src/cli/claude.ts) — the same borrowed liveness
127
+ * retry budget (#764), detached `ocx start` on the configured port, 8 s health
128
+ * poll — so all `ocx`-launched clients share one autostart contract.
129
+ */
130
+ export async function ensureProxyForCodex(deps: CodexProxyEnsureDeps = {}): Promise<LiveProxy | null> {
131
+ const probe = deps.findLiveProxy ?? findLiveProxy;
132
+ const live = await probe({ attempts: 3 });
133
+ if (live) return live;
134
+ const cfgPort = loadConfig().port;
135
+ const pinPort = typeof cfgPort === "number" && cfgPort > 0 ? cfgPort : 10100;
136
+ const child = spawn(process.execPath, selfLaunchArgv(["start", "--port", String(pinPort)]), {
137
+ detached: true,
138
+ stdio: "ignore",
139
+ windowsHide: true,
140
+ // An ordinary owner: a stray sibling marker would otherwise mark it before any probe.
141
+ env: withProcessRuntimeProvenance(codexProxyStartEnv(process.env) as NodeJS.ProcessEnv),
142
+ });
143
+ // Without a listener an 'error' (bad argv[1], EMFILE, AV denial) throws synchronously
144
+ // and kills this process; the health poll below already reports the failure properly.
145
+ child.on("error", () => { /* handled by the deadline loop returning null */ });
146
+ child.unref();
147
+ const deadline = Date.now() + 8_000;
148
+ while (Date.now() < deadline) {
149
+ const started = await probe();
150
+ if (started) return started;
151
+ await new Promise(resolve => setTimeout(resolve, 250));
152
+ }
153
+ return null;
154
+ }
155
+
156
+ export type CodexLaunchEnvDeps = {
157
+ routingKind?: CodexRoutingKind;
158
+ args?: readonly string[];
159
+ /** Test seam; production reads the hardened service token file. */
160
+ serviceToken?: (base: CodexLaunchEnv) => string | null;
161
+ credentialDestination?: (home: string, report?: CodexTokenRefusalReporter) => boolean;
162
+ };
163
+
164
+ /** Read the client admission credential from this installation's service-token file. */
165
+ const defaultServiceToken = (base: CodexLaunchEnv): string | null =>
166
+ loadServiceTokenFromFile({ ...base, OCX_API_TOKEN_FILE: serviceApiTokenFilePath() });
167
+
168
+ /**
169
+ * Launch env for a routed exec. The one injection is the shim's own: a missing
170
+ * OPENCODEX_API_AUTH_TOKEN is re-exported from the hardened service token file, so
171
+ * `ocx codex` from a shell without the system-env snapshot authenticates to the
172
+ * loopback proxy like a shimmed launch does. Fresh credentials require explicit
173
+ * argv/env/config allowlists, an exclusive managed provider and protected home/system
174
+ * configuration namespaces. User exports always win.
175
+ */
176
+ export function buildCodexLaunchEnv(
177
+ base: CodexLaunchEnv = process.env,
178
+ deps: CodexLaunchEnvDeps = {},
179
+ ): CodexLaunchEnv {
180
+ const env = { ...base };
181
+ if (deps.routingKind !== undefined && deps.routingKind !== "opencodex-local") return env;
182
+ if (!env.OPENCODEX_API_AUTH_TOKEN?.trim()) {
183
+ const withhold = (reason: CodexTokenRefusal): CodexLaunchEnv => {
184
+ console.error(codexTokenWithheldDiagnostic(reason));
185
+ return env;
186
+ };
187
+ if (!codexTokenArgsAreSafe(deps.args ?? [])) return withhold("args");
188
+ if (!codexTokenEnvironmentIsSafe(env)) return withhold("environment");
189
+ // NO_PROXY parsing and precedence vary across native HTTP/WebSocket transports.
190
+ // Without proving bypass, preserve the user's transport but never load a secret.
191
+ const home = resolveCodexLaunchHome(env);
192
+ if (!home) return withhold("home");
193
+ let refusal: CodexTokenRefusal = "destination";
194
+ const report: CodexTokenRefusalReporter = reason => { refusal = reason; };
195
+ const trusted = deps.credentialDestination
196
+ ? deps.credentialDestination(home, report)
197
+ : codexCredentialDestinationIsTrusted(home, undefined, report);
198
+ if (!trusted) return withhold(refusal);
199
+ const token = (deps.serviceToken ?? defaultServiceToken)(env);
200
+ if (!token) return withhold("credential");
201
+ if (tokenCollidesWithAdmin(token, env)) return withhold("collision");
202
+ // Reqwest's default transport can discover OS proxies even without proxy
203
+ // env. Bind both bypass spellings to the allowed loopback hosts, preserving
204
+ // existing entries and removing conflicting case aliases before handoff.
205
+ const bypass = ["127.0.0.1", "::1"];
206
+ for (const key of Object.keys(env)) if (/^no_proxy$/i.test(key)) {
207
+ if (env[key]) bypass.push(env[key]!);
208
+ delete env[key];
209
+ }
210
+ env.NO_PROXY = env.no_proxy = bypass.join(",");
211
+ env.CODEX_HOME = home;
212
+ env.OPENCODEX_API_AUTH_TOKEN = token;
213
+ }
214
+ return env;
215
+ }
216
+
217
+ const CODEX_INSTALL_HINT = "❌ `codex` CLI not found. Install it first: npm install -g @openai/codex";
218
+ class CodexNotFoundError extends Error {}
219
+
220
+ /**
221
+ * cmd.exe reports command-not-found as exit 9009 (the win32 launcher routes `.cmd`
222
+ * shims through cmd.exe, so ENOENT never fires there). Signal exits are not hints.
223
+ * Same contract as claudeNotFoundHint (devlog 260715_cross_platform_audit/020).
224
+ */
225
+ export function codexNotFoundHint(
226
+ code: number | null,
227
+ signal: NodeJS.Signals | null,
228
+ platform: NodeJS.Platform = process.platform,
229
+ ): string | null {
230
+ return platform === "win32" && code === 9009 && !signal ? CODEX_INSTALL_HINT : null;
231
+ }
232
+
233
+ export type CodexLaunchCommandDeps = {
234
+ findOnPath?: (name: string) => string | null;
235
+ inspectShim?: typeof inspectCodexShimBackingForCommand;
236
+ verifyBypass?: typeof codexCommandCanBypass;
237
+ };
238
+
239
+ export type CodexLaunchCommand = { command: string; env: CodexLaunchEnv };
240
+
241
+ /**
242
+ * The launcher has already made the ensure decision, so the generated autostart shim
243
+ * must not make it again: on a passthrough plan it would start the proxy and load the
244
+ * admission token anyway. When `codex` resolves to a recorded shim wrapper, exec its
245
+ * backing Codex directly. Unknown state requires a separate bypass-content check;
246
+ * obsolete or unverifiable Windows wrappers fail closed before starting any child.
247
+ */
248
+ export function resolveCodexLaunchCommand(
249
+ env: CodexLaunchEnv,
250
+ deps: CodexLaunchCommandDeps = {},
251
+ ): CodexLaunchCommand {
252
+ try {
253
+ const selected = (deps.findOnPath ?? findExecutableOnPath)("codex");
254
+ if (!selected) throw new CodexNotFoundError(CODEX_INSTALL_HINT);
255
+ let shim: ReturnType<typeof inspectCodexShimBackingForCommand>;
256
+ try { shim = (deps.inspectShim ?? inspectCodexShimBackingForCommand)(selected); }
257
+ catch { shim = { status: "unknown", reason: "binding_unavailable" }; }
258
+ if (shim.status === "matched" && shim.selectedRole === "wrapper") return { command: shim.backingPath, env };
259
+ if (shim.status !== "unknown") return { command: selected, env };
260
+ if (!(deps.verifyBypass ?? codexCommandCanBypass)(selected, env)) throw new Error(CODEX_UNVERIFIED_SHIM);
261
+ return { command: selected, env: { ...env, OCX_SHIM_BYPASS: "1" } };
262
+ } catch (error) {
263
+ if (error instanceof CodexNotFoundError) throw error;
264
+ throw new Error(CODEX_UNVERIFIED_SHIM);
265
+ }
266
+ }
267
+
268
+ export interface CodexSpawnDeps extends CodexLaunchCommandDeps {
269
+ execBoundary?: CodexExecBoundaryAsyncDeps;
270
+ spawn?: typeof spawn;
271
+ }
272
+
273
+ /** Validate the final backing command immediately before each launch, including fast paths. */
274
+ export async function spawnCodex(args: readonly string[], env: CodexLaunchEnv, deps: CodexSpawnDeps = {}): Promise<number> {
275
+ let launch: CodexLaunchCommand, inv: Awaited<ReturnType<typeof validatedCodexExecInvocationAsync>>;
276
+ try {
277
+ launch = resolveCodexLaunchCommand(env, deps);
278
+ inv = await validatedCodexExecInvocationAsync(launch.command, args, { ...deps.execBoundary, verifyAnyAppBundle: true, env: launch.env as NodeJS.ProcessEnv });
279
+ } catch (error) {
280
+ // A selected executable that vanished before verification is the same missing CLI
281
+ // the spawn-time ENOENT branch below reports, not a trust refusal.
282
+ const missing = error instanceof CodexNotFoundError || (error as NodeJS.ErrnoException | null)?.code === "ENOENT";
283
+ console.error(missing ? CODEX_INSTALL_HINT : `❌ Cannot launch codex: ${error instanceof Error ? error.message : "executable verification failed"}`);
284
+ return 1;
285
+ }
286
+ return new Promise<number>(resolve => {
287
+ const child = (deps.spawn ?? spawn)(inv.file, inv.args, { stdio: "inherit", env: launch.env as NodeJS.ProcessEnv, ...inv.options });
288
+ child.on("error", (err: NodeJS.ErrnoException) => {
289
+ if (err.code === "ENOENT") {
290
+ console.error(CODEX_INSTALL_HINT);
291
+ } else {
292
+ console.error(`❌ Failed to launch codex: ${err.message}`);
293
+ }
294
+ resolve(1);
295
+ });
296
+ child.on("exit", (code, signal) => {
297
+ const hint = codexNotFoundHint(code, signal);
298
+ if (hint) console.error(hint);
299
+ resolve(signal ? 1 : code ?? 0);
300
+ });
301
+ });
302
+ }
303
+
304
+ /** Apply the argument/routing plan, then hand the original arguments to Codex. */
305
+ export async function cmdCodex(args: string[]): Promise<number> {
306
+ if (codexFastPathReason(args) !== null) return spawnCodex(args, { ...process.env });
307
+ const routingKind = getCodexRoutingKind();
308
+ const plan = codexLaunchPlan(routingKind);
309
+ const notice = plan.kind === "passthrough" ? plan.notice : undefined;
310
+ if (notice) console.error(notice);
311
+ const needsProxy = plan.kind === "routed"
312
+ || (plan.kind === "passthrough" && plan.ensureProxy);
313
+ if (!needsProxy) return spawnCodex(args, { ...process.env });
314
+ const live = await ensureProxyForCodex();
315
+ if (!live) {
316
+ // A failed ensure warns and continues, subject to executable verification.
317
+ // The already-injected config decides
318
+ // what the session does next; `ocx doctor` names the autostart failure.
319
+ console.error(CODEX_SHIM_ENSURE_FAILED_DIAGNOSTIC);
320
+ }
321
+ return spawnCodex(args, buildCodexLaunchEnv(process.env, { routingKind, args }));
322
+ }
@@ -1,4 +1,4 @@
1
- import { autoRestoreCodexShim } from "../codex/shim";
1
+ import { autoRestoreCodexShim, autoRestoreCodexShimAsync } from "../codex/shim";
2
2
  import { codexShimAutoRestoreEnabled, readConfigDiagnostics } from "../config";
3
3
 
4
4
  export interface CodexShimAutoRestoreCliDeps {
@@ -19,6 +19,10 @@ const DEFAULT_DEPS: CodexShimAutoRestoreCliDeps = {
19
19
  export function skipsCodexShimAutoRestore(command: string | undefined, args: string[]): boolean {
20
20
  if (command === "uninstall" || command === "remove") return true;
21
21
  if (command === "status" || command === "doctor") return true;
22
+ // The launcher owns shim handoff after classifying routing, including native fast paths.
23
+ if (command === "codex") return true;
24
+ // Exec admission only observes the selected target; it must never repair a shim first.
25
+ if (command === "internal" && args[1] === "codex-exec-target") return true;
22
26
  // `lab` is read-only inspection; it must not trigger shim side effects.
23
27
  if (command === "lab") return true;
24
28
  // Local messaging owns its helpers; even malformed usage must not repair/start anything.
@@ -73,3 +77,19 @@ export function runCodexShimAutoRestore(deps: CodexShimAutoRestoreCliDeps = DEFA
73
77
  );
74
78
  }
75
79
  }
80
+
81
+ export async function maybeAutoRestoreCodexShimAsync(command: string | undefined, args: string[]): Promise<void> {
82
+ if (!skipsCodexShimAutoRestore(command, args)) await runCodexShimAutoRestoreAsync();
83
+ }
84
+
85
+ export async function runCodexShimAutoRestoreAsync(): Promise<void> {
86
+ try {
87
+ const result = await autoRestoreCodexShimAsync({
88
+ enabled: () => codexShimAutoRestoreEnabled(DEFAULT_DEPS.readConfig().config, DEFAULT_DEPS.env),
89
+ });
90
+ if (result.status === "restored") DEFAULT_DEPS.warn(`⚠️ ${result.message} (automatic repair after Codex update)`);
91
+ else if ((result.status === "deferred" || result.status === "ineligible") && result.message) DEFAULT_DEPS.warn(`⚠️ ${result.message}`);
92
+ } catch (error) {
93
+ DEFAULT_DEPS.warn(`⚠️ Codex shim auto-restore failed; continuing without it: ${error instanceof Error ? error.message : String(error)}. Run 'ocx codex-shim install' after the Codex update finishes.`);
94
+ }
95
+ }
@@ -1,6 +1,8 @@
1
1
  import { readFileSync, writeFileSync } from "node:fs";
2
2
  import { clearCodexAccountPin } from "../codex/account-priority";
3
3
  import { getConfigPath, mutatePersistedConfig, readConfigDiagnostics, sanitizeModelCostsForDisplay, saveConfig, validateConfigCandidate } from "../config";
4
+ import { getConfigDir, withConfigDirHardeningSettled } from "../config/paths";
5
+ import { readCliConfigForMutation } from "./config-mutation";
4
6
  import { VISION_REASONING_EFFORTS, isVisionReasoningEffort } from "../reasoning-effort";
5
7
  import type { OcxConfig } from "../types";
6
8
  import { normalizeVisionReasoningForModel } from "../vision/reasoning";
@@ -260,7 +262,7 @@ export async function handleConfigCommand(argv: string[]): Promise<number> {
260
262
  // `mutatePersistedConfig` reruns this callback against the latest validated disk
261
263
  // state, so the operation is applied to what is actually there at commit time.
262
264
  let savedValue: unknown = null;
263
- const outcome = mutatePersistedConfig(fresh => {
265
+ const outcome = await withConfigDirHardeningSettled(getConfigDir(), () => mutatePersistedConfig(fresh => {
264
266
  // Snapshot BEFORE mutating: comparing after the write compares a value with
265
267
  // itself and would report every no-op as a change, bumping the generation.
266
268
  const before = JSON.stringify(fresh);
@@ -285,9 +287,9 @@ export async function handleConfigCommand(argv: string[]): Promise<number> {
285
287
  }
286
288
  Object.assign(fresh, config);
287
289
  return { changed: JSON.stringify(fresh) !== before, value: undefined };
288
- });
290
+ }));
289
291
  if (outcome.status === "unavailable") {
290
- throw new Error(outcome.reason === "conflict"
292
+ throw new CliUsageError(outcome.reason === "conflict"
291
293
  ? "config changed while applying this update; retry"
292
294
  : `config is ${outcome.reason}`);
293
295
  }
@@ -327,7 +329,10 @@ export async function handleConfigCommand(argv: string[]): Promise<number> {
327
329
  if (!path) throw new CliUsageError("import path is required", USAGE);
328
330
  if (!yes) throw new CliUsageError("import requires --yes", USAGE);
329
331
  rejectArgs(args, USAGE);
330
- saveConfig(validate(loadInput(path)));
332
+ await withConfigDirHardeningSettled(getConfigDir(), () => {
333
+ readCliConfigForMutation();
334
+ saveConfig(validate(loadInput(path)));
335
+ });
331
336
  printData({ ok: true, source: path }, wantsJson, [`Imported config from ${path}. Restart or run ocx sync if needed.`]);
332
337
  return;
333
338
  }
@@ -0,0 +1,13 @@
1
+ import { readConfigDiagnostics } from "../config/diagnostics";
2
+ import type { OcxConfig } from "../types";
3
+ import { CliUsageError } from "./runtime-api";
4
+
5
+ /** Inside admission unless this is a passive preliminary selection read. */
6
+ export function readCliConfigForMutation(options: { passive?: boolean } = {}): OcxConfig {
7
+ const diagnostics = readConfigDiagnostics(options);
8
+ if (diagnostics.source === "fallback" || diagnostics.error) {
9
+ throw new CliUsageError("config.json is invalid or unreadable; run ocx config validate and repair it before retrying. Nothing was saved.");
10
+ }
11
+ // Fresh installs retain the full-config commands' existing default initialization.
12
+ return diagnostics.config;
13
+ }
@@ -10,6 +10,7 @@ import type { ProxyRestartStartOutcome } from "./tray-proxy";
10
10
  * never needs to import the entry module back (no cycle).
11
11
  */
12
12
  import { CLI_COMMANDS } from "./registry";
13
+ import { runCliAction } from "./runtime-api";
13
14
  import { uninstallArgsError, type CliHead } from "./root";
14
15
  import type { ReadyArgs } from "./ready";
15
16
  import type { LivenessIo, LiveProxy } from "../server/proxy-liveness";
@@ -82,9 +83,10 @@ export function selectDefaultGuiUrl(
82
83
  const ingress = config.runtimeRole === "hub" ? config.hub?.managementIngress : undefined;
83
84
  if (ingress?.enabled) return `http://127.0.0.1:${ingress.port}`;
84
85
 
86
+ // Keep literal loopback addresses: standalone pairing admits the configured
87
+ // origin, so replacing 127.0.0.1 with localhost strands its browser flow.
85
88
  const guiHost = probeHostname(live?.hostname ?? config.hostname);
86
- const hostname = guiHost === "127.0.0.1" ? "localhost" : guiHost;
87
- return `http://${hostname}:${live?.port ?? config.port ?? 10100}`;
89
+ return `http://${guiHost}:${live?.port ?? config.port ?? 10100}`;
88
90
  }
89
91
 
90
92
  const commandRunners: Record<string, CommandRunner> = {
@@ -433,8 +435,8 @@ const commandRunners: Record<string, CommandRunner> = {
433
435
  if (expectation) {
434
436
  // The root preflight skipped the shim repair for a pinned sync; the identity held, so
435
437
  // run it now, as an unpinned sync would have.
436
- const { runCodexShimAutoRestore } = await import("./codex-shim-autorestore");
437
- runCodexShimAutoRestore();
438
+ const { runCodexShimAutoRestoreAsync } = await import("./codex-shim-autorestore");
439
+ await runCodexShimAutoRestoreAsync();
438
440
  }
439
441
  // The connection the sync ran under, read inside its lock; the read above may be stale.
440
442
  const link = result.connection.transport === "link";
@@ -546,7 +548,7 @@ const commandRunners: Record<string, CommandRunner> = {
546
548
  },
547
549
  config,
548
550
  port: live.port,
549
- }, ["mcode", "pi", "raycast", "omo", "cline", "commandcode", "droid", "opencode", "kilo", "qoder", "qoder-cn", "workbuddy", "workbuddy-ai"]));
551
+ }, ["mcode", "pi", "raycast", "omo", "cline", "commandcode", "droid", "opencode", "kilo", "qoder", "qoder-cn", "workbuddy", "workbuddy-ai", "hermes", "t3code"]));
550
552
  } catch (error) {
551
553
  console.warn(`Client integrations were not refreshed: ${error instanceof Error ? error.message : String(error)}`);
552
554
  }
@@ -729,10 +731,10 @@ const commandRunners: Record<string, CommandRunner> = {
729
731
  return Number(process.exitCode ?? 0);
730
732
  },
731
733
  "codex-shim": async deps => {
732
- const { codexShimStatus, diagnoseCodexShim, installCodexShim, uninstallCodexShim } = await import("../codex/shim");
734
+ const { codexShimStatus, diagnoseCodexShim, installCodexShimAsync, uninstallCodexShimAsync } = await import("../codex/shim");
733
735
  switch (deps.args[1]) {
734
736
  case "install": {
735
- const r = installCodexShim();
737
+ const r = await installCodexShimAsync();
736
738
  const { healthy, runnable, active, summary } = diagnoseCodexShim();
737
739
  const success = !r.refused && (runnable ?? healthy);
738
740
  const { collectCodexShimReadinessWarnings } = await import("./codex-shim-readiness");
@@ -762,7 +764,7 @@ const commandRunners: Record<string, CommandRunner> = {
762
764
  }
763
765
  case "uninstall":
764
766
  case "remove": {
765
- const r = uninstallCodexShim();
767
+ const r = await uninstallCodexShimAsync();
766
768
  console.log(r.removed ? `✅ ${r.message}` : `⚠️ ${r.message}`);
767
769
  break;
768
770
  }
@@ -856,7 +858,7 @@ const commandRunners: Record<string, CommandRunner> = {
856
858
  },
857
859
  ready: async deps => {
858
860
  // Fail-closed impossible-state guard: readyArgs is populated by the
859
- // preparse block in src/cli/root.ts before maybeAutoRestoreCodexShim, so
861
+ // preparse block in src/cli/root.ts before maybeAutoRestoreCodexShimAsync, so
860
862
  // reaching here without it means dispatch diverged. Refuse with code 64
861
863
  // and perform NO I/O (no discovery/probe). process.exit is `never`,
862
864
  // narrowing below.
@@ -869,12 +871,12 @@ const commandRunners: Record<string, CommandRunner> = {
869
871
  // Reset first, like the service runner below: reading process.exitCode only
870
872
  // reports THIS command's outcome if nothing earlier in the process set it.
871
873
  process.exitCode = 0;
872
- await handleProviderCommand(deps.args.slice(1));
874
+ const code = await runCliAction(() => handleProviderCommand(deps.args.slice(1)));
873
875
  // handleProviderCommand reports failure through process.exitCode, which it sets
874
876
  // from handleProviderRuntimeCommand. Returning a literal 0 here made index.ts
875
877
  // call process.exit(0) and erase it, so `ocx provider quota` against a stopped
876
878
  // proxy printed an error and still exited 0 (#2697).
877
- return Number(process.exitCode ?? 0);
879
+ return code || Number(process.exitCode ?? 0);
878
880
  },
879
881
  account: async deps => {
880
882
  const { cmdAccount } = await import("./account");
@@ -883,10 +885,10 @@ const commandRunners: Record<string, CommandRunner> = {
883
885
  models: async deps => {
884
886
  const { handleModels } = await import("./models");
885
887
  process.exitCode = 0;
886
- await handleModels(deps.args.slice(1));
888
+ const code = await runCliAction(() => handleModels(deps.args.slice(1)));
887
889
  // Same as the provider runner above: handleModels sets process.exitCode from
888
890
  // handleModelsRuntimeCommand, and a literal 0 discarded it (#2697).
889
- return Number(process.exitCode ?? 0);
891
+ return code || Number(process.exitCode ?? 0);
890
892
  },
891
893
  alias: async deps => {
892
894
  const { handleAliasCommand } = await import("./alias");
@@ -1038,6 +1040,10 @@ const commandRunners: Record<string, CommandRunner> = {
1038
1040
  }
1039
1041
  return await cmdClaude(deps.args.slice(1));
1040
1042
  },
1043
+ codex: async deps => {
1044
+ const { cmdCodex } = await import("./codex-launcher");
1045
+ return await cmdCodex(deps.args.slice(1));
1046
+ },
1041
1047
  opencode: async deps => {
1042
1048
  const { cmdOpencode } = await import("./opencode");
1043
1049
  return await cmdOpencode(deps.args.slice(1));
package/src/cli/doctor.ts CHANGED
@@ -70,8 +70,8 @@ import {
70
70
  effortClampAppliesToRuntime,
71
71
  liveRemovedEfforts,
72
72
  loadLastEffortClamp,
73
- persistCodexRuntime,
74
- resolveAndPersistCodexRuntime,
73
+ persistCodexRuntimeAsync,
74
+ resolveAndPersistCodexRuntimeAsync,
75
75
  resolveCodexRuntime,
76
76
  } from "../codex/runtime";
77
77
  import { CODEX_REAUTH_ACTION, collectOAuthHealthEntriesForCli, MASKED_ACCOUNT_FALLBACK, type OAuthHealthEntry } from "../oauth/health";
@@ -1266,8 +1266,8 @@ export async function runDoctor(args: string[] = []): Promise<void> {
1266
1266
  const resolved = resolveCodexRuntime();
1267
1267
  if (!resolved.newerAvailable) {
1268
1268
  console.log("No newer Codex runtime found; keeping current selection.");
1269
- const current = resolveAndPersistCodexRuntime();
1270
- console.log(`Selected: ${displayCodexRuntimePath(current.runtime.command)} (${current.runtime.version ?? "unknown"})`);
1269
+ const current = await resolveAndPersistCodexRuntimeAsync();
1270
+ console.log(`Selected: ${displayCodexRuntimePath(current?.runtime.command ?? "codex")} (${current?.runtime.version ?? "unknown"})`);
1271
1271
  return;
1272
1272
  }
1273
1273
  if (resolved.runtime.source === "environment") {
@@ -1276,7 +1276,7 @@ export async function runDoctor(args: string[] = []): Promise<void> {
1276
1276
  console.log("Then run ocx sync.");
1277
1277
  return;
1278
1278
  }
1279
- persistCodexRuntime({
1279
+ await persistCodexRuntimeAsync({
1280
1280
  command: resolved.newerAvailable.command,
1281
1281
  version: resolved.newerAvailable.version,
1282
1282
  source: "configured",
package/src/cli/effort.ts CHANGED
@@ -1,4 +1,6 @@
1
1
  import { loadConfig, saveConfig } from "../config";
2
+ import { readCliConfigForMutation } from "./config-mutation";
3
+ import { getConfigDir, withConfigDirHardeningSettled } from "../config/paths";
2
4
  import {
3
5
  CODEX_REASONING_LEVELS,
4
6
  configuredReasoningEfforts,
@@ -232,20 +234,23 @@ async function setEffort(
232
234
  }
233
235
 
234
236
  // Offline persistence path: only reached when no live proxy was found before mutation
235
- const config = loadConfig();
236
- if (validatedMain !== undefined) {
237
- if (validatedMain === null) delete config.effortCap;
238
- else config.effortCap = validatedMain;
239
- }
240
- if (validatedSubagent !== undefined) {
241
- if (validatedSubagent === null) delete config.subagentEffortCap;
242
- else config.subagentEffortCap = validatedSubagent;
243
- }
244
- if (validatedInjection !== undefined) {
245
- if (validatedInjection === null) delete config.injectionEffort;
246
- else config.injectionEffort = validatedInjection;
247
- }
248
- saveConfig(config);
237
+ const config = await withConfigDirHardeningSettled(getConfigDir(), () => {
238
+ const config = readCliConfigForMutation();
239
+ if (validatedMain !== undefined) {
240
+ if (validatedMain === null) delete config.effortCap;
241
+ else config.effortCap = validatedMain;
242
+ }
243
+ if (validatedSubagent !== undefined) {
244
+ if (validatedSubagent === null) delete config.subagentEffortCap;
245
+ else config.subagentEffortCap = validatedSubagent;
246
+ }
247
+ if (validatedInjection !== undefined) {
248
+ if (validatedInjection === null) delete config.injectionEffort;
249
+ else config.injectionEffort = validatedInjection;
250
+ }
251
+ saveConfig(config);
252
+ return config;
253
+ });
249
254
 
250
255
  const result = {
251
256
  ok: true,