fix(examples): migrate integrations from v1 to v2 API surface

Migrate 15 example integrations from the v1 compatibility facade to
native v2 CopilotKit APIs. The v1 surface delegates to v2 internally
so this is an API surface change, not a functional one.

Key changes per integration:
- Import paths: @copilotkit/react-core -> react-core/v2,
  @copilotkit/runtime -> runtime/v2
- Hook renames: useCoAgent -> useAgent, useCopilotAction ->
  useFrontendTool, useRenderToolCall -> useRenderTool
- UI: CopilotSidebar from react-ui -> react-core/v2
- Styles: react-ui/styles.css -> react-core/v2/styles.css
- Runtime: copilotRuntimeNextJSAppRouterEndpoint ->
  createCopilotEndpoint + hono/vercel
- Removed @copilotkit/react-ui and @copilotkit/shared deps

Integrations migrated (v1 -> v2):
  a2a-middleware, adk, agno, crewai-crews, crewai-flows,
  langgraph-js, llamaindex, mastra, ms-agent-framework-dotnet,
  ms-agent-framework-python, pydantic-ai, strands-python

Mixed integrations cleaned up (stale deps removed):
  agent-spec, agentcore, langgraph-fastapi, langgraph-python,
  langgraph-python-threads

Author: jpr5

…a-middleware/app/api/copilotkit/route.ts …/app/api/copilotkit/[[...slug]]/route.tsexamples/integrations/a2a-middleware/app/api/copilotkit/route.ts renamed to examples/integrations/a2a-middleware/app/api/copilotkit/[[...slug]]/route.ts examples/integrations/a2a-middleware/app/api/copilotkit/route.ts renamed to examples/integrations/a2a-middleware/app/api/copilotkit/[[...slug]]/route.ts

@@ -1,39 +1,24 @@
-/**
- * CopilotKit API Route with A2A Middleware
- *
- * This connects the frontend to multiple agents using two protocols:
- * - AG-UI Protocol: Frontend ↔ Orchestrator (via CopilotKit)
- * - A2A Protocol: Orchestrator ↔ Specialized Agents (Research, Analysis)
- *
- * The A2A middleware injects send_message_to_a2a_agent tool into the orchestrator,
- * enabling seamless agent-to-agent communication without the orchestrator needing
- * to understand A2A Protocol directly.
- */
-
 import {
   CopilotRuntime,
-  ExperimentalEmptyAdapter,
-  copilotRuntimeNextJSAppRouterEndpoint,
-} from "@copilotkit/runtime";
+  createCopilotEndpoint,
+  InMemoryAgentRunner,
+} from "@copilotkit/runtime/v2";
 import { HttpAgent } from "@ag-ui/client";
 import { A2AMiddlewareAgent } from "@ag-ui/a2a-middleware";
-import { NextRequest } from "next/server";
+import { handle } from "hono/vercel";
 
-export async function POST(request: NextRequest) {
+export async function POST(request: Request) {
   const researchAgentUrl =
     process.env.RESEARCH_AGENT_URL || "http://localhost:9001";
   const analysisAgentUrl =
     process.env.ANALYSIS_AGENT_URL || "http://localhost:9002";
   const orchestratorUrl =
     process.env.ORCHESTRATOR_URL || "http://localhost:9000";
 
-  // Connect to orchestrator via AG-UI Protocol
   const orchestrationAgent = new HttpAgent({
     url: orchestratorUrl,
   });
 
-  // A2A Middleware: Wraps orchestrator and injects send_message_to_a2a_agent tool
-  // This allows orchestrator to communicate with A2A agents transparently
   const a2aMiddlewareAgent = new A2AMiddlewareAgent({
     description:
       "Research assistant with 2 specialized agents: Research (LangGraph) and Analysis (ADK)",
@@ -68,18 +53,29 @@ export async function POST(request: NextRequest) {
     `,
   });
 
-  // CopilotKit runtime connects frontend to agent system
   const runtime = new CopilotRuntime({
     agents: {
-      a2a_chat: a2aMiddlewareAgent, // Must match agent prop in <CopilotKit agent="a2a_chat">
+      a2a_chat: a2aMiddlewareAgent,
     },
+    runner: new InMemoryAgentRunner(),
   });
 
-  const { handleRequest } = copilotRuntimeNextJSAppRouterEndpoint({
+  const app = createCopilotEndpoint({
     runtime,
-    serviceAdapter: new ExperimentalEmptyAdapter(),
-    endpoint: "/api/copilotkit",
+    basePath: "/api/copilotkit",
   });
 
-  return handleRequest(request);
+  return handle(app)(request);
+}
+
+export async function GET(request: Request) {
+  const runtime = new CopilotRuntime({
+    agents: {},
+    runner: new InMemoryAgentRunner(),
+  });
+  const app = createCopilotEndpoint({
+    runtime,
+    basePath: "/api/copilotkit",
+  });
+  return handle(app)(request);
 }

examples/integrations/a2a-middleware/app/layout.tsx

@@ -1,7 +1,7 @@
 import type { Metadata } from "next";
 import { Plus_Jakarta_Sans, Spline_Sans_Mono } from "next/font/google";
 import "./globals.css";
-import "@copilotkit/react-ui/styles.css";
+import "@copilotkit/react-core/v2/styles.css";
 
 const plusJakartaSans = Plus_Jakarta_Sans({
   variable: "--font-plus-jakarta-sans",

examples/integrations/a2a-middleware/components/chat.tsx

@@ -8,11 +8,12 @@
 import React, { useEffect } from "react";
 import {
   CopilotKit,
-  useCopilotChat,
-  useCopilotAction,
-} from "@copilotkit/react-core";
-import { CopilotChat } from "@copilotkit/react-ui";
-import "@copilotkit/react-ui/styles.css";
+  useFrontendTool,
+  CopilotChat,
+} from "@copilotkit/react-core/v2";
+// NOTE: useCopilotChat has no v2 equivalent; kept on v1 import path
+import { useCopilotChat } from "@copilotkit/react-core";
+import "@copilotkit/react-core/v2/styles.css";
 import { MessageToA2A } from "./a2a/MessageToA2A";
 import { MessageFromA2A } from "./a2a/MessageFromA2A";
 
@@ -84,7 +85,7 @@ const ChatInner = ({ onResearchUpdate, onAnalysisUpdate }: ChatProps) => {
   }, [visibleMessages, onResearchUpdate, onAnalysisUpdate]);
 
   // Register action to render A2A message flow visualization
-  useCopilotAction({
+  useFrontendTool({
     name: "send_message_to_a2a_agent",
     description: "Sends a message to an A2A agent",
     available: "frontend",

examples/integrations/a2a-middleware/package.json

@@ -18,8 +18,8 @@
     "@ag-ui/a2a-middleware": "0.0.2",
     "@ag-ui/client": "0.0.52",
     "@copilotkit/react-core": "latest",
-    "@copilotkit/react-ui": "latest",
     "@copilotkit/runtime": "latest",
+    "hono": "^4",
     "next": "15.5.15",
     "react": "^19.0.0",
     "react-dom": "^19.0.0"

examples/integrations/adk/package.json

@@ -15,8 +15,9 @@
   "dependencies": {
     "@ag-ui/client": "0.0.52",
     "@copilotkit/react-core": "1.56.4",
-    "@copilotkit/react-ui": "1.56.4",
     "@copilotkit/runtime": "1.56.4",
+    "@hono/node-server": "^1",
+    "hono": "^4",
     "next": "16.1.1",
     "react": "^19.2.1",
     "react-dom": "^19.2.1",

examples/integrations/adk/src/app/api/copilotkit/[[...slug]]/route.ts

@@ -0,0 +1,24 @@
+import {
+  CopilotRuntime,
+  createCopilotEndpoint,
+  InMemoryAgentRunner,
+} from "@copilotkit/runtime/v2";
+import { HttpAgent } from "@ag-ui/client";
+import { handle } from "hono/vercel";
+
+const runtime = new CopilotRuntime({
+  agents: {
+    my_agent: new HttpAgent({
+      url: process.env.AGENT_URL || "http://localhost:8000/",
+    }),
+  },
+  runner: new InMemoryAgentRunner(),
+});
+
+const app = createCopilotEndpoint({
+  runtime,
+  basePath: "/api/copilotkit",
+});
+
+export const GET = handle(app);
+export const POST = handle(app);

examples/integrations/adk/src/app/api/copilotkit/route.ts

@@ -1,8 +1,8 @@
 import type { Metadata } from "next";
 
-import { CopilotKit } from "@copilotkit/react-core";
+import { CopilotKit } from "@copilotkit/react-core/v2";
 import "./globals.css";
-import "@copilotkit/react-ui/styles.css";
+import "@copilotkit/react-core/v2/styles.css";
 
 export const metadata: Metadata = {
   title: "Create Next App",

examples/integrations/adk/src/app/layout.tsx

@@ -4,14 +4,14 @@ import { ProverbsCard } from "@/components/proverbs";
 import { WeatherCard } from "@/components/weather";
 import { AgentState } from "@/lib/types";
 import {
-  useCoAgent,
-  useDefaultTool,
+  useAgent,
+  useDefaultRenderTool,
   useFrontendTool,
   useHumanInTheLoop,
-  useRenderToolCall,
-} from "@copilotkit/react-core";
-import { CopilotKitCSSProperties, CopilotSidebar } from "@copilotkit/react-ui";
-import { useState } from "react";
+  useRenderTool,
+  CopilotSidebar,
+} from "@copilotkit/react-core/v2";
+import React, { useState } from "react";
 
 export default function CopilotKitPage() {
   const [themeColor, setThemeColor] = useState("#6366f1");
@@ -34,7 +34,7 @@ export default function CopilotKitPage() {
   return (
     <main
       style={
-        { "--copilot-kit-primary-color": themeColor } as CopilotKitCSSProperties
+        { "--copilot-kit-primary-color": themeColor } as React.CSSProperties
       }
     >
       <CopilotSidebar
@@ -77,23 +77,18 @@ export default function CopilotKitPage() {
 
 function YourMainContent({ themeColor }: { themeColor: string }) {
   // 🪁 Shared State: https://docs.copilotkit.ai/adk/shared-state
-  const { state, setState } = useCoAgent<AgentState>({
-    name: "my_agent",
-    initialState: {
-      proverbs: [
-        "CopilotKit may be new, but its the best thing since sliced bread.",
-      ],
-    },
+  const { agent } = useAgent({
+    agentId: "my_agent",
   });
+  const state = (agent.state ?? { proverbs: ["CopilotKit may be new, but its the best thing since sliced bread."] }) as AgentState;
+  const setState = (newState: AgentState) => agent.setState(newState);
 
   //🪁 Generative UI: https://docs.copilotkit.ai/adk/generative-ui
-  useRenderToolCall(
+  useRenderTool(
     {
       name: "get_weather",
-      description: "Get the weather for a given location.",
-      parameters: [{ name: "location", type: "string", required: true }],
-      render: ({ args, result }) => {
-        return <WeatherCard location={args.location} themeColor={themeColor} />;
+      render: ({ parameters, result }) => {
+        return <WeatherCard location={(parameters as any)?.location} themeColor={themeColor} />;
       },
     },
     [themeColor],

examples/integrations/adk/src/app/page.tsx

@@ -23,10 +23,7 @@
     "@ag-ui/proto": "^0.0.46",
     "@copilotkit/a2ui-renderer": "1.57.1",
     "@copilotkit/react-core": "1.57.1",
-    "@copilotkit/react-ui": "1.57.1",
     "@copilotkit/runtime": "1.57.1",
-    "@copilotkit/runtime-client-gql": "1.57.1",
-    "@copilotkit/shared": "1.57.1",
     "hono": "^4.11.4",
     "next": "16.0.10",
     "react": "^19.2.3",