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
@@ -1,7 +1,8 @@
1
1
  import { spawn } from "node:child_process";
2
- import { existsSync } from "node:fs";
2
+ import { existsSync, lstatSync, realpathSync } from "node:fs";
3
3
  import path from "node:path";
4
- import { packageRoot } from "./state.mjs";
4
+ import { packageRoot } from "./package-identity.mjs";
5
+ import { ensureWranglerToolchain } from "./wrangler-toolchain.mjs";
5
6
  import { BoundedOutput } from "./bounded-output.mjs";
6
7
  import { terminateProcessTreeWithEscalation } from "./process-tree.mjs";
7
8
 
@@ -11,7 +12,8 @@ export function runExecutable(command, args = [], options = {}) {
11
12
  return new Promise((resolve, reject) => {
12
13
  const capture = Boolean(options.capture);
13
14
  const maxOutputBytes = Number.isFinite(Number(options.maxOutputBytes)) ? Math.max(1024, Number(options.maxOutputBytes)) : 2 * 1024 * 1024;
14
- const child = spawn(executable, argv, {
15
+ const spawnProcess = typeof options.spawnProcess === "function" ? options.spawnProcess : spawn;
16
+ const child = spawnProcess(executable, argv, {
15
17
  cwd: options.cwd || process.cwd(),
16
18
  env: options.env || process.env,
17
19
  stdio: capture ? ["ignore", "pipe", "pipe"] : "inherit",
@@ -22,7 +24,7 @@ export function runExecutable(command, args = [], options = {}) {
22
24
  const stdout = new BoundedOutput(maxOutputBytes);
23
25
  const stderr = new BoundedOutput(maxOutputBytes);
24
26
  let settled = false;
25
- let timedOut = false;
27
+ let timedOut = false; let childError = null;
26
28
  let timer = null;
27
29
  let killTimer = null;
28
30
  const timeoutMs = Number(options.timeoutMs);
@@ -44,17 +46,12 @@ export function runExecutable(command, args = [], options = {}) {
44
46
  child.stdout?.on("data", chunk => stdout.append(chunk));
45
47
  child.stderr?.on("data", chunk => stderr.append(chunk));
46
48
  }
47
- child.on("error", error => finish(() => {
48
- const result = capturedResult(127, stdout, stderr, error.message);
49
- if (options.allowFailure) resolve(result);
50
- else reject(error);
51
- }));
49
+ child.on("error", error => { childError ||= error; });
52
50
  child.on("close", code => finish(() => {
53
- const timeoutMessage = timedOut ? `command timed out after ${timeoutMs}ms` : "";
54
- const result = {
55
- ...capturedResult(timedOut ? 124 : code, stdout, stderr, timeoutMessage),
56
- };
57
- if ((!timedOut && code === 0) || options.allowFailure) resolve(result);
51
+ const failureMessage = timedOut ? `command timed out after ${timeoutMs}ms` : childError?.message || "";
52
+ const result = { ...capturedResult(timedOut ? 124 : childError ? 127 : code, stdout, stderr, failureMessage) };
53
+ if ((!timedOut && !childError && code === 0) || options.allowFailure) resolve(result);
54
+ else if (childError && !timedOut) reject(childError);
58
55
  else {
59
56
  const error = new Error((result.stderr || result.stdout || `${executable} exited ${result.code}`).trim());
60
57
  error.result = result;
@@ -97,18 +94,41 @@ function capturedResult(code, stdout, stderr, extraStderr = "") {
97
94
  }
98
95
 
99
96
  export function wranglerCommand(options = {}) {
100
- const root = path.resolve(String(options.packageRoot || packageRoot));
97
+ const root = realpathSync(path.resolve(String(options.packageRoot || packageRoot)));
101
98
  const node = path.resolve(String(options.node || process.execPath));
102
99
  const script = path.join(root, "node_modules", "wrangler", "bin", "wrangler.js");
103
- if (!existsSync(script)) throw new Error(`Wrangler JavaScript entrypoint is missing: ${script}`);
104
- return { cmd: node, argsPrefix: [script] };
100
+ let info;
101
+ try { info = lstatSync(script); }
102
+ catch (error) {
103
+ if (error?.code === "ENOENT") throw new Error(`Wrangler JavaScript entrypoint is missing: ${script}`, { cause: error });
104
+ throw error;
105
+ }
106
+ if (info.isSymbolicLink() || !info.isFile() || Number(info.nlink) !== 1 || (process.platform !== "win32" && (Number(info.mode) & 0o022) !== 0)) {
107
+ throw new Error("Wrangler JavaScript entrypoint must be a private real regular file");
108
+ }
109
+ const canonical = realpathSync(script);
110
+ const relative = path.relative(root, canonical);
111
+ if (!relative || relative === ".." || relative.startsWith(`..${path.sep}`) || path.isAbsolute(relative)) {
112
+ throw new Error("Wrangler JavaScript entrypoint escapes the private toolchain root");
113
+ }
114
+ return { cmd: node, argsPrefix: [canonical] };
105
115
  }
106
116
 
107
117
  export async function runWrangler(args, options = {}) {
108
- const wrangler = wranglerCommand();
118
+ const toolchainRoot = await ensureWranglerToolchain({
119
+ stateRoot: options.stateRoot,
120
+ packageRoot: options.packageRoot || packageRoot,
121
+ npmCli: options.npmCli,
122
+ env: options.env || process.env,
123
+ runCommand: options.runCommand || runExecutable,
124
+ auditMaxAgeMs: options.auditMaxAgeMs,
125
+ hardenedNpm: options.hardenedNpm,
126
+ });
127
+ const wrangler = wranglerCommand({ packageRoot: toolchainRoot, node: options.node });
109
128
  const operation = String(args[0] || "");
110
129
  const timeoutMs = options.timeoutMs ?? (operation === "login" || operation === "deploy" ? 10 * 60 * 1000 : 2 * 60 * 1000);
111
- return runExecutable(wrangler.cmd, [...wrangler.argsPrefix, ...args], { cwd: packageRoot, timeoutMs, ...options });
130
+ const { stateRoot: _stateRoot, packageRoot: _packageRoot, npmCli: _npmCli, runCommand: _runCommand, auditMaxAgeMs: _auditMaxAgeMs, hardenedNpm: _hardenedNpm, node: _node, ...executionOptions } = options;
131
+ return runExecutable(wrangler.cmd, [...wrangler.argsPrefix, ...args], { cwd: packageRoot, timeoutMs, ...executionOptions });
112
132
  }
113
133
 
114
134
  export function workspaceShellCommand(command) {
@@ -1,12 +1,14 @@
1
- import { constants as fsConstants } from "node:fs";
2
- import { chmod, copyFile, link, mkdir, mkdtemp, rm, unlink, writeFile } from "node:fs/promises";
1
+ import { closeSync, constants as fsConstants, fstatSync, lstatSync, unlinkSync } from "node:fs";
2
+ import { chmod, link, mkdir, mkdtemp, rm, writeFile } from "node:fs/promises";
3
3
  import { basename, dirname, join, resolve } from "node:path";
4
4
  import { randomBytes, timingSafeEqual } from "node:crypto";
5
5
  import { tmpdir } from "node:os";
6
6
  import { runExecutable } from "./shell.mjs";
7
- import { chmodRegularFileSync, readBoundedRegularFileWithInfoSync } from "./secure-file.mjs";
7
+ import { chmodRegularFileIfIdentitySync, openRegularFileSync, readBoundedRegularFileWithInfoSync, unlinkRegularFileIfIdentitySync } from "./secure-file.mjs";
8
+ import { filesystemIdentity, sameFilesystemIdentity } from "./filesystem-identity.mjs";
8
9
 
9
10
  const KEY_TYPES = new Set(["ed25519", "rsa"]);
11
+ const GENERATED_KEY_IDENTITIES = Symbol("generated-key-identities");
10
12
 
11
13
  export async function generateSshKeyPair(options = {}) {
12
14
  const request = normalizeKeyRequest(options);
@@ -15,12 +17,12 @@ export async function generateSshKeyPair(options = {}) {
15
17
 
16
18
  const existing = await inspectExistingKeyFiles(request.privateKeyPath, request.publicKeyPath);
17
19
  if (existing) {
18
- await secureKeyModes(request.privateKeyPath, request.publicKeyPath);
20
+ const inspected = await inspectSshKeyPair(request.privateKeyPath, request.publicKeyPath, false);
21
+ await secureKeyModes(request.privateKeyPath, request.publicKeyPath, keyIdentities(inspected));
19
22
  return inspectSshKeyPair(request.privateKeyPath, request.publicKeyPath, false);
20
23
  }
21
- return createSshKeyPair(request);
24
+ return createSshKeyPair(request, options);
22
25
  }
23
-
24
26
  function normalizeKeyRequest(options) {
25
27
  const privateKeyPath = resolve(String(options.privateKeyPath || ""));
26
28
  if (!privateKeyPath || privateKeyPath === resolve(".")) throw new Error("private key path is required");
@@ -31,11 +33,10 @@ function normalizeKeyRequest(options) {
31
33
  publicKeyPath: `${privateKeyPath}.pub`,
32
34
  parent: dirname(privateKeyPath),
33
35
  type,
34
- bits: options.bits,
36
+ bits: type === "rsa" ? normalizeRsaBits(options.bits) : null,
35
37
  comment: boundedComment(options.comment || `machine-mcp:${basename(privateKeyPath)}`),
36
38
  };
37
39
  }
38
-
39
40
  async function inspectExistingKeyFiles(privateKeyPath, publicKeyPath) {
40
41
  const privateSnapshot = tryReadKeySnapshot(privateKeyPath, 1024 * 1024, "SSH private key");
41
42
  const publicSnapshot = tryReadKeySnapshot(publicKeyPath, 64 * 1024, "SSH public key");
@@ -43,33 +44,57 @@ async function inspectExistingKeyFiles(privateKeyPath, publicKeyPath) {
43
44
  if (!privateSnapshot || !publicSnapshot) throw new Error("SSH key pair is incomplete or not a pair of regular files");
44
45
  return true;
45
46
  }
46
-
47
- async function createSshKeyPair(request) {
47
+ async function createSshKeyPair(request, options = {}) {
48
+ const install = typeof options.installNoReplace === "function"
49
+ ? options.installNoReplace
50
+ : (source, target) => installNoReplace(source, target, options.installOptions);
48
51
  const suffix = `${process.pid}-${randomBytes(8).toString("hex")}`;
49
52
  const tempPrivate = resolve(request.parent, `.${basename(request.privateKeyPath)}.mbm-${suffix}`);
50
53
  const tempPublic = `${tempPrivate}.pub`;
54
+ const tempIdentities = {};
55
+ let primaryError = null;
56
+ let result;
51
57
  try {
52
58
  const args = ["-q", "-t", request.type];
53
- if (request.type === "rsa") args.push("-b", String(normalizeRsaBits(request.bits)));
59
+ if (request.type === "rsa") args.push("-b", String(request.bits));
54
60
  args.push("-N", "", "-f", tempPrivate, "-C", request.comment);
55
61
  const generated = await runExecutable("ssh-keygen", args, { capture: true, timeoutMs: 30_000, maxOutputBytes: 64 * 1024 });
56
62
  if (generated.code !== 0) throw new Error("ssh-keygen failed");
57
- await secureKeyModes(tempPrivate, tempPublic);
58
- await installNoReplace(tempPrivate, request.privateKeyPath);
63
+ tempIdentities.private = keyPathIdentity(tempPrivate, "generated temporary SSH private key");
64
+ tempIdentities.public = keyPathIdentity(tempPublic, "generated temporary SSH public key");
65
+ await secureKeyModes(tempPrivate, tempPublic, tempIdentities);
66
+ await install(tempPrivate, request.privateKeyPath);
67
+ const installedPrivateIdentity = keyPathIdentity(request.privateKeyPath, "generated SSH private key");
59
68
  try {
60
- await installNoReplace(tempPublic, request.publicKeyPath);
69
+ await install(tempPublic, request.publicKeyPath);
61
70
  } catch (error) {
62
- await rm(request.privateKeyPath, { force: true });
71
+ try {
72
+ removeKeyPathIfCurrent(request.privateKeyPath, installedPrivateIdentity, "generated SSH private key");
73
+ } catch (cleanupError) {
74
+ throw new AggregateError([error, cleanupError], "SSH key pair installation failed and private-key rollback was incomplete");
75
+ }
63
76
  throw error;
64
77
  }
65
- await secureKeyModes(request.privateKeyPath, request.publicKeyPath);
66
- return inspectSshKeyPair(request.privateKeyPath, request.publicKeyPath, true);
67
- } finally {
68
- await rm(tempPrivate, { force: true });
69
- await rm(tempPublic, { force: true });
78
+ const installedIdentities = {
79
+ private: installedPrivateIdentity,
80
+ public: keyPathIdentity(request.publicKeyPath, "generated SSH public key"),
81
+ };
82
+ await secureKeyModes(request.privateKeyPath, request.publicKeyPath, installedIdentities);
83
+ result = await inspectSshKeyPair(request.privateKeyPath, request.publicKeyPath, true);
84
+ } catch (error) {
85
+ primaryError = error;
86
+ }
87
+ const cleanupErrors = [];
88
+ for (const [filePath, identity] of [[tempPrivate, tempIdentities.private], [tempPublic, tempIdentities.public]]) {
89
+ if (!identity) continue;
90
+ try { unlinkKnownLinkIfCurrent(filePath, identity); } catch (error) { cleanupErrors.push(error); }
70
91
  }
92
+ if (cleanupErrors.length) {
93
+ throw new AggregateError(primaryError ? [primaryError, ...cleanupErrors] : cleanupErrors, "SSH key staging cleanup was incomplete");
94
+ }
95
+ if (primaryError) throw primaryError;
96
+ return result;
71
97
  }
72
-
73
98
  export async function inspectSshKeyPair(privateKeyPath, publicKeyPath = `${privateKeyPath}.pub`, created = false) {
74
99
  const privateSnapshot = readKeySnapshot(privateKeyPath, 1024 * 1024, "SSH private key");
75
100
  const publicSnapshot = readKeySnapshot(publicKeyPath, 64 * 1024, "SSH public key");
@@ -100,7 +125,7 @@ export async function inspectSshKeyPair(privateKeyPath, publicKeyPath = `${priva
100
125
  if (!/^SHA256:[A-Za-z0-9+/=]+$/.test(fingerprintValue)) throw new Error("SSH key fingerprint output is invalid");
101
126
  assertKeySnapshotCurrent(privateKeyPath, privateSnapshot, 1024 * 1024, "SSH private key");
102
127
  assertKeySnapshotCurrent(publicKeyPath, publicSnapshot, 64 * 1024, "SSH public key");
103
- return {
128
+ const result = {
104
129
  created,
105
130
  privateKeyPath: resolve(privateKeyPath),
106
131
  publicKeyPath: resolve(publicKeyPath),
@@ -109,32 +134,126 @@ export async function inspectSshKeyPair(privateKeyPath, publicKeyPath = `${priva
109
134
  fingerprint: fingerprintValue,
110
135
  publicKeyType: publicLine.split(/\s+/, 1)[0],
111
136
  };
137
+ Object.defineProperty(result, GENERATED_KEY_IDENTITIES, {
138
+ value: Object.freeze({ private: privateSnapshot.identity, public: publicSnapshot.identity }),
139
+ enumerable: false,
140
+ });
141
+ return result;
112
142
  } finally {
113
143
  await rm(inspectionRoot, { recursive: true, force: true });
114
144
  }
115
145
  }
116
-
117
- async function installNoReplace(source, target) {
146
+ export async function removeGeneratedSshKeyPair(key, options = {}) {
147
+ if (!key?.created) return;
148
+ const identities = key[GENERATED_KEY_IDENTITIES];
149
+ if (!identities?.private || !identities?.public) {
150
+ throw new Error("generated SSH key rollback identity is unavailable; refusing path-only cleanup");
151
+ }
152
+ const remove = typeof options.removeIfCurrent === "function" ? options.removeIfCurrent : removeKeyPathIfCurrent;
153
+ const failures = [];
154
+ for (const [kind, filePath, identity] of [
155
+ ["private", key.privateKeyPath, identities.private],
156
+ ["public", key.publicKeyPath, identities.public],
157
+ ]) {
158
+ try { await remove(filePath, identity, `generated SSH ${kind} key`); }
159
+ catch (cause) { failures.push(new Error(`generated SSH ${kind} key cleanup failed`, { cause })); }
160
+ }
161
+ if (failures.length) throw new AggregateError(failures, "generated SSH key rollback was incomplete");
162
+ }
163
+ function keyPathIdentity(filePath, label) {
164
+ const info = lstatSync(filePath, { bigint: true });
165
+ if (info.isSymbolicLink() || !info.isFile() || info.nlink !== 1n) throw new Error(`${label} is not an exclusive regular file`);
166
+ return filesystemIdentity(info, label);
167
+ }
168
+ function removeKeyPathIfCurrent(filePath, identity, label) {
169
+ let current;
170
+ try { current = lstatSync(filePath, { bigint: true }); }
171
+ catch (error) { if (error?.code === "ENOENT") return; throw error; }
172
+ if (current.isSymbolicLink() || !current.isFile() || current.nlink !== 1n
173
+ || !sameFilesystemIdentity(identity, filesystemIdentity(current, label))) {
174
+ throw new Error(`${label} changed before rollback; replacement was preserved`);
175
+ }
176
+ if (!unlinkRegularFileIfIdentitySync(filePath, identity, label)) {
177
+ throw new Error(`${label} changed before rollback; replacement was preserved`);
178
+ }
179
+ }
180
+ async function installNoReplace(source, target, options = {}) {
181
+ const createLink = options?.link || link;
182
+ const opened = openRegularFileSync(source, fsConstants.O_RDONLY, { label: "SSH staging key", verifyPathIdentity: true, rejectMultipleLinks: true });
183
+ let primaryError = null;
118
184
  try {
119
- await link(source, target);
120
- await unlink(source);
185
+ try { await createLink(source, target); }
186
+ catch (error) {
187
+ if (error?.code === "EEXIST") throw new Error(`refusing to replace existing SSH key file: ${target}`);
188
+ throw error;
189
+ }
190
+ const installedIdentity = installedLinkIdentity(opened.fd, source, target);
191
+ try {
192
+ if (typeof options?.unlink === "function") await options.unlink(source, installedIdentity);
193
+ else removeInstalledLinkIfCurrent(source, installedIdentity, "SSH staging key");
194
+ } catch (error) {
195
+ try { removeInstalledLinkIfCurrent(target, installedIdentity); }
196
+ catch (cleanupError) { throw new AggregateError([error, cleanupError], "SSH key installation failed and target rollback was incomplete"); }
197
+ throw error;
198
+ }
121
199
  } catch (error) {
122
- if (error?.code === "EXDEV") {
123
- await copyFile(source, target, fsConstants.COPYFILE_EXCL);
124
- await unlink(source);
125
- return;
200
+ primaryError = error;
201
+ }
202
+ const cleanupErrors = [];
203
+ try { unlinkKnownLinkIfCurrent(source, filesystemIdentity(fstatSync(opened.fd, { bigint: true }), "SSH staging key cleanup")); }
204
+ catch (error) { cleanupErrors.push(error); }
205
+ try { closeSync(opened.fd); } catch (error) { cleanupErrors.push(error); }
206
+ if (cleanupErrors.length) {
207
+ throw new AggregateError(primaryError ? [primaryError, ...cleanupErrors] : cleanupErrors, "SSH key installation staging cleanup was incomplete");
208
+ }
209
+ if (primaryError) throw primaryError;
210
+ }
211
+ function installedLinkIdentity(sourceFd, source, target) {
212
+ const sourceIdentity = filesystemIdentity(fstatSync(sourceFd, { bigint: true }), "SSH staging key after link");
213
+ const targetInfo = lstatSync(target, { bigint: true });
214
+ const targetIdentity = filesystemIdentity(targetInfo, "installed SSH key target");
215
+ if (targetInfo.isSymbolicLink() || !targetInfo.isFile() || !sameFilesystemIdentity(sourceIdentity, targetIdentity)) {
216
+ throw new Error("installed SSH key target does not match the staging key; replacement was preserved");
217
+ }
218
+ try {
219
+ const sourceInfo = lstatSync(source, { bigint: true });
220
+ if (sourceInfo.isSymbolicLink() || !sourceInfo.isFile()
221
+ || !sameFilesystemIdentity(sourceIdentity, filesystemIdentity(sourceInfo, "SSH staging key after link"))) {
222
+ throw new Error("SSH staging key changed after link");
126
223
  }
127
- if (error?.code === "EEXIST") throw new Error(`refusing to replace existing SSH key file: ${target}`);
224
+ } catch (error) {
225
+ try { removeInstalledLinkIfCurrent(target, targetIdentity); }
226
+ catch (cleanupError) { throw new AggregateError([error, cleanupError], "SSH key link verification failed and target rollback was incomplete"); }
128
227
  throw error;
129
228
  }
229
+ return targetIdentity;
130
230
  }
131
-
132
- async function secureKeyModes(privateKeyPath, publicKeyPath) {
231
+ function unlinkKnownLinkIfCurrent(filePath, expectedIdentity) {
232
+ let current;
233
+ try { current = lstatSync(filePath, { bigint: true }); }
234
+ catch (error) { if (error?.code === "ENOENT") return false; throw error; }
235
+ if (current.isSymbolicLink() || !current.isFile()
236
+ || !sameFilesystemIdentity(expectedIdentity, filesystemIdentity(current, "SSH key link"))) return false;
237
+ try { unlinkSync(filePath); return true; }
238
+ catch (error) { if (error?.code === "ENOENT") return false; throw error; }
239
+ }
240
+ function removeInstalledLinkIfCurrent(filePath, expectedIdentity, label = "installed SSH key target") {
241
+ if (unlinkKnownLinkIfCurrent(filePath, expectedIdentity)) return;
242
+ try { lstatSync(filePath, { bigint: true }); }
243
+ catch (error) { if (error?.code === "ENOENT") return; throw error; }
244
+ throw new Error(`${label} changed before rollback; replacement was preserved`);
245
+ }
246
+ async function secureKeyModes(privateKeyPath, publicKeyPath, expected) {
133
247
  if (process.platform === "win32") return;
134
- chmodRegularFileSync(privateKeyPath, 0o600, "SSH private key");
135
- chmodRegularFileSync(publicKeyPath, 0o644, "SSH public key");
248
+ if (!expected?.private || !expected?.public) throw new Error("SSH key permission update requires exact key identities");
249
+ chmodRegularFileIfIdentitySync(privateKeyPath, expected.private, 0o600, "SSH private key");
250
+ chmodRegularFileIfIdentitySync(publicKeyPath, expected.public, 0o644, "SSH public key");
251
+ }
252
+ function keyIdentities(key) {
253
+ const identities = key?.[GENERATED_KEY_IDENTITIES];
254
+ if (!identities?.private || !identities?.public) throw new Error("SSH key inspection identity is unavailable");
255
+ return identities;
136
256
  }
137
-
138
257
  function tryReadKeySnapshot(path, maxBytes, label) {
139
258
  try { return readKeySnapshot(path, maxBytes, label); } catch (error) {
140
259
  if (error?.code === "ENOENT") return null;
@@ -148,10 +267,7 @@ function readKeySnapshot(path, maxBytes, label) {
148
267
 
149
268
  function assertKeySnapshotCurrent(path, expected, maxBytes, label) {
150
269
  const current = readKeySnapshot(path, maxBytes, label);
151
- const sameIdentity = Number(current.info.dev) === Number(expected.info.dev)
152
- && Number(current.info.ino) === Number(expected.info.ino)
153
- && Number(current.info.size) === Number(expected.info.size)
154
- && Number(current.info.mtimeMs) === Number(expected.info.mtimeMs);
270
+ const sameIdentity = sameFilesystemIdentity(current.identity, expected.identity);
155
271
  const sameBytes = current.buffer.length === expected.buffer.length
156
272
  && timingSafeEqual(current.buffer, expected.buffer);
157
273
  if (!sameIdentity || !sameBytes) throw new Error(`${label} changed during inspection; retry`);
@@ -165,7 +281,7 @@ function boundedComment(value) {
165
281
  }
166
282
 
167
283
  function normalizeRsaBits(value) {
168
- const bits = Number.parseInt(String(value || "3072"), 10);
169
- if (![2048, 3072, 4096].includes(bits)) throw new Error("RSA bits must be 2048, 3072, or 4096");
284
+ const bits = value === undefined || value === null || value === "" ? 3072 : Number(value);
285
+ if (!Number.isInteger(bits) || ![2048, 3072, 4096].includes(bits)) throw new Error("RSA bits must be 2048, 3072, or 4096");
170
286
  return bits;
171
287
  }
@@ -1,8 +1,11 @@
1
- import { existsSync, readdirSync, realpathSync } from "node:fs";
1
+ import { readdirSync, realpathSync } from "node:fs";
2
2
  import { resolve } from "node:path";
3
3
  import { activeManagedJobs } from "./managed-jobs.mjs";
4
+ import { MANAGED_JOB_ID } from "./managed-job-directory.mjs";
5
+ import { activeManagedJobLock } from "./managed-job-lock.mjs";
4
6
  import { inspectProcessInstance } from "./process-identity.mjs";
5
- import { readBoundedRegularFileSync } from "./secure-file.mjs";
7
+ import { inspectPathIfPresentSync, readBoundedRegularFileSync } from "./secure-file.mjs";
8
+ import { activeOwnerStateLocks } from "./state-owner-lock-inventory.mjs";
6
9
  import { STATE_SCHEMA_VERSION, expandHome, readDaemonLockOwner, resolveWorkspace } from "./state.mjs";
7
10
 
8
11
  const PROFILE_NAME = /^[a-f0-9]{24}$/;
@@ -11,13 +14,12 @@ const MAX_STATE_BYTES = 2 * 1024 * 1024;
11
14
 
12
15
  export function knownWorkerNames(stateRoot) {
13
16
  const profiles = profilesDirectory(stateRoot);
14
- if (!existsSync(profiles)) return [];
15
17
  const names = new Set();
16
18
  for (const entry of profileDirectories(profiles)) {
17
19
  const profileDir = resolve(profiles, entry.name);
18
20
  const stateFile = resolve(profileDir, "state.json");
19
- if (!existsSync(stateFile)) {
20
- const evidence = readdirSync(profileDir).some((name) => /^state\.json\.corrupt-/.test(name) || name === "daemon.lock");
21
+ if (!inspectPathIfPresentSync(stateFile, "workspace state")) {
22
+ const evidence = readdirSync(profileDir).some((name) => /^state\.json\.corrupt-/.test(name) || name === "state.json.recovery-required" || name === "daemon.lock");
21
23
  if (evidence) throw unreadableWorkerState(entry.name);
22
24
  continue;
23
25
  }
@@ -44,14 +46,13 @@ export function knownWorkerNames(stateRoot) {
44
46
  export function knownProfileStates(stateRoot) {
45
47
  const canonicalStateRoot = canonicalRoot(stateRoot);
46
48
  const profiles = resolve(canonicalStateRoot, "profiles");
47
- if (!existsSync(profiles)) return [];
48
49
  const states = [];
49
50
  const seen = new Set();
50
51
  for (const entry of profileDirectories(profiles)) {
51
52
  const profileDir = resolve(profiles, entry.name);
52
53
  const statePath = resolve(profileDir, "state.json");
53
54
  const candidates = [];
54
- if (existsSync(statePath)) {
55
+ if (inspectPathIfPresentSync(statePath, "workspace state")) {
55
56
  try {
56
57
  const value = readStateJson(statePath);
57
58
  if (typeof value?.workspace?.path === "string") candidates.push(value.workspace.path);
@@ -60,8 +61,9 @@ export function knownProfileStates(stateRoot) {
60
61
  }
61
62
  }
62
63
  const daemonLock = resolve(profileDir, "daemon.lock");
64
+ const daemonLockPresent = Boolean(inspectPathIfPresentSync(daemonLock, "daemon lock"));
63
65
  const daemonOwner = readDaemonLockOwner(daemonLock);
64
- if (existsSync(daemonLock) && !daemonOwner) {
66
+ if (daemonLockPresent && !daemonOwner) {
65
67
  throw new Error(`cannot inspect daemon lock for profile ${entry.name}; service definitions and state were kept`);
66
68
  }
67
69
  if (typeof daemonOwner?.workspace === "string") candidates.push(daemonOwner.workspace);
@@ -86,7 +88,6 @@ export function knownProfileStates(stateRoot) {
86
88
 
87
89
  export function activeStateJobs(stateRoot) {
88
90
  const profiles = profilesDirectory(stateRoot);
89
- if (!existsSync(profiles)) return [];
90
91
  const active = [];
91
92
  for (const profile of profileDirectories(profiles)) {
92
93
  for (const job of activeManagedJobs(resolve(profiles, profile.name, "jobs"))) {
@@ -97,13 +98,19 @@ export function activeStateJobs(stateRoot) {
97
98
  }
98
99
 
99
100
  export function activeStateLocks(stateRoot) {
100
- const profiles = profilesDirectory(stateRoot);
101
- if (!existsSync(profiles)) return [];
102
- const active = [];
101
+ const root = canonicalRoot(stateRoot);
102
+ const profiles = resolve(root, "profiles");
103
+ const active = activeOwnerStateLocks(root);
103
104
  for (const profile of profileDirectories(profiles)) {
104
- for (const [kind, name] of [["daemon", "daemon.lock"], ["startup", "startup.lock"]]) {
105
- const lockPath = resolve(profiles, profile.name, name);
106
- if (!existsSync(lockPath)) continue;
105
+ const profileDir = resolve(profiles, profile.name);
106
+ for (const [kind, name] of [
107
+ ["daemon", "daemon.lock"],
108
+ ["startup", "startup.lock"],
109
+ ["operation-authorization", "operation-authorization.lock"],
110
+ ["security-audit", "security-audit.lock"],
111
+ ]) {
112
+ const lockPath = resolve(profileDir, name);
113
+ if (!inspectPathIfPresentSync(lockPath, `${kind} lock`)) continue;
107
114
  const owner = readDaemonLockOwner(lockPath);
108
115
  if (!owner) {
109
116
  active.push({ kind, pid: null, path: lockPath, reason: "invalid_or_unreadable_lock" });
@@ -115,27 +122,46 @@ export function activeStateLocks(stateRoot) {
115
122
  active.push({ kind, pid: owner.pid, path: lockPath, reason: identity.reason });
116
123
  }
117
124
  }
125
+ const jobRoot = resolve(profileDir, "jobs");
126
+ const jobRootInfo = inspectPathIfPresentSync(jobRoot, "managed-job root");
127
+ if (!jobRootInfo) continue;
128
+ if (jobRootInfo.isSymbolicLink() || !jobRootInfo.isDirectory()) throw new Error("managed-job root must be a real directory");
129
+ const capacityLockPath = resolve(jobRoot, "capacity.lock");
130
+ const capacityLock = activeManagedJobLock(capacityLockPath);
131
+ if (capacityLock?.active) active.push({ kind: "job-capacity", pid: capacityLock.pid, path: capacityLockPath, reason: capacityLock.reason });
132
+ for (const entry of readdirSync(jobRoot, { withFileTypes: true })) {
133
+ if (!entry.isDirectory() || !MANAGED_JOB_ID.test(entry.name)) continue;
134
+ for (const [kind, name] of [["job-transition", "transition.lock"], ["job-recovery", "recovery.lock"]]) {
135
+ const lockPath = resolve(jobRoot, entry.name, name);
136
+ const lock = activeManagedJobLock(lockPath);
137
+ if (lock?.active) active.push({ kind, pid: lock.pid, path: lockPath, reason: lock.reason, job_id: entry.name });
138
+ }
139
+ }
118
140
  }
119
141
  return active;
120
142
  }
121
143
 
122
- function profilesDirectory(stateRoot) {
123
- return resolve(canonicalRoot(stateRoot), "profiles");
124
- }
125
-
144
+ function profilesDirectory(stateRoot) { return resolve(canonicalRoot(stateRoot), "profiles"); }
126
145
  function canonicalRoot(stateRoot) {
127
146
  const expanded = resolve(expandHome(stateRoot));
128
- if (!existsSync(expanded)) return expanded;
147
+ const info = inspectPathIfPresentSync(expanded, "state root"); if (!info) return expanded;
148
+ if (info.isSymbolicLink() || !info.isDirectory()) throw new Error("state root must be a real directory");
129
149
  return realpathSync.native ? realpathSync.native(expanded) : realpathSync(expanded);
130
150
  }
131
151
 
132
152
  function profileDirectories(profiles) {
133
- return readdirSync(profiles, { withFileTypes: true })
134
- .filter((entry) => entry.isDirectory() && PROFILE_NAME.test(entry.name));
153
+ const info = inspectPathIfPresentSync(profiles, "state profile directory");
154
+ if (!info) return [];
155
+ if (info.isSymbolicLink() || !info.isDirectory()) throw new Error("state profile directory must be a real directory");
156
+ const entries = readdirSync(profiles, { withFileTypes: true });
157
+ if (entries.some((entry) => !PROFILE_NAME.test(entry.name) || !entry.isDirectory())) throw new Error("state profile directory contains an unexpected entry; local state was kept for inspection");
158
+ return entries;
135
159
  }
136
-
137
160
  function readStateJson(path) {
138
- return JSON.parse(readBoundedRegularFileSync(path, MAX_STATE_BYTES).toString("utf8"));
161
+ return JSON.parse(readBoundedRegularFileSync(path, MAX_STATE_BYTES, "state inventory", {
162
+ verifyPathIdentity: true,
163
+ rejectMultipleLinks: true,
164
+ }).toString("utf8"));
139
165
  }
140
166
 
141
167
  function unreadableWorkerState(profile) {
@@ -0,0 +1,23 @@
1
+ import { resolve } from "node:path";
2
+ import { readOwnerStateLock } from "./owner-state-lock.mjs";
3
+ import { inspectProcessInstance } from "./process-identity.mjs";
4
+ import { inspectPathIfPresentSync } from "./secure-file.mjs";
5
+
6
+ export function activeOwnerStateLocks(stateRoot) {
7
+ const toolchains = resolve(stateRoot, "toolchains");
8
+ const directory = inspectPathIfPresentSync(toolchains, "toolchain state");
9
+ if (!directory) return [];
10
+ if (directory.isSymbolicLink() || !directory.isDirectory()) return [blocker("toolchain-state", null, "invalid_or_unreadable_state")];
11
+ const lockPath = resolve(toolchains, "wrangler-toolchain.lock");
12
+ if (!inspectPathIfPresentSync(lockPath, "Wrangler toolchain lock")) return [];
13
+ let inspected;
14
+ try { inspected = readOwnerStateLock(lockPath, "wrangler-toolchain"); }
15
+ catch { return [blocker("toolchain", null, "invalid_or_unreadable_lock")]; }
16
+ if (inspected.kind === "missing") return [];
17
+ if (inspected.kind !== "owner") return [blocker("toolchain", null, "invalid_or_unreadable_lock")];
18
+ const identity = inspectProcessInstance(inspected.owner);
19
+ if (!identity.current && !(identity.alive && !identity.reclaimable)) return [];
20
+ return [blocker("toolchain", inspected.owner.pid, identity.reason)];
21
+ }
22
+
23
+ function blocker(kind, pid, reason) { return { kind, pid: Number.isInteger(pid) ? pid : null, reason }; }
@@ -0,0 +1,83 @@
1
+ import { readdirSync } from "node:fs";
2
+ import { join } from "node:path";
3
+ import { inspectPathIfPresentSync } from "./secure-file.mjs";
4
+
5
+ const TOOLCHAIN_DIRECTORY = /^(?:npm-[0-9A-Za-z.+_-]+-hardened-[a-f0-9]{16}|wrangler-[0-9A-Za-z.+_-]+-[a-f0-9]{16})$/;
6
+ const TOOLCHAIN_LOCK_TEMP = /^\.wrangler-toolchain\.lock\.\d+\.[a-f0-9]{16}\.tmp$/;
7
+ const ACTIVATION_RECORD = /^v[0-9A-Za-z.-]+\.json$/;
8
+ const ACTIVATION_TEMP = /^\.v[0-9A-Za-z.-]+\.json\.\d+\.[a-f0-9]{16}\.tmp$/;
9
+ const RUNTIME_DIRECTORY = /^v[0-9A-Za-z.-]+-[0-9a-f]{12}-[0-9a-f]{12}$/;
10
+ const LEGACY_RELEASE_TASK = /^[0-9A-Za-z][0-9A-Za-z._-]{0,127}$/;
11
+
12
+ export function isCandidateRuntimeDirectoryName(name) { return RUNTIME_DIRECTORY.test(String(name || "")); }
13
+
14
+ export function validateOwnedStateNamespaces(root) {
15
+ validateToolchains(join(root, "toolchains"));
16
+ validateReleaseChannels(join(root, "release-channels"));
17
+ validateLegacyReleaseTasks(join(root, "release-tasks"));
18
+ }
19
+
20
+ function validateToolchains(directory) {
21
+ if (!realDirectoryIfPresent(directory, "toolchain state namespace")) return;
22
+ for (const entry of readdirSync(directory, { withFileTypes: true })) {
23
+ if (entry.name === "wrangler-toolchain.lock" || TOOLCHAIN_LOCK_TEMP.test(entry.name)) {
24
+ if (!entry.isFile()) throw new Error("Wrangler toolchain lock state has an invalid type before state removal");
25
+ continue;
26
+ }
27
+ if (!TOOLCHAIN_DIRECTORY.test(entry.name) || !entry.isDirectory()) {
28
+ throw new Error("toolchain state namespace contains an unexpected entry; state was kept for inspection");
29
+ }
30
+ }
31
+ }
32
+
33
+ function validateReleaseChannels(directory) {
34
+ if (!realDirectoryIfPresent(directory, "release-channel state namespace")) return;
35
+ for (const entry of readdirSync(directory, { withFileTypes: true })) {
36
+ if (!entry.isDirectory() || !["activations", "runtimes", "browser-extension"].includes(entry.name)) {
37
+ throw new Error("release-channel state namespace contains an unexpected entry; state was kept for inspection");
38
+ }
39
+ }
40
+ validateNamedChildren(join(directory, "activations"), "activation record", [ACTIVATION_RECORD, ACTIVATION_TEMP], "file");
41
+ validateNamedChildren(join(directory, "runtimes"), "candidate runtime", [RUNTIME_DIRECTORY], "directory");
42
+ validateBrowserExtension(join(directory, "browser-extension"));
43
+ }
44
+
45
+ function validateBrowserExtension(directory) {
46
+ if (!realDirectoryIfPresent(directory, "release browser-extension namespace")) return;
47
+ let visited = 0;
48
+ const walk = (current) => {
49
+ for (const entry of readdirSync(current, { withFileTypes: true })) {
50
+ visited += 1;
51
+ if (visited > 512) throw new Error("release browser-extension namespace contains too many entries; state was kept for inspection");
52
+ if (entry.isDirectory()) { walk(join(current, entry.name)); continue; }
53
+ if (!entry.isFile()) throw new Error("release browser-extension namespace contains an unexpected entry; state was kept for inspection");
54
+ }
55
+ };
56
+ walk(directory);
57
+ }
58
+
59
+ function validateLegacyReleaseTasks(directory) {
60
+ if (!realDirectoryIfPresent(directory, "legacy release-task namespace")) return;
61
+ for (const entry of readdirSync(directory, { withFileTypes: true })) {
62
+ if (!entry.isDirectory() || !LEGACY_RELEASE_TASK.test(entry.name)) {
63
+ throw new Error("legacy release-task namespace contains an unexpected entry; state was kept for inspection");
64
+ }
65
+ }
66
+ }
67
+
68
+ function validateNamedChildren(directory, label, patterns, kind) {
69
+ if (!realDirectoryIfPresent(directory, `${label} namespace`)) return;
70
+ for (const entry of readdirSync(directory, { withFileTypes: true })) {
71
+ const rightType = kind === "file" ? entry.isFile() : entry.isDirectory();
72
+ if (!rightType || !patterns.some((pattern) => pattern.test(entry.name))) {
73
+ throw new Error(`${label} namespace contains an unexpected entry; state was kept for inspection`);
74
+ }
75
+ }
76
+ }
77
+
78
+ function realDirectoryIfPresent(directory, label) {
79
+ const info = inspectPathIfPresentSync(directory, label);
80
+ if (!info) return false;
81
+ if (info.isSymbolicLink() || !info.isDirectory()) throw new Error(`${label} must be a real directory before state removal`);
82
+ return true;
83
+ }