Merge branch 'main' into litebox-readme-update

Author: NathanTarbert

.github/CODEOWNERS

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

.github/workflows/test.yml

@@ -0,0 +1,88 @@
+name: test
+
+on:
+  push:
+    branches: main
+  pull_request:
+    branches: main
+
+jobs:
+  python:
+    name: Python SDK Tests
+    runs-on: ubuntu-latest
+    
+    steps:
+    - name: Checkout code
+      uses: actions/checkout@v4
+      
+    - name: Set up Python
+      uses: actions/setup-python@v5
+      with:
+        python-version: '3.9'
+        
+    - name: Install Poetry
+      uses: snok/install-poetry@v1
+      with:
+        version: latest
+        virtualenvs-create: true
+        virtualenvs-in-project: true
+        
+    - name: Load cached venv
+      id: cached-poetry-dependencies
+      uses: actions/cache@v4
+      with:
+        path: python-sdk/.venv
+        key: venv-${{ runner.os }}-${{ hashFiles('**/poetry.lock') }}
+        
+    - name: Install dependencies
+      if: steps.cached-poetry-dependencies.outputs.cache-hit != 'true'
+      working-directory: python-sdk
+      run: poetry install --no-interaction --no-root
+      
+    - name: Install project
+      working-directory: python-sdk
+      run: poetry install --no-interaction
+      
+    - name: Run tests
+      working-directory: python-sdk
+      run: poetry run python -m unittest discover tests -v
+
+  typescript:
+    name: TypeScript SDK Tests
+    runs-on: ubuntu-latest
+    
+    steps:
+    - name: Checkout code
+      uses: actions/checkout@v4
+      
+    - name: Set up Node.js
+      uses: actions/setup-node@v4
+      with:
+        node-version: '18'
+        
+    - name: Install protoc
+      uses: arduino/setup-protoc@v3
+      with:
+        version: "25.x"
+        repo-token: ${{ secrets.GITHUB_TOKEN }}
+        
+    - name: Install pnpm
+      uses: pnpm/action-setup@v4
+      with:
+        version: 9.0.0
+        
+    - name: Setup pnpm cache
+      uses: actions/cache@v4
+      with:
+        path: ~/.local/share/pnpm/store
+        key: ${{ runner.os }}-pnpm-store-${{ hashFiles('**/pnpm-lock.yaml') }}
+        restore-keys: |
+          ${{ runner.os }}-pnpm-store-
+        
+    - name: Install dependencies
+      working-directory: typescript-sdk
+      run: pnpm install --frozen-lockfile
+      
+    - name: Run tests
+      working-directory: typescript-sdk
+      run: pnpm run test 

README.md

@@ -1,4 +1,6 @@
-# <img src="https://github.com/user-attachments/assets/ebc0dd08-8732-4519-9b6c-452ce54d8058" alt="ag-ui Logo" height="42px" /> AG-UI: The Agent-User Interaction Protocol
+
+# <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.
 
 [![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)
@@ -40,6 +42,8 @@ It also ships with a **reference HTTP implementation** and **default connector**
 
 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
@@ -69,6 +73,7 @@ AG-UI is complementary to the other 2 top agentic protocols
 
 ## 🛠 Supported Frameworks
 
+
 AG-UI integrates with many popular agent frameworks
 
 | Framework                                                          | Status                   | AG-UI Resources                                                              | 
@@ -97,14 +102,21 @@ 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/
 
 Video:
 
 https://github.com/user-attachments/assets/18c03330-1ebc-4863-b2b8-cc6c3a4c7bae
 
+https://agui-demo.vercel.app/
+
+Video:
+
+https://github.com/user-attachments/assets/a67d3d54-36b2-4c7a-ac69-a0ca01365d5b
+
+
 
 ## 🧩 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)).
@@ -130,6 +142,3 @@ Check out the [AG-UI Roadmap](https://github.com/orgs/ag-ui-protocol/projects/1)
 
 AG-UI is open source software [licensed as MIT](https://opensource.org/licenses/MIT).  
 Maintained by [AG Protocol](https://www.agprotocol.ai).
-
-
-

docs/concepts/events.mdx

@@ -95,12 +95,14 @@ The `RunFinished` event indicates that an agent has successfully completed all
 its work for the current run. Upon receiving this event, frontends should
 finalize any UI states that were waiting on the agent's completion. This event
 marks a clean termination point and indicates that no further processing will
-occur in this run unless explicitly requested.
+occur in this run unless explicitly requested. The optional `result` field can
+contain any output data produced by the agent run.
 
 | Property   | Description                   |
 | ---------- | ----------------------------- |
 | `threadId` | ID of the conversation thread |
 | `runId`    | ID of the agent run           |
+| `result`   | Optional result data from run |
 
 ### RunError
 
@@ -255,6 +257,9 @@ sequenceDiagram
 
     Note over Agent,Client: Tool call completes
     Agent->>Client: ToolCallEnd
+
+    Note over Agent,Client: Tool execution result
+    Agent->>Client: ToolCallResult
 ```
 
 The `ToolCallArgs` events each contain a `delta` field with a chunk of the
@@ -314,6 +319,26 @@ received the results.
 | ------------ | ----------------------------------- |
 | `toolCallId` | Matches the ID from `ToolCallStart` |
 
+### ToolCallResult
+
+Provides the result of a tool call execution.
+
+The `ToolCallResult` event delivers the output or result from a tool that was
+previously invoked by the agent. This event is sent after the tool has been
+executed by the system and contains the actual output generated by the tool.
+Unlike the streaming pattern of tool call specification (start, args, end), the
+result is delivered as a complete unit since tool execution typically produces a
+complete output. Frontends can use this event to display tool results to users,
+append them to the conversation history, or trigger follow-up actions based on
+the tool's output.
+
+| Property     | Description                                                 |
+| ------------ | ----------------------------------------------------------- |
+| `messageId`  | ID of the conversation message this result belongs to       |
+| `toolCallId` | Matches the ID from the corresponding `ToolCallStart` event |
+| `content`    | The actual result/output content from the tool execution    |
+| `role`       | Optional role identifier, typically "tool" for tool results |
+
 ## State Management Events
 
 These events are used to manage and synchronize the agent's state with the

docs/docs.json

@@ -21,6 +21,7 @@
                 "group": "Quickstart",
                 "pages": [
                   "quickstart/applications",
+                  "quickstart/clients",
                   {
                     "group": "Build integrations",
                     "pages": [
@@ -30,8 +31,7 @@
                     ]
                   }
                 ]
-              },
-              "integrations"
+              }
             ]
           },
           {
@@ -68,7 +68,12 @@
               },
               {
                 "group": "@ag-ui/client",
-                "pages": ["sdk/js/client/overview"]
+                "pages": [
+                  "sdk/js/client/overview",
+                  "sdk/js/client/abstract-agent",
+                  "sdk/js/client/http-agent",
+                  "sdk/js/client/subscriber"
+                ]
               },
               "sdk/js/encoder",
               "sdk/js/proto"
@@ -132,6 +137,12 @@
     },
     "indexing": "navigable"
   },
+  "integrations": {
+    "posthog": {
+      "apiKey": "phc_XZdymVYjrph9Mi0xZYGNyCKexxgblXRR1jMENCtdz5Q",
+      "apiHost": "https://eu.posthog.com"
+    }
+  },
   "footer": {
     "socials": {
       "github": "https://github.com/ag-ui-protocol/ag-ui"