@corti/sdk 5.0.0-rc → 6.0.0-rc

package/README.md

@@ -18,8 +18,8 @@ The Corti JavaScript library provides convenient access to the Corti APIs from J
 - [Pagination](#pagination)
 - [Advanced](#advanced)
   - [Additional Headers](#additional-headers)
-  - [Analytics](#analytics)
   - [Additional Query String Parameters](#additional-query-string-parameters)
+  - [Analytics](#analytics)
   - [Retries](#retries)
   - [Timeouts](#timeouts)
   - [Aborting Requests](#aborting-requests)
@@ -689,6 +689,24 @@ const response = await client.interactions.create(..., {
 });
 ```
 
+Use `await client.getHeaders()` to retrieve a `Headers` object containing all configured client headers: authentication, tenant, custom headers, analytics, and SDK metadata. Tokens are refreshed if needed and header suppliers are resolved on each call. Request-specific overrides and endpoint-specific headers such as `Accept` and `Content-Type` are not included. The existing `getAuthHeaders()` helper still returns only authentication and tenant headers.
+
+```typescript
+const headers = await client.getHeaders();
+```
+
+### Additional Query String Parameters
+
+If you would like to send additional query string parameters as part of the request, use the `queryParams` request option.
+
+```typescript
+const response = await client.interactions.create(..., {
+    queryParams: {
+        'customQueryParamKey': 'custom query param value'
+    }
+});
+```
+
 ### Analytics
 
 The SDK sends metadata about itself (`sdk_version`, `sdk_type`) with every request via the `X-Corti-Analytics` header (REST) or the `x-corti-analytics` query parameter (WebSocket). You can extend this payload with your own fields on the client constructor, and overlay extra fields on individual REST calls or WebSocket connections.
@@ -740,18 +758,6 @@ const socket = await client.stream.connect({
 
 > **Note**: This value is in the query string and may appear in access logs — avoid personally identifiable information.
 
-### Additional Query String Parameters
-
-If you would like to send additional query string parameters as part of the request, use the `queryParams` request option.
-
-```typescript
-const response = await client.interactions.create(..., {
-    queryParams: {
-        'customQueryParamKey': 'custom query param value'
-    }
-});
-```
-
 ### Retries
 
 The SDK is instrumented with automatic retries with exponential backoff. A request will be retried as long

package/dist/cjs/BaseClient.js

@@ -43,8 +43,8 @@ function normalizeClientOptions(options) {
     const headers = (0, headers_js_1.mergeHeaders)({
         "X-Fern-Language": "JavaScript",
         "X-Fern-SDK-Name": "@corti/sdk",
-        "X-Fern-SDK-Version": "5.0.0-rc",
-        "User-Agent": "@corti/sdk/5.0.0-rc",
+        "X-Fern-SDK-Version": "6.0.0-rc",
+        "User-Agent": "@corti/sdk/6.0.0-rc",
         "X-Fern-Runtime": core.RUNTIME.type,
         "X-Fern-Runtime-Version": core.RUNTIME.version,
         "Tenant-Name": options === null || options === void 0 ? void 0 : options.tenantName,

package/dist/cjs/api/resources/agentic/resources/agents/client/Client.d.ts

@@ -69,7 +69,7 @@ export declare class AgentsClient {
      *                 auth: {
      *                     type: "oauth2",
      *                     scope: "read:policies",
-     *                     redirectUrl: "https://app.corti.ai/oauth/callback"
+     *                     tokenUrl: "https://app.corti.ai/oauth/token"
      *                 }
      *             }, {
      *                 type: "schema",

package/dist/cjs/api/resources/agentic/resources/agents/client/Client.js

@@ -199,7 +199,7 @@ class AgentsClient {
      *                 auth: {
      *                     type: "oauth2",
      *                     scope: "read:policies",
-     *                     redirectUrl: "https://app.corti.ai/oauth/callback"
+     *                     tokenUrl: "https://app.corti.ai/oauth/token"
      *                 }
      *             }, {
      *                 type: "schema",

package/dist/cjs/api/resources/agentic/resources/agents/client/requests/AgenticAgentsCreateRequest.d.ts

@@ -18,7 +18,7 @@ import type * as Corti from "../../../../../../index.js";
  *                 auth: {
  *                     type: "oauth2",
  *                     scope: "read:policies",
- *                     redirectUrl: "https://app.corti.ai/oauth/callback"
+ *                     tokenUrl: "https://app.corti.ai/oauth/token"
  *                 }
  *             }, {
  *                 type: "schema",
@@ -58,6 +58,8 @@ export interface AgenticAgentsCreateRequest {
     systemPrompt?: string;
     /** Tenant default if omitted. */
     model?: string;
+    /** Caps the orchestrator's ReAct loop iterations per run. Server default 10 if omitted. */
+    maxLoops?: number;
     visibility?: Corti.AgentsVisibility;
     lifecycle?: Corti.AgentsLifecycle;
     /** Connectors to attach at creation. Defaults to an empty array. */

package/dist/cjs/api/resources/agentic/resources/agents/client/requests/AgenticAgentsPatchRequest.d.ts

@@ -18,6 +18,8 @@ export interface AgenticAgentsPatchRequest {
     systemPrompt?: string | null;
     /** New model identifier; `null` falls back to the tenant default. */
     model?: string | null;
+    /** New cap on the orchestrator's ReAct loop iterations per run. Omitted leaves the current value unchanged; there is no `null`-reset — send 10 to restore the default. */
+    maxLoops?: number;
     visibility?: Corti.AgentsVisibility;
     lifecycle?: Corti.AgentsLifecycle;
     /** Replacement connector list; `null` clears connectors. */

package/dist/cjs/api/resources/codes/client/Client.d.ts

@@ -11,7 +11,7 @@ export declare class CodesClient {
     protected readonly _options: NormalizedClientOptionsWithAuth<CodesClient.Options>;
     constructor(options: CodesClient.Options);
     /**
-     * Predict medical codes from provided context.<br/><Note>This is a stateless endpoint, designed to predict ICD-10-CM, ICD-10-PCS, ICD-10 (international), ICD-10-UK, CIM-10-FR, ICD-10-GM, OPCS-4, OPS, CCAM, CPT and SNOMED CT codes based on input text string or documentId.<br/><br/>More than one code system may be defined in a single request.<br/><br/>Code prediction requests have two possible values for context:<br/>- `text`: One set of code prediction results will be returned based on all input text defined.<br/>- `documentId`: Code prediction will be based on that defined document only.<br/><br/>The response includes two sets of results:<br/>- `Codes`: Codes predicted by the model.<br/>- `Candidates`: Lower-confidence codes the model considered potentially relevant but excluded from the predicted set.<br/><br/>All predicted code results are based on input context defined in the request only (not other external data or assets associated with an interaction).</Note>
+     * Predict medical codes from provided context.<br/><Note>This is a stateless endpoint, designed to predict ICD-10-CM, ICD-10-PCS, ICD-10 (international), ICD-10-UK, CIM-10-FR, ICD-10-GM, OPCS-4, OPS, CCAM, CPT, SNOMED CT, MedDRA, SKS and KVÅ codes based on input text string or documentId.<br/><br/>More than one code system may be defined in a single request.<br/><br/>Code prediction requests have two possible values for context:<br/>- `text`: One set of code prediction results will be returned based on all input text defined.<br/>- `documentId`: Code prediction will be based on that defined document only.<br/><br/>The response includes two sets of results:<br/>- `Codes`: Codes predicted by the model.<br/>- `Candidates`: Lower-confidence codes the model considered potentially relevant but excluded from the predicted set.<br/><br/>All predicted code results are based on input context defined in the request only (not other external data or assets associated with an interaction).</Note>
      *
      * @param {Corti.CodesGeneralPredictRequest} request
      * @param {CodesClient.RequestOptions} requestOptions - Request-specific configuration.
@@ -39,8 +39,11 @@ export declare class CodesClient {
      *                 text: "Patient presents with uncontrolled type 2 diabetes."
      *             }],
      *         filter: {
-     *             include: ["E11"],
-     *             exclude: ["exclude"]
+     *             include: [{
+     *                     property: "code",
+     *                     op: "is-a",
+     *                     value: ["E11"]
+     *                 }]
      *         }
      *     })
      */

package/dist/cjs/api/resources/codes/client/Client.js

@@ -56,7 +56,7 @@ class CodesClient {
         this._options = (0, BaseClient_js_1.normalizeClientOptionsWithAuth)(options);
     }
     /**
-     * Predict medical codes from provided context.<br/><Note>This is a stateless endpoint, designed to predict ICD-10-CM, ICD-10-PCS, ICD-10 (international), ICD-10-UK, CIM-10-FR, ICD-10-GM, OPCS-4, OPS, CCAM, CPT and SNOMED CT codes based on input text string or documentId.<br/><br/>More than one code system may be defined in a single request.<br/><br/>Code prediction requests have two possible values for context:<br/>- `text`: One set of code prediction results will be returned based on all input text defined.<br/>- `documentId`: Code prediction will be based on that defined document only.<br/><br/>The response includes two sets of results:<br/>- `Codes`: Codes predicted by the model.<br/>- `Candidates`: Lower-confidence codes the model considered potentially relevant but excluded from the predicted set.<br/><br/>All predicted code results are based on input context defined in the request only (not other external data or assets associated with an interaction).</Note>
+     * Predict medical codes from provided context.<br/><Note>This is a stateless endpoint, designed to predict ICD-10-CM, ICD-10-PCS, ICD-10 (international), ICD-10-UK, CIM-10-FR, ICD-10-GM, OPCS-4, OPS, CCAM, CPT, SNOMED CT, MedDRA, SKS and KVÅ codes based on input text string or documentId.<br/><br/>More than one code system may be defined in a single request.<br/><br/>Code prediction requests have two possible values for context:<br/>- `text`: One set of code prediction results will be returned based on all input text defined.<br/>- `documentId`: Code prediction will be based on that defined document only.<br/><br/>The response includes two sets of results:<br/>- `Codes`: Codes predicted by the model.<br/>- `Candidates`: Lower-confidence codes the model considered potentially relevant but excluded from the predicted set.<br/><br/>All predicted code results are based on input context defined in the request only (not other external data or assets associated with an interaction).</Note>
      *
      * @param {Corti.CodesGeneralPredictRequest} request
      * @param {CodesClient.RequestOptions} requestOptions - Request-specific configuration.
@@ -84,8 +84,11 @@ class CodesClient {
      *                 text: "Patient presents with uncontrolled type 2 diabetes."
      *             }],
      *         filter: {
-     *             include: ["E11"],
-     *             exclude: ["exclude"]
+     *             include: [{
+     *                     property: "code",
+     *                     op: "is-a",
+     *                     value: ["E11"]
+     *                 }]
      *         }
      *     })
      */

package/dist/cjs/api/resources/codes/client/requests/CodesGeneralPredictRequest.d.ts

@@ -17,8 +17,11 @@ import type * as Corti from "../../../../index.js";
  *                 text: "Patient presents with uncontrolled type 2 diabetes."
  *             }],
  *         filter: {
- *             include: ["E11"],
- *             exclude: ["exclude"]
+ *             include: [{
+ *                     property: "code",
+ *                     op: "is-a",
+ *                     value: ["E11"]
+ *                 }]
  *         }
  *     }
  */

package/dist/cjs/api/resources/documents/resources/classic/client/Client.d.ts

@@ -15,6 +15,10 @@ export declare class ClassicClient {
      *
      * List Documents
      *
+     * <Note>
+     * This endpoint is deprecated in favour of the corresponding GUIDED endpoint. See the [deprecation notice](/release-notes/changelog-upcoming#2026-08-21) for more details and migration guidance.
+     * </Note>
+     *
      * @param {Corti.Uuid} id - The unique identifier of the interaction. Must be a valid UUID.
      * @param {ClassicClient.RequestOptions} requestOptions - Request-specific configuration.
      *
@@ -33,6 +37,10 @@ export declare class ClassicClient {
      *
      * This endpoint offers different ways to generate a document. Find guides to document generation [here](/textgen/documents-standard).
      *
+     * <Note>
+     * This endpoint is deprecated in favour of the corresponding GUIDED endpoint. See the [deprecation notice](/release-notes/changelog-upcoming#2026-08-21) for more details and migration guidance.
+     * </Note>
+     *
      * @param {Corti.Uuid} id - The unique identifier of the interaction. Must be a valid UUID.
      * @param {Corti.DocumentsCreateRequest} request
      * @param {ClassicClient.RequestOptions} requestOptions - Request-specific configuration.
@@ -61,6 +69,10 @@ export declare class ClassicClient {
      *
      * Get Document.
      *
+     * <Note>
+     * This endpoint is deprecated in favour of the corresponding GUIDED endpoint. See the [deprecation notice](/release-notes/changelog-upcoming#2026-08-21) for more details and migration guidance.
+     * </Note>
+     *
      * @param {Corti.Uuid} id - The unique identifier of the interaction. Must be a valid UUID.
      * @param {Corti.Uuid} documentId - The document ID representing the context for the request. Must be a valid UUID.
      * @param {ClassicClient.RequestOptions} requestOptions - Request-specific configuration.
@@ -78,6 +90,10 @@ export declare class ClassicClient {
     /**
      * @deprecated
      *
+     * <Note>
+     * This endpoint is deprecated in favour of the corresponding GUIDED endpoint. See the [deprecation notice](/release-notes/changelog-upcoming#2026-08-21) for more details and migration guidance.
+     * </Note>
+     *
      * @param {Corti.Uuid} id - The unique identifier of the interaction. Must be a valid UUID.
      * @param {Corti.Uuid} documentId - The document ID representing the context for the request. Must be a valid UUID.
      * @param {ClassicClient.RequestOptions} requestOptions - Request-specific configuration.
@@ -95,6 +111,10 @@ export declare class ClassicClient {
     /**
      * @deprecated
      *
+     * <Note>
+     * This endpoint is deprecated in favour of the corresponding GUIDED endpoint. See the [deprecation notice](/release-notes/changelog-upcoming#2026-08-21) for more details and migration guidance.
+     * </Note>
+     *
      * @param {Corti.Uuid} id - The unique identifier of the interaction. Must be a valid UUID.
      * @param {Corti.Uuid} documentId - The document ID representing the context for the request. Must be a valid UUID.
      * @param {Corti.documents.DocumentsUpdateRequest} request

package/dist/cjs/api/resources/documents/resources/classic/client/Client.js

@@ -60,6 +60,10 @@ class ClassicClient {
      *
      * List Documents
      *
+     * <Note>
+     * This endpoint is deprecated in favour of the corresponding GUIDED endpoint. See the [deprecation notice](/release-notes/changelog-upcoming#2026-08-21) for more details and migration guidance.
+     * </Note>
+     *
      * @param {Corti.Uuid} id - The unique identifier of the interaction. Must be a valid UUID.
      * @param {ClassicClient.RequestOptions} requestOptions - Request-specific configuration.
      *
@@ -140,6 +144,10 @@ class ClassicClient {
      *
      * This endpoint offers different ways to generate a document. Find guides to document generation [here](/textgen/documents-standard).
      *
+     * <Note>
+     * This endpoint is deprecated in favour of the corresponding GUIDED endpoint. See the [deprecation notice](/release-notes/changelog-upcoming#2026-08-21) for more details and migration guidance.
+     * </Note>
+     *
      * @param {Corti.Uuid} id - The unique identifier of the interaction. Must be a valid UUID.
      * @param {Corti.DocumentsCreateRequest} request
      * @param {ClassicClient.RequestOptions} requestOptions - Request-specific configuration.
@@ -236,6 +244,10 @@ class ClassicClient {
      *
      * Get Document.
      *
+     * <Note>
+     * This endpoint is deprecated in favour of the corresponding GUIDED endpoint. See the [deprecation notice](/release-notes/changelog-upcoming#2026-08-21) for more details and migration guidance.
+     * </Note>
+     *
      * @param {Corti.Uuid} id - The unique identifier of the interaction. Must be a valid UUID.
      * @param {Corti.Uuid} documentId - The document ID representing the context for the request. Must be a valid UUID.
      * @param {ClassicClient.RequestOptions} requestOptions - Request-specific configuration.
@@ -315,6 +327,10 @@ class ClassicClient {
     /**
      * @deprecated
      *
+     * <Note>
+     * This endpoint is deprecated in favour of the corresponding GUIDED endpoint. See the [deprecation notice](/release-notes/changelog-upcoming#2026-08-21) for more details and migration guidance.
+     * </Note>
+     *
      * @param {Corti.Uuid} id - The unique identifier of the interaction. Must be a valid UUID.
      * @param {Corti.Uuid} documentId - The document ID representing the context for the request. Must be a valid UUID.
      * @param {ClassicClient.RequestOptions} requestOptions - Request-specific configuration.
@@ -385,6 +401,10 @@ class ClassicClient {
     /**
      * @deprecated
      *
+     * <Note>
+     * This endpoint is deprecated in favour of the corresponding GUIDED endpoint. See the [deprecation notice](/release-notes/changelog-upcoming#2026-08-21) for more details and migration guidance.
+     * </Note>
+     *
      * @param {Corti.Uuid} id - The unique identifier of the interaction. Must be a valid UUID.
      * @param {Corti.Uuid} documentId - The document ID representing the context for the request. Must be a valid UUID.
      * @param {Corti.documents.DocumentsUpdateRequest} request

package/dist/cjs/api/resources/languages/client/Client.d.ts

@@ -17,7 +17,6 @@ export declare class LanguagesClient {
      * @param {LanguagesClient.RequestOptions} requestOptions - Request-specific configuration.
      *
      * @throws {@link Corti.BadRequestError}
-     * @throws {@link Corti.InternalServerError}
      *
      * @example
      *     await client.languages.list()

package/dist/cjs/api/resources/languages/client/Client.js

@@ -62,7 +62,6 @@ class LanguagesClient {
      * @param {LanguagesClient.RequestOptions} requestOptions - Request-specific configuration.
      *
      * @throws {@link Corti.BadRequestError}
-     * @throws {@link Corti.InternalServerError}
      *
      * @example
      *     await client.languages.list()
@@ -111,14 +110,6 @@ class LanguagesClient {
                 switch (_response.error.statusCode) {
                     case 400:
                         throw new Corti.BadRequestError(_response.error.body, _response.rawResponse);
-                    case 500:
-                        throw new Corti.InternalServerError(serializers.ErrorResponse.parseOrThrow(_response.error.body, {
-                            unrecognizedObjectKeys: "passthrough",
-                            allowUnrecognizedUnionMembers: true,
-                            allowUnrecognizedEnumValues: true,
-                            skipValidation: true,
-                            breadcrumbsPrefix: ["response"],
-                        }), _response.rawResponse);
                     default:
                         throw new errors.CortiError({
                             statusCode: _response.error.statusCode,

package/dist/cjs/api/resources/languages/types/LanguagesListRequestEndpoint.d.ts

@@ -1,4 +1,3 @@
-/** Field used to filter languages that supported specific endpoint. */
 export declare const LanguagesListRequestEndpoint: {
     readonly Streams: "streams";
     readonly Transcribe: "transcribe";

package/dist/cjs/api/resources/languages/types/LanguagesListRequestEndpoint.js

@@ -2,7 +2,6 @@
 // This file was auto-generated by Fern from our API Definition.
 Object.defineProperty(exports, "__esModule", { value: true });
 exports.LanguagesListRequestEndpoint = void 0;
-/** Field used to filter languages that supported specific endpoint. */
 exports.LanguagesListRequestEndpoint = {
     Streams: "streams",
     Transcribe: "transcribe",

package/dist/cjs/api/resources/languages/types/LanguagesListResponse.d.ts

@@ -0,0 +1,4 @@
+import type * as Corti from "../../../index.js";
+export interface LanguagesListResponse {
+    languages: Record<string, Corti.LanguagesListResponseLanguagesValue>;
+}

package/dist/cjs/api/resources/languages/types/LanguagesListResponseLanguagesValue.d.ts

@@ -0,0 +1,4 @@
+import type * as Corti from "../../../index.js";
+export interface LanguagesListResponseLanguagesValue {
+    endpoints: Corti.LanguagesListResponseLanguagesValueEndpoints;
+}

package/dist/cjs/api/resources/languages/types/LanguagesListResponseLanguagesValueEndpoints.d.ts

@@ -0,0 +1,9 @@
+import type * as Corti from "../../../index.js";
+export interface LanguagesListResponseLanguagesValueEndpoints {
+    /** Streams endpoint with its supported attributes. */
+    streams: Corti.LanguagesEndpointAttributes;
+    /** Transcribe endpoint with its supported attributes. */
+    transcribe: Corti.LanguagesEndpointAttributes;
+    /** Transcripts endpoint with its supported attributes. */
+    transcripts: Corti.LanguagesEndpointAttributes;
+}

package/dist/cjs/api/resources/languages/types/LanguagesListResponseLanguagesValueEndpoints.js

@@ -0,0 +1,3 @@
+"use strict";
+// This file was auto-generated by Fern from our API Definition.
+Object.defineProperty(exports, "__esModule", { value: true });

package/dist/cjs/api/resources/languages/types/index.d.ts

@@ -1 +1,4 @@
 export * from "./LanguagesListRequestEndpoint.js";
+export * from "./LanguagesListResponse.js";
+export * from "./LanguagesListResponseLanguagesValue.js";
+export * from "./LanguagesListResponseLanguagesValueEndpoints.js";

package/dist/cjs/api/resources/languages/types/index.js

@@ -15,3 +15,6 @@ var __exportStar = (this && this.__exportStar) || function(m, exports) {
 };
 Object.defineProperty(exports, "__esModule", { value: true });
 __exportStar(require("./LanguagesListRequestEndpoint.js"), exports);
+__exportStar(require("./LanguagesListResponse.js"), exports);
+__exportStar(require("./LanguagesListResponseLanguagesValue.js"), exports);
+__exportStar(require("./LanguagesListResponseLanguagesValueEndpoints.js"), exports);

package/dist/cjs/api/resources/templates/client/Client.d.ts

@@ -11,8 +11,14 @@ export declare class TemplatesClient {
     protected readonly _options: NormalizedClientOptionsWithAuth<TemplatesClient.Options>;
     constructor(options: TemplatesClient.Options);
     /**
+     * @deprecated
+     *
      * Retrieves a list of template sections with optional filters for organization and language.
      *
+     * <Note>
+     * This endpoint is deprecated in favour of the corresponding GUIDED endpoint. See the [deprecation notice](/release-notes/changelog-upcoming#2026-08-21) for more details and migration guidance.
+     * </Note>
+     *
      * @param {Corti.TemplatesSectionListRequest} request
      * @param {TemplatesClient.RequestOptions} requestOptions - Request-specific configuration.
      *
@@ -25,8 +31,14 @@ export declare class TemplatesClient {
     sectionList(request?: Corti.TemplatesSectionListRequest, requestOptions?: TemplatesClient.RequestOptions): core.HttpResponsePromise<Corti.TemplatesSectionListResponse>;
     private __sectionList;
     /**
+     * @deprecated
+     *
      * Retrieves a list of templates with optional filters for organization, language, and status.
      *
+     * <Note>
+     * This endpoint is deprecated in favour of the corresponding GUIDED endpoint. See the [deprecation notice](/release-notes/changelog-upcoming#2026-08-21) for more details and migration guidance.
+     * </Note>
+     *
      * @param {Corti.TemplatesListRequest} request
      * @param {TemplatesClient.RequestOptions} requestOptions - Request-specific configuration.
      *
@@ -39,8 +51,14 @@ export declare class TemplatesClient {
     list(request?: Corti.TemplatesListRequest, requestOptions?: TemplatesClient.RequestOptions): core.HttpResponsePromise<Corti.TemplatesListResponse>;
     private __list;
     /**
+     * @deprecated
+     *
      * Retrieves template by key.
      *
+     * <Note>
+     * This endpoint is deprecated in favour of the corresponding GUIDED endpoint. See the [deprecation notice](/release-notes/changelog-upcoming#2026-08-21) for more details and migration guidance.
+     * </Note>
+     *
      * @param {string} key - The key of the template
      * @param {TemplatesClient.RequestOptions} requestOptions - Request-specific configuration.
      *

package/dist/cjs/api/resources/templates/client/Client.js

@@ -56,8 +56,14 @@ class TemplatesClient {
         this._options = (0, BaseClient_js_1.normalizeClientOptionsWithAuth)(options);
     }
     /**
+     * @deprecated
+     *
      * Retrieves a list of template sections with optional filters for organization and language.
      *
+     * <Note>
+     * This endpoint is deprecated in favour of the corresponding GUIDED endpoint. See the [deprecation notice](/release-notes/changelog-upcoming#2026-08-21) for more details and migration guidance.
+     * </Note>
+     *
      * @param {Corti.TemplatesSectionListRequest} request
      * @param {TemplatesClient.RequestOptions} requestOptions - Request-specific configuration.
      *
@@ -127,8 +133,14 @@ class TemplatesClient {
         });
     }
     /**
+     * @deprecated
+     *
      * Retrieves a list of templates with optional filters for organization, language, and status.
      *
+     * <Note>
+     * This endpoint is deprecated in favour of the corresponding GUIDED endpoint. See the [deprecation notice](/release-notes/changelog-upcoming#2026-08-21) for more details and migration guidance.
+     * </Note>
+     *
      * @param {Corti.TemplatesListRequest} request
      * @param {TemplatesClient.RequestOptions} requestOptions - Request-specific configuration.
      *
@@ -199,8 +211,14 @@ class TemplatesClient {
         });
     }
     /**
+     * @deprecated
+     *
      * Retrieves template by key.
      *
+     * <Note>
+     * This endpoint is deprecated in favour of the corresponding GUIDED endpoint. See the [deprecation notice](/release-notes/changelog-upcoming#2026-08-21) for more details and migration guidance.
+     * </Note>
+     *
      * @param {string} key - The key of the template
      * @param {TemplatesClient.RequestOptions} requestOptions - Request-specific configuration.
      *

package/dist/cjs/api/resources/transcripts/client/Client.d.ts

@@ -11,7 +11,7 @@ export declare class TranscriptsClient {
     protected readonly _options: NormalizedClientOptionsWithAuth<TranscriptsClient.Options>;
     constructor(options: TranscriptsClient.Options);
     /**
-     * Retrieves a list of transcripts for a given interaction.
+     * Retrieves a list of transcripts for a given interaction. Transcripts are ordered based on their creation time. Default ordering (desc) will return the most recent transcript first in the list. Use query parameter `direction` to define the order of the list (`asc` for ascending and `desc` for descending).
      *
      * @param {Corti.Uuid} id - The unique identifier of the interaction. Must be a valid UUID.
      * @param {Corti.TranscriptsListRequest} request

package/dist/cjs/api/resources/transcripts/client/Client.js

@@ -56,7 +56,7 @@ class TranscriptsClient {
         this._options = (0, BaseClient_js_1.normalizeClientOptionsWithAuth)(options);
     }
     /**
-     * Retrieves a list of transcripts for a given interaction.
+     * Retrieves a list of transcripts for a given interaction. Transcripts are ordered based on their creation time. Default ordering (desc) will return the most recent transcript first in the list. Use query parameter `direction` to define the order of the list (`asc` for ascending and `desc` for descending).
      *
      * @param {Corti.Uuid} id - The unique identifier of the interaction. Must be a valid UUID.
      * @param {Corti.TranscriptsListRequest} request
@@ -77,9 +77,15 @@ class TranscriptsClient {
     __list(id_1) {
         return __awaiter(this, arguments, void 0, function* (id, request = {}, requestOptions) {
             var _a, _b, _c, _d, _e, _f, _g, _h, _j, _k;
-            const { full } = request;
+            const { full, direction } = request;
             const _queryParams = {
                 full,
+                direction: direction != null
+                    ? serializers.CommonSortingDirectionEnum.jsonOrThrow(direction, {
+                        unrecognizedObjectKeys: "strip",
+                        omitUndefined: true,
+                    })
+                    : undefined,
             };
             const _authRequest = yield this._options.authProvider.getAuthRequest();
             const _headers = (0, headers_js_1.mergeHeaders)(_authRequest.headers, (_a = this._options) === null || _a === void 0 ? void 0 : _a.headers, (0, headers_js_1.mergeOnlyDefinedHeaders)({ "Tenant-Name": (_b = requestOptions === null || requestOptions === void 0 ? void 0 : requestOptions.tenantName) !== null && _b !== void 0 ? _b : (_c = this._options) === null || _c === void 0 ? void 0 : _c.tenantName }), requestOptions === null || requestOptions === void 0 ? void 0 : requestOptions.headers);

package/dist/cjs/api/resources/transcripts/client/requests/TranscriptsCreateRequest.d.ts

@@ -15,18 +15,21 @@ export interface TranscriptsCreateRequest {
     spokenPunctuation?: boolean;
     /** When true, automatically punctuates and capitalizes the transcript. Defaults to true. Overridden by `spokenPunctuation` when both are enabled. */
     automaticPunctuation?: boolean;
+    formatting?: Corti.TranscriptsFormatting;
     /** **Deprecated** — replaced by `spokenPunctuation` and `automaticPunctuation`. Ignored when either of those fields is provided. When `true` and neither new field is provided, it is treated as `spokenPunctuation: true` (automatic punctuation off). No removal date is currently planned. */
     isDictation?: boolean;
     /** If true, each audio channel is transcribed separately. */
     isMultichannel?: boolean;
     /** If true, separates speakers within an audio channel returning incrementing ids for transcript segments. */
     diarize?: boolean;
-    /** An array of participants, each specifying a role and an assigned audio channel in the recording. Leave empty when shouldDiarize: true */
+    /** An array of participants, each specifying a free-form role and an assigned audio channel in the recording. For raw PCM, the channel count must be defined; otherwise, the number of audio channels is resolved from the audio itself, not from the declared participants. Leave empty when diarize: true. See [audio formatting](https://docs.corti.ai/stt/audio) for full details. */
     participants?: Corti.TranscriptsParticipant[];
     /** If true, the request will return immediately with a 202 status and the transcript will be processed asynchronously. Poll [Get Transcript Status](/api-reference/transcripts/get-transcript-status) to check transcript processing status - `processing`, `completed`, `failed`. */
     async?: boolean;
-    /** Define replacements to have terms (single words or multi-word phrases) replaced in final text output with your preferred style. For example, replace "BID" with "twice daily". Configuration is case insensitive and limited to 1,000 replacements per stream. */
+    /** Define replacements to have terms (single words or multi-word phrases) replaced in final text output with your preferred style. For example, replace "BID" with "twice daily". Configuration is case insensitive and limited to 1,000 replacements per stream. A defined replacement can have a maximum length of 50 characters and 5-words for `find` and 100 characters and 10-words for `replace`. */
     replacements?: Corti.TranscriptsCreateRequestReplacementsItem[];
     /** Define words, terms, and phrases to be recognized by Corti speech-to-text. Especially useful for proper nouns (e.g., surnames), but also supportive of words not being recognized consistently. */
     keyterms?: Corti.TranscriptsCreateRequestKeyterms;
+    /** When enabled, the transcript is stored and returned at word level instead of phrase/utterance level. Fixed for the lifetime of the transcript once created. */
+    wordLevel?: Corti.TranscriptsCreateRequestWordLevel;
 }

package/dist/cjs/api/resources/transcripts/client/requests/TranscriptsListRequest.d.ts

@@ -1,3 +1,4 @@
+import type * as Corti from "../../../../index.js";
 /**
  * @example
  *     {}
@@ -5,4 +6,6 @@
 export interface TranscriptsListRequest {
     /** Display full transcripts in listing */
     full?: boolean;
+    /** Sorting order. Allowed values: [asc, desc]. Default is desc. */
+    direction?: Corti.CommonSortingDirectionEnum;
 }

package/dist/cjs/api/resources/transcripts/types/TranscriptsCreateRequestWordLevel.d.ts

@@ -0,0 +1,6 @@
+/**
+ * When enabled, the transcript is stored and returned at word level instead of phrase/utterance level. Fixed for the lifetime of the transcript once created.
+ */
+export interface TranscriptsCreateRequestWordLevel {
+    enabled?: boolean;
+}

package/dist/cjs/api/resources/transcripts/types/TranscriptsCreateRequestWordLevel.js

@@ -0,0 +1,3 @@
+"use strict";
+// This file was auto-generated by Fern from our API Definition.
+Object.defineProperty(exports, "__esModule", { value: true });

package/dist/cjs/api/resources/transcripts/types/index.d.ts

@@ -1,3 +1,4 @@
 export * from "./TranscriptsCreateRequestKeyterms.js";
 export * from "./TranscriptsCreateRequestKeytermsTermsItem.js";
 export * from "./TranscriptsCreateRequestReplacementsItem.js";
+export * from "./TranscriptsCreateRequestWordLevel.js";

package/dist/cjs/api/resources/transcripts/types/index.js

@@ -17,3 +17,4 @@ Object.defineProperty(exports, "__esModule", { value: true });
 __exportStar(require("./TranscriptsCreateRequestKeyterms.js"), exports);
 __exportStar(require("./TranscriptsCreateRequestKeytermsTermsItem.js"), exports);
 __exportStar(require("./TranscriptsCreateRequestReplacementsItem.js"), exports);
+__exportStar(require("./TranscriptsCreateRequestWordLevel.js"), exports);

package/dist/cjs/api/types/AgenticAgentsResponse.d.ts

@@ -15,6 +15,8 @@ export interface AgenticAgentsResponse {
      * **Open question** — in the current implementation a model is configured per *expert*, not per *agent* (`Expert.modelName`), and an `Agent` has no model field at all. The desired end state is that there is **no distinction between an expert and an agent**, so `model` lives uniformly on this resource. Until that convergence lands, the precedence of an agent-level `model` over a connector/expert-level override is undecided and MUST be resolved before this field ships.
      */
     model?: string | null;
+    /** Effective cap on the orchestrator's ReAct loop iterations per run. Always present: agents created without `maxLoops` report the server default (10). */
+    maxLoops: number;
     visibility: Corti.AgentsVisibility;
     lifecycle: Corti.AgentsLifecycle;
     /** Connectors attached to the agent, discriminated by `type`. */
@@ -26,4 +28,6 @@ export interface AgenticAgentsResponse {
     updatedAt?: Date;
     /** Principal (user or service principal) that created the agent. */
     createdBy?: Corti.AgentsUserIdValue;
+    /** When the agent expires; `null` means it does not expire. Ephemeral agents get a 24h expiry at creation time; persistent agents never expire. */
+    expiresAt?: Date | null;
 }

package/dist/cjs/api/types/AgentsCreateMcpServer.d.ts

@@ -12,8 +12,12 @@ export interface AgentsCreateMcpServer {
     authorizationScope?: string;
     /** URL of the MCP server. */
     url: string;
-    /** Redirect URI for OAuth2.0 authorization. */
-    redirectUrl?: string;
+    /** Token URL override for the OAuth2.0 token endpoint. */
+    tokenUrl?: string;
     /** Bearer token to be used in MCP client. */
     token?: string;
+    /** Header names the MCP server requires the client to send. */
+    requiredHeaders?: string[];
+    /** Header names the client may optionally send. */
+    optionalHeaders?: string[];
 }

package/dist/cjs/api/types/AgentsMcpServer.d.ts

@@ -12,6 +12,10 @@ export interface AgentsMcpServer {
     authorizationScope?: string;
     /** URL of the MCP server. */
     url: string;
-    /** Redirect URI for OAuth2.0 authorization. */
-    redirectUrl?: string | null;
+    /** Token URL override for the OAuth2.0 token endpoint. */
+    tokenUrl?: string;
+    /** Header names the MCP server requires the client to send. */
+    requiredHeaders?: string[];
+    /** Header names the client may optionally send. */
+    optionalHeaders?: string[];
 }