@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
|
@@ -1,22 +1,25 @@
|
|
|
1
|
-
import { DEFAULT_IDLE_AFTER_MS } from "../../link/child-activity";
|
|
1
|
+
import { DEFAULT_IDLE_AFTER_MS, isLinkIdle } from "../../link/child-activity";
|
|
2
|
+
import { readChildPolicy, updateChildPolicy, validPolicyPatch } from "../../link/child-policy";
|
|
2
3
|
import { createCatalogRevisionMonitor, type CatalogRevisionMonitor } from "../../link/child-catalog-freshness";
|
|
3
4
|
import { observeChild } from "../../link/child-observe";
|
|
4
5
|
import { patchChildObservation, readChildObservations, updateChildObservations } from "../../link/child-observations";
|
|
5
|
-
import {
|
|
6
|
+
import { sharedChildOpsEngine, type ChildOpsEngine, type SubmitRefusal, type SubmitResult } from "../../link/child-ops-engine";
|
|
7
|
+
import { CHILD_OPS, CHILD_OPS_MAX_LINK_IDS, type ChildOp, type ChildOpsEnv, type ChildRestart } from "../../link/child-ops-types";
|
|
6
8
|
import { requireRemotePlatform } from "../../link/remote-platform";
|
|
7
9
|
import { inspectRemoteChildRuntime } from "../../link/remote-plant";
|
|
8
|
-
import { attachLinkChildOps, type LinkStatusDto } from "../../link/status-projection";
|
|
10
|
+
import { attachLinkChildOps, projectLinkStatus, type LinkStatusDto } from "../../link/status-projection";
|
|
9
11
|
import type { LinkStore } from "../../link/store";
|
|
10
12
|
import { packageVersion } from "../../lib/package-version";
|
|
11
13
|
import { readCatalog, readCodexCatalogPath } from "../../codex/catalog";
|
|
12
14
|
import type { ManagementContext } from "./context";
|
|
13
15
|
import { readManagementJsonBodyOr } from "./body";
|
|
14
|
-
import { auth,
|
|
16
|
+
import { auth, fail, isRecord, knownHostsFile, readStoreFor, runnerFor, type LinkRouteState } from "./link-route-state";
|
|
15
17
|
|
|
16
18
|
const LINK_ID = /^lnk_[0-9a-f]{16}$/;
|
|
17
19
|
const JOB_ID = /^ljob_[0-9a-f]{16}$/;
|
|
18
|
-
const MAX_LINK_IDS =
|
|
20
|
+
const MAX_LINK_IDS = CHILD_OPS_MAX_LINK_IDS;
|
|
19
21
|
const JOB_PATH = /^\/api\/link\/children\/jobs\/([^/]+)$/;
|
|
22
|
+
const NO_STORE = { "cache-control": "no-store" };
|
|
20
23
|
|
|
21
24
|
let revisionMonitor: CatalogRevisionMonitor | undefined;
|
|
22
25
|
|
|
@@ -36,35 +39,93 @@ export function catalogRevisionForRoutes(): CatalogRevisionMonitor {
|
|
|
36
39
|
});
|
|
37
40
|
}
|
|
38
41
|
|
|
39
|
-
/**
|
|
40
|
-
|
|
41
|
-
|
|
42
|
-
|
|
43
|
-
|
|
44
|
-
|
|
45
|
-
|
|
46
|
-
if (new Set(value.linkIds).size !== value.linkIds.length) return null;
|
|
47
|
-
return { op: "observe", linkIds: value.linkIds as string[] };
|
|
42
|
+
/**
|
|
43
|
+
* One engine per Home process (Revision 5). wp2 kept one per route state, which link-routes.ts keys by the config
|
|
44
|
+
* object, so a config reload started a second engine without the first one's locks, and the wp5 scheduler must submit
|
|
45
|
+
* to the engine the routes read. state.childOps stays the seam a direct test can set.
|
|
46
|
+
*/
|
|
47
|
+
export function childOpsEngineFor(state: LinkRouteState): ChildOpsEngine {
|
|
48
|
+
return state.childOps ??= sharedChildOpsEngine();
|
|
48
49
|
}
|
|
49
50
|
|
|
50
|
-
|
|
51
|
-
|
|
52
|
-
|
|
53
|
-
|
|
51
|
+
const errorName = (error: unknown): string => error instanceof Error ? error.name : "unknown";
|
|
52
|
+
|
|
53
|
+
/** The env captures this request's seams for the job's lifetime; every read is live. wp5 passes the policy idleAfterMs. */
|
|
54
|
+
export function childOpsEnvFor(ctx: ManagementContext, state: LinkRouteState, idleAfterMs = DEFAULT_IDLE_AFTER_MS): ChildOpsEnv {
|
|
55
|
+
const now = ctx.deps.now ?? Date.now;
|
|
56
|
+
const runner = runnerFor(ctx);
|
|
57
|
+
const hosts = knownHostsFile(ctx);
|
|
58
|
+
const homeVersion = packageVersion("0.0.0");
|
|
59
|
+
return {
|
|
54
60
|
readStore: () => readStoreFor(ctx),
|
|
55
|
-
|
|
56
|
-
|
|
57
|
-
|
|
58
|
-
|
|
59
|
-
|
|
60
|
-
|
|
61
|
-
platformOf: link => requireRemotePlatform(runner, link.alias, hosts),
|
|
62
|
-
inspect: inspectRemoteChildRuntime, now,
|
|
63
|
-
});
|
|
61
|
+
runner, knownHostsFile: hosts, homeVersion, now,
|
|
62
|
+
// The wire state the status route reports, including a recorded compensation failure.
|
|
63
|
+
wireState: linkId => {
|
|
64
|
+
if (state.compensationFailures?.has(linkId)) return "failed";
|
|
65
|
+
return projectLinkStatus(readStoreFor(ctx), state.supervisor.status(), state.listener.status(), ctx.config)
|
|
66
|
+
.links.find(link => link.id === linkId)?.state ?? null;
|
|
64
67
|
},
|
|
65
|
-
|
|
66
|
-
|
|
67
|
-
|
|
68
|
+
activity: linkId => {
|
|
69
|
+
const snapshot = state.listener.linkActivity?.(linkId, now());
|
|
70
|
+
return snapshot ? { inFlight: snapshot.inFlight, idle: isLinkIdle(snapshot, now(), idleAfterMs) } : null;
|
|
71
|
+
},
|
|
72
|
+
sleep: ms => Bun.sleep(ms),
|
|
73
|
+
// wp2's observe deps, unchanged: the peer and activity listeners are optional on LinkRouteListener.
|
|
74
|
+
observe: record => observeChild(record, { runner, knownHostsFile: hosts, homeVersion,
|
|
75
|
+
peer: linkId => state.listener.peerObservation?.(linkId) ?? { observed: null, refused: null },
|
|
76
|
+
platformOf: link => requireRemotePlatform(runner, link.alias, link.explicitRoute ?? null, hosts),
|
|
77
|
+
inspect: inspectRemoteChildRuntime, now: () => new Date(now()) }),
|
|
78
|
+
readObservation: linkId => readChildObservations().children[linkId] ?? null,
|
|
79
|
+
// Never throws into a runner: a cache write failure is logged by error name (ChildOpsEnv contract).
|
|
80
|
+
writeObservation: (linkId, patch) => {
|
|
81
|
+
try { updateChildObservations(file => patchChildObservation(file, linkId, patch, new Date(now()))); }
|
|
82
|
+
catch (error) { console.warn(`[link] child observation write failed linkId=${linkId} error=${errorName(error)}`); }
|
|
83
|
+
},
|
|
84
|
+
// Revision 4: wp2's monitor on LinkRouteState.catalogRevision (catalogEtag hashing); null when the catalog cannot be read.
|
|
85
|
+
catalogEtag: () => {
|
|
86
|
+
try { return (state.catalogRevision ??= catalogRevisionForRoutes()).current()?.etag ?? null; } catch { return null; }
|
|
87
|
+
},
|
|
88
|
+
};
|
|
89
|
+
}
|
|
90
|
+
|
|
91
|
+
export interface ParsedOperation { op: ChildOp; linkIds: string[] | "all"; restart: ChildRestart; ignoreActivity?: true }
|
|
92
|
+
|
|
93
|
+
/**
|
|
94
|
+
* Exactly {op, linkIds, restart?}. A2 / M8: any request that carries a restart (sync with restart, or restart-codex,
|
|
95
|
+
* whose restart defaults to app-server) must name its links; "all" is accepted only when restart is "none".
|
|
96
|
+
* Scope (audit r2 R6): this rule binds this API route and the ocx link verbs only; ocx sync --restart-children (040)
|
|
97
|
+
* and the automatic restart policy (050) select links themselves and apply the same run-time activity check.
|
|
98
|
+
* No body can set trigger: the route always submits manual operations. ignoreActivity (D8, the operator's explicit
|
|
99
|
+
* restart past activity) is accepted only as true, on a sync or restart-codex request with a restart and exactly one
|
|
100
|
+
* link id; an update's own restart keeps the activity gate, so the flag is refused there.
|
|
101
|
+
*/
|
|
102
|
+
export function parseOperation(body: unknown): ParsedOperation | null {
|
|
103
|
+
if (!isRecord(body) || Object.keys(body).some(key => key !== "op" && key !== "linkIds" && key !== "restart" && key !== "ignoreActivity")) return null;
|
|
104
|
+
if (!(CHILD_OPS as readonly unknown[]).includes(body.op)) return null;
|
|
105
|
+
const op = body.op as ChildOp;
|
|
106
|
+
if (body.restart !== undefined && body.restart !== "app-server" && body.restart !== "codex") return null;
|
|
107
|
+
if (body.restart !== undefined && op === "observe") return null;
|
|
108
|
+
const restart: ChildRestart = op === "restart-codex" ? (body.restart as ChildRestart | undefined) ?? "app-server"
|
|
109
|
+
: (body.restart as ChildRestart | undefined) ?? "none";
|
|
110
|
+
const ids = body.linkIds;
|
|
111
|
+
let linkIds: string[] | "all";
|
|
112
|
+
if (ids === "all" && restart === "none") linkIds = "all";
|
|
113
|
+
else if (Array.isArray(ids) && ids.length >= 1 && ids.length <= MAX_LINK_IDS
|
|
114
|
+
&& ids.every(id => typeof id === "string" && LINK_ID.test(id)) && new Set(ids).size === ids.length) linkIds = [...ids as string[]];
|
|
115
|
+
else return null;
|
|
116
|
+
if (body.ignoreActivity !== undefined && (body.ignoreActivity !== true || (op !== "sync" && op !== "restart-codex") || restart === "none"
|
|
117
|
+
|| linkIds === "all" || linkIds.length !== 1)) return null;
|
|
118
|
+
return { op, linkIds, restart, ...(body.ignoreActivity === true ? { ignoreActivity: true as const } : {}) };
|
|
119
|
+
}
|
|
120
|
+
|
|
121
|
+
function refusal(code: SubmitRefusal): Response {
|
|
122
|
+
switch (code) {
|
|
123
|
+
case "link_not_found": return fail(code, "The link was not found.", 404);
|
|
124
|
+
case "link_not_home_initiated": return fail(code, "Only a Home-initiated link can be operated from this computer.", 409);
|
|
125
|
+
case "link_operation_in_progress": return fail(code, "Another operation is running on this link.", 409);
|
|
126
|
+
// Returned only when links.json has no link at all, so the message says exactly that.
|
|
127
|
+
case "no_eligible_links": return fail(code, "This Home has no links.", 409);
|
|
128
|
+
}
|
|
68
129
|
}
|
|
69
130
|
|
|
70
131
|
/** `?children=1` on a Home: attach every row's `child` block. Never fails on the cache or the revision save. */
|
|
@@ -76,15 +137,45 @@ export function attachLinkChildOpsForState(dto: LinkStatusDto, state: LinkRouteS
|
|
|
76
137
|
const observations = readChildObservations();
|
|
77
138
|
const known = new Set(store.links.map(link => link.id));
|
|
78
139
|
return attachLinkChildOps(dto, {
|
|
79
|
-
|
|
140
|
+
// The policy threshold governs every idle decision (050 reconciliation item 5).
|
|
141
|
+
homeVersion: packageVersion("0.0.0"), now, idleAfterMs: readChildPolicy().policy.idleAfterMs, revision,
|
|
80
142
|
peerVersion: linkId => state.listener.peerObservation?.(linkId).observed?.version ?? null,
|
|
81
143
|
observation: linkId => known.has(linkId) ? observations.children[linkId] ?? null : null,
|
|
82
144
|
activity: linkId => state.listener.linkActivity?.(linkId, now) ?? null,
|
|
83
145
|
catalogPull: linkId => state.listener.catalogPull?.(linkId) ?? null,
|
|
84
|
-
|
|
146
|
+
// The shared engine: a job the wp5 scheduler started shows on a status read that never submitted one.
|
|
147
|
+
activeJob: linkId => childOpsEngineFor(state).activeJob(linkId),
|
|
148
|
+
// D8: present only on a row whose link WebSocket activity holds keep it in flight.
|
|
149
|
+
holds: linkId => state.listener.linkHolds?.(linkId) ?? null,
|
|
85
150
|
});
|
|
86
151
|
}
|
|
87
152
|
|
|
153
|
+
/**
|
|
154
|
+
* D8: the operator's clear of one link's WebSocket activity holds, including an unknown state left by a crash. Never
|
|
155
|
+
* automatic. Exactly {linkId}; the link must exist in links.json. The holds file is written before anything is forgotten.
|
|
156
|
+
*/
|
|
157
|
+
async function clearActivityHolds(ctx: ManagementContext, state: LinkRouteState): Promise<Response> {
|
|
158
|
+
if (ctx.config.runtimeRole === "client") return fail("runtime_role_client", "A Child runtime does not operate other Children.", 409);
|
|
159
|
+
const body = await readManagementJsonBodyOr(ctx.req, null);
|
|
160
|
+
if (!isRecord(body) || Object.keys(body).some(key => key !== "linkId") || typeof body.linkId !== "string" || !LINK_ID.test(body.linkId)) {
|
|
161
|
+
return fail("invalid_body", "The body must be exactly {linkId}.", 400);
|
|
162
|
+
}
|
|
163
|
+
const linkId = body.linkId;
|
|
164
|
+
let store: LinkStore;
|
|
165
|
+
try { store = readStoreFor(ctx); } catch { return fail("link_unavailable", "The link store could not be read.", 503); }
|
|
166
|
+
if (!store.links.some(link => link.id === linkId)) return fail("link_not_found", "The link was not found.", 404);
|
|
167
|
+
// A listener without the hook cannot clear anything; answering "nothing held" would hide a wiring gap.
|
|
168
|
+
if (!state.listener.clearLinkHolds) return fail("activity_holds_unavailable", "This Home cannot clear link activity holds.", 503);
|
|
169
|
+
const result = state.listener.clearLinkHolds(linkId);
|
|
170
|
+
if (!result.ok) {
|
|
171
|
+
return result.reason === "links-unreadable"
|
|
172
|
+
? fail("link_unavailable", "The links could not be listed, so every link stays held; try again once links.json is readable.", 503)
|
|
173
|
+
: fail("activity_holds_write_failed", "The activity holds could not be saved; nothing was cleared.", 503);
|
|
174
|
+
}
|
|
175
|
+
if (result.cleared) console.log(`[link] activity holds cleared by the operator linkId=${linkId} holds=${result.cleared.holds.length} unknown=${result.cleared.unknown ?? "none"}`);
|
|
176
|
+
return Response.json({ linkId, cleared: result.cleared }, { headers: NO_STORE });
|
|
177
|
+
}
|
|
178
|
+
|
|
88
179
|
export async function handleLinkChildOpsRoutes(ctx: ManagementContext, state: LinkRouteState): Promise<Response | null> {
|
|
89
180
|
const { url, req } = ctx;
|
|
90
181
|
const path = url.pathname;
|
|
@@ -93,24 +184,35 @@ export async function handleLinkChildOpsRoutes(ctx: ManagementContext, state: Li
|
|
|
93
184
|
if (url.pathname === "/api/link/children/operations" && req.method === "POST") {
|
|
94
185
|
if (ctx.config.runtimeRole === "client") return fail("runtime_role_client", "A Child runtime does not operate other Children.", 409);
|
|
95
186
|
const operation = parseOperation(await readManagementJsonBodyOr(req, null));
|
|
96
|
-
if (!operation) return fail("invalid_body", "The body must be exactly {op
|
|
97
|
-
let result:
|
|
98
|
-
try {
|
|
99
|
-
|
|
100
|
-
|
|
101
|
-
|
|
102
|
-
|
|
103
|
-
|
|
104
|
-
|
|
187
|
+
if (!operation) return fail("invalid_body", "The body must be exactly {op, linkIds, restart?}; restart is app-server or codex and needs explicit linkIds.", 400);
|
|
188
|
+
let result: SubmitResult;
|
|
189
|
+
try { result = childOpsEngineFor(state).submit({ ...operation, trigger: "manual" }, childOpsEnvFor(ctx, state, readChildPolicy().policy.idleAfterMs)); }
|
|
190
|
+
catch { return fail("link_unavailable", "The link store could not be read.", 503); }
|
|
191
|
+
return result.ok ? Response.json({ job: result.job }, { status: 202, headers: NO_STORE }) : refusal(result.code);
|
|
192
|
+
}
|
|
193
|
+
// 050: the Child policy. The handler-wide auth above admits a dashboard session or the admin token on loopback.
|
|
194
|
+
if (url.pathname === "/api/link/children/policy" && req.method === "GET") return Response.json(readChildPolicy(), { headers: NO_STORE });
|
|
195
|
+
if (url.pathname === "/api/link/children/policy" && req.method === "PUT") {
|
|
196
|
+
// Same refusal as POST operations: a Child's policy file would govern nothing.
|
|
197
|
+
if (ctx.config.runtimeRole === "client") return fail("runtime_role_client", "A Child runtime does not operate other Children.", 409);
|
|
198
|
+
const body = await readManagementJsonBodyOr(req, null);
|
|
199
|
+
const patch = isRecord(body) && Object.keys(body).length > 0 ? validPolicyPatch(body) : null;
|
|
200
|
+
if (!patch) return fail("invalid_body", "Send one or more of catalogFanout, childCodexRestart, updates, idleAfterMs with valid values.", 400);
|
|
201
|
+
try { return Response.json({ policy: updateChildPolicy(patch), warning: null }, { headers: NO_STORE }); }
|
|
202
|
+
catch { return fail("policy_write_failed", "The Child policy could not be saved.", 503); }
|
|
203
|
+
}
|
|
204
|
+
// D8: the operator clears one link's WebSocket activity holds.
|
|
205
|
+
if (url.pathname === "/api/link/children/activity/clear" && req.method === "POST") {
|
|
206
|
+
return clearActivityHolds(ctx, state);
|
|
105
207
|
}
|
|
106
208
|
const jobPath = req.method === "GET" ? JOB_PATH.exec(path) : null;
|
|
107
209
|
if (jobPath) {
|
|
108
210
|
let jobId: string;
|
|
109
211
|
try { jobId = decodeURIComponent(jobPath[1]!); } catch { return fail("invalid_job_id", "The job id is invalid.", 400); }
|
|
110
212
|
if (!JOB_ID.test(jobId)) return fail("invalid_job_id", "The job id is invalid.", 400);
|
|
111
|
-
const job = state.
|
|
213
|
+
const job = childOpsEngineFor(state).job(jobId);
|
|
112
214
|
if (!job) return fail("job_not_found", "The job was not found.", 404);
|
|
113
|
-
return Response.json({ job }, { headers:
|
|
215
|
+
return Response.json({ job }, { headers: NO_STORE });
|
|
114
216
|
}
|
|
115
217
|
return fail("not_found", "Not found.", 404);
|
|
116
218
|
}
|
|
@@ -30,6 +30,37 @@ export function childConfigFailureHint(result: { code: number; stderr: string })
|
|
|
30
30
|
return "ocx config show --json on the Child did not print a configuration with a valid port";
|
|
31
31
|
}
|
|
32
32
|
|
|
33
|
+
|
|
34
|
+
/**
|
|
35
|
+
* Why a full Child cannot be enrolled as it stands, and the Child command that fixes it. Each of
|
|
36
|
+
* these used to share one phase name ("Child restart preflight"), which left the Home operator to
|
|
37
|
+
* reproduce the probe over SSH. Kept under the 160 code point hint cap.
|
|
38
|
+
*/
|
|
39
|
+
export function childRoleRefusalHint(runtimeRole: unknown): string {
|
|
40
|
+
return runtimeRole === "client"
|
|
41
|
+
? "The Child is still linked to a Home (config runtimeRole client). To end that link and move it here, on the Child run: ocx disconnect, then ocx restart."
|
|
42
|
+
: `The Child is a Hub (config runtimeRole ${runtimeRole === "hub" ? "hub" : "unknown"}). On the Child run: ocx hub disable, then retry.`;
|
|
43
|
+
}
|
|
44
|
+
|
|
45
|
+
export function childHealthRefusalHint(health: unknown, port: number): string {
|
|
46
|
+
const body = health && typeof health === "object" && !Array.isArray(health) ? health as Record<string, unknown> : null;
|
|
47
|
+
if (!body || body.service !== "opencodex") {
|
|
48
|
+
return `No OpenCodex answered /healthz on the Child's port ${port}. On the Child run: ocx start (or ocx service start).`;
|
|
49
|
+
}
|
|
50
|
+
if (body.port !== port) {
|
|
51
|
+
const seen = typeof body.port === "number" ? String(body.port) : "another port";
|
|
52
|
+
return `The Child's runtime answers as port ${seen} but its config port is ${port}. On the Child run: ocx restart.`;
|
|
53
|
+
}
|
|
54
|
+
if (body.role === "client") {
|
|
55
|
+
return `The Child still serves a client runtime (/healthz role client on port ${port}). On the Child run: ocx restart.`;
|
|
56
|
+
}
|
|
57
|
+
if (body.role !== undefined && body.role !== "standalone") {
|
|
58
|
+
return `The Child serves a Hub runtime (/healthz role hub on port ${port}). On the Child run: ocx hub disable, then ocx restart.`;
|
|
59
|
+
}
|
|
60
|
+
return `The Child's runtime advertises no restart capability v1 on port ${port}. Update OpenCodex on the Child, then run: ocx restart.`;
|
|
61
|
+
}
|
|
62
|
+
|
|
63
|
+
|
|
33
64
|
/** `ocx config validate --json` prints one small object; this bounds a misbehaving Child. */
|
|
34
65
|
export const CHILD_CONFIG_VALIDATE_MAX_OUTPUT_BYTES = 16 * 1024;
|
|
35
66
|
|
|
@@ -0,0 +1,29 @@
|
|
|
1
|
+
import { LINK_DIAGNOSTICS_DEFAULT_LIMIT, LINK_DIAGNOSTICS_MAX_LIMIT, LINK_DIAGNOSTICS_SCHEMA, readLinkDiagnostics } from "../../link/diagnostics-read";
|
|
2
|
+
|
|
3
|
+
export const LINK_DIAGNOSTICS_ROUTE = "/api/link/diagnostics";
|
|
4
|
+
|
|
5
|
+
function integerParam(url: URL, name: string, min: number, max: number): number | undefined | null {
|
|
6
|
+
const raw = url.searchParams.get(name);
|
|
7
|
+
if (raw === null) return undefined;
|
|
8
|
+
if (!/^\d{1,16}$/.test(raw)) return null;
|
|
9
|
+
const value = Number(raw);
|
|
10
|
+
return Number.isSafeInteger(value) && value >= min && value <= max ? value : null;
|
|
11
|
+
}
|
|
12
|
+
|
|
13
|
+
/**
|
|
14
|
+
* The body of `GET /api/link/diagnostics`: this runtime's bounded link diagnostics, re-sanitized
|
|
15
|
+
* on read by `readLinkDiagnostics`. It reads the file and nothing else, needs no link lifecycle,
|
|
16
|
+
* and omits the local file path. Callers authorize first: `link-routes.ts` on a standalone, Home
|
|
17
|
+
* or Hub, and `src/client/machine-listener.ts` (dashboard session only) on a connected Child.
|
|
18
|
+
* Kept free of the link route state so the Child's listener can serve it without that graph.
|
|
19
|
+
*/
|
|
20
|
+
export async function linkDiagnosticsResponse(url: URL): Promise<Response> {
|
|
21
|
+
const limit = integerParam(url, "limit", 1, LINK_DIAGNOSTICS_MAX_LIMIT);
|
|
22
|
+
const since = integerParam(url, "since", 0, Number.MAX_SAFE_INTEGER);
|
|
23
|
+
if (limit === null || since === null) {
|
|
24
|
+
return Response.json({ error: { code: "invalid_query", message: "limit must be 1-" + LINK_DIAGNOSTICS_MAX_LIMIT + " and since a non-negative epoch-millisecond time." } },
|
|
25
|
+
{ status: 400, headers: { "cache-control": "no-store" } });
|
|
26
|
+
}
|
|
27
|
+
const result = await readLinkDiagnostics({ limit: limit ?? LINK_DIAGNOSTICS_DEFAULT_LIMIT, since });
|
|
28
|
+
return Response.json({ schema: LINK_DIAGNOSTICS_SCHEMA, ...result }, { headers: { "cache-control": "no-store" } });
|
|
29
|
+
}
|