@alxxsck/ai-assistant 2.12.0 → 2.14.0

package/dist/api/messages.api.d.ts

@@ -1,6 +1,7 @@
 import type { AppApi } from "@/App";
 import type { WidgetConfig } from "@/index.types";
-import { type ConversationData, type MessageData, type RawMessageData } from "./messages.api.types";
+import { type ConversationData, type MessageData, type RawMessageData, type SendMessageResult } from "./messages.api.types";
+import type { ChatAttachment } from "@/domain/message/chat-experience";
 export declare const MAX_FETCH_MESSAGES = 100;
 export type CursorPage<T> = {
     items: T[];
@@ -17,5 +18,5 @@ export declare const listConversations: (config: WidgetConfig, api: AppApi, curs
 export declare const listConversationMessages: (config: WidgetConfig, api: AppApi, conversationId: string, cursor?: string, signal?: AbortSignal) => Promise<CursorPage<MessageData>>;
 export declare const createConversation: (config: WidgetConfig, api: AppApi) => Promise<ConversationData>;
 export declare const selectConversation: (config: WidgetConfig, api: AppApi, conversationId: string, signal?: AbortSignal) => Promise<ConversationData>;
-export declare function sendMessage(config: WidgetConfig, api: AppApi, messageText: string, conversationId?: string, clientMessageId?: `${string}-${string}-${string}-${string}-${string}`): Promise<MessageData>;
+export declare function sendMessage(config: WidgetConfig, api: AppApi, messageText: string, conversationId?: string, clientMessageId?: `${string}-${string}-${string}-${string}-${string}`, attachments?: readonly ChatAttachment[]): Promise<SendMessageResult>;
 export {};

package/dist/api/messages.api.types.d.ts

@@ -15,6 +15,16 @@ export declare enum ParticipantType {
 export type ChatParticipant = {
     id: string;
     type: ParticipantType;
+    displayName?: string;
+    avatarUrl?: string | null;
+};
+export type MessageDelivery = {
+    id: string;
+    channel: "SDK_REALTIME";
+    status: "PENDING" | "DELIVERING" | "DELIVERED" | "READ" | "FAILED" | "CANCELLED";
+    /** Omitted by realtime delivery claims; present in authoritative history. */
+    acceptedAt?: string;
+    interactionSessionId?: string | null;
 };
 export declare enum MessageStatus {
     Completed = "MESSAGE_STATUS_COMPLETED",
@@ -47,14 +57,36 @@ export type MessageData = {
     lastThreadMessageAt: string;
     createdAt: string;
     updatedAt: string;
-    attachments: [];
+    attachments: ChatAttachment[];
     threadParticipants: ChatParticipant[];
     mentions: [];
     reactions: [];
     isPinned: boolean;
     forwardCount: number;
+    ordinal?: number;
+    delivery?: MessageDelivery;
+    clientMessageId?: string | null;
+};
+/**
+ * Result of accepting a customer message. `assistantMessage` is deliberately
+ * nullable: during a human handoff the backend can accept the message without
+ * admitting it to Lola's intake.
+ */
+export type SendMessageResult = {
+    conversationId: string;
+    assistantMessage: MessageData | null;
+    assistantAdmitted: boolean;
+    aiSuspension: ConversationAISuspension | null;
 };
 export type ConversationStatus = "OPEN" | "CLOSED";
+/** Authoritative per-conversation AI mode returned by Lola Backend. */
+export type ConversationAISuspension = {
+    mode: "SUSPENDED" | "AUTOMATIC";
+    lifecycle: "NONE" | "ACTIVE" | "EXPIRED" | "RESUMED";
+    version: string;
+    serverTime: string;
+    suspendedUntil: string | null;
+};
 export type ConversationData = {
     id: string;
     title: string | null;
@@ -66,6 +98,7 @@ export type ConversationData = {
         messages: number;
     };
     messages?: RawMessageData[];
+    aiSuspension?: ConversationAISuspension;
 };
 export type RawMessageData = {
     id: string;
@@ -75,6 +108,14 @@ export type RawMessageData = {
     text: string;
     content: JSONContent | null;
     commands: unknown[];
+    ordinal?: number;
+    clientMessageId?: string | null;
+    author?: {
+        displayName?: string;
+        avatarUrl?: string | null;
+    } | null;
+    attachments?: ChatAttachment[];
+    delivery?: MessageDelivery;
     createdAt: string;
     updatedAt: string;
 };
@@ -91,4 +132,5 @@ export type ChatMessageDeltaData = {
     text: string;
     done: boolean;
 };
+import type { ChatAttachment } from "@/domain/message/chat-experience";
 export {};

package/dist/api/voice.api.d.ts

@@ -3,7 +3,9 @@ import type { WidgetConfig } from "@/index.types";
 import type { VoiceSessionData } from "./voice.api.types";
 export declare class VoiceApiError extends Error {
     readonly status: number;
-    constructor(status: number, message: string);
+    readonly code?: string | undefined;
+    readonly details?: Record<string, unknown> | undefined;
+    constructor(status: number, message: string, code?: string | undefined, details?: Record<string, unknown> | undefined);
 }
 export declare const parseVoiceSession: (value: unknown) => VoiceSessionData;
 export declare const startVoiceSession: (config: WidgetConfig, api: AppApi, conversationId?: string) => Promise<VoiceSessionData>;

package/dist/bridge-ai-chat-widget.es.js

@@ -1,7 +1,8 @@
-import { J as L, K as s, S as t, L as E } from "./index-CjC1YCB_.js";
+import { S as A, T as e, W as s, x as n, U as r } from "./index-mn1rW9m7.js";
 export {
-  L as ChatWidgetInstance,
-  s as EXTERNALLY_AVAILABLE_ACTIONS,
-  t as SUPPORTED_LOCALES,
-  E as isExternallyAvailableAction
+  A as ChatWidgetInstance,
+  e as EXTERNALLY_AVAILABLE_ACTIONS,
+  s as SUPPORTED_LOCALES,
+  n as createMockAttachmentTransport,
+  r as isExternallyAvailableAction
 };

package/dist/domain/message/cable/AnyCable.service.d.ts

@@ -28,6 +28,10 @@ export declare class AnyCableService {
     unsubscribe(channel: Channel): this;
     acknowledgeCommand(ack: CommandAck): Promise<unknown>;
     submitScenarioChoice(input: ScenarioChoiceInput): Promise<unknown>;
+    acknowledgeMessageDelivery(input: {
+        messageId: string;
+        status: "delivered" | "read";
+    }): Promise<unknown>;
     /** Registers the cable and subscribes to the bridge channel */
     private register;
     /** Unregisters the cable and disconnects from the WebSocket server */

package/dist/domain/message/cable/widget-frame.d.ts

@@ -3,7 +3,7 @@ import type { CommandAck } from "@/domain/command/command.types";
 import type { CommandRuntime } from "@/domain/command/CommandRuntime";
 import type { MessageStoreActions } from "@/domain/message/message.store";
 type WidgetFrameDependencies = {
-    messageActions: Pick<MessageStoreActions, "handleConversationCreated" | "handleMessageDelta" | "handleMessagesAgenticSteps" | "handleMessage">;
+    messageActions: Pick<MessageStoreActions, "handleConversationCreated" | "handleMessageDelta" | "handleMessagesAgenticSteps" | "handleMessage" | "handleChatTyping" | "handleSupportPresence">;
     commandRuntime: CommandRuntime;
     session: CustomerInteractionSession;
     sendAck: (ack: CommandAck) => Promise<unknown>;

package/dist/domain/message/chat-experience.d.ts

@@ -0,0 +1,44 @@
+export type ChatAttachmentKind = "image" | "document";
+export type ChatAttachment = {
+    id: string;
+    fileName: string;
+    mediaType: string;
+    size: number;
+    kind: ChatAttachmentKind;
+    downloadUrl: string;
+    previewUrl?: string;
+};
+export type ChatAttachmentUploadInput = {
+    file: File;
+    signal?: AbortSignal;
+    onProgress?: (progress: number) => void;
+};
+export interface ChatAttachmentTransport {
+    upload(input: ChatAttachmentUploadInput): Promise<ChatAttachment>;
+}
+export type ChatTypingState = {
+    conversationId: string;
+    actor: "ASSISTANT" | "ADMIN";
+    active: boolean;
+    displayName?: string;
+    avatarUrl?: string | null;
+};
+export type SupportPresenceState = {
+    conversationId: string;
+    live: boolean;
+    displayName?: string;
+    avatarUrl?: string | null;
+};
+/**
+ * Opt-in future frame fields. Unknown frames are ignored so the SDK remains
+ * compatible with the currently shipped backend, which does not emit them yet.
+ */
+export declare const normalizeChatExperienceFrame: (frame: unknown) => {
+    typing: ChatTypingState | null;
+    presence: SupportPresenceState | null;
+};
+/**
+ * A deterministic transport for visual QA and integration tests. Production
+ * integrators replace it with their signed-upload adapter through WidgetConfig.
+ */
+export declare const createMockAttachmentTransport: () => ChatAttachmentTransport;

package/dist/domain/message/message.store.d.ts

@@ -1,7 +1,8 @@
-import { type AgenticStepsAppendedData, type ChatMessageDeltaData, type ConversationData, type MessageData } from "@/api/messages.api.types";
+import { type AgenticStepsAppendedData, type ChatMessageDeltaData, type ConversationData, type MessageData, type SendMessageResult } from "@/api/messages.api.types";
 import type { AppApi } from "@/App";
 import type { WidgetConfig } from "@/index.types";
 import { type MessageStreamState } from "./message-stream";
+import type { ChatAttachment, ChatTypingState, SupportPresenceState } from "./chat-experience";
 export interface ThreadSummary {
     threadId: string;
     lastMessage: MessageData;
@@ -15,6 +16,8 @@ export type PendingCustomerMessage = {
     afterMessageId: string | null;
     acknowledged: boolean;
     canonicalMessageId: string | null;
+    attachments: ChatAttachment[];
+    readByAssistant: boolean;
 };
 export type MessageStore = {
     currentThreadId: string | undefined;
@@ -40,6 +43,9 @@ export type MessageStore = {
     pendingCustomerMessage: PendingCustomerMessage | null;
     responsePhase: AgentResponsePhase;
     sendInFlight: boolean;
+    typingByConversation: Map<string, ChatTypingState>;
+    supportPresenceByConversation: Map<string, SupportPresenceState>;
+    assistantSuspendedConversationIds: Set<string>;
     actions: MessageStoreActions;
 };
 export type MessageStoreActions = {
@@ -50,7 +56,7 @@ export type MessageStoreActions = {
     handleMessage: (message: MessageData) => void;
     handleMessageDelta: (delta: ChatMessageDeltaData) => void;
     settleMessageStream: (messageId: string) => void;
-    sendMessage: (message: string) => Promise<MessageData | undefined>;
+    sendMessage: (message: string, attachments?: ChatAttachment[]) => Promise<SendMessageResult | undefined>;
     clearSendError: () => void;
     getThreadsSummaryData: () => ThreadSummary[];
     setLatestReadMessageDate: (readMessageDate: string) => void;
@@ -64,6 +70,8 @@ export type MessageStoreActions = {
     cancelConversationPagination: () => void;
     setCurrentThreadMessages: (conversationId: string) => void;
     sendServiceMessage: (message: string) => Promise<void>;
+    handleChatTyping: (typing: ChatTypingState) => void;
+    handleSupportPresence: (presence: SupportPresenceState) => void;
     updateConfig: (config: WidgetConfig, api: AppApi) => void;
     recoverMessages: (preserveLoadedConversations?: boolean) => Promise<void>;
     fetchMoreConversations: () => Promise<void>;
@@ -87,4 +95,8 @@ export declare const useIsResponseActive: () => boolean;
 export declare const selectCurrentThreadPendingCustomerMessage: (state: MessageStore) => PendingCustomerMessage | null;
 export declare const usePendingCustomerMessage: () => PendingCustomerMessage | null;
 export declare const useMessageStream: (messageId: string) => MessageStreamState | undefined;
+export declare const useCurrentChatTyping: () => ChatTypingState | null;
+export declare const useCurrentSupportPresence: () => SupportPresenceState | null;
+export declare const selectIsCurrentConversationAISuspended: (state: MessageStore) => boolean;
+export declare const useCurrentConversationAISuspended: () => boolean;
 export declare const useMessageStoreActions: () => MessageStoreActions;