@zavudev/sdk 0.55.0 → 0.57.0

package/resources/calls.d.ts

@@ -0,0 +1,539 @@
+import { APIResource } from "../core/resource.js";
+import { APIPromise } from "../core/api-promise.js";
+import { Cursor, type CursorParams, PagePromise } from "../core/pagination.js";
+import { RequestOptions } from "../internal/request-options.js";
+export declare class Calls extends APIResource {
+    /**
+     * Place an outbound voice call answered by the voice agent configured on the
+     * sender. Zavu dials the recipient and runs the conversation through its managed
+     * voice pipeline (speech recognition, the agent's LLM, and speech synthesis, with
+     * real-time interruption handling).
+     *
+     * **Requirements:**
+     *
+     * - The Voice Agents feature must be enabled for your team (otherwise `403`).
+     * - An account that has verified nothing may only call the phone numbers the
+     *   project has verified (`403` with code `destination_not_verified`, and
+     *   `details.verifiedNumbers` lists them), and at most 5 calls a day (`429` with
+     *   code `daily_limit_exceeded`). A number is verified from the dashboard's
+     *   Sandbox screen by sending the pre-filled WhatsApp message from that phone; the
+     *   same verification covers SMS and calls. Verify your identity, add a payment
+     *   method, settle a deposit or subscribe to call any destination. That raises the
+     *   ceiling to 50 calls a day on Free; paid plans have no daily call ceiling. Full
+     *   reference: https://docs.zavu.dev/concepts/sending-limits
+     * - The sender's agent must have `voice.enabled` set to `true`.
+     * - Not available with test-mode API keys.
+     *
+     * **Billing:** Voice calls are billed per minute of connected time plus telephony,
+     * deducted from your prepaid balance. A short-duration estimate is reserved when
+     * the call is placed; you are charged for the actual duration when the call ends.
+     *
+     * @example
+     * ```ts
+     * const call = await client.calls.create({
+     *   to: '+56912345678',
+     * });
+     * ```
+     */
+    create(body: CallCreateParams, options?: RequestOptions): APIPromise<CallCreateResponse>;
+    /**
+     * Retrieve a single voice call, including its full transcript once the
+     * conversation has produced turns.
+     *
+     * @example
+     * ```ts
+     * const call = await client.calls.retrieve('callId');
+     * ```
+     */
+    retrieve(callID: string, options?: RequestOptions): APIPromise<CallRetrieveResponse>;
+    /**
+     * List voice calls for this project, most recent first. Transcripts are omitted
+     * from the list; fetch a single call to get its transcript.
+     *
+     * @example
+     * ```ts
+     * // Automatically fetches more pages as needed.
+     * for await (const callListResponse of client.calls.list()) {
+     *   // ...
+     * }
+     * ```
+     */
+    list(query?: CallListParams | null | undefined, options?: RequestOptions): PagePromise<CallListResponsesCursor, CallListResponse>;
+    /**
+     * End an active voice call. The call must still be ringing or in progress. Not
+     * available with test-mode API keys.
+     *
+     * @example
+     * ```ts
+     * const response = await client.calls.hangup('callId');
+     * ```
+     */
+    hangup(callID: string, options?: RequestOptions): APIPromise<CallHangupResponse>;
+}
+export type CallListResponsesCursor = Cursor<CallListResponse>;
+export interface CallCreateResponse {
+    call: CallCreateResponse.Call;
+}
+export declare namespace CallCreateResponse {
+    interface Call {
+        id: string;
+        createdAt: string;
+        /**
+         * Whether the call was placed by Zavu (outbound) or received from a caller
+         * (inbound).
+         */
+        direction: 'inbound' | 'outbound';
+        /**
+         * Caller phone number in E.164 format. Your sender's number for outbound calls;
+         * the caller's number for inbound calls.
+         */
+        from: string;
+        /**
+         * Lifecycle status of a voice call.
+         *
+         * - `queued`: outbound call created, not yet dialing.
+         * - `ringing`: dialing (outbound) or received and ringing (inbound).
+         * - `in_progress`: answered, the agent is connected.
+         * - `completed`: ended after a conversation.
+         * - `failed`: could not be completed.
+         * - `busy`: the line was busy.
+         * - `no_answer`: rang but was not answered.
+         * - `canceled`: canceled before it was answered.
+         */
+        status: 'queued' | 'ringing' | 'in_progress' | 'completed' | 'failed' | 'busy' | 'no_answer' | 'canceled';
+        /**
+         * Callee phone number in E.164 format.
+         */
+        to: string;
+        /**
+         * When the call was answered.
+         */
+        answeredAt?: string | null;
+        /**
+         * Total cost of the call in USD, combining the managed voice pipeline per-minute
+         * charge and telephony. Available once the call has ended.
+         */
+        cost?: number | null;
+        /**
+         * Billable talk time in seconds, measured from answer to hangup.
+         */
+        durationSeconds?: number | null;
+        /**
+         * When the call ended.
+         */
+        endedAt?: string | null;
+        /**
+         * Why the call ended (e.g. `agent_ended`, `max_duration`, `transfer`, `hangup`).
+         * Present once the call is no longer active.
+         */
+        endReason?: string | null;
+        /**
+         * Arbitrary metadata you attached when creating the call.
+         */
+        metadata?: {
+            [key: string]: string;
+        };
+        /**
+         * Ordered transcript of the call. Included when retrieving a single call; omitted
+         * from list responses.
+         */
+        transcript?: Array<Call.Transcript>;
+        /**
+         * Number of conversation turns exchanged during the call.
+         */
+        turnCount?: number | null;
+        updatedAt?: string;
+    }
+    namespace Call {
+        /**
+         * A single turn in a voice call transcript.
+         */
+        interface Transcript {
+            /**
+             * Who produced the turn. `tool` records a tool call the agent made during the
+             * conversation.
+             */
+            role: 'user' | 'assistant' | 'tool';
+            /**
+             * Ordinal position of the turn within the call, starting at 0.
+             */
+            seq: number;
+            /**
+             * Transcribed speech for `user` and `assistant` turns, or a JSON summary of the
+             * tool call for `tool` turns.
+             */
+            text: string;
+            /**
+             * When the turn ended.
+             */
+            endedAt?: string | null;
+            /**
+             * When the turn started.
+             */
+            startedAt?: string | null;
+        }
+    }
+}
+export interface CallRetrieveResponse {
+    call: CallRetrieveResponse.Call;
+}
+export declare namespace CallRetrieveResponse {
+    interface Call {
+        id: string;
+        createdAt: string;
+        /**
+         * Whether the call was placed by Zavu (outbound) or received from a caller
+         * (inbound).
+         */
+        direction: 'inbound' | 'outbound';
+        /**
+         * Caller phone number in E.164 format. Your sender's number for outbound calls;
+         * the caller's number for inbound calls.
+         */
+        from: string;
+        /**
+         * Lifecycle status of a voice call.
+         *
+         * - `queued`: outbound call created, not yet dialing.
+         * - `ringing`: dialing (outbound) or received and ringing (inbound).
+         * - `in_progress`: answered, the agent is connected.
+         * - `completed`: ended after a conversation.
+         * - `failed`: could not be completed.
+         * - `busy`: the line was busy.
+         * - `no_answer`: rang but was not answered.
+         * - `canceled`: canceled before it was answered.
+         */
+        status: 'queued' | 'ringing' | 'in_progress' | 'completed' | 'failed' | 'busy' | 'no_answer' | 'canceled';
+        /**
+         * Callee phone number in E.164 format.
+         */
+        to: string;
+        /**
+         * When the call was answered.
+         */
+        answeredAt?: string | null;
+        /**
+         * Total cost of the call in USD, combining the managed voice pipeline per-minute
+         * charge and telephony. Available once the call has ended.
+         */
+        cost?: number | null;
+        /**
+         * Billable talk time in seconds, measured from answer to hangup.
+         */
+        durationSeconds?: number | null;
+        /**
+         * When the call ended.
+         */
+        endedAt?: string | null;
+        /**
+         * Why the call ended (e.g. `agent_ended`, `max_duration`, `transfer`, `hangup`).
+         * Present once the call is no longer active.
+         */
+        endReason?: string | null;
+        /**
+         * Arbitrary metadata you attached when creating the call.
+         */
+        metadata?: {
+            [key: string]: string;
+        };
+        /**
+         * Ordered transcript of the call. Included when retrieving a single call; omitted
+         * from list responses.
+         */
+        transcript?: Array<Call.Transcript>;
+        /**
+         * Number of conversation turns exchanged during the call.
+         */
+        turnCount?: number | null;
+        updatedAt?: string;
+    }
+    namespace Call {
+        /**
+         * A single turn in a voice call transcript.
+         */
+        interface Transcript {
+            /**
+             * Who produced the turn. `tool` records a tool call the agent made during the
+             * conversation.
+             */
+            role: 'user' | 'assistant' | 'tool';
+            /**
+             * Ordinal position of the turn within the call, starting at 0.
+             */
+            seq: number;
+            /**
+             * Transcribed speech for `user` and `assistant` turns, or a JSON summary of the
+             * tool call for `tool` turns.
+             */
+            text: string;
+            /**
+             * When the turn ended.
+             */
+            endedAt?: string | null;
+            /**
+             * When the turn started.
+             */
+            startedAt?: string | null;
+        }
+    }
+}
+export interface CallListResponse {
+    id: string;
+    createdAt: string;
+    /**
+     * Whether the call was placed by Zavu (outbound) or received from a caller
+     * (inbound).
+     */
+    direction: 'inbound' | 'outbound';
+    /**
+     * Caller phone number in E.164 format. Your sender's number for outbound calls;
+     * the caller's number for inbound calls.
+     */
+    from: string;
+    /**
+     * Lifecycle status of a voice call.
+     *
+     * - `queued`: outbound call created, not yet dialing.
+     * - `ringing`: dialing (outbound) or received and ringing (inbound).
+     * - `in_progress`: answered, the agent is connected.
+     * - `completed`: ended after a conversation.
+     * - `failed`: could not be completed.
+     * - `busy`: the line was busy.
+     * - `no_answer`: rang but was not answered.
+     * - `canceled`: canceled before it was answered.
+     */
+    status: 'queued' | 'ringing' | 'in_progress' | 'completed' | 'failed' | 'busy' | 'no_answer' | 'canceled';
+    /**
+     * Callee phone number in E.164 format.
+     */
+    to: string;
+    /**
+     * When the call was answered.
+     */
+    answeredAt?: string | null;
+    /**
+     * Total cost of the call in USD, combining the managed voice pipeline per-minute
+     * charge and telephony. Available once the call has ended.
+     */
+    cost?: number | null;
+    /**
+     * Billable talk time in seconds, measured from answer to hangup.
+     */
+    durationSeconds?: number | null;
+    /**
+     * When the call ended.
+     */
+    endedAt?: string | null;
+    /**
+     * Why the call ended (e.g. `agent_ended`, `max_duration`, `transfer`, `hangup`).
+     * Present once the call is no longer active.
+     */
+    endReason?: string | null;
+    /**
+     * Arbitrary metadata you attached when creating the call.
+     */
+    metadata?: {
+        [key: string]: string;
+    };
+    /**
+     * Ordered transcript of the call. Included when retrieving a single call; omitted
+     * from list responses.
+     */
+    transcript?: Array<CallListResponse.Transcript>;
+    /**
+     * Number of conversation turns exchanged during the call.
+     */
+    turnCount?: number | null;
+    updatedAt?: string;
+}
+export declare namespace CallListResponse {
+    /**
+     * A single turn in a voice call transcript.
+     */
+    interface Transcript {
+        /**
+         * Who produced the turn. `tool` records a tool call the agent made during the
+         * conversation.
+         */
+        role: 'user' | 'assistant' | 'tool';
+        /**
+         * Ordinal position of the turn within the call, starting at 0.
+         */
+        seq: number;
+        /**
+         * Transcribed speech for `user` and `assistant` turns, or a JSON summary of the
+         * tool call for `tool` turns.
+         */
+        text: string;
+        /**
+         * When the turn ended.
+         */
+        endedAt?: string | null;
+        /**
+         * When the turn started.
+         */
+        startedAt?: string | null;
+    }
+}
+export interface CallHangupResponse {
+    call: CallHangupResponse.Call;
+}
+export declare namespace CallHangupResponse {
+    interface Call {
+        id: string;
+        createdAt: string;
+        /**
+         * Whether the call was placed by Zavu (outbound) or received from a caller
+         * (inbound).
+         */
+        direction: 'inbound' | 'outbound';
+        /**
+         * Caller phone number in E.164 format. Your sender's number for outbound calls;
+         * the caller's number for inbound calls.
+         */
+        from: string;
+        /**
+         * Lifecycle status of a voice call.
+         *
+         * - `queued`: outbound call created, not yet dialing.
+         * - `ringing`: dialing (outbound) or received and ringing (inbound).
+         * - `in_progress`: answered, the agent is connected.
+         * - `completed`: ended after a conversation.
+         * - `failed`: could not be completed.
+         * - `busy`: the line was busy.
+         * - `no_answer`: rang but was not answered.
+         * - `canceled`: canceled before it was answered.
+         */
+        status: 'queued' | 'ringing' | 'in_progress' | 'completed' | 'failed' | 'busy' | 'no_answer' | 'canceled';
+        /**
+         * Callee phone number in E.164 format.
+         */
+        to: string;
+        /**
+         * When the call was answered.
+         */
+        answeredAt?: string | null;
+        /**
+         * Total cost of the call in USD, combining the managed voice pipeline per-minute
+         * charge and telephony. Available once the call has ended.
+         */
+        cost?: number | null;
+        /**
+         * Billable talk time in seconds, measured from answer to hangup.
+         */
+        durationSeconds?: number | null;
+        /**
+         * When the call ended.
+         */
+        endedAt?: string | null;
+        /**
+         * Why the call ended (e.g. `agent_ended`, `max_duration`, `transfer`, `hangup`).
+         * Present once the call is no longer active.
+         */
+        endReason?: string | null;
+        /**
+         * Arbitrary metadata you attached when creating the call.
+         */
+        metadata?: {
+            [key: string]: string;
+        };
+        /**
+         * Ordered transcript of the call. Included when retrieving a single call; omitted
+         * from list responses.
+         */
+        transcript?: Array<Call.Transcript>;
+        /**
+         * Number of conversation turns exchanged during the call.
+         */
+        turnCount?: number | null;
+        updatedAt?: string;
+    }
+    namespace Call {
+        /**
+         * A single turn in a voice call transcript.
+         */
+        interface Transcript {
+            /**
+             * Who produced the turn. `tool` records a tool call the agent made during the
+             * conversation.
+             */
+            role: 'user' | 'assistant' | 'tool';
+            /**
+             * Ordinal position of the turn within the call, starting at 0.
+             */
+            seq: number;
+            /**
+             * Transcribed speech for `user` and `assistant` turns, or a JSON summary of the
+             * tool call for `tool` turns.
+             */
+            text: string;
+            /**
+             * When the turn ended.
+             */
+            endedAt?: string | null;
+            /**
+             * When the turn started.
+             */
+            startedAt?: string | null;
+        }
+    }
+}
+export interface CallCreateParams {
+    /**
+     * Recipient phone number in E.164 format.
+     */
+    to: string;
+    /**
+     * Overrides the agent's configured greeting for this call only.
+     */
+    greeting?: string;
+    /**
+     * Language the agent speaks on this call only, as a BCP-47 tag (`en`, `es`,
+     * `es-ES`, `pt-BR`), or `auto` to detect the caller's language and follow it.
+     * Overrides the agent's configured language for speech recognition, the agent's
+     * replies, and the synthesized voice. If the agent uses a custom voice you
+     * supplied, that voice is kept and only the language changes. When omitted, the
+     * agent's configured language is used.
+     */
+    language?: string;
+    /**
+     * Overrides the agent's maximum call duration for this call only.
+     */
+    maxDurationMinutes?: number;
+    /**
+     * Arbitrary metadata to associate with the call. Returned on the call object and
+     * included in voice webhooks.
+     */
+    metadata?: {
+        [key: string]: string;
+    };
+    /**
+     * Sender profile that places the call. Uses the project's default sender if
+     * omitted. The sender's agent must have voice enabled.
+     */
+    senderId?: string;
+}
+export interface CallListParams extends CursorParams {
+    /**
+     * Whether the call was placed by Zavu (outbound) or received from a caller
+     * (inbound).
+     */
+    direction?: 'inbound' | 'outbound';
+    /**
+     * Lifecycle status of a voice call.
+     *
+     * - `queued`: outbound call created, not yet dialing.
+     * - `ringing`: dialing (outbound) or received and ringing (inbound).
+     * - `in_progress`: answered, the agent is connected.
+     * - `completed`: ended after a conversation.
+     * - `failed`: could not be completed.
+     * - `busy`: the line was busy.
+     * - `no_answer`: rang but was not answered.
+     * - `canceled`: canceled before it was answered.
+     */
+    status?: 'queued' | 'ringing' | 'in_progress' | 'completed' | 'failed' | 'busy' | 'no_answer' | 'canceled';
+}
+export declare namespace Calls {
+    export { type CallCreateResponse as CallCreateResponse, type CallRetrieveResponse as CallRetrieveResponse, type CallListResponse as CallListResponse, type CallHangupResponse as CallHangupResponse, type CallListResponsesCursor as CallListResponsesCursor, type CallCreateParams as CallCreateParams, type CallListParams as CallListParams, };
+}
+//# sourceMappingURL=calls.d.ts.map

package/resources/calls.d.ts.map

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

package/resources/calls.js

@@ -0,0 +1,85 @@
+"use strict";
+// File generated from our OpenAPI spec by Stainless. See CONTRIBUTING.md for details.
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.Calls = void 0;
+const resource_1 = require("../core/resource.js");
+const pagination_1 = require("../core/pagination.js");
+const path_1 = require("../internal/utils/path.js");
+class Calls extends resource_1.APIResource {
+    /**
+     * Place an outbound voice call answered by the voice agent configured on the
+     * sender. Zavu dials the recipient and runs the conversation through its managed
+     * voice pipeline (speech recognition, the agent's LLM, and speech synthesis, with
+     * real-time interruption handling).
+     *
+     * **Requirements:**
+     *
+     * - The Voice Agents feature must be enabled for your team (otherwise `403`).
+     * - An account that has verified nothing may only call the phone numbers the
+     *   project has verified (`403` with code `destination_not_verified`, and
+     *   `details.verifiedNumbers` lists them), and at most 5 calls a day (`429` with
+     *   code `daily_limit_exceeded`). A number is verified from the dashboard's
+     *   Sandbox screen by sending the pre-filled WhatsApp message from that phone; the
+     *   same verification covers SMS and calls. Verify your identity, add a payment
+     *   method, settle a deposit or subscribe to call any destination. That raises the
+     *   ceiling to 50 calls a day on Free; paid plans have no daily call ceiling. Full
+     *   reference: https://docs.zavu.dev/concepts/sending-limits
+     * - The sender's agent must have `voice.enabled` set to `true`.
+     * - Not available with test-mode API keys.
+     *
+     * **Billing:** Voice calls are billed per minute of connected time plus telephony,
+     * deducted from your prepaid balance. A short-duration estimate is reserved when
+     * the call is placed; you are charged for the actual duration when the call ends.
+     *
+     * @example
+     * ```ts
+     * const call = await client.calls.create({
+     *   to: '+56912345678',
+     * });
+     * ```
+     */
+    create(body, options) {
+        return this._client.post('/v1/calls', { body, ...options });
+    }
+    /**
+     * Retrieve a single voice call, including its full transcript once the
+     * conversation has produced turns.
+     *
+     * @example
+     * ```ts
+     * const call = await client.calls.retrieve('callId');
+     * ```
+     */
+    retrieve(callID, options) {
+        return this._client.get((0, path_1.path) `/v1/calls/${callID}`, options);
+    }
+    /**
+     * List voice calls for this project, most recent first. Transcripts are omitted
+     * from the list; fetch a single call to get its transcript.
+     *
+     * @example
+     * ```ts
+     * // Automatically fetches more pages as needed.
+     * for await (const callListResponse of client.calls.list()) {
+     *   // ...
+     * }
+     * ```
+     */
+    list(query = {}, options) {
+        return this._client.getAPIList('/v1/calls', (pagination_1.Cursor), { query, ...options });
+    }
+    /**
+     * End an active voice call. The call must still be ringing or in progress. Not
+     * available with test-mode API keys.
+     *
+     * @example
+     * ```ts
+     * const response = await client.calls.hangup('callId');
+     * ```
+     */
+    hangup(callID, options) {
+        return this._client.post((0, path_1.path) `/v1/calls/${callID}/hangup`, options);
+    }
+}
+exports.Calls = Calls;
+//# sourceMappingURL=calls.js.map

package/resources/calls.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"calls.js","sourceRoot":"","sources":["../src/resources/calls.ts"],"names":[],"mappings":";AAAA,sFAAsF;;;AAEtF,kDAA+C;AAE/C,sDAA4E;AAE5E,oDAA8C;AAE9C,MAAa,KAAM,SAAQ,sBAAW;IACpC;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;OA+BG;IACH,MAAM,CAAC,IAAsB,EAAE,OAAwB;QACrD,OAAO,IAAI,CAAC,OAAO,CAAC,IAAI,CAAC,WAAW,EAAE,EAAE,IAAI,EAAE,GAAG,OAAO,EAAE,CAAC,CAAC;IAC9D,CAAC;IAED;;;;;;;;OAQG;IACH,QAAQ,CAAC,MAAc,EAAE,OAAwB;QAC/C,OAAO,IAAI,CAAC,OAAO,CAAC,GAAG,CAAC,IAAA,WAAI,EAAA,aAAa,MAAM,EAAE,EAAE,OAAO,CAAC,CAAC;IAC9D,CAAC;IAED;;;;;;;;;;;OAWG;IACH,IAAI,CACF,QAA2C,EAAE,EAC7C,OAAwB;QAExB,OAAO,IAAI,CAAC,OAAO,CAAC,UAAU,CAAC,WAAW,EAAE,CAAA,mBAAwB,CAAA,EAAE,EAAE,KAAK,EAAE,GAAG,OAAO,EAAE,CAAC,CAAC;IAC/F,CAAC;IAED;;;;;;;;OAQG;IACH,MAAM,CAAC,MAAc,EAAE,OAAwB;QAC7C,OAAO,IAAI,CAAC,OAAO,CAAC,IAAI,CAAC,IAAA,WAAI,EAAA,aAAa,MAAM,SAAS,EAAE,OAAO,CAAC,CAAC;IACtE,CAAC;CACF;AAjFD,sBAiFC"}