Merge branch 'ag-ui-protocol:main' into kotlinsdk

Author: contextablemark

.github/workflows/dojo-e2e.yml

@@ -14,6 +14,10 @@ jobs:
       fail-fast: false
       matrix:
         include:
+          - suite: a2a-middleware
+            test_path: tests/a2aMiddlewareTests
+            services: ["dojo","a2a-middleware"]
+            wait_on: http://localhost:9999,tcp:localhost:8011,tcp:localhost:8012,tcp:localhost:8013,tcp:localhost:8014
           - suite: adk-middleware
             test_path: tests/adkMiddlewareTests
             services: ["dojo","adk-middleware"]
@@ -26,10 +30,14 @@ jobs:
             test_path: tests/crewAITests
             services: ["dojo","crew-ai"]
             wait_on: http://localhost:9999,tcp:localhost:8003
-          - suite: langgraph
-            test_path: tests/langgraphTests
-            services: ["dojo","langgraph-platform-python","langgraph-platform-typescript"]
-            wait_on: http://localhost:9999,tcp:localhost:8005,tcp:localhost:8006
+          - suite: langgraph-python
+            test_path: tests/langgraphPythonTests
+            services: ["dojo","langgraph-platform-python"]
+            wait_on: http://localhost:9999,tcp:localhost:8005
+          - suite: langgraph-typescript
+            test_path: tests/langgraphTypescriptTests
+            services: ["dojo","langgraph-platform-typescript"]
+            wait_on: http://localhost:9999,tcp:localhost:8006
           - suite: langgraph-fastapi
             test_path: tests/langgraphFastAPITests
             services: ["dojo","langgraph-fastapi"]
@@ -62,10 +70,10 @@ jobs:
             test_path: tests/serverStarterAllFeaturesTests
             services: ["dojo","server-starter-all"]
             wait_on: http://localhost:9999,tcp:localhost:8001
-          - suite: vercel-ai-sdk
-            test_path: tests/vercelAISdkTests
-            services: ["dojo"]
-            wait_on: http://localhost:9999
+          # - suite: vercel-ai-sdk
+          #   test_path: tests/vercelAISdkTests
+          #   services: ["dojo"]
+          #   wait_on: http://localhost:9999
 
     steps:
     - name: Checkout code

.github/workflows/test.yml

@@ -58,7 +58,7 @@ jobs:
     - name: Set up Node.js
       uses: actions/setup-node@v4
       with:
-        node-version: '18'
+        node-version: '22'
 
     - name: Install protoc
       uses: arduino/setup-protoc@v3

README.md

@@ -1,7 +1,7 @@
 
 # <img src="https://github.com/user-attachments/assets/ebc0dd08-8732-4519-9b6c-452ce54d8058" alt="ag-ui Logo" width="22"/> AG-UI: The Agent-User Interaction Protocol
 
-AG-UI is a lightweight, event-based protocol that standardizes how AI agents connect to user-facing applications.
+AG-UI is an open, lightweight, event-based protocol that standardizes how AI agents connect to user-facing applications.
 Built for simplicity and flexibility, it enables seamless integration between AI agents, real time user context, and user interfaces.
 
 ---
@@ -14,15 +14,7 @@ Built for simplicity and flexibility, it enables seamless integration between AI
 ![MIT](https://img.shields.io/github/license/copilotkit/copilotkit?color=%236963ff&label=License)
 ![Discord](https://img.shields.io/discord/1379082175625953370?logo=discord&logoColor=%23FFFFFF&label=Discord&color=%236963ff)
 
-  <a href="https://discord.gg/Jd3FzfdJa8" target="_blank">
-   Join our Discord →
-  </a> &nbsp;&nbsp;&nbsp;
-    <a href="https://ag-ui.com/" target="_blank">
-   Read the Docs →
-  </a> &nbsp;&nbsp;&nbsp;
-    <a href="https://x.com/CopilotKit" target="_blank">
-   Follow us →
-  </a> 
+<a href="https://discord.gg/Jd3FzfdJa8" target="_blank"> Join our Discord → </a> &nbsp;&nbsp;&nbsp; <a href="https://ag-ui.com/" target="_blank"> Read the Docs → </a> &nbsp;&nbsp;&nbsp; <a href="https://dojo.ag-ui.com/" target="_blank"> Go to the AG-UI Dojo → </a> &nbsp;&nbsp;&nbsp; <a href="https://x.com/CopilotKit" target="_blank"> Follow us → </a>
 
 <img width="4096" height="1752" alt="Your application-AG-UI protocol" src="https://github.com/user-attachments/assets/dc58c64c-3257-490a-b827-e163475f4166" />
 
@@ -31,9 +23,12 @@ Create a new AG-UI application in seconds:
 ```bash
 npx create-ag-ui-app my-agent-app
 ```
-<h3>Building AG-UI Integrations (new frameworks):</h3>
 
-- [Build new integrations (Quickstart)](https://go.copilotkit.ai/agui-contribute)
+<h3> Useful Links:</h3>
+
+- [The AG-UI Dojo](https://dojo.ag-ui.com/)
+- [Build AG-UI-powered applications(Quickstart)](https://docs.ag-ui.com/quickstart/applications)
+- [Build new AG-UI framework integrations (Quickstart)](https://go.copilotkit.ai/agui-contribute)
 - [Book a call to discuss an AG-UI integration with a new framework](https://calendly.com/markus-copilotkit/ag-ui)
 - [Join the Discord Community](https://discord.gg/Jd3FzfdJa8)
 
@@ -87,14 +82,14 @@ AG-UI was born from CopilotKit's initial partnership with LangGraph and CrewAI -
 | Framework                                                          | Status                   | AG-UI Resources                                                              | Integrations             | 
 | ------------------------------------------------------------------ | ------------------------ | ---------------------------------------------------------------------------- | ------------------------ |
 | No-framework                                                       | ✅ Supported             | ➡️ Docs coming soon                                                          |                          |
-| [LangGraph](https://www.langchain.com/langgraph)                   | ✅ Supported             | ➡️ [Docs](https://docs.copilotkit.ai/langgraph/) [Demos](https://dojo.ag-ui.com/langgraph-fastapi/feature/shared_state)                           | Partnership              |
-| [CrewAI](https://crewai.com/)                                      | ✅ Supported             | ➡️ [Docs](https://docs.copilotkit.ai/crewai-flows) [Demos](https://dojo.ag-ui.com/crewai/feature/shared_state)                          | Partnership              |
-| [Mastra](https://mastra.ai/)                                       | ✅ Supported             | ➡️ [Docs](https://docs.copilotkit.ai/mastra/) [Demos](https://dojo.ag-ui.com/mastra/feature/shared_state)                               | 1st party                |
-| [AG2](https://ag2.ai/)                                             | ✅ Supported             | ➡️ [Docs](https://docs.copilotkit.ai/ag2/) [Demos](https://dojo.ag-ui.com/ag2/feature/shared_state)                                   | 1st party                |
-| [Agno](https://github.com/agno-agi/agno)                           | ✅ Supported             | ➡️ [Docs](https://docs.copilotkit.ai/agno/) [Demos](https://dojo.ag-ui.com/agno/feature/shared_state)                                  | 1st party                |
-| [LlamaIndex](https://github.com/run-llama/llama_index)             | ✅ Supported             | ➡️ [Docs](https://docs.copilotkit.ai/llamaindex/) [Demos](https://dojo.ag-ui.com/llamaindex/feature/shared_state)                            | 1st party                |
-| [Pydantic AI](https://github.com/pydantic/pydantic-ai)             | ✅ Supported             | ➡️ [Docs](https://docs.copilotkit.ai/pydantic-ai/) [Demos](https://dojo.ag-ui.com/pydantic-ai/feature/shared_state)                           | 1st party                |
-| [Google ADK](https://google.github.io/adk-docs/get-started/)       | 🛠️ [PR](https://github.com/ag-ui-protocol/ag-ui/pull/274)           | –                                                                            | 1st party                |
+| [LangGraph](https://www.langchain.com/langgraph)                   | ✅ Supported             | ➡️ [Docs](https://docs.copilotkit.ai/langgraph/) 🎮 [Demos](https://dojo.ag-ui.com/langgraph-fastapi/feature/shared_state)                           | Partnership              |
+| [Mastra](https://mastra.ai/)                                       | ✅ Supported             | ➡️ [Docs](https://docs.copilotkit.ai/mastra/) 🎮 [Demos](https://dojo.ag-ui.com/mastra)                               | 1st party                |
+| [Pydantic AI](https://github.com/pydantic/pydantic-ai)             | ✅ Supported             | ➡️ [Docs](https://docs.copilotkit.ai/pydantic-ai/) 🎮 [Demos](https://dojo.ag-ui.com/pydantic-ai/feature/shared_state)                           | 1st party                |
+| [Google ADK](https://google.github.io/adk-docs/get-started/)       | ✅ Supported            | ➡️ [Docs](https://docs.copilotkit.ai/adk) 🎮 [Demos](https://dojo.ag-ui.com/adk-middleware)                                                                            | Partnership                |
+| [Agno](https://github.com/agno-agi/agno)                           | ✅ Supported             | ➡️ [Docs](https://docs.copilotkit.ai/agno/) 🎮 [Demos](https://dojo.ag-ui.com/agno)                                  | 1st party                |
+| [LlamaIndex](https://github.com/run-llama/llama_index)             | ✅ Supported             | ➡️ [Docs](https://docs.copilotkit.ai/llamaindex/) 🎮 [Demos](https://dojo.ag-ui.com/llamaindex/feature/shared_state)                            | 1st party                |
+| [CrewAI](https://crewai.com/)                                      | ✅ Supported             | ➡️ [Docs](https://docs.copilotkit.ai/crewai-flows) 🎮 [Demos](https://dojo.ag-ui.com/crewai/feature/shared_state)                          | Partnership              |
+| [AG2](https://ag2.ai/)                                             | ✅ Supported             | ➡️ [Docs](https://docs.copilotkit.ai/ag2/)                                  | 1st party                |
 | [AWS Bedrock Agents](https://aws.amazon.com/bedrock/agents/)       | 🛠️ In Progress           | –                                                                            | 1st party                |
 | [AWS Strands Agents](https://github.com/strands-agents/sdk-python) | 🛠️ In Progress           | –                                                                            | 1st Party                |   
 | [Vercel AI SDK](https://github.com/vercel/ai)                      | 🛠️ In Progress           | –                                                                            | Community                |
@@ -117,8 +112,8 @@ AG-UI was born from CopilotKit's initial partnership with LangGraph and CrewAI -
 [View all supported frameworks →](https://ag-ui.com/frameworks)
 
 
-## ✨ Hello World App
-
+## Examples
+### Hello World App
 
 Video:
 
@@ -128,12 +123,13 @@ https://agui-demo.vercel.app/
 
 
 
-## 🧩 AG-UI Showcase: The AG-UI Dojo (Building-Blocks Viewer)
-The [AG-UI Dojo](https://dojo.ag-ui.com/langgraph-fastapi/feature/shared_state) showcases many of the building blocks that AG-UI supports ([AG-UI Dojo Source Code](https://github.com/ag-ui-protocol/ag-ui/tree/main/typescript-sdk/apps/dojo)) with each Agent Framework integration.
+## 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. 
+
+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).
 
-The building blocks are designed to be simple and focused -- between 50-200 lines of code.
+https://github.com/user-attachments/assets/c298eea8-3f39-4a94-b968-7712429b0c49
 
-https://github.com/user-attachments/assets/a67d3d54-36b2-4c7a-ac69-a0ca01365d5b
 
 
 ## 🙋🏽‍♂️ Contributing to AG-UI

docs/ag_ui.md

@@ -0,0 +1,91 @@
+# AG‑UI: The Agent–User Interaction Protocol
+
+*A horizontal standard to bring AI agents into user‑facing frontend applications.*
+
+AG‑UI is the boundary layer where agents and users meet. It standardizes how agent state, UI intents, and user interactions flow between your model/agent runtime and your app’s frontend—so you can ship reliable, debuggable, user‑friendly agentic features fast.
+
+---
+
+## Built with the ecosystem
+
+**First‑party partnerships & integrations**
+
+> **Logo strip goes here** (e.g., LangGraph • CrewAI • Autogen 2 • LlamaIndex • Mastra • Pydantic AI • Vercel AI SDK • Next.js)
+
+Short blurb: *AG‑UI works across leading agent frameworks and frontend stacks, with shared vocabulary and primitives that keep your UX consistent as your agents evolve.*
+
+---
+
+## Building blocks (today & upcoming)
+
+- **Streaming chat** — Token‑level and tool‑event streaming for responsive UIs.
+- **Static generative UI** — Render model output into stable, typed components.
+- **Declarative generative UI** — Let agents propose UI trees; app decides what to mount.
+- **Frontend tools** — Safe, typed tool calls that bridge agent logic to app actions.
+- **Interrupts & human‑in‑the‑loop** — Pause, approve, edit, or steer mid‑flow.
+- **In‑chat + in‑app interactions** — Chat commands alongside regular app controls.
+- **Attachments & multimodality** — Files, images, audio, and structured payloads.
+- **Thinking steps** — Expose summaries/redactions of chain‑of‑thought artifacts to users, safely.
+- **Sub‑agent calls** — Orchestrate nested agents and delegate specialized tasks.
+- **Agent steering** — Guardrails, policies, and UX affordances to keep agents on track.
+
+> **CTA to deeper docs** → *See the full capability map in the docs.*
+
+---
+
+## Design patterns
+
+Explore reusable interaction patterns for agentic UX:
+
+- **Link‑out:** [AI‑UI Design Patterns →](/patterns) *(placeholder URL)*
+
+---
+
+## Why AG‑UI
+
+**Agentic apps break the classic request/response contract.** Agents run for longer, stream work as they go, and make nondeterministic choices that can affect your UI and state. AG‑UI defines a clean, observable boundary so frontends remain predictable while agents stay flexible.
+
+### What’s hard about user‑facing agents
+
+- Agents are **long‑running** and **stream** intermediate work—often across multi‑turn sessions.
+- Agents are **nondeterministic** and can **control UI** in ways that must be supervised.
+- Apps must mix **structured + unstructured IO** (text, voice, tool calls, state updates).
+- Agents need **composition**: agents **call sub‑agents**, often non-deterministically.
+
+With AG‑UI, these become deliberate, well‑typed interactions rather than ad‑hoc wiring.
+
+---
+
+## Deeper proof (docs, demos, code)
+
+| Framework / Platform    | What works today                       | Docs      | Demo      |
+| ----------------------- | -------------------------------------- | --------- | --------- |
+| LangGraph               | Streams, tools, interrupts, sub‑agents | [Docs](#) | [Demo](#) |
+| CrewAI                  | Tools, action routing, steering        | [Docs](#) | [Demo](#) |
+| Autogen 2               | Multi‑agent orchestration, messaging   | [Docs](#) | [Demo](#) |
+| LlamaIndex              | Query/agent routing, UI intents        | [Docs](#) | [Demo](#) |
+| OpenAI Realtime         | Live stream, events, attachments       | [Docs](#) | [Demo](#) |
+| Vercel AI SDK / Next.js | Edge streaming, SSR hydration          | [Docs](#) | [Demo](#) |
+
+> **Note:** Replace placeholders with actual URLs to docs and demos.
+
+---
+
+## Quick links
+
+- **Get started** → */docs/getting-started* (placeholder)
+- **Concepts** → */docs/concepts/agent-ui-boundary* (placeholder)
+- **Reference** → */docs/reference* (placeholder)
+- **Patterns** → */patterns* (placeholder)
+
+---
+
+## Optional section: How AG‑UI fits
+
+- **Protocol**: Events, intents, and payload schemas shared by agents & apps.
+- **Runtime adapters**: Bindings for popular agent frameworks.
+- **Frontend kit**: Lightweight client + components to handle streaming & interrupts.
+- **Observability hooks**: Surface interaction timelines for debugging & learning.
+
+*(Include a simple diagram later: Agent(s) ⇄ AG‑UI Boundary ⇄ App UI/State)*
+

docs/concepts/agents.mdx

@@ -40,7 +40,7 @@ foundation for:
 import { AbstractAgent } from "@ag-ui/client"
 
 class MyAgent extends AbstractAgent {
-  protected run(input: RunAgentInput): RunAgent {
+  run(input: RunAgentInput): RunAgent {
     // Implementation details
   }
 }
@@ -89,7 +89,7 @@ You can create custom agents to integrate with any AI service by extending
 class CustomAgent extends AbstractAgent {
   // Custom properties and methods
 
-  protected run(input: RunAgentInput): RunAgent {
+  run(input: RunAgentInput): RunAgent {
     // Implement the agent's logic
   }
 }
@@ -113,7 +113,7 @@ import {
 import { Observable } from "rxjs"
 
 class SimpleAgent extends AbstractAgent {
-  protected run(input: RunAgentInput): RunAgent {
+  run(input: RunAgentInput): RunAgent {
     const { threadId, runId } = input
 
     return () =>

docs/concepts/architecture.mdx

@@ -8,7 +8,35 @@ architecture that enables seamless, efficient communication between front-end
 applications and AI agents. This document covers the core architectural
 components and concepts.
 
-## Overview
+## Design Principles
+
+AG-UI is designed to be lightweight and minimally opinionated, making it easy to
+integrate with a wide range of agent implementations. The protocol's flexibility
+comes from its simple requirements:
+
+1. **Event-Driven Communication**: Agents need to emit any of the 16
+   standardized event types during execution, creating a stream of updates that
+   clients can process.
+
+2. **Bidirectional Interaction**: Agents accept input from users, enabling
+   collaborative workflows where humans and AI work together seamlessly.
+
+The protocol includes a built-in middleware layer that maximizes compatibility
+in two key ways:
+
+- **Flexible Event Structure**: Events don't need to match AG-UI's format
+  exactly—they just need to be AG-UI-compatible. This allows existing agent
+  frameworks to adapt their native event formats with minimal effort.
+
+- **Transport Agnostic**: AG-UI doesn't mandate how events are delivered,
+  supporting various transport mechanisms including Server-Sent Events (SSE),
+  webhooks, WebSockets, and more. This flexibility lets developers choose the
+  transport that best fits their architecture.
+
+This pragmatic approach makes AG-UI easy to adopt without requiring major
+changes to existing agent implementations or frontend applications.
+
+## Architectural Overview
 
 AG-UI follows a client-server architecture that standardizes communication
 between agents and applications: