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

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

@@ -125,14 +125,14 @@ export declare class Agents {
      * - Legacy format (use_legacy_format=true): Single agent with inline tools/blocks
      * - New format (default): Multi-entity format with separate agents, tools, blocks, files, etc.
      *
-     * @param {string} agentId
+     * @param {string} agentId - The ID of the agent in the format 'agent-<uuid4>'
      * @param {Letta.AgentsExportFileRequest} request
      * @param {Agents.RequestOptions} requestOptions - Request-specific configuration.
      *
      * @throws {@link Letta.UnprocessableEntityError}
      *
      * @example
-     *     await client.agents.exportFile("agent_id", {
+     *     await client.agents.exportFile("agent-123e4567-e89b-42d3-8456-426614174000", {
      *         maxSteps: 1,
      *         useLegacyFormat: true
      *     })
@@ -159,41 +159,41 @@ export declare class Agents {
     /**
      * Get the state of the agent.
      *
-     * @param {string} agentId
+     * @param {string} agentId - The ID of the agent in the format 'agent-<uuid4>'
      * @param {Letta.AgentsRetrieveRequest} request
      * @param {Agents.RequestOptions} requestOptions - Request-specific configuration.
      *
      * @throws {@link Letta.UnprocessableEntityError}
      *
      * @example
-     *     await client.agents.retrieve("agent_id")
+     *     await client.agents.retrieve("agent-123e4567-e89b-42d3-8456-426614174000")
      */
     retrieve(agentId: string, request?: Letta.AgentsRetrieveRequest, requestOptions?: Agents.RequestOptions): core.HttpResponsePromise<Letta.AgentState>;
     private __retrieve;
     /**
      * Delete an agent.
      *
-     * @param {string} agentId
+     * @param {string} agentId - The ID of the agent in the format 'agent-<uuid4>'
      * @param {Agents.RequestOptions} requestOptions - Request-specific configuration.
      *
      * @throws {@link Letta.UnprocessableEntityError}
      *
      * @example
-     *     await client.agents.delete("agent_id")
+     *     await client.agents.delete("agent-123e4567-e89b-42d3-8456-426614174000")
      */
     delete(agentId: string, requestOptions?: Agents.RequestOptions): core.HttpResponsePromise<unknown>;
     private __delete;
     /**
      * Update an existing agent.
      *
-     * @param {string} agentId
+     * @param {string} agentId - The ID of the agent in the format 'agent-<uuid4>'
      * @param {Letta.UpdateAgent} request
      * @param {Agents.RequestOptions} requestOptions - Request-specific configuration.
      *
      * @throws {@link Letta.UnprocessableEntityError}
      *
      * @example
-     *     await client.agents.modify("agent_id")
+     *     await client.agents.modify("agent-123e4567-e89b-42d3-8456-426614174000")
      */
     modify(agentId: string, request?: Letta.UpdateAgent, requestOptions?: Agents.RequestOptions): core.HttpResponsePromise<Letta.AgentState>;
     private __modify;

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

@@ -223,7 +223,7 @@ class Agents {
                 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",
@@ -300,7 +300,7 @@ class Agents {
                 method: "POST",
                 headers: Object.assign(Object.assign({ "X-Project": (yield core.Supplier.get(this._options.project)) != null
                         ? yield core.Supplier.get(this._options.project)
-                        : undefined, "X-Fern-Language": "JavaScript", "X-Fern-SDK-Name": "@letta-ai/letta-client", "X-Fern-SDK-Version": "1.0.0-alpha.3", "User-Agent": "@letta-ai/letta-client/1.0.0-alpha.3", "X-Fern-Runtime": core.RUNTIME.type, "X-Fern-Runtime-Version": core.RUNTIME.version }, (yield this._getCustomAuthorizationHeaders())), requestOptions === null || requestOptions === void 0 ? void 0 : requestOptions.headers),
+                        : 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.CreateAgentRequest.jsonOrThrow(request, { unrecognizedObjectKeys: "strip" }),
@@ -376,7 +376,7 @@ class Agents {
                 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,
@@ -437,14 +437,14 @@ class Agents {
      * - Legacy format (use_legacy_format=true): Single agent with inline tools/blocks
      * - New format (default): Multi-entity format with separate agents, tools, blocks, files, etc.
      *
-     * @param {string} agentId
+     * @param {string} agentId - The ID of the agent in the format 'agent-<uuid4>'
      * @param {Letta.AgentsExportFileRequest} request
      * @param {Agents.RequestOptions} requestOptions - Request-specific configuration.
      *
      * @throws {@link Letta.UnprocessableEntityError}
      *
      * @example
-     *     await client.agents.exportFile("agent_id", {
+     *     await client.agents.exportFile("agent-123e4567-e89b-42d3-8456-426614174000", {
      *         maxSteps: 1,
      *         useLegacyFormat: true
      *     })
@@ -468,7 +468,7 @@ class Agents {
                 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",
@@ -570,7 +570,7 @@ class Agents {
                 method: "POST",
                 headers: Object.assign(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, "x-override-embedding-model": request.overrideEmbeddingModel != null ? request.overrideEmbeddingModel : undefined }, (yield this._getCustomAuthorizationHeaders())), _maybeEncodedRequest.headers), 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, "x-override-embedding-model": request.overrideEmbeddingModel != null ? request.overrideEmbeddingModel : undefined }, (yield this._getCustomAuthorizationHeaders())), _maybeEncodedRequest.headers), requestOptions === null || requestOptions === void 0 ? void 0 : requestOptions.headers),
                 requestType: "file",
                 duplex: _maybeEncodedRequest.duplex,
                 body: _maybeEncodedRequest.body,
@@ -628,14 +628,14 @@ class Agents {
     /**
      * Get the state of the agent.
      *
-     * @param {string} agentId
+     * @param {string} agentId - The ID of the agent in the format 'agent-<uuid4>'
      * @param {Letta.AgentsRetrieveRequest} request
      * @param {Agents.RequestOptions} requestOptions - Request-specific configuration.
      *
      * @throws {@link Letta.UnprocessableEntityError}
      *
      * @example
-     *     await client.agents.retrieve("agent_id")
+     *     await client.agents.retrieve("agent-123e4567-e89b-42d3-8456-426614174000")
      */
     retrieve(agentId, request = {}, requestOptions) {
         return core.HttpResponsePromise.fromPromise(this.__retrieve(agentId, request, requestOptions));
@@ -658,7 +658,7 @@ class Agents {
                 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",
@@ -716,13 +716,13 @@ class Agents {
     /**
      * Delete an agent.
      *
-     * @param {string} agentId
+     * @param {string} agentId - The ID of the agent in the format 'agent-<uuid4>'
      * @param {Agents.RequestOptions} requestOptions - Request-specific configuration.
      *
      * @throws {@link Letta.UnprocessableEntityError}
      *
      * @example
-     *     await client.agents.delete("agent_id")
+     *     await client.agents.delete("agent-123e4567-e89b-42d3-8456-426614174000")
      */
     delete(agentId, requestOptions) {
         return core.HttpResponsePromise.fromPromise(this.__delete(agentId, requestOptions));
@@ -735,7 +735,7 @@ class Agents {
                 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.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,
@@ -783,14 +783,14 @@ class Agents {
     /**
      * Update an existing agent.
      *
-     * @param {string} agentId
+     * @param {string} agentId - The ID of the agent in the format 'agent-<uuid4>'
      * @param {Letta.UpdateAgent} request
      * @param {Agents.RequestOptions} requestOptions - Request-specific configuration.
      *
      * @throws {@link Letta.UnprocessableEntityError}
      *
      * @example
-     *     await client.agents.modify("agent_id")
+     *     await client.agents.modify("agent-123e4567-e89b-42d3-8456-426614174000")
      */
     modify(agentId, request = {}, requestOptions) {
         return core.HttpResponsePromise.fromPromise(this.__modify(agentId, request, requestOptions));
@@ -803,7 +803,7 @@ class Agents {
                 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",
                 body: serializers.UpdateAgent.jsonOrThrow(request, { unrecognizedObjectKeys: "strip" }),
@@ -880,7 +880,7 @@ class Agents {
                 method: "POST",
                 headers: Object.assign(Object.assign({ "X-Project": (yield core.Supplier.get(this._options.project)) != null
                         ? yield core.Supplier.get(this._options.project)
-                        : undefined, "X-Fern-Language": "JavaScript", "X-Fern-SDK-Name": "@letta-ai/letta-client", "X-Fern-SDK-Version": "1.0.0-alpha.3", "User-Agent": "@letta-ai/letta-client/1.0.0-alpha.3", "X-Fern-Runtime": core.RUNTIME.type, "X-Fern-Runtime-Version": core.RUNTIME.version }, (yield this._getCustomAuthorizationHeaders())), requestOptions === null || requestOptions === void 0 ? void 0 : requestOptions.headers),
+                        : 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.AgentsSearchRequest.jsonOrThrow(request, { unrecognizedObjectKeys: "strip" }),

package/api/resources/agents/client/requests/CreateAgentRequest.d.ts

@@ -95,4 +95,6 @@ export interface CreateAgentRequest {
     perFileViewWindowCharLimit?: number;
     /** If set to True, the agent will be hidden. */
     hidden?: boolean;
+    /** If set to True, enables parallel tool calling. Defaults to False. */
+    parallelToolCalls?: boolean;
 }

package/api/resources/agents/client/requests/UpdateAgent.d.ts

@@ -67,4 +67,6 @@ export interface UpdateAgent {
     perFileViewWindowCharLimit?: number;
     /** If set to True, the agent will be hidden. */
     hidden?: boolean;
+    /** If set to True, enables parallel tool calling. Defaults to False. */
+    parallelToolCalls?: boolean;
 }

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

@@ -34,13 +34,13 @@ export declare class Blocks {
      * Retrieve a core memory block from an agent.
      *
      * @param {string} agentId
-     * @param {string} blockLabel
+     * @param {string} blockLabel - The ID of the agent in the format 'agent-<uuid4>'
      * @param {Blocks.RequestOptions} requestOptions - Request-specific configuration.
      *
      * @throws {@link Letta.UnprocessableEntityError}
      *
      * @example
-     *     await client.agents.blocks.retrieve("agent_id", "block_label")
+     *     await client.agents.blocks.retrieve("agent_id", "agent-123e4567-e89b-42d3-8456-426614174000")
      */
     retrieve(agentId: string, blockLabel: string, requestOptions?: Blocks.RequestOptions): core.HttpResponsePromise<Letta.Block>;
     private __retrieve;
@@ -48,28 +48,28 @@ export declare class Blocks {
      * Updates a core memory block of an agent.
      *
      * @param {string} agentId
-     * @param {string} blockLabel
+     * @param {string} blockLabel - The ID of the agent in the format 'agent-<uuid4>'
      * @param {Letta.BlockUpdate} request
      * @param {Blocks.RequestOptions} requestOptions - Request-specific configuration.
      *
      * @throws {@link Letta.UnprocessableEntityError}
      *
      * @example
-     *     await client.agents.blocks.modify("agent_id", "block_label", {})
+     *     await client.agents.blocks.modify("agent_id", "agent-123e4567-e89b-42d3-8456-426614174000", {})
      */
     modify(agentId: string, blockLabel: string, request: Letta.BlockUpdate, requestOptions?: Blocks.RequestOptions): core.HttpResponsePromise<Letta.Block>;
     private __modify;
     /**
      * Retrieve the core memory blocks of a specific agent.
      *
-     * @param {string} agentId
+     * @param {string} agentId - The ID of the agent in the format 'agent-<uuid4>'
      * @param {Letta.agents.BlocksListRequest} request
      * @param {Blocks.RequestOptions} requestOptions - Request-specific configuration.
      *
      * @throws {@link Letta.UnprocessableEntityError}
      *
      * @example
-     *     await client.agents.blocks.list("agent_id", {
+     *     await client.agents.blocks.list("agent-123e4567-e89b-42d3-8456-426614174000", {
      *         before: "before",
      *         after: "after",
      *         limit: 1,
@@ -82,28 +82,28 @@ export declare class Blocks {
     /**
      * Attach a core memory block to an agent.
      *
-     * @param {string} agentId
-     * @param {string} blockId
+     * @param {string} agentId - The ID of the block in the format 'block-<uuid4>'
+     * @param {string} blockId - The ID of the agent in the format 'agent-<uuid4>'
      * @param {Blocks.RequestOptions} requestOptions - Request-specific configuration.
      *
      * @throws {@link Letta.UnprocessableEntityError}
      *
      * @example
-     *     await client.agents.blocks.attach("agent_id", "block_id")
+     *     await client.agents.blocks.attach("block-123e4567-e89b-42d3-8456-426614174000", "agent-123e4567-e89b-42d3-8456-426614174000")
      */
     attach(agentId: string, blockId: string, requestOptions?: Blocks.RequestOptions): core.HttpResponsePromise<Letta.AgentState>;
     private __attach;
     /**
      * Detach a core memory block from an agent.
      *
-     * @param {string} agentId
-     * @param {string} blockId
+     * @param {string} agentId - The ID of the block in the format 'block-<uuid4>'
+     * @param {string} blockId - The ID of the agent in the format 'agent-<uuid4>'
      * @param {Blocks.RequestOptions} requestOptions - Request-specific configuration.
      *
      * @throws {@link Letta.UnprocessableEntityError}
      *
      * @example
-     *     await client.agents.blocks.detach("agent_id", "block_id")
+     *     await client.agents.blocks.detach("block-123e4567-e89b-42d3-8456-426614174000", "agent-123e4567-e89b-42d3-8456-426614174000")
      */
     detach(agentId: string, blockId: string, requestOptions?: Blocks.RequestOptions): core.HttpResponsePromise<Letta.AgentState>;
     private __detach;

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

@@ -63,13 +63,13 @@ class Blocks {
      * Retrieve a core memory block from an agent.
      *
      * @param {string} agentId
-     * @param {string} blockLabel
+     * @param {string} blockLabel - The ID of the agent in the format 'agent-<uuid4>'
      * @param {Blocks.RequestOptions} requestOptions - Request-specific configuration.
      *
      * @throws {@link Letta.UnprocessableEntityError}
      *
      * @example
-     *     await client.agents.blocks.retrieve("agent_id", "block_label")
+     *     await client.agents.blocks.retrieve("agent_id", "agent-123e4567-e89b-42d3-8456-426614174000")
      */
     retrieve(agentId, blockLabel, requestOptions) {
         return core.HttpResponsePromise.fromPromise(this.__retrieve(agentId, blockLabel, requestOptions));
@@ -82,7 +82,7 @@ class Blocks {
                 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,
@@ -140,14 +140,14 @@ class Blocks {
      * Updates a core memory block of an agent.
      *
      * @param {string} agentId
-     * @param {string} blockLabel
+     * @param {string} blockLabel - The ID of the agent in the format 'agent-<uuid4>'
      * @param {Letta.BlockUpdate} request
      * @param {Blocks.RequestOptions} requestOptions - Request-specific configuration.
      *
      * @throws {@link Letta.UnprocessableEntityError}
      *
      * @example
-     *     await client.agents.blocks.modify("agent_id", "block_label", {})
+     *     await client.agents.blocks.modify("agent_id", "agent-123e4567-e89b-42d3-8456-426614174000", {})
      */
     modify(agentId, blockLabel, request, requestOptions) {
         return core.HttpResponsePromise.fromPromise(this.__modify(agentId, blockLabel, request, requestOptions));
@@ -160,7 +160,7 @@ class Blocks {
                 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",
                 body: serializers.BlockUpdate.jsonOrThrow(request, { unrecognizedObjectKeys: "strip" }),
@@ -218,14 +218,14 @@ class Blocks {
     /**
      * Retrieve the core memory blocks of a specific agent.
      *
-     * @param {string} agentId
+     * @param {string} agentId - The ID of the agent in the format 'agent-<uuid4>'
      * @param {Letta.agents.BlocksListRequest} request
      * @param {Blocks.RequestOptions} requestOptions - Request-specific configuration.
      *
      * @throws {@link Letta.UnprocessableEntityError}
      *
      * @example
-     *     await client.agents.blocks.list("agent_id", {
+     *     await client.agents.blocks.list("agent-123e4567-e89b-42d3-8456-426614174000", {
      *         before: "before",
      *         after: "after",
      *         limit: 1,
@@ -263,7 +263,7 @@ class Blocks {
                 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",
@@ -321,14 +321,14 @@ class Blocks {
     /**
      * Attach a core memory block to an agent.
      *
-     * @param {string} agentId
-     * @param {string} blockId
+     * @param {string} agentId - The ID of the block in the format 'block-<uuid4>'
+     * @param {string} blockId - The ID of the agent in the format 'agent-<uuid4>'
      * @param {Blocks.RequestOptions} requestOptions - Request-specific configuration.
      *
      * @throws {@link Letta.UnprocessableEntityError}
      *
      * @example
-     *     await client.agents.blocks.attach("agent_id", "block_id")
+     *     await client.agents.blocks.attach("block-123e4567-e89b-42d3-8456-426614174000", "agent-123e4567-e89b-42d3-8456-426614174000")
      */
     attach(agentId, blockId, requestOptions) {
         return core.HttpResponsePromise.fromPromise(this.__attach(agentId, blockId, requestOptions));
@@ -341,7 +341,7 @@ class Blocks {
                 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,
@@ -398,14 +398,14 @@ class Blocks {
     /**
      * Detach a core memory block from an agent.
      *
-     * @param {string} agentId
-     * @param {string} blockId
+     * @param {string} agentId - The ID of the block in the format 'block-<uuid4>'
+     * @param {string} blockId - The ID of the agent in the format 'agent-<uuid4>'
      * @param {Blocks.RequestOptions} requestOptions - Request-specific configuration.
      *
      * @throws {@link Letta.UnprocessableEntityError}
      *
      * @example
-     *     await client.agents.blocks.detach("agent_id", "block_id")
+     *     await client.agents.blocks.detach("block-123e4567-e89b-42d3-8456-426614174000", "agent-123e4567-e89b-42d3-8456-426614174000")
      */
     detach(agentId, blockId, requestOptions) {
         return core.HttpResponsePromise.fromPromise(this.__detach(agentId, blockId, requestOptions));
@@ -418,7 +418,7 @@ class Blocks {
                 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,

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

@@ -33,13 +33,13 @@ export declare class Context {
     /**
      * Retrieve the context window of a specific agent.
      *
-     * @param {string} agentId
+     * @param {string} agentId - The ID of the agent in the format 'agent-<uuid4>'
      * @param {Context.RequestOptions} requestOptions - Request-specific configuration.
      *
      * @throws {@link Letta.UnprocessableEntityError}
      *
      * @example
-     *     await client.agents.context.retrieve("agent_id")
+     *     await client.agents.context.retrieve("agent-123e4567-e89b-42d3-8456-426614174000")
      */
     retrieve(agentId: string, requestOptions?: Context.RequestOptions): core.HttpResponsePromise<Letta.ContextWindowOverview>;
     private __retrieve;

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

@@ -62,13 +62,13 @@ class Context {
     /**
      * Retrieve the context window of a specific agent.
      *
-     * @param {string} agentId
+     * @param {string} agentId - The ID of the agent in the format 'agent-<uuid4>'
      * @param {Context.RequestOptions} requestOptions - Request-specific configuration.
      *
      * @throws {@link Letta.UnprocessableEntityError}
      *
      * @example
-     *     await client.agents.context.retrieve("agent_id")
+     *     await client.agents.context.retrieve("agent-123e4567-e89b-42d3-8456-426614174000")
      */
     retrieve(agentId, requestOptions) {
         return core.HttpResponsePromise.fromPromise(this.__retrieve(agentId, requestOptions));
@@ -81,7 +81,7 @@ class Context {
                 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/coreMemory/client/Client.d.ts

@@ -34,13 +34,13 @@ export declare class CoreMemory {
      * Retrieve the memory state of a specific agent.
      * This endpoint fetches the current memory state of the agent identified by the user ID and agent ID.
      *
-     * @param {string} agentId
+     * @param {string} agentId - The ID of the agent in the format 'agent-<uuid4>'
      * @param {CoreMemory.RequestOptions} requestOptions - Request-specific configuration.
      *
      * @throws {@link Letta.UnprocessableEntityError}
      *
      * @example
-     *     await client.agents.coreMemory.retrieve("agent_id")
+     *     await client.agents.coreMemory.retrieve("agent-123e4567-e89b-42d3-8456-426614174000")
      */
     retrieve(agentId: string, requestOptions?: CoreMemory.RequestOptions): core.HttpResponsePromise<Letta.Memory>;
     private __retrieve;

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

@@ -63,13 +63,13 @@ class CoreMemory {
      * Retrieve the memory state of a specific agent.
      * This endpoint fetches the current memory state of the agent identified by the user ID and agent ID.
      *
-     * @param {string} agentId
+     * @param {string} agentId - The ID of the agent in the format 'agent-<uuid4>'
      * @param {CoreMemory.RequestOptions} requestOptions - Request-specific configuration.
      *
      * @throws {@link Letta.UnprocessableEntityError}
      *
      * @example
-     *     await client.agents.coreMemory.retrieve("agent_id")
+     *     await client.agents.coreMemory.retrieve("agent-123e4567-e89b-42d3-8456-426614174000")
      */
     retrieve(agentId, requestOptions) {
         return core.HttpResponsePromise.fromPromise(this.__retrieve(agentId, requestOptions));
@@ -82,7 +82,7 @@ class CoreMemory {
                 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/files/client/Client.d.ts

@@ -36,13 +36,13 @@ export declare 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: string, requestOptions?: Files.RequestOptions): core.HttpResponsePromise<string[]>;
     private __closeAll;
@@ -53,14 +53,14 @@ export declare 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: string, fileId: string, requestOptions?: Files.RequestOptions): core.HttpResponsePromise<string[]>;
     private __open;
@@ -70,28 +70,28 @@ export declare 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: string, fileId: string, requestOptions?: Files.RequestOptions): core.HttpResponsePromise<unknown>;
     private __close;
     /**
      * 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,