/**
 * LanceDB client wrapper with local file-based storage
 * Provides methods for collection management and vector operations
 */
import { type Connection, type Table } from '@lancedb/lancedb';
import type { Config } from '../../shared/types/index.js';
import { type Logger } from '../../shared/logging/index.js';
/**
 * Error thrown when LanceDB operations fail
 */
export declare class LanceDBError extends Error {
    cause?: unknown | undefined;
    constructor(message: string, cause?: unknown | undefined);
}
/**
 * Collection (table) information with metadata
 */
export interface CollectionInfo {
    name: string;
    metadata?: Record<string, any>;
}
/**
 * LanceDB client wrapper with enhanced functionality
 */
export declare class LanceDBClientWrapper {
    private connection;
    private config;
    private initialized;
    private logger;
    constructor(config: Config, logger?: Logger);
    /**
     * Initialize the LanceDB client and verify connection
     */
    initialize(): Promise<void>;
    /**
     * Ensure client is initialized before operations
     */
    private ensureInitialized;
    /**
     * Generate table name following the pattern: knowledgebase_{name}_{schemaVersion}
     */
    static getTableName(knowledgeBaseName: string): string;
    /**
     * Create a new table for a knowledge base
     */
    createTable(knowledgeBaseName: string, data: any[], metadata?: Record<string, any>): Promise<void>;
    /**
     * Get or create a table for a knowledge base
     * Returns null if table doesn't exist (caller should create it with actual data)
     */
    getOrCreateTable(knowledgeBaseName: string): Promise<Table | null>;
    /**
     * Create a table with initial data
     */
    createTableWithData(knowledgeBaseName: string, data: any[]): Promise<Table>;
    /**
     * Check if a table exists
     */
    tableExists(knowledgeBaseName: string): Promise<boolean>;
    /**
     * Delete a table by knowledge base name
     */
    deleteTable(knowledgeBaseName: string): Promise<void>;
    /**
     * List all tables
     */
    listTables(): Promise<CollectionInfo[]>;
    /**
     * Get the underlying Connection instance
     */
    getConnection(): Connection;
    /**
     * Get current schema version
     */
    static getSchemaVersion(): string;
}
//# sourceMappingURL=lancedb.client.d.ts.map