@aikaara/chat-sdk 0.1.4 → 0.2.0

package/README.md

@@ -0,0 +1,435 @@
+# @aikaara/chat-sdk
+
+Embeddable chat widget and headless client for the Aikaara AI agent platform.
+
+## Installation
+
+```bash
+npm install @aikaara/chat-sdk
+```
+
+## Three Entry Points
+
+| Import Path | Use Case |
+|-------------|----------|
+| `@aikaara/chat-sdk` | Full bundle: widget + headless + `mount()`/`unmount()` |
+| `@aikaara/chat-sdk/headless` | Headless only: no DOM dependency. For React Native, custom UI, server-side |
+| `@aikaara/chat-sdk/ui` | Web Components only |
+
+## Quick Start — Chat Widget (CDN)
+
+```html
+<script src="https://cdn.aikaara.com/chat-sdk/latest/aikaara-chat.iife.js"></script>
+<script>
+  AikaaraChat.mount({
+    baseUrl: 'https://api.aikaara.com',
+    userToken: 'ut_...',
+    title: 'Support',
+    primaryColor: '#6366f1',
+  });
+</script>
+```
+
+## Quick Start — Headless Client
+
+```typescript
+import { AikaaraChatClient } from '@aikaara/chat-sdk/headless';
+
+const client = new AikaaraChatClient({
+  baseUrl: 'https://api.aikaara.com',
+  userToken: 'ut_...',
+  apiKey: 'ak_...',
+});
+
+await client.connect();
+client.on('message:received', (msg) => console.log(msg.content));
+client.on('stream:update', ({ content }) => updateUI(content));
+
+await client.sendMessage('Hello!');
+```
+
+## Quick Start — Headless with JWT Auth (Dashboard / Internal Apps)
+
+```typescript
+import { AikaaraChatClient } from '@aikaara/chat-sdk/headless';
+
+const client = new AikaaraChatClient({
+  baseUrl: 'https://api.aikaara.com',
+  userToken: 'ut_...',
+  authToken: jwtToken, // Bearer token for REST calls
+  channel: 'sidekick',
+});
+
+await client.connect();
+```
+
+## App Context — Connecting the Agent to Your App
+
+The SDK doesn't know about your app's routes, pages, or entities. You provide that context at runtime via `setContext()`, and the agent uses it to navigate, edit forms, and stay aware of what the user is doing.
+
+### Why This Matters
+
+Without context, the agent doesn't know:
+- What page the user is on (`/products/42`? `/orders`?)
+- What routes exist in your app (so it can navigate)
+- What entity the user is viewing (so it can edit the right form)
+
+### Providing Context on Route Changes
+
+Call `setContext()` whenever the user navigates in your app:
+
+```typescript
+import { AikaaraChatClient } from '@aikaara/chat-sdk/headless';
+
+const client = new AikaaraChatClient({
+  baseUrl: 'https://api.aikaara.com',
+  userToken: 'ut_...',
+  authToken: jwt,
+  channel: 'sidekick',
+});
+
+await client.connect();
+
+// Call on every route change (e.g., in a React useEffect, Vue watch, etc.)
+client.setContext({
+  currentPage: '/products/42',
+  entityType: 'product',
+  entityId: '42',
+  availableRoutes: {
+    'Product list': '/products',
+    'Order list': '/orders',
+    'Customer list': '/customers',
+    'Settings': '/settings',
+    'Analytics': '/analytics',
+  },
+  custom: {
+    formFields: ['name', 'price', 'description', 'category'],
+    userName: 'Jane',
+  },
+});
+```
+
+### What Happens Under the Hood
+
+1. `setContext()` sends a PATCH to the backend, storing the context in conversation metadata
+2. The backend interpolates `{{current_page}}`, `{{available_routes}}`, and `{{custom_context}}` into the agent's system prompt
+3. The agent now knows your app's routes and can call `navigate_to` with them
+4. The agent knows the current entity and can call `edit_current_entity` for it
+
+### AppContext Interface
+
+```typescript
+interface AppContext {
+  /** Current page/route path in your app (e.g., '/products/42') */
+  currentPage: string;
+  /** Entity type on the current page (e.g., 'product', 'order') */
+  entityType?: string;
+  /** Entity ID on the current page */
+  entityId?: string | number;
+  /** Project/workspace ID if applicable */
+  projectId?: string | number;
+  /** Routes the agent can navigate to — map of label to path */
+  availableRoutes?: Record<string, string>;
+  /** Any additional context for the agent (form fields, user info, etc.) */
+  custom?: Record<string, unknown>;
+}
+```
+
+### Handling Navigation
+
+The agent doesn't control your router — it returns a path, and you handle it:
+
+```typescript
+client.on('action:navigate', ({ navigate_to }) => {
+  // Your router (React Router, Vue Router, Next.js, etc.)
+  router.push(navigate_to);
+});
+```
+
+The `navigate_to` value will be one of the paths from your `availableRoutes`, or a path the agent constructs from context (e.g., `/products/42`).
+
+### Framework Examples
+
+**React (with React Router)**
+
+```tsx
+import { useEffect } from 'react';
+import { useLocation, useNavigate } from 'react-router';
+
+function useSidekickContext(client: AikaaraChatClient) {
+  const location = useLocation();
+  const navigate = useNavigate();
+
+  // Update context on route change
+  useEffect(() => {
+    const match = location.pathname.match(/^\/(products|orders|customers)\/(\d+)/);
+    client.setContext({
+      currentPage: location.pathname,
+      entityType: match?.[1],
+      entityId: match?.[2],
+      availableRoutes: {
+        'Products': '/products',
+        'Orders': '/orders',
+        'Customers': '/customers',
+        'Analytics': '/analytics',
+      },
+    });
+  }, [location.pathname]);
+
+  // Handle navigation from agent
+  useEffect(() => {
+    const off = client.on('action:navigate', ({ navigate_to }) => {
+      navigate(navigate_to);
+    });
+    return off;
+  }, [navigate]);
+}
+```
+
+**Vue 3 (with Vue Router)**
+
+```typescript
+import { watch } from 'vue';
+import { useRoute, useRouter } from 'vue-router';
+
+function useSidekickContext(client: AikaaraChatClient) {
+  const route = useRoute();
+  const router = useRouter();
+
+  watch(() => route.fullPath, (path) => {
+    client.setContext({
+      currentPage: path,
+      entityType: route.params.type as string,
+      entityId: route.params.id as string,
+      availableRoutes: { Products: '/products', Orders: '/orders' },
+    });
+  }, { immediate: true });
+
+  client.on('action:navigate', ({ navigate_to }) => {
+    router.push(navigate_to);
+  });
+}
+```
+
+**Vanilla JS / Any Framework**
+
+```typescript
+// On route change (however your app detects it)
+window.addEventListener('popstate', () => {
+  client.setContext({ currentPage: window.location.pathname });
+});
+
+// On navigation action from agent
+client.on('action:navigate', ({ navigate_to }) => {
+  window.history.pushState(null, '', navigate_to);
+  // Trigger your app's route handler
+});
+```
+
+## FormBridge — AI-Driven Form Editing
+
+The `FormBridge` lets AI agents visually edit forms in your application. When the agent calls tools like `edit_current_entity`, the bridge pushes field updates to your registered form — the user sees changes live and can confirm or reject them.
+
+### How It Works
+
+1. Your agent has tools like `edit_current_entity`, `save_current_entity`, and `test_tool_by_id`
+2. When the agent calls these tools, the result flows through the WebSocket as a `tool_execution_end` event
+3. The SDK's `AikaaraChatClient` parses the result and emits typed action events
+4. `FormBridge` listens for these events and pushes updates to your registered form
+
+### Integration Steps
+
+#### 1. Import FormBridge from the SDK
+
+```typescript
+import { AikaaraChatClient, FormBridge } from '@aikaara/chat-sdk/headless';
+```
+
+#### 2. Pass it your AikaaraChatClient
+
+```typescript
+const client = new AikaaraChatClient({
+  baseUrl: 'https://api.aikaara.com',
+  userToken: 'ut_...',
+  authToken: jwtToken,
+  channel: 'sidekick',
+});
+
+const bridge = new FormBridge(client);
+await client.connect();
+```
+
+#### 3. Register your forms with `registerForm()`
+
+Call this when your form component mounts. Only one form can be active at a time (the current page).
+
+```typescript
+bridge.registerForm({
+  entityType: 'product',       // matches what the agent sends
+  entityId: 42,                // the entity being edited
+  onFieldUpdate: (fields) => {
+    // Update your form UI — fields is FieldUpdate[]
+    for (const { field, value } of fields) {
+      formState[field] = value;
+      rerenderField(field);    // your UI framework's update mechanism
+    }
+  },
+  onSave: async () => {
+    // Called when the agent triggers save_current_entity
+    await api.updateProduct(42, formState);
+  },
+  onTest: async (params) => {
+    // Optional: called when the agent triggers test_tool_by_id
+    await api.testProduct(42, params);
+  },
+  getCurrentValues: () => ({ ...formState }),
+});
+
+// Unregister when the form unmounts
+bridge.unregisterForm('product', 42);
+```
+
+#### 4. The bridge automatically handles tool results
+
+When the agent calls these backend tools, the bridge takes action automatically:
+
+| Agent Tool | Bridge Action |
+|-----------|---------------|
+| `edit_current_entity` | Calls `onFieldUpdate()` with the field changes |
+| `save_current_entity` | Calls `onSave()` on the registered form |
+| `test_tool_by_id` | Calls `onTest()` with parameters |
+
+If no form is registered when an `edit_current_entity` result arrives, the bridge queues it. When a matching form later registers, the queued edits are applied automatically.
+
+#### 5. Build your own confirmation UI using bridge events
+
+```typescript
+bridge.on('edit:applied', ({ entityType, entityId, fields }) => {
+  // Show a confirmation banner: "AI edited: name, description"
+  showBanner({
+    message: `AI edited: ${fields.map(f => f.field).join(', ')}`,
+    onConfirm: () => dismissBanner(),
+    onReject: () => {
+      // Revert fields using previousValue
+      revertFields(fields);
+      dismissBanner();
+    },
+    onSave: async () => {
+      await bridge.requestSave();
+      dismissBanner();
+    },
+  });
+});
+
+bridge.on('edit:pending', ({ entityType, entityId, fields }) => {
+  // Edits queued — no matching form registered yet
+  // Navigate the user to the right page, then the form will pick them up
+});
+
+bridge.on('save:success', () => toast.success('Saved by AI'));
+bridge.on('save:error', ({ error }) => toast.error(`Save failed: ${error}`));
+bridge.on('test:triggered', ({ toolId, parameters }) => {
+  // Show test UI if needed
+});
+```
+
+### Lower-Level: Action Events on AikaaraChatClient
+
+If you don't need `FormBridge` and want to handle actions yourself:
+
+```typescript
+client.on('action:edit_entity', (action) => {
+  // action: { entity_type, entity_id, fields: FieldUpdate[] }
+});
+
+client.on('action:save_entity', () => {
+  // Trigger save
+});
+
+client.on('action:navigate', ({ navigate_to }) => {
+  // Route change: e.g., router.push(navigate_to)
+});
+
+client.on('action:test_tool', ({ tool_id, parameters }) => {
+  // Run a tool test
+});
+
+// Raw tool lifecycle events
+client.on('tool:start', ({ toolName, args }) => showSpinner(toolName));
+client.on('tool:end', ({ toolName, result, isError }) => hideSpinner(toolName));
+```
+
+### React Hook Example
+
+```tsx
+import { useEffect, useRef } from 'react';
+import type { FormBridge, FieldUpdate } from '@aikaara/chat-sdk/headless';
+
+function useFormBridge(
+  bridge: FormBridge,
+  options: {
+    entityType: string;
+    entityId: string | number | undefined;
+    onFieldUpdate: (fields: FieldUpdate[]) => void;
+    onSave: () => Promise<void>;
+    onTest?: (params?: Record<string, unknown>) => Promise<void>;
+    getCurrentValues: () => Record<string, unknown>;
+  }
+) {
+  const refs = useRef(options);
+  refs.current = options;
+
+  useEffect(() => {
+    if (!options.entityId) return;
+    bridge.registerForm({
+      entityType: options.entityType,
+      entityId: options.entityId,
+      onFieldUpdate: (f) => refs.current.onFieldUpdate(f),
+      onSave: () => refs.current.onSave(),
+      onTest: refs.current.onTest ? (p) => refs.current.onTest!(p) : undefined,
+      getCurrentValues: () => refs.current.getCurrentValues(),
+    });
+    return () => bridge.unregisterForm(options.entityType, options.entityId!);
+  }, [bridge, options.entityType, options.entityId]);
+}
+```
+
+## Agent Events
+
+Events broadcast over ActionCable from the Aikaara Rails backend:
+
+| Event | Description |
+|-------|-------------|
+| `status` | Processing state (processing/completed) |
+| `message_start/update/end` | Streaming response lifecycle |
+| `message_queued` | User message acknowledged |
+| `tool_execution_start/update/end` | Tool call lifecycle |
+| `agent_start/end` | Agent session lifecycle |
+| `turn_start/end` | Conversation turn lifecycle |
+| `auto_retry_start/end` | Auto-retry on failure |
+| `cancelled` | Processing cancelled |
+
+## TypeScript Types
+
+All types are exported from `@aikaara/chat-sdk/headless`:
+
+```typescript
+import type {
+  // Connection
+  ConnectionConfig, ConnectionState, ChatClientConfig,
+  // Messages
+  Message, ToolCall, ToolCallResult,
+  // Events
+  AgentEvent, AgentEventType, ChatEvents,
+  // App Context
+  AppContext,
+  // Form Bridge
+  FieldUpdate, FormRegistration, FormBridgeEvents,
+  // Actions
+  EditEntityAction, SaveEntityAction, TestToolAction, NavigateAction, AgentAction,
+} from '@aikaara/chat-sdk/headless';
+```
+
+## License
+
+MIT

package/dist/{headless-BhsiNVQj.mjs → AikaaraChatClient-C4lWcRsS.mjs}

@@ -163,8 +163,8 @@ class m {
     this.handlers.clear();
   }
 }
-const f = 1e3, b = 10, y = 400, I = 600, k = "#6366f1", E = 12, T = "system-ui, -apple-system, sans-serif", C = "Type a message...", M = "bottom-right", A = "light", O = { x: 20, y: 20 }, d = "aikaara_conversation_id";
-class _ extends m {
+const f = 1e3, _ = 10, w = 400, k = 600, T = "#6366f1", I = 12, E = "system-ui, -apple-system, sans-serif", C = "Type a message...", A = "bottom-right", M = "light", O = { x: 20, y: 20 }, d = "aikaara_conversation_id";
+class b extends m {
   client;
   config;
   state = "disconnected";
@@ -220,7 +220,7 @@ class _ extends m {
     this.state !== t && (this.state = t, this.emit("connection:state", t));
   }
   scheduleReconnect() {
-    const t = this.config.maxReconnectAttempts ?? b;
+    const t = this.config.maxReconnectAttempts ?? _;
     if (this.reconnectAttempt >= t) {
       this.emit("error", new Error("Max reconnection attempts reached"));
       return;
@@ -246,12 +246,13 @@ class _ extends m {
     return `${t.replace(/^http/, "ws")}/cable?token=${e}`;
   }
 }
-class S {
+class y {
   baseUrl;
   apiKey;
+  authToken;
   userToken;
-  constructor(t, e, s) {
-    this.baseUrl = t, this.userToken = e, this.apiKey = s;
+  constructor(t, e, s, n) {
+    this.baseUrl = t, this.userToken = e, this.apiKey = s, this.authToken = n;
   }
   async createConversation(t) {
     const e = {
@@ -264,6 +265,10 @@ class S {
     };
     return this.request("POST", "/api/v1/conversations", e);
   }
+  async updateContext(t, e) {
+    const s = this.authToken ? `/dashboard/sidekick_conversations/${t}` : `/api/v1/conversations/${t}`;
+    await this.request("PATCH", s, e);
+  }
   async getMessages(t) {
     return (await this.request(
       "GET",
@@ -294,22 +299,22 @@ class S {
       "Content-Type": "application/json",
       Accept: "application/json"
     };
-    this.apiKey && (n["X-Api-Key"] = this.apiKey);
+    this.apiKey && (n["X-Api-Key"] = this.apiKey), this.authToken && (n.Authorization = `Bearer ${this.authToken}`);
     const i = `${this.baseUrl}${e}`, l = { method: t, headers: n };
     s && (l.body = JSON.stringify(s));
-    const c = await fetch(i, l);
-    if (!c.ok) {
-      const a = await c.text();
+    const a = await fetch(i, l);
+    if (!a.ok) {
+      const c = await a.text();
       let h;
       try {
-        const u = JSON.parse(a);
-        h = u.error || u.message || a;
+        const u = JSON.parse(c);
+        h = u.error || u.message || c;
       } catch {
-        h = a;
+        h = c;
       }
-      throw new Error(`API error ${c.status}: ${h}`);
+      throw new Error(`API error ${a.status}: ${h}`);
     }
-    const r = await c.json();
+    const r = await a.json();
     if (r && typeof r == "object" && "success" in r) {
       if (!r.success)
         throw new Error(`API error: ${r.message || "Request failed"}`);
@@ -375,7 +380,7 @@ class v {
     this._messages = [];
   }
 }
-class w {
+class S {
   _conversationId;
   persist;
   constructor(t, e = !0) {
@@ -417,7 +422,7 @@ class U extends m {
   subscription = null;
   config;
   constructor(t) {
-    super(), this.config = t, this.connection = new _(t), this.api = new S(t.baseUrl, t.userToken, t.apiKey), this.messageStore = new v(), this.conversationManager = new w(t.conversationId), this.connection.on("connection:state", (e) => {
+    super(), this.config = t, this.connection = new b(t), this.api = new y(t.baseUrl, t.userToken, t.apiKey, t.authToken), this.messageStore = new v(), this.conversationManager = new S(t.conversationId), this.connection.on("connection:state", (e) => {
       this.emit("connection:state", e), this.config.onConnectionStateChange?.(e);
     }), this.connection.on("error", (e) => {
       this.emit("error", e), this.config.onError?.(e);
@@ -470,9 +475,51 @@ class U extends m {
   get isConnected() {
     return this.connection.connectionState === "connected";
   }
+  /**
+   * Update the agent's context with information about the host app's current state.
+   * Call this on route changes so the agent knows what page/entity the user is viewing.
+   *
+   * The context is stored in conversation metadata and interpolated into the system prompt.
+   *
+   * @example
+   * ```typescript
+   * // On route change
+   * client.setContext({
+   *   currentPage: '/products/42',
+   *   entityType: 'product',
+   *   entityId: '42',
+   *   availableRoutes: { products: '/products', orders: '/orders' },
+   * });
+   * ```
+   */
+  async setContext(t) {
+    const e = this.conversationManager.conversationId;
+    e && await this.api.updateContext(e, {
+      current_page: t.currentPage,
+      entity_type: t.entityType,
+      entity_id: t.entityId,
+      project_id: t.projectId,
+      available_routes: t.availableRoutes,
+      custom_context: t.custom
+    });
+  }
   async disconnect() {
     this.subscription && (this.subscription = null), await this.connection.disconnect();
   }
+  /**
+   * Parse structured action results from tool execution output.
+   * When the agent calls tools like `edit_current_entity`, `save_current_entity`,
+   * `navigate_to`, or `test_tool_by_id`, the result contains an action payload
+   * that the SDK emits as a typed event for the host app to handle.
+   */
+  parseActionResult(t) {
+    try {
+      const e = typeof t == "string" ? JSON.parse(t) : t;
+      if (!e || typeof e != "object") return;
+      e.navigate_to ? this.emit("action:navigate", e) : e.action === "edit_entity" ? this.emit("action:edit_entity", e) : e.action === "save_entity" ? this.emit("action:save_entity", e) : e.action === "test_tool" && this.emit("action:test_tool", e);
+    } catch {
+    }
+  }
   handleBroadcast(t) {
     const e = this.conversationManager.conversationId;
     switch (t.type) {
@@ -515,9 +562,22 @@ class U extends m {
         s && this.messageStore.confirmOptimistic(s.id);
         break;
       }
-      case "tool_execution_start":
+      case "tool_execution_start": {
+        this.emit("tool:start", {
+          toolName: t.tool_name || "",
+          args: t.args || {}
+        }), this.emit("status", t.type);
+        break;
+      }
+      case "tool_execution_end": {
+        this.emit("tool:end", {
+          toolName: t.tool_name || "",
+          result: t.result,
+          isError: !!t.is_error
+        }), this.emit("status", t.type), this.parseActionResult(t.result);
+        break;
+      }
       case "tool_execution_update":
-      case "tool_execution_end":
       case "agent_start":
       case "agent_end":
       case "turn_start":
@@ -537,15 +597,15 @@ export {
   m as E,
   v as M,
   U as a,
-  S as b,
-  _ as c,
-  w as d,
+  y as b,
+  b as c,
+  S as d,
   C as e,
-  E as f,
-  T as g,
-  I as h,
-  y as i,
-  M as j,
-  k,
-  A as l
+  I as f,
+  E as g,
+  k as h,
+  w as i,
+  A as j,
+  T as k,
+  M as l
 };

package/dist/AikaaraChatClient-ChZ2bL9f.cjs

@@ -0,0 +1 @@
+"use strict";class p{identifier;callbacks={};sendFn;constructor(t,e){this.identifier=t,this.sendFn=e}onReceived(t){return this.callbacks.received=t,this}onConnected(t){return this.callbacks.connected=t,this}onDisconnected(t){return this.callbacks.disconnected=t,this}onRejected(t){return this.callbacks.rejected=t,this}perform(t,e={}){this.sendFn({action:t,...e})}_notifyReceived(t){this.callbacks.received?.(t)}_notifyConnected(){this.callbacks.connected?.()}_notifyDisconnected(){this.callbacks.disconnected?.()}_notifyRejected(){this.callbacks.rejected?.()}}class l{ws=null;url;subscriptions=new Map;welcomePromise=null;pendingSubscriptions=new Map;constructor(t){this.url=t}connect(){return new Promise((t,e)=>{this.welcomePromise={resolve:t,reject:e},this.ws=new WebSocket(this.url),this.ws.onopen=()=>{},this.ws.onmessage=s=>{this.handleMessage(s)},this.ws.onerror=()=>{const s=new Error("WebSocket connection error");this.welcomePromise?.reject(s),this.welcomePromise=null},this.ws.onclose=()=>{this.subscriptions.forEach(s=>s._notifyDisconnected())}})}disconnect(){this.ws&&(this.ws.onclose=null,this.ws.close(),this.ws=null),this.subscriptions.forEach(t=>t._notifyDisconnected()),this.subscriptions.clear()}subscribe(t){const e=JSON.stringify(t),s=new p(e,n=>{this.send({command:"message",identifier:e,data:JSON.stringify(n)})});return this.subscriptions.set(e,s),this.send({command:"subscribe",identifier:e}),s}subscribeAsync(t){const e=this.subscribe(t),s=e.identifier;return new Promise((n,i)=>{this.pendingSubscriptions.set(s,{resolve:()=>n(e),reject:i}),setTimeout(()=>{this.pendingSubscriptions.has(s)&&(this.pendingSubscriptions.delete(s),i(new Error(`Subscription timeout for ${s}`)))},1e4)})}unsubscribe(t){this.send({command:"unsubscribe",identifier:t}),this.subscriptions.delete(t)}perform(t,e,s={}){this.send({command:"message",identifier:t,data:JSON.stringify({action:e,...s})})}get isConnected(){return this.ws?.readyState===WebSocket.OPEN}send(t){this.ws?.readyState===WebSocket.OPEN&&this.ws.send(JSON.stringify(t))}handleMessage(t){let e;try{e=JSON.parse(t.data)}catch{return}switch(e.type){case"welcome":this.welcomePromise?.resolve(),this.welcomePromise=null;break;case"ping":break;case"confirm_subscription":{const s=e.identifier;this.subscriptions.get(s)?._notifyConnected();const i=this.pendingSubscriptions.get(s);i&&(i.resolve(),this.pendingSubscriptions.delete(s));break}case"reject_subscription":{const s=e.identifier;this.subscriptions.get(s)?._notifyRejected(),this.subscriptions.delete(s);const i=this.pendingSubscriptions.get(s);i&&(i.reject(new Error(`Subscription rejected: ${s}`)),this.pendingSubscriptions.delete(s));break}case"disconnect":this.subscriptions.forEach(s=>s._notifyDisconnected());break;default:{e.identifier&&e.message!==void 0&&this.subscriptions.get(e.identifier)?._notifyReceived(e.message);break}}}}class u{handlers=new Map;on(t,e){return this.handlers.has(t)||this.handlers.set(t,new Set),this.handlers.get(t).add(e),()=>this.off(t,e)}off(t,e){this.handlers.get(t)?.delete(e)}emit(t,e){this.handlers.get(t)?.forEach(s=>{try{s(e)}catch(n){console.error(`Error in event handler for "${t}":`,n)}})}removeAllListeners(){this.handlers.clear()}}const y=1e3,S=10,w=400,T=600,E="#6366f1",I=12,k="system-ui, -apple-system, sans-serif",A="Type a message...",C="bottom-right",M="light",O={x:20,y:20},d="aikaara_conversation_id";class f extends u{client;config;state="disconnected";reconnectAttempt=0;reconnectTimer=null;constructor(t){super(),this.config=t;const e=this.buildWsUrl(t.baseUrl,t.userToken);this.client=new l(e)}async connect(){this.setState("connecting");try{await this.client.connect(),this.setState("connected"),this.reconnectAttempt=0}catch(t){if(this.setState("disconnected"),this.config.reconnect!==!1)this.scheduleReconnect();else throw t}}async disconnect(){this.clearReconnectTimer(),this.client.disconnect(),this.setState("disconnected")}subscribeToConversation(t){return this.client.subscribeAsync({channel:"ConversationChannel",conversation_id:t})}sendMessage(t,e){const s=JSON.stringify({channel:"ConversationChannel",conversation_id:t});this.client.perform(s,"send_message",{content:e})}sendUserEvent(t,e,s,n){const i=JSON.stringify({channel:"ConversationChannel",conversation_id:t});this.client.perform(i,"send_user_event",{event_key:e,...s&&{value:s},...n&&{source:n}})}get connectionState(){return this.state}setState(t){this.state!==t&&(this.state=t,this.emit("connection:state",t))}scheduleReconnect(){const t=this.config.maxReconnectAttempts??S;if(this.reconnectAttempt>=t){this.emit("error",new Error("Max reconnection attempts reached"));return}this.setState("reconnecting");const s=(this.config.reconnectInterval??y)*Math.pow(2,this.reconnectAttempt);this.reconnectAttempt++,this.reconnectTimer=setTimeout(async()=>{try{const n=this.buildWsUrl(this.config.baseUrl,this.config.userToken);this.client=new l(n),await this.connect()}catch{}},s)}clearReconnectTimer(){this.reconnectTimer&&(clearTimeout(this.reconnectTimer),this.reconnectTimer=null)}buildWsUrl(t,e){if(this.config.wsUrl){const n=this.config.wsUrl.includes("?")?"&":"?";return`${this.config.wsUrl}${n}token=${e}`}return`${t.replace(/^http/,"ws")}/cable?token=${e}`}}class _{baseUrl;apiKey;authToken;userToken;constructor(t,e,s,n){this.baseUrl=t,this.userToken=e,this.apiKey=s,this.authToken=n}async createConversation(t){const e={conversation:{...t.extUid&&{ext_uid:t.extUid},...t.systemPromptId&&{system_prompt_id:t.systemPromptId},...t.channel&&{channel:t.channel},...t.title&&{title:t.title}}};return this.request("POST","/api/v1/conversations",e)}async updateContext(t,e){const s=this.authToken?`/dashboard/sidekick_conversations/${t}`:`/api/v1/conversations/${t}`;await this.request("PATCH",s,e)}async getMessages(t){return(await this.request("GET",`/api/v1/conversations/${t}/messages`)).map(this.mapMessage)}mapMessage(t){return{id:String(t.id),conversationId:String(t.conversation_id),role:t.role,content:t.content||"",toolCalls:t.tool_calls?.map(e=>({id:e.id,type:e.type,function:e.function})),toolCallResults:t.tool_call_results,tokensInput:t.tokens_input,tokensOutput:t.tokens_output,metadata:t.metadata,createdAt:t.created_at,status:"complete"}}async request(t,e,s){const n={"Content-Type":"application/json",Accept:"application/json"};this.apiKey&&(n["X-Api-Key"]=this.apiKey),this.authToken&&(n.Authorization=`Bearer ${this.authToken}`);const i=`${this.baseUrl}${e}`,g={method:t,headers:n};s&&(g.body=JSON.stringify(s));const a=await fetch(i,g);if(!a.ok){const c=await a.text();let h;try{const m=JSON.parse(c);h=m.error||m.message||c}catch{h=c}throw new Error(`API error ${a.status}: ${h}`)}const r=await a.json();if(r&&typeof r=="object"&&"success"in r){if(!r.success)throw new Error(`API error: ${r.message||"Request failed"}`);return r.data}return r}}class b{_messages=[];optimisticCounter=0;get messages(){return[...this._messages]}addOptimistic(t,e,s){const n={id:`optimistic_${++this.optimisticCounter}`,conversationId:s,role:t,content:e,createdAt:new Date().toISOString(),status:"sending"};return this._messages.push(n),n}confirmOptimistic(t){const e=this._messages.find(s=>s.id===t);e&&(e.status="sent")}addStreamingMessage(t){const e={id:`streaming_${Date.now()}`,conversationId:t,role:"assistant",content:"",createdAt:new Date().toISOString(),status:"streaming"};return this._messages.push(e),e}updateStreaming(t){const e=this._messages.findLast(s=>s.status==="streaming");e&&(e.content=t)}appendToStreaming(t){const e=this._messages.findLast(s=>s.status==="streaming");e&&(e.content+=t)}get streamingContent(){return this._messages.findLast(e=>e.status==="streaming")?.content||""}finalizeStreaming(t){const e=this._messages.findLast(s=>s.status==="streaming");return e&&(e.status="complete",t&&(e.tokensInput=t.tokensInput,e.tokensOutput=t.tokensOutput)),e}addMessage(t){this._messages.push(t)}setMessages(t){this._messages=[...t]}clear(){this._messages=[]}}class v{_conversationId;persist;constructor(t,e=!0){this.persist=e,this._conversationId=t||this.loadFromStorage()}get conversationId(){return this._conversationId}set conversationId(t){this._conversationId=t,this.persist&&t&&this.saveToStorage(t)}clear(){if(this._conversationId=null,this.persist)try{localStorage.removeItem(d)}catch{}}loadFromStorage(){if(!this.persist)return null;try{return localStorage.getItem(d)}catch{return null}}saveToStorage(t){try{localStorage.setItem(d,t)}catch{}}}class U extends u{connection;api;messageStore;conversationManager;subscription=null;config;constructor(t){super(),this.config=t,this.connection=new f(t),this.api=new _(t.baseUrl,t.userToken,t.apiKey,t.authToken),this.messageStore=new b,this.conversationManager=new v(t.conversationId),this.connection.on("connection:state",e=>{this.emit("connection:state",e),this.config.onConnectionStateChange?.(e)}),this.connection.on("error",e=>{this.emit("error",e),this.config.onError?.(e)})}async connect(){if(await this.connection.connect(),!this.conversationManager.conversationId){const t=await this.api.createConversation({systemPromptId:this.config.systemPromptId,channel:this.config.channel||"widget",extUid:this.config.extUid});this.conversationManager.conversationId=String(t.id)}this.subscription=await this.connection.subscribeToConversation(this.conversationManager.conversationId),this.subscription.onReceived(t=>{this.handleBroadcast(t)}),await this.loadHistory()}async sendMessage(t){const e=this.conversationManager.conversationId;if(!e)throw new Error("No active conversation");const s=this.messageStore.addOptimistic("user",t,e);this.emit("message:sent",s),this.config.onMessage?.(s),this.connection.sendMessage(e,t)}async sendUserEvent(t,e,s){const n=this.conversationManager.conversationId;if(!n)throw new Error("No active conversation");this.connection.sendUserEvent(n,t,e,s)}async loadHistory(){const t=this.conversationManager.conversationId;if(!t)return[];try{const e=await this.api.getMessages(t);return this.messageStore.setMessages(e),e}catch{return[]}}get messages(){return this.messageStore.messages}get conversationId(){return this.conversationManager.conversationId}get isConnected(){return this.connection.connectionState==="connected"}async setContext(t){const e=this.conversationManager.conversationId;e&&await this.api.updateContext(e,{current_page:t.currentPage,entity_type:t.entityType,entity_id:t.entityId,project_id:t.projectId,available_routes:t.availableRoutes,custom_context:t.custom})}async disconnect(){this.subscription&&(this.subscription=null),await this.connection.disconnect()}parseActionResult(t){try{const e=typeof t=="string"?JSON.parse(t):t;if(!e||typeof e!="object")return;e.navigate_to?this.emit("action:navigate",e):e.action==="edit_entity"?this.emit("action:edit_entity",e):e.action==="save_entity"?this.emit("action:save_entity",e):e.action==="test_tool"&&this.emit("action:test_tool",e)}catch{}}handleBroadcast(t){const e=this.conversationManager.conversationId;switch(t.type){case"status":{const s=t.status;this.emit("status",s),this.config.onStatusChange?.(s),s==="processing"&&this.emit("typing:start",void 0);break}case"error":{const s=new Error(t.message||"Unknown error");this.emit("error",s),this.config.onError?.(s);break}case"message_start":{if(t.role==="assistant"){const s=this.messageStore.addStreamingMessage(e);this.emit("stream:start",{messageId:s.id}),this.emit("typing:start",void 0)}break}case"message_update":{const s=t.delta||"",n=t.content||"";n?this.messageStore.updateStreaming(n):s&&this.messageStore.appendToStreaming(s);const i=this.messageStore.streamingContent;this.emit("stream:update",{delta:s,content:i}),this.config.onStreamUpdate?.(s,i);break}case"message_end":{const s=t.usage,n=this.messageStore.finalizeStreaming(s?{tokensInput:s.tokens_input||0,tokensOutput:s.tokens_output||0}:void 0);this.emit("typing:stop",void 0),n&&(this.emit("stream:end",{messageId:n.id,usage:s?{tokensInput:s.tokens_input||0,tokensOutput:s.tokens_output||0}:void 0}),this.emit("message:received",n),this.config.onMessage?.(n));break}case"message_queued":{const s=this.messageStore.messages.findLast(n=>n.status==="sending");s&&this.messageStore.confirmOptimistic(s.id);break}case"tool_execution_start":{this.emit("tool:start",{toolName:t.tool_name||"",args:t.args||{}}),this.emit("status",t.type);break}case"tool_execution_end":{this.emit("tool:end",{toolName:t.tool_name||"",result:t.result,isError:!!t.is_error}),this.emit("status",t.type),this.parseActionResult(t.result);break}case"tool_execution_update":case"agent_start":case"agent_end":case"turn_start":case"turn_end":case"auto_retry_start":case"auto_retry_end":case"cancelled":this.emit("status",t.type);break}}}exports.ActionCableClient=l;exports.AikaaraChatClient=U;exports.ApiClient=_;exports.ChannelSubscription=p;exports.ConnectionManager=f;exports.ConversationManager=v;exports.DEFAULT_BORDER_RADIUS=I;exports.DEFAULT_FONT_FAMILY=k;exports.DEFAULT_OFFSET=O;exports.DEFAULT_PLACEHOLDER=A;exports.DEFAULT_POSITION=C;exports.DEFAULT_PRIMARY_COLOR=E;exports.DEFAULT_THEME=M;exports.DEFAULT_WIDGET_HEIGHT=T;exports.DEFAULT_WIDGET_WIDTH=w;exports.EventEmitter=u;exports.MessageStore=b;