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

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

@@ -73,7 +73,10 @@ class Models {
      * @throws {@link Letta.UnprocessableEntityError}
      *
      * @example
-     *     await client.models.list()
+     *     await client.models.list({
+     *         providerName: "provider_name",
+     *         providerType: "anthropic"
+     *     })
      */
     list(request = {}, requestOptions) {
         return core.HttpResponsePromise.fromPromise(this.__list(request, requestOptions));
@@ -106,7 +109,7 @@ class Models {
                 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.3", "User-Agent": "@letta-ai/letta-client/1.0.0-alpha.3", "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",
@@ -178,7 +181,7 @@ class Models {
                 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.3", "User-Agent": "@letta-ai/letta-client/1.0.0-alpha.3", "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/models/client/requests/ModelsListRequest.d.ts

@@ -4,7 +4,10 @@
 import * as Letta from "../../../../index";
 /**
  * @example
- *     {}
+ *     {
+ *         providerName: "provider_name",
+ *         providerType: "anthropic"
+ *     }
  */
 export interface ModelsListRequest {
     providerCategory?: Letta.ProviderCategory | Letta.ProviderCategory[];

package/api/resources/models/resources/embeddings/client/Client.js

@@ -80,7 +80,7 @@ class Embeddings {
                 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.3", "User-Agent": "@letta-ai/letta-client/1.0.0-alpha.3", "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/projects/client/Client.d.ts

@@ -37,7 +37,11 @@ export declare class Projects {
      * @param {Projects.RequestOptions} requestOptions - Request-specific configuration.
      *
      * @example
-     *     await client.projects.list()
+     *     await client.projects.list({
+     *         name: "name",
+     *         offset: "offset",
+     *         limit: "limit"
+     *     })
      */
     list(request?: Letta.ProjectsListRequest, requestOptions?: Projects.RequestOptions): core.HttpResponsePromise<Letta.ProjectsListResponse>;
     private __list;

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

@@ -65,7 +65,11 @@ class Projects {
      * @param {Projects.RequestOptions} requestOptions - Request-specific configuration.
      *
      * @example
-     *     await client.projects.list()
+     *     await client.projects.list({
+     *         name: "name",
+     *         offset: "offset",
+     *         limit: "limit"
+     *     })
      */
     list(request = {}, requestOptions) {
         return core.HttpResponsePromise.fromPromise(this.__list(request, requestOptions));
@@ -89,7 +93,7 @@ class Projects {
                 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.3", "User-Agent": "@letta-ai/letta-client/1.0.0-alpha.3", "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/projects/client/requests/ProjectsListRequest.d.ts

@@ -3,7 +3,11 @@
  */
 /**
  * @example
- *     {}
+ *     {
+ *         name: "name",
+ *         offset: "offset",
+ *         limit: "limit"
+ *     }
  */
 export interface ProjectsListRequest {
     name?: string;

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

@@ -39,7 +39,15 @@ export declare 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?: Letta.ProvidersListRequest, requestOptions?: Providers.RequestOptions): core.HttpResponsePromise<Letta.Provider[]>;
     private __list;
@@ -118,6 +126,19 @@ export declare class Providers {
      */
     check(request: Letta.ProviderCheck, requestOptions?: Providers.RequestOptions): core.HttpResponsePromise<unknown>;
     private __check;
+    /**
+     * 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: string, requestOptions?: Providers.RequestOptions): core.HttpResponsePromise<unknown>;
+    private __checkExistingProvider;
     protected _getCustomAuthorizationHeaders(): Promise<{
         Authorization: string;
     }>;

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.3", "User-Agent": "@letta-ai/letta-client/1.0.0-alpha.3", "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.3", "User-Agent": "@letta-ai/letta-client/1.0.0-alpha.3", "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.3", "User-Agent": "@letta-ai/letta-client/1.0.0-alpha.3", "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.3", "User-Agent": "@letta-ai/letta-client/1.0.0-alpha.3", "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.3", "User-Agent": "@letta-ai/letta-client/1.0.0-alpha.3", "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.3", "User-Agent": "@letta-ai/letta-client/1.0.0-alpha.3", "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.3", "User-Agent": "@letta-ai/letta-client/1.0.0-alpha.3", "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.3", "User-Agent": "@letta-ai/letta-client/1.0.0-alpha.3", "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.3", "User-Agent": "@letta-ai/letta-client/1.0.0-alpha.3", "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.3", "User-Agent": "@letta-ai/letta-client/1.0.0-alpha.3", "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.3", "User-Agent": "@letta-ai/letta-client/1.0.0-alpha.3", "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.3", "User-Agent": "@letta-ai/letta-client/1.0.0-alpha.3", "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.3", "User-Agent": "@letta-ai/letta-client/1.0.0-alpha.3", "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 {
     /**