Merge branch 'main' into mme/multiple-runs

Author: mme

.github/workflows/check-generated-files.yml

@@ -0,0 +1,38 @@
+name: Check Generated Files
+
+on:
+  push:
+    branches: [main]
+  pull_request:
+    branches: [main]
+
+jobs:
+  check-files-json:
+    name: Check files.json
+    runs-on: ubuntu-latest
+    steps:
+      - name: Checkout code
+        uses: actions/checkout@v4
+
+      - name: Regenerate files.json
+        working-directory: typescript-sdk/apps/dojo
+        run: npm run generate-content-json
+
+      - name: Check files.json
+        working-directory: typescript-sdk/apps/dojo
+        run: |
+          if git diff --exit-code src/files.json > /dev/null; then
+            echo "✅ No changes detected in dojo/src/files.json. Everything is up to date."
+          else
+            echo "❌ Detected changes in dojo/src/files.json."
+            echo ""
+            echo "Please run \`(p)npm run generate-content-json\` in the typescript-sdk/apps/dojo folder and commit the changes."
+            echo ""
+            echo "The detected diff was as follows:"
+            echo "::group::Diff for dojo/src/files.json"
+            git diff src/files.json
+            echo "::endgroup::"
+            exit 1
+          fi
+
+

.github/workflows/dojo-e2e.yml

@@ -0,0 +1,106 @@
+name: e2e
+
+on:
+  push:
+    branches: [main]
+  pull_request:
+    branches: [main]
+
+jobs:
+  e2e:
+    name: E2E Tests
+    runs-on: depot-ubuntu-latest-8
+
+    steps:
+    - name: Checkout code
+      uses: actions/checkout@v4
+
+    - name: Set up Node.js
+      uses: actions/setup-node@v4
+      with:
+        node-version: '22'
+
+    - name: Install pnpm
+      uses: pnpm/action-setup@v4
+      with:
+        version: 10.13.1
+
+    - name: Install Poetry
+      uses: snok/install-poetry@v1
+      with:
+        version: latest
+        virtualenvs-create: true
+        virtualenvs-in-project: true
+
+    - name: Install uv
+      uses: astral-sh/setup-uv@v6
+
+    - 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: Prepare dojo for e2e
+      working-directory: typescript-sdk/apps/dojo
+      run: node ./scripts/prep-dojo-everything.js -e2e
+
+    - name: Install e2e dependencies
+      working-directory: typescript-sdk/apps/dojo/e2e
+      run: |
+        pnpm install
+
+    - name: write langgraph env files
+      working-directory: typescript-sdk/integrations/langgraph
+      env:
+        OPENAI_API_KEY: ${{ secrets.OPENAI_API_KEY }}
+        LANGSMITH_API_KEY: ${{ secrets.LANGSMITH_API_KEY }}
+      run: |
+        echo "OPENAI_API_KEY=${OPENAI_API_KEY}" > examples/python/.env
+        echo "LANGSMITH_API_KEY=${LANGSMITH_API_KEY}" >> examples/python/.env
+        echo "OPENAI_API_KEY=${OPENAI_API_KEY}" > examples/typescript/.env
+        echo "LANGSMITH_API_KEY=${LANGSMITH_API_KEY}" >> examples/typescript/.env
+        echo "OPENAI_API_KEY=${OPENAI_API_KEY}" > python/ag_ui_langgraph/.env
+        echo "LANGSMITH_API_KEY=${LANGSMITH_API_KEY}" >> python/ag_ui_langgraph/.env
+
+    - name: Run dojo+agents
+      uses: JarvusInnovations/background-action@v1
+      env:
+        OPENAI_API_KEY: ${{ secrets.OPENAI_API_KEY }}
+        LANGSMITH_API_KEY: ${{ secrets.LANGSMITH_API_KEY }}
+      with:
+        run: |
+          node ../scripts/run-dojo-everything.js
+        working-directory: typescript-sdk/apps/dojo/e2e
+        wait-on: |
+          http://localhost:9999
+          tcp:localhost:8000
+          tcp:localhost:8001
+          tcp:localhost:8002
+          tcp:localhost:8003
+          tcp:localhost:8004
+          tcp:localhost:8005
+          tcp:localhost:8006
+          tcp:localhost:8007
+          tcp:localhost:8008
+          tcp:localhost:8009
+
+    - name: Run tests
+      working-directory: typescript-sdk/apps/dojo/e2e
+      env:
+        BASE_URL: http://localhost:9999
+      run: pnpm test
+
+    - name: Upload traces
+      if: always() # Uploads artifacts even if tests fail
+      uses: actions/upload-artifact@v4
+      with:
+        name: playwright-traces
+        path: typescript-sdk/apps/dojo/e2e/test-results/
+        retention-days: 7

.github/workflows/test.yml

@@ -69,7 +69,7 @@ jobs:
     - name: Install pnpm
       uses: pnpm/action-setup@v4
       with:
-        version: 9.0.0
+        version: 10.13.1
 
     - name: Setup pnpm cache
       uses: actions/cache@v4

.gitignore

@@ -0,0 +1 @@
+.vscode/

README.md

@@ -6,7 +6,7 @@ Built for simplicity and flexibility, it enables seamless integration between AI
 
 ---
 
-[📅 Upcoming Event: July 24 - San Francisco AG-UI workshop with AI Tinkerers in person (Feat. CopilotKit & Mastra)](https://lu.ma/ai-tinkerers-workshop?tk=JeUCY5)
+[📅 Upcoming Event: August 6th - AG-UI + Mastra: Build a Project Management Canvas](https://lu.ma/94688z7e)
 
 <br>
 
@@ -29,7 +29,7 @@ Built for simplicity and flexibility, it enables seamless integration between AI
 
 ## 🚀 Getting Started
 Create a new AG-UI application in seconds:
-```ts
+```bash
 npx create-ag-ui-app my-agent-app
 ```
 <h3>Building AG-UI Integrations (new frameworks):</h3>
@@ -81,39 +81,39 @@ AG-UI is complementary to the other 2 top agentic protocols
 - 🛠️ Frontend tool integration
 - 🧑‍💻 Human-in-the-loop collaboration
 
-### 1st party integrations with top agentic frameworks
-
 
 ## 🛠 Supported Frameworks
 
-AG-UI integrates with many popular agent frameworks
+AG-UI was born from CopilotKit's initial partnership with LangGraph and CrewAI - and brings the incredibly popular agent-user-interactivity infrastructure to the wider agentic ecosystem.
 
-| Framework                                                          | Status                   | AG-UI Resources                                                              | ✅ 1st Party Integration |
+| Framework                                                          | Status                   | AG-UI Resources                                                              | Integrations |
 | ------------------------------------------------------------------ | ------------------------ | ---------------------------------------------------------------------------- | ------------------------ |
-| No-framework                                                       | ✅ Supported             | ➡️ Docs coming soon                                                          | ✅                      |
-| [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)                             | ✅                      |
-| [Pydantic AI](https://github.com/pydantic/pydantic-ai)             | ✅ Supported             | ➡️ [Docs](https://docs.copilotkit.ai/pydantic-ai)                            | ✅                      |
-| [Vercel AI SDK](https://github.com/vercel/ai)                      | 🛠️ In Progress           | –                                                                            | ⬜                      |
-| [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 | –                                                                            | ⬜                      |
+| No-framework                                                       | ✅ Supported             | ➡️ Docs coming soon                                                          |                          |
+| [LangGraph](https://www.langchain.com/langgraph)                   | ✅ Supported             | ➡️ [Demo](https://v0-langgraph-land.vercel.app/)                             | Partnership              |
+| [CrewAI](https://crewai.com/)                                      | ✅ Supported             | ➡️ [Demo](https://v0-crew-land.vercel.app/)                                  | Partnership              |
+| [Mastra](https://mastra.ai/)                                       | ✅ Supported             | ➡️ [Demo](https://v0-mastra-land.vercel.app/)                                | 1st party                |
+| [AG2](https://ag2.ai/)                                             | ✅ Supported             | ➡️ [Demo](https://v0-ag2-land.vercel.app/)                                   | 1st party                |
+| [Agno](https://github.com/agno-agi/agno)                           | ✅ Supported             | ➡️ [Docs](https://docs.copilotkit.ai/agno)                                   | 1st party                |
+| [LlamaIndex](https://github.com/run-llama/llama_index)             | ✅ Supported             | ➡️ [Docs](https://docs.copilotkit.ai/llamaindex)                             | 1st party                |
+| [Pydantic AI](https://github.com/pydantic/pydantic-ai)             | ✅ Supported             | ➡️ [Docs](https://docs.copilotkit.ai/pydantic-ai)                            | 1st party                |
+| [Vercel AI SDK](https://github.com/vercel/ai)                      | 🛠️ In Progress           | –                                                                            | Community                |
+| [Google ADK](https://google.github.io/adk-docs/get-started/)       | 🛠️ In Progress           | –                                                                            | Community                |
+| [OpenAI Agent SDK](https://openai.github.io/openai-agents-python/) | 🛠️ In Progress           | –                                                                            | Community                |
+| [AWS Bedrock Agents](https://aws.amazon.com/bedrock/agents/)       | 🛠️ In Progress           | –                                                                            | 1st party                |
+| [Cloudflare Agents](https://developers.cloudflare.com/agents/)     | 💡 Open to Contributions | –                                                                            | Community                |
+| [Strands Agents SDK](https://github.com/strands-agents/sdk-python) | 💡 Open to Contributions | –                                                                            | Community                |   
 
 [View all supported frameworks →](https://ag-ui.com/frameworks)
 
 
-| Language SDK                                                       | Status                   | AG-UI Resources                                                              |
-| ------------------------------------------------------------------ | ------------------------ | ---------------------------------------------------------------------------- |
-| [Kotlin]()                                                         | 🛠️ In Progress            | ➡️ [GitHub Source](https://github.com/Contextable/ag-ui-4k)                  |
+| Language SDK                                                       | Status                    | AG-UI Resources                                                              |
+| ------------------------------------------------------------------ | ------------------------  | ---------------------------------------------------------------------------- |
+| [Kotlin]()                                                         | ✅ Supported              | ➡️ [GitHub Source](https://github.com/Contextable/ag-ui-4k)                  |
 | [.NET]()                                                           | 🛠️ In Progress            | ➡️ [PR](https://github.com/ag-ui-protocol/ag-ui/pull/38)                     |
 | [Nim]()                                                            | 🛠️ In Progress            | ➡️ [PR](https://github.com/ag-ui-protocol/ag-ui/pull/29)                     |
 | [Golang]()                                                         | 🛠️ In Progress            | ➡️ [Issue](https://github.com/ag-ui-protocol/ag-ui/issues/156)               |
+| [Rust]()                                                           | 🛠️ In Progress            | ➡️ [Issue](https://github.com/ag-ui-protocol/ag-ui/issues/239)               |
+| [Java]()                                                           | 🛠️ In Progress            | ➡️ [GitHub Source](https://github.com/work-m8/ag-ui-4j)                      |
 
 
 [View all supported frameworks →](https://ag-ui.com/frameworks)
@@ -153,4 +153,3 @@ 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).  
-Maintained by [AG Protocol](https://www.agprotocol.ai).

docs/quickstart/clients.mdx

@@ -15,7 +15,7 @@ AG-UI protocol.
 
 Building your own client is useful if you want to explore/hack on the AG-UI
 protocol. For production use, use a full-featured client like
-[CopilotKit ](https://copilokit.ai).
+[CopilotKit](https://copilotkit.ai).
 
 ## What you'll build
 

typescript-sdk/apps/client-cli-example/package.json

@@ -13,11 +13,11 @@
     "@ag-ui/core": "workspace:*",
     "@ag-ui/mastra": "workspace:*",
     "@ai-sdk/openai": "1.3.22",
-    "@mastra/client-js": "0.10.9",
-    "@mastra/core": "0.10.10",
-    "@mastra/libsql": "0.11.0",
-    "@mastra/loggers": "0.10.3",
-    "@mastra/memory": "0.11.1",
+    "@mastra/client-js": "0.10.18",
+    "@mastra/core": "0.12.1",
+    "@mastra/libsql": "0.12.0",
+    "@mastra/loggers": "0.10.5",
+    "@mastra/memory": "0.12.0",
     "open": "^10.1.2",
     "zod": "^3.22.4"
   },

typescript-sdk/apps/dojo/e2e/.gitignore

@@ -0,0 +1,2 @@
+playwright-report/
+test-results/

typescript-sdk/apps/dojo/e2e/README.md

@@ -0,0 +1,31 @@
+# CopilotKit Demo Smoke Tests
+
+This repository houses Playwright-based smoke tests that run on a 6-hour schedule to make sure CopilotKit demo apps remain live and functional.
+
+## 🔧 Local development
+
+```bash
+# Install deps
+npm install
+
+# Install browsers once
+npx playwright install --with-deps
+
+# Run the full suite
+npm test
+```
+
+Playwright HTML reports are saved to `./playwright-report`.
+
+## ➕ Adding a new smoke test
+
+1. Duplicate an existing file in `tests/` or create `tests/<demo>.spec.ts`.
+2. Use Playwright's `test` API—keep the test short (<30 s).
+3. Commit and push—GitHub Actions will pick it up on the next scheduled run.
+
+## 🚦 CI / CD
+
+- `.github/workflows/scheduled-tests.yml` executes the suite every 6 hours and on manual trigger.
+- Failing runs surface in the Actions tab; the HTML report is uploaded as an artifact.
+- (Optional) Slack notifications can be wired by adding a step after the tests.
+- Slack alert on failure is baked into the workflow. Just add `SLACK_WEBHOOK_URL` (Incoming Webhook) in repo secrets.