kirograph 0.28.0 → 0.28.1

package/dist/vectors/qdrant-index.d.ts

@@ -1,77 +0,0 @@
-/**
- * KiroGraph Qdrant Index
- *
- * ANN vector search backed by Qdrant running in embedded mode.
- * The engine spawns the Qdrant binary as a managed child process, persisting
- * data to .kirograph/qdrant/ via QDRANT__STORAGE__STORAGE_PATH.
- *
- * Opt-in: set config.semanticEngine = 'qdrant'
- * Required optional dependency (not installed by default):
- *   npm install qdrant-local
- *
- * Uses @qdrant/qdrant-js (QdrantClient) for the REST API — available as a
- * transitive dependency of qdrant-local.
- *
- * Key characteristics:
- *   - Full Qdrant feature set: filtering, payload indexing, HNSW ANN search
- *   - Data persisted to disk across restarts
- *   - Async startup check via /readyz (no blocking sleep)
- *   - Cosine distance metric
- *   - Node IDs stored in payload; deterministic UUIDs used as Qdrant point IDs
- */
-import type { Node } from '../types';
-export declare const DASHBOARD_SUBDIR = "qdrant/dashboard";
-export declare class QdrantIndex {
-    private readonly kirographDir;
-    private readonly dim;
-    private client;
-    private child;
-    private _available;
-    private _ownedProcess;
-    private storagePath;
-    private stateFile;
-    constructor(kirographDir: string, dim?: number);
-    isAvailable(): boolean;
-    private readState;
-    private writeState;
-    private clearState;
-    private isProcessAlive;
-    /** The HTTP port of the running server, or null if not available. */
-    getPort(): number | null;
-    /**
-     * Locate the Qdrant binary (via qdrant-local), spawn it with a project-scoped
-     * storage path, wait until /readyz responds, then ensure the collection exists.
-     * Silent no-op when qdrant-local is not installed.
-     */
-    initialize(): Promise<void>;
-    private ensureCollection;
-    /**
-     * Upsert a node's embedding with retry logic.
-     * Qdrant's upsert is idempotent — the same point ID is overwritten if it already exists.
-     * Retries up to 3 times with exponential backoff to handle transient connection failures.
-     */
-    upsert(node: Node, embedding: Float32Array): Promise<void>;
-    /**
-     * Batch upsert multiple nodes' embeddings in a single HTTP request.
-     * Much more efficient than individual upserts for bulk indexing.
-     * Retries up to 3 times with exponential backoff.
-     */
-    bulkUpsert(nodes: Node[], embeddings: Float32Array[]): Promise<void>;
-    /**
-     * Remove a point from the collection with retry logic.
-     */
-    delete(nodeId: string): Promise<void>;
-    /**
-     * ANN vector search. Returns node IDs ordered by cosine similarity (descending).
-     */
-    search(queryVec: Float32Array, topN?: number): Promise<string[]>;
-    /**
-     * Return all node IDs currently stored in the collection (paginated scroll).
-     */
-    getEmbeddedNodeIds(): Promise<string[]>;
-    /** Disconnect the client. The Qdrant server keeps running as a daemon. */
-    close(): void;
-    /** Number of points currently in the collection. */
-    count(): Promise<number>;
-}
-//# sourceMappingURL=qdrant-index.d.ts.map

package/dist/vectors/qdrant-index.d.ts.map

@@ -1 +0,0 @@
-{"version":3,"file":"qdrant-index.d.ts","sourceRoot":"","sources":["../../src/vectors/qdrant-index.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;GAoBG;AAOH,OAAO,KAAK,EAAE,IAAI,EAAE,MAAM,UAAU,CAAC;AAUrC,eAAO,MAAM,gBAAgB,qBAAqB,CAAC;AAgDnD,qBAAa,WAAW;IASpB,OAAO,CAAC,QAAQ,CAAC,YAAY;IAC7B,OAAO,CAAC,QAAQ,CAAC,GAAG;IATtB,OAAO,CAAC,MAAM,CAAmB;IACjC,OAAO,CAAC,KAAK,CAAoB;IACjC,OAAO,CAAC,UAAU,CAAgB;IAClC,OAAO,CAAC,aAAa,CAAa;IAClC,OAAO,CAAC,WAAW,CAAc;IACjC,OAAO,CAAC,SAAS,CAAgB;gBAGd,YAAY,EAAE,MAAM,EACpB,GAAG,SAAc;IAMpC,WAAW,IAAI,OAAO;IAEtB,OAAO,CAAC,SAAS;IAIjB,OAAO,CAAC,UAAU;IAGlB,OAAO,CAAC,UAAU;IAGlB,OAAO,CAAC,cAAc;IAItB,qEAAqE;IACrE,OAAO,IAAI,MAAM,GAAG,IAAI;IAUxB;;;;OAIG;IACG,UAAU,IAAI,OAAO,CAAC,IAAI,CAAC;YAiGnB,gBAAgB;IAU9B;;;;OAIG;IACG,MAAM,CAAC,IAAI,EAAE,IAAI,EAAE,SAAS,EAAE,YAAY,GAAG,OAAO,CAAC,IAAI,CAAC;IA6BhE;;;;OAIG;IACG,UAAU,CAAC,KAAK,EAAE,IAAI,EAAE,EAAE,UAAU,EAAE,YAAY,EAAE,GAAG,OAAO,CAAC,IAAI,CAAC;IA8B1E;;OAEG;IACG,MAAM,CAAC,MAAM,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC;IAiB3C;;OAEG;IACG,MAAM,CAAC,QAAQ,EAAE,YAAY,EAAE,IAAI,SAAK,GAAG,OAAO,CAAC,MAAM,EAAE,CAAC;IAgBlE;;OAEG;IACG,kBAAkB,IAAI,OAAO,CAAC,MAAM,EAAE,CAAC;IA2B7C,0EAA0E;IAC1E,KAAK,IAAI,IAAI;IAMb,oDAAoD;IAC9C,KAAK,IAAI,OAAO,CAAC,MAAM,CAAC;CAS/B"}

package/dist/vectors/typesense-index.d.ts

@@ -1,75 +0,0 @@
-/**
- * KiroGraph Typesense Index
- *
- * ANN vector search backed by Typesense running in embedded mode.
- * The engine downloads the Typesense binary on first use (cached at
- * ~/.kirograph/bin/), then spawns it as a managed child process persisting
- * data to .kirograph/typesense/.
- *
- * Opt-in: set config.semanticEngine = 'typesense'
- * Required optional dependency (not installed by default):
- *   npm install typesense
- *
- * Key characteristics:
- *   - HNSW ANN vector search with cosine distance
- *   - Binary auto-downloaded on first use (~37MB, cached globally)
- *   - No separate server setup required
- *   - Async startup check via /health
- *   - Node IDs used directly as Typesense document IDs (colon sanitised)
- */
-import type { Node } from '../types';
-export declare class TypesenseIndex {
-    private readonly kirographDir;
-    private readonly dim;
-    private client;
-    private child;
-    private _available;
-    private _ownedProcess;
-    private _failReason;
-    private storagePath;
-    private stateFile;
-    constructor(kirographDir: string, dim?: number);
-    private readState;
-    private writeState;
-    private clearState;
-    private isProcessAlive;
-    isAvailable(): boolean;
-    getFailReason(): string | null;
-    /**
-     * Download the Typesense binary if needed, spawn it with a project-scoped
-     * data directory, wait until /health responds, then ensure the collection
-     * exists. Silent no-op when `typesense` npm package is not installed.
-     */
-    initialize(): Promise<void>;
-    private ensureCollection;
-    /**
-     * Insert or update a node's embedding. Typesense's upsert overwrites the
-     * document if the `id` already exists.
-     */
-    upsert(node: Node, embedding: Float32Array): Promise<void>;
-    /**
-     * Bulk upsert a batch of nodes. Uses Typesense's import endpoint (single
-     * HTTP request per batch) to avoid connection churn on large codebases.
-     */
-    bulkUpsert(nodes: Node[], embeddings: Float32Array[]): Promise<void>;
-    /**
-     * Remove a document from the collection.
-     */
-    delete(nodeId: string): Promise<void>;
-    /**
-     * ANN vector search. Returns node IDs ordered by cosine similarity (descending).
-     */
-    search(queryVec: Float32Array, topN?: number): Promise<string[]>;
-    /**
-     * Return all node IDs currently stored in the collection via paginated export.
-     */
-    getEmbeddedNodeIds(): Promise<string[]>;
-    /** Number of documents currently in the collection. */
-    count(): Promise<number>;
-    /**
-     * Disconnect the client. The Typesense server keeps running as a background
-     * daemon so the next command can reconnect instantly via the state file.
-     */
-    close(): void;
-}
-//# sourceMappingURL=typesense-index.d.ts.map

package/dist/vectors/typesense-index.d.ts.map

@@ -1 +0,0 @@
-{"version":3,"file":"typesense-index.d.ts","sourceRoot":"","sources":["../../src/vectors/typesense-index.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;GAkBG;AASH,OAAO,KAAK,EAAE,IAAI,EAAE,MAAM,UAAU,CAAC;AA4HrC,qBAAa,cAAc;IAUvB,OAAO,CAAC,QAAQ,CAAC,YAAY;IAC7B,OAAO,CAAC,QAAQ,CAAC,GAAG;IAVtB,OAAO,CAAC,MAAM,CAAqB;IACnC,OAAO,CAAC,KAAK,CAAsB;IACnC,OAAO,CAAC,UAAU,CAAkB;IACpC,OAAO,CAAC,aAAa,CAAe;IACpC,OAAO,CAAC,WAAW,CAAuB;IAC1C,OAAO,CAAC,WAAW,CAAS;IAC5B,OAAO,CAAC,SAAS,CAAW;gBAGT,YAAY,EAAE,MAAM,EACpB,GAAG,SAAc;IAMpC,OAAO,CAAC,SAAS;IAMjB,OAAO,CAAC,UAAU;IAIlB,OAAO,CAAC,UAAU;IAIlB,OAAO,CAAC,cAAc;IAItB,WAAW,IAAI,OAAO;IAItB,aAAa,IAAI,MAAM,GAAG,IAAI;IAI9B;;;;OAIG;IACG,UAAU,IAAI,OAAO,CAAC,IAAI,CAAC;YAkInB,gBAAgB;IAiB9B;;;OAGG;IACG,MAAM,CAAC,IAAI,EAAE,IAAI,EAAE,SAAS,EAAE,YAAY,GAAG,OAAO,CAAC,IAAI,CAAC;IAkBhE;;;OAGG;IACG,UAAU,CAAC,KAAK,EAAE,IAAI,EAAE,EAAE,UAAU,EAAE,YAAY,EAAE,GAAG,OAAO,CAAC,IAAI,CAAC;IAoB1E;;OAEG;IACG,MAAM,CAAC,MAAM,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC;IAa3C;;OAEG;IACG,MAAM,CAAC,QAAQ,EAAE,YAAY,EAAE,IAAI,SAAK,GAAG,OAAO,CAAC,MAAM,EAAE,CAAC;IA0BlE;;OAEG;IACG,kBAAkB,IAAI,OAAO,CAAC,MAAM,EAAE,CAAC;IAwB7C,uDAAuD;IACjD,KAAK,IAAI,OAAO,CAAC,MAAM,CAAC;IAY9B;;;OAGG;IACH,KAAK,IAAI,IAAI;CAKd"}

package/dist/vectors/vec-index.d.ts

@@ -1,52 +0,0 @@
-/**
- * KiroGraph sqlite-vec ANN Index
- *
- * Opt-in ANN index backed by sqlite-vec (the successor to sqlite-vss).
- * Uses better-sqlite3 to load the sqlite-vec extension into a dedicated
- * .kirograph/vec.db file, keeping it separate from the main node-sqlite3-wasm
- * database to avoid WAL-mode conflicts.
- *
- * Required optional dependencies (not installed by default):
- *   npm install better-sqlite3 sqlite-vec
- *
- * If either package is missing, VecIndex silently marks itself unavailable
- * and VectorManager falls back to in-process cosine search.
- */
-export declare class VecIndex {
-    private readonly kirographDir;
-    private db;
-    private _available;
-    private dim;
-    constructor(kirographDir: string, dim?: number);
-    isAvailable(): boolean;
-    /**
-     * Load better-sqlite3 + sqlite-vec and create the vec schema.
-     * No-op and silent when optional deps are missing.
-     */
-    initialize(): Promise<void>;
-    /**
-     * Insert or update the embedding for a node.
-     * We let vec_nodes auto-assign its rowid (avoiding the SQLITE_INTEGER type
-     * mismatch that occurs when passing explicit JS number rowids to vec0).
-     * The auto-assigned rowid is stored in vec_nodes_map for later lookup.
-     * vec0 tables don't support UPDATE, so updates are a DELETE + INSERT pair.
-     */
-    upsert(nodeId: string, embedding: Float32Array): void;
-    /**
-     * Remove a node's embedding from the index.
-     * Called explicitly when a node is deleted; stale entries are also filtered
-     * harmlessly in search() since GraphDatabase.getNode() will return null.
-     */
-    delete(nodeId: string): void;
-    /**
-     * ANN search: returns node IDs ordered by ascending distance.
-     * Uses sqlite-vec KNN syntax: `WHERE embedding MATCH ? ORDER BY distance LIMIT ?`
-     */
-    search(queryVec: Float32Array, topN?: number): string[];
-    /** Return all node IDs currently stored in the index. */
-    getEmbeddedNodeIds(): string[];
-    /** Returns the number of entries currently in the vec index. */
-    count(): number;
-    close(): void;
-}
-//# sourceMappingURL=vec-index.d.ts.map

package/dist/vectors/vec-index.d.ts.map

@@ -1 +0,0 @@
-{"version":3,"file":"vec-index.d.ts","sourceRoot":"","sources":["../../src/vectors/vec-index.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;GAaG;AAWH,qBAAa,QAAQ;IAMjB,OAAO,CAAC,QAAQ,CAAC,YAAY;IAL/B,OAAO,CAAC,EAAE,CAAa;IACvB,OAAO,CAAC,UAAU,CAAS;IAC3B,OAAO,CAAC,GAAG,CAAS;gBAGD,YAAY,EAAE,MAAM,EACrC,GAAG,SAAc;IAKnB,WAAW,IAAI,OAAO;IAItB;;;OAGG;IACG,UAAU,IAAI,OAAO,CAAC,IAAI,CAAC;IA6DjC;;;;;;OAMG;IACH,MAAM,CAAC,MAAM,EAAE,MAAM,EAAE,SAAS,EAAE,YAAY,GAAG,IAAI;IAyBrD;;;;OAIG;IACH,MAAM,CAAC,MAAM,EAAE,MAAM,GAAG,IAAI;IAiB5B;;;OAGG;IACH,MAAM,CAAC,QAAQ,EAAE,YAAY,EAAE,IAAI,SAAK,GAAG,MAAM,EAAE;IAoBnD,yDAAyD;IACzD,kBAAkB,IAAI,MAAM,EAAE;IAU9B,gEAAgE;IAChE,KAAK,IAAI,MAAM;IAUf,KAAK,IAAI,IAAI;CAOd"}