@angri450/zvec-grep 0.2.2

package/dist/engine/service/structure-enrichment.d.ts

@@ -0,0 +1,8 @@
+import type { ZvecGrepStructureEnrichmentDiagnostics, ZvecGrepContextItem } from "./types.js";
+export declare const RG_STRUCTURE_ENRICH_FILE_LIMIT = 100;
+type StructureEnrichmentResult = {
+    items: ZvecGrepContextItem[];
+    diagnostics: ZvecGrepStructureEnrichmentDiagnostics;
+};
+export declare function enrichLexicalItemsWithStructure(root: string, items: readonly ZvecGrepContextItem[], fileLimit?: number, maxFileSizeBytes?: number): Promise<StructureEnrichmentResult>;
+export {};

package/dist/engine/service/structure-enrichment.js

@@ -0,0 +1,178 @@
+import { readFile, stat } from "node:fs/promises";
+import { relative } from "node:path";
+import { extract } from "../extraction/index.js";
+import { detectFileType } from "../file-type.js";
+import { resolveMaxFileSizeBytes } from "../file-size-policy.js";
+import { normalizePath, toDisplayPath } from "../utils/path.js";
+import { sha256Text } from "../utils/hash.js";
+export const RG_STRUCTURE_ENRICH_FILE_LIMIT = 100;
+const STRUCTURE_ENRICH_FILE_ID_NAMESPACE = "__rg_structure__";
+export async function enrichLexicalItemsWithStructure(root, items, fileLimit = RG_STRUCTURE_ENRICH_FILE_LIMIT, maxFileSizeBytes) {
+    const matchedFiles = uniqueLexicalFilePaths(items);
+    const selectedFiles = new Set(matchedFiles.slice(0, fileLimit));
+    const fragmentsByFile = new Map();
+    let parsedFiles = 0;
+    for (const absolutePath of selectedFiles) {
+        const fragments = await parseStructuralFragments(root, absolutePath, maxFileSizeBytes);
+        fragmentsByFile.set(absolutePath, fragments);
+        if (fragments !== null) {
+            parsedFiles++;
+        }
+    }
+    let enrichedItems = 0;
+    const enrichedFiles = new Set();
+    const enriched = items.map((item) => {
+        if (item.kind !== "lexical_match") {
+            return item;
+        }
+        const fragments = fragmentsByFile.get(normalizePath(item.file.absolutePath));
+        if (!fragments || fragments.length === 0) {
+            return item;
+        }
+        const matchRange = lexicalMatchRange(item);
+        if (!matchRange) {
+            return item;
+        }
+        const container = smallestContainingFragment(fragments, matchRange);
+        if (!container) {
+            return item;
+        }
+        enrichedItems++;
+        enrichedFiles.add(item.file.absolutePath);
+        const contextContainer = {
+            entityId: container.group ?? container.id,
+            range: container.range,
+            metadata: container.metadata,
+        };
+        return {
+            ...item,
+            metadata: container.metadata ?? item.metadata,
+            container: contextContainer,
+        };
+    });
+    return {
+        items: enriched,
+        diagnostics: {
+            source: "structural_extraction",
+            fileLimit,
+            matchedFiles: matchedFiles.length,
+            parsedFiles,
+            enrichedFiles: enrichedFiles.size,
+            enrichedItems,
+            skippedFiles: Math.max(0, matchedFiles.length - parsedFiles),
+            truncated: matchedFiles.length > fileLimit,
+        },
+    };
+}
+function uniqueLexicalFilePaths(items) {
+    const seen = new Set();
+    const paths = [];
+    for (const item of items) {
+        if (item.kind !== "lexical_match") {
+            continue;
+        }
+        const absolutePath = normalizePath(item.file.absolutePath);
+        if (!seen.has(absolutePath)) {
+            seen.add(absolutePath);
+            paths.push(absolutePath);
+        }
+    }
+    return paths;
+}
+async function parseStructuralFragments(root, absolutePath, maxFileSizeBytes) {
+    try {
+        const file = await fileInfoForStructure(root, absolutePath, maxFileSizeBytes);
+        if (!file) {
+            return null;
+        }
+        const text = await readFile(absolutePath, "utf8");
+        const source = {
+            kind: "text",
+            file,
+            text,
+        };
+        const fragments = await extract(source);
+        const structuralFragments = fragments.filter(isStructuralFragment);
+        return structuralFragments.length > 0 ? structuralFragments : null;
+    }
+    catch {
+        return null;
+    }
+}
+function isStructuralFragment(fragment) {
+    return (fragment.metadata?.kind === "code" || fragment.metadata?.kind === "markdown");
+}
+async function fileInfoForStructure(root, absolutePath, maxFileSizeBytes) {
+    const info = await stat(absolutePath).catch(() => null);
+    if (!info || !info.isFile() || info.size <= 0) {
+        return null;
+    }
+    const detected = detectFileType(absolutePath);
+    if (!detected || !isStructurallyEnrichableFile(detected)) {
+        return null;
+    }
+    if (info.size > resolveMaxFileSizeBytes(detected.kind, maxFileSizeBytes)) {
+        return null;
+    }
+    return {
+        id: makeStructureFileId(absolutePath),
+        absolutePath: normalizePath(absolutePath),
+        relativePath: toDisplayPath(relative(root, absolutePath) || "."),
+        rootPath: root,
+        sizeBytes: info.size,
+        lastModifiedTime: info.mtimeMs,
+        kind: detected.kind,
+        format: detected.format,
+    };
+}
+function isStructurallyEnrichableFile(file) {
+    return (file.kind === "code" || (file.kind === "text" && file.format === "markdown"));
+}
+function lexicalMatchRange(item) {
+    const range = item.excerptRange ?? item.range;
+    return range.kind === "text" ? range : null;
+}
+function smallestContainingFragment(fragments, matchRange) {
+    let best = null;
+    for (const fragment of fragments) {
+        if (!textRangeContains(fragment.range, matchRange)) {
+            continue;
+        }
+        if (!best || compareFragmentContainer(fragment, best) < 0) {
+            best = fragment;
+        }
+    }
+    return best;
+}
+function textRangeContains(outer, inner) {
+    return (outer.kind === "text" &&
+        outer.startLine <= inner.startLine &&
+        outer.endLine >= inner.endLine);
+}
+function compareFragmentContainer(left, right) {
+    const leftRange = left.range;
+    const rightRange = right.range;
+    const leftLines = leftRange.kind === "text"
+        ? leftRange.endLine - leftRange.startLine
+        : Number.MAX_SAFE_INTEGER;
+    const rightLines = rightRange.kind === "text"
+        ? rightRange.endLine - rightRange.startLine
+        : Number.MAX_SAFE_INTEGER;
+    return (leftLines - rightLines ||
+        fragmentSpecificityScore(right) - fragmentSpecificityScore(left) ||
+        left.id.localeCompare(right.id));
+}
+function fragmentSpecificityScore(fragment) {
+    const metadata = fragment.metadata;
+    if (!metadata) {
+        return 0;
+    }
+    if (metadata.kind === "code") {
+        return metadata.symbolName ? 2 : 1;
+    }
+    return metadata.heading ? 1 : 0;
+}
+function makeStructureFileId(absolutePath) {
+    return sha256Text(`${STRUCTURE_ENRICH_FILE_ID_NAMESPACE}\0${normalizePath(absolutePath)}`);
+}
+//# sourceMappingURL=structure-enrichment.js.map

package/dist/engine/service/structure-enrichment.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"structure-enrichment.js","sourceRoot":"","sources":["../../../src/engine/service/structure-enrichment.ts"],"names":[],"mappings":"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"}

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

@@ -0,0 +1,212 @@
+import type { EmbeddingModel } from "../models/index.js";
+import type { CodeSymbolType, WorkspaceIndexPolicy, WorkspaceIndexStatus, WorkspaceIndexInfo, Content, EntityMetadata, IndexProgress, IndexResult, Range, RootPath, SearchPlanRoute, SearchHitTrace, SearchMatchedBy, TimingEntry } from "../types.js";
+export type CreateZvecGrepOptions = {
+    root?: string;
+    home?: string;
+    embeddingModel?: EmbeddingModel;
+    embeddingModelOwnership?: "owned" | "borrowed";
+    daemonInstanceToken?: string;
+    embedding?: string;
+    apiKey?: string;
+    endpoint?: string;
+    modelCacheDir?: string;
+    device?: "auto" | "cpu" | "metal" | "vulkan" | "cuda";
+    /** Default for index construction and refresh, never for query embeddings. */
+    embeddingConcurrency?: number;
+    authorizationSigningKeyPath?: string;
+};
+export type ZvecGrepIndexOptions = {
+    root?: string;
+    rootPaths?: readonly (string | RootPath)[];
+    rebuild?: boolean;
+    resetPaths?: boolean;
+    includePaths?: readonly string[];
+    excludePaths?: readonly string[];
+    globs?: readonly string[];
+    insensitiveGlobs?: readonly string[];
+    fileTypes?: readonly string[];
+    excludedFileTypes?: readonly string[];
+    hidden?: boolean;
+    noIgnore?: boolean;
+    ignoreFiles?: readonly string[];
+    maxDepth?: number;
+    maxFileSizeBytes?: number;
+    follow?: boolean;
+    embeddingConcurrency?: number;
+    onProgress?: (progress: IndexProgress) => void;
+    changedPaths?: readonly string[];
+    signal?: AbortSignal;
+    onWriterContext?: (context: ZvecGrepWriterContext) => void | (() => void | Promise<void>);
+};
+export type ZvecGrepWriterContext = (options: ZvecGrepContextOptions) => Promise<ZvecGrepContextResult>;
+export type ZvecGrepInfoOptions = {
+    root?: string;
+    includeStatus?: boolean;
+};
+export type ZvecGrepInfoResult = {
+    root: string;
+    indexed: boolean;
+    indexPolicy: WorkspaceIndexPolicy | "undecided";
+    home: string;
+    indexPath: string;
+    source: "index" | "unindexed";
+    workspaceIndex?: WorkspaceIndexInfo;
+    status?: WorkspaceIndexStatus | null;
+    suggestion?: string;
+};
+export type ZvecGrepContextRoute = SearchPlanRoute;
+export type ZvecGrepContextOptions = {
+    query?: string;
+    queries?: readonly string[];
+    rg?: boolean;
+    rgOptions?: ZvecGrepSearchOptions;
+    rgPaths?: readonly string[];
+    routes?: readonly ZvecGrepContextRoute[];
+    /** Fuse every query group into one ranked search plan. */
+    fuse?: boolean;
+    root?: string;
+    limit?: number;
+    autoUpdate?: boolean;
+    onAutoUpdateProgress?: (progress: IndexProgress) => void;
+    trace?: boolean;
+    preferSymbol?: boolean;
+    symbolTypes?: readonly CodeSymbolType[];
+    includePaths?: readonly string[];
+    excludePaths?: readonly string[];
+    globs?: readonly string[];
+    insensitiveGlobs?: readonly string[];
+    fileTypes?: readonly string[];
+    excludedFileTypes?: readonly string[];
+    hidden?: boolean;
+    noIgnore?: boolean;
+    ignoreFiles?: readonly string[];
+    maxDepth?: number;
+    maxFileSizeBytes?: number;
+    follow?: boolean;
+    modifiedAfter?: number;
+    modifiedBefore?: number;
+    embeddingConcurrency?: number;
+};
+export type ZvecGrepSearchOptions = {
+    extraArgs?: readonly string[];
+    patternFiles?: readonly string[];
+    fixedStrings?: boolean;
+    ignoreCase?: boolean;
+    wordRegexp?: boolean;
+    beforeContext?: number;
+    afterContext?: number;
+    hidden?: boolean;
+};
+export type ZvecGrepContextSource = "index" | "rg";
+export type ZvecGrepContextCoverage = "ranked_sample" | "rg_exhaustive" | "rg_truncated";
+export type ZvecGrepContextFile = {
+    absolutePath: string;
+    relativePath: string;
+    rootPath?: string;
+};
+export type ZvecGrepContextItemKind = "indexed_entity" | "lexical_match";
+export type ZvecGrepContextContainer = {
+    entityId: string;
+    range: Range;
+    metadata?: EntityMetadata;
+};
+export type ZvecGrepContextQueryGroupMatch = {
+    id: string;
+    query: string;
+    role: "primary" | "supplemental";
+    rank: number;
+    matchedBy: SearchMatchedBy;
+};
+export type ZvecGrepContextSelectionReason = "coverage" | "global_fill";
+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;
+    container?: ZvecGrepContextContainer;
+    trace?: SearchHitTrace;
+    queryGroups?: readonly ZvecGrepContextQueryGroupMatch[];
+    selectionReason?: ZvecGrepContextSelectionReason;
+    coverageGroup?: string;
+};
+export type ZvecGrepContextGroupResult = {
+    id: string;
+    query: string;
+    role: "primary" | "supplemental";
+    items: ZvecGrepContextItem[];
+};
+export type ZvecGrepContextWorkspaceIndex = {
+    id: string;
+    name: string;
+    path: string;
+};
+export type ZvecGrepRgDiagnostics = {
+    backend: "bundled-rg" | "rg";
+    command: string;
+    args: readonly string[];
+    ignoredDirectories: readonly string[];
+    missingPaths?: readonly string[];
+    searchedPaths?: readonly string[];
+    limit?: number;
+    truncated: boolean;
+};
+export type ZvecGrepStructureEnrichmentDiagnostics = {
+    source: "structural_extraction";
+    fileLimit: number;
+    matchedFiles: number;
+    parsedFiles: number;
+    enrichedFiles: number;
+    enrichedItems: number;
+    skippedFiles: number;
+    truncated: boolean;
+};
+export type ZvecGrepIndexDiagnostics = {
+    hitsReturned: number;
+    queryGroups?: readonly {
+        id: string;
+        query: string;
+        role: "primary" | "supplemental";
+    }[];
+    routes: readonly {
+        id: string;
+        mode: "fts" | "vector";
+        query: string;
+    }[];
+};
+export type ZvecGrepContextDiagnostics = {
+    emptyReason?: "no_matches" | "no_searchable_files";
+    index?: ZvecGrepIndexDiagnostics;
+    rg?: ZvecGrepRgDiagnostics;
+    structure?: ZvecGrepStructureEnrichmentDiagnostics;
+    timings?: readonly TimingEntry[];
+};
+export type ZvecGrepContextResult = {
+    query: string;
+    root: string;
+    source: ZvecGrepContextSource;
+    coverage: ZvecGrepContextCoverage;
+    workspaceIndex?: ZvecGrepContextWorkspaceIndex;
+    items: ZvecGrepContextItem[];
+    /** Per-query-group recall lists before cross-group deduplication and reranking. */
+    groupResults?: ZvecGrepContextGroupResult[];
+    diagnostics: ZvecGrepContextDiagnostics;
+};
+export type ZvecGrep = {
+    readonly root: string;
+    index(options?: ZvecGrepIndexOptions): Promise<IndexResult>;
+    dropIndex(options?: ZvecGrepInfoOptions): Promise<boolean>;
+    disableIndex(options?: ZvecGrepInfoOptions): Promise<ZvecGrepInfoResult>;
+    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/workspace-index.d.ts

@@ -0,0 +1,26 @@
+import type { EmbeddingModel } from "../models/index.js";
+import type { WorkspaceIndexEmbeddingSchema, WorkspaceIndexStatus, WorkspaceIndexInfo, IndexOptions, IndexResult, SearchPlan, SearchPlanResult } from "../types.js";
+export type WorkspaceIndexOptions = {
+    mode: "read" | "write";
+    embeddingModel?: EmbeddingModel;
+};
+export declare class WorkspaceIndex {
+    readonly info: WorkspaceIndexInfo;
+    private readonly storage;
+    private readonly embedding;
+    private readonly embeddingModel?;
+    private closed;
+    constructor(info: WorkspaceIndexInfo, options: WorkspaceIndexOptions);
+    get name(): string;
+    index(options?: IndexOptions): Promise<IndexResult>;
+    status(): Promise<WorkspaceIndexStatus>;
+    searchPlan(plan: SearchPlan): Promise<SearchPlanResult>;
+    close(): void;
+    private validateIndexVersion;
+    private validateEmbeddingSchema;
+    private requireEmbeddingModel;
+}
+export declare function isWorkspaceIndexed(info: WorkspaceIndexInfo | null | undefined): info is WorkspaceIndexInfo & {
+    embedding: WorkspaceIndexEmbeddingSchema;
+    indexVersion: number;
+};

package/dist/engine/service/workspace-index.js

@@ -0,0 +1,157 @@
+import { workspaceIndexDetail, detail, EngineError, errorDetails, } from "../errors.js";
+import { getWorkspaceIndexStatus, indexWorkspace, indexWorkspacePaths, } from "../pipeline/indexing/index.js";
+import { searchWorkspaceIndex } from "../pipeline/search/index.js";
+import { createWorkspaceIndexStorage, } from "../storage/index.js";
+import { CURRENT_INDEX_VERSION } from "../types.js";
+export class WorkspaceIndex {
+    info;
+    storage;
+    embedding;
+    embeddingModel;
+    closed = false;
+    constructor(info, options) {
+        this.info = info;
+        this.embeddingModel = options.embeddingModel;
+        this.embedding = requireWorkspaceIndexEmbedding(info, "open");
+        this.validateIndexVersion();
+        if (this.embeddingModel) {
+            this.validateEmbeddingSchema(this.embeddingModel);
+        }
+        if (options.mode === "write") {
+            this.storage = createWorkspaceIndexStorage({
+                storagePath: info.path,
+                readOnly: false,
+                embedding: this.embedding,
+            });
+        }
+        else {
+            this.storage = createWorkspaceIndexStorage({
+                storagePath: info.path,
+                readOnly: true,
+            });
+        }
+    }
+    get name() {
+        return this.info.name;
+    }
+    index(options = {}) {
+        if (this.storage.readOnly) {
+            throw new EngineError("Cannot update a read-only workspace index", {
+                code: "ZVEC_GREP.ENGINE.WORKSPACE_INDEX.READ_ONLY",
+                context: workspaceIndexOperationDetails(this.name, "index"),
+            });
+        }
+        const embeddingModel = this.requireEmbeddingModel("index");
+        const context = {
+            workspaceIndex: this.info,
+            embeddingModel,
+            storage: this.storage,
+            embeddingConcurrency: options.embeddingConcurrency,
+            onProgress: options.onProgress,
+            signal: options.signal,
+        };
+        return options.changedPaths && options.changedPaths.length > 0
+            ? indexWorkspacePaths(context, options.changedPaths)
+            : indexWorkspace(context);
+    }
+    status() {
+        return getWorkspaceIndexStatus(this.info, this.storage.listFiles());
+    }
+    searchPlan(plan) {
+        return searchWorkspaceIndex(plan, {
+            workspaceIndex: this.info,
+            embeddingModel: this.embeddingModel,
+            storage: this.storage,
+        });
+    }
+    close() {
+        if (this.closed) {
+            return;
+        }
+        this.storage.close();
+        this.closed = true;
+    }
+    validateIndexVersion() {
+        if (this.info.indexVersion !== CURRENT_INDEX_VERSION) {
+            throw new EngineError("Workspace index version is not supported", {
+                code: "ZVEC_GREP.ENGINE.WORKSPACE_INDEX.VERSION_MISMATCH",
+                context: errorDetails([
+                    workspaceIndexDetail(this.name),
+                    detail("expected", CURRENT_INDEX_VERSION),
+                    detail("actual", this.info.indexVersion),
+                    detail("hint", 'Recreate the index with the current zvec-grep version; run "zg --index --rebuild" for a workspace index.'),
+                ]),
+            });
+        }
+    }
+    validateEmbeddingSchema(current) {
+        this.validateIndexVersion();
+        const expected = this.embedding;
+        if (expected.provider !== current.info.provider) {
+            throw new EngineError("Workspace index embedding provider does not match current model", {
+                code: "ZVEC_GREP.ENGINE.WORKSPACE_INDEX.EMBEDDING_PROVIDER_MISMATCH",
+                context: workspaceIndexMismatchDetails(this.name, expected.provider, current.info.provider),
+            });
+        }
+        if (expected.model !== current.info.name) {
+            throw new EngineError("Workspace index embedding model does not match current model", {
+                code: "ZVEC_GREP.ENGINE.WORKSPACE_INDEX.EMBEDDING_MODEL_MISMATCH",
+                context: workspaceIndexMismatchDetails(this.name, expected.model, current.info.name),
+            });
+        }
+        if (expected.dimension !== current.info.dimension) {
+            throw new EngineError("Workspace index embedding dimension does not match current model", {
+                code: "ZVEC_GREP.ENGINE.WORKSPACE_INDEX.EMBEDDING_DIMENSION_MISMATCH",
+                context: workspaceIndexMismatchDetails(this.name, expected.dimension, current.info.dimension),
+            });
+        }
+        if (expected.metric !== current.info.metric) {
+            throw new EngineError("Workspace index embedding metric does not match current model", {
+                code: "ZVEC_GREP.ENGINE.WORKSPACE_INDEX.EMBEDDING_METRIC_MISMATCH",
+                context: workspaceIndexMismatchDetails(this.name, expected.metric, current.info.metric),
+            });
+        }
+    }
+    requireEmbeddingModel(operation) {
+        if (!this.embeddingModel) {
+            throw new EngineError("Workspace index operation requires an embedding model", {
+                code: "ZVEC_GREP.ENGINE.WORKSPACE_INDEX.EMBEDDING_MODEL_REQUIRED",
+                context: workspaceIndexOperationDetails(this.name, operation),
+            });
+        }
+        return this.embeddingModel;
+    }
+}
+function workspaceIndexOperationDetails(name, operation) {
+    return errorDetails([
+        workspaceIndexDetail(name),
+        detail("operation", operation),
+    ]);
+}
+function workspaceIndexMismatchDetails(name, expected, actual) {
+    return errorDetails([
+        workspaceIndexDetail(name),
+        detail("expected", expected),
+        detail("actual", actual),
+    ]);
+}
+export function isWorkspaceIndexed(info) {
+    return (info?.embedding !== null &&
+        info?.embedding !== undefined &&
+        info.indexVersion !== null &&
+        info.indexVersion !== undefined);
+}
+function requireWorkspaceIndexEmbedding(info, operation) {
+    if (isWorkspaceIndexed(info)) {
+        return info.embedding;
+    }
+    throw new EngineError("Workspace index has not been built", {
+        code: "ZVEC_GREP.ENGINE.WORKSPACE_INDEX.MISSING",
+        context: errorDetails([
+            workspaceIndexDetail(info.name),
+            detail("operation", operation),
+            detail("hint", "Run zg --index to build this index."),
+        ]),
+    });
+}
+//# sourceMappingURL=workspace-index.js.map

package/dist/engine/service/workspace-index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"workspace-index.js","sourceRoot":"","sources":["../../../src/engine/service/workspace-index.ts"],"names":[],"mappings":"AAAA,OAAO,EACL,oBAAoB,EACpB,MAAM,EACN,WAAW,EACX,YAAY,GACb,MAAM,cAAc,CAAC;AAEtB,OAAO,EACL,uBAAuB,EACvB,cAAc,EACd,mBAAmB,GACpB,MAAM,+BAA+B,CAAC;AACvC,OAAO,EAAE,oBAAoB,EAAE,MAAM,6BAA6B,CAAC;AACnE,OAAO,EACL,2BAA2B,GAE5B,MAAM,qBAAqB,CAAC;AAU7B,OAAO,EAAE,qBAAqB,EAAE,MAAM,aAAa,CAAC;AAOpD,MAAM,OAAO,cAAc;IAOd;IANM,OAAO,CAAwB;IAC/B,SAAS,CAAgC;IACzC,cAAc,CAAkB;IACzC,MAAM,GAAG,KAAK,CAAC;IAEvB,YACW,IAAwB,EACjC,OAA8B;QADrB,SAAI,GAAJ,IAAI,CAAoB;QAGjC,IAAI,CAAC,cAAc,GAAG,OAAO,CAAC,cAAc,CAAC;QAC7C,IAAI,CAAC,SAAS,GAAG,8BAA8B,CAAC,IAAI,EAAE,MAAM,CAAC,CAAC;QAC9D,IAAI,CAAC,oBAAoB,EAAE,CAAC;QAC5B,IAAI,IAAI,CAAC,cAAc,EAAE,CAAC;YACxB,IAAI,CAAC,uBAAuB,CAAC,IAAI,CAAC,cAAc,CAAC,CAAC;QACpD,CAAC;QAED,IAAI,OAAO,CAAC,IAAI,KAAK,OAAO,EAAE,CAAC;YAC7B,IAAI,CAAC,OAAO,GAAG,2BAA2B,CAAC;gBACzC,WAAW,EAAE,IAAI,CAAC,IAAI;gBACtB,QAAQ,EAAE,KAAK;gBACf,SAAS,EAAE,IAAI,CAAC,SAAS;aAC1B,CAAC,CAAC;QACL,CAAC;aAAM,CAAC;YACN,IAAI,CAAC,OAAO,GAAG,2BAA2B,CAAC;gBACzC,WAAW,EAAE,IAAI,CAAC,IAAI;gBACtB,QAAQ,EAAE,IAAI;aACf,CAAC,CAAC;QACL,CAAC;IACH,CAAC;IAED,IAAI,IAAI;QACN,OAAO,IAAI,CAAC,IAAI,CAAC,IAAI,CAAC;IACxB,CAAC;IAED,KAAK,CAAC,UAAwB,EAAE;QAC9B,IAAI,IAAI,CAAC,OAAO,CAAC,QAAQ,EAAE,CAAC;YAC1B,MAAM,IAAI,WAAW,CAAC,2CAA2C,EAAE;gBACjE,IAAI,EAAE,4CAA4C;gBAClD,OAAO,EAAE,8BAA8B,CAAC,IAAI,CAAC,IAAI,EAAE,OAAO,CAAC;aAC5D,CAAC,CAAC;QACL,CAAC;QAED,MAAM,cAAc,GAAG,IAAI,CAAC,qBAAqB,CAAC,OAAO,CAAC,CAAC;QAE3D,MAAM,OAAO,GAAG;YACd,cAAc,EAAE,IAAI,CAAC,IAAI;YACzB,cAAc;YACd,OAAO,EAAE,IAAI,CAAC,OAAO;YACrB,oBAAoB,EAAE,OAAO,CAAC,oBAAoB;YAClD,UAAU,EAAE,OAAO,CAAC,UAAU;YAC9B,MAAM,EAAE,OAAO,CAAC,MAAM;SACvB,CAAC;QACF,OAAO,OAAO,CAAC,YAAY,IAAI,OAAO,CAAC,YAAY,CAAC,MAAM,GAAG,CAAC;YAC5D,CAAC,CAAC,mBAAmB,CAAC,OAAO,EAAE,OAAO,CAAC,YAAY,CAAC;YACpD,CAAC,CAAC,cAAc,CAAC,OAAO,CAAC,CAAC;IAC9B,CAAC;IAED,MAAM;QACJ,OAAO,uBAAuB,CAAC,IAAI,CAAC,IAAI,EAAE,IAAI,CAAC,OAAO,CAAC,SAAS,EAAE,CAAC,CAAC;IACtE,CAAC;IAED,UAAU,CAAC,IAAgB;QACzB,OAAO,oBAAoB,CAAC,IAAI,EAAE;YAChC,cAAc,EAAE,IAAI,CAAC,IAAI;YACzB,cAAc,EAAE,IAAI,CAAC,cAAc;YACnC,OAAO,EAAE,IAAI,CAAC,OAAO;SACtB,CAAC,CAAC;IACL,CAAC;IAED,KAAK;QACH,IAAI,IAAI,CAAC,MAAM,EAAE,CAAC;YAChB,OAAO;QACT,CAAC;QAED,IAAI,CAAC,OAAO,CAAC,KAAK,EAAE,CAAC;QACrB,IAAI,CAAC,MAAM,GAAG,IAAI,CAAC;IACrB,CAAC;IAEO,oBAAoB;QAC1B,IAAI,IAAI,CAAC,IAAI,CAAC,YAAY,KAAK,qBAAqB,EAAE,CAAC;YACrD,MAAM,IAAI,WAAW,CAAC,0CAA0C,EAAE;gBAChE,IAAI,EAAE,mDAAmD;gBACzD,OAAO,EAAE,YAAY,CAAC;oBACpB,oBAAoB,CAAC,IAAI,CAAC,IAAI,CAAC;oBAC/B,MAAM,CAAC,UAAU,EAAE,qBAAqB,CAAC;oBACzC,MAAM,CAAC,QAAQ,EAAE,IAAI,CAAC,IAAI,CAAC,YAAY,CAAC;oBACxC,MAAM,CACJ,MAAM,EACN,0GAA0G,CAC3G;iBACF,CAAC;aACH,CAAC,CAAC;QACL,CAAC;IACH,CAAC;IAEO,uBAAuB,CAAC,OAAuB;QACrD,IAAI,CAAC,oBAAoB,EAAE,CAAC;QAE5B,MAAM,QAAQ,GAAG,IAAI,CAAC,SAAS,CAAC;QAEhC,IAAI,QAAQ,CAAC,QAAQ,KAAK,OAAO,CAAC,IAAI,CAAC,QAAQ,EAAE,CAAC;YAChD,MAAM,IAAI,WAAW,CACnB,iEAAiE,EACjE;gBACE,IAAI,EAAE,8DAA8D;gBACpE,OAAO,EAAE,6BAA6B,CACpC,IAAI,CAAC,IAAI,EACT,QAAQ,CAAC,QAAQ,EACjB,OAAO,CAAC,IAAI,CAAC,QAAQ,CACtB;aACF,CACF,CAAC;QACJ,CAAC;QAED,IAAI,QAAQ,CAAC,KAAK,KAAK,OAAO,CAAC,IAAI,CAAC,IAAI,EAAE,CAAC;YACzC,MAAM,IAAI,WAAW,CACnB,8DAA8D,EAC9D;gBACE,IAAI,EAAE,2DAA2D;gBACjE,OAAO,EAAE,6BAA6B,CACpC,IAAI,CAAC,IAAI,EACT,QAAQ,CAAC,KAAK,EACd,OAAO,CAAC,IAAI,CAAC,IAAI,CAClB;aACF,CACF,CAAC;QACJ,CAAC;QAED,IAAI,QAAQ,CAAC,SAAS,KAAK,OAAO,CAAC,IAAI,CAAC,SAAS,EAAE,CAAC;YAClD,MAAM,IAAI,WAAW,CACnB,kEAAkE,EAClE;gBACE,IAAI,EAAE,+DAA+D;gBACrE,OAAO,EAAE,6BAA6B,CACpC,IAAI,CAAC,IAAI,EACT,QAAQ,CAAC,SAAS,EAClB,OAAO,CAAC,IAAI,CAAC,SAAS,CACvB;aACF,CACF,CAAC;QACJ,CAAC;QAED,IAAI,QAAQ,CAAC,MAAM,KAAK,OAAO,CAAC,IAAI,CAAC,MAAM,EAAE,CAAC;YAC5C,MAAM,IAAI,WAAW,CACnB,+DAA+D,EAC/D;gBACE,IAAI,EAAE,4DAA4D;gBAClE,OAAO,EAAE,6BAA6B,CACpC,IAAI,CAAC,IAAI,EACT,QAAQ,CAAC,MAAM,EACf,OAAO,CAAC,IAAI,CAAC,MAAM,CACpB;aACF,CACF,CAAC;QACJ,CAAC;IACH,CAAC;IAEO,qBAAqB,CAAC,SAAiB;QAC7C,IAAI,CAAC,IAAI,CAAC,cAAc,EAAE,CAAC;YACzB,MAAM,IAAI,WAAW,CACnB,uDAAuD,EACvD;gBACE,IAAI,EAAE,2DAA2D;gBACjE,OAAO,EAAE,8BAA8B,CAAC,IAAI,CAAC,IAAI,EAAE,SAAS,CAAC;aAC9D,CACF,CAAC;QACJ,CAAC;QAED,OAAO,IAAI,CAAC,cAAc,CAAC;IAC7B,CAAC;CACF;AAED,SAAS,8BAA8B,CACrC,IAAY,EACZ,SAAiB;IAEjB,OAAO,YAAY,CAAC;QAClB,oBAAoB,CAAC,IAAI,CAAC;QAC1B,MAAM,CAAC,WAAW,EAAE,SAAS,CAAC;KAC/B,CAAC,CAAC;AACL,CAAC;AAED,SAAS,6BAA6B,CACpC,IAAY,EACZ,QAAyB,EACzB,MAAuB;IAEvB,OAAO,YAAY,CAAC;QAClB,oBAAoB,CAAC,IAAI,CAAC;QAC1B,MAAM,CAAC,UAAU,EAAE,QAAQ,CAAC;QAC5B,MAAM,CAAC,QAAQ,EAAE,MAAM,CAAC;KACzB,CAAC,CAAC;AACL,CAAC;AAED,MAAM,UAAU,kBAAkB,CAChC,IAA2C;IAK3C,OAAO,CACL,IAAI,EAAE,SAAS,KAAK,IAAI;QACxB,IAAI,EAAE,SAAS,KAAK,SAAS;QAC7B,IAAI,CAAC,YAAY,KAAK,IAAI;QAC1B,IAAI,CAAC,YAAY,KAAK,SAAS,CAChC,CAAC;AACJ,CAAC;AAED,SAAS,8BAA8B,CACrC,IAAwB,EACxB,SAAiB;IAEjB,IAAI,kBAAkB,CAAC,IAAI,CAAC,EAAE,CAAC;QAC7B,OAAO,IAAI,CAAC,SAAS,CAAC;IACxB,CAAC;IAED,MAAM,IAAI,WAAW,CAAC,oCAAoC,EAAE;QAC1D,IAAI,EAAE,0CAA0C;QAChD,OAAO,EAAE,YAAY,CAAC;YACpB,oBAAoB,CAAC,IAAI,CAAC,IAAI,CAAC;YAC/B,MAAM,CAAC,WAAW,EAAE,SAAS,CAAC;YAC9B,MAAM,CAAC,MAAM,EAAE,qCAAqC,CAAC;SACtD,CAAC;KACH,CAAC,CAAC;AACL,CAAC"}

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

@@ -0,0 +1,15 @@
+import { type EmbeddingRuntimeConfig } from "../config.js";
+import { type EmbeddingModel, type EmbeddingModelInfo } from "../models/index.js";
+import type { CreateZvecGrepOptions, ZvecGrep, ZvecGrepContextOptions, ZvecGrepContextResult } from "./types.js";
+export type EmbeddingModelIdentity = Pick<EmbeddingModelInfo, "provider" | "name">;
+export declare function createZvecGrep(options?: CreateZvecGrepOptions): Promise<ZvecGrep>;
+export type WorkspaceReadSession = {
+    readonly root: string;
+    context(options: ZvecGrepContextOptions): Promise<ZvecGrepContextResult>;
+    close(): Promise<void>;
+};
+export declare function openWorkspaceReadSession(startRoot: string, embeddingModel?: EmbeddingModel): WorkspaceReadSession;
+export declare function createEmbeddingModelForIdentity(identity: EmbeddingModelIdentity, options?: CreateZvecGrepOptions, workspaceRuntime?: EmbeddingRuntimeConfig): EmbeddingModel;
+export declare function embeddingModelPoolKeyForIdentity(identity: EmbeddingModelIdentity, options?: CreateZvecGrepOptions, workspaceRuntime?: EmbeddingRuntimeConfig): string;
+/** Resolve index-stage batch concurrency; query model creation never reads it. */
+export declare function resolveIndexEmbeddingConcurrency(identity: EmbeddingModelIdentity, requested?: number): number | undefined;