Skip to content

Commit 1ca2bd1

Browse files
authored
Restructure the agent_sdks folder (#711)
The code is reorganized with the following structure ``` agent_sdks/python - src/a2ui - a2a.py - basic_catalog - provider.py - core - schema - manager.py - validation.py - payload_fixer.py - ... - template - ... - inference_stategy.py - adk - a2a_extension - send_a2ui_to_client_toolset.py ``` Tested: - [x] All individual sample ADKs are working with connected client. - [x] The orchestrator sample is also working with all sub-agents.
1 parent 5cd5eb1 commit 1ca2bd1

Some content is hidden

Large Commits have some content hidden by default. Use the searchbox below for content that may be hidden.

69 files changed

+227
-225
lines changed

.gemini/GEMINI.md

Lines changed: 2 additions & 2 deletions
Original file line numberDiff line numberDiff line change
@@ -20,8 +20,8 @@ The A2UI repository is organized into several key directories:
2020
- `lit/`: Clients using Lit and Vite (e.g., `contact`, `shell`).
2121
- `angular/`: Clients using Angular.
2222
- `mcp/`: MCP server samples (e.g., `flight_booking`).
23-
- `a2a_agents/`: Contains source code for A2A extension integrations.
24-
- `python/a2ui_agent/`: Python implementation of the A2UI agent library.
23+
- `agent_sdks/`: Contains source code for Agent integrations.
24+
- `python/`: Python implementation of the A2UI agent library.
2525
- `java/`: Java implementation of the A2UI agent library.
2626
- `renderers/`: Contains renderer libraries.
2727
- `lit/`: The shared Lit renderer library used by the Lit clients.

.github/CODEOWNERS

Lines changed: 1 addition & 1 deletion
Original file line numberDiff line numberDiff line change
@@ -15,7 +15,7 @@
1515
* @dmandar @gspencergoog @jacobsimionato @nan-yu @ditman @zeroasterisk @yjbanov
1616

1717
# Agents
18-
/a2a_agents/ @nan-yu @dmandar @gspencergoog
18+
/agent_sdks/ @nan-yu @dmandar @gspencergoog
1919

2020
# Renderers
2121
/renderers/angular/ @ditman @ava-cassiopeia @crisbeto

.github/workflows/java_build_and_test.yml

Lines changed: 4 additions & 4 deletions
Original file line numberDiff line numberDiff line change
@@ -19,11 +19,11 @@ on:
1919
branches:
2020
- main
2121
paths:
22-
- 'a2a_agents/java/**'
22+
- 'agent_sdks/java/**'
2323
- 'specification/**/json/**'
2424
pull_request:
2525
paths:
26-
- 'a2a_agents/java/**'
26+
- 'agent_sdks/java/**'
2727
- 'specification/**/json/**'
2828

2929
jobs:
@@ -42,9 +42,9 @@ jobs:
4242
distribution: 'temurin'
4343

4444
- name: Build with Maven
45-
working-directory: a2a_agents/java
45+
working-directory: agent_sdks/java
4646
run: mvn clean install
4747

4848
- name: Run Tests
49-
working-directory: a2a_agents/java
49+
working-directory: agent_sdks/java
5050
run: mvn test

.github/workflows/python_a2ui_agent_build_and_test.yml renamed to .github/workflows/python_agent_sdk_build_and_test.yml

Lines changed: 6 additions & 6 deletions
Original file line numberDiff line numberDiff line change
@@ -19,11 +19,11 @@ on:
1919
branches:
2020
- '*'
2121
paths:
22-
- 'a2a_agents/python/a2ui_agent/**'
22+
- 'agent_sdks/python/**'
2323
- 'specification/**/json/**'
2424
pull_request:
2525
paths:
26-
- 'a2a_agents/python/a2ui_agent/**'
26+
- 'agent_sdks/python/**'
2727
- 'specification/**/json/**'
2828

2929
jobs:
@@ -45,17 +45,17 @@ jobs:
4545
pip install uv
4646
4747
- name: Check Formatting
48-
working-directory: a2a_agents/python/a2ui_agent
48+
working-directory: agent_sdks/python
4949
run: uv run pyink --check .
5050

5151
- name: Run unit tests
52-
working-directory: a2a_agents/python/a2ui_agent
52+
working-directory: agent_sdks/python
5353
run: uv run --with pytest pytest tests/
5454

5555
- name: Build the python SDK
56-
working-directory: a2a_agents/python/a2ui_agent
56+
working-directory: agent_sdks/python
5757
run: uv build .
5858

5959
- name: Run validation scripts on assets packing
60-
working-directory: a2a_agents/python/a2ui_agent
60+
working-directory: agent_sdks/python
6161
run: uv run python tests/integration/verify_load_real.py

.github/workflows/python_samples_build.yml

Lines changed: 2 additions & 2 deletions
Original file line numberDiff line numberDiff line change
@@ -20,12 +20,12 @@ on:
2020
- main
2121
paths:
2222
- 'samples/agent/adk/**'
23-
- 'a2a_agents/python/a2ui_agent/**'
23+
- 'agent_sdks/python/**'
2424
- 'specification/**/json/**'
2525
pull_request:
2626
paths:
2727
- 'samples/agent/adk/**'
28-
- 'a2a_agents/python/a2ui_agent/**'
28+
- 'agent_sdks/python/**'
2929
- 'specification/**/json/**'
3030

3131
jobs:

a2a_agents/python/a2ui_agent/src/a2ui/extension/a2ui_schema_utils.py

Lines changed: 0 additions & 34 deletions
This file was deleted.

a2a_agents/python/a2ui_agent/agent_development.md renamed to agent_sdks/agent_development.md

Lines changed: 6 additions & 6 deletions
Original file line numberDiff line numberDiff line change
@@ -1,10 +1,10 @@
11
# A2A Agent Development Guide
22

3-
This guide explains how to build AI agents that generate A2UI interfaces using the `a2ui_agent` SDK. The SDK simplifies schema management, prompt engineering, and message validation for A2A (Agent-to-Agent/Agent-to-Client) communication.
3+
This guide explains how to build AI agents that generate A2UI interfaces using `agent_sdk`. The SDK simplifies schema management, prompt engineering, and message validation for A2A (Agent-to-Agent/Agent-to-Client) communication.
44

55
## Core Concepts
66

7-
The `a2ui_agent` SDK revolves around three main classes:
7+
The `agent_sdk` revolves around three main classes:
88

99
* **`CatalogConfig`**: Defines the metadata for a component catalog (name, schema path, examples path).
1010
* **`A2uiCatalog`**: Represents a processed catalog, providing methods for validation and LLM instruction rendering.
@@ -17,9 +17,9 @@ The `a2ui_agent` SDK revolves around three main classes:
1717
The first step in any A2UI-enabled agent is initializing the `A2uiSchemaManager`.
1818

1919
```python
20-
from a2ui.inference.schema.constants import VERSION_0_8
21-
from a2ui.inference.schema.manager import A2uiSchemaManager, CatalogConfig
22-
from a2ui.inference.basic_catalog.provider import BasicCatalog
20+
from a2ui.core.schema.constants import VERSION_0_8
21+
from a2ui.core.schema.manager import A2uiSchemaManager, CatalogConfig
22+
from a2ui.basic_catalog.provider import BasicCatalog
2323

2424
schema_manager = A2uiSchemaManager(
2525
version=VERSION_0_8,
@@ -118,7 +118,7 @@ After parsing and validating the A2UI JSON payloads, wrap them in an A2A DataPar
118118

119119
To ensure the A2UI Renderers on the frontend recognize the data, add `{"mimeType": "application/json+a2ui"}` to the DataPart's metadata.
120120

121-
**Recommendation:** Use the [create_a2ui_datapart](src/a2ui/extension/a2ui_extension.py#L37-L54) helper method to convert A2UI JSON payloads into an A2A DataPart.
121+
**Recommendation:** Use the [create_a2ui_datapart](src/a2ui/a2a.py#L37-L54) helper method to convert A2UI JSON payloads into an A2A DataPart.
122122

123123
## Use Cases
124124

a2a_agents/java/src/main/java/org/a2ui/A2uiExtension.java renamed to agent_sdks/java/src/main/java/org/a2ui/A2uiExtension.java

File renamed without changes.

0 commit comments

Comments
 (0)