Merge remote-tracking branch 'origin/main' into feat/CPK-7190-chat-performance

Author: marthakelly

.changeset/flat-singers-drum.md

@@ -0,0 +1,10 @@
+---
+"@copilotkit/react-textarea": patch
+"@copilotkit/a2ui-renderer": patch
+"@copilotkit/web-inspector": patch
+"@copilotkit/react-core": patch
+"@copilotkit/runtime": patch
+"@copilotkit/shared": patch
+---
+
+Fixing license warnings, barrel export and typing

.oxfmtrc.json

@@ -6,6 +6,7 @@
     "packages/runtime/src/lib/runtime/mcp-tools-utils.ts",
     ".github/actions/changesets-action/src/run.ts",
     "examples/v1/_legacy/copilot-anthropic-pinecone/src/app/api/copilotkit/route.ts",
-    "examples/v1/_legacy/copilot-openai-mongodb-atlas-vector-search/src/app/api/copilotkit/route.ts"
+    "examples/v1/_legacy/copilot-openai-mongodb-atlas-vector-search/src/app/api/copilotkit/route.ts",
+    "packages/web-inspector/src/styles/generated.css"
   ]
 }

.oxlintrc.json

@@ -10,9 +10,27 @@
     "react/react-in-jsx-scope": "off",
     "import/no-unassigned-import": "off",
     "unicorn/no-array-sort": "off",
-    "copilotkit/require-cpk-prefix": "off"
+    "copilotkit/require-cpk-prefix": "off",
+    "no-restricted-imports": "off"
   },
   "overrides": [
+    {
+      "files": ["packages/**/*.{ts,tsx}"],
+      "rules": {
+        "no-restricted-imports": [
+          "error",
+          {
+            "paths": [
+              {
+                "name": "@a2ui/lit",
+                "message": "Do not use value imports from '@a2ui/lit' — it registers custom elements as a side effect, which breaks React Strict Mode. Use `import type` for types, or import from '@a2ui/lit/0.8' for value access (core only, no UI side effects).",
+                "allowTypeImports": true
+              }
+            ]
+          }
+        ]
+      }
+    },
     {
       "files": ["packages/react-ui/src/**/*.{ts,tsx}"],
       "rules": {

examples/integrations/agentcore/infra-cdk/lib/fast-main-stack.ts

@@ -17,7 +17,8 @@ export class FastMainStack extends cdk.Stack {
   public readonly cognitoStack: CognitoStack;
 
   constructor(scope: Construct, id: string, props: FastAmplifyStackProps) {
-    const description = "CopilotKit + AWS AgentCore Integration Example";
+    const description =
+      "CopilotKit + AWS AgentCore Integration Example (uksb-v6dos0t5g8)";
     super(scope, id, { ...props, description });
 
     // Step 1: Create the Amplify stack to get the predictable domain

examples/showcases/open-mcp-client/README.md

@@ -1,10 +1,10 @@
-# CopilotKit <> MCP Apps Starter
+# Open MCP Client Builder
 
 **Production go-live:** [`docs/TRACKER.md`](docs/TRACKER.md) · **Stakeholder / product handoff** (shipped scope, CopilotKit open questions): [`docs/HANDOFF.md`](docs/HANDOFF.md)
 
 This monorepo demonstrates **MCP Apps** with **CopilotKit**: the **MCP App builder** web UI (`apps/web`) drives a **Mastra** agent (`/api/mastra-agent`) that can provision **E2B** sandboxes running the **`mcp-use-server`** template (`apps/mcp-use-server`). An optional local sample is the [Three.js MCP example](https://github.com/modelcontextprotocol/ext-apps/tree/main/examples/threejs-server) in **`apps/threejs-server`** (used for sidebar defaults when running everything locally).
 
-https://github.com/user-attachments/assets/8908af31-2b64-4426-9c83-c51ab86256de
+https://github.com/user-attachments/assets/4bb35806-5e42-43c0-a8fe-01c0d1e5b8b3
 
 ## Prerequisites
 
@@ -29,48 +29,48 @@ pnpm dev
 
 **Run pieces individually**
 
-| Goal | Command |
-|------|---------|
-| Web app only | `pnpm --filter web dev` (from repo root) or `cd apps/web && pnpm dev` |
-| Three.js MCP sample (local sidebar default) | `cd apps/threejs-server && pnpm dev` |
-| `mcp-use-server` (local MCP, not the E2B image) | `cd apps/mcp-use-server && pnpm dev` |
+| Goal                                            | Command                                                               |
+| ----------------------------------------------- | --------------------------------------------------------------------- |
+| Web app only                                    | `pnpm --filter web dev` (from repo root) or `cd apps/web && pnpm dev` |
+| Three.js MCP sample (local sidebar default)     | `cd apps/threejs-server && pnpm dev`                                  |
+| `mcp-use-server` (local MCP, not the E2B image) | `cd apps/mcp-use-server && pnpm dev`                                  |
 
 Open the URL shown by Next (usually `http://localhost:3000`).
 
 ## Scripts reference
 
 ### Root (`package.json`)
 
-| Script | Description |
-|--------|-------------|
-| `pnpm dev` | Turbo: all packages’ `dev` scripts |
-| `pnpm build` | Turbo: all packages’ `build` (for `web`, runs **`prebuild`** first — see below) |
-| `pnpm lint` | Turbo lint |
-| `pnpm clean` / `pnpm fresh` | Remove installs / lockfile helpers (see script definitions) |
+| Script                      | Description                                                                     |
+| --------------------------- | ------------------------------------------------------------------------------- |
+| `pnpm dev`                  | Turbo: all packages’ `dev` scripts                                              |
+| `pnpm build`                | Turbo: all packages’ `build` (for `web`, runs **`prebuild`** first — see below) |
+| `pnpm lint`                 | Turbo lint                                                                      |
+| `pnpm clean` / `pnpm fresh` | Remove installs / lockfile helpers (see script definitions)                     |
 
 ### `apps/web`
 
-| Script | Description |
-|--------|-------------|
-| `pnpm dev` | Next.js dev (Turbopack) |
-| `pnpm build` | Runs **`prebuild`** → **`pack-download-kit`** (writes **`.download-kit/base.tar.gz`** for [full app kit](docs/HANDOFF.md) download), then **`next build`** |
-| `pnpm pack-download-kit` | Regenerate **`.download-kit/base.tar.gz`** without a full Next build |
-| `pnpm start` | Production Next server |
-| `pnpm lint` | ESLint |
-| `pnpm run test:download-kit` | Integration test: Next + E2B + **`POST /api/workspace/download`** (see **`apps/web/test/`)** |
-| `pnpm run test:e2b-download` | Smoke test: E2B tarball only |
-| `pnpm run dev:mcp` | Starts the **Three.js** sample MCP from **`apps/threejs-server`** (for local MCP alongside web) |
+| Script                       | Description                                                                                                                                                |
+| ---------------------------- | ---------------------------------------------------------------------------------------------------------------------------------------------------------- |
+| `pnpm dev`                   | Next.js dev (Turbopack)                                                                                                                                    |
+| `pnpm build`                 | Runs **`prebuild`** → **`pack-download-kit`** (writes **`.download-kit/base.tar.gz`** for [full app kit](docs/HANDOFF.md) download), then **`next build`** |
+| `pnpm pack-download-kit`     | Regenerate **`.download-kit/base.tar.gz`** without a full Next build                                                                                       |
+| `pnpm start`                 | Production Next server                                                                                                                                     |
+| `pnpm lint`                  | ESLint                                                                                                                                                     |
+| `pnpm run test:download-kit` | Integration test: Next + E2B + **`POST /api/workspace/download`** (see **`apps/web/test/`)**                                                               |
+| `pnpm run test:e2b-download` | Smoke test: E2B tarball only                                                                                                                               |
+| `pnpm run dev:mcp`           | Starts the **Three.js** sample MCP from **`apps/threejs-server`** (for local MCP alongside web)                                                            |
 
 Manual scripts under **`apps/web/test/`**: run from **`apps/web`** as `node test/<file>.mjs` (paths and env documented in each file).
 
 ### E2B sandbox template (`apps/mcp-use-server`)
 
 The agent provisions sandboxes from an E2B **template** defined in **`template.ts`**. Rebuild the image when you change dependencies, tools, or widgets there.
 
-| Script | When to use | Command (from repo root) |
-|--------|-------------|---------------------------|
-| **Dev template** (`mcp-use-server-dev`) | Day-to-day iteration | `cd apps/mcp-use-server && npx tsx --env-file=../../.env build.dev.ts` |
-| **Prod template** (`mcp-use-server`) | Stable snapshot for production | `cd apps/mcp-use-server && npx tsx --env-file=../../.env build.prod.ts` |
+| Script                                  | When to use                    | Command (from repo root)                                                |
+| --------------------------------------- | ------------------------------ | ----------------------------------------------------------------------- |
+| **Dev template** (`mcp-use-server-dev`) | Day-to-day iteration           | `cd apps/mcp-use-server && npx tsx --env-file=../../.env build.dev.ts`  |
+| **Prod template** (`mcp-use-server`)    | Stable snapshot for production | `cd apps/mcp-use-server && npx tsx --env-file=../../.env build.prod.ts` |
 
 Requirements: **`E2B_API_KEY`** in `.env` (or environment). The CLI prints a **`BuildInfo`** object; set **`E2B_TEMPLATE`** to **`templateId`** from that output (and the same in your hosting dashboard). Template **name** (e.g. `mcp-use-server-dev`) is not the same as **`templateId`**.
 
@@ -106,10 +106,10 @@ More: **[`docs/DYNAMIC_MCP.md`](docs/DYNAMIC_MCP.md)**.
 
 ## Environment variables (E2B)
 
-| Variable | Description |
-|----------|-------------|
-| `E2B_API_KEY` | From [e2b.dev/dashboard](https://e2b.dev/dashboard) |
-| `E2B_TEMPLATE` | **`templateId`** from `Template.build` output after **`build.dev.ts`** / **`build.prod.ts`** |
+| Variable       | Description                                                                                                                                     |
+| -------------- | ----------------------------------------------------------------------------------------------------------------------------------------------- |
+| `E2B_API_KEY`  | From [e2b.dev/dashboard](https://e2b.dev/dashboard)                                                                                             |
+| `E2B_TEMPLATE` | **`templateId`** from `Template.build` output after **`build.dev.ts`** / **`build.prod.ts`**                                                    |
 | `E2B_REPO_URL` | Used when **`E2B_TEMPLATE`** is empty — clones repo into sandbox (slower cold start). Default in code: **`mcp-use-server-template`** GitHub URL |
 
 ## Hosting on Render
@@ -129,19 +129,19 @@ Widget tools should include **`_meta["ui/previewData"]`** for offline sidebar pr
 
 **In this repo**
 
-- **[`docs/TRACKER.md`](docs/TRACKER.md)** — **production go-live checklist**  
-- **[`docs/HANDOFF.md`](docs/HANDOFF.md)** — shipped scope, CopilotKit open questions  
-- **[`docs/DEPLOY-RENDER.md`](docs/DEPLOY-RENDER.md)** — Render deployment guide  
-- **[`docs/DYNAMIC_MCP.md`](docs/DYNAMIC_MCP.md)** — dynamic MCP patterns  
-- **[`docs/PLAN.md`](docs/PLAN.md)** / **[`docs/E2B-IMPLEMENTATION.md`](docs/E2B-IMPLEMENTATION.md)** — roadmap and E2B design  
+- **[`docs/TRACKER.md`](docs/TRACKER.md)** — **production go-live checklist**
+- **[`docs/HANDOFF.md`](docs/HANDOFF.md)** — shipped scope, CopilotKit open questions
+- **[`docs/DEPLOY-RENDER.md`](docs/DEPLOY-RENDER.md)** — Render deployment guide
+- **[`docs/DYNAMIC_MCP.md`](docs/DYNAMIC_MCP.md)** — dynamic MCP patterns
+- **[`docs/PLAN.md`](docs/PLAN.md)** / **[`docs/E2B-IMPLEMENTATION.md`](docs/E2B-IMPLEMENTATION.md)** — roadmap and E2B design
 
 **UI entry:** `apps/web/app/page.tsx` (theme, layout, CopilotKit wiring).
 
 **External**
 
-- [CopilotKit](https://docs.copilotkit.ai)  
-- [Next.js](https://nextjs.org/docs)  
-- [MCP Apps / UI](https://mcpui.dev/guide/introduction)  
+- [CopilotKit](https://docs.copilotkit.ai)
+- [Next.js](https://nextjs.org/docs)
+- [MCP Apps / UI](https://mcpui.dev/guide/introduction)
 
 ## Contributing
 

examples/showcases/open-mcp-client/apps/mcp-use-server/.agent/skills/chatgpt-app-builder/references/architecture.md

@@ -7,6 +7,7 @@ Design UX flows and API shape for your ChatGPT app.
 A **tool** is a backend action with no UI. It takes input and returns structured output. Use for CRUD operations, API calls, and actions (checkout, submit, cancel).
 
 A **widget** is a tool with a UI. It renders the tool output visually. The UI is a React component that can:
+
 - Navigate multiple views (search -> detail -> confirmation)
 - Manage its own state (selections, filters, form inputs)
 - Call other tools to fetch data or trigger actions
@@ -22,6 +23,7 @@ Extract flows from your spec's core actions. **Stick to the spec** -- don't inve
 Spec: "Book flights by destination and dates, and cancel existing bookings."
 
 Flows:
+
 ```
 Book flight:     Search -> Select -> Checkout
 Cancel booking:  Provide info -> Confirm cancellation
@@ -30,11 +32,13 @@ Cancel booking:  Provide info -> Confirm cancellation
 ## Step 2: Does the Flow Need UI?
 
 **YES → widget** if:
+
 - Browsing/comparing multiple items (search results, listings)
 - Visual data improves understanding (maps, charts, images, color swatches)
 - Selections are easier in a visual layout (seat picker, calendar)
 
 **NO → tool only** if:
+
 - Inputs are naturally conversational (amounts, dates, descriptions)
 - Output is simple text (confirmation ID, status message)
 - No visual element would meaningfully improve the experience
@@ -81,32 +85,42 @@ Tool calls are expensive. Return all needed data upfront.
 
 ```typescript
 // Widget: search-flights
-server.tool({
-  name: "search-flights",
-  schema: z.object({
-    destination: z.string().describe("Destination city"),
-    dates: z.string().describe("Travel dates"),
-  }),
-  widget: { name: "flight-search", invoking: "Searching...", invoked: "Flights found" },
-}, async ({ destination, dates }) => {
-  const flights = await fetchFlights(destination, dates);
-  return widget({
-    props: { flights, destination },
-    output: text(`Found ${flights.length} flights to ${destination}`),
-  });
-});
+server.tool(
+  {
+    name: "search-flights",
+    schema: z.object({
+      destination: z.string().describe("Destination city"),
+      dates: z.string().describe("Travel dates"),
+    }),
+    widget: {
+      name: "flight-search",
+      invoking: "Searching...",
+      invoked: "Flights found",
+    },
+  },
+  async ({ destination, dates }) => {
+    const flights = await fetchFlights(destination, dates);
+    return widget({
+      props: { flights, destination },
+      output: text(`Found ${flights.length} flights to ${destination}`),
+    });
+  },
+);
 
 // Tool: create-checkout (called by widget)
-server.tool({
-  name: "create-checkout",
-  schema: z.object({
-    flightId: z.string().describe("Selected flight ID"),
-    passengers: z.array(z.object({ name: z.string(), email: z.string() })),
-  }),
-}, async ({ flightId, passengers }) => {
-  const checkout = await createCheckoutSession(flightId, passengers);
-  return object({ checkoutUrl: checkout.url });
-});
+server.tool(
+  {
+    name: "create-checkout",
+    schema: z.object({
+      flightId: z.string().describe("Selected flight ID"),
+      passengers: z.array(z.object({ name: z.string(), email: z.string() })),
+    }),
+  },
+  async ({ flightId, passengers }) => {
+    const checkout = await createCheckoutSession(flightId, passengers);
+    return object({ checkoutUrl: checkout.url });
+  },
+);
 ```
 
 ### Flow DOES NOT NEED UI -> Tool(s) Only
@@ -115,23 +129,31 @@ server.tool({
 
 ```typescript
 // Tool: list-bookings
-server.tool({
-  name: "list-bookings",
-  schema: z.object({ email: z.string().describe("Booking email") }),
-}, async ({ email }) => {
-  const bookings = await getBookings(email);
-  return object({ bookings });
-  // LLM: "You have two flights: Paris Jan 1, Tokyo Feb 15. Which cancel?"
-});
+server.tool(
+  {
+    name: "list-bookings",
+    schema: z.object({ email: z.string().describe("Booking email") }),
+  },
+  async ({ email }) => {
+    const bookings = await getBookings(email);
+    return object({ bookings });
+    // LLM: "You have two flights: Paris Jan 1, Tokyo Feb 15. Which cancel?"
+  },
+);
 
 // Tool: cancel-booking
-server.tool({
-  name: "cancel-booking",
-  schema: z.object({ bookingId: z.string().describe("Booking ID to cancel") }),
-}, async ({ bookingId }) => {
-  await cancelBooking(bookingId);
-  return text(`Booking ${bookingId} has been cancelled.`);
-});
+server.tool(
+  {
+    name: "cancel-booking",
+    schema: z.object({
+      bookingId: z.string().describe("Booking ID to cancel"),
+    }),
+  },
+  async ({ bookingId }) => {
+    await cancelBooking(bookingId);
+    return text(`Booking ${bookingId} has been cancelled.`);
+  },
+);
 ```
 
 ## `exposeAsTool` Defaults to `false`