@copilotkit/react-core 1.55.3-canary.1776260990 → 1.56.0

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@copilotkit/react-core",
-  "version": "1.55.3-canary.1776260990",
+  "version": "1.56.0",
   "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.55.3-canary.1776260990",
-    "@copilotkit/core": "1.55.3-canary.1776260990",
-    "@copilotkit/web-inspector": "1.55.3-canary.1776260990",
-    "@copilotkit/runtime-client-gql": "1.55.3-canary.1776260990",
-    "@copilotkit/shared": "1.55.3-canary.1776260990"
+    "@copilotkit/a2ui-renderer": "1.56.0",
+    "@copilotkit/core": "1.56.0",
+    "@copilotkit/runtime-client-gql": "1.56.0",
+    "@copilotkit/web-inspector": "1.56.0",
+    "@copilotkit/shared": "1.56.0"
   },
   "devDependencies": {
     "@tailwindcss/cli": "^4.1.11",

package/src/components/copilot-provider/copilotkit-props.tsx

@@ -1,7 +1,7 @@
 import { ForwardedParametersInput } from "@copilotkit/runtime-client-gql";
 import { ReactNode } from "react";
 import { AuthState } from "../../context/copilot-context";
-import { CopilotErrorHandler } from "@copilotkit/shared";
+import { CopilotErrorHandler, DebugConfig } from "@copilotkit/shared";
 import { CopilotKitProviderProps } from "../../v2";
 /**
  * Props for CopilotKit.
@@ -195,4 +195,20 @@ export interface CopilotKitProps extends Omit<
    * to enabled.
    */
   enableInspector?: boolean;
+
+  /**
+   * Enable debug logging. On the server (`CopilotRuntime`), this enables
+   * structured Pino logging of the AG-UI event pipeline. On the client,
+   * this configuration is forwarded to the AG-UI transport layer
+   * (`transformChunks`) for transport-level debug output.
+   *
+   * Pass `true` for full output, or an object for granular control:
+   *
+   * ```tsx
+   * <CopilotKit debug={true} runtimeUrl="...">
+   *   {children}
+   * </CopilotKit>
+   * ```
+   */
+  debug?: DebugConfig;
 }

package/src/v2/hooks/use-interrupt.tsx

@@ -7,7 +7,6 @@ import React, {
 } from "react";
 import { useCopilotKit } from "../providers/CopilotKitProvider";
 import { useAgent } from "./use-agent";
-import type { AbstractAgent } from "@ag-ui/client";
 import type {
   InterruptEvent,
   InterruptRenderProps,
@@ -80,13 +79,6 @@ interface UseInterruptConfigBase<TValue = unknown, TResult = never> {
   enabled?: (event: InterruptEvent<TValue>) => boolean;
   /** Optional agent id. Defaults to the current configured chat agent. */
   agentId?: string;
-  /**
-   * Optional agent instance to subscribe to. When provided, the hook uses
-   * this instance directly instead of creating one internally via `useAgent`.
-   * This is useful in multiplexer setups where the consumer already holds
-   * the agent instance that `runAgent` will execute on.
-   */
-  agent?: AbstractAgent;
 }
 
 export interface UseInterruptInChatConfig<
@@ -191,8 +183,7 @@ export function useInterrupt<
 ): UseInterruptReturn<TRenderInChat> {
   /* eslint-enable @typescript-eslint/no-explicit-any */
   const { copilotkit } = useCopilotKit();
-  const { agent: internalAgent } = useAgent({ agentId: config.agentId });
-  const agent = config.agent ?? internalAgent;
+  const { agent } = useAgent({ agentId: config.agentId });
   const [pendingEvent, setPendingEvent] = useState<InterruptEvent | null>(null);
   const pendingEventRef = useRef(pendingEvent);
   pendingEventRef.current = pendingEvent;

package/src/v2/providers/CopilotKitProvider.tsx

@@ -21,6 +21,7 @@ import { LicenseWarningBanner } from "../components/license-warning-banner";
 import {
   createLicenseContextValue,
   type LicenseContextValue,
+  type DebugConfig,
 } from "@copilotkit/shared";
 import type { CopilotKitCoreErrorCode } from "@copilotkit/core";
 import {
@@ -234,6 +235,10 @@ export interface CopilotKitProviderProps {
    * Defaults to `{ horizontal: "right", vertical: "top" }`.
    */
   inspectorDefaultAnchor?: Anchor;
+  /**
+   * Enable debug logging for the client-side event pipeline.
+   */
+  debug?: DebugConfig;
 }
 
 // Small helper to normalize array props to a stable reference and warn
@@ -283,6 +288,7 @@ export const CopilotKitProvider: React.FC<CopilotKitProviderProps> = ({
   a2ui,
   defaultThrottleMs,
   inspectorDefaultAnchor,
+  debug,
 }) => {
   const [shouldRenderInspector, setShouldRenderInspector] = useState(false);
   const [runtimeA2UIEnabled, setRuntimeA2UIEnabled] = useState(false);
@@ -554,6 +560,7 @@ export const CopilotKitProvider: React.FC<CopilotKitProviderProps> = ({
       renderToolCalls: allRenderToolCalls,
       renderActivityMessages: allActivityRenderers,
       renderCustomMessages: renderCustomMessagesList,
+      debug,
     });
     // Set initial defaultThrottleMs synchronously so child hooks see the
     // correct value on their first render (before useEffect fires).
@@ -665,6 +672,7 @@ export const CopilotKitProvider: React.FC<CopilotKitProviderProps> = ({
     copilotkit.setCredentials(credentials);
     copilotkit.setProperties(properties);
     copilotkit.setAgents__unsafe_dev_only(mergedAgents);
+    copilotkit.setDebug(debug);
   }, [
     copilotkit,
     chatApiEndpoint,
@@ -673,6 +681,7 @@ export const CopilotKitProvider: React.FC<CopilotKitProviderProps> = ({
     properties,
     mergedAgents,
     useSingleEndpoint,
+    debug,
   ]);
 
   // Sync render/tool arrays to the stable instance via setters.