machine-bridge-mcp 2.0.0 → 3.0.0-beta.102
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/CHANGELOG.md +1142 -0
- package/CONTRIBUTING.md +23 -25
- package/GOVERNANCE.md +2 -2
- package/README.md +58 -20
- package/SECURITY.md +161 -120
- package/SUPPORT.md +1 -1
- package/browser-extension/broker-auth.js +83 -0
- package/browser-extension/broker-liveness.js +35 -0
- package/browser-extension/browser-error-boundary.js +96 -0
- package/browser-extension/browser-operations.js +1456 -101
- package/browser-extension/devtools-input.js +195 -34
- package/browser-extension/devtools-observation.js +429 -0
- package/browser-extension/devtools-session.js +48 -0
- package/browser-extension/manifest.json +4 -3
- package/browser-extension/page-automation.js +578 -118
- package/browser-extension/pairing-bootstrap.js +42 -0
- package/browser-extension/pairing.js +28 -12
- package/browser-extension/service-worker.js +126 -106
- package/docs/AGENT_CONTEXT.md +13 -10
- package/docs/ARCHITECTURE.md +159 -67
- package/docs/AUDIT.md +1302 -4
- package/docs/CLIENTS.md +19 -6
- package/docs/COMPUTER_USE.md +297 -0
- package/docs/ENGINEERING.md +72 -13
- package/docs/GETTING_STARTED.md +18 -20
- package/docs/LOCAL_AUTHORIZATION.md +115 -72
- package/docs/LOCAL_AUTOMATION.md +27 -21
- package/docs/LOGGING.md +40 -19
- package/docs/MANAGED_JOBS.md +37 -34
- package/docs/MULTI_ACCOUNT.md +98 -37
- package/docs/OPERATIONS.md +145 -51
- package/docs/OVERVIEW.md +14 -11
- package/docs/POLICY_REFERENCE.md +71 -3
- package/docs/PRIVACY.md +41 -2
- package/docs/PROJECT_STANDARDS.md +29 -6
- package/docs/RELEASING.md +238 -64
- package/docs/TESTING.md +150 -39
- package/docs/THREAT_MODEL.md +164 -67
- package/docs/TOOL_REFERENCE.md +653 -60
- package/docs/UPGRADING.md +78 -18
- package/native/macos/MachineBridgeBackgroundInput.swift +1051 -0
- package/native/macos/MachineBridgeBackgroundInputSmokeFixture.swift +295 -0
- package/native/macos/MachineBridgeTrustBroker.swift +233 -0
- package/package.json +94 -16
- package/scripts/accepted-candidate-tarball.mjs +77 -0
- package/scripts/candidate-runtime-store.mjs +93 -0
- package/scripts/check-plan.mjs +73 -3
- package/scripts/check-runner.mjs +129 -17
- package/scripts/commit-message-check.mjs +5 -2
- package/scripts/consumer-package-security.mjs +293 -0
- package/scripts/coverage-check.mjs +251 -15
- package/scripts/coverage-generation.mjs +41 -0
- package/scripts/coverage-range-merge.mjs +41 -0
- package/scripts/foreground-daemon-recovery.mjs +88 -0
- package/scripts/generate-policy-reference.mjs +28 -5
- package/scripts/generate-tool-reference.mjs +1 -1
- package/scripts/generate-worker-types.mjs +21 -11
- package/scripts/github-backlog.mjs +11 -10
- package/scripts/github-push.mjs +62 -16
- package/scripts/github-release-asset.mjs +58 -0
- package/scripts/github-release.mjs +241 -132
- package/scripts/global-package-installation.mjs +68 -0
- package/scripts/hardened-npm-session.mjs +42 -0
- package/scripts/install-published-prerelease.mjs +198 -0
- package/scripts/local-release-acceptance.mjs +103 -45
- package/scripts/macos-background-input-smoke.mjs +515 -0
- package/scripts/network-retry.mjs +8 -1
- package/scripts/npm-global-prefix.mjs +27 -0
- package/scripts/npm-publication-policy.mjs +17 -0
- package/scripts/official-mcp-conformance.mjs +267 -0
- package/scripts/persistent-activation-process.mjs +101 -0
- package/scripts/prepare-pinned-npm.mjs +12 -69
- package/scripts/prerelease-activation.mjs +160 -0
- package/scripts/privacy-check.mjs +14 -6
- package/scripts/promotion-digest.mjs +128 -0
- package/scripts/publish-npm.mjs +260 -0
- package/scripts/published-release.mjs +132 -0
- package/scripts/release-acceptance.mjs +62 -54
- package/scripts/release-browser-extension-store.mjs +172 -0
- package/scripts/release-candidate-manifest.mjs +52 -0
- package/scripts/release-channel.mjs +106 -0
- package/scripts/release-diagnostic.mjs +41 -0
- package/scripts/release-impact-check.mjs +12 -22
- package/scripts/release-oauth-canary-core.mjs +325 -0
- package/scripts/release-oauth-canary-evidence.mjs +100 -0
- package/scripts/release-oauth-canary.mjs +127 -0
- package/scripts/release-publication-guard.mjs +67 -0
- package/scripts/release-soak.mjs +284 -0
- package/scripts/release-state.mjs +1 -1
- package/scripts/run-checks.mjs +44 -7
- package/scripts/run-worker-dry-run.mjs +21 -0
- package/scripts/sarif-security-gate.mjs +2 -1
- package/scripts/sbom-check.mjs +106 -0
- package/scripts/start-release-candidate.mjs +267 -44
- package/scripts/syntax-check.mjs +36 -14
- package/scripts/verification-generation-guard.mjs +15 -0
- package/scripts/verification-idle-sleep-guard.mjs +37 -0
- package/scripts/verification-state.mjs +108 -0
- package/scripts/wrangler-command-lifecycle.mjs +115 -0
- package/src/local/account-access.mjs +13 -1
- package/src/local/account-admin-response.mjs +92 -0
- package/src/local/account-admin.mjs +52 -19
- package/src/local/agent-context-projection.mjs +26 -7
- package/src/local/agent-context.mjs +88 -49
- package/src/local/agent-skill-discovery.mjs +16 -5
- package/src/local/app-automation-macos-jxa.mjs +350 -0
- package/src/local/app-automation.mjs +873 -163
- package/src/local/application-capability-projection.mjs +24 -0
- package/src/local/authority-context.mjs +106 -0
- package/src/local/autostart-log-maintenance.mjs +36 -0
- package/src/local/browser-bridge-http.mjs +5 -3
- package/src/local/browser-bridge.mjs +109 -31
- package/src/local/browser-broker-auth-http.mjs +67 -0
- package/src/local/browser-broker-auth.mjs +98 -0
- package/src/local/browser-broker-routes.mjs +63 -20
- package/src/local/browser-broker-server.mjs +17 -7
- package/src/local/browser-command.mjs +79 -30
- package/src/local/browser-computer-observation-service.mjs +266 -0
- package/src/local/browser-extension-identity.mjs +50 -0
- package/src/local/browser-extension-path.mjs +22 -0
- package/src/local/browser-extension-protocol.mjs +50 -11
- package/src/local/browser-operation-service.mjs +147 -117
- package/src/local/browser-pairing-grant.mjs +109 -0
- package/src/local/browser-pairing-http.mjs +36 -0
- package/src/local/browser-pairing-launch.mjs +58 -0
- package/src/local/browser-pairing-store.mjs +85 -48
- package/src/local/browser-request-registry.mjs +40 -14
- package/src/local/browser-request-settlement.mjs +78 -0
- package/src/local/browser-resource-input.mjs +74 -0
- package/src/local/browser-trusted-input-health.mjs +63 -0
- package/src/local/call-authority.mjs +21 -0
- package/src/local/call-capacity.mjs +45 -0
- package/src/local/call-registry-drain.mjs +54 -0
- package/src/local/call-registry.mjs +30 -15
- package/src/local/capability-observer.mjs +5 -0
- package/src/local/capability-ranking.mjs +3 -2
- package/src/local/child-process-settlement.mjs +132 -0
- package/src/local/cli-account-admin.mjs +40 -6
- package/src/local/cli-activate.mjs +162 -0
- package/src/local/cli-local-admin.mjs +20 -45
- package/src/local/cli-options.mjs +12 -13
- package/src/local/cli-ready-output.mjs +52 -0
- package/src/local/cli-service.mjs +91 -11
- package/src/local/cli.mjs +232 -150
- package/src/local/computer-use-application-observation.mjs +224 -0
- package/src/local/computer-use-arguments.mjs +270 -0
- package/src/local/computer-use-deadline.mjs +50 -0
- package/src/local/computer-use-dispatch-settlement.mjs +40 -0
- package/src/local/computer-use-expectation.mjs +171 -0
- package/src/local/computer-use-observation.mjs +769 -0
- package/src/local/computer-use-recovery.mjs +82 -0
- package/src/local/computer-use-result-budget.mjs +145 -0
- package/src/local/computer-use-snapshot-store.mjs +67 -0
- package/src/local/computer-use.mjs +2255 -0
- package/src/local/daemon-http-relay-auth.mjs +26 -0
- package/src/local/daemon-http-relay-connection.mjs +298 -0
- package/src/local/daemon-http-relay-request.mjs +64 -0
- package/src/local/daemon-http-relay-sequence.mjs +49 -0
- package/src/local/daemon-process.mjs +40 -7
- package/src/local/delegated-process-sandbox.mjs +148 -0
- package/src/local/device-identity.mjs +156 -49
- package/src/local/device-root-provider.mjs +81 -0
- package/src/local/directory-metadata.mjs +47 -0
- package/src/local/doctor-reporting.mjs +23 -0
- package/src/local/durable-process-spec.mjs +80 -0
- package/src/local/errors.mjs +25 -15
- package/src/local/exclusive-file.mjs +74 -26
- package/src/local/execution-limits.mjs +9 -0
- package/src/local/execution-routing.mjs +276 -0
- package/src/local/execution-surface.mjs +23 -0
- package/src/local/file-mutation-coordinator.mjs +47 -0
- package/src/local/file-snapshot-preservation.mjs +24 -0
- package/src/local/filesystem-identity.mjs +54 -0
- package/src/local/fixed-process-environment.mjs +21 -0
- package/src/local/full-access-test.mjs +31 -13
- package/src/local/git-commit.mjs +69 -0
- package/src/local/git-config-safety.mjs +55 -0
- package/src/local/git-log-parser.mjs +41 -0
- package/src/local/git-metadata-boundary.mjs +77 -0
- package/src/local/git-metadata-tree-safety.mjs +59 -0
- package/src/local/git-operation-state.mjs +19 -0
- package/src/local/git-service.mjs +165 -30
- package/src/local/hardened-npm-download-timeout.mjs +46 -0
- package/src/local/hardened-npm-download.mjs +109 -0
- package/src/local/hardened-npm-extract.mjs +20 -0
- package/src/local/hardened-npm-verification.mjs +104 -0
- package/src/local/hardened-npm.mjs +199 -0
- package/src/local/job-runner.mjs +244 -89
- package/src/local/lifecycle.mjs +6 -0
- package/src/local/log.mjs +19 -45
- package/src/local/macos-background-input.mjs +398 -0
- package/src/local/macos-idle-sleep-assertion.mjs +65 -0
- package/src/local/macos-trust-broker.mjs +404 -0
- package/src/local/managed-job-cancellation.mjs +42 -0
- package/src/local/managed-job-capacity.mjs +16 -0
- package/src/local/managed-job-directory-generation.mjs +60 -0
- package/src/local/managed-job-directory.mjs +75 -0
- package/src/local/managed-job-durable-process.mjs +49 -0
- package/src/local/managed-job-lock.mjs +46 -14
- package/src/local/managed-job-plan.mjs +38 -14
- package/src/local/managed-job-projection.mjs +23 -15
- package/src/local/managed-job-retention.mjs +128 -0
- package/src/local/managed-job-runner-claim.mjs +70 -0
- package/src/local/managed-job-runner.mjs +35 -10
- package/src/local/managed-job-storage.mjs +22 -6
- package/src/local/managed-job-terminal-maintenance.mjs +40 -0
- package/src/local/managed-job-terminal.mjs +150 -0
- package/src/local/managed-jobs.mjs +424 -287
- package/src/local/npm-cli.mjs +42 -0
- package/src/local/npm-environment.mjs +37 -0
- package/src/local/operation-authorization.mjs +68 -324
- package/src/local/operation-risk.mjs +51 -4
- package/src/local/owner-state-lock.mjs +118 -0
- package/src/local/package-identity.mjs +9 -0
- package/src/local/patch.mjs +20 -18
- package/src/local/path-inspection.mjs +23 -0
- package/src/local/policy.mjs +19 -0
- package/src/local/private-toolchain-integrity.mjs +54 -0
- package/src/local/process-execution.mjs +87 -75
- package/src/local/process-foreground-timeout.mjs +50 -0
- package/src/local/process-identity.mjs +41 -7
- package/src/local/process-nonreplayable-settlement.mjs +50 -0
- package/src/local/process-result-projection.mjs +22 -0
- package/src/local/process-session-events.mjs +47 -0
- package/src/local/process-session-remote-activity.mjs +10 -0
- package/src/local/process-session-termination.mjs +73 -0
- package/src/local/process-sessions.mjs +144 -112
- package/src/local/process-tracker.mjs +140 -13
- package/src/local/process-tree-ownership-types.d.ts +37 -0
- package/src/local/process-tree-ownership.mjs +57 -0
- package/src/local/process-tree-signal.mjs +34 -0
- package/src/local/process-tree-snapshot.mjs +77 -0
- package/src/local/process-tree-supervisor.mjs +69 -0
- package/src/local/process-tree.mjs +11 -53
- package/src/local/project-metadata.mjs +19 -6
- package/src/local/relay-call-recovery.mjs +58 -38
- package/src/local/relay-connection-classification.mjs +131 -0
- package/src/local/relay-connection-support.mjs +91 -0
- package/src/local/relay-connection.mjs +179 -272
- package/src/local/relay-diagnostics.mjs +91 -0
- package/src/local/relay-heartbeat.mjs +119 -0
- package/src/local/relay-liveness.mjs +109 -0
- package/src/local/relay-peer-diagnostics.mjs +29 -0
- package/src/local/release-runtime-lock.mjs +18 -0
- package/src/local/remote-activity-idle-sleep-guard.mjs +77 -0
- package/src/local/remote-configuration.mjs +48 -0
- package/src/local/resilient-relay-connection.mjs +178 -0
- package/src/local/resource-admission-diagnostics.mjs +52 -0
- package/src/local/resource-admission-policy.mjs +115 -0
- package/src/local/resource-admission.mjs +339 -0
- package/src/local/resource-build-root.mjs +83 -0
- package/src/local/resource-cargo-concurrency.mjs +38 -0
- package/src/local/resource-cmake-concurrency.mjs +42 -0
- package/src/local/resource-command-concurrency.mjs +37 -0
- package/src/local/resource-command-profile.mjs +176 -0
- package/src/local/resource-coordinator-accounting.mjs +21 -0
- package/src/local/resource-cpu-window.mjs +20 -0
- package/src/local/resource-disk-headroom.mjs +13 -0
- package/src/local/resource-elastic-memory.mjs +19 -0
- package/src/local/resource-elastic-request.mjs +36 -0
- package/src/local/resource-foreground-wait.mjs +29 -0
- package/src/local/resource-go-concurrency.mjs +43 -0
- package/src/local/resource-gradle-concurrency.mjs +57 -0
- package/src/local/resource-host-cache.mjs +39 -0
- package/src/local/resource-host-darwin.mjs +54 -0
- package/src/local/resource-host-linux.mjs +35 -0
- package/src/local/resource-host-sample-file.mjs +23 -0
- package/src/local/resource-host-snapshot.mjs +99 -0
- package/src/local/resource-lease-accounting.mjs +119 -0
- package/src/local/resource-light-command.mjs +6 -0
- package/src/local/resource-make-concurrency.mjs +42 -0
- package/src/local/resource-maven-concurrency.mjs +38 -0
- package/src/local/resource-ninja-command-concurrency.mjs +20 -0
- package/src/local/resource-ninja-concurrency.mjs +28 -0
- package/src/local/resource-operations.mjs +26 -10
- package/src/local/resource-pressure.mjs +67 -0
- package/src/local/resource-probe-command.mjs +35 -0
- package/src/local/resource-process-admission.mjs +59 -0
- package/src/local/resource-process-ancestry-cache.mjs +43 -0
- package/src/local/resource-process-ancestry.mjs +32 -0
- package/src/local/resource-process-priority.mjs +15 -0
- package/src/local/resource-project-key.mjs +53 -0
- package/src/local/resource-pytest-concurrency.mjs +33 -0
- package/src/local/resource-release-control-classification.mjs +14 -0
- package/src/local/resource-release-control-executable.mjs +70 -0
- package/src/local/resource-release-control-workspace.mjs +41 -0
- package/src/local/resource-request-contract.mjs +30 -0
- package/src/local/resource-script-classification.mjs +44 -0
- package/src/local/resource-shell-analysis.mjs +58 -0
- package/src/local/resource-staging-recovery.mjs +97 -0
- package/src/local/resource-swift-concurrency.mjs +31 -0
- package/src/local/resource-transaction-lock.mjs +189 -0
- package/src/local/resource-wait.mjs +48 -0
- package/src/local/resource-waiters.mjs +139 -0
- package/src/local/resource-xcode-command.mjs +7 -0
- package/src/local/resource-xcode-concurrency.mjs +34 -0
- package/src/local/resource-xcode-non-build.mjs +19 -0
- package/src/local/runtime-activation.mjs +700 -0
- package/src/local/runtime-activity-projection.mjs +48 -0
- package/src/local/runtime-capabilities.mjs +48 -15
- package/src/local/runtime-diagnostic-state.mjs +14 -0
- package/src/local/runtime-diagnostics.mjs +40 -13
- package/src/local/runtime-info-projection.mjs +60 -0
- package/src/local/runtime-info-relay-projection.mjs +21 -0
- package/src/local/runtime-paths.mjs +2 -1
- package/src/local/runtime-process-routing.mjs +33 -0
- package/src/local/runtime-relay-connection-options.mjs +44 -0
- package/src/local/runtime-relay-control.mjs +98 -0
- package/src/local/runtime-relay.mjs +26 -50
- package/src/local/runtime-reporting.mjs +37 -21
- package/src/local/runtime-resource-service.mjs +77 -0
- package/src/local/runtime-tool-handlers.mjs +13 -10
- package/src/local/runtime.mjs +244 -208
- package/src/local/secure-file.mjs +73 -20
- package/src/local/security-audit-dispatch.mjs +35 -0
- package/src/local/security-audit-log.mjs +215 -0
- package/src/local/security-audit-state.mjs +139 -0
- package/src/local/security-audit-storage.mjs +135 -0
- package/src/local/security-audit-warning.mjs +31 -0
- package/src/local/security-audit-worker.mjs +87 -0
- package/src/local/service-convergence.mjs +42 -1
- package/src/local/service-definition.mjs +24 -0
- package/src/local/service-environment.mjs +18 -10
- package/src/local/service-owner.mjs +146 -0
- package/src/local/service-ownership.mjs +17 -0
- package/src/local/service-restart-handoff.mjs +64 -0
- package/src/local/service-restart-scheduler.mjs +49 -0
- package/src/local/service-runtime-convergence.mjs +52 -0
- package/src/local/service-runtime.mjs +105 -0
- package/src/local/service-status.mjs +60 -0
- package/src/local/service.mjs +385 -92
- package/src/local/shell.mjs +39 -19
- package/src/local/ssh-key.mjs +158 -42
- package/src/local/state-inventory.mjs +50 -24
- package/src/local/state-owner-lock-inventory.mjs +23 -0
- package/src/local/state-root-owned-namespaces.mjs +83 -0
- package/src/local/state-root-retirement.mjs +89 -0
- package/src/local/state.mjs +386 -96
- package/src/local/stdio.mjs +96 -66
- package/src/local/support-state-projection.mjs +30 -0
- package/src/local/system-network-route.mjs +76 -0
- package/src/local/systemd-removal.mjs +20 -0
- package/src/local/tool-executor.mjs +85 -20
- package/src/local/tool-result-boundary.mjs +51 -0
- package/src/local/toolchain-operation-lock.mjs +41 -0
- package/src/local/tools.mjs +7 -5
- package/src/local/trusted-executable.mjs +53 -0
- package/src/local/trusted-git-executable.mjs +34 -0
- package/src/local/trusted-github-cli.mjs +24 -0
- package/src/local/windows-service-convergence.mjs +49 -0
- package/src/local/windows-service.mjs +52 -45
- package/src/local/worker-deployment-fingerprint.mjs +102 -0
- package/src/local/worker-deployment.mjs +48 -60
- package/src/local/worker-health.mjs +12 -4
- package/src/local/worker-secret-file.mjs +37 -17
- package/src/local/workspace-file-service.mjs +156 -239
- package/src/local/workspace-file-transaction.mjs +189 -0
- package/src/local/workspace-search.mjs +55 -0
- package/src/local/wrangler-toolchain/package-lock.json +1505 -0
- package/src/local/wrangler-toolchain/package.json +23 -0
- package/src/local/wrangler-toolchain-verification.mjs +135 -0
- package/src/local/wrangler-toolchain.mjs +188 -0
- package/src/shared/access-contract.json +7 -1
- package/src/shared/activation-recovery.mjs +49 -0
- package/src/shared/admin-auth.d.mts +2 -1
- package/src/shared/admin-auth.mjs +3 -3
- package/src/shared/authority-revocation.d.mts +9 -0
- package/src/shared/authority-revocation.mjs +28 -0
- package/src/shared/daemon-auth.d.mts +11 -0
- package/src/shared/daemon-auth.mjs +17 -0
- package/src/shared/device-session-auth.d.mts +20 -0
- package/src/shared/device-session-auth.mjs +51 -0
- package/src/shared/foreground-timeout.d.mts +15 -0
- package/src/shared/foreground-timeout.mjs +70 -0
- package/src/shared/log-redaction.d.mts +9 -0
- package/src/shared/log-redaction.mjs +51 -0
- package/src/shared/mcp-protocol.d.mts +27 -0
- package/src/shared/mcp-protocol.mjs +275 -0
- package/src/shared/project-overview-projection.d.mts +4 -0
- package/src/shared/project-overview-projection.mjs +96 -0
- package/src/shared/relay-contract.json +28 -0
- package/src/shared/result-projection.d.mts +2 -1
- package/src/shared/result-projection.mjs +13 -2
- package/src/shared/server-metadata.json +15 -9
- package/src/shared/tool-argument-validation.d.mts +17 -0
- package/src/shared/tool-argument-validation.mjs +325 -0
- package/src/shared/tool-call-capacity.d.mts +41 -0
- package/src/shared/tool-call-capacity.mjs +59 -0
- package/src/shared/tool-catalog.json +626 -57
- package/src/worker/access.ts +12 -0
- package/src/worker/account-admin.ts +55 -33
- package/src/worker/authority-revocations.ts +174 -0
- package/src/worker/authority.ts +52 -6
- package/src/worker/daemon-auth.ts +49 -68
- package/src/worker/daemon-channel.ts +36 -0
- package/src/worker/daemon-http-auth.ts +63 -0
- package/src/worker/daemon-http-channel.ts +120 -0
- package/src/worker/daemon-http-controller.ts +163 -0
- package/src/worker/daemon-http-protocol.ts +62 -0
- package/src/worker/daemon-http-registry.ts +82 -0
- package/src/worker/daemon-last-observation.ts +30 -0
- package/src/worker/daemon-liveness.ts +8 -6
- package/src/worker/daemon-ready-dispatch.ts +17 -0
- package/src/worker/daemon-ready-messages.ts +73 -0
- package/src/worker/daemon-ready-waiters.ts +79 -0
- package/src/worker/daemon-recovery-budget.ts +13 -0
- package/src/worker/daemon-registry.ts +58 -0
- package/src/worker/daemon-relay-diagnostics.ts +127 -0
- package/src/worker/daemon-socket-attachment.ts +55 -0
- package/src/worker/daemon-sockets.ts +72 -62
- package/src/worker/daemon-status.ts +38 -0
- package/src/worker/device-session-verifier.ts +129 -0
- package/src/worker/dpop.ts +157 -0
- package/src/worker/durable-process-timeout.ts +29 -0
- package/src/worker/errors.ts +57 -0
- package/src/worker/http.ts +112 -26
- package/src/worker/index.ts +446 -440
- package/src/worker/mcp-access.ts +57 -0
- package/src/worker/mcp-controller.ts +188 -0
- package/src/worker/mcp-http-accept.ts +11 -0
- package/src/worker/mcp-http-contract.ts +322 -0
- package/src/worker/mcp-initialization-compat.ts +141 -0
- package/src/worker/mcp-jsonrpc.ts +11 -29
- package/src/worker/mcp-removed-protocol.ts +17 -0
- package/src/worker/mcp-response-proxy.ts +135 -0
- package/src/worker/mcp-response-stream.ts +65 -0
- package/src/worker/mcp-stale-schema-compat.ts +57 -0
- package/src/worker/mcp-stream-proxy-contract.ts +48 -0
- package/src/worker/mcp-tool-call-input.ts +23 -0
- package/src/worker/nonce-store.ts +33 -35
- package/src/worker/oauth-authorization-page.ts +21 -1
- package/src/worker/oauth-client-admin.ts +52 -0
- package/src/worker/oauth-client-contract.ts +38 -0
- package/src/worker/oauth-controller.ts +107 -47
- package/src/worker/oauth-field-contract.ts +31 -0
- package/src/worker/oauth-record-contract.ts +7 -0
- package/src/worker/oauth-refresh-authority.ts +27 -0
- package/src/worker/oauth-refresh-exchange.ts +162 -0
- package/src/worker/oauth-refresh-families.ts +130 -27
- package/src/worker/oauth-refresh-persistence.ts +116 -0
- package/src/worker/oauth-state.ts +33 -18
- package/src/worker/oauth-store-validation.ts +131 -0
- package/src/worker/oauth-token-derivation.ts +33 -0
- package/src/worker/oauth-token-issuance.ts +119 -0
- package/src/worker/oauth-tokens.ts +56 -190
- package/src/worker/observability.ts +38 -5
- package/src/worker/pending-admission.ts +15 -0
- package/src/worker/pending-call-capacity.ts +108 -0
- package/src/worker/pending-call-contract.ts +42 -5
- package/src/worker/pending-call-deadlines.ts +75 -0
- package/src/worker/pending-calls.ts +131 -125
- package/src/worker/runtime-alarm-storage.ts +37 -0
- package/src/worker/runtime-alarm.ts +136 -0
- package/src/worker/server-info-activity.ts +36 -0
- package/src/worker/server-info-tool-delivery.ts +15 -0
- package/src/worker/server-info.ts +168 -0
- package/src/worker/tool-catalog.ts +47 -1
- package/src/worker/tool-timeout.ts +75 -14
- package/src/worker/websocket-protocol.ts +26 -2
- package/src/worker/worker-edge-guard.ts +90 -0
- package/src/worker/worker-edge-log.ts +65 -0
- package/src/worker/worker-entry.ts +52 -0
- package/src/worker/worker-mcp-config.ts +23 -0
- package/src/worker/worker-metadata.ts +48 -0
- package/src/worker/worker-rate-limit-key.ts +30 -0
- package/src/worker/worker-runtime-config.ts +20 -0
- package/src/worker/worker-static-routes.ts +54 -0
- package/src/worker/worker-task-lifetime.ts +18 -0
- package/tsconfig.local.json +17 -1
- package/wrangler.jsonc +13 -0
- package/src/local/cli-approval.mjs +0 -117
- package/src/local/operation-state-lock.mjs +0 -92
- package/src/worker/mcp-session.ts +0 -72
package/src/local/shell.mjs
CHANGED
|
@@ -1,7 +1,8 @@
|
|
|
1
1
|
import { spawn } from "node:child_process";
|
|
2
|
-
import { existsSync } from "node:fs";
|
|
2
|
+
import { existsSync, lstatSync, realpathSync } from "node:fs";
|
|
3
3
|
import path from "node:path";
|
|
4
|
-
import { packageRoot } from "./
|
|
4
|
+
import { packageRoot } from "./package-identity.mjs";
|
|
5
|
+
import { ensureWranglerToolchain } from "./wrangler-toolchain.mjs";
|
|
5
6
|
import { BoundedOutput } from "./bounded-output.mjs";
|
|
6
7
|
import { terminateProcessTreeWithEscalation } from "./process-tree.mjs";
|
|
7
8
|
|
|
@@ -11,7 +12,8 @@ export function runExecutable(command, args = [], options = {}) {
|
|
|
11
12
|
return new Promise((resolve, reject) => {
|
|
12
13
|
const capture = Boolean(options.capture);
|
|
13
14
|
const maxOutputBytes = Number.isFinite(Number(options.maxOutputBytes)) ? Math.max(1024, Number(options.maxOutputBytes)) : 2 * 1024 * 1024;
|
|
14
|
-
const
|
|
15
|
+
const spawnProcess = typeof options.spawnProcess === "function" ? options.spawnProcess : spawn;
|
|
16
|
+
const child = spawnProcess(executable, argv, {
|
|
15
17
|
cwd: options.cwd || process.cwd(),
|
|
16
18
|
env: options.env || process.env,
|
|
17
19
|
stdio: capture ? ["ignore", "pipe", "pipe"] : "inherit",
|
|
@@ -22,7 +24,7 @@ export function runExecutable(command, args = [], options = {}) {
|
|
|
22
24
|
const stdout = new BoundedOutput(maxOutputBytes);
|
|
23
25
|
const stderr = new BoundedOutput(maxOutputBytes);
|
|
24
26
|
let settled = false;
|
|
25
|
-
let timedOut = false;
|
|
27
|
+
let timedOut = false; let childError = null;
|
|
26
28
|
let timer = null;
|
|
27
29
|
let killTimer = null;
|
|
28
30
|
const timeoutMs = Number(options.timeoutMs);
|
|
@@ -44,17 +46,12 @@ export function runExecutable(command, args = [], options = {}) {
|
|
|
44
46
|
child.stdout?.on("data", chunk => stdout.append(chunk));
|
|
45
47
|
child.stderr?.on("data", chunk => stderr.append(chunk));
|
|
46
48
|
}
|
|
47
|
-
child.on("error", error =>
|
|
48
|
-
const result = capturedResult(127, stdout, stderr, error.message);
|
|
49
|
-
if (options.allowFailure) resolve(result);
|
|
50
|
-
else reject(error);
|
|
51
|
-
}));
|
|
49
|
+
child.on("error", error => { childError ||= error; });
|
|
52
50
|
child.on("close", code => finish(() => {
|
|
53
|
-
const
|
|
54
|
-
const result = {
|
|
55
|
-
|
|
56
|
-
|
|
57
|
-
if ((!timedOut && code === 0) || options.allowFailure) resolve(result);
|
|
51
|
+
const failureMessage = timedOut ? `command timed out after ${timeoutMs}ms` : childError?.message || "";
|
|
52
|
+
const result = { ...capturedResult(timedOut ? 124 : childError ? 127 : code, stdout, stderr, failureMessage) };
|
|
53
|
+
if ((!timedOut && !childError && code === 0) || options.allowFailure) resolve(result);
|
|
54
|
+
else if (childError && !timedOut) reject(childError);
|
|
58
55
|
else {
|
|
59
56
|
const error = new Error((result.stderr || result.stdout || `${executable} exited ${result.code}`).trim());
|
|
60
57
|
error.result = result;
|
|
@@ -97,18 +94,41 @@ function capturedResult(code, stdout, stderr, extraStderr = "") {
|
|
|
97
94
|
}
|
|
98
95
|
|
|
99
96
|
export function wranglerCommand(options = {}) {
|
|
100
|
-
const root = path.resolve(String(options.packageRoot || packageRoot));
|
|
97
|
+
const root = realpathSync(path.resolve(String(options.packageRoot || packageRoot)));
|
|
101
98
|
const node = path.resolve(String(options.node || process.execPath));
|
|
102
99
|
const script = path.join(root, "node_modules", "wrangler", "bin", "wrangler.js");
|
|
103
|
-
|
|
104
|
-
|
|
100
|
+
let info;
|
|
101
|
+
try { info = lstatSync(script); }
|
|
102
|
+
catch (error) {
|
|
103
|
+
if (error?.code === "ENOENT") throw new Error(`Wrangler JavaScript entrypoint is missing: ${script}`, { cause: error });
|
|
104
|
+
throw error;
|
|
105
|
+
}
|
|
106
|
+
if (info.isSymbolicLink() || !info.isFile() || Number(info.nlink) !== 1 || (process.platform !== "win32" && (Number(info.mode) & 0o022) !== 0)) {
|
|
107
|
+
throw new Error("Wrangler JavaScript entrypoint must be a private real regular file");
|
|
108
|
+
}
|
|
109
|
+
const canonical = realpathSync(script);
|
|
110
|
+
const relative = path.relative(root, canonical);
|
|
111
|
+
if (!relative || relative === ".." || relative.startsWith(`..${path.sep}`) || path.isAbsolute(relative)) {
|
|
112
|
+
throw new Error("Wrangler JavaScript entrypoint escapes the private toolchain root");
|
|
113
|
+
}
|
|
114
|
+
return { cmd: node, argsPrefix: [canonical] };
|
|
105
115
|
}
|
|
106
116
|
|
|
107
117
|
export async function runWrangler(args, options = {}) {
|
|
108
|
-
const
|
|
118
|
+
const toolchainRoot = await ensureWranglerToolchain({
|
|
119
|
+
stateRoot: options.stateRoot,
|
|
120
|
+
packageRoot: options.packageRoot || packageRoot,
|
|
121
|
+
npmCli: options.npmCli,
|
|
122
|
+
env: options.env || process.env,
|
|
123
|
+
runCommand: options.runCommand || runExecutable,
|
|
124
|
+
auditMaxAgeMs: options.auditMaxAgeMs,
|
|
125
|
+
hardenedNpm: options.hardenedNpm,
|
|
126
|
+
});
|
|
127
|
+
const wrangler = wranglerCommand({ packageRoot: toolchainRoot, node: options.node });
|
|
109
128
|
const operation = String(args[0] || "");
|
|
110
129
|
const timeoutMs = options.timeoutMs ?? (operation === "login" || operation === "deploy" ? 10 * 60 * 1000 : 2 * 60 * 1000);
|
|
111
|
-
|
|
130
|
+
const { stateRoot: _stateRoot, packageRoot: _packageRoot, npmCli: _npmCli, runCommand: _runCommand, auditMaxAgeMs: _auditMaxAgeMs, hardenedNpm: _hardenedNpm, node: _node, ...executionOptions } = options;
|
|
131
|
+
return runExecutable(wrangler.cmd, [...wrangler.argsPrefix, ...args], { cwd: packageRoot, timeoutMs, ...executionOptions });
|
|
112
132
|
}
|
|
113
133
|
|
|
114
134
|
export function workspaceShellCommand(command) {
|
package/src/local/ssh-key.mjs
CHANGED
|
@@ -1,12 +1,14 @@
|
|
|
1
|
-
import { constants as fsConstants } from "node:fs";
|
|
2
|
-
import { chmod,
|
|
1
|
+
import { closeSync, constants as fsConstants, fstatSync, lstatSync, unlinkSync } from "node:fs";
|
|
2
|
+
import { chmod, link, mkdir, mkdtemp, rm, writeFile } from "node:fs/promises";
|
|
3
3
|
import { basename, dirname, join, resolve } from "node:path";
|
|
4
4
|
import { randomBytes, timingSafeEqual } from "node:crypto";
|
|
5
5
|
import { tmpdir } from "node:os";
|
|
6
6
|
import { runExecutable } from "./shell.mjs";
|
|
7
|
-
import {
|
|
7
|
+
import { chmodRegularFileIfIdentitySync, openRegularFileSync, readBoundedRegularFileWithInfoSync, unlinkRegularFileIfIdentitySync } from "./secure-file.mjs";
|
|
8
|
+
import { filesystemIdentity, sameFilesystemIdentity } from "./filesystem-identity.mjs";
|
|
8
9
|
|
|
9
10
|
const KEY_TYPES = new Set(["ed25519", "rsa"]);
|
|
11
|
+
const GENERATED_KEY_IDENTITIES = Symbol("generated-key-identities");
|
|
10
12
|
|
|
11
13
|
export async function generateSshKeyPair(options = {}) {
|
|
12
14
|
const request = normalizeKeyRequest(options);
|
|
@@ -15,12 +17,12 @@ export async function generateSshKeyPair(options = {}) {
|
|
|
15
17
|
|
|
16
18
|
const existing = await inspectExistingKeyFiles(request.privateKeyPath, request.publicKeyPath);
|
|
17
19
|
if (existing) {
|
|
18
|
-
await
|
|
20
|
+
const inspected = await inspectSshKeyPair(request.privateKeyPath, request.publicKeyPath, false);
|
|
21
|
+
await secureKeyModes(request.privateKeyPath, request.publicKeyPath, keyIdentities(inspected));
|
|
19
22
|
return inspectSshKeyPair(request.privateKeyPath, request.publicKeyPath, false);
|
|
20
23
|
}
|
|
21
|
-
return createSshKeyPair(request);
|
|
24
|
+
return createSshKeyPair(request, options);
|
|
22
25
|
}
|
|
23
|
-
|
|
24
26
|
function normalizeKeyRequest(options) {
|
|
25
27
|
const privateKeyPath = resolve(String(options.privateKeyPath || ""));
|
|
26
28
|
if (!privateKeyPath || privateKeyPath === resolve(".")) throw new Error("private key path is required");
|
|
@@ -31,11 +33,10 @@ function normalizeKeyRequest(options) {
|
|
|
31
33
|
publicKeyPath: `${privateKeyPath}.pub`,
|
|
32
34
|
parent: dirname(privateKeyPath),
|
|
33
35
|
type,
|
|
34
|
-
bits: options.bits,
|
|
36
|
+
bits: type === "rsa" ? normalizeRsaBits(options.bits) : null,
|
|
35
37
|
comment: boundedComment(options.comment || `machine-mcp:${basename(privateKeyPath)}`),
|
|
36
38
|
};
|
|
37
39
|
}
|
|
38
|
-
|
|
39
40
|
async function inspectExistingKeyFiles(privateKeyPath, publicKeyPath) {
|
|
40
41
|
const privateSnapshot = tryReadKeySnapshot(privateKeyPath, 1024 * 1024, "SSH private key");
|
|
41
42
|
const publicSnapshot = tryReadKeySnapshot(publicKeyPath, 64 * 1024, "SSH public key");
|
|
@@ -43,33 +44,57 @@ async function inspectExistingKeyFiles(privateKeyPath, publicKeyPath) {
|
|
|
43
44
|
if (!privateSnapshot || !publicSnapshot) throw new Error("SSH key pair is incomplete or not a pair of regular files");
|
|
44
45
|
return true;
|
|
45
46
|
}
|
|
46
|
-
|
|
47
|
-
|
|
47
|
+
async function createSshKeyPair(request, options = {}) {
|
|
48
|
+
const install = typeof options.installNoReplace === "function"
|
|
49
|
+
? options.installNoReplace
|
|
50
|
+
: (source, target) => installNoReplace(source, target, options.installOptions);
|
|
48
51
|
const suffix = `${process.pid}-${randomBytes(8).toString("hex")}`;
|
|
49
52
|
const tempPrivate = resolve(request.parent, `.${basename(request.privateKeyPath)}.mbm-${suffix}`);
|
|
50
53
|
const tempPublic = `${tempPrivate}.pub`;
|
|
54
|
+
const tempIdentities = {};
|
|
55
|
+
let primaryError = null;
|
|
56
|
+
let result;
|
|
51
57
|
try {
|
|
52
58
|
const args = ["-q", "-t", request.type];
|
|
53
|
-
if (request.type === "rsa") args.push("-b", String(
|
|
59
|
+
if (request.type === "rsa") args.push("-b", String(request.bits));
|
|
54
60
|
args.push("-N", "", "-f", tempPrivate, "-C", request.comment);
|
|
55
61
|
const generated = await runExecutable("ssh-keygen", args, { capture: true, timeoutMs: 30_000, maxOutputBytes: 64 * 1024 });
|
|
56
62
|
if (generated.code !== 0) throw new Error("ssh-keygen failed");
|
|
57
|
-
|
|
58
|
-
|
|
63
|
+
tempIdentities.private = keyPathIdentity(tempPrivate, "generated temporary SSH private key");
|
|
64
|
+
tempIdentities.public = keyPathIdentity(tempPublic, "generated temporary SSH public key");
|
|
65
|
+
await secureKeyModes(tempPrivate, tempPublic, tempIdentities);
|
|
66
|
+
await install(tempPrivate, request.privateKeyPath);
|
|
67
|
+
const installedPrivateIdentity = keyPathIdentity(request.privateKeyPath, "generated SSH private key");
|
|
59
68
|
try {
|
|
60
|
-
await
|
|
69
|
+
await install(tempPublic, request.publicKeyPath);
|
|
61
70
|
} catch (error) {
|
|
62
|
-
|
|
71
|
+
try {
|
|
72
|
+
removeKeyPathIfCurrent(request.privateKeyPath, installedPrivateIdentity, "generated SSH private key");
|
|
73
|
+
} catch (cleanupError) {
|
|
74
|
+
throw new AggregateError([error, cleanupError], "SSH key pair installation failed and private-key rollback was incomplete");
|
|
75
|
+
}
|
|
63
76
|
throw error;
|
|
64
77
|
}
|
|
65
|
-
|
|
66
|
-
|
|
67
|
-
|
|
68
|
-
|
|
69
|
-
await
|
|
78
|
+
const installedIdentities = {
|
|
79
|
+
private: installedPrivateIdentity,
|
|
80
|
+
public: keyPathIdentity(request.publicKeyPath, "generated SSH public key"),
|
|
81
|
+
};
|
|
82
|
+
await secureKeyModes(request.privateKeyPath, request.publicKeyPath, installedIdentities);
|
|
83
|
+
result = await inspectSshKeyPair(request.privateKeyPath, request.publicKeyPath, true);
|
|
84
|
+
} catch (error) {
|
|
85
|
+
primaryError = error;
|
|
86
|
+
}
|
|
87
|
+
const cleanupErrors = [];
|
|
88
|
+
for (const [filePath, identity] of [[tempPrivate, tempIdentities.private], [tempPublic, tempIdentities.public]]) {
|
|
89
|
+
if (!identity) continue;
|
|
90
|
+
try { unlinkKnownLinkIfCurrent(filePath, identity); } catch (error) { cleanupErrors.push(error); }
|
|
70
91
|
}
|
|
92
|
+
if (cleanupErrors.length) {
|
|
93
|
+
throw new AggregateError(primaryError ? [primaryError, ...cleanupErrors] : cleanupErrors, "SSH key staging cleanup was incomplete");
|
|
94
|
+
}
|
|
95
|
+
if (primaryError) throw primaryError;
|
|
96
|
+
return result;
|
|
71
97
|
}
|
|
72
|
-
|
|
73
98
|
export async function inspectSshKeyPair(privateKeyPath, publicKeyPath = `${privateKeyPath}.pub`, created = false) {
|
|
74
99
|
const privateSnapshot = readKeySnapshot(privateKeyPath, 1024 * 1024, "SSH private key");
|
|
75
100
|
const publicSnapshot = readKeySnapshot(publicKeyPath, 64 * 1024, "SSH public key");
|
|
@@ -100,7 +125,7 @@ export async function inspectSshKeyPair(privateKeyPath, publicKeyPath = `${priva
|
|
|
100
125
|
if (!/^SHA256:[A-Za-z0-9+/=]+$/.test(fingerprintValue)) throw new Error("SSH key fingerprint output is invalid");
|
|
101
126
|
assertKeySnapshotCurrent(privateKeyPath, privateSnapshot, 1024 * 1024, "SSH private key");
|
|
102
127
|
assertKeySnapshotCurrent(publicKeyPath, publicSnapshot, 64 * 1024, "SSH public key");
|
|
103
|
-
|
|
128
|
+
const result = {
|
|
104
129
|
created,
|
|
105
130
|
privateKeyPath: resolve(privateKeyPath),
|
|
106
131
|
publicKeyPath: resolve(publicKeyPath),
|
|
@@ -109,32 +134,126 @@ export async function inspectSshKeyPair(privateKeyPath, publicKeyPath = `${priva
|
|
|
109
134
|
fingerprint: fingerprintValue,
|
|
110
135
|
publicKeyType: publicLine.split(/\s+/, 1)[0],
|
|
111
136
|
};
|
|
137
|
+
Object.defineProperty(result, GENERATED_KEY_IDENTITIES, {
|
|
138
|
+
value: Object.freeze({ private: privateSnapshot.identity, public: publicSnapshot.identity }),
|
|
139
|
+
enumerable: false,
|
|
140
|
+
});
|
|
141
|
+
return result;
|
|
112
142
|
} finally {
|
|
113
143
|
await rm(inspectionRoot, { recursive: true, force: true });
|
|
114
144
|
}
|
|
115
145
|
}
|
|
116
|
-
|
|
117
|
-
|
|
146
|
+
export async function removeGeneratedSshKeyPair(key, options = {}) {
|
|
147
|
+
if (!key?.created) return;
|
|
148
|
+
const identities = key[GENERATED_KEY_IDENTITIES];
|
|
149
|
+
if (!identities?.private || !identities?.public) {
|
|
150
|
+
throw new Error("generated SSH key rollback identity is unavailable; refusing path-only cleanup");
|
|
151
|
+
}
|
|
152
|
+
const remove = typeof options.removeIfCurrent === "function" ? options.removeIfCurrent : removeKeyPathIfCurrent;
|
|
153
|
+
const failures = [];
|
|
154
|
+
for (const [kind, filePath, identity] of [
|
|
155
|
+
["private", key.privateKeyPath, identities.private],
|
|
156
|
+
["public", key.publicKeyPath, identities.public],
|
|
157
|
+
]) {
|
|
158
|
+
try { await remove(filePath, identity, `generated SSH ${kind} key`); }
|
|
159
|
+
catch (cause) { failures.push(new Error(`generated SSH ${kind} key cleanup failed`, { cause })); }
|
|
160
|
+
}
|
|
161
|
+
if (failures.length) throw new AggregateError(failures, "generated SSH key rollback was incomplete");
|
|
162
|
+
}
|
|
163
|
+
function keyPathIdentity(filePath, label) {
|
|
164
|
+
const info = lstatSync(filePath, { bigint: true });
|
|
165
|
+
if (info.isSymbolicLink() || !info.isFile() || info.nlink !== 1n) throw new Error(`${label} is not an exclusive regular file`);
|
|
166
|
+
return filesystemIdentity(info, label);
|
|
167
|
+
}
|
|
168
|
+
function removeKeyPathIfCurrent(filePath, identity, label) {
|
|
169
|
+
let current;
|
|
170
|
+
try { current = lstatSync(filePath, { bigint: true }); }
|
|
171
|
+
catch (error) { if (error?.code === "ENOENT") return; throw error; }
|
|
172
|
+
if (current.isSymbolicLink() || !current.isFile() || current.nlink !== 1n
|
|
173
|
+
|| !sameFilesystemIdentity(identity, filesystemIdentity(current, label))) {
|
|
174
|
+
throw new Error(`${label} changed before rollback; replacement was preserved`);
|
|
175
|
+
}
|
|
176
|
+
if (!unlinkRegularFileIfIdentitySync(filePath, identity, label)) {
|
|
177
|
+
throw new Error(`${label} changed before rollback; replacement was preserved`);
|
|
178
|
+
}
|
|
179
|
+
}
|
|
180
|
+
async function installNoReplace(source, target, options = {}) {
|
|
181
|
+
const createLink = options?.link || link;
|
|
182
|
+
const opened = openRegularFileSync(source, fsConstants.O_RDONLY, { label: "SSH staging key", verifyPathIdentity: true, rejectMultipleLinks: true });
|
|
183
|
+
let primaryError = null;
|
|
118
184
|
try {
|
|
119
|
-
await
|
|
120
|
-
|
|
185
|
+
try { await createLink(source, target); }
|
|
186
|
+
catch (error) {
|
|
187
|
+
if (error?.code === "EEXIST") throw new Error(`refusing to replace existing SSH key file: ${target}`);
|
|
188
|
+
throw error;
|
|
189
|
+
}
|
|
190
|
+
const installedIdentity = installedLinkIdentity(opened.fd, source, target);
|
|
191
|
+
try {
|
|
192
|
+
if (typeof options?.unlink === "function") await options.unlink(source, installedIdentity);
|
|
193
|
+
else removeInstalledLinkIfCurrent(source, installedIdentity, "SSH staging key");
|
|
194
|
+
} catch (error) {
|
|
195
|
+
try { removeInstalledLinkIfCurrent(target, installedIdentity); }
|
|
196
|
+
catch (cleanupError) { throw new AggregateError([error, cleanupError], "SSH key installation failed and target rollback was incomplete"); }
|
|
197
|
+
throw error;
|
|
198
|
+
}
|
|
121
199
|
} catch (error) {
|
|
122
|
-
|
|
123
|
-
|
|
124
|
-
|
|
125
|
-
|
|
200
|
+
primaryError = error;
|
|
201
|
+
}
|
|
202
|
+
const cleanupErrors = [];
|
|
203
|
+
try { unlinkKnownLinkIfCurrent(source, filesystemIdentity(fstatSync(opened.fd, { bigint: true }), "SSH staging key cleanup")); }
|
|
204
|
+
catch (error) { cleanupErrors.push(error); }
|
|
205
|
+
try { closeSync(opened.fd); } catch (error) { cleanupErrors.push(error); }
|
|
206
|
+
if (cleanupErrors.length) {
|
|
207
|
+
throw new AggregateError(primaryError ? [primaryError, ...cleanupErrors] : cleanupErrors, "SSH key installation staging cleanup was incomplete");
|
|
208
|
+
}
|
|
209
|
+
if (primaryError) throw primaryError;
|
|
210
|
+
}
|
|
211
|
+
function installedLinkIdentity(sourceFd, source, target) {
|
|
212
|
+
const sourceIdentity = filesystemIdentity(fstatSync(sourceFd, { bigint: true }), "SSH staging key after link");
|
|
213
|
+
const targetInfo = lstatSync(target, { bigint: true });
|
|
214
|
+
const targetIdentity = filesystemIdentity(targetInfo, "installed SSH key target");
|
|
215
|
+
if (targetInfo.isSymbolicLink() || !targetInfo.isFile() || !sameFilesystemIdentity(sourceIdentity, targetIdentity)) {
|
|
216
|
+
throw new Error("installed SSH key target does not match the staging key; replacement was preserved");
|
|
217
|
+
}
|
|
218
|
+
try {
|
|
219
|
+
const sourceInfo = lstatSync(source, { bigint: true });
|
|
220
|
+
if (sourceInfo.isSymbolicLink() || !sourceInfo.isFile()
|
|
221
|
+
|| !sameFilesystemIdentity(sourceIdentity, filesystemIdentity(sourceInfo, "SSH staging key after link"))) {
|
|
222
|
+
throw new Error("SSH staging key changed after link");
|
|
126
223
|
}
|
|
127
|
-
|
|
224
|
+
} catch (error) {
|
|
225
|
+
try { removeInstalledLinkIfCurrent(target, targetIdentity); }
|
|
226
|
+
catch (cleanupError) { throw new AggregateError([error, cleanupError], "SSH key link verification failed and target rollback was incomplete"); }
|
|
128
227
|
throw error;
|
|
129
228
|
}
|
|
229
|
+
return targetIdentity;
|
|
130
230
|
}
|
|
131
|
-
|
|
132
|
-
|
|
231
|
+
function unlinkKnownLinkIfCurrent(filePath, expectedIdentity) {
|
|
232
|
+
let current;
|
|
233
|
+
try { current = lstatSync(filePath, { bigint: true }); }
|
|
234
|
+
catch (error) { if (error?.code === "ENOENT") return false; throw error; }
|
|
235
|
+
if (current.isSymbolicLink() || !current.isFile()
|
|
236
|
+
|| !sameFilesystemIdentity(expectedIdentity, filesystemIdentity(current, "SSH key link"))) return false;
|
|
237
|
+
try { unlinkSync(filePath); return true; }
|
|
238
|
+
catch (error) { if (error?.code === "ENOENT") return false; throw error; }
|
|
239
|
+
}
|
|
240
|
+
function removeInstalledLinkIfCurrent(filePath, expectedIdentity, label = "installed SSH key target") {
|
|
241
|
+
if (unlinkKnownLinkIfCurrent(filePath, expectedIdentity)) return;
|
|
242
|
+
try { lstatSync(filePath, { bigint: true }); }
|
|
243
|
+
catch (error) { if (error?.code === "ENOENT") return; throw error; }
|
|
244
|
+
throw new Error(`${label} changed before rollback; replacement was preserved`);
|
|
245
|
+
}
|
|
246
|
+
async function secureKeyModes(privateKeyPath, publicKeyPath, expected) {
|
|
133
247
|
if (process.platform === "win32") return;
|
|
134
|
-
|
|
135
|
-
|
|
248
|
+
if (!expected?.private || !expected?.public) throw new Error("SSH key permission update requires exact key identities");
|
|
249
|
+
chmodRegularFileIfIdentitySync(privateKeyPath, expected.private, 0o600, "SSH private key");
|
|
250
|
+
chmodRegularFileIfIdentitySync(publicKeyPath, expected.public, 0o644, "SSH public key");
|
|
251
|
+
}
|
|
252
|
+
function keyIdentities(key) {
|
|
253
|
+
const identities = key?.[GENERATED_KEY_IDENTITIES];
|
|
254
|
+
if (!identities?.private || !identities?.public) throw new Error("SSH key inspection identity is unavailable");
|
|
255
|
+
return identities;
|
|
136
256
|
}
|
|
137
|
-
|
|
138
257
|
function tryReadKeySnapshot(path, maxBytes, label) {
|
|
139
258
|
try { return readKeySnapshot(path, maxBytes, label); } catch (error) {
|
|
140
259
|
if (error?.code === "ENOENT") return null;
|
|
@@ -148,10 +267,7 @@ function readKeySnapshot(path, maxBytes, label) {
|
|
|
148
267
|
|
|
149
268
|
function assertKeySnapshotCurrent(path, expected, maxBytes, label) {
|
|
150
269
|
const current = readKeySnapshot(path, maxBytes, label);
|
|
151
|
-
const sameIdentity =
|
|
152
|
-
&& Number(current.info.ino) === Number(expected.info.ino)
|
|
153
|
-
&& Number(current.info.size) === Number(expected.info.size)
|
|
154
|
-
&& Number(current.info.mtimeMs) === Number(expected.info.mtimeMs);
|
|
270
|
+
const sameIdentity = sameFilesystemIdentity(current.identity, expected.identity);
|
|
155
271
|
const sameBytes = current.buffer.length === expected.buffer.length
|
|
156
272
|
&& timingSafeEqual(current.buffer, expected.buffer);
|
|
157
273
|
if (!sameIdentity || !sameBytes) throw new Error(`${label} changed during inspection; retry`);
|
|
@@ -165,7 +281,7 @@ function boundedComment(value) {
|
|
|
165
281
|
}
|
|
166
282
|
|
|
167
283
|
function normalizeRsaBits(value) {
|
|
168
|
-
const bits =
|
|
169
|
-
if (![2048, 3072, 4096].includes(bits)) throw new Error("RSA bits must be 2048, 3072, or 4096");
|
|
284
|
+
const bits = value === undefined || value === null || value === "" ? 3072 : Number(value);
|
|
285
|
+
if (!Number.isInteger(bits) || ![2048, 3072, 4096].includes(bits)) throw new Error("RSA bits must be 2048, 3072, or 4096");
|
|
170
286
|
return bits;
|
|
171
287
|
}
|
|
@@ -1,8 +1,11 @@
|
|
|
1
|
-
import {
|
|
1
|
+
import { readdirSync, realpathSync } from "node:fs";
|
|
2
2
|
import { resolve } from "node:path";
|
|
3
3
|
import { activeManagedJobs } from "./managed-jobs.mjs";
|
|
4
|
+
import { MANAGED_JOB_ID } from "./managed-job-directory.mjs";
|
|
5
|
+
import { activeManagedJobLock } from "./managed-job-lock.mjs";
|
|
4
6
|
import { inspectProcessInstance } from "./process-identity.mjs";
|
|
5
|
-
import { readBoundedRegularFileSync } from "./secure-file.mjs";
|
|
7
|
+
import { inspectPathIfPresentSync, readBoundedRegularFileSync } from "./secure-file.mjs";
|
|
8
|
+
import { activeOwnerStateLocks } from "./state-owner-lock-inventory.mjs";
|
|
6
9
|
import { STATE_SCHEMA_VERSION, expandHome, readDaemonLockOwner, resolveWorkspace } from "./state.mjs";
|
|
7
10
|
|
|
8
11
|
const PROFILE_NAME = /^[a-f0-9]{24}$/;
|
|
@@ -11,13 +14,12 @@ const MAX_STATE_BYTES = 2 * 1024 * 1024;
|
|
|
11
14
|
|
|
12
15
|
export function knownWorkerNames(stateRoot) {
|
|
13
16
|
const profiles = profilesDirectory(stateRoot);
|
|
14
|
-
if (!existsSync(profiles)) return [];
|
|
15
17
|
const names = new Set();
|
|
16
18
|
for (const entry of profileDirectories(profiles)) {
|
|
17
19
|
const profileDir = resolve(profiles, entry.name);
|
|
18
20
|
const stateFile = resolve(profileDir, "state.json");
|
|
19
|
-
if (!
|
|
20
|
-
const evidence = readdirSync(profileDir).some((name) => /^state\.json\.corrupt-/.test(name) || name === "daemon.lock");
|
|
21
|
+
if (!inspectPathIfPresentSync(stateFile, "workspace state")) {
|
|
22
|
+
const evidence = readdirSync(profileDir).some((name) => /^state\.json\.corrupt-/.test(name) || name === "state.json.recovery-required" || name === "daemon.lock");
|
|
21
23
|
if (evidence) throw unreadableWorkerState(entry.name);
|
|
22
24
|
continue;
|
|
23
25
|
}
|
|
@@ -44,14 +46,13 @@ export function knownWorkerNames(stateRoot) {
|
|
|
44
46
|
export function knownProfileStates(stateRoot) {
|
|
45
47
|
const canonicalStateRoot = canonicalRoot(stateRoot);
|
|
46
48
|
const profiles = resolve(canonicalStateRoot, "profiles");
|
|
47
|
-
if (!existsSync(profiles)) return [];
|
|
48
49
|
const states = [];
|
|
49
50
|
const seen = new Set();
|
|
50
51
|
for (const entry of profileDirectories(profiles)) {
|
|
51
52
|
const profileDir = resolve(profiles, entry.name);
|
|
52
53
|
const statePath = resolve(profileDir, "state.json");
|
|
53
54
|
const candidates = [];
|
|
54
|
-
if (
|
|
55
|
+
if (inspectPathIfPresentSync(statePath, "workspace state")) {
|
|
55
56
|
try {
|
|
56
57
|
const value = readStateJson(statePath);
|
|
57
58
|
if (typeof value?.workspace?.path === "string") candidates.push(value.workspace.path);
|
|
@@ -60,8 +61,9 @@ export function knownProfileStates(stateRoot) {
|
|
|
60
61
|
}
|
|
61
62
|
}
|
|
62
63
|
const daemonLock = resolve(profileDir, "daemon.lock");
|
|
64
|
+
const daemonLockPresent = Boolean(inspectPathIfPresentSync(daemonLock, "daemon lock"));
|
|
63
65
|
const daemonOwner = readDaemonLockOwner(daemonLock);
|
|
64
|
-
if (
|
|
66
|
+
if (daemonLockPresent && !daemonOwner) {
|
|
65
67
|
throw new Error(`cannot inspect daemon lock for profile ${entry.name}; service definitions and state were kept`);
|
|
66
68
|
}
|
|
67
69
|
if (typeof daemonOwner?.workspace === "string") candidates.push(daemonOwner.workspace);
|
|
@@ -86,7 +88,6 @@ export function knownProfileStates(stateRoot) {
|
|
|
86
88
|
|
|
87
89
|
export function activeStateJobs(stateRoot) {
|
|
88
90
|
const profiles = profilesDirectory(stateRoot);
|
|
89
|
-
if (!existsSync(profiles)) return [];
|
|
90
91
|
const active = [];
|
|
91
92
|
for (const profile of profileDirectories(profiles)) {
|
|
92
93
|
for (const job of activeManagedJobs(resolve(profiles, profile.name, "jobs"))) {
|
|
@@ -97,13 +98,19 @@ export function activeStateJobs(stateRoot) {
|
|
|
97
98
|
}
|
|
98
99
|
|
|
99
100
|
export function activeStateLocks(stateRoot) {
|
|
100
|
-
const
|
|
101
|
-
|
|
102
|
-
const active =
|
|
101
|
+
const root = canonicalRoot(stateRoot);
|
|
102
|
+
const profiles = resolve(root, "profiles");
|
|
103
|
+
const active = activeOwnerStateLocks(root);
|
|
103
104
|
for (const profile of profileDirectories(profiles)) {
|
|
104
|
-
|
|
105
|
-
|
|
106
|
-
|
|
105
|
+
const profileDir = resolve(profiles, profile.name);
|
|
106
|
+
for (const [kind, name] of [
|
|
107
|
+
["daemon", "daemon.lock"],
|
|
108
|
+
["startup", "startup.lock"],
|
|
109
|
+
["operation-authorization", "operation-authorization.lock"],
|
|
110
|
+
["security-audit", "security-audit.lock"],
|
|
111
|
+
]) {
|
|
112
|
+
const lockPath = resolve(profileDir, name);
|
|
113
|
+
if (!inspectPathIfPresentSync(lockPath, `${kind} lock`)) continue;
|
|
107
114
|
const owner = readDaemonLockOwner(lockPath);
|
|
108
115
|
if (!owner) {
|
|
109
116
|
active.push({ kind, pid: null, path: lockPath, reason: "invalid_or_unreadable_lock" });
|
|
@@ -115,27 +122,46 @@ export function activeStateLocks(stateRoot) {
|
|
|
115
122
|
active.push({ kind, pid: owner.pid, path: lockPath, reason: identity.reason });
|
|
116
123
|
}
|
|
117
124
|
}
|
|
125
|
+
const jobRoot = resolve(profileDir, "jobs");
|
|
126
|
+
const jobRootInfo = inspectPathIfPresentSync(jobRoot, "managed-job root");
|
|
127
|
+
if (!jobRootInfo) continue;
|
|
128
|
+
if (jobRootInfo.isSymbolicLink() || !jobRootInfo.isDirectory()) throw new Error("managed-job root must be a real directory");
|
|
129
|
+
const capacityLockPath = resolve(jobRoot, "capacity.lock");
|
|
130
|
+
const capacityLock = activeManagedJobLock(capacityLockPath);
|
|
131
|
+
if (capacityLock?.active) active.push({ kind: "job-capacity", pid: capacityLock.pid, path: capacityLockPath, reason: capacityLock.reason });
|
|
132
|
+
for (const entry of readdirSync(jobRoot, { withFileTypes: true })) {
|
|
133
|
+
if (!entry.isDirectory() || !MANAGED_JOB_ID.test(entry.name)) continue;
|
|
134
|
+
for (const [kind, name] of [["job-transition", "transition.lock"], ["job-recovery", "recovery.lock"]]) {
|
|
135
|
+
const lockPath = resolve(jobRoot, entry.name, name);
|
|
136
|
+
const lock = activeManagedJobLock(lockPath);
|
|
137
|
+
if (lock?.active) active.push({ kind, pid: lock.pid, path: lockPath, reason: lock.reason, job_id: entry.name });
|
|
138
|
+
}
|
|
139
|
+
}
|
|
118
140
|
}
|
|
119
141
|
return active;
|
|
120
142
|
}
|
|
121
143
|
|
|
122
|
-
function profilesDirectory(stateRoot) {
|
|
123
|
-
return resolve(canonicalRoot(stateRoot), "profiles");
|
|
124
|
-
}
|
|
125
|
-
|
|
144
|
+
function profilesDirectory(stateRoot) { return resolve(canonicalRoot(stateRoot), "profiles"); }
|
|
126
145
|
function canonicalRoot(stateRoot) {
|
|
127
146
|
const expanded = resolve(expandHome(stateRoot));
|
|
128
|
-
if (!
|
|
147
|
+
const info = inspectPathIfPresentSync(expanded, "state root"); if (!info) return expanded;
|
|
148
|
+
if (info.isSymbolicLink() || !info.isDirectory()) throw new Error("state root must be a real directory");
|
|
129
149
|
return realpathSync.native ? realpathSync.native(expanded) : realpathSync(expanded);
|
|
130
150
|
}
|
|
131
151
|
|
|
132
152
|
function profileDirectories(profiles) {
|
|
133
|
-
|
|
134
|
-
|
|
153
|
+
const info = inspectPathIfPresentSync(profiles, "state profile directory");
|
|
154
|
+
if (!info) return [];
|
|
155
|
+
if (info.isSymbolicLink() || !info.isDirectory()) throw new Error("state profile directory must be a real directory");
|
|
156
|
+
const entries = readdirSync(profiles, { withFileTypes: true });
|
|
157
|
+
if (entries.some((entry) => !PROFILE_NAME.test(entry.name) || !entry.isDirectory())) throw new Error("state profile directory contains an unexpected entry; local state was kept for inspection");
|
|
158
|
+
return entries;
|
|
135
159
|
}
|
|
136
|
-
|
|
137
160
|
function readStateJson(path) {
|
|
138
|
-
return JSON.parse(readBoundedRegularFileSync(path, MAX_STATE_BYTES
|
|
161
|
+
return JSON.parse(readBoundedRegularFileSync(path, MAX_STATE_BYTES, "state inventory", {
|
|
162
|
+
verifyPathIdentity: true,
|
|
163
|
+
rejectMultipleLinks: true,
|
|
164
|
+
}).toString("utf8"));
|
|
139
165
|
}
|
|
140
166
|
|
|
141
167
|
function unreadableWorkerState(profile) {
|
|
@@ -0,0 +1,23 @@
|
|
|
1
|
+
import { resolve } from "node:path";
|
|
2
|
+
import { readOwnerStateLock } from "./owner-state-lock.mjs";
|
|
3
|
+
import { inspectProcessInstance } from "./process-identity.mjs";
|
|
4
|
+
import { inspectPathIfPresentSync } from "./secure-file.mjs";
|
|
5
|
+
|
|
6
|
+
export function activeOwnerStateLocks(stateRoot) {
|
|
7
|
+
const toolchains = resolve(stateRoot, "toolchains");
|
|
8
|
+
const directory = inspectPathIfPresentSync(toolchains, "toolchain state");
|
|
9
|
+
if (!directory) return [];
|
|
10
|
+
if (directory.isSymbolicLink() || !directory.isDirectory()) return [blocker("toolchain-state", null, "invalid_or_unreadable_state")];
|
|
11
|
+
const lockPath = resolve(toolchains, "wrangler-toolchain.lock");
|
|
12
|
+
if (!inspectPathIfPresentSync(lockPath, "Wrangler toolchain lock")) return [];
|
|
13
|
+
let inspected;
|
|
14
|
+
try { inspected = readOwnerStateLock(lockPath, "wrangler-toolchain"); }
|
|
15
|
+
catch { return [blocker("toolchain", null, "invalid_or_unreadable_lock")]; }
|
|
16
|
+
if (inspected.kind === "missing") return [];
|
|
17
|
+
if (inspected.kind !== "owner") return [blocker("toolchain", null, "invalid_or_unreadable_lock")];
|
|
18
|
+
const identity = inspectProcessInstance(inspected.owner);
|
|
19
|
+
if (!identity.current && !(identity.alive && !identity.reclaimable)) return [];
|
|
20
|
+
return [blocker("toolchain", inspected.owner.pid, identity.reason)];
|
|
21
|
+
}
|
|
22
|
+
|
|
23
|
+
function blocker(kind, pid, reason) { return { kind, pid: Number.isInteger(pid) ? pid : null, reason }; }
|
|
@@ -0,0 +1,83 @@
|
|
|
1
|
+
import { readdirSync } from "node:fs";
|
|
2
|
+
import { join } from "node:path";
|
|
3
|
+
import { inspectPathIfPresentSync } from "./secure-file.mjs";
|
|
4
|
+
|
|
5
|
+
const TOOLCHAIN_DIRECTORY = /^(?:npm-[0-9A-Za-z.+_-]+-hardened-[a-f0-9]{16}|wrangler-[0-9A-Za-z.+_-]+-[a-f0-9]{16})$/;
|
|
6
|
+
const TOOLCHAIN_LOCK_TEMP = /^\.wrangler-toolchain\.lock\.\d+\.[a-f0-9]{16}\.tmp$/;
|
|
7
|
+
const ACTIVATION_RECORD = /^v[0-9A-Za-z.-]+\.json$/;
|
|
8
|
+
const ACTIVATION_TEMP = /^\.v[0-9A-Za-z.-]+\.json\.\d+\.[a-f0-9]{16}\.tmp$/;
|
|
9
|
+
const RUNTIME_DIRECTORY = /^v[0-9A-Za-z.-]+-[0-9a-f]{12}-[0-9a-f]{12}$/;
|
|
10
|
+
const LEGACY_RELEASE_TASK = /^[0-9A-Za-z][0-9A-Za-z._-]{0,127}$/;
|
|
11
|
+
|
|
12
|
+
export function isCandidateRuntimeDirectoryName(name) { return RUNTIME_DIRECTORY.test(String(name || "")); }
|
|
13
|
+
|
|
14
|
+
export function validateOwnedStateNamespaces(root) {
|
|
15
|
+
validateToolchains(join(root, "toolchains"));
|
|
16
|
+
validateReleaseChannels(join(root, "release-channels"));
|
|
17
|
+
validateLegacyReleaseTasks(join(root, "release-tasks"));
|
|
18
|
+
}
|
|
19
|
+
|
|
20
|
+
function validateToolchains(directory) {
|
|
21
|
+
if (!realDirectoryIfPresent(directory, "toolchain state namespace")) return;
|
|
22
|
+
for (const entry of readdirSync(directory, { withFileTypes: true })) {
|
|
23
|
+
if (entry.name === "wrangler-toolchain.lock" || TOOLCHAIN_LOCK_TEMP.test(entry.name)) {
|
|
24
|
+
if (!entry.isFile()) throw new Error("Wrangler toolchain lock state has an invalid type before state removal");
|
|
25
|
+
continue;
|
|
26
|
+
}
|
|
27
|
+
if (!TOOLCHAIN_DIRECTORY.test(entry.name) || !entry.isDirectory()) {
|
|
28
|
+
throw new Error("toolchain state namespace contains an unexpected entry; state was kept for inspection");
|
|
29
|
+
}
|
|
30
|
+
}
|
|
31
|
+
}
|
|
32
|
+
|
|
33
|
+
function validateReleaseChannels(directory) {
|
|
34
|
+
if (!realDirectoryIfPresent(directory, "release-channel state namespace")) return;
|
|
35
|
+
for (const entry of readdirSync(directory, { withFileTypes: true })) {
|
|
36
|
+
if (!entry.isDirectory() || !["activations", "runtimes", "browser-extension"].includes(entry.name)) {
|
|
37
|
+
throw new Error("release-channel state namespace contains an unexpected entry; state was kept for inspection");
|
|
38
|
+
}
|
|
39
|
+
}
|
|
40
|
+
validateNamedChildren(join(directory, "activations"), "activation record", [ACTIVATION_RECORD, ACTIVATION_TEMP], "file");
|
|
41
|
+
validateNamedChildren(join(directory, "runtimes"), "candidate runtime", [RUNTIME_DIRECTORY], "directory");
|
|
42
|
+
validateBrowserExtension(join(directory, "browser-extension"));
|
|
43
|
+
}
|
|
44
|
+
|
|
45
|
+
function validateBrowserExtension(directory) {
|
|
46
|
+
if (!realDirectoryIfPresent(directory, "release browser-extension namespace")) return;
|
|
47
|
+
let visited = 0;
|
|
48
|
+
const walk = (current) => {
|
|
49
|
+
for (const entry of readdirSync(current, { withFileTypes: true })) {
|
|
50
|
+
visited += 1;
|
|
51
|
+
if (visited > 512) throw new Error("release browser-extension namespace contains too many entries; state was kept for inspection");
|
|
52
|
+
if (entry.isDirectory()) { walk(join(current, entry.name)); continue; }
|
|
53
|
+
if (!entry.isFile()) throw new Error("release browser-extension namespace contains an unexpected entry; state was kept for inspection");
|
|
54
|
+
}
|
|
55
|
+
};
|
|
56
|
+
walk(directory);
|
|
57
|
+
}
|
|
58
|
+
|
|
59
|
+
function validateLegacyReleaseTasks(directory) {
|
|
60
|
+
if (!realDirectoryIfPresent(directory, "legacy release-task namespace")) return;
|
|
61
|
+
for (const entry of readdirSync(directory, { withFileTypes: true })) {
|
|
62
|
+
if (!entry.isDirectory() || !LEGACY_RELEASE_TASK.test(entry.name)) {
|
|
63
|
+
throw new Error("legacy release-task namespace contains an unexpected entry; state was kept for inspection");
|
|
64
|
+
}
|
|
65
|
+
}
|
|
66
|
+
}
|
|
67
|
+
|
|
68
|
+
function validateNamedChildren(directory, label, patterns, kind) {
|
|
69
|
+
if (!realDirectoryIfPresent(directory, `${label} namespace`)) return;
|
|
70
|
+
for (const entry of readdirSync(directory, { withFileTypes: true })) {
|
|
71
|
+
const rightType = kind === "file" ? entry.isFile() : entry.isDirectory();
|
|
72
|
+
if (!rightType || !patterns.some((pattern) => pattern.test(entry.name))) {
|
|
73
|
+
throw new Error(`${label} namespace contains an unexpected entry; state was kept for inspection`);
|
|
74
|
+
}
|
|
75
|
+
}
|
|
76
|
+
}
|
|
77
|
+
|
|
78
|
+
function realDirectoryIfPresent(directory, label) {
|
|
79
|
+
const info = inspectPathIfPresentSync(directory, label);
|
|
80
|
+
if (!info) return false;
|
|
81
|
+
if (info.isSymbolicLink() || !info.isDirectory()) throw new Error(`${label} must be a real directory before state removal`);
|
|
82
|
+
return true;
|
|
83
|
+
}
|