@espejo/browser 0.1.0

package/dist/chat.d.cts

@@ -0,0 +1,288 @@
+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';
+
+interface AgentChatToolCall {
+    id: string;
+    name: AgentToolDefinition['name'];
+    input: Record<string, unknown>;
+}
+type AgentChatErrorCode = 'provider_auth' | 'provider_rate_limited' | 'provider_error' | 'timeout' | 'iteration_limit' | 'internal';
+type AgentWidgetTheme = 'auto' | 'light' | 'dark';
+interface AgentPublicConfig {
+    enabled: boolean;
+    allowed_actions: AgentActionType[];
+    theme: AgentWidgetTheme;
+    name: string | null;
+    icon: string | null;
+    sections: AgentWidgetSection[];
+}
+type AgentWidgetSection = 'home' | 'support' | 'tickets' | 'guides';
+
+interface ChatIdentity {
+    email: string;
+    hash: 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 ChatClientEvent = {
+    type: 'text';
+    delta: string;
+} | {
+    type: 'tool_start';
+    call: AgentChatToolCall;
+    label: string;
+    target?: string;
+    value?: string;
+    destination?: string;
+} | {
+    type: 'tool';
+    call: AgentChatToolCall;
+    label: string;
+    target?: string;
+    value?: string;
+    destination?: string;
+    result: ActResult;
+} | {
+    type: 'done';
+    conversationId: string;
+} | {
+    type: 'error';
+    code: ChatErrorCode;
+    message: string;
+    retryAfter?: number;
+} | {
+    type: 'queue';
+    queue: ChatQueueItem[];
+    paused: boolean;
+} | {
+    type: 'dequeued';
+    id: number;
+    message: string;
+};
+interface ChatClientOptions {
+    key: string;
+    baseUrl?: string;
+    onConfirm?: (req: ConfirmRequest) => boolean | Promise<boolean>;
+    onEvent?: (event: ChatClientEvent) => void;
+    agent?: EspejoAgent;
+    allow?: AgentActionType[];
+    fetch?: typeof fetch;
+    storage?: Storage | null;
+    identity?: ChatIdentity | null;
+}
+interface ChatClient {
+    send(message: string): Promise<void>;
+    enqueue(message: string): boolean;
+    removeQueued(id: number): void;
+    editQueued(id: number, message: string): void;
+    sendQueuedNow(id: number): Promise<void>;
+    clearQueue(): void;
+    resumeQueue(): Promise<void>;
+    reset(): void;
+    abort(): void;
+    identify(identity: ChatIdentity | null): void;
+    destroy(): void;
+    getConfig(): Promise<AgentPublicConfig | null>;
+    readonly conversationId: string;
+    readonly busy: boolean;
+    readonly queue: ChatQueueItem[];
+    readonly paused: boolean;
+}
+declare function createChatClient(options: ChatClientOptions): ChatClient;
+
+declare const DEFAULT_CHAT_TEXT: {
+    open: string;
+    title: string;
+    close: string;
+    newChat: string;
+    greeting: string;
+    inputLabel: string;
+    placeholder: string;
+    send: string;
+    thinking: string;
+    confirmTitle: string;
+    allow: string;
+    allowAlways: string;
+    decline: string;
+    allowed: string;
+    declined: string;
+    confirmHighlight: string;
+    confirmScroll: string;
+    confirmClick: string;
+    confirmClickLink: string;
+    confirmFill: string;
+    confirmNavigate: string;
+    emptyValue: string;
+    didHighlight: string;
+    didScroll: string;
+    didClick: string;
+    didFill: string;
+    didNavigate: string;
+    actionFailed: string;
+    errorNoAgent: string;
+    errorDailyCap: string;
+    errorRateLimited: string;
+    errorConversationLimit: string;
+    errorBusy: string;
+    startOver: string;
+    errorNetwork: string;
+    errorGeneric: string;
+    stop: string;
+    presenceNotice: string;
+    presenceNoticeNamed: string;
+    online: string;
+    options: string;
+    optionsTitle: string;
+    optionsHint: string;
+    optionsEmpty: string;
+    optionsUnavailable: string;
+    anElement: string;
+    askFirst: string;
+    suggestions: string;
+    running: string;
+    done: string;
+    failed: string;
+    actionsCount: string;
+    detailTarget: string;
+    detailDestination: string;
+    detailValue: string;
+    nameHighlight: string;
+    descHighlight: string;
+    nameScroll: string;
+    descScroll: string;
+    nameClick: string;
+    descClick: string;
+    nameFill: string;
+    descFill: string;
+    nameNavigate: string;
+    descNavigate: string;
+    whyNotAllowed: string;
+    whyPrivate: string;
+    whyDisabled: string;
+    whyGone: string;
+    whyOtherSite: string;
+    whyDeclined: string;
+    whyNotFillable: string;
+    whyInvalidValue: string;
+    whyGeneric: string;
+    queueTitle: string;
+    queuePaused: string;
+    queueResume: string;
+    queueClear: string;
+    queueSendNow: string;
+    queueEdit: string;
+    queueRemove: string;
+    queueFull: string;
+    tabs: string;
+    tabHome: string;
+    tabSupport: string;
+    tabGuides: string;
+    hello: string;
+    helpPrompt: string;
+    askTitle: string;
+    askHint: string;
+    continueTitle: string;
+    agoNow: string;
+    agoMinutes: string;
+    agoHours: string;
+    agoDays: string;
+    searchGuides: string;
+    popularGuides: string;
+    guidesCount: string;
+    guidesCountOne: string;
+    guidesLoading: string;
+    guidesError: string;
+    guidesEmpty: string;
+    guidesNoMatch: string;
+    askInstead: string;
+    retry: string;
+    backToGuides: string;
+    newTab: string;
+    openFullPage: string;
+    articleLoading: string;
+    articleError: string;
+    voteQuestion: string;
+    voteYes: string;
+    voteNo: string;
+    voteThanks: string;
+    voteSorry: string;
+    voteSorryAssist: string;
+    tabTickets: string;
+    reportProblem: string;
+    ticketsFilter: string;
+    filterAll: string;
+    filterOpen: string;
+    filterResolved: string;
+    statusTeam: string;
+    statusYou: string;
+    statusResolved: string;
+    recordingAttached: string;
+    ticketsLoading: string;
+    ticketsError: string;
+    ticketsEmpty: string;
+    openTicket: string;
+    ticketsWaiting: string;
+};
+type ChatText = typeof DEFAULT_CHAT_TEXT;
+type ChatLang = 'en' | 'es' | 'pt';
+declare function chatTextFor(lang: string | undefined): ChatText;
+interface ActionParts {
+    type: string;
+    target?: string;
+    destination?: string;
+}
+declare function describeAction(TEXT: ChatText, phase: 'confirm' | 'done' | 'failed', a: ActionParts): string;
+declare function describeError(TEXT: ChatText, code: string | undefined): string;
+declare function describeValue(TEXT: ChatText, value: string): string;
+
+interface ChatWidgetOptions {
+    key: string;
+    baseUrl?: string;
+    position?: WidgetCorner;
+    theme?: WidgetTheme;
+    lang?: string;
+    title?: string;
+    greeting?: string;
+    suggestions?: string[];
+    text?: Partial<ChatText>;
+    agent?: EspejoAgent;
+    allow?: AgentActionType[];
+    presence?: boolean;
+    identity?: ChatIdentity | null;
+    fetch?: typeof fetch;
+    storage?: Storage | null;
+    doc?: Document;
+}
+interface ChatWidgetHandle {
+    open(): void;
+    close(): void;
+    destroy(): void;
+    identify(email: string | null, hash?: 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 };

package/dist/chat.d.ts

@@ -0,0 +1,288 @@
+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';
+
+interface AgentChatToolCall {
+    id: string;
+    name: AgentToolDefinition['name'];
+    input: Record<string, unknown>;
+}
+type AgentChatErrorCode = 'provider_auth' | 'provider_rate_limited' | 'provider_error' | 'timeout' | 'iteration_limit' | 'internal';
+type AgentWidgetTheme = 'auto' | 'light' | 'dark';
+interface AgentPublicConfig {
+    enabled: boolean;
+    allowed_actions: AgentActionType[];
+    theme: AgentWidgetTheme;
+    name: string | null;
+    icon: string | null;
+    sections: AgentWidgetSection[];
+}
+type AgentWidgetSection = 'home' | 'support' | 'tickets' | 'guides';
+
+interface ChatIdentity {
+    email: string;
+    hash: 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 ChatClientEvent = {
+    type: 'text';
+    delta: string;
+} | {
+    type: 'tool_start';
+    call: AgentChatToolCall;
+    label: string;
+    target?: string;
+    value?: string;
+    destination?: string;
+} | {
+    type: 'tool';
+    call: AgentChatToolCall;
+    label: string;
+    target?: string;
+    value?: string;
+    destination?: string;
+    result: ActResult;
+} | {
+    type: 'done';
+    conversationId: string;
+} | {
+    type: 'error';
+    code: ChatErrorCode;
+    message: string;
+    retryAfter?: number;
+} | {
+    type: 'queue';
+    queue: ChatQueueItem[];
+    paused: boolean;
+} | {
+    type: 'dequeued';
+    id: number;
+    message: string;
+};
+interface ChatClientOptions {
+    key: string;
+    baseUrl?: string;
+    onConfirm?: (req: ConfirmRequest) => boolean | Promise<boolean>;
+    onEvent?: (event: ChatClientEvent) => void;
+    agent?: EspejoAgent;
+    allow?: AgentActionType[];
+    fetch?: typeof fetch;
+    storage?: Storage | null;
+    identity?: ChatIdentity | null;
+}
+interface ChatClient {
+    send(message: string): Promise<void>;
+    enqueue(message: string): boolean;
+    removeQueued(id: number): void;
+    editQueued(id: number, message: string): void;
+    sendQueuedNow(id: number): Promise<void>;
+    clearQueue(): void;
+    resumeQueue(): Promise<void>;
+    reset(): void;
+    abort(): void;
+    identify(identity: ChatIdentity | null): void;
+    destroy(): void;
+    getConfig(): Promise<AgentPublicConfig | null>;
+    readonly conversationId: string;
+    readonly busy: boolean;
+    readonly queue: ChatQueueItem[];
+    readonly paused: boolean;
+}
+declare function createChatClient(options: ChatClientOptions): ChatClient;
+
+declare const DEFAULT_CHAT_TEXT: {
+    open: string;
+    title: string;
+    close: string;
+    newChat: string;
+    greeting: string;
+    inputLabel: string;
+    placeholder: string;
+    send: string;
+    thinking: string;
+    confirmTitle: string;
+    allow: string;
+    allowAlways: string;
+    decline: string;
+    allowed: string;
+    declined: string;
+    confirmHighlight: string;
+    confirmScroll: string;
+    confirmClick: string;
+    confirmClickLink: string;
+    confirmFill: string;
+    confirmNavigate: string;
+    emptyValue: string;
+    didHighlight: string;
+    didScroll: string;
+    didClick: string;
+    didFill: string;
+    didNavigate: string;
+    actionFailed: string;
+    errorNoAgent: string;
+    errorDailyCap: string;
+    errorRateLimited: string;
+    errorConversationLimit: string;
+    errorBusy: string;
+    startOver: string;
+    errorNetwork: string;
+    errorGeneric: string;
+    stop: string;
+    presenceNotice: string;
+    presenceNoticeNamed: string;
+    online: string;
+    options: string;
+    optionsTitle: string;
+    optionsHint: string;
+    optionsEmpty: string;
+    optionsUnavailable: string;
+    anElement: string;
+    askFirst: string;
+    suggestions: string;
+    running: string;
+    done: string;
+    failed: string;
+    actionsCount: string;
+    detailTarget: string;
+    detailDestination: string;
+    detailValue: string;
+    nameHighlight: string;
+    descHighlight: string;
+    nameScroll: string;
+    descScroll: string;
+    nameClick: string;
+    descClick: string;
+    nameFill: string;
+    descFill: string;
+    nameNavigate: string;
+    descNavigate: string;
+    whyNotAllowed: string;
+    whyPrivate: string;
+    whyDisabled: string;
+    whyGone: string;
+    whyOtherSite: string;
+    whyDeclined: string;
+    whyNotFillable: string;
+    whyInvalidValue: string;
+    whyGeneric: string;
+    queueTitle: string;
+    queuePaused: string;
+    queueResume: string;
+    queueClear: string;
+    queueSendNow: string;
+    queueEdit: string;
+    queueRemove: string;
+    queueFull: string;
+    tabs: string;
+    tabHome: string;
+    tabSupport: string;
+    tabGuides: string;
+    hello: string;
+    helpPrompt: string;
+    askTitle: string;
+    askHint: string;
+    continueTitle: string;
+    agoNow: string;
+    agoMinutes: string;
+    agoHours: string;
+    agoDays: string;
+    searchGuides: string;
+    popularGuides: string;
+    guidesCount: string;
+    guidesCountOne: string;
+    guidesLoading: string;
+    guidesError: string;
+    guidesEmpty: string;
+    guidesNoMatch: string;
+    askInstead: string;
+    retry: string;
+    backToGuides: string;
+    newTab: string;
+    openFullPage: string;
+    articleLoading: string;
+    articleError: string;
+    voteQuestion: string;
+    voteYes: string;
+    voteNo: string;
+    voteThanks: string;
+    voteSorry: string;
+    voteSorryAssist: string;
+    tabTickets: string;
+    reportProblem: string;
+    ticketsFilter: string;
+    filterAll: string;
+    filterOpen: string;
+    filterResolved: string;
+    statusTeam: string;
+    statusYou: string;
+    statusResolved: string;
+    recordingAttached: string;
+    ticketsLoading: string;
+    ticketsError: string;
+    ticketsEmpty: string;
+    openTicket: string;
+    ticketsWaiting: string;
+};
+type ChatText = typeof DEFAULT_CHAT_TEXT;
+type ChatLang = 'en' | 'es' | 'pt';
+declare function chatTextFor(lang: string | undefined): ChatText;
+interface ActionParts {
+    type: string;
+    target?: string;
+    destination?: string;
+}
+declare function describeAction(TEXT: ChatText, phase: 'confirm' | 'done' | 'failed', a: ActionParts): string;
+declare function describeError(TEXT: ChatText, code: string | undefined): string;
+declare function describeValue(TEXT: ChatText, value: string): string;
+
+interface ChatWidgetOptions {
+    key: string;
+    baseUrl?: string;
+    position?: WidgetCorner;
+    theme?: WidgetTheme;
+    lang?: string;
+    title?: string;
+    greeting?: string;
+    suggestions?: string[];
+    text?: Partial<ChatText>;
+    agent?: EspejoAgent;
+    allow?: AgentActionType[];
+    presence?: boolean;
+    identity?: ChatIdentity | null;
+    fetch?: typeof fetch;
+    storage?: Storage | null;
+    doc?: Document;
+}
+interface ChatWidgetHandle {
+    open(): void;
+    close(): void;
+    destroy(): void;
+    identify(email: string | null, hash?: 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 };