a2ui-project · nan-yu · Jun 8, 2026 · Jun 2, 2026
diff --git a/.github/workflows/python_agent_sdk_build_and_test.yml b/.github/workflows/python_agent_sdk_build_and_test.yml
@@ -50,25 +50,25 @@ jobs:
           pip install uv
 
       - name: Check Formatting
-        working-directory: agent_sdks/python
+        working-directory: agent_sdks/python/a2ui_agent
         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
+        working-directory: agent_sdks/python/a2ui_agent
         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
+        working-directory: agent_sdks/python/a2ui_agent
         run: uv build .
 
       - name: Run validation scripts on assets packing
-        working-directory: agent_sdks/python
+        working-directory: agent_sdks/python/a2ui_agent
         run: uv run python tests/integration/verify_load_real.py
diff --git a/.github/workflows/python_samples_build.yml b/.github/workflows/python_samples_build.yml
@@ -56,7 +56,7 @@ jobs:
 
       - name: Validate Sample Examples
         run: |
-          PYTHONPATH=agent_sdks/python/src uv run --project agent_sdks/python pytest -vv samples/agent/adk/tests/test_examples_validation.py
+          PYTHONPATH=agent_sdks/python/a2ui_agent/src uv run --project agent_sdks/python/a2ui_agent pytest -vv samples/agent/adk/tests/test_examples_validation.py
 
       - name: Build orchestrator
         working-directory: samples/agent/adk/orchestrator

diff --git a/.gitignore b/.gitignore
@@ -18,8 +18,9 @@ coverage/
 # Generated spec assets in the agent SDK
 ## old agent SDK path
 a2a_agents/python/a2ui_agent/src/a2ui/assets/**/*.json
-## new agent SDK path
 agent_sdks/python/src/a2ui/assets/**/*.json
+## new agent SDK path
+agent_sdks/python/a2ui_agent/src/a2ui/assets/**/*.json
 ## Generated files for sandbox frame.
 samples/client/angular/projects/mcp_calculator/public/mcp_apps_inner_iframe/
 

diff --git a/agent_sdks/python/README.md → agent_sdks/python/a2ui_agent/README.md b/agent_sdks/python/README.md → agent_sdks/python/a2ui_agent/README.md
diff --git a/agent_sdks/python/agent_development.md → ...ks/python/a2ui_agent/agent_development.md b/agent_sdks/python/agent_development.md → ...ks/python/a2ui_agent/agent_development.md
diff --git a/agent_sdks/python/pack_specs_hook.py → ...sdks/python/a2ui_agent/pack_specs_hook.py b/agent_sdks/python/pack_specs_hook.py → ...sdks/python/a2ui_agent/pack_specs_hook.py
diff --git a/agent_sdks/python/pyproject.toml → agent_sdks/python/a2ui_agent/pyproject.toml b/agent_sdks/python/pyproject.toml → agent_sdks/python/a2ui_agent/pyproject.toml
diff --git a/agent_sdks/python/release.sh → agent_sdks/python/a2ui_agent/release.sh b/agent_sdks/python/release.sh → agent_sdks/python/a2ui_agent/release.sh
diff --git a/agent_sdks/python/src/a2ui/__init__.py → ...ks/python/a2ui_agent/src/a2ui/__init__.py b/agent_sdks/python/src/a2ui/__init__.py → ...ks/python/a2ui_agent/src/a2ui/__init__.py
diff --git a/agent_sdks/python/src/a2ui/a2a/extension.py → ...thon/a2ui_agent/src/a2ui/a2a/extension.py b/agent_sdks/python/src/a2ui/a2a/extension.py → ...thon/a2ui_agent/src/a2ui/a2a/extension.py
diff --git a/agent_sdks/python/src/a2ui/a2a/parts.py → ...s/python/a2ui_agent/src/a2ui/a2a/parts.py b/agent_sdks/python/src/a2ui/a2a/parts.py → ...s/python/a2ui_agent/src/a2ui/a2a/parts.py
diff --git a/agent_sdks/python/src/a2ui/adk/__init__.py → ...ython/a2ui_agent/src/a2ui/adk/__init__.py b/agent_sdks/python/src/a2ui/adk/__init__.py → ...ython/a2ui_agent/src/a2ui/adk/__init__.py
diff --git a/...ython/src/a2ui/adk/a2a/event_converter.py → ...agent/src/a2ui/adk/a2a/event_converter.py b/...ython/src/a2ui/adk/a2a/event_converter.py → ...agent/src/a2ui/adk/a2a/event_converter.py
diff --git a/...python/src/a2ui/adk/a2a/part_converter.py → ..._agent/src/a2ui/adk/a2a/part_converter.py b/...python/src/a2ui/adk/a2a/part_converter.py → ..._agent/src/a2ui/adk/a2a/part_converter.py
diff --git a/...c/a2ui/adk/send_a2ui_to_client_toolset.py → ...c/a2ui/adk/send_a2ui_to_client_toolset.py b/...c/a2ui/adk/send_a2ui_to_client_toolset.py → ...c/a2ui/adk/send_a2ui_to_client_toolset.py
diff --git a/...python/src/a2ui/basic_catalog/__init__.py → ..._agent/src/a2ui/basic_catalog/__init__.py b/...python/src/a2ui/basic_catalog/__init__.py → ..._agent/src/a2ui/basic_catalog/__init__.py
diff --git a/...ython/src/a2ui/basic_catalog/constants.py → ...agent/src/a2ui/basic_catalog/constants.py b/...ython/src/a2ui/basic_catalog/constants.py → ...agent/src/a2ui/basic_catalog/constants.py
diff --git a/...python/src/a2ui/basic_catalog/provider.py → ..._agent/src/a2ui/basic_catalog/provider.py b/...python/src/a2ui/basic_catalog/provider.py → ..._agent/src/a2ui/basic_catalog/provider.py
diff --git a/...dks/python/src/a2ui/inference_strategy.py → ...a2ui_agent/src/a2ui/inference_strategy.py b/...dks/python/src/a2ui/inference_strategy.py → ...a2ui_agent/src/a2ui/inference_strategy.py
diff --git a/...t_sdks/python/src/a2ui/parser/__init__.py → ...on/a2ui_agent/src/a2ui/parser/__init__.py b/...t_sdks/python/src/a2ui/parser/__init__.py → ...on/a2ui_agent/src/a2ui/parser/__init__.py
diff --git a/..._sdks/python/src/a2ui/parser/constants.py → ...n/a2ui_agent/src/a2ui/parser/constants.py b/..._sdks/python/src/a2ui/parser/constants.py → ...n/a2ui_agent/src/a2ui/parser/constants.py
diff --git a/agent_sdks/python/src/a2ui/parser/parser.py → ...thon/a2ui_agent/src/a2ui/parser/parser.py b/agent_sdks/python/src/a2ui/parser/parser.py → ...thon/a2ui_agent/src/a2ui/parser/parser.py
diff --git a/...s/python/src/a2ui/parser/payload_fixer.py → ...ui_agent/src/a2ui/parser/payload_fixer.py b/...s/python/src/a2ui/parser/payload_fixer.py → ...ui_agent/src/a2ui/parser/payload_fixer.py
diff --git a/...s/python/src/a2ui/parser/response_part.py → ...ui_agent/src/a2ui/parser/response_part.py b/...s/python/src/a2ui/parser/response_part.py → ...ui_agent/src/a2ui/parser/response_part.py
diff --git a/..._sdks/python/src/a2ui/parser/streaming.py → ...n/a2ui_agent/src/a2ui/parser/streaming.py b/..._sdks/python/src/a2ui/parser/streaming.py → ...n/a2ui_agent/src/a2ui/parser/streaming.py
diff --git a/...s/python/src/a2ui/parser/streaming_v08.py → ...ui_agent/src/a2ui/parser/streaming_v08.py b/...s/python/src/a2ui/parser/streaming_v08.py → ...ui_agent/src/a2ui/parser/streaming_v08.py
diff --git a/...s/python/src/a2ui/parser/streaming_v09.py → ...ui_agent/src/a2ui/parser/streaming_v09.py b/...s/python/src/a2ui/parser/streaming_v09.py → ...ui_agent/src/a2ui/parser/streaming_v09.py
diff --git a/...t_sdks/python/src/a2ui/schema/__init__.py → ...on/a2ui_agent/src/a2ui/schema/__init__.py b/...t_sdks/python/src/a2ui/schema/__init__.py → ...on/a2ui_agent/src/a2ui/schema/__init__.py
diff --git a/agent_sdks/python/src/a2ui/schema/catalog.py → ...hon/a2ui_agent/src/a2ui/schema/catalog.py b/agent_sdks/python/src/a2ui/schema/catalog.py → ...hon/a2ui_agent/src/a2ui/schema/catalog.py
diff --git a/...ython/src/a2ui/schema/catalog_provider.py → ...agent/src/a2ui/schema/catalog_provider.py b/...ython/src/a2ui/schema/catalog_provider.py → ...agent/src/a2ui/schema/catalog_provider.py
diff --git a/...ython/src/a2ui/schema/common_modifiers.py → ...agent/src/a2ui/schema/common_modifiers.py b/...ython/src/a2ui/schema/common_modifiers.py → ...agent/src/a2ui/schema/common_modifiers.py
diff --git a/..._sdks/python/src/a2ui/schema/constants.py → ...n/a2ui_agent/src/a2ui/schema/constants.py b/..._sdks/python/src/a2ui/schema/constants.py → ...n/a2ui_agent/src/a2ui/schema/constants.py
diff --git a/agent_sdks/python/src/a2ui/schema/manager.py → ...hon/a2ui_agent/src/a2ui/schema/manager.py b/agent_sdks/python/src/a2ui/schema/manager.py → ...hon/a2ui_agent/src/a2ui/schema/manager.py
diff --git a/agent_sdks/python/src/a2ui/schema/utils.py → ...ython/a2ui_agent/src/a2ui/schema/utils.py b/agent_sdks/python/src/a2ui/schema/utils.py → ...ython/a2ui_agent/src/a2ui/schema/utils.py
diff --git a/..._sdks/python/src/a2ui/schema/validator.py → ...n/a2ui_agent/src/a2ui/schema/validator.py b/..._sdks/python/src/a2ui/schema/validator.py → ...n/a2ui_agent/src/a2ui/schema/validator.py
diff --git a/...sdks/python/src/a2ui/template/__init__.py → .../a2ui_agent/src/a2ui/template/__init__.py b/...sdks/python/src/a2ui/template/__init__.py → .../a2ui_agent/src/a2ui/template/__init__.py
diff --git a/..._sdks/python/src/a2ui/template/manager.py → ...n/a2ui_agent/src/a2ui/template/manager.py b/..._sdks/python/src/a2ui/template/manager.py → ...n/a2ui_agent/src/a2ui/template/manager.py
diff --git a/agent_sdks/python/src/a2ui/version.py → ...dks/python/a2ui_agent/src/a2ui/version.py b/agent_sdks/python/src/a2ui/version.py → ...dks/python/a2ui_agent/src/a2ui/version.py
diff --git a/agent_sdks/python/tests/__init__.py → ..._sdks/python/a2ui_agent/tests/__init__.py b/agent_sdks/python/tests/__init__.py → ..._sdks/python/a2ui_agent/tests/__init__.py
diff --git a/...hon/tests/adk/a2a/test_event_converter.py → ...ent/tests/adk/a2a/test_event_converter.py b/...hon/tests/adk/a2a/test_event_converter.py → ...ent/tests/adk/a2a/test_event_converter.py
diff --git a/...thon/tests/adk/a2a/test_part_converter.py → ...gent/tests/adk/a2a/test_part_converter.py b/...thon/tests/adk/a2a/test_part_converter.py → ...gent/tests/adk/a2a/test_part_converter.py
diff --git a/...s/adk/test_send_a2ui_to_client_toolset.py → ...s/adk/test_send_a2ui_to_client_toolset.py b/...s/adk/test_send_a2ui_to_client_toolset.py → ...s/adk/test_send_a2ui_to_client_toolset.py
diff --git a/...tests/conformance/test_a2a_integration.py → ...tests/conformance/test_a2a_integration.py b/...tests/conformance/test_a2a_integration.py → ...tests/conformance/test_a2a_integration.py
@@ -20,7 +20,7 @@
 
 def _get_conformance_path(filename):
   return os.path.abspath(
-      os.path.join(os.path.dirname(__file__), "../../../conformance", filename)
+      os.path.join(os.path.dirname(__file__), "../../../../conformance", filename)
   )
 
 

diff --git a/.../tests/conformance/test_adk_extensions.py → .../tests/conformance/test_adk_extensions.py b/.../tests/conformance/test_adk_extensions.py → .../tests/conformance/test_adk_extensions.py
@@ -21,7 +21,7 @@
 
 def _get_conformance_path(filename):
   return os.path.abspath(
-      os.path.join(os.path.dirname(__file__), "../../../conformance", filename)
+      os.path.join(os.path.dirname(__file__), "../../../../conformance", filename)
   )
 
 

diff --git a/...hon/tests/conformance/test_conformance.py → ...ent/tests/conformance/test_conformance.py b/...hon/tests/conformance/test_conformance.py → ...ent/tests/conformance/test_conformance.py
@@ -39,7 +39,7 @@ def load(self):
 
 def _get_conformance_path(filename):
   return os.path.abspath(
-      os.path.join(os.path.dirname(__file__), "../../../conformance", filename)
+      os.path.join(os.path.dirname(__file__), "../../../../conformance", filename)
   )
 
 
@@ -229,7 +229,9 @@ def test_catalog_conformance(name, test_case):
   elif action == "load":
     path = args.get("path")
     if path:
-      full_path = os.path.join(os.path.dirname(__file__), "../../../conformance", path)
+      full_path = os.path.join(
+          os.path.dirname(__file__), "../../../../conformance", path
+      )
     else:
       full_path = None
     validate = args.get("validate", False)
@@ -298,7 +300,7 @@ def test_schema_manager_conformance(name, test_case):
     configs = []
     for cfg in catalog_configs:
       full_path = os.path.join(
-          os.path.dirname(__file__), "../../../conformance", cfg["path"]
+          os.path.dirname(__file__), "../../../../conformance", cfg["path"]
       )
       configs.append(CatalogConfig.from_path(name=cfg["name"], catalog_path=full_path))
     manager = A2uiSchemaManager(
@@ -322,7 +324,7 @@ def test_schema_manager_conformance(name, test_case):
     examples_path = args.get("examples_path")
     if examples_path:
       examples_path = os.path.join(
-          os.path.dirname(__file__), "../../../conformance", examples_path
+          os.path.dirname(__file__), "../../../../conformance", examples_path
       )
 
     config = BasicCatalog.get_config(version)

diff --git a/...hon/tests/integration/verify_load_real.py → ...ent/tests/integration/verify_load_real.py b/...hon/tests/integration/verify_load_real.py → ...ent/tests/integration/verify_load_real.py
diff --git a/...python/tests/parser/test_streaming_v08.py → ..._agent/tests/parser/test_streaming_v08.py b/...python/tests/parser/test_streaming_v08.py → ..._agent/tests/parser/test_streaming_v08.py
diff --git a/...python/tests/parser/test_streaming_v09.py → ..._agent/tests/parser/test_streaming_v09.py b/...python/tests/parser/test_streaming_v09.py → ..._agent/tests/parser/test_streaming_v09.py
diff --git a/..._sdks/python/tests/schema/test_catalog.py → ...n/a2ui_agent/tests/schema/test_catalog.py b/..._sdks/python/tests/schema/test_catalog.py → ...n/a2ui_agent/tests/schema/test_catalog.py
diff --git a/...ython/tests/schema/test_schema_manager.py → ...agent/tests/schema/test_schema_manager.py b/...ython/tests/schema/test_schema_manager.py → ...agent/tests/schema/test_schema_manager.py
diff --git a/...dks/python/tests/schema/test_validator.py → ...a2ui_agent/tests/schema/test_validator.py b/...dks/python/tests/schema/test_validator.py → ...a2ui_agent/tests/schema/test_validator.py
diff --git a/agent_sdks/python/uv.lock → agent_sdks/python/a2ui_agent/uv.lock b/agent_sdks/python/uv.lock → agent_sdks/python/a2ui_agent/uv.lock
diff --git a/eval/pyproject.toml b/eval/pyproject.toml
@@ -33,4 +33,4 @@ url = "https://pypi.org/simple"
 default = true
 
 [tool.uv.sources]
-a2ui-agent-sdk = { path = "../agent_sdks/python", editable = true }
+a2ui-agent-sdk = { path = "../agent_sdks/python/a2ui_agent", editable = true }
diff --git a/eval/uv.lock b/eval/uv.lock
diff --git a/samples/agent/adk/custom-components-example/pyproject.toml b/samples/agent/adk/custom-components-example/pyproject.toml
@@ -44,4 +44,4 @@ build-backend = "hatchling.build"
 allow-direct-references = true
 
 [tool.uv.sources]
-a2ui-agent-sdk = { path = "../../../../agent_sdks/python", editable = true }
+a2ui-agent-sdk = { path = "../../../../agent_sdks/python/a2ui_agent", editable = true }
diff --git a/samples/agent/adk/mcp_app_proxy/pyproject.toml b/samples/agent/adk/mcp_app_proxy/pyproject.toml
@@ -46,4 +46,4 @@ build-backend = "hatchling.build"
 packages = ["."]
 
 [tool.uv.sources]
-a2ui-agent-sdk = { path = "../../../../agent_sdks/python", editable = true }
+a2ui-agent-sdk = { path = "../../../../agent_sdks/python/a2ui_agent", editable = true }
diff --git a/samples/agent/adk/orchestrator/pyproject.toml b/samples/agent/adk/orchestrator/pyproject.toml
@@ -45,4 +45,4 @@ url = "https://pypi.org/simple"
 default = true
 
 [tool.uv.sources]
-a2ui-agent-sdk = { path = "../../../../agent_sdks/python", editable = true }
+a2ui-agent-sdk = { path = "../../../../agent_sdks/python/a2ui_agent", editable = true }
diff --git a/samples/agent/adk/pyproject.toml b/samples/agent/adk/pyproject.toml
@@ -20,7 +20,7 @@ default = true
 members = ["custom-components-example", "orchestrator", "restaurant_finder", "rizzcharts/python", "mcp_app_proxy"]
 
 [tool.uv.sources]
-a2ui-agent-sdk = { path = "../../../agent_sdks/python", editable = true }
+a2ui-agent-sdk = { path = "../../../agent_sdks/python/a2ui_agent", editable = true }
 
 [tool.pyink]
 unstable = true

diff --git a/samples/agent/adk/restaurant_finder/pyproject.toml b/samples/agent/adk/restaurant_finder/pyproject.toml
@@ -44,4 +44,4 @@ url = "https://pypi.org/simple"
 default = true
 
 [tool.uv.sources]
-a2ui-agent-sdk = { path = "../../../../agent_sdks/python", editable = true }
+a2ui-agent-sdk = { path = "../../../../agent_sdks/python/a2ui_agent", editable = true }
diff --git a/samples/agent/adk/rizzcharts/python/pyproject.toml b/samples/agent/adk/rizzcharts/python/pyproject.toml
@@ -44,4 +44,4 @@ url = "https://pypi.org/simple"
 default = true
 
 [tool.uv.sources]
-a2ui-agent-sdk = { path = "../../../../../agent_sdks/python", editable = true }
+a2ui-agent-sdk = { path = "../../../../../agent_sdks/python/a2ui_agent", editable = true }
diff --git a/samples/agent/adk/uv.lock b/samples/agent/adk/uv.lock
diff --git a/samples/mcp/a2ui-over-mcp-recipe/pyproject.toml b/samples/mcp/a2ui-over-mcp-recipe/pyproject.toml
@@ -37,7 +37,7 @@ url = "https://pypi.org/simple"
 default = true
 
 [tool.uv.sources]
-a2ui-agent-sdk = { path = "../../../agent_sdks/python", editable = true }
+a2ui-agent-sdk = { path = "../../../agent_sdks/python/a2ui_agent", editable = true }
 
 [tool.pyright]
 include = ["."]