@letta-ai/letta-client 0.1.14 → 0.1.15

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

@@ -1,7 +1,5 @@
 export { type AgentsListRequest } from "./AgentsListRequest";
 export { type CreateAgentRequest } from "./CreateAgentRequest";
 export { type UpdateAgent } from "./UpdateAgent";
-export { type ListArchivalMemoryRequest } from "./ListArchivalMemoryRequest";
-export { type CreateArchivalMemory } from "./CreateArchivalMemory";
 export { type ResetMessagesRequest } from "./ResetMessagesRequest";
 export { type AgentsSearchRequest } from "./AgentsSearchRequest";

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

@@ -3,6 +3,7 @@
  */
 import * as environments from "../../../../../../environments";
 import * as core from "../../../../../../core";
+import * as Letta from "../../../../../index";
 export declare namespace ArchivalMemory {
     interface Options {
         environment?: core.Supplier<environments.LettaEnvironment | string>;
@@ -26,30 +27,46 @@ export declare class ArchivalMemory {
     protected readonly _options: ArchivalMemory.Options;
     constructor(_options?: ArchivalMemory.Options);
     /**
+     * Retrieve the memories in an agent's archival memory store (paginated query).
+     *
      * @param {string} agentId
+     * @param {Letta.agents.ArchivalMemoryListRequest} request
      * @param {ArchivalMemory.RequestOptions} requestOptions - Request-specific configuration.
      *
+     * @throws {@link Letta.UnprocessableEntityError}
+     *
      * @example
      *     await client.agents.archivalMemory.list("agent_id")
      */
-    list(agentId: string, requestOptions?: ArchivalMemory.RequestOptions): Promise<void>;
+    list(agentId: string, request?: Letta.agents.ArchivalMemoryListRequest, requestOptions?: ArchivalMemory.RequestOptions): Promise<Letta.Passage[]>;
     /**
+     * Insert a memory into an agent's archival memory store.
+     *
      * @param {string} agentId
+     * @param {Letta.agents.CreateArchivalMemory} request
      * @param {ArchivalMemory.RequestOptions} requestOptions - Request-specific configuration.
      *
+     * @throws {@link Letta.UnprocessableEntityError}
+     *
      * @example
-     *     await client.agents.archivalMemory.create("agent_id")
+     *     await client.agents.archivalMemory.create("agent_id", {
+     *         text: "text"
+     *     })
      */
-    create(agentId: string, requestOptions?: ArchivalMemory.RequestOptions): Promise<void>;
+    create(agentId: string, request: Letta.agents.CreateArchivalMemory, requestOptions?: ArchivalMemory.RequestOptions): Promise<Letta.Passage[]>;
     /**
+     * Delete a memory from an agent's archival memory store.
+     *
      * @param {string} agentId
      * @param {string} memoryId
      * @param {ArchivalMemory.RequestOptions} requestOptions - Request-specific configuration.
      *
+     * @throws {@link Letta.UnprocessableEntityError}
+     *
      * @example
      *     await client.agents.archivalMemory.delete("agent_id", "memory_id")
      */
-    delete(agentId: string, memoryId: string, requestOptions?: ArchivalMemory.RequestOptions): Promise<void>;
+    delete(agentId: string, memoryId: string, requestOptions?: ArchivalMemory.RequestOptions): Promise<unknown>;
     protected _getCustomAuthorizationHeaders(): Promise<{
         Authorization: string;
     }>;

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

@@ -51,40 +51,76 @@ Object.defineProperty(exports, "__esModule", { value: true });
 exports.ArchivalMemory = void 0;
 const environments = __importStar(require("../../../../../../environments"));
 const core = __importStar(require("../../../../../../core"));
+const Letta = __importStar(require("../../../../../index"));
 const url_join_1 = __importDefault(require("url-join"));
+const serializers = __importStar(require("../../../../../../serialization/index"));
 const errors = __importStar(require("../../../../../../errors/index"));
 class ArchivalMemory {
     constructor(_options = {}) {
         this._options = _options;
     }
     /**
+     * Retrieve the memories in an agent's archival memory store (paginated query).
+     *
      * @param {string} agentId
+     * @param {Letta.agents.ArchivalMemoryListRequest} request
      * @param {ArchivalMemory.RequestOptions} requestOptions - Request-specific configuration.
      *
+     * @throws {@link Letta.UnprocessableEntityError}
+     *
      * @example
      *     await client.agents.archivalMemory.list("agent_id")
      */
-    list(agentId, requestOptions) {
-        return __awaiter(this, void 0, void 0, function* () {
+    list(agentId_1) {
+        return __awaiter(this, arguments, void 0, function* (agentId, request = {}, requestOptions) {
             var _a, _b, _c;
+            const { after, before, limit } = request;
+            const _queryParams = {};
+            if (after != null) {
+                _queryParams["after"] = after.toString();
+            }
+            if (before != null) {
+                _queryParams["before"] = before.toString();
+            }
+            if (limit != null) {
+                _queryParams["limit"] = limit.toString();
+            }
             const _response = yield ((_a = this._options.fetcher) !== null && _a !== void 0 ? _a : core.fetcher)({
-                url: (0, url_join_1.default)((_c = (_b = (yield core.Supplier.get(this._options.baseUrl))) !== null && _b !== void 0 ? _b : (yield core.Supplier.get(this._options.environment))) !== null && _c !== void 0 ? _c : environments.LettaEnvironment.LettaCloud, `v1/agents/${encodeURIComponent(agentId)}/archival_memory`),
+                url: (0, url_join_1.default)((_c = (_b = (yield core.Supplier.get(this._options.baseUrl))) !== null && _b !== void 0 ? _b : (yield core.Supplier.get(this._options.environment))) !== null && _c !== void 0 ? _c : environments.LettaEnvironment.LettaCloud, `v1/agents/${encodeURIComponent(agentId)}/archival-memory`),
                 method: "GET",
-                headers: Object.assign(Object.assign({ "X-Fern-Language": "JavaScript", "X-Fern-SDK-Name": "@letta-ai/letta-client", "X-Fern-SDK-Version": "0.1.14", "User-Agent": "@letta-ai/letta-client/0.1.14", "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),
+                headers: Object.assign(Object.assign({ "X-Fern-Language": "JavaScript", "X-Fern-SDK-Name": "@letta-ai/letta-client", "X-Fern-SDK-Version": "0.1.15", "User-Agent": "@letta-ai/letta-client/0.1.15", "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",
                 timeoutMs: (requestOptions === null || requestOptions === void 0 ? void 0 : requestOptions.timeoutInSeconds) != null ? requestOptions.timeoutInSeconds * 1000 : 60000,
                 maxRetries: requestOptions === null || requestOptions === void 0 ? void 0 : requestOptions.maxRetries,
                 abortSignal: requestOptions === null || requestOptions === void 0 ? void 0 : requestOptions.abortSignal,
             });
             if (_response.ok) {
-                return;
+                return serializers.agents.archivalMemory.list.Response.parseOrThrow(_response.body, {
+                    unrecognizedObjectKeys: "passthrough",
+                    allowUnrecognizedUnionMembers: true,
+                    allowUnrecognizedEnumValues: true,
+                    skipValidation: true,
+                    breadcrumbsPrefix: ["response"],
+                });
             }
             if (_response.error.reason === "status-code") {
-                throw new errors.LettaError({
-                    statusCode: _response.error.statusCode,
-                    body: _response.error.body,
-                });
+                switch (_response.error.statusCode) {
+                    case 422:
+                        throw new Letta.UnprocessableEntityError(serializers.HttpValidationError.parseOrThrow(_response.error.body, {
+                            unrecognizedObjectKeys: "passthrough",
+                            allowUnrecognizedUnionMembers: true,
+                            allowUnrecognizedEnumValues: true,
+                            skipValidation: true,
+                            breadcrumbsPrefix: ["response"],
+                        }));
+                    default:
+                        throw new errors.LettaError({
+                            statusCode: _response.error.statusCode,
+                            body: _response.error.body,
+                        });
+                }
             }
             switch (_response.error.reason) {
                 case "non-json":
@@ -93,7 +129,7 @@ class ArchivalMemory {
                         body: _response.error.rawBody,
                     });
                 case "timeout":
-                    throw new errors.LettaTimeoutError("Timeout exceeded when calling GET /v1/agents/{agent_id}/archival_memory.");
+                    throw new errors.LettaTimeoutError("Timeout exceeded when calling GET /v1/agents/{agent_id}/archival-memory.");
                 case "unknown":
                     throw new errors.LettaError({
                         message: _response.error.errorMessage,
@@ -102,33 +138,58 @@ class ArchivalMemory {
         });
     }
     /**
+     * Insert a memory into an agent's archival memory store.
+     *
      * @param {string} agentId
+     * @param {Letta.agents.CreateArchivalMemory} request
      * @param {ArchivalMemory.RequestOptions} requestOptions - Request-specific configuration.
      *
+     * @throws {@link Letta.UnprocessableEntityError}
+     *
      * @example
-     *     await client.agents.archivalMemory.create("agent_id")
+     *     await client.agents.archivalMemory.create("agent_id", {
+     *         text: "text"
+     *     })
      */
-    create(agentId, requestOptions) {
+    create(agentId, request, requestOptions) {
         return __awaiter(this, void 0, void 0, function* () {
             var _a, _b, _c;
             const _response = yield ((_a = this._options.fetcher) !== null && _a !== void 0 ? _a : core.fetcher)({
-                url: (0, url_join_1.default)((_c = (_b = (yield core.Supplier.get(this._options.baseUrl))) !== null && _b !== void 0 ? _b : (yield core.Supplier.get(this._options.environment))) !== null && _c !== void 0 ? _c : environments.LettaEnvironment.LettaCloud, `v1/agents/${encodeURIComponent(agentId)}/archival_memory`),
+                url: (0, url_join_1.default)((_c = (_b = (yield core.Supplier.get(this._options.baseUrl))) !== null && _b !== void 0 ? _b : (yield core.Supplier.get(this._options.environment))) !== null && _c !== void 0 ? _c : environments.LettaEnvironment.LettaCloud, `v1/agents/${encodeURIComponent(agentId)}/archival-memory`),
                 method: "POST",
-                headers: Object.assign(Object.assign({ "X-Fern-Language": "JavaScript", "X-Fern-SDK-Name": "@letta-ai/letta-client", "X-Fern-SDK-Version": "0.1.14", "User-Agent": "@letta-ai/letta-client/0.1.14", "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),
+                headers: Object.assign(Object.assign({ "X-Fern-Language": "JavaScript", "X-Fern-SDK-Name": "@letta-ai/letta-client", "X-Fern-SDK-Version": "0.1.15", "User-Agent": "@letta-ai/letta-client/0.1.15", "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" }),
                 timeoutMs: (requestOptions === null || requestOptions === void 0 ? void 0 : requestOptions.timeoutInSeconds) != null ? requestOptions.timeoutInSeconds * 1000 : 60000,
                 maxRetries: requestOptions === null || requestOptions === void 0 ? void 0 : requestOptions.maxRetries,
                 abortSignal: requestOptions === null || requestOptions === void 0 ? void 0 : requestOptions.abortSignal,
             });
             if (_response.ok) {
-                return;
+                return serializers.agents.archivalMemory.create.Response.parseOrThrow(_response.body, {
+                    unrecognizedObjectKeys: "passthrough",
+                    allowUnrecognizedUnionMembers: true,
+                    allowUnrecognizedEnumValues: true,
+                    skipValidation: true,
+                    breadcrumbsPrefix: ["response"],
+                });
             }
             if (_response.error.reason === "status-code") {
-                throw new errors.LettaError({
-                    statusCode: _response.error.statusCode,
-                    body: _response.error.body,
-                });
+                switch (_response.error.statusCode) {
+                    case 422:
+                        throw new Letta.UnprocessableEntityError(serializers.HttpValidationError.parseOrThrow(_response.error.body, {
+                            unrecognizedObjectKeys: "passthrough",
+                            allowUnrecognizedUnionMembers: true,
+                            allowUnrecognizedEnumValues: true,
+                            skipValidation: true,
+                            breadcrumbsPrefix: ["response"],
+                        }));
+                    default:
+                        throw new errors.LettaError({
+                            statusCode: _response.error.statusCode,
+                            body: _response.error.body,
+                        });
+                }
             }
             switch (_response.error.reason) {
                 case "non-json":
@@ -137,7 +198,7 @@ class ArchivalMemory {
                         body: _response.error.rawBody,
                     });
                 case "timeout":
-                    throw new errors.LettaTimeoutError("Timeout exceeded when calling POST /v1/agents/{agent_id}/archival_memory.");
+                    throw new errors.LettaTimeoutError("Timeout exceeded when calling POST /v1/agents/{agent_id}/archival-memory.");
                 case "unknown":
                     throw new errors.LettaError({
                         message: _response.error.errorMessage,
@@ -146,10 +207,14 @@ class ArchivalMemory {
         });
     }
     /**
+     * Delete a memory from an agent's archival memory store.
+     *
      * @param {string} agentId
      * @param {string} memoryId
      * @param {ArchivalMemory.RequestOptions} requestOptions - Request-specific configuration.
      *
+     * @throws {@link Letta.UnprocessableEntityError}
+     *
      * @example
      *     await client.agents.archivalMemory.delete("agent_id", "memory_id")
      */
@@ -157,9 +222,9 @@ class ArchivalMemory {
         return __awaiter(this, void 0, void 0, function* () {
             var _a, _b, _c;
             const _response = yield ((_a = this._options.fetcher) !== null && _a !== void 0 ? _a : core.fetcher)({
-                url: (0, url_join_1.default)((_c = (_b = (yield core.Supplier.get(this._options.baseUrl))) !== null && _b !== void 0 ? _b : (yield core.Supplier.get(this._options.environment))) !== null && _c !== void 0 ? _c : environments.LettaEnvironment.LettaCloud, `v1/agents/${encodeURIComponent(agentId)}/archival_memory/${encodeURIComponent(memoryId)}`),
+                url: (0, url_join_1.default)((_c = (_b = (yield core.Supplier.get(this._options.baseUrl))) !== null && _b !== void 0 ? _b : (yield core.Supplier.get(this._options.environment))) !== null && _c !== void 0 ? _c : environments.LettaEnvironment.LettaCloud, `v1/agents/${encodeURIComponent(agentId)}/archival-memory/${encodeURIComponent(memoryId)}`),
                 method: "DELETE",
-                headers: Object.assign(Object.assign({ "X-Fern-Language": "JavaScript", "X-Fern-SDK-Name": "@letta-ai/letta-client", "X-Fern-SDK-Version": "0.1.14", "User-Agent": "@letta-ai/letta-client/0.1.14", "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),
+                headers: Object.assign(Object.assign({ "X-Fern-Language": "JavaScript", "X-Fern-SDK-Name": "@letta-ai/letta-client", "X-Fern-SDK-Version": "0.1.15", "User-Agent": "@letta-ai/letta-client/0.1.15", "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,
@@ -167,13 +232,24 @@ class ArchivalMemory {
                 abortSignal: requestOptions === null || requestOptions === void 0 ? void 0 : requestOptions.abortSignal,
             });
             if (_response.ok) {
-                return;
+                return _response.body;
             }
             if (_response.error.reason === "status-code") {
-                throw new errors.LettaError({
-                    statusCode: _response.error.statusCode,
-                    body: _response.error.body,
-                });
+                switch (_response.error.statusCode) {
+                    case 422:
+                        throw new Letta.UnprocessableEntityError(serializers.HttpValidationError.parseOrThrow(_response.error.body, {
+                            unrecognizedObjectKeys: "passthrough",
+                            allowUnrecognizedUnionMembers: true,
+                            allowUnrecognizedEnumValues: true,
+                            skipValidation: true,
+                            breadcrumbsPrefix: ["response"],
+                        }));
+                    default:
+                        throw new errors.LettaError({
+                            statusCode: _response.error.statusCode,
+                            body: _response.error.body,
+                        });
+                }
             }
             switch (_response.error.reason) {
                 case "non-json":
@@ -182,7 +258,7 @@ class ArchivalMemory {
                         body: _response.error.rawBody,
                     });
                 case "timeout":
-                    throw new errors.LettaTimeoutError("Timeout exceeded when calling DELETE /v1/agents/{agent_id}/archival_memory/{memory_id}.");
+                    throw new errors.LettaTimeoutError("Timeout exceeded when calling DELETE /v1/agents/{agent_id}/archival-memory/{memory_id}.");
                 case "unknown":
                     throw new errors.LettaError({
                         message: _response.error.errorMessage,

package/api/resources/agents/resources/archivalMemory/client/index.d.ts

@@ -1 +1 @@
-export {};
+export * from "./requests";

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

@@ -1,2 +1,17 @@
 "use strict";
+var __createBinding = (this && this.__createBinding) || (Object.create ? (function(o, m, k, k2) {
+    if (k2 === undefined) k2 = k;
+    var desc = Object.getOwnPropertyDescriptor(m, k);
+    if (!desc || ("get" in desc ? !m.__esModule : desc.writable || desc.configurable)) {
+      desc = { enumerable: true, get: function() { return m[k]; } };
+    }
+    Object.defineProperty(o, k2, desc);
+}) : (function(o, m, k, k2) {
+    if (k2 === undefined) k2 = k;
+    o[k2] = m[k];
+}));
+var __exportStar = (this && this.__exportStar) || function(m, exports) {
+    for (var p in m) if (p !== "default" && !Object.prototype.hasOwnProperty.call(exports, p)) __createBinding(exports, m, p);
+};
 Object.defineProperty(exports, "__esModule", { value: true });
+__exportStar(require("./requests"), exports);

package/api/resources/agents/{client/requests/ListArchivalMemoryRequest.d.ts → resources/archivalMemory/client/requests/ArchivalMemoryListRequest.d.ts}

@@ -5,7 +5,7 @@
  * @example
  *     {}
  */
-export interface ListArchivalMemoryRequest {
+export interface ArchivalMemoryListRequest {
     /**
      * Unique ID of the memory to start the query range at.
      */

package/api/resources/agents/resources/archivalMemory/client/requests/index.d.ts

@@ -0,0 +1,2 @@
+export { type ArchivalMemoryListRequest } from "./ArchivalMemoryListRequest";
+export { type CreateArchivalMemory } from "./CreateArchivalMemory";

package/api/resources/agents/resources/archivalMemory/client/requests/index.js

@@ -0,0 +1,2 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });

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

@@ -76,7 +76,7 @@ class Context {
             const _response = yield ((_a = this._options.fetcher) !== null && _a !== void 0 ? _a : core.fetcher)({
                 url: (0, url_join_1.default)((_c = (_b = (yield core.Supplier.get(this._options.baseUrl))) !== null && _b !== void 0 ? _b : (yield core.Supplier.get(this._options.environment))) !== null && _c !== void 0 ? _c : environments.LettaEnvironment.LettaCloud, `v1/agents/${encodeURIComponent(agentId)}/context`),
                 method: "GET",
-                headers: Object.assign(Object.assign({ "X-Fern-Language": "JavaScript", "X-Fern-SDK-Name": "@letta-ai/letta-client", "X-Fern-SDK-Version": "0.1.14", "User-Agent": "@letta-ai/letta-client/0.1.14", "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),
+                headers: Object.assign(Object.assign({ "X-Fern-Language": "JavaScript", "X-Fern-SDK-Name": "@letta-ai/letta-client", "X-Fern-SDK-Version": "0.1.15", "User-Agent": "@letta-ai/letta-client/0.1.15", "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

@@ -3,6 +3,7 @@
  */
 import * as environments from "../../../../../../environments";
 import * as core from "../../../../../../core";
+import * as Letta from "../../../../../index";
 export declare namespace CoreMemory {
     interface Options {
         environment?: core.Supplier<environments.LettaEnvironment | string>;
@@ -26,57 +27,83 @@ export declare class CoreMemory {
     protected readonly _options: CoreMemory.Options;
     constructor(_options?: CoreMemory.Options);
     /**
+     * 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 {CoreMemory.RequestOptions} requestOptions - Request-specific configuration.
      *
+     * @throws {@link Letta.UnprocessableEntityError}
+     *
      * @example
      *     await client.agents.coreMemory.retrieve("agent_id")
      */
-    retrieve(agentId: string, requestOptions?: CoreMemory.RequestOptions): Promise<void>;
+    retrieve(agentId: string, requestOptions?: CoreMemory.RequestOptions): Promise<Letta.Memory>;
     /**
+     * Retrieve a memory block from an agent.
+     *
      * @param {string} agentId
+     * @param {string} blockLabel
      * @param {CoreMemory.RequestOptions} requestOptions - Request-specific configuration.
      *
+     * @throws {@link Letta.UnprocessableEntityError}
+     *
      * @example
-     *     await client.agents.coreMemory.listBlocks("agent_id")
+     *     await client.agents.coreMemory.retrieveBlock("agent_id", "block_label")
      */
-    listBlocks(agentId: string, requestOptions?: CoreMemory.RequestOptions): Promise<void>;
+    retrieveBlock(agentId: string, blockLabel: string, requestOptions?: CoreMemory.RequestOptions): Promise<Letta.Block>;
     /**
+     * Updates a memory block of an agent.
+     *
      * @param {string} agentId
-     * @param {string} blockId
+     * @param {string} blockLabel
+     * @param {Letta.BlockUpdate} request
      * @param {CoreMemory.RequestOptions} requestOptions - Request-specific configuration.
      *
+     * @throws {@link Letta.UnprocessableEntityError}
+     *
      * @example
-     *     await client.agents.coreMemory.attachBlock("agent_id", "block_id")
+     *     await client.agents.coreMemory.modifyBlock("agent_id", "block_label", {})
      */
-    attachBlock(agentId: string, blockId: string, requestOptions?: CoreMemory.RequestOptions): Promise<void>;
+    modifyBlock(agentId: string, blockLabel: string, request: Letta.BlockUpdate, requestOptions?: CoreMemory.RequestOptions): Promise<Letta.Block>;
     /**
+     * Retrieve the memory blocks of a specific agent.
+     *
      * @param {string} agentId
-     * @param {string} blockId
      * @param {CoreMemory.RequestOptions} requestOptions - Request-specific configuration.
      *
+     * @throws {@link Letta.UnprocessableEntityError}
+     *
      * @example
-     *     await client.agents.coreMemory.detachBlock("agent_id", "block_id")
+     *     await client.agents.coreMemory.listBlocks("agent_id")
      */
-    detachBlock(agentId: string, blockId: string, requestOptions?: CoreMemory.RequestOptions): Promise<void>;
+    listBlocks(agentId: string, requestOptions?: CoreMemory.RequestOptions): Promise<Letta.Block[]>;
     /**
+     * Attach a block to an agent.
+     *
      * @param {string} agentId
-     * @param {string} blockLabel
+     * @param {string} blockId
      * @param {CoreMemory.RequestOptions} requestOptions - Request-specific configuration.
      *
+     * @throws {@link Letta.UnprocessableEntityError}
+     *
      * @example
-     *     await client.agents.coreMemory.retrieveBlock("agent_id", "block_label")
+     *     await client.agents.coreMemory.attachBlock("agent_id", "block_id")
      */
-    retrieveBlock(agentId: string, blockLabel: string, requestOptions?: CoreMemory.RequestOptions): Promise<void>;
+    attachBlock(agentId: string, blockId: string, requestOptions?: CoreMemory.RequestOptions): Promise<Letta.AgentState>;
     /**
+     * Detach a block from an agent.
+     *
      * @param {string} agentId
-     * @param {string} blockLabel
+     * @param {string} blockId
      * @param {CoreMemory.RequestOptions} requestOptions - Request-specific configuration.
      *
+     * @throws {@link Letta.UnprocessableEntityError}
+     *
      * @example
-     *     await client.agents.coreMemory.modifyBlock("agent_id", "block_label")
+     *     await client.agents.coreMemory.detachBlock("agent_id", "block_id")
      */
-    modifyBlock(agentId: string, blockLabel: string, requestOptions?: CoreMemory.RequestOptions): Promise<void>;
+    detachBlock(agentId: string, blockId: string, requestOptions?: CoreMemory.RequestOptions): Promise<Letta.AgentState>;
     protected _getCustomAuthorizationHeaders(): Promise<{
         Authorization: string;
     }>;