Memory

Session-scoped key-value storage. Keys are automatically namespaced by agentId and sessionId.

Access memory methods via agent.memory.<method>

Set value

Store a key-value pair.

TypeScript

async set(key: string, value: string): Promise<MemorySetResponse>

Python

Parameters:

• key (string): Unique identifier (1-255 characters)

• value (string): String value to store

Response:

• success (boolean): Whether the operation succeeded

• data.key (string): The key that was set (on success)

• error (string | null): Error message (on failure)

Example:

TypeScript

const result = await agent.memory.set("lastSwapNetwork", "ethereum:42161");
if (result.success && result.data) {
  await agent.log(`Stored: ${result.data.key}`);
}

Python

Get value

Retrieve a value by key.

TypeScript

async get(key: string): Promise<MemoryGetResponse>

Python

Parameters:

• key (string): The key to retrieve

Response:

• success (boolean): Whether the operation succeeded

• data.key (string): The requested key (on success)

• data.value (string): The stored value (on success)

• error (string | null): Error message if key not found

Example:

TypeScript

const result = await agent.memory.get("lastSwapNetwork");
if (result.success && result.data) {
  await agent.log(`Network: ${result.data.value}`);
} else {
  await agent.log(`Key not found: ${result.error}`);
}

Python

Delete value

Remove a key-value pair.

TypeScript

async delete(key: string): Promise<MemoryDeleteResponse>

Python

Parameters:

• key (string): The key to delete

Response:

• success (boolean): Whether the operation succeeded

• data.key (string): The deleted key (on success)

• error (string | null): Error message (on failure)

Note: Succeeds even if the key doesn't exist.

Example:

TypeScript

const result = await agent.memory.delete("tempSwapQuote");
if (result.success && result.data) {
  await agent.log(`Deleted: ${result.data.key}`);
}

Python

List session memory keys

List all keys in session memory.

TypeScript

async list(): Promise<MemoryListResponse>

Python

Response:

• success (boolean): Whether the operation succeeded

• data.keys (string[]): Array of all stored keys (on success)

• data.count (number): Number of keys (on success)

• error (string | null): Error message (on failure)

Example:

TypeScript

const result = await agent.memory.list();
if (result.success && result.data) {
  await agent.log(`Found ${result.data.count} keys:`);
  for (const key of result.data.keys) {
    await agent.log(`  - ${key}`);
  }
}

Python

Notes

• Values must be strings. Serialize complex data (JSON, numbers) before storing.

• Keys are automatically scoped to the current agent session.

• Memory persists across execution cycles within the same session.

• Storage is cleared when the session ends.