@object-ui/plugin-chatbot 3.1.5 → 3.3.0

package/dist/{src → packages/plugin-chatbot/src}/ChatbotEnhanced.d.ts

@@ -20,7 +20,15 @@ export interface ChatbotEnhancedProps extends React.HTMLAttributes<HTMLDivElemen
     placeholder?: string;
     onSendMessage?: (message: string, files?: File[]) => void;
     onClear?: () => void;
+    /** Stop the current streaming response (API mode only) */
+    onStop?: () => void;
+    /** Reload / retry the last assistant message (API mode only) */
+    onReload?: () => void;
     disabled?: boolean;
+    /** Whether the assistant is currently generating a response */
+    isLoading?: boolean;
+    /** Current streaming/API error */
+    error?: Error;
     showTimestamp?: boolean;
     userAvatarUrl?: string;
     userAvatarFallback?: string;

package/dist/packages/plugin-chatbot/src/ChatbotEnhanced.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"ChatbotEnhanced.d.ts","sourceRoot":"","sources":["../../../../src/ChatbotEnhanced.tsx"],"names":[],"mappings":"AAAA;;;;;;GAMG;AAEH,OAAO,KAAK,KAAK,MAAM,OAAO,CAAA;AAS9B,MAAM,WAAW,WAAW;IAC1B,EAAE,EAAE,MAAM,CAAA;IACV,IAAI,EAAE,MAAM,GAAG,WAAW,GAAG,QAAQ,CAAA;IACrC,OAAO,EAAE,MAAM,CAAA;IACf,SAAS,CAAC,EAAE,MAAM,CAAA;IAClB,MAAM,CAAC,EAAE,MAAM,CAAA;IACf,cAAc,CAAC,EAAE,MAAM,CAAA;IACvB,SAAS,CAAC,EAAE,OAAO,CAAA;CACpB;AAED,MAAM,WAAW,oBAAqB,SAAQ,KAAK,CAAC,cAAc,CAAC,cAAc,CAAC;IAChF,QAAQ,CAAC,EAAE,WAAW,EAAE,CAAA;IACxB,WAAW,CAAC,EAAE,MAAM,CAAA;IACpB,aAAa,CAAC,EAAE,CAAC,OAAO,EAAE,MAAM,EAAE,KAAK,CAAC,EAAE,IAAI,EAAE,KAAK,IAAI,CAAA;IACzD,OAAO,CAAC,EAAE,MAAM,IAAI,CAAA;IACpB,0DAA0D;IAC1D,MAAM,CAAC,EAAE,MAAM,IAAI,CAAA;IACnB,gEAAgE;IAChE,QAAQ,CAAC,EAAE,MAAM,IAAI,CAAA;IACrB,QAAQ,CAAC,EAAE,OAAO,CAAA;IAClB,+DAA+D;IAC/D,SAAS,CAAC,EAAE,OAAO,CAAA;IACnB,kCAAkC;IAClC,KAAK,CAAC,EAAE,KAAK,CAAA;IACb,aAAa,CAAC,EAAE,OAAO,CAAA;IACvB,aAAa,CAAC,EAAE,MAAM,CAAA;IACtB,kBAAkB,CAAC,EAAE,MAAM,CAAA;IAC3B,kBAAkB,CAAC,EAAE,MAAM,CAAA;IAC3B,uBAAuB,CAAC,EAAE,MAAM,CAAA;IAChC,SAAS,CAAC,EAAE,MAAM,CAAA;IAClB,cAAc,CAAC,EAAE,OAAO,CAAA;IACxB,gBAAgB,CAAC,EAAE,OAAO,CAAA;IAC1B,iBAAiB,CAAC,EAAE,MAAM,CAAA;IAC1B,WAAW,CAAC,EAAE,MAAM,CAAA;IACpB,iBAAiB,CAAC,EAAE,CAAC,SAAS,EAAE,MAAM,EAAE,OAAO,EAAE,MAAM,KAAK,IAAI,CAAA;CACjE;AAiED,QAAA,MAAM,eAAe,6FAgTpB,CAAA;AAID,OAAO,EAAE,eAAe,EAAE,CAAA"}

package/dist/packages/plugin-chatbot/src/FloatingChatbot.d.ts

@@ -0,0 +1,15 @@
+import { FloatingChatbotConfig } from '@object-ui/types';
+import { ChatbotEnhancedProps } from './ChatbotEnhanced';
+export interface FloatingChatbotProps extends ChatbotEnhancedProps {
+    /** Floating configuration */
+    floatingConfig?: FloatingChatbotConfig;
+}
+/**
+ * Floating Chatbot — Airtable-style FAB widget.
+ *
+ * Wraps `ChatbotEnhanced` in a floating panel that can be toggled
+ * via a fixed FAB trigger button. Uses React portal to avoid
+ * DOM/z-index conflicts.
+ */
+export declare function FloatingChatbot({ floatingConfig, ...chatbotProps }: FloatingChatbotProps): import("react/jsx-runtime").JSX.Element;
+//# sourceMappingURL=FloatingChatbot.d.ts.map

package/dist/packages/plugin-chatbot/src/FloatingChatbot.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"FloatingChatbot.d.ts","sourceRoot":"","sources":["../../../../src/FloatingChatbot.tsx"],"names":[],"mappings":"AAAA;;;;;;GAMG;AAIH,OAAO,KAAK,EAAE,qBAAqB,EAAE,MAAM,kBAAkB,CAAA;AAI7D,OAAO,EAAmB,KAAK,oBAAoB,EAAE,MAAM,mBAAmB,CAAA;AAE9E,MAAM,WAAW,oBAAqB,SAAQ,oBAAoB;IAChE,6BAA6B;IAC7B,cAAc,CAAC,EAAE,qBAAqB,CAAA;CACvC;AAED;;;;;;GAMG;AACH,wBAAgB,eAAe,CAAC,EAC9B,cAAc,EACd,GAAG,YAAY,EAChB,EAAE,oBAAoB,2CAyDtB"}

package/dist/packages/plugin-chatbot/src/FloatingChatbotPanel.d.ts

@@ -0,0 +1,29 @@
+/**
+ * ObjectUI
+ * Copyright (c) 2024-present ObjectStack Inc.
+ *
+ * This source code is licensed under the MIT license found in the
+ * LICENSE file in the root directory of this source tree.
+ */
+import * as React from "react";
+export interface FloatingChatbotPanelProps {
+    /** Panel title */
+    title?: string;
+    /** Position of the panel (anchored to FAB corner) */
+    position?: "bottom-right" | "bottom-left";
+    /** Panel width in pixels (ignored in fullscreen) */
+    width?: number;
+    /** Panel height in pixels (ignored in fullscreen) */
+    height?: number;
+    /** Content to render inside the panel body */
+    children: React.ReactNode;
+    /** Custom className for the panel container */
+    className?: string;
+}
+/**
+ * Floating panel overlay for the chatbot.
+ * Renders above all content, anchored to the configured position.
+ * Supports fullscreen toggle and close.
+ */
+export declare function FloatingChatbotPanel({ title, position, width, height, children, className, }: FloatingChatbotPanelProps): import("react/jsx-runtime").JSX.Element | null;
+//# sourceMappingURL=FloatingChatbotPanel.d.ts.map

package/dist/packages/plugin-chatbot/src/FloatingChatbotPanel.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"FloatingChatbotPanel.d.ts","sourceRoot":"","sources":["../../../../src/FloatingChatbotPanel.tsx"],"names":[],"mappings":"AAAA;;;;;;GAMG;AAEH,OAAO,KAAK,KAAK,MAAM,OAAO,CAAA;AAM9B,MAAM,WAAW,yBAAyB;IACxC,kBAAkB;IAClB,KAAK,CAAC,EAAE,MAAM,CAAA;IACd,qDAAqD;IACrD,QAAQ,CAAC,EAAE,cAAc,GAAG,aAAa,CAAA;IACzC,oDAAoD;IACpD,KAAK,CAAC,EAAE,MAAM,CAAA;IACd,qDAAqD;IACrD,MAAM,CAAC,EAAE,MAAM,CAAA;IACf,8CAA8C;IAC9C,QAAQ,EAAE,KAAK,CAAC,SAAS,CAAA;IACzB,+CAA+C;IAC/C,SAAS,CAAC,EAAE,MAAM,CAAA;CACnB;AAED;;;;GAIG;AACH,wBAAgB,oBAAoB,CAAC,EACnC,KAAc,EACd,QAAyB,EACzB,KAAW,EACX,MAAY,EACZ,QAAQ,EACR,SAAS,GACV,EAAE,yBAAyB,kDA4D3B"}

package/dist/packages/plugin-chatbot/src/FloatingChatbotProvider.d.ts

@@ -0,0 +1,37 @@
+/**
+ * ObjectUI
+ * Copyright (c) 2024-present ObjectStack Inc.
+ *
+ * This source code is licensed under the MIT license found in the
+ * LICENSE file in the root directory of this source tree.
+ */
+import * as React from "react";
+export interface FloatingChatbotState {
+    /** Whether the floating panel is currently open */
+    isOpen: boolean;
+    /** Whether the panel is in fullscreen mode */
+    isFullscreen: boolean;
+}
+export interface FloatingChatbotActions {
+    /** Open the floating panel */
+    open: () => void;
+    /** Close the floating panel */
+    close: () => void;
+    /** Toggle the floating panel open/closed */
+    toggle: () => void;
+    /** Toggle fullscreen mode */
+    toggleFullscreen: () => void;
+}
+export type FloatingChatbotContextValue = FloatingChatbotState & FloatingChatbotActions;
+export interface FloatingChatbotProviderProps {
+    /** Whether the panel is open by default */
+    defaultOpen?: boolean;
+    children: React.ReactNode;
+}
+export declare function FloatingChatbotProvider({ defaultOpen, children, }: FloatingChatbotProviderProps): import("react/jsx-runtime").JSX.Element;
+/**
+ * Hook to access the floating chatbot state and actions.
+ * Must be used within a `FloatingChatbotProvider`.
+ */
+export declare function useFloatingChatbot(): FloatingChatbotContextValue;
+//# sourceMappingURL=FloatingChatbotProvider.d.ts.map

package/dist/packages/plugin-chatbot/src/FloatingChatbotProvider.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"FloatingChatbotProvider.d.ts","sourceRoot":"","sources":["../../../../src/FloatingChatbotProvider.tsx"],"names":[],"mappings":"AAAA;;;;;;GAMG;AAEH,OAAO,KAAK,KAAK,MAAM,OAAO,CAAA;AAE9B,MAAM,WAAW,oBAAoB;IACnC,mDAAmD;IACnD,MAAM,EAAE,OAAO,CAAA;IACf,8CAA8C;IAC9C,YAAY,EAAE,OAAO,CAAA;CACtB;AAED,MAAM,WAAW,sBAAsB;IACrC,8BAA8B;IAC9B,IAAI,EAAE,MAAM,IAAI,CAAA;IAChB,+BAA+B;IAC/B,KAAK,EAAE,MAAM,IAAI,CAAA;IACjB,4CAA4C;IAC5C,MAAM,EAAE,MAAM,IAAI,CAAA;IAClB,6BAA6B;IAC7B,gBAAgB,EAAE,MAAM,IAAI,CAAA;CAC7B;AAED,MAAM,MAAM,2BAA2B,GAAG,oBAAoB,GAAG,sBAAsB,CAAA;AAIvF,MAAM,WAAW,4BAA4B;IAC3C,2CAA2C;IAC3C,WAAW,CAAC,EAAE,OAAO,CAAA;IACrB,QAAQ,EAAE,KAAK,CAAC,SAAS,CAAA;CAC1B;AAED,wBAAgB,uBAAuB,CAAC,EACtC,WAAmB,EACnB,QAAQ,GACT,EAAE,4BAA4B,2CAwB9B;AAED;;;GAGG;AACH,wBAAgB,kBAAkB,IAAI,2BAA2B,CAQhE"}

package/dist/packages/plugin-chatbot/src/FloatingChatbotTrigger.d.ts

@@ -0,0 +1,21 @@
+/**
+ * ObjectUI
+ * Copyright (c) 2024-present ObjectStack Inc.
+ *
+ * This source code is licensed under the MIT license found in the
+ * LICENSE file in the root directory of this source tree.
+ */
+export interface FloatingChatbotTriggerProps {
+    /** Position of the FAB */
+    position?: "bottom-right" | "bottom-left";
+    /** Size of the trigger button in pixels */
+    size?: number;
+    /** Custom className */
+    className?: string;
+}
+/**
+ * Floating Action Button (FAB) trigger for the chatbot.
+ * Renders a circular button fixed to the viewport corner.
+ */
+export declare function FloatingChatbotTrigger({ position, size, className, }: FloatingChatbotTriggerProps): import("react/jsx-runtime").JSX.Element;
+//# sourceMappingURL=FloatingChatbotTrigger.d.ts.map

package/dist/packages/plugin-chatbot/src/FloatingChatbotTrigger.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"FloatingChatbotTrigger.d.ts","sourceRoot":"","sources":["../../../../src/FloatingChatbotTrigger.tsx"],"names":[],"mappings":"AAAA;;;;;;GAMG;AAQH,MAAM,WAAW,2BAA2B;IAC1C,0BAA0B;IAC1B,QAAQ,CAAC,EAAE,cAAc,GAAG,aAAa,CAAA;IACzC,2CAA2C;IAC3C,IAAI,CAAC,EAAE,MAAM,CAAA;IACb,uBAAuB;IACvB,SAAS,CAAC,EAAE,MAAM,CAAA;CACnB;AAED;;;GAGG;AACH,wBAAgB,sBAAsB,CAAC,EACrC,QAAyB,EACzB,IAAS,EACT,SAAS,GACV,EAAE,2BAA2B,2CAuB7B"}

package/dist/{src → packages/plugin-chatbot/src}/index.d.ts

@@ -41,5 +41,15 @@ export interface TypingIndicatorProps extends React.HTMLAttributes<HTMLDivElemen
 }
 declare const TypingIndicator: React.ForwardRefExoticComponent<TypingIndicatorProps & React.RefAttributes<HTMLDivElement>>;
 export { Chatbot, TypingIndicator };
+export { useObjectChat } from './useObjectChat';
+export type { UseObjectChatOptions, UseObjectChatReturn } from './useObjectChat';
+export { FloatingChatbot } from './FloatingChatbot';
+export type { FloatingChatbotProps } from './FloatingChatbot';
+export { FloatingChatbotProvider, useFloatingChatbot } from './FloatingChatbotProvider';
+export type { FloatingChatbotProviderProps, FloatingChatbotState, FloatingChatbotActions, FloatingChatbotContextValue, } from './FloatingChatbotProvider';
+export { FloatingChatbotTrigger } from './FloatingChatbotTrigger';
+export type { FloatingChatbotTriggerProps } from './FloatingChatbotTrigger';
+export { FloatingChatbotPanel } from './FloatingChatbotPanel';
+export type { FloatingChatbotPanelProps } from './FloatingChatbotPanel';
 export * from './renderer';
 //# sourceMappingURL=index.d.ts.map

package/dist/packages/plugin-chatbot/src/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../../src/index.tsx"],"names":[],"mappings":"AAAA;;;;;;GAMG;AAEH,OAAO,KAAK,KAAK,MAAM,OAAO,CAAA;AAM9B,MAAM,WAAW,WAAW;IAC1B,EAAE,EAAE,MAAM,CAAA;IACV,IAAI,EAAE,MAAM,GAAG,WAAW,GAAG,QAAQ,CAAA;IACrC,OAAO,EAAE,MAAM,CAAA;IACf,SAAS,CAAC,EAAE,MAAM,CAAA;IAClB,MAAM,CAAC,EAAE,MAAM,CAAA;IACf,cAAc,CAAC,EAAE,MAAM,CAAA;CACxB;AAGD,MAAM,WAAW,YAAa,SAAQ,KAAK,CAAC,cAAc,CAAC,cAAc,CAAC;IACxE,QAAQ,CAAC,EAAE,WAAW,EAAE,CAAA;IACxB,WAAW,CAAC,EAAE,MAAM,CAAA;IACpB,aAAa,CAAC,EAAE,CAAC,OAAO,EAAE,MAAM,KAAK,IAAI,CAAA;IACzC,QAAQ,CAAC,EAAE,OAAO,CAAA;IAClB,aAAa,CAAC,EAAE,OAAO,CAAA;IACvB,aAAa,CAAC,EAAE,MAAM,CAAA;IACtB,kBAAkB,CAAC,EAAE,MAAM,CAAA;IAC3B,kBAAkB,CAAC,EAAE,MAAM,CAAA;IAC3B,uBAAuB,CAAC,EAAE,MAAM,CAAA;IAChC,SAAS,CAAC,EAAE,MAAM,CAAA;CACnB;AAGD,QAAA,MAAM,OAAO,qFAwGZ,CAAA;AAID,MAAM,WAAW,gBAAgB;IAC/B,OAAO,EAAE,WAAW,CAAA;IACpB,aAAa,CAAC,EAAE,OAAO,CAAA;IACvB,aAAa,CAAC,EAAE,MAAM,CAAA;IACtB,kBAAkB,CAAC,EAAE,MAAM,CAAA;IAC3B,kBAAkB,CAAC,EAAE,MAAM,CAAA;IAC3B,uBAAuB,CAAC,EAAE,MAAM,CAAA;CACjC;AAiED,MAAM,WAAW,oBAAqB,SAAQ,KAAK,CAAC,cAAc,CAAC,cAAc,CAAC;IAChF,SAAS,CAAC,EAAE,MAAM,CAAA;IAClB,cAAc,CAAC,EAAE,MAAM,CAAA;CACxB;AAED,QAAA,MAAM,eAAe,6FAkBpB,CAAA;AAGD,OAAO,EAAE,OAAO,EAAE,eAAe,EAAE,CAAA;AAGnC,OAAO,EAAE,aAAa,EAAE,MAAM,iBAAiB,CAAC;AAChD,YAAY,EAAE,oBAAoB,EAAE,mBAAmB,EAAE,MAAM,iBAAiB,CAAC;AAGjF,OAAO,EAAE,eAAe,EAAE,MAAM,mBAAmB,CAAC;AACpD,YAAY,EAAE,oBAAoB,EAAE,MAAM,mBAAmB,CAAC;AAC9D,OAAO,EAAE,uBAAuB,EAAE,kBAAkB,EAAE,MAAM,2BAA2B,CAAC;AACxF,YAAY,EACV,4BAA4B,EAC5B,oBAAoB,EACpB,sBAAsB,EACtB,2BAA2B,GAC5B,MAAM,2BAA2B,CAAC;AACnC,OAAO,EAAE,sBAAsB,EAAE,MAAM,0BAA0B,CAAC;AAClE,YAAY,EAAE,2BAA2B,EAAE,MAAM,0BAA0B,CAAC;AAC5E,OAAO,EAAE,oBAAoB,EAAE,MAAM,wBAAwB,CAAC;AAC9D,YAAY,EAAE,yBAAyB,EAAE,MAAM,wBAAwB,CAAC;AAGxE,cAAc,YAAY,CAAC"}

package/dist/packages/plugin-chatbot/src/renderer.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"renderer.d.ts","sourceRoot":"","sources":["../../../../src/renderer.tsx"],"names":[],"mappings":"AAAA;;;;;;GAMG"}

package/dist/packages/plugin-chatbot/src/useObjectChat.d.ts

@@ -0,0 +1,112 @@
+import { ChatMessage as OuiChatMessage } from '@object-ui/types';
+/**
+ * Configuration options for useObjectChat hook.
+ */
+export interface UseObjectChatOptions {
+    /**
+     * Backend API endpoint for streaming chat.
+     * When provided, uses @ai-sdk/react useChat for SSE streaming.
+     * When absent, operates in local/legacy mode.
+     */
+    api?: string;
+    /**
+     * Initial messages to populate the chat.
+     */
+    initialMessages?: OuiChatMessage[];
+    /**
+     * Conversation ID for multi-turn context.
+     */
+    conversationId?: string;
+    /**
+     * System prompt for the assistant.
+     */
+    systemPrompt?: string;
+    /**
+     * AI model identifier.
+     */
+    model?: string;
+    /**
+     * Whether streaming is enabled.
+     * @default true
+     */
+    streamingEnabled?: boolean;
+    /**
+     * Additional headers to send with API requests.
+     */
+    headers?: Record<string, string>;
+    /**
+     * Additional body parameters for each API request.
+     */
+    body?: Record<string, unknown>;
+    /**
+     * Maximum tool-calling round-trips per message.
+     * @default 5
+     */
+    maxToolRoundtrips?: number;
+    /**
+     * Error callback.
+     */
+    onError?: (error: Error) => void;
+    /**
+     * Show timestamps on messages.
+     */
+    showTimestamp?: boolean;
+    /**
+     * Enable local auto-response (legacy/demo mode). Ignored when `api` is set.
+     */
+    autoResponse?: boolean;
+    /**
+     * Auto-response text for legacy/demo mode.
+     */
+    autoResponseText?: string;
+    /**
+     * Auto-response delay in ms for legacy/demo mode.
+     * @default 1000
+     */
+    autoResponseDelay?: number;
+    /**
+     * External send callback (fires for both modes).
+     */
+    onSend?: (content: string, messages: OuiChatMessage[]) => void;
+}
+/**
+ * Return type of useObjectChat.
+ */
+export interface UseObjectChatReturn {
+    /** Current chat messages */
+    messages: OuiChatMessage[];
+    /** Whether the assistant is currently generating a response */
+    isLoading: boolean;
+    /** Current error, if any */
+    error: Error | undefined;
+    /** Send a new user message */
+    sendMessage: (content: string, files?: File[]) => void;
+    /** Stop the current streaming response */
+    stop: () => void;
+    /** Reload / retry the last assistant message */
+    reload: () => void;
+    /** Clear all messages */
+    clear: () => void;
+    /** Whether the hook is operating in API (streaming) mode */
+    isApiMode: boolean;
+    /** Input value (controlled by the hook for API mode) */
+    input: string;
+    /** Set input value */
+    setInput: (value: string) => void;
+    /** Handle input change event */
+    handleInputChange: (e: React.ChangeEvent<HTMLInputElement | HTMLTextAreaElement>) => void;
+}
+/**
+ * useObjectChat – Composable hook for ObjectUI Chatbot.
+ *
+ * When `api` is provided, delegates to @ai-sdk/react's useChat for
+ * SSE streaming, tool-calling, and production-grade chat.
+ *
+ * When `api` is absent, operates in local/legacy mode with optional
+ * auto-response for demos and playground use.
+ *
+ * The mode is locked on first render to satisfy the Rules of Hooks.
+ * If `api` changes after mount, the mode will NOT switch dynamically.
+ */
+export declare function useObjectChat(options?: UseObjectChatOptions): UseObjectChatReturn;
+//# sourceMappingURL=useObjectChat.d.ts.map

package/dist/packages/plugin-chatbot/src/useObjectChat.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"useObjectChat.d.ts","sourceRoot":"","sources":["../../../../src/useObjectChat.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AAGH,OAAO,KAAK,EAAE,WAAW,IAAI,cAAc,EAAE,MAAM,kBAAkB,CAAC;AAItE;;GAEG;AACH,MAAM,WAAW,oBAAoB;IACnC;;;;OAIG;IACH,GAAG,CAAC,EAAE,MAAM,CAAC;IACb;;OAEG;IACH,eAAe,CAAC,EAAE,cAAc,EAAE,CAAC;IACnC;;OAEG;IACH,cAAc,CAAC,EAAE,MAAM,CAAC;IACxB;;OAEG;IACH,YAAY,CAAC,EAAE,MAAM,CAAC;IACtB;;OAEG;IACH,KAAK,CAAC,EAAE,MAAM,CAAC;IACf;;;OAGG;IACH,gBAAgB,CAAC,EAAE,OAAO,CAAC;IAC3B;;OAEG;IACH,OAAO,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;IACjC;;OAEG;IACH,IAAI,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;IAC/B;;;OAGG;IACH,iBAAiB,CAAC,EAAE,MAAM,CAAC;IAC3B;;OAEG;IACH,OAAO,CAAC,EAAE,CAAC,KAAK,EAAE,KAAK,KAAK,IAAI,CAAC;IACjC;;OAEG;IACH,aAAa,CAAC,EAAE,OAAO,CAAC;IAGxB;;OAEG;IACH,YAAY,CAAC,EAAE,OAAO,CAAC;IACvB;;OAEG;IACH,gBAAgB,CAAC,EAAE,MAAM,CAAC;IAC1B;;;OAGG;IACH,iBAAiB,CAAC,EAAE,MAAM,CAAC;IAC3B;;OAEG;IACH,MAAM,CAAC,EAAE,CAAC,OAAO,EAAE,MAAM,EAAE,QAAQ,EAAE,cAAc,EAAE,KAAK,IAAI,CAAC;CAChE;AAED;;GAEG;AACH,MAAM,WAAW,mBAAmB;IAClC,4BAA4B;IAC5B,QAAQ,EAAE,cAAc,EAAE,CAAC;IAC3B,+DAA+D;IAC/D,SAAS,EAAE,OAAO,CAAC;IACnB,4BAA4B;IAC5B,KAAK,EAAE,KAAK,GAAG,SAAS,CAAC;IACzB,8BAA8B;IAC9B,WAAW,EAAE,CAAC,OAAO,EAAE,MAAM,EAAE,KAAK,CAAC,EAAE,IAAI,EAAE,KAAK,IAAI,CAAC;IACvD,0CAA0C;IAC1C,IAAI,EAAE,MAAM,IAAI,CAAC;IACjB,gDAAgD;IAChD,MAAM,EAAE,MAAM,IAAI,CAAC;IACnB,yBAAyB;IACzB,KAAK,EAAE,MAAM,IAAI,CAAC;IAClB,4DAA4D;IAC5D,SAAS,EAAE,OAAO,CAAC;IACnB,wDAAwD;IACxD,KAAK,EAAE,MAAM,CAAC;IACd,sBAAsB;IACtB,QAAQ,EAAE,CAAC,KAAK,EAAE,MAAM,KAAK,IAAI,CAAC;IAClC,gCAAgC;IAChC,iBAAiB,EAAE,CAAC,CAAC,EAAE,KAAK,CAAC,WAAW,CAAC,gBAAgB,GAAG,mBAAmB,CAAC,KAAK,IAAI,CAAC;CAC3F;AAmBD;;;;;;;;;;;GAWG;AACH,wBAAgB,aAAa,CAAC,OAAO,GAAE,oBAAyB,GAAG,mBAAmB,CAwMrF"}

package/dist/packages/plugin-chatbot/src/utils.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"utils.d.ts","sourceRoot":"","sources":["../../../../src/utils.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AAEH;;;GAGG;AACH,wBAAgB,gBAAgB,CAAC,MAAM,SAAQ,GAAG,MAAM,CAKvD"}

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@object-ui/plugin-chatbot",
-  "version": "3.1.5",
+  "version": "3.3.0",
   "type": "module",
   "license": "MIT",
   "description": "Chatbot interface plugin for Object UI",
@@ -24,14 +24,16 @@
     }
   },
   "dependencies": {
-    "lucide-react": "^0.577.0",
+    "@ai-sdk/react": "^3.0.160",
+    "ai": "^6.0.158",
+    "lucide-react": "^1.8.0",
     "react-markdown": "^10.1.0",
     "react-syntax-highlighter": "^16.1.1",
     "remark-gfm": "^4.0.1",
-    "@object-ui/components": "3.1.5",
-    "@object-ui/core": "3.1.5",
-    "@object-ui/react": "3.1.5",
-    "@object-ui/types": "3.1.5"
+    "@object-ui/components": "3.3.0",
+    "@object-ui/core": "3.3.0",
+    "@object-ui/react": "3.3.0",
+    "@object-ui/types": "3.3.0"
   },
   "peerDependencies": {
     "react": "^18.0.0 || ^19.0.0",
@@ -42,8 +44,8 @@
     "@types/react-dom": "19.2.3",
     "@types/react-syntax-highlighter": "^15.5.13",
     "@vitejs/plugin-react": "^6.0.1",
-    "typescript": "^5.9.3",
-    "vite": "^8.0.1",
+    "typescript": "^6.0.2",
+    "vite": "^8.0.8",
     "vite-plugin-dts": "^4.5.4"
   },
   "scripts": {

package/src/ChatbotEnhanced.tsx

@@ -9,7 +9,7 @@
 import * as React from "react"
 import { cn } from "@object-ui/components"
 import { Button, Input, ScrollArea, Avatar, AvatarFallback, AvatarImage } from "@object-ui/components"
-import { Send, Trash2, Paperclip, X } from "lucide-react"
+import { Send, Trash2, Paperclip, X, Square, RefreshCw, AlertCircle } from "lucide-react"
 import ReactMarkdown from "react-markdown"
 import { Prism as SyntaxHighlighter } from "react-syntax-highlighter"
 import { oneDark } from "react-syntax-highlighter/dist/esm/styles/prism"
@@ -30,7 +30,15 @@ export interface ChatbotEnhancedProps extends React.HTMLAttributes<HTMLDivElemen
   placeholder?: string
   onSendMessage?: (message: string, files?: File[]) => void
   onClear?: () => void
+  /** Stop the current streaming response (API mode only) */
+  onStop?: () => void
+  /** Reload / retry the last assistant message (API mode only) */
+  onReload?: () => void
   disabled?: boolean
+  /** Whether the assistant is currently generating a response */
+  isLoading?: boolean
+  /** Current streaming/API error */
+  error?: Error
   showTimestamp?: boolean
   userAvatarUrl?: string
   userAvatarFallback?: string
@@ -115,7 +123,11 @@ const ChatbotEnhanced = React.forwardRef<HTMLDivElement, ChatbotEnhancedProps>(
       placeholder = "Type your message...",
       onSendMessage,
       onClear,
+      onStop,
+      onReload,
       disabled = false,
+      isLoading = false,
+      error,
       showTimestamp = false,
       userAvatarUrl,
       userAvatarFallback = "You",
@@ -155,6 +167,9 @@ const ChatbotEnhanced = React.forwardRef<HTMLDivElement, ChatbotEnhancedProps>(
       }
     }
 
+    const isInputDisabled = disabled || isLoading
+    const isSendDisabled = isInputDisabled || (!inputValue.trim() && selectedFiles.length === 0)
+
     const handleKeyDown = (e: React.KeyboardEvent<HTMLInputElement>) => {
       if (e.key === "Enter" && !e.shiftKey) {
         e.preventDefault()
@@ -322,6 +337,42 @@ const ChatbotEnhanced = React.forwardRef<HTMLDivElement, ChatbotEnhancedProps>(
           </div>
         )}
 
+        {/* Error display */}
+        {error && (
+          <div className="flex items-center gap-2 px-4 py-2 border-t bg-destructive/10 text-destructive text-sm" role="alert">
+            <AlertCircle className="h-4 w-4 flex-shrink-0" />
+            <span className="flex-1 truncate">{error.message || 'An error occurred'}</span>
+            {onReload && (
+              <Button
+                variant="ghost"
+                size="sm"
+                onClick={onReload}
+                className="h-7 text-xs"
+                aria-label="Retry"
+              >
+                <RefreshCw className="h-3 w-3 mr-1" />
+                Retry
+              </Button>
+            )}
+          </div>
+        )}
+
+        {/* Streaming controls */}
+        {isLoading && onStop && (
+          <div className="flex items-center justify-center px-4 py-2 border-t">
+            <Button
+              variant="outline"
+              size="sm"
+              onClick={onStop}
+              className="h-8 text-xs"
+              aria-label="Stop generating"
+            >
+              <Square className="h-3 w-3 mr-1" />
+              Stop generating
+            </Button>
+          </div>
+        )}
+
         {/* Input area */}
         <div className="flex items-center gap-2 p-4 border-t">
           {enableFileUpload && (
@@ -338,7 +389,7 @@ const ChatbotEnhanced = React.forwardRef<HTMLDivElement, ChatbotEnhancedProps>(
                 variant="ghost"
                 size="icon"
                 onClick={() => fileInputRef.current?.click()}
-                disabled={disabled}
+                disabled={isInputDisabled}
                 aria-label="Attach file"
               >
                 <Paperclip className="h-4 w-4" />
@@ -352,13 +403,13 @@ const ChatbotEnhanced = React.forwardRef<HTMLDivElement, ChatbotEnhancedProps>(
             onChange={(e) => setInputValue(e.target.value)}
             onKeyDown={handleKeyDown}
             placeholder={placeholder}
-            disabled={disabled}
+            disabled={isInputDisabled}
             className="flex-1"
           />
           
           <Button
             onClick={handleSend}
-            disabled={disabled || (!inputValue.trim() && selectedFiles.length === 0)}
+            disabled={isSendDisabled}
             size="icon"
             aria-label="Send message"
           >

package/src/FloatingChatbot.tsx

@@ -0,0 +1,89 @@
+/**
+ * ObjectUI
+ * Copyright (c) 2024-present ObjectStack Inc.
+ *
+ * This source code is licensed under the MIT license found in the
+ * LICENSE file in the root directory of this source tree.
+ */
+
+import * as React from "react"
+import * as ReactDOM from "react-dom"
+import type { FloatingChatbotConfig } from "@object-ui/types"
+import { FloatingChatbotProvider } from "./FloatingChatbotProvider"
+import { FloatingChatbotTrigger } from "./FloatingChatbotTrigger"
+import { FloatingChatbotPanel } from "./FloatingChatbotPanel"
+import { ChatbotEnhanced, type ChatbotEnhancedProps } from "./ChatbotEnhanced"
+
+export interface FloatingChatbotProps extends ChatbotEnhancedProps {
+  /** Floating configuration */
+  floatingConfig?: FloatingChatbotConfig
+}
+
+/**
+ * Floating Chatbot — Airtable-style FAB widget.
+ *
+ * Wraps `ChatbotEnhanced` in a floating panel that can be toggled
+ * via a fixed FAB trigger button. Uses React portal to avoid
+ * DOM/z-index conflicts.
+ */
+export function FloatingChatbot({
+  floatingConfig,
+  ...chatbotProps
+}: FloatingChatbotProps) {
+  const {
+    position = "bottom-right",
+    defaultOpen = false,
+    panelWidth = 400,
+    panelHeight = 520,
+    title = "Chat",
+    triggerSize = 56,
+  } = floatingConfig ?? {}
+
+  const [portalContainer, setPortalContainer] = React.useState<HTMLElement | null>(null)
+
+  React.useEffect(() => {
+    // Create a portal root so the floating UI sits outside the normal DOM tree
+    let container = document.getElementById("floating-chatbot-portal")
+    if (!container) {
+      container = document.createElement("div")
+      container.id = "floating-chatbot-portal"
+      document.body.appendChild(container)
+    }
+    setPortalContainer(container)
+
+    return () => {
+      // Only remove if we created it and it's still in the DOM
+      if (container && container.parentNode && !container.hasChildNodes()) {
+        container.parentNode.removeChild(container)
+      }
+    }
+  }, [])
+
+  const content = (
+    <FloatingChatbotProvider defaultOpen={defaultOpen}>
+      <FloatingChatbotTrigger
+        position={position}
+        size={triggerSize}
+      />
+      <FloatingChatbotPanel
+        title={title}
+        position={position}
+        width={panelWidth}
+        height={panelHeight}
+      >
+        <ChatbotEnhanced
+          {...chatbotProps}
+          maxHeight="100%"
+          className="h-full border-0 rounded-none"
+        />
+      </FloatingChatbotPanel>
+    </FloatingChatbotProvider>
+  )
+
+  // Use portal rendering when in browser, fallback to inline for SSR / tests
+  if (portalContainer) {
+    return ReactDOM.createPortal(content, portalContainer)
+  }
+
+  return content
+}

package/src/FloatingChatbotPanel.tsx

@@ -0,0 +1,102 @@
+/**
+ * ObjectUI
+ * Copyright (c) 2024-present ObjectStack Inc.
+ *
+ * This source code is licensed under the MIT license found in the
+ * LICENSE file in the root directory of this source tree.
+ */
+
+import * as React from "react"
+import { cn } from "@object-ui/components"
+import { Button } from "@object-ui/components"
+import { X, Maximize2, Minimize2 } from "lucide-react"
+import { useFloatingChatbot } from "./FloatingChatbotProvider"
+
+export interface FloatingChatbotPanelProps {
+  /** Panel title */
+  title?: string
+  /** Position of the panel (anchored to FAB corner) */
+  position?: "bottom-right" | "bottom-left"
+  /** Panel width in pixels (ignored in fullscreen) */
+  width?: number
+  /** Panel height in pixels (ignored in fullscreen) */
+  height?: number
+  /** Content to render inside the panel body */
+  children: React.ReactNode
+  /** Custom className for the panel container */
+  className?: string
+}
+
+/**
+ * Floating panel overlay for the chatbot.
+ * Renders above all content, anchored to the configured position.
+ * Supports fullscreen toggle and close.
+ */
+export function FloatingChatbotPanel({
+  title = "Chat",
+  position = "bottom-right",
+  width = 400,
+  height = 520,
+  children,
+  className,
+}: FloatingChatbotPanelProps) {
+  const { isOpen, isFullscreen, close, toggleFullscreen } = useFloatingChatbot()
+
+  if (!isOpen) return null
+
+  const panelStyle: React.CSSProperties = isFullscreen
+    ? { inset: 0, width: "100vw", height: "100vh" }
+    : { width, height, maxHeight: "calc(100vh - 100px)" }
+
+  return (
+    <div
+      className={cn(
+        "fixed z-50 flex flex-col rounded-lg border bg-background shadow-xl overflow-hidden transition-all",
+        isFullscreen
+          ? "inset-0 rounded-none"
+          : position === "bottom-right"
+            ? "right-6 bottom-20"
+            : "left-6 bottom-20",
+        className
+      )}
+      style={panelStyle}
+      role="dialog"
+      aria-label={title}
+      data-testid="floating-chatbot-panel"
+    >
+      {/* Header */}
+      <div className="flex items-center justify-between px-4 py-2 border-b bg-muted/40">
+        <span className="text-sm font-medium truncate">{title}</span>
+        <div className="flex items-center gap-1">
+          <Button
+            variant="ghost"
+            size="icon"
+            className="h-7 w-7"
+            onClick={toggleFullscreen}
+            aria-label={isFullscreen ? "Exit fullscreen" : "Fullscreen"}
+            data-testid="floating-chatbot-fullscreen"
+          >
+            {isFullscreen ? (
+              <Minimize2 className="h-4 w-4" />
+            ) : (
+              <Maximize2 className="h-4 w-4" />
+            )}
+          </Button>
+          <Button
+            variant="ghost"
+            size="icon"
+            className="h-7 w-7"
+            onClick={close}
+            aria-label="Close chat"
+            data-testid="floating-chatbot-close"
+          >
+            <X className="h-4 w-4" />
+          </Button>
+        </div>
+      </div>
+
+      {/* Body */}
+      <div className="flex-1 overflow-hidden">{children}</div>
+    </div>
+  )
+}