@alxxsck/ai-assistant 3.2.0 → 3.3.0

package/dist/avatar/Avatar.d.ts

@@ -9,7 +9,7 @@ type CameraParams = {
     lookAt: Vector3;
     fov: number;
 };
-export type AvatarFramingMode = "default" | "chat-surface";
+export type AvatarFramingMode = "default" | "compact-assistant" | "chat-surface";
 export declare class Avatar extends EventTarget {
     private canvas;
     private videoContainer;

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-C_7vxlzf.js";
+import { C as A, E as e, S as s, d as E, c } from "./index-C6_FMpJa.js";
 export {
   A as ChatWidgetInstance,
   e as EXTERNALLY_AVAILABLE_ACTIONS,

package/dist/context/ChatWidgetContext.d.ts

@@ -5,10 +5,17 @@ import type { CtaActionExecutionResult, CtaCommandContext } from "@/domain/comma
 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";
+import { type AssistantSurfaceMode, type AssistantOpenSurfaceMode } from "@/domain/ui/assistant-surface";
 type ChatWidgetContextValue = {
     open: boolean;
+    assistantSurfaceMode: AssistantSurfaceMode;
+    assistantLastOpenMode: AssistantOpenSurfaceMode;
     setOpen: (v: boolean) => void;
     transitionSurface: (open: boolean, context: SurfaceTransitionContext) => void;
+    restoreAssistant: (context: SurfaceTransitionContext) => void;
+    openFullAssistant: (context: SurfaceTransitionContext) => void;
+    minimizeAssistant: (context: SurfaceTransitionContext) => void;
+    closeAssistant: (context: SurfaceTransitionContext) => void;
     openCompactPreview: (context: SurfaceTransitionContext) => Promise<boolean> | null;
     surfaceEpisodeId: string | null;
     closeFocusDisposition: SurfaceFocusDisposition;

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

@@ -1,5 +1,5 @@
 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 UiCommandActionSnapshot, type UiActionPolicies, 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 UiActionPresentationSnapshot, 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";
@@ -15,7 +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;
+    prepareUiActionHandoff?: (action: Readonly<UiActionPresentationSnapshot>, commandId: string, invocation: UiActionInvocation) => UiActionPresentationHandoff | undefined;
 };
 export declare class CommandRuntime {
     private readonly onStatus?;
@@ -47,6 +47,7 @@ export declare class CommandRuntime {
     executeCtaAction(context: CtaCommandContext): Promise<CtaActionExecutionResult>;
     private executeCtaActionOnce;
     private executeUiAction;
+    private executeWithUiActionHandoff;
     private retainCtaAction;
     destroy(): void;
     private executeOnce;

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

@@ -1,4 +1,4 @@
-import type { HostCommandHandlerName, HostCommandHandlers, UiCommandActionSnapshot, UiCommandTarget, UiActionPolicies, UiTarget } from "./command.types";
+import type { HighlightActionPresentationSnapshot, HostCommandHandlerName, HostCommandHandlers, UiCommandActionSnapshot, UiCommandTarget, UiActionPolicies, UiTarget } from "./command.types";
 type NavigationCommandType = "open_page" | "open_modal";
 export declare class UiCommandService {
     private readonly actionPolicies;
@@ -10,6 +10,7 @@ export declare class UiCommandService {
     getHandler<K extends HostCommandHandlerName>(name: K): HostCommandHandlers[K];
     registerHandler<K extends HostCommandHandlerName>(name: K, handler: NonNullable<HostCommandHandlers[K]>): () => void;
     resolveAction(commandType: NavigationCommandType, payload: Readonly<Record<string, unknown>>, target?: UiCommandTarget): Readonly<UiCommandActionSnapshot>;
+    resolveHighlightPresentation(code: string): Readonly<HighlightActionPresentationSnapshot>;
     execute(commandType: NavigationCommandType, commandId: string, payload: Readonly<Record<string, unknown>>, target?: UiCommandTarget): Promise<void>;
     executeAction(action: Readonly<UiCommandActionSnapshot>, commandId: string, payload: Readonly<Record<string, unknown>>): Promise<void>;
     canExecute(action: Readonly<UiCommandActionSnapshot>): boolean;

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

@@ -47,6 +47,10 @@ 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 = {
+    /**
+     * Compatibility field name. The disposition is applied to the assistant
+     * surface after a successful UI action at every viewport size.
+     */
     mobileDisposition: MobileActionDisposition;
 };
 export type UiActionPolicies = Readonly<Record<string, UiActionPolicy>>;
@@ -96,6 +100,12 @@ export type UiCommandActionSnapshot = {
     selector?: string;
     target?: ModalCommandTarget;
 };
+export type HighlightActionPresentationSnapshot = {
+    kind: "element";
+    code: string;
+    mobileDisposition: MobileActionDisposition;
+};
+export type UiActionPresentationSnapshot = UiCommandActionSnapshot | HighlightActionPresentationSnapshot;
 export type HighlightCommandContext = HostCommandContext & {
     active: boolean;
     element?: Element;

package/dist/domain/ui/assistant-surface.d.ts

@@ -0,0 +1,32 @@
+export type AssistantSurfaceMode = "CLOSED" | "COMPACT" | "FULL";
+export type AssistantOpenSurfaceMode = Exclude<AssistantSurfaceMode, "CLOSED">;
+export type AssistantSurfaceState = Readonly<{
+    mode: AssistantSurfaceMode;
+    lastOpenMode: AssistantOpenSurfaceMode;
+}>;
+export declare const assistantSurfaceActions: {
+    restore: () => {
+        readonly type: "RESTORE";
+    };
+    openCompact: () => {
+        readonly type: "OPEN_COMPACT";
+    };
+    openFull: () => {
+        readonly type: "OPEN_FULL";
+    };
+    minimize: () => {
+        readonly type: "MINIMIZE";
+    };
+    close: () => {
+        readonly type: "CLOSE";
+    };
+    setLegacyOpen: (open: boolean) => {
+        readonly type: "SET_LEGACY_OPEN";
+        readonly open: boolean;
+    };
+};
+export type AssistantSurfaceAction = ReturnType<(typeof assistantSurfaceActions)[keyof typeof assistantSurfaceActions]>;
+export declare function createAssistantSurfaceState(lastOpenMode?: AssistantOpenSurfaceMode): AssistantSurfaceState;
+export declare function assistantSurfaceReducer(state: AssistantSurfaceState, action: AssistantSurfaceAction): AssistantSurfaceState;
+/** Compatibility selector for consumers where `open` means the full chat UI. */
+export declare function isLegacyAssistantSurfaceOpen(state: AssistantSurfaceState): boolean;

package/dist/domain/ui/widget-geometry.d.ts

@@ -39,12 +39,22 @@ export declare const DEFAULT_WIDGET_WIDTH: number;
 export declare const COMPACT_PREVIEW_MAX_WIDTH = 320;
 export declare const COMPACT_PREVIEW_MARGIN = 12;
 export declare const COMPACT_PREVIEW_GAP = 12;
+export declare const COMPACT_ASSISTANT_WIDTH = 164;
+export declare const COMPACT_ASSISTANT_HEIGHT = 220;
 export declare function getViewport(): Viewport;
 export declare function insetViewport(viewport: Viewport, insets: ViewportInsets): Viewport;
 export declare function getDefaultLauncherPosition(viewport: Viewport): Point;
 export declare function dockLauncherPosition(point: Point, viewport: Viewport): DockedLauncher;
 export declare function launcherPointFromDock(launcher: DockedLauncher, viewport: Viewport): Point;
 export declare function clampLauncherPosition(point: Point, viewport: Viewport): Point;
+/**
+ * Resolves the compact assistant from the same side/y docking preference as
+ * the launcher. This lets both surfaces share one persisted position without
+ * leaking the compact surface's fixed dimensions into the full chat panel.
+ */
+export declare function compactAssistantRectFromDock(dock: DockedLauncher, viewport: Viewport): Rect;
+export declare function clampCompactAssistantRect(rect: Rect, viewport: Viewport): Rect;
+export declare function dockCompactAssistantRect(rect: Rect, viewport: Viewport): DockedLauncher;
 export declare function clampPanelRect(rect: Rect, viewport: Viewport): Rect;
 export declare function dockPanelRect(rect: Rect, viewport: Viewport): Rect;
 export declare function dockPanelRectToSide(rect: Rect, viewport: Viewport, side: LauncherSide): Rect;

package/dist/i18n/messages.d.ts

@@ -78,6 +78,7 @@ declare const en: {
         readonly decline: "Decline";
         readonly muteMicrophone: "Mute microphone";
         readonly unmuteMicrophone: "Unmute microphone";
+        readonly endConversation: "End voice chat";
         readonly switchToText: "Switch to text chat";
         readonly audioPlaybackFailed: "Couldn't play the assistant's voice.";
         readonly sessionFailed: "Voice conversation failed.";