@bitkyc08/opencodex 2.100.5 → 2.100.6-preview.20261119.1

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 (536) hide show
  1. package/README.md +1 -1
  2. package/bin/ocx.mjs +2 -0
  3. package/gui/dist/assets/App-BI8LQ7Qk.css +1 -0
  4. package/gui/dist/assets/App-D5qUBOoF.js +60 -0
  5. package/gui/dist/assets/Tray-DMwQSAli.js +1 -0
  6. package/gui/dist/assets/brand-mark-ycThul7d.js +1 -0
  7. package/gui/dist/assets/index-Bp_GaFFu.js +138 -0
  8. package/gui/dist/assets/index-BtwVlpeQ.css +2 -0
  9. package/gui/dist/assets/{segment-thumb-features-Bquysdn5.js → segment-thumb-features-BLUW2Fb1.js} +1 -1
  10. package/gui/dist/classic/assets/App-CoiVLRW3.css +1 -0
  11. package/gui/dist/classic/assets/App-D39mkP2w.js +59 -0
  12. package/gui/dist/classic/assets/Tray-nUmdL7K9.js +1 -0
  13. package/gui/dist/classic/assets/index-BJ4uxZk0.js +138 -0
  14. package/gui/dist/classic/assets/usage-companion-chart-DFoYm2RY.js +1 -0
  15. package/gui/dist/classic/index.html +1 -1
  16. package/gui/dist/index.html +2 -2
  17. package/native/ocx-child/Cargo.lock +62 -0
  18. package/native/ocx-child/Cargo.toml +1 -0
  19. package/native/ocx-child/src/journal.rs +32 -10
  20. package/native/ocx-child/src/state.rs +2 -1
  21. package/native/ocx-child/src/toml_surgeon.rs +183 -72
  22. package/package.json +2 -2
  23. package/src/adapters/agy-acp/acp.ts +202 -0
  24. package/src/adapters/agy-acp/adapter.ts +554 -0
  25. package/src/adapters/agy-acp/binary.ts +79 -0
  26. package/src/adapters/agy-acp/options.ts +163 -0
  27. package/src/adapters/agy-acp/output-redaction.ts +270 -0
  28. package/src/adapters/agy-acp/policy.ts +105 -0
  29. package/src/adapters/agy-acp/process.ts +218 -0
  30. package/src/adapters/anthropic/account-metadata.ts +4 -1
  31. package/src/adapters/anthropic/advisor-tool.ts +43 -9
  32. package/src/adapters/anthropic/client-identity.ts +2 -0
  33. package/src/adapters/anthropic.ts +102 -14
  34. package/src/adapters/antigravity-refusal.ts +5 -1
  35. package/src/adapters/base.ts +25 -2
  36. package/src/adapters/claude-cli/adapter.ts +1 -0
  37. package/src/adapters/claude-cli/usage-admission.ts +12 -9
  38. package/src/adapters/codebuddy/adapter.ts +1 -0
  39. package/src/adapters/command-code.ts +2 -2
  40. package/src/adapters/cursor/http1-bidi.ts +7 -2
  41. package/src/adapters/cursor/live-transport.ts +2 -0
  42. package/src/adapters/cursor/request-builder.ts +4 -4
  43. package/src/adapters/cursor/tool-naming.ts +5 -5
  44. package/src/adapters/cursor/transport-retry.ts +14 -8
  45. package/src/adapters/cursor/transport.ts +2 -0
  46. package/src/adapters/cursor.ts +8 -2
  47. package/src/adapters/google-error-details.ts +105 -0
  48. package/src/adapters/google-errors.ts +183 -31
  49. package/src/adapters/google-http.ts +66 -22
  50. package/src/adapters/google-truncation.ts +48 -3
  51. package/src/adapters/google-vertex-endpoint.ts +12 -1
  52. package/src/adapters/google.ts +54 -26
  53. package/src/adapters/kiro/adapter.ts +39 -38
  54. package/src/adapters/kiro/stream.ts +59 -9
  55. package/src/adapters/kiro-retry.ts +5 -3
  56. package/src/adapters/m365-copilot/LICENSE +21 -0
  57. package/src/adapters/m365-copilot/fenced.ts +745 -0
  58. package/src/adapters/m365-copilot/images.ts +89 -0
  59. package/src/adapters/m365-copilot/tools.ts +284 -0
  60. package/src/adapters/m365-copilot/transport.ts +232 -0
  61. package/src/adapters/m365-copilot.ts +143 -0
  62. package/src/adapters/openai-chat/tool-schema.ts +2 -2
  63. package/src/adapters/openai-responses/passthrough.ts +1 -0
  64. package/src/adapters/openai-responses/reasoning.ts +23 -3
  65. package/src/adapters/physical-send.ts +11 -4
  66. package/src/adapters/qoder/adapter.ts +17 -3
  67. package/src/adapters/registry.ts +15 -1
  68. package/src/adapters/zed.ts +2 -1
  69. package/src/advisor/consult.ts +1 -0
  70. package/src/bridge/response-json.ts +6 -2
  71. package/src/bridge/sse.ts +21 -9
  72. package/src/chat/inbound.ts +11 -8
  73. package/src/chat/outbound.ts +28 -7
  74. package/src/claude/context-windows.ts +32 -8
  75. package/src/claude/desktop-3p.ts +18 -14
  76. package/src/claude/desktop-picker-platform.ts +1 -1
  77. package/src/claude/desktop-picker.ts +3 -3
  78. package/src/claude/inbound-content-options.ts +11 -1
  79. package/src/claude/intercept/picker-ca-cleanup.ts +17 -5
  80. package/src/claude/intercept/picker-ca.ts +162 -27
  81. package/src/claude/intercept/picker-trust-linux.ts +411 -0
  82. package/src/claude/intercept/picker-trust.ts +35 -3
  83. package/src/claude/intercept/runtime.ts +2 -2
  84. package/src/claude/subagent-force-status.ts +24 -5
  85. package/src/claude/subscription-reserve.ts +87 -0
  86. package/src/cli/account-api.ts +3 -0
  87. package/src/cli/account-auth.ts +65 -11
  88. package/src/cli/account-extended.ts +1 -1
  89. package/src/cli/account-next-actions.ts +4 -1
  90. package/src/cli/account-policy-dto.ts +1 -1
  91. package/src/cli/account-policy.ts +6 -3
  92. package/src/cli/account-probe.ts +66 -0
  93. package/src/cli/account.ts +8 -2
  94. package/src/cli/capabilities-accounts.ts +8 -1
  95. package/src/cli/capabilities-agents-routing.ts +2 -2
  96. package/src/cli/capabilities-base.ts +4 -4
  97. package/src/cli/capabilities-integrations.ts +44 -4
  98. package/src/cli/capabilities-provider-models.ts +6 -0
  99. package/src/cli/claude-context-settings.ts +60 -0
  100. package/src/cli/claude-desktop.ts +2 -2
  101. package/src/cli/claude.ts +15 -7
  102. package/src/cli/client-start-fence.ts +64 -1
  103. package/src/cli/combo-result.ts +1 -0
  104. package/src/cli/combo-stats.ts +1 -1
  105. package/src/cli/combo.ts +19 -2
  106. package/src/cli/config-command.ts +21 -8
  107. package/src/cli/connect.ts +16 -0
  108. package/src/cli/cross-home-owner.ts +65 -18
  109. package/src/cli/dispatch.ts +4 -0
  110. package/src/cli/gateway-client-command.ts +128 -0
  111. package/src/cli/index.ts +98 -97
  112. package/src/cli/init.ts +20 -4
  113. package/src/cli/integrations.ts +23 -3
  114. package/src/cli/launcher-context.ts +12 -1
  115. package/src/cli/link.ts +24 -5
  116. package/src/cli/models-runtime-subcommands.ts +1 -0
  117. package/src/cli/models-runtime.ts +32 -0
  118. package/src/cli/start-owner-fence.ts +5 -2
  119. package/src/cli/status.ts +3 -3
  120. package/src/cli/stop-client-process.ts +51 -0
  121. package/src/cli/stop-restore.ts +383 -36
  122. package/src/cli/sync-command.ts +2 -2
  123. package/src/cli/uninstall-client-state.ts +7 -0
  124. package/src/client/connect.ts +72 -13
  125. package/src/client/hub-client.ts +38 -0
  126. package/src/client/hub-relay.ts +61 -36
  127. package/src/client/hub-session.ts +106 -0
  128. package/src/client/lifecycle-lock.ts +6 -1
  129. package/src/client/link-relay.ts +2 -1
  130. package/src/client/machine-listener.ts +60 -1
  131. package/src/client/runtime-restart.ts +1 -0
  132. package/src/client/runtime.ts +104 -34
  133. package/src/client/state.ts +11 -0
  134. package/src/client/stop-darwin-process.ts +73 -0
  135. package/src/client/stop-file-routing.ts +49 -0
  136. package/src/client/stop-native-handoff.ts +108 -0
  137. package/src/client/stop-routing.ts +41 -7
  138. package/src/client/stop-teardown-owner.ts +173 -0
  139. package/src/client/sync-runtime.ts +23 -4
  140. package/src/clients/config-export/opencode-wire.ts +24 -0
  141. package/src/clients/config-export.ts +28 -19
  142. package/src/codex/auth-api/login-flow.ts +68 -33
  143. package/src/codex/auth-api/main-account-probe.ts +3 -3
  144. package/src/codex/auth-api/pool-quota-probe.ts +8 -7
  145. package/src/codex/auth-api/routes.ts +1 -1
  146. package/src/codex/catalog/aggregation.ts +22 -10
  147. package/src/codex/catalog/gather-capture.ts +11 -2
  148. package/src/codex/catalog/m365-copilot-models.ts +52 -0
  149. package/src/codex/catalog/provider-models.ts +126 -53
  150. package/src/codex/catalog/routed-gather.ts +26 -12
  151. package/src/codex/catalog-admission.ts +4 -6
  152. package/src/codex/catalog-auto-refresh.ts +4 -2
  153. package/src/codex/catalog-self-heal.ts +4 -2
  154. package/src/codex/control-plane-models.ts +6 -0
  155. package/src/codex/convergence.ts +10 -0
  156. package/src/codex/desktop-app/picker-freshness.ts +3 -14
  157. package/src/codex/desktop-app/types.ts +6 -0
  158. package/src/codex/desktop-app/windows-command-payload.ts +9 -0
  159. package/src/codex/desktop-app/windows.ts +20 -12
  160. package/src/codex/desktop-compatibility/installed-build.ts +61 -58
  161. package/src/codex/desktop-compatibility/runtime-ownership.ts +11 -5
  162. package/src/codex/desktop-compatibility/runtime.ts +51 -14
  163. package/src/codex/desktop-compatibility/windows-activation-source.ts +28 -13
  164. package/src/codex/desktop-compatibility/windows-package-command.ts +73 -33
  165. package/src/codex/desktop-compatibility/windows-package-launch.ts +41 -9
  166. package/src/codex/desktop-compatibility/windows-package-proof.ts +104 -0
  167. package/src/codex/inject/config-toml.ts +67 -73
  168. package/src/codex/inject/plan.ts +11 -10
  169. package/src/codex/inject/remove.ts +4 -1
  170. package/src/codex/inject.ts +1 -0
  171. package/src/codex/journal-config-restore.ts +31 -4
  172. package/src/codex/journal.ts +16 -4
  173. package/src/codex/model-cache.ts +98 -27
  174. package/src/codex/native-residue.ts +14 -13
  175. package/src/codex/paths.ts +65 -28
  176. package/src/codex/quota-observation-freshness.ts +4 -0
  177. package/src/codex/quota.ts +71 -8
  178. package/src/codex/routing/selection.ts +32 -8
  179. package/src/combos/capability-policy.ts +31 -0
  180. package/src/combos/failover.ts +82 -74
  181. package/src/combos/identifiers.ts +2 -2
  182. package/src/combos/index.ts +3 -0
  183. package/src/combos/jev-model-backend.ts +12 -4
  184. package/src/combos/jev-session-pin-config.ts +22 -9
  185. package/src/combos/jev.ts +15 -4
  186. package/src/combos/request-capability.ts +214 -0
  187. package/src/combos/request.ts +22 -15
  188. package/src/combos/resolve.ts +5 -2
  189. package/src/combos/suggestion-channel.ts +89 -0
  190. package/src/combos/types.ts +14 -1
  191. package/src/config/account-auto-pause-revisions.ts +33 -10
  192. package/src/config/atomic-write.ts +1 -1
  193. package/src/config/codex-ws-incremental-setting.ts +34 -0
  194. package/src/config/diagnostics.ts +47 -8
  195. package/src/config/live-topology.ts +4 -2
  196. package/src/config/load-degrade.ts +96 -2
  197. package/src/config/mutation-lock.ts +7 -3
  198. package/src/config/paths.ts +3 -0
  199. package/src/config/pending-teardown.ts +19 -3
  200. package/src/config/process-state.ts +30 -12
  201. package/src/config/provider-validation.ts +10 -0
  202. package/src/config/salvage.ts +2 -2
  203. package/src/config/schema/account-auto-pause.ts +15 -1
  204. package/src/config/schema/agy-acp-references.ts +257 -0
  205. package/src/config/schema/config-schema.ts +32 -0
  206. package/src/config/schema/leaf-validators.ts +42 -0
  207. package/src/config/schema/subscription-reserve.ts +33 -0
  208. package/src/config/windows-process-command-line.ts +27 -9
  209. package/src/config.ts +6 -0
  210. package/src/generated/compatibility-version.json +806 -402
  211. package/src/images/loop.ts +79 -39
  212. package/src/integrations/catalog-refresh.ts +19 -1
  213. package/src/integrations/gateway-clients/agy.ts +340 -0
  214. package/src/integrations/gateway-clients/antigravity.ts +224 -0
  215. package/src/integrations/gateway-clients/index.ts +89 -0
  216. package/src/integrations/gateway-clients/io.ts +278 -0
  217. package/src/integrations/gateway-clients/types.ts +80 -0
  218. package/src/integrations/route-intent-disconnect.ts +37 -21
  219. package/src/lib/app-owned-memory-stores.ts +9 -0
  220. package/src/lib/cloud-code-appeal-link.ts +30 -0
  221. package/src/lib/errors.ts +32 -0
  222. package/src/lib/executor-physical-send-receipt.ts +42 -0
  223. package/src/lib/failure-detail.ts +1 -0
  224. package/src/lib/gcp-adc.ts +5 -0
  225. package/src/lib/http-date.ts +91 -0
  226. package/src/lib/lab-passive-linker-registration.ts +2 -1
  227. package/src/lib/local-chat-completion.ts +13 -3
  228. package/src/lib/local-internal-call-capability.ts +1 -3
  229. package/src/lib/messages-error-body.ts +2 -1
  230. package/src/lib/outbound-credential-registry.ts +40 -4
  231. package/src/lib/pinned-http.ts +7 -2
  232. package/src/lib/process-control.ts +1 -0
  233. package/src/lib/provider-egress.ts +16 -0
  234. package/src/lib/provider-outbound.ts +3 -0
  235. package/src/lib/redact-folding.ts +12 -3
  236. package/src/lib/redact.ts +37 -19
  237. package/src/lib/request-execution-budget.ts +241 -32
  238. package/src/lib/request-peer-scope.ts +64 -0
  239. package/src/lib/response-send-readings.ts +41 -0
  240. package/src/lib/state-store-registrations.ts +5 -0
  241. package/src/lib/tool-envelope-echo-filter.ts +33 -5
  242. package/src/lib/upstream-condition.ts +10 -3
  243. package/src/lib/upstream-retry.ts +95 -20
  244. package/src/lib/windows-secret-acl.ts +24 -7
  245. package/src/link/child-activity.ts +60 -4
  246. package/src/link/codex-settings.ts +2 -1
  247. package/src/link/relay-auth.ts +1 -0
  248. package/src/link/route-rounds.ts +32 -9
  249. package/src/link/status-projection.ts +42 -5
  250. package/src/link/supervisor.ts +96 -11
  251. package/src/link/tunnel-history.ts +5 -0
  252. package/src/oauth/account-auto-pause-policy.ts +72 -19
  253. package/src/oauth/account-auto-pause.ts +40 -16
  254. package/src/oauth/anthropic-account-refusal.ts +7 -0
  255. package/src/oauth/anthropic-continuity.ts +70 -9
  256. package/src/oauth/anthropic-identity.ts +75 -11
  257. package/src/oauth/anthropic-login-slot.ts +258 -0
  258. package/src/oauth/anthropic-routing.ts +24 -9
  259. package/src/oauth/anthropic-send-ownership.ts +4 -3
  260. package/src/oauth/anthropic.ts +30 -11
  261. package/src/oauth/health.ts +7 -2
  262. package/src/oauth/index.ts +50 -48
  263. package/src/oauth/key-providers.ts +2 -0
  264. package/src/oauth/login-cli.ts +11 -0
  265. package/src/oauth/login-flow-state.ts +10 -4
  266. package/src/oauth/m365-copilot-browser.ts +222 -0
  267. package/src/oauth/m365-copilot-web-session.ts +25 -0
  268. package/src/oauth/m365-copilot.ts +57 -0
  269. package/src/oauth/model-discovery-auth.ts +5 -0
  270. package/src/oauth/plan.ts +44 -0
  271. package/src/oauth/pool-kernel.ts +22 -8
  272. package/src/oauth/pool-settings-capability.ts +14 -3
  273. package/src/oauth/reauth-precheck.ts +27 -0
  274. package/src/oauth/store-anthropic-instance.ts +3 -1
  275. package/src/oauth/store.ts +121 -23
  276. package/src/oauth/types.ts +27 -2
  277. package/src/protocols/codecs/chat-ir.ts +7 -4
  278. package/src/protocols/codecs/gemini-interactions.ts +770 -0
  279. package/src/protocols/codecs/gemini.ts +470 -0
  280. package/src/protocols/contract.ts +2 -0
  281. package/src/protocols/encoders/adapter-events.ts +5 -3
  282. package/src/protocols/encoders/chat.ts +23 -7
  283. package/src/protocols/settings.ts +3 -0
  284. package/src/providers/account-quota-disk.ts +26 -8
  285. package/src/providers/api-key-pause.ts +2 -2
  286. package/src/providers/api-key-response-ownership.ts +14 -4
  287. package/src/providers/claude-cli-usage-state.ts +1 -0
  288. package/src/providers/claude-cli-usage.ts +24 -7
  289. package/src/providers/default-aliases.ts +11 -5
  290. package/src/providers/derive.ts +5 -1
  291. package/src/providers/fastwire.ts +6 -5
  292. package/src/providers/free-directory.ts +2 -2
  293. package/src/providers/google-vertex-location.ts +2 -1
  294. package/src/providers/google-vertex-model-discovery.ts +22 -0
  295. package/src/providers/key-failover.ts +18 -23
  296. package/src/providers/m365-copilot-discovery-fetch.ts +17 -0
  297. package/src/providers/m365-copilot-discovery.ts +68 -0
  298. package/src/providers/m365-copilot-models.ts +32 -0
  299. package/src/providers/model-rename-fields.ts +6 -0
  300. package/src/providers/new-model-policy-runtime.ts +27 -6
  301. package/src/providers/openai-forward-destination.ts +19 -0
  302. package/src/providers/openai-tiers-destination.ts +3 -19
  303. package/src/providers/quota/account-cache.ts +183 -27
  304. package/src/providers/quota/anthropic-account-quota.ts +21 -17
  305. package/src/providers/quota/anthropic-cooldown-recovery.ts +57 -27
  306. package/src/providers/quota/anthropic-decision-windows.ts +7 -3
  307. package/src/providers/quota/anthropic-usage-windows.ts +34 -4
  308. package/src/providers/quota/antigravity-account-probe.ts +165 -0
  309. package/src/providers/quota/antigravity.ts +71 -3
  310. package/src/providers/quota/vendor-probes-oauth.ts +52 -28
  311. package/src/providers/quota-decision-publication.ts +1 -1
  312. package/src/providers/quota-decision-snapshot.ts +4 -1
  313. package/src/providers/quota-types.ts +2 -0
  314. package/src/providers/quota.ts +8 -7
  315. package/src/providers/registry/agy-acp-models.ts +3 -0
  316. package/src/providers/registry/entries-core.ts +9 -0
  317. package/src/providers/registry/entries-extended.ts +60 -0
  318. package/src/providers/registry/model-seeds.ts +51 -0
  319. package/src/providers/request-pacing.ts +37 -7
  320. package/src/providers/service-tier.ts +2 -0
  321. package/src/providers/xai-privacy-mode.ts +52 -0
  322. package/src/remote/hub-management-relay.ts +74 -0
  323. package/src/responses/id-limits.ts +2 -0
  324. package/src/responses/input-media.ts +15 -3
  325. package/src/responses/parser-tools.ts +74 -11
  326. package/src/responses/parser.ts +16 -14
  327. package/src/responses/provider-opaque-metadata.ts +10 -0
  328. package/src/responses/reasoning-envelope.ts +3 -0
  329. package/src/responses/schema.ts +2 -3
  330. package/src/responses/spill-store.ts +5 -3
  331. package/src/responses/state/connection-scope.ts +232 -0
  332. package/src/responses/state/entry-types.ts +47 -0
  333. package/src/responses/state/snapshot-codec.ts +75 -14
  334. package/src/responses/state/snapshot-select.ts +2 -0
  335. package/src/responses/state/spill-codec.ts +59 -0
  336. package/src/responses/state/spill-queue.ts +11 -2
  337. package/src/responses/state.ts +178 -159
  338. package/src/router.ts +2 -6
  339. package/src/routing/compatibility/behavior.ts +6 -2
  340. package/src/routing/compatibility/subject.ts +17 -12
  341. package/src/routing/machine-weighted-routing.ts +58 -0
  342. package/src/server/advisor-admission-scope.ts +15 -7
  343. package/src/server/auth-cors.ts +27 -0
  344. package/src/server/chat-completions.ts +37 -17
  345. package/src/server/chat-native-eligibility.ts +21 -0
  346. package/src/server/chat-native.ts +15 -6
  347. package/src/server/claude-messages.ts +54 -6
  348. package/src/server/credential-recovery-attempt.ts +32 -0
  349. package/src/server/effort-policy.ts +6 -3
  350. package/src/server/gemini-inbound.ts +267 -0
  351. package/src/server/gemini-interactions-inbound.ts +229 -0
  352. package/src/server/gemini-interactions-store.ts +129 -0
  353. package/src/server/gemini-native-catalog.ts +64 -0
  354. package/src/server/gemini-native-log.ts +33 -0
  355. package/src/server/gemini-native-paths.ts +88 -0
  356. package/src/server/gemini-native-wire.ts +201 -0
  357. package/src/server/gemini-native.ts +218 -0
  358. package/src/server/grok-upstream-envelope-echo.ts +8 -2
  359. package/src/server/hub-relay-auth.ts +87 -0
  360. package/src/server/hub-usage-windows.ts +135 -0
  361. package/src/server/hub-usage.ts +16 -3
  362. package/src/server/inbound-body-admission.ts +2 -1
  363. package/src/server/index/anthropic-model-listing.ts +75 -0
  364. package/src/server/index/gemini-routes.ts +147 -0
  365. package/src/server/index/link-management.ts +3 -22
  366. package/src/server/index/link-relay-sessions.ts +71 -13
  367. package/src/server/index/link-websocket.ts +2 -0
  368. package/src/server/index/passive-management-read.ts +55 -0
  369. package/src/server/index/serve-options.ts +93 -107
  370. package/src/server/index/websocket-handler.ts +15 -2
  371. package/src/server/index.ts +10 -0
  372. package/src/server/inference/client-encoder-delivery.ts +2 -1
  373. package/src/server/inference/context.ts +33 -6
  374. package/src/server/management/agent-settings-routes.ts +33 -16
  375. package/src/server/management/claude-code-settings-patch.ts +6 -0
  376. package/src/server/management/combo-routes.ts +21 -1
  377. package/src/server/management/combo-suggestion-routes.ts +212 -0
  378. package/src/server/management/config-routes.ts +12 -4
  379. package/src/server/management/context.ts +2 -0
  380. package/src/server/management/gateway-client-routes.ts +62 -0
  381. package/src/server/management/integration-routes.ts +5 -0
  382. package/src/server/management/link-routes.ts +5 -1
  383. package/src/server/management/m365-copilot-provider-probe.ts +23 -0
  384. package/src/server/management/model-routes.ts +32 -2
  385. package/src/server/management/model-rows.ts +36 -3
  386. package/src/server/management/oauth-account-routes.ts +68 -15
  387. package/src/server/management/protocol-settings-patch.ts +1 -0
  388. package/src/server/management/provider-omitted-fields.ts +25 -0
  389. package/src/server/management/provider-overwrite-carry.ts +33 -8
  390. package/src/server/management/provider-routes.ts +10 -16
  391. package/src/server/management/request-history-routes.ts +2 -2
  392. package/src/server/management/route-registry.ts +10 -0
  393. package/src/server/management/shared.ts +118 -30
  394. package/src/server/management/sibling-guard.ts +2 -1
  395. package/src/server/management/system-routes.ts +6 -0
  396. package/src/server/management-auth.ts +8 -1
  397. package/src/server/messages-native-scope.ts +19 -0
  398. package/src/server/messages-native.ts +156 -59
  399. package/src/server/messages-shared.ts +6 -0
  400. package/src/server/models-capabilities.ts +24 -0
  401. package/src/server/native-chat-bridge.ts +259 -0
  402. package/src/server/ollama-inbound.ts +36 -184
  403. package/src/server/passive-route-linker.ts +3 -1
  404. package/src/server/port-reclaim.ts +48 -4
  405. package/src/server/proxy-liveness.ts +79 -22
  406. package/src/server/relay.ts +16 -9
  407. package/src/server/request-log-account-rotation.ts +2 -1
  408. package/src/server/request-log-attempt-recovery.ts +24 -2
  409. package/src/server/request-log-attempt-usage.ts +5 -4
  410. package/src/server/request-log-committed-terminal.ts +87 -0
  411. package/src/server/request-log-failure-attribution.ts +3 -3
  412. package/src/server/request-log-failure-detail.ts +34 -0
  413. package/src/server/request-log-key-failure.ts +27 -0
  414. package/src/server/request-log-terminal-status.ts +25 -12
  415. package/src/server/request-log.ts +59 -63
  416. package/src/server/responses/adapter-continuation.ts +77 -44
  417. package/src/server/responses/adapter-delivery.ts +47 -22
  418. package/src/server/responses/adapter-dispatch.ts +150 -149
  419. package/src/server/responses/advisor-retention.ts +12 -4
  420. package/src/server/responses/advisor-slot.ts +97 -2
  421. package/src/server/responses/agent-task-recovery.ts +44 -11
  422. package/src/server/responses/agy-acp-preflight.ts +41 -0
  423. package/src/server/responses/anthropic-image-context.ts +44 -0
  424. package/src/server/responses/antigravity-validation-refusal.ts +25 -1
  425. package/src/server/responses/buffered-sse-json.ts +18 -1
  426. package/src/server/responses/codex-ws-correlation.ts +5 -2
  427. package/src/server/responses/codex-ws-exchange.ts +91 -8
  428. package/src/server/responses/codex-ws-incremental.ts +136 -0
  429. package/src/server/responses/codex-ws-pool.ts +22 -8
  430. package/src/server/responses/codex-ws-request.ts +5 -0
  431. package/src/server/responses/codex-ws-send-accounting.ts +8 -0
  432. package/src/server/responses/codex-ws-session.ts +14 -0
  433. package/src/server/responses/codex-ws-wire.ts +44 -22
  434. package/src/server/responses/combo-admission-snapshot.ts +93 -0
  435. package/src/server/responses/combo-required-tool-stream.ts +16 -4
  436. package/src/server/responses/combo-selection-keepalive.ts +5 -0
  437. package/src/server/responses/combo-stream-preflight.ts +182 -73
  438. package/src/server/responses/compact-response-body.ts +27 -0
  439. package/src/server/responses/compact.ts +174 -121
  440. package/src/server/responses/compaction-recovery.ts +7 -0
  441. package/src/server/responses/core-codex-account.ts +88 -62
  442. package/src/server/responses/core-combo-failure.ts +15 -0
  443. package/src/server/responses/core-combo-native.ts +12 -1
  444. package/src/server/responses/core-combo.ts +340 -94
  445. package/src/server/responses/core-normalize.ts +19 -12
  446. package/src/server/responses/core-opaque-recovery.ts +15 -4
  447. package/src/server/responses/core-options.ts +50 -5
  448. package/src/server/responses/core-pipeline.ts +11 -0
  449. package/src/server/responses/core.ts +7 -1
  450. package/src/server/responses/empty-completion-guard.ts +21 -7
  451. package/src/server/responses/estimated-usage.ts +2 -1
  452. package/src/server/responses/fetch-helpers.ts +95 -19
  453. package/src/server/responses/history-slim.ts +204 -0
  454. package/src/server/responses/hosted-advisor-spend.ts +49 -0
  455. package/src/server/responses/image-context-recovery.ts +199 -0
  456. package/src/server/responses/input-admission.ts +36 -11
  457. package/src/server/responses/jev-model-invoke.ts +23 -16
  458. package/src/server/responses/non-replayable-error.ts +12 -2
  459. package/src/server/responses/passthrough-build-error.ts +5 -3
  460. package/src/server/responses/passthrough-delivery.ts +74 -33
  461. package/src/server/responses/passthrough-dispatch.ts +170 -197
  462. package/src/server/responses/policy-fallback.ts +7 -2
  463. package/src/server/responses/policy-request-scope.ts +36 -2
  464. package/src/server/responses/replay-owner.ts +20 -0
  465. package/src/server/responses/request-prepare.ts +97 -16
  466. package/src/server/responses/request-send-budget.ts +97 -25
  467. package/src/server/responses/request-sidecar-auth.ts +138 -65
  468. package/src/server/responses/request-spend-target.ts +13 -1
  469. package/src/server/responses/request-spend.ts +228 -47
  470. package/src/server/responses/request-transport.ts +395 -70
  471. package/src/server/responses/run-turn-execution.ts +40 -9
  472. package/src/server/responses/sidecar-execution.ts +214 -67
  473. package/src/server/responses/sidecar-send-budget.ts +9 -9
  474. package/src/server/responses/terminal-guard.ts +35 -9
  475. package/src/server/responses/ws-upstream.ts +27 -6
  476. package/src/server/responses-phase-inference.ts +32 -9
  477. package/src/server/responses-terminal-repair.ts +14 -35
  478. package/src/server/system-env.ts +8 -5
  479. package/src/server/ws-bridge.ts +23 -17
  480. package/src/service/health-sentinel-linux.ts +16 -7
  481. package/src/service/systemd.ts +11 -2
  482. package/src/service/windows-checked-stop-live.ts +60 -55
  483. package/src/service/windows-checked-stop.ts +29 -11
  484. package/src/service/windows-guarded-manager.ts +14 -26
  485. package/src/service/windows-process-evidence.ts +82 -74
  486. package/src/service/windows-process-native.ts +69 -20
  487. package/src/service/windows-service-stop.ts +14 -12
  488. package/src/service/windows-stop-binding.ts +14 -5
  489. package/src/service/windows-stop-confirm.ts +1 -1
  490. package/src/service/windows-task-instance-stop.ts +98 -0
  491. package/src/service/windows-taskxml.ts +30 -7
  492. package/src/sidecar/anthropic-binding.ts +1 -1
  493. package/src/stall-timeout.ts +30 -0
  494. package/src/telemetry/aggregate.ts +6 -3
  495. package/src/types/account-auto-pause.ts +19 -1
  496. package/src/types/accounts.ts +21 -0
  497. package/src/types/anthropic-account-pool.ts +1 -1
  498. package/src/types/combo-capability-policy.ts +19 -0
  499. package/src/types/config.ts +22 -2
  500. package/src/types/provider.ts +42 -8
  501. package/src/types/request.ts +15 -0
  502. package/src/types/tools.ts +22 -5
  503. package/src/types/wire.ts +1 -0
  504. package/src/types.ts +4 -0
  505. package/src/update/check-types.ts +2 -0
  506. package/src/update/job.ts +8 -3
  507. package/src/update/managed-release.ts +6 -0
  508. package/src/update/orchestrated-entry.ts +13 -4
  509. package/src/update/refresh-scheduler.ts +17 -7
  510. package/src/usage/attempt-delivery.ts +6 -0
  511. package/src/usage/cache-provenance.ts +71 -0
  512. package/src/usage/cost.ts +216 -27
  513. package/src/usage/credit-billing.ts +88 -0
  514. package/src/usage/jev-stats.ts +13 -9
  515. package/src/usage/log.ts +5 -33
  516. package/src/usage/summary.ts +8 -43
  517. package/src/usage/user-cost-overlays.ts +13 -1
  518. package/src/vision/index.ts +8 -3
  519. package/src/vision/plan.ts +28 -14
  520. package/src/vision/routed-describe.ts +24 -36
  521. package/src/web-search/header-deadline.ts +14 -3
  522. package/src/web-search/index.ts +6 -4
  523. package/src/web-search/loop.ts +240 -78
  524. package/src/web-search/progress-stream.ts +29 -2
  525. package/src/web-search/run-turn-loop.ts +5 -1
  526. package/gui/dist/assets/App-BGP8I0V4.css +0 -1
  527. package/gui/dist/assets/App-BRExzhwL.js +0 -60
  528. package/gui/dist/assets/Tray-DHCWAn8V.js +0 -1
  529. package/gui/dist/assets/brand-mark-C70PuQ3j.js +0 -1
  530. package/gui/dist/assets/index-DJxM-imn.css +0 -2
  531. package/gui/dist/assets/index-Dy1jIGty.js +0 -138
  532. package/gui/dist/classic/assets/App-B4j-Txmb.css +0 -1
  533. package/gui/dist/classic/assets/App-CaC-E6Vl.js +0 -59
  534. package/gui/dist/classic/assets/Tray-BG253fiL.js +0 -1
  535. package/gui/dist/classic/assets/index-CR_AThOp.js +0 -138
  536. package/gui/dist/classic/assets/quota-summary-B7KQPpEC.js +0 -1
@@ -0,0 +1,278 @@
1
+ import { createHash } from "node:crypto";
2
+ import {
3
+ closeSync, existsSync, fchmodSync, fsyncSync, lstatSync, mkdirSync, openSync, realpathSync,
4
+ rmSync, rmdirSync, statSync, unlinkSync, writeFileSync,
5
+ } from "node:fs";
6
+ import { basename, dirname, isAbsolute, join, relative, sep } from "node:path";
7
+ import {
8
+ atomicWriteFileNoFollowStreamed, isMissingPathError, nextAtomicTempSequence, syncParentDirectory,
9
+ } from "../../config/atomic-write";
10
+ import { withConfigMutationLockSync } from "../../config/mutation-lock";
11
+ import { readBoundedRegularFileSync } from "../../lib/bounded-file-read";
12
+ import { parseJsonc } from "../../lib/jsonc";
13
+ import { assertNotRealCodexHomeUnderTest, assertNotRealHomeUnderTest } from "../../lib/test-home-guard";
14
+ import { renameAtomicFile } from "../../lib/windows-atomic-replace";
15
+ import type { GatewayClientContext, GatewayClientResult, GatewayOverride } from "./types";
16
+
17
+ export const GATEWAY_PLACEHOLDER_KEY = "opencodex-local";
18
+ const MAX_CLIENT_BYTES = 4 * 1024 * 1024;
19
+ // Restore records include base64 copies of up to three profiles or both settings and parsed prior values.
20
+ const MAX_STASH_BYTES = 32 * 1024 * 1024;
21
+
22
+ export const sha256 = (bytes: Uint8Array): string => createHash("sha256").update(bytes).digest("hex");
23
+
24
+ export interface ClientFile {
25
+ target: string;
26
+ bytes: Buffer;
27
+ hash: string;
28
+ }
29
+
30
+ /** Resolve the existing prefix even when a new client file or directory is needed. */
31
+ function resolveClientPath(path: string): string {
32
+ try { return realpathSync(path); }
33
+ catch (error) {
34
+ const parent = dirname(path);
35
+ if (!isMissingPathError(error) || parent === path) throw error;
36
+ if (lstatSync(path, { throwIfNoEntry: false })?.isSymbolicLink()) {
37
+ throw new Error(`Refusing an unresolvable gateway client symlink: ${path}`);
38
+ }
39
+ return join(resolveClientPath(parent), basename(path));
40
+ }
41
+ }
42
+
43
+ function underCanonicalHome(ctx: GatewayClientContext, path: string): string {
44
+ const subpath = relative(ctx.home, path);
45
+ if (subpath === ".." || subpath.startsWith(`..${sep}`) || isAbsolute(subpath)) {
46
+ throw new Error(`Gateway client path is outside the home directory: ${path}`);
47
+ }
48
+ return join(realpathSync(ctx.home), subpath);
49
+ }
50
+
51
+ /** Compare the resolved file against the fixed names under the canonical home. */
52
+ function clientDestination(ctx: GatewayClientContext, path: string, allowedPaths: readonly string[]): string {
53
+ const parent = dirname(path);
54
+ if (relative(underCanonicalHome(ctx, parent), resolveClientPath(parent)) !== "") {
55
+ throw new Error(`Gateway client file resolves outside the allowed client directory: ${path}`);
56
+ }
57
+ const target = resolveClientPath(path);
58
+ // Following links in the allowlist would let a redirected profile authorize its own destination.
59
+ if (!allowedPaths.some(allowed => relative(underCanonicalHome(ctx, allowed), target) === "")) {
60
+ throw new Error(`Gateway client file resolves outside the allowed client paths: ${path}`);
61
+ }
62
+ return target;
63
+ }
64
+
65
+ function readClientDestination(target: string): ClientFile | null {
66
+ try {
67
+ const bytes = readBoundedRegularFileSync(target, MAX_CLIENT_BYTES);
68
+ return { target, bytes, hash: sha256(bytes) };
69
+ } catch (error) {
70
+ if (isMissingPathError(error)) return null;
71
+ throw error;
72
+ }
73
+ }
74
+
75
+ export function readClientFile(ctx: GatewayClientContext, path: string, allowedPaths: readonly string[] = [path]): ClientFile | null {
76
+ return readClientDestination(clientDestination(ctx, path, allowedPaths));
77
+ }
78
+
79
+ /** Inspect a candidate without failing status or recovery when it cannot be resolved or read. */
80
+ export function inspectClientFile(ctx: GatewayClientContext, path: string, allowedPaths: readonly string[] = [path]): ClientFile | null | undefined {
81
+ try { return readClientFile(ctx, path, allowedPaths); } catch { return undefined; }
82
+ }
83
+
84
+ export function assertClientSize(bytes: Uint8Array): void {
85
+ if (bytes.length > MAX_CLIENT_BYTES) throw new Error("Gateway client file would exceed the 4 MiB limit");
86
+ }
87
+
88
+ export function checkedClientDestination(ctx: GatewayClientContext, path: string, original: ClientFile | null, allowedPaths: readonly string[] = [path], destination = original?.target): string {
89
+ const target = clientDestination(ctx, path, allowedPaths);
90
+ const current = readClientDestination(target);
91
+ if (original?.hash !== current?.hash || (destination !== undefined && destination !== target)) {
92
+ throw new Error(`Gateway client file changed before update: ${path}`);
93
+ }
94
+ return target;
95
+ }
96
+
97
+ /** Replace the resolved client file using the directory's inherited Windows ACL. */
98
+ export function writeClientFile(ctx: GatewayClientContext, path: string, original: ClientFile | null, bytes: Uint8Array, allowedPaths: readonly string[] = [path]): void {
99
+ assertClientSize(bytes);
100
+ const target = checkedClientDestination(ctx, path, original, allowedPaths);
101
+ const dir = dirname(target);
102
+ assertNotRealHomeUnderTest(dir);
103
+ assertNotRealCodexHomeUnderTest(dir);
104
+ const mode = original && process.platform !== "win32" ? statSync(target).mode & 0o777 : 0o644;
105
+ const temp = join(dir, `.${basename(target)}.ocx-${process.pid}-${nextAtomicTempSequence()}.tmp`);
106
+ const fd = openSync(temp, "wx", 0o600);
107
+ try {
108
+ try {
109
+ writeFileSync(fd, bytes);
110
+ if (process.platform !== "win32") fchmodSync(fd, mode);
111
+ fsyncSync(fd);
112
+ } finally { closeSync(fd); }
113
+ renameAtomicFile(temp, target, undefined, "config", {
114
+ validateBeforeRename: destination => { checkedClientDestination(ctx, path, original, allowedPaths, destination); },
115
+ });
116
+ } catch (error) {
117
+ try { unlinkSync(temp); } catch (cleanup) {
118
+ if (!isMissingPathError(cleanup)) throw new AggregateError([error, cleanup], "Could not update the gateway client or remove its temporary file");
119
+ }
120
+ throw error;
121
+ }
122
+ syncParentDirectory(target);
123
+ }
124
+
125
+ export function removeCreatedClientFile(ctx: GatewayClientContext, path: string, original: ClientFile, allowedPaths: readonly string[] = [path]): void {
126
+ if (lstatSync(path).isSymbolicLink()) throw new Error(`Refusing to remove a symlinked gateway client file: ${path}`);
127
+ checkedClientDestination(ctx, path, original, allowedPaths);
128
+ assertNotRealHomeUnderTest(dirname(original.target));
129
+ assertNotRealCodexHomeUnderTest(dirname(original.target));
130
+ unlinkSync(original.target);
131
+ syncParentDirectory(original.target);
132
+ }
133
+
134
+ export function clientRefusal(message: string, code: GatewayClientResult["code"] = "io-error", changedFiles: string[] = []): GatewayClientResult {
135
+ return { ok: false, code, message, changed: changedFiles.length > 0, changedFiles, notes: [] };
136
+ }
137
+
138
+ export function mutateClient(ctx: GatewayClientContext, work: () => GatewayClientResult): GatewayClientResult {
139
+ try { return withConfigMutationLockSync(work, ctx.stateDir); }
140
+ catch (error) { return clientRefusal((error as Error).message); }
141
+ }
142
+
143
+ /** Create `dir` (and parents); returns the directories that did not exist before, outermost first. */
144
+ export function mkdirTracked(dir: string): string[] {
145
+ const created: string[] = [];
146
+ for (let cur = dir; !existsSync(cur); cur = dirname(cur)) created.unshift(cur);
147
+ mkdirSync(dir, { recursive: true });
148
+ return created;
149
+ }
150
+
151
+ /** Remove the directories this connector created, deepest first, only while empty. */
152
+ export function rmdirsIfEmpty(ctx: GatewayClientContext, dirs: readonly string[]): void {
153
+ for (const dir of [...dirs].reverse()) {
154
+ try {
155
+ const allowed = underCanonicalHome(ctx, dir);
156
+ if (relative(allowed, realpathSync(dir)) === "") rmdirSync(allowed);
157
+ } catch { /* gone or not empty */ }
158
+ }
159
+ }
160
+
161
+ function stashDirectory(ctx: GatewayClientContext): string {
162
+ return join(ctx.stateDir, "gateway-clients");
163
+ }
164
+
165
+ export function stashPath(ctx: GatewayClientContext, id: string): string {
166
+ return join(stashDirectory(ctx), `${id}.json`);
167
+ }
168
+
169
+ function assertStashDirectory(path: string): void {
170
+ if (!lstatSync(dirname(path)).isDirectory()) throw new Error("Gateway restore record directory is not a regular directory");
171
+ }
172
+
173
+ export function hasStash(ctx: GatewayClientContext, id: string): boolean {
174
+ const path = stashPath(ctx, id);
175
+ try {
176
+ assertStashDirectory(path);
177
+ lstatSync(path);
178
+ return true;
179
+ } catch (error) {
180
+ if (isMissingPathError(error)) return false;
181
+ throw error;
182
+ }
183
+ }
184
+
185
+ export function readStash<T>(ctx: GatewayClientContext, id: string): T | null {
186
+ const path = stashPath(ctx, id);
187
+ try {
188
+ assertStashDirectory(path);
189
+ const bytes = readBoundedRegularFileSync(path, MAX_STASH_BYTES);
190
+ const value = JSON.parse(bytes.toString("utf8")) as { version?: number } & T;
191
+ if (value?.version !== 1) throw new Error("Unknown gateway restore record version");
192
+ return value;
193
+ } catch (error) {
194
+ if (isMissingPathError(error)) return null;
195
+ throw error;
196
+ }
197
+ }
198
+
199
+ export function inspectStashPresence(ctx: GatewayClientContext, id: string): boolean {
200
+ try { return hasStash(ctx, id); } catch { return true; }
201
+ }
202
+
203
+ export function writeStash(ctx: GatewayClientContext, id: string, value: object): void {
204
+ const path = stashPath(ctx, id);
205
+ const bytes = Buffer.from(`${JSON.stringify(value)}\n`);
206
+ if (bytes.length > MAX_STASH_BYTES) throw new Error("Gateway restore record would exceed its size limit");
207
+ mkdirSync(dirname(path), { recursive: true, mode: 0o700 });
208
+ assertStashDirectory(path);
209
+ atomicWriteFileNoFollowStreamed(path, fd => writeFileSync(fd, bytes));
210
+ }
211
+
212
+ export function dropStash(ctx: GatewayClientContext, id: string): void {
213
+ const path = stashPath(ctx, id);
214
+ assertStashDirectory(path);
215
+ rmSync(path, { force: true });
216
+ removeEmptyStashDirectory(ctx);
217
+ }
218
+
219
+ export function removeEmptyStashDirectory(ctx: GatewayClientContext): void {
220
+ const dir = stashDirectory(ctx);
221
+ try {
222
+ if (lstatSync(dir).isDirectory()) rmdirSync(dir);
223
+ } catch (error) {
224
+ const code = (error as NodeJS.ErrnoException).code;
225
+ if (code !== "ENOENT" && code !== "ENOTEMPTY" && code !== "EEXIST") throw error;
226
+ }
227
+ }
228
+
229
+ export function isRestoreFile(home: string, path: string, record: {
230
+ originalBytes: unknown; createdDirs: unknown; resolvedPath?: unknown;
231
+ }): boolean {
232
+ const allowedDirs: string[] = [];
233
+ for (let dir = dirname(path); relative(home, dir) !== "" && dir !== dirname(dir); dir = dirname(dir)) allowedDirs.push(dir);
234
+ return (record.originalBytes === null || typeof record.originalBytes === "string")
235
+ && (record.resolvedPath === undefined || typeof record.resolvedPath === "string")
236
+ && Array.isArray(record.createdDirs) && record.createdDirs.every(dir => allowedDirs.includes(dir));
237
+ }
238
+
239
+ export const normalizeUrl = (url: unknown): string => typeof url === "string" ? url.trim().replace(/\/+$/, "") : "";
240
+
241
+ /** Where an organisation's admin_settings.json lives (Google's enterprise gateway docs). */
242
+ export function adminSettingsPath(ctx: GatewayClientContext): string | undefined {
243
+ if (ctx.adminSettingsPath) return ctx.adminSettingsPath;
244
+ if (ctx.platform === "win32") {
245
+ const base = ctx.env.ProgramData;
246
+ return base ? join(base, "Antigravity", "admin_settings.json") : undefined;
247
+ }
248
+ return ctx.platform === "darwin"
249
+ ? "/Library/Application Support/Antigravity/admin_settings.json"
250
+ : "/etc/antigravity/admin_settings.json";
251
+ }
252
+
253
+ /** What admin_settings.json sets under `gateway`, or null when nothing. */
254
+ export function adminGatewayOverride(ctx: GatewayClientContext): GatewayOverride | null {
255
+ const path = adminSettingsPath(ctx);
256
+ if (!path) return null;
257
+ let gateway: unknown;
258
+ try {
259
+ // A missing file is no override; EACCES or a parse failure is an unknown one, never a thrown status.
260
+ const bytes = readBoundedRegularFileSync(resolveClientPath(path), MAX_CLIENT_BYTES);
261
+ gateway = (parseJsonc(bytes.toString("utf8")) as { gateway?: unknown } | null)?.gateway;
262
+ } catch (error) {
263
+ if (isMissingPathError(error)) return null;
264
+ return { source: "admin_settings", code: "admin-unreadable", detail: "admin_settings.json exists but could not be read, so its gateway settings are unknown" };
265
+ }
266
+ if (!gateway || typeof gateway !== "object" || Object.keys(gateway).length === 0) return null;
267
+ return { source: "admin_settings", code: "admin-gateway", detail: "organization admin_settings.json sets the gateway and wins over the user settings and AGY_LLM_GATEWAY_* variables" };
268
+ }
269
+
270
+ /** The env override, or null. Only the environment of the process OpenCodex runs in is visible. */
271
+ export function envGatewayOverride(ctx: GatewayClientContext, targetUrl?: string): GatewayOverride | null {
272
+ const raw = ctx.env.AGY_LLM_GATEWAY_URL?.trim();
273
+ if (!raw) return null;
274
+ if (targetUrl && normalizeUrl(raw) === normalizeUrl(targetUrl)) return null;
275
+ let shown = "an unparseable value";
276
+ try { shown = new URL(raw).origin; } catch { /* keep generic */ }
277
+ return { source: "env", code: "env-gateway", detail: `AGY_LLM_GATEWAY_URL is set to ${shown} in the environment OpenCodex sees (other shells are not checked) and wins over ~/.antigravity/settings.json` };
278
+ }
@@ -0,0 +1,80 @@
1
+ /** Connectors that point a Google client at OpenCodex's gateway (Antigravity app, agy CLI). */
2
+ export type GatewayClientId = "antigravity" | "agy";
3
+
4
+ export interface GatewayClientContext {
5
+ home: string;
6
+ platform: NodeJS.Platform;
7
+ env: NodeJS.ProcessEnv;
8
+ /** OpenCodex config dir; stash files live in `<stateDir>/gateway-clients/`. */
9
+ stateDir: string;
10
+ /** Override for tests; defaults to the platform's admin_settings.json location. */
11
+ adminSettingsPath?: string;
12
+ /** Isolated lifecycle lock for tests. Production uses the effective user lock. */
13
+ lifecycleLockPath?: string;
14
+ }
15
+
16
+ export interface GatewayTarget {
17
+ url: string;
18
+ apiKey: string;
19
+ defaultModel?: string;
20
+ }
21
+
22
+ /**
23
+ * Every note a connector can attach, keyed by a stable code. The CLI prints `text`; the dashboard
24
+ * translates `code`, so the English here is the source for both and no caller parses it.
25
+ */
26
+ export const GATEWAY_NOTE_TEXT = {
27
+ "restart-app": "Restart Antigravity to apply a change.",
28
+ "no-google-sign-in": "In gateway mode the app does not use the Google sign-in.",
29
+ "agy-follows-app": "agy follows this file unless it is connected on its own.",
30
+ "settings-not-json": "settings.json is not strict JSON (comments, trailing commas or a syntax error). OpenCodex will not rewrite a file it cannot round-trip; fix or simplify it, then connect again.",
31
+ "settings-not-object": "settings.json does not hold a JSON object, so OpenCodex left it untouched.",
32
+ "no-restore-record": "No restore record exists (connected outside OpenCodex), so disconnect cannot restore your previous settings.",
33
+ "new-terminal": "Open a new terminal to pick up the agy function.",
34
+ "agy-version": "Gateway support needs agy 1.2.15 or newer.",
35
+ "windows-unverified": "Google documents the agy gateway for macOS and Linux. The Windows build also reads the AGY_LLM_GATEWAY_* settings, but this path has not been verified end to end on Windows.",
36
+ "agy-env-exported": "AGY_LLM_GATEWAY_URL is exported globally in the environment OpenCodex sees; the agy function overrides it for agy only.",
37
+ } as const;
38
+ export type GatewayNoteCode = keyof typeof GATEWAY_NOTE_TEXT;
39
+ export interface GatewayNote { code: GatewayNoteCode; text: string }
40
+ export const gatewayNote = (code: GatewayNoteCode): GatewayNote => ({ code, text: GATEWAY_NOTE_TEXT[code] });
41
+
42
+ /** `code` names the override for the dashboard; `detail` is the CLI's English line and never echoes a secret. */
43
+ export interface GatewayOverride {
44
+ source: "admin_settings" | "env";
45
+ code: "admin-gateway" | "admin-unreadable" | "env-gateway";
46
+ detail: string;
47
+ }
48
+
49
+ export interface GatewayClientStatus {
50
+ id: GatewayClientId;
51
+ label: string;
52
+ state: "connected" | "disconnected" | "drifted";
53
+ files: { path: string; role: string; exists: boolean }[];
54
+ overrides: GatewayOverride[];
55
+ notes: GatewayNote[];
56
+ /** Antigravity only: `models.defaultModelId` as the settings file holds it now. */
57
+ defaultModel?: string;
58
+ }
59
+
60
+ export type GatewayRefusalCode = "unsupported-file" | "agy-profile-restore-required" | "io-error";
61
+
62
+ export interface GatewayClientResult {
63
+ ok: boolean;
64
+ code?: GatewayRefusalCode;
65
+ /** Home-relative display path for an agy profile that needs repair. */
66
+ profilePath?: string;
67
+ message: string;
68
+ changed: boolean;
69
+ changedFiles: string[];
70
+ restore?: "exact" | "path-wise" | "none";
71
+ notes: GatewayNote[];
72
+ }
73
+
74
+ export interface GatewayClientConnector {
75
+ id: GatewayClientId;
76
+ label: string;
77
+ status(ctx: GatewayClientContext, target?: GatewayTarget): GatewayClientStatus;
78
+ connect(ctx: GatewayClientContext, target: GatewayTarget): GatewayClientResult;
79
+ disconnect(ctx: GatewayClientContext): GatewayClientResult;
80
+ }
@@ -1,4 +1,4 @@
1
- /** File clients drain before disconnect removes its connection and service credential. */
1
+ /** Receipt-bound file cleanup shared by stop and disconnect. */
2
2
  import { loadConfig } from "../config";
3
3
  import { lstatSync } from "node:fs";
4
4
  import { readClientConnectionState, sameClientConnectionOwner } from "../client/state";
@@ -8,6 +8,7 @@ import { readServiceApiTokenState } from "../lib/service-secrets";
8
8
  import { readLocalRouteIntentOff, readRouteIntentReceiptStrict, readRouteIntentUnappliedProof } from "./route-intent-state";
9
9
  import { homeRouteIntentPath } from "../client/link-home";
10
10
  import type { OcxClientConnectionConfig } from "../types";
11
+ import type { RouteIntentReceipt } from "./route-intent-contract";
11
12
 
12
13
  /** Droid's empty-roster contribution has no selectors, so its generic classifier cannot prove absence. */
13
14
  async function droidRoutingAbsent(port: number): Promise<boolean> {
@@ -33,9 +34,8 @@ async function droidRoutingAbsent(port: number): Promise<boolean> {
33
34
  } catch { return false; }
34
35
  }
35
36
 
36
- export async function cleanupConnectedRouteIntent(
37
- connection: OcxClientConnectionConfig, expected: DesktopDisconnectReceipt, lifecycleLockDeps?: ClientLifecycleLockDeps, recoverConflicts = false,
38
- ): Promise<void> {
37
+ /** Read-only ownership/absence proof. Callers still fence every subsequent file write. */
38
+ export async function readConnectedFileRouteIntentForCleanup(connection: OcxClientConnectionConfig): Promise<RouteIntentReceipt | null> {
39
39
  const receipt = readRouteIntentReceiptStrict();
40
40
  if (!receipt) {
41
41
  let homeReceiptPresent = false;
@@ -63,28 +63,25 @@ export async function cleanupConnectedRouteIntent(
63
63
  && (!isIntegrationClientId(id) || readIntegrationState({ clientId: id, config, port: config.port, models: [], store }).state !== "absent"));
64
64
  const droidUnproved = connection.selectedClients.includes("droid") && !standalone("droid") && !await droidRoutingAbsent(config.port);
65
65
  if (homeReceiptPresent || owned || unproved || droidUnproved) {
66
- throw new Error("Route intent cleanup receipt is missing; preserve the connection and repair its route ownership evidence before disconnect");
66
+ throw new Error("Route intent cleanup receipt is missing; preserve the connection and repair its route ownership evidence before retrying cleanup");
67
67
  }
68
68
  }
69
- return;
69
+ return null;
70
70
  }
71
71
  // A valid unbound receipt is standalone Home state, not evidence of a Child apply.
72
- if (receipt.linkId === undefined) return;
73
- if (!connection.link || receipt.linkId !== connection.link.linkId) throw new Error("Route intent cleanup receipt belongs to another context; preserve it before disconnect");
74
- const guard = () => {
75
- const pending = readDesktopDisconnectReceipt();
76
- const current = readClientConnectionState();
77
- const token = readServiceApiTokenState();
78
- if (pending.kind !== "valid" || JSON.stringify(pending.value) !== JSON.stringify(expected)
79
- || current.kind !== "connected" || !sameClientConnectionOwner(current.value, connection)
80
- || current.value.pendingOperation || token.kind !== "present" || token.fingerprint !== connection.tokenFingerprint) {
81
- throw new Error("client_disconnect_owner_changed");
82
- }
83
- };
72
+ if (receipt.linkId === undefined) return null;
73
+ if (!connection.link || receipt.linkId !== connection.link.linkId) throw new Error("Route intent cleanup receipt belongs to another context; preserve it before retrying cleanup");
74
+ return receipt;
75
+ }
76
+
77
+ /** Shared file-only cleanup; the caller supplies its stop or disconnect ownership fence. */
78
+ export async function cleanupConnectedFileRouteIntent(
79
+ connection: OcxClientConnectionConfig, guard: () => void, lifecycleLockDeps?: ClientLifecycleLockDeps, recoverConflicts = false,
80
+ ): Promise<boolean> {
81
+ const receipt = await readConnectedFileRouteIntentForCleanup(connection);
82
+ if (!receipt || !connection.link) return false;
84
83
  const local = loadConfig();
85
84
  const { cleanupRouteIntent } = await import("./route-intent");
86
- const { stripGrokConfig } = await import("../grok/inject");
87
- const { injectClaudeAgentDefs } = await import("../claude/agents-inject");
88
85
  const config = { ...local, hostname: "127.0.0.1", unauthenticatedLoopbackListener: undefined };
89
86
  // Integrations the Child owned before this link come back instead of being removed; a local
90
87
  // opt-out is the person's own later choice and wins.
@@ -96,7 +93,26 @@ export async function cleanupConnectedRouteIntent(
96
93
  const outcomes = await cleanupRouteIntent({ config, linkId: connection.link.linkId, document: receipt.document, models: receipt.models ?? [], beforeWrite: guard, recoverConflicts,
97
94
  withReceiptWrite: write => withClientLifecycleSync(() => { guard(); write(); }, lifecycleLockDeps),
98
95
  withFileWrites: work => withClientLifecycle(work, lifecycleLockDeps) }, standalone);
99
- if (outcomes.some(row => row.outcome !== "current")) throw new Error("Route intent cleanup was partial; ownership and disconnect receipts retained. Repair the conflicting client and rerun ocx disconnect.");
96
+ if (outcomes.some(row => row.outcome !== "current")) throw new Error("Route intent cleanup was partial; ownership and recovery receipts retained. Repair the conflicting client and retry cleanup.");
97
+ return true;
98
+ }
99
+
100
+ export async function cleanupConnectedRouteIntent(
101
+ connection: OcxClientConnectionConfig, expected: DesktopDisconnectReceipt, lifecycleLockDeps?: ClientLifecycleLockDeps, recoverConflicts = false,
102
+ ): Promise<void> {
103
+ const guard = () => {
104
+ const pending = readDesktopDisconnectReceipt();
105
+ const current = readClientConnectionState();
106
+ const token = readServiceApiTokenState();
107
+ if (pending.kind !== "valid" || JSON.stringify(pending.value) !== JSON.stringify(expected)
108
+ || current.kind !== "connected" || !sameClientConnectionOwner(current.value, connection)
109
+ || current.value.pendingOperation || token.kind !== "present" || token.fingerprint !== connection.tokenFingerprint) {
110
+ throw new Error("client_disconnect_owner_changed");
111
+ }
112
+ };
113
+ if (!await cleanupConnectedFileRouteIntent(connection, guard, lifecycleLockDeps, recoverConflicts)) return;
114
+ const { stripGrokConfig } = await import("../grok/inject");
115
+ const { injectClaudeAgentDefs } = await import("../claude/agents-inject");
100
116
  withClientLifecycleSync(() => {
101
117
  guard();
102
118
  const grok = stripGrokConfig();
@@ -55,6 +55,7 @@ import { imageFulfillmentTailSnapshot } from "../images/fulfill";
55
55
  import { oauthMutationTailSnapshot } from "../oauth/store";
56
56
  import { grokApplyFlightSnapshot } from "../server/management/agent-settings-routes";
57
57
  import { nativeControlReplayRetainedStoreSnapshot } from "../server/responses/native-steering-replay";
58
+ import { evictOldestInteractionForBudget, interactionsRetainedStoreSnapshot } from "../server/gemini-interactions-store";
58
59
 
59
60
  function ringSnapshot(metrics: { entries: number; bytes: number; oldestAt: number | null }): RetainedStoreSnapshot {
60
61
  return {
@@ -192,6 +193,14 @@ export const APP_OWNED_RETAINED_STORE_REGISTRATIONS = [
192
193
  snapshot: responseContinuationRetainedStoreSnapshot,
193
194
  evictOldest: evictOldestResponseContinuationForBudget,
194
195
  },
196
+ {
197
+ // Stored Gemini interactions (previous_interaction_id history); eviction only frees memory.
198
+ id: "gemini_interactions",
199
+ category: "continuation",
200
+ snapshot: interactionsRetainedStoreSnapshot,
201
+ evictOldest: evictOldestInteractionForBudget,
202
+ passiveEvictable: true,
203
+ },
195
204
  {
196
205
  id: "native_control_replay",
197
206
  category: "continuation",
@@ -0,0 +1,30 @@
1
+ const MAX_APPEAL_URL_LENGTH = 512;
2
+ // Check the literal authority as well: URL drops an explicit :443 and empty userinfo.
3
+ const APPEAL_AUTHORITY = /^https:\/\/(?:forms\.gle|support\.google\.com|docs\.google\.com)(?=[/?#]|$)/i;
4
+
5
+ export function normalizeCloudCodeAppealUrl(value: unknown): string | undefined {
6
+ if (typeof value !== "string" || value.length > MAX_APPEAL_URL_LENGTH
7
+ || /[\s\\\p{C}]/u.test(value) || !APPEAL_AUTHORITY.test(value)) return;
8
+ let url: URL;
9
+ try { url = new URL(value); } catch { return; }
10
+ if (url.protocol !== "https:" || url.username || url.password || url.port) return;
11
+ switch (url.hostname) {
12
+ case "docs.google.com":
13
+ if (!url.pathname.startsWith("/forms/")) return;
14
+ break;
15
+ case "forms.gle":
16
+ break;
17
+ case "support.google.com":
18
+ url.search = "";
19
+ break;
20
+ default:
21
+ return;
22
+ }
23
+ url.hash = "";
24
+ return url.href.length <= MAX_APPEAL_URL_LENGTH ? url.href : undefined;
25
+ }
26
+
27
+ export function normalizeCloudCodeAppealText(value: unknown): string | undefined {
28
+ if (typeof value !== "string" || value.length > 80 || /[<>\p{C}\p{Zl}\p{Zp}]/u.test(value)) return;
29
+ return value.trim() || undefined;
30
+ }
package/src/lib/errors.ts CHANGED
@@ -28,6 +28,8 @@ export const SPEND_LEDGER_STORAGE_UNAVAILABLE_CODE = "spend_ledger_storage_unava
28
28
  export const UNDECLARED_TOOL_CALL_ERROR_CODE = "undeclared_tool_call";
29
29
  /** A buffered combo child completed without the call explicitly required by tool_choice. */
30
30
  export const REQUIRED_TOOL_CONTRACT_CODE = "required_tool_contract_unsatisfied";
31
+ /** A combo child ended its turn carrying only reasoning/commentary prelude — no tool call or final answer. */
32
+ export const COMBO_DEGENERATE_COMPLETION_CODE = "degenerate_completion";
31
33
 
32
34
  /**
33
35
  * Wire code for a provider's model-scoped plan refusal (#7684): the account's plan does not
@@ -89,6 +91,34 @@ export function namesModelNotInPlanCode(code: string | null | undefined): boolea
89
91
  return typeof code === "string" && code.trim().toLowerCase().replaceAll("-", "_") === MODEL_NOT_IN_PLAN_CODE;
90
92
  }
91
93
 
94
+ type CompletionError = { type?: string; code?: string; message?: string };
95
+
96
+ /** Meaningful error evidence on either carrier overrides an SSE completion. */
97
+ export function responsesCompletionError(payload: unknown): CompletionError | undefined {
98
+ if (!payload || typeof payload !== "object" || Array.isArray(payload)) return undefined;
99
+ const event = payload as {
100
+ type?: unknown;
101
+ error?: unknown;
102
+ last_error?: unknown;
103
+ response?: { error?: unknown; last_error?: unknown };
104
+ };
105
+ if (event.type !== "response.completed") return undefined;
106
+ const nonblank = (value: unknown): string | undefined =>
107
+ typeof value === "string" && value.trim() ? value : undefined;
108
+ for (const candidate of [event.error, event.last_error, event.response?.error, event.response?.last_error]) {
109
+ if (typeof candidate === "string") {
110
+ if (nonblank(candidate)) return { message: candidate };
111
+ } else if (candidate && typeof candidate === "object" && !Array.isArray(candidate)) {
112
+ const record = candidate as Record<string, unknown>;
113
+ const type = nonblank(record.type);
114
+ const code = nonblank(record.code);
115
+ const message = nonblank(record.message);
116
+ if (type || code || message) return { type, code, message };
117
+ }
118
+ }
119
+ return undefined;
120
+ }
121
+
92
122
  /** First nonblank string across the canonical upstream error paths, in priority order. */
93
123
  export function upstreamErrorMessageFromPayload(payload: unknown): string | undefined {
94
124
  if (!payload || typeof payload !== "object" || Array.isArray(payload)) return undefined;
@@ -99,12 +129,14 @@ export function upstreamErrorMessageFromPayload(payload: unknown): string | unde
99
129
  last_error?: { message?: unknown };
100
130
  response?: {
101
131
  error?: { message?: unknown };
132
+ last_error?: { message?: unknown };
102
133
  incomplete_details?: { message?: unknown };
103
134
  };
104
135
  };
105
136
  const messages = [json.error?.message,
106
137
  json.last_error?.message,
107
138
  json.response?.error?.message,
139
+ json.response?.last_error?.message,
108
140
  json.response?.incomplete_details?.message,
109
141
  // The Responses stream error event carries a flat message (type/code/message),
110
142
  // unlike the response.failed envelope the branches above already cover.
@@ -0,0 +1,42 @@
1
+ export const EXECUTOR_PHYSICAL_SEND_RECEIPT = Symbol("executor physical send receipt");
2
+ const receiptExecutors = new WeakSet<typeof globalThis.fetch>();
3
+
4
+ export function markPhysicalSendReceiptExecutor<T extends typeof globalThis.fetch>(executor: T): T {
5
+ receiptExecutors.add(executor);
6
+ return executor;
7
+ }
8
+
9
+ /** Use the executor's final admission when it owns the transport's remaining guards. */
10
+ export function fetchWithPhysicalSendReceipt(
11
+ executor: typeof globalThis.fetch,
12
+ input: Parameters<typeof globalThis.fetch>[0],
13
+ init: RequestInit | undefined,
14
+ receipt: () => void,
15
+ ): Promise<Response> {
16
+ if (receiptExecutors.has(executor)) {
17
+ return executor(input, { ...init, [EXECUTOR_PHYSICAL_SEND_RECEIPT]: receipt } as RequestInit);
18
+ }
19
+ receipt();
20
+ return executor(input, init);
21
+ }
22
+
23
+ const supportExecutors = new WeakMap<typeof globalThis.fetch, () => typeof globalThis.fetch>();
24
+
25
+ export function registerAdapterSupportExecutor(executor: typeof globalThis.fetch, support: () => typeof globalThis.fetch): void {
26
+ supportExecutors.set(executor, support);
27
+ }
28
+
29
+ /** Carry the lazy support transport across an inference-only wrapper. */
30
+ export function inheritAdapterSupportExecutor<T extends typeof globalThis.fetch>(
31
+ wrapped: T,
32
+ source: typeof globalThis.fetch,
33
+ ): T {
34
+ const support = supportExecutors.get(source);
35
+ if (support) registerAdapterSupportExecutor(wrapped, support);
36
+ return wrapped;
37
+ }
38
+
39
+ /** Keep the provider's transport and pacing policy for auxiliary HTTP calls. */
40
+ export function adapterSupportExecutor(executor: typeof globalThis.fetch): typeof globalThis.fetch {
41
+ return supportExecutors.get(executor)?.() ?? executor;
42
+ }
@@ -43,6 +43,7 @@ export const FAILURE_DETAIL_FINISH_REASONS = [
43
43
  "FINISH_REASON_UNSPECIFIED", "STOP", "MAX_TOKENS", "SAFETY", "RECITATION", "LANGUAGE", "OTHER", "BLOCKLIST",
44
44
  "PROHIBITED_CONTENT", "SPII", "MALFORMED_FUNCTION_CALL", "IMAGE_SAFETY", "IMAGE_PROHIBITED_CONTENT",
45
45
  "IMAGE_RECITATION", "IMAGE_OTHER", "NO_IMAGE", "UNEXPECTED_TOOL_CALL", "TOO_MANY_TOOL_CALLS",
46
+ "MALFORMED_RESPONSE", "MISSING_THOUGHT_SIGNATURE",
46
47
  ] as const;
47
48
 
48
49
  export type FailureDetailFinishReason = typeof FAILURE_DETAIL_FINISH_REASONS[number];
@@ -280,6 +280,11 @@ function observeAdcSource(markerAccount: string | undefined): { source: string;
280
280
  return next;
281
281
  }
282
282
 
283
+ /** Observe the local ADC source without exchanging a token. */
284
+ export function observeVertexAdcGeneration(markerAccount?: string): number {
285
+ return observeAdcSource(markerAccount).generation;
286
+ }
287
+
283
288
  function base64UrlEncode(bytes: Uint8Array | string): string {
284
289
  const buf = typeof bytes === "string" ? Buffer.from(bytes, "utf8") : Buffer.from(bytes);
285
290
  return buf.toString("base64url");