@letta-ai/letta-client 0.1.37 → 0.1.39

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

@@ -8,7 +8,8 @@ import { Context } from "../resources/context/client/Client";
 import { Tools } from "../resources/tools/client/Client";
 import { Sources } from "../resources/sources/client/Client";
 import { CoreMemory } from "../resources/coreMemory/client/Client";
-import { ArchivalMemory } from "../resources/archivalMemory/client/Client";
+import { Blocks } from "../resources/blocks/client/Client";
+import { Passages } from "../resources/passages/client/Client";
 import { Messages } from "../resources/messages/client/Client";
 import { Templates } from "../resources/templates/client/Client";
 import { MemoryVariables } from "../resources/memoryVariables/client/Client";
@@ -37,7 +38,8 @@ export declare class Agents {
     protected _tools: Tools | undefined;
     protected _sources: Sources | undefined;
     protected _coreMemory: CoreMemory | undefined;
-    protected _archivalMemory: ArchivalMemory | undefined;
+    protected _blocks: Blocks | undefined;
+    protected _passages: Passages | undefined;
     protected _messages: Messages | undefined;
     protected _templates: Templates | undefined;
     protected _memoryVariables: MemoryVariables | undefined;
@@ -46,7 +48,8 @@ export declare class Agents {
     get tools(): Tools;
     get sources(): Sources;
     get coreMemory(): CoreMemory;
-    get archivalMemory(): ArchivalMemory;
+    get blocks(): Blocks;
+    get passages(): Passages;
     get messages(): Messages;
     get templates(): Templates;
     get memoryVariables(): MemoryVariables;

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

@@ -70,10 +70,11 @@ const Client_1 = require("../resources/context/client/Client");
 const Client_2 = require("../resources/tools/client/Client");
 const Client_3 = require("../resources/sources/client/Client");
 const Client_4 = require("../resources/coreMemory/client/Client");
-const Client_5 = require("../resources/archivalMemory/client/Client");
-const Client_6 = require("../resources/messages/client/Client");
-const Client_7 = require("../resources/templates/client/Client");
-const Client_8 = require("../resources/memoryVariables/client/Client");
+const Client_5 = require("../resources/blocks/client/Client");
+const Client_6 = require("../resources/passages/client/Client");
+const Client_7 = require("../resources/messages/client/Client");
+const Client_8 = require("../resources/templates/client/Client");
+const Client_9 = require("../resources/memoryVariables/client/Client");
 class Agents {
     constructor(_options = {}) {
         this._options = _options;
@@ -94,21 +95,25 @@ class Agents {
         var _a;
         return ((_a = this._coreMemory) !== null && _a !== void 0 ? _a : (this._coreMemory = new Client_4.CoreMemory(this._options)));
     }
-    get archivalMemory() {
+    get blocks() {
         var _a;
-        return ((_a = this._archivalMemory) !== null && _a !== void 0 ? _a : (this._archivalMemory = new Client_5.ArchivalMemory(this._options)));
+        return ((_a = this._blocks) !== null && _a !== void 0 ? _a : (this._blocks = new Client_5.Blocks(this._options)));
+    }
+    get passages() {
+        var _a;
+        return ((_a = this._passages) !== null && _a !== void 0 ? _a : (this._passages = new Client_6.Passages(this._options)));
     }
     get messages() {
         var _a;
-        return ((_a = this._messages) !== null && _a !== void 0 ? _a : (this._messages = new Client_6.Messages(this._options)));
+        return ((_a = this._messages) !== null && _a !== void 0 ? _a : (this._messages = new Client_7.Messages(this._options)));
     }
     get templates() {
         var _a;
-        return ((_a = this._templates) !== null && _a !== void 0 ? _a : (this._templates = new Client_7.Templates(this._options)));
+        return ((_a = this._templates) !== null && _a !== void 0 ? _a : (this._templates = new Client_8.Templates(this._options)));
     }
     get memoryVariables() {
         var _a;
-        return ((_a = this._memoryVariables) !== null && _a !== void 0 ? _a : (this._memoryVariables = new Client_8.MemoryVariables(this._options)));
+        return ((_a = this._memoryVariables) !== null && _a !== void 0 ? _a : (this._memoryVariables = new Client_9.MemoryVariables(this._options)));
     }
     /**
      * List all agents associated with a given user.
@@ -125,7 +130,7 @@ class Agents {
     list() {
         return __awaiter(this, arguments, void 0, function* (request = {}, requestOptions) {
             var _a, _b, _c;
-            const { name, tags, matchAllTags, before, after, limit, queryText, projectId, templateId, baseTemplateId, identifierKey, } = request;
+            const { name, tags, matchAllTags, before, after, limit, queryText, projectId, templateId, baseTemplateId, identifierKeys, } = request;
             const _queryParams = {};
             if (name != null) {
                 _queryParams["name"] = name;
@@ -162,13 +167,18 @@ class Agents {
             if (baseTemplateId != null) {
                 _queryParams["base_template_id"] = baseTemplateId;
             }
-            if (identifierKey != null) {
-                _queryParams["identifier_key"] = identifierKey;
+            if (identifierKeys != null) {
+                if (Array.isArray(identifierKeys)) {
+                    _queryParams["identifier_keys"] = identifierKeys.map((item) => item);
+                }
+                else {
+                    _queryParams["identifier_keys"] = identifierKeys;
+                }
             }
             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/"),
                 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.37", "User-Agent": "@letta-ai/letta-client/0.1.37", "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.39", "User-Agent": "@letta-ai/letta-client/0.1.39", "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",
@@ -235,7 +245,7 @@ class Agents {
             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/"),
                 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.37", "User-Agent": "@letta-ai/letta-client/0.1.37", "X-Fern-Runtime": core.RUNTIME.type, "X-Fern-Runtime-Version": core.RUNTIME.version, "X-Project": project != null ? project : undefined }, (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.39", "User-Agent": "@letta-ai/letta-client/0.1.39", "X-Fern-Runtime": core.RUNTIME.type, "X-Fern-Runtime-Version": core.RUNTIME.version, "X-Project": project != null ? project : undefined }, (yield this._getCustomAuthorizationHeaders())), requestOptions === null || requestOptions === void 0 ? void 0 : requestOptions.headers),
                 contentType: "application/json",
                 requestType: "json",
                 body: serializers.CreateAgentRequest.jsonOrThrow(_body, { unrecognizedObjectKeys: "strip" }),
@@ -301,7 +311,7 @@ class Agents {
             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)}`),
                 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.37", "User-Agent": "@letta-ai/letta-client/0.1.37", "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.39", "User-Agent": "@letta-ai/letta-client/0.1.39", "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,
@@ -366,7 +376,7 @@ class Agents {
             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)}`),
                 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.37", "User-Agent": "@letta-ai/letta-client/0.1.37", "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.39", "User-Agent": "@letta-ai/letta-client/0.1.39", "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,
@@ -426,7 +436,7 @@ class Agents {
             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)}`),
                 method: "PATCH",
-                headers: Object.assign(Object.assign({ "X-Fern-Language": "JavaScript", "X-Fern-SDK-Name": "@letta-ai/letta-client", "X-Fern-SDK-Version": "0.1.37", "User-Agent": "@letta-ai/letta-client/0.1.37", "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.39", "User-Agent": "@letta-ai/letta-client/0.1.39", "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" }),
@@ -498,7 +508,7 @@ class Agents {
             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)}/reset-messages`),
                 method: "PATCH",
-                headers: Object.assign(Object.assign({ "X-Fern-Language": "JavaScript", "X-Fern-SDK-Name": "@letta-ai/letta-client", "X-Fern-SDK-Version": "0.1.37", "User-Agent": "@letta-ai/letta-client/0.1.37", "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.39", "User-Agent": "@letta-ai/letta-client/0.1.39", "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",
@@ -564,7 +574,7 @@ class Agents {
             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/search"),
                 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.37", "User-Agent": "@letta-ai/letta-client/0.1.37", "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.39", "User-Agent": "@letta-ai/letta-client/0.1.39", "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/AgentsListRequest.d.ts

@@ -47,7 +47,7 @@ export interface AgentsListRequest {
      */
     baseTemplateId?: string;
     /**
-     * Search agents by identifier key
+     * Search agents by identifier keys
      */
-    identifierKey?: string;
+    identifierKeys?: string | string[];
 }

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

@@ -68,8 +68,8 @@ export interface CreateAgentRequest {
     templateId?: string;
     /** The base template id of the agent. */
     baseTemplateId?: string;
-    /** The identifier key belonging to the identity associated with this agent. */
-    identifierKey?: string;
+    /** The ids of the identities associated with this agent. */
+    identityIds?: string[];
     /** If set to True, the agent will not remember previous messages (though the agent will still retain state via core memory blocks and archival/recall memory). Not recommended unless you have an advanced use case. */
     messageBufferAutoclear?: boolean;
 }

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

@@ -39,8 +39,8 @@ export interface UpdateAgent {
     templateId?: string;
     /** The base template id of the agent. */
     baseTemplateId?: string;
-    /** The identifier key belonging to the identity associated with this agent. */
-    identifierKey?: string;
+    /** The ids of the identities associated with this agent. */
+    identityIds?: string[];
     /** If set to True, the agent will not remember previous messages (though the agent will still retain state via core memory blocks and archival/recall memory). Not recommended unless you have an advanced use case. */
     messageBufferAutoclear?: boolean;
 }

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

@@ -0,0 +1,97 @@
+/**
+ * This file was auto-generated by Fern from our API Definition.
+ */
+import * as environments from "../../../../../../environments";
+import * as core from "../../../../../../core";
+import * as Letta from "../../../../../index";
+export declare namespace Blocks {
+    interface Options {
+        environment?: core.Supplier<environments.LettaEnvironment | string>;
+        /** Specify a custom URL to connect the client to. */
+        baseUrl?: core.Supplier<string>;
+        token?: core.Supplier<string | undefined>;
+        fetcher?: core.FetchFunction;
+    }
+    interface RequestOptions {
+        /** The maximum time to wait for a response in seconds. */
+        timeoutInSeconds?: number;
+        /** The number of times to retry the request. Defaults to 2. */
+        maxRetries?: number;
+        /** A hook to abort the request. */
+        abortSignal?: AbortSignal;
+        /** Additional headers to include in the request. */
+        headers?: Record<string, string>;
+    }
+}
+export declare class Blocks {
+    protected readonly _options: Blocks.Options;
+    constructor(_options?: Blocks.Options);
+    /**
+     * Retrieve a memory block from an agent.
+     *
+     * @param {string} agentId
+     * @param {string} blockLabel
+     * @param {Blocks.RequestOptions} requestOptions - Request-specific configuration.
+     *
+     * @throws {@link Letta.UnprocessableEntityError}
+     *
+     * @example
+     *     await client.agents.blocks.retrieve("agent_id", "block_label")
+     */
+    retrieve(agentId: string, blockLabel: string, requestOptions?: Blocks.RequestOptions): Promise<Letta.Block>;
+    /**
+     * Updates a memory block of an agent.
+     *
+     * @param {string} agentId
+     * @param {string} blockLabel
+     * @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", {})
+     */
+    modify(agentId: string, blockLabel: string, request: Letta.BlockUpdate, requestOptions?: Blocks.RequestOptions): Promise<Letta.Block>;
+    /**
+     * Retrieve the memory blocks of a specific agent.
+     *
+     * @param {string} agentId
+     * @param {Blocks.RequestOptions} requestOptions - Request-specific configuration.
+     *
+     * @throws {@link Letta.UnprocessableEntityError}
+     *
+     * @example
+     *     await client.agents.blocks.list("agent_id")
+     */
+    list(agentId: string, requestOptions?: Blocks.RequestOptions): Promise<Letta.Block[]>;
+    /**
+     * Attach a block to an agent.
+     *
+     * @param {string} agentId
+     * @param {string} blockId
+     * @param {Blocks.RequestOptions} requestOptions - Request-specific configuration.
+     *
+     * @throws {@link Letta.UnprocessableEntityError}
+     *
+     * @example
+     *     await client.agents.blocks.attach("agent_id", "block_id")
+     */
+    attach(agentId: string, blockId: string, requestOptions?: Blocks.RequestOptions): Promise<Letta.AgentState>;
+    /**
+     * Detach a block from an agent.
+     *
+     * @param {string} agentId
+     * @param {string} blockId
+     * @param {Blocks.RequestOptions} requestOptions - Request-specific configuration.
+     *
+     * @throws {@link Letta.UnprocessableEntityError}
+     *
+     * @example
+     *     await client.agents.blocks.detach("agent_id", "block_id")
+     */
+    detach(agentId: string, blockId: string, requestOptions?: Blocks.RequestOptions): Promise<Letta.AgentState>;
+    protected _getCustomAuthorizationHeaders(): Promise<{
+        Authorization: string;
+    }>;
+}