@vinaes/succ 1.3.19

package/dist/lib/storage/types.d.ts

@@ -0,0 +1,313 @@
+/**
+ * Storage abstraction types for multi-backend support.
+ *
+ * Supports:
+ * - SQLite + sqlite-vec (default)
+ * - PostgreSQL + pgvector
+ * - SQLite/PostgreSQL + Qdrant (hybrid)
+ */
+export type SqlBackend = 'sqlite' | 'postgresql';
+export type VectorBackend = 'builtin' | 'qdrant';
+export interface SqliteConfig {
+    /** Override default path for local database */
+    path?: string;
+    /** Override default path for global database */
+    global_path?: string;
+    /** Enable WAL mode (default: true for global, false for local) */
+    wal_mode?: boolean;
+    /** Busy timeout in ms (default: 5000) */
+    busy_timeout?: number;
+}
+export interface PostgresConfig {
+    /** Full connection string (overrides individual params) */
+    connection_string?: string;
+    /** Host (default: localhost) */
+    host?: string;
+    /** Port (default: 5432) */
+    port?: number;
+    /** Database name */
+    database?: string;
+    /** Username */
+    user?: string;
+    /** Password */
+    password?: string;
+    /** Enable SSL. true = SSL with cert validation, { rejectUnauthorized: false } to skip validation */
+    ssl?: boolean | {
+        rejectUnauthorized?: boolean;
+        ca?: string;
+    };
+    /** Connection pool size (default: 10) */
+    pool_size?: number;
+}
+export interface QdrantConfig {
+    /** Qdrant server URL (default: http://localhost:6333) */
+    url?: string;
+    /** API key for authentication */
+    api_key?: string;
+    /** Collection name prefix (default: succ_) */
+    collection_prefix?: string;
+}
+export interface StorageConfig {
+    /** SQL backend: sqlite or postgresql (default: sqlite) */
+    backend?: SqlBackend;
+    /** Vector backend: builtin or qdrant (default: builtin) */
+    vector?: VectorBackend;
+    /** SQLite-specific configuration */
+    sqlite?: SqliteConfig;
+    /** PostgreSQL-specific configuration */
+    postgresql?: PostgresConfig;
+    /** Qdrant-specific configuration (when vector: 'qdrant') */
+    qdrant?: QdrantConfig;
+}
+export interface Document {
+    id: number;
+    file_path: string;
+    chunk_index: number;
+    content: string;
+    start_line: number;
+    end_line: number;
+    embedding: number[];
+    created_at: string;
+    updated_at: string;
+}
+export interface DocumentInput {
+    filePath: string;
+    chunkIndex: number;
+    content: string;
+    startLine: number;
+    endLine: number;
+    embedding: number[];
+    symbolName?: string;
+    symbolType?: string;
+    signature?: string;
+}
+export type DocumentBatch = DocumentInput;
+export interface DocumentBatchWithHash extends DocumentBatch {
+    hash: string;
+}
+export declare const MEMORY_TYPES: readonly ["observation", "decision", "learning", "error", "pattern", "dead_end"];
+export type MemoryType = (typeof MEMORY_TYPES)[number];
+export interface Memory {
+    id: number;
+    content: string;
+    tags: string[];
+    source: string | null;
+    type: MemoryType | null;
+    quality_score: number | null;
+    quality_factors: Record<string, number> | null;
+    access_count: number;
+    last_accessed: string | null;
+    valid_from: string | null;
+    valid_until: string | null;
+    correction_count: number;
+    is_invariant: boolean;
+    priority_score: number | null;
+    created_at: string;
+}
+export interface MemoryInput {
+    content: string;
+    embedding: number[];
+    tags?: string[];
+    source?: string;
+    type?: MemoryType;
+    qualityScore?: QualityScoreData;
+    validFrom?: string | Date;
+    validUntil?: string | Date;
+}
+export interface QualityScoreData {
+    score: number;
+    factors: Record<string, number>;
+}
+export interface SaveMemoryResult {
+    id: number;
+    isDuplicate: boolean;
+    existingId?: number;
+    linksCreated?: number;
+}
+export interface MemorySearchResult extends Memory {
+    similarity: number;
+}
+export interface GlobalMemory {
+    id: number;
+    content: string;
+    tags: string[];
+    source: string | null;
+    project: string | null;
+    type: MemoryType | null;
+    quality_score: number | null;
+    quality_factors: Record<string, number> | null;
+    created_at: string;
+    isGlobal: true;
+}
+export interface GlobalMemorySearchResult extends GlobalMemory {
+    similarity: number;
+}
+export interface SearchResult {
+    file_path: string;
+    content: string;
+    start_line: number;
+    end_line: number;
+    similarity: number;
+    symbol_name?: string;
+    symbol_type?: string;
+}
+export interface HybridSearchResult extends SearchResult {
+    bm25Score?: number;
+    vectorScore?: number;
+}
+export interface HybridMemoryResult {
+    id: number;
+    content: string;
+    tags: string | null;
+    source: string | null;
+    type: string | null;
+    created_at: string;
+    similarity: number;
+    bm25Score?: number;
+    vectorScore?: number;
+    last_accessed?: string | null;
+    access_count?: number;
+    valid_from?: string | null;
+    valid_until?: string | null;
+}
+export interface HybridGlobalMemoryResult {
+    id: number;
+    content: string;
+    tags: string | null;
+    source: string | null;
+    project: string | null;
+    type: string | null;
+    created_at: string;
+    similarity: number;
+    bm25Score?: number;
+    vectorScore?: number;
+}
+export declare const LINK_RELATIONS: readonly ["related", "caused_by", "leads_to", "similar_to", "contradicts", "implements", "supersedes", "references"];
+export type LinkRelation = (typeof LINK_RELATIONS)[number];
+export interface MemoryLink {
+    id: number;
+    source_id: number;
+    target_id: number;
+    relation: LinkRelation;
+    weight: number;
+    valid_from: string | null;
+    valid_until: string | null;
+    created_at: string;
+}
+export interface MemoryLinkInput {
+    sourceId: number;
+    targetId: number;
+    relation?: LinkRelation;
+    weight?: number;
+    validFrom?: string | Date;
+    validUntil?: string | Date;
+}
+export interface MemoryWithLinks extends Memory {
+    outgoing_links: Array<{
+        target_id: number;
+        relation: LinkRelation;
+        weight: number;
+        target_content: string;
+    }>;
+    incoming_links: Array<{
+        source_id: number;
+        relation: LinkRelation;
+        weight: number;
+        source_content: string;
+    }>;
+}
+export interface ConnectedMemory {
+    memory: Memory;
+    depth: number;
+    path: number[];
+}
+export interface GraphStats {
+    total_memories: number;
+    total_links: number;
+    avg_links_per_memory: number;
+    isolated_memories: number;
+    relations: Record<string, number>;
+}
+export type TokenEventType = 'recall' | 'search' | 'search_code' | 'session_summary';
+export interface TokenStatRecord {
+    event_type: TokenEventType;
+    query?: string;
+    returned_tokens: number;
+    full_source_tokens: number;
+    savings_tokens: number;
+    files_count?: number;
+    chunks_count?: number;
+    model?: string;
+    estimated_cost?: number;
+}
+export interface TokenStatsAggregated {
+    event_type: TokenEventType;
+    total_calls: number;
+    total_returned_tokens: number;
+    total_full_source_tokens: number;
+    total_savings_tokens: number;
+    total_estimated_cost: number;
+    avg_returned_tokens: number;
+    avg_savings_tokens: number;
+    avg_savings_percent: number;
+}
+export interface MemoryForRetention {
+    id: number;
+    content: string;
+    quality_score: number | null;
+    access_count: number;
+    created_at: string;
+    last_accessed: string | null;
+}
+export type WebSearchToolName = 'succ_quick_search' | 'succ_web_search' | 'succ_deep_research';
+export interface WebSearchHistoryRecord {
+    id: number;
+    tool_name: WebSearchToolName;
+    model: string;
+    query: string;
+    prompt_tokens: number;
+    completion_tokens: number;
+    estimated_cost_usd: number;
+    citations_count: number;
+    has_reasoning: boolean;
+    response_length_chars: number;
+    created_at: string;
+}
+export interface WebSearchHistoryInput {
+    tool_name: WebSearchToolName;
+    model: string;
+    query: string;
+    prompt_tokens: number;
+    completion_tokens: number;
+    estimated_cost_usd: number;
+    citations_count: number;
+    has_reasoning: boolean;
+    response_length_chars: number;
+}
+export interface WebSearchHistoryFilter {
+    tool_name?: WebSearchToolName;
+    model?: string;
+    query_text?: string;
+    date_from?: string;
+    date_to?: string;
+    limit?: number;
+}
+export interface WebSearchHistorySummary {
+    total_searches: number;
+    total_cost_usd: number;
+    by_tool: Record<string, {
+        count: number;
+        cost: number;
+    }>;
+    today_searches: number;
+    today_cost_usd: number;
+}
+export interface VectorSearchResult {
+    id: number;
+    similarity: number;
+}
+export interface VectorItem {
+    id: number;
+    embedding: number[];
+}
+//# sourceMappingURL=types.d.ts.map

package/dist/lib/storage/types.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"types.d.ts","sourceRoot":"","sources":["../../../src/lib/storage/types.ts"],"names":[],"mappings":"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"}

package/dist/lib/storage/types.js

@@ -0,0 +1,30 @@
+/**
+ * Storage abstraction types for multi-backend support.
+ *
+ * Supports:
+ * - SQLite + sqlite-vec (default)
+ * - PostgreSQL + pgvector
+ * - SQLite/PostgreSQL + Qdrant (hybrid)
+ */
+export const MEMORY_TYPES = [
+    'observation',
+    'decision',
+    'learning',
+    'error',
+    'pattern',
+    'dead_end',
+];
+// ============================================================================
+// Memory Links / Graph Types
+// ============================================================================
+export const LINK_RELATIONS = [
+    'related',
+    'caused_by',
+    'leads_to',
+    'similar_to',
+    'contradicts',
+    'implements',
+    'supersedes',
+    'references',
+];
+//# sourceMappingURL=types.js.map

package/dist/lib/storage/types.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"types.js","sourceRoot":"","sources":["../../../src/lib/storage/types.ts"],"names":[],"mappings":"AAAA;;;;;;;GAOG;AA+FH,MAAM,CAAC,MAAM,YAAY,GAAG;IAC1B,aAAa;IACb,UAAU;IACV,UAAU;IACV,OAAO;IACP,SAAS;IACT,UAAU;CACF,CAAC;AAiHX,+EAA+E;AAC/E,6BAA6B;AAC7B,+EAA+E;AAE/E,MAAM,CAAC,MAAM,cAAc,GAAG;IAC5B,SAAS;IACT,WAAW;IACX,UAAU;IACV,YAAY;IACZ,aAAa;IACb,YAAY;IACZ,YAAY;IACZ,YAAY;CACJ,CAAC"}

package/dist/lib/storage/vector/interface.d.ts

@@ -0,0 +1,89 @@
+/**
+ * VectorStore interface for abstracting vector search backends.
+ *
+ * Implementations:
+ * - sqlite-vec (builtin for SQLite)
+ * - pgvector (builtin for PostgreSQL)
+ * - Qdrant (optional external service)
+ */
+import type { VectorSearchResult, VectorItem } from '../types.js';
+export interface VectorStore {
+    /**
+     * Initialize the vector store with the given embedding dimensions.
+     * Creates collections/tables as needed.
+     */
+    init(dimensions: number): Promise<void>;
+    /**
+     * Close connections and clean up resources.
+     */
+    close(): Promise<void>;
+    /**
+     * Check if the vector store is available and working.
+     */
+    isAvailable(): boolean;
+    /**
+     * Insert or update a document vector.
+     */
+    upsertDocumentVector(id: number, embedding: number[]): Promise<void>;
+    /**
+     * Batch insert/update document vectors.
+     */
+    upsertDocumentVectorsBatch(items: VectorItem[]): Promise<void>;
+    /**
+     * Delete a document vector by ID.
+     */
+    deleteDocumentVector(id: number): Promise<void>;
+    /**
+     * Delete all document vectors for a given file path.
+     * @param docIds - Array of document IDs to delete
+     */
+    deleteDocumentVectorsByIds(docIds: number[]): Promise<void>;
+    /**
+     * Search for similar documents.
+     * @param query - Query embedding vector
+     * @param limit - Max results to return
+     * @param threshold - Minimum similarity threshold (0-1)
+     * @returns Array of {id, similarity} sorted by similarity desc
+     */
+    searchDocuments(query: number[], limit: number, threshold: number): Promise<VectorSearchResult[]>;
+    /**
+     * Insert or update a memory vector.
+     */
+    upsertMemoryVector(id: number, embedding: number[]): Promise<void>;
+    /**
+     * Delete a memory vector by ID.
+     */
+    deleteMemoryVector(id: number): Promise<void>;
+    /**
+     * Search for similar memories.
+     */
+    searchMemories(query: number[], limit: number, threshold: number): Promise<VectorSearchResult[]>;
+    /**
+     * Insert or update a global memory vector.
+     */
+    upsertGlobalMemoryVector(id: number, embedding: number[]): Promise<void>;
+    /**
+     * Delete a global memory vector by ID.
+     */
+    deleteGlobalMemoryVector(id: number): Promise<void>;
+    /**
+     * Search for similar global memories.
+     */
+    searchGlobalMemories(query: number[], limit: number, threshold: number): Promise<VectorSearchResult[]>;
+    /**
+     * Rebuild vector index for documents from raw embeddings.
+     * @param items - Array of {id, embedding} pairs
+     */
+    rebuildDocumentVectors(items: VectorItem[]): Promise<void>;
+    /**
+     * Rebuild vector index for memories from raw embeddings.
+     * @param items - Array of {id, embedding} pairs
+     */
+    rebuildMemoryVectors(items: VectorItem[]): Promise<void>;
+    /**
+     * Rebuild vector index for global memories from raw embeddings.
+     * @param items - Array of {id, embedding} pairs
+     */
+    rebuildGlobalMemoryVectors(items: VectorItem[]): Promise<void>;
+}
+//# sourceMappingURL=interface.d.ts.map

package/dist/lib/storage/vector/interface.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"interface.d.ts","sourceRoot":"","sources":["../../../../src/lib/storage/vector/interface.ts"],"names":[],"mappings":"AAAA;;;;;;;GAOG;AAEH,OAAO,KAAK,EAAE,kBAAkB,EAAE,UAAU,EAAE,MAAM,aAAa,CAAC;AAElE,MAAM,WAAW,WAAW;IAC1B;;;OAGG;IACH,IAAI,CAAC,UAAU,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC,CAAC;IAExC;;OAEG;IACH,KAAK,IAAI,OAAO,CAAC,IAAI,CAAC,CAAC;IAEvB;;OAEG;IACH,WAAW,IAAI,OAAO,CAAC;IAMvB;;OAEG;IACH,oBAAoB,CAAC,EAAE,EAAE,MAAM,EAAE,SAAS,EAAE,MAAM,EAAE,GAAG,OAAO,CAAC,IAAI,CAAC,CAAC;IAErE;;OAEG;IACH,0BAA0B,CAAC,KAAK,EAAE,UAAU,EAAE,GAAG,OAAO,CAAC,IAAI,CAAC,CAAC;IAE/D;;OAEG;IACH,oBAAoB,CAAC,EAAE,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC,CAAC;IAEhD;;;OAGG;IACH,0BAA0B,CAAC,MAAM,EAAE,MAAM,EAAE,GAAG,OAAO,CAAC,IAAI,CAAC,CAAC;IAE5D;;;;;;OAMG;IACH,eAAe,CAAC,KAAK,EAAE,MAAM,EAAE,EAAE,KAAK,EAAE,MAAM,EAAE,SAAS,EAAE,MAAM,GAAG,OAAO,CAAC,kBAAkB,EAAE,CAAC,CAAC;IAMlG;;OAEG;IACH,kBAAkB,CAAC,EAAE,EAAE,MAAM,EAAE,SAAS,EAAE,MAAM,EAAE,GAAG,OAAO,CAAC,IAAI,CAAC,CAAC;IAEnE;;OAEG;IACH,kBAAkB,CAAC,EAAE,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC,CAAC;IAE9C;;OAEG;IACH,cAAc,CAAC,KAAK,EAAE,MAAM,EAAE,EAAE,KAAK,EAAE,MAAM,EAAE,SAAS,EAAE,MAAM,GAAG,OAAO,CAAC,kBAAkB,EAAE,CAAC,CAAC;IAMjG;;OAEG;IACH,wBAAwB,CAAC,EAAE,EAAE,MAAM,EAAE,SAAS,EAAE,MAAM,EAAE,GAAG,OAAO,CAAC,IAAI,CAAC,CAAC;IAEzE;;OAEG;IACH,wBAAwB,CAAC,EAAE,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC,CAAC;IAEpD;;OAEG;IACH,oBAAoB,CAClB,KAAK,EAAE,MAAM,EAAE,EACf,KAAK,EAAE,MAAM,EACb,SAAS,EAAE,MAAM,GAChB,OAAO,CAAC,kBAAkB,EAAE,CAAC,CAAC;IAMjC;;;OAGG;IACH,sBAAsB,CAAC,KAAK,EAAE,UAAU,EAAE,GAAG,OAAO,CAAC,IAAI,CAAC,CAAC;IAE3D;;;OAGG;IACH,oBAAoB,CAAC,KAAK,EAAE,UAAU,EAAE,GAAG,OAAO,CAAC,IAAI,CAAC,CAAC;IAEzD;;;OAGG;IACH,0BAA0B,CAAC,KAAK,EAAE,UAAU,EAAE,GAAG,OAAO,CAAC,IAAI,CAAC,CAAC;CAChE"}

package/dist/lib/storage/vector/interface.js

@@ -0,0 +1,10 @@
+/**
+ * VectorStore interface for abstracting vector search backends.
+ *
+ * Implementations:
+ * - sqlite-vec (builtin for SQLite)
+ * - pgvector (builtin for PostgreSQL)
+ * - Qdrant (optional external service)
+ */
+export {};
+//# sourceMappingURL=interface.js.map

package/dist/lib/storage/vector/interface.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"interface.js","sourceRoot":"","sources":["../../../../src/lib/storage/vector/interface.ts"],"names":[],"mappings":"AAAA;;;;;;;GAOG"}

package/dist/lib/storage/vector/qdrant.d.ts

@@ -0,0 +1,221 @@
+/**
+ * Qdrant vector store implementation — Approach C: Full Hybrid Search.
+ *
+ * When Qdrant is configured (storage.vector = "qdrant"), it becomes the
+ * single search engine for ALL backends (SQLite + Qdrant, PgSQL + Qdrant).
+ *
+ * Uses Qdrant's built-in server-side BM25 (Qdrant/bm25 model) + dense vectors
+ * + RRF (Reciprocal Rank Fusion) — all in a single API call.
+ *
+ * Collections (named vectors):
+ * - {prefix}documents — dense (384d) + bm25 sparse
+ * - {prefix}memories — dense (384d) + bm25 sparse
+ * - {prefix}global_memories — dense (384d) + bm25 sparse
+ *
+ * Payloads store full metadata so search results can be returned
+ * without a second round-trip to PG/SQLite.
+ */
+import type { VectorStore } from './interface.js';
+import type { VectorSearchResult, VectorItem, StorageConfig, Memory } from '../types.js';
+export interface QdrantConfig {
+    url?: string;
+    apiKey?: string;
+    collectionPrefix?: string;
+    /** HNSW ef parameter for search (higher = more accurate but slower). Default: 128 */
+    searchEf?: number;
+    /** Enable scalar quantization for faster search. Default: true */
+    useQuantization?: boolean;
+    /** Project ID for scoping memories. NULL = global. */
+    projectId?: string;
+}
+export interface DocumentPayload {
+    doc_type: 'code' | 'doc';
+    file_path: string;
+    content: string;
+    start_line: number;
+    end_line: number;
+    project_id: string;
+    symbol_name: string | null;
+    symbol_type: string | null;
+    signature: string | null;
+}
+export interface MemoryPayload {
+    content: string;
+    tags: string[];
+    source: string | null;
+    type: string | null;
+    project_id: string | null;
+    created_at: string;
+    valid_from: string | null;
+    valid_until: string | null;
+    invalidated_by: number | null;
+    access_count: number;
+    last_accessed: string | null;
+    quality_score: number | null;
+}
+export interface DocumentUpsertMeta {
+    filePath: string;
+    content: string;
+    startLine: number;
+    endLine: number;
+    projectId: string;
+    symbolName?: string | null;
+    symbolType?: string | null;
+    signature?: string | null;
+}
+export interface MemoryUpsertMeta {
+    content: string;
+    tags: string[];
+    source?: string | null;
+    type?: string | null;
+    projectId?: string | null;
+    createdAt: string;
+    validFrom?: string | null;
+    validUntil?: string | null;
+    invalidatedBy?: number | null;
+    accessCount?: number;
+    lastAccessed?: string | null;
+    qualityScore?: number | null;
+}
+export interface QdrantDocumentResult {
+    id: number;
+    file_path: string;
+    content: string;
+    start_line: number;
+    end_line: number;
+    similarity: number;
+    bm25Score: number;
+    vectorScore: number;
+    symbol_name?: string | null;
+    symbol_type?: string | null;
+    signature?: string | null;
+}
+export interface QdrantMemoryResult extends Memory {
+    similarity: number;
+}
+export declare class QdrantVectorStore implements VectorStore {
+    private client;
+    private config;
+    private dimensions;
+    private prefix;
+    private searchEf;
+    private useQuantization;
+    private projectId;
+    private initialized;
+    constructor(config: QdrantConfig);
+    setProjectId(projectId: string | null): void;
+    getProjectId(): string | null;
+    private getClient;
+    private collectionName;
+    private initKey;
+    init(dimensions: number): Promise<void>;
+    private ensureCollection;
+    private createMultiVectorCollection;
+    private createPayloadIndexes;
+    close(): Promise<void>;
+    isAvailable(): boolean;
+    upsertDocumentVector(id: number, embedding: number[]): Promise<void>;
+    upsertDocumentVectorsBatch(items: VectorItem[]): Promise<void>;
+    deleteDocumentVector(id: number): Promise<void>;
+    deleteDocumentVectorsByIds(docIds: number[]): Promise<void>;
+    searchDocuments(query: number[], limit: number, threshold: number): Promise<VectorSearchResult[]>;
+    upsertMemoryVector(id: number, embedding: number[], projectId?: string): Promise<void>;
+    deleteMemoryVector(id: number): Promise<void>;
+    searchMemories(query: number[], limit: number, threshold: number, options?: {
+        projectId?: string | null;
+        includeGlobal?: boolean;
+    }): Promise<VectorSearchResult[]>;
+    upsertGlobalMemoryVector(id: number, embedding: number[]): Promise<void>;
+    deleteGlobalMemoryVector(id: number): Promise<void>;
+    searchGlobalMemories(query: number[], limit: number, threshold: number): Promise<VectorSearchResult[]>;
+    rebuildDocumentVectors(items: VectorItem[]): Promise<void>;
+    rebuildMemoryVectors(items: VectorItem[]): Promise<void>;
+    rebuildGlobalMemoryVectors(items: VectorItem[]): Promise<void>;
+    /**
+     * Upsert a document with full payload + BM25 text for hybrid search.
+     * Called from dispatcher when Qdrant is configured.
+     */
+    upsertDocumentWithPayload(id: number, embedding: number[], meta: DocumentUpsertMeta): Promise<void>;
+    /**
+     * Batch upsert documents with full payload + BM25 text.
+     */
+    upsertDocumentsBatchWithPayload(items: Array<{
+        id: number;
+        embedding: number[];
+        meta: DocumentUpsertMeta;
+    }>): Promise<void>;
+    /**
+     * Upsert a memory with full payload + BM25 text for hybrid search.
+     */
+    upsertMemoryWithPayload(id: number, embedding: number[], meta: MemoryUpsertMeta): Promise<void>;
+    /**
+     * Upsert a global memory with full payload + BM25 text.
+     */
+    upsertGlobalMemoryWithPayload(id: number, embedding: number[], meta: MemoryUpsertMeta): Promise<void>;
+    /**
+     * Batch upsert memories with full payload + BM25 text.
+     */
+    upsertMemoriesBatchWithPayload(items: Array<{
+        id: number;
+        embedding: number[];
+        meta: MemoryUpsertMeta;
+    }>): Promise<void>;
+    /**
+     * Batch upsert global memories with full payload + BM25 text.
+     */
+    upsertGlobalMemoriesBatchWithPayload(items: Array<{
+        id: number;
+        embedding: number[];
+        meta: MemoryUpsertMeta;
+    }>): Promise<void>;
+    /**
+     * Hybrid search for documents using BM25 + dense vectors + RRF fusion.
+     * Returns full document data from Qdrant payload (no PG round-trip needed).
+     */
+    hybridSearchDocuments(query: string, queryEmbedding: number[], limit: number, threshold: number, options?: {
+        codeOnly?: boolean;
+        docsOnly?: boolean;
+        projectId?: string;
+        symbolType?: string;
+    }): Promise<QdrantDocumentResult[]>;
+    /**
+     * Hybrid search for memories using BM25 + dense vectors + RRF fusion.
+     * Returns full memory data from Qdrant payload.
+     */
+    hybridSearchMemories(query: string, queryEmbedding: number[], limit: number, threshold: number, options?: {
+        projectId?: string | null;
+        includeGlobal?: boolean;
+        tags?: string[];
+        since?: Date;
+        asOfDate?: Date;
+        includeExpired?: boolean;
+        createdBefore?: Date;
+    }): Promise<QdrantMemoryResult[]>;
+    /**
+     * Hybrid search for global memories using BM25 + dense + RRF.
+     */
+    hybridSearchGlobalMemories(query: string, queryEmbedding: number[], limit: number, threshold: number, options?: {
+        tags?: string[];
+        since?: Date;
+        includeExpired?: boolean;
+    }): Promise<QdrantMemoryResult[]>;
+    /**
+     * Dense-only similarity search (for dedup checks — no BM25 needed).
+     */
+    findSimilarVector(collection: 'memories' | 'global_memories', embedding: number[], limit: number, threshold: number, filter?: any): Promise<VectorSearchResult[]>;
+    /**
+     * Dense-only search with payload (for dedup — returns content).
+     */
+    findSimilarWithContent(collection: 'memories' | 'global_memories', embedding: number[], limit: number, threshold: number): Promise<Array<{
+        id: number;
+        content: string;
+        similarity: number;
+    }>>;
+    /** Convert a Qdrant point with memory payload to a Memory + similarity. */
+    private payloadToMemory;
+}
+/**
+ * Create Qdrant vector store from storage config.
+ */
+export declare function createQdrantVectorStore(config: StorageConfig): QdrantVectorStore;
+//# sourceMappingURL=qdrant.d.ts.map