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
|
@@ -1,9 +1,20 @@
|
|
|
1
|
-
import { createHash
|
|
1
|
+
import { createHash } from "node:crypto";
|
|
2
2
|
import { constants as fsConstants } from "node:fs";
|
|
3
|
-
import {
|
|
4
|
-
import path, { basename,
|
|
3
|
+
import { lstat, open, stat } from "node:fs/promises";
|
|
4
|
+
import path, { basename, resolve } from "node:path";
|
|
5
|
+
import { directoryEntriesWithMetadata } from "./directory-metadata.mjs";
|
|
6
|
+
import { BridgeError } from "./errors.mjs";
|
|
5
7
|
import { applyUpdateHunks, parsePatchEnvelope } from "./patch.mjs";
|
|
8
|
+
import { openDirectoryIfExists, pathEntryIfExists } from "./path-inspection.mjs";
|
|
6
9
|
import { clampInteger } from "./numbers.mjs";
|
|
10
|
+
import { searchWorkspaceFiles } from "./workspace-search.mjs";
|
|
11
|
+
import {
|
|
12
|
+
assertNoResolvedPatchCollisions as assertResolvedPatchCollisions,
|
|
13
|
+
atomicWriteText as commitAtomicText,
|
|
14
|
+
commitPatchTransaction as commitPatchOperations,
|
|
15
|
+
sha256,
|
|
16
|
+
} from "./workspace-file-transaction.mjs";
|
|
17
|
+
export { assertNoResolvedPatchCollisions, sha256 } from "./workspace-file-transaction.mjs";
|
|
7
18
|
|
|
8
19
|
export const MAX_WRITE_BYTES = 5 * 1024 * 1024;
|
|
9
20
|
const MAX_DIRECTORY_ENTRIES = 10_000;
|
|
@@ -12,41 +23,43 @@ const MAX_WALK_ENTRIES = 200_000;
|
|
|
12
23
|
const MAX_IMAGE_BYTES = 4 * 1024 * 1024;
|
|
13
24
|
|
|
14
25
|
export class WorkspaceFileService {
|
|
15
|
-
constructor({ workspace, policy, policyGate, resolveExistingPath, resolveWritePath, displayPath, throwIfCancelled,
|
|
26
|
+
constructor({ workspace, policy, policyGate, policyForContext = null, resolveExistingPath, resolveWritePath, displayPath, throwIfCancelled, withMutationPaths }) {
|
|
16
27
|
this.workspace = workspace;
|
|
17
28
|
this.policy = policy;
|
|
18
29
|
this.policyGate = policyGate;
|
|
30
|
+
this.policyForContext = typeof policyForContext === "function" ? policyForContext : () => this.policy;
|
|
19
31
|
this.resolveExistingPath = resolveExistingPath;
|
|
20
32
|
this.resolveWritePath = resolveWritePath;
|
|
21
33
|
this.displayPath = displayPath;
|
|
22
34
|
this.throwIfCancelled = throwIfCancelled;
|
|
23
|
-
this.
|
|
35
|
+
this.withMutationPaths = withMutationPaths;
|
|
24
36
|
}
|
|
25
37
|
|
|
26
|
-
listRoots() {
|
|
27
|
-
const
|
|
28
|
-
|
|
38
|
+
listRoots(context = {}) {
|
|
39
|
+
const policy = this.policyForContext(context);
|
|
40
|
+
const roots = [{ name: policy.exposeAbsolutePaths ? basename(this.workspace) : "workspace", path: this.displayPath(this.workspace, context), default: true }];
|
|
41
|
+
if (policy.unrestrictedPaths) {
|
|
29
42
|
const home = process.env.HOME || process.env.USERPROFILE;
|
|
30
|
-
if (home && home !== this.workspace) roots.push({ name: "home", path: this.displayPath(resolve(home)), default: false });
|
|
31
|
-
roots.push({ name: "filesystem-root", path: this.displayPath(path.parse(this.workspace).root), default: false });
|
|
43
|
+
if (home && home !== this.workspace) roots.push({ name: "home", path: this.displayPath(resolve(home), context), default: false });
|
|
44
|
+
roots.push({ name: "filesystem-root", path: this.displayPath(path.parse(this.workspace).root, context), default: false });
|
|
32
45
|
}
|
|
33
46
|
return { roots };
|
|
34
47
|
}
|
|
35
48
|
|
|
36
49
|
async listDir(inputPath, context = {}) {
|
|
37
|
-
const full = await this.resolveExistingPath(inputPath);
|
|
50
|
+
const full = await this.resolveExistingPath(inputPath, context);
|
|
38
51
|
const entries = [];
|
|
39
52
|
let resultBytes = 0;
|
|
40
53
|
let truncated = false;
|
|
41
|
-
for await (const entry of
|
|
42
|
-
this.throwIfCancelled
|
|
43
|
-
|
|
44
|
-
|
|
54
|
+
for await (const { entry, path: entryPath, info } of directoryEntriesWithMetadata(full, {
|
|
55
|
+
throwIfCancelled: this.throwIfCancelled, context,
|
|
56
|
+
})) {
|
|
57
|
+
if (!info) continue;
|
|
45
58
|
const item = {
|
|
46
59
|
name: entry.name,
|
|
47
|
-
path: this.displayPath(entryPath),
|
|
60
|
+
path: this.displayPath(entryPath, context),
|
|
48
61
|
type: entry.isDirectory() ? "directory" : entry.isFile() ? "file" : entry.isSymbolicLink() ? "symlink" : "other",
|
|
49
|
-
size: info
|
|
62
|
+
size: info.size,
|
|
50
63
|
};
|
|
51
64
|
const itemBytes = Buffer.byteLength(item.name) + Buffer.byteLength(item.path) + 64;
|
|
52
65
|
if (entries.length >= MAX_DIRECTORY_ENTRIES || resultBytes + itemBytes > MAX_PATH_RESULT_BYTES) {
|
|
@@ -57,26 +70,26 @@ export class WorkspaceFileService {
|
|
|
57
70
|
resultBytes += itemBytes;
|
|
58
71
|
}
|
|
59
72
|
entries.sort((a, b) => a.type.localeCompare(b.type) || a.name.localeCompare(b.name));
|
|
60
|
-
return { path: this.displayPath(full), entries, truncated };
|
|
73
|
+
return { path: this.displayPath(full, context), entries, truncated };
|
|
61
74
|
}
|
|
62
75
|
|
|
63
76
|
async listFiles(inputPath, maxFiles, context = {}) {
|
|
64
|
-
const root = await this.resolveExistingPath(inputPath);
|
|
77
|
+
const root = await this.resolveExistingPath(inputPath, context);
|
|
65
78
|
const info = await stat(root);
|
|
66
|
-
if (info.isFile()) return { path: this.displayPath(root), files: [this.displayPath(root)], truncated: false };
|
|
67
|
-
if (!info.isDirectory()) throw new
|
|
79
|
+
if (info.isFile()) return { path: this.displayPath(root, context), files: [this.displayPath(root, context)], truncated: false };
|
|
80
|
+
if (!info.isDirectory()) throw new BridgeError("invalid_request", "path is not a file or directory", { details: { reason: "unsupported_path_type" } });
|
|
68
81
|
const files = [];
|
|
69
82
|
let resultBytes = 0;
|
|
70
83
|
const walkResult = await this.walk(root, async full => {
|
|
71
84
|
this.throwIfCancelled(context);
|
|
72
|
-
const shown = this.displayPath(full);
|
|
85
|
+
const shown = this.displayPath(full, context);
|
|
73
86
|
const pathBytes = Buffer.byteLength(shown) + 8;
|
|
74
87
|
if (files.length >= maxFiles || resultBytes + pathBytes > MAX_PATH_RESULT_BYTES) return false;
|
|
75
88
|
files.push(shown);
|
|
76
89
|
resultBytes += pathBytes;
|
|
77
90
|
return true;
|
|
78
91
|
}, context);
|
|
79
|
-
return { path: this.displayPath(root), files, truncated: files.length >= maxFiles || resultBytes >= MAX_PATH_RESULT_BYTES || walkResult.truncated };
|
|
92
|
+
return { path: this.displayPath(root, context), files, truncated: files.length >= maxFiles || resultBytes >= MAX_PATH_RESULT_BYTES || walkResult.truncated };
|
|
80
93
|
}
|
|
81
94
|
|
|
82
95
|
async readFile(args, context = {}) {
|
|
@@ -84,8 +97,8 @@ export class WorkspaceFileService {
|
|
|
84
97
|
args = { path: args, max_bytes: typeof context === "number" ? context : undefined };
|
|
85
98
|
context = {};
|
|
86
99
|
}
|
|
87
|
-
if (!args.path) throw new
|
|
88
|
-
const full = await this.resolveExistingPath(args.path);
|
|
100
|
+
if (!args.path) throw new BridgeError("invalid_request", "path is required", { details: { reason: "missing_path" } });
|
|
101
|
+
const full = await this.resolveExistingPath(args.path, context);
|
|
89
102
|
this.throwIfCancelled(context);
|
|
90
103
|
const { buffer, info } = await readBoundedFile(full, MAX_WRITE_BYTES, "readable text file");
|
|
91
104
|
const content = decodeUtf8(buffer);
|
|
@@ -98,16 +111,16 @@ export class WorkspaceFileService {
|
|
|
98
111
|
}
|
|
99
112
|
const totalLines = lineStarts.length;
|
|
100
113
|
const endLine = args.end_line === undefined ? totalLines : clampInteger(args.end_line, totalLines, 1, Number.MAX_SAFE_INTEGER);
|
|
101
|
-
if (endLine < startLine) throw new
|
|
102
|
-
if (startLine > totalLines) throw new
|
|
114
|
+
if (endLine < startLine) throw new BridgeError("invalid_request", "end_line must be greater than or equal to start_line", { details: { reason: "invalid_line_range" } });
|
|
115
|
+
if (startLine > totalLines) throw new BridgeError("invalid_request", `start_line exceeds total lines (${startLine} > ${totalLines})`, { details: { reason: "line_out_of_range", total_lines: totalLines } });
|
|
103
116
|
const selectedEnd = Math.min(endLine, totalLines);
|
|
104
117
|
const selectedStartOffset = lineStarts[startLine - 1];
|
|
105
118
|
const selectedEndOffset = selectedEnd < totalLines ? lineStarts[selectedEnd] : content.length;
|
|
106
119
|
const selected = content.slice(selectedStartOffset, selectedEndOffset);
|
|
107
120
|
const selectedBytes = Buffer.byteLength(selected);
|
|
108
|
-
if (selectedBytes > maxBytes) throw new
|
|
121
|
+
if (selectedBytes > maxBytes) throw new BridgeError("limit_exceeded", `selected content exceeds max_bytes (${selectedBytes} > ${maxBytes})`, { details: { reason: "read_limit", selected_bytes: selectedBytes, maximum_bytes: maxBytes } });
|
|
109
122
|
return {
|
|
110
|
-
path: this.displayPath(full),
|
|
123
|
+
path: this.displayPath(full, context),
|
|
111
124
|
size: info.size,
|
|
112
125
|
sha256: sha256(content),
|
|
113
126
|
content: selected,
|
|
@@ -119,18 +132,18 @@ export class WorkspaceFileService {
|
|
|
119
132
|
}
|
|
120
133
|
|
|
121
134
|
async viewImage(args, context = {}) {
|
|
122
|
-
if (!args.path) throw new
|
|
123
|
-
const full = await this.resolveExistingPath(args.path);
|
|
135
|
+
if (!args.path) throw new BridgeError("invalid_request", "path is required", { details: { reason: "missing_path" } });
|
|
136
|
+
const full = await this.resolveExistingPath(args.path, context);
|
|
124
137
|
this.throwIfCancelled(context);
|
|
125
138
|
const { buffer, info } = await readBoundedFile(full, MAX_IMAGE_BYTES, "image");
|
|
126
139
|
this.throwIfCancelled(context);
|
|
127
140
|
const mimeType = detectImageMime(buffer);
|
|
128
|
-
if (!mimeType) throw new
|
|
141
|
+
if (!mimeType) throw new BridgeError("invalid_request", "unsupported image format; expected PNG, JPEG, GIF, or WebP", { details: { reason: "unsupported_image_format" } });
|
|
129
142
|
return {
|
|
130
143
|
$mcp: {
|
|
131
144
|
content: [{ type: "image", data: buffer.toString("base64"), mimeType }],
|
|
132
145
|
structuredContent: {
|
|
133
|
-
path: this.displayPath(full),
|
|
146
|
+
path: this.displayPath(full, context),
|
|
134
147
|
size: info.size,
|
|
135
148
|
sha256: createHash("sha256").update(buffer).digest("hex"),
|
|
136
149
|
mime_type: mimeType,
|
|
@@ -140,133 +153,152 @@ export class WorkspaceFileService {
|
|
|
140
153
|
}
|
|
141
154
|
|
|
142
155
|
async writeFile(args, context = {}) {
|
|
143
|
-
|
|
156
|
+
this.throwIfCancelled(context);
|
|
157
|
+
this.policyGate.assert("write_file");
|
|
158
|
+
if (!args.path) throw new BridgeError("invalid_request", "path is required", { details: { reason: "missing_path" } });
|
|
159
|
+
const content = String(args.content ?? "");
|
|
160
|
+
const bytes = Buffer.byteLength(content);
|
|
161
|
+
if (bytes > MAX_WRITE_BYTES) throw new BridgeError("limit_exceeded", `content exceeds maximum write size (${bytes} > ${MAX_WRITE_BYTES})`, { details: { reason: "write_limit", bytes, maximum_bytes: MAX_WRITE_BYTES } });
|
|
162
|
+
const full = await this.resolveWritePath(args.path, context);
|
|
163
|
+
return this.withMutationPaths([full], async () => {
|
|
144
164
|
this.throwIfCancelled(context);
|
|
145
|
-
|
|
146
|
-
if (
|
|
147
|
-
|
|
148
|
-
|
|
149
|
-
if (bytes > MAX_WRITE_BYTES) throw new Error(`content exceeds maximum write size (${bytes} > ${MAX_WRITE_BYTES})`);
|
|
150
|
-
const full = await this.resolveWritePath(args.path);
|
|
151
|
-
const existing = await lstat(full).catch(() => null);
|
|
152
|
-
if (existing?.isSymbolicLink()) throw new Error("refusing to overwrite a symbolic link");
|
|
153
|
-
if (args.create_only && existing) throw new Error("file exists and create_only=true");
|
|
154
|
-
if (existing && !existing.isFile()) throw new Error("path is not a regular file");
|
|
165
|
+
const existing = await pathEntryIfExists(full);
|
|
166
|
+
if (existing?.isSymbolicLink()) throw new BridgeError("conflict", "refusing to overwrite a symbolic link", { details: { reason: "symbolic_link" } });
|
|
167
|
+
if (args.create_only && existing) throw new BridgeError("conflict", "file exists and create_only=true", { details: { reason: "already_exists" } });
|
|
168
|
+
if (existing && !existing.isFile()) throw new BridgeError("conflict", "path is not a regular file", { details: { reason: "unsupported_target_type" } });
|
|
155
169
|
if (args.expected_sha256) {
|
|
156
|
-
if (!existing) throw new
|
|
170
|
+
if (!existing) throw new BridgeError("conflict", "expected_sha256 requires an existing file", { details: { reason: "precondition_target_missing" } });
|
|
157
171
|
const current = await readUtf8File(full);
|
|
158
|
-
if (sha256(current) !== String(args.expected_sha256).toLowerCase()) throw new
|
|
172
|
+
if (sha256(current) !== String(args.expected_sha256).toLowerCase()) throw new BridgeError("conflict", "expected_sha256 mismatch", { details: { reason: "hash_mismatch" } });
|
|
159
173
|
}
|
|
160
174
|
this.throwIfCancelled(context);
|
|
161
|
-
await
|
|
175
|
+
const commit = await commitAtomicText(full, content, existing, {
|
|
176
|
+
readText: readUtf8File,
|
|
162
177
|
createOnly: args.create_only === true,
|
|
163
178
|
expectedHash: args.expected_sha256 ? String(args.expected_sha256).toLowerCase() : undefined,
|
|
164
179
|
});
|
|
165
|
-
return { ok: true, path: this.displayPath(full), sha256: sha256(content), bytes };
|
|
180
|
+
return { ok: true, path: this.displayPath(full, context), sha256: sha256(content), bytes, ...(commit.warnings.length ? { warnings: commit.warnings } : {}) };
|
|
166
181
|
});
|
|
167
182
|
}
|
|
168
|
-
|
|
169
183
|
async editFile(args, context = {}) {
|
|
170
|
-
|
|
184
|
+
this.throwIfCancelled(context);
|
|
185
|
+
this.policyGate.assert("edit_file");
|
|
186
|
+
if (!args.path) throw new BridgeError("invalid_request", "path is required", { details: { reason: "missing_path" } });
|
|
187
|
+
const oldText = String(args.old_text ?? "");
|
|
188
|
+
const newText = String(args.new_text ?? "");
|
|
189
|
+
if (!oldText) throw new BridgeError("invalid_request", "old_text must not be empty", { details: { reason: "empty_old_text" } });
|
|
190
|
+
const full = await this.resolveExistingPath(args.path, context);
|
|
191
|
+
return this.withMutationPaths([full], async () => {
|
|
171
192
|
this.throwIfCancelled(context);
|
|
172
|
-
this.policyGate.assert("edit_file");
|
|
173
|
-
if (!args.path) throw new Error("path is required");
|
|
174
|
-
const oldText = String(args.old_text ?? "");
|
|
175
|
-
const newText = String(args.new_text ?? "");
|
|
176
|
-
if (!oldText) throw new Error("old_text must not be empty");
|
|
177
|
-
const full = await this.resolveExistingPath(args.path);
|
|
178
193
|
const info = await lstat(full);
|
|
179
|
-
if (!info.isFile() || info.isSymbolicLink()) throw new
|
|
194
|
+
if (!info.isFile() || info.isSymbolicLink()) throw new BridgeError("conflict", "path is not a regular non-symbolic-link file", { details: { reason: "unsupported_target_type" } });
|
|
180
195
|
const current = await readUtf8File(full);
|
|
181
|
-
if (args.expected_sha256 && sha256(current) !== String(args.expected_sha256).toLowerCase()) throw new
|
|
196
|
+
if (args.expected_sha256 && sha256(current) !== String(args.expected_sha256).toLowerCase()) throw new BridgeError("conflict", "expected_sha256 mismatch", { details: { reason: "hash_mismatch" } });
|
|
182
197
|
const occurrences = countOccurrences(current, oldText);
|
|
183
|
-
if (occurrences === 0) throw new
|
|
184
|
-
if (!args.replace_all && occurrences !== 1) throw new
|
|
198
|
+
if (occurrences === 0) throw new BridgeError("not_found", "old_text was not found", { details: { reason: "text_not_found" } });
|
|
199
|
+
if (!args.replace_all && occurrences !== 1) throw new BridgeError("conflict", `old_text occurs ${occurrences} times; provide a unique fragment or set replace_all=true`, { details: { reason: "text_ambiguous", occurrences } });
|
|
185
200
|
const updated = args.replace_all ? current.split(oldText).join(newText) : current.replace(oldText, newText);
|
|
186
201
|
const bytes = Buffer.byteLength(updated);
|
|
187
|
-
if (bytes > MAX_WRITE_BYTES) throw new
|
|
202
|
+
if (bytes > MAX_WRITE_BYTES) throw new BridgeError("limit_exceeded", `edited content exceeds maximum write size (${bytes} > ${MAX_WRITE_BYTES})`, { details: { reason: "write_limit", bytes, maximum_bytes: MAX_WRITE_BYTES } });
|
|
188
203
|
this.throwIfCancelled(context);
|
|
189
|
-
await
|
|
190
|
-
return { ok: true, path: this.displayPath(full), replacements: args.replace_all ? occurrences : 1, sha256: sha256(updated), bytes };
|
|
204
|
+
await commitAtomicText(full, updated, info, { expectedHash: sha256(current), readText: readUtf8File });
|
|
205
|
+
return { ok: true, path: this.displayPath(full, context), replacements: args.replace_all ? occurrences : 1, sha256: sha256(updated), bytes };
|
|
191
206
|
});
|
|
192
207
|
}
|
|
193
|
-
|
|
194
208
|
async applyPatch(args, context = {}) {
|
|
195
|
-
|
|
209
|
+
this.throwIfCancelled(context);
|
|
210
|
+
this.policyGate.assert("apply_patch");
|
|
211
|
+
const patchText = String(args.patch ?? "");
|
|
212
|
+
if (!patchText) throw new BridgeError("invalid_request", "patch is required", { details: { reason: "missing_patch" } });
|
|
213
|
+
if (Buffer.byteLength(patchText) > MAX_WRITE_BYTES) throw new BridgeError("limit_exceeded", "patch exceeds maximum size", { details: { reason: "patch_limit", maximum_bytes: MAX_WRITE_BYTES } });
|
|
214
|
+
const parsed = parsePatchEnvelope(patchText);
|
|
215
|
+
const resolved = [];
|
|
216
|
+
for (const operation of parsed) {
|
|
217
|
+
this.throwIfCancelled(context);
|
|
218
|
+
if (operation.kind === "add") {
|
|
219
|
+
resolved.push({ operation, kind: "add", source: null, target: await this.resolveWritePath(operation.path, context) });
|
|
220
|
+
continue;
|
|
221
|
+
}
|
|
222
|
+
const source = await this.resolveExistingPath(operation.path, context);
|
|
223
|
+
const target = operation.kind === "update" && operation.moveTo
|
|
224
|
+
? await this.resolveWritePath(operation.moveTo, context)
|
|
225
|
+
: operation.kind === "delete" ? null : source;
|
|
226
|
+
resolved.push({ operation, kind: operation.kind === "delete" ? "delete" : operation.moveTo ? "move" : "update", source, target });
|
|
227
|
+
}
|
|
228
|
+
assertResolvedPatchCollisions(resolved);
|
|
229
|
+
const mutationPaths = resolved.flatMap((item) => [item.source, item.target].filter(Boolean));
|
|
230
|
+
return this.withMutationPaths(mutationPaths, async () => {
|
|
196
231
|
this.throwIfCancelled(context);
|
|
197
|
-
this.policyGate.assert("apply_patch");
|
|
198
|
-
const patchText = String(args.patch ?? "");
|
|
199
|
-
if (!patchText) throw new Error("patch is required");
|
|
200
|
-
if (Buffer.byteLength(patchText) > MAX_WRITE_BYTES) throw new Error("patch exceeds maximum size");
|
|
201
|
-
const parsed = parsePatchEnvelope(patchText);
|
|
202
232
|
const prepared = [];
|
|
203
|
-
for (const
|
|
233
|
+
for (const item of resolved) {
|
|
234
|
+
const { operation, source, target } = item;
|
|
204
235
|
this.throwIfCancelled(context);
|
|
205
|
-
if (
|
|
206
|
-
|
|
207
|
-
|
|
208
|
-
assertTextSize(operation.content, operation.path);
|
|
236
|
+
if (item.kind === "add") {
|
|
237
|
+
if (await pathEntryIfExists(target)) throw new BridgeError("conflict", "add target already exists", { details: { reason: "already_exists", operation: "add" } });
|
|
238
|
+
assertTextSize(operation.content);
|
|
209
239
|
prepared.push({ kind: "add", source: null, target, content: operation.content, mode: 0o600 });
|
|
210
240
|
continue;
|
|
211
241
|
}
|
|
212
|
-
const source = await this.resolveExistingPath(operation.path);
|
|
213
242
|
const sourceInfo = await lstat(source);
|
|
214
|
-
if (!sourceInfo.isFile() || sourceInfo.isSymbolicLink()) throw new
|
|
243
|
+
if (!sourceInfo.isFile() || sourceInfo.isSymbolicLink()) throw new BridgeError("conflict", "patch source is not a regular file", { details: { reason: "unsupported_source_type" } });
|
|
215
244
|
const original = await readUtf8File(source);
|
|
216
|
-
if (
|
|
245
|
+
if (item.kind === "delete") {
|
|
217
246
|
prepared.push({ kind: "delete", source, target: null, originalHash: sha256(original), mode: sourceInfo.mode & 0o777 });
|
|
218
247
|
continue;
|
|
219
248
|
}
|
|
220
|
-
const content = applyUpdateHunks(original, operation.hunks
|
|
221
|
-
assertTextSize(content
|
|
222
|
-
|
|
223
|
-
|
|
224
|
-
prepared.push({ kind: operation.moveTo ? "move" : "update", source, target, content, originalHash: sha256(original), mode: sourceInfo.mode & 0o777 });
|
|
249
|
+
const content = applyUpdateHunks(original, operation.hunks);
|
|
250
|
+
assertTextSize(content);
|
|
251
|
+
if (target !== source && await pathEntryIfExists(target)) throw new BridgeError("conflict", "move target already exists", { details: { reason: "already_exists", operation: "move" } });
|
|
252
|
+
prepared.push({ kind: item.kind, source, target, content, originalHash: sha256(original), mode: sourceInfo.mode & 0o777 });
|
|
225
253
|
}
|
|
226
|
-
assertNoResolvedPatchCollisions(prepared);
|
|
227
254
|
this.throwIfCancelled(context);
|
|
228
|
-
const transaction = await
|
|
255
|
+
const transaction = await commitPatchOperations(prepared, { readText: readUtf8File });
|
|
229
256
|
return {
|
|
230
257
|
ok: true,
|
|
231
258
|
...(transaction.warnings.length ? { warnings: transaction.warnings } : {}),
|
|
232
259
|
files: prepared.map((item) => ({
|
|
233
260
|
operation: item.kind,
|
|
234
|
-
path: this.displayPath(item.target || item.source),
|
|
235
|
-
|
|
236
|
-
|
|
261
|
+
path: this.displayPath(item.target || item.source, context),
|
|
262
|
+
...(item.kind === "move" ? { from: this.displayPath(item.source, context) } : {}),
|
|
263
|
+
...(item.content === undefined ? {} : { sha256: sha256(item.content) }),
|
|
237
264
|
})),
|
|
238
265
|
};
|
|
239
266
|
});
|
|
240
267
|
}
|
|
241
|
-
|
|
242
268
|
async searchText(args, context = {}) {
|
|
243
269
|
const query = String(args.query || "");
|
|
244
|
-
if (!query) throw new
|
|
245
|
-
const root = await this.resolveExistingPath(args.path || ".");
|
|
270
|
+
if (!query) throw new BridgeError("invalid_request", "query is required", { details: { reason: "missing_query" } });
|
|
271
|
+
const root = await this.resolveExistingPath(args.path || ".", context);
|
|
246
272
|
const max = clampInteger(args.max_matches, 100, 1, 1000);
|
|
247
273
|
const maxFiles = clampInteger(args.max_files, 10000, 1, 100000);
|
|
248
|
-
let visitedFiles = 0;
|
|
249
274
|
const matches = [];
|
|
250
275
|
const rootInfo = await stat(root);
|
|
251
276
|
if (rootInfo.isFile()) {
|
|
252
277
|
await this.searchOneFile(root, query, matches, max, context);
|
|
253
|
-
return { query, root: this.displayPath(root), matches, visited_files: 1, truncated: matches.length >= max };
|
|
278
|
+
return { query, root: this.displayPath(root, context), matches, visited_files: 1, truncated: matches.length >= max };
|
|
254
279
|
}
|
|
255
|
-
if (!rootInfo.isDirectory()) throw new
|
|
256
|
-
const
|
|
257
|
-
|
|
258
|
-
|
|
259
|
-
|
|
260
|
-
|
|
261
|
-
|
|
262
|
-
|
|
263
|
-
|
|
280
|
+
if (!rootInfo.isDirectory()) throw new BridgeError("invalid_request", "path is not a file or directory", { details: { reason: "unsupported_path_type" } });
|
|
281
|
+
const result = await searchWorkspaceFiles({
|
|
282
|
+
maximumFiles: maxFiles, maximumMatches: max,
|
|
283
|
+
walk: (onFile) => this.walk(root, onFile, context),
|
|
284
|
+
searchFile: async (full) => {
|
|
285
|
+
const fileMatches = [];
|
|
286
|
+
await this.searchOneFile(full, query, fileMatches, max, context);
|
|
287
|
+
return fileMatches;
|
|
288
|
+
},
|
|
289
|
+
throwIfCancelled: this.throwIfCancelled, context,
|
|
290
|
+
});
|
|
291
|
+
return { query, root: this.displayPath(root, context), matches: result.matches, visited_files: result.visitedFiles, truncated: result.truncated };
|
|
264
292
|
}
|
|
265
293
|
|
|
266
294
|
async searchOneFile(full, query, matches, max, context = {}) {
|
|
267
295
|
this.throwIfCancelled(context);
|
|
268
|
-
|
|
269
|
-
|
|
296
|
+
let bounded;
|
|
297
|
+
try { bounded = await readBoundedFile(full, 1024 * 1024, "search file"); } catch (error) {
|
|
298
|
+
if (isSkippableSearchFileError(error)) return;
|
|
299
|
+
throw error;
|
|
300
|
+
}
|
|
301
|
+
if (bounded.buffer.includes(0)) return;
|
|
270
302
|
const buffer = bounded.buffer;
|
|
271
303
|
let text;
|
|
272
304
|
try { text = new TextDecoder("utf-8", { fatal: true }).decode(buffer); } catch { return; }
|
|
@@ -274,7 +306,7 @@ export class WorkspaceFileService {
|
|
|
274
306
|
const lines = text.split(/\r?\n/);
|
|
275
307
|
for (let index = 0; index < lines.length; index += 1) {
|
|
276
308
|
if (lines[index].includes(query)) {
|
|
277
|
-
matches.push({ path: this.displayPath(full), line: index + 1, text: lines[index].slice(0, 500) });
|
|
309
|
+
matches.push({ path: this.displayPath(full, context), line: index + 1, text: lines[index].slice(0, 500) });
|
|
278
310
|
if (matches.length >= max) break;
|
|
279
311
|
}
|
|
280
312
|
}
|
|
@@ -286,7 +318,7 @@ export class WorkspaceFileService {
|
|
|
286
318
|
while (stack.length) {
|
|
287
319
|
this.throwIfCancelled(context);
|
|
288
320
|
const current = stack.pop();
|
|
289
|
-
const entries = await
|
|
321
|
+
const entries = await openDirectoryIfExists(current);
|
|
290
322
|
if (!entries) continue;
|
|
291
323
|
for await (const entry of entries) {
|
|
292
324
|
this.throwIfCancelled(context);
|
|
@@ -310,8 +342,9 @@ export async function readBoundedFile(filePath, maxBytes, label) {
|
|
|
310
342
|
const handle = await open(filePath, flags);
|
|
311
343
|
try {
|
|
312
344
|
const info = await handle.stat();
|
|
313
|
-
if (!info.isFile()) throw new
|
|
314
|
-
if (info.
|
|
345
|
+
if (!info.isFile()) throw new BridgeError("invalid_request", `${label} is not a regular file`, { details: { reason: "unsupported_path_type" } });
|
|
346
|
+
if (Number(info.nlink) > 1) throw new BridgeError("permission_denied", `refusing to read ${label} with multiple hard links`, { details: { reason: "multiple_hard_links" } });
|
|
347
|
+
if (info.size > maxBytes) throw new BridgeError("limit_exceeded", `${label} exceeds maximum size (${info.size} > ${maxBytes})`, { details: { reason: "read_limit", size: info.size, maximum_bytes: maxBytes } });
|
|
315
348
|
const buffer = Buffer.alloc(info.size);
|
|
316
349
|
let offset = 0;
|
|
317
350
|
while (offset < buffer.length) {
|
|
@@ -325,9 +358,17 @@ export async function readBoundedFile(filePath, maxBytes, label) {
|
|
|
325
358
|
}
|
|
326
359
|
}
|
|
327
360
|
|
|
361
|
+
function isSkippableSearchFileError(error) {
|
|
362
|
+
const reason = String(error?.details?.reason || "");
|
|
363
|
+
return error?.code === "ELOOP"
|
|
364
|
+
|| reason === "read_limit"
|
|
365
|
+
|| reason === "unsupported_path_type"
|
|
366
|
+
|| reason === "multiple_hard_links";
|
|
367
|
+
}
|
|
368
|
+
|
|
328
369
|
function decodeUtf8(buffer) {
|
|
329
370
|
try { return new TextDecoder("utf-8", { fatal: true }).decode(buffer); } catch {
|
|
330
|
-
throw new
|
|
371
|
+
throw new BridgeError("invalid_request", "file is not valid UTF-8 text", { details: { reason: "invalid_utf8" } });
|
|
331
372
|
}
|
|
332
373
|
}
|
|
333
374
|
|
|
@@ -336,138 +377,17 @@ async function readUtf8File(filePath) {
|
|
|
336
377
|
return decodeUtf8(buffer);
|
|
337
378
|
}
|
|
338
379
|
|
|
339
|
-
|
|
340
|
-
|
|
341
|
-
let failure = null;
|
|
342
|
-
try {
|
|
343
|
-
await handle.writeFile(content, { encoding: "utf8" });
|
|
344
|
-
try { await handle.chmod(mode); } catch (error) { if (process.platform !== "win32") throw error; }
|
|
345
|
-
await handle.sync();
|
|
346
|
-
} catch (error) {
|
|
347
|
-
failure = error;
|
|
348
|
-
}
|
|
349
|
-
try { await handle.close(); } catch (error) { failure ||= error; }
|
|
350
|
-
if (failure) {
|
|
351
|
-
try { await rm(filePath, { force: true }); } catch {
|
|
352
|
-
throw new Error("staged file write failed and cleanup was incomplete; inspect the destination directory before retrying", { cause: failure });
|
|
353
|
-
}
|
|
354
|
-
throw failure;
|
|
355
|
-
}
|
|
356
|
-
}
|
|
357
|
-
|
|
358
|
-
async function atomicWriteText(full, content, existing = null, options = {}) {
|
|
359
|
-
await mkdir(dirname(full), { recursive: true });
|
|
360
|
-
const temp = join(dirname(full), `.${basename(full)}.mbm-${process.pid}-${randomBytes(6).toString("hex")}.tmp`);
|
|
361
|
-
try {
|
|
362
|
-
await writeFlushedText(temp, content, existing ? existing.mode & 0o777 : 0o600);
|
|
363
|
-
if (options.expectedHash) {
|
|
364
|
-
const current = await readUtf8File(full).catch(() => null);
|
|
365
|
-
if (current === null || sha256(current) !== options.expectedHash) throw new Error("file changed before atomic commit");
|
|
366
|
-
}
|
|
367
|
-
if (options.createOnly) {
|
|
368
|
-
await link(temp, full);
|
|
369
|
-
await rm(temp, { force: true });
|
|
370
|
-
} else {
|
|
371
|
-
await rename(temp, full);
|
|
372
|
-
}
|
|
373
|
-
} catch (error) {
|
|
374
|
-
await rm(temp, { force: true }).catch(() => {});
|
|
375
|
-
throw error;
|
|
376
|
-
}
|
|
377
|
-
}
|
|
378
|
-
|
|
379
|
-
function assertNoResolvedPatchCollisions(operations) {
|
|
380
|
-
const owners = new Map();
|
|
381
|
-
for (const operation of operations) {
|
|
382
|
-
const paths = operation.source === operation.target
|
|
383
|
-
? [operation.source]
|
|
384
|
-
: [operation.source, operation.target].filter(Boolean);
|
|
385
|
-
for (const full of paths) {
|
|
386
|
-
const key = process.platform === "win32" ? String(full).toLowerCase() : String(full);
|
|
387
|
-
const previous = owners.get(key);
|
|
388
|
-
if (previous && previous !== operation) throw new Error(`patch operations resolve to the same path: ${full}`);
|
|
389
|
-
owners.set(key, operation);
|
|
390
|
-
}
|
|
391
|
-
}
|
|
392
|
-
}
|
|
393
|
-
|
|
394
|
-
export async function commitPatchTransaction(operations, options = {}) {
|
|
395
|
-
const move = options.rename || rename;
|
|
396
|
-
const remove = options.remove || rm;
|
|
397
|
-
const staged = [];
|
|
398
|
-
const committed = [];
|
|
399
|
-
try {
|
|
400
|
-
for (const operation of operations) {
|
|
401
|
-
if (operation.content === undefined) continue;
|
|
402
|
-
await mkdir(dirname(operation.target), { recursive: true });
|
|
403
|
-
const temp = join(dirname(operation.target), `.${basename(operation.target)}.mbm-patch-${process.pid}-${randomBytes(6).toString("hex")}.tmp`);
|
|
404
|
-
await writeFlushedText(temp, operation.content, operation.mode);
|
|
405
|
-
staged.push({ operation, temp });
|
|
406
|
-
}
|
|
407
|
-
|
|
408
|
-
for (const operation of operations) {
|
|
409
|
-
if (operation.source) {
|
|
410
|
-
const current = await readUtf8File(operation.source);
|
|
411
|
-
if (sha256(current) !== operation.originalHash) throw new Error(`patch source changed during apply: ${operation.source}`);
|
|
412
|
-
}
|
|
413
|
-
if (operation.kind === "add" || operation.kind === "move") {
|
|
414
|
-
if (await lstat(operation.target).catch(() => null)) throw new Error(`patch target appeared during apply: ${operation.target}`);
|
|
415
|
-
}
|
|
416
|
-
}
|
|
417
|
-
|
|
418
|
-
for (const operation of operations) {
|
|
419
|
-
let backup = null;
|
|
420
|
-
if (operation.source) {
|
|
421
|
-
backup = join(dirname(operation.source), `.${basename(operation.source)}.mbm-backup-${process.pid}-${randomBytes(6).toString("hex")}`);
|
|
422
|
-
await move(operation.source, backup);
|
|
423
|
-
}
|
|
424
|
-
const record = { operation, backup, targetCreated: false };
|
|
425
|
-
committed.push(record);
|
|
426
|
-
const stage = staged.find((item) => item.operation === operation);
|
|
427
|
-
if (stage) {
|
|
428
|
-
await move(stage.temp, operation.target);
|
|
429
|
-
record.targetCreated = true;
|
|
430
|
-
}
|
|
431
|
-
}
|
|
432
|
-
} catch (error) {
|
|
433
|
-
const recoveryFailures = [];
|
|
434
|
-
for (const item of [...committed].reverse()) {
|
|
435
|
-
if (item.targetCreated) {
|
|
436
|
-
try { await remove(item.operation.target, { force: true }); } catch (failure) { recoveryFailures.push(failure); }
|
|
437
|
-
}
|
|
438
|
-
if (item.backup) {
|
|
439
|
-
try { await move(item.backup, item.operation.source); } catch (failure) { recoveryFailures.push(failure); }
|
|
440
|
-
}
|
|
441
|
-
}
|
|
442
|
-
recoveryFailures.push(...await removePatchArtifacts(staged.map((item) => item.temp), remove));
|
|
443
|
-
if (recoveryFailures.length) {
|
|
444
|
-
throw new Error(`patch transaction failed and recovery was incomplete (${recoveryFailures.length} recovery operation(s) failed); inspect the workspace before retrying`, { cause: error });
|
|
445
|
-
}
|
|
446
|
-
throw error;
|
|
447
|
-
}
|
|
448
|
-
|
|
449
|
-
const cleanupFailures = await removePatchArtifacts([
|
|
450
|
-
...staged.map((item) => item.temp),
|
|
451
|
-
...committed.map((item) => item.backup).filter(Boolean),
|
|
452
|
-
], remove);
|
|
453
|
-
return {
|
|
454
|
-
warnings: cleanupFailures.length
|
|
455
|
-
? [`Patch committed, but ${cleanupFailures.length} internal transaction artifact(s) could not be removed; inspect affected directories for .mbm-backup-* or .mbm-patch-* files.`]
|
|
456
|
-
: [],
|
|
457
|
-
};
|
|
380
|
+
export function atomicWriteText(full, content, existing = null, options = {}) {
|
|
381
|
+
return commitAtomicText(full, content, existing, { ...options, readText: options.readText || readUtf8File });
|
|
458
382
|
}
|
|
459
383
|
|
|
460
|
-
|
|
461
|
-
|
|
462
|
-
for (const path of paths) {
|
|
463
|
-
try { await remove(path, { force: true }); } catch (error) { failures.push(error); }
|
|
464
|
-
}
|
|
465
|
-
return failures;
|
|
384
|
+
export function commitPatchTransaction(operations, options = {}) {
|
|
385
|
+
return commitPatchOperations(operations, { ...options, readText: options.readText || readUtf8File });
|
|
466
386
|
}
|
|
467
387
|
|
|
468
|
-
function assertTextSize(content
|
|
388
|
+
function assertTextSize(content) {
|
|
469
389
|
const bytes = Buffer.byteLength(content);
|
|
470
|
-
if (bytes > MAX_WRITE_BYTES) throw new
|
|
390
|
+
if (bytes > MAX_WRITE_BYTES) throw new BridgeError("limit_exceeded", `patched file exceeds maximum size (${bytes} > ${MAX_WRITE_BYTES})`, { details: { reason: "write_limit", bytes, maximum_bytes: MAX_WRITE_BYTES } });
|
|
471
391
|
}
|
|
472
392
|
|
|
473
393
|
function countOccurrences(content, needle) {
|
|
@@ -480,9 +400,6 @@ function countOccurrences(content, needle) {
|
|
|
480
400
|
return count;
|
|
481
401
|
}
|
|
482
402
|
|
|
483
|
-
export function sha256(value) {
|
|
484
|
-
return createHash("sha256").update(String(value)).digest("hex");
|
|
485
|
-
}
|
|
486
403
|
|
|
487
404
|
function detectImageMime(buffer) {
|
|
488
405
|
if (buffer.length >= 8 && buffer.subarray(0, 8).equals(Buffer.from([0x89, 0x50, 0x4e, 0x47, 0x0d, 0x0a, 0x1a, 0x0a]))) return "image/png";
|