@uipath/apollo-vertex 0.0.0-stage → 0.3.0

package/dist/registry/ai-chat/components/ai-chat.d.ts

@@ -0,0 +1,30 @@
+import type { ContentPart } from "@tanstack/ai";
+import type { AnyClientTool, ChatClientState, ToolCallPart, UIMessage } from "@tanstack/ai-client";
+import { type ReactNode } from "react";
+import type { MessageFeedbackType } from "../types";
+type DefaultTools = any;
+export interface AiChatProps<TTools extends ReadonlyArray<AnyClientTool> = DefaultTools> {
+    messages: UIMessage<TTools>[];
+    status: ChatClientState;
+    onSendMessage: (content: string, parts?: ContentPart[]) => void;
+    onStop: () => void;
+    onClearChat?: () => void;
+    onRetry?: () => void;
+    onFeedback?: (messageId: string, type: MessageFeedbackType) => void;
+    getFeedback?: (messageId: string) => MessageFeedbackType | null | undefined;
+    onRegenerate?: () => void;
+    onEditMessage?: (messageId: string, content: string) => void;
+    renderToolPart?: (part: ToolCallPart<TTools>) => ReactNode;
+    assistantName?: string;
+    title?: string;
+    header?: ReactNode;
+    emptyState?: ReactNode;
+    suggestions?: string[];
+    onSuggestionClick?: (suggestion: string) => void;
+    placeholder?: string;
+    acceptedFileTypes?: string;
+    enableTextSelection?: boolean;
+    error?: Error | null;
+}
+export declare function AiChat<TTools extends ReadonlyArray<AnyClientTool> = DefaultTools>({ messages, status, onSendMessage, onStop, onClearChat, onRetry, onFeedback, getFeedback, onRegenerate, onEditMessage, renderToolPart, assistantName, title, header, emptyState, suggestions, onSuggestionClick, placeholder, acceptedFileTypes, enableTextSelection, error, }: AiChatProps<TTools>): import("react/jsx-runtime").JSX.Element;
+export {};

package/dist/registry/ai-chat/components/ai-chat.js

@@ -0,0 +1,232 @@
+"use client";
+import { jsx, jsxs } from "react/jsx-runtime";
+import { Fragment, useEffect, useRef, useState } from "react";
+import { useVertexTranslation } from "../../../lib/vertex-translation.js";
+import { cn } from "../../../lib/utils.js";
+import { asBlockquote, isVisibleAssistant } from "../content-parts.js";
+import { useStickyScroll } from "../hooks/use-sticky-scroll.js";
+import { AiChatEmptyState } from "./ai-chat-empty-state.js";
+import { AiChatEmptySuggestions } from "./ai-chat-empty-suggestions.js";
+import { AiChatErrorBanner } from "./ai-chat-error-banner.js";
+import { AiChatHeader } from "./ai-chat-header.js";
+import { AiChatInput } from "./ai-chat-input.js";
+import { AiChatLoading } from "./ai-chat-loading.js";
+import { AiChatMessage } from "./ai-chat-message.js";
+import { AiChatScrollToBottomButton } from "./ai-chat-scroll-to-bottom-button.js";
+import { AiChatSelectionMenu } from "./ai-chat-selection-menu.js";
+function AiChat({ messages, status, onSendMessage, onStop, onClearChat, onRetry, onFeedback, getFeedback, onRegenerate, onEditMessage, renderToolPart, assistantName, title, header, emptyState, suggestions, onSuggestionClick, placeholder, acceptedFileTypes, enableTextSelection = false, error }) {
+    const { t } = useVertexTranslation();
+    const [input, setInput] = useState("");
+    const [quotedText, setQuotedText] = useState(null);
+    const { attachScrollListeners, scrollElement, contentRef, isStuck, scrollToBottom } = useStickyScroll();
+    const inputRef = useRef(null);
+    const chatContainerRef = useRef(null);
+    const [isDragging, setIsDragging] = useState(false);
+    const attachmentsEnabled = !!acceptedFileTypes;
+    const handleDragEnter = (e)=>{
+        if (!attachmentsEnabled) return;
+        if (!e.dataTransfer.types.includes("Files")) return;
+        e.preventDefault();
+        setIsDragging(true);
+    };
+    const handleDragLeave = (e)=>{
+        if (!attachmentsEnabled) return;
+        const next = e.relatedTarget;
+        if (next instanceof Node && e.currentTarget.contains(next)) return;
+        setIsDragging(false);
+    };
+    const handleDragOver = (e)=>{
+        if (!attachmentsEnabled) return;
+        if (!e.dataTransfer.types.includes("Files")) return;
+        e.preventDefault();
+    };
+    const handleDrop = (e)=>{
+        if (!attachmentsEnabled) return;
+        e.preventDefault();
+        setIsDragging(false);
+        if (e.dataTransfer.files.length > 0) inputRef.current?.addFiles(e.dataTransfer.files);
+    };
+    const displayName = assistantName ?? t("ai_assistant");
+    const isInFlight = "submitted" === status || "streaming" === status;
+    const queuedMessageRef = useRef(null);
+    const conversationText = messages.map((m)=>{
+        const content = m.parts.filter((p)=>"text" === p.type).map((p)=>p.content).join("");
+        if (!content) return null;
+        const label = "user" === m.role ? t("you") : displayName;
+        return `${label}: ${content}`;
+    }).filter(Boolean).join("\n\n");
+    const handleSubmit = (parts)=>{
+        const text = input.trim();
+        if (!text && !parts?.length) return;
+        const composedText = quotedText ? `${asBlockquote(quotedText)}\n\n${text}` : text;
+        if (isInFlight) queuedMessageRef.current = {
+            text: composedText,
+            parts
+        };
+        else {
+            onSendMessage(composedText, parts);
+            scrollToBottom();
+        }
+        setInput("");
+        setQuotedText(null);
+    };
+    const wasInFlightRef = useRef(false);
+    useEffect(()=>{
+        if (wasInFlightRef.current && !isInFlight) if (queuedMessageRef.current) {
+            const { text: queuedText, parts: queuedParts } = queuedMessageRef.current;
+            queuedMessageRef.current = null;
+            onSendMessage(queuedText, queuedParts);
+            scrollToBottom();
+        } else inputRef.current?.focus();
+        wasInFlightRef.current = isInFlight;
+    }, [
+        isInFlight,
+        onSendMessage,
+        scrollToBottom
+    ]);
+    const handleAskAi = (text)=>{
+        setQuotedText(text);
+        requestAnimationFrame(()=>inputRef.current?.focus());
+    };
+    const lastMessage = messages.at(-1);
+    const lastMessageId = lastMessage?.id ?? null;
+    const lastAssistantHasText = lastMessage?.role === "assistant" && lastMessage.parts.some((p)=>"text" === p.type && p.content);
+    const showLoadingIndicator = isInFlight && !lastAssistantHasText;
+    const latestVisibleAssistantId = messages.findLast((m)=>isVisibleAssistant(m))?.id ?? null;
+    const defaultEmptyState = /*#__PURE__*/ jsx(AiChatEmptyState, {
+        title: t("shell_empty_title"),
+        description: t("shell_empty_description")
+    });
+    const defaultHeader = title && /*#__PURE__*/ jsx(AiChatHeader, {
+        title: title,
+        hasMessages: messages.length > 0,
+        conversationText: conversationText,
+        onClearChat: onClearChat
+    });
+    const sharedInputProps = {
+        ref: inputRef,
+        value: input,
+        onChange: setInput,
+        onSubmit: handleSubmit,
+        onStop,
+        isLoading: isInFlight,
+        placeholder,
+        acceptedFileTypes,
+        quotedText,
+        onClearQuote: ()=>setQuotedText(null)
+    };
+    return /*#__PURE__*/ jsxs("div", {
+        className: cn("flex flex-col h-full max-w-[680px] mx-auto bg-transparent text-ai-chat-foreground overflow-hidden rounded-lg border-2 border-dashed border-transparent transition-colors", isDragging && "border-primary"),
+        "data-slot": "ai-chat",
+        ref: chatContainerRef,
+        onDragEnter: handleDragEnter,
+        onDragLeave: handleDragLeave,
+        onDragOver: handleDragOver,
+        onDrop: handleDrop,
+        children: [
+            header ?? defaultHeader,
+            0 === messages.length ? /*#__PURE__*/ jsx("div", {
+                className: "flex-1 flex flex-col items-center justify-center min-h-0",
+                children: /*#__PURE__*/ jsxs("div", {
+                    className: "w-full",
+                    children: [
+                        /*#__PURE__*/ jsx("div", {
+                            className: "px-4 text-center mb-7",
+                            children: emptyState ?? defaultEmptyState
+                        }),
+                        /*#__PURE__*/ jsx(AiChatInput, {
+                            ...sharedInputProps,
+                            hasMessages: false
+                        }),
+                        suggestions && /*#__PURE__*/ jsx(AiChatEmptySuggestions, {
+                            suggestions: suggestions,
+                            onSelect: onSuggestionClick ?? onSendMessage
+                        })
+                    ]
+                })
+            }) : /*#__PURE__*/ jsxs("div", {
+                className: "relative flex-1 min-h-0",
+                children: [
+                    /*#__PURE__*/ jsx("div", {
+                        className: "absolute top-0 left-0 right-0 h-6 z-10 pointer-events-none",
+                        style: {
+                            background: "linear-gradient(to bottom, var(--background) 0%, transparent 100%)"
+                        },
+                        "aria-hidden": "true"
+                    }),
+                    /*#__PURE__*/ jsxs("div", {
+                        ref: attachScrollListeners,
+                        role: "log",
+                        "aria-label": t("chat_messages"),
+                        "aria-live": "polite",
+                        "aria-atomic": "false",
+                        "aria-busy": isInFlight,
+                        className: "relative h-full overflow-y-auto py-4 pl-10 pr-10",
+                        children: [
+                            enableTextSelection && /*#__PURE__*/ jsx(AiChatSelectionMenu, {
+                                onAskAi: handleAskAi,
+                                containerRef: scrollElement
+                            }),
+                            /*#__PURE__*/ jsxs("div", {
+                                ref: contentRef,
+                                className: "space-y-1",
+                                children: [
+                                    messages.map((message)=>{
+                                        const isLatestVisibleAssistant = "assistant" === message.role && message.id === latestVisibleAssistantId;
+                                        const hideActions = isInFlight && "assistant" === message.role && message.id === lastMessageId;
+                                        return /*#__PURE__*/ jsx(AiChatMessage, {
+                                            message: message,
+                                            hideActions: hideActions,
+                                            showActionsAlwaysVisible: !isInFlight && isLatestVisibleAssistant,
+                                            ...getFeedback ? {
+                                                feedback: getFeedback(message.id) ?? null
+                                            } : {},
+                                            ...onFeedback ? {
+                                                onFeedback: (type)=>onFeedback(message.id, type)
+                                            } : {},
+                                            ...onRegenerate ? {
+                                                onRegenerate
+                                            } : {},
+                                            ...onEditMessage && !isInFlight ? {
+                                                onEditMessage: (content)=>onEditMessage(message.id, content)
+                                            } : {},
+                                            children: renderToolPart && message.parts.map((part)=>{
+                                                if ("tool-call" !== part.type) return null;
+                                                const rendered = renderToolPart(part);
+                                                if (null == rendered) return null;
+                                                return /*#__PURE__*/ jsx(Fragment, {
+                                                    children: rendered
+                                                }, part.id);
+                                            })
+                                        }, message.id);
+                                    }),
+                                    showLoadingIndicator && /*#__PURE__*/ jsx(AiChatLoading, {})
+                                ]
+                            })
+                        ]
+                    }),
+                    !isStuck && /*#__PURE__*/ jsx(AiChatScrollToBottomButton, {
+                        onClick: scrollToBottom
+                    })
+                ]
+            }),
+            error && /*#__PURE__*/ jsx(AiChatErrorBanner, {
+                message: error.message,
+                onRetry: onRetry
+            }),
+            messages.length > 0 && /*#__PURE__*/ jsxs("div", {
+                children: [
+                    /*#__PURE__*/ jsx(AiChatInput, {
+                        ...sharedInputProps,
+                        hasMessages: true
+                    }),
+                    /*#__PURE__*/ jsx("div", {
+                        className: "pt-2 pb-3 px-4 text-xs leading-normal text-muted-foreground text-center",
+                        children: t("ai_response_disclaimer")
+                    })
+                ]
+            })
+        ]
+    });
+}
+export { AiChat };

package/dist/registry/ai-chat/components/icons/autopilot-gradient.d.ts

@@ -0,0 +1,7 @@
+import * as React from "react";
+interface AutopilotGradientIconProps extends Omit<React.SVGProps<SVGSVGElement>, "width" | "height" | "fill"> {
+    size?: string | number;
+    ref?: React.Ref<SVGSVGElement>;
+}
+export declare function AutopilotGradientIcon({ size, ref, ...props }: AutopilotGradientIconProps): import("react/jsx-runtime").JSX.Element;
+export {};

package/dist/registry/ai-chat/components/icons/autopilot-gradient.js

@@ -0,0 +1,54 @@
+import { jsx, jsxs } from "react/jsx-runtime";
+import { useId } from "react";
+function AutopilotGradientIcon({ size = 24, ref, ...props }) {
+    const gradientId = useId();
+    return /*#__PURE__*/ jsxs("svg", {
+        ref: ref,
+        viewBox: "0 0 24 24",
+        fill: "none",
+        xmlns: "http://www.w3.org/2000/svg",
+        width: size,
+        height: size,
+        ...props,
+        children: [
+            /*#__PURE__*/ jsx("defs", {
+                children: /*#__PURE__*/ jsxs("linearGradient", {
+                    id: gradientId,
+                    x1: "0",
+                    y1: "0.5",
+                    x2: "1",
+                    y2: "0.5",
+                    gradientUnits: "objectBoundingBox",
+                    children: [
+                        /*#__PURE__*/ jsx("stop", {
+                            offset: "8.79%",
+                            style: {
+                                stopColor: "var(--ai-gradient-start, #6C5AEF)"
+                            }
+                        }),
+                        /*#__PURE__*/ jsx("stop", {
+                            offset: "91.48%",
+                            style: {
+                                stopColor: "var(--ai-gradient-end, #69C7DD)"
+                            }
+                        })
+                    ]
+                })
+            }),
+            /*#__PURE__*/ jsxs("g", {
+                transform: "translate(-1.74 -1.19) scale(1.1)",
+                children: [
+                    /*#__PURE__*/ jsx("path", {
+                        d: "M19.4231 13.2391C15.2592 12.5335 11.9733 9.06719 11.3046 4.67449C11.292 4.59158 11.1901 4.59158 11.1775 4.67449C10.5088 9.06719 7.22293 12.5335 3.05898 13.2391C2.98034 13.2524 2.98034 13.3599 3.05898 13.3732C7.22293 14.0786 10.5088 17.5451 11.1775 21.9378C11.1901 22.0207 11.292 22.0207 11.3046 21.9378C11.9733 17.5451 15.2592 14.0786 19.4231 13.3732C19.5017 13.3599 19.5017 13.2524 19.4231 13.2391ZM15.3321 13.3397C13.2501 13.6924 11.6072 15.4256 11.2728 17.622C11.2665 17.6634 11.2156 17.6634 11.2093 17.622C10.8749 15.4256 9.23198 13.6924 7.15 13.3397C7.11069 13.333 7.11069 13.2793 7.15 13.2726C9.23198 12.9198 10.8749 11.1867 11.2093 8.99032C11.2156 8.94886 11.2665 8.94886 11.2728 8.99032C11.6072 11.1867 13.2501 12.9198 15.3321 13.2726C15.3714 13.2793 15.3714 13.333 15.3321 13.3397Z",
+                        fill: `url(#${gradientId})`
+                    }),
+                    /*#__PURE__*/ jsx("path", {
+                        d: "M21.9179 6.38045C19.8359 6.73316 18.193 8.4664 17.8586 10.6628C17.8523 10.7042 17.8014 10.7042 17.7951 10.6628C17.4607 8.4664 15.8178 6.73316 13.7358 6.38045C13.6965 6.3738 13.6965 6.32005 13.7358 6.3134C15.8178 5.96062 17.4607 4.22744 17.7951 2.03109C17.8014 1.98964 17.8523 1.98964 17.8586 2.03109C18.193 4.22744 19.8359 5.96062 21.9179 6.3134C21.9572 6.32005 21.9572 6.3738 21.9179 6.38045Z",
+                        fill: `url(#${gradientId})`
+                    })
+                ]
+            })
+        ]
+    });
+}
+export { AutopilotGradientIcon };

package/dist/registry/ai-chat/components/icons/autopilot.d.ts

@@ -0,0 +1,7 @@
+import * as React from "react";
+interface AutopilotIconProps extends Omit<React.SVGProps<SVGSVGElement>, "width" | "height"> {
+    size?: string | number;
+    ref?: React.Ref<SVGSVGElement>;
+}
+export declare function AutopilotIcon({ size, ref, ...props }: AutopilotIconProps): import("react/jsx-runtime").JSX.Element;
+export {};

package/dist/registry/ai-chat/components/icons/autopilot.js

@@ -0,0 +1,27 @@
+import { jsx, jsxs } from "react/jsx-runtime";
+import "react";
+function AutopilotIcon({ size = 24, ref, ...props }) {
+    return /*#__PURE__*/ jsx("svg", {
+        ref: ref,
+        viewBox: "0 0 24 24",
+        fill: "none",
+        xmlns: "http://www.w3.org/2000/svg",
+        width: size,
+        height: size,
+        ...props,
+        children: /*#__PURE__*/ jsxs("g", {
+            transform: "translate(-1.74 -1.19) scale(1.1)",
+            children: [
+                /*#__PURE__*/ jsx("path", {
+                    d: "M19.4231 13.2391C15.2592 12.5335 11.9733 9.06719 11.3046 4.67449C11.292 4.59158 11.1901 4.59158 11.1775 4.67449C10.5088 9.06719 7.22293 12.5335 3.05898 13.2391C2.98034 13.2524 2.98034 13.3599 3.05898 13.3732C7.22293 14.0786 10.5088 17.5451 11.1775 21.9378C11.1901 22.0207 11.292 22.0207 11.3046 21.9378C11.9733 17.5451 15.2592 14.0786 19.4231 13.3732C19.5017 13.3599 19.5017 13.2524 19.4231 13.2391ZM15.3321 13.3397C13.2501 13.6924 11.6072 15.4256 11.2728 17.622C11.2665 17.6634 11.2156 17.6634 11.2093 17.622C10.8749 15.4256 9.23198 13.6924 7.15 13.3397C7.11069 13.333 7.11069 13.2793 7.15 13.2726C9.23198 12.9198 10.8749 11.1867 11.2093 8.99032C11.2156 8.94886 11.2665 8.94886 11.2728 8.99032C11.6072 11.1867 13.2501 12.9198 15.3321 13.2726C15.3714 13.2793 15.3714 13.333 15.3321 13.3397Z",
+                    fill: "currentColor"
+                }),
+                /*#__PURE__*/ jsx("path", {
+                    d: "M21.9179 6.38045C19.8359 6.73316 18.193 8.4664 17.8586 10.6628C17.8523 10.7042 17.8014 10.7042 17.7951 10.6628C17.4607 8.4664 15.8178 6.73316 13.7358 6.38045C13.6965 6.3738 13.6965 6.32005 13.7358 6.3134C15.8178 5.96062 17.4607 4.22744 17.7951 2.03109C17.8014 1.98964 17.8523 1.98964 17.8586 2.03109C18.193 4.22744 19.8359 5.96062 21.9179 6.3134C21.9572 6.32005 21.9572 6.3738 21.9179 6.38045Z",
+                    fill: "currentColor"
+                })
+            ]
+        })
+    });
+}
+export { AutopilotIcon };

package/dist/registry/ai-chat/content-parts.d.ts

@@ -0,0 +1,5 @@
+import type { ImagePart } from "@tanstack/ai";
+import type { UIMessage } from "@tanstack/ai-client";
+export declare function imagePartToUrl(part: ImagePart): string;
+export declare function isVisibleAssistant(m: UIMessage): boolean;
+export declare function asBlockquote(text: string): string;

package/dist/registry/ai-chat/content-parts.js

@@ -0,0 +1,11 @@
+function imagePartToUrl(part) {
+    return "data" === part.source.type ? `data:${part.source.mimeType};base64,${part.source.value}` : part.source.value;
+}
+function isVisibleAssistant(m) {
+    if ("assistant" !== m.role) return false;
+    return m.parts.some((p)=>"tool-call" === p.type && null != p.output || "text" === p.type && p.content);
+}
+function asBlockquote(text) {
+    return text.split("\n").map((line)=>`> ${line}`).join("\n");
+}
+export { asBlockquote, imagePartToUrl, isVisibleAssistant };

package/dist/registry/ai-chat/hooks/use-pending-files.d.ts

@@ -0,0 +1,16 @@
+import type { ContentPart } from "@tanstack/ai";
+export interface PendingFile {
+    uid: string;
+    name: string;
+    size: number;
+    type: string;
+    file: File;
+    thumbnailUrl?: string;
+}
+export declare function usePendingFiles(): {
+    files: PendingFile[];
+    add: (incoming: FileList | File[]) => void;
+    remove: (uid: string) => void;
+    clear: () => void;
+};
+export declare function pendingFilesToContentParts(files: ReadonlyArray<PendingFile>): Promise<ContentPart[]>;

package/dist/registry/ai-chat/hooks/use-pending-files.js

@@ -0,0 +1,86 @@
+import { useCallback, useEffect, useRef, useState } from "react";
+function makePendingFile(file) {
+    const isImage = file.type.startsWith("image/");
+    return {
+        uid: crypto.randomUUID(),
+        name: file.name,
+        size: file.size,
+        type: file.type,
+        file,
+        ...isImage && {
+            thumbnailUrl: URL.createObjectURL(file)
+        }
+    };
+}
+function usePendingFiles() {
+    const [files, setFiles] = useState([]);
+    const liveUrlsRef = useRef(new Set());
+    useEffect(()=>()=>{
+            for (const url of liveUrlsRef.current)URL.revokeObjectURL(url);
+            liveUrlsRef.current.clear();
+        }, []);
+    const revoke = (url)=>{
+        URL.revokeObjectURL(url);
+        liveUrlsRef.current.delete(url);
+    };
+    const add = useCallback((incoming)=>{
+        const next = Array.from(incoming).map((f)=>makePendingFile(f));
+        if (0 === next.length) return;
+        for (const pf of next)if (pf.thumbnailUrl) liveUrlsRef.current.add(pf.thumbnailUrl);
+        setFiles((prev)=>[
+                ...prev,
+                ...next
+            ]);
+    }, []);
+    const remove = useCallback((uid)=>{
+        setFiles((prev)=>{
+            const target = prev.find((f)=>f.uid === uid);
+            if (target?.thumbnailUrl) revoke(target.thumbnailUrl);
+            return prev.filter((f)=>f.uid !== uid);
+        });
+    }, []);
+    const clear = useCallback(()=>{
+        setFiles((prev)=>{
+            for (const f of prev)if (f.thumbnailUrl) revoke(f.thumbnailUrl);
+            return [];
+        });
+    }, []);
+    return {
+        files,
+        add,
+        remove,
+        clear
+    };
+}
+function readAsDataSource(file) {
+    return new Promise((resolve, reject)=>{
+        const reader = new FileReader();
+        reader.addEventListener("load", ()=>{
+            const result = reader.result;
+            if ("string" != typeof result) return void reject(new Error("Expected data URL from FileReader"));
+            const base64 = result.slice(result.indexOf(",") + 1);
+            resolve({
+                type: "data",
+                value: base64,
+                mimeType: file.type
+            });
+        });
+        reader.addEventListener("error", ()=>reject(reader.error ?? new Error("File read failed")));
+        reader.readAsDataURL(file);
+    });
+}
+async function fileToContentPart(file) {
+    if (file.type.startsWith("image/")) {
+        const source = await readAsDataSource(file);
+        return {
+            type: "image",
+            source
+        };
+    }
+    return null;
+}
+async function pendingFilesToContentParts(files) {
+    const parts = await Promise.all(files.map((pf)=>fileToContentPart(pf.file)));
+    return parts.filter((p)=>null !== p);
+}
+export { pendingFilesToContentParts, usePendingFiles };

package/dist/registry/ai-chat/hooks/use-sticky-scroll.d.ts

@@ -0,0 +1,10 @@
+import { type RefCallback, type RefObject } from "react";
+interface StickyScroll {
+    attachScrollListeners: RefCallback<HTMLDivElement | null>;
+    scrollElement: RefObject<HTMLDivElement | null>;
+    contentRef: RefCallback<HTMLDivElement | null>;
+    isStuck: boolean;
+    scrollToBottom: () => void;
+}
+export declare function useStickyScroll(): StickyScroll;
+export {};

package/dist/registry/ai-chat/hooks/use-sticky-scroll.js

@@ -0,0 +1,68 @@
+import { useEventListener, useMergedRef, useResizeObserver } from "@mantine/hooks";
+import { useEffect, useRef, useState } from "react";
+function useStickyScroll() {
+    const [isStuck, setIsStuck] = useState(true);
+    const isStuckRef = useRef(true);
+    const scrollElement = useRef(null);
+    const rafIdRef = useRef(0);
+    function setStuck(stuck) {
+        isStuckRef.current = stuck;
+        setIsStuck(stuck);
+    }
+    function scrollToBottom() {
+        const el = scrollElement.current;
+        if (!el) return;
+        el.scrollTop = el.scrollHeight;
+        setStuck(true);
+    }
+    function unstickIfScrolled() {
+        const el = scrollElement.current;
+        if (!el) return;
+        const before = el.scrollTop;
+        cancelAnimationFrame(rafIdRef.current);
+        rafIdRef.current = requestAnimationFrame(()=>{
+            const after = el.scrollTop;
+            if (after < before - 0.5) setStuck(false);
+        });
+    }
+    useEffect(()=>()=>cancelAnimationFrame(rafIdRef.current), []);
+    function handleWheel(e) {
+        if (e.deltaY >= 0) return;
+        if (!isStuckRef.current) return;
+        unstickIfScrolled();
+    }
+    function handleScroll() {
+        if (isStuckRef.current) return;
+        const el = scrollElement.current;
+        if (!el) return;
+        const atBottom = el.scrollHeight - el.scrollTop - el.clientHeight < 1;
+        if (atBottom) setStuck(true);
+    }
+    function storeRef(node) {
+        scrollElement.current = node;
+    }
+    const wheelRef = useEventListener("wheel", handleWheel, {
+        passive: true
+    });
+    const scrollListenerRef = useEventListener("scroll", handleScroll, {
+        passive: true
+    });
+    const attachScrollListeners = useMergedRef(storeRef, wheelRef, scrollListenerRef);
+    const [contentRef, contentRect] = useResizeObserver();
+    useEffect(()=>{
+        if (isStuckRef.current) {
+            const el = scrollElement.current;
+            if (el) el.scrollTop = el.scrollHeight;
+        }
+    }, [
+        contentRect.height
+    ]);
+    return {
+        attachScrollListeners,
+        scrollElement,
+        contentRef,
+        isStuck,
+        scrollToBottom
+    };
+}
+export { useStickyScroll };

package/dist/registry/ai-chat/tools/choices/choices-tool.d.ts

@@ -0,0 +1,39 @@
+import { z } from "zod";
+declare const choiceOptionSchema: z.ZodObject<{
+    id: z.ZodString;
+    label: z.ZodString;
+    value: z.ZodOptional<z.ZodString>;
+    recommended: z.ZodOptional<z.ZodBoolean>;
+}, z.core.$strip>;
+declare const presentChoicesInput: z.ZodObject<{
+    prompt: z.ZodString;
+    options: z.ZodArray<z.ZodObject<{
+        id: z.ZodString;
+        label: z.ZodString;
+        value: z.ZodOptional<z.ZodString>;
+        recommended: z.ZodOptional<z.ZodBoolean>;
+    }, z.core.$strip>>;
+}, z.core.$strip>;
+export type ChoiceOption = z.infer<typeof choiceOptionSchema>;
+export declare const CHOICES_TOOL_PROMPT = "You have a \"presentChoices\" tool.\nWhen the conversation benefits from structured options, call this tool.\nShow at most 8 options by default, picking the most relevant ones. Only show more if the user explicitly asks for all or a complete list.\nOptionally mark one option as recommended if there is a clear best pick.";
+export declare const presentChoicesClient: import("@tanstack/ai").ClientTool<z.ZodObject<{
+    prompt: z.ZodString;
+    options: z.ZodArray<z.ZodObject<{
+        id: z.ZodString;
+        label: z.ZodString;
+        value: z.ZodOptional<z.ZodString>;
+        recommended: z.ZodOptional<z.ZodBoolean>;
+    }, z.core.$strip>>;
+}, z.core.$strip>, z.ZodObject<{
+    prompt: z.ZodString;
+    options: z.ZodArray<z.ZodObject<{
+        id: z.ZodString;
+        label: z.ZodString;
+        value: z.ZodOptional<z.ZodString>;
+        recommended: z.ZodOptional<z.ZodBoolean>;
+    }, z.core.$strip>>;
+}, z.core.$strip>, "presentChoices">;
+export declare function renderChoices(output: z.infer<typeof presentChoicesInput>, context: {
+    onAction: (message: string) => void;
+}): import("react/jsx-runtime").JSX.Element;
+export {};

package/dist/registry/ai-chat/tools/choices/choices-tool.js

@@ -0,0 +1,38 @@
+"use client";
+import { jsx } from "react/jsx-runtime";
+import { toolDefinition } from "@tanstack/ai";
+import { z } from "zod";
+import { AiChatSuggestions } from "../../components/ai-chat-suggestions.js";
+const choiceOptionSchema = z.object({
+    id: z.string().describe("Unique identifier"),
+    label: z.string().describe("Button text"),
+    value: z.string().optional().describe("Optional payload"),
+    recommended: z.boolean().optional().describe("Highlight as recommended")
+});
+const presentChoicesInput = z.object({
+    prompt: z.string().describe("Short label above choices"),
+    options: z.array(choiceOptionSchema).min(1).describe("Clickable options")
+});
+const CHOICES_TOOL_PROMPT = `You have a "presentChoices" tool.
+When the conversation benefits from structured options, call this tool.
+Show at most 8 options by default, picking the most relevant ones. Only show more if the user explicitly asks for all or a complete list.
+Optionally mark one option as recommended if there is a clear best pick.`;
+const presentChoicesDef = toolDefinition({
+    name: "presentChoices",
+    description: "Present the user with clickable choices. Call this tool when the conversation benefits from structured options. Optionally mark one option as recommended if there is a clear best pick.",
+    inputSchema: presentChoicesInput,
+    outputSchema: presentChoicesInput,
+    metadata: {
+        skipFollowUp: true
+    }
+});
+const presentChoicesClient = presentChoicesDef.client((input)=>input);
+function renderChoices(output, context) {
+    const { prompt, options } = output;
+    return /*#__PURE__*/ jsx(AiChatSuggestions, {
+        prompt: prompt,
+        options: options,
+        onSelect: (option)=>context.onAction(option.value ?? option.label)
+    });
+}
+export { CHOICES_TOOL_PROMPT, presentChoicesClient, renderChoices };

package/dist/registry/ai-chat/tools/choices/index.d.ts

@@ -0,0 +1 @@
+export { presentChoicesClient, CHOICES_TOOL_PROMPT, renderChoices, type ChoiceOption, } from "./choices-tool";

package/dist/registry/ai-chat/tools/choices/index.js

@@ -0,0 +1,2 @@
+import { CHOICES_TOOL_PROMPT, presentChoicesClient, renderChoices } from "./choices-tool.js";
+export { CHOICES_TOOL_PROMPT, presentChoicesClient, renderChoices };

package/dist/registry/ai-chat/tools/data-fabric/index.d.ts

@@ -0,0 +1,7 @@
+export { createDataFabricBarTool } from "../data-fabric-bar";
+export { createDataFabricDistributionTool } from "../data-fabric-distribution";
+export { createDataFabricKpiTool } from "../data-fabric-kpi";
+export { createDataFabricLineTool } from "../data-fabric-line";
+export { createDataFabricMultiLineTool } from "../data-fabric-multi-line";
+export { createDataFabricTableTool } from "../data-fabric-table";
+export { type DataFabricToolContext, type Entity, type EntityField, generateEntityFieldsDocs, } from "./util/entities";