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,9 +1,20 @@
1
- import { createHash, randomBytes } from "node:crypto";
1
+ import { createHash } from "node:crypto";
2
2
  import { constants as fsConstants } from "node:fs";
3
- import { link, lstat, mkdir, open, opendir, rename, rm, stat } from "node:fs/promises";
4
- import path, { basename, dirname, join, resolve } from "node:path";
3
+ import { lstat, open, stat } from "node:fs/promises";
4
+ import path, { basename, resolve } from "node:path";
5
+ import { directoryEntriesWithMetadata } from "./directory-metadata.mjs";
6
+ import { BridgeError } from "./errors.mjs";
5
7
  import { applyUpdateHunks, parsePatchEnvelope } from "./patch.mjs";
8
+ import { openDirectoryIfExists, pathEntryIfExists } from "./path-inspection.mjs";
6
9
  import { clampInteger } from "./numbers.mjs";
10
+ import { searchWorkspaceFiles } from "./workspace-search.mjs";
11
+ import {
12
+ assertNoResolvedPatchCollisions as assertResolvedPatchCollisions,
13
+ atomicWriteText as commitAtomicText,
14
+ commitPatchTransaction as commitPatchOperations,
15
+ sha256,
16
+ } from "./workspace-file-transaction.mjs";
17
+ export { assertNoResolvedPatchCollisions, sha256 } from "./workspace-file-transaction.mjs";
7
18
 
8
19
  export const MAX_WRITE_BYTES = 5 * 1024 * 1024;
9
20
  const MAX_DIRECTORY_ENTRIES = 10_000;
@@ -12,41 +23,43 @@ const MAX_WALK_ENTRIES = 200_000;
12
23
  const MAX_IMAGE_BYTES = 4 * 1024 * 1024;
13
24
 
14
25
  export class WorkspaceFileService {
15
- constructor({ workspace, policy, policyGate, resolveExistingPath, resolveWritePath, displayPath, throwIfCancelled, withMutationLock }) {
26
+ constructor({ workspace, policy, policyGate, policyForContext = null, resolveExistingPath, resolveWritePath, displayPath, throwIfCancelled, withMutationPaths }) {
16
27
  this.workspace = workspace;
17
28
  this.policy = policy;
18
29
  this.policyGate = policyGate;
30
+ this.policyForContext = typeof policyForContext === "function" ? policyForContext : () => this.policy;
19
31
  this.resolveExistingPath = resolveExistingPath;
20
32
  this.resolveWritePath = resolveWritePath;
21
33
  this.displayPath = displayPath;
22
34
  this.throwIfCancelled = throwIfCancelled;
23
- this.withMutationLock = withMutationLock;
35
+ this.withMutationPaths = withMutationPaths;
24
36
  }
25
37
 
26
- listRoots() {
27
- const roots = [{ name: this.policy.exposeAbsolutePaths ? basename(this.workspace) : "workspace", path: this.displayPath(this.workspace), default: true }];
28
- if (this.policy.unrestrictedPaths) {
38
+ listRoots(context = {}) {
39
+ const policy = this.policyForContext(context);
40
+ const roots = [{ name: policy.exposeAbsolutePaths ? basename(this.workspace) : "workspace", path: this.displayPath(this.workspace, context), default: true }];
41
+ if (policy.unrestrictedPaths) {
29
42
  const home = process.env.HOME || process.env.USERPROFILE;
30
- if (home && home !== this.workspace) roots.push({ name: "home", path: this.displayPath(resolve(home)), default: false });
31
- roots.push({ name: "filesystem-root", path: this.displayPath(path.parse(this.workspace).root), default: false });
43
+ if (home && home !== this.workspace) roots.push({ name: "home", path: this.displayPath(resolve(home), context), default: false });
44
+ roots.push({ name: "filesystem-root", path: this.displayPath(path.parse(this.workspace).root, context), default: false });
32
45
  }
33
46
  return { roots };
34
47
  }
35
48
 
36
49
  async listDir(inputPath, context = {}) {
37
- const full = await this.resolveExistingPath(inputPath);
50
+ const full = await this.resolveExistingPath(inputPath, context);
38
51
  const entries = [];
39
52
  let resultBytes = 0;
40
53
  let truncated = false;
41
- for await (const entry of await opendir(full)) {
42
- this.throwIfCancelled(context);
43
- const entryPath = resolve(full, entry.name);
44
- const info = await lstat(entryPath).catch(() => null);
54
+ for await (const { entry, path: entryPath, info } of directoryEntriesWithMetadata(full, {
55
+ throwIfCancelled: this.throwIfCancelled, context,
56
+ })) {
57
+ if (!info) continue;
45
58
  const item = {
46
59
  name: entry.name,
47
- path: this.displayPath(entryPath),
60
+ path: this.displayPath(entryPath, context),
48
61
  type: entry.isDirectory() ? "directory" : entry.isFile() ? "file" : entry.isSymbolicLink() ? "symlink" : "other",
49
- size: info?.size ?? 0,
62
+ size: info.size,
50
63
  };
51
64
  const itemBytes = Buffer.byteLength(item.name) + Buffer.byteLength(item.path) + 64;
52
65
  if (entries.length >= MAX_DIRECTORY_ENTRIES || resultBytes + itemBytes > MAX_PATH_RESULT_BYTES) {
@@ -57,26 +70,26 @@ export class WorkspaceFileService {
57
70
  resultBytes += itemBytes;
58
71
  }
59
72
  entries.sort((a, b) => a.type.localeCompare(b.type) || a.name.localeCompare(b.name));
60
- return { path: this.displayPath(full), entries, truncated };
73
+ return { path: this.displayPath(full, context), entries, truncated };
61
74
  }
62
75
 
63
76
  async listFiles(inputPath, maxFiles, context = {}) {
64
- const root = await this.resolveExistingPath(inputPath);
77
+ const root = await this.resolveExistingPath(inputPath, context);
65
78
  const info = await stat(root);
66
- if (info.isFile()) return { path: this.displayPath(root), files: [this.displayPath(root)], truncated: false };
67
- if (!info.isDirectory()) throw new Error("path is not a file or directory");
79
+ if (info.isFile()) return { path: this.displayPath(root, context), files: [this.displayPath(root, context)], truncated: false };
80
+ if (!info.isDirectory()) throw new BridgeError("invalid_request", "path is not a file or directory", { details: { reason: "unsupported_path_type" } });
68
81
  const files = [];
69
82
  let resultBytes = 0;
70
83
  const walkResult = await this.walk(root, async full => {
71
84
  this.throwIfCancelled(context);
72
- const shown = this.displayPath(full);
85
+ const shown = this.displayPath(full, context);
73
86
  const pathBytes = Buffer.byteLength(shown) + 8;
74
87
  if (files.length >= maxFiles || resultBytes + pathBytes > MAX_PATH_RESULT_BYTES) return false;
75
88
  files.push(shown);
76
89
  resultBytes += pathBytes;
77
90
  return true;
78
91
  }, context);
79
- return { path: this.displayPath(root), files, truncated: files.length >= maxFiles || resultBytes >= MAX_PATH_RESULT_BYTES || walkResult.truncated };
92
+ return { path: this.displayPath(root, context), files, truncated: files.length >= maxFiles || resultBytes >= MAX_PATH_RESULT_BYTES || walkResult.truncated };
80
93
  }
81
94
 
82
95
  async readFile(args, context = {}) {
@@ -84,8 +97,8 @@ export class WorkspaceFileService {
84
97
  args = { path: args, max_bytes: typeof context === "number" ? context : undefined };
85
98
  context = {};
86
99
  }
87
- if (!args.path) throw new Error("path is required");
88
- const full = await this.resolveExistingPath(args.path);
100
+ if (!args.path) throw new BridgeError("invalid_request", "path is required", { details: { reason: "missing_path" } });
101
+ const full = await this.resolveExistingPath(args.path, context);
89
102
  this.throwIfCancelled(context);
90
103
  const { buffer, info } = await readBoundedFile(full, MAX_WRITE_BYTES, "readable text file");
91
104
  const content = decodeUtf8(buffer);
@@ -98,16 +111,16 @@ export class WorkspaceFileService {
98
111
  }
99
112
  const totalLines = lineStarts.length;
100
113
  const endLine = args.end_line === undefined ? totalLines : clampInteger(args.end_line, totalLines, 1, Number.MAX_SAFE_INTEGER);
101
- if (endLine < startLine) throw new Error("end_line must be greater than or equal to start_line");
102
- if (startLine > totalLines) throw new Error(`start_line exceeds total lines (${startLine} > ${totalLines})`);
114
+ if (endLine < startLine) throw new BridgeError("invalid_request", "end_line must be greater than or equal to start_line", { details: { reason: "invalid_line_range" } });
115
+ if (startLine > totalLines) throw new BridgeError("invalid_request", `start_line exceeds total lines (${startLine} > ${totalLines})`, { details: { reason: "line_out_of_range", total_lines: totalLines } });
103
116
  const selectedEnd = Math.min(endLine, totalLines);
104
117
  const selectedStartOffset = lineStarts[startLine - 1];
105
118
  const selectedEndOffset = selectedEnd < totalLines ? lineStarts[selectedEnd] : content.length;
106
119
  const selected = content.slice(selectedStartOffset, selectedEndOffset);
107
120
  const selectedBytes = Buffer.byteLength(selected);
108
- if (selectedBytes > maxBytes) throw new Error(`selected content exceeds max_bytes (${selectedBytes} > ${maxBytes})`);
121
+ if (selectedBytes > maxBytes) throw new BridgeError("limit_exceeded", `selected content exceeds max_bytes (${selectedBytes} > ${maxBytes})`, { details: { reason: "read_limit", selected_bytes: selectedBytes, maximum_bytes: maxBytes } });
109
122
  return {
110
- path: this.displayPath(full),
123
+ path: this.displayPath(full, context),
111
124
  size: info.size,
112
125
  sha256: sha256(content),
113
126
  content: selected,
@@ -119,18 +132,18 @@ export class WorkspaceFileService {
119
132
  }
120
133
 
121
134
  async viewImage(args, context = {}) {
122
- if (!args.path) throw new Error("path is required");
123
- const full = await this.resolveExistingPath(args.path);
135
+ if (!args.path) throw new BridgeError("invalid_request", "path is required", { details: { reason: "missing_path" } });
136
+ const full = await this.resolveExistingPath(args.path, context);
124
137
  this.throwIfCancelled(context);
125
138
  const { buffer, info } = await readBoundedFile(full, MAX_IMAGE_BYTES, "image");
126
139
  this.throwIfCancelled(context);
127
140
  const mimeType = detectImageMime(buffer);
128
- if (!mimeType) throw new Error("unsupported image format; expected PNG, JPEG, GIF, or WebP");
141
+ if (!mimeType) throw new BridgeError("invalid_request", "unsupported image format; expected PNG, JPEG, GIF, or WebP", { details: { reason: "unsupported_image_format" } });
129
142
  return {
130
143
  $mcp: {
131
144
  content: [{ type: "image", data: buffer.toString("base64"), mimeType }],
132
145
  structuredContent: {
133
- path: this.displayPath(full),
146
+ path: this.displayPath(full, context),
134
147
  size: info.size,
135
148
  sha256: createHash("sha256").update(buffer).digest("hex"),
136
149
  mime_type: mimeType,
@@ -140,133 +153,152 @@ export class WorkspaceFileService {
140
153
  }
141
154
 
142
155
  async writeFile(args, context = {}) {
143
- return this.withMutationLock(async () => {
156
+ this.throwIfCancelled(context);
157
+ this.policyGate.assert("write_file");
158
+ if (!args.path) throw new BridgeError("invalid_request", "path is required", { details: { reason: "missing_path" } });
159
+ const content = String(args.content ?? "");
160
+ const bytes = Buffer.byteLength(content);
161
+ if (bytes > MAX_WRITE_BYTES) throw new BridgeError("limit_exceeded", `content exceeds maximum write size (${bytes} > ${MAX_WRITE_BYTES})`, { details: { reason: "write_limit", bytes, maximum_bytes: MAX_WRITE_BYTES } });
162
+ const full = await this.resolveWritePath(args.path, context);
163
+ return this.withMutationPaths([full], async () => {
144
164
  this.throwIfCancelled(context);
145
- this.policyGate.assert("write_file");
146
- if (!args.path) throw new Error("path is required");
147
- const content = String(args.content ?? "");
148
- const bytes = Buffer.byteLength(content);
149
- if (bytes > MAX_WRITE_BYTES) throw new Error(`content exceeds maximum write size (${bytes} > ${MAX_WRITE_BYTES})`);
150
- const full = await this.resolveWritePath(args.path);
151
- const existing = await lstat(full).catch(() => null);
152
- if (existing?.isSymbolicLink()) throw new Error("refusing to overwrite a symbolic link");
153
- if (args.create_only && existing) throw new Error("file exists and create_only=true");
154
- if (existing && !existing.isFile()) throw new Error("path is not a regular file");
165
+ const existing = await pathEntryIfExists(full);
166
+ if (existing?.isSymbolicLink()) throw new BridgeError("conflict", "refusing to overwrite a symbolic link", { details: { reason: "symbolic_link" } });
167
+ if (args.create_only && existing) throw new BridgeError("conflict", "file exists and create_only=true", { details: { reason: "already_exists" } });
168
+ if (existing && !existing.isFile()) throw new BridgeError("conflict", "path is not a regular file", { details: { reason: "unsupported_target_type" } });
155
169
  if (args.expected_sha256) {
156
- if (!existing) throw new Error("expected_sha256 requires an existing file");
170
+ if (!existing) throw new BridgeError("conflict", "expected_sha256 requires an existing file", { details: { reason: "precondition_target_missing" } });
157
171
  const current = await readUtf8File(full);
158
- if (sha256(current) !== String(args.expected_sha256).toLowerCase()) throw new Error("expected_sha256 mismatch");
172
+ if (sha256(current) !== String(args.expected_sha256).toLowerCase()) throw new BridgeError("conflict", "expected_sha256 mismatch", { details: { reason: "hash_mismatch" } });
159
173
  }
160
174
  this.throwIfCancelled(context);
161
- await atomicWriteText(full, content, existing, {
175
+ const commit = await commitAtomicText(full, content, existing, {
176
+ readText: readUtf8File,
162
177
  createOnly: args.create_only === true,
163
178
  expectedHash: args.expected_sha256 ? String(args.expected_sha256).toLowerCase() : undefined,
164
179
  });
165
- return { ok: true, path: this.displayPath(full), sha256: sha256(content), bytes };
180
+ return { ok: true, path: this.displayPath(full, context), sha256: sha256(content), bytes, ...(commit.warnings.length ? { warnings: commit.warnings } : {}) };
166
181
  });
167
182
  }
168
-
169
183
  async editFile(args, context = {}) {
170
- return this.withMutationLock(async () => {
184
+ this.throwIfCancelled(context);
185
+ this.policyGate.assert("edit_file");
186
+ if (!args.path) throw new BridgeError("invalid_request", "path is required", { details: { reason: "missing_path" } });
187
+ const oldText = String(args.old_text ?? "");
188
+ const newText = String(args.new_text ?? "");
189
+ if (!oldText) throw new BridgeError("invalid_request", "old_text must not be empty", { details: { reason: "empty_old_text" } });
190
+ const full = await this.resolveExistingPath(args.path, context);
191
+ return this.withMutationPaths([full], async () => {
171
192
  this.throwIfCancelled(context);
172
- this.policyGate.assert("edit_file");
173
- if (!args.path) throw new Error("path is required");
174
- const oldText = String(args.old_text ?? "");
175
- const newText = String(args.new_text ?? "");
176
- if (!oldText) throw new Error("old_text must not be empty");
177
- const full = await this.resolveExistingPath(args.path);
178
193
  const info = await lstat(full);
179
- if (!info.isFile() || info.isSymbolicLink()) throw new Error("path is not a regular non-symbolic-link file");
194
+ if (!info.isFile() || info.isSymbolicLink()) throw new BridgeError("conflict", "path is not a regular non-symbolic-link file", { details: { reason: "unsupported_target_type" } });
180
195
  const current = await readUtf8File(full);
181
- if (args.expected_sha256 && sha256(current) !== String(args.expected_sha256).toLowerCase()) throw new Error("expected_sha256 mismatch");
196
+ if (args.expected_sha256 && sha256(current) !== String(args.expected_sha256).toLowerCase()) throw new BridgeError("conflict", "expected_sha256 mismatch", { details: { reason: "hash_mismatch" } });
182
197
  const occurrences = countOccurrences(current, oldText);
183
- if (occurrences === 0) throw new Error("old_text was not found");
184
- if (!args.replace_all && occurrences !== 1) throw new Error(`old_text occurs ${occurrences} times; provide a unique fragment or set replace_all=true`);
198
+ if (occurrences === 0) throw new BridgeError("not_found", "old_text was not found", { details: { reason: "text_not_found" } });
199
+ if (!args.replace_all && occurrences !== 1) throw new BridgeError("conflict", `old_text occurs ${occurrences} times; provide a unique fragment or set replace_all=true`, { details: { reason: "text_ambiguous", occurrences } });
185
200
  const updated = args.replace_all ? current.split(oldText).join(newText) : current.replace(oldText, newText);
186
201
  const bytes = Buffer.byteLength(updated);
187
- if (bytes > MAX_WRITE_BYTES) throw new Error(`edited content exceeds maximum write size (${bytes} > ${MAX_WRITE_BYTES})`);
202
+ if (bytes > MAX_WRITE_BYTES) throw new BridgeError("limit_exceeded", `edited content exceeds maximum write size (${bytes} > ${MAX_WRITE_BYTES})`, { details: { reason: "write_limit", bytes, maximum_bytes: MAX_WRITE_BYTES } });
188
203
  this.throwIfCancelled(context);
189
- await atomicWriteText(full, updated, info, { expectedHash: sha256(current) });
190
- return { ok: true, path: this.displayPath(full), replacements: args.replace_all ? occurrences : 1, sha256: sha256(updated), bytes };
204
+ await commitAtomicText(full, updated, info, { expectedHash: sha256(current), readText: readUtf8File });
205
+ return { ok: true, path: this.displayPath(full, context), replacements: args.replace_all ? occurrences : 1, sha256: sha256(updated), bytes };
191
206
  });
192
207
  }
193
-
194
208
  async applyPatch(args, context = {}) {
195
- return this.withMutationLock(async () => {
209
+ this.throwIfCancelled(context);
210
+ this.policyGate.assert("apply_patch");
211
+ const patchText = String(args.patch ?? "");
212
+ if (!patchText) throw new BridgeError("invalid_request", "patch is required", { details: { reason: "missing_patch" } });
213
+ if (Buffer.byteLength(patchText) > MAX_WRITE_BYTES) throw new BridgeError("limit_exceeded", "patch exceeds maximum size", { details: { reason: "patch_limit", maximum_bytes: MAX_WRITE_BYTES } });
214
+ const parsed = parsePatchEnvelope(patchText);
215
+ const resolved = [];
216
+ for (const operation of parsed) {
217
+ this.throwIfCancelled(context);
218
+ if (operation.kind === "add") {
219
+ resolved.push({ operation, kind: "add", source: null, target: await this.resolveWritePath(operation.path, context) });
220
+ continue;
221
+ }
222
+ const source = await this.resolveExistingPath(operation.path, context);
223
+ const target = operation.kind === "update" && operation.moveTo
224
+ ? await this.resolveWritePath(operation.moveTo, context)
225
+ : operation.kind === "delete" ? null : source;
226
+ resolved.push({ operation, kind: operation.kind === "delete" ? "delete" : operation.moveTo ? "move" : "update", source, target });
227
+ }
228
+ assertResolvedPatchCollisions(resolved);
229
+ const mutationPaths = resolved.flatMap((item) => [item.source, item.target].filter(Boolean));
230
+ return this.withMutationPaths(mutationPaths, async () => {
196
231
  this.throwIfCancelled(context);
197
- this.policyGate.assert("apply_patch");
198
- const patchText = String(args.patch ?? "");
199
- if (!patchText) throw new Error("patch is required");
200
- if (Buffer.byteLength(patchText) > MAX_WRITE_BYTES) throw new Error("patch exceeds maximum size");
201
- const parsed = parsePatchEnvelope(patchText);
202
232
  const prepared = [];
203
- for (const operation of parsed) {
233
+ for (const item of resolved) {
234
+ const { operation, source, target } = item;
204
235
  this.throwIfCancelled(context);
205
- if (operation.kind === "add") {
206
- const target = await this.resolveWritePath(operation.path);
207
- if (await lstat(target).catch(() => null)) throw new Error(`add target already exists: ${operation.path}`);
208
- assertTextSize(operation.content, operation.path);
236
+ if (item.kind === "add") {
237
+ if (await pathEntryIfExists(target)) throw new BridgeError("conflict", "add target already exists", { details: { reason: "already_exists", operation: "add" } });
238
+ assertTextSize(operation.content);
209
239
  prepared.push({ kind: "add", source: null, target, content: operation.content, mode: 0o600 });
210
240
  continue;
211
241
  }
212
- const source = await this.resolveExistingPath(operation.path);
213
242
  const sourceInfo = await lstat(source);
214
- if (!sourceInfo.isFile() || sourceInfo.isSymbolicLink()) throw new Error(`patch source is not a regular file: ${operation.path}`);
243
+ if (!sourceInfo.isFile() || sourceInfo.isSymbolicLink()) throw new BridgeError("conflict", "patch source is not a regular file", { details: { reason: "unsupported_source_type" } });
215
244
  const original = await readUtf8File(source);
216
- if (operation.kind === "delete") {
245
+ if (item.kind === "delete") {
217
246
  prepared.push({ kind: "delete", source, target: null, originalHash: sha256(original), mode: sourceInfo.mode & 0o777 });
218
247
  continue;
219
248
  }
220
- const content = applyUpdateHunks(original, operation.hunks, operation.path);
221
- assertTextSize(content, operation.path);
222
- const target = operation.moveTo ? await this.resolveWritePath(operation.moveTo) : source;
223
- if (target !== source && await lstat(target).catch(() => null)) throw new Error(`move target already exists: ${operation.moveTo}`);
224
- prepared.push({ kind: operation.moveTo ? "move" : "update", source, target, content, originalHash: sha256(original), mode: sourceInfo.mode & 0o777 });
249
+ const content = applyUpdateHunks(original, operation.hunks);
250
+ assertTextSize(content);
251
+ if (target !== source && await pathEntryIfExists(target)) throw new BridgeError("conflict", "move target already exists", { details: { reason: "already_exists", operation: "move" } });
252
+ prepared.push({ kind: item.kind, source, target, content, originalHash: sha256(original), mode: sourceInfo.mode & 0o777 });
225
253
  }
226
- assertNoResolvedPatchCollisions(prepared);
227
254
  this.throwIfCancelled(context);
228
- const transaction = await commitPatchTransaction(prepared);
255
+ const transaction = await commitPatchOperations(prepared, { readText: readUtf8File });
229
256
  return {
230
257
  ok: true,
231
258
  ...(transaction.warnings.length ? { warnings: transaction.warnings } : {}),
232
259
  files: prepared.map((item) => ({
233
260
  operation: item.kind,
234
- path: this.displayPath(item.target || item.source),
235
- from: item.kind === "move" ? this.displayPath(item.source) : undefined,
236
- sha256: item.content === undefined ? undefined : sha256(item.content),
261
+ path: this.displayPath(item.target || item.source, context),
262
+ ...(item.kind === "move" ? { from: this.displayPath(item.source, context) } : {}),
263
+ ...(item.content === undefined ? {} : { sha256: sha256(item.content) }),
237
264
  })),
238
265
  };
239
266
  });
240
267
  }
241
-
242
268
  async searchText(args, context = {}) {
243
269
  const query = String(args.query || "");
244
- if (!query) throw new Error("query is required");
245
- const root = await this.resolveExistingPath(args.path || ".");
270
+ if (!query) throw new BridgeError("invalid_request", "query is required", { details: { reason: "missing_query" } });
271
+ const root = await this.resolveExistingPath(args.path || ".", context);
246
272
  const max = clampInteger(args.max_matches, 100, 1, 1000);
247
273
  const maxFiles = clampInteger(args.max_files, 10000, 1, 100000);
248
- let visitedFiles = 0;
249
274
  const matches = [];
250
275
  const rootInfo = await stat(root);
251
276
  if (rootInfo.isFile()) {
252
277
  await this.searchOneFile(root, query, matches, max, context);
253
- return { query, root: this.displayPath(root), matches, visited_files: 1, truncated: matches.length >= max };
278
+ return { query, root: this.displayPath(root, context), matches, visited_files: 1, truncated: matches.length >= max };
254
279
  }
255
- if (!rootInfo.isDirectory()) throw new Error("path is not a file or directory");
256
- const walkResult = await this.walk(root, async full => {
257
- this.throwIfCancelled(context);
258
- if (matches.length >= max || visitedFiles >= maxFiles) return false;
259
- visitedFiles += 1;
260
- await this.searchOneFile(full, query, matches, max, context);
261
- return matches.length < max && visitedFiles < maxFiles;
262
- }, context);
263
- return { query, root: this.displayPath(root), matches, visited_files: visitedFiles, truncated: matches.length >= max || visitedFiles >= maxFiles || walkResult.truncated };
280
+ if (!rootInfo.isDirectory()) throw new BridgeError("invalid_request", "path is not a file or directory", { details: { reason: "unsupported_path_type" } });
281
+ const result = await searchWorkspaceFiles({
282
+ maximumFiles: maxFiles, maximumMatches: max,
283
+ walk: (onFile) => this.walk(root, onFile, context),
284
+ searchFile: async (full) => {
285
+ const fileMatches = [];
286
+ await this.searchOneFile(full, query, fileMatches, max, context);
287
+ return fileMatches;
288
+ },
289
+ throwIfCancelled: this.throwIfCancelled, context,
290
+ });
291
+ return { query, root: this.displayPath(root, context), matches: result.matches, visited_files: result.visitedFiles, truncated: result.truncated };
264
292
  }
265
293
 
266
294
  async searchOneFile(full, query, matches, max, context = {}) {
267
295
  this.throwIfCancelled(context);
268
- const bounded = await readBoundedFile(full, 1024 * 1024, "search file").catch(() => null);
269
- if (!bounded || bounded.buffer.includes(0)) return;
296
+ let bounded;
297
+ try { bounded = await readBoundedFile(full, 1024 * 1024, "search file"); } catch (error) {
298
+ if (isSkippableSearchFileError(error)) return;
299
+ throw error;
300
+ }
301
+ if (bounded.buffer.includes(0)) return;
270
302
  const buffer = bounded.buffer;
271
303
  let text;
272
304
  try { text = new TextDecoder("utf-8", { fatal: true }).decode(buffer); } catch { return; }
@@ -274,7 +306,7 @@ export class WorkspaceFileService {
274
306
  const lines = text.split(/\r?\n/);
275
307
  for (let index = 0; index < lines.length; index += 1) {
276
308
  if (lines[index].includes(query)) {
277
- matches.push({ path: this.displayPath(full), line: index + 1, text: lines[index].slice(0, 500) });
309
+ matches.push({ path: this.displayPath(full, context), line: index + 1, text: lines[index].slice(0, 500) });
278
310
  if (matches.length >= max) break;
279
311
  }
280
312
  }
@@ -286,7 +318,7 @@ export class WorkspaceFileService {
286
318
  while (stack.length) {
287
319
  this.throwIfCancelled(context);
288
320
  const current = stack.pop();
289
- const entries = await opendir(current).catch(() => null);
321
+ const entries = await openDirectoryIfExists(current);
290
322
  if (!entries) continue;
291
323
  for await (const entry of entries) {
292
324
  this.throwIfCancelled(context);
@@ -310,8 +342,9 @@ export async function readBoundedFile(filePath, maxBytes, label) {
310
342
  const handle = await open(filePath, flags);
311
343
  try {
312
344
  const info = await handle.stat();
313
- if (!info.isFile()) throw new Error(`${label} is not a regular file`);
314
- if (info.size > maxBytes) throw new Error(`${label} exceeds maximum size (${info.size} > ${maxBytes})`);
345
+ if (!info.isFile()) throw new BridgeError("invalid_request", `${label} is not a regular file`, { details: { reason: "unsupported_path_type" } });
346
+ if (Number(info.nlink) > 1) throw new BridgeError("permission_denied", `refusing to read ${label} with multiple hard links`, { details: { reason: "multiple_hard_links" } });
347
+ if (info.size > maxBytes) throw new BridgeError("limit_exceeded", `${label} exceeds maximum size (${info.size} > ${maxBytes})`, { details: { reason: "read_limit", size: info.size, maximum_bytes: maxBytes } });
315
348
  const buffer = Buffer.alloc(info.size);
316
349
  let offset = 0;
317
350
  while (offset < buffer.length) {
@@ -325,9 +358,17 @@ export async function readBoundedFile(filePath, maxBytes, label) {
325
358
  }
326
359
  }
327
360
 
361
+ function isSkippableSearchFileError(error) {
362
+ const reason = String(error?.details?.reason || "");
363
+ return error?.code === "ELOOP"
364
+ || reason === "read_limit"
365
+ || reason === "unsupported_path_type"
366
+ || reason === "multiple_hard_links";
367
+ }
368
+
328
369
  function decodeUtf8(buffer) {
329
370
  try { return new TextDecoder("utf-8", { fatal: true }).decode(buffer); } catch {
330
- throw new Error("file is not valid UTF-8 text");
371
+ throw new BridgeError("invalid_request", "file is not valid UTF-8 text", { details: { reason: "invalid_utf8" } });
331
372
  }
332
373
  }
333
374
 
@@ -336,138 +377,17 @@ async function readUtf8File(filePath) {
336
377
  return decodeUtf8(buffer);
337
378
  }
338
379
 
339
- async function writeFlushedText(filePath, content, mode) {
340
- const handle = await open(filePath, "wx", mode);
341
- let failure = null;
342
- try {
343
- await handle.writeFile(content, { encoding: "utf8" });
344
- try { await handle.chmod(mode); } catch (error) { if (process.platform !== "win32") throw error; }
345
- await handle.sync();
346
- } catch (error) {
347
- failure = error;
348
- }
349
- try { await handle.close(); } catch (error) { failure ||= error; }
350
- if (failure) {
351
- try { await rm(filePath, { force: true }); } catch {
352
- throw new Error("staged file write failed and cleanup was incomplete; inspect the destination directory before retrying", { cause: failure });
353
- }
354
- throw failure;
355
- }
356
- }
357
-
358
- async function atomicWriteText(full, content, existing = null, options = {}) {
359
- await mkdir(dirname(full), { recursive: true });
360
- const temp = join(dirname(full), `.${basename(full)}.mbm-${process.pid}-${randomBytes(6).toString("hex")}.tmp`);
361
- try {
362
- await writeFlushedText(temp, content, existing ? existing.mode & 0o777 : 0o600);
363
- if (options.expectedHash) {
364
- const current = await readUtf8File(full).catch(() => null);
365
- if (current === null || sha256(current) !== options.expectedHash) throw new Error("file changed before atomic commit");
366
- }
367
- if (options.createOnly) {
368
- await link(temp, full);
369
- await rm(temp, { force: true });
370
- } else {
371
- await rename(temp, full);
372
- }
373
- } catch (error) {
374
- await rm(temp, { force: true }).catch(() => {});
375
- throw error;
376
- }
377
- }
378
-
379
- function assertNoResolvedPatchCollisions(operations) {
380
- const owners = new Map();
381
- for (const operation of operations) {
382
- const paths = operation.source === operation.target
383
- ? [operation.source]
384
- : [operation.source, operation.target].filter(Boolean);
385
- for (const full of paths) {
386
- const key = process.platform === "win32" ? String(full).toLowerCase() : String(full);
387
- const previous = owners.get(key);
388
- if (previous && previous !== operation) throw new Error(`patch operations resolve to the same path: ${full}`);
389
- owners.set(key, operation);
390
- }
391
- }
392
- }
393
-
394
- export async function commitPatchTransaction(operations, options = {}) {
395
- const move = options.rename || rename;
396
- const remove = options.remove || rm;
397
- const staged = [];
398
- const committed = [];
399
- try {
400
- for (const operation of operations) {
401
- if (operation.content === undefined) continue;
402
- await mkdir(dirname(operation.target), { recursive: true });
403
- const temp = join(dirname(operation.target), `.${basename(operation.target)}.mbm-patch-${process.pid}-${randomBytes(6).toString("hex")}.tmp`);
404
- await writeFlushedText(temp, operation.content, operation.mode);
405
- staged.push({ operation, temp });
406
- }
407
-
408
- for (const operation of operations) {
409
- if (operation.source) {
410
- const current = await readUtf8File(operation.source);
411
- if (sha256(current) !== operation.originalHash) throw new Error(`patch source changed during apply: ${operation.source}`);
412
- }
413
- if (operation.kind === "add" || operation.kind === "move") {
414
- if (await lstat(operation.target).catch(() => null)) throw new Error(`patch target appeared during apply: ${operation.target}`);
415
- }
416
- }
417
-
418
- for (const operation of operations) {
419
- let backup = null;
420
- if (operation.source) {
421
- backup = join(dirname(operation.source), `.${basename(operation.source)}.mbm-backup-${process.pid}-${randomBytes(6).toString("hex")}`);
422
- await move(operation.source, backup);
423
- }
424
- const record = { operation, backup, targetCreated: false };
425
- committed.push(record);
426
- const stage = staged.find((item) => item.operation === operation);
427
- if (stage) {
428
- await move(stage.temp, operation.target);
429
- record.targetCreated = true;
430
- }
431
- }
432
- } catch (error) {
433
- const recoveryFailures = [];
434
- for (const item of [...committed].reverse()) {
435
- if (item.targetCreated) {
436
- try { await remove(item.operation.target, { force: true }); } catch (failure) { recoveryFailures.push(failure); }
437
- }
438
- if (item.backup) {
439
- try { await move(item.backup, item.operation.source); } catch (failure) { recoveryFailures.push(failure); }
440
- }
441
- }
442
- recoveryFailures.push(...await removePatchArtifacts(staged.map((item) => item.temp), remove));
443
- if (recoveryFailures.length) {
444
- throw new Error(`patch transaction failed and recovery was incomplete (${recoveryFailures.length} recovery operation(s) failed); inspect the workspace before retrying`, { cause: error });
445
- }
446
- throw error;
447
- }
448
-
449
- const cleanupFailures = await removePatchArtifacts([
450
- ...staged.map((item) => item.temp),
451
- ...committed.map((item) => item.backup).filter(Boolean),
452
- ], remove);
453
- return {
454
- warnings: cleanupFailures.length
455
- ? [`Patch committed, but ${cleanupFailures.length} internal transaction artifact(s) could not be removed; inspect affected directories for .mbm-backup-* or .mbm-patch-* files.`]
456
- : [],
457
- };
380
+ export function atomicWriteText(full, content, existing = null, options = {}) {
381
+ return commitAtomicText(full, content, existing, { ...options, readText: options.readText || readUtf8File });
458
382
  }
459
383
 
460
- async function removePatchArtifacts(paths, remove) {
461
- const failures = [];
462
- for (const path of paths) {
463
- try { await remove(path, { force: true }); } catch (error) { failures.push(error); }
464
- }
465
- return failures;
384
+ export function commitPatchTransaction(operations, options = {}) {
385
+ return commitPatchOperations(operations, { ...options, readText: options.readText || readUtf8File });
466
386
  }
467
387
 
468
- function assertTextSize(content, label) {
388
+ function assertTextSize(content) {
469
389
  const bytes = Buffer.byteLength(content);
470
- if (bytes > MAX_WRITE_BYTES) throw new Error(`patched file exceeds maximum size for ${label} (${bytes} > ${MAX_WRITE_BYTES})`);
390
+ if (bytes > MAX_WRITE_BYTES) throw new BridgeError("limit_exceeded", `patched file exceeds maximum size (${bytes} > ${MAX_WRITE_BYTES})`, { details: { reason: "write_limit", bytes, maximum_bytes: MAX_WRITE_BYTES } });
471
391
  }
472
392
 
473
393
  function countOccurrences(content, needle) {
@@ -480,9 +400,6 @@ function countOccurrences(content, needle) {
480
400
  return count;
481
401
  }
482
402
 
483
- export function sha256(value) {
484
- return createHash("sha256").update(String(value)).digest("hex");
485
- }
486
403
 
487
404
  function detectImageMime(buffer) {
488
405
  if (buffer.length >= 8 && buffer.subarray(0, 8).equals(Buffer.from([0x89, 0x50, 0x4e, 0x47, 0x0d, 0x0a, 0x1a, 0x0a]))) return "image/png";