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

Author: tylerslaton

.env.example

@@ -0,0 +1 @@
+OPENAI_API_KEY=

.github/workflows/smoke.yml

@@ -15,8 +15,8 @@ jobs:
     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,8 +114,69 @@ jobs:
           }
         shell: pwsh
 
+      - name: Test agent startup (Linux/macOS)
+        if: runner.os != 'Windows'
+        run: |
+          # Start the LangGraph agent in background
+          pnpm --filter agent dev &
+          AGENT_PID=$!
+
+          # Wait for agent to start (max 30 seconds)
+          timeout=30
+          elapsed=0
+          started=false
+
+          while [ $elapsed -lt $timeout ] && [ "$started" = false ]; do
+            if curl -s http://localhost:8123 > /dev/null 2>&1; then
+              started=true
+              echo "✅ Agent started successfully"
+            else
+              sleep 1
+              elapsed=$((elapsed + 1))
+            fi
+          done
+
+          # Clean up background process
+          kill $AGENT_PID 2>/dev/null || true
+
+          if [ "$started" = false ]; then
+            echo "❌ Agent failed to start within 30 seconds"
+            exit 1
+          fi
+        shell: bash
+
+      - name: Test agent startup (Windows)
+        if: runner.os == 'Windows'
+        run: |
+          # Start the LangGraph agent in background
+          pnpm --filter agent dev &
+
+          # Wait for agent to start (max 30 seconds)
+          $timeout = 30
+          $elapsed = 0
+          $started = $false
+
+          while ($elapsed -lt $timeout -and -not $started) {
+            try {
+              $response = Invoke-WebRequest -Uri "http://localhost:8123" -TimeoutSec 1 -ErrorAction SilentlyContinue
+              if ($response.StatusCode -eq 200) {
+                $started = $true
+                Write-Host "✅ Agent started successfully"
+              }
+            } catch {
+              Start-Sleep -Seconds 1
+              $elapsed++
+            }
+          }
+
+          if (-not $started) {
+            Write-Host "❌ Agent failed to start within 30 seconds"
+            exit 1
+          }
+        shell: pwsh
+
       - name: Run linting
-        run: npm run lint
+        run: pnpm lint
 
   notify-slack:
     name: Notify Slack on Failure

.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