npm - @copilotkit/react-core - Versions diffs - 1.57.3 → 1.58.0 - Mend

@copilotkit/react-core 1.57.3 → 1.58.0

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 (282) hide show

package/LICENSE +21 -0
package/dist/{copilotkit-CC8DjOiC.mjs → copilotkit-BIn7HE8f.mjs} +2 -2
package/dist/{copilotkit-CC8DjOiC.mjs.map → copilotkit-BIn7HE8f.mjs.map} +1 -1
package/dist/{copilotkit-CtXcs1ea.cjs → copilotkit-Drw-g6zA.cjs} +2 -2
package/dist/{copilotkit-CtXcs1ea.cjs.map → copilotkit-Drw-g6zA.cjs.map} +1 -1
package/dist/index.cjs +3 -77
package/dist/index.cjs.map +1 -1
package/dist/index.d.cts +2 -2
package/dist/index.d.mts +2 -2
package/dist/index.mjs +3 -77
package/dist/index.mjs.map +1 -1
package/dist/index.umd.js +3 -77
package/dist/index.umd.js.map +1 -1
package/dist/v2/index.cjs +1 -1
package/dist/v2/index.mjs +1 -1
package/dist/v2/index.umd.js +1 -1
package/dist/v2/index.umd.js.map +1 -1
package/package.json +12 -13
package/skills/react-core/SKILL.md +108 -0
package/skills/react-core/references/agent-access.md +288 -0
package/skills/react-core/references/attachments.md +291 -0
package/skills/react-core/references/capabilities.md +138 -0
package/skills/react-core/references/chat-components.md +221 -0
package/skills/react-core/references/client-side-tools.md +358 -0
package/skills/react-core/references/custom-message-renderers.md +226 -0
package/skills/react-core/references/debug-mode.md +153 -0
package/skills/react-core/references/human-in-the-loop.md +312 -0
package/skills/react-core/references/provider-setup.md +326 -0
package/skills/react-core/references/rendering-activity-messages.md +207 -0
package/skills/react-core/references/rendering-tool-calls.md +319 -0
package/skills/react-core/references/suggestions.md +211 -0
package/skills/react-core/references/switching-agents-recipes.md +160 -0
package/skills/react-core/references/switching-agents.md +231 -0
package/skills/react-core/references/threads.md +226 -0
package/.attw.json +0 -3
package/CHANGELOG.md +0 -5043
package/scripts/scope-preflight.mjs +0 -100
package/src/components/CopilotListeners.tsx +0 -137
package/src/components/__tests__/CopilotListeners.test.tsx +0 -38
package/src/components/copilot-provider/__tests__/copilot-messages-key.test.tsx +0 -92
package/src/components/copilot-provider/__tests__/copilotkit-error.test.tsx +0 -77
package/src/components/copilot-provider/__tests__/error-visibility-prod.test.tsx +0 -70
package/src/components/copilot-provider/__tests__/v1-explicit-threadid-bridge.test.tsx +0 -107
package/src/components/copilot-provider/copilot-messages.tsx +0 -314
package/src/components/copilot-provider/copilotkit-props.tsx +0 -214
package/src/components/copilot-provider/copilotkit.tsx +0 -853
package/src/components/copilot-provider/index.ts +0 -3
package/src/components/dev-console/console-trigger.tsx +0 -283
package/src/components/dev-console/developer-console-modal.tsx +0 -1016
package/src/components/dev-console/icons.tsx +0 -106
package/src/components/error-boundary/error-boundary.tsx +0 -99
package/src/components/error-boundary/error-utils.tsx +0 -105
package/src/components/index.ts +0 -1
package/src/components/toast/exclamation-mark-icon.tsx +0 -27
package/src/components/toast/toast-provider.tsx +0 -448
package/src/components/usage-banner.tsx +0 -266
package/src/context/__tests__/threads-context.test.tsx +0 -141
package/src/context/coagent-state-renders-context.tsx +0 -89
package/src/context/copilot-context.tsx +0 -365
package/src/context/copilot-messages-context.tsx +0 -35
package/src/context/index.ts +0 -22
package/src/context/threads-context.tsx +0 -69
package/src/hooks/__tests__/use-coagent-config.test.ts +0 -352
package/src/hooks/__tests__/use-coagent-state-render-bridge.helpers.test.ts +0 -107
package/src/hooks/__tests__/use-coagent-state-render.e2e.test.tsx +0 -1209
package/src/hooks/__tests__/use-coagent-state-render.test.tsx +0 -356
package/src/hooks/__tests__/use-copilot-chat-internal-connect.test.tsx +0 -241
package/src/hooks/__tests__/use-frontend-tool-available.test.tsx +0 -72
package/src/hooks/__tests__/use-frontend-tool-remount.e2e.test.tsx +0 -102
package/src/hooks/index.ts +0 -33
package/src/hooks/use-agent-nodename.ts +0 -33
package/src/hooks/use-coagent-state-render-bridge.helpers.ts +0 -345
package/src/hooks/use-coagent-state-render-bridge.tsx +0 -222
package/src/hooks/use-coagent-state-render-registry.ts +0 -230
package/src/hooks/use-coagent-state-render.ts +0 -163
package/src/hooks/use-coagent.ts +0 -377
package/src/hooks/use-configure-chat-suggestions.tsx +0 -96
package/src/hooks/use-copilot-action.ts +0 -245
package/src/hooks/use-copilot-additional-instructions.ts +0 -98
package/src/hooks/use-copilot-authenticated-action.ts +0 -73
package/src/hooks/use-copilot-chat-headless_c.ts +0 -264
package/src/hooks/use-copilot-chat-suggestions.tsx +0 -134
package/src/hooks/use-copilot-chat.ts +0 -132
package/src/hooks/use-copilot-chat_internal.ts +0 -875
package/src/hooks/use-copilot-readable.ts +0 -135
package/src/hooks/use-copilot-runtime-client.ts +0 -178
package/src/hooks/use-default-tool.ts +0 -13
package/src/hooks/use-flat-category-store.ts +0 -109
package/src/hooks/use-frontend-tool.ts +0 -113
package/src/hooks/use-human-in-the-loop.ts +0 -138
package/src/hooks/use-langgraph-interrupt.ts +0 -103
package/src/hooks/use-lazy-tool-renderer.tsx +0 -30
package/src/hooks/use-make-copilot-document-readable.ts +0 -30
package/src/hooks/use-render-tool-call.ts +0 -89
package/src/hooks/use-tree.ts +0 -222
package/src/index.tsx +0 -7
package/src/lib/copilot-task.ts +0 -215
package/src/lib/index.ts +0 -1
package/src/lib/status-checker.ts +0 -67
package/src/setupTests.ts +0 -37
package/src/test-helpers/copilot-context.ts +0 -91
package/src/types/chat-suggestion-configuration.ts +0 -23
package/src/types/coagent-action.ts +0 -35
package/src/types/coagent-state.ts +0 -13
package/src/types/crew.ts +0 -89
package/src/types/document-pointer.ts +0 -7
package/src/types/frontend-action.ts +0 -213
package/src/types/index.ts +0 -17
package/src/types/interrupt-action.ts +0 -58
package/src/types/system-message.ts +0 -4
package/src/utils/dev-console.ts +0 -19
package/src/utils/index.ts +0 -2
package/src/utils/suggestions-constants.ts +0 -8
package/src/utils/utils.test.ts +0 -7
package/src/utils/utils.ts +0 -6
package/src/v2/__tests__/A2UIMessageRenderer.test.tsx +0 -240
package/src/v2/__tests__/globalSetup.ts +0 -14
package/src/v2/__tests__/setup.ts +0 -93
package/src/v2/__tests__/utils/test-helpers.tsx +0 -570
package/src/v2/a2ui/A2UICatalogContext.tsx +0 -79
package/src/v2/a2ui/A2UIMessageRenderer.tsx +0 -294
package/src/v2/a2ui/A2UIToolCallRenderer.tsx +0 -290
package/src/v2/components/CopilotKitInspector.tsx +0 -52
package/src/v2/components/MCPAppsActivityRenderer.tsx +0 -815
package/src/v2/components/OpenGenerativeUIRenderer.tsx +0 -598
package/src/v2/components/WildcardToolCallRender.tsx +0 -86
package/src/v2/components/__tests__/OpenGenerativeUIRenderer.test.tsx +0 -665
package/src/v2/components/chat/CopilotChat.tsx +0 -664
package/src/v2/components/chat/CopilotChatAssistantMessage.tsx +0 -393
package/src/v2/components/chat/CopilotChatAttachmentQueue.tsx +0 -374
package/src/v2/components/chat/CopilotChatAttachmentRenderer.tsx +0 -159
package/src/v2/components/chat/CopilotChatAudioRecorder.tsx +0 -350
package/src/v2/components/chat/CopilotChatInput.tsx +0 -1412
package/src/v2/components/chat/CopilotChatMessageView.tsx +0 -716
package/src/v2/components/chat/CopilotChatReasoningMessage.tsx +0 -265
package/src/v2/components/chat/CopilotChatSuggestionPill.tsx +0 -59
package/src/v2/components/chat/CopilotChatSuggestionView.tsx +0 -134
package/src/v2/components/chat/CopilotChatToggleButton.tsx +0 -171
package/src/v2/components/chat/CopilotChatToolCallsView.tsx +0 -40
package/src/v2/components/chat/CopilotChatUserMessage.tsx +0 -445
package/src/v2/components/chat/CopilotChatView.tsx +0 -890
package/src/v2/components/chat/CopilotModalHeader.tsx +0 -129
package/src/v2/components/chat/CopilotPopup.tsx +0 -81
package/src/v2/components/chat/CopilotPopupView.tsx +0 -317
package/src/v2/components/chat/CopilotSidebar.tsx +0 -80
package/src/v2/components/chat/CopilotSidebarView.tsx +0 -269
package/src/v2/components/chat/Lightbox.tsx +0 -103
package/src/v2/components/chat/__tests__/CopilotChat.absentThreadConnect.test.tsx +0 -66
package/src/v2/components/chat/__tests__/CopilotChat.attachments.test.tsx +0 -168
package/src/v2/components/chat/__tests__/CopilotChat.e2e.test.tsx +0 -1239
package/src/v2/components/chat/__tests__/CopilotChat.onError.test.tsx +0 -73
package/src/v2/components/chat/__tests__/CopilotChat.slots.e2e.test.tsx +0 -432
package/src/v2/components/chat/__tests__/CopilotChat.suggestionsAlways.test.tsx +0 -183
package/src/v2/components/chat/__tests__/CopilotChat.welcomeGate.test.tsx +0 -184
package/src/v2/components/chat/__tests__/CopilotChatActivityRendering.e2e.test.tsx +0 -649
package/src/v2/components/chat/__tests__/CopilotChatAssistantMessage.slots.e2e.test.tsx +0 -624
package/src/v2/components/chat/__tests__/CopilotChatAssistantMessage.test.tsx +0 -702
package/src/v2/components/chat/__tests__/CopilotChatAssistantMessage.thumbs.test.tsx +0 -72
package/src/v2/components/chat/__tests__/CopilotChatCopyButton.clipboard.test.tsx +0 -241
package/src/v2/components/chat/__tests__/CopilotChatCssClasses.test.tsx +0 -107
package/src/v2/components/chat/__tests__/CopilotChatInput.slots.e2e.test.tsx +0 -929
package/src/v2/components/chat/__tests__/CopilotChatInput.test.tsx +0 -1567
package/src/v2/components/chat/__tests__/CopilotChatMessageView.slots.e2e.test.tsx +0 -1004
package/src/v2/components/chat/__tests__/CopilotChatMessageView.test.tsx +0 -279
package/src/v2/components/chat/__tests__/CopilotChatPerf.e2e.test.tsx +0 -336
package/src/v2/components/chat/__tests__/CopilotChatPropsRerender.e2e.test.tsx +0 -249
package/src/v2/components/chat/__tests__/CopilotChatSuggestionView.slots.e2e.test.tsx +0 -530
package/src/v2/components/chat/__tests__/CopilotChatToolRendering.e2e.test.tsx +0 -785
package/src/v2/components/chat/__tests__/CopilotChatToolRerenders.e2e.test.tsx +0 -2416
package/src/v2/components/chat/__tests__/CopilotChatUserMessage.slots.e2e.test.tsx +0 -621
package/src/v2/components/chat/__tests__/CopilotChatView.connectingGate.test.tsx +0 -56
package/src/v2/components/chat/__tests__/CopilotChatView.inputOverlay.test.tsx +0 -264
package/src/v2/components/chat/__tests__/CopilotChatView.onClick.e2e.test.tsx +0 -853
package/src/v2/components/chat/__tests__/CopilotChatView.pinToSend.test.tsx +0 -94
package/src/v2/components/chat/__tests__/CopilotChatView.slots.e2e.test.tsx +0 -1050
package/src/v2/components/chat/__tests__/CopilotModalHeader.slots.e2e.test.tsx +0 -484
package/src/v2/components/chat/__tests__/CopilotPopupView.slots.e2e.test.tsx +0 -612
package/src/v2/components/chat/__tests__/CopilotSidebarView.position.test.tsx +0 -159
package/src/v2/components/chat/__tests__/CopilotSidebarView.slots.e2e.test.tsx +0 -502
package/src/v2/components/chat/__tests__/MCPAppsActivityRenderer.e2e.test.tsx +0 -1068
package/src/v2/components/chat/__tests__/MCPAppsProxy.e2e.test.tsx +0 -589
package/src/v2/components/chat/__tests__/MCPAppsUiMessage.e2e.test.tsx +0 -403
package/src/v2/components/chat/__tests__/copilot-chat-throttle.test.tsx +0 -137
package/src/v2/components/chat/__tests__/normalize-auto-scroll.test.ts +0 -37
package/src/v2/components/chat/__tests__/setup.ts +0 -1
package/src/v2/components/chat/index.ts +0 -90
package/src/v2/components/chat/last-user-message-context.ts +0 -21
package/src/v2/components/chat/normalize-auto-scroll.ts +0 -17
package/src/v2/components/chat/scroll-element-context.ts +0 -13
package/src/v2/components/index.ts +0 -8
package/src/v2/components/intelligence-indicator/IntelligenceIndicator.tsx +0 -286
package/src/v2/components/intelligence-indicator/__tests__/IntelligenceIndicator.e2e.test.tsx +0 -464
package/src/v2/components/intelligence-indicator/index.ts +0 -2
package/src/v2/components/license-warning-banner.tsx +0 -217
package/src/v2/components/ui/button.tsx +0 -124
package/src/v2/components/ui/dropdown-menu.tsx +0 -258
package/src/v2/components/ui/tooltip.tsx +0 -60
package/src/v2/context.ts +0 -62
package/src/v2/headless.ts +0 -64
package/src/v2/hooks/__tests__/standard-schema-types.test.tsx +0 -152
package/src/v2/hooks/__tests__/standard-schema.test.tsx +0 -282
package/src/v2/hooks/__tests__/use-agent-context-timing.e2e.test.tsx +0 -140
package/src/v2/hooks/__tests__/use-agent-context.test.tsx +0 -401
package/src/v2/hooks/__tests__/use-agent-error-state.test.tsx +0 -44
package/src/v2/hooks/__tests__/use-agent-stability.test.tsx +0 -211
package/src/v2/hooks/__tests__/use-agent-throttle.test.tsx +0 -1029
package/src/v2/hooks/__tests__/use-agent.e2e.test.tsx +0 -159
package/src/v2/hooks/__tests__/use-attachments.test.tsx +0 -169
package/src/v2/hooks/__tests__/use-capabilities.test.tsx +0 -76
package/src/v2/hooks/__tests__/use-component.test.tsx +0 -126
package/src/v2/hooks/__tests__/use-configure-suggestions.e2e.test.tsx +0 -696
package/src/v2/hooks/__tests__/use-default-render-tool.test.tsx +0 -153
package/src/v2/hooks/__tests__/use-frontend-tool-available.test.tsx +0 -167
package/src/v2/hooks/__tests__/use-frontend-tool.e2e.test.tsx +0 -2148
package/src/v2/hooks/__tests__/use-human-in-the-loop.e2e.test.tsx +0 -1261
package/src/v2/hooks/__tests__/use-interrupt.test.tsx +0 -397
package/src/v2/hooks/__tests__/use-katex-styles.test.tsx +0 -56
package/src/v2/hooks/__tests__/use-keyboard-height.test.tsx +0 -192
package/src/v2/hooks/__tests__/use-pin-to-send.test.tsx +0 -219
package/src/v2/hooks/__tests__/use-render-custom-messages.test.tsx +0 -55
package/src/v2/hooks/__tests__/use-render-tool.test.tsx +0 -259
package/src/v2/hooks/__tests__/use-suggestions.e2e.test.tsx +0 -524
package/src/v2/hooks/__tests__/use-threads.test.tsx +0 -757
package/src/v2/hooks/__tests__/zod-regression.test.tsx +0 -311
package/src/v2/hooks/index.ts +0 -24
package/src/v2/hooks/use-agent-context.tsx +0 -45
package/src/v2/hooks/use-agent.tsx +0 -227
package/src/v2/hooks/use-attachments.tsx +0 -269
package/src/v2/hooks/use-capabilities.tsx +0 -25
package/src/v2/hooks/use-component.tsx +0 -91
package/src/v2/hooks/use-configure-suggestions.tsx +0 -236
package/src/v2/hooks/use-default-render-tool.tsx +0 -271
package/src/v2/hooks/use-frontend-tool.tsx +0 -46
package/src/v2/hooks/use-human-in-the-loop.tsx +0 -81
package/src/v2/hooks/use-interrupt.tsx +0 -305
package/src/v2/hooks/use-keyboard-height.tsx +0 -67
package/src/v2/hooks/use-pin-to-send.ts +0 -94
package/src/v2/hooks/use-render-activity-message.tsx +0 -72
package/src/v2/hooks/use-render-custom-messages.tsx +0 -93
package/src/v2/hooks/use-render-tool-call.tsx +0 -208
package/src/v2/hooks/use-render-tool.tsx +0 -184
package/src/v2/hooks/use-suggestions.tsx +0 -91
package/src/v2/hooks/use-threads.tsx +0 -325
package/src/v2/hooks/useKatexStyles.ts +0 -27
package/src/v2/index.css +0 -1
package/src/v2/index.ts +0 -27
package/src/v2/lib/__tests__/completePartialMarkdown.test.ts +0 -495
package/src/v2/lib/__tests__/processPartialHtml.test.ts +0 -112
package/src/v2/lib/__tests__/renderSlot.test.tsx +0 -588
package/src/v2/lib/__tests__/slots.test.ts +0 -56
package/src/v2/lib/processPartialHtml.ts +0 -45
package/src/v2/lib/react-core.ts +0 -156
package/src/v2/lib/slots.tsx +0 -184
package/src/v2/lib/transcription-client.ts +0 -184
package/src/v2/lib/utils.ts +0 -8
package/src/v2/providers/CopilotChatConfigurationProvider.tsx +0 -196
package/src/v2/providers/CopilotKitProvider.tsx +0 -800
package/src/v2/providers/SandboxFunctionsContext.ts +0 -10
package/src/v2/providers/__tests__/CopilotChatConfigurationProvider.test.tsx +0 -652
package/src/v2/providers/__tests__/CopilotKitProvider.license.test.tsx +0 -101
package/src/v2/providers/__tests__/CopilotKitProvider.onError.test.tsx +0 -69
package/src/v2/providers/__tests__/CopilotKitProvider.renderCustomMessages.e2e.test.tsx +0 -881
package/src/v2/providers/__tests__/CopilotKitProvider.sandboxFunctions.test.tsx +0 -198
package/src/v2/providers/__tests__/CopilotKitProvider.stability.test.tsx +0 -740
package/src/v2/providers/__tests__/CopilotKitProvider.test.tsx +0 -713
package/src/v2/providers/__tests__/CopilotKitProvider.wildcard.test.tsx +0 -294
package/src/v2/providers/index.ts +0 -21
package/src/v2/styles/globals.css +0 -349
package/src/v2/types/__tests__/defineToolCallRenderer.test.tsx +0 -525
package/src/v2/types/defineToolCallRenderer.ts +0 -68
package/src/v2/types/frontend-tool.ts +0 -8
package/src/v2/types/human-in-the-loop.ts +0 -33
package/src/v2/types/index.ts +0 -8
package/src/v2/types/interrupt.ts +0 -15
package/src/v2/types/react-activity-message-renderer.ts +0 -27
package/src/v2/types/react-custom-message-renderer.ts +0 -17
package/src/v2/types/react-tool-call-renderer.ts +0 -35
package/src/v2/types/sandbox-function.ts +0 -11
package/tsconfig.json +0 -8
package/tsdown.config.ts +0 -193
package/typedoc.json +0 -4
package/vitest.config.mjs +0 -31

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

@@ -1,815 +0,0 @@
-"use client";
-import React, { useEffect, useRef, useState, useCallback } from "react";
-import { z } from "zod";
-import type { AbstractAgent, RunAgentResult } from "@ag-ui/client";
-import { useCopilotKit } from "../providers/CopilotKitProvider";
-// 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 { copilotkit } = useCopilotKit();
-    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 and optionally invoke agent
-                  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 }>;
-                      followUp?: boolean;
-                    };
-                    const role =
-                      (params.role as "user" | "assistant") || "user";
-                    // 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,
-                        content: textContent,
-                      });
-                    }
-                    // Acknowledge the message immediately — don't block on agent run
-                    sendResponse(msg.id, { isError: false });
-                    // Determine whether to invoke the agent after adding message.
-                    // followUp: true  → always invoke agent
-                    // followUp: false → display-only, skip agent
-                    // not specified   → invoke for user messages, skip for assistant
-                    const shouldFollowUp = params.followUp ?? role === "user";
-                    if (shouldFollowUp && textContent) {
-                      // Use copilotkit.runAgent to go through RunHandler — provides
-                      // frontend tools, context, tool execution, and abort support.
-                      // Fire-and-forget: errors are handled by RunHandler's error emission.
-                      mcpAppsRequestQueue
-                        .enqueue(currentAgent, () =>
-                          copilotkit.runAgent({ agent: currentAgent }),
-                        )
-                        .catch((err) =>
-                          console.error(
-                            "[MCPAppsRenderer] ui/message agent run failed:",
-                            err,
-                          ),
-                        );
-                    }
-                  } 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>
-    );
-  };