@alxxsck/ai-assistant 2.20.0 → 2.22.0

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

@@ -1,6 +1,6 @@
 import type { AppApi } from "@/App";
 import type { WidgetConfig } from "@/index.types";
-import { type ConversationData, type MessageData, type RawMessageData, type SendMessageResult } from "./messages.api.types";
+import { type ConversationData, type MessageData, type RawConversationData, 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> = {
@@ -10,7 +10,6 @@ export type CursorPage<T> = {
 type VersionedCursorPage<T> = CursorPage<T> & {
     contractVersion?: unknown;
 };
-type ConversationsResponse = VersionedCursorPage<ConversationData>;
 export declare class ChatApiError extends Error {
     readonly status: number;
     constructor(status: number, message: string);
@@ -20,12 +19,19 @@ export declare class ChatContractError extends Error {
 }
 export declare const isConversationClosedError: (error: unknown) => boolean;
 export declare const requestChatJson: <T>(config: WidgetConfig, api: AppApi, path: string, init?: RequestInit) => Promise<T>;
-export declare const normalizeConversation: (conversation: ConversationData) => ConversationData;
+export declare const normalizeConversation: (conversation: RawConversationData) => ConversationData;
 export declare const normalizeMessage: (message: RawMessageData, config: WidgetConfig) => MessageData;
+export declare const normalizeMessageAuthorPresentation: (role: RawMessageData["role"], author: unknown) => Readonly<{
+    contractState: "VERSIONED" | "LEGACY";
+    displayName: string;
+    avatarAsset: import("@/domain/support-presentation/support-presentation.types").PresentationAvatarAsset | null;
+    presentationVersion: number | null;
+    legacyAvatarUrl: string | null;
+}> | null;
 export declare const normalizeMessageForSession: (message: RawMessageData, interactionSessionId: string) => MessageData;
-export declare const listConversations: (config: WidgetConfig, api: AppApi, cursor?: string, signal?: AbortSignal) => Promise<ConversationsResponse>;
+export declare const listConversations: (config: WidgetConfig, api: AppApi, cursor?: string, signal?: AbortSignal) => Promise<VersionedCursorPage<ConversationData>>;
 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 createConversation: (config: WidgetConfig, api: AppApi, signal?: AbortSignal) => Promise<ConversationData>;
 export declare const selectConversation: (config: WidgetConfig, api: AppApi, conversationId: string, signal?: AbortSignal) => Promise<ConversationData>;
 export declare const getConversation: (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}`, attachments?: readonly ChatAttachment[]): Promise<SendMessageResult>;

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

@@ -103,6 +103,10 @@ export type ConversationData = {
     aiSuspension?: ConversationAISuspension;
     responderPresentation?: import("@/domain/support-presentation/support-presentation.types").SafeResponderPresentation;
 };
+/** Untrusted transport shape before responder contract normalization. */
+export type RawConversationData = Omit<ConversationData, "responderPresentation"> & {
+    responderPresentation?: unknown;
+};
 export type MessageRole = "USER" | "ASSISTANT" | "ADMIN" | "SCENARIO" | "SYSTEM";
 export type RawMessageData = {
     id: string;

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

@@ -1,4 +1,4 @@
-import { a2 as A, a3 as e, a5 as s, H as n, a4 as r } from "./index-BVQY-1rm.js";
+import { a1 as A, a2 as e, a4 as s, F as n, a3 as r } from "./index-C4NZpmiX.js";
 export {
   A as ChatWidgetInstance,
   e as EXTERNALLY_AVAILABLE_ACTIONS,

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" | "handleScenarioChoiceLifecycleChanged" | "handleScenarioChoiceSubmissionResult" | "handleMessageDelta" | "handleMessagesAgenticSteps" | "handleMessage" | "handleChatTyping" | "handleSupportPresence" | "handleResponderPresentationChanged">;
+    messageActions: Pick<MessageStoreActions, "handleConversationCreated" | "handleScenarioChoiceLifecycleChanged" | "handleScenarioChoiceSubmissionResult" | "handleMessageDelta" | "handleMessagesAgenticSteps" | "handleMessage" | "handleChatTyping" | "handleResponderPresentationChanged">;
     commandRuntime: CommandRuntime;
     session: CustomerInteractionSession;
     sendAck: (ack: CommandAck) => Promise<unknown>;

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

@@ -20,14 +20,6 @@ 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
@@ -35,7 +27,6 @@ export type SupportPresenceState = {
  */
 export declare const normalizeChatExperienceFrame: (frame: unknown) => {
     typing: ChatTypingState | null;
-    presence: SupportPresenceState | null;
 };
 /**
  * A deterministic transport for visual QA and integration tests. Production

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

@@ -2,7 +2,7 @@ import { type AgenticStepsAppendedData, type ChatMessageDeltaData, type Conversa
 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";
+import type { ChatAttachment, ChatTypingState } from "./chat-experience";
 import type { ResponderPresentationChanged, ScenarioConversationCreated } from "./cable/widget-message";
 import { type ScenarioChoiceLifecycleChanged, type ScenarioChoiceSubmissionResult } from "@/domain/scenario/scenario-choice";
 export interface ThreadSummary {
@@ -21,6 +21,7 @@ export type PendingCustomerMessage = {
     conversationId: string | undefined;
     afterMessageId: string | null;
     acknowledged: boolean;
+    acceptanceConfirmed?: boolean;
     canonicalMessageId: string | null;
     attachments: ChatAttachment[];
     readByAssistant: boolean;
@@ -54,7 +55,14 @@ export type MessageStore = {
     responsePhase: AgentResponsePhase;
     sendInFlight: boolean;
     typingByConversation: Map<string, ChatTypingState>;
-    supportPresenceByConversation: Map<string, SupportPresenceState>;
+    concealedConversationIds: Set<string>;
+    concealedMessageIds: Set<string>;
+    inactiveConversationIds: Set<string>;
+    inactiveConversationUpdatedAt: Map<string, string | null>;
+    inactiveConversationRevalidation: Map<string, "ANY_OPEN" | "NEWER_OPEN" | "EXACT_ONLY">;
+    conversationScanCandidateIds: Set<string>;
+    conversationScanAuthorityVersion: number | null;
+    conversationScanSnapshots: Map<string, ConversationData>;
     assistantSuspendedConversationIds: Set<string>;
     actions: MessageStoreActions;
 };
@@ -68,6 +76,7 @@ export type MessageStoreActions = {
     handleScenarioChoiceSubmissionResult: (result: ScenarioChoiceSubmissionResult) => void;
     handleMessage: (message: MessageData) => void;
     handleResponderPresentationChanged: (hint: ResponderPresentationChanged) => void;
+    refreshResponderPresentation: (conversationId: string, minimumRevision?: string, retryAfterTransportFailure?: boolean) => void;
     handleMessageDelta: (delta: ChatMessageDeltaData) => void;
     settleMessageStream: (messageId: string) => void;
     sendMessage: (message: string, attachments?: ChatAttachment[]) => Promise<SendMessageResult | undefined>;
@@ -83,11 +92,10 @@ export type MessageStoreActions = {
     cancelThreadMessagesRequest: (conversationId: string) => void;
     cancelConversationPagination: () => void;
     setCurrentThreadMessages: (conversationId: string) => void;
-    sendServiceMessage: (message: string) => Promise<void>;
     handleChatTyping: (typing: ChatTypingState) => void;
-    handleSupportPresence: (presence: SupportPresenceState) => void;
+    clearTransientRealtimeState: () => void;
     updateConfig: (config: WidgetConfig, api: AppApi) => void;
-    recoverMessages: (preserveLoadedConversations?: boolean) => Promise<void>;
+    recoverMessages: (preserveLoadedConversations?: boolean, preserveCurrentThread?: boolean) => Promise<void>;
     fetchMoreConversations: () => Promise<void>;
 };
 export declare const useMessageStore: import("zustand").UseBoundStore<import("zustand").StoreApi<MessageStore>>;
@@ -99,8 +107,9 @@ export declare const useIsLoadingMoreConversations: () => boolean;
 export declare const useCurrentThreadId: () => string | undefined;
 export declare const useCurrentResponderPresentation: () => Readonly<{
     contractState: "CURRENT" | "LEGACY" | "INCOMPATIBLE";
-    schemaVersion: 0 | 1;
-    mode: import("@/domain/support-presentation/support-presentation.types").ResponderMode | "UNKNOWN";
+    schemaVersion: 0 | 2;
+    humanSupport: import("@/domain/support-presentation/support-presentation.types").ResponderHumanSupportState | "UNKNOWN";
+    ai: import("@/domain/support-presentation/support-presentation.types").ResponderAIState | "UNKNOWN";
     identity: import("@/domain/support-presentation/support-presentation.types").ResponderIdentity;
     displayName: string | null;
     avatarAsset: import("@/domain/support-presentation/support-presentation.types").PresentationAvatarAsset | null;
@@ -124,8 +133,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 selectCurrentChatTypingByActor: (state: MessageStore, actor: ChatTypingState["actor"]) => ChatTypingState | null;
+export declare const useCurrentChatTypingByActor: (actor: ChatTypingState["actor"]) => ChatTypingState | null;
 export declare const selectIsCurrentConversationAISuspended: (state: MessageStore) => boolean;
 export declare const useCurrentConversationAISuspended: () => boolean;
 export declare const useMessageStoreActions: () => MessageStoreActions;

package/dist/domain/support-presentation/PresentationAvatarResolver.d.ts

@@ -34,11 +34,13 @@ export declare class PresentationAvatarResolver {
     private readonly queue;
     private readonly authorityListeners;
     private readonly conversationEpochs;
+    private readonly activeKeys;
     private activeCount;
     private generation;
     constructor(config: WidgetConfig, api: AppApi, options?: ResolverOptions);
     resolve(request: PresentationAvatarRequest): Promise<ResolvedPresentationAvatar | null>;
     private drainQueue;
+    private releaseActiveSlot;
     private trimCache;
     private loadGrant;
     replaceSession(config: WidgetConfig, api: AppApi): void;

package/dist/domain/support-presentation/support-presentation.reconciliation.d.ts

@@ -0,0 +1,13 @@
+import { type SafeResponderPresentation } from "./support-presentation.types";
+export type ResponderReconciliationOutcome = "APPLIED" | "REPLAY" | "STALE" | "HINT_AHEAD" | "INCOMPATIBLE";
+export type ResponderReconciliation = Readonly<{
+    presentation: SafeResponderPresentation;
+    outcome: ResponderReconciliationOutcome;
+}>;
+export declare const compareResponderRevisions: (left: string, right: string) => number;
+/**
+ * The one merge rule for REST snapshots and revision-only realtime hints.
+ * The backend owns the compound revision; consumers never compare or advance
+ * individual source revisions themselves.
+ */
+export declare function reconcileResponderPresentation(current: SafeResponderPresentation | undefined, incoming: SafeResponderPresentation, minimumRevision?: string): ResponderReconciliation;

package/dist/domain/support-presentation/support-presentation.types.d.ts

@@ -3,18 +3,24 @@ export type PresentationAvatarAsset = Readonly<{
     version: number;
 }>;
 export type MessageAuthorPresentation = Readonly<{
+    /** Internal provenance marker; never serialized back to the backend. */
+    contractState: "VERSIONED" | "LEGACY";
     displayName: string;
     avatarAsset: PresentationAvatarAsset | null;
     presentationVersion: number | null;
     legacyAvatarUrl: string | null;
 }>;
-export declare const RESPONDER_MODES: readonly ["LOLA", "SUPPORT_REQUESTED", "SUPPORT_LIVE", "SUPPORT_AWAY", "LOLA_SUSPENDED"];
-export type ResponderMode = (typeof RESPONDER_MODES)[number];
+export declare const RESPONDER_HUMAN_SUPPORT_STATES: readonly ["NONE", "ROUTING", "ASSIGNED"];
+export declare const RESPONDER_AI_STATES: readonly ["ACTIVE", "SUSPENDED"];
+export type ResponderHumanSupportState = (typeof RESPONDER_HUMAN_SUPPORT_STATES)[number];
+export type ResponderAIState = (typeof RESPONDER_AI_STATES)[number];
 export type ResponderIdentity = "LOLA" | "SUPPORT";
 export type ResponderSourceRevisions = Readonly<{
     conversationUpdatedAt: string;
     escalationVersionSum: string;
     escalationUpdatedAt: string | null;
+    assignmentVersionSum: string;
+    assignmentUpdatedAt: string | null;
     aiSuspensionVersion: string | null;
     aiSuspensionUpdatedAt: string | null;
     lolaPresentationVersion: number | null;
@@ -22,8 +28,9 @@ export type ResponderSourceRevisions = Readonly<{
     avatarAssetUpdatedAt: string | null;
 }>;
 export type ResponderPresentation = Readonly<{
-    schemaVersion: 1;
-    mode: ResponderMode;
+    schemaVersion: 2;
+    humanSupport: ResponderHumanSupportState;
+    ai: ResponderAIState;
     identity: ResponderIdentity;
     displayName: string;
     avatarAsset: PresentationAvatarAsset | null;
@@ -35,8 +42,9 @@ export type ResponderPresentation = Readonly<{
 }>;
 export type SafeResponderPresentation = Readonly<{
     contractState: "CURRENT" | "LEGACY" | "INCOMPATIBLE";
-    schemaVersion: 0 | 1;
-    mode: ResponderMode | "UNKNOWN";
+    schemaVersion: 0 | 2;
+    humanSupport: ResponderHumanSupportState | "UNKNOWN";
+    ai: ResponderAIState | "UNKNOWN";
     identity: ResponderIdentity;
     displayName: string | null;
     avatarAsset: PresentationAvatarAsset | null;
@@ -48,6 +56,7 @@ export type SafeResponderPresentation = Readonly<{
 }>;
 export declare const LEGACY_RESPONDER_PRESENTATION: SafeResponderPresentation;
 export declare const INCOMPATIBLE_RESPONDER_PRESENTATION: SafeResponderPresentation;
+export declare const isCanonicalResponderRevision: (value: unknown) => value is string;
 export declare function parseMessageAuthorPresentation(value: unknown): MessageAuthorPresentation | null;
 export declare function parseResponderPresentation(value: unknown): ResponderPresentation | null;
 export declare function normalizeResponderPresentation(value: unknown): SafeResponderPresentation;

package/dist/i18n/messages.d.ts

@@ -27,7 +27,6 @@ declare const en: {
         readonly system: "System";
         readonly aiAssistant: "AI assistant";
         readonly waiting: "Waiting for a specialist";
-        readonly live: "Specialist is here";
         readonly away: "We’ll reply here";
         readonly paused: "AI is paused";
         readonly unavailable: "Support status unavailable";