@openwop/openwop-conformance 2.35.0 → 2.36.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.
Files changed (123) hide show
  1. package/CHANGELOG.md +27 -0
  2. package/README.md +3 -3
  3. package/coverage.md +13 -1
  4. package/dist/lib/certification-bundle-v3.js +21 -4
  5. package/dist/spec-artifacts.lock.json +2 -2
  6. package/fixtures/a2ui-v09/negative-event-name-deleteall.json +139 -0
  7. package/fixtures/a2ui-v09/negative-extra-property.json +140 -0
  8. package/fixtures/a2ui-v09/negative-foreign-catalog.json +139 -0
  9. package/fixtures/a2ui-v09/negative-formatstring-label.json +145 -0
  10. package/fixtures/a2ui-v09/negative-functioncall-openurl.json +129 -0
  11. package/fixtures/a2ui-v09/negative-image-component.json +145 -0
  12. package/fixtures/a2ui-v09/negative-textfield-obscured.json +140 -0
  13. package/fixtures/a2ui-v09/negative-theme-iconurl.json +142 -0
  14. package/fixtures/a2ui-v09/positive-approve-brief.json +139 -0
  15. package/fixtures/conformance-artifact-emit.json +28 -0
  16. package/fixtures/conformance-clarification-nested.json +53 -0
  17. package/fixtures/conformance-clarification-sensitive.json +49 -0
  18. package/fixtures/conformance-credential.json +25 -0
  19. package/fixtures/conformance-mcp-client.json +28 -0
  20. package/fixtures/interrupt-payloads/interrupt-payload-approval.json +1 -0
  21. package/fixtures/interrupt-payloads/interrupt-payload-clarification.json +1 -0
  22. package/fixtures/interrupt-payloads/interrupt-payload-conversation-close.json +1 -0
  23. package/fixtures/interrupt-payloads/interrupt-payload-conversation-exchange.json +1 -0
  24. package/fixtures/interrupt-payloads/interrupt-payload-conversation-start.json +1 -0
  25. package/fixtures/interrupt-payloads/interrupt-payload-custom.json +1 -0
  26. package/fixtures/interrupt-payloads/interrupt-payload-external-event.json +1 -0
  27. package/fixtures/interrupt-payloads/interrupt-payload-low-confidence.json +1 -0
  28. package/fixtures/interrupt-payloads/negative-approval-with-clarification-data.json +1 -0
  29. package/fixtures/interrupt-payloads/negative-conversation-close-with-conversation-start-data.json +1 -0
  30. package/fixtures/interrupt-payloads/negative-conversation-start-with-conversation-exchange-data.json +1 -0
  31. package/fixtures/interrupt-payloads/negative-custom-with-conversation-start-data.json +1 -0
  32. package/fixtures/interrupt-payloads/negative-low-confidence-with-custom-data.json +1 -0
  33. package/fixtures/node-pack-runtime/negative-entry-mismatch.json +31 -0
  34. package/fixtures/node-pack-runtime/negative-headers.json +37 -0
  35. package/fixtures/node-pack-runtime/negative-http.json +31 -0
  36. package/fixtures/node-pack-runtime/negative-icons.json +37 -0
  37. package/fixtures/node-pack-runtime/negative-meta.json +36 -0
  38. package/fixtures/node-pack-runtime/negative-non-remote-language.json +31 -0
  39. package/fixtures/node-pack-runtime/negative-packages.json +41 -0
  40. package/fixtures/node-pack-runtime/negative-sse.json +31 -0
  41. package/fixtures/node-pack-runtime/negative-templated-url.json +31 -0
  42. package/fixtures/node-pack-runtime/negative-two-remotes.json +35 -0
  43. package/fixtures/node-pack-runtime/negative-variables.json +38 -0
  44. package/fixtures/node-pack-runtime/negative-version-range.json +31 -0
  45. package/fixtures/node-pack-runtime/positive-every-optional-member.json +40 -0
  46. package/fixtures/node-pack-runtime/positive-rfc-example.json +31 -0
  47. package/fixtures/node-pack-runtime/upstream/mcp-registry-server-2025-12-11.schema.json +574 -0
  48. package/fixtures/oauth-providers/synthetic.json +36 -4
  49. package/fixtures/upstream/a2a-v1.0.1/README.md +24 -0
  50. package/fixtures/upstream/a2a-v1.0.1/a2a.proto +811 -0
  51. package/fixtures/upstream/a2ui-v0.9/README.md +33 -0
  52. package/fixtures/upstream/a2ui-v0.9/catalog.json +1383 -0
  53. package/fixtures/upstream/a2ui-v0.9/common_types.json +305 -0
  54. package/fixtures/upstream/a2ui-v0.9/server_to_client.json +132 -0
  55. package/fixtures.md +139 -0
  56. package/package.json +2 -2
  57. package/requirements.json +4480 -97
  58. package/scenario-majors.json +93 -6
  59. package/schemas/CORPUS-STAMP.json +103 -89
  60. package/src/lib/behavior-gate.ts +7 -1
  61. package/src/lib/certification-bundle-v3.ts +18 -4
  62. package/src/lib/localized-content.ts +53 -0
  63. package/src/lib/mcp-fake-server.ts +105 -4
  64. package/src/lib/node-pack-runtime.ts +41 -0
  65. package/src/lib/oauth-as-double.ts +316 -0
  66. package/src/lib/protected-resource.ts +88 -0
  67. package/src/lib/standard-webhooks.ts +120 -0
  68. package/src/lib/toolCatalog.ts +54 -4
  69. package/src/lib/trace-context.ts +98 -0
  70. package/src/lib/v2.ts +6 -0
  71. package/src/lib/webhook-receiver.ts +201 -1
  72. package/src/scenarios/artifact-type-pack-manifest-validation.test.ts +10 -1
  73. package/src/scenarios/auth-challenge-no-oracle.test.ts +122 -0
  74. package/src/scenarios/auth-oauth2-client-credentials.test.ts +46 -5
  75. package/src/scenarios/cross-host-traceparent-propagation.test.ts +92 -58
  76. package/src/scenarios/debugBundle.test.ts +41 -0
  77. package/src/scenarios/fixtures-valid.test.ts +72 -0
  78. package/src/scenarios/inbound-credential-no-passthrough.test.ts +115 -0
  79. package/src/scenarios/interrupt-approver-routing.test.ts +3 -0
  80. package/src/scenarios/localized-content-delivery.test.ts +26 -15
  81. package/src/scenarios/mcp-current-auth-boundary.test.ts +38 -0
  82. package/src/scenarios/mcp-tool-roundtrip.test.ts +29 -0
  83. package/src/scenarios/otel-mcp-semconv-projection.test.ts +85 -0
  84. package/src/scenarios/tool-catalog-compact-projection.test.ts +28 -14
  85. package/src/scenarios/tool-catalog-projection.test.ts +48 -12
  86. package/src/scenarios/tool-descriptor-shape.test.ts +34 -13
  87. package/src/scenarios/v2-a2a-agent-cards.test.ts +305 -0
  88. package/src/scenarios/v2-a2a-operation-map.test.ts +310 -0
  89. package/src/scenarios/v2-a2ui-v09-surface.test.ts +283 -0
  90. package/src/scenarios/v2-advertised-fixtures-exist.test.ts +2 -2
  91. package/src/scenarios/v2-artifact-a2a-shape.test.ts +122 -0
  92. package/src/scenarios/v2-auth-challenge.test.ts +119 -0
  93. package/src/scenarios/v2-bound-id-kinds.test.ts +1 -1
  94. package/src/scenarios/v2-callback-url-guarded.test.ts +2 -2
  95. package/src/scenarios/v2-capability-maturity-bounded.test.ts +108 -0
  96. package/src/scenarios/v2-configurable-closed.test.ts +1 -1
  97. package/src/scenarios/v2-content-locale-keys.test.ts +92 -0
  98. package/src/scenarios/v2-conversation-turn-parts.test.ts +74 -0
  99. package/src/scenarios/v2-credential-interrupt.test.ts +253 -0
  100. package/src/scenarios/v2-effect-identity-business-key.test.ts +2 -2
  101. package/src/scenarios/v2-fork-a-v1-run.test.ts +1 -1
  102. package/src/scenarios/v2-implementation-informational.test.ts +33 -0
  103. package/src/scenarios/v2-interop-trace-context.test.ts +351 -0
  104. package/src/scenarios/v2-lane-exp-only-bound.test.ts +236 -0
  105. package/src/scenarios/v2-lane-issuer-advertised.test.ts +52 -3
  106. package/src/scenarios/v2-mcp-client-results.test.ts +202 -0
  107. package/src/scenarios/v2-mcp-mount-map.test.ts +308 -0
  108. package/src/scenarios/v2-mcp-tasks.test.ts +503 -0
  109. package/src/scenarios/v2-oauth-client-pkce-state-iss.test.ts +203 -0
  110. package/src/scenarios/v2-oauth-mcp-reach-discovery.test.ts +186 -0
  111. package/src/scenarios/v2-oidc-id-token-audience.test.ts +108 -0
  112. package/src/scenarios/v2-protected-resource-metadata.test.ts +145 -0
  113. package/src/scenarios/v2-run-cancel.test.ts +1 -1
  114. package/src/scenarios/v2-run-fork-prefix.test.ts +4 -4
  115. package/src/scenarios/v2-run-pause-resume.test.ts +1 -1
  116. package/src/scenarios/v2-tool-catalog-annotations.test.ts +100 -0
  117. package/src/scenarios/v2-unmapped-type-refused.test.ts +1 -1
  118. package/src/scenarios/v2-v1-events-translated.test.ts +1 -1
  119. package/src/scenarios/v2-webhook-egress-refusal.test.ts +5 -5
  120. package/src/scenarios/v2-webhook-endpoint-verification.test.ts +124 -0
  121. package/src/scenarios/v2-webhook-message-id-stable.test.ts +124 -0
  122. package/src/scenarios/v2-webhook-secret-rotation.test.ts +132 -0
  123. package/src/scenarios/v2-webhook-standard-webhooks-delivery.test.ts +195 -0
@@ -0,0 +1,1383 @@
1
+ {
2
+ "$schema": "https://json-schema.org/draft/2020-12/schema",
3
+ "$id": "https://a2ui.org/specification/v0_9/catalogs/basic/catalog.json",
4
+ "title": "A2UI Basic Catalog",
5
+ "description": "Unified catalog of basic A2UI components and functions.",
6
+ "catalogId": "https://a2ui.org/specification/v0_9/catalogs/basic/catalog.json",
7
+ "components": {
8
+ "Text": {
9
+ "type": "object",
10
+ "allOf": [
11
+ {
12
+ "$ref": "https://a2ui.org/specification/v0_9/common_types.json#/$defs/ComponentCommon"
13
+ },
14
+ {
15
+ "$ref": "#/$defs/CatalogComponentCommon"
16
+ },
17
+ {
18
+ "type": "object",
19
+ "properties": {
20
+ "component": {
21
+ "const": "Text"
22
+ },
23
+ "text": {
24
+ "$ref": "https://a2ui.org/specification/v0_9/common_types.json#/$defs/DynamicString",
25
+ "description": "The text content to display. While simple Markdown formatting is supported (i.e. without HTML, images, or links), utilizing dedicated UI components is generally preferred for a richer and more structured presentation."
26
+ },
27
+ "variant": {
28
+ "type": "string",
29
+ "description": "A hint for the base text style.",
30
+ "enum": ["h1", "h2", "h3", "h4", "h5", "caption", "body"],
31
+ "default": "body"
32
+ }
33
+ },
34
+ "required": ["component", "text"]
35
+ }
36
+ ],
37
+ "unevaluatedProperties": false
38
+ },
39
+ "Image": {
40
+ "type": "object",
41
+ "allOf": [
42
+ {
43
+ "$ref": "https://a2ui.org/specification/v0_9/common_types.json#/$defs/ComponentCommon"
44
+ },
45
+ {
46
+ "$ref": "#/$defs/CatalogComponentCommon"
47
+ },
48
+ {
49
+ "type": "object",
50
+ "properties": {
51
+ "component": {
52
+ "const": "Image"
53
+ },
54
+ "url": {
55
+ "$ref": "https://a2ui.org/specification/v0_9/common_types.json#/$defs/DynamicString",
56
+ "description": "The URL of the image to display."
57
+ },
58
+ "description": {
59
+ "$ref": "https://a2ui.org/specification/v0_9/common_types.json#/$defs/DynamicString",
60
+ "description": "Accessibility text for the image."
61
+ },
62
+ "fit": {
63
+ "type": "string",
64
+ "description": "Specifies how the image should be resized to fit its container. This corresponds to the CSS 'object-fit' property.",
65
+ "enum": ["contain", "cover", "fill", "none", "scaleDown"],
66
+ "default": "fill"
67
+ },
68
+ "variant": {
69
+ "type": "string",
70
+ "description": "A hint for the image size and style.",
71
+ "enum": ["icon", "avatar", "smallFeature", "mediumFeature", "largeFeature", "header"],
72
+ "default": "mediumFeature"
73
+ }
74
+ },
75
+ "required": ["component", "url"]
76
+ }
77
+ ],
78
+ "unevaluatedProperties": false
79
+ },
80
+ "Icon": {
81
+ "type": "object",
82
+ "allOf": [
83
+ {
84
+ "$ref": "https://a2ui.org/specification/v0_9/common_types.json#/$defs/ComponentCommon"
85
+ },
86
+ {
87
+ "$ref": "#/$defs/CatalogComponentCommon"
88
+ },
89
+ {
90
+ "type": "object",
91
+ "properties": {
92
+ "component": {
93
+ "const": "Icon"
94
+ },
95
+ "name": {
96
+ "description": "The name of the icon to display.",
97
+ "oneOf": [
98
+ {
99
+ "type": "string",
100
+ "enum": [
101
+ "accountCircle",
102
+ "add",
103
+ "arrowBack",
104
+ "arrowForward",
105
+ "attachFile",
106
+ "calendarToday",
107
+ "call",
108
+ "camera",
109
+ "check",
110
+ "close",
111
+ "delete",
112
+ "download",
113
+ "edit",
114
+ "event",
115
+ "error",
116
+ "fastForward",
117
+ "favorite",
118
+ "favoriteOff",
119
+ "folder",
120
+ "help",
121
+ "home",
122
+ "info",
123
+ "locationOn",
124
+ "lock",
125
+ "lockOpen",
126
+ "mail",
127
+ "menu",
128
+ "moreVert",
129
+ "moreHoriz",
130
+ "notificationsOff",
131
+ "notifications",
132
+ "pause",
133
+ "payment",
134
+ "person",
135
+ "phone",
136
+ "photo",
137
+ "play",
138
+ "print",
139
+ "refresh",
140
+ "rewind",
141
+ "search",
142
+ "send",
143
+ "settings",
144
+ "share",
145
+ "shoppingCart",
146
+ "skipNext",
147
+ "skipPrevious",
148
+ "star",
149
+ "starHalf",
150
+ "starOff",
151
+ "stop",
152
+ "upload",
153
+ "visibility",
154
+ "visibilityOff",
155
+ "volumeDown",
156
+ "volumeMute",
157
+ "volumeOff",
158
+ "volumeUp",
159
+ "warning"
160
+ ]
161
+ },
162
+ {
163
+ "type": "object",
164
+ "properties": {
165
+ "svgPath": {
166
+ "type": "string"
167
+ }
168
+ },
169
+ "required": ["svgPath"],
170
+ "additionalProperties": false
171
+ },
172
+ {
173
+ "$ref": "https://a2ui.org/specification/v0_9/common_types.json#/$defs/DataBinding"
174
+ }
175
+ ]
176
+ }
177
+ },
178
+ "required": ["component", "name"]
179
+ }
180
+ ],
181
+ "unevaluatedProperties": false
182
+ },
183
+ "Video": {
184
+ "type": "object",
185
+ "allOf": [
186
+ {
187
+ "$ref": "https://a2ui.org/specification/v0_9/common_types.json#/$defs/ComponentCommon"
188
+ },
189
+ {
190
+ "$ref": "#/$defs/CatalogComponentCommon"
191
+ },
192
+ {
193
+ "type": "object",
194
+ "properties": {
195
+ "component": {
196
+ "const": "Video"
197
+ },
198
+ "url": {
199
+ "$ref": "https://a2ui.org/specification/v0_9/common_types.json#/$defs/DynamicString",
200
+ "description": "The URL of the video to display."
201
+ }
202
+ },
203
+ "required": ["component", "url"]
204
+ }
205
+ ],
206
+ "unevaluatedProperties": false
207
+ },
208
+ "AudioPlayer": {
209
+ "type": "object",
210
+ "allOf": [
211
+ {
212
+ "$ref": "https://a2ui.org/specification/v0_9/common_types.json#/$defs/ComponentCommon"
213
+ },
214
+ {
215
+ "$ref": "#/$defs/CatalogComponentCommon"
216
+ },
217
+ {
218
+ "type": "object",
219
+ "properties": {
220
+ "component": {
221
+ "const": "AudioPlayer"
222
+ },
223
+ "url": {
224
+ "$ref": "https://a2ui.org/specification/v0_9/common_types.json#/$defs/DynamicString",
225
+ "description": "The URL of the audio to be played."
226
+ },
227
+ "description": {
228
+ "description": "A description of the audio, such as a title or summary.",
229
+ "$ref": "https://a2ui.org/specification/v0_9/common_types.json#/$defs/DynamicString"
230
+ }
231
+ },
232
+ "required": ["component", "url"]
233
+ }
234
+ ],
235
+ "unevaluatedProperties": false
236
+ },
237
+ "Row": {
238
+ "type": "object",
239
+ "allOf": [
240
+ {
241
+ "$ref": "https://a2ui.org/specification/v0_9/common_types.json#/$defs/ComponentCommon"
242
+ },
243
+ {
244
+ "$ref": "#/$defs/CatalogComponentCommon"
245
+ },
246
+ {
247
+ "type": "object",
248
+ "description": "A layout component that arranges its children horizontally. To create a grid layout, nest Columns within this Row.",
249
+ "properties": {
250
+ "component": {
251
+ "const": "Row"
252
+ },
253
+ "children": {
254
+ "description": "Defines the children. Use an array of strings for a fixed set of children, or a template object to generate children from a data list. Children cannot be defined inline, they must be referred to by ID.",
255
+ "$ref": "https://a2ui.org/specification/v0_9/common_types.json#/$defs/ChildList"
256
+ },
257
+ "justify": {
258
+ "type": "string",
259
+ "description": "Defines the arrangement of children along the main axis (horizontally). Use 'spaceBetween' to push items to the edges, or 'start'/'end'/'center' to pack them together.",
260
+ "enum": [
261
+ "center",
262
+ "end",
263
+ "spaceAround",
264
+ "spaceBetween",
265
+ "spaceEvenly",
266
+ "start",
267
+ "stretch"
268
+ ],
269
+ "default": "start"
270
+ },
271
+ "align": {
272
+ "type": "string",
273
+ "description": "Defines the alignment of children along the cross axis (vertically). This is similar to the CSS 'align-items' property, but uses camelCase values (e.g., 'start').",
274
+ "enum": ["start", "center", "end", "stretch"],
275
+ "default": "stretch"
276
+ }
277
+ },
278
+ "required": ["component", "children"]
279
+ }
280
+ ],
281
+ "unevaluatedProperties": false
282
+ },
283
+ "Column": {
284
+ "type": "object",
285
+ "allOf": [
286
+ {
287
+ "$ref": "https://a2ui.org/specification/v0_9/common_types.json#/$defs/ComponentCommon"
288
+ },
289
+ {
290
+ "$ref": "#/$defs/CatalogComponentCommon"
291
+ },
292
+ {
293
+ "type": "object",
294
+ "description": "A layout component that arranges its children vertically. To create a grid layout, nest Rows within this Column.",
295
+ "properties": {
296
+ "component": {
297
+ "const": "Column"
298
+ },
299
+ "children": {
300
+ "description": "Defines the children. Use an array of strings for a fixed set of children, or a template object to generate children from a data list. Children cannot be defined inline, they must be referred to by ID.",
301
+ "$ref": "https://a2ui.org/specification/v0_9/common_types.json#/$defs/ChildList"
302
+ },
303
+ "justify": {
304
+ "type": "string",
305
+ "description": "Defines the arrangement of children along the main axis (vertically). Use 'spaceBetween' to push items to the edges (e.g. header at top, footer at bottom), or 'start'/'end'/'center' to pack them together.",
306
+ "enum": [
307
+ "start",
308
+ "center",
309
+ "end",
310
+ "spaceBetween",
311
+ "spaceAround",
312
+ "spaceEvenly",
313
+ "stretch"
314
+ ],
315
+ "default": "start"
316
+ },
317
+ "align": {
318
+ "type": "string",
319
+ "description": "Defines the alignment of children along the cross axis (horizontally). This is similar to the CSS 'align-items' property.",
320
+ "enum": ["center", "end", "start", "stretch"],
321
+ "default": "stretch"
322
+ }
323
+ },
324
+ "required": ["component", "children"]
325
+ }
326
+ ],
327
+ "unevaluatedProperties": false
328
+ },
329
+ "List": {
330
+ "type": "object",
331
+ "allOf": [
332
+ {
333
+ "$ref": "https://a2ui.org/specification/v0_9/common_types.json#/$defs/ComponentCommon"
334
+ },
335
+ {
336
+ "$ref": "#/$defs/CatalogComponentCommon"
337
+ },
338
+ {
339
+ "type": "object",
340
+ "properties": {
341
+ "component": {
342
+ "const": "List"
343
+ },
344
+ "children": {
345
+ "description": "Defines the children. Use an array of strings for a fixed set of children, or a template object to generate children from a data list.",
346
+ "$ref": "https://a2ui.org/specification/v0_9/common_types.json#/$defs/ChildList"
347
+ },
348
+ "direction": {
349
+ "type": "string",
350
+ "description": "The direction in which the list items are laid out.",
351
+ "enum": ["vertical", "horizontal"],
352
+ "default": "vertical"
353
+ },
354
+ "align": {
355
+ "type": "string",
356
+ "description": "Defines the alignment of children along the cross axis.",
357
+ "enum": ["start", "center", "end", "stretch"],
358
+ "default": "stretch"
359
+ }
360
+ },
361
+ "required": ["component", "children"]
362
+ }
363
+ ],
364
+ "unevaluatedProperties": false
365
+ },
366
+ "Card": {
367
+ "type": "object",
368
+ "allOf": [
369
+ {
370
+ "$ref": "https://a2ui.org/specification/v0_9/common_types.json#/$defs/ComponentCommon"
371
+ },
372
+ {
373
+ "$ref": "#/$defs/CatalogComponentCommon"
374
+ },
375
+ {
376
+ "type": "object",
377
+ "properties": {
378
+ "component": {
379
+ "const": "Card"
380
+ },
381
+ "child": {
382
+ "$ref": "https://a2ui.org/specification/v0_9/common_types.json#/$defs/ComponentId",
383
+ "description": "The ID of the single child component to be rendered inside the card. To display multiple elements, you MUST wrap them in a layout component (like Column or Row) and pass that container's ID here. Do NOT pass multiple IDs or a non-existent ID."
384
+ }
385
+ },
386
+ "required": ["component", "child"]
387
+ }
388
+ ],
389
+ "unevaluatedProperties": false
390
+ },
391
+ "Tabs": {
392
+ "type": "object",
393
+ "allOf": [
394
+ {
395
+ "$ref": "https://a2ui.org/specification/v0_9/common_types.json#/$defs/ComponentCommon"
396
+ },
397
+ {
398
+ "$ref": "#/$defs/CatalogComponentCommon"
399
+ },
400
+ {
401
+ "type": "object",
402
+ "properties": {
403
+ "component": {
404
+ "const": "Tabs"
405
+ },
406
+ "tabs": {
407
+ "type": "array",
408
+ "description": "An array of objects, where each object defines a tab with a title and a child component.",
409
+ "minItems": 1,
410
+ "items": {
411
+ "type": "object",
412
+ "properties": {
413
+ "title": {
414
+ "description": "The tab title.",
415
+ "$ref": "https://a2ui.org/specification/v0_9/common_types.json#/$defs/DynamicString"
416
+ },
417
+ "child": {
418
+ "$ref": "https://a2ui.org/specification/v0_9/common_types.json#/$defs/ComponentId",
419
+ "description": "The ID of the child component."
420
+ }
421
+ },
422
+ "required": ["title", "child"],
423
+ "additionalProperties": false
424
+ }
425
+ }
426
+ },
427
+ "required": ["component", "tabs"]
428
+ }
429
+ ],
430
+ "unevaluatedProperties": false
431
+ },
432
+ "Modal": {
433
+ "type": "object",
434
+ "allOf": [
435
+ {
436
+ "$ref": "https://a2ui.org/specification/v0_9/common_types.json#/$defs/ComponentCommon"
437
+ },
438
+ {
439
+ "$ref": "#/$defs/CatalogComponentCommon"
440
+ },
441
+ {
442
+ "type": "object",
443
+ "properties": {
444
+ "component": {
445
+ "const": "Modal"
446
+ },
447
+ "trigger": {
448
+ "$ref": "https://a2ui.org/specification/v0_9/common_types.json#/$defs/ComponentId",
449
+ "description": "The ID of the component that opens the modal when interacted with (e.g., a button)."
450
+ },
451
+ "content": {
452
+ "$ref": "https://a2ui.org/specification/v0_9/common_types.json#/$defs/ComponentId",
453
+ "description": "The ID of the component to be displayed inside the modal."
454
+ }
455
+ },
456
+ "required": ["component", "trigger", "content"]
457
+ }
458
+ ],
459
+ "unevaluatedProperties": false
460
+ },
461
+ "Divider": {
462
+ "type": "object",
463
+ "allOf": [
464
+ {
465
+ "$ref": "https://a2ui.org/specification/v0_9/common_types.json#/$defs/ComponentCommon"
466
+ },
467
+ {
468
+ "$ref": "#/$defs/CatalogComponentCommon"
469
+ },
470
+ {
471
+ "type": "object",
472
+ "properties": {
473
+ "component": {
474
+ "const": "Divider"
475
+ },
476
+ "axis": {
477
+ "type": "string",
478
+ "description": "The orientation of the divider.",
479
+ "enum": ["horizontal", "vertical"],
480
+ "default": "horizontal"
481
+ }
482
+ },
483
+ "required": ["component"]
484
+ }
485
+ ],
486
+ "unevaluatedProperties": false
487
+ },
488
+ "Button": {
489
+ "type": "object",
490
+ "allOf": [
491
+ {
492
+ "$ref": "https://a2ui.org/specification/v0_9/common_types.json#/$defs/ComponentCommon"
493
+ },
494
+ {
495
+ "$ref": "#/$defs/CatalogComponentCommon"
496
+ },
497
+ {
498
+ "$ref": "https://a2ui.org/specification/v0_9/common_types.json#/$defs/Checkable"
499
+ },
500
+ {
501
+ "type": "object",
502
+ "properties": {
503
+ "component": {
504
+ "const": "Button"
505
+ },
506
+ "child": {
507
+ "$ref": "https://a2ui.org/specification/v0_9/common_types.json#/$defs/ComponentId",
508
+ "description": "The ID of the child component. Use a 'Text' component for a labeled button. Only use an 'Icon' if the requirements explicitly ask for an icon-only button."
509
+ },
510
+ "variant": {
511
+ "type": "string",
512
+ "description": "A hint for the button style. If omitted, a default button style is used. 'primary' indicates this is the main call-to-action button. 'borderless' means the button has no visual border or background, making its child content appear like a clickable link.",
513
+ "enum": ["default", "primary", "borderless"],
514
+ "default": "default"
515
+ },
516
+ "action": {
517
+ "$ref": "https://a2ui.org/specification/v0_9/common_types.json#/$defs/Action"
518
+ }
519
+ },
520
+ "required": ["component", "child", "action"]
521
+ }
522
+ ],
523
+ "unevaluatedProperties": false
524
+ },
525
+ "TextField": {
526
+ "type": "object",
527
+ "allOf": [
528
+ {
529
+ "$ref": "https://a2ui.org/specification/v0_9/common_types.json#/$defs/ComponentCommon"
530
+ },
531
+ {
532
+ "$ref": "#/$defs/CatalogComponentCommon"
533
+ },
534
+ {
535
+ "$ref": "https://a2ui.org/specification/v0_9/common_types.json#/$defs/Checkable"
536
+ },
537
+ {
538
+ "type": "object",
539
+ "properties": {
540
+ "component": {
541
+ "const": "TextField"
542
+ },
543
+ "label": {
544
+ "$ref": "https://a2ui.org/specification/v0_9/common_types.json#/$defs/DynamicString",
545
+ "description": "The text label for the input field."
546
+ },
547
+ "value": {
548
+ "$ref": "https://a2ui.org/specification/v0_9/common_types.json#/$defs/DynamicString",
549
+ "description": "The value of the text field."
550
+ },
551
+ "variant": {
552
+ "type": "string",
553
+ "description": "The type of input field to display.",
554
+ "enum": ["longText", "number", "shortText", "obscured"],
555
+ "default": "shortText"
556
+ },
557
+ "validationRegexp": {
558
+ "type": "string",
559
+ "description": "A regular expression used for client-side validation of the input."
560
+ }
561
+ },
562
+ "required": ["component", "label"]
563
+ }
564
+ ],
565
+ "unevaluatedProperties": false
566
+ },
567
+ "CheckBox": {
568
+ "type": "object",
569
+ "allOf": [
570
+ {
571
+ "$ref": "https://a2ui.org/specification/v0_9/common_types.json#/$defs/ComponentCommon"
572
+ },
573
+ {
574
+ "$ref": "#/$defs/CatalogComponentCommon"
575
+ },
576
+ {
577
+ "$ref": "https://a2ui.org/specification/v0_9/common_types.json#/$defs/Checkable"
578
+ },
579
+ {
580
+ "type": "object",
581
+ "properties": {
582
+ "component": {
583
+ "const": "CheckBox"
584
+ },
585
+ "label": {
586
+ "$ref": "https://a2ui.org/specification/v0_9/common_types.json#/$defs/DynamicString",
587
+ "description": "The text to display next to the checkbox."
588
+ },
589
+ "value": {
590
+ "$ref": "https://a2ui.org/specification/v0_9/common_types.json#/$defs/DynamicBoolean",
591
+ "description": "The current state of the checkbox (true for checked, false for unchecked)."
592
+ }
593
+ },
594
+ "required": ["component", "label", "value"]
595
+ }
596
+ ],
597
+ "unevaluatedProperties": false
598
+ },
599
+ "ChoicePicker": {
600
+ "type": "object",
601
+ "allOf": [
602
+ {
603
+ "$ref": "https://a2ui.org/specification/v0_9/common_types.json#/$defs/ComponentCommon"
604
+ },
605
+ {
606
+ "$ref": "#/$defs/CatalogComponentCommon"
607
+ },
608
+ {
609
+ "$ref": "https://a2ui.org/specification/v0_9/common_types.json#/$defs/Checkable"
610
+ },
611
+ {
612
+ "type": "object",
613
+ "description": "A component that allows selecting one or more options from a list.",
614
+ "properties": {
615
+ "component": {
616
+ "const": "ChoicePicker"
617
+ },
618
+ "label": {
619
+ "$ref": "https://a2ui.org/specification/v0_9/common_types.json#/$defs/DynamicString",
620
+ "description": "The label for the group of options."
621
+ },
622
+ "variant": {
623
+ "type": "string",
624
+ "description": "A hint for how the choice picker should be displayed and behave.",
625
+ "enum": ["multipleSelection", "mutuallyExclusive"],
626
+ "default": "mutuallyExclusive"
627
+ },
628
+ "options": {
629
+ "type": "array",
630
+ "description": "The list of available options to choose from.",
631
+ "items": {
632
+ "type": "object",
633
+ "properties": {
634
+ "label": {
635
+ "description": "The text to display for this option.",
636
+ "$ref": "https://a2ui.org/specification/v0_9/common_types.json#/$defs/DynamicString"
637
+ },
638
+ "value": {
639
+ "type": "string",
640
+ "description": "The stable value associated with this option."
641
+ }
642
+ },
643
+ "required": ["label", "value"],
644
+ "additionalProperties": false
645
+ }
646
+ },
647
+ "value": {
648
+ "$ref": "https://a2ui.org/specification/v0_9/common_types.json#/$defs/DynamicStringList",
649
+ "description": "The list of currently selected values. This should be bound to a string array in the data model."
650
+ },
651
+ "displayStyle": {
652
+ "type": "string",
653
+ "description": "The display style of the component.",
654
+ "enum": ["checkbox", "chips"],
655
+ "default": "checkbox"
656
+ },
657
+ "filterable": {
658
+ "type": "boolean",
659
+ "description": "If true, displays a search input to filter the options.",
660
+ "default": false
661
+ }
662
+ },
663
+ "required": ["component", "options", "value"]
664
+ }
665
+ ],
666
+ "unevaluatedProperties": false
667
+ },
668
+ "Slider": {
669
+ "type": "object",
670
+ "allOf": [
671
+ {
672
+ "$ref": "https://a2ui.org/specification/v0_9/common_types.json#/$defs/ComponentCommon"
673
+ },
674
+ {
675
+ "$ref": "#/$defs/CatalogComponentCommon"
676
+ },
677
+ {
678
+ "$ref": "https://a2ui.org/specification/v0_9/common_types.json#/$defs/Checkable"
679
+ },
680
+ {
681
+ "type": "object",
682
+ "properties": {
683
+ "component": {
684
+ "const": "Slider"
685
+ },
686
+ "label": {
687
+ "$ref": "https://a2ui.org/specification/v0_9/common_types.json#/$defs/DynamicString",
688
+ "description": "The label for the slider."
689
+ },
690
+ "min": {
691
+ "type": "number",
692
+ "description": "The minimum value of the slider.",
693
+ "default": 0
694
+ },
695
+ "max": {
696
+ "type": "number",
697
+ "description": "The maximum value of the slider."
698
+ },
699
+ "value": {
700
+ "$ref": "https://a2ui.org/specification/v0_9/common_types.json#/$defs/DynamicNumber",
701
+ "description": "The current value of the slider."
702
+ }
703
+ },
704
+ "required": ["component", "value", "max"]
705
+ }
706
+ ],
707
+ "unevaluatedProperties": false
708
+ },
709
+ "DateTimeInput": {
710
+ "type": "object",
711
+ "allOf": [
712
+ {
713
+ "$ref": "https://a2ui.org/specification/v0_9/common_types.json#/$defs/ComponentCommon"
714
+ },
715
+ {
716
+ "$ref": "#/$defs/CatalogComponentCommon"
717
+ },
718
+ {
719
+ "$ref": "https://a2ui.org/specification/v0_9/common_types.json#/$defs/Checkable"
720
+ },
721
+ {
722
+ "type": "object",
723
+ "properties": {
724
+ "component": {
725
+ "const": "DateTimeInput"
726
+ },
727
+ "value": {
728
+ "$ref": "https://a2ui.org/specification/v0_9/common_types.json#/$defs/DynamicString",
729
+ "description": "The selected date and/or time value in ISO 8601 format. If not yet set, initialize with an empty string."
730
+ },
731
+ "enableDate": {
732
+ "type": "boolean",
733
+ "description": "If true, allows the user to select a date.",
734
+ "default": false
735
+ },
736
+ "enableTime": {
737
+ "type": "boolean",
738
+ "description": "If true, allows the user to select a time.",
739
+ "default": false
740
+ },
741
+ "min": {
742
+ "allOf": [
743
+ {
744
+ "$ref": "https://a2ui.org/specification/v0_9/common_types.json#/$defs/DynamicString"
745
+ },
746
+ {
747
+ "if": {
748
+ "type": "string"
749
+ },
750
+ "then": {
751
+ "oneOf": [
752
+ {
753
+ "format": "date"
754
+ },
755
+ {
756
+ "format": "time"
757
+ },
758
+ {
759
+ "format": "date-time"
760
+ }
761
+ ]
762
+ }
763
+ }
764
+ ],
765
+ "description": "The minimum allowed date/time in ISO 8601 format."
766
+ },
767
+ "max": {
768
+ "allOf": [
769
+ {
770
+ "$ref": "https://a2ui.org/specification/v0_9/common_types.json#/$defs/DynamicString"
771
+ },
772
+ {
773
+ "if": {
774
+ "type": "string"
775
+ },
776
+ "then": {
777
+ "oneOf": [
778
+ {
779
+ "format": "date"
780
+ },
781
+ {
782
+ "format": "time"
783
+ },
784
+ {
785
+ "format": "date-time"
786
+ }
787
+ ]
788
+ }
789
+ }
790
+ ],
791
+ "description": "The maximum allowed date/time in ISO 8601 format."
792
+ },
793
+ "label": {
794
+ "$ref": "https://a2ui.org/specification/v0_9/common_types.json#/$defs/DynamicString",
795
+ "description": "The text label for the input field."
796
+ }
797
+ },
798
+ "required": ["component", "value"]
799
+ }
800
+ ],
801
+ "unevaluatedProperties": false
802
+ }
803
+ },
804
+ "functions": {
805
+ "required": {
806
+ "type": "object",
807
+ "description": "Checks that the value is not null, undefined, or empty.",
808
+ "properties": {
809
+ "call": {
810
+ "const": "required"
811
+ },
812
+ "args": {
813
+ "type": "object",
814
+ "properties": {
815
+ "value": {
816
+ "description": "The value to check."
817
+ }
818
+ },
819
+ "required": ["value"],
820
+ "additionalProperties": false
821
+ },
822
+ "returnType": {
823
+ "const": "boolean"
824
+ }
825
+ },
826
+ "required": ["call", "args"],
827
+ "unevaluatedProperties": false
828
+ },
829
+ "regex": {
830
+ "type": "object",
831
+ "description": "Checks that the value matches a regular expression string.",
832
+ "properties": {
833
+ "call": {
834
+ "const": "regex"
835
+ },
836
+ "args": {
837
+ "type": "object",
838
+ "properties": {
839
+ "value": {
840
+ "$ref": "https://a2ui.org/specification/v0_9/common_types.json#/$defs/DynamicString"
841
+ },
842
+ "pattern": {
843
+ "type": "string",
844
+ "description": "The regex pattern to match against."
845
+ }
846
+ },
847
+ "required": ["value", "pattern"],
848
+ "unevaluatedProperties": false
849
+ },
850
+ "returnType": {
851
+ "const": "boolean"
852
+ }
853
+ },
854
+ "required": ["call", "args"],
855
+ "unevaluatedProperties": false
856
+ },
857
+ "length": {
858
+ "type": "object",
859
+ "description": "Checks string length constraints.",
860
+ "properties": {
861
+ "call": {
862
+ "const": "length"
863
+ },
864
+ "args": {
865
+ "type": "object",
866
+ "properties": {
867
+ "value": {
868
+ "$ref": "https://a2ui.org/specification/v0_9/common_types.json#/$defs/DynamicString"
869
+ },
870
+ "min": {
871
+ "type": "integer",
872
+ "minimum": 0,
873
+ "description": "The minimum allowed length."
874
+ },
875
+ "max": {
876
+ "type": "integer",
877
+ "minimum": 0,
878
+ "description": "The maximum allowed length."
879
+ }
880
+ },
881
+ "required": ["value"],
882
+ "anyOf": [
883
+ {
884
+ "required": ["min"]
885
+ },
886
+ {
887
+ "required": ["max"]
888
+ }
889
+ ],
890
+ "unevaluatedProperties": false
891
+ },
892
+ "returnType": {
893
+ "const": "boolean"
894
+ }
895
+ },
896
+ "required": ["call", "args"],
897
+ "unevaluatedProperties": false
898
+ },
899
+ "numeric": {
900
+ "type": "object",
901
+ "description": "Checks numeric range constraints.",
902
+ "properties": {
903
+ "call": {
904
+ "const": "numeric"
905
+ },
906
+ "args": {
907
+ "type": "object",
908
+ "properties": {
909
+ "value": {
910
+ "$ref": "https://a2ui.org/specification/v0_9/common_types.json#/$defs/DynamicNumber"
911
+ },
912
+ "min": {
913
+ "type": "number",
914
+ "description": "The minimum allowed value."
915
+ },
916
+ "max": {
917
+ "type": "number",
918
+ "description": "The maximum allowed value."
919
+ }
920
+ },
921
+ "required": ["value"],
922
+ "anyOf": [
923
+ {
924
+ "required": ["min"]
925
+ },
926
+ {
927
+ "required": ["max"]
928
+ }
929
+ ],
930
+ "unevaluatedProperties": false
931
+ },
932
+ "returnType": {
933
+ "const": "boolean"
934
+ }
935
+ },
936
+ "required": ["call", "args"],
937
+ "unevaluatedProperties": false
938
+ },
939
+ "email": {
940
+ "type": "object",
941
+ "description": "Checks that the value is a valid email address.",
942
+ "properties": {
943
+ "call": {
944
+ "const": "email"
945
+ },
946
+ "args": {
947
+ "type": "object",
948
+ "properties": {
949
+ "value": {
950
+ "$ref": "https://a2ui.org/specification/v0_9/common_types.json#/$defs/DynamicString"
951
+ }
952
+ },
953
+ "required": ["value"],
954
+ "unevaluatedProperties": false
955
+ },
956
+ "returnType": {
957
+ "const": "boolean"
958
+ }
959
+ },
960
+ "required": ["call", "args"],
961
+ "unevaluatedProperties": false
962
+ },
963
+ "formatString": {
964
+ "type": "object",
965
+ "description": "Performs string interpolation of data model values and other functions in the catalog functions list and returns the resulting string. The value string can contain interpolated expressions in the `${expression}` format. Supported expression types include: JSON Pointer paths to the data model (e.g., `${/absolute/path}` or `${relative/path}`), and client-side function calls (e.g., `${now()}`). Function arguments must be named (e.g., `${formatDate(value:${/currentDate}, format:'MM-dd')}`). To include a literal `${` sequence, escape it as `\\${`.",
966
+ "properties": {
967
+ "call": {
968
+ "const": "formatString"
969
+ },
970
+ "args": {
971
+ "type": "object",
972
+ "properties": {
973
+ "value": {
974
+ "$ref": "https://a2ui.org/specification/v0_9/common_types.json#/$defs/DynamicString"
975
+ }
976
+ },
977
+ "required": ["value"],
978
+ "unevaluatedProperties": false
979
+ },
980
+ "returnType": {
981
+ "const": "string"
982
+ }
983
+ },
984
+ "required": ["call", "args"],
985
+ "unevaluatedProperties": false
986
+ },
987
+ "formatNumber": {
988
+ "type": "object",
989
+ "description": "Formats a number with the specified grouping and decimal precision.",
990
+ "properties": {
991
+ "call": {
992
+ "const": "formatNumber"
993
+ },
994
+ "args": {
995
+ "type": "object",
996
+ "properties": {
997
+ "value": {
998
+ "$ref": "https://a2ui.org/specification/v0_9/common_types.json#/$defs/DynamicNumber",
999
+ "description": "The number to format."
1000
+ },
1001
+ "decimals": {
1002
+ "$ref": "https://a2ui.org/specification/v0_9/common_types.json#/$defs/DynamicNumber",
1003
+ "description": "Optional. The number of decimal places to show. Defaults to 0 or 2 depending on locale."
1004
+ },
1005
+ "grouping": {
1006
+ "$ref": "https://a2ui.org/specification/v0_9/common_types.json#/$defs/DynamicBoolean",
1007
+ "description": "Optional. If true, uses locale-specific grouping separators (e.g. '1,000'). If false, returns raw digits (e.g. '1000'). Defaults to true."
1008
+ }
1009
+ },
1010
+ "required": ["value"],
1011
+ "unevaluatedProperties": false
1012
+ },
1013
+ "returnType": {
1014
+ "const": "string"
1015
+ }
1016
+ },
1017
+ "required": ["call", "args"],
1018
+ "unevaluatedProperties": false
1019
+ },
1020
+ "formatCurrency": {
1021
+ "type": "object",
1022
+ "description": "Formats a number as a currency string.",
1023
+ "properties": {
1024
+ "call": {
1025
+ "const": "formatCurrency"
1026
+ },
1027
+ "args": {
1028
+ "type": "object",
1029
+ "properties": {
1030
+ "value": {
1031
+ "$ref": "https://a2ui.org/specification/v0_9/common_types.json#/$defs/DynamicNumber",
1032
+ "description": "The monetary amount."
1033
+ },
1034
+ "currency": {
1035
+ "$ref": "https://a2ui.org/specification/v0_9/common_types.json#/$defs/DynamicString",
1036
+ "description": "The ISO 4217 currency code (e.g., 'USD', 'EUR')."
1037
+ },
1038
+ "decimals": {
1039
+ "$ref": "https://a2ui.org/specification/v0_9/common_types.json#/$defs/DynamicNumber",
1040
+ "description": "Optional. The number of decimal places to show. Defaults to 0 or 2 depending on locale."
1041
+ },
1042
+ "grouping": {
1043
+ "$ref": "https://a2ui.org/specification/v0_9/common_types.json#/$defs/DynamicBoolean",
1044
+ "description": "Optional. If true, uses locale-specific grouping separators (e.g. '1,000'). If false, returns raw digits (e.g. '1000'). Defaults to true."
1045
+ }
1046
+ },
1047
+ "required": ["currency", "value"],
1048
+ "unevaluatedProperties": false
1049
+ },
1050
+ "returnType": {
1051
+ "const": "string"
1052
+ }
1053
+ },
1054
+ "required": ["call", "args"],
1055
+ "unevaluatedProperties": false
1056
+ },
1057
+ "formatDate": {
1058
+ "type": "object",
1059
+ "description": "Formats a timestamp into a string using a pattern.",
1060
+ "properties": {
1061
+ "call": {
1062
+ "const": "formatDate"
1063
+ },
1064
+ "args": {
1065
+ "type": "object",
1066
+ "properties": {
1067
+ "value": {
1068
+ "$ref": "https://a2ui.org/specification/v0_9/common_types.json#/$defs/DynamicValue",
1069
+ "description": "The date to format."
1070
+ },
1071
+ "format": {
1072
+ "$ref": "https://a2ui.org/specification/v0_9/common_types.json#/$defs/DynamicString",
1073
+ "description": "A Unicode TR35 date pattern string.\n\nToken Reference:\n- Year: 'yy' (26), 'yyyy' (2026)\n- Month: 'M' (1), 'MM' (01), 'MMM' (Jan), 'MMMM' (January)\n- Day: 'd' (1), 'dd' (01), 'E' (Tue), 'EEEE' (Tuesday)\n- Hour (12h): 'h' (1-12), 'hh' (01-12) - requires 'a' for AM/PM\n- Hour (24h): 'H' (0-23), 'HH' (00-23) - Military Time\n- Minute: 'mm' (00-59)\n- Second: 'ss' (00-59)\n- Period: 'a' (AM/PM)\n\nExamples:\n- 'MMM dd, yyyy' -> 'Jan 16, 2026'\n- 'HH:mm' -> '14:30' (Military)\n- 'h:mm a' -> '2:30 PM'\n- 'EEEE, d MMMM' -> 'Friday, 16 January'"
1074
+ }
1075
+ },
1076
+ "required": ["format", "value"],
1077
+ "unevaluatedProperties": false
1078
+ },
1079
+ "returnType": {
1080
+ "const": "string"
1081
+ }
1082
+ },
1083
+ "required": ["call", "args"],
1084
+ "unevaluatedProperties": false
1085
+ },
1086
+ "pluralize": {
1087
+ "type": "object",
1088
+ "description": "Returns a localized string based on the Common Locale Data Repository (CLDR) plural category of the count (zero, one, two, few, many, other). Requires an 'other' fallback. For English, just use 'one' and 'other'.",
1089
+ "properties": {
1090
+ "call": {
1091
+ "const": "pluralize"
1092
+ },
1093
+ "args": {
1094
+ "type": "object",
1095
+ "properties": {
1096
+ "value": {
1097
+ "$ref": "https://a2ui.org/specification/v0_9/common_types.json#/$defs/DynamicNumber",
1098
+ "description": "The numeric value used to determine the plural category."
1099
+ },
1100
+ "zero": {
1101
+ "$ref": "https://a2ui.org/specification/v0_9/common_types.json#/$defs/DynamicString",
1102
+ "description": "String for the 'zero' category (e.g., 0 items)."
1103
+ },
1104
+ "one": {
1105
+ "$ref": "https://a2ui.org/specification/v0_9/common_types.json#/$defs/DynamicString",
1106
+ "description": "String for the 'one' category (e.g., 1 item)."
1107
+ },
1108
+ "two": {
1109
+ "$ref": "https://a2ui.org/specification/v0_9/common_types.json#/$defs/DynamicString",
1110
+ "description": "String for the 'two' category (used in Arabic, Welsh, etc.)."
1111
+ },
1112
+ "few": {
1113
+ "$ref": "https://a2ui.org/specification/v0_9/common_types.json#/$defs/DynamicString",
1114
+ "description": "String for the 'few' category (e.g., small groups in Slavic languages)."
1115
+ },
1116
+ "many": {
1117
+ "$ref": "https://a2ui.org/specification/v0_9/common_types.json#/$defs/DynamicString",
1118
+ "description": "String for the 'many' category (e.g., large groups in various languages)."
1119
+ },
1120
+ "other": {
1121
+ "$ref": "https://a2ui.org/specification/v0_9/common_types.json#/$defs/DynamicString",
1122
+ "description": "The default/fallback string (used for general plural cases)."
1123
+ }
1124
+ },
1125
+ "required": ["value", "other"],
1126
+ "unevaluatedProperties": false
1127
+ },
1128
+ "returnType": {
1129
+ "const": "string"
1130
+ }
1131
+ },
1132
+ "required": ["call", "args"],
1133
+ "unevaluatedProperties": false
1134
+ },
1135
+ "openUrl": {
1136
+ "type": "object",
1137
+ "description": "Opens the specified URL in a browser or handler. This function has no return value.",
1138
+ "properties": {
1139
+ "call": {
1140
+ "const": "openUrl"
1141
+ },
1142
+ "args": {
1143
+ "type": "object",
1144
+ "properties": {
1145
+ "url": {
1146
+ "type": "string",
1147
+ "format": "uri",
1148
+ "description": "The URL to open."
1149
+ }
1150
+ },
1151
+ "required": ["url"],
1152
+ "additionalProperties": false
1153
+ },
1154
+ "returnType": {
1155
+ "const": "void"
1156
+ }
1157
+ },
1158
+ "required": ["call", "args"],
1159
+ "unevaluatedProperties": false
1160
+ },
1161
+ "and": {
1162
+ "type": "object",
1163
+ "description": "Performs a logical AND operation on a list of boolean values.",
1164
+ "properties": {
1165
+ "call": {
1166
+ "const": "and"
1167
+ },
1168
+ "args": {
1169
+ "type": "object",
1170
+ "properties": {
1171
+ "values": {
1172
+ "type": "array",
1173
+ "description": "The list of boolean values to evaluate.",
1174
+ "items": {
1175
+ "$ref": "https://a2ui.org/specification/v0_9/common_types.json#/$defs/DynamicBoolean"
1176
+ },
1177
+ "minItems": 2
1178
+ }
1179
+ },
1180
+ "required": ["values"],
1181
+ "unevaluatedProperties": false
1182
+ },
1183
+ "returnType": {
1184
+ "const": "boolean"
1185
+ }
1186
+ },
1187
+ "required": ["call", "args"],
1188
+ "unevaluatedProperties": false
1189
+ },
1190
+ "or": {
1191
+ "type": "object",
1192
+ "description": "Performs a logical OR operation on a list of boolean values.",
1193
+ "properties": {
1194
+ "call": {
1195
+ "const": "or"
1196
+ },
1197
+ "args": {
1198
+ "type": "object",
1199
+ "properties": {
1200
+ "values": {
1201
+ "type": "array",
1202
+ "description": "The list of boolean values to evaluate.",
1203
+ "items": {
1204
+ "$ref": "https://a2ui.org/specification/v0_9/common_types.json#/$defs/DynamicBoolean"
1205
+ },
1206
+ "minItems": 2
1207
+ }
1208
+ },
1209
+ "required": ["values"],
1210
+ "unevaluatedProperties": false
1211
+ },
1212
+ "returnType": {
1213
+ "const": "boolean"
1214
+ }
1215
+ },
1216
+ "required": ["call", "args"],
1217
+ "unevaluatedProperties": false
1218
+ },
1219
+ "not": {
1220
+ "type": "object",
1221
+ "description": "Performs a logical NOT operation on a boolean value.",
1222
+ "properties": {
1223
+ "call": {
1224
+ "const": "not"
1225
+ },
1226
+ "args": {
1227
+ "type": "object",
1228
+ "properties": {
1229
+ "value": {
1230
+ "$ref": "https://a2ui.org/specification/v0_9/common_types.json#/$defs/DynamicBoolean",
1231
+ "description": "The boolean value to negate."
1232
+ }
1233
+ },
1234
+ "required": ["value"],
1235
+ "unevaluatedProperties": false
1236
+ },
1237
+ "returnType": {
1238
+ "const": "boolean"
1239
+ }
1240
+ },
1241
+ "required": ["call", "args"],
1242
+ "unevaluatedProperties": false
1243
+ }
1244
+ },
1245
+ "$defs": {
1246
+ "CatalogComponentCommon": {
1247
+ "type": "object",
1248
+ "properties": {
1249
+ "weight": {
1250
+ "type": "number",
1251
+ "description": "The relative weight of this component within a Row or Column. This is similar to the CSS 'flex-grow' property. Note: this may ONLY be set when the component is a direct descendant of a Row or Column."
1252
+ }
1253
+ }
1254
+ },
1255
+ "theme": {
1256
+ "type": "object",
1257
+ "properties": {
1258
+ "primaryColor": {
1259
+ "type": "string",
1260
+ "description": "The primary brand color used for highlights (e.g., primary buttons, active borders). Renderers may generate variants of this color for different contexts. Format: Hexadecimal code (e.g., '#00BFFF').",
1261
+ "pattern": "^#[0-9a-fA-F]{6}$"
1262
+ },
1263
+ "iconUrl": {
1264
+ "type": "string",
1265
+ "format": "uri",
1266
+ "description": "A URL for an image that identifies the agent or tool associated with the surface."
1267
+ },
1268
+ "agentDisplayName": {
1269
+ "type": "string",
1270
+ "description": "Text to be displayed next to the surface to identify the agent or tool that created it."
1271
+ }
1272
+ },
1273
+ "additionalProperties": true
1274
+ },
1275
+ "anyComponent": {
1276
+ "oneOf": [
1277
+ {
1278
+ "$ref": "#/components/Text"
1279
+ },
1280
+ {
1281
+ "$ref": "#/components/Image"
1282
+ },
1283
+ {
1284
+ "$ref": "#/components/Icon"
1285
+ },
1286
+ {
1287
+ "$ref": "#/components/Video"
1288
+ },
1289
+ {
1290
+ "$ref": "#/components/AudioPlayer"
1291
+ },
1292
+ {
1293
+ "$ref": "#/components/Row"
1294
+ },
1295
+ {
1296
+ "$ref": "#/components/Column"
1297
+ },
1298
+ {
1299
+ "$ref": "#/components/List"
1300
+ },
1301
+ {
1302
+ "$ref": "#/components/Card"
1303
+ },
1304
+ {
1305
+ "$ref": "#/components/Tabs"
1306
+ },
1307
+ {
1308
+ "$ref": "#/components/Modal"
1309
+ },
1310
+ {
1311
+ "$ref": "#/components/Divider"
1312
+ },
1313
+ {
1314
+ "$ref": "#/components/Button"
1315
+ },
1316
+ {
1317
+ "$ref": "#/components/TextField"
1318
+ },
1319
+ {
1320
+ "$ref": "#/components/CheckBox"
1321
+ },
1322
+ {
1323
+ "$ref": "#/components/ChoicePicker"
1324
+ },
1325
+ {
1326
+ "$ref": "#/components/Slider"
1327
+ },
1328
+ {
1329
+ "$ref": "#/components/DateTimeInput"
1330
+ }
1331
+ ],
1332
+ "discriminator": {
1333
+ "propertyName": "component"
1334
+ }
1335
+ },
1336
+ "anyFunction": {
1337
+ "oneOf": [
1338
+ {
1339
+ "$ref": "#/functions/required"
1340
+ },
1341
+ {
1342
+ "$ref": "#/functions/regex"
1343
+ },
1344
+ {
1345
+ "$ref": "#/functions/length"
1346
+ },
1347
+ {
1348
+ "$ref": "#/functions/numeric"
1349
+ },
1350
+ {
1351
+ "$ref": "#/functions/email"
1352
+ },
1353
+ {
1354
+ "$ref": "#/functions/formatString"
1355
+ },
1356
+ {
1357
+ "$ref": "#/functions/formatNumber"
1358
+ },
1359
+ {
1360
+ "$ref": "#/functions/formatCurrency"
1361
+ },
1362
+ {
1363
+ "$ref": "#/functions/formatDate"
1364
+ },
1365
+ {
1366
+ "$ref": "#/functions/pluralize"
1367
+ },
1368
+ {
1369
+ "$ref": "#/functions/openUrl"
1370
+ },
1371
+ {
1372
+ "$ref": "#/functions/and"
1373
+ },
1374
+ {
1375
+ "$ref": "#/functions/or"
1376
+ },
1377
+ {
1378
+ "$ref": "#/functions/not"
1379
+ }
1380
+ ]
1381
+ }
1382
+ }
1383
+ }