@roarkanalytics/sdk 2.13.1 → 2.15.0

package/resources/call.d.ts

@@ -1,6 +1,15 @@
 import { APIResource } from "../resource.js";
 import * as Core from "../core.js";
 export declare class Call extends APIResource {
+    /**
+     * Create a new call with recording, transcript, agents, and customers
+     */
+    create(body: CallCreateParams, options?: Core.RequestOptions): Core.APIPromise<CallCreateResponse>;
+    /**
+     * Returns a paginated list of calls for the authenticated project.
+     */
+    list(query?: CallListParams, options?: Core.RequestOptions): Core.APIPromise<CallListResponse>;
+    list(options?: Core.RequestOptions): Core.APIPromise<CallListResponse>;
     /**
      * Retrieve an existing call by its unique identifier
      */
@@ -8,18 +17,184 @@ export declare class Call extends APIResource {
     /**
      * Fetch all evaluation run results for a specific call.
      */
-    getEvaluationRuns(callId: string, options?: Core.RequestOptions): Core.APIPromise<CallGetEvaluationRunsResponse>;
+    listEvaluationRuns(callId: string, options?: Core.RequestOptions): Core.APIPromise<CallListEvaluationRunsResponse>;
     /**
      * Fetch all call-level metrics for a specific call, including both
      * system-generated and custom metrics. Only returns successfully computed metrics.
      */
-    getMetrics(callId: string, query?: CallGetMetricsParams, options?: Core.RequestOptions): Core.APIPromise<CallGetMetricsResponse>;
-    getMetrics(callId: string, options?: Core.RequestOptions): Core.APIPromise<CallGetMetricsResponse>;
+    listMetrics(callId: string, query?: CallListMetricsParams, options?: Core.RequestOptions): Core.APIPromise<CallListMetricsResponse>;
+    listMetrics(callId: string, options?: Core.RequestOptions): Core.APIPromise<CallListMetricsResponse>;
     /**
      * Fetch detailed sentiment analysis results for a specific call, including
      * emotional tone, key phrases, and sentiment scores.
      */
-    getSentimentRuns(callId: string, options?: Core.RequestOptions): Core.APIPromise<CallGetSentimentRunsResponse>;
+    listSentimentRuns(callId: string, options?: Core.RequestOptions): Core.APIPromise<CallListSentimentRunsResponse>;
+}
+export interface CallCreateResponse {
+    /**
+     * Response after creating a call
+     */
+    data: CallCreateResponse.Data;
+}
+export declare namespace CallCreateResponse {
+    /**
+     * Response after creating a call
+     */
+    interface Data {
+        /**
+         * Unique identifier for the call
+         */
+        id: string;
+        agents: Array<Data.Agent> | null;
+        /**
+         * Direction of the call (inbound or outbound)
+         */
+        callDirection: 'INBOUND' | 'OUTBOUND';
+        createdAt: string | null;
+        customers: Array<Data.Customer> | null;
+        /**
+         * ID of the project this call belongs to
+         */
+        projectId: string;
+        /**
+         * Timestamp when the call started
+         */
+        startedAt: string;
+        status: 'RINGING' | 'IN_PROGRESS' | 'ENDED' | null;
+    }
+    namespace Data {
+        interface Agent {
+            id: string;
+            endpoint?: Agent.Endpoint | null;
+        }
+        namespace Agent {
+            interface Endpoint {
+                id: string;
+                environment: string;
+                phoneNumberE164?: string | null;
+            }
+        }
+        interface Customer {
+            label?: string | null;
+            phoneNumberE164?: string | null;
+        }
+    }
+}
+export interface CallListResponse {
+    data: Array<CallListResponse.Data>;
+    pagination: CallListResponse.Pagination;
+}
+export declare namespace CallListResponse {
+    /**
+     * Response containing call information
+     */
+    interface Data {
+        /**
+         * Unique identifier for the call
+         */
+        id: string;
+        /**
+         * Direction of the call (inbound or outbound)
+         */
+        callDirection: 'INBOUND' | 'OUTBOUND';
+        /**
+         * ID of the project this call belongs to
+         */
+        projectId: string;
+        /**
+         * Timestamp when the call started
+         */
+        startedAt: string;
+        /**
+         * Agent information
+         */
+        agents?: Array<Data.Agent> | null;
+        /**
+         * Timestamp when the call record was created
+         */
+        createdAt?: string | null;
+        /**
+         * Customer information
+         */
+        customers?: Array<Data.Customer> | null;
+        /**
+         * Duration of the call in milliseconds
+         */
+        durationMs?: number | null;
+        /**
+         * Timestamp when the call ended
+         */
+        endedAt?: string | null;
+        /**
+         * Status indicating how the call ended
+         */
+        endedStatus?: 'PARTICIPANTS_DID_NOT_SPEAK' | 'AGENT_DID_NOT_ANSWER' | 'AGENT_DID_NOT_SPEAK' | 'AGENT_STOPPED_SPEAKING' | 'AGENT_ENDED_CALL' | 'AGENT_TRANSFERRED_CALL' | 'AGENT_BUSY' | 'AGENT_ERROR' | 'CUSTOMER_ENDED_CALL' | 'VOICE_MAIL_REACHED' | 'SILENCE_TIME_OUT' | 'PHONE_CALL_PROVIDER_CONNECTION_ERROR' | 'CUSTOMER_DID_NOT_ANSWER' | 'CUSTOMER_DID_NOT_SPEAK' | 'CUSTOMER_STOPPED_SPEAKING' | 'CUSTOMER_BUSY' | 'DIAL_ERROR' | 'MAX_DURATION_REACHED' | 'UNKNOWN' | null;
+        /**
+         * Custom properties associated with the call
+         */
+        properties?: {
+            [key: string]: unknown;
+        } | null;
+        /**
+         * Pre-signed URL to the call recording (expires in 1 hour)
+         */
+        recordingUrl?: string | null;
+        /**
+         * ID of the simulation job if this call was generated by a simulation
+         */
+        simulationJobId?: string | null;
+        /**
+         * Current status of the call
+         */
+        status?: 'RINGING' | 'IN_PROGRESS' | 'ENDED' | null;
+        /**
+         * Auto-generated summary of the call conversation
+         */
+        summary?: string | null;
+        /**
+         * ID of the call that superseded this one (if applicable)
+         */
+        supersededByCallId?: string | null;
+        /**
+         * Auto-generated title for the call based on content
+         */
+        title?: string | null;
+        /**
+         * Timestamp when the call record was last updated
+         */
+        updatedAt?: string | null;
+    }
+    namespace Data {
+        interface Agent {
+            id: string;
+            endpoint?: Agent.Endpoint | null;
+        }
+        namespace Agent {
+            interface Endpoint {
+                id: string;
+                environment: string;
+                phoneNumberE164?: string | null;
+            }
+        }
+        interface Customer {
+            label?: string | null;
+            phoneNumberE164?: string | null;
+        }
+    }
+    interface Pagination {
+        /**
+         * Whether there are more items to fetch
+         */
+        hasMore: boolean;
+        /**
+         * Cursor for the next page of items
+         */
+        nextCursor: string | null;
+        /**
+         * Total number of items
+         */
+        total: number;
+    }
 }
 export interface CallGetByIDResponse {
     /**
@@ -72,6 +247,12 @@ export declare namespace CallGetByIDResponse {
          * Status indicating how the call ended
          */
         endedStatus?: 'PARTICIPANTS_DID_NOT_SPEAK' | 'AGENT_DID_NOT_ANSWER' | 'AGENT_DID_NOT_SPEAK' | 'AGENT_STOPPED_SPEAKING' | 'AGENT_ENDED_CALL' | 'AGENT_TRANSFERRED_CALL' | 'AGENT_BUSY' | 'AGENT_ERROR' | 'CUSTOMER_ENDED_CALL' | 'VOICE_MAIL_REACHED' | 'SILENCE_TIME_OUT' | 'PHONE_CALL_PROVIDER_CONNECTION_ERROR' | 'CUSTOMER_DID_NOT_ANSWER' | 'CUSTOMER_DID_NOT_SPEAK' | 'CUSTOMER_STOPPED_SPEAKING' | 'CUSTOMER_BUSY' | 'DIAL_ERROR' | 'MAX_DURATION_REACHED' | 'UNKNOWN' | null;
+        /**
+         * Custom properties associated with the call
+         */
+        properties?: {
+            [key: string]: unknown;
+        } | null;
         /**
          * Pre-signed URL to the call recording (expires in 1 hour)
          */
@@ -104,7 +285,7 @@ export declare namespace CallGetByIDResponse {
     namespace Data {
         interface Agent {
             id: string;
-            endpoint: Agent.Endpoint;
+            endpoint?: Agent.Endpoint | null;
         }
         namespace Agent {
             interface Endpoint {
@@ -114,17 +295,18 @@ export declare namespace CallGetByIDResponse {
             }
         }
         interface Customer {
+            label?: string | null;
             phoneNumberE164?: string | null;
         }
     }
 }
-export interface CallGetEvaluationRunsResponse {
+export interface CallListEvaluationRunsResponse {
     /**
      * Evaluation run response payload
      */
-    data: Array<CallGetEvaluationRunsResponse.Data>;
+    data: Array<CallListEvaluationRunsResponse.Data>;
 }
-export declare namespace CallGetEvaluationRunsResponse {
+export declare namespace CallListEvaluationRunsResponse {
     interface Data {
         /**
          * All block runs for this evaluator, including skipped ones
@@ -270,13 +452,13 @@ export declare namespace CallGetEvaluationRunsResponse {
         }
     }
 }
-export interface CallGetMetricsResponse {
+export interface CallListMetricsResponse {
     /**
      * Call metrics response payload grouped by metric definition
      */
-    data: Array<CallGetMetricsResponse.Data>;
+    data: Array<CallListMetricsResponse.Data>;
 }
-export declare namespace CallGetMetricsResponse {
+export declare namespace CallListMetricsResponse {
     /**
      * Call metric data grouped by metric definition
      */
@@ -436,13 +618,13 @@ export declare namespace CallGetMetricsResponse {
         }
     }
 }
-export interface CallGetSentimentRunsResponse {
+export interface CallListSentimentRunsResponse {
     /**
      * Sentiment run response payload
      */
-    data: CallGetSentimentRunsResponse.Data;
+    data: CallListSentimentRunsResponse.Data;
 }
-export declare namespace CallGetSentimentRunsResponse {
+export declare namespace CallListSentimentRunsResponse {
     /**
      * Sentiment run response payload
      */
@@ -465,7 +647,550 @@ export declare namespace CallGetSentimentRunsResponse {
         commonEmotion?: string;
     }
 }
-export interface CallGetMetricsParams {
+export interface CallCreateParams {
+    /**
+     * Direction of the call (INBOUND or OUTBOUND)
+     */
+    callDirection: 'INBOUND' | 'OUTBOUND';
+    /**
+     * Interface type of the call (PHONE or WEB)
+     */
+    interfaceType: 'PHONE' | 'WEB';
+    /**
+     * URL of source recording (must be an accessible WAV, MP3, or MP4 file). Can be a
+     * signed URL.
+     */
+    recordingUrl: string;
+    /**
+     * When the call started (ISO 8601 format)
+     */
+    startedAt: string;
+    /**
+     * Single agent participating in the call. Use this for simpler API when you have
+     * only one agent.
+     */
+    agent?: CallCreateParams.AgentIdentificationByRoarkID | CallCreateParams.AgentIdentificationByName | CallCreateParams.AgentIdentificationByCustomID;
+    /**
+     * Agents participating in the call. Each agent requires identification and prompt
+     * information.
+     */
+    agents?: Array<CallCreateParams.AgentIdentificationByRoarkID | CallCreateParams.AgentIdentificationByName | CallCreateParams.AgentIdentificationByCustomID>;
+    /**
+     * Single customer participating in the call. Use this for simpler API when you
+     * have only one customer.
+     */
+    customer?: CallCreateParams.Customer;
+    /**
+     * Customers participating in the call.
+     */
+    customers?: Array<CallCreateParams.Customer>;
+    /**
+     * High-level call end status, indicating how the call terminated
+     */
+    endedStatus?: 'PARTICIPANTS_DID_NOT_SPEAK' | 'AGENT_DID_NOT_ANSWER' | 'AGENT_DID_NOT_SPEAK' | 'AGENT_STOPPED_SPEAKING' | 'AGENT_ENDED_CALL' | 'AGENT_TRANSFERRED_CALL' | 'AGENT_BUSY' | 'AGENT_ERROR' | 'CUSTOMER_ENDED_CALL' | 'VOICE_MAIL_REACHED' | 'SILENCE_TIME_OUT' | 'PHONE_CALL_PROVIDER_CONNECTION_ERROR' | 'CUSTOMER_DID_NOT_ANSWER' | 'CUSTOMER_DID_NOT_SPEAK' | 'CUSTOMER_STOPPED_SPEAKING' | 'CUSTOMER_BUSY' | 'DIAL_ERROR' | 'MAX_DURATION_REACHED' | 'UNKNOWN';
+    /**
+     * Custom properties to include with the call. These can be used for filtering and
+     * will show in the call details page
+     */
+    properties?: {
+        [key: string]: unknown;
+    };
+    /**
+     * URL of source stereo recording. Must be accessible. Can be a signed URL.
+     * Supported formats: WAV, MP3, MP4.
+     */
+    stereoRecordingUrl?: string;
+    /**
+     * List of tool invocations made during the call
+     */
+    toolInvocations?: Array<CallCreateParams.ToolInvocation>;
+    /**
+     * List of transcript entries made during the call
+     */
+    transcript?: Array<CallCreateParams.TranscriptEntryAgent | CallCreateParams.TranscriptEntryCustomer>;
+}
+export declare namespace CallCreateParams {
+    interface AgentIdentificationByRoarkID {
+        /**
+         * Existing Roark agent ID
+         */
+        roarkId: string;
+        /**
+         * Endpoint configuration for this agent (optional)
+         */
+        endpoint?: AgentIdentificationByRoarkID.AgentEndpointByID | AgentIdentificationByRoarkID.AgentEndpointByValue;
+        /**
+         * Agent's prompt configuration (optional)
+         */
+        prompt?: AgentIdentificationByRoarkID.Prompt;
+    }
+    namespace AgentIdentificationByRoarkID {
+        interface AgentEndpointByID {
+            /**
+             * Existing Roark endpoint ID
+             */
+            id: string;
+        }
+        /**
+         * Lookup or create endpoint if one with these values does not exist
+         */
+        interface AgentEndpointByValue {
+            /**
+             * Type of endpoint (phone or websocket)
+             */
+            type: string;
+            /**
+             * Endpoint value (phone number in E.164 format or websocket URL)
+             */
+            value: string;
+            /**
+             * Call direction for this endpoint
+             */
+            direction?: string;
+        }
+        /**
+         * Agent's prompt configuration (optional)
+         */
+        interface Prompt {
+            /**
+             * The agent's system prompt used during this call
+             */
+            resolvedPrompt: string;
+        }
+    }
+    /**
+     * Create a new agent or find existing by customId if provided
+     */
+    interface AgentIdentificationByName {
+        /**
+         * Agent name
+         */
+        name: string;
+        /**
+         * Agent custom ID
+         */
+        customId?: string;
+        /**
+         * Agent description
+         */
+        description?: string;
+        /**
+         * Endpoint configuration for this agent (optional)
+         */
+        endpoint?: AgentIdentificationByName.AgentEndpointByID | AgentIdentificationByName.AgentEndpointByValue;
+        /**
+         * Agent's prompt configuration (optional)
+         */
+        prompt?: AgentIdentificationByName.Prompt;
+    }
+    namespace AgentIdentificationByName {
+        interface AgentEndpointByID {
+            /**
+             * Existing Roark endpoint ID
+             */
+            id: string;
+        }
+        /**
+         * Lookup or create endpoint if one with these values does not exist
+         */
+        interface AgentEndpointByValue {
+            /**
+             * Type of endpoint (phone or websocket)
+             */
+            type: string;
+            /**
+             * Endpoint value (phone number in E.164 format or websocket URL)
+             */
+            value: string;
+            /**
+             * Call direction for this endpoint
+             */
+            direction?: string;
+        }
+        /**
+         * Agent's prompt configuration (optional)
+         */
+        interface Prompt {
+            /**
+             * The agent's system prompt used during this call
+             */
+            resolvedPrompt: string;
+        }
+    }
+    interface AgentIdentificationByCustomID {
+        /**
+         * Existing custom ID for a Roark agent
+         */
+        customId: string;
+        /**
+         * Endpoint configuration for this agent (optional)
+         */
+        endpoint?: AgentIdentificationByCustomID.AgentEndpointByID | AgentIdentificationByCustomID.AgentEndpointByValue;
+        /**
+         * Agent's prompt configuration (optional)
+         */
+        prompt?: AgentIdentificationByCustomID.Prompt;
+    }
+    namespace AgentIdentificationByCustomID {
+        interface AgentEndpointByID {
+            /**
+             * Existing Roark endpoint ID
+             */
+            id: string;
+        }
+        /**
+         * Lookup or create endpoint if one with these values does not exist
+         */
+        interface AgentEndpointByValue {
+            /**
+             * Type of endpoint (phone or websocket)
+             */
+            type: string;
+            /**
+             * Endpoint value (phone number in E.164 format or websocket URL)
+             */
+            value: string;
+            /**
+             * Call direction for this endpoint
+             */
+            direction?: string;
+        }
+        /**
+         * Agent's prompt configuration (optional)
+         */
+        interface Prompt {
+            /**
+             * The agent's system prompt used during this call
+             */
+            resolvedPrompt: string;
+        }
+    }
+    interface AgentIdentificationByRoarkID {
+        /**
+         * Existing Roark agent ID
+         */
+        roarkId: string;
+        /**
+         * Endpoint configuration for this agent (optional)
+         */
+        endpoint?: AgentIdentificationByRoarkID.AgentEndpointByID | AgentIdentificationByRoarkID.AgentEndpointByValue;
+        /**
+         * Agent's prompt configuration (optional)
+         */
+        prompt?: AgentIdentificationByRoarkID.Prompt;
+    }
+    namespace AgentIdentificationByRoarkID {
+        interface AgentEndpointByID {
+            /**
+             * Existing Roark endpoint ID
+             */
+            id: string;
+        }
+        /**
+         * Lookup or create endpoint if one with these values does not exist
+         */
+        interface AgentEndpointByValue {
+            /**
+             * Type of endpoint (phone or websocket)
+             */
+            type: string;
+            /**
+             * Endpoint value (phone number in E.164 format or websocket URL)
+             */
+            value: string;
+            /**
+             * Call direction for this endpoint
+             */
+            direction?: string;
+        }
+        /**
+         * Agent's prompt configuration (optional)
+         */
+        interface Prompt {
+            /**
+             * The agent's system prompt used during this call
+             */
+            resolvedPrompt: string;
+        }
+    }
+    /**
+     * Create a new agent or find existing by customId if provided
+     */
+    interface AgentIdentificationByName {
+        /**
+         * Agent name
+         */
+        name: string;
+        /**
+         * Agent custom ID
+         */
+        customId?: string;
+        /**
+         * Agent description
+         */
+        description?: string;
+        /**
+         * Endpoint configuration for this agent (optional)
+         */
+        endpoint?: AgentIdentificationByName.AgentEndpointByID | AgentIdentificationByName.AgentEndpointByValue;
+        /**
+         * Agent's prompt configuration (optional)
+         */
+        prompt?: AgentIdentificationByName.Prompt;
+    }
+    namespace AgentIdentificationByName {
+        interface AgentEndpointByID {
+            /**
+             * Existing Roark endpoint ID
+             */
+            id: string;
+        }
+        /**
+         * Lookup or create endpoint if one with these values does not exist
+         */
+        interface AgentEndpointByValue {
+            /**
+             * Type of endpoint (phone or websocket)
+             */
+            type: string;
+            /**
+             * Endpoint value (phone number in E.164 format or websocket URL)
+             */
+            value: string;
+            /**
+             * Call direction for this endpoint
+             */
+            direction?: string;
+        }
+        /**
+         * Agent's prompt configuration (optional)
+         */
+        interface Prompt {
+            /**
+             * The agent's system prompt used during this call
+             */
+            resolvedPrompt: string;
+        }
+    }
+    interface AgentIdentificationByCustomID {
+        /**
+         * Existing custom ID for a Roark agent
+         */
+        customId: string;
+        /**
+         * Endpoint configuration for this agent (optional)
+         */
+        endpoint?: AgentIdentificationByCustomID.AgentEndpointByID | AgentIdentificationByCustomID.AgentEndpointByValue;
+        /**
+         * Agent's prompt configuration (optional)
+         */
+        prompt?: AgentIdentificationByCustomID.Prompt;
+    }
+    namespace AgentIdentificationByCustomID {
+        interface AgentEndpointByID {
+            /**
+             * Existing Roark endpoint ID
+             */
+            id: string;
+        }
+        /**
+         * Lookup or create endpoint if one with these values does not exist
+         */
+        interface AgentEndpointByValue {
+            /**
+             * Type of endpoint (phone or websocket)
+             */
+            type: string;
+            /**
+             * Endpoint value (phone number in E.164 format or websocket URL)
+             */
+            value: string;
+            /**
+             * Call direction for this endpoint
+             */
+            direction?: string;
+        }
+        /**
+         * Agent's prompt configuration (optional)
+         */
+        interface Prompt {
+            /**
+             * The agent's system prompt used during this call
+             */
+            resolvedPrompt: string;
+        }
+    }
+    /**
+     * Single customer participating in the call. Use this for simpler API when you
+     * have only one customer.
+     */
+    interface Customer {
+        /**
+         * Customer phone number in E.164 format (e.g., +14155551234)
+         */
+        phoneNumberE164: string | null;
+        /**
+         * Label to identify this customer in the transcript (e.g., "speaker-01",
+         * "speaker-02")
+         */
+        label?: string | null;
+    }
+    /**
+     * Customer participating in the call
+     */
+    interface Customer {
+        /**
+         * Customer phone number in E.164 format (e.g., +14155551234)
+         */
+        phoneNumberE164: string | null;
+        /**
+         * Label to identify this customer in the transcript (e.g., "speaker-01",
+         * "speaker-02")
+         */
+        label?: string | null;
+    }
+    interface ToolInvocation {
+        /**
+         * Name of the tool that was invoked
+         */
+        name: string;
+        /**
+         * Parameters provided to the tool during invocation
+         */
+        parameters: {
+            [key: string]: ToolInvocation.UnionMember0 | unknown;
+        };
+        /**
+         * Result returned by the tool after execution. Can be a string or a JSON object
+         */
+        result: string | {
+            [key: string]: unknown;
+        };
+        /**
+         * Offset in milliseconds from the start of the call when the tool was invoked
+         */
+        startOffsetMs: number;
+        /**
+         * Metadata about the agent that invoked this tool - used to match which agent from
+         * the agents array this tool invocation belongs to
+         */
+        agent?: ToolInvocation.Agent;
+        /**
+         * Description of when the tool should be invoked
+         */
+        description?: string;
+        /**
+         * Offset in milliseconds from the start of the call when the tool execution
+         * completed. Used to calculate duration of the tool execution
+         */
+        endOffsetMs?: number;
+    }
+    namespace ToolInvocation {
+        interface UnionMember0 {
+            description?: string;
+            type?: 'string' | 'number' | 'boolean';
+            value?: unknown;
+        }
+        /**
+         * Metadata about the agent that invoked this tool - used to match which agent from
+         * the agents array this tool invocation belongs to
+         */
+        interface Agent {
+            /**
+             * The custom ID set on the agent
+             */
+            customId?: string;
+            /**
+             * The Roark ID of the agent
+             */
+            roarkId?: string;
+        }
+    }
+    interface TranscriptEntryAgent {
+        endOffsetMs: number;
+        role: 'AGENT';
+        startOffsetMs: number;
+        text: string;
+        /**
+         * Metadata about the agent that spoke this turn - used to match which agent from
+         * the `agents` array this transcript entry belongs to
+         */
+        agent?: TranscriptEntryAgent.Agent;
+        languageCode?: string;
+    }
+    namespace TranscriptEntryAgent {
+        /**
+         * Metadata about the agent that spoke this turn - used to match which agent from
+         * the `agents` array this transcript entry belongs to
+         */
+        interface Agent {
+            /**
+             * The custom ID set on the agent
+             */
+            customId?: string;
+            /**
+             * The Roark ID of the agent
+             */
+            roarkId?: string;
+        }
+    }
+    interface TranscriptEntryCustomer {
+        endOffsetMs: number;
+        role: 'CUSTOMER';
+        startOffsetMs: number;
+        text: string;
+        /**
+         * Metadata about the customer that spoke this turn - used to match which customer
+         * from the `customers` array this transcript entry belongs to
+         */
+        customer?: TranscriptEntryCustomer.Customer;
+        languageCode?: string;
+    }
+    namespace TranscriptEntryCustomer {
+        /**
+         * Metadata about the customer that spoke this turn - used to match which customer
+         * from the `customers` array this transcript entry belongs to
+         */
+        interface Customer {
+            /**
+             * Label matching the `label` field on the `customers` array when creating the call
+             */
+            label?: string;
+            /**
+             * The phone number of the customer in E.164 format, matching the `phoneNumberE164`
+             * field on the `customers` array when creating the call
+             */
+            phoneNumberE164?: string;
+        }
+    }
+}
+export interface CallListParams {
+    /**
+     * Cursor for pagination - use the nextCursor value from a previous response
+     */
+    after?: string;
+    /**
+     * Maximum number of calls to return (default: 20, max: 100)
+     */
+    limit?: number;
+    /**
+     * Search text to filter calls by title, summary, or transcript
+     */
+    searchText?: string;
+    /**
+     * Field to sort by (default: createdAt)
+     */
+    sortBy?: 'createdAt' | 'startedAt' | 'endedAt' | 'duration' | 'title' | 'status';
+    /**
+     * Sort direction (default: desc)
+     */
+    sortDirection?: 'asc' | 'desc';
+    /**
+     * Filter by call status
+     */
+    status?: 'RINGING' | 'IN_PROGRESS' | 'ENDED';
+}
+export interface CallListMetricsParams {
     /**
      * Whether to return a flat list instead of grouped by metric definition (default:
      * false)
@@ -473,6 +1198,6 @@ export interface CallGetMetricsParams {
     flatten?: string;
 }
 export declare namespace Call {
-    export { type CallGetByIDResponse as CallGetByIDResponse, type CallGetEvaluationRunsResponse as CallGetEvaluationRunsResponse, type CallGetMetricsResponse as CallGetMetricsResponse, type CallGetSentimentRunsResponse as CallGetSentimentRunsResponse, type CallGetMetricsParams as CallGetMetricsParams, };
+    export { type CallCreateResponse as CallCreateResponse, type CallListResponse as CallListResponse, type CallGetByIDResponse as CallGetByIDResponse, type CallListEvaluationRunsResponse as CallListEvaluationRunsResponse, type CallListMetricsResponse as CallListMetricsResponse, type CallListSentimentRunsResponse as CallListSentimentRunsResponse, type CallCreateParams as CallCreateParams, type CallListParams as CallListParams, type CallListMetricsParams as CallListMetricsParams, };
 }
 //# sourceMappingURL=call.d.ts.map