@letta-ai/letta-client 0.0.68663 → 0.0.68665

package/api/resources/agents/resources/index.js

@@ -36,26 +36,32 @@ 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.groups = exports.blocks = exports.coreMemory = exports.files = exports.folders = exports.sources = exports.tools = exports.context = exports.memoryVariables = exports.templates = exports.messages = exports.passages = void 0;
+exports.coreMemory = exports.context = exports.memoryVariables = exports.groups = exports.messages = exports.passages = exports.blocks = exports.files = exports.folders = exports.sources = exports.tools = void 0;
+exports.tools = __importStar(require("./tools"));
+__exportStar(require("./tools/types"), exports);
+exports.sources = __importStar(require("./sources"));
+__exportStar(require("./sources/types"), exports);
+exports.folders = __importStar(require("./folders"));
+__exportStar(require("./folders/types"), exports);
+exports.files = __importStar(require("./files"));
+__exportStar(require("./files/types"), exports);
+exports.blocks = __importStar(require("./blocks"));
+__exportStar(require("./blocks/types"), exports);
 exports.passages = __importStar(require("./passages"));
 __exportStar(require("./passages/types"), exports);
 exports.messages = __importStar(require("./messages"));
 __exportStar(require("./messages/types"), exports);
-exports.templates = __importStar(require("./templates"));
-__exportStar(require("./templates/types"), exports);
+exports.groups = __importStar(require("./groups"));
+__exportStar(require("./groups/types"), exports);
 exports.memoryVariables = __importStar(require("./memoryVariables"));
 __exportStar(require("./memoryVariables/types"), exports);
 exports.context = __importStar(require("./context"));
-exports.tools = __importStar(require("./tools"));
-exports.sources = __importStar(require("./sources"));
-exports.folders = __importStar(require("./folders"));
-exports.files = __importStar(require("./files"));
 exports.coreMemory = __importStar(require("./coreMemory"));
-exports.blocks = __importStar(require("./blocks"));
-exports.groups = __importStar(require("./groups"));
 __exportStar(require("./tools/client/requests"), exports);
+__exportStar(require("./sources/client/requests"), exports);
+__exportStar(require("./folders/client/requests"), exports);
 __exportStar(require("./files/client/requests"), exports);
+__exportStar(require("./blocks/client/requests"), exports);
 __exportStar(require("./passages/client/requests"), exports);
 __exportStar(require("./messages/client/requests"), exports);
 __exportStar(require("./groups/client/requests"), exports);
-__exportStar(require("./templates/client/requests"), exports);

package/api/resources/agents/resources/memoryVariables/client/Client.js

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

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

@@ -33,14 +33,25 @@ export declare class Messages {
     /**
      * Retrieve message history for an agent.
      *
-     * @param {string} agentId
+     * @param {string} agentId - The ID of the agent in the format 'agent-<uuid4>'
      * @param {Letta.agents.MessagesListRequest} request
      * @param {Messages.RequestOptions} requestOptions - Request-specific configuration.
      *
      * @throws {@link Letta.UnprocessableEntityError}
      *
      * @example
-     *     await client.agents.messages.list("agent_id")
+     *     await client.agents.messages.list("agent-123e4567-e89b-42d3-8456-426614174000", {
+     *         before: "before",
+     *         after: "after",
+     *         limit: 1,
+     *         order: "asc",
+     *         orderBy: "created_at",
+     *         groupId: "group_id",
+     *         useAssistantMessage: true,
+     *         assistantMessageToolName: "assistant_message_tool_name",
+     *         assistantMessageToolKwarg: "assistant_message_tool_kwarg",
+     *         includeErr: true
+     *     })
      */
     list(agentId: string, request?: Letta.agents.MessagesListRequest, requestOptions?: Messages.RequestOptions): core.HttpResponsePromise<Letta.LettaMessageUnion[]>;
     private __list;
@@ -48,14 +59,14 @@ export declare class Messages {
      * Process a user message and return the agent's response.
      * This endpoint accepts a message from a user and processes it through the agent.
      *
-     * @param {string} agentId
+     * @param {string} agentId - The ID of the agent in the format 'agent-<uuid4>'
      * @param {Letta.LettaRequest} request
      * @param {Messages.RequestOptions} requestOptions - Request-specific configuration.
      *
      * @throws {@link Letta.UnprocessableEntityError}
      *
      * @example
-     *     await client.agents.messages.create("agent_id", {
+     *     await client.agents.messages.create("agent-123e4567-e89b-42d3-8456-426614174000", {
      *         messages: [{
      *                 role: "user",
      *                 content: [{
@@ -70,15 +81,15 @@ export declare class Messages {
     /**
      * Update the details of a message associated with an agent.
      *
-     * @param {string} agentId
-     * @param {string} messageId
+     * @param {string} agentId - The ID of the agent in the format 'agent-<uuid4>'
+     * @param {string} messageId - The ID of the message in the format 'message-<uuid4>'
      * @param {Letta.agents.MessagesModifyRequest} request
      * @param {Messages.RequestOptions} requestOptions - Request-specific configuration.
      *
      * @throws {@link Letta.UnprocessableEntityError}
      *
      * @example
-     *     await client.agents.messages.modify("agent_id", "message_id", {
+     *     await client.agents.messages.modify("agent-123e4567-e89b-42d3-8456-426614174000", "message-123e4567-e89b-42d3-8456-426614174000", {
      *         content: "content"
      *     })
      */
@@ -96,14 +107,14 @@ export declare class Messages {
      *
      * Note to cancel active runs associated with an agent, redis is required.
      *
-     * @param {string} agentId
+     * @param {string} agentId - The ID of the agent in the format 'agent-<uuid4>'
      * @param {Letta.agents.CancelAgentRunRequest} request
      * @param {Messages.RequestOptions} requestOptions - Request-specific configuration.
      *
      * @throws {@link Letta.UnprocessableEntityError}
      *
      * @example
-     *     await client.agents.messages.cancel("agent_id")
+     *     await client.agents.messages.cancel("agent-123e4567-e89b-42d3-8456-426614174000")
      */
     cancel(agentId: string, request?: Letta.agents.CancelAgentRunRequest, requestOptions?: Messages.RequestOptions): core.HttpResponsePromise<Record<string, unknown>>;
     private __cancel;
@@ -126,17 +137,16 @@ export declare class Messages {
      * Asynchronously process a user message and return a run object.
      * The actual processing happens in the background, and the status can be checked using the run ID.
      *
-     * This is "asynchronous" in the sense that it's a background job and explicitly must be fetched by the run ID.
-     * This is more like `send_message_job`
+     * This is "asynchronous" in the sense that it's a background run and explicitly must be fetched by the run ID.
      *
-     * @param {string} agentId
+     * @param {string} agentId - The ID of the agent in the format 'agent-<uuid4>'
      * @param {Letta.agents.LettaAsyncRequest} request
      * @param {Messages.RequestOptions} requestOptions - Request-specific configuration.
      *
      * @throws {@link Letta.UnprocessableEntityError}
      *
      * @example
-     *     await client.agents.messages.createAsync("agent_id", {
+     *     await client.agents.messages.createAsync("agent-123e4567-e89b-42d3-8456-426614174000", {
      *         messages: [{
      *                 role: "user",
      *                 content: [{
@@ -151,14 +161,16 @@ export declare class Messages {
     /**
      * Resets the messages for an agent
      *
-     * @param {string} agentId
+     * @param {string} agentId - The ID of the agent in the format 'agent-<uuid4>'
      * @param {Letta.agents.MessagesResetRequest} request
      * @param {Messages.RequestOptions} requestOptions - Request-specific configuration.
      *
      * @throws {@link Letta.UnprocessableEntityError}
      *
      * @example
-     *     await client.agents.messages.reset("agent_id")
+     *     await client.agents.messages.reset("agent-123e4567-e89b-42d3-8456-426614174000", {
+     *         addDefaultInitialMessages: true
+     *     })
      */
     reset(agentId: string, request?: Letta.agents.MessagesResetRequest, requestOptions?: Messages.RequestOptions): core.HttpResponsePromise<Letta.AgentState>;
     private __reset;
@@ -169,14 +181,14 @@ export declare class Messages {
      * the LLM request, then returns the raw request payload that would
      * be sent to the LLM provider. Useful for debugging and inspection.
      *
-     * @param {string} agentId
+     * @param {string} agentId - The ID of the agent in the format 'agent-<uuid4>'
      * @param {Letta.agents.MessagesPreviewRequest} request
      * @param {Messages.RequestOptions} requestOptions - Request-specific configuration.
      *
      * @throws {@link Letta.UnprocessableEntityError}
      *
      * @example
-     *     await client.agents.messages.preview("agent_id", {
+     *     await client.agents.messages.preview("agent-123e4567-e89b-42d3-8456-426614174000", {
      *         messages: [{
      *                 role: "user",
      *                 content: [{
@@ -194,14 +206,14 @@ export declare class Messages {
      * This endpoint summarizes the current message history for a given agent,
      * truncating and compressing it down to the specified `max_message_length`.
      *
-     * @param {string} agentId
+     * @param {string} agentId - The ID of the agent in the format 'agent-<uuid4>'
      * @param {Letta.agents.MessagesSummarizeRequest} request
      * @param {Messages.RequestOptions} requestOptions - Request-specific configuration.
      *
      * @throws {@link Letta.UnprocessableEntityError}
      *
      * @example
-     *     await client.agents.messages.summarize("agent_id", {
+     *     await client.agents.messages.summarize("agent-123e4567-e89b-42d3-8456-426614174000", {
      *         maxMessageLength: 1
      *     })
      */

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

@@ -52,8 +52,8 @@ exports.Messages = 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 Messages {
     constructor(_options = {}) {
@@ -62,14 +62,25 @@ class Messages {
     /**
      * Retrieve message history for an agent.
      *
-     * @param {string} agentId
+     * @param {string} agentId - The ID of the agent in the format 'agent-<uuid4>'
      * @param {Letta.agents.MessagesListRequest} request
      * @param {Messages.RequestOptions} requestOptions - Request-specific configuration.
      *
      * @throws {@link Letta.UnprocessableEntityError}
      *
      * @example
-     *     await client.agents.messages.list("agent_id")
+     *     await client.agents.messages.list("agent-123e4567-e89b-42d3-8456-426614174000", {
+     *         before: "before",
+     *         after: "after",
+     *         limit: 1,
+     *         order: "asc",
+     *         orderBy: "created_at",
+     *         groupId: "group_id",
+     *         useAssistantMessage: true,
+     *         assistantMessageToolName: "assistant_message_tool_name",
+     *         assistantMessageToolKwarg: "assistant_message_tool_kwarg",
+     *         includeErr: true
+     *     })
      */
     list(agentId, request = {}, requestOptions) {
         return core.HttpResponsePromise.fromPromise(this.__list(agentId, request, requestOptions));
@@ -77,17 +88,25 @@ class Messages {
     __list(agentId_1) {
         return __awaiter(this, arguments, void 0, function* (agentId, request = {}, requestOptions) {
             var _a, _b, _c;
-            const { after, before, limit, groupId, useAssistantMessage, assistantMessageToolName, assistantMessageToolKwarg, includeErr, } = request;
+            const { before, after, limit, order, orderBy, groupId, useAssistantMessage, assistantMessageToolName, assistantMessageToolKwarg, includeErr, } = request;
             const _queryParams = {};
-            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.agents.MessagesListRequestOrder.jsonOrThrow(order, {
+                    unrecognizedObjectKeys: "strip",
+                });
+            }
+            if (orderBy != null) {
+                _queryParams["order_by"] = orderBy;
+            }
             if (groupId != null) {
                 _queryParams["group_id"] = groupId;
             }
@@ -108,7 +127,7 @@ class Messages {
                 method: "GET",
                 headers: Object.assign(Object.assign({ "X-Project": (yield core.Supplier.get(this._options.project)) != null
                         ? yield core.Supplier.get(this._options.project)
-                        : undefined, "X-Fern-Language": "JavaScript", "X-Fern-SDK-Name": "@letta-ai/letta-client", "X-Fern-SDK-Version": "0.0.68663", "User-Agent": "@letta-ai/letta-client/0.0.68663", "X-Fern-Runtime": core.RUNTIME.type, "X-Fern-Runtime-Version": core.RUNTIME.version }, (yield this._getCustomAuthorizationHeaders())), requestOptions === null || requestOptions === void 0 ? void 0 : requestOptions.headers),
+                        : undefined, "X-Fern-Language": "JavaScript", "X-Fern-SDK-Name": "@letta-ai/letta-client", "X-Fern-SDK-Version": "0.0.68665", "User-Agent": "@letta-ai/letta-client/0.0.68665", "X-Fern-Runtime": core.RUNTIME.type, "X-Fern-Runtime-Version": core.RUNTIME.version }, (yield this._getCustomAuthorizationHeaders())), requestOptions === null || requestOptions === void 0 ? void 0 : requestOptions.headers),
                 contentType: "application/json",
                 queryParameters: _queryParams,
                 requestType: "json",
@@ -167,14 +186,14 @@ class Messages {
      * Process a user message and return the agent's response.
      * This endpoint accepts a message from a user and processes it through the agent.
      *
-     * @param {string} agentId
+     * @param {string} agentId - The ID of the agent in the format 'agent-<uuid4>'
      * @param {Letta.LettaRequest} request
      * @param {Messages.RequestOptions} requestOptions - Request-specific configuration.
      *
      * @throws {@link Letta.UnprocessableEntityError}
      *
      * @example
-     *     await client.agents.messages.create("agent_id", {
+     *     await client.agents.messages.create("agent-123e4567-e89b-42d3-8456-426614174000", {
      *         messages: [{
      *                 role: "user",
      *                 content: [{
@@ -195,7 +214,7 @@ class Messages {
                 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": "0.0.68663", "User-Agent": "@letta-ai/letta-client/0.0.68663", "X-Fern-Runtime": core.RUNTIME.type, "X-Fern-Runtime-Version": core.RUNTIME.version }, (yield this._getCustomAuthorizationHeaders())), requestOptions === null || requestOptions === void 0 ? void 0 : requestOptions.headers),
+                        : undefined, "X-Fern-Language": "JavaScript", "X-Fern-SDK-Name": "@letta-ai/letta-client", "X-Fern-SDK-Version": "0.0.68665", "User-Agent": "@letta-ai/letta-client/0.0.68665", "X-Fern-Runtime": core.RUNTIME.type, "X-Fern-Runtime-Version": core.RUNTIME.version }, (yield this._getCustomAuthorizationHeaders())), requestOptions === null || requestOptions === void 0 ? void 0 : requestOptions.headers),
                 contentType: "application/json",
                 requestType: "json",
                 body: serializers.LettaRequest.jsonOrThrow(request, { unrecognizedObjectKeys: "strip" }),
@@ -253,15 +272,15 @@ class Messages {
     /**
      * Update the details of a message associated with an agent.
      *
-     * @param {string} agentId
-     * @param {string} messageId
+     * @param {string} agentId - The ID of the agent in the format 'agent-<uuid4>'
+     * @param {string} messageId - The ID of the message in the format 'message-<uuid4>'
      * @param {Letta.agents.MessagesModifyRequest} request
      * @param {Messages.RequestOptions} requestOptions - Request-specific configuration.
      *
      * @throws {@link Letta.UnprocessableEntityError}
      *
      * @example
-     *     await client.agents.messages.modify("agent_id", "message_id", {
+     *     await client.agents.messages.modify("agent-123e4567-e89b-42d3-8456-426614174000", "message-123e4567-e89b-42d3-8456-426614174000", {
      *         content: "content"
      *     })
      */
@@ -276,7 +295,7 @@ class Messages {
                 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": "0.0.68663", "User-Agent": "@letta-ai/letta-client/0.0.68663", "X-Fern-Runtime": core.RUNTIME.type, "X-Fern-Runtime-Version": core.RUNTIME.version }, (yield this._getCustomAuthorizationHeaders())), requestOptions === null || requestOptions === void 0 ? void 0 : requestOptions.headers),
+                        : undefined, "X-Fern-Language": "JavaScript", "X-Fern-SDK-Name": "@letta-ai/letta-client", "X-Fern-SDK-Version": "0.0.68665", "User-Agent": "@letta-ai/letta-client/0.0.68665", "X-Fern-Runtime": core.RUNTIME.type, "X-Fern-Runtime-Version": core.RUNTIME.version }, (yield this._getCustomAuthorizationHeaders())), requestOptions === null || requestOptions === void 0 ? void 0 : requestOptions.headers),
                 contentType: "application/json",
                 requestType: "json",
                 body: serializers.agents.MessagesModifyRequest.jsonOrThrow(request, { unrecognizedObjectKeys: "strip" }),
@@ -347,7 +366,7 @@ class Messages {
                 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": "0.0.68663", "User-Agent": "@letta-ai/letta-client/0.0.68663", "X-Fern-Runtime": core.RUNTIME.type, "X-Fern-Runtime-Version": core.RUNTIME.version }, (yield this._getCustomAuthorizationHeaders())), requestOptions === null || requestOptions === void 0 ? void 0 : requestOptions.headers),
+                        : undefined, "X-Fern-Language": "JavaScript", "X-Fern-SDK-Name": "@letta-ai/letta-client", "X-Fern-SDK-Version": "0.0.68665", "User-Agent": "@letta-ai/letta-client/0.0.68665", "X-Fern-Runtime": core.RUNTIME.type, "X-Fern-Runtime-Version": core.RUNTIME.version }, (yield this._getCustomAuthorizationHeaders())), requestOptions === null || requestOptions === void 0 ? void 0 : requestOptions.headers),
                 contentType: "application/json",
                 requestType: "json",
                 body: serializers.LettaStreamingRequest.jsonOrThrow(request, { unrecognizedObjectKeys: "strip" }),
@@ -418,14 +437,14 @@ class Messages {
      *
      * Note to cancel active runs associated with an agent, redis is required.
      *
-     * @param {string} agentId
+     * @param {string} agentId - The ID of the agent in the format 'agent-<uuid4>'
      * @param {Letta.agents.CancelAgentRunRequest} request
      * @param {Messages.RequestOptions} requestOptions - Request-specific configuration.
      *
      * @throws {@link Letta.UnprocessableEntityError}
      *
      * @example
-     *     await client.agents.messages.cancel("agent_id")
+     *     await client.agents.messages.cancel("agent-123e4567-e89b-42d3-8456-426614174000")
      */
     cancel(agentId, request = {}, requestOptions) {
         return core.HttpResponsePromise.fromPromise(this.__cancel(agentId, request, requestOptions));
@@ -438,7 +457,7 @@ class Messages {
                 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": "0.0.68663", "User-Agent": "@letta-ai/letta-client/0.0.68663", "X-Fern-Runtime": core.RUNTIME.type, "X-Fern-Runtime-Version": core.RUNTIME.version }, (yield this._getCustomAuthorizationHeaders())), requestOptions === null || requestOptions === void 0 ? void 0 : requestOptions.headers),
+                        : undefined, "X-Fern-Language": "JavaScript", "X-Fern-SDK-Name": "@letta-ai/letta-client", "X-Fern-SDK-Version": "0.0.68665", "User-Agent": "@letta-ai/letta-client/0.0.68665", "X-Fern-Runtime": core.RUNTIME.type, "X-Fern-Runtime-Version": core.RUNTIME.version }, (yield this._getCustomAuthorizationHeaders())), requestOptions === null || requestOptions === void 0 ? void 0 : requestOptions.headers),
                 contentType: "application/json",
                 requestType: "json",
                 body: serializers.agents.CancelAgentRunRequest.jsonOrThrow(request, { unrecognizedObjectKeys: "strip" }),
@@ -517,7 +536,7 @@ class Messages {
                 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": "0.0.68663", "User-Agent": "@letta-ai/letta-client/0.0.68663", "X-Fern-Runtime": core.RUNTIME.type, "X-Fern-Runtime-Version": core.RUNTIME.version }, (yield this._getCustomAuthorizationHeaders())), requestOptions === null || requestOptions === void 0 ? void 0 : requestOptions.headers),
+                        : undefined, "X-Fern-Language": "JavaScript", "X-Fern-SDK-Name": "@letta-ai/letta-client", "X-Fern-SDK-Version": "0.0.68665", "User-Agent": "@letta-ai/letta-client/0.0.68665", "X-Fern-Runtime": core.RUNTIME.type, "X-Fern-Runtime-Version": core.RUNTIME.version }, (yield this._getCustomAuthorizationHeaders())), requestOptions === null || requestOptions === void 0 ? void 0 : requestOptions.headers),
                 contentType: "application/json",
                 requestType: "json",
                 body: serializers.agents.MessageSearchRequest.jsonOrThrow(request, { unrecognizedObjectKeys: "strip" }),
@@ -576,17 +595,16 @@ class Messages {
      * Asynchronously process a user message and return a run object.
      * The actual processing happens in the background, and the status can be checked using the run ID.
      *
-     * This is "asynchronous" in the sense that it's a background job and explicitly must be fetched by the run ID.
-     * This is more like `send_message_job`
+     * This is "asynchronous" in the sense that it's a background run and explicitly must be fetched by the run ID.
      *
-     * @param {string} agentId
+     * @param {string} agentId - The ID of the agent in the format 'agent-<uuid4>'
      * @param {Letta.agents.LettaAsyncRequest} request
      * @param {Messages.RequestOptions} requestOptions - Request-specific configuration.
      *
      * @throws {@link Letta.UnprocessableEntityError}
      *
      * @example
-     *     await client.agents.messages.createAsync("agent_id", {
+     *     await client.agents.messages.createAsync("agent-123e4567-e89b-42d3-8456-426614174000", {
      *         messages: [{
      *                 role: "user",
      *                 content: [{
@@ -607,7 +625,7 @@ class Messages {
                 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": "0.0.68663", "User-Agent": "@letta-ai/letta-client/0.0.68663", "X-Fern-Runtime": core.RUNTIME.type, "X-Fern-Runtime-Version": core.RUNTIME.version }, (yield this._getCustomAuthorizationHeaders())), requestOptions === null || requestOptions === void 0 ? void 0 : requestOptions.headers),
+                        : undefined, "X-Fern-Language": "JavaScript", "X-Fern-SDK-Name": "@letta-ai/letta-client", "X-Fern-SDK-Version": "0.0.68665", "User-Agent": "@letta-ai/letta-client/0.0.68665", "X-Fern-Runtime": core.RUNTIME.type, "X-Fern-Runtime-Version": core.RUNTIME.version }, (yield this._getCustomAuthorizationHeaders())), requestOptions === null || requestOptions === void 0 ? void 0 : requestOptions.headers),
                 contentType: "application/json",
                 requestType: "json",
                 body: serializers.agents.LettaAsyncRequest.jsonOrThrow(request, { unrecognizedObjectKeys: "strip" }),
@@ -665,14 +683,16 @@ class Messages {
     /**
      * Resets the messages for an agent
      *
-     * @param {string} agentId
+     * @param {string} agentId - The ID of the agent in the format 'agent-<uuid4>'
      * @param {Letta.agents.MessagesResetRequest} request
      * @param {Messages.RequestOptions} requestOptions - Request-specific configuration.
      *
      * @throws {@link Letta.UnprocessableEntityError}
      *
      * @example
-     *     await client.agents.messages.reset("agent_id")
+     *     await client.agents.messages.reset("agent-123e4567-e89b-42d3-8456-426614174000", {
+     *         addDefaultInitialMessages: true
+     *     })
      */
     reset(agentId, request = {}, requestOptions) {
         return core.HttpResponsePromise.fromPromise(this.__reset(agentId, request, requestOptions));
@@ -690,7 +710,7 @@ class Messages {
                 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": "0.0.68663", "User-Agent": "@letta-ai/letta-client/0.0.68663", "X-Fern-Runtime": core.RUNTIME.type, "X-Fern-Runtime-Version": core.RUNTIME.version }, (yield this._getCustomAuthorizationHeaders())), requestOptions === null || requestOptions === void 0 ? void 0 : requestOptions.headers),
+                        : undefined, "X-Fern-Language": "JavaScript", "X-Fern-SDK-Name": "@letta-ai/letta-client", "X-Fern-SDK-Version": "0.0.68665", "User-Agent": "@letta-ai/letta-client/0.0.68665", "X-Fern-Runtime": core.RUNTIME.type, "X-Fern-Runtime-Version": core.RUNTIME.version }, (yield this._getCustomAuthorizationHeaders())), requestOptions === null || requestOptions === void 0 ? void 0 : requestOptions.headers),
                 contentType: "application/json",
                 queryParameters: _queryParams,
                 requestType: "json",
@@ -752,14 +772,14 @@ class Messages {
      * the LLM request, then returns the raw request payload that would
      * be sent to the LLM provider. Useful for debugging and inspection.
      *
-     * @param {string} agentId
+     * @param {string} agentId - The ID of the agent in the format 'agent-<uuid4>'
      * @param {Letta.agents.MessagesPreviewRequest} request
      * @param {Messages.RequestOptions} requestOptions - Request-specific configuration.
      *
      * @throws {@link Letta.UnprocessableEntityError}
      *
      * @example
-     *     await client.agents.messages.preview("agent_id", {
+     *     await client.agents.messages.preview("agent-123e4567-e89b-42d3-8456-426614174000", {
      *         messages: [{
      *                 role: "user",
      *                 content: [{
@@ -780,7 +800,7 @@ class Messages {
                 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": "0.0.68663", "User-Agent": "@letta-ai/letta-client/0.0.68663", "X-Fern-Runtime": core.RUNTIME.type, "X-Fern-Runtime-Version": core.RUNTIME.version }, (yield this._getCustomAuthorizationHeaders())), requestOptions === null || requestOptions === void 0 ? void 0 : requestOptions.headers),
+                        : undefined, "X-Fern-Language": "JavaScript", "X-Fern-SDK-Name": "@letta-ai/letta-client", "X-Fern-SDK-Version": "0.0.68665", "User-Agent": "@letta-ai/letta-client/0.0.68665", "X-Fern-Runtime": core.RUNTIME.type, "X-Fern-Runtime-Version": core.RUNTIME.version }, (yield this._getCustomAuthorizationHeaders())), requestOptions === null || requestOptions === void 0 ? void 0 : requestOptions.headers),
                 contentType: "application/json",
                 requestType: "json",
                 body: serializers.agents.MessagesPreviewRequest.jsonOrThrow(request, { unrecognizedObjectKeys: "strip" }),
@@ -841,14 +861,14 @@ class Messages {
      * This endpoint summarizes the current message history for a given agent,
      * truncating and compressing it down to the specified `max_message_length`.
      *
-     * @param {string} agentId
+     * @param {string} agentId - The ID of the agent in the format 'agent-<uuid4>'
      * @param {Letta.agents.MessagesSummarizeRequest} request
      * @param {Messages.RequestOptions} requestOptions - Request-specific configuration.
      *
      * @throws {@link Letta.UnprocessableEntityError}
      *
      * @example
-     *     await client.agents.messages.summarize("agent_id", {
+     *     await client.agents.messages.summarize("agent-123e4567-e89b-42d3-8456-426614174000", {
      *         maxMessageLength: 1
      *     })
      */
@@ -866,7 +886,7 @@ class Messages {
                 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": "0.0.68663", "User-Agent": "@letta-ai/letta-client/0.0.68663", "X-Fern-Runtime": core.RUNTIME.type, "X-Fern-Runtime-Version": core.RUNTIME.version }, (yield this._getCustomAuthorizationHeaders())), requestOptions === null || requestOptions === void 0 ? void 0 : requestOptions.headers),
+                        : undefined, "X-Fern-Language": "JavaScript", "X-Fern-SDK-Name": "@letta-ai/letta-client", "X-Fern-SDK-Version": "0.0.68665", "User-Agent": "@letta-ai/letta-client/0.0.68665", "X-Fern-Runtime": core.RUNTIME.type, "X-Fern-Runtime-Version": core.RUNTIME.version }, (yield this._getCustomAuthorizationHeaders())), requestOptions === null || requestOptions === void 0 ? void 0 : requestOptions.headers),
                 contentType: "application/json",
                 queryParameters: _queryParams,
                 requestType: "json",

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

@@ -1,23 +1,43 @@
 /**
  * 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",
+ *         groupId: "group_id",
+ *         useAssistantMessage: true,
+ *         assistantMessageToolName: "assistant_message_tool_name",
+ *         assistantMessageToolKwarg: "assistant_message_tool_kwarg",
+ *         includeErr: true
+ *     }
  */
 export interface MessagesListRequest {
     /**
-     * Message after which to retrieve the returned messages.
+     * Message ID cursor for pagination. Returns messages that come before this message ID in the specified sort order
      */
-    after?: string;
+    before?: string;
     /**
-     * Message before which to retrieve the returned messages.
+     * Message ID cursor for pagination. Returns messages that come after this message ID in the specified sort order
      */
-    before?: string;
+    after?: string;
     /**
-     * Maximum number of messages to retrieve.
+     * Maximum number of messages to return
      */
     limit?: number;
+    /**
+     * Sort order for messages by creation time. 'asc' for oldest first, 'desc' for newest first
+     */
+    order?: Letta.agents.MessagesListRequestOrder;
+    /**
+     * Field to sort by
+     */
+    orderBy?: "created_at";
     /**
      * Group ID to filter messages by.
      */

package/api/resources/agents/resources/messages/client/requests/MessagesResetRequest.d.ts

@@ -3,7 +3,9 @@
  */
 /**
  * @example
- *     {}
+ *     {
+ *         addDefaultInitialMessages: true
+ *     }
  */
 export interface MessagesResetRequest {
     /**

package/api/resources/agents/resources/messages/types/MessagesListRequestOrder.d.ts

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

package/api/resources/agents/resources/messages/types/MessagesListRequestOrder.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.MessagesListRequestOrder = void 0;
+exports.MessagesListRequestOrder = {
+    Asc: "asc",
+    Desc: "desc",
+};

package/api/resources/agents/resources/messages/types/index.d.ts

@@ -1,3 +1,4 @@
+export * from "./MessagesListRequestOrder";
 export * from "./MessagesModifyRequest";
 export * from "./MessagesModifyResponse";
 export * from "./LettaStreamingResponse";

package/api/resources/agents/resources/messages/types/index.js

@@ -14,6 +14,7 @@ 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("./MessagesListRequestOrder"), exports);
 __exportStar(require("./MessagesModifyRequest"), exports);
 __exportStar(require("./MessagesModifyResponse"), exports);
 __exportStar(require("./LettaStreamingResponse"), exports);