@zvec/zvec-grep 0.1.0

package/dist/engine/service/root.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"root.js","sourceRoot":"","sources":["../../../src/engine/service/root.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,UAAU,EAAE,MAAM,SAAS,CAAC;AACrC,OAAO,EAAE,OAAO,EAAE,IAAI,EAAE,OAAO,EAAE,MAAM,WAAW,CAAC;AAGnD,MAAM,CAAC,MAAM,aAAa,GAAG,YAAY,CAAC;AAC1C,MAAM,CAAC,MAAM,yBAAyB,GAAG,eAAe,CAAC;AACzD,MAAM,CAAC,MAAM,wBAAwB,GAAG,OAAO,CAAC;AAGhD,MAAM,aAAa,GAAG,eAAe,CAAC;AACtC,MAAM,eAAe,GAAG,iBAAiB,CAAC;AAW1C,MAAM,UAAU,mBAAmB,CAAC,IAAwB;IAC1D,OAAO,OAAO,CAAC,IAAI,IAAI,OAAO,CAAC,GAAG,EAAE,CAAC,CAAC;AACxC,CAAC;AAGD,MAAM,UAAU,aAAa,CAAC,IAAY;IACxC,OAAO,IAAI,CAAC,OAAO,CAAC,IAAI,CAAC,EAAE,aAAa,CAAC,CAAC;AAC5C,CAAC;AAGD,MAAM,UAAU,uBAAuB,CAAC,IAAY;IAClD,OAAO,IAAI,CAAC,aAAa,CAAC,IAAI,CAAC,EAAE,wBAAwB,CAAC,CAAC;AAC7D,CAAC;AAGD,MAAM,UAAU,sBAAsB,CAAC,IAAY;IACjD,MAAM,YAAY,GAAG,OAAO,CAAC,IAAI,CAAC,CAAC;IAEnC,OAAO;QACL,IAAI,EAAE,YAAY;QAClB,IAAI,EAAE,aAAa,CAAC,YAAY,CAAC;QACjC,cAAc,EAAE,yBAAyB;QACzC,cAAc,EAAE,uBAAuB,CAAC,YAAY,CAAC;KACtD,CAAC;AACJ,CAAC;AAGD,MAAM,UAAU,yBAAyB,CAAC,KAAa;IACrD,IAAI,OAAO,GAAG,OAAO,CAAC,KAAK,CAAC,CAAC;IAE7B,OAAO,IAAI,EAAE,CAAC;QACZ,MAAM,QAAQ,GAAG,sBAAsB,CAAC,OAAO,CAAC,CAAC;QACjD,IAAI,iBAAiB,CAAC,QAAQ,CAAC,EAAE,CAAC;YAChC,OAAO,QAAQ,CAAC;QAClB,CAAC;QAED,MAAM,MAAM,GAAG,OAAO,CAAC,OAAO,CAAC,CAAC;QAChC,IAAI,MAAM,KAAK,OAAO,EAAE,CAAC;YACvB,OAAO,IAAI,CAAC;QACd,CAAC;QAED,OAAO,GAAG,MAAM,CAAC;IACnB,CAAC;AACH,CAAC;AAGD,MAAM,UAAU,iBAAiB,CAAC,QAAgC;IAChE,OAAO,UAAU,CAAC,IAAI,CAAC,QAAQ,CAAC,IAAI,EAAE,aAAa,CAAC,CAAC;WAChD,UAAU,CAAC,IAAI,CAAC,QAAQ,CAAC,cAAc,EAAE,eAAe,CAAC,CAAC,CAAC;AAClE,CAAC"}

package/dist/engine/service/types.d.ts

@@ -0,0 +1,157 @@
+import type { EmbeddingModel } from "../models/embeddings.js";
+import type { CodeSymbolType, CollectionIndexStatus, CollectionInfo, Content, EntityMetadata, IndexProgress, IndexResult, Range, RootPath, SearchPlanRoute, SearchHitTrace, SearchMatchedBy } from "../types.js";
+export type CreateZvecGrepOptions = {
+    root?: string;
+    home?: string;
+    embeddingModel?: EmbeddingModel;
+    embedding?: string;
+    apiKey?: string;
+    endpoint?: string;
+    modelCacheDir?: string;
+    llamaGpu?: "auto" | "metal" | "vulkan" | "cuda" | false;
+    embeddingParallelism?: number;
+    defaultEmbedding?: boolean;
+};
+export type ZvecGrepInitOptions = {
+    root?: string;
+    rootPaths?: readonly (string | RootPath)[];
+    rebuild?: boolean;
+    resetPaths?: boolean;
+    includePaths?: readonly string[];
+    excludePaths?: readonly string[];
+    embeddingConcurrency?: number;
+    onProgress?: (progress: IndexProgress) => void;
+};
+export type ZvecGrepInfoOptions = {
+    root?: string;
+};
+export type ZvecGrepInfoResult = {
+    root: string;
+    initialized: boolean;
+    home: string;
+    indexPath: string;
+    source: "index" | "uninitialized";
+    collection?: CollectionInfo;
+    status?: CollectionIndexStatus | null;
+    suggestion?: string;
+};
+export type ZvecGrepContextRoute = SearchPlanRoute;
+export type ZvecGrepFallbackPolicy = "auto" | "disabled";
+export type ZvecGrepContextOptions = {
+    query?: string;
+    queries?: readonly string[];
+    rg?: boolean;
+    rgOptions?: ZvecGrepSearchOptions;
+    rgPaths?: readonly string[];
+    routes?: readonly ZvecGrepContextRoute[];
+    root?: string;
+    collection?: string;
+    limit?: number;
+    /** @deprecated Anonymous context queries require an index; use rg for explicit no-index lexical search. */
+    fallback?: ZvecGrepFallbackPolicy;
+    autoUpdate?: boolean;
+    onAutoUpdateProgress?: (progress: IndexProgress) => void;
+    trace?: boolean;
+    preferSymbol?: boolean;
+    symbolTypes?: readonly CodeSymbolType[];
+    includePaths?: readonly string[];
+    excludePaths?: readonly string[];
+    modifiedAfter?: number;
+    modifiedBefore?: number;
+    embeddingConcurrency?: number;
+};
+export type ZvecGrepSearchOptions = {
+    extraArgs?: readonly string[];
+    fixedStrings?: boolean;
+    ignoreCase?: boolean;
+    wordRegexp?: boolean;
+    beforeContext?: number;
+    afterContext?: number;
+    hidden?: boolean;
+};
+export type ZvecGrepContextSource = "index" | "rg" | "lexical_fallback";
+export type ZvecGrepContextCoverage = "ranked_sample" | "lexical_exhaustive" | "lexical_truncated";
+export type ZvecGrepContextFile = {
+    absolutePath: string;
+    relativePath: string;
+    rootPath?: string;
+};
+export type ZvecGrepContextItemKind = "indexed_entity" | "lexical_match";
+export type ZvecGrepContextItem = {
+    kind: ZvecGrepContextItemKind;
+    rank: number;
+    file: ZvecGrepContextFile;
+    range: Range;
+    excerptRange?: Range;
+    content: string;
+    contentRole?: "source" | "outline";
+    outline?: string;
+    status: "fresh" | "possibly_stale";
+    score?: number;
+    matchedBy: SearchMatchedBy | "lexical";
+    metadata?: EntityMetadata;
+    entityId?: string;
+    trace?: SearchHitTrace;
+};
+export type ZvecGrepContextCollection = {
+    id: string;
+    name: string;
+    path: string;
+    anonymous: boolean;
+};
+export type ZvecGrepLexicalFallbackDiagnostics = {
+    backend: "bundled-rg" | "rg";
+    command: string;
+    args: readonly string[];
+    ignoredDirectories: readonly string[];
+    missingPaths?: readonly string[];
+    searchedPaths?: readonly string[];
+    limit?: number;
+    truncated: boolean;
+};
+export type ZvecGrepIndexDiagnostics = {
+    hitsReturned: number;
+    routes: readonly {
+        id: string;
+        mode: "fts" | "vector";
+        query: string;
+    }[];
+};
+export type ZvecGrepContextDiagnostics = {
+    emptyReason?: "no_matches" | "no_searchable_files" | "index_unavailable" | "search_failed";
+    index?: ZvecGrepIndexDiagnostics;
+    fallback?: ZvecGrepLexicalFallbackDiagnostics;
+};
+export type ZvecGrepContextResult = {
+    query: string;
+    root: string;
+    source: ZvecGrepContextSource;
+    coverage: ZvecGrepContextCoverage;
+    collection?: ZvecGrepContextCollection;
+    items: ZvecGrepContextItem[];
+    diagnostics: ZvecGrepContextDiagnostics;
+};
+export type ZvecGrepCollectionIndexOptions = {
+    rebuild?: boolean;
+    resetPaths?: boolean;
+    includePaths?: readonly string[];
+    excludePaths?: readonly string[];
+    embeddingConcurrency?: number;
+    onProgress?: (progress: IndexProgress) => void;
+};
+export type ZvecGrepCollections = {
+    list(): Promise<CollectionInfo[]>;
+    info(name: string): Promise<CollectionInfo | null>;
+    status(name: string): Promise<CollectionIndexStatus | null>;
+    index(name: string, paths?: string | RootPath | readonly (string | RootPath)[], options?: ZvecGrepCollectionIndexOptions): Promise<IndexResult>;
+    remove(name: string): Promise<boolean>;
+};
+export type ZvecGrep = {
+    readonly root: string;
+    readonly collections: ZvecGrepCollections;
+    init(options?: ZvecGrepInitOptions): Promise<IndexResult>;
+    info(options?: ZvecGrepInfoOptions): Promise<ZvecGrepInfoResult>;
+    context(options: ZvecGrepContextOptions): Promise<ZvecGrepContextResult>;
+    close(): Promise<void>;
+};
+export type ZvecGrepContent = Content;

package/dist/engine/service/types.js

@@ -0,0 +1,2 @@
+export {};
+//# sourceMappingURL=types.js.map

package/dist/engine/service/types.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"types.js","sourceRoot":"","sources":["../../../src/engine/service/types.ts"],"names":[],"mappings":""}

package/dist/engine/service/zvec-grep.d.ts

@@ -0,0 +1,2 @@
+import type { CreateZvecGrepOptions, ZvecGrep } from "./types.js";
+export declare function createZvecGrep(options?: CreateZvecGrepOptions): Promise<ZvecGrep>;