refactor!: restructure repo for v1.x and add v2.x (CopilotKit#2794)

- Move original CopilotKit/CopilotKit directory to src/v1.x
- Introduce new v2 interfaces in src/v2.x
- Align CI paths and preview environments to new layout

Signed-off-by: Tyler Slaton <tyler@copilotkit.ai>
Co-authored-by: Ran Shemtov <ran@copilotkit.ai>
Co-authored-by: Brandon McConnell <brandon@dreamthinkbuild.com>
Co-authored-by: Mike Ryan <mike.ryan52@gmail.com>

Author: 4 people

.cursor/rules/agent-development.mdc

@@ -23,7 +23,7 @@ Python agents are typically in folders named `agent-py/` or `agent/` and use the
 - **[langgraph-tutorial-quickstart/agent-py/](mdc:examples/langgraph-tutorial-quickstart/agent-py/)** - LangGraph integration
 
 ### JavaScript Agents
-JavaScript agents are in folders named `agent-js/` and use the [sdk-js/](mdc:CopilotKit/packages/sdk-js/) package.
+JavaScript agents are in folders named `agent-js/` and use the [sdk-js/](mdc:src/v1.x/packages/sdk-js/) package.
 
 #### JavaScript Agent Examples
 - **[coagents-starter/agent-js/](mdc:examples/coagents-starter/agent-js/)** - Basic JavaScript agent setup

.cursor/rules/copilotkit-architecture.mdc

@@ -6,18 +6,18 @@ alwaysApply: false
 # CopilotKit Architecture Overview
 
 ## Core Library Structure
-The main CopilotKit library is located in [CopilotKit/](mdc:CopilotKit/) with the following key packages:
+The main CopilotKit library is located in [CopilotKit/](mdc:src/v1.x/) with the following key packages:
 
 ### React Packages
-- **[react-core/](mdc:CopilotKit/packages/react-core/)** - Core React components and hooks for CopilotKit
-- **[react-textarea/](mdc:CopilotKit/packages/react-textarea/)** - Textarea component with AI integration
-- **[react-ui/](mdc:CopilotKit/packages/react-ui/)** - UI components for copilot interfaces
+- **[react-core/](mdc:src/v1.x/packages/react-core/)** - Core React components and hooks for CopilotKit
+- **[react-textarea/](mdc:src/v1.x/packages/react-textarea/)** - Textarea component with AI integration
+- **[react-ui/](mdc:src/v1.x/packages/react-ui/)** - UI components for copilot interfaces
 
 ### Runtime & SDK
-- **[runtime/](mdc:CopilotKit/packages/runtime/)** - Core runtime for executing copilot actions
-- **[runtime-client-gql/](mdc:CopilotKit/packages/runtime-client-gql/)** - GraphQL client for runtime communication
-- **[sdk-js/](mdc:CopilotKit/packages/sdk-js/)** - JavaScript SDK for backend integration
-- **[shared/](mdc:CopilotKit/packages/shared/)** - Shared utilities and types
+- **[runtime/](mdc:src/v1.x/packages/runtime/)** - Core runtime for executing copilot actions
+- **[runtime-client-gql/](mdc:src/v1.x/packages/runtime-client-gql/)** - GraphQL client for runtime communication
+- **[sdk-js/](mdc:src/v1.x/packages/sdk-js/)** - JavaScript SDK for backend integration
+- **[shared/](mdc:src/v1.x/packages/shared/)** - Shared utilities and types
 
 ### Python SDK
 - **[sdk-python/](mdc:sdk-python/)** - Python SDK with integrations for:
@@ -39,7 +39,7 @@ All examples are in [examples/](mdc:examples/) and typically follow this pattern
 
 ## Development Workflow
 - Examples use the local packages via workspace references
-- [package.json](mdc:CopilotKit/package.json) contains workspace configuration
-- Scripts in [scripts/](mdc:CopilotKit/scripts/) for development, testing, and releases
+- [package.json](mdc:src/v1.x/package.json) contains workspace configuration
+- Scripts in [scripts/](mdc:src/v1.x/scripts/) for development, testing, and releases
 
 

.cursor/rules/development-workflow.mdc

@@ -7,20 +7,20 @@ alwaysApply: false
 
 ## Workspace Setup
 CopilotKit uses a monorepo structure with:
-- **[CopilotKit/package.json](mdc:CopilotKit/package.json)** - Main workspace configuration
-- **[CopilotKit/packages/](mdc:CopilotKit/packages)** - Core library packages
+- **[src/v1.x/package.json](mdc:src/v1.x/package.json)** - Main workspace configuration
+- **[src/v1.x/packages/](mdc:src/v1.x/packages)** - Core library packages
 - **[examples/](mdc:examples)** - Example applications
 
 ## Development Scripts
-Located in [CopilotKit/scripts/](mdc:CopilotKit/scripts):
+Located in [src/v1.x/scripts/](mdc:src/v1.x/scripts):
 
 ### Development Scripts
-- **[develop/](mdc:CopilotKit/scripts/develop)** - Development environment setup
-- **[qa/](mdc:CopilotKit/scripts/qa)** - Quality assurance and testing scripts
-- **[release/](mdc:CopilotKit/scripts/release)** - Release automation scripts
+- **[develop/](mdc:src/v1.x/scripts/develop)** - Development environment setup
+- **[qa/](mdc:src/v1.x/scripts/qa)** - Quality assurance and testing scripts
+- **[release/](mdc:src/v1.x/scripts/release)** - Release automation scripts
 
 ### Documentation Scripts
-- **[docs/](mdc:CopilotKit/scripts/docs)** - Documentation generation and management
+- **[docs/](mdc:src/v1.x/scripts/docs)** - Documentation generation and management
 
 ## Package Management
 - Uses pnpm workspaces for package management
@@ -39,11 +39,11 @@ Located in [CopilotKit/scripts/](mdc:CopilotKit/scripts):
 - **[snippets/](mdc:docs/snippets)** - Code snippets for documentation
 
 ## Configuration Files
-- **[CopilotKit.code-workspace](mdc:CopilotKit/CopilotKit.code-workspace)** - VS Code workspace settings
-- **[utilities/](mdc:CopilotKit/utilities)** - Shared utilities:
-  - [eslint-config-custom/](mdc:CopilotKit/utilities/eslint-config-custom) - ESLint configuration
-  - [tailwind-config/](mdc:CopilotKit/utilities/tailwind-config) - Tailwind CSS configuration  
-  - [tsconfig/](mdc:CopilotKit/utilities/tsconfig) - TypeScript configurations
+- **[CopilotKit.code-workspace](mdc:src/v1.x/CopilotKit.code-workspace)** - VS Code workspace settings
+- **[utilities/](mdc:src/v1.x/utilities)** - Shared utilities:
+  - [eslint-config-custom/](mdc:src/v1.x/utilities/eslint-config-custom) - ESLint configuration
+  - [tailwind-config/](mdc:src/v1.x/utilities/tailwind-config) - Tailwind CSS configuration  
+  - [tsconfig/](mdc:src/v1.x/utilities/tsconfig) - TypeScript configurations
 
 ## Infrastructure
 - **[infra/](mdc:infra)** - AWS CDK infrastructure code

.cursor/rules/frontend-development.mdc

@@ -8,20 +8,20 @@ alwaysApply: false
 ## Core React Packages
 
 ### React Components
-- **[react-core/](mdc:CopilotKit/packages/react-core/)** - Core React components and hooks
+- **[react-core/](mdc:src/v1.x/packages/react-core/)** - Core React components and hooks
   - `CopilotProvider` - Main provider component
   - `useCopilotChat` - Chat functionality hook
   - `useCopilotAction` - Action definition hook
   - `useCopilotReadable` - State reading hook
 
 ### UI Components
-- **[react-ui/](mdc:CopilotKit/packages/react-ui/)** - Pre-built UI components
+- **[react-ui/](mdc:src/v1.x/packages/react-ui/)** - Pre-built UI components
   - `CopilotChat` - Chat interface component
   - `CopilotPopup` - Popup chat component
   - `CopilotSidebar` - Sidebar chat component
 
 ### Specialized Components
-- **[react-textarea/](mdc:CopilotKit/packages/react-textarea/)** - AI-enhanced textarea
+- **[react-textarea/](mdc:src/v1.x/packages/react-textarea/)** - AI-enhanced textarea
   - `CopilotTextarea` - Smart textarea with AI suggestions
   - Auto-completion and suggestions
 
@@ -115,8 +115,8 @@ function MyComponent() {
 ## Integration with Agents
 
 ### Runtime Configuration
-- **[runtime/](mdc:CopilotKit/packages/runtime/)** - Core runtime for agent communication
-- **[runtime-client-gql/](mdc:CopilotKit/packages/runtime-client-gql/)** - GraphQL client
+- **[runtime/](mdc:src/v1.x/packages/runtime/)** - Core runtime for agent communication
+- **[runtime-client-gql/](mdc:src/v1.x/packages/runtime-client-gql/)** - GraphQL client
 
 ### Agent Communication
 - Frontend components communicate with agents via the runtime
@@ -145,7 +145,7 @@ function MyComponent() {
 
 ### Styling and Theming
 - Uses Tailwind CSS for styling
-- Shared configuration in [utilities/tailwind-config/](mdc:CopilotKit/utilities/tailwind-config/)
+- Shared configuration in [utilities/tailwind-config/](mdc:src/v1.x/utilities/tailwind-config/)
 - Custom components in [components.json](mdc:docs/components.json)
 - UI components follow modern design patterns
 

.cursor/rules/quick-reference.mdc

@@ -9,8 +9,8 @@ alwaysApply: false
 
 ### Build a Simple Copilot
 - Start with [copilot-chat-with-your-data/](mdc:examples/copilot-chat-with-your-data)
-- Use [react-core/](mdc:CopilotKit/packages/react-core) for basic integration
-- Add [react-ui/](mdc:CopilotKit/packages/react-ui) for pre-built components
+- Use [react-core/](mdc:src/v1.x/packages/react-core) for basic integration
+- Add [react-ui/](mdc:src/v1.x/packages/react-ui) for pre-built components
 
 ### Create Multi-Agent Systems
 - Check [coagents-starter/](mdc:examples/coagents-starter) for basic setup
@@ -27,18 +27,18 @@ alwaysApply: false
 - See [coagents-starter/agent-py/](mdc:examples/coagents-starter/agent-py) for example
 
 ### Develop JavaScript Agents
-- Use [sdk-js/](mdc:CopilotKit/packages/sdk-js) package
+- Use [sdk-js/](mdc:src/v1.x/packages/sdk-js) package
 - Check [coagents-starter/agent-js/](mdc:examples/coagents-starter/agent-js) for example
 
 ### Customize UI Components
 - Browse [registry/](mdc:registry) for reusable components
 - Check [docs/components/react/](mdc:docs/components/react) for documentation
-- Use [react-ui/](mdc:CopilotKit/packages/react-ui) for pre-built components
+- Use [react-ui/](mdc:src/v1.x/packages/react-ui) for pre-built components
 
 ### Set Up Development Environment
-- Review [CopilotKit/package.json](mdc:CopilotKit/package.json) for workspace setup
-- Use scripts in [CopilotKit/scripts/](mdc:CopilotKit/scripts)
-- Check [utilities/](mdc:CopilotKit/utilities) for shared configurations
+- Review [src/v1.x/package.json](mdc:src/v1.x/package.json) for workspace setup
+- Use scripts in [src/v1.x/scripts/](mdc:src/v1.x/scripts)
+- Check [utilities/](mdc:src/v1.x/utilities) for shared configurations
 
 ### Run Tests
 - Use [examples/e2e/](mdc:examples/e2e) for end-to-end testing
@@ -50,9 +50,9 @@ alwaysApply: false
 - See [docs/content/docs/](mdc:docs/content/docs) for markdown files
 
 ## Key Files to Know
-- **[CopilotKit/package.json](mdc:CopilotKit/package.json)** - Main workspace configuration
+- **[src/v1.x/package.json](mdc:src/v1.x/package.json)** - Main workspace configuration
 - **[sdk-python/pyproject.toml](mdc:sdk-python/pyproject.toml)** - Python SDK configuration
-- **[CopilotKit.code-workspace](mdc:CopilotKit/CopilotKit.code-workspace)** - VS Code workspace settings
+- **[CopilotKit.code-workspace](mdc:src/v1.x/CopilotKit.code-workspace)** - VS Code workspace settings
 - **[examples/shared/](mdc:examples/shared)** - Shared utilities and templates
 
 ## Common Patterns
@@ -63,7 +63,7 @@ alwaysApply: false
 
 ## Getting Started Checklist
 1. Clone the repository
-2. Navigate to [CopilotKit/](mdc:CopilotKit) directory
+2. Navigate to [src/v1.x/](mdc:src/v1.x) directory
 3. Run `npm install` to set up workspace
 4. Choose an example from [examples/](mdc:examples)
 5. Follow the example's README.md

.cursor/rules/suggestions-development.mdc

@@ -31,16 +31,16 @@ Users can configure suggestions via `useCopilotChatSuggestions` hook which regis
 ## Core files
 
 - **@react-ui**
-  - [Suggestions.tsx](mdc:CopilotKit/packages/react-ui/src/components/chat/Suggestions.tsx) - How suggestions are rendered
-  - [Messages.tsx](mdc:CopilotKit/packages/react-ui/src/components/chat/Messages.tsx) - Includes relevant code for what renders [Suggestions.tsx](mdc:CopilotKit/packages/react-ui/src/components/chat/Suggestions.tsx)
-  - [Chat.tsx](mdc:CopilotKit/packages/react-ui/src/components/chat/Chat.tsx) - Includes relevant logic for our prebuilt components loading suggestions
-  - [use-copilot-chat-suggestions.tsx](mdc:CopilotKit/packages/react-ui/src/hooks/use-copilot-chat-suggestions.tsx) - How users specify the configuration for their suggestions
-  - [suggestions.css](mdc:CopilotKit/packages/react-ui/src/css/suggestions.css) - Styling for suggestions
+  - [Suggestions.tsx](mdc:src/v1.x/packages/react-ui/src/components/chat/Suggestions.tsx) - How suggestions are rendered
+  - [Messages.tsx](mdc:src/v1.x/packages/react-ui/src/components/chat/Messages.tsx) - Includes relevant code for what renders [Suggestions.tsx](mdc:src/v1.x/packages/react-ui/src/components/chat/Suggestions.tsx)
+  - [Chat.tsx](mdc:src/v1.x/packages/react-ui/src/components/chat/Chat.tsx) - Includes relevant logic for our prebuilt components loading suggestions
+  - [use-copilot-chat-suggestions.tsx](mdc:src/v1.x/packages/react-ui/src/hooks/use-copilot-chat-suggestions.tsx) - How users specify the configuration for their suggestions
+  - [suggestions.css](mdc:src/v1.x/packages/react-ui/src/css/suggestions.css) - Styling for suggestions
 - **@react-core**
-  - [copilot-context.tsx](mdc:CopilotKit/packages/react-core/src/context/copilot-context.tsx) - Where the actual suggestions are stored, the "provider" or "context"
-  - [use-copilot-chat.ts](mdc:CopilotKit/packages/react-core/src/hooks/use-copilot-chat.ts) - Hook that controls and contains logic for suggestions, often referred to as "headless UI"
-  - [suggestions.ts](mdc:CopilotKit/packages/react-core/src/utils/suggestions.ts) - Core suggestion generation logic with streaming validation and error handling
-  - [suggestions-constants.ts](mdc:CopilotKit/packages/react-core/src/utils/suggestions-constants.ts) - Retry configuration constants
+  - [copilot-context.tsx](mdc:src/v1.x/packages/react-core/src/context/copilot-context.tsx) - Where the actual suggestions are stored, the "provider" or "context"
+  - [use-copilot-chat.ts](mdc:src/v1.x/packages/react-core/src/hooks/use-copilot-chat.ts) - Hook that controls and contains logic for suggestions, often referred to as "headless UI"
+  - [suggestions.ts](mdc:src/v1.x/packages/react-core/src/utils/suggestions.ts) - Core suggestion generation logic with streaming validation and error handling
+  - [suggestions-constants.ts](mdc:src/v1.x/packages/react-core/src/utils/suggestions-constants.ts) - Retry configuration constants
 
 ## How Suggestions Work
 

.github/workflows/ci.yml

@@ -9,9 +9,9 @@ on:
       - 'examples/**'
       - '.github/workflows/demos_preview.yml'
       - '.github/workflows/release.yml'
-      - 'CopilotKit/packages/**/package.json'
-      - 'CopilotKit/packages/**/CHANGELOG.md'
-      - 'CopilotKit/.changeset/**'
+      - 'src/v1.x/packages/**/package.json'
+      - 'src/v1.x/packages/**/CHANGELOG.md'
+      - 'src/v1.x/.changeset/**'
   pull_request:
     branches: [main]
     paths-ignore:
@@ -24,7 +24,7 @@ jobs:
     runs-on: ubuntu-latest
     defaults:
       run:
-        working-directory: 'CopilotKit'
+        working-directory: 'src/v1.x'
     strategy:
       matrix:
         node-version: [20.x, 18.x]

.github/workflows/custom-prerelease.yml

@@ -11,7 +11,7 @@ jobs:
     runs-on: ubuntu-latest
     defaults:
       run:
-        working-directory: "CopilotKit"
+        working-directory: "src/v1.x"
     timeout-minutes: 10
     steps:
       - name: Checkout Repo

.github/workflows/danger.yml

@@ -4,7 +4,7 @@ on:
   pull_request:
     paths:
       - "sdk-python/copilotkit/langgraph_agent.py"
-      - "CopilotKit/packages/sdk-js/src/langgraph.ts"
+      - "src/v1.x/packages/sdk-js/src/langgraph.ts"
 
 jobs:
   danger:

.github/workflows/dojo-e2e.yml

@@ -143,11 +143,11 @@ jobs:
         uses: astral-sh/setup-uv@v6
 
       - name: Install cpk dependencies
-        working-directory: CopilotKit/CopilotKit
+        working-directory: CopilotKit/src/v1.x
         run: pnpm install --frozen-lockfile
 
       - name: Build cpk
-        working-directory: CopilotKit/CopilotKit
+        working-directory: CopilotKit/src/v1.x
         env:
           NODE_OPTIONS: --max-old-space-size=8192
           TURBO_CONCURRENCY: 2
@@ -163,7 +163,7 @@ jobs:
 
       - name: Link cpk into ag-ui
         working-directory: CopilotKit
-        run: node ../ag-ui/apps/dojo/scripts/link-cpk.js .
+        run: node ../ag-ui/apps/dojo/scripts/link-cpk.js src/v1.x/packages
 
       - name: Prepare dojo for e2e
         working-directory: ag-ui/apps/dojo