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,45 +1,19 @@
1
1
  import { isLiveDaemonAttachment, withDaemonLastSeenAt, type DaemonRole } from "./daemon-liveness.ts";
2
- import { sanitizeMetadataText } from "./http.ts";
3
- import { sanitizeDaemonPolicy, sanitizeDaemonTools, type DaemonPolicy } from "./policy.ts";
4
- import { sanitizeDaemonChallengeAttachment, type DaemonChallenge } from "./daemon-auth.ts";
5
-
6
- export interface DaemonAttachment {
7
- role: DaemonRole;
8
- connectedAt: string;
9
- lastSeenAt?: string;
10
- probeId?: string;
11
- instanceId?: string;
12
- policy?: DaemonPolicy;
13
- tools?: string[];
14
- authChallenge?: string;
15
- authIssuedAt?: number;
16
- authExpiresAt?: number;
17
- workerOrigin?: string;
18
- }
19
-
2
+ import type { DaemonPolicy } from "./policy.ts";
3
+ import { relayDiagnosticsAfterReady, type DaemonRelayDiagnostics } from "./daemon-relay-diagnostics.ts";
4
+ import type { DaemonChallenge } from "./daemon-auth.ts";
5
+ import { sanitizeDaemonAttachment, type DaemonAttachment } from "./daemon-socket-attachment.ts";
20
6
  interface WebSocketContext {
21
7
  getWebSockets(): WebSocket[];
22
8
  }
23
-
9
+ export interface DaemonSocketCleanup { task: Promise<void>; first: boolean }
24
10
  export class DaemonSocketRegistry {
25
- constructor(private readonly context: WebSocketContext) {}
11
+ private readonly context: WebSocketContext;
12
+ private readonly cleanupTasks = new WeakMap<WebSocket, Promise<void>>();
13
+ constructor(context: WebSocketContext) { this.context = context; }
26
14
 
27
15
  attachment(socket: WebSocket): DaemonAttachment | undefined {
28
- const raw = socket.deserializeAttachment();
29
- if (!raw || typeof raw !== "object") return undefined;
30
- const candidate = raw as Partial<DaemonAttachment>;
31
- if (!["candidate", "probing", "expired", "daemon"].includes(String(candidate.role))) return undefined;
32
- const policy = sanitizeDaemonPolicy(candidate.policy);
33
- return {
34
- role: candidate.role as DaemonRole,
35
- connectedAt: sanitizeMetadataText(candidate.connectedAt, 64) ?? "",
36
- lastSeenAt: sanitizeMetadataText(candidate.lastSeenAt, 64),
37
- probeId: sanitizeProbeId(candidate.probeId),
38
- instanceId: sanitizeDaemonInstanceId(candidate.instanceId),
39
- policy,
40
- tools: sanitizeDaemonTools(candidate.tools, policy),
41
- ...sanitizeDaemonChallengeAttachment(candidate as Record<string, unknown>),
42
- };
16
+ return sanitizeDaemonAttachment(socket.deserializeAttachment());
43
17
  }
44
18
 
45
19
  readyAttachment(socket: WebSocket): DaemonAttachment | undefined {
@@ -53,38 +27,56 @@ export class DaemonSocketRegistry {
53
27
  readySockets(now = Date.now()): WebSocket[] {
54
28
  return this.readyRoleSockets().filter((socket) => isLiveDaemonAttachment(this.readyAttachment(socket), now));
55
29
  }
30
+ readyChannels(now = Date.now()): WebSocket[] { return this.readySockets(now); }
56
31
 
57
32
  nonReadySockets(): WebSocket[] {
58
- return this.context.getWebSockets().filter((socket) => this.attachment(socket)?.role !== "daemon" && socket.readyState === WebSocket.OPEN);
33
+ return this.context.getWebSockets().filter((socket) => {
34
+ const role = this.attachment(socket)?.role;
35
+ return Boolean(role && role !== "daemon" && socket.readyState === WebSocket.OPEN);
36
+ });
59
37
  }
60
38
 
61
- beginCandidate(socket: WebSocket, challenge: DaemonChallenge, connectedAt = new Date().toISOString()): void {
39
+ beginCandidate(
40
+ socket: WebSocket,
41
+ challenge: DaemonChallenge,
42
+ preflight: { sessionPublicKeyJson: string; sessionKeyId: string; certificateExpiresAt: number },
43
+ connectionId: string,
44
+ connectedAt = new Date().toISOString(),
45
+ ): void {
62
46
  socket.serializeAttachment({
63
47
  role: "candidate",
64
48
  connectedAt,
49
+ connectionId,
65
50
  authChallenge: challenge.challenge,
66
51
  authIssuedAt: challenge.issuedAt,
67
52
  authExpiresAt: challenge.expiresAt,
68
53
  workerOrigin: challenge.workerOrigin,
54
+ authSessionPublicKeyJson: preflight.sessionPublicKeyJson,
55
+ authSessionKeyId: preflight.sessionKeyId,
56
+ authCertificateExpiresAt: preflight.certificateExpiresAt,
69
57
  } satisfies DaemonAttachment);
70
58
  }
71
59
 
72
- beginProbe(socket: WebSocket, values: { connectedAt: string; probeId: string; instanceId: string; policy: DaemonPolicy; tools: string[] }): void {
60
+ beginProbe(socket: WebSocket, values: {
61
+ connectedAt: string; probeId: string; instanceId: string; connectionId: string;
62
+ policy: DaemonPolicy; tools: string[]; relayDiagnostics?: DaemonRelayDiagnostics;
63
+ }): void {
73
64
  socket.serializeAttachment({
74
- role: "probing",
75
- connectedAt: values.connectedAt,
76
- lastSeenAt: values.connectedAt,
77
- probeId: values.probeId,
78
- instanceId: values.instanceId,
79
- policy: values.policy,
80
- tools: values.tools,
65
+ role: "probing", connectedAt: values.connectedAt, lastSeenAt: values.connectedAt,
66
+ probeId: values.probeId, instanceId: values.instanceId, connectionId: values.connectionId,
67
+ policy: values.policy, tools: values.tools, relayDiagnostics: values.relayDiagnostics,
81
68
  } satisfies DaemonAttachment);
82
69
  }
83
70
 
84
71
  promote(socket: WebSocket, lastSeenAt = new Date().toISOString()): DaemonAttachment | undefined {
85
72
  const attachment = this.attachment(socket);
86
73
  if (attachment?.role !== "probing") return undefined;
87
- const ready = { ...attachment, role: "daemon" as const, lastSeenAt };
74
+ const ready = {
75
+ ...attachment,
76
+ role: "daemon" as const,
77
+ lastSeenAt,
78
+ relayDiagnostics: relayDiagnosticsAfterReady(attachment.relayDiagnostics, lastSeenAt),
79
+ };
88
80
  delete ready.probeId;
89
81
  socket.serializeAttachment(ready satisfies DaemonAttachment);
90
82
  return ready;
@@ -98,15 +90,43 @@ export class DaemonSocketRegistry {
98
90
  return touched;
99
91
  }
100
92
 
101
- expire(socket: WebSocket): void {
93
+ expire(socket: WebSocket): DaemonAttachment | undefined {
102
94
  const attachment = this.attachment(socket);
103
- if (!attachment) return;
95
+ if (!attachment || attachment.role === "expired") return undefined;
104
96
  socket.serializeAttachment({
105
- role: "expired",
106
- connectedAt: attachment.connectedAt,
107
- lastSeenAt: attachment.lastSeenAt,
108
- instanceId: attachment.instanceId,
97
+ role: "expired", connectedAt: attachment.connectedAt, lastSeenAt: attachment.lastSeenAt,
98
+ instanceId: attachment.instanceId, connectionId: attachment.connectionId,
99
+ relayDiagnostics: attachment.relayDiagnostics,
109
100
  } satisfies DaemonAttachment);
101
+ return attachment;
102
+ }
103
+
104
+ beginCleanup(
105
+ socket: WebSocket,
106
+ operation: (attachment: DaemonAttachment) => Promise<unknown>,
107
+ ): DaemonSocketCleanup | undefined {
108
+ const existing = this.cleanupTasks.get(socket);
109
+ if (existing) return { task: existing, first: false };
110
+ const attachment = this.attachment(socket);
111
+ if (!attachment) return undefined;
112
+ const first = attachment.role !== "expired";
113
+ if (first) this.expire(socket);
114
+ let task!: Promise<void>;
115
+ task = Promise.resolve().then(() => operation(attachment)).catch(() => operation(attachment)).then(
116
+ () => undefined,
117
+ (error) => {
118
+ if (this.cleanupTasks.get(socket) === task) this.cleanupTasks.delete(socket);
119
+ throw error;
120
+ },
121
+ );
122
+ this.cleanupTasks.set(socket, task);
123
+ return { task, first };
124
+ }
125
+
126
+ socketForConnectionId(connectionId: string): WebSocket | undefined {
127
+ if (!connectionId) return undefined;
128
+ return this.context.getWebSockets().find((socket) =>
129
+ this.attachment(socket)?.connectionId === connectionId && socket.readyState === WebSocket.OPEN);
110
130
  }
111
131
 
112
132
  private openSockets(role: DaemonRole): WebSocket[] {
@@ -117,13 +137,3 @@ export class DaemonSocketRegistry {
117
137
  return Date.parse(this.attachment(socket)?.connectedAt ?? "") || 0;
118
138
  }
119
139
  }
120
-
121
- function sanitizeProbeId(value: unknown): string | undefined {
122
- if (typeof value !== "string" || !/^probe_[A-Za-z0-9_-]{8,240}$/.test(value)) return undefined;
123
- return value;
124
- }
125
-
126
- function sanitizeDaemonInstanceId(value: unknown): string | undefined {
127
- if (typeof value !== "string" || !/^daemon_[A-Za-z0-9_-]{16,96}$/.test(value)) return undefined;
128
- return value;
129
- }
@@ -0,0 +1,38 @@
1
+ import { DAEMON_LIVENESS_TIMEOUT_MS, DAEMON_READY_TIMEOUT_MS } from "./daemon-liveness.ts";
2
+ import relayContract from "../shared/relay-contract.json" with { type: "json" };
3
+ import type { DaemonRegistry } from "./daemon-registry.ts";
4
+ import { readyDaemonChannels } from "./daemon-channel.ts";
5
+
6
+ export function daemonStatusSnapshot(registry: DaemonRegistry, detail: boolean): Record<string, unknown> {
7
+ const sockets = readyDaemonChannels(registry);
8
+ const attachment = sockets[0] ? registry.readyAttachment(sockets[0]) : undefined;
9
+ const previous = sockets.length === 0 ? registry.lastDaemonObservation?.() : undefined;
10
+ const tools = attachment?.tools ?? [];
11
+ const transport = sockets[0]?.daemonTransport === "https" ? "https" : "websocket";
12
+ const base = {
13
+ connected: sockets.length > 0,
14
+ count: sockets.length,
15
+ tool_count: tools.length,
16
+ connected_at: attachment?.connectedAt ?? null,
17
+ last_seen_at: attachment?.lastSeenAt ?? attachment?.connectedAt ?? null,
18
+ readiness_verified: sockets.length > 0,
19
+ readiness_timeout_ms: DAEMON_READY_TIMEOUT_MS,
20
+ liveness_timeout_ms: transport === "https"
21
+ ? relayContract.httpFallbackLivenessTimeoutMs
22
+ : DAEMON_LIVENESS_TIMEOUT_MS,
23
+ previous_connection: previous ? {
24
+ transport: previous.transport,
25
+ connected_at: previous.connectedAt,
26
+ last_seen_at: previous.lastSeenAt,
27
+ disconnected_at: previous.disconnectedAt,
28
+ relay_transport: previous.relayDiagnostics ?? null,
29
+ } : null,
30
+ };
31
+ if (!detail) return base;
32
+ return {
33
+ ...base,
34
+ policy: attachment?.policy ?? null,
35
+ tools,
36
+ relay_transport: attachment?.relayDiagnostics ?? null,
37
+ };
38
+ }
@@ -0,0 +1,129 @@
1
+ import {
2
+ DEVICE_SESSION_CERTIFICATE_SCHEME,
3
+ DEVICE_SESSION_MAX_LIFETIME_SECONDS,
4
+ canonicalPublicJwk,
5
+ deviceSessionCertificateTranscript,
6
+ } from "../shared/device-session-auth.mjs";
7
+ import { safeEqual } from "./oauth-state.ts";
8
+
9
+ const SESSION_CERTIFICATE_MAX_BYTES = 16 * 1024;
10
+
11
+ export interface VerifiedDeviceSessionCertificate {
12
+ sessionPublicJwk: JsonWebKey;
13
+ sessionPublicKeyJson: string;
14
+ sessionKeyId: string;
15
+ rootKeyId: string;
16
+ issuedAt: number;
17
+ expiresAt: number;
18
+ }
19
+
20
+ export async function verifyDeviceSessionCertificate(input: {
21
+ encodedCertificate: string;
22
+ rootPublicKeyJson: string;
23
+ workerOrigin: string;
24
+ server: string;
25
+ version: string;
26
+ now: number;
27
+ }): Promise<VerifiedDeviceSessionCertificate | null> {
28
+ const bytes = decodeBase64Url(input.encodedCertificate);
29
+ if (!bytes || bytes.byteLength > SESSION_CERTIFICATE_MAX_BYTES) return null;
30
+ let value: Record<string, unknown>;
31
+ try {
32
+ const parsed = JSON.parse(new TextDecoder("utf-8", { fatal: true }).decode(bytes));
33
+ if (!parsed || typeof parsed !== "object" || Array.isArray(parsed)) return null;
34
+ value = parsed as Record<string, unknown>;
35
+ } catch {
36
+ return null;
37
+ }
38
+ if (value.scheme !== DEVICE_SESSION_CERTIFICATE_SCHEME) return null;
39
+ const issuedAt = Number(value.issued_at);
40
+ const expiresAt = Number(value.expires_at);
41
+ const nonce = String(value.nonce || "");
42
+ const rootKeyId = String(value.root_key_id || "");
43
+ const signature = decodeBase64Url(String(value.signature || ""), 64);
44
+ if (!signature || !Number.isSafeInteger(issuedAt) || !Number.isSafeInteger(expiresAt)) return null;
45
+ if (issuedAt > input.now + 5 * 60 || expiresAt <= input.now) return null;
46
+ if (expiresAt <= issuedAt || expiresAt - issuedAt > DEVICE_SESSION_MAX_LIFETIME_SECONDS) return null;
47
+ if (!/^[A-Za-z0-9_-]{24,128}$/.test(nonce)) return null;
48
+ let rootPublicJwk: JsonWebKey;
49
+ let sessionPublicJwk: JsonWebKey;
50
+ try {
51
+ rootPublicJwk = parsePublicJwk(input.rootPublicKeyJson);
52
+ sessionPublicJwk = parsePublicJwk(JSON.stringify(value.public_jwk));
53
+ } catch {
54
+ return null;
55
+ }
56
+ const expectedRootKeyId = await publicKeyId(rootPublicJwk);
57
+ if (!(await safeEqual(rootKeyId, expectedRootKeyId))) return null;
58
+ let transcript: string;
59
+ try {
60
+ transcript = deviceSessionCertificateTranscript({
61
+ workerOrigin: input.workerOrigin,
62
+ server: input.server,
63
+ version: input.version,
64
+ rootKeyId,
65
+ publicJwk: sessionPublicJwk,
66
+ issuedAt,
67
+ expiresAt,
68
+ nonce,
69
+ });
70
+ } catch {
71
+ return null;
72
+ }
73
+ if (!(await verifyP256Signature(rootPublicJwk, transcript, signature))) return null;
74
+ return {
75
+ sessionPublicJwk,
76
+ sessionPublicKeyJson: JSON.stringify(canonicalPublicJwk(sessionPublicJwk)),
77
+ sessionKeyId: await publicKeyId(sessionPublicJwk),
78
+ rootKeyId,
79
+ issuedAt,
80
+ expiresAt,
81
+ };
82
+ }
83
+
84
+ export async function verifyP256Signature(publicJwk: JsonWebKey, transcript: string, signature: Uint8Array<ArrayBuffer>): Promise<boolean> {
85
+ try {
86
+ const key = await crypto.subtle.importKey("jwk", publicJwk, { name: "ECDSA", namedCurve: "P-256" }, false, ["verify"]);
87
+ return crypto.subtle.verify(
88
+ { name: "ECDSA", hash: "SHA-256" },
89
+ key,
90
+ signature,
91
+ new TextEncoder().encode(transcript),
92
+ );
93
+ } catch {
94
+ return false;
95
+ }
96
+ }
97
+
98
+ export function parsePublicJwk(value: string): JsonWebKey {
99
+ const parsed = JSON.parse(value) as JsonWebKey;
100
+ const canonical = canonicalPublicJwk(parsed);
101
+ return { ...canonical, ext: true, key_ops: ["verify"] };
102
+ }
103
+
104
+ export async function publicKeyId(jwk: JsonWebKey): Promise<string> {
105
+ const canonical = JSON.stringify(canonicalPublicJwk(jwk));
106
+ const digest = await crypto.subtle.digest("SHA-256", new TextEncoder().encode(canonical));
107
+ return `device_${base64Url(new Uint8Array(digest)).slice(0, 32)}`;
108
+ }
109
+
110
+ export function decodeBase64Url(value: string, expectedBytes?: number): Uint8Array<ArrayBuffer> | null {
111
+ if (!/^[A-Za-z0-9_-]+$/.test(value)) return null;
112
+ const normalized = value.replace(/-/g, "+").replace(/_/g, "/");
113
+ const padding = "=".repeat((4 - (normalized.length % 4)) % 4);
114
+ try {
115
+ const binary = atob(normalized + padding);
116
+ if (expectedBytes !== undefined && binary.length !== expectedBytes) return null;
117
+ const bytes = new Uint8Array(new ArrayBuffer(binary.length));
118
+ for (let index = 0; index < binary.length; index += 1) bytes[index] = binary.charCodeAt(index);
119
+ return bytes;
120
+ } catch {
121
+ return null;
122
+ }
123
+ }
124
+
125
+ function base64Url(bytes: Uint8Array): string {
126
+ let binary = "";
127
+ for (const byte of bytes) binary += String.fromCharCode(byte);
128
+ return btoa(binary).replace(/\+/g, "-").replace(/\//g, "_").replace(/=+$/g, "");
129
+ }
@@ -0,0 +1,157 @@
1
+ import { consumeBoundedNonce } from "./nonce-store.ts";
2
+ import { JWK_THUMBPRINT_PATTERN } from "./oauth-record-contract.ts";
3
+
4
+ const DPOP_WINDOW_SECONDS = 5 * 60;
5
+ const MAX_DPOP_JTIS = 4096;
6
+
7
+ export interface VerifiedDpopProof {
8
+ jkt: string;
9
+ jti: string;
10
+ issuedAt: number;
11
+ replayKey: string;
12
+ expiresAt: number;
13
+ }
14
+
15
+ export async function verifyDpopProof(input: {
16
+ request: Request;
17
+ expectedMethod?: string;
18
+ expectedUrl?: string;
19
+ accessToken?: string;
20
+ expectedJkt?: string;
21
+ now?: number;
22
+ }): Promise<VerifiedDpopProof | null> {
23
+ const encoded = input.request.headers.get("DPoP") || "";
24
+ if (!encoded) return null;
25
+ const parts = encoded.split(".");
26
+ if (parts.length !== 3 || parts.some((part) => !/^[A-Za-z0-9_-]+$/.test(part))) return null;
27
+ const header = decodeJson(parts[0]);
28
+ const payload = decodeJson(parts[1]);
29
+ const signature = decodeBase64Url(parts[2], 64);
30
+ if (!header || !payload || !signature) return null;
31
+ if (header.typ !== "dpop+jwt" || header.alg !== "ES256" || !plainRecord(header.jwk)) return null;
32
+ if (header.crit !== undefined || header.b64 !== undefined) return null;
33
+ const publicJwk = publicP256Jwk(header.jwk);
34
+ if (!publicJwk) return null;
35
+ const now = Number.isSafeInteger(input.now) ? Number(input.now) : Math.floor(Date.now() / 1000);
36
+ const issuedAt = Number(payload.iat);
37
+ const jti = String(payload.jti || "");
38
+ if (!Number.isSafeInteger(issuedAt) || Math.abs(now - issuedAt) > DPOP_WINDOW_SECONDS) return null;
39
+ if (!/^[A-Za-z0-9._~-]{16,200}$/.test(jti)) return null;
40
+ const expectedMethod = String(input.expectedMethod || input.request.method).toUpperCase();
41
+ const expectedUrl = normalizedHtu(input.expectedUrl || input.request.url);
42
+ if (String(payload.htm || "").toUpperCase() !== expectedMethod || normalizedHtu(String(payload.htu || "")) !== expectedUrl) return null;
43
+ const jkt = await jwkThumbprint(publicJwk);
44
+ if (input.expectedJkt && (!JWK_THUMBPRINT_PATTERN.test(input.expectedJkt) || input.expectedJkt !== jkt)) return null;
45
+ if (input.accessToken) {
46
+ const ath = String(payload.ath || "");
47
+ if (ath !== await sha256Base64Url(input.accessToken)) return null;
48
+ } else if (payload.ath !== undefined) {
49
+ return null;
50
+ }
51
+ try {
52
+ const key = await crypto.subtle.importKey("jwk", publicJwk, { name: "ECDSA", namedCurve: "P-256" }, false, ["verify"]);
53
+ const verified = await crypto.subtle.verify(
54
+ { name: "ECDSA", hash: "SHA-256" },
55
+ key,
56
+ signature as unknown as BufferSource,
57
+ new TextEncoder().encode(`${parts[0]}.${parts[1]}`),
58
+ );
59
+ if (!verified) return null;
60
+ } catch {
61
+ return null;
62
+ }
63
+ const replayKey = await sha256Base64Url(`${jkt}\0${jti}`);
64
+ return {
65
+ jkt,
66
+ jti,
67
+ issuedAt,
68
+ replayKey,
69
+ expiresAt: Math.max(now + 1, issuedAt + DPOP_WINDOW_SECONDS),
70
+ };
71
+ }
72
+
73
+ export async function consumeDpopProof(
74
+ storage: DurableObjectStorage | DpopNonceStorage,
75
+ proof: VerifiedDpopProof,
76
+ now = Math.floor(Date.now() / 1000),
77
+ ): Promise<boolean> {
78
+ if (!proof || !JWK_THUMBPRINT_PATTERN.test(proof.replayKey) || !Number.isSafeInteger(proof.expiresAt) || proof.expiresAt <= now) return false;
79
+ return consumeBoundedNonce(storage, {
80
+ key: "dpop-proof-jtis",
81
+ nonce: proof.replayKey,
82
+ expiresAt: proof.expiresAt,
83
+ now,
84
+ noncePattern: JWK_THUMBPRINT_PATTERN,
85
+ maximum: MAX_DPOP_JTIS,
86
+ maxFutureSeconds: DPOP_WINDOW_SECONDS * 2,
87
+ });
88
+ }
89
+
90
+ type DpopNonceStorage = {
91
+ get<T = unknown>(key: string): Promise<T | undefined>;
92
+ put(key: string, value: unknown): Promise<void>;
93
+ };
94
+
95
+ export async function jwkThumbprint(jwk: JsonWebKey): Promise<string> {
96
+ const publicJwk = publicP256Jwk(jwk);
97
+ if (!publicJwk) throw new Error("DPoP public key is invalid");
98
+ const canonical = JSON.stringify({ crv: publicJwk.crv, kty: publicJwk.kty, x: publicJwk.x, y: publicJwk.y });
99
+ return sha256Base64Url(canonical);
100
+ }
101
+
102
+ export function normalizedHtu(value: string): string {
103
+ const url = new URL(value);
104
+ if (url.protocol !== "https:" && !(url.protocol === "http:" && ["127.0.0.1", "localhost", "[::1]"].includes(url.hostname))) {
105
+ throw new Error("DPoP target URI is invalid");
106
+ }
107
+ if (url.username || url.password || url.hash) throw new Error("DPoP target URI is invalid");
108
+ return `${url.origin}${url.pathname}`;
109
+ }
110
+
111
+ function publicP256Jwk(value: unknown): JsonWebKey | null {
112
+ if (!plainRecord(value) || value.kty !== "EC" || value.crv !== "P-256" || value.d !== undefined) return null;
113
+ if (typeof value.x !== "string" || typeof value.y !== "string") return null;
114
+ if (!/^[A-Za-z0-9_-]{42,44}$/.test(value.x) || !/^[A-Za-z0-9_-]{42,44}$/.test(value.y)) return null;
115
+ return { kty: "EC", crv: "P-256", x: value.x, y: value.y, ext: true, key_ops: ["verify"] };
116
+ }
117
+
118
+ function decodeJson(value: string): Record<string, unknown> | null {
119
+ const bytes = decodeBase64Url(value);
120
+ if (!bytes || bytes.byteLength > 16 * 1024) return null;
121
+ try {
122
+ const parsed = JSON.parse(new TextDecoder("utf-8", { fatal: true }).decode(bytes));
123
+ return plainRecord(parsed) ? parsed : null;
124
+ } catch {
125
+ return null;
126
+ }
127
+ }
128
+
129
+ function decodeBase64Url(value: string, expectedBytes?: number): Uint8Array | null {
130
+ if (!/^[A-Za-z0-9_-]+$/.test(value)) return null;
131
+ const normalized = value.replaceAll("-", "+").replaceAll("_", "/");
132
+ const padded = normalized.padEnd(Math.ceil(normalized.length / 4) * 4, "=");
133
+ try {
134
+ const binary = atob(padded);
135
+ if (expectedBytes !== undefined && binary.length !== expectedBytes) return null;
136
+ const bytes = new Uint8Array(new ArrayBuffer(binary.length));
137
+ for (let index = 0; index < binary.length; index += 1) bytes[index] = binary.charCodeAt(index);
138
+ return bytes;
139
+ } catch {
140
+ return null;
141
+ }
142
+ }
143
+
144
+ async function sha256Base64Url(value: string): Promise<string> {
145
+ const digest = await crypto.subtle.digest("SHA-256", new TextEncoder().encode(value));
146
+ return base64Url(new Uint8Array(digest));
147
+ }
148
+
149
+ function base64Url(bytes: Uint8Array): string {
150
+ let binary = "";
151
+ for (const byte of bytes) binary += String.fromCharCode(byte);
152
+ return btoa(binary).replaceAll("+", "-").replaceAll("/", "_").replaceAll("=", "");
153
+ }
154
+
155
+ function plainRecord(value: unknown): value is Record<string, any> {
156
+ return Boolean(value) && typeof value === "object" && !Array.isArray(value);
157
+ }
@@ -0,0 +1,29 @@
1
+ import relayContract from "../shared/relay-contract.json" with { type: "json" };
2
+ import {
3
+ remoteDurableProcessTimeoutSeconds,
4
+ REMOTE_DURABLE_PROCESS_DEFAULT_TIMEOUT_SECONDS,
5
+ REMOTE_DURABLE_PROCESS_MAXIMUM_TIMEOUT_SECONDS,
6
+ } from "../shared/foreground-timeout.mjs";
7
+ import { WorkerToolError } from "./errors.ts";
8
+
9
+ export function durableProcessAcceptanceTimeoutMs(name: string, args: Record<string, unknown>): number {
10
+ try { remoteDurableProcessTimeoutSeconds(args.timeout_seconds); }
11
+ catch { throw durableProcessTimeoutError(name); }
12
+ return relayContract.durableProcessAcceptanceTimeoutMs;
13
+ }
14
+
15
+ function durableProcessTimeoutError(name: string): WorkerToolError {
16
+ return new WorkerToolError(
17
+ "invalid_request",
18
+ `durable remote execution timeout for ${name} must be an integer from 1 to ${REMOTE_DURABLE_PROCESS_MAXIMUM_TIMEOUT_SECONDS} seconds`,
19
+ false,
20
+ {
21
+ side_effects_started: false,
22
+ minimum_execution_timeout_seconds: 1,
23
+ maximum_execution_timeout_seconds: REMOTE_DURABLE_PROCESS_MAXIMUM_TIMEOUT_SECONDS,
24
+ default_execution_timeout_seconds: REMOTE_DURABLE_PROCESS_DEFAULT_TIMEOUT_SECONDS,
25
+ execution_mode: "durable_job",
26
+ recovery_tool: "read_job",
27
+ },
28
+ );
29
+ }
@@ -31,6 +31,63 @@ export function daemonToolError(value: unknown): WorkerToolError {
31
31
  );
32
32
  }
33
33
 
34
+ export function dispatchedDaemonTimeoutError(tool: string, terminationRequested = true, recovery?: Record<string, unknown>): WorkerToolError {
35
+ return dispatchedDaemonCancellationStateError("timeout", `daemon tool timed out: ${tool}`, terminationRequested, recovery);
36
+ }
37
+
38
+ export function dispatchedDaemonCancellationError(message: string, terminationRequested = true, recovery?: Record<string, unknown>): WorkerToolError {
39
+ return dispatchedDaemonCancellationStateError("cancelled", message, terminationRequested, recovery);
40
+ }
41
+
42
+ function dispatchedDaemonCancellationStateError(code: "cancelled" | "timeout", message: string, terminationRequested: boolean, recovery?: Record<string, unknown>): WorkerToolError {
43
+ return new WorkerToolError(
44
+ code,
45
+ message,
46
+ false,
47
+ {
48
+ side_effects_started: true,
49
+ termination_requested: terminationRequested,
50
+ effect_settlement: terminationRequested ? "pending" : "unknown",
51
+ ...(recovery ? { recovery } : {}),
52
+ },
53
+ );
54
+ }
55
+
56
+ export function dispatchedDaemonDisconnectError(message: string, recovery?: Record<string, unknown>): WorkerToolError {
57
+ return new WorkerToolError(
58
+ "unavailable",
59
+ message,
60
+ false,
61
+ {
62
+ side_effects_started: true,
63
+ termination_requested: false,
64
+ effect_settlement: "unknown",
65
+ ...(recovery ? { recovery } : {}),
66
+ },
67
+ );
68
+ }
69
+
70
+ export function daemonCallNotReceivedAfterReconnectError(recovery?: Record<string, unknown>): WorkerToolError {
71
+ return new WorkerToolError(
72
+ "unavailable",
73
+ "daemon reconnect confirmed the tool call was not received; retry the call",
74
+ true,
75
+ {
76
+ side_effects_started: false,
77
+ reason: "daemon_call_not_received_after_reconnect",
78
+ ...(recovery ? { recovery } : {}),
79
+ },
80
+ );
81
+ }
82
+
83
+ export function revokedDaemonAuthorityError(): WorkerToolError {
84
+ return new WorkerToolError("authorization_denied", "tool call authority was revoked", false, {
85
+ side_effects_started: true,
86
+ termination_requested: false,
87
+ effect_settlement: "unknown",
88
+ });
89
+ }
90
+
34
91
  export function publicWorkerToolError(error: unknown): { code: string; message: string; retryable: boolean; details?: Record<string, unknown> } {
35
92
  if (error instanceof WorkerToolError) {
36
93
  return {