@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,768 @@
1
+ import { createHash } from "node:crypto";
2
+ import { MIMEType } from "node:util";
3
+ import { AgentError, requireCondition } from "../contracts/errors.js";
4
+ import { canonicalJson, isPlainRecord } from "../contracts/json.js";
5
+ import { authorizeCall } from "../contracts/caller.js";
6
+ import { parseOpenApi, openApiLimits } from "./openapi-schema.js";
7
+ import { buildOpenApiRequest, normalizeOpenApiInput, } from "./openapi-request.js";
8
+ import { executeOpenApiHttp, OpenApiHttpError } from "./openapi-http.js";
9
+ import { generateOpenApiTypes } from "./openapi-typegen.js";
10
+ const permissions = Object.freeze(["api.use"]);
11
+ const methods = new Set([
12
+ "get",
13
+ "put",
14
+ "post",
15
+ "delete",
16
+ "options",
17
+ "head",
18
+ "patch",
19
+ "trace",
20
+ ]);
21
+ const parameterGroups = {
22
+ path: "path",
23
+ query: "query",
24
+ header: "headers",
25
+ cookie: "cookies",
26
+ };
27
+ const ignoredHeaders = new Set(["authorization", "accept", "content-type"]);
28
+ const clone = (value, max = 32 * 1024 * 1024) => JSON.parse(canonicalJson(value, max));
29
+ const object = (value) => isPlainRecord(value);
30
+ const digest = (value) => createHash("sha256").update(value).digest("hex");
31
+ function frozen(value) {
32
+ if (value && typeof value === "object") {
33
+ for (const child of Object.values(value))
34
+ frozen(child);
35
+ Object.freeze(value);
36
+ }
37
+ return value;
38
+ }
39
+ function schemaFor(parameter, swagger) {
40
+ if (!swagger || parameter.in === "body")
41
+ return (parameter.schema ??
42
+ (object(parameter.content)
43
+ ? Object.values(parameter.content)[0]?.schema
44
+ : {}) ??
45
+ {});
46
+ const schema = Object.create(null);
47
+ for (const key of [
48
+ "type",
49
+ "format",
50
+ "items",
51
+ "default",
52
+ "maximum",
53
+ "exclusiveMaximum",
54
+ "minimum",
55
+ "exclusiveMinimum",
56
+ "maxLength",
57
+ "minLength",
58
+ "pattern",
59
+ "maxItems",
60
+ "minItems",
61
+ "uniqueItems",
62
+ "enum",
63
+ "multipleOf",
64
+ "x-nullable",
65
+ ])
66
+ if (Object.hasOwn(parameter, key))
67
+ schema[key === "x-nullable" ? "nullable" : key] = parameter[key];
68
+ return schema;
69
+ }
70
+ function documentationValue(value) {
71
+ if (Array.isArray(value))
72
+ return value.map(documentationValue);
73
+ if (!object(value))
74
+ return value;
75
+ const result = Object.create(null);
76
+ // Auth examples/defaults and imported server payloads are not a shared manual.
77
+ for (const [key, child] of Object.entries(value))
78
+ if (!["example", "examples", "default"].includes(key))
79
+ result[key] = documentationValue(child);
80
+ return result;
81
+ }
82
+ function credentialString(value, allowEmpty = false) {
83
+ requireCondition(typeof value === "string" &&
84
+ (allowEmpty || value.length > 0) &&
85
+ Buffer.byteLength(value) <= 65536 &&
86
+ !/[\0\r\n]/.test(value), "api_invalid_credential", "A configured API credential is unavailable or not a bounded valid value.");
87
+ }
88
+ function matchedMedia(keys, requested) {
89
+ const available = [...keys];
90
+ const chosen = requested ??
91
+ (available.length === 1 && !available[0].includes("*")
92
+ ? available[0]
93
+ : undefined);
94
+ if (!chosen)
95
+ return null;
96
+ let actual;
97
+ try {
98
+ actual = new MIMEType(chosen);
99
+ }
100
+ catch {
101
+ throw new AgentError("api_invalid_media_type", "An API media selection is not a valid MIME type.");
102
+ }
103
+ requireCondition(!actual.essence.includes("*"), "api_request_media_required", "A request must choose a concrete media type instead of sending a wildcard.");
104
+ const matches = [];
105
+ for (const key of available) {
106
+ let declared;
107
+ try {
108
+ declared = new MIMEType(key);
109
+ }
110
+ catch {
111
+ throw new AgentError("api_invalid_media_type", "A declared API media type is invalid.");
112
+ }
113
+ const essence = declared.essence.toLowerCase(), target = actual.essence.toLowerCase();
114
+ const [type, subtype] = essence.split("/");
115
+ const fits = essence === target ||
116
+ essence === "*/*" ||
117
+ (subtype === "*" && target.startsWith(type + "/")) ||
118
+ (subtype?.startsWith("*+") &&
119
+ target.startsWith(type + "/") &&
120
+ target.endsWith(subtype.slice(1)));
121
+ if (!fits)
122
+ continue;
123
+ const parameters = [...declared.params];
124
+ if (!parameters.every(([name, value]) => actual.params.get(name) === value))
125
+ continue;
126
+ matches.push({
127
+ key,
128
+ score: (essence === target
129
+ ? 3
130
+ : subtype?.startsWith("*+")
131
+ ? 2
132
+ : type === "*"
133
+ ? 0
134
+ : 1) +
135
+ parameters.length * 10,
136
+ });
137
+ }
138
+ matches.sort((a, b) => b.score - a.score);
139
+ if (!matches.length)
140
+ return null;
141
+ requireCondition(matches.length === 1 || matches[0].score !== matches[1].score, "api_ambiguous_media_type", "The concrete media type matches multiple equally specific source representations.");
142
+ return { key: matches[0].key, actual: chosen };
143
+ }
144
+ /** Approved fixed source -> public SDK factory, without source fetches, approval, or implicit retries. */
145
+ export async function prepareOpenApi(input, options = {}) {
146
+ const signal = options.signal;
147
+ signal?.throwIfAborted();
148
+ requireCondition(object(input) &&
149
+ Object.keys(input).every((key) => [
150
+ "name",
151
+ "revision",
152
+ "document",
153
+ "references",
154
+ "serviceUrl",
155
+ "authentication",
156
+ "limits",
157
+ ].includes(key)) &&
158
+ typeof input.name === "string" &&
159
+ /^[A-Za-z_$][A-Za-z0-9_$-]{0,127}$/.test(input.name) &&
160
+ typeof input.revision === "string" &&
161
+ input.revision.length > 0 &&
162
+ input.revision.length <= 1024, "api_invalid_config", "An API adapter needs its approved name, source revision, fixed documents and service configuration.");
163
+ const name = input.name, approvedRevision = input.revision;
164
+ let service;
165
+ try {
166
+ service = new URL(input.serviceUrl);
167
+ }
168
+ catch {
169
+ throw new AgentError("api_invalid_service", "The API service needs an absolute HTTP(S) base URL.");
170
+ }
171
+ requireCondition(["http:", "https:"].includes(service.protocol) &&
172
+ !service.username &&
173
+ !service.password &&
174
+ !service.search &&
175
+ !service.hash, "api_invalid_service", "API service bases cannot contain credentials, query parameters or fragments.");
176
+ const serviceUrl = service.href.replace(/\/$/, "");
177
+ const limits = openApiLimits(input.limits);
178
+ const auth = clone(input.authentication ?? {}, 1024 * 1024);
179
+ requireCondition(Object.keys(auth).every((key) => [
180
+ "credentialBindings",
181
+ "operationSelections",
182
+ "supplementalSchemes",
183
+ "supplementalSecurity",
184
+ ].includes(key)), "api_invalid_authentication", "Only approved authentication bindings and selections are accepted.");
185
+ const parsed = await parseOpenApi(input, limits, signal);
186
+ const document = parsed.document, swagger = parsed.sourceVersion === "2.0";
187
+ const bindings = auth.credentialBindings ?? {}, selections = auth.operationSelections ?? {};
188
+ requireCondition(object(bindings) && object(selections), "api_invalid_authentication", "Authentication bindings and operation selections must be objects.");
189
+ for (const value of Object.values(bindings))
190
+ credentialString(value);
191
+ const definitions = Object.create(null);
192
+ const declared = swagger
193
+ ? document.securityDefinitions
194
+ : document.components?.securitySchemes;
195
+ for (const [key, value] of Object.entries(declared ?? {}))
196
+ definitions[key] = parsed.resolve(value);
197
+ for (const [key, value] of Object.entries(auth.supplementalSchemes ?? {})) {
198
+ requireCondition(!Object.hasOwn(definitions, key), "api_authentication_conflict", "Supplemental authentication cannot silently replace a source scheme.");
199
+ definitions[key] = clone(value);
200
+ }
201
+ for (const [key, definition] of Object.entries(definitions)) {
202
+ requireCondition(key.length > 0 && Buffer.byteLength(key) <= 256 && object(definition), "api_invalid_authentication", "A security scheme needs a bounded original identity and definition.");
203
+ const supported = (definition.type === "apiKey" &&
204
+ ["header", "query", "cookie"].includes(definition.in) &&
205
+ typeof definition.name === "string" &&
206
+ definition.name.length > 0 &&
207
+ definition.name.length <= 256 &&
208
+ !/[\0\r\n]/.test(definition.name) &&
209
+ (definition.in === "query" ||
210
+ /^[!#$%&'*+\-.^_`|~0-9A-Za-z]+$/.test(definition.name))) ||
211
+ definition.type === "basic" ||
212
+ (definition.type === "http" &&
213
+ typeof definition.scheme === "string" &&
214
+ ["basic", "bearer"].includes(definition.scheme?.toLowerCase())) ||
215
+ ["oauth2", "openIdConnect", "mutualTLS"].includes(definition.type);
216
+ requireCondition(supported, "api_unsupported_authentication", "A declared authentication scheme needs a supported protected credential provider.", { scheme: key });
217
+ if (definition.type === "apiKey" && definition.in === "header")
218
+ requireCondition(![
219
+ "host",
220
+ "content-length",
221
+ "connection",
222
+ "transfer-encoding",
223
+ "upgrade",
224
+ "te",
225
+ "trailer",
226
+ "keep-alive",
227
+ "proxy-authorization",
228
+ ].includes(definition.name.toLowerCase()) &&
229
+ !definition.name.toLowerCase().startsWith("proxy-"), "api_unsupported_authentication", "Authentication cannot replace HTTP routing or framing headers.", { scheme: key });
230
+ }
231
+ for (const key of Object.keys(bindings))
232
+ requireCondition(Object.hasOwn(definitions, key), "api_invalid_authentication", "A credential binding names an unknown security scheme.");
233
+ const selectSecurity = (operation, name) => {
234
+ let security = operation.security ?? document.security ?? [];
235
+ if (!security.length && auth.supplementalSecurity)
236
+ security = auth.supplementalSecurity;
237
+ requireCondition(Array.isArray(security) && security.length <= 64, "api_invalid_authentication", "An operation needs a bounded set of authentication alternatives.");
238
+ const choices = security.length ? security : [{}];
239
+ for (const requirement of choices) {
240
+ requireCondition(object(requirement) && Object.keys(requirement).length <= 16, "api_invalid_authentication", "Authentication AND-groups must be bounded objects.");
241
+ for (const [key, scopes] of Object.entries(requirement))
242
+ requireCondition(Object.hasOwn(definitions, key) &&
243
+ Array.isArray(scopes) &&
244
+ scopes.every((scope) => typeof scope === "string" && scope.length <= 1024) &&
245
+ (["oauth2", "openIdConnect"].includes(definitions[key].type) ||
246
+ scopes.length === 0), "api_invalid_authentication", "An authentication requirement names an invalid scheme or scope set.");
247
+ }
248
+ const selected = Object.hasOwn(selections, name)
249
+ ? selections[name]
250
+ : choices.findIndex((item) => Object.keys(item).every((key) => Object.hasOwn(bindings, key)));
251
+ requireCondition(typeof selected === "number" &&
252
+ Number.isInteger(selected) &&
253
+ selected >= 0 &&
254
+ selected < choices.length &&
255
+ Object.keys(choices[selected]).every((key) => Object.hasOwn(bindings, key)), "api_authentication_required", "An operation's approved authentication alternative is not fully configured.", { operation: name });
256
+ requireCondition(!Object.keys(choices[selected]).length || options.credentials, "api_authentication_required", "Configured API authentication needs the trusted Agent credential provider.");
257
+ const targets = new Set();
258
+ for (const key of Object.keys(choices[selected])) {
259
+ const scheme = definitions[key];
260
+ const target = scheme.type === "apiKey"
261
+ ? `${scheme.in}:${scheme.in === "header" ? scheme.name.toLowerCase() : scheme.name}`
262
+ : scheme.type === "mutualTLS"
263
+ ? "tls:client"
264
+ : "header:authorization";
265
+ requireCondition(!targets.has(target), "api_authentication_conflict", "Two authentication schemes cannot overwrite the same request target.", { operation: name });
266
+ targets.add(target);
267
+ }
268
+ return {
269
+ security,
270
+ selected: choices[selected],
271
+ targets,
272
+ };
273
+ };
274
+ const models = [], metadata = [];
275
+ const names = new Set(), routes = new Set();
276
+ for (const [pathname, rawPath] of Object.entries(document.paths ?? {})) {
277
+ if (pathname.startsWith("x-"))
278
+ continue;
279
+ requireCondition(pathname.startsWith("/") &&
280
+ !pathname.startsWith("//") &&
281
+ !/[\\?#\0\r\n]/.test(pathname), "api_invalid_path", "An API path must remain a path under its approved service base.");
282
+ const pathItem = parsed.resolve(rawPath);
283
+ requireCondition(object(pathItem), "api_invalid_specification", "A path item must resolve to a standard object.");
284
+ for (const [method, rawOperation] of Object.entries(pathItem)) {
285
+ if (!methods.has(method))
286
+ continue;
287
+ requireCondition(method !== "trace", "api_unsupported_method", "Native Node fetch does not support TRACE; use an explicitly supported SDK transport.");
288
+ requireCondition(object(rawOperation), "api_invalid_specification", "Each HTTP operation must be an object.");
289
+ const name = rawOperation.operationId ?? `${method.toUpperCase()} ${pathname}`;
290
+ requireCondition(typeof name === "string" &&
291
+ name.length > 0 &&
292
+ Buffer.byteLength(name) <= 1024 &&
293
+ !/[\0\r\n]/.test(name) &&
294
+ !names.has(name), "api_operation_conflict", "Original operation identifiers must be unique bounded names.");
295
+ names.add(name);
296
+ const route = method + ":" + pathname.replace(/\{[^}]+\}/g, "{}");
297
+ requireCondition(!routes.has(route), "api_operation_conflict", "Equivalent path templates cannot define duplicate operations.");
298
+ routes.add(route);
299
+ requireCondition(models.length < limits.operationCount, "api_catalog_too_large", "The API operation catalog exceeds its configured budget.");
300
+ const security = selectSecurity(rawOperation, name);
301
+ const merged = new Map();
302
+ for (const raw of [
303
+ ...(pathItem.parameters ?? []),
304
+ ...(rawOperation.parameters ?? []),
305
+ ]) {
306
+ const parameter = parsed.resolve(raw);
307
+ requireCondition(object(parameter) &&
308
+ typeof parameter.name === "string" &&
309
+ typeof parameter.in === "string", "api_invalid_specification", "An operation parameter must resolve to its original location and name.");
310
+ merged.set(parameter.in +
311
+ ":" +
312
+ (parameter.in === "header"
313
+ ? parameter.name.toLowerCase()
314
+ : parameter.name), parameter);
315
+ }
316
+ const parameters = [...merged.values()].filter((parameter) => !(parameter.in === "header" &&
317
+ ignoredHeaders.has(parameter.name.toLowerCase())));
318
+ const modelParameters = parameters.filter((parameter) => !security.targets.has(`${parameter.in}:${parameter.in === "header" ? parameter.name.toLowerCase() : parameter.name}`));
319
+ const requiredPath = [...pathname.matchAll(/\{([^}]+)\}/g)].map((match) => match[1]);
320
+ requireCondition(requiredPath.every((key) => parameters.some((parameter) => parameter.in === "path" &&
321
+ parameter.name === key &&
322
+ parameter.required === true)) &&
323
+ parameters
324
+ .filter((parameter) => parameter.in === "path")
325
+ .every((parameter) => requiredPath.includes(parameter.name)), "api_invalid_path", "Path placeholders and required declared path parameters must agree.");
326
+ const checks = modelParameters
327
+ .filter((parameter) => parameter.in in parameterGroups)
328
+ .map((parameter) => ({
329
+ parameter,
330
+ validate: parsed.compile(schemaFor(parameter, swagger), "request"),
331
+ }));
332
+ const bodyParameter = modelParameters.find((parameter) => parameter.in === "body");
333
+ const form = modelParameters.filter((parameter) => parameter.in === "formData");
334
+ requireCondition(!bodyParameter || form.length === 0, "api_invalid_specification", "Swagger body and formData cannot describe the same operation body.");
335
+ let bodyDefinition = rawOperation.requestBody
336
+ ? parsed.resolve(rawOperation.requestBody)
337
+ : null;
338
+ if (swagger && bodyParameter)
339
+ bodyDefinition = {
340
+ required: !!bodyParameter.required,
341
+ content: Object.fromEntries((rawOperation.consumes ??
342
+ document.consumes ?? ["application/json"]).map((mime) => [
343
+ mime,
344
+ { schema: bodyParameter.schema ?? {} },
345
+ ])),
346
+ };
347
+ if (swagger && form.length)
348
+ bodyDefinition = {
349
+ required: form.some((parameter) => parameter.required),
350
+ content: Object.fromEntries((rawOperation.consumes ??
351
+ document.consumes ?? ["application/x-www-form-urlencoded"]).map((mime) => [
352
+ mime,
353
+ {
354
+ schema: {
355
+ type: "object",
356
+ properties: Object.fromEntries(form.map((parameter) => [
357
+ parameter.name,
358
+ schemaFor(parameter, true),
359
+ ])),
360
+ required: form
361
+ .filter((parameter) => parameter.required)
362
+ .map((parameter) => parameter.name),
363
+ additionalProperties: false,
364
+ },
365
+ },
366
+ ])),
367
+ };
368
+ const body = bodyDefinition
369
+ ? {
370
+ required: !!bodyDefinition.required,
371
+ content: bodyDefinition.content ?? {},
372
+ checks: new Map(),
373
+ }
374
+ : null;
375
+ if (body)
376
+ for (const [mime, media] of Object.entries(body.content)) {
377
+ requireCondition(typeof mime === "string" && mime.length <= 256 && object(media), "api_invalid_media_type", "Request media types must have bounded standard definitions.");
378
+ const schema = media.schema ?? {};
379
+ body.checks.set(mime, parsed.compile(schema, "request"));
380
+ }
381
+ const responseChecks = new Map();
382
+ for (const [status, rawResponse] of Object.entries(rawOperation.responses ?? {})) {
383
+ const response = parsed.resolve(rawResponse);
384
+ requireCondition(object(response), "api_invalid_specification", "Each response must resolve to its standard definition.");
385
+ const content = swagger
386
+ ? Object.fromEntries((rawOperation.produces ??
387
+ document.produces ?? ["application/json"]).map((mime) => [
388
+ mime,
389
+ { schema: response.schema ?? {} },
390
+ ]))
391
+ : (response.content ?? {});
392
+ const validators = new Map();
393
+ for (const [mime, media] of Object.entries(content)) {
394
+ requireCondition(mime.length <= 256 && object(media), "api_invalid_media_type", "Response media types must have bounded standard definitions.");
395
+ // An unspecified payload schema is intentionally unconstrained, including native binary responses.
396
+ validators.set(mime, media.schema === undefined ||
397
+ (object(media.schema) && !Object.keys(media.schema).length)
398
+ ? () => { }
399
+ : parsed.compile(media.schema, "response"));
400
+ }
401
+ responseChecks.set(status, validators);
402
+ }
403
+ const inputProperties = Object.create(null), inputRequired = [];
404
+ for (const [position, group] of Object.entries(parameterGroups)) {
405
+ const matching = checks.filter((check) => check.parameter.in === position);
406
+ if (!matching.length)
407
+ continue;
408
+ const required = matching
409
+ .filter((check) => check.parameter.required)
410
+ .map((check) => check.parameter.name);
411
+ inputProperties[group] = {
412
+ type: "object",
413
+ additionalProperties: false,
414
+ properties: Object.fromEntries(matching.map((check) => [check.parameter.name, {}])),
415
+ ...(required.length ? { required } : {}),
416
+ };
417
+ if (required.length)
418
+ inputRequired.push(group);
419
+ }
420
+ if (body) {
421
+ inputProperties.body = {};
422
+ inputProperties.contentType = {
423
+ type: "string",
424
+ minLength: 1,
425
+ maxLength: 256,
426
+ };
427
+ if (body.required)
428
+ inputRequired.push("body");
429
+ }
430
+ inputProperties.accept = {
431
+ type: "string",
432
+ minLength: 1,
433
+ maxLength: 1024,
434
+ };
435
+ const inputSchema = {
436
+ type: "object",
437
+ properties: inputProperties,
438
+ additionalProperties: false,
439
+ ...(inputRequired.length ? { required: inputRequired } : {}),
440
+ };
441
+ const description = rawOperation.description ??
442
+ rawOperation.summary ??
443
+ `${method.toUpperCase()} ${pathname}`;
444
+ requireCondition(typeof description === "string" &&
445
+ description.length > 0 &&
446
+ description.length <= 4096, "api_catalog_too_large", "An operation description exceeds the public method budget.");
447
+ const model = {
448
+ name,
449
+ method,
450
+ path: pathname,
451
+ description,
452
+ operation: {
453
+ ...rawOperation,
454
+ operationId: name,
455
+ parameters: modelParameters,
456
+ ...(!swagger && bodyDefinition
457
+ ? { requestBody: bodyDefinition }
458
+ : {}),
459
+ responses: Object.fromEntries(Object.entries(rawOperation.responses ?? {}).map(([key, value]) => [
460
+ key,
461
+ parsed.resolve(value),
462
+ ])),
463
+ },
464
+ parameters: modelParameters,
465
+ checks,
466
+ body,
467
+ responseChecks,
468
+ selectedSecurity: security.selected,
469
+ authenticationTargets: security.targets,
470
+ inputSchema,
471
+ };
472
+ models.push(model);
473
+ metadata.push(documentationValue({
474
+ name,
475
+ method: method.toUpperCase(),
476
+ path: pathname,
477
+ description,
478
+ parameters: modelParameters,
479
+ ...(bodyDefinition ? { requestBody: bodyDefinition } : {}),
480
+ responses: rawOperation.responses,
481
+ security: security.security,
482
+ }));
483
+ }
484
+ }
485
+ requireCondition(models.length > 0, "api_no_operations", "The API description has no callable HTTP path operations.");
486
+ for (const key of Object.keys(selections))
487
+ requireCondition(names.has(key), "api_invalid_authentication", "An authentication selection names an unknown operation.");
488
+ const revision = "sha256:" +
489
+ digest(canonicalJson({
490
+ approved: approvedRevision,
491
+ source: parsed.revision,
492
+ serviceUrl,
493
+ authentication: auth,
494
+ }, 2 * 1024 * 1024));
495
+ const publicOperations = frozen(clone(metadata, limits.totalDocumentBytes));
496
+ const markdownParts = [
497
+ `# API ${name}\n\n规范 ${parsed.sourceVersion};固定修订 ${revision}。\n\n每个调用接受一个对象,按 path/query/headers/cookies/body 保留 HTTP 位置。contentType 在多种请求媒体类型时必须显式选择;返回 status/headers/data,二进制 data 为原生 Blob;图片预览显式 return output.image({data: response.data}),普通文件沿 output.file。\n\n认证只从已批准凭据绑定注入;规范与引用不在调用时重新下载。HTTP 错误有独立错误码及 response,不自动重试、跟随重定向、启动回调服务或把 202 变为后台任务。\n\n公共方法输入是 2020-12 envelope;原始 Swagger 2/OAS 3.0 payload 使用 Draft 4/OAS 约束,OAS 3.1 使用 JSON Schema 2020-12。下方保留原始定义;示例/default不进入共享手册。当前高级 schema-local $id/anchor/dynamicRef 不支持并明确拒绝。原生二进制引用不能附加约束 siblings,组合 binary Schema、复杂 style cookie 和 XML/object 自动编解码不在当前矩阵;相关调用明确失败,不静默丢字段。XML/其他文本在源 Schema 允许时保留原始字符串,不创建隐式编解码。Node fetch 不支持 TRACE 以及 GET/HEAD body。\n`,
498
+ ];
499
+ let docsBytes = Buffer.byteLength(markdownParts[0]);
500
+ for (const operation of publicOperations) {
501
+ const part = `\n## ${operation.name}\n\n\`api.${name}[${JSON.stringify(operation.name)}](arguments)\`\n\n${operation.description}\n\n\`\`\`json\n${canonicalJson(operation, limits.totalDocumentBytes)}\n\`\`\`\n`;
502
+ docsBytes += Buffer.byteLength(part);
503
+ requireCondition(docsBytes <= limits.totalDocumentBytes, "api_catalog_too_large", "The generated API documentation exceeds its byte budget.");
504
+ markdownParts.push(part);
505
+ }
506
+ let ready = false, constructed = false;
507
+ const factory = async (host) => {
508
+ requireCondition(!constructed, "api_adapter_in_use", "Create a fresh API adapter for each installed source instance.");
509
+ constructed = true;
510
+ host.signal.throwIfAborted();
511
+ authorizeCall(() => host.authorize({ type: "url", value: serviceUrl, access: "connect" }));
512
+ const lifetime = new AbortController();
513
+ const entries = Object.create(null);
514
+ const pending = new Set();
515
+ for (const model of models)
516
+ entries[model.name] = {
517
+ description: model.description,
518
+ permissions,
519
+ schemaDialect: "2020-12",
520
+ inputSchema: model.inputSchema,
521
+ normalize(args) {
522
+ requireCondition(args.length <= 1, "api_invalid_arguments", "API operations accept one argument object.");
523
+ const fixed = normalizeOpenApiInput(args[0] ?? {}, limits.requestBytes);
524
+ if (fixed.headers) {
525
+ const normalized = Object.create(null);
526
+ for (const [key, value] of Object.entries(fixed.headers)) {
527
+ const found = model.parameters.find((parameter) => parameter.in === "header" &&
528
+ parameter.name.toLowerCase() === key.toLowerCase());
529
+ requireCondition(found && !Object.hasOwn(normalized, found.name), "api_invalid_arguments", "A header parameter is unknown or specified more than once.");
530
+ normalized[found.name] = value;
531
+ }
532
+ fixed.headers = normalized;
533
+ }
534
+ if (model.body && Object.hasOwn(fixed, "body")) {
535
+ const selected = matchedMedia(model.body.checks.keys(), fixed.contentType);
536
+ requireCondition(selected, "api_request_media_required", "Choose a concrete contentType matching a declared request representation.");
537
+ fixed.contentType = selected.actual;
538
+ }
539
+ return fixed;
540
+ },
541
+ async handle(value, call) {
542
+ lifetime.signal.throwIfAborted();
543
+ const argument = value;
544
+ for (const { parameter, validate } of model.checks) {
545
+ const group = parameterGroups[parameter.in];
546
+ const found = argument[group]?.[parameter.name];
547
+ requireCondition(found !== undefined || !parameter.required, "api_invalid_arguments", "A required API parameter is missing.", { parameter: parameter.name, in: parameter.in });
548
+ if (found !== undefined)
549
+ validate(found);
550
+ }
551
+ if (model.body) {
552
+ requireCondition(Object.hasOwn(argument, "body") || !model.body.required, "api_invalid_arguments", "The API operation needs a request body.");
553
+ if (Object.hasOwn(argument, "body")) {
554
+ requireCondition(!["get", "head"].includes(model.method), "api_unsupported_request_body", "Native Node fetch cannot send a GET or HEAD request body.");
555
+ const selected = matchedMedia(model.body.checks.keys(), argument.contentType);
556
+ requireCondition(selected, "api_request_media_required", "Choose a declared contentType when an operation has multiple request representations.");
557
+ const essence = new MIMEType(selected.actual).essence;
558
+ requireCondition(essence.includes("json") ||
559
+ [
560
+ "multipart/form-data",
561
+ "application/x-www-form-urlencoded",
562
+ ].includes(essence) ||
563
+ (!object(argument.body) && !Array.isArray(argument.body)), "api_unsupported_media_schema", "Non-JSON object/XML serialization requires an explicit codec; raw text or native binary remains supported.");
564
+ model.body.checks.get(selected.key)(argument.body);
565
+ }
566
+ }
567
+ const activeOperation = { ...model.operation };
568
+ if (model.body && Object.hasOwn(argument, "body")) {
569
+ const selected = matchedMedia(model.body.checks.keys(), argument.contentType);
570
+ if (swagger)
571
+ activeOperation.consumes = [selected.actual];
572
+ else
573
+ activeOperation.requestBody = {
574
+ ...model.operation.requestBody,
575
+ content: {
576
+ [selected.actual]: model.body.content[selected.key],
577
+ },
578
+ };
579
+ }
580
+ const operationView = {
581
+ ...document,
582
+ paths: { [model.path]: { [model.method]: activeOperation } },
583
+ };
584
+ const request = buildOpenApiRequest({
585
+ document: operationView,
586
+ operationId: model.name,
587
+ method: model.method,
588
+ path: model.path,
589
+ serviceUrl,
590
+ parameters: model.parameters,
591
+ input: argument,
592
+ maxRequestBytes: limits.requestBytes,
593
+ });
594
+ const ongoing = executeOpenApiHttp({
595
+ request,
596
+ host,
597
+ call: {
598
+ ...call,
599
+ signal: AbortSignal.any([call.signal, lifetime.signal]),
600
+ },
601
+ operation: model.name,
602
+ limits,
603
+ authenticate: async (scope) => {
604
+ lifetime.signal.throwIfAborted();
605
+ scope.throwIfAborted();
606
+ const target = new URL(request.url), headers = new Headers(request.headers), secrets = [], sensitiveHeaders = ["authorization", "cookie"];
607
+ let dispatcher;
608
+ for (const [key, scopes] of Object.entries(model.selectedSecurity)) {
609
+ const definition = definitions[key];
610
+ const credential = await options.credentials.get({
611
+ api: name,
612
+ revision,
613
+ scheme: key,
614
+ definition: frozen(clone(definition)),
615
+ credentialRef: bindings[key],
616
+ scopes,
617
+ target: request.url,
618
+ signal: AbortSignal.any([scope, lifetime.signal]),
619
+ operationId: call.operationId,
620
+ context: call.context,
621
+ hostContext: host.context,
622
+ });
623
+ scope.throwIfAborted();
624
+ lifetime.signal.throwIfAborted();
625
+ if (definition.type === "apiKey") {
626
+ requireCondition(credential.type === "apiKey", "api_invalid_credential", "The credential type does not match its approved security scheme.");
627
+ credentialString(credential.value);
628
+ secrets.push(credential.value);
629
+ if (definition.in === "header") {
630
+ requireCondition(!headers.has(definition.name), "api_authentication_conflict", "An argument cannot replace an Agent-managed authentication header.");
631
+ headers.set(definition.name, credential.value);
632
+ sensitiveHeaders.push(definition.name);
633
+ }
634
+ else if (definition.in === "query") {
635
+ requireCondition(!target.searchParams.has(definition.name), "api_authentication_conflict", "An argument cannot replace an Agent-managed authentication query value.");
636
+ target.searchParams.set(definition.name, credential.value);
637
+ const encoded = new URLSearchParams([
638
+ [definition.name, credential.value],
639
+ ]).toString();
640
+ secrets.push(encoded.slice(encoded.indexOf("=") + 1));
641
+ }
642
+ else {
643
+ const existing = headers.get("cookie") ?? "";
644
+ requireCondition(!existing
645
+ .split(";")
646
+ .some((part) => part.trim().split("=", 1)[0] === definition.name), "api_authentication_conflict", "An argument cannot replace an Agent-managed authentication cookie.");
647
+ headers.set("cookie", (existing ? existing + "; " : "") +
648
+ definition.name +
649
+ "=" +
650
+ encodeURIComponent(credential.value));
651
+ }
652
+ }
653
+ else if (definition.type === "mutualTLS") {
654
+ requireCondition(credential.type === "mutualTLS" &&
655
+ credential.dispatcher &&
656
+ typeof credential.dispatcher === "object", "api_invalid_credential", "mTLS needs its approved connection-level TLS dispatcher.");
657
+ dispatcher = credential.dispatcher;
658
+ }
659
+ else {
660
+ const basic = definition.type === "basic" ||
661
+ (definition.type === "http" &&
662
+ definition.scheme.toLowerCase() === "basic");
663
+ requireCondition(basic
664
+ ? credential.type === "basic"
665
+ : credential.type === "bearer", "api_invalid_credential", "The credential type does not match its approved security scheme.");
666
+ let authorization;
667
+ if (credential.type === "basic") {
668
+ credentialString(credential.username, true);
669
+ credentialString(credential.password, true);
670
+ requireCondition(!credential.username.includes(":"), "api_invalid_credential", "A Basic username cannot contain a colon.");
671
+ const pair = credential.username + ":" + credential.password;
672
+ const encoded = Buffer.from(pair).toString("base64");
673
+ authorization = "Basic " + encoded;
674
+ secrets.push(credential.password, pair, encoded, authorization);
675
+ }
676
+ else {
677
+ requireCondition(credential.type === "bearer", "api_invalid_credential", "A token credential is required.");
678
+ credentialString(credential.token);
679
+ authorization = "Bearer " + credential.token;
680
+ secrets.push(credential.token, authorization);
681
+ }
682
+ requireCondition(!headers.has("authorization"), "api_authentication_conflict", "An argument cannot replace an Agent-managed Authorization header.");
683
+ headers.set("authorization", authorization);
684
+ }
685
+ }
686
+ return {
687
+ url: target.href,
688
+ headers,
689
+ ...(dispatcher ? { dispatcher } : {}),
690
+ secrets,
691
+ sensitiveHeaders,
692
+ };
693
+ },
694
+ validateResponse(response, mime) {
695
+ const status = String(response.status), group = model.responseChecks.get(status) ??
696
+ model.responseChecks.get(status[0] + "XX") ??
697
+ model.responseChecks.get("default");
698
+ requireCondition(group, "api_unexpected_response", "The service returned a status not described by this operation.", { status: response.status, operation: model.name });
699
+ if (!group.size ||
700
+ response.status === 204 ||
701
+ response.status === 304 ||
702
+ model.method === "head")
703
+ return;
704
+ const matched = matchedMedia(group.keys(), response.headers["content-type"] ?? mime);
705
+ const validate = matched ? group.get(matched.key) : undefined;
706
+ requireCondition(validate, "api_unexpected_response_media", "The service returned a media type not described by this operation.", { status: response.status, operation: model.name });
707
+ validate(response.data);
708
+ },
709
+ });
710
+ pending.add(ongoing);
711
+ try {
712
+ return await ongoing;
713
+ }
714
+ catch (error) {
715
+ if (error instanceof OpenApiHttpError) {
716
+ // The public extension boundary accepts ordinary AgentError data,
717
+ // not an adapter-specific control prototype.
718
+ const result = new AgentError(error.code, error.message, error.details);
719
+ result.name = "OpenApiHttpError";
720
+ Object.defineProperty(result, "response", {
721
+ value: error.response,
722
+ enumerable: true,
723
+ });
724
+ throw result;
725
+ }
726
+ throw error;
727
+ }
728
+ finally {
729
+ pending.delete(ongoing);
730
+ }
731
+ },
732
+ };
733
+ ready = true;
734
+ return {
735
+ methods: entries,
736
+ async dispose() {
737
+ ready = false;
738
+ lifetime.abort(new AgentError("api_adapter_stopping", "The API source no longer accepts calls."));
739
+ await Promise.allSettled([...pending]);
740
+ },
741
+ };
742
+ };
743
+ return Object.freeze({
744
+ factory,
745
+ bindingPath: Object.freeze(["api", name]),
746
+ permissions,
747
+ revision,
748
+ documentation: Object.freeze({
749
+ markdown: markdownParts.join(""),
750
+ types: generateOpenApiTypes(models.map((model) => ({
751
+ name: model.name,
752
+ parameters: model.parameters,
753
+ requestBody: model.body
754
+ ? { required: model.body.required, content: model.body.content }
755
+ : null,
756
+ responses: model.operation.responses,
757
+ })), parsed.resolve, (parameter) => schemaFor(parameter, swagger), limits.totalDocumentBytes),
758
+ }),
759
+ catalog: () => Object.freeze({
760
+ name: name,
761
+ sourceVersion: parsed.sourceVersion,
762
+ revision,
763
+ ready,
764
+ operations: publicOperations,
765
+ }),
766
+ });
767
+ }
768
+ //# sourceMappingURL=openapi.js.map