@copilotkit/react-core 1.56.4-canary.1777529757 → 1.56.4-canary.1777531098

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@copilotkit/react-core",
-  "version": "1.56.4-canary.1777529757",
+  "version": "1.56.4-canary.1777531098",
   "private": false,
   "keywords": [
     "ai",
@@ -73,11 +73,11 @@
     "untruncate-json": "^0.0.1",
     "use-stick-to-bottom": "^1.1.1",
     "zod-to-json-schema": "^3.24.5",
-    "@copilotkit/a2ui-renderer": "1.56.4-canary.1777529757",
-    "@copilotkit/shared": "1.56.4-canary.1777529757",
-    "@copilotkit/web-inspector": "1.56.4-canary.1777529757",
-    "@copilotkit/runtime-client-gql": "1.56.4-canary.1777529757",
-    "@copilotkit/core": "1.56.4-canary.1777529757"
+    "@copilotkit/a2ui-renderer": "1.56.4-canary.1777531098",
+    "@copilotkit/web-inspector": "1.56.4-canary.1777531098",
+    "@copilotkit/shared": "1.56.4-canary.1777531098",
+    "@copilotkit/runtime-client-gql": "1.56.4-canary.1777531098",
+    "@copilotkit/core": "1.56.4-canary.1777531098"
   },
   "devDependencies": {
     "@tailwindcss/cli": "^4.1.11",

package/src/v2/components/chat/CopilotChatView.tsx

@@ -264,14 +264,20 @@ export function CopilotChatView({
     ...(disclaimer !== undefined ? { disclaimer } : {}),
   } as CopilotChatInputProps);
 
-  // Hide suggestions while a thread is connecting (mid-replay would render
-  // against a still-assembling message tree and visibly jump as each final
-  // text chunk reflows the layout). Run-in-flight is handled by the
-  // SuggestionEngine: at run start, non-"always" suggestions are cleared and
-  // only "always" ones are restored — so a non-empty `suggestions` array
-  // here already means "this is something the user opted to keep visible."
+  // Hide suggestions while a thread is connecting or a run is in flight.
+  // Otherwise, mid-replay (bootstrap stream from /connect) or mid-run, the
+  // suggestions would render against a still-assembling message tree and
+  // visibly jump as each final text chunk reflows the layout.
+  //
+  // `available: "always"` controls *eligibility windows* (welcome screen vs
+  // after first message), not whether to render through these transitions —
+  // we still wait for the connect/run to settle and the end-of-run reload
+  // to repopulate against the new context.
   const hasSuggestions =
-    !isConnecting && Array.isArray(suggestions) && suggestions.length > 0;
+    !isConnecting &&
+    !isRunning &&
+    Array.isArray(suggestions) &&
+    suggestions.length > 0;
   const BoundSuggestionView = hasSuggestions
     ? renderSlot(suggestionView, CopilotChatSuggestionView, {
         suggestions,

package/src/v2/components/chat/__tests__/CopilotChat.suggestionsAlways.test.tsx

@@ -87,7 +87,7 @@ describe("CopilotChat - static suggestions with available:'always'", () => {
     });
   });
 
-  it("should keep suggestions visible during a run", async () => {
+  it("should hide suggestions during a run and restore them after", async () => {
     const agent = new MockStepwiseAgent();
     renderChat({ agent, consumerAgentId: "default" });
 
@@ -111,14 +111,13 @@ describe("CopilotChat - static suggestions with available:'always'", () => {
     agent.emit(runStartedEvent());
     agent.emit(textChunkEvent(messageId, "Hello! How can I help?"));
 
-    // Suggestions must remain visible even while the run is still in progress
-    await waitFor(
-      () => {
-        expect(screen.getByText("Say hello")).toBeDefined();
-        expect(screen.getByText("Get help")).toBeDefined();
-      },
-      { timeout: 3000 },
-    );
+    // While the run is in flight, suggestions should be hidden — every run
+    // changes the conversation context, so we wait for the end-of-run reload
+    // before showing them again.
+    await waitFor(() => {
+      expect(screen.queryByText("Say hello")).toBeNull();
+      expect(screen.queryByText("Get help")).toBeNull();
+    });
 
     agent.emit(runFinishedEvent());
     agent.complete();
@@ -127,7 +126,7 @@ describe("CopilotChat - static suggestions with available:'always'", () => {
       expect(screen.getByText("Hello! How can I help?")).toBeDefined();
     });
 
-    // And still visible after the run completes
+    // After the run, the static "always" config repopulates them.
     await waitFor(
       () => {
         expect(screen.getByText("Say hello")).toBeDefined();
@@ -137,7 +136,7 @@ describe("CopilotChat - static suggestions with available:'always'", () => {
     );
   });
 
-  it("should keep suggestions visible during a run in pin-to-send mode", async () => {
+  it("should hide suggestions during a run in pin-to-send mode", async () => {
     const agent = new MockStepwiseAgent();
     renderChat({ agent, autoScroll: "pin-to-send" });
 
@@ -161,14 +160,10 @@ describe("CopilotChat - static suggestions with available:'always'", () => {
     agent.emit(runStartedEvent());
     agent.emit(textChunkEvent(messageId, "Hello! How can I help?"));
 
-    // Suggestions must remain visible even while the run is still in progress
-    await waitFor(
-      () => {
-        expect(screen.getByText("Say hello")).toBeDefined();
-        expect(screen.getByText("Get help")).toBeDefined();
-      },
-      { timeout: 3000 },
-    );
+    await waitFor(() => {
+      expect(screen.queryByText("Say hello")).toBeNull();
+      expect(screen.queryByText("Get help")).toBeNull();
+    });
 
     agent.emit(runFinishedEvent());
     agent.complete();
@@ -177,7 +172,6 @@ describe("CopilotChat - static suggestions with available:'always'", () => {
       expect(screen.getByText("Hello! How can I help?")).toBeDefined();
     });
 
-    // And still visible after the run completes
     await waitFor(
       () => {
         expect(screen.getByText("Say hello")).toBeDefined();

package/src/v2/hooks/use-configure-suggestions.tsx

@@ -106,22 +106,37 @@ export function useConfigureSuggestions(
   const isGlobalConfig =
     rawConsumerAgentId === undefined || rawConsumerAgentId === "*";
 
+  const isDynamicConfigType = useMemo(
+    () => !!normalizedConfig && "instructions" in normalizedConfig,
+    [normalizedConfig],
+  );
+
   const requestReload = useCallback(() => {
     if (!normalizedConfig) {
       return;
     }
 
     if (isGlobalConfig) {
+      const seen = new Set<string>();
       const agents = Object.values(copilotkit.agents ?? {});
       for (const entry of agents) {
         const agentId = entry.agentId;
         if (!agentId) {
           continue;
         }
+        seen.add(agentId);
         if (!entry.isRunning) {
           copilotkit.reloadSuggestions(agentId);
         }
       }
+      // Also reload for the chat's resolved consumer agent. The registry can
+      // be empty at this point (e.g. runtime info still loading), in which
+      // case the loop above wouldn't have fired for the agent the user is
+      // actually chatting with — and the welcome screen would render with
+      // no suggestions until they navigate away and back.
+      if (targetAgentId && !seen.has(targetAgentId)) {
+        copilotkit.reloadSuggestions(targetAgentId);
+      }
       return;
     }
 
@@ -169,6 +184,34 @@ export function useConfigureSuggestions(
     }
     requestReload();
   }, [extraDeps.length, normalizedConfig, requestReload, ...extraDeps]);
+
+  // When agents arrive after the initial render (runtime info just landed),
+  // re-request a reload so dynamic configs that need a real agent can finally
+  // generate.  Skip for static configs — they don't need an agent and the
+  // initial mount reload already handled them.  Skip when the target agent
+  // is already in the registry — the initial reload already covered it, and
+  // re-firing on every subsequent `onAgentsChanged` (e.g. dev-mode hot
+  // reloads, sibling chat configs mounting) would stack overlapping
+  // generations.
+  useEffect(() => {
+    if (!normalizedConfig || !isDynamicConfigType) return;
+    if (!targetAgentId) return;
+
+    const initiallyPresent = !!copilotkit.getAgent(targetAgentId);
+    if (initiallyPresent) return;
+
+    const subscription = copilotkit.subscribe({
+      onAgentsChanged: () => {
+        if (copilotkit.getAgent(targetAgentId)) {
+          requestReload();
+          subscription.unsubscribe();
+        }
+      },
+    });
+    return () => {
+      subscription.unsubscribe();
+    };
+  }, [copilotkit, normalizedConfig, isDynamicConfigType, targetAgentId, requestReload]);
 }
 
 function isDynamicConfig(