mulesoft-anypoint-cli-agent-fabric-plugin 1.2.11 → 1.3.1-beta

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 (313) hide show
  1. package/LICENSE.txt +89 -0
  2. package/README.md +177 -31
  3. package/bin/run +6 -0
  4. package/dist/commands/agent-network/project/agent-console.d.ts +16 -0
  5. package/dist/commands/agent-network/project/agent-console.js +175 -0
  6. package/dist/commands/agent-network/project/agent-console.js.map +1 -0
  7. package/dist/commands/agent-network/project/broker/create.d.ts +10 -0
  8. package/dist/commands/agent-network/project/broker/create.js +192 -0
  9. package/dist/commands/agent-network/project/broker/create.js.map +1 -0
  10. package/dist/commands/agent-network/project/build.d.ts +1 -1
  11. package/dist/commands/agent-network/project/build.js +8 -3
  12. package/dist/commands/agent-network/project/build.js.map +1 -1
  13. package/dist/commands/agent-network/project/create.d.ts +13 -1
  14. package/dist/commands/agent-network/project/create.js +56 -14
  15. package/dist/commands/agent-network/project/create.js.map +1 -1
  16. package/dist/commands/agent-network/project/deploy.d.ts +25 -15
  17. package/dist/commands/agent-network/project/deploy.js +238 -181
  18. package/dist/commands/agent-network/project/deploy.js.map +1 -1
  19. package/dist/commands/agent-network/project/export-logs.d.ts +11 -0
  20. package/dist/commands/agent-network/project/export-logs.js +38 -0
  21. package/dist/commands/agent-network/project/export-logs.js.map +1 -0
  22. package/dist/commands/agent-network/project/mcp/introspect.js +13 -5
  23. package/dist/commands/agent-network/project/mcp/introspect.js.map +1 -1
  24. package/dist/commands/agent-network/project/publish.d.ts +1 -1
  25. package/dist/commands/agent-network/project/publish.js +9 -4
  26. package/dist/commands/agent-network/project/publish.js.map +1 -1
  27. package/dist/commands/agent-network/project/run-local.d.ts +85 -0
  28. package/dist/commands/agent-network/project/run-local.js +825 -0
  29. package/dist/commands/agent-network/project/run-local.js.map +1 -0
  30. package/dist/commands/agent-network/project/secrets.d.ts +21 -0
  31. package/dist/commands/agent-network/project/secrets.js +163 -0
  32. package/dist/commands/agent-network/project/secrets.js.map +1 -0
  33. package/dist/commands/agent-network/project/stop-local.d.ts +11 -0
  34. package/dist/commands/agent-network/project/stop-local.js +38 -0
  35. package/dist/commands/agent-network/project/stop-local.js.map +1 -0
  36. package/dist/commands/agent-network/project/undeploy.d.ts +3 -2
  37. package/dist/commands/agent-network/project/undeploy.js +66 -40
  38. package/dist/commands/agent-network/project/undeploy.js.map +1 -1
  39. package/dist/commands/agent-network/project/unpublish.d.ts +12 -3
  40. package/dist/commands/agent-network/project/unpublish.js +212 -62
  41. package/dist/commands/agent-network/project/unpublish.js.map +1 -1
  42. package/dist/commands/agent-network/setup/dependencies.js +5 -0
  43. package/dist/commands/agent-network/setup/dependencies.js.map +1 -1
  44. package/dist/commands/agent-network/setup/gateways.d.ts +4 -1
  45. package/dist/commands/agent-network/setup/gateways.js +74 -6
  46. package/dist/commands/agent-network/setup/gateways.js.map +1 -1
  47. package/dist/errors/base-error.js +5 -0
  48. package/dist/errors/base-error.js.map +1 -1
  49. package/dist/errors/error-factory.d.ts +53 -12
  50. package/dist/errors/error-factory.js +261 -36
  51. package/dist/errors/error-factory.js.map +1 -1
  52. package/dist/helpers/connection-id.js +5 -0
  53. package/dist/helpers/connection-id.js.map +1 -1
  54. package/dist/helpers/connection.js +5 -0
  55. package/dist/helpers/connection.js.map +1 -1
  56. package/dist/helpers/dependency-manager.js +8 -3
  57. package/dist/helpers/dependency-manager.js.map +1 -1
  58. package/dist/helpers/entitlement-utils.js +5 -0
  59. package/dist/helpers/entitlement-utils.js.map +1 -1
  60. package/dist/helpers/policy-helper.js +8 -3
  61. package/dist/helpers/policy-helper.js.map +1 -1
  62. package/dist/helpers/project/api-project-dependency-fetcher.js +5 -0
  63. package/dist/helpers/project/api-project-dependency-fetcher.js.map +1 -1
  64. package/dist/helpers/project/constants.d.ts +1 -0
  65. package/dist/helpers/project/constants.js +6 -0
  66. package/dist/helpers/project/constants.js.map +1 -1
  67. package/dist/helpers/project/debug-messages.js +5 -0
  68. package/dist/helpers/project/debug-messages.js.map +1 -1
  69. package/dist/helpers/project/templates.js +5 -0
  70. package/dist/helpers/project/templates.js.map +1 -1
  71. package/dist/helpers/project/uris.js +5 -0
  72. package/dist/helpers/project/uris.js.map +1 -1
  73. package/dist/helpers/project/validation-commons.js +5 -0
  74. package/dist/helpers/project/validation-commons.js.map +1 -1
  75. package/dist/helpers/proxy-agent.d.ts +2 -0
  76. package/dist/helpers/proxy-agent.js +26 -0
  77. package/dist/helpers/proxy-agent.js.map +1 -0
  78. package/dist/helpers/request-logging.js +6 -1
  79. package/dist/helpers/request-logging.js.map +1 -1
  80. package/dist/helpers/request-utils.d.ts +2 -1
  81. package/dist/helpers/request-utils.js +7 -2
  82. package/dist/helpers/request-utils.js.map +1 -1
  83. package/dist/helpers/types.js +5 -0
  84. package/dist/helpers/types.js.map +1 -1
  85. package/dist/helpers/utils.d.ts +17 -1
  86. package/dist/helpers/utils.js +32 -1
  87. package/dist/helpers/utils.js.map +1 -1
  88. package/dist/index.js +5 -0
  89. package/dist/index.js.map +1 -1
  90. package/dist/resources/agent-console.html +478 -0
  91. package/dist/resources/schemas/broker-deployment-settings.schema.json +46 -0
  92. package/dist/types/agent-network-v2.d.ts +4 -0
  93. package/dist/types/agent-network-v2.js +5 -0
  94. package/dist/types/agent-network-v2.js.map +1 -1
  95. package/dist/types/agent-network.js +5 -0
  96. package/dist/types/agent-network.js.map +1 -1
  97. package/dist/types/types.d.ts +31 -34
  98. package/dist/types/types.js +5 -0
  99. package/dist/types/types.js.map +1 -1
  100. package/dist/utils/access-management.js +5 -0
  101. package/dist/utils/access-management.js.map +1 -1
  102. package/dist/utils/builders/builder.js +5 -0
  103. package/dist/utils/builders/builder.js.map +1 -1
  104. package/dist/utils/builders/common/agent-metadata.js +5 -0
  105. package/dist/utils/builders/common/agent-metadata.js.map +1 -1
  106. package/dist/utils/builders/common/asset-file-resolver.js +5 -0
  107. package/dist/utils/builders/common/asset-file-resolver.js.map +1 -1
  108. package/dist/utils/builders/common/connection-facet-helpers.js +5 -0
  109. package/dist/utils/builders/common/connection-facet-helpers.js.map +1 -1
  110. package/dist/utils/builders/common/connection-metadata.js +5 -0
  111. package/dist/utils/builders/common/connection-metadata.js.map +1 -1
  112. package/dist/utils/builders/common/network-builder-helpers.js +5 -0
  113. package/dist/utils/builders/common/network-builder-helpers.js.map +1 -1
  114. package/dist/utils/builders/common/network-metadata.js +5 -0
  115. package/dist/utils/builders/common/network-metadata.js.map +1 -1
  116. package/dist/utils/builders/common/registry-entry.js +5 -0
  117. package/dist/utils/builders/common/registry-entry.js.map +1 -1
  118. package/dist/utils/builders/common/types.js +5 -0
  119. package/dist/utils/builders/common/types.js.map +1 -1
  120. package/dist/utils/builders/component-factory.d.ts +2 -0
  121. package/dist/utils/builders/component-factory.js +24 -0
  122. package/dist/utils/builders/component-factory.js.map +1 -0
  123. package/dist/utils/builders/local-space-resolver.d.ts +18 -0
  124. package/dist/utils/builders/local-space-resolver.js +43 -0
  125. package/dist/utils/builders/local-space-resolver.js.map +1 -0
  126. package/dist/utils/builders/network-lock.d.ts +2 -0
  127. package/dist/utils/builders/network-lock.js +56 -6
  128. package/dist/utils/builders/network-lock.js.map +1 -1
  129. package/dist/utils/builders/policies-factory.d.ts +5 -1
  130. package/dist/utils/builders/policies-factory.js +15 -2
  131. package/dist/utils/builders/policies-factory.js.map +1 -1
  132. package/dist/utils/builders/project-builder-impl.d.ts +17 -3
  133. package/dist/utils/builders/project-builder-impl.js +34 -1
  134. package/dist/utils/builders/project-builder-impl.js.map +1 -1
  135. package/dist/utils/builders/project-builder.d.ts +31 -3
  136. package/dist/utils/builders/project-builder.js +15 -2
  137. package/dist/utils/builders/project-builder.js.map +1 -1
  138. package/dist/utils/builders/remote-space-resolver.d.ts +5 -1
  139. package/dist/utils/builders/remote-space-resolver.js +120 -45
  140. package/dist/utils/builders/remote-space-resolver.js.map +1 -1
  141. package/dist/utils/builders/space-serializer.js +8 -1
  142. package/dist/utils/builders/space-serializer.js.map +1 -1
  143. package/dist/utils/builders/stage-diagnostics.d.ts +2 -0
  144. package/dist/utils/builders/stage-diagnostics.js +27 -0
  145. package/dist/utils/builders/stage-diagnostics.js.map +1 -0
  146. package/dist/utils/builders/tooling-metadata.d.ts +4 -4
  147. package/dist/utils/builders/tooling-metadata.js +32 -15
  148. package/dist/utils/builders/tooling-metadata.js.map +1 -1
  149. package/dist/utils/builders/v1/agent-builder.js +5 -0
  150. package/dist/utils/builders/v1/agent-builder.js.map +1 -1
  151. package/dist/utils/builders/v1/broker-builder.js +5 -0
  152. package/dist/utils/builders/v1/broker-builder.js.map +1 -1
  153. package/dist/utils/builders/v1/connections-builder.js +5 -0
  154. package/dist/utils/builders/v1/connections-builder.js.map +1 -1
  155. package/dist/utils/builders/v1/llm-builder.js +5 -0
  156. package/dist/utils/builders/v1/llm-builder.js.map +1 -1
  157. package/dist/utils/builders/v1/mcp-builder.js +5 -0
  158. package/dist/utils/builders/v1/mcp-builder.js.map +1 -1
  159. package/dist/utils/builders/v1/network-builder.js +7 -1
  160. package/dist/utils/builders/v1/network-builder.js.map +1 -1
  161. package/dist/utils/builders/v1/path.js +5 -0
  162. package/dist/utils/builders/v1/path.js.map +1 -1
  163. package/dist/utils/builders/v2/agent-builder.js +5 -0
  164. package/dist/utils/builders/v2/agent-builder.js.map +1 -1
  165. package/dist/utils/builders/v2/broker-builder.d.ts +1 -0
  166. package/dist/utils/builders/v2/broker-builder.js +74 -4
  167. package/dist/utils/builders/v2/broker-builder.js.map +1 -1
  168. package/dist/utils/builders/v2/connections-builder.js +5 -0
  169. package/dist/utils/builders/v2/connections-builder.js.map +1 -1
  170. package/dist/utils/builders/v2/llm-builder.js +5 -0
  171. package/dist/utils/builders/v2/llm-builder.js.map +1 -1
  172. package/dist/utils/builders/v2/mcp-builder.js +5 -0
  173. package/dist/utils/builders/v2/mcp-builder.js.map +1 -1
  174. package/dist/utils/builders/v2/network-builder.js +8 -3
  175. package/dist/utils/builders/v2/network-builder.js.map +1 -1
  176. package/dist/utils/builders/v2/path.js +5 -0
  177. package/dist/utils/builders/v2/path.js.map +1 -1
  178. package/dist/utils/constants.d.ts +3 -2
  179. package/dist/utils/constants.js +13 -5
  180. package/dist/utils/constants.js.map +1 -1
  181. package/dist/utils/deployment-settings.d.ts +13 -0
  182. package/dist/utils/deployment-settings.js +97 -0
  183. package/dist/utils/deployment-settings.js.map +1 -0
  184. package/dist/utils/dry-run/dry-run-render.d.ts +19 -0
  185. package/dist/utils/dry-run/dry-run-render.js +137 -0
  186. package/dist/utils/dry-run/dry-run-render.js.map +1 -0
  187. package/dist/utils/exchange.js +5 -0
  188. package/dist/utils/exchange.js.map +1 -1
  189. package/dist/utils/facets/abstract-facet.d.ts +1 -0
  190. package/dist/utils/facets/abstract-facet.js +8 -0
  191. package/dist/utils/facets/abstract-facet.js.map +1 -1
  192. package/dist/utils/facets/agent-graph-facet.d.ts +14 -1
  193. package/dist/utils/facets/agent-graph-facet.js +139 -53
  194. package/dist/utils/facets/agent-graph-facet.js.map +1 -1
  195. package/dist/utils/facets/api-instance-facet.d.ts +37 -3
  196. package/dist/utils/facets/api-instance-facet.js +221 -65
  197. package/dist/utils/facets/api-instance-facet.js.map +1 -1
  198. package/dist/utils/facets/apim-policy-helpers.d.ts +13 -12
  199. package/dist/utils/facets/apim-policy-helpers.js +34 -22
  200. package/dist/utils/facets/apim-policy-helpers.js.map +1 -1
  201. package/dist/utils/facets/asset-facet.js +12 -9
  202. package/dist/utils/facets/asset-facet.js.map +1 -1
  203. package/dist/utils/facets/connection-facet.d.ts +9 -2
  204. package/dist/utils/facets/connection-facet.js +97 -68
  205. package/dist/utils/facets/connection-facet.js.map +1 -1
  206. package/dist/utils/facets/deployment-helpers.d.ts +18 -1
  207. package/dist/utils/facets/deployment-helpers.js +58 -0
  208. package/dist/utils/facets/deployment-helpers.js.map +1 -1
  209. package/dist/utils/facets/deployment-logs.d.ts +5 -0
  210. package/dist/utils/facets/deployment-logs.js +88 -0
  211. package/dist/utils/facets/deployment-logs.js.map +1 -0
  212. package/dist/utils/facets/deployment-runner.d.ts +2 -1
  213. package/dist/utils/facets/deployment-runner.js +22 -2
  214. package/dist/utils/facets/deployment-runner.js.map +1 -1
  215. package/dist/utils/facets/facets.d.ts +2 -0
  216. package/dist/utils/facets/facets.js +25 -3
  217. package/dist/utils/facets/facets.js.map +1 -1
  218. package/dist/utils/facets/mule-application-facet.d.ts +1 -1
  219. package/dist/utils/facets/mule-application-facet.js +38 -25
  220. package/dist/utils/facets/mule-application-facet.js.map +1 -1
  221. package/dist/utils/facets/publication-metadata-patcher.js +5 -0
  222. package/dist/utils/facets/publication-metadata-patcher.js.map +1 -1
  223. package/dist/utils/facets/publication-rank.js +5 -0
  224. package/dist/utils/facets/publication-rank.js.map +1 -1
  225. package/dist/utils/facets/undeploy-helpers.js +5 -0
  226. package/dist/utils/facets/undeploy-helpers.js.map +1 -1
  227. package/dist/utils/facets/unpublish-preflight.js +5 -0
  228. package/dist/utils/facets/unpublish-preflight.js.map +1 -1
  229. package/dist/utils/files.d.ts +25 -0
  230. package/dist/utils/files.js +67 -0
  231. package/dist/utils/files.js.map +1 -1
  232. package/dist/utils/gateway-mode.js +5 -0
  233. package/dist/utils/gateway-mode.js.map +1 -1
  234. package/dist/utils/gateway.d.ts +6 -2
  235. package/dist/utils/gateway.js +42 -33
  236. package/dist/utils/gateway.js.map +1 -1
  237. package/dist/utils/keychain.d.ts +56 -0
  238. package/dist/utils/keychain.js +488 -0
  239. package/dist/utils/keychain.js.map +1 -0
  240. package/dist/utils/logger.d.ts +1 -0
  241. package/dist/utils/logger.js +22 -14
  242. package/dist/utils/logger.js.map +1 -1
  243. package/dist/utils/mcp/mcp-metadata-mapper.d.ts +8 -0
  244. package/dist/utils/mcp/mcp-metadata-mapper.js +12 -1
  245. package/dist/utils/mcp/mcp-metadata-mapper.js.map +1 -1
  246. package/dist/utils/mcp/project-registrar.js +7 -26
  247. package/dist/utils/mcp/project-registrar.js.map +1 -1
  248. package/dist/utils/mcp/registry-key.js +5 -0
  249. package/dist/utils/mcp/registry-key.js.map +1 -1
  250. package/dist/utils/naming.d.ts +14 -0
  251. package/dist/utils/naming.js +41 -0
  252. package/dist/utils/naming.js.map +1 -1
  253. package/dist/utils/promise/promiseCreator.js +5 -0
  254. package/dist/utils/promise/promiseCreator.js.map +1 -1
  255. package/dist/utils/report/junit-report.js +5 -0
  256. package/dist/utils/report/junit-report.js.map +1 -1
  257. package/dist/utils/report/validation-report.js +5 -0
  258. package/dist/utils/report/validation-report.js.map +1 -1
  259. package/dist/utils/request-executor.d.ts +5 -5
  260. package/dist/utils/request-executor.js +5 -0
  261. package/dist/utils/request-executor.js.map +1 -1
  262. package/dist/utils/run-local/agent-console-proxy.d.ts +56 -0
  263. package/dist/utils/run-local/agent-console-proxy.js +182 -0
  264. package/dist/utils/run-local/agent-console-proxy.js.map +1 -0
  265. package/dist/utils/run-local/broker-recreate-selector.d.ts +31 -0
  266. package/dist/utils/run-local/broker-recreate-selector.js +82 -0
  267. package/dist/utils/run-local/broker-recreate-selector.js.map +1 -0
  268. package/dist/utils/run-local/build-status.d.ts +73 -0
  269. package/dist/utils/run-local/build-status.js +210 -0
  270. package/dist/utils/run-local/build-status.js.map +1 -0
  271. package/dist/utils/run-local/constants.d.ts +28 -0
  272. package/dist/utils/run-local/constants.js +36 -0
  273. package/dist/utils/run-local/constants.js.map +1 -0
  274. package/dist/utils/run-local/crd-files.d.ts +2 -0
  275. package/dist/utils/run-local/crd-files.js +24 -0
  276. package/dist/utils/run-local/crd-files.js.map +1 -0
  277. package/dist/utils/run-local/index.d.ts +9 -0
  278. package/dist/utils/run-local/index.js +42 -0
  279. package/dist/utils/run-local/index.js.map +1 -0
  280. package/dist/utils/run-local/local-a2a-upstream.d.ts +9 -0
  281. package/dist/utils/run-local/local-a2a-upstream.js +55 -0
  282. package/dist/utils/run-local/local-a2a-upstream.js.map +1 -0
  283. package/dist/utils/run-local/local-deploy-descriptor.d.ts +36 -0
  284. package/dist/utils/run-local/local-deploy-descriptor.js +70 -0
  285. package/dist/utils/run-local/local-deploy-descriptor.js.map +1 -0
  286. package/dist/utils/run-local/local-run-manager.d.ts +51 -0
  287. package/dist/utils/run-local/local-run-manager.js +220 -0
  288. package/dist/utils/run-local/local-run-manager.js.map +1 -0
  289. package/dist/utils/run-local/policy-resolver.d.ts +69 -0
  290. package/dist/utils/run-local/policy-resolver.js +461 -0
  291. package/dist/utils/run-local/policy-resolver.js.map +1 -0
  292. package/dist/utils/run-local/runtime-environment-manager.d.ts +89 -0
  293. package/dist/utils/run-local/runtime-environment-manager.js +313 -0
  294. package/dist/utils/run-local/runtime-environment-manager.js.map +1 -0
  295. package/dist/utils/run-local/secrets-manager.d.ts +66 -0
  296. package/dist/utils/run-local/secrets-manager.js +181 -0
  297. package/dist/utils/run-local/secrets-manager.js.map +1 -0
  298. package/dist/utils/uris.d.ts +5 -0
  299. package/dist/utils/uris.js +23 -1
  300. package/dist/utils/uris.js.map +1 -1
  301. package/dist/utils/variables.d.ts +17 -4
  302. package/dist/utils/variables.js +57 -7
  303. package/dist/utils/variables.js.map +1 -1
  304. package/dist/utils/zip-utils.js +5 -0
  305. package/dist/utils/zip-utils.js.map +1 -1
  306. package/package.json +7 -5
  307. package/scripts/check-gus-ticket-format.sh +29 -0
  308. package/scripts/resolve-version.sh +241 -0
  309. package/scripts/resolve-version.test.sh +278 -0
  310. package/scripts/test-publish-npm.sh +130 -0
  311. package/templates/agent-network/exchange.json.template +1 -0
  312. package/templates/agentic-network/brokers/broker1.agent.template +2 -2
  313. package/templates/agentic-network/exchange.json.template +1 -0
@@ -0,0 +1,36 @@
1
+ import { Space } from '../builders/project-builder';
2
+ import { GAV } from '../../types/types';
3
+ /** Bumped only on a breaking change to the shape; consumers must ignore versions they don't know. */
4
+ export declare const LOCAL_DEPLOY_DESCRIPTOR_SCHEMA_VERSION = 1;
5
+ /**
6
+ * One callable broker endpoint. `id` (assetId), `name` (`info.label`) and `path` are distinct
7
+ * on purpose: reusing one for another mislabels the broker or calls the wrong URL.
8
+ */
9
+ export type LocalDeployBroker = {
10
+ id: string;
11
+ name: string;
12
+ path: string;
13
+ url: string;
14
+ description?: string;
15
+ };
16
+ /** Identifiers, labels, paths and ports only — never variable values, which stay in compose env. */
17
+ export type LocalDeployDescriptor = {
18
+ schemaVersion: number;
19
+ generatedAt: string;
20
+ gav: GAV;
21
+ ingress: {
22
+ port: number;
23
+ baseUrl: string;
24
+ };
25
+ brokers: LocalDeployBroker[];
26
+ };
27
+ export type LocalDeployDescriptorOptions = {
28
+ localRenderDir: string;
29
+ space: Space;
30
+ dockerPort: number;
31
+ /** The map the gateway CRDs were rendered against, secrets already replaced by an inert token. */
32
+ variables: Record<string, string>;
33
+ };
34
+ export declare function buildLocalDeployDescriptor(space: Space, dockerPort: number, variables: Record<string, string>): LocalDeployDescriptor;
35
+ /** Writes via tmp-file + rename so a watching consumer never observes a partial JSON document. */
36
+ export declare function writeLocalDeployDescriptor(options: LocalDeployDescriptorOptions): void;
@@ -0,0 +1,70 @@
1
+ "use strict";
2
+ Object.defineProperty(exports, "__esModule", { value: true });
3
+ exports.LOCAL_DEPLOY_DESCRIPTOR_SCHEMA_VERSION = void 0;
4
+ exports.buildLocalDeployDescriptor = buildLocalDeployDescriptor;
5
+ exports.writeLocalDeployDescriptor = writeLocalDeployDescriptor;
6
+ const tslib_1 = require("tslib");
7
+ const fs = tslib_1.__importStar(require("fs-extra"));
8
+ const node_path_1 = require("node:path");
9
+ const constants_1 = require("../constants");
10
+ const variables_1 = require("../variables");
11
+ const constants_2 = require("./constants");
12
+ /** Bumped only on a breaking change to the shape; consumers must ignore versions they don't know. */
13
+ exports.LOCAL_DEPLOY_DESCRIPTOR_SCHEMA_VERSION = 1;
14
+ const TMP_SUFFIX = '.tmp';
15
+ const LOCAL_HOST = 'localhost';
16
+ function buildLocalDeployDescriptor(space, dockerPort, variables) {
17
+ const baseUrl = `http://${LOCAL_HOST}:${dockerPort}`;
18
+ const brokers = [];
19
+ for (const component of Object.values(space.components)) {
20
+ for (const instance of Object.values(component.apiInstances)) {
21
+ if (instance.type !== constants_1.A2AV1) {
22
+ continue;
23
+ }
24
+ brokers.push(toBroker(instance, baseUrl, variables));
25
+ }
26
+ }
27
+ brokers.sort((a, b) => a.id.localeCompare(b.id));
28
+ return {
29
+ schemaVersion: exports.LOCAL_DEPLOY_DESCRIPTOR_SCHEMA_VERSION,
30
+ generatedAt: new Date().toISOString(),
31
+ gav: space.gav,
32
+ ingress: { port: dockerPort, baseUrl },
33
+ brokers,
34
+ };
35
+ }
36
+ function toBroker(instance, baseUrl, variables) {
37
+ // Same map and helper as the ingress CRD, so the advertised URL and the live route cannot diverge.
38
+ const path = normalizePath(variables_1.VariablesHelper.recursivelyReplacePlaceholders(instance.path, variables));
39
+ // Defensive: every broker reaching here sets environmentInstanceId; fall back to the raw
40
+ // (unresolved) path for a stable id if that ever changes — a resolved path would move with a
41
+ // variable value and lose the consumer's per-broker state on the next render.
42
+ const id = instance.environmentInstanceId || normalizePath(instance.path);
43
+ const name = variables_1.VariablesHelper.recursivelyReplacePlaceholders(instance.id, variables);
44
+ const description = instance.description && variables_1.VariablesHelper.recursivelyReplacePlaceholders(instance.description, variables);
45
+ return {
46
+ id,
47
+ name,
48
+ path,
49
+ url: `${baseUrl}/${path}/`,
50
+ ...(description ? { description } : {}),
51
+ };
52
+ }
53
+ function normalizePath(path) {
54
+ return path.replace(/^\/+/, '').replace(/\/+$/, '');
55
+ }
56
+ /** Writes via tmp-file + rename so a watching consumer never observes a partial JSON document. */
57
+ function writeLocalDeployDescriptor(options) {
58
+ const { localRenderDir, space, dockerPort, variables } = options;
59
+ const target = (0, node_path_1.join)(localRenderDir, constants_2.LOCAL_DEPLOY_DESCRIPTOR_FILE);
60
+ const tmp = `${target}${TMP_SUFFIX}`;
61
+ try {
62
+ fs.writeFileSync(tmp, JSON.stringify(buildLocalDeployDescriptor(space, dockerPort, variables), null, 2));
63
+ fs.renameSync(tmp, target);
64
+ }
65
+ finally {
66
+ // The render dir is watched, so a half-written tmp left by a failed rename must not survive.
67
+ fs.removeSync(tmp);
68
+ }
69
+ }
70
+ //# sourceMappingURL=local-deploy-descriptor.js.map
@@ -0,0 +1 @@
1
+ {"version":3,"file":"local-deploy-descriptor.js","sourceRoot":"","sources":["../../../src/utils/run-local/local-deploy-descriptor.ts"],"names":[],"mappings":";;;AA8CA,gEAuBC;AA0BD,gEAYC;;AA3GD,qDAA8B;AAC9B,yCAA8B;AAG9B,4CAAkC;AAClC,4CAA4C;AAC5C,2CAAwD;AAExD,qGAAqG;AACxF,QAAA,sCAAsC,GAAG,CAAC,CAAA;AAEvD,MAAM,UAAU,GAAG,MAAM,CAAA;AACzB,MAAM,UAAU,GAAG,WAAW,CAAA;AAkC9B,SAAgB,0BAA0B,CAAC,KAAY,EAAE,UAAkB,EAAE,SAAiC;IAC5G,MAAM,OAAO,GAAG,UAAU,UAAU,IAAI,UAAU,EAAE,CAAA;IACpD,MAAM,OAAO,GAAwB,EAAE,CAAA;IAEvC,KAAK,MAAM,SAAS,IAAI,MAAM,CAAC,MAAM,CAAC,KAAK,CAAC,UAAU,CAAC,EAAE,CAAC;QACxD,KAAK,MAAM,QAAQ,IAAI,MAAM,CAAC,MAAM,CAAC,SAAS,CAAC,YAAY,CAAC,EAAE,CAAC;YAC7D,IAAI,QAAQ,CAAC,IAAI,KAAK,iBAAK,EAAE,CAAC;gBAC5B,SAAQ;YACV,CAAC;YAED,OAAO,CAAC,IAAI,CAAC,QAAQ,CAAC,QAAQ,EAAE,OAAO,EAAE,SAAS,CAAC,CAAC,CAAA;QACtD,CAAC;IACH,CAAC;IAED,OAAO,CAAC,IAAI,CAAC,CAAC,CAAC,EAAE,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,EAAE,CAAC,aAAa,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,CAAA;IAEhD,OAAO;QACL,aAAa,EAAE,8CAAsC;QACrD,WAAW,EAAE,IAAI,IAAI,EAAE,CAAC,WAAW,EAAE;QACrC,GAAG,EAAE,KAAK,CAAC,GAAG;QACd,OAAO,EAAE,EAAC,IAAI,EAAE,UAAU,EAAE,OAAO,EAAC;QACpC,OAAO;KACR,CAAA;AACH,CAAC;AAED,SAAS,QAAQ,CAAC,QAAqB,EAAE,OAAe,EAAE,SAAiC;IACzF,mGAAmG;IACnG,MAAM,IAAI,GAAG,aAAa,CAAC,2BAAe,CAAC,8BAA8B,CAAC,QAAQ,CAAC,IAAI,EAAE,SAAS,CAAC,CAAC,CAAA;IACpG,yFAAyF;IACzF,6FAA6F;IAC7F,8EAA8E;IAC9E,MAAM,EAAE,GAAG,QAAQ,CAAC,qBAAqB,IAAI,aAAa,CAAC,QAAQ,CAAC,IAAI,CAAC,CAAA;IACzE,MAAM,IAAI,GAAG,2BAAe,CAAC,8BAA8B,CAAC,QAAQ,CAAC,EAAE,EAAE,SAAS,CAAC,CAAA;IACnF,MAAM,WAAW,GAAG,QAAQ,CAAC,WAAW,IAAI,2BAAe,CAAC,8BAA8B,CAAC,QAAQ,CAAC,WAAW,EAAE,SAAS,CAAC,CAAA;IAE3H,OAAO;QACL,EAAE;QACF,IAAI;QACJ,IAAI;QACJ,GAAG,EAAE,GAAG,OAAO,IAAI,IAAI,GAAG;QAC1B,GAAG,CAAC,WAAW,CAAC,CAAC,CAAC,EAAC,WAAW,EAAC,CAAC,CAAC,CAAC,EAAE,CAAC;KACtC,CAAA;AACH,CAAC;AAED,SAAS,aAAa,CAAC,IAAY;IACjC,OAAO,IAAI,CAAC,OAAO,CAAC,MAAM,EAAE,EAAE,CAAC,CAAC,OAAO,CAAC,MAAM,EAAE,EAAE,CAAC,CAAA;AACrD,CAAC;AAED,kGAAkG;AAClG,SAAgB,0BAA0B,CAAC,OAAqC;IAC9E,MAAM,EAAC,cAAc,EAAE,KAAK,EAAE,UAAU,EAAE,SAAS,EAAC,GAAG,OAAO,CAAA;IAC9D,MAAM,MAAM,GAAG,IAAA,gBAAI,EAAC,cAAc,EAAE,wCAA4B,CAAC,CAAA;IACjE,MAAM,GAAG,GAAG,GAAG,MAAM,GAAG,UAAU,EAAE,CAAA;IAEpC,IAAI,CAAC;QACH,EAAE,CAAC,aAAa,CAAC,GAAG,EAAE,IAAI,CAAC,SAAS,CAAC,0BAA0B,CAAC,KAAK,EAAE,UAAU,EAAE,SAAS,CAAC,EAAE,IAAI,EAAE,CAAC,CAAC,CAAC,CAAA;QACxG,EAAE,CAAC,UAAU,CAAC,GAAG,EAAE,MAAM,CAAC,CAAA;IAC5B,CAAC;YAAS,CAAC;QACT,6FAA6F;QAC7F,EAAE,CAAC,UAAU,CAAC,GAAG,CAAC,CAAA;IACpB,CAAC;AACH,CAAC"}
@@ -0,0 +1,51 @@
1
+ import { Dependency, Space } from '../builders/project-builder';
2
+ export type LocalRunSetupOptions = {
3
+ projectPath: string;
4
+ targetDir: string;
5
+ localRenderDir: string;
6
+ space: Space;
7
+ dockerPort: number;
8
+ };
9
+ /**
10
+ * Manages the .deployment/local/ directory structure that serves as the self-contained
11
+ * runtime environment for local execution.
12
+ *
13
+ * Responsibilities include creating gateway config directories, generating Flex
14
+ * Gateway registration files, copying project sources, writing static CRDs
15
+ * (logging, exchange service), and preparing Exchange assets for the local
16
+ * static file server.
17
+ */
18
+ export interface LocalRunManager {
19
+ /**
20
+ * Validates the Exchange assets that local run will copy before any render side effects.
21
+ */
22
+ validateExchangeAssets(space: Space, targetDir: string): void;
23
+ /**
24
+ * Creates or refreshes the .deployment/local/ directory with all static artifacts
25
+ * needed before facet rendering and runtime configuration.
26
+ */
27
+ setup(options: LocalRunSetupOptions): void;
28
+ }
29
+ /**
30
+ * Default implementation that produces a Docker Compose-compatible directory layout.
31
+ * Generates Flex Gateway disconnected-mode registration via Docker, copies project
32
+ * sources, and writes Flex CRDs for logging and the exchange service.
33
+ */
34
+ export declare class DefaultLocalRunManager implements LocalRunManager {
35
+ validateExchangeAssets(space: Space, targetDir: string): void;
36
+ setup(options: LocalRunSetupOptions): void;
37
+ static validateExchangeAssets(space: Space, targetDir: string, exchangeModuleDir?: string): void;
38
+ static cleanVolatileArtifacts(localRenderDir: string): void;
39
+ static ensureFlexRegistration(localRenderDir: string, side: 'ingress' | 'egress'): boolean;
40
+ static copyProjectSources(projectPath: string, destDir: string): void;
41
+ static writeLoggingConfig(localRenderDir: string, side: 'ingress' | 'egress'): void;
42
+ static writeExchangeServiceCRD(localRenderDir: string, side: 'ingress' | 'egress'): void;
43
+ static copyExchangeAssets(space: Space, targetDir: string, localRenderDir: string, exchangeModuleDir?: string): void;
44
+ static copyDependencyAsset(dep: Dependency, exchangeDir: string, depCacheDir?: string): void;
45
+ private static collectOwnedCandidate;
46
+ private static collectDependencyCandidate;
47
+ private static exchangeAssetCandidates;
48
+ private static validateCandidateDestinations;
49
+ private static candidateLabel;
50
+ private static writePortConfig;
51
+ }
@@ -0,0 +1,220 @@
1
+ "use strict";
2
+ Object.defineProperty(exports, "__esModule", { value: true });
3
+ exports.DefaultLocalRunManager = void 0;
4
+ const tslib_1 = require("tslib");
5
+ const node_child_process_1 = require("node:child_process");
6
+ const fs = tslib_1.__importStar(require("fs-extra"));
7
+ const node_path_1 = require("node:path");
8
+ const yaml_1 = tslib_1.__importDefault(require("yaml"));
9
+ const naming_1 = require("../naming");
10
+ const error_factory_1 = require("../../errors/error-factory");
11
+ const utils_1 = require("../../helpers/utils");
12
+ const FLEX_IMAGE = 'mulesoft/flex-gateway';
13
+ /**
14
+ * Default implementation that produces a Docker Compose-compatible directory layout.
15
+ * Generates Flex Gateway disconnected-mode registration via Docker, copies project
16
+ * sources, and writes Flex CRDs for logging and the exchange service.
17
+ */
18
+ class DefaultLocalRunManager {
19
+ validateExchangeAssets(space, targetDir) {
20
+ DefaultLocalRunManager.validateExchangeAssets(space, targetDir);
21
+ }
22
+ setup(options) {
23
+ const { projectPath, targetDir, localRenderDir, space, dockerPort } = options;
24
+ fs.mkdirpSync(localRenderDir);
25
+ fs.mkdirpSync((0, node_path_1.join)(localRenderDir, 'ingress', 'config'));
26
+ fs.mkdirpSync((0, node_path_1.join)(localRenderDir, 'egress', 'config'));
27
+ DefaultLocalRunManager.cleanVolatileArtifacts(localRenderDir);
28
+ DefaultLocalRunManager.ensureFlexRegistration(localRenderDir, 'ingress');
29
+ DefaultLocalRunManager.ensureFlexRegistration(localRenderDir, 'egress');
30
+ DefaultLocalRunManager.copyProjectSources(projectPath, (0, node_path_1.join)(localRenderDir, 'agent-graph', 'src'));
31
+ DefaultLocalRunManager.writeLoggingConfig(localRenderDir, 'ingress');
32
+ DefaultLocalRunManager.writeLoggingConfig(localRenderDir, 'egress');
33
+ DefaultLocalRunManager.writeExchangeServiceCRD(localRenderDir, 'ingress');
34
+ DefaultLocalRunManager.writeExchangeServiceCRD(localRenderDir, 'egress');
35
+ DefaultLocalRunManager.writePortConfig(localRenderDir, dockerPort);
36
+ DefaultLocalRunManager.copyExchangeAssets(space, targetDir, localRenderDir);
37
+ }
38
+ static validateExchangeAssets(space, targetDir, exchangeModuleDir = (0, utils_1.resolvePDKExchangeModuleDir)()) {
39
+ DefaultLocalRunManager.exchangeAssetCandidates(space, targetDir, exchangeModuleDir);
40
+ }
41
+ static cleanVolatileArtifacts(localRenderDir) {
42
+ fs.removeSync((0, node_path_1.join)(localRenderDir, 'ingress', 'config', 'apis'));
43
+ fs.removeSync((0, node_path_1.join)(localRenderDir, 'egress', 'config', 'apis'));
44
+ }
45
+ static ensureFlexRegistration(localRenderDir, side) {
46
+ var _a, _b;
47
+ const configDir = (0, node_path_1.join)(localRenderDir, side, 'config');
48
+ const registrationFile = (0, node_path_1.join)(configDir, 'registration.yaml');
49
+ if (fs.existsSync(registrationFile)) {
50
+ return true;
51
+ }
52
+ fs.mkdirpSync(configDir);
53
+ const gwName = `local-${side}`;
54
+ const uid = (_a = process.getuid) === null || _a === void 0 ? void 0 : _a.call(process);
55
+ const args = ['run', '--rm', '--entrypoint', 'flexctl'];
56
+ if (uid !== undefined) {
57
+ args.push('-u', String(uid));
58
+ }
59
+ args.push('-v', `${configDir}:/registration`, FLEX_IMAGE, 'registration', 'create', '--output-directory=/registration', '--mode=disconnected', gwName);
60
+ try {
61
+ (0, node_child_process_1.execFileSync)('docker', args, { stdio: 'pipe' });
62
+ }
63
+ catch (error) {
64
+ const stderr = ((_b = error.stderr) === null || _b === void 0 ? void 0 : _b.toString()) || error.message;
65
+ throw error_factory_1.ErrorFactory.flexRegistrationFailed(side, stderr);
66
+ }
67
+ return false;
68
+ }
69
+ static copyProjectSources(projectPath, destDir) {
70
+ fs.mkdirpSync(destDir);
71
+ fs.emptyDirSync(destDir);
72
+ const entries = fs.readdirSync(projectPath);
73
+ for (const entry of entries) {
74
+ if (entry === 'target' || entry === 'node_modules' || entry.startsWith('.')) {
75
+ continue;
76
+ }
77
+ fs.copySync((0, node_path_1.join)(projectPath, entry), (0, node_path_1.join)(destDir, entry));
78
+ }
79
+ }
80
+ static writeLoggingConfig(localRenderDir, side) {
81
+ const config = {
82
+ apiVersion: 'gateway.mulesoft.com/v1alpha1',
83
+ kind: 'Configuration',
84
+ metadata: { name: `${side}-logging-config` },
85
+ spec: {
86
+ logging: {
87
+ runtimeLogs: {
88
+ logLevel: 'info',
89
+ },
90
+ },
91
+ },
92
+ };
93
+ fs.writeFileSync((0, node_path_1.join)(localRenderDir, side, 'config', 'logging.yaml'), yaml_1.default.stringify(config));
94
+ }
95
+ static writeExchangeServiceCRD(localRenderDir, side) {
96
+ const crd = {
97
+ apiVersion: 'gateway.mulesoft.com/v1alpha1',
98
+ kind: 'Service',
99
+ metadata: { name: 'exchange' },
100
+ spec: { address: 'http://exchange/' },
101
+ };
102
+ fs.writeFileSync((0, node_path_1.join)(localRenderDir, side, 'config', 'exchange-service.yaml'), yaml_1.default.stringify(crd));
103
+ }
104
+ static copyExchangeAssets(space, targetDir, localRenderDir, exchangeModuleDir = (0, utils_1.resolvePDKExchangeModuleDir)()) {
105
+ const exchangeDir = (0, node_path_1.join)(localRenderDir, 'exchange', 'assets');
106
+ fs.mkdirpSync(exchangeDir);
107
+ for (const candidate of DefaultLocalRunManager.exchangeAssetCandidates(space, targetDir, exchangeModuleDir)) {
108
+ const destDir = (0, node_path_1.join)(exchangeDir, candidate.destination);
109
+ if (candidate.kind === 'owned') {
110
+ fs.mkdirpSync(destDir);
111
+ fs.copySync(candidate.sourceDir, destDir);
112
+ }
113
+ else {
114
+ DefaultLocalRunManager.copyDependencyAsset(candidate.gav, exchangeDir, candidate.sourceDir);
115
+ }
116
+ }
117
+ const nginxConf = `server {
118
+ listen 80;
119
+ location / {
120
+ root /usr/share/nginx/html;
121
+ autoindex on;
122
+ add_header Access-Control-Allow-Origin *;
123
+ }
124
+ }
125
+ `;
126
+ fs.writeFileSync((0, node_path_1.join)(localRenderDir, 'exchange', 'nginx.conf'), nginxConf);
127
+ }
128
+ static copyDependencyAsset(dep, exchangeDir, depCacheDir = (0, node_path_1.join)((0, utils_1.resolvePDKExchangeModuleDir)(), dep.groupId, dep.assetId, dep.version)) {
129
+ if (!fs.existsSync(depCacheDir)) {
130
+ return;
131
+ }
132
+ const destDir = (0, node_path_1.join)(exchangeDir, (0, naming_1.toSlug)(dep.assetId));
133
+ if (fs.existsSync(destDir)) {
134
+ return;
135
+ }
136
+ fs.mkdirpSync(destDir);
137
+ const entries = fs.readdirSync(depCacheDir);
138
+ for (const entry of entries) {
139
+ if (entry === 'exchange.json') {
140
+ continue;
141
+ }
142
+ fs.copySync((0, node_path_1.join)(depCacheDir, entry), (0, node_path_1.join)(destDir, entry));
143
+ }
144
+ }
145
+ static collectOwnedCandidate(space, component, assetId, targetDir) {
146
+ const sourceDir = (0, node_path_1.join)(targetDir, 'network', component.id, 'assets', assetId, 'files');
147
+ if (!fs.existsSync(sourceDir)) {
148
+ return undefined;
149
+ }
150
+ return {
151
+ kind: 'owned',
152
+ gav: { groupId: space.gav.groupId, assetId, version: component.version },
153
+ sourceDir,
154
+ destination: (0, naming_1.toSlug)(assetId),
155
+ };
156
+ }
157
+ static collectDependencyCandidate(dep, exchangeModuleDir, dependencies) {
158
+ if (dep.classifier === 'schema') {
159
+ return undefined;
160
+ }
161
+ const depCacheDir = (0, node_path_1.join)(exchangeModuleDir, dep.groupId, dep.assetId, dep.version);
162
+ if (!fs.existsSync(depCacheDir)) {
163
+ return undefined;
164
+ }
165
+ const identity = `${dep.groupId}:${dep.assetId}:${dep.version}`;
166
+ if (dependencies.has(identity)) {
167
+ return undefined;
168
+ }
169
+ dependencies.add(identity);
170
+ return { kind: 'dependency', gav: dep, sourceDir: depCacheDir, destination: (0, naming_1.toSlug)(dep.assetId) };
171
+ }
172
+ static exchangeAssetCandidates(space, targetDir, exchangeModuleDir = (0, utils_1.resolvePDKExchangeModuleDir)()) {
173
+ var _a;
174
+ const candidates = [];
175
+ const dependencies = new Set();
176
+ for (const component of Object.values(space.components)) {
177
+ for (const [assetId, asset] of Object.entries(component.assets)) {
178
+ const owned = DefaultLocalRunManager.collectOwnedCandidate(space, component, assetId, targetDir);
179
+ if (!owned) {
180
+ continue;
181
+ }
182
+ candidates.push(owned);
183
+ for (const dep of (_a = asset.dependencies) !== null && _a !== void 0 ? _a : []) {
184
+ const dependency = DefaultLocalRunManager.collectDependencyCandidate(dep, exchangeModuleDir, dependencies);
185
+ if (dependency) {
186
+ candidates.push(dependency);
187
+ }
188
+ }
189
+ }
190
+ }
191
+ DefaultLocalRunManager.validateCandidateDestinations(candidates);
192
+ return candidates;
193
+ }
194
+ static validateCandidateDestinations(candidates) {
195
+ const destinations = new Map();
196
+ for (const candidate of candidates) {
197
+ if (!candidate.destination) {
198
+ throw error_factory_1.ErrorFactory.genericError(`Local Exchange asset ${DefaultLocalRunManager.candidateLabel(candidate)} has an empty or unsafe destination. Rename the asset or dependency to a safe asset ID.`);
199
+ }
200
+ const existing = destinations.get(candidate.destination);
201
+ if (existing) {
202
+ throw error_factory_1.ErrorFactory.genericError(`Local Exchange assets ${DefaultLocalRunManager.candidateLabel(existing)} and ` +
203
+ `${DefaultLocalRunManager.candidateLabel(candidate)} both map to ` +
204
+ `'exchange/assets/${candidate.destination}'. Rename an asset or use a distinct dependency.`);
205
+ }
206
+ destinations.set(candidate.destination, candidate);
207
+ }
208
+ }
209
+ static candidateLabel(candidate) {
210
+ const identity = `${candidate.gav.groupId}:${candidate.gav.assetId}:${candidate.gav.version}`;
211
+ return candidate.kind === 'owned' ? `owned asset '${identity}'` : `dependency '${identity}'`;
212
+ }
213
+ static writePortConfig(localRenderDir, dockerPort) {
214
+ const portFile = (0, node_path_1.join)(localRenderDir, 'deploy-port.cfg');
215
+ fs.existsSync(portFile) && fs.rmSync(portFile);
216
+ fs.writeFileSync(portFile, String(dockerPort));
217
+ }
218
+ }
219
+ exports.DefaultLocalRunManager = DefaultLocalRunManager;
220
+ //# sourceMappingURL=local-run-manager.js.map
@@ -0,0 +1 @@
1
+ {"version":3,"file":"local-run-manager.js","sourceRoot":"","sources":["../../../src/utils/run-local/local-run-manager.ts"],"names":[],"mappings":"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"}
@@ -0,0 +1,69 @@
1
+ import { AxiosInstance } from 'axios';
2
+ import { PolicyBinding } from '../builders/project-builder';
3
+ /**
4
+ * Resolves policy definition GAVs to their Flex Gateway implementation asset IDs.
5
+ *
6
+ * Facets call `resolve()` during CRD rendering to get the implementation name for
7
+ * each policy (resolving lazily via Exchange API on first encounter, then cached).
8
+ * `markForDownload()` flags non-OOTB policies for later installation.
9
+ * After facets complete, the command calls `downloadAll()` to fetch and install bundles.
10
+ */
11
+ export interface PolicyResolver {
12
+ /** Returns the Flex definition extension name for a policy binding. Resolves lazily from Exchange on first call; OOTB policies return their own assetId immediately. */
13
+ resolve(policy: PolicyBinding): Promise<string>;
14
+ /**
15
+ * Marks a non-OOTB policy for download into the given side's config directory.
16
+ * Must be called after `resolve()` for the same policy: `resolve()` populates the
17
+ * implementation cache (including the definition extension name) that `downloadAll()`
18
+ * later reads to synthesize definition Extensions for schema-classifier bases.
19
+ */
20
+ markForDownload(policy: PolicyBinding, side: 'ingress' | 'egress'): void;
21
+ /** Downloads and installs all marked policies. Returns the count of newly installed bundles. */
22
+ downloadAll(localRenderDir: string): Promise<number>;
23
+ }
24
+ export type PolicyResolverOptions = {
25
+ req: AxiosInstance;
26
+ localRenderDir: string;
27
+ session: any;
28
+ host: string;
29
+ };
30
+ /**
31
+ * PolicyResolver backed by the Exchange API with disk-based caching.
32
+ *
33
+ * On construction, loads previously resolved implementations from
34
+ * .policy-implementations.json. New policies are resolved lazily on first
35
+ * `resolve()` call and cached both in memory and on disk.
36
+ * Downloads are batched per side after facets complete.
37
+ */
38
+ export declare class ExchangePolicyResolver implements PolicyResolver {
39
+ private readonly implCache;
40
+ private readonly pendingResolutions;
41
+ private dirty;
42
+ private readonly ingressDownloads;
43
+ private readonly egressDownloads;
44
+ private readonly req;
45
+ private readonly session;
46
+ private readonly host;
47
+ private readonly localRenderDir;
48
+ constructor(options: PolicyResolverOptions);
49
+ resolve(policy: PolicyBinding): Promise<string>;
50
+ private fetchAndCache;
51
+ markForDownload(policy: PolicyBinding, side: 'ingress' | 'egress'): void;
52
+ downloadAll(localRenderDir: string): Promise<number>;
53
+ private fetchFlexImplementation;
54
+ private static toKey;
55
+ private static loadDiskCache;
56
+ private static saveDiskCache;
57
+ private static isPolicyFetched;
58
+ private static isPolicyInstalled;
59
+ static installPolicyToTarget(assetPath: string, targetDir: string, visited?: Set<string>, definitionNameMap?: Map<string, string>): void;
60
+ private static copyPolicyMain;
61
+ private static installGclOrSynthesizeDefinition;
62
+ private static installPolicyDependencies;
63
+ private static mapDependencyTreeToDefinition;
64
+ private static fetchAssetWithDependencies;
65
+ private static fetchAssetOnce;
66
+ private static synthesizeDefinitionExtension;
67
+ private static extractDefinitionExtensionName;
68
+ private static getDescriptorFromAsset;
69
+ }