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

@copilotkit/react-core 1.55.0-next.8 → 1.55.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 (94) hide show

package/CHANGELOG.md +48 -5
package/dist/{copilotkit-DNYSFuz5.mjs → copilotkit-BY5S1-0P.mjs} +2772 -858
package/dist/copilotkit-BY5S1-0P.mjs.map +1 -0
package/dist/{copilotkit-Dy5w3qEV.d.mts → copilotkit-BuhSUZHb.d.mts} +230 -17
package/dist/copilotkit-BuhSUZHb.d.mts.map +1 -0
package/dist/{copilotkit-B3Mb1yVE.cjs → copilotkit-Bz5-ImDl.cjs} +2776 -832
package/dist/copilotkit-Bz5-ImDl.cjs.map +1 -0
package/dist/{copilotkit-DBzgOMby.d.cts → copilotkit-dwDWYpya.d.cts} +230 -17
package/dist/copilotkit-dwDWYpya.d.cts.map +1 -0
package/dist/index.cjs +9 -4
package/dist/index.cjs.map +1 -1
package/dist/index.d.cts +1 -1
package/dist/index.d.mts +1 -1
package/dist/index.mjs +9 -4
package/dist/index.mjs.map +1 -1
package/dist/index.umd.js +1624 -396
package/dist/index.umd.js.map +1 -1
package/dist/v2/index.cjs +13 -1
package/dist/v2/index.css +1 -1
package/dist/v2/index.d.cts +3 -3
package/dist/v2/index.d.mts +3 -3
package/dist/v2/index.mjs +3 -2
package/dist/v2/index.umd.js +2746 -790
package/dist/v2/index.umd.js.map +1 -1
package/package.json +62 -54
package/scripts/scope-preflight.mjs +1 -2
package/src/components/CopilotListeners.tsx +41 -8
package/src/components/copilot-provider/__tests__/copilot-messages-key.test.tsx +92 -0
package/src/components/copilot-provider/copilotkit-props.tsx +4 -2
package/src/components/copilot-provider/copilotkit.tsx +3 -3
package/src/components/toast/toast-provider.tsx +269 -194
package/src/hooks/__tests__/use-copilot-chat-internal-connect.test.tsx +27 -16
package/src/hooks/use-copilot-chat_internal.ts +15 -4
package/src/v2/__tests__/A2UIMessageRenderer.test.tsx +86 -22
package/src/v2/__tests__/utils/test-helpers.tsx +107 -7
package/src/v2/a2ui/A2UICatalogContext.tsx +79 -0
package/src/v2/a2ui/A2UIMessageRenderer.tsx +125 -37
package/src/v2/a2ui/A2UIToolCallRenderer.tsx +290 -0
package/src/v2/components/CopilotKitInspector.tsx +2 -0
package/src/v2/components/OpenGenerativeUIRenderer.tsx +598 -0
package/src/v2/components/__tests__/OpenGenerativeUIRenderer.test.tsx +665 -0
package/src/v2/components/chat/CopilotChat.tsx +197 -52
package/src/v2/components/chat/CopilotChatAssistantMessage.tsx +17 -2
package/src/v2/components/chat/CopilotChatAttachmentQueue.tsx +481 -0
package/src/v2/components/chat/CopilotChatAttachmentRenderer.tsx +139 -0
package/src/v2/components/chat/CopilotChatInput.tsx +146 -77
package/src/v2/components/chat/CopilotChatMessageView.tsx +260 -151
package/src/v2/components/chat/CopilotChatSuggestionView.tsx +1 -0
package/src/v2/components/chat/CopilotChatUserMessage.tsx +54 -0
package/src/v2/components/chat/CopilotChatView.tsx +179 -66
package/src/v2/components/chat/__tests__/CopilotChat.attachments.test.tsx +168 -0
package/src/v2/components/chat/__tests__/CopilotChatActivityRendering.e2e.test.tsx +63 -2
package/src/v2/components/chat/__tests__/CopilotChatInput.test.tsx +544 -1
package/src/v2/components/chat/__tests__/CopilotChatPerf.e2e.test.tsx +268 -0
package/src/v2/components/chat/__tests__/CopilotChatPropsRerender.e2e.test.tsx +249 -0
package/src/v2/components/chat/__tests__/CopilotChatToolRendering.e2e.test.tsx +5 -2
package/src/v2/components/chat/__tests__/CopilotChatToolRerenders.e2e.test.tsx +5 -2
package/src/v2/components/chat/__tests__/MCPAppsActivityRenderer.e2e.test.tsx +60 -3
package/src/v2/components/chat/__tests__/copilot-chat-throttle.test.tsx +138 -0
package/src/v2/components/chat/index.ts +9 -0
package/src/v2/components/chat/scroll-element-context.ts +13 -0
package/src/v2/hooks/__tests__/use-agent-context-timing.e2e.test.tsx +8 -0
package/src/v2/hooks/__tests__/use-agent-thread-isolation.test.tsx +327 -0
package/src/v2/hooks/__tests__/use-agent-throttle.test.tsx +1003 -0
package/src/v2/hooks/__tests__/use-agent.e2e.test.tsx +13 -2
package/src/v2/hooks/__tests__/use-attachments.test.tsx +169 -0
package/src/v2/hooks/__tests__/use-frontend-tool.e2e.test.tsx +23 -4
package/src/v2/hooks/__tests__/use-threads.test.tsx +54 -0
package/src/v2/hooks/index.ts +5 -0
package/src/v2/hooks/use-agent.tsx +220 -15
package/src/v2/hooks/use-attachments.tsx +269 -0
package/src/v2/hooks/use-frontend-tool.tsx +5 -2
package/src/v2/hooks/use-render-activity-message.tsx +9 -2
package/src/v2/hooks/use-render-custom-messages.tsx +6 -1
package/src/v2/hooks/use-threads.tsx +35 -15
package/src/v2/index.ts +5 -1
package/src/v2/lib/__tests__/processPartialHtml.test.ts +112 -0
package/src/v2/lib/__tests__/slots.test.ts +56 -0
package/src/v2/lib/processPartialHtml.ts +45 -0
package/src/v2/lib/slots.tsx +42 -1
package/src/v2/providers/CopilotChatConfigurationProvider.tsx +9 -3
package/src/v2/providers/CopilotKitProvider.tsx +268 -32
package/src/v2/providers/SandboxFunctionsContext.ts +10 -0
package/src/v2/providers/__tests__/CopilotKitProvider.sandboxFunctions.test.tsx +198 -0
package/src/v2/providers/__tests__/CopilotKitProvider.test.tsx +71 -0
package/src/v2/providers/index.ts +7 -0
package/src/v2/styles/globals.css +2 -1
package/src/v2/types/index.ts +1 -0
package/src/v2/types/sandbox-function.ts +11 -0
package/dist/copilotkit-B3Mb1yVE.cjs.map +0 -1
package/dist/copilotkit-DBzgOMby.d.cts.map +0 -1
package/dist/copilotkit-DNYSFuz5.mjs.map +0 -1
package/dist/copilotkit-Dy5w3qEV.d.mts.map +0 -1
package/src/v2/components/__tests__/license-warning-banner.test.tsx +0 -46

package/src/v2/components/__tests__/OpenGenerativeUIRenderer.test.tsx ADDED Viewed

@@ -0,0 +1,665 @@
+import { render, cleanup, act } from "@testing-library/react";
+import { describe, it, expect, vi, beforeEach, afterEach } from "vitest";
+import React from "react";
+import { z } from "zod";
+import {
+  OpenGenerativeUIActivityRenderer,
+  OpenGenerativeUIContent,
+} from "../OpenGenerativeUIRenderer";
+import { SandboxFunctionsContext } from "../../providers/SandboxFunctionsContext";
+import type { SandboxFunction } from "../../types/sandbox-function";
+// Mock @jetbrains/websandbox
+const mockRun = vi.fn().mockResolvedValue(undefined);
+const mockDestroy = vi.fn();
+let mockIframe: HTMLIFrameElement;
+let mockPromiseResolve: () => void;
+let mockPromise: Promise<unknown>;
+function resetMockPromise() {
+  mockPromise = new Promise<void>((resolve) => {
+    mockPromiseResolve = resolve;
+  });
+}
+const mockCreate = vi.fn(() => {
+  mockIframe = document.createElement("iframe");
+  return {
+    iframe: mockIframe,
+    promise: mockPromise,
+    run: mockRun,
+    destroy: mockDestroy,
+  };
+});
+vi.mock("@jetbrains/websandbox", () => ({
+  default: {
+    create: (...args: unknown[]) => mockCreate(...args),
+  },
+}));
+/** Flush the dynamic import() microtask so the sandbox gets created */
+async function flushImport() {
+  await act(async () => {
+    await new Promise((r) => setTimeout(r, 0));
+  });
+}
+function renderRenderer(content: OpenGenerativeUIContent) {
+  return render(
+    <OpenGenerativeUIActivityRenderer
+      activityType="open-generative-ui"
+      content={content}
+      message={{}}
+      agent={{}}
+    />,
+  );
+}
+describe("OpenGenerativeUIActivityRenderer", () => {
+  beforeEach(() => {
+    vi.clearAllMocks();
+    resetMockPromise();
+  });
+  afterEach(() => {
+    cleanup();
+  });
+  it("renders placeholder when no html", async () => {
+    const { container } = renderRenderer({ initialHeight: 300 });
+    await flushImport();
+    const div = container.firstElementChild as HTMLElement;
+    expect(div.style.height).toBe("300px");
+    expect(div.querySelector("svg")).not.toBeNull();
+    expect(mockCreate).not.toHaveBeenCalled();
+  });
+  it("creates sandbox when html is complete", async () => {
+    const html = "<head></head><body><p>Hello</p></body>";
+    renderRenderer({ html: [html], htmlComplete: true });
+    await flushImport();
+    expect(mockCreate).toHaveBeenCalledTimes(1);
+    const [, options] = mockCreate.mock.calls[0];
+    expect(options.frameContent).toBe(html);
+    expect(options.frameContainer).toBeInstanceOf(HTMLElement);
+  });
+  it("creates preview sandbox when html is streaming (not complete)", async () => {
+    renderRenderer({
+      html: ["<head></head><body>partial"],
+      htmlComplete: false,
+      cssComplete: true,
+    });
+    await flushImport();
+    // Preview sandbox is created with empty body template
+    expect(mockCreate).toHaveBeenCalledTimes(1);
+    const [, options] = mockCreate.mock.calls[0];
+    expect(options.frameContent).toBe("<head></head><body></body>");
+  });
+  it("wraps html missing <head>", async () => {
+    renderRenderer({
+      html: ["<body><p>No head</p></body>"],
+      htmlComplete: true,
+    });
+    await flushImport();
+    expect(mockCreate).toHaveBeenCalledTimes(1);
+    const [, options] = mockCreate.mock.calls[0];
+    expect(options.frameContent).toContain("<head></head>");
+  });
+  it("joins html chunks when complete", async () => {
+    renderRenderer({
+      html: ["<head></head>", "<body>", "<p>Hello</p>", "</body>"],
+      htmlComplete: true,
+    });
+    await flushImport();
+    expect(mockCreate).toHaveBeenCalledTimes(1);
+    const [, options] = mockCreate.mock.calls[0];
+    expect(options.frameContent).toBe("<head></head><body><p>Hello</p></body>");
+  });
+  it("destroys sandbox on unmount", async () => {
+    const { unmount } = renderRenderer({
+      html: ["<head></head><body></body>"],
+      htmlComplete: true,
+    });
+    await flushImport();
+    expect(mockCreate).toHaveBeenCalledTimes(1);
+    unmount();
+    expect(mockDestroy).toHaveBeenCalledTimes(1);
+  });
+  it("injects jsFunctions via run()", async () => {
+    const jsFunctions = "function greet() { return 'hi'; }";
+    renderRenderer({
+      html: ["<head></head><body></body>"],
+      htmlComplete: true,
+      jsFunctions,
+    });
+    await flushImport();
+    // Resolve sandbox promise
+    await act(async () => {
+      mockPromiseResolve();
+      await mockPromise;
+    });
+    await flushImport();
+    expect(mockRun).toHaveBeenCalledWith(jsFunctions);
+  });
+  it("executes jsExpressions sequentially", async () => {
+    renderRenderer({
+      html: ["<head></head><body></body>"],
+      htmlComplete: true,
+      jsExpressions: ["expr1()", "expr2()"],
+    });
+    await flushImport();
+    await act(async () => {
+      mockPromiseResolve();
+      await mockPromise;
+    });
+    await flushImport();
+    expect(mockRun).toHaveBeenCalledWith("expr1()");
+    expect(mockRun).toHaveBeenCalledWith("expr2()");
+  });
+  it("tracks index — no re-execution on re-render", async () => {
+    const { rerender } = render(
+      <OpenGenerativeUIActivityRenderer
+        activityType="open-generative-ui"
+        content={{
+          html: ["<head></head><body></body>"],
+          htmlComplete: true,
+          jsExpressions: ["expr1()"],
+        }}
+        message={{}}
+        agent={{}}
+      />,
+    );
+    await flushImport();
+    await act(async () => {
+      mockPromiseResolve();
+      await mockPromise;
+    });
+    await flushImport();
+    const callCountAfterFirst = mockRun.mock.calls.filter(
+      (c: unknown[]) => c[0] === "expr1()",
+    ).length;
+    expect(callCountAfterFirst).toBe(1);
+    // Re-render with additional expression
+    rerender(
+      <OpenGenerativeUIActivityRenderer
+        activityType="open-generative-ui"
+        content={{
+          html: ["<head></head><body></body>"],
+          htmlComplete: true,
+          jsExpressions: ["expr1()", "expr2()"],
+        }}
+        message={{}}
+        agent={{}}
+      />,
+    );
+    await flushImport();
+    // expr1 should NOT have been called again
+    const expr1Calls = mockRun.mock.calls.filter(
+      (c: unknown[]) => c[0] === "expr1()",
+    ).length;
+    expect(expr1Calls).toBe(1);
+    // expr2 should have been called
+    const expr2Calls = mockRun.mock.calls.filter(
+      (c: unknown[]) => c[0] === "expr2()",
+    ).length;
+    expect(expr2Calls).toBe(1);
+  });
+  it("queues JS before sandbox ready", async () => {
+    renderRenderer({
+      html: ["<head></head><body></body>"],
+      htmlComplete: true,
+      jsFunctions: "function foo() {}",
+      jsExpressions: ["foo()"],
+    });
+    await flushImport();
+    // Sandbox not ready yet — run should not have been called
+    expect(mockRun).not.toHaveBeenCalled();
+    // Now resolve
+    await act(async () => {
+      mockPromiseResolve();
+      await mockPromise;
+    });
+    await flushImport();
+    // Both should have been flushed
+    expect(mockRun).toHaveBeenCalledWith("function foo() {}");
+    expect(mockRun).toHaveBeenCalledWith("foo()");
+  });
+  it("recreates sandbox when html changes", async () => {
+    const { rerender } = render(
+      <OpenGenerativeUIActivityRenderer
+        activityType="open-generative-ui"
+        content={{ html: ["<head></head><body>v1</body>"], htmlComplete: true }}
+        message={{}}
+        agent={{}}
+      />,
+    );
+    await flushImport();
+    expect(mockCreate).toHaveBeenCalledTimes(1);
+    await act(async () => {
+      mockPromiseResolve();
+      await mockPromise;
+    });
+    // Change html — need a new promise for the new sandbox
+    resetMockPromise();
+    rerender(
+      <OpenGenerativeUIActivityRenderer
+        activityType="open-generative-ui"
+        content={{ html: ["<head></head><body>v2</body>"], htmlComplete: true }}
+        message={{}}
+        agent={{}}
+      />,
+    );
+    await flushImport();
+    // Old sandbox destroyed, new one created
+    expect(mockDestroy).toHaveBeenCalledTimes(1);
+    expect(mockCreate).toHaveBeenCalledTimes(2);
+    const [, options] = mockCreate.mock.calls[1];
+    expect(options.frameContent).toContain("v2");
+  });
+  describe("sandboxFunctions / localApi", () => {
+    function renderWithSandboxFunctions(
+      content: OpenGenerativeUIContent,
+      sandboxFunctions: SandboxFunction[],
+    ) {
+      return render(
+        <SandboxFunctionsContext.Provider value={sandboxFunctions}>
+          <OpenGenerativeUIActivityRenderer
+            activityType="open-generative-ui"
+            content={content}
+            message={{}}
+            agent={{}}
+          />
+        </SandboxFunctionsContext.Provider>,
+      );
+    }
+    it("passes localApi built from sandbox functions to websandbox", async () => {
+      const handler = vi.fn().mockResolvedValue(42);
+      const fns: SandboxFunction[] = [
+        {
+          name: "addToCart",
+          description: "Add item to cart",
+          parameters: z.object({ itemId: z.string() }),
+          handler,
+        },
+      ];
+      renderWithSandboxFunctions(
+        { html: ["<head></head><body>test</body>"], htmlComplete: true },
+        fns,
+      );
+      await flushImport();
+      expect(mockCreate).toHaveBeenCalledTimes(1);
+      const [localApi] = mockCreate.mock.calls[0];
+      expect(localApi).toHaveProperty("addToCart");
+      expect(localApi.addToCart).toBe(handler);
+    });
+    it("passes empty localApi when no sandbox functions", async () => {
+      renderWithSandboxFunctions(
+        { html: ["<head></head><body>test</body>"], htmlComplete: true },
+        [],
+      );
+      await flushImport();
+      expect(mockCreate).toHaveBeenCalledTimes(1);
+      const [localApi] = mockCreate.mock.calls[0];
+      expect(Object.keys(localApi)).toHaveLength(0);
+    });
+    it("recreates sandbox when sandbox functions change", async () => {
+      const handler1 = vi.fn();
+      const fns1: SandboxFunction[] = [
+        {
+          name: "fn1",
+          description: "first",
+          parameters: z.object({}),
+          handler: handler1,
+        },
+      ];
+      const { rerender } = render(
+        <SandboxFunctionsContext.Provider value={fns1}>
+          <OpenGenerativeUIActivityRenderer
+            activityType="open-generative-ui"
+            content={{
+              html: ["<head></head><body>test</body>"],
+              htmlComplete: true,
+            }}
+            message={{}}
+            agent={{}}
+          />
+        </SandboxFunctionsContext.Provider>,
+      );
+      await flushImport();
+      expect(mockCreate).toHaveBeenCalledTimes(1);
+      await act(async () => {
+        mockPromiseResolve();
+        await mockPromise;
+      });
+      // Change sandbox functions
+      const handler2 = vi.fn();
+      const fns2: SandboxFunction[] = [
+        {
+          name: "fn2",
+          description: "second",
+          parameters: z.object({}),
+          handler: handler2,
+        },
+      ];
+      resetMockPromise();
+      rerender(
+        <SandboxFunctionsContext.Provider value={fns2}>
+          <OpenGenerativeUIActivityRenderer
+            activityType="open-generative-ui"
+            content={{
+              html: ["<head></head><body>test</body>"],
+              htmlComplete: true,
+            }}
+            message={{}}
+            agent={{}}
+          />
+        </SandboxFunctionsContext.Provider>,
+      );
+      await flushImport();
+      // Old sandbox destroyed, new one created with new localApi
+      expect(mockDestroy).toHaveBeenCalledTimes(1);
+      expect(mockCreate).toHaveBeenCalledTimes(2);
+      const [localApi] = mockCreate.mock.calls[1];
+      expect(localApi).toHaveProperty("fn2");
+      expect(localApi.fn2).toBe(handler2);
+    });
+    it("includes multiple sandbox functions in localApi", async () => {
+      const handlerA = vi.fn();
+      const handlerB = vi.fn();
+      const fns: SandboxFunction[] = [
+        {
+          name: "fnA",
+          description: "A",
+          parameters: z.object({}),
+          handler: handlerA,
+        },
+        {
+          name: "fnB",
+          description: "B",
+          parameters: z.object({}),
+          handler: handlerB,
+        },
+      ];
+      renderWithSandboxFunctions(
+        { html: ["<head></head><body>test</body>"], htmlComplete: true },
+        fns,
+      );
+      await flushImport();
+      const [localApi] = mockCreate.mock.calls[0];
+      expect(Object.keys(localApi)).toHaveLength(2);
+      expect(localApi.fnA).toBe(handlerA);
+      expect(localApi.fnB).toBe(handlerB);
+    });
+  });
+  describe("progressive streaming preview", () => {
+    it("creates preview sandbox when chunks arrive but htmlComplete is false", async () => {
+      renderRenderer({
+        html: ["<body><div>Hello</div>"],
+        htmlComplete: false,
+        cssComplete: true,
+        generating: true,
+      });
+      await flushImport();
+      // Preview sandbox created with empty body template
+      expect(mockCreate).toHaveBeenCalledTimes(1);
+      const [localApi, options] = mockCreate.mock.calls[0];
+      expect(options.frameContent).toBe("<head></head><body></body>");
+      expect(Object.keys(localApi)).toHaveLength(0);
+    });
+    it("updates preview on re-render with more chunks (after throttle)", async () => {
+      const { rerender } = render(
+        <OpenGenerativeUIActivityRenderer
+          activityType="open-generative-ui"
+          content={{
+            html: ["<body><div>Hello</div>"],
+            htmlComplete: false,
+            cssComplete: true,
+            generating: true,
+          }}
+          message={{}}
+          agent={{}}
+        />,
+      );
+      await flushImport();
+      // Resolve preview sandbox promise
+      await act(async () => {
+        mockPromiseResolve();
+        await mockPromise;
+      });
+      await flushImport();
+      // Should have called run with innerHTML update (initial content — immediate flush)
+      const innerHtmlCalls = mockRun.mock.calls.filter(
+        (c: unknown[]) =>
+          typeof c[0] === "string" &&
+          (c[0] as string).includes("document.body.innerHTML"),
+      );
+      expect(innerHtmlCalls.length).toBeGreaterThanOrEqual(1);
+      // Re-render with more chunks — throttled by the outer wrapper
+      mockRun.mockClear();
+      rerender(
+        <OpenGenerativeUIActivityRenderer
+          activityType="open-generative-ui"
+          content={{
+            html: ["<body><div>Hello</div>", "<p>World</p>"],
+            htmlComplete: false,
+            cssComplete: true,
+            generating: true,
+          }}
+          message={{}}
+          agent={{}}
+        />,
+      );
+      // Wait for the 1s throttle window to pass
+      await act(async () => {
+        await new Promise((r) => setTimeout(r, 1100));
+      });
+      await flushImport();
+      // Should have updated innerHTML with new content after throttle
+      const updateCalls = mockRun.mock.calls.filter(
+        (c: unknown[]) =>
+          typeof c[0] === "string" &&
+          (c[0] as string).includes("document.body.innerHTML"),
+      );
+      expect(updateCalls.length).toBeGreaterThanOrEqual(1);
+      expect(updateCalls[updateCalls.length - 1]![0]).toContain("World");
+    }, 10000);
+    it("destroys preview and creates final sandbox when htmlComplete arrives", async () => {
+      const { rerender } = render(
+        <OpenGenerativeUIActivityRenderer
+          activityType="open-generative-ui"
+          content={{
+            html: ["<body><div>Hello</div>"],
+            htmlComplete: false,
+            cssComplete: true,
+            generating: true,
+          }}
+          message={{}}
+          agent={{}}
+        />,
+      );
+      await flushImport();
+      expect(mockCreate).toHaveBeenCalledTimes(1);
+      // Now complete the HTML
+      resetMockPromise();
+      rerender(
+        <OpenGenerativeUIActivityRenderer
+          activityType="open-generative-ui"
+          content={{
+            html: [
+              "<head><style>body{margin:0}</style></head><body><div>Hello</div></body>",
+            ],
+            htmlComplete: true,
+            cssComplete: true,
+            generating: false,
+          }}
+          message={{}}
+          agent={{}}
+        />,
+      );
+      await flushImport();
+      // Preview destroyed, final sandbox created
+      expect(mockDestroy).toHaveBeenCalledTimes(1);
+      expect(mockCreate).toHaveBeenCalledTimes(2);
+      const [, options] = mockCreate.mock.calls[1];
+      expect(options.frameContent).toContain("<style>");
+      expect(options.frameContent).toContain("Hello");
+    });
+    it("does not show preview until cssComplete, then starts streaming HTML immediately", async () => {
+      // Phase 1: HTML chunks arrive but CSS is not yet complete — no preview
+      const { rerender } = render(
+        <OpenGenerativeUIActivityRenderer
+          activityType="open-generative-ui"
+          content={{
+            html: ["<body><div>Streaming content</div>"],
+            htmlComplete: false,
+            generating: true,
+            // cssComplete is NOT set — CSS still generating
+          }}
+          message={{}}
+          agent={{}}
+        />,
+      );
+      await flushImport();
+      // No sandbox created — placeholder shown while CSS is pending
+      expect(mockCreate).not.toHaveBeenCalled();
+      // Phase 2: CSS completes — preview should appear immediately with the
+      // HTML chunks that have already accumulated
+      rerender(
+        <OpenGenerativeUIActivityRenderer
+          activityType="open-generative-ui"
+          content={{
+            css: "body { margin: 0; color: red; }",
+            cssComplete: true,
+            html: ["<body><div>Streaming content</div>"],
+            htmlComplete: false,
+            generating: true,
+          }}
+          message={{}}
+          agent={{}}
+        />,
+      );
+      await flushImport();
+      // Preview sandbox created now that CSS is complete
+      expect(mockCreate).toHaveBeenCalledTimes(1);
+      const [, options] = mockCreate.mock.calls[0];
+      expect(options.frameContent).toBe("<head></head><body></body>");
+      // Resolve sandbox promise so preview content is applied
+      await act(async () => {
+        mockPromiseResolve();
+        await mockPromise;
+      });
+      await flushImport();
+      // CSS should be injected into <head> as a <style> tag
+      const headCalls = mockRun.mock.calls.filter(
+        (c: unknown[]) =>
+          typeof c[0] === "string" &&
+          (c[0] as string).includes("document.head.innerHTML"),
+      );
+      expect(headCalls.length).toBeGreaterThanOrEqual(1);
+      expect(headCalls[0][0]).toContain("body { margin: 0; color: red; }");
+      // HTML body content should be rendered in the preview
+      const bodyCalls = mockRun.mock.calls.filter(
+        (c: unknown[]) =>
+          typeof c[0] === "string" &&
+          (c[0] as string).includes("document.body.innerHTML"),
+      );
+      expect(bodyCalls.length).toBeGreaterThanOrEqual(1);
+      expect(bodyCalls[0][0]).toContain("Streaming content");
+    });
+    it("does not create preview when no meaningful body content", async () => {
+      renderRenderer({
+        html: ["<head><style>.foo { color: red; }</style></head>"],
+        htmlComplete: false,
+        generating: true,
+      });
+      await flushImport();
+      // No preview — only head content, no body
+      expect(mockCreate).not.toHaveBeenCalled();
+    });
+    it("skips preview entirely for fast completion", async () => {
+      renderRenderer({
+        html: ["<head></head><body><div>Done</div></body>"],
+        htmlComplete: true,
+        generating: false,
+      });
+      await flushImport();
+      // Only final sandbox created, no preview
+      expect(mockCreate).toHaveBeenCalledTimes(1);
+      const [, options] = mockCreate.mock.calls[0];
+      expect(options.frameContent).toContain("Done");
+      // Final sandbox uses localApi, not empty object
+      expect(options.frameContent).not.toBe("<head></head><body></body>");
+    });
+  });
+});