@vapi-ai/web 3.0.0 → 3.0.1

package/dist/api.js

@@ -218,6 +218,24 @@ class Api extends HttpClient {
             format: "json",
             ...params,
         }),
+        /**
+         * No description
+         *
+         * @tags Assistants
+         * @name AssistantControllerValidateBackgroundSoundUrl
+         * @summary Validate Background Sound URL
+         * @request POST:/assistant/background-sound/validate
+         * @secure
+         */
+        assistantControllerValidateBackgroundSoundUrl: (data, params = {}) => this.request({
+            path: `/assistant/background-sound/validate`,
+            method: "POST",
+            body: data,
+            secure: true,
+            type: ContentType.Json,
+            format: "json",
+            ...params,
+        }),
         /**
          * No description
          *
@@ -441,6 +459,24 @@ class Api extends HttpClient {
             format: "json",
             ...params,
         }),
+        /**
+         * No description
+         *
+         * @tags Assistants
+         * @name AssistantControllerUpsertDraft
+         * @summary Upsert Assistant Draft
+         * @request PUT:/assistant/{id}/draft
+         * @secure
+         */
+        assistantControllerUpsertDraft: (id, data, params = {}) => this.request({
+            path: `/assistant/${id}/draft`,
+            method: "PUT",
+            body: data,
+            secure: true,
+            type: ContentType.Json,
+            format: "json",
+            ...params,
+        }),
         /**
          * No description
          *
@@ -680,6 +716,23 @@ class Api extends HttpClient {
             format: "json",
             ...params,
         }),
+        /**
+         * No description
+         *
+         * @tags Files
+         * @name FileV2ControllerFindAllPaginated
+         * @summary List Files with pagination
+         * @request GET:/v2/file
+         * @secure
+         */
+        fileV2ControllerFindAllPaginated: (query, params = {}) => this.request({
+            path: `/v2/file`,
+            method: "GET",
+            query: query,
+            secure: true,
+            format: "json",
+            ...params,
+        }),
         /**
          * No description
          *
@@ -918,6 +971,56 @@ class Api extends HttpClient {
             format: "json",
             ...params,
         }),
+        /**
+         * @description Returns the version history for the squad.
+         *
+         * @tags Squads
+         * @name SquadControllerFindAllVersions
+         * @summary List Squad Versions
+         * @request GET:/squad/{id}/versions
+         * @secure
+         */
+        squadControllerFindAllVersions: (id, query, params = {}) => this.request({
+            path: `/squad/${id}/versions`,
+            method: "GET",
+            query: query,
+            secure: true,
+            format: "json",
+            ...params,
+        }),
+        /**
+         * No description
+         *
+         * @tags Squads
+         * @name SquadControllerFindOneVersion
+         * @summary Get Squad Version
+         * @request GET:/squad/{id}/versions/{version}
+         * @secure
+         */
+        squadControllerFindOneVersion: (id, version, query, params = {}) => this.request({
+            path: `/squad/${id}/versions/${version}`,
+            method: "GET",
+            query: query,
+            secure: true,
+            format: "json",
+            ...params,
+        }),
+        /**
+         * @description Deletes the selected version and rolls the squad back to the highest remaining live version. Deleting a version that is already deleted returns 200 with that version.
+         *
+         * @tags Squads
+         * @name SquadControllerSoftDeleteVersion
+         * @summary Delete Squad Version
+         * @request DELETE:/squad/{id}/versions/{version}
+         * @secure
+         */
+        squadControllerSoftDeleteVersion: (id, version, params = {}) => this.request({
+            path: `/squad/${id}/versions/${version}`,
+            method: "DELETE",
+            secure: true,
+            format: "json",
+            ...params,
+        }),
     };
     workflow = {
         /**
@@ -1565,6 +1668,93 @@ class Api extends HttpClient {
             ...params,
         }),
     };
+    trafficAllocations = {
+        /**
+         * @description Creates a new traffic allocation for an assistant, replacing the one currently in effect. To start or adjust a split, send targets naming published versions (such as "v7") with percentages totaling 100; allocationIntent is inferred as 'explicit'. To stop splitting and send every call to the newest published version, send allocationIntent 'follow-latest' with no targets field; stopping always names its intent, so a dropped targets field can never end a split by accident. Traffic splitting is in beta, rolling out to select organizations; requests from organizations without access receive a 403.
+         *
+         * @tags Traffic Allocations
+         * @name TrafficAllocationControllerCreate
+         * @summary Create traffic allocation
+         * @request POST:/traffic-allocations
+         * @secure
+         */
+        trafficAllocationControllerCreate: (data, params = {}) => this.request({
+            path: `/traffic-allocations`,
+            method: "POST",
+            body: data,
+            secure: true,
+            type: ContentType.Json,
+            format: "json",
+            ...params,
+        }),
+        /**
+         * @description The append-only history of an assistant's allocations, newest first. Traffic splitting is in beta, rolling out to select organizations; requests from organizations without access receive a 403.
+         *
+         * @tags Traffic Allocations
+         * @name TrafficAllocationControllerFindAllPaginated
+         * @summary List traffic allocations
+         * @request GET:/traffic-allocations
+         * @secure
+         */
+        trafficAllocationControllerFindAllPaginated: (query, params = {}) => this.request({
+            path: `/traffic-allocations`,
+            method: "GET",
+            query: query,
+            secure: true,
+            format: "json",
+            ...params,
+        }),
+        /**
+         * @description The allocation currently in effect for the assistant, with its targets. The response carries no allocation field when traffic splitting has never been configured. Traffic splitting is in beta, rolling out to select organizations; requests from organizations without access receive a 403.
+         *
+         * @tags Traffic Allocations
+         * @name TrafficAllocationControllerLatestGet
+         * @summary Get latest traffic allocation
+         * @request GET:/traffic-allocations/latest
+         * @secure
+         */
+        trafficAllocationControllerLatestGet: (query, params = {}) => this.request({
+            path: `/traffic-allocations/latest`,
+            method: "GET",
+            query: query,
+            secure: true,
+            format: "json",
+            ...params,
+        }),
+        /**
+         * @description Per-assistant-version call metrics over a time window: call counts, configured vs actual traffic share, duration, cost per minute, latency, ended reasons, a bucketed timeseries, and optional structured output aggregations. Calls with no assistant version are reported as an 'unversioned' row. Traffic splitting is in beta, rolling out to select organizations; requests from organizations without access receive a 403.
+         *
+         * @tags Traffic Allocations
+         * @name TrafficAllocationControllerMetricsGet
+         * @summary Get traffic split metrics
+         * @request GET:/traffic-allocations/metrics
+         * @secure
+         */
+        trafficAllocationControllerMetricsGet: (query, params = {}) => this.request({
+            path: `/traffic-allocations/metrics`,
+            method: "GET",
+            query: query,
+            secure: true,
+            format: "json",
+            ...params,
+        }),
+        /**
+         * @description Returns a single allocation by id, including its targets and actor attribution. Traffic splitting is in beta, rolling out to select organizations; requests from organizations without access receive a 403.
+         *
+         * @tags Traffic Allocations
+         * @name TrafficAllocationControllerFindOne
+         * @summary Get traffic allocation
+         * @request GET:/traffic-allocations/{id}
+         * @secure
+         */
+        trafficAllocationControllerFindOne: (id, params = {}) => this.request({
+            path: `/traffic-allocations/${id}`,
+            method: "GET",
+            secure: true,
+            format: "json",
+            ...params,
+        }),
+    };
     phoneNumber = {
         /**
          * @description Use POST /phone-number instead.
@@ -1862,6 +2052,22 @@ class Api extends HttpClient {
             format: "json",
             ...params,
         }),
+        /**
+         * @description Restores the selected version as the current configuration and publishes it as a new version. Deletes any drafts for this tool.
+         *
+         * @tags Tools
+         * @name ToolControllerToolVersionRestore
+         * @summary Restore Tool Version
+         * @request POST:/tool/{id}/restore/{version}
+         * @secure
+         */
+        toolControllerToolVersionRestore: (id, version, params = {}) => this.request({
+            path: `/tool/${id}/restore/${version}`,
+            method: "POST",
+            secure: true,
+            format: "json",
+            ...params,
+        }),
         /**
          * No description
          *
@@ -2826,7 +3032,7 @@ class Api extends HttpClient {
             ...params,
         }),
         /**
-         * No description
+         * @description Returns a pagination envelope when page, limit, name, assistantId, or squadId is supplied; otherwise returns the legacy array.
          *
          * @tags Simulation Suites
          * @name SimulationSuiteControllerFindAll
@@ -2842,6 +3048,22 @@ class Api extends HttpClient {
             format: "json",
             ...params,
         }),
+        /**
+         * No description
+         *
+         * @tags Simulation Suites
+         * @name SimulationSuiteControllerDuplicate
+         * @summary Duplicate simulation suite
+         * @request POST:/eval/simulation/suite/{id}/duplicate
+         * @secure
+         */
+        simulationSuiteControllerDuplicate: (id, params = {}) => this.request({
+            path: `/eval/simulation/suite/${id}/duplicate`,
+            method: "POST",
+            secure: true,
+            format: "json",
+            ...params,
+        }),
         /**
          * No description
          *
@@ -2945,6 +3167,22 @@ class Api extends HttpClient {
             format: "json",
             ...params,
         }),
+        /**
+         * No description
+         *
+         * @tags Simulations
+         * @name SimulationControllerGetConcurrency
+         * @summary Get Simulation Concurrency
+         * @request GET:/eval/simulation/concurrency
+         * @secure
+         */
+        simulationControllerGetConcurrency: (params = {}) => this.request({
+            path: `/eval/simulation/concurrency`,
+            method: "GET",
+            secure: true,
+            format: "json",
+            ...params,
+        }),
         /**
          * No description
          *
@@ -2995,22 +3233,6 @@ class Api extends HttpClient {
             format: "json",
             ...params,
         }),
-        /**
-         * No description
-         *
-         * @tags Simulations
-         * @name SimulationControllerGetConcurrency
-         * @summary Get Simulation Concurrency
-         * @request GET:/eval/simulation/concurrency
-         * @secure
-         */
-        simulationControllerGetConcurrency: (params = {}) => this.request({
-            path: `/eval/simulation/concurrency`,
-            method: "GET",
-            secure: true,
-            format: "json",
-            ...params,
-        }),
         /**
          * No description
          *
@@ -3143,6 +3365,7 @@ class Api extends HttpClient {
             body: data,
             secure: true,
             type: ContentType.Json,
+            format: "json",
             ...params,
         }),
         /**
@@ -3526,6 +3749,22 @@ class Api extends HttpClient {
             format: "json",
             ...params,
         }),
+        /**
+         * @description Returns the call concurrency limits and API rate limit usage for the authenticated org. Read-only and cheap enough to poll every few seconds. The X-RateLimit-* response headers describe this endpoint's own polling ceiling, not the API budget reported in apiLimits.
+         *
+         * @tags Orgs
+         * @name OrgControllerLimitsGet
+         * @summary Get org limits
+         * @request GET:/org/limits
+         * @secure
+         */
+        orgControllerLimitsGet: (params = {}) => this.request({
+            path: `/org/limits`,
+            method: "GET",
+            secure: true,
+            format: "json",
+            ...params,
+        }),
         /**
          * No description
          *

package/dist/jest.config.js

@@ -2,6 +2,9 @@
 Object.defineProperty(exports, "__esModule", { value: true });
 const config = {
     preset: 'ts-jest',
+    transform: {
+        '^.+\\.tsx?$': ['ts-jest', { tsconfig: { types: ['jest', 'node'] } }],
+    },
     testEnvironment: 'node',
     // Your Jest configuration options here
     // For example, to match test files:

package/dist/vapi.d.ts

@@ -70,6 +70,8 @@ type VapiEventListeners = {
     'recording-upload-completed': (event: DailyEventObjectNoPayload) => void;
 };
 type StartCallOptions = {
+    /** Acquire the microphone before creating a backend call. Defaults to true. */
+    microphonePreflightEnabled?: boolean;
     /**
      * This determines whether the daily room will be deleted and all participants will be kicked once the user leaves the room.
      * If set to `false`, the room will be kept alive even after the user leaves, allowing clients to reconnect to the same room.
@@ -138,6 +140,9 @@ export default class Vapi extends VapiEventEmitter {
     private speakingTimeout;
     private dailyCallConfig;
     private dailyCallObject;
+    private microphoneTrack;
+    private cancelMicrophonePreflight;
+    private microphoneAcquire;
     private hasEmittedCallEndedStatus;
     constructor(apiToken: string, apiBaseUrl?: string, dailyCallConfig?: Pick<DailyAdvancedConfig, 'avoidEval' | 'alwaysIncludeMicInPermissionPrompt'>, dailyCallObject?: Pick<DailyFactoryOptions, 'audioSource' | 'startAudioOff'>);
     private cleanup;

package/dist/vapi.js

@@ -134,6 +134,39 @@ class Vapi extends VapiEventEmitter {
     speakingTimeout = null;
     dailyCallConfig = {};
     dailyCallObject = {};
+    microphoneTrack = null;
+    cancelMicrophonePreflight = null;
+    async microphoneAcquire() {
+        const source = this.dailyCallObject.audioSource;
+        if (source && typeof source === 'object') {
+            if (source.readyState === 'ended') {
+                throw new DOMException('The supplied microphone track has ended.', 'NotReadableError');
+            }
+            return source;
+        }
+        return new Promise((resolve, reject) => {
+            let cancelled = false;
+            this.cancelMicrophonePreflight = () => {
+                cancelled = true;
+                reject(new DOMException('Microphone preflight cancelled.', 'AbortError'));
+            };
+            navigator.mediaDevices.getUserMedia({
+                audio: typeof source === 'string' ? { deviceId: { exact: source } } : true,
+            }).then((stream) => {
+                const track = stream.getAudioTracks()[0];
+                if (cancelled || !track || track.readyState === 'ended') {
+                    stream.getTracks().forEach((item) => item.stop());
+                    reject(new DOMException('No live microphone track available.', 'NotFoundError'));
+                    return;
+                }
+                stream.getTracks().filter((item) => item !== track).forEach((item) => item.stop());
+                this.microphoneTrack = track;
+                resolve(track);
+            }, reject);
+        }).finally(() => {
+            this.cancelMicrophonePreflight = null;
+        });
+    }
     hasEmittedCallEndedStatus = false;
     constructor(apiToken, apiBaseUrl, dailyCallConfig, dailyCallObject) {
         super();
@@ -143,6 +176,8 @@ class Vapi extends VapiEventEmitter {
         this.dailyCallObject = (0, daily_guards_1.createSafeDailyFactoryOptions)(dailyCallObject);
     }
     async cleanup() {
+        this.microphoneTrack?.stop();
+        this.microphoneTrack = null;
         this.started = false;
         this.hasEmittedCallEndedStatus = false;
         if (this.call) {
@@ -243,7 +278,16 @@ class Vapi extends VapiEventEmitter {
             }
         });
         this.started = true;
+        let failureStage = 'microphone-preflight';
         try {
+            if (this.call) {
+                await this.cleanup();
+                this.started = true;
+            }
+            const audioSource = options?.microphonePreflightEnabled === false
+                ? this.dailyCallObject.audioSource ?? true
+                : await this.microphoneAcquire();
+            failureStage = 'unknown';
             // Stage 1: Create web call
             this.emit('call-start-progress', {
                 stage: 'web-call-creation',
@@ -274,15 +318,6 @@ class Vapi extends VapiEventEmitter {
                     voiceProvider: webCall?.assistant?.voice?.provider || 'unknown'
                 }
             });
-            if (this.call) {
-                this.emit('call-start-progress', {
-                    stage: 'daily-call-object-creation',
-                    status: 'started',
-                    timestamp: new Date().toISOString(),
-                    metadata: { action: 'cleanup-existing' }
-                });
-                await this.cleanup();
-            }
             const isVideoRecordingEnabled = webCall?.artifactPlan?.videoRecordingEnabled ?? false;
             const isVideoEnabled = webCall?.assistant?.voice?.provider === 'tavus';
             // When video recording is enabled, the server sends a Daily meeting
@@ -305,7 +340,7 @@ class Vapi extends VapiEventEmitter {
             const dailyCallStartTime = Date.now();
             try {
                 this.call = daily_js_1.default.createCallObject({
-                    audioSource: this.dailyCallObject.audioSource ?? true,
+                    audioSource,
                     videoSource: this.dailyCallObject.videoSource ?? isVideoRecordingEnabled,
                     dailyConfig: this.dailyCallConfig,
                 });
@@ -693,8 +728,9 @@ class Vapi extends VapiEventEmitter {
         catch (e) {
             const totalDuration = Date.now() - startTime;
             const serializedError = serializeError(e);
+            await this.cleanup();
             this.emit('call-start-failed', {
-                stage: 'unknown',
+                stage: failureStage,
                 totalDuration,
                 error: serializedError.message,
                 errorStack: serializedError.stack || 'No stack trace available',
@@ -708,8 +744,10 @@ class Vapi extends VapiEventEmitter {
             });
             // Also emit the generic error event for backward compatibility
             this.emit('error', {
-                type: 'start-method-error',
-                stage: 'unknown',
+                type: failureStage === 'microphone-preflight'
+                    ? `microphone-preflight-${e && typeof e === 'object' && 'name' in e ? e.name : 'error'}`
+                    : 'start-method-error',
+                stage: failureStage,
                 error: serializedError,
                 totalDuration,
                 timestamp: new Date().toISOString(),
@@ -720,7 +758,6 @@ class Vapi extends VapiEventEmitter {
                     isMobile: this.isMobileDevice()
                 }
             });
-            await this.cleanup();
             return null;
         }
     }
@@ -778,6 +815,12 @@ class Vapi extends VapiEventEmitter {
      * If `roomDeleteOnUserLeaveEnabled` is set to `true`, the Vapi call will also be destroyed, preventing any reconnections.
      */
     async stop() {
+        if (this.cancelMicrophonePreflight) {
+            this.cancelMicrophonePreflight();
+            return;
+        }
+        this.microphoneTrack?.stop();
+        this.microphoneTrack = null;
         this.started = false;
         if (this.call) {
             await this.call.destroy();

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@vapi-ai/web",
-  "version": "3.0.0",
+  "version": "3.0.1",
   "description": "",
   "main": "dist/vapi.js",
   "types": "dist/vapi.d.ts",
@@ -31,7 +31,7 @@
     "node": ">=22.14.0"
   },
   "dependencies": {
-    "@daily-co/daily-js": "^0.93.0",
+    "@daily-co/daily-js": "^0.94.0",
     "events": "^3.3.0"
   },
   "devDependencies": {

package/vapi.ts

@@ -206,6 +206,8 @@ type VapiEventListeners = {
 };
 
 type StartCallOptions = {
+  /** Acquire the microphone before creating a backend call. Defaults to true. */
+  microphonePreflightEnabled?: boolean;
   /**
    * This determines whether the daily room will be deleted and all participants will be kicked once the user leaves the room.
    * If set to `false`, the room will be kept alive even after the user leaves, allowing clients to reconnect to the same room.
@@ -356,6 +358,40 @@ export default class Vapi extends VapiEventEmitter {
   private speakingTimeout: NodeJS.Timeout | null = null;
   private dailyCallConfig: DailyAdvancedConfig = {};
   private dailyCallObject: DailyFactoryOptions = {};
+  private microphoneTrack: MediaStreamTrack | null = null;
+  private cancelMicrophonePreflight: (() => void) | null = null;
+
+  private async microphoneAcquire(): Promise<MediaStreamTrack> {
+    const source = this.dailyCallObject.audioSource;
+    if (source && typeof source === 'object') {
+      if (source.readyState === 'ended') {
+        throw new DOMException('The supplied microphone track has ended.', 'NotReadableError');
+      }
+      return source;
+    }
+    return new Promise<MediaStreamTrack>((resolve, reject) => {
+      let cancelled = false;
+      this.cancelMicrophonePreflight = () => {
+        cancelled = true;
+        reject(new DOMException('Microphone preflight cancelled.', 'AbortError'));
+      };
+      navigator.mediaDevices.getUserMedia({
+        audio: typeof source === 'string' ? { deviceId: { exact: source } } : true,
+      }).then((stream) => {
+        const track = stream.getAudioTracks()[0];
+        if (cancelled || !track || track.readyState === 'ended') {
+          stream.getTracks().forEach((item) => item.stop());
+          reject(new DOMException('No live microphone track available.', 'NotFoundError'));
+          return;
+        }
+        stream.getTracks().filter((item) => item !== track).forEach((item) => item.stop());
+        this.microphoneTrack = track;
+        resolve(track);
+      }, reject);
+    }).finally(() => {
+      this.cancelMicrophonePreflight = null;
+    });
+  }
 
   private hasEmittedCallEndedStatus: boolean = false;
 
@@ -376,6 +412,8 @@ export default class Vapi extends VapiEventEmitter {
   }
 
   private async cleanup() {
+    this.microphoneTrack?.stop();
+    this.microphoneTrack = null;
     this.started = false;
     this.hasEmittedCallEndedStatus = false;
     if (this.call) {
@@ -498,7 +536,16 @@ export default class Vapi extends VapiEventEmitter {
     
     this.started = true;
 
+    let failureStage = 'microphone-preflight';
     try {
+      if (this.call) {
+        await this.cleanup();
+        this.started = true;
+      }
+      const audioSource = options?.microphonePreflightEnabled === false
+        ? this.dailyCallObject.audioSource ?? true
+        : await this.microphoneAcquire();
+      failureStage = 'unknown';
             // Stage 1: Create web call
       this.emit('call-start-progress', {
         stage: 'web-call-creation',
@@ -535,16 +582,6 @@ export default class Vapi extends VapiEventEmitter {
         }
       });
 
-      if (this.call) {
-        this.emit('call-start-progress', {
-          stage: 'daily-call-object-creation',
-          status: 'started',
-          timestamp: new Date().toISOString(),
-          metadata: { action: 'cleanup-existing' }
-        });
-        await this.cleanup();
-      }
-
       const isVideoRecordingEnabled =
         webCall?.artifactPlan?.videoRecordingEnabled ?? false;
 
@@ -575,7 +612,7 @@ export default class Vapi extends VapiEventEmitter {
       
       try {
         this.call = DailyIframe.createCallObject({
-          audioSource: this.dailyCallObject.audioSource ?? true,
+          audioSource,
           videoSource: this.dailyCallObject.videoSource ?? isVideoRecordingEnabled,
           dailyConfig: this.dailyCallConfig,
         });
@@ -994,9 +1031,10 @@ export default class Vapi extends VapiEventEmitter {
     } catch (e) {
       const totalDuration = Date.now() - startTime;
       const serializedError = serializeError(e);
+      await this.cleanup();
       
       this.emit('call-start-failed', {
-        stage: 'unknown',
+        stage: failureStage,
         totalDuration,
         error: serializedError.message,
         errorStack: serializedError.stack || 'No stack trace available',
@@ -1011,8 +1049,10 @@ export default class Vapi extends VapiEventEmitter {
       
       // Also emit the generic error event for backward compatibility
       this.emit('error', {
-        type: 'start-method-error',
-        stage: 'unknown',
+        type: failureStage === 'microphone-preflight'
+          ? `microphone-preflight-${e && typeof e === 'object' && 'name' in e ? e.name : 'error'}`
+          : 'start-method-error',
+        stage: failureStage,
         error: serializedError,
         totalDuration,
         timestamp: new Date().toISOString(),
@@ -1024,7 +1064,6 @@ export default class Vapi extends VapiEventEmitter {
         }
       });
       
-      await this.cleanup();
       return null;
     }
   }
@@ -1092,6 +1131,12 @@ export default class Vapi extends VapiEventEmitter {
    * If `roomDeleteOnUserLeaveEnabled` is set to `true`, the Vapi call will also be destroyed, preventing any reconnections.
    */
   async stop(): Promise<void> {
+    if (this.cancelMicrophonePreflight) {
+      this.cancelMicrophonePreflight();
+      return;
+    }
+    this.microphoneTrack?.stop();
+    this.microphoneTrack = null;
     this.started = false;
     if (this.call) {
       await this.call.destroy();