From 915415a260babefa2728df79807667aad2605e05 Mon Sep 17 00:00:00 2001
From: Tyler Slaton <tyler@copilotkit.ai>
Date: Mon, 26 Jan 2026 12:30:45 -0500
Subject: [PATCH] refactor: overhaul design, UI and architecture for simplicity

- Brand new mono-repo structure with Turbo
- Utilize all of the latest recommendations for LangGraph for agent
- Use CopilotKit's v2 UI's and hooks
- Add ThreeJS example MCP App server to the mono-repo
- Add .env.example
- New README structure
- Restructure components for progressive disclosure of complexity
- Add new "canvas mode" to default UI
- Include new suggestions for guiding and teaching about CopilotKit
---
 .env.example                                  |   1 +
 .github/workflows/{smoke.yml => ci.yml}       |  62 +++-
 .gitignore                                    |  22 +-
 CLAUDE.md                                     | 286 ++++++++++++++++++
 README.md                                     |  12 +-
 agent/main.py                                 |  30 --
 {agent => apps/agent}/.gitignore              |   0
 {agent => apps/agent}/langgraph.json          |   2 +-
 apps/agent/main.py                            |  37 +++
 apps/agent/package.json                       |  12 +
 {agent => apps/agent}/pyproject.toml          |   5 +-
 apps/agent/src/db.csv                         |  16 +
 apps/agent/src/query.py                       |  13 +
 apps/agent/src/todos.py                       |  48 +++
 {agent => apps/agent}/uv.lock                 | 275 +++++++++++++++--
 .../app/eslint.config.mjs                     |   0
 next.config.ts => apps/app/next.config.ts     |   0
 apps/app/package.json                         |  35 +++
 .../app/postcss.config.mjs                    |   0
 {public => apps/app/public}/file.svg          |   0
 {public => apps/app/public}/globe.svg         |   0
 {public => apps/app/public}/next.svg          |   0
 {public => apps/app/public}/vercel.svg        |   0
 {public => apps/app/public}/window.svg        |   0
 .../app/api/copilotkit/ag-ui-middleware.ts    |  13 +
 apps/app/src/app/api/copilotkit/route.ts      |  33 ++
 {src => apps/app/src}/app/favicon.ico         | Bin
 {src => apps/app/src}/app/globals.css         |   0
 apps/app/src/app/layout.tsx                   |  22 ++
 apps/app/src/app/page.tsx                     |  24 ++
 apps/app/src/components/canvas/index.tsx      |  21 ++
 apps/app/src/components/canvas/todo-card.tsx  | 153 ++++++++++
 .../app/src/components/canvas/todo-column.tsx |  78 +++++
 apps/app/src/components/canvas/todo-list.tsx  | 106 +++++++
 .../src/components/example-layout/index.tsx   |  64 ++++
 .../components/example-layout/mode-toggle.tsx |  37 +++
 .../generative-ui/charts/bar-chart.tsx        |  53 ++++
 .../components/generative-ui/charts/config.ts |  18 ++
 .../generative-ui/charts/pie-chart.tsx        |  64 ++++
 .../generative-ui/meeting-time-picker.tsx     | 120 ++++++++
 apps/app/src/components/headless-chat.tsx     |  30 ++
 apps/app/src/hooks/index.ts                   |   2 +
 .../app/src/hooks/use-example-suggestions.tsx |  14 +
 .../src/hooks/use-generative-ui-examples.tsx  | 112 +++++++
 tsconfig.json => apps/app/tsconfig.json       |   0
 apps/mcp/.gitignore                           |   3 +
 apps/mcp/README.md                            | 110 +++++++
 apps/mcp/grid-cell.png                        | Bin 0 -> 4857 bytes
 apps/mcp/mcp-app.html                         |  14 +
 apps/mcp/package.json                         |  53 ++++
 apps/mcp/screenshot.png                       | Bin 0 -> 5647 bytes
 apps/mcp/server-utils.ts                      |  72 +++++
 apps/mcp/server.ts                            | 246 +++++++++++++++
 apps/mcp/src/global.css                       |  43 +++
 apps/mcp/src/mcp-app-wrapper.tsx              | 135 +++++++++
 apps/mcp/src/threejs-app.tsx                  | 232 ++++++++++++++
 apps/mcp/test-input.json                      |   3 +
 apps/mcp/tsconfig.json                        |  20 ++
 apps/mcp/vite.config.ts                       |  25 ++
 package.json                                  |  47 +--
 pnpm-workspace.yaml                           |   4 +
 scripts/setup-agent.bat                       |   6 -
 scripts/setup-agent.sh                        |   7 -
 src/app/api/copilotkit/route.ts               |  35 ---
 src/app/layout.tsx                            |  26 --
 src/app/page.tsx                              | 154 ----------
 src/components/moon.tsx                       |  88 ------
 src/components/proverbs.tsx                   |  18 --
 src/components/weather.tsx                    |  53 ----
 src/lib/types.ts                              |   4 -
 turbo.json                                    |  18 ++
 71 files changed, 2733 insertions(+), 503 deletions(-)
 create mode 100644 .env.example
 rename .github/workflows/{smoke.yml => ci.yml} (76%)
 create mode 100644 CLAUDE.md
 delete mode 100644 agent/main.py
 rename {agent => apps/agent}/.gitignore (100%)
 rename {agent => apps/agent}/langgraph.json (88%)
 create mode 100644 apps/agent/main.py
 create mode 100644 apps/agent/package.json
 rename {agent => apps/agent}/pyproject.toml (81%)
 create mode 100644 apps/agent/src/db.csv
 create mode 100644 apps/agent/src/query.py
 create mode 100644 apps/agent/src/todos.py
 rename {agent => apps/agent}/uv.lock (88%)
 rename eslint.config.mjs => apps/app/eslint.config.mjs (100%)
 rename next.config.ts => apps/app/next.config.ts (100%)
 create mode 100644 apps/app/package.json
 rename postcss.config.mjs => apps/app/postcss.config.mjs (100%)
 rename {public => apps/app/public}/file.svg (100%)
 rename {public => apps/app/public}/globe.svg (100%)
 rename {public => apps/app/public}/next.svg (100%)
 rename {public => apps/app/public}/vercel.svg (100%)
 rename {public => apps/app/public}/window.svg (100%)
 create mode 100644 apps/app/src/app/api/copilotkit/ag-ui-middleware.ts
 create mode 100644 apps/app/src/app/api/copilotkit/route.ts
 rename {src => apps/app/src}/app/favicon.ico (100%)
 rename {src => apps/app/src}/app/globals.css (100%)
 create mode 100644 apps/app/src/app/layout.tsx
 create mode 100644 apps/app/src/app/page.tsx
 create mode 100644 apps/app/src/components/canvas/index.tsx
 create mode 100644 apps/app/src/components/canvas/todo-card.tsx
 create mode 100644 apps/app/src/components/canvas/todo-column.tsx
 create mode 100644 apps/app/src/components/canvas/todo-list.tsx
 create mode 100644 apps/app/src/components/example-layout/index.tsx
 create mode 100644 apps/app/src/components/example-layout/mode-toggle.tsx
 create mode 100644 apps/app/src/components/generative-ui/charts/bar-chart.tsx
 create mode 100644 apps/app/src/components/generative-ui/charts/config.ts
 create mode 100644 apps/app/src/components/generative-ui/charts/pie-chart.tsx
 create mode 100644 apps/app/src/components/generative-ui/meeting-time-picker.tsx
 create mode 100644 apps/app/src/components/headless-chat.tsx
 create mode 100644 apps/app/src/hooks/index.ts
 create mode 100644 apps/app/src/hooks/use-example-suggestions.tsx
 create mode 100644 apps/app/src/hooks/use-generative-ui-examples.tsx
 rename tsconfig.json => apps/app/tsconfig.json (100%)
 create mode 100644 apps/mcp/.gitignore
 create mode 100644 apps/mcp/README.md
 create mode 100644 apps/mcp/grid-cell.png
 create mode 100644 apps/mcp/mcp-app.html
 create mode 100644 apps/mcp/package.json
 create mode 100644 apps/mcp/screenshot.png
 create mode 100644 apps/mcp/server-utils.ts
 create mode 100644 apps/mcp/server.ts
 create mode 100644 apps/mcp/src/global.css
 create mode 100644 apps/mcp/src/mcp-app-wrapper.tsx
 create mode 100644 apps/mcp/src/threejs-app.tsx
 create mode 100644 apps/mcp/test-input.json
 create mode 100644 apps/mcp/tsconfig.json
 create mode 100644 apps/mcp/vite.config.ts
 create mode 100644 pnpm-workspace.yaml
 delete mode 100644 scripts/setup-agent.bat
 delete mode 100755 scripts/setup-agent.sh
 delete mode 100644 src/app/api/copilotkit/route.ts
 delete mode 100644 src/app/layout.tsx
 delete mode 100644 src/app/page.tsx
 delete mode 100644 src/components/moon.tsx
 delete mode 100644 src/components/proverbs.tsx
 delete mode 100644 src/components/weather.tsx
 delete mode 100644 src/lib/types.ts
 create mode 100644 turbo.json

diff --git a/.env.example b/.env.example
new file mode 100644
index 0000000..9847a1d
--- /dev/null
+++ b/.env.example
@@ -0,0 +1 @@
+OPENAI_API_KEY=
\ No newline at end of file
diff --git a/.github/workflows/smoke.yml b/.github/workflows/ci.yml
similarity index 76%
rename from .github/workflows/smoke.yml
rename to .github/workflows/ci.yml
index 2ccf24b..54f0bd1 100644
--- a/.github/workflows/smoke.yml
+++ b/.github/workflows/ci.yml
@@ -1,4 +1,4 @@
-name: Smoke
+name: CI
 
 on:
   push:
@@ -10,13 +10,13 @@ on:
 
 jobs:
   smoke:
-    name: ${{ matrix.os }} / Node ${{ matrix.node }} / Python ${{ matrix.python }}
+    name: Smoke / ${{ matrix.os }} / Node ${{ matrix.node }} / Python ${{ matrix.python }}
     runs-on: ${{ matrix.os }}
     strategy:
       fail-fast: false
       matrix:
-        os: [ubuntu-latest, windows-latest, macos-latest]
-        node: [20, 22]
+        os: [ubuntu-latest, windows-latest]
+        node: [22, 24]
         python: [3.12, 3.13]
 
     steps:
@@ -33,6 +33,9 @@ jobs:
         with:
           python-version: ${{ matrix.python }}
 
+      - name: Install pnpm
+        uses: pnpm/action-setup@v4
+
       - name: Install uv
         uses: astral-sh/setup-uv@v4
         with:
@@ -41,22 +44,20 @@ jobs:
       - name: Configure uv to use matrix Python version
         run: echo "UV_PYTHON=python${{ matrix.python }}" >> $GITHUB_ENV
 
-      - name: Install Node.js dependencies (root)
-        run: npm install
+      - name: Install dependencies (monorepo)
+        run: pnpm install
 
-      - name: Install Node.js dependencies (agent)
-        run: |
-          cd agent
-          npm install
+      - name: Build all apps
+        run: pnpm build
 
-      - name: Build frontend
-        run: npm run build
+      - name: Create empty .env file
+        run: touch .env
 
       - name: Test frontend startup (Linux/macOS)
         if: runner.os != 'Windows'
         run: |
           # Start the Next.js frontend in background
-          npm start &
+          pnpm --filter app start &
           FRONTEND_PID=$!
 
           # Wait for frontend to start (max 30 seconds)
@@ -87,7 +88,7 @@ jobs:
         if: runner.os == 'Windows'
         run: |
           # Start the Next.js frontend in background
-          npm start &
+          pnpm --filter app start &
 
           # Wait for frontend to start (max 30 seconds)
           $timeout = 30
@@ -113,13 +114,42 @@ jobs:
           }
         shell: pwsh
 
+  lint:
+    name: Lint
+    runs-on: ubuntu-latest
+
+    steps:
+      - name: Checkout
+        uses: actions/checkout@v4
+
+      - name: Setup Node.js
+        uses: actions/setup-node@v4
+        with:
+          node-version: 22
+
+      - name: Setup Python
+        uses: actions/setup-python@v4
+        with:
+          python-version: 3.12
+
+      - name: Install pnpm
+        uses: pnpm/action-setup@v4
+
+      - name: Install uv
+        uses: astral-sh/setup-uv@v4
+        with:
+          enable-cache: true
+
+      - name: Install dependencies
+        run: pnpm install
+
       - name: Run linting
-        run: npm run lint
+        run: pnpm lint
 
   notify-slack:
     name: Notify Slack on Failure
     runs-on: ubuntu-latest
-    needs: smoke
+    needs: [smoke, lint]
     if: |
       failure() &&
       github.event_name == 'schedule'
diff --git a/.gitignore b/.gitignore
index be9e14d..5645994 100644
--- a/.gitignore
+++ b/.gitignore
@@ -1,8 +1,8 @@
 # See https://help.github.com/articles/ignoring-files/ for more about ignoring files.
 
 # dependencies
-/node_modules
-/.pnp
+node_modules
+.pnp
 .pnp.*
 .yarn/*
 !.yarn/patches
@@ -11,14 +11,14 @@
 !.yarn/versions
 
 # testing
-/coverage
+coverage
 
 # next.js
-/.next/
-/out/
+.next/
+out/
 
 # production
-/build
+build
 
 # misc
 .DS_Store
@@ -32,6 +32,7 @@ yarn-error.log*
 
 # env files (can opt-in for committing if needed)
 .env*
+!.env.example
 
 # vercel
 .vercel
@@ -48,3 +49,12 @@ bun.lockb
 
 # LangGraph API
 .langgraph_api
+
+# Git worktrees
+.worktrees
+
+# Turbo
+.turbo
+
+# Tools
+.claude
diff --git a/CLAUDE.md b/CLAUDE.md
new file mode 100644
index 0000000..6070bc5
--- /dev/null
+++ b/CLAUDE.md
@@ -0,0 +1,286 @@
+# CopilotKit + LangGraph Todo Demo
+
+## Purpose
+
+This repository serves as both a **showcase** and **template** for building AI agents with CopilotKit and LangGraph. It demonstrates how CopilotKit can drive interactive UI beyond just chat, using a **collaborative todo list** as the primary example.
+
+**Target audience:** Developers evaluating CopilotKit or starting new projects with AI agents.
+
+## Core Concept
+
+The todo list demonstrates **agent-driven UI** where:
+- The agent can manipulate application state (adding todos, updating status, organizing tasks)
+- Users can interact with the same state (editing titles, checking off tasks, deleting todos)
+- Both agent and user changes update the same shared state
+- The UI reactively updates based on agent state changes
+
+This uses CopilotKit's **v2 agent state pattern** where state lives in the agent and syncs to the frontend.
+
+## Architecture
+
+This is a **Turborepo monorepo** with three apps:
+
+### Repository Structure
+
+```
+apps/
+├── app/                         # Next.js frontend
+│   ├── src/
+│   │   ├── app/
+│   │   │   ├── page.tsx        # Main page - wires up all components
+│   │   │   └── api/copilotkit/ # CopilotKit API route
+│   │   ├── components/
+│   │   │   ├── canvas/         # Todo list UI
+│   │   │   │   ├── index.tsx   # Canvas container
+│   │   │   │   ├── todo-list.tsx    # Todo list with columns
+│   │   │   │   ├── todo-column.tsx  # Column (pending/completed)
+│   │   │   │   └── todo-card.tsx    # Individual todo card
+│   │   │   ├── example-layout/ # Layout: chat + canvas side-by-side
+│   │   │   └── generative-ui/  # Example generative UI components
+│   │   └── hooks/
+│   │       ├── use-generative-ui-examples.tsx  # Example CopilotKit patterns
+│   │       └── use-example-suggestions.tsx     # Chat suggestions
+├── agent/                       # LangGraph Python agent
+│   ├── main.py                  # Agent entry point
+│   └── src/
+│       ├── todos.py             # Todo tools and state schema
+│       └── query.py             # Example data query tool
+└── mcp/                         # MCP (Model Context Protocol) integration
+```
+
+## Key Pattern: Agent State with CopilotKit v2
+
+The todo list uses **CopilotKit v2's agent state pattern** where state lives in the agent backend and syncs bidirectionally with the frontend.
+
+### How It Works
+
+1. **Agent defines state schema and tools** (Python)
+   ```python
+   # apps/agent/src/todos.py
+   class Todo(TypedDict):
+       id: str
+       title: str
+       description: str
+       emoji: str
+       status: Literal["pending", "completed"]
+
+   class AgentState(TypedDict):
+       todos: list[Todo]
+
+   @tool
+   def manage_todos(todos: list[Todo], runtime: ToolRuntime) -> Command:
+       """Manage the current todos."""
+       return Command(update={"todos": todos, ...})
+   ```
+
+2. **Frontend reads from agent state**
+   ```typescript
+   // apps/app/src/components/canvas/index.tsx
+   const { agent } = useAgent();
+
+   return (
+     <TodoList
+       todos={agent.state?.todos || []}
+       onUpdate={(updatedTodos) => agent.setState({ todos: updatedTodos })}
+       isAgentRunning={agent.isRunning}
+     />
+   );
+   ```
+
+3. **User interactions update agent state**
+   ```typescript
+   // User clicks checkbox → frontend calls agent.setState()
+   const toggleStatus = (todo) => {
+     const updated = todos.map(t =>
+       t.id === todo.id ? { ...t, status: t.status === "completed" ? "pending" : "completed" } : t
+     );
+     agent.setState({ todos: updated });
+   };
+   ```
+
+4. **Agent can manipulate state via tools**
+   - The agent calls `manage_todos` tool to update the todo list
+   - Both user and agent changes update the same `agent.state.todos`
+   - Frontend automatically re-renders when state changes
+
+### Why This Pattern?
+
+- **Single source of truth**: State lives in the agent, not duplicated in frontend
+- **Bidirectional sync**: User changes → agent state, Agent changes → UI update
+- **Simple**: No need for separate frontend state management
+- **Observable**: Agent has full visibility into state changes
+
+## Implementation Details
+
+### Agent Backend
+
+**Agent Definition** (`apps/agent/main.py`):
+```python
+from langchain.agents import create_agent
+from copilotkit import CopilotKitMiddleware
+from src.todos import todo_tools, AgentState
+
+agent = create_agent(
+    model="gpt-5.2",
+    tools=[*todo_tools, ...],  # manage_todos, get_todos
+    middleware=[CopilotKitMiddleware()],
+    state_schema=AgentState,  # Defines state shape
+    system_prompt="You are a helpful assistant..."
+)
+```
+
+**Todo Tools** (`apps/agent/src/todos.py`):
+```python
+@tool
+def manage_todos(todos: list[Todo], runtime: ToolRuntime) -> Command:
+    """Manage the current todos."""
+    # Ensure todos have unique IDs
+    for todo in todos:
+        if "id" not in todo or not todo["id"]:
+            todo["id"] = str(uuid.uuid4())
+
+    # Update agent state
+    return Command(update={
+        "todos": todos,
+        "messages": [ToolMessage(...)]
+    })
+
+@tool
+def get_todos(runtime: ToolRuntime):
+    """Get the current todos."""
+    return runtime.state.get("todos", [])
+```
+
+### Frontend
+
+**Canvas Component** (`apps/app/src/components/canvas/index.tsx`):
+```typescript
+export function Canvas() {
+  const { agent } = useAgent();  // CopilotKit v2 hook
+
+  return (
+    <div className="h-full p-8 bg-gray-50">
+      <TodoList
+        // Read state from agent
+        todos={agent.state?.todos || []}
+        // Update state in agent
+        onUpdate={(updatedTodos) => agent.setState({ todos: updatedTodos })}
+        // React to agent execution
+        isAgentRunning={agent.isRunning}
+      />
+    </div>
+  );
+}
+```
+
+**Todo List** (`apps/app/src/components/canvas/todo-list.tsx`):
+```typescript
+export function TodoList({ todos, onUpdate, isAgentRunning }: TodoListProps) {
+  const toggleStatus = (todo: Todo) => {
+    const updated = todos.map((t) =>
+      t.id === todo.id
+        ? { ...t, status: t.status === "completed" ? "pending" : "completed" }
+        : t
+    );
+    onUpdate(updated);  // Calls agent.setState()
+  };
+
+  const addTodo = () => {
+    const newTodo = { id: crypto.randomUUID(), ... };
+    onUpdate([...todos, newTodo]);
+  };
+
+  return (
+    <div className="flex gap-8">
+      <TodoColumn title="To Do" todos={pendingTodos} onAddTodo={addTodo} ... />
+      <TodoColumn title="Done" todos={completedTodos} ... />
+    </div>
+  );
+}
+```
+
+### How State Flows
+
+1. **User adds/edits todo** → Frontend calls `agent.setState({ todos: [...] })`
+2. **Agent state updates** → CopilotKit syncs to backend
+3. **Agent observes change** → Can respond via `manage_todos` tool
+4. **Agent modifies todos** → Calls `manage_todos` tool
+5. **State syncs to frontend** → `agent.state.todos` updates
+6. **UI re-renders** → React sees new state and updates display
+
+**Key insight**: State lives in the agent, frontend just reads/writes to it via CopilotKit hooks.
+
+## Tech Stack
+
+- **Frontend**: Next.js 16, React 19, TailwindCSS 4
+- **Agent**: LangGraph (Python), OpenAI GPT-5.2
+- **CopilotKit**: React hooks for agent integration (v2)
+- **Monorepo**: Turborepo with pnpm workspaces
+- **Other**: MCP (Model Context Protocol) integration, Recharts for generative UI examples
+
+## Development
+
+This is a Turborepo monorepo using pnpm workspaces.
+
+```bash
+# Install dependencies (all apps)
+pnpm install
+
+# Start all apps (app, agent, mcp)
+pnpm dev
+
+# Start individually
+pnpm dev:app    # Next.js frontend on port 3000
+pnpm dev:agent  # LangGraph agent on port 8123
+pnpm dev:mcp    # MCP server
+
+# Build all apps
+pnpm build
+
+# Lint all apps
+pnpm lint
+```
+
+### Environment Setup
+
+```bash
+# Set OpenAI API key for the agent
+echo 'OPENAI_API_KEY=your-key-here' > apps/agent/.env
+```
+
+## Design Principles
+
+1. **Simple over complex** - The todo list is intentionally simple and focused
+2. **CopilotKit v2 patterns** - Uses modern agent state management
+3. **Template-first** - Code is meant to be forked and extended
+4. **Showcasing agent-driven UI** - Demonstrates AI manipulating application state beyond chat
+
+## Future Enhancements
+
+Possible extensions to demonstrate more CopilotKit capabilities:
+- Todo categories/tags/priorities
+- Agent-driven task organization (auto-categorize, suggest priorities)
+- Due dates and reminders
+- Subtasks and dependencies
+- Export/import todo lists
+- Undo/redo with state history
+- Real-time collaboration
+
+---
+
+## Key Takeaways for Developers
+
+**State Management Pattern**: This app uses CopilotKit v2's agent state pattern where:
+- State is defined in the agent backend (Python TypedDict)
+- Frontend reads via `agent.state.todos`
+- Frontend writes via `agent.setState({ todos: ... })`
+- Agent can modify state via tools (`manage_todos`)
+- Changes sync bidirectionally automatically
+
+**When extending this template**:
+- Define state schema in the agent (`AgentState`)
+- Create tools that manipulate state via `Command(update={...})`
+- Use `useAgent()` hook in frontend to read/write state
+- Let CopilotKit handle the sync - no manual state management needed
+
+This pattern works great for **agent-driven applications** where the AI needs to manipulate structured application state, not just chat.
diff --git a/README.md b/README.md
index c925160..18a757d 100644
--- a/README.md
+++ b/README.md
@@ -32,12 +32,16 @@ yarn install
 bun install
 ```
 
-> **Note:** Installing the package dependencies will also install the agent's python dependencies via the `install:agent` script.
 
+2. Set up your environment variables:
+```bash
+cp .env.example .env
+```
+
+Then edit the `.env` file and add your OpenAI API key:
 
-2. Set up your OpenAI API key:
 ```bash
-echo 'OPENAI_API_KEY=your-openai-api-key-here' > agent/.env
+OPENAI_API_KEY=your-openai-api-key-here
 ```
 
 3. Start the development server:
@@ -79,8 +83,6 @@ The main UI component is in `src/app/page.tsx`. You can:
 
 - [LangGraph Documentation](https://langchain-ai.github.io/langgraph/) - Learn more about LangGraph and its features
 - [CopilotKit Documentation](https://docs.copilotkit.ai) - Explore CopilotKit's capabilities
-- [Next.js Documentation](https://nextjs.org/docs) - Learn about Next.js features and API
-- [YFinance Documentation](https://pypi.org/project/yfinance/) - Financial data tools
 
 ## Contributing
 
diff --git a/agent/main.py b/agent/main.py
deleted file mode 100644
index f1312e8..0000000
--- a/agent/main.py
+++ /dev/null
@@ -1,30 +0,0 @@
-"""
-This is the main entry point for the agent.
-It defines the workflow graph, state, tools, nodes and edges.
-"""
-
-from typing import List
-
-from langchain.tools import tool
-from langchain.agents import create_agent
-from copilotkit import CopilotKitMiddleware, CopilotKitState
-
-@tool
-def get_weather(location: str):
-    """
-    Get the weather for a given location.
-    """
-    return f"The weather for {location} is 70 degrees."
-
-class AgentState(CopilotKitState):
-    proverbs: List[str]
-
-agent = create_agent(
-    model="gpt-4.1-mini",
-    tools=[get_weather],
-    middleware=[CopilotKitMiddleware()],
-    state_schema=AgentState,
-    system_prompt="You are a helpful research assistant."
-)
-
-graph = agent
diff --git a/agent/.gitignore b/apps/agent/.gitignore
similarity index 100%
rename from agent/.gitignore
rename to apps/agent/.gitignore
diff --git a/agent/langgraph.json b/apps/agent/langgraph.json
similarity index 88%
rename from agent/langgraph.json
rename to apps/agent/langgraph.json
index dd21781..804b1ea 100644
--- a/agent/langgraph.json
+++ b/apps/agent/langgraph.json
@@ -6,5 +6,5 @@
   "graphs": {
     "sample_agent": "./main.py:graph"
   },
-  "env": ".env"
+  "env": "../../.env"
 }
diff --git a/apps/agent/main.py b/apps/agent/main.py
new file mode 100644
index 0000000..78c7f67
--- /dev/null
+++ b/apps/agent/main.py
@@ -0,0 +1,37 @@
+"""
+This is the main entry point for the agent.
+It defines the workflow graph, state, tools, nodes and edges.
+"""
+
+import asyncio
+from langchain.agents import create_agent
+from copilotkit import CopilotKitMiddleware
+from langchain_mcp_adapters.client import MultiServerMCPClient
+from src.query import query_data
+from src.todos import todo_tools, AgentState
+
+client = MultiServerMCPClient({
+    "copilotkit": {
+        "transport": "http",
+        "url": "https://mcp.copilotkit.ai",
+    }
+})
+
+mcp_tools = asyncio.run(client.get_tools())
+
+agent = create_agent(
+    model="gpt-5.2",
+    tools=[query_data, *mcp_tools, *todo_tools],
+    middleware=[CopilotKitMiddleware()],
+    state_schema=AgentState,
+    system_prompt=f"""
+        You are a helpful assistant that helps users understand CopilotKit and LangGraph used together.
+
+        When asked about generative UI:
+        1. Ground yourself in relevant information from the CopilotKit documentation.
+        2. Use one of the relevant tools to demonstrate that piece of generative UI.
+        3. Explain the concept to the user with a brief summary.
+    """
+)
+
+graph = agent
diff --git a/apps/agent/package.json b/apps/agent/package.json
new file mode 100644
index 0000000..53af393
--- /dev/null
+++ b/apps/agent/package.json
@@ -0,0 +1,12 @@
+{
+  "name": "@repo/agent",
+  "version": "0.1.0",
+  "private": true,
+  "scripts": {
+    "dev": "npx @langchain/langgraph-cli dev --port 8123 --no-browser",
+    "postinstall": "uv sync"
+  },
+  "devDependencies": {
+    "@langchain/langgraph-cli": "^1.1.12"
+  }
+}
diff --git a/agent/pyproject.toml b/apps/agent/pyproject.toml
similarity index 81%
rename from agent/pyproject.toml
rename to apps/agent/pyproject.toml
index fb0ea47..5bb21d3 100644
--- a/agent/pyproject.toml
+++ b/apps/agent/pyproject.toml
@@ -13,6 +13,7 @@ dependencies = [
     "python-dotenv>=1.0.0,<2.0.0",
     "langgraph-cli[inmem]>=0.4.11",
     "langchain-openai>=1.1.0",
-    "copilotkit>=0.1.74",
-    "langgraph-api>=0.6.0",
+    "copilotkit>=0.1.77",
+    "langgraph-api>=0.7.16",
+    "langchain-mcp-adapters>=0.2.1",
 ]
diff --git a/apps/agent/src/db.csv b/apps/agent/src/db.csv
new file mode 100644
index 0000000..ee25411
--- /dev/null
+++ b/apps/agent/src/db.csv
@@ -0,0 +1,16 @@
+date,category,subcategory,amount,type
+2026-01-01,Revenue,Subscriptions,45000,income
+2026-01-01,Revenue,One-time Sales,12000,income
+2026-01-01,Expenses,Salaries,30000,expense
+2026-01-01,Expenses,Infrastructure,5000,expense
+2026-01-01,Expenses,Marketing,8000,expense
+2026-02-01,Revenue,Subscriptions,48000,income
+2026-02-01,Revenue,One-time Sales,15000,income
+2026-02-01,Expenses,Salaries,30000,expense
+2026-02-01,Expenses,Infrastructure,5500,expense
+2026-02-01,Expenses,Marketing,10000,expense
+2026-03-01,Revenue,Subscriptions,52000,income
+2026-03-01,Revenue,One-time Sales,18000,income
+2026-03-01,Expenses,Salaries,32000,expense
+2026-03-01,Expenses,Infrastructure,6000,expense
+2026-03-01,Expenses,Marketing,12000,expense
diff --git a/apps/agent/src/query.py b/apps/agent/src/query.py
new file mode 100644
index 0000000..c4a63c8
--- /dev/null
+++ b/apps/agent/src/query.py
@@ -0,0 +1,13 @@
+from langchain.tools import tool
+from pathlib import Path
+import csv
+
+@tool
+def query_data(query: str):
+    """
+    Query the database. Always call before showing a chart or graph.
+    """
+    csv_path = Path(__file__).parent / "db.csv"
+    with open(csv_path) as f:
+        reader = csv.DictReader(f)
+        return list(reader)
\ No newline at end of file
diff --git a/apps/agent/src/todos.py b/apps/agent/src/todos.py
new file mode 100644
index 0000000..2d10e82
--- /dev/null
+++ b/apps/agent/src/todos.py
@@ -0,0 +1,48 @@
+from langchain.tools import ToolRuntime, tool
+from langchain.messages import ToolMessage
+from langgraph.types import Command
+from typing import TypedDict, Literal
+import uuid
+
+class Todo(TypedDict):
+    id: str
+    title: str
+    description: str
+    emoji: str
+    status: Literal["pending", "completed"]
+
+class AgentState(TypedDict):
+    todos: list[Todo]
+
+@tool
+def manage_todos(todos: list[Todo], runtime: ToolRuntime) -> Command:
+    """
+    Manage the current todos.
+    """
+    # Ensure all todos have IDs that are unique
+    for todo in todos:
+        if "id" not in todo or not todo["id"]:
+            todo["id"] = str(uuid.uuid4())
+
+    # Update the state
+    return Command(update={
+        "todos": todos,
+        "messages": [
+            ToolMessage(
+                content="Successfully updated todos",
+                tool_call_id=runtime.tool_call_id
+            )
+        ]
+    })
+
+@tool
+def get_todos(runtime: ToolRuntime):
+    """
+    Get the current todos.
+    """
+    return runtime.state.get("todos", [])
+
+todo_tools = [
+    manage_todos,
+    get_todos,
+]
\ No newline at end of file
diff --git a/agent/uv.lock b/apps/agent/uv.lock
similarity index 88%
rename from agent/uv.lock
rename to apps/agent/uv.lock
index 0c5ad34..8991989 100644
--- a/agent/uv.lock
+++ b/apps/agent/uv.lock
@@ -4,7 +4,7 @@ requires-python = ">=3.12"
 
 [[package]]
 name = "ag-ui-langgraph"
-version = "0.0.23"
+version = "0.0.24"
 source = { registry = "https://pypi.org/simple" }
 dependencies = [
     { name = "ag-ui-protocol" },
@@ -13,9 +13,9 @@ dependencies = [
     { name = "langgraph" },
     { name = "pydantic" },
 ]
-sdist = { url = "https://files.pythonhosted.org/packages/8b/76/beca247c88713c9ecca28d229419a1cb81644c0c7e1a4d9872baf4ad7900/ag_ui_langgraph-0.0.23.tar.gz", hash = "sha256:6f44958b996e7be4ca77533932857369e5ac038bfd60281b6a9fc28916d2af4e", size = 13032, upload-time = "2026-01-09T15:51:09.735Z" }
+sdist = { url = "https://files.pythonhosted.org/packages/05/b2/b63b17f360c43db6b315f034d663faa43d0080f40a08ccc07c0c9654c291/ag_ui_langgraph-0.0.24.tar.gz", hash = "sha256:48416b22dc83aac677ad4c82a0946689e10fcb7283c33c8765c04fdf2b53f090", size = 13200, upload-time = "2026-01-28T13:50:32.793Z" }
 wheels = [
-    { url = "https://files.pythonhosted.org/packages/52/0f/5f2d5bc4582ae3e9d7aab3a2db77827ab7bd2cc77381892deb58fd4fd00f/ag_ui_langgraph-0.0.23-py3-none-any.whl", hash = "sha256:d1911eb6cf28749ebc17c176de7d5bb134cc14b73cc5764005fc38ba6b76c2fb", size = 14760, upload-time = "2026-01-09T15:51:08.608Z" },
+    { url = "https://files.pythonhosted.org/packages/13/30/f6f94479b80de837ad3f2f4189136365167477759f7d35a97ef254461eed/ag_ui_langgraph-0.0.24-py3-none-any.whl", hash = "sha256:d424e20d01254b58d45f99104ba368c6f304a67df471235444d0031d8579fa2c", size = 14945, upload-time = "2026-01-28T13:50:30.971Z" },
 ]
 
 [package.optional-dependencies]
@@ -57,6 +57,15 @@ wheels = [
     { url = "https://files.pythonhosted.org/packages/38/0e/27be9fdef66e72d64c0cdc3cc2823101b80585f8119b5c112c2e8f5f7dab/anyio-4.12.1-py3-none-any.whl", hash = "sha256:d405828884fc140aa80a3c667b8beed277f1dfedec42ba031bd6ac3db606ab6c", size = 113592, upload-time = "2026-01-06T11:45:19.497Z" },
 ]
 
+[[package]]
+name = "attrs"
+version = "25.4.0"
+source = { registry = "https://pypi.org/simple" }
+sdist = { url = "https://files.pythonhosted.org/packages/6b/5c/685e6633917e101e5dcb62b9dd76946cbb57c26e133bae9e0cd36033c0a9/attrs-25.4.0.tar.gz", hash = "sha256:16d5969b87f0859ef33a48b35d55ac1be6e42ae49d5e853b597db70c35c57e11", size = 934251, upload-time = "2025-10-06T13:54:44.725Z" }
+wheels = [
+    { url = "https://files.pythonhosted.org/packages/3a/2a/7cc015f5b9f5db42b7d48157e23356022889fc354a2813c15934b7cb5c0e/attrs-25.4.0-py3-none-any.whl", hash = "sha256:adcf7e2a1fb3b36ac48d97835bb6d8ade15b8dcce26aba8bf1d14847b57a3373", size = 67615, upload-time = "2025-10-06T13:54:43.17Z" },
+]
+
 [[package]]
 name = "blockbuster"
 version = "1.5.26"
@@ -224,7 +233,7 @@ wheels = [
 
 [[package]]
 name = "copilotkit"
-version = "0.1.76"
+version = "0.1.77"
 source = { registry = "https://pypi.org/simple" }
 dependencies = [
     { name = "ag-ui-langgraph", extra = ["fastapi"] },
@@ -234,9 +243,9 @@ dependencies = [
     { name = "partialjson" },
     { name = "toml" },
 ]
-sdist = { url = "https://files.pythonhosted.org/packages/dc/cd/afd4cafa17d9196fb805a5a84ea2eebcef88492cd7d4df0250434eeacdc2/copilotkit-0.1.76.tar.gz", hash = "sha256:03190bf289aceac073f2524681a3c1bafbabcdd97276c697ded0aa661dbcec84", size = 36845, upload-time = "2026-01-09T16:07:55.278Z" }
+sdist = { url = "https://files.pythonhosted.org/packages/f5/4c/0a60cc230318f83fe2d8e217572955e5269eb0ca9b8e8357759ca40878d9/copilotkit-0.1.77.tar.gz", hash = "sha256:a3ea824e6957d844b1465f899599d714bd2db0740e6d7134dc5d55b06dbb914e", size = 36846, upload-time = "2026-01-28T13:54:19.186Z" }
 wheels = [
-    { url = "https://files.pythonhosted.org/packages/d4/28/57819cfe9a8a437e348ed04a3c958d4ec12fa455e52fdf35e8862323fd56/copilotkit-0.1.76-py3-none-any.whl", hash = "sha256:42d2e332afad47ce73760ce67ae6fae97df0def6d5446417150b075e1708d0ef", size = 46204, upload-time = "2026-01-09T16:07:53.855Z" },
+    { url = "https://files.pythonhosted.org/packages/72/20/7982431f72a84c71daa885931a38485a842b2c32c19421f5e74a3d2156f2/copilotkit-0.1.77-py3-none-any.whl", hash = "sha256:df9c7f1dcd6c2cef17dcd52e89cdc2700d0f8587dbbf8e2572b44ef5f364e9e9", size = 46205, upload-time = "2026-01-28T13:54:17.551Z" },
 ]
 
 [[package]]
@@ -470,6 +479,15 @@ wheels = [
     { url = "https://files.pythonhosted.org/packages/2a/39/e50c7c3a983047577ee07d2a9e53faf5a69493943ec3f6a384bdc792deb2/httpx-0.28.1-py3-none-any.whl", hash = "sha256:d909fcccc110f8c7faf814ca82a9a4d816bc5a6dbfea25d6591d6985b8ba59ad", size = 73517, upload-time = "2024-12-06T15:37:21.509Z" },
 ]
 
+[[package]]
+name = "httpx-sse"
+version = "0.4.3"
+source = { registry = "https://pypi.org/simple" }
+sdist = { url = "https://files.pythonhosted.org/packages/0f/4c/751061ffa58615a32c31b2d82e8482be8dd4a89154f003147acee90f2be9/httpx_sse-0.4.3.tar.gz", hash = "sha256:9b1ed0127459a66014aec3c56bebd93da3c1bc8bb6618c8082039a44889a755d", size = 15943, upload-time = "2025-10-10T21:48:22.271Z" }
+wheels = [
+    { url = "https://files.pythonhosted.org/packages/d2/fd/6668e5aec43ab844de6fc74927e155a3b37bf40d7c3790e49fc0406b6578/httpx_sse-0.4.3-py3-none-any.whl", hash = "sha256:0ac1c9fe3c0afad2e0ebb25a934a59f4c7823b60792691f779fad2c5568830fc", size = 8960, upload-time = "2025-10-10T21:48:21.158Z" },
+]
+
 [[package]]
 name = "idna"
 version = "3.11"
@@ -580,6 +598,21 @@ wheels = [
     { url = "https://files.pythonhosted.org/packages/71/92/5e77f98553e9e75130c78900d000368476aed74276eb8ae8796f65f00918/jsonpointer-3.0.0-py2.py3-none-any.whl", hash = "sha256:13e088adc14fca8b6aa8177c044e12701e6ad4b28ff10e65f2267a90109c9942", size = 7595, upload-time = "2024-06-10T19:24:40.698Z" },
 ]
 
+[[package]]
+name = "jsonschema"
+version = "4.26.0"
+source = { registry = "https://pypi.org/simple" }
+dependencies = [
+    { name = "attrs" },
+    { name = "jsonschema-specifications" },
+    { name = "referencing" },
+    { name = "rpds-py" },
+]
+sdist = { url = "https://files.pythonhosted.org/packages/b3/fc/e067678238fa451312d4c62bf6e6cf5ec56375422aee02f9cb5f909b3047/jsonschema-4.26.0.tar.gz", hash = "sha256:0c26707e2efad8aa1bfc5b7ce170f3fccc2e4918ff85989ba9ffa9facb2be326", size = 366583, upload-time = "2026-01-07T13:41:07.246Z" }
+wheels = [
+    { url = "https://files.pythonhosted.org/packages/69/90/f63fb5873511e014207a475e2bb4e8b2e570d655b00ac19a9a0ca0a385ee/jsonschema-4.26.0-py3-none-any.whl", hash = "sha256:d489f15263b8d200f8387e64b4c3a75f06629559fb73deb8fdfb525f2dab50ce", size = 90630, upload-time = "2026-01-07T13:41:05.306Z" },
+]
+
 [[package]]
 name = "jsonschema-rs"
 version = "0.29.1"
@@ -602,6 +635,18 @@ wheels = [
     { url = "https://files.pythonhosted.org/packages/13/e8/f0ad941286cd350b879dd2b3c848deecd27f0b3fbc0ff44f2809ad59718d/jsonschema_rs-0.29.1-cp313-cp313-win_amd64.whl", hash = "sha256:1c4e5a61ac760a2fc3856a129cc84aa6f8fba7b9bc07b19fe4101050a8ecc33c", size = 1871619, upload-time = "2025-02-08T21:24:42.286Z" },
 ]
 
+[[package]]
+name = "jsonschema-specifications"
+version = "2025.9.1"
+source = { registry = "https://pypi.org/simple" }
+dependencies = [
+    { name = "referencing" },
+]
+sdist = { url = "https://files.pythonhosted.org/packages/19/74/a633ee74eb36c44aa6d1095e7cc5569bebf04342ee146178e2d36600708b/jsonschema_specifications-2025.9.1.tar.gz", hash = "sha256:b540987f239e745613c7a9176f3edb72b832a4ac465cf02712288397832b5e8d", size = 32855, upload-time = "2025-09-08T01:34:59.186Z" }
+wheels = [
+    { url = "https://files.pythonhosted.org/packages/41/45/1a4ed80516f02155c51f51e8cedb3c1902296743db0bbc66608a0db2814f/jsonschema_specifications-2025.9.1-py3-none-any.whl", hash = "sha256:98802fee3a11ee76ecaca44429fda8a41bff98b00a0f2838151b113f210cc6fe", size = 18437, upload-time = "2025-09-08T01:34:57.871Z" },
+]
+
 [[package]]
 name = "langchain"
 version = "1.2.0"
@@ -635,6 +680,20 @@ wheels = [
     { url = "https://files.pythonhosted.org/packages/6e/6f/34a9fba14d191a67f7e2ee3dbce3e9b86d2fa7310e2c7f2c713583481bd2/langchain_core-1.2.7-py3-none-any.whl", hash = "sha256:452f4fef7a3d883357b22600788d37e3d8854ef29da345b7ac7099f33c31828b", size = 490232, upload-time = "2026-01-09T17:44:24.236Z" },
 ]
 
+[[package]]
+name = "langchain-mcp-adapters"
+version = "0.2.1"
+source = { registry = "https://pypi.org/simple" }
+dependencies = [
+    { name = "langchain-core" },
+    { name = "mcp" },
+    { name = "typing-extensions" },
+]
+sdist = { url = "https://files.pythonhosted.org/packages/d9/52/cebf0ef5b1acef6cbc63d671171d43af70f12d19f55577909c7afa79fb6e/langchain_mcp_adapters-0.2.1.tar.gz", hash = "sha256:58e64c44e8df29ca7eb3b656cf8c9931ef64386534d7ca261982e3bdc63f3176", size = 36394, upload-time = "2025-12-09T16:28:38.98Z" }
+wheels = [
+    { url = "https://files.pythonhosted.org/packages/03/81/b2479eb26861ab36be851026d004b2d391d789b7856e44c272b12828ece0/langchain_mcp_adapters-0.2.1-py3-none-any.whl", hash = "sha256:9f96ad4c64230f6757297fec06fde19d772c99dbdfbca987f7b7cfd51ff77240", size = 22708, upload-time = "2025-12-09T16:28:37.877Z" },
+]
+
 [[package]]
 name = "langchain-openai"
 version = "1.1.7"
@@ -668,7 +727,7 @@ wheels = [
 
 [[package]]
 name = "langgraph-api"
-version = "0.6.35"
+version = "0.7.16"
 source = { registry = "https://pypi.org/simple" }
 dependencies = [
     { name = "cloudpickle" },
@@ -683,7 +742,7 @@ dependencies = [
     { name = "langgraph-checkpoint" },
     { name = "langgraph-runtime-inmem" },
     { name = "langgraph-sdk" },
-    { name = "langsmith" },
+    { name = "langsmith", extra = ["otel"] },
     { name = "opentelemetry-api" },
     { name = "opentelemetry-exporter-otlp-proto-http" },
     { name = "opentelemetry-sdk" },
@@ -699,9 +758,9 @@ dependencies = [
     { name = "uvicorn" },
     { name = "watchfiles" },
 ]
-sdist = { url = "https://files.pythonhosted.org/packages/92/ad/4591de9fce44229e82a4df0648278991620b0f7f3827c3a70a7b00eeb3fa/langgraph_api-0.6.35.tar.gz", hash = "sha256:b9da247163380fa63fc3db54b7c6b4b04d06323f37d5a1b3dbaaec5be69aea8d", size = 438441, upload-time = "2026-01-13T04:43:41.551Z" }
+sdist = { url = "https://files.pythonhosted.org/packages/40/59/31309ac149b219213d32461c5b26ce56624f0aafa83b667c43057c709937/langgraph_api-0.7.16.tar.gz", hash = "sha256:f5f581637a855c99e7e286d777c000e4c5046284eedcbeb03c2c42cc54bde64a", size = 549679, upload-time = "2026-02-03T16:43:53.91Z" }
 wheels = [
-    { url = "https://files.pythonhosted.org/packages/ff/e4/fdc32d6eaf566332ee72db12a322c64388ba1e98b07c9b70bdcec192df21/langgraph_api-0.6.35-py3-none-any.whl", hash = "sha256:32233230f69db7f2753c3c8904b3dddec0357dc8c93c6a4d1ee957c4f3d0c832", size = 343479, upload-time = "2026-01-13T04:43:40.018Z" },
+    { url = "https://files.pythonhosted.org/packages/90/3d/51adb80fa671fe73d99b935bde8df35d44a36ddc64c13571b0f6ceefc013/langgraph_api-0.7.16-py3-none-any.whl", hash = "sha256:b97338bbac66589f36387f1d33414bcd715838ca8f71ac3b6874cc0360690b5f", size = 478917, upload-time = "2026-02-03T16:43:52.634Z" },
 ]
 
 [[package]]
@@ -719,15 +778,15 @@ wheels = [
 
 [[package]]
 name = "langgraph-cli"
-version = "0.4.11"
+version = "0.4.12"
 source = { registry = "https://pypi.org/simple" }
 dependencies = [
     { name = "click" },
     { name = "langgraph-sdk" },
 ]
-sdist = { url = "https://files.pythonhosted.org/packages/94/2a/b5d51df0db49bf5dc8860f6f66605ff2f44da664d645b6287ceb24223df4/langgraph_cli-0.4.11.tar.gz", hash = "sha256:c38c531510ace1c2d90f8a15f4bb5b874ca9d07c0564cbda7590730da2b0dff3", size = 837429, upload-time = "2025-12-17T14:13:12.889Z" }
+sdist = { url = "https://files.pythonhosted.org/packages/08/04/0764d07b1c5601cdb73f6949fab80ce867983684d024f3de48cce1d8aba2/langgraph_cli-0.4.12.tar.gz", hash = "sha256:7aa6ca37d6f60c75f2ea310f4cae233f59fe0026e5ef43dab34c04d1cb61c7a6", size = 838313, upload-time = "2026-01-23T13:34:16.211Z" }
 wheels = [
-    { url = "https://files.pythonhosted.org/packages/1c/ac/fd0af9c89638e4d99db8d00b6c6fe1a60f27d9d61b0bbe1d4d5300a74b18/langgraph_cli-0.4.11-py3-none-any.whl", hash = "sha256:807cd6e8c5d4fd7160bd44be67f3b5621cb34ec309658072f75852b639b41ca0", size = 41163, upload-time = "2025-12-17T14:13:12.026Z" },
+    { url = "https://files.pythonhosted.org/packages/29/06/0adb15491518db7b0617bbc3f0894fbc1ffa74b1fc0c051217b1c1a538f5/langgraph_cli-0.4.12-py3-none-any.whl", hash = "sha256:ce85901b307dfa14408c6e4e122a2ccafe3abc53f6bcc99f5080715c1a0a8347", size = 41159, upload-time = "2026-01-23T13:34:14.65Z" },
 ]
 
 [package.optional-dependencies]
@@ -752,7 +811,7 @@ wheels = [
 
 [[package]]
 name = "langgraph-runtime-inmem"
-version = "0.22.0"
+version = "0.23.1"
 source = { registry = "https://pypi.org/simple" }
 dependencies = [
     { name = "blockbuster" },
@@ -762,9 +821,9 @@ dependencies = [
     { name = "starlette" },
     { name = "structlog" },
 ]
-sdist = { url = "https://files.pythonhosted.org/packages/fc/4e/1658cfe871c2cd02013e97663cb64e734b531b3102cebbe50523f9f839ae/langgraph_runtime_inmem-0.22.0.tar.gz", hash = "sha256:8c50ccdfe2654a8524c3729d24f83705360c03b7d6a1c362584e0546abaeb32b", size = 103368, upload-time = "2026-01-08T02:03:28.315Z" }
+sdist = { url = "https://files.pythonhosted.org/packages/d0/25/f8ce026c9f56678ba3a0ee07456b60643be9ea46860b1b0268fe064bb1a8/langgraph_runtime_inmem-0.23.1.tar.gz", hash = "sha256:f7854bb2742dd797ae8d19a51d3b72d6218b51cb961af4fe9b437bb50710890b", size = 104659, upload-time = "2026-01-22T18:47:47.004Z" }
 wheels = [
-    { url = "https://files.pythonhosted.org/packages/fb/f9/09de2d2e09e122a93b4145487f1a4cd5923242ed4d3e3edfcea6fd6673cd/langgraph_runtime_inmem-0.22.0-py3-none-any.whl", hash = "sha256:46994bfebadc824e3b20374ed8ae151fa6da40eed3e43dd44c2a66d0185cb8ef", size = 37473, upload-time = "2026-01-08T02:03:27.372Z" },
+    { url = "https://files.pythonhosted.org/packages/8a/1e/db6c2a5189793b49c482449cff38ff60df757e7081c209678df4e4693d57/langgraph_runtime_inmem-0.23.1-py3-none-any.whl", hash = "sha256:79763b741d86643b28d6ea4b9b11f3189a64d1e233127339b458efd2f6f647f7", size = 39017, upload-time = "2026-01-22T18:47:45.567Z" },
 ]
 
 [[package]]
@@ -782,7 +841,7 @@ wheels = [
 
 [[package]]
 name = "langsmith"
-version = "0.6.2"
+version = "0.6.8"
 source = { registry = "https://pypi.org/simple" }
 dependencies = [
     { name = "httpx" },
@@ -792,11 +851,44 @@ dependencies = [
     { name = "requests" },
     { name = "requests-toolbelt" },
     { name = "uuid-utils" },
+    { name = "xxhash" },
     { name = "zstandard" },
 ]
-sdist = { url = "https://files.pythonhosted.org/packages/0c/8e/3ea7a8e9ce8c530204964207af7f7778597f5a548dc1a489c0c0940561f3/langsmith-0.6.2.tar.gz", hash = "sha256:c2efd7ed61eed3b6fdbf158ea2e9862bc2636f2edc95e90d2faad9462773d097", size = 1739277, upload-time = "2026-01-08T23:17:40.504Z" }
+sdist = { url = "https://files.pythonhosted.org/packages/8e/15/35f49a0b2efd33002fdcb9a7b0bdb65d77e40b4739104ffe843a3479874a/langsmith-0.6.8.tar.gz", hash = "sha256:3a7eb7155f2839dc729a5aa5b0bfc4aa1cb617b09a2290cf77031041271a7cdf", size = 973475, upload-time = "2026-02-02T23:20:02.208Z" }
+wheels = [
+    { url = "https://files.pythonhosted.org/packages/cd/2d/2389e65522ebeab17489df72b4fabcfc661fced8af178aa6c2bc3b9afff5/langsmith-0.6.8-py3-none-any.whl", hash = "sha256:d17da18aeef15fdb4c3baec348bad64056591d785629cd5ba4846fd93cab166b", size = 319165, upload-time = "2026-02-02T23:20:00.456Z" },
+]
+
+[package.optional-dependencies]
+otel = [
+    { name = "opentelemetry-api" },
+    { name = "opentelemetry-exporter-otlp-proto-http" },
+    { name = "opentelemetry-sdk" },
+]
+
+[[package]]
+name = "mcp"
+version = "1.26.0"
+source = { registry = "https://pypi.org/simple" }
+dependencies = [
+    { name = "anyio" },
+    { name = "httpx" },
+    { name = "httpx-sse" },
+    { name = "jsonschema" },
+    { name = "pydantic" },
+    { name = "pydantic-settings" },
+    { name = "pyjwt", extra = ["crypto"] },
+    { name = "python-multipart" },
+    { name = "pywin32", marker = "sys_platform == 'win32'" },
+    { name = "sse-starlette" },
+    { name = "starlette" },
+    { name = "typing-extensions" },
+    { name = "typing-inspection" },
+    { name = "uvicorn", marker = "sys_platform != 'emscripten'" },
+]
+sdist = { url = "https://files.pythonhosted.org/packages/fc/6d/62e76bbb8144d6ed86e202b5edd8a4cb631e7c8130f3f4893c3f90262b10/mcp-1.26.0.tar.gz", hash = "sha256:db6e2ef491eecc1a0d93711a76f28dec2e05999f93afd48795da1c1137142c66", size = 608005, upload-time = "2026-01-24T19:40:32.468Z" }
 wheels = [
-    { url = "https://files.pythonhosted.org/packages/ed/e0/9d173dd2fa7f85d9ec4989f6f5a1a057d281daa8dada0ff8db0de0cb68aa/langsmith-0.6.2-py3-none-any.whl", hash = "sha256:1ea1a591f52683a5aeebdaa2b58458d72ce9598105dd8b29e16f7373631a6434", size = 282918, upload-time = "2026-01-08T23:17:38.858Z" },
+    { url = "https://files.pythonhosted.org/packages/fd/d9/eaa1f80170d2b7c5ba23f3b59f766f3a0bb41155fbc32a69adfa1adaaef9/mcp-1.26.0-py3-none-any.whl", hash = "sha256:904a21c33c25aa98ddbeb47273033c435e595bbacfdb177f4bd87f6dceebe1ca", size = 233615, upload-time = "2026-01-24T19:40:30.652Z" },
 ]
 
 [[package]]
@@ -1119,6 +1211,20 @@ wheels = [
     { url = "https://files.pythonhosted.org/packages/f7/07/34573da085946b6a313d7c42f82f16e8920bfd730665de2d11c0c37a74b5/pydantic_core-2.41.5-graalpy312-graalpy250_312_native-manylinux_2_17_x86_64.manylinux2014_x86_64.whl", hash = "sha256:76d0819de158cd855d1cbb8fcafdf6f5cf1eb8e470abe056d5d161106e38062b", size = 2139017, upload-time = "2025-11-04T13:42:59.471Z" },
 ]
 
+[[package]]
+name = "pydantic-settings"
+version = "2.12.0"
+source = { registry = "https://pypi.org/simple" }
+dependencies = [
+    { name = "pydantic" },
+    { name = "python-dotenv" },
+    { name = "typing-inspection" },
+]
+sdist = { url = "https://files.pythonhosted.org/packages/43/4b/ac7e0aae12027748076d72a8764ff1c9d82ca75a7a52622e67ed3f765c54/pydantic_settings-2.12.0.tar.gz", hash = "sha256:005538ef951e3c2a68e1c08b292b5f2e71490def8589d4221b95dab00dafcfd0", size = 194184, upload-time = "2025-11-10T14:25:47.013Z" }
+wheels = [
+    { url = "https://files.pythonhosted.org/packages/c1/60/5d4751ba3f4a40a6891f24eec885f51afd78d208498268c734e256fb13c4/pydantic_settings-2.12.0-py3-none-any.whl", hash = "sha256:fddb9fd99a5b18da837b29710391e945b1e30c135477f484084ee513adb93809", size = 51880, upload-time = "2025-11-10T14:25:45.546Z" },
+]
+
 [[package]]
 name = "pyjwt"
 version = "2.10.1"
@@ -1128,6 +1234,11 @@ wheels = [
     { url = "https://files.pythonhosted.org/packages/61/ad/689f02752eeec26aed679477e80e632ef1b682313be70793d798c1d5fc8f/PyJWT-2.10.1-py3-none-any.whl", hash = "sha256:dcdd193e30abefd5debf142f9adfcdd2b58004e644f25406ffaebd50bd98dacb", size = 22997, upload-time = "2024-11-28T03:43:27.893Z" },
 ]
 
+[package.optional-dependencies]
+crypto = [
+    { name = "cryptography" },
+]
+
 [[package]]
 name = "python-dotenv"
 version = "1.2.1"
@@ -1137,6 +1248,31 @@ wheels = [
     { url = "https://files.pythonhosted.org/packages/14/1b/a298b06749107c305e1fe0f814c6c74aea7b2f1e10989cb30f544a1b3253/python_dotenv-1.2.1-py3-none-any.whl", hash = "sha256:b81ee9561e9ca4004139c6cbba3a238c32b03e4894671e181b671e8cb8425d61", size = 21230, upload-time = "2025-10-26T15:12:09.109Z" },
 ]
 
+[[package]]
+name = "python-multipart"
+version = "0.0.22"
+source = { registry = "https://pypi.org/simple" }
+sdist = { url = "https://files.pythonhosted.org/packages/94/01/979e98d542a70714b0cb2b6728ed0b7c46792b695e3eaec3e20711271ca3/python_multipart-0.0.22.tar.gz", hash = "sha256:7340bef99a7e0032613f56dc36027b959fd3b30a787ed62d310e951f7c3a3a58", size = 37612, upload-time = "2026-01-25T10:15:56.219Z" }
+wheels = [
+    { url = "https://files.pythonhosted.org/packages/1b/d0/397f9626e711ff749a95d96b7af99b9c566a9bb5129b8e4c10fc4d100304/python_multipart-0.0.22-py3-none-any.whl", hash = "sha256:2b2cd894c83d21bf49d702499531c7bafd057d730c201782048f7945d82de155", size = 24579, upload-time = "2026-01-25T10:15:54.811Z" },
+]
+
+[[package]]
+name = "pywin32"
+version = "311"
+source = { registry = "https://pypi.org/simple" }
+wheels = [
+    { url = "https://files.pythonhosted.org/packages/e7/ab/01ea1943d4eba0f850c3c61e78e8dd59757ff815ff3ccd0a84de5f541f42/pywin32-311-cp312-cp312-win32.whl", hash = "sha256:750ec6e621af2b948540032557b10a2d43b0cee2ae9758c54154d711cc852d31", size = 8706543, upload-time = "2025-07-14T20:13:20.765Z" },
+    { url = "https://files.pythonhosted.org/packages/d1/a8/a0e8d07d4d051ec7502cd58b291ec98dcc0c3fff027caad0470b72cfcc2f/pywin32-311-cp312-cp312-win_amd64.whl", hash = "sha256:b8c095edad5c211ff31c05223658e71bf7116daa0ecf3ad85f3201ea3190d067", size = 9495040, upload-time = "2025-07-14T20:13:22.543Z" },
+    { url = "https://files.pythonhosted.org/packages/ba/3a/2ae996277b4b50f17d61f0603efd8253cb2d79cc7ae159468007b586396d/pywin32-311-cp312-cp312-win_arm64.whl", hash = "sha256:e286f46a9a39c4a18b319c28f59b61de793654af2f395c102b4f819e584b5852", size = 8710102, upload-time = "2025-07-14T20:13:24.682Z" },
+    { url = "https://files.pythonhosted.org/packages/a5/be/3fd5de0979fcb3994bfee0d65ed8ca9506a8a1260651b86174f6a86f52b3/pywin32-311-cp313-cp313-win32.whl", hash = "sha256:f95ba5a847cba10dd8c4d8fefa9f2a6cf283b8b88ed6178fa8a6c1ab16054d0d", size = 8705700, upload-time = "2025-07-14T20:13:26.471Z" },
+    { url = "https://files.pythonhosted.org/packages/e3/28/e0a1909523c6890208295a29e05c2adb2126364e289826c0a8bc7297bd5c/pywin32-311-cp313-cp313-win_amd64.whl", hash = "sha256:718a38f7e5b058e76aee1c56ddd06908116d35147e133427e59a3983f703a20d", size = 9494700, upload-time = "2025-07-14T20:13:28.243Z" },
+    { url = "https://files.pythonhosted.org/packages/04/bf/90339ac0f55726dce7d794e6d79a18a91265bdf3aa70b6b9ca52f35e022a/pywin32-311-cp313-cp313-win_arm64.whl", hash = "sha256:7b4075d959648406202d92a2310cb990fea19b535c7f4a78d3f5e10b926eeb8a", size = 8709318, upload-time = "2025-07-14T20:13:30.348Z" },
+    { url = "https://files.pythonhosted.org/packages/c9/31/097f2e132c4f16d99a22bfb777e0fd88bd8e1c634304e102f313af69ace5/pywin32-311-cp314-cp314-win32.whl", hash = "sha256:b7a2c10b93f8986666d0c803ee19b5990885872a7de910fc460f9b0c2fbf92ee", size = 8840714, upload-time = "2025-07-14T20:13:32.449Z" },
+    { url = "https://files.pythonhosted.org/packages/90/4b/07c77d8ba0e01349358082713400435347df8426208171ce297da32c313d/pywin32-311-cp314-cp314-win_amd64.whl", hash = "sha256:3aca44c046bd2ed8c90de9cb8427f581c479e594e99b5c0bb19b29c10fd6cb87", size = 9656800, upload-time = "2025-07-14T20:13:34.312Z" },
+    { url = "https://files.pythonhosted.org/packages/c0/d2/21af5c535501a7233e734b8af901574572da66fcc254cb35d0609c9080dd/pywin32-311-cp314-cp314-win_arm64.whl", hash = "sha256:a508e2d9025764a8270f93111a970e1d0fbfc33f4153b388bb649b7eec4f9b42", size = 8932540, upload-time = "2025-07-14T20:13:36.379Z" },
+]
+
 [[package]]
 name = "pyyaml"
 version = "6.0.3"
@@ -1183,6 +1319,20 @@ wheels = [
     { url = "https://files.pythonhosted.org/packages/f1/12/de94a39c2ef588c7e6455cfbe7343d3b2dc9d6b6b2f40c4c6565744c873d/pyyaml-6.0.3-cp314-cp314t-win_arm64.whl", hash = "sha256:ebc55a14a21cb14062aa4162f906cd962b28e2e9ea38f9b4391244cd8de4ae0b", size = 149341, upload-time = "2025-09-25T21:32:56.828Z" },
 ]
 
+[[package]]
+name = "referencing"
+version = "0.37.0"
+source = { registry = "https://pypi.org/simple" }
+dependencies = [
+    { name = "attrs" },
+    { name = "rpds-py" },
+    { name = "typing-extensions", marker = "python_full_version < '3.13'" },
+]
+sdist = { url = "https://files.pythonhosted.org/packages/22/f5/df4e9027acead3ecc63e50fe1e36aca1523e1719559c499951bb4b53188f/referencing-0.37.0.tar.gz", hash = "sha256:44aefc3142c5b842538163acb373e24cce6632bd54bdb01b21ad5863489f50d8", size = 78036, upload-time = "2025-10-13T15:30:48.871Z" }
+wheels = [
+    { url = "https://files.pythonhosted.org/packages/2c/58/ca301544e1fa93ed4f80d724bf5b194f6e4b945841c5bfd555878eea9fcb/referencing-0.37.0-py3-none-any.whl", hash = "sha256:381329a9f99628c9069361716891d34ad94af76e461dcb0335825aecc7692231", size = 26766, upload-time = "2025-10-13T15:30:47.625Z" },
+]
+
 [[package]]
 name = "regex"
 version = "2025.11.3"
@@ -1288,6 +1438,87 @@ wheels = [
     { url = "https://files.pythonhosted.org/packages/3f/51/d4db610ef29373b879047326cbf6fa98b6c1969d6f6dc423279de2b1be2c/requests_toolbelt-1.0.0-py2.py3-none-any.whl", hash = "sha256:cccfdd665f0a24fcf4726e690f65639d272bb0637b9b92dfd91a5568ccf6bd06", size = 54481, upload-time = "2023-05-01T04:11:28.427Z" },
 ]
 
+[[package]]
+name = "rpds-py"
+version = "0.30.0"
+source = { registry = "https://pypi.org/simple" }
+sdist = { url = "https://files.pythonhosted.org/packages/20/af/3f2f423103f1113b36230496629986e0ef7e199d2aa8392452b484b38ced/rpds_py-0.30.0.tar.gz", hash = "sha256:dd8ff7cf90014af0c0f787eea34794ebf6415242ee1d6fa91eaba725cc441e84", size = 69469, upload-time = "2025-11-30T20:24:38.837Z" }
+wheels = [
+    { url = "https://files.pythonhosted.org/packages/03/e7/98a2f4ac921d82f33e03f3835f5bf3a4a40aa1bfdc57975e74a97b2b4bdd/rpds_py-0.30.0-cp312-cp312-macosx_10_12_x86_64.whl", hash = "sha256:a161f20d9a43006833cd7068375a94d035714d73a172b681d8881820600abfad", size = 375086, upload-time = "2025-11-30T20:22:17.93Z" },
+    { url = "https://files.pythonhosted.org/packages/4d/a1/bca7fd3d452b272e13335db8d6b0b3ecde0f90ad6f16f3328c6fb150c889/rpds_py-0.30.0-cp312-cp312-macosx_11_0_arm64.whl", hash = "sha256:6abc8880d9d036ecaafe709079969f56e876fcf107f7a8e9920ba6d5a3878d05", size = 359053, upload-time = "2025-11-30T20:22:19.297Z" },
+    { url = "https://files.pythonhosted.org/packages/65/1c/ae157e83a6357eceff62ba7e52113e3ec4834a84cfe07fa4b0757a7d105f/rpds_py-0.30.0-cp312-cp312-manylinux_2_17_aarch64.manylinux2014_aarch64.whl", hash = "sha256:ca28829ae5f5d569bb62a79512c842a03a12576375d5ece7d2cadf8abe96ec28", size = 390763, upload-time = "2025-11-30T20:22:21.661Z" },
+    { url = "https://files.pythonhosted.org/packages/d4/36/eb2eb8515e2ad24c0bd43c3ee9cd74c33f7ca6430755ccdb240fd3144c44/rpds_py-0.30.0-cp312-cp312-manylinux_2_17_armv7l.manylinux2014_armv7l.whl", hash = "sha256:a1010ed9524c73b94d15919ca4d41d8780980e1765babf85f9a2f90d247153dd", size = 408951, upload-time = "2025-11-30T20:22:23.408Z" },
+    { url = "https://files.pythonhosted.org/packages/d6/65/ad8dc1784a331fabbd740ef6f71ce2198c7ed0890dab595adb9ea2d775a1/rpds_py-0.30.0-cp312-cp312-manylinux_2_17_ppc64le.manylinux2014_ppc64le.whl", hash = "sha256:f8d1736cfb49381ba528cd5baa46f82fdc65c06e843dab24dd70b63d09121b3f", size = 514622, upload-time = "2025-11-30T20:22:25.16Z" },
+    { url = "https://files.pythonhosted.org/packages/63/8e/0cfa7ae158e15e143fe03993b5bcd743a59f541f5952e1546b1ac1b5fd45/rpds_py-0.30.0-cp312-cp312-manylinux_2_17_s390x.manylinux2014_s390x.whl", hash = "sha256:d948b135c4693daff7bc2dcfc4ec57237a29bd37e60c2fabf5aff2bbacf3e2f1", size = 414492, upload-time = "2025-11-30T20:22:26.505Z" },
+    { url = "https://files.pythonhosted.org/packages/60/1b/6f8f29f3f995c7ffdde46a626ddccd7c63aefc0efae881dc13b6e5d5bb16/rpds_py-0.30.0-cp312-cp312-manylinux_2_17_x86_64.manylinux2014_x86_64.whl", hash = "sha256:47f236970bccb2233267d89173d3ad2703cd36a0e2a6e92d0560d333871a3d23", size = 394080, upload-time = "2025-11-30T20:22:27.934Z" },
+    { url = "https://files.pythonhosted.org/packages/6d/d5/a266341051a7a3ca2f4b750a3aa4abc986378431fc2da508c5034d081b70/rpds_py-0.30.0-cp312-cp312-manylinux_2_31_riscv64.whl", hash = "sha256:2e6ecb5a5bcacf59c3f912155044479af1d0b6681280048b338b28e364aca1f6", size = 408680, upload-time = "2025-11-30T20:22:29.341Z" },
+    { url = "https://files.pythonhosted.org/packages/10/3b/71b725851df9ab7a7a4e33cf36d241933da66040d195a84781f49c50490c/rpds_py-0.30.0-cp312-cp312-manylinux_2_5_i686.manylinux1_i686.whl", hash = "sha256:a8fa71a2e078c527c3e9dc9fc5a98c9db40bcc8a92b4e8858e36d329f8684b51", size = 423589, upload-time = "2025-11-30T20:22:31.469Z" },
+    { url = "https://files.pythonhosted.org/packages/00/2b/e59e58c544dc9bd8bd8384ecdb8ea91f6727f0e37a7131baeff8d6f51661/rpds_py-0.30.0-cp312-cp312-musllinux_1_2_aarch64.whl", hash = "sha256:73c67f2db7bc334e518d097c6d1e6fed021bbc9b7d678d6cc433478365d1d5f5", size = 573289, upload-time = "2025-11-30T20:22:32.997Z" },
+    { url = "https://files.pythonhosted.org/packages/da/3e/a18e6f5b460893172a7d6a680e86d3b6bc87a54c1f0b03446a3c8c7b588f/rpds_py-0.30.0-cp312-cp312-musllinux_1_2_i686.whl", hash = "sha256:5ba103fb455be00f3b1c2076c9d4264bfcb037c976167a6047ed82f23153f02e", size = 599737, upload-time = "2025-11-30T20:22:34.419Z" },
+    { url = "https://files.pythonhosted.org/packages/5c/e2/714694e4b87b85a18e2c243614974413c60aa107fd815b8cbc42b873d1d7/rpds_py-0.30.0-cp312-cp312-musllinux_1_2_x86_64.whl", hash = "sha256:7cee9c752c0364588353e627da8a7e808a66873672bcb5f52890c33fd965b394", size = 563120, upload-time = "2025-11-30T20:22:35.903Z" },
+    { url = "https://files.pythonhosted.org/packages/6f/ab/d5d5e3bcedb0a77f4f613706b750e50a5a3ba1c15ccd3665ecc636c968fd/rpds_py-0.30.0-cp312-cp312-win32.whl", hash = "sha256:1ab5b83dbcf55acc8b08fc62b796ef672c457b17dbd7820a11d6c52c06839bdf", size = 223782, upload-time = "2025-11-30T20:22:37.271Z" },
+    { url = "https://files.pythonhosted.org/packages/39/3b/f786af9957306fdc38a74cef405b7b93180f481fb48453a114bb6465744a/rpds_py-0.30.0-cp312-cp312-win_amd64.whl", hash = "sha256:a090322ca841abd453d43456ac34db46e8b05fd9b3b4ac0c78bcde8b089f959b", size = 240463, upload-time = "2025-11-30T20:22:39.021Z" },
+    { url = "https://files.pythonhosted.org/packages/f3/d2/b91dc748126c1559042cfe41990deb92c4ee3e2b415f6b5234969ffaf0cc/rpds_py-0.30.0-cp312-cp312-win_arm64.whl", hash = "sha256:669b1805bd639dd2989b281be2cfd951c6121b65e729d9b843e9639ef1fd555e", size = 230868, upload-time = "2025-11-30T20:22:40.493Z" },
+    { url = "https://files.pythonhosted.org/packages/ed/dc/d61221eb88ff410de3c49143407f6f3147acf2538c86f2ab7ce65ae7d5f9/rpds_py-0.30.0-cp313-cp313-macosx_10_12_x86_64.whl", hash = "sha256:f83424d738204d9770830d35290ff3273fbb02b41f919870479fab14b9d303b2", size = 374887, upload-time = "2025-11-30T20:22:41.812Z" },
+    { url = "https://files.pythonhosted.org/packages/fd/32/55fb50ae104061dbc564ef15cc43c013dc4a9f4527a1f4d99baddf56fe5f/rpds_py-0.30.0-cp313-cp313-macosx_11_0_arm64.whl", hash = "sha256:e7536cd91353c5273434b4e003cbda89034d67e7710eab8761fd918ec6c69cf8", size = 358904, upload-time = "2025-11-30T20:22:43.479Z" },
+    { url = "https://files.pythonhosted.org/packages/58/70/faed8186300e3b9bdd138d0273109784eea2396c68458ed580f885dfe7ad/rpds_py-0.30.0-cp313-cp313-manylinux_2_17_aarch64.manylinux2014_aarch64.whl", hash = "sha256:2771c6c15973347f50fece41fc447c054b7ac2ae0502388ce3b6738cd366e3d4", size = 389945, upload-time = "2025-11-30T20:22:44.819Z" },
+    { url = "https://files.pythonhosted.org/packages/bd/a8/073cac3ed2c6387df38f71296d002ab43496a96b92c823e76f46b8af0543/rpds_py-0.30.0-cp313-cp313-manylinux_2_17_armv7l.manylinux2014_armv7l.whl", hash = "sha256:0a59119fc6e3f460315fe9d08149f8102aa322299deaa5cab5b40092345c2136", size = 407783, upload-time = "2025-11-30T20:22:46.103Z" },
+    { url = "https://files.pythonhosted.org/packages/77/57/5999eb8c58671f1c11eba084115e77a8899d6e694d2a18f69f0ba471ec8b/rpds_py-0.30.0-cp313-cp313-manylinux_2_17_ppc64le.manylinux2014_ppc64le.whl", hash = "sha256:76fec018282b4ead0364022e3c54b60bf368b9d926877957a8624b58419169b7", size = 515021, upload-time = "2025-11-30T20:22:47.458Z" },
+    { url = "https://files.pythonhosted.org/packages/e0/af/5ab4833eadc36c0a8ed2bc5c0de0493c04f6c06de223170bd0798ff98ced/rpds_py-0.30.0-cp313-cp313-manylinux_2_17_s390x.manylinux2014_s390x.whl", hash = "sha256:692bef75a5525db97318e8cd061542b5a79812d711ea03dbc1f6f8dbb0c5f0d2", size = 414589, upload-time = "2025-11-30T20:22:48.872Z" },
+    { url = "https://files.pythonhosted.org/packages/b7/de/f7192e12b21b9e9a68a6d0f249b4af3fdcdff8418be0767a627564afa1f1/rpds_py-0.30.0-cp313-cp313-manylinux_2_17_x86_64.manylinux2014_x86_64.whl", hash = "sha256:9027da1ce107104c50c81383cae773ef5c24d296dd11c99e2629dbd7967a20c6", size = 394025, upload-time = "2025-11-30T20:22:50.196Z" },
+    { url = "https://files.pythonhosted.org/packages/91/c4/fc70cd0249496493500e7cc2de87504f5aa6509de1e88623431fec76d4b6/rpds_py-0.30.0-cp313-cp313-manylinux_2_31_riscv64.whl", hash = "sha256:9cf69cdda1f5968a30a359aba2f7f9aa648a9ce4b580d6826437f2b291cfc86e", size = 408895, upload-time = "2025-11-30T20:22:51.87Z" },
+    { url = "https://files.pythonhosted.org/packages/58/95/d9275b05ab96556fefff73a385813eb66032e4c99f411d0795372d9abcea/rpds_py-0.30.0-cp313-cp313-manylinux_2_5_i686.manylinux1_i686.whl", hash = "sha256:a4796a717bf12b9da9d3ad002519a86063dcac8988b030e405704ef7d74d2d9d", size = 422799, upload-time = "2025-11-30T20:22:53.341Z" },
+    { url = "https://files.pythonhosted.org/packages/06/c1/3088fc04b6624eb12a57eb814f0d4997a44b0d208d6cace713033ff1a6ba/rpds_py-0.30.0-cp313-cp313-musllinux_1_2_aarch64.whl", hash = "sha256:5d4c2aa7c50ad4728a094ebd5eb46c452e9cb7edbfdb18f9e1221f597a73e1e7", size = 572731, upload-time = "2025-11-30T20:22:54.778Z" },
+    { url = "https://files.pythonhosted.org/packages/d8/42/c612a833183b39774e8ac8fecae81263a68b9583ee343db33ab571a7ce55/rpds_py-0.30.0-cp313-cp313-musllinux_1_2_i686.whl", hash = "sha256:ba81a9203d07805435eb06f536d95a266c21e5b2dfbf6517748ca40c98d19e31", size = 599027, upload-time = "2025-11-30T20:22:56.212Z" },
+    { url = "https://files.pythonhosted.org/packages/5f/60/525a50f45b01d70005403ae0e25f43c0384369ad24ffe46e8d9068b50086/rpds_py-0.30.0-cp313-cp313-musllinux_1_2_x86_64.whl", hash = "sha256:945dccface01af02675628334f7cf49c2af4c1c904748efc5cf7bbdf0b579f95", size = 563020, upload-time = "2025-11-30T20:22:58.2Z" },
+    { url = "https://files.pythonhosted.org/packages/0b/5d/47c4655e9bcd5ca907148535c10e7d489044243cc9941c16ed7cd53be91d/rpds_py-0.30.0-cp313-cp313-win32.whl", hash = "sha256:b40fb160a2db369a194cb27943582b38f79fc4887291417685f3ad693c5a1d5d", size = 223139, upload-time = "2025-11-30T20:23:00.209Z" },
+    { url = "https://files.pythonhosted.org/packages/f2/e1/485132437d20aa4d3e1d8b3fb5a5e65aa8139f1e097080c2a8443201742c/rpds_py-0.30.0-cp313-cp313-win_amd64.whl", hash = "sha256:806f36b1b605e2d6a72716f321f20036b9489d29c51c91f4dd29a3e3afb73b15", size = 240224, upload-time = "2025-11-30T20:23:02.008Z" },
+    { url = "https://files.pythonhosted.org/packages/24/95/ffd128ed1146a153d928617b0ef673960130be0009c77d8fbf0abe306713/rpds_py-0.30.0-cp313-cp313-win_arm64.whl", hash = "sha256:d96c2086587c7c30d44f31f42eae4eac89b60dabbac18c7669be3700f13c3ce1", size = 230645, upload-time = "2025-11-30T20:23:03.43Z" },
+    { url = "https://files.pythonhosted.org/packages/ff/1b/b10de890a0def2a319a2626334a7f0ae388215eb60914dbac8a3bae54435/rpds_py-0.30.0-cp313-cp313t-macosx_10_12_x86_64.whl", hash = "sha256:eb0b93f2e5c2189ee831ee43f156ed34e2a89a78a66b98cadad955972548be5a", size = 364443, upload-time = "2025-11-30T20:23:04.878Z" },
+    { url = "https://files.pythonhosted.org/packages/0d/bf/27e39f5971dc4f305a4fb9c672ca06f290f7c4e261c568f3dea16a410d47/rpds_py-0.30.0-cp313-cp313t-macosx_11_0_arm64.whl", hash = "sha256:922e10f31f303c7c920da8981051ff6d8c1a56207dbdf330d9047f6d30b70e5e", size = 353375, upload-time = "2025-11-30T20:23:06.342Z" },
+    { url = "https://files.pythonhosted.org/packages/40/58/442ada3bba6e8e6615fc00483135c14a7538d2ffac30e2d933ccf6852232/rpds_py-0.30.0-cp313-cp313t-manylinux_2_17_aarch64.manylinux2014_aarch64.whl", hash = "sha256:cdc62c8286ba9bf7f47befdcea13ea0e26bf294bda99758fd90535cbaf408000", size = 383850, upload-time = "2025-11-30T20:23:07.825Z" },
+    { url = "https://files.pythonhosted.org/packages/14/14/f59b0127409a33c6ef6f5c1ebd5ad8e32d7861c9c7adfa9a624fc3889f6c/rpds_py-0.30.0-cp313-cp313t-manylinux_2_17_armv7l.manylinux2014_armv7l.whl", hash = "sha256:47f9a91efc418b54fb8190a6b4aa7813a23fb79c51f4bb84e418f5476c38b8db", size = 392812, upload-time = "2025-11-30T20:23:09.228Z" },
+    { url = "https://files.pythonhosted.org/packages/b3/66/e0be3e162ac299b3a22527e8913767d869e6cc75c46bd844aa43fb81ab62/rpds_py-0.30.0-cp313-cp313t-manylinux_2_17_ppc64le.manylinux2014_ppc64le.whl", hash = "sha256:1f3587eb9b17f3789ad50824084fa6f81921bbf9a795826570bda82cb3ed91f2", size = 517841, upload-time = "2025-11-30T20:23:11.186Z" },
+    { url = "https://files.pythonhosted.org/packages/3d/55/fa3b9cf31d0c963ecf1ba777f7cf4b2a2c976795ac430d24a1f43d25a6ba/rpds_py-0.30.0-cp313-cp313t-manylinux_2_17_s390x.manylinux2014_s390x.whl", hash = "sha256:39c02563fc592411c2c61d26b6c5fe1e51eaa44a75aa2c8735ca88b0d9599daa", size = 408149, upload-time = "2025-11-30T20:23:12.864Z" },
+    { url = "https://files.pythonhosted.org/packages/60/ca/780cf3b1a32b18c0f05c441958d3758f02544f1d613abf9488cd78876378/rpds_py-0.30.0-cp313-cp313t-manylinux_2_17_x86_64.manylinux2014_x86_64.whl", hash = "sha256:51a1234d8febafdfd33a42d97da7a43f5dcb120c1060e352a3fbc0c6d36e2083", size = 383843, upload-time = "2025-11-30T20:23:14.638Z" },
+    { url = "https://files.pythonhosted.org/packages/82/86/d5f2e04f2aa6247c613da0c1dd87fcd08fa17107e858193566048a1e2f0a/rpds_py-0.30.0-cp313-cp313t-manylinux_2_31_riscv64.whl", hash = "sha256:eb2c4071ab598733724c08221091e8d80e89064cd472819285a9ab0f24bcedb9", size = 396507, upload-time = "2025-11-30T20:23:16.105Z" },
+    { url = "https://files.pythonhosted.org/packages/4b/9a/453255d2f769fe44e07ea9785c8347edaf867f7026872e76c1ad9f7bed92/rpds_py-0.30.0-cp313-cp313t-manylinux_2_5_i686.manylinux1_i686.whl", hash = "sha256:6bdfdb946967d816e6adf9a3d8201bfad269c67efe6cefd7093ef959683c8de0", size = 414949, upload-time = "2025-11-30T20:23:17.539Z" },
+    { url = "https://files.pythonhosted.org/packages/a3/31/622a86cdc0c45d6df0e9ccb6becdba5074735e7033c20e401a6d9d0e2ca0/rpds_py-0.30.0-cp313-cp313t-musllinux_1_2_aarch64.whl", hash = "sha256:c77afbd5f5250bf27bf516c7c4a016813eb2d3e116139aed0096940c5982da94", size = 565790, upload-time = "2025-11-30T20:23:19.029Z" },
+    { url = "https://files.pythonhosted.org/packages/1c/5d/15bbf0fb4a3f58a3b1c67855ec1efcc4ceaef4e86644665fff03e1b66d8d/rpds_py-0.30.0-cp313-cp313t-musllinux_1_2_i686.whl", hash = "sha256:61046904275472a76c8c90c9ccee9013d70a6d0f73eecefd38c1ae7c39045a08", size = 590217, upload-time = "2025-11-30T20:23:20.885Z" },
+    { url = "https://files.pythonhosted.org/packages/6d/61/21b8c41f68e60c8cc3b2e25644f0e3681926020f11d06ab0b78e3c6bbff1/rpds_py-0.30.0-cp313-cp313t-musllinux_1_2_x86_64.whl", hash = "sha256:4c5f36a861bc4b7da6516dbdf302c55313afa09b81931e8280361a4f6c9a2d27", size = 555806, upload-time = "2025-11-30T20:23:22.488Z" },
+    { url = "https://files.pythonhosted.org/packages/f9/39/7e067bb06c31de48de3eb200f9fc7c58982a4d3db44b07e73963e10d3be9/rpds_py-0.30.0-cp313-cp313t-win32.whl", hash = "sha256:3d4a69de7a3e50ffc214ae16d79d8fbb0922972da0356dcf4d0fdca2878559c6", size = 211341, upload-time = "2025-11-30T20:23:24.449Z" },
+    { url = "https://files.pythonhosted.org/packages/0a/4d/222ef0b46443cf4cf46764d9c630f3fe4abaa7245be9417e56e9f52b8f65/rpds_py-0.30.0-cp313-cp313t-win_amd64.whl", hash = "sha256:f14fc5df50a716f7ece6a80b6c78bb35ea2ca47c499e422aa4463455dd96d56d", size = 225768, upload-time = "2025-11-30T20:23:25.908Z" },
+    { url = "https://files.pythonhosted.org/packages/86/81/dad16382ebbd3d0e0328776d8fd7ca94220e4fa0798d1dc5e7da48cb3201/rpds_py-0.30.0-cp314-cp314-macosx_10_12_x86_64.whl", hash = "sha256:68f19c879420aa08f61203801423f6cd5ac5f0ac4ac82a2368a9fcd6a9a075e0", size = 362099, upload-time = "2025-11-30T20:23:27.316Z" },
+    { url = "https://files.pythonhosted.org/packages/2b/60/19f7884db5d5603edf3c6bce35408f45ad3e97e10007df0e17dd57af18f8/rpds_py-0.30.0-cp314-cp314-macosx_11_0_arm64.whl", hash = "sha256:ec7c4490c672c1a0389d319b3a9cfcd098dcdc4783991553c332a15acf7249be", size = 353192, upload-time = "2025-11-30T20:23:29.151Z" },
+    { url = "https://files.pythonhosted.org/packages/bf/c4/76eb0e1e72d1a9c4703c69607cec123c29028bff28ce41588792417098ac/rpds_py-0.30.0-cp314-cp314-manylinux_2_17_aarch64.manylinux2014_aarch64.whl", hash = "sha256:f251c812357a3fed308d684a5079ddfb9d933860fc6de89f2b7ab00da481e65f", size = 384080, upload-time = "2025-11-30T20:23:30.785Z" },
+    { url = "https://files.pythonhosted.org/packages/72/87/87ea665e92f3298d1b26d78814721dc39ed8d2c74b86e83348d6b48a6f31/rpds_py-0.30.0-cp314-cp314-manylinux_2_17_armv7l.manylinux2014_armv7l.whl", hash = "sha256:ac98b175585ecf4c0348fd7b29c3864bda53b805c773cbf7bfdaffc8070c976f", size = 394841, upload-time = "2025-11-30T20:23:32.209Z" },
+    { url = "https://files.pythonhosted.org/packages/77/ad/7783a89ca0587c15dcbf139b4a8364a872a25f861bdb88ed99f9b0dec985/rpds_py-0.30.0-cp314-cp314-manylinux_2_17_ppc64le.manylinux2014_ppc64le.whl", hash = "sha256:3e62880792319dbeb7eb866547f2e35973289e7d5696c6e295476448f5b63c87", size = 516670, upload-time = "2025-11-30T20:23:33.742Z" },
+    { url = "https://files.pythonhosted.org/packages/5b/3c/2882bdac942bd2172f3da574eab16f309ae10a3925644e969536553cb4ee/rpds_py-0.30.0-cp314-cp314-manylinux_2_17_s390x.manylinux2014_s390x.whl", hash = "sha256:4e7fc54e0900ab35d041b0601431b0a0eb495f0851a0639b6ef90f7741b39a18", size = 408005, upload-time = "2025-11-30T20:23:35.253Z" },
+    { url = "https://files.pythonhosted.org/packages/ce/81/9a91c0111ce1758c92516a3e44776920b579d9a7c09b2b06b642d4de3f0f/rpds_py-0.30.0-cp314-cp314-manylinux_2_17_x86_64.manylinux2014_x86_64.whl", hash = "sha256:47e77dc9822d3ad616c3d5759ea5631a75e5809d5a28707744ef79d7a1bcfcad", size = 382112, upload-time = "2025-11-30T20:23:36.842Z" },
+    { url = "https://files.pythonhosted.org/packages/cf/8e/1da49d4a107027e5fbc64daeab96a0706361a2918da10cb41769244b805d/rpds_py-0.30.0-cp314-cp314-manylinux_2_31_riscv64.whl", hash = "sha256:b4dc1a6ff022ff85ecafef7979a2c6eb423430e05f1165d6688234e62ba99a07", size = 399049, upload-time = "2025-11-30T20:23:38.343Z" },
+    { url = "https://files.pythonhosted.org/packages/df/5a/7ee239b1aa48a127570ec03becbb29c9d5a9eb092febbd1699d567cae859/rpds_py-0.30.0-cp314-cp314-manylinux_2_5_i686.manylinux1_i686.whl", hash = "sha256:4559c972db3a360808309e06a74628b95eaccbf961c335c8fe0d590cf587456f", size = 415661, upload-time = "2025-11-30T20:23:40.263Z" },
+    { url = "https://files.pythonhosted.org/packages/70/ea/caa143cf6b772f823bc7929a45da1fa83569ee49b11d18d0ada7f5ee6fd6/rpds_py-0.30.0-cp314-cp314-musllinux_1_2_aarch64.whl", hash = "sha256:0ed177ed9bded28f8deb6ab40c183cd1192aa0de40c12f38be4d59cd33cb5c65", size = 565606, upload-time = "2025-11-30T20:23:42.186Z" },
+    { url = "https://files.pythonhosted.org/packages/64/91/ac20ba2d69303f961ad8cf55bf7dbdb4763f627291ba3d0d7d67333cced9/rpds_py-0.30.0-cp314-cp314-musllinux_1_2_i686.whl", hash = "sha256:ad1fa8db769b76ea911cb4e10f049d80bf518c104f15b3edb2371cc65375c46f", size = 591126, upload-time = "2025-11-30T20:23:44.086Z" },
+    { url = "https://files.pythonhosted.org/packages/21/20/7ff5f3c8b00c8a95f75985128c26ba44503fb35b8e0259d812766ea966c7/rpds_py-0.30.0-cp314-cp314-musllinux_1_2_x86_64.whl", hash = "sha256:46e83c697b1f1c72b50e5ee5adb4353eef7406fb3f2043d64c33f20ad1c2fc53", size = 553371, upload-time = "2025-11-30T20:23:46.004Z" },
+    { url = "https://files.pythonhosted.org/packages/72/c7/81dadd7b27c8ee391c132a6b192111ca58d866577ce2d9b0ca157552cce0/rpds_py-0.30.0-cp314-cp314-win32.whl", hash = "sha256:ee454b2a007d57363c2dfd5b6ca4a5d7e2c518938f8ed3b706e37e5d470801ed", size = 215298, upload-time = "2025-11-30T20:23:47.696Z" },
+    { url = "https://files.pythonhosted.org/packages/3e/d2/1aaac33287e8cfb07aab2e6b8ac1deca62f6f65411344f1433c55e6f3eb8/rpds_py-0.30.0-cp314-cp314-win_amd64.whl", hash = "sha256:95f0802447ac2d10bcc69f6dc28fe95fdf17940367b21d34e34c737870758950", size = 228604, upload-time = "2025-11-30T20:23:49.501Z" },
+    { url = "https://files.pythonhosted.org/packages/e8/95/ab005315818cc519ad074cb7784dae60d939163108bd2b394e60dc7b5461/rpds_py-0.30.0-cp314-cp314-win_arm64.whl", hash = "sha256:613aa4771c99f03346e54c3f038e4cc574ac09a3ddfb0e8878487335e96dead6", size = 222391, upload-time = "2025-11-30T20:23:50.96Z" },
+    { url = "https://files.pythonhosted.org/packages/9e/68/154fe0194d83b973cdedcdcc88947a2752411165930182ae41d983dcefa6/rpds_py-0.30.0-cp314-cp314t-macosx_10_12_x86_64.whl", hash = "sha256:7e6ecfcb62edfd632e56983964e6884851786443739dbfe3582947e87274f7cb", size = 364868, upload-time = "2025-11-30T20:23:52.494Z" },
+    { url = "https://files.pythonhosted.org/packages/83/69/8bbc8b07ec854d92a8b75668c24d2abcb1719ebf890f5604c61c9369a16f/rpds_py-0.30.0-cp314-cp314t-macosx_11_0_arm64.whl", hash = "sha256:a1d0bc22a7cdc173fedebb73ef81e07faef93692b8c1ad3733b67e31e1b6e1b8", size = 353747, upload-time = "2025-11-30T20:23:54.036Z" },
+    { url = "https://files.pythonhosted.org/packages/ab/00/ba2e50183dbd9abcce9497fa5149c62b4ff3e22d338a30d690f9af970561/rpds_py-0.30.0-cp314-cp314t-manylinux_2_17_aarch64.manylinux2014_aarch64.whl", hash = "sha256:0d08f00679177226c4cb8c5265012eea897c8ca3b93f429e546600c971bcbae7", size = 383795, upload-time = "2025-11-30T20:23:55.556Z" },
+    { url = "https://files.pythonhosted.org/packages/05/6f/86f0272b84926bcb0e4c972262f54223e8ecc556b3224d281e6598fc9268/rpds_py-0.30.0-cp314-cp314t-manylinux_2_17_armv7l.manylinux2014_armv7l.whl", hash = "sha256:5965af57d5848192c13534f90f9dd16464f3c37aaf166cc1da1cae1fd5a34898", size = 393330, upload-time = "2025-11-30T20:23:57.033Z" },
+    { url = "https://files.pythonhosted.org/packages/cb/e9/0e02bb2e6dc63d212641da45df2b0bf29699d01715913e0d0f017ee29438/rpds_py-0.30.0-cp314-cp314t-manylinux_2_17_ppc64le.manylinux2014_ppc64le.whl", hash = "sha256:9a4e86e34e9ab6b667c27f3211ca48f73dba7cd3d90f8d5b11be56e5dbc3fb4e", size = 518194, upload-time = "2025-11-30T20:23:58.637Z" },
+    { url = "https://files.pythonhosted.org/packages/ee/ca/be7bca14cf21513bdf9c0606aba17d1f389ea2b6987035eb4f62bd923f25/rpds_py-0.30.0-cp314-cp314t-manylinux_2_17_s390x.manylinux2014_s390x.whl", hash = "sha256:e5d3e6b26f2c785d65cc25ef1e5267ccbe1b069c5c21b8cc724efee290554419", size = 408340, upload-time = "2025-11-30T20:24:00.2Z" },
+    { url = "https://files.pythonhosted.org/packages/c2/c7/736e00ebf39ed81d75544c0da6ef7b0998f8201b369acf842f9a90dc8fce/rpds_py-0.30.0-cp314-cp314t-manylinux_2_17_x86_64.manylinux2014_x86_64.whl", hash = "sha256:626a7433c34566535b6e56a1b39a7b17ba961e97ce3b80ec62e6f1312c025551", size = 383765, upload-time = "2025-11-30T20:24:01.759Z" },
+    { url = "https://files.pythonhosted.org/packages/4a/3f/da50dfde9956aaf365c4adc9533b100008ed31aea635f2b8d7b627e25b49/rpds_py-0.30.0-cp314-cp314t-manylinux_2_31_riscv64.whl", hash = "sha256:acd7eb3f4471577b9b5a41baf02a978e8bdeb08b4b355273994f8b87032000a8", size = 396834, upload-time = "2025-11-30T20:24:03.687Z" },
+    { url = "https://files.pythonhosted.org/packages/4e/00/34bcc2565b6020eab2623349efbdec810676ad571995911f1abdae62a3a0/rpds_py-0.30.0-cp314-cp314t-manylinux_2_5_i686.manylinux1_i686.whl", hash = "sha256:fe5fa731a1fa8a0a56b0977413f8cacac1768dad38d16b3a296712709476fbd5", size = 415470, upload-time = "2025-11-30T20:24:05.232Z" },
+    { url = "https://files.pythonhosted.org/packages/8c/28/882e72b5b3e6f718d5453bd4d0d9cf8df36fddeb4ddbbab17869d5868616/rpds_py-0.30.0-cp314-cp314t-musllinux_1_2_aarch64.whl", hash = "sha256:74a3243a411126362712ee1524dfc90c650a503502f135d54d1b352bd01f2404", size = 565630, upload-time = "2025-11-30T20:24:06.878Z" },
+    { url = "https://files.pythonhosted.org/packages/3b/97/04a65539c17692de5b85c6e293520fd01317fd878ea1995f0367d4532fb1/rpds_py-0.30.0-cp314-cp314t-musllinux_1_2_i686.whl", hash = "sha256:3e8eeb0544f2eb0d2581774be4c3410356eba189529a6b3e36bbbf9696175856", size = 591148, upload-time = "2025-11-30T20:24:08.445Z" },
+    { url = "https://files.pythonhosted.org/packages/85/70/92482ccffb96f5441aab93e26c4d66489eb599efdcf96fad90c14bbfb976/rpds_py-0.30.0-cp314-cp314t-musllinux_1_2_x86_64.whl", hash = "sha256:dbd936cde57abfee19ab3213cf9c26be06d60750e60a8e4dd85d1ab12c8b1f40", size = 556030, upload-time = "2025-11-30T20:24:10.956Z" },
+    { url = "https://files.pythonhosted.org/packages/20/53/7c7e784abfa500a2b6b583b147ee4bb5a2b3747a9166bab52fec4b5b5e7d/rpds_py-0.30.0-cp314-cp314t-win32.whl", hash = "sha256:dc824125c72246d924f7f796b4f63c1e9dc810c7d9e2355864b3c3a73d59ade0", size = 211570, upload-time = "2025-11-30T20:24:12.735Z" },
+    { url = "https://files.pythonhosted.org/packages/d0/02/fa464cdfbe6b26e0600b62c528b72d8608f5cc49f96b8d6e38c95d60c676/rpds_py-0.30.0-cp314-cp314t-win_amd64.whl", hash = "sha256:27f4b0e92de5bfbc6f86e43959e6edd1425c33b5e69aab0984a72047f2bcf1e3", size = 226532, upload-time = "2025-11-30T20:24:14.634Z" },
+]
+
 [[package]]
 name = "sample-agent"
 version = "0.1.0"
@@ -1296,6 +1527,7 @@ dependencies = [
     { name = "copilotkit" },
     { name = "fastapi" },
     { name = "langchain" },
+    { name = "langchain-mcp-adapters" },
     { name = "langchain-openai" },
     { name = "langgraph" },
     { name = "langgraph-api" },
@@ -1308,12 +1540,13 @@ dependencies = [
 
 [package.metadata]
 requires-dist = [
-    { name = "copilotkit", specifier = ">=0.1.74" },
+    { name = "copilotkit", specifier = ">=0.1.77" },
     { name = "fastapi", specifier = ">=0.115.5,<1.0.0" },
     { name = "langchain", specifier = "==1.2.0" },
+    { name = "langchain-mcp-adapters", specifier = ">=0.2.1" },
     { name = "langchain-openai", specifier = ">=1.1.0" },
     { name = "langgraph", specifier = "==1.0.5" },
-    { name = "langgraph-api", specifier = ">=0.6.0" },
+    { name = "langgraph-api", specifier = ">=0.7.16" },
     { name = "langgraph-cli", extras = ["inmem"], specifier = ">=0.4.11" },
     { name = "langsmith", specifier = ">=0.4.49" },
     { name = "openai", specifier = ">=1.68.2,<2.0.0" },
diff --git a/eslint.config.mjs b/apps/app/eslint.config.mjs
similarity index 100%
rename from eslint.config.mjs
rename to apps/app/eslint.config.mjs
diff --git a/next.config.ts b/apps/app/next.config.ts
similarity index 100%
rename from next.config.ts
rename to apps/app/next.config.ts
diff --git a/apps/app/package.json b/apps/app/package.json
new file mode 100644
index 0000000..6ac221b
--- /dev/null
+++ b/apps/app/package.json
@@ -0,0 +1,35 @@
+{
+  "name": "@repo/app",
+  "version": "0.1.0",
+  "private": true,
+  "scripts": {
+    "dev": "next dev --turbopack",
+    "build": "next build",
+    "start": "next start",
+    "lint": "eslint ."
+  },
+  "dependencies": {
+    "@ag-ui/mcp-apps-middleware": "^0.0.3",
+    "@copilotkit/react-core": "1.51.4-next.1",
+    "@copilotkit/react-ui": "1.51.4-next.1",
+    "@copilotkit/runtime": "1.51.4-next.1",
+    "next": "16.1.6",
+    "react": "^19.2.4",
+    "react-dom": "^19.2.4",
+    "react-rnd": "^10.5.2",
+    "react18-json-view": "^0.2.9",
+    "recharts": "^3.7.0"
+  },
+  "devDependencies": {
+    "@eslint/eslintrc": "^3",
+    "@tailwindcss/postcss": "^4",
+    "@types/node": "^20",
+    "@types/react": "^19",
+    "@types/react-dom": "^19",
+    "eslint": "^9",
+    "eslint-config-next": "16.1.6",
+    "tailwindcss": "^4",
+    "typescript": "^5",
+    "zod": "^3.23.8"
+  }
+}
diff --git a/postcss.config.mjs b/apps/app/postcss.config.mjs
similarity index 100%
rename from postcss.config.mjs
rename to apps/app/postcss.config.mjs
diff --git a/public/file.svg b/apps/app/public/file.svg
similarity index 100%
rename from public/file.svg
rename to apps/app/public/file.svg
diff --git a/public/globe.svg b/apps/app/public/globe.svg
similarity index 100%
rename from public/globe.svg
rename to apps/app/public/globe.svg
diff --git a/public/next.svg b/apps/app/public/next.svg
similarity index 100%
rename from public/next.svg
rename to apps/app/public/next.svg
diff --git a/public/vercel.svg b/apps/app/public/vercel.svg
similarity index 100%
rename from public/vercel.svg
rename to apps/app/public/vercel.svg
diff --git a/public/window.svg b/apps/app/public/window.svg
similarity index 100%
rename from public/window.svg
rename to apps/app/public/window.svg
diff --git a/apps/app/src/app/api/copilotkit/ag-ui-middleware.ts b/apps/app/src/app/api/copilotkit/ag-ui-middleware.ts
new file mode 100644
index 0000000..1685ded
--- /dev/null
+++ b/apps/app/src/app/api/copilotkit/ag-ui-middleware.ts
@@ -0,0 +1,13 @@
+import { MCPAppsMiddleware } from "@ag-ui/mcp-apps-middleware";
+
+export const aguiMiddleware = [
+  new MCPAppsMiddleware({
+    mcpServers: [
+      {
+        type: "http",
+        url: "http://localhost:3108/mcp",
+        serverId: "example_mcp_app",
+      },
+    ],
+  }),
+];
\ No newline at end of file
diff --git a/apps/app/src/app/api/copilotkit/route.ts b/apps/app/src/app/api/copilotkit/route.ts
new file mode 100644
index 0000000..502f950
--- /dev/null
+++ b/apps/app/src/app/api/copilotkit/route.ts
@@ -0,0 +1,33 @@
+import {
+  CopilotRuntime,
+  ExperimentalEmptyAdapter,
+  copilotRuntimeNextJSAppRouterEndpoint,
+} from "@copilotkit/runtime";
+import { LangGraphAgent } from "@copilotkit/runtime/langgraph";
+import { NextRequest } from "next/server";
+import { aguiMiddleware } from "@/app/api/copilotkit/ag-ui-middleware";
+
+// 1. Define the agent connection to LangGraph
+const defaultAgent = new LangGraphAgent({
+  deploymentUrl: process.env.LANGGRAPH_DEPLOYMENT_URL || "http://localhost:8123",
+  graphId: "sample_agent",
+  langsmithApiKey: process.env.LANGSMITH_API_KEY || "",
+});
+
+// 2. Bind in middleware to the agent. For A2UI and MCP Apps.
+defaultAgent.use(...aguiMiddleware)
+
+// 3. Define the route and CopilotRuntime for the agent
+export const POST = async (req: NextRequest) => {
+  const { handleRequest } = copilotRuntimeNextJSAppRouterEndpoint({
+    endpoint: "/api/copilotkit",
+    serviceAdapter: new ExperimentalEmptyAdapter(),
+    runtime: new CopilotRuntime({
+      agents: {
+        default: defaultAgent,
+      },
+    }),
+  });
+
+  return handleRequest(req);
+};
diff --git a/src/app/favicon.ico b/apps/app/src/app/favicon.ico
similarity index 100%
rename from src/app/favicon.ico
rename to apps/app/src/app/favicon.ico
diff --git a/src/app/globals.css b/apps/app/src/app/globals.css
similarity index 100%
rename from src/app/globals.css
rename to apps/app/src/app/globals.css
diff --git a/apps/app/src/app/layout.tsx b/apps/app/src/app/layout.tsx
new file mode 100644
index 0000000..6917a03
--- /dev/null
+++ b/apps/app/src/app/layout.tsx
@@ -0,0 +1,22 @@
+"use client";
+
+import "./globals.css";
+
+import { CopilotKit } from "@copilotkit/react-core";
+import "@copilotkit/react-ui/v2/styles.css";
+
+export default function RootLayout({
+  children,
+}: Readonly<{
+  children: React.ReactNode;
+}>) {
+  return (
+    <html lang="en">
+      <body className={`antialiased`}>
+        <CopilotKit runtimeUrl="/api/copilotkit">
+          {children}
+        </CopilotKit>
+      </body>
+    </html>
+  );
+}
diff --git a/apps/app/src/app/page.tsx b/apps/app/src/app/page.tsx
new file mode 100644
index 0000000..514277c
--- /dev/null
+++ b/apps/app/src/app/page.tsx
@@ -0,0 +1,24 @@
+"use client";
+
+import { ExampleLayout } from "@/components/example-layout";
+import { Canvas } from "@/components/canvas";
+import { useGenerativeUIExamples, useExampleSuggestions } from "@/hooks";
+
+import { CopilotChat } from "@copilotkit/react-core/v2";
+// import { HeadlessChat } from "@/components/headless-chat";
+
+export default function HomePage() {
+  // 🪁 Generative UI Examples
+  useGenerativeUIExamples();
+
+  // 🪁 Example Suggestions
+  useExampleSuggestions();
+
+  return (
+    <ExampleLayout
+      chatContent={<CopilotChat />}
+      // chatContent={<HeadlessChat />}
+      appContent={<Canvas />}
+    />
+  );
+}
\ No newline at end of file
diff --git a/apps/app/src/components/canvas/index.tsx b/apps/app/src/components/canvas/index.tsx
new file mode 100644
index 0000000..9ab34fe
--- /dev/null
+++ b/apps/app/src/components/canvas/index.tsx
@@ -0,0 +1,21 @@
+"use client";
+
+import { useAgent } from "@copilotkit/react-core/v2";
+import { TodoList } from "./todo-list";
+
+export function Canvas() {
+  const { agent } = useAgent();
+
+  return (
+    <div className="h-full p-8 bg-gray-50">
+      <TodoList
+        // read state from agent
+        todos={agent.state?.todos || []} 
+        // update state in agent
+        onUpdate={(updatedTodos) => agent.setState({ todos: updatedTodos })}
+        // change UI based on agent execution
+        isAgentRunning={agent.isRunning}
+      />
+    </div>
+  );
+}
diff --git a/apps/app/src/components/canvas/todo-card.tsx b/apps/app/src/components/canvas/todo-card.tsx
new file mode 100644
index 0000000..3088147
--- /dev/null
+++ b/apps/app/src/components/canvas/todo-card.tsx
@@ -0,0 +1,153 @@
+"use client";
+
+import { useState } from "react";
+
+interface Todo {
+  id: string;
+  title: string;
+  description: string;
+  emoji: string;
+  status: "pending" | "completed";
+}
+
+interface TodoCardProps {
+  todo: Todo;
+  onToggleStatus: (todo: Todo) => void;
+  onDelete: (todo: Todo) => void;
+  onUpdateTitle: (todoId: string, title: string) => void;
+  onUpdateDescription: (todoId: string, description: string) => void;
+}
+
+export function TodoCard({
+  todo,
+  onToggleStatus,
+  onDelete,
+  onUpdateTitle,
+  onUpdateDescription,
+}: TodoCardProps) {
+  const [editingField, setEditingField] = useState<"title" | "description" | null>(null);
+  const [editValue, setEditValue] = useState("");
+
+  const isEditingTitle = editingField === "title";
+  const isEditingDescription = editingField === "description";
+  const isCompleted = todo.status === "completed";
+  const truncatedDescription = todo.description.length > 100
+    ? todo.description.slice(0, 100) + "..."
+    : todo.description;
+
+  const startEdit = (field: "title" | "description") => {
+    setEditingField(field);
+    setEditValue(field === "title" ? todo.title : todo.description);
+  };
+
+  const saveEdit = (field: "title" | "description") => {
+    if (editValue.trim()) {
+      if (field === "title") {
+        onUpdateTitle(todo.id, editValue.trim());
+      } else {
+        onUpdateDescription(todo.id, editValue.trim());
+      }
+    }
+    setEditingField(null);
+    setEditValue("");
+  };
+
+  const cancelEdit = () => {
+    setEditingField(null);
+    setEditValue("");
+  };
+
+  return (
+    <div
+      className="group bg-white rounded-lg border border-gray-200 p-4 hover:shadow-md transition-all duration-200 shadow-sm"
+    >
+      <div className="flex items-start gap-3">
+        {/* Checkbox toggle */}
+        <button
+          onClick={() => onToggleStatus(todo)}
+          className="flex-shrink-0 w-5 h-5 rounded-full border-2 border-gray-300 hover:border-gray-600 transition-colors flex items-center justify-center mt-0.5 cursor-pointer"
+          aria-label={isCompleted ? "Mark as incomplete" : "Mark as complete"}
+          title={isCompleted ? "Mark as incomplete" : "Mark as complete"}
+        >
+          {isCompleted && (
+            <svg className="w-3 h-3 text-gray-700" viewBox="0 0 12 12" fill="none" stroke="currentColor" strokeWidth="2.5">
+              <polyline points="2,6 5,9 10,3" />
+            </svg>
+          )}
+        </button>
+
+        <div className="flex-1 min-w-0">
+          <div className="flex items-start gap-2">
+            {/* Emoji */}
+            <span className="text-xl flex-shrink-0">{todo.emoji}</span>
+
+            {/* Title (editable) */}
+            <div className="flex-1 min-w-0">
+              {isEditingTitle ? (
+                <input
+                  type="text"
+                  value={editValue}
+                  onChange={(e) => setEditValue(e.target.value)}
+                  onBlur={() => saveEdit("title")}
+                  onKeyDown={(e) => {
+                    if (e.key === "Enter") saveEdit("title");
+                    if (e.key === "Escape") cancelEdit();
+                  }}
+                  className="w-full px-2 py-1 text-base font-semibold border-b-2 border-gray-400 focus:outline-none"
+                  autoFocus
+                  aria-label="Edit todo title"
+                />
+              ) : (
+                <div
+                  onClick={() => startEdit("title")}
+                  className={`text-base font-semibold cursor-text break-words ${
+                    isCompleted ? "line-through text-gray-400" : "text-gray-900"
+                  }`}
+                >
+                  {todo.title}
+                </div>
+              )}
+            </div>
+          </div>
+
+          {/* Description (editable, truncated) */}
+          <div className="mt-2 ml-7">
+            {isEditingDescription ? (
+              <textarea
+                value={editValue}
+                onChange={(e) => setEditValue(e.target.value)}
+                onBlur={() => saveEdit("description")}
+                onKeyDown={(e) => {
+                  if (e.key === "Escape") cancelEdit();
+                }}
+                className="w-full px-2 py-1 text-sm text-gray-600 border border-gray-400 rounded focus:outline-none resize-none"
+                rows={3}
+                autoFocus
+                aria-label="Edit todo description"
+              />
+            ) : (
+              <p
+                onClick={() => startEdit("description")}
+                className={`text-sm cursor-text ${
+                  isCompleted ? "line-through text-gray-300" : "text-gray-600"
+                }`}
+              >
+                {truncatedDescription}
+              </p>
+            )}
+          </div>
+        </div>
+
+        {/* Delete button (visible on hover) */}
+        <button
+          onClick={() => onDelete(todo)}
+          className="flex-shrink-0 opacity-0 group-hover:opacity-100 text-gray-400 hover:text-red-600 transition-all text-lg cursor-pointer"
+          aria-label="Delete todo"
+          title="Delete todo"
+        >
+          ×
+        </button>
+      </div>
+    </div>
+  );
+}
diff --git a/apps/app/src/components/canvas/todo-column.tsx b/apps/app/src/components/canvas/todo-column.tsx
new file mode 100644
index 0000000..e453bdb
--- /dev/null
+++ b/apps/app/src/components/canvas/todo-column.tsx
@@ -0,0 +1,78 @@
+"use client";
+
+import { TodoCard } from "./todo-card";
+
+interface Todo {
+  id: string;
+  title: string;
+  description: string;
+  emoji: string;
+  status: "pending" | "completed";
+}
+
+interface TodoColumnProps {
+  title: string;
+  todos: Todo[];
+  emptyMessage: string;
+  showAddButton?: boolean;
+  onAddTodo?: () => void;
+  onToggleStatus: (todo: Todo) => void;
+  onDelete: (todo: Todo) => void;
+  onUpdateTitle: (todoId: string, title: string) => void;
+  onUpdateDescription: (todoId: string, description: string) => void;
+  isAgentRunning: boolean;
+}
+
+export function TodoColumn({
+  title,
+  todos,
+  emptyMessage,
+  showAddButton = false,
+  onAddTodo,
+  onToggleStatus,
+  onDelete,
+  onUpdateTitle,
+  onUpdateDescription,
+  isAgentRunning,
+}: TodoColumnProps) {
+  return (
+    <section aria-label={`${title} column`} className="flex-1 min-w-0">
+      <div className="mb-6 flex items-center justify-between">
+        <div>
+          <h2 className="text-xl font-bold text-gray-900">{title}</h2>
+          <p className="text-sm text-gray-500 mt-1">
+            {todos.length} {todos.length === 1 ? 'task' : 'tasks'}
+          </p>
+        </div>
+        {showAddButton && onAddTodo && (
+          <button
+            onClick={onAddTodo}
+            className="px-2.5 py-0.5 text-black text-xl border bg-white font-medium rounded-lg hover:border-gray-500 hover:border hover:shadow-md transition-all cursor-pointer"
+            aria-label="Add new todo"
+            disabled={isAgentRunning}
+          >
+            +
+          </button>
+        )}
+      </div>
+      <div className="space-y-6">
+        {todos.length === 0 ? (
+          <div role="status" className="text-center py-12 text-gray-400 text-sm">
+            {emptyMessage}
+          </div>
+        ) : (
+          todos.map((todo) => (
+            <TodoCard
+              key={todo.id}
+              todo={todo}
+              onToggleStatus={onToggleStatus}
+              onDelete={onDelete}
+              onUpdateTitle={onUpdateTitle}
+              onUpdateDescription={onUpdateDescription}
+            />
+          ))
+        )}
+      </div>
+    </section>
+  );
+}
diff --git a/apps/app/src/components/canvas/todo-list.tsx b/apps/app/src/components/canvas/todo-list.tsx
new file mode 100644
index 0000000..041a8a9
--- /dev/null
+++ b/apps/app/src/components/canvas/todo-list.tsx
@@ -0,0 +1,106 @@
+"use client";
+
+import { TodoColumn } from "./todo-column";
+
+interface Todo {
+  id: string;
+  title: string;
+  description: string;
+  emoji: string;
+  status: "pending" | "completed";
+}
+
+interface TodoListProps {
+  todos: Todo[];
+  onUpdate: (todos: Todo[]) => void;
+  isAgentRunning: boolean;
+}
+
+export function TodoList({ todos, onUpdate, isAgentRunning }: TodoListProps) {
+  // Filter todos by status
+  const pendingTodos = todos.filter((t) => t.status === "pending");
+  const completedTodos = todos.filter((t) => t.status === "completed");
+
+  // Handlers
+  const toggleStatus = (todo: Todo) => {
+    const updated = todos.map((t) =>
+      t.id === todo.id
+        ? { ...t, status: (t.status === "completed" ? "pending" : "completed") as "pending" | "completed" }
+        : t
+    );
+    onUpdate(updated);
+  };
+
+  const deleteTodo = (todo: Todo) => {
+    onUpdate(todos.filter((t) => t.id !== todo.id));
+  };
+
+  const updateTitle = (todoId: string, title: string) => {
+    const updated = todos.map((t) =>
+      t.id === todoId ? { ...t, title } : t
+    );
+    onUpdate(updated);
+  };
+
+  const updateDescription = (todoId: string, description: string) => {
+    const updated = todos.map((t) =>
+      t.id === todoId ? { ...t, description } : t
+    );
+    onUpdate(updated);
+  };
+
+  const addTodo = () => {
+    const newTodo: Todo = {
+      id: crypto.randomUUID(),
+      title: "New Todo",
+      description: "Add a description",
+      emoji: "✅",
+      status: "pending",
+    };
+    onUpdate([...todos, newTodo]);
+  };
+
+  // Empty state
+  if (!todos || todos.length === 0) {
+    return (
+      <div className="flex items-center justify-center h-full">
+        <button
+          onClick={addTodo}
+          className="px-6 py-3 bg-gray-800 text-white font-medium rounded-lg hover:bg-gray-900 shadow-md hover:shadow-lg transition-all cursor-pointer"
+          aria-label="Add your first todo task"
+          disabled={isAgentRunning}
+        >
+          Add your first todo
+        </button>
+      </div>
+    );
+  }
+
+  // Columns
+  return (
+    <div className="flex gap-8 h-full max-w-6xl mx-auto">
+      <TodoColumn
+        title="To Do"
+        todos={pendingTodos}
+        emptyMessage="No pending tasks"
+        showAddButton
+        onAddTodo={addTodo}
+        onToggleStatus={toggleStatus}
+        onDelete={deleteTodo}
+        onUpdateTitle={updateTitle}
+        onUpdateDescription={updateDescription}
+        isAgentRunning={isAgentRunning}
+      />
+      <TodoColumn
+        title="Done"
+        todos={completedTodos}
+        emptyMessage="No completed tasks"
+        onToggleStatus={toggleStatus}
+        onDelete={deleteTodo}
+        onUpdateTitle={updateTitle}
+        onUpdateDescription={updateDescription}
+        isAgentRunning={isAgentRunning}
+      />
+    </div>
+  );
+}
diff --git a/apps/app/src/components/example-layout/index.tsx b/apps/app/src/components/example-layout/index.tsx
new file mode 100644
index 0000000..5701316
--- /dev/null
+++ b/apps/app/src/components/example-layout/index.tsx
@@ -0,0 +1,64 @@
+"use client";
+
+import { ReactNode, useState } from "react";
+import { ModeToggle } from "./mode-toggle";
+import { useFrontendTool } from "@copilotkit/react-core";
+import { z } from "zod";
+
+interface ExampleLayoutProps {
+  chatContent: ReactNode;
+  appContent: ReactNode;
+}
+
+export function ExampleLayout({
+  chatContent,
+  appContent,
+}: ExampleLayoutProps) {
+  const [mode, setMode] = useState<'chat' | 'app'>('chat');
+
+  useFrontendTool({
+    name: "enableAppMode",
+    description: "Enable app mode, make sure its open when interacting with todos.",
+    handler: async () => {
+      setMode('app');
+    },
+  });
+
+  useFrontendTool({
+    name: "enableChatMode",
+    description: "Enable chat mode",
+    handler: async () => {
+      setMode('chat');
+    },
+  });
+
+  return (
+    <div className="h-full flex flex-row">
+      <ModeToggle mode={mode} onModeChange={setMode} />
+
+      {/* Chat Content */}
+      <div
+        className={`max-h-full overflow-y-auto ${
+          mode === 'app'
+            ? 'w-1/3 px-6 max-lg:hidden' // Hide on mobile in app mode
+            : 'flex-1 max-lg:px-4'
+        }`}
+      >
+        {chatContent}
+      </div>
+
+      {/* State Panel */}
+      <div
+        className={`h-full overflow-hidden ${
+          mode === 'app'
+            ? 'w-2/3 max-lg:w-full border-l max-lg:border-l-0' // Full width on mobile
+            : 'w-0 border-l-0'
+        }`}
+      >
+        <div className="w-full lg:w-[66.666vw] h-full">
+          {appContent}
+        </div>
+      </div>
+    </div>
+  );
+}
diff --git a/apps/app/src/components/example-layout/mode-toggle.tsx b/apps/app/src/components/example-layout/mode-toggle.tsx
new file mode 100644
index 0000000..4bd4509
--- /dev/null
+++ b/apps/app/src/components/example-layout/mode-toggle.tsx
@@ -0,0 +1,37 @@
+interface ModeToggleProps {
+  mode: 'chat' | 'app';
+  onModeChange: (mode: 'chat' | 'app') => void;
+}
+
+export function ModeToggle({ mode, onModeChange }: ModeToggleProps) {
+  return (
+    <div className="fixed top-4 right-4 z-50 flex bg-gray-100 rounded-lg p-1 shadow-sm max-lg:top-2 max-lg:right-2 max-lg:scale-90">
+      <button
+        onClick={() => onModeChange('chat')}
+        className={`
+          px-4 py-2 rounded-md text-sm font-medium transition-all max-lg:px-3 max-lg:py-1.5 max-lg:text-xs
+          cursor-pointer
+          ${mode === 'chat'
+            ? 'bg-white text-gray-900 shadow-sm'
+            : 'text-gray-600 hover:text-gray-900'
+          }
+        `}
+      >
+        Chat
+      </button>
+      <button
+        onClick={() => onModeChange('app')}
+        className={`
+          px-4 py-2 rounded-md text-sm font-medium transition-all max-lg:px-3 max-lg:py-1.5 max-lg:text-xs
+          cursor-pointer
+          ${mode === 'app'
+            ? 'bg-white text-gray-900 shadow-sm'
+            : 'text-gray-600 hover:text-gray-900'
+          }
+        `}
+      >
+        App Mode
+      </button>
+    </div>
+  );
+}
diff --git a/apps/app/src/components/generative-ui/charts/bar-chart.tsx b/apps/app/src/components/generative-ui/charts/bar-chart.tsx
new file mode 100644
index 0000000..4e07b2c
--- /dev/null
+++ b/apps/app/src/components/generative-ui/charts/bar-chart.tsx
@@ -0,0 +1,53 @@
+import { BarChart as RechartsBarChart, Bar, XAxis, YAxis, Tooltip, ResponsiveContainer } from 'recharts';
+import { CHART_COLORS, CHART_CONFIG } from './config';
+
+interface BarChartProps {
+  title: string;
+  description: string;
+  data: Array<{ label: string; value: number }>;
+}
+
+export function BarChart({ title, description, data }: BarChartProps) {
+  if (!data || !Array.isArray(data) || data.length === 0) {
+    return (
+      <div className="rounded-xl border shadow-sm p-6 max-w-2xl mx-auto my-6">
+        <div className="mb-4">
+          <h3 className="text-xl font-bold">{title}</h3>
+          <p className="text-sm text-gray-600">{description}</p>
+        </div>
+        <p className="text-gray-500 text-center py-8">No data available</p>
+      </div>
+    );
+  }
+
+  // Add colors to data
+  const coloredData = data.map((entry, index) => ({
+    ...entry,
+    fill: CHART_COLORS[index % CHART_COLORS.length]
+  }));
+
+  return (
+    <div className="rounded-xl border shadow-sm p-6 max-w-2xl mx-auto my-6">
+      <div className="mb-4">
+        <h3 className="text-xl font-bold">{title}</h3>
+        <p className="text-sm text-gray-600">{description}</p>
+      </div>
+
+      <ResponsiveContainer width="100%" height={300}>
+        <RechartsBarChart data={coloredData} margin={{ top: 5, right: 20, bottom: 5, left: 0 }}>
+          <XAxis
+            dataKey="label"
+            tick={{ fontSize: 12 }}
+            stroke="#6b7280"
+          />
+          <YAxis
+            tick={{ fontSize: 12 }}
+            stroke="#6b7280"
+          />
+          <Tooltip contentStyle={CHART_CONFIG.tooltipStyle} />
+          <Bar dataKey="value" radius={[4, 4, 0, 0]} />
+        </RechartsBarChart>
+      </ResponsiveContainer>
+    </div>
+  );
+}
diff --git a/apps/app/src/components/generative-ui/charts/config.ts b/apps/app/src/components/generative-ui/charts/config.ts
new file mode 100644
index 0000000..5d6dac5
--- /dev/null
+++ b/apps/app/src/components/generative-ui/charts/config.ts
@@ -0,0 +1,18 @@
+export const CHART_COLORS = [
+  '#3b82f6', // blue
+  '#8b5cf6', // purple
+  '#ec4899', // pink
+  '#f59e0b', // amber
+  '#10b981', // emerald
+  '#06b6d4', // cyan
+  '#f97316', // orange
+];
+
+export const CHART_CONFIG = {
+  tooltipStyle: {
+    backgroundColor: 'white',
+    border: '1px solid #e5e7eb',
+    borderRadius: '8px',
+    padding: '8px 12px',
+  }
+};
diff --git a/apps/app/src/components/generative-ui/charts/pie-chart.tsx b/apps/app/src/components/generative-ui/charts/pie-chart.tsx
new file mode 100644
index 0000000..78edeee
--- /dev/null
+++ b/apps/app/src/components/generative-ui/charts/pie-chart.tsx
@@ -0,0 +1,64 @@
+import { PieChart as RechartsPieChart, Pie, Tooltip, ResponsiveContainer } from 'recharts';
+import { CHART_COLORS, CHART_CONFIG } from './config';
+
+interface PieChartProps {
+  title: string;
+  description: string;
+  data: Array<{ label: string; value: number }>;
+}
+
+export function PieChart({ title, description, data }: PieChartProps) {
+  if (!data || !Array.isArray(data) || data.length === 0) {
+    return (
+      <div className="rounded-xl border shadow-sm p-6 max-w-lg mx-auto my-6">
+        <div className="mb-4">
+          <h3 className="text-xl font-bold">{title}</h3>
+          <p className="text-sm text-gray-600">{description}</p>
+        </div>
+        <p className="text-gray-500 text-center py-8">No data available</p>
+      </div>
+    );
+  }
+
+  // Add colors to data
+  const coloredData = data.map((entry, index) => ({
+    ...entry,
+    fill: CHART_COLORS[index % CHART_COLORS.length]
+  }));
+
+  return (
+    <div className="rounded-xl border shadow-sm p-6 max-w-lg mx-auto my-6">
+      <div className="mb-4">
+        <h3 className="text-xl font-bold">{title}</h3>
+        <p className="text-sm text-gray-600">{description}</p>
+      </div>
+
+      <ResponsiveContainer width="100%" height={300}>
+        <RechartsPieChart>
+          <Pie
+            data={coloredData}
+            dataKey="value"
+            nameKey="label"
+            cx="50%"
+            cy="50%"
+            outerRadius={100}
+          />
+          <Tooltip contentStyle={CHART_CONFIG.tooltipStyle} />
+        </RechartsPieChart>
+      </ResponsiveContainer>
+
+      {/* Legend */}
+      <div className="mt-4 grid grid-cols-2 gap-2">
+        {data.map((item, index) => (
+          <div key={index} className="flex items-center gap-2">
+            <div
+              className="w-3 h-3 rounded-sm"
+              style={{ backgroundColor: CHART_COLORS[index % CHART_COLORS.length] }}
+            />
+            <span className="text-sm">{item.label}</span>
+          </div>
+        ))}
+      </div>
+    </div>
+  );
+}
diff --git a/apps/app/src/components/generative-ui/meeting-time-picker.tsx b/apps/app/src/components/generative-ui/meeting-time-picker.tsx
new file mode 100644
index 0000000..64cc4cc
--- /dev/null
+++ b/apps/app/src/components/generative-ui/meeting-time-picker.tsx
@@ -0,0 +1,120 @@
+import { useState } from "react";
+
+export interface TimeSlot {
+  date: string;
+  time: string;
+  duration?: string;
+}
+
+export interface MeetingTimePickerProps {
+  status: "inProgress" | "executing" | "complete";
+  respond?: (response: string) => void;
+  title?: string;
+  timeSlots?: TimeSlot[];
+}
+
+export function MeetingTimePicker({
+  status,
+  respond,
+  title = "Schedule a Meeting",
+  timeSlots = [
+    { date: "Tomorrow", time: "2:00 PM", duration: "30 min" },
+    { date: "Friday", time: "10:00 AM", duration: "30 min" },
+    { date: "Next Monday", time: "3:00 PM", duration: "30 min" },
+  ]
+}: MeetingTimePickerProps) {
+  const [selectedSlot, setSelectedSlot] = useState<TimeSlot | null>(null);
+  const [declined, setDeclined] = useState(false);
+
+  const handleSelectSlot = (slot: TimeSlot) => {
+    setSelectedSlot(slot);
+    respond?.(`Meeting scheduled for ${slot.date} at ${slot.time}${slot.duration ? ` (${slot.duration})` : ''}.`);
+  };
+
+  const handleDecline = () => {
+    setDeclined(true);
+    respond?.("The user declined all proposed meeting times. Please suggest alternative times or ask for their availability.");
+  };
+
+  return (
+    <div className="rounded-2xl shadow-lg max-w-md w-full border mx-auto mb-10">
+      <div className="backdrop-blur-md p-8 w-full rounded-2xl">
+        {/* Show confirmation or prompt */}
+        {selectedSlot ? (
+          <div className="text-center">
+            <div className="text-7xl mb-4">📅</div>
+            <h2 className="text-2xl font-bold mb-2">
+              Meeting Scheduled
+            </h2>
+            <p className="text-gray-600 mb-2">
+              {selectedSlot.date} at {selectedSlot.time}
+            </p>
+            {selectedSlot.duration && (
+              <p className="text-sm text-gray-500">
+                Duration: {selectedSlot.duration}
+              </p>
+            )}
+          </div>
+        ) : declined ? (
+          <div className="text-center">
+            <div className="text-7xl mb-4">🔄</div>
+            <h2 className="text-2xl font-bold mb-2">
+              No Time Selected
+            </h2>
+            <p className="text-gray-600">
+              Let me find a better time that works for you
+            </p>
+          </div>
+        ) : (
+          <>
+            <div className="text-center mb-6">
+              <div className="text-7xl mb-4">🗓️</div>
+              <h2 className="text-2xl font-bold mb-2">
+                {title}
+              </h2>
+              <p className="text-gray-600">
+                Select a time that works for you
+              </p>
+            </div>
+
+            {/* Time slot options */}
+            {status === "executing" && (
+              <div className="space-y-3">
+                {timeSlots.map((slot, index) => (
+                  <button
+                    key={index}
+                    onClick={() => handleSelectSlot(slot)}
+                    className="w-full px-6 py-4 rounded-xl font-medium
+                      border-2 border-gray-200 hover:border-blue-500
+                      shadow-sm hover:shadow-md transition-all cursor-pointer
+                      hover:scale-102 active:scale-98
+                      flex justify-between items-center
+                      hover:bg-blue-50"
+                  >
+                    <div className="text-left">
+                      <div className="font-bold text-gray-900">{slot.date}</div>
+                      <div className="text-sm text-gray-600">{slot.time}</div>
+                    </div>
+                    {slot.duration && (
+                      <div className="text-sm text-gray-500">{slot.duration}</div>
+                    )}
+                  </button>
+                ))}
+
+                <button
+                  onClick={handleDecline}
+                  className="w-full px-6 py-3 rounded-xl font-medium
+                    text-gray-600 hover:text-gray-800
+                    transition-all cursor-pointer
+                    hover:bg-gray-100"
+                >
+                  None of these work
+                </button>
+              </div>
+            )}
+          </>
+        )}
+      </div>
+    </div>
+  );
+}
diff --git a/apps/app/src/components/headless-chat.tsx b/apps/app/src/components/headless-chat.tsx
new file mode 100644
index 0000000..ec3b1e5
--- /dev/null
+++ b/apps/app/src/components/headless-chat.tsx
@@ -0,0 +1,30 @@
+import { useAgent } from "@copilotkit/react-core/v2";
+import { useCallback, useState } from "react";
+
+export const HeadlessChat = () => {
+    const { agent } = useAgent()
+    const [message, setMessage] = useState("")
+
+    const sendMessage = useCallback((message: string) => {
+        agent.addMessage({
+            role: "user",
+            id: crypto.randomUUID(),
+            content: message,
+        })
+        agent.runAgent()
+        setMessage("")
+    }, [agent])
+
+    return (
+        <div>
+            <h1>Chat</h1>
+            {agent.messages.map((message) => (
+                <div key={message.id}>
+                    <p>{JSON.stringify(message.content)}</p>
+                </div>
+            ))}
+            <input type="text" value={message} onChange={(e) => setMessage(e.target.value)} />
+            <button onClick={() => sendMessage(message)}>Send</button>
+        </div>
+    )
+}
\ No newline at end of file
diff --git a/apps/app/src/hooks/index.ts b/apps/app/src/hooks/index.ts
new file mode 100644
index 0000000..fa43cc4
--- /dev/null
+++ b/apps/app/src/hooks/index.ts
@@ -0,0 +1,2 @@
+export { useExampleSuggestions } from "./use-example-suggestions";
+export { useGenerativeUIExamples } from "./use-generative-ui-examples";
\ No newline at end of file
diff --git a/apps/app/src/hooks/use-example-suggestions.tsx b/apps/app/src/hooks/use-example-suggestions.tsx
new file mode 100644
index 0000000..cae80c4
--- /dev/null
+++ b/apps/app/src/hooks/use-example-suggestions.tsx
@@ -0,0 +1,14 @@
+import { useConfigureSuggestions } from "@copilotkit/react-core/v2";
+
+export const useExampleSuggestions = () => {
+  useConfigureSuggestions({
+    suggestions: [
+      { title: "Generative UI", message: "Please briefly explain and then demonstrate static generative UI to me with your tools." },
+      { title: "MCP Apps", message: "Please briefly explain and then demonstrate MCP Apps with a 3D outlined cube." },
+      { title: "Frontend Tools", message: "Please briefly explain and then demonstrate frontend tools to me." },
+      { title: "Human In The Loop", message: "Please briefly explain and then demonstrate frontend-based human-in-the-loop to me" },
+      { title: "App Mode", message: "Please briefly explain shared state, open the canvas, and then add some todos to it about learning about CopilotKit." },
+    ],
+    available: "always", // Optional: when to show suggestions
+  });
+}
\ No newline at end of file
diff --git a/apps/app/src/hooks/use-generative-ui-examples.tsx b/apps/app/src/hooks/use-generative-ui-examples.tsx
new file mode 100644
index 0000000..becfd04
--- /dev/null
+++ b/apps/app/src/hooks/use-generative-ui-examples.tsx
@@ -0,0 +1,112 @@
+import {
+  useFrontendTool,
+  useHumanInTheLoop,
+} from "@copilotkit/react-core/v2";
+import { z } from "zod"
+import { useDefaultTool } from "@copilotkit/react-core";
+import { PieChart } from "@/components/generative-ui/charts/pie-chart";
+import { BarChart } from "@/components/generative-ui/charts/bar-chart";
+import { MeetingTimePicker } from "@/components/generative-ui/meeting-time-picker";
+
+export const useGenerativeUIExamples = () => {
+
+  // ------------------
+  // 🪁 Frontend Tools: https://docs.copilotkit.ai/langgraph/frontend-actions
+  // ------------------
+  useFrontendTool({
+    name: "alertHelloToUser",
+    description: "Call the browser's native `alert` function. This is a great example of a frontend tool.",
+    parameters: z.object({
+      name: z.string(),
+    }),
+    handler: async ({ name }) => {
+      alert(`Hello ${name}!`);
+      return `Said hello to ${name}!`;
+    },
+  });
+
+  // --------------------------
+  // 🪁 Backend Tool Rendering: https://docs.copilotkit.ai/langgraph/generative-ui/backend-tools
+  // --------------------------
+  useDefaultTool({
+    render: ({ name, status }) => {
+      const textStyles = "text-gray-500 text-sm mt-2"
+      if(status !== "complete") {
+        return <p className={textStyles}>Calling {name}...</p>;
+      }
+      return <p className={textStyles}>Called {name}!</p>;
+    },
+  });
+
+  // ----------------------------------
+  // 🪁 Frontend Tools - Generative UI: https://docs.copilotkit.ai/langgraph/generative-ui/frontend-tools
+  // ----------------------------------
+  useFrontendTool({
+    name: "show_pie_chart",
+    description: `
+      Always call the query_data tool to fetch all data from the database first.
+      Display data as a pie chart or bar chart. Use pie charts for part-to-whole relationships (5-7 segments max). Use bar charts for comparisons or trends.
+
+      This is a great example of static generative UI.
+    `,
+    parameters: z.object({
+      title: z.string().describe("Chart title"),
+      description: z.string().describe("Brief description or subtitle"),
+      data: z.array(z.object({
+        label: z.string(),
+        value: z.number(),
+      })).describe("Array of {label: string, value: number}"),
+    }),
+    render: ({ args }) => {
+      const { title, description, data } = args;
+
+      // Provide defaults for required fields
+      const chartTitle = title || "Chart";
+      const chartDescription = description || "";
+      const chartData = (data as Array<{ label: string; value: number }>) || [];
+
+      return <PieChart title={chartTitle} description={chartDescription} data={chartData} />;
+    }
+  });
+
+  useFrontendTool({
+    name: "show_bar_chart",
+    description: `
+      Always call the query_data tool to fetch all data from the database first.
+      Display data as a pie chart or bar chart. Use pie charts for part-to-whole relationships (5-7 segments max). Use bar charts for comparisons or trends.
+
+      This is a great example of static generative UI.
+    `,
+    parameters: z.object({
+      title: z.string().describe("Chart title"),
+      description: z.string().describe("Brief description or subtitle"),
+      data: z.array(z.object({
+        label: z.string(),
+        value: z.number(),
+      })).describe("Array of {label: string, value: number}"),
+    }),
+    render: ({ args }) => {
+      const { title, description, data } = args;
+
+      // Provide defaults for required fields
+      const chartTitle = title || "Chart";
+      const chartDescription = description || "";
+      const chartData = (data as Array<{ label: string; value: number }>) || [];
+
+      return <BarChart title={chartTitle} description={chartDescription} data={chartData} />;
+    }
+  });
+
+  // -------------------------------------
+  // 🪁 Frontend-tools - Human-in-the-loop: https://docs.copilotkit.ai/langgraph/human-in-the-loop/frontend-tool-based
+  // -------------------------------------
+  useHumanInTheLoop({
+    name: "demonstrateHumanInTheLoop",
+    description: "Demonstrate human-in-the-loop by proposing meeting times and asking the user to select one.",
+    render: ({ respond, status }) => {
+      return (
+        <MeetingTimePicker status={status} respond={respond} />
+      );
+    },
+  });
+}
\ No newline at end of file
diff --git a/tsconfig.json b/apps/app/tsconfig.json
similarity index 100%
rename from tsconfig.json
rename to apps/app/tsconfig.json
diff --git a/apps/mcp/.gitignore b/apps/mcp/.gitignore
new file mode 100644
index 0000000..c5478ba
--- /dev/null
+++ b/apps/mcp/.gitignore
@@ -0,0 +1,3 @@
+node_modules/
+dist/
+.turbo
\ No newline at end of file
diff --git a/apps/mcp/README.md b/apps/mcp/README.md
new file mode 100644
index 0000000..41e6d2f
--- /dev/null
+++ b/apps/mcp/README.md
@@ -0,0 +1,110 @@
+# Example: Three.js App
+
+![Screenshot](screenshot.png)
+
+Interactive 3D scene renderer using Three.js. Demonstrates streaming code preview and full MCP App integration.
+
+## Features
+
+- **Interactive 3D Rendering**: Execute JavaScript code to create and animate Three.js scenes
+- **Streaming Preview**: See the scene build in real-time as code is being written
+- **Built-in Helpers**: Pre-configured `OrbitControls`, post-processing effects (bloom), and render passes
+- **Documentation Tool**: `learn_threejs` provides API docs and code examples on demand
+
+## Running
+
+1. Install dependencies:
+
+   ```bash
+   npm install
+   ```
+
+2. Build and start the server:
+
+   ```bash
+   npm run start:http  # for Streamable HTTP transport
+   # OR
+   npm run start:stdio  # for stdio transport
+   ```
+
+3. View using the [`basic-host`](https://github.com/modelcontextprotocol/ext-apps/tree/main/examples/basic-host) example or another MCP Apps-compatible host.
+
+### Tool Input
+
+To test the example, copy the contents of [`test-input.json`](test-input.json) into the tool input field in `basic-host`.
+
+The test input creates a simple scene with a rotating cube:
+
+```javascript
+const scene = new THREE.Scene();
+const camera = new THREE.PerspectiveCamera(60, width / height, 0.1, 100);
+camera.position.set(2, 2, 2);
+
+const renderer = new THREE.WebGLRenderer({ canvas, antialias: true });
+renderer.setSize(width, height);
+renderer.shadowMap.enabled = true;
+
+const cube = new THREE.Mesh(
+  new THREE.BoxGeometry(),
+  new THREE.MeshStandardMaterial({ color: 0x00ff88 }),
+);
+cube.castShadow = true;
+cube.position.y = 0.5;
+scene.add(cube);
+
+const floor = new THREE.Mesh(
+  new THREE.PlaneGeometry(5, 5),
+  new THREE.MeshStandardMaterial({ color: 0x222233 }),
+);
+floor.rotation.x = -Math.PI / 2;
+floor.receiveShadow = true;
+scene.add(floor);
+
+const light = new THREE.DirectionalLight(0xffffff, 2);
+light.position.set(3, 5, 3);
+light.castShadow = true;
+scene.add(light);
+scene.add(new THREE.AmbientLight(0x404040));
+
+function animate() {
+  requestAnimationFrame(animate);
+  cube.rotation.y += 0.01;
+  renderer.render(scene, camera);
+}
+animate();
+```
+
+#### Available Three.js Globals
+
+When writing custom code, these globals are available:
+
+```javascript
+THREE; // Three.js library
+canvas; // Pre-created canvas element
+width; // Canvas width
+height; // Canvas height
+OrbitControls; // Camera controls
+EffectComposer; // Post-processing composer
+RenderPass; // Render pass
+UnrealBloomPass; // Bloom effect
+```
+
+## Architecture
+
+### Server (`server.ts`)
+
+Exposes two tools:
+
+- `show_threejs_scene` - Renders a 3D scene from JavaScript code
+- `learn_threejs` - Returns documentation and code examples for Three.js APIs
+
+Supports Streamable HTTP and stdio transports.
+
+### App (`src/threejs-app.tsx`)
+
+React component that:
+
+- Receives tool inputs via the MCP App SDK
+- Displays streaming preview from `toolInputsPartial.code` as code arrives
+- Executes final code from `toolInputs.code` when complete
+- Renders to a pre-created canvas with configurable height
diff --git a/apps/mcp/grid-cell.png b/apps/mcp/grid-cell.png
new file mode 100644
index 0000000000000000000000000000000000000000..49d22d9bb8c25482fa1df1d403edbda9641839ee
GIT binary patch
literal 4857
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

literal 0
HcmV?d00001

diff --git a/apps/mcp/mcp-app.html b/apps/mcp/mcp-app.html
new file mode 100644
index 0000000..b549f0c
--- /dev/null
+++ b/apps/mcp/mcp-app.html
@@ -0,0 +1,14 @@
+<!DOCTYPE html>
+<html lang="en">
+<head>
+  <meta charset="UTF-8">
+  <meta name="viewport" content="width=device-width, initial-scale=1.0">
+  <meta name="color-scheme" content="light dark">
+  <title>Three.js Widget</title>
+  <link rel="stylesheet" href="/src/global.css">
+</head>
+<body>
+  <div id="root"></div>
+  <script type="module" src="/src/mcp-app-wrapper.tsx"></script>
+</body>
+</html>
diff --git a/apps/mcp/package.json b/apps/mcp/package.json
new file mode 100644
index 0000000..cf0f2d2
--- /dev/null
+++ b/apps/mcp/package.json
@@ -0,0 +1,53 @@
+{
+  "name": "@repo/mcp",
+  "version": "0.4.0",
+  "type": "module",
+  "description": "Three.js 3D visualization MCP App Server",
+  "repository": {
+    "type": "git",
+    "url": "https://github.com/modelcontextprotocol/ext-apps",
+    "directory": "examples/threejs-server"
+  },
+  "license": "MIT",
+  "main": "server.ts",
+  "files": [
+    "server.ts",
+    "server-utils.ts",
+    "dist"
+  ],
+  "scripts": {
+    "build": "tsc --noEmit && cross-env INPUT=mcp-app.html vite build",
+    "watch": "cross-env INPUT=mcp-app.html vite build --watch",
+    "serve:http": "bun --watch server.ts",
+    "serve:stdio": "bun server.ts --stdio",
+    "start": "npm run start:http",
+    "start:http": "cross-env NODE_ENV=development npm run build && npm run serve:http",
+    "start:stdio": "cross-env NODE_ENV=development npm run build && npm run serve:stdio",
+    "dev": "cross-env NODE_ENV=development concurrently 'npm run watch' 'npm run serve:http'",
+    "prepublishOnly": "npm run build"
+  },
+  "dependencies": {
+    "@modelcontextprotocol/ext-apps": "^0.4.0",
+    "@modelcontextprotocol/sdk": "^1.24.0",
+    "react": "^19.2.0",
+    "react-dom": "^19.2.0",
+    "three": "^0.181.0",
+    "zod": "^4.1.13"
+  },
+  "devDependencies": {
+    "@types/cors": "^2.8.19",
+    "@types/express": "^5.0.0",
+    "@types/node": "^22.0.0",
+    "@types/react": "^19.2.2",
+    "@types/react-dom": "^19.2.2",
+    "@types/three": "^0.181.0",
+    "@vitejs/plugin-react": "^4.3.4",
+    "concurrently": "^9.2.1",
+    "cors": "^2.8.5",
+    "cross-env": "^10.1.0",
+    "express": "^5.1.0",
+    "typescript": "^5.9.3",
+    "vite": "^6.0.0",
+    "vite-plugin-singlefile": "^2.3.0"
+  }
+}
diff --git a/apps/mcp/screenshot.png b/apps/mcp/screenshot.png
new file mode 100644
index 0000000000000000000000000000000000000000..5b04941dc1d24d2ad2bc90b2201cb4c4631bc449
GIT binary patch
literal 5647
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

literal 0
HcmV?d00001

diff --git a/apps/mcp/server-utils.ts b/apps/mcp/server-utils.ts
new file mode 100644
index 0000000..9fe9745
--- /dev/null
+++ b/apps/mcp/server-utils.ts
@@ -0,0 +1,72 @@
+/**
+ * Shared utilities for running MCP servers with Streamable HTTP transport.
+ */
+
+import { createMcpExpressApp } from "@modelcontextprotocol/sdk/server/express.js";
+import type { McpServer } from "@modelcontextprotocol/sdk/server/mcp.js";
+import { StreamableHTTPServerTransport } from "@modelcontextprotocol/sdk/server/streamableHttp.js";
+import cors from "cors";
+import type { Request, Response } from "express";
+
+export interface ServerOptions {
+  port: number;
+  name?: string;
+}
+
+/**
+ * Starts an MCP server with Streamable HTTP transport in stateless mode.
+ *
+ * @param createServer - Factory function that creates a new McpServer instance per request.
+ * @param options - Server configuration options.
+ */
+export async function startServer(
+  createServer: () => McpServer,
+  options: ServerOptions,
+): Promise<void> {
+  const { port, name = "MCP Server" } = options;
+
+  const app = createMcpExpressApp({ host: "0.0.0.0" });
+  app.use(cors());
+
+  app.all("/mcp", async (req: Request, res: Response) => {
+    const server = createServer();
+    const transport = new StreamableHTTPServerTransport({
+      sessionIdGenerator: undefined,
+    });
+
+    res.on("close", () => {
+      transport.close().catch(() => {});
+      server.close().catch(() => {});
+    });
+
+    try {
+      await server.connect(transport);
+      await transport.handleRequest(req, res, req.body);
+    } catch (error) {
+      console.error("MCP error:", error);
+      if (!res.headersSent) {
+        res.status(500).json({
+          jsonrpc: "2.0",
+          error: { code: -32603, message: "Internal server error" },
+          id: null,
+        });
+      }
+    }
+  });
+
+  const httpServer = app.listen(port, (err) => {
+    if (err) {
+      console.error("Failed to start server:", err);
+      process.exit(1);
+    }
+    console.log(`${name} listening on http://localhost:${port}/mcp`);
+  });
+
+  const shutdown = () => {
+    console.log("\nShutting down...");
+    httpServer.close(() => process.exit(0));
+  };
+
+  process.on("SIGINT", shutdown);
+  process.on("SIGTERM", shutdown);
+}
diff --git a/apps/mcp/server.ts b/apps/mcp/server.ts
new file mode 100644
index 0000000..75ef787
--- /dev/null
+++ b/apps/mcp/server.ts
@@ -0,0 +1,246 @@
+/**
+ * Three.js MCP Server
+ *
+ * Provides tools for rendering interactive 3D scenes using Three.js.
+ */
+import {
+  RESOURCE_MIME_TYPE,
+  registerAppResource,
+  registerAppTool,
+} from "@modelcontextprotocol/ext-apps/server";
+import { McpServer } from "@modelcontextprotocol/sdk/server/mcp.js";
+import { StdioServerTransport } from "@modelcontextprotocol/sdk/server/stdio.js";
+import type { ReadResourceResult } from "@modelcontextprotocol/sdk/types.js";
+import fs from "node:fs/promises";
+import path from "node:path";
+import { z } from "zod";
+import { startServer } from "./server-utils.js";
+
+// =============================================================================
+// Constants
+// =============================================================================
+
+const DIST_DIR = path.join(import.meta.dirname, "dist");
+
+// Default code example for the Three.js widget
+const DEFAULT_THREEJS_CODE = `const scene = new THREE.Scene();
+const camera = new THREE.PerspectiveCamera(75, width / height, 0.1, 1000);
+const renderer = new THREE.WebGLRenderer({ canvas, antialias: true });
+renderer.setSize(width, height);
+renderer.setClearColor(0x1a1a2e);
+
+const cube = new THREE.Mesh(
+  new THREE.BoxGeometry(1, 1, 1),
+  new THREE.MeshStandardMaterial({ color: 0x00ff88 })
+);
+scene.add(cube);
+
+scene.add(new THREE.DirectionalLight(0xffffff, 1));
+scene.add(new THREE.AmbientLight(0x404040));
+
+camera.position.z = 3;
+
+function animate() {
+  requestAnimationFrame(animate);
+  cube.rotation.x += 0.01;
+  cube.rotation.y += 0.01;
+  renderer.render(scene, camera);
+}
+animate();`;
+
+const THREEJS_DOCUMENTATION = `# Three.js Widget Documentation
+
+## Available Globals
+- \`THREE\` - Three.js library (r181)
+- \`canvas\` - Pre-created canvas element
+- \`width\`, \`height\` - Canvas dimensions in pixels
+- \`OrbitControls\` - Interactive camera controls
+- \`EffectComposer\`, \`RenderPass\`, \`UnrealBloomPass\` - Post-processing effects
+
+## Basic Template
+\`\`\`javascript
+const scene = new THREE.Scene();
+const camera = new THREE.PerspectiveCamera(75, width / height, 0.1, 1000);
+const renderer = new THREE.WebGLRenderer({ canvas, antialias: true });
+renderer.setSize(width, height);
+renderer.setClearColor(0x1a1a2e);  // Dark background
+
+// Add objects here...
+
+camera.position.z = 5;
+renderer.render(scene, camera);  // Static render
+\`\`\`
+
+## Example: Rotating Cube with Lighting
+\`\`\`javascript
+const scene = new THREE.Scene();
+const camera = new THREE.PerspectiveCamera(75, width / height, 0.1, 1000);
+const renderer = new THREE.WebGLRenderer({ canvas, antialias: true });
+renderer.setSize(width, height);
+renderer.setClearColor(0x1a1a2e);
+
+const cube = new THREE.Mesh(
+  new THREE.BoxGeometry(1, 1, 1),
+  new THREE.MeshStandardMaterial({ color: 0x00ff88 })
+);
+scene.add(cube);
+
+// Lighting - keep intensity at 1 or below
+scene.add(new THREE.DirectionalLight(0xffffff, 1));
+scene.add(new THREE.AmbientLight(0x404040));
+
+camera.position.z = 3;
+
+function animate() {
+  requestAnimationFrame(animate);
+  cube.rotation.x += 0.01;
+  cube.rotation.y += 0.01;
+  renderer.render(scene, camera);
+}
+animate();
+\`\`\`
+
+## Example: Interactive OrbitControls
+\`\`\`javascript
+const scene = new THREE.Scene();
+const camera = new THREE.PerspectiveCamera(75, width / height, 0.1, 1000);
+const renderer = new THREE.WebGLRenderer({ canvas, antialias: true });
+renderer.setSize(width, height);
+renderer.setClearColor(0x2d2d44);
+
+const controls = new OrbitControls(camera, renderer.domElement);
+controls.enableDamping = true;
+
+const sphere = new THREE.Mesh(
+  new THREE.SphereGeometry(1, 32, 32),
+  new THREE.MeshStandardMaterial({ color: 0xff6b6b, roughness: 0.4 })
+);
+scene.add(sphere);
+
+scene.add(new THREE.DirectionalLight(0xffffff, 1));
+scene.add(new THREE.AmbientLight(0x404040));
+
+camera.position.z = 4;
+
+function animate() {
+  requestAnimationFrame(animate);
+  controls.update();
+  renderer.render(scene, camera);
+}
+animate();
+\`\`\`
+
+## Tips
+- Always set \`renderer.setClearColor()\` to a dark color
+- Keep light intensity ≤ 1 to avoid washed-out scenes
+- Use \`MeshStandardMaterial\` for realistic lighting
+- For animations, use \`requestAnimationFrame\`
+`;
+
+const resourceUri = "ui://threejs/mcp-app.html";
+
+// =============================================================================
+// Server Setup
+// =============================================================================
+
+/**
+ * Creates a new MCP server instance with tools and resources registered.
+ * Each HTTP session needs its own server instance because McpServer only supports one transport.
+ */
+export function createServer(): McpServer {
+  const server = new McpServer({
+    name: "Three.js Server",
+    version: "1.0.0",
+  });
+
+  // Tool 1: show_threejs_scene
+  registerAppTool(
+    server,
+    "show_threejs_scene",
+    {
+      title: "Show Three.js Scene",
+      description:
+        "Render an interactive 3D scene with custom Three.js code. Available globals: THREE, OrbitControls, EffectComposer, RenderPass, UnrealBloomPass, canvas, width, height.",
+      inputSchema: {
+        code: z
+          .string()
+          .default(DEFAULT_THREEJS_CODE)
+          .describe("JavaScript code to render the 3D scene"),
+        height: z
+          .number()
+          .int()
+          .positive()
+          .default(400)
+          .describe("Height in pixels"),
+      },
+      outputSchema: z.object({
+        code: z.string(),
+        height: z.number(),
+      }),
+      _meta: { ui: { resourceUri } },
+    },
+    async ({ code, height }) => {
+      const data = { code, height };
+      return {
+        content: [{ type: "text", text: JSON.stringify(data) }],
+        structuredContent: data,
+      };
+    },
+  );
+
+  // Tool 2: learn_threejs (not a UI tool, just returns documentation)
+  server.registerTool(
+    "learn_threejs",
+    {
+      title: "Learn Three.js",
+      description:
+        "Get documentation and examples for using the Three.js widget",
+      inputSchema: {},
+    },
+    async () => {
+      return {
+        content: [{ type: "text", text: THREEJS_DOCUMENTATION }],
+      };
+    },
+  );
+
+  // Resource registration
+  registerAppResource(
+    server,
+    resourceUri,
+    resourceUri,
+    { mimeType: RESOURCE_MIME_TYPE, description: "Three.js Widget UI" },
+    async (): Promise<ReadResourceResult> => {
+      const html = await fs.readFile(
+        path.join(DIST_DIR, "mcp-app.html"),
+        "utf-8",
+      );
+
+      return {
+        contents: [
+          {
+            uri: resourceUri,
+            mimeType: RESOURCE_MIME_TYPE,
+            text: html,
+          },
+        ],
+      };
+    },
+  );
+
+  return server;
+}
+
+async function main() {
+  if (process.argv.includes("--stdio")) {
+    await createServer().connect(new StdioServerTransport());
+  } else {
+    const port = parseInt(process.env.PORT ?? "3108", 10);
+    await startServer(createServer, { port, name: "Three.js Server" });
+  }
+}
+
+main().catch((e) => {
+  console.error(e);
+  process.exit(1);
+});
diff --git a/apps/mcp/src/global.css b/apps/mcp/src/global.css
new file mode 100644
index 0000000..22aaaef
--- /dev/null
+++ b/apps/mcp/src/global.css
@@ -0,0 +1,43 @@
+* {
+  box-sizing: border-box;
+}
+
+html, body {
+  font-family: system-ui, -apple-system, sans-serif;
+  font-size: 1rem;
+  margin: 0;
+  padding: 0;
+  background: #1a1a2e;
+}
+
+.loading {
+  display: flex;
+  align-items: center;
+  justify-content: center;
+  height: 400px;
+  color: #888;
+  font-size: 14px;
+}
+
+.error {
+  padding: 20px;
+  color: #ff6b6b;
+}
+
+.threejs-container {
+  width: 100%;
+  position: relative;
+}
+
+.error-overlay {
+  position: absolute;
+  inset: 0;
+  display: flex;
+  align-items: center;
+  justify-content: center;
+  color: #ff6b6b;
+  background: rgba(26, 26, 46, 0.9);
+  border-radius: 8px;
+  font-family: system-ui;
+  padding: 20px;
+}
diff --git a/apps/mcp/src/mcp-app-wrapper.tsx b/apps/mcp/src/mcp-app-wrapper.tsx
new file mode 100644
index 0000000..fe94721
--- /dev/null
+++ b/apps/mcp/src/mcp-app-wrapper.tsx
@@ -0,0 +1,135 @@
+/**
+ * Three.js Widget - MCP App Wrapper
+ *
+ * Generic wrapper that handles MCP App connection and passes all relevant
+ * props to the actual widget component.
+ */
+import type { App, McpUiHostContext } from "@modelcontextprotocol/ext-apps";
+import { useApp } from "@modelcontextprotocol/ext-apps/react";
+import type { CallToolResult } from "@modelcontextprotocol/sdk/types.js";
+import { StrictMode, useState, useCallback, useEffect } from "react";
+import { createRoot } from "react-dom/client";
+import ThreeJSApp from "./threejs-app.tsx";
+import "./global.css";
+
+// =============================================================================
+// Types
+// =============================================================================
+
+/**
+ * Props passed to the widget component.
+ * This interface can be reused for other widgets.
+ */
+export interface WidgetProps<TToolInput = Record<string, unknown>> {
+  /** Complete tool input (after streaming finishes) */
+  toolInputs: TToolInput | null;
+  /** Partial tool input (during streaming) */
+  toolInputsPartial: TToolInput | null;
+  /** Tool execution result from the server */
+  toolResult: CallToolResult | null;
+  /** Host context (theme, dimensions, locale, etc.) */
+  hostContext: McpUiHostContext | null;
+  /** Call a tool on the MCP server */
+  callServerTool: App["callServerTool"];
+  /** Send a message to the host's chat */
+  sendMessage: App["sendMessage"];
+  /** Request the host to open a URL */
+  openLink: App["openLink"];
+  /** Send log messages to the host */
+  sendLog: App["sendLog"];
+}
+
+// =============================================================================
+// MCP App Wrapper
+// =============================================================================
+
+function McpAppWrapper() {
+  const [toolInputs, setToolInputs] = useState<Record<string, unknown> | null>(
+    null,
+  );
+  const [toolInputsPartial, setToolInputsPartial] = useState<Record<
+    string,
+    unknown
+  > | null>(null);
+  const [toolResult, setToolResult] = useState<CallToolResult | null>(null);
+  const [hostContext, setHostContext] = useState<McpUiHostContext | null>(null);
+
+  const { app, error } = useApp({
+    appInfo: { name: "Three.js Widget", version: "1.0.0" },
+    capabilities: {},
+    onAppCreated: (app) => {
+      // Complete tool input (streaming finished)
+      app.ontoolinput = (params) => {
+        setToolInputs(params.arguments as Record<string, unknown>);
+        setToolInputsPartial(null);
+      };
+      // Partial tool input (streaming in progress)
+      app.ontoolinputpartial = (params) => {
+        setToolInputsPartial(params.arguments as Record<string, unknown>);
+      };
+      // Tool execution result
+      app.ontoolresult = (params) => {
+        setToolResult(params as CallToolResult);
+      };
+      // Host context changes (theme, dimensions, etc.)
+      app.onhostcontextchanged = (params) => {
+        setHostContext((prev) => ({ ...prev, ...params }));
+      };
+    },
+  });
+
+  // Get initial host context after connection
+  useEffect(() => {
+    if (app) {
+      const ctx = app.getHostContext();
+      if (ctx) {
+        setHostContext(ctx);
+      }
+    }
+  }, [app]);
+
+  // Memoized callbacks that forward to app methods
+  const callServerTool = useCallback<App["callServerTool"]>(
+    (params, options) => app!.callServerTool(params, options),
+    [app],
+  );
+  const sendMessage = useCallback<App["sendMessage"]>(
+    (params, options) => app!.sendMessage(params, options),
+    [app],
+  );
+  const openLink = useCallback<App["openLink"]>(
+    (params, options) => app!.openLink(params, options),
+    [app],
+  );
+  const sendLog = useCallback<App["sendLog"]>(
+    (params) => app!.sendLog(params),
+    [app],
+  );
+
+  if (error) {
+    return <div className="error">Error: {error.message}</div>;
+  }
+
+  if (!app) {
+    return <div className="loading">Connecting...</div>;
+  }
+
+  return (
+    <ThreeJSApp
+      toolInputs={toolInputs}
+      toolInputsPartial={toolInputsPartial}
+      toolResult={toolResult}
+      hostContext={hostContext}
+      callServerTool={callServerTool}
+      sendMessage={sendMessage}
+      openLink={openLink}
+      sendLog={sendLog}
+    />
+  );
+}
+
+createRoot(document.getElementById("root")!).render(
+  <StrictMode>
+    <McpAppWrapper />
+  </StrictMode>,
+);
diff --git a/apps/mcp/src/threejs-app.tsx b/apps/mcp/src/threejs-app.tsx
new file mode 100644
index 0000000..e6b773e
--- /dev/null
+++ b/apps/mcp/src/threejs-app.tsx
@@ -0,0 +1,232 @@
+/**
+ * Three.js App Component
+ *
+ * Renders interactive 3D scenes using Three.js with streaming code preview.
+ * Receives all MCP App props from the wrapper.
+ */
+import { useState, useEffect, useRef } from "react";
+import * as THREE from "three";
+import { OrbitControls } from "three/examples/jsm/controls/OrbitControls.js";
+import { EffectComposer } from "three/examples/jsm/postprocessing/EffectComposer.js";
+import { RenderPass } from "three/examples/jsm/postprocessing/RenderPass.js";
+import { UnrealBloomPass } from "three/examples/jsm/postprocessing/UnrealBloomPass.js";
+import type { WidgetProps } from "./mcp-app-wrapper.tsx";
+
+// =============================================================================
+// Types
+// =============================================================================
+
+interface ThreeJSToolInput {
+  code?: string;
+  height?: number;
+}
+
+type ThreeJSAppProps = WidgetProps<ThreeJSToolInput>;
+
+// =============================================================================
+// Constants
+// =============================================================================
+
+// Default demo code shown when no code is provided
+const DEFAULT_THREEJS_CODE = `const scene = new THREE.Scene();
+const camera = new THREE.PerspectiveCamera(75, width / height, 0.1, 1000);
+const renderer = new THREE.WebGLRenderer({ canvas, antialias: true });
+renderer.setSize(width, height);
+renderer.setClearColor(0x1a1a2e);
+
+const cube = new THREE.Mesh(
+  new THREE.BoxGeometry(1, 1, 1),
+  new THREE.MeshStandardMaterial({ color: 0x00ff88 })
+);
+// Start with an isometric-ish rotation to show 3 faces
+cube.rotation.x = 0.5;
+cube.rotation.y = 0.7;
+scene.add(cube);
+
+// Better lighting: key light + fill light + ambient
+const keyLight = new THREE.DirectionalLight(0xffffff, 1.2);
+keyLight.position.set(1, 1, 2);
+scene.add(keyLight);
+const fillLight = new THREE.DirectionalLight(0x8888ff, 0.4);
+fillLight.position.set(-1, 0, -1);
+scene.add(fillLight);
+scene.add(new THREE.AmbientLight(0x404040, 0.5));
+
+camera.position.z = 3;
+
+function animate() {
+  requestAnimationFrame(animate);
+  cube.rotation.x += 0.01;
+  cube.rotation.y += 0.01;
+  renderer.render(scene, camera);
+}
+animate();`;
+
+// =============================================================================
+// Streaming Preview
+// =============================================================================
+
+const SHIMMER_STYLE = `
+  @keyframes shimmer {
+    0% { background-position: 200% 0; }
+    100% { background-position: -200% 0; }
+  }
+`;
+
+function LoadingShimmer({ height, code }: { height: number; code?: string }) {
+  const preRef = useRef<HTMLPreElement>(null);
+
+  useEffect(() => {
+    if (preRef.current) preRef.current.scrollTop = preRef.current.scrollHeight;
+  }, [code]);
+
+  return (
+    <div
+      style={{
+        width: "100%",
+        height,
+        borderRadius: 8,
+        padding: 16,
+        boxSizing: "border-box",
+        display: "flex",
+        flexDirection: "column",
+        overflow: "hidden",
+        background:
+          "linear-gradient(90deg, #1a1a2e 25%, #2d2d44 50%, #1a1a2e 75%)",
+        backgroundSize: "200% 100%",
+        animation: "shimmer 1.5s ease-in-out infinite",
+      }}
+    >
+      <style>{SHIMMER_STYLE}</style>
+      <div
+        style={{
+          color: "#888",
+          fontFamily: "system-ui",
+          fontSize: 12,
+          marginBottom: 8,
+        }}
+      >
+        🎮 Three.js
+      </div>
+      {code && (
+        <pre
+          ref={preRef}
+          style={{
+            margin: 0,
+            padding: 0,
+            flex: 1,
+            overflow: "auto",
+            color: "#aaa",
+            fontFamily: "monospace",
+            fontSize: 11,
+            lineHeight: 1.4,
+            whiteSpace: "pre-wrap",
+            wordBreak: "break-word",
+          }}
+        >
+          {code}
+        </pre>
+      )}
+    </div>
+  );
+}
+
+// =============================================================================
+// Three.js Execution
+// =============================================================================
+
+const threeContext = {
+  THREE,
+  OrbitControls,
+  EffectComposer,
+  RenderPass,
+  UnrealBloomPass,
+};
+
+async function executeThreeCode(
+  code: string,
+  canvas: HTMLCanvasElement,
+  width: number,
+  height: number,
+): Promise<void> {
+  const fn = new Function(
+    "ctx",
+    "canvas",
+    "width",
+    "height",
+    `const { THREE, OrbitControls, EffectComposer, RenderPass, UnrealBloomPass } = ctx;
+     return (async () => { ${code} })();`,
+  );
+  await fn(threeContext, canvas, width, height);
+}
+
+// =============================================================================
+// Main Component
+// =============================================================================
+
+export default function ThreeJSApp({
+  toolInputs,
+  toolInputsPartial,
+  toolResult: _toolResult,
+  hostContext,
+  callServerTool: _callServerTool,
+  sendMessage: _sendMessage,
+  openLink: _openLink,
+  sendLog: _sendLog,
+}: ThreeJSAppProps) {
+  const [error, setError] = useState<string | null>(null);
+  const canvasRef = useRef<HTMLCanvasElement>(null);
+  const containerRef = useRef<HTMLDivElement>(null);
+
+  const height = toolInputs?.height ?? toolInputsPartial?.height ?? 400;
+  const code = toolInputs?.code || DEFAULT_THREEJS_CODE;
+  const partialCode = toolInputsPartial?.code;
+  const isStreaming = !toolInputs && !!toolInputsPartial;
+
+  const safeAreaInsets = hostContext?.safeAreaInsets;
+  const containerStyle = {
+    paddingTop: safeAreaInsets?.top,
+    paddingRight: safeAreaInsets?.right,
+    paddingBottom: safeAreaInsets?.bottom,
+    paddingLeft: safeAreaInsets?.left,
+  };
+
+  useEffect(() => {
+    if (!code || !canvasRef.current || !containerRef.current) return;
+
+    setError(null);
+    const width = containerRef.current.offsetWidth || 800;
+    executeThreeCode(code, canvasRef.current, width, height).catch((e) =>
+      setError(e instanceof Error ? e.message : "Unknown error"),
+    );
+  }, [code, height]);
+
+  if (isStreaming || !code) {
+    return (
+      <div style={containerStyle}>
+        <LoadingShimmer height={height} code={partialCode} />
+      </div>
+    );
+  }
+
+  return (
+    <div
+      ref={containerRef}
+      className="threejs-container"
+      style={containerStyle}
+    >
+      <canvas
+        id="threejs-canvas"
+        ref={canvasRef}
+        style={{
+          width: "100%",
+          height,
+          borderRadius: 8,
+          display: "block",
+          background: "#1a1a2e",
+        }}
+      />
+      {error && <div className="error-overlay">Error: {error}</div>}
+    </div>
+  );
+}
diff --git a/apps/mcp/test-input.json b/apps/mcp/test-input.json
new file mode 100644
index 0000000..54eef27
--- /dev/null
+++ b/apps/mcp/test-input.json
@@ -0,0 +1,3 @@
+{
+  "code": "const scene = new THREE.Scene(); const camera = new THREE.PerspectiveCamera(60, width/height, 0.1, 100); camera.position.set(2, 2, 2); camera.lookAt(0, 0.5, 0); const renderer = new THREE.WebGLRenderer({canvas, antialias: true}); renderer.setSize(width, height); renderer.shadowMap.enabled = true; const cube = new THREE.Mesh(new THREE.BoxGeometry(), new THREE.MeshStandardMaterial({color: 0xff4444})); cube.castShadow = true; cube.position.y = 0.5; scene.add(cube); const floor = new THREE.Mesh(new THREE.PlaneGeometry(5,5), new THREE.MeshStandardMaterial({color: 0x222233})); floor.rotation.x = -Math.PI/2; floor.receiveShadow = true; scene.add(floor); const light = new THREE.DirectionalLight(0xffffff, 2); light.position.set(3, 5, 3); light.castShadow = true; scene.add(light); scene.add(new THREE.AmbientLight(0x404040)); function animate() { requestAnimationFrame(animate); cube.rotation.y += 0.01; renderer.render(scene, camera); } animate();"
+}
diff --git a/apps/mcp/tsconfig.json b/apps/mcp/tsconfig.json
new file mode 100644
index 0000000..fc3c210
--- /dev/null
+++ b/apps/mcp/tsconfig.json
@@ -0,0 +1,20 @@
+{
+  "compilerOptions": {
+    "target": "ESNext",
+    "lib": ["ESNext", "DOM", "DOM.Iterable"],
+    "module": "ESNext",
+    "moduleResolution": "bundler",
+    "allowImportingTsExtensions": true,
+    "resolveJsonModule": true,
+    "isolatedModules": true,
+    "verbatimModuleSyntax": true,
+    "noEmit": true,
+    "jsx": "react-jsx",
+    "strict": true,
+    "skipLibCheck": true,
+    "noUnusedLocals": true,
+    "noUnusedParameters": true,
+    "noFallthroughCasesInSwitch": true
+  },
+  "include": ["src", "server.ts"]
+}
diff --git a/apps/mcp/vite.config.ts b/apps/mcp/vite.config.ts
new file mode 100644
index 0000000..da0af84
--- /dev/null
+++ b/apps/mcp/vite.config.ts
@@ -0,0 +1,25 @@
+import { defineConfig } from "vite";
+import react from "@vitejs/plugin-react";
+import { viteSingleFile } from "vite-plugin-singlefile";
+
+const INPUT = process.env.INPUT;
+if (!INPUT) {
+  throw new Error("INPUT environment variable is not set");
+}
+
+const isDevelopment = process.env.NODE_ENV === "development";
+
+export default defineConfig({
+  plugins: [react(), viteSingleFile()],
+  build: {
+    sourcemap: isDevelopment ? "inline" : undefined,
+    cssMinify: !isDevelopment,
+    minify: !isDevelopment,
+
+    rollupOptions: {
+      input: INPUT,
+    },
+    outDir: "dist",
+    emptyOutDir: false,
+  },
+});
diff --git a/package.json b/package.json
index 6198dfd..3c9e376 100644
--- a/package.json
+++ b/package.json
@@ -1,38 +1,23 @@
 {
-  "name": "langgraph-python-starter",
-  "version": "0.1.0",
+  "name": "copilotkit-langgraph-template",
   "private": true,
   "scripts": {
-    "dev": "concurrently \"npm run dev:ui\" \"npm run dev:agent\" --names ui,agent --prefix-colors blue,green --kill-others",
-    "dev:debug": "LOG_LEVEL=debug npm run dev",
-    "dev:agent": "cd agent && npx @langchain/langgraph-cli dev --port 8123 --no-browser",
-    "dev:ui": "next dev --turbopack",
-    "build": "next build",
-    "start": "next start",
-    "lint": "eslint .",
-    "install:agent": "sh ./scripts/setup-agent.sh || scripts\\setup-agent.bat",
-    "postinstall": "npm run install:agent"
-  },
-  "dependencies": {
-    "@copilotkit/react-core": "1.51.0",
-    "@copilotkit/react-ui": "1.51.0",
-    "@copilotkit/runtime": "1.51.0",
-    "next": "16.1.1",
-    "react": "^19.2.3",
-    "react-dom": "^19.2.3",
-    "react18-json-view": "^0.2.9"
+    "dev": "turbo run dev",
+    "dev:app": "turbo run dev --filter='app'",
+    "dev:agent": "turbo run dev --filter='agent'",
+    "dev:mcp": "turbo run dev --filter='mcp'",
+    "build": "turbo run build",
+    "lint": "turbo run lint",
+    "clean": "turbo run clean"
   },
   "devDependencies": {
-    "@eslint/eslintrc": "^3",
-    "@langchain/langgraph-cli": "^1.0.4",
-    "@tailwindcss/postcss": "^4",
-    "@types/node": "^20",
-    "@types/react": "^19",
-    "@types/react-dom": "^19",
-    "concurrently": "^9.1.2",
-    "eslint": "^9",
-    "eslint-config-next": "16.1.1",
-    "tailwindcss": "^4",
-    "typescript": "^5"
+    "turbo": "^2.5.4",
+    "concurrently": "^9.1.2"
+  },
+  "packageManager": "pnpm@9.0.0",
+  "pnpm": {
+    "overrides": {
+      "esbuild": "^0.27.3"
+    }
   }
 }
diff --git a/pnpm-workspace.yaml b/pnpm-workspace.yaml
new file mode 100644
index 0000000..cca881f
--- /dev/null
+++ b/pnpm-workspace.yaml
@@ -0,0 +1,4 @@
+packages:
+  - "apps/app"
+  - "apps/agent"
+  - "apps/mcp"
diff --git a/scripts/setup-agent.bat b/scripts/setup-agent.bat
deleted file mode 100644
index 6556e56..0000000
--- a/scripts/setup-agent.bat
+++ /dev/null
@@ -1,6 +0,0 @@
-@echo off
-REM Navigate to the agent directory
-cd /d "%~dp0\..\agent" || exit /b 1
-
-REM Install dependencies using uv
-uv sync 
\ No newline at end of file
diff --git a/scripts/setup-agent.sh b/scripts/setup-agent.sh
deleted file mode 100755
index 8b68a46..0000000
--- a/scripts/setup-agent.sh
+++ /dev/null
@@ -1,7 +0,0 @@
-#!/bin/bash
-
-# Navigate to the agent directory
-cd "$(dirname "$0")/../agent" || exit 1
-
-# Install dependencies using uv
-uv sync
diff --git a/src/app/api/copilotkit/route.ts b/src/app/api/copilotkit/route.ts
deleted file mode 100644
index ab33e70..0000000
--- a/src/app/api/copilotkit/route.ts
+++ /dev/null
@@ -1,35 +0,0 @@
-import {
-  CopilotRuntime,
-  ExperimentalEmptyAdapter,
-  copilotRuntimeNextJSAppRouterEndpoint,
-} from "@copilotkit/runtime";
-import { LangGraphAgent } from "@copilotkit/runtime/langgraph";
-import { NextRequest } from "next/server";
-
-// 1. You can use any service adapter here for multi-agent support. We use
-//    the empty adapter since we're only using one agent.
-const serviceAdapter = new ExperimentalEmptyAdapter();
-
-// 2. Create the CopilotRuntime instance and utilize the LangGraph AG-UI
-//    integration to setup the connection.
-const runtime = new CopilotRuntime({
-  agents: {
-    sample_agent: new LangGraphAgent({
-      deploymentUrl:
-        process.env.LANGGRAPH_DEPLOYMENT_URL || "http://localhost:8123",
-      graphId: "sample_agent",
-      langsmithApiKey: process.env.LANGSMITH_API_KEY || "",
-    }),
-  },
-});
-
-// 3. Build a Next.js API route that handles the CopilotKit runtime requests.
-export const POST = async (req: NextRequest) => {
-  const { handleRequest } = copilotRuntimeNextJSAppRouterEndpoint({
-    runtime,
-    serviceAdapter,
-    endpoint: "/api/copilotkit",
-  });
-
-  return handleRequest(req);
-};
diff --git a/src/app/layout.tsx b/src/app/layout.tsx
deleted file mode 100644
index f7bf02b..0000000
--- a/src/app/layout.tsx
+++ /dev/null
@@ -1,26 +0,0 @@
-import type { Metadata } from "next";
-
-import { CopilotKit } from "@copilotkit/react-core";
-import "./globals.css";
-import "@copilotkit/react-ui/styles.css";
-
-export const metadata: Metadata = {
-  title: "Create Next App",
-  description: "Generated by create next app",
-};
-
-export default function RootLayout({
-  children,
-}: Readonly<{
-  children: React.ReactNode;
-}>) {
-  return (
-    <html lang="en">
-      <body className={"antialiased"}>
-        <CopilotKit runtimeUrl="/api/copilotkit" agent="sample_agent" showDevConsole={false}>
-          {children}
-        </CopilotKit>
-      </body>
-    </html>
-  );
-}
diff --git a/src/app/page.tsx b/src/app/page.tsx
deleted file mode 100644
index 8cedd97..0000000
--- a/src/app/page.tsx
+++ /dev/null
@@ -1,154 +0,0 @@
-"use client";
-
-import { ProverbsCard } from "@/components/proverbs";
-import { WeatherCard } from "@/components/weather";
-import { MoonCard } from "@/components/moon";
-import { AgentState } from "@/lib/types";
-import {
-  useCoAgent,
-  useDefaultTool,
-  useFrontendTool,
-  useHumanInTheLoop,
-  useLangGraphInterrupt,
-  useRenderToolCall,
-} from "@copilotkit/react-core";
-import { CopilotKitCSSProperties, CopilotSidebar } from "@copilotkit/react-ui";
-import { useState } from "react";
-
-export default function CopilotKitPage() {
-  const [themeColor, setThemeColor] = useState("#6366f1");
-
-  // 🪁 Frontend Actions: https://docs.copilotkit.ai/pydantic-ai/frontend-actions
-  useFrontendTool({
-    name: "setThemeColor",
-    parameters: [
-      {
-        name: "themeColor",
-        description: "The theme color to set. Make sure to pick nice colors.",
-        required: true,
-      },
-    ],
-    handler({ themeColor }) {
-      setThemeColor(themeColor);
-    },
-  });
-
-  return (
-    <main
-      style={
-        { "--copilot-kit-primary-color": themeColor } as CopilotKitCSSProperties
-      }
-    >
-      <CopilotSidebar
-        disableSystemMessage={true}
-        clickOutsideToClose={false}
-        labels={{
-          title: "Popup Assistant",
-          initial: "👋 Hi, there! You're chatting with an agent.",
-        }}
-        suggestions={[
-          {
-            title: "Generative UI",
-            message: "Get the weather in San Francisco.",
-          },
-          {
-            title: "Frontend Tools",
-            message: "Set the theme to green.",
-          },
-          {
-            title: "Human In the Loop",
-            message: "Please go to the moon.",
-          },
-          {
-            title: "Write Agent State",
-            message: "Add a proverb about AI.",
-          },
-          {
-            title: "Update Agent State",
-            message:
-              "Please remove 1 random proverb from the list if there are any.",
-          },
-          {
-            title: "Read Agent State",
-            message: "What are the proverbs?",
-          },
-        ]}
-      >
-        <YourMainContent themeColor={themeColor} />
-      </CopilotSidebar>
-    </main>
-  );
-}
-
-function YourMainContent({ themeColor }: { themeColor: string }) {
-  // 🪁 Shared State: https://docs.copilotkit.ai/pydantic-ai/shared-state
-  const { state, setState } = useCoAgent({
-    name: "sample_agent",
-  });
-
-  // 🪁 Frontend Actions: https://docs.copilotkit.ai/coagents/frontend-actions
-  useFrontendTool({
-    name: "updateProverbs",
-    description: "Update the list of proverbs. Always describe what the proverbs you added are.",
-    parameters: [
-      {
-        name: "proverbs",
-        description: "What the current list of proverbs should be updated to",
-        type: "string[]",
-        required: true,
-      },
-    ],
-    handler: ({ proverbs }) => {
-      setState({
-        ...state,
-        proverbs: proverbs,
-      });
-    },
-  });
-
-  //🪁 Generative UI: https://docs.copilotkit.ai/pydantic-ai/generative-ui
-  useRenderToolCall(
-    {
-      name: "get_weather",
-      description: "Get the weather for a given location.",
-      parameters: [{ name: "location", type: "string", required: true }],
-      render: ({ args }) => {
-        return <WeatherCard location={args.location} themeColor={themeColor} />;
-      },
-    },
-    [themeColor],
-  );
-
-  useDefaultTool({
-    render: ({ name, status }) => {
-      const textStyles = "text-gray-500 text-sm mt-2"
-      if(status !== "complete") {
-        return <p className={textStyles}>Calling {name}...</p>;
-      }
-      return <p className={textStyles}>Called {name}!</p>;
-    },
-  })
-
-  // 🪁 Human In the Loop: https://docs.copilotkit.ai/pydantic-ai/human-in-the-loop
-  useHumanInTheLoop(
-    {
-      name: "go_to_moon",
-      description: "Go to the moon on request.",
-      render: ({ respond, status }) => {
-        return (
-          <MoonCard themeColor={themeColor} status={status} respond={respond} />
-        );
-      },
-    },
-    [themeColor],
-  );
-
-  return (
-    <div
-      style={{ backgroundColor: themeColor }}
-      className="h-screen flex justify-center items-center flex-col transition-colors duration-300"
-    >
-      <ProverbsCard state={state} setState={setState} />
-    </div>
-  );
-}
diff --git a/src/components/moon.tsx b/src/components/moon.tsx
deleted file mode 100644
index 0056c30..0000000
--- a/src/components/moon.tsx
+++ /dev/null
@@ -1,88 +0,0 @@
-import { useState } from "react";
-
-export interface MoonCardProps {
-  themeColor: string;
-  status: "inProgress" | "executing" | "complete";
-  respond?: (response: string) => void;
-}
-
-export function MoonCard({ themeColor, status, respond }: MoonCardProps) {
-  const [decision, setDecision] = useState<"launched" | "aborted" | null>(null);
-
-  const handleLaunch = () => {
-    setDecision("launched");
-    respond?.("You have permission to go to the moon.");
-  };
-
-  const handleAbort = () => {
-    setDecision("aborted");
-    respond?.("You do not have permission to go to the moon. The user you're talking to rejected the request.");
-  };
-
-  return (
-    <div
-      style={{ backgroundColor: themeColor }}
-      className="rounded-2xl shadow-xl max-w-md w-full mt-6"
-    >
-      <div className="bg-white/20 backdrop-blur-md p-8 w-full rounded-2xl">
-        {/* Show decision or prompt */}
-        {decision === "launched" ? (
-          <div className="text-center">
-            <div className="text-7xl mb-4">🌕</div>
-            <h2 className="text-2xl font-bold text-white mb-2">
-              Mission Launched
-            </h2>
-            <p className="text-white/90">
-              We made it to the moon! 
-            </p>
-          </div>
-        ) : decision === "aborted" ? (
-          <div className="text-center">
-            <div className="text-7xl mb-4">✋</div>
-            <h2 className="text-2xl font-bold text-white mb-2">
-              Mission Aborted
-            </h2>
-            <p className="text-white/90">
-              Staying on Earth 🌍
-            </p>
-          </div>
-        ) : (
-          <>
-            <div className="text-center mb-6">
-              <div className="text-7xl mb-4">🚀</div>
-              <h2 className="text-2xl font-bold text-white mb-2">
-                Ready for Launch?
-              </h2>
-              <p className="text-white/90">
-                Mission to the Moon 🌕
-              </p>
-            </div>
-            
-            {/* Launch Buttons */}
-            {status === "executing" && (
-              <div className="flex gap-3">
-                <button
-                  onClick={handleLaunch}
-                  className="flex-1 px-6 py-4 rounded-xl bg-white text-black font-bold 
-                    shadow-lg hover:shadow-xl transition-all 
-                    hover:scale-105 active:scale-95"
-                >
-                  🚀 Launch!
-                </button>
-                <button
-                  onClick={handleAbort}
-                  className="flex-1 px-6 py-4 rounded-xl bg-black/20 text-white font-bold 
-                    border-2 border-white/30 shadow-lg
-                    transition-all hover:scale-105 active:scale-95
-                    hover:bg-black/30"
-                >
-                  ✋ Abort
-                </button>
-              </div>
-            )}
-          </>
-        )}
-      </div>
-    </div>
-  );
-}
diff --git a/src/components/proverbs.tsx b/src/components/proverbs.tsx
deleted file mode 100644
index f539b48..0000000
--- a/src/components/proverbs.tsx
+++ /dev/null
@@ -1,18 +0,0 @@
-import JsonView from "react18-json-view";
-import 'react18-json-view/src/style.css'
-
-export interface ProverbsCardProps {
-  state: any;
-  setState: (state: any) => void;
-}
-
-export function ProverbsCard({ state, setState }: ProverbsCardProps) {
-  return (
-    <div className="bg-white/20 backdrop-blur-md p-8 rounded-2xl shadow-xl max-w-2xl w-full">
-      <h1 className="text-4xl font-bold text-white mb-2 text-center">Proverbs</h1>
-      <p className="text-gray-200 text-center italic mb-6">This is a demonstrative page, but it could be anything you want! 🪁</p>
-      <hr className="border-white/20 my-6" />
-      <JsonView src={state} className="w-full bg-white p-4 rounded-2xl h-[500px] overflow-y-scroll" collapseObjectsAfterLength={1}/>
-    </div>
-  );
-}
\ No newline at end of file
diff --git a/src/components/weather.tsx b/src/components/weather.tsx
deleted file mode 100644
index b30320d..0000000
--- a/src/components/weather.tsx
+++ /dev/null
@@ -1,53 +0,0 @@
-
-// Simple sun icon for the weather card
-function SunIcon() {
-  return (
-    <svg xmlns="http://www.w3.org/2000/svg" viewBox="0 0 24 24" fill="currentColor" className="w-14 h-14 text-yellow-200">
-      <circle cx="12" cy="12" r="5" />
-      <path d="M12 1v2M12 21v2M4.22 4.22l1.42 1.42M18.36 18.36l1.42 1.42M1 12h2M21 12h2M4.22 19.78l1.42-1.42M18.36 5.64l1.42-1.42" strokeWidth="2" stroke="currentColor" />
-    </svg>
-  );
-}
-
-// Weather card component where the location and themeColor are based on what the agent
-// sets via tool calls.
-export function WeatherCard({ location, themeColor }: { location?: string, themeColor: string }) {
-  return (
-    <div
-    style={{ backgroundColor: themeColor }}
-    className="rounded-xl shadow-xl mt-6 mb-4 max-w-md w-full"
-  >
-    <div className="bg-white/20 p-4 w-full">
-      <div className="flex items-center justify-between">
-        <div>
-          <h3 className="text-xl font-bold text-white capitalize">{location}</h3>
-          <p className="text-white">Current Weather</p>
-        </div>
-        <SunIcon />
-      </div>
-      
-      <div className="mt-4 flex items-end justify-between">
-        <div className="text-3xl font-bold text-white">70°</div>
-        <div className="text-sm text-white">Clear skies</div>
-      </div>
-      
-      <div className="mt-4 pt-4 border-t border-white">
-        <div className="grid grid-cols-3 gap-2 text-center">
-          <div>
-            <p className="text-white text-xs">Humidity</p>
-            <p className="text-white font-medium">45%</p>
-          </div>
-          <div>
-            <p className="text-white text-xs">Wind</p>
-            <p className="text-white font-medium">5 mph</p>
-          </div>
-          <div>
-            <p className="text-white text-xs">Feels Like</p>
-            <p className="text-white font-medium">72°</p>
-          </div>
-        </div>
-      </div>
-    </div>
-  </div>
-  );
-}
diff --git a/src/lib/types.ts b/src/lib/types.ts
deleted file mode 100644
index 1ba21b9..0000000
--- a/src/lib/types.ts
+++ /dev/null
@@ -1,4 +0,0 @@
-// State of the agent, make sure this aligns with your agent's state.
-export type AgentState = {
-  proverbs: string[];
-};
diff --git a/turbo.json b/turbo.json
new file mode 100644
index 0000000..32f16e8
--- /dev/null
+++ b/turbo.json
@@ -0,0 +1,18 @@
+{
+  "$schema": "https://turborepo.com/schema.json",
+  "ui": "tui",
+  "tasks": {
+    "dev": {
+      "cache": false,
+      "persistent": true
+    },
+    "build": {
+      "dependsOn": ["^build"],
+      "outputs": [".next/**", "!.next/cache/**", "dist/**"]
+    },
+    "lint": {},
+    "clean": {
+      "cache": false
+    }
+  }
+}