@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,494 @@
|
|
|
1
|
+
// Plain ESM with no Bun or TypeScript dependency; its one caller is the Home's startup step,
|
|
2
|
+
// src/link/child-binary-cache-start.ts. Types: child-binary-cache-fill.d.mts.
|
|
3
|
+
import { createHash, randomBytes } from "node:crypto";
|
|
4
|
+
import { closeSync, fsyncSync, linkSync, lstatSync, mkdirSync, openSync, readFileSync, readdirSync, realpathSync, renameSync, unlinkSync, writeFileSync, writeSync } from "node:fs";
|
|
5
|
+
import { dirname, join } from "node:path";
|
|
6
|
+
import { fileURLToPath } from "node:url";
|
|
7
|
+
import { detectInstallFromPath } from "../update/install-detection.mjs";
|
|
8
|
+
|
|
9
|
+
/**
|
|
10
|
+
* Fills $OPENCODEX_HOME/ocx-child-builds/<version>/ when an updated Home of that version starts (lane
|
|
11
|
+
* O2 of the disposable-machines design), so a packaged Home can plant ocx-child on a bare machine
|
|
12
|
+
* after an update by any installer.
|
|
13
|
+
*
|
|
14
|
+
* Trust is the update's own: the expected digests come from CHILD_RELEASE_DIGESTS_PATH inside the
|
|
15
|
+
* running package tree, which its installer verified, and each binary, fetched from the GitHub
|
|
16
|
+
* release of exactly that version, is cached only when its SHA-256 equals that digest. Nothing is
|
|
17
|
+
* fetched without that file, from a source checkout, on Windows, or without evidence of an upgrade:
|
|
18
|
+
* ocx-child-builds/.versions/ holds one marker per version, "<version>.filled" when its fill completed
|
|
19
|
+
* and "<version>.baseline" when it ran and fetched nothing (a first start, or a package without
|
|
20
|
+
* digests, silently, so the first release that ships them sees an upgrade); markers are only added,
|
|
21
|
+
* so the newest can never go down, and only a running version newer than it fills. A first start (no record: a fresh install) records
|
|
22
|
+
* its version and fetches nothing, a restart of the same version fetches nothing, and a record or
|
|
23
|
+
* cache directory for a newer version means a downgrade. A listed build that cannot be verified loses its manifest line,
|
|
24
|
+
* so it can never stay trusted under an older manifest; the fill deletes no build file (unlisted, the reader
|
|
25
|
+
* refuses it); the record stays behind until every listed build is verified, so the next start retries.
|
|
26
|
+
* A digest file that is there but unreadable or unusable is not an absent one: nothing is written and
|
|
27
|
+
* the record stays, so a repaired package still fills. Overlapping fills cannot lose a build: the
|
|
28
|
+
* manifest is rebuilt from the builds verified on disk when it is written, and a completed record
|
|
29
|
+
* whose manifest no longer covers the package's digests is repaired on the next start by re-listing
|
|
30
|
+
* the builds still verified on disk; a same-version start never downloads. ocx-child-builds/.fill.lock (reclaimed once its
|
|
31
|
+
* process is gone or after an hour) keeps concurrent starts from downloading twice; it is not the guarantee.
|
|
32
|
+
*
|
|
33
|
+
* The directory is OpenCodex's own (uninstall removes it); an operator's hand-placed builds live in
|
|
34
|
+
* cache/ocx-child/<version>/, which the reader checks first and this module never reads or writes.
|
|
35
|
+
*
|
|
36
|
+
* Nobody else can substitute a build or forge a record: each of ocx-child-builds, .versions and the version
|
|
37
|
+
* directory must be a real directory (never a symlink; created 0700 when missing) owned by this user
|
|
38
|
+
* and writable by nobody else, and every directory above them must be owned by this user or root and
|
|
39
|
+
* writable by nobody else unless sticky. Every write re-checks the target directory's identity, so a
|
|
40
|
+
* directory swapped in during a download receives nothing. An existing build counts only when it
|
|
41
|
+
* passes the reader's file checks as well as the digest. Windows has no mode bits to establish that
|
|
42
|
+
* privacy, so there the fill does nothing and builds are placed by hand.
|
|
43
|
+
*/
|
|
44
|
+
|
|
45
|
+
/** Digests of the release's ocx-child builds, relative to the package root ("<sha256> ocx-child-<triple>[.exe]"). */
|
|
46
|
+
export const CHILD_RELEASE_DIGESTS_PATH = "native/ocx-child/SHA256SUMS";
|
|
47
|
+
export const CHILD_RELEASE_REPOSITORY = "lidge-jun/opencodex";
|
|
48
|
+
/** The build file names child-binary-source.ts plants from (childArtifactFilename of every target). */
|
|
49
|
+
export const CHILD_CACHE_ARTIFACT_FILES = Object.freeze([
|
|
50
|
+
"ocx-child-darwin-arm64", "ocx-child-darwin-x64", "ocx-child-linux-x64", "ocx-child-linux-arm64", "ocx-child-windows-x64.exe",
|
|
51
|
+
]);
|
|
52
|
+
const MAX_CHILD_BINARY_BYTES = 32 * 1024 * 1024;
|
|
53
|
+
const MAX_MANIFEST_BYTES = 256 * 1024;
|
|
54
|
+
const SHA256_HEX = /^[0-9a-f]{64}$/;
|
|
55
|
+
const VERSIONS_DIR = ".versions";
|
|
56
|
+
const POSIX = process.platform !== "win32";
|
|
57
|
+
const SEMVER = /^(0|[1-9]\d*)\.(0|[1-9]\d*)\.(0|[1-9]\d*)(?:-([0-9A-Za-z-]+(?:\.[0-9A-Za-z-]+)*))?(?:\+[0-9A-Za-z-]+(?:\.[0-9A-Za-z-]+)*)?$/;
|
|
58
|
+
|
|
59
|
+
export function childReleaseAssetUrl(version, file) {
|
|
60
|
+
return "https://github.com/" + CHILD_RELEASE_REPOSITORY + "/releases/download/v" + encodeURIComponent(version) + "/" + encodeURIComponent(file);
|
|
61
|
+
}
|
|
62
|
+
|
|
63
|
+
/** The fill's own directory under OPENCODEX_HOME, listed as owned once created (never cache/, which is the operator's). */
|
|
64
|
+
export const CHILD_FILL_DIR = "ocx-child-builds";
|
|
65
|
+
|
|
66
|
+
export function childBinaryCacheDir(opencodexHome, version) {
|
|
67
|
+
return join(opencodexHome, CHILD_FILL_DIR, version);
|
|
68
|
+
}
|
|
69
|
+
|
|
70
|
+
function parseVersion(value) {
|
|
71
|
+
if (typeof value !== "string" || value.length > 96) return null;
|
|
72
|
+
const match = SEMVER.exec(value);
|
|
73
|
+
if (!match) return null;
|
|
74
|
+
return { core: [BigInt(match[1]), BigInt(match[2]), BigInt(match[3])], pre: match[4] === undefined ? [] : match[4].split(".") };
|
|
75
|
+
}
|
|
76
|
+
|
|
77
|
+
/** SemVer precedence (build metadata ignored): -1 older, 0 equal, 1 newer. */
|
|
78
|
+
export function compareReleaseVersions(left, right) {
|
|
79
|
+
const a = parseVersion(left), b = parseVersion(right);
|
|
80
|
+
if (!a || !b) return null;
|
|
81
|
+
for (let i = 0; i < 3; i++) if (a.core[i] !== b.core[i]) return a.core[i] > b.core[i] ? 1 : -1;
|
|
82
|
+
if (a.pre.length === 0 || b.pre.length === 0) return a.pre.length === b.pre.length ? 0 : a.pre.length === 0 ? 1 : -1;
|
|
83
|
+
for (let i = 0; i < Math.max(a.pre.length, b.pre.length); i++) {
|
|
84
|
+
const x = a.pre[i], y = b.pre[i];
|
|
85
|
+
if (x === y) continue;
|
|
86
|
+
if (x === undefined) return -1;
|
|
87
|
+
if (y === undefined) return 1;
|
|
88
|
+
const xn = /^\d+$/.test(x), yn = /^\d+$/.test(y);
|
|
89
|
+
if (xn && yn) return BigInt(x) > BigInt(y) ? 1 : -1;
|
|
90
|
+
if (xn !== yn) return xn ? -1 : 1;
|
|
91
|
+
return x > y ? 1 : -1;
|
|
92
|
+
}
|
|
93
|
+
return 0;
|
|
94
|
+
}
|
|
95
|
+
|
|
96
|
+
/** "<sha256> <file>" lines, the format child-binary-source.ts reads (parseSha256Sums). */
|
|
97
|
+
function parseManifest(text) {
|
|
98
|
+
const entries = new Map();
|
|
99
|
+
for (const raw of text.split(/\r?\n/)) {
|
|
100
|
+
const line = raw.trim();
|
|
101
|
+
if (!line || line.startsWith("#")) continue;
|
|
102
|
+
const match = /^([0-9A-Fa-f]{64})\s+\*?([^\s/\\]+)$/.exec(line);
|
|
103
|
+
if (match) entries.set(match[2], match[1].toLowerCase());
|
|
104
|
+
}
|
|
105
|
+
return entries;
|
|
106
|
+
}
|
|
107
|
+
|
|
108
|
+
function readRegular(path, maxBytes) {
|
|
109
|
+
let st;
|
|
110
|
+
try { st = lstatSync(path); } catch (error) { if (error?.code === "ENOENT") return null; throw error; }
|
|
111
|
+
if (!st.isFile() || st.isSymbolicLink() || st.size > maxBytes) throw new Error("not a regular file: " + path);
|
|
112
|
+
return readFileSync(path);
|
|
113
|
+
}
|
|
114
|
+
|
|
115
|
+
/** null: no digest file (every release so far); "invalid": there but unreadable or unusable; else the digests. */
|
|
116
|
+
function readDigests(packageRoot) {
|
|
117
|
+
let bytes;
|
|
118
|
+
try { bytes = readRegular(join(packageRoot, CHILD_RELEASE_DIGESTS_PATH), MAX_MANIFEST_BYTES); } catch { return "invalid"; }
|
|
119
|
+
if (bytes === null) return null;
|
|
120
|
+
const known = new Set(CHILD_CACHE_ARTIFACT_FILES);
|
|
121
|
+
const digests = new Map([...parseManifest(bytes.toString("utf8"))].filter(([file, sha]) => known.has(file) && SHA256_HEX.test(sha)));
|
|
122
|
+
return digests.size > 0 ? digests : "invalid";
|
|
123
|
+
}
|
|
124
|
+
|
|
125
|
+
function currentUid() {
|
|
126
|
+
return typeof process.getuid === "function" ? process.getuid() : null;
|
|
127
|
+
}
|
|
128
|
+
|
|
129
|
+
/** Every directory above the cache: owned by this user or root, writable by nobody else unless sticky (/tmp). */
|
|
130
|
+
function assertTrustedAncestors(home) {
|
|
131
|
+
if (!POSIX) return;
|
|
132
|
+
let dir = realpathSync(home);
|
|
133
|
+
for (;;) {
|
|
134
|
+
const st = lstatSync(dir);
|
|
135
|
+
const owner = st.uid === currentUid() || st.uid === 0;
|
|
136
|
+
const writers = (st.mode & 0o022) === 0 || (st.mode & 0o1000) !== 0;
|
|
137
|
+
if (!st.isDirectory() || !owner || !writers) throw new Error("unsafe cache directory: " + dir);
|
|
138
|
+
const parent = dirname(dir);
|
|
139
|
+
if (parent === dir) return;
|
|
140
|
+
dir = parent;
|
|
141
|
+
}
|
|
142
|
+
}
|
|
143
|
+
|
|
144
|
+
/** A real directory (never a symlink) private to this user, created 0700 when missing; returns its identity. */
|
|
145
|
+
function realDirectory(path) {
|
|
146
|
+
let st;
|
|
147
|
+
try { st = lstatSync(path); } catch (error) {
|
|
148
|
+
if (error?.code !== "ENOENT") throw error;
|
|
149
|
+
mkdirSync(path, { mode: 0o700 });
|
|
150
|
+
st = lstatSync(path);
|
|
151
|
+
}
|
|
152
|
+
if (!st.isDirectory() || st.isSymbolicLink()) throw new Error("unsafe cache directory: " + path);
|
|
153
|
+
if (POSIX && (st.uid !== currentUid() || (st.mode & 0o022) !== 0)) throw new Error("unsafe cache directory: " + path);
|
|
154
|
+
return { dev: st.dev, ino: st.ino };
|
|
155
|
+
}
|
|
156
|
+
|
|
157
|
+
function sameDirectory(path, identity) {
|
|
158
|
+
try {
|
|
159
|
+
const st = lstatSync(path);
|
|
160
|
+
return st.isDirectory() && !st.isSymbolicLink() && st.dev === identity.dev && st.ino === identity.ino;
|
|
161
|
+
} catch { return false; }
|
|
162
|
+
}
|
|
163
|
+
|
|
164
|
+
function sha256Hex(bytes) {
|
|
165
|
+
return createHash("sha256").update(bytes).digest("hex");
|
|
166
|
+
}
|
|
167
|
+
|
|
168
|
+
/** Exclusive private temp beside the target, then rename: a symlink at the name is replaced, never followed. */
|
|
169
|
+
function publish(dir, identity, name, bytes) {
|
|
170
|
+
if (!sameDirectory(dir, identity)) throw new Error("cache directory changed");
|
|
171
|
+
const temp = join(dir, ".ocx-child-cache." + process.pid + "." + randomBytes(6).toString("hex") + ".tmp");
|
|
172
|
+
const fd = openSync(temp, "wx", 0o600);
|
|
173
|
+
try {
|
|
174
|
+
// writeFileSync on a descriptor writes every byte or throws; a short or failed write never reaches the name.
|
|
175
|
+
try { writeFileSync(fd, bytes); fsyncSync(fd); } finally { closeSync(fd); }
|
|
176
|
+
if (!sameDirectory(dir, identity)) throw new Error("cache directory changed");
|
|
177
|
+
renameSync(temp, join(dir, name));
|
|
178
|
+
} catch (error) {
|
|
179
|
+
try { unlinkSync(temp); } catch { /* already gone */ }
|
|
180
|
+
throw error;
|
|
181
|
+
}
|
|
182
|
+
}
|
|
183
|
+
|
|
184
|
+
function unpublish(dir, identity, name) {
|
|
185
|
+
if (!sameDirectory(dir, identity)) throw new Error("cache directory changed");
|
|
186
|
+
try { unlinkSync(join(dir, name)); } catch (error) { if (error?.code !== "ENOENT") throw error; }
|
|
187
|
+
}
|
|
188
|
+
|
|
189
|
+
/**
|
|
190
|
+
* The record is one empty marker per version in ocx-child-builds/.versions/: "<version>.filled" when
|
|
191
|
+
* that version's fill completed, "<version>.baseline" when it ran and fetched nothing (a first start,
|
|
192
|
+
* or a package without digests). Markers are only ever added, so the newest version recorded can never
|
|
193
|
+
* go down, whichever fill writes last. null: no marker (or an unreadable directory), no evidence.
|
|
194
|
+
*/
|
|
195
|
+
function readVersionRecord(root) {
|
|
196
|
+
let names;
|
|
197
|
+
try {
|
|
198
|
+
const st = lstatSync(join(root, VERSIONS_DIR));
|
|
199
|
+
if (!st.isDirectory() || st.isSymbolicLink()) return null;
|
|
200
|
+
// Another user able to add or remove markers could suppress fills or fake an upgrade.
|
|
201
|
+
if (POSIX && (st.uid !== currentUid() || (st.mode & 0o022) !== 0)) names = null;
|
|
202
|
+
else names = readdirSync(join(root, VERSIONS_DIR));
|
|
203
|
+
} catch { return null; }
|
|
204
|
+
if (names === null) throw new Error("unsafe cache directory: " + join(root, VERSIONS_DIR));
|
|
205
|
+
let newest = null;
|
|
206
|
+
for (const name of names) {
|
|
207
|
+
const match = /^(.+)\.(baseline|filled)$/.exec(name);
|
|
208
|
+
if (!match || compareReleaseVersions(match[1], match[1]) === null) continue;
|
|
209
|
+
const order = newest === null ? 1 : compareReleaseVersions(match[1], newest.version);
|
|
210
|
+
if (order === 1) newest = { version: match[1], filled: match[2] === "filled" };
|
|
211
|
+
else if (order === 0 && match[2] === "filled") newest.filled = true;
|
|
212
|
+
}
|
|
213
|
+
return newest;
|
|
214
|
+
}
|
|
215
|
+
|
|
216
|
+
/** The release builds verified on disk right now: what a manifest may list, whoever wrote them. */
|
|
217
|
+
function verifiedOnDisk(dir, digests) {
|
|
218
|
+
const verified = new Map();
|
|
219
|
+
for (const [file, expected] of digests) {
|
|
220
|
+
const bytes = readCachedBuild(join(dir, file));
|
|
221
|
+
if (bytes && sha256Hex(bytes) === expected) verified.set(file, expected);
|
|
222
|
+
}
|
|
223
|
+
return verified;
|
|
224
|
+
}
|
|
225
|
+
|
|
226
|
+
function readCacheManifest(dir) {
|
|
227
|
+
return parseManifest((readRegular(join(dir, "SHA256SUMS"), MAX_MANIFEST_BYTES) ?? Buffer.alloc(0)).toString("utf8"));
|
|
228
|
+
}
|
|
229
|
+
|
|
230
|
+
/** A completed fill's manifest still lists every build the package vouches for. */
|
|
231
|
+
function manifestCovers(dir, digests) {
|
|
232
|
+
let listed;
|
|
233
|
+
try { listed = readCacheManifest(dir); } catch { return false; }
|
|
234
|
+
return [...digests].every(([file, sha]) => listed.get(file) === sha);
|
|
235
|
+
}
|
|
236
|
+
|
|
237
|
+
/** An existing build the reader would accept: a non-empty regular file, never a symlink, writable only by this user. */
|
|
238
|
+
function readCachedBuild(path) {
|
|
239
|
+
let st;
|
|
240
|
+
try { st = lstatSync(path); } catch { return null; }
|
|
241
|
+
if (!st.isFile() || st.isSymbolicLink() || st.size <= 0 || st.size > MAX_CHILD_BINARY_BYTES) return null;
|
|
242
|
+
if (POSIX && (st.uid !== currentUid() || (st.mode & 0o022) !== 0)) return null;
|
|
243
|
+
try { return readFileSync(path); } catch { return null; }
|
|
244
|
+
}
|
|
245
|
+
|
|
246
|
+
async function download(url, fetchImpl, timeoutMs) {
|
|
247
|
+
let response;
|
|
248
|
+
try { response = await fetchImpl(url, { redirect: "follow", signal: AbortSignal.timeout(timeoutMs) }); } catch { return null; }
|
|
249
|
+
if (!response.ok || !response.body) return null;
|
|
250
|
+
if (Number(response.headers.get("content-length") ?? "0") > MAX_CHILD_BINARY_BYTES) {
|
|
251
|
+
try { await response.body.cancel(); } catch { /* already closed */ }
|
|
252
|
+
return null;
|
|
253
|
+
}
|
|
254
|
+
const chunks = [];
|
|
255
|
+
let size = 0;
|
|
256
|
+
try {
|
|
257
|
+
for await (const chunk of response.body) {
|
|
258
|
+
size += chunk.byteLength;
|
|
259
|
+
if (size > MAX_CHILD_BINARY_BYTES) return null;
|
|
260
|
+
chunks.push(chunk);
|
|
261
|
+
}
|
|
262
|
+
} catch { return null; }
|
|
263
|
+
return Buffer.concat(chunks, size);
|
|
264
|
+
}
|
|
265
|
+
|
|
266
|
+
/** A cache directory for a version newer than this one: this Home was downgraded. */
|
|
267
|
+
function newerVersionCached(home, version) {
|
|
268
|
+
let names;
|
|
269
|
+
try { names = readdirSync(join(home, CHILD_FILL_DIR)); } catch { return false; }
|
|
270
|
+
return names.some(name => compareReleaseVersions(name, version) === 1);
|
|
271
|
+
}
|
|
272
|
+
|
|
273
|
+
/** The package tree this module was loaded from: <root>/src/link/child-binary-cache-fill.mjs. */
|
|
274
|
+
export function runningPackageRoot() {
|
|
275
|
+
return fileURLToPath(new URL("../../", import.meta.url));
|
|
276
|
+
}
|
|
277
|
+
|
|
278
|
+
/**
|
|
279
|
+
* Keeps Home processes sharing one OPENCODEX_HOME from downloading the same builds at once. It is an
|
|
280
|
+
* optimisation, never the guarantee: two fills can still overlap after a stale lock is reclaimed, so
|
|
281
|
+
* the manifest is rebuilt from what is verified on disk when it is written, and a completed record
|
|
282
|
+
* whose manifest no longer covers the package's digests is repaired on the next start.
|
|
283
|
+
*/
|
|
284
|
+
const FILL_LOCK = ".fill.lock";
|
|
285
|
+
/** A fill takes at most a few minutes (five builds, 20 s each); an older lock is a crash's leftover. */
|
|
286
|
+
const STALE_LOCK_MS = 60 * 60 * 1000;
|
|
287
|
+
|
|
288
|
+
function processAlive(pid) {
|
|
289
|
+
try { process.kill(pid, 0); return true; } catch (error) { return error?.code === "EPERM"; }
|
|
290
|
+
}
|
|
291
|
+
|
|
292
|
+
function readLock(path) {
|
|
293
|
+
try {
|
|
294
|
+
const st = lstatSync(path);
|
|
295
|
+
if (!st.isFile() || st.isSymbolicLink() || st.size > 256) return null;
|
|
296
|
+
const token = readFileSync(path, "utf8").trim();
|
|
297
|
+
const pid = Number(token.split(".")[0]);
|
|
298
|
+
return Number.isSafeInteger(pid) && pid > 0 ? { token, pid, mtimeMs: st.mtimeMs } : null;
|
|
299
|
+
} catch { return null; }
|
|
300
|
+
}
|
|
301
|
+
|
|
302
|
+
function removeQuietly(path) {
|
|
303
|
+
try { unlinkSync(path); } catch { /* already gone */ }
|
|
304
|
+
}
|
|
305
|
+
|
|
306
|
+
/**
|
|
307
|
+
* The lock file appears whole or not at all (linked from a private temp), names "<pid>.<nonce>", and
|
|
308
|
+
* is reclaimed only when its process is gone or it is older than STALE_LOCK_MS. null: another fill runs.
|
|
309
|
+
*/
|
|
310
|
+
function acquireFillLock(root, rootIdentity, now) {
|
|
311
|
+
const path = join(root, FILL_LOCK);
|
|
312
|
+
const token = process.pid + "." + randomBytes(8).toString("hex");
|
|
313
|
+
for (let attempt = 0; attempt < 2; attempt++) {
|
|
314
|
+
if (!sameDirectory(root, rootIdentity)) throw new Error("cache directory changed");
|
|
315
|
+
const temp = join(root, ".ocx-child-cache." + token + ".lock.tmp");
|
|
316
|
+
const fd = openSync(temp, "wx", 0o600);
|
|
317
|
+
try {
|
|
318
|
+
// As in publish: the whole record or nothing, and the temp never outlives a failed write or fsync.
|
|
319
|
+
const record = Buffer.from(token + "\n");
|
|
320
|
+
try {
|
|
321
|
+
if (writeSync(fd, record) !== record.length) throw new Error("short write to the cache fill lock");
|
|
322
|
+
fsyncSync(fd);
|
|
323
|
+
} finally { closeSync(fd); }
|
|
324
|
+
try { linkSync(temp, path); return { path, token }; }
|
|
325
|
+
catch (error) { if (error?.code !== "EEXIST") throw error; }
|
|
326
|
+
} finally { removeQuietly(temp); }
|
|
327
|
+
const holder = readLock(path);
|
|
328
|
+
if (holder && processAlive(holder.pid) && now() - holder.mtimeMs < STALE_LOCK_MS) return null;
|
|
329
|
+
// Move the leftover aside, and put it back if a live fill took the lock in the meantime.
|
|
330
|
+
const aside = join(root, ".ocx-child-cache." + token + ".stale.tmp");
|
|
331
|
+
try { renameSync(path, aside); } catch { continue; }
|
|
332
|
+
if (readLock(aside)?.token !== holder?.token) {
|
|
333
|
+
try { linkSync(aside, path); } catch { /* a third fill holds it now */ }
|
|
334
|
+
removeQuietly(aside);
|
|
335
|
+
return null;
|
|
336
|
+
}
|
|
337
|
+
removeQuietly(aside);
|
|
338
|
+
}
|
|
339
|
+
return null;
|
|
340
|
+
}
|
|
341
|
+
|
|
342
|
+
function assertFillLockHeld(lock) {
|
|
343
|
+
if (readLock(lock.path)?.token !== lock.token) throw new Error("cache fill lock lost");
|
|
344
|
+
}
|
|
345
|
+
|
|
346
|
+
function releaseFillLock(lock) {
|
|
347
|
+
if (lock && readLock(lock.path)?.token === lock.token) removeQuietly(lock.path);
|
|
348
|
+
}
|
|
349
|
+
|
|
350
|
+
/** A real directory is there (a symlink or another error counts as present: the write path refuses it). */
|
|
351
|
+
function directoryPresent(path) {
|
|
352
|
+
try { return lstatSync(path).isDirectory(); } catch (error) { return error?.code !== "ENOENT"; }
|
|
353
|
+
}
|
|
354
|
+
|
|
355
|
+
/**
|
|
356
|
+
* What the record alone decides, before any lock or write; null when there is work to do. A start
|
|
357
|
+
* that writes nothing (a same-version restart, a downgrade, a package without digests whose version
|
|
358
|
+
* is recorded) takes no lock and touches no file.
|
|
359
|
+
*/
|
|
360
|
+
function decideFromRecord(recorded, version, digests, dir) {
|
|
361
|
+
if (!digests) return recorded !== null && compareReleaseVersions(version, recorded.version) !== 1 ? { kind: "skipped", reason: "no_digests" } : null;
|
|
362
|
+
if (recorded === null) return null;
|
|
363
|
+
const order = compareReleaseVersions(version, recorded.version);
|
|
364
|
+
if (order === -1) return { kind: "skipped", reason: "downgrade" };
|
|
365
|
+
// A same-version start fetches nothing. It re-lists the builds still verified on disk only when a
|
|
366
|
+
// completed fill's manifest lost lines (fills that overlapped); a version directory removed by hand
|
|
367
|
+
// stays removed.
|
|
368
|
+
if (order === 0 && (!recorded.filled || !directoryPresent(dir) || manifestCovers(dir, digests))) return { kind: "skipped", reason: "not_an_upgrade" };
|
|
369
|
+
return null;
|
|
370
|
+
}
|
|
371
|
+
|
|
372
|
+
export async function fillChildBinaryCacheForVersion(options) {
|
|
373
|
+
// The caller names the Home (the startup step passes getConfigDir(), the Home the reader resolves too); no
|
|
374
|
+
// environment fallback, so the fill and the reader can never resolve two different Homes.
|
|
375
|
+
const home = options.opencodexHome;
|
|
376
|
+
if (typeof home !== "string" || home.length === 0) throw new Error("fillChildBinaryCacheForVersion: opencodexHome is required");
|
|
377
|
+
if (compareReleaseVersions(options.version, options.version) === null) return { kind: "skipped", reason: "invalid_version" };
|
|
378
|
+
if ((options.platform ?? process.platform) === "win32") return { kind: "skipped", reason: "unsupported_platform" };
|
|
379
|
+
const digests = readDigests(options.packageRoot);
|
|
380
|
+
// A digest file that is there but unusable is not "no digests": the record stays, so a repair still fills.
|
|
381
|
+
if (digests === "invalid") return { kind: "skipped", reason: "invalid_digests" };
|
|
382
|
+
const root = join(home, CHILD_FILL_DIR);
|
|
383
|
+
const dir = childBinaryCacheDir(home, options.version);
|
|
384
|
+
let rootIdentity, lock = null, recorded;
|
|
385
|
+
try {
|
|
386
|
+
assertTrustedAncestors(home);
|
|
387
|
+
if (newerVersionCached(home, options.version)) return { kind: "skipped", reason: "downgrade" };
|
|
388
|
+
// After the Home directory itself passed the ancestor checks and before the fill's directory is
|
|
389
|
+
// created: the startup step claims it for uninstall.
|
|
390
|
+
const refused = options.claimCache?.() ?? null;
|
|
391
|
+
if (refused) return { kind: "skipped", reason: refused };
|
|
392
|
+
rootIdentity = realDirectory(root);
|
|
393
|
+
const early = decideFromRecord(readVersionRecord(root), options.version, digests, dir);
|
|
394
|
+
if (early) return early;
|
|
395
|
+
lock = acquireFillLock(root, rootIdentity, options.now ?? Date.now);
|
|
396
|
+
if (!lock) return { kind: "skipped", reason: "busy" };
|
|
397
|
+
recorded = readVersionRecord(root);
|
|
398
|
+
} catch (error) {
|
|
399
|
+
releaseFillLock(lock);
|
|
400
|
+
// Without digests only the baseline record was at stake: stay silent, as before this lane.
|
|
401
|
+
if (!digests) return { kind: "skipped", reason: "no_digests" };
|
|
402
|
+
throw error;
|
|
403
|
+
}
|
|
404
|
+
try {
|
|
405
|
+
// Decided again under the lock: another start may have recorded meanwhile.
|
|
406
|
+
const settled = decideFromRecord(recorded, options.version, digests, dir);
|
|
407
|
+
if (settled) return settled;
|
|
408
|
+
const record = kind => {
|
|
409
|
+
assertFillLockHeld(lock);
|
|
410
|
+
const versions = join(root, VERSIONS_DIR);
|
|
411
|
+
publish(versions, realDirectory(versions), options.version + "." + kind, Buffer.alloc(0));
|
|
412
|
+
};
|
|
413
|
+
if (!digests) {
|
|
414
|
+
// The baseline a later digest-bearing release needs to recognise its start as an upgrade.
|
|
415
|
+
try { record("baseline"); } catch { /* best effort */ }
|
|
416
|
+
return { kind: "skipped", reason: "no_digests" };
|
|
417
|
+
}
|
|
418
|
+
if (recorded === null) { record("baseline"); return { kind: "skipped", reason: "first_start" }; }
|
|
419
|
+
const sameVersion = compareReleaseVersions(options.version, recorded.version) === 0;
|
|
420
|
+
const identity = realDirectory(dir);
|
|
421
|
+
const fetchImpl = options.fetchImpl ?? fetch;
|
|
422
|
+
const timeoutMs = options.timeoutMs ?? 60_000;
|
|
423
|
+
const fetched = [];
|
|
424
|
+
const failed = [];
|
|
425
|
+
for (const [file, expected] of [...digests].sort(([a], [b]) => (a < b ? -1 : a > b ? 1 : 0))) {
|
|
426
|
+
const present = readCachedBuild(join(dir, file));
|
|
427
|
+
if (present && sha256Hex(present) === expected) continue;
|
|
428
|
+
if (sameVersion) continue;
|
|
429
|
+
const bytes = await download(childReleaseAssetUrl(options.version, file), fetchImpl, timeoutMs);
|
|
430
|
+
if (bytes && sha256Hex(bytes) === expected) {
|
|
431
|
+
publish(dir, identity, file, bytes);
|
|
432
|
+
fetched.push(file);
|
|
433
|
+
} else {
|
|
434
|
+
failed.push(file);
|
|
435
|
+
}
|
|
436
|
+
}
|
|
437
|
+
assertFillLockHeld(lock);
|
|
438
|
+
// Rebuilt from the disk as it is now, so an overlapping fill's verified builds stay listed and a
|
|
439
|
+
// build the release does not vouch for never stays under an older line (the fill deletes no build file;
|
|
440
|
+
// unlisted, the reader refuses it). Lines for targets the release does not list are left as they
|
|
441
|
+
// are: the fill manages only the builds its digests name.
|
|
442
|
+
const verified = verifiedOnDisk(dir, digests);
|
|
443
|
+
const manifest = new Map([...readCacheManifest(dir)].filter(([file]) => !digests.has(file)));
|
|
444
|
+
for (const [file, sha] of verified) manifest.set(file, sha);
|
|
445
|
+
if (manifest.size > 0) publish(dir, identity, "SHA256SUMS", Buffer.from([...manifest].map(([file, sha]) => sha + " " + file + "\n").join("")));
|
|
446
|
+
else unpublish(dir, identity, "SHA256SUMS");
|
|
447
|
+
// An incomplete fill leaves the older record, so the next start of this version retries.
|
|
448
|
+
if (verified.size === digests.size) record("filled");
|
|
449
|
+
// Counted from what is verified on disk now, never from what was written.
|
|
450
|
+
const cached = [...verified.keys()].sort();
|
|
451
|
+
return { kind: "filled", cached, fetched: fetched.filter(file => verified.has(file)), failed: failed.filter(file => !verified.has(file)) };
|
|
452
|
+
} finally {
|
|
453
|
+
releaseFillLock(lock);
|
|
454
|
+
}
|
|
455
|
+
}
|
|
456
|
+
|
|
457
|
+
/** The running package's version, from its own package.json; null when unreadable. */
|
|
458
|
+
export function runningPackageVersion(packageRoot = runningPackageRoot()) {
|
|
459
|
+
try {
|
|
460
|
+
const parsed = JSON.parse(readRegular(join(packageRoot, "package.json"), MAX_MANIFEST_BYTES)?.toString("utf8") ?? "null");
|
|
461
|
+
return typeof parsed?.version === "string" ? parsed.version : null;
|
|
462
|
+
} catch { return null; }
|
|
463
|
+
}
|
|
464
|
+
|
|
465
|
+
/**
|
|
466
|
+
* Startup step (src/server/index.ts): fill the cache for the running version in the background and
|
|
467
|
+
* say what happened in one line. Never throws and never delays the server.
|
|
468
|
+
*/
|
|
469
|
+
export async function fillChildBinaryCacheOnStart(options = {}, out = { log: console.log, warn: console.warn }) {
|
|
470
|
+
let outcome;
|
|
471
|
+
// The documented opt-out (structure/remote-link.md, the Remote Link guide): nothing read or written.
|
|
472
|
+
if (process.env.OCX_DISABLE_CHILD_CACHE_FILL === "1") return { kind: "skipped", reason: "disabled" };
|
|
473
|
+
const packageRoot = options.packageRoot ?? runningPackageRoot();
|
|
474
|
+
const onDisk = runningPackageVersion(packageRoot);
|
|
475
|
+
const version = options.version ?? onDisk ?? "";
|
|
476
|
+
try {
|
|
477
|
+
// A source checkout (a developer's server, the test suite) never fetches a release.
|
|
478
|
+
if (detectInstallFromPath(packageRoot) === "source") return { kind: "skipped", reason: "source_checkout" };
|
|
479
|
+
// A package.json that is not the running code's version (an in-place install still extracting)
|
|
480
|
+
// records nothing: its baseline could suppress that version's upgrade fill.
|
|
481
|
+
if (options.bundledVersion !== undefined && onDisk !== options.bundledVersion) return { kind: "skipped", reason: "version_mismatch" };
|
|
482
|
+
outcome = await fillChildBinaryCacheForVersion({ timeoutMs: 20_000, ...options, packageRoot, version });
|
|
483
|
+
} catch {
|
|
484
|
+
out.warn("[link] the ocx-child builds of this release could not be cached; planting on a bare machine needs a build supplied by hand.");
|
|
485
|
+
return null;
|
|
486
|
+
}
|
|
487
|
+
if (outcome.kind === "filled") {
|
|
488
|
+
const fetched = outcome.fetched.length;
|
|
489
|
+
if (fetched > 0) out.log("[link] cached " + fetched + " verified ocx-child build" + (fetched === 1 ? "" : "s") + " for v" + version + ".");
|
|
490
|
+
if (outcome.failed.length > 0) out.warn("[link] " + outcome.failed.length + " ocx-child build" + (outcome.failed.length === 1 ? "" : "s") + " of this release could not be fetched or did not match the package digests; only verified builds are planted.");
|
|
491
|
+
}
|
|
492
|
+
if (outcome.kind === "skipped" && outcome.reason === "invalid_digests") out.warn("[link] this package's ocx-child digest file could not be read; no ocx-child build was cached.");
|
|
493
|
+
return outcome;
|
|
494
|
+
}
|
|
@@ -0,0 +1,73 @@
|
|
|
1
|
+
import { lstatSync, mkdirSync, readdirSync, rmdirSync } from "node:fs";
|
|
2
|
+
import { join } from "node:path";
|
|
3
|
+
import { getConfigDir } from "../config/paths";
|
|
4
|
+
import { ConfigUninstallInProgressError, configPathOwnership, initializeConfigOwnership, registerOwnedConfigPath } from "../lib/config-ownership";
|
|
5
|
+
import { packageVersion } from "../lib/package-version";
|
|
6
|
+
import { CHILD_FILL_DIR, fillChildBinaryCacheOnStart, type ChildCacheClaimRefusal, type ChildCacheFillOptions, type ChildCacheFillOutcome } from "./child-binary-cache-fill.mjs";
|
|
7
|
+
|
|
8
|
+
/** "absent"; "ours": an empty real directory owned by this user that nobody else can write; else "other". */
|
|
9
|
+
function inspect(path: string): "absent" | "ours" | "other" {
|
|
10
|
+
let st;
|
|
11
|
+
try { st = lstatSync(path); } catch (error) {
|
|
12
|
+
if ((error as NodeJS.ErrnoException).code === "ENOENT") return "absent";
|
|
13
|
+
throw error;
|
|
14
|
+
}
|
|
15
|
+
const uid = typeof process.getuid === "function" ? process.getuid() : null;
|
|
16
|
+
const private_ = st.isDirectory() && !st.isSymbolicLink() && st.uid === uid && (st.mode & 0o022) === 0;
|
|
17
|
+
return private_ && readdirSync(path).length === 0 ? "ours" : "other";
|
|
18
|
+
}
|
|
19
|
+
|
|
20
|
+
/**
|
|
21
|
+
* Claims the fill's own directory, <OPENCODEX_HOME>/ocx-child-builds, for uninstall. The manifest lists
|
|
22
|
+
* it only once OpenCodex has created it: an absent directory is created here (exclusively, 0700) and
|
|
23
|
+
* then registered, and removed again if the registration does not succeed, so a listing always names a
|
|
24
|
+
* directory OpenCodex made or adopted. An unlisted directory is adopted only when it is empty, a real directory,
|
|
25
|
+
* owned by this user and writable by nobody else (what an interruption between creation and
|
|
26
|
+
* registration leaves); any other one was not created by OpenCodex, and the fill leaves it alone
|
|
27
|
+
* (foreign_directory). A failed registration removes only a directory this call created, and a Home whose
|
|
28
|
+
* metadata disappeared between the check and the registration (an uninstall) stops the fill. The operator's cache/ is never claimed or written. A Home without ownership
|
|
29
|
+
* metadata fills as before (its uninstall removes nothing). An uninstall in progress, a full manifest or
|
|
30
|
+
* a busy ownership lock stops this start before any write.
|
|
31
|
+
*/
|
|
32
|
+
export function claimChildBinaryCache(configDir: string): ChildCacheClaimRefusal | null {
|
|
33
|
+
const dir = join(configDir, CHILD_FILL_DIR);
|
|
34
|
+
try {
|
|
35
|
+
let ownership = configPathOwnership(configDir, dir);
|
|
36
|
+
// A Home still empty gets its ownership metadata first, as any other first write would create it.
|
|
37
|
+
if (ownership === "unowned" && initializeConfigOwnership(configDir)) ownership = configPathOwnership(configDir, dir);
|
|
38
|
+
if (ownership !== "unlisted") return null;
|
|
39
|
+
const found = inspect(dir);
|
|
40
|
+
if (found === "other") return "foreign_directory";
|
|
41
|
+
const created = found === "absent";
|
|
42
|
+
if (created) {
|
|
43
|
+
try { mkdirSync(dir, { mode: 0o700 }); } catch { return "foreign_directory"; }
|
|
44
|
+
}
|
|
45
|
+
// The Home was owned a moment ago, so "unowned" now means an uninstall removed its metadata in between.
|
|
46
|
+
let registered: ReturnType<typeof registerOwnedConfigPath> | "failed" = "failed";
|
|
47
|
+
try { registered = registerOwnedConfigPath(configDir, dir); } finally {
|
|
48
|
+
// Only a directory this call created is removed; an adopted one stays as it was found.
|
|
49
|
+
if (registered !== "recorded" && created) { try { rmdirSync(dir); } catch { /* an empty directory left; the next start adopts it */ } }
|
|
50
|
+
}
|
|
51
|
+
if (registered === "unowned") return "uninstall_in_progress";
|
|
52
|
+
return registered === "full" ? "ownership_unavailable" : null;
|
|
53
|
+
} catch (error) {
|
|
54
|
+
return error instanceof ConfigUninstallInProgressError ? "uninstall_in_progress" : "ownership_unavailable";
|
|
55
|
+
}
|
|
56
|
+
}
|
|
57
|
+
|
|
58
|
+
/**
|
|
59
|
+
* The Home's startup step for the ocx-child cache (src/server/index.ts, background work; lane O2).
|
|
60
|
+
* A client runtime does nothing. Otherwise the fill runs its gates (opt-out, source checkout, version,
|
|
61
|
+
* platform, digests, the Home directory's own safety, downgrade) and then, before it writes,
|
|
62
|
+
* {@link claimChildBinaryCache}. The fill gets the running code's own version, so a package.json that
|
|
63
|
+
* does not match it (an install still extracting) records nothing.
|
|
64
|
+
*/
|
|
65
|
+
export async function startChildBinaryCacheFill(
|
|
66
|
+
runtimeRole: string | undefined,
|
|
67
|
+
options: Partial<ChildCacheFillOptions> & { readonly configDir?: string } = {},
|
|
68
|
+
out?: { log: (line: string) => void; warn: (line: string) => void },
|
|
69
|
+
): Promise<ChildCacheFillOutcome | null> {
|
|
70
|
+
if ((runtimeRole ?? "standalone") === "client") return null;
|
|
71
|
+
const { configDir = getConfigDir(), ...fill } = options;
|
|
72
|
+
return fillChildBinaryCacheOnStart({ opencodexHome: configDir, bundledVersion: packageVersion("0.0.0"), claimCache: () => claimChildBinaryCache(configDir), ...fill }, out);
|
|
73
|
+
}
|
|
@@ -2,6 +2,7 @@ import { createHash } from "node:crypto";
|
|
|
2
2
|
import { existsSync, lstatSync, readFileSync } from "node:fs";
|
|
3
3
|
import { homedir } from "node:os";
|
|
4
4
|
import { basename, dirname, join, resolve } from "node:path";
|
|
5
|
+
import { getConfigDir } from "../config/paths";
|
|
5
6
|
import { packageVersion } from "../lib/package-version";
|
|
6
7
|
|
|
7
8
|
export const CHILD_TARGET_TRIPLES = [
|
|
@@ -216,12 +217,18 @@ export function resolveChildBinarySource(
|
|
|
216
217
|
}
|
|
217
218
|
}
|
|
218
219
|
|
|
219
|
-
//
|
|
220
|
-
|
|
220
|
+
// With no Home and no environment passed, the Home is the one the rest of OpenCodex uses (getConfigDir:
|
|
221
|
+
// trimmed, ~ expanded, resolved), which is where the startup fill writes ocx-child-builds/. An injected
|
|
222
|
+
// environment keeps its literal reading. An empty OPENCODEX_HOME counts as unset, as in ocx-child.
|
|
223
|
+
const ocxHome = options.opencodexHome
|
|
224
|
+
|| (options.env ? env.OPENCODEX_HOME?.trim() || join(env.HOME || homedir(), ".opencodex") : getConfigDir());
|
|
221
225
|
const version = options.version ?? packageVersion("0.0.0");
|
|
222
|
-
|
|
223
|
-
|
|
224
|
-
|
|
226
|
+
// A build an operator placed in cache/ocx-child/ first, then the one the Home filled after an update
|
|
227
|
+
// (ocx-child-builds/, src/link/child-binary-cache-fill.mjs); both need a SHA256SUMS that lists them.
|
|
228
|
+
for (const dir of [join(ocxHome, "cache", "ocx-child"), join(ocxHome, "ocx-child-builds")]) {
|
|
229
|
+
const cacheRes = verifyManifestCandidate(join(dir, version, artifactFile), targetTriple, "cache", hostPlatform);
|
|
230
|
+
if (cacheRes) return cacheRes;
|
|
231
|
+
}
|
|
225
232
|
|
|
226
233
|
return { ok: false, reason: "artifact_not_found" };
|
|
227
234
|
}
|