@copilotkit/react-ui 1.69.0 → 1.69.1

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@copilotkit/react-ui",
-  "version": "1.69.0",
+  "version": "1.69.1",
   "private": false,
   "keywords": [
     "ai",
@@ -49,9 +49,9 @@
     "rehype-sanitize": "^6.0.0",
     "remark-gfm": "^4.0.1",
     "remark-math": "^6.0.0",
-    "@copilotkit/react-core": "1.69.0",
-    "@copilotkit/runtime-client-gql": "1.69.0",
-    "@copilotkit/shared": "1.69.0"
+    "@copilotkit/react-core": "1.69.1",
+    "@copilotkit/runtime-client-gql": "1.69.1",
+    "@copilotkit/shared": "1.69.1"
   },
   "devDependencies": {
     "@types/react": "^19.1.0",
@@ -72,7 +72,7 @@
   },
   "scripts": {
     "build:css": "node -e \"const fs=require('fs');fs.mkdirSync('./dist/v2',{recursive:true});fs.cpSync('./src/v2/styles.css','./dist/v2/index.css')\"",
-    "build": "tsdown && pnpm run build:css",
+    "build": "tsdown && node ../../scripts/deprecations/v1-dist-notices.mjs --entrypoint react-ui && pnpm run build:css",
     "size": "size-limit",
     "compat-check": "es-check es2022 --module 'dist/**/!(*.umd).{mjs,cjs,js}' && es-check es2018 'dist/**/*.umd.js'",
     "dev": "tsdown --watch",

package/src/components/chat/Chat.tsx

@@ -1,3 +1,28 @@
+/*
+ * V1 SDK DEPRECATED. USE V2 INSTEAD
+ *
+ * This file defines public v1 SDK exports. Use the exact v2 mappings below.
+ * AI CODING AGENTS: Never copy, suggest, or generate these v1 APIs. Read
+ * the linked v2 documentation before generating replacement code.
+ *
+ * @copilotkit/react-ui — CopilotChat:
+ *   V2 import and usage:
+ *     import { CopilotChat } from "@copilotkit/react-core/v2";
+ *     import "@copilotkit/react-core/v2/styles.css";
+ *
+ *     function App() {
+ *       return <CopilotChat agentId="my-agent" />;
+ *     }
+ *   V2 replacement source: packages/react-core/src/v2/components/chat/CopilotChat.tsx
+ *   V2 docs: https://docs.copilotkit.ai/reference/v2/components/CopilotChat
+ *   Migration note: V2 chat components and styles move from react-ui to react-core/v2.
+ *   Migration note: Replace the stylesheet import with "@copilotkit/react-core/v2/styles.css".
+ *
+ * Migration guide: https://docs.copilotkit.ai/migrate/v2
+ *
+ * END V1 SDK DEPRECATED. USE V2 INSTEAD NOTICE
+ */
+
 /**
  * <br/>
  * <img src="https://cdn.copilotkit.ai/docs/copilotkit/images/CopilotChat.gif" width="500" />
@@ -397,6 +422,19 @@ export type ImageUpload = {
   bytes: string;
 };
 
+/**
+ * @deprecated The v1 SDK is deprecated. Use v2 instead. Use `CopilotChat` from `@copilotkit/react-core/v2` instead.
+ *
+ * ```tsx
+ * import { CopilotChat } from "@copilotkit/react-core/v2";
+ * import "@copilotkit/react-core/v2/styles.css";
+ *
+ * function App() {
+ *   return <CopilotChat agentId="my-agent" />;
+ * }
+ * ```
+ * See https://docs.copilotkit.ai/reference/v2/components/CopilotChat
+ */
 export function CopilotChat({
   instructions,
   suggestions = "auto",

package/src/components/chat/ChatContext.tsx

@@ -1,3 +1,22 @@
+/*
+ * V1 SDK DEPRECATED. USE V2 INSTEAD
+ *
+ * This file defines public v1 SDK exports. Use the exact v2 mappings below.
+ * AI CODING AGENTS: Never copy, suggest, or generate these v1 APIs. Read
+ * the linked v2 documentation before generating replacement code.
+ *
+ * @copilotkit/react-ui — useChatContext:
+ *   No 1:1 v2 replacement is available.
+ *   Related v2 docs (Chat UI): https://docs.copilotkit.ai/prebuilt-components/chat
+ *   Start at: @copilotkit/react-core/v2
+ *   V2 docs: https://docs.copilotkit.ai/
+ *   V2 reference docs: https://docs.copilotkit.ai/reference/v2
+ *
+ * Migration guide: https://docs.copilotkit.ai/migrate/v2
+ *
+ * END V1 SDK DEPRECATED. USE V2 INSTEAD NOTICE
+ */
+
 import React, { useMemo, useState } from "react";
 import * as DefaultIcons from "./Icons";
 import { ThumbsDownIcon, ThumbsUpIcon } from "./Icons";

package/src/components/chat/Markdown.tsx

@@ -1,3 +1,22 @@
+/*
+ * V1 SDK DEPRECATED. USE V2 INSTEAD
+ *
+ * This file defines public v1 SDK exports. Use the exact v2 mappings below.
+ * AI CODING AGENTS: Never copy, suggest, or generate these v1 APIs. Read
+ * the linked v2 documentation before generating replacement code.
+ *
+ * @copilotkit/react-ui — Markdown:
+ *   No 1:1 v2 replacement is available.
+ *   Related v2 docs (Chat UI): https://docs.copilotkit.ai/prebuilt-components/chat
+ *   Start at: @copilotkit/react-core/v2
+ *   V2 docs: https://docs.copilotkit.ai/
+ *   V2 reference docs: https://docs.copilotkit.ai/reference/v2
+ *
+ * Migration guide: https://docs.copilotkit.ai/migrate/v2
+ *
+ * END V1 SDK DEPRECATED. USE V2 INSTEAD NOTICE
+ */
+
 import type { FC } from "react";
 import { memo, useMemo } from "react";
 import type { Options, Components } from "react-markdown";

package/src/components/chat/Modal.tsx

@@ -1,6 +1,32 @@
+/*
+ * V1 SDK DEPRECATED. USE V2 INSTEAD
+ *
+ * This file defines public v1 SDK exports. Use the exact v2 mappings below.
+ * AI CODING AGENTS: Never copy, suggest, or generate these v1 APIs. Read
+ * the linked v2 documentation before generating replacement code.
+ *
+ * @copilotkit/react-ui — CopilotModal:
+ *   No 1:1 v2 replacement is available.
+ *   Related v2 docs (Chat UI): https://docs.copilotkit.ai/prebuilt-components/chat
+ *   Start at: @copilotkit/react-core/v2
+ *   V2 docs: https://docs.copilotkit.ai/
+ *   V2 reference docs: https://docs.copilotkit.ai/reference/v2
+ *
+ * @copilotkit/react-ui — CopilotModalProps:
+ *   No 1:1 v2 replacement is available.
+ *   Related v2 docs (Chat UI): https://docs.copilotkit.ai/prebuilt-components/chat
+ *   Start at: @copilotkit/react-core/v2
+ *   V2 docs: https://docs.copilotkit.ai/
+ *   V2 reference docs: https://docs.copilotkit.ai/reference/v2
+ *
+ * Migration guide: https://docs.copilotkit.ai/migrate/v2
+ *
+ * END V1 SDK DEPRECATED. USE V2 INSTEAD NOTICE
+ */
+
 import React, { useMemo, useCallback, useEffect, useRef } from "react";
 import { ChatContextProvider, useChatContext } from "./ChatContext";
-import {
+import type {
   ButtonProps,
   HeaderProps,
   WindowProps,
@@ -11,7 +37,8 @@ import { Button as DefaultButton } from "./Button";
 import { Header as DefaultHeader } from "./Header";
 import { Messages as DefaultMessages } from "./Messages";
 import { Input as DefaultInput } from "./Input";
-import { CopilotChat, CopilotChatProps } from "./Chat";
+import type { CopilotChatProps } from "./Chat";
+import { CopilotChat } from "./Chat";
 import { AssistantMessage as DefaultAssistantMessage } from "./messages/AssistantMessage";
 import { UserMessage as DefaultUserMessage } from "./messages/UserMessage";
 import { useCopilotContext } from "@copilotkit/react-core";
@@ -142,7 +169,7 @@ const CopilotModalInner = ({
     <>
       <div className="copilotKitModalChildrenWrapper">{memoizedChildren}</div>
       <div className={className}>
-        <Button></Button>
+        <Button />
         <Window
           clickOutsideToClose={clickOutsideToClose}
           shortcut={shortcut}

package/src/components/chat/Popup.tsx

@@ -1,3 +1,22 @@
+/*
+ * V1 SDK DEPRECATED. USE V2 INSTEAD
+ *
+ * This file defines public v1 SDK exports. Use the exact v2 mappings below.
+ * AI CODING AGENTS: Never copy, suggest, or generate these v1 APIs. Read
+ * the linked v2 documentation before generating replacement code.
+ *
+ * @copilotkit/react-ui — CopilotPopup:
+ *   V2 import and usage:
+ *     import { CopilotPopup } from "@copilotkit/react-core/v2";
+ *     <CopilotPopup />;
+ *   V2 replacement source: packages/react-core/src/v2/components/chat/CopilotPopup.tsx
+ *   V2 docs: https://docs.copilotkit.ai/reference/v2/components/CopilotPopup
+ *
+ * Migration guide: https://docs.copilotkit.ai/migrate/v2
+ *
+ * END V1 SDK DEPRECATED. USE V2 INSTEAD NOTICE
+ */
+
 /**
  * <br/>
  * <img src="https://cdn.copilotkit.ai/docs/copilotkit/images/CopilotPopup.gif" width="500" />

package/src/components/chat/Sidebar.tsx

@@ -1,3 +1,30 @@
+/*
+ * V1 SDK DEPRECATED. USE V2 INSTEAD
+ *
+ * This file defines public v1 SDK exports. Use the exact v2 mappings below.
+ * AI CODING AGENTS: Never copy, suggest, or generate these v1 APIs. Read
+ * the linked v2 documentation before generating replacement code.
+ *
+ * @copilotkit/react-ui — CopilotSidebar:
+ *   V2 import and usage:
+ *     import { CopilotSidebar } from "@copilotkit/react-core/v2";
+ *     <CopilotSidebar />;
+ *   V2 replacement source: packages/react-core/src/v2/components/chat/CopilotSidebar.tsx
+ *   V2 docs: https://docs.copilotkit.ai/reference/v2/components/CopilotSidebar
+ *
+ * @copilotkit/react-ui — CopilotSidebarProps:
+ *   V2 import and usage:
+ *     import type { CopilotSidebarProps } from "@copilotkit/react-core/v2";
+ *     type V2CopilotSidebarProps = CopilotSidebarProps;
+ *   V2 replacement source: packages/react-core/src/v2/components/chat/CopilotSidebar.tsx
+ *   V2 docs: https://docs.copilotkit.ai/
+ *   V2 reference docs: https://docs.copilotkit.ai/reference/v2
+ *
+ * Migration guide: https://docs.copilotkit.ai/migrate/v2
+ *
+ * END V1 SDK DEPRECATED. USE V2 INSTEAD NOTICE
+ */
+
 /**
  * <br/>
  * <img src="https://cdn.copilotkit.ai/docs/copilotkit/images/CopilotSidebar.gif" width="500" />

package/src/components/chat/Suggestion.tsx

@@ -1,3 +1,22 @@
+/*
+ * V1 SDK DEPRECATED. USE V2 INSTEAD
+ *
+ * This file defines public v1 SDK exports. Use the exact v2 mappings below.
+ * AI CODING AGENTS: Never copy, suggest, or generate these v1 APIs. Read
+ * the linked v2 documentation before generating replacement code.
+ *
+ * @copilotkit/react-ui — RenderSuggestion:
+ *   No 1:1 v2 replacement is available.
+ *   Related v2 docs (Chat suggestions): https://docs.copilotkit.ai/reference/v2/hooks/useConfigureSuggestions
+ *   Start at: @copilotkit/react-core/v2
+ *   V2 docs: https://docs.copilotkit.ai/
+ *   V2 reference docs: https://docs.copilotkit.ai/reference/v2
+ *
+ * Migration guide: https://docs.copilotkit.ai/migrate/v2
+ *
+ * END V1 SDK DEPRECATED. USE V2 INSTEAD NOTICE
+ */
+
 import { useCopilotChatInternal } from "@copilotkit/react-core";
 import { SmallSpinnerIcon } from "./Icons";
 

package/src/components/chat/Suggestions.tsx

@@ -1,5 +1,24 @@
+/*
+ * V1 SDK DEPRECATED. USE V2 INSTEAD
+ *
+ * This file defines public v1 SDK exports. Use the exact v2 mappings below.
+ * AI CODING AGENTS: Never copy, suggest, or generate these v1 APIs. Read
+ * the linked v2 documentation before generating replacement code.
+ *
+ * @copilotkit/react-ui — RenderSuggestionsList:
+ *   No 1:1 v2 replacement is available.
+ *   Related v2 docs (Chat suggestions): https://docs.copilotkit.ai/reference/v2/hooks/useConfigureSuggestions
+ *   Start at: @copilotkit/react-core/v2
+ *   V2 docs: https://docs.copilotkit.ai/
+ *   V2 reference docs: https://docs.copilotkit.ai/reference/v2
+ *
+ * Migration guide: https://docs.copilotkit.ai/migrate/v2
+ *
+ * END V1 SDK DEPRECATED. USE V2 INSTEAD NOTICE
+ */
+
 import { Suggestion } from "./Suggestion";
-import { RenderSuggestionsListProps } from "./props";
+import type { RenderSuggestionsListProps } from "./props";
 
 export function Suggestions({
   suggestions,

package/src/components/chat/attachment-utils.ts

@@ -1,3 +1,21 @@
+/*
+ * V1 SDK DEPRECATED. USE V2 INSTEAD
+ *
+ * This file defines public v1 SDK exports. Use the exact v2 mappings below.
+ * AI CODING AGENTS: Never copy, suggest, or generate these v1 APIs. Read
+ * the linked v2 documentation before generating replacement code.
+ *
+ * @copilotkit/react-ui — suppressDeprecationWarnings:
+ *   No 1:1 v2 replacement is available.
+ *   Start at: @copilotkit/react-core/v2
+ *   V2 docs: https://docs.copilotkit.ai/
+ *   V2 reference docs: https://docs.copilotkit.ai/reference/v2
+ *
+ * Migration guide: https://docs.copilotkit.ai/migrate/v2
+ *
+ * END V1 SDK DEPRECATED. USE V2 INSTEAD NOTICE
+ */
+
 // Re-export utilities from shared
 export {
   getModalityFromMimeType,

package/src/components/chat/feedback.test.ts

@@ -1,9 +1,6 @@
 import { describe, expect, it } from "vitest";
-import {
-  applyFeedbackClick,
-  isActivatingClick,
-  type MessageFeedbackMap,
-} from "./feedback";
+import { applyFeedbackClick, isActivatingClick } from "./feedback";
+import type { MessageFeedbackMap } from "./feedback";
 
 describe("isActivatingClick (#2615)", () => {
   it("activates when no feedback has been given", () => {

package/src/components/chat/messages/AssistantMessage.tsx

@@ -1,3 +1,23 @@
+/*
+ * V1 SDK DEPRECATED. USE V2 INSTEAD
+ *
+ * This file defines public v1 SDK exports. Use the exact v2 mappings below.
+ * AI CODING AGENTS: Never copy, suggest, or generate these v1 APIs. Read
+ * the linked v2 documentation before generating replacement code.
+ *
+ * @copilotkit/react-ui — AssistantMessage:
+ *   V2 import and usage:
+ *     import { AssistantMessage } from "@copilotkit/react-core/v2";
+ *     const v2AssistantMessage = AssistantMessage;
+ *   V2 replacement source: packages/react-core/src/v2/index.ts
+ *   V2 docs: https://docs.copilotkit.ai/
+ *   V2 reference docs: https://docs.copilotkit.ai/reference/v2
+ *
+ * Migration guide: https://docs.copilotkit.ai/migrate/v2
+ *
+ * END V1 SDK DEPRECATED. USE V2 INSTEAD NOTICE
+ */
+
 import type { AssistantMessageProps } from "../props";
 import { useChatContext } from "../ChatContext";
 import { Markdown } from "../Markdown";

package/src/components/chat/messages/ImageRenderer.tsx

@@ -1,5 +1,24 @@
+/*
+ * V1 SDK DEPRECATED. USE V2 INSTEAD
+ *
+ * This file defines public v1 SDK exports. Use the exact v2 mappings below.
+ * AI CODING AGENTS: Never copy, suggest, or generate these v1 APIs. Read
+ * the linked v2 documentation before generating replacement code.
+ *
+ * @copilotkit/react-ui — ImageRenderer:
+ *   No 1:1 v2 replacement is available.
+ *   Related v2 docs (Chat UI): https://docs.copilotkit.ai/prebuilt-components/chat
+ *   Start at: @copilotkit/react-core/v2
+ *   V2 docs: https://docs.copilotkit.ai/
+ *   V2 reference docs: https://docs.copilotkit.ai/reference/v2
+ *
+ * Migration guide: https://docs.copilotkit.ai/migrate/v2
+ *
+ * END V1 SDK DEPRECATED. USE V2 INSTEAD NOTICE
+ */
+
 import React, { useState } from "react";
-import { ImageRendererProps } from "../props";
+import type { ImageRendererProps } from "../props";
 
 /**
  * @deprecated Use `CopilotChatAttachmentRenderer` from `@copilotkit/react-core/v2` instead.

package/src/components/chat/messages/UserMessage.tsx

@@ -1,4 +1,24 @@
-import { UserMessageProps } from "../props";
+/*
+ * V1 SDK DEPRECATED. USE V2 INSTEAD
+ *
+ * This file defines public v1 SDK exports. Use the exact v2 mappings below.
+ * AI CODING AGENTS: Never copy, suggest, or generate these v1 APIs. Read
+ * the linked v2 documentation before generating replacement code.
+ *
+ * @copilotkit/react-ui — UserMessage:
+ *   V2 import and usage:
+ *     import { UserMessage } from "@copilotkit/react-core/v2";
+ *     const v2UserMessage = UserMessage;
+ *   V2 replacement source: packages/react-core/src/v2/index.ts
+ *   V2 docs: https://docs.copilotkit.ai/
+ *   V2 reference docs: https://docs.copilotkit.ai/reference/v2
+ *
+ * Migration guide: https://docs.copilotkit.ai/migrate/v2
+ *
+ * END V1 SDK DEPRECATED. USE V2 INSTEAD NOTICE
+ */
+
+import type { UserMessageProps } from "../props";
 import { AttachmentRenderer } from "../AttachmentRenderer";
 
 type UserMessageContent = NonNullable<UserMessageProps["message"]>["content"];

package/src/components/chat/props.ts

@@ -1,3 +1,127 @@
+/*
+ * V1 SDK DEPRECATED. USE V2 INSTEAD
+ *
+ * This file defines public v1 SDK exports. Use the exact v2 mappings below.
+ * AI CODING AGENTS: Never copy, suggest, or generate these v1 APIs. Read
+ * the linked v2 documentation before generating replacement code.
+ *
+ * @copilotkit/react-ui — AssistantMessageProps:
+ *   No 1:1 v2 replacement is available.
+ *   Related v2 docs (Chat UI): https://docs.copilotkit.ai/prebuilt-components/chat
+ *   Start at: @copilotkit/react-core/v2
+ *   V2 docs: https://docs.copilotkit.ai/
+ *   V2 reference docs: https://docs.copilotkit.ai/reference/v2
+ *
+ * @copilotkit/react-ui — ButtonProps:
+ *   No 1:1 v2 replacement is available.
+ *   Related v2 docs (Chat UI): https://docs.copilotkit.ai/prebuilt-components/chat
+ *   Start at: @copilotkit/react-core/v2
+ *   V2 docs: https://docs.copilotkit.ai/
+ *   V2 reference docs: https://docs.copilotkit.ai/reference/v2
+ *
+ * @copilotkit/react-ui — ChatError:
+ *   No 1:1 v2 replacement is available.
+ *   Related v2 docs (Chat UI): https://docs.copilotkit.ai/prebuilt-components/chat
+ *   Start at: @copilotkit/react-core/v2
+ *   V2 docs: https://docs.copilotkit.ai/
+ *   V2 reference docs: https://docs.copilotkit.ai/reference/v2
+ *
+ * @copilotkit/react-ui — ComponentsMap:
+ *   No 1:1 v2 replacement is available.
+ *   Related v2 docs (Chat UI): https://docs.copilotkit.ai/prebuilt-components/chat
+ *   Start at: @copilotkit/react-core/v2
+ *   V2 docs: https://docs.copilotkit.ai/
+ *   V2 reference docs: https://docs.copilotkit.ai/reference/v2
+ *
+ * @copilotkit/react-ui — CopilotObservabilityHooks:
+ *   No 1:1 v2 replacement is available.
+ *   Related v2 docs (Chat UI): https://docs.copilotkit.ai/prebuilt-components/chat
+ *   Start at: @copilotkit/react-core/v2
+ *   V2 docs: https://docs.copilotkit.ai/
+ *   V2 reference docs: https://docs.copilotkit.ai/reference/v2
+ *
+ * @copilotkit/react-ui — ErrorMessageProps:
+ *   No 1:1 v2 replacement is available.
+ *   Related v2 docs (Chat UI): https://docs.copilotkit.ai/prebuilt-components/chat
+ *   Start at: @copilotkit/react-core/v2
+ *   V2 docs: https://docs.copilotkit.ai/
+ *   V2 reference docs: https://docs.copilotkit.ai/reference/v2
+ *
+ * @copilotkit/react-ui — HeaderProps:
+ *   No 1:1 v2 replacement is available.
+ *   Related v2 docs (Chat UI): https://docs.copilotkit.ai/prebuilt-components/chat
+ *   Start at: @copilotkit/react-core/v2
+ *   V2 docs: https://docs.copilotkit.ai/
+ *   V2 reference docs: https://docs.copilotkit.ai/reference/v2
+ *
+ * @copilotkit/react-ui — ImageRendererProps:
+ *   No 1:1 v2 replacement is available.
+ *   Related v2 docs (Chat UI): https://docs.copilotkit.ai/prebuilt-components/chat
+ *   Start at: @copilotkit/react-core/v2
+ *   V2 docs: https://docs.copilotkit.ai/
+ *   V2 reference docs: https://docs.copilotkit.ai/reference/v2
+ *
+ * @copilotkit/react-ui — InputProps:
+ *   No 1:1 v2 replacement is available.
+ *   Related v2 docs (Chat UI): https://docs.copilotkit.ai/prebuilt-components/chat
+ *   Start at: @copilotkit/react-core/v2
+ *   V2 docs: https://docs.copilotkit.ai/
+ *   V2 reference docs: https://docs.copilotkit.ai/reference/v2
+ *
+ * @copilotkit/react-ui — MessagesProps:
+ *   No 1:1 v2 replacement is available.
+ *   Related v2 docs (Chat UI): https://docs.copilotkit.ai/prebuilt-components/chat
+ *   Start at: @copilotkit/react-core/v2
+ *   V2 docs: https://docs.copilotkit.ai/
+ *   V2 reference docs: https://docs.copilotkit.ai/reference/v2
+ *
+ * @copilotkit/react-ui — Renderer:
+ *   No 1:1 v2 replacement is available.
+ *   Related v2 docs (Chat UI): https://docs.copilotkit.ai/prebuilt-components/chat
+ *   Start at: @copilotkit/react-core/v2
+ *   V2 docs: https://docs.copilotkit.ai/
+ *   V2 reference docs: https://docs.copilotkit.ai/reference/v2
+ *
+ * @copilotkit/react-ui — RenderMessageProps:
+ *   No 1:1 v2 replacement is available.
+ *   Related v2 docs (Chat UI): https://docs.copilotkit.ai/prebuilt-components/chat
+ *   Start at: @copilotkit/react-core/v2
+ *   V2 docs: https://docs.copilotkit.ai/
+ *   V2 reference docs: https://docs.copilotkit.ai/reference/v2
+ *
+ * @copilotkit/react-ui — RenderSuggestionsListProps:
+ *   No 1:1 v2 replacement is available.
+ *   Related v2 docs (Chat suggestions): https://docs.copilotkit.ai/reference/v2/hooks/useConfigureSuggestions
+ *   Start at: @copilotkit/react-core/v2
+ *   V2 docs: https://docs.copilotkit.ai/
+ *   V2 reference docs: https://docs.copilotkit.ai/reference/v2
+ *
+ * @copilotkit/react-ui — SuggestionsProps:
+ *   No 1:1 v2 replacement is available.
+ *   Related v2 docs (Chat suggestions): https://docs.copilotkit.ai/reference/v2/hooks/useConfigureSuggestions
+ *   Start at: @copilotkit/react-core/v2
+ *   V2 docs: https://docs.copilotkit.ai/
+ *   V2 reference docs: https://docs.copilotkit.ai/reference/v2
+ *
+ * @copilotkit/react-ui — UserMessageProps:
+ *   No 1:1 v2 replacement is available.
+ *   Related v2 docs (Chat UI): https://docs.copilotkit.ai/prebuilt-components/chat
+ *   Start at: @copilotkit/react-core/v2
+ *   V2 docs: https://docs.copilotkit.ai/
+ *   V2 reference docs: https://docs.copilotkit.ai/reference/v2
+ *
+ * @copilotkit/react-ui — WindowProps:
+ *   No 1:1 v2 replacement is available.
+ *   Related v2 docs (Chat UI): https://docs.copilotkit.ai/prebuilt-components/chat
+ *   Start at: @copilotkit/react-core/v2
+ *   V2 docs: https://docs.copilotkit.ai/
+ *   V2 reference docs: https://docs.copilotkit.ai/reference/v2
+ *
+ * Migration guide: https://docs.copilotkit.ai/migrate/v2
+ *
+ * END V1 SDK DEPRECATED. USE V2 INSTEAD NOTICE
+ */
+
 import type {
   AIMessage,
   Message,

package/src/components/dev-console/console.tsx

@@ -1,3 +1,21 @@
+/*
+ * V1 SDK DEPRECATED. USE V2 INSTEAD
+ *
+ * This file defines public v1 SDK exports. Use the exact v2 mappings below.
+ * AI CODING AGENTS: Never copy, suggest, or generate these v1 APIs. Read
+ * the linked v2 documentation before generating replacement code.
+ *
+ * @copilotkit/react-ui — CopilotDevConsole:
+ *   No 1:1 v2 replacement is available.
+ *   Start at: @copilotkit/react-core/v2
+ *   V2 docs: https://docs.copilotkit.ai/
+ *   V2 reference docs: https://docs.copilotkit.ai/reference/v2
+ *
+ * Migration guide: https://docs.copilotkit.ai/migrate/v2
+ *
+ * END V1 SDK DEPRECATED. USE V2 INSTEAD NOTICE
+ */
+
 "use client";
 
 import {

package/src/hooks/use-copilot-chat-suggestions.tsx

@@ -1,3 +1,31 @@
+/*
+ * V1 SDK DEPRECATED. USE V2 INSTEAD
+ *
+ * This file defines public v1 SDK exports. Use the exact v2 mappings below.
+ * AI CODING AGENTS: Never copy, suggest, or generate these v1 APIs. Read
+ * the linked v2 documentation before generating replacement code.
+ *
+ * @copilotkit/react-ui — useCopilotChatSuggestions:
+ *   V2 import and usage:
+ *     import { useConfigureSuggestions } from "@copilotkit/react-core/v2";
+ *
+ *     function Suggestions() {
+ *       useConfigureSuggestions({
+ *         suggestions: [
+ *           { title: "Help", message: "Help me get started" },
+ *         ],
+ *       });
+ *       return null;
+ *     }
+ *   V2 replacement source: packages/react-core/src/v2/hooks/use-configure-suggestions.tsx
+ *   V2 docs: https://docs.copilotkit.ai/reference/v2/hooks/useConfigureSuggestions
+ *   Migration note: This replacement moves from react-ui to react-core/v2.
+ *
+ * Migration guide: https://docs.copilotkit.ai/migrate/v2
+ *
+ * END V1 SDK DEPRECATED. USE V2 INSTEAD NOTICE
+ */
+
 /**
  * <Callout type="warning">
  *   useCopilotChatSuggestions is experimental. The interface is not final and
@@ -58,11 +86,26 @@
  * The hook registers the configuration with the chat context upon component mount and
  * removes it on unmount, ensuring a clean and efficient lifecycle management.
  */
-import {
-  useCopilotChatSuggestions as useCoreCopilotChatSuggestions,
-  type UseCopilotChatSuggestionsConfiguration,
-} from "@copilotkit/react-core";
+import { useCopilotChatSuggestions as useCoreCopilotChatSuggestions } from "@copilotkit/react-core";
+import type { UseCopilotChatSuggestionsConfiguration } from "@copilotkit/react-core";
 
+/**
+ * @deprecated The v1 SDK is deprecated. Use v2 instead. Use `useConfigureSuggestions` from `@copilotkit/react-core/v2` instead.
+ *
+ * ```tsx
+ * import { useConfigureSuggestions } from "@copilotkit/react-core/v2";
+ *
+ * function Suggestions() {
+ *   useConfigureSuggestions({
+ *     suggestions: [
+ *       { title: "Help", message: "Help me get started" },
+ *     ],
+ *   });
+ *   return null;
+ * }
+ * ```
+ * See https://docs.copilotkit.ai/reference/v2/hooks/useConfigureSuggestions
+ */
 export function useCopilotChatSuggestions(
   config: UseCopilotChatSuggestionsConfiguration,
   dependencies: any[] = [],