@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.
- package/AGENTS_INSTALL.md +23 -1
- package/README.md +1 -1
- package/bin/ocx.mjs +40 -19
- package/gui/dist/assets/{App-COo8Yopd.css → App-BGP8I0V4.css} +1 -1
- package/gui/dist/assets/App-DcpyI78f.js +60 -0
- package/gui/dist/assets/{Tray-BcaI-VCr.js → Tray-CzjPJprT.js} +1 -1
- package/gui/dist/assets/brand-mark-BTIi7e69.js +1 -0
- package/gui/dist/assets/index-DJxM-imn.css +2 -0
- package/gui/dist/assets/index-DVgU6S3y.js +138 -0
- package/gui/dist/assets/{segment-thumb-features-e9A_FogJ.js → segment-thumb-features-Bn6Y-g3R.js} +1 -1
- package/gui/dist/classic/assets/App-eYJAyNHM.js +59 -0
- package/gui/dist/classic/assets/{Tray-DT146AhS.js → Tray-xHMYxLkV.js} +1 -1
- package/gui/dist/classic/assets/index-DSaVRW4F.js +138 -0
- package/gui/dist/classic/assets/quota-summary-DyzHlkFl.js +1 -0
- package/gui/dist/classic/index.html +1 -1
- package/gui/dist/index.html +2 -2
- package/native/ocx-child/Cargo.toml +9 -0
- package/native/ocx-child/src/cli.rs +404 -20
- package/native/ocx-child/src/codex_home.rs +99 -14
- package/native/ocx-child/src/daemon.rs +2 -1
- package/native/ocx-child/src/lib.rs +3 -0
- package/native/ocx-child/src/link_ws.rs +2598 -0
- package/native/ocx-child/src/link_ws_advert.rs +346 -0
- package/native/ocx-child/src/link_ws_frame.rs +749 -0
- package/native/ocx-child/src/parity.rs +5 -1
- package/native/ocx-child/src/platform.rs +152 -6
- package/native/ocx-child/src/relay.rs +150 -19
- package/package.json +3 -3
- package/src/adapters/anthropic/advisor-tool.ts +176 -0
- package/src/adapters/anthropic/beta-body-pairs.ts +6 -0
- package/src/adapters/anthropic/client-identity.ts +3 -1
- package/src/adapters/anthropic/passthrough.ts +9 -3
- package/src/adapters/anthropic/per-message-effort.ts +296 -0
- package/src/adapters/anthropic.ts +34 -14
- package/src/adapters/claude-cli/adapter.ts +1 -0
- package/src/adapters/client-fingerprint.ts +3 -3
- package/src/adapters/cursor/discovery.ts +17 -0
- package/src/adapters/cursor/native-exec-desktop.ts +2 -1
- package/src/adapters/cursor/native-exec-shell.ts +2 -1
- package/src/adapters/cursor/protobuf-request.ts +8 -8
- package/src/adapters/cursor.ts +7 -6
- package/src/adapters/devin/cloud-direct/chat.ts +71 -14
- package/src/adapters/google-antigravity-wire.ts +7 -5
- package/src/adapters/google-errors.ts +14 -2
- package/src/adapters/google-wire-compiler.ts +2 -2
- package/src/adapters/google.ts +9 -2
- package/src/adapters/kiro/payload.ts +7 -4
- package/src/adapters/kiro/reasoning.ts +44 -1
- package/src/adapters/kiro/structured-output.ts +10 -8
- package/src/adapters/kiro-tools.ts +61 -15
- package/src/adapters/openai-chat/destination-policy.ts +16 -0
- package/src/adapters/openai-chat/reasoning-replay.ts +4 -1
- package/src/adapters/qoder/adapter.ts +9 -1
- package/src/adapters/zed.ts +7 -2
- package/src/advisor/consult.ts +15 -4
- package/src/advisor/context.ts +12 -3
- package/src/advisor/runtime.ts +35 -5
- package/src/advisor/settings.ts +8 -0
- package/src/advisor/synthetic-tool.ts +21 -8
- package/src/bridge/response-json.ts +11 -2
- package/src/bridge/sse.ts +43 -8
- package/src/claude/auth-detect.ts +21 -33
- package/src/claude/desktop-3p.ts +11 -5
- package/src/claude/desktop-gateway-state.ts +2 -0
- package/src/claude/desktop-remote-store-artifact.ts +14 -3
- package/src/claude/desktop-remote-store.ts +82 -12
- package/src/claude/inbound-content-options.ts +31 -16
- package/src/claude/outbound.ts +13 -3
- package/src/cli/account-api.ts +21 -1
- package/src/cli/account-auth.ts +83 -22
- package/src/cli/account-extended.ts +33 -2
- package/src/cli/account-key-quota.ts +34 -5
- package/src/cli/account.ts +4 -2
- package/src/cli/advisor.ts +7 -4
- package/src/cli/alias.ts +38 -1
- package/src/cli/capabilities-access-remote.ts +128 -3
- package/src/cli/capabilities-accounts.ts +6 -6
- package/src/cli/capabilities-agents-routing.ts +17 -10
- package/src/cli/capabilities-base.ts +49 -19
- package/src/cli/capabilities-integrations.ts +2 -2
- package/src/cli/capabilities-observe-system.ts +2 -2
- package/src/cli/capabilities-provider-models.ts +18 -2
- package/src/cli/capabilities-route-to.ts +43 -0
- package/src/cli/capabilities.ts +2 -0
- package/src/cli/capability-contracts.ts +1 -1
- package/src/cli/claude-desktop.ts +30 -11
- package/src/cli/claude.ts +17 -3
- package/src/cli/codex-launcher.ts +3 -1
- package/src/cli/codex-shim-autorestore.ts +5 -42
- package/src/cli/config-command.ts +14 -1
- package/src/cli/config-root-startup.ts +34 -0
- package/src/cli/connect.ts +88 -16
- package/src/cli/desktop-runtime-guidance.ts +1 -1
- package/src/cli/disconnect-runtime.ts +178 -0
- package/src/cli/dispatch.ts +61 -13
- package/src/cli/export-command.ts +1 -1
- package/src/cli/gui-pair-client.ts +6 -3
- package/src/cli/gui.ts +10 -5
- package/src/cli/help-catalog.ts +11 -0
- package/src/cli/help.ts +4 -3
- package/src/cli/index.ts +85 -94
- package/src/cli/inspect.ts +11 -2
- package/src/cli/integrations.ts +26 -1
- package/src/cli/link-apply-restart.ts +4 -2
- package/src/cli/link-capture.ts +64 -0
- package/src/cli/link-child-ops.ts +218 -40
- package/src/cli/link-cleanup.ts +8 -5
- package/src/cli/link-diagnostics.ts +67 -0
- package/src/cli/link-enrollment.ts +158 -12
- package/src/cli/link-operations.ts +52 -0
- package/src/cli/link-recover.ts +152 -0
- package/src/cli/link-routes.ts +90 -0
- package/src/cli/link-status-child.ts +44 -1
- package/src/cli/link-status-traffic.ts +34 -0
- package/src/cli/link.ts +315 -37
- package/src/cli/message-command.ts +1 -1
- package/src/cli/message-mcp-command.ts +23 -10
- package/src/cli/models-runtime.ts +3 -3
- package/src/cli/opencode.ts +3 -1
- package/src/cli/pi-sync.ts +35 -0
- package/src/cli/preflight-exemptions.ts +49 -0
- package/src/cli/registry.ts +33 -14
- package/src/cli/resolve.ts +23 -8
- package/src/cli/restart-failure.ts +15 -2
- package/src/cli/root.ts +5 -1
- package/src/cli/route-to.ts +172 -0
- package/src/cli/runtime-api.ts +9 -8
- package/src/cli/status.ts +7 -2
- package/src/cli/stop-approval.ts +66 -19
- package/src/cli/stop-report.ts +23 -0
- package/src/cli/stop-windows-checked.ts +304 -0
- package/src/cli/sync-command.ts +70 -15
- package/src/cli/sync-fanout.ts +74 -19
- package/src/cli/sync-flags.ts +40 -3
- package/src/cli/sync-link-status.ts +18 -2
- package/src/cli/sync-update-guard.ts +7 -2
- package/src/cli/system-command.ts +1 -1
- package/src/cli/system-restart-client.ts +10 -3
- package/src/cli/system-settings-parity.ts +2 -1
- package/src/cli/uninstall-plan.ts +77 -5
- package/src/cli/uninstall-stop.ts +152 -0
- package/src/cli/v2-input.ts +10 -6
- package/src/cli/v2-local-output.ts +3 -2
- package/src/cli/v2-runtime.ts +10 -3
- package/src/cli/v2.ts +22 -7
- package/src/client/connect.ts +376 -35
- package/src/client/desktop-refusal.ts +38 -0
- package/src/client/lifecycle-lock.ts +29 -4
- package/src/client/link-home-features.ts +27 -0
- package/src/client/link-home.ts +92 -4
- package/src/client/link-ingress.ts +21 -3
- package/src/client/link-join.ts +12 -2
- package/src/client/link-parity-reporter.ts +60 -6
- package/src/client/link-relay-transport.ts +161 -36
- package/src/client/link-relay.ts +150 -6
- package/src/client/link-request-compression.ts +84 -0
- package/src/client/link-state.ts +11 -5
- package/src/client/link-status.ts +39 -1
- package/src/client/link-teardown.ts +1 -0
- package/src/client/link-tunnel.ts +56 -5
- package/src/client/link-websocket-limits.ts +89 -0
- package/src/client/link-websocket.ts +586 -0
- package/src/client/link-ws-advertisement.ts +100 -0
- package/src/client/link-ws-framer.ts +241 -0
- package/src/client/link-ws-transport.ts +177 -0
- package/src/client/machine-api.ts +13 -2
- package/src/client/machine-listener.ts +48 -7
- package/src/client/route-intent-apply.ts +293 -0
- package/src/client/route-intent-file-originals.ts +97 -0
- package/src/client/route-intent-native-originals.ts +201 -0
- package/src/client/route-intent-watch.ts +141 -0
- package/src/client/runtime-restart.ts +141 -7
- package/src/client/runtime.ts +63 -15
- package/src/client/state.ts +44 -0
- package/src/client/sync-expectation.ts +36 -2
- package/src/client/sync-runtime.ts +7 -0
- package/src/clients/config-export/alias-selectors.ts +63 -40
- package/src/clients/config-export/contracts.ts +2 -0
- package/src/clients/config-export/nested-selectors.ts +42 -0
- package/src/clients/config-export.ts +22 -3
- package/src/codex/account-pause.ts +4 -0
- package/src/codex/account-runtime-state.ts +4 -0
- package/src/codex/account-store.ts +12 -3
- package/src/codex/account-usability.ts +13 -0
- package/src/codex/auth-api/account-list.ts +29 -3
- package/src/codex/auth-api/main-account-probe.ts +3 -1
- package/src/codex/auth-api/main-hard-lock-refusal-read.ts +172 -0
- package/src/codex/auth-collision.ts +23 -22
- package/src/codex/auth-context.ts +61 -8
- package/src/codex/catalog/build-entries.ts +10 -0
- package/src/codex/catalog/derive-entry.ts +7 -0
- package/src/codex/catalog/gather-capture.ts +8 -2
- package/src/codex/catalog/parsing.ts +7 -3
- package/src/codex/catalog/provider-models.ts +54 -15
- package/src/codex/catalog/reserve-warn.ts +7 -5
- package/src/codex/catalog/reserve.ts +4 -3
- package/src/codex/catalog/retained-sync.ts +4 -1
- package/src/codex/catalog/routed-defaults.ts +35 -0
- package/src/codex/catalog/routed-gather.ts +1 -1
- package/src/codex/catalog-auto-refresh.ts +11 -0
- package/src/codex/cli-update-job.ts +35 -13
- package/src/codex/convergence.ts +4 -2
- package/src/codex/desktop-compatibility/native-identity.ts +4 -8
- package/src/codex/features.ts +2 -2
- package/src/codex/history-provider.ts +31 -0
- package/src/codex/inject/multi-agent-v2.ts +9 -3
- package/src/codex/inject/paginated-openai-compat.ts +54 -1
- package/src/codex/inject/plan.ts +20 -2
- package/src/codex/inject.ts +2 -0
- package/src/codex/journal-config-restore.ts +217 -0
- package/src/codex/journal.ts +75 -6
- package/src/codex/loopback-target.ts +22 -8
- package/src/codex/main-account.ts +109 -57
- package/src/codex/native-main-auth-file.ts +118 -0
- package/src/codex/native-main-credentials.ts +270 -0
- package/src/codex/native-main-owner.ts +3 -0
- package/src/codex/native-main-refresh-mode.ts +14 -1
- package/src/codex/native-profile-manager.ts +4 -3
- package/src/codex/native-profile-store.ts +3 -61
- package/src/codex/orca-import.ts +10 -1
- package/src/codex/quota-history.ts +13 -0
- package/src/codex/quota-window-conflict.ts +103 -0
- package/src/codex/quota.ts +86 -15
- package/src/codex/subagent-model-fallback.ts +3 -1
- package/src/codex/websocket-activity.ts +171 -16
- package/src/codex/websocket-registry.ts +11 -4
- package/src/combos/cooldown-store.ts +25 -5
- package/src/combos/failover.ts +342 -3
- package/src/combos/index.ts +5 -0
- package/src/combos/resolve.ts +115 -19
- package/src/config/dashboard-trusted-proxy.ts +83 -0
- package/src/config/diagnostics.ts +31 -0
- package/src/config/feature-flags.ts +9 -0
- package/src/config/live-reconcile.ts +16 -4
- package/src/config/load-degrade.ts +14 -1
- package/src/config/multi-agent-surface.ts +28 -5
- package/src/config/pending-teardown.ts +60 -3
- package/src/config/persisted-mutation.ts +2 -2
- package/src/config/persisted-projections.ts +18 -0
- package/src/config/process-state.ts +176 -4
- package/src/config/provider-validation.ts +4 -4
- package/src/config/reserve-capability.ts +96 -0
- package/src/config/schema/config-schema.ts +12 -0
- package/src/config/schema/leaf-validators.ts +11 -2
- package/src/config/schema/routed-catalog-defaults.ts +49 -0
- package/src/config/windows-process-command-line.ts +107 -0
- package/src/config.ts +7 -7
- package/src/desktop-update/acquire.ts +202 -0
- package/src/desktop-update/cli.ts +168 -0
- package/src/desktop-update/drain.ts +40 -0
- package/src/desktop-update/headless.ts +285 -0
- package/src/desktop-update/image.ts +85 -0
- package/src/desktop-update/install.ts +53 -0
- package/src/desktop-update/msi.ts +72 -0
- package/src/desktop-update/release.ts +128 -0
- package/src/desktop-update/runtime.ts +155 -0
- package/src/desktop-update/staging.ts +118 -0
- package/src/desktop-update/trust.ts +45 -0
- package/src/generated/compatibility-version.json +1114 -442
- package/src/generated/model-metadata.ts +1 -1
- package/src/images/fulfill-video.ts +3 -3
- package/src/images/loop.ts +9 -2
- package/src/images/plan.ts +147 -11
- package/src/images/types.ts +13 -4
- package/src/images/xai-video-client.ts +72 -10
- package/src/integrations/model-name-guard.ts +25 -0
- package/src/integrations/route-intent-catalog.ts +26 -0
- package/src/integrations/route-intent-connected.ts +262 -0
- package/src/integrations/route-intent-contract.ts +55 -0
- package/src/integrations/route-intent-disconnect.ts +109 -0
- package/src/integrations/route-intent-initial.ts +64 -0
- package/src/integrations/route-intent-state.ts +117 -0
- package/src/integrations/route-intent-tick.ts +65 -0
- package/src/integrations/route-intent.ts +212 -0
- package/src/integrations/writer.ts +44 -11
- package/src/lib/client-retry-after.ts +29 -0
- package/src/lib/config-ownership.ts +13 -0
- package/src/lib/desktop-gui-origin.ts +28 -0
- package/src/lib/errors.ts +1 -1
- package/src/lib/gcp-adc.ts +48 -4
- package/src/lib/gui-pair-capability.ts +2 -1
- package/src/lib/messages-error-body.ts +4 -1
- package/src/lib/offline-resend.ts +150 -0
- package/src/lib/outbound-credential-registry.ts +362 -4
- package/src/lib/paced-stream.ts +34 -0
- package/src/lib/passive-key-fetch-proof.ts +30 -0
- package/src/lib/passive-read.ts +5 -0
- package/src/lib/process-control.ts +76 -12
- package/src/lib/provider-outbound.ts +17 -6
- package/src/lib/redact.ts +84 -8
- package/src/lib/request-failure-model.ts +2 -0
- package/src/lib/response-body-inactivity.ts +23 -1
- package/src/lib/state-store-registrations.ts +11 -0
- package/src/lib/state-store-sweeper.ts +4 -0
- package/src/lib/supervisor-markers.ts +18 -0
- package/src/lib/terminal-safe-text.ts +58 -0
- package/src/lib/translator-budget.ts +3 -2
- package/src/lib/upstream-retry.ts +52 -9
- package/src/link/alias-lock.ts +119 -0
- package/src/link/child-activity.ts +28 -2
- package/src/link/child-binary-cache-fill.d.mts +50 -0
- package/src/link/child-binary-cache-fill.mjs +494 -0
- package/src/link/child-binary-cache-start.ts +73 -0
- package/src/link/child-binary-source.ts +12 -5
- package/src/link/child-gated-ocx.ts +29 -11
- package/src/link/child-observations.ts +2 -1
- package/src/link/child-observe.ts +2 -2
- package/src/link/child-ops-engine.ts +159 -91
- package/src/link/child-ops-host.ts +138 -0
- package/src/link/child-ops-runners.ts +319 -0
- package/src/link/child-ops-scheduler.ts +207 -0
- package/src/link/child-ops-types.ts +89 -0
- package/src/link/child-parity.ts +23 -4
- package/src/link/child-policy.ts +93 -0
- package/src/link/child-update-contract.ts +12 -3
- package/src/link/codex-settings.ts +1 -1
- package/src/link/compatibility.ts +18 -1
- package/src/link/diagnostics-read.ts +163 -0
- package/src/link/diagnostics.ts +20 -7
- package/src/link/explicit-route.ts +209 -0
- package/src/link/link-recover.ts +113 -0
- package/src/link/management-routes.ts +3 -1
- package/src/link/operation-recovery-slot.ts +44 -0
- package/src/link/operations-journal.ts +408 -0
- package/src/link/peer-report.ts +1 -1
- package/src/link/relay-auth.ts +14 -0
- package/src/link/remote-plant.ts +152 -14
- package/src/link/remote-platform.ts +21 -10
- package/src/link/remote-probe.ts +11 -3
- package/src/link/remote-windows.ts +124 -36
- package/src/link/request-compression.ts +30 -0
- package/src/link/residual-recovery.ts +66 -0
- package/src/link/retirement.ts +128 -0
- package/src/link/route-intent-watch.ts +41 -0
- package/src/link/route-intent.ts +209 -0
- package/src/link/route-proof.ts +82 -0
- package/src/link/route-rounds.ts +579 -0
- package/src/link/route-select.ts +95 -0
- package/src/link/route-trust.ts +96 -0
- package/src/link/ssh-argv.ts +172 -24
- package/src/link/ssh-capture-redact.ts +253 -0
- package/src/link/ssh-capture.ts +497 -0
- package/src/link/ssh-runner.ts +141 -14
- package/src/link/status-projection.ts +87 -0
- package/src/link/store.ts +54 -1
- package/src/link/supervisor.ts +543 -55
- package/src/link/sync-fanout-classify.ts +16 -0
- package/src/link/sync-then-restart.ts +65 -0
- package/src/link/tombstones.ts +209 -0
- package/src/link/traffic.ts +178 -0
- package/src/link/ws-activity-holds.ts +474 -0
- package/src/local-credentials/publication-fence.ts +20 -1
- package/src/messaging/budget.ts +23 -5
- package/src/messaging/mcp-queue-rpc.ts +1 -1
- package/src/messaging/mcp-queue-server.ts +16 -1
- package/src/messaging/mcp-resume-tools.ts +25 -0
- package/src/messaging/remote-enrollment.ts +3 -3
- package/src/messaging/remote-tunnels.ts +2 -2
- package/src/messaging/resume-permissions.ts +27 -0
- package/src/messaging/rpc.ts +50 -6
- package/src/oauth/anthropic-continuity.ts +23 -7
- package/src/oauth/anthropic-routing.ts +5 -2
- package/src/oauth/anthropic.ts +22 -2
- package/src/oauth/antigravity-risk.ts +126 -0
- package/src/oauth/claude-keychain-read.ts +78 -68
- package/src/oauth/generic-account-failover.ts +89 -18
- package/src/oauth/generic-session-affinity.ts +10 -3
- package/src/oauth/index.ts +24 -6
- package/src/oauth/local-token-detect.ts +8 -29
- package/src/oauth/login-cli-errors.ts +5 -1
- package/src/oauth/login-cli.ts +68 -19
- package/src/oauth/login-flow-state.ts +26 -3
- package/src/oauth/meta-muse.ts +1 -1
- package/src/oauth/pool-kernel.ts +3 -3
- package/src/oauth/store.ts +7 -0
- package/src/oauth/xai.ts +248 -14
- package/src/protocols/contract.ts +4 -0
- package/src/protocols/encoders/messages.ts +1 -0
- package/src/providers/alias-template.ts +48 -0
- package/src/providers/anthropic-billing-ownership.ts +2 -0
- package/src/providers/anthropic-billing-refusal.ts +27 -3
- package/src/providers/anthropic-output-caps.ts +46 -0
- package/src/providers/anthropic-reset-grant-ledger.ts +9 -3
- package/src/providers/antigravity-effort-families.ts +11 -3
- package/src/providers/antigravity-models.ts +32 -9
- package/src/providers/antigravity-wire-snapshot.ts +3 -2
- package/src/providers/api-key-pause.ts +3 -0
- package/src/providers/api-key-resolve.ts +49 -7
- package/src/providers/api-key-response-ownership.ts +2 -0
- package/src/providers/api-key-selection.ts +51 -9
- package/src/providers/api-keys.ts +6 -2
- package/src/providers/cache-affinity-identity.ts +73 -0
- package/src/providers/cache-affinity.ts +256 -0
- package/src/providers/default-aliases.ts +98 -20
- package/src/providers/google-vertex-model-discovery.ts +515 -0
- package/src/providers/key-failover.ts +123 -8
- package/src/providers/key-store.ts +3 -3
- package/src/providers/kiro-models.ts +3 -5
- package/src/providers/label.ts +31 -5
- package/src/providers/mistral-transport.ts +17 -4
- package/src/providers/model-rename-fields.ts +5 -0
- package/src/providers/muse-key-quota.ts +14 -6
- package/src/providers/new-model-policy-runtime.ts +17 -4
- package/src/providers/new-model-policy.ts +30 -4
- package/src/providers/passive-key-observation.ts +252 -0
- package/src/providers/quota/account-cache.ts +2 -1
- package/src/providers/quota/anthropic-cooldown-recovery-worker.ts +121 -0
- package/src/providers/quota/passive-key-limits.ts +272 -0
- package/src/providers/quota/passive-wire-model.ts +126 -0
- package/src/providers/quota/report-cache.ts +61 -2
- package/src/providers/quota/workbuddy.ts +6 -2
- package/src/providers/quota-key-accounts.ts +11 -6
- package/src/providers/quota-types.ts +18 -0
- package/src/providers/quota.ts +11 -12
- package/src/providers/registry/entries-core.ts +34 -16
- package/src/providers/registry/entries-extended.ts +32 -0
- package/src/providers/registry/model-seeds.ts +35 -0
- package/src/providers/resolved-model-policy.ts +7 -0
- package/src/providers/routed-config.ts +8 -3
- package/src/providers/workbuddy-credit-balance.ts +125 -16
- package/src/providers/xai-transport.ts +3 -0
- package/src/remote/features.ts +17 -0
- package/src/responses/anthropic-progress.ts +10 -4
- package/src/responses/citation-markers.ts +231 -0
- package/src/responses/effort-history.ts +732 -0
- package/src/responses/spill-store.ts +5 -1
- package/src/responses/state/replay-input.ts +50 -0
- package/src/responses/state/replay-owner.ts +24 -0
- package/src/responses/state/snapshot-codec.ts +9 -0
- package/src/responses/state/spill-queue.ts +1 -0
- package/src/responses/state.ts +42 -60
- package/src/router.ts +2 -2
- package/src/routing/history/integrity.ts +41 -4
- package/src/routing/home-route-capture.ts +123 -0
- package/src/routing/home-route-intent.ts +200 -0
- package/src/routing/route-intent-state.ts +178 -0
- package/src/routing/route-to-live-settings.ts +35 -0
- package/src/routing/route-to-local.ts +145 -0
- package/src/routing/route-to-status.ts +94 -0
- package/src/routing/route-to-sync-child.ts +32 -0
- package/src/server/adapter-resolve.ts +21 -1
- package/src/server/admitted-http-turn.ts +3 -0
- package/src/server/auth-cors.ts +111 -3
- package/src/server/bare-upstream-error.ts +220 -0
- package/src/server/chat-native.ts +14 -5
- package/src/server/claude-messages.ts +6 -4
- package/src/server/codex-model-list.ts +4 -2
- package/src/server/configured-credentials.ts +37 -5
- package/src/server/direct-local-http.ts +26 -3
- package/src/server/gui-desktop-authorization.ts +36 -0
- package/src/server/gui-pair-delivery.ts +6 -3
- package/src/server/gui-session.ts +10 -1
- package/src/server/inbound-body-admission.ts +17 -4
- package/src/server/index/link-listener.ts +196 -12
- package/src/server/index/link-management.ts +15 -1
- package/src/server/index/link-relay-sessions.ts +87 -8
- package/src/server/index/link-websocket-limits.ts +136 -0
- package/src/server/index/link-websocket.ts +692 -0
- package/src/server/index/optional-listeners.ts +97 -7
- package/src/server/index/route-intent-watch.ts +47 -0
- package/src/server/index/serve-contract.ts +86 -0
- package/src/server/index/serve-options.ts +36 -86
- package/src/server/index/startup-warnings.ts +8 -2
- package/src/server/index/websocket-handler.ts +26 -4
- package/src/server/index.ts +15 -4
- package/src/server/inference/client-encoder-delivery.ts +2 -0
- package/src/server/inspection-tee.ts +39 -2
- package/src/server/lifecycle.ts +2 -0
- package/src/server/link-turn.ts +149 -0
- package/src/server/management/advisor-routes.ts +10 -2
- package/src/server/management/agent-settings-routes.ts +50 -16
- package/src/server/management/anthropic-reset-grant-routes.ts +1 -1
- package/src/server/management/config-routes.ts +39 -3
- package/src/server/management/context.ts +9 -2
- package/src/server/management/desktop-authorization.ts +41 -0
- package/src/server/management/desktop-compatibility-routes.ts +9 -8
- package/src/server/management/desktop-compatibility-runtime-routes.ts +3 -2
- package/src/server/management/desktop-compatibility-settings-routes.ts +5 -3
- package/src/server/management/home-integration-decision.ts +89 -0
- package/src/server/management/integration-routes.ts +208 -81
- package/src/server/management/link-child-ops-routes.ts +145 -43
- package/src/server/management/link-child-preflight.ts +31 -0
- package/src/server/management/link-diagnostics-route.ts +29 -0
- package/src/server/management/link-enrollment.ts +199 -47
- package/src/server/management/link-operation.ts +609 -0
- package/src/server/management/link-recover-route.ts +103 -0
- package/src/server/management/link-route-edit.ts +192 -0
- package/src/server/management/link-route-request.ts +62 -0
- package/src/server/management/link-route-state.ts +83 -7
- package/src/server/management/link-routes.ts +553 -51
- package/src/server/management/link-traffic-status.ts +13 -0
- package/src/server/management/model-routes.ts +122 -36
- package/src/server/management/model-rows.ts +2 -1
- package/src/server/management/native-integration-routes.ts +176 -70
- package/src/server/management/oauth-account-routes.ts +58 -18
- package/src/server/management/protocol-routes.ts +7 -0
- package/src/server/management/provider-completion-test.ts +4 -4
- package/src/server/management/provider-overwrite-carry.ts +14 -0
- package/src/server/management/provider-routes.ts +68 -65
- package/src/server/management/provider-routing-quota.ts +45 -0
- package/src/server/management/route-registry.ts +22 -3
- package/src/server/management/route-to-routes.ts +257 -0
- package/src/server/management/static-catalog-probe.ts +33 -0
- package/src/server/management/system-restart.ts +4 -2
- package/src/server/management/usage-aggregate-cache.ts +101 -66
- package/src/server/management-api.ts +17 -3
- package/src/server/management-auth.ts +13 -1
- package/src/server/messages-native-preflight.ts +27 -4
- package/src/server/messages-native.ts +17 -5
- package/src/server/persistent-gui-session.ts +6 -3
- package/src/server/proxy-liveness.ts +87 -15
- package/src/server/relay-eager.ts +36 -12
- package/src/server/relay.ts +189 -117
- package/src/server/request-body-facts.ts +48 -0
- package/src/server/request-decompress.ts +65 -2
- package/src/server/request-log-account-rotation.ts +6 -0
- package/src/server/request-log-attempt-usage.ts +69 -0
- package/src/server/request-log-cache-affinity.ts +60 -0
- package/src/server/request-log-conversation.ts +45 -2
- package/src/server/request-log-terminal-status.ts +210 -24
- package/src/server/request-log.ts +76 -80
- package/src/server/reserve-capability-startup.ts +32 -0
- package/src/server/responses/adapter-continuation.ts +2 -1
- package/src/server/responses/adapter-delivery.ts +4 -0
- package/src/server/responses/adapter-dispatch.ts +36 -17
- package/src/server/responses/advisor-plan-slot.ts +33 -1
- package/src/server/responses/advisor-question.ts +21 -0
- package/src/server/responses/advisor-slot.ts +10 -3
- package/src/server/responses/antigravity-fault-rotation.ts +24 -0
- package/src/server/responses/antigravity-validation-refusal.ts +43 -6
- package/src/server/responses/bare-namespace-aliases.ts +18 -0
- package/src/server/responses/buffered-sse-json.ts +9 -3
- package/src/server/responses/code-mode-collab-surface.ts +11 -0
- package/src/server/responses/codex-tool-catalog.ts +156 -0
- package/src/server/responses/combo-required-tool-fulfillments.ts +4 -2
- package/src/server/responses/combo-selection-keepalive.ts +254 -0
- package/src/server/responses/combo-stream-preflight.ts +557 -54
- package/src/server/responses/compact.ts +32 -8
- package/src/server/responses/core-codex-account.ts +17 -3
- package/src/server/responses/core-combo-failure.ts +8 -0
- package/src/server/responses/core-combo.ts +55 -12
- package/src/server/responses/core-errors.ts +13 -7
- package/src/server/responses/core-lifetime.ts +3 -2
- package/src/server/responses/core-normalize.ts +3 -1
- package/src/server/responses/core-options.ts +14 -0
- package/src/server/responses/core.ts +23 -0
- package/src/server/responses/estimated-usage.ts +115 -0
- package/src/server/responses/fetch-helpers.ts +15 -10
- package/src/server/responses/jev-model-invoke.ts +7 -2
- package/src/server/responses/native-replay-guard.ts +57 -0
- package/src/server/responses/opengateway-completion-guard.ts +10 -4
- package/src/server/responses/outbound-request-body.ts +29 -0
- package/src/server/responses/passthrough-completion.ts +109 -9
- package/src/server/responses/passthrough-delivery.ts +77 -18
- package/src/server/responses/passthrough-dispatch.ts +77 -73
- package/src/server/responses/policy-fallback.ts +13 -1
- package/src/server/responses/request-prepare.ts +59 -11
- package/src/server/responses/request-transport.ts +10 -3
- package/src/server/responses/reset-replay.ts +46 -2
- package/src/server/responses/run-turn-execution.ts +2 -0
- package/src/server/responses/sidecar-execution.ts +19 -0
- package/src/server/responses/terminal-error-redaction.ts +222 -25
- package/src/server/responses/ws-upstream.ts +2 -2
- package/src/server/sse-payload-rewrite.ts +3 -2
- package/src/server/stop-service-route.ts +85 -0
- package/src/server/system-env-shell.ts +12 -1
- package/src/server/system-env.ts +5 -3
- package/src/server/windows-tcp-drop.ts +21 -4
- package/src/server/workflow-refusal.ts +8 -0
- package/src/server/ws-bridge.ts +191 -12
- package/src/service/cli-windows-stop.ts +189 -0
- package/src/service/cli.ts +41 -12
- package/src/service/desktop-supervision.d.mts +2 -0
- package/src/service/desktop-supervision.mjs +5 -0
- package/src/service/disconnected-client-restart.ts +60 -0
- package/src/service/guarded-manager-target.ts +18 -1
- package/src/service/health.ts +99 -6
- package/src/service/launchd.ts +84 -31
- package/src/service/orchestration.ts +418 -91
- package/src/service/repair.ts +223 -6
- package/src/service/restart-proxy-stop.ts +79 -0
- package/src/service/service-child-ownership.ts +6 -2
- package/src/service/windows-checked-stop-live.ts +467 -0
- package/src/service/windows-checked-stop.ts +435 -0
- package/src/service/windows-command-line-token.ts +23 -0
- package/src/service/windows-guarded-manager.ts +77 -34
- package/src/service/windows-ops.ts +38 -56
- package/src/service/windows-process-evidence.ts +292 -0
- package/src/service/windows-process-native.ts +262 -0
- package/src/service/windows-service-stop.ts +321 -0
- package/src/service/windows-stop-binding.ts +187 -0
- package/src/service/windows-stop-budget.ts +123 -0
- package/src/service/windows-stop-confirm.ts +158 -0
- package/src/service/windows-stop-deadline.ts +56 -0
- package/src/service.ts +2 -2
- package/src/stall-timeout.ts +11 -0
- package/src/types/config.ts +57 -110
- package/src/types/link.ts +20 -0
- package/src/types/multi-agent.ts +13 -0
- package/src/types/provider.ts +60 -2
- package/src/types/request.ts +23 -0
- package/src/types/routed-catalog-defaults.ts +17 -0
- package/src/types/routing-profile.ts +90 -0
- package/src/types.ts +4 -0
- package/src/update/guarded-runtime-ops.ts +5 -7
- package/src/update/index.ts +26 -11
- package/src/update/install-detection.mjs +3 -1
- package/src/update/job-pinned-start.ts +2 -0
- package/src/update/job-windows-restart.ts +19 -32
- package/src/update/job.ts +12 -5
- package/src/update/npm-install.d.mts +11 -0
- package/src/update/npm-install.mjs +44 -7
- package/src/update/orchestrated-entry.ts +1 -1
- package/src/update/orchestrated-node-driver.mjs +3 -2
- package/src/update/orchestrated-pnpm.d.mts +4 -0
- package/src/update/orchestrated-pnpm.mjs +50 -6
- package/src/update/orchestrated-session.d.mts +3 -1
- package/src/update/orchestrated-session.mjs +21 -6
- package/src/update/pnpm-global-install.d.mts +21 -3
- package/src/update/pnpm-global-install.mjs +322 -19
- package/src/update/pnpm-store-layout.mjs +46 -0
- package/src/update/sync-update-mutex.d.mts +3 -2
- package/src/update/sync-update-mutex.mjs +57 -8
- package/src/update/transactional-install.d.mts +3 -1
- package/src/update/transactional-install.mjs +545 -12
- package/src/update/windows-installer-marker.d.mts +1 -0
- package/src/update/windows-installer-marker.mjs +44 -0
- package/src/usage/expected-prices.ts +8 -0
- package/src/usage/filter-index.ts +326 -77
- package/src/usage/ledger-scanner.ts +15 -0
- package/src/usage/link-log-fields.ts +48 -0
- package/src/usage/log.ts +57 -6
- package/src/usage/request-body.ts +37 -0
- package/src/usage/telemetry-contract.ts +1 -0
- package/src/web-search/loop.ts +3 -0
- package/src/web-search/passthrough-bridge.ts +7 -0
- package/gui/dist/assets/App-BpJOzw4F.js +0 -59
- package/gui/dist/assets/brand-mark-DU-0Vdkr.js +0 -1
- package/gui/dist/assets/index-Bbor_y80.js +0 -94
- package/gui/dist/assets/index-DJEkIDAi.css +0 -2
- package/gui/dist/classic/assets/App-BrIlUiLc.js +0 -58
- package/gui/dist/classic/assets/index-DyJHagvT.js +0 -94
- package/gui/dist/classic/assets/quota-summary-CakPe9Ni.js +0 -1
- package/src/server/management/desktop-compatibility-authorization.ts +0 -12
|
@@ -0,0 +1,262 @@
|
|
|
1
|
+
/** Read-only Home fetches, followed by local materialization under the caller's sync fence. */
|
|
2
|
+
import type { ExportModel } from "../clients/config-export";
|
|
3
|
+
import { loadConfig } from "../config";
|
|
4
|
+
import { withClientLifecycleSync } from "../client/lifecycle-lock";
|
|
5
|
+
import { nativeOpenAiSlugs } from "../codex/catalog/metadata";
|
|
6
|
+
import { COMBO_NAMESPACE } from "../combos/identifiers";
|
|
7
|
+
import type { LocalRouteIntentOptions } from "../client/route-intent-apply";
|
|
8
|
+
import { clearHomeRouteIntentRecord, fetchHomeRouteIntent, homeRouteIntentReceipt, linkBoundFetch, readHomeRouteIntentRecord,
|
|
9
|
+
writeHomeRouteIntentRecord, type LinkHomeConnection, type LinkHomeDeps } from "../client/link-home";
|
|
10
|
+
import { readBoundedResponseBytes } from "../lib/bounded-body";
|
|
11
|
+
import { ROUTE_CLIENT_IDS, type HomeRouteIntentDocument } from "../link/route-intent";
|
|
12
|
+
import type { OcxClientConnectionConfig } from "../types";
|
|
13
|
+
import type { RouteIntentReceipt } from "./route-intent-contract";
|
|
14
|
+
import { clearRouteIntentUnappliedProof, effectiveRouteIntent, readLocalRouteIntentOff, readRouteIntentReceipt, readRouteIntentReceiptStrict,
|
|
15
|
+
writeRouteIntentReceipt } from "./route-intent-state";
|
|
16
|
+
import { resolveInitialRouteIntent, initialRouteOutcomeMetadata } from "./route-intent-initial";
|
|
17
|
+
import { LINK_ROUTE_CATALOG_PATH } from "../link/management-routes";
|
|
18
|
+
import { MAX_ROUTE_CATALOG_BYTES, parseRouteCatalogFacts } from "./route-intent-catalog";
|
|
19
|
+
import { canonicalizeReasoningEfforts, isDeclaredReasoningEffort } from "../reasoning-effort";
|
|
20
|
+
|
|
21
|
+
/** Modalities the exporters serialize; anything else a served row declares is dropped. */
|
|
22
|
+
const SERVED_INPUT_MODALITIES: ReadonlySet<string> = new Set(["text", "image", "video", "audio"]);
|
|
23
|
+
const MAX_SERVED_EFFORTS = 16;
|
|
24
|
+
|
|
25
|
+
/**
|
|
26
|
+
* The capability fields a Home's `/v1/models` row carries (see `modelCapabilityFields` in
|
|
27
|
+
* `src/server/models-capabilities.ts`), read strictly from the served document.
|
|
28
|
+
*
|
|
29
|
+
* The row is remote input, so every value is type- and range-checked here and a malformed
|
|
30
|
+
* field is dropped rather than forwarded: one bad modality or a non-numeric window would
|
|
31
|
+
* either empty a Pi config or make a client offer a control the Home cannot honour. Nothing
|
|
32
|
+
* is synthesized — a field the row omits stays absent, exactly as `toExportModel` projects
|
|
33
|
+
* the local `/api/models` rows.
|
|
34
|
+
*/
|
|
35
|
+
function servedCapabilities(row: object): Partial<ExportModel> {
|
|
36
|
+
const capabilities = "capabilities" in row && row.capabilities && typeof row.capabilities === "object"
|
|
37
|
+
&& !Array.isArray(row.capabilities) ? row.capabilities as Record<string, unknown> : {};
|
|
38
|
+
const top = row as Record<string, unknown>;
|
|
39
|
+
const limit = (value: unknown): number | undefined => typeof value === "number" && Number.isSafeInteger(value) && value > 0
|
|
40
|
+
? value : undefined;
|
|
41
|
+
const flag = (value: unknown): boolean | undefined => typeof value === "boolean" ? value : undefined;
|
|
42
|
+
const modalities = (value: unknown): string[] | undefined => {
|
|
43
|
+
if (!Array.isArray(value)) return undefined;
|
|
44
|
+
const kept: string[] = [];
|
|
45
|
+
for (const entry of value) {
|
|
46
|
+
if (typeof entry !== "string" || !SERVED_INPUT_MODALITIES.has(entry) || kept.includes(entry)) continue;
|
|
47
|
+
kept.push(entry);
|
|
48
|
+
}
|
|
49
|
+
return kept.length > 0 ? kept : undefined;
|
|
50
|
+
};
|
|
51
|
+
const efforts = (value: unknown): string[] | undefined => {
|
|
52
|
+
if (!Array.isArray(value)) return undefined;
|
|
53
|
+
const kept: string[] = [];
|
|
54
|
+
for (const entry of value) {
|
|
55
|
+
const effort = typeof entry === "string" ? entry
|
|
56
|
+
: entry && typeof entry === "object" && "value" in entry && typeof entry.value === "string" ? entry.value : undefined;
|
|
57
|
+
if (effort === undefined || !isDeclaredReasoningEffort(effort) || kept.includes(effort)) continue;
|
|
58
|
+
kept.push(effort);
|
|
59
|
+
if (kept.length >= MAX_SERVED_EFFORTS) break;
|
|
60
|
+
}
|
|
61
|
+
return kept.length > 0 ? canonicalizeReasoningEfforts(kept) : undefined;
|
|
62
|
+
};
|
|
63
|
+
const contextWindow = limit(top.context_window) ?? limit(top.context_length) ?? limit(capabilities.context_length);
|
|
64
|
+
const maxTokens = limit(top.max_output_tokens) ?? limit(capabilities.max_output_tokens);
|
|
65
|
+
const inputModalities = modalities(capabilities.input_modalities);
|
|
66
|
+
const reasoningEfforts = efforts(top.reasoning_efforts) ?? efforts(capabilities.reasoning_effort);
|
|
67
|
+
const supportsReasoning = flag(capabilities.supports_reasoning);
|
|
68
|
+
const supportsThinkingToggle = flag(capabilities.supports_thinking_toggle);
|
|
69
|
+
const supportsReasoningEffort = flag(capabilities.supports_reasoning_effort);
|
|
70
|
+
const defaultThinkingEnabled = flag(capabilities.default_thinking_enabled);
|
|
71
|
+
const declaredDefault = typeof top.reasoning_effort === "string" && isDeclaredReasoningEffort(top.reasoning_effort)
|
|
72
|
+
? top.reasoning_effort
|
|
73
|
+
: Array.isArray(top.reasoning_efforts)
|
|
74
|
+
? top.reasoning_efforts.find(option => option && typeof option === "object" && "default" in option && option.default === true
|
|
75
|
+
&& "value" in option && typeof option.value === "string")?.value
|
|
76
|
+
: undefined;
|
|
77
|
+
const defaultReasoningEffort = declaredDefault !== undefined && reasoningEfforts?.includes(declaredDefault) ? declaredDefault : undefined;
|
|
78
|
+
return {
|
|
79
|
+
...(contextWindow !== undefined ? { contextWindow } : {}),
|
|
80
|
+
...(maxTokens !== undefined ? { maxTokens } : {}),
|
|
81
|
+
...(inputModalities ? { inputModalities } : {}),
|
|
82
|
+
...(reasoningEfforts ? { reasoningEfforts } : {}),
|
|
83
|
+
...(supportsReasoning !== undefined ? { supportsReasoning } : {}),
|
|
84
|
+
...(supportsThinkingToggle !== undefined ? { supportsThinkingToggle } : {}),
|
|
85
|
+
...(supportsReasoningEffort !== undefined ? { supportsReasoningEffort } : {}),
|
|
86
|
+
...(defaultThinkingEnabled !== undefined ? { defaultThinkingEnabled } : {}),
|
|
87
|
+
...(defaultReasoningEffort !== undefined ? { defaultReasoningEffort } : {}),
|
|
88
|
+
};
|
|
89
|
+
}
|
|
90
|
+
|
|
91
|
+
export interface PreparedConnectedRouteIntent { document: HomeRouteIntentDocument; fetchedAt: string; stale: boolean; localOnly?: true }
|
|
92
|
+
|
|
93
|
+
/**
|
|
94
|
+
* The Home's `/v1/models` expands a listed combo into synthetic selectors the route catalog does
|
|
95
|
+
* not list: `<base>--fast` (src/server/fast-row.ts) and `<base>--<effort>` (src/server/effort-row.ts).
|
|
96
|
+
* Such a row routes to its base combo, so its identity is the base's when that base is verified.
|
|
97
|
+
* Returns the base public id the selector grammar names, or undefined when it is not one.
|
|
98
|
+
*/
|
|
99
|
+
function expandedComboBase(publicId: string): string | undefined {
|
|
100
|
+
const separator = publicId.lastIndexOf("--");
|
|
101
|
+
if (separator <= 0) return undefined;
|
|
102
|
+
const suffix = publicId.slice(separator + 2);
|
|
103
|
+
if (suffix !== "fast" && (suffix === "none" || !isDeclaredReasoningEffort(suffix))) return undefined;
|
|
104
|
+
return publicId.slice(0, separator);
|
|
105
|
+
}
|
|
106
|
+
|
|
107
|
+
/** Provisioning preview; connect records its enabled-only choices after enrollment. */
|
|
108
|
+
export function initialConnectRouteIntent(
|
|
109
|
+
prepared: PreparedConnectedRouteIntent | undefined, selected: OcxClientConnectionConfig["selectedClients"], explicit = false,
|
|
110
|
+
): PreparedConnectedRouteIntent | undefined {
|
|
111
|
+
if (!prepared || !explicit) return prepared;
|
|
112
|
+
const document = structuredClone(prepared.document);
|
|
113
|
+
for (const client of ROUTE_CLIENT_IDS) {
|
|
114
|
+
const enabled = selected.includes(client);
|
|
115
|
+
if (client === "codex" || client === "claude" || enabled) {
|
|
116
|
+
document.clients[client] = { ...document.clients[client], enabled };
|
|
117
|
+
document.sources[client] = "device";
|
|
118
|
+
}
|
|
119
|
+
}
|
|
120
|
+
return { ...prepared, document };
|
|
121
|
+
}
|
|
122
|
+
|
|
123
|
+
export async function prepareConnectedRouteIntent(
|
|
124
|
+
connection: LinkHomeConnection, token: string, deps?: LinkHomeDeps, beforeWrite?: () => void,
|
|
125
|
+
): Promise<PreparedConnectedRouteIntent | undefined> {
|
|
126
|
+
if (connection.transport !== "link" || !connection.link) return undefined;
|
|
127
|
+
const fetched = await fetchHomeRouteIntent(connection, token, deps);
|
|
128
|
+
if (fetched.kind === "fresh") return { document: resolveInitialRouteIntent(connection.link.linkId, fetched.document, beforeWrite), fetchedAt: new Date().toISOString(), stale: false };
|
|
129
|
+
const previous = fetched.kind === "failed" ? readHomeRouteIntentRecord(connection.link.linkId) : null;
|
|
130
|
+
return previous ? { document: resolveInitialRouteIntent(connection.link.linkId, previous.document, beforeWrite), fetchedAt: previous.fetchedAt, stale: true } : undefined;
|
|
131
|
+
}
|
|
132
|
+
|
|
133
|
+
export function connectedRouteSelectedClients(prepared: PreparedConnectedRouteIntent | undefined, fallback: OcxClientConnectionConfig["selectedClients"]) {
|
|
134
|
+
const off = new Set(readLocalRouteIntentOff());
|
|
135
|
+
return prepared ? effectiveRouteIntent(prepared.document).selectedClients : fallback.filter(id => !off.has(id));
|
|
136
|
+
}
|
|
137
|
+
|
|
138
|
+
/** Read the exact /v1/models rows this Child relays, preserving ids byte-for-byte. */
|
|
139
|
+
export async function loadConnectedRouteModels(connection: LinkHomeConnection, token: string, deps: LinkHomeDeps = {}): Promise<ExportModel[]> {
|
|
140
|
+
if (!connection.link) throw new Error("A Link connection is required for the local served roster");
|
|
141
|
+
const fetchImpl = deps.fetchImpl ?? linkBoundFetch(connection, token);
|
|
142
|
+
const response = await fetchImpl(`http://127.0.0.1:${connection.link.tunnelPort}/v1/models`, {
|
|
143
|
+
method: "GET", headers: { authorization: `Bearer ${token}` }, redirect: "manual", signal: AbortSignal.timeout(deps.timeoutMs ?? 10_000),
|
|
144
|
+
});
|
|
145
|
+
if (!response.ok) { await response.body?.cancel(); throw new Error("The Child served model roster is unavailable"); }
|
|
146
|
+
const body = await readBoundedResponseBytes(response, { maxBytes: 8 * 1024 * 1024, signal: AbortSignal.timeout(deps.timeoutMs ?? 10_000) });
|
|
147
|
+
if (body.oversized) throw new Error("The Child served model roster is too large");
|
|
148
|
+
const raw: unknown = JSON.parse(new TextDecoder("utf-8", { fatal: true }).decode(body.bytes));
|
|
149
|
+
if (!raw || typeof raw !== "object" || !("data" in raw) || !Array.isArray(raw.data)) throw new Error("Invalid Child served model roster");
|
|
150
|
+
const seen = new Set<string>();
|
|
151
|
+
const nativeIds = new Set(nativeOpenAiSlugs());
|
|
152
|
+
const comboIdentity = new Map<string, string>();
|
|
153
|
+
if (raw.data.some(row => row && typeof row === "object" && row.is_combo === true)) {
|
|
154
|
+
// is_combo describes the inbound adapter in owned_by. This separate passive projection
|
|
155
|
+
// contains only public selectors and canonical combo keys, never model discovery.
|
|
156
|
+
const response = await fetchImpl(`http://127.0.0.1:${connection.link.tunnelPort}${LINK_ROUTE_CATALOG_PATH}`, {
|
|
157
|
+
method: "GET", headers: { authorization: `Bearer ${token}` }, redirect: "manual", signal: AbortSignal.timeout(deps.timeoutMs ?? 10_000),
|
|
158
|
+
});
|
|
159
|
+
if (!response.ok) { await response.body?.cancel(); throw new Error("Combo route identity is unavailable"); }
|
|
160
|
+
const body = await readBoundedResponseBytes(response, { maxBytes: MAX_ROUTE_CATALOG_BYTES, signal: AbortSignal.timeout(deps.timeoutMs ?? 10_000) });
|
|
161
|
+
if (body.oversized) throw new Error("Combo metadata is too large");
|
|
162
|
+
const facts = parseRouteCatalogFacts(JSON.parse(new TextDecoder("utf-8", { fatal: true }).decode(body.bytes)));
|
|
163
|
+
if (!facts) throw new Error("Invalid combo route metadata");
|
|
164
|
+
for (const row of facts.combos) comboIdentity.set(row.publicId, row.comboId);
|
|
165
|
+
}
|
|
166
|
+
return raw.data.flatMap((row: unknown): ExportModel[] => {
|
|
167
|
+
if (!row || typeof row !== "object" || !("id" in row) || typeof row.id !== "string" || !row.id || seen.has(row.id)) {
|
|
168
|
+
throw new Error("Invalid or duplicate Child served model identifier");
|
|
169
|
+
}
|
|
170
|
+
seen.add(row.id);
|
|
171
|
+
const owner = "owned_by" in row ? row.owned_by : undefined;
|
|
172
|
+
if ("is_combo" in row && row.is_combo === true) {
|
|
173
|
+
const listed = comboIdentity.get(row.id);
|
|
174
|
+
const base = listed === undefined ? expandedComboBase(row.id) : undefined;
|
|
175
|
+
// An expanded selector whose base is not verified is left out on its own: it never fails
|
|
176
|
+
// the rest of the roster, and its id is never trusted.
|
|
177
|
+
if (base !== undefined && !comboIdentity.has(base)) return [];
|
|
178
|
+
const id = listed ?? (base === undefined ? undefined : comboIdentity.get(base));
|
|
179
|
+
if (!id) throw new Error("The served combo has no verified route identity");
|
|
180
|
+
return [{ namespaced: row.id, provider: COMBO_NAMESPACE, id, ...servedCapabilities(row) }];
|
|
181
|
+
}
|
|
182
|
+
const canonical = "native_id" in row ? row.native_id : row.id;
|
|
183
|
+
if (typeof canonical !== "string" || !canonical || canonical !== canonical.trim() || canonical.length > 4096 || /[\x00-\x1f\x7f]/.test(canonical)) {
|
|
184
|
+
throw new Error("Invalid canonical served model identity");
|
|
185
|
+
}
|
|
186
|
+
const slash = canonical.indexOf("/");
|
|
187
|
+
const native = slash < 0 && owner !== COMBO_NAMESPACE && (nativeIds.has(canonical) || owner === "openai");
|
|
188
|
+
if (slash < 0 && !native) throw new Error("The served alias has no verified canonical route identity");
|
|
189
|
+
if (!native && (slash === 0 || slash === canonical.length - 1)) throw new Error("Invalid canonical routed model identity");
|
|
190
|
+
return [{ namespaced: row.id, provider: native ? "openai" : canonical.slice(0, slash),
|
|
191
|
+
id: native ? canonical : canonical.slice(slash + 1), ...(native ? { native: true } : {}), ...servedCapabilities(row) }];
|
|
192
|
+
});
|
|
193
|
+
}
|
|
194
|
+
|
|
195
|
+
export async function applyConnectedRouteIntent(
|
|
196
|
+
connection: OcxClientConnectionConfig, token: string, prepared: PreparedConnectedRouteIntent | undefined,
|
|
197
|
+
options: LocalRouteIntentOptions, deps: LinkHomeDeps = {},
|
|
198
|
+
): Promise<RouteIntentReceipt | undefined> {
|
|
199
|
+
if (!connection.link) return undefined;
|
|
200
|
+
const localOff = readLocalRouteIntentOff(options.statePath);
|
|
201
|
+
if (!prepared && localOff.length > 0) {
|
|
202
|
+
const previous = readRouteIntentReceipt(options.statePath);
|
|
203
|
+
const document: HomeRouteIntentDocument = previous?.document ?? { version: 1, home: { name: "Home", version: "unavailable" },
|
|
204
|
+
clients: Object.fromEntries(ROUTE_CLIENT_IDS.map(id => [id, { enabled: connection.selectedClients.includes(id) }])) as HomeRouteIntentDocument["clients"],
|
|
205
|
+
sources: Object.fromEntries(ROUTE_CLIENT_IDS.map(id => [id, "builtin"])) as HomeRouteIntentDocument["sources"] };
|
|
206
|
+
prepared = { document, stale: true, fetchedAt: new Date().toISOString(), localOnly: true };
|
|
207
|
+
options = { ...options, onlyClients: localOff };
|
|
208
|
+
}
|
|
209
|
+
if (!prepared) return undefined;
|
|
210
|
+
const { materializeLocalRouteIntent } = await import("../client/route-intent-apply");
|
|
211
|
+
const intent = prepared;
|
|
212
|
+
const linkId = connection.link.linkId;
|
|
213
|
+
const guard = options.beforeWrite ?? (() => {});
|
|
214
|
+
const previousModels = readRouteIntentReceipt(options.statePath)?.models ?? [];
|
|
215
|
+
const local = loadConfig();
|
|
216
|
+
const config = { ...local, hostname: "127.0.0.1", unauthenticatedLoopbackListener: undefined };
|
|
217
|
+
const previousHomeRecord = readHomeRouteIntentRecord(linkId);
|
|
218
|
+
const { createIntegrationStateStore } = await import("./store");
|
|
219
|
+
const { captureFileIntentOriginals } = await import("../client/route-intent-file-originals");
|
|
220
|
+
const store = options.store ?? createIntegrationStateStore();
|
|
221
|
+
withClientLifecycleSync(() => {
|
|
222
|
+
guard();
|
|
223
|
+
// An apply begins here: from now on only a receipt can prove what this link left behind.
|
|
224
|
+
clearRouteIntentUnappliedProof(options.statePath);
|
|
225
|
+
// Write-ahead, before any client changes: which file integrations were standalone. Only a
|
|
226
|
+
// receipt read strictly proves a first apply; a corrupt one refuses here, before an owner the
|
|
227
|
+
// link created could be recorded as standalone and the receipt naming it replaced.
|
|
228
|
+
captureFileIntentOriginals(linkId, readRouteIntentReceiptStrict(options.statePath)?.linkId === undefined, store.readRecordsStrict());
|
|
229
|
+
// A failed materialization must not leave the separately reportable Home proof current.
|
|
230
|
+
clearHomeRouteIntentRecord();
|
|
231
|
+
}, options.lifecycleLockDeps);
|
|
232
|
+
const persist = (receipt: RouteIntentReceipt) => {
|
|
233
|
+
receipt.outcomes = receipt.outcomes.map(initialRouteOutcomeMetadata(linkId, intent.document));
|
|
234
|
+
withClientLifecycleSync(() => {
|
|
235
|
+
guard();
|
|
236
|
+
writeRouteIntentReceipt(receipt, options.statePath);
|
|
237
|
+
if (intent.localOnly) { clearHomeRouteIntentRecord(); return; }
|
|
238
|
+
const record = homeRouteIntentReceipt(linkId, intent.document, intent.fetchedAt, receipt.appliedAt, receipt.outcomes, previousHomeRecord);
|
|
239
|
+
try { writeHomeRouteIntentRecord(record); }
|
|
240
|
+
catch (error) { clearHomeRouteIntentRecord(); throw error; }
|
|
241
|
+
}, options.lifecycleLockDeps);
|
|
242
|
+
};
|
|
243
|
+
// Disable and opt-out need no catalog. Their proven outcomes survive an offline Home;
|
|
244
|
+
// every enabled client stays stale until its local served model roster is available.
|
|
245
|
+
const effective = effectiveRouteIntent(intent.document, options.statePath);
|
|
246
|
+
const off = ROUTE_CLIENT_IDS.filter(id => !effective.clients[id].enabled && (!options.onlyClients || options.onlyClients.includes(id)));
|
|
247
|
+
const receipt = await materializeLocalRouteIntent(config, intent.document, previousModels, { ...options, onlyClients: off });
|
|
248
|
+
persist(receipt);
|
|
249
|
+
if (intent.localOnly) { receipt.catalogPending = true; persist(receipt); return receipt; }
|
|
250
|
+
if (off.length === ROUTE_CLIENT_IDS.length) return receipt;
|
|
251
|
+
let models: ExportModel[];
|
|
252
|
+
try { models = await loadConnectedRouteModels(connection, token, deps); }
|
|
253
|
+
catch {
|
|
254
|
+
guard();
|
|
255
|
+
receipt.catalogPending = true;
|
|
256
|
+
persist(receipt);
|
|
257
|
+
return receipt;
|
|
258
|
+
}
|
|
259
|
+
const applied = await materializeLocalRouteIntent(config, intent.document, models, options);
|
|
260
|
+
persist(applied);
|
|
261
|
+
return applied;
|
|
262
|
+
}
|
|
@@ -0,0 +1,55 @@
|
|
|
1
|
+
import type { ExportModel } from "../clients/config-export";
|
|
2
|
+
import type { HomeRouteIntentDocument, RouteClientId, RouteClientIntent, RouteClientOutcome } from "../link/route-intent";
|
|
3
|
+
import type { OcxConfig } from "../types";
|
|
4
|
+
import type { IntegrationStateStore } from "./store";
|
|
5
|
+
|
|
6
|
+
export type { RouteClientOutcome } from "../link/route-intent";
|
|
7
|
+
|
|
8
|
+
export interface RouteIntentReceipt {
|
|
9
|
+
version: 1;
|
|
10
|
+
linkId?: string;
|
|
11
|
+
/** Last local served roster, retained for offline owned-conflict recovery. No credentials. */
|
|
12
|
+
models?: readonly ExportModel[];
|
|
13
|
+
document: HomeRouteIntentDocument;
|
|
14
|
+
clients: Record<RouteClientId, RouteClientIntent>;
|
|
15
|
+
sources: Record<RouteClientId, "builtin" | "default" | "device" | "native" | "local">;
|
|
16
|
+
selectedClients: RouteClientId[];
|
|
17
|
+
outcomes: RouteClientOutcome[];
|
|
18
|
+
/** Null if any client failed, conflicts, or is not installed. Never a partial success. */
|
|
19
|
+
appliedRouteIntentDigest: string | null;
|
|
20
|
+
appliedAt: string;
|
|
21
|
+
/** Off intents are proved, while enabled clients await the local served model roster. */
|
|
22
|
+
catalogPending?: true;
|
|
23
|
+
}
|
|
24
|
+
|
|
25
|
+
export interface RouteIntentApplyInput {
|
|
26
|
+
config: OcxConfig;
|
|
27
|
+
linkId?: string;
|
|
28
|
+
document: HomeRouteIntentDocument;
|
|
29
|
+
/** The local served roster, never Home-generated client contributions. */
|
|
30
|
+
models: readonly ExportModel[];
|
|
31
|
+
home?: string;
|
|
32
|
+
env?: NodeJS.ProcessEnv;
|
|
33
|
+
store?: IntegrationStateStore;
|
|
34
|
+
/** Isolates local opt-outs and receipts; defaults to the local config directory. */
|
|
35
|
+
statePath?: string;
|
|
36
|
+
/** Home passes an empty list; undefined reads this Child's persistent local opt-outs. */
|
|
37
|
+
localOff?: readonly RouteClientId[];
|
|
38
|
+
overwriteConflict?: boolean;
|
|
39
|
+
/** When a client toggle grants takeover, other clients retain ordinary conflict checks. */
|
|
40
|
+
overwriteClient?: RouteClientId;
|
|
41
|
+
/** Rechecks connection/runtime ownership immediately before each writer commits. */
|
|
42
|
+
beforeWrite?: () => void;
|
|
43
|
+
/** Reconcile only explicit local opt-outs when no Home document is available. */
|
|
44
|
+
onlyClients?: readonly RouteClientId[];
|
|
45
|
+
/** Clients skipped by onlyClients keep the previous receipt outcome for the same client intent. */
|
|
46
|
+
retainSkippedOutcomes?: boolean;
|
|
47
|
+
/** Explicit disconnect recovery only: snapshot an owned conflicting block, then remove it. */
|
|
48
|
+
recoverConflicts?: boolean;
|
|
49
|
+
/** Lifecycle exclusion around async file writers; native adapters manage their own lock order. */
|
|
50
|
+
withFileWrites?: <T>(work: () => Promise<T>) => Promise<T>;
|
|
51
|
+
withReceiptWrite?: (write: () => void) => void;
|
|
52
|
+
now?: () => Date;
|
|
53
|
+
/** Native adapters retain their existing ownership/journal implementations. */
|
|
54
|
+
applyNative?: (client: "codex" | "claude" | "claude-desktop" | "grok", intent: RouteClientIntent) => Promise<RouteClientOutcome>;
|
|
55
|
+
}
|
|
@@ -0,0 +1,109 @@
|
|
|
1
|
+
/** File clients drain before disconnect removes its connection and service credential. */
|
|
2
|
+
import { loadConfig } from "../config";
|
|
3
|
+
import { lstatSync } from "node:fs";
|
|
4
|
+
import { readClientConnectionState, sameClientConnectionOwner } from "../client/state";
|
|
5
|
+
import { withClientLifecycle, withClientLifecycleSync, type ClientLifecycleLockDeps } from "../client/lifecycle-lock";
|
|
6
|
+
import { readDesktopDisconnectReceipt, type DesktopDisconnectReceipt } from "../claude/desktop-remote-store";
|
|
7
|
+
import { readServiceApiTokenState } from "../lib/service-secrets";
|
|
8
|
+
import { readLocalRouteIntentOff, readRouteIntentReceiptStrict, readRouteIntentUnappliedProof } from "./route-intent-state";
|
|
9
|
+
import { homeRouteIntentPath } from "../client/link-home";
|
|
10
|
+
import type { OcxClientConnectionConfig } from "../types";
|
|
11
|
+
|
|
12
|
+
/** Droid's empty-roster contribution has no selectors, so its generic classifier cannot prove absence. */
|
|
13
|
+
async function droidRoutingAbsent(port: number): Promise<boolean> {
|
|
14
|
+
const { INTEGRATION_CLIENTS } = await import("./registry");
|
|
15
|
+
const { defaultIntegrationIO, loadTarget } = await import("./config-io");
|
|
16
|
+
const { createIntegrationStateStore } = await import("./store");
|
|
17
|
+
const target = loadTarget(defaultIntegrationIO(createIntegrationStateStore()), INTEGRATION_CLIENTS.droid.configPath());
|
|
18
|
+
if (!target.ok) return false;
|
|
19
|
+
if (target.before === null) return true;
|
|
20
|
+
try {
|
|
21
|
+
const value: unknown = JSON.parse(target.before);
|
|
22
|
+
if (!value || typeof value !== "object" || Array.isArray(value)) return false;
|
|
23
|
+
const rows = (value as Record<string, unknown>).customModels;
|
|
24
|
+
if (rows === undefined) return true;
|
|
25
|
+
if (!Array.isArray(rows)) return false;
|
|
26
|
+
return rows.every(row => {
|
|
27
|
+
if (!row || typeof row !== "object" || Array.isArray(row)) return false;
|
|
28
|
+
if (typeof row.displayName === "string" && row.displayName.startsWith("OpenCodex:")) return false;
|
|
29
|
+
if (typeof row.baseUrl !== "string") return false;
|
|
30
|
+
const url = new URL(row.baseUrl);
|
|
31
|
+
return !(["127.0.0.1", "localhost", "[::1]"].includes(url.hostname) && url.port === String(port));
|
|
32
|
+
});
|
|
33
|
+
} catch { return false; }
|
|
34
|
+
}
|
|
35
|
+
|
|
36
|
+
export async function cleanupConnectedRouteIntent(
|
|
37
|
+
connection: OcxClientConnectionConfig, expected: DesktopDisconnectReceipt, lifecycleLockDeps?: ClientLifecycleLockDeps, recoverConflicts = false,
|
|
38
|
+
): Promise<void> {
|
|
39
|
+
const receipt = readRouteIntentReceiptStrict();
|
|
40
|
+
if (!receipt) {
|
|
41
|
+
let homeReceiptPresent = false;
|
|
42
|
+
try { lstatSync(homeRouteIntentPath()); homeReceiptPresent = true; }
|
|
43
|
+
catch (error) { if ((error as NodeJS.ErrnoException).code !== "ENOENT") throw error; }
|
|
44
|
+
if (connection.link) {
|
|
45
|
+
const { createIntegrationStateStore } = await import("./store");
|
|
46
|
+
const { isIntegrationClientId } = await import("./registry");
|
|
47
|
+
const { readIntegrationState } = await import("./state");
|
|
48
|
+
const { listAsideProfileStores } = await import("./aside-profile-context");
|
|
49
|
+
const store = createIntegrationStateStore();
|
|
50
|
+
const records = store.readRecordsStrict();
|
|
51
|
+
// Connect proved, for this exact connection, that no route apply has begun (`--no-sync`, an
|
|
52
|
+
// older Home). An ownership record then predates the link: it is the person's standalone
|
|
53
|
+
// integration, which disconnect keeps. Unowned routing residue still refuses below.
|
|
54
|
+
const proof = readRouteIntentUnappliedProof();
|
|
55
|
+
const neverApplied = !homeReceiptPresent && proof?.linkId === connection.link.linkId && proof.connectedAt === connection.connectedAt;
|
|
56
|
+
const owned = !neverApplied && (Object.keys(records).length > 0
|
|
57
|
+
|| listAsideProfileStores(store).some(child => Object.keys(child.store.readRecordsStrict()).length > 0));
|
|
58
|
+
const standalone = (id: string) => neverApplied && records[id as keyof typeof records] !== undefined;
|
|
59
|
+
const config = loadConfig();
|
|
60
|
+
// Older Homes and --no-sync may never invoke the controller. Only disk absence,
|
|
61
|
+
// not selectedClients alone, proves those file clients have nothing to drain.
|
|
62
|
+
const unproved = connection.selectedClients.some(id => id !== "codex" && id !== "claude" && !standalone(id)
|
|
63
|
+
&& (!isIntegrationClientId(id) || readIntegrationState({ clientId: id, config, port: config.port, models: [], store }).state !== "absent"));
|
|
64
|
+
const droidUnproved = connection.selectedClients.includes("droid") && !standalone("droid") && !await droidRoutingAbsent(config.port);
|
|
65
|
+
if (homeReceiptPresent || owned || unproved || droidUnproved) {
|
|
66
|
+
throw new Error("Route intent cleanup receipt is missing; preserve the connection and repair its route ownership evidence before disconnect");
|
|
67
|
+
}
|
|
68
|
+
}
|
|
69
|
+
return;
|
|
70
|
+
}
|
|
71
|
+
// A valid unbound receipt is standalone Home state, not evidence of a Child apply.
|
|
72
|
+
if (receipt.linkId === undefined) return;
|
|
73
|
+
if (!connection.link || receipt.linkId !== connection.link.linkId) throw new Error("Route intent cleanup receipt belongs to another context; preserve it before disconnect");
|
|
74
|
+
const guard = () => {
|
|
75
|
+
const pending = readDesktopDisconnectReceipt();
|
|
76
|
+
const current = readClientConnectionState();
|
|
77
|
+
const token = readServiceApiTokenState();
|
|
78
|
+
if (pending.kind !== "valid" || JSON.stringify(pending.value) !== JSON.stringify(expected)
|
|
79
|
+
|| current.kind !== "connected" || !sameClientConnectionOwner(current.value, connection)
|
|
80
|
+
|| current.value.pendingOperation || token.kind !== "present" || token.fingerprint !== connection.tokenFingerprint) {
|
|
81
|
+
throw new Error("client_disconnect_owner_changed");
|
|
82
|
+
}
|
|
83
|
+
};
|
|
84
|
+
const local = loadConfig();
|
|
85
|
+
const { cleanupRouteIntent } = await import("./route-intent");
|
|
86
|
+
const { stripGrokConfig } = await import("../grok/inject");
|
|
87
|
+
const { injectClaudeAgentDefs } = await import("../claude/agents-inject");
|
|
88
|
+
const config = { ...local, hostname: "127.0.0.1", unauthenticatedLoopbackListener: undefined };
|
|
89
|
+
// Integrations the Child owned before this link come back instead of being removed; a local
|
|
90
|
+
// opt-out is the person's own later choice and wins.
|
|
91
|
+
const { readFileIntentOriginals } = await import("../client/route-intent-file-originals");
|
|
92
|
+
const originals = readFileIntentOriginals();
|
|
93
|
+
const optedOut = new Set<string>(readLocalRouteIntentOff());
|
|
94
|
+
const standalone = originals?.linkId === connection.link.linkId
|
|
95
|
+
? Object.fromEntries(Object.entries(originals.clients).filter(([client]) => !optedOut.has(client))) : {};
|
|
96
|
+
const outcomes = await cleanupRouteIntent({ config, linkId: connection.link.linkId, document: receipt.document, models: receipt.models ?? [], beforeWrite: guard, recoverConflicts,
|
|
97
|
+
withReceiptWrite: write => withClientLifecycleSync(() => { guard(); write(); }, lifecycleLockDeps),
|
|
98
|
+
withFileWrites: work => withClientLifecycle(work, lifecycleLockDeps) }, standalone);
|
|
99
|
+
if (outcomes.some(row => row.outcome !== "current")) throw new Error("Route intent cleanup was partial; ownership and disconnect receipts retained. Repair the conflicting client and rerun ocx disconnect.");
|
|
100
|
+
withClientLifecycleSync(() => {
|
|
101
|
+
guard();
|
|
102
|
+
const grok = stripGrokConfig();
|
|
103
|
+
if (!grok.ok) throw new Error("Grok route cleanup was partial; rerun ocx disconnect after repair");
|
|
104
|
+
const config = loadConfig();
|
|
105
|
+
const agents = injectClaudeAgentDefs({ ...config, claudeCode: { ...config.claudeCode, enabled: false } }, {});
|
|
106
|
+
if (agents === null) throw new Error("Claude route cleanup was partial; rerun ocx disconnect after repair");
|
|
107
|
+
guard();
|
|
108
|
+
}, lifecycleLockDeps);
|
|
109
|
+
}
|
|
@@ -0,0 +1,64 @@
|
|
|
1
|
+
/** Provisioning choices are local enabled-only overrides, never writes to Home policy. */
|
|
2
|
+
import { mkdirSync } from "node:fs";
|
|
3
|
+
import { join } from "node:path";
|
|
4
|
+
import { atomicWriteFileNoFollow } from "../config/atomic-write";
|
|
5
|
+
import { readBoundedRegularFileSync } from "../lib/bounded-file-read";
|
|
6
|
+
import { assertNotRealHomeUnderTest } from "../lib/test-home-guard";
|
|
7
|
+
import { isRouteClientId, ROUTE_CLIENT_IDS, type HomeRouteIntentDocument, type RouteClientId, type RouteClientOutcome } from "../link/route-intent";
|
|
8
|
+
import { routeIntentStatePath } from "./route-intent-state";
|
|
9
|
+
|
|
10
|
+
type InitialSelection = Partial<Record<RouteClientId, { enabled: boolean; revision: number }>>;
|
|
11
|
+
function recordPath(linkId: string, root: string): string {
|
|
12
|
+
if (!/^lnk_[0-9a-f]{16}$/.test(linkId)) throw new Error("Invalid initial route intent link identity");
|
|
13
|
+
return join(root, `initial-${linkId}.json`);
|
|
14
|
+
}
|
|
15
|
+
export function readInitialRouteIntent(linkId: string, root = routeIntentStatePath()): InitialSelection {
|
|
16
|
+
let raw: unknown;
|
|
17
|
+
try { raw = JSON.parse(readBoundedRegularFileSync(recordPath(linkId, root), 64 * 1024).toString("utf8")); }
|
|
18
|
+
catch (error) { if ((error as NodeJS.ErrnoException).code === "ENOENT") return {}; throw new Error("Initial route selection is unreadable"); }
|
|
19
|
+
if (!raw || typeof raw !== "object" || Array.isArray(raw) || !("version" in raw) || raw.version !== 1
|
|
20
|
+
|| !("linkId" in raw) || raw.linkId !== linkId || !("clients" in raw) || !raw.clients || typeof raw.clients !== "object" || Array.isArray(raw.clients)) {
|
|
21
|
+
throw new Error("Invalid initial route selection");
|
|
22
|
+
}
|
|
23
|
+
const clients: InitialSelection = {};
|
|
24
|
+
for (const [id, entry] of Object.entries(raw.clients)) {
|
|
25
|
+
if (!isRouteClientId(id) || !entry || typeof entry !== "object" || Array.isArray(entry)
|
|
26
|
+
|| Object.keys(entry).sort().join(",") !== "enabled,revision" || !("enabled" in entry) || typeof entry.enabled !== "boolean"
|
|
27
|
+
|| !("revision" in entry) || !Number.isSafeInteger(entry.revision) || Number(entry.revision) < 0) throw new Error("Invalid initial route selection client");
|
|
28
|
+
clients[id] = { enabled: entry.enabled, revision: Number(entry.revision) };
|
|
29
|
+
}
|
|
30
|
+
return clients;
|
|
31
|
+
}
|
|
32
|
+
function writeInitial(linkId: string, clients: InitialSelection, root: string): void {
|
|
33
|
+
assertNotRealHomeUnderTest(root); mkdirSync(root, { recursive: true, mode: 0o700 });
|
|
34
|
+
atomicWriteFileNoFollow(recordPath(linkId, root), JSON.stringify({ version: 1, linkId, clients }));
|
|
35
|
+
}
|
|
36
|
+
export function recordInitialRouteIntent(linkId: string, document: HomeRouteIntentDocument | undefined, selected: readonly RouteClientId[], root = routeIntentStatePath()): void {
|
|
37
|
+
const clients: InitialSelection = {};
|
|
38
|
+
for (const id of ROUTE_CLIENT_IDS) if (id === "codex" || id === "claude" || selected.includes(id)) {
|
|
39
|
+
clients[id] = { enabled: selected.includes(id), revision: document?.clientRevisions?.[id] ?? 0 };
|
|
40
|
+
}
|
|
41
|
+
writeInitial(linkId, clients, root);
|
|
42
|
+
}
|
|
43
|
+
export function resolveInitialRouteIntent(linkId: string, document: HomeRouteIntentDocument, beforeWrite: () => void = () => {}, root = routeIntentStatePath()): HomeRouteIntentDocument {
|
|
44
|
+
const clients = readInitialRouteIntent(linkId, root);
|
|
45
|
+
const next = structuredClone(document);
|
|
46
|
+
let removed = false;
|
|
47
|
+
for (const id of ROUTE_CLIENT_IDS) {
|
|
48
|
+
const initial = clients[id]; if (!initial) continue;
|
|
49
|
+
if ((document.clientRevisions?.[id] ?? 0) !== initial.revision) { delete clients[id]; removed = true; continue; }
|
|
50
|
+
next.clients[id] = { ...next.clients[id], enabled: initial.enabled };
|
|
51
|
+
next.sources[id] = "device";
|
|
52
|
+
}
|
|
53
|
+
if (removed) { beforeWrite(); writeInitial(linkId, clients, root); }
|
|
54
|
+
return next;
|
|
55
|
+
}
|
|
56
|
+
export function initialRouteOutcomeMetadata(linkId: string, document: HomeRouteIntentDocument, root = routeIntentStatePath()) {
|
|
57
|
+
const initial = readInitialRouteIntent(linkId, root);
|
|
58
|
+
return (row: RouteClientOutcome): RouteClientOutcome => {
|
|
59
|
+
const entry = initial[row.client];
|
|
60
|
+
return entry && entry.revision === (document.clientRevisions?.[row.client] ?? 0)
|
|
61
|
+
? { ...row, initialIntent: { enabled: entry.enabled }, initialRevision: entry.revision } : row;
|
|
62
|
+
};
|
|
63
|
+
}
|
|
64
|
+
export function clearInitialRouteIntent(linkId: string, root = routeIntentStatePath()): void { writeInitial(linkId, {}, root); }
|
|
@@ -0,0 +1,117 @@
|
|
|
1
|
+
import { mkdirSync, unlinkSync } from "node:fs";
|
|
2
|
+
import { join } from "node:path";
|
|
3
|
+
import { atomicWriteFileNoFollow } from "../config/atomic-write";
|
|
4
|
+
import { getConfigDir } from "../config/paths";
|
|
5
|
+
import { readBoundedRegularFileSync } from "../lib/bounded-file-read";
|
|
6
|
+
import { assertNotRealHomeUnderTest } from "../lib/test-home-guard";
|
|
7
|
+
import { ROUTE_CLIENT_IDS, isRouteClientId, parseHomeRouteIntentDocument, parseRouteClientIntent, type HomeRouteIntentDocument, type RouteClientId } from "../link/route-intent";
|
|
8
|
+
import type { RouteIntentReceipt } from "./route-intent-contract";
|
|
9
|
+
|
|
10
|
+
export function routeIntentStatePath(): string { return join(getConfigDir(), "route-intent"); }
|
|
11
|
+
|
|
12
|
+
function readJson(path: string, maxBytes = 16 * 1024 * 1024): unknown {
|
|
13
|
+
try { return JSON.parse(readBoundedRegularFileSync(path, maxBytes).toString("utf8")); }
|
|
14
|
+
catch (error) {
|
|
15
|
+
if ((error as NodeJS.ErrnoException).code === "ENOENT") return undefined;
|
|
16
|
+
throw new Error("Local route intent state is unreadable; preserve it for recovery");
|
|
17
|
+
}
|
|
18
|
+
}
|
|
19
|
+
|
|
20
|
+
export function readLocalRouteIntentOff(statePath = routeIntentStatePath()): RouteClientId[] {
|
|
21
|
+
const raw = readJson(join(statePath, "local-off.json"), 64 * 1024);
|
|
22
|
+
if (raw === undefined) return [];
|
|
23
|
+
if (!raw || typeof raw !== "object" || !("version" in raw) || raw.version !== 1 || !("clients" in raw)
|
|
24
|
+
|| !Array.isArray(raw.clients) || raw.clients.some(id => !ROUTE_CLIENT_IDS.includes(id))
|
|
25
|
+
|| new Set(raw.clients).size !== raw.clients.length) throw new Error("Invalid local route intent opt-outs");
|
|
26
|
+
return raw.clients;
|
|
27
|
+
}
|
|
28
|
+
|
|
29
|
+
export function effectiveRouteIntent(document: HomeRouteIntentDocument, statePath = routeIntentStatePath(), localOff?: readonly RouteClientId[]) {
|
|
30
|
+
const clients = structuredClone(document.clients);
|
|
31
|
+
const sources: RouteIntentReceipt["sources"] = { ...document.sources };
|
|
32
|
+
for (const id of localOff ?? readLocalRouteIntentOff(statePath)) {
|
|
33
|
+
clients[id] = { ...clients[id], enabled: false };
|
|
34
|
+
sources[id] = "local";
|
|
35
|
+
}
|
|
36
|
+
return { clients, sources, selectedClients: ROUTE_CLIENT_IDS.filter(id => clients[id].enabled) };
|
|
37
|
+
}
|
|
38
|
+
|
|
39
|
+
export function writeRouteIntentReceipt(receipt: RouteIntentReceipt, statePath = routeIntentStatePath()): void {
|
|
40
|
+
assertNotRealHomeUnderTest(statePath);
|
|
41
|
+
mkdirSync(statePath, { recursive: true, mode: 0o700 });
|
|
42
|
+
const body = JSON.stringify(receipt);
|
|
43
|
+
if (Buffer.byteLength(body) > 16 * 1024 * 1024) throw new Error("Local route intent receipt is too large");
|
|
44
|
+
atomicWriteFileNoFollow(join(statePath, "receipt.json"), body);
|
|
45
|
+
}
|
|
46
|
+
|
|
47
|
+
export function readRouteIntentReceipt(statePath = routeIntentStatePath()): RouteIntentReceipt | null {
|
|
48
|
+
try { return readRouteIntentReceiptStrict(statePath); } catch { return null; }
|
|
49
|
+
}
|
|
50
|
+
|
|
51
|
+
/** Cleanup must distinguish absence from corrupt, unsafe, or incomplete ownership evidence. */
|
|
52
|
+
export function readRouteIntentReceiptStrict(statePath = routeIntentStatePath()): RouteIntentReceipt | null {
|
|
53
|
+
const raw = readJson(join(statePath, "receipt.json")) as RouteIntentReceipt | undefined;
|
|
54
|
+
if (raw === undefined) return null;
|
|
55
|
+
if (!raw || raw.version !== 1 || !parseHomeRouteIntentDocument(raw.document, { allowNative: true }) || !Array.isArray(raw.outcomes)
|
|
56
|
+
|| raw.outcomes.length !== ROUTE_CLIENT_IDS.length || new Set(raw.outcomes.map(row => row?.client)).size !== ROUTE_CLIENT_IDS.length
|
|
57
|
+
|| !raw.clients || !raw.sources || !Array.isArray(raw.selectedClients) || new Set(raw.selectedClients).size !== raw.selectedClients.length
|
|
58
|
+
|| raw.selectedClients.some(id => !isRouteClientId(id)) || typeof raw.appliedAt !== "string" || !Number.isFinite(Date.parse(raw.appliedAt))
|
|
59
|
+
|| (raw.linkId !== undefined && !/^lnk_[0-9a-f]{16}$/.test(raw.linkId))
|
|
60
|
+
|| (raw.models !== undefined && (!Array.isArray(raw.models) || raw.models.some(row => !row || typeof row.namespaced !== "string" || typeof row.provider !== "string" || typeof row.id !== "string")))
|
|
61
|
+
|| !(raw.appliedRouteIntentDigest === null || (typeof raw.appliedRouteIntentDigest === "string" && /^[0-9a-f]{64}$/.test(raw.appliedRouteIntentDigest)))
|
|
62
|
+
|| raw.outcomes.some(row => !row || !isRouteClientId(row.client) || !["current", "stale", "not_installed", "conflict", "failed"].includes(row.outcome))
|
|
63
|
+
|| ROUTE_CLIENT_IDS.some(id => !parseRouteClientIntent(raw.clients[id], id) || !["builtin", "default", "device", "native", "local"].includes(raw.sources[id])
|
|
64
|
+
|| raw.selectedClients.includes(id) !== raw.clients[id].enabled)) throw new Error("Route intent receipt is malformed; preserve it and repair before disconnect");
|
|
65
|
+
return raw;
|
|
66
|
+
}
|
|
67
|
+
|
|
68
|
+
export function clearRouteIntentReceipt(statePath = routeIntentStatePath()): void {
|
|
69
|
+
assertNotRealHomeUnderTest(statePath);
|
|
70
|
+
try { unlinkSync(join(statePath, "receipt.json")); }
|
|
71
|
+
catch (error) { if ((error as NodeJS.ErrnoException).code !== "ENOENT") throw error; }
|
|
72
|
+
}
|
|
73
|
+
|
|
74
|
+
/**
|
|
75
|
+
* Link-bound proof that no route apply has begun for one committed Link connection. Connect writes
|
|
76
|
+
* it with the connection; the first route apply removes it before changing any client. Disconnect
|
|
77
|
+
* reads a matching proof as evidence that a missing receipt was never written, so a `--no-sync`
|
|
78
|
+
* enrollment over standalone integrations can still disconnect. Anything unreadable is no proof.
|
|
79
|
+
*/
|
|
80
|
+
export interface RouteIntentUnappliedProof { version: 1; linkId: string; connectedAt: string }
|
|
81
|
+
const UNAPPLIED_PROOF = "unapplied.json";
|
|
82
|
+
|
|
83
|
+
export function writeRouteIntentUnappliedProof(linkId: string, connectedAt: string, statePath = routeIntentStatePath()): void {
|
|
84
|
+
if (!/^lnk_[0-9a-f]{16}$/.test(linkId) || !Number.isFinite(Date.parse(connectedAt))) throw new Error("Invalid route intent apply proof");
|
|
85
|
+
assertNotRealHomeUnderTest(statePath);
|
|
86
|
+
mkdirSync(statePath, { recursive: true, mode: 0o700 });
|
|
87
|
+
atomicWriteFileNoFollow(join(statePath, UNAPPLIED_PROOF), JSON.stringify({ version: 1, linkId, connectedAt } satisfies RouteIntentUnappliedProof));
|
|
88
|
+
}
|
|
89
|
+
|
|
90
|
+
export function readRouteIntentUnappliedProof(statePath = routeIntentStatePath()): RouteIntentUnappliedProof | null {
|
|
91
|
+
let raw: unknown;
|
|
92
|
+
try { raw = readJson(join(statePath, UNAPPLIED_PROOF), 4 * 1024); } catch { return null; }
|
|
93
|
+
if (!raw || typeof raw !== "object" || Array.isArray(raw) || Object.keys(raw).sort().join(",") !== "connectedAt,linkId,version") return null;
|
|
94
|
+
const value = raw as Record<string, unknown>;
|
|
95
|
+
return value.version === 1 && typeof value.linkId === "string" && /^lnk_[0-9a-f]{16}$/.test(value.linkId)
|
|
96
|
+
&& typeof value.connectedAt === "string" ? { version: 1, linkId: value.linkId, connectedAt: value.connectedAt } : null;
|
|
97
|
+
}
|
|
98
|
+
|
|
99
|
+
export function clearRouteIntentUnappliedProof(statePath = routeIntentStatePath()): void {
|
|
100
|
+
assertNotRealHomeUnderTest(statePath);
|
|
101
|
+
try { unlinkSync(join(statePath, UNAPPLIED_PROOF)); }
|
|
102
|
+
catch (error) { if ((error as NodeJS.ErrnoException).code !== "ENOENT") throw error; }
|
|
103
|
+
}
|
|
104
|
+
|
|
105
|
+
/** true opts out; false drops the override and inherits the Home again. Never enables locally. */
|
|
106
|
+
export function setLocalRouteIntentOff(client: RouteClientId, off: boolean, statePath = routeIntentStatePath()): void {
|
|
107
|
+
if (!ROUTE_CLIENT_IDS.includes(client) || typeof off !== "boolean") throw new Error("Invalid local route intent override");
|
|
108
|
+
const clients = new Set(readLocalRouteIntentOff(statePath));
|
|
109
|
+
if (off) clients.add(client); else clients.delete(client);
|
|
110
|
+
assertNotRealHomeUnderTest(statePath);
|
|
111
|
+
mkdirSync(statePath, { recursive: true, mode: 0o700 });
|
|
112
|
+
// Invalidate before publishing the override: failure cannot leave an old success claim.
|
|
113
|
+
const receipt = readRouteIntentReceiptStrict(statePath);
|
|
114
|
+
if (receipt) writeRouteIntentReceipt({ ...receipt, appliedRouteIntentDigest: null,
|
|
115
|
+
outcomes: receipt.outcomes.map(row => row.client === client ? { ...row, outcome: "stale" } : row) }, statePath);
|
|
116
|
+
atomicWriteFileNoFollow(join(statePath, "local-off.json"), JSON.stringify({ version: 1, clients: [...clients].sort() }));
|
|
117
|
+
}
|