update docs

Author: maxkorp

CLAUDE.md

@@ -6,8 +6,6 @@ This file provides guidance to Claude Code (claude.ai/code) when working with co
 
 ### TypeScript SDK (Main Development)
 ```bash
-# Navigate to typescript-sdk directory for all TypeScript work
-cd typescript-sdk
 
 # Install dependencies (using pnpm)
 pnpm install
@@ -55,11 +53,11 @@ poetry build
 ### Running Specific Integration Tests
 ```bash
 # For TypeScript packages/integrations
-cd typescript-sdk/packages/<package-name>
+cd packages/<package-name>
 pnpm test
 
 # For running a single test file
-cd typescript-sdk/packages/<package-name>
+cd packages/<package-name>
 pnpm test -- path/to/test.spec.ts
 ```
 
@@ -78,11 +76,11 @@ AG-UI is an event-based protocol that standardizes agent-user interactions. The
 3. **Event Types**: Lifecycle events (RUN_STARTED/FINISHED), message events (TEXT_MESSAGE_*), tool events (TOOL_CALL_*), and state management events (STATE_SNAPSHOT/DELTA)
 
 ### Repository Structure
-- `/typescript-sdk/`: Main TypeScript implementation
+- `/sdks/typescript/`: Main TypeScript implementation
   - `/packages/`: Core protocol packages (@ag-ui/core, @ag-ui/client, @ag-ui/encoder, @ag-ui/proto)
-  - `/integrations/`: Framework integrations (langgraph, mastra, crewai, etc.)
-  - `/apps/`: Example applications including the AG-UI Dojo demo viewer
-- `/python-sdk/`: Python implementation of the protocol
+- `/integrations/`: Framework integrations (langgraph, mastra, crewai, etc.)
+- `/apps/`: Example applications including the AG-UI Dojo demo viewer
+- `/sdks/python/`: Python implementation of the protocol
 - `/docs/`: Documentation site content
 
 ### Integration Pattern
@@ -108,4 +106,4 @@ Each framework integration follows a similar pattern:
 - Turbo is used for monorepo build orchestration
 - Each package has independent versioning
 - Integration tests demonstrate protocol compliance
-- The AG-UI Dojo app showcases all protocol features with live examples
+- The AG-UI Dojo app showcases all protocol features with live examples

README.md

@@ -63,8 +63,8 @@ AG-UI is complementary to the other 2 top agentic protocols
 
 <div align="center">
   <img width="2048" height="1182" alt="The Agent Protocol Stack" src="https://github.com/user-attachments/assets/41138f71-50be-4812-98aa-20e0ad595716" />
-</div>  
-   
+</div>
+
 ## 🚀 Features
 
 - 💬 Real-time agentic chat with streaming
@@ -138,9 +138,9 @@ https://agui-demo.vercel.app/
 
 
 ## The AG-UI Dojo (Building-Blocks Viewer)
-The AG-UI Dojo demonstrates AG-UI's core building blocks through simple, focused examples—each just 50-200 lines of code. 
+The AG-UI Dojo demonstrates AG-UI's core building blocks through simple, focused examples—each just 50-200 lines of code.
 
-View the source code for the Dojo and all framework integrations [here](https://github.com/ag-ui-protocol/ag-ui/tree/main/typescript-sdk/apps/dojo).
+View the source code for the Dojo and all framework integrations [here](https://github.com/ag-ui-protocol/ag-ui/tree/main/apps/dojo).
 
 https://github.com/user-attachments/assets/c298eea8-3f39-4a94-b968-7712429b0c49
 
@@ -150,7 +150,7 @@ https://github.com/user-attachments/assets/c298eea8-3f39-4a94-b968-7712429b0c49
 
 Check out the [Contributing guide](https://github.com/ag-ui-protocol/ag-ui/blob/main/CONTRIBUTING.md)
 
-- **[Bi-Weekely AG-UI Working Group](https://lu.ma/CopilotKit?k=c)**  
+- **[Bi-Weekely AG-UI Working Group](https://lu.ma/CopilotKit?k=c)**
   📅 Follow the CopilotKit Luma Events Calendar
 
 ## Roadmap
@@ -160,4 +160,4 @@ Check out the [AG-UI Roadmap](https://github.com/orgs/ag-ui-protocol/projects/1)
 
 ## 📄 License
 
-AG-UI is open source software [licensed as MIT](https://opensource.org/licenses/MIT).  
+AG-UI is open source software [licensed as MIT](https://opensource.org/licenses/MIT).

docs/development/contributing.mdx

@@ -5,13 +5,13 @@ description: How to participate in Agent User Interaction Protocol development
 
 # Naming conventions
 
-Add your package under `typescript-sdk/integrations/` with docs and tests.
+Add your package under `integrations/` with docs and tests.
 
 If your integration is work in progress, you can still add it to main branch.
 You can prefix it with `wip-`, i.e.
-(`typescript-sdk/integrations/wip-your-integration`) or if you're a third party
+(`integrations/wip-your-integration`) or if you're a third party
 contributor use the `community` prefix, i.e.
-(`typescript-sdk/integrations/community-your-integration`).
+(`integrations/community/your-integration`).
 
 For questions and discussions, please use
 [GitHub Discussions](https://github.com/ag-ui-protocol/ag-ui/discussions).

docs/quickstart/middleware.mdx

@@ -72,11 +72,11 @@ curl -fsSL https://get.pnpm.io/install.sh | sh -
 
 ## Step 1 – Scaffold your integration
 
-Start by cloning the repo and navigating to the TypeScript SDK:
+Start by cloning the repo
 
 ```bash
 git clone [email protected]:ag-ui-protocol/ag-ui.git
-cd ag-ui/typescript-sdk
+cd ag-ui/
 ```
 
 Copy the middleware-starter template to create your OpenAI integration:
@@ -417,7 +417,7 @@ Did you build a custom adapter that others could reuse? We welcome community
 contributions!
 
 1. Fork the [AG-UI repository](https://github.com/ag-ui-protocol/ag-ui)
-2. Add your package under `typescript-sdk/integrations/`. See
+2. Add your package under `integrations`. See
    [Contributing](../development/contributing) for more details and naming
    conventions.
 3. Open a pull request describing your use-case and design decisions

docs/quickstart/server.mdx

@@ -68,11 +68,11 @@ curl -fsSL https://get.pnpm.io/install.sh | sh -
 
 ## Step 1 – Scaffold your server
 
-Start by cloning the repo and navigating to the TypeScript SDK:
+Start by cloning the repo:
 
 ```bash
 git clone [email protected]:ag-ui-protocol/ag-ui.git
-cd ag-ui/typescript-sdk
+cd ag-ui
 ```
 
 Copy the server-starter template to create your OpenAI server:
@@ -181,8 +181,6 @@ poetry install && poetry run dev
 In another terminal, start the dojo:
 
 ```bash
-cd typescript-sdk
-
 # Install dependencies
 pnpm install
 
@@ -442,7 +440,7 @@ Did you build a custom server that others could reuse? We welcome community
 contributions!
 
 1. Fork the [AG-UI repository](https://github.com/ag-ui-protocol/ag-ui)
-2. Add your package under `typescript-sdk/integrations/`. See
+2. Add your package under `integrations/`. See
    [Contributing](../development/contributing) for more details and naming
    conventions.
 3. Open a pull request describing your use-case and design decisions

integrations/adk-middleware/python/README.md

@@ -18,10 +18,10 @@ To use this integration you need to:
     git clone https://github.com/ag-ui-protocol/ag-ui.git
     ```
 
-2. Change to the `typescript-sdk/integrations/adk-middleware` directory.
+2. Change to the `integrations/adk-middleware/python` directory.
 
     ```bash
-    cd typescript-sdk/integrations/adk-middleware
+    cd integrations/adk-middleware/python
     ```
 
 3. Install the `adk-middleware` package from the local directory.  For example,
@@ -61,7 +61,6 @@ To use this integration you need to:
 7. Start the integration ag-ui dojo:
 
     ```bash
-    cd typescript-sdk
     pnpm install && pnpm run dev
     ```
 

integrations/adk-middleware/typescript/README.md

@@ -18,10 +18,10 @@ To use this integration you need to:
     git clone https://github.com/ag-ui-protocol/ag-ui.git
     ```
 
-2. Change to the `typescript-sdk/integrations/adk-middleware` directory.
+2. Change to the `integrations/adk-middleware/python` directory.
 
     ```bash
-    cd typescript-sdk/integrations/adk-middleware
+    cd integrations/adk-middleware/python
     ```
 
 3. Install the `adk-middleware` package from the local directory.  For example,
@@ -30,12 +30,12 @@ To use this integration you need to:
     pip install .
     ```
 
-    or 
+    or
 
     ```bash
     uv pip install .
     ```
-    
+
     This installs the package from the current directory which contains:
     - `src/adk_middleware/` - The middleware source code
     - `examples/` - Example servers and agents
@@ -61,7 +61,6 @@ To use this integration you need to:
 7. Start the integration ag-ui dojo:
 
     ```bash
-    cd typescript-sdk
     pnpm install && pnpm run dev
     ```
 
@@ -125,7 +124,7 @@ my_agent = Agent(
 # 2. Create the middleware with direct agent embedding
 agent = ADKAgent(
     adk_agent=my_agent,
-    app_name="my_app", 
+    app_name="my_app",
     user_id="user123"
 )
 
@@ -150,7 +149,7 @@ my_agent = Agent(
 # 2. Create the middleware with direct agent embedding
 agent = ADKAgent(
     adk_agent=my_agent,
-    app_name="my_app", 
+    app_name="my_app",
     user_id="user123"
 )
 
@@ -187,13 +186,13 @@ from ag_ui.core import RunAgentInput, UserMessage
 async def main():
     # Setup
     my_agent = Agent(name="assistant", instruction="You are a helpful assistant.")
-    
+
     agent = ADKAgent(
         adk_agent=my_agent,
-        app_name="demo_app", 
+        app_name="demo_app",
         user_id="demo"
     )
-    
+
     # Create input
     input = RunAgentInput(
         thread_id="thread_001",
@@ -206,7 +205,7 @@ async def main():
         tools=[],
         forwarded_props={}
     )
-    
+
     # Run and handle events
     async for event in agent.run(input):
         print(f"Event: {event.type}")

integrations/community/spring-ai/typescript/README.md

@@ -39,6 +39,6 @@ const result = await agent.runAgent({
 ## To run the example server in the dojo
 
 ```bash
-cd typescript-sdk/integrations/llamaindex/server-py
+cd integrations/llama-index/python/examples
 uv sync && uv run dev
 ```

integrations/crew-ai/typescript/README.md

@@ -39,6 +39,6 @@ const result = await agent.runAgent({
 ## To run the example server in the dojo
 
 ```bash
-cd typescript-sdk/integrations/crewai/python
+cd integrations/crew-ai/python
 poetry install && poetry run dev
 ```

integrations/langgraph/python/examples/README.md

@@ -6,13 +6,13 @@ First, make sure to create a new .env file from the .env.example and include the
 
 To run the Python examples for langgraph platform, run:
 ```
-cd typescript-sdk/integrations/langgraph/examples/python
+cd integrations/langgraph/python/examples
 pnpx @langchain/langgraph-cli@latest dev
 ```
 
 To run the python examples using FastAPI, run:
 ```
-cd typescript-sdk/integrations/langgraph/examples/python
+cd integrations/langgraph/python/examples
 poetry install
 poetry run dev
 ```