@uraiagent/react 0.0.5 → 0.0.7

package/dist/Widget.d.ts

@@ -1,6 +1,10 @@
 /**
- * The widget's UI shell — launcher trigger + chat panel. Internal: it must render
- * inside the providers set up by `Root`. Consumers use the unified `AgentWidget`
- * (which composes `Root` + this) instead of rendering it directly.
+ * The widget's UI shell. A fixed bottom-right dock holding two decoupled pieces:
+ * the standalone launcher, and the panel that mounts above it on open. The morphing
+ * single-surface launcher of the old design is gone — opening/closing is now a clean
+ * swap between the two, animated by framer-motion.
+ *
+ * Internal: must render inside the providers set up by `Root`. Consumers use the
+ * unified `AgentWidget` (which composes `Root` + this).
  */
 export declare function WidgetShell(): import("react/jsx-runtime").JSX.Element;

package/dist/components/Attachment/MessageAttachments.d.ts

@@ -0,0 +1,6 @@
+import { AttachmentRef } from '../../interfaces/messages';
+/** Renders a message's attachments: images as a wrapping row of small thumbnails
+ *  (Gleap-style), other file types as cards stacked below. */
+export declare function MessageAttachments({ attachments, }: {
+    attachments?: AttachmentRef[];
+}): import("react/jsx-runtime").JSX.Element | null;

package/dist/components/Chat/ChatFooter.d.ts

@@ -1 +1,7 @@
+/**
+ * The message composer. A single rounded card: the text area sits on top, and a
+ * toolbar row underneath holds the attach + voice actions on the left and a circular
+ * send button on the right. Always active (it only mounts inside the open panel's
+ * chat view), so there's no hover/open state to juggle.
+ */
 export declare function ChatFooter(): import("react/jsx-runtime").JSX.Element;

package/dist/components/Chat/ChatScreen.d.ts

@@ -1 +1,6 @@
+/**
+ * The conversation view. Header and launcher live at the panel/dock level now, so
+ * this is purely the scrollable message log + the composer. Always "open" — it only
+ * mounts when the panel's `chat` view is active.
+ */
 export declare function ChatScreen(): import("react/jsx-runtime").JSX.Element;

package/dist/components/Event/Text.d.ts

@@ -5,5 +5,5 @@ type Props = ComponentProps<{
 /**
  * The Basic Text component
  */
-export declare function Text({ _id, data, createdAt }: Props): import("react/jsx-runtime").JSX.Element;
+export declare function Text({ _id, data, createdAt, attachments }: Props): import("react/jsx-runtime").JSX.Element;
 export {};

package/dist/components/Launcher/WidgetLauncher.d.ts

@@ -0,0 +1,9 @@
+/**
+ * The standalone floating launcher — the only thing on screen when the widget is closed.
+ *
+ * It's fully decoupled from the panel now: clicking it opens the panel (which slides down
+ * into the launcher's corner) and the launcher itself scales/fades away. Closing reverses
+ * it. Keeps the original pulsing brand mark as the resting icon; while open it briefly shows
+ * a chevron so the affordance reads as "collapse back down".
+ */
+export declare function WidgetLauncher(): import("react/jsx-runtime").JSX.Element;

package/dist/components/Panel/PanelHeader.d.ts

@@ -0,0 +1,6 @@
+/**
+ * The panel's top bar. Keeps the original "Powered by uraiagent.com" strip (with the
+ * live connection dot) and owns the close affordance for the whole widget. On the chat
+ * screen it also offers a back arrow to the home screen.
+ */
+export declare function PanelHeader(): import("react/jsx-runtime").JSX.Element;

package/dist/components/Panel/WidgetPanel.d.ts

@@ -0,0 +1,7 @@
+/**
+ * The open widget surface. Mounts above the launcher and settles down into its
+ * corner (transform-origin bottom-right), so opening reads as the panel dropping
+ * into the launcher's place. Owns the header; the body cross-fades between the
+ * home screen and the conversation.
+ */
+export declare function WidgetPanel(): import("react/jsx-runtime").JSX.Element;

package/dist/components/Screens/HomeScreen.d.ts

@@ -0,0 +1,6 @@
+/**
+ * The panel's landing screen. Gradient hero up top (with a bottom-aligned brand +
+ * welcome block, like the earlier layout), then a clean body with the single primary
+ * action. Owns its own close control since the panel drops its top bar on this view.
+ */
+export declare function HomeScreen(): import("react/jsx-runtime").JSX.Element;

package/dist/components/User/UserMessage.d.ts

@@ -1,2 +1,2 @@
 import { UserMessageProps } from '../../interfaces/messages';
-export declare function UserMessage({ message, _id, createdAt }: UserMessageProps): import("react/jsx-runtime").JSX.Element;
+export declare function UserMessage({ message, _id, createdAt, attachments, }: UserMessageProps): import("react/jsx-runtime").JSX.Element;

package/dist/contexts/WidgetContext.d.ts

@@ -1,10 +1,19 @@
 import { ReactNode } from 'react';
+/** Which screen the open panel is showing. `home` = greeting + CTA, `chat` = the conversation. */
+export type WidgetView = "home" | "chat";
 type WidgetContextType = {
     open: boolean;
+    /** Active panel screen. Only meaningful while `open`. */
+    view: WidgetView;
     maximize: {
         value: boolean;
         component: ReactNode | null;
     };
+    /**
+     * Legacy hover flag from the old morphing-launcher design. The split
+     * launcher/panel UI no longer drives it, but it's kept so any lingering
+     * consumer keeps compiling. Always `false`.
+     */
     hover: boolean;
     setMaximize: (data: {
         value: boolean;
@@ -12,6 +21,7 @@ type WidgetContextType = {
     }) => void;
     setOpen: (data: boolean) => void;
     setHover: (data: boolean) => void;
+    setView: (view: WidgetView) => void;
     toggleWidget: () => void;
     toggleMaximize: (component: ReactNode | null) => void;
     onClose: () => void;

package/dist/contexts/session/SessionContext.d.ts

@@ -3,6 +3,9 @@ type SessionContextType = {
     sessionId: string | null;
     conversationId: string | null;
     ensureSession: () => Promise<string>;
+    /** Adopt a session id the backend resolved us onto (e.g. it resumed an archived conversation onto
+     * a fresh one) so we persist + subscribe to the right session. */
+    adoptSession: (sessionId: string, conversationId?: string) => void;
     isCreating: boolean;
 };
 export declare function SessionProvider({ children }: {

package/dist/contexts/session/session.api.d.ts

@@ -1,3 +1,11 @@
+export interface AttachmentRef {
+    id: string;
+    /** Permanent public URL (object stored public-read under an unguessable randomized key). */
+    url: string;
+    filename: string;
+    mimeType: string;
+    size: number;
+}
 export interface ChatMessage {
     id: string;
     role: "user" | "agent";
@@ -5,6 +13,7 @@ export interface ChatMessage {
     createdAt: string;
     senderName?: string;
     senderAvatarUrl?: string;
+    attachments?: AttachmentRef[];
     /** MessageContentTypeEnum value — 'text' | 'ui_component' | 'mixed'. */
     type?: string;
     /** Present for ui_component messages so widget history re-renders. */
@@ -22,7 +31,10 @@ export interface SessionResponse {
     sessionId: string;
     conversationId: string;
 }
+export type ConversationLifecycleState = "active" | "resolved" | "archived";
 export interface SessionHistoryResponse extends SessionResponse {
+    /** Lifecycle state of the resolved conversation (informational). */
+    state?: ConversationLifecycleState;
     messages: ChatMessage[];
 }
 export interface CreateSessionOptions {
@@ -79,10 +91,16 @@ export declare function loadSession(api: string, sessionId: string, widgetToken:
 export interface SendMessageOptions {
     headers?: Record<string, string>;
     queryParams?: Record<string, string>;
+    attachments?: AttachmentRef[];
 }
 export declare function sendMessage(api: string, sessionId: string, message: string, organizationId: string, options?: SendMessageOptions): Promise<{
     ok: boolean;
 }>;
+/**
+ * Upload one file to the chat attachment endpoint. Returns the attachment ref to include on the next
+ * message. Note: no Content-Type header — the browser sets the multipart boundary itself.
+ */
+export declare function uploadFile(api: string, organizationId: string, file: File): Promise<AttachmentRef>;
 export interface WidgetActionRequest {
     action: {
         type: string;

package/dist/helpers/MessageHandler.d.ts

@@ -1,4 +1,4 @@
-import { ProgressEventType, AgentResponseUI, ConfirmationEvent, FollowUpProps, HandoffPayloadType, Message, Meta, UserMessageProps } from '../interfaces';
+import { ProgressEventType, AgentResponseUI, AttachmentRef, ConfirmationEvent, FollowUpProps, HandoffPayloadType, Message, Meta, UserMessageProps } from '../interfaces';
 export type State = {
     current_message: null | UserMessageProps;
     progress_msg: null | string;
@@ -37,6 +37,7 @@ export declare class ChatController {
         createdAt: string;
         senderName?: string;
         senderAvatarUrl?: string;
+        attachments?: AttachmentRef[];
         type?: string;
         uiComponent?: {
             componentType: string;
@@ -49,10 +50,10 @@ export declare class ChatController {
             };
         };
     }>) => void;
-    /** Optimistically add the user's message and mark as loading. */
-    appendUserMessage: (message: string) => string;
+    /** Optimistically add the user's message (with any attachments) and mark as loading. */
+    appendUserMessage: (message: string, attachments?: AttachmentRef[]) => string;
     /** Add a complete agent message (non-streaming). */
-    appendAgentMessageFull: (id: string, text: string, senderName?: string, senderAvatarUrl?: string) => void;
+    appendAgentMessageFull: (id: string, text: string, senderName?: string, senderAvatarUrl?: string, attachments?: AttachmentRef[]) => void;
     /** Append a streaming chunk to the current in-progress agent message. */
     appendAgentMessage: (text: string) => void;
     /**

package/dist/hooks/useSendMessage.d.ts

@@ -1,3 +1,3 @@
 export declare function useSendMessage(): {
-    send: (message: string) => Promise<void>;
+    send: (message: string, files?: File[]) => Promise<void>;
 };