AgentForge

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