@bitkyc08/opencodex 2.100.2 → 2.100.4

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 (644) hide show
  1. package/AGENTS_INSTALL.md +23 -1
  2. package/README.md +1 -1
  3. package/bin/ocx.mjs +40 -19
  4. package/gui/dist/assets/{App-COo8Yopd.css → App-BGP8I0V4.css} +1 -1
  5. package/gui/dist/assets/App-DcpyI78f.js +60 -0
  6. package/gui/dist/assets/{Tray-BcaI-VCr.js → Tray-CzjPJprT.js} +1 -1
  7. package/gui/dist/assets/brand-mark-BTIi7e69.js +1 -0
  8. package/gui/dist/assets/index-DJxM-imn.css +2 -0
  9. package/gui/dist/assets/index-DVgU6S3y.js +138 -0
  10. package/gui/dist/assets/{segment-thumb-features-e9A_FogJ.js → segment-thumb-features-Bn6Y-g3R.js} +1 -1
  11. package/gui/dist/classic/assets/App-eYJAyNHM.js +59 -0
  12. package/gui/dist/classic/assets/{Tray-DT146AhS.js → Tray-xHMYxLkV.js} +1 -1
  13. package/gui/dist/classic/assets/index-DSaVRW4F.js +138 -0
  14. package/gui/dist/classic/assets/quota-summary-DyzHlkFl.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.toml +9 -0
  18. package/native/ocx-child/src/cli.rs +404 -20
  19. package/native/ocx-child/src/codex_home.rs +99 -14
  20. package/native/ocx-child/src/daemon.rs +2 -1
  21. package/native/ocx-child/src/lib.rs +3 -0
  22. package/native/ocx-child/src/link_ws.rs +2598 -0
  23. package/native/ocx-child/src/link_ws_advert.rs +346 -0
  24. package/native/ocx-child/src/link_ws_frame.rs +749 -0
  25. package/native/ocx-child/src/parity.rs +5 -1
  26. package/native/ocx-child/src/platform.rs +152 -6
  27. package/native/ocx-child/src/relay.rs +150 -19
  28. package/package.json +3 -3
  29. package/src/adapters/anthropic/advisor-tool.ts +176 -0
  30. package/src/adapters/anthropic/beta-body-pairs.ts +6 -0
  31. package/src/adapters/anthropic/client-identity.ts +3 -1
  32. package/src/adapters/anthropic/passthrough.ts +9 -3
  33. package/src/adapters/anthropic/per-message-effort.ts +296 -0
  34. package/src/adapters/anthropic.ts +34 -14
  35. package/src/adapters/claude-cli/adapter.ts +1 -0
  36. package/src/adapters/client-fingerprint.ts +3 -3
  37. package/src/adapters/cursor/discovery.ts +17 -0
  38. package/src/adapters/cursor/native-exec-desktop.ts +2 -1
  39. package/src/adapters/cursor/native-exec-shell.ts +2 -1
  40. package/src/adapters/cursor/protobuf-request.ts +8 -8
  41. package/src/adapters/cursor.ts +7 -6
  42. package/src/adapters/devin/cloud-direct/chat.ts +71 -14
  43. package/src/adapters/google-antigravity-wire.ts +7 -5
  44. package/src/adapters/google-errors.ts +14 -2
  45. package/src/adapters/google-wire-compiler.ts +2 -2
  46. package/src/adapters/google.ts +9 -2
  47. package/src/adapters/kiro/payload.ts +7 -4
  48. package/src/adapters/kiro/reasoning.ts +44 -1
  49. package/src/adapters/kiro/structured-output.ts +10 -8
  50. package/src/adapters/kiro-tools.ts +61 -15
  51. package/src/adapters/openai-chat/destination-policy.ts +16 -0
  52. package/src/adapters/openai-chat/reasoning-replay.ts +4 -1
  53. package/src/adapters/qoder/adapter.ts +9 -1
  54. package/src/adapters/zed.ts +7 -2
  55. package/src/advisor/consult.ts +15 -4
  56. package/src/advisor/context.ts +12 -3
  57. package/src/advisor/runtime.ts +35 -5
  58. package/src/advisor/settings.ts +8 -0
  59. package/src/advisor/synthetic-tool.ts +21 -8
  60. package/src/bridge/response-json.ts +11 -2
  61. package/src/bridge/sse.ts +43 -8
  62. package/src/claude/auth-detect.ts +21 -33
  63. package/src/claude/desktop-3p.ts +11 -5
  64. package/src/claude/desktop-gateway-state.ts +2 -0
  65. package/src/claude/desktop-remote-store-artifact.ts +14 -3
  66. package/src/claude/desktop-remote-store.ts +82 -12
  67. package/src/claude/inbound-content-options.ts +31 -16
  68. package/src/claude/outbound.ts +13 -3
  69. package/src/cli/account-api.ts +21 -1
  70. package/src/cli/account-auth.ts +83 -22
  71. package/src/cli/account-extended.ts +33 -2
  72. package/src/cli/account-key-quota.ts +34 -5
  73. package/src/cli/account.ts +4 -2
  74. package/src/cli/advisor.ts +7 -4
  75. package/src/cli/alias.ts +38 -1
  76. package/src/cli/capabilities-access-remote.ts +128 -3
  77. package/src/cli/capabilities-accounts.ts +6 -6
  78. package/src/cli/capabilities-agents-routing.ts +17 -10
  79. package/src/cli/capabilities-base.ts +49 -19
  80. package/src/cli/capabilities-integrations.ts +2 -2
  81. package/src/cli/capabilities-observe-system.ts +2 -2
  82. package/src/cli/capabilities-provider-models.ts +18 -2
  83. package/src/cli/capabilities-route-to.ts +43 -0
  84. package/src/cli/capabilities.ts +2 -0
  85. package/src/cli/capability-contracts.ts +1 -1
  86. package/src/cli/claude-desktop.ts +30 -11
  87. package/src/cli/claude.ts +17 -3
  88. package/src/cli/codex-launcher.ts +3 -1
  89. package/src/cli/codex-shim-autorestore.ts +5 -42
  90. package/src/cli/config-command.ts +14 -1
  91. package/src/cli/config-root-startup.ts +34 -0
  92. package/src/cli/connect.ts +88 -16
  93. package/src/cli/desktop-runtime-guidance.ts +1 -1
  94. package/src/cli/disconnect-runtime.ts +178 -0
  95. package/src/cli/dispatch.ts +61 -13
  96. package/src/cli/export-command.ts +1 -1
  97. package/src/cli/gui-pair-client.ts +6 -3
  98. package/src/cli/gui.ts +10 -5
  99. package/src/cli/help-catalog.ts +11 -0
  100. package/src/cli/help.ts +4 -3
  101. package/src/cli/index.ts +85 -94
  102. package/src/cli/inspect.ts +11 -2
  103. package/src/cli/integrations.ts +26 -1
  104. package/src/cli/link-apply-restart.ts +4 -2
  105. package/src/cli/link-capture.ts +64 -0
  106. package/src/cli/link-child-ops.ts +218 -40
  107. package/src/cli/link-cleanup.ts +8 -5
  108. package/src/cli/link-diagnostics.ts +67 -0
  109. package/src/cli/link-enrollment.ts +158 -12
  110. package/src/cli/link-operations.ts +52 -0
  111. package/src/cli/link-recover.ts +152 -0
  112. package/src/cli/link-routes.ts +90 -0
  113. package/src/cli/link-status-child.ts +44 -1
  114. package/src/cli/link-status-traffic.ts +34 -0
  115. package/src/cli/link.ts +315 -37
  116. package/src/cli/message-command.ts +1 -1
  117. package/src/cli/message-mcp-command.ts +23 -10
  118. package/src/cli/models-runtime.ts +3 -3
  119. package/src/cli/opencode.ts +3 -1
  120. package/src/cli/pi-sync.ts +35 -0
  121. package/src/cli/preflight-exemptions.ts +49 -0
  122. package/src/cli/registry.ts +33 -14
  123. package/src/cli/resolve.ts +23 -8
  124. package/src/cli/restart-failure.ts +15 -2
  125. package/src/cli/root.ts +5 -1
  126. package/src/cli/route-to.ts +172 -0
  127. package/src/cli/runtime-api.ts +9 -8
  128. package/src/cli/status.ts +7 -2
  129. package/src/cli/stop-approval.ts +66 -19
  130. package/src/cli/stop-report.ts +23 -0
  131. package/src/cli/stop-windows-checked.ts +304 -0
  132. package/src/cli/sync-command.ts +70 -15
  133. package/src/cli/sync-fanout.ts +74 -19
  134. package/src/cli/sync-flags.ts +40 -3
  135. package/src/cli/sync-link-status.ts +18 -2
  136. package/src/cli/sync-update-guard.ts +7 -2
  137. package/src/cli/system-command.ts +1 -1
  138. package/src/cli/system-restart-client.ts +10 -3
  139. package/src/cli/system-settings-parity.ts +2 -1
  140. package/src/cli/uninstall-plan.ts +77 -5
  141. package/src/cli/uninstall-stop.ts +152 -0
  142. package/src/cli/v2-input.ts +10 -6
  143. package/src/cli/v2-local-output.ts +3 -2
  144. package/src/cli/v2-runtime.ts +10 -3
  145. package/src/cli/v2.ts +22 -7
  146. package/src/client/connect.ts +376 -35
  147. package/src/client/desktop-refusal.ts +38 -0
  148. package/src/client/lifecycle-lock.ts +29 -4
  149. package/src/client/link-home-features.ts +27 -0
  150. package/src/client/link-home.ts +92 -4
  151. package/src/client/link-ingress.ts +21 -3
  152. package/src/client/link-join.ts +12 -2
  153. package/src/client/link-parity-reporter.ts +60 -6
  154. package/src/client/link-relay-transport.ts +161 -36
  155. package/src/client/link-relay.ts +150 -6
  156. package/src/client/link-request-compression.ts +84 -0
  157. package/src/client/link-state.ts +11 -5
  158. package/src/client/link-status.ts +39 -1
  159. package/src/client/link-teardown.ts +1 -0
  160. package/src/client/link-tunnel.ts +56 -5
  161. package/src/client/link-websocket-limits.ts +89 -0
  162. package/src/client/link-websocket.ts +586 -0
  163. package/src/client/link-ws-advertisement.ts +100 -0
  164. package/src/client/link-ws-framer.ts +241 -0
  165. package/src/client/link-ws-transport.ts +177 -0
  166. package/src/client/machine-api.ts +13 -2
  167. package/src/client/machine-listener.ts +48 -7
  168. package/src/client/route-intent-apply.ts +293 -0
  169. package/src/client/route-intent-file-originals.ts +97 -0
  170. package/src/client/route-intent-native-originals.ts +201 -0
  171. package/src/client/route-intent-watch.ts +141 -0
  172. package/src/client/runtime-restart.ts +141 -7
  173. package/src/client/runtime.ts +63 -15
  174. package/src/client/state.ts +44 -0
  175. package/src/client/sync-expectation.ts +36 -2
  176. package/src/client/sync-runtime.ts +7 -0
  177. package/src/clients/config-export/alias-selectors.ts +63 -40
  178. package/src/clients/config-export/contracts.ts +2 -0
  179. package/src/clients/config-export/nested-selectors.ts +42 -0
  180. package/src/clients/config-export.ts +22 -3
  181. package/src/codex/account-pause.ts +4 -0
  182. package/src/codex/account-runtime-state.ts +4 -0
  183. package/src/codex/account-store.ts +12 -3
  184. package/src/codex/account-usability.ts +13 -0
  185. package/src/codex/auth-api/account-list.ts +29 -3
  186. package/src/codex/auth-api/main-account-probe.ts +3 -1
  187. package/src/codex/auth-api/main-hard-lock-refusal-read.ts +172 -0
  188. package/src/codex/auth-collision.ts +23 -22
  189. package/src/codex/auth-context.ts +61 -8
  190. package/src/codex/catalog/build-entries.ts +10 -0
  191. package/src/codex/catalog/derive-entry.ts +7 -0
  192. package/src/codex/catalog/gather-capture.ts +8 -2
  193. package/src/codex/catalog/parsing.ts +7 -3
  194. package/src/codex/catalog/provider-models.ts +54 -15
  195. package/src/codex/catalog/reserve-warn.ts +7 -5
  196. package/src/codex/catalog/reserve.ts +4 -3
  197. package/src/codex/catalog/retained-sync.ts +4 -1
  198. package/src/codex/catalog/routed-defaults.ts +35 -0
  199. package/src/codex/catalog/routed-gather.ts +1 -1
  200. package/src/codex/catalog-auto-refresh.ts +11 -0
  201. package/src/codex/cli-update-job.ts +35 -13
  202. package/src/codex/convergence.ts +4 -2
  203. package/src/codex/desktop-compatibility/native-identity.ts +4 -8
  204. package/src/codex/features.ts +2 -2
  205. package/src/codex/history-provider.ts +31 -0
  206. package/src/codex/inject/multi-agent-v2.ts +9 -3
  207. package/src/codex/inject/paginated-openai-compat.ts +54 -1
  208. package/src/codex/inject/plan.ts +20 -2
  209. package/src/codex/inject.ts +2 -0
  210. package/src/codex/journal-config-restore.ts +217 -0
  211. package/src/codex/journal.ts +75 -6
  212. package/src/codex/loopback-target.ts +22 -8
  213. package/src/codex/main-account.ts +109 -57
  214. package/src/codex/native-main-auth-file.ts +118 -0
  215. package/src/codex/native-main-credentials.ts +270 -0
  216. package/src/codex/native-main-owner.ts +3 -0
  217. package/src/codex/native-main-refresh-mode.ts +14 -1
  218. package/src/codex/native-profile-manager.ts +4 -3
  219. package/src/codex/native-profile-store.ts +3 -61
  220. package/src/codex/orca-import.ts +10 -1
  221. package/src/codex/quota-history.ts +13 -0
  222. package/src/codex/quota-window-conflict.ts +103 -0
  223. package/src/codex/quota.ts +86 -15
  224. package/src/codex/subagent-model-fallback.ts +3 -1
  225. package/src/codex/websocket-activity.ts +171 -16
  226. package/src/codex/websocket-registry.ts +11 -4
  227. package/src/combos/cooldown-store.ts +25 -5
  228. package/src/combos/failover.ts +342 -3
  229. package/src/combos/index.ts +5 -0
  230. package/src/combos/resolve.ts +115 -19
  231. package/src/config/dashboard-trusted-proxy.ts +83 -0
  232. package/src/config/diagnostics.ts +31 -0
  233. package/src/config/feature-flags.ts +9 -0
  234. package/src/config/live-reconcile.ts +16 -4
  235. package/src/config/load-degrade.ts +14 -1
  236. package/src/config/multi-agent-surface.ts +28 -5
  237. package/src/config/pending-teardown.ts +60 -3
  238. package/src/config/persisted-mutation.ts +2 -2
  239. package/src/config/persisted-projections.ts +18 -0
  240. package/src/config/process-state.ts +176 -4
  241. package/src/config/provider-validation.ts +4 -4
  242. package/src/config/reserve-capability.ts +96 -0
  243. package/src/config/schema/config-schema.ts +12 -0
  244. package/src/config/schema/leaf-validators.ts +11 -2
  245. package/src/config/schema/routed-catalog-defaults.ts +49 -0
  246. package/src/config/windows-process-command-line.ts +107 -0
  247. package/src/config.ts +7 -7
  248. package/src/desktop-update/acquire.ts +202 -0
  249. package/src/desktop-update/cli.ts +168 -0
  250. package/src/desktop-update/drain.ts +40 -0
  251. package/src/desktop-update/headless.ts +285 -0
  252. package/src/desktop-update/image.ts +85 -0
  253. package/src/desktop-update/install.ts +53 -0
  254. package/src/desktop-update/msi.ts +72 -0
  255. package/src/desktop-update/release.ts +128 -0
  256. package/src/desktop-update/runtime.ts +155 -0
  257. package/src/desktop-update/staging.ts +118 -0
  258. package/src/desktop-update/trust.ts +45 -0
  259. package/src/generated/compatibility-version.json +1114 -442
  260. package/src/generated/model-metadata.ts +1 -1
  261. package/src/images/fulfill-video.ts +3 -3
  262. package/src/images/loop.ts +9 -2
  263. package/src/images/plan.ts +147 -11
  264. package/src/images/types.ts +13 -4
  265. package/src/images/xai-video-client.ts +72 -10
  266. package/src/integrations/model-name-guard.ts +25 -0
  267. package/src/integrations/route-intent-catalog.ts +26 -0
  268. package/src/integrations/route-intent-connected.ts +262 -0
  269. package/src/integrations/route-intent-contract.ts +55 -0
  270. package/src/integrations/route-intent-disconnect.ts +109 -0
  271. package/src/integrations/route-intent-initial.ts +64 -0
  272. package/src/integrations/route-intent-state.ts +117 -0
  273. package/src/integrations/route-intent-tick.ts +65 -0
  274. package/src/integrations/route-intent.ts +212 -0
  275. package/src/integrations/writer.ts +44 -11
  276. package/src/lib/client-retry-after.ts +29 -0
  277. package/src/lib/config-ownership.ts +13 -0
  278. package/src/lib/desktop-gui-origin.ts +28 -0
  279. package/src/lib/errors.ts +1 -1
  280. package/src/lib/gcp-adc.ts +48 -4
  281. package/src/lib/gui-pair-capability.ts +2 -1
  282. package/src/lib/messages-error-body.ts +4 -1
  283. package/src/lib/offline-resend.ts +150 -0
  284. package/src/lib/outbound-credential-registry.ts +362 -4
  285. package/src/lib/paced-stream.ts +34 -0
  286. package/src/lib/passive-key-fetch-proof.ts +30 -0
  287. package/src/lib/passive-read.ts +5 -0
  288. package/src/lib/process-control.ts +76 -12
  289. package/src/lib/provider-outbound.ts +17 -6
  290. package/src/lib/redact.ts +84 -8
  291. package/src/lib/request-failure-model.ts +2 -0
  292. package/src/lib/response-body-inactivity.ts +23 -1
  293. package/src/lib/state-store-registrations.ts +11 -0
  294. package/src/lib/state-store-sweeper.ts +4 -0
  295. package/src/lib/supervisor-markers.ts +18 -0
  296. package/src/lib/terminal-safe-text.ts +58 -0
  297. package/src/lib/translator-budget.ts +3 -2
  298. package/src/lib/upstream-retry.ts +52 -9
  299. package/src/link/alias-lock.ts +119 -0
  300. package/src/link/child-activity.ts +28 -2
  301. package/src/link/child-binary-cache-fill.d.mts +50 -0
  302. package/src/link/child-binary-cache-fill.mjs +494 -0
  303. package/src/link/child-binary-cache-start.ts +73 -0
  304. package/src/link/child-binary-source.ts +12 -5
  305. package/src/link/child-gated-ocx.ts +29 -11
  306. package/src/link/child-observations.ts +2 -1
  307. package/src/link/child-observe.ts +2 -2
  308. package/src/link/child-ops-engine.ts +159 -91
  309. package/src/link/child-ops-host.ts +138 -0
  310. package/src/link/child-ops-runners.ts +319 -0
  311. package/src/link/child-ops-scheduler.ts +207 -0
  312. package/src/link/child-ops-types.ts +89 -0
  313. package/src/link/child-parity.ts +23 -4
  314. package/src/link/child-policy.ts +93 -0
  315. package/src/link/child-update-contract.ts +12 -3
  316. package/src/link/codex-settings.ts +1 -1
  317. package/src/link/compatibility.ts +18 -1
  318. package/src/link/diagnostics-read.ts +163 -0
  319. package/src/link/diagnostics.ts +20 -7
  320. package/src/link/explicit-route.ts +209 -0
  321. package/src/link/link-recover.ts +113 -0
  322. package/src/link/management-routes.ts +3 -1
  323. package/src/link/operation-recovery-slot.ts +44 -0
  324. package/src/link/operations-journal.ts +408 -0
  325. package/src/link/peer-report.ts +1 -1
  326. package/src/link/relay-auth.ts +14 -0
  327. package/src/link/remote-plant.ts +152 -14
  328. package/src/link/remote-platform.ts +21 -10
  329. package/src/link/remote-probe.ts +11 -3
  330. package/src/link/remote-windows.ts +124 -36
  331. package/src/link/request-compression.ts +30 -0
  332. package/src/link/residual-recovery.ts +66 -0
  333. package/src/link/retirement.ts +128 -0
  334. package/src/link/route-intent-watch.ts +41 -0
  335. package/src/link/route-intent.ts +209 -0
  336. package/src/link/route-proof.ts +82 -0
  337. package/src/link/route-rounds.ts +579 -0
  338. package/src/link/route-select.ts +95 -0
  339. package/src/link/route-trust.ts +96 -0
  340. package/src/link/ssh-argv.ts +172 -24
  341. package/src/link/ssh-capture-redact.ts +253 -0
  342. package/src/link/ssh-capture.ts +497 -0
  343. package/src/link/ssh-runner.ts +141 -14
  344. package/src/link/status-projection.ts +87 -0
  345. package/src/link/store.ts +54 -1
  346. package/src/link/supervisor.ts +543 -55
  347. package/src/link/sync-fanout-classify.ts +16 -0
  348. package/src/link/sync-then-restart.ts +65 -0
  349. package/src/link/tombstones.ts +209 -0
  350. package/src/link/traffic.ts +178 -0
  351. package/src/link/ws-activity-holds.ts +474 -0
  352. package/src/local-credentials/publication-fence.ts +20 -1
  353. package/src/messaging/budget.ts +23 -5
  354. package/src/messaging/mcp-queue-rpc.ts +1 -1
  355. package/src/messaging/mcp-queue-server.ts +16 -1
  356. package/src/messaging/mcp-resume-tools.ts +25 -0
  357. package/src/messaging/remote-enrollment.ts +3 -3
  358. package/src/messaging/remote-tunnels.ts +2 -2
  359. package/src/messaging/resume-permissions.ts +27 -0
  360. package/src/messaging/rpc.ts +50 -6
  361. package/src/oauth/anthropic-continuity.ts +23 -7
  362. package/src/oauth/anthropic-routing.ts +5 -2
  363. package/src/oauth/anthropic.ts +22 -2
  364. package/src/oauth/antigravity-risk.ts +126 -0
  365. package/src/oauth/claude-keychain-read.ts +78 -68
  366. package/src/oauth/generic-account-failover.ts +89 -18
  367. package/src/oauth/generic-session-affinity.ts +10 -3
  368. package/src/oauth/index.ts +24 -6
  369. package/src/oauth/local-token-detect.ts +8 -29
  370. package/src/oauth/login-cli-errors.ts +5 -1
  371. package/src/oauth/login-cli.ts +68 -19
  372. package/src/oauth/login-flow-state.ts +26 -3
  373. package/src/oauth/meta-muse.ts +1 -1
  374. package/src/oauth/pool-kernel.ts +3 -3
  375. package/src/oauth/store.ts +7 -0
  376. package/src/oauth/xai.ts +248 -14
  377. package/src/protocols/contract.ts +4 -0
  378. package/src/protocols/encoders/messages.ts +1 -0
  379. package/src/providers/alias-template.ts +48 -0
  380. package/src/providers/anthropic-billing-ownership.ts +2 -0
  381. package/src/providers/anthropic-billing-refusal.ts +27 -3
  382. package/src/providers/anthropic-output-caps.ts +46 -0
  383. package/src/providers/anthropic-reset-grant-ledger.ts +9 -3
  384. package/src/providers/antigravity-effort-families.ts +11 -3
  385. package/src/providers/antigravity-models.ts +32 -9
  386. package/src/providers/antigravity-wire-snapshot.ts +3 -2
  387. package/src/providers/api-key-pause.ts +3 -0
  388. package/src/providers/api-key-resolve.ts +49 -7
  389. package/src/providers/api-key-response-ownership.ts +2 -0
  390. package/src/providers/api-key-selection.ts +51 -9
  391. package/src/providers/api-keys.ts +6 -2
  392. package/src/providers/cache-affinity-identity.ts +73 -0
  393. package/src/providers/cache-affinity.ts +256 -0
  394. package/src/providers/default-aliases.ts +98 -20
  395. package/src/providers/google-vertex-model-discovery.ts +515 -0
  396. package/src/providers/key-failover.ts +123 -8
  397. package/src/providers/key-store.ts +3 -3
  398. package/src/providers/kiro-models.ts +3 -5
  399. package/src/providers/label.ts +31 -5
  400. package/src/providers/mistral-transport.ts +17 -4
  401. package/src/providers/model-rename-fields.ts +5 -0
  402. package/src/providers/muse-key-quota.ts +14 -6
  403. package/src/providers/new-model-policy-runtime.ts +17 -4
  404. package/src/providers/new-model-policy.ts +30 -4
  405. package/src/providers/passive-key-observation.ts +252 -0
  406. package/src/providers/quota/account-cache.ts +2 -1
  407. package/src/providers/quota/anthropic-cooldown-recovery-worker.ts +121 -0
  408. package/src/providers/quota/passive-key-limits.ts +272 -0
  409. package/src/providers/quota/passive-wire-model.ts +126 -0
  410. package/src/providers/quota/report-cache.ts +61 -2
  411. package/src/providers/quota/workbuddy.ts +6 -2
  412. package/src/providers/quota-key-accounts.ts +11 -6
  413. package/src/providers/quota-types.ts +18 -0
  414. package/src/providers/quota.ts +11 -12
  415. package/src/providers/registry/entries-core.ts +34 -16
  416. package/src/providers/registry/entries-extended.ts +32 -0
  417. package/src/providers/registry/model-seeds.ts +35 -0
  418. package/src/providers/resolved-model-policy.ts +7 -0
  419. package/src/providers/routed-config.ts +8 -3
  420. package/src/providers/workbuddy-credit-balance.ts +125 -16
  421. package/src/providers/xai-transport.ts +3 -0
  422. package/src/remote/features.ts +17 -0
  423. package/src/responses/anthropic-progress.ts +10 -4
  424. package/src/responses/citation-markers.ts +231 -0
  425. package/src/responses/effort-history.ts +732 -0
  426. package/src/responses/spill-store.ts +5 -1
  427. package/src/responses/state/replay-input.ts +50 -0
  428. package/src/responses/state/replay-owner.ts +24 -0
  429. package/src/responses/state/snapshot-codec.ts +9 -0
  430. package/src/responses/state/spill-queue.ts +1 -0
  431. package/src/responses/state.ts +42 -60
  432. package/src/router.ts +2 -2
  433. package/src/routing/history/integrity.ts +41 -4
  434. package/src/routing/home-route-capture.ts +123 -0
  435. package/src/routing/home-route-intent.ts +200 -0
  436. package/src/routing/route-intent-state.ts +178 -0
  437. package/src/routing/route-to-live-settings.ts +35 -0
  438. package/src/routing/route-to-local.ts +145 -0
  439. package/src/routing/route-to-status.ts +94 -0
  440. package/src/routing/route-to-sync-child.ts +32 -0
  441. package/src/server/adapter-resolve.ts +21 -1
  442. package/src/server/admitted-http-turn.ts +3 -0
  443. package/src/server/auth-cors.ts +111 -3
  444. package/src/server/bare-upstream-error.ts +220 -0
  445. package/src/server/chat-native.ts +14 -5
  446. package/src/server/claude-messages.ts +6 -4
  447. package/src/server/codex-model-list.ts +4 -2
  448. package/src/server/configured-credentials.ts +37 -5
  449. package/src/server/direct-local-http.ts +26 -3
  450. package/src/server/gui-desktop-authorization.ts +36 -0
  451. package/src/server/gui-pair-delivery.ts +6 -3
  452. package/src/server/gui-session.ts +10 -1
  453. package/src/server/inbound-body-admission.ts +17 -4
  454. package/src/server/index/link-listener.ts +196 -12
  455. package/src/server/index/link-management.ts +15 -1
  456. package/src/server/index/link-relay-sessions.ts +87 -8
  457. package/src/server/index/link-websocket-limits.ts +136 -0
  458. package/src/server/index/link-websocket.ts +692 -0
  459. package/src/server/index/optional-listeners.ts +97 -7
  460. package/src/server/index/route-intent-watch.ts +47 -0
  461. package/src/server/index/serve-contract.ts +86 -0
  462. package/src/server/index/serve-options.ts +36 -86
  463. package/src/server/index/startup-warnings.ts +8 -2
  464. package/src/server/index/websocket-handler.ts +26 -4
  465. package/src/server/index.ts +15 -4
  466. package/src/server/inference/client-encoder-delivery.ts +2 -0
  467. package/src/server/inspection-tee.ts +39 -2
  468. package/src/server/lifecycle.ts +2 -0
  469. package/src/server/link-turn.ts +149 -0
  470. package/src/server/management/advisor-routes.ts +10 -2
  471. package/src/server/management/agent-settings-routes.ts +50 -16
  472. package/src/server/management/anthropic-reset-grant-routes.ts +1 -1
  473. package/src/server/management/config-routes.ts +39 -3
  474. package/src/server/management/context.ts +9 -2
  475. package/src/server/management/desktop-authorization.ts +41 -0
  476. package/src/server/management/desktop-compatibility-routes.ts +9 -8
  477. package/src/server/management/desktop-compatibility-runtime-routes.ts +3 -2
  478. package/src/server/management/desktop-compatibility-settings-routes.ts +5 -3
  479. package/src/server/management/home-integration-decision.ts +89 -0
  480. package/src/server/management/integration-routes.ts +208 -81
  481. package/src/server/management/link-child-ops-routes.ts +145 -43
  482. package/src/server/management/link-child-preflight.ts +31 -0
  483. package/src/server/management/link-diagnostics-route.ts +29 -0
  484. package/src/server/management/link-enrollment.ts +199 -47
  485. package/src/server/management/link-operation.ts +609 -0
  486. package/src/server/management/link-recover-route.ts +103 -0
  487. package/src/server/management/link-route-edit.ts +192 -0
  488. package/src/server/management/link-route-request.ts +62 -0
  489. package/src/server/management/link-route-state.ts +83 -7
  490. package/src/server/management/link-routes.ts +553 -51
  491. package/src/server/management/link-traffic-status.ts +13 -0
  492. package/src/server/management/model-routes.ts +122 -36
  493. package/src/server/management/model-rows.ts +2 -1
  494. package/src/server/management/native-integration-routes.ts +176 -70
  495. package/src/server/management/oauth-account-routes.ts +58 -18
  496. package/src/server/management/protocol-routes.ts +7 -0
  497. package/src/server/management/provider-completion-test.ts +4 -4
  498. package/src/server/management/provider-overwrite-carry.ts +14 -0
  499. package/src/server/management/provider-routes.ts +68 -65
  500. package/src/server/management/provider-routing-quota.ts +45 -0
  501. package/src/server/management/route-registry.ts +22 -3
  502. package/src/server/management/route-to-routes.ts +257 -0
  503. package/src/server/management/static-catalog-probe.ts +33 -0
  504. package/src/server/management/system-restart.ts +4 -2
  505. package/src/server/management/usage-aggregate-cache.ts +101 -66
  506. package/src/server/management-api.ts +17 -3
  507. package/src/server/management-auth.ts +13 -1
  508. package/src/server/messages-native-preflight.ts +27 -4
  509. package/src/server/messages-native.ts +17 -5
  510. package/src/server/persistent-gui-session.ts +6 -3
  511. package/src/server/proxy-liveness.ts +87 -15
  512. package/src/server/relay-eager.ts +36 -12
  513. package/src/server/relay.ts +189 -117
  514. package/src/server/request-body-facts.ts +48 -0
  515. package/src/server/request-decompress.ts +65 -2
  516. package/src/server/request-log-account-rotation.ts +6 -0
  517. package/src/server/request-log-attempt-usage.ts +69 -0
  518. package/src/server/request-log-cache-affinity.ts +60 -0
  519. package/src/server/request-log-conversation.ts +45 -2
  520. package/src/server/request-log-terminal-status.ts +210 -24
  521. package/src/server/request-log.ts +76 -80
  522. package/src/server/reserve-capability-startup.ts +32 -0
  523. package/src/server/responses/adapter-continuation.ts +2 -1
  524. package/src/server/responses/adapter-delivery.ts +4 -0
  525. package/src/server/responses/adapter-dispatch.ts +36 -17
  526. package/src/server/responses/advisor-plan-slot.ts +33 -1
  527. package/src/server/responses/advisor-question.ts +21 -0
  528. package/src/server/responses/advisor-slot.ts +10 -3
  529. package/src/server/responses/antigravity-fault-rotation.ts +24 -0
  530. package/src/server/responses/antigravity-validation-refusal.ts +43 -6
  531. package/src/server/responses/bare-namespace-aliases.ts +18 -0
  532. package/src/server/responses/buffered-sse-json.ts +9 -3
  533. package/src/server/responses/code-mode-collab-surface.ts +11 -0
  534. package/src/server/responses/codex-tool-catalog.ts +156 -0
  535. package/src/server/responses/combo-required-tool-fulfillments.ts +4 -2
  536. package/src/server/responses/combo-selection-keepalive.ts +254 -0
  537. package/src/server/responses/combo-stream-preflight.ts +557 -54
  538. package/src/server/responses/compact.ts +32 -8
  539. package/src/server/responses/core-codex-account.ts +17 -3
  540. package/src/server/responses/core-combo-failure.ts +8 -0
  541. package/src/server/responses/core-combo.ts +55 -12
  542. package/src/server/responses/core-errors.ts +13 -7
  543. package/src/server/responses/core-lifetime.ts +3 -2
  544. package/src/server/responses/core-normalize.ts +3 -1
  545. package/src/server/responses/core-options.ts +14 -0
  546. package/src/server/responses/core.ts +23 -0
  547. package/src/server/responses/estimated-usage.ts +115 -0
  548. package/src/server/responses/fetch-helpers.ts +15 -10
  549. package/src/server/responses/jev-model-invoke.ts +7 -2
  550. package/src/server/responses/native-replay-guard.ts +57 -0
  551. package/src/server/responses/opengateway-completion-guard.ts +10 -4
  552. package/src/server/responses/outbound-request-body.ts +29 -0
  553. package/src/server/responses/passthrough-completion.ts +109 -9
  554. package/src/server/responses/passthrough-delivery.ts +77 -18
  555. package/src/server/responses/passthrough-dispatch.ts +77 -73
  556. package/src/server/responses/policy-fallback.ts +13 -1
  557. package/src/server/responses/request-prepare.ts +59 -11
  558. package/src/server/responses/request-transport.ts +10 -3
  559. package/src/server/responses/reset-replay.ts +46 -2
  560. package/src/server/responses/run-turn-execution.ts +2 -0
  561. package/src/server/responses/sidecar-execution.ts +19 -0
  562. package/src/server/responses/terminal-error-redaction.ts +222 -25
  563. package/src/server/responses/ws-upstream.ts +2 -2
  564. package/src/server/sse-payload-rewrite.ts +3 -2
  565. package/src/server/stop-service-route.ts +85 -0
  566. package/src/server/system-env-shell.ts +12 -1
  567. package/src/server/system-env.ts +5 -3
  568. package/src/server/windows-tcp-drop.ts +21 -4
  569. package/src/server/workflow-refusal.ts +8 -0
  570. package/src/server/ws-bridge.ts +191 -12
  571. package/src/service/cli-windows-stop.ts +189 -0
  572. package/src/service/cli.ts +41 -12
  573. package/src/service/desktop-supervision.d.mts +2 -0
  574. package/src/service/desktop-supervision.mjs +5 -0
  575. package/src/service/disconnected-client-restart.ts +60 -0
  576. package/src/service/guarded-manager-target.ts +18 -1
  577. package/src/service/health.ts +99 -6
  578. package/src/service/launchd.ts +84 -31
  579. package/src/service/orchestration.ts +418 -91
  580. package/src/service/repair.ts +223 -6
  581. package/src/service/restart-proxy-stop.ts +79 -0
  582. package/src/service/service-child-ownership.ts +6 -2
  583. package/src/service/windows-checked-stop-live.ts +467 -0
  584. package/src/service/windows-checked-stop.ts +435 -0
  585. package/src/service/windows-command-line-token.ts +23 -0
  586. package/src/service/windows-guarded-manager.ts +77 -34
  587. package/src/service/windows-ops.ts +38 -56
  588. package/src/service/windows-process-evidence.ts +292 -0
  589. package/src/service/windows-process-native.ts +262 -0
  590. package/src/service/windows-service-stop.ts +321 -0
  591. package/src/service/windows-stop-binding.ts +187 -0
  592. package/src/service/windows-stop-budget.ts +123 -0
  593. package/src/service/windows-stop-confirm.ts +158 -0
  594. package/src/service/windows-stop-deadline.ts +56 -0
  595. package/src/service.ts +2 -2
  596. package/src/stall-timeout.ts +11 -0
  597. package/src/types/config.ts +57 -110
  598. package/src/types/link.ts +20 -0
  599. package/src/types/multi-agent.ts +13 -0
  600. package/src/types/provider.ts +60 -2
  601. package/src/types/request.ts +23 -0
  602. package/src/types/routed-catalog-defaults.ts +17 -0
  603. package/src/types/routing-profile.ts +90 -0
  604. package/src/types.ts +4 -0
  605. package/src/update/guarded-runtime-ops.ts +5 -7
  606. package/src/update/index.ts +26 -11
  607. package/src/update/install-detection.mjs +3 -1
  608. package/src/update/job-pinned-start.ts +2 -0
  609. package/src/update/job-windows-restart.ts +19 -32
  610. package/src/update/job.ts +12 -5
  611. package/src/update/npm-install.d.mts +11 -0
  612. package/src/update/npm-install.mjs +44 -7
  613. package/src/update/orchestrated-entry.ts +1 -1
  614. package/src/update/orchestrated-node-driver.mjs +3 -2
  615. package/src/update/orchestrated-pnpm.d.mts +4 -0
  616. package/src/update/orchestrated-pnpm.mjs +50 -6
  617. package/src/update/orchestrated-session.d.mts +3 -1
  618. package/src/update/orchestrated-session.mjs +21 -6
  619. package/src/update/pnpm-global-install.d.mts +21 -3
  620. package/src/update/pnpm-global-install.mjs +322 -19
  621. package/src/update/pnpm-store-layout.mjs +46 -0
  622. package/src/update/sync-update-mutex.d.mts +3 -2
  623. package/src/update/sync-update-mutex.mjs +57 -8
  624. package/src/update/transactional-install.d.mts +3 -1
  625. package/src/update/transactional-install.mjs +545 -12
  626. package/src/update/windows-installer-marker.d.mts +1 -0
  627. package/src/update/windows-installer-marker.mjs +44 -0
  628. package/src/usage/expected-prices.ts +8 -0
  629. package/src/usage/filter-index.ts +326 -77
  630. package/src/usage/ledger-scanner.ts +15 -0
  631. package/src/usage/link-log-fields.ts +48 -0
  632. package/src/usage/log.ts +57 -6
  633. package/src/usage/request-body.ts +37 -0
  634. package/src/usage/telemetry-contract.ts +1 -0
  635. package/src/web-search/loop.ts +3 -0
  636. package/src/web-search/passthrough-bridge.ts +7 -0
  637. package/gui/dist/assets/App-BpJOzw4F.js +0 -59
  638. package/gui/dist/assets/brand-mark-DU-0Vdkr.js +0 -1
  639. package/gui/dist/assets/index-Bbor_y80.js +0 -94
  640. package/gui/dist/assets/index-DJEkIDAi.css +0 -2
  641. package/gui/dist/classic/assets/App-BrIlUiLc.js +0 -58
  642. package/gui/dist/classic/assets/index-DyJHagvT.js +0 -94
  643. package/gui/dist/classic/assets/quota-summary-CakPe9Ni.js +0 -1
  644. package/src/server/management/desktop-compatibility-authorization.ts +0 -12
@@ -1,3 +1,4 @@
1
+ import { validReplayOwnerKey } from "./state/replay-owner";
1
2
  import {
2
3
  chmodSync,
3
4
  closeSync,
@@ -59,6 +60,7 @@ export interface ResponseSpillPayload {
59
60
  responseId: string;
60
61
  createdAt: number;
61
62
  clientThreadId?: string;
63
+ replayOwnerKey?: string;
62
64
  items: unknown[];
63
65
  /**
64
66
  * Index in `items` where the provider output begins, used by replay-overlap detection
@@ -494,6 +496,7 @@ function serializedSpill(
494
496
  responseId,
495
497
  createdAt: state.createdAt,
496
498
  ...(state.clientThreadId ? { clientThreadId: state.clientThreadId } : {}),
499
+ ...(state.replayOwnerKey ? { replayOwnerKey: state.replayOwnerKey } : {}),
497
500
  items: state.items,
498
501
  ...(state.providerOutputStart !== undefined ? { providerOutputStart: state.providerOutputStart } : {}),
499
502
  ...(state.providers ? { providers: state.providers } : {}),
@@ -551,11 +554,12 @@ function validPayload(value: unknown, responseId: string): value is ResponseSpil
551
554
  if (!value || typeof value !== "object" || Array.isArray(value)) return false;
552
555
  const payload = value as Record<string, unknown>;
553
556
  const keys = Object.keys(payload);
554
- if (keys.some(key => !["version", "responseId", "createdAt", "clientThreadId", "items", "providerOutputStart", "providers", "unforcedStoreFalse"].includes(key))) return false;
557
+ if (keys.some(key => !["version", "responseId", "createdAt", "clientThreadId", "replayOwnerKey", "items", "providerOutputStart", "providers", "unforcedStoreFalse"].includes(key))) return false;
555
558
  if (payload.version !== 1 || payload.responseId !== responseId) return false;
556
559
  if (typeof payload.createdAt !== "number" || !Number.isFinite(payload.createdAt)) return false;
557
560
  if (payload.clientThreadId !== undefined
558
561
  && (typeof payload.clientThreadId !== "string" || payload.clientThreadId.trim().length === 0)) return false;
562
+ if (payload.replayOwnerKey !== undefined && !validReplayOwnerKey(payload.replayOwnerKey)) return false;
559
563
  if (payload.unforcedStoreFalse !== undefined && typeof payload.unforcedStoreFalse !== "boolean") return false;
560
564
  if (!Array.isArray(payload.items)) return false;
561
565
  if (payload.unforcedStoreFalse === true && payload.providerOutputStart === undefined) return false;
@@ -0,0 +1,50 @@
1
+ import type { ResidentResponseState } from "../state";
2
+ import { clientCarriedPrefixLength, providerIssuedIdentity } from "./replay-fingerprint";
3
+ import { allowsUnforcedStoreFalseReplay } from "./unforced-store-false";
4
+
5
+ export function expandStoredResponseInput(request: Record<string, unknown>, input: unknown[], state: ResidentResponseState): {
6
+ body: Record<string, unknown>; prefixLength: number; overlap: boolean;
7
+ } {
8
+ const clientInput = input;
9
+ const stored = state.items;
10
+ const carried = clientCarriedPrefixLength(stored, clientInput);
11
+ if (
12
+ state.unforcedStoreFalse
13
+ && !allowsUnforcedStoreFalseReplay(stored, state.providerOutputStart, clientInput, carried)
14
+ ) {
15
+ return { body: request, prefixLength: 0, overlap: false };
16
+ }
17
+ // The client already replayed this history verbatim. Prepending the stored copy would
18
+ // double it, and the doubled turn is stored again, so the next turn triples (#1412 saw
19
+ // 127k of real context reach 1.3M tokens this way).
20
+ //
21
+ // Three conditions, all required. The run must cover the whole stored entry; it must reach
22
+ // the provider-output region; and some matched item in that region must carry a
23
+ // provider-issued id. The last one is the load-bearing part: content equality alone proves
24
+ // two items look alike, not that they are the same occurrence, so a client that merely
25
+ // repeats its own message would otherwise authorize a skip that deletes real history.
26
+ // There is no invariant that provider output always carries ids, so an entry whose output
27
+ // has none simply never skips.
28
+ {
29
+ const anchor = state.providerOutputStart;
30
+ if (
31
+ carried === stored.length
32
+ && anchor !== undefined
33
+ && carried > anchor
34
+ && stored.slice(anchor, carried).some(item => providerIssuedIdentity(item) !== null)
35
+ ) {
36
+ // Keep previous_response_id: Kiro and Cursor recover their conversation ids from it
37
+ // (kiro-wire.ts, cursor/request-builder.ts). Only the concatenation is skipped.
38
+ const unchanged = { ...request };
39
+ // Same provenance boundary a real expansion would record, so the replayed prefix does
40
+ // not re-acknowledge historical compaction markers (parser.ts) and stays visible to
41
+ // guidance de-duplication (collaboration.ts).
42
+ return { body: unchanged, prefixLength: carried, overlap: true };
43
+ }
44
+ }
45
+ const expanded = {
46
+ ...request,
47
+ input: [...stored, ...clientInput],
48
+ };
49
+ return { body: expanded, prefixLength: stored.length, overlap: false };
50
+ }
@@ -0,0 +1,24 @@
1
+ import { createHash } from "node:crypto";
2
+
3
+ /** A content-free binding, derived only from trusted admission and the request's OWN thread. */
4
+ export function responseReplayOwnerKey(principal: string | undefined, ownThread: string | undefined): string | null {
5
+ if (!principal || !ownThread?.trim()) return null;
6
+ return createHash("sha256").update(JSON.stringify(["ocx-response-owner-v1", principal, ownThread.trim()])).digest("hex");
7
+ }
8
+
9
+ export function validReplayOwnerKey(value: unknown): value is string {
10
+ return typeof value === "string" && /^[a-f0-9]{64}$/.test(value);
11
+ }
12
+
13
+ export function normalizedClientThreadId(value: unknown): string | undefined {
14
+ return typeof value === "string" && value.trim().length > 0 ? value.trim() : undefined;
15
+ }
16
+
17
+ /** Undefined is the legacy internal API; null explicitly means a request without an owner. */
18
+ export function replayScopeMatches(
19
+ entry: { clientThreadId?: string; replayOwnerKey?: string }, thread: string | undefined, key: string | null | undefined,
20
+ ): boolean {
21
+ if (key === null || (key !== undefined && !validReplayOwnerKey(key))) return false;
22
+ return key === entry.replayOwnerKey
23
+ && normalizedClientThreadId(thread) === normalizedClientThreadId(entry.clientThreadId);
24
+ }
@@ -1,3 +1,4 @@
1
+ import { validReplayOwnerKey } from "./replay-owner";
1
2
  import type {
2
3
  ResidentInput,
3
4
  ResidentResponseState,
@@ -20,6 +21,7 @@ export interface SnapshotLoadStore {
20
21
  interface LegacySnapshotState {
21
22
  createdAt?: unknown;
22
23
  clientThreadId?: unknown;
24
+ replayOwnerKey?: unknown;
23
25
  items?: unknown;
24
26
  providers?: OcxProviderContinuationState;
25
27
  conversationId?: unknown;
@@ -41,6 +43,11 @@ export function loadSnapshotEntry(id: string, value: unknown, store: SnapshotLoa
41
43
  if (!value || typeof value !== "object" || Array.isArray(value)) return;
42
44
  const rec = value as LegacySnapshotState & { kind?: unknown; spill?: unknown };
43
45
  if (typeof rec.createdAt !== "number" || !Number.isFinite(rec.createdAt)) return;
46
+ if (rec.replayOwnerKey !== undefined && !validReplayOwnerKey(rec.replayOwnerKey)) {
47
+ store.replaceMapEntry(id, store.tombstone(id, rec.createdAt));
48
+ return;
49
+ }
50
+ const replayOwnerKey = rec.replayOwnerKey;
44
51
  const clientThreadId = typeof rec.clientThreadId === "string" && rec.clientThreadId.trim().length > 0
45
52
  ? rec.clientThreadId.trim()
46
53
  : undefined;
@@ -61,6 +68,7 @@ export function loadSnapshotEntry(id: string, value: unknown, store: SnapshotLoa
61
68
  kind: "spill",
62
69
  createdAt: rec.createdAt,
63
70
  ...(clientThreadId ? { clientThreadId } : {}),
71
+ ...(replayOwnerKey ? { replayOwnerKey } : {}),
64
72
  // Item count is unknown until materialization, so accept any non-negative integer
65
73
  // here; the spill payload validator re-checks it against the real array.
66
74
  ...(anchorFor(Number.MAX_SAFE_INTEGER) !== undefined ? { providerOutputStart: anchorFor(Number.MAX_SAFE_INTEGER) } : {}),
@@ -90,6 +98,7 @@ export function loadSnapshotEntry(id: string, value: unknown, store: SnapshotLoa
90
98
  const resident = store.measureResidentEntry(id, {
91
99
  createdAt: rec.createdAt,
92
100
  ...(clientThreadId ? { clientThreadId } : {}),
101
+ ...(replayOwnerKey ? { replayOwnerKey } : {}),
93
102
  items: rec.items,
94
103
  ...(anchorFor(rec.items.length) !== undefined ? { providerOutputStart: anchorFor(rec.items.length) } : {}),
95
104
  ...(providers ? { providers } : {}),
@@ -193,6 +193,7 @@ function spillPayloadForResident(candidate: ResidentResponseState): Parameters<t
193
193
  return {
194
194
  createdAt: candidate.createdAt,
195
195
  ...(candidate.clientThreadId ? { clientThreadId: candidate.clientThreadId } : {}),
196
+ ...(candidate.replayOwnerKey ? { replayOwnerKey: candidate.replayOwnerKey } : {}),
196
197
  items: candidate.items,
197
198
  ...(candidate.providerOutputStart !== undefined ? { providerOutputStart: candidate.providerOutputStart } : {}),
198
199
  ...(candidate.providers ? { providers: candidate.providers } : {}),
@@ -20,8 +20,9 @@ import {
20
20
  } from "./spill-store";
21
21
  import { collectReferencedSpillFileNames, snapshotReferencedSpillFileNames } from "./state/spill-inspect";
22
22
  import { selectSnapshotEntries, snapshotPayload } from "./state/snapshot-select";
23
- import { clientCarriedPrefixLength, providerIssuedIdentity } from "./state/replay-fingerprint";
24
- import { hasPendingClientToolCall, allowsUnforcedStoreFalseReplay } from "./state/unforced-store-false";
23
+ import { expandStoredResponseInput } from "./state/replay-input";
24
+ import { normalizedClientThreadId, replayScopeMatches, validReplayOwnerKey } from "./state/replay-owner";
25
+ import { hasPendingClientToolCall } from "./state/unforced-store-false";
25
26
  import { computeResponseStateMetrics, type ResponseStateMetrics } from "./state/metrics";
26
27
  export type { ResponseStateMetrics } from "./state/metrics";
27
28
  export type { ResponseStateTempRecoveryResult, ResponseStateTempRecoveryOptions } from "./state/temp-recovery";
@@ -117,6 +118,7 @@ export interface ResidentResponseState {
117
118
  kind: "resident";
118
119
  createdAt: number;
119
120
  clientThreadId?: string;
121
+ replayOwnerKey?: string;
120
122
  items: unknown[];
121
123
  /** Index in `items` where provider output begins; see clientCarriedPrefixLength. */
122
124
  providerOutputStart?: number;
@@ -129,6 +131,7 @@ export interface SpilledResponseState {
129
131
  kind: "spill";
130
132
  createdAt: number;
131
133
  clientThreadId?: string;
134
+ replayOwnerKey?: string;
132
135
  /** Mirrors the spilled payload boundary so a spilled entry keeps its anchor. */
133
136
  providerOutputStart?: number;
134
137
  providers?: OcxProviderContinuationState;
@@ -317,6 +320,7 @@ function measureResidentEntry(id: string, entry: ResidentInput): ResidentRespons
317
320
  responseId: id,
318
321
  createdAt: entry.createdAt,
319
322
  ...(entry.clientThreadId ? { clientThreadId: entry.clientThreadId } : {}),
323
+ ...(entry.replayOwnerKey ? { replayOwnerKey: entry.replayOwnerKey } : {}),
320
324
  items: entry.items,
321
325
  ...(entry.providerOutputStart !== undefined ? { providerOutputStart: entry.providerOutputStart } : {}),
322
326
  ...(entry.providers ? { providers: entry.providers } : {}),
@@ -423,6 +427,7 @@ function swapResidentForSpill(id: string, expected: ResidentResponseState, ref:
423
427
  kind: "spill",
424
428
  createdAt: expected.createdAt,
425
429
  ...(expected.clientThreadId ? { clientThreadId: expected.clientThreadId } : {}),
430
+ ...(expected.replayOwnerKey ? { replayOwnerKey: expected.replayOwnerKey } : {}),
426
431
  ...(expected.providerOutputStart !== undefined ? { providerOutputStart: expected.providerOutputStart } : {}),
427
432
  ...(expected.providers ? { providers: expected.providers } : {}),
428
433
  ...(expected.unforcedStoreFalse ? { unforcedStoreFalse: expected.unforcedStoreFalse } : {}),
@@ -446,6 +451,7 @@ function replaceSpillEntryAtomically(
446
451
  const ref = writeResponseSpillDurably(id, {
447
452
  createdAt: candidate.createdAt,
448
453
  ...(candidate.clientThreadId ? { clientThreadId: candidate.clientThreadId } : {}),
454
+ ...(candidate.replayOwnerKey ? { replayOwnerKey: candidate.replayOwnerKey } : {}),
449
455
  items: candidate.items,
450
456
  ...(candidate.providerOutputStart !== undefined ? { providerOutputStart: candidate.providerOutputStart } : {}),
451
457
  ...(candidate.providers ? { providers: candidate.providers } : {}),
@@ -455,6 +461,7 @@ function replaceSpillEntryAtomically(
455
461
  kind: "spill",
456
462
  createdAt: candidate.createdAt,
457
463
  ...(candidate.clientThreadId ? { clientThreadId: candidate.clientThreadId } : {}),
464
+ ...(candidate.replayOwnerKey ? { replayOwnerKey: candidate.replayOwnerKey } : {}),
458
465
  ...(candidate.providerOutputStart !== undefined ? { providerOutputStart: candidate.providerOutputStart } : {}),
459
466
  ...(candidate.providers ? { providers: candidate.providers } : {}),
460
467
  ...(candidate.unforcedStoreFalse ? { unforcedStoreFalse: candidate.unforcedStoreFalse } : {}),
@@ -540,6 +547,7 @@ function admitOversizedCandidate(
540
547
  const ref = writeResponseSpillDurably(id, {
541
548
  createdAt: candidate.createdAt,
542
549
  ...(candidate.clientThreadId ? { clientThreadId: candidate.clientThreadId } : {}),
550
+ ...(candidate.replayOwnerKey ? { replayOwnerKey: candidate.replayOwnerKey } : {}),
543
551
  items: candidate.items,
544
552
  ...(candidate.providerOutputStart !== undefined ? { providerOutputStart: candidate.providerOutputStart } : {}),
545
553
  ...(candidate.providers ? { providers: candidate.providers } : {}),
@@ -558,6 +566,7 @@ function admitOversizedCandidate(
558
566
  kind: "spill",
559
567
  createdAt: candidate.createdAt,
560
568
  ...(candidate.clientThreadId ? { clientThreadId: candidate.clientThreadId } : {}),
569
+ ...(candidate.replayOwnerKey ? { replayOwnerKey: candidate.replayOwnerKey } : {}),
561
570
  ...(candidate.providerOutputStart !== undefined ? { providerOutputStart: candidate.providerOutputStart } : {}),
562
571
  ...(candidate.providers ? { providers: candidate.providers } : {}),
563
572
  ...(candidate.unforcedStoreFalse ? { unforcedStoreFalse: candidate.unforcedStoreFalse } : {}),
@@ -609,6 +618,7 @@ bindSpillQueueStore({
609
618
  // once. It records the boundary whether the proxy prepended the history or the client already
610
619
  // carried it — the boundary is the same either way, and only its provenance differs.
611
620
  const replayedInputPrefixLengths = new WeakMap<object, number>();
621
+ const clientCarriedReplays = new WeakSet<object>(); // overlap skip: the client resent the window itself
612
622
  const replayFailures = new WeakMap<object, PreviousResponseReplayFailure>();
613
623
  let loaded = false;
614
624
  let persistTimer: ReturnType<typeof setTimeout> | null = null;
@@ -959,6 +969,7 @@ function pruneResponses(at = now()): void {
959
969
  const ref = writeResponseSpillDurably(oldestId, {
960
970
  createdAt: entry.createdAt,
961
971
  ...(entry.clientThreadId ? { clientThreadId: entry.clientThreadId } : {}),
972
+ ...(entry.replayOwnerKey ? { replayOwnerKey: entry.replayOwnerKey } : {}),
962
973
  items: entry.items,
963
974
  ...(entry.providerOutputStart !== undefined ? { providerOutputStart: entry.providerOutputStart } : {}),
964
975
  ...(entry.providers ? { providers: entry.providers } : {}),
@@ -1019,6 +1030,7 @@ export function evictOldestResponseContinuationForBudget(): number {
1019
1030
  const ref = writeResponseSpillDurably(id, {
1020
1031
  createdAt: entry.createdAt,
1021
1032
  ...(entry.clientThreadId ? { clientThreadId: entry.clientThreadId } : {}),
1033
+ ...(entry.replayOwnerKey ? { replayOwnerKey: entry.replayOwnerKey } : {}),
1022
1034
  items: entry.items,
1023
1035
  ...(entry.providerOutputStart !== undefined ? { providerOutputStart: entry.providerOutputStart } : {}),
1024
1036
  ...(entry.providers ? { providers: entry.providers } : {}),
@@ -1059,6 +1071,9 @@ function materializeEntry(
1059
1071
  schedulePersist();
1060
1072
  return { ok: false, failure };
1061
1073
  }
1074
+ if (entry.replayOwnerKey !== result.payload.replayOwnerKey || entry.clientThreadId !== result.payload.clientThreadId) {
1075
+ return { ok: false, failure: { code: "previous_response_not_found", reason: "spill_corrupt" } };
1076
+ }
1062
1077
  // A restricted snapshot stub must agree with the validated spill's provenance.
1063
1078
  if (entry.unforcedStoreFalse && (result.payload.unforcedStoreFalse !== true
1064
1079
  || entry.providerOutputStart === undefined || entry.providerOutputStart > result.payload.items.length
@@ -1071,6 +1086,7 @@ function materializeEntry(
1071
1086
  const state = measureResidentEntry(id, {
1072
1087
  createdAt: result.payload.createdAt,
1073
1088
  ...(result.payload.clientThreadId ? { clientThreadId: result.payload.clientThreadId } : {}),
1089
+ ...(result.payload.replayOwnerKey ? { replayOwnerKey: result.payload.replayOwnerKey } : {}),
1074
1090
  items: result.payload.items,
1075
1091
  ...(result.payload.providerOutputStart !== undefined
1076
1092
  ? { providerOutputStart: result.payload.providerOutputStart }
@@ -1087,11 +1103,7 @@ function materializeEntry(
1087
1103
  return { ok: true, state };
1088
1104
  }
1089
1105
 
1090
- function normalizedClientThreadId(value: unknown): string | undefined {
1091
- return typeof value === "string" && value.trim().length > 0 ? value.trim() : undefined;
1092
- }
1093
-
1094
- export function expandPreviousResponseInput(body: unknown, clientThreadId?: string): unknown {
1106
+ export function expandPreviousResponseInput(body: unknown, clientThreadId?: string, replayOwnerKey?: string | null): unknown {
1095
1107
  if (!body || typeof body !== "object" || Array.isArray(body)) return body;
1096
1108
  const request = body as Record<string, unknown>;
1097
1109
  const previousId = typeof request.previous_response_id === "string" ? request.previous_response_id : undefined;
@@ -1100,65 +1112,24 @@ export function expandPreviousResponseInput(body: unknown, clientThreadId?: stri
1100
1112
  pruneResponses();
1101
1113
  const previous = states.get(previousId);
1102
1114
  if (!previous) return body;
1103
- const materialized = materializeEntry(previousId, previous);
1104
- if (!materialized.ok) {
1105
- replayFailures.set(request, materialized.failure);
1106
- return body;
1107
- }
1108
- const requestThreadId = normalizedClientThreadId(clientThreadId);
1109
- const storedThreadId = normalizedClientThreadId(materialized.state.clientThreadId);
1110
- // A Codex task must never inherit another task's continuation, nor a legacy unscoped entry.
1111
- // Unscoped callers retain backward-compatible replay only with other unscoped entries.
1112
- if (requestThreadId !== storedThreadId) {
1115
+ // Authorize metadata BEFORE opening a spill or exposing provider continuation state.
1116
+ if (previous.kind !== "spill-failed" && !replayScopeMatches(previous, clientThreadId, replayOwnerKey)) {
1113
1117
  replayFailures.set(request, { code: "previous_response_not_found", reason: "scope_mismatch" });
1114
1118
  replayScopeMismatchDrops += 1;
1115
1119
  return body;
1116
1120
  }
1117
- const clientInput = inputItems(request.input);
1118
- const stored = materialized.state.items;
1119
- const carried = clientCarriedPrefixLength(stored, clientInput);
1120
- if (
1121
- materialized.state.unforcedStoreFalse
1122
- && !allowsUnforcedStoreFalseReplay(stored, materialized.state.providerOutputStart, clientInput, carried)
1123
- ) {
1121
+ const materialized = materializeEntry(previousId, previous);
1122
+ if (!materialized.ok) {
1123
+ replayFailures.set(request, materialized.failure);
1124
1124
  return body;
1125
1125
  }
1126
- // The client already replayed this history verbatim. Prepending the stored copy would
1127
- // double it, and the doubled turn is stored again, so the next turn triples (#1412 saw
1128
- // 127k of real context reach 1.3M tokens this way).
1129
- //
1130
- // Three conditions, all required. The run must cover the whole stored entry; it must reach
1131
- // the provider-output region; and some matched item in that region must carry a
1132
- // provider-issued id. The last one is the load-bearing part: content equality alone proves
1133
- // two items look alike, not that they are the same occurrence, so a client that merely
1134
- // repeats its own message would otherwise authorize a skip that deletes real history.
1135
- // There is no invariant that provider output always carries ids, so an entry whose output
1136
- // has none simply never skips.
1137
- {
1138
- const anchor = materialized.state.providerOutputStart;
1139
- if (
1140
- carried === stored.length
1141
- && anchor !== undefined
1142
- && carried > anchor
1143
- && stored.slice(anchor, carried).some(item => providerIssuedIdentity(item) !== null)
1144
- ) {
1145
- replayOverlapSkips += 1;
1146
- // Keep previous_response_id: Kiro and Cursor recover their conversation ids from it
1147
- // (kiro-wire.ts, cursor/request-builder.ts). Only the concatenation is skipped.
1148
- const unchanged = { ...request };
1149
- // Same provenance boundary a real expansion would record, so the replayed prefix does
1150
- // not re-acknowledge historical compaction markers (parser.ts) and stays visible to
1151
- // guidance de-duplication (collaboration.ts).
1152
- replayedInputPrefixLengths.set(unchanged, carried);
1153
- return unchanged;
1154
- }
1126
+ const expanded = expandStoredResponseInput(request, inputItems(request.input), materialized.state);
1127
+ if (expanded.overlap) {
1128
+ replayOverlapSkips += 1;
1129
+ clientCarriedReplays.add(expanded.body);
1155
1130
  }
1156
- const expanded = {
1157
- ...request,
1158
- input: [...stored, ...clientInput],
1159
- };
1160
- replayedInputPrefixLengths.set(expanded, stored.length);
1161
- return expanded;
1131
+ if (expanded.body !== request) replayedInputPrefixLengths.set(expanded.body, expanded.prefixLength);
1132
+ return expanded.body;
1162
1133
  }
1163
1134
 
1164
1135
  export function previousResponseReplayFailure(body: unknown): PreviousResponseReplayFailure | undefined {
@@ -1172,6 +1143,11 @@ export function previousResponseReplayPrefixLength(body: unknown): number {
1172
1143
  return replayedInputPrefixLengths.get(body) ?? 0;
1173
1144
  }
1174
1145
 
1146
+ /** Leading items the PROXY prepended; 0 when the client resent the stored window itself (overlap skip). */
1147
+ export function previousResponseRestoredPrefixLength(body: unknown): number {
1148
+ return body && typeof body === "object" && clientCarriedReplays.has(body) ? 0 : previousResponseReplayPrefixLength(body);
1149
+ }
1150
+
1175
1151
  /** Copy proxy-private replay provenance to an internal clone with the same materialized input. */
1176
1152
  export function copyPreviousResponseReplayProvenance(source: unknown, target: unknown): void {
1177
1153
  if (!source || typeof source !== "object" || Array.isArray(source)) return;
@@ -1181,6 +1157,7 @@ export function copyPreviousResponseReplayProvenance(source: unknown, target: un
1181
1157
  const input = (target as { input?: unknown }).input;
1182
1158
  if (!Array.isArray(input) || prefixLength > input.length) return;
1183
1159
  replayedInputPrefixLengths.set(target, prefixLength);
1160
+ if (clientCarriedReplays.has(source)) clientCarriedReplays.add(target);
1184
1161
  }
1185
1162
 
1186
1163
  /** True when this exact request could not replay because its task scope did not match. */
@@ -1252,7 +1229,7 @@ export function rememberResponseState(
1252
1229
  requestBody: unknown,
1253
1230
  response: { id?: unknown; output?: unknown; status?: unknown; incomplete_details?: unknown },
1254
1231
  providerState?: OcxProviderContinuationState | string,
1255
- opts?: { force?: boolean; clientThreadId?: string; retainForToolContinuation?: boolean },
1232
+ opts?: { force?: boolean; clientThreadId?: string; retainForToolContinuation?: boolean; replayOwnerKey?: string | null; compiledPlaintext?: boolean },
1256
1233
  ): void {
1257
1234
  if (!requestBody || typeof requestBody !== "object" || Array.isArray(requestBody)) return;
1258
1235
  const request = requestBody as Record<string, unknown>;
@@ -1271,7 +1248,11 @@ export function rememberResponseState(
1271
1248
  if (!details || typeof details !== "object" || Array.isArray(details)
1272
1249
  || (details as { reason?: unknown }).reason !== "max_output_tokens") return;
1273
1250
  } else if (response.status !== undefined && response.status !== "completed") return;
1251
+ if ((opts?.compiledPlaintext && !validReplayOwnerKey(opts.replayOwnerKey)) || opts?.replayOwnerKey === null || (opts?.replayOwnerKey !== undefined && !validReplayOwnerKey(opts.replayOwnerKey))) return;
1274
1252
  ensureLoaded();
1253
+ const existing = states.get(response.id);
1254
+ // Never let a colliding upstream id replace a different caller's retained response.
1255
+ if (existing && existing.kind !== "spill-failed" && !replayScopeMatches(existing, opts?.clientThreadId, opts?.replayOwnerKey)) return;
1275
1256
  const normalizedProviderState: OcxProviderContinuationState = typeof providerState === "string"
1276
1257
  ? { cursor: { conversationId: providerState } }
1277
1258
  : structuredClone(providerState ?? {});
@@ -1287,6 +1268,7 @@ export function rememberResponseState(
1287
1268
  setResidentEntry(response.id, {
1288
1269
  createdAt: now(),
1289
1270
  ...(clientThreadId ? { clientThreadId } : {}),
1271
+ ...(opts?.replayOwnerKey ? { replayOwnerKey: opts.replayOwnerKey } : {}),
1290
1272
  items: [...requestItems, ...response.output],
1291
1273
  // Where response.output begins. A replay skip requires a matched item at or past this
1292
1274
  // index that also carries a provider-issued id — position alone proves only that an item
package/src/router.ts CHANGED
@@ -600,7 +600,7 @@ function routeModelInternal(
600
600
  const decoded = decodeRoutedModelIdOrThrow(requestedModel, known);
601
601
  const nativeModel = known.includes(decoded)
602
602
  ? decoded
603
- : resolveModelAlias(config, prov, known, requestedModel)
603
+ : resolveModelAlias(config, prov, known, requestedModel, provName)
604
604
  // Last resort for direct requests while the live roster is cold: display-name keys are
605
605
  // operator-declared native ids, consulted only here so they never claim aliases or shadow
606
606
  // known or retained ids. Concrete policy/combo/redirect targets (bypassCombos) keep the
@@ -672,7 +672,7 @@ function routeModelInternal(
672
672
  const aliasMatches: Array<{ provider: string; model: string; qualified: string }> = [];
673
673
  for (const [provName, prov] of activeProviderEntries(config)) {
674
674
  const known = knownModelIdsForProvider(provName, prov, config);
675
- const native = resolveModelAlias(config, prov, known, modelId);
675
+ const native = resolveModelAlias(config, prov, known, modelId, provName);
676
676
  if (native) aliasMatches.push({
677
677
  provider: provName,
678
678
  model: native,
@@ -7,11 +7,39 @@
7
7
  * serving-thread scan is needed, and operational failures only delay retry.
8
8
  */
9
9
 
10
+ import { statSync } from "node:fs";
10
11
  import { RebuildWorkerJob } from "./rebuild-job";
11
12
 
12
13
  export const REQUEST_HISTORY_INTEGRITY_INTERVAL_MS = 5 * 60_000;
13
14
  export const REQUEST_HISTORY_INTEGRITY_FAILURE_COOLDOWN_MS = 30_000;
14
15
  export const REQUEST_HISTORY_INTEGRITY_CHECK_TIMEOUT_MS = 30_000;
16
+ export const REQUEST_HISTORY_INTEGRITY_CHECK_MAX_TIMEOUT_MS = 15 * 60_000;
17
+ /**
18
+ * quick_check reads every index page, so its cost scales with file size. Assume
19
+ * a conservative sustained scan rate well below observed throughput; the 30 s
20
+ * constant stays the floor for the small indexes it was chosen for.
21
+ */
22
+ const REQUEST_HISTORY_INTEGRITY_CHECK_MIN_SCAN_BYTES_PER_SECOND = 32 * 1024 * 1024;
23
+
24
+ function indexFileSizeBytes(path: string): number | undefined {
25
+ try {
26
+ return statSync(path).size;
27
+ } catch {
28
+ return undefined;
29
+ }
30
+ }
31
+
32
+ /** Per-generation check bound: the 30 s floor, scaled by index size, capped. */
33
+ export function requestHistoryIntegrityCheckTimeoutMs(indexBytes: number | undefined): number {
34
+ if (indexBytes === undefined || !Number.isFinite(indexBytes) || indexBytes <= 0) {
35
+ return REQUEST_HISTORY_INTEGRITY_CHECK_TIMEOUT_MS;
36
+ }
37
+ const scaledMs = Math.ceil(indexBytes / REQUEST_HISTORY_INTEGRITY_CHECK_MIN_SCAN_BYTES_PER_SECOND * 1000);
38
+ return Math.min(
39
+ REQUEST_HISTORY_INTEGRITY_CHECK_MAX_TIMEOUT_MS,
40
+ Math.max(REQUEST_HISTORY_INTEGRITY_CHECK_TIMEOUT_MS, scaledMs),
41
+ );
42
+ }
15
43
 
16
44
  type IntegrityJob = Pick<RebuildWorkerJob, "check" | "dispose" | "afterExit">;
17
45
 
@@ -38,6 +66,7 @@ interface Generation {
38
66
  corrupt: boolean;
39
67
  nextCheckAt: number;
40
68
  failure: { error: unknown } | null;
69
+ timeoutMs: number;
41
70
  }
42
71
 
43
72
  interface ActiveCheck {
@@ -59,7 +88,7 @@ export class RequestHistoryIntegrityMonitor {
59
88
  private readonly now: () => number;
60
89
  private readonly intervalMs: number;
61
90
  private readonly failureCooldownMs: number;
62
- private readonly checkTimeoutMs: number;
91
+ private readonly checkTimeoutMs: number | undefined;
63
92
  private readonly scheduleTimeout: (callback: () => void, ms: number) => () => void;
64
93
  private current: Generation | null = null;
65
94
  private active: ActiveCheck | null = null;
@@ -70,7 +99,7 @@ export class RequestHistoryIntegrityMonitor {
70
99
  this.now = options.now ?? Date.now;
71
100
  this.intervalMs = options.intervalMs ?? REQUEST_HISTORY_INTEGRITY_INTERVAL_MS;
72
101
  this.failureCooldownMs = options.failureCooldownMs ?? REQUEST_HISTORY_INTEGRITY_FAILURE_COOLDOWN_MS;
73
- this.checkTimeoutMs = options.checkTimeoutMs ?? REQUEST_HISTORY_INTEGRITY_CHECK_TIMEOUT_MS;
102
+ this.checkTimeoutMs = options.checkTimeoutMs;
74
103
  this.scheduleTimeout = options.scheduleTimeout ?? ((callback, ms) => {
75
104
  const timer = setTimeout(callback, ms);
76
105
  return () => clearTimeout(timer);
@@ -80,7 +109,10 @@ export class RequestHistoryIntegrityMonitor {
80
109
  inspect(handle: object, path: string): RequestHistoryIntegrityState {
81
110
  if (this.current?.handle !== handle || this.current.path !== path) {
82
111
  this.quiesce();
83
- this.current = { handle, path, verified: false, corrupt: false, nextCheckAt: -Infinity, failure: null };
112
+ this.current = {
113
+ handle, path, verified: false, corrupt: false, nextCheckAt: -Infinity, failure: null,
114
+ timeoutMs: this.generationTimeoutMs(path),
115
+ };
84
116
  }
85
117
  const generation = this.current;
86
118
  if (generation.corrupt) return { state: "corrupt" };
@@ -115,9 +147,14 @@ export class RequestHistoryIntegrityMonitor {
115
147
  this.current = {
116
148
  handle, path, verified: true, corrupt: false,
117
149
  nextCheckAt: this.now() + this.intervalMs, failure: null,
150
+ timeoutMs: this.generationTimeoutMs(path),
118
151
  };
119
152
  }
120
153
 
154
+ private generationTimeoutMs(path: string): number {
155
+ return this.checkTimeoutMs ?? requestHistoryIntegrityCheckTimeoutMs(indexFileSizeBytes(path));
156
+ }
157
+
121
158
  /**
122
159
  * Invalidate and stop the current check. Null means the index can be replaced
123
160
  * now; otherwise await the returned barrier before deleting or renaming it.
@@ -166,7 +203,7 @@ export class RequestHistoryIntegrityMonitor {
166
203
  private async run(check: ActiveCheck, job: IntegrityJob, cancelled: Promise<CheckOutcome>, release: () => void): Promise<void> {
167
204
  let expire!: (outcome: CheckOutcome) => void;
168
205
  const timeout = new Promise<CheckOutcome>(resolve => { expire = resolve; });
169
- const clear = this.scheduleTimeout(() => expire({ kind: "timeout", error: new Error("request-history integrity check timed out") }), this.checkTimeoutMs);
206
+ const clear = this.scheduleTimeout(() => expire({ kind: "timeout", error: new Error("request-history integrity check timed out") }), check.generation.timeoutMs);
170
207
  const observed = Promise.resolve().then(async (): Promise<CheckOutcome> => {
171
208
  if (check.cancelled) return { kind: "cancelled" };
172
209
  try {
@@ -0,0 +1,123 @@
1
+ /**
2
+ * Children inherit the Home's native switches as they stood when route intent began, never as they
3
+ * are now: ocx restore, Messages off, Claude Desktop apply and the Claude toggle are Home-only.
4
+ *
5
+ * One idempotent capture freezes the four native defaults into route-intent.json. It runs before
6
+ * a Home default write and at Child enrollment, and, only once the Home has a link, when its link
7
+ * listener binds (a failure there is retried, see link-listener.ts) and before any Home-only
8
+ * decision changes a switch. On a Home with no link Home-only decisions leave route-intent.json
9
+ * alone, so a Child enrolled later inherits the switches as they stand at enrollment unless a Home
10
+ * default write already saved them. Reads never capture. Once a default is saved it is never
11
+ * captured again; only a Home default write changes it.
12
+ */
13
+ import { readConfigDiagnostics } from "../config";
14
+ import { withConfigMutationLockSync } from "../config/mutation-lock";
15
+ import { setIntegrationEnabled, type CodexDesiredStateResult, type DurableIntentClientId } from "../codex/desired-state";
16
+ import { linkStorePath } from "../link/paths";
17
+ import { readLinkStore } from "../link/store";
18
+ import { HOME_NATIVE_ROUTE_CLIENTS, homeNativeRouteDefaults, type HomeNativeRouteClientId, type RouteClientIntent } from "../link/route-intent";
19
+ import type { OcxConfig } from "../types";
20
+ import { readRouteIntentState, routeIntentStatePath, updateRouteIntentState, type RouteIntentState } from "./route-intent-state";
21
+
22
+ function captured(state: RouteIntentState): boolean {
23
+ return HOME_NATIVE_ROUTE_CLIENTS.every(client => state.defaults[client] !== undefined);
24
+ }
25
+
26
+ /**
27
+ * Whether a linked Child inherits these defaults. An ephemeral `ocx-child` never reads route intent,
28
+ * so a Home whose only links are ephemeral has nothing to protect. Unreadable trust metadata counts
29
+ * as linked: a Child may still depend on these defaults.
30
+ */
31
+ export function homeHasLinks(): boolean {
32
+ try { return readLinkStore(linkStorePath()).links.some(link => link.childKind !== "ephemeral"); } catch { return true; }
33
+ }
34
+
35
+ export interface CaptureHomeRouteDefaultsOptions {
36
+ /**
37
+ * Every Home-only switch writer passes this: a Home without any link has no Child to protect
38
+ * yet, so route-intent.json is neither read nor written for it.
39
+ */
40
+ whenLinked?: boolean;
41
+ }
42
+
43
+ /** The native defaults the Home's durable switches give (`fallback` only when the file is unreadable); null on a Child. */
44
+ export function durableHomeNativeRouteDefaults(fallback?: OcxConfig): Record<HomeNativeRouteClientId, RouteClientIntent> | null {
45
+ const latest = readConfigDiagnostics();
46
+ const durable = latest.source === "file" && !latest.error ? latest.config : fallback;
47
+ return !durable || durable.runtimeRole === "client" ? null : homeNativeRouteDefaults(durable);
48
+ }
49
+
50
+ /** Fills only the missing native defaults; a saved one is never captured again. */
51
+ export function fillHomeNativeRouteDefaults(state: RouteIntentState, defaults: Record<HomeNativeRouteClientId, RouteClientIntent>): boolean {
52
+ let filled = false;
53
+ for (const client of HOME_NATIVE_ROUTE_CLIENTS) {
54
+ if (state.defaults[client] !== undefined) continue;
55
+ state.defaults[client] = defaults[client];
56
+ filled = true;
57
+ }
58
+ return filled;
59
+ }
60
+
61
+ /**
62
+ * Saves the missing native defaults from the durable switches (`fallback` only when the config
63
+ * file is unreadable). A Child never captures. Returns whether anything was saved.
64
+ */
65
+ export function captureHomeRouteDefaults(fallback?: OcxConfig, options: CaptureHomeRouteDefaultsOptions = {}): boolean {
66
+ if (fallback?.runtimeRole === "client") return false;
67
+ if (options.whenLinked && !homeHasLinks()) return false;
68
+ if (captured(readRouteIntentState())) return false;
69
+ return withConfigMutationLockSync(() => {
70
+ const defaults = durableHomeNativeRouteDefaults(fallback);
71
+ if (!defaults) return false;
72
+ let saved = false;
73
+ updateRouteIntentState(state => { saved = fillHomeNativeRouteDefaults(state, defaults); return state; });
74
+ return saved;
75
+ });
76
+ }
77
+
78
+ /**
79
+ * A Home-only switch write refused because the Children's defaults could not be saved first.
80
+ * Writing the switch anyway would change what Children inherit once the file is repaired.
81
+ */
82
+ export interface HomeRouteCaptureRefusal {
83
+ readonly ok: false;
84
+ readonly reason: "unavailable";
85
+ readonly retryable: boolean;
86
+ readonly message: string;
87
+ }
88
+
89
+ export type HomeIntegrationResult = CodexDesiredStateResult | HomeRouteCaptureRefusal;
90
+
91
+ /** Only SQLITE_BUSY is contention worth retrying; any other lock failure repeats forever. */
92
+ function lockContention(error: unknown): boolean {
93
+ if (!error || typeof error !== "object") return false;
94
+ return (error as { code?: unknown }).code === "CONFIG_MUTATION_LOCK_UNAVAILABLE"
95
+ && (error as { cause?: { code?: unknown } }).cause?.code === "SQLITE_BUSY";
96
+ }
97
+
98
+ export function captureRefusal(error: unknown): HomeRouteCaptureRefusal {
99
+ const path = routeIntentStatePath();
100
+ if (lockContention(error)) return { ok: false, reason: "unavailable", retryable: true,
101
+ message: `Another process is saving the configuration, so the Children's route defaults in ${path} could not be saved first; nothing was changed. Retry in a moment.` };
102
+ return { ok: false, reason: "unavailable", retryable: false,
103
+ message: `The Children's route defaults in ${path} could not be read or saved; nothing was changed. Inspect it, fix or remove it, then retry.` };
104
+ }
105
+
106
+ /** `captureHomeRouteDefaults` for the Home-only switch writers: a failure is a typed refusal, never a throw. */
107
+ export function captureHomeRouteDefaultsBeforeHomeSwitch(): HomeRouteCaptureRefusal | null {
108
+ try {
109
+ captureHomeRouteDefaults(undefined, { whenLinked: true });
110
+ return null;
111
+ } catch (error) {
112
+ return captureRefusal(error);
113
+ }
114
+ }
115
+
116
+ /**
117
+ * The Home-only switch writers (ocx restore, ocx restore back, Claude Desktop apply from the CLI
118
+ * and the dashboard) go through here. desired-state.ts itself stays free of link state: it is on
119
+ * the always-on request path (tests/lab/core-link-boundary.test.ts).
120
+ */
121
+ export function setHomeIntegrationEnabled(client: DurableIntentClientId, enabled: boolean): HomeIntegrationResult {
122
+ return captureHomeRouteDefaultsBeforeHomeSwitch() ?? setIntegrationEnabled(client, enabled);
123
+ }