@chatwidgetai/chat-widget 0.1.0 → 0.1.1

package/dist/api/client.d.ts

@@ -8,6 +8,15 @@ export interface ApiClientConfig {
     apiKey: string;
     apiUrl: string;
 }
+export declare class ApiError extends Error {
+    status: number;
+    details?: unknown;
+    retryAfterMs?: number;
+    constructor(message: string, status: number, options?: {
+        details?: unknown;
+        retryAfterMs?: number;
+    });
+}
 export declare class WidgetApiClient {
     private config;
     constructor(config: ApiClientConfig);

package/dist/api/client.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"client.d.ts","sourceRoot":"","sources":["../../src/api/client.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAEH,OAAO,EAAE,YAAY,EAAE,mBAAmB,EAAE,MAAM,UAAU,CAAC;AAE7D,MAAM,WAAW,eAAe;IAC9B,QAAQ,EAAE,MAAM,CAAC;IACjB,MAAM,EAAE,MAAM,CAAC;IACf,MAAM,EAAE,MAAM,CAAC;CAChB;AAED,qBAAa,eAAe;IAC1B,OAAO,CAAC,MAAM,CAAkB;gBAEpB,MAAM,EAAE,eAAe;IAInC;;OAEG;IACG,SAAS,IAAI,OAAO,CAAC,YAAY,CAAC;IAoBlC,uBAAuB,CAAC,cAAc,CAAC,EAAE,MAAM,GAAG,OAAO,CAAC;QAAC,EAAE,EAAE,MAAM,CAAC;QAAC,QAAQ,EAAE,mBAAmB,EAAE,CAAA;KAAC,CAAC;IAqB9G;;OAEG;IACG,UAAU,CAAC,cAAc,EAAE,MAAM,EAAE,IAAI,EAAE,IAAI,GAAG,OAAO,CAAC;QAAE,EAAE,EAAE,MAAM,CAAC;QAAC,QAAQ,EAAE,MAAM,CAAC;QAAC,IAAI,EAAE,MAAM,CAAA;KAAE,CAAC;IAyB7G;;;OAGG;IACG,WAAW,CAAC,cAAc,EAAE,MAAM,EAAE,OAAO,EAAE,MAAM,EAAE,OAAO,CAAC,EAAE,MAAM,EAAE,GAAG,OAAO,CAAC,mBAAmB,EAAE,CAAC;IAyB9G;;OAEG;IACG,gBAAgB,CACpB,cAAc,EAAE,MAAM,EACtB,OAAO,EAAE,MAAM,EACf,OAAO,CAAC,EAAE,MAAM,EAAE,GACjB,OAAO,CAAC,GAAG,CAAC;IA4Cf;;OAEG;IACG,cAAc,CAClB,SAAS,EAAE,MAAM,EACjB,SAAS,EAAE,MAAM,EACjB,QAAQ,EAAE,UAAU,GAAG,UAAU,GAChC,OAAO,CAAC,IAAI,CAAC;IA4BhB;;OAEG;IACG,cAAc,IAAI,OAAO,CAAC,OAAO,CAAC;CAsBzC"}
+{"version":3,"file":"client.d.ts","sourceRoot":"","sources":["../../src/api/client.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAEH,OAAO,EAAE,YAAY,EAAE,mBAAmB,EAAE,MAAM,UAAU,CAAC;AAE7D,MAAM,WAAW,eAAe;IAC9B,QAAQ,EAAE,MAAM,CAAC;IACjB,MAAM,EAAE,MAAM,CAAC;IACf,MAAM,EAAE,MAAM,CAAC;CAChB;AAED,qBAAa,QAAS,SAAQ,KAAK;IACjC,MAAM,EAAE,MAAM,CAAC;IACf,OAAO,CAAC,EAAE,OAAO,CAAC;IAClB,YAAY,CAAC,EAAE,MAAM,CAAC;gBAEV,OAAO,EAAE,MAAM,EAAE,MAAM,EAAE,MAAM,EAAE,OAAO,CAAC,EAAE;QAAE,OAAO,CAAC,EAAE,OAAO,CAAC;QAAC,YAAY,CAAC,EAAE,MAAM,CAAA;KAAE;CAOpG;AAwDD,qBAAa,eAAe;IAC1B,OAAO,CAAC,MAAM,CAAkB;gBAEpB,MAAM,EAAE,eAAe;IAInC;;OAEG;IACG,SAAS,IAAI,OAAO,CAAC,YAAY,CAAC;IAoBlC,uBAAuB,CAAC,cAAc,CAAC,EAAE,MAAM,GAAG,OAAO,CAAC;QAAE,EAAE,EAAE,MAAM,CAAC;QAAC,QAAQ,EAAE,mBAAmB,EAAE,CAAA;KAAE,CAAC;IAqBhH;;OAEG;IACG,UAAU,CAAC,cAAc,EAAE,MAAM,EAAE,IAAI,EAAE,IAAI,GAAG,OAAO,CAAC;QAAE,EAAE,EAAE,MAAM,CAAC;QAAC,QAAQ,EAAE,MAAM,CAAC;QAAC,IAAI,EAAE,MAAM,CAAA;KAAE,CAAC;IAwB7G;;;OAGG;IACG,WAAW,CAAC,cAAc,EAAE,MAAM,EAAE,OAAO,EAAE,MAAM,EAAE,OAAO,CAAC,EAAE,MAAM,EAAE,GAAG,OAAO,CAAC,mBAAmB,EAAE,CAAC;IAwB9G;;OAEG;IACG,gBAAgB,CACpB,cAAc,EAAE,MAAM,EACtB,OAAO,EAAE,MAAM,EACf,OAAO,CAAC,EAAE,MAAM,EAAE,GACjB,OAAO,CAAC,GAAG,CAAC;IA2Cf;;OAEG;IACG,cAAc,CAClB,SAAS,EAAE,MAAM,EACjB,SAAS,EAAE,MAAM,EACjB,QAAQ,EAAE,UAAU,GAAG,UAAU,GAChC,OAAO,CAAC,IAAI,CAAC;IA4BhB;;OAEG;IACG,cAAc,IAAI,OAAO,CAAC,OAAO,CAAC;CAsBzC"}

package/dist/components/ChatWidget.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"ChatWidget.d.ts","sourceRoot":"","sources":["../../src/components/ChatWidget.tsx"],"names":[],"mappings":"AAAA;;;GAGG;AAEH,OAAO,KAA8B,MAAM,OAAO,CAAC;AACnD,OAAO,EAAE,WAAW,EAAE,MAAM,UAAU,CAAC;AAGvC,OAAO,sBAAsB,CAAC;AAE9B,eAAO,MAAM,UAAU,EAAE,KAAK,CAAC,EAAE,CAAC,WAAW,CAkI5C,CAAC"}
+{"version":3,"file":"ChatWidget.d.ts","sourceRoot":"","sources":["../../src/components/ChatWidget.tsx"],"names":[],"mappings":"AAAA;;;GAGG;AAEH,OAAO,KAA8B,MAAM,OAAO,CAAC;AACnD,OAAO,EAAE,WAAW,EAAE,MAAM,UAAU,CAAC;AAGvC,OAAO,sBAAsB,CAAC;AAE9B,eAAO,MAAM,UAAU,EAAE,KAAK,CAAC,EAAE,CAAC,WAAW,CA8H5C,CAAC"}

package/dist/components/ChatWindow.d.ts

@@ -11,8 +11,6 @@ export interface ChatWindowProps {
     error: string | null;
     config: WidgetConfig | null;
     onSendMessage: (message: string) => void;
-    onApproveAction: () => void;
-    onRejectAction: () => void;
     onClose: () => void;
     onFeedback: (messageId: string, feedback: 'positive' | 'negative') => void;
 }

package/dist/components/ChatWindow.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"ChatWindow.d.ts","sourceRoot":"","sources":["../../src/components/ChatWindow.tsx"],"names":[],"mappings":"AAAA;;;GAGG;AAEH,OAAO,KAA8B,MAAM,OAAO,CAAC;AACnD,OAAO,EAAE,mBAAmB,EAAE,YAAY,EAAE,MAAM,UAAU,CAAC;AAK7D,MAAM,WAAW,eAAe;IAC9B,QAAQ,EAAE,mBAAmB,EAAE,CAAC;IAChC,SAAS,EAAE,OAAO,CAAC;IACnB,QAAQ,EAAE,OAAO,CAAC;IAClB,KAAK,EAAE,MAAM,GAAG,IAAI,CAAC;IACrB,MAAM,EAAE,YAAY,GAAG,IAAI,CAAC;IAC5B,aAAa,EAAE,CAAC,OAAO,EAAE,MAAM,KAAK,IAAI,CAAC;IACzC,eAAe,EAAE,MAAM,IAAI,CAAC;IAC5B,cAAc,EAAE,MAAM,IAAI,CAAC;IAC3B,OAAO,EAAE,MAAM,IAAI,CAAC;IACpB,UAAU,EAAE,CAAC,SAAS,EAAE,MAAM,EAAE,QAAQ,EAAE,UAAU,GAAG,UAAU,KAAK,IAAI,CAAC;CAC5E;AAED,eAAO,MAAM,UAAU,EAAE,KAAK,CAAC,EAAE,CAAC,eAAe,CAgIhD,CAAC"}
+{"version":3,"file":"ChatWindow.d.ts","sourceRoot":"","sources":["../../src/components/ChatWindow.tsx"],"names":[],"mappings":"AAAA;;;GAGG;AAEH,OAAO,KAA8B,MAAM,OAAO,CAAC;AACnD,OAAO,EAAE,mBAAmB,EAAE,YAAY,EAAE,MAAM,UAAU,CAAC;AAK7D,MAAM,WAAW,eAAe;IAC9B,QAAQ,EAAE,mBAAmB,EAAE,CAAC;IAChC,SAAS,EAAE,OAAO,CAAC;IACnB,QAAQ,EAAE,OAAO,CAAC;IAClB,KAAK,EAAE,MAAM,GAAG,IAAI,CAAC;IACrB,MAAM,EAAE,YAAY,GAAG,IAAI,CAAC;IAC5B,aAAa,EAAE,CAAC,OAAO,EAAE,MAAM,KAAK,IAAI,CAAC;IACzC,OAAO,EAAE,MAAM,IAAI,CAAC;IACpB,UAAU,EAAE,CAAC,SAAS,EAAE,MAAM,EAAE,QAAQ,EAAE,UAAU,GAAG,UAAU,KAAK,IAAI,CAAC;CAC5E;AAED,eAAO,MAAM,UAAU,EAAE,KAAK,CAAC,EAAE,CAAC,eAAe,CAgIhD,CAAC"}

package/dist/hooks/useChat.d.ts

@@ -3,7 +3,6 @@
  * Main state management for chat functionality
  */
 import { ConversationMessage, WidgetConfig } from '../types';
-import { ClientAction } from '../utils/actionExecutor';
 export interface UseChatOptions {
     widgetId: string;
     apiKey: string;
@@ -11,12 +10,6 @@ export interface UseChatOptions {
     onMessage?: (message: ConversationMessage) => void;
     onError?: (error: Error) => void;
 }
-export interface PendingAction {
-    action: ClientAction;
-    message: string;
-    continueToken: string;
-    messageId: string;
-}
 export interface UseChatReturn {
     messages: ConversationMessage[];
     isLoading: boolean;
@@ -24,10 +17,7 @@ export interface UseChatReturn {
     error: string | null;
     config: WidgetConfig | null;
     conversationId: string;
-    pendingAction: PendingAction | null;
     sendMessage: (content: string) => Promise<void>;
-    approveAction: () => Promise<void>;
-    rejectAction: () => void;
     clearMessages: () => void;
     submitFeedback: (messageId: string, feedback: 'positive' | 'negative') => Promise<void>;
 }

package/dist/hooks/useChat.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"useChat.d.ts","sourceRoot":"","sources":["../../src/hooks/useChat.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAGH,OAAO,EAAE,mBAAmB,EAAE,YAAY,EAAa,MAAM,UAAU,CAAC;AAIxE,OAAO,EAAuB,YAAY,EAAgB,MAAM,yBAAyB,CAAC;AAE1F,MAAM,WAAW,cAAc;IAC7B,QAAQ,EAAE,MAAM,CAAC;IACjB,MAAM,EAAE,MAAM,CAAC;IACf,MAAM,EAAE,MAAM,CAAC;IACf,SAAS,CAAC,EAAE,CAAC,OAAO,EAAE,mBAAmB,KAAK,IAAI,CAAC;IACnD,OAAO,CAAC,EAAE,CAAC,KAAK,EAAE,KAAK,KAAK,IAAI,CAAC;CAClC;AAED,MAAM,WAAW,aAAa;IAC5B,MAAM,EAAE,YAAY,CAAC;IACrB,OAAO,EAAE,MAAM,CAAC;IAChB,aAAa,EAAE,MAAM,CAAC;IACtB,SAAS,EAAE,MAAM,CAAC;CACnB;AAED,MAAM,WAAW,aAAa;IAC5B,QAAQ,EAAE,mBAAmB,EAAE,CAAC;IAChC,SAAS,EAAE,OAAO,CAAC;IACnB,QAAQ,EAAE,OAAO,CAAC;IAClB,KAAK,EAAE,MAAM,GAAG,IAAI,CAAC;IACrB,MAAM,EAAE,YAAY,GAAG,IAAI,CAAC;IAC5B,cAAc,EAAE,MAAM,CAAC;IACvB,aAAa,EAAE,aAAa,GAAG,IAAI,CAAC;IACpC,WAAW,EAAE,CAAC,OAAO,EAAE,MAAM,KAAK,OAAO,CAAC,IAAI,CAAC,CAAC;IAChD,aAAa,EAAE,MAAM,OAAO,CAAC,IAAI,CAAC,CAAC;IACnC,YAAY,EAAE,MAAM,IAAI,CAAC;IACzB,aAAa,EAAE,MAAM,IAAI,CAAC;IAC1B,cAAc,EAAE,CAAC,SAAS,EAAE,MAAM,EAAE,QAAQ,EAAE,UAAU,GAAG,UAAU,KAAK,OAAO,CAAC,IAAI,CAAC,CAAC;CACzF;AAED,wBAAgB,OAAO,CAAC,OAAO,EAAE,cAAc,GAAG,aAAa,CAoZ9D"}
+{"version":3,"file":"useChat.d.ts","sourceRoot":"","sources":["../../src/hooks/useChat.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAGH,OAAO,EAAE,mBAAmB,EAAE,YAAY,EAAa,MAAM,UAAU,CAAC;AAKxE,MAAM,WAAW,cAAc;IAC7B,QAAQ,EAAE,MAAM,CAAC;IACjB,MAAM,EAAE,MAAM,CAAC;IACf,MAAM,EAAE,MAAM,CAAC;IACf,SAAS,CAAC,EAAE,CAAC,OAAO,EAAE,mBAAmB,KAAK,IAAI,CAAC;IACnD,OAAO,CAAC,EAAE,CAAC,KAAK,EAAE,KAAK,KAAK,IAAI,CAAC;CAClC;AAED,MAAM,WAAW,aAAa;IAC5B,QAAQ,EAAE,mBAAmB,EAAE,CAAC;IAChC,SAAS,EAAE,OAAO,CAAC;IACnB,QAAQ,EAAE,OAAO,CAAC;IAClB,KAAK,EAAE,MAAM,GAAG,IAAI,CAAC;IACrB,MAAM,EAAE,YAAY,GAAG,IAAI,CAAC;IAC5B,cAAc,EAAE,MAAM,CAAC;IACvB,WAAW,EAAE,CAAC,OAAO,EAAE,MAAM,KAAK,OAAO,CAAC,IAAI,CAAC,CAAC;IAChD,aAAa,EAAE,MAAM,IAAI,CAAC;IAC1B,cAAc,EAAE,CAAC,SAAS,EAAE,MAAM,EAAE,QAAQ,EAAE,UAAU,GAAG,UAAU,KAAK,OAAO,CAAC,IAAI,CAAC,CAAC;CACzF;AAkED,wBAAgB,OAAO,CAAC,OAAO,EAAE,cAAc,GAAG,aAAa,CAyS9D"}

package/dist/index.d.ts

@@ -4,6 +4,7 @@
  */
 export { ChatWidget } from './components/ChatWidget';
 export { useChat } from './hooks/useChat';
+export { ApiError } from './api/client';
 export type { WidgetProps, WidgetTheme, WidgetPosition, WidgetSize, WidgetAppearance, WidgetBehavior, WidgetConfig, ConversationMessage, ChatMessage, KbDocument, SourceDisplayMode, ChatState, } from './types';
 export type { UseChatOptions, UseChatReturn, } from './hooks/useChat';
 //# sourceMappingURL=index.d.ts.map

package/dist/index.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAEH,OAAO,EAAE,UAAU,EAAE,MAAM,yBAAyB,CAAC;AACrD,OAAO,EAAE,OAAO,EAAE,MAAM,iBAAiB,CAAC;AAG1C,YAAY,EACV,WAAW,EACX,WAAW,EACX,cAAc,EACd,UAAU,EACV,gBAAgB,EAChB,cAAc,EACd,YAAY,EACZ,mBAAmB,EACnB,WAAW,EACX,UAAU,EACV,iBAAiB,EACjB,SAAS,GACV,MAAM,SAAS,CAAC;AAEjB,YAAY,EACV,cAAc,EACd,aAAa,GACd,MAAM,iBAAiB,CAAC"}
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAEH,OAAO,EAAE,UAAU,EAAE,MAAM,yBAAyB,CAAC;AACrD,OAAO,EAAE,OAAO,EAAE,MAAM,iBAAiB,CAAC;AAC1C,OAAO,EAAE,QAAQ,EAAE,MAAM,cAAc,CAAC;AAGxC,YAAY,EACV,WAAW,EACX,WAAW,EACX,cAAc,EACd,UAAU,EACV,gBAAgB,EAChB,cAAc,EACd,YAAY,EACZ,mBAAmB,EACnB,WAAW,EACX,UAAU,EACV,iBAAiB,EACjB,SAAS,GACV,MAAM,SAAS,CAAC;AAEjB,YAAY,EACV,cAAc,EACd,aAAa,GACd,MAAM,iBAAiB,CAAC"}

package/dist/index.esm.js

@@ -5,6 +5,65 @@ import { useState, useRef, useEffect, useCallback, useMemo } from 'react';
  * API Client for Widget Communication
  * Handles all HTTP requests to the widget API
  */
+class ApiError extends Error {
+    constructor(message, status, options) {
+        super(message);
+        this.name = 'ApiError';
+        this.status = status;
+        this.details = options?.details;
+        this.retryAfterMs = options?.retryAfterMs;
+    }
+}
+function parseRetryAfter(headerValue) {
+    if (!headerValue)
+        return undefined;
+    const seconds = Number(headerValue);
+    if (!Number.isNaN(seconds) && seconds >= 0) {
+        return seconds * 1000;
+    }
+    const date = Date.parse(headerValue);
+    if (!Number.isNaN(date)) {
+        return Math.max(0, date - Date.now());
+    }
+    return undefined;
+}
+async function buildApiError(response, defaultMessage) {
+    let parsedBody = null;
+    let message = defaultMessage;
+    try {
+        const raw = await response.text();
+        if (raw) {
+            try {
+                parsedBody = JSON.parse(raw);
+                if (typeof parsedBody === 'object' && parsedBody !== null) {
+                    const body = parsedBody;
+                    message = typeof body.error === 'string'
+                        ? body.error
+                        : typeof body.message === 'string'
+                            ? body.message
+                            : defaultMessage;
+                }
+                else {
+                    message = raw;
+                }
+            }
+            catch {
+                message = raw;
+            }
+        }
+    }
+    catch {
+        // ignore body parsing errors
+    }
+    let retryAfterMs = parseRetryAfter(response.headers.get('retry-after'));
+    if (retryAfterMs === undefined) {
+        retryAfterMs = parseRetryAfter(response.headers.get('x-ratelimit-reset'));
+    }
+    return new ApiError(message || defaultMessage, response.status, {
+        details: parsedBody,
+        retryAfterMs,
+    });
+}
 class WidgetApiClient {
     constructor(config) {
         this.config = config;
@@ -21,23 +80,24 @@ class WidgetApiClient {
             },
         });
         if (!response.ok) {
-            throw new Error(`Failed to fetch config: ${response.statusText}`);
+            throw await buildApiError(response, 'Failed to fetch config');
         }
         const json = await response.json();
         return json;
     }
     async getOrCreateConversation(conversationId) {
-        const response = await fetch(`${this.config.apiUrl}/api/widget/${this.config.widgetId}/conversation/${conversationId || '0'}`, {
+        const baseUrl = `${this.config.apiUrl}/api/widget/${this.config.widgetId}/conversation`;
+        const query = conversationId ? `?conversationId=${encodeURIComponent(conversationId)}` : '';
+        const response = await fetch(`${baseUrl}${query}`, {
             method: 'GET',
             headers: {
                 'Authorization': `Bearer ${this.config.apiKey}`,
-            }
+            },
         });
         if (!response.ok) {
-            const error = await response.json().catch(() => ({ error: response.statusText }));
-            throw new Error(error.error || 'Failed to upload file');
+            throw await buildApiError(response, 'Failed to load conversation');
         }
-        return await response.json();
+        return response.json();
     }
     /**
      * Upload a file
@@ -54,8 +114,7 @@ class WidgetApiClient {
             body: formData,
         });
         if (!response.ok) {
-            const error = await response.json().catch(() => ({ error: response.statusText }));
-            throw new Error(error.error || 'Failed to upload file');
+            throw await buildApiError(response, 'Failed to upload file');
         }
         const result = await response.json();
         return result.file;
@@ -78,8 +137,7 @@ class WidgetApiClient {
             }),
         });
         if (!response.ok) {
-            const error = await response.json().catch(() => ({ error: response.statusText }));
-            throw new Error(error.error || 'Failed to send message');
+            throw await buildApiError(response, 'Failed to send message');
         }
         return response.json();
     }
@@ -101,8 +159,7 @@ class WidgetApiClient {
                 }),
             });
             if (!response.ok) {
-                const error = await response.json().catch(() => ({ error: response.statusText }));
-                throw new Error(error.error || `Agent request failed with status ${response.status}`);
+                throw await buildApiError(response, `Agent request failed with status ${response.status}`);
             }
             const data = await response.json();
             // Check if response indicates an error
@@ -114,7 +171,7 @@ class WidgetApiClient {
         catch (error) {
             // Enhance error messages
             if (error instanceof TypeError && error.message.includes('fetch')) {
-                throw new Error('Network error: Unable to reach the server');
+                throw new ApiError('Network error: Unable to reach the server', 0);
             }
             throw error;
         }
@@ -136,13 +193,13 @@ class WidgetApiClient {
             }),
         });
         if (!response.ok) {
-            const errorData = await response.json().catch(() => ({ error: 'Unknown error' }));
+            const apiError = await buildApiError(response, 'Failed to submit feedback');
             console.error('Feedback submission failed:', {
                 status: response.status,
-                error: errorData,
+                error: apiError.details,
                 payload: { session_id: sessionId, message_id: messageId, feedback }
             });
-            throw new Error(errorData.error || 'Failed to submit feedback');
+            throw apiError;
         }
     }
     /**
@@ -250,111 +307,70 @@ function isStorageAvailable() {
 }
 
 /**
- * Client Action Executor
- * Handles execution of client-side actions
- */
-/**
- * Execute a client-side action
+ * useChat Hook
+ * Main state management for chat functionality
  */
-async function executeClientAction(action) {
-    try {
-        console.log(`[ActionExecutor] Executing action: ${action.implementation}`, action.parameters);
-        switch (action.implementation) {
-            case 'redirect':
-                return executeRedirect(action.parameters);
-            case 'show_modal':
-                return executeShowModal(action.parameters);
-            case 'copy_to_clipboard':
-                return executeCopyToClipboard(action.parameters);
-            case 'open_chat':
-                return executeOpenChat(action.parameters);
+function deriveErrorInfo(error) {
+    if (error instanceof ApiError) {
+        const retryAfterSeconds = typeof error.retryAfterMs === 'number'
+            ? Math.max(1, Math.ceil(error.retryAfterMs / 1000))
+            : undefined;
+        const lowerMessage = (error.message || '').toLowerCase();
+        let message;
+        switch (error.status) {
+            case 429: {
+                const isPerUser = lowerMessage.includes('user');
+                const base = isPerUser
+                    ? 'You have reached the per-user rate limit.'
+                    : 'This widget has received too many requests.';
+                if (retryAfterSeconds) {
+                    message = `${base} Please wait ${retryAfterSeconds} second${retryAfterSeconds === 1 ? '' : 's'} before trying again.`;
+                }
+                else {
+                    message = `${base} Please wait a moment and try again.`;
+                }
+                break;
+            }
+            case 401:
+                message = 'Authentication failed. Please refresh the page or verify your API key.';
+                break;
+            case 403:
+                message = 'Access to this widget is restricted. Please contact the site owner if you believe this is an error.';
+                break;
+            case 404:
+                message = 'We could not find this widget. It may have been removed.';
+                break;
             default:
-                console.warn(`[ActionExecutor] Unknown action: ${action.implementation}`);
-                return {
-                    success: false,
-                    error: `Unknown action type: ${action.implementation}`
-                };
+                if (error.status >= 500) {
+                    message = 'The server encountered an error. Please try again shortly.';
+                }
+                else if (error.status > 0) {
+                    message = error.message || 'Something went wrong. Please try again.';
+                }
+                else {
+                    message = error.message || 'Unable to connect to the server. Please check your internet connection.';
+                }
         }
+        return { message, retryAfterSeconds, status: error.status };
     }
-    catch (error) {
-        console.error(`[ActionExecutor] Error executing action:`, error);
-        return {
-            success: false,
-            error: error instanceof Error ? error.message : 'Unknown error'
-        };
-    }
-}
-/**
- * Redirect to a URL
- */
-function executeRedirect(params) {
-    const url = params.url;
-    if (!url) {
-        return { success: false, error: 'URL parameter is required' };
-    }
-    try {
-        // Validate URL
-        new URL(url);
-        // Redirect
-        window.location.href = url;
-        return { success: true, result: { redirected_to: url } };
-    }
-    catch (error) {
-        return { success: false, error: 'Invalid URL' };
-    }
-}
-/**
- * Show a modal
- */
-function executeShowModal(params) {
-    const { title, content } = params;
-    if (!title || !content) {
-        return { success: false, error: 'Title and content are required' };
-    }
-    // Use browser's alert as a simple modal
-    // In a real implementation, you'd use a proper modal component
-    alert(`${title}\n\n${content}`);
-    return { success: true, result: { shown: true } };
-}
-/**
- * Copy text to clipboard
- */
-async function executeCopyToClipboard(params) {
-    const text = params.text;
-    if (!text) {
-        return { success: false, error: 'Text parameter is required' };
-    }
-    try {
-        await navigator.clipboard.writeText(text);
-        return { success: true, result: { copied: text } };
-    }
-    catch (error) {
-        return {
-            success: false,
-            error: 'Failed to copy to clipboard. Please check browser permissions.'
-        };
-    }
-}
-/**
- * Open chat with a specific message
- */
-function executeOpenChat(params) {
-    const message = params.message;
-    if (!message) {
-        return { success: false, error: 'Message parameter is required' };
+    if (error instanceof Error) {
+        const lower = error.message.toLowerCase();
+        if (lower.includes('network')) {
+            return { message: 'Unable to connect to the server. Please check your internet connection.' };
+        }
+        if (lower.includes('timeout')) {
+            return { message: 'The request timed out. Please try again.' };
+        }
+        if (lower.includes('unauthorized') || lower.includes('401')) {
+            return { message: 'Authentication failed. Please refresh the page or verify your API key.' };
+        }
+        if (lower.includes('internal server error') || lower.includes('500')) {
+            return { message: 'The server encountered an error. Please try again shortly.' };
+        }
+        return { message: error.message || 'Something went wrong. Please try again.' };
     }
-    // Dispatch a custom event that the chat widget can listen to
-    const event = new CustomEvent('widget:open-chat', {
-        detail: { message }
-    });
-    window.dispatchEvent(event);
-    return { success: true, result: { message } };
+    return { message: 'Something went wrong. Please try again.' };
 }
-
-/**
- * useChat Hook
- * Main state management for chat functionality
- */
 function useChat(options) {
     const { widgetId, apiKey, apiUrl, onMessage, onError, } = options;
     const [state, setState] = useState({
@@ -366,7 +382,6 @@ function useChat(options) {
         conversationId: '', // Will be set after loading conversation
         config: null,
     });
-    const [pendingAction, setPendingAction] = useState(null);
     const apiClient = useRef(new WidgetApiClient({ widgetId, apiKey, apiUrl }));
     // Load configuration and conversation on mount
     useEffect(() => {
@@ -391,8 +406,9 @@ function useChat(options) {
                 }));
             }
             catch (error) {
-                const err = error instanceof Error ? error : new Error('Failed to initialize');
-                setState(prev => ({ ...prev, error: err.message }));
+                const errorInfo = deriveErrorInfo(error);
+                const err = error instanceof Error ? error : new Error(errorInfo.message);
+                setState(prev => ({ ...prev, error: errorInfo.message }));
                 onError?.(err);
             }
         };
@@ -447,7 +463,6 @@ function useChat(options) {
             }
             // Determine if widget has actions (use agent endpoint)
             const useAgent = state.config?.behavior.agentic || (state.config?.actions && state.config.actions.length > 0);
-            console.log(useAgent);
             let response;
             if (useAgent) {
                 // Use agent endpoint - returns ConversationMessage[]
@@ -516,26 +531,9 @@ function useChat(options) {
             }
         }
         catch (error) {
-            const err = error instanceof Error ? error : new Error('Failed to send message');
-            // Determine user-friendly error message
-            let userMessage = err.message;
-            // Handle specific error types
-            if (err.message.includes('Network') || err.message.includes('fetch')) {
-                userMessage = 'Unable to connect to the server. Please check your internet connection.';
-            }
-            else if (err.message.includes('401') || err.message.includes('Unauthorized')) {
-                userMessage = 'Authentication failed. Please refresh the page.';
-            }
-            else if (err.message.includes('500') || err.message.includes('Internal Server Error')) {
-                userMessage = 'The server encountered an error. Please try again later.';
-            }
-            else if (err.message.includes('timeout')) {
-                userMessage = 'Request timed out. Please try again.';
-            }
-            // Use fallback message if configured, otherwise use error message
+            const errorInfo = deriveErrorInfo(error);
+            const err = error instanceof Error ? error : new Error(errorInfo.message);
             const fallbackMessage = state.config?.behavior?.fallbackMessage;
-            const errorMessage = fallbackMessage || userMessage;
-            // If fallback message is configured, add it as an assistant message
             if (fallbackMessage) {
                 const fallbackAssistantMessage = {
                     id: generateMessageId(),
@@ -551,17 +549,16 @@ function useChat(options) {
                     messages: [...prev.messages, fallbackAssistantMessage],
                     isLoading: false,
                     isTyping: false,
-                    error: null,
+                    error: errorInfo.message,
                 }));
                 onMessage?.(fallbackAssistantMessage);
             }
             else {
-                // Show error message as assistant message for better UX
                 const errorAssistantMessage = {
                     id: generateMessageId(),
                     message: {
                         type: 'ai',
-                        content: `⚠️ ${errorMessage}`,
+                        content: `⚠️ ${errorInfo.message}`,
                     },
                     timestamp: new Date().toISOString(),
                     sources: [],
@@ -571,7 +568,7 @@ function useChat(options) {
                     messages: [...prev.messages, errorAssistantMessage],
                     isLoading: false,
                     isTyping: false,
-                    error: errorMessage,
+                    error: errorInfo.message,
                 }));
                 onMessage?.(errorAssistantMessage);
             }
@@ -609,81 +606,12 @@ function useChat(options) {
             }));
         }
         catch (error) {
-            const err = error instanceof Error ? error : new Error('Failed to submit feedback');
+            const errorInfo = deriveErrorInfo(error);
+            const err = error instanceof Error ? error : new Error(errorInfo.message);
+            setState(prev => ({ ...prev, error: errorInfo.message }));
             onError?.(err);
         }
     }, [state.conversationId, onError]);
-    /**
-     * Approve and execute pending action
-     */
-    const approveAction = useCallback(async () => {
-        if (!pendingAction)
-            return;
-        setState(prev => ({ ...prev, isLoading: true, isTyping: true }));
-        try {
-            // Execute the client action
-            const actionResult = await executeClientAction(pendingAction.action);
-            // Update the pending action message to show execution result
-            const executionMessage = actionResult.success
-                ? `✓ Action executed successfully`
-                : `✗ Action failed: ${actionResult.error}`;
-            setState(prev => ({
-                ...prev,
-                messages: prev.messages.map(msg => msg.id === pendingAction.messageId
-                    ? { ...msg, message: { ...msg.message, content: `${msg.message.content}\n\n${executionMessage}` } }
-                    : msg),
-            }));
-            // Clear pending action
-            setPendingAction(null);
-            // TODO: Implement continueAgent in API client if actions are needed
-            // For now, just show success message
-            const assistantMessage = {
-                id: generateMessageId(),
-                message: {
-                    type: 'ai',
-                    content: 'Action completed successfully.',
-                },
-                timestamp: new Date().toISOString(),
-                sources: [],
-            };
-            setState(prev => ({
-                ...prev,
-                messages: [...prev.messages, assistantMessage],
-                isLoading: false,
-                isTyping: false,
-            }));
-            onMessage?.(assistantMessage);
-        }
-        catch (error) {
-            const err = error instanceof Error ? error : new Error('Failed to execute action');
-            setState(prev => ({
-                ...prev,
-                isLoading: false,
-                isTyping: false,
-                error: err.message,
-                messages: prev.messages.map(msg => msg.id === pendingAction.messageId
-                    ? { ...msg, message: { ...msg.message, content: `${msg.message.content}\n\n✗ Failed to execute action` } }
-                    : msg),
-            }));
-            setPendingAction(null);
-            onError?.(err);
-        }
-    }, [pendingAction, state.conversationId, onMessage, onError]);
-    /**
-     * Reject pending action
-     */
-    const rejectAction = useCallback(() => {
-        if (!pendingAction)
-            return;
-        // Update message to show rejection
-        setState(prev => ({
-            ...prev,
-            messages: prev.messages.map(msg => msg.id === pendingAction.messageId
-                ? { ...msg, message: { ...msg.message, content: `${msg.message.content}\n\n✗ Action cancelled by user` } }
-                : msg),
-        }));
-        setPendingAction(null);
-    }, [pendingAction]);
     return {
         messages: state.messages,
         isLoading: state.isLoading,
@@ -691,10 +619,7 @@ function useChat(options) {
         error: state.error,
         config: state.config,
         conversationId: state.conversationId,
-        pendingAction,
         sendMessage,
-        approveAction,
-        rejectAction,
         clearMessages,
         submitFeedback,
     };
@@ -21609,7 +21534,7 @@ styleInject(css_248z);
 
 const ChatWidget = ({ widgetId, apiKey, apiUrl = window.location.origin, position = 'bottom-right', theme: themeOverride, primaryColor, onOpen, onClose, onMessage, onError, }) => {
     const [isOpen, setIsOpen] = useState(false);
-    const { messages, isLoading, isTyping, error, config, sendMessage, approveAction, rejectAction, submitFeedback, } = useChat({
+    const { messages, isLoading, isTyping, error, config, sendMessage, submitFeedback, } = useChat({
         widgetId,
         apiKey,
         apiUrl,
@@ -21659,11 +21584,11 @@ const ChatWidget = ({ widgetId, apiKey, apiUrl = window.location.origin, positio
     const handleFeedback = async (messageId, feedback) => {
         await submitFeedback(messageId, feedback);
     };
-    return (jsx("div", { className: `ai-chat-widget ${effectiveTheme}`, style: customStyles, children: jsx("div", { className: `ai-chat-widget-container ${effectivePosition}`, children: isOpen ? (jsx(ChatWindow, { messages: messages, isLoading: isLoading, isTyping: isTyping, error: error, config: config, onSendMessage: sendMessage, onApproveAction: approveAction, onRejectAction: rejectAction, onClose: handleToggle, onFeedback: handleFeedback })) : (jsx("button", { className: "ai-chat-button", onClick: handleToggle, "aria-label": "Open chat", style: {
+    return (jsx("div", { className: `ai-chat-widget ${effectiveTheme}`, style: customStyles, children: jsx("div", { className: `ai-chat-widget-container ${effectivePosition}`, children: isOpen ? (jsx(ChatWindow, { messages: messages, isLoading: isLoading, isTyping: isTyping, error: error, config: config, onSendMessage: sendMessage, onClose: handleToggle, onFeedback: handleFeedback })) : (jsx("button", { className: "ai-chat-button", onClick: handleToggle, "aria-label": "Open chat", style: {
                     width: config?.appearance.buttonSize || 60,
                     height: config?.appearance.buttonSize || 60,
                 }, children: config?.appearance.buttonIcon ? (jsx("span", { className: "ai-chat-button-icon", children: config.appearance.buttonIcon })) : (jsx("svg", { className: "ai-chat-button-svg", viewBox: "0 0 24 24", fill: "none", stroke: "currentColor", strokeWidth: "2", strokeLinecap: "round", strokeLinejoin: "round", children: jsx("path", { d: "M21 15a2 2 0 0 1-2 2H7l-4 4V5a2 2 0 0 1 2-2h14a2 2 0 0 1 2 2z" }) })) })) }) }));
 };
 
-export { ChatWidget, useChat };
+export { ApiError, ChatWidget, useChat };
 //# sourceMappingURL=index.esm.js.map