Merge branch 'ag-ui-protocol:main' into adk-middleware

Author: contextablemark

.github/CODEOWNERS

@@ -1 +1 @@
-* @mme @ranst91 @ataibarkai @maxkorp @tylerslaton
+* @mme @ranst91 @ataibarkai @maxkorp @tylerslaton @NathanTarbert

CONTRIBUTING.md

@@ -1,57 +1,71 @@
-# Contributing to AG-UI
+# 👋 Contributing to AG-UI
 
-Thanks for your interest in improving **AG-UI**!
+Thanks for checking out AG-UI! Whether you’re here to fix a bug, ship a feature, improve the docs, or just figure out how things work—we’re glad you’re here.
 
-This short guide shows the fastest way to get your idea merged.
-You can find more detailed contribution guides at [ag-ui.com](ag-ui.com) 
+Here’s how to get involved:
 
 ---
 
-## 1. Start a Discussion
+## 🤔 Have a Question or Ran Into Something?
 
-Before writing code, open a new **Discussion** and briefly cover:
+Pick the right spot so we can help you faster:
 
-1. **Problem** – what you’re trying to solve.
-2. **Proposal** – how you plan to solve it (code, docs, design, etc.).
-3. **Alternatives** – other options you considered.
-
-Early feedback keeps everyone aligned and saves re-work.
+- **🐛 Bugs / Feature Ideas** → [GitHub Issues](https://github.com/ag-ui-protocol/ag-ui/issues)  
+- **❓ "How do I...?" / General Questions** → [GitHub Discussions](https://github.com/ag-ui-protocol/ag-ui/discussions)  
+- **💬 Quick chats / casual stuff** → [Discord](https://discord.gg/Jd3FzfdJa8) → `#-💎-contributing`
 
 ---
 
-## 2. Join a Bi-Weekly Working Group
+## 🧑‍💻 Want to Contribute Code?
 
-Meet the team and potential collaborators in our [bi-weekly community call](https://lu.ma/calendar/manage/cal-DBw2gK428IQbiSO).
+1. **Find Something to Work On**  
+   Browse open issues on [GitHub](https://github.com/ag-ui-protocol/ag-ui/issues).  
+   Got your own idea? Open an issue first so we can start the discussion.
 
----
+2. **Ask to Be Assigned**  
+   Comment on the issue and tag a code owner:  
+   → [Code Owners](https://github.com/ag-ui-protocol/ag-ui/blob/main/.github/CODEOWNERS)
+
+3. **Get on the Roadmap**  
+   Once approved, you'll be assigned the issue, and it'll get added to our [roadmap](https://github.com/orgs/ag-ui-protocol/projects/1).
 
-## 3. Connect with the Maintainers
+4. **Coordinate With Others**  
+   - If you're collaborating or need feedback, start a thread in `#-💎-contributing` on Discord  
+   - Or just DM the assignee directly
 
-Need a quick sync?
+5. **Open a Pull Request**  
+   - When you’re ready, submit your PR  
+   - In the description, include: `Fixes #<issue-number>`  
+     (This links your PR to the issue and closes it automatically)
 
-- **Markus:** [@mme_xyz](https://twitter.com/mme_xyz) on X (Twitter)
-- **Book a chat:** <https://calendly.com/markus-copilotkit/ag-ui>
+6. **Review & Merge**  
+   - A maintainer will review your code and leave comments if needed  
+   - Once it’s approved, we’ll merge it and move the issue to “done.”
 
 ---
 
-## 4. Useful Resources & Docs
+## 📝 Want to Contribute to the Docs?
 
-| Resource                                  | Link                                                     |
-| ----------------------------------------- | -------------------------------------------------------- |
-| Learn how to connect to AG-UI with JS     | <https://docs.ag-ui.com/quickstart/connect>              |
-| Learn how to connect to AG-UI with Python | <https://docs.ag-ui.com/quickstart/build>                |
-| Dojo reference implementation             | <https://github.com/ag-ui-protocol/ag-ui/tree/main/dojo> |
+Docs are part of the codebase and super valuable—thanks for helping improve them!
 
----
+Here’s how to contribute:
+
+1. **Open an Issue First**  
+   - Open a [GitHub issue](https://github.com/ag-ui-protocol/ag-ui/issues) describing what you’d like to update or add.  
+   - Then comment and ask to be assigned.
 
-## 5. Open Your Pull Request
+2. **Submit a PR**  
+   - Once assigned, make your edits and open a pull request.
+   - In the description, include: `Fixes #<issue-number>`  
+     (This links your PR to the issue and closes it automatically)
 
-1. **Fork** the repo and create a feature branch.
-2. Keep changes focused—one PR per feature or fix.
-3. Link back to your Discussion in the PR description.
+   - A maintainer will review it and merge if it looks good.
 
-We review PRs weekly. Feel free to nudge us in your Discussion if you haven’t heard back in a few days.
+That’s it! Simple and appreciated.
 
 ---
 
-**Thank you for making AG-UI better!**
+## 🙌 That’s It!
+
+AG-UI is community-built, and every contribution helps shape where we go next.  
+Big thanks for being part of it!

README.md

@@ -1,14 +1,38 @@
-[![AG-UI Workshop – June 20](https://img.shields.io/badge/AG--UI%20Workshop%20%E2%80%94June%2020-blue?style=flat-square)](https://go.copilotkit.ai/ag-ui-build-an-agent-canvas)
+
+# <img src="https://github.com/user-attachments/assets/ebc0dd08-8732-4519-9b6c-452ce54d8058" alt="ag-ui Logo" width="45"/> 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.
+Built for simplicity and flexibility, it enables seamless integration between AI agents, realtime user context, and user interfaces.
+
+[![Version](https://img.shields.io/npm/v/@ag-ui/core?label=Version&color=6963ff&logo=npm&logoColor=white)](https://www.npmjs.com/package/@ag-ui/core)
+![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> 
 
-# <img src="https://github.com/user-attachments/assets/ebc0dd08-8732-4519-9b6c-452ce54d8058" alt="ag-ui Logo" width="45"/> AG-UI: The Agent-User Interaction Protocol
-AG-UI is a lightweight, event-based protocol that standardizes how AI agents connect to front-end applications. Built for simplicity and flexibility, it enables seamless integration between your AI agents and user interfaces.
+<img width="4096" height="1816" alt="Readme 3 - Redesign" src="https://github.com/user-attachments/assets/af15b751-a72a-434f-a93c-9103f2a17006" />
 
-![AG-UI](https://github.com/user-attachments/assets/bec3bc01-d8f2-4667-885e-028cbcbc8439)
 
+## 🚀 Getting Started
+Create a new AG-UI application in seconds:
+```ts
+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)
+- [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)
 
-# What is AG-UI? (Specification)
+## What is AG-UI?
 
 AG-UI is an open, lightweight, event-based protocol for agent-human interaction, designed for simplicity & flexibility:
 
@@ -23,24 +47,26 @@ AG-UI is an open, lightweight, event-based protocol for agent-human interaction,
 It also ships with a **reference HTTP implementation** and **default connector** to help teams get started fast.
 
 
-[Learn more about the specs](https://go.copilotkit.ai/ag-ui-introduction)
+[Learn more about the specs →](https://go.copilotkit.ai/ag-ui-introduction)
 
 
 ## Why AG-UI?
 
 AG-UI was developed based on real-world requirements and practical experience building in-app agent interactions.
 
+
 ## Where does AGUI fit in the agentic protocol stack?
 AG-UI is complementary to the other 2 top agentic protocols
 - MCP gives agents tools
 - A2A allows agents to communicate with other agents
 - AG-UI brings agents into user-facing applications
 
 <div align="center">
-  <img src="https://github.com/user-attachments/assets/0c1ec566-050b-4ef8-ab89-15be41abe64f" height="300px" />
+  <img src="https://github.com/user-attachments/assets/0c1ec566-050b-4ef8-ab89-15be41abe64f"  />
 </div>  
+
 
-## Features
+## 🚀 Features
 
 - 💬 Real-time agentic chat with streaming
 - 🔄 Bi-directional state synchronization
@@ -49,23 +75,26 @@ AG-UI is complementary to the other 2 top agentic protocols
 - 🛠️ Frontend tool integration
 - 🧑‍💻 Human-in-the-loop collaboration
 
-## Framework Support
+### 1st party integrations with top agentic frameworks
+
+## 🛠 Supported Frameworks
+
 
 AG-UI integrates with many popular agent frameworks
 
-| Framework                                                          | Status                   | AG-UI Resources                                                              |
-| ------------------------------------------------------------------ | ------------------------ | ---------------------------------------------------------------------------- |
+| Framework                                                          | Status                   | AG-UI Resources                                                              | 
+| ------------------------------------------------------------------ | ------------------------ | ---------------------------------------------------------------------------- | 
 | No-framework                                                       | ✅ Supported             | ➡️ Docs coming soon       |
-| [LangGraph](https://www.langchain.com/langgraph)                   | ✅ Supported             | ➡️ [Demo](https://v0-langgraph-land.vercel.app/) |
+| [LangGraph](https://www.langchain.com/langgraph)                   | ✅ Supported             | ➡️ [Demo](https://v0-langgraph-land.vercel.app/) |  
 | [Mastra](https://mastra.ai/)                                       | ✅ Supported             | ➡️ [Demo](https://v0-mastra-land.vercel.app/)    |
 | [CrewAI](https://crewai.com/)                                      | ✅ Supported             | ➡️ [Demo](https://v0-crew-land.vercel.app/)      |
 | [AG2](https://ag2.ai/)                                             | ✅ Supported             | ➡️ [Demo](https://v0-ag2-land.vercel.app/)       |
 | [Agno](https://github.com/agno-agi/agno)                           | ✅ Supported             | ➡️ [Docs](https://docs.copilotkit.ai/agno)     |                                                  |
-| [LlamaIndex](https://github.com/run-llama/llama_index)             | ✅ Supported             |   ➡️ [Docs](https://docs.copilotkit.ai/llamaindex)      |                                               |
+| [LlamaIndex](https://github.com/run-llama/llama_index)             | ✅ Supported             | ➡️ [Docs](https://docs.copilotkit.ai/llamaindex)      |                                               |
 | [Pydantic AI](https://github.com/pydantic/pydantic-ai)             | 🛠️ In Progress           | –                                                                            |
 | [Vercel AI SDK](https://github.com/vercel/ai)                      | 🛠️ In Progress           | –                                                                            |
-| [OpenAI Agent SDK](https://openai.github.io/openai-agents-python/) | 💡 Open to Contributions | –                                                                            |
 | [Google ADK](https://google.github.io/adk-docs/get-started/)       | 🛠️ In Progress           | –                                                                            |
+| [OpenAI Agent SDK](https://openai.github.io/openai-agents-python/) | 💡 Open to Contributions | –                                                                            |
 | [AWS Bedrock Agents](https://aws.amazon.com/bedrock/agents/)       | 💡 Open to Contributions | –                                                                            |
 | [Cloudflare Agents](https://developers.cloudflare.com/agents/)     | 💡 Open to Contributions | –                                                                            |
 | [Strands Agents SDK](https://github.com/strands-agents/sdk-python) | 💡 Open to Contributions | –                                                                            |
@@ -79,51 +108,39 @@ AG-UI integrates with many popular agent frameworks
 
 [View all supported frameworks →](https://ag-ui.com/frameworks)
 
-## Hello World App
-https://agui-demo.vercel.app/
+
+## ✨ Hello World App
+
 
 Video:
 
 https://github.com/user-attachments/assets/18c03330-1ebc-4863-b2b8-cc6c3a4c7bae
 
+https://agui-demo.vercel.app/
+
+
 
-## AG-UI Showcase: The AG-UI Dojo (Building-Blocks Viewer)
+## 🧩 AG-UI Showcase: The AG-UI Dojo (Building-Blocks Viewer)
 The [AG-UI Dojo](https://copilotkit-feature-viewer.vercel.app/) 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)).
 
 The building blocks are designed to be simple and focused -- between 50-200 lines of code.
 
 https://github.com/user-attachments/assets/a67d3d54-36b2-4c7a-ac69-a0ca01365d5b
 
-## Getting Started
 
-Choose your path:
+## 🙋🏽‍♂️ Contributing to AG-UI
 
-### Building AG-UI Powered Applications
-
-Create a new AG-UI application in seconds:
-
-```bash
-npx create-ag-ui-app my-agent-app
-```
-
-[View Documentation](https://go.copilotkit.ai/ag-ui-introduction) · [Join Discord](https://discord.gg/Jd3FzfdJa8)
-
-### Building AG-UI Integrations (new frameworks)
-
-1. [Build new integrations (Quickstart)](https://go.copilotkit.ai/build-quickstart)
-2. [Book a call to discuss an AG-UI integration with a new framework](https://go.copilotkit.ai/ag-ui-book-a-call)
-3. [Join the Discord Community](https://go.copilotkit.ai/AG-UI-Discord)
-
-
-## Contributing
+Check out the [Contributing guide](https://github.com/ag-ui-protocol/ag-ui/blob/main/CONTRIBUTING.md)
 
+- **[Weekely AG-UI Working Group](https://lu.ma/CopilotKit?k=c)**  
+  📅 Follow the CopilotKit Luma Events Page
 
-Check out the [Contributing guide](https://github.com/ag-ui-protocol/ag-ui/blob/main/CONTRIBUTING.md)
+## Roadmap
 
-- **[AG-UI: Build an agent canvas with AG-UI](https://go.copilotkit.ai/ag-ui-build-an-agent-canvas)**  
-  📅 Friday, June 20, 9:00 AM PT  
+Check out the [AG-UI Roadmap](https://github.com/orgs/ag-ui-protocol/projects/1) to see what's being built and where you can jump in.
 
 
-## License
+## 📄 License
 
-AG-UI is open source and available under the MIT License.
+AG-UI is open source software [licensed as MIT](https://opensource.org/licenses/MIT).  
+Maintained by [AG Protocol](https://www.agprotocol.ai).

python-sdk/README.md

@@ -1,5 +1,57 @@
-# Agent User Interaction Protocol Documentation
+# ag-ui-protocol
 
-The Python SDK for the [Agent User Interaction Protocol](https://ag-ui.com).
+Python SDK for the **Agent-User Interaction (AG-UI) Protocol**.
 
-For more information visit the [official documentation](https://docs.ag-ui.com/).
+`ag-ui-protocol` provides Python developers with strongly-typed data structures and event encoding for building AG-UI compatible agent servers. Built on Pydantic for robust validation and automatic camelCase serialization for seamless frontend integration.
+
+## Installation
+
+```bash
+pip install ag-ui-protocol
+poetry add ag-ui-protocol
+pipenv install ag-ui-protocol
+```
+
+## Features
+
+- 🐍 **Python-native** – Idiomatic Python APIs with full type hints and validation
+- 📋 **Pydantic models** – Runtime validation and automatic JSON serialization
+- 🔄 **Streaming events** – 16 core event types for real-time agent communication
+- ⚡ **High performance** – Efficient event encoding for Server-Sent Events
+
+## Quick example
+
+```python
+from ag_ui.core import TextMessageContentEvent, EventType
+from ag_ui.encoder import EventEncoder
+
+# Create a streaming text event
+event = TextMessageContentEvent(
+    type=EventType.TEXT_MESSAGE_CONTENT,
+    message_id="msg_123",
+    delta="Hello from Python!"
+)
+
+# Encode for HTTP streaming
+encoder = EventEncoder()
+sse_data = encoder.encode(event)
+# Output: data: {"type":"TEXT_MESSAGE_CONTENT","messageId":"msg_123","delta":"Hello from Python!"}\n\n
+```
+
+## Packages
+
+- **`ag_ui.core`** – Types, events, and data models for AG-UI protocol
+- **`ag_ui.encoder`** – Event encoding utilities for HTTP streaming
+
+## Documentation
+
+- Concepts & architecture: [`docs/concepts`](https://docs.ag-ui.com/concepts/architecture)
+- Full API reference: [`docs/sdk/python`](https://docs.ag-ui.com/sdk/python/core/overview)
+
+## Contributing
+
+Bug reports and pull requests are welcome! Please read our [contributing guide](https://docs.ag-ui.com/development/contributing) first.
+
+## License
+
+MIT © 2025 AG-UI Protocol Contributors

python-sdk/pyproject.toml

@@ -1,6 +1,6 @@
 [tool.poetry]
 name = "ag-ui-protocol"
-version = "0.1.7"
+version = "0.1.8"
 description = ""
 authors = ["Markus Ecker <[email protected]>"]
 readme = "README.md"

typescript-sdk/integrations/agno/README.md

@@ -0,0 +1,36 @@
+# @ag-ui/agno
+
+Implementation of the AG-UI protocol for Agno.
+
+Connects Agno agents to frontend applications via the AG-UI protocol using HTTP communication.
+
+## Installation
+
+```bash
+npm install @ag-ui/agno
+pnpm add @ag-ui/agno
+yarn add @ag-ui/agno
+```
+
+## Usage
+
+```ts
+import { AgnoAgent } from "@ag-ui/agno";
+
+// Create an AG-UI compatible agent
+const agent = new AgnoAgent({
+  url: "https://your-agno-server.com/agent",
+  headers: { Authorization: "Bearer your-token" },
+});
+
+// Run with streaming
+const result = await agent.runAgent({
+  messages: [{ role: "user", content: "Hello from Agno!" }],
+});
+```
+
+## Features
+
+- **HTTP connectivity** – Direct connection to Agno agent servers
+- **Multi-agent support** – Works with Agno's multi-agent system architecture
+- **Streaming responses** – Real-time communication with full AG-UI event support