@elevenlabs/react 0.8.1 → 0.9.1

package/.turbo/turbo-build.log

@@ -1,22 +1,22 @@
 
-> @elevenlabs/react@0.8.1 prebuild /home/runner/work/packages/packages/packages/react
+> @elevenlabs/react@0.9.1 prebuild /home/runner/work/packages/packages/packages/react
 > npm run generate-version
 
 
-> @elevenlabs/react@0.8.1 generate-version
+> @elevenlabs/react@0.9.1 generate-version
 > printf "// This file is auto-generated during build\nexport const PACKAGE_VERSION = \"%s\";\n" "$npm_package_version" > src/version.ts
 
 
-> @elevenlabs/react@0.8.1 build /home/runner/work/packages/packages/packages/react
+> @elevenlabs/react@0.9.1 build /home/runner/work/packages/packages/packages/react
 > BROWSERSLIST_ENV=modern microbundle --jsx React.createElement --jsxFragment React.Fragment --jsxImportSource react src/index.ts
 
 No name was provided for external module '@elevenlabs/client' in output.globals – guessing 'client'
 Build "@elevenlabs/react" to dist:
-      2.02 kB: lib.cjs.gz
-      1.79 kB: lib.cjs.br
-      1.78 kB: lib.modern.js.gz
-      1.57 kB: lib.modern.js.br
-         2 kB: lib.module.js.gz
-      1.78 kB: lib.module.js.br
-       2.1 kB: lib.umd.js.gz
-      1.86 kB: lib.umd.js.br
+      3.18 kB: lib.cjs.gz
+      2.81 kB: lib.cjs.br
+      2.87 kB: lib.modern.js.gz
+      2.52 kB: lib.modern.js.br
+      3.14 kB: lib.module.js.gz
+      2.78 kB: lib.module.js.br
+      3.24 kB: lib.umd.js.gz
+      2.87 kB: lib.umd.js.br

package/.turbo/turbo-generate-version.log

@@ -1,4 +1,4 @@
 
-> @elevenlabs/react@0.8.1 generate-version /home/runner/work/packages/packages/packages/react
+> @elevenlabs/react@0.9.1 generate-version /home/runner/work/packages/packages/packages/react
 > printf "// This file is auto-generated during build\nexport const PACKAGE_VERSION = \"%s\";\n" "$npm_package_version" > src/version.ts
 

package/README.md

@@ -525,6 +525,499 @@ const { canSendFeedback } = useConversation();
 console.log(canSendFeedback); // boolean
 ```
 
+### useScribe
+
+React hook for managing real-time speech-to-text transcription with ElevenLabs Scribe Realtime v2.
+
+**Note:** Scribe Realtime v2 is currently in closed beta. For access please [contact sales](https://elevenlabs.io/contact-sales).
+
+#### Quick Start
+
+```tsx
+import { useScribe } from "@elevenlabs/react";
+
+function MyComponent() {
+  const scribe = useScribe({
+    modelId: "scribe_realtime_v2",
+    onPartialTranscript: (data) => {
+      console.log("Partial:", data.text);
+    },
+    onFinalTranscript: (data) => {
+      console.log("Final:", data.text);
+    },
+  });
+
+  const handleStart = async () => {
+    const token = await fetchTokenFromServer();
+    await scribe.connect({
+      token,
+      microphone: {
+        echoCancellation: true,
+        noiseSuppression: true,
+      },
+    });
+  };
+
+  return (
+    <div>
+      <button onClick={handleStart} disabled={scribe.isConnected}>
+        Start Recording
+      </button>
+      <button onClick={scribe.disconnect} disabled={!scribe.isConnected}>
+        Stop
+      </button>
+
+      {scribe.partialTranscript && <p>Live: {scribe.partialTranscript}</p>}
+
+      <div>
+        {scribe.finalTranscripts.map((t) => (
+          <p key={t.id}>{t.text}</p>
+        ))}
+      </div>
+    </div>
+  );
+}
+```
+
+#### Getting a Token
+
+Scribe requires a single-use token for authentication. Create an API endpoint on your server:
+
+```js
+// Node.js server
+app.get("/scribe-token", yourAuthMiddleware, async (req, res) => {
+  const response = await fetch(
+    "https://api.elevenlabs.io/v1/single-use-token/realtime_scribe",
+    {
+      headers: {
+        "xi-api-key": process.env.ELEVENLABS_API_KEY,
+      },
+    }
+  );
+
+  const data = await response.json();
+  res.json({ token: data.token });
+});
+```
+
+**Warning:** Your ElevenLabs API key is sensitive, do not leak it to the client. Always generate the token on the server.
+
+```tsx
+// Client
+const fetchToken = async () => {
+  const response = await fetch("/scribe-token");
+  const { token } = await response.json();
+  return token;
+};
+```
+
+#### Hook Options
+
+Configure the hook with default options and callbacks:
+
+```tsx
+const scribe = useScribe({
+  // Connection options (can be overridden in connect())
+  token: "optional-default-token",
+  modelId: "scribe_realtime_v2",
+  baseUri: "wss://api.elevenlabs.io",
+
+  // VAD options
+  commitStrategy: CommitStrategy.AUTOMATIC,
+  vadSilenceThresholdSecs: 0.5,
+  vadThreshold: 0.5,
+  minSpeechDurationMs: 100,
+  minSilenceDurationMs: 500,
+  languageCode: "en",
+
+  // Microphone options (for automatic mode)
+  microphone: {
+    deviceId: "optional-device-id",
+    echoCancellation: true,
+    noiseSuppression: true,
+    autoGainControl: true,
+  },
+
+  // Manual audio options (for file transcription)
+  audioFormat: AudioFormat.PCM_16000,
+  sampleRate: 16000,
+
+  // Auto-connect on mount
+  autoConnect: false,
+
+  // Event callbacks
+  onSessionStarted: () => console.log("Session started"),
+  onPartialTranscript: (data) => console.log("Partial:", data.text),
+  onFinalTranscript: (data) => console.log("Final:", data.text),
+  onFinalTranscriptWithTimestamps: (data) => console.log("With timestamps:", data),
+  onError: (error) => console.error("Error:", error),
+  onAuthError: (data) => console.error("Auth error:", data.error),
+  onConnect: () => console.log("Connected"),
+  onDisconnect: () => console.log("Disconnected"),
+});
+```
+
+#### Microphone Mode
+
+Stream audio directly from the user's microphone:
+
+```tsx
+function MicrophoneTranscription() {
+  const scribe = useScribe({
+    modelId: "scribe_realtime_v2",
+  });
+
+  const startRecording = async () => {
+    const token = await fetchToken();
+    await scribe.connect({
+      token,
+      microphone: {
+        echoCancellation: true,
+        noiseSuppression: true,
+        autoGainControl: true,
+      },
+    });
+  };
+
+  return (
+    <div>
+      <button onClick={startRecording} disabled={scribe.isConnected}>
+        {scribe.status === "connecting" ? "Connecting..." : "Start"}
+      </button>
+      <button onClick={scribe.disconnect} disabled={!scribe.isConnected}>
+        Stop
+      </button>
+
+      {scribe.partialTranscript && (
+        <div>
+          <strong>Speaking:</strong> {scribe.partialTranscript}
+        </div>
+      )}
+
+      {scribe.finalTranscripts.map((transcript) => (
+        <div key={transcript.id}>{transcript.text}</div>
+      ))}
+    </div>
+  );
+}
+```
+
+#### Manual Audio Mode (File Transcription)
+
+Transcribe pre-recorded audio files:
+
+```tsx
+import { useScribe, AudioFormat } from "@elevenlabs/react";
+
+function FileTranscription() {
+  const [file, setFile] = useState<File | null>(null);
+  const scribe = useScribe({
+    modelId: "scribe_realtime_v2",
+    audioFormat: AudioFormat.PCM_16000,
+    sampleRate: 16000,
+  });
+
+  const transcribeFile = async () => {
+    if (!file) return;
+
+    const token = await fetchToken();
+    await scribe.connect({ token });
+
+    // Decode audio file
+    const arrayBuffer = await file.arrayBuffer();
+    const audioContext = new AudioContext({ sampleRate: 16000 });
+    const audioBuffer = await audioContext.decodeAudioData(arrayBuffer);
+
+    // Convert to PCM16
+    const channelData = audioBuffer.getChannelData(0);
+    const pcmData = new Int16Array(channelData.length);
+
+    for (let i = 0; i < channelData.length; i++) {
+      const sample = Math.max(-1, Math.min(1, channelData[i]));
+      pcmData[i] = sample < 0 ? sample * 32768 : sample * 32767;
+    }
+
+    // Send in chunks
+    const chunkSize = 4096;
+    for (let offset = 0; offset < pcmData.length; offset += chunkSize) {
+      const chunk = pcmData.slice(offset, offset + chunkSize);
+      const bytes = new Uint8Array(chunk.buffer);
+      const base64 = btoa(String.fromCharCode(...bytes));
+
+      scribe.sendAudio(base64);
+      await new Promise((resolve) => setTimeout(resolve, 50));
+    }
+
+    // Commit transcription
+    scribe.commit();
+  };
+
+  return (
+    <div>
+      <input
+        type="file"
+        accept="audio/*"
+        onChange={(e) => setFile(e.target.files?.[0] || null)}
+      />
+      <button onClick={transcribeFile} disabled={!file || scribe.isConnected}>
+        Transcribe
+      </button>
+
+      {scribe.finalTranscripts.map((transcript) => (
+        <div key={transcript.id}>{transcript.text}</div>
+      ))}
+    </div>
+  );
+}
+```
+
+#### Hook Return Values
+
+##### State
+
+- **status** - Current connection status: `"disconnected"`, `"connecting"`, `"connected"`, `"transcribing"`, or `"error"`
+- **isConnected** - Boolean indicating if connected
+- **isTranscribing** - Boolean indicating if actively transcribing
+- **partialTranscript** - Current partial (interim) transcript
+- **finalTranscripts** - Array of completed transcript segments
+- **error** - Current error message, or null
+
+```tsx
+const scribe = useScribe(/* options */);
+
+console.log(scribe.status); // "connected"
+console.log(scribe.isConnected); // true
+console.log(scribe.partialTranscript); // "hello world"
+console.log(scribe.finalTranscripts); // [{ id: "...", text: "...", timestamp: ..., isFinal: true }]
+console.log(scribe.error); // null or error string
+```
+
+##### Methods
+
+###### connect(options?)
+
+Connect to Scribe. Options provided here override hook defaults:
+
+```tsx
+await scribe.connect({
+  token: "your-token", // Required
+  microphone: { /* ... */ }, // For microphone mode
+  // OR
+  audioFormat: AudioFormat.PCM_16000, // For manual mode
+  sampleRate: 16000,
+});
+```
+
+###### disconnect()
+
+Disconnect and clean up resources:
+
+```tsx
+scribe.disconnect();
+```
+
+###### sendAudio(audioBase64, options?)
+
+Send audio data (manual mode only):
+
+```tsx
+scribe.sendAudio(base64AudioChunk, {
+  commit: false, // Optional: commit immediately
+  sampleRate: 16000, // Optional: override sample rate
+});
+```
+
+###### commit()
+
+Manually commit the current transcription:
+
+```tsx
+scribe.commit();
+```
+
+###### clearTranscripts()
+
+Clear all transcripts from state:
+
+```tsx
+scribe.clearTranscripts();
+```
+
+###### getConnection()
+
+Get the underlying connection instance:
+
+```tsx
+const connection = scribe.getConnection();
+// Returns RealtimeConnection | null
+```
+
+#### Transcript Segment Type
+
+Each final transcript segment has the following structure:
+
+```typescript
+interface TranscriptSegment {
+  id: string; // Unique identifier
+  text: string; // Transcript text
+  timestamp: number; // Unix timestamp
+  isFinal: boolean; // Always true for final transcripts
+}
+```
+
+#### Event Callbacks
+
+All event callbacks are optional and can be provided as hook options:
+
+```tsx
+const scribe = useScribe({
+  onSessionStarted: () => {
+    console.log("Session started");
+  },
+  onPartialTranscript: (data: { text: string }) => {
+    console.log("Partial:", data.text);
+  },
+  onFinalTranscript: (data: { text: string }) => {
+    console.log("Final:", data.text);
+  },
+  onFinalTranscriptWithTimestamps: (data: {
+    text: string;
+    timestamps?: { start: number; end: number }[];
+  }) => {
+    console.log("Text:", data.text);
+    console.log("Word timestamps:", data.timestamps);
+  },
+  onError: (error: Error | Event) => {
+    console.error("Connection error:", error);
+  },
+  onAuthError: (data: { error: string }) => {
+    console.error("Auth error:", data.error);
+  },
+  onConnect: () => {
+    console.log("WebSocket opened");
+  },
+  onDisconnect: () => {
+    console.log("WebSocket closed");
+  },
+});
+```
+
+#### Commit Strategies
+
+Control when transcriptions are finalized:
+
+```tsx
+import { CommitStrategy } from "@elevenlabs/react";
+
+// Automatic (default) - API detects speech end
+const scribe = useScribe({
+  commitStrategy: CommitStrategy.AUTOMATIC,
+});
+
+// Manual - you control when to commit
+const scribe = useScribe({
+  commitStrategy: CommitStrategy.MANUAL,
+});
+
+// Later...
+scribe.commit(); // Finalize transcription
+```
+
+#### Complete Example
+
+```tsx
+import { useScribe, AudioFormat, CommitStrategy } from "@elevenlabs/react";
+import { useState } from "react";
+
+function ScribeDemo() {
+  const [mode, setMode] = useState<"microphone" | "file">("microphone");
+
+  const scribe = useScribe({
+    modelId: "scribe_realtime_v2",
+    commitStrategy: CommitStrategy.AUTOMATIC,
+    onSessionStarted: () => console.log("Started"),
+    onFinalTranscript: (data) => console.log("Final:", data.text),
+    onError: (error) => console.error("Error:", error),
+  });
+
+  const startMicrophone = async () => {
+    const token = await fetchToken();
+    await scribe.connect({
+      token,
+      microphone: {
+        echoCancellation: true,
+        noiseSuppression: true,
+      },
+    });
+  };
+
+  return (
+    <div>
+      <h1>Scribe Demo</h1>
+
+      {/* Status */}
+      <div>
+        Status: {scribe.status}
+        {scribe.error && <span>Error: {scribe.error}</span>}
+      </div>
+
+      {/* Controls */}
+      <div>
+        {!scribe.isConnected ? (
+          <button onClick={startMicrophone}>Start Recording</button>
+        ) : (
+          <button onClick={scribe.disconnect}>Stop</button>
+        )}
+        <button onClick={scribe.clearTranscripts}>Clear</button>
+      </div>
+
+      {/* Live Transcript */}
+      {scribe.partialTranscript && (
+        <div>
+          <strong>Live:</strong> {scribe.partialTranscript}
+        </div>
+      )}
+
+      {/* Final Transcripts */}
+      <div>
+        <h2>Transcripts ({scribe.finalTranscripts.length})</h2>
+        {scribe.finalTranscripts.map((t) => (
+          <div key={t.id}>
+            <span>{new Date(t.timestamp).toLocaleTimeString()}</span>
+            <p>{t.text}</p>
+          </div>
+        ))}
+      </div>
+    </div>
+  );
+}
+```
+
+#### TypeScript Support
+
+Full TypeScript types are included:
+
+```typescript
+import {
+  useScribe,
+  AudioFormat,
+  CommitStrategy,
+  RealtimeEvents,
+  type UseScribeReturn,
+  type ScribeHookOptions,
+  type ScribeStatus,
+  type TranscriptSegment,
+  type RealtimeConnection,
+} from "@elevenlabs/react";
+
+const scribe: UseScribeReturn = useScribe({
+  modelId: "scribe_realtime_v2",
+  microphone: {
+    echoCancellation: true,
+  },
+});
+```
+
 ## CSP compliance
 
 If your application has a tight Content Security Policy and does not allow data: or blob: in the `script-src` (w3.org/TR/CSP2#source-list-guid-matching), you self-host the needed files in the public folder.

package/dist/index.d.ts

@@ -14,6 +14,8 @@ export declare function getOriginForLocation(location: Location): string;
 export declare function getLivekitUrlForLocation(location: Location): string;
 export type { Role, Mode, Status, SessionConfig, DisconnectionDetails, Language, VadScoreEvent, InputConfig, FormatConfig, VoiceConversation, TextConversation, Callbacks, } from "@elevenlabs/client";
 export { postOverallFeedback } from "@elevenlabs/client";
+export { useScribe, AudioFormat, CommitStrategy, RealtimeEvents, } from "./scribe";
+export type { ScribeStatus, TranscriptSegment, ScribeCallbacks, ScribeHookOptions, UseScribeReturn, RealtimeConnection, } from "./scribe";
 export type HookOptions = Partial<SessionConfig & HookCallbacks & ClientToolsConfig & InputConfig & OutputConfig & AudioWorkletConfig & FormatConfig & {
     serverLocation?: Location | string;
 }>;

package/dist/lib.cjs

@@ -1,2 +1,2 @@
-var n=require("react"),e=require("@elevenlabs/client");function t(){return t=Object.assign?Object.assign.bind():function(n){for(var e=1;e<arguments.length;e++){var t=arguments[e];for(var r in t)({}).hasOwnProperty.call(t,r)&&(n[r]=t[r])}return n},t.apply(null,arguments)}var r=["micMuted","volume","serverLocation"];function o(n){switch(void 0===n&&(n="us"),n){case"eu-residency":case"in-residency":case"us":case"global":return n;default:return console.warn("[ConversationalAI] Invalid server-location: "+n+'. Defaulting to "us"'),"us"}}function u(n){return{us:"wss://api.elevenlabs.io","eu-residency":"wss://api.eu.residency.elevenlabs.io","in-residency":"wss://api.in.residency.elevenlabs.io",global:"wss://api.elevenlabs.io"}[n]}function l(n){return{us:"wss://livekit.rtc.elevenlabs.io","eu-residency":"wss://livekit.rtc.eu.residency.elevenlabs.io","in-residency":"wss://livekit.rtc.in.residency.elevenlabs.io",global:"wss://livekit.rtc.elevenlabs.io"}[n]}Object.defineProperty(exports,"postOverallFeedback",{enumerable:!0,get:function(){return e.postOverallFeedback}}),exports.getLivekitUrlForLocation=l,exports.getOriginForLocation=u,exports.parseLocation=o,exports.useConversation=function(i){void 0===i&&(i={});var s=i.micMuted,c=i.volume,a=i.serverLocation,v=function(n,e){if(null==n)return{};var t={};for(var r in n)if({}.hasOwnProperty.call(n,r)){if(-1!==e.indexOf(r))continue;t[r]=n[r]}return t}(i,r),d=n.useRef(null),f=n.useRef(null),g=n.useState("disconnected"),p=g[0],h=g[1],C=n.useState(!1),b=C[0],m=C[1],y=n.useState("listening"),M=y[0],P=y[1],S=n.useRef(s),I=n.useRef(c);return S.current=s,I.current=c,n.useEffect(function(){var n;void 0!==s&&(null==d||null==(n=d.current)||n.setMicMuted(s))},[s]),n.useEffect(function(){var n;void 0!==c&&(null==d||null==(n=d.current)||n.setVolume({volume:c}))},[c]),n.useEffect(function(){return function(){var n;null==(n=d.current)||n.endSession()}},[]),{startSession:function(n){try{var r,i,s=function(r){return i?r:function(r,i){try{var s=(O=u(A=o((null==n?void 0:n.serverLocation)||a)),F=l(A),f.current=e.Conversation.startSession(t({},null!=v?v:{},null!=n?n:{},{origin:O,livekitUrl:F,overrides:t({},null!=(c=null==v?void 0:v.overrides)?c:{},null!=(g=null==n?void 0:n.overrides)?g:{},{client:t({},null!=(p=null==v||null==(C=v.overrides)?void 0:C.client)?p:{},null!=(b=null==n||null==(y=n.overrides)?void 0:y.client)?b:{},{source:(null==n||null==(M=n.overrides)||null==(M=M.client)?void 0:M.source)||(null==v||null==(k=v.overrides)||null==(k=k.client)?void 0:k.source)||"react_sdk",version:(null==n||null==(w=n.overrides)||null==(w=w.client)?void 0:w.version)||(null==v||null==(D=v.overrides)||null==(D=D.client)?void 0:D.version)||"0.8.1"})}),onConnect:(null==n?void 0:n.onConnect)||(null==v?void 0:v.onConnect),onDisconnect:(null==n?void 0:n.onDisconnect)||(null==v?void 0:v.onDisconnect),onError:(null==n?void 0:n.onError)||(null==v?void 0:v.onError),onMessage:(null==n?void 0:n.onMessage)||(null==v?void 0:v.onMessage),onAudio:(null==n?void 0:n.onAudio)||(null==v?void 0:v.onAudio),onDebug:(null==n?void 0:n.onDebug)||(null==v?void 0:v.onDebug),onUnhandledClientToolCall:(null==n?void 0:n.onUnhandledClientToolCall)||(null==v?void 0:v.onUnhandledClientToolCall),onVadScore:(null==n?void 0:n.onVadScore)||(null==v?void 0:v.onVadScore),onInterruption:(null==n?void 0:n.onInterruption)||(null==v?void 0:v.onInterruption),onAgentToolResponse:(null==n?void 0:n.onAgentToolResponse)||(null==v?void 0:v.onAgentToolResponse),onConversationMetadata:(null==n?void 0:n.onConversationMetadata)||(null==v?void 0:v.onConversationMetadata),onMCPToolCall:(null==n?void 0:n.onMCPToolCall)||(null==v?void 0:v.onMCPToolCall),onMCPConnectionStatus:(null==n?void 0:n.onMCPConnectionStatus)||(null==v?void 0:v.onMCPConnectionStatus),onAsrInitiationMetadata:(null==n?void 0:n.onAsrInitiationMetadata)||(null==v?void 0:v.onAsrInitiationMetadata),onAgentChatResponsePart:(null==n?void 0:n.onAgentChatResponsePart)||(null==v?void 0:v.onAgentChatResponsePart),onModeChange:function(e){var t,r=e.mode;P(r),null==(t=(null==n?void 0:n.onModeChange)||(null==v?void 0:v.onModeChange))||t({mode:r})},onStatusChange:function(e){var t,r=e.status;h(r),null==(t=(null==n?void 0:n.onStatusChange)||(null==v?void 0:v.onStatusChange))||t({status:r})},onCanSendFeedbackChange:function(e){var t,r=e.canSendFeedback;m(r),null==(t=(null==n?void 0:n.onCanSendFeedbackChange)||(null==v?void 0:v.onCanSendFeedbackChange))||t({canSendFeedback:r})}})),Promise.resolve(f.current).then(function(n){return d.current=n,void 0!==S.current&&d.current.setMicMuted(S.current),void 0!==I.current&&d.current.setVolume({volume:I.current}),d.current.getId()}))}catch(n){return i(!0,n)}var c,g,p,C,b,y,M,k,w,D,A,O,F;return s&&s.then?s.then(i.bind(null,!1),i.bind(null,!0)):i(!1,s)}(0,function(n,e){if(f.current=null,n)throw e;return e})};if(null!=(r=d.current)&&r.isOpen())return Promise.resolve(d.current.getId());var c=function(){if(f.current)return Promise.resolve(f.current).then(function(n){var e=n.getId();return i=1,e})}();return Promise.resolve(c&&c.then?c.then(s):s(c))}catch(n){return Promise.reject(n)}},endSession:function(){try{var n=d.current;return d.current=null,Promise.resolve(null==n?void 0:n.endSession()).then(function(){})}catch(n){return Promise.reject(n)}},setVolume:function(n){var e;null==(e=d.current)||e.setVolume({volume:n.volume})},getInputByteFrequencyData:function(){var n;return null==(n=d.current)?void 0:n.getInputByteFrequencyData()},getOutputByteFrequencyData:function(){var n;return null==(n=d.current)?void 0:n.getOutputByteFrequencyData()},getInputVolume:function(){var n,e;return null!=(n=null==(e=d.current)?void 0:e.getInputVolume())?n:0},getOutputVolume:function(){var n,e;return null!=(n=null==(e=d.current)?void 0:e.getOutputVolume())?n:0},sendFeedback:function(n){var e;null==(e=d.current)||e.sendFeedback(n)},getId:function(){var n;return null==(n=d.current)?void 0:n.getId()},sendContextualUpdate:function(n){var e;null==(e=d.current)||e.sendContextualUpdate(n)},sendUserMessage:function(n){var e;null==(e=d.current)||e.sendUserMessage(n)},sendUserActivity:function(){var n;null==(n=d.current)||n.sendUserActivity()},sendMCPToolApprovalResult:function(n,e){var t;null==(t=d.current)||t.sendMCPToolApprovalResult(n,e)},changeInputDevice:function(n){try{var e,t=function(n){if(e)return n;throw new Error("Device switching is only available for voice conversations")},r=function(){if(d.current&&"changeInputDevice"in d.current)return Promise.resolve(d.current.changeInputDevice(n)).then(function(n){return e=1,n})}();return Promise.resolve(r&&r.then?r.then(t):t(r))}catch(n){return Promise.reject(n)}},changeOutputDevice:function(n){try{var e,t=function(n){if(e)return n;throw new Error("Device switching is only available for voice conversations")},r=function(){if(d.current&&"changeOutputDevice"in d.current)return Promise.resolve(d.current.changeOutputDevice(n)).then(function(n){return e=1,n})}();return Promise.resolve(r&&r.then?r.then(t):t(r))}catch(n){return Promise.reject(n)}},status:p,canSendFeedback:b,micMuted:s,isSpeaking:"speaking"===M}};
+var e=require("react"),n=require("@elevenlabs/client");function t(){return t=Object.assign?Object.assign.bind():function(e){for(var n=1;n<arguments.length;n++){var t=arguments[n];for(var r in t)({}).hasOwnProperty.call(t,r)&&(e[r]=t[r])}return e},t.apply(null,arguments)}var r=["micMuted","volume","serverLocation"];function o(e){switch(void 0===e&&(e="us"),e){case"eu-residency":case"in-residency":case"us":case"global":return e;default:return console.warn("[ConversationalAI] Invalid server-location: "+e+'. Defaulting to "us"'),"us"}}function i(e){return{us:"wss://api.elevenlabs.io","eu-residency":"wss://api.eu.residency.elevenlabs.io","in-residency":"wss://api.in.residency.elevenlabs.io",global:"wss://api.elevenlabs.io"}[e]}function u(e){return{us:"wss://livekit.rtc.elevenlabs.io","eu-residency":"wss://livekit.rtc.eu.residency.elevenlabs.io","in-residency":"wss://livekit.rtc.in.residency.elevenlabs.io",global:"wss://livekit.rtc.elevenlabs.io"}[e]}Object.defineProperty(exports,"AudioFormat",{enumerable:!0,get:function(){return n.AudioFormat}}),Object.defineProperty(exports,"CommitStrategy",{enumerable:!0,get:function(){return n.CommitStrategy}}),Object.defineProperty(exports,"RealtimeEvents",{enumerable:!0,get:function(){return n.RealtimeEvents}}),Object.defineProperty(exports,"postOverallFeedback",{enumerable:!0,get:function(){return n.postOverallFeedback}}),exports.getLivekitUrlForLocation=u,exports.getOriginForLocation=i,exports.parseLocation=o,exports.useConversation=function(l){void 0===l&&(l={});var a=l.micMuted,c=l.volume,s=l.serverLocation,d=function(e,n){if(null==e)return{};var t={};for(var r in e)if({}.hasOwnProperty.call(e,r)){if(-1!==n.indexOf(r))continue;t[r]=e[r]}return t}(l,r),v=e.useRef(null),f=e.useRef(null),m=e.useState("disconnected"),h=m[0],g=m[1],p=e.useState(!1),S=p[0],C=p[1],b=e.useState("listening"),y=b[0],M=b[1],T=e.useRef(a),R=e.useRef(c);return T.current=a,R.current=c,e.useEffect(function(){var e;void 0!==a&&(null==v||null==(e=v.current)||e.setMicMuted(a))},[a]),e.useEffect(function(){var e;void 0!==c&&(null==v||null==(e=v.current)||e.setVolume({volume:c}))},[c]),e.useEffect(function(){return function(){var e;null==(e=v.current)||e.endSession()}},[]),{startSession:function(e){try{var r,l,a=function(r){return l?r:function(r,l){try{var a=(I=i(D=o((null==e?void 0:e.serverLocation)||s)),A=u(D),f.current=n.Conversation.startSession(t({},null!=d?d:{},null!=e?e:{},{origin:I,livekitUrl:A,overrides:t({},null!=(c=null==d?void 0:d.overrides)?c:{},null!=(m=null==e?void 0:e.overrides)?m:{},{client:t({},null!=(h=null==d||null==(p=d.overrides)?void 0:p.client)?h:{},null!=(S=null==e||null==(b=e.overrides)?void 0:b.client)?S:{},{source:(null==e||null==(y=e.overrides)||null==(y=y.client)?void 0:y.source)||(null==d||null==(P=d.overrides)||null==(P=P.client)?void 0:P.source)||"react_sdk",version:(null==e||null==(E=e.overrides)||null==(E=E.client)?void 0:E.version)||(null==d||null==(w=d.overrides)||null==(w=w.client)?void 0:w.version)||"0.9.1"})}),onConnect:(null==e?void 0:e.onConnect)||(null==d?void 0:d.onConnect),onDisconnect:(null==e?void 0:e.onDisconnect)||(null==d?void 0:d.onDisconnect),onError:(null==e?void 0:e.onError)||(null==d?void 0:d.onError),onMessage:(null==e?void 0:e.onMessage)||(null==d?void 0:d.onMessage),onAudio:(null==e?void 0:e.onAudio)||(null==d?void 0:d.onAudio),onDebug:(null==e?void 0:e.onDebug)||(null==d?void 0:d.onDebug),onUnhandledClientToolCall:(null==e?void 0:e.onUnhandledClientToolCall)||(null==d?void 0:d.onUnhandledClientToolCall),onVadScore:(null==e?void 0:e.onVadScore)||(null==d?void 0:d.onVadScore),onInterruption:(null==e?void 0:e.onInterruption)||(null==d?void 0:d.onInterruption),onAgentToolResponse:(null==e?void 0:e.onAgentToolResponse)||(null==d?void 0:d.onAgentToolResponse),onConversationMetadata:(null==e?void 0:e.onConversationMetadata)||(null==d?void 0:d.onConversationMetadata),onMCPToolCall:(null==e?void 0:e.onMCPToolCall)||(null==d?void 0:d.onMCPToolCall),onMCPConnectionStatus:(null==e?void 0:e.onMCPConnectionStatus)||(null==d?void 0:d.onMCPConnectionStatus),onAsrInitiationMetadata:(null==e?void 0:e.onAsrInitiationMetadata)||(null==d?void 0:d.onAsrInitiationMetadata),onAgentChatResponsePart:(null==e?void 0:e.onAgentChatResponsePart)||(null==d?void 0:d.onAgentChatResponsePart),onModeChange:function(n){var t,r=n.mode;M(r),null==(t=(null==e?void 0:e.onModeChange)||(null==d?void 0:d.onModeChange))||t({mode:r})},onStatusChange:function(n){var t,r=n.status;g(r),null==(t=(null==e?void 0:e.onStatusChange)||(null==d?void 0:d.onStatusChange))||t({status:r})},onCanSendFeedbackChange:function(n){var t,r=n.canSendFeedback;C(r),null==(t=(null==e?void 0:e.onCanSendFeedbackChange)||(null==d?void 0:d.onCanSendFeedbackChange))||t({canSendFeedback:r})}})),Promise.resolve(f.current).then(function(e){return v.current=e,void 0!==T.current&&v.current.setMicMuted(T.current),void 0!==R.current&&v.current.setVolume({volume:R.current}),v.current.getId()}))}catch(e){return l(!0,e)}var c,m,h,p,S,b,y,P,E,w,D,I,A;return a&&a.then?a.then(l.bind(null,!1),l.bind(null,!0)):l(!1,a)}(0,function(e,n){if(f.current=null,e)throw n;return n})};if(null!=(r=v.current)&&r.isOpen())return Promise.resolve(v.current.getId());var c=function(){if(f.current)return Promise.resolve(f.current).then(function(e){var n=e.getId();return l=1,n})}();return Promise.resolve(c&&c.then?c.then(a):a(c))}catch(e){return Promise.reject(e)}},endSession:function(){try{var e=v.current;return v.current=null,Promise.resolve(null==e?void 0:e.endSession()).then(function(){})}catch(e){return Promise.reject(e)}},setVolume:function(e){var n;null==(n=v.current)||n.setVolume({volume:e.volume})},getInputByteFrequencyData:function(){var e;return null==(e=v.current)?void 0:e.getInputByteFrequencyData()},getOutputByteFrequencyData:function(){var e;return null==(e=v.current)?void 0:e.getOutputByteFrequencyData()},getInputVolume:function(){var e,n;return null!=(e=null==(n=v.current)?void 0:n.getInputVolume())?e:0},getOutputVolume:function(){var e,n;return null!=(e=null==(n=v.current)?void 0:n.getOutputVolume())?e:0},sendFeedback:function(e){var n;null==(n=v.current)||n.sendFeedback(e)},getId:function(){var e;return null==(e=v.current)?void 0:e.getId()},sendContextualUpdate:function(e){var n;null==(n=v.current)||n.sendContextualUpdate(e)},sendUserMessage:function(e){var n;null==(n=v.current)||n.sendUserMessage(e)},sendUserActivity:function(){var e;null==(e=v.current)||e.sendUserActivity()},sendMCPToolApprovalResult:function(e,n){var t;null==(t=v.current)||t.sendMCPToolApprovalResult(e,n)},changeInputDevice:function(e){try{var n,t=function(e){if(n)return e;throw new Error("Device switching is only available for voice conversations")},r=function(){if(v.current&&"changeInputDevice"in v.current)return Promise.resolve(v.current.changeInputDevice(e)).then(function(e){return n=1,e})}();return Promise.resolve(r&&r.then?r.then(t):t(r))}catch(e){return Promise.reject(e)}},changeOutputDevice:function(e){try{var n,t=function(e){if(n)return e;throw new Error("Device switching is only available for voice conversations")},r=function(){if(v.current&&"changeOutputDevice"in v.current)return Promise.resolve(v.current.changeOutputDevice(e)).then(function(e){return n=1,e})}();return Promise.resolve(r&&r.then?r.then(t):t(r))}catch(e){return Promise.reject(e)}},status:h,canSendFeedback:S,micMuted:a,isSpeaking:"speaking"===y}},exports.useScribe=function(r){void 0===r&&(r={});var o=r.onSessionStarted,i=r.onPartialTranscript,u=r.onFinalTranscript,l=r.onFinalTranscriptWithTimestamps,a=r.onError,c=r.onAuthError,s=r.onConnect,d=r.onDisconnect,v=r.token,f=r.modelId,m=r.baseUri,h=r.commitStrategy,g=r.vadSilenceThresholdSecs,p=r.vadThreshold,S=r.minSpeechDurationMs,C=r.minSilenceDurationMs,b=r.languageCode,y=r.microphone,M=r.audioFormat,T=r.sampleRate,R=r.autoConnect,P=void 0!==R&&R,E=e.useRef(null),w=e.useState("disconnected"),D=w[0],I=w[1],A=e.useState(""),k=A[0],F=A[1],O=e.useState([]),x=O[0],U=O[1],j=e.useState(null),L=j[0],V=j[1];e.useEffect(function(){return function(){var e;null==(e=E.current)||e.close()}},[]);var N=e.useCallback(function(e){void 0===e&&(e={});try{if(E.current)return console.warn("Already connected"),Promise.resolve();try{I("connecting"),V(null);var t=e.token||v,r=e.modelId||f;if(!t)throw new Error("Token is required");if(!r)throw new Error("Model ID is required");var R,P=e.microphone||y,w=e.audioFormat||M,D=e.sampleRate||T;if(P)R=n.Scribe.connect({token:t,modelId:r,baseUri:e.baseUri||m,commitStrategy:e.commitStrategy||h,vadSilenceThresholdSecs:e.vadSilenceThresholdSecs||g,vadThreshold:e.vadThreshold||p,minSpeechDurationMs:e.minSpeechDurationMs||S,minSilenceDurationMs:e.minSilenceDurationMs||C,languageCode:e.languageCode||b,microphone:P});else{if(!w||!D)throw new Error("Either microphone options or (audioFormat + sampleRate) must be provided");R=n.Scribe.connect({token:t,modelId:r,baseUri:e.baseUri||m,commitStrategy:e.commitStrategy||h,vadSilenceThresholdSecs:e.vadSilenceThresholdSecs||g,vadThreshold:e.vadThreshold||p,minSpeechDurationMs:e.minSpeechDurationMs||S,minSilenceDurationMs:e.minSilenceDurationMs||C,languageCode:e.languageCode||b,audioFormat:w,sampleRate:D})}E.current=R,R.on(n.RealtimeEvents.SESSION_STARTED,function(){I("connected"),null==o||o()}),R.on(n.RealtimeEvents.PARTIAL_TRANSCRIPT,function(e){var n=e;F(n.text),I("transcribing"),null==i||i(n)}),R.on(n.RealtimeEvents.FINAL_TRANSCRIPT,function(e){var n=e,t={id:Date.now()+"-"+Math.random(),text:n.text,timestamp:Date.now(),isFinal:!0};U(function(e){return[].concat(e,[t])}),F(""),null==u||u(n)}),R.on(n.RealtimeEvents.FINAL_TRANSCRIPT_WITH_TIMESTAMPS,function(e){var n=e,t={id:Date.now()+"-"+Math.random(),text:n.text,timestamp:Date.now(),isFinal:!0};U(function(e){return[].concat(e,[t])}),F(""),null==l||l(n)}),R.on(n.RealtimeEvents.ERROR,function(e){var n=e;V(n.error),I("error"),null==a||a(new Error(n.error))}),R.on(n.RealtimeEvents.AUTH_ERROR,function(e){var n=e;V(n.error),I("error"),null==c||c(n)}),R.on(n.RealtimeEvents.OPEN,function(){null==s||s()}),R.on(n.RealtimeEvents.CLOSE,function(){I("disconnected"),E.current=null,null==d||d()})}catch(e){var A=e instanceof Error?e.message:"Failed to connect";throw V(A),I("error"),e}return Promise.resolve()}catch(e){return Promise.reject(e)}},[v,f,m,h,g,p,S,C,b,y,M,T,o,i,u,l,a,c,s,d]),q=e.useCallback(function(){var e;null==(e=E.current)||e.close(),E.current=null,I("disconnected")},[]),_=e.useCallback(function(e,n){if(!E.current)throw new Error("Not connected to Scribe");E.current.send(t({audioBase64:e},n))},[]),B=e.useCallback(function(){if(!E.current)throw new Error("Not connected to Scribe");E.current.commit()},[]),H=e.useCallback(function(){U([]),F("")},[]),W=e.useCallback(function(){return E.current},[]);return e.useEffect(function(){P&&N()},[P,N]),{status:D,isConnected:"connected"===D||"transcribing"===D,isTranscribing:"transcribing"===D,partialTranscript:k,finalTranscripts:x,error:L,connect:N,disconnect:q,sendAudio:_,commit:B,clearTranscripts:H,getConnection:W}};
 //# sourceMappingURL=lib.cjs.map