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

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

@@ -65,13 +65,13 @@ class Files {
      * This endpoint updates the file state for the agent so that no files are marked as open.
      * Typically used to reset the working memory view for the agent.
      *
-     * @param {string} agentId
+     * @param {string} agentId - The ID of the agent in the format 'agent-<uuid4>'
      * @param {Files.RequestOptions} requestOptions - Request-specific configuration.
      *
      * @throws {@link Letta.UnprocessableEntityError}
      *
      * @example
-     *     await client.agents.files.closeAll("agent_id")
+     *     await client.agents.files.closeAll("agent-123e4567-e89b-42d3-8456-426614174000")
      */
     closeAll(agentId, requestOptions) {
         return core.HttpResponsePromise.fromPromise(this.__closeAll(agentId, requestOptions));
@@ -84,7 +84,7 @@ class Files {
                 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.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),
+                        : undefined, "X-Fern-Language": "JavaScript", "X-Fern-SDK-Name": "@letta-ai/letta-client", "X-Fern-SDK-Version": "1.0.0-alpha.4", "User-Agent": "@letta-ai/letta-client/1.0.0-alpha.4", "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,
@@ -145,14 +145,14 @@ class Files {
      * The file will be included in the agent's working memory view.
      * Returns a list of file names that were closed due to LRU eviction.
      *
-     * @param {string} agentId
-     * @param {string} fileId
+     * @param {string} agentId - The ID of the agent in the format 'agent-<uuid4>'
+     * @param {string} fileId - The ID of the file in the format 'file-<uuid4>'
      * @param {Files.RequestOptions} requestOptions - Request-specific configuration.
      *
      * @throws {@link Letta.UnprocessableEntityError}
      *
      * @example
-     *     await client.agents.files.open("agent_id", "file_id")
+     *     await client.agents.files.open("agent-123e4567-e89b-42d3-8456-426614174000", "file-123e4567-e89b-42d3-8456-426614174000")
      */
     open(agentId, fileId, requestOptions) {
         return core.HttpResponsePromise.fromPromise(this.__open(agentId, fileId, requestOptions));
@@ -165,7 +165,7 @@ class Files {
                 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.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),
+                        : undefined, "X-Fern-Language": "JavaScript", "X-Fern-SDK-Name": "@letta-ai/letta-client", "X-Fern-SDK-Version": "1.0.0-alpha.4", "User-Agent": "@letta-ai/letta-client/1.0.0-alpha.4", "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,
@@ -225,14 +225,14 @@ class Files {
      * This endpoint marks a specific file as closed in the agent's file state.
      * The file will be removed from the agent's working memory view.
      *
-     * @param {string} agentId
-     * @param {string} fileId
+     * @param {string} agentId - The ID of the agent in the format 'agent-<uuid4>'
+     * @param {string} fileId - The ID of the file in the format 'file-<uuid4>'
      * @param {Files.RequestOptions} requestOptions - Request-specific configuration.
      *
      * @throws {@link Letta.UnprocessableEntityError}
      *
      * @example
-     *     await client.agents.files.close("agent_id", "file_id")
+     *     await client.agents.files.close("agent-123e4567-e89b-42d3-8456-426614174000", "file-123e4567-e89b-42d3-8456-426614174000")
      */
     close(agentId, fileId, requestOptions) {
         return core.HttpResponsePromise.fromPromise(this.__close(agentId, fileId, requestOptions));
@@ -245,7 +245,7 @@ class Files {
                 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.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),
+                        : undefined, "X-Fern-Language": "JavaScript", "X-Fern-SDK-Name": "@letta-ai/letta-client", "X-Fern-SDK-Version": "1.0.0-alpha.4", "User-Agent": "@letta-ai/letta-client/1.0.0-alpha.4", "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,
@@ -293,14 +293,14 @@ class Files {
     /**
      * Get the files attached to an agent with their open/closed status (paginated).
      *
-     * @param {string} agentId
+     * @param {string} agentId - The ID of the agent in the format 'agent-<uuid4>'
      * @param {Letta.agents.FilesListRequest} request
      * @param {Files.RequestOptions} requestOptions - Request-specific configuration.
      *
      * @throws {@link Letta.UnprocessableEntityError}
      *
      * @example
-     *     await client.agents.files.list("agent_id", {
+     *     await client.agents.files.list("agent-123e4567-e89b-42d3-8456-426614174000", {
      *         before: "before",
      *         after: "after",
      *         limit: 1,
@@ -346,7 +346,7 @@ class Files {
                 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),
+                        : undefined, "X-Fern-Language": "JavaScript", "X-Fern-SDK-Name": "@letta-ai/letta-client", "X-Fern-SDK-Version": "1.0.0-alpha.4", "User-Agent": "@letta-ai/letta-client/1.0.0-alpha.4", "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/folders/client/Client.d.ts

@@ -33,42 +33,42 @@ export declare class Folders {
     /**
      * Attach a folder to an agent.
      *
-     * @param {string} agentId
-     * @param {string} folderId
+     * @param {string} agentId - The ID of the source in the format 'source-<uuid4>'
+     * @param {string} folderId - The ID of the agent in the format 'agent-<uuid4>'
      * @param {Folders.RequestOptions} requestOptions - Request-specific configuration.
      *
      * @throws {@link Letta.UnprocessableEntityError}
      *
      * @example
-     *     await client.agents.folders.attach("agent_id", "folder_id")
+     *     await client.agents.folders.attach("source-123e4567-e89b-42d3-8456-426614174000", "agent-123e4567-e89b-42d3-8456-426614174000")
      */
     attach(agentId: string, folderId: string, requestOptions?: Folders.RequestOptions): core.HttpResponsePromise<Letta.AgentState>;
     private __attach;
     /**
      * Detach a folder from an agent.
      *
-     * @param {string} agentId
-     * @param {string} folderId
+     * @param {string} agentId - The ID of the source in the format 'source-<uuid4>'
+     * @param {string} folderId - The ID of the agent in the format 'agent-<uuid4>'
      * @param {Folders.RequestOptions} requestOptions - Request-specific configuration.
      *
      * @throws {@link Letta.UnprocessableEntityError}
      *
      * @example
-     *     await client.agents.folders.detach("agent_id", "folder_id")
+     *     await client.agents.folders.detach("source-123e4567-e89b-42d3-8456-426614174000", "agent-123e4567-e89b-42d3-8456-426614174000")
      */
     detach(agentId: string, folderId: string, requestOptions?: Folders.RequestOptions): core.HttpResponsePromise<Letta.AgentState>;
     private __detach;
     /**
      * Get the folders associated with an agent.
      *
-     * @param {string} agentId
+     * @param {string} agentId - The ID of the agent in the format 'agent-<uuid4>'
      * @param {Letta.agents.FoldersListRequest} request
      * @param {Folders.RequestOptions} requestOptions - Request-specific configuration.
      *
      * @throws {@link Letta.UnprocessableEntityError}
      *
      * @example
-     *     await client.agents.folders.list("agent_id", {
+     *     await client.agents.folders.list("agent-123e4567-e89b-42d3-8456-426614174000", {
      *         before: "before",
      *         after: "after",
      *         limit: 1,

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

@@ -62,14 +62,14 @@ class Folders {
     /**
      * Attach a folder to an agent.
      *
-     * @param {string} agentId
-     * @param {string} folderId
+     * @param {string} agentId - The ID of the source in the format 'source-<uuid4>'
+     * @param {string} folderId - The ID of the agent in the format 'agent-<uuid4>'
      * @param {Folders.RequestOptions} requestOptions - Request-specific configuration.
      *
      * @throws {@link Letta.UnprocessableEntityError}
      *
      * @example
-     *     await client.agents.folders.attach("agent_id", "folder_id")
+     *     await client.agents.folders.attach("source-123e4567-e89b-42d3-8456-426614174000", "agent-123e4567-e89b-42d3-8456-426614174000")
      */
     attach(agentId, folderId, requestOptions) {
         return core.HttpResponsePromise.fromPromise(this.__attach(agentId, folderId, requestOptions));
@@ -82,7 +82,7 @@ class Folders {
                 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.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),
+                        : undefined, "X-Fern-Language": "JavaScript", "X-Fern-SDK-Name": "@letta-ai/letta-client", "X-Fern-SDK-Version": "1.0.0-alpha.4", "User-Agent": "@letta-ai/letta-client/1.0.0-alpha.4", "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,
@@ -139,14 +139,14 @@ class Folders {
     /**
      * Detach a folder from an agent.
      *
-     * @param {string} agentId
-     * @param {string} folderId
+     * @param {string} agentId - The ID of the source in the format 'source-<uuid4>'
+     * @param {string} folderId - The ID of the agent in the format 'agent-<uuid4>'
      * @param {Folders.RequestOptions} requestOptions - Request-specific configuration.
      *
      * @throws {@link Letta.UnprocessableEntityError}
      *
      * @example
-     *     await client.agents.folders.detach("agent_id", "folder_id")
+     *     await client.agents.folders.detach("source-123e4567-e89b-42d3-8456-426614174000", "agent-123e4567-e89b-42d3-8456-426614174000")
      */
     detach(agentId, folderId, requestOptions) {
         return core.HttpResponsePromise.fromPromise(this.__detach(agentId, folderId, requestOptions));
@@ -159,7 +159,7 @@ class Folders {
                 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.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),
+                        : undefined, "X-Fern-Language": "JavaScript", "X-Fern-SDK-Name": "@letta-ai/letta-client", "X-Fern-SDK-Version": "1.0.0-alpha.4", "User-Agent": "@letta-ai/letta-client/1.0.0-alpha.4", "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,
@@ -216,14 +216,14 @@ class Folders {
     /**
      * Get the folders associated with an agent.
      *
-     * @param {string} agentId
+     * @param {string} agentId - The ID of the agent in the format 'agent-<uuid4>'
      * @param {Letta.agents.FoldersListRequest} request
      * @param {Folders.RequestOptions} requestOptions - Request-specific configuration.
      *
      * @throws {@link Letta.UnprocessableEntityError}
      *
      * @example
-     *     await client.agents.folders.list("agent_id", {
+     *     await client.agents.folders.list("agent-123e4567-e89b-42d3-8456-426614174000", {
      *         before: "before",
      *         after: "after",
      *         limit: 1,
@@ -261,7 +261,7 @@ class Folders {
                 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),
+                        : undefined, "X-Fern-Language": "JavaScript", "X-Fern-SDK-Name": "@letta-ai/letta-client", "X-Fern-SDK-Version": "1.0.0-alpha.4", "User-Agent": "@letta-ai/letta-client/1.0.0-alpha.4", "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/groups/client/Client.d.ts

@@ -33,14 +33,14 @@ export declare class Groups {
     /**
      * Lists the groups for an agent
      *
-     * @param {string} agentId
+     * @param {string} agentId - The ID of the agent in the format 'agent-<uuid4>'
      * @param {Letta.agents.GroupsListRequest} request
      * @param {Groups.RequestOptions} requestOptions - Request-specific configuration.
      *
      * @throws {@link Letta.UnprocessableEntityError}
      *
      * @example
-     *     await client.agents.groups.list("agent_id", {
+     *     await client.agents.groups.list("agent-123e4567-e89b-42d3-8456-426614174000", {
      *         managerType: "manager_type",
      *         before: "before",
      *         after: "after",

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

@@ -62,14 +62,14 @@ class Groups {
     /**
      * Lists the groups for an agent
      *
-     * @param {string} agentId
+     * @param {string} agentId - The ID of the agent in the format 'agent-<uuid4>'
      * @param {Letta.agents.GroupsListRequest} request
      * @param {Groups.RequestOptions} requestOptions - Request-specific configuration.
      *
      * @throws {@link Letta.UnprocessableEntityError}
      *
      * @example
-     *     await client.agents.groups.list("agent_id", {
+     *     await client.agents.groups.list("agent-123e4567-e89b-42d3-8456-426614174000", {
      *         managerType: "manager_type",
      *         before: "before",
      *         after: "after",
@@ -111,7 +111,7 @@ class Groups {
                 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),
+                        : undefined, "X-Fern-Language": "JavaScript", "X-Fern-SDK-Name": "@letta-ai/letta-client", "X-Fern-SDK-Version": "1.0.0-alpha.4", "User-Agent": "@letta-ai/letta-client/1.0.0-alpha.4", "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/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": "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),
+                        : undefined, "X-Fern-Language": "JavaScript", "X-Fern-SDK-Name": "@letta-ai/letta-client", "X-Fern-SDK-Version": "1.0.0-alpha.4", "User-Agent": "@letta-ai/letta-client/1.0.0-alpha.4", "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,14 @@ 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,
@@ -59,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: [{
@@ -81,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"
      *     })
      */
@@ -107,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;
@@ -139,14 +139,14 @@ export declare class Messages {
      *
      * 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: [{
@@ -161,14 +161,14 @@ 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
      *     })
      */
@@ -181,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: [{
@@ -206,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
      *     })
      */