fix(showcase): add shared-tools symlinks and refactor imports

Replace sys.path.insert hacks in Python agent files with direct
imports via symlinks to shared/{python,typescript}/tools.
Update Dockerfiles, entrypoints, and configs to support the new
symlink-based tool resolution. Add PARITY_NOTES for frameworks
that have known gaps.

Author: jpr5

showcase/integrations/ag2/.gitignore

@@ -11,4 +11,3 @@ test-results/
 
 # Shared modules (copied by CI)
 shared_frontend/
-shared_python/

showcase/integrations/ag2/Dockerfile

@@ -58,9 +58,9 @@ COPY --chown=app:app --from=frontend /app/public ./public
 COPY --chown=app:app src/agent_server.py ./
 COPY --chown=app:app src/agents/ ./agents/
 
-# Shared Python tools (copied into build context by CI/dev-local.sh)
-COPY --chown=app:app shared_python/ /app/shared/python/
-ENV PYTHONPATH=/app/shared/python
+# Shared Python tools (symlinked locally, copied into build context by CI)
+COPY --chown=app:app tools/ /app/tools/
+ENV PYTHONPATH=/app
 
 # Entrypoint
 COPY --chown=app:app entrypoint.sh ./

showcase/integrations/ag2/entrypoint.sh

@@ -68,7 +68,7 @@ echo "[entrypoint] Next.js started (PID: $NEXTJS_PID)"
 # and Railway restarts the container. We kill the agent (not the whole
 # script) first so `set -e` + `wait -n; exit $?` handles the restart
 # through the normal path rather than a forced `exit` that would bypass
-# logging. Generalized from showcase/packages/crewai-crews/entrypoint.sh
+# logging. Generalized from showcase/integrations/crewai-crews/entrypoint.sh
 # (PRs #4114 + #4115).
 (
   FAILS=0

showcase/integrations/ag2/manifest.yaml

@@ -7,7 +7,7 @@ description: >-
   CopilotKit integration with AG2. Supports the full range of CopilotKit features
   including generative UI, shared state, human-in-the-loop, sub-agents, and streaming.
 partner_docs: null
-repo: https://github.com/CopilotKit/CopilotKit/tree/main/showcase/packages/ag2
+repo: https://github.com/CopilotKit/CopilotKit/tree/main/showcase/integrations/ag2
 copilotkit_version: 2.0.0
 backend_url: https://showcase-ag2-production.up.railway.app
 deployed: true
@@ -220,12 +220,12 @@ demos:
       - src/app/demos/frontend-tools-async/notes-card.tsx
       - src/app/api/copilotkit/route.ts
 starter:
-  path: showcase/starters/ag2
+  path: showcase/integrations/ag2
   name: Sales Dashboard
   description: Full-featured sales pipeline with 4 GenUI rendering strategies
-  github_url: https://github.com/CopilotKit/CopilotKit/tree/main/showcase/starters/ag2
+  github_url: https://github.com/CopilotKit/CopilotKit/tree/main/showcase/integrations/ag2
   demo_url: https://showcase-starter-ag2-production.up.railway.app
-  clone_command: npx degit CopilotKit/CopilotKit/showcase/starters/ag2 my-copilotkit-app
+  clone_command: npx degit CopilotKit/CopilotKit/showcase/integrations/ag2 my-copilotkit-app
 managed_platform:
   name: Agent OS
   url: https://ag2.ai/product

showcase/integrations/ag2/package.json

@@ -3,7 +3,7 @@
   "version": "0.1.0",
   "private": true,
   "scripts": {
-    "dev": "concurrently \"next dev --turbopack\" \"python -m uvicorn agent_server:app --host 0.0.0.0 --port 8000 --reload\"",
+    "dev": "concurrently \"next dev --turbopack\" \"PYTHONPATH=. python -m uvicorn agent_server:app --host 0.0.0.0 --port 8000 --reload\"",
     "build": "next build",
     "start": "next start",
     "lint": "next lint",

showcase/integrations/ag2/src/agents/agent.py

@@ -9,7 +9,6 @@
 
 import json
 import os
-import sys
 from typing import Annotated, Any
 
 from autogen import ConversableAgent, LLMConfig
@@ -19,7 +18,6 @@
 load_dotenv()
 
 # Import shared tool implementations
-sys.path.insert(0, os.path.join(os.path.dirname(__file__), "..", "..", "..", "..", "shared", "python"))
 from tools import (
     get_weather_impl,
     query_data_impl,

showcase/integrations/ag2/src/app/demos/agentic-chat/page.tsx

@@ -13,9 +13,11 @@ import { z } from "zod";
 
 export default function AgenticChatDemo() {
   return (
+    // @region[provider-setup]
     <CopilotKit runtimeUrl="/api/copilotkit" agent="agentic_chat">
       <Chat />
     </CopilotKit>
+    // @endregion[provider-setup]
   );
 }
 
@@ -68,6 +70,7 @@ function Chat() {
     },
   });
 
+  // @region[configure-suggestions]
   useConfigureSuggestions({
     suggestions: [
       {
@@ -81,6 +84,7 @@ function Chat() {
     ],
     available: "always",
   });
+  // @endregion[configure-suggestions]
 
   return (
     <div

showcase/integrations/ag2/src/app/demos/gen-ui-tool-based/page.tsx

@@ -3,7 +3,7 @@
 import React, { useState } from "react";
 import { CopilotKit } from "@copilotkit/react-core";
 import {
-  CopilotSidebar,
+  CopilotChat,
   useFrontendTool,
   useConfigureSuggestions,
 } from "@copilotkit/react-core/v2";
@@ -16,16 +16,30 @@ interface Haiku {
   gradient: string;
 }
 
+const VALID_IMAGE_NAMES = [
+  "Osaka_Castle_Turret_Stone_Wall_Pine_Trees_Daytime.jpg",
+  "Tokyo_Skyline_Night_Tokyo_Tower_Mount_Fuji_View.jpg",
+  "Itsukushima_Shrine_Miyajima_Floating_Torii_Gate_Sunset_Long_Exposure.jpg",
+  "Takachiho_Gorge_Waterfall_River_Lush_Greenery_Japan.jpg",
+  "Bonsai_Tree_Potted_Japanese_Art_Green_Foliage.jpeg",
+  "Shirakawa-go_Gassho-zukuri_Thatched_Roof_Village_Aerial_View.jpg",
+  "Ginkaku-ji_Silver_Pavilion_Kyoto_Japanese_Garden_Pond_Reflection.jpg",
+  "Senso-ji_Temple_Asakusa_Cherry_Blossoms_Kimono_Umbrella.jpg",
+  "Cherry_Blossoms_Sakura_Night_View_City_Lights_Japan.jpg",
+  "Mount_Fuji_Lake_Reflection_Cherry_Blossoms_Sakura_Spring.jpg",
+];
+
 export default function GenUiToolBasedDemo() {
   return (
     <CopilotKit runtimeUrl="/api/copilotkit" agent="gen-ui-tool-based">
-      <SidebarWithSuggestions />
-      <HaikuDisplay />
+      <Chat />
     </CopilotKit>
   );
 }
 
-function SidebarWithSuggestions() {
+function Chat() {
+  const [haikus, setHaikus] = useState<Haiku[]>([]);
+
   useConfigureSuggestions({
     suggestions: [
       { title: "Nature Haiku", message: "Write me a haiku about nature." },
@@ -35,43 +49,6 @@ function SidebarWithSuggestions() {
     available: "always",
   });
 
-  return (
-    <CopilotSidebar
-      defaultOpen={true}
-      labels={{
-        modalHeaderTitle: "Haiku Generator",
-      }}
-    />
-  );
-}
-
-const VALID_IMAGE_NAMES = [
-  "Osaka_Castle_Turret_Stone_Wall_Pine_Trees_Daytime.jpg",
-  "Tokyo_Skyline_Night_Tokyo_Tower_Mount_Fuji_View.jpg",
-  "Itsukushima_Shrine_Miyajima_Floating_Torii_Gate_Sunset_Long_Exposure.jpg",
-  "Takachiho_Gorge_Waterfall_River_Lush_Greenery_Japan.jpg",
-  "Bonsai_Tree_Potted_Japanese_Art_Green_Foliage.jpeg",
-  "Shirakawa-go_Gassho-zukuri_Thatched_Roof_Village_Aerial_View.jpg",
-  "Ginkaku-ji_Silver_Pavilion_Kyoto_Japanese_Garden_Pond_Reflection.jpg",
-  "Senso-ji_Temple_Asakusa_Cherry_Blossoms_Kimono_Umbrella.jpg",
-  "Cherry_Blossoms_Sakura_Night_View_City_Lights_Japan.jpg",
-  "Mount_Fuji_Lake_Reflection_Cherry_Blossoms_Sakura_Spring.jpg",
-];
-
-function HaikuDisplay() {
-  const [haikus, setHaikus] = useState<Haiku[]>([
-    {
-      japanese: ["仮の句よ", "まっさらながら", "花を呼ぶ"],
-      english: [
-        "A placeholder verse--",
-        "even in a blank canvas,",
-        "it beckons flowers.",
-      ],
-      image_name: null,
-      gradient: "",
-    },
-  ]);
-
   useFrontendTool(
     {
       name: "generate_haiku",
@@ -105,10 +82,7 @@ function HaikuDisplay() {
           image_name: image_name || null,
           gradient: gradient || "",
         };
-        setHaikus((prev) => [
-          newHaiku,
-          ...prev.filter((h) => h.english[0] !== "A placeholder verse--"),
-        ]);
+        setHaikus((prev) => [newHaiku, ...prev]);
         return "Haiku generated!";
       },
       render: ({ args }: { args: Partial<Haiku> }) => {
@@ -120,13 +94,12 @@ function HaikuDisplay() {
   );
 
   return (
-    <div className="relative flex items-center justify-center h-full w-full">
-      <div className="px-20 py-12 w-full max-w-4xl">
-        <div className="space-y-6">
-          {haikus.map((haiku, index) => (
-            <HaikuCard key={index} haiku={haiku} />
-          ))}
-        </div>
+    <div className="flex justify-center items-center h-screen w-full">
+      <div className="h-full w-full max-w-4xl">
+        <CopilotChat
+          agentId="gen-ui-tool-based"
+          className="h-full rounded-2xl"
+        />
       </div>
     </div>
   );

showcase/integrations/ag2/tools

@@ -0,0 +1 @@
+../../shared/python/tools

showcase/integrations/agno/.gitignore

@@ -11,4 +11,3 @@ test-results/
 
 # Shared modules (copied by CI)
 shared_frontend/
-shared_python/