/**
 * Agent Memory
 *
 * Agent memory is just FeltDB state. Memory is stored as collections
 * under flow://agent/{name}/memory/*
 */
/**
 * Agent memory configuration
 */
export interface AgentMemoryConfig {
    /** Agent name */
    agentName: string;
    /** Maximum memory size in KB */
    maxSizeKb?: number;
    /** Memory retention period in milliseconds */
    retentionMs?: number;
    /** Memory scope */
    scope: 'local' | 'distributed' | 'shared';
    /** Whether to enable memory persistence */
    persistent: boolean;
}
/**
 * Memory entry stored in an agent's memory collection
 */
export interface AgentMemoryEntry {
    /** Unique entry ID */
    entryId: string;
    /** Entry key for lookup */
    key: string;
    /** Entry value */
    value: any;
    /** Entry type */
    type: 'fact' | 'observation' | 'decision' | 'outcome' | 'goal' | 'plan';
    /** When this entry was created */
    createdAt: number;
    /** When this entry expires (optional) */
    expiresAt?: number;
    /** Whether this entry is still valid */
    valid: boolean;
    /** Metadata about the entry */
    metadata?: Record<string, any>;
}
/**
 * Agent memory query result
 */
export interface AgentMemoryResult {
    /** Retrieved memory entries */
    entries: AgentMemoryEntry[];
    /** Total count of matching entries */
    total: number;
    /** Query execution time in milliseconds */
    durationMs: number;
}
/**
 * Memory collection reference for an agent
 */
export declare function getAgentMemoryPath(agentName: string, memoryType?: string): string;
/**
 * Generate a unique memory entry ID
 */
export declare function generateMemoryEntryId(): string;
/**
 * Agent memory store interface
 */
export interface AgentMemoryStore {
    /**
     * Store a memory entry
     */
    store(agentName: string, entry: AgentMemoryEntry): Promise<void>;
    /**
     * Retrieve a memory entry by key
     */
    retrieve(agentName: string, key: string): Promise<AgentMemoryEntry | null>;
    /**
     * Retrieve all memory entries of a type
     */
    retrieveByType(agentName: string, type: AgentMemoryEntry['type']): Promise<AgentMemoryEntry[]>;
    /**
     * Query memory entries
     */
    query(agentName: string, filter: Record<string, any>): Promise<AgentMemoryResult>;
    /**
     * Delete a memory entry
     */
    delete(agentName: string, key: string): Promise<void>;
    /**
     * Clear all memory for an agent
     */
    clear(agentName: string): Promise<void>;
}
//# sourceMappingURL=agent-memory.d.ts.map