@corti/sdk 0.1.1-rc.1 → 0.1.2-agents

package/README.md

@@ -1,14 +1,13 @@
-# Corti JavaScript 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-javascript)
 [![npm shield](https://img.shields.io/npm/v/@corti/sdk)](https://www.npmjs.com/package/@corti/sdk)
 
-> [!WARNING]
-> This is a **Beta version** of the Corti JavaScript SDK library. 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 library and would greatly
+> 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 JavaScript library provides convenient access to the Corti API from JavaScript.
+The Corti JavaScript SDK provides convenient access to the Corti API from JavaScript.
 
 ## Installation
 
@@ -18,7 +17,7 @@ npm i -s @corti/sdk
 
 ## Reference
 
-A full reference for this library is available [here](REFERENCE-latest.md).
+A full reference for this SDK is available [here](REFERENCE-latest.md).
 
 For detailed authentication instructions, see the [Authentication Guide](./AUTHENTICATION.md).
 
@@ -52,6 +51,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
 
@@ -235,8 +251,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.0",
-                "User-Agent": "@corti/sdk/0.1.0",
+                "X-Fern-SDK-Version": "0.1.2-agents",
+                "User-Agent": "@corti/sdk/0.1.2-agents",
                 "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,195 @@
+/**
+ * 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"
+     *     })
+     */
+    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"
+     *         }
+     *     })
+     */
+    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>;
+}