Merge branch 'main' into qa-report

Author: zeroasterisk

.editorconfig

@@ -0,0 +1,22 @@
+# Copyright 2026 Google LLC
+#
+# Licensed under the Apache License, Version 2.0 (the "License");
+# you may not use this file except in compliance with the License.
+# You may obtain a copy of the License at
+#
+#     http://www.apache.org/licenses/LICENSE-2.0
+#
+# Unless required by applicable law or agreed to in writing, software
+# distributed under the License is distributed on an "AS IS" BASIS,
+# WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+# See the License for the specific language governing permissions and
+# limitations under the License.
+
+root = true
+
+[*]
+indent_style = space
+indent_size = 2
+end_of_line = lf
+charset = utf-8
+insert_final_newline = true

.gemini/GEMINI.md

@@ -6,40 +6,40 @@ This document serves as a guide for using the Gemini agent within the A2UI repos
 
 The A2UI repository is organized into several key directories:
 
--   `specification/`: Contains the A2UI protocol specifications.
-    -   `v0_8/`: The stable protocol version.
-        -   `docs/`: Human-readable documentation.
-        -   `json/`: JSON schema definitions.
-        -   `eval/`: Genkit-based evaluation framework.
-    -   `v0_9/`: The draft protocol version (in development).
-        -   `docs/`: Human-readable documentation.
-        -   `json/`: JSON schema definitions.
-        -   `eval/`: Genkit-based evaluation framework.
-    -   `v0_10/`: The proposed protocol version (next version).
-        -   `docs/`: Human-readable documentation.
-        -   `json/`: JSON schema definitions.
-        -   `eval/`: Genkit-based evaluation framework.
--   `samples/`: Contains sample implementations.
-    -   `agent/`:
-        -   `adk/`: Python-based ADK agent samples (e.g., `contact_lookup`, `restaurant_finder`, `rizzcharts`, `orchestrator`).
-        -   `mcp/`: MCP server sample (A2UI over MCP).
-    -   `client/`: Web client implementations.
-        -   `lit/`: Clients using Lit and Vite (e.g., `contact`, `shell`).
-        -   `angular/`: Clients using Angular (e.g., `contact`, `orchestrator`).
-    -   `personalized_learning/`: Personalized learning sample implementation.
--   `agent_sdks/`: Contains source code for Agent integrations.
-    -   `python/`: Python implementation of the A2UI agent library.
-    -   `java/`: Java implementation of the A2UI agent library.
--   `renderers/`: Contains renderer libraries.
-    -   `lit/`: The shared Lit renderer library used by the Lit clients.
-    -   `angular/`: The shared Angular renderer library used by the Angular clients.
-    -   `web_core/`: The shared core library used by web renderers.
-    -   `markdown/`: Markdown rendering utilities.
--   `tools/`: Helper tools for development.
-    -   `editor/`: A web-based editor for generating and visualizing A2UI.
-    -   `inspector/`: A web-based inspector for A2UI responses.
-    -   `composer/`: Visual composer tool.
-    -   `build_catalog/`: Catalog building utility.
+- `specification/`: Contains the A2UI protocol specifications.
+  - `v0_8/`: The stable protocol version.
+    - `docs/`: Human-readable documentation.
+    - `json/`: JSON schema definitions.
+    - `eval/`: Genkit-based evaluation framework.
+  - `v0_9/`: The draft protocol version (in development).
+    - `docs/`: Human-readable documentation.
+    - `json/`: JSON schema definitions.
+    - `eval/`: Genkit-based evaluation framework.
+  - `v0_10/`: The proposed protocol version (next version).
+    - `docs/`: Human-readable documentation.
+    - `json/`: JSON schema definitions.
+    - `eval/`: Genkit-based evaluation framework.
+- `samples/`: Contains sample implementations.
+  - `agent/`:
+    - `adk/`: Python-based ADK agent samples (e.g., `contact_lookup`, `restaurant_finder`, `rizzcharts`, `orchestrator`).
+    - `mcp/`: MCP server sample (A2UI over MCP).
+  - `client/`: Web client implementations.
+    - `lit/`: Clients using Lit and Vite (e.g., `contact`, `shell`).
+    - `angular/`: Clients using Angular (e.g., `contact`, `orchestrator`).
+  - `personalized_learning/`: Personalized learning sample implementation.
+- `agent_sdks/`: Contains source code for Agent integrations.
+  - `python/`: Python implementation of the A2UI agent library.
+  - `kotlin/`: Kotlin implementation of the A2UI agent library.
+- `renderers/`: Contains renderer libraries.
+  - `lit/`: The shared Lit renderer library used by the Lit clients.
+  - `angular/`: The shared Angular renderer library used by the Angular clients.
+  - `web_core/`: The shared core library used by web renderers.
+  - `markdown/`: Markdown rendering utilities.
+- `tools/`: Helper tools for development.
+  - `editor/`: A web-based editor for generating and visualizing A2UI.
+  - `inspector/`: A web-based inspector for A2UI responses.
+  - `composer/`: Visual composer tool.
+  - `build_catalog/`: Catalog building utility.
 
 ## A2UI Specification Overview
 
@@ -49,17 +49,17 @@ The A2UI protocol is a JSONL-based, streaming UI protocol designed to be easily
 
 The core concepts of the A2UI protocol are detailed in the main specification document. Refer to the authoritative source for the current version (0.9):
 
--   **A2UI Protocol Specification**: `@specification/v0_9/docs/a2ui_protocol.md`
+- **A2UI Protocol Specification**: `@specification/v0_9/docs/a2ui_protocol.md`
 
 This document covers the design philosophy, architecture, data flow, and core concepts of the protocol.
 
 ### Schemas
 
 The formal, machine-readable definitions of the protocol are maintained as JSON schemas. For version 0.9:
 
--   **Server-to-Client Schema**: `@specification/v0_9/json/server_to_client.json`
--   **Client-to-Server Schema**: `@specification/v0_9/json/client_to_server.json`
--   **Basic Catalog**: `@specification/v0_9/json/basic_catalog.json`
+- **Server-to-Client Schema**: `@specification/v0_9/json/server_to_client.json`
+- **Client-to-Server Schema**: `@specification/v0_9/json/client_to_server.json`
+- **Basic Catalog**: `@specification/v0_9/json/basic_catalog.json`
 
 ## Running the Demos
 
@@ -82,6 +82,7 @@ The Lit clients are located in `samples/client/lit/`.
 
 1.  **Build the Renderer**:
     First, ensure the shared renderers are built:
+
     ```bash
     cd renderers/markdown/markdown-it
     npm install
@@ -109,6 +110,7 @@ The Lit clients are located in `samples/client/lit/`.
 The Angular clients are located in `samples/client/angular/`.
 
 First, ensure the shared renderers are built (if not already done):
+
 ```bash
 cd renderers/markdown/markdown-it
 npm install
@@ -124,6 +126,7 @@ npm run build
 ```
 
 Then run the Angular client:
+
 ```bash
 cd samples/client/angular
 npm install
@@ -132,25 +135,25 @@ npm start -- contact  # Replace 'contact' with the desired project name (e.g., r
 
 ### Running Tools
 
--   **Editor**: Located in `tools/editor`. Run with `npm install && npm run dev`.
-    -   Requires a Gemini API key in `.env` (`GEMINI_API_KEY=<key>`).
--   **Inspector**: Located in `tools/inspector`. Run with `npm install && npm run dev`.
+- **Editor**: Located in `tools/editor`. Run with `npm install && npm run dev`.
+  - Requires a Gemini API key in `.env` (`GEMINI_API_KEY=<key>`).
+- **Inspector**: Located in `tools/inspector`. Run with `npm install && npm run dev`.
 
 ## Renderers
 
 There are three renderers available for A2UI:
 
--   **Web (Lit)**: Located in `renderers/lit`, this is the primary web renderer used by the demos in `web/`.
--   **Angular**: Located in `renderers/angular`, this is an alternative web renderer for Angular applications.
--   **Flutter**: The Flutter renderer is in a separate repository: [https://github.com/flutter/genui](https://github.com/flutter/genui). There is a placeholder renderer folder with a README.md file at `renderers/flutter`.
+- **Web (Lit)**: Located in `renderers/lit`, this is the primary web renderer used by the demos in `web/`.
+- **Angular**: Located in `renderers/angular`, this is an alternative web renderer for Angular applications.
+- **Flutter**: The Flutter renderer is in a separate repository: [https://github.com/flutter/genui](https://github.com/flutter/genui). There is a placeholder renderer folder with a README.md file at `renderers/flutter`.
 
 ## Keeping This Guide Updated
 
 This document is intended to be a living guide for the repository. As the repository evolves, it's important to keep this file up-to-date. When making changes to the repository, please consider the following:
 
--   **New Demos or Clients**: If you add a new demo or client in `samples/`, add it to the "Running the Demos" section.
--   **Specification Changes**: If you make significant changes to the A2UI protocol, ensure that the "A2UI Specification Overview" section is updated.
--   **Repository Structure Changes**: If you change the directory structure of the repository, update the "Repository Structure" section.
+- **New Demos or Clients**: If you add a new demo or client in `samples/`, add it to the "Running the Demos" section.
+- **Specification Changes**: If you make significant changes to the A2UI protocol, ensure that the "A2UI Specification Overview" section is updated.
+- **Repository Structure Changes**: If you change the directory structure of the repository, update the "Repository Structure" section.
 
 To get this file back in sync, you can run the following commands:
 
@@ -160,4 +163,4 @@ To get this file back in sync, you can run the following commands:
 
 ## Change descriptions
 
-If you (the agent) are generating a pull request summary, pull request description, or change description, avoid flowery or hyperbolic terms (e.g. "significantly improves", "greatly enhances", "is an incredible improvement").  Be factual and avoid marketing language: you're not selling the PR, you're describing it.
+If you (the agent) are generating a pull request summary, pull request description, or change description, avoid flowery or hyperbolic terms (e.g. "significantly improves", "greatly enhances", "is an incredible improvement"). Be factual and avoid marketing language: you're not selling the PR, you're describing it.

.github/ISSUE_TEMPLATE/sprint-task.md

@@ -4,7 +4,4 @@ about: An issue to track a task used in a sprint
 title: ''
 labels: P2, sprint ready
 assignees: ''
-
 ---
-
-

.github/PULL_REQUEST_TEMPLATE.md

@@ -12,6 +12,7 @@ _List which issues are fixed by this PR. For larger changes, raising an issue fi
 - [ ] I have added updates to the [CHANGELOG].
 - [ ] I updated/added relevant documentation.
 - [ ] My code changes (if any) have tests.
+- [ ] If my branch is on fork, I have verified that [scripts/e2e_test.sh](../scripts/e2e_test.sh) passes.
 
 If you need help, consider asking for advice on the [discussion board].
 

.github/workflows/auto-assignment.yml

@@ -41,4 +41,4 @@ jobs:
             const fileUrl = pathToFileURL(filePath).href;
 
             const importedModule = await import(fileUrl);
-            await importedModule.default({ github, context });
+            await importedModule.default({ github, context });

.github/workflows/check_license.yml

@@ -31,7 +31,7 @@ jobs:
       - name: Set up Go
         uses: actions/setup-go@v6
         with:
-          go-version: '1.21'
+          go-version: "1.21"
 
       - name: Install addlicense
         run: go install github.com/google/addlicense@latest
@@ -41,6 +41,10 @@ jobs:
           if ! addlicense -check \
             -l apache \
             -c "Google LLC" \
+            -ignore "**/pnpm-lock.yaml" \
+            -ignore "**/package-lock.json" \
+            -ignore "**/yarn.lock" \
+            -ignore "eval/datasets/*.yaml" \
             .; then
             echo "License check failed. To fix this, install addlicense and run it:"
             echo "  go install github.com/google/addlicense@latest"

.github/workflows/composer_build_and_test.yml

@@ -17,16 +17,16 @@ name: Composer
 on:
   push:
     paths:
-      - 'tools/composer/**'
-      - 'renderers/react/**'
-      - 'renderers/web_core/**'
-      - '.github/workflows/composer_build_and_test.yml'
+      - "tools/composer/**"
+      - "renderers/react/**"
+      - "renderers/web_core/**"
+      - ".github/workflows/composer_build_and_test.yml"
   pull_request:
     paths:
-      - 'tools/composer/**'
-      - 'renderers/react/**'
-      - 'renderers/web_core/**'
-      - '.github/workflows/composer_build_and_test.yml'
+      - "tools/composer/**"
+      - "renderers/react/**"
+      - "renderers/web_core/**"
+      - ".github/workflows/composer_build_and_test.yml"
 
 jobs:
   build-and-test:
@@ -43,9 +43,9 @@ jobs:
       - name: Set up Node.js
         uses: actions/setup-node@v6
         with:
-          node-version: '20'
-          cache: 'pnpm'
-          cache-dependency-path: 'tools/composer/pnpm-lock.yaml'
+          node-version: "22"
+          cache: "pnpm"
+          cache-dependency-path: "tools/composer/pnpm-lock.yaml"
 
       - name: Build web_core (dependency of @a2ui/react)
         working-directory: ./renderers/web_core

.github/workflows/e2e_test.yaml

@@ -0,0 +1,55 @@
+# Copyright 2025 The Flutter Authors.
+# Use of this source code is governed by a BSD-style license that can be
+# found in the LICENSE file.
+
+name: E2E Tests
+
+on:
+  push:
+    # Workflow runs on push to any branch in the repo (not forks).
+  schedule:
+    - cron: "0 * * * *" # hourly
+
+jobs:
+  e2e_test:
+    # Do not run on forked branches,
+    # because the test does not have access to secrets in forks.
+    if: github.repository == 'google/a2ui'
+    runs-on: ubuntu-latest
+    steps:
+      - name: Check that REPO_GEMINI_API_KEY is set and available
+        env:
+          # REPO_GEMINI_API_KEY is expected to be set in the repository secrets
+          # See https://docs.github.com/en/actions/security-guides/encrypted-secrets
+          GEMINI_API_KEY: ${{ secrets.REPO_GEMINI_API_KEY }}
+        run: |
+          if [ -z "$GEMINI_API_KEY" ]; then
+            echo "ERROR: REPO_GEMINI_API_KEY is not set"
+            exit 1
+          fi
+          echo "GEMINI_API_KEY has ${#GEMINI_API_KEY} characters"
+      - name: Checkout code
+        uses: actions/checkout@de0fac2e4500dabe0009e67214ff5f5447ce83dd
+      - name: Install uv
+        uses: astral-sh/setup-uv@v6
+      - name: Install Flutter
+        # Before bumping, verify the new version is on the flutter org's
+        # enterprise actions allowlist, or CI will fail with startup_failure.
+        uses: subosito/flutter-action@fd55f4c5af5b953cc57a2be44cb082c8f6635e8e
+        with:
+          channel: beta
+          cache: false
+      - name: Print Flutter version
+        run: flutter --version
+      - name: Cache pub dependencies
+        uses: actions/cache@668228422ae6a00e4ad889ee87cd7109ec5666a7
+        with:
+          path: ~/.pub-cache
+          key: ${{ runner.os }}-pub-${{ hashFiles('**/pubspec.lock') }}
+          restore-keys: ${{ runner.os }}-pub-
+      - name: Install dependencies
+        run: flutter pub get
+      - name: Run ./scripts/e2e_test.sh
+        env:
+          GEMINI_API_KEY: ${{ secrets.REPO_GEMINI_API_KEY }}
+        run: ./scripts/e2e_test.sh

.github/workflows/editor_build.yml

@@ -17,16 +17,16 @@ name: Editor
 on:
   push:
     paths:
-      - 'tools/editor/**'
-      - 'renderers/lit/**'
-      - 'renderers/web_core/**'
-      - '.github/workflows/editor_build.yml'
+      - "tools/editor/**"
+      - "renderers/lit/**"
+      - "renderers/web_core/**"
+      - ".github/workflows/editor_build.yml"
   pull_request:
     paths:
-      - 'tools/editor/**'
-      - 'renderers/lit/**'
-      - 'renderers/web_core/**'
-      - '.github/workflows/editor_build.yml'
+      - "tools/editor/**"
+      - "renderers/lit/**"
+      - "renderers/web_core/**"
+      - ".github/workflows/editor_build.yml"
 
 jobs:
   build:
@@ -38,7 +38,7 @@ jobs:
       - name: Set up Node.js
         uses: actions/setup-node@v6
         with:
-          node-version: '20'
+          node-version: "22"
 
       - name: Install web_core deps
         working-directory: ./renderers/web_core