@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,586 @@
|
|
|
1
|
+
import type { Server, ServerWebSocket, WebSocketHandler } from "bun";
|
|
2
|
+
import type { Socket } from "node:net";
|
|
3
|
+
import type { LinkDiagnosticRecord, LinkDiagnosticSink } from "../link/diagnostics";
|
|
4
|
+
import { childLinkTraffic, type LinkTrafficBook, type LinkTrafficFlow } from "../link/traffic";
|
|
5
|
+
import { upgradeRequiredResponse } from "./link-ingress";
|
|
6
|
+
import { forwardLinkUpgradeHeaders, type LinkAdmissionResult, type LinkTunnelGate } from "./link-relay";
|
|
7
|
+
import { CODEX_WS_MAX_MESSAGE_HEADER, LINK_CHILD_WS_LIMITS, linkWebsocketChildReady, type LinkChildWebsocketLimits } from "./link-websocket-limits";
|
|
8
|
+
import { linkWebsocketAdvertisement } from "./link-ws-advertisement";
|
|
9
|
+
import { encodeClientClose, encodeClientPong, encodeClientText, isWireCloseCode, LinkWsFrameReader, LinkWsProtocolError, type LinkWsFrameEvent } from "./link-ws-framer";
|
|
10
|
+
import { openLinkWebsocket, type LinkWebsocketSetupFailure } from "./link-ws-transport";
|
|
11
|
+
|
|
12
|
+
/**
|
|
13
|
+
* The Responses WebSocket over a Remote Link, Child side (design T4 3.2 and 3.3).
|
|
14
|
+
*
|
|
15
|
+
* Codex's upgrade on the Child's listener is tried only when this build's release gate is open, the Child has
|
|
16
|
+
* not opted out, and the last relay answer this Child applied for the link did not say off (an answer it has
|
|
17
|
+
* not had yet since it started counts as a try: the upgrade's own preflight decides); otherwise the ingress
|
|
18
|
+
* keeps today's 426 and nothing touches the network. A tried upgrade passes, in order: no Origin; the link key;
|
|
19
|
+
* the local caps and memory reservation; the tunnel gate (a connecting or reconnecting tunnel is held up
|
|
20
|
+
* to 3 s, then 503, the only transient answer); one preflight and the upgrade on one authenticated
|
|
21
|
+
* connection (link-ws-transport.ts); all inside an 8 s budget. Every other failure is today's 426, which
|
|
22
|
+
* makes Codex use HTTP for that session.
|
|
23
|
+
*
|
|
24
|
+
* After the upgrade the Child relays whole text messages both ways without parsing or writing any of its
|
|
25
|
+
* own: a binary message from Codex closes both legs with 1003; close codes are relayed (toward Codex 1005,
|
|
26
|
+
* 1006 and 1015 become 1011; toward the Home, Codex's drop ends the connection without a close frame and a
|
|
27
|
+
* close without a status becomes an empty close frame); pings stay per hop. A second message from Codex while
|
|
28
|
+
* the previous one is still unflushed toward the Home closes both legs (1013 to Codex, 1001 to the Home), and
|
|
29
|
+
* the Home leg is paused while more than 1 MiB waits toward Codex. No timer closes a socket Codex has open;
|
|
30
|
+
* the only timers are the 5 s close bound and the same bound for a socket Bun upgraded but never opened. A
|
|
31
|
+
* runtime stop closes every socket with 1001 on both legs. When the tunnel supervisor starts stopping (a Child
|
|
32
|
+
* restart, or a link that ended and is about to be recycled), the relay drains first:
|
|
33
|
+
* open sockets close with 1001 and every upgrade from then on, new or still in setup, gets the transient 503,
|
|
34
|
+
* so Codex keeps its WebSocket session for the replacement, within its retry budget, instead of falling back to HTTP.
|
|
35
|
+
*/
|
|
36
|
+
|
|
37
|
+
export type LinkWsFallbackReason =
|
|
38
|
+
| "local_optout" | "origin" | "credential" | "cap" | "memory" | "tunnel_failed" | "tunnel_connecting_timeout"
|
|
39
|
+
| "preflight" | "not_advertised" | "home_refused" | "handshake" | "timeout" | "aborted" | "draining";
|
|
40
|
+
|
|
41
|
+
export type LinkWsCloseReason = "client" | "home" | "home_dropped" | "binary" | "protocol" | "overload" | "stopped";
|
|
42
|
+
|
|
43
|
+
export interface LinkWebsocketTimers {
|
|
44
|
+
setTimeout(callback: () => void, ms: number): unknown;
|
|
45
|
+
clearTimeout(handle: unknown): void;
|
|
46
|
+
}
|
|
47
|
+
|
|
48
|
+
/** What the relay needs from the listener's link ingress. */
|
|
49
|
+
export interface LinkWebsocketTarget {
|
|
50
|
+
tunnelPort: number;
|
|
51
|
+
linkId?: string;
|
|
52
|
+
apiKeyId?: string;
|
|
53
|
+
linkKey: () => string | null;
|
|
54
|
+
}
|
|
55
|
+
|
|
56
|
+
export interface LinkWebsocketRelayDeps {
|
|
57
|
+
tunnel?: LinkTunnelGate;
|
|
58
|
+
diagnostic?: LinkDiagnosticSink;
|
|
59
|
+
traffic?: LinkTrafficBook;
|
|
60
|
+
limits?: Partial<LinkChildWebsocketLimits>;
|
|
61
|
+
timers?: LinkWebsocketTimers;
|
|
62
|
+
/** Test seam for the Home leg's setup. */
|
|
63
|
+
open?: typeof openLinkWebsocket;
|
|
64
|
+
/** The Child's release gate; linkWebsocketChildReady by default. */
|
|
65
|
+
ready?: () => boolean;
|
|
66
|
+
/**
|
|
67
|
+
* Whether the Home's advertisement lets an upgrade try the Home at all: by default true for a cached "on" and for
|
|
68
|
+
* "unknown" (no answer applied for this link since this process started), false for a cached "off".
|
|
69
|
+
*/
|
|
70
|
+
advertised?: (linkId: string | undefined) => boolean;
|
|
71
|
+
/** The Child-local opt-out (D4): true keeps this Child on HTTP whatever its Home advertises. */
|
|
72
|
+
optOut?: () => boolean;
|
|
73
|
+
/** Test seam: told when a socket stops (true) or resumes (false) reading the Home leg. */
|
|
74
|
+
onDownlinkPause?: (paused: boolean) => void;
|
|
75
|
+
/** Test seam: told when a socket's slot and reservation are released (its Home connection closed). */
|
|
76
|
+
onReleased?: () => void;
|
|
77
|
+
}
|
|
78
|
+
|
|
79
|
+
export interface LinkWebsocketData { leg: HomeLeg }
|
|
80
|
+
|
|
81
|
+
/**
|
|
82
|
+
* Design 9.3, Child side: display-only, in memory, reset at restart; reasons are closed sets. A non-local
|
|
83
|
+
* `Origin` is refused (403) by the ingress before the relay and is not counted here.
|
|
84
|
+
*/
|
|
85
|
+
export interface LinkWebsocketCounters {
|
|
86
|
+
open: number;
|
|
87
|
+
settingUp: number;
|
|
88
|
+
upgrades: number;
|
|
89
|
+
fallbacks: Partial<Record<LinkWsFallbackReason, number>>;
|
|
90
|
+
closes: Partial<Record<LinkWsCloseReason, number>>;
|
|
91
|
+
/**
|
|
92
|
+
* Text message payload bytes Codex sent on link sockets (L2), counted on arrival while the Home leg is
|
|
93
|
+
* open, forwarded or not; a binary message, and anything after the Home leg began closing, is not counted.
|
|
94
|
+
*/
|
|
95
|
+
fromCodexBytes: number;
|
|
96
|
+
/** Message payload bytes sent to Codex on link sockets. */
|
|
97
|
+
toCodexBytes: number;
|
|
98
|
+
}
|
|
99
|
+
|
|
100
|
+
const defaultTimers: LinkWebsocketTimers = {
|
|
101
|
+
setTimeout(callback, ms) {
|
|
102
|
+
const handle = setTimeout(callback, ms);
|
|
103
|
+
(handle as { unref?: () => void }).unref?.();
|
|
104
|
+
return handle;
|
|
105
|
+
},
|
|
106
|
+
clearTimeout(handle) { clearTimeout(handle as ReturnType<typeof setTimeout>); },
|
|
107
|
+
};
|
|
108
|
+
|
|
109
|
+
/** The one transient answer (design 3.2, D2): never a code Codex treats as terminal. */
|
|
110
|
+
function tunnelReconnecting(): Response {
|
|
111
|
+
return Response.json({ error: { type: "server_error", code: "link_websocket_unavailable", message: "The link to the Home is reconnecting; retry." } },
|
|
112
|
+
{ status: 503, headers: { "cache-control": "no-store" } });
|
|
113
|
+
}
|
|
114
|
+
|
|
115
|
+
/** A close code relayed to the other leg: 1005, 1006, 1015 and anything that may not appear on the wire become 1011. */
|
|
116
|
+
function relayCloseCode(code: number | null): number {
|
|
117
|
+
return code !== null && isWireCloseCode(code) ? code : 1011;
|
|
118
|
+
}
|
|
119
|
+
|
|
120
|
+
const FAILURE_REASON: Record<LinkWebsocketSetupFailure, LinkWsFallbackReason> = {
|
|
121
|
+
disabled: "not_advertised", credential: "credential", preflight: "preflight", not_advertised: "not_advertised", home_refused: "home_refused",
|
|
122
|
+
handshake: "handshake", timeout: "timeout", aborted: "aborted",
|
|
123
|
+
};
|
|
124
|
+
|
|
125
|
+
/**
|
|
126
|
+
* One Codex socket and its Home leg. The leg is created paused; it starts reading once Bun has opened the
|
|
127
|
+
* local socket, and the bytes the Home sent with its 101 are read first. A close decided before Bun opened
|
|
128
|
+
* the local socket is kept and applied when it opens. The leg's reservation is released only once the Home
|
|
129
|
+
* connection has actually closed (`onReleased`), so a closing socket still counts against the caps.
|
|
130
|
+
*
|
|
131
|
+
* A socket counts (one request in the traffic book, a close reason) only once Codex's socket is open: from
|
|
132
|
+
* `attach` (Bun 1.4 runs `open` inside `server.upgrade`) or `upgraded`, whichever comes first; a local
|
|
133
|
+
* upgrade that failed ends through `abandon` and counts nothing. If Bun upgraded the socket but never opens
|
|
134
|
+
* it, the leg stops after the close bound, so it cannot hold its slot.
|
|
135
|
+
*/
|
|
136
|
+
export class HomeLeg {
|
|
137
|
+
private readonly reader: LinkWsFrameReader;
|
|
138
|
+
private local: Pick<ServerWebSocket<LinkWebsocketData>, "send" | "close" | "getBufferedAmount"> | null = null;
|
|
139
|
+
private flow: LinkTrafficFlow | null = null;
|
|
140
|
+
private opened = false;
|
|
141
|
+
private attachTimer: unknown;
|
|
142
|
+
private paused = false;
|
|
143
|
+
private homeClosed = false;
|
|
144
|
+
private localClosed = false;
|
|
145
|
+
private pendingLocalClose: { code: number; reason: string } | null = null;
|
|
146
|
+
private closeTimer: unknown;
|
|
147
|
+
private ended = false;
|
|
148
|
+
private released = false;
|
|
149
|
+
|
|
150
|
+
constructor(
|
|
151
|
+
private readonly socket: Socket,
|
|
152
|
+
private readonly head: Buffer,
|
|
153
|
+
private readonly limits: LinkChildWebsocketLimits,
|
|
154
|
+
private readonly timers: LinkWebsocketTimers,
|
|
155
|
+
private readonly beginFlow: () => LinkTrafficFlow,
|
|
156
|
+
private readonly onEnd: (reason: LinkWsCloseReason) => void,
|
|
157
|
+
private readonly onReleased: () => void,
|
|
158
|
+
private readonly onPause?: (paused: boolean) => void,
|
|
159
|
+
private readonly onBytes?: (direction: "fromCodex" | "toCodex", bytes: number) => void,
|
|
160
|
+
) {
|
|
161
|
+
this.reader = new LinkWsFrameReader({ maxMessageBytes: limits.homeMessageBytes, maxFragments: limits.maxFragments });
|
|
162
|
+
socket.pause();
|
|
163
|
+
socket.on("data", chunk => this.fromHome(chunk as Buffer));
|
|
164
|
+
socket.on("error", () => { /* the close below ends the leg */ });
|
|
165
|
+
socket.on("close", () => this.homeGone());
|
|
166
|
+
// A connection that ended before this leg existed has already emitted its close.
|
|
167
|
+
if (socket.destroyed) queueMicrotask(() => this.homeGone());
|
|
168
|
+
this.attachTimer = timers.setTimeout(() => { this.attachTimer = undefined; if (!this.local) this.stop(); }, limits.closeHandshakeMs);
|
|
169
|
+
}
|
|
170
|
+
|
|
171
|
+
attach(local: Pick<ServerWebSocket<LinkWebsocketData>, "send" | "close" | "getBufferedAmount">): void {
|
|
172
|
+
this.clearAttachTimer();
|
|
173
|
+
this.markOpened();
|
|
174
|
+
this.local = local;
|
|
175
|
+
if (this.pendingLocalClose) {
|
|
176
|
+
const { code, reason } = this.pendingLocalClose;
|
|
177
|
+
this.pendingLocalClose = null;
|
|
178
|
+
try { local.close(code, reason); } catch { /* already closed */ }
|
|
179
|
+
return;
|
|
180
|
+
}
|
|
181
|
+
if (this.head.length) this.fromHome(this.head);
|
|
182
|
+
if (!this.ended && !this.paused) this.socket.resume();
|
|
183
|
+
}
|
|
184
|
+
|
|
185
|
+
/** Bun accepted the local upgrade: the socket is Codex's from here on. */
|
|
186
|
+
upgraded(): void {
|
|
187
|
+
this.markOpened();
|
|
188
|
+
}
|
|
189
|
+
|
|
190
|
+
/**
|
|
191
|
+
* The local upgrade failed (Bun refused or threw): close the Home leg and count nothing. If Bun had already
|
|
192
|
+
* opened Codex's socket before failing, the socket is Codex's: both legs close as on a stop, counted once.
|
|
193
|
+
*/
|
|
194
|
+
abandon(): void {
|
|
195
|
+
if (this.ended) return;
|
|
196
|
+
if (this.opened) {
|
|
197
|
+
this.stop();
|
|
198
|
+
return;
|
|
199
|
+
}
|
|
200
|
+
this.closeHome(1001, "");
|
|
201
|
+
this.finish("stopped");
|
|
202
|
+
}
|
|
203
|
+
|
|
204
|
+
private markOpened(): void {
|
|
205
|
+
if (this.opened || this.ended) return;
|
|
206
|
+
this.opened = true;
|
|
207
|
+
this.flow = this.beginFlow();
|
|
208
|
+
}
|
|
209
|
+
|
|
210
|
+
private clearAttachTimer(): void {
|
|
211
|
+
if (this.attachTimer === undefined) return;
|
|
212
|
+
this.timers.clearTimeout(this.attachTimer);
|
|
213
|
+
this.attachTimer = undefined;
|
|
214
|
+
}
|
|
215
|
+
|
|
216
|
+
private fromHome(chunk: Buffer): void {
|
|
217
|
+
if (this.ended || this.homeClosed) return;
|
|
218
|
+
// Events completed before a framing error in the same chunk are delivered first, in wire order.
|
|
219
|
+
const events: LinkWsFrameEvent[] = [];
|
|
220
|
+
let refused: unknown = null;
|
|
221
|
+
try {
|
|
222
|
+
this.reader.push(chunk, events);
|
|
223
|
+
} catch (error) {
|
|
224
|
+
refused = error;
|
|
225
|
+
}
|
|
226
|
+
for (const event of events) {
|
|
227
|
+
if (this.ended) return;
|
|
228
|
+
if (event.type === "text") {
|
|
229
|
+
this.flow?.fromHome(event.bytes);
|
|
230
|
+
const sent = this.local?.send(event.data) ?? 0;
|
|
231
|
+
if (sent === 0) { this.closeBoth(1013, "link websocket overloaded", 1001, "overload"); return; }
|
|
232
|
+
this.onBytes?.("toCodex", event.bytes);
|
|
233
|
+
if (!this.paused && (this.local?.getBufferedAmount() ?? 0) > this.limits.downlinkPauseBytes) {
|
|
234
|
+
this.paused = true;
|
|
235
|
+
this.socket.pause();
|
|
236
|
+
this.onPause?.(true);
|
|
237
|
+
}
|
|
238
|
+
} else if (event.type === "binary") {
|
|
239
|
+
this.closeBoth(1003, "binary messages are not relayed", 1003, "binary");
|
|
240
|
+
return;
|
|
241
|
+
} else if (event.type === "ping") {
|
|
242
|
+
this.socket.write(encodeClientPong(event.payload));
|
|
243
|
+
} else if (event.type === "close") {
|
|
244
|
+
// The Home closed: echo its close to finish the handshake, then relay it to Codex. The Home ends the
|
|
245
|
+
// connection; if it does not within the bound, the Child does.
|
|
246
|
+
this.homeClosed = true;
|
|
247
|
+
try { this.socket.end(encodeClientClose(event.code ?? undefined, event.reason)); } catch { /* already gone */ }
|
|
248
|
+
this.armCloseTimer();
|
|
249
|
+
this.closeLocal(relayCloseCode(event.code), event.reason);
|
|
250
|
+
this.finish("home");
|
|
251
|
+
return;
|
|
252
|
+
}
|
|
253
|
+
}
|
|
254
|
+
if (refused !== null && !this.ended) {
|
|
255
|
+
// A Home message over the limit, or a frame no server may send: both legs close (1011 to Codex).
|
|
256
|
+
const code = refused instanceof LinkWsProtocolError ? refused.closeCode : 1002;
|
|
257
|
+
this.closeBoth(1011, "home message refused", code, "protocol");
|
|
258
|
+
}
|
|
259
|
+
}
|
|
260
|
+
|
|
261
|
+
/** Bun reports the local send buffer drained. */
|
|
262
|
+
drained(): void {
|
|
263
|
+
if (!this.paused || this.ended) return;
|
|
264
|
+
if ((this.local?.getBufferedAmount() ?? 0) > this.limits.downlinkPauseBytes) return;
|
|
265
|
+
this.paused = false;
|
|
266
|
+
this.socket.resume();
|
|
267
|
+
this.onPause?.(false);
|
|
268
|
+
}
|
|
269
|
+
|
|
270
|
+
/** A message from Codex. */
|
|
271
|
+
fromCodex(message: string | Buffer): void {
|
|
272
|
+
if (this.ended || this.homeClosed) return;
|
|
273
|
+
if (typeof message !== "string") { this.closeBoth(1003, "binary messages are not relayed", 1003, "binary"); return; }
|
|
274
|
+
const bytes = Buffer.byteLength(message);
|
|
275
|
+
this.onBytes?.("fromCodex", bytes);
|
|
276
|
+
// One unflushed message at most: Bun cannot pause delivery, so a second one while the first is still
|
|
277
|
+
// queued toward the Home is an overload, never a buffer that grows.
|
|
278
|
+
if (this.socket.writableLength > 0) { this.closeBoth(1013, "link websocket overloaded", 1001, "overload"); return; }
|
|
279
|
+
this.socket.write(encodeClientText(message), error => { if (!error) this.flow?.toHome(bytes); });
|
|
280
|
+
}
|
|
281
|
+
|
|
282
|
+
/**
|
|
283
|
+
* Codex's socket closed (or Bun closed it); the Home leg follows as it happened: Codex's drop (1006 with no
|
|
284
|
+
* reason) ends the Home connection without a close frame, a close without a status (1005) becomes an empty
|
|
285
|
+
* close frame, anything else is relayed (1015, codes that may not appear on the wire, and a 1006 Bun reports
|
|
286
|
+
* with its own reason, such as an oversized message it refused with 1009, as 1011).
|
|
287
|
+
*/
|
|
288
|
+
localGone(code: number, reason = ""): void {
|
|
289
|
+
this.localClosed = true;
|
|
290
|
+
if (this.ended) return;
|
|
291
|
+
if (code === 1006 && reason === "") {
|
|
292
|
+
this.homeClosed = true;
|
|
293
|
+
this.socket.destroy();
|
|
294
|
+
} else {
|
|
295
|
+
this.closeHome(code === 1005 ? null : relayCloseCode(code), "");
|
|
296
|
+
}
|
|
297
|
+
// A 1006 (Codex's drop, or Bun's own close of an oversized message) is no close frame from Codex: the
|
|
298
|
+
// request is incomplete, as the Home counts the same socket.
|
|
299
|
+
this.finish("client", code !== 1006);
|
|
300
|
+
}
|
|
301
|
+
|
|
302
|
+
/** A runtime stop: both legs close with 1001. */
|
|
303
|
+
stop(): void {
|
|
304
|
+
if (this.ended) return;
|
|
305
|
+
this.closeBoth(1001, "link websocket stopping", 1001, "stopped");
|
|
306
|
+
}
|
|
307
|
+
|
|
308
|
+
private homeGone(): void {
|
|
309
|
+
if (this.closeTimer !== undefined) { this.timers.clearTimeout(this.closeTimer); this.closeTimer = undefined; }
|
|
310
|
+
if (!this.ended) {
|
|
311
|
+
// The Home's connection ended without a close frame (a tunnel drop, a killed Home): 1011 to Codex.
|
|
312
|
+
this.homeClosed = true;
|
|
313
|
+
this.closeLocal(1011, "home connection ended");
|
|
314
|
+
this.finish("home_dropped");
|
|
315
|
+
}
|
|
316
|
+
if (this.released) return;
|
|
317
|
+
this.released = true;
|
|
318
|
+
this.onReleased();
|
|
319
|
+
}
|
|
320
|
+
|
|
321
|
+
private closeBoth(localCode: number, localReason: string, homeCode: number, why: LinkWsCloseReason): void {
|
|
322
|
+
this.closeHome(homeCode, "");
|
|
323
|
+
this.closeLocal(localCode, localReason);
|
|
324
|
+
this.finish(why);
|
|
325
|
+
}
|
|
326
|
+
|
|
327
|
+
private closeLocal(code: number, reason: string): void {
|
|
328
|
+
if (this.localClosed) return;
|
|
329
|
+
this.localClosed = true;
|
|
330
|
+
if (!this.local) { this.pendingLocalClose = { code, reason }; return; }
|
|
331
|
+
try { this.local.close(code, reason); } catch { /* already closed */ }
|
|
332
|
+
}
|
|
333
|
+
|
|
334
|
+
private armCloseTimer(): void {
|
|
335
|
+
if (this.closeTimer !== undefined) return;
|
|
336
|
+
this.closeTimer = this.timers.setTimeout(() => { this.closeTimer = undefined; this.socket.destroy(); }, this.limits.closeHandshakeMs);
|
|
337
|
+
}
|
|
338
|
+
|
|
339
|
+
/**
|
|
340
|
+
* Start the close handshake on the Home leg (`null`: a close frame without a status); the Home's own
|
|
341
|
+
* close or the 5 s bound ends the connection.
|
|
342
|
+
*/
|
|
343
|
+
private closeHome(code: number | null, reason: string): void {
|
|
344
|
+
if (this.homeClosed) return;
|
|
345
|
+
this.homeClosed = true;
|
|
346
|
+
try { this.socket.write(code === null ? encodeClientClose() : encodeClientClose(code, reason)); } catch { /* already gone */ }
|
|
347
|
+
this.socket.resume();
|
|
348
|
+
this.armCloseTimer();
|
|
349
|
+
// The Home's close reply ends the handshake; anything else it still sends is dropped.
|
|
350
|
+
this.socket.removeAllListeners("data");
|
|
351
|
+
this.socket.on("data", chunk => {
|
|
352
|
+
try {
|
|
353
|
+
for (const event of this.reader.push(chunk as Buffer)) {
|
|
354
|
+
if (event.type === "close") { this.socket.destroy(); return; }
|
|
355
|
+
}
|
|
356
|
+
} catch { this.socket.destroy(); }
|
|
357
|
+
});
|
|
358
|
+
// A reader stopped by a protocol error parses nothing more: flush the close and let the Home end the connection.
|
|
359
|
+
if (this.reader.closed) this.socket.end();
|
|
360
|
+
}
|
|
361
|
+
|
|
362
|
+
/** `complete`: a close frame ended the socket; by default true for home, client and stopped. */
|
|
363
|
+
private finish(reason: LinkWsCloseReason, complete = reason === "home" || reason === "client" || reason === "stopped"): void {
|
|
364
|
+
if (this.ended) return;
|
|
365
|
+
this.ended = true;
|
|
366
|
+
this.clearAttachTimer();
|
|
367
|
+
if (this.paused) this.onPause?.(false);
|
|
368
|
+
// A socket Codex never had (a failed local upgrade) counts nothing: no request, no close.
|
|
369
|
+
if (!this.opened) return;
|
|
370
|
+
// Complete when a close ended it, from either side; a drop, an overload or a refused message is incomplete.
|
|
371
|
+
this.flow?.end(complete);
|
|
372
|
+
this.onEnd(reason);
|
|
373
|
+
}
|
|
374
|
+
}
|
|
375
|
+
|
|
376
|
+
export function createLinkWebsocketRelay(deps: LinkWebsocketRelayDeps = {}) {
|
|
377
|
+
const limits: LinkChildWebsocketLimits = { ...LINK_CHILD_WS_LIMITS, ...deps.limits };
|
|
378
|
+
const timers = deps.timers ?? defaultTimers;
|
|
379
|
+
const ready = deps.ready ?? linkWebsocketChildReady;
|
|
380
|
+
const advertised = deps.advertised ?? ((linkId: string | undefined) => linkWebsocketAdvertisement(linkId) !== "off");
|
|
381
|
+
const open = deps.open ?? openLinkWebsocket;
|
|
382
|
+
const traffic = deps.traffic ?? childLinkTraffic;
|
|
383
|
+
const optOut = deps.optOut ?? (() => false);
|
|
384
|
+
let openSockets = 0;
|
|
385
|
+
let settingUp = 0;
|
|
386
|
+
let reservedBytes = 0;
|
|
387
|
+
const legs = new Set<HomeLeg>();
|
|
388
|
+
// Upgrades still in setup: a stop aborts them, and nothing set up after a stop is kept.
|
|
389
|
+
const setups = new Set<AbortController>();
|
|
390
|
+
let stopping = false;
|
|
391
|
+
// The tunnel supervisor is stopping (a Child restart): every upgrade from now on gets the transient 503.
|
|
392
|
+
let draining = false;
|
|
393
|
+
const counted = { upgrades: 0, fallbacks: {} as LinkWebsocketCounters["fallbacks"], closes: {} as LinkWebsocketCounters["closes"], fromCodexBytes: 0, toCodexBytes: 0 };
|
|
394
|
+
const countBytes = (direction: "fromCodex" | "toCodex", bytes: number): void => {
|
|
395
|
+
if (direction === "fromCodex") counted.fromCodexBytes += bytes; else counted.toCodexBytes += bytes;
|
|
396
|
+
};
|
|
397
|
+
|
|
398
|
+
const diagnostic = (event: LinkDiagnosticRecord["event"], outcome: LinkDiagnosticRecord["outcome"]): void => {
|
|
399
|
+
try { deps.diagnostic?.({ event, outcome }); } catch { /* diagnostics never alter the relay */ }
|
|
400
|
+
};
|
|
401
|
+
const fallback = (reason: LinkWsFallbackReason): Response => {
|
|
402
|
+
counted.fallbacks[reason] = (counted.fallbacks[reason] ?? 0) + 1;
|
|
403
|
+
diagnostic("link_ws_fallback", reason);
|
|
404
|
+
return upgradeRequiredResponse();
|
|
405
|
+
};
|
|
406
|
+
const drained = (): Response => {
|
|
407
|
+
counted.fallbacks.draining = (counted.fallbacks.draining ?? 0) + 1;
|
|
408
|
+
diagnostic("link_ws_fallback", "draining");
|
|
409
|
+
return tunnelReconnecting();
|
|
410
|
+
};
|
|
411
|
+
const closeAll = (): number => {
|
|
412
|
+
stopping = true;
|
|
413
|
+
for (const setup of [...setups]) setup.abort(new DOMException("link websocket stopping", "AbortError"));
|
|
414
|
+
const all = [...legs];
|
|
415
|
+
for (const leg of all) leg.stop();
|
|
416
|
+
return all.length;
|
|
417
|
+
};
|
|
418
|
+
// Drain before the tunnel goes: a socket closed here reconnects to whatever serves next, and an upgrade
|
|
419
|
+
// meanwhile is told to retry rather than to use HTTP for the rest of its session.
|
|
420
|
+
try {
|
|
421
|
+
deps.tunnel?.onStopping?.(() => {
|
|
422
|
+
if (draining) return;
|
|
423
|
+
draining = true;
|
|
424
|
+
closeAll();
|
|
425
|
+
});
|
|
426
|
+
} catch { /* a gate without the hook never drains */ }
|
|
427
|
+
|
|
428
|
+
return {
|
|
429
|
+
/**
|
|
430
|
+
* Design 3.2 step 2: whether an upgrade may try the Home at all. False keeps today's 426 with no network
|
|
431
|
+
* I/O. With the release gate closed nothing is counted or written; with it open, the Child-local opt-out
|
|
432
|
+
* and a Home whose last applied answer said off are counted in memory (never in the diagnostics file). A
|
|
433
|
+
* link with no applied answer since this process started is tried, and its upgrade's own preflight decides. While the relay drains,
|
|
434
|
+
* an upgrade goes on to its 503 whatever the Home last advertised (the opt-out still keeps it on HTTP).
|
|
435
|
+
*/
|
|
436
|
+
wanted(linkId: string | undefined): boolean {
|
|
437
|
+
try {
|
|
438
|
+
if (!ready()) return false;
|
|
439
|
+
const why: LinkWsFallbackReason | null = optOut() ? "local_optout" : draining || advertised(linkId) ? null : "not_advertised";
|
|
440
|
+
if (why) counted.fallbacks[why] = (counted.fallbacks[why] ?? 0) + 1;
|
|
441
|
+
return why === null;
|
|
442
|
+
} catch { return false; }
|
|
443
|
+
},
|
|
444
|
+
|
|
445
|
+
/** Steps 1 and 3 to 11. Resolves undefined once the local socket is upgraded. */
|
|
446
|
+
async upgrade(req: Request, server: Server<unknown>, target: LinkWebsocketTarget): Promise<Response | undefined> {
|
|
447
|
+
if (draining) return drained();
|
|
448
|
+
if (req.headers.has("origin")) return fallback("origin");
|
|
449
|
+
const admissionKey = target.linkKey();
|
|
450
|
+
if (!admissionKey || !target.linkId || !target.apiKeyId) return fallback("credential");
|
|
451
|
+
if (openSockets + settingUp >= limits.openSockets || settingUp >= limits.settingUp) return fallback("cap");
|
|
452
|
+
if (reservedBytes + limits.socketReservationBytes > limits.memoryBudgetBytes) return fallback("memory");
|
|
453
|
+
const headers = forwardLinkUpgradeHeaders(req.headers, admissionKey);
|
|
454
|
+
if (!headers) return fallback("handshake");
|
|
455
|
+
settingUp += 1;
|
|
456
|
+
reservedBytes += limits.socketReservationBytes;
|
|
457
|
+
let reservation: "setup" | "open" | "released" = "setup";
|
|
458
|
+
const release = (): void => {
|
|
459
|
+
if (reservation === "released") return;
|
|
460
|
+
if (reservation === "setup") settingUp -= 1; else openSockets -= 1;
|
|
461
|
+
reservedBytes -= limits.socketReservationBytes;
|
|
462
|
+
reservation = "released";
|
|
463
|
+
};
|
|
464
|
+
const budget = new AbortController();
|
|
465
|
+
setups.add(budget);
|
|
466
|
+
const onLocalAbort = () => budget.abort(req.signal.reason);
|
|
467
|
+
req.signal.addEventListener("abort", onLocalAbort, { once: true });
|
|
468
|
+
if (req.signal.aborted) onLocalAbort();
|
|
469
|
+
let expired = false;
|
|
470
|
+
const budgetTimer = timers.setTimeout(() => { expired = true; budget.abort(new DOMException("link websocket setup budget", "TimeoutError")); }, limits.setupBudgetMs);
|
|
471
|
+
const stopBudget = (): void => { setups.delete(budget); timers.clearTimeout(budgetTimer); req.signal.removeEventListener("abort", onLocalAbort); };
|
|
472
|
+
const failed = (reason: LinkWsFallbackReason): Response => {
|
|
473
|
+
stopBudget();
|
|
474
|
+
release();
|
|
475
|
+
if (draining) return drained();
|
|
476
|
+
return fallback(expired && (reason === "aborted" || reason === "preflight") ? "timeout" : reason);
|
|
477
|
+
};
|
|
478
|
+
// Every ownership check is raced against the budget: a stalled lookup cannot hold the request or its reservation.
|
|
479
|
+
const proof = async (gate: LinkTunnelGate): Promise<LinkAdmissionResult | null> => {
|
|
480
|
+
if (budget.signal.aborted) return null;
|
|
481
|
+
let onAbort!: () => void;
|
|
482
|
+
const aborted = new Promise<null>(resolve => { onAbort = () => resolve(null); budget.signal.addEventListener("abort", onAbort, { once: true }); });
|
|
483
|
+
try { return await Promise.race([Promise.resolve(gate.connected()), aborted]); }
|
|
484
|
+
finally { budget.signal.removeEventListener("abort", onAbort); }
|
|
485
|
+
};
|
|
486
|
+
try {
|
|
487
|
+
// Step 5: the tunnel gate. A Home-initiated link's gate always matches and goes straight on.
|
|
488
|
+
const tunnel = deps.tunnel;
|
|
489
|
+
if (!tunnel) return failed("tunnel_failed");
|
|
490
|
+
let admission = await proof(tunnel);
|
|
491
|
+
// A deadline proves neither a foreign owner nor a broken tunnel: one fresh proof, as the HTTP relay gives it.
|
|
492
|
+
if (admission?.kind === "deadline") admission = await proof(tunnel);
|
|
493
|
+
if (!admission) return failed("aborted");
|
|
494
|
+
if (admission.kind !== "match") {
|
|
495
|
+
if (!tunnel.pending()) return failed(budget.signal.aborted ? "aborted" : "tunnel_failed");
|
|
496
|
+
await tunnel.waitForConnected(limits.tunnelHoldMs, budget.signal);
|
|
497
|
+
if (budget.signal.aborted) return failed("aborted");
|
|
498
|
+
admission = await proof(tunnel);
|
|
499
|
+
if (!admission) return failed("aborted");
|
|
500
|
+
if (admission.kind !== "match") {
|
|
501
|
+
if (!tunnel.pending()) return failed("tunnel_failed");
|
|
502
|
+
stopBudget();
|
|
503
|
+
release();
|
|
504
|
+
counted.fallbacks.tunnel_connecting_timeout = (counted.fallbacks.tunnel_connecting_timeout ?? 0) + 1;
|
|
505
|
+
diagnostic("link_ws_fallback", "tunnel_connecting_timeout");
|
|
506
|
+
return tunnelReconnecting();
|
|
507
|
+
}
|
|
508
|
+
}
|
|
509
|
+
if (budget.signal.aborted) return failed("aborted");
|
|
510
|
+
// Steps 6 to 9 on one authenticated connection.
|
|
511
|
+
const setup = await open({ tunnelPort: target.tunnelPort, admissionKey, linkId: target.linkId, apiKeyId: target.apiKeyId }, headers,
|
|
512
|
+
{ signal: budget.signal, preflightMs: limits.preflightMs, upgradeMs: limits.setupBudgetMs, timers, ready });
|
|
513
|
+
if (!setup.ok) return failed(FAILURE_REASON[setup.reason]);
|
|
514
|
+
stopBudget();
|
|
515
|
+
if (req.signal.aborted || expired || stopping) {
|
|
516
|
+
setup.socket.destroy();
|
|
517
|
+
release();
|
|
518
|
+
return draining ? drained() : fallback(expired ? "timeout" : "aborted");
|
|
519
|
+
}
|
|
520
|
+
const linkId = target.linkId;
|
|
521
|
+
// The reservation is held until the Home connection has actually closed.
|
|
522
|
+
const leg = new HomeLeg(setup.socket, setup.head, limits, timers, () => traffic.begin(linkId),
|
|
523
|
+
reason => { counted.closes[reason] = (counted.closes[reason] ?? 0) + 1; diagnostic("link_ws_close", reason); },
|
|
524
|
+
() => {
|
|
525
|
+
legs.delete(leg);
|
|
526
|
+
release();
|
|
527
|
+
try { deps.onReleased?.(); } catch { /* a test seam never alters the relay */ }
|
|
528
|
+
},
|
|
529
|
+
deps.onDownlinkPause, countBytes);
|
|
530
|
+
legs.add(leg);
|
|
531
|
+
settingUp -= 1;
|
|
532
|
+
openSockets += 1;
|
|
533
|
+
reservation = "open";
|
|
534
|
+
// Step 11: Codex's own 101 names the message limit, so Codex sends a larger request over HTTP.
|
|
535
|
+
let upgraded = false;
|
|
536
|
+
try {
|
|
537
|
+
upgraded = server.upgrade(req, { data: { leg } satisfies LinkWebsocketData, headers: { [CODEX_WS_MAX_MESSAGE_HEADER]: String(limits.localMessageBytes) } });
|
|
538
|
+
} catch {
|
|
539
|
+
upgraded = false;
|
|
540
|
+
}
|
|
541
|
+
if (!upgraded) {
|
|
542
|
+
// Codex never had this socket: the Home leg closes, nothing is counted but the fallback, and the
|
|
543
|
+
// reservation is released once the Home connection has closed.
|
|
544
|
+
leg.abandon();
|
|
545
|
+
return fallback("handshake");
|
|
546
|
+
}
|
|
547
|
+
leg.upgraded();
|
|
548
|
+
counted.upgrades += 1;
|
|
549
|
+
diagnostic("link_ws_open", "connected");
|
|
550
|
+
return undefined;
|
|
551
|
+
} catch {
|
|
552
|
+
return failed("handshake");
|
|
553
|
+
}
|
|
554
|
+
},
|
|
555
|
+
|
|
556
|
+
/** The listener's websocket handler for link sockets. */
|
|
557
|
+
handler(): WebSocketHandler<LinkWebsocketData> {
|
|
558
|
+
return {
|
|
559
|
+
maxPayloadLength: limits.localMessageBytes,
|
|
560
|
+
backpressureLimit: limits.localBackpressureBytes,
|
|
561
|
+
closeOnBackpressureLimit: false,
|
|
562
|
+
idleTimeout: 0,
|
|
563
|
+
perMessageDeflate: false,
|
|
564
|
+
open(ws) { ws.data.leg.attach(ws); },
|
|
565
|
+
message(ws, message) { ws.data.leg.fromCodex(message); },
|
|
566
|
+
drain(ws) { ws.data.leg.drained(); },
|
|
567
|
+
close(ws, code, reason) { ws.data.leg.localGone(code, reason); },
|
|
568
|
+
};
|
|
569
|
+
},
|
|
570
|
+
|
|
571
|
+
/** A runtime stop: every link socket closes with 1001 on both legs, and every upgrade still in setup is aborted. */
|
|
572
|
+
closeAll,
|
|
573
|
+
|
|
574
|
+
snapshot(): { open: number; settingUp: number; reservedBytes: number } {
|
|
575
|
+
return { open: openSockets, settingUp, reservedBytes };
|
|
576
|
+
},
|
|
577
|
+
|
|
578
|
+
/** Design 9.3: this Child's counters (display only). */
|
|
579
|
+
counters(): LinkWebsocketCounters {
|
|
580
|
+
return { open: openSockets, settingUp, upgrades: counted.upgrades, fallbacks: { ...counted.fallbacks }, closes: { ...counted.closes },
|
|
581
|
+
fromCodexBytes: counted.fromCodexBytes, toCodexBytes: counted.toCodexBytes };
|
|
582
|
+
},
|
|
583
|
+
};
|
|
584
|
+
}
|
|
585
|
+
|
|
586
|
+
export type LinkWebsocketRelay = ReturnType<typeof createLinkWebsocketRelay>;
|