@bitkyc08/opencodex 2.93.0 → 2.94.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 (435) hide show
  1. package/README.md +27 -8
  2. package/bin/ocx.mjs +215 -63
  3. package/gui/dist/assets/App-DmvwlhQq.js +58 -0
  4. package/gui/dist/assets/Tray-CZatQdoF.js +1 -0
  5. package/gui/dist/assets/index-3EPO_KbX.js +94 -0
  6. package/gui/dist/assets/index-CHWwDo9L.css +1 -0
  7. package/gui/dist/assets/{quota-summary-BXu4zE8H.js → quota-summary-BHvWg9mi.js} +1 -1
  8. package/gui/dist/index.html +2 -2
  9. package/gui/dist/provider-icons/t3code.svg +4 -0
  10. package/package.json +7 -4
  11. package/src/adapters/anthropic/account-metadata.ts +34 -3
  12. package/src/adapters/anthropic/beta-allowlist.ts +5 -5
  13. package/src/adapters/anthropic/passthrough.ts +5 -2
  14. package/src/adapters/anthropic.ts +17 -4
  15. package/src/adapters/antigravity-refusal.ts +29 -0
  16. package/src/adapters/base.ts +11 -1
  17. package/src/adapters/client-fingerprint.ts +43 -9
  18. package/src/adapters/coding-agent/protocol.ts +19 -9
  19. package/src/adapters/command-code.ts +4 -5
  20. package/src/adapters/cursor/catalog.ts +5 -3
  21. package/src/adapters/cursor/claude-id.ts +30 -19
  22. package/src/adapters/cursor/cursor-errors.ts +5 -2
  23. package/src/adapters/cursor/h2-pool.ts +9 -7
  24. package/src/adapters/cursor/http1-bidi.ts +1 -0
  25. package/src/adapters/cursor/live-models.ts +4 -2
  26. package/src/adapters/cursor.ts +4 -1
  27. package/src/adapters/devin/cloud-direct/chat.ts +18 -2
  28. package/src/adapters/google-antigravity-replay.ts +13 -2
  29. package/src/adapters/google-antigravity-wire.ts +8 -3
  30. package/src/adapters/google-errors.ts +33 -0
  31. package/src/adapters/google-http.ts +41 -16
  32. package/src/adapters/google-wire-compiler.ts +4 -0
  33. package/src/adapters/google.ts +21 -10
  34. package/src/adapters/kiro/adapter.ts +3 -0
  35. package/src/adapters/kiro/stream.ts +18 -13
  36. package/src/adapters/openai-chat/completed-tool-blocks.ts +65 -0
  37. package/src/adapters/openai-chat/messages.ts +22 -10
  38. package/src/adapters/openai-chat/required-tool-result.ts +3 -3
  39. package/src/adapters/openai-chat/serialized-tool-call-content.ts +5 -0
  40. package/src/adapters/openai-chat/wire.ts +9 -0
  41. package/src/adapters/openai-chat.ts +18 -17
  42. package/src/adapters/openai-responses/image-gen.ts +15 -1
  43. package/src/adapters/openai-responses/passthrough.ts +11 -34
  44. package/src/adapters/openai-responses/transport.ts +20 -2
  45. package/src/adapters/openai-responses/usage.ts +34 -0
  46. package/src/adapters/qoder/adapter.ts +9 -15
  47. package/src/adapters/qoder/image-input.ts +52 -0
  48. package/src/adapters/unique-tool-call-ids.ts +2 -2
  49. package/src/adapters/zed-additional-tools.ts +51 -0
  50. package/src/adapters/zed-diagnostic-usage.ts +22 -0
  51. package/src/adapters/zed-json-tokens.ts +166 -0
  52. package/src/adapters/zed-openai-stream.ts +723 -0
  53. package/src/adapters/zed-tool-arguments.ts +79 -0
  54. package/src/adapters/zed.ts +53 -3
  55. package/src/advisor/consult.ts +22 -0
  56. package/src/advisor/runtime.ts +3 -0
  57. package/src/bridge/errors.ts +22 -1
  58. package/src/bridge/response-json.ts +4 -1
  59. package/src/bridge/sse.ts +21 -12
  60. package/src/chat/inbound.ts +13 -2
  61. package/src/chatgpt/app-server-shim/bundle-trust-async.ts +111 -0
  62. package/src/chatgpt/app-server-shim/bundle-trust-policy.ts +83 -0
  63. package/src/chatgpt/app-server-shim/bundle-trust.ts +15 -72
  64. package/src/claude/desktop-first-party.ts +16 -5
  65. package/src/claude/desktop-gateway-state.ts +4 -0
  66. package/src/claude/inbound-tool-loading.ts +93 -0
  67. package/src/claude/intercept/picker-listener.ts +33 -1
  68. package/src/claude/model-info.ts +29 -4
  69. package/src/claude/outbound.ts +33 -13
  70. package/src/cli/account-main.ts +43 -5
  71. package/src/cli/capabilities-base.ts +22 -5
  72. package/src/cli/capabilities-integrations.ts +4 -4
  73. package/src/cli/claude-desktop.ts +139 -98
  74. package/src/cli/codex-cli-update.ts +102 -48
  75. package/src/cli/codex-launch-auth.ts +93 -0
  76. package/src/cli/codex-launch-command.ts +32 -0
  77. package/src/cli/codex-launch-diagnostics.ts +37 -0
  78. package/src/cli/codex-launch-ownership.ts +307 -0
  79. package/src/cli/codex-launch-policy.ts +84 -0
  80. package/src/cli/codex-launcher.ts +310 -0
  81. package/src/cli/codex-shim-autorestore.ts +2 -0
  82. package/src/cli/config-command.ts +9 -4
  83. package/src/cli/config-mutation.ts +13 -0
  84. package/src/cli/dispatch.ts +13 -7
  85. package/src/cli/effort.ts +19 -14
  86. package/src/cli/ensure-desired-integrations.ts +21 -14
  87. package/src/cli/ensure-desktop-cold-start.ts +41 -10
  88. package/src/cli/export-command.ts +8 -4
  89. package/src/cli/help.ts +3 -1
  90. package/src/cli/index.ts +58 -64
  91. package/src/cli/integration-input.ts +12 -0
  92. package/src/cli/integration-plan-dto.ts +2 -0
  93. package/src/cli/integration-preview.ts +6 -3
  94. package/src/cli/integrations.ts +2 -1
  95. package/src/cli/link-cleanup.ts +8 -23
  96. package/src/cli/link-enrollment.ts +1 -4
  97. package/src/cli/link.ts +1 -1
  98. package/src/cli/loopback-family.ts +2 -31
  99. package/src/cli/models.ts +62 -49
  100. package/src/cli/provider.ts +146 -139
  101. package/src/cli/registry.ts +34 -3
  102. package/src/cli/root.ts +2 -0
  103. package/src/cli/start-owner-fence.ts +22 -3
  104. package/src/cli/status-link.ts +28 -0
  105. package/src/cli/status.ts +15 -0
  106. package/src/cli/stop-restore-guard.ts +48 -0
  107. package/src/cli/stop-restore.ts +117 -36
  108. package/src/cli/system-command.ts +2 -0
  109. package/src/cli/v2.ts +17 -4
  110. package/src/client/lifecycle-lock.ts +1 -1
  111. package/src/client/link-connection.ts +19 -0
  112. package/src/client/link-relay-transport.ts +25 -3
  113. package/src/client/link-tunnel.ts +10 -0
  114. package/src/client/machine-listener.ts +7 -1
  115. package/src/client/restore-ownership.ts +45 -0
  116. package/src/client/runtime.ts +13 -1
  117. package/src/client/state.ts +1 -1
  118. package/src/clients/client-ids.ts +7 -0
  119. package/src/clients/client-path.ts +13 -5
  120. package/src/clients/config-export/agent-clients.ts +3 -6
  121. package/src/clients/config-export/alias-selectors.ts +85 -0
  122. package/src/clients/config-export/contracts.ts +6 -25
  123. package/src/clients/config-export/dsh.ts +8 -1
  124. package/src/clients/config-export/model-metadata.ts +19 -0
  125. package/src/clients/config-export/model-names.ts +31 -0
  126. package/src/clients/config-export/qoder.ts +3 -11
  127. package/src/clients/config-export/t3code.ts +141 -0
  128. package/src/clients/config-export.ts +51 -15
  129. package/src/clients/gentle-shell-path.ts +3 -3
  130. package/src/codex/account-lifecycle.ts +27 -13
  131. package/src/codex/account-store.ts +32 -6
  132. package/src/codex/app-server-processes.ts +84 -1
  133. package/src/codex/auth-api/main-account-probe.ts +50 -11
  134. package/src/codex/auth-api/pool-mode-gate.ts +16 -8
  135. package/src/codex/auth-context.ts +45 -4
  136. package/src/codex/catalog/antigravity-discovery.ts +59 -0
  137. package/src/codex/catalog/build-entries.ts +12 -13
  138. package/src/codex/catalog/bundled.ts +59 -9
  139. package/src/codex/catalog/derive-entry.ts +2 -0
  140. package/src/codex/catalog/gather-capture.ts +3 -0
  141. package/src/codex/catalog/metadata.ts +6 -5
  142. package/src/codex/catalog/model-hints.ts +36 -4
  143. package/src/codex/catalog/native-priority.ts +63 -0
  144. package/src/codex/catalog/provider-models.ts +20 -4
  145. package/src/codex/catalog/retained-sync.ts +1 -1
  146. package/src/codex/chatgpt-refresh-failure.ts +2 -2
  147. package/src/codex/cli-install-provenance.ts +57 -29
  148. package/src/codex/cli-installation-identity.ts +1 -1
  149. package/src/codex/cli-installation-limits.ts +7 -0
  150. package/src/codex/cli-update-apply.ts +391 -0
  151. package/src/codex/cli-update-artifacts.ts +257 -0
  152. package/src/codex/cli-update-files.ts +100 -0
  153. package/src/codex/cli-update-inspection-context.ts +49 -0
  154. package/src/codex/cli-update-job-execution.ts +77 -0
  155. package/src/codex/cli-update-job-store-windows.ts +1010 -0
  156. package/src/codex/cli-update-job-worker.ts +393 -0
  157. package/src/codex/cli-update-job.ts +369 -0
  158. package/src/codex/cli-update-lease.ts +71 -0
  159. package/src/codex/cli-update-paths.ts +76 -0
  160. package/src/codex/cli-update-plan.ts +180 -47
  161. package/src/codex/cli-update-recovery.ts +236 -0
  162. package/src/codex/cli-update-selection-gate.ts +235 -0
  163. package/src/codex/cli-update-windows-apply.ts +308 -0
  164. package/src/codex/cli-update-windows-layout.ts +110 -0
  165. package/src/codex/cli-update-windows-observation.ts +91 -0
  166. package/src/codex/cli-update-windows-paths.ts +26 -0
  167. package/src/codex/cli-update-worker-recovery.ts +32 -0
  168. package/src/codex/cli-update-worker.ts +185 -0
  169. package/src/codex/cli-windows-plan-provenance.ts +250 -0
  170. package/src/codex/desktop-app-restart.ts +22 -3
  171. package/src/codex/exec-boundary.ts +208 -0
  172. package/src/codex/forward-transport-headers.ts +80 -0
  173. package/src/codex/history-job.ts +7 -0
  174. package/src/codex/history-provider.ts +5 -2
  175. package/src/codex/history-worker.ts +20 -1
  176. package/src/codex/inject/restore.ts +57 -25
  177. package/src/codex/internal/history-writer.ts +2 -1
  178. package/src/codex/mac-app-bundle.ts +52 -0
  179. package/src/codex/main-account.ts +161 -23
  180. package/src/codex/native-main-auth-temp.ts +3 -2
  181. package/src/codex/native-main-refresh-mode.ts +18 -3
  182. package/src/codex/native-profile-manager.ts +8 -6
  183. package/src/codex/native-profile-store.ts +9 -0
  184. package/src/codex/ocx-compaction-history.ts +3 -2
  185. package/src/codex/prompt-text-probe.ts +211 -69
  186. package/src/codex/quota.ts +9 -0
  187. package/src/codex/role-model-history.ts +253 -0
  188. package/src/codex/runtime.ts +120 -71
  189. package/src/codex/shim-overlay.ts +22 -3
  190. package/src/codex/shim-templates.ts +5 -2
  191. package/src/codex/shim-wrapper-write.ts +136 -0
  192. package/src/codex/shim.ts +24 -125
  193. package/src/codex/windows-cli-child-native.ts +119 -0
  194. package/src/codex/windows-cli-child-pipe.ts +87 -0
  195. package/src/codex/windows-cli-child.ts +260 -0
  196. package/src/codex/windows-cli-recovery-guardian.ts +89 -0
  197. package/src/codex/windows-cli-recovery.ts +39 -0
  198. package/src/codex/windows-installation-files.ts +52 -6
  199. package/src/codex/windows-npm-execution.ts +25 -0
  200. package/src/combos/failover.ts +84 -5
  201. package/src/combos/index.ts +1 -0
  202. package/src/combos/resolve.ts +60 -22
  203. package/src/config/atomic-write.ts +75 -22
  204. package/src/config/diagnostics.ts +18 -10
  205. package/src/config/live-reconcile.ts +11 -3
  206. package/src/config/owner-registry.ts +5 -4
  207. package/src/config/persist-unlocked.ts +34 -8
  208. package/src/config/persisted-mutation.ts +7 -0
  209. package/src/config/process-state.ts +9 -5
  210. package/src/config/removed-opencode-free-backup.ts +99 -0
  211. package/src/config/removed-opencode-free.ts +4 -8
  212. package/src/config/salvage.ts +1 -0
  213. package/src/config/schema/config-schema.ts +16 -1
  214. package/src/config/schema/leaf-validators.ts +15 -0
  215. package/src/config.ts +4 -4
  216. package/src/generated/compatibility-version.json +743 -315
  217. package/src/grok/inject.ts +2 -1
  218. package/src/grok/sync.ts +5 -2
  219. package/src/images/loop.ts +14 -5
  220. package/src/integrations/catalog-refresh.ts +1 -1
  221. package/src/integrations/hermes-refresh.ts +28 -0
  222. package/src/integrations/model-name-guard.ts +31 -0
  223. package/src/integrations/mutation-plan.ts +17 -4
  224. package/src/integrations/ownership.ts +3 -0
  225. package/src/integrations/registry.ts +10 -1
  226. package/src/integrations/state.ts +6 -0
  227. package/src/integrations/writer.ts +64 -59
  228. package/src/lib/abort.ts +8 -4
  229. package/src/lib/bounded-body.ts +7 -1
  230. package/src/lib/config-ownership.ts +4 -0
  231. package/src/lib/errors.ts +2 -0
  232. package/src/lib/eventstream-decoder.ts +3 -2
  233. package/src/lib/http-response-semantics.ts +9 -6
  234. package/src/lib/inbound-body-policy.ts +11 -0
  235. package/src/lib/jsonc.ts +7 -2
  236. package/src/lib/local-management-capability.ts +3 -1
  237. package/src/lib/local-upstream.ts +22 -26
  238. package/src/lib/loopback-family.ts +31 -0
  239. package/src/lib/plain-data.ts +7 -5
  240. package/src/lib/process-control.ts +30 -5
  241. package/src/lib/shadow-call.ts +55 -1
  242. package/src/lib/tool-argument-integers.ts +99 -7
  243. package/src/lib/upstream-retry.ts +6 -1
  244. package/src/lib/windows-elevation.ts +34 -11
  245. package/src/lib/windows-owner-acl.ts +272 -32
  246. package/src/lib/windows-secret-acl.ts +310 -44
  247. package/src/lib/windows-service-wrappers.ts +10 -7
  248. package/src/lib/winsw.ts +8 -4
  249. package/src/link/relay-auth.ts +38 -1
  250. package/src/link/remote-platform.ts +11 -23
  251. package/src/link/remote-probe.ts +3 -1
  252. package/src/link/remote-windows.ts +150 -0
  253. package/src/link/ssh-argv.ts +13 -5
  254. package/src/link/store.ts +4 -1
  255. package/src/link/supervisor.ts +9 -0
  256. package/src/local-credentials/generation.ts +238 -0
  257. package/src/local-credentials/inventory.ts +281 -0
  258. package/src/local-credentials/observation-lease.ts +83 -0
  259. package/src/local-credentials/publication-fence.ts +81 -0
  260. package/src/local-credentials/references.ts +36 -0
  261. package/src/local-credentials/runtime-observation.ts +28 -0
  262. package/src/oauth/account-auto-pause-policy.ts +11 -0
  263. package/src/oauth/anthropic-account-refusal.ts +1 -0
  264. package/src/oauth/anthropic-rate-limit-policy.ts +26 -2
  265. package/src/oauth/anthropic-routing.ts +34 -44
  266. package/src/oauth/anthropic-session-affinity-store.ts +177 -0
  267. package/src/oauth/chatgpt.ts +11 -9
  268. package/src/oauth/cursor.ts +8 -2
  269. package/src/oauth/generic-account-failover.ts +33 -2
  270. package/src/oauth/generic-session-affinity.ts +7 -0
  271. package/src/oauth/google-antigravity.ts +29 -5
  272. package/src/oauth/index.ts +1 -0
  273. package/src/oauth/store.ts +32 -4
  274. package/src/protocols/encoders/adapter-events.ts +7 -4
  275. package/src/protocols/encoders/messages.ts +1 -1
  276. package/src/providers/antigravity-account-roster.ts +73 -7
  277. package/src/providers/antigravity-models.ts +8 -4
  278. package/src/providers/api-key-resolve.ts +16 -3
  279. package/src/providers/claude-cli-identity.ts +2 -0
  280. package/src/providers/codex-capacity.ts +3 -2
  281. package/src/providers/free-directory.ts +10 -2
  282. package/src/providers/key-store.ts +7 -2
  283. package/src/providers/provider-id-rewrite.ts +3 -0
  284. package/src/providers/quota/antigravity.ts +6 -4
  285. package/src/providers/quota/vendor-probes-oauth.ts +0 -1
  286. package/src/providers/stale-model-roster-migration.ts +3 -0
  287. package/src/quota-pool/assemble.ts +51 -21
  288. package/src/quota-pool/pooled.ts +162 -0
  289. package/src/remote-control/workspace-codex-runtime.ts +63 -20
  290. package/src/responses/apply-patch-envelope.ts +35 -0
  291. package/src/responses/compaction-history-framing.ts +15 -4
  292. package/src/responses/turn-membership.ts +111 -0
  293. package/src/server/advisor-admission-scope.ts +43 -0
  294. package/src/server/audio-upstream.ts +10 -2
  295. package/src/server/auth-cors.ts +23 -0
  296. package/src/server/bind-host.ts +5 -0
  297. package/src/server/chat-completions.ts +17 -2
  298. package/src/server/chat-native.ts +16 -11
  299. package/src/server/claude-messages.ts +9 -1
  300. package/src/server/codex-model-list.ts +46 -0
  301. package/src/server/gui-session.ts +5 -2
  302. package/src/server/inbound-body-admission.ts +21 -13
  303. package/src/server/inbound-body-budget.ts +128 -0
  304. package/src/server/index/link-listener.ts +3 -1
  305. package/src/server/index/link-relay-sessions.ts +9 -2
  306. package/src/server/index/optional-listeners.ts +1 -0
  307. package/src/server/index/serve-options.ts +9 -43
  308. package/src/server/index/websocket-handler.ts +7 -0
  309. package/src/server/index.ts +6 -5
  310. package/src/server/inference/client-encoder-delivery.ts +3 -1
  311. package/src/server/lifecycle.ts +8 -1
  312. package/src/server/management/advisor-routes.ts +26 -9
  313. package/src/server/management/agent-settings-routes.ts +424 -543
  314. package/src/server/management/anthropic-reset-grant-routes.ts +2 -1
  315. package/src/server/management/claude-code-settings-patch.ts +211 -0
  316. package/src/server/management/claude-desktop-config-writers.ts +78 -0
  317. package/src/server/management/codex-agent-role-routes.ts +79 -2
  318. package/src/server/management/codex-cli-update-routes.ts +55 -0
  319. package/src/server/management/codex-prompt-routes.ts +2 -1
  320. package/src/server/management/config-routes.ts +444 -380
  321. package/src/server/management/consent-session.ts +6 -0
  322. package/src/server/management/desktop-compatibility-authorization.ts +12 -0
  323. package/src/server/management/desktop-compatibility-routes.ts +3 -2
  324. package/src/server/management/desktop-compatibility-runtime-routes.ts +2 -1
  325. package/src/server/management/desktop-compatibility-settings-routes.ts +2 -1
  326. package/src/server/management/integration-routes.ts +45 -5
  327. package/src/server/management/link-enrollment.ts +21 -32
  328. package/src/server/management/link-route-state.ts +1 -0
  329. package/src/server/management/link-routes.ts +4 -1
  330. package/src/server/management/model-routes.ts +22 -6
  331. package/src/server/management/model-rows.ts +3 -1
  332. package/src/server/management/native-integration-routes.ts +90 -38
  333. package/src/server/management/oauth-account-routes.ts +8 -7
  334. package/src/server/management/route-registry.ts +8 -3
  335. package/src/server/management/session-routes.ts +20 -2
  336. package/src/server/management/shadow-call-validation.ts +43 -2
  337. package/src/server/management/sidebar-routes.ts +2 -1
  338. package/src/server/management/system-restart.ts +47 -7
  339. package/src/server/management-api.ts +61 -51
  340. package/src/server/management-auth.ts +11 -3
  341. package/src/server/messages-native.ts +21 -7
  342. package/src/server/messages-shared.ts +110 -18
  343. package/src/server/persistent-gui-session.ts +155 -0
  344. package/src/server/port-reclaim.ts +29 -5
  345. package/src/server/proxy-liveness.ts +110 -33
  346. package/src/server/request-decompress.ts +5 -1
  347. package/src/server/responses/account-change-state.ts +14 -2
  348. package/src/server/responses/adapter-continuation.ts +5 -4
  349. package/src/server/responses/adapter-delivery.ts +20 -5
  350. package/src/server/responses/adapter-dispatch.ts +39 -45
  351. package/src/server/responses/advisor-plan-slot.ts +3 -0
  352. package/src/server/responses/advisor-slot.ts +4 -2
  353. package/src/server/responses/antigravity-model-denial-recovery.ts +70 -0
  354. package/src/server/responses/antigravity-validation-refusal.ts +6 -0
  355. package/src/server/responses/combo-required-tool-contract.ts +2 -1
  356. package/src/server/responses/combo-required-tool-fulfillments.ts +58 -0
  357. package/src/server/responses/combo-required-tool-stream.ts +119 -0
  358. package/src/server/responses/combo-stream-preflight.ts +47 -7
  359. package/src/server/responses/compact.ts +14 -7
  360. package/src/server/responses/compaction-recovery.ts +2 -1
  361. package/src/server/responses/core-auth.ts +2 -1
  362. package/src/server/responses/core-codex-account.ts +1 -0
  363. package/src/server/responses/core-combo-failure.ts +11 -6
  364. package/src/server/responses/core-combo-native.ts +6 -5
  365. package/src/server/responses/core-combo.ts +93 -20
  366. package/src/server/responses/core-options.ts +7 -0
  367. package/src/server/responses/fetch-helpers.ts +5 -1
  368. package/src/server/responses/jev-model-invoke.ts +8 -3
  369. package/src/server/responses/memory-models.ts +3 -2
  370. package/src/server/responses/passthrough-delivery.ts +36 -8
  371. package/src/server/responses/passthrough-dispatch.ts +12 -12
  372. package/src/server/responses/request-prepare.ts +10 -1
  373. package/src/server/responses/request-transport.ts +41 -6
  374. package/src/server/responses/run-turn-execution.ts +11 -3
  375. package/src/server/responses/sidecar-execution.ts +5 -0
  376. package/src/server/responses/turn-membership.ts +30 -0
  377. package/src/server/responses-custom-tool-repair.ts +86 -11
  378. package/src/server/responses-image-gen-repair.ts +1 -1
  379. package/src/server/restart-parent-ownership.ts +49 -0
  380. package/src/server/stop-teardown.ts +46 -9
  381. package/src/server/windows-tcp-drop.ts +4 -2
  382. package/src/service/desktop-recovery-process.ts +341 -0
  383. package/src/service/desktop-recovery.ts +172 -0
  384. package/src/service/windows-ops.ts +6 -3
  385. package/src/service/windows-scheduler.ts +29 -6
  386. package/src/stall-timeout.ts +47 -0
  387. package/src/tray/windows.ts +6 -4
  388. package/src/types/config.ts +61 -10
  389. package/src/types/request.ts +1 -1
  390. package/src/types.ts +1 -0
  391. package/src/update/async-check.ts +4 -3
  392. package/src/update/bind-probe.ts +2 -2
  393. package/src/update/codex-cli-update-launch-policy.mjs +9 -0
  394. package/src/update/guarded-port-reclaim.ts +14 -0
  395. package/src/update/guarded-runtime-ops.ts +58 -0
  396. package/src/update/guarded-tray-ops.ts +9 -0
  397. package/src/update/index.ts +196 -58
  398. package/src/update/job-pinned-start.ts +53 -0
  399. package/src/update/job-supervised-restart.ts +23 -6
  400. package/src/update/job-update-home.ts +62 -0
  401. package/src/update/job-update-tray.ts +29 -0
  402. package/src/update/job-windows-restart.ts +39 -0
  403. package/src/update/job.ts +179 -193
  404. package/src/update/mutation-guard.d.mts +30 -0
  405. package/src/update/mutation-guard.mjs +103 -0
  406. package/src/update/notify.ts +2 -2
  407. package/src/update/npm-cache-preflight.mjs +4 -4
  408. package/src/update/npm-install.mjs +5 -3
  409. package/src/update/pnpm-read-policy.mjs +3 -2
  410. package/src/update/proxy-liveness-probe.mjs +2 -2
  411. package/src/update/service-home-authority.ts +35 -0
  412. package/src/update/service-home-package-only-protocol.json +1 -0
  413. package/src/update/service-home-policy.d.mts +25 -0
  414. package/src/update/service-home-policy.mjs +112 -0
  415. package/src/update/service-home-probe-entry.ts +9 -0
  416. package/src/update/service-home-probe.d.mts +15 -0
  417. package/src/update/service-home-probe.mjs +79 -0
  418. package/src/update/service-home-protocol.json +1 -0
  419. package/src/update/supervised-recovery.d.mts +2 -2
  420. package/src/update/supervised-recovery.mjs +14 -7
  421. package/src/update/transactional-install.d.mts +3 -1
  422. package/src/update/transactional-install.mjs +29 -19
  423. package/src/update/update-failure-guidance.mjs +1 -1
  424. package/src/update/worker-launch.ts +3 -3
  425. package/src/vision/anthropic-describe.ts +2 -1
  426. package/src/web-search/anthropic-executor.ts +2 -1
  427. package/src/web-search/anthropic-history.ts +1 -0
  428. package/src/web-search/format-result.ts +3 -2
  429. package/src/web-search/header-deadline.ts +3 -2
  430. package/src/web-search/loop.ts +10 -4
  431. package/src/web-search/parse.ts +191 -38
  432. package/gui/dist/assets/App-CizjBqyk.js +0 -58
  433. package/gui/dist/assets/Tray-DamiMqcX.js +0 -1
  434. package/gui/dist/assets/index-DQsht3vH.js +0 -94
  435. package/gui/dist/assets/index-DRe8Hhfz.css +0 -1
@@ -622,11 +622,13 @@ export async function runWindowsTrayHost(): Promise<void> {
622
622
  });
623
623
  }
624
624
 
625
- function signalTrayStop(): ReturnType<typeof readHeartbeat> {
625
+ function signalTrayStop(beforeMutation?: () => void): ReturnType<typeof readHeartbeat> {
626
626
  const previous = readHeartbeat();
627
627
  // The stop event name depends only on the current home. Never execute paths
628
628
  // recovered from tray-state.json while attempting cleanup or repair.
629
- execFileSync(windowsPowerShellPath(), windowsTrayProcessArgs(currentEntry(), "Stop"), {
629
+ const file = windowsPowerShellPath(), args = windowsTrayProcessArgs(currentEntry(), "Stop");
630
+ beforeMutation?.();
631
+ execFileSync(file, args, {
630
632
  stdio: "ignore",
631
633
  windowsHide: true,
632
634
  timeout: 15_000,
@@ -743,11 +745,11 @@ export function startWindowsTray(): WindowsTrayStatus {
743
745
  return getWindowsTrayStatus();
744
746
  }
745
747
 
746
- export function stopWindowsTray(): WindowsTrayStatus {
748
+ export function stopWindowsTray(beforeMutation?: () => void): WindowsTrayStatus {
747
749
  assertWindows();
748
750
  let previous = readHeartbeat();
749
751
  if (previous) {
750
- previous = signalTrayStop();
752
+ previous = signalTrayStop(beforeMutation);
751
753
  }
752
754
  if (!waitForTrayExit(previous)) throw new Error("The tray did not exit after the stop signal. Its login registration was preserved.");
753
755
  return getWindowsTrayStatus();
@@ -56,6 +56,14 @@ export interface OcxClaudeCodeConfig {
56
56
  * Default: false; only literal true enables it. Native passthrough is unchanged.
57
57
  */
58
58
  stabilizePromptCache?: boolean;
59
+ /**
60
+ * Opt-in resolved provider/model routes verified to accept Responses additional_tools.
61
+ * A single trailing '*' matches a provider-qualified prefix (for example 'gateway/gpt-*').
62
+ * Replays successful client ToolSearch discoveries in place without growing the initial
63
+ * catalog. Requires metadata.user_id. Absent/empty is off; native passthrough is unchanged.
64
+ * Applies only after routing settles on a direct openai-responses route; combos and policies are skipped.
65
+ */
66
+ appendOnlyToolLoadingModels?: string[];
59
67
  /** Opt-in translated Messages admission; unset keeps legacy behavior. Native passthrough is exempt. */
60
68
  compatibility?: "shadow" | "enforce";
61
69
  /** Kill switch for the /v1/messages inbound (GUI "Claude ON" toggle). Default: enabled. */
@@ -147,15 +155,15 @@ export interface OcxClaudeCodeConfig {
147
155
  * that back on: "Set ENABLE_TOOL_SEARCH=true (or auto / auto:N) if your proxy
148
156
  * forwards tool_reference blocks."
149
157
  *
150
- * Default OFF, because opencodex only forwards them on the NATIVE ANTHROPIC
151
- * PASSTHROUGH route, where the body reaches Anthropic untouched. On a translated
152
- * route the deferral shape is not representable: compatibility.ts marks
153
- * tool_search/tool_reference/deferred_tools unsupported, and toolsToResponses
154
- * drops the tool_search server tool while ignoring defer_loading — deferred tools
155
- * still carry input_schema on the wire, so the routed provider receives every
156
- * schema anyway while Claude Code stops accounting for them and therefore stops
157
- * compacting. Under `claudeCode.compatibility: "enforce"` the same request is
158
- * rejected with 400 instead.
158
+ * Default OFF. Native Anthropic passthrough retains server-side search; the
159
+ * ordinary translated route drops the typed search tool and sends function schemas
160
+ * eagerly. appendOnlyToolLoadingModels is a separate opt-in for verified final
161
+ * Responses destinations and an eager client-executed ToolSearch function: it
162
+ * projects currently declared deferred definitions at successful discovery results.
163
+ * This launcher switch alone enables neither that projection nor server-side search.
164
+ * Compatibility-enforcement admission remains unchanged and can reject unsupported
165
+ * tool_search/tool_reference/deferred_tools requests; no native-search parity or
166
+ * cache-hit guarantee is implied.
159
167
  *
160
168
  * `true` injects "true"; a string is passed through verbatim so Claude Code's own
161
169
  * vocabulary (`auto`, `auto:N`, `force`) stays reachable. `false` and absent
@@ -384,6 +392,28 @@ export interface OcxClientIntegrationsConfig {
384
392
  "claude-desktop"?: boolean;
385
393
  }
386
394
 
395
+ /**
396
+ * Opt-in opencode-side request timeouts written into the generated opencode provider block
397
+ * (both the V1 `options` and V2 `settings` connection objects). Each maps to the matching
398
+ * opencode `settings` field and accepts a number of milliseconds or `false` to disable that wait.
399
+ *
400
+ * Omitted by default: opencode keeps its native header and chunk waits for every upstream reached
401
+ * through the proxy (current V2 defaults the header wait to 5 minutes and the longer chunk wait to
402
+ * 15 minutes; this repo pins no opencode release). The knob exists because the generated
403
+ * `opencodex` provider multiplexes all upstreams under one block and opencode's timeouts are
404
+ * provider-wide, so a user fronting a slow local model (whose prompt prefill behind a non-streaming
405
+ * turn can exceed the header wait before the proxy emits a byte) can raise or disable the wait
406
+ * without touching the safety net for anyone else only by setting it here.
407
+ */
408
+ export interface OcxOpencodeClientExportConfig {
409
+ /** opencode `settings.headerTimeout`: client wait for the proxy's first response header (ms), or false to disable. */
410
+ headerTimeoutMs?: number | false;
411
+ /** opencode `settings.chunkTimeout`: wait between streamed response chunks (ms), or false to disable. */
412
+ chunkTimeoutMs?: number | false;
413
+ /** opencode `settings.timeout`: whole-request bound (ms), or false. opencode applies no default. */
414
+ timeoutMs?: number | false;
415
+ }
416
+
387
417
  export interface OcxConfigRebaseProvenance {
388
418
  version: 1;
389
419
  deletedTopLevelKeys: string[];
@@ -665,6 +695,13 @@ export interface OcxConfig {
665
695
  * one key at a time rather than widening a shared union.
666
696
  */
667
697
  clientIntegrations?: OcxClientIntegrationsConfig;
698
+ /**
699
+ * Opt-in opencode-side request timeouts emitted into the generated opencode provider block.
700
+ * Omitted by default (opencode keeps its native header/chunk waits). Set `headerTimeoutMs` to
701
+ * extend or disable the header wait that otherwise cuts a slow local model's prompt prefill.
702
+ * See {@link OcxOpencodeClientExportConfig}.
703
+ */
704
+ opencodeClientExport?: OcxOpencodeClientExportConfig;
668
705
  /** Aside account-backed profile synchronization; individual overrides survive bulk refresh. */
669
706
  asideProfileSync?: {
670
707
  allProfiles?: boolean;
@@ -1024,7 +1061,14 @@ export interface OcxConfig {
1024
1061
  * response.incomplete. Default 300. Min 1.
1025
1062
  */
1026
1063
  stallTimeoutSec?: number;
1027
- /** Connect timeout (ms) for upstream fetch — covers DNS, TCP, TLS, and response header. Default 200000. */
1064
+ /**
1065
+ * Connect timeout (ms) for upstream fetch — the deadline from dispatch until the upstream
1066
+ * returns its first response header (covers DNS, TCP, TLS, and the header wait; NOT the body
1067
+ * stream that follows, which is governed by stallTimeoutSec). Set 0 (or any non-positive value)
1068
+ * to disable it entirely. When unset, a public upstream defaults to 200000, while a local
1069
+ * upstream (loopback / private / `.local` / `.lan`) disables it — a local model's prompt prefill
1070
+ * can hold the connection silent for minutes on a large prompt before the first header arrives.
1071
+ */
1028
1072
  connectTimeoutMs?: number;
1029
1073
  /** Graceful shutdown drain timeout (ms). Active turns are aborted after this deadline. Default 5000. */
1030
1074
  shutdownTimeoutMs?: number;
@@ -1323,6 +1367,13 @@ export interface OcxConfig {
1323
1367
  * server starts, so raising this takes effect on restart.
1324
1368
  */
1325
1369
  maxInboundBodyBytes?: number;
1370
+ /**
1371
+ * Aggregate admission budget, in bytes, for concurrent raised-limit inbound HTTP bodies.
1372
+ * Omitted or 0 = the built-in 512 MiB budget. `resolveConcurrentInboundBodyLimitBytes()`
1373
+ * clamps to [512 MiB, 2 GiB]; there is no disabled or unbounded mode. Changes take effect
1374
+ * on proxy restart. This accounts for admitted bodies, not total process memory.
1375
+ */
1376
+ maxConcurrentInboundBodyBytes?: number;
1326
1377
  /**
1327
1378
  * Opt-in Anthropic OAuth PROACTIVE routing (#294). Default OFF.
1328
1379
  * Sticky session affinity; new sessions may pick lowest known 5h usage.
@@ -479,7 +479,7 @@ export type AdapterEvent =
479
479
  | { type: "reasoning_raw_delta"; text: string }
480
480
  | { type: "tool_call_start"; id: string; name: string; providerMetadata?: OcxProviderOpaqueToolCallMetadata }
481
481
  | { type: "tool_call_delta"; arguments: string }
482
- | { type: "tool_call_end" }
482
+ | { type: "tool_call_end"; incomplete?: true }
483
483
  /** Internal boundary between a guarded first pass and its one-shot continuation. */
484
484
  | { type: "assistant_boundary" }
485
485
  // Native web-search activity surfaced by the web-search sidecar so Codex renders a "Searched the
package/src/types.ts CHANGED
@@ -79,6 +79,7 @@ export type {
79
79
  OcxCustomModel,
80
80
  OcxApiKeyEntry,
81
81
  OcxClientIntegrationsConfig,
82
+ OcxOpencodeClientExportConfig,
82
83
  OcxConfigRebaseProvenance,
83
84
  OcxHubConfig,
84
85
  OcxRemoteGuiConfig,
@@ -1,4 +1,5 @@
1
- import { spawn, type ChildProcessWithoutNullStreams } from "node:child_process";
1
+ import type { ChildProcessWithoutNullStreams } from "node:child_process";
2
+ import { probeSpawn } from "./mutation-guard.mjs";
2
3
  import { unprivilegedOwnershipMutationEnvironment } from "../service/ownership-mutation-lease.mjs";
3
4
  import { PKG, registrySpawnTarget, type Channel, type Installer } from "./index";
4
5
  import type { PnpmGlobalOwner } from "./pnpm-global-install.mjs";
@@ -40,11 +41,11 @@ export async function pnpmOwner(deps: PnpmOwnerDeps = {}): Promise<PnpmGlobalOwn
40
41
 
41
42
  export interface AsyncLookupDeps {
42
43
  ownerFn: () => Promise<PnpmGlobalOwner | null>;
43
- spawnFn: typeof spawn;
44
+ spawnFn: typeof probeSpawn;
44
45
  deadlineMs?: number;
45
46
  }
46
47
 
47
- const defaultDeps: AsyncLookupDeps = { ownerFn: pnpmOwner, spawnFn: spawn };
48
+ const defaultDeps: AsyncLookupDeps = { ownerFn: pnpmOwner, spawnFn: probeSpawn };
48
49
 
49
50
  export async function latestVersionAsync(
50
51
  channel: Channel,
@@ -1,4 +1,4 @@
1
- import { spawnSync } from "node:child_process";
1
+ import { probeSpawnSync } from "./mutation-guard.mjs";
2
2
 
3
3
  /**
4
4
  * Strict bind script: exit 0 only after listen+close. Any listen error (including
@@ -17,7 +17,7 @@ export function strictBindProbeScript(port: number, hostname: string): string {
17
17
 
18
18
  export function spawnBindProbe(bin: string, script: string): boolean {
19
19
  try {
20
- const r = spawnSync(bin, ["-e", script], {
20
+ const r = probeSpawnSync(bin, ["-e", script], {
21
21
  windowsHide: true,
22
22
  timeout: 4000,
23
23
  stdio: "ignore",
@@ -39,6 +39,15 @@ export function isCodexCliUpdateInspectionArgv(argv) {
39
39
  return args[0] === "system" && args[1] === "codex-cli-update";
40
40
  }
41
41
 
42
+ /** Long-lived published proxy servers need the same proof-bound snapshot so management routes
43
+ * can inspect the Node-selected Codex CLI without accepting a client path or ambient dotenv value.
44
+ * This only controls snapshot inclusion; it does not extend the one-shot inspection restrictions.
45
+ */
46
+ export function carriesCodexCliUpdateInspectionContext(argv) {
47
+ const args = argv.slice(2).filter(value => !value.startsWith("--ocx-internal-launch-proof="));
48
+ return isCodexCliUpdateInspectionArgv(argv) || args[0] === "start";
49
+ }
50
+
42
51
  /** Serialized OCX_NODE_LAUNCH_CONTEXT ceiling; src/cli/launcher-context.ts refuses above it. */
43
52
  export const NODE_LAUNCH_CONTEXT_MAX_CHARS = 64 * 1024;
44
53
 
@@ -0,0 +1,14 @@
1
+ import { reclaimListenPort, type ReclaimListenPortOptions } from "../server/port-reclaim";
2
+
3
+ export type UpdateReclaimOptions = ReclaimListenPortOptions & { mayMutateFn: () => boolean };
4
+
5
+ /** Update callers must supply authority; the shared helper keeps its ordinary defaults. */
6
+ export async function guardedReclaimListenPort(port: number, hostname: string | undefined,
7
+ options: UpdateReclaimOptions): Promise<boolean> {
8
+ // Finish option accessors before capturing the gate. Inherited/omitted gates
9
+ // are absent from this copy and cannot select the shared helper's permissive default.
10
+ const prepared = { ...options };
11
+ if (typeof prepared.mayMutateFn !== "function") return false;
12
+ try { if (prepared.mayMutateFn() !== true) return false; } catch { return false; }
13
+ return reclaimListenPort(port, hostname, prepared);
14
+ }
@@ -0,0 +1,58 @@
1
+ import { isProcessAlive, waitForExit } from "../lib/process-control";
2
+ import type { killProxy } from "../lib/process-control";
3
+ import { atomicWriteFile } from "../config/atomic-write";
4
+ import { removePid, removeRuntimePort } from "../config/process-state";
5
+ import { dropWindowsTcpRowsForLocalPort } from "../server/windows-tcp-drop";
6
+ import { stopWinswService } from "../lib/winsw";
7
+ import { stopWindows } from "../service";
8
+ import { killWindowsSchedulerWrappers } from "../lib/windows-service-wrappers";
9
+ import { guardedRun, guardedKill, guardedExecFileSync, materializeMutationData, UpdateMutationRefusedError, type UpdateMutationAuthorizer } from "./mutation-guard.mjs";
10
+
11
+ export type KillProxy = typeof killProxy;
12
+ function mutationGate<K extends Parameters<UpdateMutationAuthorizer>[0]>(authorize: (kind: K) => boolean, kind: K) {
13
+ return () => { if (authorize(kind) !== true) throw new UpdateMutationRefusedError(); };
14
+ }
15
+ export function guardedKillProxy<K extends "runtime" | "own-child">(authorize: (kind: K) => boolean, kind: K, pid: number, native?: KillProxy) {
16
+ if (native) return guardedRun(authorize, kind, native, [pid]); // trusted external-I/O test seam
17
+ const target = materializeMutationData(pid);
18
+ if (!isProcessAlive(target)) return;
19
+ if (process.platform === "win32") {
20
+ const taskkill = `${process.env.SystemRoot ?? "C:\\Windows"}\\System32\\taskkill.exe`;
21
+ try { guardedExecFileSync(authorize, kind, taskkill, ["/PID", String(target), "/T", "/F"], { stdio: "pipe", windowsHide: true }); }
22
+ catch (error) { if (error instanceof UpdateMutationRefusedError || isProcessAlive(target)) throw error; }
23
+ } else {
24
+ guardedKill(authorize, kind, target, "SIGTERM");
25
+ if (!waitForExit(target, 5000)) guardedKill(authorize, kind, target, "SIGKILL");
26
+ }
27
+ if (!waitForExit(target, 5000)) throw new Error(`process ${target} did not exit`);
28
+ }
29
+ export function guardedPublishJob(authorize: UpdateMutationAuthorizer, kind: "publish" | "package-publish",
30
+ target: string, text: string, native: typeof atomicWriteFile = atomicWriteFile): void {
31
+ const [path, payload] = materializeMutationData([target, text]);
32
+ const validateBeforeRename = () => { if (authorize(kind) !== true) throw new UpdateMutationRefusedError(); };
33
+ validateBeforeRename();
34
+ // The atomic writer carries this gate through temp preparation AND every rename retry.
35
+ native(path, payload, undefined, { validateBeforeRename });
36
+ }
37
+ export function guardedRemovePid(authorize: (kind: "runtime") => boolean, pid?: number) {
38
+ return removePid(materializeMutationData(pid), mutationGate(authorize, "runtime"));
39
+ }
40
+ export function guardedRemoveRuntimePort(authorize: (kind: "runtime") => boolean) {
41
+ return removeRuntimePort(undefined, mutationGate(authorize, "runtime"));
42
+ }
43
+ export function guardedDropWindowsTcp(authorize: (kind: "runtime") => boolean, port: number) {
44
+ const target = materializeMutationData(port);
45
+ return dropWindowsTcpRowsForLocalPort(target, () => {
46
+ if (authorize("runtime") !== true) throw new UpdateMutationRefusedError();
47
+ return true;
48
+ });
49
+ }
50
+ export function guardedStopWinsw(authorize: UpdateMutationAuthorizer) {
51
+ return stopWinswService(mutationGate(authorize, "service"));
52
+ }
53
+ export function guardedStopWindows(authorize: UpdateMutationAuthorizer) {
54
+ return stopWindows(mutationGate(authorize, "service"));
55
+ }
56
+ export function guardedKillWindowsWrappers(authorize: UpdateMutationAuthorizer, paths: Parameters<typeof killWindowsSchedulerWrappers>[0]) {
57
+ return killWindowsSchedulerWrappers(materializeMutationData(paths), mutationGate(authorize, "service"));
58
+ }
@@ -0,0 +1,9 @@
1
+ import { getWindowsTrayStatus, startWindowsTray, stopWindowsTray } from "../tray/windows";
2
+ import { guardedRun, UpdateMutationRefusedError, type UpdateMutationAuthorizer } from "./mutation-guard.mjs";
3
+ export { getWindowsTrayStatus };
4
+ export function guardedStartWindowsTray(authorize: UpdateMutationAuthorizer) {
5
+ return guardedRun(authorize, "own-tray", startWindowsTray, []);
6
+ }
7
+ export function guardedStopWindowsTray(authorize: UpdateMutationAuthorizer) {
8
+ return stopWindowsTray(() => { if (authorize("tray") !== true) throw new UpdateMutationRefusedError(); });
9
+ }