@corti/sdk 1.0.0-alpha.2 → 1.0.0-rc-8

package/README.md

@@ -29,7 +29,7 @@ The Corti JavaScript library provides convenient access to the Corti APIs from J
 
 ## Documentation
 
-- [Documentation](https://docs.corti.ai/)
+- [Documentation](https://docs.corti.ai/sdk/js)
 - [API Reference](https://docs.corti.ai/api-reference)
 - [Console](https://console.corti.app/) — get your credentials here
 - [Examples](https://github.com/corticph/corti-examples)

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": "0.10.2",
-        "User-Agent": "@corti/sdk/0.10.2",
+        "X-Fern-SDK-Version": "1.0.0-rc-8",
+        "User-Agent": "@corti/sdk/1.0.0-rc-8",
         "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/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, and CPT 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-UK, CIM-10-FR, ICD-10-GM, OPCS-4 and CPT 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.

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, and CPT 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-UK, CIM-10-FR, ICD-10-GM, OPCS-4 and CPT 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.

package/dist/cjs/api/resources/stream/client/Socket.d.ts

@@ -4,7 +4,7 @@ export declare namespace StreamSocket {
     interface Args {
         socket: core.ReconnectingWebSocket;
     }
-    type Response = Corti.StreamTranscriptMessage | Corti.StreamFactsMessage | Corti.StreamFlushedMessage | Corti.StreamEndedMessage | Corti.StreamUsageMessage | Corti.StreamErrorMessage | Corti.StreamConfigStatusMessage;
+    type Response = Corti.StreamTranscriptMessage | Corti.StreamFactsMessage | Corti.StreamFlushedMessage | Corti.StreamDeltaUsageMessage | Corti.StreamEndedMessage | Corti.StreamUsageMessage | Corti.StreamErrorMessage | Corti.StreamConfigStatusMessage;
     type EventHandlers = {
         open?: () => void;
         message?: (message: Response) => void;

package/dist/cjs/api/resources/transcribe/client/Socket.d.ts

@@ -4,7 +4,7 @@ export declare namespace TranscribeSocket {
     interface Args {
         socket: core.ReconnectingWebSocket;
     }
-    type Response = Corti.TranscribeUsageMessage | Corti.TranscribeFlushedMessage | Corti.TranscribeEndedMessage | Corti.TranscribeErrorMessage | Corti.TranscribeTranscriptMessage | Corti.TranscribeCommandMessage | Corti.TranscribeConfigStatusMessage;
+    type Response = Corti.TranscribeUsageMessage | Corti.TranscribeFlushedMessage | Corti.TranscribeDeltaUsageMessage | Corti.TranscribeEndedMessage | Corti.TranscribeErrorMessage | Corti.TranscribeTranscriptMessage | Corti.TranscribeCommandMessage | Corti.TranscribeConfigStatusMessage;
     type EventHandlers = {
         open?: () => void;
         message?: (message: Response) => void;

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

@@ -15,10 +15,10 @@ export interface AgentsAgentCard {
     iconUrl?: string | null;
     /** A URL to documentation describing how to interact with the agent. */
     documentationUrl?: string | null;
-    provider?: Corti.AgentsAgentProvider;
+    provider?: Corti.AgentsAgentProvider | null;
     /** The version of the agent. */
     version: string;
-    capabilities: Corti.AgentsAgentCapabilities;
+    capabilities: Corti.AgentsAgentCapabilities | null;
     /** A declaration of the security schemes available to authorize requests. The key is the scheme name. Follows the OpenAPI 3.0 Security Scheme Object. */
     securitySchemes?: Record<string, unknown> | null;
     /** A list of security requirement objects that apply to all agent interactions. Each object lists security schemes that can be used. Follows the OpenAPI 3.0 Security Requirement Object. This list can be seen as an OR of ANDs. Each object in the list describes one possible set of security requirements that must be present on a request. This allows specifying, for example, "callers must either use OAuth OR an API Key AND mTLS." */

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

@@ -1,4 +1,3 @@
-import type * as Corti from "../index.js";
 export interface AgentsErrorResponse {
     /** A machine-readable error code that identifies the type of error. */
     code: string;
@@ -8,5 +7,6 @@ export interface AgentsErrorResponse {
     howToFix?: string;
     /** An optional object containing additional details about the error. */
     details?: Record<string, unknown>;
-    cause?: Corti.AgentsErrorResponse;
+    /** An optional object containing the cause of the error, following the same structure as the parent error response. */
+    cause?: Record<string, unknown>;
 }

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

@@ -4,5 +4,5 @@ export interface CodesGeneralResponse {
     codes: Corti.CodesGeneralReadResponse[];
     /** Lower-confidence codes the model considered potentially relevant but excluded from the predicted set. */
     candidates: Corti.CodesGeneralReadResponse[];
-    usageInfo?: Corti.CommonUsageInfo;
+    usageInfo: Corti.CommonUsageInfo;
 }

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

@@ -3,5 +3,14 @@ export declare const CommonCodingSystemEnum: {
     readonly Icd10CmOutpatient: "icd10cm-outpatient";
     readonly Icd10Pcs: "icd10pcs";
     readonly Cpt: "cpt";
+    readonly Icd10IntInpatient: "icd10int-inpatient";
+    readonly Icd10IntOutpatient: "icd10int-outpatient";
+    readonly Icd10UkInpatient: "icd10uk-inpatient";
+    readonly Icd10UkOutpatient: "icd10uk-outpatient";
+    readonly Cim10FrInpatient: "cim10fr-inpatient";
+    readonly Cim10FrOutpatient: "cim10fr-outpatient";
+    readonly Icd10GmInpatient: "icd10gm-inpatient";
+    readonly Icd10GmOutpatient: "icd10gm-outpatient";
+    readonly Opcs4: "opcs4";
 };
 export type CommonCodingSystemEnum = (typeof CommonCodingSystemEnum)[keyof typeof CommonCodingSystemEnum];

package/dist/cjs/api/types/CommonCodingSystemEnum.js

@@ -7,4 +7,13 @@ exports.CommonCodingSystemEnum = {
     Icd10CmOutpatient: "icd10cm-outpatient",
     Icd10Pcs: "icd10pcs",
     Cpt: "cpt",
+    Icd10IntInpatient: "icd10int-inpatient",
+    Icd10IntOutpatient: "icd10int-outpatient",
+    Icd10UkInpatient: "icd10uk-inpatient",
+    Icd10UkOutpatient: "icd10uk-outpatient",
+    Cim10FrInpatient: "cim10fr-inpatient",
+    Cim10FrOutpatient: "cim10fr-outpatient",
+    Icd10GmInpatient: "icd10gm-inpatient",
+    Icd10GmOutpatient: "icd10gm-outpatient",
+    Opcs4: "opcs4",
 };

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

@@ -2,4 +2,6 @@ import type * as Corti from "../index.js";
 export interface StreamConfig {
     transcription: Corti.StreamConfigTranscription;
     mode: Corti.StreamConfigMode;
+    /** Optional parameter to specify data retention policy for the generated transcripts and facts. Use value 'none' to indicate data should not be stored in the database. Use value 'retain' to indicate that the data should be retained according to standard retention policies. If configuration is not provided, then the default retention policy will apply. */
+    xCortiRetentionPolicy?: Corti.StreamConfigXCortiRetentionPolicy;
 }

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

@@ -5,6 +5,5 @@ export declare const StreamConfigStatusMessageType: {
     readonly ConfigMissing: "CONFIG_MISSING";
     readonly ConfigNotProvided: "CONFIG_NOT_PROVIDED";
     readonly ConfigAlreadyReceived: "CONFIG_ALREADY_RECEIVED";
-    readonly ConfigTimeout: "CONFIG_TIMEOUT";
 };
 export type StreamConfigStatusMessageType = (typeof StreamConfigStatusMessageType)[keyof typeof StreamConfigStatusMessageType];

package/dist/cjs/api/types/StreamConfigStatusMessageType.js

@@ -9,5 +9,4 @@ exports.StreamConfigStatusMessageType = {
     ConfigMissing: "CONFIG_MISSING",
     ConfigNotProvided: "CONFIG_NOT_PROVIDED",
     ConfigAlreadyReceived: "CONFIG_ALREADY_RECEIVED",
-    ConfigTimeout: "CONFIG_TIMEOUT",
 };

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

@@ -0,0 +1,6 @@
+/** Optional parameter to specify data retention policy for the generated transcripts and facts. Use value 'none' to indicate data should not be stored in the database. Use value 'retain' to indicate that the data should be retained according to standard retention policies. If configuration is not provided, then the default retention policy will apply. */
+export declare const StreamConfigXCortiRetentionPolicy: {
+    readonly Retain: "retain";
+    readonly None: "none";
+};
+export type StreamConfigXCortiRetentionPolicy = (typeof StreamConfigXCortiRetentionPolicy)[keyof typeof StreamConfigXCortiRetentionPolicy];

package/dist/cjs/api/types/StreamConfigXCortiRetentionPolicy.js

@@ -0,0 +1,9 @@
+"use strict";
+// This file was auto-generated by Fern from our API Definition.
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.StreamConfigXCortiRetentionPolicy = void 0;
+/** Optional parameter to specify data retention policy for the generated transcripts and facts. Use value 'none' to indicate data should not be stored in the database. Use value 'retain' to indicate that the data should be retained according to standard retention policies. If configuration is not provided, then the default retention policy will apply. */
+exports.StreamConfigXCortiRetentionPolicy = {
+    Retain: "retain",
+    None: "none",
+};

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

@@ -0,0 +1,5 @@
+export interface StreamDeltaUsageMessage {
+    type: "delta_usage";
+    /** Approximate credits consumed since recording started. */
+    credits: number;
+}

package/dist/cjs/api/types/StreamDeltaUsageMessage.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/types/TranscribeConfigStatusMessageType.d.ts

@@ -3,5 +3,7 @@ export declare const TranscribeConfigStatusMessageType: {
     readonly ConfigAccepted: "CONFIG_ACCEPTED";
     readonly ConfigDenied: "CONFIG_DENIED";
     readonly ConfigTimeout: "CONFIG_TIMEOUT";
+    readonly ConfigAlreadyReceived: "CONFIG_ALREADY_RECEIVED";
+    readonly ConfigMissing: "CONFIG_MISSING";
 };
 export type TranscribeConfigStatusMessageType = (typeof TranscribeConfigStatusMessageType)[keyof typeof TranscribeConfigStatusMessageType];

package/dist/cjs/api/types/TranscribeConfigStatusMessageType.js

@@ -7,4 +7,6 @@ exports.TranscribeConfigStatusMessageType = {
     ConfigAccepted: "CONFIG_ACCEPTED",
     ConfigDenied: "CONFIG_DENIED",
     ConfigTimeout: "CONFIG_TIMEOUT",
+    ConfigAlreadyReceived: "CONFIG_ALREADY_RECEIVED",
+    ConfigMissing: "CONFIG_MISSING",
 };

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

@@ -0,0 +1,5 @@
+export interface TranscribeDeltaUsageMessage {
+    type: "delta_usage";
+    /** Approximate credits consumed since recording started. */
+    credits: number;
+}

package/dist/cjs/api/types/TranscribeDeltaUsageMessage.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/types/index.d.ts

@@ -135,6 +135,8 @@ export * from "./StreamConfigParticipantRole.js";
 export * from "./StreamConfigStatusMessage.js";
 export * from "./StreamConfigStatusMessageType.js";
 export * from "./StreamConfigTranscription.js";
+export * from "./StreamConfigXCortiRetentionPolicy.js";
+export * from "./StreamDeltaUsageMessage.js";
 export * from "./StreamEndedMessage.js";
 export * from "./StreamEndMessage.js";
 export * from "./StreamErrorDetail.js";
@@ -167,6 +169,7 @@ export * from "./TranscribeConfig.js";
 export * from "./TranscribeConfigMessage.js";
 export * from "./TranscribeConfigStatusMessage.js";
 export * from "./TranscribeConfigStatusMessageType.js";
+export * from "./TranscribeDeltaUsageMessage.js";
 export * from "./TranscribeEndedMessage.js";
 export * from "./TranscribeEndMessage.js";
 export * from "./TranscribeErrorMessage.js";

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

@@ -151,6 +151,8 @@ __exportStar(require("./StreamConfigParticipantRole.js"), exports);
 __exportStar(require("./StreamConfigStatusMessage.js"), exports);
 __exportStar(require("./StreamConfigStatusMessageType.js"), exports);
 __exportStar(require("./StreamConfigTranscription.js"), exports);
+__exportStar(require("./StreamConfigXCortiRetentionPolicy.js"), exports);
+__exportStar(require("./StreamDeltaUsageMessage.js"), exports);
 __exportStar(require("./StreamEndedMessage.js"), exports);
 __exportStar(require("./StreamEndMessage.js"), exports);
 __exportStar(require("./StreamErrorDetail.js"), exports);
@@ -183,6 +185,7 @@ __exportStar(require("./TranscribeConfig.js"), exports);
 __exportStar(require("./TranscribeConfigMessage.js"), exports);
 __exportStar(require("./TranscribeConfigStatusMessage.js"), exports);
 __exportStar(require("./TranscribeConfigStatusMessageType.js"), exports);
+__exportStar(require("./TranscribeDeltaUsageMessage.js"), exports);
 __exportStar(require("./TranscribeEndedMessage.js"), exports);
 __exportStar(require("./TranscribeEndMessage.js"), exports);
 __exportStar(require("./TranscribeErrorMessage.js"), exports);

package/dist/cjs/custom/CortiClient.d.ts

@@ -1,25 +1,10 @@
-import type { OAuthAuthProvider } from "../auth/OAuthAuthProvider.js";
 import { CortiClient as BaseCortiClient } from "../Client.js";
 import type * as environments from "../environments.js";
+import { CustomAgents } from "./agents/CustomAgents.js";
 import { CortiAuth } from "./auth/CortiAuth.js";
 import { CustomStream } from "./stream/CustomStream.js";
 import { CustomTranscribe } from "./transcribe/CustomTranscribe.js";
 import { type Environment } from "./utils/environment.js";
-type TokenDerivableAuth = {
-    accessToken: string;
-    refreshAccessToken?: OAuthAuthProvider.RefreshAccessTokenFunction;
-    expiresIn?: number;
-    refreshToken?: string;
-    refreshExpiresIn?: number;
-    clientId?: string;
-} | {
-    refreshAccessToken: OAuthAuthProvider.RefreshAccessTokenFunction;
-    accessToken?: string;
-    expiresIn?: number;
-    refreshToken?: string;
-    refreshExpiresIn?: number;
-    clientId?: string;
-};
 type OptionsBase = Omit<BaseCortiClient.Options, "clientId" | "clientSecret" | "token" | "environment" | "tenantName" | "baseUrl"> & {
     withCredentials?: boolean;
     /**
@@ -30,71 +15,23 @@ type OptionsBase = Omit<BaseCortiClient.Options, "clientId" | "clientSecret" | "
     encodeHeadersAsWsProtocols?: boolean;
 };
 export declare namespace CortiClient {
-    type Auth = {
-        clientId: string;
-        clientSecret: string;
-    } | {
-        accessToken: string;
-        refreshAccessToken?: OAuthAuthProvider.RefreshAccessTokenFunction;
-        expiresIn?: number;
-        refreshToken?: string;
-        refreshExpiresIn?: number;
-        clientId?: string;
-    } | {
-        clientId: string;
-        username: string;
-        password: string;
-    } | {
-        clientId: string;
-        clientSecret: string;
-        code: string;
-        redirectUri: string;
-    } | {
-        clientId: string;
-        code: string;
-        redirectUri: string;
-        codeVerifier?: string;
-    } | {
-        refreshAccessToken: OAuthAuthProvider.RefreshAccessTokenFunction;
-        accessToken?: string;
-        expiresIn?: number;
-        refreshToken?: string;
-        refreshExpiresIn?: number;
-        clientId?: string;
-    };
+    type Auth = CortiAuth.AuthServer | CortiAuth.AuthTokenDerivable;
     type Options = (OptionsBase & {
-        auth: {
-            clientId: string;
-            clientSecret: string;
-        } | {
-            clientId: string;
-            username: string;
-            password: string;
-        } | {
-            clientId: string;
-            clientSecret: string;
-            code: string;
-            redirectUri: string;
-        } | {
-            clientId: string;
-            code: string;
-            redirectUri: string;
-            codeVerifier?: string;
-        };
+        auth: CortiAuth.AuthServer;
         tenantName: string;
         environment: Environment;
     }) | (OptionsBase & {
-        auth: TokenDerivableAuth;
+        auth: CortiAuth.AuthTokenDerivable;
         tenantName?: string;
         environment?: Environment;
     }) | (OptionsBase & {
         baseUrl: string;
-        auth?: CortiClient.Auth;
+        auth?: Auth;
         tenantName?: string;
         environment?: Environment;
     }) | (OptionsBase & {
         environment: environments.CortiEnvironmentUrls;
-        auth?: CortiClient.Auth;
+        auth?: Auth;
         tenantName?: string;
     });
     interface RequestOptions extends BaseCortiClient.RequestOptions {
@@ -104,10 +41,29 @@ export declare class CortiClient extends BaseCortiClient {
     protected _auth: CortiAuth | undefined;
     protected _stream: CustomStream | undefined;
     protected _transcribe: CustomTranscribe | undefined;
+    protected _agents: CustomAgents | undefined;
     private readonly _encodeHeadersAsWsProtocols;
     constructor(options: CortiClient.Options);
     get auth(): CortiAuth;
     get stream(): CustomStream;
     get transcribe(): CustomTranscribe;
+    get agents(): CustomAgents;
+    /**
+     * Retrieves authentication headers for API requests.
+     *
+     * This method returns a Headers object containing the Authorization header with a valid
+     * bearer token and the Tenant-Name header. The token is automatically refreshed if needed.
+     *
+     * @returns A Promise that resolves to a Headers object with Authorization and Tenant-Name headers
+     *
+     * @example
+     * ```typescript
+     * const client = new CortiClient({ ... });
+     * const headers = await client.getAuthHeaders();
+     * console.log(headers.get("Authorization")); // "Bearer ..."
+     * console.log(headers.get("Tenant-Name")); // "your-tenant"
+     * ```
+     */
+    getAuthHeaders: () => Promise<Headers>;
 }
 export {};

package/dist/cjs/custom/CortiClient.js

@@ -1,20 +1,85 @@
 "use strict";
+var __createBinding = (this && this.__createBinding) || (Object.create ? (function(o, m, k, k2) {
+    if (k2 === undefined) k2 = k;
+    var desc = Object.getOwnPropertyDescriptor(m, k);
+    if (!desc || ("get" in desc ? !m.__esModule : desc.writable || desc.configurable)) {
+      desc = { enumerable: true, get: function() { return m[k]; } };
+    }
+    Object.defineProperty(o, k2, desc);
+}) : (function(o, m, k, k2) {
+    if (k2 === undefined) k2 = k;
+    o[k2] = m[k];
+}));
+var __setModuleDefault = (this && this.__setModuleDefault) || (Object.create ? (function(o, v) {
+    Object.defineProperty(o, "default", { enumerable: true, value: v });
+}) : function(o, v) {
+    o["default"] = v;
+});
+var __importStar = (this && this.__importStar) || (function () {
+    var ownKeys = function(o) {
+        ownKeys = Object.getOwnPropertyNames || function (o) {
+            var ar = [];
+            for (var k in o) if (Object.prototype.hasOwnProperty.call(o, k)) ar[ar.length] = k;
+            return ar;
+        };
+        return ownKeys(o);
+    };
+    return function (mod) {
+        if (mod && mod.__esModule) return mod;
+        var result = {};
+        if (mod != null) for (var k = ownKeys(mod), i = 0; i < k.length; i++) if (k[i] !== "default") __createBinding(result, mod, k[i]);
+        __setModuleDefault(result, mod);
+        return result;
+    };
+})();
+var __awaiter = (this && this.__awaiter) || function (thisArg, _arguments, P, generator) {
+    function adopt(value) { return value instanceof P ? value : new P(function (resolve) { resolve(value); }); }
+    return new (P || (P = Promise))(function (resolve, reject) {
+        function fulfilled(value) { try { step(generator.next(value)); } catch (e) { reject(e); } }
+        function rejected(value) { try { step(generator["throw"](value)); } catch (e) { reject(e); } }
+        function step(result) { result.done ? resolve(result.value) : adopt(result.value).then(fulfilled, rejected); }
+        step((generator = generator.apply(thisArg, _arguments || [])).next());
+    });
+};
 Object.defineProperty(exports, "__esModule", { value: true });
 exports.CortiClient = void 0;
 const Client_js_1 = require("../Client.js");
+const core = __importStar(require("../core/index.js"));
+const CustomAgents_js_1 = require("./agents/CustomAgents.js");
 const CortiAuth_js_1 = require("./auth/CortiAuth.js");
 const CustomStream_js_1 = require("./stream/CustomStream.js");
 const CustomTranscribe_js_1 = require("./transcribe/CustomTranscribe.js");
 const authToBaseOptions_js_1 = require("./utils/authToBaseOptions.js");
-const withCredentialsConfig_js_1 = require("./utils/withCredentialsConfig.js");
 const environment_js_1 = require("./utils/environment.js");
 const resolveClientOptions_js_1 = require("./utils/resolveClientOptions.js");
+const withCredentialsConfig_js_1 = require("./utils/withCredentialsConfig.js");
 class CortiClient extends Client_js_1.CortiClient {
     constructor(options) {
         const opts = options;
         const ctx = (0, resolveClientOptions_js_1.resolveClientOptions)(options);
         const restOptions = Object.assign(Object.assign(Object.assign({}, opts), { tenantName: ctx.tenantName, environment: (0, environment_js_1.getEnvironment)(ctx.environment) }), (ctx.initialTokenResponse != null ? { initialTokenResponse: ctx.initialTokenResponse } : {}));
         super((0, authToBaseOptions_js_1.authToBaseOptions)(opts.auth, restOptions));
+        /**
+         * Retrieves authentication headers for API requests.
+         *
+         * This method returns a Headers object containing the Authorization header with a valid
+         * bearer token and the Tenant-Name header. The token is automatically refreshed if needed.
+         *
+         * @returns A Promise that resolves to a Headers object with Authorization and Tenant-Name headers
+         *
+         * @example
+         * ```typescript
+         * const client = new CortiClient({ ... });
+         * const headers = await client.getAuthHeaders();
+         * console.log(headers.get("Authorization")); // "Bearer ..."
+         * console.log(headers.get("Tenant-Name")); // "your-tenant"
+         * ```
+         */
+        this.getAuthHeaders = () => __awaiter(this, void 0, void 0, function* () {
+            var _a;
+            const req = yield this._options.authProvider.getAuthRequest();
+            return new Headers(Object.assign(Object.assign({}, ((_a = req.headers) !== null && _a !== void 0 ? _a : {})), { "Tenant-Name": yield core.Supplier.get(this._options.tenantName) }));
+        });
         (0, withCredentialsConfig_js_1.setDefaultWithCredentials)(options.withCredentials);
         this._encodeHeadersAsWsProtocols = options.encodeHeadersAsWsProtocols;
     }
@@ -30,5 +95,9 @@ class CortiClient extends Client_js_1.CortiClient {
         var _a;
         return ((_a = this._transcribe) !== null && _a !== void 0 ? _a : (this._transcribe = new CustomTranscribe_js_1.CustomTranscribe(Object.assign(Object.assign({}, this._options), { encodeHeadersAsWsProtocols: this._encodeHeadersAsWsProtocols }))));
     }
+    get agents() {
+        var _a;
+        return ((_a = this._agents) !== null && _a !== void 0 ? _a : (this._agents = new CustomAgents_js_1.CustomAgents(this._options)));
+    }
 }
 exports.CortiClient = CortiClient;

package/dist/cjs/custom/agents/CustomAgents.d.ts

@@ -0,0 +1,20 @@
+/**
+ * This file is the custom implementation of the Agents client (src/api/resources/agents/client/Client.ts)
+ *
+ * It extends the auto-generated Agents class and adds custom helper methods.
+ *
+ * All the patches marked with `// Patch: ...` comments.
+ */
+import { AgentsClient } from "../../api/resources/agents/client/Client.js";
+export declare class CustomAgents extends AgentsClient {
+    /**
+     * Returns the URL for the agent card JSON file.
+     *
+     * @param {string} agentId - The ID of the agent
+     * @returns {Promise<URL>} A Promise that resolves to the URL for the agent card
+     *
+     * @example
+     *     const url = await client.agents.getAgentCardUrl("agent-123");
+     */
+    getCardUrl: (agentId: string) => Promise<URL>;
+}

package/dist/cjs/custom/agents/CustomAgents.js

@@ -0,0 +1,73 @@
+"use strict";
+/**
+ * This file is the custom implementation of the Agents client (src/api/resources/agents/client/Client.ts)
+ *
+ * It extends the auto-generated Agents class and adds custom helper methods.
+ *
+ * All the patches marked with `// Patch: ...` comments.
+ */
+var __createBinding = (this && this.__createBinding) || (Object.create ? (function(o, m, k, k2) {
+    if (k2 === undefined) k2 = k;
+    var desc = Object.getOwnPropertyDescriptor(m, k);
+    if (!desc || ("get" in desc ? !m.__esModule : desc.writable || desc.configurable)) {
+      desc = { enumerable: true, get: function() { return m[k]; } };
+    }
+    Object.defineProperty(o, k2, desc);
+}) : (function(o, m, k, k2) {
+    if (k2 === undefined) k2 = k;
+    o[k2] = m[k];
+}));
+var __setModuleDefault = (this && this.__setModuleDefault) || (Object.create ? (function(o, v) {
+    Object.defineProperty(o, "default", { enumerable: true, value: v });
+}) : function(o, v) {
+    o["default"] = v;
+});
+var __importStar = (this && this.__importStar) || (function () {
+    var ownKeys = function(o) {
+        ownKeys = Object.getOwnPropertyNames || function (o) {
+            var ar = [];
+            for (var k in o) if (Object.prototype.hasOwnProperty.call(o, k)) ar[ar.length] = k;
+            return ar;
+        };
+        return ownKeys(o);
+    };
+    return function (mod) {
+        if (mod && mod.__esModule) return mod;
+        var result = {};
+        if (mod != null) for (var k = ownKeys(mod), i = 0; i < k.length; i++) if (k[i] !== "default") __createBinding(result, mod, k[i]);
+        __setModuleDefault(result, mod);
+        return result;
+    };
+})();
+var __awaiter = (this && this.__awaiter) || function (thisArg, _arguments, P, generator) {
+    function adopt(value) { return value instanceof P ? value : new P(function (resolve) { resolve(value); }); }
+    return new (P || (P = Promise))(function (resolve, reject) {
+        function fulfilled(value) { try { step(generator.next(value)); } catch (e) { reject(e); } }
+        function rejected(value) { try { step(generator["throw"](value)); } catch (e) { reject(e); } }
+        function step(result) { result.done ? resolve(result.value) : adopt(result.value).then(fulfilled, rejected); }
+        step((generator = generator.apply(thisArg, _arguments || [])).next());
+    });
+};
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.CustomAgents = void 0;
+const Client_js_1 = require("../../api/resources/agents/client/Client.js");
+const core = __importStar(require("../../core/index.js"));
+class CustomAgents extends Client_js_1.AgentsClient {
+    constructor() {
+        super(...arguments);
+        /**
+         * Returns the URL for the agent card JSON file.
+         *
+         * @param {string} agentId - The ID of the agent
+         * @returns {Promise<URL>} A Promise that resolves to the URL for the agent card
+         *
+         * @example
+         *     const url = await client.agents.getAgentCardUrl("agent-123");
+         */
+        this.getCardUrl = (agentId) => __awaiter(this, void 0, void 0, function* () {
+            const encodedAgentId = encodeURIComponent(agentId);
+            return new URL(`/agents/${encodedAgentId}/agent-card.json`, (yield core.Supplier.get(this._options.environment)).agents);
+        });
+    }
+}
+exports.CustomAgents = CustomAgents;

package/dist/cjs/custom/auth/CortiAuth.d.ts

@@ -45,6 +45,32 @@ export declare namespace CortiAuth {
         codeVerifier?: string;
         scopes?: string[];
     }
+    /**
+     * Auth shapes used by `CortiClient` when passing `auth: ...`.
+     */
+    type AuthClientCredentials = {
+        clientId: string;
+        clientSecret: string;
+    };
+    type AuthRopc = Omit<GetRopcFlowTokenRequest, "scopes">;
+    type AuthCode = Omit<GetCodeFlowTokenRequest, "scopes">;
+    type AuthPkce = Omit<GetPkceFlowTokenRequest, "scopes">;
+    type AuthTokenDerivable = {
+        accessToken: string;
+        refreshAccessToken?: OAuthAuthProvider.RefreshAccessTokenFunction;
+        expiresIn?: number;
+        refreshToken?: string;
+        refreshExpiresIn?: number;
+        clientId?: string;
+    } | {
+        refreshAccessToken: OAuthAuthProvider.RefreshAccessTokenFunction;
+        accessToken?: string;
+        expiresIn?: number;
+        refreshToken?: string;
+        refreshExpiresIn?: number;
+        clientId?: string;
+    };
+    type AuthServer = AuthClientCredentials | AuthRopc | AuthCode | AuthPkce;
     /** Parameters for authorizeURL — builds the Keycloak authorization endpoint URL. */
     interface AuthorizationCodeClient {
         clientId: string;
@@ -61,6 +87,7 @@ export declare namespace CortiAuth {
     }
 }
 export declare class CortiAuth extends AuthClient {
+    private readonly _tenantName;
     /** No-op auth provider so super.token() does not trigger OAuth refresh. When auth is omitted, a dummy token is passed so the base constructor does not throw. */
     constructor(options: CortiAuth.Options);
     /**