docs: refactor MCP Apps guide to use standalone sample and fix conflicts

Author: zeroasterisk

.github/workflows/auto-assignment.yml

@@ -0,0 +1,44 @@
+# 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
+#
+#      https://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.
+
+name: A2UI Issue Auto-Assignment
+
+on:
+  issues:
+    types: [opened]
+
+permissions:
+  contents: read
+  issues: write
+
+jobs:
+  auto-assign:
+    runs-on: ubuntu-latest
+
+    steps:
+      - name: Checkout repository
+        uses: actions/checkout@v4
+
+      - name: Run auto-assignment script
+        uses: actions/github-script@v7
+        with:
+          script: |
+            const path = require('path');
+            const { pathToFileURL } = require('url');
+
+            const filePath = path.resolve('./scripts/auto-assignment.mjs');
+            const fileUrl = pathToFileURL(filePath).href;
+
+            const importedModule = await import(fileUrl);
+            await importedModule.default({ github, context });

.github/workflows/composer_build_and_test.yml

@@ -18,10 +18,14 @@ on:
   push:
     paths:
       - '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'
 
 jobs:
@@ -43,6 +47,14 @@ jobs:
           cache: 'pnpm'
           cache-dependency-path: 'tools/composer/pnpm-lock.yaml'
 
+      - name: Build web_core (dependency of @a2ui/react)
+        working-directory: ./renderers/web_core
+        run: npm ci && npm run build
+
+      - name: Build React renderer (local file dependency)
+        working-directory: ./renderers/react
+        run: npm ci && npm run build
+
       - name: Install dependencies
         working-directory: ./tools/composer
         run: pnpm install

.github/workflows/ng_build_and_test.yml

@@ -43,10 +43,6 @@ jobs:
         working-directory: ./samples/client/angular
         run: npm run build:renderer
 
-      - name: Build contact sample
-        working-directory: ./samples/client/angular
-        run: npm run build contact
-
       - name: Build restaurant sample
         working-directory: ./samples/client/angular
         run: npm run build restaurant

.github/workflows/python_agent_sdk_build_and_test.yml

@@ -21,10 +21,12 @@ on:
     paths:
       - 'agent_sdks/python/**'
       - 'specification/**/json/**'
+      - 'agent_sdks/conformance/**'
   pull_request:
     paths:
       - 'agent_sdks/python/**'
       - 'specification/**/json/**'
+      - 'agent_sdks/conformance/**'
 
 jobs:
   build-and-test:
@@ -48,10 +50,18 @@ jobs:
         working-directory: agent_sdks/python
         run: uv run pyink --check .
 
+      - name: Check Formatting for Conformance
+        working-directory: agent_sdks/conformance
+        run: uv run --with pyink pyink --check tests/
+
       - name: Run unit tests
         working-directory: agent_sdks/python
         run: uv run --with pytest pytest tests/
 
+      - name: Run conformance YAML validation
+        working-directory: agent_sdks/conformance
+        run: uv run pytest
+
       - name: Build the python SDK
         working-directory: agent_sdks/python
         run: uv build .

.github/workflows/python_samples_build.yml

@@ -55,10 +55,6 @@ jobs:
         run: |
           PYTHONPATH=agent_sdks/python/src uv run --project agent_sdks/python pytest -vv samples/agent/adk/tests/test_examples_validation.py
 
-      - name: Build contact_lookup
-        working-directory: samples/agent/adk/contact_lookup
-        run: uv build .
-
       - name: Build orchestrator
         working-directory: samples/agent/adk/orchestrator
         run: uv build .
@@ -68,5 +64,5 @@ jobs:
         run: uv build .
 
       - name: Build rizzcharts
-        working-directory: samples/agent/adk/rizzcharts
+        working-directory: samples/agent/adk/rizzcharts/python
         run: uv build .

.github/workflows/react_renderer.yml

@@ -47,6 +47,12 @@ jobs:
           npm ci
           npm run build
 
+      - name: Build markdown-it dependency
+        working-directory: ./renderers/markdown/markdown-it
+        run: |
+          npm ci
+          npm run build
+
       - name: Install React renderer deps
         working-directory: ./renderers/react
         run: npm ci
@@ -76,6 +82,12 @@ jobs:
           npm ci
           npm run build
 
+      - name: Build markdown-it dependency
+        working-directory: ./renderers/markdown/markdown-it
+        run: |
+          npm ci
+          npm run build
+
       - name: Install React renderer deps
         working-directory: ./renderers/react
         run: npm ci
@@ -105,6 +117,12 @@ jobs:
           npm ci
           npm run build
 
+      - name: Build markdown-it dependency
+        working-directory: ./renderers/markdown/markdown-it
+        run: |
+          npm ci
+          npm run build
+
       - name: Install React renderer deps
         working-directory: ./renderers/react
         run: npm ci

.github/workflows/web_build_and_test.yml

@@ -45,10 +45,15 @@ jobs:
         working-directory: ./renderers/web_core
         run: npm run build
 
+      - name: Lint web_core
+        working-directory: ./renderers/web_core
+        run: npm run lint
+
       - name: Test web_core
         working-directory: ./renderers/web_core
         run: npm run test
-  lint:
+  test-scripts:
+    runs-on: ubuntu-latest
     steps:
       - uses: actions/checkout@v6
 
@@ -57,14 +62,5 @@ jobs:
         with:
           node-version: '20'
 
-      - name: Install web_core dependencies
-        working-directory: ./renderers/web_core
-        run: npm i
-
-      - name: Build web_core
-        working-directory: ./renderers/web_core
-        run: npm run build
-
-      - name: Lint web_core
-        working-directory: ./renderers/web_core
-        run: npm run lint
+      - name: Run publish script integration test
+        run: node --test renderers/scripts/publish_npm.test.mjs

.gitignore

@@ -24,3 +24,7 @@ a2a_agents/python/a2ui_agent/src/a2ui/assets/**/*.json
 agent_sdks/python/src/a2ui/assets/**/*.json
 ## Generated files for sandbox frame.
 samples/client/angular/projects/mcp_calculator/public/mcp_apps_inner_iframe/
+
+## Generated files for a2ui-in-mcpapps
+samples/agent/mcp/a2ui-in-mcpapps/server/apps/dist
+samples/agent/mcp/a2ui-in-mcpapps/server/apps/public

agent_sdks/agent_sdk_guide.md

@@ -245,7 +245,7 @@ Implement `CatalogConfig` (and its `Provider`), `A2uiCatalog`, and an `Inference
 Implement `generateSystemPrompt`. Verify that it outputs valid Markdown with embedded JSON schemas and examples.
 
 ### Step 3: Parsing & Validation
-Implement `parseResponse` and validation. Hook up a standard JSON Schema validator for your language. Write unit tests to check if it rejects bad JSON and accepts good JSON.
+Implement `parseResponse` and validation. Hook up a standard JSON Schema validator for your language. Use the centralized YAML conformance suite in `agent_sdks/conformance/` to verify that your implementation handles streaming and validation edge cases identically to the reference implementation.
 
 ### Step 4: Transport (A2A)
 Create the helper utilities to wrap JSON in transport Parts (if needed for your ecosystem).
@@ -268,3 +268,11 @@ The A2UI Agent SDK is a multi-language ecosystem. While features may be implemen
 2.  **File Sync Issues**: The author or reviewer of the feature **must file issues** for the equivalent feature requests in all other supported languages to ensure they are tracked.
 3.  **Cross-Referencing**: Link these new issues back to the original Pull Request or issue for context and reference.
 4.  **Consistency Over Clones**: While implementations should be idiomatic to the target language, they must follow the same architectural patterns (Inference Strategies, Validators, Streaming Parsers) and protocol standards defined in this guide.
+
+---
+
+## 12. Conformance Testing
+
+To ensure behavioral parity across all SDK implementations (Python, Kotlin, etc.), the project maintains a language-agnostic conformance suite.
+
+For detailed information on the suite structure and how to use it in your SDK implementation, see the [Conformance Testing README](conformance/README.md).

agent_sdks/conformance/README.md

@@ -0,0 +1,16 @@
+# Conformance Testing
+
+To ensure behavioral parity across all SDK implementations (Python, Kotlin, etc.), the project maintains a language-agnostic conformance suite in this directory.
+
+## Suite Structure
+*   `parser.yaml`: Contains test cases for the `A2uiStreamParser`, verifying chunk buffering, incremental yielding, and edge cases like cut tokens.
+*   `validator.yaml`: Contains test cases for the `A2uiValidator`, verifying structural integrity, cycle detection, and reachability.
+*   `conformance_schema.json`: The JSON schema that validates the structure of the YAML test files themselves.
+
+## Usage in SDKs
+Each language SDK must implement a test harness that:
+1.  Reads the YAML files.
+2.  Feeds the inputs to the language's specific implementation of the parser/validator.
+3.  Asserts that the output matches the expected results defined in the YAML.
+
+Refer to `agent_sdks/python/tests/conformance/test_conformance.py` for a reference implementation of a harness.