@corti/sdk 0.0.0-alpha.10 → 0.0.0-rc

package/README.md

@@ -1,26 +1,22 @@
-# Corti TypeScript Library
+# Corti JavaScript SDK
 
-[![fern shield](https://img.shields.io/badge/%F0%9F%8C%BF-Built%20with%20Fern-brightgreen)](https://buildwithfern.com?utm_source=github&utm_medium=github&utm_campaign=readme&utm_source=https%3A%2F%2Fgithub.com%2Fcorticph%2Fcorti-sdk-typescript)
+[![fern shield](https://img.shields.io/badge/%F0%9F%8C%BF-Built%20with%20Fern-brightgreen)](https://buildwithfern.com?utm_source=github&utm_medium=github&utm_campaign=readme&utm_source=https%3A%2F%2Fgithub.com%2Fcorticph%2Fcorti-sdk-javascript)
 [![npm shield](https://img.shields.io/npm/v/@corti/sdk)](https://www.npmjs.com/package/@corti/sdk)
 
-> [!WARNING]
-> This is an **alpha version** of the Corti TypeScript SDK library. As such, there will be breaking changes in future releases as we work toward our beta version. Additionally, types might not always match the actual API reality, and some features may be missing or incomplete. We're actively working to improve the library and would greatly appreciate any feedback if you encounter any inconsistencies or issues 💚
+> This is a **Beta version** of the Corti JavaScript SDK. We are treating it as stable for production use, but
+> there may still be breaking changes before we reach version 1.0. We're actively working to improve the SDK and would greatly
+> appreciate any feedback if you encounter any inconsistencies or issues 💚
 
-The Corti TypeScript library provides convenient access to the Corti API from TypeScript.
+The Corti JavaScript SDK provides convenient access to the Corti API from JavaScript.
 
 ## Installation
 
-> [!NOTE]
-> You must install the alpha version as the latest version is essentially empty. Use the command below to get the functional SDK.
-
 ```sh
-npm i -s @corti/sdk@alpha
+npm i -s @corti/sdk
 ```
 
 ## Reference
 
-A full reference for this library is available [here](REFERENCE-latest.md).
-
 For detailed authentication instructions, see the [Authentication Guide](./AUTHENTICATION.md).
 
 ## Usage
@@ -32,7 +28,7 @@ import { CortiEnvironment, CortiClient } from "@corti/sdk";
 
 // Using client credentials (OAuth2)
 const client = new CortiClient({
-    environment: CortiEnvironment.BetaEu,
+    environment: CortiEnvironment.Eu,
     tenantName: "YOUR_TENANT_NAME",
     auth: {
         clientId: "YOUR_CLIENT_ID",
@@ -42,14 +38,31 @@ const client = new CortiClient({
 
 // Or using a bearer token
 const client = new CortiClient({
-    environment: CortiEnvironment.BetaEu,
+    environment: CortiEnvironment.Eu,
     tenantName: "YOUR_TENANT_NAME",
     auth: {
-        access_token: "YOUR_ACCESS_TOKEN",
+        accessToken: "YOUR_ACCESS_TOKEN",
         // Optional: refresh token for automatic token refresh
-        refresh_token: "YOUR_REFRESH_TOKEN",
-        expires_in: 3600,
-        refresh_expires_in: 86400,
+        refreshToken: "YOUR_REFRESH_TOKEN",
+        expiresIn: 3600,
+        refreshExpiresIn: 86400,
+    },
+});
+
+// Or using just a refresh function (no initial access token needed)
+const client = new CortiClient({
+    environment: CortiEnvironment.Eu,
+    tenantName: "YOUR_TENANT_NAME",
+    auth: {
+        refreshAccessToken: async (refreshToken?: string) => {
+            // Your custom logic to get a new access token
+            const response = await fetch("https://your-auth-server/refresh", {
+                method: "POST", 
+                headers: { "Content-Type": "application/json" },
+                body: JSON.stringify({ refreshToken: refreshToken }),
+            });
+            return response.json();
+        },
     },
 });
 
@@ -80,21 +93,35 @@ const request: Corti.InteractionsListRequest = {
 
 ## Exception Handling
 
-When the API returns a non-success status code (4xx or 5xx response), a subclass of the following error
-will be thrown.
+Depending on the type of error, the SDK will throw one of the following:
+
+- **CortiError**: Thrown when the API returns a non-success status code (4xx or 5xx response). This is the base error for API-related issues.
+- **ParseError**: Thrown when parsing input data fails schema validation. This typically occurs when the data you provide does not match the expected schema.
+- **JsonError**: Thrown when serializing data to JSON fails schema validation. This typically occurs when converting parsed data to JSON for transmission or storage fails validation.
+
+Example usage:
 
 ```typescript
-import { CortiError } from "@corti/sdk";
+import { CortiError, ParseError, JsonError } from "@corti/sdk";
 
 try {
     await client.interactions.create(...);
 } catch (err) {
     if (err instanceof CortiError) {
+        // Handle API errors
         console.log(err.statusCode);
         console.log(err.message);
         console.log(err.body);
         console.log(err.rawResponse);
     }
+    if (err instanceof ParseError) {
+        // Handle schema validation errors during parsing
+        console.error("Parse validation error details:", err.errors);
+    }
+    if (err instanceof JsonError) {
+        // Handle schema validation errors during serialization
+        console.error("JSON validation error details:", err.errors);
+    }
 }
 ```
 
@@ -106,7 +133,7 @@ List endpoints are paginated. The SDK provides an iterator so that you can simpl
 import { CortiEnvironment, CortiClient } from "@corti/sdk";
 
 const client = new CortiClient({
-    environment: CortiEnvironment.BetaEu,
+    environment: CortiEnvironment.Eu,
     tenantName: "YOUR_TENANT_NAME",
     auth: {
         clientId: "YOUR_CLIENT_ID",
@@ -222,8 +249,8 @@ const client = new CortiClient({
 
 ## Contributing
 
-While we value open-source contributions to this SDK, this library is generated programmatically.
-Additions made directly to this library would have to be moved over to our generation code,
+While we value open-source contributions to this SDK, this repo is (mostly) generated programmatically.
+Additions made directly to this code would have to be moved over to our generation code,
 otherwise they would be overwritten upon the next generated release. Feel free to open a PR as
 a proof of concept, but know that we will not be able to merge it as-is. We suggest opening
 an issue first to discuss with us!

package/dist/cjs/Client.d.ts

@@ -0,0 +1,65 @@
+/**
+ * This file was auto-generated by Fern from our API Definition.
+ */
+import * as environments from "./environments.js";
+import * as core from "./core/index.js";
+import { Auth } from "./api/resources/auth/client/Client.js";
+import { Interactions } from "./api/resources/interactions/client/Client.js";
+import { Recordings } from "./api/resources/recordings/client/Client.js";
+import { Transcripts } from "./api/resources/transcripts/client/Client.js";
+import { Facts } from "./api/resources/facts/client/Client.js";
+import { Documents } from "./api/resources/documents/client/Client.js";
+import { Templates } from "./api/resources/templates/client/Client.js";
+import { Agents } from "./api/resources/agents/client/Client.js";
+import { Stream } from "./api/resources/stream/client/Client.js";
+import { Transcribe } from "./api/resources/transcribe/client/Client.js";
+export declare namespace CortiClient {
+    interface Options {
+        environment: core.Supplier<environments.CortiEnvironment | environments.CortiEnvironmentUrls>;
+        /** Specify a custom URL to connect the client to. */
+        baseUrl?: core.Supplier<string>;
+        clientId: core.Supplier<string>;
+        clientSecret: core.Supplier<string>;
+        /** Override the Tenant-Name header */
+        tenantName: core.Supplier<string>;
+        /** Additional headers to include in requests. */
+        headers?: Record<string, string | core.Supplier<string | undefined> | undefined>;
+    }
+    interface RequestOptions {
+        /** The maximum time to wait for a response in seconds. */
+        timeoutInSeconds?: number;
+        /** The number of times to retry the request. Defaults to 2. */
+        maxRetries?: number;
+        /** A hook to abort the request. */
+        abortSignal?: AbortSignal;
+        /** Override the Tenant-Name header */
+        tenantName?: string;
+        /** Additional headers to include in the request. */
+        headers?: Record<string, string | core.Supplier<string | undefined> | undefined>;
+    }
+}
+export declare class CortiClient {
+    protected readonly _options: CortiClient.Options;
+    private readonly _oauthTokenProvider;
+    protected _interactions: Interactions | undefined;
+    protected _recordings: Recordings | undefined;
+    protected _transcripts: Transcripts | undefined;
+    protected _facts: Facts | undefined;
+    protected _documents: Documents | undefined;
+    protected _templates: Templates | undefined;
+    protected _auth: Auth | undefined;
+    protected _agents: Agents | undefined;
+    protected _stream: Stream | undefined;
+    protected _transcribe: Transcribe | undefined;
+    constructor(_options: CortiClient.Options);
+    get interactions(): Interactions;
+    get recordings(): Recordings;
+    get transcripts(): Transcripts;
+    get facts(): Facts;
+    get documents(): Documents;
+    get templates(): Templates;
+    get auth(): Auth;
+    get agents(): Agents;
+    get stream(): Stream;
+    get transcribe(): Transcribe;
+}

package/dist/cjs/Client.js

@@ -0,0 +1,119 @@
+"use strict";
+/**
+ * This file was auto-generated by Fern from our API Definition.
+ */
+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 core = __importStar(require("./core/index.js"));
+const Client_js_1 = require("./api/resources/auth/client/Client.js");
+const headers_js_1 = require("./core/headers.js");
+const Client_js_2 = require("./api/resources/interactions/client/Client.js");
+const Client_js_3 = require("./api/resources/recordings/client/Client.js");
+const Client_js_4 = require("./api/resources/transcripts/client/Client.js");
+const Client_js_5 = require("./api/resources/facts/client/Client.js");
+const Client_js_6 = require("./api/resources/documents/client/Client.js");
+const Client_js_7 = require("./api/resources/templates/client/Client.js");
+const Client_js_8 = require("./api/resources/agents/client/Client.js");
+const Client_js_9 = require("./api/resources/stream/client/Client.js");
+const Client_js_10 = require("./api/resources/transcribe/client/Client.js");
+class CortiClient {
+    constructor(_options) {
+        this._options = Object.assign(Object.assign({}, _options), { headers: (0, headers_js_1.mergeHeaders)({
+                "Tenant-Name": _options === null || _options === void 0 ? void 0 : _options.tenantName,
+                "X-Fern-Language": "JavaScript",
+                "X-Fern-SDK-Name": "@corti/sdk",
+                "X-Fern-SDK-Version": "0.0.0-rc",
+                "User-Agent": "@corti/sdk/0.0.0-rc",
+                "X-Fern-Runtime": core.RUNTIME.type,
+                "X-Fern-Runtime-Version": core.RUNTIME.version,
+            }, _options === null || _options === void 0 ? void 0 : _options.headers) });
+        this._oauthTokenProvider = new core.OAuthTokenProvider({
+            clientId: this._options.clientId,
+            clientSecret: this._options.clientSecret,
+            authClient: new Client_js_1.Auth(Object.assign(Object.assign({}, this._options), { environment: this._options.environment })),
+        });
+    }
+    get interactions() {
+        var _a;
+        return ((_a = this._interactions) !== null && _a !== void 0 ? _a : (this._interactions = new Client_js_2.Interactions(Object.assign(Object.assign({}, this._options), { token: () => __awaiter(this, void 0, void 0, function* () { return yield this._oauthTokenProvider.getToken(); }) }))));
+    }
+    get recordings() {
+        var _a;
+        return ((_a = this._recordings) !== null && _a !== void 0 ? _a : (this._recordings = new Client_js_3.Recordings(Object.assign(Object.assign({}, this._options), { token: () => __awaiter(this, void 0, void 0, function* () { return yield this._oauthTokenProvider.getToken(); }) }))));
+    }
+    get transcripts() {
+        var _a;
+        return ((_a = this._transcripts) !== null && _a !== void 0 ? _a : (this._transcripts = new Client_js_4.Transcripts(Object.assign(Object.assign({}, this._options), { token: () => __awaiter(this, void 0, void 0, function* () { return yield this._oauthTokenProvider.getToken(); }) }))));
+    }
+    get facts() {
+        var _a;
+        return ((_a = this._facts) !== null && _a !== void 0 ? _a : (this._facts = new Client_js_5.Facts(Object.assign(Object.assign({}, this._options), { token: () => __awaiter(this, void 0, void 0, function* () { return yield this._oauthTokenProvider.getToken(); }) }))));
+    }
+    get documents() {
+        var _a;
+        return ((_a = this._documents) !== null && _a !== void 0 ? _a : (this._documents = new Client_js_6.Documents(Object.assign(Object.assign({}, this._options), { token: () => __awaiter(this, void 0, void 0, function* () { return yield this._oauthTokenProvider.getToken(); }) }))));
+    }
+    get templates() {
+        var _a;
+        return ((_a = this._templates) !== null && _a !== void 0 ? _a : (this._templates = new Client_js_7.Templates(Object.assign(Object.assign({}, this._options), { token: () => __awaiter(this, void 0, void 0, function* () { return yield this._oauthTokenProvider.getToken(); }) }))));
+    }
+    get auth() {
+        var _a;
+        return ((_a = this._auth) !== null && _a !== void 0 ? _a : (this._auth = new Client_js_1.Auth(Object.assign(Object.assign({}, this._options), { token: () => __awaiter(this, void 0, void 0, function* () { return yield this._oauthTokenProvider.getToken(); }) }))));
+    }
+    get agents() {
+        var _a;
+        return ((_a = this._agents) !== null && _a !== void 0 ? _a : (this._agents = new Client_js_8.Agents(Object.assign(Object.assign({}, this._options), { token: () => __awaiter(this, void 0, void 0, function* () { return yield this._oauthTokenProvider.getToken(); }) }))));
+    }
+    get stream() {
+        var _a;
+        return ((_a = this._stream) !== null && _a !== void 0 ? _a : (this._stream = new Client_js_9.Stream(Object.assign(Object.assign({}, this._options), { token: () => __awaiter(this, void 0, void 0, function* () { return yield this._oauthTokenProvider.getToken(); }) }))));
+    }
+    get transcribe() {
+        var _a;
+        return ((_a = this._transcribe) !== null && _a !== void 0 ? _a : (this._transcribe = new Client_js_10.Transcribe(Object.assign(Object.assign({}, this._options), { token: () => __awaiter(this, void 0, void 0, function* () { return yield this._oauthTokenProvider.getToken(); }) }))));
+    }
+}
+exports.CortiClient = CortiClient;

package/dist/cjs/api/errors/NotFoundError.d.ts

@@ -2,8 +2,7 @@
  * This file was auto-generated by Fern from our API Definition.
  */
 import * as errors from "../../errors/index.js";
-import * as Corti from "../index.js";
 import * as core from "../../core/index.js";
 export declare class NotFoundError extends errors.CortiError {
-    constructor(body: Corti.ErrorResponse, rawResponse?: core.RawResponse);
+    constructor(body?: unknown, rawResponse?: core.RawResponse);
 }

package/dist/cjs/api/index.d.ts

@@ -1,3 +1,7 @@
 export * from "./resources/index.js";
 export * from "./types/index.js";
 export * from "./errors/index.js";
+/**
+ * Patch: including custom types to main export of types
+ */
+export * from "../custom/index.js";

package/dist/cjs/api/index.js

@@ -17,3 +17,7 @@ Object.defineProperty(exports, "__esModule", { value: true });
 __exportStar(require("./resources/index.js"), exports);
 __exportStar(require("./types/index.js"), exports);
 __exportStar(require("./errors/index.js"), exports);
+/**
+ * Patch: including custom types to main export of types
+ */
+__exportStar(require("../custom/index.js"), exports);

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

@@ -0,0 +1,209 @@
+/**
+ * This file was auto-generated by Fern from our API Definition.
+ */
+import * as environments from "../../../../environments.js";
+import * as core from "../../../../core/index.js";
+import * as Corti from "../../../index.js";
+export declare namespace Agents {
+    interface Options {
+        environment: core.Supplier<environments.CortiEnvironment | environments.CortiEnvironmentUrls>;
+        /** Specify a custom URL to connect the client to. */
+        baseUrl?: core.Supplier<string>;
+        token?: core.Supplier<core.BearerToken | undefined>;
+        /** Override the Tenant-Name header */
+        tenantName: core.Supplier<string>;
+        /** Additional headers to include in requests. */
+        headers?: Record<string, string | core.Supplier<string | undefined> | undefined>;
+    }
+    interface RequestOptions {
+        /** The maximum time to wait for a response in seconds. */
+        timeoutInSeconds?: number;
+        /** The number of times to retry the request. Defaults to 2. */
+        maxRetries?: number;
+        /** A hook to abort the request. */
+        abortSignal?: AbortSignal;
+        /** Override the Tenant-Name header */
+        tenantName?: string;
+        /** Additional headers to include in the request. */
+        headers?: Record<string, string | core.Supplier<string | undefined> | undefined>;
+    }
+}
+export declare class Agents {
+    protected readonly _options: Agents.Options;
+    constructor(_options: Agents.Options);
+    /**
+     * This endpoint retrieves a list of all agents that can be called by the Corti Agent Framework.
+     *
+     * @param {Corti.AgentsListRequest} request
+     * @param {Agents.RequestOptions} requestOptions - Request-specific configuration.
+     *
+     * @throws {@link Corti.BadRequestError}
+     * @throws {@link Corti.UnauthorizedError}
+     *
+     * @example
+     *     await client.agents.list()
+     */
+    list(request?: Corti.AgentsListRequest, requestOptions?: Agents.RequestOptions): core.HttpResponsePromise<Corti.AgentsAgentResponse[]>;
+    private __list;
+    /**
+     * This endpoint allows the creation of a new agent that can be utilized in the `POST /agents/{id}/v1/message:send` endpoint.
+     *
+     * @param {Corti.AgentsCreateAgent} request
+     * @param {Agents.RequestOptions} requestOptions - Request-specific configuration.
+     *
+     * @throws {@link Corti.BadRequestError}
+     * @throws {@link Corti.UnauthorizedError}
+     *
+     * @example
+     *     await client.agents.create({
+     *         name: "name",
+     *         description: "description"
+     *     })
+     */
+    create(request: Corti.AgentsCreateAgent, requestOptions?: Agents.RequestOptions): core.HttpResponsePromise<Corti.AgentsAgent>;
+    private __create;
+    /**
+     * This endpoint retrieves an agent by its identifier. The agent contains information about its capabilities and the experts it can call.
+     *
+     * @param {string} id - The identifier of the agent associated with the context.
+     * @param {Agents.RequestOptions} requestOptions - Request-specific configuration.
+     *
+     * @throws {@link Corti.BadRequestError}
+     * @throws {@link Corti.UnauthorizedError}
+     * @throws {@link Corti.NotFoundError}
+     *
+     * @example
+     *     await client.agents.get("12345678-90ab-cdef-gh12-34567890abc")
+     */
+    get(id: string, requestOptions?: Agents.RequestOptions): core.HttpResponsePromise<Corti.AgentsAgentResponse>;
+    private __get;
+    /**
+     * This endpoint deletes an agent by its identifier. Once deleted, the agent can no longer be used in threads.
+     *
+     * @param {string} id - The identifier of the agent associated with the context.
+     * @param {Agents.RequestOptions} requestOptions - Request-specific configuration.
+     *
+     * @throws {@link Corti.BadRequestError}
+     * @throws {@link Corti.UnauthorizedError}
+     * @throws {@link Corti.NotFoundError}
+     *
+     * @example
+     *     await client.agents.delete("12345678-90ab-cdef-gh12-34567890abc")
+     */
+    delete(id: string, requestOptions?: Agents.RequestOptions): core.HttpResponsePromise<void>;
+    private __delete;
+    /**
+     * This endpoint updates an existing agent. Only the fields provided in the request body will be updated; other fields will remain unchanged.
+     *
+     * @param {string} id - The identifier of the agent associated with the context.
+     * @param {Corti.AgentsAgent} request
+     * @param {Agents.RequestOptions} requestOptions - Request-specific configuration.
+     *
+     * @throws {@link Corti.BadRequestError}
+     * @throws {@link Corti.UnauthorizedError}
+     * @throws {@link Corti.NotFoundError}
+     *
+     * @example
+     *     await client.agents.update("12345678-90ab-cdef-gh12-34567890abc", {
+     *         id: "id",
+     *         name: "name",
+     *         description: "description",
+     *         systemPrompt: "systemPrompt"
+     *     })
+     */
+    update(id: string, request: Corti.AgentsAgent, requestOptions?: Agents.RequestOptions): core.HttpResponsePromise<Corti.AgentsAgent>;
+    private __update;
+    /**
+     * This endpoint retrieves the agent card in JSON format, which provides metadata about the agent, including its name, description, and the experts it can call.
+     *
+     * @param {string} id - The identifier of the agent associated with the context.
+     * @param {Agents.RequestOptions} requestOptions - Request-specific configuration.
+     *
+     * @throws {@link Corti.BadRequestError}
+     * @throws {@link Corti.UnauthorizedError}
+     * @throws {@link Corti.NotFoundError}
+     *
+     * @example
+     *     await client.agents.getCard("12345678-90ab-cdef-gh12-34567890abc")
+     */
+    getCard(id: string, requestOptions?: Agents.RequestOptions): core.HttpResponsePromise<Corti.AgentsAgentCard>;
+    private __getCard;
+    /**
+     * This endpoint sends a message to the specified agent to start or continue a task. The agent processes the message and returns a response. If the message contains a task ID that matches an ongoing task, the agent will continue that task; otherwise, it will start a new task.
+     *
+     * @param {string} id - The identifier of the agent associated with the context.
+     * @param {Corti.AgentsMessageSendParams} request
+     * @param {Agents.RequestOptions} requestOptions - Request-specific configuration.
+     *
+     * @throws {@link Corti.BadRequestError}
+     * @throws {@link Corti.UnauthorizedError}
+     * @throws {@link Corti.NotFoundError}
+     *
+     * @example
+     *     await client.agents.messageSend("12345678-90ab-cdef-gh12-34567890abc", {
+     *         message: {
+     *             role: "user",
+     *             parts: [{
+     *                     kind: "text",
+     *                     text: "text"
+     *                 }],
+     *             messageId: "messageId",
+     *             kind: "message"
+     *         }
+     *     })
+     */
+    messageSend(id: string, request: Corti.AgentsMessageSendParams, requestOptions?: Agents.RequestOptions): core.HttpResponsePromise<Corti.AgentsMessageSendResponse>;
+    private __messageSend;
+    /**
+     * This endpoint retrieves the status and details of a specific task associated with the given agent. It provides information about the task's current state, history, and any artifacts produced during its execution.
+     *
+     * @param {string} id - The identifier of the agent associated with the context.
+     * @param {string} taskId - The identifier of the task to retrieve.
+     * @param {Corti.AgentsGetTaskRequest} request
+     * @param {Agents.RequestOptions} requestOptions - Request-specific configuration.
+     *
+     * @throws {@link Corti.BadRequestError}
+     * @throws {@link Corti.UnauthorizedError}
+     * @throws {@link Corti.NotFoundError}
+     *
+     * @example
+     *     await client.agents.getTask("12345678-90ab-cdef-gh12-34567890abc", "taskId")
+     */
+    getTask(id: string, taskId: string, request?: Corti.AgentsGetTaskRequest, requestOptions?: Agents.RequestOptions): core.HttpResponsePromise<Corti.AgentsTask>;
+    private __getTask;
+    /**
+     * This endpoint retrieves all tasks and top-level messages associated with a specific context for the given agent.
+     *
+     * @param {string} id - The identifier of the agent associated with the context.
+     * @param {string} contextId - The identifier of the context (thread) to retrieve tasks for.
+     * @param {Corti.AgentsGetContextRequest} request
+     * @param {Agents.RequestOptions} requestOptions - Request-specific configuration.
+     *
+     * @throws {@link Corti.BadRequestError}
+     * @throws {@link Corti.UnauthorizedError}
+     * @throws {@link Corti.NotFoundError}
+     *
+     * @example
+     *     await client.agents.getContext("12345678-90ab-cdef-gh12-34567890abc", "contextId")
+     */
+    getContext(id: string, contextId: string, request?: Corti.AgentsGetContextRequest, requestOptions?: Agents.RequestOptions): core.HttpResponsePromise<Corti.AgentsContext>;
+    private __getContext;
+    /**
+     * This endpoint retrieves the experts registry, which contains information about all available experts that can be referenced when creating agents through the AgentsExpertReference schema.
+     *
+     * @param {Corti.AgentsGetRegistryExpertsRequest} request
+     * @param {Agents.RequestOptions} requestOptions - Request-specific configuration.
+     *
+     * @throws {@link Corti.BadRequestError}
+     * @throws {@link Corti.UnauthorizedError}
+     *
+     * @example
+     *     await client.agents.getRegistryExperts({
+     *         limit: 100,
+     *         offset: 0
+     *     })
+     */
+    getRegistryExperts(request?: Corti.AgentsGetRegistryExpertsRequest, requestOptions?: Agents.RequestOptions): core.HttpResponsePromise<Corti.AgentsRegistryExpertsResponse>;
+    private __getRegistryExperts;
+    protected _getAuthorizationHeader(): Promise<string | undefined>;
+}