@nexum-hub/agent 0.0.0-stage → 0.0.2

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 +133 -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,22 @@
1
+ import { type Transport, type OAuthClientProvider } from "@modelcontextprotocol/client";
2
+ import type { ManagedResource } from "../extensions/resources.js";
3
+ export interface ManagedHttpTransportOptions {
4
+ readonly url: string;
5
+ readonly headers?: Readonly<Record<string, string>>;
6
+ /** Trusted approved source service; never decoded from connection JSON. */
7
+ readonly authProvider?: OAuthClientProvider;
8
+ readonly maxMessageBytes: number;
9
+ authorize(url: string): void;
10
+ }
11
+ /**
12
+ * Cold official MCP transport with resource ownership of the underlying HTTP
13
+ * exchanges. SDK onclose is notification, not proof that a body has closed.
14
+ */
15
+ export declare class ManagedHttpTransport implements ManagedResource {
16
+ #private;
17
+ readonly transport: Transport;
18
+ readonly closed: Promise<void>;
19
+ constructor(options: ManagedHttpTransportOptions);
20
+ run<T>(signal: AbortSignal, callback: () => Promise<T>): Promise<T>;
21
+ dispose(reason?: unknown): Promise<void>;
22
+ }
@@ -0,0 +1,472 @@
1
+ import { AsyncLocalStorage } from "node:async_hooks";
2
+ import { StreamableHTTPClientTransport, isJSONRPCRequest, discoverOAuthServerInfo, extractResourceMetadataUrl, selectResourceURL, refreshAuthorization, assertSecureTokenEndpoint, } from "@modelcontextprotocol/client";
3
+ import { AgentError, requireCondition } from "../contracts/errors.js";
4
+ /** Bound wire bytes between SSE blank lines; the official SDK owns parsing. */
5
+ function frameBudget(limit) {
6
+ let frameBytes = 0, lineBytes = 0, afterCR = false, resetAfterCR = false;
7
+ const count = () => {
8
+ requireCondition(++frameBytes <= limit, "mcp_message_too_large", "An MCP HTTP event exceeds the configured message byte limit.");
9
+ };
10
+ return (bytes) => {
11
+ for (const byte of bytes) {
12
+ if (afterCR) {
13
+ afterCR = false;
14
+ if (byte === 10) {
15
+ count();
16
+ if (resetAfterCR)
17
+ frameBytes = 0;
18
+ resetAfterCR = false;
19
+ continue;
20
+ }
21
+ if (resetAfterCR)
22
+ frameBytes = 0;
23
+ resetAfterCR = false;
24
+ }
25
+ count();
26
+ if (byte === 13 || byte === 10) {
27
+ const blank = lineBytes === 0;
28
+ lineBytes = 0;
29
+ if (byte === 13) {
30
+ afterCR = true;
31
+ resetAfterCR = blank;
32
+ }
33
+ else if (blank)
34
+ frameBytes = 0;
35
+ }
36
+ else
37
+ lineBytes++;
38
+ }
39
+ };
40
+ }
41
+ /**
42
+ * Cold official MCP transport with resource ownership of the underlying HTTP
43
+ * exchanges. SDK onclose is notification, not proof that a body has closed.
44
+ */
45
+ export class ManagedHttpTransport {
46
+ transport;
47
+ closed;
48
+ #lifetime = new AbortController();
49
+ #calls = new AsyncLocalStorage();
50
+ #pending = new Set();
51
+ #closeSdk;
52
+ #resolveClosed;
53
+ #disposal;
54
+ #limit;
55
+ #authorize;
56
+ #oauth;
57
+ #sourceUrl;
58
+ #sourceHeaders;
59
+ #generation = 0;
60
+ #sharedGeneration = 0;
61
+ #refresh;
62
+ constructor(options) {
63
+ requireCondition(!options.authProvider?.dpop, "mcp_oauth_unsupported", "This MCP transport supports bearer OAuth; DPoP requires a proof-aware transport.");
64
+ requireCondition(!options.authProvider ||
65
+ !new Headers(options.headers).has("authorization"), "invalid_mcp_config", "Choose bearer OAuth or a static Authorization header for this connection.");
66
+ requireCondition(Number.isSafeInteger(options.maxMessageBytes) &&
67
+ options.maxMessageBytes > 0, "invalid_mcp_config", "MCP HTTP message limits must be positive bounded integers.");
68
+ this.#limit = options.maxMessageBytes;
69
+ this.#authorize = options.authorize;
70
+ this.#oauth = options.authProvider !== undefined;
71
+ const url = new URL(options.url);
72
+ this.#sourceUrl = url.href;
73
+ this.#sourceHeaders = Object.freeze({ ...options.headers });
74
+ requireCondition((url.protocol === "http:" || url.protocol === "https:") &&
75
+ !url.username &&
76
+ !url.password, "invalid_mcp_config", "MCP HTTP requires an HTTP URL without embedded credentials.");
77
+ const closure = Promise.withResolvers();
78
+ this.closed = closure.promise;
79
+ this.#resolveClosed = closure.resolve;
80
+ const sdk = new StreamableHTTPClientTransport(url, {
81
+ // Do not let the SDK merge source headers into AS fetches. Injection
82
+ // happens below only at the exact MCP endpoint, outside OAuth exchanges.
83
+ requestInit: { redirect: "error" },
84
+ fetch: (target, init) => this.#fetch(target, init),
85
+ ...(options.authProvider
86
+ ? { authProvider: this.#authentication(options.authProvider) }
87
+ : {}),
88
+ onInsufficientScope: "throw",
89
+ maxStepUpRetries: 0,
90
+ });
91
+ this.#closeSdk = sdk.close.bind(sdk);
92
+ const send = sdk.send.bind(sdk);
93
+ sdk.send = (message, sendOptions) => {
94
+ const messages = Array.isArray(message) ? message : [message];
95
+ // The initialized notification starts the shared GET in its async
96
+ // descendants. Clear call context there; request recovery GETs retain it.
97
+ return messages.some(isJSONRPCRequest)
98
+ ? send(message, sendOptions)
99
+ : this.#calls.exit(() => send(message, sendOptions));
100
+ };
101
+ // Keep the official transport's complete API and per-request stream flag.
102
+ // Client.close() must use the same physical closure path as resource stop.
103
+ sdk.close = () => this.dispose();
104
+ this.transport = sdk;
105
+ }
106
+ async run(signal, callback) {
107
+ this.#lifetime.signal.throwIfAborted();
108
+ signal.throwIfAborted();
109
+ const ended = new AbortController();
110
+ const scope = {
111
+ signal,
112
+ authSignal: AbortSignal.any([signal, ended.signal]),
113
+ pending: new Set(),
114
+ authentication: new Set(),
115
+ active: true,
116
+ };
117
+ try {
118
+ return await this.#calls.run(scope, callback);
119
+ }
120
+ finally {
121
+ scope.active = false;
122
+ ended.abort(new AgentError("mcp_call_closed", "The MCP operation has completed its observation."));
123
+ await Promise.allSettled(scope.authentication);
124
+ // The callback owns the SDK result promise. Once it settles, a server
125
+ // retaining its POST stream must not retain the finished operation.
126
+ // The shared GET and notifications belong to the resource, not this set.
127
+ for (const pending of scope.pending) {
128
+ if (pending.cancel)
129
+ void pending.cancel(signal.reason);
130
+ else
131
+ pending.controller.abort(signal.reason);
132
+ }
133
+ await this.#drain(scope.pending);
134
+ signal.throwIfAborted();
135
+ }
136
+ }
137
+ dispose(reason) {
138
+ if (!this.#disposal) {
139
+ this.#disposal = (async () => {
140
+ this.#lifetime.abort(reason);
141
+ try {
142
+ await this.#closeSdk();
143
+ }
144
+ finally {
145
+ await this.#refresh?.done;
146
+ await this.#drain(this.#pending);
147
+ this.#calls.disable();
148
+ this.#resolveClosed();
149
+ }
150
+ })();
151
+ }
152
+ return this.#disposal;
153
+ }
154
+ async #drain(pending) {
155
+ while (pending.size)
156
+ await Promise.all([...pending].map((entry) => entry.done));
157
+ }
158
+ #authentication(provider) {
159
+ return {
160
+ token: async () => {
161
+ const generation = this.#generation;
162
+ const tokens = await provider.tokens();
163
+ const scope = this.#calls.getStore();
164
+ if (scope)
165
+ scope.authGeneration = generation;
166
+ else
167
+ this.#sharedGeneration = generation;
168
+ return tokens?.access_token;
169
+ },
170
+ onUnauthorized: async (context) => {
171
+ const owner = this.#calls.getStore();
172
+ const signal = owner?.authSignal ?? owner?.signal ?? this.#lifetime.signal;
173
+ signal.throwIfAborted();
174
+ requireCondition(!owner || owner.active, "mcp_call_closed", "The requesting operation is closed.");
175
+ const generation = owner?.authGeneration ?? this.#sharedGeneration;
176
+ if (generation !== this.#generation)
177
+ return;
178
+ let refresh = this.#refresh;
179
+ // A last-waiter cancellation may still be settling real native I/O.
180
+ // A new request observes that closure instead of joining its aborted
181
+ // authentication scope or starting an overlapping token exchange.
182
+ while (refresh?.scope.signal.aborted) {
183
+ await refresh.done;
184
+ signal.throwIfAborted();
185
+ requireCondition(!owner || owner.active, "mcp_call_closed", "The requesting operation is closed.");
186
+ if (generation !== this.#generation)
187
+ return;
188
+ refresh = this.#refresh;
189
+ }
190
+ if (!refresh) {
191
+ const controller = new AbortController();
192
+ const scope = {
193
+ signal: AbortSignal.any([
194
+ this.#lifetime.signal,
195
+ controller.signal,
196
+ AbortSignal.timeout(30000),
197
+ ]),
198
+ pending: new Set(),
199
+ active: true,
200
+ oauth: true,
201
+ };
202
+ refresh = {
203
+ controller,
204
+ scope,
205
+ waiters: new Set(),
206
+ stopped: new Set(),
207
+ done: Promise.resolve(),
208
+ };
209
+ this.#refresh = refresh;
210
+ const active = refresh;
211
+ // Native shared authentication belongs to the registered connection.
212
+ // A cancelled waiter cannot destroy a refresh still needed by others.
213
+ active.done = Promise.resolve().then(async () => {
214
+ let failure;
215
+ try {
216
+ await this.#calls.run(scope, async () => {
217
+ scope.signal.throwIfAborted();
218
+ const cached = await provider.discoveryState?.();
219
+ const resourceMetadataUrl = extractResourceMetadataUrl(context.response);
220
+ const discovery = cached && !resourceMetadataUrl
221
+ ? cached
222
+ : await discoverOAuthServerInfo(context.serverUrl, {
223
+ fetchFn: context.fetchFn,
224
+ ...(resourceMetadataUrl ? { resourceMetadataUrl } : {}),
225
+ });
226
+ const issuer = discovery.authorizationServerMetadata?.issuer ??
227
+ discovery.authorizationServerUrl;
228
+ assertSecureTokenEndpoint(issuer);
229
+ const oldIssuer = cached?.authorizationServerMetadata?.issuer ??
230
+ cached?.authorizationServerUrl;
231
+ requireCondition(!oldIssuer || oldIssuer === issuer, "maintenance_auth_required", "Changing OAuth issuer requires user confirmation.");
232
+ await provider.saveDiscoveryState?.(discovery);
233
+ const ctx = { issuer }, tokens = await provider.tokens(ctx), info = await provider.clientInformation(ctx);
234
+ requireCondition(tokens?.refresh_token &&
235
+ info &&
236
+ (!tokens.issuer || tokens.issuer === issuer) &&
237
+ (!info.issuer || info.issuer === issuer), "maintenance_auth_required", "Renew MCP consent through the authorization page.");
238
+ const selectedResource = await selectResourceURL(context.serverUrl, provider, discovery.resourceMetadata);
239
+ const resource = discovery.resourceMetadata?.resource ?? selectedResource;
240
+ const result = await refreshAuthorization(discovery.authorizationServerUrl, {
241
+ metadata: discovery.authorizationServerMetadata,
242
+ clientInformation: info,
243
+ refreshToken: tokens.refresh_token,
244
+ scope: await provider.scopeForRefresh?.(tokens),
245
+ resource,
246
+ addClientAuthentication: provider.addClientAuthentication,
247
+ fetchFn: context.fetchFn,
248
+ });
249
+ scope.signal.throwIfAborted();
250
+ await provider.saveTokens({ ...result, issuer }, ctx);
251
+ scope.signal.throwIfAborted();
252
+ });
253
+ this.#generation++;
254
+ }
255
+ catch (error) {
256
+ if (!scope.signal.aborted &&
257
+ error &&
258
+ typeof error === "object" &&
259
+ "code" in error &&
260
+ [
261
+ "invalid_grant",
262
+ "invalid_client",
263
+ "unauthorized_client",
264
+ ].includes(String(error.code))) {
265
+ try {
266
+ await provider.invalidateCredentials?.("tokens");
267
+ }
268
+ catch { }
269
+ failure = new AgentError("maintenance_auth_required", "The MCP authorization must be renewed through the user page.");
270
+ }
271
+ else
272
+ failure = new AgentError(scope.signal.aborted
273
+ ? "mcp_oauth_cancelled"
274
+ : error instanceof AgentError
275
+ ? error.code
276
+ : "mcp_oauth_failed", scope.signal.aborted
277
+ ? "The OAuth operation was cancelled after its native work settled."
278
+ : "The MCP authorization operation failed; provider details are private.");
279
+ }
280
+ finally {
281
+ scope.active = false;
282
+ for (const pending of scope.pending) {
283
+ if (pending.cancel)
284
+ void pending.cancel();
285
+ else
286
+ pending.controller.abort();
287
+ }
288
+ await this.#drain(scope.pending);
289
+ if (this.#refresh === active)
290
+ this.#refresh = undefined;
291
+ for (const waiter of [...active.waiters, ...active.stopped]) {
292
+ waiter.signal.removeEventListener("abort", waiter.abort);
293
+ if (waiter.signal.aborted)
294
+ waiter.reject(new AgentError("mcp_oauth_cancelled", "This OAuth waiter was cancelled."));
295
+ else if (failure)
296
+ waiter.reject(failure);
297
+ else
298
+ waiter.resolve();
299
+ }
300
+ active.waiters.clear();
301
+ active.stopped.clear();
302
+ }
303
+ });
304
+ }
305
+ requireCondition(refresh.waiters.size < 256, "mcp_oauth_busy", "The authentication waiter budget is full.");
306
+ const active = refresh;
307
+ const waiting = new Promise((resolve, reject) => {
308
+ const waiter = {
309
+ signal,
310
+ resolve,
311
+ reject,
312
+ abort: () => {
313
+ if (!active.waiters.delete(waiter))
314
+ return;
315
+ if (active.waiters.size) {
316
+ signal.removeEventListener("abort", waiter.abort);
317
+ reject(new AgentError("mcp_oauth_cancelled", "This OAuth waiter was cancelled."));
318
+ }
319
+ else {
320
+ active.stopped.add(waiter);
321
+ active.controller.abort(signal.reason);
322
+ }
323
+ },
324
+ };
325
+ active.waiters.add(waiter);
326
+ signal.addEventListener("abort", waiter.abort, { once: true });
327
+ if (signal.aborted)
328
+ waiter.abort();
329
+ });
330
+ owner?.authentication?.add(waiting);
331
+ try {
332
+ await waiting;
333
+ }
334
+ finally {
335
+ owner?.authentication?.delete(waiting);
336
+ }
337
+ },
338
+ };
339
+ }
340
+ async #fetch(target, init = {}) {
341
+ this.#lifetime.signal.throwIfAborted();
342
+ const url = new URL(target).href;
343
+ this.#authorize(url);
344
+ const body = init.body;
345
+ if (typeof body === "string") {
346
+ requireCondition(Buffer.byteLength(body) <= this.#limit, "mcp_message_too_large", "An MCP HTTP request exceeds the configured message byte limit.");
347
+ }
348
+ // OAuth discovery, registration and token exchanges are descendants of the
349
+ // invoking SDK operation too. Their real fetch/body lifetime and abort must
350
+ // remain owned by that operation, even when the body is form-urlencoded.
351
+ const scope = this.#calls.getStore();
352
+ if (scope?.oauth)
353
+ assertSecureTokenEndpoint(url);
354
+ const headers = new Headers(init.headers);
355
+ if (!scope?.oauth && url === this.#sourceUrl)
356
+ for (const [name, value] of Object.entries(this.#sourceHeaders))
357
+ headers.set(name, value);
358
+ requireCondition(!scope || scope.active, "mcp_call_closed", "The MCP operation no longer admits HTTP requests.");
359
+ const controller = new AbortController();
360
+ const signals = [this.#lifetime.signal, controller.signal];
361
+ if (init.signal)
362
+ signals.push(init.signal);
363
+ if (scope)
364
+ signals.push(scope.signal);
365
+ const signal = AbortSignal.any(signals);
366
+ signal.throwIfAborted();
367
+ const completion = Promise.withResolvers();
368
+ const entry = { controller, done: completion.promise };
369
+ this.#pending.add(entry);
370
+ scope?.pending.add(entry);
371
+ let finished = false;
372
+ const finish = () => {
373
+ if (finished)
374
+ return;
375
+ finished = true;
376
+ this.#pending.delete(entry);
377
+ scope?.pending.delete(entry);
378
+ completion.resolve();
379
+ };
380
+ try {
381
+ const response = await fetch(url, {
382
+ ...init,
383
+ headers,
384
+ redirect: "error",
385
+ signal,
386
+ });
387
+ if (!response.body) {
388
+ finish();
389
+ return response;
390
+ }
391
+ const reader = response.body.getReader();
392
+ let cancellation;
393
+ const settle = async () => {
394
+ await reader.closed.catch(() => { });
395
+ await cancellation;
396
+ signal.removeEventListener("abort", onAbort);
397
+ finish();
398
+ };
399
+ const cancel = (reason) => {
400
+ if (!cancellation) {
401
+ // Mark cancellation before aborting: abort delivery is synchronous.
402
+ const done = Promise.withResolvers();
403
+ cancellation = done.promise;
404
+ void reader
405
+ .cancel(reason)
406
+ .catch(() => { })
407
+ .then(done.resolve);
408
+ controller.abort(reason);
409
+ }
410
+ return settle();
411
+ };
412
+ const onAbort = () => {
413
+ void cancel(signal.reason);
414
+ };
415
+ entry.cancel = cancel;
416
+ signal.addEventListener("abort", onAbort, { once: true });
417
+ void reader.closed.then(settle, settle);
418
+ if (signal.aborted)
419
+ await cancel(signal.reason);
420
+ if (response.status === 401 && !this.#oauth) {
421
+ await cancel();
422
+ throw new AgentError("mcp_authentication_required", "The MCP server requires an approved authentication configuration.");
423
+ }
424
+ const sse = response.headers
425
+ .get("content-type")
426
+ ?.split(";", 1)[0]
427
+ ?.trim()
428
+ .toLowerCase() === "text/event-stream";
429
+ const checkFrame = sse ? frameBudget(this.#limit) : null;
430
+ let bytes = 0;
431
+ const wrapped = new ReadableStream({
432
+ pull: async (output) => {
433
+ try {
434
+ const item = await reader.read();
435
+ if (item.done) {
436
+ output.close();
437
+ await settle();
438
+ return;
439
+ }
440
+ if (checkFrame)
441
+ checkFrame(item.value);
442
+ else {
443
+ bytes += item.value.byteLength;
444
+ requireCondition(bytes <= this.#limit, "mcp_message_too_large", "An MCP HTTP response exceeds the configured message byte limit.");
445
+ }
446
+ output.enqueue(item.value);
447
+ }
448
+ catch (error) {
449
+ output.error(error);
450
+ await cancel(error);
451
+ }
452
+ },
453
+ cancel,
454
+ });
455
+ return new Response(wrapped, {
456
+ status: response.status,
457
+ statusText: response.statusText,
458
+ headers: response.headers,
459
+ });
460
+ }
461
+ catch (error) {
462
+ // A native fetch rejection has no body. Once headers were received,
463
+ // closure is confirmed by the reader/cancellation path instead.
464
+ if (entry.cancel)
465
+ await entry.cancel(error);
466
+ else
467
+ finish();
468
+ throw error;
469
+ }
470
+ }
471
+ }
472
+ //# sourceMappingURL=mcp-http.js.map
@@ -0,0 +1 @@
1
+ {"version":3,"file":"mcp-http.js","sourceRoot":"","sources":["../../src/adapters/mcp-http.ts"],"names":[],"mappings":"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"}
@@ -0,0 +1,29 @@
1
+ import { type OAuthClientProvider } from "@modelcontextprotocol/client";
2
+ import type { JsonObject } from "../contracts/types.js";
3
+ import type { ExtensionHost } from "../extensions/api.js";
4
+ import type { CredentialVault } from "../maintenance/credentials.js";
5
+ import type { MaintenanceScope, MaintenanceOAuthScope, MaintenanceOAuthBinding, MaintenanceOAuthComplete, MaintenanceOAuthLaunch } from "../maintenance/requests.js";
6
+ export interface McpOAuthConfig {
7
+ clientMetadata?: JsonObject;
8
+ clientInformation?: JsonObject;
9
+ clientMetadataUrl?: string;
10
+ scope?: string;
11
+ issuer?: string;
12
+ }
13
+ /** Created only after approval, then bound to the actual registered instance. */
14
+ export type McpOAuthProviderFactory = (host: ExtensionHost) => OAuthClientProvider;
15
+ type Vault = Pick<CredentialVault, "read" | "update">;
16
+ /** Pure validation: never discovers, registers a client or launches a process. */
17
+ export declare function validateMcpOAuthConfig(value: unknown): McpOAuthConfig;
18
+ /** Agent-private storage and official SDK orchestration; never enters script SDK. */
19
+ export declare class McpOAuthService {
20
+ #private;
21
+ readonly vault: Vault;
22
+ readonly timeoutMs: number;
23
+ constructor(vault: Vault, timeoutMs?: number);
24
+ start(config: JsonObject, ref: string, identity: JsonObject, authorization: MaintenanceOAuthBinding, scope: MaintenanceOAuthScope): Promise<MaintenanceOAuthLaunch>;
25
+ complete(config: JsonObject, ref: string, identity: JsonObject, input: MaintenanceOAuthComplete, scope: MaintenanceOAuthScope): Promise<string>;
26
+ ready(config: JsonObject, ref: string, identity: JsonObject, scope: MaintenanceScope): Promise<boolean>;
27
+ provider(config: JsonObject, ref: string, identity: JsonObject, scope: MaintenanceScope): Promise<McpOAuthProviderFactory>;
28
+ }
29
+ export {};