@alxxsck/ai-assistant 3.0.0 → 3.1.0

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

@@ -31,7 +31,8 @@ export type MessageDelivery = {
 export declare enum MessageStatus {
     Completed = "MESSAGE_STATUS_COMPLETED",
     Writing = "MESSAGE_STATUS_WRITING",
-    Failed = "MESSAGE_STATUS_FAILED"
+    Failed = "MESSAGE_STATUS_FAILED",
+    Cancelled = "MESSAGE_STATUS_CANCELLED"
 }
 export type CustomerContent = {
     text: string;

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

@@ -1,4 +1,4 @@
-import { C as A, E as e, S as s, d as E, c } from "./index-DY_Y_QHI.js";
+import { C as A, E as e, S as s, d as E, c } from "./index-DCsPGgIk.js";
 export {
   A as ChatWidgetInstance,
   e as EXTERNALLY_AVAILABLE_ACTIONS,

package/dist/context/ChatWidgetContext.d.ts

@@ -3,6 +3,7 @@ import type { Avatar } from "@/avatar/Avatar";
 import type { WidgetConfig } from "@/index.types";
 import type { CtaActionExecutionResult, CtaCommandContext } from "@/domain/command/command.types";
 import type { SurfaceTransitionContext } from "@/domain/scenario-interaction/scenario-interaction.types";
+import type { SurfaceFocusDisposition } from "@/domain/scenario-interaction/scenario-interaction.types";
 import { CompactPreviewController } from "@/domain/compact-preview/CompactPreviewController";
 type ChatWidgetContextValue = {
     open: boolean;
@@ -10,6 +11,8 @@ type ChatWidgetContextValue = {
     transitionSurface: (open: boolean, context: SurfaceTransitionContext) => void;
     openCompactPreview: (context: SurfaceTransitionContext) => Promise<boolean> | null;
     surfaceEpisodeId: string | null;
+    closeFocusDisposition: SurfaceFocusDisposition;
+    uiActionHandoffPending: boolean;
     contentActivated: boolean;
     isAvatarCoveredByChatList: boolean;
     setAvatarCoveredByChatList: (covered: boolean) => void;

package/dist/domain/command/CommandRuntime.d.ts

@@ -1,7 +1,12 @@
 import type { CustomerInteractionSession } from "@/types";
-import { type CommandAck, type CommandEnvelope, type CommandEventDetail, type CtaActionExecutionResult, type CtaCommandContext, type HostCommandHandlerName, type HostCommandHandlers, type SpeakTextCommandContext, type StartVoiceConversationCommandContext, type UiTarget } from "./command.types";
+import { type CommandAck, type CommandEnvelope, type CommandEventDetail, type CtaActionExecutionResult, type CtaCommandContext, type HostCommandHandlerName, type HostCommandHandlers, type SpeakTextCommandContext, type StartVoiceConversationCommandContext, type UiCommandActionSnapshot, type UiActionPolicies, type UiTarget } from "./command.types";
 import type { ScenarioInteractionRuntime } from "@/domain/scenario-interaction/ScenarioInteractionRuntime";
 type AckSender = (ack: CommandAck) => Promise<unknown>;
+type UiActionInvocation = "COMMAND" | "CTA";
+type UiActionPresentationHandoff = {
+    complete: () => void;
+    cancel: () => void;
+};
 type InternalHandlers = {
     setAssistantVisible?: (visible: boolean, commandId: string) => void;
     setChatOpen?: (open: boolean, commandId: string) => void | Promise<void>;
@@ -10,6 +15,7 @@ type InternalHandlers = {
     connectTelegram?: (context: CtaCommandContext) => CtaActionExecutionResult | Promise<CtaActionExecutionResult>;
     speakText?: (context: SpeakTextCommandContext) => void | Promise<void>;
     startVoiceConversation?: (context: StartVoiceConversationCommandContext) => void | Promise<void>;
+    prepareUiActionHandoff?: (action: Readonly<UiCommandActionSnapshot>, commandId: string, invocation: UiActionInvocation) => UiActionPresentationHandoff | undefined;
 };
 export declare class CommandRuntime {
     private readonly onStatus?;
@@ -32,7 +38,7 @@ export declare class CommandRuntime {
     private principalSessionId;
     private principalGeneration;
     private destroyed;
-    constructor(targets?: Record<string, UiTarget>, handlers?: HostCommandHandlers, onStatus?: ((detail: CommandEventDetail) => void) | undefined, scenarioInteractions?: ScenarioInteractionRuntime | undefined);
+    constructor(targets?: Record<string, UiTarget>, handlers?: HostCommandHandlers, onStatus?: ((detail: CommandEventDetail) => void) | undefined, scenarioInteractions?: ScenarioInteractionRuntime | undefined, actionPolicies?: UiActionPolicies);
     registerTarget(code: string, target: UiTarget): () => void;
     registerHostHandler<K extends HostCommandHandlerName>(name: K, handler: NonNullable<HostCommandHandlers[K]>): () => void;
     setInternalHandlers(handlers: InternalHandlers): () => void;
@@ -40,6 +46,7 @@ export declare class CommandRuntime {
     updateSession(session: CustomerInteractionSession): void;
     executeCtaAction(context: CtaCommandContext): Promise<CtaActionExecutionResult>;
     private executeCtaActionOnce;
+    private executeUiAction;
     private retainCtaAction;
     destroy(): void;
     private executeOnce;

package/dist/domain/command/UiCommandService.d.ts

@@ -1,9 +1,10 @@
-import type { HostCommandHandlerName, HostCommandHandlers, UiCommandActionSnapshot, UiCommandTarget, UiTarget } from "./command.types";
+import type { HostCommandHandlerName, HostCommandHandlers, UiCommandActionSnapshot, UiCommandTarget, UiActionPolicies, UiTarget } from "./command.types";
 type NavigationCommandType = "open_page" | "open_modal";
 export declare class UiCommandService {
+    private readonly actionPolicies;
     private readonly targets;
     private readonly handlers;
-    constructor(targets?: Record<string, UiTarget>, handlers?: HostCommandHandlers);
+    constructor(targets?: Record<string, UiTarget>, handlers?: HostCommandHandlers, actionPolicies?: UiActionPolicies);
     registerTarget(code: string, target: UiTarget): () => void;
     getTarget(code: string): UiTarget | undefined;
     getHandler<K extends HostCommandHandlerName>(name: K): HostCommandHandlers[K];
@@ -16,6 +17,7 @@ export declare class UiCommandService {
     private resolveLegacyAction;
     private assertLegacyTarget;
     private targetUrl;
+    private mobileDisposition;
     private applyUrlFallback;
     private isSameOriginUrl;
     private requireNonEmptyString;

package/dist/domain/command/command.types.d.ts

@@ -44,6 +44,12 @@ export type ElementCommandTarget = {
 };
 export type UiCommandTarget = PageCommandTarget | ModalCommandTarget | ElementCommandTarget;
 export type UiTargetKind = "button" | "element" | "modal" | "page";
+export declare const MOBILE_ACTION_DISPOSITIONS: readonly ["keep", "collapseOnSuccess", "immersive"];
+export type MobileActionDisposition = (typeof MOBILE_ACTION_DISPOSITIONS)[number];
+export type UiActionPolicy = {
+    mobileDisposition: MobileActionDisposition;
+};
+export type UiActionPolicies = Readonly<Record<string, UiActionPolicy>>;
 export type UiTarget = {
     kind: UiTargetKind;
     /** Trusted selector supplied by the host application. */
@@ -79,10 +85,12 @@ export type UiCommandActionSnapshot = {
     kind: "page";
     code: string;
     route: string;
+    mobileDisposition: MobileActionDisposition;
     target?: PageCommandTarget;
 } | {
     kind: "modal";
     code: string;
+    mobileDisposition: MobileActionDisposition;
     modalName?: string;
     url?: string;
     selector?: string;

package/dist/domain/message/cable/CableContext.d.ts

@@ -13,6 +13,7 @@ interface CableContextType {
     anycableService: AnyCableService | null;
     endUserTypingClient: EndUserTypingClient;
     networkStatus: NetworkStatus;
+    networkStatusChangedAt: number;
     scenarioChoiceSubmissionController: ScenarioChoiceSubmissionController;
 }
 export type CableServiceFactory = (url: string, onMessage?: (message: unknown) => void, onAuthenticationError?: () => void) => AnyCableService;

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

@@ -44,6 +44,7 @@ export type MessageStore = {
     threads: Map<string, MessageData[]>;
     threadsPreviews: ThreadSummary[];
     sendError: string | null;
+    sendErrorOccurredAt: number | null;
     config: WidgetConfig | null;
     api: AppApi | null;
     latestReadMessageDate: string | null;
@@ -57,6 +58,7 @@ export type MessageStore = {
     pendingCustomerMessage: PendingCustomerMessage | null;
     responsePhase: AgentResponsePhase;
     sendInFlight: boolean;
+    isCreatingConversation: boolean;
     typingByConversation: Map<string, ChatTypingState>;
     concealedConversationIds: Set<string>;
     concealedMessageIds: Set<string>;
@@ -130,10 +132,12 @@ export declare const useLatestMessageDate: () => string | null;
 export declare const useConversationNavigationRequest: () => ConversationNavigationRequest | null;
 export declare const useScenarioChoiceSubmissionResult: (clientEventId?: string) => ScenarioChoiceSubmissionResult | undefined;
 export declare const useSendError: () => string | null;
+export declare const useSendErrorOccurredAt: () => number | null;
 export declare const selectIsCurrentThreadLoading: (state: MessageStore) => boolean;
 export declare const useIsCurrentThreadLoading: () => boolean;
 export declare const useIsAwaitingFirstToken: () => boolean;
 export declare const useIsResponseActive: () => boolean;
+export declare const useIsCreatingConversation: () => boolean;
 export declare const selectCurrentThreadPendingCustomerMessage: (state: MessageStore) => PendingCustomerMessage | null;
 export declare const usePendingCustomerMessage: () => PendingCustomerMessage | null;
 export declare const useMessageStream: (messageId: string) => MessageStreamState | undefined;

package/dist/domain/scenario-interaction/scenario-interaction.types.d.ts

@@ -59,10 +59,13 @@ export type SurfaceState = "OPEN" | "CLOSED";
 export type SurfaceTransitionActor = ScenarioInteractionActor | "SYSTEM";
 /** Exact SDK-local reasons; state-changing reasons are preserved on the wire. */
 export type SurfaceTransitionReason = "USER_LAUNCHER" | "USER_CLOSE_BUTTON" | "VOICE_SWITCH_TO_TEXT" | "HOST_SET_OPEN" | "SCENARIO_COMMAND" | "SYSTEM_RESTORE";
+export type SurfaceFocusDisposition = "RETURN_TO_LAUNCHER" | "PRESERVE_HOST";
 export type SurfaceTransitionContext = {
     actor: SurfaceTransitionActor;
     reason: SurfaceTransitionReason;
     sourceCommandId?: string;
+    /** Local focus ownership; it is never serialized to interaction observations. */
+    focusDisposition?: SurfaceFocusDisposition;
 };
 export type SurfaceTransition = {
     changed: boolean;

package/dist/domain/voice/voice-input-spectrum.d.ts

@@ -0,0 +1,17 @@
+/**
+ * Owns the optional visualization branch of the current microphone graph.
+ * Capture remains in the AudioWorklet; this object only reads the browser's
+ * native FFT into caller-owned buffers.
+ */
+export declare class VoiceInputSpectrum {
+    private graph;
+    private cachedBandCount;
+    private bandStarts;
+    private bandEnds;
+    attach(context: AudioContext, source: AudioNode): void;
+    detach(context?: AudioContext): void;
+    readBands(target: Float32Array): void;
+    private invalidateBandGeometry;
+    private ensureBandGeometry;
+}
+export declare const voiceInputSpectrum: VoiceInputSpectrum;

package/dist/i18n/messages.d.ts

@@ -47,6 +47,7 @@ declare const en: {
         readonly previousLoadFailed: "Couldn't load previous messages.";
         readonly loadingOlderMessages: "Loading older messages";
         readonly loadingMessages: "Loading messages";
+        readonly openingDestination: "Opening…";
         readonly switchToVoice: "Switch to voice chat";
         readonly talk: "Talk";
         readonly messageLabel: "Message";