mulesoft-anypoint-cli-agent-fabric-plugin 1.3.0 → 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 (184) hide show
  1. package/README.md +77 -42
  2. package/bin/run +6 -0
  3. package/dist/commands/agent-network/project/agent-console.d.ts +16 -0
  4. package/dist/commands/agent-network/project/agent-console.js +175 -0
  5. package/dist/commands/agent-network/project/agent-console.js.map +1 -0
  6. package/dist/commands/agent-network/project/broker/create.d.ts +10 -0
  7. package/dist/commands/agent-network/project/broker/create.js +192 -0
  8. package/dist/commands/agent-network/project/broker/create.js.map +1 -0
  9. package/dist/commands/agent-network/project/create.d.ts +12 -0
  10. package/dist/commands/agent-network/project/create.js +48 -11
  11. package/dist/commands/agent-network/project/create.js.map +1 -1
  12. package/dist/commands/agent-network/project/deploy.d.ts +24 -14
  13. package/dist/commands/agent-network/project/deploy.js +230 -178
  14. package/dist/commands/agent-network/project/deploy.js.map +1 -1
  15. package/dist/commands/agent-network/project/export-logs.d.ts +11 -0
  16. package/dist/commands/agent-network/project/export-logs.js +38 -0
  17. package/dist/commands/agent-network/project/export-logs.js.map +1 -0
  18. package/dist/commands/agent-network/project/mcp/introspect.js +4 -1
  19. package/dist/commands/agent-network/project/mcp/introspect.js.map +1 -1
  20. package/dist/commands/agent-network/project/publish.js +1 -1
  21. package/dist/commands/agent-network/project/publish.js.map +1 -1
  22. package/dist/commands/agent-network/project/run-local.d.ts +85 -0
  23. package/dist/commands/agent-network/project/run-local.js +825 -0
  24. package/dist/commands/agent-network/project/run-local.js.map +1 -0
  25. package/dist/commands/agent-network/project/secrets.d.ts +21 -0
  26. package/dist/commands/agent-network/project/secrets.js +163 -0
  27. package/dist/commands/agent-network/project/secrets.js.map +1 -0
  28. package/dist/commands/agent-network/project/stop-local.d.ts +11 -0
  29. package/dist/commands/agent-network/project/stop-local.js +38 -0
  30. package/dist/commands/agent-network/project/stop-local.js.map +1 -0
  31. package/dist/commands/agent-network/project/undeploy.js +15 -10
  32. package/dist/commands/agent-network/project/undeploy.js.map +1 -1
  33. package/dist/commands/agent-network/project/unpublish.js +14 -6
  34. package/dist/commands/agent-network/project/unpublish.js.map +1 -1
  35. package/dist/commands/agent-network/setup/gateways.d.ts +3 -0
  36. package/dist/commands/agent-network/setup/gateways.js +66 -3
  37. package/dist/commands/agent-network/setup/gateways.js.map +1 -1
  38. package/dist/errors/error-factory.d.ts +51 -6
  39. package/dist/errors/error-factory.js +246 -15
  40. package/dist/errors/error-factory.js.map +1 -1
  41. package/dist/helpers/proxy-agent.d.ts +2 -0
  42. package/dist/helpers/proxy-agent.js +26 -0
  43. package/dist/helpers/proxy-agent.js.map +1 -0
  44. package/dist/helpers/request-utils.d.ts +2 -1
  45. package/dist/helpers/request-utils.js +2 -2
  46. package/dist/helpers/request-utils.js.map +1 -1
  47. package/dist/helpers/utils.d.ts +1 -0
  48. package/dist/helpers/utils.js +5 -0
  49. package/dist/helpers/utils.js.map +1 -1
  50. package/dist/resources/agent-console.html +478 -0
  51. package/dist/resources/schemas/broker-deployment-settings.schema.json +46 -0
  52. package/dist/types/agent-network-v2.d.ts +4 -0
  53. package/dist/types/agent-network-v2.js.map +1 -1
  54. package/dist/types/types.d.ts +1 -0
  55. package/dist/utils/builders/network-lock.d.ts +1 -0
  56. package/dist/utils/builders/network-lock.js +41 -6
  57. package/dist/utils/builders/network-lock.js.map +1 -1
  58. package/dist/utils/builders/policies-factory.d.ts +5 -1
  59. package/dist/utils/builders/policies-factory.js +10 -2
  60. package/dist/utils/builders/policies-factory.js.map +1 -1
  61. package/dist/utils/builders/project-builder-impl.d.ts +16 -2
  62. package/dist/utils/builders/project-builder-impl.js +29 -1
  63. package/dist/utils/builders/project-builder-impl.js.map +1 -1
  64. package/dist/utils/builders/project-builder.d.ts +29 -2
  65. package/dist/utils/builders/project-builder.js +10 -2
  66. package/dist/utils/builders/project-builder.js.map +1 -1
  67. package/dist/utils/builders/remote-space-resolver.d.ts +2 -2
  68. package/dist/utils/builders/remote-space-resolver.js +27 -11
  69. package/dist/utils/builders/remote-space-resolver.js.map +1 -1
  70. package/dist/utils/builders/space-serializer.js +3 -1
  71. package/dist/utils/builders/space-serializer.js.map +1 -1
  72. package/dist/utils/builders/stage-diagnostics.d.ts +2 -0
  73. package/dist/utils/builders/stage-diagnostics.js +27 -0
  74. package/dist/utils/builders/stage-diagnostics.js.map +1 -0
  75. package/dist/utils/builders/tooling-metadata.d.ts +4 -4
  76. package/dist/utils/builders/tooling-metadata.js +27 -15
  77. package/dist/utils/builders/tooling-metadata.js.map +1 -1
  78. package/dist/utils/builders/v1/network-builder.js +2 -1
  79. package/dist/utils/builders/v1/network-builder.js.map +1 -1
  80. package/dist/utils/builders/v2/broker-builder.d.ts +1 -0
  81. package/dist/utils/builders/v2/broker-builder.js +69 -4
  82. package/dist/utils/builders/v2/broker-builder.js.map +1 -1
  83. package/dist/utils/builders/v2/network-builder.js +1 -1
  84. package/dist/utils/builders/v2/network-builder.js.map +1 -1
  85. package/dist/utils/constants.d.ts +3 -0
  86. package/dist/utils/constants.js +8 -3
  87. package/dist/utils/constants.js.map +1 -1
  88. package/dist/utils/deployment-settings.d.ts +13 -0
  89. package/dist/utils/deployment-settings.js +97 -0
  90. package/dist/utils/deployment-settings.js.map +1 -0
  91. package/dist/utils/facets/abstract-facet.d.ts +1 -0
  92. package/dist/utils/facets/abstract-facet.js +3 -0
  93. package/dist/utils/facets/abstract-facet.js.map +1 -1
  94. package/dist/utils/facets/agent-graph-facet.d.ts +14 -1
  95. package/dist/utils/facets/agent-graph-facet.js +126 -49
  96. package/dist/utils/facets/agent-graph-facet.js.map +1 -1
  97. package/dist/utils/facets/api-instance-facet.d.ts +36 -1
  98. package/dist/utils/facets/api-instance-facet.js +196 -5
  99. package/dist/utils/facets/api-instance-facet.js.map +1 -1
  100. package/dist/utils/facets/connection-facet.d.ts +8 -0
  101. package/dist/utils/facets/connection-facet.js +65 -1
  102. package/dist/utils/facets/connection-facet.js.map +1 -1
  103. package/dist/utils/facets/deployment-helpers.d.ts +18 -1
  104. package/dist/utils/facets/deployment-helpers.js +53 -0
  105. package/dist/utils/facets/deployment-helpers.js.map +1 -1
  106. package/dist/utils/facets/deployment-logs.js +1 -0
  107. package/dist/utils/facets/deployment-logs.js.map +1 -1
  108. package/dist/utils/facets/deployment-runner.js +5 -0
  109. package/dist/utils/facets/deployment-runner.js.map +1 -1
  110. package/dist/utils/facets/facets.d.ts +2 -0
  111. package/dist/utils/facets/facets.js +20 -3
  112. package/dist/utils/facets/facets.js.map +1 -1
  113. package/dist/utils/facets/mule-application-facet.d.ts +1 -1
  114. package/dist/utils/facets/mule-application-facet.js +25 -21
  115. package/dist/utils/facets/mule-application-facet.js.map +1 -1
  116. package/dist/utils/files.d.ts +25 -0
  117. package/dist/utils/files.js +62 -0
  118. package/dist/utils/files.js.map +1 -1
  119. package/dist/utils/gateway.d.ts +6 -2
  120. package/dist/utils/gateway.js +37 -33
  121. package/dist/utils/gateway.js.map +1 -1
  122. package/dist/utils/keychain.d.ts +56 -0
  123. package/dist/utils/keychain.js +488 -0
  124. package/dist/utils/keychain.js.map +1 -0
  125. package/dist/utils/logger.d.ts +1 -0
  126. package/dist/utils/logger.js +3 -0
  127. package/dist/utils/logger.js.map +1 -1
  128. package/dist/utils/mcp/mcp-metadata-mapper.d.ts +8 -0
  129. package/dist/utils/mcp/mcp-metadata-mapper.js +7 -1
  130. package/dist/utils/mcp/mcp-metadata-mapper.js.map +1 -1
  131. package/dist/utils/mcp/project-registrar.js +2 -26
  132. package/dist/utils/mcp/project-registrar.js.map +1 -1
  133. package/dist/utils/naming.d.ts +13 -0
  134. package/dist/utils/naming.js +36 -4
  135. package/dist/utils/naming.js.map +1 -1
  136. package/dist/utils/request-executor.d.ts +5 -5
  137. package/dist/utils/run-local/agent-console-proxy.d.ts +56 -0
  138. package/dist/utils/run-local/agent-console-proxy.js +182 -0
  139. package/dist/utils/run-local/agent-console-proxy.js.map +1 -0
  140. package/dist/utils/run-local/broker-recreate-selector.d.ts +31 -0
  141. package/dist/utils/run-local/broker-recreate-selector.js +82 -0
  142. package/dist/utils/run-local/broker-recreate-selector.js.map +1 -0
  143. package/dist/utils/run-local/build-status.d.ts +73 -0
  144. package/dist/utils/run-local/build-status.js +210 -0
  145. package/dist/utils/run-local/build-status.js.map +1 -0
  146. package/dist/utils/run-local/constants.d.ts +28 -0
  147. package/dist/utils/run-local/constants.js +36 -0
  148. package/dist/utils/run-local/constants.js.map +1 -0
  149. package/dist/utils/run-local/crd-files.d.ts +2 -0
  150. package/dist/utils/run-local/crd-files.js +24 -0
  151. package/dist/utils/run-local/crd-files.js.map +1 -0
  152. package/dist/utils/run-local/index.d.ts +9 -0
  153. package/dist/utils/run-local/index.js +42 -0
  154. package/dist/utils/run-local/index.js.map +1 -0
  155. package/dist/utils/run-local/local-a2a-upstream.d.ts +9 -0
  156. package/dist/utils/run-local/local-a2a-upstream.js +55 -0
  157. package/dist/utils/run-local/local-a2a-upstream.js.map +1 -0
  158. package/dist/utils/run-local/local-deploy-descriptor.d.ts +36 -0
  159. package/dist/utils/run-local/local-deploy-descriptor.js +70 -0
  160. package/dist/utils/run-local/local-deploy-descriptor.js.map +1 -0
  161. package/dist/utils/run-local/local-run-manager.d.ts +51 -0
  162. package/dist/utils/run-local/local-run-manager.js +220 -0
  163. package/dist/utils/run-local/local-run-manager.js.map +1 -0
  164. package/dist/utils/run-local/policy-resolver.d.ts +69 -0
  165. package/dist/utils/run-local/policy-resolver.js +461 -0
  166. package/dist/utils/run-local/policy-resolver.js.map +1 -0
  167. package/dist/utils/run-local/runtime-environment-manager.d.ts +89 -0
  168. package/dist/utils/run-local/runtime-environment-manager.js +313 -0
  169. package/dist/utils/run-local/runtime-environment-manager.js.map +1 -0
  170. package/dist/utils/run-local/secrets-manager.d.ts +66 -0
  171. package/dist/utils/run-local/secrets-manager.js +181 -0
  172. package/dist/utils/run-local/secrets-manager.js.map +1 -0
  173. package/dist/utils/uris.js +4 -0
  174. package/dist/utils/uris.js.map +1 -1
  175. package/dist/utils/variables.d.ts +17 -4
  176. package/dist/utils/variables.js +52 -7
  177. package/dist/utils/variables.js.map +1 -1
  178. package/package.json +3 -1
  179. package/scripts/check-gus-ticket-format.sh +29 -0
  180. package/scripts/resolve-version.sh +161 -52
  181. package/scripts/resolve-version.test.sh +207 -20
  182. package/templates/agent-network/exchange.json.template +1 -0
  183. package/templates/agentic-network/brokers/broker1.agent.template +2 -2
  184. package/templates/agentic-network/exchange.json.template +1 -0
@@ -0,0 +1,478 @@
1
+ <!DOCTYPE html>
2
+ <html lang="en">
3
+ <head>
4
+ <meta charset="UTF-8">
5
+ <meta name="viewport" content="width=device-width, initial-scale=1.0">
6
+ <title>Agent Console</title>
7
+ <style>
8
+ :root {
9
+ --brand: #0176D3;
10
+ --brand-dark: #014486;
11
+ --brand-darker: #032D60;
12
+ --success: #04844B;
13
+ --warning: #FFB75D;
14
+ --error: #EA001E;
15
+ --bg: #F4F6F9;
16
+ --surface: #FFFFFF;
17
+ --border: #DDDBDA;
18
+ --text: #3E3E3C;
19
+ --text-muted: #706E6B;
20
+ --text-light: #FAFAF9;
21
+ --highlight: #E6F7FF;
22
+ --font: 'Salesforce Sans', -apple-system, BlinkMacSystemFont, 'Segoe UI', 'Helvetica Neue', Arial, sans-serif;
23
+ --mono: 'SF Mono', Monaco, 'Cascadia Code', 'Roboto Mono', Consolas, monospace;
24
+ --radius: 8px;
25
+ }
26
+ * { margin: 0; padding: 0; box-sizing: border-box; }
27
+ body { font-family: var(--font); background: var(--bg); color: var(--text); height: 100vh; display: flex; flex-direction: column; }
28
+
29
+ header { background: var(--brand-darker); color: var(--text-light); padding: 12px 24px; display: flex; align-items: center; gap: 16px; }
30
+ header h1 { font-size: 18px; font-weight: 600; }
31
+ header .spacer { flex: 1; }
32
+ header .debug-toggle { background: rgba(255,255,255,0.15); border: 1px solid rgba(255,255,255,0.3); color: white; padding: 6px 12px; border-radius: var(--radius); font-size: 12px; cursor: pointer; font-family: var(--font); }
33
+ header .debug-toggle.active { background: var(--brand); }
34
+
35
+ .main { flex: 1; display: flex; overflow: hidden; }
36
+
37
+ /* Left sidebar */
38
+ .sidebar { width: 300px; background: var(--surface); border-right: 1px solid var(--border); display: flex; flex-direction: column; }
39
+ .section-header { padding: 10px 16px; font-size: 11px; font-weight: 600; color: var(--text-muted); text-transform: uppercase; letter-spacing: 0.5px; border-bottom: 1px solid var(--border); display: flex; align-items: center; justify-content: space-between; background: var(--bg); }
40
+ .section-header button { background: var(--brand); color: white; border: none; padding: 3px 8px; border-radius: var(--radius); font-size: 11px; cursor: pointer; font-family: var(--font); }
41
+
42
+ /* Agent entries */
43
+ .agents-section { border-bottom: 1px solid var(--border); }
44
+ button.agent-entry, button.task-item, button.debug-entry-header, button.cancel-task {
45
+ font: inherit; color: inherit; background: none; border: none; border-radius: 0;
46
+ }
47
+ button.agent-entry, button.task-item {
48
+ display: block; width: 100%; text-align: left;
49
+ }
50
+ button.debug-entry-header {
51
+ display: flex; width: 100%; text-align: left;
52
+ }
53
+ button.agent-entry:focus-visible, button.task-item:focus-visible,
54
+ button.debug-entry-header:focus-visible, button.cancel-task:focus-visible,
55
+ .close-btn:focus-visible {
56
+ outline: 2px solid var(--brand); outline-offset: -2px;
57
+ }
58
+ .agent-entry { padding: 10px 16px; border-bottom: 1px solid var(--border); cursor: pointer; transition: background 0.15s; }
59
+ .agent-entry:last-child { border-bottom: none; }
60
+ .agent-entry:hover { background: var(--bg); }
61
+ .agent-entry.active { background: var(--highlight); border-left: 3px solid var(--brand); }
62
+ .agent-entry .agent-header { display: flex; align-items: center; gap: 8px; }
63
+ .status-dot { width: 8px; height: 8px; border-radius: 50%; flex-shrink: 0; }
64
+ .status-dot.checking { background: var(--warning); animation: pulse 1.5s infinite; }
65
+ .status-dot.online { background: var(--success); }
66
+ .status-dot.offline { background: var(--error); }
67
+ @keyframes pulse { 0%, 100% { opacity: 1; } 50% { opacity: 0.4; } }
68
+ .agent-entry .agent-name { font-size: 13px; font-weight: 600; }
69
+ .agent-entry .agent-status-text { font-size: 10px; color: var(--text-muted); margin-left: auto; }
70
+ .agent-entry .agent-desc { font-size: 11px; color: var(--text-muted); line-height: 1.3; margin-top: 3px; display: -webkit-box; -webkit-line-clamp: 2; -webkit-box-orient: vertical; overflow: hidden; }
71
+ .agent-entry .skill-tags { margin-top: 4px; display: flex; flex-wrap: wrap; gap: 3px; }
72
+ .skill-tag { font-size: 9px; padding: 1px 6px; border-radius: 10px; background: var(--highlight); color: var(--brand); font-weight: 500; }
73
+
74
+ /* Task list */
75
+ .task-section { flex: 1; overflow-y: auto; }
76
+ .task-row { display: flex; align-items: stretch; border-bottom: 1px solid var(--border); }
77
+ .task-row.active { background: var(--highlight); border-left: 3px solid var(--brand); }
78
+ .task-item { flex: 1; padding: 8px 16px; cursor: pointer; transition: background 0.15s; min-width: 0; }
79
+ .task-item:hover { background: var(--highlight); }
80
+ .task-item .task-preview { display: block; font-size: 12px; white-space: nowrap; overflow: hidden; text-overflow: ellipsis; }
81
+ .task-item .task-meta { display: flex; align-items: center; gap: 6px; margin-top: 3px; }
82
+ .task-item .task-id { font-size: 10px; color: var(--text-muted); font-family: var(--mono); }
83
+ .cancel-task { color: var(--error); font-size: 12px; cursor: pointer; padding: 8px 12px; white-space: nowrap; align-self: center; }
84
+
85
+ .badge { font-size: 9px; font-weight: 600; padding: 1px 5px; border-radius: 10px; text-transform: uppercase; letter-spacing: 0.3px; }
86
+ .badge-completed { background: #e6f4ea; color: var(--success); }
87
+ .badge-working, .badge-submitted { background: var(--highlight); color: var(--brand); }
88
+ .badge-failed, .badge-rejected { background: #fde7e9; color: var(--error); }
89
+ .badge-input-required { background: #fff8e1; color: #6B4F00; }
90
+ .badge-auth-required { background: #fff0e0; color: #8A3400; }
91
+ .badge-canceled { background: #f3f2f2; color: var(--text-muted); }
92
+
93
+ /* Center — chat */
94
+ .chat-area { flex: 1; display: flex; flex-direction: column; min-width: 0; }
95
+ .messages { flex: 1; overflow-y: auto; padding: 20px 24px; display: flex; flex-direction: column; gap: 12px; }
96
+ .message { max-width: 75%; padding: 10px 14px; border-radius: var(--radius); font-size: 14px; line-height: 1.5; white-space: pre-wrap; word-break: break-word; }
97
+ .message.user { align-self: flex-end; background: var(--brand); color: white; border-bottom-right-radius: 2px; }
98
+ .message.agent { align-self: flex-start; background: var(--surface); border: 1px solid var(--border); border-bottom-left-radius: 2px; }
99
+ .message.system { align-self: center; background: #fff8e1; border: 1px solid var(--warning); font-size: 13px; color: #6B4F00; text-align: center; max-width: 90%; }
100
+ .message.error { align-self: center; background: #fde7e9; border: 1px solid var(--error); font-size: 13px; color: var(--error); text-align: center; max-width: 90%; }
101
+ .message pre { font-family: var(--mono); font-size: 12px; background: rgba(0,0,0,0.04); padding: 8px; border-radius: 4px; overflow-x: auto; margin: 6px 0; }
102
+ .loading { display: flex; gap: 4px; padding: 10px 14px; align-self: flex-start; }
103
+ .loading span { width: 8px; height: 8px; background: var(--border); border-radius: 50%; animation: bounce 1.4s infinite; }
104
+ .loading span:nth-child(2) { animation-delay: 0.2s; }
105
+ .loading span:nth-child(3) { animation-delay: 0.4s; }
106
+ @keyframes bounce { 0%, 80%, 100% { transform: translateY(0); } 40% { transform: translateY(-8px); } }
107
+ .empty-state { flex: 1; display: flex; align-items: center; justify-content: center; flex-direction: column; color: var(--text-muted); gap: 8px; }
108
+ .empty-state svg { width: 48px; height: 48px; opacity: 0.4; }
109
+
110
+ .visually-hidden { position: absolute; width: 1px; height: 1px; padding: 0; margin: -1px; overflow: hidden; clip: rect(0, 0, 0, 0); white-space: nowrap; border: 0; }
111
+ .input-bar { padding: 12px 24px; border-top: 1px solid var(--border); background: var(--surface); display: flex; gap: 8px; align-items: flex-end; position: relative; }
112
+ .input-bar textarea { flex: 1; resize: none; border: 1px solid var(--border); border-radius: var(--radius); padding: 10px 14px; font-family: var(--font); font-size: 14px; line-height: 1.4; min-height: 42px; max-height: 140px; outline: none; transition: border-color 0.15s; }
113
+ .input-bar textarea:focus { border-color: var(--brand); }
114
+ .input-bar button { background: var(--brand); color: white; border: none; border-radius: var(--radius); padding: 10px 20px; font-family: var(--font); font-size: 14px; font-weight: 600; cursor: pointer; transition: background 0.15s; white-space: nowrap; }
115
+ .input-bar button:hover { background: var(--brand-dark); }
116
+ .input-bar button:disabled { background: var(--border); cursor: not-allowed; }
117
+
118
+ /* Debug panel */
119
+ .debug-panel { width: 420px; background: var(--surface); border-left: 1px solid var(--border); display: flex; flex-direction: column; transition: width 0.2s; overflow: hidden; }
120
+ .debug-panel.collapsed { width: 0; border-left: none; }
121
+ .debug-panel-header { padding: 8px 14px; font-size: 12px; font-weight: 600; color: var(--text-muted); border-bottom: 1px solid var(--border); display: flex; align-items: center; gap: 0; min-width: 420px; }
122
+ .debug-panel-header button.close-btn { background: none; border: none; color: var(--text-muted); cursor: pointer; font-size: 16px; margin-left: auto; padding: 0 4px; }
123
+ .debug-tab { padding: 6px 12px; cursor: pointer; border: none; background: none; font-family: var(--font); font-size: 12px; color: var(--text-muted); border-bottom: 2px solid transparent; }
124
+ .debug-tab.active { color: var(--brand); border-bottom-color: var(--brand); font-weight: 600; }
125
+ .debug-content { flex: 1; overflow-y: auto; min-width: 420px; }
126
+ .debug-content > div { display: none; }
127
+ .debug-content > div.active { display: block; }
128
+
129
+ /* HTTP log entries */
130
+ .debug-entry { border-bottom: 1px solid var(--border); }
131
+ .debug-entry-header { padding: 8px 14px; font-size: 11px; font-family: var(--mono); color: var(--text-muted); cursor: pointer; display: flex; align-items: center; gap: 6px; }
132
+ .debug-entry-header:hover { background: var(--bg); }
133
+ .debug-entry-header .arrow { transition: transform 0.15s; font-size: 10px; }
134
+ .debug-entry-header.open .arrow { transform: rotate(90deg); }
135
+ .debug-entry-header .method { color: var(--brand); font-weight: 600; }
136
+ .debug-entry-header .status-ok { color: var(--success); }
137
+ .debug-entry-header .status-err { color: var(--error); }
138
+ .debug-entry-body { display: none; padding: 0 14px 10px; }
139
+ .debug-entry-body.open { display: block; }
140
+ .debug-entry-body pre { font-family: var(--mono); font-size: 11px; background: var(--bg); padding: 8px; border-radius: 4px; overflow-x: auto; white-space: pre-wrap; word-break: break-all; max-height: 300px; overflow-y: auto; }
141
+ .debug-entry-body h4 { font-size: 10px; text-transform: uppercase; color: var(--text-muted); margin: 6px 0 4px; letter-spacing: 0.5px; }
142
+
143
+ /* Agent card view */
144
+ .card-view { padding: 14px; }
145
+ .card-view pre { font-family: var(--mono); font-size: 11px; background: var(--bg); padding: 10px; border-radius: 4px; white-space: pre-wrap; word-break: break-all; overflow-y: auto; }
146
+ .card-view .card-placeholder { color: var(--text-muted); font-size: 13px; padding: 20px; text-align: center; }
147
+
148
+ ::-webkit-scrollbar { width: 6px; }
149
+ ::-webkit-scrollbar-track { background: transparent; }
150
+ ::-webkit-scrollbar-thumb { background: var(--border); border-radius: 3px; }
151
+ </style>
152
+ </head>
153
+ <body>
154
+
155
+ <header>
156
+ <svg width="24" height="24" viewBox="0 0 24 24" fill="none"><circle cx="12" cy="12" r="10" stroke="white" stroke-width="2"/><path d="M8 12l3 3 5-5" stroke="white" stroke-width="2" stroke-linecap="round"/></svg>
157
+ <h1>Agent Console</h1>
158
+ <div class="spacer"></div>
159
+ <button class="debug-toggle" id="debugToggle" onclick="toggleDebug()">Debug</button>
160
+ </header>
161
+
162
+ <div class="main">
163
+ <div class="sidebar">
164
+ <div class="agents-section">
165
+ <div class="section-header">Agents</div>
166
+ <div id="agentsList"></div>
167
+ </div>
168
+ <div class="section-header">
169
+ Tasks
170
+ <button onclick="newConversation()">+ New</button>
171
+ </div>
172
+ <div class="task-section" id="taskList">
173
+ <div style="padding:16px;color:var(--text-muted);font-size:12px;text-align:center">No tasks yet</div>
174
+ </div>
175
+ </div>
176
+
177
+ <div class="chat-area">
178
+ <div class="messages" id="messages">
179
+ <div class="empty-state">
180
+ <svg viewBox="0 0 24 24" fill="none"><path d="M21 15a2 2 0 01-2 2H7l-4 4V5a2 2 0 012-2h14a2 2 0 012 2z" stroke="currentColor" stroke-width="1.5"/></svg>
181
+ <div>Select an agent to start a conversation</div>
182
+ </div>
183
+ </div>
184
+ <div class="input-bar">
185
+ <label for="input" class="visually-hidden">Message</label>
186
+ <textarea id="input" placeholder="Type a message..." rows="1" onkeydown="handleKey(event)" oninput="autoResize(this)"></textarea>
187
+ <button id="sendBtn" onclick="sendMessage()">Send</button>
188
+ </div>
189
+ </div>
190
+
191
+ <div class="debug-panel collapsed" id="debugPanel">
192
+ <div class="debug-panel-header">
193
+ <button class="debug-tab active" onclick="switchDebugTab('http', this)">HTTP Log</button>
194
+ <button class="debug-tab" onclick="switchDebugTab('card', this)">Agent Card</button>
195
+ <button class="close-btn" onclick="toggleDebug()" aria-label="Close debug panel">&times;</button>
196
+ </div>
197
+ <div class="debug-content">
198
+ <div id="debugHttpTab" class="active">
199
+ <div id="debugEntries"></div>
200
+ </div>
201
+ <div id="debugCardTab">
202
+ <div class="card-view" id="cardView">
203
+ <div class="card-placeholder">Select an agent to view its card</div>
204
+ </div>
205
+ </div>
206
+ </div>
207
+ </div>
208
+ </div>
209
+
210
+ <script>
211
+ const GATEWAY_URL = '{{GATEWAY_URL}}';
212
+ let agents = [];
213
+ let agentCards = {};
214
+ let agentStatus = {};
215
+ let currentAgent = null;
216
+ let currentContextId = null;
217
+ let currentTaskId = null;
218
+ let tasks = [];
219
+ let sending = false;
220
+ let debugOpen = false;
221
+ let debugLog = [];
222
+
223
+ async function init() {
224
+ try {
225
+ const resp = await fetch('/api/agents');
226
+ agents = await resp.json();
227
+ agents.forEach(a => { agentStatus[a.path] = 'checking'; });
228
+ renderAgentsList();
229
+ if (agents.length > 0) selectAgent(agents[0]);
230
+ agents.forEach(a => loadAgentCard(a));
231
+ setInterval(checkAllAgentStatus, 15000);
232
+ } catch (e) {
233
+ showError('Failed to load agents: ' + e.message);
234
+ }
235
+ }
236
+
237
+ async function checkAllAgentStatus() {
238
+ await Promise.all(agents.map(async a => {
239
+ try {
240
+ const r = await fetch(`/api/agent-card?path=${encodeURIComponent(a.path)}`);
241
+ const newStatus = r.ok ? 'online' : 'offline';
242
+ if (agentStatus[a.path] !== newStatus) { agentStatus[a.path] = newStatus; renderAgentsList(); }
243
+ } catch {
244
+ if (agentStatus[a.path] !== 'offline') { agentStatus[a.path] = 'offline'; renderAgentsList(); }
245
+ }
246
+ }));
247
+ }
248
+
249
+ async function loadAgentCard(agent) {
250
+ try {
251
+ const resp = await fetch(`/api/agent-card?path=${encodeURIComponent(agent.path)}`);
252
+ if (resp.ok) { agentCards[agent.path] = await resp.json(); agentStatus[agent.path] = 'online'; }
253
+ else agentStatus[agent.path] = 'offline';
254
+ } catch { agentStatus[agent.path] = 'offline'; }
255
+ renderAgentsList();
256
+ if (currentAgent?.path === agent.path) renderCardView();
257
+ }
258
+
259
+ function selectAgent(agent) {
260
+ currentAgent = agent;
261
+ currentContextId = null;
262
+ currentTaskId = null;
263
+ tasks = [];
264
+ renderAgentsList();
265
+ renderTaskList();
266
+ renderCardView();
267
+ showEmpty(`Start a conversation with ${agentCards[agent.path]?.name || agent.name}`);
268
+ }
269
+
270
+ function renderAgentsList() {
271
+ const el = document.getElementById('agentsList');
272
+ const statusLabels = { checking: 'Starting...', online: 'Online', offline: 'Offline' };
273
+ el.innerHTML = agents.map(a => {
274
+ const active = currentAgent?.path === a.path ? 'active' : '';
275
+ const status = agentStatus[a.path] || 'checking';
276
+ const card = agentCards[a.path];
277
+ const desc = card?.description || '';
278
+ const skills = (card?.skills || []).slice(0, 4).map(s =>
279
+ `<span class="skill-tag">${escHtml(s.name || s.id)}</span>`).join('');
280
+
281
+ return `<button type="button" class="agent-entry ${active}" onclick="selectAgent(agents.find(x=>x.path===${jsAttr(a.path)}))">
282
+ <span class="agent-header">
283
+ <span class="status-dot ${status}"></span>
284
+ <span class="agent-name">${escHtml(card?.name || a.name)}</span>
285
+ <span class="agent-status-text">${statusLabels[status]}</span>
286
+ </span>
287
+ ${desc ? `<span class="agent-desc">${escHtml(desc)}</span>` : ''}
288
+ ${skills ? `<span class="skill-tags">${skills}</span>` : ''}
289
+ </button>`;
290
+ }).join('');
291
+ }
292
+
293
+ function renderTaskList() {
294
+ const list = document.getElementById('taskList');
295
+ if (tasks.length === 0) {
296
+ list.innerHTML = '<div style="padding:16px;color:var(--text-muted);font-size:12px;text-align:center">No tasks yet</div>';
297
+ return;
298
+ }
299
+ list.innerHTML = tasks.map(t => {
300
+ const preview = getTaskPreview(t);
301
+ const state = t.status?.state || 'unknown';
302
+ const active = t.id === currentTaskId ? 'active' : '';
303
+ return `<div class="task-row ${active}">
304
+ <button type="button" class="task-item" onclick="selectTask(${jsAttr(t.id)})">
305
+ <span class="task-preview">${escHtml(preview)}</span>
306
+ <span class="task-meta">
307
+ <span class="task-id">${t.id.substring(0, 8)}</span>
308
+ <span class="badge badge-${state.replace('_','-')}">${state.replace('_',' ')}</span>
309
+ </span>
310
+ </button>
311
+ ${state === 'working' || state === 'submitted' ? `<button type="button" class="cancel-task" aria-label="Cancel task" onclick="cancelTask(${jsAttr(t.id)})">&times; cancel</button>` : ''}
312
+ </div>`;
313
+ }).join('');
314
+ }
315
+
316
+ function renderCardView() {
317
+ const el = document.getElementById('cardView');
318
+ if (!currentAgent) { el.innerHTML = '<div class="card-placeholder">Select an agent to view its card</div>'; return; }
319
+ const card = agentCards[currentAgent.path];
320
+ if (!card) { el.innerHTML = `<div class="card-placeholder">${agentStatus[currentAgent.path] === 'checking' ? 'Loading...' : 'Agent card not available'}</div>`; return; }
321
+ el.innerHTML = `<pre>${escHtml(JSON.stringify(card, null, 2))}</pre>`;
322
+ }
323
+
324
+ function switchDebugTab(tab, btn) {
325
+ document.querySelectorAll('.debug-tab').forEach(t => t.classList.remove('active'));
326
+ btn.classList.add('active');
327
+ document.getElementById('debugHttpTab').classList.toggle('active', tab === 'http');
328
+ document.getElementById('debugCardTab').classList.toggle('active', tab === 'card');
329
+ }
330
+
331
+ function toggleDebug() {
332
+ debugOpen = !debugOpen;
333
+ document.getElementById('debugPanel').classList.toggle('collapsed', !debugOpen);
334
+ document.getElementById('debugToggle').classList.toggle('active', debugOpen);
335
+ }
336
+
337
+ function addDebugEntry(method, url, request, response, status) {
338
+ debugLog.unshift({ method, url, request, response, status, time: new Date().toLocaleTimeString() });
339
+ if (debugLog.length > 50) debugLog.pop();
340
+ renderDebugEntries();
341
+ }
342
+
343
+ function renderDebugEntries() {
344
+ document.getElementById('debugEntries').innerHTML = debugLog.map((e, i) => {
345
+ const sc = e.status && e.status < 400 ? 'status-ok' : 'status-err';
346
+ return `<div class="debug-entry">
347
+ <button type="button" class="debug-entry-header" aria-expanded="false" aria-controls="debugBody${i}" onclick="toggleDebugEntry(${i})">
348
+ <span class="arrow">&#9654;</span>
349
+ <span class="method">${e.method}</span>
350
+ <span>${escHtml(e.url)}</span>
351
+ <span class="${sc}" style="margin-left:auto">${e.status || '---'}</span>
352
+ <span style="color:var(--text-muted)">${e.time}</span>
353
+ </button>
354
+ <div class="debug-entry-body" id="debugBody${i}">
355
+ <h4>Request</h4><pre>${escHtml(JSON.stringify(e.request, null, 2))}</pre>
356
+ <h4>Response</h4><pre>${escHtml(JSON.stringify(e.response, null, 2))}</pre>
357
+ </div>
358
+ </div>`;
359
+ }).join('');
360
+ }
361
+
362
+ function toggleDebugEntry(idx) {
363
+ const header = document.querySelectorAll('.debug-entry-header')[idx];
364
+ const body = document.getElementById(`debugBody${idx}`);
365
+ const open = header.classList.toggle('open');
366
+ body.classList.toggle('open', open);
367
+ header.setAttribute('aria-expanded', open ? 'true' : 'false');
368
+ }
369
+
370
+ function newConversation() {
371
+ if (!currentAgent) return;
372
+ currentContextId = null;
373
+ currentTaskId = null;
374
+ renderTaskList();
375
+ showEmpty(`Start a new conversation with ${agentCards[currentAgent.path]?.name || currentAgent.name}`);
376
+ }
377
+
378
+ async function sendMessage() {
379
+ const input = document.getElementById('input');
380
+ const text = input.value.trim();
381
+ if (!text || !currentAgent || sending) return;
382
+ sending = true; updateSendButton();
383
+ input.value = ''; autoResize(input);
384
+ clearEmpty(); appendMessage('user', text); showLoading();
385
+
386
+ const payload = {
387
+ jsonrpc: '2.0', method: 'message/send', id: crypto.randomUUID(),
388
+ params: { message: { messageId: crypto.randomUUID(), role: 'user', parts: [{ kind: 'text', text }] } }
389
+ };
390
+ if (currentContextId) payload.params.contextId = currentContextId;
391
+
392
+ try {
393
+ const resp = await fetch('/api/send', {
394
+ method: 'POST', headers: { 'Content-Type': 'application/json' },
395
+ body: JSON.stringify({ agentId: currentAgent.path, payload }),
396
+ });
397
+ const data = await resp.json();
398
+ hideLoading();
399
+ addDebugEntry('POST', `${currentAgent.path}/`, payload, data, resp.status);
400
+ if (data.error) showError(data.error.message || JSON.stringify(data.error));
401
+ else if (data.result) {
402
+ const task = data.result;
403
+ currentTaskId = task.id;
404
+ currentContextId = task.contextId || currentContextId;
405
+ updateTask(task);
406
+ renderTaskStatus(task);
407
+ }
408
+ } catch (e) {
409
+ hideLoading();
410
+ addDebugEntry('POST', `${currentAgent.path}/`, payload, { error: e.message }, 0);
411
+ showError('Request failed: ' + e.message);
412
+ }
413
+ sending = false; updateSendButton();
414
+ }
415
+
416
+ function renderTaskStatus(task) {
417
+ const s = task.status; if (!s) return;
418
+ if (s.message?.parts) {
419
+ for (const p of s.message.parts) {
420
+ if (p.kind === 'text') appendMessage('agent', p.text);
421
+ else if (p.kind === 'data') appendMessage('agent', '', p.data);
422
+ else if (p.kind === 'file') appendMessage('agent', `[File: ${p.file?.name || 'attachment'}]`);
423
+ }
424
+ }
425
+ if (s.state === 'input_required') appendSystem('The agent needs additional input to continue.');
426
+ else if (s.state === 'auth_required') appendSystem('Authentication required. Please provide credentials.');
427
+ else if (s.state === 'failed') showError('Task failed' + (s.message?.parts?.[0]?.text ? ': ' + s.message.parts[0].text : ''));
428
+ }
429
+
430
+ function updateTask(task) {
431
+ const idx = tasks.findIndex(t => t.id === task.id);
432
+ if (idx >= 0) tasks[idx] = task; else tasks.unshift(task);
433
+ renderTaskList();
434
+ }
435
+
436
+ function getTaskPreview(task) {
437
+ if (task.history?.length > 0) { const u = task.history.find(m => m.role === 'user'); if (u?.parts) { const t = u.parts.find(p => p.kind === 'text'); if (t) return t.text; } }
438
+ return 'Task ' + task.id.substring(0, 8);
439
+ }
440
+
441
+ async function selectTask(taskId) {
442
+ const task = tasks.find(t => t.id === taskId); if (!task) return;
443
+ currentTaskId = task.id; currentContextId = task.contextId;
444
+ const msgs = document.getElementById('messages'); msgs.innerHTML = '';
445
+ if (task.history) { for (const msg of task.history) { const role = msg.role === 'user' ? 'user' : 'agent'; for (const p of (msg.parts || [])) { if (p.kind === 'text') appendMessage(role, p.text); else if (p.kind === 'data') appendMessage(role, '', p.data); } } }
446
+ if (task.status) renderTaskStatus(task);
447
+ renderTaskList();
448
+ }
449
+
450
+ async function cancelTask(taskId) {
451
+ const payload = { jsonrpc: '2.0', method: 'tasks/cancel', id: crypto.randomUUID(), params: { id: taskId } };
452
+ try {
453
+ const resp = await fetch('/api/cancel', { method: 'POST', headers: { 'Content-Type': 'application/json' }, body: JSON.stringify({ agentId: currentAgent.path, payload }) });
454
+ const data = await resp.json();
455
+ addDebugEntry('POST', `${currentAgent.path}/ [cancel]`, payload, data, resp.status);
456
+ const task = tasks.find(t => t.id === taskId);
457
+ if (task) { task.status = { state: 'canceled' }; renderTaskList(); }
458
+ } catch (e) { showError('Cancel failed: ' + e.message); }
459
+ }
460
+
461
+ function appendMessage(role, text, data) { clearEmpty(); const msgs = document.getElementById('messages'); const div = document.createElement('div'); div.className = `message ${role}`; if (data) div.innerHTML = `<pre>${escHtml(JSON.stringify(data, null, 2))}</pre>`; else div.textContent = text; msgs.appendChild(div); msgs.scrollTop = msgs.scrollHeight; }
462
+ function appendSystem(text) { const msgs = document.getElementById('messages'); const div = document.createElement('div'); div.className = 'message system'; div.textContent = text; msgs.appendChild(div); msgs.scrollTop = msgs.scrollHeight; }
463
+ function showError(text) { const msgs = document.getElementById('messages'); const div = document.createElement('div'); div.className = 'message error'; div.textContent = text; msgs.appendChild(div); msgs.scrollTop = msgs.scrollHeight; }
464
+ function showEmpty(text) { document.getElementById('messages').innerHTML = `<div class="empty-state"><svg viewBox="0 0 24 24" fill="none"><path d="M21 15a2 2 0 01-2 2H7l-4 4V5a2 2 0 012-2h14a2 2 0 012 2z" stroke="currentColor" stroke-width="1.5"/></svg><div>${escHtml(text)}</div></div>`; }
465
+ function showLoading() { clearEmpty(); const msgs = document.getElementById('messages'); const div = document.createElement('div'); div.className = 'loading'; div.id = 'loadingIndicator'; div.innerHTML = '<span></span><span></span><span></span>'; msgs.appendChild(div); msgs.scrollTop = msgs.scrollHeight; }
466
+ function hideLoading() { const el = document.getElementById('loadingIndicator'); if (el) el.remove(); }
467
+ function clearEmpty() { const e = document.querySelector('.empty-state'); if (e) e.remove(); }
468
+ function updateSendButton() { const b = document.getElementById('sendBtn'); b.disabled = sending; b.textContent = sending ? 'Sending...' : 'Send'; }
469
+ function handleKey(e) { if (e.key === 'Enter' && !e.shiftKey) { e.preventDefault(); sendMessage(); } }
470
+ function autoResize(el) { el.style.height = 'auto'; el.style.height = Math.min(el.scrollHeight, 140) + 'px'; }
471
+ function escHtml(s) { const d = document.createElement('div'); d.textContent = s; return d.innerHTML; }
472
+ /** JSON.stringify inside a double-quoted HTML attribute: encode quotes so a ' or " in the value cannot break out. */
473
+ function jsAttr(value) { return JSON.stringify(value).replace(/&/g, '&amp;').replace(/"/g, '&quot;'); }
474
+
475
+ init();
476
+ </script>
477
+ </body>
478
+ </html>
@@ -0,0 +1,46 @@
1
+ {
2
+ "$schema": "https://json-schema.org/draft/2019-09/schema",
3
+ "title": "Broker Deployment Settings Specification",
4
+ "$comment": "Owned by this CLI as a deploy-time contract; validated by the CLI's Ajv2019 validator. See docs/adr/0003.",
5
+ "$ref": "#/definitions/DeploymentSettings",
6
+ "definitions": {
7
+ "DeploymentSettings": {
8
+ "type": "object",
9
+ "additionalProperties": false,
10
+ "properties": {
11
+ "brokers": {
12
+ "$ref": "#/definitions/BrokerDeploymentSettings"
13
+ }
14
+ }
15
+ },
16
+ "BrokerDeploymentSettings": {
17
+ "type": "object",
18
+ "additionalProperties": false,
19
+ "properties": {
20
+ "vCores": {
21
+ "type": "number",
22
+ "exclusiveMinimum": 0
23
+ },
24
+ "resources.cpu.reserved": {
25
+ "type": "string"
26
+ },
27
+ "resources.cpu.limit": {
28
+ "type": "string"
29
+ },
30
+ "resources.memory.reserved": {
31
+ "type": "string"
32
+ },
33
+ "resources.memory.limit": {
34
+ "type": "string"
35
+ },
36
+ "logging.level": {
37
+ "enum": ["ERROR", "WARN", "INFO", "DEBUG", "TRACE"]
38
+ },
39
+ "runtimeVersion": {
40
+ "type": "string",
41
+ "pattern": "^[^:]+$"
42
+ }
43
+ }
44
+ }
45
+ }
46
+ }
@@ -372,6 +372,10 @@ export declare namespace AgentNetworkV2 {
372
372
  a2a: {
373
373
  card: Card;
374
374
  policies?: Policies;
375
+ authorization?: {
376
+ principal?: string;
377
+ allowAnonymousAccess?: boolean;
378
+ };
375
379
  };
376
380
  };
377
381
  ast: any;
@@ -1 +1 @@
1
- {"version":3,"file":"agent-network-v2.js","sourceRoot":"","sources":["../../src/types/agent-network-v2.ts"],"names":[],"mappings":";AAAA;;;;GAIG;;;AAmBH,gFAAgF;AAEhF,2DAA2D;AAC3D,IAAiB,cAAc,CAyZ9B;AAzZD,WAAiB,cAAc;IAyRhB,gCAAiB,GAAG,CAAC,YAA0B,EAAmC,EAAE;QAC/F,OAAO,KAAK,IAAI,YAAY,CAAA;IAC9B,CAAC,CAAA;IAEY,gCAAiB,GAAG,CAAC,YAA0B,EAAmC,EAAE;QAC/F,OAAO,KAAK,IAAI,YAAY,CAAA;IAC9B,CAAC,CAAA;IA6CY,iCAAkB,GAAG,CAAC,UAAsB,EAAkC,EAAE;QAC3F,OAAO,KAAK,IAAI,UAAU,CAAA;IAC5B,CAAC,CAAA;IA4BY,8BAAe,GAAG;QAC7B,GAAG,EAAE,KAAK;QACV,GAAG,EAAE,KAAK;QACV,GAAG,EAAE,KAAK;KACF,CAAA;AA2CZ,CAAC,EAzZgB,cAAc,8BAAd,cAAc,QAyZ9B"}
1
+ {"version":3,"file":"agent-network-v2.js","sourceRoot":"","sources":["../../src/types/agent-network-v2.ts"],"names":[],"mappings":";AAAA;;;;GAIG;;;AAmBH,gFAAgF;AAEhF,2DAA2D;AAC3D,IAAiB,cAAc,CA6Z9B;AA7ZD,WAAiB,cAAc;IAyRhB,gCAAiB,GAAG,CAAC,YAA0B,EAAmC,EAAE;QAC/F,OAAO,KAAK,IAAI,YAAY,CAAA;IAC9B,CAAC,CAAA;IAEY,gCAAiB,GAAG,CAAC,YAA0B,EAAmC,EAAE;QAC/F,OAAO,KAAK,IAAI,YAAY,CAAA;IAC9B,CAAC,CAAA;IA6CY,iCAAkB,GAAG,CAAC,UAAsB,EAAkC,EAAE;QAC3F,OAAO,KAAK,IAAI,UAAU,CAAA;IAC5B,CAAC,CAAA;IA4BY,8BAAe,GAAG;QAC7B,GAAG,EAAE,KAAK;QACV,GAAG,EAAE,KAAK;QACV,GAAG,EAAE,KAAK;KACF,CAAA;AA+CZ,CAAC,EA7ZgB,cAAc,8BAAd,cAAc,QA6Z9B"}
@@ -151,6 +151,7 @@ export type ExchangeDescriptor = GAV & {
151
151
  dependencies?: GAV[];
152
152
  tags?: string[];
153
153
  metadata?: {
154
+ toolingVersion?: number;
154
155
  variables?: NestedVariables;
155
156
  properties?: {
156
157
  [key: string]: string;
@@ -15,6 +15,7 @@ export declare function versionVariableKey(assetIdentity: {
15
15
  groupId: string;
16
16
  assetId: string;
17
17
  }): string;
18
+ export declare function validateNoReservedVersionVariableDeclarations(names: Iterable<string>): void;
18
19
  export declare function formatVersionSuffix(registry: {
19
20
  getVariable(id: string): string | undefined;
20
21
  }, asset: {
@@ -7,6 +7,7 @@
7
7
  Object.defineProperty(exports, "__esModule", { value: true });
8
8
  exports.networkLockPath = networkLockPath;
9
9
  exports.versionVariableKey = versionVariableKey;
10
+ exports.validateNoReservedVersionVariableDeclarations = validateNoReservedVersionVariableDeclarations;
10
11
  exports.formatVersionSuffix = formatVersionSuffix;
11
12
  exports.resolveVersionSlot = resolveVersionSlot;
12
13
  exports.parseLockKey = parseLockKey;
@@ -19,6 +20,7 @@ const fs = tslib_1.__importStar(require("node:fs"));
19
20
  const path = tslib_1.__importStar(require("node:path"));
20
21
  const crypto = tslib_1.__importStar(require("node:crypto"));
21
22
  const error_factory_1 = require("../../errors/error-factory");
23
+ const utils_1 = require("../../helpers/utils");
22
24
  const logger_1 = require("../logger");
23
25
  function networkLockPath(targetDir, networkAssetId) {
24
26
  if (!networkAssetId) {
@@ -29,6 +31,12 @@ function networkLockPath(targetDir, networkAssetId) {
29
31
  function versionVariableKey(assetIdentity) {
30
32
  return `__version:${assetIdentity.groupId}:${assetIdentity.assetId}`;
31
33
  }
34
+ function validateNoReservedVersionVariableDeclarations(names) {
35
+ const reserved = [...names].filter(name => name.startsWith('__version:')).sort();
36
+ if (reserved.length > 0) {
37
+ throw error_factory_1.ErrorFactory.genericError(`Variable namespace '__version:' is reserved for generated asset versions. Remove declarations: ${reserved.join(', ')}.`);
38
+ }
39
+ }
32
40
  function formatVersionSuffix(registry, asset) {
33
41
  const isPlaceholder = !asset.version || asset.version.startsWith('${');
34
42
  const version = isPlaceholder ? registry.getVariable(versionVariableKey(asset)) : asset.version;
@@ -36,7 +44,7 @@ function formatVersionSuffix(registry, asset) {
36
44
  }
37
45
  function resolveVersionSlot(assetIdentity, dependencies) {
38
46
  const matchingDep = dependencies.find(dep => dep.groupId === assetIdentity.groupId && dep.assetId === assetIdentity.assetId);
39
- return matchingDep ? matchingDep.version : `\${${versionVariableKey(assetIdentity)}}`;
47
+ return matchingDep && matchingDep.version !== utils_1.LOCAL_COMPONENT_VERSION ? matchingDep.version : `\${${versionVariableKey(assetIdentity)}}`;
40
48
  }
41
49
  function parseLockKey(key) {
42
50
  const parts = key.split(':');
@@ -62,17 +70,44 @@ function readNetworkLock(targetDir, networkAssetId) {
62
70
  logger_1.Log.debug(error);
63
71
  throw error_factory_1.ErrorFactory.networkLockMalformed(`Agent Network lock file for network '${networkAssetId}' contains malformed JSON. Please, build and then publish your Agent Network to regenerate it.`);
64
72
  }
65
- if (!lock.assetId || !lock.groupId) {
66
- throw error_factory_1.ErrorFactory.networkLockMalformed(`Agent Network lock file for network '${networkAssetId}' is missing required headers (assetId or groupId). Please, build and then publish your Agent Network to regenerate it.`);
73
+ if (!isRecord(lock)) {
74
+ throw malformedNetworkLock(networkAssetId, 'has invalid root (expected object)');
75
+ }
76
+ for (const header of ['assetId', 'groupId', 'version', 'versionGroup']) {
77
+ if (!isNonEmptyString(lock[header])) {
78
+ throw malformedNetworkLock(networkAssetId, `has invalid or missing '${header}' header`);
79
+ }
80
+ }
81
+ if (lock.assetId !== networkAssetId) {
82
+ throw malformedNetworkLock(networkAssetId, `has assetId '${lock.assetId}' that does not match the requested network`);
83
+ }
84
+ if (!isRecord(lock.assets)) {
85
+ throw malformedNetworkLock(networkAssetId, "has invalid 'assets' field (expected object)");
67
86
  }
68
- if (typeof lock.assets !== 'object' || lock.assets === null || Array.isArray(lock.assets)) {
69
- throw error_factory_1.ErrorFactory.networkLockMalformed(`Agent Network lock file for network '${networkAssetId}' has invalid 'assets' field (expected object, got ${Array.isArray(lock.assets) ? 'array' : typeof lock.assets}). Please, build and then publish your Agent Network to regenerate it.`);
87
+ for (const [key, asset] of Object.entries(lock.assets)) {
88
+ if (!isRecord(asset) || !isNonEmptyString(asset.versionGroup) || !isNonEmptyString(asset.version)) {
89
+ throw malformedNetworkLock(networkAssetId, `has invalid asset entry '${key}'`);
90
+ }
70
91
  }
71
92
  if (!Array.isArray(lock.dependencies)) {
72
- throw error_factory_1.ErrorFactory.networkLockMalformed(`Agent Network lock file for network '${networkAssetId}' has invalid 'dependencies' field (expected array, got ${typeof lock.dependencies}). Please, build and then publish your Agent Network to regenerate it.`);
93
+ throw malformedNetworkLock(networkAssetId, "has invalid 'dependencies' field (expected array)");
94
+ }
95
+ for (const dependency of lock.dependencies) {
96
+ if (!isRecord(dependency) || !isNonEmptyString(dependency.groupId) || !isNonEmptyString(dependency.assetId) || !isNonEmptyString(dependency.version)) {
97
+ throw malformedNetworkLock(networkAssetId, "has invalid 'dependencies' entry");
98
+ }
73
99
  }
74
100
  return lock;
75
101
  }
102
+ function isRecord(value) {
103
+ return typeof value === 'object' && value !== null && !Array.isArray(value);
104
+ }
105
+ function isNonEmptyString(value) {
106
+ return typeof value === 'string' && value.trim().length > 0;
107
+ }
108
+ function malformedNetworkLock(networkAssetId, reason) {
109
+ return error_factory_1.ErrorFactory.networkLockMalformed(`Agent Network lock file for network '${networkAssetId}' ${reason}. Please, build and then publish your Agent Network to regenerate it.`);
110
+ }
76
111
  function writeNetworkLock(targetDir, lock) {
77
112
  const lockPath = networkLockPath(targetDir, lock.assetId);
78
113
  fs.mkdirSync(path.dirname(lockPath), { recursive: true });