@wysdym/agent 0.1.0

package/dist/sdk/WysdymWidget.d.ts

@@ -0,0 +1,108 @@
+/**
+ * Props for the WysdymWidget component.
+ *
+ * @example
+ * ```tsx
+ * <WysdymWidget
+ *   agentId="your-agent-id"
+ *   mode="floating"
+ *   position="bottom-right"
+ * />
+ * ```
+ */
+export interface WysdymWidgetProps {
+    /** The unique agent ID for your Wysdym agent (required) */
+    agentId: string;
+    /** Display mode: 'floating' (bottom corner) or 'inline' (embedded in container) */
+    mode?: 'floating' | 'inline';
+    /** Position for floating mode: 'bottom-right' or 'bottom-left' */
+    position?: 'bottom-right' | 'bottom-left';
+    /** Color theme: 'light' or 'dark' */
+    theme?: 'light' | 'dark';
+    /** Primary brand color (CSS color value) */
+    primaryColor?: string;
+    /** Whether the widget can be expanded/collapsed by the user */
+    expandable?: boolean;
+    /** Defer initialization until manually triggered */
+    deferInit?: boolean;
+    /** Text shown on the trigger button */
+    triggerText?: string;
+    /** Override the backend API URL (defaults to auto-detection based on hostname) */
+    backendUrl?: string;
+    /** Admin preview: tooltip text (overrides API when set) */
+    previewTriggerText?: string;
+    /** Admin preview: button text (overrides API when set) */
+    previewButtonText?: string;
+    /** Admin preview: button icon name e.g. ArrowLeft, Home (overrides API when set) */
+    previewButtonIcon?: string;
+}
+/**
+ * Options for generating widget embed code.
+ */
+export interface GetEmbedCodeOptions {
+    /** Company token for authentication (deprecated: no longer required) */
+    companyToken?: string;
+    /** Display mode: 'floating' (bottom corner) or 'inline' (embedded in container) */
+    mode?: 'floating' | 'inline';
+    /** Position for floating mode */
+    position?: string;
+    /** Container element ID for inline mode */
+    containerId?: string;
+}
+/**
+ * Wysdym Widget - Declarative React component for embedding the Wysdym chat widget.
+ *
+ * This component renders the `<wysdym-widget>` custom element which displays
+ * a pill-shaped trigger button with animated rainbow border. When clicked,
+ * it mounts the full chat widget in expanded mode.
+ *
+ * @example Basic usage
+ * ```tsx
+ * import { WysdymWidget } from '@wysdym/agent';
+ * import '@wysdym/agent/style.css';
+ *
+ * function App() {
+ *   return (
+ *     <WysdymWidget
+ *       agentId="your-agent-id"
+ *       mode="floating"
+ *     />
+ *   );
+ * }
+ * ```
+ *
+ * @example With position
+ * ```tsx
+ * <WysdymWidget
+ *   agentId="your-agent-id"
+ *   mode="floating"
+ *   position="bottom-left"
+ * />
+ * ```
+ */
+export declare function WysdymWidget({ agentId, mode, position, theme, primaryColor, expandable, deferInit, backendUrl, previewTriggerText, previewButtonText, previewButtonIcon, }: WysdymWidgetProps): import("react/jsx-runtime").JSX.Element;
+/**
+ * Generate HTML embed code snippet for the Wysdym widget.
+ *
+ * This utility generates a `<script>` tag that can be copied and pasted
+ * into any website to embed the Wysdym chat widget via CDN.
+ *
+ * @param agentId - The unique agent ID for your Wysdym agent
+ * @param opts - Optional configuration for the embed code
+ * @returns HTML script tag string for embedding the widget
+ *
+ * @example
+ * ```ts
+ * import { getEmbedCode } from '@wysdym/agent';
+ *
+ * // Floating widget (default)
+ * const floatingCode = getEmbedCode('your-agent-id');
+ *
+ * // Inline widget in a specific container
+ * const inlineCode = getEmbedCode('your-agent-id', {
+ *   mode: 'inline',
+ *   containerId: 'widget-container'
+ * });
+ * ```
+ */
+export declare function getEmbedCode(agentId: string, opts?: GetEmbedCodeOptions): string;

package/dist/types/agent.d.ts

@@ -0,0 +1,32 @@
+export interface AgentConfig {
+    id: string;
+    company_id: string;
+    name: string;
+    description: string | null;
+    agent_first_message: string;
+    agent_instructions: string | null;
+    elevenlabs_agent_id: string | null;
+    elevenlabs_voice_id: string | null;
+    require_email: boolean;
+    product: string | null;
+    template_id: number | null;
+    primary_color: string | null;
+    secondary_color: string | null;
+    widget_trigger_text: string | null;
+    widget_trigger_button_text: string | null;
+    widget_trigger_button_icon: string | null;
+    email_collection_button_text: string | null;
+    email_collection_button_icon: string | null;
+    force_display_email: boolean;
+}
+export type EmbedMode = 'floating' | 'inline' | 'voice-button';
+export type FloatingPosition = 'bottom-right' | 'bottom-left';
+export type DisplayMode = 'collapsed' | 'expanded' | 'inline' | 'voice-button' | 'fullscreen';
+export interface WidgetAttributes {
+    agentId: string;
+    mode: EmbedMode;
+    position: FloatingPosition;
+    theme: string;
+    expandable: boolean;
+    deferInit: boolean;
+}

package/dist/types/analytics.d.ts

@@ -0,0 +1,75 @@
+export declare enum EventType {
+    WIDGET_OPEN = "widget_open",
+    WIDGET_CLOSE = "widget_close",
+    WIDGET_EXPAND = "widget_expand",
+    WIDGET_COLLAPSE = "widget_collapse",
+    SESSION_START = "session_start",
+    SESSION_END = "session_end",
+    SESSION_ABANDON = "session_abandon",
+    WIDGET_SESSION_CREATED = "widget_session_created",
+    WIDGET_SESSION_PAUSED = "widget_session_paused",
+    WIDGET_SESSION_RESUMED = "widget_session_resumed",
+    WIDGET_SESSION_ENDED = "widget_session_ended",
+    WIDGET_SESSION_ABANDONED = "widget_session_abandoned",
+    WIDGET_PAGE_NAVIGATION = "widget_page_navigation",
+    WIDGET_SESSION_TIMEOUT = "widget_session_timeout",
+    WIDGET_RESUME_PROMPT_SHOWN = "widget_resume_prompt_shown",
+    WIDGET_RESUME_PROMPT_ACCEPTED = "widget_resume_prompt_accepted",
+    WIDGET_RESUME_PROMPT_DECLINED = "widget_resume_prompt_declined",
+    INPUT_MODE_SWITCH = "input_mode_switch",
+    VOICE_MODE_START = "voice_mode_start",
+    VOICE_MODE_END = "voice_mode_end",
+    TEXT_MODE_START = "text_mode_start",
+    MESSAGE_SENT = "message_sent",
+    MESSAGE_RECEIVED = "message_received",
+    VOICE_START_LISTENING = "voice_start_listening",
+    VOICE_STOP_LISTENING = "voice_stop_listening",
+    MICROPHONE_REQUEST = "microphone_request",
+    MICROPHONE_GRANTED = "microphone_granted",
+    MICROPHONE_DENIED = "microphone_denied",
+    CALL_START = "call_start",
+    CALL_END = "call_end",
+    CALL_MUTE = "call_mute",
+    CALL_UNMUTE = "call_unmute",
+    CALL_HOLD = "call_hold",
+    CALL_RESUME = "call_resume",
+    CONNECTION_ERROR = "connection_error",
+    API_ERROR = "api_error",
+    AUDIO_QUALITY_ISSUE = "audio_quality_issue",
+    NETWORK_TIMEOUT = "network_timeout",
+    RESPONSE_LATENCY = "response_latency",
+    PAGE_VISIBLE = "page_visible",
+    PAGE_HIDDEN = "page_hidden",
+    TAB_SWITCH = "tab_switch",
+    WINDOW_FOCUS = "window_focus",
+    WINDOW_BLUR = "window_blur",
+    CTA_DISPLAY = "cta_display",
+    CTA_CLICK = "cta_click",
+    CTA_RETURN = "cta_return",
+    EMAIL_FORM_SHOW = "email_form_show",
+    EMAIL_SUBMIT = "email_submit",
+    EMAIL_SUBMIT_SUCCESS = "email_submit_success",
+    EMAIL_SUBMIT_ERROR = "email_submit_error",
+    AGENT_LOAD_START = "agent_load_start",
+    AGENT_LOAD_SUCCESS = "agent_load_success",
+    AGENT_LOAD_ERROR = "agent_load_error",
+    AGENT_SPEAKING_START = "agent_speaking_start",
+    AGENT_SPEAKING_END = "agent_speaking_end"
+}
+export interface AnalyticsEvent {
+    event_type: string;
+    event_name: string;
+    widget_session_id?: string;
+    registered_agent_id?: string;
+    event_data?: Record<string, any>;
+    event_metadata?: Record<string, any>;
+    response_time_ms?: number;
+    error_code?: string;
+    error_message?: string;
+}
+export interface AnalyticsServiceConfig {
+    baseUrl: string;
+    companyToken: string;
+    agentId: string;
+    sessionId?: string;
+}

package/dist/types/api.d.ts

@@ -0,0 +1,21 @@
+export interface BootstrapResponse {
+    access_token: string;
+    token_type: 'bearer';
+}
+export interface AnalyticsTrackRequest {
+    event_type: string;
+    event_name: string;
+    widget_session_id?: string;
+    registered_agent_id?: string;
+    event_data?: Record<string, unknown>;
+}
+export interface PersonalizedPromptResponse {
+    prompt: string;
+}
+export interface SignedUrlResponse {
+    signed_url: string;
+}
+export interface ApiError {
+    detail: string;
+    status_code: number;
+}

package/dist/types/index.d.ts

@@ -0,0 +1,4 @@
+export * from './agent.ts';
+export * from './session.ts';
+export * from './voice.ts';
+export * from './api.ts';

package/dist/types/session.d.ts

@@ -0,0 +1,55 @@
+export type SessionStatus = 'ACTIVE' | 'PAUSED' | 'RESUMED' | 'ENDED' | 'EXPIRED' | 'ABANDONED';
+export interface SessionIntakeRequest {
+    email?: string;
+    role?: string;
+    company?: string;
+    pain_points?: string;
+    agent_id?: string;
+    needs?: string[];
+    challenges?: string[];
+    anonymous_user_id?: string;
+}
+export interface SessionResponse {
+    id: string | null;
+    session_id: string;
+    company_id: string | null;
+    registered_agent_id: string | null;
+    prospect_id: string | null;
+    started_at: string;
+    ended_at: string | null;
+    prospect_needs: string[] | null;
+    pain_points: string[] | null;
+    linked_past_sessions: string[] | null;
+    widget_jwt: string | null;
+    has_email: boolean | null;
+}
+export interface ChatMessage {
+    id: string;
+    role: 'user' | 'assistant';
+    message: string;
+    created_at: string;
+    tokens_used: number | null;
+    latency_ms: number | null;
+    model: string | null;
+}
+export interface SessionHistoryResponse {
+    session_id: string;
+    messages: ChatMessage[];
+    total_messages: number;
+    started_at: string;
+    status: SessionStatus;
+    has_email: boolean;
+}
+export interface PersistedSession {
+    sessionId: string;
+    widgetJwt: string;
+    agentId: string;
+    status: 'active' | 'paused';
+    lastActivityAt: number;
+    pageUrl: string;
+    conversationState: {
+        messageCount: number;
+        lastMessage: string;
+    };
+    expiresAt: number;
+}

package/dist/types/voice.d.ts

@@ -0,0 +1,33 @@
+export type VoiceState = 'disconnected' | 'connecting' | 'connected' | 'reconnecting' | 'error';
+export interface VoiceConfig {
+    signedUrl: string;
+    agentId: string;
+    sessionId: string;
+    personalizedPrompt?: string;
+}
+export interface TranscriptEntry {
+    role: 'user' | 'agent';
+    text: string;
+    source: 'voice' | 'text';
+    timestamp: number;
+    isFinal: boolean;
+}
+export interface ConnectionHealth {
+    isConnected: boolean;
+    latencyMs: number | null;
+    lastHeartbeat: number | null;
+}
+export type AgentStatus = 'idle' | 'listening' | 'thinking' | 'speaking' | 'calling_tool' | 'using_skill';
+export type Unsubscribe = () => void;
+export interface VoiceProvider {
+    connect(config: VoiceConfig): Promise<void>;
+    disconnect(): void;
+    sendMessage(text: string): void;
+    mute(): void;
+    unmute(): void;
+    isMuted(): boolean;
+    onStateChange(cb: (state: VoiceState) => void): Unsubscribe;
+    onTranscript(cb: (entry: TranscriptEntry) => void): Unsubscribe;
+    onAudioData(cb: (data: Uint8Array) => void): Unsubscribe;
+    getConnectionHealth(): ConnectionHealth;
+}

package/dist/vite.svg

@@ -0,0 +1 @@
+<svg xmlns="http://www.w3.org/2000/svg" xmlns:xlink="http://www.w3.org/1999/xlink" aria-hidden="true" role="img" class="iconify iconify--logos" width="31.88" height="32" preserveAspectRatio="xMidYMid meet" viewBox="0 0 256 257"><defs><linearGradient id="IconifyId1813088fe1fbc01fb466" x1="-.828%" x2="57.636%" y1="7.652%" y2="78.411%"><stop offset="0%" stop-color="#41D1FF"></stop><stop offset="100%" stop-color="#BD34FE"></stop></linearGradient><linearGradient id="IconifyId1813088fe1fbc01fb467" x1="43.376%" x2="50.316%" y1="2.242%" y2="89.03%"><stop offset="0%" stop-color="#FFEA83"></stop><stop offset="8.333%" stop-color="#FFDD35"></stop><stop offset="100%" stop-color="#FFA800"></stop></linearGradient></defs><path fill="url(#IconifyId1813088fe1fbc01fb466)" d="M255.153 37.938L134.897 252.976c-2.483 4.44-8.862 4.466-11.382.048L.875 37.958c-2.746-4.814 1.371-10.646 6.827-9.67l120.385 21.517a6.537 6.537 0 0 0 2.322-.004l117.867-21.483c5.438-.991 9.574 4.796 6.877 9.62Z"></path><path fill="url(#IconifyId1813088fe1fbc01fb467)" d="M185.432.063L96.44 17.501a3.268 3.268 0 0 0-2.634 3.014l-5.474 92.456a3.268 3.268 0 0 0 3.997 3.378l24.777-5.718c2.318-.535 4.413 1.507 3.936 3.838l-7.361 36.047c-.495 2.426 1.782 4.5 4.151 3.78l15.304-4.649c2.372-.72 4.652 1.36 4.15 3.788l-11.698 56.621c-.732 3.542 3.979 5.473 5.943 2.437l1.313-2.028l72.516-144.72c1.215-2.423-.88-5.186-3.54-4.672l-25.505 4.922c-2.396.462-4.435-1.77-3.759-4.114l16.646-57.705c.677-2.35-1.37-4.583-3.769-4.113Z"></path></svg>

package/package.json

@@ -0,0 +1,99 @@
+{
+  "name": "@wysdym/agent",
+  "version": "0.1.0",
+  "type": "module",
+  "main": "./dist/index.cjs.js",
+  "module": "./dist/index.es.js",
+  "types": "./dist/index.d.ts",
+  "exports": {
+    ".": {
+      "types": "./dist/index.d.ts",
+      "import": "./dist/index.es.js",
+      "require": "./dist/index.cjs.js"
+    },
+    "./style.css": "./dist/index.css",
+    "./dist/index.css": "./dist/index.css"
+  },
+  "style": "./dist/index.css",
+  "files": [
+    "dist",
+    "README.md"
+  ],
+  "publishConfig": {
+    "access": "public"
+  },
+  "scripts": {
+    "dev": "vite",
+    "dev:host": "vite --host",
+    "compile:css": "node scripts/compile-css.mjs",
+    "prebuild": "npm run compile:css",
+    "build": "npm run build:cdn && npm run build:lib",
+    "build:cdn": "vite build && node scripts/generate-manifest.js && node scripts/generate-loader.js",
+    "build:lib": "npm run compile:css && vite build --config vite.config.lib.ts",
+    "prepublishOnly": "rm -rf dist && npm run build:lib",
+    "preview": "vite preview",
+    "test": "vitest run src/__tests__/",
+    "test:all": "vitest run",
+    "test:watch": "vitest src/__tests__/",
+    "test:coverage": "vitest run --coverage src/__tests__/",
+    "test:e2e": "playwright test",
+    "test:e2e:ui": "playwright test --ui",
+    "test:e2e:headed": "playwright test --headed",
+    "test:e2e:staging": "E2E_ENV=staging playwright test",
+    "test:e2e:report": "playwright show-report",
+    "lint": "eslint . --ext ts,tsx --report-unused-disable-directives --max-warnings 0",
+    "lint:fix": "eslint . --fix",
+    "type-check": "tsc --noEmit"
+  },
+  "dependencies": {
+    "@elevenlabs/elevenlabs-js": "^2.8.0",
+    "@elevenlabs/react": "^0.6.2",
+    "@radix-ui/react-dialog": "^1.1.14",
+    "@radix-ui/react-icons": "^1.3.2",
+    "@radix-ui/react-popover": "^1.1.14",
+    "clsx": "^2.1.1",
+    "lottie-react": "^2.4.1",
+    "lucide-react": "^0.539.0",
+    "socket.io-client": "^4.8.1",
+    "tailwind-merge": "^3.3.1",
+    "zustand": "^5.0.11"
+  },
+  "devDependencies": {
+    "@eslint/js": "^9.30.1",
+    "@playwright/test": "^1.58.2",
+    "@testing-library/jest-dom": "^6.9.1",
+    "@testing-library/react": "^16.3.0",
+    "@types/node": "^24.0.14",
+    "@types/react": "^19.1.8",
+    "@types/react-dom": "^19.1.6",
+    "@vitejs/plugin-react": "^4.6.0",
+    "@vitest/coverage-v8": "^4.0.18",
+    "autoprefixer": "^10.4.19",
+    "eslint": "^9.30.1",
+    "eslint-plugin-react-hooks": "^5.2.0",
+    "eslint-plugin-react-refresh": "^0.4.20",
+    "globals": "^16.3.0",
+    "jsdom": "^28.1.0",
+    "msw": "^2.12.10",
+    "postcss": "^8.4.38",
+    "tailwindcss": "^3.4.3",
+    "terser": "^5.43.1",
+    "typescript": "~5.8.3",
+    "typescript-eslint": "^8.35.1",
+    "vite": "^7.0.5",
+    "vite-plugin-dts": "^4.5.4",
+    "vitest": "^4.0.18"
+  },
+  "peerDependencies": {
+    "react": ">=18.0.0",
+    "react-dom": ">=18.0.0"
+  },
+  "peerDependenciesMeta": {
+    "react": {
+      "optional": false
+    },
+    "react-dom": {
+      "optional": false
+    }
+  }
+}