@nexum-hub/agent 0.0.0-stage → 0.0.1

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 (343) hide show
  1. package/README.md +129 -2
  2. package/contracts/v2/common.schema.json +262 -0
  3. package/contracts/v2/fixtures/inputs.json +244 -0
  4. package/contracts/v2/fixtures/wire.json +6493 -0
  5. package/contracts/v2/model/agent.close.input.schema.json +14 -0
  6. package/contracts/v2/model/agent.close.output.schema.json +101 -0
  7. package/contracts/v2/model/agent.list.input.schema.json +57 -0
  8. package/contracts/v2/model/agent.list.output.schema.json +220 -0
  9. package/contracts/v2/model/agent.open.input.schema.json +35 -0
  10. package/contracts/v2/model/agent.open.output.schema.json +41 -0
  11. package/contracts/v2/model/agent.run.cancel.input.schema.json +18 -0
  12. package/contracts/v2/model/agent.run.cancel.output.schema.json +100 -0
  13. package/contracts/v2/model/agent.run.get.input.schema.json +41 -0
  14. package/contracts/v2/model/agent.run.get.output.schema.json +100 -0
  15. package/contracts/v2/model/agent.run.input.input.schema.json +30 -0
  16. package/contracts/v2/model/agent.run.input.output.schema.json +100 -0
  17. package/contracts/v2/model/agent.run.list.input.schema.json +47 -0
  18. package/contracts/v2/model/agent.run.list.output.schema.json +41 -0
  19. package/contracts/v2/model/agent.run.start.input.schema.json +73 -0
  20. package/contracts/v2/model/agent.run.start.output.schema.json +100 -0
  21. package/contracts/v2/wire/bodies.schema.json +383 -0
  22. package/contracts/v2/wire/envelope.schema.json +2280 -0
  23. package/contracts/v2/wire/events.schema.json +242 -0
  24. package/contracts/v2/wire/maintenance.schema.json +308 -0
  25. package/contracts/v2/wire/operations.schema.json +1791 -0
  26. package/contracts/v2/wire/stream.schema.json +74 -0
  27. package/contracts/v2/wire/types.schema.json +2616 -0
  28. package/dist/adapters/mcp-http.d.ts +22 -0
  29. package/dist/adapters/mcp-http.js +472 -0
  30. package/dist/adapters/mcp-http.js.map +1 -0
  31. package/dist/adapters/mcp-oauth.d.ts +29 -0
  32. package/dist/adapters/mcp-oauth.js +653 -0
  33. package/dist/adapters/mcp-oauth.js.map +1 -0
  34. package/dist/adapters/mcp-wire.d.ts +21 -0
  35. package/dist/adapters/mcp-wire.js +307 -0
  36. package/dist/adapters/mcp-wire.js.map +1 -0
  37. package/dist/adapters/mcp.d.ts +56 -0
  38. package/dist/adapters/mcp.js +1989 -0
  39. package/dist/adapters/mcp.js.map +1 -0
  40. package/dist/adapters/openapi-http.d.ts +29 -0
  41. package/dist/adapters/openapi-http.js +504 -0
  42. package/dist/adapters/openapi-http.js.map +1 -0
  43. package/dist/adapters/openapi-request.d.ts +26 -0
  44. package/dist/adapters/openapi-request.js +597 -0
  45. package/dist/adapters/openapi-request.js.map +1 -0
  46. package/dist/adapters/openapi-schema.d.ts +22 -0
  47. package/dist/adapters/openapi-schema.js +471 -0
  48. package/dist/adapters/openapi-schema.js.map +1 -0
  49. package/dist/adapters/openapi-typegen.d.ts +11 -0
  50. package/dist/adapters/openapi-typegen.js +185 -0
  51. package/dist/adapters/openapi-typegen.js.map +1 -0
  52. package/dist/adapters/openapi-types.d.ts +99 -0
  53. package/dist/adapters/openapi-types.js +2 -0
  54. package/dist/adapters/openapi-types.js.map +1 -0
  55. package/dist/adapters/openapi.d.ts +7 -0
  56. package/dist/adapters/openapi.js +768 -0
  57. package/dist/adapters/openapi.js.map +1 -0
  58. package/dist/application/activation.d.ts +28 -0
  59. package/dist/application/activation.js +289 -0
  60. package/dist/application/activation.js.map +1 -0
  61. package/dist/application/attachments.d.ts +24 -0
  62. package/dist/application/attachments.js +87 -0
  63. package/dist/application/attachments.js.map +1 -0
  64. package/dist/application/authority.d.ts +32 -0
  65. package/dist/application/authority.js +213 -0
  66. package/dist/application/authority.js.map +1 -0
  67. package/dist/application/catalog.d.ts +11 -0
  68. package/dist/application/catalog.js +177 -0
  69. package/dist/application/catalog.js.map +1 -0
  70. package/dist/application/config.d.ts +24 -0
  71. package/dist/application/config.js +140 -0
  72. package/dist/application/config.js.map +1 -0
  73. package/dist/application/connection.d.ts +35 -0
  74. package/dist/application/connection.js +465 -0
  75. package/dist/application/connection.js.map +1 -0
  76. package/dist/application/data-plane.d.ts +35 -0
  77. package/dist/application/data-plane.js +437 -0
  78. package/dist/application/data-plane.js.map +1 -0
  79. package/dist/application/diagnostics.d.ts +4 -0
  80. package/dist/application/diagnostics.js +65 -0
  81. package/dist/application/diagnostics.js.map +1 -0
  82. package/dist/application/dispatcher.d.ts +4 -0
  83. package/dist/application/dispatcher.js +16 -0
  84. package/dist/application/dispatcher.js.map +1 -0
  85. package/dist/application/main.d.ts +12 -0
  86. package/dist/application/main.js +167 -0
  87. package/dist/application/main.js.map +1 -0
  88. package/dist/application/maintenance.d.ts +27 -0
  89. package/dist/application/maintenance.js +244 -0
  90. package/dist/application/maintenance.js.map +1 -0
  91. package/dist/application/packages.d.ts +25 -0
  92. package/dist/application/packages.js +208 -0
  93. package/dist/application/packages.js.map +1 -0
  94. package/dist/application/processes.d.ts +49 -0
  95. package/dist/application/processes.js +180 -0
  96. package/dist/application/processes.js.map +1 -0
  97. package/dist/application/run-view.d.ts +17 -0
  98. package/dist/application/run-view.js +286 -0
  99. package/dist/application/run-view.js.map +1 -0
  100. package/dist/application/runtime.d.ts +78 -0
  101. package/dist/application/runtime.js +1747 -0
  102. package/dist/application/runtime.js.map +1 -0
  103. package/dist/application/tasks.d.ts +38 -0
  104. package/dist/application/tasks.js +23 -0
  105. package/dist/application/tasks.js.map +1 -0
  106. package/dist/application/user-state.d.ts +20 -0
  107. package/dist/application/user-state.js +52 -0
  108. package/dist/application/user-state.js.map +1 -0
  109. package/dist/application/work-git.d.ts +14 -0
  110. package/dist/application/work-git.js +67 -0
  111. package/dist/application/work-git.js.map +1 -0
  112. package/dist/cli.d.ts +2 -0
  113. package/dist/cli.js +40 -0
  114. package/dist/cli.js.map +1 -0
  115. package/dist/contracts/caller.d.ts +51 -0
  116. package/dist/contracts/caller.js +95 -0
  117. package/dist/contracts/caller.js.map +1 -0
  118. package/dist/contracts/error-data.d.ts +6 -0
  119. package/dist/contracts/error-data.js +51 -0
  120. package/dist/contracts/error-data.js.map +1 -0
  121. package/dist/contracts/errors.d.ts +10 -0
  122. package/dist/contracts/errors.js +28 -0
  123. package/dist/contracts/errors.js.map +1 -0
  124. package/dist/contracts/json.d.ts +9 -0
  125. package/dist/contracts/json.js +104 -0
  126. package/dist/contracts/json.js.map +1 -0
  127. package/dist/contracts/types.d.ts +122 -0
  128. package/dist/contracts/types.js +19 -0
  129. package/dist/contracts/types.js.map +1 -0
  130. package/dist/contracts/validation.d.ts +4 -0
  131. package/dist/contracts/validation.js +157 -0
  132. package/dist/contracts/validation.js.map +1 -0
  133. package/dist/contracts/wire-validation.d.ts +9 -0
  134. package/dist/contracts/wire-validation.js +399 -0
  135. package/dist/contracts/wire-validation.js.map +1 -0
  136. package/dist/contracts/wire.d.ts +1083 -0
  137. package/dist/contracts/wire.js +62 -0
  138. package/dist/contracts/wire.js.map +1 -0
  139. package/dist/extension-api.d.ts +12 -0
  140. package/dist/extension-api.js +2 -0
  141. package/dist/extension-api.js.map +1 -0
  142. package/dist/extensions/api.d.ts +72 -0
  143. package/dist/extensions/api.js +2 -0
  144. package/dist/extensions/api.js.map +1 -0
  145. package/dist/extensions/host-requests.d.ts +23 -0
  146. package/dist/extensions/host-requests.js +60 -0
  147. package/dist/extensions/host-requests.js.map +1 -0
  148. package/dist/extensions/materials.d.ts +37 -0
  149. package/dist/extensions/materials.js +691 -0
  150. package/dist/extensions/materials.js.map +1 -0
  151. package/dist/extensions/package-loader.d.ts +28 -0
  152. package/dist/extensions/package-loader.js +177 -0
  153. package/dist/extensions/package-loader.js.map +1 -0
  154. package/dist/extensions/packages.d.ts +73 -0
  155. package/dist/extensions/packages.js +441 -0
  156. package/dist/extensions/packages.js.map +1 -0
  157. package/dist/extensions/registry.d.ts +92 -0
  158. package/dist/extensions/registry.js +1540 -0
  159. package/dist/extensions/registry.js.map +1 -0
  160. package/dist/extensions/resources.d.ts +105 -0
  161. package/dist/extensions/resources.js +595 -0
  162. package/dist/extensions/resources.js.map +1 -0
  163. package/dist/extensions/state.d.ts +25 -0
  164. package/dist/extensions/state.js +10 -0
  165. package/dist/extensions/state.js.map +1 -0
  166. package/dist/extensions/transfer.d.ts +81 -0
  167. package/dist/extensions/transfer.js +16 -0
  168. package/dist/extensions/transfer.js.map +1 -0
  169. package/dist/index.d.ts +7 -0
  170. package/dist/index.js +25 -0
  171. package/dist/index.js.map +1 -0
  172. package/dist/maintenance/configuration.d.ts +79 -0
  173. package/dist/maintenance/configuration.js +1503 -0
  174. package/dist/maintenance/configuration.js.map +1 -0
  175. package/dist/maintenance/credentials.d.ts +23 -0
  176. package/dist/maintenance/credentials.js +177 -0
  177. package/dist/maintenance/credentials.js.map +1 -0
  178. package/dist/maintenance/files.d.ts +2 -0
  179. package/dist/maintenance/files.js +40 -0
  180. package/dist/maintenance/files.js.map +1 -0
  181. package/dist/maintenance/npm.d.ts +71 -0
  182. package/dist/maintenance/npm.js +1013 -0
  183. package/dist/maintenance/npm.js.map +1 -0
  184. package/dist/maintenance/oauth.d.ts +45 -0
  185. package/dist/maintenance/oauth.js +686 -0
  186. package/dist/maintenance/oauth.js.map +1 -0
  187. package/dist/maintenance/requests.d.ts +347 -0
  188. package/dist/maintenance/requests.js +959 -0
  189. package/dist/maintenance/requests.js.map +1 -0
  190. package/dist/maintenance/work-git.d.ts +29 -0
  191. package/dist/maintenance/work-git.js +776 -0
  192. package/dist/maintenance/work-git.js.map +1 -0
  193. package/dist/process/backend.d.ts +54 -0
  194. package/dist/process/backend.js +39 -0
  195. package/dist/process/backend.js.map +1 -0
  196. package/dist/process/environment-windows.d.ts +15 -0
  197. package/dist/process/environment-windows.js +151 -0
  198. package/dist/process/environment-windows.js.map +1 -0
  199. package/dist/process/environment.d.ts +28 -0
  200. package/dist/process/environment.js +410 -0
  201. package/dist/process/environment.js.map +1 -0
  202. package/dist/process/launch.d.ts +31 -0
  203. package/dist/process/launch.js +281 -0
  204. package/dist/process/launch.js.map +1 -0
  205. package/dist/process/managed.d.ts +36 -0
  206. package/dist/process/managed.js +459 -0
  207. package/dist/process/managed.js.map +1 -0
  208. package/dist/process/output-log.d.ts +50 -0
  209. package/dist/process/output-log.js +552 -0
  210. package/dist/process/output-log.js.map +1 -0
  211. package/dist/process/pipes.d.ts +16 -0
  212. package/dist/process/pipes.js +588 -0
  213. package/dist/process/pipes.js.map +1 -0
  214. package/dist/process/pty.d.ts +22 -0
  215. package/dist/process/pty.js +512 -0
  216. package/dist/process/pty.js.map +1 -0
  217. package/dist/process/windows-conout-worker.d.ts +1 -0
  218. package/dist/process/windows-conout-worker.js +90 -0
  219. package/dist/process/windows-conout-worker.js.map +1 -0
  220. package/dist/process/windows-conout.d.ts +46 -0
  221. package/dist/process/windows-conout.js +140 -0
  222. package/dist/process/windows-conout.js.map +1 -0
  223. package/dist/process/windows-helper.d.ts +43 -0
  224. package/dist/process/windows-helper.js +255 -0
  225. package/dist/process/windows-helper.js.map +1 -0
  226. package/dist/process/windows-job.d.ts +39 -0
  227. package/dist/process/windows-job.js +224 -0
  228. package/dist/process/windows-job.js.map +1 -0
  229. package/dist/process/windows-pipes.d.ts +16 -0
  230. package/dist/process/windows-pipes.js +475 -0
  231. package/dist/process/windows-pipes.js.map +1 -0
  232. package/dist/results/artifacts.d.ts +118 -0
  233. package/dist/results/artifacts.js +873 -0
  234. package/dist/results/artifacts.js.map +1 -0
  235. package/dist/results/encoder.d.ts +57 -0
  236. package/dist/results/encoder.js +1179 -0
  237. package/dist/results/encoder.js.map +1 -0
  238. package/dist/results/mcp.d.ts +95 -0
  239. package/dist/results/mcp.js +656 -0
  240. package/dist/results/mcp.js.map +1 -0
  241. package/dist/results/media.d.ts +19 -0
  242. package/dist/results/media.js +301 -0
  243. package/dist/results/media.js.map +1 -0
  244. package/dist/results/normalize.d.ts +29 -0
  245. package/dist/results/normalize.js +464 -0
  246. package/dist/results/normalize.js.map +1 -0
  247. package/dist/runtime/control-scripts.d.ts +23 -0
  248. package/dist/runtime/control-scripts.js +242 -0
  249. package/dist/runtime/control-scripts.js.map +1 -0
  250. package/dist/runtime/engine.d.ts +177 -0
  251. package/dist/runtime/engine.js +1159 -0
  252. package/dist/runtime/engine.js.map +1 -0
  253. package/dist/runtime/globals.d.ts +1 -0
  254. package/dist/runtime/globals.js +31 -0
  255. package/dist/runtime/globals.js.map +1 -0
  256. package/dist/runtime/material-retention.d.ts +34 -0
  257. package/dist/runtime/material-retention.js +671 -0
  258. package/dist/runtime/material-retention.js.map +1 -0
  259. package/dist/runtime/modules.d.ts +50 -0
  260. package/dist/runtime/modules.js +320 -0
  261. package/dist/runtime/modules.js.map +1 -0
  262. package/dist/runtime/names.d.ts +2 -0
  263. package/dist/runtime/names.js +22 -0
  264. package/dist/runtime/names.js.map +1 -0
  265. package/dist/runtime/operations.d.ts +20 -0
  266. package/dist/runtime/operations.js +137 -0
  267. package/dist/runtime/operations.js.map +1 -0
  268. package/dist/runtime/paths.d.ts +3 -0
  269. package/dist/runtime/paths.js +38 -0
  270. package/dist/runtime/paths.js.map +1 -0
  271. package/dist/runtime/promises.d.ts +9 -0
  272. package/dist/runtime/promises.js +78 -0
  273. package/dist/runtime/promises.js.map +1 -0
  274. package/dist/runtime/retention.d.ts +88 -0
  275. package/dist/runtime/retention.js +735 -0
  276. package/dist/runtime/retention.js.map +1 -0
  277. package/dist/runtime/run-log.d.ts +30 -0
  278. package/dist/runtime/run-log.js +207 -0
  279. package/dist/runtime/run-log.js.map +1 -0
  280. package/dist/runtime/scripts.d.ts +84 -0
  281. package/dist/runtime/scripts.js +387 -0
  282. package/dist/runtime/scripts.js.map +1 -0
  283. package/dist/runtime/tasks.d.ts +54 -0
  284. package/dist/runtime/tasks.js +290 -0
  285. package/dist/runtime/tasks.js.map +1 -0
  286. package/dist/sdk/maintenance.d.ts +3 -0
  287. package/dist/sdk/maintenance.js +80 -0
  288. package/dist/sdk/maintenance.js.map +1 -0
  289. package/dist/sdk/output-extension.d.ts +3 -0
  290. package/dist/sdk/output-extension.js +44 -0
  291. package/dist/sdk/output-extension.js.map +1 -0
  292. package/dist/sdk/output.d.ts +52 -0
  293. package/dist/sdk/output.js +350 -0
  294. package/dist/sdk/output.js.map +1 -0
  295. package/dist/sdk/runtime.d.ts +3 -0
  296. package/dist/sdk/runtime.js +26 -0
  297. package/dist/sdk/runtime.js.map +1 -0
  298. package/dist/sdk/sh.d.ts +3 -0
  299. package/dist/sdk/sh.js +384 -0
  300. package/dist/sdk/sh.js.map +1 -0
  301. package/dist/sdk/state.d.ts +2 -0
  302. package/dist/sdk/state.js +69 -0
  303. package/dist/sdk/state.js.map +1 -0
  304. package/dist/sdk/transfer.d.ts +3 -0
  305. package/dist/sdk/transfer.js +141 -0
  306. package/dist/sdk/transfer.js.map +1 -0
  307. package/dist/services/extensions.d.ts +19 -0
  308. package/dist/services/extensions.js +183 -0
  309. package/dist/services/extensions.js.map +1 -0
  310. package/dist/services/state.d.ts +37 -0
  311. package/dist/services/state.js +125 -0
  312. package/dist/services/state.js.map +1 -0
  313. package/dist/services/transfer.d.ts +86 -0
  314. package/dist/services/transfer.js +948 -0
  315. package/dist/services/transfer.js.map +1 -0
  316. package/dist/storage/schema.d.ts +8 -0
  317. package/dist/storage/schema.js +241 -0
  318. package/dist/storage/schema.js.map +1 -0
  319. package/dist/storage/sqlite.d.ts +241 -0
  320. package/dist/storage/sqlite.js +1855 -0
  321. package/dist/storage/sqlite.js.map +1 -0
  322. package/dist/storage/transfers.d.ts +90 -0
  323. package/dist/storage/transfers.js +2 -0
  324. package/dist/storage/transfers.js.map +1 -0
  325. package/dist/transfer/io.d.ts +74 -0
  326. package/dist/transfer/io.js +425 -0
  327. package/dist/transfer/io.js.map +1 -0
  328. package/dist/transfer/offers.d.ts +72 -0
  329. package/dist/transfer/offers.js +380 -0
  330. package/dist/transfer/offers.js.map +1 -0
  331. package/dist/transfer/stream-slots.d.ts +12 -0
  332. package/dist/transfer/stream-slots.js +28 -0
  333. package/dist/transfer/stream-slots.js.map +1 -0
  334. package/dist/work/catalog.d.ts +43 -0
  335. package/dist/work/catalog.js +198 -0
  336. package/dist/work/catalog.js.map +1 -0
  337. package/dist/work/discovery.d.ts +70 -0
  338. package/dist/work/discovery.js +465 -0
  339. package/dist/work/discovery.js.map +1 -0
  340. package/dist/work/service.d.ts +83 -0
  341. package/dist/work/service.js +703 -0
  342. package/dist/work/service.js.map +1 -0
  343. package/package.json +66 -4
@@ -0,0 +1,653 @@
1
+ import { createHash } from "node:crypto";
2
+ import { discoverOAuthServerInfo, selectResourceURL, registerClient, startAuthorization, exchangeAuthorization, validateAuthorizationResponseIssuer, assertSecureTokenEndpoint, checkResourceAllowed, resourceUrlFromServerUrl, validateClientMetadataUrl, } from "@modelcontextprotocol/client";
3
+ import { AgentError, isAgentError, requireCondition, } from "../contracts/errors.js";
4
+ import { authorizeCall } from "../contracts/caller.js";
5
+ import { canonicalJson, isPlainRecord } from "../contracts/json.js";
6
+ function checkAttempt(session, expected) {
7
+ requireCondition(!expected ||
8
+ Object.entries(expected).every(([key, value]) => session.attempt[key] === value), "mcp_oauth_state_invalid", "The OAuth attempt was replaced while its native operation was in progress.");
9
+ }
10
+ const maxBytes = 1024 * 1024;
11
+ const copy = (value) => JSON.parse(canonicalJson(value, maxBytes));
12
+ // The official SDK constructs optional own properties with undefined values.
13
+ // Only its trusted typed protocol values take this finite JSON projection.
14
+ const protocolCopy = (value) => copy(JSON.parse(JSON.stringify(value)));
15
+ const hash = (value) => createHash("sha256").update(canonicalJson(value, maxBytes)).digest("hex");
16
+ const bounded = (value, maximum = 8192) => typeof value === "string" &&
17
+ value.length > 0 &&
18
+ Buffer.byteLength(value) <= maximum &&
19
+ !/[\0\r\n]/.test(value);
20
+ function endpoint(value) {
21
+ let url;
22
+ try {
23
+ url = new URL(value);
24
+ }
25
+ catch {
26
+ throw new AgentError("mcp_oauth_invalid_configuration", "OAuth needs an absolute HTTP(S) endpoint.");
27
+ }
28
+ requireCondition(bounded(value) &&
29
+ ["http:", "https:"].includes(url.protocol) &&
30
+ !url.username &&
31
+ !url.password &&
32
+ !url.hash, "mcp_oauth_invalid_configuration", "OAuth endpoints cannot contain embedded credentials or fragments.");
33
+ return url;
34
+ }
35
+ function secureEndpoint(value) {
36
+ const url = endpoint(value);
37
+ try {
38
+ return assertSecureTokenEndpoint(url);
39
+ }
40
+ catch {
41
+ throw new AgentError("mcp_oauth_insecure_endpoint", "OAuth authorization-server endpoints require HTTPS; loopback fixtures are allowed.");
42
+ }
43
+ }
44
+ /** Pure validation: never discovers, registers a client or launches a process. */
45
+ export function validateMcpOAuthConfig(value) {
46
+ const config = copy(value);
47
+ requireCondition(isPlainRecord(config) &&
48
+ Object.keys(config).every((key) => [
49
+ "clientMetadata",
50
+ "clientInformation",
51
+ "clientMetadataUrl",
52
+ "scope",
53
+ "issuer",
54
+ ].includes(key)), "mcp_oauth_invalid_configuration", "Only supported non-secret MCP OAuth configuration is accepted.");
55
+ if (config.clientMetadata !== undefined) {
56
+ requireCondition(isPlainRecord(config.clientMetadata) &&
57
+ Object.keys(config.clientMetadata).every((key) => [
58
+ "client_name",
59
+ "client_uri",
60
+ "logo_uri",
61
+ "redirect_uris",
62
+ "token_endpoint_auth_method",
63
+ "grant_types",
64
+ "response_types",
65
+ "scope",
66
+ "contacts",
67
+ "tos_uri",
68
+ "policy_uri",
69
+ "application_type",
70
+ ].includes(key)), "mcp_oauth_invalid_configuration", "MCP client metadata must contain supported public registration fields.");
71
+ const metadata = config.clientMetadata;
72
+ for (const key of [
73
+ "client_name",
74
+ "client_uri",
75
+ "logo_uri",
76
+ "scope",
77
+ "tos_uri",
78
+ "policy_uri",
79
+ ])
80
+ if (metadata[key] !== undefined)
81
+ requireCondition(bounded(metadata[key]), "mcp_oauth_invalid_configuration", "MCP client metadata fields must be bounded text.");
82
+ for (const key of [
83
+ "redirect_uris",
84
+ "grant_types",
85
+ "response_types",
86
+ "contacts",
87
+ ])
88
+ if (metadata[key] !== undefined)
89
+ requireCondition(Array.isArray(metadata[key]) &&
90
+ metadata[key].length <= 128 &&
91
+ metadata[key].every((item) => bounded(item)), "mcp_oauth_invalid_configuration", "MCP registration lists must contain bounded text entries.");
92
+ if (metadata.token_endpoint_auth_method !== undefined)
93
+ requireCondition(["none", "client_secret_basic", "client_secret_post"].includes(String(metadata.token_endpoint_auth_method)), "mcp_oauth_invalid_configuration", "This OAuth provider supports standard public/secret client authentication.");
94
+ if (metadata.application_type !== undefined)
95
+ requireCondition(["web", "native"].includes(String(metadata.application_type)), "mcp_oauth_invalid_configuration", "Use a supported OAuth application type.");
96
+ if (Array.isArray(metadata.grant_types))
97
+ requireCondition(metadata.grant_types.every((item) => ["authorization_code", "refresh_token"].includes(String(item))), "mcp_oauth_invalid_configuration", "MCP consent uses authorization code with PKCE and refresh.");
98
+ if (Array.isArray(metadata.response_types))
99
+ requireCondition(metadata.response_types.every((item) => item === "code"), "mcp_oauth_invalid_configuration", "MCP consent requires an authorization code response.");
100
+ }
101
+ if (config.clientInformation !== undefined) {
102
+ requireCondition(isPlainRecord(config.clientInformation) &&
103
+ Object.keys(config.clientInformation).every((key) => [
104
+ "client_id",
105
+ "client_id_issued_at",
106
+ "client_secret_expires_at",
107
+ ].includes(key)) &&
108
+ bounded(config.clientInformation.client_id), "mcp_oauth_invalid_configuration", "Pre-registered client information must not include secrets or tokens.");
109
+ for (const key of ["client_id_issued_at", "client_secret_expires_at"])
110
+ if (config.clientInformation[key] !== undefined)
111
+ requireCondition(Number.isSafeInteger(config.clientInformation[key]) &&
112
+ Number(config.clientInformation[key]) >= 0, "mcp_oauth_invalid_configuration", "OAuth registration timestamps must be nonnegative integers.");
113
+ }
114
+ if (config.clientMetadataUrl !== undefined) {
115
+ requireCondition(bounded(config.clientMetadataUrl), "mcp_oauth_invalid_configuration", "Use a bounded client metadata URL.");
116
+ endpoint(config.clientMetadataUrl);
117
+ try {
118
+ validateClientMetadataUrl(config.clientMetadataUrl);
119
+ }
120
+ catch {
121
+ throw new AgentError("mcp_oauth_invalid_configuration", "A client metadata document requires its public HTTPS URL with a non-root path.");
122
+ }
123
+ }
124
+ if (config.scope !== undefined)
125
+ requireCondition(bounded(config.scope) &&
126
+ config.scope
127
+ .split(" ")
128
+ .every((item) => /^[\x21\x23-\x5b\x5d-\x7e]+$/.test(item)), "mcp_oauth_invalid_configuration", "Use space-separated OAuth scope tokens.");
129
+ if (config.issuer !== undefined) {
130
+ requireCondition(bounded(config.issuer), "mcp_oauth_invalid_configuration", "Use a bounded issuer.");
131
+ requireCondition(!endpoint(config.issuer).search, "mcp_oauth_invalid_configuration", "An OAuth issuer cannot contain query parameters.");
132
+ }
133
+ return config;
134
+ }
135
+ function current(scope) {
136
+ scope.signal.throwIfAborted();
137
+ authorizeCall(() => scope.assertCurrent());
138
+ }
139
+ function access(scope, url) {
140
+ current(scope);
141
+ authorizeCall(() => scope.authorize({
142
+ type: "url",
143
+ value: endpoint(url).href,
144
+ access: "oauth",
145
+ }));
146
+ }
147
+ function safeFailure(error, signal) {
148
+ if (signal.aborted)
149
+ return new AgentError("mcp_oauth_cancelled", "The OAuth operation was cancelled after its native work settled.");
150
+ if (isAgentError(error))
151
+ return new AgentError(error.code, error.code.startsWith("mcp_oauth_") ||
152
+ error.code === "maintenance_auth_required"
153
+ ? error.message
154
+ : "The OAuth operation is not currently authorized.");
155
+ return new AgentError("mcp_oauth_failed", "The MCP OAuth operation failed; provider payloads and credentials are private.");
156
+ }
157
+ /** Agent-private storage and official SDK orchestration; never enters script SDK. */
158
+ export class McpOAuthService {
159
+ vault;
160
+ timeoutMs;
161
+ #writes = new Map();
162
+ constructor(vault, timeoutMs = 30000) {
163
+ this.vault = vault;
164
+ this.timeoutMs = timeoutMs;
165
+ requireCondition(Number.isSafeInteger(timeoutMs) && timeoutMs > 0 && timeoutMs <= 120000, "mcp_oauth_invalid_configuration", "OAuth requires a bounded native request deadline.");
166
+ }
167
+ #binding(config, ref, identity) {
168
+ const fixed = validateMcpOAuthConfig(config), bound = copy(identity);
169
+ requireCondition(bound.target === "mcp" &&
170
+ bound.scheme === "oauth" &&
171
+ [
172
+ "owner",
173
+ "agentId",
174
+ "profile",
175
+ "name",
176
+ "service",
177
+ "authRevision",
178
+ ].every((key) => bounded(bound[key])) &&
179
+ /^[a-f0-9]{64}$/.test(String(bound.authRevision)) &&
180
+ /^[a-f0-9]{64}$/.test(hash(fixed)) &&
181
+ /^cred_[a-f0-9]{48}$/.test(ref), "mcp_oauth_binding_invalid", "OAuth requires the fixed owner, Agent/profile, connection and configuration binding.");
182
+ requireCondition(bound.authRevision === hash(fixed), "mcp_oauth_binding_invalid", "The OAuth configuration changed outside its credential binding.");
183
+ return {
184
+ config: fixed,
185
+ identity: bound,
186
+ ref,
187
+ serverUrl: endpoint(String(bound.service)).href,
188
+ configHash: hash(fixed),
189
+ };
190
+ }
191
+ async #read(binding, scope, expected) {
192
+ current(scope);
193
+ const record = await this.vault.read(binding.ref, binding.identity), session = record.mcpOAuth;
194
+ current(scope);
195
+ requireCondition(isPlainRecord(session) &&
196
+ session.format === 1 &&
197
+ session.serverUrl === binding.serverUrl &&
198
+ session.configHash === binding.configHash &&
199
+ isPlainRecord(session.attempt), "maintenance_auth_required", "Complete MCP authorization for this exact connection configuration.");
200
+ checkAttempt(session, expected);
201
+ return { record, session: session };
202
+ }
203
+ async #mutate(binding, scope, mutate) {
204
+ const previous = this.#writes.get(binding.ref) ?? Promise.resolve();
205
+ const next = previous
206
+ .catch(() => { })
207
+ .then(async () => {
208
+ current(scope);
209
+ const record = await this.vault.read(binding.ref, binding.identity);
210
+ current(scope);
211
+ mutate(record);
212
+ current(scope);
213
+ await this.vault.update(binding.ref, binding.identity, record);
214
+ current(scope);
215
+ });
216
+ this.#writes.set(binding.ref, next);
217
+ try {
218
+ await next;
219
+ }
220
+ finally {
221
+ if (this.#writes.get(binding.ref) === next)
222
+ this.#writes.delete(binding.ref);
223
+ }
224
+ }
225
+ async #set(binding, scope, mutate, expected) {
226
+ await this.#mutate(binding, scope, (record) => {
227
+ const session = record.mcpOAuth;
228
+ requireCondition(isPlainRecord(session) &&
229
+ session.configHash === binding.configHash &&
230
+ session.serverUrl === binding.serverUrl, "mcp_oauth_binding_invalid", "The OAuth session no longer belongs to this configuration.");
231
+ checkAttempt(session, expected);
232
+ mutate(session, record);
233
+ });
234
+ }
235
+ #provider(binding, scope, callbackUrl, interactive, expected) {
236
+ const metadata = {
237
+ client_name: "Nexum",
238
+ token_endpoint_auth_method: "none",
239
+ grant_types: ["authorization_code", "refresh_token"],
240
+ response_types: ["code"],
241
+ ...binding.config.clientMetadata,
242
+ redirect_uris: [callbackUrl],
243
+ };
244
+ const configuredRedirects = binding.config.clientMetadata?.redirect_uris;
245
+ requireCondition(!Array.isArray(configuredRedirects) ||
246
+ configuredRedirects.includes(callbackUrl), "mcp_oauth_invalid_configuration", "The registered redirect URI must include the platform callback.");
247
+ const checkIssuer = (discovery) => {
248
+ const issuer = discovery.authorizationServerMetadata?.issuer ??
249
+ discovery.authorizationServerUrl;
250
+ requireCondition(!binding.config.issuer || binding.config.issuer === issuer, "mcp_oauth_issuer_mismatch", "Discovery did not match the configured issuer.");
251
+ secureEndpoint(issuer);
252
+ for (const key of [
253
+ "authorization_endpoint",
254
+ "token_endpoint",
255
+ "registration_endpoint",
256
+ ]) {
257
+ const value = discovery.authorizationServerMetadata?.[key];
258
+ if (value)
259
+ secureEndpoint(value);
260
+ }
261
+ return issuer;
262
+ };
263
+ const service = this;
264
+ const read = () => service.#read(binding, scope, expected);
265
+ const set = (mutate) => service.#set(binding, scope, mutate, expected);
266
+ return {
267
+ redirectUrl: callbackUrl,
268
+ clientMetadata: copy(metadata),
269
+ ...(binding.config.clientMetadataUrl
270
+ ? { clientMetadataUrl: binding.config.clientMetadataUrl }
271
+ : {}),
272
+ async state() {
273
+ requireCondition(interactive, "maintenance_auth_required", "Renew MCP consent through the user authorization page.");
274
+ return (await read()).session.attempt.state;
275
+ },
276
+ async clientInformation(ctx) {
277
+ const { record, session } = await read();
278
+ const info = session.clientInfo ?? binding.config.clientInformation;
279
+ if (!info || (ctx && info.issuer && info.issuer !== ctx.issuer))
280
+ return undefined;
281
+ const issuer = session.discovery
282
+ ?.authorizationServerMetadata?.issuer ??
283
+ session.discovery
284
+ ?.authorizationServerUrl;
285
+ if (ctx && issuer && ctx.issuer !== issuer)
286
+ return undefined;
287
+ return copy({
288
+ ...info,
289
+ ...(info.token_endpoint_auth_method === undefined &&
290
+ binding.config.clientMetadata?.token_endpoint_auth_method
291
+ ? {
292
+ token_endpoint_auth_method: binding.config.clientMetadata.token_endpoint_auth_method,
293
+ }
294
+ : {}),
295
+ ...(binding.config.clientInformation &&
296
+ typeof record.clientSecret === "string"
297
+ ? { client_secret: record.clientSecret }
298
+ : {}),
299
+ });
300
+ },
301
+ async saveClientInformation(info, ctx) {
302
+ requireCondition(interactive || (await read()).session.clientInfo !== undefined, "maintenance_auth_required", "Client registration changes require the authorization page.");
303
+ requireCondition(!ctx || info.issuer === ctx.issuer, "mcp_oauth_issuer_mismatch", "Client registration must retain its issuer.");
304
+ await set((session) => {
305
+ session.clientInfo = copy(info);
306
+ });
307
+ },
308
+ async tokens(ctx) {
309
+ const { session } = await read();
310
+ if (session.attempt.phase !== "completed")
311
+ return undefined;
312
+ const tokens = session.tokens;
313
+ return tokens && (!ctx || tokens.issuer === ctx.issuer)
314
+ ? copy(tokens)
315
+ : undefined;
316
+ },
317
+ async saveTokens(tokens, ctx) {
318
+ requireCondition(bounded(tokens.access_token, 65536) &&
319
+ (!ctx || tokens.issuer === ctx.issuer), "mcp_oauth_invalid_tokens", "OAuth tokens must retain their authorized issuer.");
320
+ await set((session) => {
321
+ const discovery = session.discovery;
322
+ requireCondition(tokens.issuer === checkIssuer(discovery), "mcp_oauth_issuer_mismatch", "Tokens cannot change their authorized issuer.");
323
+ const old = session.tokens;
324
+ session.tokens = copy({
325
+ ...tokens,
326
+ ...(tokens.refresh_token === undefined && old?.refresh_token
327
+ ? { refresh_token: old.refresh_token }
328
+ : {}),
329
+ });
330
+ });
331
+ },
332
+ async redirectToAuthorization(url) {
333
+ requireCondition(interactive, "maintenance_auth_required", "Renew MCP consent through the user authorization page.");
334
+ secureEndpoint(url.href);
335
+ access(scope, url.href);
336
+ await set((session) => {
337
+ session.authorizationUrl = url.href;
338
+ session.attempt.phase = "pending";
339
+ });
340
+ },
341
+ async saveCodeVerifier(value) {
342
+ requireCondition(interactive && /^[A-Za-z0-9._~-]{43,128}$/.test(value), "maintenance_auth_required", "PKCE preparation requires an interactive authorization request.");
343
+ await set((session) => {
344
+ session.verifier = value;
345
+ });
346
+ },
347
+ async codeVerifier() {
348
+ const { session } = await read();
349
+ requireCondition(bounded(session.verifier, 128), "mcp_oauth_state_invalid", "The authorization attempt has no matching PKCE verifier.");
350
+ return session.verifier;
351
+ },
352
+ async saveDiscoveryState(value) {
353
+ const issuer = checkIssuer(value);
354
+ await set((session) => {
355
+ if (!interactive && session.discovery)
356
+ requireCondition(checkIssuer(session.discovery) === issuer, "maintenance_auth_required", "Changing authorization server requires user confirmation.");
357
+ session.discovery = protocolCopy(value);
358
+ });
359
+ },
360
+ async discoveryState() {
361
+ const { session } = await read();
362
+ return session.discovery
363
+ ? copy(session.discovery)
364
+ : undefined;
365
+ },
366
+ async invalidateCredentials(kind) {
367
+ await set((session) => {
368
+ if (kind === "all" || kind === "tokens")
369
+ delete session.tokens;
370
+ if (kind === "all" || kind === "client")
371
+ delete session.clientInfo;
372
+ if (kind === "all" || kind === "verifier")
373
+ delete session.verifier;
374
+ if (kind === "all" || kind === "discovery")
375
+ delete session.discovery;
376
+ });
377
+ },
378
+ async validateResourceURL(serverUrl, resource) {
379
+ current(scope);
380
+ const expected = resourceUrlFromServerUrl(binding.serverUrl);
381
+ requireCondition(resourceUrlFromServerUrl(serverUrl).href === expected.href &&
382
+ (!resource ||
383
+ checkResourceAllowed({
384
+ requestedResource: expected,
385
+ configuredResource: resource,
386
+ })), "mcp_oauth_resource_mismatch", "OAuth resource must match this exact MCP connection.");
387
+ return resource ? new URL(resource) : expected;
388
+ },
389
+ };
390
+ }
391
+ async #run(scope, action) {
392
+ const timeout = AbortSignal.timeout(this.timeoutMs), signal = AbortSignal.any([scope.signal, timeout]);
393
+ const operation = {
394
+ signal,
395
+ assertCurrent: () => current(scope),
396
+ authorize: (target) => scope.authorize(target),
397
+ };
398
+ try {
399
+ current(operation);
400
+ const value = await action(operation);
401
+ current(operation);
402
+ return value;
403
+ }
404
+ catch (error) {
405
+ if (timeout.aborted && signal.reason === timeout.reason)
406
+ throw new AgentError("mcp_oauth_timeout", "The OAuth deadline expired after its native work settled.");
407
+ throw safeFailure(error, signal);
408
+ }
409
+ }
410
+ #fetch(scope) {
411
+ return async (target, init = {}) => {
412
+ const url = secureEndpoint(target instanceof Request ? target.url : String(target)).href;
413
+ access(scope, url);
414
+ const signal = AbortSignal.any([
415
+ scope.signal,
416
+ ...(init.signal ? [init.signal] : []),
417
+ ]);
418
+ const headers = new Headers(init.headers);
419
+ requireCondition(!headers.has("cookie") && !headers.has("proxy-authorization"), "mcp_oauth_invalid_transport", "OAuth does not inherit platform cookies or proxy credentials.");
420
+ const response = await fetch(url, {
421
+ ...init,
422
+ headers,
423
+ signal,
424
+ redirect: "error",
425
+ credentials: "omit",
426
+ });
427
+ const chunks = [];
428
+ let size = 0;
429
+ if (response.body) {
430
+ const reader = response.body.getReader();
431
+ try {
432
+ while (true) {
433
+ current(scope);
434
+ const item = await reader.read();
435
+ if (item.done)
436
+ break;
437
+ size += item.value.byteLength;
438
+ requireCondition(size <= maxBytes, "mcp_oauth_response_too_large", "OAuth metadata and token responses exceed their byte budget.");
439
+ chunks.push(item.value);
440
+ }
441
+ }
442
+ finally {
443
+ await reader.cancel().catch(() => { });
444
+ await reader.closed.catch(() => { });
445
+ }
446
+ }
447
+ current(scope);
448
+ return new Response(size ? Buffer.concat(chunks, size) : null, {
449
+ status: response.status,
450
+ statusText: response.statusText,
451
+ headers: response.headers,
452
+ });
453
+ };
454
+ }
455
+ async start(config, ref, identity, authorization, scope) {
456
+ const binding = this.#binding(config, ref, identity), fixed = copy(authorization);
457
+ requireCondition(scope.caller.principalId === identity.owner &&
458
+ bounded(fixed.state, 4096) &&
459
+ bounded(fixed.schemeId) &&
460
+ /^[a-f0-9]{64}$/.test(fixed.candidateRevision), "mcp_oauth_binding_invalid", "Consent must use the current owner and candidate identity.");
461
+ endpoint(fixed.callbackUrl);
462
+ const expected = {
463
+ state: fixed.state,
464
+ requestId: scope.requestId,
465
+ revision: scope.revision,
466
+ schemeId: fixed.schemeId,
467
+ candidateRevision: fixed.candidateRevision,
468
+ };
469
+ return this.#run(scope, async (operation) => {
470
+ await this.#mutate(binding, operation, (record) => {
471
+ const old = record.mcpOAuth;
472
+ record.mcpOAuth = {
473
+ format: 1,
474
+ serverUrl: binding.serverUrl,
475
+ configHash: binding.configHash,
476
+ callbackUrl: fixed.callbackUrl,
477
+ ...(old?.configHash === binding.configHash && old.clientInfo
478
+ ? { clientInfo: old.clientInfo }
479
+ : {}),
480
+ attempt: {
481
+ state: fixed.state,
482
+ requestId: scope.requestId,
483
+ revision: scope.revision,
484
+ schemeId: fixed.schemeId,
485
+ candidateRevision: fixed.candidateRevision,
486
+ expiresAt: Date.now() + 15 * 60 * 1000,
487
+ phase: "preparing",
488
+ },
489
+ };
490
+ });
491
+ const provider = this.#provider(binding, operation, fixed.callbackUrl, true, expected);
492
+ const fetchFn = this.#fetch(operation);
493
+ const discovery = await discoverOAuthServerInfo(binding.serverUrl, {
494
+ fetchFn,
495
+ });
496
+ await provider.saveDiscoveryState(discovery);
497
+ const issuer = discovery.authorizationServerMetadata?.issuer ??
498
+ discovery.authorizationServerUrl;
499
+ const context = { issuer }, metadata = discovery.authorizationServerMetadata;
500
+ let info = await provider.clientInformation(context);
501
+ if (!info)
502
+ info =
503
+ metadata?.client_id_metadata_document_supported &&
504
+ binding.config.clientMetadataUrl
505
+ ? { client_id: binding.config.clientMetadataUrl, issuer }
506
+ : {
507
+ ...(await registerClient(discovery.authorizationServerUrl, {
508
+ metadata,
509
+ clientMetadata: provider.clientMetadata,
510
+ fetchFn,
511
+ })),
512
+ issuer,
513
+ };
514
+ info = { ...info, issuer };
515
+ await provider.saveClientInformation(info, context);
516
+ const selectedResource = await selectResourceURL(binding.serverUrl, provider, discovery.resourceMetadata);
517
+ const resource = discovery.resourceMetadata?.resource ?? selectedResource;
518
+ const scopeText = binding.config.scope ??
519
+ (String(binding.config.clientMetadata?.scope ?? "") || undefined);
520
+ const { authorizationUrl, codeVerifier } = await startAuthorization(discovery.authorizationServerUrl, {
521
+ metadata,
522
+ clientInformation: info,
523
+ redirectUrl: fixed.callbackUrl,
524
+ state: fixed.state,
525
+ scope: scopeText,
526
+ resource,
527
+ });
528
+ await provider.saveCodeVerifier(codeVerifier);
529
+ await provider.redirectToAuthorization(authorizationUrl);
530
+ const { session } = await this.#read(binding, operation, expected);
531
+ requireCondition(bounded(session.authorizationUrl, 32768), "mcp_oauth_failed", "The official provider did not prepare a consent redirect.");
532
+ return {
533
+ authorizationUrl: session.authorizationUrl,
534
+ issuer: discovery.authorizationServerMetadata?.issuer ??
535
+ discovery.authorizationServerUrl,
536
+ requireIssuer: discovery.authorizationServerMetadata
537
+ ?.authorization_response_iss_parameter_supported === true,
538
+ };
539
+ });
540
+ }
541
+ async complete(config, ref, identity, input, scope) {
542
+ const binding = this.#binding(config, ref, identity), fixed = copy(input);
543
+ const expected = {
544
+ state: fixed.callback.state,
545
+ requestId: scope.requestId,
546
+ revision: scope.revision,
547
+ schemeId: fixed.schemeId,
548
+ candidateRevision: fixed.candidateRevision,
549
+ };
550
+ return this.#run(scope, async (operation) => {
551
+ await this.#set(binding, operation, (session) => {
552
+ const attempt = session.attempt;
553
+ requireCondition(scope.caller.principalId === identity.owner &&
554
+ attempt.phase === "pending" &&
555
+ attempt.expiresAt > Date.now() &&
556
+ attempt.requestId === scope.requestId &&
557
+ attempt.revision === scope.revision &&
558
+ attempt.state === fixed.callback.state &&
559
+ attempt.schemeId === fixed.schemeId &&
560
+ attempt.candidateRevision === fixed.candidateRevision, "mcp_oauth_state_invalid", "The authorization callback does not match the original pending attempt.");
561
+ attempt.phase = "exchanging";
562
+ }, expected);
563
+ try {
564
+ requireCondition(!fixed.callback.error && bounded(fixed.callback.code, 65536), "mcp_oauth_denied", "The user or provider declined this authorization attempt.");
565
+ const { session } = await this.#read(binding, operation, expected);
566
+ const provider = this.#provider(binding, operation, session.callbackUrl, true, expected);
567
+ const discovery = session.discovery;
568
+ requireCondition(discovery?.authorizationServerUrl, "mcp_oauth_state_invalid", "Authorization requires the server discovery recorded before redirect.");
569
+ const issuer = discovery.authorizationServerMetadata?.issuer ??
570
+ discovery.authorizationServerUrl;
571
+ validateAuthorizationResponseIssuer({
572
+ iss: fixed.callback.issuer,
573
+ expectedIssuer: issuer,
574
+ issParameterSupported: discovery.authorizationServerMetadata
575
+ ?.authorization_response_iss_parameter_supported === true,
576
+ });
577
+ const info = await provider.clientInformation({ issuer });
578
+ requireCondition(info && info.issuer === issuer, "mcp_oauth_issuer_mismatch", "The client registration no longer matches the original issuer.");
579
+ const selectedResource = await selectResourceURL(binding.serverUrl, provider, discovery.resourceMetadata);
580
+ const resource = discovery.resourceMetadata?.resource ?? selectedResource;
581
+ const tokens = await exchangeAuthorization(discovery.authorizationServerUrl, {
582
+ metadata: discovery.authorizationServerMetadata,
583
+ clientInformation: info,
584
+ authorizationCode: fixed.callback.code,
585
+ ...(fixed.callback.issuer ? { iss: fixed.callback.issuer } : {}),
586
+ codeVerifier: await provider.codeVerifier(),
587
+ redirectUri: session.callbackUrl,
588
+ resource,
589
+ fetchFn: this.#fetch(operation),
590
+ });
591
+ await provider.saveTokens({ ...tokens, issuer }, { issuer });
592
+ await this.#set(binding, operation, (session) => {
593
+ requireCondition(session.attempt.phase === "exchanging", "mcp_oauth_state_invalid", "Only the matching admitted exchange may complete.");
594
+ session.attempt.phase = "completed";
595
+ delete session.verifier;
596
+ delete session.authorizationUrl;
597
+ }, expected);
598
+ return ref;
599
+ }
600
+ catch (error) {
601
+ // An admitted code exchange is never replayed after unknown I/O outcome.
602
+ // A cancelled/revoked scope cannot write; phase remains exchanging.
603
+ if (!operation.signal.aborted) {
604
+ try {
605
+ await this.#set(binding, operation, (session) => {
606
+ session.attempt.phase = "failed";
607
+ delete session.verifier;
608
+ }, expected);
609
+ }
610
+ catch { }
611
+ }
612
+ throw error;
613
+ }
614
+ });
615
+ }
616
+ async ready(config, ref, identity, scope) {
617
+ const binding = this.#binding(config, ref, identity);
618
+ requireCondition(scope.caller.principalId === binding.identity.owner, "mcp_oauth_binding_invalid", "OAuth credentials belong to their original owner.");
619
+ current(scope);
620
+ const record = await this.vault.read(ref, binding.identity);
621
+ current(scope);
622
+ const session = record.mcpOAuth;
623
+ return (isPlainRecord(session) &&
624
+ session.configHash === binding.configHash &&
625
+ session.serverUrl === binding.serverUrl &&
626
+ isPlainRecord(session.attempt) &&
627
+ session.attempt.phase === "completed" &&
628
+ isPlainRecord(session.tokens) &&
629
+ bounded(session.tokens.access_token, 65536));
630
+ }
631
+ async provider(config, ref, identity, scope) {
632
+ const binding = this.#binding(config, ref, identity);
633
+ requireCondition(await this.ready(config, ref, identity, scope), "maintenance_auth_required", "Complete the connection's OAuth consent before approving activation.");
634
+ const callbackUrl = (await this.#read(binding, scope)).session.callbackUrl;
635
+ // No apply/request/run scope is retained by the returned factory.
636
+ return (host) => {
637
+ requireCondition(host.context.agentId === binding.identity.agentId &&
638
+ host.context.profile === binding.identity.profile, "mcp_oauth_binding_invalid", "OAuth credentials cannot bind to another Agent or profile.");
639
+ const runtime = {
640
+ signal: host.signal,
641
+ assertCurrent: () => host.authorize({
642
+ type: "connection",
643
+ value: String(binding.identity.name),
644
+ access: "oauth",
645
+ }),
646
+ authorize: (target) => host.authorize(target),
647
+ };
648
+ current(runtime);
649
+ return this.#provider(binding, runtime, callbackUrl, false);
650
+ };
651
+ }
652
+ }
653
+ //# sourceMappingURL=mcp-oauth.js.map