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

package/api/types/LettaSchemasAgentFileToolSchema.d.ts

@@ -32,6 +32,8 @@ export interface LettaSchemasAgentFileToolSchema {
     npmRequirements?: Letta.NpmRequirement[];
     /** Default value for whether or not executing this tool requires approval. */
     defaultRequiresApproval?: boolean;
+    /** If set to True, then this tool will potentially be executed concurrently with other tools. Default False. */
+    enableParallelExecution?: boolean;
     /** The id of the user that made this Tool. */
     createdById?: string;
     /** The id of the user that made this Tool. */

package/api/types/LlmConfig.d.ts

@@ -44,4 +44,6 @@ export interface LlmConfig {
     verbosity?: Letta.LlmConfigVerbosity;
     /** The cost tier for the model (cloud only). */
     tier?: string;
+    /** If set to True, enables parallel tool calling. Defaults to False. */
+    parallelToolCalls?: boolean;
 }

package/api/types/RunMetrics.d.ts

@@ -14,6 +14,8 @@ export interface RunMetrics {
     runNs?: number;
     /** The number of steps in the run. */
     numSteps?: number;
+    /** List of tool IDs that were used in this run. */
+    toolsUsed?: string[];
     /** The template ID that the run belongs to (cloud only). */
     templateId?: string;
     /** The base template ID that the run belongs to (cloud only). */

package/api/types/Tool.d.ts

@@ -39,6 +39,8 @@ export interface Tool {
     npmRequirements?: Letta.NpmRequirement[];
     /** Default value for whether or not executing this tool requires approval. */
     defaultRequiresApproval?: boolean;
+    /** If set to True, then this tool will potentially be executed concurrently with other tools. Default False. */
+    enableParallelExecution?: boolean;
     /** The id of the user that made this Tool. */
     createdById?: string;
     /** The id of the user that made this Tool. */

package/api/types/ToolCreate.d.ts

@@ -23,4 +23,6 @@ export interface ToolCreate {
     npmRequirements?: Letta.NpmRequirement[];
     /** Whether or not to require approval before executing this tool. */
     defaultRequiresApproval?: boolean;
+    /** If set to True, then this tool will potentially be executed concurrently with other tools. Default False. */
+    enableParallelExecution?: boolean;
 }

package/api/types/index.d.ts

@@ -15,6 +15,7 @@ export * from "./AnnotationUrlCitation";
 export * from "./ApprovalCreateApprovalsItem";
 export * from "./ApprovalCreate";
 export * from "./ApprovalRequestMessageToolCall";
+export * from "./ApprovalRequestMessageToolCalls";
 export * from "./ApprovalRequestMessage";
 export * from "./ApprovalResponseMessageApprovalsItem";
 export * from "./ApprovalResponseMessage";

package/api/types/index.js

@@ -31,6 +31,7 @@ __exportStar(require("./AnnotationUrlCitation"), exports);
 __exportStar(require("./ApprovalCreateApprovalsItem"), exports);
 __exportStar(require("./ApprovalCreate"), exports);
 __exportStar(require("./ApprovalRequestMessageToolCall"), exports);
+__exportStar(require("./ApprovalRequestMessageToolCalls"), exports);
 __exportStar(require("./ApprovalRequestMessage"), exports);
 __exportStar(require("./ApprovalResponseMessageApprovalsItem"), exports);
 __exportStar(require("./ApprovalResponseMessage"), exports);

package/dist/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/dist/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.5", "User-Agent": "@letta-ai/letta-client/1.0.0-alpha.5", "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.5", "User-Agent": "@letta-ai/letta-client/1.0.0-alpha.5", "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.5", "User-Agent": "@letta-ai/letta-client/1.0.0-alpha.5", "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.5", "User-Agent": "@letta-ai/letta-client/1.0.0-alpha.5", "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.5", "User-Agent": "@letta-ai/letta-client/1.0.0-alpha.5", "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.5", "User-Agent": "@letta-ai/letta-client/1.0.0-alpha.5", "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.5", "User-Agent": "@letta-ai/letta-client/1.0.0-alpha.5", "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.5", "User-Agent": "@letta-ai/letta-client/1.0.0-alpha.5", "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.5", "User-Agent": "@letta-ai/letta-client/1.0.0-alpha.5", "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/dist/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/dist/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/dist/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/dist/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.5", "User-Agent": "@letta-ai/letta-client/1.0.0-alpha.5", "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.5", "User-Agent": "@letta-ai/letta-client/1.0.0-alpha.5", "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.5", "User-Agent": "@letta-ai/letta-client/1.0.0-alpha.5", "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.5", "User-Agent": "@letta-ai/letta-client/1.0.0-alpha.5", "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.5", "User-Agent": "@letta-ai/letta-client/1.0.0-alpha.5", "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/dist/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/dist/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.5", "User-Agent": "@letta-ai/letta-client/1.0.0-alpha.5", "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/dist/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/dist/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.5", "User-Agent": "@letta-ai/letta-client/1.0.0-alpha.5", "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,