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
@@ -2,7 +2,7 @@
2
2
  {
3
3
  "name": "server_info",
4
4
  "title": "Server information",
5
- "description": "Return authenticated account authority, effective policy/tools, daemon capability ceiling, runtime metadata, and protocol status. Treat authorization.effective_policy and authorization.effective_tools as authoritative; daemon.policy is only a ceiling.",
5
+ "description": "Return live authorization and daemon status. Use detail=summary for routine version, authority, readiness, relay, capacity, and timeout checks; use the default/full projection for exact tool membership, OAuth metadata, account identity, and detailed observability.",
6
6
  "availability": "always",
7
7
  "annotations": {
8
8
  "readOnlyHint": true,
@@ -12,13 +12,24 @@
12
12
  },
13
13
  "inputSchema": {
14
14
  "type": "object",
15
+ "properties": {
16
+ "detail": {
17
+ "type": "string",
18
+ "enum": [
19
+ "summary",
20
+ "full"
21
+ ],
22
+ "default": "full",
23
+ "description": "Use summary for compact health/authority status; use full for complete tool, OAuth, and observability diagnostics."
24
+ }
25
+ },
15
26
  "additionalProperties": false
16
27
  }
17
28
  },
18
29
  {
19
30
  "name": "project_overview",
20
31
  "title": "Project overview",
21
- "description": "Summarize the connected workspace and repository. Remote responses report the authenticated account effective policy/tools at policy and tools, with the daemon capability ceiling preserved separately as daemonPolicy and daemonTools.",
32
+ "description": "Summarize the connected workspace, repository root, top-level entries, and project-facing runtime context. Use detail=summary for a compact inventory/readiness projection; use full for exact tool membership, account authority detail, and complete top-level metadata.",
22
33
  "availability": "always",
23
34
  "annotations": {
24
35
  "readOnlyHint": true,
@@ -28,13 +39,24 @@
28
39
  },
29
40
  "inputSchema": {
30
41
  "type": "object",
42
+ "properties": {
43
+ "detail": {
44
+ "type": "string",
45
+ "enum": [
46
+ "summary",
47
+ "full"
48
+ ],
49
+ "default": "full",
50
+ "description": "Use summary for compact workspace/inventory and authority counts; use full for exact tools, account identity, routing detail, and per-entry paths/sizes."
51
+ }
52
+ },
31
53
  "additionalProperties": false
32
54
  }
33
55
  },
34
56
  {
35
57
  "name": "session_bootstrap",
36
58
  "title": "Load session bootstrap",
37
- "description": "Load built-in working agreements, bounded automatic project facts, user-global and root workspace instructions, and capability refresh metadata for MCP session initialization.",
59
+ "description": "Load built-in working agreements, bounded automatic project facts, authority-permitted user-global guidance, root workspace instructions, and capability refresh metadata. Delegated remote accounts do not read the daemon owner's home-scoped agent config unless their effective authority permits unrestricted paths. Clients call it explicitly when refreshed authority-scoped project context is needed; MCP 2026-07-28 has no initialization-time compatibility adapter.",
38
60
  "availability": "always",
39
61
  "annotations": {
40
62
  "readOnlyHint": true,
@@ -57,7 +79,7 @@
57
79
  {
58
80
  "name": "resolve_task_capabilities",
59
81
  "title": "Resolve task capabilities",
60
- "description": "Rescan built-in and automatic project context, local instruction files, skills, explicit and automatic package commands, installed applications, and browser capability metadata; rank the capabilities relevant to the current task and optionally load the best skill.",
82
+ "description": "Rescan authority-permitted task-relevant instructions, skills, registered commands, installed applications, browser metadata, and the effective tool catalog. Delegated remote accounts remain confined to project-scoped capability context unless their effective authority permits unrestricted paths. Return bounded set-level execution routes, ranked tools, routing ambiguity, and an optional selected skill. Pass known_refresh_fingerprint to omit unchanged static instructions while recomputing task-specific ranking. The result is advisory: direct Bash and every other policy-allowed tool remain available.",
61
83
  "availability": "always",
62
84
  "annotations": {
63
85
  "readOnlyHint": true,
@@ -88,6 +110,12 @@
88
110
  "include_selected_skill": {
89
111
  "type": "boolean",
90
112
  "default": true
113
+ },
114
+ "known_refresh_fingerprint": {
115
+ "type": "string",
116
+ "pattern": "^[a-f0-9]{64}$",
117
+ "maxLength": 64,
118
+ "description": "Previous refresh fingerprint. When it still matches, unchanged static instructions are omitted while task-specific ranking is recomputed."
91
119
  }
92
120
  },
93
121
  "required": [
@@ -99,7 +127,7 @@
99
127
  "name": "list_local_applications",
100
128
  "title": "List local applications",
101
129
  "description": "Discover installed local applications and launchers without reading their document contents.",
102
- "availability": "full",
130
+ "availability": "always",
103
131
  "annotations": {
104
132
  "readOnlyHint": true,
105
133
  "destructiveHint": false,
@@ -127,7 +155,7 @@
127
155
  {
128
156
  "name": "open_local_application",
129
157
  "title": "Open local application",
130
- "description": "Open a named local application, optionally with a document or URL target, using the operating system launcher.",
158
+ "description": "Open a named local application, optionally with a document or URL target, using the operating system launcher. Launch is non-idempotent: cancellation is checked immediately before invoking the launcher, but once the launcher process invocation is attempted, timeout, cancellation, or response loss is an unknown launch outcome and callers should inspect application state before retrying. That fixed ambiguous settlement is returned as a public, non-retryable MCP error. Foreground execution is limited to 60 seconds; use process sessions or managed jobs for longer work.",
131
159
  "availability": "full",
132
160
  "annotations": {
133
161
  "readOnlyHint": false,
@@ -155,7 +183,7 @@
155
183
  "timeout_seconds": {
156
184
  "type": "integer",
157
185
  "minimum": 1,
158
- "maximum": 120,
186
+ "maximum": 60,
159
187
  "default": 30
160
188
  }
161
189
  },
@@ -167,7 +195,7 @@
167
195
  {
168
196
  "name": "inspect_local_application",
169
197
  "title": "Inspect local application UI",
170
- "description": "Inspect a bounded macOS Accessibility tree for a running application. Requires local Accessibility permission and never executes arbitrary AppleScript supplied by the caller.",
198
+ "description": "Inspect a bounded macOS Accessibility tree for a running application. Requires local Accessibility permission and never executes arbitrary AppleScript supplied by the caller. Foreground execution is limited to 60 seconds; use process sessions or managed jobs for longer work.",
171
199
  "availability": "full",
172
200
  "annotations": {
173
201
  "readOnlyHint": true,
@@ -208,7 +236,7 @@
208
236
  "timeout_seconds": {
209
237
  "type": "integer",
210
238
  "minimum": 1,
211
- "maximum": 120,
239
+ "maximum": 60,
212
240
  "default": 30
213
241
  }
214
242
  },
@@ -220,7 +248,7 @@
220
248
  {
221
249
  "name": "operate_local_application",
222
250
  "title": "Operate local application UI",
223
- "description": "Perform a structured macOS Accessibility action on a matched UI element. Text can be supplied through a registered local resource so secret values do not enter MCP arguments.",
251
+ "description": "Perform a structured macOS Accessibility action on a matched UI element. check/uncheck are desired-state operations: they read the current checkbox/radio state at dispatch time, skip input when already satisfied, and otherwise issue at most one AXPress (uncheck is checkbox-only). Text can be supplied through a registered local resource so secret values do not enter MCP arguments. keystroke focuses the matched AX target and delivers surrogate-safe Unicode chunks with public PID-scoped CoreGraphics keyboard events; key_press delivers a layout-independent special key (Enter, Tab, Escape, Backspace, Delete, arrows, Home/End, PageUp/PageDown, or Space) with optional Shift+, likewise PID-scoped and without making the application frontmost. Both return input_transport=public-cgevent-pid; Meta/Control/Alt and character shortcuts are deliberately unsupported because inactive-AppKit validation did not establish reliable command-shortcut semantics. Cancellation is re-checked after asynchronous local-resource resolution and before invoking the fixed JXA mutation helper. Explicit JXA selector/geometry/action preflight errors remain definite, but once the mutating osascript invocation is attempted, timeout, cancellation, missing output, or malformed helper settlement is an unknown action outcome and must not be replayed blindly. Fixed launch/Accessibility/visual ambiguous settlements are returned as public, non-retryable MCP errors. Foreground execution is limited to 60 seconds; use process sessions or managed jobs for longer work.",
224
252
  "availability": "full",
225
253
  "annotations": {
226
254
  "readOnlyHint": false,
@@ -239,13 +267,17 @@
239
267
  },
240
268
  "action": {
241
269
  "type": "string",
270
+ "description": "Structured Accessibility action. check/uncheck are idempotent desired-state actions; check accepts checkbox or radio-button targets, while uncheck accepts checkbox targets.",
242
271
  "enum": [
243
272
  "activate",
244
273
  "click",
274
+ "check",
275
+ "uncheck",
245
276
  "set_value",
246
277
  "focus",
247
278
  "press",
248
- "keystroke"
279
+ "keystroke",
280
+ "key_press"
249
281
  ]
250
282
  },
251
283
  "selector": {
@@ -291,6 +323,11 @@
291
323
  "type": "string",
292
324
  "pattern": "^[a-z][a-z0-9._-]{0,63}$"
293
325
  },
326
+ "key": {
327
+ "type": "string",
328
+ "maxLength": 100,
329
+ "description": "Required for key_press. One layout-independent special key: Enter, Tab, Escape, Backspace, Delete, ArrowLeft, ArrowUp, ArrowRight, ArrowDown, Home, End, PageUp, PageDown, or Space, optionally prefixed with Shift+."
330
+ },
294
331
  "include_menus": {
295
332
  "type": "boolean",
296
333
  "default": false,
@@ -305,7 +342,7 @@
305
342
  "timeout_seconds": {
306
343
  "type": "integer",
307
344
  "minimum": 1,
308
- "maximum": 120,
345
+ "maximum": 60,
309
346
  "default": 30
310
347
  }
311
348
  },
@@ -315,10 +352,489 @@
315
352
  ]
316
353
  }
317
354
  },
355
+ {
356
+ "name": "computer_observe",
357
+ "title": "Observe computer surface",
358
+ "description": "Create a snapshot-bound browser or desktop observation. Browser mode combines executable DOM refs with a real Chromium Accessibility snapshot, layout geometry, document epoch, and an optional screenshot captured through the same bounded CDP session when available; high-confidence AX nodes are fused back to executable action_ref values, while executable DOM candidates are salience-ranked globally across accessible frames. Cancellation is checked again after asynchronous capture and before snapshot publication, so a cancelled observe cannot leave an actionable snapshot_id in the bounded store. Use computer_act with the exact snapshot_id instead of carrying selectors across changing UI state. timeout_seconds is one end-to-end observation budget; compound screenshot/semantic/window-revalidation stages consume the remaining deadline rather than restarting it.",
359
+ "availability": "full",
360
+ "annotations": {
361
+ "readOnlyHint": false,
362
+ "destructiveHint": false,
363
+ "idempotentHint": false,
364
+ "openWorldHint": true
365
+ },
366
+ "inputSchema": {
367
+ "type": "object",
368
+ "additionalProperties": false,
369
+ "properties": {
370
+ "surface": {
371
+ "type": "string",
372
+ "enum": [
373
+ "browser",
374
+ "application"
375
+ ]
376
+ },
377
+ "tab_id": {
378
+ "type": "integer",
379
+ "minimum": 1,
380
+ "description": "Browser tab to observe. Omit to use the active tab."
381
+ },
382
+ "application": {
383
+ "type": "string",
384
+ "minLength": 1,
385
+ "maxLength": 300,
386
+ "description": "Required when surface=application."
387
+ },
388
+ "include_screenshot": {
389
+ "type": "boolean",
390
+ "default": true,
391
+ "description": "Include a browser viewport screenshot or, for macOS application observations, a best-effort target-window screenshot. Application screenshot failure does not discard Accessibility state."
392
+ },
393
+ "screenshot_format": {
394
+ "type": "string",
395
+ "enum": [
396
+ "png",
397
+ "jpeg"
398
+ ],
399
+ "default": "png"
400
+ },
401
+ "screenshot_quality": {
402
+ "type": "integer",
403
+ "minimum": 1,
404
+ "maximum": 100,
405
+ "default": 90
406
+ },
407
+ "max_elements": {
408
+ "type": "integer",
409
+ "minimum": 1,
410
+ "maximum": 1000,
411
+ "default": 300
412
+ },
413
+ "max_ax_nodes": {
414
+ "type": "integer",
415
+ "minimum": 1,
416
+ "maximum": 2000,
417
+ "default": 600,
418
+ "description": "Browser only. Maximum Chromium Accessibility nodes retained after salience ranking."
419
+ },
420
+ "max_frames": {
421
+ "type": "integer",
422
+ "minimum": 1,
423
+ "maximum": 64,
424
+ "default": 32,
425
+ "description": "Browser only. Maximum CDP frame documents considered for the Accessibility snapshot."
426
+ },
427
+ "ax_depth": {
428
+ "type": "integer",
429
+ "minimum": 1,
430
+ "maximum": 16,
431
+ "default": 12,
432
+ "description": "Browser only. Maximum Chromium Accessibility tree depth requested per frame."
433
+ },
434
+ "focus_query": {
435
+ "type": "string",
436
+ "maxLength": 1000,
437
+ "description": "Optional task/target hint used only to rank bounded browser DOM/Chromium Accessibility or macOS application Accessibility observations; it never becomes a selector or action. Observation metadata reports whether the bounded scan matched the query and whether absence was searched exhaustively."
438
+ },
439
+ "max_depth": {
440
+ "type": "integer",
441
+ "minimum": 1,
442
+ "maximum": 12,
443
+ "default": 6,
444
+ "description": "Application accessibility traversal depth."
445
+ },
446
+ "include_values": {
447
+ "type": "boolean",
448
+ "default": false
449
+ },
450
+ "include_menus": {
451
+ "type": "boolean",
452
+ "default": false,
453
+ "description": "Application only. Include menu subtrees."
454
+ },
455
+ "all_frames": {
456
+ "type": "boolean",
457
+ "default": true,
458
+ "description": "Browser only. Inspect accessible frames within the aggregate element budget."
459
+ },
460
+ "timeout_seconds": {
461
+ "type": "integer",
462
+ "minimum": 1,
463
+ "maximum": 60,
464
+ "default": 30
465
+ }
466
+ },
467
+ "required": [
468
+ "surface"
469
+ ]
470
+ }
471
+ },
472
+ {
473
+ "name": "computer_act",
474
+ "title": "Act on computer snapshot",
475
+ "description": "Perform one snapshot-bound browser or desktop action and then observe/verify the effect. Semantic targets use refs from computer_observe. Browser click/double-click/hover/scroll may use normalized_viewport coordinates from the same navigation-coherent CDP screenshot; browser drag uses a source target plus destination from that same snapshot and requires ref-to-ref or point-to-point evidence. macOS application drag uses two normalized points from the same window screenshot, and application scroll uses one normalized point plus bounded wheel deltas; both require the opt-in snapshot-bound native pixel backend and do not guess Accessibility fallbacks. Point dispatch revalidates the exact screenshot immediately before native/trusted input; browser ref drag revalidates both trusted backend identities and in-viewport geometry before any drag input; browser ref scroll revalidates the anchor identity and requires its content quad to remain in viewport before one trusted wheel event. Browser reload/back/forward also bind the observed tab URL, document epoch, and current history-list slot and revalidate those authorities immediately before the navigation mutation; stale or unavailable history authority fails before dispatch. Results distinguish dispatch_status from effect_status; unknown outcomes must be inspected before retrying. dispatch_status=unknown is driven only by fixed lower-layer mutation-settlement markers, so a resource or preflight timeout before mutation remains a definite failure. Deterministic post-observation checks expose `verification.post_checks[].evidence_source` (`browser_tab_state`, `browser_semantic`, `application_process`, `application_workspace`, `application_accessibility`, or `screenshot`) so callers can distinguish state evidence from pixel evidence. Browser post-state defaults to a compact summary plus bounded semantic delta; post_screenshot=auto avoids redundant images unless visual evidence or ambiguous dispatch requires one. Request post_observation_detail=full only when the full tree is needed. timeout_seconds is one end-to-end action budget spanning preflight, the single dispatch attempt, verification, and post-observation; internal stages receive only the remaining deadline.",
476
+ "availability": "full",
477
+ "annotations": {
478
+ "readOnlyHint": false,
479
+ "destructiveHint": true,
480
+ "idempotentHint": false,
481
+ "openWorldHint": true
482
+ },
483
+ "inputSchema": {
484
+ "type": "object",
485
+ "additionalProperties": false,
486
+ "properties": {
487
+ "surface": {
488
+ "type": "string",
489
+ "enum": [
490
+ "browser",
491
+ "application"
492
+ ]
493
+ },
494
+ "snapshot_id": {
495
+ "type": "string",
496
+ "pattern": "^cu_[A-Za-z0-9_-]{8,80}$"
497
+ },
498
+ "action": {
499
+ "type": "string",
500
+ "description": "Surface action. For application refs, check/uncheck are idempotent desired-state actions verified by post-observation checked state; their required target state cannot be weakened by expect. Application key_press is ref-only and sends one layout-independent special key, optionally Shift-modified, through PID-scoped CoreGraphics without activating the app.",
501
+ "enum": [
502
+ "navigate",
503
+ "reload",
504
+ "back",
505
+ "forward",
506
+ "click",
507
+ "double_click",
508
+ "hover",
509
+ "drag",
510
+ "scroll",
511
+ "fill",
512
+ "type_text",
513
+ "select",
514
+ "check",
515
+ "uncheck",
516
+ "focus",
517
+ "press",
518
+ "submit",
519
+ "scroll_into_view",
520
+ "activate",
521
+ "set_value",
522
+ "keystroke",
523
+ "key_press"
524
+ ]
525
+ },
526
+ "target": {
527
+ "oneOf": [
528
+ {
529
+ "type": "object",
530
+ "additionalProperties": false,
531
+ "properties": {
532
+ "ref": {
533
+ "type": "string",
534
+ "minLength": 1,
535
+ "maxLength": 100
536
+ }
537
+ },
538
+ "required": [
539
+ "ref"
540
+ ]
541
+ },
542
+ {
543
+ "type": "object",
544
+ "additionalProperties": false,
545
+ "properties": {
546
+ "point": {
547
+ "type": "object",
548
+ "additionalProperties": false,
549
+ "properties": {
550
+ "x": {
551
+ "type": "number",
552
+ "minimum": 0,
553
+ "exclusiveMaximum": 1
554
+ },
555
+ "y": {
556
+ "type": "number",
557
+ "minimum": 0,
558
+ "exclusiveMaximum": 1
559
+ },
560
+ "space": {
561
+ "type": "string",
562
+ "enum": [
563
+ "normalized_viewport"
564
+ ],
565
+ "default": "normalized_viewport"
566
+ }
567
+ },
568
+ "required": [
569
+ "x",
570
+ "y"
571
+ ]
572
+ }
573
+ },
574
+ "required": [
575
+ "point"
576
+ ]
577
+ }
578
+ ],
579
+ "description": "Snapshot-bound semantic ref; a normalized point is also allowed for browser click/double-click/hover/drag/scroll against the exact navigation-coherent CDP screenshot, and for macOS application click/double-click/drag/scroll against the exact window screenshot. Application click point delivery may prefer one unique addressable Accessibility control under the point. Application double_click is deliberately point-only and always uses one snapshot-bound native pixel settlement; it is never approximated by repeated AXPress. Arbitrary/custom-drawn single-click pixels plus all application double-click, drag, and scroll points require the snapshot's opt-in native pixel backend. For drag this is the source endpoint; for scroll this is the wheel anchor. Omit only for targetless actions."
580
+ },
581
+ "destination": {
582
+ "oneOf": [
583
+ {
584
+ "type": "object",
585
+ "additionalProperties": false,
586
+ "properties": {
587
+ "ref": {
588
+ "type": "string",
589
+ "minLength": 1,
590
+ "maxLength": 100
591
+ }
592
+ },
593
+ "required": [
594
+ "ref"
595
+ ]
596
+ },
597
+ {
598
+ "type": "object",
599
+ "additionalProperties": false,
600
+ "properties": {
601
+ "point": {
602
+ "type": "object",
603
+ "additionalProperties": false,
604
+ "properties": {
605
+ "x": {
606
+ "type": "number",
607
+ "minimum": 0,
608
+ "exclusiveMaximum": 1
609
+ },
610
+ "y": {
611
+ "type": "number",
612
+ "minimum": 0,
613
+ "exclusiveMaximum": 1
614
+ },
615
+ "space": {
616
+ "type": "string",
617
+ "enum": [
618
+ "normalized_viewport"
619
+ ],
620
+ "default": "normalized_viewport"
621
+ }
622
+ },
623
+ "required": [
624
+ "x",
625
+ "y"
626
+ ]
627
+ }
628
+ },
629
+ "required": [
630
+ "point"
631
+ ]
632
+ }
633
+ ],
634
+ "description": "Drag destination from the same computer snapshot. Browser drag requires ref-to-ref or normalized-point-to-point evidence; mixed evidence types are rejected. macOS application drag currently requires normalized point source and destination from the same window screenshot and the snapshot-bound native pixel backend."
635
+ },
636
+ "delta_x": {
637
+ "type": "number",
638
+ "minimum": -10000,
639
+ "maximum": 10000,
640
+ "default": 0,
641
+ "description": "Browser or macOS application scroll only. Horizontal trusted wheel delta in logical pixels; positive values scroll right. At least one of delta_x or delta_y must be non-zero."
642
+ },
643
+ "delta_y": {
644
+ "type": "number",
645
+ "minimum": -10000,
646
+ "maximum": 10000,
647
+ "default": 0,
648
+ "description": "Browser or macOS application scroll only. Vertical trusted wheel delta in logical pixels; positive values scroll down. At least one of delta_x or delta_y must be non-zero."
649
+ },
650
+ "url": {
651
+ "type": "string",
652
+ "maxLength": 32768,
653
+ "description": "Required for browser navigate."
654
+ },
655
+ "value": {
656
+ "type": "string",
657
+ "maxLength": 131072
658
+ },
659
+ "value_resource": {
660
+ "type": "string",
661
+ "pattern": "^[a-z][a-z0-9._-]{0,63}$"
662
+ },
663
+ "key": {
664
+ "type": "string",
665
+ "maxLength": 100,
666
+ "description": "Browser press key, or application key_press special key. Application supports Enter, Tab, Escape, Backspace, Delete, ArrowLeft, ArrowUp, ArrowRight, ArrowDown, Home, End, PageUp, PageDown, Space, with optional Shift+."
667
+ },
668
+ "wait_for": {
669
+ "type": "string",
670
+ "enum": [
671
+ "none",
672
+ "domcontentloaded",
673
+ "complete"
674
+ ],
675
+ "default": "none"
676
+ },
677
+ "input_mode": {
678
+ "type": "string",
679
+ "enum": [
680
+ "auto",
681
+ "trusted",
682
+ "dom"
683
+ ],
684
+ "default": "auto",
685
+ "description": "Browser only."
686
+ },
687
+ "element_timeout_seconds": {
688
+ "type": "integer",
689
+ "minimum": 1,
690
+ "maximum": 60,
691
+ "default": 10
692
+ },
693
+ "timeout_seconds": {
694
+ "type": "integer",
695
+ "minimum": 1,
696
+ "maximum": 60,
697
+ "default": 30
698
+ },
699
+ "verify_timeout_seconds": {
700
+ "type": "integer",
701
+ "minimum": 1,
702
+ "maximum": 60,
703
+ "default": 5,
704
+ "description": "Bounded effect-verification window. Browser conditions use the browser wait backend; application expectations may retry at most nine read-only post-action observations with bounded backoff, and each retry capture is capped by the remaining verification budget. Verification retries never replay the dispatched action; post-dispatch cancellation or incomplete readback makes unsettled effect evidence unknown rather than retryable."
705
+ },
706
+ "include_post_screenshot": {
707
+ "type": "boolean",
708
+ "description": "Legacy explicit boolean override for post_screenshot: true maps to always and false maps to never. Mutually exclusive with post_screenshot."
709
+ },
710
+ "post_screenshot": {
711
+ "type": "string",
712
+ "enum": [
713
+ "auto",
714
+ "always",
715
+ "never"
716
+ ],
717
+ "default": "auto",
718
+ "description": "auto includes the post-action screenshot only for snapshot-bound visual-point actions, explicit expect.visual_change, or an unknown dispatch outcome on either browser or application surfaces; always/never force the choice. Mutually exclusive with include_post_screenshot."
719
+ },
720
+ "post_max_elements": {
721
+ "type": "integer",
722
+ "minimum": 1,
723
+ "maximum": 1000,
724
+ "default": 180
725
+ },
726
+ "post_max_ax_nodes": {
727
+ "type": "integer",
728
+ "minimum": 1,
729
+ "maximum": 2000,
730
+ "default": 180,
731
+ "description": "Browser only. Bound Chromium Accessibility nodes in the automatic post-action observation."
732
+ },
733
+ "post_max_depth": {
734
+ "type": "integer",
735
+ "minimum": 1,
736
+ "maximum": 12,
737
+ "default": 6,
738
+ "description": "Application only. Accessibility depth for the new post-action observation. It does not change target dispatch identity; dispatch and preflight reuse the source snapshot's max_depth."
739
+ },
740
+ "post_observation_detail": {
741
+ "type": "string",
742
+ "enum": [
743
+ "summary",
744
+ "full"
745
+ ],
746
+ "description": "Return a compact post-state summary or the full post-action semantic observation. Both browser and application surfaces default to summary; application summaries retain a bounded set of actionable post-snapshot refs. Request full only when the complete tree is required."
747
+ },
748
+ "include_menus": {
749
+ "type": "boolean",
750
+ "default": false,
751
+ "description": "Application only. Include menu trees in the new post-action observation. It does not change target dispatch identity; observe with include_menus=true when the source target itself is in a menu."
752
+ },
753
+ "expect": {
754
+ "type": "object",
755
+ "additionalProperties": false,
756
+ "properties": {
757
+ "url_contains": {
758
+ "type": "string",
759
+ "minLength": 1,
760
+ "maxLength": 32768
761
+ },
762
+ "url_changed": {
763
+ "type": "boolean"
764
+ },
765
+ "semantic_change": {
766
+ "type": "boolean",
767
+ "description": "Explicitly require the bounded semantic observation fingerprint to change or remain unchanged."
768
+ },
769
+ "visual_change": {
770
+ "type": "boolean",
771
+ "description": "Explicitly require the screenshot SHA-256 fingerprint to change or remain unchanged. Requires screenshots in both the referenced and post-action observations; animations can satisfy this condition, so use it only when visual change is the intended effect."
772
+ },
773
+ "text": {
774
+ "type": "string",
775
+ "minLength": 1,
776
+ "maxLength": 4000
777
+ },
778
+ "load_state": {
779
+ "type": "string",
780
+ "enum": [
781
+ "domcontentloaded",
782
+ "complete"
783
+ ]
784
+ },
785
+ "target_state": {
786
+ "type": "string",
787
+ "enum": [
788
+ "attached",
789
+ "detached",
790
+ "visible",
791
+ "hidden",
792
+ "enabled",
793
+ "editable",
794
+ "checked",
795
+ "unchecked"
796
+ ]
797
+ },
798
+ "frontmost": {
799
+ "type": "boolean"
800
+ },
801
+ "target_exists": {
802
+ "type": "boolean"
803
+ },
804
+ "target_enabled": {
805
+ "type": "boolean"
806
+ },
807
+ "target_focused": {
808
+ "type": "boolean"
809
+ },
810
+ "target_checked": {
811
+ "type": "boolean"
812
+ },
813
+ "target_selected": {
814
+ "type": "boolean"
815
+ },
816
+ "target_expanded": {
817
+ "type": "boolean"
818
+ },
819
+ "target_value_matches": {
820
+ "type": "boolean",
821
+ "description": "Application set_value only. Compare the post-action AXValue with the value being written inside the local application backend and return only a Boolean result. Non-sensitive set_value actions require this to remain true; sensitive targets do not support this readback."
822
+ }
823
+ },
824
+ "description": "Browser expectations use url/text/load/target_state and optional explicit semantic_change/visual_change checks; application expectations use frontmost and semantic target state fields including enabled/focused/checked/selected/expanded, plus private target_value_matches readback for non-sensitive set_value actions."
825
+ }
826
+ },
827
+ "required": [
828
+ "surface",
829
+ "snapshot_id",
830
+ "action"
831
+ ]
832
+ }
833
+ },
318
834
  {
319
835
  "name": "browser_status",
320
836
  "title": "Browser bridge status",
321
- "description": "Start or inspect the loopback bridge for the Chromium profile where the extension is installed. Machine Bridge does not launch Playwright or another browser process, but cannot infer whether that profile is the user's daily or isolated profile; status reports authenticated extension version, protocol, capabilities, and reload state.",
837
+ "description": "Start or inspect the loopback bridge for the Chromium profile where the extension is installed. Machine Bridge does not launch Playwright or another browser process, but cannot infer whether that profile is the user's daily or isolated profile; status reports authenticated extension version, protocol, capabilities, and reload state. Concurrent callers may share one broker-startup operation, but each caller re-checks its own cancellation after shared startup settles, so cancelling one request does not cancel startup for another waiter or return completion to the cancelled caller.",
322
838
  "availability": "full",
323
839
  "annotations": {
324
840
  "readOnlyHint": false,
@@ -334,7 +850,7 @@
334
850
  {
335
851
  "name": "pair_browser_extension",
336
852
  "title": "Pair browser extension",
337
- "description": "Open the local pairing page and return the packaged unpacked-extension path for installation in the user's intended Chromium profile. Pairing is persisted only after an acknowledged version/capability handshake.",
853
+ "description": "Open the local pairing page and return the packaged unpacked-extension path for installation in the user's intended Chromium profile. Pairing is persisted only after an acknowledged version/capability handshake. Opening the pairing page is non-idempotent: cancellation is checked immediately before the OS launcher, but once that launcher invocation is attempted, timeout/cancellation/response loss is an unknown launch outcome and callers should inspect the browser before opening it again. That fixed ambiguous settlement is returned as a public, non-retryable MCP error.",
338
854
  "availability": "full",
339
855
  "annotations": {
340
856
  "readOnlyHint": false,
@@ -356,7 +872,7 @@
356
872
  {
357
873
  "name": "browser_list_tabs",
358
874
  "title": "List browser tabs",
359
- "description": "List tabs from the paired user's existing Chromium browser profile.",
875
+ "description": "Read the tab inventory from the paired existing Chromium profile without creating, activating, or closing a tab. Use browser_manage_tabs for tab mutations. Foreground execution is limited to 60 seconds; use process sessions or managed jobs for longer work.",
360
876
  "availability": "full",
361
877
  "annotations": {
362
878
  "readOnlyHint": true,
@@ -379,7 +895,7 @@
379
895
  "timeout_seconds": {
380
896
  "type": "integer",
381
897
  "minimum": 1,
382
- "maximum": 120,
898
+ "maximum": 60,
383
899
  "default": 30
384
900
  }
385
901
  }
@@ -388,7 +904,7 @@
388
904
  {
389
905
  "name": "browser_manage_tabs",
390
906
  "title": "Manage browser tabs",
391
- "description": "Create, activate, or close tabs in the paired existing browser profile.",
907
+ "description": "Create, activate, or close tabs in the paired existing Chromium profile. Tab mutations are non-idempotent: if Chrome rejects a mutation request after invocation, or the broker loses the extension response after attempting dispatch, the outcome is reported as unknown and callers should inspect browser_list_tabs before retrying. If a completed mutating extension result cannot be serialized or fit within the bounded response budget, that result settlement is also unknown and must not be used as evidence that activation/close/create did not run. Fixed ambiguous browser settlements are returned as public, non-retryable MCP errors. Activation is verified between its two mutation stages: after tab activation resolves, the target is re-read and must still be active before its freshly observed current window is focused; after focus resolves, the target is re-read again and success returns only the final verified tab provenance. Concurrent tab/window moves or user tab switches are reported as partial completion with inspection guidance and are never automatically re-activated or re-focused. Cancellation is re-checked after asynchronous tab lookup and before each later mutation stage; a stage not yet started is skipped, while an earlier completed stage is not rolled back. Use browser_list_tabs when only a read-only tab inventory is needed. Foreground execution is limited to 60 seconds; use process sessions or managed jobs for longer work.",
392
908
  "availability": "full",
393
909
  "annotations": {
394
910
  "readOnlyHint": false,
@@ -425,7 +941,7 @@
425
941
  "timeout_seconds": {
426
942
  "type": "integer",
427
943
  "minimum": 1,
428
- "maximum": 120,
944
+ "maximum": 60,
429
945
  "default": 30
430
946
  }
431
947
  },
@@ -437,7 +953,7 @@
437
953
  {
438
954
  "name": "browser_get_source",
439
955
  "title": "Read browser page source",
440
- "description": "Read bounded serialized current DOM HTML from the active or selected browser tab. max_bytes is one aggregate budget across at most 64 accessible frames, with explicit frame, node, and byte truncation metadata.",
956
+ "description": "Read bounded raw serialized DOM HTML from the active or selected tab only when source markup is genuinely required. Raw source can contain hidden bootstrap, session, account, authentication, or other sensitive data that is not visible in the rendered page; treat the entire result as sensitive and do not use it for routine semantic inspection. Prefer browser_inspect_page for semantic elements, actionability, reusable refs, and structured interaction planning. max_bytes is one aggregate budget across at most 64 accessible frames. Foreground execution is limited to 60 seconds; use process sessions or managed jobs for longer work.",
441
957
  "availability": "full",
442
958
  "annotations": {
443
959
  "readOnlyHint": true,
@@ -462,7 +978,7 @@
462
978
  "timeout_seconds": {
463
979
  "type": "integer",
464
980
  "minimum": 1,
465
- "maximum": 120,
981
+ "maximum": 60,
466
982
  "default": 30
467
983
  },
468
984
  "frame_id": {
@@ -479,7 +995,7 @@
479
995
  {
480
996
  "name": "browser_inspect_page",
481
997
  "title": "Inspect browser page",
482
- "description": "Inspect a bounded snapshot-version-2 semantic representation across at most 64 accessible frames, with one aggregate element budget, bounded reusable refs, actionability state, bounded page-controlled metadata, and explicit scan/frame truncation.",
998
+ "description": "Inspect a bounded semantic/actionability snapshot with reusable element refs for structured browser decisions and actions. Candidates are salience-ranked globally across accessible frames instead of consuming the aggregate budget in frame traversal order. This is not raw page source; use browser_get_source when serialized DOM HTML is required. The aggregate element budget spans at most 64 accessible frames. Foreground execution is limited to 60 seconds; use process sessions or managed jobs for longer work.",
483
999
  "availability": "full",
484
1000
  "annotations": {
485
1001
  "readOnlyHint": true,
@@ -508,7 +1024,7 @@
508
1024
  "timeout_seconds": {
509
1025
  "type": "integer",
510
1026
  "minimum": 1,
511
- "maximum": 120,
1027
+ "maximum": 60,
512
1028
  "default": 30
513
1029
  },
514
1030
  "frame_id": {
@@ -525,7 +1041,7 @@
525
1041
  {
526
1042
  "name": "browser_wait",
527
1043
  "title": "Wait for browser state",
528
- "description": "Wait until all supplied URL, load, text, and element-state conditions are satisfied in an existing browser tab.",
1044
+ "description": "Wait until all supplied URL, load, text, and element-state conditions are satisfied in an existing browser tab. Foreground execution is limited to 60 seconds; use process sessions or managed jobs for longer work.",
529
1045
  "availability": "full",
530
1046
  "annotations": {
531
1047
  "readOnlyHint": true,
@@ -621,7 +1137,7 @@
621
1137
  "timeout_seconds": {
622
1138
  "type": "integer",
623
1139
  "minimum": 1,
624
- "maximum": 120,
1140
+ "maximum": 60,
625
1141
  "default": 30
626
1142
  }
627
1143
  }
@@ -630,7 +1146,7 @@
630
1146
  {
631
1147
  "name": "browser_action",
632
1148
  "title": "Operate browser page",
633
- "description": "Perform one structured navigation or page action in the user's existing browser tab without arbitrary JavaScript. Automatic trusted-input fallback occurs only before any DevTools Input command starts; ambiguous post-dispatch failures require inspection before retry.",
1149
+ "description": "Perform one structured navigation or page action in the user's existing browser tab without arbitrary JavaScript. Automatic trusted-input fallback occurs only before any trusted preparation (including DOM focus/scroll) or DevTools Input mutation starts; ambiguous post-dispatch failures require inspection before retry. Broker timeout, disconnect, extension replacement, or response loss after WebSocket dispatch is attempted is also an unknown mutation outcome, not proof that the action did not run. If the mutating extension call completes but its success result cannot be serialized or fit within the bounded response budget, that result settlement is likewise unknown and callers must inspect state rather than replay. Fixed ambiguous browser settlements are returned as public, non-retryable MCP errors. DOM/trusted-preparation page calls use a structured settlement envelope: an explicit page preflight error remains definite, while loss of the mutating scripting invocation response after that invocation is attempted is an unknown action outcome and must not be replayed blindly. Cancellation is re-checked after asynchronous target/preparation steps and before each later mutation stage; a stage not yet started is skipped, while earlier focus/scroll/input effects are not rolled back. A successful action is not converted to failure by a later tab-metadata read: current tab provenance is returned only when verified, otherwise tab_metadata_verified is false and stale pre-action title/URL metadata is omitted. Foreground execution is limited to 60 seconds; use process sessions or managed jobs for longer work.",
634
1150
  "availability": "full",
635
1151
  "annotations": {
636
1152
  "readOnlyHint": false,
@@ -739,7 +1255,7 @@
739
1255
  "timeout_seconds": {
740
1256
  "type": "integer",
741
1257
  "minimum": 1,
742
- "maximum": 120,
1258
+ "maximum": 60,
743
1259
  "default": 30
744
1260
  },
745
1261
  "frame_id": {
@@ -771,7 +1287,7 @@
771
1287
  {
772
1288
  "name": "browser_fill_form",
773
1289
  "title": "Fill complex browser form",
774
- "description": "Fill multiple fields and optionally submit a complex form. Sensitive values can come from registered local resources; errors identify possible earlier mutations without returning field values.",
1290
+ "description": "Fill multiple fields and optionally submit a complex form. Sensitive values can come from registered local resources; errors identify possible earlier mutations without returning field values. If the broker has attempted extension dispatch and the response is then lost, times out, disconnects, or is interrupted by extension replacement, the mutation outcome is unknown and browser state must be inspected before retrying. If the completed mutating extension result cannot be serialized or fit within the bounded response budget, that result settlement is also unknown and the form must not be replayed blindly. Fixed ambiguous browser settlements are returned as public, non-retryable MCP errors. The mutating page-world scripting call also uses a structured settlement envelope: explicit selector/field preflight errors remain definite, but loss of the scripting invocation response after the invocation is attempted is an unknown form outcome and must be inspected before retrying. Cancellation observed after asynchronous target lookup but before page mutation skips the fill stage; once page mutation starts, earlier field changes are not rolled back. Successful results attach current tab title/URL only when a fresh metadata read verifies them; otherwise tab_metadata_verified is false and stale pre-fill provenance is omitted. Foreground execution is limited to 60 seconds; use process sessions or managed jobs for longer work.",
775
1291
  "availability": "full",
776
1292
  "annotations": {
777
1293
  "readOnlyHint": false,
@@ -928,7 +1444,7 @@
928
1444
  "timeout_seconds": {
929
1445
  "type": "integer",
930
1446
  "minimum": 1,
931
- "maximum": 180,
1447
+ "maximum": 60,
932
1448
  "default": 60
933
1449
  },
934
1450
  "frame_id": {
@@ -950,7 +1466,7 @@
950
1466
  {
951
1467
  "name": "browser_screenshot",
952
1468
  "title": "Capture browser screenshot",
953
- "description": "Capture the visible area of the active or selected tab from the paired existing browser profile, restore the previous active tab when safe, avoid focusing another window, and return native MCP image content.",
1469
+ "description": "Capture the visible area of the active or selected tab from the paired existing browser profile and return native MCP image content without focusing another window. Selecting an inactive tab may temporarily activate it. Immediately before activation, the extension revalidates that the same restore-baseline tab is still active in that window; a concurrent user tab switch fails definite pre-dispatch without activating anything. If the activation response is then lost, or if the resolved activation no longer verifies the same target tab in the restore-baseline window, the outcome is unknown, no capture or automatic rollback is attempted, and callers should inspect browser_list_tabs before retrying. Broker response loss after extension dispatch is attempted is also reported as unknown because the temporary activation/capture lifecycle may already have run. If the completed mutating extension result cannot be serialized or fit within the bounded response budget, that result settlement is likewise unknown because temporary tab activation/restoration may already have occurred. Fixed ambiguous browser settlements are returned as public, non-retryable MCP errors. Cancellation observed before temporary activation prevents activation; if it arrives after confirmed temporary activation but before capture, capture is skipped and the previous active tab is restored when safely verifiable. After confirmed temporary activation, later capture or verification failures restore the previous active tab when safe while preserving a concurrent user tab switch; restoration revalidates that the baseline tab still belongs to the capture window before activating it. Once the restore activation API is invoked, a rejected response, returned window mismatch, or failed post-restore verification is an unknown active-tab outcome and callers must inspect browser_list_tabs before retrying; no same screenshot is replayed automatically. Successful results use the verified post-capture active-tab observation for title/URL provenance and report tab_metadata_verified=true. Foreground execution is limited to 60 seconds; use process sessions or managed jobs for longer work.",
954
1470
  "availability": "full",
955
1471
  "annotations": {
956
1472
  "readOnlyHint": false,
@@ -983,7 +1499,7 @@
983
1499
  "timeout_seconds": {
984
1500
  "type": "integer",
985
1501
  "minimum": 1,
986
- "maximum": 120,
1502
+ "maximum": 60,
987
1503
  "default": 30
988
1504
  }
989
1505
  }
@@ -992,7 +1508,7 @@
992
1508
  {
993
1509
  "name": "browser_upload_files",
994
1510
  "title": "Upload browser files",
995
- "description": "Populate a browser file input from registered local resource files without returning file contents through MCP results.",
1511
+ "description": "Populate a browser file input from registered local resource files without returning file contents through MCP results. If the broker has attempted extension dispatch and the response is then lost, times out, disconnects, or is interrupted by extension replacement, the mutation outcome is unknown and browser state must be inspected before retrying. If the completed mutating extension result cannot be serialized or fit within the bounded response budget, that result settlement is also unknown and the upload must not be replayed blindly. Fixed ambiguous browser settlements are returned as public, non-retryable MCP errors. The mutating page-world scripting call also uses a structured settlement envelope: explicit selector/file-input preflight errors remain definite, but loss of the scripting invocation response after the invocation is attempted is an unknown upload outcome and must be inspected before retrying. Cancellation observed after asynchronous target lookup but before the file-input mutation skips that stage; once the page mutation starts, resulting input/change handlers are not rolled back. Successful results attach current tab title/URL only when a fresh metadata read verifies them; otherwise tab_metadata_verified is false and stale pre-upload provenance is omitted. Foreground execution is limited to 60 seconds; use process sessions or managed jobs for longer work.",
996
1512
  "availability": "full",
997
1513
  "annotations": {
998
1514
  "readOnlyHint": false,
@@ -1079,7 +1595,7 @@
1079
1595
  "timeout_seconds": {
1080
1596
  "type": "integer",
1081
1597
  "minimum": 1,
1082
- "maximum": 180,
1598
+ "maximum": 60,
1083
1599
  "default": 60
1084
1600
  },
1085
1601
  "frame_id": {
@@ -1103,7 +1619,7 @@
1103
1619
  {
1104
1620
  "name": "agent_context",
1105
1621
  "title": "Load agent context",
1106
- "description": "Discover built-in defaults, bounded automatic project facts, Codex-compatible global/root-to-target instruction precedence, progressively disclosed local skills, explicit commands, and safe automatic package-script command aliases for a target path.",
1622
+ "description": "Discover the instruction, skill, and registered-command inventory for a target path, including precedence and provenance. Use this when the caller needs the context itself; use resolve_task_capabilities when it needs task-specific ranking and execution-route advice.",
1107
1623
  "availability": "always",
1108
1624
  "annotations": {
1109
1625
  "readOnlyHint": true,
@@ -1230,7 +1746,7 @@
1230
1746
  {
1231
1747
  "name": "run_local_command",
1232
1748
  "title": "Run registered local command",
1233
- "description": "Run an effective manifest or automatic package-script command through its fixed argv, cwd, timeout ceiling, and extra-argument policy. Large stdout/stderr is previewed inline and retained temporarily for paged read_process continuation.",
1749
+ "description": "Prefer this when the repository already defines the desired operation as a registered command or package script. It runs the fixed argv/cwd/timeout contract without shell reinterpretation; use exec_command for ad hoc pipelines or run_process for an unregistered executable argv. Local foreground execution remains request-scoped. Remote execution is durable-first: the command is committed as a principal-bound one-step managed job and the response returns a job_id for read_job recovery across MCP disconnects or daemon replacement. Supply idempotency_key when retry-safe recovery of an ambiguous acceptance response is required.",
1234
1750
  "availability": "direct-exec",
1235
1751
  "annotations": {
1236
1752
  "readOnlyHint": false,
@@ -1260,10 +1776,15 @@
1260
1776
  "maxItems": 64,
1261
1777
  "default": []
1262
1778
  },
1779
+ "idempotency_key": {
1780
+ "type": "string",
1781
+ "pattern": "^[A-Za-z0-9][A-Za-z0-9._~:-]{0,127}$"
1782
+ },
1263
1783
  "timeout_seconds": {
1264
1784
  "type": "integer",
1265
1785
  "minimum": 1,
1266
- "maximum": 600
1786
+ "maximum": 60,
1787
+ "default": 60
1267
1788
  }
1268
1789
  },
1269
1790
  "required": [
@@ -1403,7 +1924,7 @@
1403
1924
  {
1404
1925
  "name": "write_file",
1405
1926
  "title": "Write text file",
1406
- "description": "Atomically write a UTF-8 file up to 5 MiB. Supports create-only and optimistic SHA-256 checks; symbolic-link destinations are rejected.",
1927
+ "description": "Atomically write a UTF-8 file up to 5 MiB. Supports create-only and optimistic SHA-256 checks; expected state failures return typed conflict reasons without exposing file content or hashes.",
1407
1928
  "availability": "write",
1408
1929
  "annotations": {
1409
1930
  "readOnlyHint": false,
@@ -1439,7 +1960,7 @@
1439
1960
  {
1440
1961
  "name": "edit_file",
1441
1962
  "title": "Edit text file",
1442
- "description": "Atomically replace an exact text fragment in one UTF-8 file. By default the old text must occur exactly once.",
1963
+ "description": "Atomically replace an exact text fragment in one UTF-8 file. Missing text returns not_found; ambiguous text, stale SHA-256 preconditions, and unsupported targets return typed conflicts.",
1443
1964
  "availability": "write",
1444
1965
  "annotations": {
1445
1966
  "readOnlyHint": false,
@@ -1480,7 +2001,7 @@
1480
2001
  {
1481
2002
  "name": "apply_patch",
1482
2003
  "title": "Apply structured patch",
1483
- "description": "Apply a bounded Begin Patch/End Patch envelope containing add, update, move, or delete file operations. All paths are prevalidated and mutations are serialized.",
2004
+ "description": "Apply a bounded Begin Patch/End Patch envelope containing add, update, move, or delete operations. Syntax errors are invalid_request; stale contexts and target collisions are typed conflicts; mutations remain serialized and transactional. A failed transaction is rolled back when possible; if rollback itself is incomplete after mutations began, the tool returns a public non-retryable patch_recovery_incomplete settlement because affected files may be partially modified and must be inspected before retrying.",
1484
2005
  "availability": "write",
1485
2006
  "annotations": {
1486
2007
  "readOnlyHint": false,
@@ -1560,7 +2081,8 @@
1560
2081
  "properties": {
1561
2082
  "path": {
1562
2083
  "type": "string",
1563
- "default": "."
2084
+ "default": ".",
2085
+ "maxLength": 32768
1564
2086
  }
1565
2087
  },
1566
2088
  "additionalProperties": false
@@ -1582,7 +2104,8 @@
1582
2104
  "properties": {
1583
2105
  "path": {
1584
2106
  "type": "string",
1585
- "default": "."
2107
+ "default": ".",
2108
+ "maxLength": 32768
1586
2109
  },
1587
2110
  "staged": {
1588
2111
  "type": "boolean",
@@ -1614,7 +2137,8 @@
1614
2137
  "properties": {
1615
2138
  "path": {
1616
2139
  "type": "string",
1617
- "default": "."
2140
+ "default": ".",
2141
+ "maxLength": 32768
1618
2142
  },
1619
2143
  "max_count": {
1620
2144
  "type": "integer",
@@ -1646,11 +2170,13 @@
1646
2170
  "properties": {
1647
2171
  "path": {
1648
2172
  "type": "string",
1649
- "default": "."
2173
+ "default": ".",
2174
+ "maxLength": 32768
1650
2175
  },
1651
2176
  "revision": {
1652
2177
  "type": "string",
1653
- "default": "HEAD"
2178
+ "default": "HEAD",
2179
+ "maxLength": 256
1654
2180
  },
1655
2181
  "max_bytes": {
1656
2182
  "type": "integer",
@@ -1662,10 +2188,41 @@
1662
2188
  "additionalProperties": false
1663
2189
  }
1664
2190
  },
2191
+ {
2192
+ "name": "git_commit",
2193
+ "title": "Create Git commit",
2194
+ "description": "Create one local Git commit from the repository's existing staged index. This tool refuses repositories with an in-progress merge, rebase, cherry-pick, revert, bisect, or sequencer operation. It never stages files, amends history, signs, runs Git hooks, launches an editor, or pushes. The commit message is delivered over stdin rather than process argv; repository-local Git author identity must already be configured.",
2195
+ "availability": "direct-exec",
2196
+ "annotations": {
2197
+ "readOnlyHint": false,
2198
+ "destructiveHint": false,
2199
+ "idempotentHint": false,
2200
+ "openWorldHint": false
2201
+ },
2202
+ "inputSchema": {
2203
+ "type": "object",
2204
+ "properties": {
2205
+ "path": {
2206
+ "type": "string",
2207
+ "default": ".",
2208
+ "maxLength": 32768
2209
+ },
2210
+ "message": {
2211
+ "type": "string",
2212
+ "minLength": 1,
2213
+ "maxLength": 16384
2214
+ }
2215
+ },
2216
+ "required": [
2217
+ "message"
2218
+ ],
2219
+ "additionalProperties": false
2220
+ }
2221
+ },
1665
2222
  {
1666
2223
  "name": "run_process",
1667
2224
  "title": "Run process directly",
1668
- "description": "Execute an argv array without a command shell. This avoids shell parsing but does not sandbox the executable or code it launches. Large stdout/stderr is previewed inline and retained temporarily for paged read_process continuation.",
2225
+ "description": "Run an explicit executable plus argv when no shell syntax is needed and no registered command fits. This avoids quoting, globbing, pipelines, and redirection, but it is not a sandbox; use exec_command when Bash composition is the convenient choice. Local foreground execution remains request-scoped. Remote execution is durable-first: the argv is committed as a principal-bound one-step managed job and the response returns a job_id for read_job recovery across MCP disconnects or daemon replacement. Supply idempotency_key when retry-safe recovery of an ambiguous acceptance response is required.",
1669
2226
  "availability": "direct-exec",
1670
2227
  "annotations": {
1671
2228
  "readOnlyHint": false,
@@ -1688,11 +2245,15 @@
1688
2245
  "type": "string",
1689
2246
  "default": "."
1690
2247
  },
2248
+ "idempotency_key": {
2249
+ "type": "string",
2250
+ "pattern": "^[A-Za-z0-9][A-Za-z0-9._~:-]{0,127}$"
2251
+ },
1691
2252
  "timeout_seconds": {
1692
2253
  "type": "integer",
1693
2254
  "minimum": 1,
1694
- "maximum": 600,
1695
- "default": 120
2255
+ "maximum": 60,
2256
+ "default": 60
1696
2257
  }
1697
2258
  },
1698
2259
  "required": [
@@ -1704,7 +2265,7 @@
1704
2265
  {
1705
2266
  "name": "start_process",
1706
2267
  "title": "Start process session",
1707
- "description": "Start a direct argv process without a shell and retain bounded stdout, stderr, and stdin state across MCP calls.",
2268
+ "description": "Start a direct argv process without a shell and retain bounded stdout, stderr, and stdin state across MCP calls. Cancellation before spawn is definite. If cancellation or deadline arrives after the child has spawned but before the start result settles, the server requests termination and returns a public non-retryable unknown outcome with the allocated session_id; the retained session remains inspectable so callers can verify its state instead of starting the command again blindly. Process sessions are daemon-lifetime state: use start_job/read_job when work must survive a Machine Bridge daemon restart, service replacement, or MCP disconnect. For an authorized remote call on macOS, a successfully admitted session keeps an idle-sleep assertion for the child lifetime; this does not override explicit sleep or lid-close behavior.",
1708
2269
  "availability": "direct-exec",
1709
2270
  "annotations": {
1710
2271
  "readOnlyHint": false,
@@ -1787,7 +2348,7 @@
1787
2348
  {
1788
2349
  "name": "write_process",
1789
2350
  "title": "Write process stdin",
1790
- "description": "Write bounded UTF-8 data to a live process session and optionally close its stdin stream.",
2351
+ "description": "Write bounded UTF-8 data to a live process session and optionally close its stdin stream. Cancellation before any stdin mutation is definite. Once stdin.write or stdin.end has been invoked, callback/error/cancellation ambiguity is returned as a public non-retryable unknown outcome with the session_id; inspect the session before writing the same data again because the child may already have consumed it.",
1791
2352
  "availability": "direct-exec",
1792
2353
  "annotations": {
1793
2354
  "readOnlyHint": false,
@@ -1847,7 +2408,7 @@
1847
2408
  {
1848
2409
  "name": "diagnose_runtime",
1849
2410
  "title": "Diagnose runtime layers",
1850
- "description": "Run fixed, non-user-controlled local probes to distinguish MCP policy, local filesystem, process-spawn, shell, managed-job storage, and registered-resource failures. A successful response proves the request reached the local daemon; it cannot diagnose a host refusal that blocks the tool call itself.",
2411
+ "description": "Run fixed, non-user-controlled local probes and return privacy-safe control-plane state (call capacity, draining processes, execution guardrails, relay liveness, and audit health) to distinguish MCP policy, local filesystem, process-spawn, shell, managed-job storage, and registered-resource failures. A successful response proves the request reached the local daemon; it cannot diagnose a host refusal that blocks the tool call itself.",
1851
2412
  "availability": "always",
1852
2413
  "annotations": {
1853
2414
  "readOnlyHint": true,
@@ -1915,8 +2476,8 @@
1915
2476
  },
1916
2477
  {
1917
2478
  "name": "stage_job",
1918
- "title": "Stage managed job for local approval",
1919
- "description": "Validate and persist a managed-job plan without starting any process. Use this when execution tools are unavailable or local operator review is required; launch later with machine-mcp job approve JOB_ID.",
2479
+ "title": "Stage managed job draft",
2480
+ "description": "Validate and persist a durable managed-job draft without starting any process. This is a non-executing record only; a trusted owner client starts work with start_job after reviewing or reconstructing the plan.",
1920
2481
  "availability": "write",
1921
2482
  "annotations": {
1922
2483
  "readOnlyHint": false,
@@ -2112,7 +2673,7 @@
2112
2673
  {
2113
2674
  "name": "start_job",
2114
2675
  "title": "Start managed job",
2115
- "description": "Durably accept a detached argv-based job with ordered steps, job-scoped temporary files, and guaranteed-attempt finally steps. The independent local runner continues if the MCP connection disappears. Use {{temp:name}}, {{resource:name}}, env_resources, or stdin_resource; registered resource contents never enter MCP arguments.",
2676
+ "description": "Durably accept a detached argv-based job with ordered steps, job-scoped temporary files, and guaranteed-attempt finally steps. The independent local runner continues if the MCP connection disappears. On macOS, an authorized remote account job keeps a runner-owned idle-sleep assertion only after the runner ownership claim is confirmed and persisted account ownership is validated, then through admission, steps, cleanup, and terminal persistence; local managed jobs do not acquire this remote-continuity assertion, and it does not override explicit sleep or lid-close behavior. Use an idempotency_key to deduplicate an uncertain retry while the original job record is retained; eviction/retention expiry ends that deduplication window, so this is not permanent exactly-once execution. Use {{temp:name}}, {{resource:name}}, env_resources, or stdin_resource; registered resource contents never enter MCP arguments.",
2116
2677
  "availability": "write+direct-exec",
2117
2678
  "annotations": {
2118
2679
  "readOnlyHint": false,
@@ -2127,6 +2688,10 @@
2127
2688
  "type": "string",
2128
2689
  "maxLength": 128
2129
2690
  },
2691
+ "idempotency_key": {
2692
+ "type": "string",
2693
+ "pattern": "^[A-Za-z0-9][A-Za-z0-9._~:-]{0,127}$"
2694
+ },
2130
2695
  "steps": {
2131
2696
  "type": "array",
2132
2697
  "minItems": 1,
@@ -2308,7 +2873,7 @@
2308
2873
  {
2309
2874
  "name": "list_jobs",
2310
2875
  "title": "List managed jobs",
2311
- "description": "List recent detached managed jobs and their lifecycle status without returning step output.",
2876
+ "description": "List recent detached managed jobs and their lifecycle status without returning step output. Owner/local callers also receive coarse retained-state capacity counts, including unreadable retired cleanup blockers, without internal retired filenames or filesystem identities.",
2312
2877
  "availability": "always",
2313
2878
  "annotations": {
2314
2879
  "readOnlyHint": true,
@@ -2332,7 +2897,7 @@
2332
2897
  {
2333
2898
  "name": "read_job",
2334
2899
  "title": "Read managed job",
2335
- "description": "Return one managed job status plus bounded, resource-redacted step results. Registered resource paths and contents are never returned.",
2900
+ "description": "Return one managed job status plus bounded, resource-redacted step results. current_phase=resource_admission means the runner is still in cooperative pre-spawn resource admission and no child for that step has started yet. Completed step results keep duration_ms as total orchestration duration; local/owner reads additionally expose resource_admission_ms as the pre-spawn portion, while delegated non-owner reads omit that machine-user scheduling timing. Registered resource paths and contents are never returned.",
2336
2901
  "availability": "always",
2337
2902
  "annotations": {
2338
2903
  "readOnlyHint": true,
@@ -2382,7 +2947,7 @@
2382
2947
  {
2383
2948
  "name": "exec_command",
2384
2949
  "title": "Execute shell command",
2385
- "description": "Execute a shell command with workspace cwd. This is not a sandbox and has the operating-system authority of the local user. Large stdout/stderr is previewed inline and retained temporarily for paged read_process continuation.",
2950
+ "description": "Run Bash-compatible shell composition in the workspace: pipelines, redirection, globbing, conditionals, or compact multi-command probes. This is the convenient general escape hatch, not a sandbox, and has the local user's operating-system authority. Prefer run_local_command for an existing fixed project command and run_process when no shell syntax is needed. Local foreground execution remains request-scoped. Remote execution is durable-first: the shell argv is committed as a principal-bound one-step managed job and the response returns a job_id for read_job recovery across MCP disconnects or daemon replacement. Supply idempotency_key when retry-safe recovery of an ambiguous acceptance response is required.",
2386
2951
  "availability": "shell-exec",
2387
2952
  "annotations": {
2388
2953
  "readOnlyHint": false,
@@ -2398,11 +2963,15 @@
2398
2963
  "minLength": 1,
2399
2964
  "maxLength": 65536
2400
2965
  },
2966
+ "idempotency_key": {
2967
+ "type": "string",
2968
+ "pattern": "^[A-Za-z0-9][A-Za-z0-9._~:-]{0,127}$"
2969
+ },
2401
2970
  "timeout_seconds": {
2402
2971
  "type": "integer",
2403
2972
  "minimum": 1,
2404
- "maximum": 600,
2405
- "default": 120
2973
+ "maximum": 60,
2974
+ "default": 60
2406
2975
  }
2407
2976
  },
2408
2977
  "required": [