@vapi-ai/web 3.0.1 → 3.1.0

package/dist/api.js

@@ -1338,6 +1338,41 @@ class Api extends HttpClient {
             secure: true,
             ...params,
         }),
+        /**
+         * No description
+         *
+         * @tags Calls
+         * @name GoalEvaluationCurrentControllerCurrentGet
+         * @summary Get the current goal evaluation for a call
+         * @request GET:/call/{id}/goal-evaluation
+         * @secure
+         */
+        goalEvaluationCurrentControllerCurrentGet: (id, query, params = {}) => this.request({
+            path: `/call/${id}/goal-evaluation`,
+            method: "GET",
+            query: query,
+            secure: true,
+            format: "json",
+            ...params,
+        }),
+        /**
+         * No description
+         *
+         * @tags Calls
+         * @name GoalEvaluationCurrentControllerCurrentBatchGet
+         * @summary Get current goal evaluations for up to 100 call/goal pairs
+         * @request POST:/call/goal-evaluation/batch
+         * @secure
+         */
+        goalEvaluationCurrentControllerCurrentBatchGet: (data, params = {}) => this.request({
+            path: `/call/goal-evaluation/batch`,
+            method: "POST",
+            body: data,
+            secure: true,
+            type: ContentType.Json,
+            format: "json",
+            ...params,
+        }),
     };
     chat = {
         /**
@@ -1670,7 +1705,7 @@ class Api extends HttpClient {
     };
     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.
+         * @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.
          *
          * @tags Traffic Allocations
          * @name TrafficAllocationControllerCreate
@@ -1688,7 +1723,7 @@ class Api extends HttpClient {
             ...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.
+         * @description The append-only history of an assistant's allocations, newest first.
          *
          * @tags Traffic Allocations
          * @name TrafficAllocationControllerFindAllPaginated
@@ -1705,7 +1740,7 @@ class Api extends HttpClient {
             ...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.
+         * @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.
          *
          * @tags Traffic Allocations
          * @name TrafficAllocationControllerLatestGet
@@ -1722,7 +1757,7 @@ class Api extends HttpClient {
             ...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.
+         * @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.
          *
          * @tags Traffic Allocations
          * @name TrafficAllocationControllerMetricsGet
@@ -1739,7 +1774,7 @@ class Api extends HttpClient {
             ...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.
+         * @description Returns a single allocation by id, including its targets and actor attribution.
          *
          * @tags Traffic Allocations
          * @name TrafficAllocationControllerFindOne
@@ -3132,6 +3167,60 @@ class Api extends HttpClient {
             format: "json",
             ...params,
         }),
+        /**
+         * @description Generate draft test requirements from an assistant's prompt, tools, and handoff configuration. The response includes numbered requirements describing expected behavior and open questions about behavior that needs clarification. Use this endpoint before generating a simulation suite. Review the requirements and resolve any open questions. To revise a draft, send it as `previousDraft` together with natural-language `feedback` describing the changes or answers. Once the requirements are ready, pass them to `POST /eval/simulation/onboarding/suite`. Requests can take up to 2 minutes. Each organization can draft requirements 60 times per UTC day, shared with the dashboard. A 429 `SIMULATION_ONBOARDING_QUOTA_EXCEEDED` response means the daily limit has been reached. Wait until the limit resets at 00:00 UTC before retrying.
+         *
+         * @tags Simulation Suites
+         * @name SimulationOnboardingControllerRequirementsDraft
+         * @summary Draft simulation requirements
+         * @request POST:/eval/simulation/onboarding/requirements
+         * @secure
+         */
+        simulationOnboardingControllerRequirementsDraft: (data, params = {}) => this.request({
+            path: `/eval/simulation/onboarding/requirements`,
+            method: "POST",
+            body: data,
+            secure: true,
+            type: ContentType.Json,
+            format: "json",
+            ...params,
+        }),
+        /**
+         * @description Generate and save a simulation suite from reviewed test requirements, and assign it to an assistant. First draft requirements with `POST /eval/simulation/onboarding/requirements`. The response includes the saved suite, its simulations, and requirement coverage, including any gaps. Requests can take up to 3 minutes. Set a client timeout of at least 200 seconds. Use a unique `idempotencyKey` for each suite generation request. Retrying with the same key does not create a duplicate suite: - On a timeout or a 5xx (502, 504, 524), retry with the same key. You get the saved suite, a 409 while it is still generating, or a fresh generation if the first one never saved. - On a 409 `SIMULATION_ONBOARDING_GENERATION_IN_PROGRESS`, the first request is still generating. Wait `Retry-After` seconds (15) and retry with the same key. - On a 409 `SIMULATION_ONBOARDING_IDEMPOTENCY_KEY_REUSED`, the key was used for a different assistant or requirements. Send a new key. Review the generated simulations and coverage gaps. Revise the suite with `PATCH /eval/simulation/onboarding/suite/{suiteId}`, then run it with `POST /eval/simulation/run`. Each organization can generate 20 suites per UTC day, shared with the dashboard, and 2 at a time. A retry that returns a saved suite does not count toward these limits. On a 429 `SIMULATION_ONBOARDING_CONCURRENCY_LIMITED`, wait `Retry-After` seconds (30) before retrying. On a 429 `SIMULATION_ONBOARDING_QUOTA_EXCEEDED`, wait until the daily limit resets at 00:00 UTC before retrying.
+         *
+         * @tags Simulation Suites
+         * @name SimulationOnboardingControllerSuiteCreate
+         * @summary Generate a simulation suite
+         * @request POST:/eval/simulation/onboarding/suite
+         * @secure
+         */
+        simulationOnboardingControllerSuiteCreate: (data, params = {}) => this.request({
+            path: `/eval/simulation/onboarding/suite`,
+            method: "POST",
+            body: data,
+            secure: true,
+            type: ContentType.Json,
+            format: "json",
+            ...params,
+        }),
+        /**
+         * @description Revise a suite created by `POST /eval/simulation/onboarding/suite`. Remove simulations, rewrite scenarios using natural-language instructions, or set `retryFailed` to regenerate scenarios that failed or exceeded generation limits. The response includes the updated suite and requirement coverage. Requests can take up to 2 minutes. Send a new `patchKey` for each edit. Replaying an applied key changes nothing and returns the current suite, with `failedEditSimulationIds` listing the simulations that edit could not rewrite, so retry a timeout or a 5xx with the same key. A suite remembers its last 50 keys, so never reuse one. Each organization can make 60 edits per UTC day, shared with the dashboard. Requests that only remove simulations and replays of applied edits do not count toward this limit. On a 429 `SIMULATION_ONBOARDING_QUOTA_EXCEEDED`, wait until the daily limit resets at 00:00 UTC before retrying.
+         *
+         * @tags Simulation Suites
+         * @name SimulationOnboardingControllerSuiteUpdate
+         * @summary Edit a generated simulation suite
+         * @request PATCH:/eval/simulation/onboarding/suite/{suiteId}
+         * @secure
+         */
+        simulationOnboardingControllerSuiteUpdate: (suiteId, data, params = {}) => this.request({
+            path: `/eval/simulation/onboarding/suite/${suiteId}`,
+            method: "PATCH",
+            body: data,
+            secure: true,
+            type: ContentType.Json,
+            format: "json",
+            ...params,
+        }),
         /**
          * No description
          *

package/dist/vapi.d.ts

@@ -1,7 +1,7 @@
 import type { ChatCompletionMessageParam } from 'openai/resources';
 import { DailyCall, DailyAdvancedConfig, DailyFactoryOptions, DailyEventObjectNoPayload, DailyEventObjectRecordingError, DailyEventObjectRecordingStarted, DailyEventObjectRecordingStopped, DailyParticipant, DailyVideoSendSettings } from '@daily-co/daily-js';
 import EventEmitter from 'events';
-import { Call, CreateSquadDTO, CreateAssistantDTO, AssistantOverrides, CreateWorkflowDTO, WorkflowOverrides } from './api';
+import { Call, CreateSquadDTO, CreateAssistantDTO, AssistantOverrides, CreateWebCallDTO, CreateWorkflowDTO, WorkflowOverrides } from './api';
 export interface EndCallMessage {
     type: 'end-call';
 }
@@ -69,6 +69,7 @@ type VapiEventListeners = {
     'recording-error': (event: DailyEventObjectRecordingError) => void;
     'recording-upload-completed': (event: DailyEventObjectNoPayload) => void;
 };
+type VideoRecordingStartMode = NonNullable<CreateWebCallDTO['videoRecordingStartMode']>;
 type StartCallOptions = {
     /** Acquire the microphone before creating a backend call. Defaults to true. */
     microphonePreflightEnabled?: boolean;
@@ -81,6 +82,25 @@ type StartCallOptions = {
      * @example true
      */
     roomDeleteOnUserLeaveEnabled?: boolean;
+    /**
+     * This determines who starts the video recording. Only applies when video
+     * recording is enabled (`artifactPlan.videoRecordingEnabled`).
+     *
+     * - `client`: the web client starts the recording when it joins.
+     * - `server`: Vapi starts the recording once the user has joined, so a weak
+     *   client connection can't stop it from starting. If Vapi can't set up the
+     *   server-side start, or the start itself fails, the SDK emits
+     *   `recording-error`.
+     *
+     * In `server` mode the SDK never calls `startRecording()` itself. If the
+     * server-side start couldn't be set up, calling it yourself may still start
+     * the recording.
+     *
+     * Requires a Vapi API that supports this field; older servers reject the
+     * request. The server defaults to `client` when it is not set.
+     * @example "server"
+     */
+    videoRecordingStartMode?: VideoRecordingStartMode;
 };
 type WebCall = {
     /**
@@ -113,13 +133,21 @@ type WebCall = {
     };
     /**
      * The Vapi WebCall transport. When video recording is enabled, the server
-     * sets `callToken` to a Daily meeting token that auto-starts the cloud
-     * recording on join.
+     * sets `callToken` to the Daily meeting token to join with. In `client` mode
+     * the token auto-starts the cloud recording on join; in `server` mode it
+     * starts nothing and Vapi starts the recording. If there is no token, the
+     * SDK emits `recording-error` and starts nothing, though `startRecording()`
+     * may still start the recording from the client.
+     *
+     * `videoRecordingStartMode` is `server` when Vapi starts the recording, and
+     * is absent when video recording is off or the server-side start couldn't
+     * be set up.
      *
      * call.transport
      */
     transport?: {
         callToken?: string;
+        videoRecordingStartMode?: VideoRecordingStartMode;
     };
 };
 declare class VapiEventEmitter extends EventEmitter {
@@ -220,6 +248,16 @@ export default class Vapi extends VapiEventEmitter {
      * which EventEmitter throws on when nothing is listening.
      */
     private emitToConsumer;
+    /**
+     * Reported in a later task, like Daily's own recording-error: start() or
+     * reconnect() has resolved and the caller's await continuation has run, so a
+     * listener registered right after it still hears this, and one that calls
+     * stop() can't interrupt call setup. Skipped if that call was stopped or
+     * replaced.
+     */
+    private recordingTokenMissingReportSchedule;
+    /** The fields are read defensively: the app message is untrusted JSON. */
+    private videoRecordingStartFailedReport;
     /** Drops the reference before removing, so nothing hands out a detached element. */
     private detachAudioPlayer;
     /**

package/dist/vapi.js

@@ -58,6 +58,8 @@ function serializeError(error) {
     }
     return { message: String(error) };
 }
+// The app message Vapi sends when it couldn't start a server-mode recording.
+const VIDEO_RECORDING_START_FAILED_MESSAGE_TYPE = 'video-recording.start-failed';
 async function startAudioPlayer(player, track) {
     player.muted = false;
     player.autoplay = true;
@@ -88,13 +90,13 @@ function destroyAudioPlayer(participantId) {
     const player = document.querySelector(`audio[data-participant-id="${participantId}"]`);
     player?.remove();
 }
-function subscribeToTracks(e, call, isVideoRecordingEnabled, isVideoEnabled) {
+function subscribeToTracks(e, call, isVideoRecordingEnabled) {
     if (e.participant.local)
         return;
     call.updateParticipant(e.participant.session_id, {
         setSubscribedTracks: {
             audio: true,
-            video: isVideoRecordingEnabled || isVideoEnabled,
+            video: isVideoRecordingEnabled,
         },
     });
 }
@@ -295,7 +297,9 @@ class Vapi extends VapiEventEmitter {
                 timestamp: new Date().toISOString()
             });
             const webCallStartTime = Date.now();
-            const webCall = (await client_1.client.call.callControllerCreateWebCall({
+            // An unset option stays undefined, so JSON.stringify drops the key and
+            // older servers never see it.
+            const createWebCallBody = {
                 assistant: typeof assistant === 'string' ? undefined : assistant,
                 assistantId: typeof assistant === 'string' ? assistant : undefined,
                 assistantOverrides,
@@ -305,7 +309,9 @@ class Vapi extends VapiEventEmitter {
                 workflowId: typeof workflow === 'string' ? workflow : undefined,
                 workflowOverrides,
                 roomDeleteOnUserLeaveEnabled: options?.roomDeleteOnUserLeaveEnabled,
-            })).data;
+                videoRecordingStartMode: options?.videoRecordingStartMode,
+            };
+            const webCall = (await client_1.client.call.callControllerCreateWebCall(createWebCallBody)).data;
             const webCallDuration = Date.now() - webCallStartTime;
             this.emit('call-start-progress', {
                 stage: 'web-call-creation',
@@ -319,12 +325,16 @@ class Vapi extends VapiEventEmitter {
                 }
             });
             const isVideoRecordingEnabled = webCall?.artifactPlan?.videoRecordingEnabled ?? false;
-            const isVideoEnabled = webCall?.assistant?.voice?.provider === 'tavus';
             // When video recording is enabled, the server sends a Daily meeting
-            // token that auto-starts the cloud recording on join — more reliable
-            // than calling startRecording() from a weak client network. Older
-            // servers don't send one; then the client starts the recording itself.
-            const callToken = webCall?.transport?.callToken;
+            // token. In client mode it auto-starts the cloud recording on join. In
+            // server mode it starts nothing: Vapi starts the recording from its
+            // servers once the user has joined, which a weak client network can't
+            // stop. Without a token the SDK emits recording-error and starts
+            // nothing.
+            const transport = webCall?.transport;
+            const callToken = transport?.callToken;
+            const isRecordingStartedByServer = transport?.videoRecordingStartMode === 'server';
+            const recordingTokenMissing = isVideoRecordingEnabled && !callToken;
             // Stage 2: Create Daily call object
             this.emit('call-start-progress', {
                 stage: 'daily-call-object-creation',
@@ -334,7 +344,6 @@ class Vapi extends VapiEventEmitter {
                     audioSource: this.dailyCallObject.audioSource ?? true,
                     videoSource: this.dailyCallObject.videoSource ?? isVideoRecordingEnabled,
                     isVideoRecordingEnabled,
-                    isVideoEnabled
                 }
             });
             const dailyCallStartTime = Date.now();
@@ -435,7 +444,7 @@ class Vapi extends VapiEventEmitter {
             this.call.on('participant-joined', (e) => {
                 if (!e || !this.call)
                     return;
-                subscribeToTracks(e, this.call, isVideoRecordingEnabled, isVideoEnabled);
+                subscribeToTracks(e, this.call, isVideoRecordingEnabled);
             });
             this.call.on('participant-updated', (e) => {
                 if (!e) {
@@ -449,6 +458,10 @@ class Vapi extends VapiEventEmitter {
                 }
                 this.detachAudioPlayer(e.participant.session_id);
             });
+            // Registered before join(), as in reconnect(): Vapi starts a server-mode
+            // recording when it sees the user join, so its start-failed message can
+            // arrive while join() is still in flight.
+            this.call.on('app-message', (e) => this.onAppMessage(e));
             // Registered before join(): a token-auto-started recording can begin
             // while join() is still in flight, so a listener added after join
             // could miss the event.
@@ -543,51 +556,29 @@ class Vapi extends VapiEventEmitter {
             }
             // Stage 5: Video recording setup (if enabled)
             if (isVideoRecordingEnabled && callToken) {
-                // The meeting token auto-started the recording at join, so there is
-                // nothing to request from the client.
+                // The meeting token auto-started the recording at join, or Vapi
+                // starts it from its servers, so there is nothing to request from the
+                // client.
                 this.emit('call-start-progress', {
                     stage: 'video-recording-setup',
                     status: 'completed',
                     timestamp: new Date().toISOString(),
-                    metadata: { action: 'auto-started-via-meeting-token' }
+                    metadata: {
+                        action: isRecordingStartedByServer
+                            ? 'started-by-server'
+                            : 'auto-started-via-meeting-token'
+                    }
                 });
             }
             else if (isVideoRecordingEnabled) {
+                // No token: nothing starts the recording. The recording-error is
+                // reported once start() has finished.
                 this.emit('call-start-progress', {
                     stage: 'video-recording-setup',
-                    status: 'started',
-                    timestamp: new Date().toISOString()
+                    status: 'failed',
+                    timestamp: new Date().toISOString(),
+                    metadata: { action: 'no-meeting-token' }
                 });
-                const recordingStartTime = Date.now();
-                try {
-                    recordingRequestedTime = new Date().getTime();
-                    this.startRecording();
-                    const recordingSetupDuration = Date.now() - recordingStartTime;
-                    this.emit('call-start-progress', {
-                        stage: 'video-recording-setup',
-                        status: 'completed',
-                        duration: recordingSetupDuration,
-                        timestamp: new Date().toISOString()
-                    });
-                }
-                catch (error) {
-                    const recordingSetupDuration = Date.now() - recordingStartTime;
-                    const serializedError = serializeError(error);
-                    this.emit('call-start-progress', {
-                        stage: 'video-recording-setup',
-                        status: 'failed',
-                        duration: recordingSetupDuration,
-                        timestamp: new Date().toISOString(),
-                        metadata: { error: serializedError.message }
-                    });
-                    this.emit('error', {
-                        type: 'video-recording-setup-error',
-                        stage: 'video-recording-setup',
-                        error: serializedError,
-                        timestamp: new Date().toISOString()
-                    });
-                    // Don't throw here, video recording is optional
-                }
             }
             else {
                 this.emit('call-start-progress', {
@@ -640,7 +631,6 @@ class Vapi extends VapiEventEmitter {
                 if (e)
                     this.handleLocalAudioLevel(e);
             });
-            this.call.on('app-message', (e) => this.onAppMessage(e));
             this.call.on('nonfatal-error', (e) => {
                 // https://docs.daily.co/reference/daily-js/events/meeting-events#type-audio-processor-error
                 if (e?.type === 'local-audio-level-observer-error') {
@@ -723,6 +713,9 @@ class Vapi extends VapiEventEmitter {
                 callId: webCall?.id || 'unknown',
                 timestamp: new Date().toISOString()
             });
+            if (recordingTokenMissing) {
+                this.recordingTokenMissingReportSchedule();
+            }
             return webCall;
         }
         catch (e) {
@@ -772,6 +765,12 @@ class Vapi extends VapiEventEmitter {
             else {
                 try {
                     const parsedMessage = JSON.parse(e.data);
+                    // Not a Vapi client message: re-emitted as recording-error, and kept
+                    // out of 'message' because its consumers switch on `type`.
+                    if (parsedMessage?.type === VIDEO_RECORDING_START_FAILED_MESSAGE_TYPE) {
+                        this.videoRecordingStartFailedReport(parsedMessage);
+                        return;
+                    }
                     this.emit('message', parsedMessage);
                     if (parsedMessage && 'type' in parsedMessage && 'status' in parsedMessage && parsedMessage.type === 'status-update' && parsedMessage.status === 'ended') {
                         this.hasEmittedCallEndedStatus = true;
@@ -939,6 +938,37 @@ class Vapi extends VapiEventEmitter {
             console.error(`[vapi] ${event} event listener threw`, error);
         }
     }
+    /**
+     * Reported in a later task, like Daily's own recording-error: start() or
+     * reconnect() has resolved and the caller's await continuation has run, so a
+     * listener registered right after it still hears this, and one that calls
+     * stop() can't interrupt call setup. Skipped if that call was stopped or
+     * replaced.
+     */
+    recordingTokenMissingReportSchedule() {
+        const call = this.call;
+        if (!call)
+            return;
+        setTimeout(() => {
+            if (!this.started || this.call !== call)
+                return;
+            this.emitToConsumer('recording-error', {
+                action: 'recording-error',
+                callClientId: call.callClientId,
+                errorMsg: 'Vapi returned no recording token, so the recording was not started. Call startRecording() to try starting it from the client.',
+            });
+        }, 0);
+    }
+    /** The fields are read defensively: the app message is untrusted JSON. */
+    videoRecordingStartFailedReport(message) {
+        const outcome = typeof message.outcome === 'string' ? message.outcome : 'unknown';
+        const error = typeof message.error === 'string' ? message.error : 'unknown';
+        this.emitToConsumer('recording-error', {
+            action: 'recording-error',
+            callClientId: this.call?.callClientId ?? '',
+            errorMsg: `Vapi couldn't start the recording (${outcome}): ${error}`,
+        });
+    }
     /** Drops the reference before removing, so nothing hands out a detached element. */
     detachAudioPlayer(participantId) {
         if (this.audioPlayer?.dataset.participantId === participantId) {
@@ -1171,11 +1201,14 @@ class Vapi extends VapiEventEmitter {
                 });
             }
             const isVideoRecordingEnabled = webCall?.artifactPlan?.videoRecordingEnabled ?? false;
-            const isVideoEnabled = webCall?.assistant?.voice?.provider === 'tavus';
-            // Same auto-start token as in start(). Rejoining with it while the
+            // Same token as in start(). In client mode, rejoining with it while the
             // recording is still running is safe; if the recording stopped when the
-            // user left, the token starts a new one.
+            // user left, the token starts a new one. In server mode it starts
+            // nothing. Without a token the SDK emits recording-error and starts
+            // nothing.
             const callToken = webCall?.transport?.callToken;
+            const isRecordingStartedByServer = webCall?.transport?.videoRecordingStartMode === 'server';
+            const recordingTokenMissing = isVideoRecordingEnabled && !callToken;
             // Stage 1: Create Daily call object
             this.emit('call-start-progress', {
                 stage: 'daily-call-object-creation',
@@ -1185,7 +1218,6 @@ class Vapi extends VapiEventEmitter {
                     audioSource: this.dailyCallObject.audioSource ?? true,
                     videoSource: this.dailyCallObject.videoSource ?? isVideoRecordingEnabled,
                     isVideoRecordingEnabled,
-                    isVideoEnabled
                 }
             });
             const dailyCallStartTime = Date.now();
@@ -1267,7 +1299,7 @@ class Vapi extends VapiEventEmitter {
             this.call.on('participant-joined', (e) => {
                 if (!e || !this.call)
                     return;
-                subscribeToTracks(e, this.call, isVideoRecordingEnabled, isVideoEnabled);
+                subscribeToTracks(e, this.call, isVideoRecordingEnabled);
             });
             this.call.on('participant-updated', (e) => {
                 if (!e) {
@@ -1384,45 +1416,29 @@ class Vapi extends VapiEventEmitter {
             });
             // Stage 4: Video recording setup (if enabled)
             if (isVideoRecordingEnabled && callToken) {
-                // The meeting token auto-started the recording at join, so there is
-                // nothing to request from the client.
+                // The meeting token auto-started the recording at join, or Vapi
+                // starts it from its servers, so there is nothing to request from the
+                // client.
                 this.emit('call-start-progress', {
                     stage: 'video-recording-setup',
                     status: 'completed',
                     timestamp: new Date().toISOString(),
-                    metadata: { action: 'auto-started-via-meeting-token' }
+                    metadata: {
+                        action: isRecordingStartedByServer
+                            ? 'started-by-server'
+                            : 'auto-started-via-meeting-token'
+                    }
                 });
             }
             else if (isVideoRecordingEnabled) {
+                // No token: nothing starts the recording. The recording-error is
+                // reported once reconnect() has finished.
                 this.emit('call-start-progress', {
                     stage: 'video-recording-setup',
-                    status: 'started',
-                    timestamp: new Date().toISOString()
+                    status: 'failed',
+                    timestamp: new Date().toISOString(),
+                    metadata: { action: 'no-meeting-token' }
                 });
-                const recordingStartTime = Date.now();
-                try {
-                    recordingRequestedTime = new Date().getTime();
-                    this.startRecording();
-                    const recordingSetupDuration = Date.now() - recordingStartTime;
-                    this.emit('call-start-progress', {
-                        stage: 'video-recording-setup',
-                        status: 'completed',
-                        duration: recordingSetupDuration,
-                        timestamp: new Date().toISOString()
-                    });
-                }
-                catch (error) {
-                    const recordingSetupDuration = Date.now() - recordingStartTime;
-                    const serializedError = serializeError(error);
-                    this.emit('call-start-progress', {
-                        stage: 'video-recording-setup',
-                        status: 'failed',
-                        duration: recordingSetupDuration,
-                        timestamp: new Date().toISOString(),
-                        metadata: { error: serializedError.message }
-                    });
-                    // Don't throw here, video recording is optional
-                }
             }
             else {
                 this.emit('call-start-progress', {
@@ -1516,6 +1532,9 @@ class Vapi extends VapiEventEmitter {
                 timestamp: new Date().toISOString()
             });
             this.emit('call-start');
+            if (recordingTokenMissing) {
+                this.recordingTokenMissingReportSchedule();
+            }
         }
         catch (e) {
             const totalDuration = Date.now() - startTime;

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@vapi-ai/web",
-  "version": "3.0.1",
+  "version": "3.1.0",
   "description": "",
   "main": "dist/vapi.js",
   "types": "dist/vapi.d.ts",