@aikaara/chat-sdk 0.1.0

package/dist/headless.d.ts

@@ -0,0 +1,243 @@
+export declare class ActionCableClient {
+    private ws;
+    private url;
+    private subscriptions;
+    private welcomePromise;
+    private pendingSubscriptions;
+    constructor(url: string);
+    connect(): Promise<void>;
+    disconnect(): void;
+    subscribe(identifier: Record<string, unknown>): ChannelSubscription;
+    subscribeAsync(identifier: Record<string, unknown>): Promise<ChannelSubscription>;
+    unsubscribe(identifierStr: string): void;
+    perform(identifierStr: string, action: string, data?: Record<string, unknown>): void;
+    get isConnected(): boolean;
+    private send;
+    private handleMessage;
+}
+
+export declare interface ActionCableMessage {
+    type?: 'welcome' | 'ping' | 'confirm_subscription' | 'reject_subscription' | 'disconnect';
+    identifier?: string;
+    message?: unknown;
+}
+
+export declare interface AgentEvent {
+    type: AgentEventType;
+    [key: string]: unknown;
+}
+
+export declare type AgentEventType = 'status' | 'error' | 'agent_start' | 'agent_end' | 'turn_start' | 'turn_end' | 'message_start' | 'message_update' | 'message_end' | 'tool_execution_start' | 'tool_execution_update' | 'tool_execution_end' | 'auto_retry_start' | 'auto_retry_end' | 'cancelled' | 'message_queued';
+
+export declare class AikaaraChatClient extends EventEmitter<ChatEvents> {
+    private connection;
+    private api;
+    private messageStore;
+    private conversationManager;
+    private subscription;
+    private config;
+    constructor(config: ChatClientConfig);
+    connect(): Promise<void>;
+    sendMessage(content: string): Promise<void>;
+    sendUserEvent(eventKey: string, value?: object, source?: string): Promise<void>;
+    loadHistory(): Promise<Message[]>;
+    get messages(): Message[];
+    get conversationId(): string | null;
+    get isConnected(): boolean;
+    disconnect(): Promise<void>;
+    private handleBroadcast;
+}
+
+export declare class ApiClient {
+    private baseUrl;
+    private apiKey?;
+    private userToken;
+    constructor(baseUrl: string, userToken: string, apiKey?: string);
+    createConversation(params: {
+        systemPromptId?: number;
+        channel?: string;
+        title?: string;
+    }): Promise<CreateConversationResponse>;
+    getMessages(conversationId: string): Promise<Message[]>;
+    private mapMessage;
+    private request;
+}
+
+export declare class ChannelSubscription {
+    readonly identifier: string;
+    private callbacks;
+    private sendFn;
+    constructor(identifier: string, sendFn: (data: Record<string, unknown>) => void);
+    onReceived(callback: SubscriptionCallback): this;
+    onConnected(callback: () => void): this;
+    onDisconnected(callback: () => void): this;
+    onRejected(callback: () => void): this;
+    perform(action: string, data?: Record<string, unknown>): void;
+    /* Excluded from this release type: _notifyReceived */
+    /* Excluded from this release type: _notifyConnected */
+    /* Excluded from this release type: _notifyDisconnected */
+    /* Excluded from this release type: _notifyRejected */
+}
+
+export declare interface ChatClientConfig extends ConnectionConfig {
+    apiKey?: string;
+    conversationId?: string;
+    systemPromptId?: number;
+    channel?: 'widget' | 'api';
+    onMessage?: (message: Message) => void;
+    onStatusChange?: (status: string) => void;
+    onError?: (error: Error) => void;
+    onStreamUpdate?: (delta: string, fullContent: string) => void;
+    onConnectionStateChange?: (state: ConnectionState) => void;
+}
+
+export declare interface ChatEvents {
+    'connection:state': ConnectionState;
+    'message:received': Message;
+    'message:updated': Message;
+    'message:sent': Message;
+    'stream:start': {
+        messageId: string;
+    };
+    'stream:update': {
+        delta: string;
+        content: string;
+    };
+    'stream:end': {
+        messageId: string;
+        usage?: {
+            tokensInput: number;
+            tokensOutput: number;
+        };
+    };
+    'typing:start': void;
+    'typing:stop': void;
+    'error': Error;
+    'status': string;
+}
+
+export declare interface ConnectionConfig {
+    baseUrl: string;
+    userToken: string;
+    reconnect?: boolean;
+    maxReconnectAttempts?: number;
+    reconnectInterval?: number;
+}
+
+export declare class ConnectionManager extends EventEmitter<ChatEvents> {
+    private client;
+    private config;
+    private state;
+    private reconnectAttempt;
+    private reconnectTimer;
+    constructor(config: ConnectionConfig);
+    connect(): Promise<void>;
+    disconnect(): Promise<void>;
+    subscribeToConversation(conversationId: string | number): Promise<ChannelSubscription>;
+    sendMessage(conversationId: string | number, content: string): void;
+    sendUserEvent(conversationId: string | number, eventKey: string, value?: object, source?: string): void;
+    get connectionState(): ConnectionState;
+    private setState;
+    private scheduleReconnect;
+    private clearReconnectTimer;
+    private buildWsUrl;
+}
+
+export declare type ConnectionState = 'disconnected' | 'connecting' | 'connected' | 'reconnecting';
+
+export declare class ConversationManager {
+    private _conversationId;
+    private persist;
+    constructor(conversationId?: string, persist?: boolean);
+    get conversationId(): string | null;
+    set conversationId(id: string | null);
+    clear(): void;
+    private loadFromStorage;
+    private saveToStorage;
+}
+
+declare interface CreateConversationResponse {
+    id: string;
+    status: string;
+}
+
+export declare class EventEmitter<Events extends Record<string, any>> {
+    private handlers;
+    on<K extends keyof Events & string>(event: K, handler: (data: Events[K]) => void): () => void;
+    off<K extends keyof Events & string>(event: K, handler: (data: Events[K]) => void): void;
+    emit<K extends keyof Events & string>(event: K, data: Events[K]): void;
+    removeAllListeners(): void;
+}
+
+export declare interface Message {
+    id: string;
+    conversationId: string;
+    role: 'user' | 'assistant' | 'system' | 'tool';
+    content: string;
+    toolCalls?: ToolCall[];
+    toolCallResults?: ToolCallResult;
+    tokensInput?: number;
+    tokensOutput?: number;
+    metadata?: Record<string, unknown>;
+    createdAt: string;
+    status?: 'sending' | 'sent' | 'streaming' | 'complete' | 'error';
+}
+
+export declare class MessageStore {
+    private _messages;
+    private optimisticCounter;
+    get messages(): Message[];
+    addOptimistic(role: 'user', content: string, conversationId: string): Message;
+    confirmOptimistic(tempId: string): void;
+    addStreamingMessage(conversationId: string): Message;
+    updateStreaming(content: string): void;
+    finalizeStreaming(usage?: {
+        tokensInput: number;
+        tokensOutput: number;
+    }): Message | undefined;
+    addMessage(message: Message): void;
+    setMessages(messages: Message[]): void;
+    clear(): void;
+}
+
+declare type SubscriptionCallback = (data: unknown) => void;
+
+export declare interface ToolCall {
+    id: string;
+    type: 'function';
+    function: {
+        name: string;
+        arguments: string;
+    };
+}
+
+export declare interface ToolCallResult {
+    tool_call_id: string;
+    content: string;
+}
+
+export declare interface WidgetConfig extends ChatClientConfig {
+    position?: 'bottom-right' | 'bottom-left';
+    offset?: {
+        x: number;
+        y: number;
+    };
+    width?: number;
+    height?: number;
+    theme?: 'light' | 'dark' | 'auto';
+    primaryColor?: string;
+    fontFamily?: string;
+    borderRadius?: number;
+    title?: string;
+    subtitle?: string;
+    avatarUrl?: string;
+    welcomeMessage?: string;
+    placeholder?: string;
+    showTimestamps?: boolean;
+    persistConversation?: boolean;
+    showBubble?: boolean;
+    bubbleText?: string;
+    bubbleIcon?: string;
+}
+
+export { }

package/dist/headless.mjs

@@ -0,0 +1,11 @@
+import { A as n, a as t, b as s, C as i, c as o, d as r, E as C, M as l } from "./headless-DzI-CcOZ.mjs";
+export {
+  n as ActionCableClient,
+  t as AikaaraChatClient,
+  s as ApiClient,
+  i as ChannelSubscription,
+  o as ConnectionManager,
+  r as ConversationManager,
+  C as EventEmitter,
+  l as MessageStore
+};

package/dist/index.cjs

@@ -0,0 +1 @@
+"use strict";Object.defineProperty(exports,Symbol.toStringTag,{value:"Module"});const e=require("./headless-CjIUiswe.cjs"),a=require("./ui.cjs");function l(t){a.registerComponents();const r=document.createElement("aikaara-chat-widget"),n={baseUrl:"base-url",userToken:"user-token",apiKey:"api-key",title:"title",subtitle:"subtitle",theme:"theme",primaryColor:"primary-color",position:"position",width:"width",height:"height",placeholder:"placeholder",welcomeMessage:"welcome-message",avatarUrl:"avatar-url"};for(const[o,s]of Object.entries(n)){const i=t[o];i!=null&&r.setAttribute(s,String(i))}return r.configure(t),document.body.appendChild(r),r}function u(){const t=document.querySelector("aikaara-chat-widget");t&&t.remove()}exports.ActionCableClient=e.ActionCableClient;exports.AikaaraChatClient=e.AikaaraChatClient;exports.ApiClient=e.ApiClient;exports.ChannelSubscription=e.ChannelSubscription;exports.ConnectionManager=e.ConnectionManager;exports.ConversationManager=e.ConversationManager;exports.EventEmitter=e.EventEmitter;exports.MessageStore=e.MessageStore;exports.AikaaraChatBubble=a.AikaaraChatBubble;exports.AikaaraChatHeader=a.AikaaraChatHeader;exports.AikaaraChatInput=a.AikaaraChatInput;exports.AikaaraChatWidget=a.AikaaraChatWidget;exports.AikaaraErrorBanner=a.AikaaraErrorBanner;exports.AikaaraMessageBubble=a.AikaaraMessageBubble;exports.AikaaraMessageList=a.AikaaraMessageList;exports.AikaaraStreamingMessage=a.AikaaraStreamingMessage;exports.AikaaraTypingIndicator=a.AikaaraTypingIndicator;exports.registerComponents=a.registerComponents;exports.mount=l;exports.unmount=u;

package/dist/index.d.ts

@@ -0,0 +1,354 @@
+export declare class ActionCableClient {
+    private ws;
+    private url;
+    private subscriptions;
+    private welcomePromise;
+    private pendingSubscriptions;
+    constructor(url: string);
+    connect(): Promise<void>;
+    disconnect(): void;
+    subscribe(identifier: Record<string, unknown>): ChannelSubscription;
+    subscribeAsync(identifier: Record<string, unknown>): Promise<ChannelSubscription>;
+    unsubscribe(identifierStr: string): void;
+    perform(identifierStr: string, action: string, data?: Record<string, unknown>): void;
+    get isConnected(): boolean;
+    private send;
+    private handleMessage;
+}
+
+export declare interface ActionCableMessage {
+    type?: 'welcome' | 'ping' | 'confirm_subscription' | 'reject_subscription' | 'disconnect';
+    identifier?: string;
+    message?: unknown;
+}
+
+export declare interface AgentEvent {
+    type: AgentEventType;
+    [key: string]: unknown;
+}
+
+export declare type AgentEventType = 'status' | 'error' | 'agent_start' | 'agent_end' | 'turn_start' | 'turn_end' | 'message_start' | 'message_update' | 'message_end' | 'tool_execution_start' | 'tool_execution_update' | 'tool_execution_end' | 'auto_retry_start' | 'auto_retry_end' | 'cancelled' | 'message_queued';
+
+export declare class AikaaraChatBubble extends HTMLElement {
+    private shadow;
+    constructor();
+    connectedCallback(): void;
+    private render;
+    setIcon(svgOrText: string): void;
+}
+
+export declare class AikaaraChatClient extends EventEmitter<ChatEvents> {
+    private connection;
+    private api;
+    private messageStore;
+    private conversationManager;
+    private subscription;
+    private config;
+    constructor(config: ChatClientConfig);
+    connect(): Promise<void>;
+    sendMessage(content: string): Promise<void>;
+    sendUserEvent(eventKey: string, value?: object, source?: string): Promise<void>;
+    loadHistory(): Promise<Message[]>;
+    get messages(): Message[];
+    get conversationId(): string | null;
+    get isConnected(): boolean;
+    disconnect(): Promise<void>;
+    private handleBroadcast;
+}
+
+export declare class AikaaraChatHeader extends HTMLElement {
+    private shadow;
+    static get observedAttributes(): string[];
+    constructor();
+    connectedCallback(): void;
+    attributeChangedCallback(): void;
+    private render;
+    setStatus(status: string): void;
+}
+
+export declare class AikaaraChatInput extends HTMLElement {
+    private shadow;
+    private textarea;
+    private sendBtn;
+    private _disabled;
+    constructor();
+    connectedCallback(): void;
+    set disabled(val: boolean);
+    get disabled(): boolean;
+    focus(): void;
+    clear(): void;
+    private handleSend;
+    private autoGrow;
+}
+
+export declare class AikaaraChatWidget extends HTMLElement {
+    private shadow;
+    private controller;
+    private _config;
+    static get observedAttributes(): string[];
+    constructor();
+    connectedCallback(): void;
+    disconnectedCallback(): void;
+    attributeChangedCallback(_name: string, oldVal: string, newVal: string): void;
+    configure(config: Partial<WidgetConfig>): void;
+    private getConfig;
+    private render;
+    private initController;
+    private darkenColor;
+}
+
+export declare class AikaaraErrorBanner extends HTMLElement {
+    private shadow;
+    private container;
+    private dismissTimer;
+    constructor();
+    connectedCallback(): void;
+    show(message: string, autoDismissMs?: number): void;
+    hide(): void;
+}
+
+export declare class AikaaraMessageBubble extends HTMLElement {
+    private shadow;
+    static get observedAttributes(): string[];
+    constructor();
+    connectedCallback(): void;
+    attributeChangedCallback(): void;
+    private render;
+}
+
+export declare class AikaaraMessageList extends HTMLElement {
+    private shadow;
+    private container;
+    private welcomeMessage;
+    private showTimestamps;
+    constructor();
+    connectedCallback(): void;
+    setWelcomeMessage(message: string): void;
+    setShowTimestamps(show: boolean): void;
+    renderMessages(messages: Message[]): void;
+    addMessage(message: Message): void;
+    updateStreamingContent(content: string): void;
+    finalizeStreaming(): void;
+    showTypingIndicator(): void;
+    removeTypingIndicator(): void;
+    private appendMessageElement;
+    private scrollToBottom;
+    private formatTime;
+}
+
+export declare class AikaaraStreamingMessage extends HTMLElement {
+    private shadow;
+    private bubble;
+    constructor();
+    connectedCallback(): void;
+    updateContent(content: string): void;
+    finalize(): void;
+}
+
+export declare class AikaaraTypingIndicator extends HTMLElement {
+    private shadow;
+    constructor();
+    connectedCallback(): void;
+    show(): void;
+    hide(): void;
+}
+
+export declare class ApiClient {
+    private baseUrl;
+    private apiKey?;
+    private userToken;
+    constructor(baseUrl: string, userToken: string, apiKey?: string);
+    createConversation(params: {
+        systemPromptId?: number;
+        channel?: string;
+        title?: string;
+    }): Promise<CreateConversationResponse>;
+    getMessages(conversationId: string): Promise<Message[]>;
+    private mapMessage;
+    private request;
+}
+
+export declare class ChannelSubscription {
+    readonly identifier: string;
+    private callbacks;
+    private sendFn;
+    constructor(identifier: string, sendFn: (data: Record<string, unknown>) => void);
+    onReceived(callback: SubscriptionCallback): this;
+    onConnected(callback: () => void): this;
+    onDisconnected(callback: () => void): this;
+    onRejected(callback: () => void): this;
+    perform(action: string, data?: Record<string, unknown>): void;
+    /* Excluded from this release type: _notifyReceived */
+    /* Excluded from this release type: _notifyConnected */
+    /* Excluded from this release type: _notifyDisconnected */
+    /* Excluded from this release type: _notifyRejected */
+}
+
+export declare interface ChatClientConfig extends ConnectionConfig {
+    apiKey?: string;
+    conversationId?: string;
+    systemPromptId?: number;
+    channel?: 'widget' | 'api';
+    onMessage?: (message: Message) => void;
+    onStatusChange?: (status: string) => void;
+    onError?: (error: Error) => void;
+    onStreamUpdate?: (delta: string, fullContent: string) => void;
+    onConnectionStateChange?: (state: ConnectionState) => void;
+}
+
+export declare interface ChatEvents {
+    'connection:state': ConnectionState;
+    'message:received': Message;
+    'message:updated': Message;
+    'message:sent': Message;
+    'stream:start': {
+        messageId: string;
+    };
+    'stream:update': {
+        delta: string;
+        content: string;
+    };
+    'stream:end': {
+        messageId: string;
+        usage?: {
+            tokensInput: number;
+            tokensOutput: number;
+        };
+    };
+    'typing:start': void;
+    'typing:stop': void;
+    'error': Error;
+    'status': string;
+}
+
+export declare interface ConnectionConfig {
+    baseUrl: string;
+    userToken: string;
+    reconnect?: boolean;
+    maxReconnectAttempts?: number;
+    reconnectInterval?: number;
+}
+
+export declare class ConnectionManager extends EventEmitter<ChatEvents> {
+    private client;
+    private config;
+    private state;
+    private reconnectAttempt;
+    private reconnectTimer;
+    constructor(config: ConnectionConfig);
+    connect(): Promise<void>;
+    disconnect(): Promise<void>;
+    subscribeToConversation(conversationId: string | number): Promise<ChannelSubscription>;
+    sendMessage(conversationId: string | number, content: string): void;
+    sendUserEvent(conversationId: string | number, eventKey: string, value?: object, source?: string): void;
+    get connectionState(): ConnectionState;
+    private setState;
+    private scheduleReconnect;
+    private clearReconnectTimer;
+    private buildWsUrl;
+}
+
+export declare type ConnectionState = 'disconnected' | 'connecting' | 'connected' | 'reconnecting';
+
+export declare class ConversationManager {
+    private _conversationId;
+    private persist;
+    constructor(conversationId?: string, persist?: boolean);
+    get conversationId(): string | null;
+    set conversationId(id: string | null);
+    clear(): void;
+    private loadFromStorage;
+    private saveToStorage;
+}
+
+declare interface CreateConversationResponse {
+    id: string;
+    status: string;
+}
+
+export declare class EventEmitter<Events extends Record<string, any>> {
+    private handlers;
+    on<K extends keyof Events & string>(event: K, handler: (data: Events[K]) => void): () => void;
+    off<K extends keyof Events & string>(event: K, handler: (data: Events[K]) => void): void;
+    emit<K extends keyof Events & string>(event: K, data: Events[K]): void;
+    removeAllListeners(): void;
+}
+
+export declare interface Message {
+    id: string;
+    conversationId: string;
+    role: 'user' | 'assistant' | 'system' | 'tool';
+    content: string;
+    toolCalls?: ToolCall[];
+    toolCallResults?: ToolCallResult;
+    tokensInput?: number;
+    tokensOutput?: number;
+    metadata?: Record<string, unknown>;
+    createdAt: string;
+    status?: 'sending' | 'sent' | 'streaming' | 'complete' | 'error';
+}
+
+export declare class MessageStore {
+    private _messages;
+    private optimisticCounter;
+    get messages(): Message[];
+    addOptimistic(role: 'user', content: string, conversationId: string): Message;
+    confirmOptimistic(tempId: string): void;
+    addStreamingMessage(conversationId: string): Message;
+    updateStreaming(content: string): void;
+    finalizeStreaming(usage?: {
+        tokensInput: number;
+        tokensOutput: number;
+    }): Message | undefined;
+    addMessage(message: Message): void;
+    setMessages(messages: Message[]): void;
+    clear(): void;
+}
+
+export declare function mount(config: WidgetConfig): AikaaraChatWidget;
+
+export declare function registerComponents(): void;
+
+declare type SubscriptionCallback = (data: unknown) => void;
+
+export declare interface ToolCall {
+    id: string;
+    type: 'function';
+    function: {
+        name: string;
+        arguments: string;
+    };
+}
+
+export declare interface ToolCallResult {
+    tool_call_id: string;
+    content: string;
+}
+
+export declare function unmount(): void;
+
+export declare interface WidgetConfig extends ChatClientConfig {
+    position?: 'bottom-right' | 'bottom-left';
+    offset?: {
+        x: number;
+        y: number;
+    };
+    width?: number;
+    height?: number;
+    theme?: 'light' | 'dark' | 'auto';
+    primaryColor?: string;
+    fontFamily?: string;
+    borderRadius?: number;
+    title?: string;
+    subtitle?: string;
+    avatarUrl?: string;
+    welcomeMessage?: string;
+    placeholder?: string;
+    showTimestamps?: boolean;
+    persistConversation?: boolean;
+    showBubble?: boolean;
+    bubbleText?: string;
+    bubbleIcon?: string;
+}
+
+export { }

package/dist/index.mjs

@@ -0,0 +1,52 @@
+import { A as p, a as d, b as g, C as h, c as k, d as C, E as b, M as A } from "./headless-DzI-CcOZ.mjs";
+import { registerComponents as n } from "./ui.mjs";
+import { AikaaraChatBubble as M, AikaaraChatHeader as w, AikaaraChatInput as y, AikaaraChatWidget as v, AikaaraErrorBanner as E, AikaaraMessageBubble as S, AikaaraMessageList as x, AikaaraStreamingMessage as B, AikaaraTypingIndicator as I } from "./ui.mjs";
+function l(a) {
+  n();
+  const e = document.createElement("aikaara-chat-widget"), r = {
+    baseUrl: "base-url",
+    userToken: "user-token",
+    apiKey: "api-key",
+    title: "title",
+    subtitle: "subtitle",
+    theme: "theme",
+    primaryColor: "primary-color",
+    position: "position",
+    width: "width",
+    height: "height",
+    placeholder: "placeholder",
+    welcomeMessage: "welcome-message",
+    avatarUrl: "avatar-url"
+  };
+  for (const [i, o] of Object.entries(r)) {
+    const t = a[i];
+    t != null && e.setAttribute(o, String(t));
+  }
+  return e.configure(a), document.body.appendChild(e), e;
+}
+function c() {
+  const a = document.querySelector("aikaara-chat-widget");
+  a && a.remove();
+}
+export {
+  p as ActionCableClient,
+  M as AikaaraChatBubble,
+  d as AikaaraChatClient,
+  w as AikaaraChatHeader,
+  y as AikaaraChatInput,
+  v as AikaaraChatWidget,
+  E as AikaaraErrorBanner,
+  S as AikaaraMessageBubble,
+  x as AikaaraMessageList,
+  B as AikaaraStreamingMessage,
+  I as AikaaraTypingIndicator,
+  g as ApiClient,
+  h as ChannelSubscription,
+  k as ConnectionManager,
+  C as ConversationManager,
+  b as EventEmitter,
+  A as MessageStore,
+  l as mount,
+  n as registerComponents,
+  c as unmount
+};