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
@@ -3,34 +3,86 @@ import { mkdtempSync, readFileSync, readdirSync, rmSync } from "node:fs";
3
3
  import { tmpdir } from "node:os";
4
4
  import { dirname, isAbsolute, relative, resolve, sep } from "node:path";
5
5
  import { fileURLToPath } from "node:url";
6
+ import { captureCoverageGeneration } from "./coverage-generation.mjs";
7
+ import { mergeFunctionExecutions } from "./coverage-range-merge.mjs";
6
8
 
7
9
  const root = resolve(dirname(fileURLToPath(import.meta.url)), "..");
10
+ const CRITICAL_SCRIPT_FILES = new Set(["scripts/release-publication-guard.mjs", "scripts/verification-generation-guard.mjs", "scripts/verification-state.mjs"]);
11
+ const generationBefore = captureCoverageGeneration(root);
8
12
  const coverageDir = mkdtempSync(resolve(tmpdir(), "machine-bridge-coverage-"));
9
13
  const tests = [
10
14
  "tests/policy-test.mjs",
11
15
  "tests/runtime-infrastructure-test.mjs",
16
+ "tests/control-plane-resilience-test.mjs",
17
+ "tests/process-output-continuation-test.mjs",
18
+ "tests/process-nonreplayable-test.mjs",
12
19
  "tests/runtime-boundaries-test.mjs",
20
+ "tests/git-commit-test.mjs",
21
+ "tests/privacy-test.mjs",
13
22
  "tests/worker-runtime-infrastructure-test.mjs",
23
+ "tests/mcp-protocol-test.mjs",
24
+ "tests/mcp-controller-test.mjs",
25
+ "tests/mcp-response-proxy-test.mjs",
26
+ "tests/tool-argument-validation-test.mjs",
14
27
  "tests/worker-oauth-controller-test.mjs",
15
28
  "tests/logging-structure-test.mjs",
16
29
  "tests/runtime-handler-matrix-test.mjs",
17
30
  "tests/cli-entrypoint-test.mjs",
18
31
  "tests/cli-service-test.mjs",
32
+ "tests/service-restart-handoff-test.mjs",
33
+ "tests/service-platform-test.mjs",
34
+ "tests/process-lock-test.mjs",
35
+ "tests/secure-file-test.mjs",
36
+ "tests/worker-secret-file-test.mjs",
37
+ "tests/atomic-fs-test.mjs",
38
+ "tests/coverage-range-merge-test.mjs",
39
+ "tests/coverage-generation-test.mjs",
40
+ "tests/check-runner-test.mjs",
41
+ "tests/full-verification-receipt-test.mjs",
42
+ "tests/resource-admission-test.mjs",
43
+ "tests/resource-build-root-test.mjs",
44
+ "tests/runtime-activation-test.mjs",
45
+ "tests/prerelease-activation-test.mjs",
46
+ "tests/release-publication-guard-test.mjs",
19
47
  "tests/local-self-test.mjs",
20
- "tests/runtime-self-test.mjs",
21
48
  "tests/numbers-test.mjs",
22
49
  "tests/records-test.mjs",
23
50
  "tests/project-metadata-test.mjs",
24
51
  "tests/state-inventory-test.mjs",
52
+ "tests/state-root-retirement-test.mjs",
25
53
  "tests/worker-deployment-test.mjs",
54
+ "tests/hardened-npm-test.mjs",
55
+ "tests/wrangler-toolchain-test.mjs",
26
56
  "tests/agent-context-test.mjs",
27
57
  "tests/agent-boundaries-test.mjs",
28
58
  "tests/capability-ranking-test.mjs",
59
+ "tests/execution-routing-test.mjs",
60
+ "tests/browser-broker-auth-test.mjs",
61
+ "tests/browser-pairing-launch-test.mjs",
29
62
  "tests/browser-bridge-test.mjs",
63
+ "tests/browser-request-settlement-test.mjs",
64
+ "tests/browser-operation-service-test.mjs",
65
+ "tests/browser-devtools-input-test.mjs",
66
+ "tests/browser-devtools-observation-test.mjs",
67
+ "tests/browser-service-worker-test.mjs",
68
+ "tests/app-automation-test.mjs",
69
+ "tests/macos-background-input-test.mjs",
70
+ "tests/computer-use-application-observation-test.mjs",
71
+ "tests/browser-computer-observation-test.mjs",
72
+ "tests/computer-use-test.mjs",
73
+ "tests/computer-use-result-budget-test.mjs",
30
74
  "tests/relay-connection-test.mjs",
75
+ "tests/managed-job-boundary-test.mjs",
31
76
  "tests/managed-jobs-test.mjs",
32
77
  "tests/account-admin-test.mjs",
33
78
  "tests/monotonic-deadline-test.mjs",
79
+ "tests/device-auth-test.mjs",
80
+ "tests/operation-authorization-test.mjs",
81
+ "tests/security-audit-log-test.mjs",
82
+ "tests/delegated-process-sandbox-test.mjs",
83
+ "tests/dpop-test.mjs",
84
+ "tests/worker-security-boundaries-test.mjs",
85
+ "tests/ssh-key-test.mjs",
34
86
  ];
35
87
 
36
88
  try {
@@ -47,20 +99,136 @@ try {
47
99
  throw new Error(`coverage fixture failed: ${test}`);
48
100
  }
49
101
  }
102
+ const generationAfter = captureCoverageGeneration(root);
103
+ if (generationAfter !== generationBefore) {
104
+ throw new Error(`coverage generation changed during verification: ${generationBefore} -> ${generationAfter}`);
105
+ }
50
106
 
51
107
  const coverage = collectCoverage(coverageDir);
52
108
  const thresholds = {
109
+ "src/local/authority-context.mjs": [85, 55],
110
+ "src/local/device-identity.mjs": [90, null],
111
+ "src/local/operation-authorization.mjs": [85, 45],
112
+ "src/local/operation-risk.mjs": [85, 60],
113
+ "src/local/fixed-process-environment.mjs": [100, 80],
114
+ "src/local/git-config-safety.mjs": [100, 75],
115
+ "src/local/git-metadata-boundary.mjs": [100, 70],
116
+ "src/local/git-metadata-tree-safety.mjs": [100, 70],
117
+ "src/local/git-operation-state.mjs": [100, 80],
118
+ "src/local/git-commit.mjs": [100, 75],
119
+ "src/local/git-log-parser.mjs": [100, 80],
120
+ "src/local/git-service.mjs": [90, 65],
121
+ "src/local/support-state-projection.mjs": [100, 75],
122
+ "src/local/security-audit-log.mjs": [85, 55],
123
+ "src/local/security-audit-dispatch.mjs": [100, 70],
124
+ "src/local/security-audit-warning.mjs": [100, 75],
125
+ "src/local/security-audit-storage.mjs": [85, 60],
126
+ "src/local/security-audit-state.mjs": [90, 65],
127
+ "src/local/delegated-process-sandbox.mjs": [80, 45],
128
+ "src/shared/device-session-auth.mjs": [100, null],
129
+ "src/shared/mcp-protocol.mjs": [90, 70],
130
+ "src/shared/tool-argument-validation.mjs": [90, 70],
131
+ "src/shared/tool-call-capacity.mjs": [100, 75],
132
+ "src/shared/project-overview-projection.mjs": [100, 90],
133
+ "src/shared/activation-recovery.mjs": [100, 85],
53
134
  "src/local/policy.mjs": [90, 65],
54
135
  "src/local/errors.mjs": [70, 50],
55
136
  "src/local/call-registry.mjs": [85, 55],
137
+ "src/local/call-capacity.mjs": [100, 70],
138
+ "src/local/call-registry-drain.mjs": [100, 70],
139
+ "src/local/process-tree-signal.mjs": [90, 55],
140
+ "src/local/process-tree-supervisor.mjs": [100, 70],
141
+ "src/local/process-tree-snapshot.mjs": [90, 65],
142
+ "src/local/relay-heartbeat.mjs": [90, 65],
56
143
  "src/local/tool-executor.mjs": [90, 40],
144
+ "src/local/tool-result-boundary.mjs": [100, 75],
145
+ "src/local/process-nonreplayable-settlement.mjs": [100, 80],
146
+ "src/local/computer-use.mjs": [85, 60],
147
+ "src/local/computer-use-observation.mjs": [90, 65],
148
+ "src/local/computer-use-application-observation.mjs": [90, 65],
149
+ "src/local/computer-use-recovery.mjs": [100, 75],
150
+ "src/local/computer-use-snapshot-store.mjs": [100, 80],
151
+ "src/local/computer-use-result-budget.mjs": [100, 75],
152
+ "src/local/browser-computer-observation-service.mjs": [90, 65],
153
+ "src/local/macos-background-input.mjs": [90, 60],
57
154
  "src/local/observability.mjs": [95, 40],
58
155
  "src/local/process-tracker.mjs": [65, 35],
156
+ "src/local/process-session-termination.mjs": [100, 70],
157
+ "src/local/file-mutation-coordinator.mjs": [100, 65],
158
+ "src/local/file-snapshot-preservation.mjs": [100, 75],
159
+ "src/local/directory-metadata.mjs": [100, 80],
160
+ "src/local/workspace-search.mjs": [100, 75],
161
+ "src/local/filesystem-identity.mjs": [100, 85],
162
+ "src/local/workspace-file-transaction.mjs": [90, 65],
59
163
  "src/local/log.mjs": [60, 40],
60
164
  "src/local/runtime.mjs": [75, 55],
61
165
  "src/local/runtime-paths.mjs": [90, 50],
166
+ "src/local/resource-operations.mjs": [80, 50],
167
+ "src/local/resource-admission.mjs": [95, 40],
168
+ "src/local/resource-admission-policy.mjs": [100, 65],
169
+ "src/local/resource-waiters.mjs": [95, 45],
170
+ "src/local/resource-cargo-concurrency.mjs": [100, 75],
171
+ "src/local/resource-cmake-concurrency.mjs": [100, 75],
172
+ "src/local/resource-go-concurrency.mjs": [100, 75],
173
+ "src/local/resource-gradle-concurrency.mjs": [100, 75],
174
+ "src/local/resource-swift-concurrency.mjs": [100, 75],
175
+ "src/local/resource-xcode-concurrency.mjs": [100, 75],
176
+ "src/local/resource-xcode-command.mjs": [100, 75],
177
+ "src/local/resource-xcode-non-build.mjs": [100, 75],
178
+ "src/local/resource-make-concurrency.mjs": [100, 75],
179
+ "src/local/resource-ninja-command-concurrency.mjs": [100, 75],
180
+ "src/local/resource-ninja-concurrency.mjs": [100, 75],
181
+ "src/local/resource-command-profile.mjs": [100, 55],
182
+ "src/local/resource-foreground-wait.mjs": [100, 75],
183
+ "src/local/npm-cli.mjs": [100, 70],
184
+ "src/local/resource-light-command.mjs": [100, null],
185
+ "src/local/resource-release-control-classification.mjs": [100, 75],
186
+ "src/local/resource-release-control-executable.mjs": [100, 70],
187
+ "src/local/resource-release-control-workspace.mjs": [100, 70],
188
+ "src/local/resource-command-concurrency.mjs": [100, 70],
189
+ "src/local/resource-maven-concurrency.mjs": [100, 75],
190
+ "src/local/resource-pytest-concurrency.mjs": [100, 75],
191
+ "src/local/resource-elastic-memory.mjs": [100, 75],
192
+ "src/local/resource-elastic-request.mjs": [100, 70],
193
+ "src/local/resource-script-classification.mjs": [100, 50],
194
+ "src/local/resource-shell-analysis.mjs": [95, 60],
195
+ "src/local/resource-host-cache.mjs": [100, 70],
196
+ "src/local/resource-host-darwin.mjs": [100, 65],
197
+ "src/local/resource-host-linux.mjs": [100, 85],
198
+ "src/local/resource-host-snapshot.mjs": [100, null],
199
+ "src/local/resource-lease-accounting.mjs": [95, 65],
200
+ "src/local/resource-coordinator-accounting.mjs": [100, null],
201
+ "src/local/resource-probe-command.mjs": [100, 40],
202
+ "src/local/resource-process-ancestry.mjs": [100, 45],
203
+ "src/local/resource-process-ancestry-cache.mjs": [100, 70],
204
+ "src/local/resource-process-priority.mjs": [100, 60],
205
+ "src/local/resource-project-key.mjs": [100, 45],
206
+ "src/local/resource-wait.mjs": [100, 75],
207
+ "src/local/resource-staging-recovery.mjs": [100, 55],
208
+ "src/local/resource-build-root.mjs": [90, 65],
209
+ "src/local/resource-process-admission.mjs": [100, 35],
210
+ "src/local/resource-request-contract.mjs": [100, 70],
211
+ "src/local/secure-file.mjs": [90, 65],
212
+ "src/local/ssh-key.mjs": [90, 65],
213
+ "src/local/service-definition.mjs": [100, 75],
214
+ "src/local/account-admin.mjs": [90, 60],
215
+ "src/local/account-admin-response.mjs": [100, 75],
62
216
  "src/local/cli.mjs": [48, 21.9],
63
- "src/local/cli-service.mjs": [90, 65],
217
+ "src/local/cli-service.mjs": [100, 75],
218
+ "src/local/service-convergence.mjs": [100, 75],
219
+ "src/local/service-status.mjs": [100, 75],
220
+ "src/local/service-ownership.mjs": [100, 75],
221
+ "src/local/service-restart-scheduler.mjs": [100, 70],
222
+ "src/local/service-restart-handoff.mjs": [100, 60],
223
+ "src/local/service-owner.mjs": [100, 85],
224
+ "src/local/service-runtime.mjs": [100, 80],
225
+ "src/local/service-runtime-convergence.mjs": [100, 80],
226
+ "src/local/windows-service-convergence.mjs": [100, 95],
227
+ "src/local/runtime-activation.mjs": [90, 70],
228
+ "scripts/release-publication-guard.mjs": [100, 80],
229
+ "scripts/verification-generation-guard.mjs": [100, 80],
230
+ "scripts/verification-state.mjs": [90, 70],
231
+ "src/local/child-process-settlement.mjs": [100, 85],
64
232
  "src/local/cli-options.mjs": [65, 35],
65
233
  "src/local/cli-policy.mjs": [70, 35],
66
234
  "src/local/numbers.mjs": [100, 100],
@@ -70,33 +238,89 @@ try {
70
238
  "src/local/network-proxy.mjs": [90, 65],
71
239
  "src/local/worker-health.mjs": [85, 60],
72
240
  "src/local/worker-deployment.mjs": [80, 55],
241
+ "src/local/hardened-npm-download.mjs": [90, 70],
242
+ "src/local/hardened-npm-download-timeout.mjs": [100, 85],
73
243
  "src/local/agent-contract.mjs": [95, 40],
74
244
  "src/local/agent-context-projection.mjs": [95, 60],
75
245
  "src/local/agent-skill-discovery.mjs": [85, 60],
76
246
  "src/local/agent-text-file.mjs": [90, 60],
77
247
  "src/local/capability-ranking.mjs": [95, 70],
248
+ "src/local/application-capability-projection.mjs": [100, 100],
249
+ "src/local/execution-routing.mjs": [95, 70],
78
250
  "src/local/browser-extension-protocol.mjs": [95, 35],
79
251
  "src/local/browser-operation-service.mjs": [80, 50],
252
+ "src/local/owner-state-lock.mjs": [90, 55],
253
+ "src/local/exclusive-file.mjs": [90, 60],
254
+ "src/local/worker-secret-file.mjs": [90, 65],
80
255
  "src/local/runtime-reporting.mjs": [95, 75],
256
+ "src/local/runtime-info-projection.mjs": [100, 70],
81
257
  "src/local/runtime-diagnostics.mjs": [75, 65],
258
+ "src/local/system-network-route.mjs": [90, 75],
259
+ "src/local/systemd-removal.mjs": [100, 80],
82
260
  "src/local/runtime-capabilities.mjs": [75, 45],
83
261
  "src/local/monotonic-deadline.mjs": [100, 100],
262
+ "src/local/path-inspection.mjs": [100, 60],
84
263
  "src/local/state.mjs": [85, 45],
264
+ "src/local/state-root-retirement.mjs": [90, 70],
85
265
  "src/local/relay-connection.mjs": [90, 55],
266
+ "src/local/relay-connection-classification.mjs": [90, 60],
86
267
  "src/local/managed-jobs.mjs": [85, 50],
268
+ "src/local/managed-job-capacity.mjs": [100, 75],
269
+ "src/local/managed-job-directory-generation.mjs": [90, 70],
270
+ "src/local/managed-job-retention.mjs": [90, 70],
271
+ "src/local/managed-job-terminal-maintenance.mjs": [90, 70],
87
272
  "src/local/managed-job-projection.mjs": [90, 60],
88
273
  "src/local/managed-job-storage.mjs": [75, 50],
274
+ "src/local/managed-job-runner-claim.mjs": [90, 60],
89
275
  "src/local/managed-job-runner.mjs": [80, 50],
276
+ "src/local/browser-broker-auth.mjs": [95, 80],
277
+ "src/local/browser-pairing-grant.mjs": [95, 75],
278
+ "src/local/browser-pairing-launch.mjs": [90, 70],
279
+ "src/local/browser-broker-auth-http.mjs": [90, 70],
90
280
  "src/local/browser-bridge.mjs": [80, 55],
281
+ "src/local/browser-request-settlement.mjs": [100, 75],
91
282
  "src/local/browser-request-registry.mjs": [95, 35],
92
283
  "src/local/browser-broker-routes.mjs": [85, 55],
93
284
  "src/local/browser-broker-server.mjs": [80, 50],
94
- "src/worker/oauth-controller.ts": [85, 65],
285
+ "src/worker/account-admin.ts": [70, 35],
286
+ "src/worker/tool-timeout.ts": [95, 85],
287
+ "src/worker/daemon-ready-waiters.ts": [100, 70],
288
+ "src/worker/daemon-ready-dispatch.ts": [100, 80],
289
+ "src/worker/daemon-recovery-budget.ts": [100, 75],
290
+ "src/worker/tool-catalog.ts": [95, 80],
291
+ "src/worker/daemon-auth.ts": [85, 45],
292
+ "src/worker/dpop.ts": [90, 30],
293
+ "src/worker/nonce-store.ts": [85, 50],
294
+ "src/worker/oauth-client-admin.ts": [75, 45],
295
+ "src/worker/oauth-refresh-families.ts": [70, 35],
296
+ "src/worker/oauth-store-validation.ts": [90, 70],
297
+ "src/worker/oauth-tokens.ts": [70, 35],
298
+ "src/worker/oauth-controller.ts": [84, 65],
95
299
  "src/worker/oauth-authorization-page.ts": [90, 60],
96
300
  "src/worker/pending-calls.ts": [90, 35],
301
+ "src/worker/pending-call-capacity.ts": [100, 70],
97
302
  "src/worker/policy.ts": [100, 25],
98
303
  "src/worker/errors.ts": [100, 40],
99
304
  "src/worker/mcp-jsonrpc.ts": [95, 55],
305
+ "src/worker/mcp-tool-call-input.ts": [100, 75],
306
+ "src/worker/mcp-http-contract.ts": [90, 70],
307
+ "src/worker/mcp-controller.ts": [90, 70],
308
+ "src/worker/mcp-removed-protocol.ts": [100, 75],
309
+ "src/worker/mcp-response-proxy.ts": [90, 70],
310
+ "src/worker/mcp-response-stream.ts": [100, null],
311
+ "src/worker/mcp-http-accept.ts": [100, 75],
312
+ "src/worker/mcp-stream-proxy-contract.ts": [100, 75],
313
+ "src/worker/worker-mcp-config.ts": [100, 75],
314
+ "src/worker/runtime-alarm.ts": [95, 65],
315
+ "src/worker/worker-static-routes.ts": [100, 90],
316
+ "src/worker/worker-metadata.ts": [100, null],
317
+ "src/worker/worker-edge-guard.ts": [100, 55],
318
+ "src/worker/worker-edge-log.ts": [100, 80],
319
+ "src/worker/oauth-token-issuance.ts": [100, 80],
320
+ "src/worker/oauth-token-derivation.ts": [100, 75],
321
+ "src/worker/oauth-refresh-exchange.ts": [95, 60],
322
+ "src/worker/server-info.ts": [95, 65],
323
+ "src/worker/daemon-status.ts": [100, 70],
100
324
  "src/worker/websocket-protocol.ts": [100, 50],
101
325
  };
102
326
  const failures = [];
@@ -128,30 +352,42 @@ function collectCoverage(directory) {
128
352
  const repositoryRelative = relative(root, absolute);
129
353
  if (!repositoryRelative || repositoryRelative === ".." || repositoryRelative.startsWith(`..${sep}`) || isAbsolute(repositoryRelative)) continue;
130
354
  const file = repositoryRelative.split(sep).join("/");
131
- if (!file.startsWith("src/")) continue;
355
+ if (!file.startsWith("src/") && !CRITICAL_SCRIPT_FILES.has(file)) continue;
132
356
  let entry = scripts.get(file);
133
357
  if (!entry) {
134
- entry = { functions: new Map(), blocks: new Map() };
358
+ entry = { functions: new Map() };
135
359
  scripts.set(file, entry);
136
360
  }
137
361
  for (const fn of script.functions || []) {
138
362
  if (!fn.ranges?.length) continue;
139
363
  const outer = fn.ranges[0];
140
364
  const functionKey = `${outer.startOffset}:${outer.endOffset}:${fn.functionName}`;
141
- entry.functions.set(functionKey, (entry.functions.get(functionKey) || false) || outer.count > 0);
142
- for (const range of fn.ranges.slice(1)) {
143
- const blockKey = `${range.startOffset}:${range.endOffset}`;
144
- entry.blocks.set(blockKey, (entry.blocks.get(blockKey) || false) || range.count > 0);
365
+ let functionEntry = entry.functions.get(functionKey);
366
+ if (!functionEntry) {
367
+ functionEntry = { executions: [] };
368
+ entry.functions.set(functionKey, functionEntry);
145
369
  }
370
+ functionEntry.executions.push(fn.ranges);
146
371
  }
147
372
  }
148
373
  }
149
- return new Map([...scripts].map(([file, entry]) => [file, {
150
- functionsTotal: entry.functions.size,
151
- functionsCovered: [...entry.functions.values()].filter(Boolean).length,
152
- blocksTotal: entry.blocks.size,
153
- blocksCovered: [...entry.blocks.values()].filter(Boolean).length,
154
- }]));
374
+ return new Map([...scripts].map(([file, entry]) => {
375
+ const blocks = new Map();
376
+ let functionsCovered = 0;
377
+ for (const functionEntry of entry.functions.values()) {
378
+ const merged = mergeFunctionExecutions(functionEntry.executions);
379
+ if (merged.functionCovered) functionsCovered += 1;
380
+ for (const [blockKey, covered] of merged.blocks) {
381
+ blocks.set(blockKey, (blocks.get(blockKey) || false) || covered);
382
+ }
383
+ }
384
+ return [file, {
385
+ functionsTotal: entry.functions.size,
386
+ functionsCovered,
387
+ blocksTotal: blocks.size,
388
+ blocksCovered: [...blocks.values()].filter(Boolean).length,
389
+ }];
390
+ }));
155
391
  }
156
392
 
157
393
  function percent(covered, total) {
@@ -0,0 +1,41 @@
1
+ import { createHash } from "node:crypto";
2
+ import { lstatSync, readlinkSync, readdirSync } from "node:fs";
3
+ import { join, relative } from "node:path";
4
+ import { readBoundedRegularFileWithInfoSync } from "../src/local/secure-file.mjs";
5
+
6
+ const DEFAULT_ROOTS = ["src", "scripts", "tests", "browser-extension", ".github/scripts"];
7
+ const DEFAULT_FILES = ["package.json", "package-lock.json", "tsconfig.json", "tsconfig.local.json", "wrangler.jsonc"];
8
+ const MAX_GENERATION_FILE_BYTES = 16 * 1024 * 1024;
9
+
10
+ export function captureCoverageGeneration(root, options = {}) {
11
+ const entries = [];
12
+ for (const name of options.roots || DEFAULT_ROOTS) collect(join(root, name), root, entries);
13
+ for (const name of options.files || DEFAULT_FILES) collect(join(root, name), root, entries);
14
+ entries.sort((left, right) => left.path.localeCompare(right.path));
15
+ const hash = createHash("sha256");
16
+ for (const entry of entries) {
17
+ hash.update(entry.path); hash.update("\0"); hash.update(String(entry.mode)); hash.update("\0");
18
+ hash.update(entry.content); hash.update("\0");
19
+ }
20
+ return hash.digest("hex");
21
+ }
22
+
23
+ function collect(path, root, entries) {
24
+ let info;
25
+ try { info = lstatSync(path); } catch (error) { if (error?.code === "ENOENT") return; throw error; }
26
+ const name = relative(root, path).split("\\").join("/");
27
+ const mode = Number(info.mode) & 0o777;
28
+ if (info.isSymbolicLink()) {
29
+ entries.push({ path: name, mode, content: Buffer.from(`link:${readlinkSync(path)}`) });
30
+ return;
31
+ }
32
+ if (info.isFile()) {
33
+ const snapshot = readBoundedRegularFileWithInfoSync(path, MAX_GENERATION_FILE_BYTES, `verification input ${name}`, {
34
+ verifyPathIdentity: true,
35
+ });
36
+ entries.push({ path: name, mode: Number(snapshot.info.mode) & 0o777, content: snapshot.buffer });
37
+ return;
38
+ }
39
+ if (!info.isDirectory()) return;
40
+ for (const entry of readdirSync(path, { withFileTypes: true })) collect(join(path, entry.name), root, entries);
41
+ }
@@ -0,0 +1,41 @@
1
+ export function mergeFunctionExecutions(executions = []) {
2
+ const normalized = executions.map(normalizeExecution).filter((ranges) => ranges.length);
3
+ const functionCovered = normalized.some((ranges) => ranges[0].count > 0);
4
+ const candidates = new Map();
5
+ for (const ranges of normalized) {
6
+ for (const range of ranges.slice(1)) candidates.set(rangeKey(range), range);
7
+ }
8
+ return {
9
+ functionCovered,
10
+ blocks: new Map([...candidates].map(([key, range]) => [
11
+ key,
12
+ rangeCoveredAcrossExecutions(normalized, range.startOffset, range.endOffset),
13
+ ])),
14
+ };
15
+ }
16
+
17
+ export function rangeCoveredAcrossExecutions(executions, startOffset, endOffset) {
18
+ if (!(Number.isInteger(startOffset) && Number.isInteger(endOffset) && startOffset < endOffset)) return false;
19
+ return (executions || []).some((ranges) => effectiveRangeCount(ranges, startOffset, endOffset) > 0);
20
+ }
21
+
22
+ function effectiveRangeCount(ranges, startOffset, endOffset) {
23
+ let selected = null;
24
+ for (const range of ranges || []) {
25
+ if (range.startOffset > startOffset || range.endOffset < endOffset) continue;
26
+ if (!selected || range.endOffset - range.startOffset <= selected.endOffset - selected.startOffset) selected = range;
27
+ }
28
+ return selected ? selected.count : 0;
29
+ }
30
+
31
+ function normalizeExecution(ranges) {
32
+ return (ranges || []).map((range) => ({
33
+ startOffset: Number(range.startOffset),
34
+ endOffset: Number(range.endOffset),
35
+ count: Math.max(0, Number(range.count) || 0),
36
+ })).filter((range) => Number.isInteger(range.startOffset) && Number.isInteger(range.endOffset) && range.startOffset < range.endOffset);
37
+ }
38
+
39
+ function rangeKey(range) {
40
+ return `${range.startOffset}:${range.endOffset}`;
41
+ }
@@ -0,0 +1,88 @@
1
+ import { readFileSync, realpathSync, statSync } from "node:fs";
2
+ import path from "node:path";
3
+ import { inspectProcessInstance, processCommandLine, splitProcessCommandLine } from "../src/local/process-identity.mjs";
4
+ import {
5
+ daemonLockPathForState, loadState, readDaemonLockOwner, resolveWorkspace, selectedWorkspace,
6
+ } from "../src/local/state.mjs";
7
+
8
+ const FOREGROUND_PID = /foreground daemon is active \(pid (\d+)\)/i;
9
+
10
+ export function discoverForegroundDaemonRecovery({ output, stateRoot, workspace = "", dependencies = {} } = {}) {
11
+ const pid = foregroundPid(output);
12
+ if (!pid || typeof stateRoot !== "string" || !stateRoot) return null;
13
+ const selectWorkspace = dependencies.selectedWorkspace || selectedWorkspace;
14
+ const resolve = dependencies.resolveWorkspace || resolveWorkspace;
15
+ const load = dependencies.loadState || loadState;
16
+ const readOwner = dependencies.readDaemonOwner || readDaemonLockOwner;
17
+ const lockPath = dependencies.daemonLockPathForState || daemonLockPathForState;
18
+ const inspect = dependencies.inspectProcessInstance || inspectProcessInstance;
19
+ const readCommand = dependencies.processCommandLine || processCommandLine;
20
+ const splitCommand = dependencies.splitProcessCommandLine || splitProcessCommandLine;
21
+ const canonical = dependencies.realpathSync || realpathSync;
22
+ const fileInfo = dependencies.statSync || statSync;
23
+ const readFile = dependencies.readFileSync || readFileSync;
24
+ let targetWorkspace;
25
+ let canonicalStateRoot;
26
+ let state;
27
+ let owner;
28
+ try {
29
+ targetWorkspace = resolve(workspace || selectWorkspace(stateRoot));
30
+ canonicalStateRoot = canonical(path.resolve(stateRoot));
31
+ state = load(targetWorkspace, { stateDir: canonicalStateRoot });
32
+ owner = readOwner(lockPath(state));
33
+ } catch {
34
+ return null;
35
+ }
36
+ if (Number(owner?.pid) !== pid || owner?.mode !== "foreground" || owner?.purpose !== "daemon") return null;
37
+ if (inspect(owner)?.current !== true) return null;
38
+ if (!sameCanonical(owner.workspace, targetWorkspace, canonical)) return null;
39
+ let entry;
40
+ let argv;
41
+ try {
42
+ entry = canonical(String(owner.entryScript || ""));
43
+ if (!fileInfo(entry).isFile()) return null;
44
+ argv = splitCommand(readCommand(pid));
45
+ } catch {
46
+ return null;
47
+ }
48
+ const entryIndex = argv.findIndex(value => sameCanonical(value, entry, canonical));
49
+ if (entryIndex < 0 || argv[entryIndex + 1] !== "start" || argv.includes("--daemon-only")) return null;
50
+ const commandWorkspace = commandFlagValue(argv, "--workspace");
51
+ const commandStateRoot = commandFlagValue(argv, "--state-dir");
52
+ if (!sameCanonical(commandWorkspace, targetWorkspace, canonical)
53
+ || !sameCanonical(commandStateRoot, canonicalStateRoot, canonical)) return null;
54
+ const packageRoot = path.dirname(path.dirname(entry));
55
+ let pkg;
56
+ try {
57
+ pkg = JSON.parse(readFile(path.join(packageRoot, "package.json"), "utf8"));
58
+ } catch {
59
+ return null;
60
+ }
61
+ if (pkg?.name !== "machine-bridge-mcp" || pkg.version !== owner.version) return null;
62
+ if (!["machine-mcp", "machine-mcp.mjs"].includes(path.basename(entry))) return null;
63
+ return { pid, cli: entry, version: owner.version, workspace: targetWorkspace, stateRoot: canonicalStateRoot };
64
+ }
65
+
66
+ export function foregroundPid(output) {
67
+ const match = FOREGROUND_PID.exec(String(output || ""));
68
+ const pid = Number(match?.[1]);
69
+ return Number.isSafeInteger(pid) && pid > 0 ? pid : 0;
70
+ }
71
+
72
+ function commandFlagValue(argv, name) {
73
+ const exact = argv.find(value => value.startsWith(`${name}=`));
74
+ if (exact) return exact.slice(name.length + 1);
75
+ const index = argv.indexOf(name);
76
+ return index >= 0 && index + 1 < argv.length ? argv[index + 1] : "";
77
+ }
78
+
79
+ function sameCanonical(left, right, canonical) {
80
+ if (typeof left !== "string" || typeof right !== "string" || !left || !right) return false;
81
+ try {
82
+ const a = canonical(path.resolve(left));
83
+ const b = canonical(path.resolve(right));
84
+ return process.platform === "win32" ? a.toLowerCase() === b.toLowerCase() : a === b;
85
+ } catch {
86
+ return false;
87
+ }
88
+ }
@@ -4,9 +4,10 @@ import { normalizeLineEndings } from "./markdown.mjs";
4
4
 
5
5
  const root = new URL("../", import.meta.url);
6
6
  const contract = JSON.parse(await readFile(new URL("src/shared/policy-contract.json", root), "utf8"));
7
+ const access = JSON.parse(await readFile(new URL("src/shared/access-contract.json", root), "utf8"));
7
8
  const catalog = JSON.parse(await readFile(new URL("src/shared/tool-catalog.json", root), "utf8"));
8
9
  const target = new URL("docs/POLICY_REFERENCE.md", root);
9
- const generated = render(contract, catalog);
10
+ const generated = render(contract, catalog, access);
10
11
 
11
12
  if (process.argv.includes("--check")) {
12
13
  const current = await readFile(target, "utf8").catch(() => "");
@@ -21,12 +22,14 @@ if (process.argv.includes("--check")) {
21
22
  console.log("generated docs/POLICY_REFERENCE.md");
22
23
  }
23
24
 
24
- function render(value, tools) {
25
+ function render(value, tools, access) {
25
26
  const profileNames = Object.keys(value.profiles);
27
+ const roleNames = Object.keys(access.roles);
28
+ const ownerOnlyTools = new Set(access.ownerOnlyTools);
26
29
  const lines = [
27
30
  "# Policy reference",
28
31
  "",
29
- "> Generated from `src/shared/policy-contract.json` and `src/shared/tool-catalog.json`. Do not edit this file manually.",
32
+ "> Generated from `src/shared/policy-contract.json`, `src/shared/access-contract.json`, and `src/shared/tool-catalog.json`. Do not edit this file manually.",
30
33
  "",
31
34
  `Policy revision: **${value.revision}**. Default profile: **${value.defaultProfile}**.`,
32
35
  "",
@@ -48,12 +51,32 @@ function render(value, tools) {
48
51
  for (const [name, requirement] of Object.entries(value.availability)) {
49
52
  lines.push(`| \`${name}\` | ${requirementText(requirement)} |`);
50
53
  }
51
- lines.push("", "## Tool access", "", `| Tool | Availability | ${profileNames.join(" | ")} |`, `|---|---|${profileNames.map(() => "---").join("|")}|`);
52
- for (const tool of [...tools].sort((left, right) => left.name.localeCompare(right.name))) {
54
+ const sortedTools = [...tools].sort((left, right) => left.name.localeCompare(right.name));
55
+ lines.push("", "## Local policy tool access", "", "This table describes the local daemon policy ceiling. Remote account roles apply an additional authorization overlay shown below.", "", `| Tool | Availability | ${profileNames.join(" | ")} |`, `|---|---|${profileNames.map(() => "---").join("|")}|`);
56
+ for (const tool of sortedTools) {
53
57
  const cells = profileNames.map((name) => allows(value.profiles[name], value.availability[tool.availability]) ? "yes" : "no");
54
58
  lines.push(`| \`${tool.name}\` | \`${tool.availability}\` | ${cells.join(" | ")} |`);
55
59
  }
56
60
  lines.push(
61
+ "",
62
+ "## Remote account-role tool access",
63
+ "",
64
+ `Account-access revision: **${access.revision}**. Default role: **${access.defaultRole}**. Remote effective authority is the intersection of this account-role ceiling with the connected daemon policy/tool ceiling; the MCP host may expose a further subset.`,
65
+ "",
66
+ `| Tool | ${roleNames.join(" | ")} |`,
67
+ `|---|${roleNames.map(() => "---").join("|")}|`,
68
+ );
69
+ for (const tool of sortedTools) {
70
+ const cells = roleNames.map((role) => {
71
+ const profile = value.profiles[access.roles[role].profile];
72
+ const locallyAllowed = allows(profile, value.availability[tool.availability]);
73
+ return locallyAllowed && (!ownerOnlyTools.has(tool.name) || role === access.ownerRole) ? "yes" : "no";
74
+ });
75
+ lines.push(`| \`${tool.name}\` | ${cells.join(" | ")} |`);
76
+ }
77
+ lines.push(
78
+ "",
79
+ `Owner-only remote tools: ${[...ownerOnlyTools].sort().map((name) => `\`${name}\``).join(", ")}. Their local availability class is unchanged; the extra restriction applies only to authenticated remote account roles.`,
57
80
  "",
58
81
  "## Enforcement contract",
59
82
  "",
@@ -27,7 +27,7 @@ function renderToolReference(tools) {
27
27
  "",
28
28
  "> Generated from `src/shared/tool-catalog.json`. Do not edit this file manually.",
29
29
  "",
30
- "This catalog is the authoritative public tool contract for names, availability classes, behavior annotations, and JSON input schemas. Runtime authorization is additionally determined by the active policy described in [POLICY_REFERENCE.md](POLICY_REFERENCE.md).",
30
+ "This catalog is the authoritative public tool contract for names, local-daemon availability classes, behavior annotations, and JSON input schemas. An availability value describes the daemon policy ceiling, not authenticated remote-account entitlement. Remote account-role ceilings (including owner-only tools) and the effective-authority intersection are generated in [POLICY_REFERENCE.md](POLICY_REFERENCE.md).",
31
31
  "",
32
32
  `Tool count: **${tools.length}**.`,
33
33
  "",