Module memory 

Persistent memory tools and conversation storage.

This module stores conversations, resources, artifacts, and memory-management commands for agents. Conversation metadata is stored in AndaDB collections with BTree and BM25 indexes, while higher-level memory operations are exposed through KIP (Knowledge Interaction Protocol) tools backed by the Cognitive Nexus.

The KIP, resource, and conversation tools report the same capability group via memory_tool_group_info, so the discovery layer presents them to the model as one persistent-memory bundle.

Structs

Conversation

Conversation record stored in the memory database.

ConversationDelta

A delta of a conversation since a given offset, used for incremental fetching of conversation messages.

ConversationRef

Borrowed view of a conversation for insertion into AndaDB.

ConversationState

Lightweight conversation state returned by management APIs.

Conversations

Storage wrapper for the conversations collection.

GetResourceContentArgs

Arguments for “get_resource_content” tool

GetResourceContentTool

Tool that retrieves the full content for a stored resource.

KipArgs

The model-facing arguments of execute_kip and execute_kip_readonly.

ListConversationsArgs

Arguments for “list_previous_conversations” tool

ListConversationsTool

Tool that lists previous conversations for the current caller.

MemoryManagement

High-level memory manager for conversations, resources, and the Cognitive Nexus.

MemoryReadonly

A read-only version of the KIP tool for memory management, which does not allow any modifications to the memory and is safe to use for retrieval operations.

MemoryTool

A tool for conversation API

PrunedMessage

Message view used when embedding conversations for search and recall.

SearchConversationsArgs

Arguments for “search_conversations” tool

SearchConversationsTool

Tool that searches previous conversations for the current caller.

Enums

ConversationStatus

Conversation lifecycle state.

KipOperation

One entry of KipArgs::operations.

MemoryToolArgs

Arguments for “memory_api” tool

Tenancy

How the KIP tools bind a call to an identity and a MemorySpace.

Constants

MEMORY_TOOL_GROUP_ID

Stable id of the persistent memory capability group.

Statics

FUNCTION_DEFINITION

Default KIP tool function definition used by MemoryManagement.

READONLY_FUNCTION_DEFINITION

Default read-only KIP tool function definition used by MemoryReadonly.

Functions

memory_tool_group_info

Returns the shared ToolGroupInfo for the persistent memory tools.