@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
@@ -1,6 +1,6 @@
1
1
  import {
2
2
  closeSync, constants, fstatSync, ftruncateSync, lstatSync, openSync, readSync, writeSync,
3
- type Stats,
3
+ type BigIntStats,
4
4
  } from "node:fs";
5
5
  import { join } from "node:path";
6
6
  import { redactUserPath } from "../../lib/redact";
@@ -40,15 +40,15 @@ function auditLine(event: CatalogWriteAuditEvent): Buffer {
40
40
  })}\n`);
41
41
  }
42
42
 
43
- function regularPrivateFile(stat: Stats): boolean {
43
+ function regularPrivateFile(stat: BigIntStats): boolean {
44
44
  // POSIX bits cannot prove NTFS privacy. Windows requires fresh-file ACL hardening.
45
- return !windowsSecretAclApplies() && stat.isFile() && stat.nlink === 1
46
- && stat.uid === process.getuid?.() && (stat.mode & 0o777) === 0o600;
45
+ return !windowsSecretAclApplies() && stat.isFile() && stat.nlink === 1n
46
+ && stat.uid === BigInt(process.getuid?.() ?? -1) && (stat.mode & 0o777n) === 0o600n;
47
47
  }
48
48
 
49
- function sameFile(left: Stats, right: Stats): boolean {
49
+ function sameFile(left: BigIntStats, right: BigIntStats): boolean {
50
50
  return left.dev === right.dev && left.ino === right.ino && left.size === right.size
51
- && left.mtimeMs === right.mtimeMs && left.ctimeMs === right.ctimeMs;
51
+ && left.mtimeNs === right.mtimeNs && left.ctimeNs === right.ctimeNs;
52
52
  }
53
53
 
54
54
  /** Read at most the tail budget plus one byte to locate a complete first record. */
@@ -116,8 +116,8 @@ export function appendCatalogWriteAudit(
116
116
  if (line.length > CATALOG_AUDIT_MAX_EVENT_BYTES) return "skipped";
117
117
  const path = codexCatalogAuditPath(codexHome);
118
118
  const windows = windowsSecretAclApplies();
119
- let before: Stats | undefined;
120
- try { before = lstatSync(path); }
119
+ let before: BigIntStats | undefined;
120
+ try { before = lstatSync(path, { bigint: true }); }
121
121
  catch (error) {
122
122
  if ((error as NodeJS.ErrnoException).code !== "ENOENT" || !options.create) return "skipped";
123
123
  }
@@ -126,29 +126,29 @@ export function appendCatalogWriteAudit(
126
126
  const flags = constants.O_RDWR | (constants.O_NOFOLLOW ?? 0) | (constants.O_NONBLOCK ?? 0)
127
127
  | (before ? (options.create ? 0 : constants.O_APPEND) : constants.O_CREAT | constants.O_EXCL);
128
128
  fd = openSync(path, flags, 0o600);
129
- let opened = fstatSync(fd);
129
+ let opened = fstatSync(fd, { bigint: true });
130
130
  if (windows) {
131
131
  // Existing files have already been refused: no read-only NTFS privacy verifier exists.
132
- if (!opened.isFile() || opened.nlink !== 1 || opened.size !== 0
133
- || !sameFile(opened, lstatSync(path))) return "skipped";
132
+ if (!opened.isFile() || opened.nlink !== 1n || opened.size !== 0n
133
+ || !sameFile(opened, lstatSync(path, { bigint: true }))) return "skipped";
134
134
  if (!hardenSecretPath(path, { required: true, deadlineMs: AUDIT_ACL_DEADLINE_MS }).ok) return "skipped";
135
- const hardened = fstatSync(fd);
135
+ const hardened = fstatSync(fd, { bigint: true });
136
136
  // ACL changes legitimately move ctime. Retain object identity, then take a fresh baseline.
137
- if (!hardened.isFile() || hardened.nlink !== 1 || hardened.size !== 0
137
+ if (!hardened.isFile() || hardened.nlink !== 1n || hardened.size !== 0n
138
138
  || opened.dev !== hardened.dev || opened.ino !== hardened.ino
139
- || !sameFile(hardened, lstatSync(path))) return "skipped";
139
+ || !sameFile(hardened, lstatSync(path, { bigint: true }))) return "skipped";
140
140
  opened = hardened;
141
141
  } else if (!regularPrivateFile(opened) || (before && !sameFile(before, opened))) return "skipped";
142
- if (!options.create && opened.size + line.length > CATALOG_AUDIT_MAX_BYTES) return "skipped";
143
- const tail = readTail(fd, opened.size);
142
+ if (!options.create && opened.size + BigInt(line.length) > CATALOG_AUDIT_MAX_BYTES) return "skipped";
143
+ const tail = readTail(fd, Number(opened.size));
144
144
  const parsed = completeRecords(tail);
145
- if (!sameFile(opened, fstatSync(fd)) || !sameFile(opened, lstatSync(path))) return "skipped";
145
+ if (!sameFile(opened, fstatSync(fd, { bigint: true })) || !sameFile(opened, lstatSync(path, { bigint: true }))) return "skipped";
146
146
  if (!options.create) {
147
147
  if (!parsed.clean || parsed.count + 1 > CATALOG_AUDIT_KEEP_RECORDS) return "skipped";
148
148
  writeAll(fd, line, null);
149
149
  } else if (opened.size <= CATALOG_AUDIT_MAX_BYTES - line.length
150
150
  && parsed.clean && parsed.count < CATALOG_AUDIT_KEEP_RECORDS) {
151
- writeAll(fd, line, opened.size);
151
+ writeAll(fd, line, Number(opened.size));
152
152
  } else {
153
153
  const retained: Buffer[] = [line];
154
154
  let bytes = line.length;
@@ -1,7 +1,7 @@
1
1
  /** Closed diagnostic vocabulary; provider descriptions and unknown codes never escape. */
2
2
  const REFRESH_DIAGNOSTIC_CODES = [
3
3
  "invalid_grant", "refresh_token_invalidated", "token_invalidated", "refresh_token_reused",
4
- "refresh_token_expired", "invalid_client", "invalid_request", "server_error",
4
+ "refresh_token_expired", "account_deactivated", "deactivated_workspace", "invalid_client", "invalid_request", "server_error",
5
5
  "temporarily_unavailable", "rate_limit_exceeded", "unsupported_grant_type", "invalid_scope",
6
6
  ] as const;
7
7
  export type ChatgptRefreshDiagnosticCode = typeof REFRESH_DIAGNOSTIC_CODES[number];
@@ -32,7 +32,7 @@ export function classifyChatgptRefreshFailure(status: number, body: string): Cha
32
32
  ? exactCode as ChatgptRefreshDiagnosticCode : undefined;
33
33
  let reason: ChatgptRefreshFailure["reason"] = "unknown";
34
34
  if (status === 400 || status === 401 || status === 403) {
35
- if (["invalid_grant", "refresh_token_invalidated", "token_invalidated", "refresh_token_reused"].includes(exactCode ?? "")) {
35
+ if (["invalid_grant", "refresh_token_invalidated", "token_invalidated", "refresh_token_reused", "account_deactivated", "deactivated_workspace"].includes(exactCode ?? "")) {
36
36
  reason = "revoked";
37
37
  } else if (exactCode === "refresh_token_expired") {
38
38
  reason = "expired";
@@ -9,12 +9,15 @@ import {
9
9
  readSync,
10
10
  realpathSync,
11
11
  statSync,
12
- type Stats,
12
+ type BigIntStats,
13
13
  } from "node:fs";
14
+ import { sameFileIdentity, statTimeMs } from "../lib/file-identity";
14
15
  import { posix, win32 } from "node:path";
15
16
  import { getConfigDir } from "../config";
16
17
  import { parseStrictSemver } from "../lib/strict-semver";
17
18
  import { CODEX_CLI_VERSION_MANAGER_ROOT_ENV_SLOTS } from "../update/codex-cli-update-launch-policy.mjs";
19
+ import { MAX_NATIVE_BACKING_BYTES } from "./cli-installation-limits";
20
+ export { MAX_NATIVE_BACKING_BYTES } from "./cli-installation-limits";
18
21
  import { isSpawnableCodexCandidate } from "./exec-invocation";
19
22
  import {
20
23
  codexRuntimeStatePath,
@@ -36,15 +39,6 @@ const MAX_RUNTIME_STATE_BYTES = 256 * 1024;
36
39
  const MAX_MANIFEST_ANCESTORS = 12;
37
40
  /** The published package entrypoint is a few KB; 1 MiB leaves wide headroom. */
38
41
  const MAX_PACKAGE_ENTRYPOINT_BYTES = 1024 * 1024;
39
- /**
40
- * The native companion binary is streamed in HELD_READ_CHUNK_BYTES chunks and
41
- * never buffered whole, so this bound limits read time, not memory. Published
42
- * backings outgrew the former 256 MiB: `@openai/codex@0.163.0-linux-x64` ships a
43
- * 296,865,480-byte binary, in platform packages of 341-430 MB unpacked. 1 GiB
44
- * leaves more than 3x headroom over that binary while staying finite; larger
45
- * files are refused by fstat before any read.
46
- */
47
- export const MAX_NATIVE_BACKING_BYTES = 1024 * 1024 * 1024;
48
42
  const HELD_READ_CHUNK_BYTES = 1024 * 1024;
49
43
 
50
44
  export type CodexCliInstallKind =
@@ -128,6 +122,26 @@ export interface CodexCliInstallReport {
128
122
  readonly evidence: readonly CodexCliInstallEvidence[];
129
123
  }
130
124
 
125
+ /** Process-local evidence; deliberately absent from the public/redacted report. */
126
+ export interface CodexCliMutationEvidence {
127
+ readonly prefix: string;
128
+ readonly launcher: string;
129
+ readonly canonicalLauncher: string;
130
+ readonly packageRoot: string;
131
+ readonly backingRoot: string | null;
132
+ }
133
+ const mutationEvidence = new WeakMap<CodexCliInstallReport, CodexCliMutationEvidence>();
134
+ export function codexCliMutationEvidence(report: CodexCliInstallReport): CodexCliMutationEvidence | null {
135
+ return mutationEvidence.get(report) ?? null;
136
+ }
137
+ /** Final synchronous selector/link observation after a potentially long full-file readback. */
138
+ export function codexCliMutationSelectionMatches(evidence: CodexCliMutationEvidence, deps: CodexCliInstallProvenanceDeps): boolean {
139
+ const selected = observeCodexCliSelectedCommand(deps);
140
+ const path = selected ? resolveCandidateCommandPath(selected, deps) : null;
141
+ return !!path && canonicalize(path, deps) === evidence.canonicalLauncher
142
+ && canonicalize(evidence.launcher, deps) === evidence.canonicalLauncher;
143
+ }
144
+
131
145
  export interface CodexCliInstallProvenanceDeps {
132
146
  readonly env?: NodeJS.ProcessEnv;
133
147
  readonly platform?: NodeJS.Platform;
@@ -414,6 +428,7 @@ export function isAppBundledCodexPath(path: string, platform: NodeJS.Platform):
414
428
  if (platform === "win32") {
415
429
  return normalized.includes("/windowsapps/")
416
430
  || normalized.includes("/microsoft/windowsapps/")
431
+ || normalized.includes("/openai/codex/bin/")
417
432
  || normalized.includes("/packages/openai.codex_");
418
433
  }
419
434
  if (platform === "darwin") return /[.]app\/contents\//i.test(normalized);
@@ -455,13 +470,14 @@ function configuredVersionManagerRoots(
455
470
  const roots: string[] = [];
456
471
  for (const name of CODEX_CLI_VERSION_MANAGER_ROOT_ENV_SLOTS) {
457
472
  const raw = platform === "win32" ? caseInsensitiveEnv(env, name) : env[name];
458
- if (!raw || !isLocalAbsoluteInspectionPath(raw, platform)) continue;
459
- // Windows roots are advisory lexical labels only in this first slice. Do
460
- // not resolve or open them until the handle-bound Windows layer exists.
473
+ if (!raw) continue;
474
+ // Preserve Windows root spellings for lexical exclusions; the managed-plan
475
+ // layer refuses roots that cannot be verified as canonical through handles.
461
476
  if (platform === "win32") {
462
477
  roots.push(normalizePath(win32.normalize(raw), platform));
463
478
  continue;
464
479
  }
480
+ if (!isLocalAbsoluteInspectionPath(raw, platform)) continue;
465
481
  const canonical = isSafeLocalInspectionPath(raw, deps) ? canonicalize(raw, deps) : null;
466
482
  if (canonical) roots.push(normalizePath(canonical, platform));
467
483
  }
@@ -488,10 +504,10 @@ function readBoundedFile(
488
504
  // injected stat/read behavior.
489
505
  const inspectLexical = deps.lstat
490
506
  ?? (deps.stat === undefined && deps.readFile === undefined ? lstatSync : null);
491
- let lexicalBefore: ReturnType<typeof lstatSync> | null = null;
507
+ let lexicalBefore: BigIntStats | null = null;
492
508
  if (inspectLexical) {
493
509
  try {
494
- lexicalBefore = inspectLexical(path);
510
+ lexicalBefore = inspectLexical(path, { bigint: true });
495
511
  if (lexicalBefore.isSymbolicLink() || !lexicalBefore.isFile()) return null;
496
512
  } catch {
497
513
  return null;
@@ -505,9 +521,9 @@ function readBoundedFile(
505
521
  ? fsConstants.O_RDONLY
506
522
  : fsConstants.O_RDONLY | fsConstants.O_NOFOLLOW | fsConstants.O_NONBLOCK;
507
523
  fd = openSync(path, flags);
508
- const before = fstatSync(fd);
524
+ const before = fstatSync(fd, { bigint: true });
509
525
  if (!before.isFile() || before.size > maxBytes) return null;
510
- const bytes = Buffer.allocUnsafe(before.size);
526
+ const bytes = Buffer.allocUnsafe(Number(before.size));
511
527
  let offset = 0;
512
528
  while (offset < bytes.length) {
513
529
  const count = readSync(fd, bytes, offset, bytes.length - offset, offset);
@@ -516,16 +532,16 @@ function readBoundedFile(
516
532
  }
517
533
  const extra = Buffer.allocUnsafe(1);
518
534
  if (readSync(fd, extra, 0, 1, offset) !== 0) return null;
519
- const after = fstatSync(fd);
520
- const lexicalAfter = inspectLexical ? inspectLexical(path) : null;
535
+ const after = fstatSync(fd, { bigint: true });
536
+ const lexicalAfter = inspectLexical ? inspectLexical(path, { bigint: true }) : null;
521
537
  if (lexicalAfter?.isSymbolicLink()) return null;
522
- if (before.dev !== after.dev || before.ino !== after.ino || before.size !== after.size
523
- || before.mtimeMs !== after.mtimeMs || before.ctimeMs !== after.ctimeMs
538
+ if (!sameFileIdentity(before, after) || before.size !== after.size
539
+ || statTimeMs(before.mtimeNs) !== statTimeMs(after.mtimeNs) || statTimeMs(before.ctimeNs) !== statTimeMs(after.ctimeNs)
524
540
  || (lexicalBefore !== null && (lexicalAfter === null || lexicalAfter.isSymbolicLink()
525
- || lexicalBefore.dev !== before.dev || lexicalBefore.ino !== before.ino
526
- || lexicalAfter.dev !== after.dev || lexicalAfter.ino !== after.ino
527
- || lexicalAfter.size !== after.size || lexicalAfter.mtimeMs !== after.mtimeMs
528
- || lexicalAfter.ctimeMs !== after.ctimeMs))) return null;
541
+ || !sameFileIdentity(lexicalBefore, before)
542
+ || !sameFileIdentity(lexicalAfter, after)
543
+ || lexicalAfter.size !== after.size || statTimeMs(lexicalAfter.mtimeNs) !== statTimeMs(after.mtimeNs)
544
+ || statTimeMs(lexicalAfter.ctimeNs) !== statTimeMs(after.ctimeNs)))) return null;
529
545
  return bytes;
530
546
  } catch {
531
547
  return null;
@@ -537,20 +553,19 @@ function readBoundedFile(
537
553
  const stat = deps.stat;
538
554
  const read = deps.readFile;
539
555
  try {
540
- const before = stat(path);
556
+ const before = stat(path, { bigint: true });
541
557
  if (!before.isFile() || before.size > maxBytes) return null;
542
558
  const bytes = read(path);
543
- const after = stat(path);
544
- const lexicalAfter = inspectLexical ? inspectLexical(path) : null;
559
+ const after = stat(path, { bigint: true });
560
+ const lexicalAfter = inspectLexical ? inspectLexical(path, { bigint: true }) : null;
545
561
  if (
546
- bytes.byteLength !== before.size
547
- || before.dev !== after.dev
548
- || before.ino !== after.ino
562
+ BigInt(bytes.byteLength) !== before.size
563
+ || !sameFileIdentity(before, after)
549
564
  || before.size !== after.size
550
- || before.mtimeMs !== after.mtimeMs
565
+ || statTimeMs(before.mtimeNs) !== statTimeMs(after.mtimeNs)
551
566
  || (lexicalBefore !== null && (lexicalAfter === null || lexicalAfter.isSymbolicLink()
552
- || lexicalBefore.dev !== before.dev || lexicalBefore.ino !== before.ino
553
- || lexicalAfter.dev !== after.dev || lexicalAfter.ino !== after.ino))
567
+ || !sameFileIdentity(lexicalBefore, before)
568
+ || !sameFileIdentity(lexicalAfter, after)))
554
569
  ) return null;
555
570
  return bytes;
556
571
  } catch {
@@ -700,6 +715,9 @@ const CODEX_PLATFORM_BACKING: Readonly<Record<string, Readonly<{ triple: string;
700
715
  "win32:x64": { triple: "x86_64-pc-windows-msvc", package: "@openai/codex-win32-x64" },
701
716
  "win32:arm64": { triple: "aarch64-pc-windows-msvc", package: "@openai/codex-win32-arm64" },
702
717
  };
718
+ export function codexCliPlatformBacking(platform: NodeJS.Platform, arch: string) {
719
+ return CODEX_PLATFORM_BACKING[platform + ":" + arch] ?? null;
720
+ }
703
721
 
704
722
  /** Node's Module._nodeModulePaths: every ancestor's node_modules child, closest first. */
705
723
  function nodeModuleDirs(fromDir: string, platform: NodeJS.Platform): string[] {
@@ -782,6 +800,13 @@ interface ObservedContentFile {
782
800
  function fileContentDomain(role: InstallContentFile["role"]): string {
783
801
  return role === "manifest" ? "codex-cli-package-manifest-v1" : "codex-cli-observed-file-v1";
784
802
  }
803
+ export function codexCliContentFileDigest(role: InstallContentFile["role"], bytes: Buffer): string {
804
+ return sha256(fileContentDomain(role), bytes);
805
+ }
806
+ export function codexCliContentSetDigest(platform: NodeJS.Platform, arch: string, triple: string,
807
+ backingKind: "optional-package" | "package-vendor", files: readonly { role: string; digest: string | undefined }[]): string {
808
+ return sha256("codex-cli-install-content-v1", JSON.stringify({ layout: "npm-global", platform, arch, triple, backingKind, files }));
809
+ }
785
810
 
786
811
  /**
787
812
  * Hash every requested file under one observation window. Native POSIX mode
@@ -805,16 +830,16 @@ function observeHeldFileSet(
805
830
  const read = deps.readFile;
806
831
  if (!stat || !read) return null;
807
832
  const results = new Map<string, ObservedContentFile>();
808
- const identities: { before: Stats; req: InstallContentFile }[] = [];
833
+ const identities: { before: BigIntStats; req: InstallContentFile }[] = [];
809
834
  try {
810
835
  for (const req of requests) {
811
- const before = stat(req.path);
836
+ const before = stat(req.path, { bigint: true });
812
837
  if (!before.isFile() || before.size > req.maxBytes) return null;
813
838
  const bytes = read(req.path);
814
- const after = stat(req.path);
815
- if (bytes.byteLength !== before.size
816
- || before.dev !== after.dev || before.ino !== after.ino
817
- || before.size !== after.size || before.mtimeMs !== after.mtimeMs) return null;
839
+ const after = stat(req.path, { bigint: true });
840
+ if (BigInt(bytes.byteLength) !== before.size
841
+ || !sameFileIdentity(before, after)
842
+ || before.size !== after.size || statTimeMs(before.mtimeNs) !== statTimeMs(after.mtimeNs)) return null;
818
843
  identities.push({ before, req });
819
844
  results.set(req.role, {
820
845
  digest: sha256(fileContentDomain(req.role), bytes),
@@ -823,9 +848,9 @@ function observeHeldFileSet(
823
848
  }
824
849
  // A replacement that slipped in after a file's own read still failed.
825
850
  for (const { before, req } of identities) {
826
- const now = stat(req.path);
827
- if (before.dev !== now.dev || before.ino !== now.ino
828
- || before.size !== now.size || before.mtimeMs !== now.mtimeMs) return null;
851
+ const now = stat(req.path, { bigint: true });
852
+ if (!sameFileIdentity(before, now)
853
+ || before.size !== now.size || statTimeMs(before.mtimeNs) !== statTimeMs(now.mtimeNs)) return null;
829
854
  }
830
855
  if (finalize && !finalize()) return null;
831
856
  return results;
@@ -833,7 +858,7 @@ function observeHeldFileSet(
833
858
  return null;
834
859
  }
835
860
  }
836
- const held: { fd: number; req: InstallContentFile; before: Stats }[] = [];
861
+ const held: { fd: number; req: InstallContentFile; before: BigIntStats }[] = [];
837
862
  const openedFds: number[] = [];
838
863
  try {
839
864
  const flags = process.platform === "win32"
@@ -845,7 +870,7 @@ function observeHeldFileSet(
845
870
  // The descriptor joins the close set before any check that can bail, so
846
871
  // an fstat failure or a refused type/size cannot leak it.
847
872
  openedFds.push(fd);
848
- const before = fstatSync(fd);
873
+ const before = fstatSync(fd, { bigint: true });
849
874
  // O_NONBLOCK keeps a FIFO open nonblocking, so the type check must come
850
875
  // first: anything that is not a regular file is refused before a read.
851
876
  if (!before.isFile() || before.size > req.maxBytes) return null;
@@ -856,11 +881,12 @@ function observeHeldFileSet(
856
881
  const hasher = createHash("sha256")
857
882
  .update(fileContentDomain(req.role), "utf8")
858
883
  .update("\0", "utf8");
859
- const bytes = keepBytes(req.role) ? Buffer.allocUnsafe(before.size) : null;
860
- const chunk = Buffer.allocUnsafe(Math.max(1, Math.min(HELD_READ_CHUNK_BYTES, before.size)));
884
+ const size = Number(before.size);
885
+ const bytes = keepBytes(req.role) ? Buffer.allocUnsafe(size) : null;
886
+ const chunk = Buffer.allocUnsafe(Math.max(1, Math.min(HELD_READ_CHUNK_BYTES, size)));
861
887
  let offset = 0;
862
- while (offset < before.size) {
863
- const count = readSync(fd, chunk, 0, Math.min(chunk.length, before.size - offset), offset);
888
+ while (offset < size) {
889
+ const count = readSync(fd, chunk, 0, Math.min(chunk.length, size - offset), offset);
864
890
  if (count <= 0) return null;
865
891
  hasher.update(chunk.subarray(0, count));
866
892
  if (bytes) chunk.copy(bytes, offset, 0, count);
@@ -871,15 +897,15 @@ function observeHeldFileSet(
871
897
  results.set(req.role, { digest: hasher.digest("hex"), bytes });
872
898
  }
873
899
  for (const { fd, req, before } of held) {
874
- const after = fstatSync(fd);
875
- const lexical = lstatSync(req.path);
876
- const followed = statSync(req.path);
877
- if (before.dev !== after.dev || before.ino !== after.ino
878
- || before.size !== after.size || before.mtimeMs !== after.mtimeMs
879
- || before.ctimeMs !== after.ctimeMs
900
+ const after = fstatSync(fd, { bigint: true });
901
+ const lexical = lstatSync(req.path, { bigint: true });
902
+ const followed = statSync(req.path, { bigint: true });
903
+ if (!sameFileIdentity(before, after)
904
+ || before.size !== after.size || statTimeMs(before.mtimeNs) !== statTimeMs(after.mtimeNs)
905
+ || statTimeMs(before.ctimeNs) !== statTimeMs(after.ctimeNs)
880
906
  || lexical.isSymbolicLink() || !lexical.isFile()
881
- || lexical.dev !== before.dev || lexical.ino !== before.ino
882
- || followed.dev !== before.dev || followed.ino !== before.ino) return null;
907
+ || !sameFileIdentity(lexical, before)
908
+ || !sameFileIdentity(followed, before)) return null;
883
909
  }
884
910
  if (finalize && !finalize()) return null;
885
911
  return results;
@@ -907,6 +933,7 @@ function observeInstallContent(
907
933
  env: NodeJS.ProcessEnv,
908
934
  deps: CodexCliInstallProvenanceDeps,
909
935
  selection: { readonly lexical: string; readonly canonical: string },
936
+ observedBacking?: (root: string | null) => void,
910
937
  ): string | null {
911
938
  const arch = deps.arch ?? process.arch;
912
939
  const backing = CODEX_PLATFORM_BACKING[platform + ":" + arch];
@@ -1022,15 +1049,10 @@ function observeInstallContent(
1022
1049
  return null;
1023
1050
  }
1024
1051
  }
1025
- const record = {
1026
- layout: "npm-global" as const,
1027
- platform,
1028
- arch,
1029
- triple: backing.triple,
1030
- backingKind: backingManifestPath ? "optional-package" as const : "package-vendor" as const,
1031
- files: requests.map(req => ({ role: req.role, digest: observed.get(req.role)?.digest })),
1032
- };
1033
- return sha256("codex-cli-install-content-v1", JSON.stringify(record));
1052
+ observedBacking?.(backingPackageDir);
1053
+ return codexCliContentSetDigest(platform, arch, backing.triple,
1054
+ backingManifestPath ? "optional-package" : "package-vendor",
1055
+ requests.map(req => ({ role: req.role, digest: observed.get(req.role)?.digest })));
1034
1056
  }
1035
1057
 
1036
1058
  /** Inspect ownership of one configured Codex CLI candidate, without mutation. */
@@ -1053,11 +1075,9 @@ export async function inspectCodexCliInstall(
1053
1075
 
1054
1076
  const env = deps.env ?? process.env;
1055
1077
  if (platform === "win32") {
1056
- // This first slice never opens a candidate-controlled Windows pathname.
1057
- // A boolean precheck followed by lstat/realpath/open is raceable when an
1058
- // ancestor can be replaced with a remote reparse point. Preserve only
1059
- // lexical, report-only classifications until a handle-bound inspector is
1060
- // introduced; every result remains unattested and unmanaged.
1078
+ // Lexical exclusions precede the restricted handle-bound plan predicate.
1079
+ // Other Windows layouts remain observation-only; pathname prechecks alone
1080
+ // cannot prove a writable ancestor stayed local and non-reparse.
1061
1081
  const lexicalCandidatePath = win32.isAbsolute(candidate.command)
1062
1082
  && isLocalAbsoluteInspectionPath(candidate.command, platform)
1063
1083
  ? win32.normalize(candidate.command)
@@ -1090,9 +1110,12 @@ export async function inspectCodexCliInstall(
1090
1110
  evidence: Object.freeze([appBundle ? "app_bundle_path" : "version_manager_path"]),
1091
1111
  });
1092
1112
  }
1093
- return unknownWindowsReport("windows_inspection_deferred", candidate, {
1113
+ const deferred = unknownWindowsReport("windows_inspection_deferred", candidate, {
1094
1114
  location: publicExecutableLocation(lexicalCandidatePath, platform),
1095
1115
  });
1116
+ return (await import("./cli-windows-plan-provenance")).inspectWindowsCodexCliPlanInstall(deps, deferred,
1117
+ path => isAppBundledCodexPath(path, platform) || isCodexCliUpdateVersionManagerPath(path, platform)
1118
+ || isWithinConfiguredVersionManagerRoot(path, managerRoots, platform), managerRoots);
1096
1119
  }
1097
1120
  const configDir = deps.configDir ?? getConfigDir();
1098
1121
  if (!isSafeLocalInspectionPath(configDir, deps)) {
@@ -1227,6 +1250,7 @@ export async function inspectCodexCliInstall(
1227
1250
  const npmPrefix = manifestOwned
1228
1251
  ? manifest.root.slice(0, manifest.root.length - "/lib/node_modules/@openai/codex".length)
1229
1252
  : "";
1253
+ let backingRoot: string | null = null;
1230
1254
  const installContentDigest = manifestOwned && deps.observeInstallContent === true
1231
1255
  // The selection's own lexical->canonical link is part of the claim:
1232
1256
  // verified again at the end of the observation so a retargeted launcher
@@ -1234,14 +1258,14 @@ export async function inspectCodexCliInstall(
1234
1258
  ? observeInstallContent(manifest, npmPrefix, platform, env, deps, {
1235
1259
  lexical: ownershipPath,
1236
1260
  canonical: canonicalOwnershipPath,
1237
- })
1261
+ }, root => { backingRoot = root; })
1238
1262
  : null;
1239
1263
  const versionMatches = candidate.version === null || candidate.version === manifest.version;
1240
1264
  const reason: CodexCliInstallReason = !global || !linked
1241
1265
  ? "npm_global_unverified"
1242
1266
  : !versionMatches ? "version_mismatch"
1243
1267
  : selectionAttested ? "managed_npm_global" : "selection_unattested";
1244
- return freezeReport({
1268
+ const report = freezeReport({
1245
1269
  schemaVersion: 1,
1246
1270
  candidateAvailable: true,
1247
1271
  candidateVersion: candidate.version,
@@ -1272,6 +1296,11 @@ export async function inspectCodexCliInstall(
1272
1296
  ...(installContentDigest ? ["install_content_digest" as const] : []),
1273
1297
  ]),
1274
1298
  });
1299
+ if (report.managed && report.installContentDigest && shim.status === "not-tracked") {
1300
+ mutationEvidence.set(report, Object.freeze({ prefix: npmPrefix, launcher: ownershipPath,
1301
+ canonicalLauncher: canonicalOwnershipPath, packageRoot: manifest.root, backingRoot }));
1302
+ }
1303
+ return report;
1275
1304
  }
1276
1305
 
1277
1306
  const stat = deps.stat ?? statSync;
@@ -113,7 +113,7 @@ function manifest(file: ObservedInstallationFile, name: string, bin: string, exp
113
113
  }
114
114
 
115
115
  /** Only the standard npm cmd-shim is linked here; arbitrary wrappers remain unverified. */
116
- function npmCodexCommandShim(bytes: Uint8Array): boolean {
116
+ export function npmCodexCommandShim(bytes: Uint8Array): boolean {
117
117
  const expected = `@ECHO off
118
118
  GOTO start
119
119
  :find_dp0
@@ -0,0 +1,7 @@
1
+ /**
2
+ * Shared finite observation bound, independent of platform/native API modules.
3
+ * Published npm backings exceed 256 MiB: Linux 0.163.0 is 296,865,480 bytes
4
+ * and Windows 0.153.4 is 295,408,944 bytes. Both readers hash native files in
5
+ * bounded chunks; 1 GiB limits read time without allocating the whole file.
6
+ */
7
+ export const MAX_NATIVE_BACKING_BYTES = 1024 * 1024 * 1024;