Merge branch 'main' into feat/generic-a2ui-react-renderer

Author: sugoi-yuzuru

.github/workflows/kotlin_agent_sdk_build_and_test.yml

@@ -19,12 +19,12 @@ on:
     branches:
       - "*"
     paths:
-      - "agent_sdks/kotlin/**"
+      - "kotlin/agent_sdk_legacy/**"
       - "specification/**/json/**"
       - "agent_sdks/conformance/**"
   pull_request:
     paths:
-      - "agent_sdks/kotlin/**"
+      - "kotlin/agent_sdk_legacy/**"
       - "specification/**/json/**"
       - "agent_sdks/conformance/**"
 
@@ -49,13 +49,13 @@ jobs:
           cache: "gradle"
 
       - name: Make gradlew executable
-        working-directory: agent_sdks/kotlin
+        working-directory: kotlin/agent_sdk_legacy
         run: chmod +x gradlew
 
       - name: Check formatting
-        working-directory: agent_sdks/kotlin
+        working-directory: kotlin/agent_sdk_legacy
         run: ./gradlew ktfmtCheck
 
       - name: Run tests
-        working-directory: agent_sdks/kotlin
+        working-directory: kotlin/agent_sdk_legacy
         run: ./gradlew test --info

AGENTS.md

@@ -57,7 +57,8 @@ For a detailed explanation of the methodology, lifecycle, and workflows, read th
 - **`blueprints/`**: Isolated central repository for language-agnostic module blueprints (`modules/`), feature blueprints (`features/`, `features/archived/`), codebase compliance blueprints (`codebases/`), and SDD skills (`skills/`).
 - **`docs/`**: Documentation hierarchy. Public site documentation published via MkDocs resides in `docs/public/`, while non-public contributor or internal documentation resides under `docs/` alongside `docs/scripts/`.
 - **`specification/`**: Versioned subdirectories (`v0_8/`, `v0_9/`, `v0_9_1/`, `v1_0/`) containing JSON schemas, component/function catalogs, and human-readable guides. The `specification/<version>/docs/a2ui_protocol.md` file is the most important source of truth for each protocol version, and the `specification/<version>/json` directory contains the associated schemas for the protocol.
-- **`agent_sdks/`**: Server integration SDKs for Python (`python/`), Kotlin (`kotlin/`), and core conformance tests (`conformance/`).
+- **`agent_sdks/`**: Server integration SDKs for Python (`python/`) and core conformance tests (`conformance/`).
+- **`kotlin/`**: Legacy Kotlin agent SDK (`agent_sdk_legacy/`).
 - **`renderers/`**: Shared core state logic (`web_core/`), Lit renderer (`lit/`), Angular renderer (`angular/`), React renderer (`react/`), markdown parser (`markdown/`), and placeholder for Flutter (`flutter/`).
 - **`samples/`**: Ready-to-run demo agents utilizing Python ADK (`agent/adk/`), MCP server (`agent/mcp/`), and sample clients (`client/lit/`, `client/angular/`, `client/react/`, `client/flutter/`).
 - **`tools/`**: Developer utility suite including visual Editor (`editor/`), visual Composer (`composer/`), payload Inspector (`inspector/`), and catalog builder (`build_catalog/`).
@@ -84,7 +85,7 @@ When creating or modifying workspaces, guarantee strict script uniformity by imp
 Do not use hardcoded or guessed build/run sequences. Each subdirectory contains detailed setup, build, dependency resolution, and execution steps.
 
 - **Prerequisite:** Consult the `README.md` under `renderers/` to build shared web core and renderer packages before running any web tools or clients.
-- **Running SDKs & Samples:** Consult the local `README.md` inside any targeted directory under `agent_sdks/`, `samples/`, or `tools/` for specific run/test/build commands.
+- **Running SDKs & Samples:** Consult the local `README.md` inside any targeted directory under `agent_sdks/`, `kotlin/`, `samples/`, or `tools/` for specific run/test/build commands.
 
 ---