@cloudcrane/app-spec 0.0.0-stage → 0.1.1

package/vendor/a2ui/v0_9_1/catalogs/basic/examples/34_child-list-template.json

@@ -0,0 +1,80 @@
+{
+  "name": "ChildList Template Expansion",
+  "description": "Demonstrates dynamic list generation using ChildList object templates.",
+  "messages": [
+    {
+      "version": "v0.9",
+      "createSurface": {
+        "surfaceId": "gallery-child-list-template",
+        "catalogId": "https://a2ui.org/specification/v0_9/catalogs/basic/catalog.json",
+        "sendDataModel": true
+      }
+    },
+    {
+      "version": "v0.9",
+      "updateComponents": {
+        "surfaceId": "gallery-child-list-template",
+        "components": [
+          {
+            "id": "root",
+            "component": "Card",
+            "child": "main-column"
+          },
+          {
+            "id": "main-column",
+            "component": "Column",
+            "children": ["title-text", "item-list"],
+            "align": "stretch"
+          },
+          {
+            "id": "title-text",
+            "component": "Text",
+            "text": "Dynamic Item List",
+            "variant": "h3"
+          },
+          {
+            "id": "item-list",
+            "component": "List",
+            "children": {
+              "componentId": "item-row",
+              "path": "/items"
+            }
+          },
+          {
+            "id": "item-row",
+            "component": "Row",
+            "children": ["item-name", "qty-label", "item-qty"]
+          },
+          {
+            "id": "item-name",
+            "component": "Text",
+            "text": {"path": "name"}
+          },
+          {
+            "id": "qty-label",
+            "component": "Text",
+            "text": " - Qty: "
+          },
+          {
+            "id": "item-qty",
+            "component": "Text",
+            "text": {"path": "quantity"}
+          }
+        ]
+      }
+    },
+    {
+      "version": "v0.9",
+      "updateDataModel": {
+        "surfaceId": "gallery-child-list-template",
+        "value": {
+          "items": [
+            {"name": "Apple", "quantity": 10},
+            {"name": "Banana", "quantity": 5},
+            {"name": "Cherry", "quantity": 20}
+          ]
+        }
+      }
+    }
+  ]
+}

package/vendor/a2ui/v0_9_1/catalogs/basic/examples/35_markdown-text.json

@@ -0,0 +1,44 @@
+{
+  "name": "Markdown Text Support",
+  "description": "Demonstrates Markdown rendering in Text component.",
+  "messages": [
+    {
+      "version": "v0.9",
+      "createSurface": {
+        "surfaceId": "gallery-markdown-text",
+        "catalogId": "https://a2ui.org/specification/v0_9/catalogs/basic/catalog.json",
+        "sendDataModel": true
+      }
+    },
+    {
+      "version": "v0.9",
+      "updateComponents": {
+        "surfaceId": "gallery-markdown-text",
+        "components": [
+          {
+            "id": "root",
+            "component": "Card",
+            "child": "main-column"
+          },
+          {
+            "id": "main-column",
+            "component": "Column",
+            "children": ["title-text", "markdown-content"],
+            "align": "stretch"
+          },
+          {
+            "id": "title-text",
+            "component": "Text",
+            "text": "Markdown Rendering",
+            "variant": "h3"
+          },
+          {
+            "id": "markdown-content",
+            "component": "Text",
+            "text": "# Heading 1\n\nThis is **bold** text and *italic* text.\n\n- List item 1\n- List item 2\n\n[Link to Google](https://google.com)"
+          }
+        ]
+      }
+    }
+  ]
+}

package/vendor/a2ui/v0_9_1/catalogs/basic/examples/36_modal.json

@@ -0,0 +1,65 @@
+{
+  "name": "Modal Sample",
+  "description": "Example of Modal component showing a trigger and content.",
+  "messages": [
+    {
+      "version": "v0.9",
+      "createSurface": {
+        "surfaceId": "modal-sample-surface",
+        "catalogId": "https://a2ui.org/specification/v0_9/catalogs/basic/catalog.json",
+        "sendDataModel": true
+      }
+    },
+    {
+      "version": "v0.9",
+      "updateComponents": {
+        "surfaceId": "modal-sample-surface",
+        "components": [
+          {
+            "id": "root",
+            "component": "Column",
+            "children": ["title", "modal-comp"]
+          },
+          {
+            "id": "title",
+            "component": "Text",
+            "text": "Modal Component Sample",
+            "variant": "h2"
+          },
+          {
+            "id": "modal-comp",
+            "component": "Modal",
+            "trigger": "open-btn",
+            "content": "modal-content"
+          },
+          {
+            "id": "open-btn-text",
+            "component": "Text",
+            "text": "Open Modal"
+          },
+          {
+            "id": "open-btn",
+            "component": "Button",
+            "child": "open-btn-text",
+            "action": {
+              "event": {
+                "name": "openModalEvent",
+                "context": {}
+              }
+            }
+          },
+          {
+            "id": "modal-content",
+            "component": "Column",
+            "children": ["modal-text"]
+          },
+          {
+            "id": "modal-text",
+            "component": "Text",
+            "text": "This is the content inside the modal."
+          }
+        ]
+      }
+    }
+  ]
+}

package/vendor/a2ui/v0_9_1/client_capabilities.json

@@ -0,0 +1,89 @@
+{
+  "$schema": "https://json-schema.org/draft/2020-12/schema",
+  "$id": "https://a2ui.org/specification/v0_9/client_capabilities.json",
+  "title": "A2UI Client Capabilities Schema",
+  "description": "A schema for the a2uiClientCapabilities object, which is sent from the client to the server as part of the A2A metadata to describe the client's UI rendering capabilities.",
+  "type": "object",
+  "properties": {
+    "v0.9": {
+      "type": "object",
+      "description": "The capabilities structure for version 0.9 of the A2UI protocol.",
+      "properties": {
+        "supportedCatalogIds": {
+          "type": "array",
+          "description": "An array of string identifiers for each of the component and function catalogs supported by the client.",
+          "items": {"type": "string"}
+        },
+        "inlineCatalogs": {
+          "type": "array",
+          "description": "An array of inline catalog definitions, which can contain both components and functions. This should only be provided if the agent declares 'acceptsInlineCatalogs: true' in its capabilities.",
+          "items": {"$ref": "#/$defs/Catalog"}
+        }
+      },
+      "required": ["supportedCatalogIds"]
+    }
+  },
+  "required": ["v0.9"],
+  "$defs": {
+    "FunctionDefinition": {
+      "type": "object",
+      "description": "Describes a function's interface.",
+      "properties": {
+        "name": {
+          "type": "string",
+          "description": "The unique name of the function."
+        },
+        "description": {
+          "type": "string",
+          "description": "A human-readable description of what the function does and how to use it."
+        },
+        "parameters": {
+          "type": "object",
+          "description": "A JSON Schema describing the expected arguments (args) for this function.",
+          "$ref": "https://json-schema.org/draft/2020-12/schema"
+        },
+        "returnType": {
+          "type": "string",
+          "enum": ["string", "number", "boolean", "array", "object", "any", "void"],
+          "description": "The type of value this function returns."
+        }
+      },
+      "required": ["name", "parameters", "returnType"],
+      "additionalProperties": false
+    },
+    "Catalog": {
+      "type": "object",
+      "description": "A collection of component and function definitions.",
+      "properties": {
+        "catalogId": {
+          "type": "string",
+          "description": "Unique identifier for this catalog."
+        },
+        "components": {
+          "type": "object",
+          "description": "Definitions for UI components supported by this catalog.",
+          "additionalProperties": {
+            "$ref": "https://json-schema.org/draft/2020-12/schema"
+          }
+        },
+        "functions": {
+          "type": "array",
+          "description": "Definitions for functions supported by this catalog.",
+          "items": {
+            "$ref": "#/$defs/FunctionDefinition"
+          }
+        },
+        "theme": {
+          "title": "A2UI Theme",
+          "description": "A schema that defines a catalog of A2UI theme properties. Each key is a theme property name (e.g. 'primaryColor'), and each value is the JSON schema for that property.",
+          "type": "object",
+          "additionalProperties": {
+            "$ref": "https://json-schema.org/draft/2020-12/schema"
+          }
+        }
+      },
+      "required": ["catalogId"],
+      "additionalProperties": false
+    }
+  }
+}

package/vendor/a2ui/v0_9_1/client_data_model.json

@@ -0,0 +1,22 @@
+{
+  "$schema": "https://json-schema.org/draft/2020-12/schema",
+  "$id": "https://a2ui.org/specification/v0_9/client_data_model.json",
+  "title": "A2UI Client Data Model Schema",
+  "description": "Schema for attaching the client data model to A2A message metadata. This object should be placed in the `a2uiClientDataModel` field of the metadata.",
+  "type": "object",
+  "properties": {
+    "version": {
+      "enum": ["v0.9", "v0.9.1"]
+    },
+    "surfaces": {
+      "type": "object",
+      "description": "A map of surface IDs to their current data models.",
+      "additionalProperties": {
+        "type": "object",
+        "description": "The current data model for the surface, as a standard JSON object."
+      }
+    }
+  },
+  "required": ["version", "surfaces"],
+  "additionalProperties": false
+}

package/vendor/a2ui/v0_9_1/client_to_server.json

@@ -0,0 +1,98 @@
+{
+  "title": "A2UI (Agent to UI) Client-to-Server Event Schema",
+  "description": "Describes a JSON payload for a client-to-server event message.",
+  "type": "object",
+  "minProperties": 2,
+  "maxProperties": 2,
+  "properties": {
+    "version": {
+      "enum": ["v0.9", "v0.9.1"]
+    },
+    "action": {
+      "type": "object",
+      "description": "Reports a user-initiated action from a component.",
+      "properties": {
+        "name": {
+          "type": "string",
+          "description": "The name of the action, taken from the component's action.event.name property."
+        },
+        "surfaceId": {
+          "type": "string",
+          "description": "The id of the surface where the event originated."
+        },
+        "sourceComponentId": {
+          "type": "string",
+          "description": "The id of the component that triggered the event."
+        },
+        "timestamp": {
+          "type": "string",
+          "format": "date-time",
+          "description": "An ISO 8601 timestamp of when the event occurred."
+        },
+        "context": {
+          "type": "object",
+          "description": "A JSON object containing the key-value pairs from the component's action.event.context, after resolving all data bindings.",
+          "additionalProperties": true
+        }
+      },
+      "required": ["name", "surfaceId", "sourceComponentId", "timestamp", "context"]
+    },
+    "error": {
+      "description": "Reports a client-side error.",
+      "oneOf": [
+        {
+          "type": "object",
+          "title": "Validation Failed Error",
+          "properties": {
+            "code": {
+              "const": "VALIDATION_FAILED"
+            },
+            "surfaceId": {
+              "type": "string",
+              "description": "The id of the surface where the error occurred."
+            },
+            "path": {
+              "type": "string",
+              "description": "The JSON pointer to the field that failed validation (e.g. '/components/0/text')."
+            },
+            "message": {
+              "type": "string",
+              "description": "A short one or two sentence description of why validation failed."
+            }
+          },
+          "required": ["code", "path", "message", "surfaceId"],
+          "additionalProperties": false
+        },
+        {
+          "type": "object",
+          "title": "Generic Error",
+          "properties": {
+            "code": {
+              "not": {
+                "const": "VALIDATION_FAILED"
+              }
+            },
+            "message": {
+              "type": "string",
+              "description": "A short one or two sentence description of why the error occurred."
+            },
+            "surfaceId": {
+              "type": "string",
+              "description": "The id of the surface where the error occurred."
+            }
+          },
+          "required": ["code", "surfaceId", "message"],
+          "additionalProperties": true
+        }
+      ]
+    }
+  },
+  "oneOf": [
+    {
+      "required": ["action", "version"]
+    },
+    {
+      "required": ["error", "version"]
+    }
+  ]
+}

package/vendor/a2ui/v0_9_1/client_to_server_list.json

@@ -0,0 +1,10 @@
+{
+  "$schema": "https://json-schema.org/draft/2020-12/schema",
+  "$id": "https://a2ui.org/specification/v0_9/client_to_server_list.json",
+  "title": "A2UI Client-to-Server Message List",
+  "description": "A list of A2UI Client-to-Server messages.",
+  "type": "array",
+  "items": {
+    "$ref": "client_to_server.json"
+  }
+}

package/vendor/a2ui/v0_9_1/client_to_server_list_wrapper.json

@@ -0,0 +1,14 @@
+{
+  "$schema": "https://json-schema.org/draft/2020-12/schema",
+  "$id": "https://a2ui.org/specification/v0_9/client_to_server_list_wrapper.json",
+  "title": "A2UI Client-to-Server Message List Wrapper",
+  "description": "An object wrapping a list of A2UI Client-to-Server messages. Intended for protocols that require a top-level JSON object instead of a raw array.",
+  "type": "object",
+  "properties": {
+    "messages": {
+      "$ref": "client_to_server_list.json"
+    }
+  },
+  "additionalProperties": false,
+  "required": ["messages"]
+}