@letta-ai/letta-client 1.0.0-alpha.1 → 1.0.0-alpha.2

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

@@ -83,7 +83,18 @@ class Runs {
      * @throws {@link Letta.UnprocessableEntityError}
      *
      * @example
-     *     await client.runs.list()
+     *     await client.runs.list({
+     *         agentId: "agent_id",
+     *         background: true,
+     *         stopReason: "end_turn",
+     *         before: "before",
+     *         after: "after",
+     *         limit: 1,
+     *         order: "asc",
+     *         orderBy: "created_at",
+     *         active: true,
+     *         ascending: true
+     *     })
      */
     list(request = {}, requestOptions) {
         return core.HttpResponsePromise.fromPromise(this.__list(request, requestOptions));
@@ -91,7 +102,7 @@ class Runs {
     __list() {
         return __awaiter(this, arguments, void 0, function* (request = {}, requestOptions) {
             var _a, _b, _c;
-            const { agentId, agentIds, background, stopReason, after, before, limit, active, ascending } = request;
+            const { agentId, agentIds, statuses, background, stopReason, before, after, limit, order, orderBy, active, ascending, } = request;
             const _queryParams = {};
             if (agentId != null) {
                 _queryParams["agent_id"] = agentId;
@@ -104,6 +115,14 @@ class Runs {
                     _queryParams["agent_ids"] = agentIds;
                 }
             }
+            if (statuses != null) {
+                if (Array.isArray(statuses)) {
+                    _queryParams["statuses"] = statuses.map((item) => item);
+                }
+                else {
+                    _queryParams["statuses"] = statuses;
+                }
+            }
             if (background != null) {
                 _queryParams["background"] = background.toString();
             }
@@ -112,15 +131,23 @@ class Runs {
                     unrecognizedObjectKeys: "strip",
                 });
             }
-            if (after != null) {
-                _queryParams["after"] = after;
-            }
             if (before != null) {
                 _queryParams["before"] = before;
             }
+            if (after != null) {
+                _queryParams["after"] = after;
+            }
             if (limit != null) {
                 _queryParams["limit"] = limit.toString();
             }
+            if (order != null) {
+                _queryParams["order"] = serializers.RunsListRequestOrder.jsonOrThrow(order, {
+                    unrecognizedObjectKeys: "strip",
+                });
+            }
+            if (orderBy != null) {
+                _queryParams["order_by"] = orderBy;
+            }
             if (active != null) {
                 _queryParams["active"] = active.toString();
             }
@@ -132,7 +159,7 @@ class Runs {
                 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": "1.0.0-alpha.1", "User-Agent": "@letta-ai/letta-client/1.0.0-alpha.1", "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": "1.0.0-alpha.2", "User-Agent": "@letta-ai/letta-client/1.0.0-alpha.2", "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",
@@ -196,7 +223,10 @@ class Runs {
      * @throws {@link Letta.UnprocessableEntityError}
      *
      * @example
-     *     await client.runs.listActive()
+     *     await client.runs.listActive({
+     *         agentId: "agent_id",
+     *         background: true
+     *     })
      */
     listActive(request = {}, requestOptions) {
         return core.HttpResponsePromise.fromPromise(this.__listActive(request, requestOptions));
@@ -217,7 +247,7 @@ class Runs {
                 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": "1.0.0-alpha.1", "User-Agent": "@letta-ai/letta-client/1.0.0-alpha.1", "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": "1.0.0-alpha.2", "User-Agent": "@letta-ai/letta-client/1.0.0-alpha.2", "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",
@@ -294,7 +324,7 @@ class Runs {
                 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": "1.0.0-alpha.1", "User-Agent": "@letta-ai/letta-client/1.0.0-alpha.1", "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": "1.0.0-alpha.2", "User-Agent": "@letta-ai/letta-client/1.0.0-alpha.2", "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,
@@ -370,7 +400,7 @@ class Runs {
                 method: "DELETE",
                 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": "1.0.0-alpha.1", "User-Agent": "@letta-ai/letta-client/1.0.0-alpha.1", "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": "1.0.0-alpha.2", "User-Agent": "@letta-ai/letta-client/1.0.0-alpha.2", "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,
@@ -424,6 +454,82 @@ class Runs {
             }
         });
     }
+    /**
+     * Get run metrics by run ID.
+     *
+     * @param {string} runId
+     * @param {Runs.RequestOptions} requestOptions - Request-specific configuration.
+     *
+     * @throws {@link Letta.UnprocessableEntityError}
+     *
+     * @example
+     *     await client.runs.retrieveMetricsForRun("run_id")
+     */
+    retrieveMetricsForRun(runId, requestOptions) {
+        return core.HttpResponsePromise.fromPromise(this.__retrieveMetricsForRun(runId, requestOptions));
+    }
+    __retrieveMetricsForRun(runId, requestOptions) {
+        return __awaiter(this, void 0, void 0, function* () {
+            var _a, _b, _c;
+            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)}/metrics`),
+                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": "1.0.0-alpha.2", "User-Agent": "@letta-ai/letta-client/1.0.0-alpha.2", "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,
+                maxRetries: requestOptions === null || requestOptions === void 0 ? void 0 : requestOptions.maxRetries,
+                abortSignal: requestOptions === null || requestOptions === void 0 ? void 0 : requestOptions.abortSignal,
+            });
+            if (_response.ok) {
+                return {
+                    data: serializers.RunMetrics.parseOrThrow(_response.body, {
+                        unrecognizedObjectKeys: "passthrough",
+                        allowUnrecognizedUnionMembers: true,
+                        allowUnrecognizedEnumValues: true,
+                        skipValidation: true,
+                        breadcrumbsPrefix: ["response"],
+                    }),
+                    rawResponse: _response.rawResponse,
+                };
+            }
+            if (_response.error.reason === "status-code") {
+                switch (_response.error.statusCode) {
+                    case 422:
+                        throw new Letta.UnprocessableEntityError(serializers.HttpValidationError.parseOrThrow(_response.error.body, {
+                            unrecognizedObjectKeys: "passthrough",
+                            allowUnrecognizedUnionMembers: true,
+                            allowUnrecognizedEnumValues: true,
+                            skipValidation: true,
+                            breadcrumbsPrefix: ["response"],
+                        }), _response.rawResponse);
+                    default:
+                        throw new errors.LettaError({
+                            statusCode: _response.error.statusCode,
+                            body: _response.error.body,
+                            rawResponse: _response.rawResponse,
+                        });
+                }
+            }
+            switch (_response.error.reason) {
+                case "non-json":
+                    throw new errors.LettaError({
+                        statusCode: _response.error.statusCode,
+                        body: _response.error.rawBody,
+                        rawResponse: _response.rawResponse,
+                    });
+                case "timeout":
+                    throw new errors.LettaTimeoutError("Timeout exceeded when calling GET /v1/runs/{run_id}/metrics.");
+                case "unknown":
+                    throw new errors.LettaError({
+                        message: _response.error.errorMessage,
+                        rawResponse: _response.rawResponse,
+                    });
+            }
+        });
+    }
     stream(runId, request = {}, requestOptions) {
         return core.HttpResponsePromise.fromPromise(this.__stream(runId, request, requestOptions));
     }
@@ -435,7 +541,7 @@ class Runs {
                 method: "POST",
                 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": "1.0.0-alpha.1", "User-Agent": "@letta-ai/letta-client/1.0.0-alpha.1", "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": "1.0.0-alpha.2", "User-Agent": "@letta-ai/letta-client/1.0.0-alpha.2", "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",
                 body: serializers.RetrieveStreamRequest.jsonOrThrow(request, { unrecognizedObjectKeys: "strip" }),

package/dist/api/resources/runs/client/requests/RunsListActiveRequest.d.ts

@@ -3,7 +3,10 @@
  */
 /**
  * @example
- *     {}
+ *     {
+ *         agentId: "agent_id",
+ *         background: true
+ *     }
  */
 export interface RunsListActiveRequest {
     /**

package/dist/api/resources/runs/client/requests/RunsListRequest.d.ts

@@ -4,7 +4,18 @@
 import * as Letta from "../../../../index";
 /**
  * @example
- *     {}
+ *     {
+ *         agentId: "agent_id",
+ *         background: true,
+ *         stopReason: "end_turn",
+ *         before: "before",
+ *         after: "after",
+ *         limit: 1,
+ *         order: "asc",
+ *         orderBy: "created_at",
+ *         active: true,
+ *         ascending: true
+ *     }
  */
 export interface RunsListRequest {
     /**
@@ -15,6 +26,10 @@ export interface RunsListRequest {
      * The unique identifiers of the agents associated with the run. Deprecated in favor of agent_id field.
      */
     agentIds?: string | string[];
+    /**
+     * Filter runs by status. Can specify multiple statuses.
+     */
+    statuses?: string | string[];
     /**
      * If True, filters for runs that were created in background mode.
      */
@@ -24,23 +39,31 @@ export interface RunsListRequest {
      */
     stopReason?: Letta.StopReasonType;
     /**
-     * Cursor for pagination
+     * Run ID cursor for pagination. Returns runs that come before this run ID in the specified sort order
      */
-    after?: string;
+    before?: string;
     /**
-     * Cursor for pagination
+     * Run ID cursor for pagination. Returns runs that come after this run ID in the specified sort order
      */
-    before?: string;
+    after?: string;
     /**
      * Maximum number of runs to return
      */
     limit?: number;
+    /**
+     * Sort order for runs by creation time. 'asc' for oldest first, 'desc' for newest first
+     */
+    order?: Letta.RunsListRequestOrder;
+    /**
+     * Field to sort by
+     */
+    orderBy?: "created_at";
     /**
      * Filter for active runs.
      */
     active?: boolean;
     /**
-     * Whether to sort agents oldest to newest (True) or newest to oldest (False, default)
+     * Whether to sort agents oldest to newest (True) or newest to oldest (False, default). Deprecated in favor of order field.
      */
     ascending?: boolean;
 }

package/dist/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/dist/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/dist/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/dist/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": "1.0.0-alpha.1", "User-Agent": "@letta-ai/letta-client/1.0.0-alpha.1", "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": "1.0.0-alpha.2", "User-Agent": "@letta-ai/letta-client/1.0.0-alpha.2", "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/dist/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/dist/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/dist/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": "1.0.0-alpha.1", "User-Agent": "@letta-ai/letta-client/1.0.0-alpha.1", "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": "1.0.0-alpha.2", "User-Agent": "@letta-ai/letta-client/1.0.0-alpha.2", "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/dist/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/dist/api/resources/runs/resources/steps/index.d.ts

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

package/dist/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/dist/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/dist/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/dist/api/resources/runs/resources/steps/types/index.d.ts

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

package/dist/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/dist/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": "1.0.0-alpha.1", "User-Agent": "@letta-ai/letta-client/1.0.0-alpha.1", "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": "1.0.0-alpha.2", "User-Agent": "@letta-ai/letta-client/1.0.0-alpha.2", "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/dist/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/dist/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/dist/api/resources/runs/types/index.d.ts

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