@letta-ai/letta-client 0.1.12 → 0.1.13

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

@@ -7,11 +7,11 @@ import * as Letta from "../../../index";
 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 { Messages } from "../resources/messages/client/Client";
 import { Templates } from "../resources/templates/client/Client";
 import { MemoryVariables } from "../resources/memoryVariables/client/Client";
+import { CoreMemory } from "../resources/coreMemory/client/Client";
+import { ArchivalMemory } from "../resources/archivalMemory/client/Client";
 export declare namespace Agents {
     interface Options {
         environment?: core.Supplier<environments.LettaEnvironment | string>;
@@ -36,20 +36,20 @@ export declare class Agents {
     protected _context: Context | undefined;
     protected _tools: Tools | undefined;
     protected _sources: Sources | undefined;
-    protected _coreMemory: CoreMemory | undefined;
-    protected _archivalMemory: ArchivalMemory | undefined;
     protected _messages: Messages | undefined;
     protected _templates: Templates | undefined;
     protected _memoryVariables: MemoryVariables | undefined;
+    protected _coreMemory: CoreMemory | undefined;
+    protected _archivalMemory: ArchivalMemory | undefined;
     constructor(_options?: Agents.Options);
     get context(): Context;
     get tools(): Tools;
     get sources(): Sources;
-    get coreMemory(): CoreMemory;
-    get archivalMemory(): ArchivalMemory;
     get messages(): Messages;
     get templates(): Templates;
     get memoryVariables(): MemoryVariables;
+    get coreMemory(): CoreMemory;
+    get archivalMemory(): ArchivalMemory;
     /**
      * List all agents associated with a given user.
      * This endpoint retrieves a list of all agents and their configurations associated with the specified user ID.
@@ -84,9 +84,9 @@ export declare class Agents {
      * @throws {@link Letta.UnprocessableEntityError}
      *
      * @example
-     *     await client.agents.get("agent_id")
+     *     await client.agents.retrieve("agent_id")
      */
-    get(agentId: string, requestOptions?: Agents.RequestOptions): Promise<Letta.AgentState>;
+    retrieve(agentId: string, requestOptions?: Agents.RequestOptions): Promise<Letta.AgentState>;
     /**
      * Delete an agent.
      *
@@ -109,9 +109,128 @@ export declare class Agents {
      * @throws {@link Letta.UnprocessableEntityError}
      *
      * @example
-     *     await client.agents.update("agent_id")
+     *     await client.agents.modify("agent_id")
+     */
+    modify(agentId: string, request?: Letta.UpdateAgent, requestOptions?: Agents.RequestOptions): Promise<Letta.AgentState>;
+    /**
+     * 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 {Agents.RequestOptions} requestOptions - Request-specific configuration.
+     *
+     * @throws {@link Letta.UnprocessableEntityError}
+     *
+     * @example
+     *     await client.agents.retrieveAgentMemory("agent_id")
+     */
+    retrieveAgentMemory(agentId: string, requestOptions?: Agents.RequestOptions): Promise<Letta.Memory>;
+    /**
+     * Retrieve a memory block from an agent.
+     *
+     * @param {string} agentId
+     * @param {string} blockLabel
+     * @param {Agents.RequestOptions} requestOptions - Request-specific configuration.
+     *
+     * @throws {@link Letta.UnprocessableEntityError}
+     *
+     * @example
+     *     await client.agents.retrieveCoreMemoryBlock("agent_id", "block_label")
+     */
+    retrieveCoreMemoryBlock(agentId: string, blockLabel: string, requestOptions?: Agents.RequestOptions): Promise<Letta.Block>;
+    /**
+     * Updates a memory block of an agent.
+     *
+     * @param {string} agentId
+     * @param {string} blockLabel
+     * @param {Letta.BlockUpdate} request
+     * @param {Agents.RequestOptions} requestOptions - Request-specific configuration.
+     *
+     * @throws {@link Letta.UnprocessableEntityError}
+     *
+     * @example
+     *     await client.agents.modifyCoreMemoryBlock("agent_id", "block_label", {})
+     */
+    modifyCoreMemoryBlock(agentId: string, blockLabel: string, request: Letta.BlockUpdate, requestOptions?: Agents.RequestOptions): Promise<Letta.Block>;
+    /**
+     * Retrieve the memory blocks of a specific agent.
+     *
+     * @param {string} agentId
+     * @param {Agents.RequestOptions} requestOptions - Request-specific configuration.
+     *
+     * @throws {@link Letta.UnprocessableEntityError}
+     *
+     * @example
+     *     await client.agents.listCoreMemoryBlocks("agent_id")
+     */
+    listCoreMemoryBlocks(agentId: string, requestOptions?: Agents.RequestOptions): Promise<Letta.Block[]>;
+    /**
+     * Attach a block to an agent.
+     *
+     * @param {string} agentId
+     * @param {string} blockId
+     * @param {Agents.RequestOptions} requestOptions - Request-specific configuration.
+     *
+     * @throws {@link Letta.UnprocessableEntityError}
+     *
+     * @example
+     *     await client.agents.attachCoreMemoryBlock("agent_id", "block_id")
+     */
+    attachCoreMemoryBlock(agentId: string, blockId: string, requestOptions?: Agents.RequestOptions): Promise<Letta.AgentState>;
+    /**
+     * Detach a block from an agent.
+     *
+     * @param {string} agentId
+     * @param {string} blockId
+     * @param {Agents.RequestOptions} requestOptions - Request-specific configuration.
+     *
+     * @throws {@link Letta.UnprocessableEntityError}
+     *
+     * @example
+     *     await client.agents.detachCoreMemoryBlock("agent_id", "block_id")
+     */
+    detachCoreMemoryBlock(agentId: string, blockId: string, requestOptions?: Agents.RequestOptions): Promise<Letta.AgentState>;
+    /**
+     * Retrieve the memories in an agent's archival memory store (paginated query).
+     *
+     * @param {string} agentId
+     * @param {Letta.ListArchivalMemoryRequest} request
+     * @param {Agents.RequestOptions} requestOptions - Request-specific configuration.
+     *
+     * @throws {@link Letta.UnprocessableEntityError}
+     *
+     * @example
+     *     await client.agents.listArchivalMemory("agent_id")
+     */
+    listArchivalMemory(agentId: string, request?: Letta.ListArchivalMemoryRequest, requestOptions?: Agents.RequestOptions): Promise<Letta.Passage[]>;
+    /**
+     * Insert a memory into an agent's archival memory store.
+     *
+     * @param {string} agentId
+     * @param {Letta.CreateArchivalMemory} request
+     * @param {Agents.RequestOptions} requestOptions - Request-specific configuration.
+     *
+     * @throws {@link Letta.UnprocessableEntityError}
+     *
+     * @example
+     *     await client.agents.createArchivalMemory("agent_id", {
+     *         text: "text"
+     *     })
+     */
+    createArchivalMemory(agentId: string, request: Letta.CreateArchivalMemory, requestOptions?: Agents.RequestOptions): Promise<Letta.Passage[]>;
+    /**
+     * Delete a memory from an agent's archival memory store.
+     *
+     * @param {string} agentId
+     * @param {string} memoryId
+     * @param {Agents.RequestOptions} requestOptions - Request-specific configuration.
+     *
+     * @throws {@link Letta.UnprocessableEntityError}
+     *
+     * @example
+     *     await client.agents.deleteArchivalMemory("agent_id", "memory_id")
      */
-    update(agentId: string, request?: Letta.UpdateAgent, requestOptions?: Agents.RequestOptions): Promise<Letta.AgentState>;
+    deleteArchivalMemory(agentId: string, memoryId: string, requestOptions?: Agents.RequestOptions): Promise<unknown>;
     /**
      * Resets the messages for an agent
      *