@liveblocks/react-ui 2.25.0-aiprivatebeta0 → 2.25.0-aiprivatebeta10

package/dist/icons/index.cjs

@@ -10,12 +10,15 @@ var BellCrossed = require('./BellCrossed.cjs');
 var Blockquote = require('./Blockquote.cjs');
 var Bold = require('./Bold.cjs');
 var Check = require('./Check.cjs');
+var CheckCircle = require('./CheckCircle.cjs');
+var CheckCircleFill = require('./CheckCircleFill.cjs');
 var ChevronDown = require('./ChevronDown.cjs');
 var ChevronLeft = require('./ChevronLeft.cjs');
 var ChevronRight = require('./ChevronRight.cjs');
 var ChevronUp = require('./ChevronUp.cjs');
 var Code = require('./Code.cjs');
 var Comment = require('./Comment.cjs');
+var Copy = require('./Copy.cjs');
 var Cross = require('./Cross.cjs');
 var Delete = require('./Delete.cjs');
 var Edit = require('./Edit.cjs');
@@ -32,9 +35,8 @@ var ListUnordered = require('./ListUnordered.cjs');
 var Mention = require('./Mention.cjs');
 var QuestionMark = require('./QuestionMark.cjs');
 var Redo = require('./Redo.cjs');
-var Resolve = require('./Resolve.cjs');
-var Resolved = require('./Resolved.cjs');
 var Restore = require('./Restore.cjs');
+var Retry = require('./Retry.cjs');
 var Search = require('./Search.cjs');
 var Send = require('./Send.cjs');
 var Shorten = require('./Shorten.cjs');
@@ -61,12 +63,15 @@ exports.BellCrossedIcon = BellCrossed.BellCrossedIcon;
 exports.BlockquoteIcon = Blockquote.BlockquoteIcon;
 exports.BoldIcon = Bold.BoldIcon;
 exports.CheckIcon = Check.CheckIcon;
+exports.CheckCircleIcon = CheckCircle.CheckCircleIcon;
+exports.CheckCircleFillIcon = CheckCircleFill.CheckCircleFillIcon;
 exports.ChevronDownIcon = ChevronDown.ChevronDownIcon;
 exports.ChevronLeftIcon = ChevronLeft.ChevronLeftIcon;
 exports.ChevronRightIcon = ChevronRight.ChevronRightIcon;
 exports.ChevronUpIcon = ChevronUp.ChevronUpIcon;
 exports.CodeIcon = Code.CodeIcon;
 exports.CommentIcon = Comment.CommentIcon;
+exports.CopyIcon = Copy.CopyIcon;
 exports.CrossIcon = Cross.CrossIcon;
 exports.DeleteIcon = Delete.DeleteIcon;
 exports.EditIcon = Edit.EditIcon;
@@ -83,9 +88,8 @@ exports.ListUnorderedIcon = ListUnordered.ListUnorderedIcon;
 exports.MentionIcon = Mention.MentionIcon;
 exports.QuestionMarkIcon = QuestionMark.QuestionMarkIcon;
 exports.RedoIcon = Redo.RedoIcon;
-exports.ResolveIcon = Resolve.ResolveIcon;
-exports.ResolvedIcon = Resolved.ResolvedIcon;
 exports.RestoreIcon = Restore.RestoreIcon;
+exports.RetryIcon = Retry.RetryIcon;
 exports.SearchIcon = Search.SearchIcon;
 exports.SendIcon = Send.SendIcon;
 exports.ShortenIcon = Shorten.ShortenIcon;

package/dist/icons/index.cjs.map

@@ -1 +1 @@
-{"version":3,"file":"index.cjs","sources":[],"sourcesContent":[],"names":[],"mappings":";;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;"}
+{"version":3,"file":"index.cjs","sources":[],"sourcesContent":[],"names":[],"mappings":";;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;"}

package/dist/icons/index.js

@@ -8,12 +8,15 @@ export { BellCrossedIcon } from './BellCrossed.js';
 export { BlockquoteIcon } from './Blockquote.js';
 export { BoldIcon } from './Bold.js';
 export { CheckIcon } from './Check.js';
+export { CheckCircleIcon } from './CheckCircle.js';
+export { CheckCircleFillIcon } from './CheckCircleFill.js';
 export { ChevronDownIcon } from './ChevronDown.js';
 export { ChevronLeftIcon } from './ChevronLeft.js';
 export { ChevronRightIcon } from './ChevronRight.js';
 export { ChevronUpIcon } from './ChevronUp.js';
 export { CodeIcon } from './Code.js';
 export { CommentIcon } from './Comment.js';
+export { CopyIcon } from './Copy.js';
 export { CrossIcon } from './Cross.js';
 export { DeleteIcon } from './Delete.js';
 export { EditIcon } from './Edit.js';
@@ -30,9 +33,8 @@ export { ListUnorderedIcon } from './ListUnordered.js';
 export { MentionIcon } from './Mention.js';
 export { QuestionMarkIcon } from './QuestionMark.js';
 export { RedoIcon } from './Redo.js';
-export { ResolveIcon } from './Resolve.js';
-export { ResolvedIcon } from './Resolved.js';
 export { RestoreIcon } from './Restore.js';
+export { RetryIcon } from './Retry.js';
 export { SearchIcon } from './Search.js';
 export { SendIcon } from './Send.js';
 export { ShortenIcon } from './Shorten.js';

package/dist/icons/index.js.map

@@ -1 +1 @@
-{"version":3,"file":"index.js","sources":[],"sourcesContent":[],"names":[],"mappings":";;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;"}
+{"version":3,"file":"index.js","sources":[],"sourcesContent":[],"names":[],"mappings":";;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;"}

package/dist/index.cjs

@@ -2,7 +2,8 @@
 
 var core = require('@liveblocks/core');
 var version = require('./version.cjs');
-var AiChat = require('./components/AiChat/AiChat.cjs');
+var AiChat = require('./components/AiChat.cjs');
+var AiTool = require('./components/AiTool.cjs');
 var Comment = require('./components/Comment.cjs');
 var Composer = require('./components/Composer.cjs');
 var HistoryVersionSummary = require('./components/HistoryVersionSummary.cjs');
@@ -17,6 +18,7 @@ var overrides = require('./overrides.cjs');
 core.detectDupes(version.PKG_NAME, version.PKG_VERSION, version.PKG_FORMAT);
 
 exports.AiChat = AiChat.AiChat;
+exports.AiTool = AiTool.AiTool;
 exports.Comment = Comment.Comment;
 exports.Composer = Composer.Composer;
 exports.HistoryVersionSummary = HistoryVersionSummary.HistoryVersionSummary;

package/dist/index.cjs.map

@@ -1 +1 @@
-{"version":3,"file":"index.cjs","sources":["../src/index.ts"],"sourcesContent":["import { detectDupes } from \"@liveblocks/core\";\n\nimport { PKG_FORMAT, PKG_NAME, PKG_VERSION } from \"./version\";\n\ndetectDupes(PKG_NAME, PKG_VERSION, PKG_FORMAT);\n\nexport { AiChat, type AiChatProps } from \"./components/AiChat/AiChat\";\nexport type { CommentProps } from \"./components/Comment\";\nexport { Comment } from \"./components/Comment\";\nexport type { ComposerProps } from \"./components/Composer\";\nexport { Composer } from \"./components/Composer\";\nexport type { HistoryVersionSummaryProps } from \"./components/HistoryVersionSummary\";\nexport { HistoryVersionSummary } from \"./components/HistoryVersionSummary\";\nexport type { HistoryVersionSummaryListProps } from \"./components/HistoryVersionSummaryList\";\nexport { HistoryVersionSummaryList } from \"./components/HistoryVersionSummaryList\";\nexport type {\n  InboxNotificationAvatarProps,\n  InboxNotificationCustomKindProps,\n  InboxNotificationCustomProps,\n  InboxNotificationIconProps,\n  InboxNotificationProps,\n  InboxNotificationTextMentionKindProps,\n  InboxNotificationTextMentionProps,\n  InboxNotificationThreadKindProps,\n  InboxNotificationThreadProps,\n} from \"./components/InboxNotification\";\nexport { InboxNotification } from \"./components/InboxNotification\";\nexport type { InboxNotificationListProps } from \"./components/InboxNotificationList\";\nexport { InboxNotificationList } from \"./components/InboxNotificationList\";\nexport type { ThreadProps } from \"./components/Thread\";\nexport { Thread } from \"./components/Thread\";\nexport { LiveblocksUIConfig } from \"./config\";\nexport * as Icon from \"./icon\";\nexport type {\n  ChatComposerOverrides,\n  CommentOverrides,\n  ComposerOverrides,\n  GlobalOverrides,\n  InboxNotificationOverrides,\n  LocalizationOverrides,\n  Overrides,\n  ThreadOverrides,\n} from \"./overrides\";\nexport { useOverrides } from \"./overrides\";\nexport type { ComposerSubmitComment } from \"./primitives\";\nexport type {\n  CommentAttachmentArgs,\n  ComposerBodyMark,\n  ComposerBodyMarks,\n} from \"./types\";\n"],"names":["detectDupes","PKG_NAME","PKG_VERSION","PKG_FORMAT"],"mappings":";;;;;;;;;;;;;;;;AAIAA,gBAAY,CAAAC,gBAAA,EAAUC,qBAAaC,kBAAU,CAAA;;;;;;;;;;;;;;"}
+{"version":3,"file":"index.cjs","sources":["../src/index.ts"],"sourcesContent":["import { detectDupes } from \"@liveblocks/core\";\n\nimport { PKG_FORMAT, PKG_NAME, PKG_VERSION } from \"./version\";\n\ndetectDupes(PKG_NAME, PKG_VERSION, PKG_FORMAT);\n\nexport type {\n  AiChatComponents,\n  AiChatComponentsEmptyProps,\n  AiChatComponentsLoadingProps,\n  AiChatProps,\n} from \"./components/AiChat\";\nexport { AiChat } from \"./components/AiChat\";\nexport type { AiToolIconProps, AiToolProps } from \"./components/AiTool\";\nexport { AiTool } from \"./components/AiTool\";\nexport type { CommentProps } from \"./components/Comment\";\nexport { Comment } from \"./components/Comment\";\nexport type { ComposerProps } from \"./components/Composer\";\nexport { Composer } from \"./components/Composer\";\nexport type { HistoryVersionSummaryProps } from \"./components/HistoryVersionSummary\";\nexport { HistoryVersionSummary } from \"./components/HistoryVersionSummary\";\nexport type { HistoryVersionSummaryListProps } from \"./components/HistoryVersionSummaryList\";\nexport { HistoryVersionSummaryList } from \"./components/HistoryVersionSummaryList\";\nexport type {\n  InboxNotificationAvatarProps,\n  InboxNotificationCustomKindProps,\n  InboxNotificationCustomProps,\n  InboxNotificationIconProps,\n  InboxNotificationProps,\n  InboxNotificationTextMentionKindProps,\n  InboxNotificationTextMentionProps,\n  InboxNotificationThreadKindProps,\n  InboxNotificationThreadProps,\n} from \"./components/InboxNotification\";\nexport { InboxNotification } from \"./components/InboxNotification\";\nexport type { InboxNotificationListProps } from \"./components/InboxNotificationList\";\nexport { InboxNotificationList } from \"./components/InboxNotificationList\";\nexport type { ThreadProps } from \"./components/Thread\";\nexport { Thread } from \"./components/Thread\";\nexport { LiveblocksUIConfig } from \"./config\";\nexport * as Icon from \"./icon\";\nexport type {\n  CommentOverrides,\n  ComposerOverrides,\n  GlobalOverrides,\n  InboxNotificationOverrides,\n  LocalizationOverrides,\n  Overrides,\n  ThreadOverrides,\n} from \"./overrides\";\nexport { useOverrides } from \"./overrides\";\nexport type { ComposerSubmitComment } from \"./primitives\";\nexport type {\n  CommentAttachmentArgs,\n  ComposerBodyMark,\n  ComposerBodyMarks,\n} from \"./types\";\n"],"names":["detectDupes","PKG_NAME","PKG_VERSION","PKG_FORMAT"],"mappings":";;;;;;;;;;;;;;;;;AAIAA,gBAAY,CAAAC,gBAAA,EAAUC,qBAAaC,kBAAU,CAAA;;;;;;;;;;;;;;;"}

package/dist/index.d.cts

@@ -1,8 +1,13 @@
 import * as react from 'react';
-import { ElementType, ComponentPropsWithoutRef, ReactNode, HTMLAttributes, FormEvent, ComponentType, RefAttributes, MouseEvent, ComponentProps, PropsWithChildren } from 'react';
-import { CommentAttachment, CopilotId, AiChatContext, ClientToolDefinition, CommentBody, BaseMetadata, DM, CommentData, HistoryVersion, InboxNotificationData, InboxNotificationThreadData, InboxNotificationTextMentionData, InboxNotificationCustomData, KDAD, ThreadData } from '@liveblocks/core';
+import { ComponentType, ComponentPropsWithoutRef, ElementType, ReactNode, ComponentProps, FormEvent, RefAttributes, MouseEvent, PropsWithChildren } from 'react';
+import { CommentAttachment, AiKnowledgeSource, AiOpaqueToolDefinition, AiToolTypePack, JsonObject, ToolResultData, NoInfr, AiToolExecuteCallback, CommentBody, BaseMetadata, DM, CommentData, HistoryVersion, InboxNotificationData, InboxNotificationThreadData, InboxNotificationTextMentionData, InboxNotificationCustomData, KDAD, ThreadData } from '@liveblocks/core';
 import * as react_jsx_runtime from 'react/jsx-runtime';
 
+interface GlobalComponents {
+    Anchor: ComponentType<ComponentPropsWithoutRef<"a">> | "a";
+}
+type Components = GlobalComponents;
+
 type Direction = "ltr" | "rtl";
 type SlotProp = {
     /**
@@ -73,21 +78,17 @@ interface ComposerOverrides {
     COMPOSER_SEND: string;
     COMPOSER_TOGGLE_MARK: (mark: ComposerBodyMark) => string;
 }
-interface ChatComposerOverrides {
-    CHAT_COMPOSER_PLACEHOLDER: string;
-    CHAT_COMPOSER_SEND: string;
-    CHAT_COMPOSER_ATTACH_FILES: string;
-    CHAT_COMPOSER_REMOVE_ATTACHMENT: string;
-    CHAT_COMPOSER_ABORT: string;
+interface AiChatComposerOverrides {
+    AI_CHAT_COMPOSER_PLACEHOLDER: string;
+    AI_CHAT_COMPOSER_SEND: string;
+    AI_CHAT_COMPOSER_ABORT: string;
 }
-interface ChatMessageOverrides {
-    CHAT_MESSAGE_DELETED: string;
-    CHAT_MESSAGE_THINKING: string;
-    CHAT_MESSAGE_COPY: string;
-    CHAT_MESSAGE_TRY_AGAIN: string;
+interface AiChatMessageOverrides {
+    AI_CHAT_MESSAGE_DELETED: string;
+    AI_CHAT_MESSAGE_THINKING: string;
 }
-interface ChatOverrides {
-    GET_CHAT_MESSAGES_ERROR: (error: Error) => ReactNode;
+interface AiChatOverrides {
+    AI_CHAT_MESSAGES_ERROR: (error: Error) => ReactNode;
 }
 interface ThreadOverrides {
     THREAD_RESOLVE: string;
@@ -113,53 +114,107 @@ interface HistoryVersionPreviewOverrides {
     HISTORY_VERSION_PREVIEW_EMPTY: ReactNode;
     HISTORY_VERSION_PREVIEW_ERROR: (error: Error) => ReactNode;
 }
-type Overrides = LocalizationOverrides & GlobalOverrides & ComposerOverrides & CommentOverrides & ThreadOverrides & InboxNotificationOverrides & HistoryVersionPreviewOverrides & ChatComposerOverrides & ChatMessageOverrides & ChatOverrides;
+type Overrides = LocalizationOverrides & GlobalOverrides & ComposerOverrides & CommentOverrides & ThreadOverrides & InboxNotificationOverrides & HistoryVersionPreviewOverrides & AiChatComposerOverrides & AiChatMessageOverrides & AiChatOverrides;
 declare function useOverrides(overrides?: Partial<Overrides>): Overrides;
 
-type AiChatProps = HTMLAttributes<HTMLDivElement> & {
+type AiChatComponentsEmptyProps = {
     /**
-     * The id of the chat the composer belongs to.
+     * The chat id provided to the `AiChat` component.
      */
     chatId: string;
     /**
-     * The id of the copilot to use to send the message.
-     */
-    copilotId?: CopilotId;
-    /**
-     * The contextual information to include in the chat. Used by the assistant when generating responses.
+     * The copilot id provided to the `AiChat` component.
      */
-    contexts?: AiChatContext[];
+    copilotId?: string;
+};
+type AiChatComponentsLoadingProps = Record<string, never>;
+type AiChatComponents = {
     /**
-     * The contextual information to include in the chat. Used by the assistant when generating responses.
+     * The component used to render the empty state of the chat.
      */
-    tools?: Record<string, ClientToolDefinition>;
+    Empty: ComponentType<AiChatComponentsEmptyProps>;
     /**
-     * Override the component's strings.
+     * The component used to render the loading state of the chat.
      */
-    overrides?: Partial<GlobalOverrides & ChatMessageOverrides & ChatComposerOverrides & ChatOverrides>;
+    Loading: ComponentType<AiChatComponentsLoadingProps>;
 };
-declare const AiChat: react.ForwardRefExoticComponent<HTMLAttributes<HTMLDivElement> & {
+interface AiChatProps extends ComponentProps<"div"> {
     /**
      * The id of the chat the composer belongs to.
      */
     chatId: string;
+    /**
+     * Whether to focus the chat composer on mount.
+     */
+    autoFocus?: boolean;
     /**
      * The id of the copilot to use to send the message.
      */
-    copilotId?: CopilotId;
+    copilotId?: string;
+    /**
+     * The contextual knowledge to include in the chat. May be used by the assistant when generating responses.
+     * Any knowledge you provide via this prop will be added to any already globally registered knowledge via <RegisterAiKnowledge />.
+     */
+    knowledge?: AiKnowledgeSource[];
     /**
-     * The contextual information to include in the chat. Used by the assistant when generating responses.
+     * Tool definitions to make available within this chat. May be used by the assistant when generating responses.
      */
-    contexts?: AiChatContext[];
+    tools?: Record<string, AiOpaqueToolDefinition>;
     /**
-     * The contextual information to include in the chat. Used by the assistant when generating responses.
+     * The layout of the chat and its composer.
      */
-    tools?: Record<string, ClientToolDefinition>;
+    layout?: "inset" | "compact";
     /**
      * Override the component's strings.
      */
-    overrides?: Partial<GlobalOverrides & ChatMessageOverrides & ChatComposerOverrides & ChatOverrides>;
-} & react.RefAttributes<HTMLDivElement>>;
+    overrides?: Partial<GlobalOverrides & AiChatMessageOverrides & AiChatComposerOverrides & AiChatOverrides>;
+    /**
+     * Override the component's components.
+     */
+    components?: Partial<GlobalComponents & AiChatComponents>;
+}
+declare const AiChat: react.ForwardRefExoticComponent<Omit<AiChatProps, "ref"> & react.RefAttributes<HTMLDivElement>>;
+
+interface AiToolProps extends Omit<ComponentProps<"div">, "title" | "children"> {
+    /**
+     * The tool's title.
+     *
+     * By default, a human-readable version of the tool's name is used:
+     * - `"showTodo"` → "Show todo"
+     * - `"get_weather"` → "Get weather"
+     */
+    title?: string;
+    /**
+     * An optional icon displayed next to the title.
+     */
+    icon?: ReactNode;
+    /**
+     * The content shown in the tool.
+     */
+    children?: ReactNode;
+}
+type AiToolIconProps = ComponentProps<"div">;
+type AiToolInspectorProps = ComponentProps<"div">;
+/**
+ * @private This API will change, and is not considered stable. DO NOT RELY on it.
+ *
+ * This component can be used to build human-in-the-loop interfaces.
+ */
+interface AiToolConfirmationProps<A extends JsonObject, R extends ToolResultData> extends ComponentProps<"div"> {
+    types?: NoInfr<AiToolTypePack<A, R>>;
+    args?: A;
+    confirm: AiToolExecuteCallback<A, R>;
+    cancel: AiToolExecuteCallback<A, R>;
+    variant?: "default" | "destructive";
+}
+declare function AiToolIcon({ className, ...props }: AiToolIconProps): react_jsx_runtime.JSX.Element;
+declare function AiToolInspector({ className, ...props }: AiToolInspectorProps): react_jsx_runtime.JSX.Element;
+declare function AiToolConfirmation<TPack extends AiToolTypePack, A extends JsonObject = TPack["A"], R extends ToolResultData = TPack["R"]>({ children, variant, confirm, cancel, className, ...props }: AiToolConfirmationProps<A, R>): react_jsx_runtime.JSX.Element | null;
+declare const AiTool: react.ForwardRefExoticComponent<Omit<AiToolProps, "ref"> & react.RefAttributes<HTMLDivElement>> & {
+    Icon: typeof AiToolIcon;
+    Inspector: typeof AiToolInspector;
+    Confirmation: typeof AiToolConfirmation;
+};
 
 interface ComposerEditorMentionProps {
     /**
@@ -214,7 +269,7 @@ interface ComposerEditorComponents {
      */
     FloatingToolbar?: ComponentType<ComposerEditorFloatingToolbarProps>;
 }
-interface ComposerEditorProps extends Omit<ComponentPropsWithoutRef<"div">, "defaultValue"> {
+interface ComposerEditorProps extends Omit<ComponentPropsWithoutRef<"div">, "defaultValue" | "children"> {
     /**
      * The reading direction of the editor and related elements.
      */
@@ -454,11 +509,6 @@ type HistoryVersionSummaryListProps = ComponentPropsWithoutRef<"ol">;
  */
 declare const HistoryVersionSummaryList: react.ForwardRefExoticComponent<Omit<react.DetailedHTMLProps<react.OlHTMLAttributes<HTMLOListElement>, HTMLOListElement>, "ref"> & react.RefAttributes<HTMLOListElement>>;
 
-interface GlobalComponents {
-    Anchor: ComponentType<ComponentPropsWithoutRef<"a">> | "a";
-}
-type Components = GlobalComponents;
-
 interface AvatarProps extends ComponentProps<"div"> {
     /**
      * The user ID to display the avatar for.
@@ -762,6 +812,8 @@ declare function BoldIcon(props: ComponentProps<"svg">): react_jsx_runtime.JSX.E
 
 declare function CheckIcon(props: ComponentProps<"svg">): react_jsx_runtime.JSX.Element;
 
+declare function CheckCircleIcon(props: ComponentProps<"svg">): react_jsx_runtime.JSX.Element;
+
 declare function ChevronDownIcon(props: ComponentProps<"svg">): react_jsx_runtime.JSX.Element;
 
 declare function ChevronLeftIcon(props: ComponentProps<"svg">): react_jsx_runtime.JSX.Element;
@@ -774,6 +826,8 @@ declare function CodeIcon(props: ComponentProps<"svg">): react_jsx_runtime.JSX.E
 
 declare function CommentIcon(props: ComponentProps<"svg">): react_jsx_runtime.JSX.Element;
 
+declare function CopyIcon(props: ComponentProps<"svg">): react_jsx_runtime.JSX.Element;
+
 declare function CrossIcon(props: ComponentProps<"svg">): react_jsx_runtime.JSX.Element;
 
 declare function EllipsisIcon(props: ComponentProps<"svg">): react_jsx_runtime.JSX.Element;
@@ -802,6 +856,8 @@ declare function QuestionMarkIcon(props: ComponentProps<"svg">): react_jsx_runti
 
 declare function RedoIcon(props: ComponentProps<"svg">): react_jsx_runtime.JSX.Element;
 
+declare function RetryIcon(props: ComponentProps<"svg">): react_jsx_runtime.JSX.Element;
+
 declare function SearchIcon(props: ComponentProps<"svg">): react_jsx_runtime.JSX.Element;
 
 declare function SendIcon(props: ComponentProps<"svg">): react_jsx_runtime.JSX.Element;
@@ -838,12 +894,14 @@ declare namespace icon {
     BlockquoteIcon as Blockquote,
     BoldIcon as Bold,
     CheckIcon as Check,
+    CheckCircleIcon as CheckCircle,
     ChevronDownIcon as ChevronDown,
     ChevronLeftIcon as ChevronLeft,
     ChevronRightIcon as ChevronRight,
     ChevronUpIcon as ChevronUp,
     CodeIcon as Code,
     CommentIcon as Comment,
+    CopyIcon as Copy,
     CrossIcon as Cross,
     EllipsisIcon as Ellipsis,
     EmojiIcon as Emoji,
@@ -858,6 +916,7 @@ declare namespace icon {
     MentionIcon as Mention,
     QuestionMarkIcon as QuestionMark,
     RedoIcon as Redo,
+    RetryIcon as Retry,
     SearchIcon as Search,
     SendIcon as Send,
     ShortenIcon as Shorten,
@@ -873,4 +932,4 @@ declare namespace icon {
   };
 }
 
-export { AiChat, AiChatProps, ChatComposerOverrides, Comment, CommentAttachmentArgs, CommentOverrides, CommentProps, Composer, ComposerBodyMark, ComposerBodyMarks, ComposerOverrides, ComposerProps, ComposerSubmitComment, GlobalOverrides, HistoryVersionSummary, HistoryVersionSummaryList, HistoryVersionSummaryListProps, HistoryVersionSummaryProps, icon as Icon, InboxNotification, InboxNotificationAvatarProps, InboxNotificationCustomKindProps, InboxNotificationCustomProps, InboxNotificationIconProps, InboxNotificationList, InboxNotificationListProps, InboxNotificationOverrides, InboxNotificationProps, InboxNotificationTextMentionKindProps, InboxNotificationTextMentionProps, InboxNotificationThreadKindProps, InboxNotificationThreadProps, LiveblocksUIConfig, LocalizationOverrides, Overrides, Thread, ThreadOverrides, ThreadProps, useOverrides };
+export { AiChat, AiChatComponents, AiChatComponentsEmptyProps, AiChatComponentsLoadingProps, AiChatProps, AiTool, AiToolIconProps, AiToolProps, Comment, CommentAttachmentArgs, CommentOverrides, CommentProps, Composer, ComposerBodyMark, ComposerBodyMarks, ComposerOverrides, ComposerProps, ComposerSubmitComment, GlobalOverrides, HistoryVersionSummary, HistoryVersionSummaryList, HistoryVersionSummaryListProps, HistoryVersionSummaryProps, icon as Icon, InboxNotification, InboxNotificationAvatarProps, InboxNotificationCustomKindProps, InboxNotificationCustomProps, InboxNotificationIconProps, InboxNotificationList, InboxNotificationListProps, InboxNotificationOverrides, InboxNotificationProps, InboxNotificationTextMentionKindProps, InboxNotificationTextMentionProps, InboxNotificationThreadKindProps, InboxNotificationThreadProps, LiveblocksUIConfig, LocalizationOverrides, Overrides, Thread, ThreadOverrides, ThreadProps, useOverrides };

package/dist/index.d.ts

@@ -1,8 +1,13 @@
 import * as react from 'react';
-import { ElementType, ComponentPropsWithoutRef, ReactNode, HTMLAttributes, FormEvent, ComponentType, RefAttributes, MouseEvent, ComponentProps, PropsWithChildren } from 'react';
-import { CommentAttachment, CopilotId, AiChatContext, ClientToolDefinition, CommentBody, BaseMetadata, DM, CommentData, HistoryVersion, InboxNotificationData, InboxNotificationThreadData, InboxNotificationTextMentionData, InboxNotificationCustomData, KDAD, ThreadData } from '@liveblocks/core';
+import { ComponentType, ComponentPropsWithoutRef, ElementType, ReactNode, ComponentProps, FormEvent, RefAttributes, MouseEvent, PropsWithChildren } from 'react';
+import { CommentAttachment, AiKnowledgeSource, AiOpaqueToolDefinition, AiToolTypePack, JsonObject, ToolResultData, NoInfr, AiToolExecuteCallback, CommentBody, BaseMetadata, DM, CommentData, HistoryVersion, InboxNotificationData, InboxNotificationThreadData, InboxNotificationTextMentionData, InboxNotificationCustomData, KDAD, ThreadData } from '@liveblocks/core';
 import * as react_jsx_runtime from 'react/jsx-runtime';
 
+interface GlobalComponents {
+    Anchor: ComponentType<ComponentPropsWithoutRef<"a">> | "a";
+}
+type Components = GlobalComponents;
+
 type Direction = "ltr" | "rtl";
 type SlotProp = {
     /**
@@ -73,21 +78,17 @@ interface ComposerOverrides {
     COMPOSER_SEND: string;
     COMPOSER_TOGGLE_MARK: (mark: ComposerBodyMark) => string;
 }
-interface ChatComposerOverrides {
-    CHAT_COMPOSER_PLACEHOLDER: string;
-    CHAT_COMPOSER_SEND: string;
-    CHAT_COMPOSER_ATTACH_FILES: string;
-    CHAT_COMPOSER_REMOVE_ATTACHMENT: string;
-    CHAT_COMPOSER_ABORT: string;
+interface AiChatComposerOverrides {
+    AI_CHAT_COMPOSER_PLACEHOLDER: string;
+    AI_CHAT_COMPOSER_SEND: string;
+    AI_CHAT_COMPOSER_ABORT: string;
 }
-interface ChatMessageOverrides {
-    CHAT_MESSAGE_DELETED: string;
-    CHAT_MESSAGE_THINKING: string;
-    CHAT_MESSAGE_COPY: string;
-    CHAT_MESSAGE_TRY_AGAIN: string;
+interface AiChatMessageOverrides {
+    AI_CHAT_MESSAGE_DELETED: string;
+    AI_CHAT_MESSAGE_THINKING: string;
 }
-interface ChatOverrides {
-    GET_CHAT_MESSAGES_ERROR: (error: Error) => ReactNode;
+interface AiChatOverrides {
+    AI_CHAT_MESSAGES_ERROR: (error: Error) => ReactNode;
 }
 interface ThreadOverrides {
     THREAD_RESOLVE: string;
@@ -113,53 +114,107 @@ interface HistoryVersionPreviewOverrides {
     HISTORY_VERSION_PREVIEW_EMPTY: ReactNode;
     HISTORY_VERSION_PREVIEW_ERROR: (error: Error) => ReactNode;
 }
-type Overrides = LocalizationOverrides & GlobalOverrides & ComposerOverrides & CommentOverrides & ThreadOverrides & InboxNotificationOverrides & HistoryVersionPreviewOverrides & ChatComposerOverrides & ChatMessageOverrides & ChatOverrides;
+type Overrides = LocalizationOverrides & GlobalOverrides & ComposerOverrides & CommentOverrides & ThreadOverrides & InboxNotificationOverrides & HistoryVersionPreviewOverrides & AiChatComposerOverrides & AiChatMessageOverrides & AiChatOverrides;
 declare function useOverrides(overrides?: Partial<Overrides>): Overrides;
 
-type AiChatProps = HTMLAttributes<HTMLDivElement> & {
+type AiChatComponentsEmptyProps = {
     /**
-     * The id of the chat the composer belongs to.
+     * The chat id provided to the `AiChat` component.
      */
     chatId: string;
     /**
-     * The id of the copilot to use to send the message.
-     */
-    copilotId?: CopilotId;
-    /**
-     * The contextual information to include in the chat. Used by the assistant when generating responses.
+     * The copilot id provided to the `AiChat` component.
      */
-    contexts?: AiChatContext[];
+    copilotId?: string;
+};
+type AiChatComponentsLoadingProps = Record<string, never>;
+type AiChatComponents = {
     /**
-     * The contextual information to include in the chat. Used by the assistant when generating responses.
+     * The component used to render the empty state of the chat.
      */
-    tools?: Record<string, ClientToolDefinition>;
+    Empty: ComponentType<AiChatComponentsEmptyProps>;
     /**
-     * Override the component's strings.
+     * The component used to render the loading state of the chat.
      */
-    overrides?: Partial<GlobalOverrides & ChatMessageOverrides & ChatComposerOverrides & ChatOverrides>;
+    Loading: ComponentType<AiChatComponentsLoadingProps>;
 };
-declare const AiChat: react.ForwardRefExoticComponent<HTMLAttributes<HTMLDivElement> & {
+interface AiChatProps extends ComponentProps<"div"> {
     /**
      * The id of the chat the composer belongs to.
      */
     chatId: string;
+    /**
+     * Whether to focus the chat composer on mount.
+     */
+    autoFocus?: boolean;
     /**
      * The id of the copilot to use to send the message.
      */
-    copilotId?: CopilotId;
+    copilotId?: string;
+    /**
+     * The contextual knowledge to include in the chat. May be used by the assistant when generating responses.
+     * Any knowledge you provide via this prop will be added to any already globally registered knowledge via <RegisterAiKnowledge />.
+     */
+    knowledge?: AiKnowledgeSource[];
     /**
-     * The contextual information to include in the chat. Used by the assistant when generating responses.
+     * Tool definitions to make available within this chat. May be used by the assistant when generating responses.
      */
-    contexts?: AiChatContext[];
+    tools?: Record<string, AiOpaqueToolDefinition>;
     /**
-     * The contextual information to include in the chat. Used by the assistant when generating responses.
+     * The layout of the chat and its composer.
      */
-    tools?: Record<string, ClientToolDefinition>;
+    layout?: "inset" | "compact";
     /**
      * Override the component's strings.
      */
-    overrides?: Partial<GlobalOverrides & ChatMessageOverrides & ChatComposerOverrides & ChatOverrides>;
-} & react.RefAttributes<HTMLDivElement>>;
+    overrides?: Partial<GlobalOverrides & AiChatMessageOverrides & AiChatComposerOverrides & AiChatOverrides>;
+    /**
+     * Override the component's components.
+     */
+    components?: Partial<GlobalComponents & AiChatComponents>;
+}
+declare const AiChat: react.ForwardRefExoticComponent<Omit<AiChatProps, "ref"> & react.RefAttributes<HTMLDivElement>>;
+
+interface AiToolProps extends Omit<ComponentProps<"div">, "title" | "children"> {
+    /**
+     * The tool's title.
+     *
+     * By default, a human-readable version of the tool's name is used:
+     * - `"showTodo"` → "Show todo"
+     * - `"get_weather"` → "Get weather"
+     */
+    title?: string;
+    /**
+     * An optional icon displayed next to the title.
+     */
+    icon?: ReactNode;
+    /**
+     * The content shown in the tool.
+     */
+    children?: ReactNode;
+}
+type AiToolIconProps = ComponentProps<"div">;
+type AiToolInspectorProps = ComponentProps<"div">;
+/**
+ * @private This API will change, and is not considered stable. DO NOT RELY on it.
+ *
+ * This component can be used to build human-in-the-loop interfaces.
+ */
+interface AiToolConfirmationProps<A extends JsonObject, R extends ToolResultData> extends ComponentProps<"div"> {
+    types?: NoInfr<AiToolTypePack<A, R>>;
+    args?: A;
+    confirm: AiToolExecuteCallback<A, R>;
+    cancel: AiToolExecuteCallback<A, R>;
+    variant?: "default" | "destructive";
+}
+declare function AiToolIcon({ className, ...props }: AiToolIconProps): react_jsx_runtime.JSX.Element;
+declare function AiToolInspector({ className, ...props }: AiToolInspectorProps): react_jsx_runtime.JSX.Element;
+declare function AiToolConfirmation<TPack extends AiToolTypePack, A extends JsonObject = TPack["A"], R extends ToolResultData = TPack["R"]>({ children, variant, confirm, cancel, className, ...props }: AiToolConfirmationProps<A, R>): react_jsx_runtime.JSX.Element | null;
+declare const AiTool: react.ForwardRefExoticComponent<Omit<AiToolProps, "ref"> & react.RefAttributes<HTMLDivElement>> & {
+    Icon: typeof AiToolIcon;
+    Inspector: typeof AiToolInspector;
+    Confirmation: typeof AiToolConfirmation;
+};
 
 interface ComposerEditorMentionProps {
     /**
@@ -214,7 +269,7 @@ interface ComposerEditorComponents {
      */
     FloatingToolbar?: ComponentType<ComposerEditorFloatingToolbarProps>;
 }
-interface ComposerEditorProps extends Omit<ComponentPropsWithoutRef<"div">, "defaultValue"> {
+interface ComposerEditorProps extends Omit<ComponentPropsWithoutRef<"div">, "defaultValue" | "children"> {
     /**
      * The reading direction of the editor and related elements.
      */
@@ -454,11 +509,6 @@ type HistoryVersionSummaryListProps = ComponentPropsWithoutRef<"ol">;
  */
 declare const HistoryVersionSummaryList: react.ForwardRefExoticComponent<Omit<react.DetailedHTMLProps<react.OlHTMLAttributes<HTMLOListElement>, HTMLOListElement>, "ref"> & react.RefAttributes<HTMLOListElement>>;
 
-interface GlobalComponents {
-    Anchor: ComponentType<ComponentPropsWithoutRef<"a">> | "a";
-}
-type Components = GlobalComponents;
-
 interface AvatarProps extends ComponentProps<"div"> {
     /**
      * The user ID to display the avatar for.
@@ -762,6 +812,8 @@ declare function BoldIcon(props: ComponentProps<"svg">): react_jsx_runtime.JSX.E
 
 declare function CheckIcon(props: ComponentProps<"svg">): react_jsx_runtime.JSX.Element;
 
+declare function CheckCircleIcon(props: ComponentProps<"svg">): react_jsx_runtime.JSX.Element;
+
 declare function ChevronDownIcon(props: ComponentProps<"svg">): react_jsx_runtime.JSX.Element;
 
 declare function ChevronLeftIcon(props: ComponentProps<"svg">): react_jsx_runtime.JSX.Element;
@@ -774,6 +826,8 @@ declare function CodeIcon(props: ComponentProps<"svg">): react_jsx_runtime.JSX.E
 
 declare function CommentIcon(props: ComponentProps<"svg">): react_jsx_runtime.JSX.Element;
 
+declare function CopyIcon(props: ComponentProps<"svg">): react_jsx_runtime.JSX.Element;
+
 declare function CrossIcon(props: ComponentProps<"svg">): react_jsx_runtime.JSX.Element;
 
 declare function EllipsisIcon(props: ComponentProps<"svg">): react_jsx_runtime.JSX.Element;
@@ -802,6 +856,8 @@ declare function QuestionMarkIcon(props: ComponentProps<"svg">): react_jsx_runti
 
 declare function RedoIcon(props: ComponentProps<"svg">): react_jsx_runtime.JSX.Element;
 
+declare function RetryIcon(props: ComponentProps<"svg">): react_jsx_runtime.JSX.Element;
+
 declare function SearchIcon(props: ComponentProps<"svg">): react_jsx_runtime.JSX.Element;
 
 declare function SendIcon(props: ComponentProps<"svg">): react_jsx_runtime.JSX.Element;
@@ -838,12 +894,14 @@ declare namespace icon {
     BlockquoteIcon as Blockquote,
     BoldIcon as Bold,
     CheckIcon as Check,
+    CheckCircleIcon as CheckCircle,
     ChevronDownIcon as ChevronDown,
     ChevronLeftIcon as ChevronLeft,
     ChevronRightIcon as ChevronRight,
     ChevronUpIcon as ChevronUp,
     CodeIcon as Code,
     CommentIcon as Comment,
+    CopyIcon as Copy,
     CrossIcon as Cross,
     EllipsisIcon as Ellipsis,
     EmojiIcon as Emoji,
@@ -858,6 +916,7 @@ declare namespace icon {
     MentionIcon as Mention,
     QuestionMarkIcon as QuestionMark,
     RedoIcon as Redo,
+    RetryIcon as Retry,
     SearchIcon as Search,
     SendIcon as Send,
     ShortenIcon as Shorten,
@@ -873,4 +932,4 @@ declare namespace icon {
   };
 }
 
-export { AiChat, AiChatProps, ChatComposerOverrides, Comment, CommentAttachmentArgs, CommentOverrides, CommentProps, Composer, ComposerBodyMark, ComposerBodyMarks, ComposerOverrides, ComposerProps, ComposerSubmitComment, GlobalOverrides, HistoryVersionSummary, HistoryVersionSummaryList, HistoryVersionSummaryListProps, HistoryVersionSummaryProps, icon as Icon, InboxNotification, InboxNotificationAvatarProps, InboxNotificationCustomKindProps, InboxNotificationCustomProps, InboxNotificationIconProps, InboxNotificationList, InboxNotificationListProps, InboxNotificationOverrides, InboxNotificationProps, InboxNotificationTextMentionKindProps, InboxNotificationTextMentionProps, InboxNotificationThreadKindProps, InboxNotificationThreadProps, LiveblocksUIConfig, LocalizationOverrides, Overrides, Thread, ThreadOverrides, ThreadProps, useOverrides };
+export { AiChat, AiChatComponents, AiChatComponentsEmptyProps, AiChatComponentsLoadingProps, AiChatProps, AiTool, AiToolIconProps, AiToolProps, Comment, CommentAttachmentArgs, CommentOverrides, CommentProps, Composer, ComposerBodyMark, ComposerBodyMarks, ComposerOverrides, ComposerProps, ComposerSubmitComment, GlobalOverrides, HistoryVersionSummary, HistoryVersionSummaryList, HistoryVersionSummaryListProps, HistoryVersionSummaryProps, icon as Icon, InboxNotification, InboxNotificationAvatarProps, InboxNotificationCustomKindProps, InboxNotificationCustomProps, InboxNotificationIconProps, InboxNotificationList, InboxNotificationListProps, InboxNotificationOverrides, InboxNotificationProps, InboxNotificationTextMentionKindProps, InboxNotificationTextMentionProps, InboxNotificationThreadKindProps, InboxNotificationThreadProps, LiveblocksUIConfig, LocalizationOverrides, Overrides, Thread, ThreadOverrides, ThreadProps, useOverrides };

package/dist/index.js

@@ -1,6 +1,7 @@
 import { detectDupes } from '@liveblocks/core';
 import { PKG_NAME, PKG_VERSION, PKG_FORMAT } from './version.js';
-export { AiChat } from './components/AiChat/AiChat.js';
+export { AiChat } from './components/AiChat.js';
+export { AiTool } from './components/AiTool.js';
 export { Comment } from './components/Comment.js';
 export { Composer } from './components/Composer.js';
 export { HistoryVersionSummary } from './components/HistoryVersionSummary.js';