Memory Tool

interface MemoryTool extends Tool {
  name: "memory";

  actions: {
    // Basic storage
    store(key: string, value: unknown, metadata?: MemoryMetadata): Promise<void>;
    retrieve(key: string): Promise<unknown | null>;
    delete(key: string): Promise<void>;
    list(prefix?: string): Promise<string[]>;

    // Semantic search
    search(query: string, options?: SearchOptions): Promise<MemoryResult[]>;

    // Context management
    getContext(conversationId: string): Promise<ConversationContext>;
    updateContext(conversationId: string, context: Partial<ConversationContext>): Promise<void>;

    // Preferences
    getPreference(key: string): Promise<unknown>;
    setPreference(key: string, value: unknown): Promise<void>;

    // Learning
    recordInteraction(interaction: Interaction): Promise<void>;
    getInsights(topic?: string): Promise<Insight[]>;
  };
}

interface MemoryMetadata {
  category?: string;
  tags?: string[];
  expiresAt?: Date;
  importance?: number;
}

interface MemoryResult {
  key: string;
  value: unknown;
  score: number;  // Relevance score
  metadata: MemoryMetadata;
}

~/.bot0/memory/
├── kv/                  # Key-value store
│   ├── preferences.json
│   └── context/
├── conversations/       # Conversation history
│   └── {id}.json
├── embeddings/          # Vector store for semantic search
│   └── index.bin
└── insights/            # Learned patterns
    └── insights.json

// Store a fact
await memory.store("user.timezone", "America/New_York", {
  category: "preference",
  importance: 0.8
});

// Semantic search
const results = await memory.search("what does the user prefer for meetings?");

// Get conversation context
const context = await memory.getContext("conv_123");