@roarkanalytics/sdk 2.13.1 → 2.15.0

package/src/resources/call.ts

@@ -5,6 +5,28 @@ import { isRequestOptions } from '../core';
 import * as Core from '../core';
 
 export class Call extends APIResource {
+  /**
+   * Create a new call with recording, transcript, agents, and customers
+   */
+  create(body: CallCreateParams, options?: Core.RequestOptions): Core.APIPromise<CallCreateResponse> {
+    return this._client.post('/v1/call', { body, ...options });
+  }
+
+  /**
+   * 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>;
+  list(
+    query: CallListParams | Core.RequestOptions = {},
+    options?: Core.RequestOptions,
+  ): Core.APIPromise<CallListResponse> {
+    if (isRequestOptions(query)) {
+      return this.list({}, query);
+    }
+    return this._client.get('/v1/call', { query, ...options });
+  }
+
   /**
    * Retrieve an existing call by its unique identifier
    */
@@ -15,10 +37,10 @@ export class Call extends APIResource {
   /**
    * Fetch all evaluation run results for a specific call.
    */
-  getEvaluationRuns(
+  listEvaluationRuns(
     callId: string,
     options?: Core.RequestOptions,
-  ): Core.APIPromise<CallGetEvaluationRunsResponse> {
+  ): Core.APIPromise<CallListEvaluationRunsResponse> {
     return this._client.get(`/v1/call/${callId}/evaluation-run`, options);
   }
 
@@ -26,19 +48,19 @@ export class Call extends APIResource {
    * Fetch all call-level metrics for a specific call, including both
    * system-generated and custom metrics. Only returns successfully computed metrics.
    */
-  getMetrics(
+  listMetrics(
     callId: string,
-    query?: CallGetMetricsParams,
+    query?: CallListMetricsParams,
     options?: Core.RequestOptions,
-  ): Core.APIPromise<CallGetMetricsResponse>;
-  getMetrics(callId: string, options?: Core.RequestOptions): Core.APIPromise<CallGetMetricsResponse>;
-  getMetrics(
+  ): Core.APIPromise<CallListMetricsResponse>;
+  listMetrics(callId: string, options?: Core.RequestOptions): Core.APIPromise<CallListMetricsResponse>;
+  listMetrics(
     callId: string,
-    query: CallGetMetricsParams | Core.RequestOptions = {},
+    query: CallListMetricsParams | Core.RequestOptions = {},
     options?: Core.RequestOptions,
-  ): Core.APIPromise<CallGetMetricsResponse> {
+  ): Core.APIPromise<CallListMetricsResponse> {
     if (isRequestOptions(query)) {
-      return this.getMetrics(callId, {}, query);
+      return this.listMetrics(callId, {}, query);
     }
     return this._client.get(`/v1/call/${callId}/metrics`, { query, ...options });
   }
@@ -47,14 +69,244 @@ export class Call extends APIResource {
    * Fetch detailed sentiment analysis results for a specific call, including
    * emotional tone, key phrases, and sentiment scores.
    */
-  getSentimentRuns(
+  listSentimentRuns(
     callId: string,
     options?: Core.RequestOptions,
-  ): Core.APIPromise<CallGetSentimentRunsResponse> {
+  ): Core.APIPromise<CallListSentimentRunsResponse> {
     return this._client.get(`/v1/call/${callId}/sentiment-run`, options);
   }
 }
 
+export interface CallCreateResponse {
+  /**
+   * Response after creating a call
+   */
+  data: CallCreateResponse.Data;
+}
+
+export namespace CallCreateResponse {
+  /**
+   * Response after creating a call
+   */
+  export 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;
+  }
+
+  export namespace Data {
+    export interface Agent {
+      id: string;
+
+      endpoint?: Agent.Endpoint | null;
+    }
+
+    export namespace Agent {
+      export interface Endpoint {
+        id: string;
+
+        environment: string;
+
+        phoneNumberE164?: string | null;
+      }
+    }
+
+    export interface Customer {
+      label?: string | null;
+
+      phoneNumberE164?: string | null;
+    }
+  }
+}
+
+export interface CallListResponse {
+  data: Array<CallListResponse.Data>;
+
+  pagination: CallListResponse.Pagination;
+}
+
+export namespace CallListResponse {
+  /**
+   * Response containing call information
+   */
+  export 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;
+  }
+
+  export namespace Data {
+    export interface Agent {
+      id: string;
+
+      endpoint?: Agent.Endpoint | null;
+    }
+
+    export namespace Agent {
+      export interface Endpoint {
+        id: string;
+
+        environment: string;
+
+        phoneNumberE164?: string | null;
+      }
+    }
+
+    export interface Customer {
+      label?: string | null;
+
+      phoneNumberE164?: string | null;
+    }
+  }
+
+  export 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 {
   /**
    * Response containing call information
@@ -137,6 +389,11 @@ export namespace CallGetByIDResponse {
       | 'UNKNOWN'
       | null;
 
+    /**
+     * Custom properties associated with the call
+     */
+    properties?: { [key: string]: unknown } | null;
+
     /**
      * Pre-signed URL to the call recording (expires in 1 hour)
      */
@@ -177,7 +434,7 @@ export namespace CallGetByIDResponse {
     export interface Agent {
       id: string;
 
-      endpoint: Agent.Endpoint;
+      endpoint?: Agent.Endpoint | null;
     }
 
     export namespace Agent {
@@ -191,19 +448,21 @@ export namespace CallGetByIDResponse {
     }
 
     export 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 namespace CallGetEvaluationRunsResponse {
+export namespace CallListEvaluationRunsResponse {
   export interface Data {
     /**
      * All block runs for this evaluator, including skipped ones
@@ -384,14 +643,14 @@ export 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 namespace CallGetMetricsResponse {
+export namespace CallListMetricsResponse {
   /**
    * Call metric data grouped by metric definition
    */
@@ -582,14 +841,14 @@ export namespace CallGetMetricsResponse {
   }
 }
 
-export interface CallGetSentimentRunsResponse {
+export interface CallListSentimentRunsResponse {
   /**
    * Sentiment run response payload
    */
-  data: CallGetSentimentRunsResponse.Data;
+  data: CallListSentimentRunsResponse.Data;
 }
 
-export namespace CallGetSentimentRunsResponse {
+export namespace CallListSentimentRunsResponse {
   /**
    * Sentiment run response payload
    */
@@ -616,7 +875,681 @@ export namespace CallGetSentimentRunsResponse {
   }
 }
 
-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 namespace CallCreateParams {
+  export 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;
+  }
+
+  export namespace AgentIdentificationByRoarkID {
+    export interface AgentEndpointByID {
+      /**
+       * Existing Roark endpoint ID
+       */
+      id: string;
+    }
+
+    /**
+     * Lookup or create endpoint if one with these values does not exist
+     */
+    export 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)
+     */
+    export interface Prompt {
+      /**
+       * The agent's system prompt used during this call
+       */
+      resolvedPrompt: string;
+    }
+  }
+
+  /**
+   * Create a new agent or find existing by customId if provided
+   */
+  export 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;
+  }
+
+  export namespace AgentIdentificationByName {
+    export interface AgentEndpointByID {
+      /**
+       * Existing Roark endpoint ID
+       */
+      id: string;
+    }
+
+    /**
+     * Lookup or create endpoint if one with these values does not exist
+     */
+    export 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)
+     */
+    export interface Prompt {
+      /**
+       * The agent's system prompt used during this call
+       */
+      resolvedPrompt: string;
+    }
+  }
+
+  export 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;
+  }
+
+  export namespace AgentIdentificationByCustomID {
+    export interface AgentEndpointByID {
+      /**
+       * Existing Roark endpoint ID
+       */
+      id: string;
+    }
+
+    /**
+     * Lookup or create endpoint if one with these values does not exist
+     */
+    export 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)
+     */
+    export interface Prompt {
+      /**
+       * The agent's system prompt used during this call
+       */
+      resolvedPrompt: string;
+    }
+  }
+
+  export 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;
+  }
+
+  export namespace AgentIdentificationByRoarkID {
+    export interface AgentEndpointByID {
+      /**
+       * Existing Roark endpoint ID
+       */
+      id: string;
+    }
+
+    /**
+     * Lookup or create endpoint if one with these values does not exist
+     */
+    export 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)
+     */
+    export interface Prompt {
+      /**
+       * The agent's system prompt used during this call
+       */
+      resolvedPrompt: string;
+    }
+  }
+
+  /**
+   * Create a new agent or find existing by customId if provided
+   */
+  export 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;
+  }
+
+  export namespace AgentIdentificationByName {
+    export interface AgentEndpointByID {
+      /**
+       * Existing Roark endpoint ID
+       */
+      id: string;
+    }
+
+    /**
+     * Lookup or create endpoint if one with these values does not exist
+     */
+    export 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)
+     */
+    export interface Prompt {
+      /**
+       * The agent's system prompt used during this call
+       */
+      resolvedPrompt: string;
+    }
+  }
+
+  export 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;
+  }
+
+  export namespace AgentIdentificationByCustomID {
+    export interface AgentEndpointByID {
+      /**
+       * Existing Roark endpoint ID
+       */
+      id: string;
+    }
+
+    /**
+     * Lookup or create endpoint if one with these values does not exist
+     */
+    export 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)
+     */
+    export 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.
+   */
+  export 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
+   */
+  export 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;
+  }
+
+  export 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;
+  }
+
+  export namespace ToolInvocation {
+    export 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
+     */
+    export interface Agent {
+      /**
+       * The custom ID set on the agent
+       */
+      customId?: string;
+
+      /**
+       * The Roark ID of the agent
+       */
+      roarkId?: string;
+    }
+  }
+
+  export 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;
+  }
+
+  export namespace TranscriptEntryAgent {
+    /**
+     * Metadata about the agent that spoke this turn - used to match which agent from
+     * the `agents` array this transcript entry belongs to
+     */
+    export interface Agent {
+      /**
+       * The custom ID set on the agent
+       */
+      customId?: string;
+
+      /**
+       * The Roark ID of the agent
+       */
+      roarkId?: string;
+    }
+  }
+
+  export 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;
+  }
+
+  export namespace TranscriptEntryCustomer {
+    /**
+     * Metadata about the customer that spoke this turn - used to match which customer
+     * from the `customers` array this transcript entry belongs to
+     */
+    export 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)
@@ -626,10 +1559,14 @@ export interface CallGetMetricsParams {
 
 export declare namespace Call {
   export {
+    type CallCreateResponse as CallCreateResponse,
+    type CallListResponse as CallListResponse,
     type CallGetByIDResponse as CallGetByIDResponse,
-    type CallGetEvaluationRunsResponse as CallGetEvaluationRunsResponse,
-    type CallGetMetricsResponse as CallGetMetricsResponse,
-    type CallGetSentimentRunsResponse as CallGetSentimentRunsResponse,
-    type CallGetMetricsParams as CallGetMetricsParams,
+    type CallListEvaluationRunsResponse as CallListEvaluationRunsResponse,
+    type CallListMetricsResponse as CallListMetricsResponse,
+    type CallListSentimentRunsResponse as CallListSentimentRunsResponse,
+    type CallCreateParams as CallCreateParams,
+    type CallListParams as CallListParams,
+    type CallListMetricsParams as CallListMetricsParams,
   };
 }