@espejo/browser 0.1.0 → 0.3.0

package/dist/chat.d.cts

@@ -1,5 +1,5 @@
-import { A as AgentActionType, a as AgentToolDefinition, b as ActResult, C as ConfirmRequest, E as EspejoAgent } from './index-Djj7dbiY.cjs';
-import { W as WidgetCorner, a as WidgetTheme } from './shadow-scaffold-DUJmxf_n.cjs';
+import { A as AgentActionType, a as AgentToolDefinition, b as ActResult, R as RingSource, C as ConfirmRequest, E as EspejoAgent } from './index-DsYc9zWf.cjs';
+import { W as WidgetTheme, a as WidgetCorner } from './shadow-scaffold-BsadRTCW.cjs';
 
 interface AgentChatToolCall {
     id: string;
@@ -7,13 +7,36 @@ interface AgentChatToolCall {
     input: Record<string, unknown>;
 }
 type AgentChatErrorCode = 'provider_auth' | 'provider_rate_limited' | 'provider_error' | 'timeout' | 'iteration_limit' | 'internal';
+interface AgentConversationSummary {
+    id: string;
+    title: string;
+    created_at: string;
+    updated_at: string;
+}
+interface AgentConversationMessage {
+    role: 'user' | 'assistant';
+    text: string;
+    at?: string;
+}
+interface AgentConversationDetail {
+    id: string;
+    created_at: string;
+    updated_at: string;
+    messages: AgentConversationMessage[];
+}
 type AgentWidgetTheme = 'auto' | 'light' | 'dark';
+type AgentGreetingMode = 'default' | 'custom' | 'agent';
 interface AgentPublicConfig {
     enabled: boolean;
     allowed_actions: AgentActionType[];
     theme: AgentWidgetTheme;
     name: string | null;
     icon: string | null;
+    sticky_container_id?: string | null;
+    accent_color?: string | null;
+    greeting_mode?: AgentGreetingMode;
+    greeting_text?: string | null;
+    history_enabled?: boolean;
     sections: AgentWidgetSection[];
 }
 type AgentWidgetSection = 'home' | 'support' | 'tickets' | 'guides';
@@ -21,12 +44,17 @@ type AgentWidgetSection = 'home' | 'support' | 'tickets' | 'guides';
 interface ChatIdentity {
     email: string;
     hash: string;
+    name?: string;
 }
 interface ChatQueueItem {
     id: number;
     text: string;
 }
-type ChatErrorCode = 'no_agent' | 'daily_cap' | 'rate_limited' | 'conversation_limit' | 'conversation_expired' | 'conversation_busy' | 'identity_changed' | 'conflict' | 'forbidden' | 'bad_request' | 'unavailable' | 'network' | AgentChatErrorCode;
+type ChatErrorCode = 'no_agent' | 'daily_cap' | 'rate_limited' | 'conversation_limit' | 'conversation_expired' | 'conversation_busy' | 'identity_changed' | 'conflict' | 'identity_required' | 'history_disabled' | 'conversation_not_found' | 'greeting_disabled' | 'greeting_not_allowed' | 'bad_response' | 'forbidden' | 'bad_request' | 'unavailable' | 'network' | AgentChatErrorCode;
+type ChatError = Error & {
+    code: ChatErrorCode;
+};
+type ChatGreetResult = 'done' | 'greeting_disabled' | 'greeting_not_allowed' | 'failed';
 type ChatClientEvent = {
     type: 'text';
     delta: string;
@@ -62,8 +90,15 @@ type ChatClientEvent = {
     id: number;
     message: string;
 };
+interface ChatEspejo {
+    snapshot(): ReturnType<RingSource['snapshot']>;
+    readonly lastReportId: string | null;
+    canOpenReport(): boolean;
+    openReport(): boolean;
+}
 interface ChatClientOptions {
     key: string;
+    espejo?: ChatEspejo;
     baseUrl?: string;
     onConfirm?: (req: ConfirmRequest) => boolean | Promise<boolean>;
     onEvent?: (event: ChatClientEvent) => void;
@@ -72,6 +107,8 @@ interface ChatClientOptions {
     fetch?: typeof fetch;
     storage?: Storage | null;
     identity?: ChatIdentity | null;
+    conversationId?: string;
+    lang?: string;
 }
 interface ChatClient {
     send(message: string): Promise<void>;
@@ -86,6 +123,13 @@ interface ChatClient {
     identify(identity: ChatIdentity | null): void;
     destroy(): void;
     getConfig(): Promise<AgentPublicConfig | null>;
+    listConversations(): Promise<AgentConversationSummary[]>;
+    loadConversation(id: string): Promise<AgentConversationDetail>;
+    openConversation(id: string): Promise<AgentConversationDetail>;
+    greet(options?: {
+        lang?: string;
+        title?: string;
+    }): Promise<ChatGreetResult>;
     readonly conversationId: string;
     readonly busy: boolean;
     readonly queue: ChatQueueItem[];
@@ -185,6 +229,8 @@ declare const DEFAULT_CHAT_TEXT: {
     askTitle: string;
     askHint: string;
     continueTitle: string;
+    historyTitle: string;
+    errorHistory: string;
     agoNow: string;
     agoMinutes: string;
     agoHours: string;
@@ -225,6 +271,29 @@ declare const DEFAULT_CHAT_TEXT: {
     ticketsEmpty: string;
     openTicket: string;
     ticketsWaiting: string;
+    ticketsReload: string;
+    minimize: string;
+    expand: string;
+    collapse: string;
+    dock: string;
+    undock: string;
+    more: string;
+    copy: string;
+    copied: string;
+    copyCode: string;
+    regenerate: string;
+    regenerateShort: string;
+    goodResponse: string;
+    badResponse: string;
+    notSent: string;
+    resend: string;
+    stopped: string;
+    jumpLatest: string;
+    hintSend: string;
+    hintQueue: string;
+    hintNewline: string;
+    helloNamed: string;
+    errorUnavailable: string;
 };
 type ChatText = typeof DEFAULT_CHAT_TEXT;
 type ChatLang = 'en' | 'es' | 'pt';
@@ -238,19 +307,42 @@ declare function describeAction(TEXT: ChatText, phase: 'confirm' | 'done' | 'fai
 declare function describeError(TEXT: ChatText, code: string | undefined): string;
 declare function describeValue(TEXT: ChatText, value: string): string;
 
+declare const PRESENCE_HOST_ATTRIBUTE = "data-espejo-presence";
+interface PresenceOptions {
+    lang?: string;
+    text?: Partial<Pick<ChatText, 'presenceNotice' | 'presenceNoticeNamed' | 'stop'>>;
+    name?: string;
+    theme?: WidgetTheme;
+    onStop?: () => void;
+    idleMs?: number;
+    glow?: boolean;
+    cursor?: boolean;
+    doc?: Document;
+}
+interface PresenceHandle {
+    start(): void;
+    end(): void;
+    stop(): void;
+    destroy(): void;
+    readonly active: boolean;
+}
+declare function installPresence(agent: EspejoAgent, options?: PresenceOptions): PresenceHandle | null;
+
 interface ChatWidgetOptions {
     key: string;
     baseUrl?: string;
     position?: WidgetCorner;
+    stickyContainerId?: string;
     theme?: WidgetTheme;
     lang?: string;
     title?: string;
     greeting?: string;
     suggestions?: string[];
     text?: Partial<ChatText>;
+    espejo?: ChatEspejo;
     agent?: EspejoAgent;
     allow?: AgentActionType[];
-    presence?: boolean;
+    presence?: boolean | Pick<PresenceOptions, 'glow' | 'cursor'>;
     identity?: ChatIdentity | null;
     fetch?: typeof fetch;
     storage?: Storage | null;
@@ -260,29 +352,10 @@ interface ChatWidgetHandle {
     open(): void;
     close(): void;
     destroy(): void;
-    identify(email: string | null, hash?: string): void;
+    identify(email: string | null, hash?: string, name?: string): void;
     readonly client: ChatClient;
 }
 declare const CHAT_HOST_ATTRIBUTE = "data-espejo-chat";
 declare function installChatWidget(options: ChatWidgetOptions): ChatWidgetHandle | null;
 
-declare const PRESENCE_HOST_ATTRIBUTE = "data-espejo-presence";
-interface PresenceOptions {
-    lang?: string;
-    text?: Partial<Pick<ChatText, 'presenceNotice' | 'presenceNoticeNamed' | 'stop'>>;
-    name?: string;
-    theme?: WidgetTheme;
-    onStop?: () => void;
-    idleMs?: number;
-    doc?: Document;
-}
-interface PresenceHandle {
-    start(): void;
-    end(): void;
-    stop(): void;
-    destroy(): void;
-    readonly active: boolean;
-}
-declare function installPresence(agent: EspejoAgent, options?: PresenceOptions): PresenceHandle | null;
-
-export { type ActionParts, CHAT_HOST_ATTRIBUTE, type ChatClient, type ChatClientEvent, type ChatClientOptions, type ChatErrorCode, type ChatIdentity, type ChatLang, type ChatQueueItem, type ChatText, type ChatWidgetHandle, type ChatWidgetOptions, DEFAULT_CHAT_TEXT, PRESENCE_HOST_ATTRIBUTE, type PresenceHandle, type PresenceOptions, chatTextFor, createChatClient, describeAction, describeError, describeValue, installChatWidget, installPresence };
+export { type ActionParts, type AgentConversationDetail, type AgentConversationMessage, type AgentConversationSummary, type AgentGreetingMode, CHAT_HOST_ATTRIBUTE, type ChatClient, type ChatClientEvent, type ChatClientOptions, type ChatError, type ChatErrorCode, type ChatEspejo, type ChatGreetResult, type ChatIdentity, type ChatLang, type ChatQueueItem, type ChatText, type ChatWidgetHandle, type ChatWidgetOptions, DEFAULT_CHAT_TEXT, PRESENCE_HOST_ATTRIBUTE, type PresenceHandle, type PresenceOptions, chatTextFor, createChatClient, describeAction, describeError, describeValue, installChatWidget, installPresence };

package/dist/chat.d.ts

@@ -1,5 +1,5 @@
-import { A as AgentActionType, a as AgentToolDefinition, b as ActResult, C as ConfirmRequest, E as EspejoAgent } from './index-Djj7dbiY.js';
-import { W as WidgetCorner, a as WidgetTheme } from './shadow-scaffold-DUJmxf_n.js';
+import { A as AgentActionType, a as AgentToolDefinition, b as ActResult, R as RingSource, C as ConfirmRequest, E as EspejoAgent } from './index-DsYc9zWf.js';
+import { W as WidgetTheme, a as WidgetCorner } from './shadow-scaffold-BsadRTCW.js';
 
 interface AgentChatToolCall {
     id: string;
@@ -7,13 +7,36 @@ interface AgentChatToolCall {
     input: Record<string, unknown>;
 }
 type AgentChatErrorCode = 'provider_auth' | 'provider_rate_limited' | 'provider_error' | 'timeout' | 'iteration_limit' | 'internal';
+interface AgentConversationSummary {
+    id: string;
+    title: string;
+    created_at: string;
+    updated_at: string;
+}
+interface AgentConversationMessage {
+    role: 'user' | 'assistant';
+    text: string;
+    at?: string;
+}
+interface AgentConversationDetail {
+    id: string;
+    created_at: string;
+    updated_at: string;
+    messages: AgentConversationMessage[];
+}
 type AgentWidgetTheme = 'auto' | 'light' | 'dark';
+type AgentGreetingMode = 'default' | 'custom' | 'agent';
 interface AgentPublicConfig {
     enabled: boolean;
     allowed_actions: AgentActionType[];
     theme: AgentWidgetTheme;
     name: string | null;
     icon: string | null;
+    sticky_container_id?: string | null;
+    accent_color?: string | null;
+    greeting_mode?: AgentGreetingMode;
+    greeting_text?: string | null;
+    history_enabled?: boolean;
     sections: AgentWidgetSection[];
 }
 type AgentWidgetSection = 'home' | 'support' | 'tickets' | 'guides';
@@ -21,12 +44,17 @@ type AgentWidgetSection = 'home' | 'support' | 'tickets' | 'guides';
 interface ChatIdentity {
     email: string;
     hash: string;
+    name?: string;
 }
 interface ChatQueueItem {
     id: number;
     text: string;
 }
-type ChatErrorCode = 'no_agent' | 'daily_cap' | 'rate_limited' | 'conversation_limit' | 'conversation_expired' | 'conversation_busy' | 'identity_changed' | 'conflict' | 'forbidden' | 'bad_request' | 'unavailable' | 'network' | AgentChatErrorCode;
+type ChatErrorCode = 'no_agent' | 'daily_cap' | 'rate_limited' | 'conversation_limit' | 'conversation_expired' | 'conversation_busy' | 'identity_changed' | 'conflict' | 'identity_required' | 'history_disabled' | 'conversation_not_found' | 'greeting_disabled' | 'greeting_not_allowed' | 'bad_response' | 'forbidden' | 'bad_request' | 'unavailable' | 'network' | AgentChatErrorCode;
+type ChatError = Error & {
+    code: ChatErrorCode;
+};
+type ChatGreetResult = 'done' | 'greeting_disabled' | 'greeting_not_allowed' | 'failed';
 type ChatClientEvent = {
     type: 'text';
     delta: string;
@@ -62,8 +90,15 @@ type ChatClientEvent = {
     id: number;
     message: string;
 };
+interface ChatEspejo {
+    snapshot(): ReturnType<RingSource['snapshot']>;
+    readonly lastReportId: string | null;
+    canOpenReport(): boolean;
+    openReport(): boolean;
+}
 interface ChatClientOptions {
     key: string;
+    espejo?: ChatEspejo;
     baseUrl?: string;
     onConfirm?: (req: ConfirmRequest) => boolean | Promise<boolean>;
     onEvent?: (event: ChatClientEvent) => void;
@@ -72,6 +107,8 @@ interface ChatClientOptions {
     fetch?: typeof fetch;
     storage?: Storage | null;
     identity?: ChatIdentity | null;
+    conversationId?: string;
+    lang?: string;
 }
 interface ChatClient {
     send(message: string): Promise<void>;
@@ -86,6 +123,13 @@ interface ChatClient {
     identify(identity: ChatIdentity | null): void;
     destroy(): void;
     getConfig(): Promise<AgentPublicConfig | null>;
+    listConversations(): Promise<AgentConversationSummary[]>;
+    loadConversation(id: string): Promise<AgentConversationDetail>;
+    openConversation(id: string): Promise<AgentConversationDetail>;
+    greet(options?: {
+        lang?: string;
+        title?: string;
+    }): Promise<ChatGreetResult>;
     readonly conversationId: string;
     readonly busy: boolean;
     readonly queue: ChatQueueItem[];
@@ -185,6 +229,8 @@ declare const DEFAULT_CHAT_TEXT: {
     askTitle: string;
     askHint: string;
     continueTitle: string;
+    historyTitle: string;
+    errorHistory: string;
     agoNow: string;
     agoMinutes: string;
     agoHours: string;
@@ -225,6 +271,29 @@ declare const DEFAULT_CHAT_TEXT: {
     ticketsEmpty: string;
     openTicket: string;
     ticketsWaiting: string;
+    ticketsReload: string;
+    minimize: string;
+    expand: string;
+    collapse: string;
+    dock: string;
+    undock: string;
+    more: string;
+    copy: string;
+    copied: string;
+    copyCode: string;
+    regenerate: string;
+    regenerateShort: string;
+    goodResponse: string;
+    badResponse: string;
+    notSent: string;
+    resend: string;
+    stopped: string;
+    jumpLatest: string;
+    hintSend: string;
+    hintQueue: string;
+    hintNewline: string;
+    helloNamed: string;
+    errorUnavailable: string;
 };
 type ChatText = typeof DEFAULT_CHAT_TEXT;
 type ChatLang = 'en' | 'es' | 'pt';
@@ -238,19 +307,42 @@ declare function describeAction(TEXT: ChatText, phase: 'confirm' | 'done' | 'fai
 declare function describeError(TEXT: ChatText, code: string | undefined): string;
 declare function describeValue(TEXT: ChatText, value: string): string;
 
+declare const PRESENCE_HOST_ATTRIBUTE = "data-espejo-presence";
+interface PresenceOptions {
+    lang?: string;
+    text?: Partial<Pick<ChatText, 'presenceNotice' | 'presenceNoticeNamed' | 'stop'>>;
+    name?: string;
+    theme?: WidgetTheme;
+    onStop?: () => void;
+    idleMs?: number;
+    glow?: boolean;
+    cursor?: boolean;
+    doc?: Document;
+}
+interface PresenceHandle {
+    start(): void;
+    end(): void;
+    stop(): void;
+    destroy(): void;
+    readonly active: boolean;
+}
+declare function installPresence(agent: EspejoAgent, options?: PresenceOptions): PresenceHandle | null;
+
 interface ChatWidgetOptions {
     key: string;
     baseUrl?: string;
     position?: WidgetCorner;
+    stickyContainerId?: string;
     theme?: WidgetTheme;
     lang?: string;
     title?: string;
     greeting?: string;
     suggestions?: string[];
     text?: Partial<ChatText>;
+    espejo?: ChatEspejo;
     agent?: EspejoAgent;
     allow?: AgentActionType[];
-    presence?: boolean;
+    presence?: boolean | Pick<PresenceOptions, 'glow' | 'cursor'>;
     identity?: ChatIdentity | null;
     fetch?: typeof fetch;
     storage?: Storage | null;
@@ -260,29 +352,10 @@ interface ChatWidgetHandle {
     open(): void;
     close(): void;
     destroy(): void;
-    identify(email: string | null, hash?: string): void;
+    identify(email: string | null, hash?: string, name?: string): void;
     readonly client: ChatClient;
 }
 declare const CHAT_HOST_ATTRIBUTE = "data-espejo-chat";
 declare function installChatWidget(options: ChatWidgetOptions): ChatWidgetHandle | null;
 
-declare const PRESENCE_HOST_ATTRIBUTE = "data-espejo-presence";
-interface PresenceOptions {
-    lang?: string;
-    text?: Partial<Pick<ChatText, 'presenceNotice' | 'presenceNoticeNamed' | 'stop'>>;
-    name?: string;
-    theme?: WidgetTheme;
-    onStop?: () => void;
-    idleMs?: number;
-    doc?: Document;
-}
-interface PresenceHandle {
-    start(): void;
-    end(): void;
-    stop(): void;
-    destroy(): void;
-    readonly active: boolean;
-}
-declare function installPresence(agent: EspejoAgent, options?: PresenceOptions): PresenceHandle | null;
-
-export { type ActionParts, CHAT_HOST_ATTRIBUTE, type ChatClient, type ChatClientEvent, type ChatClientOptions, type ChatErrorCode, type ChatIdentity, type ChatLang, type ChatQueueItem, type ChatText, type ChatWidgetHandle, type ChatWidgetOptions, DEFAULT_CHAT_TEXT, PRESENCE_HOST_ATTRIBUTE, type PresenceHandle, type PresenceOptions, chatTextFor, createChatClient, describeAction, describeError, describeValue, installChatWidget, installPresence };
+export { type ActionParts, type AgentConversationDetail, type AgentConversationMessage, type AgentConversationSummary, type AgentGreetingMode, CHAT_HOST_ATTRIBUTE, type ChatClient, type ChatClientEvent, type ChatClientOptions, type ChatError, type ChatErrorCode, type ChatEspejo, type ChatGreetResult, type ChatIdentity, type ChatLang, type ChatQueueItem, type ChatText, type ChatWidgetHandle, type ChatWidgetOptions, DEFAULT_CHAT_TEXT, PRESENCE_HOST_ATTRIBUTE, type PresenceHandle, type PresenceOptions, chatTextFor, createChatClient, describeAction, describeError, describeValue, installChatWidget, installPresence };