import type { Database } from "./database.js";
export interface HandleRecord {
    id: string;
    tool: string;
    sha: string | null;
    created_at: number;
    expires_at: number;
    body: string;
    preview: string;
}
export declare class HandleStore {
    private db;
    private upsertStmt;
    private getStmt;
    private deleteExpiredStmt;
    private countStmt;
    constructor(db: Database);
    create(tool: string, body: string, sha?: string | null, ttlMs?: number): HandleRecord;
    get(id: string): HandleRecord | null;
    /**
     * Lookup + freshness check. Returns null if the handle is missing,
     * expired, or its pinned SHA no longer matches the current SHA.
     */
    getFresh(id: string, currentSha: string | null): HandleRecord | null;
    purgeExpired(now?: number): number;
    count(): number;
}
export declare function buildHandleUri(toolName: string, handleId: string): string;
export declare function parseHandleUri(uri: string): {
    tool: string;
    id: string;
} | null;