import type { SemanticMemoryDocument, SemanticMemoryEntry, SemanticMemoryScope } from "./types.js";
interface SemanticMemoryDocumentSelector {
    authId: string;
    document: SemanticMemoryDocument;
    scope: SemanticMemoryScope;
}
interface SemanticMemorySearchMatch {
    content: string;
    createdAt?: string;
    document: SemanticMemoryDocument;
    lineNumber?: number;
    role?: SemanticMemoryEntry["role"];
    scope: SemanticMemoryScope;
}
interface CompactSemanticMemoryConversationsOptions {
    authId: string;
    maxEntries?: number;
    retainEntries?: number;
    summarizeOverflow: (entries: SemanticMemoryEntry[]) => Promise<string>;
}
export declare function getSemanticMemoryRootPath(homeDir: string): string;
export declare function getSemanticMemoryDocumentPath(homeDir: string, options: SemanticMemoryDocumentSelector): string;
export declare function ensureSemanticMemoryStore(homeDir: string, authId: string): Promise<void>;
export declare function readSemanticMemoryDocument(homeDir: string, options: SemanticMemoryDocumentSelector): Promise<string>;
export declare function updateSemanticMemoryDocument(homeDir: string, options: SemanticMemoryDocumentSelector & {
    content: string;
    mode?: "append" | "overwrite";
}): Promise<string>;
export declare function appendSemanticMemoryConversation(homeDir: string, authId: string, entry: SemanticMemoryEntry, compactionOptions?: Omit<CompactSemanticMemoryConversationsOptions, "authId">): Promise<void>;
export declare function compactSemanticMemoryConversations(homeDir: string, options: CompactSemanticMemoryConversationsOptions): Promise<{
    compacted: boolean;
    retainedEntries: number;
    summarizedEntries: number;
}>;
export declare function searchSemanticMemory(homeDir: string, options: {
    authId: string;
    document: SemanticMemoryDocument;
    query: string;
    scope?: SemanticMemoryScope;
}): Promise<SemanticMemorySearchMatch[]>;
export declare function readSemanticCoreMemory(homeDir: string, authId: string): Promise<{
    globalCore: string;
    userCore: string;
}>;
export {};
//# sourceMappingURL=semantic-memory.d.ts.map