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.
Files changed (473) hide show
  1. package/CHANGELOG.md +1142 -0
  2. package/CONTRIBUTING.md +23 -25
  3. package/GOVERNANCE.md +2 -2
  4. package/README.md +58 -20
  5. package/SECURITY.md +161 -120
  6. package/SUPPORT.md +1 -1
  7. package/browser-extension/broker-auth.js +83 -0
  8. package/browser-extension/broker-liveness.js +35 -0
  9. package/browser-extension/browser-error-boundary.js +96 -0
  10. package/browser-extension/browser-operations.js +1456 -101
  11. package/browser-extension/devtools-input.js +195 -34
  12. package/browser-extension/devtools-observation.js +429 -0
  13. package/browser-extension/devtools-session.js +48 -0
  14. package/browser-extension/manifest.json +4 -3
  15. package/browser-extension/page-automation.js +578 -118
  16. package/browser-extension/pairing-bootstrap.js +42 -0
  17. package/browser-extension/pairing.js +28 -12
  18. package/browser-extension/service-worker.js +126 -106
  19. package/docs/AGENT_CONTEXT.md +13 -10
  20. package/docs/ARCHITECTURE.md +159 -67
  21. package/docs/AUDIT.md +1302 -4
  22. package/docs/CLIENTS.md +19 -6
  23. package/docs/COMPUTER_USE.md +297 -0
  24. package/docs/ENGINEERING.md +72 -13
  25. package/docs/GETTING_STARTED.md +18 -20
  26. package/docs/LOCAL_AUTHORIZATION.md +115 -72
  27. package/docs/LOCAL_AUTOMATION.md +27 -21
  28. package/docs/LOGGING.md +40 -19
  29. package/docs/MANAGED_JOBS.md +37 -34
  30. package/docs/MULTI_ACCOUNT.md +98 -37
  31. package/docs/OPERATIONS.md +145 -51
  32. package/docs/OVERVIEW.md +14 -11
  33. package/docs/POLICY_REFERENCE.md +71 -3
  34. package/docs/PRIVACY.md +41 -2
  35. package/docs/PROJECT_STANDARDS.md +29 -6
  36. package/docs/RELEASING.md +238 -64
  37. package/docs/TESTING.md +150 -39
  38. package/docs/THREAT_MODEL.md +164 -67
  39. package/docs/TOOL_REFERENCE.md +653 -60
  40. package/docs/UPGRADING.md +78 -18
  41. package/native/macos/MachineBridgeBackgroundInput.swift +1051 -0
  42. package/native/macos/MachineBridgeBackgroundInputSmokeFixture.swift +295 -0
  43. package/native/macos/MachineBridgeTrustBroker.swift +233 -0
  44. package/package.json +94 -16
  45. package/scripts/accepted-candidate-tarball.mjs +77 -0
  46. package/scripts/candidate-runtime-store.mjs +93 -0
  47. package/scripts/check-plan.mjs +73 -3
  48. package/scripts/check-runner.mjs +129 -17
  49. package/scripts/commit-message-check.mjs +5 -2
  50. package/scripts/consumer-package-security.mjs +293 -0
  51. package/scripts/coverage-check.mjs +251 -15
  52. package/scripts/coverage-generation.mjs +41 -0
  53. package/scripts/coverage-range-merge.mjs +41 -0
  54. package/scripts/foreground-daemon-recovery.mjs +88 -0
  55. package/scripts/generate-policy-reference.mjs +28 -5
  56. package/scripts/generate-tool-reference.mjs +1 -1
  57. package/scripts/generate-worker-types.mjs +21 -11
  58. package/scripts/github-backlog.mjs +11 -10
  59. package/scripts/github-push.mjs +62 -16
  60. package/scripts/github-release-asset.mjs +58 -0
  61. package/scripts/github-release.mjs +241 -132
  62. package/scripts/global-package-installation.mjs +68 -0
  63. package/scripts/hardened-npm-session.mjs +42 -0
  64. package/scripts/install-published-prerelease.mjs +198 -0
  65. package/scripts/local-release-acceptance.mjs +103 -45
  66. package/scripts/macos-background-input-smoke.mjs +515 -0
  67. package/scripts/network-retry.mjs +8 -1
  68. package/scripts/npm-global-prefix.mjs +27 -0
  69. package/scripts/npm-publication-policy.mjs +17 -0
  70. package/scripts/official-mcp-conformance.mjs +267 -0
  71. package/scripts/persistent-activation-process.mjs +101 -0
  72. package/scripts/prepare-pinned-npm.mjs +12 -69
  73. package/scripts/prerelease-activation.mjs +160 -0
  74. package/scripts/privacy-check.mjs +14 -6
  75. package/scripts/promotion-digest.mjs +128 -0
  76. package/scripts/publish-npm.mjs +260 -0
  77. package/scripts/published-release.mjs +132 -0
  78. package/scripts/release-acceptance.mjs +62 -54
  79. package/scripts/release-browser-extension-store.mjs +172 -0
  80. package/scripts/release-candidate-manifest.mjs +52 -0
  81. package/scripts/release-channel.mjs +106 -0
  82. package/scripts/release-diagnostic.mjs +41 -0
  83. package/scripts/release-impact-check.mjs +12 -22
  84. package/scripts/release-oauth-canary-core.mjs +325 -0
  85. package/scripts/release-oauth-canary-evidence.mjs +100 -0
  86. package/scripts/release-oauth-canary.mjs +127 -0
  87. package/scripts/release-publication-guard.mjs +67 -0
  88. package/scripts/release-soak.mjs +284 -0
  89. package/scripts/release-state.mjs +1 -1
  90. package/scripts/run-checks.mjs +44 -7
  91. package/scripts/run-worker-dry-run.mjs +21 -0
  92. package/scripts/sarif-security-gate.mjs +2 -1
  93. package/scripts/sbom-check.mjs +106 -0
  94. package/scripts/start-release-candidate.mjs +267 -44
  95. package/scripts/syntax-check.mjs +36 -14
  96. package/scripts/verification-generation-guard.mjs +15 -0
  97. package/scripts/verification-idle-sleep-guard.mjs +37 -0
  98. package/scripts/verification-state.mjs +108 -0
  99. package/scripts/wrangler-command-lifecycle.mjs +115 -0
  100. package/src/local/account-access.mjs +13 -1
  101. package/src/local/account-admin-response.mjs +92 -0
  102. package/src/local/account-admin.mjs +52 -19
  103. package/src/local/agent-context-projection.mjs +26 -7
  104. package/src/local/agent-context.mjs +88 -49
  105. package/src/local/agent-skill-discovery.mjs +16 -5
  106. package/src/local/app-automation-macos-jxa.mjs +350 -0
  107. package/src/local/app-automation.mjs +873 -163
  108. package/src/local/application-capability-projection.mjs +24 -0
  109. package/src/local/authority-context.mjs +106 -0
  110. package/src/local/autostart-log-maintenance.mjs +36 -0
  111. package/src/local/browser-bridge-http.mjs +5 -3
  112. package/src/local/browser-bridge.mjs +109 -31
  113. package/src/local/browser-broker-auth-http.mjs +67 -0
  114. package/src/local/browser-broker-auth.mjs +98 -0
  115. package/src/local/browser-broker-routes.mjs +63 -20
  116. package/src/local/browser-broker-server.mjs +17 -7
  117. package/src/local/browser-command.mjs +79 -30
  118. package/src/local/browser-computer-observation-service.mjs +266 -0
  119. package/src/local/browser-extension-identity.mjs +50 -0
  120. package/src/local/browser-extension-path.mjs +22 -0
  121. package/src/local/browser-extension-protocol.mjs +50 -11
  122. package/src/local/browser-operation-service.mjs +147 -117
  123. package/src/local/browser-pairing-grant.mjs +109 -0
  124. package/src/local/browser-pairing-http.mjs +36 -0
  125. package/src/local/browser-pairing-launch.mjs +58 -0
  126. package/src/local/browser-pairing-store.mjs +85 -48
  127. package/src/local/browser-request-registry.mjs +40 -14
  128. package/src/local/browser-request-settlement.mjs +78 -0
  129. package/src/local/browser-resource-input.mjs +74 -0
  130. package/src/local/browser-trusted-input-health.mjs +63 -0
  131. package/src/local/call-authority.mjs +21 -0
  132. package/src/local/call-capacity.mjs +45 -0
  133. package/src/local/call-registry-drain.mjs +54 -0
  134. package/src/local/call-registry.mjs +30 -15
  135. package/src/local/capability-observer.mjs +5 -0
  136. package/src/local/capability-ranking.mjs +3 -2
  137. package/src/local/child-process-settlement.mjs +132 -0
  138. package/src/local/cli-account-admin.mjs +40 -6
  139. package/src/local/cli-activate.mjs +162 -0
  140. package/src/local/cli-local-admin.mjs +20 -45
  141. package/src/local/cli-options.mjs +12 -13
  142. package/src/local/cli-ready-output.mjs +52 -0
  143. package/src/local/cli-service.mjs +91 -11
  144. package/src/local/cli.mjs +232 -150
  145. package/src/local/computer-use-application-observation.mjs +224 -0
  146. package/src/local/computer-use-arguments.mjs +270 -0
  147. package/src/local/computer-use-deadline.mjs +50 -0
  148. package/src/local/computer-use-dispatch-settlement.mjs +40 -0
  149. package/src/local/computer-use-expectation.mjs +171 -0
  150. package/src/local/computer-use-observation.mjs +769 -0
  151. package/src/local/computer-use-recovery.mjs +82 -0
  152. package/src/local/computer-use-result-budget.mjs +145 -0
  153. package/src/local/computer-use-snapshot-store.mjs +67 -0
  154. package/src/local/computer-use.mjs +2255 -0
  155. package/src/local/daemon-http-relay-auth.mjs +26 -0
  156. package/src/local/daemon-http-relay-connection.mjs +298 -0
  157. package/src/local/daemon-http-relay-request.mjs +64 -0
  158. package/src/local/daemon-http-relay-sequence.mjs +49 -0
  159. package/src/local/daemon-process.mjs +40 -7
  160. package/src/local/delegated-process-sandbox.mjs +148 -0
  161. package/src/local/device-identity.mjs +156 -49
  162. package/src/local/device-root-provider.mjs +81 -0
  163. package/src/local/directory-metadata.mjs +47 -0
  164. package/src/local/doctor-reporting.mjs +23 -0
  165. package/src/local/durable-process-spec.mjs +80 -0
  166. package/src/local/errors.mjs +25 -15
  167. package/src/local/exclusive-file.mjs +74 -26
  168. package/src/local/execution-limits.mjs +9 -0
  169. package/src/local/execution-routing.mjs +276 -0
  170. package/src/local/execution-surface.mjs +23 -0
  171. package/src/local/file-mutation-coordinator.mjs +47 -0
  172. package/src/local/file-snapshot-preservation.mjs +24 -0
  173. package/src/local/filesystem-identity.mjs +54 -0
  174. package/src/local/fixed-process-environment.mjs +21 -0
  175. package/src/local/full-access-test.mjs +31 -13
  176. package/src/local/git-commit.mjs +69 -0
  177. package/src/local/git-config-safety.mjs +55 -0
  178. package/src/local/git-log-parser.mjs +41 -0
  179. package/src/local/git-metadata-boundary.mjs +77 -0
  180. package/src/local/git-metadata-tree-safety.mjs +59 -0
  181. package/src/local/git-operation-state.mjs +19 -0
  182. package/src/local/git-service.mjs +165 -30
  183. package/src/local/hardened-npm-download-timeout.mjs +46 -0
  184. package/src/local/hardened-npm-download.mjs +109 -0
  185. package/src/local/hardened-npm-extract.mjs +20 -0
  186. package/src/local/hardened-npm-verification.mjs +104 -0
  187. package/src/local/hardened-npm.mjs +199 -0
  188. package/src/local/job-runner.mjs +244 -89
  189. package/src/local/lifecycle.mjs +6 -0
  190. package/src/local/log.mjs +19 -45
  191. package/src/local/macos-background-input.mjs +398 -0
  192. package/src/local/macos-idle-sleep-assertion.mjs +65 -0
  193. package/src/local/macos-trust-broker.mjs +404 -0
  194. package/src/local/managed-job-cancellation.mjs +42 -0
  195. package/src/local/managed-job-capacity.mjs +16 -0
  196. package/src/local/managed-job-directory-generation.mjs +60 -0
  197. package/src/local/managed-job-directory.mjs +75 -0
  198. package/src/local/managed-job-durable-process.mjs +49 -0
  199. package/src/local/managed-job-lock.mjs +46 -14
  200. package/src/local/managed-job-plan.mjs +38 -14
  201. package/src/local/managed-job-projection.mjs +23 -15
  202. package/src/local/managed-job-retention.mjs +128 -0
  203. package/src/local/managed-job-runner-claim.mjs +70 -0
  204. package/src/local/managed-job-runner.mjs +35 -10
  205. package/src/local/managed-job-storage.mjs +22 -6
  206. package/src/local/managed-job-terminal-maintenance.mjs +40 -0
  207. package/src/local/managed-job-terminal.mjs +150 -0
  208. package/src/local/managed-jobs.mjs +424 -287
  209. package/src/local/npm-cli.mjs +42 -0
  210. package/src/local/npm-environment.mjs +37 -0
  211. package/src/local/operation-authorization.mjs +68 -324
  212. package/src/local/operation-risk.mjs +51 -4
  213. package/src/local/owner-state-lock.mjs +118 -0
  214. package/src/local/package-identity.mjs +9 -0
  215. package/src/local/patch.mjs +20 -18
  216. package/src/local/path-inspection.mjs +23 -0
  217. package/src/local/policy.mjs +19 -0
  218. package/src/local/private-toolchain-integrity.mjs +54 -0
  219. package/src/local/process-execution.mjs +87 -75
  220. package/src/local/process-foreground-timeout.mjs +50 -0
  221. package/src/local/process-identity.mjs +41 -7
  222. package/src/local/process-nonreplayable-settlement.mjs +50 -0
  223. package/src/local/process-result-projection.mjs +22 -0
  224. package/src/local/process-session-events.mjs +47 -0
  225. package/src/local/process-session-remote-activity.mjs +10 -0
  226. package/src/local/process-session-termination.mjs +73 -0
  227. package/src/local/process-sessions.mjs +144 -112
  228. package/src/local/process-tracker.mjs +140 -13
  229. package/src/local/process-tree-ownership-types.d.ts +37 -0
  230. package/src/local/process-tree-ownership.mjs +57 -0
  231. package/src/local/process-tree-signal.mjs +34 -0
  232. package/src/local/process-tree-snapshot.mjs +77 -0
  233. package/src/local/process-tree-supervisor.mjs +69 -0
  234. package/src/local/process-tree.mjs +11 -53
  235. package/src/local/project-metadata.mjs +19 -6
  236. package/src/local/relay-call-recovery.mjs +58 -38
  237. package/src/local/relay-connection-classification.mjs +131 -0
  238. package/src/local/relay-connection-support.mjs +91 -0
  239. package/src/local/relay-connection.mjs +179 -272
  240. package/src/local/relay-diagnostics.mjs +91 -0
  241. package/src/local/relay-heartbeat.mjs +119 -0
  242. package/src/local/relay-liveness.mjs +109 -0
  243. package/src/local/relay-peer-diagnostics.mjs +29 -0
  244. package/src/local/release-runtime-lock.mjs +18 -0
  245. package/src/local/remote-activity-idle-sleep-guard.mjs +77 -0
  246. package/src/local/remote-configuration.mjs +48 -0
  247. package/src/local/resilient-relay-connection.mjs +178 -0
  248. package/src/local/resource-admission-diagnostics.mjs +52 -0
  249. package/src/local/resource-admission-policy.mjs +115 -0
  250. package/src/local/resource-admission.mjs +339 -0
  251. package/src/local/resource-build-root.mjs +83 -0
  252. package/src/local/resource-cargo-concurrency.mjs +38 -0
  253. package/src/local/resource-cmake-concurrency.mjs +42 -0
  254. package/src/local/resource-command-concurrency.mjs +37 -0
  255. package/src/local/resource-command-profile.mjs +176 -0
  256. package/src/local/resource-coordinator-accounting.mjs +21 -0
  257. package/src/local/resource-cpu-window.mjs +20 -0
  258. package/src/local/resource-disk-headroom.mjs +13 -0
  259. package/src/local/resource-elastic-memory.mjs +19 -0
  260. package/src/local/resource-elastic-request.mjs +36 -0
  261. package/src/local/resource-foreground-wait.mjs +29 -0
  262. package/src/local/resource-go-concurrency.mjs +43 -0
  263. package/src/local/resource-gradle-concurrency.mjs +57 -0
  264. package/src/local/resource-host-cache.mjs +39 -0
  265. package/src/local/resource-host-darwin.mjs +54 -0
  266. package/src/local/resource-host-linux.mjs +35 -0
  267. package/src/local/resource-host-sample-file.mjs +23 -0
  268. package/src/local/resource-host-snapshot.mjs +99 -0
  269. package/src/local/resource-lease-accounting.mjs +119 -0
  270. package/src/local/resource-light-command.mjs +6 -0
  271. package/src/local/resource-make-concurrency.mjs +42 -0
  272. package/src/local/resource-maven-concurrency.mjs +38 -0
  273. package/src/local/resource-ninja-command-concurrency.mjs +20 -0
  274. package/src/local/resource-ninja-concurrency.mjs +28 -0
  275. package/src/local/resource-operations.mjs +26 -10
  276. package/src/local/resource-pressure.mjs +67 -0
  277. package/src/local/resource-probe-command.mjs +35 -0
  278. package/src/local/resource-process-admission.mjs +59 -0
  279. package/src/local/resource-process-ancestry-cache.mjs +43 -0
  280. package/src/local/resource-process-ancestry.mjs +32 -0
  281. package/src/local/resource-process-priority.mjs +15 -0
  282. package/src/local/resource-project-key.mjs +53 -0
  283. package/src/local/resource-pytest-concurrency.mjs +33 -0
  284. package/src/local/resource-release-control-classification.mjs +14 -0
  285. package/src/local/resource-release-control-executable.mjs +70 -0
  286. package/src/local/resource-release-control-workspace.mjs +41 -0
  287. package/src/local/resource-request-contract.mjs +30 -0
  288. package/src/local/resource-script-classification.mjs +44 -0
  289. package/src/local/resource-shell-analysis.mjs +58 -0
  290. package/src/local/resource-staging-recovery.mjs +97 -0
  291. package/src/local/resource-swift-concurrency.mjs +31 -0
  292. package/src/local/resource-transaction-lock.mjs +189 -0
  293. package/src/local/resource-wait.mjs +48 -0
  294. package/src/local/resource-waiters.mjs +139 -0
  295. package/src/local/resource-xcode-command.mjs +7 -0
  296. package/src/local/resource-xcode-concurrency.mjs +34 -0
  297. package/src/local/resource-xcode-non-build.mjs +19 -0
  298. package/src/local/runtime-activation.mjs +700 -0
  299. package/src/local/runtime-activity-projection.mjs +48 -0
  300. package/src/local/runtime-capabilities.mjs +48 -15
  301. package/src/local/runtime-diagnostic-state.mjs +14 -0
  302. package/src/local/runtime-diagnostics.mjs +40 -13
  303. package/src/local/runtime-info-projection.mjs +60 -0
  304. package/src/local/runtime-info-relay-projection.mjs +21 -0
  305. package/src/local/runtime-paths.mjs +2 -1
  306. package/src/local/runtime-process-routing.mjs +33 -0
  307. package/src/local/runtime-relay-connection-options.mjs +44 -0
  308. package/src/local/runtime-relay-control.mjs +98 -0
  309. package/src/local/runtime-relay.mjs +26 -50
  310. package/src/local/runtime-reporting.mjs +37 -21
  311. package/src/local/runtime-resource-service.mjs +77 -0
  312. package/src/local/runtime-tool-handlers.mjs +13 -10
  313. package/src/local/runtime.mjs +244 -208
  314. package/src/local/secure-file.mjs +73 -20
  315. package/src/local/security-audit-dispatch.mjs +35 -0
  316. package/src/local/security-audit-log.mjs +215 -0
  317. package/src/local/security-audit-state.mjs +139 -0
  318. package/src/local/security-audit-storage.mjs +135 -0
  319. package/src/local/security-audit-warning.mjs +31 -0
  320. package/src/local/security-audit-worker.mjs +87 -0
  321. package/src/local/service-convergence.mjs +42 -1
  322. package/src/local/service-definition.mjs +24 -0
  323. package/src/local/service-environment.mjs +18 -10
  324. package/src/local/service-owner.mjs +146 -0
  325. package/src/local/service-ownership.mjs +17 -0
  326. package/src/local/service-restart-handoff.mjs +64 -0
  327. package/src/local/service-restart-scheduler.mjs +49 -0
  328. package/src/local/service-runtime-convergence.mjs +52 -0
  329. package/src/local/service-runtime.mjs +105 -0
  330. package/src/local/service-status.mjs +60 -0
  331. package/src/local/service.mjs +385 -92
  332. package/src/local/shell.mjs +39 -19
  333. package/src/local/ssh-key.mjs +158 -42
  334. package/src/local/state-inventory.mjs +50 -24
  335. package/src/local/state-owner-lock-inventory.mjs +23 -0
  336. package/src/local/state-root-owned-namespaces.mjs +83 -0
  337. package/src/local/state-root-retirement.mjs +89 -0
  338. package/src/local/state.mjs +386 -96
  339. package/src/local/stdio.mjs +96 -66
  340. package/src/local/support-state-projection.mjs +30 -0
  341. package/src/local/system-network-route.mjs +76 -0
  342. package/src/local/systemd-removal.mjs +20 -0
  343. package/src/local/tool-executor.mjs +85 -20
  344. package/src/local/tool-result-boundary.mjs +51 -0
  345. package/src/local/toolchain-operation-lock.mjs +41 -0
  346. package/src/local/tools.mjs +7 -5
  347. package/src/local/trusted-executable.mjs +53 -0
  348. package/src/local/trusted-git-executable.mjs +34 -0
  349. package/src/local/trusted-github-cli.mjs +24 -0
  350. package/src/local/windows-service-convergence.mjs +49 -0
  351. package/src/local/windows-service.mjs +52 -45
  352. package/src/local/worker-deployment-fingerprint.mjs +102 -0
  353. package/src/local/worker-deployment.mjs +48 -60
  354. package/src/local/worker-health.mjs +12 -4
  355. package/src/local/worker-secret-file.mjs +37 -17
  356. package/src/local/workspace-file-service.mjs +156 -239
  357. package/src/local/workspace-file-transaction.mjs +189 -0
  358. package/src/local/workspace-search.mjs +55 -0
  359. package/src/local/wrangler-toolchain/package-lock.json +1505 -0
  360. package/src/local/wrangler-toolchain/package.json +23 -0
  361. package/src/local/wrangler-toolchain-verification.mjs +135 -0
  362. package/src/local/wrangler-toolchain.mjs +188 -0
  363. package/src/shared/access-contract.json +7 -1
  364. package/src/shared/activation-recovery.mjs +49 -0
  365. package/src/shared/admin-auth.d.mts +2 -1
  366. package/src/shared/admin-auth.mjs +3 -3
  367. package/src/shared/authority-revocation.d.mts +9 -0
  368. package/src/shared/authority-revocation.mjs +28 -0
  369. package/src/shared/daemon-auth.d.mts +11 -0
  370. package/src/shared/daemon-auth.mjs +17 -0
  371. package/src/shared/device-session-auth.d.mts +20 -0
  372. package/src/shared/device-session-auth.mjs +51 -0
  373. package/src/shared/foreground-timeout.d.mts +15 -0
  374. package/src/shared/foreground-timeout.mjs +70 -0
  375. package/src/shared/log-redaction.d.mts +9 -0
  376. package/src/shared/log-redaction.mjs +51 -0
  377. package/src/shared/mcp-protocol.d.mts +27 -0
  378. package/src/shared/mcp-protocol.mjs +275 -0
  379. package/src/shared/project-overview-projection.d.mts +4 -0
  380. package/src/shared/project-overview-projection.mjs +96 -0
  381. package/src/shared/relay-contract.json +28 -0
  382. package/src/shared/result-projection.d.mts +2 -1
  383. package/src/shared/result-projection.mjs +13 -2
  384. package/src/shared/server-metadata.json +15 -9
  385. package/src/shared/tool-argument-validation.d.mts +17 -0
  386. package/src/shared/tool-argument-validation.mjs +325 -0
  387. package/src/shared/tool-call-capacity.d.mts +41 -0
  388. package/src/shared/tool-call-capacity.mjs +59 -0
  389. package/src/shared/tool-catalog.json +626 -57
  390. package/src/worker/access.ts +12 -0
  391. package/src/worker/account-admin.ts +55 -33
  392. package/src/worker/authority-revocations.ts +174 -0
  393. package/src/worker/authority.ts +52 -6
  394. package/src/worker/daemon-auth.ts +49 -68
  395. package/src/worker/daemon-channel.ts +36 -0
  396. package/src/worker/daemon-http-auth.ts +63 -0
  397. package/src/worker/daemon-http-channel.ts +120 -0
  398. package/src/worker/daemon-http-controller.ts +163 -0
  399. package/src/worker/daemon-http-protocol.ts +62 -0
  400. package/src/worker/daemon-http-registry.ts +82 -0
  401. package/src/worker/daemon-last-observation.ts +30 -0
  402. package/src/worker/daemon-liveness.ts +8 -6
  403. package/src/worker/daemon-ready-dispatch.ts +17 -0
  404. package/src/worker/daemon-ready-messages.ts +73 -0
  405. package/src/worker/daemon-ready-waiters.ts +79 -0
  406. package/src/worker/daemon-recovery-budget.ts +13 -0
  407. package/src/worker/daemon-registry.ts +58 -0
  408. package/src/worker/daemon-relay-diagnostics.ts +127 -0
  409. package/src/worker/daemon-socket-attachment.ts +55 -0
  410. package/src/worker/daemon-sockets.ts +72 -62
  411. package/src/worker/daemon-status.ts +38 -0
  412. package/src/worker/device-session-verifier.ts +129 -0
  413. package/src/worker/dpop.ts +157 -0
  414. package/src/worker/durable-process-timeout.ts +29 -0
  415. package/src/worker/errors.ts +57 -0
  416. package/src/worker/http.ts +112 -26
  417. package/src/worker/index.ts +446 -440
  418. package/src/worker/mcp-access.ts +57 -0
  419. package/src/worker/mcp-controller.ts +188 -0
  420. package/src/worker/mcp-http-accept.ts +11 -0
  421. package/src/worker/mcp-http-contract.ts +322 -0
  422. package/src/worker/mcp-initialization-compat.ts +141 -0
  423. package/src/worker/mcp-jsonrpc.ts +11 -29
  424. package/src/worker/mcp-removed-protocol.ts +17 -0
  425. package/src/worker/mcp-response-proxy.ts +135 -0
  426. package/src/worker/mcp-response-stream.ts +65 -0
  427. package/src/worker/mcp-stale-schema-compat.ts +57 -0
  428. package/src/worker/mcp-stream-proxy-contract.ts +48 -0
  429. package/src/worker/mcp-tool-call-input.ts +23 -0
  430. package/src/worker/nonce-store.ts +33 -35
  431. package/src/worker/oauth-authorization-page.ts +21 -1
  432. package/src/worker/oauth-client-admin.ts +52 -0
  433. package/src/worker/oauth-client-contract.ts +38 -0
  434. package/src/worker/oauth-controller.ts +107 -47
  435. package/src/worker/oauth-field-contract.ts +31 -0
  436. package/src/worker/oauth-record-contract.ts +7 -0
  437. package/src/worker/oauth-refresh-authority.ts +27 -0
  438. package/src/worker/oauth-refresh-exchange.ts +162 -0
  439. package/src/worker/oauth-refresh-families.ts +130 -27
  440. package/src/worker/oauth-refresh-persistence.ts +116 -0
  441. package/src/worker/oauth-state.ts +33 -18
  442. package/src/worker/oauth-store-validation.ts +131 -0
  443. package/src/worker/oauth-token-derivation.ts +33 -0
  444. package/src/worker/oauth-token-issuance.ts +119 -0
  445. package/src/worker/oauth-tokens.ts +56 -190
  446. package/src/worker/observability.ts +38 -5
  447. package/src/worker/pending-admission.ts +15 -0
  448. package/src/worker/pending-call-capacity.ts +108 -0
  449. package/src/worker/pending-call-contract.ts +42 -5
  450. package/src/worker/pending-call-deadlines.ts +75 -0
  451. package/src/worker/pending-calls.ts +131 -125
  452. package/src/worker/runtime-alarm-storage.ts +37 -0
  453. package/src/worker/runtime-alarm.ts +136 -0
  454. package/src/worker/server-info-activity.ts +36 -0
  455. package/src/worker/server-info-tool-delivery.ts +15 -0
  456. package/src/worker/server-info.ts +168 -0
  457. package/src/worker/tool-catalog.ts +47 -1
  458. package/src/worker/tool-timeout.ts +75 -14
  459. package/src/worker/websocket-protocol.ts +26 -2
  460. package/src/worker/worker-edge-guard.ts +90 -0
  461. package/src/worker/worker-edge-log.ts +65 -0
  462. package/src/worker/worker-entry.ts +52 -0
  463. package/src/worker/worker-mcp-config.ts +23 -0
  464. package/src/worker/worker-metadata.ts +48 -0
  465. package/src/worker/worker-rate-limit-key.ts +30 -0
  466. package/src/worker/worker-runtime-config.ts +20 -0
  467. package/src/worker/worker-static-routes.ts +54 -0
  468. package/src/worker/worker-task-lifetime.ts +18 -0
  469. package/tsconfig.local.json +17 -1
  470. package/wrangler.jsonc +13 -0
  471. package/src/local/cli-approval.mjs +0 -117
  472. package/src/local/operation-state-lock.mjs +0 -92
  473. package/src/worker/mcp-session.ts +0 -72
@@ -0,0 +1,515 @@
1
+ #!/usr/bin/env node
2
+ import assert from "node:assert/strict";
3
+ import { spawn } from "node:child_process";
4
+ import { chmod, mkdir, mkdtemp, open, readFile, rm, writeFile } from "node:fs/promises";
5
+ import { tmpdir } from "node:os";
6
+ import path from "node:path";
7
+ import { AppAutomationManager } from "../src/local/app-automation.mjs";
8
+ import { ComputerUseManager } from "../src/local/computer-use.mjs";
9
+ import { MacosBackgroundInputService } from "../src/local/macos-background-input.mjs";
10
+ import { packageRoot } from "../src/local/package-identity.mjs";
11
+
12
+ const EXPLICIT_FLAG = "--run";
13
+ const BACKEND_ENV = "MBM_MACOS_BACKGROUND_VISUAL_BACKEND";
14
+ const BACKEND_VALUE = "skylight-experimental";
15
+ const FIXTURE_SOURCE = path.join(packageRoot, "native", "macos", "MachineBridgeBackgroundInputSmokeFixture.swift");
16
+
17
+ if (process.platform !== "darwin") throw new Error("macOS background-input smoke requires macOS");
18
+ if (!process.argv.includes(EXPLICIT_FLAG)) {
19
+ throw new Error(`refusing interactive smoke without ${EXPLICIT_FLAG}`);
20
+ }
21
+ if (process.env[BACKEND_ENV] !== BACKEND_VALUE) {
22
+ throw new Error(`refusing interactive smoke unless ${BACKEND_ENV}=${BACKEND_VALUE}`);
23
+ }
24
+
25
+ const root = await mkdtemp(path.join(tmpdir(), "mbm-background-input-smoke-"));
26
+ const fixtureName = `mbmcu-${process.pid}`;
27
+ const fixtureApp = path.join(root, `${fixtureName}.app`);
28
+ const fixtureContents = path.join(fixtureApp, "Contents");
29
+ const fixtureBinary = path.join(fixtureContents, "MacOS", fixtureName);
30
+ const statusPath = path.join(root, "status.json");
31
+ const hitPath = path.join(root, "hit.json");
32
+ const dragPath = path.join(root, "drag.json");
33
+ const scrollPath = path.join(root, "scroll.json");
34
+ const activationPath = path.join(root, "activation.json");
35
+ let fixturePid = null;
36
+ let fixtureActivationBaseline = 0;
37
+ let frontBefore = null;
38
+ let frontAfter = null;
39
+
40
+ try {
41
+ await mkdir(path.dirname(fixtureBinary), { recursive: true });
42
+ await writeFile(path.join(fixtureContents, "Info.plist"), fixtureInfoPlist(fixtureName), "utf8");
43
+ await runProcess("/usr/bin/xcrun", [
44
+ "swiftc", "-O", FIXTURE_SOURCE, "-o", fixtureBinary, "-framework", "AppKit", "-framework", "CoreGraphics",
45
+ ], 120_000, false, 256 * 1024);
46
+ await chmod(fixtureBinary, 0o700);
47
+
48
+ frontBefore = await frontmostApplication();
49
+ await runProcess("/usr/bin/open", ["-g", fixtureApp, "--args", statusPath, hitPath, dragPath, scrollPath, activationPath], 10_000, false, 64 * 1024);
50
+ const status = await waitForJson(statusPath, 5_000);
51
+ fixturePid = Number(status.pid);
52
+ assert(Number.isInteger(fixturePid) && fixturePid > 0, "fixture did not publish a pid");
53
+ assert(Number.isInteger(Number(status.windowNumber)) && Number(status.windowNumber) > 0, "fixture did not publish a window id");
54
+ assertNormalizedPoint(status.clickProbe, "fixture click probe");
55
+ assertNormalizedPoint(status.dragSource, "fixture drag source");
56
+ assertNormalizedPoint(status.dragDestination, "fixture drag destination");
57
+ assertNormalizedPoint(status.scrollAnchor, "fixture scroll anchor");
58
+ assert.equal(Number(status.scrollInitialOffsetY), 0, "fixture scroll view did not start at offset zero");
59
+ assert.doesNotThrow(() => process.kill(fixturePid, 0), "fixture exited before WindowServer settled its window");
60
+ assert.notEqual(fixturePid, frontBefore.pid, "LaunchServices fixture unexpectedly became frontmost before the smoke action");
61
+ await delay(250);
62
+ fixtureActivationBaseline = await readActivationCount(activationPath);
63
+
64
+ const service = new MacosBackgroundInputService({
65
+ runProcess,
66
+ cacheRoot: path.join(root, "background-input-cache"),
67
+ platform: "darwin",
68
+ sourceRoot: packageRoot,
69
+ });
70
+ const applications = new AppAutomationManager({
71
+ policy: {},
72
+ authorizeTool() {},
73
+ displayPath: (value) => String(value),
74
+ runProcess,
75
+ readResourceText: async () => "",
76
+ platform: "darwin",
77
+ home: root,
78
+ backgroundVisualBackend: BACKEND_VALUE,
79
+ backgroundInputService: service,
80
+ });
81
+
82
+ const computerUse = new ComputerUseManager({
83
+ authorizeTool() {},
84
+ browserBridgeManager: {},
85
+ appAutomationManager: applications,
86
+ });
87
+ const cuObserved = structuredResult(await computerUse.observe({
88
+ surface: "application",
89
+ application: fixtureName,
90
+ focus_query: "mbm-smoke-button",
91
+ max_depth: 4,
92
+ max_elements: 20,
93
+ timeout_seconds: 10,
94
+ }));
95
+ if (cuObserved.capture.window_coherent !== true) {
96
+ const directWindowState = await applications.inspectApplicationWindow({ application: fixtureName, timeout_seconds: 10 })
97
+ .catch((error) => ({ error: String(error?.message || error) }));
98
+ assert.equal(cuObserved.capture.window_coherent, true,
99
+ `Computer Use did not produce a window-coherent native snapshot: ${JSON.stringify({ capture: cuObserved.capture, directWindowState })}`);
100
+ }
101
+ const cuCheckbox = cuObserved.semantic.elements.find((element) => element.identifier === "mbm-smoke-button");
102
+ assert(cuCheckbox?.ref, "Computer Use observation did not expose the fixture checkbox ref");
103
+ assert.equal(cuCheckbox.checked, false, "Computer Use did not observe the fixture's initial checkbox state");
104
+ const cuUnchecked = structuredResult(await computerUse.act({
105
+ surface: "application",
106
+ snapshot_id: cuObserved.snapshot_id,
107
+ action: "uncheck",
108
+ target: { ref: cuCheckbox.ref },
109
+ post_screenshot: "never",
110
+ post_max_depth: 4,
111
+ post_max_elements: 100,
112
+ timeout_seconds: 10,
113
+ }));
114
+ assert.equal(cuUnchecked.effect_status, "confirmed",
115
+ `Computer Use uncheck was not confirmed by live Accessibility readback: ${JSON.stringify(cuUnchecked)}`);
116
+ assert.equal(cuUnchecked.dispatch.no_input_required, true, "initial uncheck should be an idempotent no-op");
117
+ assert.match(cuUnchecked.continuation.mapped_post_target_ref || "", /^a\d+$/, "Computer Use did not map the checkbox into the post snapshot");
118
+ const cuChecked = structuredResult(await computerUse.act({
119
+ surface: "application",
120
+ snapshot_id: cuUnchecked.post_snapshot_id,
121
+ action: "check",
122
+ target: { ref: cuUnchecked.continuation.mapped_post_target_ref },
123
+ post_screenshot: "never",
124
+ post_max_depth: 4,
125
+ post_max_elements: 100,
126
+ timeout_seconds: 10,
127
+ }));
128
+ assert.equal(cuChecked.effect_status, "confirmed", "Computer Use check from the mapped post ref was not confirmed");
129
+
130
+ const cuTextObserved = structuredResult(await computerUse.observe({
131
+ surface: "application",
132
+ application: fixtureName,
133
+ focus_query: "mbm-smoke-text",
134
+ include_screenshot: false,
135
+ max_depth: 4,
136
+ max_elements: 20,
137
+ timeout_seconds: 10,
138
+ }));
139
+ const cuText = cuTextObserved.semantic.elements.find((element) => element.identifier === "mbm-smoke-text");
140
+ assert(cuText?.ref, "Computer Use observation did not expose the fixture text-field ref");
141
+ const cuSetValue = structuredResult(await computerUse.act({
142
+ surface: "application",
143
+ snapshot_id: cuTextObserved.snapshot_id,
144
+ action: "set_value",
145
+ target: { ref: cuText.ref },
146
+ value: "computer-use-value",
147
+ post_screenshot: "never",
148
+ post_max_depth: 4,
149
+ post_max_elements: 100,
150
+ timeout_seconds: 10,
151
+ }));
152
+ assert.equal(cuSetValue.effect_status, "confirmed",
153
+ `Computer Use set_value was not confirmed by private live AXValue comparison: ${JSON.stringify({ verification: cuSetValue.verification, post_observation_error: cuSetValue.post_observation_error || "", observed_diff: cuSetValue.observed_diff })}`);
154
+ assert.equal(cuSetValue.verification.post_checks.some((check) => check.condition === "target_value_matches" && check.matched === true), true);
155
+ const cuTextPostRef = cuSetValue.continuation.mapped_post_target_ref;
156
+ assert.match(cuTextPostRef || "", /^a\d+$/, "Computer Use did not map the text field into the set_value post snapshot");
157
+ await rm(hitPath, { force: true });
158
+ const keyboardText = "甲😀乙".repeat(12);
159
+ const cuKeystroke = structuredResult(await computerUse.act({
160
+ surface: "application",
161
+ snapshot_id: cuSetValue.post_snapshot_id,
162
+ action: "keystroke",
163
+ target: { ref: cuTextPostRef },
164
+ value: keyboardText,
165
+ post_screenshot: "never",
166
+ post_max_depth: 4,
167
+ post_max_elements: 100,
168
+ timeout_seconds: 10,
169
+ }));
170
+ assert.equal(cuKeystroke.dispatch_status, "completed", "Computer Use Unicode keystroke did not settle as dispatched");
171
+ assert.equal(cuKeystroke.effect_status, "confirmed", "Computer Use Unicode keystroke did not confirm target focus");
172
+ assert.equal(cuKeystroke.dispatch.input_transport, "public-cgevent-pid", "application keystroke did not use public PID keyboard delivery");
173
+ assert.equal(cuKeystroke.dispatch.focus_prepared, true, "application keystroke lost pre-dispatch AX focus provenance");
174
+ const keyboardEvidence = await waitForJson(hitPath, 3_000,
175
+ (value) => value?.type === "keyDown" && Number(value.keyboardDownCount) >= 3);
176
+ assert.equal(Number(keyboardEvidence.windowNumber), Number(status.windowNumber), "application keystroke reached the wrong AppKit window");
177
+ assert.equal(Number(keyboardEvidence.keyboardDownCount), 3, "application keystroke lost the fixed 20-UTF-16-unit chunking contract");
178
+ assert.deepEqual(keyboardEvidence.keyboardChunks.map((chunk) => String(chunk).length), [20, 20, 8],
179
+ "application keystroke split Unicode chunks at unexpected UTF-16 boundaries");
180
+ assert.equal(keyboardEvidence.keyboardText, keyboardText, "application keystroke lost Unicode content or chunk ordering");
181
+ assert.equal(await readActivationCount(activationPath), fixtureActivationBaseline, "application keystroke activated the fixture");
182
+
183
+ const cuKeyPressRef = cuKeystroke.continuation.mapped_post_target_ref;
184
+ assert.match(cuKeyPressRef || "", /^a\d+$/, "Computer Use did not map the text field into the keystroke post snapshot");
185
+ await rm(hitPath, { force: true });
186
+ const cuKeyPress = structuredResult(await computerUse.act({
187
+ surface: "application",
188
+ snapshot_id: cuKeystroke.post_snapshot_id,
189
+ action: "key_press",
190
+ target: { ref: cuKeyPressRef },
191
+ key: "Shift+Tab",
192
+ post_screenshot: "never",
193
+ post_max_depth: 4,
194
+ post_max_elements: 100,
195
+ timeout_seconds: 10,
196
+ }));
197
+ assert.equal(cuKeyPress.dispatch_status, "completed", "Computer Use special key did not settle as dispatched");
198
+ assert.equal(cuKeyPress.effect_status, "unknown", "Computer Use special key incorrectly inferred a stable post-focus effect from pre-dispatch focus preparation");
199
+ assert.equal(cuKeyPress.dispatch.input_transport, "public-cgevent-pid", "application key_press did not use public PID keyboard delivery");
200
+ assert.equal(cuKeyPress.dispatch.focus_prepared, true, "application key_press lost pre-dispatch AX focus provenance");
201
+ const keyPressEvidence = await waitForJson(hitPath, 3_000,
202
+ (value) => value?.type === "keyDown" && Number(value.keyboardDownCount) >= 4);
203
+ assert.equal(Number(keyPressEvidence.windowNumber), Number(status.windowNumber), "application key_press reached the wrong AppKit window");
204
+ assert.equal(Number(keyPressEvidence.keyboardDownCount), 4, "application key_press was not delivered exactly once after Unicode chunks");
205
+ assert.equal(Number(keyPressEvidence.keyboardKeyCode), 0x30, "application key_press did not preserve the layout-independent Tab key code");
206
+ assert.notEqual(Number(keyPressEvidence.keyboardModifierFlags) & (1 << 17), 0, "application key_press lost the Shift modifier");
207
+ assert.equal(await readActivationCount(activationPath), fixtureActivationBaseline, "application key_press activated the fixture");
208
+
209
+ const cuFocusObserved = structuredResult(await computerUse.observe({
210
+ surface: "application",
211
+ application: fixtureName,
212
+ focus_query: "mbm-smoke-button",
213
+ include_screenshot: false,
214
+ max_depth: 4,
215
+ max_elements: 20,
216
+ timeout_seconds: 10,
217
+ }));
218
+ const cuFocusCheckbox = cuFocusObserved.semantic.elements.find((element) => element.identifier === "mbm-smoke-button");
219
+ assert(cuFocusCheckbox?.ref, "Computer Use focus observation did not expose the fixture checkbox ref");
220
+ const cuFocused = structuredResult(await computerUse.act({
221
+ surface: "application",
222
+ snapshot_id: cuFocusObserved.snapshot_id,
223
+ action: "focus",
224
+ target: { ref: cuFocusCheckbox.ref },
225
+ post_screenshot: "never",
226
+ post_max_depth: 4,
227
+ post_max_elements: 20,
228
+ timeout_seconds: 10,
229
+ }));
230
+ assert.equal(cuFocused.effect_status, "confirmed", "Computer Use semantic ref focus was not confirmed");
231
+ await delay(250);
232
+
233
+ const cuRawObserved = structuredResult(await computerUse.observe({
234
+ surface: "application",
235
+ application: fixtureName,
236
+ max_depth: 2,
237
+ max_elements: 20,
238
+ timeout_seconds: 10,
239
+ }));
240
+ await rm(hitPath, { force: true });
241
+ const cuRawPoint = structuredResult(await computerUse.act({
242
+ surface: "application",
243
+ snapshot_id: cuRawObserved.snapshot_id,
244
+ action: "click",
245
+ target: { point: status.clickProbe },
246
+ post_screenshot: "always",
247
+ post_max_depth: 2,
248
+ post_max_elements: 20,
249
+ timeout_seconds: 10,
250
+ }));
251
+ const cuRawHit = await waitForJson(hitPath, 3_000);
252
+ assert.equal(cuRawPoint.dispatch.coordinate_source, "macos_skylight_experimental",
253
+ "Computer Use blank-surface point did not fall back to the snapshot-bound native pixel backend");
254
+ assert.equal(cuRawPoint.dispatch_status, "completed");
255
+ assert.equal(Number(cuRawHit.windowNumber), Number(status.windowNumber), "Computer Use raw visual point reached the wrong AppKit window");
256
+ assert.equal(cuRawHit.handledBy, "TargetView", "Computer Use raw visual point entered the window but did not reach the intended AppKit view handler");
257
+
258
+ const rawDownCount = Number(cuRawHit.downCount || 0);
259
+ await rm(hitPath, { force: true });
260
+ const cuDoubleClick = structuredResult(await computerUse.act({
261
+ surface: "application",
262
+ snapshot_id: cuRawPoint.post_snapshot_id,
263
+ action: "double_click",
264
+ target: { point: status.clickProbe },
265
+ post_screenshot: "always",
266
+ post_max_depth: 2,
267
+ post_max_elements: 20,
268
+ timeout_seconds: 10,
269
+ }));
270
+ const doubleClickEvidence = await waitForJson(hitPath, 3_000,
271
+ (value) => Number(value?.downCount || 0) >= rawDownCount + 2);
272
+ assert.equal(cuDoubleClick.dispatch_status, "completed", "Computer Use background double click did not settle as one completed mutation");
273
+ assert.equal(cuDoubleClick.effect_status, "unknown", "double click without an explicit post-condition was promoted to effect success");
274
+ assert.equal(cuDoubleClick.dispatch.input_transport, "public-cgevent-pid", "AppKit double click did not keep the exact-once public PID transport");
275
+ assert.equal(cuDoubleClick.dispatch.focus_without_raise, false, "AppKit double click unexpectedly performed focus preparation");
276
+ assert.equal(cuDoubleClick.dispatch.screenshot_revalidated, true, "double click did not revalidate the exact window screenshot");
277
+ assert.equal(cuDoubleClick.dispatch.cursor_preserved, true, "background double click moved the hardware cursor");
278
+ assert.equal(Number(doubleClickEvidence.windowNumber), Number(status.windowNumber), "double click reached the wrong AppKit window");
279
+ assert.equal(doubleClickEvidence.handledBy, "TargetView", "double click did not reach the intended AppKit view");
280
+ assert.equal(Number(doubleClickEvidence.downCount) - rawDownCount, 2, "double click duplicated or dropped mouseDown delivery");
281
+ assert.deepEqual((doubleClickEvidence.clickCounts || []).slice(-2).map(Number), [1, 2],
282
+ "double click did not deliver clickCount 1 then 2 exactly once");
283
+
284
+ await rm(dragPath, { force: true });
285
+ const cuDrag = structuredResult(await computerUse.act({
286
+ surface: "application",
287
+ snapshot_id: cuDoubleClick.post_snapshot_id,
288
+ action: "drag",
289
+ target: { point: status.dragSource },
290
+ destination: { point: status.dragDestination },
291
+ post_screenshot: "always",
292
+ post_max_depth: 2,
293
+ post_max_elements: 20,
294
+ timeout_seconds: 10,
295
+ }));
296
+ const dragEvidence = await waitForJson(dragPath, 3_000);
297
+ const expectedDragDestination = {
298
+ x: Number(status.dragDestination.x) * Number(cuRawObserved.semantic.selection.window_size.width),
299
+ y: (1 - Number(status.dragDestination.y)) * Number(cuRawObserved.semantic.selection.window_size.height),
300
+ };
301
+ assert.equal(cuDrag.dispatch_status, "completed", "Computer Use background drag did not settle as dispatched");
302
+ assert.equal(cuDrag.dispatch.coordinate_source, "macos_skylight_experimental");
303
+ assert.equal(cuDrag.dispatch.input_transport, "public-cgevent-pid", "native AppKit drag did not use the non-activating public PID route");
304
+ assert.equal(cuDrag.dispatch.cursor_preserved, true, "background drag moved the hardware cursor");
305
+ assert.equal(Number(dragEvidence.windowNumber), Number(status.windowNumber), "background drag reached the wrong AppKit window");
306
+ assert.equal(dragEvidence.lastType, "mouseUp", "background drag did not finish with mouseUp");
307
+ assert.equal(Number(dragEvidence.downCount), 1, "background drag duplicated mouseDown delivery");
308
+ assert.equal(Number(dragEvidence.draggedCount), 8, "background drag did not deliver the fixed eight-step path exactly once");
309
+ assert.equal(Number(dragEvidence.upCount), 1, "background drag duplicated mouseUp delivery");
310
+ assertNear(Number(dragEvidence.x), expectedDragDestination.x, 1.5, "background drag released at the wrong window-local x");
311
+ assertNear(Number(dragEvidence.y), expectedDragDestination.y, 1.5, "background drag released at the wrong window-local y");
312
+
313
+ await rm(scrollPath, { force: true });
314
+ const cuScrollResult = await computerUse.act({
315
+ surface: "application",
316
+ snapshot_id: cuDrag.post_snapshot_id,
317
+ action: "scroll",
318
+ target: { point: status.scrollAnchor },
319
+ delta_y: 480,
320
+ expect: { visual_change: true },
321
+ post_screenshot: "always",
322
+ post_max_depth: 2,
323
+ post_max_elements: 20,
324
+ timeout_seconds: 10,
325
+ });
326
+ const cuScroll = structuredResult(cuScrollResult);
327
+ const scrollEvidence = await waitForJson(scrollPath, 3_000);
328
+ assert.equal(cuScroll.dispatch_status, "completed", "Computer Use background scroll did not settle as dispatched");
329
+ assert.equal(cuScroll.effect_status, "confirmed", "Computer Use did not confirm the native scroll from visual post-state");
330
+ assert.equal(cuScroll.dispatch.coordinate_source, "macos_skylight_experimental");
331
+ assert.equal(cuScroll.dispatch.input_transport, "skylight-pid", "native AppKit scroll did not stay on the non-disruptive SkyLight PID route");
332
+ assert.equal(cuScroll.dispatch.cursor_preserved, true, "background scroll moved the hardware cursor");
333
+ assert.deepEqual(cuScroll.dispatch.scroll_delta, { delta_x: 0, delta_y: 480 });
334
+ assert.equal(Number(scrollEvidence.windowNumber), Number(status.windowNumber), "background scroll reached the wrong AppKit window");
335
+ assert.equal(Number(scrollEvidence.eventCount), 1, "background scroll duplicated logical wheel delivery");
336
+ assert.equal(scrollEvidence.precise, true, "background scroll did not use precise pixel-unit wheel delivery");
337
+ assertNear(Number(scrollEvidence.deltaX), 0, 0.01, "background scroll changed the horizontal delta");
338
+ assertNear(Number(scrollEvidence.deltaY), -480, 0.01, "background scroll lost the macOS wheel sign mapping");
339
+ assertNear(Number(scrollEvidence.beforeOffsetY), Number(status.scrollInitialOffsetY), 0.01, "background scroll started from an unexpected content offset");
340
+ assertNear(Number(scrollEvidence.afterOffsetY) - Number(scrollEvidence.beforeOffsetY), 480, 1.5,
341
+ "background wheel was delivered but did not scroll the nested NSScrollView by the requested amount");
342
+ frontAfter = await frontmostApplication();
343
+ const activationCount = await readActivationCount(activationPath);
344
+ assert.notEqual(frontAfter.pid, fixturePid, "background Computer Use left the fixture frontmost");
345
+ assert.equal(activationCount, fixtureActivationBaseline, "background Computer Use activated the fixture application");
346
+ assert.equal(cuRawPoint.dispatch.input_transport, "public-cgevent-pid");
347
+ assert.equal(cuRawPoint.dispatch.focus_without_raise, false, "AppKit visual click unexpectedly performed focus preparation");
348
+ assert.equal(cuDrag.dispatch.focus_without_raise, false, "AppKit drag unexpectedly performed focus preparation");
349
+ assert.equal(cuScroll.dispatch.focus_without_raise, false, "AppKit scroll unexpectedly performed focus preparation");
350
+
351
+ process.stdout.write(`${JSON.stringify({
352
+ ok: true,
353
+ backend: BACKEND_VALUE,
354
+ fixture: { pid: Number(status.pid), window_id: Number(status.windowNumber) },
355
+ fixture_never_activated: true,
356
+ cursor_preserved: cuRawPoint.dispatch.cursor_preserved === true
357
+ && cuDoubleClick.dispatch.cursor_preserved === true
358
+ && cuDrag.dispatch.cursor_preserved === true
359
+ && cuScroll.dispatch.cursor_preserved === true,
360
+ computer_use_e2e: {
361
+ mapped_post_ref: true,
362
+ desired_state_idempotence: true,
363
+ private_value_readback: true,
364
+ pid_unicode_keystroke: true,
365
+ pid_special_key_press: true,
366
+ semantic_ref_focus: true,
367
+ raw_visual_click: true,
368
+ native_double_click_exact_once: true,
369
+ native_drag_exact_once: true,
370
+ native_scroll_effect_confirmed: true,
371
+ },
372
+ transports: {
373
+ keyboard: cuKeystroke.dispatch.input_transport,
374
+ click: cuRawPoint.dispatch.input_transport,
375
+ double_click: cuDoubleClick.dispatch.input_transport,
376
+ drag: cuDrag.dispatch.input_transport,
377
+ scroll: cuScroll.dispatch.input_transport,
378
+ },
379
+ }, null, 2)}\n`);
380
+ } finally {
381
+ if (fixturePid && frontBefore) {
382
+ const current = await frontmostApplication().catch(() => null);
383
+ if (current?.pid === fixturePid) await restoreFrontmost(frontBefore.pid).catch(() => { /* Preserve the smoke-test result; frontmost restoration is best-effort cleanup. */ });
384
+ }
385
+ if (fixturePid) await terminatePid(fixturePid).catch(() => { /* Fixture termination is best-effort cleanup after the primary result is known. */ });
386
+ await rm(root, { recursive: true, force: true }).catch(() => { /* Temporary fixture removal is best-effort cleanup. */ });
387
+ }
388
+
389
+ async function frontmostApplication() {
390
+ const source = String.raw`ObjC.import('AppKit'); const app=$.NSWorkspace.sharedWorkspace.frontmostApplication; JSON.stringify({pid:Number(app.processIdentifier),name:String(ObjC.unwrap(app.localizedName)||'')});`;
391
+ const result = await runProcess("/usr/bin/osascript", ["-l", "JavaScript", "-e", source], 10_000, false, 64 * 1024);
392
+ const parsed = JSON.parse(String(result.stdout || "").trim());
393
+ if (!Number.isInteger(Number(parsed.pid)) || Number(parsed.pid) < 1) throw new Error("could not resolve frontmost application pid");
394
+ return { pid: Number(parsed.pid), name: String(parsed.name || "") };
395
+ }
396
+
397
+ async function restoreFrontmost(pid) {
398
+ const script = `tell application "System Events" to set frontmost of first application process whose unix id is ${Number(pid)} to true`;
399
+ await runProcess("/usr/bin/osascript", ["-e", script], 10_000, true, 64 * 1024);
400
+ }
401
+
402
+ async function readActivationCount(file) {
403
+ try {
404
+ const parsed = JSON.parse(await readFile(file, "utf8"));
405
+ const count = Number(parsed?.activationCount || 0);
406
+ return Number.isInteger(count) && count >= 0 ? count : 0;
407
+ } catch (error) {
408
+ if (error?.code === "ENOENT") return 0;
409
+ throw error;
410
+ }
411
+ }
412
+
413
+ async function waitForJson(file, timeoutMs, predicate = () => true) {
414
+ const deadline = Date.now() + timeoutMs;
415
+ let lastError = null;
416
+ while (Date.now() < deadline) {
417
+ try {
418
+ const handle = await open(file, "r");
419
+ try {
420
+ const info = await handle.stat();
421
+ if (info.isFile() && info.size > 0 && info.size < 64 * 1024) {
422
+ const parsed = JSON.parse(await handle.readFile("utf8"));
423
+ if (predicate(parsed)) return parsed;
424
+ }
425
+ } finally {
426
+ await handle.close();
427
+ }
428
+ } catch (error) { lastError = error; }
429
+ await delay(50);
430
+ }
431
+ throw new Error(`timed out waiting for fixture evidence${lastError ? ` (${String(lastError.code || lastError.message || lastError)})` : ""}`);
432
+ }
433
+
434
+ async function terminatePid(pid) {
435
+ try { process.kill(pid, "SIGTERM"); }
436
+ catch (error) { if (error?.code === "ESRCH") return; else throw error; }
437
+ const deadline = Date.now() + 1_000;
438
+ while (Date.now() < deadline) {
439
+ await delay(50);
440
+ try { process.kill(pid, 0); }
441
+ catch (error) { if (error?.code === "ESRCH") return; else throw error; }
442
+ }
443
+ try { process.kill(pid, "SIGKILL"); }
444
+ catch (error) { if (error?.code !== "ESRCH") throw error; }
445
+ }
446
+
447
+ function fixtureInfoPlist(name) {
448
+ return `<?xml version="1.0" encoding="UTF-8"?>\n<!DOCTYPE plist PUBLIC "-//Apple//DTD PLIST 1.0//EN" "http://www.apple.com/DTDs/PropertyList-1.0.dtd">\n<plist version="1.0"><dict>\n<key>CFBundleExecutable</key><string>${name}</string>\n<key>CFBundleIdentifier</key><string>dev.machinebridge.smoke.p${process.pid}</string>\n<key>CFBundleName</key><string>${name}</string>\n<key>CFBundlePackageType</key><string>APPL</string>\n<key>LSUIElement</key><true/>\n</dict></plist>\n`;
449
+ }
450
+
451
+ function structuredResult(value) {
452
+ return value?.$mcp?.structuredContent || value;
453
+ }
454
+
455
+ function runProcess(cmd, argv, timeoutMs = 30_000, allowFailure = false, maxOutputBytes = 512 * 1024, _context = {}, cwd = undefined, stdin = null) {
456
+ return new Promise((resolve, reject) => {
457
+ const child = spawn(cmd, argv, { cwd, stdio: ["pipe", "pipe", "pipe"] });
458
+ const stdout = [];
459
+ const stderr = [];
460
+ let bytes = 0;
461
+ let settled = false;
462
+ const timer = setTimeout(() => child.kill("SIGKILL"), timeoutMs);
463
+ const collect = (target) => (chunk) => {
464
+ bytes += chunk.length;
465
+ if (bytes > maxOutputBytes) {
466
+ child.kill("SIGKILL");
467
+ return;
468
+ }
469
+ target.push(chunk);
470
+ };
471
+ child.stdout.on("data", collect(stdout));
472
+ child.stderr.on("data", collect(stderr));
473
+ child.on("error", (error) => {
474
+ if (!settled) {
475
+ settled = true;
476
+ clearTimeout(timer);
477
+ reject(error);
478
+ }
479
+ });
480
+ child.on("close", (code, signal) => {
481
+ if (!settled) {
482
+ settled = true;
483
+ clearTimeout(timer);
484
+ const result = {
485
+ code: Number.isInteger(code) ? code : null,
486
+ signal: signal || null,
487
+ stdout: Buffer.concat(stdout).toString("utf8"),
488
+ stderr: Buffer.concat(stderr).toString("utf8"),
489
+ };
490
+ if (bytes > maxOutputBytes) reject(new Error(`process output exceeded ${maxOutputBytes} bytes`));
491
+ else if (!allowFailure && code !== 0) reject(new Error(`${cmd} exited with ${code ?? signal}: ${result.stderr.trim()}`));
492
+ else resolve(result);
493
+ }
494
+ });
495
+ if (stdin === null || stdin === undefined) child.stdin.end();
496
+ else child.stdin.end(String(stdin));
497
+ });
498
+ }
499
+
500
+ function delay(milliseconds) {
501
+ return new Promise((resolve) => { setTimeout(resolve, milliseconds); });
502
+ }
503
+
504
+ function assertNormalizedPoint(value, label) {
505
+ assert(value && typeof value === "object", `${label} is missing`);
506
+ for (const axis of ["x", "y"]) {
507
+ const number = Number(value[axis]);
508
+ assert(Number.isFinite(number) && number >= 0 && number < 1, `${label}.${axis} is outside normalized window space`);
509
+ }
510
+ }
511
+
512
+ function assertNear(actual, expected, tolerance, message) {
513
+ assert(Number.isFinite(actual) && Number.isFinite(expected) && Math.abs(actual - expected) <= tolerance,
514
+ `${message}: expected ${expected} +/- ${tolerance}, got ${actual}`);
515
+ }
@@ -6,6 +6,7 @@ const TRANSIENT_NETWORK_FAILURE = /(?:SSL_ERROR_SYSCALL|SSL_connect|TLS handshak
6
6
  export function runNetworkCommand(command, args, options = {}) {
7
7
  const attempts = clampInteger(options.attempts, 3, 1, 5);
8
8
  const baseDelayMs = clampInteger(options.baseDelayMs, 750, 0, 10_000);
9
+ const timeoutMs = clampInteger(options.timeoutMs, 120_000, 10, 600_000);
9
10
  const actualArgs = networkCommandArgs(command, args);
10
11
  let result;
11
12
  for (let attempt = 1; attempt <= attempts; attempt += 1) {
@@ -14,6 +15,9 @@ export function runNetworkCommand(command, args, options = {}) {
14
15
  encoding: "utf8",
15
16
  stdio: "pipe",
16
17
  env: options.env,
18
+ timeout: timeoutMs,
19
+ killSignal: "SIGKILL",
20
+ maxBuffer: 8 * 1024 * 1024,
17
21
  windowsHide: true,
18
22
  });
19
23
  result.attempts = attempt;
@@ -24,7 +28,10 @@ export function runNetworkCommand(command, args, options = {}) {
24
28
  }
25
29
 
26
30
  export function networkCommandArgs(command, args) {
27
- return command === "git" ? ["-c", "http.version=HTTP/1.1", ...args] : [...args];
31
+ const executable = String(command || "");
32
+ return /(?:^|[\\/])git(?:\.exe)?$/i.test(executable)
33
+ ? ["-c", "http.version=HTTP/1.1", ...args]
34
+ : [...args];
28
35
  }
29
36
 
30
37
  export function isTransientNetworkFailure(result) {
@@ -0,0 +1,27 @@
1
+ import { spawnSync } from "node:child_process";
2
+ import { isAbsolute, resolve } from "node:path";
3
+ import { nestedNpmEnvironment } from "../src/local/npm-environment.mjs";
4
+ import { releaseCommandFailure } from "./release-diagnostic.mjs";
5
+
6
+ export function resolveNpmGlobalPrefix(npmCli, options = {}) {
7
+ const cli = String(npmCli || "").trim();
8
+ if (!isAbsolute(cli)) throw new TypeError("npm global prefix resolution requires an absolute npm CLI path");
9
+ const cwd = resolve(String(options.cwd || process.cwd()));
10
+ const run = options.run || spawnSync;
11
+ const result = run(process.execPath, [cli, "prefix", "--global", "--json=false", "--parseable=false"], {
12
+ cwd,
13
+ encoding: "utf8",
14
+ env: nestedNpmEnvironment(options.env || process.env),
15
+ timeout: 30_000,
16
+ killSignal: "SIGKILL",
17
+ windowsHide: true,
18
+ });
19
+ if (result.error || result.status !== 0) {
20
+ throw new Error(`npm global prefix resolution failed: ${releaseCommandFailure("npm", ["prefix"], result)}`);
21
+ }
22
+ const prefix = String(result.stdout || "").trim();
23
+ if (!prefix || prefix.length > 32 * 1024 || /[\0\r\n]/.test(prefix) || !isAbsolute(prefix)) {
24
+ throw new Error("npm global prefix output is invalid");
25
+ }
26
+ return resolve(prefix);
27
+ }
@@ -0,0 +1,17 @@
1
+ #!/usr/bin/env node
2
+
3
+ import { readFileSync } from "node:fs";
4
+ import { resolve } from "node:path";
5
+ import { assertPublishTag, parseReleaseVersion } from "./release-channel.mjs";
6
+ import { releaseDiagnosticEvent } from "./release-diagnostic.mjs";
7
+
8
+ try {
9
+ const pkg = JSON.parse(readFileSync(resolve("package.json"), "utf8"));
10
+ const parsed = parseReleaseVersion(pkg.version);
11
+ const configured = String(process.env.npm_config_tag || "latest").trim().toLowerCase() || "latest";
12
+ assertPublishTag(parsed.raw, configured);
13
+ console.log(`npm publication channel verified: ${parsed.raw} -> ${parsed.npmTag}`);
14
+ } catch (error) {
15
+ console.error(JSON.stringify(releaseDiagnosticEvent("npm.publication_policy.failed", error?.message || error, 1000)));
16
+ process.exit(1);
17
+ }