import type { FileRecord } from "./types.js";
export interface ManageOptions {
    wsPath: string;
}
/**
 * Soft-delete a file by setting deleted_at on the parent row and all child chunks.
 */
export declare function remove(id: string, opts: ManageOptions): Promise<void>;
/**
 * Update tags and/or short-summary-compatible metadata on a file record.
 */
export declare function update(id: string, changes: {
    tags?: string[];
    description?: string | null;
    tldr?: string | null;
    digest?: string | null;
    displayName?: string | null;
    abstract?: string | null;
}, opts: ManageOptions): Promise<void>;
/**
 * Garbage collect: permanently remove soft-deleted rows and their disk files.
 */
export declare function gc(opts: ManageOptions): Promise<{
    deletedRows: number;
    freedBytes: number;
}>;
/**
 * Health check: report issues with the workspace.
 */
export declare function doctor(opts: ManageOptions): Promise<{
    healthy: boolean;
    issues: string[];
}>;
export interface ListFilesInput {
    limit?: number;
    cursor?: string;
    taxonomyPath?: string[];
    contentType?: string;
    tags?: string[];
}
export interface ListFilesResult {
    items: FileRecord[];
    nextCursor?: string;
    total: number;
}
/**
 * List files with cursor-based pagination.
 * Files are ordered by created_at descending.
 * Cursor is the id of the last item; subsequent pages use WHERE created_at < cursor_item.created_at.
 */
export declare function listFiles(input: ListFilesInput, opts: ManageOptions): Promise<ListFilesResult>;
export interface UsageEntry {
    timestamp: number;
    model: string;
    tokensUsed: number;
    operation: string;
}
export interface UsageSummary {
    totalTokens: number;
    estimatedCost: number;
    entries: number;
}
/**
 * Log a usage entry to usage.jsonl.
 */
export declare function logUsage(wsPath: string, entry: UsageEntry): Promise<void>;
/**
 * Read and aggregate usage.jsonl. Returns total tokens and estimated cost.
 */
export declare function getUsage(wsPath: string): Promise<UsageSummary>;
//# sourceMappingURL=manage.d.ts.map