@bitkyc08/opencodex 2.93.0-preview.20261027 → 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-DxToX1rV.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-CJZoq-uF.js +0 -58
  433. package/gui/dist/assets/Tray-BWQPcgZn.js +0 -1
  434. package/gui/dist/assets/index-DRe8Hhfz.css +0 -1
  435. package/gui/dist/assets/index-Xfct8owH.js +0 -94
@@ -64,9 +64,16 @@ export type ReclaimListenPortOptions = WaitForPortOptions & {
64
64
  listListenPidsFn?: (port: number) => ListenPidScan | number[];
65
65
  isAliveFn?: (pid: number) => boolean;
66
66
  verifyOcxFn?: (pid: number) => number | null;
67
- killFn?: (pid: number) => void;
68
- dropTcpFn?: (port: number) => number | { dropped: number; skippedIpv6: number };
67
+ killFn?: (pid: number, mayMutate?: () => boolean) => void;
68
+ dropTcpFn?: (port: number, mayMutate?: () => boolean) => number | { dropped: number; skippedIpv6: number };
69
69
  isAvailableFn?: (port: number, hostname?: string) => Promise<boolean>;
70
+ /**
71
+ * Synchronous authority gate re-checked after each availability await and
72
+ * immediately before every destructive action (killFn / dropTcpFn). Returning
73
+ * false denies the mutation and ends the reclaim: the port is reported
74
+ * not-freed without touching processes or TCP rows. A throwing gate denies too.
75
+ */
76
+ mayMutateFn?: () => boolean;
70
77
  sleepMs?: (ms: number) => Promise<void>;
71
78
  };
72
79
 
@@ -516,6 +523,8 @@ export async function ownsIpv4LoopbackListener(
516
523
  * revalidates immediately before each kill.
517
524
  * Never overrides a rejected ocx verifier result. Never drops TCP rows while a
518
525
  * rejected live or protected ocx listener owns the port, or when the scan failed.
526
+ * A denied `mayMutateFn` ends the wait: no kill or TCP-row drop may run under
527
+ * an authority that no longer holds.
519
528
  */
520
529
  export async function reclaimListenPort(
521
530
  port: number,
@@ -539,13 +548,21 @@ export async function reclaimListenPort(
539
548
  const dropTcpFn = opts.dropTcpFn ?? dropWindowsTcpRowsForLocalPort;
540
549
  const isAvailableFn = opts.isAvailableFn ?? isPortAvailable;
541
550
  const sleep = opts.sleepMs ?? ((ms: number) => new Promise<void>(resolve => setTimeout(resolve, ms)));
551
+ let denied = false;
552
+ const mayMutate = (): boolean => {
553
+ try { denied ||= opts.mayMutateFn !== undefined && opts.mayMutateFn() !== true; } catch { denied = true; }
554
+ return !denied;
555
+ };
542
556
 
543
557
  const deadline = Date.now() + timeoutMs;
544
558
  let lastScan = 0;
545
559
  const killed = new Set<number>();
546
560
 
547
561
  for (;;) {
548
- if (await isAvailableFn(port, hostname)) return true;
562
+ const available = await isAvailableFn(port, hostname);
563
+ // The authority may have changed while the availability probe was in flight.
564
+ if (!mayMutate()) return false;
565
+ if (available) return true;
549
566
  if (Date.now() >= deadline) return false;
550
567
 
551
568
  if (Date.now() - lastScan >= scanIntervalMs) {
@@ -586,10 +603,13 @@ export async function reclaimListenPort(
586
603
  if (!killed.has(pid)) {
587
604
  // Revalidate immediately before termination.
588
605
  if (isAliveFn(pid) && verifyOcxFn(pid) === pid && mayKillThis) {
606
+ if (!mayMutate()) return false;
589
607
  try {
590
- killFn(pid);
608
+ if (opts.mayMutateFn) killFn(pid, mayMutate);
609
+ else killFn(pid);
591
610
  killed.add(pid);
592
611
  } catch {
612
+ if (denied) return false;
593
613
  // Kill failed: keep waiting and never reset this listener's TCP rows.
594
614
  protectedOcxListener = true;
595
615
  }
@@ -619,9 +639,13 @@ export async function reclaimListenPort(
619
639
  // Reset those IPv4 TCBs (and ghost LISTEN rows) so the configured port can bind again —
620
640
  // without killing the browser process. Only safe when no live foreign/protected listener remains.
621
641
  if (dropTcpRows) {
642
+ // Same gate as the kill path: denied authority never runs SetTcpEntry.
643
+ if (!mayMutate()) return false;
622
644
  try {
623
- dropTcpFn(port);
645
+ if (opts.mayMutateFn) dropTcpFn(port, mayMutate);
646
+ else dropTcpFn(port);
624
647
  } catch {
648
+ if (denied) return false;
625
649
  /* access denied / unsupported — keep waiting */
626
650
  }
627
651
  }
@@ -10,8 +10,10 @@
10
10
  * Lives outside cli.ts (which dispatches argv at module top level) so tests can import it.
11
11
  */
12
12
  import { loadConfig } from "../config";
13
- import { isWildcardHostname } from "../codex/loopback-target";
14
- import { readAlivePid, readRuntimePort, verifyPidIdentity } from "../config/process-state";
13
+ import { isLoopbackHostname, isWildcardHostname } from "../codex/loopback-target";
14
+ import { normalizeBindHostname } from "./bind-host";
15
+ import { isOcxCommandLine, readAlivePid, readProcessCommandLine, readRuntimePort, verifyPidIdentity } from "../config/process-state";
16
+ import { loopbackFamilyAvailability } from "../lib/loopback-family";
15
17
  import {
16
18
  LOCAL_ATTESTATION_CHALLENGE_HEADER,
17
19
  LOCAL_ATTESTATION_PROOF_HEADER,
@@ -52,6 +54,9 @@ export interface LivenessIo {
52
54
  * Destructive callers only ever receive pids that passed this gate.
53
55
  */
54
56
  verifyPidFn?: (candidatePid: number) => number | null;
57
+ /** Fresh command-line evidence: undefined/empty is unreadable, never confirmed foreign. */
58
+ readCommandLineFn?: typeof readProcessCommandLine;
59
+ loopbackAvailabilityFn?: typeof loopbackFamilyAvailability;
55
60
  readRuntimeFn?: (pid?: number) => { pid?: number; port: number; hostname?: string } | null;
56
61
  configFn?: () => { port?: number; hostname?: string };
57
62
  timeoutMs?: number;
@@ -152,8 +157,10 @@ type LivenessFetch = (
152
157
  export interface LiveProxy {
153
158
  pid: number | null;
154
159
  port: number;
155
- /** Raw bind hostname the probe succeeded against; compose URLs via `probeHostname`. */
160
+ /** Candidate bind scope, with the default loopback made explicit; never a probe alias. */
156
161
  hostname?: string;
162
+ /** Successful recovery probe address, when discovery checked both loopback families. */
163
+ probeHostname?: string;
157
164
  /** Whether the successful probe used runtime-port metadata or the configured listen port. */
158
165
  source: "runtime" | "config";
159
166
  /**
@@ -197,7 +204,7 @@ export type HomeOwnershipProof = "proven" | "refuted" | "indeterminate";
197
204
  export async function proveLiveProxyOwnedByHome(live: LiveProxy, io: LivenessIo = {}): Promise<HomeOwnershipProof> {
198
205
  if (live.pid === null) return "indeterminate";
199
206
  return attestFencedIdentity(
200
- `http://${probeHostname(live.hostname)}:${live.port}/healthz`,
207
+ `http://${probeHostname(live.probeHostname ?? live.hostname)}:${live.port}/healthz`,
201
208
  live.port,
202
209
  live.pid,
203
210
  io,
@@ -329,16 +336,16 @@ export function isConnectionRefused(error: unknown): boolean {
329
336
  if (depth >= 4) return false;
330
337
  if (current === null || (typeof current !== "object" && typeof current !== "function")) return false;
331
338
  const record = current as { code?: unknown; cause?: unknown; errors?: unknown };
332
- if (record.code === "ECONNREFUSED" || record.code === "ConnectionRefused") return true;
333
- if (typeof record.code === "string" && record.code.endsWith("ECONNREFUSED")) return true;
334
- if (Array.isArray(record.errors) && record.errors.length > 0) {
339
+ if (record.errors !== undefined) {
335
340
  // One connect attempt fanned out over several addresses reports a single AggregateError.
336
341
  // Only a unanimous refusal proves the endpoint is free: a bundle that mixes ECONNREFUSED
337
342
  // with a timeout means one address answered nothing at all, and an address whose state is
338
343
  // unreadable is unknown, not absence. Collapsing it to "refused" is how a second runtime
339
344
  // gets started on a port that already has one.
340
- return record.errors.every(error => visit(error, depth + 1));
345
+ return Array.isArray(record.errors) && record.errors.length > 0 && record.errors.every(error => visit(error, depth + 1));
341
346
  }
347
+ if (record.code === "ECONNREFUSED" || record.code === "ConnectionRefused") return true;
348
+ if (typeof record.code === "string" && record.code.endsWith("ECONNREFUSED")) return true;
342
349
  return visit(record.cause, depth + 1);
343
350
  };
344
351
  return visit(error, 0);
@@ -393,6 +400,17 @@ export async function proxyIdentityAt(
393
400
  opts: { hostname?: string; expectedPid?: number } = {},
394
401
  io: LivenessIo = {},
395
402
  ): Promise<{ pid: number | null; version?: string; role?: string; packageTreeFenced?: true } | null> {
403
+ return proxyIdentityAtObserved(port, opts, io);
404
+ }
405
+
406
+ /** Preserve negative evidence for recovery without changing identity-only callers. */
407
+ async function proxyIdentityAtObserved(
408
+ port: number,
409
+ opts: { hostname?: string; expectedPid?: number },
410
+ io: LivenessIo,
411
+ observe?: (result: EndpointLiveness) => void,
412
+ ): ReturnType<typeof proxyIdentityAt> {
413
+ const negative = (result: "dead" | "unknown"): null => { observe?.(result); return null; };
396
414
  const fetchFn = io.fetchFn ?? directLocalHttpFetch;
397
415
  const sleepFn = io.sleepFn ?? ((ms: number) => new Promise<void>(r => setTimeout(r, ms)));
398
416
  const nowFn = io.nowFn ?? Date.now;
@@ -401,10 +419,11 @@ export async function proxyIdentityAt(
401
419
  const attempts = Number.isNaN(requestedAttempts)
402
420
  ? 1
403
421
  : Math.max(1, Math.min(requestedAttempts, 5));
422
+ let sawUnknown = false;
404
423
 
405
424
  for (let attempt = 1; attempt <= attempts; attempt++) {
406
425
  const remainingMs = io.deadlineAt === undefined ? baseTimeoutMs : io.deadlineAt - nowFn();
407
- if (remainingMs <= 0) return null;
426
+ if (remainingMs <= 0) return negative("unknown");
408
427
  const timeoutMs = Math.min(baseTimeoutMs, remainingMs);
409
428
  try {
410
429
  const url = `http://${probeHostname(opts.hostname)}:${port}/healthz`;
@@ -413,12 +432,12 @@ export async function proxyIdentityAt(
413
432
  });
414
433
  if (!res.ok && io.acceptPackageTreeFenced && res.status === 503) {
415
434
  const fenced = (await res.json().catch(() => null)) as HealthzIdentity | null;
416
- if (!isPackageTreeFencedHealthz(fenced)) return null;
435
+ if (!isPackageTreeFencedHealthz(fenced)) return negative("unknown");
417
436
  const fencedPid = fenced!.pid as number;
418
- if (opts.expectedPid !== undefined && fencedPid !== opts.expectedPid) return null;
437
+ if (opts.expectedPid !== undefined && fencedPid !== opts.expectedPid) return negative("unknown");
419
438
  const attestMs = io.deadlineAt === undefined ? baseTimeoutMs : Math.min(baseTimeoutMs, io.deadlineAt - nowFn());
420
- if (attestMs <= 0) return null;
421
- if ((await attestFencedIdentity(url, port, fencedPid, io, fetchFn, attestMs)) !== "proven") return null;
439
+ if (attestMs <= 0) return negative("unknown");
440
+ if ((await attestFencedIdentity(url, port, fencedPid, io, fetchFn, attestMs)) !== "proven") return negative("unknown");
422
441
  const fencedVersion = isHealthzVersion(fenced?.version) ? fenced!.version as string : undefined;
423
442
  return {
424
443
  pid: fencedPid,
@@ -426,11 +445,11 @@ export async function proxyIdentityAt(
426
445
  packageTreeFenced: true,
427
446
  };
428
447
  }
429
- if (!res.ok) return null;
430
- const body = (await res.json().catch(() => null)) as HealthzIdentity | null;
431
- if (!isOpencodexHealthz(body)) return null;
448
+ if (!res.ok) return negative("unknown");
449
+ const body = (await res.json().catch(() => undefined)) as HealthzIdentity | null | undefined;
450
+ if (!isOpencodexHealthz(body ?? null)) return negative(res.status === 200 && body !== undefined ? "dead" : "unknown");
432
451
  const pid = typeof body?.pid === "number" ? body.pid : null;
433
- if (opts.expectedPid !== undefined && pid !== null && pid !== opts.expectedPid) return null;
452
+ if (opts.expectedPid !== undefined && pid !== null && pid !== opts.expectedPid) return negative("unknown");
434
453
  // Whoever holds the port controls this response. Only carry bounded semver text into
435
454
  // diagnostics; dropping anything else prevents terminal controls reaching human output.
436
455
  const version = isHealthzVersion(body?.version) ? body.version : undefined;
@@ -442,15 +461,38 @@ export async function proxyIdentityAt(
442
461
  ...(version === undefined ? {} : { version }),
443
462
  ...(role === undefined ? {} : { role }),
444
463
  };
445
- } catch {
464
+ } catch (error) {
446
465
  // Transport failure (timeout / refused) — retry while budget remains; a proxy that
447
466
  // has only just begun listening can miss a single short probe (#764).
448
- if (attempt >= attempts) return null;
449
- if (io.deadlineAt !== undefined && io.deadlineAt - nowFn() <= 0) return null;
467
+ if (!isConnectionRefused(error)) sawUnknown = true;
468
+ if (attempt >= attempts) return negative(sawUnknown ? "unknown" : "dead");
469
+ if (io.deadlineAt !== undefined && io.deadlineAt - nowFn() <= 0) return negative("unknown");
450
470
  await sleepFn(100);
451
471
  }
452
472
  }
453
- return null;
473
+ return negative("unknown");
474
+ }
475
+
476
+ export type ProxyLivenessObservation =
477
+ | { kind: "live"; live: LiveProxy }
478
+ | { kind: "absent" | "unknown"; live: null };
479
+
480
+ /** Recovery additionally covers both available loopback families and fresh PID identity. */
481
+ export async function observeProxyLiveness(io: LivenessIo = {}): Promise<ProxyLivenessObservation> {
482
+ let alivePid: number | null = null, unknown = false;
483
+ const live = await discoverLiveProxy(io, {
484
+ pid: pid => { alivePid = pid; },
485
+ endpoint: result => { if (result === "unknown") unknown = true; },
486
+ });
487
+ if (live) return { kind: "live", live };
488
+ if (alivePid !== null && !unknown) {
489
+ // A failed verifier alone conflates foreign with unreadable. Only fresh positive
490
+ // evidence of a foreign command line releases a reused PID; never signal it.
491
+ const commandLine = (io.readCommandLineFn ?? readProcessCommandLine)(alivePid);
492
+ unknown = !commandLine?.trim() || isOcxCommandLine(commandLine);
493
+ if (io.deadlineAt !== undefined && (io.nowFn ?? Date.now)() >= io.deadlineAt) unknown = true;
494
+ }
495
+ return { kind: unknown ? "unknown" : "absent", live: null };
454
496
  }
455
497
 
456
498
  /**
@@ -459,6 +501,13 @@ export async function proxyIdentityAt(
459
501
  * found and a foreign listener on the configured port is rejected.
460
502
  */
461
503
  export async function findLiveProxy(io: LivenessIo = {}): Promise<LiveProxy | null> {
504
+ return discoverLiveProxy(io);
505
+ }
506
+
507
+ async function discoverLiveProxy(io: LivenessIo, observer?: {
508
+ pid: (pid: number | null) => void;
509
+ endpoint: (result: EndpointLiveness) => void;
510
+ }): Promise<LiveProxy | null> {
462
511
  // Prefer the cheap alive-pid check: the Windows cmdline probe (WMIC/PowerShell) is too
463
512
  // expensive for waitForProxy's 150ms poll loop, and /healthz identity is the real trust gate.
464
513
  const readPidFn = io.readPidFn ?? readAlivePid;
@@ -470,6 +519,26 @@ export async function findLiveProxy(io: LivenessIo = {}): Promise<LiveProxy | nu
470
519
  const probeIo: LivenessIo = io;
471
520
  const budgetExhausted = (): boolean =>
472
521
  deadlineAt !== undefined && nowFn() >= deadlineAt;
522
+ const expired = (): null => { observer?.endpoint("unknown"); return null; };
523
+ const probe = async (port: number, opts: { hostname?: string; expectedPid?: number }) => {
524
+ // Missing/blank means an actual loopback bind, not a later config's bind scope.
525
+ const bindHostname = opts.hostname?.trim() || "127.0.0.1";
526
+ const hostname = normalizeBindHostname(opts.hostname);
527
+ if (!observer || (!isLoopbackHostname(hostname) && !isWildcardHostname(hostname))) {
528
+ const identity = await proxyIdentityAtObserved(port, opts, probeIo, observer?.endpoint);
529
+ return identity ? { ...identity, hostname: bindHostname,
530
+ ...(observer ? { probeHostname: probeHostname(opts.hostname) } : {}) } : null;
531
+ }
532
+ // Parallel families share the existing per-probe attempts/timeout and absolute
533
+ // deadline. A slow family cannot multiply the serial discovery budget.
534
+ const hosts = loopbackProbeHosts(hostname).filter(host =>
535
+ (io.loopbackAvailabilityFn ?? loopbackFamilyAvailability)(host) !== "unavailable");
536
+ const identities = await Promise.all(hosts.map(async hostname => {
537
+ const identity = await proxyIdentityAtObserved(port, { ...opts, hostname }, probeIo, observer.endpoint);
538
+ return identity ? { ...identity, hostname: bindHostname, probeHostname: hostname } : null;
539
+ }));
540
+ return identities.find(identity => identity !== null) ?? null;
541
+ };
473
542
 
474
543
  // The cheap pid is discovery-only. Before it can appear in a returned (killable) result
475
544
  // it must pass the full identity check AND the verifier must echo the exact candidate —
@@ -488,13 +557,14 @@ export async function findLiveProxy(io: LivenessIo = {}): Promise<LiveProxy | nu
488
557
  };
489
558
 
490
559
  const pid = readPidFn();
560
+ observer?.pid(pid);
491
561
  let probedPort: number | null = null;
492
562
  if (pid) {
493
563
  const runtime = readRuntimeFn(pid);
494
564
  if (runtime?.port) {
495
- if (budgetExhausted()) return null;
565
+ if (budgetExhausted()) return expired();
496
566
  probedPort = runtime.port;
497
- const identity = await proxyIdentityAt(runtime.port, { hostname: runtime.hostname, expectedPid: pid }, probeIo);
567
+ const identity = await probe(runtime.port, { hostname: runtime.hostname, expectedPid: pid });
498
568
  if (identity) {
499
569
  // healthz confirmed the pid itself → trusted; a pidless legacy body did not,
500
570
  // so the cheap pid must pass full identity verification before it is returned.
@@ -502,7 +572,8 @@ export async function findLiveProxy(io: LivenessIo = {}): Promise<LiveProxy | nu
502
572
  return {
503
573
  pid: trusted,
504
574
  port: runtime.port,
505
- hostname: runtime.hostname,
575
+ hostname: identity.hostname,
576
+ ...(identity.probeHostname === undefined ? {} : { probeHostname: identity.probeHostname }),
506
577
  source: "runtime",
507
578
  ...(identity.version === undefined ? {} : { version: identity.version }),
508
579
  ...(identity.role === undefined ? {} : { role: identity.role }),
@@ -517,9 +588,9 @@ export async function findLiveProxy(io: LivenessIo = {}): Promise<LiveProxy | nu
517
588
  // identity-probe it so ensure/update/stop see the live proxy instead of shadowing it.
518
589
  const record = readRuntimeFn();
519
590
  if (record?.port && record.port !== probedPort) {
520
- if (budgetExhausted()) return null;
591
+ if (budgetExhausted()) return expired();
521
592
  const expectedPid = typeof record.pid === "number" ? record.pid : undefined;
522
- const identity = await proxyIdentityAt(record.port, { hostname: record.hostname, expectedPid }, probeIo);
593
+ const identity = await probe(record.port, { hostname: record.hostname, expectedPid });
523
594
  // Only the healthz-reported pid is authoritative here. The record's pid may be stale
524
595
  // (its process dead, the port reused by a pidless legacy proxy) — synthesizing it
525
596
  // would hand destructive callers (stopProxy → kill fallback) a reusable pid.
@@ -527,7 +598,8 @@ export async function findLiveProxy(io: LivenessIo = {}): Promise<LiveProxy | nu
527
598
  return {
528
599
  pid: verifiedReportedPid(identity.pid),
529
600
  port: record.port,
530
- hostname: record.hostname,
601
+ hostname: identity.hostname,
602
+ ...(identity.probeHostname === undefined ? {} : { probeHostname: identity.probeHostname }),
531
603
  source: "runtime",
532
604
  ...(identity.version === undefined ? {} : { version: identity.version }),
533
605
  ...(identity.role === undefined ? {} : { role: identity.role }),
@@ -538,13 +610,16 @@ export async function findLiveProxy(io: LivenessIo = {}): Promise<LiveProxy | nu
538
610
 
539
611
  const config = configFn();
540
612
  const port = config.port ?? 10100;
541
- if (budgetExhausted()) return null;
542
- const identity = await proxyIdentityAt(port, { hostname: config.hostname }, probeIo);
613
+ if (budgetExhausted()) return expired();
614
+ // Port zero requests an OS-assigned port; it cannot name an existing listener.
615
+ if (observer && port === 0) return null;
616
+ const identity = await probe(port, { hostname: config.hostname });
543
617
  if (identity) {
544
618
  return {
545
619
  pid: verifiedReportedPid(identity.pid) ?? killablePid(pid),
546
620
  port,
547
- hostname: config.hostname,
621
+ hostname: identity.hostname,
622
+ ...(identity.probeHostname === undefined ? {} : { probeHostname: identity.probeHostname }),
548
623
  source: "config",
549
624
  ...(identity.version === undefined ? {} : { version: identity.version }),
550
625
  ...(identity.role === undefined ? {} : { role: identity.role }),
@@ -572,9 +647,11 @@ export async function findLiveProxy(io: LivenessIo = {}): Promise<LiveProxy | nu
572
647
  * different question than the caller asked.
573
648
  */
574
649
  export function loopbackProbeHosts(hostname: string | undefined): string[] {
575
- const primary = probeHostname(hostname);
576
- if (primary === "127.0.0.1" || /^localhost$/i.test(primary)) return ["127.0.0.1", "[::1]"];
577
- if (primary === "[::1]") return ["[::1]", "127.0.0.1"];
650
+ const normalized = normalizeBindHostname(hostname);
651
+ const primary = probeHostname(normalized);
652
+ if (isLoopbackHostname(normalized) || isWildcardHostname(normalized)) {
653
+ return primary === "[::1]" ? ["[::1]", "127.0.0.1"] : ["127.0.0.1", "[::1]"];
654
+ }
578
655
  return [primary];
579
656
  }
580
657
 
@@ -1,6 +1,7 @@
1
1
  import { Buffer } from "node:buffer";
2
2
  import { gunzipSync, inflateRawSync, inflateSync, zstdDecompressSync } from "node:zlib";
3
3
  import type { TranslatorBudget } from "../lib/translator-budget";
4
+ import { updateInboundBodyReservation } from "./inbound-body-budget";
4
5
 
5
6
  /**
6
7
  * Request-body decompression for the /v1/responses data plane.
@@ -328,11 +329,14 @@ export async function readBoundedJsonRequestBody(
328
329
  // Count UTF-8 without allocating another request-sized byte array for diagnostics.
329
330
  releaseText = budget?.observeAcceptedRequestCopy(Buffer.byteLength(text, "utf8"));
330
331
  if (options && "emptyBodyFallback" in options && text.trim() === "") {
332
+ updateInboundBodyReservation(req, Math.max(raw.byteLength, decoded.byteLength));
331
333
  return options.emptyBodyFallback;
332
334
  }
333
335
  const parsed = JSON.parse(text);
334
336
  // Keep the serialized-size contract: normalization can expand numeric literals.
335
- budget?.observeAcceptedRequestCopy(Buffer.byteLength(JSON.stringify(parsed), "utf8"));
337
+ const parsedBytes = budget ? Buffer.byteLength(JSON.stringify(parsed), "utf8") : decoded.byteLength;
338
+ budget?.observeAcceptedRequestCopy(parsedBytes);
339
+ updateInboundBodyReservation(req, Math.max(raw.byteLength, decoded.byteLength, parsedBytes));
336
340
  return parsed;
337
341
  } finally {
338
342
  releaseText?.();
@@ -199,6 +199,13 @@ export function scrubUnportableConversationStateInPlace(body: unknown): boolean
199
199
  delete record.conversation;
200
200
  changed = true;
201
201
  }
202
+ if (record.client_metadata && typeof record.client_metadata === "object" && !Array.isArray(record.client_metadata)) {
203
+ const cm = record.client_metadata as Record<string, unknown>;
204
+ if ("x-codex-turn-state" in cm) {
205
+ delete cm["x-codex-turn-state"];
206
+ changed = true;
207
+ }
208
+ }
202
209
  // Encrypted reasoning and compaction ciphertext are deliberately NOT touched here. #2247
203
210
  // already strips them when a pooled thread moves accounts, and in a specific shape: the
204
211
  // reasoning item keeps its readable summary with an emptied content array, and the compaction
@@ -230,6 +237,7 @@ export function rememberServingConversationStateIssuer(
230
237
 
231
238
  export interface ApplyAccountChangeConversationStateScrubArgs {
232
239
  body: unknown;
240
+ headers?: Headers;
233
241
  bindingKey: string;
234
242
  servingAccountId: string;
235
243
  /** Account this request body was prepared for, when this is an in-request move. */
@@ -257,9 +265,13 @@ export function applyAccountChangeConversationStateScrub(
257
265
  // The issuer record can outlive the serving-route cache. Even a retained ciphertext cannot
258
266
  // make its reasoning item id resolvable in the new account's store.
259
267
  if (parsed) parsed._dropForeignReasoningItemIds = true;
260
- if (canPortConversationState(collectConversationStateCarriers(body)).portable) return false;
268
+ let headerScrubbed = false;
269
+ if (args.headers?.has("x-codex-turn-state")) {
270
+ args.headers.delete("x-codex-turn-state");
271
+ headerScrubbed = true;
272
+ }
261
273
  const scrubbed = scrubUnportableConversationStateInPlace(body);
262
- if (!scrubbed) return false;
274
+ if (!scrubbed && !headerScrubbed) return false;
263
275
  if (parsed) {
264
276
  delete parsed.previousResponseId;
265
277
  parsed._stripNativeCompactionEncryptedContent = true;
@@ -18,6 +18,7 @@ import {
18
18
  import { noteAttemptRecoveryWithheld } from "../request-log";
19
19
  import { withProviderRequestSlot } from "../../providers/request-pacing";
20
20
  import { providerFetch, fetchWithHeaderTimeout, safeHostLabel } from "./fetch-helpers";
21
+ import { isLocalUpstream } from "../../lib/local-upstream";
21
22
  import {
22
23
  transientRetryPolicyFor,
23
24
  rateLimitRetryDelayMs,
@@ -139,8 +140,7 @@ export function createAdapterContinuations(
139
140
  } = transportState;
140
141
  const { route, translatorBudget, inboundWire, parsed } = requestState;
141
142
  const { routedCompaction } = sidecarState;
142
- const { upstream, connectMs, rateLimitPolicy, stallTimeoutMs, localUpstream } = adapterExchange;
143
- const bodyInactivityMs = resolveStallTimeoutMs(config.stallTimeoutSec, { localUpstream });
143
+ const { upstream, connectMs, rateLimitPolicy, stallTimeoutMs } = adapterExchange;
144
144
  const {
145
145
  adapterDispatchBudget,
146
146
  noteAdapterPhysicalSend,
@@ -249,7 +249,7 @@ export function createAdapterContinuations(
249
249
  transportState.activeAdapter.fetchResponse!(builtContinuationRequest, {
250
250
  kiroPreferAccountFailover: route.providerName === "kiro" && isGenericOAuthFailoverEnabled(config, "kiro"),
251
251
  abortSignal: upstream.signal,
252
- timeoutMs: connectMs,
252
+ timeoutMs: route.provider.authMode === "forward" ? connectMs : 0,
253
253
  sendBudget: adapterDispatchBudget,
254
254
  onPhysicalSend: send => noteAdapterPhysicalSend(continuationEstimate, send),
255
255
  onRecoveryWithheld: noteAdapterRecoveryWithheld,
@@ -284,7 +284,7 @@ export function createAdapterContinuations(
284
284
  body: builtContinuationRequest.body,
285
285
  }, recovery),
286
286
  upstream.signal,
287
- connectMs,
287
+ route.provider.authMode === "forward" ? connectMs : 0,
288
288
  nextParsed.stream,
289
289
  providerFetch(route.provider, options.codexWsRuntimeIdentity, {
290
290
  dispatchOverride: oauthDispatch(builtContinuationRequest, nextParsed),
@@ -720,6 +720,7 @@ export function createAdapterContinuations(
720
720
  // The shared signal is not aborted on timeout: this generator must still emit
721
721
  // the error that the already-live Responses bridge turns into a terminal.
722
722
  const parse = async function* (current: Response): AsyncGenerator<AdapterEvent> {
723
+ const bodyInactivityMs = resolveStallTimeoutMs(config.stallTimeoutSec, { localUpstream: isLocalUpstream(transportState.sameTargetRequest?.url ?? route.provider.baseUrl) });
723
724
  if (!current.ok) {
724
725
  yield await adapterExchange.thinkingSignatureRecovery.projectHttpFailure(current, upstream.signal);
725
726
  } else if (nextParsed.stream) {
@@ -42,6 +42,8 @@ export async function deliverAdapterResponse(
42
42
  | "clientToolCatalogRestriction"
43
43
  | "rememberKiroDeliveredFinalAnswer"
44
44
  | "responseStateOptions"
45
+ | "turnMembership"
46
+ | "completedToolBlocks"
45
47
  >,
46
48
  transportState: Pick<ResponsesTransport, "activeAdapter" | "bindKeyUsageFromBridge" | "sentOAuthSnapshot">,
47
49
  sidecarState: Pick<ResponsesSidecarAuth, "routedCompaction">,
@@ -100,6 +102,7 @@ export async function deliverAdapterResponse(
100
102
  return;
101
103
  }
102
104
  try {
105
+ const bodyInactivityMs = resolveStallTimeoutMs(config.stallTimeoutSec, { localUpstream: adapterExchange.localUpstream });
103
106
  const retryEvents = upstreamRequestsStream
104
107
  ? readResponseStreamWithInactivity(response, upstream.signal, bodyInactivityMs,
105
108
  guarded => transportState.activeAdapter.parseStream(guarded, translatorBudget, logCtx.activeTierMetadata))
@@ -125,6 +128,15 @@ export async function deliverAdapterResponse(
125
128
 
126
129
 
127
130
  if (parsed.stream) {
131
+ const clientEncoder = clientToolCatalog?.bareCustomToolNames.has("exec") ? undefined
132
+ : clientEncoderForDelivery(options, logCtx, !!routedCompaction, transportState.activeAdapter.name);
133
+ // Sign only the negotiated canonical Chat delivery. Native/sidecar/opaque item identities
134
+ // retain their existing owners; structural membership grants no supplier-state authority.
135
+ const outputItemIds = requestState.completedToolBlocks && transportState.activeAdapter.name === "openai-chat"
136
+ && options.inboundWire !== "chat" && options.inboundWire !== "anthropic"
137
+ && !routedCompaction && !parsed._advisorGuard && !clientEncoder && upstreamResponse.headers.get("x-opencodex-tool-completion") === "block-stop-v1"
138
+ ? requestState.turnMembership?.begin() : undefined;
139
+
128
140
  // The continuation legs classify a stalled body themselves; the initial stream needs the
129
141
  // same mapping or the bridge catch reports this upstream timeout as a 500 proxy_error.
130
142
  const initialEventStream = (async function* (): AsyncGenerator<AdapterEvent> {
@@ -133,7 +145,7 @@ export async function deliverAdapterResponse(
133
145
  upstreamResponse,
134
146
  upstream.signal,
135
147
  bodyInactivityMs,
136
- response => transportState.activeAdapter.parseStream(response, translatorBudget, logCtx.activeTierMetadata),
148
+ response => transportState.activeAdapter.parseStream(response, translatorBudget, logCtx.activeTierMetadata, { completedToolBlocks: outputItemIds !== undefined }),
137
149
  )) {
138
150
  options.onCompactionRecoveryAdapterEvent?.(event);
139
151
  yield event;
@@ -211,8 +223,7 @@ export async function deliverAdapterResponse(
211
223
  notifyResponseComplete(response);
212
224
  };
213
225
  // The Responses bridge owns code-mode helper compilation; the direct encoder only renames.
214
- const clientEncoder = clientToolCatalog?.bareCustomToolNames.has("exec") ? undefined
215
- : clientEncoderForDelivery(options, logCtx, !!routedCompaction, transportState.activeAdapter.name);
226
+
216
227
  if (clientEncoder) {
217
228
  return deliverClientEncodedResponse({
218
229
  encoder: clientEncoder,
@@ -224,11 +235,12 @@ export async function deliverAdapterResponse(
224
235
  fold: {
225
236
  replayCacheScope: parsed._reasoningReplayScope,
226
237
  hideThinkingSummary: parsed.options.hideThinkingSummary,
238
+ chatRawReasoningVisible: options.chatRawReasoningVisible,
227
239
  hideRawReasoning: parsed.options.hideRawReasoning,
228
240
  toolNsMap, declaredToolNames, toolParameterSchemas, freeformToolNames, bareCustomToolNames, toolSearchToolNames,
229
241
  },
230
242
  stallTimeoutSec: config.stallTimeoutSec,
231
- localUpstream,
243
+ get localUpstream() { return adapterExchange.localUpstream; },
232
244
  turnAdmissionLease: options.turnAdmissionLease,
233
245
  ...(options.onFirstOutput ? { onFirstOutput: options.onFirstOutput } : {}),
234
246
  stopUpstream: () => { cancelResponseCompletion(); upstream.abort(); },
@@ -243,10 +255,12 @@ export async function deliverAdapterResponse(
243
255
  {
244
256
  translatorBudget,
245
257
  replayCacheScope: parsed._reasoningReplayScope,
258
+ ...(outputItemIds ? { outputItemIds } : {}),
246
259
  ...(options.forceEmptyResponseId ? { responseId: "" } : {}),
247
260
  stallTimeoutSec: config.stallTimeoutSec,
248
- localUpstream,
261
+ get localUpstream() { return adapterExchange.localUpstream; },
249
262
  hideThinkingSummary: parsed.options.hideThinkingSummary,
263
+ chatRawReasoningVisible: options.chatRawReasoningVisible,
250
264
  hideRawReasoning: parsed.options.hideRawReasoning,
251
265
  declaredToolNames,
252
266
  bareCustomToolNames,
@@ -354,6 +368,7 @@ export async function deliverAdapterResponse(
354
368
  translatorBudget,
355
369
  replayCacheScope: parsed._reasoningReplayScope,
356
370
  hideThinkingSummary: parsed.options.hideThinkingSummary,
371
+ chatRawReasoningVisible: options.chatRawReasoningVisible,
357
372
  hideRawReasoning: parsed.options.hideRawReasoning,
358
373
  toolNsMap,
359
374
  declaredToolNames,