npm - @copilotkit/react-core - Versions diffs - 1.54.1 → 1.55.0-next.8 - Mend

@copilotkit/react-core 1.54.1 → 1.55.0-next.8

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.

Files changed (183) hide show

package/CHANGELOG.md +127 -116
package/dist/copilotkit-B3Mb1yVE.cjs +7975 -0
package/dist/copilotkit-B3Mb1yVE.cjs.map +1 -0
package/dist/copilotkit-DBzgOMby.d.cts +2182 -0
package/dist/copilotkit-DBzgOMby.d.cts.map +1 -0
package/dist/copilotkit-DNYSFuz5.mjs +7562 -0
package/dist/copilotkit-DNYSFuz5.mjs.map +1 -0
package/dist/copilotkit-Dy5w3qEV.d.mts +2182 -0
package/dist/copilotkit-Dy5w3qEV.d.mts.map +1 -0
package/dist/index.cjs +27 -28
package/dist/index.cjs.map +1 -1
package/dist/index.d.cts +3 -3
package/dist/index.d.cts.map +1 -1
package/dist/index.d.mts +3 -3
package/dist/index.d.mts.map +1 -1
package/dist/index.mjs +4 -5
package/dist/index.mjs.map +1 -1
package/dist/index.umd.js +1941 -35
package/dist/index.umd.js.map +1 -1
package/dist/v2/index.cjs +77 -7
package/dist/v2/index.css +1 -2
package/dist/v2/index.d.cts +6 -4
package/dist/v2/index.d.mts +6 -4
package/dist/v2/index.mjs +7 -4
package/dist/v2/index.umd.js +5725 -24
package/dist/v2/index.umd.js.map +1 -1
package/package.json +37 -9
package/scripts/scope-preflight.mjs +101 -0
package/src/components/CopilotListeners.tsx +2 -6
package/src/components/copilot-provider/copilot-messages.tsx +1 -1
package/src/components/copilot-provider/copilotkit-props.tsx +1 -1
package/src/components/copilot-provider/copilotkit.tsx +4 -4
package/src/context/copilot-messages-context.tsx +1 -1
package/src/hooks/__tests__/use-coagent-config.test.ts +2 -2
package/src/hooks/__tests__/use-coagent-state-render.e2e.test.tsx +2 -2
package/src/hooks/__tests__/use-copilot-chat-internal-connect.test.tsx +3 -7
package/src/hooks/__tests__/use-frontend-tool-available.test.tsx +1 -1
package/src/hooks/__tests__/use-frontend-tool-remount.e2e.test.tsx +4 -4
package/src/hooks/use-agent-nodename.ts +1 -1
package/src/hooks/use-coagent-state-render-bridge.tsx +1 -4
package/src/hooks/use-coagent.ts +1 -1
package/src/hooks/use-configure-chat-suggestions.tsx +2 -2
package/src/hooks/use-copilot-chat-suggestions.tsx +2 -2
package/src/hooks/use-copilot-chat_internal.ts +2 -2
package/src/hooks/use-copilot-readable.ts +1 -1
package/src/hooks/use-frontend-tool.ts +2 -2
package/src/hooks/use-human-in-the-loop.ts +2 -2
package/src/hooks/use-langgraph-interrupt.ts +2 -5
package/src/hooks/use-lazy-tool-renderer.tsx +1 -1
package/src/hooks/use-render-tool-call.ts +1 -1
package/src/lib/copilot-task.ts +1 -1
package/src/setupTests.ts +18 -14
package/src/v2/__tests__/A2UIMessageRenderer.test.tsx +176 -0
package/src/v2/__tests__/globalSetup.ts +14 -0
package/src/v2/__tests__/setup.ts +93 -0
package/src/v2/__tests__/utils/test-helpers.tsx +470 -0
package/src/v2/a2ui/A2UIMessageRenderer.tsx +206 -0
package/src/v2/components/CopilotKitInspector.tsx +50 -0
package/src/v2/components/MCPAppsActivityRenderer.tsx +785 -0
package/src/v2/components/WildcardToolCallRender.tsx +86 -0
package/src/v2/components/__tests__/license-warning-banner.test.tsx +46 -0
package/src/v2/components/chat/CopilotChat.tsx +431 -0
package/src/v2/components/chat/CopilotChatAssistantMessage.tsx +375 -0
package/src/v2/components/chat/CopilotChatAudioRecorder.tsx +350 -0
package/src/v2/components/chat/CopilotChatInput.tsx +1302 -0
package/src/v2/components/chat/CopilotChatMessageView.tsx +556 -0
package/src/v2/components/chat/CopilotChatReasoningMessage.tsx +252 -0
package/src/v2/components/chat/CopilotChatSuggestionPill.tsx +59 -0
package/src/v2/components/chat/CopilotChatSuggestionView.tsx +133 -0
package/src/v2/components/chat/CopilotChatToggleButton.tsx +171 -0
package/src/v2/components/chat/CopilotChatToolCallsView.tsx +40 -0
package/src/v2/components/chat/CopilotChatUserMessage.tsx +388 -0
package/src/v2/components/chat/CopilotChatView.tsx +598 -0
package/src/v2/components/chat/CopilotModalHeader.tsx +129 -0
package/src/v2/components/chat/CopilotPopup.tsx +81 -0
package/src/v2/components/chat/CopilotPopupView.tsx +317 -0
package/src/v2/components/chat/CopilotSidebar.tsx +76 -0
package/src/v2/components/chat/CopilotSidebarView.tsx +255 -0
package/src/v2/components/chat/__tests__/CopilotChat.e2e.test.tsx +1113 -0
package/src/v2/components/chat/__tests__/CopilotChat.onError.test.tsx +73 -0
package/src/v2/components/chat/__tests__/CopilotChat.slots.e2e.test.tsx +432 -0
package/src/v2/components/chat/__tests__/CopilotChatActivityRendering.e2e.test.tsx +150 -0
package/src/v2/components/chat/__tests__/CopilotChatAssistantMessage.slots.e2e.test.tsx +624 -0
package/src/v2/components/chat/__tests__/CopilotChatAssistantMessage.test.tsx +702 -0
package/src/v2/components/chat/__tests__/CopilotChatCssClasses.test.tsx +107 -0
package/src/v2/components/chat/__tests__/CopilotChatInput.slots.e2e.test.tsx +929 -0
package/src/v2/components/chat/__tests__/CopilotChatInput.test.tsx +986 -0
package/src/v2/components/chat/__tests__/CopilotChatMessageView.slots.e2e.test.tsx +1004 -0
package/src/v2/components/chat/__tests__/CopilotChatMessageView.test.tsx +169 -0
package/src/v2/components/chat/__tests__/CopilotChatSuggestionView.slots.e2e.test.tsx +530 -0
package/src/v2/components/chat/__tests__/CopilotChatToolRendering.e2e.test.tsx +782 -0
package/src/v2/components/chat/__tests__/CopilotChatToolRerenders.e2e.test.tsx +2413 -0
package/src/v2/components/chat/__tests__/CopilotChatUserMessage.slots.e2e.test.tsx +621 -0
package/src/v2/components/chat/__tests__/CopilotChatView.onClick.e2e.test.tsx +853 -0
package/src/v2/components/chat/__tests__/CopilotChatView.slots.e2e.test.tsx +1050 -0
package/src/v2/components/chat/__tests__/CopilotModalHeader.slots.e2e.test.tsx +484 -0
package/src/v2/components/chat/__tests__/CopilotPopupView.slots.e2e.test.tsx +612 -0
package/src/v2/components/chat/__tests__/CopilotSidebarView.slots.e2e.test.tsx +502 -0
package/src/v2/components/chat/__tests__/MCPAppsActivityRenderer.e2e.test.tsx +1011 -0
package/src/v2/components/chat/__tests__/setup.ts +1 -0
package/src/v2/components/chat/index.ts +79 -0
package/src/v2/components/index.ts +7 -0
package/src/v2/components/license-warning-banner.tsx +198 -0
package/src/v2/components/ui/button.tsx +123 -0
package/src/v2/components/ui/dropdown-menu.tsx +258 -0
package/src/v2/components/ui/tooltip.tsx +60 -0
package/src/v2/hooks/__tests__/standard-schema-types.test.tsx +152 -0
package/src/v2/hooks/__tests__/standard-schema.test.tsx +282 -0
package/src/v2/hooks/__tests__/use-agent-context-timing.e2e.test.tsx +132 -0
package/src/v2/hooks/__tests__/use-agent-context.test.tsx +401 -0
package/src/v2/hooks/__tests__/use-agent-error-state.test.tsx +44 -0
package/src/v2/hooks/__tests__/use-agent-stability.test.tsx +205 -0
package/src/v2/hooks/__tests__/use-agent.e2e.test.tsx +148 -0
package/src/v2/hooks/__tests__/use-component.test.tsx +123 -0
package/src/v2/hooks/__tests__/use-configure-suggestions.e2e.test.tsx +696 -0
package/src/v2/hooks/__tests__/use-default-render-tool.test.tsx +153 -0
package/src/v2/hooks/__tests__/use-frontend-tool-available.test.tsx +167 -0
package/src/v2/hooks/__tests__/use-frontend-tool.e2e.test.tsx +2129 -0
package/src/v2/hooks/__tests__/use-human-in-the-loop.e2e.test.tsx +1261 -0
package/src/v2/hooks/__tests__/use-interrupt.test.tsx +397 -0
package/src/v2/hooks/__tests__/use-katex-styles.test.tsx +56 -0
package/src/v2/hooks/__tests__/use-keyboard-height.test.tsx +192 -0
package/src/v2/hooks/__tests__/use-render-tool.test.tsx +259 -0
package/src/v2/hooks/__tests__/use-suggestions.e2e.test.tsx +524 -0
package/src/v2/hooks/__tests__/use-threads.test.tsx +433 -0
package/src/v2/hooks/__tests__/zod-regression.test.tsx +311 -0
package/src/v2/hooks/index.ts +18 -0
package/src/v2/hooks/use-agent-context.tsx +45 -0
package/src/v2/hooks/use-agent.tsx +155 -0
package/src/v2/hooks/use-component.tsx +89 -0
package/src/v2/hooks/use-configure-suggestions.tsx +187 -0
package/src/v2/hooks/use-default-render-tool.tsx +254 -0
package/src/v2/hooks/use-frontend-tool.tsx +43 -0
package/src/v2/hooks/use-human-in-the-loop.tsx +81 -0
package/src/v2/hooks/use-interrupt.tsx +305 -0
package/src/v2/hooks/use-keyboard-height.tsx +67 -0
package/src/v2/hooks/use-render-activity-message.tsx +73 -0
package/src/v2/hooks/use-render-custom-messages.tsx +93 -0
package/src/v2/hooks/use-render-tool-call.tsx +175 -0
package/src/v2/hooks/use-render-tool.tsx +181 -0
package/src/v2/hooks/use-suggestions.tsx +91 -0
package/src/v2/hooks/use-threads.tsx +256 -0
package/src/v2/hooks/useKatexStyles.ts +27 -0
package/src/v2/index.css +1 -1
package/src/v2/index.ts +18 -2
package/src/v2/lib/__tests__/completePartialMarkdown.test.ts +495 -0
package/src/v2/lib/__tests__/renderSlot.test.tsx +588 -0
package/src/v2/lib/react-core.ts +156 -0
package/src/v2/lib/slots.tsx +143 -0
package/src/v2/lib/transcription-client.ts +184 -0
package/src/v2/lib/utils.ts +8 -0
package/src/v2/providers/CopilotChatConfigurationProvider.tsx +162 -0
package/src/v2/providers/CopilotKitProvider.tsx +600 -0
package/src/v2/providers/__tests__/CopilotChatConfigurationProvider.test.tsx +546 -0
package/src/v2/providers/__tests__/CopilotKitProvider.license.test.tsx +101 -0
package/src/v2/providers/__tests__/CopilotKitProvider.onError.test.tsx +69 -0
package/src/v2/providers/__tests__/CopilotKitProvider.renderCustomMessages.e2e.test.tsx +881 -0
package/src/v2/providers/__tests__/CopilotKitProvider.stability.test.tsx +740 -0
package/src/v2/providers/__tests__/CopilotKitProvider.test.tsx +642 -0
package/src/v2/providers/__tests__/CopilotKitProvider.wildcard.test.tsx +294 -0
package/src/v2/providers/index.ts +14 -0
package/src/v2/styles/globals.css +230 -0
package/src/v2/types/__tests__/defineToolCallRenderer.test.tsx +525 -0
package/src/v2/types/defineToolCallRenderer.ts +65 -0
package/src/v2/types/frontend-tool.ts +8 -0
package/src/v2/types/human-in-the-loop.ts +33 -0
package/src/v2/types/index.ts +7 -0
package/src/v2/types/interrupt.ts +15 -0
package/src/v2/types/react-activity-message-renderer.ts +27 -0
package/src/v2/types/react-custom-message-renderer.ts +17 -0
package/src/v2/types/react-tool-call-renderer.ts +32 -0
package/tsdown.config.ts +34 -10
package/vitest.config.mjs +4 -3
package/LICENSE +0 -21
package/dist/copilotkit-BRPQ2sqS.d.cts +0 -670
package/dist/copilotkit-BRPQ2sqS.d.cts.map +0 -1
package/dist/copilotkit-C94ayZbs.cjs +0 -2161
package/dist/copilotkit-C94ayZbs.cjs.map +0 -1
package/dist/copilotkit-CwZMFmSK.d.mts +0 -670
package/dist/copilotkit-CwZMFmSK.d.mts.map +0 -1
package/dist/copilotkit-Yh_Ld_FX.mjs +0 -2031
package/dist/copilotkit-Yh_Ld_FX.mjs.map +0 -1
package/dist/v2/index.css.map +0 -1

package/src/v2/components/MCPAppsActivityRenderer.tsx ADDED Viewed

@@ -0,0 +1,785 @@
+"use client";
+import React, { useEffect, useRef, useState, useCallback } from "react";
+import { z } from "zod";
+import type { AbstractAgent, RunAgentResult } from "@ag-ui/client";
+// Protocol version supported
+const PROTOCOL_VERSION = "2025-06-18";
+// Build sandbox proxy HTML with optional extra CSP domains from resource metadata
+function buildSandboxHTML(extraCspDomains?: string[]): string {
+  const baseScriptSrc =
+    "'self' 'wasm-unsafe-eval' 'unsafe-inline' 'unsafe-eval' blob: data: http://localhost:* https://localhost:*";
+  const baseFrameSrc = "* blob: data: http://localhost:* https://localhost:*";
+  const extra = extraCspDomains?.length ? " " + extraCspDomains.join(" ") : "";
+  const scriptSrc = baseScriptSrc + extra;
+  const frameSrc = baseFrameSrc + extra;
+  return `<!doctype html>
+<html>
+<head>
+<meta charset="utf-8" />
+<meta http-equiv="Content-Security-Policy" content="default-src 'self'; img-src * data: blob: 'unsafe-inline'; media-src * blob: data:; font-src * blob: data:; script-src ${scriptSrc}; style-src * blob: data: 'unsafe-inline'; connect-src *; frame-src ${frameSrc}; base-uri 'self';" />
+<style>html,body{margin:0;padding:0;height:100%;width:100%;overflow:hidden}*{box-sizing:border-box}iframe{background-color:transparent;border:none;padding:0;overflow:hidden;width:100%;height:100%}</style>
+</head>
+<body>
+<script>
+if(window.self===window.top){throw new Error("This file must be used in an iframe.")}
+const inner=document.createElement("iframe");
+inner.style="width:100%;height:100%;border:none;";
+inner.setAttribute("sandbox","allow-scripts allow-same-origin allow-forms");
+document.body.appendChild(inner);
+window.addEventListener("message",async(event)=>{
+if(event.source===window.parent){
+if(event.data&&event.data.method==="ui/notifications/sandbox-resource-ready"){
+const{html,sandbox}=event.data.params;
+if(typeof sandbox==="string")inner.setAttribute("sandbox",sandbox);
+if(typeof html==="string")inner.srcdoc=html;
+}else if(inner&&inner.contentWindow){
+inner.contentWindow.postMessage(event.data,"*");
+}
+}else if(event.source===inner.contentWindow){
+window.parent.postMessage(event.data,"*");
+}
+});
+window.parent.postMessage({jsonrpc:"2.0",method:"ui/notifications/sandbox-proxy-ready",params:{}},"*");
+</script>
+</body>
+</html>`;
+}
+/**
+ * Queue for serializing MCP app requests to an agent.
+ * Ensures requests wait for the agent to stop running and are processed one at a time.
+ */
+class MCPAppsRequestQueue {
+  private queues = new Map<
+    string,
+    Array<{
+      execute: () => Promise<RunAgentResult>;
+      resolve: (result: RunAgentResult) => void;
+      reject: (error: Error) => void;
+    }>
+  >();
+  private processing = new Map<string, boolean>();
+  /**
+   * Add a request to the queue for a specific agent thread.
+   * Returns a promise that resolves when the request completes.
+   */
+  async enqueue(
+    agent: AbstractAgent,
+    request: () => Promise<RunAgentResult>,
+  ): Promise<RunAgentResult> {
+    const threadId = agent.threadId || "default";
+    return new Promise((resolve, reject) => {
+      // Get or create queue for this thread
+      let queue = this.queues.get(threadId);
+      if (!queue) {
+        queue = [];
+        this.queues.set(threadId, queue);
+      }
+      // Add request to queue
+      queue.push({ execute: request, resolve, reject });
+      // Start processing if not already running
+      this.processQueue(threadId, agent);
+    });
+  }
+  private async processQueue(
+    threadId: string,
+    agent: AbstractAgent,
+  ): Promise<void> {
+    // If already processing this queue, return
+    if (this.processing.get(threadId)) {
+      return;
+    }
+    this.processing.set(threadId, true);
+    try {
+      const queue = this.queues.get(threadId);
+      if (!queue) return;
+      while (queue.length > 0) {
+        const item = queue[0]!;
+        try {
+          // Wait for any active run to complete before processing
+          await this.waitForAgentIdle(agent);
+          // Execute the request
+          const result = await item.execute();
+          item.resolve(result);
+        } catch (error) {
+          item.reject(
+            error instanceof Error ? error : new Error(String(error)),
+          );
+        }
+        // Remove processed item
+        queue.shift();
+      }
+    } finally {
+      this.processing.set(threadId, false);
+    }
+  }
+  private waitForAgentIdle(agent: AbstractAgent): Promise<void> {
+    return new Promise((resolve) => {
+      if (!agent.isRunning) {
+        resolve();
+        return;
+      }
+      let done = false;
+      const finish = () => {
+        if (done) return;
+        done = true;
+        clearInterval(checkInterval);
+        sub.unsubscribe();
+        resolve();
+      };
+      const sub = agent.subscribe({
+        onRunFinalized: finish,
+        onRunFailed: finish,
+      });
+      // Fallback for reconnect scenarios where events don't fire
+      const checkInterval = setInterval(() => {
+        if (!agent.isRunning) finish();
+      }, 500);
+    });
+  }
+}
+// Global queue instance for all MCP app requests
+const mcpAppsRequestQueue = new MCPAppsRequestQueue();
+/**
+ * Activity type for MCP Apps events - must match the middleware's MCPAppsActivityType
+ */
+export const MCPAppsActivityType = "mcp-apps";
+// Zod schema for activity content validation (middleware 0.0.2 format)
+export const MCPAppsActivityContentSchema = z.object({
+  result: z.object({
+    content: z.array(z.any()).optional(),
+    structuredContent: z.any().optional(),
+    isError: z.boolean().optional(),
+  }),
+  // Resource URI to fetch (e.g., "ui://server/dashboard")
+  resourceUri: z.string(),
+  // MD5 hash of server config (renamed from serverId in 0.0.1)
+  serverHash: z.string(),
+  // Optional stable server ID from config (takes precedence over serverHash)
+  serverId: z.string().optional(),
+  // Original tool input arguments
+  toolInput: z.record(z.unknown()).optional(),
+});
+export type MCPAppsActivityContent = z.infer<
+  typeof MCPAppsActivityContentSchema
+>;
+// Type for the resource fetched from the server
+interface FetchedResource {
+  uri: string;
+  mimeType?: string;
+  text?: string;
+  blob?: string;
+  _meta?: {
+    ui?: {
+      prefersBorder?: boolean;
+      csp?: {
+        connectDomains?: string[];
+        resourceDomains?: string[];
+      };
+    };
+  };
+}
+interface JSONRPCRequest {
+  jsonrpc: "2.0";
+  id: string | number;
+  method: string;
+  params?: Record<string, unknown>;
+}
+interface JSONRPCResponse {
+  jsonrpc: "2.0";
+  id: string | number;
+  result?: unknown;
+  error?: { code: number; message: string };
+}
+interface JSONRPCNotification {
+  jsonrpc: "2.0";
+  method: string;
+  params?: Record<string, unknown>;
+}
+type JSONRPCMessage = JSONRPCRequest | JSONRPCResponse | JSONRPCNotification;
+function isRequest(msg: JSONRPCMessage): msg is JSONRPCRequest {
+  return "id" in msg && "method" in msg;
+}
+function isNotification(msg: JSONRPCMessage): msg is JSONRPCNotification {
+  return !("id" in msg) && "method" in msg;
+}
+/**
+ * Props for the activity renderer component
+ */
+interface MCPAppsActivityRendererProps {
+  activityType: string;
+  content: MCPAppsActivityContent;
+  message: unknown; // ActivityMessage from @ag-ui/core
+  agent: AbstractAgent | undefined;
+}
+/**
+ * MCP Apps Extension Activity Renderer
+ *
+ * Renders MCP Apps UI in a sandboxed iframe with full protocol support.
+ * Fetches resource content on-demand via proxied MCP requests.
+ */
+export const MCPAppsActivityRenderer: React.FC<MCPAppsActivityRendererProps> =
+  function MCPAppsActivityRenderer({ content, agent }) {
+    const containerRef = useRef<HTMLDivElement>(null);
+    const iframeRef = useRef<HTMLIFrameElement | null>(null);
+    const [iframeReady, setIframeReady] = useState(false);
+    const [error, setError] = useState<Error | null>(null);
+    const [isLoading, setIsLoading] = useState(true);
+    const [iframeSize, setIframeSize] = useState<{
+      width?: number;
+      height?: number;
+    }>({});
+    const [fetchedResource, setFetchedResource] =
+      useState<FetchedResource | null>(null);
+    // Use refs for values that shouldn't trigger re-renders but need latest values
+    const contentRef = useRef(content);
+    contentRef.current = content;
+    // Store agent in a ref for use in async handlers
+    const agentRef = useRef(agent);
+    agentRef.current = agent;
+    // Ref to track fetch state - survives StrictMode remounts
+    const fetchStateRef = useRef<{
+      inProgress: boolean;
+      promise: Promise<FetchedResource | null> | null;
+      resourceUri: string | null;
+    }>({ inProgress: false, promise: null, resourceUri: null });
+    // Callback to send a message to the iframe
+    const sendToIframe = useCallback((msg: JSONRPCMessage) => {
+      if (iframeRef.current?.contentWindow) {
+        console.log("[MCPAppsRenderer] Sending to iframe:", msg);
+        iframeRef.current.contentWindow.postMessage(msg, "*");
+      }
+    }, []);
+    // Callback to send a JSON-RPC response
+    const sendResponse = useCallback(
+      (id: string | number, result: unknown) => {
+        sendToIframe({
+          jsonrpc: "2.0",
+          id,
+          result,
+        });
+      },
+      [sendToIframe],
+    );
+    // Callback to send a JSON-RPC error response
+    const sendErrorResponse = useCallback(
+      (id: string | number, code: number, message: string) => {
+        sendToIframe({
+          jsonrpc: "2.0",
+          id,
+          error: { code, message },
+        });
+      },
+      [sendToIframe],
+    );
+    // Callback to send a notification
+    const sendNotification = useCallback(
+      (method: string, params?: Record<string, unknown>) => {
+        sendToIframe({
+          jsonrpc: "2.0",
+          method,
+          params: params || {},
+        });
+      },
+      [sendToIframe],
+    );
+    // Effect 0: Fetch the resource content on mount
+    // Uses ref-based deduplication to handle React StrictMode double-mounting
+    useEffect(() => {
+      const { resourceUri, serverHash, serverId } = content;
+      // Check if we already have a fetch in progress for this resource
+      // This handles StrictMode double-mounting - second mount reuses first mount's promise
+      if (
+        fetchStateRef.current.inProgress &&
+        fetchStateRef.current.resourceUri === resourceUri
+      ) {
+        // Reuse the existing promise
+        fetchStateRef.current.promise
+          ?.then((resource) => {
+            if (resource) {
+              setFetchedResource(resource);
+              setIsLoading(false);
+            }
+          })
+          .catch((err) => {
+            setError(err instanceof Error ? err : new Error(String(err)));
+            setIsLoading(false);
+          });
+        return;
+      }
+      if (!agent) {
+        setError(new Error("No agent available to fetch resource"));
+        setIsLoading(false);
+        return;
+      }
+      // Mark fetch as in progress
+      fetchStateRef.current.inProgress = true;
+      fetchStateRef.current.resourceUri = resourceUri;
+      // Create the fetch promise using the queue to serialize requests
+      const fetchPromise = (async (): Promise<FetchedResource | null> => {
+        try {
+          // Use queue to wait for agent to be idle and serialize requests
+          const runResult = await mcpAppsRequestQueue.enqueue(agent, () =>
+            agent.runAgent({
+              forwardedProps: {
+                __proxiedMCPRequest: {
+                  serverHash,
+                  serverId, // optional, takes precedence if provided
+                  method: "resources/read",
+                  params: { uri: resourceUri },
+                },
+              },
+            }),
+          );
+          // Extract resource from result
+          // The response format is: { contents: [{ uri, mimeType, text?, blob?, _meta? }] }
+          const resultData = runResult.result as
+            | { contents?: FetchedResource[] }
+            | undefined;
+          const resource = resultData?.contents?.[0];
+          if (!resource) {
+            throw new Error("No resource content in response");
+          }
+          return resource;
+        } catch (err) {
+          console.error("[MCPAppsRenderer] Failed to fetch resource:", err);
+          throw err;
+        } finally {
+          // Mark fetch as complete
+          fetchStateRef.current.inProgress = false;
+        }
+      })();
+      // Store the promise for potential reuse
+      fetchStateRef.current.promise = fetchPromise;
+      // Handle the result
+      fetchPromise
+        .then((resource) => {
+          if (resource) {
+            setFetchedResource(resource);
+            setIsLoading(false);
+          }
+        })
+        .catch((err) => {
+          setError(err instanceof Error ? err : new Error(String(err)));
+          setIsLoading(false);
+        });
+      // No cleanup needed - we want the fetch to complete even if StrictMode unmounts
+    }, [agent, content]);
+    // Effect 1: Setup sandbox proxy iframe and communication (after resource is fetched)
+    useEffect(() => {
+      // Wait for resource to be fetched
+      if (isLoading || !fetchedResource) {
+        return;
+      }
+      // Capture container reference at effect start (refs are cleared during unmount)
+      const container = containerRef.current;
+      if (!container) {
+        return;
+      }
+      let mounted = true;
+      let messageHandler: ((event: MessageEvent) => void) | null = null;
+      let initialListener: ((event: MessageEvent) => void) | null = null;
+      let createdIframe: HTMLIFrameElement | null = null;
+      const setup = async () => {
+        try {
+          // Create sandbox proxy iframe
+          const iframe = document.createElement("iframe");
+          createdIframe = iframe; // Track for cleanup
+          iframe.style.width = "100%";
+          iframe.style.height = "100px"; // Start small, will be resized by size-changed notification
+          iframe.style.border = "none";
+          iframe.style.backgroundColor = "transparent";
+          iframe.style.display = "block";
+          iframe.setAttribute(
+            "sandbox",
+            "allow-scripts allow-same-origin allow-forms",
+          );
+          // Wait for sandbox proxy to be ready
+          const sandboxReady = new Promise<void>((resolve) => {
+            initialListener = (event: MessageEvent) => {
+              if (event.source === iframe.contentWindow) {
+                if (
+                  event.data?.method === "ui/notifications/sandbox-proxy-ready"
+                ) {
+                  if (initialListener) {
+                    window.removeEventListener("message", initialListener);
+                    initialListener = null;
+                  }
+                  resolve();
+                }
+              }
+            };
+            window.addEventListener("message", initialListener);
+          });
+          // Check mounted before adding to DOM (handles StrictMode double-mount)
+          if (!mounted) {
+            if (initialListener) {
+              window.removeEventListener("message", initialListener);
+              initialListener = null;
+            }
+            return;
+          }
+          // Build sandbox HTML with CSP domains from resource metadata
+          const cspDomains = fetchedResource._meta?.ui?.csp?.resourceDomains;
+          iframe.srcdoc = buildSandboxHTML(cspDomains);
+          iframeRef.current = iframe;
+          container.appendChild(iframe);
+          // Wait for sandbox proxy to signal ready
+          await sandboxReady;
+          if (!mounted) return;
+          console.log("[MCPAppsRenderer] Sandbox proxy ready");
+          // Setup message handler for JSON-RPC messages from the inner iframe
+          messageHandler = async (event: MessageEvent) => {
+            if (event.source !== iframe.contentWindow) return;
+            const msg = event.data as JSONRPCMessage;
+            if (!msg || typeof msg !== "object" || msg.jsonrpc !== "2.0")
+              return;
+            console.log("[MCPAppsRenderer] Received from iframe:", msg);
+            // Handle requests (need response)
+            if (isRequest(msg)) {
+              switch (msg.method) {
+                case "ui/initialize": {
+                  // Respond with host capabilities
+                  sendResponse(msg.id, {
+                    protocolVersion: PROTOCOL_VERSION,
+                    hostInfo: {
+                      name: "CopilotKit MCP Apps Host",
+                      version: "1.0.0",
+                    },
+                    hostCapabilities: {
+                      openLinks: {},
+                      logging: {},
+                    },
+                    hostContext: {
+                      theme: "light",
+                      platform: "web",
+                    },
+                  });
+                  break;
+                }
+                case "ui/message": {
+                  // Add message to CopilotKit chat
+                  const currentAgent = agentRef.current;
+                  if (!currentAgent) {
+                    console.warn(
+                      "[MCPAppsRenderer] ui/message: No agent available",
+                    );
+                    sendResponse(msg.id, { isError: false });
+                    break;
+                  }
+                  try {
+                    const params = msg.params as {
+                      role?: string;
+                      content?: Array<{ type: string; text?: string }>;
+                    };
+                    // Extract text content from the message
+                    const textContent =
+                      params.content
+                        ?.filter((c) => c.type === "text" && c.text)
+                        .map((c) => c.text)
+                        .join("\n") || "";
+                    if (textContent) {
+                      currentAgent.addMessage({
+                        id: crypto.randomUUID(),
+                        role: (params.role as "user" | "assistant") || "user",
+                        content: textContent,
+                      });
+                    }
+                    sendResponse(msg.id, { isError: false });
+                  } catch (err) {
+                    console.error("[MCPAppsRenderer] ui/message error:", err);
+                    sendResponse(msg.id, { isError: true });
+                  }
+                  break;
+                }
+                case "ui/open-link": {
+                  // Open URL in new tab
+                  const url = msg.params?.url as string | undefined;
+                  if (url) {
+                    window.open(url, "_blank", "noopener,noreferrer");
+                    sendResponse(msg.id, { isError: false });
+                  } else {
+                    sendErrorResponse(msg.id, -32602, "Missing url parameter");
+                  }
+                  break;
+                }
+                case "tools/call": {
+                  // Proxy tool call to MCP server via agent.runAgent()
+                  const { serverHash, serverId } = contentRef.current;
+                  const currentAgent = agentRef.current;
+                  if (!serverHash) {
+                    sendErrorResponse(
+                      msg.id,
+                      -32603,
+                      "No server hash available for proxying",
+                    );
+                    break;
+                  }
+                  if (!currentAgent) {
+                    sendErrorResponse(
+                      msg.id,
+                      -32603,
+                      "No agent available for proxying",
+                    );
+                    break;
+                  }
+                  try {
+                    // Use queue to wait for agent to be idle and serialize requests
+                    const runResult = await mcpAppsRequestQueue.enqueue(
+                      currentAgent,
+                      () =>
+                        currentAgent.runAgent({
+                          forwardedProps: {
+                            __proxiedMCPRequest: {
+                              serverHash,
+                              serverId, // optional, takes precedence if provided
+                              method: "tools/call",
+                              params: msg.params,
+                            },
+                          },
+                        }),
+                    );
+                    // The result from runAgent contains the MCP response
+                    sendResponse(msg.id, runResult.result || {});
+                  } catch (err) {
+                    console.error("[MCPAppsRenderer] tools/call error:", err);
+                    sendErrorResponse(msg.id, -32603, String(err));
+                  }
+                  break;
+                }
+                default:
+                  sendErrorResponse(
+                    msg.id,
+                    -32601,
+                    `Method not found: ${msg.method}`,
+                  );
+              }
+            }
+            // Handle notifications (no response needed)
+            if (isNotification(msg)) {
+              switch (msg.method) {
+                case "ui/notifications/initialized": {
+                  console.log("[MCPAppsRenderer] Inner iframe initialized");
+                  if (mounted) {
+                    setIframeReady(true);
+                  }
+                  break;
+                }
+                case "ui/notifications/size-changed": {
+                  const { width, height } = msg.params || {};
+                  console.log("[MCPAppsRenderer] Size change:", {
+                    width,
+                    height,
+                  });
+                  if (mounted) {
+                    setIframeSize({
+                      width: typeof width === "number" ? width : undefined,
+                      height: typeof height === "number" ? height : undefined,
+                    });
+                  }
+                  break;
+                }
+                case "notifications/message": {
+                  // Logging notification from the app
+                  console.log("[MCPAppsRenderer] App log:", msg.params);
+                  break;
+                }
+              }
+            }
+          };
+          window.addEventListener("message", messageHandler);
+          // Extract HTML content from fetched resource
+          let html: string;
+          if (fetchedResource.text) {
+            html = fetchedResource.text;
+          } else if (fetchedResource.blob) {
+            html = atob(fetchedResource.blob);
+          } else {
+            throw new Error("Resource has no text or blob content");
+          }
+          // Send the resource content to the sandbox proxy
+          sendNotification("ui/notifications/sandbox-resource-ready", { html });
+        } catch (err) {
+          console.error("[MCPAppsRenderer] Setup error:", err);
+          if (mounted) {
+            setError(err instanceof Error ? err : new Error(String(err)));
+          }
+        }
+      };
+      setup();
+      return () => {
+        mounted = false;
+        // Clean up initial listener if still active
+        if (initialListener) {
+          window.removeEventListener("message", initialListener);
+          initialListener = null;
+        }
+        if (messageHandler) {
+          window.removeEventListener("message", messageHandler);
+        }
+        // Remove the iframe we created (using tracked reference, not DOM query)
+        // This works even if containerRef.current is null during unmount
+        if (createdIframe) {
+          createdIframe.remove();
+          createdIframe = null;
+        }
+        iframeRef.current = null;
+      };
+    }, [
+      isLoading,
+      fetchedResource,
+      sendNotification,
+      sendResponse,
+      sendErrorResponse,
+    ]);
+    // Effect 2: Update iframe size when it changes
+    useEffect(() => {
+      if (iframeRef.current) {
+        if (iframeSize.width !== undefined) {
+          // Use minWidth with min() to allow expansion but cap at 100%
+          iframeRef.current.style.minWidth = `min(${iframeSize.width}px, 100%)`;
+          iframeRef.current.style.width = "100%";
+        }
+        if (iframeSize.height !== undefined) {
+          iframeRef.current.style.height = `${iframeSize.height}px`;
+        }
+      }
+    }, [iframeSize]);
+    // Effect 3: Send tool input when iframe ready
+    useEffect(() => {
+      if (iframeReady && content.toolInput) {
+        console.log("[MCPAppsRenderer] Sending tool input:", content.toolInput);
+        sendNotification("ui/notifications/tool-input", {
+          arguments: content.toolInput,
+        });
+      }
+    }, [iframeReady, content.toolInput, sendNotification]);
+    // Effect 4: Send tool result when iframe ready
+    useEffect(() => {
+      if (iframeReady && content.result) {
+        console.log("[MCPAppsRenderer] Sending tool result:", content.result);
+        sendNotification("ui/notifications/tool-result", content.result);
+      }
+    }, [iframeReady, content.result, sendNotification]);
+    // Determine border styling based on prefersBorder metadata from fetched resource
+    // true = show border/background, false = none, undefined = host decides (we default to none)
+    const prefersBorder = fetchedResource?._meta?.ui?.prefersBorder;
+    const borderStyle =
+      prefersBorder === true
+        ? {
+            borderRadius: "8px",
+            backgroundColor: "#f9f9f9",
+            border: "1px solid #e0e0e0",
+          }
+        : {};
+    return (
+      <div
+        ref={containerRef}
+        style={{
+          width: "100%",
+          height: iframeSize.height ? `${iframeSize.height}px` : "auto",
+          minHeight: "100px",
+          overflow: "hidden",
+          position: "relative",
+          ...borderStyle,
+        }}
+      >
+        {isLoading && (
+          <div style={{ padding: "1rem", color: "#666" }}>Loading...</div>
+        )}
+        {error && (
+          <div style={{ color: "red", padding: "1rem" }}>
+            Error: {error.message}
+          </div>
+        )}
+      </div>
+    );
+  };