@copilotkit/react-core 1.10.0-next.9 → 1.10.0

package/src/hooks/use-copilot-chat.ts

@@ -1,178 +1,127 @@
 /**
- * `useCopilotChat` is a React hook that lets you directly interact with the
- * Copilot instance. Use to implement a fully custom UI (headless UI) or to
- * programmatically interact with the Copilot instance managed by the default
- * UI.
+ * `useCopilotChat` is a lightweight React hook for headless chat interactions.
+ * Perfect for controlling the prebuilt chat components programmatically.
  *
- * **Requires a publicApiKey** - Sign up for free at https://cloud.copilotkit.ai/
- * to get your API key with generous usage limits.
+ * **Open Source Friendly** - Works without requiring a free public license key.
  *
- * ## Usage
+ * <Callout title="Looking for fully headless UI?">
+ * Get started with [useCopilotChatHeadless_c](https://docs.copilotkit.ai/reference/hooks/useCopilotChatHeadless_c).
+ * </Callout>
+ *
+ * ## Use Cases
  *
- * ### Simple Usage
+ * - **Programmatic Messaging**: Send messages without displaying chat UI
+ * - **Programmatic control**: Control prebuilt component programmatically
+ * - **Background Operations**: Trigger AI interactions in the background
+ * - **Fire-and-Forget**: Send messages without needing to read responses
+ *
+ * ## Usage
  *
  * ```tsx
- * import { CopilotKit } from "@copilotkit/react-core";
- * import { useCopilotChat } from "@copilotkit/react-core";
- * import { Role, TextMessage } from "@copilotkit/runtime-client-gql";
- *
- * export function App() {
- *   return (
- *     <CopilotKit publicApiKey="your-public-api-key">
- *       <YourComponent />
- *     </CopilotKit>
- *   );
- * }
+ * import { TextMessage, MessageRole } from "@copilotkit/runtime-client-gql";
  *
- * export function YourComponent() {
- *   const { appendMessage } = useCopilotChat();
+ * const { appendMessage } = useCopilotChat();
  *
- *   appendMessage(
+ * // Example usage without naming conflicts
+ * const handleSendMessage = async (content: string) => {
+ *   await appendMessage(
  *     new TextMessage({
- *       content: "Hello World",
- *       role: Role.User,
- *     }),
+ *       role: MessageRole.User,
+ *       content,
+ *     })
  *   );
- *
- *   // optionally, you can append a message without running chat completion
- *   appendMessage(yourMessage, { followUp: false });
- * }
+ * };
  * ```
  *
- * ### Working with Suggestions
+ * ## Return Values
+ * The following properties are returned from the hook:
  *
- * ```tsx
- * import { CopilotKit } from "@copilotkit/react-core";
- * import { useCopilotChat, useCopilotChatSuggestions } from "@copilotkit/react-core";
- *
- * export function App() {
- *   return (
- *     <CopilotKit publicApiKey="your-public-api-key">
- *       <YourComponent />
- *     </CopilotKit>
- *   );
- * }
- *
- * export function YourComponent() {
- *   const {
- *     suggestions,
- *     setSuggestions,
- *     generateSuggestions,
- *     isLoadingSuggestions
- *   } = useCopilotChat();
- *
- *   // Configure AI suggestion generation
- *   useCopilotChatSuggestions({
- *     instructions: "Suggest helpful actions based on the current context",
- *     maxSuggestions: 3
- *   });
- *
- *   // Manual suggestion control
- *   const handleCustomSuggestion = () => {
- *     setSuggestions([{ title: "Custom Action", message: "Perform custom action" }]);
- *   };
- *
- *   // Trigger AI generation
- *   const handleGenerateSuggestions = async () => {
- *     await generateSuggestions();
- *   };
- * }
- * ```
+ * <PropertyReference name="visibleMessages" type="DeprecatedGqlMessage[]" deprecated>
+ * Array of messages in old non-AG-UI format, use for compatibility only
+ * </PropertyReference>
  *
- * `useCopilotChat` returns an object with the following properties:
+ * <PropertyReference name="appendMessage" type="(message: DeprecatedGqlMessage, options?) => Promise<void>" deprecated>
+ * Append message using old format, use `sendMessage` instead
+ * </PropertyReference>
  *
- * ```tsx
- * const {
- *   visibleMessages, // An array of messages that are currently visible in the chat.
- *   appendMessage, // A function to append a message to the chat.
- *   setMessages, // A function to set the messages in the chat.
- *   deleteMessage, // A function to delete a message from the chat.
- *   reloadMessages, // A function to reload the messages from the API.
- *   stopGeneration, // A function to stop the generation of the next message.
- *   reset, // A function to reset the chat.
- *   isLoading, // A boolean indicating if the chat is loading.
- *
- *   // Suggestion control (headless UI)
- *   suggestions, // Current suggestions array
- *   setSuggestions, // Manually set suggestions
- *   generateSuggestions, // Trigger AI suggestion generation
- *   resetSuggestions, // Clear all suggestions
- *   isLoadingSuggestions, // Whether suggestions are being generated
- * } = useCopilotChat();
- * ```
+ * <PropertyReference name="reloadMessages" type="(messageId: string) => Promise<void>">
+ * Regenerate the response for a specific message by ID
+ * </PropertyReference>
+ *
+ * <PropertyReference name="stopGeneration" type="() => void">
+ * Stop the current message generation process
+ * </PropertyReference>
+ *
+ * <PropertyReference name="reset" type="() => void">
+ * Clear all messages and reset chat state completely
+ * </PropertyReference>
+ *
+ * <PropertyReference name="isLoading" type="boolean">
+ * Whether the chat is currently generating a response
+ * </PropertyReference>
+ *
+ * <PropertyReference name="runChatCompletion" type="() => Promise<Message[]>">
+ * Manually trigger chat completion for advanced usage
+ * </PropertyReference>
+ *
+ * <PropertyReference name="mcpServers" type="MCPServerConfig[]">
+ * Array of Model Context Protocol server configurations
+ * </PropertyReference>
+ *
+ * <PropertyReference name="setMcpServers" type="(servers: MCPServerConfig[]) => void">
+ * Update MCP server configurations for enhanced context
+ * </PropertyReference>
  */
-import { useEffect } from "react";
-import { useCopilotContext } from "../context/copilot-context";
 
 import {
-  useCopilotChat as useCopilotChatInternal,
-  defaultSystemMessage,
   UseCopilotChatOptions,
-  UseCopilotChatReturn,
-  MCPServerConfig,
+  useCopilotChat as useCopilotChatInternal,
+  UseCopilotChatReturn as UseCopilotChatReturnInternal,
 } from "./use-copilot-chat_internal";
-import {
-  ErrorVisibility,
-  Severity,
-  CopilotKitError,
-  CopilotKitErrorCode,
-  styledConsole,
-} from "@copilotkit/shared";
-
-// Non-functional fallback implementation
-const createNonFunctionalReturn = (): UseCopilotChatReturn => ({
-  visibleMessages: [],
-  appendMessage: async () => {},
-  setMessages: () => {},
-  deleteMessage: () => {},
-  reloadMessages: async () => {},
-  stopGeneration: () => {},
-  reset: () => {},
-  isLoading: false,
-  runChatCompletion: async () => [],
-  mcpServers: [],
-  setMcpServers: () => {},
-  suggestions: [],
-  setSuggestions: () => {},
-  generateSuggestions: async () => {},
-  resetSuggestions: () => {},
-  isLoadingSuggestions: false,
-  interrupt: null,
-});
-function useCopilotChat(options: UseCopilotChatOptions = {}): UseCopilotChatReturn {
-  const { copilotApiConfig, setBannerError } = useCopilotContext();
 
-  // Check if publicApiKey is available
-  const hasPublicApiKey = Boolean(copilotApiConfig.publicApiKey);
+// Create a type that excludes message-related properties from the internal type
+export type UseCopilotChatReturn = Omit<
+  UseCopilotChatReturnInternal,
+  | "messages"
+  | "sendMessage"
+  | "suggestions"
+  | "setSuggestions"
+  | "generateSuggestions"
+  | "isLoadingSuggestions"
+  | "resetSuggestions"
+  | "interrupt"
+  | "setMessages"
+  | "deleteMessage"
+>;
 
-  // Always call the internal hook (follows rules of hooks)
-  const internalResult = useCopilotChatInternal(options);
-
-  // Set banner error when no public API key is provided
-  useEffect(() => {
-    if (!hasPublicApiKey) {
-      setBannerError(
-        new CopilotKitError({
-          message: "As of v1.10.0, useCopilotChat requires a publicApiKey to function.",
-          code: CopilotKitErrorCode.MISSING_PUBLIC_API_KEY_ERROR,
-          severity: Severity.CRITICAL,
-          visibility: ErrorVisibility.BANNER,
-        }),
-      );
-      styledConsole.logCopilotKitPlatformMessage();
-    } else {
-      setBannerError(null); // Clear banner when API key is provided
-    }
-  }, [hasPublicApiKey]); // Removed setBannerError dependency
-
-  // Return internal result if publicApiKey is available, otherwise return fallback
-  if (hasPublicApiKey) {
-    return internalResult;
-  }
+/**
+ * A lightweight React hook for headless chat interactions.
+ * Perfect for programmatic messaging, background operations, and custom UI implementations.
+ *
+ * **Open Source Friendly** - Works without requiring a `publicApiKey`.
+ */
+export function useCopilotChat(options: UseCopilotChatOptions = {}): UseCopilotChatReturn {
+  const {
+    visibleMessages,
+    appendMessage,
+    reloadMessages,
+    stopGeneration,
+    reset,
+    isLoading,
+    runChatCompletion,
+    mcpServers,
+    setMcpServers,
+  } = useCopilotChatInternal(options);
 
-  // Return non-functional fallback when no publicApiKey
-  return createNonFunctionalReturn();
+  return {
+    visibleMessages,
+    appendMessage,
+    reloadMessages,
+    stopGeneration,
+    reset,
+    isLoading,
+    runChatCompletion,
+    mcpServers,
+    setMcpServers,
+  };
 }
-
-export { defaultSystemMessage, useCopilotChat };
-export type { UseCopilotChatOptions, UseCopilotChatReturn, MCPServerConfig };

package/src/hooks/use-copilot-chat_internal.ts

@@ -10,7 +10,13 @@ import { reloadSuggestions as generateSuggestions } from "../utils";
 import type { SuggestionItem } from "../utils";
 
 import { Message } from "@copilotkit/shared";
-import { Role as gqlRole, TextMessage, aguiToGQL, gqlToAGUI } from "@copilotkit/runtime-client-gql";
+import {
+  Role as gqlRole,
+  TextMessage,
+  aguiToGQL,
+  gqlToAGUI,
+  Message as DeprecatedGqlMessage,
+} from "@copilotkit/runtime-client-gql";
 import { useLangGraphInterruptRender } from "./use-langgraph-interrupt-render";
 
 export interface UseCopilotChatOptions {
@@ -43,28 +49,111 @@ export interface MCPServerConfig {
 }
 
 export interface UseCopilotChatReturn {
-  /** Array of messages currently visible in the chat interface */
-  visibleMessages: Message[];
+  /**
+   * @deprecated use `messages` instead, this is an old non ag-ui version of the messages
+   * Array of messages currently visible in the chat interface
+   *
+   * This is the visible messages, not the raw messages from the runtime client.
+   */
+  visibleMessages: DeprecatedGqlMessage[];
 
-  /** Send a new message to the chat */
-  appendMessage: (message: Message, options?: AppendMessageOptions) => Promise<void>;
+  /**
+   * The messages that are currently in the chat in AG-UI format.
+   */
+  messages: Message[];
 
-  /** Replace all messages in the chat */
-  setMessages: (messages: Message[]) => void;
+  /** @deprecated use `sendMessage` instead */
+  appendMessage: (message: DeprecatedGqlMessage, options?: AppendMessageOptions) => Promise<void>;
+
+  /**
+   * Send a new message to the chat
+   *
+   * ```tsx
+   * await sendMessage({
+   *   id: "123",
+   *   role: "user",
+   *   content: "Hello, process this request",
+   * });
+   * ```
+   */
+  sendMessage: (message: Message, options?: AppendMessageOptions) => Promise<void>;
 
-  /** Remove a specific message by ID */
+  /**
+   * Replace all messages in the chat
+   *
+   * ```tsx
+   * setMessages([
+   *   { id: "123", role: "user", content: "Hello, process this request" },
+   *   { id: "456", role: "assistant", content: "Hello, I'm the assistant" },
+   * ]);
+   * ```
+   *
+   * **Deprecated** non-ag-ui version:
+   *
+   * ```tsx
+   * setMessages([
+   *   new TextMessage({
+   *     content: "Hello, process this request",
+   *     role: gqlRole.User,
+   *   }),
+   *   new TextMessage({
+   *     content: "Hello, I'm the assistant",
+   *     role: gqlRole.Assistant,
+   * ]);
+   * ```
+   *
+   */
+  setMessages: (messages: Message[] | DeprecatedGqlMessage[]) => void;
+
+  /**
+   * Remove a specific message by ID
+   *
+   * ```tsx
+   * deleteMessage("123");
+   * ```
+   */
   deleteMessage: (messageId: string) => void;
 
-  /** Regenerate the response for a specific message */
+  /**
+   * Regenerate the response for a specific message
+   *
+   * ```tsx
+   * reloadMessages("123");
+   * ```
+   */
   reloadMessages: (messageId: string) => Promise<void>;
 
-  /** Stop the current message generation */
+  /**
+   * Stop the current message generation
+   *
+   * ```tsx
+   * if (isLoading) {
+   *   stopGeneration();
+   * }
+   * ```
+   */
   stopGeneration: () => void;
 
-  /** Clear all messages and reset chat state */
+  /**
+   * Clear all messages and reset chat state
+   *
+   * ```tsx
+   * reset();
+   * console.log(messages); // []
+   * ```
+   */
   reset: () => void;
 
-  /** Whether the chat is currently generating a response */
+  /**
+   * Whether the chat is currently generating a response
+   *
+   * ```tsx
+   * if (isLoading) {
+   *   console.log("Loading...");
+   * } else {
+   *   console.log("Not loading");
+   * }
+   */
   isLoading: boolean;
 
   /** Manually trigger chat completion (advanced usage) */
@@ -92,6 +181,11 @@ export interface UseCopilotChatReturn {
    * Trigger AI-powered suggestion generation
    * Uses configurations from useCopilotChatSuggestions hooks
    * Respects global debouncing - only one generation can run at a time
+   *
+   * ```tsx
+   * generateSuggestions();
+   * console.log(suggestions); // [suggestion1, suggestion2, suggestion3]
+   * ```
    */
   generateSuggestions: () => Promise<void>;
 
@@ -300,9 +394,17 @@ export function useCopilotChat(options: UseCopilotChatOptions = {}): UseCopilotC
 
   const latestAppend = useUpdatedRef(append);
   const latestAppendFunc = useAsyncCallback(
+    async (message: DeprecatedGqlMessage, options?: AppendMessageOptions) => {
+      abortSuggestions(options?.clearSuggestions);
+      return await latestAppend.current(message, options);
+    },
+    [latestAppend],
+  );
+
+  const latestSendMessageFunc = useAsyncCallback(
     async (message: Message, options?: AppendMessageOptions) => {
       abortSuggestions(options?.clearSuggestions);
-      return await latestAppend.current(aguiToGQL([message])[0], options);
+      return await latestAppend.current(aguiToGQL([message])[0] as DeprecatedGqlMessage, options);
     },
     [latestAppend],
   );
@@ -330,7 +432,10 @@ export function useCopilotChat(options: UseCopilotChatOptions = {}): UseCopilotC
 
   const latestSetMessages = useUpdatedRef(setMessages);
   const latestSetMessagesFunc = useCallback(
-    (messages: Message[]) => {
+    (messages: Message[] | DeprecatedGqlMessage[]) => {
+      if (messages.every((message) => message instanceof DeprecatedGqlMessage)) {
+        return latestSetMessages.current(messages as DeprecatedGqlMessage[]);
+      }
       return latestSetMessages.current(aguiToGQL(messages));
     },
     [latestSetMessages],
@@ -373,7 +478,9 @@ export function useCopilotChat(options: UseCopilotChatOptions = {}): UseCopilotC
   const interrupt = useLangGraphInterruptRender();
 
   return {
-    visibleMessages: gqlToAGUI(messages, actions, coAgentStateRenders),
+    visibleMessages: messages,
+    messages: gqlToAGUI(messages, actions, coAgentStateRenders),
+    sendMessage: latestSendMessageFunc,
     appendMessage: latestAppendFunc,
     setMessages: latestSetMessagesFunc,
     reloadMessages: latestReloadFunc,

package/dist/chunk-AWFAFFO5.mjs.map

@@ -1 +0,0 @@
-{"version":3,"sources":["../src/components/usage-banner.tsx"],"sourcesContent":["import {\n  Severity,\n  CopilotKitError,\n  ErrorVisibility,\n  CopilotKitErrorCode,\n} from \"@copilotkit/shared\";\n\ninterface UsageBannerProps {\n  severity?: Severity;\n  message?: string;\n  onClose?: () => void;\n  actions?: {\n    primary?: {\n      label: string;\n      onClick: () => void;\n    };\n    secondary?: {\n      label: string;\n      onClick: () => void;\n    };\n  };\n}\n\nexport function UsageBanner({\n  severity = Severity.CRITICAL,\n  message = \"\",\n  onClose,\n  actions,\n}: UsageBannerProps) {\n  if (!message || !severity) {\n    return null;\n  }\n\n  const themes = {\n    [Severity.INFO]: {\n      bg: \"#f8fafc\",\n      border: \"#e2e8f0\",\n      text: \"#475569\",\n      accent: \"#3b82f6\",\n    },\n    [Severity.WARNING]: {\n      bg: \"#fffbeb\",\n      border: \"#fbbf24\",\n      text: \"#92400e\",\n      accent: \"#f59e0b\",\n    },\n    [Severity.CRITICAL]: {\n      bg: \"#fef2f2\",\n      border: \"#fecaca\",\n      text: \"#dc2626\",\n      accent: \"#ef4444\",\n    },\n  };\n\n  const theme = themes[severity];\n\n  return (\n    <>\n      <style>\n        {`\n          @keyframes slideUp {\n            from { opacity: 0; transform: translateX(-50%) translateY(8px); }\n            to { opacity: 1; transform: translateX(-50%) translateY(0); }\n          }\n          \n          .usage-banner {\n            position: fixed;\n            bottom: 24px;\n            left: 50%;\n            transform: translateX(-50%);\n            width: min(600px, calc(100vw - 32px));\n            z-index: 10000;\n            animation: slideUp 0.2s cubic-bezier(0.16, 1, 0.3, 1);\n          }\n          \n          .banner-content {\n            background: linear-gradient(135deg, ${theme.bg} 0%, ${theme.bg}f5 100%);\n            border: 1px solid ${theme.border};\n            border-radius: 12px;\n            padding: 18px 20px;\n            box-shadow: \n              0 4px 24px rgba(0, 0, 0, 0.08),\n              0 2px 8px rgba(0, 0, 0, 0.04),\n              inset 0 1px 0 rgba(255, 255, 255, 0.7);\n            display: flex;\n            align-items: center;\n            gap: 16px;\n            font-family: -apple-system, BlinkMacSystemFont, 'Segoe UI', system-ui, sans-serif;\n            backdrop-filter: blur(12px);\n            position: relative;\n            overflow: hidden;\n          }\n          \n          .banner-content::before {\n            content: '';\n            position: absolute;\n            top: 0;\n            left: 0;\n            right: 0;\n            height: 1px;\n            background: linear-gradient(90deg, transparent, ${theme.accent}40, transparent);\n          }\n          \n          .banner-message {\n            color: ${theme.text};\n            font-size: 14px;\n            line-height: 1.5;\n            font-weight: 500;\n            flex: 1;\n            letter-spacing: -0.01em;\n          }\n          \n          .close-btn {\n            background: rgba(0, 0, 0, 0.05);\n            border: none;\n            color: ${theme.text};\n            cursor: pointer;\n            padding: 0;\n            border-radius: 6px;\n            opacity: 0.6;\n            transition: all 0.15s cubic-bezier(0.16, 1, 0.3, 1);\n            font-size: 14px;\n            line-height: 1;\n            flex-shrink: 0;\n            width: 24px;\n            height: 24px;\n            display: flex;\n            align-items: center;\n            justify-content: center;\n          }\n          \n          .close-btn:hover {\n            opacity: 1;\n            background: rgba(0, 0, 0, 0.08);\n            transform: scale(1.05);\n          }\n          \n          .btn-primary {\n            background: linear-gradient(135deg, ${theme.accent} 0%, ${theme.accent}e6 100%);\n            color: white;\n            border: none;\n            border-radius: 8px;\n            padding: 10px 18px;\n            font-size: 13px;\n            font-weight: 600;\n            cursor: pointer;\n            transition: all 0.15s cubic-bezier(0.16, 1, 0.3, 1);\n            font-family: inherit;\n            flex-shrink: 0;\n            box-shadow: \n              0 2px 8px ${theme.accent}30,\n              inset 0 1px 0 rgba(255, 255, 255, 0.2);\n            letter-spacing: -0.01em;\n          }\n          \n          .btn-primary:hover {\n            transform: translateY(-1px) scale(1.02);\n            box-shadow: \n              0 4px 12px ${theme.accent}40,\n              inset 0 1px 0 rgba(255, 255, 255, 0.25);\n          }\n          \n          .btn-primary:active {\n            transform: translateY(0) scale(0.98);\n            transition: all 0.08s cubic-bezier(0.16, 1, 0.3, 1);\n          }\n          \n          @media (max-width: 640px) {\n            .usage-banner {\n              width: calc(100vw - 24px);\n            }\n            \n            .banner-content {\n              padding: 16px;\n              gap: 12px;\n            }\n            \n            .banner-message {\n              font-size: 13px;\n              line-height: 1.45;\n            }\n            \n            .btn-primary {\n              padding: 8px 14px;\n              font-size: 12px;\n            }\n            \n            .close-btn {\n              width: 22px;\n              height: 22px;\n              font-size: 12px;\n            }\n          }\n        `}\n      </style>\n\n      <div className=\"usage-banner\">\n        <div className=\"banner-content\">\n          <div className=\"banner-message\">{message}</div>\n          {actions?.primary && (\n            <button className=\"btn-primary\" onClick={actions.primary.onClick}>\n              {actions.primary.label}\n            </button>\n          )}\n          {onClose && (\n            <button className=\"close-btn\" onClick={onClose} title=\"Close\">\n              ×\n            </button>\n          )}\n        </div>\n      </div>\n    </>\n  );\n}\n\n// Get action button based on error type\nexport const getErrorActions = (error: CopilotKitError) => {\n  switch (error.code) {\n    case CopilotKitErrorCode.MISSING_PUBLIC_API_KEY_ERROR:\n      return {\n        primary: {\n          label: \"Get Free API Key\",\n          onClick: () =>\n            window.open(\"https://cloud.copilotkit.ai\", \"_blank\", \"noopener,noreferrer\"),\n        },\n      };\n    case CopilotKitErrorCode.UPGRADE_REQUIRED_ERROR:\n      return {\n        primary: {\n          label: \"Upgrade\",\n          onClick: () =>\n            window.open(\"https://cloud.copilotkit.ai\", \"_blank\", \"noopener,noreferrer\"),\n        },\n      };\n    default:\n      return undefined;\n  }\n};\n\nexport function renderCopilotKitUsage(error: CopilotKitError, onClose?: () => void) {\n  // Route based on error visibility level\n  if (error.visibility !== ErrorVisibility.BANNER) {\n    return null;\n  }\n\n  return (\n    <UsageBanner\n      severity={error.severity || Severity.CRITICAL}\n      message={error.message}\n      onClose={onClose}\n      actions={getErrorActions(error)}\n    />\n  );\n}\n"],"mappings":"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","names":[]}

package/dist/chunk-GRCHDHC4.mjs.map

@@ -1 +0,0 @@
-{"version":3,"sources":["../src/hooks/use-copilot-chat_internal.ts"],"sourcesContent":["import { useRef, useEffect, useCallback, useState, useMemo } from \"react\";\nimport { AgentSession, useCopilotContext, CopilotContextParams } from \"../context/copilot-context\";\nimport { useCopilotMessagesContext, CopilotMessagesContextParams } from \"../context\";\nimport { SystemMessageFunction } from \"../types\";\nimport { useChat, AppendMessageOptions } from \"./use-chat\";\nimport { defaultCopilotContextCategories } from \"../components\";\nimport { CoAgentStateRenderHandlerArguments } from \"@copilotkit/shared\";\nimport { useAsyncCallback } from \"../components/error-boundary/error-utils\";\nimport { reloadSuggestions as generateSuggestions } from \"../utils\";\nimport type { SuggestionItem } from \"../utils\";\n\nimport { Message } from \"@copilotkit/shared\";\nimport { Role as gqlRole, TextMessage, aguiToGQL, gqlToAGUI } from \"@copilotkit/runtime-client-gql\";\nimport { useLangGraphInterruptRender } from \"./use-langgraph-interrupt-render\";\n\nexport interface UseCopilotChatOptions {\n  /**\n   * A unique identifier for the chat. If not provided, a random one will be\n   * generated. When provided, the `useChat` hook with the same `id` will\n   * have shared states across components.\n   */\n  id?: string;\n\n  /**\n   * HTTP headers to be sent with the API request.\n   */\n  headers?: Record<string, string> | Headers;\n\n  /**\n   * Initial messages to populate the chat with.\n   */\n  initialMessages?: Message[];\n\n  /**\n   * A function to generate the system message. Defaults to `defaultSystemMessage`.\n   */\n  makeSystemMessage?: SystemMessageFunction;\n}\n\nexport interface MCPServerConfig {\n  endpoint: string;\n  apiKey?: string;\n}\n\nexport interface UseCopilotChatReturn {\n  /** Array of messages currently visible in the chat interface */\n  visibleMessages: Message[];\n\n  /** Send a new message to the chat */\n  appendMessage: (message: Message, options?: AppendMessageOptions) => Promise<void>;\n\n  /** Replace all messages in the chat */\n  setMessages: (messages: Message[]) => void;\n\n  /** Remove a specific message by ID */\n  deleteMessage: (messageId: string) => void;\n\n  /** Regenerate the response for a specific message */\n  reloadMessages: (messageId: string) => Promise<void>;\n\n  /** Stop the current message generation */\n  stopGeneration: () => void;\n\n  /** Clear all messages and reset chat state */\n  reset: () => void;\n\n  /** Whether the chat is currently generating a response */\n  isLoading: boolean;\n\n  /** Manually trigger chat completion (advanced usage) */\n  runChatCompletion: () => Promise<Message[]>;\n\n  /** MCP (Model Context Protocol) server configurations */\n  mcpServers: MCPServerConfig[];\n\n  /** Update MCP server configurations */\n  setMcpServers: (mcpServers: MCPServerConfig[]) => void;\n\n  /**\n   * Current suggestions array\n   * Use this to read the current suggestions or in conjunction with setSuggestions for manual control\n   */\n  suggestions: SuggestionItem[];\n\n  /**\n   * Manually set suggestions\n   * Useful for manual mode or custom suggestion workflows\n   */\n  setSuggestions: (suggestions: SuggestionItem[]) => void;\n\n  /**\n   * Trigger AI-powered suggestion generation\n   * Uses configurations from useCopilotChatSuggestions hooks\n   * Respects global debouncing - only one generation can run at a time\n   */\n  generateSuggestions: () => Promise<void>;\n\n  /**\n   * Clear all current suggestions\n   * Also resets suggestion generation state\n   */\n  resetSuggestions: () => void;\n\n  /** Whether suggestions are currently being generated */\n  isLoadingSuggestions: boolean;\n\n  /** Interrupt content for human-in-the-loop workflows */\n  interrupt: string | React.ReactElement | null;\n}\n\nlet globalSuggestionPromise: Promise<void> | null = null;\n\nexport function useCopilotChat(options: UseCopilotChatOptions = {}): UseCopilotChatReturn {\n  const makeSystemMessage = options.makeSystemMessage ?? defaultSystemMessage;\n  const {\n    getContextString,\n    getFunctionCallHandler,\n    copilotApiConfig,\n    isLoading,\n    setIsLoading,\n    chatInstructions,\n    actions,\n    coagentStatesRef,\n    setCoagentStatesWithRef,\n    coAgentStateRenders,\n    agentSession,\n    setAgentSession,\n    forwardedParameters,\n    agentLock,\n    threadId,\n    setThreadId,\n    runId,\n    setRunId,\n    chatAbortControllerRef,\n    extensions,\n    setExtensions,\n    langGraphInterruptAction,\n    setLangGraphInterruptAction,\n    chatSuggestionConfiguration,\n\n    runtimeClient,\n  } = useCopilotContext();\n  const { messages, setMessages, suggestions, setSuggestions } = useCopilotMessagesContext();\n\n  // Simple state for MCP servers (keep for interface compatibility)\n  const [mcpServers, setLocalMcpServers] = useState<MCPServerConfig[]>([]);\n\n  // Basic suggestion state for programmatic control\n  const suggestionsAbortControllerRef = useRef<AbortController | null>(null);\n  const isLoadingSuggestionsRef = useRef<boolean>(false);\n\n  const abortSuggestions = useCallback(\n    (clear: boolean = true) => {\n      suggestionsAbortControllerRef.current?.abort(\"suggestions aborted by user\");\n      suggestionsAbortControllerRef.current = null;\n      if (clear) {\n        setSuggestions([]);\n      }\n    },\n    [setSuggestions],\n  );\n\n  // Memoize context with stable dependencies only\n  const stableContext = useMemo(() => {\n    return {\n      actions,\n      copilotApiConfig,\n      chatSuggestionConfiguration,\n      messages,\n      setMessages,\n      getContextString,\n      runtimeClient,\n    };\n  }, [\n    JSON.stringify(Object.keys(actions)),\n    copilotApiConfig.chatApiEndpoint,\n    messages.length,\n    Object.keys(chatSuggestionConfiguration).length,\n  ]);\n\n  // Programmatic suggestion generation function\n  const generateSuggestionsFunc = useCallback(async () => {\n    // If a global suggestion is running, ignore this call\n    if (globalSuggestionPromise) {\n      return globalSuggestionPromise;\n    }\n\n    globalSuggestionPromise = (async () => {\n      try {\n        abortSuggestions();\n        isLoadingSuggestionsRef.current = true;\n        suggestionsAbortControllerRef.current = new AbortController();\n\n        setSuggestions([]);\n\n        await generateSuggestions(\n          stableContext as CopilotContextParams & CopilotMessagesContextParams,\n          chatSuggestionConfiguration,\n          setSuggestions,\n          suggestionsAbortControllerRef,\n        );\n      } catch (error) {\n        // Re-throw to allow caller to handle the error\n        throw error;\n      } finally {\n        isLoadingSuggestionsRef.current = false;\n        globalSuggestionPromise = null;\n      }\n    })();\n\n    return globalSuggestionPromise;\n  }, [stableContext, chatSuggestionConfiguration, setSuggestions, abortSuggestions]);\n\n  const resetSuggestions = useCallback(() => {\n    setSuggestions([]);\n  }, [setSuggestions]);\n\n  // MCP servers logic\n  useEffect(() => {\n    if (mcpServers.length > 0) {\n      const serversCopy = [...mcpServers];\n      copilotApiConfig.mcpServers = serversCopy;\n      if (!copilotApiConfig.properties) {\n        copilotApiConfig.properties = {};\n      }\n      copilotApiConfig.properties.mcpServers = serversCopy;\n    }\n  }, [mcpServers, copilotApiConfig]);\n\n  const setMcpServers = useCallback((servers: MCPServerConfig[]) => {\n    setLocalMcpServers(servers);\n  }, []);\n\n  // Move these function declarations above the useChat call\n  const onCoAgentStateRender = useAsyncCallback(\n    async (args: CoAgentStateRenderHandlerArguments) => {\n      const { name, nodeName, state } = args;\n      let action = Object.values(coAgentStateRenders).find(\n        (action) => action.name === name && action.nodeName === nodeName,\n      );\n      if (!action) {\n        action = Object.values(coAgentStateRenders).find(\n          (action) => action.name === name && !action.nodeName,\n        );\n      }\n      if (action) {\n        await action.handler?.({ state, nodeName });\n      }\n    },\n    [coAgentStateRenders],\n  );\n\n  const makeSystemMessageCallback = useCallback(() => {\n    const systemMessageMaker = makeSystemMessage || defaultSystemMessage;\n    // this always gets the latest context string\n    const contextString = getContextString([], defaultCopilotContextCategories); // TODO: make the context categories configurable\n\n    return new TextMessage({\n      content: systemMessageMaker(contextString, chatInstructions),\n      role: gqlRole.System,\n    });\n  }, [getContextString, makeSystemMessage, chatInstructions]);\n\n  const deleteMessage = useCallback(\n    (messageId: string) => {\n      setMessages((prev) => prev.filter((message) => message.id !== messageId));\n    },\n    [setMessages],\n  );\n\n  // Get chat helpers with updated config\n  const { append, reload, stop, runChatCompletion } = useChat({\n    ...options,\n    actions: Object.values(actions),\n    copilotConfig: copilotApiConfig,\n    initialMessages: aguiToGQL(options.initialMessages || []),\n    onFunctionCall: getFunctionCallHandler(),\n    onCoAgentStateRender,\n    messages,\n    setMessages,\n    makeSystemMessageCallback,\n    isLoading,\n    setIsLoading,\n    coagentStatesRef,\n    setCoagentStatesWithRef,\n    agentSession,\n    setAgentSession,\n    forwardedParameters,\n    threadId,\n    setThreadId,\n    runId,\n    setRunId,\n    chatAbortControllerRef,\n    agentLock,\n    extensions,\n    setExtensions,\n    langGraphInterruptAction,\n    setLangGraphInterruptAction,\n  });\n\n  const latestAppend = useUpdatedRef(append);\n  const latestAppendFunc = useAsyncCallback(\n    async (message: Message, options?: AppendMessageOptions) => {\n      abortSuggestions(options?.clearSuggestions);\n      return await latestAppend.current(aguiToGQL([message])[0], options);\n    },\n    [latestAppend],\n  );\n\n  const latestReload = useUpdatedRef(reload);\n  const latestReloadFunc = useAsyncCallback(\n    async (messageId: string) => {\n      return await latestReload.current(messageId);\n    },\n    [latestReload],\n  );\n\n  const latestStop = useUpdatedRef(stop);\n  const latestStopFunc = useCallback(() => {\n    return latestStop.current();\n  }, [latestStop]);\n\n  const latestDelete = useUpdatedRef(deleteMessage);\n  const latestDeleteFunc = useCallback(\n    (messageId: string) => {\n      return latestDelete.current(messageId);\n    },\n    [latestDelete],\n  );\n\n  const latestSetMessages = useUpdatedRef(setMessages);\n  const latestSetMessagesFunc = useCallback(\n    (messages: Message[]) => {\n      return latestSetMessages.current(aguiToGQL(messages));\n    },\n    [latestSetMessages],\n  );\n\n  const latestRunChatCompletion = useUpdatedRef(runChatCompletion);\n  const latestRunChatCompletionFunc = useAsyncCallback(async () => {\n    return await latestRunChatCompletion.current!();\n  }, [latestRunChatCompletion]);\n\n  const reset = useCallback(() => {\n    latestStopFunc();\n    setMessages([]);\n    setRunId(null);\n    setCoagentStatesWithRef({});\n    let initialAgentSession: AgentSession | null = null;\n    if (agentLock) {\n      initialAgentSession = {\n        agentName: agentLock,\n      };\n    }\n    setAgentSession(initialAgentSession);\n    // Reset suggestions when chat is reset\n    resetSuggestions();\n  }, [\n    latestStopFunc,\n    setMessages,\n    setThreadId,\n    setCoagentStatesWithRef,\n    setAgentSession,\n    agentLock,\n    resetSuggestions,\n  ]);\n\n  const latestReset = useUpdatedRef(reset);\n  const latestResetFunc = useCallback(() => {\n    return latestReset.current();\n  }, [latestReset]);\n\n  const interrupt = useLangGraphInterruptRender();\n\n  return {\n    visibleMessages: gqlToAGUI(messages, actions, coAgentStateRenders),\n    appendMessage: latestAppendFunc,\n    setMessages: latestSetMessagesFunc,\n    reloadMessages: latestReloadFunc,\n    stopGeneration: latestStopFunc,\n    reset: latestResetFunc,\n    deleteMessage: latestDeleteFunc,\n    runChatCompletion: latestRunChatCompletionFunc,\n    isLoading,\n    mcpServers,\n    setMcpServers,\n    suggestions,\n    setSuggestions,\n    generateSuggestions: generateSuggestionsFunc,\n    resetSuggestions,\n    isLoadingSuggestions: isLoadingSuggestionsRef.current,\n    interrupt,\n  };\n}\n\n// store `value` in a ref and update\n// it whenever it changes.\nfunction useUpdatedRef<T>(value: T) {\n  const ref = useRef(value);\n\n  useEffect(() => {\n    ref.current = value;\n  }, [value]);\n\n  return ref;\n}\n\nexport function defaultSystemMessage(\n  contextString: string,\n  additionalInstructions?: string,\n): string {\n  return (\n    `\nPlease act as an efficient, competent, conscientious, and industrious professional assistant.\n\nHelp the user achieve their goals, and you do so in a way that is as efficient as possible, without unnecessary fluff, but also without sacrificing professionalism.\nAlways be polite and respectful, and prefer brevity over verbosity.\n\nThe user has provided you with the following context:\n\\`\\`\\`\n${contextString}\n\\`\\`\\`\n\nThey have also provided you with functions you can call to initiate actions on their behalf, or functions you can call to receive more information.\n\nPlease assist them as best you can.\n\nYou can ask them for clarifying questions if needed, but don't be annoying about it. If you can reasonably 'fill in the blanks' yourself, do so.\n\nIf you would like to call a function, call it without saying anything else.\nIn case of a function error:\n- If this error stems from incorrect function parameters or syntax, you may retry with corrected arguments.\n- If the error's source is unclear or seems unrelated to your input, do not attempt further retries.\n` + (additionalInstructions ? `\\n\\n${additionalInstructions}` : \"\")\n  );\n}\n"],"mappings":"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","names":["_a","action","options","messages"]}

package/dist/chunk-MWHILKQH.mjs

@@ -1,18 +0,0 @@
-import {
-  useCopilotChat
-} from "./chunk-GRCHDHC4.mjs";
-
-// src/hooks/use-copilot-chat-light.ts
-function useCopilotChatLight(options = {}) {
-  const { appendMessage, setSuggestions, generateSuggestions } = useCopilotChat(options);
-  return {
-    appendMessage,
-    setSuggestions,
-    generateSuggestions
-  };
-}
-
-export {
-  useCopilotChatLight
-};
-//# sourceMappingURL=chunk-MWHILKQH.mjs.map

package/dist/chunk-MWHILKQH.mjs.map

@@ -1 +0,0 @@
-{"version":3,"sources":["../src/hooks/use-copilot-chat-light.ts"],"sourcesContent":["/**\n * `useCopilotChatLight` is a lightweight React hook for headless chat interactions.\n * Perfect for programmatic messaging, background operations, and custom UI implementations.\n *\n * **Open Source Friendly** - Works without requiring a `publicApiKey`.\n *\n * ## Use Cases:\n *\n * - **Programmatic Messaging**: Send messages without displaying chat UI\n * - **Background Operations**: Trigger AI interactions in the background\n * - **Custom UI**: Build your own chat interface using CopilotKit's messaging infrastructure\n * - **Testing & Automation**: Programmatic chat interactions for testing\n * - **Fire-and-Forget**: Send messages without needing to read responses\n * - **Suggestion Management**: Control chat suggestions programmatically\n *\n * ## What's Included:\n *\n * - `appendMessage` - Send messages to the chat\n * - `setSuggestions` - Manually control suggestions\n * - `generateSuggestions` - Trigger AI-powered suggestion generation\n *\n * ## What's NOT Included:\n *\n * - Message reading (`visibleMessages`)\n * - Loading states (`isLoading`, `isLoadingSuggestions`)\n * - Message management (`setMessages`, `deleteMessage`, `reloadMessages`)\n * - Chat controls (`reset`, `stopGeneration`)\n * - Advanced features (`mcpServers`, `runChatCompletion`, `interrupt`)\n *\n * ## Usage:\n *\n * ### Basic Messaging\n *\n * ```tsx\n * import { useCopilotChatLite } from \"@copilotkit/react-core\";\n * import { TextMessage, Role } from \"@copilotkit/runtime-client-gql\";\n *\n * export function BackgroundMessaging() {\n *   const { appendMessage } = useCopilotChatLite();\n *\n *   const sendBackgroundMessage = async () => {\n *     await appendMessage(new TextMessage({\n *       content: \"Process this data in the background\",\n *       role: Role.User,\n *     }));\n *   };\n *\n *   return <button onClick={sendBackgroundMessage}>Process Data</button>;\n * }\n * ```\n *\n * ### Suggestion Management\n *\n * ```tsx\n * import { useCopilotChatLight } from \"@copilotkit/react-core\";\n *\n * export function SuggestionController() {\n *   const { setSuggestions, generateSuggestions } = useCopilotChatLight();\n *\n *   const setCustomSuggestions = () => {\n *     setSuggestions([\n *       { title: \"Analyze Data\", message: \"Analyze the current dataset\" },\n *       { title: \"Generate Report\", message: \"Create a summary report\" }\n *     ]);\n *   };\n *\n *   const triggerAISuggestions = async () => {\n *     await generateSuggestions();\n *   };\n *\n *   return (\n *     <div>\n *       <button onClick={setCustomSuggestions}>Set Custom Suggestions</button>\n *       <button onClick={triggerAISuggestions}>Generate AI Suggestions</button>\n *     </div>\n *   );\n * }\n * ```\n *\n * ### Automated Workflows\n *\n * ```tsx\n * import { useCopilotChatLight } from \"@copilotkit/react-core\";\n *\n * export function AutomatedWorkflow() {\n *   const { appendMessage, setSuggestions } = useCopilotChatLight();\n *\n *   const runWorkflow = async () => {\n *     // Step 1: Send initial message\n *     await appendMessage(new TextMessage({\n *       content: \"Start workflow analysis\",\n *       role: Role.User,\n *     }));\n *\n *     // Step 2: Set contextual suggestions\n *     setSuggestions([\n *       { title: \"Continue\", message: \"Continue to next step\" },\n *       { title: \"Stop\", message: \"Stop the workflow\" }\n *     ]);\n *   };\n *\n *   return <button onClick={runWorkflow}>Run Automated Workflow</button>;\n * }\n * ```\n *\n * ## Return Type:\n *\n * ```tsx\n * const {\n *   appendMessage,    // Send messages programmatically\n *   setSuggestions,   // Set custom suggestions array\n *   generateSuggestions, // Trigger AI suggestion generation\n * } = useCopilotChatLight();\n * ```\n */\n\nimport { Message } from \"@copilotkit/shared\";\nimport { AppendMessageOptions } from \"./use-chat\";\nimport { useCopilotChat as useCopilotChatInternal } from \"./use-copilot-chat_internal\";\nimport type { SuggestionItem } from \"../utils\";\n\nexport interface UseCopilotChatLightOptions {\n  /**\n   * A unique identifier for the chat. If not provided, a random one will be\n   * generated. When provided, the chat instance with the same `id` will\n   * have shared state across components.\n   */\n  id?: string;\n\n  /**\n   * HTTP headers to be sent with the API request.\n   */\n  headers?: Record<string, string> | Headers;\n\n  /**\n   * Initial messages to populate the chat with.\n   */\n  initialMessages?: Message[];\n\n  /**\n   * A function to generate the system message. Defaults to `defaultSystemMessage`.\n   */\n  makeSystemMessage?: (contextString: string, additionalInstructions?: string) => string;\n}\n\nexport interface UseCopilotChatLightReturn {\n  /**\n   * Send a new message to the chat programmatically.\n   *\n   * @param message - The message to send\n   * @param options - Optional configuration for the message\n   *\n   * @example\n   * ```tsx\n   * await appendMessage(new TextMessage({\n   *   content: \"Hello, process this request\",\n   *   role: Role.User,\n   * }));\n   * ```\n   */\n  appendMessage: (message: Message, options?: AppendMessageOptions) => Promise<void>;\n\n  /**\n   * Manually set the suggestions array.\n   * Useful for custom suggestion workflows and manual control.\n   *\n   * @param suggestions - Array of suggestion items to display\n   *\n   * @example\n   * ```tsx\n   * setSuggestions([\n   *   { title: \"Continue\", message: \"Continue the process\" },\n   *   { title: \"Stop\", message: \"Stop the current operation\" }\n   * ]);\n   * ```\n   */\n  setSuggestions: (suggestions: SuggestionItem[]) => void;\n\n  /**\n   * Trigger AI-powered suggestion generation.\n   * Uses configurations from `useCopilotChatSuggestions` hooks.\n   * Respects global debouncing - only one generation can run at a time.\n   *\n   * @returns Promise that resolves when suggestions are generated\n   *\n   * @example\n   * ```tsx\n   * await generateSuggestions();\n   * ```\n   */\n  generateSuggestions: () => Promise<void>;\n}\n\n/**\n * A lightweight React hook for headless chat interactions.\n * Perfect for programmatic messaging, background operations, and custom UI implementations.\n *\n * **Open Source Friendly** - Works without requiring a `publicApiKey`.\n *\n * @param options - Configuration options for the chat\n * @returns Object containing appendMessage, setSuggestions, and generateSuggestions functions\n *\n * @example\n * ```tsx\n * const { appendMessage, setSuggestions, generateSuggestions } = useCopilotChatLite();\n * ```\n */\nexport function useCopilotChatLight(\n  options: UseCopilotChatLightOptions = {},\n): UseCopilotChatLightReturn {\n  // Use the internal implementation (no API key required)\n  const { appendMessage, setSuggestions, generateSuggestions } = useCopilotChatInternal(options);\n\n  return {\n    appendMessage,\n    setSuggestions,\n    generateSuggestions,\n  };\n}\n"],"mappings":";;;;;AA+MO,SAAS,oBACd,UAAsC,CAAC,GACZ;AAE3B,QAAM,EAAE,eAAe,gBAAgB,oBAAoB,IAAI,eAAuB,OAAO;AAE7F,SAAO;AAAA,IACL;AAAA,IACA;AAAA,IACA;AAAA,EACF;AACF;","names":[]}