@corti/sdk 0.3.0 → 0.4.0

package/dist/cjs/Client.d.ts

@@ -10,6 +10,7 @@ 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 {
@@ -47,6 +48,7 @@ export declare class CortiClient {
     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);
@@ -57,6 +59,7 @@ export declare class CortiClient {
     get documents(): Documents;
     get templates(): Templates;
     get auth(): Auth;
+    get agents(): Agents;
     get stream(): Stream;
     get transcribe(): Transcribe;
 }

package/dist/cjs/Client.js

@@ -55,16 +55,17 @@ 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/stream/client/Client.js");
-const Client_js_9 = require("./api/resources/transcribe/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.3.0",
-                "User-Agent": "@corti/sdk/0.3.0",
+                "X-Fern-SDK-Version": "0.4.0",
+                "User-Agent": "@corti/sdk/0.4.0",
                 "X-Fern-Runtime": core.RUNTIME.type,
                 "X-Fern-Runtime-Version": core.RUNTIME.version,
             }, _options === null || _options === void 0 ? void 0 : _options.headers) });
@@ -102,13 +103,17 @@ class CortiClient {
         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_8.Stream(Object.assign(Object.assign({}, this._options), { token: () => __awaiter(this, void 0, void 0, function* () { return yield this._oauthTokenProvider.getToken(); }) }))));
+        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_9.Transcribe(Object.assign(Object.assign({}, this._options), { token: () => __awaiter(this, void 0, void 0, function* () { return yield this._oauthTokenProvider.getToken(); }) }))));
+        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/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>;
+}