@tavus/widget 0.12.0 → 0.14.0

package/dist/integration.d.ts

@@ -1,3 +1,5 @@
+import { StartConversationOptions } from './host-types.ts';
+export type { StartConversationOptions } from './host-types.ts';
 export type TavusInteraction = {
     event_type: "conversation.echo";
     properties: {
@@ -23,13 +25,17 @@ export type TavusInteraction = {
         context: string;
     };
 };
-export type TavusEventName = "tavus:ready" | "tavus:conversation-started" | "tavus:conversation-ended" | "tavus:error" | "tavus:state-change" | "tavus:chat-message"
+export type TavusEventName = "tavus:ready" | "tavus:conversation-created" | "tavus:conversation-started" | "tavus:conversation-ended" | "tavus:error" | "tavus:state-change" | "tavus:chat-message"
 /** Retained for type-back-compat; never emitted at runtime. */
  | "tavus:message" | "tavus:protocol-message" | "tavus:tool-call" | "tavus:mode-change";
 export interface TavusEventMap {
     "tavus:ready": {
         deploymentId: string;
     };
+    /** The room exists and the replica is warming up; nobody has joined yet. */
+    "tavus:conversation-created": {
+        conversationId: string;
+    };
     "tavus:conversation-started": {
         conversationId: string;
     };
@@ -59,6 +65,28 @@ export interface TavusEventMap {
     };
 }
 export declare const TAVUS_EVENT_NAMES: TavusEventName[];
+interface TavusElementTavusApi {
+    start?: () => Promise<void>;
+    end?: () => Promise<void>;
+    sendChat?: (text: string) => void;
+    sendMessage?: (interaction: TavusInteraction) => void;
+}
+export interface TavusElement extends HTMLElement {
+    open?: () => void;
+    close?: () => void;
+    /** Creates the room without joining it; the next start joins it. Rejects on failure. */
+    createConversation?: () => Promise<{
+        conversationId: string;
+    }>;
+    /** Resolves even when the start fails — failures arrive as `tavus:error`. */
+    startConversation?: (options?: StartConversationOptions) => Promise<void>;
+    endConversation?: () => Promise<void>;
+    /** Legacy string-based send; prefer el.tavus.sendMessage for typed interactions. */
+    sendMessage?: (input: TavusInteraction | string) => void;
+    updateConfig?: (config: Record<string, unknown>) => void;
+    destroy?: () => void;
+    tavus?: TavusElementTavusApi;
+}
 export declare class TavusIntegration {
     private element;
     private tagName;
@@ -66,7 +94,16 @@ export declare class TavusIntegration {
     private getElement;
     open(): void;
     close(): void;
-    startConversation(): void;
+    /**
+     * Create the conversation now and join it on the next `startConversation()`.
+     * Lets the replica warm up while the visitor is still on the preview or the
+     * host's own haircheck. Rejects when the room could not be created; a later
+     * start then creates one as usual.
+     */
+    createConversation(): Promise<{
+        conversationId: string;
+    }>;
+    startConversation(options?: StartConversationOptions): void;
     endConversation(): void;
     /**
      * Send a typed interaction or a plain text string (back-compat shim).

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@tavus/widget",
-  "version": "0.12.0",
+  "version": "0.14.0",
   "description": "Tavus conversational video AI <tavus-widget> launcher custom element for the web.",
   "keywords": [
     "ai",