Retrieval
Query and retrieve memories — search, filtering, and namespace resolution.
retrieveMemories
import { retrieveMemories } from '@ahzan-agentforge/core';
const results = await retrieveMemories(store, {
query: 'customer preferences',
namespace: 'customer_123',
limit: 10,
});MemoryQuery
interface MemoryQuery {
query: string; // Search query
namespace?: string; // Filter by namespace
limit?: number; // Max results
minScore?: number; // Minimum similarity score
metadata?: Record<string, unknown>; // Filter by metadata
}MemorySearchResult
interface MemorySearchResult {
entry: MemoryEntry;
score: number; // Similarity score (0-1)
}Agent-Level Recall
const memories = await agent.recall('communication preferences', {
customerId: 'cust_123',
});
for (const { entry, score } of memories) {
console.log(`[${score.toFixed(2)}] ${entry.content}`);
}Namespace Resolution
Use resolveNamespace() to build namespace strings:
import { resolveNamespace } from '@ahzan-agentforge/core';
const ns = resolveNamespace('agent', 'customer_123');
// "agent:customer_123"Next Steps
- Consolidation — merge similar memories
- Cleanup — memory cleanup manager