import type { UserPrefs, Convention, ProjectContext, SessionEntry, SessionMemory, MemoryCandidate, MemoryEntryInput, MemoryEntryRecord, MemoryFilter, MemorySearchOptions, MemorySearchResult, GetMemoryOptions, GetMemoryResult, MemorySnapshotItem } from "../types/memory.js";
import type { KnowledgeEntry } from "../types/plugin.js";
import type { MemoryWriteProvenance } from "../retrieval-scope.js";
export interface IMemoryEngine {
    getUserPreferences(): Promise<UserPrefs>;
    updateUserPreference(key: string, value: unknown): Promise<void>;
    getProjectContext(): Promise<ProjectContext>;
    setProjectContext(ctx: Partial<ProjectContext>): Promise<void>;
    getTeamConventions(): Promise<Convention[]>;
    createSession(task: string): Promise<string>;
    appendToSession(sessionId: string, entry: SessionEntry): Promise<void>;
    getSession(sessionId: string): Promise<SessionMemory>;
    closeSession(sessionId: string): Promise<void>;
    searchGlobal(query: string): Promise<KnowledgeEntry[]>;
    upsertGlobal(entries: KnowledgeEntry[]): Promise<void>;
    getAll(options?: string | GetMemoryOptions): Promise<GetMemoryResult & {
        session?: SessionMemory;
        relevant?: KnowledgeEntry[];
    }>;
    saveExplicitMemoryIntent(content: string, provenance: MemoryWriteProvenance, sourceEventId?: string): Promise<MemorySnapshotItem>;
    getCandidates(): Promise<MemoryCandidate[]>;
    approveCandidate(id: string, provenance: MemoryWriteProvenance): Promise<void>;
    rejectCandidate(id: string, provenance: MemoryWriteProvenance): Promise<void>;
    search(query: string, options?: MemorySearchOptions): Promise<MemorySearchResult[]>;
    listMemories(filter?: MemoryFilter): Promise<MemoryEntryRecord[]>;
    addMemory(entry: MemoryEntryInput, provenance: MemoryWriteProvenance): Promise<MemoryEntryRecord>;
    updateMemory(id: string, updates: Partial<Pick<MemoryEntryRecord, 'content' | 'status'>>, provenance: MemoryWriteProvenance): Promise<void>;
    deleteMemory(id: string, provenance: MemoryWriteProvenance): Promise<void>;
    getPendingMemories(): Promise<MemoryEntryRecord[]>;
    approveMemory(id: string, provenance: MemoryWriteProvenance): Promise<void>;
    rejectMemory(id: string, provenance: MemoryWriteProvenance): Promise<void>;
}
//# sourceMappingURL=IMemoryEngine.d.ts.map