@copilotkit/react-core 0.0.0-0.0.0-max-changeset-10101010101010-20260109191632

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":[]}

package/dist/hooks/use-copilot-action.d.ts

@@ -0,0 +1,103 @@
+import { Parameter } from '@copilotkit/shared';
+import { FrontendAction, CatchAllFrontendAction } from '../types/frontend-action.js';
+import '@copilotkit/runtime-client-gql';
+import 'react';
+
+/**
+ * Example usage of useCopilotAction with complex parameters:
+ *
+ * @example
+ * useCopilotAction({
+ *   name: "myAction",
+ *   parameters: [
+ *     { name: "arg1", type: "string", enum: ["option1", "option2", "option3"], required: false },
+ *     { name: "arg2", type: "number" },
+ *     {
+ *       name: "arg3",
+ *       type: "object",
+ *       attributes: [
+ *         { name: "nestedArg1", type: "boolean" },
+ *         { name: "xyz", required: false },
+ *       ],
+ *     },
+ *     { name: "arg4", type: "number[]" },
+ *   ],
+ *   handler: ({ arg1, arg2, arg3, arg4 }) => {
+ *     const x = arg3.nestedArg1;
+ *     const z = arg3.xyz;
+ *     console.log(arg1, arg2, arg3);
+ *   },
+ * });
+ *
+ * @example
+ * // Simple action without parameters
+ * useCopilotAction({
+ *   name: "myAction",
+ *   handler: () => {
+ *     console.log("No parameters provided.");
+ *   },
+ * });
+ *
+ * @example
+ * // Interactive action with UI rendering and response handling
+ * useCopilotAction({
+ *   name: "handleMeeting",
+ *   description: "Handle a meeting by booking or canceling",
+ *   parameters: [
+ *     {
+ *       name: "meeting",
+ *       type: "string",
+ *       description: "The meeting to handle",
+ *       required: true,
+ *     },
+ *     {
+ *       name: "date",
+ *       type: "string",
+ *       description: "The date of the meeting",
+ *       required: true,
+ *     },
+ *     {
+ *       name: "title",
+ *       type: "string",
+ *       description: "The title of the meeting",
+ *       required: true,
+ *     },
+ *   ],
+ *   renderAndWaitForResponse: ({ args, respond, status }) => {
+ *     const { meeting, date, title } = args;
+ *     return (
+ *       <MeetingConfirmationDialog
+ *         meeting={meeting}
+ *         date={date}
+ *         title={title}
+ *         onConfirm={() => respond('meeting confirmed')}
+ *         onCancel={() => respond('meeting canceled')}
+ *       />
+ *     );
+ *   },
+ * });
+ *
+ * @example
+ * // Catch all action allows you to render actions that are not defined in the frontend
+ * useCopilotAction({
+ *   name: "*",
+ *   render: ({ name, args, status, result, handler, respond }) => {
+ *     return <div>Rendering action: {name}</div>;
+ *   },
+ * });
+ */
+
+/**
+ * useCopilotAction is a legacy hook maintained for backwards compatibility.
+ *
+ * To avoid violating React's Rules of Hooks (which prohibit conditional hook calls),
+ * we use a registration pattern:
+ * 1. This hook registers the action configuration with the CopilotContext
+ * 2. A renderer component in CopilotKit actually renders the appropriate hook wrapper
+ * 3. React properly manages hook state since components are rendered, not conditionally called
+ *
+ * This allows action types to change between renders without corrupting React's hook state.
+ */
+declare function useCopilotAction<const T extends Parameter[] | [] = []>(action: FrontendAction<T> | CatchAllFrontendAction, dependencies?: any[]): void;
+
+export { useCopilotAction };

package/dist/hooks/use-copilot-action.js

@@ -0,0 +1,295 @@
+"use strict";
+var __create = Object.create;
+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 __getProtoOf = Object.getPrototypeOf;
+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 __objRest = (source, exclude) => {
+  var target = {};
+  for (var prop in source)
+    if (__hasOwnProp.call(source, prop) && exclude.indexOf(prop) < 0)
+      target[prop] = source[prop];
+  if (source != null && __getOwnPropSymbols)
+    for (var prop of __getOwnPropSymbols(source)) {
+      if (exclude.indexOf(prop) < 0 && __propIsEnum.call(source, prop))
+        target[prop] = source[prop];
+    }
+  return target;
+};
+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 __toESM = (mod, isNodeMode, target) => (target = mod != null ? __create(__getProtoOf(mod)) : {}, __copyProps(
+  // If the importer is in node compatibility mode or this is not an ESM
+  // file that has been converted to a CommonJS file using a Babel-
+  // compatible transform (i.e. "__esModule" has not been set), then set
+  // "default" to the CommonJS "module.exports" for node compatibility.
+  isNodeMode || !mod || !mod.__esModule ? __defProp(target, "default", { value: mod, enumerable: true }) : target,
+  mod
+));
+var __toCommonJS = (mod) => __copyProps(__defProp({}, "__esModule", { value: true }), mod);
+
+// src/hooks/use-copilot-action.ts
+var use_copilot_action_exports = {};
+__export(use_copilot_action_exports, {
+  useCopilotAction: () => useCopilotAction
+});
+module.exports = __toCommonJS(use_copilot_action_exports);
+var import_react7 = require("react");
+
+// src/hooks/use-frontend-tool.ts
+var import_react = __toESM(require("react"));
+var import_shared = require("@copilotkit/shared");
+var import_shared2 = require("@copilotkit/shared");
+var import_react2 = require("@copilotkitnext/react");
+function useFrontendTool(tool, dependencies) {
+  const { name, description, parameters, render, followUp } = tool;
+  const zodParameters = (0, import_shared.getZodParameters)(parameters);
+  const normalizedRender = (() => {
+    if (typeof render === "undefined") {
+      return void 0;
+    }
+    if (typeof render === "string") {
+      const staticRender = render;
+      return () => import_react.default.createElement(
+        import_react.default.Fragment,
+        null,
+        staticRender
+      );
+    }
+    return (args) => {
+      const renderArgs = __spreadProps(__spreadValues({}, args), {
+        result: typeof args.result === "string" ? (0, import_shared2.parseJson)(args.result, args.result) : args.result
+      });
+      const rendered = render(renderArgs);
+      if (typeof rendered === "string") {
+        return import_react.default.createElement(import_react.default.Fragment, null, rendered);
+      }
+      return rendered != null ? rendered : null;
+    };
+  })();
+  const handlerRef = (0, import_react.useRef)(tool.handler);
+  (0, import_react.useEffect)(() => {
+    handlerRef.current = tool.handler;
+  }, [tool.handler, ...dependencies != null ? dependencies : []]);
+  const normalizedHandler = tool.handler ? (args) => {
+    var _a;
+    return (_a = handlerRef.current) == null ? void 0 : _a.call(handlerRef, args);
+  } : void 0;
+  (0, import_react2.useFrontendTool)({
+    name,
+    description,
+    parameters: zodParameters,
+    handler: normalizedHandler,
+    followUp,
+    render: normalizedRender
+  });
+}
+
+// src/hooks/use-render-tool-call.ts
+var import_shared3 = require("@copilotkit/shared");
+var import_react3 = require("react");
+var import_react4 = require("@copilotkitnext/react");
+var import_shared4 = require("@copilotkit/shared");
+function useRenderToolCall(tool, dependencies) {
+  const { copilotkit } = (0, import_react4.useCopilotKit)();
+  const hasAddedRef = (0, import_react3.useRef)(false);
+  (0, import_react3.useEffect)(() => {
+    const { name, parameters, render } = tool;
+    const zodParameters = (0, import_shared3.getZodParameters)(parameters);
+    const renderToolCall = name === "*" ? (0, import_react4.defineToolCallRenderer)({
+      name: "*",
+      render: (args) => {
+        return render(__spreadProps(__spreadValues({}, args), {
+          result: args.result ? (0, import_shared4.parseJson)(args.result, args.result) : args.result
+        }));
+      }
+    }) : (0, import_react4.defineToolCallRenderer)({
+      name,
+      args: zodParameters,
+      render: (args) => {
+        return render(__spreadProps(__spreadValues({}, args), {
+          result: args.result ? (0, import_shared4.parseJson)(args.result, args.result) : args.result
+        }));
+      }
+    });
+    const existingIndex = copilotkit.renderToolCalls.findIndex((r) => r.name === name);
+    if (existingIndex !== -1) {
+      copilotkit.renderToolCalls.splice(existingIndex, 1);
+    }
+    copilotkit.renderToolCalls.push(renderToolCall);
+    hasAddedRef.current = true;
+    return () => {
+      if (hasAddedRef.current) {
+        const index = copilotkit.renderToolCalls.findIndex((r) => r.name === name);
+        if (index !== -1) {
+          copilotkit.renderToolCalls.splice(index, 1);
+        }
+        hasAddedRef.current = false;
+      }
+    };
+  }, [tool, ...dependencies != null ? dependencies : []]);
+}
+
+// src/hooks/use-human-in-the-loop.ts
+var import_shared5 = require("@copilotkit/shared");
+var import_react5 = require("@copilotkitnext/react");
+var import_core = require("@copilotkitnext/core");
+var import_react6 = __toESM(require("react"));
+function useHumanInTheLoop(tool, dependencies) {
+  const _a = tool, { render } = _a, toolRest = __objRest(_a, ["render"]);
+  const { name, description, parameters, followUp } = toolRest;
+  const zodParameters = (0, import_shared5.getZodParameters)(parameters);
+  const renderRef = (0, import_react6.useRef)(null);
+  (0, import_react6.useEffect)(() => {
+    renderRef.current = (args) => {
+      if (typeof render === "string") {
+        return import_react6.default.createElement(import_react6.default.Fragment, null, render);
+      }
+      if (!render) {
+        return null;
+      }
+      const renderProps = (() => {
+        const mappedArgs = args.args;
+        switch (args.status) {
+          case import_core.ToolCallStatus.InProgress:
+            return {
+              args: mappedArgs,
+              respond: args.respond,
+              status: args.status,
+              handler: void 0
+            };
+          case import_core.ToolCallStatus.Executing:
+            return {
+              args: mappedArgs,
+              respond: args.respond,
+              status: args.status,
+              handler: () => {
+              }
+            };
+          case import_core.ToolCallStatus.Complete:
+            return {
+              args: mappedArgs,
+              respond: args.respond,
+              status: args.status,
+              result: args.result ? (0, import_shared5.parseJson)(args.result, args.result) : args.result,
+              handler: void 0
+            };
+          default:
+            throw new import_shared5.CopilotKitError({
+              code: import_shared5.CopilotKitErrorCode.UNKNOWN,
+              message: `Invalid tool call status: ${args.status}`
+            });
+        }
+      })();
+      const rendered = render(renderProps);
+      if (typeof rendered === "string") {
+        return import_react6.default.createElement(import_react6.default.Fragment, null, rendered);
+      }
+      return rendered != null ? rendered : null;
+    };
+  }, [render, ...dependencies != null ? dependencies : []]);
+  (0, import_react5.useHumanInTheLoop)({
+    name,
+    description,
+    followUp,
+    parameters: zodParameters,
+    render: (args) => {
+      var _a2, _b;
+      return (_b = (_a2 = renderRef.current) == null ? void 0 : _a2.call(renderRef, args)) != null ? _b : null;
+    }
+  });
+}
+
+// src/hooks/use-copilot-action.ts
+function getActionConfig(action) {
+  if (action.name === "*") {
+    return {
+      type: "render",
+      action
+    };
+  }
+  if ("renderAndWaitForResponse" in action || "renderAndWait" in action) {
+    let render = action.render;
+    if (!render && "renderAndWaitForResponse" in action) {
+      render = action.renderAndWaitForResponse;
+    }
+    if (!render && "renderAndWait" in action) {
+      render = action.renderAndWait;
+    }
+    return {
+      type: "hitl",
+      action: __spreadProps(__spreadValues({}, action), { render })
+    };
+  }
+  if ("available" in action) {
+    if (action.available === "enabled" || action.available === "remote") {
+      return {
+        type: "frontend",
+        action
+      };
+    }
+    if (action.available === "frontend" || action.available === "disabled") {
+      return {
+        type: "render",
+        action
+      };
+    }
+  }
+  if ("handler" in action) {
+    return {
+      type: "frontend",
+      action
+    };
+  }
+  throw new Error("Invalid action configuration");
+}
+function useCopilotAction(action, dependencies) {
+  const [initialActionConfig] = (0, import_react7.useState)(getActionConfig(action));
+  const currentActionConfig = getActionConfig(action);
+  if (initialActionConfig.type !== currentActionConfig.type) {
+    throw new Error("Action configuration changed between renders");
+  }
+  switch (currentActionConfig.type) {
+    case "render":
+      return useRenderToolCall(currentActionConfig.action, dependencies);
+    case "hitl":
+      return useHumanInTheLoop(currentActionConfig.action, dependencies);
+    case "frontend":
+      return useFrontendTool(currentActionConfig.action, dependencies);
+    default:
+      throw new Error("Invalid action configuration");
+  }
+}
+// Annotate the CommonJS export names for ESM import in node:
+0 && (module.exports = {
+  useCopilotAction
+});
+//# sourceMappingURL=use-copilot-action.js.map

package/dist/hooks/use-copilot-action.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../../src/hooks/use-copilot-action.ts","../../src/hooks/use-frontend-tool.ts","../../src/hooks/use-render-tool-call.ts","../../src/hooks/use-human-in-the-loop.ts"],"sourcesContent":["/**\n * Example usage of useCopilotAction with complex parameters:\n *\n * @example\n * useCopilotAction({\n *   name: \"myAction\",\n *   parameters: [\n *     { name: \"arg1\", type: \"string\", enum: [\"option1\", \"option2\", \"option3\"], required: false },\n *     { name: \"arg2\", type: \"number\" },\n *     {\n *       name: \"arg3\",\n *       type: \"object\",\n *       attributes: [\n *         { name: \"nestedArg1\", type: \"boolean\" },\n *         { name: \"xyz\", required: false },\n *       ],\n *     },\n *     { name: \"arg4\", type: \"number[]\" },\n *   ],\n *   handler: ({ arg1, arg2, arg3, arg4 }) => {\n *     const x = arg3.nestedArg1;\n *     const z = arg3.xyz;\n *     console.log(arg1, arg2, arg3);\n *   },\n * });\n *\n * @example\n * // Simple action without parameters\n * useCopilotAction({\n *   name: \"myAction\",\n *   handler: () => {\n *     console.log(\"No parameters provided.\");\n *   },\n * });\n *\n * @example\n * // Interactive action with UI rendering and response handling\n * useCopilotAction({\n *   name: \"handleMeeting\",\n *   description: \"Handle a meeting by booking or canceling\",\n *   parameters: [\n *     {\n *       name: \"meeting\",\n *       type: \"string\",\n *       description: \"The meeting to handle\",\n *       required: true,\n *     },\n *     {\n *       name: \"date\",\n *       type: \"string\",\n *       description: \"The date of the meeting\",\n *       required: true,\n *     },\n *     {\n *       name: \"title\",\n *       type: \"string\",\n *       description: \"The title of the meeting\",\n *       required: true,\n *     },\n *   ],\n *   renderAndWaitForResponse: ({ args, respond, status }) => {\n *     const { meeting, date, title } = args;\n *     return (\n *       <MeetingConfirmationDialog\n *         meeting={meeting}\n *         date={date}\n *         title={title}\n *         onConfirm={() => respond('meeting confirmed')}\n *         onCancel={() => respond('meeting canceled')}\n *       />\n *     );\n *   },\n * });\n *\n * @example\n * // Catch all action allows you to render actions that are not defined in the frontend\n * useCopilotAction({\n *   name: \"*\",\n *   render: ({ name, args, status, result, handler, respond }) => {\n *     return <div>Rendering action: {name}</div>;\n *   },\n * });\n */\n\n/**\n * <img src=\"https://cdn.copilotkit.ai/docs/copilotkit/images/use-copilot-action/useCopilotAction.gif\" width=\"500\" />\n * `useCopilotAction` is a React hook that you can use in your application to provide\n * custom actions that can be called by the AI. Essentially, it allows the Copilot to\n * execute these actions contextually during a chat, based on the user's interactions\n * and needs.\n *\n * Here's how it works:\n *\n * Use `useCopilotAction` to set up actions that the Copilot can call. To provide\n * more context to the Copilot, you can provide it with a `description` (for example to explain\n * what the action does, under which conditions it can be called, etc.).\n *\n * Then you define the parameters of the action, which can be simple, e.g. primitives like strings or numbers,\n * or complex, e.g. objects or arrays.\n *\n * Finally, you provide a `handler` function that receives the parameters and returns a result.\n * CopilotKit takes care of automatically inferring the parameter types, so you get type safety\n * and autocompletion for free.\n *\n * To render a custom UI for the action, you can provide a `render()` function. This function\n * lets you render a custom component or return a string to display.\n *\n * ## Usage\n *\n * ### Simple Usage\n *\n * ```tsx\n * useCopilotAction({\n *   name: \"sayHello\",\n *   description: \"Say hello to someone.\",\n *   parameters: [\n *     {\n *       name: \"name\",\n *       type: \"string\",\n *       description: \"name of the person to say greet\",\n *     },\n *   ],\n *   handler: async ({ name }) => {\n *     alert(`Hello, ${name}!`);\n *   },\n * });\n * ```\n *\n * ## Generative UI\n *\n * This hooks enables you to dynamically generate UI elements and render them in the copilot chat. For more information, check out the [Generative UI](/guides/generative-ui) page.\n */\nimport { useEffect, useRef, useState } from \"react\";\nimport { Parameter } from \"@copilotkit/shared\";\nimport { CatchAllFrontendAction, FrontendAction } from \"../types/frontend-action\";\nimport { useFrontendTool, UseFrontendToolArgs } from \"./use-frontend-tool\";\nimport { useRenderToolCall, UseRenderToolCallArgs } from \"./use-render-tool-call\";\nimport { useHumanInTheLoop, UseHumanInTheLoopArgs } from \"./use-human-in-the-loop\";\nimport { useCopilotContext } from \"../context\";\n\n// Helper to determine which component and action config to use\nfunction getActionConfig<const T extends Parameter[] | [] = []>(\n  action: FrontendAction<T> | CatchAllFrontendAction,\n) {\n  if (action.name === \"*\") {\n    return {\n      type: \"render\" as const,\n      action: action as UseRenderToolCallArgs<T>,\n    };\n  }\n\n  if (\"renderAndWaitForResponse\" in action || \"renderAndWait\" in action) {\n    let render = action.render;\n    if (!render && \"renderAndWaitForResponse\" in action) {\n      // @ts-expect-error -- renderAndWaitForResponse is deprecated, but we need to support it for backwards compatibility\n      render = action.renderAndWaitForResponse;\n    }\n    if (!render && \"renderAndWait\" in action) {\n      // @ts-expect-error -- renderAndWait is deprecated, but we need to support it for backwards compatibility\n      render = action.renderAndWait;\n    }\n\n    return {\n      type: \"hitl\" as const,\n      action: { ...action, render } as UseHumanInTheLoopArgs<T>,\n    };\n  }\n\n  if (\"available\" in action) {\n    if (action.available === \"enabled\" || action.available === \"remote\") {\n      return {\n        type: \"frontend\" as const,\n        action: action as UseFrontendToolArgs<T>,\n      };\n    }\n    if (action.available === \"frontend\" || action.available === \"disabled\") {\n      return {\n        type: \"render\" as const,\n        action: action as UseRenderToolCallArgs<T>,\n      };\n    }\n  }\n\n  if (\"handler\" in action) {\n    return {\n      type: \"frontend\" as const,\n      action: action as UseFrontendToolArgs<T>,\n    };\n  }\n\n  throw new Error(\"Invalid action configuration\");\n}\n\n/**\n * useCopilotAction is a legacy hook maintained for backwards compatibility.\n *\n * To avoid violating React's Rules of Hooks (which prohibit conditional hook calls),\n * we use a registration pattern:\n * 1. This hook registers the action configuration with the CopilotContext\n * 2. A renderer component in CopilotKit actually renders the appropriate hook wrapper\n * 3. React properly manages hook state since components are rendered, not conditionally called\n *\n * This allows action types to change between renders without corrupting React's hook state.\n */\nexport function useCopilotAction<const T extends Parameter[] | [] = []>(\n  action: FrontendAction<T> | CatchAllFrontendAction,\n  dependencies?: any[],\n): void {\n  const [initialActionConfig] = useState(getActionConfig(action));\n  const currentActionConfig = getActionConfig(action);\n\n  /**\n   * Calling hooks conditionally violates React's Rules of Hooks. This rule exists because\n   * React maintains the call stack for hooks like useEffect or useState, and conditionally\n   * calling a hook would result in inconsistent call stacks between renders.\n   *\n   * Unfortunately, useCopilotAction _has_ to conditionally call a hook based on the\n   * supplied parameters. In order to avoid breaking React's call stack tracking, while\n   * breaking the Rule of Hooks, we use a ref to store the initial action configuration\n   * and throw an error if the _configuration_ changes such that we would call a different hook.\n   */\n  if (initialActionConfig.type !== currentActionConfig.type) {\n    throw new Error(\"Action configuration changed between renders\");\n  }\n\n  switch (currentActionConfig.type) {\n    case \"render\":\n      return useRenderToolCall(currentActionConfig.action, dependencies);\n    case \"hitl\":\n      return useHumanInTheLoop(currentActionConfig.action, dependencies);\n    case \"frontend\":\n      return useFrontendTool(currentActionConfig.action, dependencies);\n    default:\n      throw new Error(\"Invalid action configuration\");\n  }\n}\n","import React, { useEffect, useRef } from \"react\";\nimport { ActionRenderProps, FrontendAction } from \"../types/frontend-action\";\nimport { Parameter, getZodParameters, MappedParameterTypes } from \"@copilotkit/shared\";\nimport { parseJson } from \"@copilotkit/shared\";\nimport { ToolCallStatus } from \"@copilotkitnext/core\";\nimport {\n  type ReactFrontendTool,\n  useFrontendTool as useFrontendToolVNext,\n} from \"@copilotkitnext/react\";\n\ntype FrontendToolOptions<T extends Parameter[] | []> = ReactFrontendTool<MappedParameterTypes<T>>;\ntype FrontendToolRenderArgs<T extends Parameter[] | []> =\n  | {\n      name: string;\n      args: Partial<MappedParameterTypes<T>>;\n      status: ToolCallStatus.InProgress;\n      result: undefined;\n    }\n  | {\n      name: string;\n      args: MappedParameterTypes<T>;\n      status: ToolCallStatus.Executing;\n      result: undefined;\n    }\n  | {\n      name: string;\n      args: MappedParameterTypes<T>;\n      status: ToolCallStatus.Complete;\n      result: string;\n    };\n\nexport type UseFrontendToolArgs<T extends Parameter[] | [] = []> = {\n  available?: \"disabled\" | \"enabled\";\n} & Pick<\n  FrontendAction<T>,\n  \"name\" | \"description\" | \"parameters\" | \"handler\" | \"followUp\" | \"render\"\n>;\n\nexport function useFrontendTool<const T extends Parameter[] = []>(\n  tool: UseFrontendToolArgs<T>,\n  dependencies?: any[],\n) {\n  const { name, description, parameters, render, followUp } = tool;\n  const zodParameters = getZodParameters(parameters);\n\n  const normalizedRender: FrontendToolOptions<T>[\"render\"] | undefined = (() => {\n    if (typeof render === \"undefined\") {\n      return undefined;\n    }\n\n    if (typeof render === \"string\") {\n      const staticRender = render;\n      return (() =>\n        React.createElement(\n          React.Fragment,\n          null,\n          staticRender,\n        )) as FrontendToolOptions<T>[\"render\"];\n    }\n\n    return ((args: FrontendToolRenderArgs<T>) => {\n      const renderArgs = {\n        ...args,\n        result: typeof args.result === \"string\" ? parseJson(args.result, args.result) : args.result,\n      } as ActionRenderProps<T>;\n\n      const rendered = render(renderArgs);\n\n      if (typeof rendered === \"string\") {\n        return React.createElement(React.Fragment, null, rendered);\n      }\n\n      return rendered ?? null;\n    }) as FrontendToolOptions<T>[\"render\"];\n  })();\n\n  // Handler ref to avoid stale closures\n  const handlerRef = useRef<typeof tool.handler>(tool.handler);\n\n  useEffect(() => {\n    handlerRef.current = tool.handler;\n  }, [tool.handler, ...(dependencies ?? [])]);\n\n  const normalizedHandler = tool.handler\n    ? (args: MappedParameterTypes<T>) => handlerRef.current?.(args)\n    : undefined;\n\n  useFrontendToolVNext<MappedParameterTypes<T>>({\n    name,\n    description,\n    parameters: zodParameters,\n    handler: normalizedHandler,\n    followUp,\n    render: normalizedRender,\n  });\n}\n","import {\n  ActionRenderProps,\n  ActionRenderPropsNoArgs,\n  ActionRenderPropsWait,\n  FrontendAction,\n} from \"../types\";\nimport { Parameter, getZodParameters } from \"@copilotkit/shared\";\nimport React, { useEffect, useRef } from \"react\";\nimport { defineToolCallRenderer, useCopilotKit } from \"@copilotkitnext/react\";\nimport { parseJson } from \"@copilotkit/shared\";\n\ntype ToolCallRendererDefinition = Parameters<typeof defineToolCallRenderer>[0];\n\nexport type UseRenderToolCallArgs<T extends Parameter[] | [] = []> = Pick<\n  FrontendAction<T>,\n  \"name\" | \"description\" | \"parameters\"\n> & {\n  available?: \"disabled\" | \"enabled\";\n  render: T extends []\n    ? (props: ActionRenderPropsNoArgs<T>) => React.ReactElement\n    : (props: ActionRenderProps<T>) => React.ReactElement;\n};\n\nexport function useRenderToolCall<const T extends Parameter[] | [] = []>(\n  tool: UseRenderToolCallArgs<T>,\n  dependencies?: any[],\n) {\n  const { copilotkit } = useCopilotKit();\n\n  // Track whether we've already added this renderer to avoid duplicates\n  const hasAddedRef = useRef(false);\n\n  useEffect(() => {\n    const { name, parameters, render } = tool;\n    const zodParameters = getZodParameters(parameters);\n\n    const renderToolCall =\n      name === \"*\"\n        ? defineToolCallRenderer({\n            name: \"*\",\n            render: ((args) => {\n              return render({\n                ...args,\n                result: args.result ? parseJson(args.result, args.result) : args.result,\n              });\n            }) as ToolCallRendererDefinition[\"render\"],\n          })\n        : defineToolCallRenderer({\n            name,\n            args: zodParameters,\n            render: ((args) => {\n              return render({\n                ...args,\n                result: args.result ? parseJson(args.result, args.result) : args.result,\n              });\n            }) as ToolCallRendererDefinition[\"render\"],\n          });\n\n    // Remove any existing renderer with the same name\n    const existingIndex = copilotkit.renderToolCalls.findIndex((r) => r.name === name);\n    if (existingIndex !== -1) {\n      copilotkit.renderToolCalls.splice(existingIndex, 1);\n    }\n\n    // Add the new renderer\n    copilotkit.renderToolCalls.push(renderToolCall);\n    hasAddedRef.current = true;\n\n    // Cleanup: remove this renderer when the component unmounts or tool changes\n    return () => {\n      if (hasAddedRef.current) {\n        const index = copilotkit.renderToolCalls.findIndex((r) => r.name === name);\n        if (index !== -1) {\n          copilotkit.renderToolCalls.splice(index, 1);\n        }\n        hasAddedRef.current = false;\n      }\n    };\n  }, [tool, ...(dependencies ?? [])]);\n}\n","import { ActionRenderProps, ActionRenderPropsWait, FrontendAction } from \"../types\";\nimport {\n  CopilotKitError,\n  CopilotKitErrorCode,\n  MappedParameterTypes,\n  Parameter,\n  getZodParameters,\n  parseJson,\n} from \"@copilotkit/shared\";\nimport { useHumanInTheLoop as useHumanInTheLoopVNext } from \"@copilotkitnext/react\";\nimport { ToolCallStatus } from \"@copilotkitnext/core\";\nimport React, { ComponentType, FunctionComponent, useEffect, useRef } from \"react\";\n\ntype HumanInTheLoopOptions = Parameters<typeof useHumanInTheLoopVNext>[0];\ntype HumanInTheLoopRender = HumanInTheLoopOptions[\"render\"];\ntype HumanInTheLoopRenderArgs = HumanInTheLoopRender extends (props: infer P) => any ? P : never;\n\nexport type UseHumanInTheLoopArgs<T extends Parameter[] | [] = []> = {\n  available?: \"disabled\" | \"enabled\";\n  render: FrontendAction<T>[\"renderAndWaitForResponse\"];\n  followUp?: FrontendAction<T>[\"followUp\"];\n} & Pick<FrontendAction<T>, \"name\" | \"description\" | \"parameters\">;\n\ntype HitlRendererArgs =\n  | {\n      name: string;\n      description: string;\n      args: Partial<Record<string, unknown>>;\n      status: ToolCallStatus.InProgress;\n      result: undefined;\n      respond: undefined;\n    }\n  | {\n      name: string;\n      description: string;\n      args: Record<string, unknown>;\n      status: ToolCallStatus.Executing;\n      result: undefined;\n      respond: (result: unknown) => Promise<void>;\n    }\n  | {\n      name: string;\n      description: string;\n      args: Record<string, unknown>;\n      status: ToolCallStatus.Complete;\n      result: string;\n      respond: undefined;\n    };\ntype HitlRenderer = FunctionComponent<HitlRendererArgs>;\n\nexport function useHumanInTheLoop<const T extends Parameter[] | [] = []>(\n  tool: UseHumanInTheLoopArgs<T>,\n  dependencies?: any[],\n) {\n  const { render, ...toolRest } = tool;\n  const { name, description, parameters, followUp } = toolRest;\n  const zodParameters = getZodParameters(parameters);\n  const renderRef = useRef<HitlRenderer | null>(null);\n\n  useEffect(() => {\n    renderRef.current = (args: HitlRendererArgs): React.ReactElement | null => {\n      if (typeof render === \"string\") {\n        return React.createElement(React.Fragment, null, render);\n      }\n\n      if (!render) {\n        return null;\n      }\n\n      const renderProps: ActionRenderPropsWait<T> = (() => {\n        const mappedArgs = args.args as unknown as MappedParameterTypes<T>;\n\n        switch (args.status) {\n          case ToolCallStatus.InProgress:\n            return {\n              args: mappedArgs,\n              respond: args.respond,\n              status: args.status,\n              handler: undefined,\n            };\n          case ToolCallStatus.Executing:\n            return {\n              args: mappedArgs,\n              respond: args.respond,\n              status: args.status,\n              handler: () => {},\n            };\n          case ToolCallStatus.Complete:\n            return {\n              args: mappedArgs,\n              respond: args.respond,\n              status: args.status,\n              result: args.result ? parseJson(args.result, args.result) : args.result,\n              handler: undefined,\n            };\n          default:\n            throw new CopilotKitError({\n              code: CopilotKitErrorCode.UNKNOWN,\n              message: `Invalid tool call status: ${(args as unknown as { status: string }).status}`,\n            });\n        }\n      })();\n\n      const rendered = render(renderProps);\n\n      if (typeof rendered === \"string\") {\n        return React.createElement(React.Fragment, null, rendered);\n      }\n\n      return rendered ?? null;\n    };\n  }, [render, ...(dependencies ?? [])]);\n\n  useHumanInTheLoopVNext({\n    name,\n    description,\n    followUp,\n    parameters: zodParameters,\n    render: ((args: HumanInTheLoopRenderArgs) =>\n      renderRef.current?.(args as HitlRendererArgs) ?? null) as HumanInTheLoopOptions[\"render\"],\n  });\n}\n"],"mappings":"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","names":["import_react","import_shared","import_react","React","useFrontendToolVNext","import_shared","import_react","import_shared","import_react","React","useHumanInTheLoopVNext","_a"]}

package/dist/hooks/use-copilot-action.mjs

@@ -0,0 +1,11 @@
+import {
+  useCopilotAction
+} from "../chunk-GPEJNVE5.mjs";
+import "../chunk-NBK4KBLX.mjs";
+import "../chunk-CDUIA2WM.mjs";
+import "../chunk-7DTB7S5V.mjs";
+import "../chunk-SKC7AJIV.mjs";
+export {
+  useCopilotAction
+};
+//# sourceMappingURL=use-copilot-action.mjs.map

package/dist/hooks/use-copilot-action.mjs.map

@@ -0,0 +1 @@
+{"version":3,"sources":[],"sourcesContent":[],"mappings":"","names":[]}

package/dist/hooks/use-copilot-additional-instructions.d.ts

@@ -0,0 +1,26 @@
+/**
+ * Options for the useCopilotAdditionalInstructions hook.
+ */
+interface UseCopilotAdditionalInstructionsOptions {
+    /**
+     * The instructions to be added to the Copilot. Will be added to the instructions like so:
+     *
+     * ```txt
+     * You are a helpful assistant.
+     * Additionally, follow these instructions:
+     * - Do not answer questions about the weather.
+     * - Do not answer questions about the stock market.
+     * ```
+     */
+    instructions: string;
+    /**
+     * Whether the instructions are available to the Copilot.
+     */
+    available?: "enabled" | "disabled";
+}
+/**
+ * Adds the given instructions to the Copilot context.
+ */
+declare function useCopilotAdditionalInstructions({ instructions, available }: UseCopilotAdditionalInstructionsOptions, dependencies?: any[]): void;
+
+export { UseCopilotAdditionalInstructionsOptions, useCopilotAdditionalInstructions };