@corti/sdk 0.1.5-alpha → 0.2.0-agents-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
@@ -53,6 +49,23 @@ const client = new CortiClient({
     },
 });
 
+// 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();
+        },
+    },
+});
+
 // For user authentication, you can also use Authorization Code Flow
 // See the Authentication Guide for detailed instructions
 
@@ -236,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

@@ -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.1.5-alpha",
-                "User-Agent": "@corti/sdk/0.1.5-alpha",
+                "X-Fern-SDK-Version": "0.2.0-agents-rc",
+                "User-Agent": "@corti/sdk/0.2.0-agents-rc",
                 "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/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,197 @@
+/**
+ * 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 /threads` 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 to retrieve.
+     * @param {Agents.RequestOptions} requestOptions - Request-specific configuration.
+     *
+     * @throws {@link Corti.BadRequestError}
+     * @throws {@link Corti.UnauthorizedError}
+     * @throws {@link Corti.NotFoundError}
+     *
+     * @example
+     *     await client.agents.get("id")
+     */
+    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 to delete.
+     * @param {Agents.RequestOptions} requestOptions - Request-specific configuration.
+     *
+     * @throws {@link Corti.BadRequestError}
+     * @throws {@link Corti.UnauthorizedError}
+     * @throws {@link Corti.NotFoundError}
+     *
+     * @example
+     *     await client.agents.delete("id")
+     */
+    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 to update.
+     * @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("id", {
+     *         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 to retrieve the agent card for.
+     * @param {Agents.RequestOptions} requestOptions - Request-specific configuration.
+     *
+     * @throws {@link Corti.BadRequestError}
+     * @throws {@link Corti.UnauthorizedError}
+     * @throws {@link Corti.NotFoundError}
+     *
+     * @example
+     *     await client.agents.getCard("id")
+     */
+    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 to send the message to.
+     * @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("id", {
+     *         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;
+    /**
+     * Sends a message to the specified agent and streams the response as it is generated. This method requires the server to have support for streaming.
+     */
+    messageStream(id: string, request: Corti.AgentsMessageSendParams, requestOptions?: Agents.RequestOptions): core.HttpResponsePromise<core.Stream<Corti.AgentsMessageStreamResponse>>;
+    private __messageStream;
+    /**
+     * 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 task.
+     * @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("id", "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("id", "contextId")
+     */
+    getContext(id: string, contextId: string, request?: Corti.AgentsGetContextRequest, requestOptions?: Agents.RequestOptions): core.HttpResponsePromise<Corti.AgentsContext>;
+    private __getContext;
+    protected _getAuthorizationHeader(): Promise<string | undefined>;
+}