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

package/api/resources/providers/client/Client.js

@@ -68,7 +68,15 @@ class Providers {
      * @throws {@link Letta.UnprocessableEntityError}
      *
      * @example
-     *     await client.providers.list()
+     *     await client.providers.list({
+     *         before: "before",
+     *         after: "after",
+     *         limit: 1,
+     *         order: "asc",
+     *         orderBy: "created_at",
+     *         name: "name",
+     *         providerType: "anthropic"
+     *     })
      */
     list(request = {}, requestOptions) {
         return core.HttpResponsePromise.fromPromise(this.__list(request, requestOptions));
@@ -108,7 +116,7 @@ class Providers {
                 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",
@@ -189,7 +197,7 @@ class Providers {
                 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.ProviderCreate.jsonOrThrow(request, { unrecognizedObjectKeys: "strip" }),
@@ -266,7 +274,7 @@ class Providers {
                 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,
@@ -342,7 +350,7 @@ class Providers {
                 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,
@@ -412,7 +420,7 @@ class Providers {
                 method: "PATCH",
                 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.ProviderUpdate.jsonOrThrow(request, { unrecognizedObjectKeys: "strip" }),
@@ -492,7 +500,7 @@ class Providers {
                 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.ProviderCheck.jsonOrThrow(request, { unrecognizedObjectKeys: "strip" }),
@@ -538,6 +546,73 @@ class Providers {
             }
         });
     }
+    /**
+     * Verify the API key and additional parameters for an existing provider.
+     *
+     * @param {string} providerId
+     * @param {Providers.RequestOptions} requestOptions - Request-specific configuration.
+     *
+     * @throws {@link Letta.UnprocessableEntityError}
+     *
+     * @example
+     *     await client.providers.checkExistingProvider("provider_id")
+     */
+    checkExistingProvider(providerId, requestOptions) {
+        return core.HttpResponsePromise.fromPromise(this.__checkExistingProvider(providerId, requestOptions));
+    }
+    __checkExistingProvider(providerId, 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/providers/${encodeURIComponent(providerId)}/check`),
+                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.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: _response.body, 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 POST /v1/providers/{provider_id}/check.");
+                case "unknown":
+                    throw new errors.LettaError({
+                        message: _response.error.errorMessage,
+                        rawResponse: _response.rawResponse,
+                    });
+            }
+        });
+    }
     _getCustomAuthorizationHeaders() {
         return __awaiter(this, void 0, void 0, function* () {
             const tokenValue = yield core.Supplier.get(this._options.token);

package/api/resources/providers/client/requests/ProvidersListRequest.d.ts

@@ -4,7 +4,15 @@
 import * as Letta from "../../../../index";
 /**
  * @example
- *     {}
+ *     {
+ *         before: "before",
+ *         after: "after",
+ *         limit: 1,
+ *         order: "asc",
+ *         orderBy: "created_at",
+ *         name: "name",
+ *         providerType: "anthropic"
+ *     }
  */
 export interface ProvidersListRequest {
     /**

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

@@ -48,7 +48,18 @@ export declare 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?: Letta.RunsListRequest, requestOptions?: Runs.RequestOptions): core.HttpResponsePromise<Letta.Run[]>;
     private __list;
@@ -61,7 +72,10 @@ export declare class Runs {
      * @throws {@link Letta.UnprocessableEntityError}
      *
      * @example
-     *     await client.runs.listActive()
+     *     await client.runs.listActive({
+     *         agentId: "agent_id",
+     *         background: true
+     *     })
      */
     listActive(request?: Letta.RunsListActiveRequest, requestOptions?: Runs.RequestOptions): core.HttpResponsePromise<Letta.Run[]>;
     private __listActive;
@@ -91,6 +105,19 @@ export declare class Runs {
      */
     delete(runId: string, requestOptions?: Runs.RequestOptions): core.HttpResponsePromise<Letta.Run>;
     private __delete;
+    /**
+     * 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: string, requestOptions?: Runs.RequestOptions): core.HttpResponsePromise<Letta.RunMetrics>;
+    private __retrieveMetricsForRun;
     stream(runId: string, request?: Letta.RetrieveStreamRequest, requestOptions?: Runs.RequestOptions): core.HttpResponsePromise<core.Stream<Letta.LettaStreamingResponse>>;
     private __stream;
     protected _getCustomAuthorizationHeaders(): Promise<{

package/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/api/resources/runs/client/requests/RunsListActiveRequest.d.ts

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

package/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/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": "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/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";
 }