@copilotkit/react-core 1.73.0 → 1.73.2-canary.1790068297

package/dist/v2/headless.d.cts

@@ -544,6 +544,58 @@ declare function useAgent({
 //#region src/v2/hooks/use-frontend-tool.d.ts
 declare function useFrontendTool<T extends Record<string, unknown> = Record<string, unknown>>(tool: ReactFrontendTool<T>, deps?: ReadonlyArray<unknown>): void;
 //#endregion
+//#region src/v2/hooks/use-frontend-tools.d.ts
+/**
+ * Register a list of frontend tools whose length can change between renders.
+ *
+ * `useFrontendTool` registers exactly one tool per call, so it cannot be called
+ * in a loop over a runtime-length list without breaking the rules of hooks.
+ * This hook runs a single effect over the whole array instead, which makes it
+ * safe to build the list from state, props, or a server response.
+ *
+ * Tools are keyed by `name` plus `agentId`, the same as `useFrontendTool`. A
+ * tool that disappears from the array is unregistered on the next render, and
+ * every tool is unregistered on unmount. Renderers stay registered after
+ * unmount so past tool calls still render in the chat history.
+ *
+ * @param tools - The tools to register. May be empty and may change length.
+ * @param deps - Extra dependencies that force re-registration, compared by
+ * identity like the second argument of `useEffect`. Use this when a handler
+ * closes over a value that is not part of the tool definition. Keep the array
+ * a constant length across renders.
+ *
+ * @example
+ * Register one tool per item in application state:
+ * ```tsx
+ * const [reports, setReports] = useState<Report[]>([]);
+ *
+ * useFrontendTools(
+ *   reports.map((report) => ({
+ *     name: `open_${report.id}`,
+ *     description: `Open the ${report.title} report`,
+ *     handler: async () => navigate(`/reports/${report.id}`),
+ *   })),
+ *   [navigate],
+ * );
+ * ```
+ *
+ * @example
+ * Register tools described by the backend:
+ * ```tsx
+ * const { data } = useQuery(fetchToolDescriptors);
+ *
+ * useFrontendTools(
+ *   (data ?? []).map((descriptor) => ({
+ *     name: descriptor.name,
+ *     description: descriptor.description,
+ *     parameters: z.object({ query: z.string() }),
+ *     handler: async ({ query }) => runDescriptor(descriptor.id, query),
+ *   })),
+ * );
+ * ```
+ */
+declare function useFrontendTools(tools: ReadonlyArray<ReactFrontendTool<any>> | undefined, deps?: ReadonlyArray<unknown>): void;
+//#endregion
 //#region src/v2/hooks/use-component.d.ts
 type InferRenderProps<T> = T extends StandardSchemaV1 ? InferSchemaOutput<T> : any;
 /**
@@ -1028,5 +1080,5 @@ declare function useRenderToolCall(): ({
  */
 declare function useCapabilities(agentId?: string): AgentCapabilities | undefined;
 //#endregion
-export { type AgentContextInput, CopilotChatConfigurationProvider, type CopilotChatConfigurationProviderProps, type CopilotChatConfigurationValue, CopilotChatDefaultLabels, type CopilotChatLabels, CopilotKitCoreReact, type CopilotKitCoreReactConfig, type Interrupt, type InterruptEvent, type InterruptHandlerProps, type InterruptRenderProps, type JsonSerializable, type ReactFrontendTool, type ReactHumanInTheLoop, type ReactToolCallRenderer, type RenderToolCompleteProps, type RenderToolExecutingProps, type RenderToolInProgressProps, type RenderToolProps, type ResumeEntry, type ResumeStatus, type Thread, UseAgentUpdate, type UseInterruptConfig, type UseThreadsInput, type UseThreadsResult, defineToolCallRenderer, useAgent, useAgentContext, useCapabilities, useComponent, useConfigureSuggestions, useCopilotChatConfiguration, useCopilotKit, useFrontendTool, useHumanInTheLoop, useInterrupt, useRenderTool, useRenderToolCall, useSuggestions, useThreads };
+export { type AgentContextInput, CopilotChatConfigurationProvider, type CopilotChatConfigurationProviderProps, type CopilotChatConfigurationValue, CopilotChatDefaultLabels, type CopilotChatLabels, CopilotKitCoreReact, type CopilotKitCoreReactConfig, type Interrupt, type InterruptEvent, type InterruptHandlerProps, type InterruptRenderProps, type JsonSerializable, type ReactFrontendTool, type ReactHumanInTheLoop, type ReactToolCallRenderer, type RenderToolCompleteProps, type RenderToolExecutingProps, type RenderToolInProgressProps, type RenderToolProps, type ResumeEntry, type ResumeStatus, type Thread, UseAgentUpdate, type UseInterruptConfig, type UseThreadsInput, type UseThreadsResult, defineToolCallRenderer, useAgent, useAgentContext, useCapabilities, useComponent, useConfigureSuggestions, useCopilotChatConfiguration, useCopilotKit, useFrontendTool, useFrontendTools, useHumanInTheLoop, useInterrupt, useRenderTool, useRenderToolCall, useSuggestions, useThreads };
 //# sourceMappingURL=headless.d.cts.map

package/dist/v2/headless.d.cts.map

@@ -1 +1 @@
-{"version":3,"file":"headless.d.cts","names":[],"sources":["../../src/v2/types/react-tool-call-renderer.ts","../../src/v2/types/react-activity-message-renderer.ts","../../src/v2/types/react-custom-message-renderer.ts","../../src/v2/types/frontend-tool.ts","../../src/v2/types/human-in-the-loop.ts","../../src/v2/types/defineToolCallRenderer.ts","../../src/v2/types/interrupt.ts","../../src/v2/lib/react-core.ts","../../src/v2/context.ts","../../src/v2/providers/CopilotChatConfigurationProvider.tsx","../../src/v2/hooks/use-agent.tsx","../../src/v2/hooks/use-frontend-tool.tsx","../../src/v2/hooks/use-component.tsx","../../src/v2/hooks/use-human-in-the-loop.tsx","../../src/v2/hooks/use-interrupt.tsx","../../src/v2/hooks/use-suggestions.tsx","../../src/v2/hooks/use-configure-suggestions.tsx","../../src/v2/hooks/use-agent-context.tsx","../../src/v2/hooks/use-threads.tsx","../../src/v2/hooks/use-render-tool.tsx","../../src/v2/hooks/use-render-tool-call.tsx","../../src/v2/hooks/use-capabilities.tsx"],"mappings":"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"}
+{"version":3,"file":"headless.d.cts","names":[],"sources":["../../src/v2/types/react-tool-call-renderer.ts","../../src/v2/types/react-activity-message-renderer.ts","../../src/v2/types/react-custom-message-renderer.ts","../../src/v2/types/frontend-tool.ts","../../src/v2/types/human-in-the-loop.ts","../../src/v2/types/defineToolCallRenderer.ts","../../src/v2/types/interrupt.ts","../../src/v2/lib/react-core.ts","../../src/v2/context.ts","../../src/v2/providers/CopilotChatConfigurationProvider.tsx","../../src/v2/hooks/use-agent.tsx","../../src/v2/hooks/use-frontend-tool.tsx","../../src/v2/hooks/use-frontend-tools.tsx","../../src/v2/hooks/use-component.tsx","../../src/v2/hooks/use-human-in-the-loop.tsx","../../src/v2/hooks/use-interrupt.tsx","../../src/v2/hooks/use-suggestions.tsx","../../src/v2/hooks/use-configure-suggestions.tsx","../../src/v2/hooks/use-agent-context.tsx","../../src/v2/hooks/use-threads.tsx","../../src/v2/hooks/use-render-tool.tsx","../../src/v2/hooks/use-render-tool-call.tsx","../../src/v2/hooks/use-capabilities.tsx"],"mappings":"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"}

package/dist/v2/headless.d.mts

@@ -307,6 +307,58 @@ type ReactFrontendTool<T extends Record<string, unknown> = Record<string, unknow
 //#region src/v2/hooks/use-frontend-tool.d.ts
 declare function useFrontendTool<T extends Record<string, unknown> = Record<string, unknown>>(tool: ReactFrontendTool<T>, deps?: ReadonlyArray<unknown>): void;
 //#endregion
+//#region src/v2/hooks/use-frontend-tools.d.ts
+/**
+ * Register a list of frontend tools whose length can change between renders.
+ *
+ * `useFrontendTool` registers exactly one tool per call, so it cannot be called
+ * in a loop over a runtime-length list without breaking the rules of hooks.
+ * This hook runs a single effect over the whole array instead, which makes it
+ * safe to build the list from state, props, or a server response.
+ *
+ * Tools are keyed by `name` plus `agentId`, the same as `useFrontendTool`. A
+ * tool that disappears from the array is unregistered on the next render, and
+ * every tool is unregistered on unmount. Renderers stay registered after
+ * unmount so past tool calls still render in the chat history.
+ *
+ * @param tools - The tools to register. May be empty and may change length.
+ * @param deps - Extra dependencies that force re-registration, compared by
+ * identity like the second argument of `useEffect`. Use this when a handler
+ * closes over a value that is not part of the tool definition. Keep the array
+ * a constant length across renders.
+ *
+ * @example
+ * Register one tool per item in application state:
+ * ```tsx
+ * const [reports, setReports] = useState<Report[]>([]);
+ *
+ * useFrontendTools(
+ *   reports.map((report) => ({
+ *     name: `open_${report.id}`,
+ *     description: `Open the ${report.title} report`,
+ *     handler: async () => navigate(`/reports/${report.id}`),
+ *   })),
+ *   [navigate],
+ * );
+ * ```
+ *
+ * @example
+ * Register tools described by the backend:
+ * ```tsx
+ * const { data } = useQuery(fetchToolDescriptors);
+ *
+ * useFrontendTools(
+ *   (data ?? []).map((descriptor) => ({
+ *     name: descriptor.name,
+ *     description: descriptor.description,
+ *     parameters: z.object({ query: z.string() }),
+ *     handler: async ({ query }) => runDescriptor(descriptor.id, query),
+ *   })),
+ * );
+ * ```
+ */
+declare function useFrontendTools(tools: ReadonlyArray<ReactFrontendTool<any>> | undefined, deps?: ReadonlyArray<unknown>): void;
+//#endregion
 //#region src/v2/hooks/use-component.d.ts
 type InferRenderProps<T> = T extends StandardSchemaV1 ? InferSchemaOutput<T> : any;
 /**
@@ -924,5 +976,5 @@ declare function defineToolCallRenderer<S extends StandardSchemaV1>(def: {
  */
 declare function useCapabilities(agentId?: string): AgentCapabilities | undefined;
 //#endregion
-export { type AgentContextInput, CopilotChatConfigurationProvider, type CopilotChatConfigurationProviderProps, type CopilotChatConfigurationValue, CopilotChatDefaultLabels, type CopilotChatLabels, CopilotKitCoreReact, type CopilotKitCoreReactConfig, type Interrupt, type InterruptEvent, type InterruptHandlerProps, type InterruptRenderProps, type JsonSerializable, type ReactFrontendTool, type ReactHumanInTheLoop, type ReactToolCallRenderer, type RenderToolCompleteProps, type RenderToolExecutingProps, type RenderToolInProgressProps, type RenderToolProps, type ResumeEntry, type ResumeStatus, type Thread, UseAgentUpdate, type UseInterruptConfig, type UseThreadsInput, type UseThreadsResult, defineToolCallRenderer, useAgent, useAgentContext, useCapabilities, useComponent, useConfigureSuggestions, useCopilotChatConfiguration, useCopilotKit, useFrontendTool, useHumanInTheLoop, useInterrupt, useRenderTool, useRenderToolCall, useSuggestions, useThreads };
+export { type AgentContextInput, CopilotChatConfigurationProvider, type CopilotChatConfigurationProviderProps, type CopilotChatConfigurationValue, CopilotChatDefaultLabels, type CopilotChatLabels, CopilotKitCoreReact, type CopilotKitCoreReactConfig, type Interrupt, type InterruptEvent, type InterruptHandlerProps, type InterruptRenderProps, type JsonSerializable, type ReactFrontendTool, type ReactHumanInTheLoop, type ReactToolCallRenderer, type RenderToolCompleteProps, type RenderToolExecutingProps, type RenderToolInProgressProps, type RenderToolProps, type ResumeEntry, type ResumeStatus, type Thread, UseAgentUpdate, type UseInterruptConfig, type UseThreadsInput, type UseThreadsResult, defineToolCallRenderer, useAgent, useAgentContext, useCapabilities, useComponent, useConfigureSuggestions, useCopilotChatConfiguration, useCopilotKit, useFrontendTool, useFrontendTools, useHumanInTheLoop, useInterrupt, useRenderTool, useRenderToolCall, useSuggestions, useThreads };
 //# sourceMappingURL=headless.d.mts.map

package/dist/v2/headless.d.mts.map

@@ -1 +1 @@
-{"version":3,"file":"headless.d.mts","names":[],"sources":["../../src/v2/providers/CopilotChatConfigurationProvider.tsx","../../src/v2/hooks/use-agent.tsx","../../src/v2/types/react-tool-call-renderer.ts","../../src/v2/types/frontend-tool.ts","../../src/v2/hooks/use-frontend-tool.tsx","../../src/v2/hooks/use-component.tsx","../../src/v2/types/human-in-the-loop.ts","../../src/v2/hooks/use-human-in-the-loop.tsx","../../src/v2/types/interrupt.ts","../../src/v2/hooks/use-interrupt.tsx","../../src/v2/hooks/use-suggestions.tsx","../../src/v2/hooks/use-configure-suggestions.tsx","../../src/v2/hooks/use-agent-context.tsx","../../src/v2/hooks/use-threads.tsx","../../src/v2/hooks/use-render-tool.tsx","../../src/v2/hooks/use-render-tool-call.tsx","../../src/v2/types/defineToolCallRenderer.ts","../../src/v2/hooks/use-capabilities.tsx"],"mappings":";;;;;;;;cAiBa,wBAAA;;;;;;;;;;;;;;;;;;;;;;;;;;;;;KAiCD,iBAAA,UAA2B,wBAAA;AAAA,UA6BtB,6BAAA;EACf,MAAA,EAAQ,iBAAA;EACR,OAAA;EACA,QAAA;EACA,WAAA;EACA,YAAA,GAAe,IAAA;;;;AAlCjB;;EAwCE,UAAA;EAxCqC;;AA6BvC;;;EAiBE,aAAA,GAAgB,IAAA;EAhBhB;;;;;EAsBA,gBAAA;EAlBe;;;;;;;EA0Bf,cAAA;EAWuB;;;;;;;;;AA4CzB;EA5CE,oBAAA,GAAuB,UAAA,GAAa,IAAA;EAKpC,mBAAA;EAwCU;;;;;;;;;;;;;;;;AAcZ;EApCE,iBAAA,GACE,QAAA,UACA,OAAA;IAAY,QAAA;EAAA;EAkC+B;;;;;AAyV/C;;;;EAhXE,cAAA;AAAA;AAAA,UAQe,qCAAA;EACf,QAAA,EAAU,SAAA;EACV,MAAA,GAAS,OAAA,CAAQ,iBAAA;EACjB,OAAA;EACA,QAAA;EAMA,mBAAA;EACA,kBAAA;AAAA;AAAA,cAIW,gCAAA,EAAkC,OAAA,CAAM,EAAA,CACnD,qCAAA;AAAA,cAwVW,2BAAA,QACP,6BAAA;;;aClgBM,cAAA;EACV,iBAAA;EACA,cAAA;EACA,kBAAA;AAAA;AAAA,UASQ,iBAAA;EACR,OAAA,GAAU,cAAA;EDRC;;;;;;;;;;;;;;;;;;;;;;EC+BX,UAAA;AAAA;;;;;;;;UAUQ,yBAAA;;ADRV;;;;;AA6BA;;;ECXE,OAAA;EDYA;;;;;;;;;;;ECAA,QAAA;EDyCA;;;;;;;;;;;AA4CF;;;;;;ECnEE,cAAA;AAAA;;;;;;;;;;UAYQ,qBAAA;EDkEU;AAIpB;;;ECjEE,OAAA;EDiE6C;EC/D7C,QAAA;EDgEA;EC9DA,cAAA;AAAA;ADsZF;;;;;;;;ACjgBA;;;;;;;;ADigBA,KCnYY,aAAA,GAAgB,iBAAA,IACzB,yBAAA,GAA4B,qBAAA;AAAA,iBAEf,QAAA,CAAA;EACd,OAAA;EACA,QAAA;EACA,cAAA;EACA,OAAA;EACA;AAAA,IACC,aAAA;;;;;;;;;AAnGS;;;;;;;;;;;UC7CK,qBAAA;EACf,IAAA;;;;;EAKA,IAAA,GAAO,gBAAA,MAAsB,CAAA;EFuC9B;;;;EElCC,OAAA;EACA,MAAA,EAAQ,KAAA,CAAM,aAAA;IAER,IAAA;IACA,UAAA;IACA,IAAA,EAAM,OAAA,CAAQ,CAAA;IACd,MAAA,EAAQ,cAAA,CAAe,UAAA;IACvB,MAAA;EAAA;IAGA,IAAA;IACA,UAAA;IACA,IAAA,EAAM,CAAA;IACN,MAAA,EAAQ,cAAA,CAAe,SAAA;IACvB,MAAA;EAAA;IAGA,IAAA;IACA,UAAA;IACA,IAAA,EAAM,CAAA;IACN,MAAA,EAAQ,cAAA,CAAe,QAAA;IACvB,MAAA;EAAA;AAAA;;;KChCI,iBAAA,WACA,MAAA,oBAA0B,MAAA,qBAClC,YAAA,CAAa,CAAA;EACf,MAAA,GAAS,qBAAA,CAAsB,CAAA;AAAA;;;iBCAjB,eAAA,WACJ,MAAA,oBAA0B,MAAA,kBAAA,CACpC,IAAA,EAAM,iBAAA,CAAkB,CAAA,GAAI,IAAA,GAAO,aAAA;;;KCJhC,gBAAA,MAAsB,CAAA,SAAU,gBAAA,GACjC,iBAAA,CAAkB,CAAA;;;;;;ALYtB;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;AAiCA;;;;;AA6BA;;;;;;;iBKrBgB,YAAA,iBACE,gBAAA,MAAsB,MAAA,2CAAA,CAGtC,MAAA;EACE,IAAA;EACA,WAAA;EACA,UAAA,GAAa,OAAA;EACb,MAAA,EAAQ,aAAA,CAAc,OAAA,CAAQ,gBAAA,CAAiB,OAAA;EAC/C,OAAA;EACA,QAAA;AAAA,GAEF,IAAA,GAAO,aAAA;;;KCnEG,mBAAA,WACA,MAAA,oBAA0B,MAAA,qBAClC,IAAA,CAAK,YAAA,CAAa,CAAA;;;;;;ANYtB;;;;;;;;;;;EMKE,MAAA,EAAQ,OAAA,CAAM,aAAA;IAER,IAAA;IACA,WAAA;IACA,UAAA;IACA,OAAA;IACA,IAAA,EAAM,OAAA,CAAQ,CAAA;IACd,MAAA,EAAQ,cAAA,CAAe,UAAA;IACvB,MAAA;IACA,OAAA;EAAA;IAGA,IAAA;IACA,WAAA;IACA,UAAA;IACA,OAAA;IACA,IAAA,EAAM,CAAA;IACN,MAAA,EAAQ,cAAA,CAAe,SAAA;IACvB,MAAA;IACA,OAAA,GAAU,MAAA,cAAoB,OAAA;EAAA;IAG9B,IAAA;IACA,WAAA;IACA,UAAA;IACA,OAAA;IACA,IAAA,EAAM,CAAA;IACN,MAAA,EAAQ,cAAA,CAAe,QAAA;IACvB,MAAA;IACA,OAAA;EAAA;AAAA;;;iBCvCQ,iBAAA,WACJ,MAAA,oBAA0B,MAAA,kBAAA,CACpC,IAAA,EAAM,mBAAA,CAAoB,CAAA,GAAI,IAAA,GAAO,aAAA;;;;UCNtB,cAAA;EACf,IAAA;EACA,KAAA,EAAO,MAAA;AAAA;;;;;;;;;KAWG,kBAAA,IACV,OAAA,YACA,WAAA,cACG,OAAA,CAAQ,cAAA;;;;;;;;KASD,iBAAA,IACV,WAAA,cACG,OAAA,CAAQ,cAAA;AAAA,UAEI,qBAAA;;;;;;EAMf,KAAA,EAAO,cAAA,CAAe,MAAA;;EAEtB,SAAA,EAAW,SAAA;;EAEX,UAAA,EAAY,SAAA;EACZ,OAAA,EAAS,kBAAA;EACT,MAAA,EAAQ,iBAAA;AAAA;AAAA,UAGO,oBAAA;EACf,KAAA,EAAO,cAAA,CAAe,MAAA;EACtB,SAAA,EAAW,SAAA;EACX,UAAA,EAAY,SAAA;EACZ,MAAA,EAAQ,OAAA;EACR,OAAA,EAAS,kBAAA;EACT,MAAA,EAAQ,iBAAA;AAAA;;;KCvBL,kBAAA,qBACH,KAAA,EAAO,qBAAA,CAAsB,MAAA,MAC1B,OAAA,GAAU,WAAA,CAAY,OAAA;AAAA,KAEtB,0BAAA,aAAuC,QAAA,cACvC,IAAA,+BAED,OAAA,SAAgB,WAAA,oBACd,SAAA,UACA,OAAA;AAAA,KAGD,eAAA,oBAAmC,0BAAA,CACtC,kBAAA,CAAmB,MAAA,EAAQ,OAAA;AAAA,KAGxB,qBAAA;AAAA,KAEA,kBAAA,uBAAyC,qBAAA,IAC5C,aAAA,iBACI,OAAA,CAAM,YAAA,UACN,aAAA,mCAEE,OAAA,CAAM,YAAA;;;;UAqBJ,sBAAA;;;;;;;EAOR,MAAA,GACE,KAAA,EAAO,oBAAA,CAAqB,MAAA,EAAQ,eAAA,CAAgB,MAAA,EAAQ,OAAA,OACzD,OAAA,CAAM,YAAA;;;;;;EAMX,OAAA,GAAU,kBAAA,CAAmB,MAAA,EAAQ,OAAA;;;;;;EAMrC,OAAA,IAAW,KAAA,EAAO,cAAA,CAAe,MAAA;;EAEjC,OAAA;AAAA;AAAA,KA2BU,kBAAA,0DAGY,qBAAA,gBACpB,sBAAA,CAAuB,MAAA,EAAQ,OAAA;ETrDR,0FSuDzB,YAAA,GAAe,aAAA;AAAA;;;;;;;;;;;;;;;;;;;;;;AT8BjB;;;;;;iBSCgB,YAAA,wCAEQ,qBAAA,aAAA,CAEtB,MAAA,EAAQ,kBAAA,MAAwB,OAAA,EAAS,aAAA,IACxC,kBAAA,CAAmB,aAAA;;;UCrKL,qBAAA;EACf,OAAA;AAAA;AAAA,UAGe,oBAAA;EACf,WAAA,EAAa,UAAA;EACb,iBAAA;EACA,gBAAA;EACA,SAAA;AAAA;AAAA,iBAGc,cAAA,CAAA;EACd;AAAA,IACC,qBAAA,GAA6B,oBAAA;;;KCR3B,qBAAA,GAAwB,IAAA,CAAK,UAAA,iBAChC,OAAA,CAAQ,IAAA,CAAK,UAAA;AAAA,KAEV,4BAAA,GAA+B,IAAA,CAClC,uBAAA;EAGA,WAAA,EAAa,qBAAA;AAAA;AAAA,KAGV,sBAAA,GACD,wBAAA,GACA,4BAAA;AAAA,iBAEY,uBAAA,CACd,MAAA,EAAQ,sBAAA,qBACR,IAAA,GAAO,aAAA;;;;;;KCrBG,gBAAA,sCAKR,gBAAA;EAAA,CACG,GAAA,WAAc,gBAAA;AAAA;;;AZKrB;;UYCiB,iBAAA;EZ8BhB;EY5BC,WAAA;;EAEA,KAAA,EAAO,gBAAA;AAAA;AAAA,iBAGO,eAAA,CAAgB,OAAA,EAAS,iBAAA;;;;;;;;;UCExB,MAAA;EACf,EAAA;EACA,OAAA;EACA,IAAA;EACA,QAAA;EACA,SAAA;EACA,SAAA;;;;;;;EAOA,SAAA;AAAA;;;;;;;UASe,eAAA;;EAEf,OAAA;;EAEA,eAAA;;EAEA,KAAA;;;;;;;;AbLF;;EaeE,OAAA;AAAA;;AbcF;;;;;;UaJiB,gBAAA;EbOf;;;;;EaDA,OAAA,EAAS,MAAA;EbeO;;;;EaVhB,SAAA;EbmCuB;;;;;;;;;AA4CzB;EapEE,KAAA,EAAO,KAAA;;;;;;;;EAQP,SAAA,EAAW,KAAA;Eb8DX;;;;;;;EatDA,cAAA,EAAgB,KAAA;Eb+DE;AAIpB;;;Ea9DE,cAAA;Eb8D6C;;;Ea1D7C,qBAAA;Eb2DqC;AAwVvC;;;;;Ea5YE,UAAA;;;AZrHF;;EY0HE,gBAAA;EZ1HwB;;;;;EYgIxB,cAAA;EZpHQ;;;;;EY0HR,cAAA;EZlGA;;;AAAU;EYuGV,YAAA,GAAe,QAAA,UAAkB,IAAA,aAAiB,OAAA;;;;;;EAMlD,aAAA,GAAgB,QAAA,aAAqB,OAAA;EZ3DvB;AAAA;;;;EYiEd,eAAA,GAAkB,QAAA,aAAqB,OAAA;EZ9CvC;;;;AAqBF;EY+BE,YAAA,GAAe,QAAA,aAAqB,OAAA;AAAA;;;;;;;;;;;AZ5BtC;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;iBY6FgB,UAAA,CAAA;EACd,OAAA;EACA,eAAA;EACA,KAAA;EACA;AAAA,GACC,eAAA,GAAkB,gBAAA;;;UCvOJ,yBAAA,WAAoC,gBAAA;EACnD,IAAA;EACA,UAAA;EACA,UAAA,EAAY,OAAA,CAAQ,iBAAA,CAAkB,CAAA;EACtC,MAAA;EACA,MAAA;AAAA;AAAA,UAGe,wBAAA,WAAmC,gBAAA;EAClD,IAAA;EACA,UAAA;EACA,UAAA,EAAY,iBAAA,CAAkB,CAAA;EAC9B,MAAA;EACA,MAAA;AAAA;AAAA,UAGe,uBAAA,WAAkC,gBAAA;EACjD,IAAA;EACA,UAAA;EACA,UAAA,EAAY,iBAAA,CAAkB,CAAA;EAC9B,MAAA;EACA,MAAA;AAAA;AAAA,KAGU,eAAA,WAA0B,gBAAA,IAClC,yBAAA,CAA0B,CAAA,IAC1B,wBAAA,CAAyB,CAAA,IACzB,uBAAA,CAAwB,CAAA;;;;;;;;;;;;;;;;;;;Ade5B;;;;;AA6BA;iBcXgB,aAAA,CACd,MAAA;EACE,IAAA;EACA,MAAA,GAAS,KAAA,UAAe,KAAA,CAAM,YAAA;EAC9B,OAAA;AAAA,GAEF,IAAA,GAAO,aAAA;;;;;;;;;;;;;;;;;;;;;;Ad2FT;;;;;;iBc7DgB,aAAA,WAAwB,gBAAA,CAAA,CACtC,MAAA;EACE,IAAA;EACA,UAAA,EAAY,CAAA;EACZ,MAAA,GAAS,KAAA,EAAO,eAAA,CAAgB,CAAA,MAAO,KAAA,CAAM,YAAA;EAC7C,OAAA;AAAA,GAEF,IAAA,GAAO,aAAA;;;UChGQ,sBAAA;EACf,QAAA,EAAU,QAAA;EACV,WAAA,GAAc,WAAA;AAAA;;;AfAhB;;;;iBe6IgB,iBAAA,CAAA;EAAiB,QAAA;EAAA;AAAA,GAgC1B,sBAAA,KAAyB,OAAA,CAAM,YAAA;;;;;;;Af7KtC;;;KgBJK,WAAA;EAEC,IAAA;EACA,UAAA;EACA,IAAA,EAAM,OAAA,CAAQ,CAAA;EACd,MAAA,EAAQ,cAAA,CAAe,UAAA;EACvB,MAAA;AAAA;EAGA,IAAA;EACA,UAAA;EACA,IAAA,EAAM,CAAA;EACN,MAAA,EAAQ,cAAA,CAAe,SAAA;EACvB,MAAA;AAAA;EAGA,IAAA;EACA,UAAA;EACA,IAAA,EAAM,CAAA;EACN,MAAA,EAAQ,cAAA,CAAe,QAAA;EACvB,MAAA;AAAA;AAAA,iBAIU,sBAAA,CAAuB,GAAA;EACrC,IAAA;EACA,MAAA,GAAS,KAAA,EAAO,WAAA,UAAqB,OAAA,CAAM,YAAA;EAC3C,OAAA;AAAA,IACE,qBAAA;AAAA,iBAGY,sBAAA,WAAiC,gBAAA,CAAA,CAAkB,GAAA;EACjE,IAAA;EACA,IAAA,EAAM,CAAA;EACN,MAAA,GACE,KAAA,EAAO,WAAA,CAAY,iBAAA,CAAkB,CAAA,OAClC,OAAA,CAAM,YAAA;EACX,OAAA;AAAA,IACE,qBAAA,CAAsB,iBAAA,CAAkB,CAAA;;;;;;;;;;AhBlC5C;;;;;;iBiBDgB,eAAA,CACd,OAAA,YACC,iBAAA"}
+{"version":3,"file":"headless.d.mts","names":[],"sources":["../../src/v2/providers/CopilotChatConfigurationProvider.tsx","../../src/v2/hooks/use-agent.tsx","../../src/v2/types/react-tool-call-renderer.ts","../../src/v2/types/frontend-tool.ts","../../src/v2/hooks/use-frontend-tool.tsx","../../src/v2/hooks/use-frontend-tools.tsx","../../src/v2/hooks/use-component.tsx","../../src/v2/types/human-in-the-loop.ts","../../src/v2/hooks/use-human-in-the-loop.tsx","../../src/v2/types/interrupt.ts","../../src/v2/hooks/use-interrupt.tsx","../../src/v2/hooks/use-suggestions.tsx","../../src/v2/hooks/use-configure-suggestions.tsx","../../src/v2/hooks/use-agent-context.tsx","../../src/v2/hooks/use-threads.tsx","../../src/v2/hooks/use-render-tool.tsx","../../src/v2/hooks/use-render-tool-call.tsx","../../src/v2/types/defineToolCallRenderer.ts","../../src/v2/hooks/use-capabilities.tsx"],"mappings":";;;;;;;;cAiBa,wBAAA;;;;;;;;;;;;;;;;;;;;;;;;;;;;;KAiCD,iBAAA,UAA2B,wBAAA;AAAA,UA6BtB,6BAAA;EACf,MAAA,EAAQ,iBAAA;EACR,OAAA;EACA,QAAA;EACA,WAAA;EACA,YAAA,GAAe,IAAA;;;;AAlCjB;;EAwCE,UAAA;EAxCqC;;AA6BvC;;;EAiBE,aAAA,GAAgB,IAAA;EAhBhB;;;;;EAsBA,gBAAA;EAlBe;;;;;;;EA0Bf,cAAA;EAWuB;;;;;;;;;AA4CzB;EA5CE,oBAAA,GAAuB,UAAA,GAAa,IAAA;EAKpC,mBAAA;EAwCU;;;;;;;;;;;;;;;;AAcZ;EApCE,iBAAA,GACE,QAAA,UACA,OAAA;IAAY,QAAA;EAAA;EAkC+B;;;;;AAyV/C;;;;EAhXE,cAAA;AAAA;AAAA,UAQe,qCAAA;EACf,QAAA,EAAU,SAAA;EACV,MAAA,GAAS,OAAA,CAAQ,iBAAA;EACjB,OAAA;EACA,QAAA;EAMA,mBAAA;EACA,kBAAA;AAAA;AAAA,cAIW,gCAAA,EAAkC,OAAA,CAAM,EAAA,CACnD,qCAAA;AAAA,cAwVW,2BAAA,QACP,6BAAA;;;aClgBM,cAAA;EACV,iBAAA;EACA,cAAA;EACA,kBAAA;AAAA;AAAA,UASQ,iBAAA;EACR,OAAA,GAAU,cAAA;EDRC;;;;;;;;;;;;;;;;;;;;;;EC+BX,UAAA;AAAA;;;;;;;;UAUQ,yBAAA;;ADRV;;;;;AA6BA;;;ECXE,OAAA;EDYA;;;;;;;;;;;ECAA,QAAA;EDyCA;;;;;;;;;;;AA4CF;;;;;;ECnEE,cAAA;AAAA;;;;;;;;;;UAYQ,qBAAA;EDkEU;AAIpB;;;ECjEE,OAAA;EDiE6C;EC/D7C,QAAA;EDgEA;EC9DA,cAAA;AAAA;ADsZF;;;;;;;;ACjgBA;;;;;;;;ADigBA,KCnYY,aAAA,GAAgB,iBAAA,IACzB,yBAAA,GAA4B,qBAAA;AAAA,iBAEf,QAAA,CAAA;EACd,OAAA;EACA,QAAA;EACA,cAAA;EACA,OAAA;EACA;AAAA,IACC,aAAA;;;;;;;;;AAnGS;;;;;;;;;;;UC7CK,qBAAA;EACf,IAAA;;;;;EAKA,IAAA,GAAO,gBAAA,MAAsB,CAAA;EFuC9B;;;;EElCC,OAAA;EACA,MAAA,EAAQ,KAAA,CAAM,aAAA;IAER,IAAA;IACA,UAAA;IACA,IAAA,EAAM,OAAA,CAAQ,CAAA;IACd,MAAA,EAAQ,cAAA,CAAe,UAAA;IACvB,MAAA;EAAA;IAGA,IAAA;IACA,UAAA;IACA,IAAA,EAAM,CAAA;IACN,MAAA,EAAQ,cAAA,CAAe,SAAA;IACvB,MAAA;EAAA;IAGA,IAAA;IACA,UAAA;IACA,IAAA,EAAM,CAAA;IACN,MAAA,EAAQ,cAAA,CAAe,QAAA;IACvB,MAAA;EAAA;AAAA;;;KChCI,iBAAA,WACA,MAAA,oBAA0B,MAAA,qBAClC,YAAA,CAAa,CAAA;EACf,MAAA,GAAS,qBAAA,CAAsB,CAAA;AAAA;;;iBCAjB,eAAA,WACJ,MAAA,oBAA0B,MAAA,kBAAA,CACpC,IAAA,EAAM,iBAAA,CAAkB,CAAA,GAAI,IAAA,GAAO,aAAA;;;;;;;;;;AJSrC;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;AAiCA;;;;;AA6BA;;;;iBKvBgB,gBAAA,CACd,KAAA,EAAO,aAAA,CAAc,iBAAA,oBACrB,IAAA,GAAO,aAAA;;;KCtDJ,gBAAA,MAAsB,CAAA,SAAU,gBAAA,GACjC,iBAAA,CAAkB,CAAA;;;;;;ANYtB;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;AAiCA;;;;;AA6BA;;;;;;;iBMrBgB,YAAA,iBACE,gBAAA,MAAsB,MAAA,2CAAA,CAGtC,MAAA;EACE,IAAA;EACA,WAAA;EACA,UAAA,GAAa,OAAA;EACb,MAAA,EAAQ,aAAA,CAAc,OAAA,CAAQ,gBAAA,CAAiB,OAAA;EAC/C,OAAA;EACA,QAAA;AAAA,GAEF,IAAA,GAAO,aAAA;;;KCnEG,mBAAA,WACA,MAAA,oBAA0B,MAAA,qBAClC,IAAA,CAAK,YAAA,CAAa,CAAA;;;;;;APYtB;;;;;;;;;;;EOKE,MAAA,EAAQ,OAAA,CAAM,aAAA;IAER,IAAA;IACA,WAAA;IACA,UAAA;IACA,OAAA;IACA,IAAA,EAAM,OAAA,CAAQ,CAAA;IACd,MAAA,EAAQ,cAAA,CAAe,UAAA;IACvB,MAAA;IACA,OAAA;EAAA;IAGA,IAAA;IACA,WAAA;IACA,UAAA;IACA,OAAA;IACA,IAAA,EAAM,CAAA;IACN,MAAA,EAAQ,cAAA,CAAe,SAAA;IACvB,MAAA;IACA,OAAA,GAAU,MAAA,cAAoB,OAAA;EAAA;IAG9B,IAAA;IACA,WAAA;IACA,UAAA;IACA,OAAA;IACA,IAAA,EAAM,CAAA;IACN,MAAA,EAAQ,cAAA,CAAe,QAAA;IACvB,MAAA;IACA,OAAA;EAAA;AAAA;;;iBCvCQ,iBAAA,WACJ,MAAA,oBAA0B,MAAA,kBAAA,CACpC,IAAA,EAAM,mBAAA,CAAoB,CAAA,GAAI,IAAA,GAAO,aAAA;;;;UCNtB,cAAA;EACf,IAAA;EACA,KAAA,EAAO,MAAA;AAAA;;;;;;;;;KAWG,kBAAA,IACV,OAAA,YACA,WAAA,cACG,OAAA,CAAQ,cAAA;;;;;;;;KASD,iBAAA,IACV,WAAA,cACG,OAAA,CAAQ,cAAA;AAAA,UAEI,qBAAA;;;;;;EAMf,KAAA,EAAO,cAAA,CAAe,MAAA;;EAEtB,SAAA,EAAW,SAAA;;EAEX,UAAA,EAAY,SAAA;EACZ,OAAA,EAAS,kBAAA;EACT,MAAA,EAAQ,iBAAA;AAAA;AAAA,UAGO,oBAAA;EACf,KAAA,EAAO,cAAA,CAAe,MAAA;EACtB,SAAA,EAAW,SAAA;EACX,UAAA,EAAY,SAAA;EACZ,MAAA,EAAQ,OAAA;EACR,OAAA,EAAS,kBAAA;EACT,MAAA,EAAQ,iBAAA;AAAA;;;KCvBL,kBAAA,qBACH,KAAA,EAAO,qBAAA,CAAsB,MAAA,MAC1B,OAAA,GAAU,WAAA,CAAY,OAAA;AAAA,KAEtB,0BAAA,aAAuC,QAAA,cACvC,IAAA,+BAED,OAAA,SAAgB,WAAA,oBACd,SAAA,UACA,OAAA;AAAA,KAGD,eAAA,oBAAmC,0BAAA,CACtC,kBAAA,CAAmB,MAAA,EAAQ,OAAA;AAAA,KAGxB,qBAAA;AAAA,KAEA,kBAAA,uBAAyC,qBAAA,IAC5C,aAAA,iBACI,OAAA,CAAM,YAAA,UACN,aAAA,mCAEE,OAAA,CAAM,YAAA;;;;UAqBJ,sBAAA;;;;;;;EAOR,MAAA,GACE,KAAA,EAAO,oBAAA,CAAqB,MAAA,EAAQ,eAAA,CAAgB,MAAA,EAAQ,OAAA,OACzD,OAAA,CAAM,YAAA;;;;;;EAMX,OAAA,GAAU,kBAAA,CAAmB,MAAA,EAAQ,OAAA;;;;;;EAMrC,OAAA,IAAW,KAAA,EAAO,cAAA,CAAe,MAAA;;EAEjC,OAAA;AAAA;AAAA,KA2BU,kBAAA,0DAGY,qBAAA,gBACpB,sBAAA,CAAuB,MAAA,EAAQ,OAAA;EVrDR,0FUuDzB,YAAA,GAAe,aAAA;AAAA;;;;;;;;;;;;;;;;;;;;;;AV8BjB;;;;;;iBUCgB,YAAA,wCAEQ,qBAAA,aAAA,CAEtB,MAAA,EAAQ,kBAAA,MAAwB,OAAA,EAAS,aAAA,IACxC,kBAAA,CAAmB,aAAA;;;UCrKL,qBAAA;EACf,OAAA;AAAA;AAAA,UAGe,oBAAA;EACf,WAAA,EAAa,UAAA;EACb,iBAAA;EACA,gBAAA;EACA,SAAA;AAAA;AAAA,iBAGc,cAAA,CAAA;EACd;AAAA,IACC,qBAAA,GAA6B,oBAAA;;;KCR3B,qBAAA,GAAwB,IAAA,CAAK,UAAA,iBAChC,OAAA,CAAQ,IAAA,CAAK,UAAA;AAAA,KAEV,4BAAA,GAA+B,IAAA,CAClC,uBAAA;EAGA,WAAA,EAAa,qBAAA;AAAA;AAAA,KAGV,sBAAA,GACD,wBAAA,GACA,4BAAA;AAAA,iBAEY,uBAAA,CACd,MAAA,EAAQ,sBAAA,qBACR,IAAA,GAAO,aAAA;;;;;;KCrBG,gBAAA,sCAKR,gBAAA;EAAA,CACG,GAAA,WAAc,gBAAA;AAAA;;;AbKrB;;UaCiB,iBAAA;Eb8BhB;Ea5BC,WAAA;;EAEA,KAAA,EAAO,gBAAA;AAAA;AAAA,iBAGO,eAAA,CAAgB,OAAA,EAAS,iBAAA;;;;;;;;;UCExB,MAAA;EACf,EAAA;EACA,OAAA;EACA,IAAA;EACA,QAAA;EACA,SAAA;EACA,SAAA;;;;;;;EAOA,SAAA;AAAA;;;;;;;UASe,eAAA;;EAEf,OAAA;;EAEA,eAAA;;EAEA,KAAA;;;;;;;;AdLF;;EceE,OAAA;AAAA;;AdcF;;;;;;UcJiB,gBAAA;EdOf;;;;;EcDA,OAAA,EAAS,MAAA;EdeO;;;;EcVhB,SAAA;EdmCuB;;;;;;;;;AA4CzB;EcpEE,KAAA,EAAO,KAAA;;;;;;;;EAQP,SAAA,EAAW,KAAA;Ed8DX;;;;;;;EctDA,cAAA,EAAgB,KAAA;Ed+DE;AAIpB;;;Ec9DE,cAAA;Ed8D6C;;;Ec1D7C,qBAAA;Ed2DqC;AAwVvC;;;;;Ec5YE,UAAA;;;AbrHF;;Ea0HE,gBAAA;Eb1HwB;;;;;EagIxB,cAAA;EbpHQ;;;;;Ea0HR,cAAA;EblGA;;;AAAU;EauGV,YAAA,GAAe,QAAA,UAAkB,IAAA,aAAiB,OAAA;;;;;;EAMlD,aAAA,GAAgB,QAAA,aAAqB,OAAA;Eb3DvB;AAAA;;;;EaiEd,eAAA,GAAkB,QAAA,aAAqB,OAAA;Eb9CvC;;;;AAqBF;Ea+BE,YAAA,GAAe,QAAA,aAAqB,OAAA;AAAA;;;;;;;;;;;Ab5BtC;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;iBa6FgB,UAAA,CAAA;EACd,OAAA;EACA,eAAA;EACA,KAAA;EACA;AAAA,GACC,eAAA,GAAkB,gBAAA;;;UCvOJ,yBAAA,WAAoC,gBAAA;EACnD,IAAA;EACA,UAAA;EACA,UAAA,EAAY,OAAA,CAAQ,iBAAA,CAAkB,CAAA;EACtC,MAAA;EACA,MAAA;AAAA;AAAA,UAGe,wBAAA,WAAmC,gBAAA;EAClD,IAAA;EACA,UAAA;EACA,UAAA,EAAY,iBAAA,CAAkB,CAAA;EAC9B,MAAA;EACA,MAAA;AAAA;AAAA,UAGe,uBAAA,WAAkC,gBAAA;EACjD,IAAA;EACA,UAAA;EACA,UAAA,EAAY,iBAAA,CAAkB,CAAA;EAC9B,MAAA;EACA,MAAA;AAAA;AAAA,KAGU,eAAA,WAA0B,gBAAA,IAClC,yBAAA,CAA0B,CAAA,IAC1B,wBAAA,CAAyB,CAAA,IACzB,uBAAA,CAAwB,CAAA;;;;;;;;;;;;;;;;;;;Afe5B;;;;;AA6BA;iBeXgB,aAAA,CACd,MAAA;EACE,IAAA;EACA,MAAA,GAAS,KAAA,UAAe,KAAA,CAAM,YAAA;EAC9B,OAAA;AAAA,GAEF,IAAA,GAAO,aAAA;;;;;;;;;;;;;;;;;;;;;;Af2FT;;;;;;iBe7DgB,aAAA,WAAwB,gBAAA,CAAA,CACtC,MAAA;EACE,IAAA;EACA,UAAA,EAAY,CAAA;EACZ,MAAA,GAAS,KAAA,EAAO,eAAA,CAAgB,CAAA,MAAO,KAAA,CAAM,YAAA;EAC7C,OAAA;AAAA,GAEF,IAAA,GAAO,aAAA;;;UChGQ,sBAAA;EACf,QAAA,EAAU,QAAA;EACV,WAAA,GAAc,WAAA;AAAA;;;AhBAhB;;;;iBgB6IgB,iBAAA,CAAA;EAAiB,QAAA;EAAA;AAAA,GAgC1B,sBAAA,KAAyB,OAAA,CAAM,YAAA;;;;;;;AhB7KtC;;;KiBJK,WAAA;EAEC,IAAA;EACA,UAAA;EACA,IAAA,EAAM,OAAA,CAAQ,CAAA;EACd,MAAA,EAAQ,cAAA,CAAe,UAAA;EACvB,MAAA;AAAA;EAGA,IAAA;EACA,UAAA;EACA,IAAA,EAAM,CAAA;EACN,MAAA,EAAQ,cAAA,CAAe,SAAA;EACvB,MAAA;AAAA;EAGA,IAAA;EACA,UAAA;EACA,IAAA,EAAM,CAAA;EACN,MAAA,EAAQ,cAAA,CAAe,QAAA;EACvB,MAAA;AAAA;AAAA,iBAIU,sBAAA,CAAuB,GAAA;EACrC,IAAA;EACA,MAAA,GAAS,KAAA,EAAO,WAAA,UAAqB,OAAA,CAAM,YAAA;EAC3C,OAAA;AAAA,IACE,qBAAA;AAAA,iBAGY,sBAAA,WAAiC,gBAAA,CAAA,CAAkB,GAAA;EACjE,IAAA;EACA,IAAA,EAAM,CAAA;EACN,MAAA,GACE,KAAA,EAAO,WAAA,CAAY,iBAAA,CAAkB,CAAA,OAClC,OAAA,CAAM,YAAA;EACX,OAAA;AAAA,IACE,qBAAA,CAAsB,iBAAA,CAAkB,CAAA;;;;;;;;;;AjBlC5C;;;;;;iBkBDgB,eAAA,CACd,OAAA,YACC,iBAAA"}

package/dist/v2/headless.mjs

@@ -514,10 +514,10 @@ function useAgent({ agentId, threadId, runtimeAgentId, updates, throttleMs } = {
 
 //#endregion
 //#region src/v2/hooks/use-frontend-tool.tsx
-const EMPTY_DEPS$1 = [];
+const EMPTY_DEPS$2 = [];
 function useFrontendTool(tool, deps) {
 	const { copilotkit } = useCopilotKit$1();
-	const extraDeps = deps ?? EMPTY_DEPS$1;
+	const extraDeps = deps ?? EMPTY_DEPS$2;
 	useLayoutEffect(() => {
 		const name = tool.name;
 		if (copilotkit.getTool({
@@ -546,6 +546,103 @@ function useFrontendTool(tool, deps) {
 	]);
 }
 
+//#endregion
+//#region src/v2/hooks/use-frontend-tools.tsx
+const EMPTY_DEPS$1 = [];
+const EMPTY_TOOLS = [];
+/**
+* Register a list of frontend tools whose length can change between renders.
+*
+* `useFrontendTool` registers exactly one tool per call, so it cannot be called
+* in a loop over a runtime-length list without breaking the rules of hooks.
+* This hook runs a single effect over the whole array instead, which makes it
+* safe to build the list from state, props, or a server response.
+*
+* Tools are keyed by `name` plus `agentId`, the same as `useFrontendTool`. A
+* tool that disappears from the array is unregistered on the next render, and
+* every tool is unregistered on unmount. Renderers stay registered after
+* unmount so past tool calls still render in the chat history.
+*
+* @param tools - The tools to register. May be empty and may change length.
+* @param deps - Extra dependencies that force re-registration, compared by
+* identity like the second argument of `useEffect`. Use this when a handler
+* closes over a value that is not part of the tool definition. Keep the array
+* a constant length across renders.
+*
+* @example
+* Register one tool per item in application state:
+* ```tsx
+* const [reports, setReports] = useState<Report[]>([]);
+*
+* useFrontendTools(
+*   reports.map((report) => ({
+*     name: `open_${report.id}`,
+*     description: `Open the ${report.title} report`,
+*     handler: async () => navigate(`/reports/${report.id}`),
+*   })),
+*   [navigate],
+* );
+* ```
+*
+* @example
+* Register tools described by the backend:
+* ```tsx
+* const { data } = useQuery(fetchToolDescriptors);
+*
+* useFrontendTools(
+*   (data ?? []).map((descriptor) => ({
+*     name: descriptor.name,
+*     description: descriptor.description,
+*     parameters: z.object({ query: z.string() }),
+*     handler: async ({ query }) => runDescriptor(descriptor.id, query),
+*   })),
+* );
+* ```
+*/
+function useFrontendTools(tools, deps) {
+	const { copilotkit } = useCopilotKit$1();
+	const toolList = tools ?? EMPTY_TOOLS;
+	const extraDeps = deps ?? EMPTY_DEPS$1;
+	useLayoutEffect(() => {
+		const deduped = /* @__PURE__ */ new Map();
+		for (const tool of toolList) {
+			const key = `${tool.agentId ?? ""}:${tool.name}`;
+			if (deduped.has(key)) console.warn(`Tool '${tool.name}' is listed more than once for agent '${tool.agentId || "global"}' in the same useFrontendTools call. Using the last entry.`);
+			deduped.set(key, tool);
+		}
+		const registered = [...deduped.values()];
+		for (const tool of registered) {
+			if (copilotkit.getTool({
+				toolName: tool.name,
+				agentId: tool.agentId
+			})) {
+				console.warn(`Tool '${tool.name}' already exists for agent '${tool.agentId || "global"}'. Overriding with latest registration.`);
+				copilotkit.removeTool(tool.name, tool.agentId);
+			}
+			copilotkit.addTool(tool);
+			if (tool.render) copilotkit.addHookRenderToolCall({
+				name: tool.name,
+				args: tool.parameters,
+				agentId: tool.agentId,
+				render: tool.render
+			});
+		}
+		return () => {
+			for (const tool of registered) copilotkit.removeTool(tool.name, tool.agentId);
+		};
+	}, [
+		JSON.stringify(toolList.map((tool) => [
+			tool.name,
+			tool.description ?? null,
+			tool.agentId ?? null,
+			tool.available ?? null,
+			tool.webmcp ?? null
+		])),
+		copilotkit,
+		...extraDeps
+	]);
+}
+
 //#endregion
 //#region src/v2/hooks/use-component.tsx
 /**
@@ -692,6 +789,7 @@ function useHumanInTheLoop(tool, deps) {
 	]);
 	useFrontendTool({
 		...tool,
+		type: "human-in-the-loop",
 		handler,
 		render: RenderComponent
 	}, deps);
@@ -1654,5 +1752,5 @@ function useCapabilities(agentId) {
 }
 
 //#endregion
-export { CopilotChatConfigurationProvider, CopilotChatDefaultLabels, CopilotKitCoreReact, UseAgentUpdate, defineToolCallRenderer, useAgent, useAgentContext, useCapabilities, useComponent, useConfigureSuggestions, useCopilotChatConfiguration, useCopilotKit, useFrontendTool, useHumanInTheLoop, useInterrupt, useRenderTool, useRenderToolCall, useSuggestions, useThreads };
+export { CopilotChatConfigurationProvider, CopilotChatDefaultLabels, CopilotKitCoreReact, UseAgentUpdate, defineToolCallRenderer, useAgent, useAgentContext, useCapabilities, useComponent, useConfigureSuggestions, useCopilotChatConfiguration, useCopilotKit, useFrontendTool, useFrontendTools, useHumanInTheLoop, useInterrupt, useRenderTool, useRenderToolCall, useSuggestions, useThreads };
 //# sourceMappingURL=headless.mjs.map