vanilla-agent 0.2.0 → 1.0.0

package/dist/index.d.cts

@@ -1,7 +1,7 @@
 /**
  * Plugin interface for customizing widget components
  */
-interface ChatWidgetPlugin {
+interface AgentWidgetPlugin {
     /**
      * Unique identifier for the plugin
      */
@@ -15,16 +15,16 @@ interface ChatWidgetPlugin {
      * Return null to use default renderer
      */
     renderMessage?: (context: {
-        message: ChatWidgetMessage;
+        message: AgentWidgetMessage;
         defaultRenderer: () => HTMLElement;
-        config: ChatWidgetConfig;
+        config: AgentWidgetConfig;
     }) => HTMLElement | null;
     /**
      * Custom renderer for launcher button
      * Return null to use default renderer
      */
     renderLauncher?: (context: {
-        config: ChatWidgetConfig;
+        config: AgentWidgetConfig;
         defaultRenderer: () => HTMLElement;
         onToggle: () => void;
     }) => HTMLElement | null;
@@ -33,7 +33,7 @@ interface ChatWidgetPlugin {
      * Return null to use default renderer
      */
     renderHeader?: (context: {
-        config: ChatWidgetConfig;
+        config: AgentWidgetConfig;
         defaultRenderer: () => HTMLElement;
         onClose?: () => void;
     }) => HTMLElement | null;
@@ -42,7 +42,7 @@ interface ChatWidgetPlugin {
      * Return null to use default renderer
      */
     renderComposer?: (context: {
-        config: ChatWidgetConfig;
+        config: AgentWidgetConfig;
         defaultRenderer: () => HTMLElement;
         onSubmit: (text: string) => void;
         disabled: boolean;
@@ -52,18 +52,18 @@ interface ChatWidgetPlugin {
      * Return null to use default renderer
      */
     renderReasoning?: (context: {
-        message: ChatWidgetMessage;
+        message: AgentWidgetMessage;
         defaultRenderer: () => HTMLElement;
-        config: ChatWidgetConfig;
+        config: AgentWidgetConfig;
     }) => HTMLElement | null;
     /**
      * Custom renderer for tool call bubbles
      * Return null to use default renderer
      */
     renderToolCall?: (context: {
-        message: ChatWidgetMessage;
+        message: AgentWidgetMessage;
         defaultRenderer: () => HTMLElement;
-        config: ChatWidgetConfig;
+        config: AgentWidgetConfig;
     }) => HTMLElement | null;
     /**
      * Called when plugin is registered
@@ -75,11 +75,11 @@ interface ChatWidgetPlugin {
     onUnregister?: () => void;
 }
 
-type ChatWidgetFeatureFlags = {
+type AgentWidgetFeatureFlags = {
     showReasoning?: boolean;
     showToolCalls?: boolean;
 };
-type ChatWidgetTheme = {
+type AgentWidgetTheme = {
     primary?: string;
     secondary?: string;
     surface?: string;
@@ -98,6 +98,9 @@ type ChatWidgetTheme = {
     closeButtonColor?: string;
     closeButtonBackgroundColor?: string;
     closeButtonBorderColor?: string;
+    clearChatIconColor?: string;
+    clearChatBackgroundColor?: string;
+    clearChatBorderColor?: string;
     micIconColor?: string;
     micBackgroundColor?: string;
     micBorderColor?: string;
@@ -112,7 +115,7 @@ type ChatWidgetTheme = {
     launcherRadius?: string;
     buttonRadius?: string;
 };
-type ChatWidgetLauncherConfig = {
+type AgentWidgetLauncherConfig = {
     enabled?: boolean;
     title?: string;
     subtitle?: string;
@@ -141,9 +144,16 @@ type ChatWidgetLauncherConfig = {
     closeButtonBorderWidth?: string;
     closeButtonBorderColor?: string;
     closeButtonBorderRadius?: string;
+    closeButtonPaddingX?: string;
+    closeButtonPaddingY?: string;
     closeButtonPlacement?: "inline" | "top-right";
+    closeButtonIconName?: string;
+    closeButtonIconText?: string;
+    closeButtonTooltipText?: string;
+    closeButtonShowTooltip?: boolean;
+    clearChat?: AgentWidgetClearChatConfig;
 };
-type ChatWidgetSendButtonConfig = {
+type AgentWidgetSendButtonConfig = {
     borderWidth?: string;
     borderColor?: string;
     paddingX?: string;
@@ -157,14 +167,28 @@ type ChatWidgetSendButtonConfig = {
     textColor?: string;
     size?: string;
 };
-type ChatWidgetStatusIndicatorConfig = {
+type AgentWidgetClearChatConfig = {
+    enabled?: boolean;
+    iconName?: string;
+    iconColor?: string;
+    backgroundColor?: string;
+    borderWidth?: string;
+    borderColor?: string;
+    borderRadius?: string;
+    size?: string;
+    paddingX?: string;
+    paddingY?: string;
+    tooltipText?: string;
+    showTooltip?: boolean;
+};
+type AgentWidgetStatusIndicatorConfig = {
     visible?: boolean;
     idleText?: string;
     connectingText?: string;
     connectedText?: string;
     errorText?: string;
 };
-type ChatWidgetVoiceRecognitionConfig = {
+type AgentWidgetVoiceRecognitionConfig = {
     enabled?: boolean;
     pauseDuration?: number;
     iconName?: string;
@@ -182,7 +206,7 @@ type ChatWidgetVoiceRecognitionConfig = {
     recordingBorderColor?: string;
     showRecordingIndicator?: boolean;
 };
-type ChatWidgetConfig = {
+type AgentWidgetConfig = {
     apiUrl?: string;
     flowId?: string;
     headers?: Record<string, string>;
@@ -192,26 +216,26 @@ type ChatWidgetConfig = {
         inputPlaceholder?: string;
         sendButtonLabel?: string;
     };
-    theme?: ChatWidgetTheme;
-    features?: ChatWidgetFeatureFlags;
-    launcher?: ChatWidgetLauncherConfig;
-    initialMessages?: ChatWidgetMessage[];
+    theme?: AgentWidgetTheme;
+    features?: AgentWidgetFeatureFlags;
+    launcher?: AgentWidgetLauncherConfig;
+    initialMessages?: AgentWidgetMessage[];
     suggestionChips?: string[];
     debug?: boolean;
     formEndpoint?: string;
     launcherWidth?: string;
-    sendButton?: ChatWidgetSendButtonConfig;
-    statusIndicator?: ChatWidgetStatusIndicatorConfig;
-    voiceRecognition?: ChatWidgetVoiceRecognitionConfig;
+    sendButton?: AgentWidgetSendButtonConfig;
+    statusIndicator?: AgentWidgetStatusIndicatorConfig;
+    voiceRecognition?: AgentWidgetVoiceRecognitionConfig;
     postprocessMessage?: (context: {
         text: string;
-        message: ChatWidgetMessage;
+        message: AgentWidgetMessage;
         streaming: boolean;
     }) => string;
-    plugins?: ChatWidgetPlugin[];
+    plugins?: AgentWidgetPlugin[];
 };
-type ChatWidgetMessageRole = "user" | "assistant" | "system";
-type ChatWidgetReasoning = {
+type AgentWidgetMessageRole = "user" | "assistant" | "system";
+type AgentWidgetReasoning = {
     id: string;
     status: "pending" | "streaming" | "complete";
     chunks: string[];
@@ -219,7 +243,7 @@ type ChatWidgetReasoning = {
     completedAt?: number;
     durationMs?: number;
 };
-type ChatWidgetToolCall = {
+type AgentWidgetToolCall = {
     id: string;
     name?: string;
     status: "pending" | "running" | "complete";
@@ -231,22 +255,22 @@ type ChatWidgetToolCall = {
     completedAt?: number;
     durationMs?: number;
 };
-type ChatWidgetMessageVariant = "assistant" | "reasoning" | "tool";
-type ChatWidgetMessage = {
+type AgentWidgetMessageVariant = "assistant" | "reasoning" | "tool";
+type AgentWidgetMessage = {
     id: string;
-    role: ChatWidgetMessageRole;
+    role: AgentWidgetMessageRole;
     content: string;
     createdAt: string;
     streaming?: boolean;
-    variant?: ChatWidgetMessageVariant;
+    variant?: AgentWidgetMessageVariant;
     sequence?: number;
-    reasoning?: ChatWidgetReasoning;
-    toolCall?: ChatWidgetToolCall;
-    tools?: ChatWidgetToolCall[];
+    reasoning?: AgentWidgetReasoning;
+    toolCall?: AgentWidgetToolCall;
+    tools?: AgentWidgetToolCall[];
 };
-type ChatWidgetEvent = {
+type AgentWidgetEvent = {
     type: "message";
-    message: ChatWidgetMessage;
+    message: AgentWidgetMessage;
 } | {
     type: "status";
     status: "connecting" | "connected" | "error" | "idle";
@@ -254,36 +278,37 @@ type ChatWidgetEvent = {
     type: "error";
     error: Error;
 };
-type ChatWidgetInitOptions = {
+type AgentWidgetInitOptions = {
     target: string | HTMLElement;
-    config?: ChatWidgetConfig;
+    config?: AgentWidgetConfig;
     useShadowDom?: boolean;
     onReady?: () => void;
 };
 
 type Controller = {
-    update: (config: ChatWidgetConfig) => void;
+    update: (config: AgentWidgetConfig) => void;
     destroy: () => void;
     open: () => void;
     close: () => void;
     toggle: () => void;
+    clearChat: () => void;
 };
-declare const createChatExperience: (mount: HTMLElement, initialConfig?: ChatWidgetConfig) => Controller;
-type ChatWidgetController = Controller;
+declare const createAgentExperience: (mount: HTMLElement, initialConfig?: AgentWidgetConfig) => Controller;
+type AgentWidgetController = Controller;
 
-type ChatWidgetInitHandle = ChatWidgetController & {
+type AgentWidgetInitHandle = AgentWidgetController & {
     host: HTMLElement;
 };
-declare const initChatWidget: (options: ChatWidgetInitOptions) => ChatWidgetInitHandle;
+declare const initAgentWidget: (options: AgentWidgetInitOptions) => AgentWidgetInitHandle;
 
-type ChatWidgetSessionStatus = "idle" | "connecting" | "connected" | "error";
+type AgentWidgetSessionStatus = "idle" | "connecting" | "connected" | "error";
 type SessionCallbacks = {
-    onMessagesChanged: (messages: ChatWidgetMessage[]) => void;
-    onStatusChanged: (status: ChatWidgetSessionStatus) => void;
+    onMessagesChanged: (messages: AgentWidgetMessage[]) => void;
+    onStatusChanged: (status: AgentWidgetSessionStatus) => void;
     onStreamingChanged: (streaming: boolean) => void;
     onError?: (error: Error) => void;
 };
-declare class ChatWidgetSession {
+declare class AgentWidgetSession {
     private config;
     private callbacks;
     private client;
@@ -292,13 +317,14 @@ declare class ChatWidgetSession {
     private streaming;
     private abortController;
     private sequenceCounter;
-    constructor(config: ChatWidgetConfig | undefined, callbacks: SessionCallbacks);
-    updateConfig(next: ChatWidgetConfig): void;
-    getMessages(): ChatWidgetMessage[];
-    getStatus(): ChatWidgetSessionStatus;
+    constructor(config: AgentWidgetConfig | undefined, callbacks: SessionCallbacks);
+    updateConfig(next: AgentWidgetConfig): void;
+    getMessages(): AgentWidgetMessage[];
+    getStatus(): AgentWidgetSessionStatus;
     isStreaming(): boolean;
     sendMessage(rawInput: string): Promise<void>;
     cancel(): void;
+    clearMessages(): void;
     private handleEvent;
     private setStatus;
     private setStreaming;
@@ -310,16 +336,16 @@ declare class ChatWidgetSession {
 }
 
 type DispatchOptions = {
-    messages: ChatWidgetMessage[];
+    messages: AgentWidgetMessage[];
     signal?: AbortSignal;
 };
-type SSEHandler = (event: ChatWidgetEvent) => void;
-declare class ChatWidgetClient {
+type SSEHandler = (event: AgentWidgetEvent) => void;
+declare class AgentWidgetClient {
     private config;
     private readonly apiUrl;
     private readonly headers;
     private readonly debug;
-    constructor(config?: ChatWidgetConfig);
+    constructor(config?: AgentWidgetConfig);
     dispatch(options: DispatchOptions, onEvent: SSEHandler): Promise<void>;
     private streamResponse;
 }
@@ -346,7 +372,7 @@ declare class PluginRegistry {
     /**
      * Register a plugin
      */
-    register(plugin: ChatWidgetPlugin): void;
+    register(plugin: AgentWidgetPlugin): void;
     /**
      * Unregister a plugin
      */
@@ -354,12 +380,12 @@ declare class PluginRegistry {
     /**
      * Get all plugins sorted by priority
      */
-    getAll(): ChatWidgetPlugin[];
+    getAll(): AgentWidgetPlugin[];
     /**
      * Get plugins for a specific instance (from config)
      * Merges instance plugins with globally registered plugins
      */
-    getForInstance(instancePlugins?: ChatWidgetPlugin[]): ChatWidgetPlugin[];
+    getForInstance(instancePlugins?: AgentWidgetPlugin[]): AgentWidgetPlugin[];
     /**
      * Clear all plugins
      */
@@ -367,4 +393,15 @@ declare class PluginRegistry {
 }
 declare const pluginRegistry: PluginRegistry;
 
-export { ChatWidgetClient, type ChatWidgetConfig, type ChatWidgetController, type ChatWidgetEvent, type ChatWidgetFeatureFlags, type ChatWidgetInitHandle, type ChatWidgetInitOptions, type ChatWidgetLauncherConfig, type ChatWidgetMessage, type ChatWidgetPlugin, ChatWidgetSession, type ChatWidgetSessionStatus, type ChatWidgetTheme, createChatExperience, initChatWidget as default, directivePostprocessor, escapeHtml, initChatWidget, markdownPostprocessor, pluginRegistry };
+/**
+ * Default widget configuration
+ * Single source of truth for all default values
+ */
+declare const DEFAULT_WIDGET_CONFIG: Partial<AgentWidgetConfig>;
+/**
+ * Helper to deep merge user config with defaults
+ * This ensures all default values are present while allowing selective overrides
+ */
+declare function mergeWithDefaults(config?: Partial<AgentWidgetConfig>): Partial<AgentWidgetConfig>;
+
+export { AgentWidgetClient, type AgentWidgetConfig, type AgentWidgetController, type AgentWidgetEvent, type AgentWidgetFeatureFlags, type AgentWidgetInitHandle, type AgentWidgetInitOptions, type AgentWidgetLauncherConfig, type AgentWidgetMessage, type AgentWidgetPlugin, AgentWidgetSession, type AgentWidgetSessionStatus, type AgentWidgetTheme, DEFAULT_WIDGET_CONFIG, createAgentExperience, initAgentWidget as default, directivePostprocessor, escapeHtml, initAgentWidget, markdownPostprocessor, mergeWithDefaults, pluginRegistry };