mulesoft-anypoint-cli-agent-fabric-plugin 1.4.0 → 1.6.0
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.
- package/GETTING_STARTED.md +396 -0
- package/README.md +61 -23
- package/TROUBLESHOOTING.md +468 -0
- package/dist/commands/agent-network/project/agent-console.d.ts +3 -2
- package/dist/commands/agent-network/project/agent-console.js +3 -1
- package/dist/commands/agent-network/project/agent-console.js.map +1 -1
- package/dist/commands/agent-network/project/broker/create.d.ts +3 -2
- package/dist/commands/agent-network/project/broker/create.js +3 -1
- package/dist/commands/agent-network/project/broker/create.js.map +1 -1
- package/dist/commands/agent-network/project/build.d.ts +4 -3
- package/dist/commands/agent-network/project/build.js +13 -8
- package/dist/commands/agent-network/project/build.js.map +1 -1
- package/dist/commands/agent-network/project/create.d.ts +11 -6
- package/dist/commands/agent-network/project/create.js +52 -16
- package/dist/commands/agent-network/project/create.js.map +1 -1
- package/dist/commands/agent-network/project/deploy.d.ts +4 -2
- package/dist/commands/agent-network/project/deploy.js +45 -26
- package/dist/commands/agent-network/project/deploy.js.map +1 -1
- package/dist/commands/agent-network/project/export-logs.d.ts +3 -2
- package/dist/commands/agent-network/project/export-logs.js +3 -2
- package/dist/commands/agent-network/project/export-logs.js.map +1 -1
- package/dist/commands/agent-network/project/mcp/introspect.d.ts +7 -3
- package/dist/commands/agent-network/project/mcp/introspect.js +14 -9
- package/dist/commands/agent-network/project/mcp/introspect.js.map +1 -1
- package/dist/commands/agent-network/project/publish.d.ts +3 -4
- package/dist/commands/agent-network/project/publish.js +11 -14
- package/dist/commands/agent-network/project/publish.js.map +1 -1
- package/dist/commands/agent-network/project/run-local.d.ts +14 -2
- package/dist/commands/agent-network/project/run-local.js +339 -60
- package/dist/commands/agent-network/project/run-local.js.map +1 -1
- package/dist/commands/agent-network/project/secrets.d.ts +3 -2
- package/dist/commands/agent-network/project/secrets.js +3 -1
- package/dist/commands/agent-network/project/secrets.js.map +1 -1
- package/dist/commands/agent-network/project/stop-local.d.ts +3 -2
- package/dist/commands/agent-network/project/stop-local.js +3 -2
- package/dist/commands/agent-network/project/stop-local.js.map +1 -1
- package/dist/commands/agent-network/project/undeploy.d.ts +3 -2
- package/dist/commands/agent-network/project/undeploy.js +19 -12
- package/dist/commands/agent-network/project/undeploy.js.map +1 -1
- package/dist/commands/agent-network/project/unpublish.d.ts +3 -2
- package/dist/commands/agent-network/project/unpublish.js +26 -19
- package/dist/commands/agent-network/project/unpublish.js.map +1 -1
- package/dist/commands/agent-network/setup/dependencies.d.ts +4 -3
- package/dist/commands/agent-network/setup/dependencies.js +7 -4
- package/dist/commands/agent-network/setup/dependencies.js.map +1 -1
- package/dist/commands/agent-network/setup/gateways.d.ts +3 -2
- package/dist/commands/agent-network/setup/gateways.js +3 -3
- package/dist/commands/agent-network/setup/gateways.js.map +1 -1
- package/dist/errors/base-error.d.ts +6 -0
- package/dist/errors/base-error.js +49 -20
- package/dist/errors/base-error.js.map +1 -1
- package/dist/errors/error-factory.d.ts +62 -4
- package/dist/errors/error-factory.js +341 -13
- package/dist/errors/error-factory.js.map +1 -1
- package/dist/helpers/connection.d.ts +6 -2
- package/dist/helpers/connection.js +13 -6
- package/dist/helpers/connection.js.map +1 -1
- package/dist/helpers/dependency-manager.d.ts +14 -5
- package/dist/helpers/dependency-manager.js +185 -51
- package/dist/helpers/dependency-manager.js.map +1 -1
- package/dist/helpers/policy-helper.js +256 -26
- package/dist/helpers/policy-helper.js.map +1 -1
- package/dist/helpers/project/constants.d.ts +1 -1
- package/dist/helpers/proxy-agent.d.ts +2 -0
- package/dist/helpers/proxy-agent.js +26 -0
- package/dist/helpers/proxy-agent.js.map +1 -0
- package/dist/helpers/proxy-fetch.d.ts +5 -0
- package/dist/helpers/proxy-fetch.js +102 -0
- package/dist/helpers/proxy-fetch.js.map +1 -0
- package/dist/helpers/request-logging.d.ts +4 -0
- package/dist/helpers/request-logging.js +96 -2
- package/dist/helpers/request-logging.js.map +1 -1
- package/dist/helpers/types.d.ts +5 -0
- package/dist/helpers/utils.d.ts +1 -0
- package/dist/helpers/utils.js +16 -1
- package/dist/helpers/utils.js.map +1 -1
- package/dist/hooks/init/check-node-version.d.ts +6 -0
- package/dist/hooks/init/check-node-version.js +34 -0
- package/dist/hooks/init/check-node-version.js.map +1 -0
- package/dist/resources/runtime-dependencies.json +5 -1
- package/dist/resources/schemas/broker-deployment-settings.schema.json +4 -0
- package/dist/resources/schemas/runtime-dependencies-schema.json +21 -0
- package/dist/types/agent-network-v2.d.ts +55 -9
- package/dist/types/agent-network-v2.js.map +1 -1
- package/dist/types/agent-network.d.ts +0 -4
- package/dist/types/agent-network.js.map +1 -1
- package/dist/types/types.d.ts +25 -3
- package/dist/utils/agent-fabric-commands.d.ts +24 -0
- package/dist/utils/agent-fabric-commands.js +39 -0
- package/dist/utils/agent-fabric-commands.js.map +1 -0
- package/dist/utils/builders/builder.d.ts +2 -0
- package/dist/utils/builders/builder.js +22 -1
- package/dist/utils/builders/builder.js.map +1 -1
- package/dist/utils/builders/common/connection-facet-helpers.d.ts +2 -0
- package/dist/utils/builders/common/connection-facet-helpers.js +4 -1
- package/dist/utils/builders/common/connection-facet-helpers.js.map +1 -1
- package/dist/utils/builders/common/network-builder-helpers.d.ts +5 -0
- package/dist/utils/builders/common/network-builder-helpers.js +8 -0
- package/dist/utils/builders/common/network-builder-helpers.js.map +1 -1
- package/dist/utils/builders/common/network-metadata.js +1 -1
- package/dist/utils/builders/common/network-metadata.js.map +1 -1
- package/dist/utils/builders/common/types.d.ts +1 -1
- package/dist/utils/builders/local-space-resolver.d.ts +13 -3
- package/dist/utils/builders/local-space-resolver.js +16 -3
- package/dist/utils/builders/local-space-resolver.js.map +1 -1
- package/dist/utils/builders/policies-factory.d.ts +6 -2
- package/dist/utils/builders/policies-factory.js +106 -8
- package/dist/utils/builders/policies-factory.js.map +1 -1
- package/dist/utils/builders/project-builder-impl.d.ts +20 -1
- package/dist/utils/builders/project-builder-impl.js +40 -4
- package/dist/utils/builders/project-builder-impl.js.map +1 -1
- package/dist/utils/builders/project-builder.d.ts +18 -3
- package/dist/utils/builders/project-builder.js +4 -2
- package/dist/utils/builders/project-builder.js.map +1 -1
- package/dist/utils/builders/remote-space-resolver.d.ts +3 -3
- package/dist/utils/builders/remote-space-resolver.js +47 -32
- package/dist/utils/builders/remote-space-resolver.js.map +1 -1
- package/dist/utils/builders/space-serializer.d.ts +2 -0
- package/dist/utils/builders/space-serializer.js +12 -2
- package/dist/utils/builders/space-serializer.js.map +1 -1
- package/dist/utils/builders/v1/broker-builder.d.ts +1 -0
- package/dist/utils/builders/v1/broker-builder.js +45 -9
- package/dist/utils/builders/v1/broker-builder.js.map +1 -1
- package/dist/utils/builders/v1/connections-builder.js +3 -0
- package/dist/utils/builders/v1/connections-builder.js.map +1 -1
- package/dist/utils/builders/v1/network-builder.js +22 -4
- package/dist/utils/builders/v1/network-builder.js.map +1 -1
- package/dist/utils/builders/v2/broker-builder.js +1 -1
- package/dist/utils/builders/v2/broker-builder.js.map +1 -1
- package/dist/utils/builders/v2/connection-interfaces.d.ts +5 -0
- package/dist/utils/builders/v2/connection-interfaces.js +68 -0
- package/dist/utils/builders/v2/connection-interfaces.js.map +1 -0
- package/dist/utils/builders/v2/connections-builder.d.ts +5 -1
- package/dist/utils/builders/v2/connections-builder.js +120 -20
- package/dist/utils/builders/v2/connections-builder.js.map +1 -1
- package/dist/utils/builders/v2/llm-builder.js +17 -6
- package/dist/utils/builders/v2/llm-builder.js.map +1 -1
- package/dist/utils/builders/v2/network-builder.js +10 -1
- package/dist/utils/builders/v2/network-builder.js.map +1 -1
- package/dist/utils/constants.d.ts +22 -1
- package/dist/utils/constants.js +26 -4
- package/dist/utils/constants.js.map +1 -1
- package/dist/utils/deployment-settings.d.ts +1 -0
- package/dist/utils/deployment-settings.js.map +1 -1
- package/dist/utils/dry-run/dry-run-render.d.ts +1 -0
- package/dist/utils/dry-run/dry-run-render.js +23 -13
- package/dist/utils/dry-run/dry-run-render.js.map +1 -1
- package/dist/utils/exchange.d.ts +1 -0
- package/dist/utils/exchange.js +20 -0
- package/dist/utils/exchange.js.map +1 -1
- package/dist/utils/facets/agent-graph-facet.d.ts +1 -1
- package/dist/utils/facets/agent-graph-facet.js +10 -9
- package/dist/utils/facets/agent-graph-facet.js.map +1 -1
- package/dist/utils/facets/api-instance-facet.d.ts +2 -0
- package/dist/utils/facets/api-instance-facet.js +75 -19
- package/dist/utils/facets/api-instance-facet.js.map +1 -1
- package/dist/utils/facets/apim-policy-helpers.d.ts +29 -2
- package/dist/utils/facets/apim-policy-helpers.js +19 -5
- package/dist/utils/facets/apim-policy-helpers.js.map +1 -1
- package/dist/utils/facets/asset-facet.d.ts +2 -0
- package/dist/utils/facets/asset-facet.js +75 -40
- package/dist/utils/facets/asset-facet.js.map +1 -1
- package/dist/utils/facets/connection-facet.d.ts +6 -0
- package/dist/utils/facets/connection-facet.js +202 -22
- package/dist/utils/facets/connection-facet.js.map +1 -1
- package/dist/utils/facets/deployment-helpers.d.ts +2 -1
- package/dist/utils/facets/deployment-helpers.js +28 -21
- package/dist/utils/facets/deployment-helpers.js.map +1 -1
- package/dist/utils/facets/deployment-runner.js +88 -6
- package/dist/utils/facets/deployment-runner.js.map +1 -1
- package/dist/utils/facets/facets.d.ts +6 -0
- package/dist/utils/facets/facets.js +56 -9
- package/dist/utils/facets/facets.js.map +1 -1
- package/dist/utils/facets/mule-application-facet.js +2 -2
- package/dist/utils/facets/mule-application-facet.js.map +1 -1
- package/dist/utils/facets/publication-metadata-patcher.d.ts +7 -1
- package/dist/utils/facets/publication-metadata-patcher.js +32 -17
- package/dist/utils/facets/publication-metadata-patcher.js.map +1 -1
- package/dist/utils/facets/secret-manager-client.d.ts +29 -0
- package/dist/utils/facets/secret-manager-client.js +172 -0
- package/dist/utils/facets/secret-manager-client.js.map +1 -0
- package/dist/utils/facets/secret-ref-validator.d.ts +11 -0
- package/dist/utils/facets/secret-ref-validator.js +80 -0
- package/dist/utils/facets/secret-ref-validator.js.map +1 -0
- package/dist/utils/facets/secret-tls-validator.d.ts +6 -0
- package/dist/utils/facets/secret-tls-validator.js +59 -0
- package/dist/utils/facets/secret-tls-validator.js.map +1 -0
- package/dist/utils/gateway.d.ts +3 -0
- package/dist/utils/gateway.js +70 -1
- package/dist/utils/gateway.js.map +1 -1
- package/dist/utils/logger.js +1 -1
- package/dist/utils/logger.js.map +1 -1
- package/dist/utils/maven-proxy.d.ts +10 -0
- package/dist/utils/maven-proxy.js +118 -0
- package/dist/utils/maven-proxy.js.map +1 -0
- package/dist/utils/registry/registry-errors.d.ts +4 -0
- package/dist/utils/registry/registry-errors.js +36 -0
- package/dist/utils/registry/registry-errors.js.map +1 -0
- package/dist/utils/registry/registry-response.d.ts +46 -0
- package/dist/utils/registry/registry-response.js +264 -0
- package/dist/utils/registry/registry-response.js.map +1 -0
- package/dist/utils/request-executor.d.ts +9 -1
- package/dist/utils/request-executor.js +6 -3
- package/dist/utils/request-executor.js.map +1 -1
- package/dist/utils/run-local/build-status.js +4 -2
- package/dist/utils/run-local/build-status.js.map +1 -1
- package/dist/utils/run-local/index.d.ts +1 -1
- package/dist/utils/run-local/index.js +2 -1
- package/dist/utils/run-local/index.js.map +1 -1
- package/dist/utils/run-local/local-a2a-upstream.d.ts +1 -0
- package/dist/utils/run-local/local-a2a-upstream.js +5 -4
- package/dist/utils/run-local/local-a2a-upstream.js.map +1 -1
- package/dist/utils/run-local/local-tls-model.d.ts +18 -0
- package/dist/utils/run-local/local-tls-model.js +97 -0
- package/dist/utils/run-local/local-tls-model.js.map +1 -0
- package/dist/utils/run-local/local-tls.d.ts +37 -0
- package/dist/utils/run-local/local-tls.js +245 -0
- package/dist/utils/run-local/local-tls.js.map +1 -0
- package/dist/utils/run-local/policy-resolver.js +5 -0
- package/dist/utils/run-local/policy-resolver.js.map +1 -1
- package/dist/utils/run-local/runtime-environment-manager.d.ts +23 -2
- package/dist/utils/run-local/runtime-environment-manager.js +236 -6
- package/dist/utils/run-local/runtime-environment-manager.js.map +1 -1
- package/dist/utils/run-local/secrets-manager.d.ts +1 -0
- package/dist/utils/run-local/secrets-manager.js +2 -1
- package/dist/utils/run-local/secrets-manager.js.map +1 -1
- package/dist/utils/sanitize.d.ts +3 -0
- package/dist/utils/sanitize.js +45 -0
- package/dist/utils/sanitize.js.map +1 -0
- package/dist/utils/variables.d.ts +28 -6
- package/dist/utils/variables.js +114 -14
- package/dist/utils/variables.js.map +1 -1
- package/package.json +12 -10
- package/scripts/extract-error-catalog.js +88 -0
- package/templates/agentic-network/agent-network.yaml.template +1 -7
- package/templates/agentic-network/brokers/broker1.agent.template +1 -1
- package/templates/agentic-network/exchange.json.template +9 -1
|
@@ -0,0 +1,468 @@
|
|
|
1
|
+
# Troubleshooting
|
|
2
|
+
|
|
3
|
+
This guide helps you diagnose and resolve errors from the Anypoint CLI Agent Fabric plugin. It has two parts:
|
|
4
|
+
|
|
5
|
+
- **[Part A — CLI error-code reference](#part-a--cli-error-code-reference):** every error code the CLI can raise, what triggers it, and how to fix it.
|
|
6
|
+
- **[Part B — Dependent services: status codes and common issues](#part-b--dependent-services-status-codes-and-common-issues):** the platform services the CLI calls (Exchange, API Manager, Runtime Fabric, Gateway Manager, Access Management), the HTTP failures they return, and what to do about them.
|
|
7
|
+
|
|
8
|
+
> This reference reflects the CLI's error codes as of the latest release. If you see a code that isn't listed here, update to the latest CLI version and check again; if it's still missing, open a support case.
|
|
9
|
+
|
|
10
|
+
## How to read a CLI error
|
|
11
|
+
|
|
12
|
+
When a command fails, the CLI prints a structured JSON payload to `stderr`. For example:
|
|
13
|
+
|
|
14
|
+
```json
|
|
15
|
+
{
|
|
16
|
+
"errorCode": 3001,
|
|
17
|
+
"errorMessage": "Error while trying to create 'my-agent' in API Manager. Please, check in the Platform if the API 'my-agent' already exists.",
|
|
18
|
+
"requestId": "a1b2c3d4-0000-4444-8888-abcdef123456",
|
|
19
|
+
"steps": ["✅ resolveAssets", "❌ createApiInstance"],
|
|
20
|
+
"referenceTo": { "url": "https://anypoint.mulesoft.com/..." },
|
|
21
|
+
"cause": {
|
|
22
|
+
"message": "Request failed with status code 409",
|
|
23
|
+
"request": { "url": "https://.../apimanager/api/v1/organizations/.../apis", "method": "post" },
|
|
24
|
+
"response": { "status": "409 : 'Conflict'" },
|
|
25
|
+
"data": { "..." : "..." }
|
|
26
|
+
}
|
|
27
|
+
}
|
|
28
|
+
```
|
|
29
|
+
|
|
30
|
+
Use the fields as follows:
|
|
31
|
+
|
|
32
|
+
| Field | What it tells you | Where to look |
|
|
33
|
+
| --- | --- | --- |
|
|
34
|
+
| `errorCode` | The CLI error class. | [Part A](#part-a--cli-error-code-reference) — find the row for this code. |
|
|
35
|
+
| `errorMessage` | The human-readable summary, with your values interpolated. | Read it first; it usually names the resource involved. |
|
|
36
|
+
| `cause.response.status` | The HTTP status the downstream service returned (format `"<code> : '<statusText>'"`). | [Part B](#part-b--dependent-services-status-codes-and-common-issues) — match the service and status. |
|
|
37
|
+
| `cause.request.url` / `method` | Which service and endpoint failed. | Identifies the dependent service in Part B. |
|
|
38
|
+
| `requestId` | Correlation ID for the failed request. | Include it when you open a support case. |
|
|
39
|
+
| `steps` | Which stages completed (✅) and which failed (❌). | Shows how far a multi-step command got. |
|
|
40
|
+
|
|
41
|
+
Some errors are **pass-through errors**: the top-level `errorMessage` is generic, and the specific cause is nested in the `cause` field. For those (for example codes `2010`, `3030`, `9001`), read the `cause` block and then consult Part B for the underlying service failure.
|
|
42
|
+
|
|
43
|
+
### Using an internal Nexus mirror
|
|
44
|
+
|
|
45
|
+
Set `ANYPOINT_AGENT_FABRIC_REPOSITORY_URL` to the base URL of your mirror before running `agent-network project build`:
|
|
46
|
+
|
|
47
|
+
```
|
|
48
|
+
export ANYPOINT_AGENT_FABRIC_REPOSITORY_URL=https://nexus.example.com/repository
|
|
49
|
+
```
|
|
50
|
+
|
|
51
|
+
- The URL is the parent of a repository named `releases`, not the repository itself. The plugin requests `<url>/releases/com/mulesoft/agents/agent-fabric-transformation/<version>/agent-fabric-transformation-<version>.jar`. If your proxy repository has a different name (for example `maven-proxy`), expose it under the name `releases` below that base (a repository or a group), otherwise the download fails with error 6001.
|
|
52
|
+
- The URL must be `https://` (error 6007 otherwise). Redirects to `http://` are refused.
|
|
53
|
+
- The downloaded `agent-fabric-transformation` JAR must match the SHA-256 shipped with the plugin (error 6009 otherwise), so the mirror has to serve the exact published artifact.
|
|
54
|
+
- A response that is not a JAR, typically an HTML login or block page from a proxy, fails with error 6008.
|
|
55
|
+
- When the plugin is upgraded to a release that pins a different JAR version, the next `build` downloads it once and refreshes the cache.
|
|
56
|
+
|
|
57
|
+
---
|
|
58
|
+
|
|
59
|
+
## Part A — CLI error-code reference
|
|
60
|
+
|
|
61
|
+
Error codes are grouped into bands by area:
|
|
62
|
+
|
|
63
|
+
| Band | Area | Jump to |
|
|
64
|
+
| --- | --- | --- |
|
|
65
|
+
| 1000–1999 | Build (project, schema, AgentScript, MCP (Model Context Protocol) introspection) | [Build errors](#build-errors-10001999) |
|
|
66
|
+
| 2000–2999 | Publish / unpublish | [Publish errors](#publish-errors-20002999) |
|
|
67
|
+
| 3000–3999 | Deploy / undeploy | [Deploy errors](#deploy-errors-30003999) |
|
|
68
|
+
| 4000–4999 | Gateway setup | [Gateway setup errors](#gateway-setup-errors-40004999) |
|
|
69
|
+
| 5000–5999 | Entitlement / organization access | [Entitlement errors](#entitlement-and-organization-access-errors-50005999) |
|
|
70
|
+
| 6000–6999 | Dependency manager | [Dependency manager errors](#dependency-manager-errors-60006999) |
|
|
71
|
+
| 7000–7999 | Create command | [Create command errors](#create-command-errors-70007999) |
|
|
72
|
+
| 8001–8004 | Policy validation | [Policy validation errors](#policy-validation-errors-80018004) |
|
|
73
|
+
| 8500–8550 | Local run (`run-local`) | [Local run errors](#local-run-errors-85008550) |
|
|
74
|
+
| 9001 | Generic (uncategorized) | [Generic errors](#generic-errors-9001) |
|
|
75
|
+
| 10001 | Access management | [Access management errors](#access-management-errors-10001) |
|
|
76
|
+
| 11001–11005 | Gateway flags / CLI arguments | [Gateway flag errors](#gateway-flag-and-cli-argument-errors-1100111005) |
|
|
77
|
+
|
|
78
|
+
> **Note on pass-through codes.** A few codes (`2010`, `3030`, `9001`) carry a message assembled at the failure site. Their "How to fix" points you at the nested `cause` and Part B, because the specific error lives there.
|
|
79
|
+
>
|
|
80
|
+
> **Internal errors.** Codes marked *Internal* indicate a build-output or invariant problem you can't fix by changing configuration: rebuild the project with `agent-network project build`, and if it persists, open a support case with the `requestId`.
|
|
81
|
+
|
|
82
|
+
### Build errors (1000–1999)
|
|
83
|
+
|
|
84
|
+
| Code | Name | What it means | How to fix |
|
|
85
|
+
| --- | --- | --- | --- |
|
|
86
|
+
| 1001 | `projectDescriptorNotFound` | `exchange.json` is missing for the project. | Run the command from the project root, and confirm `exchange.json` exists. |
|
|
87
|
+
| 1002 | `invalidAgentNetworkProject` | The project failed validation. | Check the validation output printed above the error; fix the reported issue and rebuild. |
|
|
88
|
+
| 1003 | `buildAssetsError` | An asset failed to build. | Read the nested `cause`; usually a malformed asset file in the assets directory. |
|
|
89
|
+
| 1004 | `variableNotFound` | A `${placeholder}` has no matching variable. | Declare the variable under `metadata.variables` in `exchange.json`. |
|
|
90
|
+
| 1005 | `validatingAgentNetworkError` | Project validation exited with a non-zero status. | Review the validator output for the specific failure. If it doesn't explain the failure, verify `JAVA_HOME` points to a supported JDK. |
|
|
91
|
+
| 1006 | `buildingAgentNetworkError` | The build process exited with a non-zero status. | Check the build logs printed above the error. |
|
|
92
|
+
| 1007 | `wrapperNotFoundError` | The Maven wrapper (`mvnw`/`mvnw.cmd`) is missing. | Ensure the project is a Maven project and the wrapper is present and executable. |
|
|
93
|
+
| 1008 | `buildBrokersAppError` | The Brokers App failed to build. | Check the logs; usually an AgentScript compile error. |
|
|
94
|
+
| 1009 | `variablesNotFound` | One or more `${placeholder}`s in `agent-network.yaml` are not declared; raised by `build`. | Declare each listed variable under `metadata.variables` in `exchange.json`. |
|
|
95
|
+
| 1010 | `invalidVariablePath` | A variable resolves to an invalid nested path. | Correct the variable path in `exchange.json`. |
|
|
96
|
+
| 1011 | `invalidPath` | A file or YAML path is invalid. | Verify the referenced path exists and is well-formed. |
|
|
97
|
+
| 1012 | `invalidOrNotBuiltAgentNetworkProject` | A downstream command ran before the project was built. | Run `agent-network project build` first. |
|
|
98
|
+
| 1013 | `unsupportedSchemaVersion` | The `schemaVersion` isn't supported by this CLI. | Use a supported version (listed in the message), or upgrade the CLI. |
|
|
99
|
+
| 1014 | `validationConnectionsError` | A connection references an undefined target, or has the wrong kind. | Fix the connection references in `agent-network.yaml` to match defined entities and kinds. |
|
|
100
|
+
| 1015 | `noBrokerForImplementation` | An AgentScript implementation has no matching broker entry. | Add a broker for the implementation, or remove the orphaned file. |
|
|
101
|
+
| 1016 | `unsupportedToolType` | An entity declares an unknown tool type. | Use a supported tool type (listed in the message). |
|
|
102
|
+
| 1017 | `invalidAgentScriptPath` | An AgentScript path is invalid or its content is unsafe. | Use a path inside the project; remove unsafe content. |
|
|
103
|
+
| 1018 | `errorParsingAgentFile` | An AgentScript file failed to parse. | Fix the syntax error reported in the nested `cause`. |
|
|
104
|
+
| 1019 | `policyBindingNotFound` | A referenced policy binding doesn't exist. | Define the binding, or correct the reference name. |
|
|
105
|
+
| 1020 | `brokerKindMismatch` **⚠ see note** | A broker's kind doesn't support the requested interface kind. | Align the broker's kind with the interface, or use a compatible broker. |
|
|
106
|
+
| 1021 | `brokerIdMismatch` **⚠ see note** | The broker id in AgentScript doesn't match the YAML. | Make the broker id consistent between AgentScript and `agent-network.yaml`. |
|
|
107
|
+
| 1022 | `invalidAgentNetworkProjectDescriptor` **⚠ see note** | `exchange.json` descriptor is malformed. | Fix the descriptor per the details in the message. |
|
|
108
|
+
| 1023 | `brokerSupportedInterfacesUrlMismatch` **⚠ see note** | A broker's A2A supported interfaces use different base URLs. | Make all supported interfaces share one scheme/host/port; differ only on path. |
|
|
109
|
+
| 1024 | `brokerUnsupportedProtocolBinding` **⚠ see note** | A broker's `protocolBinding` isn't supported. | Use a supported `protocolBinding` value (listed in the message). |
|
|
110
|
+
| 1020 | `mcpMainYamlNotFound` **⚠ see note** | MCP introspection can't find the main YAML. | Set the `main` field in `exchange.json` to the correct file. |
|
|
111
|
+
| 1021 | `mcpYamlParseError` **⚠ see note** | The MCP YAML failed to parse. | Fix the YAML syntax error in the reported file. |
|
|
112
|
+
| 1022 | `mcpServerJsonNotFound` **⚠ see note** | `server.json` couldn't be read. | Confirm `server.json` exists and is readable. |
|
|
113
|
+
| 1023 | `mcpServerJsonInvalidJson` **⚠ see note** | `server.json` isn't valid JSON. | Fix the JSON syntax. |
|
|
114
|
+
| 1024 | `mcpServerJsonSchemaValidation` **⚠ see note** | `server.json` failed schema validation. | Correct the fields listed in the message. |
|
|
115
|
+
| 1025 | `mcpServerJsonNoRemotes` | `server.json` defines no remotes. | Add a remote entry; only remote MCP servers are supported. |
|
|
116
|
+
| 1026 | `mcpServerJsonMultipleRemotes` | `server.json` defines multiple remotes. | Pass `--transport` to select one. |
|
|
117
|
+
| 1027 | `mcpServerJsonRemoteNotFound` | The requested transport isn't in `server.json`. | Use one of the available transports listed in the message. |
|
|
118
|
+
| 1028 | `mcpInvalidRemoteProtocol` | The remote URL uses an unsupported scheme. | Use `http:` or `https:`. |
|
|
119
|
+
| 1029 | `mcpInvalidRemoteUrl` | The remote URL failed to parse. | Correct the URL in `server.json`. |
|
|
120
|
+
| 1030 | `mcpInvalidRegistryKey` | A registry key contains invalid characters. | Use only lowercase letters, digits, and hyphens. |
|
|
121
|
+
| 1031 | `mcpCannotDeriveRegistryKey` | A registry key couldn't be derived. | Declare an explicit registry key. |
|
|
122
|
+
| 1032 | `assetIdTooLongForDeployment` | The project asset id exceeds the deployment-name length limit. | Shorten the asset id and rebuild. |
|
|
123
|
+
| 1033 | `invalidExchangeJson` | `exchange.json` isn't valid JSON. | Fix the JSON syntax. |
|
|
124
|
+
| 1034 | `invalidExchangeJsonField` | An `exchange.json` field has the wrong type. | Set the reported field to the expected type (a string). |
|
|
125
|
+
| 1035 | `pushNotificationNotSupported` | A broker sets `capabilities.pushNotifications: true` in its A2A card, but push notifications aren't supported. | Set `pushNotifications` to `false` in `interfaces.a2a.card` and rebuild. |
|
|
126
|
+
| 1036 | `variableKeyCollision` | Two `metadata.variables` entries in `exchange.json` flatten to the same dotted key (e.g. `"a.b"` and nested `a` → `b`). | Rename one entry, or use nested objects consistently. |
|
|
127
|
+
| 1037 | `variableNameContainsColon` | A `metadata.variables` key or category in `exchange.json` contains a `:`, which is a restricted character and is not allowed. | Remove the `:` from the reported key or category (the message shows its full path). |
|
|
128
|
+
| 1038 | `unsupportedAuthenticationKind` | A connection (or `card.authentication`) declares an authentication `kind` the CLI does not recognize. | Use a supported kind (`basic`, `apiKey`, `apikey-client-credentials`, `oauth2-client-credentials`, `oauth2-obo` with flow `oauth2-token-exchange` or `microsoft-entra-obo`, `in-task-authorization-code`). Fix the YAML and rebuild. |
|
|
129
|
+
| 1042 | `a2aInterfacesNotSupportedForV03` | `interfaces` was declared on a connection to an A2A v0.3 agent. | Remove `interfaces` from the A2A v0.3 connection, or point the connection at an A2A v1 agent. |
|
|
130
|
+
| 1043 | `invalidA2aInterfaceBasePath` | An `interfaces.*.basePath` failed validation. | Ensure each `interfaces.*.basePath` is an absolute path starting with `/` (root and trailing `/` are allowed) with no `..` segments (including percent-encoded forms), mid-path empty segments (`//`), or URL schemes. |
|
|
131
|
+
| 1044 | `invalidA2aInterfaceProtocol` | An `interfaces` binding key is not one of the supported protocols. | Use only `jsonrpc`, `http`, or `grpc` as binding keys under `interfaces`. |
|
|
132
|
+
| 1045 | `invalidA2aInterfacesShape` | `interfaces`, an `interfaces` binding, or a card policy's `interfacePaths` is present but not a plain object. | Use a plain object: `interfaces` keyed by `jsonrpc`, `http`, or `grpc`, each binding `{ basePath }`, and `interfacePaths` a map of path strings. |
|
|
133
|
+
| 1046 | `javaHomeNotSet` | `JAVA_HOME` isn't set; schema 1.0.0 builds need a JDK to generate the brokers application. | Set `JAVA_HOME` to the installation directory of a supported JDK. |
|
|
134
|
+
| 1047 | `javaExecutableError` | The `java` executable under `JAVA_HOME` couldn't be launched (missing or not executable). | Point `JAVA_HOME` at a valid JDK installation (it must contain `bin/java`, or `bin\java.exe` on Windows). |
|
|
135
|
+
| 1048 | `invalidSecretRefDeclaration` | A `secretRef` variable is missing `group` or `name`, or is combined with `default`, `secret`, or `optional: true`. | Declare `secretRef` as `{ group, name }` and remove `default`, `secret`, and `optional`. |
|
|
136
|
+
| 1049 | `secretRefNotWholeSensitiveField` | Shared secret '<name>' at '<location>' is not allowed. A shared secret is only valid as the entire value of a sensitive policy configuration field. | The placeholder is outside policy configuration. Move it onto a field marked `security:sensitive` (or legacy `sensitive: true`). Placement outside policy configuration is a build error. |
|
|
137
|
+
| 1049 ⚠ | `secretRefNotEntireFieldValue` | Shared secret '<name>' at '<location>' is not allowed. A shared secret can only be used as the entire value of the field and cannot be prefixed or suffixed. | Same code as 1049. The placeholder is embedded in a larger string, such as `prefix-${var.name}` or `${var.name}-suffix`. Use `${var.name}` alone. |
|
|
138
|
+
| 1049 ⚠ | `secretRefFieldNotSensitive` | Shared secret '<name>' at '<location>' is not allowed. A shared secret is not supported on this policy configuration field because the field does not accept a sensitive value. | Same code as 1049. The placeholder is the entire value, but the policy schema does not mark that field sensitive (`security:sensitive` or legacy `sensitive: true`). Move it to a sensitive field. A field reached only through `patternProperties` is not treated as sensitive. |
|
|
139
|
+
|
|
140
|
+
> **⚠ Code collision (1020–1024) — known defect.** Codes 1020 through 1024 are each currently assigned to **two** different errors: a broker-interface error and an MCP-introspection error. The `errorMessage` text disambiguates which one you hit (broker interface vs. `server.json`/MCP YAML). This is a defect that will be fixed by renumbering the MCP block; until then, match on the message, not the number alone.
|
|
141
|
+
|
|
142
|
+
### Publish errors (2000–2999)
|
|
143
|
+
|
|
144
|
+
| Code | Name | What it means | How to fix |
|
|
145
|
+
| --- | --- | --- | --- |
|
|
146
|
+
| 2001 | `organizationAccessError` | You lack access to the project's `groupId`. | Switch to an organization that owns the `groupId`, or request access. |
|
|
147
|
+
| 2002 | `projectNotBuiltError` | Publish ran before build. | Run `agent-network project build` first. |
|
|
148
|
+
| 2003 | `publishError` | An asset failed to publish. | Read the nested `cause`; see [Exchange](#exchange) in Part B. |
|
|
149
|
+
| 2004 | `assetNotFoundError` | An Exchange asset lookup failed. | Verify the GAV and that the asset exists; check organization access. |
|
|
150
|
+
| 2005 | `assetTypeMismatchError` | An asset already exists in Exchange with a different type. | Use a new asset id/version, or reconcile the existing asset's type. |
|
|
151
|
+
| 2006 | `ownershipConflictsError` | The asset id is already owned by another project. | Choose a different asset id, or publish from the owning project. |
|
|
152
|
+
| 2007 | `deployedResourcesExistOnUnpublish` | Unpublish is blocked because deployed resources still reference the assets. | Run `agent-network project undeploy` first, then retry unpublish. |
|
|
153
|
+
| 2010 | `unpublishError` | Reports a failure that occurred during the unpublish stage. | Read the nested `cause` for the specific reason; see [Exchange](#exchange) — note the known 403 issue. |
|
|
154
|
+
| 2011 | `incompatibleTargetVersionPublish` | The `target/` artifact was built with an incompatible CLI version. | Rebuild with the current CLI version, then publish. |
|
|
155
|
+
| 2012 | `projectNotBuiltPublish` | No build artifact was found at publish time. | Run `agent-network project build` first. |
|
|
156
|
+
| 2013 | `publicationAggregateFailure` | One or more components failed during the publication stage; the message lists each underlying failure. | Fix the listed reasons (see the matching specific error code), then publish again. |
|
|
157
|
+
| 2014 | `unrecognizedComponentKindForPublicationOrder` | A component's kind is not recognized, so its publication order cannot be determined. | Rebuild the project with the current CLI version; if it persists, file a ticket. |
|
|
158
|
+
| 2015 | `metadataPatchParseFailed` | A serialized metadata file could not be parsed when patching versions, so publish aborted. | Rebuild with `agent-network project build`, then publish again. |
|
|
159
|
+
| 2016 | `registryPublishError` | The Registry API reported a failed `specification` step while publishing an asset, or failed the request with a failed aspect. The message names the aspect, step, system and reason, lists aspects that were not attempted, and ends with `(requestId: …)` when the service returned a request id. A `specification` status of `ERROR`, `ROLLED_BACK` or `PARTIAL` counts as failed (this set is not part of the service contract), and so does a `FAILED` status that is padded, decorated with control or zero-width characters or differs only in case. A rejected (non-2xx) response that lists failed steps is also reported as 2016, including side-aspect failures, and the message states the HTTP status. A step with a missing, blank or whitespace-only status that carries an `error` also counts as failed. A list is read as the latest projection when any element has a string `aspect` and either a `steps` array or no `stepName`; an aspect that omits `steps` is treated as having none and is named as `<aspect>: <missing steps>` in the unrecognized-statuses text, so a failed `specification` in such a body is still reported. It is also raised when a successful response lists aspects but returns no published version, except for unchanged re-publishes; that message also lists any failed side aspects from the response. Failed side aspects on a successful publish only log a warning. | Fix the reason shown for the named aspect/step, then publish again. If it is not actionable, file a ticket with the `requestId` from the error. |
|
|
160
|
+
|
|
161
|
+
### Deploy errors (3000–3999)
|
|
162
|
+
|
|
163
|
+
| Code | Name | What it means | How to fix |
|
|
164
|
+
| --- | --- | --- | --- |
|
|
165
|
+
| 3001 | `createApiError` | Creating an API instance in API Manager failed. | Often a 409 — an instance with this name already exists. See [API Manager](#api-manager). |
|
|
166
|
+
| 3004 | `deployError` | Deploying an API into a gateway failed. | Read the nested `cause`; see [Runtime Fabric / AMC](#runtime-fabric--application-manager-amc). |
|
|
167
|
+
| 3005 | `connectionNotFoundError` | A connection couldn't be resolved. | Verify the connection is published and its name matches the reference. |
|
|
168
|
+
| 3006 | `gettingEgressConnectionError` | Fetching the egress connection failed. | Check the egress gateway and target; see [Gateway Manager](#gateway-manager). |
|
|
169
|
+
| 3007 | `deployAPIError` | A generic API deploy failure. | Read the nested `cause`. |
|
|
170
|
+
| 3008 | `brokerGroupDeploymentError` | Broker group (Agent Graph) deployment failed. | Check the logs; see [Runtime Fabric / AMC](#runtime-fabric--application-manager-amc). |
|
|
171
|
+
| 3009 | `unableToResolve` | A GAV couldn't be resolved at deploy time. | Build and publish the project before deploying. |
|
|
172
|
+
| 3010 | `createPatchApiError` | Updating an existing API instance failed. | Read the nested `cause`; see [API Manager](#api-manager). |
|
|
173
|
+
| 3012 | `noTranscodingFoundFor` | An expected transcoding policy is missing. | Ensure the transcoding policy is published and referenced correctly. |
|
|
174
|
+
| 3015 | `gatewayTargetSpaceError` | The ingress/egress gateways and the runtime target space don't match. | Choose gateways whose target space matches your runtime target. |
|
|
175
|
+
| 3016 | `createApiSpecNotFound` | The API spec asset isn't in Exchange. | Publish the Agent Network before deploying. |
|
|
176
|
+
| 3017 | `requestTimeout` | A single HTTP request timed out. | Retry; if it persists, raise `--request-timeout`. See [retry engine](#the-retry-and-timeout-engine). |
|
|
177
|
+
| 3018 | `commandTimeout` | The overall command exceeded its timeout budget. | Review organization resource limits; raise `--process-timeout`. Check `steps` for how far it got. |
|
|
178
|
+
| 3019 | `findingAssetsError` | Discovering assets to deploy failed. | Retry; if it persists, read the nested `cause`. |
|
|
179
|
+
| 3020 | `nonPublishedAssetsFoundError` | One or more assets aren't published in Exchange. | Publish the listed assets, then deploy. |
|
|
180
|
+
| 3021 | `noGatewayFoundForInstance` | No gateway resolvable for an API instance. | Ensure a gateway is configured for the instance's protection direction. |
|
|
181
|
+
| 3022 | `assetNotFoundForInstance` | An API instance's backing asset is missing from Exchange. | Publish the asset before deploying. |
|
|
182
|
+
| 3023 | `assetNotFoundForConnection` | A connection's backing asset is missing from Exchange. | Publish the asset before deploying. |
|
|
183
|
+
| 3024 | `missingRequiredUpstreamUrl` | A required upstream URL wasn't resolved. | Provide the upstream URL variable at deploy time (`--property`). |
|
|
184
|
+
| 3025 | `dependencyFailure` | A stage was skipped because a dependency's stage failed. | Fix the upstream failure reported elsewhere in the output. |
|
|
185
|
+
| 3026 | `apiBelongsToAnotherProject` | An instance name collides with another project's instance. | Choose a different name, or reuse the existing instance. |
|
|
186
|
+
| 3027 | `invalidSourceValue` | An invalid `source` value was supplied. | Set `source` to a supported value (listed in the message). |
|
|
187
|
+
| 3028 | `agentGraphDeploymentError` | Agent Graph provisioning failed. | Check the logs; see [Runtime Fabric / AMC](#runtime-fabric--application-manager-amc). |
|
|
188
|
+
| 3029 | `connectionRefNotFoundError` | A `connection.ref.name` didn't resolve. | Verify the connection is published and the ref name matches. |
|
|
189
|
+
| 3030 | `undeployError` | Reports a failure that occurred during the undeploy stage (fail-closed). | Read the nested `cause` for the specific reason; see Part B for the underlying service. |
|
|
190
|
+
| 3031 | `invalidPolicy` | A policy metadata response was empty or invalid. | Verify the policy GAV (`groupId:assetId:version` coordinate); retry (may be transient). See [API Manager](#api-manager). |
|
|
191
|
+
| 3032 | `missingGatewayForSharedSpace` | A shared-space deploy needs a gateway but none was given. | Provide a gateway with `--gateway`. |
|
|
192
|
+
| 3033 | `invalidGAVFormat` | A GAV argument couldn't be parsed. | Use `groupId:assetId:version`. |
|
|
193
|
+
| 3034 | `parentAssetNotFound` | A parent asset lookup failed. | Verify the parent asset exists in Exchange. |
|
|
194
|
+
| 3036 | `invalidAgentProtocol` | Agent metadata declares no protocol for a connection. | Declare a protocol for the connection in agent metadata. |
|
|
195
|
+
| 3037 | `unsupportedAgentProtocol` | An agent exposes a non-A2A protocol only. | Only A2A (Agent2Agent) agents (`a2a`/`a2a_v1`) can be connected. |
|
|
196
|
+
| 3041 *Internal* | `networkLockMissing` | The Agent Network lock file (generated at publish) is missing at deploy time. | Build and publish the Agent Network to (re)generate the lock file, then deploy. |
|
|
197
|
+
| 3042 *Internal* | `networkLockMalformed` | The Agent Network lock file exists but is malformed or has an invalid key. | Rebuild and republish the Agent Network to regenerate the lock file, then deploy. |
|
|
198
|
+
| 3044 *Internal* | `assetMissingFromNetworkLock` | An asset referenced by the project isn't present in the lock file. | Rebuild and republish the Agent Network so the lock file covers every asset, then deploy. |
|
|
199
|
+
| 3045 | `incompatibleTargetVersionDeploy` | The `target/` artifact was built with an incompatible CLI version. | Rebuild with the current CLI, republish, then deploy. |
|
|
200
|
+
| 3046 | `projectNotBuiltDeploy` | Deploy ran before build. | Run `agent-network project build` first. |
|
|
201
|
+
| 3047 | `bulkApplyPolicyError` | Applying policies in API Manager failed. | Check policy GAV resolution and organization entitlements. See [API Manager](#api-manager). |
|
|
202
|
+
| 3048 | `brokerAuthorizationPolicyConflict` | An explicit `user-context-propagation` policy conflicts with the broker's `authorization` section. | Align or remove the conflicting policy field, per the message. |
|
|
203
|
+
| 3049 | `deploymentSettingsFlagsMutuallyExclusive` | `--deployment-properties-file` and `--deployment-property` were both passed. | Use one or the other, not both. |
|
|
204
|
+
| 3050 | `deploymentFileReadError` | The deployment settings file couldn't be read. | Verify the file path and permissions. |
|
|
205
|
+
| 3051 | `deploymentSettingsMalformedEntry` | A `--deployment-property` entry is malformed. | Use `<scope>:<name>:<value>` (for example `brokers:vCores:0.1`). |
|
|
206
|
+
| 3052 | `deploymentSettingsInvalid` | Deployment settings failed semantic validation. | Fix the reported setting. |
|
|
207
|
+
| 3053 | `runtimeVersionNotFound` | The requested runtime version isn't available. | Use one of the available versions listed in the message. |
|
|
208
|
+
| 3054 | `mixedRuntimeTypesInDeploy` | The deploy set mixes Mule apps and Agent Graphs. | Split into separate deploys. |
|
|
209
|
+
| 3055 | `deploymentAggregateFailure` | One or more deployment-stage facets failed; the message summarizes the stage. | Fix the failures listed in the command output and redeploy. |
|
|
210
|
+
| 3056 | `runtimeVersionNotResolved` | A runtime version was required but not resolved before deployment. | *Internal* — rebuild and retry; if it persists, open a support case with the `requestId`. |
|
|
211
|
+
| 3057 | `undeployEnvironmentIdRequired` | `--gav` undeploy was invoked without an environment ID. | Pass `--environment` (or ensure the session has an environment selected). |
|
|
212
|
+
| 3058 | `undeployEnvironmentRequired` | Undeploy ran with no selected environment. | Use `--environment` to specify one. |
|
|
213
|
+
| 3059 | `publicationBeforeDeploymentFailed` | Automatic publish-before-deploy failed, so deploy was aborted. | Fix the publication error in the nested cause, then redeploy. |
|
|
214
|
+
| 3060 | `llmAuthenticationKindNotSupported` | An LLM connection's authentication kind isn't declared by the referenced llm-metadata. | Use one of the supported kinds listed in the message, or publish an LLM asset that declares the kind. The legacy path (no `inputFormat`) accepts only `apiKey`. |
|
|
215
|
+
| 3061 | `llmAssetRequiresV2` | A V1 Agent Network references an LLM asset that declares `inputFormat` (V2-only). | Migrate the project to schema 2.0.0, or reference an LLM asset without `inputFormat`. |
|
|
216
|
+
| 3062 | `llmInputFormatRequiresAuthentication` | An LLM asset declares `inputFormat` but no non-empty `authentication`. | Add `authentication` to the LLM metadata (use `[{kind: 'none'}]` for no auth) and republish. |
|
|
217
|
+
| 3063 | `llmModelNotDeclared` | An agent requests a `model` the referenced LLM asset doesn't declare in `models`. | Use one of the declared model ids listed in the message, or add the model to the LLM asset and republish. |
|
|
218
|
+
| 3064 | `llmAuthenticationKindUnmapped` | The referenced llm-metadata declares the connection's authentication kind, but the CLI has no policy mapping for it. | Use one of the kinds listed in the message, or upgrade the CLI. |
|
|
219
|
+
| 3065 | `llmAdapterPolicyNotFound` | The adapter policy named by the LLM asset's `policyRef` was not found in Exchange (404, or no version returned). | Republish the LLM asset with a valid `policyRef`, or publish the adapter policy. |
|
|
220
|
+
| 3066 | `llmAdapterPolicyLookupFailed` | Resolving the LLM asset's adapter policy failed (not a 404, for example a 5xx). | Retry; if it persists, check Exchange availability and your access to the policy. |
|
|
221
|
+
| 3067 | `cardAuthenticationUpstreamsError` | Configuring dual egress upstreams (`agent` / `card`) for agent-card authentication failed in API Manager (create PATCH, update PATCH, or upstreams GET). | Confirm Flex Gateway ≥ **1.5.0**, that the connection is `a2a`/`a2a_v1`, and that outbound policies are enabled for the environment (`OUTBOUND_POLICIES_GCL_ENABLED`). An older CLI cannot update a connection that already has two upstreams, because it still PATCHes `endpoint.uri`, which API Manager rejects (ADR 0005 finding 7). Read the nested `cause`; see [API Manager](#api-manager). See ADR 0005. |
|
|
222
|
+
| 3068 | `outboundPolicyUpstreamLabelNotFound` | An outbound policy was bound to a labelled upstream (`agent` or `card`) that API Manager did not return. | Redeploy so upstreams and routing match the desired set; if it persists, the PATCH response may be missing a label — open a support case with the `requestId`. |
|
|
223
|
+
| 3069 | `secretRefGroupNotFound` | The secret group referenced by a shared secret (`secretRef` variable) does not exist in the target environment. | Create the group in that environment, or fix the `secretRef.group` name. A missing name is an empty list match, not an HTTP 404. |
|
|
224
|
+
| 3070 | `sharedSecretNotFound` | The shared secret name does not exist in the resolved secret group. | Add a Blob secret with that name, or fix `secretRef.name`. |
|
|
225
|
+
| 3071 | `secretRefNotEligible` | The secret group is not downloadable, or the shared secret is not type Blob. | Use a downloadable group and a Blob secret. Username-password, symmetric-key, and S3 secrets are not eligible. |
|
|
226
|
+
| 3072 | `secretRefValidationFailed` | Shared secret validation failed before deploy. The message lists every failure. | Fix each listed group, secret, eligibility, or non-UUID id problem and deploy again. Nothing is published until this passes. |
|
|
227
|
+
| 3072 ⚠ | `duplicateSecretGroup` | More than one secret group is named for the variable. | Same code as 3072. Remove the duplicate group name in the target environment. The pre-publish gate reports this sentence inside the consolidated 3072. |
|
|
228
|
+
| 3072 ⚠ | `duplicateSharedSecret` | More than one shared secret is named in the group for the variable. | Same code as 3072. Remove the duplicate secret name in that group. The pre-publish gate reports this sentence inside the consolidated 3072. |
|
|
229
|
+
| 3072 ⚠ | `secretRefIdNotUuid` | A resolved secret-group or shared-secret id is not a UUID. | Same code as 3072. The secret manager returned an id the CLI cannot turn into a Blob URN. |
|
|
230
|
+
| 3073 | `sharedSecretsCallFailed` | The Secret Manager call failed while resolving shared secrets, or the response was not an array. | Retry the deploy. If it persists, confirm the session can read Secret Manager in the target environment. |
|
|
231
|
+
| 3074 | `secretRefPropertyNotAllowed` | `--property` was passed for a shared secret (`secretRef` variable) on platform deploy. | Remove that `--property`. Platform deploy resolves it from Secret Manager. Local deploy accepts `--property` for the same variable. |
|
|
232
|
+
| 3075 | `gatewayNotDeployable` | The Flex gateway cannot serve a deployment. Deploy proceeds only for UI status `RUNNING`, `UPDATING`, or `OUTDATED`. Apply-state `status` is mapped with `desiredStatus` (`RUNNING` and `STARTED` are the same started state) and the `running` flag. `desiredStatus` `STOPPED` or `DELETED` is rejected even while the spec is applying; the message says `STOPPED` or `DELETED` rather than `UPDATING` or `OUTDATED`. | Start the gateway and redeploy when the status is `STOPPED`, `STOPPING`, or `NOT_RUNNING`. When the status is `STARTING`, wait until the gateway is RUNNING, then redeploy. When the status is `DELETING` or `DELETED`, choose a different gateway. |
|
|
233
|
+
|
|
234
|
+
### Gateway setup errors (4000–4999)
|
|
235
|
+
|
|
236
|
+
| Code | Name | What it means | How to fix |
|
|
237
|
+
| --- | --- | --- | --- |
|
|
238
|
+
| 4001 | `noDomainsFound` | No private-network domains for the target space. | Create a private network in the target space first. |
|
|
239
|
+
| 4002 | `setupIngressGatewayError` | Ingress gateway setup threw. | Read the nested `cause`; see [Gateway Manager](#gateway-manager). |
|
|
240
|
+
| 4003 | `setupIngressGatewayFail` | Ingress gateway setup returned a non-success status. | Check the `status` and response in the message; see [Gateway Manager](#gateway-manager). |
|
|
241
|
+
| 4004 | `setupEgressGatewayError` | Egress gateway setup threw. | Read the nested `cause`; see [Gateway Manager](#gateway-manager). |
|
|
242
|
+
| 4005 | `setupEgressGatewayFail` | Egress gateway setup returned a non-success status. | Check the `status` and response; see [Gateway Manager](#gateway-manager). |
|
|
243
|
+
| 4006 | `gatewayNotFoundError` | A named gateway isn't in the environment. | Use one of the available gateways listed in the message. |
|
|
244
|
+
| 4007 | `runtimeTargetNotFoundError` | A named runtime target space isn't in the environment. | Use an available space, or create one ([CloudHub 2 docs](https://docs.mulesoft.com/cloudhub-2/ps-create-configure)). |
|
|
245
|
+
| 4008 | `unableToRetrieveTargetSpaceMetadata` | Fetching target space metadata failed. | Retry; see [Gateway Manager](#gateway-manager). |
|
|
246
|
+
| 4009 | `unableToRetrieveGateways` | Fetching the gateway list failed. | Retry; check organization/environment access. |
|
|
247
|
+
| 4010 | `unableToRetrieveGatewayVersions` | Fetching gateway versions failed. | Retry; see [Gateway Manager](#gateway-manager). |
|
|
248
|
+
| 4011 | `gatewayChannelNotFoundError` | The requested update channel doesn't exist. | Use one of the available channels listed in the message. |
|
|
249
|
+
| 4012 | `noGatewayVersionsFoundError` | The channel has no versions. | Choose a different channel. |
|
|
250
|
+
| 4013 | `gatewayAlreadyExists` | A gateway with this name already exists in the environment. | Gateway names must be unique per environment; choose a different name. |
|
|
251
|
+
| 4014 | `setupGatewayInsufficientResourcesError` | The organization's gateway quota is exhausted. | Delete an unused gateway, or increase your organization limits. |
|
|
252
|
+
| 4015 | `missingDomainsResponse` | Domains are required for a non-shared target but none were returned. | Confirm a private network exists for the target. |
|
|
253
|
+
| 4016 | `gatewayUpdateFailedError` | Updating the gateway runtime version failed. | Check the `status` in the message; retry. |
|
|
254
|
+
| 4017 | `gatewayUpdateTimedOutError` | The gateway update didn't finish within the timeout. | Check the gateway status in Runtime Manager; retry once stable. |
|
|
255
|
+
|
|
256
|
+
### Entitlement and organization-access errors (5000–5999)
|
|
257
|
+
|
|
258
|
+
| Code | Name | What it means | How to fix |
|
|
259
|
+
| --- | --- | --- | --- |
|
|
260
|
+
| 5001 | `noEntitlementForOrganization` | Retrieving organization entitlements failed. | Check the `status` in the message; verify organization access; see [Access Management](#access-management). |
|
|
261
|
+
|
|
262
|
+
### Dependency manager errors (6000–6999)
|
|
263
|
+
|
|
264
|
+
| Code | Name | What it means | How to fix |
|
|
265
|
+
| --- | --- | --- | --- |
|
|
266
|
+
| 6001 | `downloadFileError` | A dependency download failed. The message includes the URL (credentials stripped) and the HTTP status when available. | Check network access and proxy settings; retry. A download that receives no data for 60 seconds is aborted (`no data received for 60s`); `maven-metadata.xml` requests time out after 30 seconds of inactivity. Slow proxies that scan the file first can exceed this: ask your network team to allow the Nexus host without inspection or use an internal mirror. |
|
|
267
|
+
| 6002 | `couldNotFindVersion` | No resolvable version in `maven-metadata.xml`. | Confirm the dependency exists in the repository and that you have network access to it. |
|
|
268
|
+
| 6003 | `invalidStrategyVersion` | A dependency strategy/version config is invalid. | Correct the strategy/version in the descriptor. |
|
|
269
|
+
| 6004 | `invalidMetadataFile` | A dependency metadata file is invalid. | Re-run setup to refresh the cached dependency. |
|
|
270
|
+
| 6005 | `runtimeDependenciesFileNotFound` | The runtime dependency manifest is missing. | Run `agent-network setup dependencies`. |
|
|
271
|
+
| 6006 | `invalidDependencyVersion` | A dependency version isn't valid SemVer. | Use SemVer (for example `2.1.3`). |
|
|
272
|
+
| 6007 | `insecureRepositoryUrl` | The repository URL set with `--nexus-url` or `ANYPOINT_AGENT_FABRIC_REPOSITORY_URL` is not a valid `https://` URL. | Use an `https://` URL. |
|
|
273
|
+
| 6008 | `downloadedFileNotArchive` | The downloaded dependency is not a JAR (usually an HTML page from a proxy, captive portal or mirror). | Verify the repository URL and that your proxy CA is trusted (`NODE_EXTRA_CA_CERTS`); retry. |
|
|
274
|
+
| 6009 | `checksumMismatch` | The downloaded dependency does not match the SHA-256 pinned by this plugin release. The file is discarded. | Verify the mirror serves the unmodified artifact version pinned by the plugin; update the plugin if the mirror is current. |
|
|
275
|
+
|
|
276
|
+
### Create command errors (7000–7999)
|
|
277
|
+
|
|
278
|
+
| Code | Name | What it means | How to fix |
|
|
279
|
+
| --- | --- | --- | --- |
|
|
280
|
+
| 7001 | `projectAlreadyExists` | The target project/directory already exists. | Use a new name or directory. |
|
|
281
|
+
| 7002 | `invalidAssetVersion` | The asset version isn't valid SemVer. | Use SemVer (for example `0.0.0`). |
|
|
282
|
+
| 7003 | `invalidGroupId` | The `group-id` wasn't found. | Use a `group-id` for an organization you belong to (listed in the message). |
|
|
283
|
+
| 7004 | `invalidProjectName` | The project name has no alphanumeric character. | Include at least one alphanumeric character. |
|
|
284
|
+
| 7005 | `invalidAssetId` | The asset id has invalid characters. | Use only `A-Z`, `a-z`, `0-9`, `_`, `-`. |
|
|
285
|
+
| 7006 | `missingAssetIdWithInvalidProjectName` | The project name has no alphanumerics and no asset id was given. | Provide an explicit asset id. |
|
|
286
|
+
| 7007 | `brokerAlreadyExists` | A broker with this name already exists. | Choose a different broker name. |
|
|
287
|
+
| 7008 | `invalidBrokerTemplate` | The broker scaffold template is missing. | Reinstall the plugin; the installation may be corrupted. |
|
|
288
|
+
| 7009 | `unsupportedAgentNetworkVersion` | The command requires a V2 project. | Use a V2 Agent Network project. |
|
|
289
|
+
| 7010 | `invalidAgentNetworkYaml` | `agent-network.yaml` failed to parse. | Fix the YAML syntax error reported in the message. |
|
|
290
|
+
| 7011 | `invalidEmptyBrokerName` | The broker name has no alphanumeric character. | Include at least one alphanumeric character. |
|
|
291
|
+
| 7012 | `invalidBrokerName` | The broker id violates the naming pattern. | Start/end with a letter or digit; use only letters, digits, `_`, `.`, `-` in the middle. |
|
|
292
|
+
| 7013 | `invalidBrokersSection` | The `brokers` YAML section isn't a mapping. | Make `brokers:` a mapping of names to definitions. |
|
|
293
|
+
| 7014 | `brokerNameTooLong` | The broker id exceeds the deployment-name length limit. | Shorten the broker name. |
|
|
294
|
+
|
|
295
|
+
### Policy validation errors (8001–8004)
|
|
296
|
+
|
|
297
|
+
| Code | Name | What it means | How to fix |
|
|
298
|
+
| --- | --- | --- | --- |
|
|
299
|
+
| 8001 | `policyVersionError` | Looking up a policy version failed. | Verify the policy GAV; see [Exchange](#exchange). |
|
|
300
|
+
| 8002 | `policyValidationFailed` | One or more policy bindings failed validation. | Fix the validation errors listed in the nested `cause`. |
|
|
301
|
+
| 8003 | `schemaNotFoundForAsset` | A policy config schema file is missing. | Verify the policy asset includes its schema. |
|
|
302
|
+
| 8004 | `dependencyVersionNotFound` | A dependency version is absent from the descriptor. | Add the dependency version to `exchange.json`. |
|
|
303
|
+
|
|
304
|
+
### Local run errors (8500–8550)
|
|
305
|
+
|
|
306
|
+
These come from `agent-network project run-local` (local Docker Compose environment).
|
|
307
|
+
|
|
308
|
+
| Code | Name | What it means | How to fix |
|
|
309
|
+
| --- | --- | --- | --- |
|
|
310
|
+
| 8500 | `v1NotSupportedForLocalRun` | `run-local` was invoked on a V1 project. | Only V2 projects can run locally. |
|
|
311
|
+
| 8501 | `dockerNotInstalled` | Docker isn't installed. | Install [Docker Desktop](https://www.docker.com/products/docker-desktop/). |
|
|
312
|
+
| 8502 | `dockerDaemonNotRunning` | The Docker daemon isn't running. | Start Docker Desktop and retry. |
|
|
313
|
+
| 8503 | `dockerSignInRequired` | Docker requires sign-in. | Run `docker login` or sign in via Docker Desktop. |
|
|
314
|
+
| 8504 | `dockerImagePullFailed` | A required image failed to pull. | Ensure you're signed in and have network access. |
|
|
315
|
+
| 8505 | `exchangeJsonMissingMain` | `exchange.json` has no `main` field. | Set the `main` field to the network YAML file. |
|
|
316
|
+
| 8506 | `flexRegistrationFailed` | Flex Gateway registration generation failed. | Read the detail in the message; retry. |
|
|
317
|
+
| 8507 | `policyImplementationNotFound` | No Flex implementation exists for a policy. | Use a policy with a Flex Gateway implementation. |
|
|
318
|
+
| 8508 | `policyImplementationResolveFailed` | Resolving a policy's Flex implementation failed. | Read the detail; verify the policy GAV. |
|
|
319
|
+
| 8509 | `policyFetchFailed` | Fetching a policy asset failed. | Check network/Exchange access; retry. |
|
|
320
|
+
| 8510 | `policyAssetCorrupt` | A cached policy asset is missing `exchange.json`. | Clear the cache and re-fetch. |
|
|
321
|
+
| 8511 | `policyMainFileMissing` | A policy asset's declared main file is absent. | Verify the policy asset is complete. |
|
|
322
|
+
| 8512 | `policyDependencyMissing` | A policy dependency isn't cached. | Re-run to fetch dependencies. |
|
|
323
|
+
| 8513 | `noAvailablePort` | No free port in the scan range. | Free a port or pass `--port` explicitly. |
|
|
324
|
+
| 8514 | `invalidPort` | The `--port` value is invalid. | Use an integer between 1 and 65535. |
|
|
325
|
+
| 8515 | `agentGraphServiceNameCollision` | Two asset ids trim to the same Docker service name. | Rename one asset to avoid the DNS-label collision. |
|
|
326
|
+
| 8516 | `localSecretRetrievalFailed` | A stored secret couldn't be retrieved. | Re-run without a cached value to re-enter the secret. |
|
|
327
|
+
| 8517 | `unknownLlmPlatformForApiKey` | An LLM platform isn't recognized for API-key selection. | Use a supported platform (listed in the message). |
|
|
328
|
+
| 8518 | `undeclaredVariables` | A `${...}` placeholder is used but not declared. | Declare each variable under `metadata.variables` in `exchange.json`. |
|
|
329
|
+
| 8519 | `dockerAgentGraphImageMissing` | The Agent Graph image isn't published yet. | Local deploy isn't available yet; use `--build-only`, which doesn't need the image. |
|
|
330
|
+
| 8520 | `localEnvironmentNotRendered` | A local-deploy command ran before `run-local`. | Run `agent-network project run-local` first. |
|
|
331
|
+
| 8521 | `secretEnvVarNameCollision` | Two secret variables normalize to the same env var name. | Rename one to avoid the collision. |
|
|
332
|
+
| 8522 | `secretRouteSegment` | A secret variable is used in a route path segment. | Use a non-secret variable for the path. |
|
|
333
|
+
| 8523 | `secretUpstreamAddress` | A secret variable is used in an upstream URL. | Use a non-secret variable, or supply the credential via a policy. |
|
|
334
|
+
| 8524 | `flexCrdNameCollision` | Two Flex Gateway CRD (Custom Resource Definition) ids collapse to the same filename. | Rename one of the colliding ids. |
|
|
335
|
+
| 8535 | `localRunUnsupportedProjectType` | `run-local` was invoked on a project that is not an Agent Network (`exchange.json` classifier is present and is neither `agentic-network` nor `agent-network`). | Run local deploy from an Agent Network V2 project. A V1 project (`agent-network`) reports 8500 instead. |
|
|
336
|
+
| 8536 | `localTlsVariableCollision` | A declared variable has the exact name `tls.<connectionId>.<field>` that local run generates for a connection `tlsContext`. | Rename the declared variable; local run reserves the generated `tls.<connectionId>.<field>` names for egress TLS inputs. |
|
|
337
|
+
| 8537 | `localTlsUpstreamNotHttps` | A connection with a `tlsContext` has a non-`https://` upstream (checked before any TLS file is read). | Use an `https://` upstream, or remove the `tlsContext`. |
|
|
338
|
+
| 8538 | `localTlsFileUnreadable` | A TLS certificate, key or CA file couldn't be read. | Fix the `tls.<connectionId>.<field>` path (relative to the project directory; `~` is your home directory) or its permissions. |
|
|
339
|
+
| 8539 | `localTlsInvalidPem` | A TLS file isn't the expected PEM certificate or private key. | Provide PEM files; convert DER/PKCS#12 files with `openssl`. The certificate file must not embed a private key block. |
|
|
340
|
+
| 8540 | `localTlsTraditionalEncryptedKey` | The private key is a traditional encrypted PEM (`Proc-Type: 4,ENCRYPTED`). | Convert it with `openssl pkcs8 -topk8 -in <key> -out <new-key>` and use the new file. |
|
|
341
|
+
| 8541 | `localTlsKeyUnloadable` | The private key couldn't be loaded (corrupt key or wrong passphrase). | Check the key file and re-enter `tls.<connectionId>.keyPassphrase` (empty for an unencrypted key). |
|
|
342
|
+
| 8542 | `localTlsIncompleteCertificate` | Only one of `certificateFile` / `keyFile` is set. | Set both for a client certificate, or neither. |
|
|
343
|
+
| 8543 | `localTlsInvalidOption` | A TLS option (`skipValidation`, version, `ciphers`, `alpn`) has an unsupported value. | Use one of the allowed values listed in the message. |
|
|
344
|
+
| 8544 | `localTlsVersionRange` | The TLS `minVersion` is greater than `maxVersion`. | Lower `minVersion` or raise `maxVersion`. |
|
|
345
|
+
| 8545 | `localTlsSecureEnvMissing` | A resolved TLS key env var is empty at runtime start. | *Internal* — re-run local run so the TLS files are read again. |
|
|
346
|
+
| 8546 | `localTlsCertificateKeyMismatch` | No certificate in the TLS client certificate file matches the private key. | Provide the certificate that was issued for this key, or the matching key. |
|
|
347
|
+
| 8547 | `localTlsAddedWhileWatching` | A rebuild during `--watch` added a connection with a `tlsContext` that was never resolved in this session. | Restart `run-local` so the TLS inputs are prompted and resolved. |
|
|
348
|
+
| 8548 | `localTlsBindingMissing` | A connection with a `tlsContext` reached rendering without resolved TLS inputs. | *Internal* — restart `run-local`; report it if it persists. |
|
|
349
|
+
| 8549 | `localTlsNoCipherForMaxVersion` | `maxVersion` is `1.2` but every configured cipher is a TLS 1.3 suite, so no handshake could succeed. | Add a TLS 1.2 cipher to `tls.<connectionId>.ciphers` or set `maxVersion` to `1.3`. |
|
|
350
|
+
| 8550 | `localTlsLeafNotFirst` | The private key matches a certificate that is not the first one in the TLS client certificate file. | Reorder the file so the client (leaf) certificate comes first, followed by its chain. |
|
|
351
|
+
|
|
352
|
+
### Generic errors (9001)
|
|
353
|
+
|
|
354
|
+
| Code | Name | What it means | How to fix |
|
|
355
|
+
| --- | --- | --- | --- |
|
|
356
|
+
| 9001 | `genericError` | An uncategorized failure; the message carries the specific reason. | Read the `errorMessage` and nested `cause`; consult Part B for the underlying service. |
|
|
357
|
+
|
|
358
|
+
### Access management errors (10001)
|
|
359
|
+
|
|
360
|
+
| Code | Name | What it means | How to fix |
|
|
361
|
+
| --- | --- | --- | --- |
|
|
362
|
+
| 10001 | `credentialsValidationsError` | Credential validation failed. | Re-authenticate; verify your credentials. See [Access Management](#access-management). |
|
|
363
|
+
|
|
364
|
+
### Gateway flag and CLI-argument errors (11001–11005)
|
|
365
|
+
|
|
366
|
+
| Code | Name | What it means | How to fix |
|
|
367
|
+
| --- | --- | --- | --- |
|
|
368
|
+
| 11001 | `gatewayFlagsMutuallyExclusive` | `--gateway` was combined with `--ingress-gw`/`--egress-gw`. | Use `--gateway` alone, or `--ingress-gw [--egress-gw]`. |
|
|
369
|
+
| 11002 | `egressGwRequiresIngress` | `--egress-gw` was passed without `--ingress-gw`. | Pass both, or use `--gateway`. |
|
|
370
|
+
| 11003 | `gatewayFlagRequired` | No gateway flag was supplied. | Pass `--gateway` or `--ingress-gw [--egress-gw]`. |
|
|
371
|
+
| 11004 | `separateGatewayModeNotSupportedInSharedSpace` | Separate-gateway mode was used with a Shared Space. | Use `--gateway`, or pass a Private Space to `--target-space`. |
|
|
372
|
+
| 11005 | `singleGatewayTargetSpaceMismatch` | `--target-space` conflicts with the gateway's target space. | Omit `--target-space`, or make it match the gateway. |
|
|
373
|
+
|
|
374
|
+
---
|
|
375
|
+
|
|
376
|
+
## Part B — Dependent services: status codes and common issues
|
|
377
|
+
|
|
378
|
+
The CLI orchestrates several Anypoint Platform services. When one of them returns an HTTP error, it surfaces in the `cause.response.status` field described in [How to read a CLI error](#how-to-read-a-cli-error). This part explains the common failures per service.
|
|
379
|
+
|
|
380
|
+
### The retry and timeout engine
|
|
381
|
+
|
|
382
|
+
Before diagnosing a transient-looking failure, know that the CLI already retries automatically:
|
|
383
|
+
|
|
384
|
+
- **Retries:** every HTTP `429` and `5xx`, plus network errors (`ECONNRESET`, `ETIMEDOUT`, `ENETUNREACH`, `EAI_AGAIN`).
|
|
385
|
+
- **Attempts:** up to 2, with a 30-second backoff; the server's `Retry-After` header is honored (clamped to 30s).
|
|
386
|
+
- **Deletes:** a `404` on a retry is treated as success (the resource was already deleted).
|
|
387
|
+
- **Non-idempotent writes:** `POST`/`PUT`/`PATCH` are also retried on `5xx`/`429`; retrying these can occasionally create a duplicate resource on non-idempotent endpoints.
|
|
388
|
+
- **Timeouts:** each request defaults to 60s (`--request-timeout`); the whole command defaults to 15 minutes (`--process-timeout`).
|
|
389
|
+
|
|
390
|
+
If a command still fails after these retries, treat the failure as deterministic rather than transient, unless a table below says otherwise.
|
|
391
|
+
|
|
392
|
+
### Exchange
|
|
393
|
+
|
|
394
|
+
Backs `publish`, `unpublish`, and asset lookups during build/deploy.
|
|
395
|
+
|
|
396
|
+
| Operation | Status / symptom | Likely cause | Fix |
|
|
397
|
+
| --- | --- | --- | --- |
|
|
398
|
+
| Publish asset | `409` / asset already exists | An asset with this id exists with a different type or owner. | See codes 2005/2006; use a new id/version or reconcile ownership. |
|
|
399
|
+
| Unpublish / undeploy asset delete | **`403 Forbidden` (surfaces as code 2010)** | A known Exchange platform issue. | Retry later. If it persists, open a support case with your `requestId` — this is a known platform issue, not something you can resolve locally. |
|
|
400
|
+
| Delete asset version | `404` | The asset is already gone. | None — treated as success. |
|
|
401
|
+
| Fetch policy / asset | `5xx` / `429` | Transient platform load. | Automatically retried; if it persists, retry later. |
|
|
402
|
+
| Fetch policy Flex bundle | Missing zip classifier (`run-local` only) | Some policy versions (for example `user-context-propagation-policy-flex@1.0.0`) were published without a zip classifier. | This policy version is missing a required file in Exchange. Open a support case to request that MuleSoft republish it with a zip classifier. Production `deploy` is unaffected. |
|
|
403
|
+
|
|
404
|
+
### API Manager
|
|
405
|
+
|
|
406
|
+
Backs API-instance and connection creation/patching, policy application, and instance deletion during deploy/undeploy.
|
|
407
|
+
|
|
408
|
+
| Operation | Status / symptom | Likely cause | Fix |
|
|
409
|
+
| --- | --- | --- | --- |
|
|
410
|
+
| Create API instance / connection | **`409 Conflict` (code 3001)** | A stale/orphaned instance from a prior partial deploy, or a name collision. | Check API Manager for an existing instance with that name; delete or reuse it, then redeploy. |
|
|
411
|
+
| Patch API instance | non-2xx (code 3010) | The target instance changed or was removed. | Read the `cause`; verify the instance still exists. |
|
|
412
|
+
| Apply policies | failure (code 3047) | Policy GAV resolution or organization entitlement problem. | Verify the policy GAV and that your organization is entitled to the policy. |
|
|
413
|
+
| Fetch policy metadata | empty/invalid (code 3031) | Transient, or a bad policy GAV. | Retry; if it persists, verify the policy GAV. |
|
|
414
|
+
| Delete instance (undeploy) | `404` | The instance was already removed. | None — treated as success. |
|
|
415
|
+
|
|
416
|
+
### Runtime Fabric / Application Manager (AMC)
|
|
417
|
+
|
|
418
|
+
Backs Mule application and Agent Graph deployment and undeployment.
|
|
419
|
+
|
|
420
|
+
| Operation | Status / symptom | Likely cause | Fix |
|
|
421
|
+
| --- | --- | --- | --- |
|
|
422
|
+
| Poll deployment status | "Deployment status request returned status N" | A non-retryable HTTP error, or retries exhausted. | Read the status; check the deployment in Runtime Manager. |
|
|
423
|
+
| Deploy request | request timeout (code 3017) | The request exceeded `--request-timeout`. | Retry; raise `--request-timeout`. |
|
|
424
|
+
| Whole command | command timeout (code 3018) | The organization may be resource-constrained, or the deploy is genuinely slow. | Review organization resource allocation; raise `--process-timeout`. Check `steps` for progress. |
|
|
425
|
+
| Deploy (broker group / Agent Graph) | failure (codes 3008 / 3028) | Underlying AMC error. | Read the logs and nested `cause`. |
|
|
426
|
+
| Undeploy by name | `404` | Already removed. | None — treated as success. |
|
|
427
|
+
|
|
428
|
+
### Gateway Manager
|
|
429
|
+
|
|
430
|
+
Backs `agent-network setup gateways` (ingress/egress Flex Gateway provisioning).
|
|
431
|
+
|
|
432
|
+
| Operation | Status / symptom | Likely cause | Fix |
|
|
433
|
+
| --- | --- | --- | --- |
|
|
434
|
+
| Create gateway | name collision (code 4013) | Gateway names must be unique per environment. | Choose a different name. |
|
|
435
|
+
| Create gateway | insufficient resources (code 4014) | The organization's gateway quota is exhausted. | Delete an unused gateway or raise organization limits. |
|
|
436
|
+
| Resolve domains | no domains (codes 4001 / 4015) | No private network in the target space. | Create a private network for the target space first. |
|
|
437
|
+
| Setup ingress/egress | non-success status (codes 4003 / 4005) | Downstream gateway/API Manager error. | Read the `status` and response in the message; retry. |
|
|
438
|
+
| List gateways / versions / metadata | non-2xx (codes 4008–4010) | Transient or access issue. | Retry; verify organization/environment access. |
|
|
439
|
+
|
|
440
|
+
### Access Management
|
|
441
|
+
|
|
442
|
+
Backs organization, entitlement, and credential validation at build/publish/deploy time.
|
|
443
|
+
|
|
444
|
+
| Operation | Status / symptom | Likely cause | Fix |
|
|
445
|
+
| --- | --- | --- | --- |
|
|
446
|
+
| Retrieve entitlements | non-2xx (code 5001) | Transient, or the organization lacks the entitlement. | Retry; verify the organization is entitled to Agent Fabric. |
|
|
447
|
+
| Credential validation | failure (code 10001) | Expired or invalid credentials. | Re-authenticate. |
|
|
448
|
+
|
|
449
|
+
### Building schema 1.0.0 projects behind a proxy
|
|
450
|
+
|
|
451
|
+
Schema 1.0.0 builds run `./mvnw clean package`. Maven ignores `HTTPS_PROXY`, so when `HTTPS_PROXY` (or `https_proxy`, `HTTP_PROXY`, `http_proxy`) is set, the CLI writes `target/maven-proxy-settings.xml` with the proxy host and port and passes it to Maven as `-gs` (global settings). `NO_PROXY` / `no_proxy` entries become Maven `nonProxyHosts`, so internal mirrors such as Nexus can bypass the proxy; a bare host such as `corp.local` also matches its subdomains, and a leading-dot entry such as `.corp.local` matches both `corp.local` and its subdomains. CIDR ranges (for example `10.0.0.0/8`) are not supported, so list the hosts by name. Only `http://` and `https://` proxy URLs are used; a value without a scheme is treated as `http://`. Maven always connects to the proxy over plain HTTP, so an `https://` proxy URL logs a warning; use an `http://` URL for the proxy. The same proxy is used for HTTP and HTTPS repositories. The file is generated only when the user settings Maven reads (`.mvn/settings.xml` if present, otherwise `~/.m2/settings.xml`) declare no active `<proxy>`; otherwise your proxies and their `nonProxyHosts` are used unchanged and `HTTPS_PROXY` is ignored for Maven. When the file is generated, `-gs` replaces the global `conf/settings.xml` of the Maven installation for that build; the generated file keeps Maven's default `maven-default-http-blocker` mirror so plain-HTTP repositories stay blocked, and a mirror in your own settings still takes precedence. The CLI logs the applied proxy at info level; pass `--no-maven-proxy` to `agent-network project build` to skip generating it. Schema 2.0.0 (AgentScript) builds do not run Maven and are not affected.
|
|
452
|
+
|
|
453
|
+
| Symptom | Likely cause | Fix |
|
|
454
|
+
| --- | --- | --- |
|
|
455
|
+
| Warning that the proxy URL includes credentials | Credentials in `HTTPS_PROXY` are deliberately not forwarded to Maven, so they never appear in arguments, environment or logs. | Declare the proxy with an encrypted password in a `<proxy>` block of `.mvn/settings.xml`. |
|
|
456
|
+
| An internal mirror (for example Nexus) is unreachable after the CLI started applying `HTTPS_PROXY` | `HTTPS_PROXY` is exported globally and the internal host is not covered by `NO_PROXY` (CIDR entries such as `10.0.0.0/8` are not supported), so Maven now sends its traffic through the proxy. | List the internal hosts by name in `NO_PROXY`, or run `agent-network project build --no-maven-proxy`. |
|
|
457
|
+
| Dependencies still fail to resolve behind a proxy | An active `<proxy>` in your own settings disables the generated one, or a `<mirror>` redirects the repositories. | Fix the proxy block in `.mvn/settings.xml` (or `~/.m2/settings.xml` when there is no `.mvn/settings.xml`), or set it inactive so `HTTPS_PROXY` is used. |
|
|
458
|
+
|
|
459
|
+
### Known platform issues vs. plugin issues
|
|
460
|
+
|
|
461
|
+
| Item | Status / code | Classification |
|
|
462
|
+
| --- | --- | --- |
|
|
463
|
+
| Exchange unpublish/undeploy `403` | 403 → code 2010 | **Known Exchange platform issue** — retry later; open a support case with your `requestId` if it persists. |
|
|
464
|
+
| `user-context-propagation-policy-flex@1.0.0` missing zip classifier | `run-local` fetch failure | **Missing file in Exchange** — open a support case to request republish; production `deploy` unaffected. |
|
|
465
|
+
| Agent Graph Docker image not published | code 8519 | **External blocker** — use `--build-only` until the image is published. |
|
|
466
|
+
| `409` on API instance/connection create | 409 → code 3001 | **Environment state** — usually an orphaned instance; check API Manager and delete/reuse. |
|
|
467
|
+
| API Manager / AMC `5xx` / `429` / timeouts | 429, 5xx | **Transient platform load** — already retried by the CLI. |
|
|
468
|
+
| Gateway setup non-2xx relays | codes 4003–4010 | **Downstream relay** — the CLI passes through the status returned by the gateway or API Manager service. |
|
|
@@ -1,5 +1,5 @@
|
|
|
1
|
-
import {
|
|
2
|
-
export default class AgentConsole extends
|
|
1
|
+
import { AgentFabricCommand } from '../../../utils/agent-fabric-commands';
|
|
2
|
+
export default class AgentConsole extends AgentFabricCommand {
|
|
3
3
|
static description: string;
|
|
4
4
|
static hidden: boolean;
|
|
5
5
|
static examples: string[];
|
|
@@ -7,6 +7,7 @@ export default class AgentConsole extends Command {
|
|
|
7
7
|
path: import("@oclif/core/lib/interfaces").OptionFlag<string>;
|
|
8
8
|
port: import("@oclif/core/lib/interfaces").OptionFlag<number>;
|
|
9
9
|
'gateway-url': import("@oclif/core/lib/interfaces").OptionFlag<string | undefined>;
|
|
10
|
+
debug: import("@oclif/core/lib/interfaces").BooleanFlag<boolean>;
|
|
10
11
|
};
|
|
11
12
|
run(): Promise<void>;
|
|
12
13
|
private static discoverAgents;
|
|
@@ -1,6 +1,7 @@
|
|
|
1
1
|
"use strict";
|
|
2
2
|
Object.defineProperty(exports, "__esModule", { value: true });
|
|
3
3
|
const core_1 = require("@oclif/core");
|
|
4
|
+
const agent_fabric_commands_1 = require("../../../utils/agent-fabric-commands");
|
|
4
5
|
const node_http_1 = require("node:http");
|
|
5
6
|
const node_fs_1 = require("node:fs");
|
|
6
7
|
const node_path_1 = require("node:path");
|
|
@@ -19,7 +20,7 @@ function consoleErrorStatus(error) {
|
|
|
19
20
|
}
|
|
20
21
|
return 500;
|
|
21
22
|
}
|
|
22
|
-
class AgentConsole extends
|
|
23
|
+
class AgentConsole extends agent_fabric_commands_1.AgentFabricCommand {
|
|
23
24
|
async run() {
|
|
24
25
|
const { flags } = await this.parse(AgentConsole);
|
|
25
26
|
const cwd = process.cwd();
|
|
@@ -159,6 +160,7 @@ AgentConsole.examples = [
|
|
|
159
160
|
'$ agent-network project agent-console --gateway-url http://localhost:8081',
|
|
160
161
|
];
|
|
161
162
|
AgentConsole.flags = {
|
|
163
|
+
...agent_fabric_commands_1.AgentFabricCommand.flags,
|
|
162
164
|
path: core_1.Flags.file({
|
|
163
165
|
description: 'The path to the project.',
|
|
164
166
|
default: '.',
|
|
@@ -1 +1 @@
|
|
|
1
|
-
{"version":3,"file":"agent-console.js","sourceRoot":"","sources":["../../../../src/commands/agent-network/project/agent-console.ts"],"names":[],"mappings":";;AAAA,
|
|
1
|
+
{"version":3,"file":"agent-console.js","sourceRoot":"","sources":["../../../../src/commands/agent-network/project/agent-console.ts"],"names":[],"mappings":"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"}
|
|
@@ -1,10 +1,11 @@
|
|
|
1
|
-
import {
|
|
2
|
-
export default class Create extends
|
|
1
|
+
import { AgentFabricCommand } from '../../../../utils/agent-fabric-commands';
|
|
2
|
+
export default class Create extends AgentFabricCommand {
|
|
3
3
|
static description: string;
|
|
4
4
|
static examples: string[];
|
|
5
5
|
static flags: {
|
|
6
6
|
name: import("@oclif/core/lib/interfaces").OptionFlag<string>;
|
|
7
7
|
path: import("@oclif/core/lib/interfaces").OptionFlag<string>;
|
|
8
|
+
debug: import("@oclif/core/lib/interfaces").BooleanFlag<boolean>;
|
|
8
9
|
};
|
|
9
10
|
run(): Promise<void>;
|
|
10
11
|
}
|