In-Memory Storage

InMemoryStorage is the simplest storage driver. It keeps all data in a JavaScript Map—no external dependencies, no disk I/O. Data is lost when the process restarts. Use it for development, testing, or ephemeral workloads.

When to Use

Development

Fast iteration. No database setup required.

Testing

Isolated tests. No shared state between runs.

Demos

Quick prototypes. No infrastructure needed.

Not for Production

Data is lost on restart. Use Sqlite, Postgres, or MongoDB for persistence.

Installation

No additional packages required. InMemoryStorage is included in @agentium/core.

Usage

import { InMemoryStorage } from "@agentium/core";

const storage = new InMemoryStorage();

// No initialize() needed—ready to use immediately
await storage.set("namespace", "key", { foo: "bar" });
const value = await storage.get<{ foo: string }>("namespace", "key");
console.log(value); // { foo: "bar" }

const items = await storage.list("namespace", "k");
console.log(items); // [{ key: "key", value: { foo: "bar" } }]

await storage.delete("namespace", "key");
await storage.close();

With Agent

Sessions need memory.storage. Bare Agent still keeps a tiny in-memory session for the current process, but it is gone on restart and is not a storage: field.

import { Agent, InMemoryStorage, openai } from "@agentium/core";

const agent = new Agent({
  name: "Assistant",
  model: openai(process.env.OPENAI_MODEL ?? "gpt-6.1-sol"),
  memory: { storage: new InMemoryStorage() },
});

await agent.run("Hello!", { sessionId: "user-123" });

Limitations

Limitation	Description
No persistence	All data is lost when the Node.js process exits.
Single process	Not shared across multiple server instances.
Memory bound	Large datasets consume RAM.
No backup	No built-in snapshot or export.

API Reference

Method	Signature	Description
`get`	`get<T>(namespace, key) => Promise<T \| null>`	Get value by key.
`set`	`set<T>(namespace, key, value) => Promise<void>`	Store value (JSON-serialized).
`delete`	`delete(namespace, key) => Promise<void>`	Remove key.
`list`	`list<T>(namespace, prefix?) => Promise<Array<{key, value}>>`	List keys, optionally with prefix.
`close`	`close() => Promise<void>`	Clears the in-memory store.

Find an integration

Voice and call adapters

Sandbox and telemetry

Providers and services

Protocols and devices

In-Memory Storage

When to Use

Development

Testing

Demos

Not for Production

Installation

Usage

With Agent

Limitations

API Reference

​When to Use

Development

Testing

Demos

Not for Production

​Installation

​Usage

​With Agent

​Limitations

​API Reference

When to Use

Installation

Usage

With Agent

Limitations

API Reference