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

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

@@ -62,14 +62,14 @@ 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,
@@ -127,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": "1.0.0-alpha.2", "User-Agent": "@letta-ai/letta-client/1.0.0-alpha.2", "X-Fern-Runtime": core.RUNTIME.type, "X-Fern-Runtime-Version": core.RUNTIME.version }, (yield this._getCustomAuthorizationHeaders())), requestOptions === null || requestOptions === void 0 ? void 0 : requestOptions.headers),
+                        : 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",
@@ -186,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: [{
@@ -214,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": "1.0.0-alpha.2", "User-Agent": "@letta-ai/letta-client/1.0.0-alpha.2", "X-Fern-Runtime": core.RUNTIME.type, "X-Fern-Runtime-Version": core.RUNTIME.version }, (yield this._getCustomAuthorizationHeaders())), requestOptions === null || requestOptions === void 0 ? void 0 : requestOptions.headers),
+                        : 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",
                 body: serializers.LettaRequest.jsonOrThrow(request, { unrecognizedObjectKeys: "strip" }),
@@ -272,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"
      *     })
      */
@@ -295,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": "1.0.0-alpha.2", "User-Agent": "@letta-ai/letta-client/1.0.0-alpha.2", "X-Fern-Runtime": core.RUNTIME.type, "X-Fern-Runtime-Version": core.RUNTIME.version }, (yield this._getCustomAuthorizationHeaders())), requestOptions === null || requestOptions === void 0 ? void 0 : requestOptions.headers),
+                        : 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",
                 body: serializers.agents.MessagesModifyRequest.jsonOrThrow(request, { unrecognizedObjectKeys: "strip" }),
@@ -366,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": "1.0.0-alpha.2", "User-Agent": "@letta-ai/letta-client/1.0.0-alpha.2", "X-Fern-Runtime": core.RUNTIME.type, "X-Fern-Runtime-Version": core.RUNTIME.version }, (yield this._getCustomAuthorizationHeaders())), requestOptions === null || requestOptions === void 0 ? void 0 : requestOptions.headers),
+                        : 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",
                 body: serializers.LettaStreamingRequest.jsonOrThrow(request, { unrecognizedObjectKeys: "strip" }),
@@ -437,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));
@@ -457,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": "1.0.0-alpha.2", "User-Agent": "@letta-ai/letta-client/1.0.0-alpha.2", "X-Fern-Runtime": core.RUNTIME.type, "X-Fern-Runtime-Version": core.RUNTIME.version }, (yield this._getCustomAuthorizationHeaders())), requestOptions === null || requestOptions === void 0 ? void 0 : requestOptions.headers),
+                        : 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",
                 body: serializers.agents.CancelAgentRunRequest.jsonOrThrow(request, { unrecognizedObjectKeys: "strip" }),
@@ -536,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": "1.0.0-alpha.2", "User-Agent": "@letta-ai/letta-client/1.0.0-alpha.2", "X-Fern-Runtime": core.RUNTIME.type, "X-Fern-Runtime-Version": core.RUNTIME.version }, (yield this._getCustomAuthorizationHeaders())), requestOptions === null || requestOptions === void 0 ? void 0 : requestOptions.headers),
+                        : 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",
                 body: serializers.agents.MessageSearchRequest.jsonOrThrow(request, { unrecognizedObjectKeys: "strip" }),
@@ -597,14 +597,14 @@ 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: [{
@@ -625,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": "1.0.0-alpha.2", "User-Agent": "@letta-ai/letta-client/1.0.0-alpha.2", "X-Fern-Runtime": core.RUNTIME.type, "X-Fern-Runtime-Version": core.RUNTIME.version }, (yield this._getCustomAuthorizationHeaders())), requestOptions === null || requestOptions === void 0 ? void 0 : requestOptions.headers),
+                        : 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",
                 body: serializers.agents.LettaAsyncRequest.jsonOrThrow(request, { unrecognizedObjectKeys: "strip" }),
@@ -683,14 +683,14 @@ 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
      *     })
      */
@@ -710,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": "1.0.0-alpha.2", "User-Agent": "@letta-ai/letta-client/1.0.0-alpha.2", "X-Fern-Runtime": core.RUNTIME.type, "X-Fern-Runtime-Version": core.RUNTIME.version }, (yield this._getCustomAuthorizationHeaders())), requestOptions === null || requestOptions === void 0 ? void 0 : requestOptions.headers),
+                        : 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",
@@ -772,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: [{
@@ -800,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": "1.0.0-alpha.2", "User-Agent": "@letta-ai/letta-client/1.0.0-alpha.2", "X-Fern-Runtime": core.RUNTIME.type, "X-Fern-Runtime-Version": core.RUNTIME.version }, (yield this._getCustomAuthorizationHeaders())), requestOptions === null || requestOptions === void 0 ? void 0 : requestOptions.headers),
+                        : 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",
                 body: serializers.agents.MessagesPreviewRequest.jsonOrThrow(request, { unrecognizedObjectKeys: "strip" }),
@@ -861,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
      *     })
      */
@@ -886,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": "1.0.0-alpha.2", "User-Agent": "@letta-ai/letta-client/1.0.0-alpha.2", "X-Fern-Runtime": core.RUNTIME.type, "X-Fern-Runtime-Version": core.RUNTIME.version }, (yield this._getCustomAuthorizationHeaders())), requestOptions === null || requestOptions === void 0 ? void 0 : requestOptions.headers),
+                        : 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/passages/client/Client.d.ts

@@ -33,14 +33,14 @@ export declare class Passages {
     /**
      * Retrieve the memories in an agent's archival memory store (paginated query).
      *
-     * @param {string} agentId
+     * @param {string} agentId - The ID of the agent in the format 'agent-<uuid4>'
      * @param {Letta.agents.PassagesListRequest} request
      * @param {Passages.RequestOptions} requestOptions - Request-specific configuration.
      *
      * @throws {@link Letta.UnprocessableEntityError}
      *
      * @example
-     *     await client.agents.passages.list("agent_id", {
+     *     await client.agents.passages.list("agent-123e4567-e89b-42d3-8456-426614174000", {
      *         after: "after",
      *         before: "before",
      *         limit: 1,
@@ -53,14 +53,14 @@ export declare class Passages {
     /**
      * Insert a memory into an agent's archival memory store.
      *
-     * @param {string} agentId
+     * @param {string} agentId - The ID of the agent in the format 'agent-<uuid4>'
      * @param {Letta.agents.CreateArchivalMemory} request
      * @param {Passages.RequestOptions} requestOptions - Request-specific configuration.
      *
      * @throws {@link Letta.UnprocessableEntityError}
      *
      * @example
-     *     await client.agents.passages.create("agent_id", {
+     *     await client.agents.passages.create("agent-123e4567-e89b-42d3-8456-426614174000", {
      *         text: "text"
      *     })
      */
@@ -73,14 +73,14 @@ export declare class Passages {
      * an agent's archival memory store directly via the API. The search uses the same functionality
      * as the agent's archival_memory_search tool but is accessible for external API usage.
      *
-     * @param {string} agentId
+     * @param {string} agentId - The ID of the agent in the format 'agent-<uuid4>'
      * @param {Letta.agents.PassagesSearchRequest} request
      * @param {Passages.RequestOptions} requestOptions - Request-specific configuration.
      *
      * @throws {@link Letta.UnprocessableEntityError}
      *
      * @example
-     *     await client.agents.passages.search("agent_id", {
+     *     await client.agents.passages.search("agent-123e4567-e89b-42d3-8456-426614174000", {
      *         query: "query",
      *         tagMatchMode: "any",
      *         topK: 1,
@@ -94,13 +94,13 @@ export declare class Passages {
      * Delete a memory from an agent's archival memory store.
      *
      * @param {string} agentId
-     * @param {string} memoryId
+     * @param {string} memoryId - The ID of the agent in the format 'agent-<uuid4>'
      * @param {Passages.RequestOptions} requestOptions - Request-specific configuration.
      *
      * @throws {@link Letta.UnprocessableEntityError}
      *
      * @example
-     *     await client.agents.passages.delete("agent_id", "memory_id")
+     *     await client.agents.passages.delete("agent_id", "agent-123e4567-e89b-42d3-8456-426614174000")
      */
     delete(agentId: string, memoryId: string, requestOptions?: Passages.RequestOptions): core.HttpResponsePromise<unknown>;
     private __delete;

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

@@ -62,14 +62,14 @@ class Passages {
     /**
      * Retrieve the memories in an agent's archival memory store (paginated query).
      *
-     * @param {string} agentId
+     * @param {string} agentId - The ID of the agent in the format 'agent-<uuid4>'
      * @param {Letta.agents.PassagesListRequest} request
      * @param {Passages.RequestOptions} requestOptions - Request-specific configuration.
      *
      * @throws {@link Letta.UnprocessableEntityError}
      *
      * @example
-     *     await client.agents.passages.list("agent_id", {
+     *     await client.agents.passages.list("agent-123e4567-e89b-42d3-8456-426614174000", {
      *         after: "after",
      *         before: "before",
      *         limit: 1,
@@ -105,7 +105,7 @@ class Passages {
                 method: "GET",
                 headers: Object.assign(Object.assign({ "X-Project": (yield core.Supplier.get(this._options.project)) != null
                         ? yield core.Supplier.get(this._options.project)
-                        : undefined, "X-Fern-Language": "JavaScript", "X-Fern-SDK-Name": "@letta-ai/letta-client", "X-Fern-SDK-Version": "1.0.0-alpha.2", "User-Agent": "@letta-ai/letta-client/1.0.0-alpha.2", "X-Fern-Runtime": core.RUNTIME.type, "X-Fern-Runtime-Version": core.RUNTIME.version }, (yield this._getCustomAuthorizationHeaders())), requestOptions === null || requestOptions === void 0 ? void 0 : requestOptions.headers),
+                        : 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",
@@ -163,14 +163,14 @@ class Passages {
     /**
      * Insert a memory into an agent's archival memory store.
      *
-     * @param {string} agentId
+     * @param {string} agentId - The ID of the agent in the format 'agent-<uuid4>'
      * @param {Letta.agents.CreateArchivalMemory} request
      * @param {Passages.RequestOptions} requestOptions - Request-specific configuration.
      *
      * @throws {@link Letta.UnprocessableEntityError}
      *
      * @example
-     *     await client.agents.passages.create("agent_id", {
+     *     await client.agents.passages.create("agent-123e4567-e89b-42d3-8456-426614174000", {
      *         text: "text"
      *     })
      */
@@ -185,7 +185,7 @@ class Passages {
                 method: "POST",
                 headers: Object.assign(Object.assign({ "X-Project": (yield core.Supplier.get(this._options.project)) != null
                         ? yield core.Supplier.get(this._options.project)
-                        : undefined, "X-Fern-Language": "JavaScript", "X-Fern-SDK-Name": "@letta-ai/letta-client", "X-Fern-SDK-Version": "1.0.0-alpha.2", "User-Agent": "@letta-ai/letta-client/1.0.0-alpha.2", "X-Fern-Runtime": core.RUNTIME.type, "X-Fern-Runtime-Version": core.RUNTIME.version }, (yield this._getCustomAuthorizationHeaders())), requestOptions === null || requestOptions === void 0 ? void 0 : requestOptions.headers),
+                        : 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",
                 body: serializers.agents.CreateArchivalMemory.jsonOrThrow(request, { unrecognizedObjectKeys: "strip" }),
@@ -247,14 +247,14 @@ class Passages {
      * an agent's archival memory store directly via the API. The search uses the same functionality
      * as the agent's archival_memory_search tool but is accessible for external API usage.
      *
-     * @param {string} agentId
+     * @param {string} agentId - The ID of the agent in the format 'agent-<uuid4>'
      * @param {Letta.agents.PassagesSearchRequest} request
      * @param {Passages.RequestOptions} requestOptions - Request-specific configuration.
      *
      * @throws {@link Letta.UnprocessableEntityError}
      *
      * @example
-     *     await client.agents.passages.search("agent_id", {
+     *     await client.agents.passages.search("agent-123e4567-e89b-42d3-8456-426614174000", {
      *         query: "query",
      *         tagMatchMode: "any",
      *         topK: 1,
@@ -296,7 +296,7 @@ class Passages {
                 method: "GET",
                 headers: Object.assign(Object.assign({ "X-Project": (yield core.Supplier.get(this._options.project)) != null
                         ? yield core.Supplier.get(this._options.project)
-                        : undefined, "X-Fern-Language": "JavaScript", "X-Fern-SDK-Name": "@letta-ai/letta-client", "X-Fern-SDK-Version": "1.0.0-alpha.2", "User-Agent": "@letta-ai/letta-client/1.0.0-alpha.2", "X-Fern-Runtime": core.RUNTIME.type, "X-Fern-Runtime-Version": core.RUNTIME.version }, (yield this._getCustomAuthorizationHeaders())), requestOptions === null || requestOptions === void 0 ? void 0 : requestOptions.headers),
+                        : 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",
@@ -355,13 +355,13 @@ class Passages {
      * Delete a memory from an agent's archival memory store.
      *
      * @param {string} agentId
-     * @param {string} memoryId
+     * @param {string} memoryId - The ID of the agent in the format 'agent-<uuid4>'
      * @param {Passages.RequestOptions} requestOptions - Request-specific configuration.
      *
      * @throws {@link Letta.UnprocessableEntityError}
      *
      * @example
-     *     await client.agents.passages.delete("agent_id", "memory_id")
+     *     await client.agents.passages.delete("agent_id", "agent-123e4567-e89b-42d3-8456-426614174000")
      */
     delete(agentId, memoryId, requestOptions) {
         return core.HttpResponsePromise.fromPromise(this.__delete(agentId, memoryId, requestOptions));
@@ -374,7 +374,7 @@ class Passages {
                 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.2", "User-Agent": "@letta-ai/letta-client/1.0.0-alpha.2", "X-Fern-Runtime": core.RUNTIME.type, "X-Fern-Runtime-Version": core.RUNTIME.version }, (yield this._getCustomAuthorizationHeaders())), requestOptions === null || requestOptions === void 0 ? void 0 : requestOptions.headers),
+                        : 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,
@@ -438,7 +438,7 @@ class Passages {
                 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.2", "User-Agent": "@letta-ai/letta-client/1.0.0-alpha.2", "X-Fern-Runtime": core.RUNTIME.type, "X-Fern-Runtime-Version": core.RUNTIME.version }, (yield this._getCustomAuthorizationHeaders())), requestOptions === null || requestOptions === void 0 ? void 0 : requestOptions.headers),
+                        : 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/sources/client/Client.d.ts

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

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

@@ -62,14 +62,14 @@ class Sources {
     /**
      * Attach a source to an agent.
      *
-     * @param {string} agentId
-     * @param {string} sourceId
+     * @param {string} agentId - The ID of the source in the format 'source-<uuid4>'
+     * @param {string} sourceId - The ID of the agent in the format 'agent-<uuid4>'
      * @param {Sources.RequestOptions} requestOptions - Request-specific configuration.
      *
      * @throws {@link Letta.UnprocessableEntityError}
      *
      * @example
-     *     await client.agents.sources.attach("agent_id", "source_id")
+     *     await client.agents.sources.attach("source-123e4567-e89b-42d3-8456-426614174000", "agent-123e4567-e89b-42d3-8456-426614174000")
      */
     attach(agentId, sourceId, requestOptions) {
         return core.HttpResponsePromise.fromPromise(this.__attach(agentId, sourceId, requestOptions));
@@ -82,7 +82,7 @@ class Sources {
                 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.2", "User-Agent": "@letta-ai/letta-client/1.0.0-alpha.2", "X-Fern-Runtime": core.RUNTIME.type, "X-Fern-Runtime-Version": core.RUNTIME.version }, (yield this._getCustomAuthorizationHeaders())), requestOptions === null || requestOptions === void 0 ? void 0 : requestOptions.headers),
+                        : 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 Sources {
     /**
      * Detach a source from an agent.
      *
-     * @param {string} agentId
-     * @param {string} sourceId
+     * @param {string} agentId - The ID of the source in the format 'source-<uuid4>'
+     * @param {string} sourceId - The ID of the agent in the format 'agent-<uuid4>'
      * @param {Sources.RequestOptions} requestOptions - Request-specific configuration.
      *
      * @throws {@link Letta.UnprocessableEntityError}
      *
      * @example
-     *     await client.agents.sources.detach("agent_id", "source_id")
+     *     await client.agents.sources.detach("source-123e4567-e89b-42d3-8456-426614174000", "agent-123e4567-e89b-42d3-8456-426614174000")
      */
     detach(agentId, sourceId, requestOptions) {
         return core.HttpResponsePromise.fromPromise(this.__detach(agentId, sourceId, requestOptions));
@@ -159,7 +159,7 @@ class Sources {
                 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.2", "User-Agent": "@letta-ai/letta-client/1.0.0-alpha.2", "X-Fern-Runtime": core.RUNTIME.type, "X-Fern-Runtime-Version": core.RUNTIME.version }, (yield this._getCustomAuthorizationHeaders())), requestOptions === null || requestOptions === void 0 ? void 0 : requestOptions.headers),
+                        : 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 Sources {
     /**
      * Get the sources associated with an agent.
      *
-     * @param {string} agentId
+     * @param {string} agentId - The ID of the agent in the format 'agent-<uuid4>'
      * @param {Letta.agents.SourcesListRequest} request
      * @param {Sources.RequestOptions} requestOptions - Request-specific configuration.
      *
      * @throws {@link Letta.UnprocessableEntityError}
      *
      * @example
-     *     await client.agents.sources.list("agent_id", {
+     *     await client.agents.sources.list("agent-123e4567-e89b-42d3-8456-426614174000", {
      *         before: "before",
      *         after: "after",
      *         limit: 1,
@@ -261,7 +261,7 @@ class Sources {
                 method: "GET",
                 headers: Object.assign(Object.assign({ "X-Project": (yield core.Supplier.get(this._options.project)) != null
                         ? yield core.Supplier.get(this._options.project)
-                        : undefined, "X-Fern-Language": "JavaScript", "X-Fern-SDK-Name": "@letta-ai/letta-client", "X-Fern-SDK-Version": "1.0.0-alpha.2", "User-Agent": "@letta-ai/letta-client/1.0.0-alpha.2", "X-Fern-Runtime": core.RUNTIME.type, "X-Fern-Runtime-Version": core.RUNTIME.version }, (yield this._getCustomAuthorizationHeaders())), requestOptions === null || requestOptions === void 0 ? void 0 : requestOptions.headers),
+                        : 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/tools/client/Client.d.ts

@@ -33,14 +33,14 @@ export declare class Tools {
     /**
      * Get tools from an existing agent
      *
-     * @param {string} agentId
+     * @param {string} agentId - The ID of the agent in the format 'agent-<uuid4>'
      * @param {Letta.agents.ToolsListRequest} request
      * @param {Tools.RequestOptions} requestOptions - Request-specific configuration.
      *
      * @throws {@link Letta.UnprocessableEntityError}
      *
      * @example
-     *     await client.agents.tools.list("agent_id", {
+     *     await client.agents.tools.list("agent-123e4567-e89b-42d3-8456-426614174000", {
      *         before: "before",
      *         after: "after",
      *         limit: 1,
@@ -53,35 +53,35 @@ export declare class Tools {
     /**
      * Attach a tool to an agent.
      *
-     * @param {string} agentId
-     * @param {string} toolId
+     * @param {string} agentId - The ID of the tool in the format 'tool-<uuid4>'
+     * @param {string} toolId - The ID of the agent in the format 'agent-<uuid4>'
      * @param {Tools.RequestOptions} requestOptions - Request-specific configuration.
      *
      * @throws {@link Letta.UnprocessableEntityError}
      *
      * @example
-     *     await client.agents.tools.attach("agent_id", "tool_id")
+     *     await client.agents.tools.attach("tool-123e4567-e89b-42d3-8456-426614174000", "agent-123e4567-e89b-42d3-8456-426614174000")
      */
     attach(agentId: string, toolId: string, requestOptions?: Tools.RequestOptions): core.HttpResponsePromise<Letta.AgentState>;
     private __attach;
     /**
      * Detach a tool from an agent.
      *
-     * @param {string} agentId
-     * @param {string} toolId
+     * @param {string} agentId - The ID of the tool in the format 'tool-<uuid4>'
+     * @param {string} toolId - The ID of the agent in the format 'agent-<uuid4>'
      * @param {Tools.RequestOptions} requestOptions - Request-specific configuration.
      *
      * @throws {@link Letta.UnprocessableEntityError}
      *
      * @example
-     *     await client.agents.tools.detach("agent_id", "tool_id")
+     *     await client.agents.tools.detach("tool-123e4567-e89b-42d3-8456-426614174000", "agent-123e4567-e89b-42d3-8456-426614174000")
      */
     detach(agentId: string, toolId: string, requestOptions?: Tools.RequestOptions): core.HttpResponsePromise<Letta.AgentState>;
     private __detach;
     /**
      * Attach a tool to an agent.
      *
-     * @param {string} agentId
+     * @param {string} agentId - The ID of the agent in the format 'agent-<uuid4>'
      * @param {string} toolName
      * @param {Letta.agents.ToolsModifyApprovalRequest} request
      * @param {Tools.RequestOptions} requestOptions - Request-specific configuration.
@@ -89,7 +89,7 @@ export declare class Tools {
      * @throws {@link Letta.UnprocessableEntityError}
      *
      * @example
-     *     await client.agents.tools.modifyApproval("agent_id", "tool_name", {
+     *     await client.agents.tools.modifyApproval("agent-123e4567-e89b-42d3-8456-426614174000", "tool_name", {
      *         requiresApproval: true
      *     })
      */