@speakai/shared 2.1.4 → 2.1.5

package/dist/voice/interfaces/agent.d.ts

@@ -0,0 +1,246 @@
+/**
+ * Agent Types and Interfaces
+ * Client-facing agent contract shared across backend and client.
+ *
+ * The proprietary agent-generation pipeline types (GenerationMeta/Step/Event,
+ * ExtractedInput, InstructionGapSuggestion, GENERATION_STEP_ORDER/_LABELS,
+ * PromptQuality, …) and the runtime AgentConfig/WorkerConfig live privately in
+ * speak-server (`@speak-voice-generation-internal`) and are intentionally NOT
+ * part of this public package.
+ */
+import { AvatarProvider, TTSProvider, STTProvider } from "../enums/providers.js";
+import { LLMProvider } from "../../enums/llm.js";
+import { AgentStatusType } from "../enums/agent.js";
+import { IntegrationSlug } from "../enums/integration.js";
+import { AgentTelephonySettings } from "./telephony.js";
+/**
+ * Pronunciation rule for TTS providers that support pronunciation dictionaries
+ * (currently ElevenLabs). `term` is the input text to match; `pronounceAs` is the
+ * alias the TTS should speak instead.
+ */
+export interface PronunciationRule {
+    term: string;
+    pronounceAs: string;
+    caseSensitive?: boolean;
+    wordBoundaries?: boolean;
+    type?: "alias" | "phoneme";
+    alphabet?: "cmu-arpabet";
+}
+export type PronunciationAlphabet = "cmu-arpabet" | "respelling";
+export type PronunciationSyncStatus = "synced" | "unsynced" | "failed" | "not_applicable";
+export interface PronunciationSuggestion {
+    phonemes: string;
+    syllable_breakdown: string;
+    confidence: "high" | "medium" | "low";
+}
+export interface PronunciationSuggestionInput {
+    term: string;
+    alphabet: PronunciationAlphabet;
+    hint?: string;
+}
+export interface PronunciationData {
+    rules: PronunciationRule[];
+    syncStatus: PronunciationSyncStatus;
+    syncedAt?: string;
+    elevenLabsDictId?: string;
+    elevenLabsVersionId?: string;
+}
+/**
+ * Widget configuration for embedded agents
+ */
+export interface WidgetConfig {
+    displayMode?: "floating" | "inline";
+    position?: "bottom-left" | "bottom-right";
+    bubbleIconType?: "avatar" | "generic";
+    buttonSize?: "small" | "medium" | "large";
+    buttonColor?: string;
+    theme?: "light" | "dark" | "auto";
+    compactMode?: boolean;
+    defaultMode?: "voice" | "avatar";
+    showAvatar?: boolean;
+    voiceEnabled?: boolean;
+    fontFamily?: string;
+    borderRadius?: number;
+    backgroundColor?: string;
+    enableUserCamera?: boolean;
+    /** When true, the chat panel opens automatically once the agent joins the conversation. Defaults to false. */
+    chatOpenByDefault?: boolean;
+    language?: string;
+    companyLogoUrl?: string;
+    /** Launcher greeting title beside the bubble. Default: "👋 Hi! Want to chat?" */
+    launcherTitle?: string;
+    /** Launcher greeting subtitle beside the bubble. Default: "Start a conversation" */
+    launcherSubtitle?: string;
+    /** Whether the launcher greeting is shown (floating mode only). Default: true */
+    showLauncher?: boolean;
+    /** Title on the pre-start screen. Default: "Ready to start" */
+    beforeCallTitle?: string;
+    /** Description on the pre-start screen. Default: "Tap below to start a quick conversation." */
+    beforeCallDescription?: string;
+    /** Label for the start button. Default: "Start conversation" */
+    startButtonLabel?: string;
+    /** Title on the post-end screen. Default: "Thanks for chatting" */
+    afterCallTitle?: string;
+    /** Description on the post-end screen. Default: "We hope it was useful." */
+    afterCallDescription?: string;
+    /** When true, show the post-call feedback card (stars + comment). Default: false */
+    feedbackEnabled?: boolean;
+}
+/** Subset of WidgetConfig for API update payloads (partial updates) */
+export type WidgetConfigUpdate = Partial<WidgetConfig>;
+/**
+ * Agent share settings
+ */
+export interface AgentShareSettings {
+    isPublic: boolean;
+    shareToken?: string;
+    shortCode?: string;
+    allowedDomains: string[];
+    expiresAt?: string;
+    widgetConfig?: WidgetConfig;
+}
+/**
+ * A single Composio tool selected for an agent.
+ *
+ * The tool's JSON Schema (`paramsSchema`) is persisted at pick-time so the
+ * worker/dispatcher can register the live LiveKit tool without making a
+ * Composio API call. Connections are ORG-scoped (D3): `slug` references an
+ * org-connected app, and `toolName` is the specific Composio tool slug on
+ * that app.
+ */
+export interface AgentSelectedTool {
+    /** The org-connected Composio app this tool belongs to (e.g. IntegrationSlug.GMAIL). */
+    slug: IntegrationSlug;
+    /** Composio tool slug, e.g. "GMAIL_SEND_EMAIL". */
+    toolName: string;
+    /** Human-readable label shown in the UI. */
+    displayName: string;
+    /** The tool's JSON Schema, persisted at pick-time so the worker needs no Composio call. */
+    paramsSchema: Record<string, any>;
+    /** When true, the agent must confirm with the user before invoking (drives the confirm gate). */
+    destructive?: boolean;
+    /**
+     * Provider-side account id (Composio connected-account id) this tool is bound
+     * to. Optional for backwards compatibility; pins the tool to a specific
+     * connected account when multiple accounts exist for the same provider.
+     */
+    providerAccountId?: string;
+    /** Best-effort account email for the bound account (display only; may be absent). */
+    accountEmail?: string;
+}
+/**
+ * Full Agent entity (for client/frontend use)
+ */
+export interface Agent {
+    agentId: string;
+    userId: string;
+    name: string;
+    avatar: {
+        avatarId?: string;
+        avatarUrl?: string;
+        provider?: AvatarProvider;
+        tavusFaceId?: string;
+        tavusPalId?: string;
+    };
+    voice: {
+        provider: TTSProvider;
+        voiceId: string;
+        model?: string;
+        pronunciationRules?: PronunciationRule[];
+        elevenLabsDictId?: string;
+        elevenLabsVersionId?: string;
+        pronunciationSyncedAt?: string;
+        /**
+         * Set to `true` when the most recent ElevenLabs sync attempt failed. The
+         * UI uses this to show a persistent "Sync failed" banner across page
+         * reloads. Cleared on the next successful sync or when rules are cleared.
+         */
+        pronunciationSyncFailed?: boolean;
+    };
+    stt: {
+        provider: STTProvider;
+        model?: string;
+        lexiconTerms?: string[];
+    };
+    llm: {
+        provider: LLMProvider;
+        model?: string;
+    };
+    personality: string;
+    instructions: string;
+    chatSettings: {
+        welcomeMessage: string;
+        conversationStarters: string[];
+        maxResponseLength?: number;
+        topicsToAvoid: string[];
+        maxSessionLength: number;
+        language: string;
+    };
+    knowledgeBaseId?: string;
+    creativityLevel: number;
+    conversationMode: "voice" | "avatar";
+    recordingEnabled?: boolean;
+    status: AgentStatusType;
+    shareSettings: AgentShareSettings;
+    structuredOutputIds?: string[];
+    telephony?: AgentTelephonySettings;
+    conversationCount?: number;
+    websiteUrl?: string;
+    enableWebSearch?: boolean;
+    /** Composio tools (max 3) selected for this agent; enforced backend-side. */
+    selectedTools?: AgentSelectedTool[];
+    createdAt: string;
+    updatedAt: string;
+}
+/**
+ * Request to create a new agent
+ */
+export interface CreateAgentRequest {
+    name: string;
+    avatar?: {
+        avatarId?: string;
+        avatarUrl?: string;
+        provider?: AvatarProvider;
+        tavusFaceId?: string;
+        tavusPalId?: string;
+    };
+    voice: {
+        provider: TTSProvider;
+        voiceId: string;
+        model?: string;
+    };
+    stt?: {
+        provider: STTProvider;
+        model?: string;
+    };
+    llm?: {
+        provider: LLMProvider;
+        model?: string;
+    };
+    personality: string;
+    instructions: string;
+    chatSettings: {
+        welcomeMessage: string;
+        conversationStarters: string[];
+        maxResponseLength?: number;
+        topicsToAvoid: string[];
+        maxSessionLength: number;
+        language: string;
+    };
+    creativityLevel: number;
+}
+export interface AgentResource {
+    resourceId: string;
+    agentId: string;
+    organizationId: string;
+    url: string;
+    title: string;
+    description: string;
+    action: "link" | "presentation";
+    contentType?: "video" | "pdf" | "image";
+    isDeleted?: boolean;
+    deletedAt?: Date;
+    createdAt?: Date;
+    updatedAt?: Date;
+}
+//# sourceMappingURL=agent.d.ts.map

package/dist/voice/interfaces/agent.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"agent.d.ts","sourceRoot":"","sources":["../../../src/voice/interfaces/agent.ts"],"names":[],"mappings":"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"}

package/dist/voice/interfaces/agent.js

@@ -0,0 +1,12 @@
+/**
+ * Agent Types and Interfaces
+ * Client-facing agent contract shared across backend and client.
+ *
+ * The proprietary agent-generation pipeline types (GenerationMeta/Step/Event,
+ * ExtractedInput, InstructionGapSuggestion, GENERATION_STEP_ORDER/_LABELS,
+ * PromptQuality, …) and the runtime AgentConfig/WorkerConfig live privately in
+ * speak-server (`@speak-voice-generation-internal`) and are intentionally NOT
+ * part of this public package.
+ */
+export {};
+//# sourceMappingURL=agent.js.map

package/dist/voice/interfaces/agent.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"agent.js","sourceRoot":"","sources":["../../../src/voice/interfaces/agent.ts"],"names":[],"mappings":"AAAA;;;;;;;;;GASG"}

package/dist/voice/interfaces/analytics.d.ts

@@ -0,0 +1,45 @@
+/**
+ * Analytics Interfaces
+ * Dashboard and reporting aggregations
+ */
+export interface DailyCount {
+    date: string;
+    count: number;
+}
+export interface AnalyticsOverview {
+    totalConversations: number;
+    thisWeekCount: number;
+    lastWeekCount: number;
+    completionRate: number;
+    avgDurationSeconds: number;
+    dailyCounts: DailyCount[];
+}
+export interface EngagementBucket {
+    label: string;
+    minMessages: number;
+    maxMessages: number | null;
+    count: number;
+    percentage: number;
+    avgDurationSeconds: number;
+    sentimentBreakdown: {
+        positive: number;
+        neutral: number;
+        negative: number;
+        unanalyzed: number;
+    };
+}
+export interface EngagementFunnel {
+    buckets: EngagementBucket[];
+    totalConversations: number;
+    since: string | null;
+}
+export interface AgentFunnelSummary {
+    agentId: string;
+    agentName: string;
+    totalConversations: number;
+    bounceRate: number;
+    briefRate: number;
+    engagedRate: number;
+    deepRate: number;
+}
+//# sourceMappingURL=analytics.d.ts.map

package/dist/voice/interfaces/analytics.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"analytics.d.ts","sourceRoot":"","sources":["../../../src/voice/interfaces/analytics.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAEH,MAAM,WAAW,UAAU;IACzB,IAAI,EAAE,MAAM,CAAC;IACb,KAAK,EAAE,MAAM,CAAC;CACf;AAED,MAAM,WAAW,iBAAiB;IAChC,kBAAkB,EAAE,MAAM,CAAC;IAC3B,aAAa,EAAE,MAAM,CAAC;IACtB,aAAa,EAAE,MAAM,CAAC;IACtB,cAAc,EAAE,MAAM,CAAC;IACvB,kBAAkB,EAAE,MAAM,CAAC;IAC3B,WAAW,EAAE,UAAU,EAAE,CAAC;CAC3B;AAED,MAAM,WAAW,gBAAgB;IAC/B,KAAK,EAAE,MAAM,CAAC;IACd,WAAW,EAAE,MAAM,CAAC;IACpB,WAAW,EAAE,MAAM,GAAG,IAAI,CAAC;IAC3B,KAAK,EAAE,MAAM,CAAC;IACd,UAAU,EAAE,MAAM,CAAC;IACnB,kBAAkB,EAAE,MAAM,CAAC;IAC3B,kBAAkB,EAAE;QAClB,QAAQ,EAAE,MAAM,CAAC;QACjB,OAAO,EAAE,MAAM,CAAC;QAChB,QAAQ,EAAE,MAAM,CAAC;QACjB,UAAU,EAAE,MAAM,CAAC;KACpB,CAAC;CACH;AAED,MAAM,WAAW,gBAAgB;IAC/B,OAAO,EAAE,gBAAgB,EAAE,CAAC;IAC5B,kBAAkB,EAAE,MAAM,CAAC;IAC3B,KAAK,EAAE,MAAM,GAAG,IAAI,CAAC;CACtB;AAED,MAAM,WAAW,kBAAkB;IACjC,OAAO,EAAE,MAAM,CAAC;IAChB,SAAS,EAAE,MAAM,CAAC;IAClB,kBAAkB,EAAE,MAAM,CAAC;IAC3B,UAAU,EAAE,MAAM,CAAC;IACnB,SAAS,EAAE,MAAM,CAAC;IAClB,WAAW,EAAE,MAAM,CAAC;IACpB,QAAQ,EAAE,MAAM,CAAC;CAClB"}

package/dist/voice/interfaces/analytics.js

@@ -0,0 +1,6 @@
+/**
+ * Analytics Interfaces
+ * Dashboard and reporting aggregations
+ */
+export {};
+//# sourceMappingURL=analytics.js.map

package/dist/voice/interfaces/analytics.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"analytics.js","sourceRoot":"","sources":["../../../src/voice/interfaces/analytics.ts"],"names":[],"mappings":"AAAA;;;GAGG"}

package/dist/voice/interfaces/avatar.d.ts

@@ -0,0 +1,60 @@
+/**
+ * Avatar Interfaces
+ */
+import { AvatarProvider } from "../enums/providers.js";
+import { AvatarCategory } from "../enums/avatar.js";
+/**
+ * Tavus-specific avatar data
+ */
+export interface TavusAvatarData {
+    faceId: string;
+    palId?: string;
+    status?: "started" | "completed" | "error";
+    trainingProgress?: string;
+    faceType?: "user" | "system";
+    modelType?: string;
+    isRecommended?: boolean;
+}
+/**
+ * Beyond Presence-specific avatar data
+ */
+export interface BeyAvatarData {
+    avatarId: string;
+    gender?: string;
+    ethnicity?: string;
+    ageRange?: string;
+    style?: string;
+    isDefault?: boolean;
+}
+/**
+ * Custom avatar data
+ */
+export interface CustomAvatarData {
+    uploadedBy?: string;
+    originalFileName?: string;
+}
+/**
+ * Avatar entity
+ */
+export interface Avatar {
+    id: string;
+    name: string;
+    imageUrl: string;
+    videoUrl?: string;
+    category: AvatarCategory;
+    isPremium: boolean;
+    provider: AvatarProvider;
+    tavus?: TavusAvatarData;
+    bey?: BeyAvatarData;
+    custom?: CustomAvatarData;
+    metadata?: Record<string, unknown>;
+}
+/**
+ * Avatar list response
+ */
+export interface AvatarListResponse {
+    success: boolean;
+    avatars: Avatar[];
+    total: number;
+}
+//# sourceMappingURL=avatar.d.ts.map

package/dist/voice/interfaces/avatar.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"avatar.d.ts","sourceRoot":"","sources":["../../../src/voice/interfaces/avatar.ts"],"names":[],"mappings":"AAAA;;GAEG;AAEH,OAAO,EAAE,cAAc,EAAE,MAAM,uBAAuB,CAAC;AACvD,OAAO,EAAE,cAAc,EAAE,MAAM,oBAAoB,CAAC;AAEpD;;GAEG;AACH,MAAM,WAAW,eAAe;IAC9B,MAAM,EAAE,MAAM,CAAC;IACf,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,MAAM,CAAC,EAAE,SAAS,GAAG,WAAW,GAAG,OAAO,CAAC;IAC3C,gBAAgB,CAAC,EAAE,MAAM,CAAC;IAC1B,QAAQ,CAAC,EAAE,MAAM,GAAG,QAAQ,CAAC;IAC7B,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,aAAa,CAAC,EAAE,OAAO,CAAC;CACzB;AAED;;GAEG;AACH,MAAM,WAAW,aAAa;IAC5B,QAAQ,EAAE,MAAM,CAAC;IACjB,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,SAAS,CAAC,EAAE,OAAO,CAAC;CACrB;AAED;;GAEG;AACH,MAAM,WAAW,gBAAgB;IAC/B,UAAU,CAAC,EAAE,MAAM,CAAC;IACpB,gBAAgB,CAAC,EAAE,MAAM,CAAC;CAC3B;AAED;;GAEG;AACH,MAAM,WAAW,MAAM;IACrB,EAAE,EAAE,MAAM,CAAC;IACX,IAAI,EAAE,MAAM,CAAC;IACb,QAAQ,EAAE,MAAM,CAAC;IACjB,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB,QAAQ,EAAE,cAAc,CAAC;IACzB,SAAS,EAAE,OAAO,CAAC;IACnB,QAAQ,EAAE,cAAc,CAAC;IACzB,KAAK,CAAC,EAAE,eAAe,CAAC;IACxB,GAAG,CAAC,EAAE,aAAa,CAAC;IACpB,MAAM,CAAC,EAAE,gBAAgB,CAAC;IAC1B,QAAQ,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;CACpC;AAED;;GAEG;AACH,MAAM,WAAW,kBAAkB;IACjC,OAAO,EAAE,OAAO,CAAC;IACjB,OAAO,EAAE,MAAM,EAAE,CAAC;IAClB,KAAK,EAAE,MAAM,CAAC;CACf"}

package/dist/voice/interfaces/avatar.js

@@ -0,0 +1,5 @@
+/**
+ * Avatar Interfaces
+ */
+export {};
+//# sourceMappingURL=avatar.js.map

package/dist/voice/interfaces/avatar.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"avatar.js","sourceRoot":"","sources":["../../../src/voice/interfaces/avatar.ts"],"names":[],"mappings":"AAAA;;GAEG"}

package/dist/voice/interfaces/billing.d.ts

@@ -0,0 +1,130 @@
+/**
+ * Billing Interfaces
+ * Usage metrics, cost tracking, and transaction records.
+ */
+import { TransactionEventType } from "../enums/billing.js";
+/**
+ * Usage metrics tracked per conversation event
+ * Fields align with LiveKit Agents SDK metric types
+ */
+export interface UsageMetrics {
+    llm?: {
+        provider: string;
+        model: string;
+        inputTokens: number;
+        outputTokens: number;
+        cachedTokens?: number;
+        totalTokens: number;
+        latency?: number;
+        completionDuration?: number;
+        tokensPerSecond?: number;
+        speechId?: string;
+        cancelled?: boolean;
+    };
+    tts?: {
+        provider: string;
+        voice: string;
+        characters: number;
+        duration?: number;
+        latency?: number;
+        generationDuration?: number;
+        speechId?: string;
+        isStreaming?: boolean;
+        cancelled?: boolean;
+    };
+    stt?: {
+        provider: string;
+        duration?: number;
+        latency?: number;
+        processingDuration?: number;
+        isStreaming?: boolean;
+        endOfUtteranceDelay?: number;
+        onUserTurnCompletedDelay?: number;
+        speechId?: string;
+    };
+    avatar?: {
+        provider: string;
+        duration?: number;
+        frames?: number;
+        latency?: number;
+    };
+    telephony?: {
+        provider: string;
+        duration?: number;
+        billedMinutes?: number;
+    };
+}
+/**
+ * Cost breakdown for a conversation
+ */
+export interface CostBreakdown {
+    llmCost: number;
+    ttsCost: number;
+    sttCost: number;
+    avatarCost: number;
+    telephonyCost?: number;
+    platformCost: number;
+    totalCost: number;
+}
+/**
+ * User credits balance
+ */
+export interface Credits {
+    totalCredits: number;
+    usedCredits: number;
+    availableCredits: number;
+    orgId: string;
+}
+/**
+ * Transaction record (API-facing)
+ */
+export interface Transaction {
+    transactionId: string;
+    conversationId: string;
+    agentId: string;
+    orgId: string;
+    eventType: TransactionEventType;
+    timestamp: string;
+    costs: {
+        totalCost: number;
+        llmCost: number;
+        ttsCost: number;
+        sttCost: number;
+        avatarCost: number;
+        telephonyCost: number;
+    };
+    metadata?: {
+        durationMinutes?: number;
+    };
+    status: string;
+}
+/**
+ * Billing statistics
+ */
+export interface BillingStats {
+    totalSpend: number;
+    todaySpend: number;
+    availableCredits: number;
+}
+/**
+ * Pricing information
+ */
+export interface Pricing {
+    perMinute: number;
+    version: string;
+}
+/**
+ * Conversation cost summary
+ */
+export interface ConversationCost {
+    conversationId: string;
+    totalCost: number;
+    llmCost: number;
+    ttsCost: number;
+    sttCost: number;
+    avatarCost: number;
+    telephonyCost?: number;
+    transactionCount: number;
+    durationMinutes?: number;
+}
+//# sourceMappingURL=billing.d.ts.map

package/dist/voice/interfaces/billing.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"billing.d.ts","sourceRoot":"","sources":["../../../src/voice/interfaces/billing.ts"],"names":[],"mappings":"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"}

package/dist/voice/interfaces/billing.js

@@ -0,0 +1,6 @@
+/**
+ * Billing Interfaces
+ * Usage metrics, cost tracking, and transaction records.
+ */
+export {};
+//# sourceMappingURL=billing.js.map

package/dist/voice/interfaces/billing.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"billing.js","sourceRoot":"","sources":["../../../src/voice/interfaces/billing.ts"],"names":[],"mappings":"AAAA;;;GAGG"}