@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
@@ -11,6 +11,7 @@ import {
11
11
  type ManagementAuthState,
12
12
  } from "../server/management-auth";
13
13
  import { resolveInboundBodyLimitBytes } from "../server/request-decompress";
14
+ import { LINK_DIAGNOSTICS_ROUTE, linkDiagnosticsResponse } from "../server/management/link-diagnostics-route";
14
15
  import type { OcxClientConnectionConfig, OcxConfig } from "../types";
15
16
  import { disconnectClient, syncConnectedClient } from "./connect";
16
17
  import { isLinkConnection, readClientConnectionState } from "./state";
@@ -19,8 +20,11 @@ import { MACHINE_GUI_ORIGIN_HEADER, requireMachineAuth } from "./machine-auth";
19
20
  import { HUB_RELAY_REQUEST_BODY_MAX_BYTES, relayHubManagementRequest } from "./hub-relay";
20
21
  import { createLinkKeySource, handleLinkIngress, type LinkIngress, type LinkKeySourceDeps } from "./link-ingress";
21
22
  import type { LinkTunnelGate } from "./link-relay";
23
+ import { createLinkWebsocketRelay, type LinkWebsocketRelayDeps } from "./link-websocket";
22
24
  import { readClientLinkState, type ClientLinkState } from "./link-state";
23
- import { projectClientLinkChild, type ClientLinkSidecarRead } from "./link-status";
25
+ import { projectClientLinkChild, projectClientLinkRow, type ClientLinkSidecarRead } from "./link-status";
26
+ import { attachLinkTraffic } from "../link/status-projection";
27
+ import { childLinkTraffic } from "../link/traffic";
24
28
  import type { ClientLinkSupervisorStatus } from "./link-tunnel";
25
29
  import type { LinkReadiness } from "./link-readiness";
26
30
  import { packageVersion } from "../lib/package-version";
@@ -69,6 +73,8 @@ export interface MachineListenerDeps {
69
73
  linkTunnel?: LinkTunnelGate;
70
74
  /** Link mode: relay seams (deadline clock and byte cap). */
71
75
  linkRelay?: LinkIngress["relay"];
76
+ /** Link mode: seams of the Responses WebSocket over the link (release gate, timers, limits). */
77
+ linkWebsocket?: Partial<LinkWebsocketRelayDeps>;
72
78
  /**
73
79
  * Link mode: whether relayed requests can be served now. `GET /readyz` answers 503 `pending`
74
80
  * with `link.reason` while it is not; `/healthz` is unaffected (`link-readiness.ts`).
@@ -107,8 +113,8 @@ export function machineRouteAllowed(url: URL, req: Request, relayEnabled: boolea
107
113
  // The bound restart. Only a capability signed for this exact process admits it (see the handler).
108
114
  if (req.method === SYSTEM_RESTART_METHOD && path === SYSTEM_RESTART_PATH) return true;
109
115
  if ((req.method === "GET" || req.method === "HEAD") && (path === "/api/machine/status" || path === "/api/machine/clients" || path === "/api/machine/shim")) return true;
110
- // The one link route a connected Child serves: its own read-only link status.
111
- if (linkMode && (req.method === "GET" || req.method === "HEAD") && path === "/api/link/status") return true;
116
+ // The link routes a connected Child serves: its own read-only link status and diagnostics.
117
+ if (linkMode && (req.method === "GET" || req.method === "HEAD") && (path === "/api/link/status" || path === LINK_DIAGNOSTICS_ROUTE)) return true;
112
118
  if (req.method === "POST" && (path === "/api/machine/sync" || path === "/api/machine/shim" || path === "/api/machine/disconnect")) return true;
113
119
  if (relayEnabled && path.startsWith("/api/machine/hub-relay/")) return true;
114
120
  // Known machine endpoints are admitted for every method so an unsupported
@@ -157,6 +163,18 @@ export function startMachineListener(
157
163
  // Link mode only. Everything is resolved once here, so a relayed request reads no file and
158
164
  // builds no policy: the key is cached, the loopback policy is fixed at bind like the listener.
159
165
  const inboundBodyLimit = resolveInboundBodyLimitBytes(config.maxInboundBodyBytes);
166
+ // Link mode only: Codex's upgrade tries the link only when the relay's wanted() lets it (the Child's
167
+ // release gate is open, no opt-out, and the Home's last applied answer is not off; a cached off still tries while
168
+ // the relay drains for a restart); otherwise it keeps today's 426. A tried upgrade can still end in 426 or the
169
+ // transient 503 (link-websocket.ts).
170
+ const linkWebsocket = linkMode
171
+ ? createLinkWebsocketRelay({
172
+ tunnel: deps.linkTunnel, diagnostic: recordLinkDiagnostic,
173
+ // D4: read once at start, like the rest of this listener's config.
174
+ optOut: () => config.linkResponsesWebsocketOptOut === true,
175
+ ...deps.linkWebsocket,
176
+ })
177
+ : null;
160
178
  const linkIngress: LinkIngress | null = linkMode
161
179
  ? {
162
180
  tunnelPort: connection.link!.tunnelPort,
@@ -165,15 +183,18 @@ export function startMachineListener(
165
183
  policy: requestPolicyView(config, "127.0.0.1"),
166
184
  linkKey: deps.linkKeySource ?? createLinkKeySource(connection.tokenFingerprint, deps.linkKey),
167
185
  relay: { diagnostic: recordLinkDiagnostic, fetchImpl: deps.fetchImpl, bodyLimitBytes: inboundBodyLimit, tunnel: deps.linkTunnel, ...deps.linkRelay },
186
+ ...(linkWebsocket ? { websocket: linkWebsocket } : {}),
168
187
  }
169
188
  : null;
170
- return (deps.serve ?? (options => Bun.serve(options)))({
189
+ const server = (deps.serve ?? (options => Bun.serve(options)))({
171
190
  port: port ?? config.port ?? 10100,
172
191
  hostname: "127.0.0.1",
173
192
  // A hub client relays only bounded management calls. A link Child carries the Codex data
174
193
  // plane, so it admits what a standalone listener admits and keeps its idle limit.
175
194
  maxRequestBodySize: linkMode ? inboundBodyLimit : HUB_RELAY_REQUEST_BODY_MAX_BYTES,
176
195
  ...(linkMode ? { idleTimeout: LINK_LISTENER_IDLE_TIMEOUT_SECONDS } : {}),
196
+ // Only an upgrade the link WebSocket admitted ever reaches server.upgrade (link-websocket.ts).
197
+ ...(linkWebsocket ? { websocket: linkWebsocket.handler() } : {}),
177
198
  async fetch(req: Request, server: Server<unknown>) {
178
199
  const url = new URL(req.url);
179
200
  if (linkIngress) {
@@ -251,7 +272,7 @@ export function startMachineListener(
251
272
  else hubReachability = "online";
252
273
  return response;
253
274
  }
254
- if (url.pathname.startsWith("/api/machine/") || (linkMode && url.pathname === "/api/link/status")) {
275
+ if (url.pathname.startsWith("/api/machine/") || (linkMode && (url.pathname === "/api/link/status" || url.pathname === LINK_DIAGNOSTICS_ROUTE))) {
255
276
  const authError = requireManagementAuth(req, managementAuth, config);
256
277
  if (authError) return authError;
257
278
  if (managementPrincipal(req, managementAuth, config) !== "gui-session") {
@@ -268,10 +289,23 @@ export function startMachineListener(
268
289
  if (req.method !== "GET" && req.method !== "HEAD") {
269
290
  return Response.json({ error: "opencodex machine changes require the local CLI" }, { status: 403 });
270
291
  }
292
+ // This Child's own bounded tunnel evidence, read from its file; never relayed to the Home.
293
+ if (url.pathname === LINK_DIAGNOSTICS_ROUTE) return linkDiagnosticsResponse(url);
271
294
  if (url.pathname === "/api/link/status") {
272
295
  // A Child never joins again from here, so the dashboard reads `joinAvailable: false`.
273
- const status = projectClientLinkChild(readSidecarSafely(readSidecar), deps.linkStatus?.() ?? { kind: "stopped" }, Date.now());
274
- return Response.json({ ...status, joinAvailable: false }, { headers: { "Cache-Control": "no-store" } });
296
+ const sidecar = readSidecarSafely(readSidecar);
297
+ const status = projectClientLinkChild(sidecar, deps.linkStatus?.() ?? { kind: "stopped" }, Date.now());
298
+ // Opt-in (#3023): this Child's link as a row, with the bytes its link transport carried.
299
+ if (url.searchParams.get("traffic") === "1" && connection.link) {
300
+ // One sidecar read per status read: the Home's name is needed only when there is none,
301
+ // and then only from the Home's published settings.
302
+ status.links = [projectClientLinkRow({ ...connection, link: connection.link }, sidecar, status.child, Date.now(),
303
+ undefined, sidecar === null ? linkHomeName(connection, () => null) : null)];
304
+ attachLinkTraffic(status, id => childLinkTraffic.snapshot(id));
305
+ }
306
+ // Opt-in (design 9.3): this Child's own link WebSocket counters.
307
+ const transport = url.searchParams.get("transport") === "1" && linkWebsocket ? { websocket: linkWebsocket.counters() } : {};
308
+ return Response.json({ ...status, joinAvailable: false, ...transport }, { headers: { "Cache-Control": "no-store" } });
275
309
  }
276
310
  return await handleMachineApi(req, url, connection, machineApiDeps) ?? json404(req);
277
311
  }
@@ -302,6 +336,13 @@ export function startMachineListener(
302
336
  return json404(req);
303
337
  },
304
338
  } as Parameters<typeof Bun.serve>[0]);
339
+ if (linkWebsocket) {
340
+ // Any stop, graceful or forced, closes the link sockets first (1001 on both legs): Codex reconnects
341
+ // to whatever serves next, and a graceful drain never waits on an idle Codex socket.
342
+ const stop = server.stop.bind(server);
343
+ server.stop = ((closeActiveConnections?: boolean) => { linkWebsocket.closeAll(); return stop(closeActiveConnections); }) as typeof server.stop;
344
+ }
345
+ return server;
305
346
  }
306
347
 
307
348
  /**
@@ -0,0 +1,293 @@
1
+ /** Production native adapters for the common Home/Child local intent controller. */
2
+ import { existsSync } from "node:fs";
3
+ import { homedir } from "node:os";
4
+ import { join } from "node:path";
5
+ import type { ExportModel } from "../clients/config-export";
6
+ import { loadConfig, mutatePersistedConfig, withConfigMutationLockSync } from "../config";
7
+ import { readConfigForAdmittedMutation } from "../config/persisted-mutation";
8
+ import { commitClaudeCodeBlock } from "../claude/claude-code-block";
9
+ import { localInferenceDestination } from "../lib/local-destinations";
10
+ import { persistCommittedDesktopGateway } from "../claude/desktop-gateway-state";
11
+ import { captureDesktopAppliedMarker, commitDesktopAppliedMarker } from "../claude/desktop-applied-marker";
12
+ import { localClientSyncAllowed } from "../codex/desired-state";
13
+ import { materializeRouteIntent, type RouteClientOutcome, type RouteIntentApplyInput, type RouteIntentReceipt } from "../integrations/route-intent";
14
+ import type { HomeRouteIntentDocument, RouteClientId, RouteClientIntent } from "../link/route-intent";
15
+ import type { OcxConfig } from "../types";
16
+ import { assertNoClientDisconnectPending, readClientConnectionState, sameClientConnectionOwner } from "./state";
17
+ import { withClientLifecycle, withClientLifecycleSync, type ClientLifecycleLockDeps } from "./lifecycle-lock";
18
+ import { assertRouteIntentPort } from "./sync-runtime";
19
+ import { resolveApiSurfaceSettings } from "../protocols/settings";
20
+ import { nativeIntentFields, prepareNativeIntentWrite, publishNativeIntentWrite } from "./route-intent-native-originals";
21
+
22
+ export interface LocalRouteIntentOptions extends Pick<RouteIntentApplyInput,
23
+ "overwriteConflict" | "overwriteClient" | "beforeWrite" | "statePath" | "store" | "home" | "env" | "now" | "onlyClients" | "retainSkippedOutcomes"> {
24
+ /** Connect/sync already applied the Home's Codex settings through the existing injector. */
25
+ codexApplied?: boolean;
26
+ lifecycleLockDeps?: ClientLifecycleLockDeps;
27
+ /** The native client a Home write is deciding; only it may change a Home native switch. */
28
+ decidedClient?: RouteClientId;
29
+ }
30
+
31
+ /**
32
+ * The Home's own native switch, read rather than decided by this apply (a sync, or a write for
33
+ * another client). It is never rewritten here; only the client's owned artifacts follow it.
34
+ */
35
+ function liveHomeSwitch(document: HomeRouteIntentDocument, client: RouteClientId, options: LocalRouteIntentOptions): boolean {
36
+ return document.sources[client] === "native" && options.decidedClient !== client && readClientConnectionState().kind !== "connected";
37
+ }
38
+
39
+ /**
40
+ * An enabled Home Grok or Desktop switch nobody is deciding right now gets exactly the startup
41
+ * behavior: Grok follows the startup gate and Desktop only refreshes a gateway profile OpenCodex
42
+ * already owns. The outcome is "current": the switch is satisfied without creating anything.
43
+ */
44
+ function implicitHomeIntent(document: HomeRouteIntentDocument, client: RouteClientId, intent: RouteClientIntent, options: LocalRouteIntentOptions): boolean {
45
+ return intent.enabled && liveHomeSwitch(document, client, options);
46
+ }
47
+ const IMPLICIT_DESKTOP_MESSAGE = "No OpenCodex-owned Claude Desktop profile to refresh; choose ocx route to claude-desktop on to create one";
48
+
49
+ /**
50
+ * First-party Desktop already routes through OpenCodex, so an enabled intent is satisfied without
51
+ * a write. Turning it off changes the Desktop mode, which only its own transaction may do.
52
+ */
53
+ function firstPartyDesktopOutcome(enabled: boolean, target?: string): RouteClientOutcome {
54
+ const base = { client: "claude-desktop" as const, ...(target === undefined ? {} : { target }) };
55
+ if (enabled) return { ...base, outcome: "current", message: "Claude Desktop first-party mode already routes through OpenCodex" };
56
+ const command = readClientConnectionState().kind === "connected"
57
+ ? "switch modes with ocx claude desktop apply --gateway, then run ocx route to sync"
58
+ : "turn it off with ocx integrations native claude-desktop off";
59
+ return { ...base, outcome: "conflict", message: `Claude Desktop is in first-party mode; ${command}` };
60
+ }
61
+
62
+ /**
63
+ * Caller holds the lifecycle fence; the config coordinator rechecks guard before each commit.
64
+ * `recordStandalone` is true only for a Child's link write: it records the standalone value
65
+ * write-ahead so disconnect or a failed enrollment can restore it. Home writes are the
66
+ * operator's own decisions and are not recorded.
67
+ */
68
+ export function persistNativeRouteIntent(client: "codex" | "claude" | "claude-desktop" | "grok", enabled: boolean, guard: () => void, snapshot: OcxConfig,
69
+ recordStandalone: boolean): OcxConfig {
70
+ const now = new Date();
71
+ const apply = (config: OcxConfig): boolean => {
72
+ const previous = client === "claude" ? config.claudeCode?.enabled !== false : config.clientIntegrations?.[client] !== false;
73
+ if (previous === enabled) return false;
74
+ if (client === "claude") {
75
+ // The legacy flag also supplied the shared Messages API default. A local opt-out
76
+ // must preserve that preexisting exposure for other devices and Desktop clients.
77
+ if (!enabled && resolveApiSurfaceSettings(config).messages.source === "claude-code-legacy") {
78
+ config.apiSurfaces = { ...config.apiSurfaces, messages: { enabled: resolveApiSurfaceSettings(config).messages.enabled } };
79
+ }
80
+ commitClaudeCodeBlock(config, { ...config.claudeCode, enabled }, now);
81
+ }
82
+ else config.clientIntegrations = { ...config.clientIntegrations, [client]: enabled };
83
+ return true;
84
+ };
85
+ const result = withConfigMutationLockSync(() => {
86
+ let recorded = false;
87
+ if (recordStandalone) {
88
+ guard();
89
+ const base = readConfigForAdmittedMutation(), planned = structuredClone(base);
90
+ if (apply(planned)) recorded = prepareNativeIntentWrite(nativeIntentFields(base), nativeIntentFields(planned));
91
+ }
92
+ const outcome = mutatePersistedConfig(config => {
93
+ guard();
94
+ return { changed: apply(config), value: config };
95
+ });
96
+ if (outcome.status !== "unavailable" && recorded) publishNativeIntentWrite(nativeIntentFields(outcome.value));
97
+ return outcome;
98
+ });
99
+ if (result.status === "unavailable") throw new Error(`Local native route intent could not be persisted (${result.reason})`);
100
+ if (client === "claude") {
101
+ snapshot.claudeCode = { ...snapshot.claudeCode, enabled,
102
+ ...(result.value.claudeCode?.authModeMigratedAt ? { authModeMigratedAt: result.value.claudeCode.authModeMigratedAt } : {}) };
103
+ if (result.value.apiSurfaces?.messages !== undefined) snapshot.apiSurfaces = { ...snapshot.apiSurfaces, messages: { ...result.value.apiSurfaces.messages } };
104
+ }
105
+ else if (result.value.clientIntegrations) snapshot.clientIntegrations = { ...result.value.clientIntegrations };
106
+ else delete snapshot.clientIntegrations;
107
+ return result.value;
108
+ }
109
+
110
+ async function applyNative(
111
+ input: RouteIntentApplyInput, options: LocalRouteIntentOptions, client: "codex" | "claude" | "claude-desktop" | "grok", intent: RouteClientIntent,
112
+ ): Promise<RouteClientOutcome> {
113
+ const guard = input.beforeWrite!;
114
+ const home = input.home ?? homedir();
115
+ const env = input.env ?? process.env;
116
+ const desktopMode = client === "claude-desktop" ? await import("../claude/desktop-first-party") : undefined;
117
+ const homeSwitch = liveHomeSwitch(input.document, client, options);
118
+ // The committed flag reaches the caller's working snapshot too. The management owner mirrors
119
+ // these individual flags onto its live config; a copied request config cannot do that for it.
120
+ const committedConfig = withClientLifecycleSync(() => withConfigMutationLockSync(() => {
121
+ guard();
122
+ if (desktopMode) {
123
+ const current = loadConfig();
124
+ if (desktopMode.resolveClaudeDesktopMode(current, desktopMode.observeClaudeDesktopMode(current)) === "first-party") return null;
125
+ }
126
+ if (homeSwitch) return loadConfig();
127
+ // Only a connected Child's write displaces a standalone value; the Home owns its own flags.
128
+ return persistNativeRouteIntent(client, intent.enabled, guard, input.config, readClientConnectionState().kind === "connected");
129
+ }), options.lifecycleLockDeps);
130
+ if (committedConfig === null) return firstPartyDesktopOutcome(intent.enabled);
131
+ if (client === "codex") {
132
+ const { getCodexHome, CODEX_CONFIG_PATH, DEFAULT_CATALOG_PATH } = await import("../codex/paths");
133
+ const { injectCodexConfig, restoreNativeCodexAsync, currentExternalCodexModelProvider, isCodexRoutingInjected } = await import("../codex/inject");
134
+ const target = CODEX_CONFIG_PATH;
135
+ guard();
136
+ if (!existsSync(getCodexHome())) return { client, target, outcome: intent.enabled ? "not_installed" : "current" };
137
+ if (intent.enabled && options.codexApplied) return { client, target, outcome: "current" };
138
+ const externalProvider = currentExternalCodexModelProvider();
139
+ if (externalProvider) {
140
+ const { approvedCodexProviders } = await import("../codex/provider-routing");
141
+ if (!approvedCodexProviders().includes(externalProvider)) return { client, target, outcome: intent.enabled ? "conflict" : "current", message: "Codex has an external provider" };
142
+ }
143
+ if (!intent.enabled && !isCodexRoutingInjected()) return { client, target, outcome: "current" };
144
+ const config = committedConfig;
145
+ if (!intent.enabled) {
146
+ const result = await restoreNativeCodexAsync({ withWriteGuard: work => withConfigMutationLockSync(() => { guard(); return work(); }) });
147
+ return { client, target, outcome: result.success ? "current" : "failed", message: result.message };
148
+ }
149
+ const state = readClientConnectionState();
150
+ const result = await injectCodexConfig(input.config.port, { ...config, syncResumeHistory: false }, {
151
+ catalogPath: DEFAULT_CATALOG_PATH, beforeClientWrite: guard,
152
+ ...(state.kind === "connected" ? { journalOwner: { kind: "client" as const, apiKeyId: state.value.apiKeyId },
153
+ routingTarget: { baseUrl: `http://127.0.0.1:${input.config.port}/v1`, requiresAdmissionToken: false, tokenEnv: "OPENCODEX_API_AUTH_TOKEN" as const } } : {}),
154
+ });
155
+ return { client, target, outcome: result.success && result.status !== "skipped" ? "current" : "failed", message: result.message };
156
+ }
157
+ if (client === "claude") {
158
+ const target = env.CLAUDE_CONFIG_DIR || join(home, ".claude");
159
+ if (!existsSync(target)) return { client, target, outcome: intent.enabled ? "not_installed" : "current" };
160
+ if (!intent.enabled) {
161
+ const { injectClaudeAgentDefs } = await import("../claude/agents-inject");
162
+ const cleaned = withClientLifecycleSync(() => { guard(); return injectClaudeAgentDefs(committedConfig, {}, target); }, options.lifecycleLockDeps);
163
+ if (cleaned === null) return { client, target, outcome: "failed", message: "Owned Claude agent definitions could not be removed" };
164
+ }
165
+ // Claude Code uses the existing launcher and selectedClients gate; no foreign config is copied.
166
+ return { client, target, outcome: "current" };
167
+ }
168
+ if (client === "grok") {
169
+ const { injectGrokConfig, stripGrokConfig } = await import("../grok/inject");
170
+ const { inspectGrokConfig } = await import("../grok/inspect");
171
+ const grokHome = env.GROK_HOME || join(home, ".grok");
172
+ const target = join(grokHome, "config.toml");
173
+ if (implicitHomeIntent(input.document, client, intent, options) && !localClientSyncAllowed(input.config)) {
174
+ return { client, target, outcome: "current", message: "Grok sync is gated on this Home, as it is at startup" };
175
+ }
176
+ return withClientLifecycleSync(() => withConfigMutationLockSync(() => {
177
+ guard();
178
+ const state = inspectGrokConfig({ grokHome });
179
+ if (state.kind === "not_installed") return { client, target, outcome: intent.enabled ? "not_installed" : "current" };
180
+ if (state.kind === "orphaned_marker") return { client, target, outcome: "conflict", message: "Grok managed block is incomplete" };
181
+ if (!intent.enabled && state.kind === "absent") return { client, target, outcome: "current" };
182
+ const destination = localInferenceDestination(input.config, input.config.port);
183
+ if (intent.enabled && destination.requiresAdmissionToken) return { client, target, outcome: "failed", message: "Grok requires a credential-free local listener" };
184
+ const result = intent.enabled ? injectGrokConfig(destination.port, input.models.map(model => ({
185
+ id: model.namespaced, name: model.displayName, contextWindow: model.contextWindow,
186
+ reasoningEfforts: model.reasoningEfforts, defaultReasoningEffort: model.defaultReasoningEffort,
187
+ })), { grokHome, hostname: "127.0.0.1" }) : stripGrokConfig({ grokHome });
188
+ return { client, target, outcome: result.ok && !result.skippedReason ? "current" : "failed", message: result.message };
189
+ }), options.lifecycleLockDeps);
190
+ }
191
+ const desktop = await import("../claude/desktop-3p");
192
+ guard();
193
+ // The durable marker: a caller's snapshot can predate a Desktop apply by another process.
194
+ const inspected = desktop.inspectDesktop3pConfigLibrary({ appliedFingerprint: committedConfig.claudeCode?.desktopProfile?.appliedFingerprint });
195
+ const target = inspected.selectedProfilePath ?? inspected.libraryPath;
196
+ if (inspected.kind === "not_installed") return { client, target, outcome: intent.enabled ? "not_installed" : "current" };
197
+ const state = readClientConnectionState();
198
+ // Connected profiles carry their own owner/projection evidence, not the standalone marker.
199
+ if (!intent.enabled && state.kind === "connected") {
200
+ guard();
201
+ const result = desktop.removeDesktop3pStandardPivot({ lifecycleLockDeps: options.lifecycleLockDeps });
202
+ return { client, target, outcome: result.ok ? "current" : result.reason === "conflict" ? "conflict" : "failed" };
203
+ }
204
+ const firstParty = (config: OcxConfig) => desktopMode!.resolveClaudeDesktopMode(config, desktopMode!.observeClaudeDesktopMode(config)) === "first-party";
205
+ const modeConflict: RouteClientOutcome = { client, target, outcome: "conflict", message: "Claude Desktop first-party mode needs its existing mode-switch transaction" };
206
+ if (intent.enabled && state.kind === "connected") {
207
+ const { applyRemoteDesktopStore } = await import("../claude/desktop-remote-store");
208
+ const { readServiceApiTokenState } = await import("../lib/service-secrets");
209
+ const models = desktop.generateDesktop3pModels(input.models.filter(model => model.native).map(model => model.id),
210
+ input.models.filter(model => !model.native).map(model => ({ provider: model.provider, id: model.id, contextWindow: model.contextWindow })));
211
+ return withClientLifecycleSync(held => withConfigMutationLockSync(() => {
212
+ guard();
213
+ if (firstParty(loadConfig())) return firstPartyDesktopOutcome(true, target);
214
+ const token = readServiceApiTokenState();
215
+ if (token.kind !== "present") return { client, target, outcome: "failed", message: "Child service credential is unavailable" };
216
+ const result = applyRemoteDesktopStore(held, {
217
+ owner: { serverUrl: state.value.serverUrl, apiKeyId: state.value.apiKeyId, connectedAt: state.value.connectedAt },
218
+ expectedTokenFingerprint: token.fingerprint, baseUrl: `http://127.0.0.1:${input.config.port}`,
219
+ apiKey: "opencodex-loopback", mode: "static", models, localListener: true, overwriteConflict: options.overwriteConflict,
220
+ });
221
+ return { client, target: result.ok ? result.path ?? target : target, outcome: result.ok ? "current" : result.reason === "conflict" ? "conflict" : "failed" };
222
+ }), options.lifecycleLockDeps);
223
+ }
224
+ if (!intent.enabled && inspected.kind === "no_owned_state") return { client, target, outcome: "current" };
225
+ const appliedFingerprint = committedConfig.claudeCode?.desktopProfile?.appliedFingerprint;
226
+ const refreshOnly = implicitHomeIntent(input.document, client, intent, options);
227
+ const changedProfile = ["unsafe", "broken", "gateway_drifted"].includes(inspected.kind);
228
+ if (changedProfile && refreshOnly) {
229
+ // Only an OpenCodex-owned profile can have changed under a refresh. An unreadable library or one
230
+ // selecting another app's profile was never ours, so the refresh has nothing to do there.
231
+ const owned = inspected.ownedProfileActive === true || (inspected.ownedProfileActive === null && !!appliedFingerprint);
232
+ if (!owned) return { client, target, outcome: "current", message: IMPLICIT_DESKTOP_MESSAGE };
233
+ // A refresh never takes over a changed profile, even with overwrite: that is a decided write.
234
+ return { client, target, outcome: "conflict",
235
+ message: "Claude Desktop ownership or profile changed; replace it with ocx route to claude-desktop on --device home --overwrite-conflict" };
236
+ }
237
+ if (changedProfile && !options.overwriteConflict) return { client, target, outcome: "conflict", message: "Claude Desktop ownership or profile changed" };
238
+ // Only an absent or untouched profile satisfies a refresh-only switch.
239
+ if (refreshOnly && (inspected.kind !== "gateway_ours" || !appliedFingerprint)) return { client, target, outcome: "current", message: IMPLICIT_DESKTOP_MESSAGE };
240
+ if (!intent.enabled) {
241
+ guard();
242
+ const result = desktop.removeDesktop3pStandardPivot({ appliedFingerprint: committedConfig.claudeCode?.desktopProfile?.appliedFingerprint, lifecycleLockDeps: options.lifecycleLockDeps });
243
+ return { client, target, outcome: result.ok ? "current" : "failed" };
244
+ }
245
+ const { getClaudePickerController } = await import("../claude/intercept/runtime");
246
+ const { runDesktopTransition } = await import("../claude/desktop-picker");
247
+ // Mode switches share picker exclusion in-process and L→C across CLI/server writers.
248
+ // Keep the file write and marker together, reusing the existing writer with this lease.
249
+ return runDesktopTransition<RouteClientOutcome>(getClaudePickerController(), async () => withClientLifecycleSync(held => withConfigMutationLockSync(() => {
250
+ guard();
251
+ const config = loadConfig();
252
+ if (firstParty(config)) return firstPartyDesktopOutcome(true, target);
253
+ const profile = config.claudeCode?.desktopProfile;
254
+ const result = desktop.writeDesktop3pConfig(input.config.port,
255
+ input.models.filter(model => model.native).map(model => model.id),
256
+ input.models.filter(model => !model.native).map(model => ({ provider: model.provider, id: model.id, contextWindow: model.contextWindow })),
257
+ undefined, "static", profile, undefined, options.lifecycleLockDeps,
258
+ refreshOnly ? { appliedFingerprint: appliedFingerprint!, admit: () => !firstParty(loadConfig()) } : undefined, held);
259
+ if (refreshOnly && result.reason === "desktop_refresh_only_skipped") return { client, target, outcome: "current", message: IMPLICIT_DESKTOP_MESSAGE };
260
+ if (!result.written) return { client, target, outcome: "failed", message: result.reason ?? "Claude Desktop writer refused" };
261
+ guard();
262
+ if (firstParty(loadConfig())) return modeConflict;
263
+ if (refreshOnly) {
264
+ // A refresh keeps the existing mode; only the applied marker follows the new bytes.
265
+ const marked = commitDesktopAppliedMarker(captureDesktopAppliedMarker(profile), result.fingerprint!);
266
+ return { client, target, outcome: marked.status !== "unavailable" && marked.value ? "current" : "failed" };
267
+ }
268
+ const recorded = persistCommittedDesktopGateway(config, config.claudeCode?.desktopProfile, result.fingerprint, current => !firstParty(current));
269
+ return { client, target, outcome: recorded.ok ? "current" : "failed" };
270
+ }), options.lifecycleLockDeps), { config: committedConfig });
271
+ }
272
+
273
+ export function materializeLocalRouteIntent(
274
+ config: OcxConfig, document: HomeRouteIntentDocument, models: readonly ExportModel[], options: LocalRouteIntentOptions = {},
275
+ ): Promise<RouteIntentReceipt> {
276
+ const expected = readClientConnectionState();
277
+ const configuredPort = loadConfig().port;
278
+ const beforeWrite = () => {
279
+ options.beforeWrite?.();
280
+ assertRouteIntentPort(config.port);
281
+ if (loadConfig().port !== configuredPort) throw new Error("client_runtime_changed");
282
+ assertNoClientDisconnectPending();
283
+ const current = readClientConnectionState();
284
+ if (expected.kind === "connected" ? current.kind !== "connected" || !sameClientConnectionOwner(current.value, expected.value)
285
+ : current.kind !== expected.kind || current.kind !== "disconnected") throw new Error("client_connection_changed");
286
+ };
287
+ const input: RouteIntentApplyInput = { config, document: structuredClone(document), models: structuredClone([...models]), ...options, beforeWrite,
288
+ ...(expected.kind === "connected" && expected.value.link ? { linkId: expected.value.link.linkId } : {}),
289
+ localOff: expected.kind === "connected" && expected.value.transport === "link" ? undefined : [] };
290
+ return materializeRouteIntent({ ...input, withFileWrites: work => withClientLifecycle(work, options.lifecycleLockDeps),
291
+ withReceiptWrite: write => withClientLifecycleSync(() => { beforeWrite(); write(); }, options.lifecycleLockDeps),
292
+ applyNative: (client, intent) => applyNative(input, { ...options, overwriteConflict: options.overwriteConflict === true && (options.overwriteClient === undefined || options.overwriteClient === client) }, client, intent) });
293
+ }
@@ -0,0 +1,97 @@
1
+ /**
2
+ * File integrations a linked Child owned before linking.
3
+ *
4
+ * A Child applying its Home's route intent disables, refreshes or creates file-integration blocks.
5
+ * Without this record, disconnect cannot tell a block the link created from one the person had
6
+ * set up on their own, and removed both. At the first link apply, before any client changes, the
7
+ * Child records which file clients had an ownership record (with their model-name policy). The
8
+ * record is private, bound to the link that captured it, and carries no paths or secrets.
9
+ *
10
+ * Disconnect restores those clients to their standalone state: a client the link left owned is
11
+ * kept as is, a client the link disabled is applied again, and a client the person changed in the
12
+ * meantime (a local opt-out, or a block of their own) is left alone. Clients the link created keep
13
+ * the ordinary cleanup. Aside profiles are not recorded and keep that cleanup too.
14
+ *
15
+ * Callers hold the client lifecycle lock; reads are strict, so a damaged record refuses the
16
+ * disconnect instead of silently dropping a standalone integration.
17
+ */
18
+ import { chmodSync, lstatSync, mkdirSync, readFileSync, unlinkSync } from "node:fs";
19
+ import { join } from "node:path";
20
+ import { atomicWriteFile, isMissingPathError } from "../config/atomic-write";
21
+ import { assertNotRealHomeUnderTest } from "../lib/test-home-guard";
22
+ import { hardenSecretDir } from "../lib/windows-secret-acl";
23
+ import { linkDir } from "../link/paths";
24
+ import { ROUTE_CLIENT_IDS, type RouteClientId } from "../link/route-intent";
25
+
26
+ type ModelNames = "alias" | "routed";
27
+ export interface FileIntentOriginals {
28
+ version: 1;
29
+ linkId: string;
30
+ clients: Partial<Record<RouteClientId, { modelNames?: ModelNames }>>;
31
+ }
32
+
33
+ const RECORD_MAX_BYTES = 16 * 1024;
34
+ const NOT_FILE_CLIENTS: readonly RouteClientId[] = ["codex", "claude", "claude-desktop", "grok", "aside"];
35
+ const FILE_CLIENTS = ROUTE_CLIENT_IDS.filter(client => !NOT_FILE_CLIENTS.includes(client));
36
+ const isRecord = (value: unknown): value is Record<string, unknown> => value !== null && typeof value === "object" && !Array.isArray(value);
37
+
38
+ export function fileIntentOriginalsPath(): string { return join(linkDir(), "file-intent-originals.json"); }
39
+
40
+ const unsafe = (): never => {
41
+ throw new Error(`File integration originals record is unreadable; inspect or remove ${fileIntentOriginalsPath()} and retry`);
42
+ };
43
+
44
+ function parse(value: unknown): FileIntentOriginals {
45
+ if (!isRecord(value) || value.version !== 1 || typeof value.linkId !== "string" || !/^lnk_[0-9a-f]{16}$/.test(value.linkId)
46
+ || !isRecord(value.clients) || Object.keys(value).length !== 3) return unsafe();
47
+ for (const [client, entry] of Object.entries(value.clients)) {
48
+ if (!(FILE_CLIENTS as readonly string[]).includes(client) || !isRecord(entry)
49
+ || Object.keys(entry).some(key => key !== "modelNames")
50
+ || (entry.modelNames !== undefined && entry.modelNames !== "alias" && entry.modelNames !== "routed")) return unsafe();
51
+ }
52
+ return value as unknown as FileIntentOriginals;
53
+ }
54
+
55
+ /** Missing reads as null; a present but malformed record refuses. */
56
+ export function readFileIntentOriginals(): FileIntentOriginals | null {
57
+ let stat;
58
+ try { stat = lstatSync(fileIntentOriginalsPath()); } catch (error) { if (isMissingPathError(error)) return null; throw error; }
59
+ if (!stat.isFile() || stat.size > RECORD_MAX_BYTES) return unsafe();
60
+ let value: unknown;
61
+ try { value = JSON.parse(readFileSync(fileIntentOriginalsPath(), "utf8")); } catch { return unsafe(); }
62
+ return parse(value);
63
+ }
64
+
65
+ function writeRecord(record: FileIntentOriginals): void {
66
+ parse(record);
67
+ const dir = linkDir();
68
+ assertNotRealHomeUnderTest(join(dir, ".."));
69
+ mkdirSync(dir, { recursive: true, mode: 0o700 });
70
+ if (process.platform === "win32") hardenSecretDir(dir, { required: true });
71
+ else chmodSync(dir, 0o700);
72
+ atomicWriteFile(fileIntentOriginalsPath(), `${JSON.stringify(record, null, 2)}\n`);
73
+ if (process.platform !== "win32") chmodSync(fileIntentOriginalsPath(), 0o600);
74
+ }
75
+
76
+ export function clearFileIntentOriginals(): void {
77
+ assertNotRealHomeUnderTest(join(linkDir(), ".."));
78
+ try { unlinkSync(fileIntentOriginalsPath()); } catch (error) { if (!isMissingPathError(error)) throw error; }
79
+ }
80
+
81
+ /**
82
+ * Write-ahead capture for a link's first apply. `firstApply` is false once a route receipt bound
83
+ * to a link exists, so clients a link created are never recorded as standalone. A record from
84
+ * another link is stale and is replaced.
85
+ */
86
+ export function captureFileIntentOriginals(linkId: string, firstApply: boolean,
87
+ owners: Partial<Record<string, { modelNames?: ModelNames } | undefined>>): void {
88
+ const existing = readFileIntentOriginals();
89
+ if (existing?.linkId === linkId || !firstApply) return;
90
+ const clients: FileIntentOriginals["clients"] = {};
91
+ for (const client of FILE_CLIENTS) {
92
+ const owner = owners[client];
93
+ if (owner) clients[client] = owner.modelNames ? { modelNames: owner.modelNames } : {};
94
+ }
95
+ if (Object.keys(clients).length === 0) { if (existing) clearFileIntentOriginals(); return; }
96
+ writeRecord({ version: 1, linkId, clients });
97
+ }