@copilotkit/react-core 1.50.1 → 1.51.0-next.1

package/CHANGELOG.md

@@ -1,5 +1,21 @@
 # ui
 
+## 1.51.0-next.1
+
+### Patch Changes
+
+- @copilotkit/runtime-client-gql@1.51.0-next.1
+- @copilotkit/shared@1.51.0-next.1
+- @copilotkitnext/core@1.51.0-next.1
+- @copilotkitnext/react@1.51.0-next.1
+
+## 1.50.2-next.0
+
+### Patch Changes
+
+- @copilotkit/runtime-client-gql@1.50.2-next.0
+- @copilotkit/shared@1.50.2-next.0
+
 ## 1.50.1
 
 ### Patch Changes
@@ -605,14 +621,12 @@
   agentic runtimes we acquired tech-debt that, with this PR, is being alleviated.
 
   As such, the following features have been updated to be completely functional with Headless UI.
-
   - Generative UI
   - Suggestions
   - Agentic Generative UI
   - Interrupts
 
   In addition, a variety of QOL changes have been made.
-
   - New AG-UI based message types
   - Inline code rendering is fixed
 
@@ -624,19 +638,15 @@
 - 6d1de58: - fix: address issues that would cause headless UI breaking changes in the next release
 
   Signed-off-by: Tyler Slaton <tyler@copilotkit.ai>
-
   - fix: more fixes addressing breaking changes in new Headless UI
 
   Signed-off-by: Tyler Slaton <tyler@copilotkit.ai>
-
   - chore: address linting issues
 
   Signed-off-by: Tyler Slaton <tyler@copilotkit.ai>
-
   - chore: fixing branding and docs
 
   Signed-off-by: Tyler Slaton <tyler@copilotkit.ai>
-
   - chore: more docs fixing
 
   Signed-off-by: Tyler Slaton <tyler@copilotkit.ai>
@@ -678,19 +688,15 @@
 - 6d1de58: - fix: address issues that would cause headless UI breaking changes in the next release
 
   Signed-off-by: Tyler Slaton <tyler@copilotkit.ai>
-
   - fix: more fixes addressing breaking changes in new Headless UI
 
   Signed-off-by: Tyler Slaton <tyler@copilotkit.ai>
-
   - chore: address linting issues
 
   Signed-off-by: Tyler Slaton <tyler@copilotkit.ai>
-
   - chore: fixing branding and docs
 
   Signed-off-by: Tyler Slaton <tyler@copilotkit.ai>
-
   - chore: more docs fixing
 
   Signed-off-by: Tyler Slaton <tyler@copilotkit.ai>
@@ -775,14 +781,12 @@
   agentic runtimes we acquired tech-debt that, with this PR, is being alleviated.
 
   As such, the following features have been updated to be completely functional with Headless UI.
-
   - Generative UI
   - Suggestions
   - Agentic Generative UI
   - Interrupts
 
   In addition, a variety of QOL changes have been made.
-
   - New AG-UI based message types
   - Inline code rendering is fixed
 
@@ -848,7 +852,6 @@
 - 3f8c575: - fix: use time travel for regeneration of messages
   - fix: use a better cutoff for regeneration request
 - fac89c2: - refactor: rename onTrace to onError throughout codebase
-
   - Rename CopilotTraceEvent to CopilotErrorEvent and CopilotTraceHandler to CopilotErrorHandler
 
 - e1de032: - fix: synchronously execute renderAndWaitForResponse
@@ -941,7 +944,6 @@
   works with any combination of action given much more freedom when asking for user input.
 
   Signed-off-by: Tyler Slaton <tyler@copilotkit.ai>
-
   - @copilotkit/runtime-client-gql@1.9.2-next.20
   - @copilotkit/shared@1.9.2-next.20
 
@@ -957,7 +959,6 @@
 ### Patch Changes
 
 - fac89c2: - refactor: rename onTrace to onError throughout codebase
-
   - Rename CopilotTraceEvent to CopilotErrorEvent and CopilotTraceHandler to CopilotErrorHandler
 
 - Updated dependencies [fac89c2]
@@ -1454,11 +1455,9 @@
 - c0d3261: - full AWP support
 
   Signed-off-by: Tyler Slaton <tyler@copilotkit.ai>
-
   - refactor: address linter issues with the new pages
 
   Signed-off-by: Tyler Slaton <tyler@copilotkit.ai>
-
   - Merge branch 'mme/acp' into mme/mastra
   - add sse example
   - Create small-turkeys-agree.md
@@ -1484,11 +1483,9 @@
 - c0d3261: - full AWP support
 
   Signed-off-by: Tyler Slaton <tyler@copilotkit.ai>
-
   - refactor: address linter issues with the new pages
 
   Signed-off-by: Tyler Slaton <tyler@copilotkit.ai>
-
   - Merge branch 'mme/acp' into mme/mastra
   - add sse example
   - Create small-turkeys-agree.md
@@ -2603,7 +2600,6 @@
 - e16d95e: New prerelease
 - 1721cbd: Add convertActionsToDynamicStructuredTools to sdk-js
 - CopilotKit Core:
-
   - Improved error messages and overall logs
   - `useCopilotAction.renderAndAwait` renamed to `.renderAndAwaitForResponse` (backwards compatible, will be deprecated in the future)
   - Improved scrolling behavior. It is now possible to scroll up during LLM response generation
@@ -2611,7 +2607,6 @@
   - Updated interfaces for better developer ergonomics
 
   CoAgents:
-
   - Renamed `remoteActions` to `remoteEndpoints` (backwards compatible, will be deprecated in the future)
   - Support for LangGraph Platform in Remote Endpoints
   - LangGraph JS Support for CoAgents (locally via `langgraph dev`, `langgraph up` or deployed to LangGraph Platform)
@@ -2619,7 +2614,6 @@
   - Enhanced state management and message handling
 
   CopilotKid Back-end SDK:
-
   - Released a whole-new `@copilotkit/sdk-js` for building agents with LangGraph JS Support
 
 - 8d0144f: bump
@@ -2994,7 +2988,6 @@ CopilotKid Back-end SDK:
 ### Patch Changes
 
 - inject minified css in bundle
-
   - removes the need to import `styles.css` manually
   - empty `styles.css` included in the build for backwards compatibility
   - uses tsup's `injectStyles` with `postcss` to bundle and minify the CSS, then inject it as a style tag
@@ -3145,7 +3138,6 @@ CopilotKid Back-end SDK:
 ### Major Changes
 
 - b6a4b6eb: V1.0 Release Candidate
-
   - A robust new protocol between the frontend and the Copilot Runtime
   - Support for Copilot Cloud
   - Generative UI
@@ -3153,7 +3145,6 @@ CopilotKid Back-end SDK:
   - OpenAI assistant API streaming
 
 - V1.0 Release
-
   - A robust new protocol between the frontend and the Copilot Runtime
   - Support for Copilot Cloud
   - Generative UI
@@ -3194,7 +3185,6 @@ CopilotKid Back-end SDK:
 ### Major Changes
 
 - V1.0 Release Candidate
-
   - A robust new protocol between the frontend and the Copilot Runtime
   - Support for Copilot Cloud
   - Generative UI

package/LICENSE

@@ -0,0 +1,21 @@
+The MIT License
+
+Copyright (c) Atai Barkai
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in
+all copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN
+THE SOFTWARE.

package/dist/{chunk-LCZZ7YGZ.mjs → chunk-3V5TOYKW.mjs}

@@ -117,4 +117,4 @@ ${instructions}
 export {
   CopilotTask
 };
-//# sourceMappingURL=chunk-LCZZ7YGZ.mjs.map
+//# sourceMappingURL=chunk-3V5TOYKW.mjs.map

package/dist/chunk-3V5TOYKW.mjs.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../src/lib/copilot-task.ts"],"sourcesContent":["/**\n * This class is used to execute one-off tasks, for example on button press. It can use the context available via [useCopilotReadable](/reference/hooks/useCopilotReadable) and the actions provided by [useCopilotAction](/reference/hooks/useCopilotAction), or you can provide your own context and actions.\n *\n * ## Example\n * In the simplest case, use CopilotTask in the context of your app by giving it instructions on what to do.\n *\n * ```tsx\n * import { CopilotTask, useCopilotContext } from \"@copilotkit/react-core\";\n *\n * export function MyComponent() {\n *   const context = useCopilotContext();\n *\n *   const task = new CopilotTask({\n *     instructions: \"Set a random message\",\n *     actions: [\n *       {\n *         name: \"setMessage\",\n *       description: \"Set the message.\",\n *       argumentAnnotations: [\n *         {\n *           name: \"message\",\n *           type: \"string\",\n *           description:\n *             \"A message to display.\",\n *           required: true,\n *         },\n *       ],\n *      }\n *     ]\n *   });\n *\n *   const executeTask = async () => {\n *     await task.run(context, action);\n *   }\n *\n *   return (\n *     <>\n *       <button onClick={executeTask}>\n *         Execute task\n *       </button>\n *     </>\n *   )\n * }\n * ```\n *\n * Have a look at the [Presentation Example App](https://github.com/CopilotKit/CopilotKit/blob/main/src/v1.x/examples/next-openai/src/app/presentation/page.tsx) for a more complete example.\n */\n\nimport {\n  ActionExecutionMessage,\n  CopilotRuntimeClient,\n  Message,\n  Role,\n  TextMessage,\n  convertGqlOutputToMessages,\n  convertMessagesToGqlInput,\n  filterAgentStateMessages,\n  CopilotRequestType,\n  ForwardedParametersInput,\n} from \"@copilotkit/runtime-client-gql\";\nimport { FrontendAction, processActionsForRuntimeRequest } from \"../types/frontend-action\";\nimport { CopilotContextParams } from \"../context\";\nimport { defaultCopilotContextCategories } from \"../components\";\n\nexport interface CopilotTaskConfig {\n  /**\n   * The instructions to be given to the assistant.\n   */\n  instructions: string;\n  /**\n   * An array of action definitions that can be called.\n   */\n  actions?: FrontendAction<any>[];\n  /**\n   * Whether to include the copilot readable context in the task.\n   */\n  includeCopilotReadable?: boolean;\n\n  /**\n   * Whether to include actions defined via useCopilotAction in the task.\n   */\n  includeCopilotActions?: boolean;\n\n  /**\n   * The forwarded parameters to use for the task.\n   */\n  forwardedParameters?: ForwardedParametersInput;\n}\n\nexport class CopilotTask<T = any> {\n  private instructions: string;\n  private actions: FrontendAction<any>[];\n  private includeCopilotReadable: boolean;\n  private includeCopilotActions: boolean;\n  private forwardedParameters?: ForwardedParametersInput;\n  constructor(config: CopilotTaskConfig) {\n    this.instructions = config.instructions;\n    this.actions = config.actions || [];\n    this.includeCopilotReadable = config.includeCopilotReadable !== false;\n    this.includeCopilotActions = config.includeCopilotActions !== false;\n    this.forwardedParameters = config.forwardedParameters;\n  }\n\n  /**\n   * Run the task.\n   * @param context The CopilotContext to use for the task. Use `useCopilotContext` to obtain the current context.\n   * @param data The data to use for the task.\n   */\n  async run(context: CopilotContextParams, data?: T): Promise<void> {\n    const actions = this.includeCopilotActions ? Object.assign({}, context.actions) : {};\n\n    // merge functions into entry points\n    for (const fn of this.actions) {\n      actions[fn.name] = fn;\n    }\n\n    let contextString = \"\";\n\n    if (data) {\n      contextString = (typeof data === \"string\" ? data : JSON.stringify(data)) + \"\\n\\n\";\n    }\n\n    if (this.includeCopilotReadable) {\n      contextString += context.getContextString([], defaultCopilotContextCategories);\n    }\n\n    const systemMessage = new TextMessage({\n      content: taskSystemMessage(contextString, this.instructions),\n      role: Role.System,\n    });\n\n    const messages: Message[] = [systemMessage];\n\n    const runtimeClient = new CopilotRuntimeClient({\n      url: context.copilotApiConfig.chatApiEndpoint,\n      publicApiKey: context.copilotApiConfig.publicApiKey,\n      headers: context.copilotApiConfig.headers,\n      credentials: context.copilotApiConfig.credentials,\n    });\n\n    const response = await runtimeClient\n      .generateCopilotResponse({\n        data: {\n          frontend: {\n            actions: processActionsForRuntimeRequest(Object.values(actions)),\n            url: window.location.href,\n          },\n          messages: convertMessagesToGqlInput(filterAgentStateMessages(messages)),\n          metadata: {\n            requestType: CopilotRequestType.Task,\n          },\n          forwardedParameters: {\n            // if forwardedParameters is provided, use it\n            toolChoice: \"required\",\n            ...(this.forwardedParameters ?? {}),\n          },\n        },\n        properties: context.copilotApiConfig.properties,\n      })\n      .toPromise();\n\n    const functionCallHandler = context.getFunctionCallHandler(actions);\n    const functionCalls = convertGqlOutputToMessages(\n      response.data?.generateCopilotResponse?.messages || [],\n    ).filter((m): m is ActionExecutionMessage => m.isActionExecutionMessage());\n\n    for (const functionCall of functionCalls) {\n      await functionCallHandler({\n        messages,\n        name: functionCall.name,\n        args: functionCall.arguments,\n      });\n    }\n  }\n}\n\nfunction taskSystemMessage(contextString: string, instructions: string): string {\n  return `\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.\n\nPlease assist them as best you can.\n\nThis is not a conversation, so please do not ask questions. Just call a function without saying anything else.\n\nThe user has given you the following task to complete:\n\n\\`\\`\\`\n${instructions}\n\\`\\`\\`\n`;\n}\n"],"mappings":";;;;;;;;;;;;AAgDA;AAAA,EAEE;AAAA,EAEA;AAAA,EACA;AAAA,EACA;AAAA,EACA;AAAA,EACA;AAAA,EACA;AAAA,OAEK;AA8BA,IAAM,cAAN,MAA2B;AAAA,EAMhC,YAAY,QAA2B;AACrC,SAAK,eAAe,OAAO;AAC3B,SAAK,UAAU,OAAO,WAAW,CAAC;AAClC,SAAK,yBAAyB,OAAO,2BAA2B;AAChE,SAAK,wBAAwB,OAAO,0BAA0B;AAC9D,SAAK,sBAAsB,OAAO;AAAA,EACpC;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA,EAOM,IAAI,SAA+B,MAAyB;AAAA;AA5GpE;AA6GI,YAAM,UAAU,KAAK,wBAAwB,OAAO,OAAO,CAAC,GAAG,QAAQ,OAAO,IAAI,CAAC;AAGnF,iBAAW,MAAM,KAAK,SAAS;AAC7B,gBAAQ,GAAG,IAAI,IAAI;AAAA,MACrB;AAEA,UAAI,gBAAgB;AAEpB,UAAI,MAAM;AACR,yBAAiB,OAAO,SAAS,WAAW,OAAO,KAAK,UAAU,IAAI,KAAK;AAAA,MAC7E;AAEA,UAAI,KAAK,wBAAwB;AAC/B,yBAAiB,QAAQ,iBAAiB,CAAC,GAAG,+BAA+B;AAAA,MAC/E;AAEA,YAAM,gBAAgB,IAAI,YAAY;AAAA,QACpC,SAAS,kBAAkB,eAAe,KAAK,YAAY;AAAA,QAC3D,MAAM,KAAK;AAAA,MACb,CAAC;AAED,YAAM,WAAsB,CAAC,aAAa;AAE1C,YAAM,gBAAgB,IAAI,qBAAqB;AAAA,QAC7C,KAAK,QAAQ,iBAAiB;AAAA,QAC9B,cAAc,QAAQ,iBAAiB;AAAA,QACvC,SAAS,QAAQ,iBAAiB;AAAA,QAClC,aAAa,QAAQ,iBAAiB;AAAA,MACxC,CAAC;AAED,YAAM,WAAW,MAAM,cACpB,wBAAwB;AAAA,QACvB,MAAM;AAAA,UACJ,UAAU;AAAA,YACR,SAAS,gCAAgC,OAAO,OAAO,OAAO,CAAC;AAAA,YAC/D,KAAK,OAAO,SAAS;AAAA,UACvB;AAAA,UACA,UAAU,0BAA0B,yBAAyB,QAAQ,CAAC;AAAA,UACtE,UAAU;AAAA,YACR,aAAa,mBAAmB;AAAA,UAClC;AAAA,UACA,qBAAqB;AAAA;AAAA,YAEnB,YAAY;AAAA,cACR,UAAK,wBAAL,YAA4B,CAAC;AAAA,QAErC;AAAA,QACA,YAAY,QAAQ,iBAAiB;AAAA,MACvC,CAAC,EACA,UAAU;AAEb,YAAM,sBAAsB,QAAQ,uBAAuB,OAAO;AAClE,YAAM,gBAAgB;AAAA,UACpB,oBAAS,SAAT,mBAAe,4BAAf,mBAAwC,aAAY,CAAC;AAAA,MACvD,EAAE,OAAO,CAAC,MAAmC,EAAE,yBAAyB,CAAC;AAEzE,iBAAW,gBAAgB,eAAe;AACxC,cAAM,oBAAoB;AAAA,UACxB;AAAA,UACA,MAAM,aAAa;AAAA,UACnB,MAAM,aAAa;AAAA,QACrB,CAAC;AAAA,MACH;AAAA,IACF;AAAA;AACF;AAEA,SAAS,kBAAkB,eAAuB,cAA8B;AAC9E,SAAO;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA,EAQP;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA,EAYA;AAAA;AAAA;AAGF;","names":[]}

package/dist/components/copilot-provider/copilotkit.mjs

@@ -4,9 +4,9 @@ import {
   defaultCopilotContextCategories
 } from "../../chunk-4YZA2BZC.mjs";
 import "../../chunk-LHERIF3L.mjs";
-import "../../chunk-HE22TZMF.mjs";
 import "../../chunk-CYDWEPFL.mjs";
 import "../../chunk-2IDV5OHF.mjs";
+import "../../chunk-HE22TZMF.mjs";
 import "../../chunk-ICIK2BSB.mjs";
 import "../../chunk-RKTVJRK7.mjs";
 import "../../chunk-PMAFHQ7P.mjs";

package/dist/components/copilot-provider/index.mjs

@@ -4,9 +4,9 @@ import {
   defaultCopilotContextCategories
 } from "../../chunk-4YZA2BZC.mjs";
 import "../../chunk-LHERIF3L.mjs";
-import "../../chunk-HE22TZMF.mjs";
 import "../../chunk-CYDWEPFL.mjs";
 import "../../chunk-2IDV5OHF.mjs";
+import "../../chunk-HE22TZMF.mjs";
 import "../../chunk-ICIK2BSB.mjs";
 import "../../chunk-RKTVJRK7.mjs";
 import "../../chunk-PMAFHQ7P.mjs";

package/dist/components/index.mjs

@@ -5,9 +5,9 @@ import {
   defaultCopilotContextCategories
 } from "../chunk-4YZA2BZC.mjs";
 import "../chunk-LHERIF3L.mjs";
-import "../chunk-HE22TZMF.mjs";
 import "../chunk-CYDWEPFL.mjs";
 import "../chunk-2IDV5OHF.mjs";
+import "../chunk-HE22TZMF.mjs";
 import "../chunk-ICIK2BSB.mjs";
 import "../chunk-RKTVJRK7.mjs";
 import "../chunk-PMAFHQ7P.mjs";

package/dist/hooks/index.mjs

@@ -1,19 +1,34 @@
 import "../chunk-A6NKSGH3.mjs";
+import {
+  useMakeCopilotDocumentReadable
+} from "../chunk-7IBF6RBW.mjs";
+import {
+  useCopilotRuntimeClient
+} from "../chunk-6ESSSQ7Q.mjs";
 import {
   useDefaultTool
 } from "../chunk-BUSWSDYO.mjs";
 import {
   useLangGraphInterrupt
 } from "../chunk-4RRMC7L2.mjs";
-import {
-  useMakeCopilotDocumentReadable
-} from "../chunk-7IBF6RBW.mjs";
 import {
   useCopilotAdditionalInstructions
 } from "../chunk-ABWT4DRT.mjs";
 import {
   useCopilotAuthenticatedAction_c
 } from "../chunk-E7SE25ZU.mjs";
+import {
+  useCopilotAction
+} from "../chunk-GPEJNVE5.mjs";
+import {
+  useRenderToolCall
+} from "../chunk-NBK4KBLX.mjs";
+import {
+  useFrontendTool
+} from "../chunk-CDUIA2WM.mjs";
+import {
+  useHumanInTheLoop
+} from "../chunk-7DTB7S5V.mjs";
 import {
   useCopilotChatHeadless_c
 } from "../chunk-FQFXYAV7.mjs";
@@ -35,9 +50,6 @@ import {
 import {
   useCopilotReadable
 } from "../chunk-Z6JV2LRY.mjs";
-import {
-  useCopilotRuntimeClient
-} from "../chunk-6ESSSQ7Q.mjs";
 import {
   useCoAgentStateRender
 } from "../chunk-YTQHRJUA.mjs";
@@ -45,18 +57,6 @@ import {
   useCoAgent
 } from "../chunk-ZYTXB6HH.mjs";
 import "../chunk-I76HKHPJ.mjs";
-import {
-  useCopilotAction
-} from "../chunk-GPEJNVE5.mjs";
-import {
-  useRenderToolCall
-} from "../chunk-NBK4KBLX.mjs";
-import {
-  useFrontendTool
-} from "../chunk-CDUIA2WM.mjs";
-import {
-  useHumanInTheLoop
-} from "../chunk-7DTB7S5V.mjs";
 import "../chunk-6PUNP7CD.mjs";
 import "../chunk-O7ARI5CV.mjs";
 import "../chunk-QNUAXSDP.mjs";

package/dist/hooks/use-configure-chat-suggestions.d.ts

@@ -0,0 +1,36 @@
+import { useSuggestions } from '@copilotkitnext/react';
+import { StaticSuggestionsConfig, Suggestion } from '@copilotkitnext/core';
+
+type StaticSuggestionInput = Omit<Suggestion, "isLoading"> & Partial<Pick<Suggestion, "isLoading">>;
+type StaticSuggestionsConfigInput = Omit<StaticSuggestionsConfig, "suggestions"> & {
+    suggestions: StaticSuggestionInput[];
+};
+type DynamicSuggestionsConfigInput = {
+    /**
+     * A prompt or instructions for the GPT to generate suggestions.
+     */
+    instructions: string;
+    /**
+     * The minimum number of suggestions to generate. Defaults to `1`.
+     * @default 1
+     */
+    minSuggestions?: number;
+    /**
+     * The maximum number of suggestions to generate. Defaults to `3`.
+     * @default 1
+     */
+    maxSuggestions?: number;
+    /**
+     * Whether the suggestions are available. Defaults to `enabled`.
+     * @default enabled
+     */
+    available?: "enabled" | "disabled" | "always" | "before-first-message" | "after-first-message";
+    /**
+     * An optional class name to apply to the suggestions.
+     */
+    className?: string;
+};
+type UseCopilotChatSuggestionsConfiguration = DynamicSuggestionsConfigInput | StaticSuggestionsConfigInput;
+declare function useConfigureChatSuggestions(config: UseCopilotChatSuggestionsConfiguration, dependencies?: any[]): ReturnType<typeof useSuggestions>;
+
+export { UseCopilotChatSuggestionsConfiguration, useConfigureChatSuggestions };

package/dist/hooks/use-configure-chat-suggestions.js

@@ -0,0 +1,79 @@
+"use strict";
+var __defProp = Object.defineProperty;
+var __defProps = Object.defineProperties;
+var __getOwnPropDesc = Object.getOwnPropertyDescriptor;
+var __getOwnPropDescs = Object.getOwnPropertyDescriptors;
+var __getOwnPropNames = Object.getOwnPropertyNames;
+var __getOwnPropSymbols = Object.getOwnPropertySymbols;
+var __hasOwnProp = Object.prototype.hasOwnProperty;
+var __propIsEnum = Object.prototype.propertyIsEnumerable;
+var __defNormalProp = (obj, key, value) => key in obj ? __defProp(obj, key, { enumerable: true, configurable: true, writable: true, value }) : obj[key] = value;
+var __spreadValues = (a, b) => {
+  for (var prop in b || (b = {}))
+    if (__hasOwnProp.call(b, prop))
+      __defNormalProp(a, prop, b[prop]);
+  if (__getOwnPropSymbols)
+    for (var prop of __getOwnPropSymbols(b)) {
+      if (__propIsEnum.call(b, prop))
+        __defNormalProp(a, prop, b[prop]);
+    }
+  return a;
+};
+var __spreadProps = (a, b) => __defProps(a, __getOwnPropDescs(b));
+var __export = (target, all) => {
+  for (var name in all)
+    __defProp(target, name, { get: all[name], enumerable: true });
+};
+var __copyProps = (to, from, except, desc) => {
+  if (from && typeof from === "object" || typeof from === "function") {
+    for (let key of __getOwnPropNames(from))
+      if (!__hasOwnProp.call(to, key) && key !== except)
+        __defProp(to, key, { get: () => from[key], enumerable: !(desc = __getOwnPropDesc(from, key)) || desc.enumerable });
+  }
+  return to;
+};
+var __toCommonJS = (mod) => __copyProps(__defProp({}, "__esModule", { value: true }), mod);
+
+// src/hooks/use-configure-chat-suggestions.tsx
+var use_configure_chat_suggestions_exports = {};
+__export(use_configure_chat_suggestions_exports, {
+  useConfigureChatSuggestions: () => useConfigureChatSuggestions
+});
+module.exports = __toCommonJS(use_configure_chat_suggestions_exports);
+var import_react = require("@copilotkitnext/react");
+var import_react2 = require("react");
+function useConfigureChatSuggestions(config, dependencies = []) {
+  var _a;
+  const existingConfig = (0, import_react.useCopilotChatConfiguration)();
+  const resolvedAgentId = (_a = existingConfig == null ? void 0 : existingConfig.agentId) != null ? _a : "default";
+  const { copilotkit } = (0, import_react.useCopilotKit)();
+  const available = config.available === "enabled" ? "always" : config.available;
+  const finalSuggestionConfig = __spreadProps(__spreadValues({}, config), {
+    available,
+    consumerAgentId: resolvedAgentId
+    // Use chatConfig.agentId here
+  });
+  (0, import_react.useConfigureSuggestions)(finalSuggestionConfig, dependencies);
+  const result = (0, import_react.useSuggestions)({ agentId: resolvedAgentId });
+  (0, import_react2.useEffect)(() => {
+    if (finalSuggestionConfig.available === "disabled")
+      return;
+    const subscription = copilotkit.subscribe({
+      onAgentsChanged: () => {
+        const agent = copilotkit.getAgent(resolvedAgentId);
+        if (agent && !agent.isRunning && !result.suggestions.length) {
+          copilotkit.reloadSuggestions(resolvedAgentId);
+        }
+      }
+    });
+    return () => {
+      subscription.unsubscribe();
+    };
+  }, [resolvedAgentId]);
+  return result;
+}
+// Annotate the CommonJS export names for ESM import in node:
+0 && (module.exports = {
+  useConfigureChatSuggestions
+});
+//# sourceMappingURL=use-configure-chat-suggestions.js.map

package/dist/hooks/use-configure-chat-suggestions.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../../src/hooks/use-configure-chat-suggestions.tsx"],"sourcesContent":["import {\n  useConfigureSuggestions,\n  useCopilotChatConfiguration,\n  useCopilotKit,\n  useSuggestions,\n} from \"@copilotkitnext/react\";\nimport { StaticSuggestionsConfig, Suggestion } from \"@copilotkitnext/core\";\nimport { useCopilotContext } from \"../context\";\nimport { useEffect, useMemo } from \"react\";\n\ntype StaticSuggestionInput = Omit<Suggestion, \"isLoading\"> & Partial<Pick<Suggestion, \"isLoading\">>;\n\ntype StaticSuggestionsConfigInput = Omit<StaticSuggestionsConfig, \"suggestions\"> & {\n  suggestions: StaticSuggestionInput[];\n};\n\ntype DynamicSuggestionsConfigInput = {\n  /**\n   * A prompt or instructions for the GPT to generate suggestions.\n   */\n  instructions: string;\n  /**\n   * The minimum number of suggestions to generate. Defaults to `1`.\n   * @default 1\n   */\n  minSuggestions?: number;\n  /**\n   * The maximum number of suggestions to generate. Defaults to `3`.\n   * @default 1\n   */\n  maxSuggestions?: number;\n\n  /**\n   * Whether the suggestions are available. Defaults to `enabled`.\n   * @default enabled\n   */\n  available?: \"enabled\" | \"disabled\" | \"always\" | \"before-first-message\" | \"after-first-message\";\n\n  /**\n   * An optional class name to apply to the suggestions.\n   */\n  className?: string;\n};\n\nexport type UseCopilotChatSuggestionsConfiguration =\n  | DynamicSuggestionsConfigInput\n  | StaticSuggestionsConfigInput;\n\nexport function useConfigureChatSuggestions(\n  config: UseCopilotChatSuggestionsConfiguration,\n  dependencies: any[] = [],\n): ReturnType<typeof useSuggestions> {\n  const existingConfig = useCopilotChatConfiguration();\n  const resolvedAgentId = existingConfig?.agentId ?? \"default\";\n  const { copilotkit } = useCopilotKit();\n\n  const available = config.available === \"enabled\" ? \"always\" : config.available;\n\n  const finalSuggestionConfig = {\n    ...config,\n    available,\n    consumerAgentId: resolvedAgentId, // Use chatConfig.agentId here\n  };\n  useConfigureSuggestions(finalSuggestionConfig, dependencies);\n\n  const result = useSuggestions({ agentId: resolvedAgentId });\n\n  useEffect(() => {\n    if (finalSuggestionConfig.available === \"disabled\") return;\n    const subscription = copilotkit.subscribe({\n      onAgentsChanged: () => {\n        // When agents change, check if our target agent now exists and reload\n        const agent = copilotkit.getAgent(resolvedAgentId);\n        if (agent && !agent.isRunning && !result.suggestions.length) {\n          copilotkit.reloadSuggestions(resolvedAgentId);\n        }\n      },\n    });\n\n    return () => {\n      subscription.unsubscribe();\n    };\n  }, [resolvedAgentId]);\n\n  return result;\n}\n"],"mappings":";;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA,mBAKO;AAGP,IAAAA,gBAAmC;AAwC5B,SAAS,4BACd,QACA,eAAsB,CAAC,GACY;AAnDrC;AAoDE,QAAM,qBAAiB,0CAA4B;AACnD,QAAM,mBAAkB,sDAAgB,YAAhB,YAA2B;AACnD,QAAM,EAAE,WAAW,QAAI,4BAAc;AAErC,QAAM,YAAY,OAAO,cAAc,YAAY,WAAW,OAAO;AAErE,QAAM,wBAAwB,iCACzB,SADyB;AAAA,IAE5B;AAAA,IACA,iBAAiB;AAAA;AAAA,EACnB;AACA,4CAAwB,uBAAuB,YAAY;AAE3D,QAAM,aAAS,6BAAe,EAAE,SAAS,gBAAgB,CAAC;AAE1D,+BAAU,MAAM;AACd,QAAI,sBAAsB,cAAc;AAAY;AACpD,UAAM,eAAe,WAAW,UAAU;AAAA,MACxC,iBAAiB,MAAM;AAErB,cAAM,QAAQ,WAAW,SAAS,eAAe;AACjD,YAAI,SAAS,CAAC,MAAM,aAAa,CAAC,OAAO,YAAY,QAAQ;AAC3D,qBAAW,kBAAkB,eAAe;AAAA,QAC9C;AAAA,MACF;AAAA,IACF,CAAC;AAED,WAAO,MAAM;AACX,mBAAa,YAAY;AAAA,IAC3B;AAAA,EACF,GAAG,CAAC,eAAe,CAAC;AAEpB,SAAO;AACT;","names":["import_react"]}

package/dist/hooks/use-configure-chat-suggestions.mjs

@@ -0,0 +1,47 @@
+import {
+  __spreadProps,
+  __spreadValues
+} from "../chunk-SKC7AJIV.mjs";
+
+// src/hooks/use-configure-chat-suggestions.tsx
+import {
+  useConfigureSuggestions,
+  useCopilotChatConfiguration,
+  useCopilotKit,
+  useSuggestions
+} from "@copilotkitnext/react";
+import { useEffect } from "react";
+function useConfigureChatSuggestions(config, dependencies = []) {
+  var _a;
+  const existingConfig = useCopilotChatConfiguration();
+  const resolvedAgentId = (_a = existingConfig == null ? void 0 : existingConfig.agentId) != null ? _a : "default";
+  const { copilotkit } = useCopilotKit();
+  const available = config.available === "enabled" ? "always" : config.available;
+  const finalSuggestionConfig = __spreadProps(__spreadValues({}, config), {
+    available,
+    consumerAgentId: resolvedAgentId
+    // Use chatConfig.agentId here
+  });
+  useConfigureSuggestions(finalSuggestionConfig, dependencies);
+  const result = useSuggestions({ agentId: resolvedAgentId });
+  useEffect(() => {
+    if (finalSuggestionConfig.available === "disabled")
+      return;
+    const subscription = copilotkit.subscribe({
+      onAgentsChanged: () => {
+        const agent = copilotkit.getAgent(resolvedAgentId);
+        if (agent && !agent.isRunning && !result.suggestions.length) {
+          copilotkit.reloadSuggestions(resolvedAgentId);
+        }
+      }
+    });
+    return () => {
+      subscription.unsubscribe();
+    };
+  }, [resolvedAgentId]);
+  return result;
+}
+export {
+  useConfigureChatSuggestions
+};
+//# sourceMappingURL=use-configure-chat-suggestions.mjs.map

package/dist/hooks/use-configure-chat-suggestions.mjs.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../../src/hooks/use-configure-chat-suggestions.tsx"],"sourcesContent":["import {\n  useConfigureSuggestions,\n  useCopilotChatConfiguration,\n  useCopilotKit,\n  useSuggestions,\n} from \"@copilotkitnext/react\";\nimport { StaticSuggestionsConfig, Suggestion } from \"@copilotkitnext/core\";\nimport { useCopilotContext } from \"../context\";\nimport { useEffect, useMemo } from \"react\";\n\ntype StaticSuggestionInput = Omit<Suggestion, \"isLoading\"> & Partial<Pick<Suggestion, \"isLoading\">>;\n\ntype StaticSuggestionsConfigInput = Omit<StaticSuggestionsConfig, \"suggestions\"> & {\n  suggestions: StaticSuggestionInput[];\n};\n\ntype DynamicSuggestionsConfigInput = {\n  /**\n   * A prompt or instructions for the GPT to generate suggestions.\n   */\n  instructions: string;\n  /**\n   * The minimum number of suggestions to generate. Defaults to `1`.\n   * @default 1\n   */\n  minSuggestions?: number;\n  /**\n   * The maximum number of suggestions to generate. Defaults to `3`.\n   * @default 1\n   */\n  maxSuggestions?: number;\n\n  /**\n   * Whether the suggestions are available. Defaults to `enabled`.\n   * @default enabled\n   */\n  available?: \"enabled\" | \"disabled\" | \"always\" | \"before-first-message\" | \"after-first-message\";\n\n  /**\n   * An optional class name to apply to the suggestions.\n   */\n  className?: string;\n};\n\nexport type UseCopilotChatSuggestionsConfiguration =\n  | DynamicSuggestionsConfigInput\n  | StaticSuggestionsConfigInput;\n\nexport function useConfigureChatSuggestions(\n  config: UseCopilotChatSuggestionsConfiguration,\n  dependencies: any[] = [],\n): ReturnType<typeof useSuggestions> {\n  const existingConfig = useCopilotChatConfiguration();\n  const resolvedAgentId = existingConfig?.agentId ?? \"default\";\n  const { copilotkit } = useCopilotKit();\n\n  const available = config.available === \"enabled\" ? \"always\" : config.available;\n\n  const finalSuggestionConfig = {\n    ...config,\n    available,\n    consumerAgentId: resolvedAgentId, // Use chatConfig.agentId here\n  };\n  useConfigureSuggestions(finalSuggestionConfig, dependencies);\n\n  const result = useSuggestions({ agentId: resolvedAgentId });\n\n  useEffect(() => {\n    if (finalSuggestionConfig.available === \"disabled\") return;\n    const subscription = copilotkit.subscribe({\n      onAgentsChanged: () => {\n        // When agents change, check if our target agent now exists and reload\n        const agent = copilotkit.getAgent(resolvedAgentId);\n        if (agent && !agent.isRunning && !result.suggestions.length) {\n          copilotkit.reloadSuggestions(resolvedAgentId);\n        }\n      },\n    });\n\n    return () => {\n      subscription.unsubscribe();\n    };\n  }, [resolvedAgentId]);\n\n  return result;\n}\n"],"mappings":";;;;;;AAAA;AAAA,EACE;AAAA,EACA;AAAA,EACA;AAAA,EACA;AAAA,OACK;AAGP,SAAS,iBAA0B;AAwC5B,SAAS,4BACd,QACA,eAAsB,CAAC,GACY;AAnDrC;AAoDE,QAAM,iBAAiB,4BAA4B;AACnD,QAAM,mBAAkB,sDAAgB,YAAhB,YAA2B;AACnD,QAAM,EAAE,WAAW,IAAI,cAAc;AAErC,QAAM,YAAY,OAAO,cAAc,YAAY,WAAW,OAAO;AAErE,QAAM,wBAAwB,iCACzB,SADyB;AAAA,IAE5B;AAAA,IACA,iBAAiB;AAAA;AAAA,EACnB;AACA,0BAAwB,uBAAuB,YAAY;AAE3D,QAAM,SAAS,eAAe,EAAE,SAAS,gBAAgB,CAAC;AAE1D,YAAU,MAAM;AACd,QAAI,sBAAsB,cAAc;AAAY;AACpD,UAAM,eAAe,WAAW,UAAU;AAAA,MACxC,iBAAiB,MAAM;AAErB,cAAM,QAAQ,WAAW,SAAS,eAAe;AACjD,YAAI,SAAS,CAAC,MAAM,aAAa,CAAC,OAAO,YAAY,QAAQ;AAC3D,qBAAW,kBAAkB,eAAe;AAAA,QAC9C;AAAA,MACF;AAAA,IACF,CAAC;AAED,WAAO,MAAM;AACX,mBAAa,YAAY;AAAA,IAC3B;AAAA,EACF,GAAG,CAAC,eAAe,CAAC;AAEpB,SAAO;AACT;","names":[]}