@copilotkit/react-core 1.57.0 → 1.57.1-canary.1778272612

package/dist/v2/headless.d.cts

@@ -0,0 +1,605 @@
+import React$1, { ComponentType, ReactNode } from "react";
+import { InferSchemaOutput, StandardSchemaV1 } from "@copilotkit/shared";
+import { CopilotKitCore, CopilotKitCoreConfig, CopilotKitCoreSubscriber, CopilotKitCoreSubscription, DynamicSuggestionsConfig, FrontendTool, StaticSuggestionsConfig, Suggestion, ToolCallStatus } from "@copilotkit/core";
+import { ActivityMessage, Message } from "@ag-ui/core";
+import { AbstractAgent } from "@ag-ui/client";
+
+//#region src/v2/types/react-tool-call-renderer.d.ts
+interface ReactToolCallRenderer<T = unknown> {
+  name: string;
+  args: StandardSchemaV1<any, T>;
+  /**
+   * Optional agent ID to constrain this tool renderer to a specific agent.
+   * If specified, this renderer will only be used for the specified agent.
+   */
+  agentId?: string;
+  render: React.ComponentType<{
+    name: string;
+    toolCallId: string;
+    args: Partial<T>;
+    status: ToolCallStatus.InProgress;
+    result: undefined;
+  } | {
+    name: string;
+    toolCallId: string;
+    args: T;
+    status: ToolCallStatus.Executing;
+    result: undefined;
+  } | {
+    name: string;
+    toolCallId: string;
+    args: T;
+    status: ToolCallStatus.Complete;
+    result: string;
+  }>;
+}
+//#endregion
+//#region src/v2/types/react-activity-message-renderer.d.ts
+interface ReactActivityMessageRenderer<TActivityContent> {
+  /**
+   * Activity type to match when rendering. Use "*" as a wildcard renderer.
+   */
+  activityType: string;
+  /**
+   * Optional agent ID to scope the renderer to a particular agent.
+   */
+  agentId?: string;
+  /**
+   * Schema describing the activity content payload.
+   */
+  content: StandardSchemaV1<any, TActivityContent>;
+  /**
+   * React component invoked to render the activity message.
+   */
+  render: React.ComponentType<{
+    activityType: string;
+    content: TActivityContent;
+    message: ActivityMessage;
+    agent: AbstractAgent | undefined;
+  }>;
+}
+//#endregion
+//#region src/v2/types/react-custom-message-renderer.d.ts
+type ReactCustomMessageRendererPosition = "before" | "after";
+interface ReactCustomMessageRenderer {
+  agentId?: string;
+  render: React.ComponentType<{
+    message: Message;
+    position: ReactCustomMessageRendererPosition;
+    runId: string;
+    messageIndex: number;
+    messageIndexInRun: number;
+    numberOfMessagesInRun: number;
+    agentId: string;
+    stateSnapshot: any;
+  }> | null;
+}
+//#endregion
+//#region src/v2/types/frontend-tool.d.ts
+type ReactFrontendTool<T extends Record<string, unknown> = Record<string, unknown>> = FrontendTool<T> & {
+  render?: ReactToolCallRenderer<T>["render"];
+};
+//#endregion
+//#region src/v2/types/human-in-the-loop.d.ts
+type ReactHumanInTheLoop<T extends Record<string, unknown> = Record<string, unknown>> = Omit<FrontendTool<T>, "handler"> & {
+  render: React$1.ComponentType<{
+    name: string;
+    description: string;
+    args: Partial<T>;
+    status: ToolCallStatus.InProgress;
+    result: undefined;
+    respond: undefined;
+  } | {
+    name: string;
+    description: string;
+    args: T;
+    status: ToolCallStatus.Executing;
+    result: undefined;
+    respond: (result: unknown) => Promise<void>;
+  } | {
+    name: string;
+    description: string;
+    args: T;
+    status: ToolCallStatus.Complete;
+    result: string;
+    respond: undefined;
+  }>;
+};
+//#endregion
+//#region src/v2/types/interrupt.d.ts
+interface InterruptEvent<TValue = unknown> {
+  name: string;
+  value: TValue;
+}
+interface InterruptHandlerProps<TValue = unknown> {
+  event: InterruptEvent<TValue>;
+  resolve: (response: unknown) => void;
+}
+interface InterruptRenderProps<TValue = unknown, TResult = unknown> {
+  event: InterruptEvent<TValue>;
+  result: TResult;
+  resolve: (response: unknown) => void;
+}
+//#endregion
+//#region src/v2/lib/react-core.d.ts
+interface CopilotKitCoreReactConfig extends CopilotKitCoreConfig {
+  renderToolCalls?: ReactToolCallRenderer<any>[];
+  renderActivityMessages?: ReactActivityMessageRenderer<any>[];
+  renderCustomMessages?: ReactCustomMessageRenderer[];
+}
+interface CopilotKitCoreReactSubscriber extends CopilotKitCoreSubscriber {
+  onRenderToolCallsChanged?: (event: {
+    copilotkit: CopilotKitCore;
+    renderToolCalls: ReactToolCallRenderer<any>[];
+  }) => void | Promise<void>;
+  onInterruptElementChanged?: (event: {
+    copilotkit: CopilotKitCore;
+    interruptElement: React$1.ReactElement | null;
+  }) => void | Promise<void>;
+}
+declare class CopilotKitCoreReact extends CopilotKitCore {
+  private _renderToolCalls;
+  private _hookRenderToolCalls;
+  private _cachedMergedRenderToolCalls;
+  private _renderCustomMessages;
+  private _renderActivityMessages;
+  private _interruptElement;
+  constructor(config: CopilotKitCoreReactConfig);
+  get renderCustomMessages(): Readonly<ReactCustomMessageRenderer[]>;
+  get renderActivityMessages(): Readonly<ReactActivityMessageRenderer<any>>[];
+  get renderToolCalls(): Readonly<ReactToolCallRenderer<any>>[];
+  setRenderActivityMessages(renderers: ReactActivityMessageRenderer<any>[]): void;
+  setRenderCustomMessages(renderers: ReactCustomMessageRenderer[]): void;
+  setRenderToolCalls(renderToolCalls: ReactToolCallRenderer<any>[]): void;
+  addHookRenderToolCall(entry: ReactToolCallRenderer<any>): void;
+  removeHookRenderToolCall(name: string, agentId?: string): void;
+  private _notifyRenderToolCallsChanged;
+  get interruptElement(): React$1.ReactElement | null;
+  setInterruptElement(element: React$1.ReactElement | null): void;
+  subscribe(subscriber: CopilotKitCoreReactSubscriber): CopilotKitCoreSubscription;
+  /**
+   * Wait for pending React state updates before the follow-up agent run.
+   *
+   * When a frontend tool handler calls setState(), React 18 batches the update
+   * and schedules a commit via its internal scheduler (MessageChannel). The
+   * useAgentContext hook registers context via useLayoutEffect, which runs
+   * synchronously after React commits that batch.
+   *
+   * Awaiting a zero-delay timeout yields to the macrotask queue. React's
+   * MessageChannel task runs first, committing the pending state and running
+   * useLayoutEffect (which updates the context store). The follow-up runAgent
+   * call then reads fresh context.
+   */
+  waitForPendingFrameworkUpdates(): Promise<void>;
+}
+//#endregion
+//#region src/v2/providers/CopilotChatConfigurationProvider.d.ts
+declare const CopilotChatDefaultLabels: {
+  chatInputPlaceholder: string;
+  chatInputToolbarStartTranscribeButtonLabel: string;
+  chatInputToolbarCancelTranscribeButtonLabel: string;
+  chatInputToolbarFinishTranscribeButtonLabel: string;
+  chatInputToolbarAddButtonLabel: string;
+  chatInputToolbarToolsButtonLabel: string;
+  assistantMessageToolbarCopyCodeLabel: string;
+  assistantMessageToolbarCopyCodeCopiedLabel: string;
+  assistantMessageToolbarCopyMessageLabel: string;
+  assistantMessageToolbarThumbsUpLabel: string;
+  assistantMessageToolbarThumbsDownLabel: string;
+  assistantMessageToolbarReadAloudLabel: string;
+  assistantMessageToolbarRegenerateLabel: string;
+  userMessageToolbarCopyMessageLabel: string;
+  userMessageToolbarEditMessageLabel: string;
+  chatDisclaimerText: string;
+  chatToggleOpenLabel: string;
+  chatToggleCloseLabel: string;
+  modalHeaderTitle: string;
+  welcomeMessageText: string;
+};
+type CopilotChatLabels = typeof CopilotChatDefaultLabels;
+interface CopilotChatConfigurationValue {
+  labels: CopilotChatLabels;
+  agentId: string;
+  threadId: string;
+  isModalOpen: boolean;
+  setModalOpen: (open: boolean) => void;
+  hasExplicitThreadId: boolean;
+}
+interface CopilotChatConfigurationProviderProps {
+  children: ReactNode;
+  labels?: Partial<CopilotChatLabels>;
+  agentId?: string;
+  threadId?: string;
+  hasExplicitThreadId?: boolean;
+  isModalDefaultOpen?: boolean;
+}
+declare const CopilotChatConfigurationProvider: React$1.FC<CopilotChatConfigurationProviderProps>;
+declare const useCopilotChatConfiguration: () => CopilotChatConfigurationValue | null;
+//#endregion
+//#region src/v2/hooks/use-agent.d.ts
+declare enum UseAgentUpdate {
+  OnMessagesChanged = "OnMessagesChanged",
+  OnStateChanged = "OnStateChanged",
+  OnRunStatusChanged = "OnRunStatusChanged"
+}
+interface UseAgentProps {
+  agentId?: string;
+  updates?: UseAgentUpdate[];
+  /**
+   * Throttle interval (in milliseconds) for re-renders triggered by
+   * `onMessagesChanged` and `onStateChanged` notifications. Useful to reduce
+   * re-render frequency during high-frequency streaming updates.
+   *
+   * Uses a leading+trailing pattern with a shared window — first update
+   * fires immediately, subsequent updates within the window are coalesced,
+   * and a trailing timer ensures the most recent update fires after the
+   * window expires. See `CopilotKitCore.subscribeToAgentWithOptions` in `@copilotkit/core`
+   * for details.
+   *
+   * Resolved as: `throttleMs ?? provider defaultThrottleMs ?? 0`.
+   * Passing `throttleMs={0}` explicitly disables throttling even when the
+   * provider specifies a non-zero `defaultThrottleMs`.
+   *
+   * Run lifecycle callbacks (`onRunInitialized`, `onRunFinalized`,
+   * `onRunFailed`, `onRunErrorEvent`) always fire immediately.
+   *
+   * @default undefined
+   * When unset, inherits from the provider's `defaultThrottleMs`;
+   * if that is also unset, the effective value is `0` (no throttle).
+   */
+  throttleMs?: number;
+}
+declare function useAgent({
+  agentId,
+  updates,
+  throttleMs
+}?: UseAgentProps): {
+  agent: AbstractAgent;
+};
+//#endregion
+//#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-component.d.ts
+type InferRenderProps<T> = T extends StandardSchemaV1 ? InferSchemaOutput<T> : any;
+/**
+ * Registers a React component as a frontend tool renderer in chat.
+ *
+ * This hook is a convenience wrapper around `useFrontendTool` that:
+ * - builds a model-facing tool description,
+ * - forwards optional schema parameters (any Standard Schema V1 compatible library),
+ * - renders your component with tool call parameters.
+ *
+ * Use this when you want to display a typed visual component for a tool call
+ * without manually wiring a full frontend tool object.
+ *
+ * When `parameters` is provided, render props are inferred from the schema.
+ * When omitted, the render component may accept any props.
+ *
+ * @typeParam TSchema - Schema describing tool parameters, or `undefined` when no schema is given.
+ * @param config - Tool registration config.
+ * @param deps - Optional dependencies to refresh registration (same semantics as `useEffect`).
+ *
+ * @example
+ * ```tsx
+ * // Without parameters — render accepts any props
+ * useComponent({
+ *   name: "showGreeting",
+ *   render: ({ message }: { message: string }) => <div>{message}</div>,
+ * });
+ * ```
+ *
+ * @example
+ * ```tsx
+ * // With parameters — render props inferred from schema
+ * useComponent({
+ *   name: "showWeatherCard",
+ *   parameters: z.object({ city: z.string() }),
+ *   render: ({ city }) => <div>{city}</div>,
+ * });
+ * ```
+ *
+ * @example
+ * ```tsx
+ * useComponent(
+ *   {
+ *     name: "renderProfile",
+ *     parameters: z.object({ userId: z.string() }),
+ *     render: ProfileCard,
+ *     agentId: "support-agent",
+ *   },
+ *   [selectedAgentId],
+ * );
+ * ```
+ */
+declare function useComponent<TSchema extends StandardSchemaV1 | undefined = undefined>(config: {
+  name: string;
+  description?: string;
+  parameters?: TSchema;
+  render: ComponentType<NoInfer<InferRenderProps<TSchema>>>;
+  agentId?: string;
+}, deps?: ReadonlyArray<unknown>): void;
+//#endregion
+//#region src/v2/hooks/use-human-in-the-loop.d.ts
+declare function useHumanInTheLoop<T extends Record<string, unknown> = Record<string, unknown>>(tool: ReactHumanInTheLoop<T>, deps?: ReadonlyArray<unknown>): void;
+//#endregion
+//#region src/v2/hooks/use-interrupt.d.ts
+type InterruptHandlerFn<TValue, TResult> = (props: InterruptHandlerProps<TValue>) => TResult | PromiseLike<TResult>;
+type InterruptResultFromHandler<THandler> = THandler extends ((...args: never[]) => infer TResult) ? TResult extends PromiseLike<infer TResolved> ? TResolved | null : TResult | null : null;
+type InterruptResult<TValue, TResult> = InterruptResultFromHandler<InterruptHandlerFn<TValue, TResult>>;
+type InterruptRenderInChat = boolean | undefined;
+type UseInterruptReturn<TRenderInChat extends InterruptRenderInChat> = TRenderInChat extends false ? React$1.ReactElement | null : TRenderInChat extends true | undefined ? void : React$1.ReactElement | null | void;
+/**
+ * Configuration options for `useInterrupt`.
+ */
+interface UseInterruptConfigBase<TValue = unknown, TResult = never> {
+  /**
+   * Render function for the interrupt UI.
+   *
+   * This is called once an interrupt is finalized and accepted by `enabled` (if provided).
+   * Use `resolve` from render props to resume the agent run with user input.
+   */
+  render: (props: InterruptRenderProps<TValue, InterruptResult<TValue, TResult>>) => React$1.ReactElement;
+  /**
+   * Optional pre-render handler invoked when an interrupt is received.
+   *
+   * Return either a sync value or an async value to pass into `render` as `result`.
+   * Rejecting/throwing falls back to `result = null`.
+   */
+  handler?: InterruptHandlerFn<TValue, TResult>;
+  /**
+   * Optional predicate to filter which interrupts should be handled by this hook.
+   * Return `false` to ignore an interrupt.
+   */
+  enabled?: (event: InterruptEvent<TValue>) => boolean;
+  /** Optional agent id. Defaults to the current configured chat agent. */
+  agentId?: string;
+}
+type UseInterruptConfig<TValue = unknown, TResult = never, TRenderInChat extends InterruptRenderInChat = undefined> = UseInterruptConfigBase<TValue, TResult> & {
+  /** When true (default), the interrupt UI renders inside `<CopilotChat>` automatically. Set to false to render it yourself. */renderInChat?: TRenderInChat;
+};
+/**
+ * Handles agent interrupts (`on_interrupt`) with optional filtering, preprocessing, and resume behavior.
+ *
+ * The hook listens to custom events on the active agent, stores interrupt payloads per run,
+ * and surfaces a render callback once the run finalizes. Call `resolve` from your UI to resume
+ * execution with user-provided data.
+ *
+ * - `renderInChat: true` (default): the element is published into `<CopilotChat>` and this hook returns `void`.
+ * - `renderInChat: false`: the hook returns the interrupt element so you can place it anywhere in your component tree.
+ *
+ * `event.value` is typed as `any` since the interrupt payload shape depends on your agent.
+ * Type-narrow it in your callbacks (e.g. `handler`, `enabled`, `render`) as needed.
+ *
+ * @typeParam TResult - Inferred from `handler` return type. Exposed as `result` in `render`.
+ * @param config - Interrupt configuration (renderer, optional handler/filter, and render mode).
+ * @returns When `renderInChat` is `false`, returns the interrupt element (or `null` when idle).
+ * Otherwise returns `void` and publishes the element into chat. In `render`, `result` is always
+ * either the handler's resolved return value or `null` (including when no handler is provided,
+ * when filtering skips the interrupt, or when handler execution fails).
+ *
+ * @example
+ * ```tsx
+ * import { useInterrupt } from "@copilotkit/react-core/v2";
+ *
+ * function InterruptUI() {
+ *   useInterrupt({
+ *     render: ({ event, resolve }) => (
+ *       <div>
+ *         <p>{event.value.question}</p>
+ *         <button onClick={() => resolve({ approved: true })}>Approve</button>
+ *         <button onClick={() => resolve({ approved: false })}>Reject</button>
+ *       </div>
+ *     ),
+ *   });
+ *
+ *   return null;
+ * }
+ * ```
+ *
+ * @example
+ * ```tsx
+ * import { useInterrupt } from "@copilotkit/react-core/v2";
+ *
+ * function CustomPanel() {
+ *   const interruptElement = useInterrupt({
+ *     renderInChat: false,
+ *     enabled: (event) => event.value.startsWith("approval:"),
+ *     handler: async ({ event }) => ({ label: event.value.toUpperCase() }),
+ *     render: ({ event, result, resolve }) => (
+ *       <aside>
+ *         <strong>{result?.label ?? ""}</strong>
+ *         <button onClick={() => resolve({ value: event.value })}>Continue</button>
+ *       </aside>
+ *     ),
+ *   });
+ *
+ *   return <>{interruptElement}</>;
+ * }
+ * ```
+ */
+declare function useInterrupt<TResult = never, TRenderInChat extends InterruptRenderInChat = undefined>(config: UseInterruptConfig<any, TResult, TRenderInChat>): UseInterruptReturn<TRenderInChat>;
+//#endregion
+//#region src/v2/hooks/use-suggestions.d.ts
+interface UseSuggestionsOptions {
+  agentId?: string;
+}
+interface UseSuggestionsResult {
+  suggestions: Suggestion[];
+  reloadSuggestions: () => void;
+  clearSuggestions: () => void;
+  isLoading: boolean;
+}
+declare function useSuggestions({
+  agentId
+}?: UseSuggestionsOptions): UseSuggestionsResult;
+//#endregion
+//#region src/v2/hooks/use-configure-suggestions.d.ts
+type StaticSuggestionInput = Omit<Suggestion, "isLoading"> & Partial<Pick<Suggestion, "isLoading">>;
+type StaticSuggestionsConfigInput = Omit<StaticSuggestionsConfig, "suggestions"> & {
+  suggestions: StaticSuggestionInput[];
+};
+type SuggestionsConfigInput = DynamicSuggestionsConfig | StaticSuggestionsConfigInput;
+declare function useConfigureSuggestions(config: SuggestionsConfigInput | null | undefined, deps?: ReadonlyArray<unknown>): void;
+//#endregion
+//#region src/v2/hooks/use-agent-context.d.ts
+/**
+ * Represents any value that can be serialized to JSON.
+ */
+type JsonSerializable = string | number | boolean | null | JsonSerializable[] | {
+  [key: string]: JsonSerializable;
+};
+/**
+ * Context configuration for useAgentContext.
+ * Accepts any JSON-serializable value which will be converted to a string.
+ */
+interface AgentContextInput {
+  /** A human-readable description of what this context represents */
+  description: string;
+  /** The context value - will be converted to a JSON string if not already a string */
+  value: JsonSerializable;
+}
+declare function useAgentContext(context: AgentContextInput): void;
+//#endregion
+//#region src/v2/hooks/use-threads.d.ts
+/**
+ * A conversation thread managed by the Intelligence platform.
+ *
+ * Each thread has a unique `id`, an optional human-readable `name`, and
+ * timestamp fields tracking creation and update times.
+ */
+interface Thread {
+  id: string;
+  agentId: string;
+  name: string | null;
+  archived: boolean;
+  createdAt: string;
+  updatedAt: string;
+  /**
+   * ISO-8601 timestamp of the most recent agent run on this thread. Absent
+   * when the thread has never been run. Prefer this over `updatedAt` for
+   * user-facing "last activity" displays — it is not bumped by metadata-only
+   * actions like rename or archive.
+   */
+  lastRunAt?: string;
+}
+/**
+ * Configuration for the {@link useThreads} hook.
+ *
+ * Thread operations are scoped to the runtime-authenticated user and the
+ * provided agent on the Intelligence platform.
+ */
+interface UseThreadsInput {
+  /** The ID of the agent whose threads to list and manage. */
+  agentId: string;
+  /** When `true`, archived threads are included in the list. Defaults to `false`. */
+  includeArchived?: boolean;
+  /** Maximum number of threads to fetch per page. When set, enables cursor-based pagination. */
+  limit?: number;
+}
+/**
+ * Return value of the {@link useThreads} hook.
+ *
+ * The `threads` array is kept in sync with the platform via a realtime
+ * WebSocket subscription (when available) and is sorted most-recently-updated
+ * first. Mutations reject with an `Error` if the platform request fails.
+ */
+interface UseThreadsResult {
+  /**
+   * Threads for the current user/agent pair, sorted by most recently
+   * updated first. Updated in realtime when the platform pushes metadata
+   * events. Includes archived threads only when `includeArchived` is set.
+   */
+  threads: Thread[];
+  /**
+   * `true` while the initial thread list is being fetched from the platform.
+   * Subsequent realtime updates do not re-enter the loading state.
+   */
+  isLoading: boolean;
+  /**
+   * The most recent error from fetching threads or executing a mutation,
+   * or `null` when there is no error. Reset to `null` on the next
+   * successful fetch.
+   */
+  error: Error | null;
+  /**
+   * `true` when there are more threads available to fetch via
+   * {@link fetchMoreThreads}. Only meaningful when `limit` is set.
+   */
+  hasMoreThreads: boolean;
+  /**
+   * `true` while a subsequent page of threads is being fetched.
+   */
+  isFetchingMoreThreads: boolean;
+  /**
+   * Fetch the next page of threads. No-op when {@link hasMoreThreads} is
+   * `false` or a fetch is already in progress.
+   */
+  fetchMoreThreads: () => void;
+  /**
+   * Rename a thread on the platform.
+   * Resolves when the server confirms the update; rejects on failure.
+   */
+  renameThread: (threadId: string, name: string) => Promise<void>;
+  /**
+   * Archive a thread on the platform.
+   * Archived threads are excluded from subsequent list results.
+   * Resolves when the server confirms the update; rejects on failure.
+   */
+  archiveThread: (threadId: string) => Promise<void>;
+  /**
+   * Permanently delete a thread from the platform.
+   * This is irreversible. Resolves when the server confirms deletion;
+   * rejects on failure.
+   */
+  deleteThread: (threadId: string) => Promise<void>;
+}
+/**
+ * React hook for listing and managing Intelligence platform threads.
+ *
+ * On mount the hook fetches the thread list for the runtime-authenticated user
+ * and the given `agentId`. When the Intelligence platform exposes a WebSocket
+ * URL, it also opens a realtime subscription so the `threads` array stays
+ * current without polling — thread creates, renames, archives, and deletes
+ * from any client are reflected immediately.
+ *
+ * Mutation methods (`renameThread`, `archiveThread`, `deleteThread`) return
+ * promises that resolve once the platform confirms the operation and reject
+ * with an `Error` on failure.
+ *
+ * @param input - Agent identifier and optional list controls.
+ * @returns Thread list state and stable mutation callbacks.
+ *
+ * @example
+ * ```tsx
+ * import { useThreads } from "@copilotkit/react-core";
+ *
+ * function ThreadList() {
+ *   const { threads, isLoading, renameThread, deleteThread } = useThreads({
+ *     agentId: "agent-1",
+ *   });
+ *
+ *   if (isLoading) return <p>Loading…</p>;
+ *
+ *   return (
+ *     <ul>
+ *       {threads.map((t) => (
+ *         <li key={t.id}>
+ *           {t.name ?? "Untitled"}
+ *           <button onClick={() => renameThread(t.id, "New name")}>Rename</button>
+ *           <button onClick={() => deleteThread(t.id)}>Delete</button>
+ *         </li>
+ *       ))}
+ *     </ul>
+ *   );
+ * }
+ * ```
+ */
+declare function useThreads({
+  agentId,
+  includeArchived,
+  limit
+}: UseThreadsInput): UseThreadsResult;
+//#endregion
+export { type AgentContextInput, CopilotChatConfigurationProvider, type CopilotChatConfigurationProviderProps, type CopilotChatConfigurationValue, CopilotChatDefaultLabels, type CopilotChatLabels, CopilotKitCoreReact, type CopilotKitCoreReactConfig, type JsonSerializable, type Thread, type UseAgentUpdate, type UseInterruptConfig, type UseThreadsInput, type UseThreadsResult, useAgent, useAgentContext, useComponent, useConfigureSuggestions, useCopilotChatConfiguration, useFrontendTool, useHumanInTheLoop, useInterrupt, useSuggestions, useThreads };
+//# sourceMappingURL=headless.d.cts.map

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

@@ -0,0 +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/interrupt.ts","../../src/v2/lib/react-core.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"],"mappings":";;;;;;;UAGiB,qBAAA;EACf,IAAA;EACA,IAAA,EAAM,gBAAA,MAAsB,CAAA;;;AAF9B;;EAOE,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;;;UC3BS,4BAAA;;;;EAIf,YAAA;EDLoC;;;ECSpC,OAAA;EDGoB;;;ECCpB,OAAA,EAAS,gBAAA,MAAsB,gBAAA;EDOjB;;;ECHd,MAAA,EAAQ,KAAA,CAAM,aAAA;IACZ,YAAA;IACA,OAAA,EAAS,gBAAA;IACT,OAAA,EAAS,eAAA;IACT,KAAA,EAAO,aAAA;EAAA;AAAA;;;KCtBC,kCAAA;AAAA,UAEK,0BAAA;EACf,OAAA;EACA,MAAA,EAAQ,KAAA,CAAM,aAAA;IACZ,OAAA,EAAS,OAAA;IACT,QAAA,EAAU,kCAAA;IACV,KAAA;IACA,YAAA;IACA,iBAAA;IACA,qBAAA;IACA,OAAA;IACA,aAAA;EAAA;AAAA;;;KCXQ,iBAAA,WACA,MAAA,oBAA0B,MAAA,qBAClC,YAAA,CAAa,CAAA;EACf,MAAA,GAAS,qBAAA,CAAsB,CAAA;AAAA;;;KCHrB,mBAAA,WACA,MAAA,oBAA0B,MAAA,qBAClC,IAAA,CAAK,YAAA,CAAa,CAAA;EACpB,MAAA,EAAQ,OAAA,CAAM,aAAA;IAER,IAAA;IACA,WAAA;IACA,IAAA,EAAM,OAAA,CAAQ,CAAA;IACd,MAAA,EAAQ,cAAA,CAAe,UAAA;IACvB,MAAA;IACA,OAAA;EAAA;IAGA,IAAA;IACA,WAAA;IACA,IAAA,EAAM,CAAA;IACN,MAAA,EAAQ,cAAA,CAAe,SAAA;IACvB,MAAA;IACA,OAAA,GAAU,MAAA,cAAoB,OAAA;EAAA;IAG9B,IAAA;IACA,WAAA;IACA,IAAA,EAAM,CAAA;IACN,MAAA,EAAQ,cAAA,CAAe,QAAA;IACvB,MAAA;IACA,OAAA;EAAA;AAAA;;;UC7BS,cAAA;EACf,IAAA;EACA,KAAA,EAAO,MAAA;AAAA;AAAA,UAGQ,qBAAA;EACf,KAAA,EAAO,cAAA,CAAe,MAAA;EACtB,OAAA,GAAU,QAAA;AAAA;AAAA,UAGK,oBAAA;EACf,KAAA,EAAO,cAAA,CAAe,MAAA;EACtB,MAAA,EAAQ,OAAA;EACR,OAAA,GAAU,QAAA;AAAA;;;UCHK,yBAAA,SAAkC,oBAAA;EAEjD,eAAA,GAAkB,qBAAA;EAClB,sBAAA,GAAyB,4BAAA;EAGzB,oBAAA,GAAuB,0BAAA;AAAA;AAAA,UAGR,6BAAA,SAAsC,wBAAA;EACrD,wBAAA,IAA4B,KAAA;IAC1B,UAAA,EAAY,cAAA;IACZ,eAAA,EAAiB,qBAAA;EAAA,aACN,OAAA;EACb,yBAAA,IAA6B,KAAA;IAC3B,UAAA,EAAY,cAAA;IACZ,gBAAA,EAAkB,OAAA,CAAM,YAAA;EAAA,aACb,OAAA;AAAA;AAAA,cAGF,mBAAA,SAA4B,cAAA;EAAA,QAC/B,gBAAA;EAAA,QACA,oBAAA;EAAA,QAEA,4BAAA;EAAA,QAEA,qBAAA;EAAA,QACA,uBAAA;EAAA,QACA,iBAAA;cAEI,MAAA,EAAQ,yBAAA;EAAA,IAOhB,oBAAA,CAAA,GAAwB,QAAA,CAAS,0BAAA;EAAA,IAIjC,sBAAA,CAAA,GAA0B,QAAA,CAAS,4BAAA;EAAA,IAInC,eAAA,CAAA,GAAmB,QAAA,CAAS,qBAAA;EAmBhC,yBAAA,CACE,SAAA,EAAW,4BAAA;EAKb,uBAAA,CAAwB,SAAA,EAAW,0BAAA;EAInC,kBAAA,CAAmB,eAAA,EAAiB,qBAAA;EAMpC,qBAAA,CAAsB,KAAA,EAAO,qBAAA;EAO7B,wBAAA,CAAyB,IAAA,UAAc,OAAA;EAAA,QAQ/B,6BAAA;EAAA,IAYJ,gBAAA,CAAA,GAAoB,OAAA,CAAM,YAAA;EAI9B,mBAAA,CAAoB,OAAA,EAAS,OAAA,CAAM,YAAA;EAYnC,SAAA,CACE,UAAA,EAAY,6BAAA,GACX,0BAAA;ENtHG;;;;;;;;;;;;;EMuIA,8BAAA,CAAA,GAAkC,OAAA;AAAA;;;cC1I7B,wBAAA;;;;;;;;;;;;;;;;;;;;;;KAwBD,iBAAA,UAA2B,wBAAA;AAAA,UAGtB,6BAAA;EACf,MAAA,EAAQ,iBAAA;EACR,OAAA;EACA,QAAA;EACA,WAAA;EACA,YAAA,GAAe,IAAA;EAKf,mBAAA;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,cAoHW,2BAAA,QACP,6BAAA;;;aCtLM,cAAA;EACV,iBAAA;EACA,cAAA;EACA,kBAAA;AAAA;AAAA,UASe,aAAA;EACf,OAAA;EACA,OAAA,GAAU,cAAA;ERrB0B;;;;;;;;;;;;;;;;;;;;;;EQ4CpC,UAAA;AAAA;AAAA,iBAGc,QAAA,CAAA;EAAW,OAAA;EAAS,OAAA;EAAS;AAAA,IAAc,aAAA;;;;;iBC5C3C,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;;;;;AVFtB;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;iBUuDgB,YAAA,iBACE,gBAAA,yBAAA,CAEhB,MAAA;EACE,IAAA;EACA,WAAA;EACA,UAAA,GAAa,OAAA;EACb,MAAA,EAAQ,aAAA,CAAc,OAAA,CAAQ,gBAAA,CAAiB,OAAA;EAC/C,OAAA;AAAA,GAEF,IAAA,GAAO,aAAA;;;iBC5DO,iBAAA,WACJ,MAAA,oBAA0B,MAAA,kBAAA,CACpC,IAAA,EAAM,mBAAA,CAAoB,CAAA,GAAI,IAAA,GAAO,aAAA;;;KCSlC,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;;;;UAeJ,sBAAA;EZ1CI;;;;;;EYiDZ,MAAA,GACE,KAAA,EAAO,oBAAA,CAAqB,MAAA,EAAQ,eAAA,CAAgB,MAAA,EAAQ,OAAA,OACzD,OAAA,CAAM,YAAA;EZvDgB;;;;;;EY8D3B,OAAA,GAAU,kBAAA,CAAmB,MAAA,EAAQ,OAAA;EZ/DrC;;;;EYoEA,OAAA,IAAW,KAAA,EAAO,cAAA,CAAe,MAAA;EZhE3B;EYkEN,OAAA;AAAA;AAAA,KA2BU,kBAAA,0DAGY,qBAAA,gBACpB,sBAAA,CAAuB,MAAA,EAAQ,OAAA;EZpF3B,8HYsFN,YAAA,GAAe,aAAA;AAAA;;;;;;;;;;;AX7GjB;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;ACFA;;;;;AAEA;;;;;;;;;;;;;iBU6KgB,YAAA,wCAEQ,qBAAA,aAAA,CAEtB,MAAA,EAAQ,kBAAA,MAAwB,OAAA,EAAS,aAAA,IACxC,kBAAA,CAAmB,aAAA;;;UChLL,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;;AfTrB;;;UeeiB,iBAAA;EfbT;EeeN,WAAA;EfLY;EeOZ,KAAA,EAAO,gBAAA;AAAA;AAAA,iBAGO,eAAA,CAAgB,OAAA,EAAS,iBAAA;;;;;;;;;UCCxB,MAAA;EACf,EAAA;EACA,OAAA;EACA,IAAA;EACA,QAAA;EACA,SAAA;EACA,SAAA;EhBjBY;;;;;;EgBwBZ,SAAA;AAAA;;;;;;;UASe,eAAA;EhBrCf;EgBuCA,OAAA;EhBvCc;EgByCd,eAAA;EhBtCM;EgBwCN,KAAA;AAAA;;;;;;;;UAUe,gBAAA;EhB1CH;;;;;EgBgDZ,OAAA,EAAS,MAAA;EhB1CH;;;;EgB+CN,SAAA;EhB7C6B;;;;;EgBmD7B,KAAA,EAAO,KAAA;;Af7ET;;;EekFE,cAAA;EftES;;;Ee0ET,qBAAA;EftEQ;;;;Ee2ER,gBAAA;EfnFA;;;;EewFA,YAAA,GAAe,QAAA,UAAkB,IAAA,aAAiB,OAAA;EfhF1C;;;;;EesFR,aAAA,GAAgB,QAAA,aAAqB,OAAA;EfnF1B;;;;;EeyFX,YAAA,GAAe,QAAA,aAAqB,OAAA;AAAA;;Ad9GtC;;;;;AAEA;;;;;;;;;;;;;;;;;;;;;;;;;;;ACDA;;;;;;;;iBayKgB,UAAA,CAAA;EACd,OAAA;EACA,eAAA;EACA;AAAA,GACC,eAAA,GAAkB,gBAAA"}