@bitkyc08/opencodex 2.100.2 → 2.100.3

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 (561) hide show
  1. package/README.md +1 -1
  2. package/bin/ocx.mjs +32 -18
  3. package/gui/dist/assets/{App-COo8Yopd.css → App-BGP8I0V4.css} +1 -1
  4. package/gui/dist/assets/App-Dnb6VMsP.js +59 -0
  5. package/gui/dist/assets/{Tray-BcaI-VCr.js → Tray-BV4ms9U9.js} +1 -1
  6. package/gui/dist/assets/{brand-mark-DU-0Vdkr.js → brand-mark-XOLJbomA.js} +1 -1
  7. package/gui/dist/assets/index-DCdXsMyZ.js +105 -0
  8. package/gui/dist/assets/{index-DJEkIDAi.css → index-DQtCRNAw.css} +1 -1
  9. package/gui/dist/assets/{segment-thumb-features-e9A_FogJ.js → segment-thumb-features-DXSidY6D.js} +1 -1
  10. package/gui/dist/classic/assets/App-DA-scMPq.js +58 -0
  11. package/gui/dist/classic/assets/{Tray-DT146AhS.js → Tray-BrHaVRAq.js} +1 -1
  12. package/gui/dist/classic/assets/index-BqOaGLf5.js +105 -0
  13. package/gui/dist/classic/assets/{quota-summary-CakPe9Ni.js → quota-summary-Dy5_wfTT.js} +1 -1
  14. package/gui/dist/classic/index.html +1 -1
  15. package/gui/dist/index.html +2 -2
  16. package/native/ocx-child/Cargo.toml +9 -0
  17. package/native/ocx-child/src/cli.rs +402 -20
  18. package/native/ocx-child/src/codex_home.rs +98 -14
  19. package/native/ocx-child/src/daemon.rs +2 -1
  20. package/native/ocx-child/src/lib.rs +3 -0
  21. package/native/ocx-child/src/link_ws.rs +2598 -0
  22. package/native/ocx-child/src/link_ws_advert.rs +346 -0
  23. package/native/ocx-child/src/link_ws_frame.rs +749 -0
  24. package/native/ocx-child/src/parity.rs +5 -1
  25. package/native/ocx-child/src/platform.rs +152 -6
  26. package/native/ocx-child/src/relay.rs +150 -19
  27. package/package.json +3 -3
  28. package/src/adapters/anthropic/advisor-tool.ts +176 -0
  29. package/src/adapters/anthropic/beta-body-pairs.ts +6 -0
  30. package/src/adapters/anthropic/client-identity.ts +3 -1
  31. package/src/adapters/anthropic/passthrough.ts +9 -3
  32. package/src/adapters/anthropic.ts +31 -14
  33. package/src/adapters/client-fingerprint.ts +3 -3
  34. package/src/adapters/cursor/discovery.ts +17 -0
  35. package/src/adapters/cursor/native-exec-desktop.ts +2 -1
  36. package/src/adapters/cursor/native-exec-shell.ts +2 -1
  37. package/src/adapters/cursor/protobuf-request.ts +8 -8
  38. package/src/adapters/cursor.ts +7 -6
  39. package/src/adapters/google-antigravity-wire.ts +7 -5
  40. package/src/adapters/google-wire-compiler.ts +2 -2
  41. package/src/adapters/google.ts +9 -2
  42. package/src/adapters/kiro/payload.ts +7 -4
  43. package/src/adapters/kiro/reasoning.ts +44 -1
  44. package/src/adapters/kiro/structured-output.ts +10 -8
  45. package/src/adapters/kiro-tools.ts +61 -15
  46. package/src/adapters/openai-chat/destination-policy.ts +16 -0
  47. package/src/adapters/openai-chat/reasoning-replay.ts +4 -1
  48. package/src/adapters/zed.ts +3 -0
  49. package/src/advisor/consult.ts +15 -4
  50. package/src/advisor/context.ts +12 -3
  51. package/src/advisor/runtime.ts +35 -5
  52. package/src/advisor/settings.ts +8 -0
  53. package/src/advisor/synthetic-tool.ts +21 -8
  54. package/src/bridge/response-json.ts +11 -2
  55. package/src/bridge/sse.ts +43 -8
  56. package/src/claude/auth-detect.ts +21 -33
  57. package/src/claude/desktop-3p.ts +11 -5
  58. package/src/claude/desktop-gateway-state.ts +2 -0
  59. package/src/claude/desktop-remote-store-artifact.ts +14 -3
  60. package/src/claude/desktop-remote-store.ts +24 -4
  61. package/src/claude/inbound-content-options.ts +31 -16
  62. package/src/claude/outbound.ts +13 -3
  63. package/src/cli/account-api.ts +17 -1
  64. package/src/cli/account-auth.ts +54 -21
  65. package/src/cli/account-key-quota.ts +34 -5
  66. package/src/cli/account.ts +4 -2
  67. package/src/cli/advisor.ts +7 -4
  68. package/src/cli/alias.ts +38 -1
  69. package/src/cli/capabilities-access-remote.ts +128 -3
  70. package/src/cli/capabilities-accounts.ts +3 -3
  71. package/src/cli/capabilities-agents-routing.ts +17 -10
  72. package/src/cli/capabilities-base.ts +41 -16
  73. package/src/cli/capabilities-integrations.ts +2 -2
  74. package/src/cli/capabilities-provider-models.ts +18 -2
  75. package/src/cli/capabilities-route-to.ts +43 -0
  76. package/src/cli/capabilities.ts +2 -0
  77. package/src/cli/capability-contracts.ts +1 -1
  78. package/src/cli/claude-desktop.ts +30 -11
  79. package/src/cli/claude.ts +17 -3
  80. package/src/cli/codex-launcher.ts +3 -1
  81. package/src/cli/codex-shim-autorestore.ts +5 -42
  82. package/src/cli/config-command.ts +14 -1
  83. package/src/cli/config-root-startup.ts +34 -0
  84. package/src/cli/connect.ts +88 -16
  85. package/src/cli/desktop-runtime-guidance.ts +1 -1
  86. package/src/cli/disconnect-runtime.ts +168 -0
  87. package/src/cli/dispatch.ts +54 -12
  88. package/src/cli/export-command.ts +1 -1
  89. package/src/cli/gui-pair-client.ts +6 -3
  90. package/src/cli/gui.ts +10 -5
  91. package/src/cli/help-catalog.ts +11 -0
  92. package/src/cli/help.ts +4 -3
  93. package/src/cli/index.ts +83 -92
  94. package/src/cli/inspect.ts +11 -2
  95. package/src/cli/integrations.ts +26 -1
  96. package/src/cli/link-capture.ts +64 -0
  97. package/src/cli/link-child-ops.ts +218 -40
  98. package/src/cli/link-cleanup.ts +8 -5
  99. package/src/cli/link-diagnostics.ts +67 -0
  100. package/src/cli/link-enrollment.ts +158 -12
  101. package/src/cli/link-operations.ts +52 -0
  102. package/src/cli/link-recover.ts +152 -0
  103. package/src/cli/link-routes.ts +87 -0
  104. package/src/cli/link-status-child.ts +44 -1
  105. package/src/cli/link-status-traffic.ts +34 -0
  106. package/src/cli/link.ts +314 -37
  107. package/src/cli/message-command.ts +1 -1
  108. package/src/cli/message-mcp-command.ts +23 -10
  109. package/src/cli/models-runtime.ts +3 -3
  110. package/src/cli/opencode.ts +3 -1
  111. package/src/cli/pi-sync.ts +35 -0
  112. package/src/cli/preflight-exemptions.ts +46 -0
  113. package/src/cli/registry.ts +28 -12
  114. package/src/cli/restart-failure.ts +5 -2
  115. package/src/cli/root.ts +5 -1
  116. package/src/cli/route-to.ts +172 -0
  117. package/src/cli/runtime-api.ts +5 -8
  118. package/src/cli/status.ts +3 -1
  119. package/src/cli/stop-approval.ts +66 -19
  120. package/src/cli/stop-report.ts +23 -0
  121. package/src/cli/stop-windows-checked.ts +304 -0
  122. package/src/cli/sync-command.ts +70 -15
  123. package/src/cli/sync-fanout.ts +74 -19
  124. package/src/cli/sync-flags.ts +40 -3
  125. package/src/cli/sync-link-status.ts +18 -2
  126. package/src/cli/sync-update-guard.ts +7 -2
  127. package/src/cli/system-restart-client.ts +3 -2
  128. package/src/cli/uninstall-plan.ts +77 -5
  129. package/src/cli/uninstall-stop.ts +152 -0
  130. package/src/cli/v2-input.ts +10 -6
  131. package/src/cli/v2-local-output.ts +3 -2
  132. package/src/cli/v2-runtime.ts +10 -3
  133. package/src/cli/v2.ts +22 -7
  134. package/src/client/connect.ts +321 -34
  135. package/src/client/link-home-features.ts +27 -0
  136. package/src/client/link-home.ts +92 -4
  137. package/src/client/link-ingress.ts +21 -3
  138. package/src/client/link-join.ts +12 -2
  139. package/src/client/link-parity-reporter.ts +60 -6
  140. package/src/client/link-relay-transport.ts +161 -36
  141. package/src/client/link-relay.ts +150 -6
  142. package/src/client/link-request-compression.ts +84 -0
  143. package/src/client/link-state.ts +11 -5
  144. package/src/client/link-status.ts +39 -1
  145. package/src/client/link-teardown.ts +1 -0
  146. package/src/client/link-tunnel.ts +56 -5
  147. package/src/client/link-websocket-limits.ts +89 -0
  148. package/src/client/link-websocket.ts +586 -0
  149. package/src/client/link-ws-advertisement.ts +100 -0
  150. package/src/client/link-ws-framer.ts +241 -0
  151. package/src/client/link-ws-transport.ts +177 -0
  152. package/src/client/machine-api.ts +13 -2
  153. package/src/client/machine-listener.ts +48 -7
  154. package/src/client/route-intent-apply.ts +293 -0
  155. package/src/client/route-intent-file-originals.ts +97 -0
  156. package/src/client/route-intent-native-originals.ts +201 -0
  157. package/src/client/route-intent-watch.ts +141 -0
  158. package/src/client/runtime-restart.ts +127 -5
  159. package/src/client/runtime.ts +61 -15
  160. package/src/client/state.ts +30 -0
  161. package/src/client/sync-expectation.ts +36 -2
  162. package/src/client/sync-runtime.ts +7 -0
  163. package/src/clients/config-export/alias-selectors.ts +63 -40
  164. package/src/clients/config-export/contracts.ts +2 -0
  165. package/src/clients/config-export/nested-selectors.ts +42 -0
  166. package/src/clients/config-export.ts +22 -3
  167. package/src/codex/account-store.ts +12 -3
  168. package/src/codex/account-usability.ts +13 -0
  169. package/src/codex/auth-api/account-list.ts +29 -3
  170. package/src/codex/auth-collision.ts +23 -22
  171. package/src/codex/auth-context.ts +21 -6
  172. package/src/codex/catalog/gather-capture.ts +8 -2
  173. package/src/codex/catalog/parsing.ts +7 -3
  174. package/src/codex/catalog/provider-models.ts +54 -15
  175. package/src/codex/catalog/retained-sync.ts +2 -1
  176. package/src/codex/catalog/routed-gather.ts +1 -1
  177. package/src/codex/catalog-auto-refresh.ts +11 -0
  178. package/src/codex/cli-update-job.ts +35 -13
  179. package/src/codex/convergence.ts +2 -2
  180. package/src/codex/desktop-compatibility/native-identity.ts +4 -8
  181. package/src/codex/features.ts +2 -2
  182. package/src/codex/history-provider.ts +31 -0
  183. package/src/codex/inject/multi-agent-v2.ts +9 -3
  184. package/src/codex/inject/paginated-openai-compat.ts +54 -1
  185. package/src/codex/inject/plan.ts +20 -2
  186. package/src/codex/inject.ts +2 -0
  187. package/src/codex/journal-config-restore.ts +217 -0
  188. package/src/codex/journal.ts +75 -6
  189. package/src/codex/main-account.ts +23 -30
  190. package/src/codex/native-main-auth-file.ts +104 -0
  191. package/src/codex/native-profile-manager.ts +4 -3
  192. package/src/codex/native-profile-store.ts +3 -61
  193. package/src/codex/orca-import.ts +10 -1
  194. package/src/codex/quota-history.ts +13 -0
  195. package/src/codex/quota-window-conflict.ts +103 -0
  196. package/src/codex/quota.ts +23 -1
  197. package/src/codex/subagent-model-fallback.ts +3 -1
  198. package/src/codex/websocket-activity.ts +171 -16
  199. package/src/codex/websocket-registry.ts +11 -4
  200. package/src/combos/cooldown-store.ts +25 -5
  201. package/src/combos/failover.ts +330 -2
  202. package/src/config/dashboard-trusted-proxy.ts +83 -0
  203. package/src/config/diagnostics.ts +28 -0
  204. package/src/config/feature-flags.ts +9 -0
  205. package/src/config/live-reconcile.ts +10 -1
  206. package/src/config/load-degrade.ts +12 -1
  207. package/src/config/multi-agent-surface.ts +28 -5
  208. package/src/config/pending-teardown.ts +60 -3
  209. package/src/config/process-state.ts +175 -4
  210. package/src/config/provider-validation.ts +4 -4
  211. package/src/config/schema/config-schema.ts +6 -0
  212. package/src/config/schema/leaf-validators.ts +9 -2
  213. package/src/config/windows-process-command-line.ts +107 -0
  214. package/src/generated/compatibility-version.json +948 -392
  215. package/src/generated/model-metadata.ts +1 -1
  216. package/src/images/loop.ts +3 -0
  217. package/src/integrations/model-name-guard.ts +25 -0
  218. package/src/integrations/route-intent-catalog.ts +26 -0
  219. package/src/integrations/route-intent-connected.ts +262 -0
  220. package/src/integrations/route-intent-contract.ts +55 -0
  221. package/src/integrations/route-intent-disconnect.ts +109 -0
  222. package/src/integrations/route-intent-initial.ts +64 -0
  223. package/src/integrations/route-intent-state.ts +117 -0
  224. package/src/integrations/route-intent-tick.ts +65 -0
  225. package/src/integrations/route-intent.ts +212 -0
  226. package/src/integrations/writer.ts +44 -11
  227. package/src/lib/client-retry-after.ts +29 -0
  228. package/src/lib/config-ownership.ts +13 -0
  229. package/src/lib/desktop-gui-origin.ts +28 -0
  230. package/src/lib/errors.ts +1 -1
  231. package/src/lib/gui-pair-capability.ts +2 -1
  232. package/src/lib/messages-error-body.ts +4 -1
  233. package/src/lib/outbound-credential-registry.ts +362 -4
  234. package/src/lib/paced-stream.ts +34 -0
  235. package/src/lib/passive-key-fetch-proof.ts +30 -0
  236. package/src/lib/passive-read.ts +5 -0
  237. package/src/lib/process-control.ts +76 -12
  238. package/src/lib/redact.ts +84 -8
  239. package/src/lib/state-store-registrations.ts +11 -0
  240. package/src/lib/state-store-sweeper.ts +4 -0
  241. package/src/lib/supervisor-markers.ts +18 -0
  242. package/src/lib/terminal-safe-text.ts +58 -0
  243. package/src/lib/translator-budget.ts +3 -2
  244. package/src/lib/upstream-retry.ts +14 -4
  245. package/src/link/alias-lock.ts +119 -0
  246. package/src/link/child-activity.ts +28 -2
  247. package/src/link/child-binary-cache-fill.d.mts +50 -0
  248. package/src/link/child-binary-cache-fill.mjs +494 -0
  249. package/src/link/child-binary-cache-start.ts +73 -0
  250. package/src/link/child-binary-source.ts +12 -5
  251. package/src/link/child-gated-ocx.ts +29 -11
  252. package/src/link/child-observations.ts +2 -1
  253. package/src/link/child-observe.ts +2 -2
  254. package/src/link/child-ops-engine.ts +159 -91
  255. package/src/link/child-ops-host.ts +138 -0
  256. package/src/link/child-ops-runners.ts +319 -0
  257. package/src/link/child-ops-scheduler.ts +207 -0
  258. package/src/link/child-ops-types.ts +89 -0
  259. package/src/link/child-parity.ts +23 -4
  260. package/src/link/child-policy.ts +93 -0
  261. package/src/link/child-update-contract.ts +12 -3
  262. package/src/link/codex-settings.ts +1 -1
  263. package/src/link/compatibility.ts +18 -1
  264. package/src/link/diagnostics-read.ts +163 -0
  265. package/src/link/diagnostics.ts +20 -7
  266. package/src/link/explicit-route.ts +209 -0
  267. package/src/link/link-recover.ts +113 -0
  268. package/src/link/management-routes.ts +3 -1
  269. package/src/link/operation-recovery-slot.ts +44 -0
  270. package/src/link/operations-journal.ts +408 -0
  271. package/src/link/peer-report.ts +1 -1
  272. package/src/link/relay-auth.ts +14 -0
  273. package/src/link/remote-plant.ts +152 -14
  274. package/src/link/remote-platform.ts +21 -10
  275. package/src/link/remote-probe.ts +11 -3
  276. package/src/link/remote-windows.ts +50 -10
  277. package/src/link/request-compression.ts +30 -0
  278. package/src/link/residual-recovery.ts +54 -0
  279. package/src/link/retirement.ts +128 -0
  280. package/src/link/route-intent-watch.ts +41 -0
  281. package/src/link/route-intent.ts +209 -0
  282. package/src/link/route-proof.ts +82 -0
  283. package/src/link/route-rounds.ts +579 -0
  284. package/src/link/route-select.ts +95 -0
  285. package/src/link/route-trust.ts +96 -0
  286. package/src/link/ssh-argv.ts +172 -24
  287. package/src/link/ssh-capture-redact.ts +253 -0
  288. package/src/link/ssh-capture.ts +497 -0
  289. package/src/link/ssh-runner.ts +141 -14
  290. package/src/link/status-projection.ts +87 -0
  291. package/src/link/store.ts +54 -1
  292. package/src/link/supervisor.ts +543 -55
  293. package/src/link/sync-fanout-classify.ts +16 -0
  294. package/src/link/sync-then-restart.ts +65 -0
  295. package/src/link/tombstones.ts +209 -0
  296. package/src/link/traffic.ts +178 -0
  297. package/src/link/ws-activity-holds.ts +474 -0
  298. package/src/local-credentials/publication-fence.ts +20 -1
  299. package/src/messaging/mcp-queue-rpc.ts +1 -1
  300. package/src/messaging/mcp-queue-server.ts +16 -1
  301. package/src/messaging/mcp-resume-tools.ts +25 -0
  302. package/src/messaging/remote-enrollment.ts +3 -3
  303. package/src/messaging/remote-tunnels.ts +2 -2
  304. package/src/messaging/resume-permissions.ts +27 -0
  305. package/src/messaging/rpc.ts +46 -2
  306. package/src/oauth/anthropic-continuity.ts +23 -7
  307. package/src/oauth/anthropic-routing.ts +5 -2
  308. package/src/oauth/anthropic.ts +22 -2
  309. package/src/oauth/claude-keychain-read.ts +78 -68
  310. package/src/oauth/index.ts +24 -6
  311. package/src/oauth/local-token-detect.ts +8 -29
  312. package/src/oauth/login-cli-errors.ts +5 -1
  313. package/src/oauth/login-cli.ts +33 -18
  314. package/src/oauth/login-flow-state.ts +26 -3
  315. package/src/oauth/meta-muse.ts +1 -1
  316. package/src/oauth/store.ts +7 -0
  317. package/src/oauth/xai.ts +248 -14
  318. package/src/protocols/contract.ts +4 -0
  319. package/src/protocols/encoders/messages.ts +1 -0
  320. package/src/providers/alias-template.ts +48 -0
  321. package/src/providers/anthropic-billing-ownership.ts +2 -0
  322. package/src/providers/anthropic-output-caps.ts +46 -0
  323. package/src/providers/anthropic-reset-grant-ledger.ts +9 -3
  324. package/src/providers/antigravity-effort-families.ts +11 -3
  325. package/src/providers/antigravity-models.ts +32 -9
  326. package/src/providers/antigravity-wire-snapshot.ts +3 -2
  327. package/src/providers/api-key-pause.ts +3 -0
  328. package/src/providers/api-key-resolve.ts +49 -7
  329. package/src/providers/api-key-response-ownership.ts +2 -0
  330. package/src/providers/api-key-selection.ts +51 -9
  331. package/src/providers/api-keys.ts +6 -2
  332. package/src/providers/cache-affinity-identity.ts +73 -0
  333. package/src/providers/cache-affinity.ts +256 -0
  334. package/src/providers/default-aliases.ts +98 -20
  335. package/src/providers/google-vertex-model-discovery.ts +510 -0
  336. package/src/providers/key-failover.ts +123 -8
  337. package/src/providers/key-store.ts +3 -3
  338. package/src/providers/kiro-models.ts +3 -5
  339. package/src/providers/label.ts +31 -5
  340. package/src/providers/mistral-transport.ts +17 -4
  341. package/src/providers/model-rename-fields.ts +3 -0
  342. package/src/providers/muse-key-quota.ts +14 -6
  343. package/src/providers/new-model-policy-runtime.ts +17 -4
  344. package/src/providers/new-model-policy.ts +30 -4
  345. package/src/providers/passive-key-observation.ts +252 -0
  346. package/src/providers/quota/account-cache.ts +2 -1
  347. package/src/providers/quota/anthropic-cooldown-recovery-worker.ts +121 -0
  348. package/src/providers/quota/passive-key-limits.ts +272 -0
  349. package/src/providers/quota/passive-wire-model.ts +126 -0
  350. package/src/providers/quota/report-cache.ts +61 -2
  351. package/src/providers/quota-key-accounts.ts +11 -6
  352. package/src/providers/quota-types.ts +18 -0
  353. package/src/providers/quota.ts +11 -12
  354. package/src/providers/registry/entries-core.ts +34 -16
  355. package/src/providers/registry/entries-extended.ts +32 -0
  356. package/src/providers/registry/model-seeds.ts +35 -0
  357. package/src/providers/resolved-model-policy.ts +7 -0
  358. package/src/providers/routed-config.ts +8 -3
  359. package/src/providers/xai-transport.ts +3 -0
  360. package/src/remote/features.ts +17 -0
  361. package/src/responses/anthropic-progress.ts +10 -4
  362. package/src/responses/citation-markers.ts +231 -0
  363. package/src/responses/spill-store.ts +5 -1
  364. package/src/responses/state/replay-input.ts +50 -0
  365. package/src/responses/state/replay-owner.ts +24 -0
  366. package/src/responses/state/snapshot-codec.ts +9 -0
  367. package/src/responses/state/spill-queue.ts +1 -0
  368. package/src/responses/state.ts +42 -60
  369. package/src/router.ts +2 -2
  370. package/src/routing/home-route-capture.ts +123 -0
  371. package/src/routing/home-route-intent.ts +200 -0
  372. package/src/routing/route-intent-state.ts +178 -0
  373. package/src/routing/route-to-live-settings.ts +35 -0
  374. package/src/routing/route-to-local.ts +145 -0
  375. package/src/routing/route-to-status.ts +94 -0
  376. package/src/routing/route-to-sync-child.ts +32 -0
  377. package/src/server/adapter-resolve.ts +21 -1
  378. package/src/server/admitted-http-turn.ts +3 -0
  379. package/src/server/auth-cors.ts +98 -0
  380. package/src/server/bare-upstream-error.ts +220 -0
  381. package/src/server/chat-native.ts +14 -5
  382. package/src/server/claude-messages.ts +6 -4
  383. package/src/server/codex-model-list.ts +2 -1
  384. package/src/server/configured-credentials.ts +37 -5
  385. package/src/server/gui-desktop-authorization.ts +36 -0
  386. package/src/server/gui-pair-delivery.ts +6 -3
  387. package/src/server/gui-session.ts +10 -1
  388. package/src/server/inbound-body-admission.ts +17 -4
  389. package/src/server/index/link-listener.ts +190 -12
  390. package/src/server/index/link-management.ts +15 -1
  391. package/src/server/index/link-relay-sessions.ts +87 -8
  392. package/src/server/index/link-websocket-limits.ts +136 -0
  393. package/src/server/index/link-websocket.ts +692 -0
  394. package/src/server/index/optional-listeners.ts +97 -7
  395. package/src/server/index/route-intent-watch.ts +47 -0
  396. package/src/server/index/serve-contract.ts +86 -0
  397. package/src/server/index/serve-options.ts +35 -86
  398. package/src/server/index/startup-warnings.ts +8 -2
  399. package/src/server/index/websocket-handler.ts +26 -4
  400. package/src/server/index.ts +12 -2
  401. package/src/server/inference/client-encoder-delivery.ts +2 -0
  402. package/src/server/inspection-tee.ts +39 -2
  403. package/src/server/lifecycle.ts +2 -0
  404. package/src/server/link-turn.ts +137 -0
  405. package/src/server/management/advisor-routes.ts +10 -2
  406. package/src/server/management/agent-settings-routes.ts +50 -16
  407. package/src/server/management/anthropic-reset-grant-routes.ts +1 -1
  408. package/src/server/management/context.ts +9 -2
  409. package/src/server/management/desktop-authorization.ts +41 -0
  410. package/src/server/management/desktop-compatibility-routes.ts +9 -8
  411. package/src/server/management/desktop-compatibility-runtime-routes.ts +3 -2
  412. package/src/server/management/desktop-compatibility-settings-routes.ts +5 -3
  413. package/src/server/management/home-integration-decision.ts +89 -0
  414. package/src/server/management/integration-routes.ts +208 -81
  415. package/src/server/management/link-child-ops-routes.ts +145 -43
  416. package/src/server/management/link-child-preflight.ts +31 -0
  417. package/src/server/management/link-diagnostics-route.ts +29 -0
  418. package/src/server/management/link-enrollment.ts +199 -47
  419. package/src/server/management/link-operation.ts +609 -0
  420. package/src/server/management/link-recover-route.ts +103 -0
  421. package/src/server/management/link-route-edit.ts +173 -0
  422. package/src/server/management/link-route-request.ts +62 -0
  423. package/src/server/management/link-route-state.ts +83 -7
  424. package/src/server/management/link-routes.ts +553 -51
  425. package/src/server/management/link-traffic-status.ts +13 -0
  426. package/src/server/management/model-routes.ts +122 -36
  427. package/src/server/management/model-rows.ts +2 -1
  428. package/src/server/management/native-integration-routes.ts +176 -70
  429. package/src/server/management/oauth-account-routes.ts +36 -13
  430. package/src/server/management/protocol-routes.ts +7 -0
  431. package/src/server/management/provider-completion-test.ts +4 -4
  432. package/src/server/management/provider-overwrite-carry.ts +11 -0
  433. package/src/server/management/provider-routes.ts +64 -61
  434. package/src/server/management/provider-routing-quota.ts +45 -0
  435. package/src/server/management/route-registry.ts +22 -3
  436. package/src/server/management/route-to-routes.ts +257 -0
  437. package/src/server/management/system-restart.ts +4 -2
  438. package/src/server/management/usage-aggregate-cache.ts +101 -66
  439. package/src/server/management-api.ts +17 -3
  440. package/src/server/management-auth.ts +13 -1
  441. package/src/server/messages-native-preflight.ts +27 -4
  442. package/src/server/messages-native.ts +17 -5
  443. package/src/server/persistent-gui-session.ts +6 -3
  444. package/src/server/proxy-liveness.ts +33 -6
  445. package/src/server/relay-eager.ts +36 -12
  446. package/src/server/relay.ts +183 -116
  447. package/src/server/request-body-facts.ts +48 -0
  448. package/src/server/request-decompress.ts +65 -2
  449. package/src/server/request-log-account-rotation.ts +6 -0
  450. package/src/server/request-log-attempt-usage.ts +69 -0
  451. package/src/server/request-log-cache-affinity.ts +60 -0
  452. package/src/server/request-log-conversation.ts +45 -2
  453. package/src/server/request-log-terminal-status.ts +210 -24
  454. package/src/server/request-log.ts +71 -79
  455. package/src/server/responses/adapter-continuation.ts +2 -1
  456. package/src/server/responses/adapter-delivery.ts +2 -0
  457. package/src/server/responses/adapter-dispatch.ts +5 -7
  458. package/src/server/responses/advisor-plan-slot.ts +33 -1
  459. package/src/server/responses/advisor-question.ts +21 -0
  460. package/src/server/responses/advisor-slot.ts +10 -3
  461. package/src/server/responses/bare-namespace-aliases.ts +18 -0
  462. package/src/server/responses/buffered-sse-json.ts +9 -3
  463. package/src/server/responses/code-mode-collab-surface.ts +11 -0
  464. package/src/server/responses/codex-tool-catalog.ts +156 -0
  465. package/src/server/responses/combo-required-tool-fulfillments.ts +4 -2
  466. package/src/server/responses/combo-stream-preflight.ts +557 -54
  467. package/src/server/responses/compact.ts +32 -8
  468. package/src/server/responses/core-codex-account.ts +17 -3
  469. package/src/server/responses/core-combo-failure.ts +8 -0
  470. package/src/server/responses/core-combo.ts +32 -4
  471. package/src/server/responses/core-errors.ts +5 -2
  472. package/src/server/responses/core-lifetime.ts +3 -2
  473. package/src/server/responses/core-normalize.ts +3 -1
  474. package/src/server/responses/core-options.ts +6 -0
  475. package/src/server/responses/core.ts +2 -0
  476. package/src/server/responses/fetch-helpers.ts +15 -10
  477. package/src/server/responses/native-replay-guard.ts +57 -0
  478. package/src/server/responses/opengateway-completion-guard.ts +10 -4
  479. package/src/server/responses/outbound-request-body.ts +29 -0
  480. package/src/server/responses/passthrough-completion.ts +105 -8
  481. package/src/server/responses/passthrough-delivery.ts +31 -11
  482. package/src/server/responses/passthrough-dispatch.ts +74 -73
  483. package/src/server/responses/policy-fallback.ts +13 -1
  484. package/src/server/responses/request-prepare.ts +50 -6
  485. package/src/server/responses/request-transport.ts +10 -3
  486. package/src/server/responses/reset-replay.ts +46 -2
  487. package/src/server/responses/run-turn-execution.ts +2 -0
  488. package/src/server/responses/sidecar-execution.ts +14 -0
  489. package/src/server/responses/terminal-error-redaction.ts +222 -25
  490. package/src/server/responses/ws-upstream.ts +2 -2
  491. package/src/server/sse-payload-rewrite.ts +3 -2
  492. package/src/server/stop-service-route.ts +85 -0
  493. package/src/server/system-env-shell.ts +12 -1
  494. package/src/server/system-env.ts +5 -3
  495. package/src/server/windows-tcp-drop.ts +21 -4
  496. package/src/server/workflow-refusal.ts +8 -0
  497. package/src/server/ws-bridge.ts +191 -12
  498. package/src/service/cli-windows-stop.ts +189 -0
  499. package/src/service/cli.ts +41 -12
  500. package/src/service/disconnected-client-restart.ts +60 -0
  501. package/src/service/guarded-manager-target.ts +18 -1
  502. package/src/service/health.ts +99 -6
  503. package/src/service/launchd.ts +84 -31
  504. package/src/service/orchestration.ts +418 -91
  505. package/src/service/repair.ts +223 -6
  506. package/src/service/restart-proxy-stop.ts +79 -0
  507. package/src/service/service-child-ownership.ts +6 -2
  508. package/src/service/windows-checked-stop-live.ts +467 -0
  509. package/src/service/windows-checked-stop.ts +435 -0
  510. package/src/service/windows-command-line-token.ts +23 -0
  511. package/src/service/windows-guarded-manager.ts +77 -34
  512. package/src/service/windows-ops.ts +38 -56
  513. package/src/service/windows-process-evidence.ts +292 -0
  514. package/src/service/windows-process-native.ts +262 -0
  515. package/src/service/windows-service-stop.ts +321 -0
  516. package/src/service/windows-stop-binding.ts +187 -0
  517. package/src/service/windows-stop-budget.ts +123 -0
  518. package/src/service/windows-stop-confirm.ts +158 -0
  519. package/src/service/windows-stop-deadline.ts +56 -0
  520. package/src/service.ts +2 -2
  521. package/src/types/config.ts +42 -18
  522. package/src/types/link.ts +20 -0
  523. package/src/types/multi-agent.ts +13 -0
  524. package/src/types/provider.ts +47 -2
  525. package/src/types/request.ts +4 -0
  526. package/src/types.ts +3 -0
  527. package/src/update/guarded-runtime-ops.ts +5 -7
  528. package/src/update/index.ts +25 -10
  529. package/src/update/install-detection.mjs +3 -1
  530. package/src/update/job-pinned-start.ts +2 -0
  531. package/src/update/job-windows-restart.ts +19 -32
  532. package/src/update/job.ts +12 -5
  533. package/src/update/npm-install.d.mts +11 -0
  534. package/src/update/npm-install.mjs +44 -7
  535. package/src/update/orchestrated-entry.ts +1 -1
  536. package/src/update/orchestrated-node-driver.mjs +3 -2
  537. package/src/update/orchestrated-pnpm.d.mts +4 -0
  538. package/src/update/orchestrated-pnpm.mjs +50 -6
  539. package/src/update/orchestrated-session.d.mts +3 -1
  540. package/src/update/orchestrated-session.mjs +21 -6
  541. package/src/update/pnpm-global-install.d.mts +21 -3
  542. package/src/update/pnpm-global-install.mjs +322 -19
  543. package/src/update/pnpm-store-layout.mjs +46 -0
  544. package/src/update/sync-update-mutex.d.mts +3 -2
  545. package/src/update/sync-update-mutex.mjs +57 -8
  546. package/src/update/transactional-install.d.mts +3 -1
  547. package/src/update/transactional-install.mjs +545 -12
  548. package/src/update/windows-installer-marker.d.mts +1 -0
  549. package/src/update/windows-installer-marker.mjs +44 -0
  550. package/src/usage/expected-prices.ts +8 -0
  551. package/src/usage/filter-index.ts +326 -77
  552. package/src/usage/ledger-scanner.ts +15 -0
  553. package/src/usage/link-log-fields.ts +48 -0
  554. package/src/usage/log.ts +43 -2
  555. package/src/usage/request-body.ts +37 -0
  556. package/src/web-search/loop.ts +3 -0
  557. package/gui/dist/assets/App-BpJOzw4F.js +0 -59
  558. package/gui/dist/assets/index-Bbor_y80.js +0 -94
  559. package/gui/dist/classic/assets/App-BrIlUiLc.js +0 -58
  560. package/gui/dist/classic/assets/index-DyJHagvT.js +0 -94
  561. package/src/server/management/desktop-compatibility-authorization.ts +0 -12
@@ -1,5 +1,6 @@
1
1
  import { configuredAnthropicInstance, isAnthropicOAuthInstance } from "../providers/anthropic-instance";
2
- import { parseQuotaFailureCode, type QuotaFailureCode, type ProviderQuota, type AccountQuotaMode } from "../providers/quota-types";
2
+ import { parseQuotaFailureCode, parseQuotaUnknownReason, type QuotaFailureCode, type QuotaUnknownReason, type ProviderQuota, type AccountQuotaMode } from "../providers/quota-types";
3
+ import { parseWeeklyWindowConflicts, type WeeklyWindowConflict } from "../codex/quota-window-conflict";
3
4
  /**
4
5
  * Data-access layer for `ocx account` (issue #180) — live-proxy HTTP client and
5
6
  * per-family account readers. Kept separate from account.ts (command handlers)
@@ -57,6 +58,12 @@ export interface AccountRow {
57
58
  quotaRefresh?: CodexQuotaRefreshOutcome;
58
59
  quotaUnavailable?: boolean;
59
60
  quotaFailure?: QuotaFailureCode;
61
+ /** Live weekly windows a Codex pool account reported in contradiction (#8574). */
62
+ weeklyQuotaConflicts?: WeeklyWindowConflict[];
63
+ /** Why the balance is unknown (#8397); reasons this CLI does not know are dropped. */
64
+ quotaUnknownReason?: QuotaUnknownReason;
65
+ /** When the server last read this balance, success or failure (epoch ms). */
66
+ quotaReadAt?: number;
60
67
  /**
61
68
  * Whether the pool is holding this account out of rotation.
62
69
  *
@@ -348,6 +355,7 @@ interface CodexAccountDto {
348
355
  needsReauth?: boolean;
349
356
  selectionExcludedReason?: "plan_excluded";
350
357
  selectionExcludedPlan?: string;
358
+ weeklyQuotaConflicts?: unknown;
351
359
  health?: { reason?: string };
352
360
  healthLabel?: unknown;
353
361
  creditsAfterLimit?: unknown;
@@ -440,11 +448,17 @@ export async function fetchCodexRows(
440
448
  ...(includeQuota ? {
441
449
  quota: projectQuota(a.quota),
442
450
  quotaRefresh: projectCodexQuotaRefreshOutcome(a.quotaRefresh),
451
+ ...weeklyQuotaConflictsField(a.weeklyQuotaConflicts),
443
452
  } : {}),
444
453
  }));
445
454
  return { rows, activeId, autoSwitchThreshold, status: 200 };
446
455
  }
447
456
 
457
+ function weeklyQuotaConflictsField(value: unknown): { weeklyQuotaConflicts?: WeeklyWindowConflict[] } {
458
+ const weeklyQuotaConflicts = parseWeeklyWindowConflicts(value);
459
+ return weeklyQuotaConflicts ? { weeklyQuotaConflicts } : {};
460
+ }
461
+
448
462
  interface OAuthAccountDto {
449
463
  id: string;
450
464
  alias?: string;
@@ -464,6 +478,7 @@ interface OAuthAccountDto {
464
478
  quota?: CodexQuotaDto | null;
465
479
  quotaUnavailable?: boolean;
466
480
  quotaFailure?: unknown;
481
+ quotaUnknownReason?: unknown;
467
482
  }
468
483
 
469
484
  function isKiroSkipReason(value: unknown): value is NonNullable<AccountRow["skipReason"]> {
@@ -514,6 +529,7 @@ async function fetchOAuthRows(
514
529
  ...(a.quotaUnavailable !== undefined ? { quotaUnavailable: a.quotaUnavailable } : {}),
515
530
  ...(a.quotaUnavailable === true && parseQuotaFailureCode(a.quotaFailure)
516
531
  ? { quotaFailure: parseQuotaFailureCode(a.quotaFailure) } : {}),
532
+ ...(parseQuotaUnknownReason(a.quotaUnknownReason) ? { quotaUnknownReason: parseQuotaUnknownReason(a.quotaUnknownReason) } : {}),
517
533
  }));
518
534
  return { rows, activeId, status: 200 };
519
535
  }
@@ -45,10 +45,13 @@ const USAGE = `Usage:
45
45
  ocx account reset-credits <account-id|main> [--consume --yes [--operation-id <uuid>]] [--json]
46
46
  ocx account grok-reset-coupons [<account-id>] [--consume --yes [--token-id <token-id>] [--operation-id <uuid>]] [--json]
47
47
 
48
- --device runs the OpenAI device-code login instead of the browser callback: use
49
- it when the proxy has no browser or nothing can reach localhost:1455, such as a
50
- headless or remote hub. Enter the printed code at the printed URL from any other
51
- machine.
48
+ --device runs the device-code login instead of the browser callback (codex and
49
+ xai): use it when the proxy has no browser or nothing can reach its localhost
50
+ callback, such as a headless or remote hub. Both print a URL and a short code;
51
+ confirm that code in any browser and the login finishes here, so nothing is
52
+ pasted back and no local port is used. Each flow polls until its own deadline:
53
+ Codex's 15-minute device grant, and xAI's provider-issued expires_in bounded to
54
+ 30 minutes and to one poll a second.
52
55
 
53
56
  The redirect URL or authorization code is a short-lived credential. Pipe it in
54
57
  rather than passing it as an argument, where it lands in shell history and is
@@ -162,12 +165,23 @@ const STDIN_SENTINEL = "-";
162
165
 
163
166
  /** Providers whose ONLY login is already a device flow; --device is redundant, not wrong. */
164
167
  const DEVICE_NATIVE_PROVIDERS = new Set(["kimi", "nous", "github-copilot"]);
165
- const stripTerminalControls = (value: string): string => value.replace(/[\u0000-\u001f\u007f-\u009f\u200b-\u200f\u202a-\u202e\u2060-\u2069\ufeff]/g, "");
168
+ /** Providers with a device grant besides their browser login; --device selects it. */
169
+ const DEVICE_OPT_IN_PROVIDERS = new Set(["xai"]);
170
+ /**
171
+ * The native Kiro handoff, rendered for a terminal.
172
+ *
173
+ * Every field here is provider- or proxy-supplied, so they go through the same sanitizer as the
174
+ * OAuth CLI's instructions rather than a local strip regex: a narrower strip both left characters
175
+ * reachable (the Arabic letter mark, the line separators, the deprecated `U+206A`–`U+206F` bidi
176
+ * controls) and deleted ones that must survive (ZWNJ/ZWJ, which shape Persian and emoji). Escaping
177
+ * keeps the value readable in a pasted report and leaves the layout below intact, because a
178
+ * newline inside a field is escaped rather than allowed to add a line.
179
+ */
166
180
  export function formatKiroDeviceInstructions(start: { verificationUriComplete?: string; verificationUri?: string; userCode?: string; flowId?: string }): string {
167
181
  return [
168
- stripTerminalControls(start.verificationUriComplete ?? start.verificationUri ?? ""),
169
- start.userCode ? `User code: ${stripTerminalControls(start.userCode)}` : "",
170
- start.flowId ? `Flow: ${stripTerminalControls(start.flowId)}` : "",
182
+ terminalSafeText(start.verificationUriComplete ?? start.verificationUri ?? ""),
183
+ start.userCode ? `User code: ${terminalSafeText(start.userCode)}` : "",
184
+ start.flowId ? `Flow: ${terminalSafeText(start.flowId)}` : "",
171
185
  ].filter(Boolean).join("\n");
172
186
  }
173
187
 
@@ -225,9 +239,14 @@ async function login(argv: string[], deps: RuntimeApiDeps): Promise<number | voi
225
239
  // kimi, nous, and github-copilot are already device flows, so --device is a
226
240
  // true statement about them and is accepted as a no-op rather than an error.
227
241
  // Anything else has no device grant at all and must fail loudly.
228
- if (device && !CODEX_NAMES.has(provider) && !DEVICE_NATIVE_PROVIDERS.has(provider)) {
242
+ if (device && !CODEX_NAMES.has(provider) && !DEVICE_NATIVE_PROVIDERS.has(provider) && !DEVICE_OPT_IN_PROVIDERS.has(provider)) {
229
243
  throw new CliUsageError("--device is not supported for this provider", USAGE);
230
244
  }
245
+ // A device grant never asks for a pasted code: the CLI would have spent the caller's stdin, and
246
+ // the proxy would have accepted the paste into a flow with nothing to do with it (the device flow
247
+ // is not a code flow, so `submitLoginCode` stashes it and the login still waits for approval).
248
+ if (device && suppliedCode) throw new CliUsageError("--code cannot be combined with --device", USAGE);
249
+ if (provider === "xai" && device && wantsJson && !noWait) throw new CliUsageError("xAI device login with --json requires --no-wait; use the returned handoff to complete authorization", USAGE);
231
250
  if (addAccount !== undefined && (reauth || CODEX_NAMES.has(provider))) throw new CliUsageError("--add-account is only valid for fresh provider OAuth login", USAGE);
232
251
  if (openBrowser !== undefined && (device || DEVICE_NATIVE_PROVIDERS.has(provider))) throw new CliUsageError("--open-browser is not supported for device login", USAGE);
233
252
  if (!CODEX_NAMES.has(provider) && id && !reauth) throw new CliUsageError("--id is only valid with --reauth for provider OAuth accounts", USAGE);
@@ -274,11 +293,11 @@ async function login(argv: string[], deps: RuntimeApiDeps): Promise<number | voi
274
293
  // One atomic pre-poll block, flushed synchronously so a piped parent
275
294
  // reads the URL before the polling window starts (#1007).
276
295
  writeLoginInstructions([
277
- start.url ? `Open this URL to sign in:\n${start.url}` : "",
278
- start.deviceCode ? `Device code: ${start.deviceCode}` : "",
296
+ start.url ? `Open this URL to sign in:\n${terminalSafeText(start.url)}` : "",
297
+ start.deviceCode ? `Device code: ${terminalSafeText(start.deviceCode)}` : "",
279
298
  start.instructions ?? "",
280
299
  start.browserLaunch === "failed" ? BROWSER_LAUNCH_FAILED_HINT : "",
281
- start.flowId ? `Flow: ${start.flowId}` : "",
300
+ start.flowId ? `Flow: ${terminalSafeText(start.flowId)}` : "",
282
301
  ]);
283
302
  }
284
303
  if (code && !start.flowId) throw new Error("Code submission requires a returned flow id");
@@ -327,13 +346,24 @@ async function login(argv: string[], deps: RuntimeApiDeps): Promise<number | voi
327
346
 
328
347
  const start = publicLoginStart(await runtimeRequest<unknown>("/api/oauth/login", {
329
348
  method: "POST", redirect: "error",
330
- body: JSON.stringify({ provider, addAccount: addAccount ?? !reauth, ...(openBrowser === undefined ? {} : { openBrowser }), ...(reauth && id ? { accountId: id, reauth: true } : {}) }),
349
+ body: JSON.stringify({ provider, addAccount: addAccount ?? !reauth, ...(device && DEVICE_OPT_IN_PROVIDERS.has(provider) ? { device: true } : {}), ...(openBrowser === undefined ? {} : { openBrowser }), ...(reauth && id ? { accountId: id, reauth: true } : {}) }),
331
350
  }, pinned));
351
+ const xaiDevice = provider === "xai" && device;
352
+ if (xaiDevice && (!start.flowId?.trim() || !start.url?.trim() || !start.deviceCode?.trim())) {
353
+ let cleanupFailed = false;
354
+ try {
355
+ await runtimeRequest("/api/oauth/login/cancel", {
356
+ method: "POST", redirect: "error",
357
+ body: JSON.stringify({ provider, ...(start.flowId?.trim() ? { flowId: start.flowId } : {}) }),
358
+ }, pinned);
359
+ } catch { cleanupFailed = true; }
360
+ throw new CliUsageError(`Running proxy does not support xAI device login; restart or upgrade it.${cleanupFailed ? " Could not cancel the unintended login flow." : ""}`);
361
+ }
332
362
  if (!wantsJson) {
333
363
  writeLoginInstructions([
334
- start.url ? `Open this URL to sign in:\n${start.url}` : "",
335
- start.instructions ?? "",
336
- start.deviceCode ? `Device code: ${start.deviceCode}` : "",
364
+ start.url ? `Open this URL to sign in:\n${terminalSafeText(start.url)}` : "",
365
+ provider === "xai" && device ? terminalSafeText(start.instructions ?? "") : start.instructions ?? "",
366
+ start.deviceCode ? `Device code: ${terminalSafeText(start.deviceCode)}` : "",
337
367
  ]);
338
368
  }
339
369
  if (code) {
@@ -347,13 +377,16 @@ async function login(argv: string[], deps: RuntimeApiDeps): Promise<number | voi
347
377
  printData({ ...start, modelSelection: modelSelectionNextSteps(provider, true) }, wantsJson, modelSelectionGuidance(provider, true));
348
378
  return;
349
379
  }
350
- for (let attempt = 0; attempt < 100; attempt++) {
380
+ // A device grant waits on a person at another machine: outlast xAI's 30-minute code.
381
+ for (let attempt = 0; attempt < (device ? 930 : 100); attempt++) {
351
382
  await Bun.sleep(2_000);
352
- const raw = await runtimeRequest<Record<string, unknown>>(`/api/oauth/status?provider=${encodeURIComponent(provider)}`, { redirect: "error" }, pinned);
383
+ const raw = await runtimeRequest<Record<string, unknown>>(`/api/oauth/status?provider=${encodeURIComponent(provider)}${xaiDevice ? `&flowId=${encodeURIComponent(start.flowId!)}` : ""}`, { redirect: "error" }, pinned);
353
384
  if (loginObject(raw).error) throw new Error("Provider login failed");
385
+ if (xaiDevice && (raw.flowId !== start.flowId || raw.status === "idle")) throw new Error("Device login flow is unavailable");
354
386
  const state = publicLoginStatus(raw);
355
- if (state.done === true && state.loggedIn !== true) throw new Error("Provider login ended without authentication");
356
- if (state.loggedIn === true) {
387
+ if (state.done === true && state.loggedIn !== true && !(xaiDevice && raw.status === "complete")) throw new Error("Provider login ended without authentication");
388
+ // A device login adds an account, so an already signed-in provider is not done until its flow is.
389
+ if ((xaiDevice && raw.status === "complete") || (state.loggedIn === true && (!device || (state.done === true && !xaiDevice)))) {
357
390
  printData({ ...state, modelSelection: modelSelectionNextSteps(provider) }, wantsJson, [`Logged in to ${provider}.`, ...modelSelectionGuidance(provider)]);
358
391
  return;
359
392
  }
@@ -407,7 +440,7 @@ async function cancel(argv: string[], deps: RuntimeApiDeps): Promise<void> {
407
440
  }
408
441
  const result = await runtimeRequest(codex ? "/api/codex-auth/login/cancel" : "/api/oauth/login/cancel", {
409
442
  method: "POST",
410
- body: JSON.stringify(codex ? { flowId } : { provider, ...(provider === "kiro" && flowId ? { flowId } : {}) }),
443
+ body: JSON.stringify(codex ? { flowId } : { provider, ...((provider === "kiro" || provider === "xai") && flowId ? { flowId } : {}) }),
411
444
  }, deps);
412
445
  printData(result, wantsJson, [`Cancelled ${provider} login.`]);
413
446
  }
@@ -1,5 +1,5 @@
1
1
  /** Public API-key quota projection; private probe identity stays on the server. */
2
- import { parseQuotaFailureCode, type AccountQuotaFields, type ProviderQuota, type ProviderQuotaWindow, type ProviderQuotaCreditsUsd } from "../providers/quota-types";
2
+ import { parseQuotaFailureCode, parseQuotaUnknownReason, type AccountQuotaFields, type ProviderQuota, type ProviderQuotaWindow, type ProviderQuotaCreditsUsd, type QuotaUnknownReason } from "../providers/quota-types";
3
3
  import { terminalSafeText } from "./runtime-api";
4
4
  import type { AccountRow, FamilyRows } from "./account-api";
5
5
  import { accountPauseDetailsSchema } from "../config/schema/account-auto-pause";
@@ -98,6 +98,11 @@ export function projectApiKeyQuotaRows(value: unknown, provider: string): Family
98
98
  if (!failure) throw new Error("Malformed API-key quota response.");
99
99
  if (unavailable === true) fields.quotaFailure = failure;
100
100
  }
101
+ // #8397: a reason a newer proxy adds is dropped, not fatal; a non-string is malformed.
102
+ const unknownReason = parseQuotaUnknownReason(optionalString(row, "quotaUnknownReason"));
103
+ if (unknownReason) fields.quotaUnknownReason = unknownReason;
104
+ // Display-only: a malformed read time is dropped like an unknown reason, not fatal to the listing.
105
+ if (typeof row.quotaReadAt === "number" && Number.isFinite(row.quotaReadAt) && row.quotaReadAt >= 0) fields.quotaReadAt = row.quotaReadAt;
101
106
  const masked = optionalString(row, "masked");
102
107
  return { provider, type: "api-key", id, label: optionalString(row, "label") ?? masked,
103
108
  masked, active: optionalBoolean(row, "active") ?? id === activeId,
@@ -107,13 +112,37 @@ export function projectApiKeyQuotaRows(value: unknown, provider: string): Family
107
112
  return { rows, activeId, status: 200 };
108
113
  }
109
114
 
115
+ const UNKNOWN_REASON_TEXT: Record<QuotaUnknownReason, string> = {
116
+ no_balance_source: "no balance source",
117
+ passive_not_observed: "not observed yet",
118
+ read_failed: "read failed",
119
+ not_read: "not read",
120
+ not_reported: "provider reported none",
121
+ };
122
+ export function quotaUnknownReasonText(reason: QuotaUnknownReason): string {
123
+ return UNKNOWN_REASON_TEXT[reason];
124
+ }
125
+
126
+ /** "read 3 min ago"; a clock skewed into the future reads as just now. */
127
+ function readAgeText(readAt: number | undefined, now = Date.now()): string {
128
+ if (readAt === undefined) return "";
129
+ const minutes = Math.floor(Math.max(0, now - readAt) / 60_000);
130
+ if (minutes < 1) return "; read just now";
131
+ if (minutes < 60) return `; read ${minutes} min ago`;
132
+ const hours = Math.floor(minutes / 60);
133
+ return hours < 48 ? `; read ${hours} h ago` : `; read ${Math.floor(hours / 24)} d ago`;
134
+ }
135
+
110
136
  export function apiKeyQuotaText(row: AccountRow): string {
111
137
  const mode = row.quotaMode;
112
138
  if (!mode) return "unverified";
113
- if (mode === "unsupported") return "unsupported";
114
- if (row.quotaUnavailable) return `${mode}: unavailable${row.quotaFailure ? ` (${row.quotaFailure})` : ""}`;
139
+ // Without a reader there is no balance source, whichever proxy version answered.
140
+ if (mode === "unsupported") return `unsupported: balance UNKNOWN (${quotaUnknownReasonText("no_balance_source")})`;
141
+ const read = readAgeText(row.quotaReadAt);
142
+ const unknown = row.quotaUnknownReason ? `; balance UNKNOWN (${quotaUnknownReasonText(row.quotaUnknownReason)})` : "";
143
+ if (row.quotaUnavailable) return `${mode}: unavailable${row.quotaFailure ? ` (${row.quotaFailure})` : ""}${unknown}${read}`;
115
144
  const quota = row.quota;
116
- if (!quota) return `${mode}: not measured`;
145
+ if (!quota) return unknown ? `${mode}: ${unknown.slice(2)}${read}` : `${mode}: not measured${read}`;
117
146
  const parts: string[] = [];
118
147
  for (const [label, percent] of [["5h", quota.fiveHourPercent], ["wk", quota.weeklyPercent], ["mo", quota.monthlyPercent]] as const) {
119
148
  if (percent !== undefined) parts.push(`${label} ${percent}%`);
@@ -137,5 +166,5 @@ export function apiKeyQuotaText(row: AccountRow): string {
137
166
  parts.push(`USD ${c.used}/${c.unlimited ? "unlimited" : c.limit} used; ${c.remaining} remaining (${c.percent}%)`);
138
167
  }
139
168
  if (quota.kiroCreditsUsed !== undefined || quota.kiroCreditsLimit !== undefined) parts.push(`credits ${quota.kiroCreditsUsed ?? "?"}/${quota.kiroCreditsLimit ?? "?"}`);
140
- return `${mode}: ${parts.join("; ") || "not measured"}`;
169
+ return `${mode}: ${parts.join("; ") || "not measured"}${read}`;
141
170
  }
@@ -1,5 +1,5 @@
1
1
  /** `ocx account` — list and switch provider credentials (issue #180). */
2
- import { apiKeyQuotaText } from "./account-key-quota";
2
+ import { apiKeyQuotaText, quotaUnknownReasonText } from "./account-key-quota";
3
3
  import { redactSecretArgs } from "./secret-args";
4
4
  import { emptyAccountNextAction, recoveryAccountLabel } from "./account-next-actions";
5
5
  import { loadConfig } from "../config";
@@ -151,7 +151,7 @@ function quotaText(row: AccountRow): string {
151
151
  if (row.type === "api-key") return apiKeyQuotaText(row);
152
152
  if (row.quotaUnavailable) return row.quotaFailure ? `unavailable (${row.quotaFailure})` : "unavailable";
153
153
  const quota = row.quota;
154
- if (!quota) return "-";
154
+ if (!quota) return row.quotaUnknownReason ? `UNKNOWN (${quotaUnknownReasonText(row.quotaUnknownReason)})` : "-";
155
155
  const parts: string[] = [];
156
156
  // Two spellings reach this DTO: the per-account provider probe reports `fiveHourPercent`,
157
157
  // while the Codex pool reports the same idea as `shortPercent`.
@@ -161,6 +161,8 @@ function quotaText(row: AccountRow): string {
161
161
  // Kiro bills a monthly allowance and reports no shorter window, so without this arm a
162
162
  // perfectly healthy Kiro account prints "-" and reads as broken.
163
163
  if (typeof quota.monthlyPercent === "number") parts.push(`mo ${Math.round(quota.monthlyPercent)}%`);
164
+ // #8574: the stored weekly reading follows whichever of two live windows came last; say so.
165
+ if (row.weeklyQuotaConflicts?.length) parts.push("(weekly windows conflict)");
164
166
  return parts.length > 0 ? parts.join(" ") : "-";
165
167
  }
166
168
 
@@ -7,14 +7,15 @@ const USAGE = `Usage:
7
7
  ocx advisor on [--ack-context-sharing] [--json]
8
8
  ocx advisor off [--json]
9
9
  ocx advisor consent [--revoke] [--json]
10
- ocx advisor set [--model <model>] [--effort <effort>] [--policy <manual|preflight|adaptive>] [--max-consultations <1-3>] [--timeout-ms <ms>] [--json]`;
10
+ ocx advisor set [--model <model>] [--effort <effort>] [--policy <manual|preflight|adaptive>] [--context-mode <context|question-only>] [--max-consultations <1-3>] [--timeout-ms <ms>] [--json]`;
11
11
 
12
- const VALUED_FLAGS = new Set(["--model", "--effort", "--policy", "--timeout-ms", "--max-consultations"]);
12
+ const VALUED_FLAGS = new Set(["--model", "--effort", "--policy", "--context-mode", "--timeout-ms", "--max-consultations"]);
13
13
 
14
14
  interface SetOptions {
15
15
  model?: string;
16
16
  effort?: string;
17
17
  policy?: string;
18
+ contextMode?: string;
18
19
  timeoutMs?: string;
19
20
  maxConsultations?: string;
20
21
  }
@@ -32,11 +33,12 @@ function parseSetArgs(args: string[]): SetOptions {
32
33
  if (arg === "--model") options.model = value;
33
34
  else if (arg === "--effort") options.effort = value;
34
35
  else if (arg === "--policy") options.policy = value;
36
+ else if (arg === "--context-mode") options.contextMode = value;
35
37
  else if (arg === "--max-consultations") options.maxConsultations = value;
36
38
  else options.timeoutMs = value;
37
39
  }
38
40
  if (Object.keys(options).length === 0) {
39
- throw new CliUsageError("advisor set requires a model, effort, policy, task limit, or timeout option", USAGE);
41
+ throw new CliUsageError("advisor set requires a model, effort, policy, context mode, task limit, or timeout option", USAGE);
40
42
  }
41
43
  return options;
42
44
  }
@@ -115,7 +117,7 @@ async function consent(argv: string[], deps: RuntimeApiDeps): Promise<void> {
115
117
  contextSharingConsent: revoke ? null : ADVISOR_CONTEXT_SHARING_CONSENT_VERSION,
116
118
  }),
117
119
  }, deps), wantsJson, [revoke
118
- ? "Advisor context-sharing consent removed. Consultations will not send task content."
120
+ ? "Advisor context-sharing consent removed. Consultations not yet dispatched will not send task content; a dispatched consultation cannot be cancelled and task content already sent cannot be retracted."
119
121
  : "Advisor context-sharing consent v1 recorded.",
120
122
  ]);
121
123
  }
@@ -128,6 +130,7 @@ async function set(argv: string[], deps: RuntimeApiDeps): Promise<void> {
128
130
  if (options.model !== undefined) patch.model = options.model;
129
131
  if (options.effort !== undefined) patch.effort = options.effort;
130
132
  if (options.policy !== undefined) patch.policy = options.policy;
133
+ if (options.contextMode !== undefined) patch.contextMode = options.contextMode;
131
134
  if (options.maxConsultations !== undefined) {
132
135
  const limit = Number(options.maxConsultations);
133
136
  if (!Number.isInteger(limit) || limit < 1 || limit > 3) throw new CliUsageError("--max-consultations must be an integer between 1 and 3", USAGE);
package/src/cli/alias.ts CHANGED
@@ -5,7 +5,10 @@ const USAGE = `Usage:
5
5
  ocx alias set <provider> <alias>
6
6
  ocx alias set <provider>/<native-model-id> <alias>
7
7
  ocx alias rm <provider>[/<native-model-id>]
8
- ocx alias defaults <on|off> [--provider <name>]`;
8
+ ocx alias defaults <on|off> [--provider <name>]
9
+ ocx alias template set <provider> <template>
10
+ ocx alias template rm <provider>
11
+ ocx alias template show [<provider>]`;
9
12
 
10
13
  function selector(value: string): { provider: string; model?: string } {
11
14
  const slash = value.indexOf("/");
@@ -32,6 +35,7 @@ async function runAliasAction(argv: string[], deps: RuntimeApiDeps): Promise<num
32
35
  printData(result, wantsJson, lines.length ? lines : ["No aliases configured."]);
33
36
  return 0;
34
37
  }
38
+ if (action === "template") return runTemplateAction(args, wantsJson, deps);
35
39
  if (action === "defaults") {
36
40
  const state = args.shift()?.toLowerCase();
37
41
  const provider = takeOption(args, "--provider");
@@ -70,3 +74,36 @@ async function runAliasAction(argv: string[], deps: RuntimeApiDeps): Promise<num
70
74
  }
71
75
  return 0;
72
76
  }
77
+
78
+ /**
79
+ * #7705: opt-in per-provider alias templates. The template is stored as text and the aliases are
80
+ * derived when models resolve; `set` prints how many aliases it produces and how many it skipped.
81
+ */
82
+ async function runTemplateAction(args: string[], wantsJson: boolean, deps: RuntimeApiDeps): Promise<number> {
83
+ const sub = args.shift()?.toLowerCase();
84
+ if (sub === "show") {
85
+ const provider = args.shift()?.trim();
86
+ rejectArgs(args, USAGE);
87
+ const result = await runtimeRequest<{ templates?: Record<string, string> }>("/api/aliases", {}, deps);
88
+ const templates = Object.entries(result.templates ?? {}).filter(([name]) => !provider || name === provider);
89
+ printData(provider ? { provider, template: Object.fromEntries(templates)[provider] ?? null } : (result.templates ?? {}), wantsJson,
90
+ templates.length ? templates.map(([name, template]) => `${name}: ${template}`) : ["No alias templates configured."]);
91
+ return 0;
92
+ }
93
+ if (sub !== "set" && sub !== "rm") throw new CliUsageError("alias template requires set, rm or show", USAGE);
94
+ const provider = args.shift()?.trim();
95
+ if (!provider) throw new CliUsageError("alias template requires a provider", USAGE);
96
+ const template = sub === "set" ? args.shift() : null;
97
+ if (sub === "set" && !template?.trim()) throw new CliUsageError("alias template set requires a template", USAGE);
98
+ rejectArgs(args, USAGE);
99
+ const result = await runtimeRequest<{ preview?: { generated: number; skippedTotal?: number; skipped?: unknown[] } }>(
100
+ `/api/providers/${encodeURIComponent(provider)}/alias-template`,
101
+ { method: "PUT", body: JSON.stringify({ template }) },
102
+ deps,
103
+ );
104
+ const skipped = result.preview?.skippedTotal ?? result.preview?.skipped?.length ?? 0;
105
+ printData(result, wantsJson, sub === "set"
106
+ ? [`${provider}: ${template} (${result.preview?.generated ?? 0} aliases, ${skipped} skipped)`]
107
+ : [`Removed the alias template for ${provider}.`]);
108
+ return 0;
109
+ }
@@ -4,12 +4,14 @@ import type { Capability } from "./capability-types";
4
4
  export const ACCESS_REMOTE_CAPABILITIES: readonly Capability[] = [
5
5
  {
6
6
  command: ["disconnect"], summary: "Disconnect a client or preserve orphaned token files for recovery.",
7
- usage: "ocx disconnect [--keep-catalog] [--json] | ocx disconnect --orphaned-token --yes [--json]",
7
+ usage: "ocx disconnect [--keep-catalog] [--recover-config --yes] [--json] [--expect-link <linkId>] | ocx disconnect --orphaned-token --yes [--json]",
8
8
  routes: [],
9
9
  flags: [
10
10
  { name: "--keep-catalog", value: "boolean", summary: "Keep the connected client's catalog during ordinary disconnect." },
11
+ { name: "--recover-config", value: "boolean", summary: "With --yes, snapshot current Codex artifacts and recover only evidenced owned keys; unknown ownership still refuses." },
12
+ { name: "--expect-link", value: "string", summary: "Disconnect only when this machine is the connected Child of that link, or finish its unfinished disconnect once the connection is cleared; otherwise exit 5 with child_link_mismatch and change nothing." },
11
13
  { name: "--orphaned-token", value: "boolean", summary: "Preserve unowned service-token files in a private backup when disconnected." },
12
- { name: "--yes", value: "boolean", summary: "Explicitly confirm orphan-token recovery; requires --orphaned-token." },
14
+ { name: "--yes", value: "boolean", summary: "Explicitly confirm --recover-config or --orphaned-token recovery." },
13
15
  { name: "--json", value: "boolean", summary: "Emit the local result and backup location as JSON." },
14
16
  ],
15
17
  mutates: true, json: "payload",
@@ -173,6 +175,129 @@ export const ACCESS_REMOTE_CAPABILITIES: readonly Capability[] = [
173
175
  flags: [{"name":"--link-id","value":"string","summary":"Link id to check; repeatable, up to 64."},{"name":"--all","value":"boolean","summary":"Check every link in the Home's store."},{"name":"--no-wait","value":"boolean","summary":"Print the queued job and return without polling it."},{"name":"--json","value":"boolean","summary":"Emit the ocx.link.child-job/1 document as JSON (always JSON)."}],
174
176
  mutates: true,
175
177
  json: "payload",
176
- details: ["Requires loopback admin authority on the Home. Starts one observe job; the CLI polls it every 2 s and prints the final ocx.link.child-job/1 document. Exit 0 when every item succeeded, 6 when an item is busy, offline, refused, owner-action or unsupported, 1 on a failure, 4 when the link is unknown or the Home predates Child operations, 5 on a conflict: the link already has an operation running, --all found no Home-initiated link, or the command ran on a Child.","Changes no install on the Child: it runs the gated update --plan, which only computes. An npm Child without a census pair runs it through its ocx shim, so the launcher's ordinary bootstrap (sync-guard bookkeeping, Bun resolution) runs first, as for any pinned sync; the gated script disables the Desktop handoff. Writes the Home's Child observation cache.","One SSH call per Child, up to 60 s, three at a time; a POSIX Child older than 2.97.0 costs one more read-only call for its version. Home-initiated links only: client-initiated and ocx-child links are reported without SSH. One operation per link per running Home."],
178
+ details: ["Requires loopback admin authority on the Home. Starts one observe job; the CLI polls it every 2 s and prints the final ocx.link.child-job/1 document. Exit 0 when every item succeeded, 6 when an item is busy, offline, refused, owner-action or unsupported, 1 on a failure, 4 when the link is unknown or the Home predates Child operations, 5 on a conflict: the link already has an operation running, the Home has no links, or the command ran on a Child.","Changes no install on the Child: it runs the gated update --plan, which only computes. An npm Child without a census pair runs it through its ocx shim, so the launcher's ordinary bootstrap (sync-guard bookkeeping, Bun resolution) runs first, as for any pinned sync; the gated script disables the Desktop handoff. On an npm or pnpm Child served through its census pair it also runs node --version (bounded to 10 s, read-only) to report whether the package launcher can apply an update. Writes the Home's Child observation cache.","One SSH call per Child, up to 60 s, three at a time; a POSIX Child older than 2.97.0 costs one more read-only call for its version. Home-initiated links only: client-initiated and ocx-child links are reported without SSH. One operation per link per running Home."],
179
+ },
180
+ {
181
+ command: ["link", "update"], summary: "Update a Home-initiated Child's OpenCodex to this Home's version.",
182
+ usage: "ocx link update (--link-id <id> | --all) --yes [--no-wait] [--json]",
183
+ routes: [{ method: "POST", path: "/api/link/children/operations" }, { method: "GET", path: "/api/link/children/jobs/{jobId}" }],
184
+ flags: [{ name: "--link-id", value: "string", summary: "Home-initiated link to update; repeatable, up to 64." }, { name: "--all", value: "boolean", summary: "Every link in the Home's store, one Child at a time; Child-initiated links report unsupported." },
185
+ { name: "--yes", value: "boolean", required: true, summary: "Confirms that each updated Child's OpenCodex restarts and its relayed turns end." },
186
+ { name: "--no-wait", value: "boolean", summary: "Print the queued job and return." }, { name: "--json", value: "boolean", summary: "Emit the ocx.link.child-job/1 document (always JSON)." }],
187
+ mutates: true, json: "payload",
188
+ details: ["Runs a pinned sync --expect-link first to confirm the Child still belongs to this link, then the Child's own ocx update --plan through the served entry, then --yes with --expect-plan and a --not-after 120 s after the plan on the Child's own clock, through the link's pinned SSH trust. npm and pnpm installs apply through their Node launcher; Bun installs plan and apply on their served Bun entry. The target is always this Home's version; the Child refuses a downgrade.", "Children below 2.97.0 receive no update command: from 2.93.0 they still get the identity sync, then report owner-action legacy-ocx; ocx-child and GOAT-managed Children report unsupported or owner-action; Windows Children are refused orchestrated apply (unsupported windows-apply). An update restarts the Child's OpenCodex and ends any turn currently relayed for it, so --yes is required. A pinned sync follows a successful, failed or rolled-back apply; an apply whose result is unknown is recorded and neither retried nor resynced, so re-check it with ocx link check.", "Exit 0 all succeeded or up-to-date (with --no-wait: the job was accepted and may still be running), 6 partial (including a kept update whose follow-up sync failed), 1 failed, uncertain or an unknown state, 5 another operation holds the link, the only link named was started from the Child, the Home has no links or the command ran on a Child, 4 the link is unknown or the Home lacks Child operations. On a Home not bound to loopback it exits 1: these operations are not available there, and the dashboard has no controls for them."],
189
+ },
190
+ {
191
+ command: ["link", "sync"], summary: "Run the pinned catalog and settings sync on Home-initiated Children.",
192
+ usage: "ocx link sync (--link-id <id> | --all) [--no-wait] [--json] | ocx link sync --link-id <id> (--restart-app-server-only | --restart-codex --yes) [--ignore-activity] [--no-wait] [--json]",
193
+ routes: [{ method: "POST", path: "/api/link/children/operations" }, { method: "GET", path: "/api/link/children/jobs/{jobId}" }],
194
+ flags: [{ name: "--link-id", value: "string", summary: "Home-initiated link to sync; repeatable, up to 64, exactly one with a restart." }, { name: "--all", value: "boolean", summary: "Every link in the Home's store, three at a time; refused with a restart." },
195
+ { name: "--restart-app-server-only", value: "boolean", summary: "Also restart the Child's Codex app-servers after the sync writes." }, { name: "--restart-codex", value: "boolean", summary: "Also quit and relaunch the Child's Codex desktop app; ends live turns." },
196
+ { name: "--yes", value: "boolean", summary: "Confirms --restart-codex." }, { name: "--ignore-activity", value: "boolean", summary: "Restart even while the Child is busy or held; ends its running work (operator override, never automatic)." }, { name: "--no-wait", value: "boolean", summary: "Print the queued job and return." }, { name: "--json", value: "boolean", summary: "Emit the ocx.link.child-job/1 document (always JSON)." }],
197
+ mutates: true, json: "payload",
198
+ details: ["The same sync --expect-link the ocx sync fan-out runs, gated at 2.93.0. Restart flags are refused on Windows and ignored by ocx-child; the item reports restart unsupported.", "A restart needs one --link-id (--all is refused) and --restart-codex needs --yes. The sync runs first; the restart then goes out as a second pinned sync and is withheld (restart skipped, reason restart-skipped:link-active) while a relayed model request for that Child is in flight. A restarting call whose result is unknown ends uncertain (restart-result-unknown).", "--ignore-activity restarts past that check and past held link WebSocket activity (ocx link status, child.holds); the job records ignoreActivity: true and the Home logs the link id and its in-flight count. Platform and Child-kind refusals still apply, and no automatic path sets it.", "Exit codes as for ocx link update; a withheld or unconfirmed restart exits 6 or 1."],
199
+ },
200
+ {
201
+ command: ["link", "restart-codex"], summary: "Restart Codex on one Home-initiated Child so it reloads the catalog.",
202
+ usage: "ocx link restart-codex --link-id <id> [--scope app-server|codex] --yes [--ignore-activity] [--no-wait] [--json]",
203
+ routes: [{ method: "POST", path: "/api/link/children/operations" }, { method: "GET", path: "/api/link/children/jobs/{jobId}" }],
204
+ flags: [{ name: "--link-id", value: "string", required: true, summary: "Home-initiated link." }, { name: "--scope", value: "string", summary: "app-server (default) or codex (also relaunches the desktop app)." },
205
+ { name: "--yes", value: "boolean", required: true, summary: "Confirms that running Codex turns on the Child end." }, { name: "--ignore-activity", value: "boolean", summary: "Restart even while the Child is busy or held; ends its running work (operator override, never automatic)." },
206
+ { name: "--no-wait", value: "boolean", summary: "Print the queued job and return." }, { name: "--json", value: "boolean", summary: "Emit the ocx.link.child-job/1 document (always JSON)." }],
207
+ mutates: true, json: "payload",
208
+ details: ["A pinned sync, then a second pinned sync with the restart flag; works on full Children from 2.93.0. app-server scope leaves the Codex desktop app's own app-server running. While a relayed model request for that Child is in flight nothing is sent and the item is busy (restart-skipped:link-active), unless --ignore-activity overrides that check.", "Refused on Windows Children (unsupported windows-restart) and reported unsupported for ocx-child. The codex scope needs a logged-in GUI session on the Child; its outcome is requested, not confirmed. Exit codes as for ocx link update."],
209
+ },
210
+ {
211
+ command: ["link", "capture", "start"], summary: "Open a short window in which this machine's link tunnels log sanitized SSH diagnostics.",
212
+ usage: "ocx link capture start [--minutes <1-60>] [--json]",
213
+ routes: [],
214
+ flags: [{ name: "--minutes", value: "number", summary: "Window length, 15 by default and 60 at most; starting again while open moves the expiry." },
215
+ { name: "--json", value: "boolean", summary: "Emit the capture status as JSON." }],
216
+ mutates: true, json: "envelope",
217
+ details: ["A local file operation under <OPENCODEX_HOME>/link/ssh-capture/ on a Home or a Child; it needs no running proxy and no admin token, and no sync, management route or remote input can start it. While the window is open, the next ssh attempt of each Home (-R) or Child (-L) tunnel runs with LogLevel=DEBUG1; an already connected tunnel keeps its level until it reconnects.", "Every stderr line passes an allowlist of OpenSSH line shapes before it is stored: host names, addresses, users, ports, paths, keys, fingerprints, commands and server messages become fixed placeholders and an unknown line is stored only as the category unrecognized. One file per window, at most 1 MiB, deleted 72 h after its last write; at most four files are kept, the oldest deleted first. Admission is unchanged and lines ssh prints only above LogLevel=ERROR are kept out of the failure classification; an unrecognized line such as a server banner still counts and can change the reported cause."],
218
+ },
219
+ {
220
+ command: ["link", "capture", "stop"], summary: "Close the SSH capture window; capture files stay until their retention passes.",
221
+ usage: "ocx link capture stop [--json]",
222
+ routes: [],
223
+ flags: [{ name: "--json", value: "boolean", summary: "Emit the capture status as JSON." }],
224
+ mutates: true, json: "envelope",
225
+ details: ["Removes only the control file, so nothing more is stored and the next tunnel attempt runs ssh with LogLevel=ERROR again. Capture files are kept for sharing and deleted 72 h after their last write; status and later starts apply that retention."],
226
+ },
227
+ {
228
+ command: ["link", "capture", "status"], summary: "Show whether SSH capture is on, its expiry and the retained capture files.",
229
+ usage: "ocx link capture status [--json]",
230
+ routes: [],
231
+ flags: [{ name: "--json", value: "boolean", summary: "Emit the capture status as JSON." }],
232
+ mutates: true, json: "envelope",
233
+ details: ["Reads the local capture directory. It also applies retention: capture files 72 h past their last write and an expired control file are deleted, and the count is reported as removed."],
234
+ },
235
+ {
236
+ command: ["link", "policy"], summary: "Read or change how this Home keeps its Children current.",
237
+ usage: "ocx link policy [--updates off|notify|auto-when-idle] [--catalog-fanout auto|manual] [--child-codex-restart never|app-server-when-idle] [--idle-after-minutes <1-60>] [--json]",
238
+ routes: [{ method: "GET", path: "/api/link/children/policy" }, { method: "PUT", path: "/api/link/children/policy" }],
239
+ flags: [{ name: "--updates", value: "string", summary: "off, notify, or auto-when-idle (default)." }, { name: "--catalog-fanout", value: "string", summary: "auto (default) or manual." },
240
+ { name: "--child-codex-restart", value: "string", summary: "never (default) or app-server-when-idle." }, { name: "--idle-after-minutes", value: "number", summary: "Minutes without a relayed model request before a Child counts as idle; default 10." },
241
+ { name: "--json", value: "boolean", summary: "Emit {policy, warning} as JSON." }],
242
+ mutates: true, json: "payload",
243
+ details: ["Without flags it reads the policy; with flags it changes only those knobs. Stored in <configDir>/link/child-policy.json on the Home, never in config.json. An invalid file turns automatic catalog fan-out and updates off; saving merges onto that, so pass --catalog-fanout auto and an --updates mode to turn them back on.", "--updates stores the update mode only; this release starts no automatic update (notify and auto-when-idle take effect when the automatic update sweep ships). Catalog fan-out syncs Home-initiated Children 60 s after a Home catalog change; it restarts Codex on a Child only with app-server-when-idle, and only while that Child is idle. A Home without links runs none of it."],
244
+ },
245
+ {
246
+ command: ["link", "routes"], summary: "List the SSH routes a Home-initiated link may use, in the order the Home tries them.",
247
+ usage: "ocx link routes --link-id <id> [--json]",
248
+ routes: [{ method: "GET", path: "/api/link/{id}/routes" }],
249
+ flags: [{ name: "--link-id", value: "string", required: true, summary: "Home-initiated link id." }, { name: "--json", value: "boolean", summary: "Emit {linkId, pin, routes} as JSON." }],
250
+ mutates: false, json: "payload",
251
+ details: ["Requires loopback admin authority on the Home, like ocx link reconnect; the local control socket does not serve it. The pin is the link's own alias: its host key is the one every route must present, and it is always in the list. A link with one route lists its alias only. Read ocx link status for the route in use and since when."],
252
+ },
253
+ {
254
+ command: ["link", "routes", "add"], summary: "Add an SSH route to a Home-initiated link after proving the link's pinned host key over it.",
255
+ usage: "ocx link routes add --link-id <id> --route <alias> [--position <n>] [--json]",
256
+ routes: [{ method: "POST", path: "/api/link/{id}/routes" }],
257
+ flags: [{ name: "--link-id", value: "string", required: true, summary: "Home-initiated link id." }, { name: "--route", value: "string", required: true, summary: "SSH host alias or destination of the new route." },
258
+ { name: "--position", value: "number", summary: "Index in the list; by default just before the alias, so direct routes come first and the alias stays last." }, { name: "--json", value: "boolean", summary: "Emit {linkId, pin, routes} as JSON." }],
259
+ mutates: true, json: "payload",
260
+ details: ["The Home first checks that its link known_hosts file trusts only the link's recorded key for the alias (every entry for it, in any case or hashed by an older release, carries that key), then connects over the new route with strict checking against that one key and stores the route only if the same machine answers. Refusals: route_unproven with a cause (hostkey, auth, forward, transient), pin_mismatch, trust_file_unexpected, link_changed, pin_changed, route_exists, route_limit (8 routes), link_operation_in_progress (removal or a Child job holds the link). Exit 5 on a refusal, 4 for an unknown link, 1 when the routes were stored but the running proxy did not apply them (routes_stored_reload_failed; ocx link routes --link-id <id> reads what was stored).", "Adding a route does not move a running tunnel; the Home tries the list in order from the next connection on (ocx link reconnect starts one now). Requires loopback admin authority on the Home."],
261
+ },
262
+ {
263
+ command: ["link", "routes", "remove"], summary: "Remove an SSH route from a Home-initiated link.",
264
+ usage: "ocx link routes remove --link-id <id> --route <alias> [--json]",
265
+ routes: [{ method: "POST", path: "/api/link/{id}/routes" }],
266
+ flags: [{ name: "--link-id", value: "string", required: true, summary: "Home-initiated link id." }, { name: "--route", value: "string", required: true, summary: "Route to remove." }, { name: "--json", value: "boolean", summary: "Emit {linkId, pin, routes} as JSON." }],
267
+ mutates: true, json: "payload",
268
+ details: ["The alias is the link's pin and cannot be removed (route_is_pin). Removing the route the tunnel uses restarts the tunnel on the remaining list; removing the last extra route returns the link to one route. Exit 4 for an unknown link or route (link_not_found, route_not_found), 5 on a refusal (route_is_pin, link_operation_in_progress), 1 when the routes were stored but the running proxy did not apply them (routes_stored_reload_failed). Requires loopback admin authority on the Home."],
269
+ },
270
+ {
271
+ command: ["link", "routes", "order"], summary: "Reorder a Home-initiated link's SSH routes.",
272
+ usage: "ocx link routes order --link-id <id> --routes <alias,alias,...> [--json]",
273
+ routes: [{ method: "POST", path: "/api/link/{id}/routes" }],
274
+ flags: [{ name: "--link-id", value: "string", required: true, summary: "Home-initiated link id." }, { name: "--routes", value: "string", required: true, summary: "The current routes, comma separated, in the new order." }, { name: "--json", value: "boolean", summary: "Emit {linkId, pin, routes} as JSON." }],
275
+ mutates: true, json: "payload",
276
+ details: ["The list must name exactly the current routes (route_order_mismatch otherwise), so no route enters unproven. A reorder does not move a running tunnel. Requires loopback admin authority on the Home."],
277
+ },
278
+ {
279
+ command: ["link", "operations"], summary: "List or read the enrollments and revokes journalled under an operation id.",
280
+ usage: "ocx link operations [--operation-id <id>] [--json]",
281
+ routes: [{ method: "GET", path: "/api/link/operations" }, { method: "GET", path: "/api/link/operations/{id}" }],
282
+ flags: [{ name: "--operation-id", value: "string", summary: "Read one operation." }, { name: "--json", value: "boolean", summary: "Emit {operations} or the one entry as JSON." }],
283
+ mutates: false, json: "payload",
284
+ details: ["Each entry names its reserved link and key ids, the intent and completion of every effect and its outcome: open, committed, failed_clean, residual (the Child may still hold an enrollment or a plant) or unknown. Committed and failed_clean entries stay 30 days; residual and unknown entries stay until resolved, then 30 days. Past 256 settled entries the oldest go early, never before 2 hours plus the alias-lock wait: a repeat with the same operation id and parameters (another set answers operation_mismatch) that reaches the journal within 2 hours of the answer gets the recorded outcome, except that a revoke whose own removal was interrupted resumes it first and answers that attempt (retry a transient refusal such as link_operation_in_progress), and later the id may be treated as a new operation, which enrolls a machine again if its link was removed meanwhile; at 256 open or unresolved residual or unknown entries a new journalled operation is refused (operation_journal_full) until some are resolved, and so is one after 1024 operations settled within 2 hours and three minutes, a limit of about 500 journalled operations per hour sustained. Requires loopback admin authority on the Home."],
285
+ },
286
+ {
287
+ command: ["link", "operations", "resolve"], summary: "Mark a residual or unknown link operation resolved.",
288
+ usage: "ocx link operations resolve --operation-id <id> --yes [--json]",
289
+ routes: [{ method: "POST", path: "/api/link/operations/{id}/resolve" }],
290
+ flags: [{ name: "--operation-id", value: "string", required: true, summary: "The residual or unknown operation." }, { name: "--yes", value: "boolean", required: true, summary: "Confirms that the Child is clean or the loss is accepted." }, { name: "--json", value: "boolean", summary: "Emit the resolved entry as JSON." }],
291
+ mutates: true, json: "payload",
292
+ details: ["Changes nothing on the Child or in links.json: it records the resolution, and the entry's 30 days of retention start then. operation_not_resolvable (exit 5) for any other state, operation_not_found (exit 4). Requires loopback admin authority on the Home.", "A journalled revoke past its remote_cleanup intent (the Child's cleanup may have started) that then ended unknown, or that stayed open with no revoke running it (the Home stopped or the revoke failed before writing its outcome), keeps that link's tunnel down across restarts (ocx link status: reason revoke_unsettled; ocx link reconnect: link_suspended). Resolving the revoke reloads the tunnels, so the link reconnects. An open revoke cannot be resolved: repeat it with the same --operation-id and the flags of its first attempt (the journal keeps only a digest of them, so a different --purge answers operation_mismatch), then resolve it if it ends unknown."],
293
+ },
294
+ {
295
+ command: ["link", "activity", "clear"], summary: "Clear one link's held activity so automatic and activity-gated Child restarts may run again.",
296
+ usage: "ocx link activity clear --link-id <id> [--json]",
297
+ routes: [{ method: "POST", path: "/api/link/children/activity/clear" }],
298
+ flags: [{ name: "--link-id", value: "string", required: true, summary: "The link whose holds to clear." },
299
+ { name: "--json", value: "boolean", summary: "Emit {linkId, cleared} as JSON." }],
300
+ mutates: true, json: "payload",
301
+ details: ["A link Responses WebSocket that closes while Codex was busy leaves a hold, and so does a Home that stopped without a clean shutdown; a hold keeps the Child in flight so automatic and activity-gated restarts wait. ocx link status lists each held link's holds and their reasons under child.holds. Holds that only the operator can release (an unknown running turn, untracked results, no thread id, or an unknown state after a crash) end here.", "Clears every hold of that one link and nothing else; nothing clears holds automatically. The holds file is saved before anything is forgotten, so a failed save clears nothing (503). It does not touch live sockets or relayed requests."],
177
302
  },
178
303
  ];
@@ -96,7 +96,7 @@ export const ACCOUNT_CAPABILITIES: readonly Capability[] = [
96
96
  summary: "Reauthenticate a provider account through the existing login flow.",
97
97
  usage: "ocx account reauth <provider> [--id <account-id>] [--device] [--code -] [--no-wait] [--open-browser <on|off>] [--json]",
98
98
  routes: [{"method":"POST","path":"/api/codex-auth/login"},{"method":"GET","path":"/api/codex-auth/login-status"},{"method":"POST","path":"/api/codex-auth/login/code"},{"method":"POST","path":"/api/oauth/login"},{"method":"GET","path":"/api/oauth/status"},{"method":"POST","path":"/api/oauth/login/code"}],
99
- flags: [{"name":"--id","value":"string","summary":"Account identity to reauthenticate."},{"name":"--device","value":"boolean","summary":"Codex device login; accepted for already-device-native kimi, nous and github-copilot."},{"name":"--code","value":"string","summary":"Use - to read the short-lived authorization code from stdin."},{"name":"--no-wait","value":"boolean","summary":"Return after starting the flow."},{"name":"--json","value":"boolean","summary":"Emit login instructions or completion state."},{"name":"--open-browser","value":"string","summary":"on or off for browser-capable login; rejected for explicit/native device flows."}],
99
+ flags: [{"name":"--id","value":"string","summary":"Account identity to reauthenticate."},{"name":"--device","value":"boolean","summary":"Codex device login or xAI device authorization; a no-op for already-device-native kimi, nous and github-copilot."},{"name":"--code","value":"string","summary":"Use - to read the short-lived authorization code from stdin."},{"name":"--no-wait","value":"boolean","summary":"Return after starting the flow."},{"name":"--json","value":"boolean","summary":"Emit login instructions or completion state; xAI --device requires --no-wait."},{"name":"--open-browser","value":"string","summary":"on or off for browser-capable login; rejected for explicit/native device flows."}],
100
100
  mutates: true,
101
101
  json: "payload",
102
102
  details: ["Alias of account login with --reauth. openai, codex and chatgpt address the pool; native main uses account main reauth. Human completes authorization; keep returned login material out of transcripts. Kiro --method cannot be combined with reauth.","Explicit add-account is incompatible with reauth. Browser preference is accepted only by browser-capable flows; device verification remains manual."],
@@ -112,8 +112,8 @@ export const ACCOUNT_CAPABILITIES: readonly Capability[] = [
112
112
  command: ["account", "cancel"], summary: "Cancel a pending account login flow.",
113
113
  usage: "ocx account cancel <provider> [--flow <flow-id>] [--json]",
114
114
  routes: [{ method: "POST", path: "/api/codex-auth/login/cancel" }, { method: "POST", path: "/api/oauth/login/cancel" }],
115
- flags: [{ name: "--flow", value: "string", summary: "Required for Codex; selects a native Kiro flow when supplied." }, { name: "--json", value: "boolean", summary: "Emit cancellation receipt." }], mutates: true, json: "payload",
116
- details: ["Codex cancellation sends flowId. Other providers send provider; Kiro additionally forwards a supplied flowId."],
115
+ flags: [{ name: "--flow", value: "string", summary: "Required for Codex; selects a native Kiro or xAI flow when supplied." }, { name: "--json", value: "boolean", summary: "Emit cancellation receipt." }], mutates: true, json: "payload",
116
+ details: ["Codex cancellation sends flowId. Other providers send provider; Kiro and xAI additionally forward a supplied flowId."],
117
117
  },
118
118
  {
119
119
  command: ["account", "reset-credits"], summary: "Read Codex reset-credit state, or explicitly consume one with operator authorization.",