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
package/package.json CHANGED
@@ -1,6 +1,6 @@
1
1
  {
2
2
  "name": "machine-bridge-mcp",
3
- "version": "2.0.0",
3
+ "version": "3.0.0-beta.102",
4
4
  "description": "Cross-client MCP bridge for local agent context, structured browser and application automation, files, Git, processes, resources, and durable jobs over stdio or OAuth relay.",
5
5
  "type": "module",
6
6
  "license": "MIT",
@@ -22,6 +22,7 @@
22
22
  "src/shared",
23
23
  "src/worker",
24
24
  "scripts",
25
+ "native",
25
26
  "wrangler.jsonc",
26
27
  "tsconfig.json",
27
28
  "tsconfig.local.json",
@@ -43,18 +44,18 @@
43
44
  "version:check": "node scripts/sync-worker-version.mjs --check",
44
45
  "version": "node scripts/sync-worker-version.mjs && git add package.json package-lock.json src/worker/index.ts browser-extension/manifest.json",
45
46
  "prepack": "npm run version:check && npm run privacy:check && npm run release-impact:check",
46
- "prepublishOnly": "npm run check && npm run version:check && npm run release:check",
47
+ "prepublishOnly": "npm run publication:check && npm run check && npm run version:check && npm run release:check",
47
48
  "worker:types": "node scripts/generate-worker-types.mjs",
48
49
  "typecheck": "npm run worker:types && tsc -p tsconfig.json --noEmit && npm run typecheck:local",
49
50
  "syntax": "node scripts/syntax-check.mjs",
50
51
  "check": "npm run check:full",
51
- "worker:dry-run": "wrangler deploy --dry-run",
52
+ "worker:dry-run": "node scripts/run-worker-dry-run.mjs",
52
53
  "worker:integration-test": "node tests/worker-integration-test.mjs",
53
- "release:check": "node scripts/github-release.mjs --check",
54
- "release:publish": "node scripts/github-release.mjs --publish",
54
+ "release:check": "npm run consumer-security:test && node scripts/github-release.mjs --check",
55
55
  "release:backfill": "node scripts/github-release.mjs --backfill",
56
56
  "stdio:integration-test": "node tests/stdio-integration-test.mjs",
57
57
  "catalog:test": "node tests/catalog-test.mjs",
58
+ "tool-arguments:test": "node tests/tool-argument-validation-test.mjs",
58
59
  "managed-jobs:test": "node tests/managed-jobs-test.mjs",
59
60
  "ssh-key:test": "node tests/ssh-key-test.mjs",
60
61
  "full-access:test": "node tests/full-access-test.mjs",
@@ -66,7 +67,9 @@
66
67
  "release-impact:test": "node tests/release-impact-test.mjs",
67
68
  "privacy:test": "node tests/privacy-test.mjs",
68
69
  "network-retry:test": "node tests/network-retry-test.mjs",
70
+ "release-diagnostic:test": "node tests/release-diagnostic-test.mjs",
69
71
  "relay:test": "node tests/relay-connection-test.mjs",
72
+ "relay-http-fallback:test": "node tests/relay-http-fallback-test.mjs",
70
73
  "install:test": "node tests/install-smoke-test.mjs",
71
74
  "secure-file:test": "node tests/secure-file-test.mjs",
72
75
  "worker-secret-file:test": "node tests/worker-secret-file-test.mjs",
@@ -76,29 +79,43 @@
76
79
  "numbers:test": "node tests/numbers-test.mjs",
77
80
  "records:test": "node tests/records-test.mjs",
78
81
  "state-inventory:test": "node tests/state-inventory-test.mjs",
82
+ "state-root-retirement:test": "node tests/state-root-retirement-test.mjs",
79
83
  "release-state:test": "node tests/release-state-test.mjs",
80
84
  "release-ci:test": "node tests/release-ci-test.mjs",
81
85
  "agent-context:test": "node tests/agent-context-test.mjs",
82
86
  "agent-boundaries:test": "node tests/agent-boundaries-test.mjs",
83
87
  "browser-bridge:test": "node tests/browser-bridge-test.mjs",
84
88
  "app-automation:test": "node tests/app-automation-test.mjs",
89
+ "app-screenshot:test": "node tests/app-screenshot-test.mjs",
90
+ "macos-background-input:test": "node tests/macos-background-input-test.mjs",
91
+ "macos-background-input:smoke": "node scripts/macos-background-input-smoke.mjs",
92
+ "macos-native-build:test": "node tests/macos-native-build-test.mjs",
85
93
  "process-lock:test": "node tests/process-lock-test.mjs",
86
94
  "service-lifecycle:test": "node tests/service-lifecycle-test.mjs",
87
95
  "service-environment:test": "node tests/service-environment-test.mjs",
88
96
  "app-automation:live-test": "node tests/app-automation-test.mjs --live-macos",
89
97
  "browser-command:test": "node tests/browser-command-test.mjs",
98
+ "browser-request-settlement:test": "node tests/browser-request-settlement-test.mjs",
99
+ "browser-operation-service:test": "node tests/browser-operation-service-test.mjs",
100
+ "computer-use-application-observation:test": "node tests/computer-use-application-observation-test.mjs",
101
+ "computer-use-result-budget:test": "node tests/computer-use-result-budget-test.mjs",
102
+ "computer-use:test": "node tests/computer-use-test.mjs",
90
103
  "browser-devtools-input:test": "node tests/browser-devtools-input-test.mjs",
104
+ "browser-devtools-observation:test": "node tests/browser-devtools-observation-test.mjs",
105
+ "browser-computer-observation:test": "node tests/browser-computer-observation-test.mjs",
91
106
  "browser-page-automation:test": "node tests/browser-page-automation-test.mjs",
92
107
  "browser-service-worker:test": "node tests/browser-service-worker-test.mjs",
93
108
  "service-platform:test": "node tests/service-platform-test.mjs",
94
109
  "policy:test": "node tests/policy-test.mjs",
95
110
  "runtime-infrastructure:test": "node tests/runtime-infrastructure-test.mjs",
111
+ "control-plane-resilience:test": "node --test tests/control-plane-resilience-test.mjs",
96
112
  "worker-runtime-infrastructure:test": "node tests/worker-runtime-infrastructure-test.mjs",
97
113
  "logging-structure:test": "node tests/logging-structure-test.mjs",
98
114
  "policy-docs:generate": "node scripts/generate-policy-reference.mjs",
99
115
  "policy-docs:check": "node scripts/generate-policy-reference.mjs --check",
100
116
  "coverage:test": "node scripts/coverage-check.mjs",
101
117
  "capability-ranking:test": "node tests/capability-ranking-test.mjs",
118
+ "execution-routing:test": "node tests/execution-routing-test.mjs",
102
119
  "lifecycle:test": "node tests/lifecycle-test.mjs",
103
120
  "runtime-handlers:test": "node tests/runtime-handler-matrix-test.mjs",
104
121
  "cli-entrypoint:test": "node tests/cli-entrypoint-test.mjs",
@@ -109,7 +126,7 @@
109
126
  "account:test": "node tests/account-admin-test.mjs",
110
127
  "sarif-security:test": "node tests/sarif-security-gate-test.mjs",
111
128
  "security-properties:test": "node tests/security-properties-test.js",
112
- "lint": "eslint eslint.config.mjs bin src/local scripts tests browser-extension",
129
+ "lint": "eslint eslint.config.mjs bin src/local src/shared scripts tests browser-extension .github/scripts",
113
130
  "lint:test": "node tests/lint-gate-test.mjs",
114
131
  "shell:test": "node tests/shell-test.mjs",
115
132
  "deadline:test": "node tests/monotonic-deadline-test.mjs",
@@ -117,10 +134,13 @@
117
134
  "worker-deployment:test": "node tests/worker-deployment-test.mjs",
118
135
  "typecheck:local": "tsc -p tsconfig.local.json --noEmit",
119
136
  "runtime-boundaries:test": "node tests/runtime-boundaries-test.mjs",
137
+ "git-commit:test": "node tests/git-commit-test.mjs",
120
138
  "worker-oauth-controller:test": "node tests/worker-oauth-controller-test.mjs",
121
139
  "cli-service:test": "node tests/cli-service-test.mjs",
122
140
  "release:acceptance:test": "node tests/release-acceptance-test.mjs",
123
- "release:candidate": "npm run check && node scripts/local-release-acceptance.mjs --prepare",
141
+ "release-oauth-canary:test": "node tests/release-oauth-canary-test.mjs",
142
+ "release:candidate": "node scripts/local-release-acceptance.mjs --prepare",
143
+ "release:oauth-canary": "node scripts/release-oauth-canary.mjs",
124
144
  "release:accept": "node scripts/local-release-acceptance.mjs --record",
125
145
  "release:acceptance:verify": "node scripts/local-release-acceptance.mjs --verify",
126
146
  "github:push": "node scripts/github-push.mjs",
@@ -131,24 +151,77 @@
131
151
  "release": "node scripts/github-release.mjs --publish",
132
152
  "release:candidate:start": "node scripts/start-release-candidate.mjs",
133
153
  "check-runner:test": "node tests/check-runner-test.mjs",
154
+ "full-verification-receipt:test": "node tests/full-verification-receipt-test.mjs",
134
155
  "process-output:test": "node tests/process-output-continuation-test.mjs",
156
+ "process-nonreplayable:test": "node tests/process-nonreplayable-test.mjs",
135
157
  "github-backlog:test": "node tests/github-backlog-test.mjs",
136
158
  "github:backlog": "node scripts/github-backlog.mjs",
137
159
  "operation-authorization:test": "node tests/operation-authorization-test.mjs",
138
- "device-auth:test": "node tests/device-auth-test.mjs"
160
+ "device-auth:test": "node tests/device-auth-test.mjs",
161
+ "device-root-provider:test": "node tests/device-root-provider-test.mjs",
162
+ "security-audit:test": "node tests/security-audit-log-test.mjs",
163
+ "delegated-sandbox:test": "node tests/delegated-process-sandbox-test.mjs",
164
+ "dpop:test": "node tests/dpop-test.mjs",
165
+ "macos-trust:test": "node tests/macos-trust-broker-test.mjs",
166
+ "worker-security:test": "node tests/worker-security-boundaries-test.mjs",
167
+ "publication:check": "node scripts/npm-publication-policy.mjs",
168
+ "prerelease:release": "node scripts/github-release.mjs --publish-prerelease",
169
+ "release:candidate:activate": "node scripts/start-release-candidate.mjs --activate-service",
170
+ "prerelease:install": "node scripts/install-published-prerelease.mjs",
171
+ "prerelease:soak:accept": "node scripts/release-soak.mjs --record",
172
+ "release:soak:verify": "node scripts/release-soak.mjs --verify",
173
+ "release-channel:test": "node tests/release-channel-test.mjs",
174
+ "promotion-digest:test": "node tests/promotion-digest-test.mjs",
175
+ "prerelease-activation:test": "node tests/prerelease-activation-test.mjs",
176
+ "release-soak:test": "node tests/release-soak-test.mjs",
177
+ "published-release:test": "node tests/published-release-test.mjs",
178
+ "npm-publication-policy:test": "node tests/npm-publication-policy-test.mjs",
179
+ "runtime-activation:test": "node tests/runtime-activation-test.mjs",
180
+ "prerelease:publish": "node scripts/publish-npm.mjs prerelease",
181
+ "stable:publish": "node scripts/publish-npm.mjs stable",
182
+ "publish-npm:test": "node tests/publish-npm-test.mjs",
183
+ "release-candidate-manifest:test": "node tests/release-candidate-manifest-test.mjs",
184
+ "device-key-id-stability:test": "node tests/device-key-id-stability-test.mjs",
185
+ "candidate-runtime-store:test": "node tests/candidate-runtime-store-test.mjs",
186
+ "service-restart:test": "node tests/service-restart-handoff-test.mjs",
187
+ "browser-identity:test": "node tests/browser-extension-identity-test.mjs",
188
+ "mcp-protocol:test": "node tests/mcp-protocol-test.mjs",
189
+ "mcp-controller:test": "node tests/mcp-controller-test.mjs",
190
+ "mcp-response-proxy:test": "node tests/mcp-response-proxy-test.mjs",
191
+ "mcp:conformance": "node scripts/official-mcp-conformance.mjs",
192
+ "mcp:conformance:test": "node tests/official-mcp-conformance-test.mjs",
193
+ "sbom-check:test": "node tests/sbom-check-test.mjs",
194
+ "sbom:test": "node scripts/sbom-check.mjs",
195
+ "release-publication-guard:test": "node tests/release-publication-guard-test.mjs",
196
+ "consumer-security:test": "node scripts/consumer-package-security.mjs",
197
+ "consumer-package-security:test": "node tests/consumer-package-security-test.mjs",
198
+ "wrangler-toolchain:test": "node tests/wrangler-toolchain-test.mjs",
199
+ "worker-types-generator:test": "node tests/worker-types-generator-test.mjs",
200
+ "npm-environment:test": "node tests/npm-environment-test.mjs",
201
+ "hardened-npm:test": "node tests/hardened-npm-test.mjs",
202
+ "workflow-policy:check": "node .github/scripts/workflow-policy.mjs",
203
+ "workflow-policy:test": "node tests/workflow-policy-test.mjs",
204
+ "managed-job-boundary:test": "node tests/managed-job-boundary-test.mjs",
205
+ "ci-bootstrap:test": "node tests/ci-bootstrap-test.mjs",
206
+ "browser-broker-auth:test": "node tests/browser-broker-auth-test.mjs",
207
+ "browser-pairing-content:test": "node tests/browser-pairing-content-test.mjs",
208
+ "browser-pairing-launch:test": "node tests/browser-pairing-launch-test.mjs",
209
+ "browser-cli-pairing:test": "node tests/browser-cli-pairing-test.mjs",
210
+ "resource-admission:test": "node tests/resource-admission-test.mjs",
211
+ "resource-build-root:test": "node tests/resource-build-root-test.mjs"
139
212
  },
140
213
  "dependencies": {
141
214
  "https-proxy-agent": "9.1.0",
142
215
  "proxy-from-env": "2.1.0",
143
- "wrangler": "4.112.0",
144
216
  "ws": "8.21.1"
145
217
  },
146
218
  "devDependencies": {
147
- "@types/node": "26.1.1",
148
- "eslint": "10.7.0",
219
+ "@types/node": "26.1.2",
220
+ "eslint": "10.8.0",
149
221
  "fast-check": "4.9.0",
150
- "globals": "17.7.0",
151
- "typescript": "7.0.2"
222
+ "globals": "17.8.0",
223
+ "typescript": "7.0.2",
224
+ "wrangler": "4.120.0"
152
225
  },
153
226
  "keywords": [
154
227
  "mcp",
@@ -178,21 +251,26 @@
178
251
  "homepage": "https://github.com/YuLeiFuYun/machine-bridge-mcp#readme",
179
252
  "allowScripts": {
180
253
  "esbuild@0.28.1": true,
181
- "sharp@0.34.5": true,
182
254
  "fsevents": false,
183
- "workerd@1.20260714.1": true
255
+ "sharp@0.35.3": true,
256
+ "workerd@1.20260801.1": true
184
257
  },
185
258
  "packageManager": "npm@12.0.1",
186
259
  "devEngines": {
187
260
  "runtime": {
188
261
  "name": "node",
189
262
  "version": ">=26.0.0",
190
- "onFail": "error"
263
+ "onFail": "warn"
191
264
  },
192
265
  "packageManager": {
193
266
  "name": "npm",
194
267
  "version": ">=12.0.0",
195
268
  "onFail": "error"
196
269
  }
270
+ },
271
+ "overrides": {
272
+ "sharp": "0.35.3",
273
+ "brace-expansion": "5.0.9",
274
+ "undici": "7.29.0"
197
275
  }
198
276
  }
@@ -0,0 +1,77 @@
1
+ import { mkdtempSync, rmSync, writeFileSync } from "node:fs";
2
+ import { tmpdir } from "node:os";
3
+ import { join, resolve } from "node:path";
4
+ import { readBoundedRegularFileSync } from "../src/local/secure-file.mjs";
5
+ import { validateCandidateManifest } from "./release-candidate-manifest.mjs";
6
+ import { verifyTarball } from "./release-acceptance.mjs";
7
+
8
+ const MAX_CANDIDATE_MANIFEST_BYTES = 64 * 1024;
9
+
10
+ export function resolveAcceptedCandidateTarball(repositoryRoot, acceptance) {
11
+ const inspected = inspectAcceptedCandidate(repositoryRoot, acceptance);
12
+ return Object.freeze({ path: inspected.path, manifest: inspected.manifest });
13
+ }
14
+
15
+ export function stageAcceptedCandidateTarball(repositoryRoot, acceptance, options = {}) {
16
+ const inspected = inspectAcceptedCandidate(repositoryRoot, acceptance);
17
+ const parent = resolve(String(options.tempRoot || tmpdir()));
18
+ const stagingRoot = mkdtempSync(join(parent, "mbm-accepted-candidate-"));
19
+ let disposed = false;
20
+ try {
21
+ const stagedPath = join(stagingRoot, inspected.manifest.filename);
22
+ writeFileSync(stagedPath, inspected.bytes, { flag: "wx", mode: 0o600 });
23
+ verifyTarball(stagedPath, acceptance.metadata);
24
+ return Object.freeze({
25
+ path: stagedPath,
26
+ manifest: inspected.manifest,
27
+ dispose() {
28
+ if (disposed) return;
29
+ rmSync(stagingRoot, { recursive: true, force: true, maxRetries: 3, retryDelay: 50 });
30
+ disposed = true;
31
+ },
32
+ });
33
+ } catch (error) {
34
+ try { rmSync(stagingRoot, { recursive: true, force: true, maxRetries: 3, retryDelay: 50 }); }
35
+ catch (cleanupError) {
36
+ throw new AggregateError([error, cleanupError], "accepted candidate staging failed and temporary cleanup was incomplete");
37
+ }
38
+ throw error;
39
+ }
40
+ }
41
+
42
+ function inspectAcceptedCandidate(repositoryRoot, acceptance) {
43
+ const root = resolve(repositoryRoot);
44
+ if (acceptance?.required !== true || !acceptance.metadata || !acceptance.record) {
45
+ throw new Error("exact npm publication requires current local candidate acceptance");
46
+ }
47
+ const directory = join(root, ".release-candidate");
48
+ const manifest = validateCandidateManifest(readManifest(join(directory, "manifest.json")), {
49
+ packageName: acceptance.metadata.package_name,
50
+ packageVersion: acceptance.metadata.package_version,
51
+ });
52
+ for (const key of ["filename", "shasum", "integrity"]) {
53
+ if (manifest[key] !== acceptance.metadata[key]) {
54
+ throw new Error(`accepted candidate manifest ${key} does not match the acceptance record`);
55
+ }
56
+ }
57
+ if (manifest.promotion_content_sha256 !== acceptance.record.promotion_content_sha256) {
58
+ throw new Error("accepted candidate manifest promotion digest does not match the acceptance record");
59
+ }
60
+ const path = join(directory, manifest.filename);
61
+ const bytes = verifyTarball(path, acceptance.metadata);
62
+ return { path, manifest, bytes };
63
+ }
64
+
65
+ function readManifest(file) {
66
+ let bytes;
67
+ try {
68
+ bytes = readBoundedRegularFileSync(file, MAX_CANDIDATE_MANIFEST_BYTES, "release candidate manifest", {
69
+ verifyPathIdentity: true,
70
+ rejectMultipleLinks: true,
71
+ });
72
+ } catch (error) {
73
+ throw new Error(`release candidate manifest is unavailable or unsafe: ${error?.message || error}`, { cause: error });
74
+ }
75
+ try { return JSON.parse(bytes.toString("utf8")); }
76
+ catch (error) { throw new Error(`release candidate manifest is not valid JSON: ${error.message}`, { cause: error }); }
77
+ }
@@ -0,0 +1,93 @@
1
+ import { randomBytes } from "node:crypto";
2
+ import { lstatSync, readdirSync, realpathSync, rmSync } from "node:fs";
3
+ import { isAbsolute, join, relative, resolve, sep } from "node:path";
4
+ import { isCandidateRuntimeDirectoryName } from "../src/local/state-root-owned-namespaces.mjs";
5
+ import { parseReleaseVersion } from "./release-channel.mjs";
6
+
7
+ const NON_BLOCKING_CLEANUP_CODES = new Set(["EACCES", "EPERM", "EIO", "ENOSPC", "EDQUOT", "ENOMEM", "EROFS", "EMFILE", "ENFILE", "EAGAIN", "ENOBUFS", "EINTR", "ESTALE", "EBUSY", "ENOTEMPTY", "ETIMEDOUT"]);
8
+
9
+ export function candidateRuntimeContainer(stateRoot) {
10
+ return resolve(stateRoot, "release-channels", "runtimes");
11
+ }
12
+
13
+ export function createCandidateRuntimePrefix({ stateRoot, version, shasum, random = () => randomBytes(6).toString("hex") }) {
14
+ const parsed = parseReleaseVersion(version);
15
+ const digest = String(shasum || "");
16
+ if (!/^[0-9a-f]{40}$/.test(digest)) throw new Error("candidate runtime package SHA-1 is invalid");
17
+ const suffix = String(random());
18
+ if (!/^[0-9a-f]{12}$/.test(suffix)) throw new Error("candidate runtime random suffix is invalid");
19
+ return join(candidateRuntimeContainer(stateRoot), `v${parsed.raw}-${digest.slice(0, 12)}-${suffix}`);
20
+ }
21
+
22
+ export function pruneInactiveCandidateRuntimes({ stateRoot, activePrefix, remove = rmSync } = {}) {
23
+ const state = resolve(String(stateRoot || ""));
24
+ const releaseChannels = join(state, "release-channels");
25
+ const container = join(releaseChannels, "runtimes");
26
+ const active = resolve(String(activePrefix || ""));
27
+ const activeRelative = relative(container, active);
28
+ if (!activeRelative || activeRelative === ".." || activeRelative.startsWith(`..${sep}`) || isAbsolute(activeRelative)) {
29
+ throw new Error("active candidate runtime is outside the runtime container");
30
+ }
31
+
32
+ const stateInfo = realDirectoryIfPresent(state, "candidate state root");
33
+ if (!stateInfo) return [];
34
+ const releaseInfo = realDirectoryIfPresent(releaseChannels, "candidate release-channel directory");
35
+ if (!releaseInfo) return [];
36
+ const containerInfo = realDirectoryIfPresent(container, "candidate runtime container");
37
+ if (!containerInfo) return [];
38
+ const canonicalState = realpathSync(state);
39
+ const canonicalReleaseChannels = realpathSync(releaseChannels);
40
+ const canonicalContainer = realpathSync(container);
41
+ requireContainedDirectory(canonicalState, canonicalReleaseChannels, "candidate release-channel directory");
42
+ requireContainedDirectory(canonicalReleaseChannels, canonicalContainer, "candidate runtime container");
43
+
44
+ const activeInfo = realDirectoryIfPresent(active, "active candidate runtime");
45
+ if (!activeInfo) throw new Error("active candidate runtime is missing");
46
+ const canonicalActive = realpathSync(active);
47
+ requireContainedDirectory(canonicalContainer, canonicalActive, "active candidate runtime");
48
+
49
+ const removed = [];
50
+ for (const entry of readdirSync(container, { withFileTypes: true })) {
51
+ if (!entry.isDirectory() || !isCandidateRuntimeDirectoryName(entry.name)) continue;
52
+ const candidatePath = join(container, entry.name);
53
+ const candidateInfo = realDirectoryIfPresent(candidatePath, "inactive candidate runtime");
54
+ if (!candidateInfo) continue;
55
+ const canonicalCandidate = realpathSync(candidatePath);
56
+ requireContainedDirectory(canonicalContainer, canonicalCandidate, "inactive candidate runtime");
57
+ if (canonicalCandidate === canonicalActive) continue;
58
+ requireSameDirectory(container, containerInfo, "candidate runtime container");
59
+ remove(canonicalCandidate, { recursive: true, force: true });
60
+ removed.push(canonicalCandidate);
61
+ }
62
+ return removed;
63
+ }
64
+
65
+ function realDirectoryIfPresent(directory, label) {
66
+ let info;
67
+ try { info = lstatSync(directory); }
68
+ catch (error) {
69
+ if (error?.code === "ENOENT") return null;
70
+ throw error;
71
+ }
72
+ if (info.isSymbolicLink() || !info.isDirectory()) throw new Error(`${label} must be a real directory`);
73
+ return info;
74
+ }
75
+
76
+ function requireContainedDirectory(parent, child, label) {
77
+ const childRelative = relative(parent, child);
78
+ if (!childRelative || childRelative === ".." || childRelative.startsWith(`..${sep}`) || isAbsolute(childRelative)) {
79
+ throw new Error(`${label} escapes its parent directory`);
80
+ }
81
+ }
82
+
83
+ function requireSameDirectory(directory, expected, label) {
84
+ const actual = lstatSync(directory);
85
+ if (actual.isSymbolicLink() || !actual.isDirectory()
86
+ || Number(actual.dev) !== Number(expected.dev) || Number(actual.ino) !== Number(expected.ino)) {
87
+ throw new Error(`${label} identity changed during cleanup`);
88
+ }
89
+ }
90
+
91
+ export function isNonBlockingCandidateRuntimeCleanupError(error) {
92
+ return NON_BLOCKING_CLEANUP_CODES.has(String(error?.code || ""));
93
+ }
@@ -2,16 +2,44 @@ export const FAST_CHECK_TASKS = Object.freeze([
2
2
  "privacy:check",
3
3
  "release-impact:check",
4
4
  "release:acceptance:test",
5
+ "release-oauth-canary:test",
6
+ "release-channel:test",
7
+ "release-candidate-manifest:test",
8
+ "promotion-digest:test",
9
+ "prerelease-activation:test",
10
+ "release-soak:test",
11
+ "published-release:test",
12
+ "npm-publication-policy:test",
13
+ "publish-npm:test",
14
+ "runtime-activation:test",
15
+ "candidate-runtime-store:test",
5
16
  "release-state:test",
17
+ "release-publication-guard:test",
6
18
  "release-ci:test",
7
19
  "network-retry:test",
20
+ "release-diagnostic:test",
8
21
  "check-runner:test",
22
+ "full-verification-receipt:test",
9
23
  "process-output:test",
24
+ "process-nonreplayable:test",
10
25
  "github-backlog:test",
26
+ "workflow-policy:test",
27
+ "managed-job-boundary:test",
11
28
  "secure-file:test",
12
29
  "worker-secret-file:test",
13
30
  "device-auth:test",
31
+ "device-root-provider:test",
32
+ "device-key-id-stability:test",
33
+ "dpop:test",
34
+ "security-audit:test",
14
35
  "sarif-security:test",
36
+ "sbom-check:test",
37
+ "npm-environment:test",
38
+ "hardened-npm:test",
39
+ "ci-bootstrap:test",
40
+ "consumer-package-security:test",
41
+ "wrangler-toolchain:test",
42
+ "worker-types-generator:test",
15
43
  "shell:test",
16
44
  "architecture:test",
17
45
  "markdown:test",
@@ -19,33 +47,74 @@ export const FAST_CHECK_TASKS = Object.freeze([
19
47
  "numbers:test",
20
48
  "records:test",
21
49
  "state-inventory:test",
50
+ "state-root-retirement:test",
22
51
  "commit-message:test",
23
52
  "policy:test",
24
53
  "account:test",
25
54
  "operation-authorization:test",
26
55
  "worker-oauth-controller:test",
56
+ "worker-security:test",
27
57
  "policy-docs:check",
28
58
  "tool-docs:check",
29
59
  "runtime-infrastructure:test",
60
+ "control-plane-resilience:test",
30
61
  "runtime-boundaries:test",
62
+ "git-commit:test",
31
63
  "runtime-handlers:test",
32
64
  "cli-entrypoint:test",
33
65
  "cli-service:test",
66
+ "service-restart:test",
34
67
  "lifecycle:test",
35
68
  "logging-structure:test",
36
69
  "worker-runtime-infrastructure:test",
70
+ "relay-http-fallback:test",
71
+ "mcp-protocol:test",
72
+ "mcp-controller:test",
73
+ "mcp-response-proxy:test",
74
+ "mcp:conformance:test",
37
75
  "lint:test",
38
76
  "lint",
39
77
  "typecheck",
40
78
  "syntax",
41
79
  "deadline:test",
42
80
  "catalog:test",
81
+ "tool-arguments:test",
43
82
  "capability-ranking:test",
83
+ "execution-routing:test",
44
84
  "agent-boundaries:test",
85
+ "browser-identity:test",
86
+ "browser-broker-auth:test",
87
+ "browser-pairing-content:test",
88
+ "browser-pairing-launch:test",
89
+ "browser-cli-pairing:test",
90
+ "resource-admission:test",
91
+ "resource-build-root:test",
45
92
  "browser-command:test",
93
+ "browser-devtools-input:test",
94
+ "browser-devtools-observation:test",
95
+ "browser-computer-observation:test",
96
+ "browser-service-worker:test",
97
+ "app-automation:test",
98
+ "browser-request-settlement:test",
99
+ "browser-operation-service:test",
100
+ "app-screenshot:test",
101
+ "macos-background-input:test",
102
+ "computer-use-application-observation:test",
103
+ "computer-use-result-budget:test",
104
+ "computer-use:test",
46
105
  "check-plan:test",
47
106
  ]);
48
107
 
108
+ export const SERIAL_FAST_CHECK_TASKS = Object.freeze([
109
+ "release:acceptance:test",
110
+ "hardened-npm:test",
111
+ "worker-oauth-controller:test",
112
+ "cli-entrypoint:test",
113
+ "lint",
114
+ "typecheck",
115
+ "syntax",
116
+ ]);
117
+
49
118
  export const PLATFORM_ONLY_CHECK_TASKS = Object.freeze([
50
119
  "privacy:test",
51
120
  "release-impact:test",
@@ -56,11 +125,11 @@ export const PLATFORM_ONLY_CHECK_TASKS = Object.freeze([
56
125
  "service-lifecycle:test",
57
126
  "service-environment:test",
58
127
  "service-platform:test",
128
+ "delegated-sandbox:test",
129
+ "macos-trust:test",
130
+ "macos-native-build:test",
59
131
  "agent-context:test",
60
- "browser-devtools-input:test",
61
- "browser-service-worker:test",
62
132
  "browser-page-automation:test",
63
- "app-automation:test",
64
133
  "self-test",
65
134
  "atomic-fs:test",
66
135
  "ssh-key:test",
@@ -72,6 +141,7 @@ export const FULL_ONLY_CHECK_TASKS = Object.freeze([
72
141
  "coverage:test",
73
142
  "browser-bridge:test",
74
143
  "package:test",
144
+ "sbom:test",
75
145
  "install:test",
76
146
  "stdio:integration-test",
77
147
  "worker:integration-test",