Honcho memory

@maniac-ai/agents

---

Classes

HonchoMemory

Defined in: src/memory/adapters/honcho.ts:132

Implements

• Memory

Constructors

Constructor

new HonchoMemory(options?): HonchoMemory

Defined in: src/memory/adapters/honcho.ts:140

Parameters

options?

HonchoMemoryOptions = {}

Returns

HonchoMemory

Properties

base

readonly base: Memory

Defined in: src/memory/adapters/honcho.ts:133

client

readonly client: HonchoClientLike

Defined in: src/memory/adapters/honcho.ts:134

workspaceId

readonly workspaceId: string | null

Defined in: src/memory/adapters/honcho.ts:135

defaultUserPeer

readonly defaultUserPeer: string

Defined in: src/memory/adapters/honcho.ts:136

defaultAssistantPeer

readonly defaultAssistantPeer: string

Defined in: src/memory/adapters/honcho.ts:137

environment

readonly environment: "production" | "demo"

Defined in: src/memory/adapters/honcho.ts:138

Methods

save()

save(record, scope): Promise<string>

Defined in: src/memory/adapters/honcho.ts:169

Parameters

record

id

string = ...

namespace

string = ...

content

unknown = ...

metadata

Record<string, unknown> = ...

created_at

string = ...

scope

read

string[] = ...

write

string[] = ...

Returns

Promise<string>

Implementation of

Memory.save

load()

load(id, scope): Promise<{ id: string; namespace: string; content: unknown; metadata: Record<string, unknown>; created_at: string; } | null>

Defined in: src/memory/adapters/honcho.ts:173

Parameters

id

string

scope

read

string[] = ...

write

string[] = ...

Returns

Promise<{ id: string; namespace: string; content: unknown; metadata: Record<string, unknown>; created_at: string; } | null>

Implementation of

Memory.load

search()

search(query, scope): Promise<object[]>

Defined in: src/memory/adapters/honcho.ts:177

Parameters

query

text?

string | null = ...

namespace?

string | null = ...

filters

Record<string, unknown> = ...

k

number = ...

scope

read

string[] = ...

write

string[] = ...

Returns

Promise<object[]>

Implementation of

Memory.search

delete()

delete(id, scope): Promise<boolean>

Defined in: src/memory/adapters/honcho.ts:181

Parameters

id

string

scope

read

string[] = ...

write

string[] = ...

Returns

Promise<boolean>

Implementation of

Memory.delete

Interfaces

HonchoClientLike

Defined in: src/memory/adapters/honcho.ts:84

Tagging interface for the subset of @honcho-ai/sdk surface this adapter calls. We deliberately type unknown-shaped stand-ins so the Honcho dependency stays an optional peer dep — consumers who don't use HonchoMemory don't need @honcho-ai/sdk installed.

Real callers pass either a constructed new Honcho({...}) instance or a fake (in tests). The Honcho-aware stores re-narrow these types locally where they call them.

Methods

peer()

peer(peerId): unknown

Defined in: src/memory/adapters/honcho.ts:85

Parameters

peerId

string

Returns

unknown

session()

session(sessionId): unknown

Defined in: src/memory/adapters/honcho.ts:86

Parameters

sessionId

string

Returns

unknown

---

HonchoMemoryOptions

Defined in: src/memory/adapters/honcho.ts:91

Properties

client?

optional client?: HonchoClientLike

Defined in: src/memory/adapters/honcho.ts:98

Pre-built Honcho client. When omitted the constructor builds one from apiKey / environment / process.env.HONCHO_API_KEY. Pass an explicit client when you want to share one across multiple adapters or when running tests with a stand-in.

workspaceId?

optional workspaceId?: string | null

Defined in: src/memory/adapters/honcho.ts:103

Honcho workspace id to scope every operation to. null/omitted falls back to the SDK default ("default").

base?

optional base?: Memory

Defined in: src/memory/adapters/honcho.ts:111

Base Memory adapter for pass-through persistence. Defaults to a fresh in-process InMemoryMemory; pass a SqliteMemory(...) (or any other adapter) for production deployments where checkpoints / background tasks / observation records also need to survive process restarts.

apiKey?

optional apiKey?: string

Defined in: src/memory/adapters/honcho.ts:113

Honcho API key. Used only when client is omitted.

environment?

optional environment?: "production" | "demo"

Defined in: src/memory/adapters/honcho.ts:118

Either "production" (default) or "demo". Demo is allowed for experimentation but emits a one-shot console warning.

defaultUserPeer?

optional defaultUserPeer?: string

Defined in: src/memory/adapters/honcho.ts:123

Peer id used when a chat turn does not supply userPeerId; typically the human user.

defaultAssistantPeer?

optional defaultAssistantPeer?: string

Defined in: src/memory/adapters/honcho.ts:129

Peer id used when a chat turn does not supply assistantPeerId; defaults to a per-app derivation in the Honcho-aware conversation store.