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,278 @@
1
+ #!/usr/bin/env bash
2
+ #
3
+ # Integration test for scripts/resolve-version.sh.
4
+ # Runs the resolver against temporary package.json fixtures and asserts:
5
+ # - version is rewritten as expected for each branch shape
6
+ # - the resulting file is still valid JSON
7
+ # - non-version fields are preserved untouched
8
+ #
9
+ # Uses Node (already required by the resolver) to validate JSON, so no
10
+ # additional dependencies are needed on the SFCI image.
11
+
12
+ set -euo pipefail
13
+
14
+ SCRIPT_DIR="$(cd "$(dirname "$0")" && pwd)"
15
+ RESOLVER="${SCRIPT_DIR}/resolve-version.sh"
16
+
17
+ fail=0
18
+ pass=0
19
+
20
+ # Builds a fake `npm` executable that fails `npm view` with the given
21
+ # stderr output, so published_versions()'s registry-failure path can be
22
+ # exercised deterministically and offline (no real network/registry).
23
+ make_fake_npm() {
24
+ local bindir="$1" stderr_output="$2"
25
+ mkdir -p "$bindir"
26
+ cat > "${bindir}/npm" <<SCRIPT
27
+ #!/usr/bin/env bash
28
+ echo "${stderr_output}" >&2
29
+ exit 1
30
+ SCRIPT
31
+ chmod +x "${bindir}/npm"
32
+ }
33
+
34
+ # Builds a fake `npm` executable that SUCCEEDS (exit 0) with the given stdout
35
+ # JSON, but ALSO writes noise to stderr -- reproducing real npm@10.8.3's
36
+ # "npm info using npm@10.8.3" banner on stderr on every call, success or not.
37
+ make_fake_npm_success() {
38
+ local bindir="$1" stdout_json="$2" stderr_noise="$3"
39
+ mkdir -p "$bindir"
40
+ cat > "${bindir}/npm" <<SCRIPT
41
+ #!/usr/bin/env bash
42
+ echo "${stderr_noise}" >&2
43
+ echo '${stdout_json}'
44
+ exit 0
45
+ SCRIPT
46
+ chmod +x "${bindir}/npm"
47
+ }
48
+
49
+ run_case() {
50
+ local label="$1"; shift
51
+ local expected="$1"; shift
52
+ # Remaining args are VAR=VALUE pairs to export for the resolver, plus
53
+ # test-only directives consumed here (not exported): PKG_VERSION=x.y.z
54
+ # overrides the fixture's package.json version (default 1.0.0);
55
+ # FAKE_NPM_STDERR=<text> puts a fake FAILING `npm` on PATH instead of
56
+ # relying on RESOLVE_PUBLISHED_VERSIONS_JSON; FAKE_NPM_SUCCESS_JSON=<json>
57
+ # (paired with FAKE_NPM_NOISE=<text>) puts a fake SUCCEEDING `npm` on
58
+ # PATH that also writes noise to stderr, reproducing real npm's
59
+ # informational banners on a successful call; PRE_TAG=<tag> creates that
60
+ # git tag in the fixture BEFORE the resolver runs, to simulate "a prior
61
+ # build already tagged this version, but the registry doesn't know it
62
+ # yet" (git_tag_versions()'s reason for existing).
63
+
64
+ local pkg_version="1.0.0"
65
+ local fake_npm_stderr=""
66
+ local fake_npm_success_json=""
67
+ local fake_npm_noise=""
68
+ local pre_tag=""
69
+ local -a envs=()
70
+ for kv in "$@"; do
71
+ case "$kv" in
72
+ PKG_VERSION=*) pkg_version="${kv#PKG_VERSION=}" ;;
73
+ FAKE_NPM_STDERR=*) fake_npm_stderr="${kv#FAKE_NPM_STDERR=}" ;;
74
+ FAKE_NPM_SUCCESS_JSON=*) fake_npm_success_json="${kv#FAKE_NPM_SUCCESS_JSON=}" ;;
75
+ FAKE_NPM_NOISE=*) fake_npm_noise="${kv#FAKE_NPM_NOISE=}" ;;
76
+ PRE_TAG=*) pre_tag="${kv#PRE_TAG=}" ;;
77
+ *) envs+=("$kv") ;;
78
+ esac
79
+ done
80
+
81
+ local tmpdir
82
+ tmpdir="$(mktemp -d)"
83
+ trap 'rm -rf "$tmpdir"' RETURN
84
+
85
+ cat > "${tmpdir}/package.json" <<JSON
86
+ {
87
+ "name": "@mulesoft/anypoint-cli-agent-fabric-plugin",
88
+ "version": "${pkg_version}",
89
+ "description": "agent-fabric plugin"
90
+ }
91
+ JSON
92
+ git -C "$tmpdir" init -q
93
+ git -C "$tmpdir" config user.email "test@example.com"
94
+ git -C "$tmpdir" config user.name "test"
95
+ git -C "$tmpdir" add package.json
96
+ git -C "$tmpdir" commit -q -m init
97
+ if [[ -n "$pre_tag" ]]; then
98
+ git -C "$tmpdir" tag "$pre_tag"
99
+ fi
100
+
101
+ (
102
+ cd "$tmpdir"
103
+ unset BRANCH_NAME GIT_BRANCH BUILD_NUMBER
104
+ for kv in "${envs[@]}"; do
105
+ export "$kv"
106
+ done
107
+ if [[ -n "$fake_npm_stderr" ]]; then
108
+ make_fake_npm "${tmpdir}/bin" "$fake_npm_stderr"
109
+ export PATH="${tmpdir}/bin:${PATH}"
110
+ elif [[ -n "$fake_npm_success_json" ]]; then
111
+ make_fake_npm_success "${tmpdir}/bin" "$fake_npm_success_json" "$fake_npm_noise"
112
+ export PATH="${tmpdir}/bin:${PATH}"
113
+ fi
114
+ "$RESOLVER" > /dev/null
115
+ )
116
+
117
+ local actual
118
+ actual="$(node -p "require('${tmpdir}/package.json').version")"
119
+ local name_after
120
+ name_after="$(node -p "require('${tmpdir}/package.json').name")"
121
+
122
+ if [[ "$actual" == "$expected" && "$name_after" == "@mulesoft/anypoint-cli-agent-fabric-plugin" ]]; then
123
+ echo " ok ${label}: version=${actual}"
124
+ pass=$((pass + 1))
125
+ else
126
+ echo " FAIL ${label}: expected version=${expected}, got version=${actual}, name=${name_after}" >&2
127
+ fail=$((fail + 1))
128
+ fi
129
+
130
+ rm -rf "$tmpdir"
131
+ trap - RETURN
132
+ }
133
+
134
+ # Asserts the resolver ABORTS (non-zero exit) instead of writing a version --
135
+ # used for the registry-failure-that-is-not-a-404 path, where publishing a
136
+ # silently-re-derived version would be worse than failing the build.
137
+ run_fail_case() {
138
+ local label="$1"; shift
139
+ local fake_npm_stderr="$1"; shift
140
+ # Remaining args are VAR=VALUE pairs to export for the resolver.
141
+
142
+ local tmpdir
143
+ tmpdir="$(mktemp -d)"
144
+ trap 'rm -rf "$tmpdir"' RETURN
145
+
146
+ cat > "${tmpdir}/package.json" <<'JSON'
147
+ {
148
+ "name": "@mulesoft/anypoint-cli-agent-fabric-plugin",
149
+ "version": "1.0.0",
150
+ "description": "agent-fabric plugin"
151
+ }
152
+ JSON
153
+ make_fake_npm "${tmpdir}/bin" "$fake_npm_stderr"
154
+
155
+ local rc=0
156
+ (
157
+ cd "$tmpdir"
158
+ unset BRANCH_NAME GIT_BRANCH BUILD_NUMBER RESOLVE_PUBLISHED_VERSIONS_JSON
159
+ for kv in "$@"; do
160
+ export "$kv"
161
+ done
162
+ export PATH="${tmpdir}/bin:${PATH}"
163
+ "$RESOLVER" > /dev/null 2>/dev/null
164
+ ) || rc=$?
165
+
166
+ if [[ "$rc" -ne 0 ]]; then
167
+ echo " ok ${label}: resolver aborted (exit ${rc}) as expected"
168
+ pass=$((pass + 1))
169
+ else
170
+ echo " FAIL ${label}: expected resolver to abort, but it exited 0" >&2
171
+ fail=$((fail + 1))
172
+ fi
173
+
174
+ rm -rf "$tmpdir"
175
+ trap - RETURN
176
+ }
177
+
178
+ echo "resolve-version.sh integration tests"
179
+
180
+ # master derives its patch from the published-versions list (injected offline),
181
+ # not from package.json's patch or BUILD_NUMBER.
182
+ VERS_10='["1.0.0","1.0.1-arroba-mulesoft-added.1","1.0.2-19.sfci-mig-plan-b-4","1.0.6-7.arroba-mulesoft-added","1.1.0"]'
183
+
184
+ run_case "master -> next patch above all 1.0.x" "1.0.7" "BRANCH_NAME=master" "RESOLVE_PUBLISHED_VERSIONS_JSON=${VERS_10}"
185
+ run_case "master -> 1.0.1 when only 1.0.0 clean" "1.0.1" "BRANCH_NAME=master" "RESOLVE_PUBLISHED_VERSIONS_JSON=[\"1.0.0\"]"
186
+ run_case "master -> 1.0.0 when none published" "1.0.0" "BRANCH_NAME=master" "RESOLVE_PUBLISHED_VERSIONS_JSON=[]"
187
+ run_case "master patch ignores BUILD_NUMBER" "1.0.7" "BRANCH_NAME=master" "BUILD_NUMBER=999" "RESOLVE_PUBLISHED_VERSIONS_JSON=${VERS_10}"
188
+
189
+ # Non-master production branches (test/*, develop, feature/*, release/*) get
190
+ # a pre-release with their OWN patch counter: starts at package.json's base
191
+ # patch (1.0.0 -> patch 0) when nothing is published for that branch yet,
192
+ # then increments per build of that same branch -- BUILD_NUMBER is ignored.
193
+ # The FULL branch path (every segment, not just the last) becomes the
194
+ # identifier, so different branch TYPES never share one prerelease lineage.
195
+ run_case "test/* branch -> starts at base patch" "1.0.0-test-sfci-mig-plan-b" "BRANCH_NAME=test/sfci-mig-plan-b" "BUILD_NUMBER=7" "RESOLVE_PUBLISHED_VERSIONS_JSON=[]"
196
+ run_case "test/* branch -> increments on 2nd build" "1.0.1-test-sfci-mig-plan-b" "BRANCH_NAME=test/sfci-mig-plan-b" "RESOLVE_PUBLISHED_VERSIONS_JSON=[\"1.0.0-test-sfci-mig-plan-b\"]"
197
+ run_case "test/* branch ignores BUILD_NUMBER" "1.0.0-test-sfci-mig-plan-b" "BRANCH_NAME=test/sfci-mig-plan-b" "BUILD_NUMBER=999" "RESOLVE_PUBLISHED_VERSIONS_JSON=[]"
198
+ run_case "other branch's counter does not interfere" "1.0.0-other-branch" "BRANCH_NAME=other-branch" "RESOLVE_PUBLISHED_VERSIONS_JSON=[\"1.0.5-test-sfci-mig-plan-b\"]"
199
+ run_case "origin/ prefix stripped (no other segment)" "1.0.0-my-branch" "BRANCH_NAME=origin/my-branch" "RESOLVE_PUBLISHED_VERSIONS_JSON=[]"
200
+ run_case "GIT_BRANCH fallback keeps its segment" "1.0.0-feature-x" "GIT_BRANCH=feature/x" "RESOLVE_PUBLISHED_VERSIONS_JSON=[]"
201
+
202
+ # release/* is just another production branch now (only master cuts a clean
203
+ # semver release) -> per-branch pre-release counter, same as test/*/feature/*.
204
+ run_case "release/ branch -> starts at base patch" "1.0.0-release-1.3" "BRANCH_NAME=release/1.3" "RESOLVE_PUBLISHED_VERSIONS_JSON=[]"
205
+ run_case "release/ branch -> increments on 2nd build" "1.0.1-release-1.3" "BRANCH_NAME=release/1.3" "RESOLVE_PUBLISHED_VERSIONS_JSON=[\"1.0.0-release-1.3\"]"
206
+ run_case "release/ origin prefix stripped" "1.0.0-release-1.3" "BRANCH_NAME=origin/release/1.3" "RESOLVE_PUBLISHED_VERSIONS_JSON=[]"
207
+
208
+ # Regression coverage for the production collision this fix corrects: before
209
+ # it, release/1.2.25-2 and test/1.2.25-2 (and a nested test/release/1-2-25-2)
210
+ # all published the SAME version (1.2.25-1-2-25-2), because only the last
211
+ # path segment was kept. Each branch TYPE now gets a distinct lineage. Dots
212
+ # inside a segment are kept literally (not collapsed to dashes) -- only the
213
+ # `/` path separator becomes `-`.
214
+ run_case "release/1.2.25-2 keeps the release- type prefix and its dots" "1.2.25-release-1.2.25-2" "BRANCH_NAME=release/1.2.25-2" "PKG_VERSION=1.2.25" "RESOLVE_PUBLISHED_VERSIONS_JSON=[]"
215
+ run_case "release/1.2.25-2 2nd build increments its own lineage" "1.2.26-release-1.2.25-2" "BRANCH_NAME=release/1.2.25-2" "PKG_VERSION=1.2.25" "RESOLVE_PUBLISHED_VERSIONS_JSON=[\"1.2.25-release-1.2.25-2\"]"
216
+ run_case "test/1.2.25-2 gets a DIFFERENT lineage than release/" "1.2.25-test-1.2.25-2" "BRANCH_NAME=test/1.2.25-2" "PKG_VERSION=1.2.25" "RESOLVE_PUBLISHED_VERSIONS_JSON=[\"1.2.25-release-1.2.25-2\"]"
217
+ run_case "test/1.2.25-2 2nd build increments its own lineage" "1.2.26-test-1.2.25-2" "BRANCH_NAME=test/1.2.25-2" "PKG_VERSION=1.2.25" "RESOLVE_PUBLISHED_VERSIONS_JSON=[\"1.2.25-test-1.2.25-2\"]"
218
+ run_case "nested test/release/1-2-25-2 keeps both segments" "1.2.25-test-release-1-2-25-2" "BRANCH_NAME=test/release/1-2-25-2" "PKG_VERSION=1.2.25" "RESOLVE_PUBLISHED_VERSIONS_JSON=[]"
219
+
220
+ # Regression coverage for the SECOND production bug: release/1.2.25-hf ran
221
+ # two builds 28 minutes apart and published the exact same version both
222
+ # times. Build 2's own log proved the git tag from build 1 was already
223
+ # present ("could not create tag, already exists") -- npm view alone (via
224
+ # RESOLVE_PUBLISHED_VERSIONS_JSON=[] here, simulating the Nexus-proxy lag
225
+ # that made it blind to a version published minutes earlier) is no longer
226
+ # the only signal: a pre-existing git tag for that exact version must still
227
+ # push the counter forward instead of colliding with it.
228
+ run_case "pre-existing git tag advances the counter past a stale npm view" "1.2.26-release-1.2.25-hf" "BRANCH_NAME=release/1.2.25-hf" "PKG_VERSION=1.2.25" "RESOLVE_PUBLISHED_VERSIONS_JSON=[]" "PRE_TAG=1.2.25-release-1.2.25-hf"
229
+
230
+ # The per-branch counter starts at package.json's OWN current patch, which
231
+ # is only meaningfully exercised at a non-zero patch (every case above uses
232
+ # fixture version 1.0.0, so the floor is always 0) -- matches production,
233
+ # which is already at 1.2.25.
234
+ run_case "branch counter starts at package.json's non-zero patch" "1.2.25-test-develop" "BRANCH_NAME=test/develop" "PKG_VERSION=1.2.25" "RESOLVE_PUBLISHED_VERSIONS_JSON=[]"
235
+ run_case "branch counter increments above non-zero base" "1.2.26-test-develop" "BRANCH_NAME=test/develop" "PKG_VERSION=1.2.25" "RESOLVE_PUBLISHED_VERSIONS_JSON=[\"1.2.25-test-develop\"]"
236
+
237
+ # Legacy pre-migration versions (MAJOR.MINOR.PATCH-BRANCH.BUILD, published by
238
+ # the old BUILD_NUMBER scheme) must still count toward the branch's max patch
239
+ # -- otherwise the first post-migration build of a long-lived branch resets
240
+ # to the floor, which is a semver REGRESSION relative to the legacy tag
241
+ # (fewer pre-release fields = lower precedence at equal PATCH).
242
+ run_case "legacy .BUILD-suffixed version still counts toward max" "1.2.26-test-develop" "BRANCH_NAME=test/develop" "PKG_VERSION=1.2.25" "RESOLVE_PUBLISHED_VERSIONS_JSON=[\"1.2.25-test-develop.1\"]"
243
+ run_case "legacy + new-format versions: max wins across both" "1.2.28-test-develop" "BRANCH_NAME=test/develop" "PKG_VERSION=1.2.25" "RESOLVE_PUBLISHED_VERSIONS_JSON=[\"1.2.25-test-develop.1\",\"1.2.27-test-develop\"]"
244
+
245
+ # A branch name that normalizes to pure digits with no other path segment
246
+ # (e.g. a bare branch called `007`, no slash) would be an invalid semver
247
+ # identifier (numeric identifiers can't have a leading zero, and a bare
248
+ # numeric tail is easy to misread as a version) -- it must come out
249
+ # alphanumeric. A prefixed branch like release/1.3 is unaffected: it already
250
+ # contains the "release" segment, so it was never purely numeric.
251
+ run_case "bare numeric branch (leading zero) gets a non-numeric prefix" "1.0.0-b007" "BRANCH_NAME=007" "RESOLVE_PUBLISHED_VERSIONS_JSON=[]"
252
+ run_case "bare numeric branch (no leading zero) still gets prefixed" "1.0.0-b42" "BRANCH_NAME=42" "RESOLVE_PUBLISHED_VERSIONS_JSON=[]"
253
+
254
+ # A registry error that ISN'T a 404 (network/auth/outage) must abort the
255
+ # build rather than being treated as "nothing published yet" -- silently
256
+ # re-deriving the floor version when one is already published would fail
257
+ # npm-publish on a duplicate, or worse, look like a fresh build that isn't.
258
+ run_fail_case "npm view non-404 failure aborts the build" "npm ERR! network timeout ECONNRESET" "BRANCH_NAME=test/develop" "PKG_VERSION=1.2.25"
259
+
260
+ # A genuine 404 (brand-new/unpublished package) IS treated as "nothing
261
+ # published yet" -- this is the legitimate empty case the fallback exists for.
262
+ run_case "npm view 404 (new package) is treated as empty" "1.2.25-test-develop" "BRANCH_NAME=test/develop" "PKG_VERSION=1.2.25" "FAKE_NPM_STDERR=npm ERR! 404 Not Found - GET https://registry/@mulesoft%2fanypoint-cli-agent-fabric-plugin - Not found E404"
263
+
264
+ # Regression coverage for the THIRD production bug: real npm (confirmed
265
+ # npm@10.8.3) writes an informational banner ("npm info using npm@10.8.3")
266
+ # to stderr on every call, success or not. published_versions() used to
267
+ # merge stdout+stderr via `2>&1`, so that banner got prepended to the JSON
268
+ # payload on the SUCCESS path too, corrupting JSON.parse and hard-failing
269
+ # EVERY branch build (confirmed: test/W-23849126-3-sfci-version's Package
270
+ # stage failed with exactly this SyntaxError). stdout and stderr must stay
271
+ # separate: a successful call's noisy stderr must never affect its result.
272
+ run_case "npm view success + stderr noise doesn't corrupt the JSON payload" "1.2.26-test-develop" "BRANCH_NAME=test/develop" "PKG_VERSION=1.2.25" "FAKE_NPM_SUCCESS_JSON=[\"1.2.25-test-develop\"]" "FAKE_NPM_NOISE=npm info using npm@10.8.3"
273
+
274
+ if [[ "$fail" -gt 0 ]]; then
275
+ echo "resolve-version.sh: ${pass} passed, ${fail} failed" >&2
276
+ exit 1
277
+ fi
278
+ echo "resolve-version.sh: ${pass} passed"
@@ -0,0 +1,130 @@
1
+ #!/usr/bin/env bash
2
+ #
3
+ # Verifies the transformations that .github/workflows/publish-npm-package.yml performs
4
+ # on package.json (name, version) and the dist-tag it derives from the manually
5
+ # entered version — replayed locally against a seeded fixture.
6
+ #
7
+ # WHY: the workflow only runs on GitHub Actions and can only be validated
8
+ # end-to-end by dispatching it. This script mirrors the exact bash/node blocks
9
+ # from the workflow steps and asserts the transformed output, so drift between
10
+ # repo state and the intended public-publish payload is caught before dispatch.
11
+ #
12
+ # Usage: bash scripts/test-publish-npm.sh
13
+
14
+ set -euo pipefail
15
+
16
+ REPO_ROOT="$(cd "$(dirname "$0")/.." && pwd)"
17
+ WORKFLOW_FILE="$REPO_ROOT/.github/workflows/publish-npm-package.yml"
18
+ PUBLIC_NAME="mulesoft-anypoint-cli-agent-fabric-plugin"
19
+
20
+ if [[ ! -f "$WORKFLOW_FILE" ]]; then
21
+ echo "FAIL: workflow file not found at $WORKFLOW_FILE" >&2
22
+ exit 1
23
+ fi
24
+
25
+ pass=0
26
+ fail=0
27
+
28
+ assert_eq() {
29
+ local label="$1" actual="$2" expected="$3"
30
+ if [[ "$actual" == "$expected" ]]; then
31
+ echo " ✅ $label = $actual"
32
+ pass=$((pass+1))
33
+ else
34
+ echo " ❌ $label expected=$expected actual=$actual"
35
+ fail=$((fail+1))
36
+ fi
37
+ }
38
+
39
+ # Applies the workflow's "Set version from input" + "Rename package for public
40
+ # publish" + "Determine publish tag" steps to a temp package.json copy.
41
+ run_case() {
42
+ local title="$1"
43
+ local initial_name="$2"
44
+ local initial_version="$3"
45
+ local user_input_version="$4"
46
+ local expected_final_version="$5"
47
+ local expected_dist_tag="$6"
48
+
49
+ echo ""
50
+ echo "── Case: $title"
51
+ echo " initial : ${initial_name}@${initial_version}"
52
+ echo " user input: ${user_input_version}"
53
+
54
+ local case_dir
55
+ case_dir="$(mktemp -d)"
56
+ trap 'rm -rf "$case_dir"' RETURN
57
+
58
+ node -e '
59
+ const fs = require("fs");
60
+ const pkg = {name: process.argv[1], version: process.argv[2]};
61
+ fs.writeFileSync("package.json", JSON.stringify(pkg, null, 2) + "\n");
62
+ ' "$initial_name" "$initial_version" >/dev/null
63
+
64
+ ( cd "$case_dir" && cp - package.json <<< "$(cat "$case_dir/package.json" 2>/dev/null || true)" ) >/dev/null 2>&1 || true
65
+
66
+ pushd "$case_dir" >/dev/null
67
+
68
+ node -e '
69
+ const fs = require("fs");
70
+ const pkg = {name: process.argv[1], version: process.argv[2]};
71
+ fs.writeFileSync("package.json", JSON.stringify(pkg, null, 2) + "\n");
72
+ ' "$initial_name" "$initial_version" >/dev/null
73
+
74
+ VERSION_INPUT="$user_input_version" \
75
+ npm version "$user_input_version" --no-git-tag-version --allow-same-version >/dev/null
76
+
77
+ PUBLIC_NAME="$PUBLIC_NAME" node -e '
78
+ const fs = require("fs");
79
+ const pkg = JSON.parse(fs.readFileSync("package.json", "utf8"));
80
+ pkg.name = process.env.PUBLIC_NAME;
81
+ fs.writeFileSync("package.json", JSON.stringify(pkg, null, 2) + "\n");
82
+ '
83
+
84
+ local final_name final_version dist_tag
85
+ final_name="$(node -p "require('./package.json').name")"
86
+ final_version="$(node -p "require('./package.json').version")"
87
+
88
+ if echo "$final_version" | grep -qE '(alpha|beta|rc|next|dev)'; then
89
+ dist_tag="$(echo "$final_version" | sed -E 's/.*-(alpha|beta|rc|next|dev).*/\1/')"
90
+ else
91
+ dist_tag="latest"
92
+ fi
93
+
94
+ assert_eq "final .name " "$final_name" "$PUBLIC_NAME"
95
+ assert_eq "final .version " "$final_version" "$expected_final_version"
96
+ assert_eq "resolved dist-tag " "$dist_tag" "$expected_dist_tag"
97
+ echo " → publishes: ${final_name}@${final_version} (npm tag: ${dist_tag})"
98
+ echo " → tarball : ${final_name}-${final_version}.tgz"
99
+
100
+ popd >/dev/null
101
+ rm -rf "$case_dir"
102
+ trap - RETURN
103
+ }
104
+
105
+ echo "=========================================================="
106
+ echo "publish-npm-package.yml transformation test"
107
+ echo "=========================================================="
108
+
109
+ # Case 1: Maria's fixture — internal Nexus tarball
110
+ # @mulesoft/anypoint-cli-agent-fabric-plugin-1.0.0-sfci-mig-plan-b-1.2.tgz
111
+ # ⇒ manual public version 1.2.0
112
+ run_case "manual release 1.2.0 (from internal 1.0.0-sfci-mig-plan-b prerelease)" \
113
+ "@mulesoft/anypoint-cli-agent-fabric-plugin" "1.0.0" "1.2.0" "1.2.0" "latest"
114
+
115
+ # Case 2: manual beta
116
+ run_case "manual prerelease 1.3.0-beta.1" \
117
+ "@mulesoft/anypoint-cli-agent-fabric-plugin" "1.0.0" "1.3.0-beta.1" "1.3.0-beta.1" "beta"
118
+
119
+ # Case 3: manual rc
120
+ run_case "manual prerelease 1.3.0-rc.2" \
121
+ "@mulesoft/anypoint-cli-agent-fabric-plugin" "1.0.0" "1.3.0-rc.2" "1.3.0-rc.2" "rc"
122
+
123
+ echo ""
124
+ echo "=========================================================="
125
+ echo "Result: $pass passed, $fail failed"
126
+ echo "=========================================================="
127
+
128
+ if (( fail > 0 )); then
129
+ exit 1
130
+ fi
@@ -11,6 +11,7 @@
11
11
  "version": "{{assetVersion}}",
12
12
  "dependencies": [],
13
13
  "metadata": {
14
+ "toolingVersion": 1,
14
15
  "variables": {
15
16
  "agent1": {
16
17
  "url": {
@@ -3,7 +3,7 @@ system:
3
3
  instructions: "You are a helpful assistant."
4
4
 
5
5
  config:
6
- agent_name: "My Broker 1"
6
+ agent_name: "{{brokerName}}"
7
7
  default_llm: @llm.openai_llm
8
8
 
9
9
  llm:
@@ -27,7 +27,7 @@ actions:
27
27
 
28
28
  trigger brokerTrigger:
29
29
  kind: "a2a"
30
- target: "brokers://broker1/a2a"
30
+ target: "brokers://{{brokerId}}/a2a"
31
31
  on_message: ->
32
32
  transition to @orchestrator.main
33
33
 
@@ -11,6 +11,7 @@
11
11
  "version": "{{assetVersion}}",
12
12
  "dependencies": [],
13
13
  "metadata": {
14
+ "toolingVersion": 1,
14
15
  "variables": {
15
16
  "myAgent": {
16
17
  "url": {