retell-sdk 5.22.0 → 5.23.0

package/src/resources/chat-agent.ts

@@ -107,6 +107,24 @@ export class ChatAgent extends APIResource {
   getVersions(agentID: string, options?: RequestOptions): APIPromise<ChatAgentGetVersionsResponse> {
     return this._client.get(path`/get-chat-agent-versions/${agentID}`, options);
   }
+
+  /**
+   * Publish an existing draft version in place.
+   *
+   * @example
+   * ```ts
+   * await client.chatAgent.publish('agent_xxx', {
+   *   version: 15,
+   * });
+   * ```
+   */
+  publish(agentID: string, body: ChatAgentPublishParams, options?: RequestOptions): APIPromise<void> {
+    return this._client.post(path`/publish-agent-version/${agentID}`, {
+      body,
+      ...options,
+      headers: buildHeaders([{ Accept: '*/*' }, options?.headers]),
+    });
+  }
 }
 
 export interface ChatAgentResponse {
@@ -1978,6 +1996,12 @@ export interface ChatAgentListParams {
   pagination_key_version?: number;
 }
 
+export interface ChatAgentPublishParams {
+  version: number;
+
+  version_description?: string;
+}
+
 export declare namespace ChatAgent {
   export {
     type ChatAgentResponse as ChatAgentResponse,
@@ -1987,5 +2011,6 @@ export declare namespace ChatAgent {
     type ChatAgentRetrieveParams as ChatAgentRetrieveParams,
     type ChatAgentUpdateParams as ChatAgentUpdateParams,
     type ChatAgentListParams as ChatAgentListParams,
+    type ChatAgentPublishParams as ChatAgentPublishParams,
   };
 }

package/src/resources/chat.ts

@@ -1,6 +1,7 @@
 // File generated from our OpenAPI spec by Stainless. See CONTRIBUTING.md for details.
 
 import { APIResource } from '../core/resource';
+import * as ChatAPI from './chat';
 import { APIPromise } from '../core/api-promise';
 import { buildHeaders } from '../internal/headers';
 import { RequestOptions } from '../internal/request-options';
@@ -60,16 +61,16 @@ export class Chat extends APIResource {
   }
 
   /**
-   * List all chats
+   * List chats with unified cursor pagination response.
    *
-   * @deprecated
+   * @example
+   * ```ts
+   * const chats = await client.chat.list();
+   * ```
    */
-  list(
-    query: ChatListParams | null | undefined = {},
-    options?: RequestOptions,
-  ): APIPromise<ChatListResponse> {
-    return this._client.get('/list-chat', {
-      query,
+  list(body: ChatListParams | null | undefined = {}, options?: RequestOptions): APIPromise<ChatListResponse> {
+    return this._client.post('/v3/list-chats', {
+      body,
       timeout: (this._client as any)._options.timeout ?? 300000,
       ...options,
     });
@@ -470,7 +471,26 @@ export namespace ChatResponse {
   }
 }
 
-export type ChatListResponse = Array<ChatResponse>;
+export interface ChatListResponse {
+  /**
+   * Whether more results are available.
+   */
+  has_more?: boolean;
+
+  items?: Array<ChatListResponse.Item>;
+
+  /**
+   * Pagination key for the next page.
+   */
+  pagination_key?: string;
+}
+
+export namespace ChatListResponse {
+  /**
+   * V3 list chats response. Transcript fields are intentionally omitted.
+   */
+  export interface Item extends ChatAPI.ChatResponse {}
+}
 
 export interface ChatCreateChatCompletionResponse {
   /**
@@ -712,22 +732,27 @@ export interface ChatUpdateParams {
 
 export interface ChatListParams {
   /**
-   * Limit the number of chats returned. Default 50, Max 1000. To retrieve more than
-   * 1000, use pagination_key to continue fetching the next page.
+   * Filter criteria for chats to retrieve.
+   */
+  filter_criteria?: { [key: string]: unknown };
+
+  /**
+   * Maximum number of chats to return.
    */
   limit?: number;
 
   /**
-   * The pagination key to continue fetching the next page of chats. Pagination key
-   * is represented by a chat id here, and it's exclusive (not included in the
-   * fetched chats). The last chat id from the list chats is usually used as
-   * pagination key here. If not set, will start from the beginning.
+   * Opaque pagination cursor from a previous response.
    */
   pagination_key?: string;
 
   /**
-   * The chats will be sorted by `start_timestamp`, whether to return the chats in
-   * ascending or descending order.
+   * Number of records to skip for pagination.
+   */
+  skip?: number;
+
+  /**
+   * Sort chats by `start_timestamp` in ascending or descending order.
    */
   sort_order?: 'ascending' | 'descending';
 }

package/src/resources/conversation-flow-component.ts

@@ -76,12 +76,19 @@ export class ConversationFlowComponent extends APIResource {
   }
 
   /**
-   * List shared conversation flow components
+   * List shared conversation flow components with pagination
    *
-   * @deprecated
+   * @example
+   * ```ts
+   * const conversationFlowComponents =
+   *   await client.conversationFlowComponent.list();
+   * ```
    */
-  list(options?: RequestOptions): APIPromise<ConversationFlowComponentListResponse> {
-    return this._client.get('/list-conversation-flow-components', options);
+  list(
+    query: ConversationFlowComponentListParams | null | undefined = {},
+    options?: RequestOptions,
+  ): APIPromise<ConversationFlowComponentListResponse> {
+    return this._client.get('/v2/list-conversation-flow-components', { query, ...options });
   }
 
   /**
@@ -8339,7 +8346,19 @@ export namespace ConversationFlowComponentResponse {
   }
 }
 
-export type ConversationFlowComponentListResponse = Array<ConversationFlowComponentResponse>;
+export interface ConversationFlowComponentListResponse {
+  /**
+   * Whether more results are available.
+   */
+  has_more?: boolean;
+
+  items?: Array<ConversationFlowComponentResponse>;
+
+  /**
+   * Pagination key for the next page.
+   */
+  pagination_key?: string;
+}
 
 export interface ConversationFlowComponentCreateParams {
   /**
@@ -24783,11 +24802,29 @@ export namespace ConversationFlowComponentUpdateParams {
   }
 }
 
+export interface ConversationFlowComponentListParams {
+  /**
+   * Maximum number of items to return.
+   */
+  limit?: number;
+
+  /**
+   * Pagination key for fetching the next page.
+   */
+  pagination_key?: string;
+
+  /**
+   * Sort order for results.
+   */
+  sort_order?: 'ascending' | 'descending';
+}
+
 export declare namespace ConversationFlowComponent {
   export {
     type ConversationFlowComponentResponse as ConversationFlowComponentResponse,
     type ConversationFlowComponentListResponse as ConversationFlowComponentListResponse,
     type ConversationFlowComponentCreateParams as ConversationFlowComponentCreateParams,
     type ConversationFlowComponentUpdateParams as ConversationFlowComponentUpdateParams,
+    type ConversationFlowComponentListParams as ConversationFlowComponentListParams,
   };
 }

package/src/resources/conversation-flow.ts

@@ -78,15 +78,19 @@ export class ConversationFlow extends APIResource {
   }
 
   /**
-   * List all conversation flows that can be attached to an agent.
+   * List conversation flows with pagination
    *
-   * @deprecated
+   * @example
+   * ```ts
+   * const conversationFlows =
+   *   await client.conversationFlow.list();
+   * ```
    */
   list(
     query: ConversationFlowListParams | null | undefined = {},
     options?: RequestOptions,
   ): APIPromise<ConversationFlowListResponse> {
-    return this._client.get('/list-conversation-flows', { query, ...options });
+    return this._client.get('/v2/list-conversation-flows', { query, ...options });
   }
 
   /**
@@ -16666,7 +16670,19 @@ export namespace ConversationFlowResponse {
   }
 }
 
-export type ConversationFlowListResponse = Array<ConversationFlowResponse>;
+export interface ConversationFlowListResponse {
+  /**
+   * Whether more results are available.
+   */
+  has_more?: boolean;
+
+  items?: Array<ConversationFlowResponse>;
+
+  /**
+   * Pagination key for the next page.
+   */
+  pagination_key?: string;
+}
 
 export interface ConversationFlowCreateParams {
   /**
@@ -49783,26 +49799,19 @@ export namespace ConversationFlowUpdateParams {
 
 export interface ConversationFlowListParams {
   /**
-   * Limit the number of conversation flows returned. Default 1000, Max 1000. To
-   * retrieve more than 1000, use pagination_key to continue fetching the next page.
+   * Maximum number of items to return.
    */
   limit?: number;
 
   /**
-   * The pagination key to continue fetching the next page of conversation flows.
-   * Pagination key is represented by a conversation flow id here, and it's exclusive
-   * (not included in the fetched conversation flows). The last conversation flow id
-   * from the list conversation flows is usually used as pagination key here. If not
-   * set, will start from the beginning.
+   * Pagination key for fetching the next page.
    */
   pagination_key?: string;
 
   /**
-   * Specifies the version of the conversation flow associated with the
-   * pagination_key. When paginating, both the pagination_key and its version must be
-   * provided to ensure consistent ordering and to fetch the next page correctly.
+   * Sort order for results.
    */
-  pagination_key_version?: number;
+  sort_order?: 'ascending' | 'descending';
 }
 
 export declare namespace ConversationFlow {

package/src/resources/index.ts

@@ -9,6 +9,7 @@ export {
   type AgentRetrieveParams,
   type AgentUpdateParams,
   type AgentListParams,
+  type AgentPublishParams,
 } from './agent';
 export { BatchCall, type BatchCallResponse, type BatchCallCreateBatchCallParams } from './batch-call';
 export {
@@ -43,6 +44,7 @@ export {
   type ChatAgentRetrieveParams,
   type ChatAgentUpdateParams,
   type ChatAgentListParams,
+  type ChatAgentPublishParams,
 } from './chat-agent';
 export { Concurrency, type ConcurrencyRetrieveResponse } from './concurrency';
 export {
@@ -60,6 +62,7 @@ export {
   type ConversationFlowComponentListResponse,
   type ConversationFlowComponentCreateParams,
   type ConversationFlowComponentUpdateParams,
+  type ConversationFlowComponentListParams,
 } from './conversation-flow-component';
 export {
   ExportRequest,
@@ -95,6 +98,7 @@ export {
   type PhoneNumberListResponse,
   type PhoneNumberCreateParams,
   type PhoneNumberUpdateParams,
+  type PhoneNumberListParams,
   type PhoneNumberImportParams,
 } from './phone-number';
 export { Playground, type PlaygroundCompletionResponse, type PlaygroundCompletionParams } from './playground';
@@ -110,6 +114,7 @@ export {
   type TestCreateTestCaseDefinitionParams,
   type TestListBatchTestsParams,
   type TestListTestCaseDefinitionsParams,
+  type TestListTestRunsParams,
   type TestUpdateTestCaseDefinitionParams,
 } from './tests';
 export {

package/src/resources/llm.ts

@@ -62,12 +62,15 @@ export class Llm extends APIResource {
   }
 
   /**
-   * List all Retell LLM Response Engines that can be attached to an agent.
+   * List Retell LLM Response Engines with pagination
    *
-   * @deprecated
+   * @example
+   * ```ts
+   * const llms = await client.llm.list();
+   * ```
    */
   list(query: LlmListParams | null | undefined = {}, options?: RequestOptions): APIPromise<LlmListResponse> {
-    return this._client.get('/list-retell-llms', { query, ...options });
+    return this._client.get('/v2/list-retell-llms', { query, ...options });
   }
 
   /**
@@ -2641,7 +2644,19 @@ export namespace LlmResponse {
   }
 }
 
-export type LlmListResponse = Array<LlmResponse>;
+export interface LlmListResponse {
+  /**
+   * Whether more results are available.
+   */
+  has_more?: boolean;
+
+  items?: Array<LlmResponse>;
+
+  /**
+   * Pagination key for the next page.
+   */
+  pagination_key?: string;
+}
 
 export interface LlmCreateParams {
   /**
@@ -7739,24 +7754,19 @@ export namespace LlmUpdateParams {
 
 export interface LlmListParams {
   /**
-   * A limit on the number of objects to be returned. Limit can range between 1 and
-   * 1000, and the default is 1000.
+   * Maximum number of items to return.
    */
   limit?: number;
 
   /**
-   * The pagination key to continue fetching the next page of LLMs. Pagination key is
-   * represented by a llm id, pagination key and version pair is exclusive (not
-   * included in the fetched page). If not set, will start from the beginning.
+   * Pagination key for fetching the next page.
    */
   pagination_key?: string;
 
   /**
-   * Specifies the version of the llm associated with the pagination_key. When
-   * paginating, both the pagination_key and its version must be provided to ensure
-   * consistent ordering and to fetch the next page correctly.
+   * Sort order for results.
    */
-  pagination_key_version?: number;
+  sort_order?: 'ascending' | 'descending';
 }
 
 export declare namespace Llm {

package/src/resources/phone-number.ts

@@ -69,12 +69,18 @@ export class PhoneNumber extends APIResource {
   }
 
   /**
-   * List all phone numbers
+   * List phone numbers with pagination
    *
-   * @deprecated
+   * @example
+   * ```ts
+   * const phoneNumbers = await client.phoneNumber.list();
+   * ```
    */
-  list(options?: RequestOptions): APIPromise<PhoneNumberListResponse> {
-    return this._client.get('/list-phone-numbers', options);
+  list(
+    query: PhoneNumberListParams | null | undefined = {},
+    options?: RequestOptions,
+  ): APIPromise<PhoneNumberListResponse> {
+    return this._client.get('/v2/list-phone-numbers', { query, ...options });
   }
 
   /**
@@ -309,7 +315,19 @@ export namespace PhoneNumberResponse {
   }
 }
 
-export type PhoneNumberListResponse = Array<PhoneNumberResponse>;
+export interface PhoneNumberListResponse {
+  /**
+   * Whether more results are available.
+   */
+  has_more?: boolean;
+
+  items?: Array<PhoneNumberResponse>;
+
+  /**
+   * Pagination key for the next page.
+   */
+  pagination_key?: string;
+}
 
 export interface PhoneNumberCreateParams {
   /**
@@ -610,6 +628,23 @@ export namespace PhoneNumberUpdateParams {
   }
 }
 
+export interface PhoneNumberListParams {
+  /**
+   * Maximum number of items to return.
+   */
+  limit?: number;
+
+  /**
+   * Pagination key for fetching the next page.
+   */
+  pagination_key?: string;
+
+  /**
+   * Sort order for results.
+   */
+  sort_order?: 'ascending' | 'descending';
+}
+
 export interface PhoneNumberImportParams {
   /**
    * The number you are trying to import in E.164 format of the number (+country
@@ -735,6 +770,7 @@ export declare namespace PhoneNumber {
     type PhoneNumberListResponse as PhoneNumberListResponse,
     type PhoneNumberCreateParams as PhoneNumberCreateParams,
     type PhoneNumberUpdateParams as PhoneNumberUpdateParams,
+    type PhoneNumberListParams as PhoneNumberListParams,
     type PhoneNumberImportParams as PhoneNumberImportParams,
   };
 }

package/src/resources/tests.ts

@@ -59,36 +59,34 @@ export class Tests extends APIResource {
   }
 
   /**
-   * List batch test jobs for a response engine
-   *
-   * @deprecated
+   * List batch test jobs with pagination
    */
   listBatchTests(
     query: TestListBatchTestsParams,
     options?: RequestOptions,
   ): APIPromise<TestListBatchTestsResponse> {
-    return this._client.get('/list-batch-tests', { query, ...options });
+    return this._client.get('/v2/list-batch-tests', { query, ...options });
   }
 
   /**
-   * List test case definitions for a response engine
-   *
-   * @deprecated
+   * List test case definitions with pagination
    */
   listTestCaseDefinitions(
     query: TestListTestCaseDefinitionsParams,
     options?: RequestOptions,
   ): APIPromise<TestListTestCaseDefinitionsResponse> {
-    return this._client.get('/list-test-case-definitions', { query, ...options });
+    return this._client.get('/v2/list-test-case-definitions', { query, ...options });
   }
 
   /**
-   * List all test case jobs (test runs) for a batch test job
-   *
-   * @deprecated
+   * List test case jobs (test runs) for a batch test job with pagination
    */
-  listTestRuns(testCaseBatchJobID: string, options?: RequestOptions): APIPromise<TestListTestRunsResponse> {
-    return this._client.get(path`/list-test-runs/${testCaseBatchJobID}`, options);
+  listTestRuns(
+    testCaseBatchJobID: string,
+    query: TestListTestRunsParams | null | undefined = {},
+    options?: RequestOptions,
+  ): APIPromise<TestListTestRunsResponse> {
+    return this._client.get(path`/v2/list-test-runs/${testCaseBatchJobID}`, { query, ...options });
   }
 
   /**
@@ -400,11 +398,47 @@ export interface TestCaseJobResponse {
   transcript_snapshot?: unknown | null;
 }
 
-export type TestListBatchTestsResponse = Array<BatchTestResponse>;
+export interface TestListBatchTestsResponse {
+  /**
+   * Whether more results are available.
+   */
+  has_more?: boolean;
 
-export type TestListTestCaseDefinitionsResponse = Array<TestCaseDefinitionResponse>;
+  items?: Array<BatchTestResponse>;
 
-export type TestListTestRunsResponse = Array<TestCaseJobResponse>;
+  /**
+   * Pagination key for the next page.
+   */
+  pagination_key?: string;
+}
+
+export interface TestListTestCaseDefinitionsResponse {
+  /**
+   * Whether more results are available.
+   */
+  has_more?: boolean;
+
+  items?: Array<TestCaseDefinitionResponse>;
+
+  /**
+   * Pagination key for the next page.
+   */
+  pagination_key?: string;
+}
+
+export interface TestListTestRunsResponse {
+  /**
+   * Whether more results are available.
+   */
+  has_more?: boolean;
+
+  items?: Array<TestCaseJobResponse>;
+
+  /**
+   * Pagination key for the next page.
+   */
+  pagination_key?: string;
+}
 
 export interface TestCreateBatchTestParams {
   /**
@@ -605,11 +639,21 @@ export interface TestListBatchTestsParams {
    */
   conversation_flow_id?: string;
 
+  /**
+   * Maximum number of items to return.
+   */
+  limit?: number;
+
   /**
    * LLM ID (required when type is retell-llm)
    */
   llm_id?: string;
 
+  /**
+   * Pagination key for fetching the next page.
+   */
+  pagination_key?: string;
+
   /**
    * Version of the response engine (defaults to latest)
    */
@@ -627,10 +671,32 @@ export interface TestListTestCaseDefinitionsParams {
    */
   conversation_flow_id?: string;
 
+  /**
+   * Maximum number of items to return.
+   */
+  limit?: number;
+
   /**
    * LLM ID (required when type is retell-llm)
    */
   llm_id?: string;
+
+  /**
+   * Pagination key for fetching the next page.
+   */
+  pagination_key?: string;
+}
+
+export interface TestListTestRunsParams {
+  /**
+   * Maximum number of items to return.
+   */
+  limit?: number;
+
+  /**
+   * Pagination key for fetching the next page.
+   */
+  pagination_key?: string;
 }
 
 export interface TestUpdateTestCaseDefinitionParams {
@@ -783,6 +849,7 @@ export declare namespace Tests {
     type TestCreateTestCaseDefinitionParams as TestCreateTestCaseDefinitionParams,
     type TestListBatchTestsParams as TestListBatchTestsParams,
     type TestListTestCaseDefinitionsParams as TestListTestCaseDefinitionsParams,
+    type TestListTestRunsParams as TestListTestRunsParams,
     type TestUpdateTestCaseDefinitionParams as TestUpdateTestCaseDefinitionParams,
   };
 }

package/src/version.ts

@@ -1 +1 @@
-export const VERSION = '5.22.0'; // x-release-please-version
+export const VERSION = '5.23.0'; // x-release-please-version

package/version.d.mts

@@ -1,2 +1,2 @@
-export declare const VERSION = "5.22.0";
+export declare const VERSION = "5.23.0";
 //# sourceMappingURL=version.d.mts.map

package/version.d.ts

@@ -1,2 +1,2 @@
-export declare const VERSION = "5.22.0";
+export declare const VERSION = "5.23.0";
 //# sourceMappingURL=version.d.ts.map

package/version.js

@@ -1,5 +1,5 @@
 "use strict";
 Object.defineProperty(exports, "__esModule", { value: true });
 exports.VERSION = void 0;
-exports.VERSION = '5.22.0'; // x-release-please-version
+exports.VERSION = '5.23.0'; // x-release-please-version
 //# sourceMappingURL=version.js.map

package/version.mjs

@@ -1,2 +1,2 @@
-export const VERSION = '5.22.0'; // x-release-please-version
+export const VERSION = '5.23.0'; // x-release-please-version
 //# sourceMappingURL=version.mjs.map