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
|
@@ -0,0 +1,398 @@
|
|
|
1
|
+
import { createHash, randomBytes } from "node:crypto";
|
|
2
|
+
import { chmod, lstat, mkdir, readFile, rename, rm, writeFile } from "node:fs/promises";
|
|
3
|
+
import path from "node:path";
|
|
4
|
+
import { errorCode } from "./errors.mjs";
|
|
5
|
+
import { packageRoot } from "./package-identity.mjs";
|
|
6
|
+
|
|
7
|
+
const SOURCE_RELATIVE = path.join("native", "macos", "MachineBridgeBackgroundInput.swift");
|
|
8
|
+
const MAX_OUTPUT_BYTES = 64 * 1024;
|
|
9
|
+
|
|
10
|
+
export class MacosBackgroundInputService {
|
|
11
|
+
constructor({ runProcess, cacheRoot, platform = process.platform, sourceRoot = packageRoot }) {
|
|
12
|
+
if (typeof runProcess !== "function") throw new Error("macOS background input requires runProcess");
|
|
13
|
+
if (typeof cacheRoot !== "string" || !cacheRoot || !path.isAbsolute(cacheRoot)) throw new Error("macOS background input requires an absolute cacheRoot string");
|
|
14
|
+
this.runProcess = runProcess;
|
|
15
|
+
this.cacheRoot = path.resolve(cacheRoot);
|
|
16
|
+
this.platform = platform;
|
|
17
|
+
this.sourcePath = path.resolve(sourceRoot, SOURCE_RELATIVE);
|
|
18
|
+
this.binaryPath = "";
|
|
19
|
+
this.buildPromise = null;
|
|
20
|
+
this.lastProbe = null;
|
|
21
|
+
}
|
|
22
|
+
|
|
23
|
+
configured() {
|
|
24
|
+
return this.platform === "darwin";
|
|
25
|
+
}
|
|
26
|
+
|
|
27
|
+
status() {
|
|
28
|
+
return {
|
|
29
|
+
configured: this.configured(),
|
|
30
|
+
probed: this.lastProbe !== null,
|
|
31
|
+
available: this.lastProbe?.ok === true,
|
|
32
|
+
backend: "skylight-experimental",
|
|
33
|
+
error: safeErrorCode(this.lastProbe?.error),
|
|
34
|
+
};
|
|
35
|
+
}
|
|
36
|
+
|
|
37
|
+
async probe(context = {}, { force = false } = {}) {
|
|
38
|
+
if (!this.configured()) {
|
|
39
|
+
this.lastProbe = { ok: false, backend: "skylight-experimental", error: "unsupported_platform_before_dispatch" };
|
|
40
|
+
return { ...this.lastProbe };
|
|
41
|
+
}
|
|
42
|
+
if (!force && this.lastProbe) return { ...this.lastProbe };
|
|
43
|
+
try {
|
|
44
|
+
const result = await this.runHelper({ operation: "probe" }, 30, context);
|
|
45
|
+
this.lastProbe = { ...result, error: safeErrorCode(result.error) };
|
|
46
|
+
} catch (error) {
|
|
47
|
+
if (errorCode(error) === "cancelled") throw error;
|
|
48
|
+
this.lastProbe = { ok: false, backend: "skylight-experimental", error: "helper_probe_failed_before_dispatch" };
|
|
49
|
+
}
|
|
50
|
+
return { ...this.lastProbe };
|
|
51
|
+
}
|
|
52
|
+
|
|
53
|
+
async click(args = {}, context = {}) {
|
|
54
|
+
if (!this.configured()) throw new Error("macOS SkyLight background input unavailable before dispatch");
|
|
55
|
+
const probe = await this.probe(context);
|
|
56
|
+
if (probe.ok !== true) throw new Error(`macOS SkyLight background input unavailable before dispatch: ${safeErrorCode(probe.error) || "probe_failed"}`);
|
|
57
|
+
const clickCount = args.click_count === undefined ? 1 : positiveInteger(args.click_count, "click_count");
|
|
58
|
+
if (clickCount > 2) throw new Error("macOS background click_count must be 1 or 2");
|
|
59
|
+
const payload = {
|
|
60
|
+
operation: "click",
|
|
61
|
+
pid: positiveInteger(args.pid, "pid"),
|
|
62
|
+
process_generation: requiredProcessGeneration(args.process_generation),
|
|
63
|
+
window_id: positiveInteger(args.window_id, "window_id"),
|
|
64
|
+
screen_x: finiteNumber(args.screen_x, "screen_x"),
|
|
65
|
+
screen_y: finiteNumber(args.screen_y, "screen_y"),
|
|
66
|
+
local_x: nonNegativeFinite(args.local_x, "local_x"),
|
|
67
|
+
local_y: nonNegativeFinite(args.local_y, "local_y"),
|
|
68
|
+
...(clickCount === 1 ? {} : { click_count: clickCount }),
|
|
69
|
+
window_x: finiteNumber(args.window_x, "window_x"),
|
|
70
|
+
window_y: finiteNumber(args.window_y, "window_y"),
|
|
71
|
+
window_width: positiveFinite(args.window_width, "window_width"),
|
|
72
|
+
window_height: positiveFinite(args.window_height, "window_height"),
|
|
73
|
+
};
|
|
74
|
+
const result = await this.runHelper(payload, boundedTimeout(args.timeout_seconds), context, { mutating: true });
|
|
75
|
+
if (result.ok === true) return result;
|
|
76
|
+
if (result.dispatch_started === true || result.error === "dispatch_outcome_unknown") {
|
|
77
|
+
throw new Error("macOS SkyLight background input may have been partially dispatched; the action outcome is unknown");
|
|
78
|
+
}
|
|
79
|
+
throw new Error(`macOS SkyLight background input unavailable before dispatch: ${safeErrorCode(result.error)}`);
|
|
80
|
+
}
|
|
81
|
+
|
|
82
|
+
async drag(args = {}, context = {}) {
|
|
83
|
+
if (!this.configured()) throw new Error("macOS SkyLight background input unavailable before dispatch");
|
|
84
|
+
const probe = await this.probe(context);
|
|
85
|
+
if (probe.ok !== true) throw new Error(`macOS SkyLight background input unavailable before dispatch: ${safeErrorCode(probe.error) || "probe_failed"}`);
|
|
86
|
+
const payload = {
|
|
87
|
+
operation: "drag",
|
|
88
|
+
pid: positiveInteger(args.pid, "pid"),
|
|
89
|
+
process_generation: requiredProcessGeneration(args.process_generation),
|
|
90
|
+
window_id: positiveInteger(args.window_id, "window_id"),
|
|
91
|
+
screen_x: finiteNumber(args.screen_x, "screen_x"),
|
|
92
|
+
screen_y: finiteNumber(args.screen_y, "screen_y"),
|
|
93
|
+
local_x: nonNegativeFinite(args.local_x, "local_x"),
|
|
94
|
+
local_y: nonNegativeFinite(args.local_y, "local_y"),
|
|
95
|
+
destination_screen_x: finiteNumber(args.destination_screen_x, "destination_screen_x"),
|
|
96
|
+
destination_screen_y: finiteNumber(args.destination_screen_y, "destination_screen_y"),
|
|
97
|
+
destination_local_x: nonNegativeFinite(args.destination_local_x, "destination_local_x"),
|
|
98
|
+
destination_local_y: nonNegativeFinite(args.destination_local_y, "destination_local_y"),
|
|
99
|
+
window_x: finiteNumber(args.window_x, "window_x"),
|
|
100
|
+
window_y: finiteNumber(args.window_y, "window_y"),
|
|
101
|
+
window_width: positiveFinite(args.window_width, "window_width"),
|
|
102
|
+
window_height: positiveFinite(args.window_height, "window_height"),
|
|
103
|
+
};
|
|
104
|
+
const result = await this.runHelper(payload, boundedTimeout(args.timeout_seconds), context, { mutating: true });
|
|
105
|
+
if (result.ok === true) return result;
|
|
106
|
+
if (result.dispatch_started === true || result.error === "dispatch_outcome_unknown") {
|
|
107
|
+
throw new Error("macOS SkyLight background input may have been partially dispatched; the action outcome is unknown");
|
|
108
|
+
}
|
|
109
|
+
throw new Error(`macOS SkyLight background input unavailable before dispatch: ${safeErrorCode(result.error)}`);
|
|
110
|
+
}
|
|
111
|
+
|
|
112
|
+
async scroll(args = {}, context = {}) {
|
|
113
|
+
if (!this.configured()) throw new Error("macOS SkyLight background input unavailable before dispatch");
|
|
114
|
+
const probe = await this.probe(context);
|
|
115
|
+
if (probe.ok !== true) throw new Error(`macOS SkyLight background input unavailable before dispatch: ${safeErrorCode(probe.error) || "probe_failed"}`);
|
|
116
|
+
const deltaX = scrollDelta(args.delta_x, "delta_x");
|
|
117
|
+
const deltaY = scrollDelta(args.delta_y, "delta_y");
|
|
118
|
+
if (deltaX === 0 && deltaY === 0) throw new Error("macOS background scroll requires a non-zero delta_x or delta_y");
|
|
119
|
+
const payload = {
|
|
120
|
+
operation: "scroll",
|
|
121
|
+
pid: positiveInteger(args.pid, "pid"),
|
|
122
|
+
process_generation: requiredProcessGeneration(args.process_generation),
|
|
123
|
+
window_id: positiveInteger(args.window_id, "window_id"),
|
|
124
|
+
screen_x: finiteNumber(args.screen_x, "screen_x"),
|
|
125
|
+
screen_y: finiteNumber(args.screen_y, "screen_y"),
|
|
126
|
+
local_x: nonNegativeFinite(args.local_x, "local_x"),
|
|
127
|
+
local_y: nonNegativeFinite(args.local_y, "local_y"),
|
|
128
|
+
delta_x: deltaX,
|
|
129
|
+
delta_y: deltaY,
|
|
130
|
+
window_x: finiteNumber(args.window_x, "window_x"),
|
|
131
|
+
window_y: finiteNumber(args.window_y, "window_y"),
|
|
132
|
+
window_width: positiveFinite(args.window_width, "window_width"),
|
|
133
|
+
window_height: positiveFinite(args.window_height, "window_height"),
|
|
134
|
+
};
|
|
135
|
+
const result = await this.runHelper(payload, boundedTimeout(args.timeout_seconds), context, { mutating: true });
|
|
136
|
+
if (result.ok === true) return result;
|
|
137
|
+
if (result.dispatch_started === true || result.error === "dispatch_outcome_unknown") {
|
|
138
|
+
throw new Error("macOS SkyLight background input may have been partially dispatched; the action outcome is unknown");
|
|
139
|
+
}
|
|
140
|
+
throw new Error(`macOS SkyLight background input unavailable before dispatch: ${safeErrorCode(result.error)}`);
|
|
141
|
+
}
|
|
142
|
+
|
|
143
|
+
async keystroke(args = {}, context = {}) {
|
|
144
|
+
if (!this.configured()) throw new Error("macOS PID keyboard input unavailable before dispatch");
|
|
145
|
+
const text = args.text;
|
|
146
|
+
if (typeof text !== "string" || !text || text.includes("\0") || text.length > 4000) throw new Error("macOS PID keystroke text is invalid before dispatch");
|
|
147
|
+
const result = await this.runHelper({
|
|
148
|
+
operation: "unicode_keystroke",
|
|
149
|
+
pid: positiveInteger(args.pid, "pid"),
|
|
150
|
+
process_generation: requiredProcessGeneration(args.process_generation),
|
|
151
|
+
text,
|
|
152
|
+
}, boundedTimeout(args.timeout_seconds), context, { mutating: true });
|
|
153
|
+
return requireKeyboardSettlement(result);
|
|
154
|
+
}
|
|
155
|
+
|
|
156
|
+
async keyPress(args = {}, context = {}) {
|
|
157
|
+
if (!this.configured()) throw new Error("macOS PID keyboard input unavailable before dispatch");
|
|
158
|
+
const result = await this.runHelper({
|
|
159
|
+
operation: "key_press",
|
|
160
|
+
pid: positiveInteger(args.pid, "pid"),
|
|
161
|
+
process_generation: requiredProcessGeneration(args.process_generation),
|
|
162
|
+
key: requiredSpecialKey(args.key),
|
|
163
|
+
}, boundedTimeout(args.timeout_seconds), context, { mutating: true });
|
|
164
|
+
return requireKeyboardSettlement(result);
|
|
165
|
+
}
|
|
166
|
+
|
|
167
|
+
async runHelper(payload, timeoutSeconds, context, { mutating = false } = {}) {
|
|
168
|
+
const binary = await this.ensureBuilt(context);
|
|
169
|
+
let result;
|
|
170
|
+
try {
|
|
171
|
+
result = await this.runProcess(
|
|
172
|
+
binary,
|
|
173
|
+
[],
|
|
174
|
+
timeoutSeconds * 1000,
|
|
175
|
+
true,
|
|
176
|
+
MAX_OUTPUT_BYTES,
|
|
177
|
+
context,
|
|
178
|
+
undefined,
|
|
179
|
+
`${JSON.stringify(payload)}\n`,
|
|
180
|
+
mutating ? { nonReplayableMutation: true } : {},
|
|
181
|
+
);
|
|
182
|
+
} catch (error) {
|
|
183
|
+
if (mutating && error?.details?.reason === "process_outcome_unknown_after_spawn") throw backgroundInputOutcomeUnknown();
|
|
184
|
+
if (mutating && errorCode(error) !== "cancelled") {
|
|
185
|
+
throw new Error(`macOS native input helper unavailable before dispatch: ${safeErrorCode(errorCode(error))}`);
|
|
186
|
+
}
|
|
187
|
+
throw error;
|
|
188
|
+
}
|
|
189
|
+
if (!result || typeof result !== "object" || Array.isArray(result)
|
|
190
|
+
|| !Number.isSafeInteger(result.code) || typeof result.stdout !== "string") {
|
|
191
|
+
if (mutating) throw backgroundInputOutcomeUnknown();
|
|
192
|
+
throw new Error("macOS native input helper returned an invalid process settlement before dispatch");
|
|
193
|
+
}
|
|
194
|
+
const output = result.stdout.trim();
|
|
195
|
+
let parsed;
|
|
196
|
+
try { parsed = JSON.parse(output); }
|
|
197
|
+
catch {
|
|
198
|
+
if (mutating) throw backgroundInputOutcomeUnknown();
|
|
199
|
+
throw new Error("macOS native input helper returned invalid JSON before dispatch");
|
|
200
|
+
}
|
|
201
|
+
if (!parsed || typeof parsed !== "object" || Array.isArray(parsed)) {
|
|
202
|
+
if (mutating) throw backgroundInputOutcomeUnknown();
|
|
203
|
+
throw new Error("macOS native input helper returned an invalid response before dispatch");
|
|
204
|
+
}
|
|
205
|
+
if (mutating && (typeof parsed.ok !== "boolean" || typeof parsed.dispatch_started !== "boolean"
|
|
206
|
+
|| parsed.ok === true && parsed.dispatch_started !== true)) {
|
|
207
|
+
throw backgroundInputOutcomeUnknown();
|
|
208
|
+
}
|
|
209
|
+
if (mutating) {
|
|
210
|
+
if (Object.hasOwn(parsed, "error") && parsed.error !== null
|
|
211
|
+
&& (typeof parsed.error !== "string" || !/^[a-z0-9_-]{1,100}$/.test(parsed.error))) {
|
|
212
|
+
throw backgroundInputOutcomeUnknown();
|
|
213
|
+
}
|
|
214
|
+
if (parsed.ok === false && parsed.dispatch_started === false
|
|
215
|
+
&& (typeof parsed.error !== "string" || !/^[a-z0-9_-]{1,100}$/.test(parsed.error))) {
|
|
216
|
+
throw backgroundInputOutcomeUnknown();
|
|
217
|
+
}
|
|
218
|
+
if (parsed.ok === true && !["public-cgevent-pid", "skylight-pid"].includes(parsed.input_transport)) {
|
|
219
|
+
throw backgroundInputOutcomeUnknown();
|
|
220
|
+
}
|
|
221
|
+
for (const field of ["focus_without_raise", "frontmost_restored", "front_window_validated", "cursor_preserved"]) {
|
|
222
|
+
if (Object.hasOwn(parsed, field) && parsed[field] !== null && typeof parsed[field] !== "boolean") {
|
|
223
|
+
throw backgroundInputOutcomeUnknown();
|
|
224
|
+
}
|
|
225
|
+
}
|
|
226
|
+
}
|
|
227
|
+
return {
|
|
228
|
+
ok: parsed.ok === true,
|
|
229
|
+
backend: "skylight-experimental",
|
|
230
|
+
focus_without_raise: parsed.focus_without_raise === true,
|
|
231
|
+
frontmost_restored: parsed.frontmost_restored === true,
|
|
232
|
+
front_window_validated: parsed.front_window_validated === true,
|
|
233
|
+
cursor_preserved: parsed.cursor_preserved === true,
|
|
234
|
+
dispatch_started: parsed.dispatch_started === true,
|
|
235
|
+
input_transport: ["public-cgevent-pid", "skylight-pid"].includes(parsed.input_transport) ? parsed.input_transport : "",
|
|
236
|
+
error: safeErrorCode(parsed.error),
|
|
237
|
+
exit_code: result.code,
|
|
238
|
+
};
|
|
239
|
+
}
|
|
240
|
+
|
|
241
|
+
async ensureBuilt(context) {
|
|
242
|
+
while (true) {
|
|
243
|
+
if (this.binaryPath && await executableRegularFile(this.binaryPath)) return this.binaryPath;
|
|
244
|
+
let owned = false;
|
|
245
|
+
let pending = this.buildPromise;
|
|
246
|
+
if (!pending) {
|
|
247
|
+
owned = true;
|
|
248
|
+
pending = this.startBuild(context);
|
|
249
|
+
}
|
|
250
|
+
try { return await pending; }
|
|
251
|
+
catch (error) {
|
|
252
|
+
if (errorCode(error) !== "cancelled" || owned) throw error;
|
|
253
|
+
}
|
|
254
|
+
}
|
|
255
|
+
}
|
|
256
|
+
|
|
257
|
+
startBuild(context) {
|
|
258
|
+
const pending = this.build(context)
|
|
259
|
+
.then((binary) => { this.binaryPath = binary; return binary; })
|
|
260
|
+
.finally(() => { if (this.buildPromise === pending) this.buildPromise = null; });
|
|
261
|
+
this.buildPromise = pending;
|
|
262
|
+
return pending;
|
|
263
|
+
}
|
|
264
|
+
|
|
265
|
+
async build(context) {
|
|
266
|
+
if (!this.configured()) throw new Error("macOS native input helper unavailable before dispatch");
|
|
267
|
+
const source = await readFile(this.sourcePath);
|
|
268
|
+
const digest = createHash("sha256").update(source).update(`\0${process.arch}\0`).digest("hex");
|
|
269
|
+
await mkdir(this.cacheRoot, { recursive: true, mode: 0o700 });
|
|
270
|
+
await chmod(this.cacheRoot, 0o700);
|
|
271
|
+
const output = path.join(this.cacheRoot, `background-input-${digest.slice(0, 24)}`);
|
|
272
|
+
if (await executableRegularFile(output)) return output;
|
|
273
|
+
const temporary = `${output}.tmp-${process.pid}-${randomBytes(6).toString("hex")}`;
|
|
274
|
+
const temporarySource = `${temporary}.swift`;
|
|
275
|
+
try {
|
|
276
|
+
await writeFile(temporarySource, source, { mode: 0o600, flag: "wx" });
|
|
277
|
+
await this.runProcess(
|
|
278
|
+
"/usr/bin/xcrun",
|
|
279
|
+
["swiftc", "-O", temporarySource, "-o", temporary, "-framework", "CoreGraphics", "-framework", "AppKit"],
|
|
280
|
+
120_000,
|
|
281
|
+
false,
|
|
282
|
+
256 * 1024,
|
|
283
|
+
context,
|
|
284
|
+
);
|
|
285
|
+
await chmod(temporary, 0o700);
|
|
286
|
+
try { await rename(temporary, output); }
|
|
287
|
+
catch (error) {
|
|
288
|
+
if (!await executableRegularFile(output)) throw error;
|
|
289
|
+
}
|
|
290
|
+
await chmod(output, 0o700);
|
|
291
|
+
return output;
|
|
292
|
+
} finally {
|
|
293
|
+
await rm(temporary, { force: true }).catch(() => { /* Preserve the primary native-helper result; temp cleanup is best-effort. */ });
|
|
294
|
+
await rm(temporarySource, { force: true }).catch(() => { /* Preserve the primary native-helper result; source cleanup is best-effort. */ });
|
|
295
|
+
}
|
|
296
|
+
}
|
|
297
|
+
}
|
|
298
|
+
|
|
299
|
+
export function applicationBackgroundInputConfiguration(applicationAutomation, runProcess, runtimeDir) {
|
|
300
|
+
const configuredBackend = applicationAutomation.backgroundVisualBackend === undefined
|
|
301
|
+
? process.env.MBM_MACOS_BACKGROUND_VISUAL_BACKEND || "disabled"
|
|
302
|
+
: applicationAutomation.backgroundVisualBackend;
|
|
303
|
+
if (typeof configuredBackend !== "string") throw new Error("backgroundVisualBackend must be disabled or skylight-experimental");
|
|
304
|
+
const backgroundVisualBackend = configuredBackend;
|
|
305
|
+
const applicationPlatform = applicationAutomation.platform || process.platform;
|
|
306
|
+
const backgroundInputService = applicationAutomation.backgroundInputService
|
|
307
|
+
|| (applicationPlatform === "darwin"
|
|
308
|
+
? new MacosBackgroundInputService({
|
|
309
|
+
runProcess,
|
|
310
|
+
cacheRoot: path.resolve(runtimeDir, "macos-background-input"),
|
|
311
|
+
platform: applicationPlatform,
|
|
312
|
+
})
|
|
313
|
+
: null);
|
|
314
|
+
return { backgroundVisualBackend, backgroundInputService };
|
|
315
|
+
}
|
|
316
|
+
|
|
317
|
+
async function executableRegularFile(value) {
|
|
318
|
+
try {
|
|
319
|
+
const info = await lstat(value);
|
|
320
|
+
const currentUid = typeof process.getuid === "function" ? process.getuid() : null;
|
|
321
|
+
const trustedOwner = currentUid === null || info.uid === currentUid || info.uid === 0;
|
|
322
|
+
return info.isFile() && !info.isSymbolicLink() && trustedOwner && (info.mode & 0o111) !== 0 && (info.mode & 0o022) === 0;
|
|
323
|
+
} catch { return false; }
|
|
324
|
+
}
|
|
325
|
+
|
|
326
|
+
function positiveInteger(value, label) {
|
|
327
|
+
if (!Number.isSafeInteger(value) || value < 1) throw new Error(`${label} must be a positive integer`);
|
|
328
|
+
return value;
|
|
329
|
+
}
|
|
330
|
+
|
|
331
|
+
function requiredProcessGeneration(value) {
|
|
332
|
+
if (typeof value !== "string" || !value || value.length > 2048 || /[\r\n\0]/.test(value)) throw new Error("process_generation is invalid");
|
|
333
|
+
return value;
|
|
334
|
+
}
|
|
335
|
+
|
|
336
|
+
function finiteNumber(value, label) {
|
|
337
|
+
if (typeof value !== "number" || !Number.isFinite(value)) throw new Error(`${label} must be finite`);
|
|
338
|
+
return value;
|
|
339
|
+
}
|
|
340
|
+
|
|
341
|
+
function nonNegativeFinite(value, label) {
|
|
342
|
+
const number = finiteNumber(value, label);
|
|
343
|
+
if (number < 0) throw new Error(`${label} must be non-negative`);
|
|
344
|
+
return number;
|
|
345
|
+
}
|
|
346
|
+
|
|
347
|
+
function scrollDelta(value, label) {
|
|
348
|
+
if (value === undefined || value === null) return 0;
|
|
349
|
+
const number = finiteNumber(value, label);
|
|
350
|
+
if (Math.abs(number) > 10_000) throw new Error(`${label} must be from -10000 to 10000`);
|
|
351
|
+
return Object.is(number, -0) ? 0 : Math.round(number);
|
|
352
|
+
}
|
|
353
|
+
|
|
354
|
+
function positiveFinite(value, label) {
|
|
355
|
+
const number = finiteNumber(value, label);
|
|
356
|
+
if (!(number > 0)) throw new Error(`${label} must be positive`);
|
|
357
|
+
return number;
|
|
358
|
+
}
|
|
359
|
+
|
|
360
|
+
function requiredSpecialKey(value) {
|
|
361
|
+
if (typeof value !== "string") throw new Error("macOS PID key_press key is unsupported before dispatch");
|
|
362
|
+
const key = value;
|
|
363
|
+
const raw = key.startsWith("Shift+") ? key.slice(6) : key;
|
|
364
|
+
const allowed = new Set([
|
|
365
|
+
"Enter", "Tab", "Escape", "Backspace", "Delete", "ArrowLeft", "ArrowUp", "ArrowRight", "ArrowDown",
|
|
366
|
+
"Home", "End", "PageUp", "PageDown", "Space",
|
|
367
|
+
]);
|
|
368
|
+
if (!allowed.has(raw) || key !== raw && key !== `Shift+${raw}`) throw new Error("macOS PID key_press key is unsupported before dispatch");
|
|
369
|
+
return key;
|
|
370
|
+
}
|
|
371
|
+
|
|
372
|
+
function requireKeyboardSettlement(result) {
|
|
373
|
+
if (result.ok === true && result.dispatch_started === true && result.input_transport === "public-cgevent-pid") return result;
|
|
374
|
+
if (result.dispatch_started === true || result.error === "dispatch_outcome_unknown") {
|
|
375
|
+
throw new Error("macOS PID keyboard input may have been partially dispatched; the action outcome is unknown");
|
|
376
|
+
}
|
|
377
|
+
if (result.error === "process_generation_changed_before_dispatch") {
|
|
378
|
+
throw new Error("macOS PID keyboard process generation changed before dispatch");
|
|
379
|
+
}
|
|
380
|
+
throw new Error(`macOS PID keyboard input unavailable before dispatch: ${safeErrorCode(result.error)}`);
|
|
381
|
+
}
|
|
382
|
+
|
|
383
|
+
function boundedTimeout(value) {
|
|
384
|
+
if (value === undefined || value === null) return 30;
|
|
385
|
+
if (!Number.isInteger(value) || value < 1 || value > 120) throw new Error("timeout_seconds must be from 1 to 120");
|
|
386
|
+
return value;
|
|
387
|
+
}
|
|
388
|
+
|
|
389
|
+
function backgroundInputOutcomeUnknown() {
|
|
390
|
+
return new Error("macOS native background input may have been partially dispatched; the action outcome is unknown");
|
|
391
|
+
}
|
|
392
|
+
|
|
393
|
+
function safeErrorCode(value) {
|
|
394
|
+
if (typeof value !== "string") return "";
|
|
395
|
+
const text = value.trim().toLowerCase();
|
|
396
|
+
if (!text) return "";
|
|
397
|
+
return /^[a-z0-9_-]{1,100}$/.test(text) ? text : "helper_error";
|
|
398
|
+
}
|
|
@@ -0,0 +1,65 @@
|
|
|
1
|
+
import { spawn } from "node:child_process";
|
|
2
|
+
import { classifyOperationalError } from "./log.mjs";
|
|
3
|
+
|
|
4
|
+
export class MacosIdleSleepAssertion {
|
|
5
|
+
constructor({ platform = process.platform, processId = process.pid, spawnProcess = spawn, logger = console } = {}) {
|
|
6
|
+
this.supported = platform === "darwin";
|
|
7
|
+
this.processId = processId;
|
|
8
|
+
this.spawnProcess = spawnProcess;
|
|
9
|
+
this.logger = logger;
|
|
10
|
+
this.child = null;
|
|
11
|
+
this.lastErrorClass = null;
|
|
12
|
+
}
|
|
13
|
+
|
|
14
|
+
acquire() {
|
|
15
|
+
if (!this.supported) return false;
|
|
16
|
+
if (this.child) return true;
|
|
17
|
+
let child = null;
|
|
18
|
+
try {
|
|
19
|
+
child = this.spawnProcess("/usr/bin/caffeinate", ["-i", "-w", String(this.processId)], {
|
|
20
|
+
stdio: "ignore", shell: false, windowsHide: true,
|
|
21
|
+
});
|
|
22
|
+
this.child = child;
|
|
23
|
+
child.unref?.();
|
|
24
|
+
child.once?.("error", (error) => this.handleChildFailure(child, error));
|
|
25
|
+
child.once?.("exit", () => {
|
|
26
|
+
if (this.child !== child) return;
|
|
27
|
+
this.child = null;
|
|
28
|
+
this.reportUnavailable(new Error("idle-sleep assertion child exited before its owner process"));
|
|
29
|
+
});
|
|
30
|
+
this.lastErrorClass = null;
|
|
31
|
+
return true;
|
|
32
|
+
} catch (error) {
|
|
33
|
+
if (this.child === child) this.child = null;
|
|
34
|
+
try { child?.kill?.("SIGTERM"); } catch { /* Best-effort cleanup after partial child setup. */ }
|
|
35
|
+
this.reportUnavailable(error);
|
|
36
|
+
return false;
|
|
37
|
+
}
|
|
38
|
+
}
|
|
39
|
+
|
|
40
|
+
handleChildFailure(child, error) {
|
|
41
|
+
if (this.child === child) this.child = null;
|
|
42
|
+
this.reportUnavailable(error);
|
|
43
|
+
}
|
|
44
|
+
|
|
45
|
+
reportUnavailable(error) {
|
|
46
|
+
const errorClass = classifyOperationalError(error);
|
|
47
|
+
if (this.lastErrorClass === errorClass) return;
|
|
48
|
+
this.lastErrorClass = errorClass;
|
|
49
|
+
try {
|
|
50
|
+
this.logger.event?.("warn", "runtime.idle_sleep_guard.unavailable", { error_class: errorClass },
|
|
51
|
+
"macOS idle-sleep assertion is unavailable");
|
|
52
|
+
} catch { /* Auxiliary power-management logging must never affect the owning workload. */ }
|
|
53
|
+
}
|
|
54
|
+
|
|
55
|
+
release() {
|
|
56
|
+
const child = this.child;
|
|
57
|
+
this.child = null;
|
|
58
|
+
if (!child || child.exitCode !== null || child.killed === true) return;
|
|
59
|
+
try { child.kill?.("SIGTERM"); } catch { /* -w binds any survivor to the owner process lifetime. */ }
|
|
60
|
+
}
|
|
61
|
+
|
|
62
|
+
snapshot() {
|
|
63
|
+
return { supported: this.supported, active: Boolean(this.child), last_error_class: this.lastErrorClass };
|
|
64
|
+
}
|
|
65
|
+
}
|