@letta-ai/letta-client 0.0.68663 → 0.0.68665

package/api/resources/runs/resources/index.d.ts

@@ -1,6 +1,7 @@
 export * as messages from "./messages";
 export * from "./messages/types";
-export * as usage from "./usage";
 export * as steps from "./steps";
+export * from "./steps/types";
+export * as usage from "./usage";
 export * from "./messages/client/requests";
 export * from "./steps/client/requests";

package/api/resources/runs/resources/index.js

@@ -36,10 +36,11 @@ var __exportStar = (this && this.__exportStar) || function(m, exports) {
     for (var p in m) if (p !== "default" && !Object.prototype.hasOwnProperty.call(exports, p)) __createBinding(exports, m, p);
 };
 Object.defineProperty(exports, "__esModule", { value: true });
-exports.steps = exports.usage = exports.messages = void 0;
+exports.usage = exports.steps = exports.messages = void 0;
 exports.messages = __importStar(require("./messages"));
 __exportStar(require("./messages/types"), exports);
-exports.usage = __importStar(require("./usage"));
 exports.steps = __importStar(require("./steps"));
+__exportStar(require("./steps/types"), exports);
+exports.usage = __importStar(require("./usage"));
 __exportStar(require("./messages/client/requests"), exports);
 __exportStar(require("./steps/client/requests"), exports);

package/api/resources/runs/resources/messages/client/Client.d.ts

@@ -40,7 +40,13 @@ export declare class Messages {
      * @throws {@link Letta.UnprocessableEntityError}
      *
      * @example
-     *     await client.runs.messages.list("run_id")
+     *     await client.runs.messages.list("run_id", {
+     *         before: "before",
+     *         after: "after",
+     *         limit: 1,
+     *         order: "asc",
+     *         orderBy: "created_at"
+     *     })
      */
     list(runId: string, request?: Letta.runs.MessagesListRequest, requestOptions?: Messages.RequestOptions): core.HttpResponsePromise<Letta.LettaMessageUnion[]>;
     private __list;

package/api/resources/runs/resources/messages/client/Client.js

@@ -69,7 +69,13 @@ class Messages {
      * @throws {@link Letta.UnprocessableEntityError}
      *
      * @example
-     *     await client.runs.messages.list("run_id")
+     *     await client.runs.messages.list("run_id", {
+     *         before: "before",
+     *         after: "after",
+     *         limit: 1,
+     *         order: "asc",
+     *         orderBy: "created_at"
+     *     })
      */
     list(runId, request = {}, requestOptions) {
         return core.HttpResponsePromise.fromPromise(this.__list(runId, request, requestOptions));
@@ -77,7 +83,7 @@ class Messages {
     __list(runId_1) {
         return __awaiter(this, arguments, void 0, function* (runId, request = {}, requestOptions) {
             var _a, _b, _c;
-            const { before, after, limit, order } = request;
+            const { before, after, limit, order, orderBy } = request;
             const _queryParams = {};
             if (before != null) {
                 _queryParams["before"] = before;
@@ -93,12 +99,15 @@ class Messages {
                     unrecognizedObjectKeys: "strip",
                 });
             }
+            if (orderBy != null) {
+                _queryParams["order_by"] = orderBy;
+            }
             const _response = yield ((_a = this._options.fetcher) !== null && _a !== void 0 ? _a : core.fetcher)({
                 url: (0, url_join_1.default)((_c = (_b = (yield core.Supplier.get(this._options.baseUrl))) !== null && _b !== void 0 ? _b : (yield core.Supplier.get(this._options.environment))) !== null && _c !== void 0 ? _c : environments.LettaEnvironment.LettaCloud, `v1/runs/${encodeURIComponent(runId)}/messages`),
                 method: "GET",
                 headers: Object.assign(Object.assign({ "X-Project": (yield core.Supplier.get(this._options.project)) != null
                         ? yield core.Supplier.get(this._options.project)
-                        : undefined, "X-Fern-Language": "JavaScript", "X-Fern-SDK-Name": "@letta-ai/letta-client", "X-Fern-SDK-Version": "0.0.68663", "User-Agent": "@letta-ai/letta-client/0.0.68663", "X-Fern-Runtime": core.RUNTIME.type, "X-Fern-Runtime-Version": core.RUNTIME.version }, (yield this._getCustomAuthorizationHeaders())), requestOptions === null || requestOptions === void 0 ? void 0 : requestOptions.headers),
+                        : undefined, "X-Fern-Language": "JavaScript", "X-Fern-SDK-Name": "@letta-ai/letta-client", "X-Fern-SDK-Version": "0.0.68665", "User-Agent": "@letta-ai/letta-client/0.0.68665", "X-Fern-Runtime": core.RUNTIME.type, "X-Fern-Runtime-Version": core.RUNTIME.version }, (yield this._getCustomAuthorizationHeaders())), requestOptions === null || requestOptions === void 0 ? void 0 : requestOptions.headers),
                 contentType: "application/json",
                 queryParameters: _queryParams,
                 requestType: "json",

package/api/resources/runs/resources/messages/client/requests/MessagesListRequest.d.ts

@@ -4,7 +4,13 @@
 import * as Letta from "../../../../../../index";
 /**
  * @example
- *     {}
+ *     {
+ *         before: "before",
+ *         after: "after",
+ *         limit: 1,
+ *         order: "asc",
+ *         orderBy: "created_at"
+ *     }
  */
 export interface MessagesListRequest {
     /**
@@ -23,4 +29,8 @@ export interface MessagesListRequest {
      * Sort order for messages by creation time. 'asc' for oldest first, 'desc' for newest first
      */
     order?: Letta.runs.MessagesListRequestOrder;
+    /**
+     * Field to sort by
+     */
+    orderBy?: "created_at";
 }

package/api/resources/runs/resources/steps/client/Client.d.ts

@@ -31,17 +31,7 @@ export declare class Steps {
     protected readonly _options: Steps.Options;
     constructor(_options?: Steps.Options);
     /**
-     * Get messages associated with a run with filtering options.
-     *
-     * Args:
-     *     run_id: ID of the run
-     *     before: A cursor for use in pagination. `before` is an object ID that defines your place in the list. For instance, if you make a list request and receive 100 objects, starting with obj_foo, your subsequent call can include before=obj_foo in order to fetch the previous page of the list.
-     *     after: A cursor for use in pagination. `after` is an object ID that defines your place in the list. For instance, if you make a list request and receive 100 objects, ending with obj_foo, your subsequent call can include after=obj_foo in order to fetch the next page of the list.
-     *     limit: Maximum number of steps to return
-     *     order: Sort order by the created_at timestamp of the objects. asc for ascending order and desc for descending order.
-     *
-     * Returns:
-     *     A list of steps associated with the run.
+     * Get steps associated with a run with filtering options.
      *
      * @param {string} runId
      * @param {Letta.runs.StepsListRequest} request
@@ -50,7 +40,13 @@ export declare class Steps {
      * @throws {@link Letta.UnprocessableEntityError}
      *
      * @example
-     *     await client.runs.steps.list("run_id")
+     *     await client.runs.steps.list("run_id", {
+     *         before: "before",
+     *         after: "after",
+     *         limit: 1,
+     *         order: "asc",
+     *         orderBy: "created_at"
+     *     })
      */
     list(runId: string, request?: Letta.runs.StepsListRequest, requestOptions?: Steps.RequestOptions): core.HttpResponsePromise<Letta.Step[]>;
     private __list;

package/api/resources/runs/resources/steps/client/Client.js

@@ -52,25 +52,15 @@ exports.Steps = void 0;
 const environments = __importStar(require("../../../../../../environments"));
 const core = __importStar(require("../../../../../../core"));
 const Letta = __importStar(require("../../../../../index"));
-const url_join_1 = __importDefault(require("url-join"));
 const serializers = __importStar(require("../../../../../../serialization/index"));
+const url_join_1 = __importDefault(require("url-join"));
 const errors = __importStar(require("../../../../../../errors/index"));
 class Steps {
     constructor(_options = {}) {
         this._options = _options;
     }
     /**
-     * Get messages associated with a run with filtering options.
-     *
-     * Args:
-     *     run_id: ID of the run
-     *     before: A cursor for use in pagination. `before` is an object ID that defines your place in the list. For instance, if you make a list request and receive 100 objects, starting with obj_foo, your subsequent call can include before=obj_foo in order to fetch the previous page of the list.
-     *     after: A cursor for use in pagination. `after` is an object ID that defines your place in the list. For instance, if you make a list request and receive 100 objects, ending with obj_foo, your subsequent call can include after=obj_foo in order to fetch the next page of the list.
-     *     limit: Maximum number of steps to return
-     *     order: Sort order by the created_at timestamp of the objects. asc for ascending order and desc for descending order.
-     *
-     * Returns:
-     *     A list of steps associated with the run.
+     * Get steps associated with a run with filtering options.
      *
      * @param {string} runId
      * @param {Letta.runs.StepsListRequest} request
@@ -79,7 +69,13 @@ class Steps {
      * @throws {@link Letta.UnprocessableEntityError}
      *
      * @example
-     *     await client.runs.steps.list("run_id")
+     *     await client.runs.steps.list("run_id", {
+     *         before: "before",
+     *         after: "after",
+     *         limit: 1,
+     *         order: "asc",
+     *         orderBy: "created_at"
+     *     })
      */
     list(runId, request = {}, requestOptions) {
         return core.HttpResponsePromise.fromPromise(this.__list(runId, request, requestOptions));
@@ -87,7 +83,7 @@ class Steps {
     __list(runId_1) {
         return __awaiter(this, arguments, void 0, function* (runId, request = {}, requestOptions) {
             var _a, _b, _c;
-            const { before, after, limit, order } = request;
+            const { before, after, limit, order, orderBy } = request;
             const _queryParams = {};
             if (before != null) {
                 _queryParams["before"] = before;
@@ -99,14 +95,19 @@ class Steps {
                 _queryParams["limit"] = limit.toString();
             }
             if (order != null) {
-                _queryParams["order"] = order;
+                _queryParams["order"] = serializers.runs.StepsListRequestOrder.jsonOrThrow(order, {
+                    unrecognizedObjectKeys: "strip",
+                });
+            }
+            if (orderBy != null) {
+                _queryParams["order_by"] = orderBy;
             }
             const _response = yield ((_a = this._options.fetcher) !== null && _a !== void 0 ? _a : core.fetcher)({
                 url: (0, url_join_1.default)((_c = (_b = (yield core.Supplier.get(this._options.baseUrl))) !== null && _b !== void 0 ? _b : (yield core.Supplier.get(this._options.environment))) !== null && _c !== void 0 ? _c : environments.LettaEnvironment.LettaCloud, `v1/runs/${encodeURIComponent(runId)}/steps`),
                 method: "GET",
                 headers: Object.assign(Object.assign({ "X-Project": (yield core.Supplier.get(this._options.project)) != null
                         ? yield core.Supplier.get(this._options.project)
-                        : undefined, "X-Fern-Language": "JavaScript", "X-Fern-SDK-Name": "@letta-ai/letta-client", "X-Fern-SDK-Version": "0.0.68663", "User-Agent": "@letta-ai/letta-client/0.0.68663", "X-Fern-Runtime": core.RUNTIME.type, "X-Fern-Runtime-Version": core.RUNTIME.version }, (yield this._getCustomAuthorizationHeaders())), requestOptions === null || requestOptions === void 0 ? void 0 : requestOptions.headers),
+                        : undefined, "X-Fern-Language": "JavaScript", "X-Fern-SDK-Name": "@letta-ai/letta-client", "X-Fern-SDK-Version": "0.0.68665", "User-Agent": "@letta-ai/letta-client/0.0.68665", "X-Fern-Runtime": core.RUNTIME.type, "X-Fern-Runtime-Version": core.RUNTIME.version }, (yield this._getCustomAuthorizationHeaders())), requestOptions === null || requestOptions === void 0 ? void 0 : requestOptions.headers),
                 contentType: "application/json",
                 queryParameters: _queryParams,
                 requestType: "json",

package/api/resources/runs/resources/steps/client/requests/StepsListRequest.d.ts

@@ -1,9 +1,16 @@
 /**
  * This file was auto-generated by Fern from our API Definition.
  */
+import * as Letta from "../../../../../../index";
 /**
  * @example
- *     {}
+ *     {
+ *         before: "before",
+ *         after: "after",
+ *         limit: 1,
+ *         order: "asc",
+ *         orderBy: "created_at"
+ *     }
  */
 export interface StepsListRequest {
     /**
@@ -19,7 +26,11 @@ export interface StepsListRequest {
      */
     limit?: number;
     /**
-     * Sort order by the created_at timestamp of the objects. asc for ascending order and desc for descending order.
+     * Sort order for steps by creation time. 'asc' for oldest first, 'desc' for newest first
      */
-    order?: string;
+    order?: Letta.runs.StepsListRequestOrder;
+    /**
+     * Field to sort by
+     */
+    orderBy?: "created_at";
 }

package/api/resources/runs/resources/steps/index.d.ts

@@ -1 +1,2 @@
+export * from "./types";
 export * from "./client";

package/api/resources/runs/resources/steps/index.js

@@ -14,4 +14,5 @@ var __exportStar = (this && this.__exportStar) || function(m, exports) {
     for (var p in m) if (p !== "default" && !Object.prototype.hasOwnProperty.call(exports, p)) __createBinding(exports, m, p);
 };
 Object.defineProperty(exports, "__esModule", { value: true });
+__exportStar(require("./types"), exports);
 __exportStar(require("./client"), exports);

package/api/resources/runs/resources/steps/types/StepsListRequestOrder.d.ts

@@ -0,0 +1,11 @@
+/**
+ * This file was auto-generated by Fern from our API Definition.
+ */
+/**
+ * Sort order for steps by creation time. 'asc' for oldest first, 'desc' for newest first
+ */
+export type StepsListRequestOrder = "asc" | "desc";
+export declare const StepsListRequestOrder: {
+    readonly Asc: "asc";
+    readonly Desc: "desc";
+};

package/api/resources/runs/resources/steps/types/StepsListRequestOrder.js

@@ -0,0 +1,10 @@
+"use strict";
+/**
+ * This file was auto-generated by Fern from our API Definition.
+ */
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.StepsListRequestOrder = void 0;
+exports.StepsListRequestOrder = {
+    Asc: "asc",
+    Desc: "desc",
+};

package/api/resources/runs/resources/steps/types/index.d.ts

@@ -0,0 +1 @@
+export * from "./StepsListRequestOrder";

package/api/resources/runs/resources/steps/types/index.js

@@ -0,0 +1,17 @@
+"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 __exportStar = (this && this.__exportStar) || function(m, exports) {
+    for (var p in m) if (p !== "default" && !Object.prototype.hasOwnProperty.call(exports, p)) __createBinding(exports, m, p);
+};
+Object.defineProperty(exports, "__esModule", { value: true });
+__exportStar(require("./StepsListRequestOrder"), exports);

package/api/resources/runs/resources/usage/client/Client.js

@@ -81,7 +81,7 @@ class Usage {
                 method: "GET",
                 headers: Object.assign(Object.assign({ "X-Project": (yield core.Supplier.get(this._options.project)) != null
                         ? yield core.Supplier.get(this._options.project)
-                        : undefined, "X-Fern-Language": "JavaScript", "X-Fern-SDK-Name": "@letta-ai/letta-client", "X-Fern-SDK-Version": "0.0.68663", "User-Agent": "@letta-ai/letta-client/0.0.68663", "X-Fern-Runtime": core.RUNTIME.type, "X-Fern-Runtime-Version": core.RUNTIME.version }, (yield this._getCustomAuthorizationHeaders())), requestOptions === null || requestOptions === void 0 ? void 0 : requestOptions.headers),
+                        : undefined, "X-Fern-Language": "JavaScript", "X-Fern-SDK-Name": "@letta-ai/letta-client", "X-Fern-SDK-Version": "0.0.68665", "User-Agent": "@letta-ai/letta-client/0.0.68665", "X-Fern-Runtime": core.RUNTIME.type, "X-Fern-Runtime-Version": core.RUNTIME.version }, (yield this._getCustomAuthorizationHeaders())), requestOptions === null || requestOptions === void 0 ? void 0 : requestOptions.headers),
                 contentType: "application/json",
                 requestType: "json",
                 timeoutMs: (requestOptions === null || requestOptions === void 0 ? void 0 : requestOptions.timeoutInSeconds) != null ? requestOptions.timeoutInSeconds * 1000 : 60000,

package/api/resources/runs/types/RunsListRequestOrder.d.ts

@@ -0,0 +1,11 @@
+/**
+ * This file was auto-generated by Fern from our API Definition.
+ */
+/**
+ * Sort order for runs by creation time. 'asc' for oldest first, 'desc' for newest first
+ */
+export type RunsListRequestOrder = "asc" | "desc";
+export declare const RunsListRequestOrder: {
+    readonly Asc: "asc";
+    readonly Desc: "desc";
+};

package/api/resources/runs/types/RunsListRequestOrder.js

@@ -0,0 +1,10 @@
+"use strict";
+/**
+ * This file was auto-generated by Fern from our API Definition.
+ */
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.RunsListRequestOrder = void 0;
+exports.RunsListRequestOrder = {
+    Asc: "asc",
+    Desc: "desc",
+};

package/api/resources/runs/types/index.d.ts

@@ -1 +1,2 @@
+export * from "./RunsListRequestOrder";
 export * from "./LettaStreamingResponse";

package/api/resources/runs/types/index.js

@@ -14,4 +14,5 @@ var __exportStar = (this && this.__exportStar) || function(m, exports) {
     for (var p in m) if (p !== "default" && !Object.prototype.hasOwnProperty.call(exports, p)) __createBinding(exports, m, p);
 };
 Object.defineProperty(exports, "__esModule", { value: true });
+__exportStar(require("./RunsListRequestOrder"), exports);
 __exportStar(require("./LettaStreamingResponse"), exports);

package/api/resources/sources/client/Client.d.ts

@@ -51,40 +51,40 @@ export declare class Sources {
     /**
      * Get all sources
      *
-     * @param {string} sourceId
+     * @param {string} sourceId - The ID of the source in the format 'source-<uuid4>'
      * @param {Sources.RequestOptions} requestOptions - Request-specific configuration.
      *
      * @throws {@link Letta.UnprocessableEntityError}
      *
      * @example
-     *     await client.sources.retrieve("source_id")
+     *     await client.sources.retrieve("source-123e4567-e89b-42d3-8456-426614174000")
      */
     retrieve(sourceId: string, requestOptions?: Sources.RequestOptions): core.HttpResponsePromise<Letta.Source>;
     private __retrieve;
     /**
      * Delete a data source.
      *
-     * @param {string} sourceId
+     * @param {string} sourceId - The ID of the source in the format 'source-<uuid4>'
      * @param {Sources.RequestOptions} requestOptions - Request-specific configuration.
      *
      * @throws {@link Letta.UnprocessableEntityError}
      *
      * @example
-     *     await client.sources.delete("source_id")
+     *     await client.sources.delete("source-123e4567-e89b-42d3-8456-426614174000")
      */
     delete(sourceId: string, requestOptions?: Sources.RequestOptions): core.HttpResponsePromise<unknown>;
     private __delete;
     /**
      * Update the name or documentation of an existing data source.
      *
-     * @param {string} sourceId
+     * @param {string} sourceId - The ID of the source in the format 'source-<uuid4>'
      * @param {Letta.SourceUpdate} request
      * @param {Sources.RequestOptions} requestOptions - Request-specific configuration.
      *
      * @throws {@link Letta.UnprocessableEntityError}
      *
      * @example
-     *     await client.sources.modify("source_id", {})
+     *     await client.sources.modify("source-123e4567-e89b-42d3-8456-426614174000", {})
      */
     modify(sourceId: string, request: Letta.SourceUpdate, requestOptions?: Sources.RequestOptions): core.HttpResponsePromise<Letta.Source>;
     private __modify;
@@ -116,7 +116,9 @@ export declare class Sources {
      * @throws {@link Letta.UnprocessableEntityError}
      *
      * @example
-     *     await client.sources.getSourcesMetadata()
+     *     await client.sources.getSourcesMetadata({
+     *         includeDetailedPerSourceMetadata: true
+     *     })
      */
     getSourcesMetadata(request?: Letta.GetSourcesMetadataRequest, requestOptions?: Sources.RequestOptions): core.HttpResponsePromise<Letta.OrganizationSourcesStats>;
     private __getSourcesMetadata;
@@ -150,28 +152,30 @@ export declare class Sources {
     /**
      * Get all agent IDs that have the specified source attached.
      *
-     * @param {string} sourceId
+     * @param {string} sourceId - The ID of the source in the format 'source-<uuid4>'
      * @param {Sources.RequestOptions} requestOptions - Request-specific configuration.
      *
      * @throws {@link Letta.UnprocessableEntityError}
      *
      * @example
-     *     await client.sources.getAgentsForSource("source_id")
+     *     await client.sources.getAgentsForSource("source-123e4567-e89b-42d3-8456-426614174000")
      */
     getAgentsForSource(sourceId: string, requestOptions?: Sources.RequestOptions): core.HttpResponsePromise<string[]>;
     private __getAgentsForSource;
     /**
      * Retrieve metadata for a specific file by its ID.
      *
-     * @param {string} sourceId
-     * @param {string} fileId
+     * @param {string} sourceId - The ID of the source in the format 'source-<uuid4>'
+     * @param {string} fileId - The ID of the file in the format 'file-<uuid4>'
      * @param {Letta.GetFileMetadataRequest} request
      * @param {Sources.RequestOptions} requestOptions - Request-specific configuration.
      *
      * @throws {@link Letta.UnprocessableEntityError}
      *
      * @example
-     *     await client.sources.getFileMetadata("source_id", "file_id")
+     *     await client.sources.getFileMetadata("source-123e4567-e89b-42d3-8456-426614174000", "file-123e4567-e89b-42d3-8456-426614174000", {
+     *         includeContent: true
+     *     })
      */
     getFileMetadata(sourceId: string, fileId: string, request?: Letta.GetFileMetadataRequest, requestOptions?: Sources.RequestOptions): core.HttpResponsePromise<Letta.FileMetadata>;
     private __getFileMetadata;