@corti/sdk 5.0.0 → 6.0.0-rc.2

package/dist/esm/api/resources/documents/resources/classic/client/Client.mjs

@@ -24,6 +24,10 @@ export 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.
      *
@@ -104,6 +108,10 @@ export 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.
@@ -200,6 +208,10 @@ export 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.
@@ -279,6 +291,10 @@ export 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.
@@ -349,6 +365,10 @@ export 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/esm/api/resources/languages/client/Client.d.mts

@@ -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/esm/api/resources/languages/client/Client.mjs

@@ -26,7 +26,6 @@ export class LanguagesClient {
      * @param {LanguagesClient.RequestOptions} requestOptions - Request-specific configuration.
      *
      * @throws {@link Corti.BadRequestError}
-     * @throws {@link Corti.InternalServerError}
      *
      * @example
      *     await client.languages.list()
@@ -75,14 +74,6 @@ export 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/esm/api/resources/languages/types/LanguagesListRequestEndpoint.d.mts

@@ -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/esm/api/resources/languages/types/LanguagesListRequestEndpoint.mjs

@@ -1,5 +1,4 @@
 // This file was auto-generated by Fern from our API Definition.
-/** Field used to filter languages that supported specific endpoint. */
 export const LanguagesListRequestEndpoint = {
     Streams: "streams",
     Transcribe: "transcribe",

package/dist/esm/api/resources/languages/types/LanguagesListResponse.d.mts

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

package/dist/esm/api/resources/languages/types/LanguagesListResponseLanguagesValue.d.mts

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

package/dist/esm/api/resources/languages/types/LanguagesListResponseLanguagesValueEndpoints.d.mts

@@ -0,0 +1,9 @@
+import type * as Corti from "../../../index.mjs";
+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/esm/api/resources/languages/types/LanguagesListResponseLanguagesValueEndpoints.mjs

@@ -0,0 +1,2 @@
+// This file was auto-generated by Fern from our API Definition.
+export {};

package/dist/esm/api/resources/languages/types/index.d.mts

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

package/dist/esm/api/resources/languages/types/index.mjs

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

package/dist/esm/api/resources/templates/client/Client.d.mts

@@ -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/esm/api/resources/templates/client/Client.mjs

@@ -20,8 +20,14 @@ export class TemplatesClient {
         this._options = 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.
      *
@@ -91,8 +97,14 @@ export 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.
      *
@@ -163,8 +175,14 @@ export 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/esm/api/resources/transcribe/client/Socket.d.mts

@@ -4,7 +4,7 @@ export declare namespace TranscribeSocket {
     interface Args {
         socket: core.ReconnectingWebSocket;
     }
-    type Response = Corti.TranscribeUsageMessage | Corti.TranscribeFlushedMessage | Corti.TranscribeDeltaUsageMessage | Corti.TranscribeEndedMessage | Corti.TranscribeErrorMessage | Corti.TranscribeTranscriptMessage | Corti.TranscribeCommandMessage | Corti.TranscribeConfigStatusMessage | Corti.TranscribeAudioEventMessage;
+    type Response = Corti.TranscribeUsageMessage | Corti.TranscribeFlushedMessage | Corti.TranscribeDeltaUsageMessage | Corti.TranscribeEndedMessage | Corti.TranscribeErrorMessage | Corti.TranscribeTranscriptMessage | Corti.TranscribeCommandMessage | Corti.TranscribeConfigStatusMessage | Corti.TranscribeAudioEventMessage | Corti.TranscribeCommandsUpdateAcceptedMessage | Corti.TranscribeCommandsUpdateDeniedMessage;
     type EventHandlers = {
         open?: () => void;
         message?: (message: Response) => void;
@@ -37,6 +37,7 @@ export declare class TranscribeSocket {
     sendAudio(message: ArrayBufferLike | Blob | ArrayBufferView): void;
     sendFlush(message: Corti.TranscribeFlushMessage): void;
     sendEnd(message: Corti.TranscribeEndMessage): void;
+    sendCommandsUpdate(message: Corti.TranscribeCommandsUpdateMessage): void;
     /** Connect to the websocket and register event handlers. */
     connect(): TranscribeSocket;
     /** Close the websocket and unregister event handlers. */

package/dist/esm/api/resources/transcribe/client/Socket.mjs

@@ -11,6 +11,7 @@ var __awaiter = (this && this.__awaiter) || function (thisArg, _arguments, P, ge
 import * as core from "../../../../core/index.mjs";
 import { fromJson } from "../../../../core/json.mjs";
 import * as serializers from "../../../../serialization/index.mjs";
+import { TranscribeCommandsUpdateMessage } from "../../../../serialization/types/TranscribeCommandsUpdateMessage.mjs";
 import { TranscribeConfigMessage } from "../../../../serialization/types/TranscribeConfigMessage.mjs";
 import { TranscribeEndMessage } from "../../../../serialization/types/TranscribeEndMessage.mjs";
 import { TranscribeFlushMessage } from "../../../../serialization/types/TranscribeFlushMessage.mjs";
@@ -107,6 +108,17 @@ export class TranscribeSocket {
         });
         this.socket.send(JSON.stringify(jsonPayload));
     }
+    sendCommandsUpdate(message) {
+        this.assertSocketIsOpen();
+        const jsonPayload = TranscribeCommandsUpdateMessage.jsonOrThrow(message, {
+            unrecognizedObjectKeys: "passthrough",
+            allowUnrecognizedUnionMembers: true,
+            allowUnrecognizedEnumValues: true,
+            skipValidation: true,
+            omitUndefined: true,
+        });
+        this.socket.send(JSON.stringify(jsonPayload));
+    }
     /** Connect to the websocket and register event handlers. */
     connect() {
         this.socket.reconnect();

package/dist/esm/api/resources/transcripts/client/Client.d.mts

@@ -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/esm/api/resources/transcripts/client/Client.mjs

@@ -20,7 +20,7 @@ export class TranscriptsClient {
         this._options = 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
@@ -41,9 +41,15 @@ export 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 = mergeHeaders(_authRequest.headers, (_a = this._options) === null || _a === void 0 ? void 0 : _a.headers, 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/esm/api/resources/transcripts/client/requests/TranscriptsCreateRequest.d.mts

@@ -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 100 characters and 10-words for `find` and `replace` fields. */
     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/esm/api/resources/transcripts/client/requests/TranscriptsListRequest.d.mts

@@ -1,3 +1,4 @@
+import type * as Corti from "../../../../index.mjs";
 /**
  * @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/esm/api/resources/transcripts/types/TranscriptsCreateRequestWordLevel.d.mts

@@ -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/esm/api/resources/transcripts/types/TranscriptsCreateRequestWordLevel.mjs

@@ -0,0 +1,2 @@
+// This file was auto-generated by Fern from our API Definition.
+export {};

package/dist/esm/api/resources/transcripts/types/index.d.mts

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

package/dist/esm/api/resources/transcripts/types/index.mjs

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

package/dist/esm/api/types/AgenticAgentsResponse.d.mts

@@ -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/esm/api/types/AgentsCreateMcpServer.d.mts

@@ -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/esm/api/types/AgentsMcpServer.d.mts

@@ -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[];
 }

package/dist/esm/api/types/AgentsRegistryMcpServer.d.mts

@@ -4,4 +4,8 @@ export interface AgentsRegistryMcpServer {
     name: string;
     /** Type of authorization used by the MCP server. */
     authorizationType: Corti.AgentsRegistryMcpServerAuthorizationType;
+    /** Header names the MCP server requires the client to send. */
+    requiredHeaders?: string[];
+    /** Header names the client may optionally send. */
+    optionalHeaders?: string[];
 }

package/dist/esm/api/types/CodesFilter.d.mts

@@ -1,11 +1,10 @@
+import type * as Corti from "../index.mjs";
 /**
  * Optional filter to restrict the set of codes the model can predict.
  */
 export interface CodesFilter {
-    /** Codes or categories to include. When empty, the full set of codes for the requested systems is used. */
-    include?: string[];
-    /** Codes or categories to subtract from the include set. */
-    exclude?: string[];
-    /** When true (default), category codes are expanded to their leaf codes. */
-    expand?: boolean;
+    /** Condition objects to include. When empty, the full set of codes for the requested systems is used. */
+    include?: Corti.CodesFilterCondition[];
+    /** Condition objects to subtract from the include set. */
+    exclude?: Corti.CodesFilterCondition[];
 }

package/dist/esm/api/types/CodesFilterCondition.d.mts

@@ -0,0 +1,12 @@
+import type * as Corti from "../index.mjs";
+/**
+ * Single property/op/value filter clause for attribute-based code filtering.
+ */
+export interface CodesFilterCondition {
+    /** The attribute to filter on. */
+    property: string;
+    /** Comparison operator: `=` (equal), `is-a` (code plus descendants), `descendent-of` (strict descendants), `exists` (`value: true`/`false` for set/unset), `in` (membership). */
+    op?: Corti.CodesFilterConditionOp;
+    /** Comparison value; type depends on `op`. */
+    value: Corti.CodesFilterConditionValue;
+}

package/dist/esm/api/types/CodesFilterCondition.mjs

@@ -0,0 +1,2 @@
+// This file was auto-generated by Fern from our API Definition.
+export {};

package/dist/esm/api/types/CodesFilterConditionOp.d.mts

@@ -0,0 +1,9 @@
+/** Comparison operator: `=` (equal), `is-a` (code plus descendants), `descendent-of` (strict descendants), `exists` (`value: true`/`false` for set/unset), `in` (membership). */
+export declare const CodesFilterConditionOp: {
+    readonly EqualTo: "=";
+    readonly IsA: "is-a";
+    readonly DescendentOf: "descendent-of";
+    readonly Exists: "exists";
+    readonly In: "in";
+};
+export type CodesFilterConditionOp = (typeof CodesFilterConditionOp)[keyof typeof CodesFilterConditionOp];

package/dist/esm/api/types/CodesFilterConditionOp.mjs

@@ -0,0 +1,9 @@
+// This file was auto-generated by Fern from our API Definition.
+/** Comparison operator: `=` (equal), `is-a` (code plus descendants), `descendent-of` (strict descendants), `exists` (`value: true`/`false` for set/unset), `in` (membership). */
+export const CodesFilterConditionOp = {
+    EqualTo: "=",
+    IsA: "is-a",
+    DescendentOf: "descendent-of",
+    Exists: "exists",
+    In: "in",
+};

package/dist/esm/api/types/CodesFilterConditionValue.d.mts

@@ -0,0 +1,4 @@
+/**
+ * Comparison value; type depends on `op`.
+ */
+export type CodesFilterConditionValue = string | boolean | number | string[];

package/dist/esm/api/types/CodesFilterConditionValue.mjs

@@ -0,0 +1,2 @@
+// This file was auto-generated by Fern from our API Definition.
+export {};

package/dist/esm/api/types/CommonCodingSystemEnum.d.mts

@@ -22,5 +22,14 @@ export declare const CommonCodingSystemEnum: {
     readonly Snomedctdk: "snomedctdk";
     readonly Snomedctse: "snomedctse";
     readonly Snomedctus: "snomedctus";
+    readonly MeddraIt: "meddra-it";
+    readonly MeddraEn: "meddra-en";
+    readonly MeddraFr: "meddra-fr";
+    readonly MeddraEs: "meddra-es";
+    readonly MeddraDe: "meddra-de";
+    readonly MeddraNo: "meddra-no";
+    readonly MeddraSe: "meddra-se";
+    readonly Sks: "sks";
+    readonly Kvaa: "kvaa";
 };
 export type CommonCodingSystemEnum = (typeof CommonCodingSystemEnum)[keyof typeof CommonCodingSystemEnum];

package/dist/esm/api/types/CommonCodingSystemEnum.mjs

@@ -23,4 +23,13 @@ export const CommonCodingSystemEnum = {
     Snomedctdk: "snomedctdk",
     Snomedctse: "snomedctse",
     Snomedctus: "snomedctus",
+    MeddraIt: "meddra-it",
+    MeddraEn: "meddra-en",
+    MeddraFr: "meddra-fr",
+    MeddraEs: "meddra-es",
+    MeddraDe: "meddra-de",
+    MeddraNo: "meddra-no",
+    MeddraSe: "meddra-se",
+    Sks: "sks",
+    Kvaa: "kvaa",
 };

package/dist/esm/api/types/CommonConnectorAuth.d.mts

@@ -12,8 +12,12 @@ export interface CommonConnectorAuth {
     type: Corti.CommonConnectorAuthType;
     /** OAuth2 scope requested. */
     scope?: string;
-    /** OAuth2 redirect URL. */
-    redirectUrl?: string;
+    /** Token URL override for the OAuth2.0 token endpoint. */
+    tokenUrl?: string;
     /** Reference to a server-side stored secret. Mutually exclusive with inline credentials passed at call time. */
     ref?: string;
+    /** Header names the MCP server requires the client to send in the authorization data part. The client must supply values for each listed name; missing headers trigger an auth-required challenge that lists them. */
+    requiredHeaders?: string[];
+    /** Header names the client may optionally send. Headers not in requiredHeaders or optionalHeaders are rejected as undeclared. */
+    optionalHeaders?: string[];
 }

package/dist/esm/api/types/CommonCortiMetadata.d.mts

@@ -0,0 +1,8 @@
+import type * as Corti from "../index.mjs";
+/**
+ * Corti-specific namespace within task metadata. Carries the
+ * per-request `usage` accounting.
+ */
+export interface CommonCortiMetadata {
+    usage?: Corti.CommonCortiUsage;
+}

package/dist/esm/api/types/CommonCortiMetadata.mjs

@@ -0,0 +1,2 @@
+// This file was auto-generated by Fern from our API Definition.
+export {};

package/dist/esm/api/types/CommonCortiUsage.d.mts

@@ -0,0 +1,13 @@
+/**
+ * Per-request usage accounting emitted by the agent service under
+ * `metadata.corti.usage`. `creditsConsumed` is always populated;
+ * `inputTokens` and `outputTokens` may appear in the future.
+ */
+export interface CommonCortiUsage {
+    /** Corti billing credits charged for the task. */
+    creditsConsumed: number;
+    /** Prompt tokens consumed. */
+    inputTokens?: number;
+    /** Completion tokens produced. */
+    outputTokens?: number;
+}

package/dist/esm/api/types/CommonCortiUsage.mjs

@@ -0,0 +1,2 @@
+// This file was auto-generated by Fern from our API Definition.
+export {};

package/dist/esm/api/types/CommonTaskMetadata.d.mts

@@ -1,12 +1,11 @@
 import type * as Corti from "../index.mjs";
 /**
- * Free-form A2A task metadata. Corti's first-party keys are prefixed with
- * `$` (à la Mixpanel) to set them apart from caller-supplied keys. Token and
- * credit accounting is carried under `$usage`. Arbitrary additional keys are
- * permitted.
+ * Free-form A2A task metadata. Corti's first-party keys live under the
+ * `corti` namespace. Token and credit accounting is carried under
+ * `corti.usage`. Arbitrary additional keys are permitted.
  */
 export interface CommonTaskMetadata {
-    usage?: Corti.CommonUsage;
+    corti?: Corti.CommonCortiMetadata;
     /** Accepts any additional properties */
     [key: string]: any;
 }

package/dist/esm/api/types/CommonTaskResponse.d.mts

@@ -10,6 +10,6 @@ export interface CommonTaskResponse {
     history?: Corti.CommonMessage[];
     /** Artifacts produced by the task. */
     artifacts?: Corti.CommonArtifactResponse[];
-    /** Task metadata, including `$usage` token/credit accounting. Not yet exposed through the REST binding (deferred); only the JSON-RPC binding populates this field. */
+    /** Task metadata, including `corti.usage` credit accounting. Populated by both the REST and JSON-RPC v2 bindings; the deprecated v1 bindings do not include it. */
     metadata?: Corti.CommonTaskMetadata;
 }

package/dist/esm/api/types/CommonTranscriptResponse.d.mts

@@ -5,7 +5,7 @@ export interface CommonTranscriptResponse {
     participant: number;
     /** Id to tag an identified speaker. Auto-increments. */
     speakerId: number;
-    /** The spoken phrase or utterance extracted from the audio. */
+    /** The spoken phrase or utterance extracted from the audio. Will be a single word or entity if `wordLevel.enabled` was set to `true` when the transcript was created. */
     text: string;
     /** Start time in milliseconds for phrase/utterance. */
     start: number;

package/dist/esm/api/types/GuidedArrayNode.d.mts

@@ -11,4 +11,6 @@ export interface GuidedArrayNode {
     minItems?: number | null;
     /** Maximum number of array items to generate. */
     maxItems?: number | null;
+    /** Text rendered in place of the array when no items have relevant input/output. */
+    fallbackString?: string | null;
 }