@angri450/zvec-grep 0.2.2
This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
- package/LICENSE +201 -0
- package/README.md +319 -0
- package/README_CN.md +297 -0
- package/dist/authorization/index.d.ts +7 -0
- package/dist/authorization/index.js +7 -0
- package/dist/authorization/index.js.map +1 -0
- package/dist/authorization/manager.d.ts +8 -0
- package/dist/authorization/manager.js +19 -0
- package/dist/authorization/manager.js.map +1 -0
- package/dist/authorization/operation.d.ts +7 -0
- package/dist/authorization/operation.js +50 -0
- package/dist/authorization/operation.js.map +1 -0
- package/dist/authorization/planner.d.ts +21 -0
- package/dist/authorization/planner.js +97 -0
- package/dist/authorization/planner.js.map +1 -0
- package/dist/authorization/prompt.d.ts +12 -0
- package/dist/authorization/prompt.js +63 -0
- package/dist/authorization/prompt.js.map +1 -0
- package/dist/authorization/store.d.ts +20 -0
- package/dist/authorization/store.js +251 -0
- package/dist/authorization/store.js.map +1 -0
- package/dist/authorization/target.d.ts +15 -0
- package/dist/authorization/target.js +49 -0
- package/dist/authorization/target.js.map +1 -0
- package/dist/authorization/types.d.ts +61 -0
- package/dist/authorization/types.js +2 -0
- package/dist/authorization/types.js.map +1 -0
- package/dist/cli/args.d.ts +6 -0
- package/dist/cli/args.js +1255 -0
- package/dist/cli/args.js.map +1 -0
- package/dist/cli/auth.d.ts +21 -0
- package/dist/cli/auth.js +209 -0
- package/dist/cli/auth.js.map +1 -0
- package/dist/cli/commands.d.ts +4 -0
- package/dist/cli/commands.js +801 -0
- package/dist/cli/commands.js.map +1 -0
- package/dist/cli/errors.d.ts +9 -0
- package/dist/cli/errors.js +131 -0
- package/dist/cli/errors.js.map +1 -0
- package/dist/cli/format/context.d.ts +9 -0
- package/dist/cli/format/context.js +786 -0
- package/dist/cli/format/context.js.map +1 -0
- package/dist/cli/format/debug.d.ts +4 -0
- package/dist/cli/format/debug.js +60 -0
- package/dist/cli/format/debug.js.map +1 -0
- package/dist/cli/format/highlight.d.ts +3 -0
- package/dist/cli/format/highlight.js +106 -0
- package/dist/cli/format/highlight.js.map +1 -0
- package/dist/cli/format/progress.d.ts +13 -0
- package/dist/cli/format/progress.js +290 -0
- package/dist/cli/format/progress.js.map +1 -0
- package/dist/cli/format/range.d.ts +3 -0
- package/dist/cli/format/range.js +24 -0
- package/dist/cli/format/range.js.map +1 -0
- package/dist/cli/format/status.d.ts +83 -0
- package/dist/cli/format/status.js +530 -0
- package/dist/cli/format/status.js.map +1 -0
- package/dist/cli/help.d.ts +1 -0
- package/dist/cli/help.js +546 -0
- package/dist/cli/help.js.map +1 -0
- package/dist/cli/index.d.ts +2 -0
- package/dist/cli/index.js +40 -0
- package/dist/cli/index.js.map +1 -0
- package/dist/cli/install.d.ts +4 -0
- package/dist/cli/install.js +1735 -0
- package/dist/cli/install.js.map +1 -0
- package/dist/cli/managed-rg.d.ts +10 -0
- package/dist/cli/managed-rg.js +337 -0
- package/dist/cli/managed-rg.js.map +1 -0
- package/dist/cli/server-search.d.ts +3 -0
- package/dist/cli/server-search.js +12 -0
- package/dist/cli/server-search.js.map +1 -0
- package/dist/cli/types.d.ts +87 -0
- package/dist/cli/types.js +10 -0
- package/dist/cli/types.js.map +1 -0
- package/dist/cli/version.d.ts +1 -0
- package/dist/cli/version.js +13 -0
- package/dist/cli/version.js.map +1 -0
- package/dist/client/daemon-client.d.ts +31 -0
- package/dist/client/daemon-client.js +203 -0
- package/dist/client/daemon-client.js.map +1 -0
- package/dist/client/mode-router.d.ts +9 -0
- package/dist/client/mode-router.js +28 -0
- package/dist/client/mode-router.js.map +1 -0
- package/dist/client/search-policy.d.ts +11 -0
- package/dist/client/search-policy.js +15 -0
- package/dist/client/search-policy.js.map +1 -0
- package/dist/daemon/backend.d.ts +78 -0
- package/dist/daemon/backend.js +1118 -0
- package/dist/daemon/backend.js.map +1 -0
- package/dist/daemon/change-set.d.ts +30 -0
- package/dist/daemon/change-set.js +163 -0
- package/dist/daemon/change-set.js.map +1 -0
- package/dist/daemon/config.d.ts +27 -0
- package/dist/daemon/config.js +107 -0
- package/dist/daemon/config.js.map +1 -0
- package/dist/daemon/errors.d.ts +5 -0
- package/dist/daemon/errors.js +11 -0
- package/dist/daemon/errors.js.map +1 -0
- package/dist/daemon/http-server.d.ts +30 -0
- package/dist/daemon/http-server.js +307 -0
- package/dist/daemon/http-server.js.map +1 -0
- package/dist/daemon/index-coordinator.d.ts +22 -0
- package/dist/daemon/index-coordinator.js +55 -0
- package/dist/daemon/index-coordinator.js.map +1 -0
- package/dist/daemon/job-scheduler.d.ts +85 -0
- package/dist/daemon/job-scheduler.js +492 -0
- package/dist/daemon/job-scheduler.js.map +1 -0
- package/dist/daemon/logger.d.ts +10 -0
- package/dist/daemon/logger.js +101 -0
- package/dist/daemon/logger.js.map +1 -0
- package/dist/daemon/model-pool.d.ts +48 -0
- package/dist/daemon/model-pool.js +190 -0
- package/dist/daemon/model-pool.js.map +1 -0
- package/dist/daemon/root-lease.d.ts +14 -0
- package/dist/daemon/root-lease.js +197 -0
- package/dist/daemon/root-lease.js.map +1 -0
- package/dist/daemon/root-runtime.d.ts +80 -0
- package/dist/daemon/root-runtime.js +340 -0
- package/dist/daemon/root-runtime.js.map +1 -0
- package/dist/daemon/runtime-manager.d.ts +47 -0
- package/dist/daemon/runtime-manager.js +252 -0
- package/dist/daemon/runtime-manager.js.map +1 -0
- package/dist/daemon/runtime.d.ts +12 -0
- package/dist/daemon/runtime.js +105 -0
- package/dist/daemon/runtime.js.map +1 -0
- package/dist/daemon/server-controller.d.ts +38 -0
- package/dist/daemon/server-controller.js +327 -0
- package/dist/daemon/server-controller.js.map +1 -0
- package/dist/daemon/watch-manager.d.ts +62 -0
- package/dist/daemon/watch-manager.js +415 -0
- package/dist/daemon/watch-manager.js.map +1 -0
- package/dist/daemon/workspace-read-session-cache.d.ts +31 -0
- package/dist/daemon/workspace-read-session-cache.js +115 -0
- package/dist/daemon/workspace-read-session-cache.js.map +1 -0
- package/dist/engine/code-formats.d.ts +3 -0
- package/dist/engine/code-formats.js +14 -0
- package/dist/engine/code-formats.js.map +1 -0
- package/dist/engine/config.d.ts +57 -0
- package/dist/engine/config.js +351 -0
- package/dist/engine/config.js.map +1 -0
- package/dist/engine/errors.d.ts +20 -0
- package/dist/engine/errors.js +51 -0
- package/dist/engine/errors.js.map +1 -0
- package/dist/engine/extraction/code/adapter.d.ts +19 -0
- package/dist/engine/extraction/code/adapter.js +24 -0
- package/dist/engine/extraction/code/adapter.js.map +1 -0
- package/dist/engine/extraction/code/extractor.d.ts +13 -0
- package/dist/engine/extraction/code/extractor.js +696 -0
- package/dist/engine/extraction/code/extractor.js.map +1 -0
- package/dist/engine/extraction/code/families/c-family.d.ts +2 -0
- package/dist/engine/extraction/code/families/c-family.js +122 -0
- package/dist/engine/extraction/code/families/c-family.js.map +1 -0
- package/dist/engine/extraction/code/families/js-ts.d.ts +12 -0
- package/dist/engine/extraction/code/families/js-ts.js +118 -0
- package/dist/engine/extraction/code/families/js-ts.js.map +1 -0
- package/dist/engine/extraction/code/families/metadata.d.ts +8 -0
- package/dist/engine/extraction/code/families/metadata.js +86 -0
- package/dist/engine/extraction/code/families/metadata.js.map +1 -0
- package/dist/engine/extraction/code/families/name-field.d.ts +3 -0
- package/dist/engine/extraction/code/families/name-field.js +22 -0
- package/dist/engine/extraction/code/families/name-field.js.map +1 -0
- package/dist/engine/extraction/code/languages/c.d.ts +1 -0
- package/dist/engine/extraction/code/languages/c.js +12 -0
- package/dist/engine/extraction/code/languages/c.js.map +1 -0
- package/dist/engine/extraction/code/languages/cpp.d.ts +1 -0
- package/dist/engine/extraction/code/languages/cpp.js +18 -0
- package/dist/engine/extraction/code/languages/cpp.js.map +1 -0
- package/dist/engine/extraction/code/languages/go.d.ts +2 -0
- package/dist/engine/extraction/code/languages/go.js +70 -0
- package/dist/engine/extraction/code/languages/go.js.map +1 -0
- package/dist/engine/extraction/code/languages/java.d.ts +1 -0
- package/dist/engine/extraction/code/languages/java.js +17 -0
- package/dist/engine/extraction/code/languages/java.js.map +1 -0
- package/dist/engine/extraction/code/languages/javascript.d.ts +2 -0
- package/dist/engine/extraction/code/languages/javascript.js +23 -0
- package/dist/engine/extraction/code/languages/javascript.js.map +1 -0
- package/dist/engine/extraction/code/languages/python.d.ts +2 -0
- package/dist/engine/extraction/code/languages/python.js +52 -0
- package/dist/engine/extraction/code/languages/python.js.map +1 -0
- package/dist/engine/extraction/code/languages/rust.d.ts +2 -0
- package/dist/engine/extraction/code/languages/rust.js +25 -0
- package/dist/engine/extraction/code/languages/rust.js.map +1 -0
- package/dist/engine/extraction/code/languages/typescript.d.ts +2 -0
- package/dist/engine/extraction/code/languages/typescript.js +37 -0
- package/dist/engine/extraction/code/languages/typescript.js.map +1 -0
- package/dist/engine/extraction/code/tree-sitter/grammar.d.ts +4 -0
- package/dist/engine/extraction/code/tree-sitter/grammar.js +49 -0
- package/dist/engine/extraction/code/tree-sitter/grammar.js.map +1 -0
- package/dist/engine/extraction/code/tree-sitter/nodes.d.ts +3 -0
- package/dist/engine/extraction/code/tree-sitter/nodes.js +27 -0
- package/dist/engine/extraction/code/tree-sitter/nodes.js.map +1 -0
- package/dist/engine/extraction/code/tree-sitter/parser.d.ts +2 -0
- package/dist/engine/extraction/code/tree-sitter/parser.js +31 -0
- package/dist/engine/extraction/code/tree-sitter/parser.js.map +1 -0
- package/dist/engine/extraction/ids.d.ts +1 -0
- package/dist/engine/extraction/ids.js +5 -0
- package/dist/engine/extraction/ids.js.map +1 -0
- package/dist/engine/extraction/image/extractor.d.ts +5 -0
- package/dist/engine/extraction/image/extractor.js +35 -0
- package/dist/engine/extraction/image/extractor.js.map +1 -0
- package/dist/engine/extraction/index.d.ts +4 -0
- package/dist/engine/extraction/index.js +3 -0
- package/dist/engine/extraction/index.js.map +1 -0
- package/dist/engine/extraction/markdown/extractor.d.ts +7 -0
- package/dist/engine/extraction/markdown/extractor.js +362 -0
- package/dist/engine/extraction/markdown/extractor.js.map +1 -0
- package/dist/engine/extraction/runtime.d.ts +9 -0
- package/dist/engine/extraction/runtime.js +37 -0
- package/dist/engine/extraction/runtime.js.map +1 -0
- package/dist/engine/extraction/source.d.ts +18 -0
- package/dist/engine/extraction/source.js +22 -0
- package/dist/engine/extraction/source.js.map +1 -0
- package/dist/engine/extraction/text/extractor.d.ts +7 -0
- package/dist/engine/extraction/text/extractor.js +168 -0
- package/dist/engine/extraction/text/extractor.js.map +1 -0
- package/dist/engine/extraction/types.d.ts +4 -0
- package/dist/engine/extraction/types.js +2 -0
- package/dist/engine/extraction/types.js.map +1 -0
- package/dist/engine/extraction/vector-content.d.ts +5 -0
- package/dist/engine/extraction/vector-content.js +83 -0
- package/dist/engine/extraction/vector-content.js.map +1 -0
- package/dist/engine/file-size-policy.d.ts +6 -0
- package/dist/engine/file-size-policy.js +20 -0
- package/dist/engine/file-size-policy.js.map +1 -0
- package/dist/engine/file-type.d.ts +15 -0
- package/dist/engine/file-type.js +152 -0
- package/dist/engine/file-type.js.map +1 -0
- package/dist/engine/index-status.d.ts +9 -0
- package/dist/engine/index-status.js +38 -0
- package/dist/engine/index-status.js.map +1 -0
- package/dist/engine/manifest.d.ts +13 -0
- package/dist/engine/manifest.js +124 -0
- package/dist/engine/manifest.js.map +1 -0
- package/dist/engine/models/artifact-cache-lock.d.ts +16 -0
- package/dist/engine/models/artifact-cache-lock.js +228 -0
- package/dist/engine/models/artifact-cache-lock.js.map +1 -0
- package/dist/engine/models/artifact-downloader.d.ts +77 -0
- package/dist/engine/models/artifact-downloader.js +766 -0
- package/dist/engine/models/artifact-downloader.js.map +1 -0
- package/dist/engine/models/backends/llama-cpp.d.ts +100 -0
- package/dist/engine/models/backends/llama-cpp.js +567 -0
- package/dist/engine/models/backends/llama-cpp.js.map +1 -0
- package/dist/engine/models/backends/model2vec-runtime.d.ts +63 -0
- package/dist/engine/models/backends/model2vec-runtime.js +112 -0
- package/dist/engine/models/backends/model2vec-runtime.js.map +1 -0
- package/dist/engine/models/backends/model2vec-tokenizer.d.ts +2 -0
- package/dist/engine/models/backends/model2vec-tokenizer.js +42 -0
- package/dist/engine/models/backends/model2vec-tokenizer.js.map +1 -0
- package/dist/engine/models/backends/model2vec-worker-pool.d.ts +25 -0
- package/dist/engine/models/backends/model2vec-worker-pool.js +264 -0
- package/dist/engine/models/backends/model2vec-worker-pool.js.map +1 -0
- package/dist/engine/models/backends/model2vec-worker.d.ts +1 -0
- package/dist/engine/models/backends/model2vec-worker.js +41 -0
- package/dist/engine/models/backends/model2vec-worker.js.map +1 -0
- package/dist/engine/models/backends/model2vec.d.ts +38 -0
- package/dist/engine/models/backends/model2vec.js +344 -0
- package/dist/engine/models/backends/model2vec.js.map +1 -0
- package/dist/engine/models/backends/qwen.d.ts +44 -0
- package/dist/engine/models/backends/qwen.js +411 -0
- package/dist/engine/models/backends/qwen.js.map +1 -0
- package/dist/engine/models/backends/transformers-js.d.ts +90 -0
- package/dist/engine/models/backends/transformers-js.js +411 -0
- package/dist/engine/models/backends/transformers-js.js.map +1 -0
- package/dist/engine/models/catalog.d.ts +490 -0
- package/dist/engine/models/catalog.js +522 -0
- package/dist/engine/models/catalog.js.map +1 -0
- package/dist/engine/models/download-progress.d.ts +16 -0
- package/dist/engine/models/download-progress.js +47 -0
- package/dist/engine/models/download-progress.js.map +1 -0
- package/dist/engine/models/embeddings.d.ts +73 -0
- package/dist/engine/models/embeddings.js +125 -0
- package/dist/engine/models/embeddings.js.map +1 -0
- package/dist/engine/models/factory.d.ts +2 -0
- package/dist/engine/models/factory.js +51 -0
- package/dist/engine/models/factory.js.map +1 -0
- package/dist/engine/models/index.d.ts +5 -0
- package/dist/engine/models/index.js +6 -0
- package/dist/engine/models/index.js.map +1 -0
- package/dist/engine/models/local-embedding-parallelism.d.ts +15 -0
- package/dist/engine/models/local-embedding-parallelism.js +63 -0
- package/dist/engine/models/local-embedding-parallelism.js.map +1 -0
- package/dist/engine/models/local-embedding-queue.d.ts +12 -0
- package/dist/engine/models/local-embedding-queue.js +65 -0
- package/dist/engine/models/local-embedding-queue.js.map +1 -0
- package/dist/engine/models/ranking.d.ts +19 -0
- package/dist/engine/models/ranking.js +2 -0
- package/dist/engine/models/ranking.js.map +1 -0
- package/dist/engine/models/resolution.d.ts +8 -0
- package/dist/engine/models/resolution.js +22 -0
- package/dist/engine/models/resolution.js.map +1 -0
- package/dist/engine/pipeline/indexing/index.d.ts +14 -0
- package/dist/engine/pipeline/indexing/index.js +1219 -0
- package/dist/engine/pipeline/indexing/index.js.map +1 -0
- package/dist/engine/pipeline/indexing/input-budget.d.ts +2 -0
- package/dist/engine/pipeline/indexing/input-budget.js +51 -0
- package/dist/engine/pipeline/indexing/input-budget.js.map +1 -0
- package/dist/engine/pipeline/indexing/root-paths.d.ts +7 -0
- package/dist/engine/pipeline/indexing/root-paths.js +148 -0
- package/dist/engine/pipeline/indexing/root-paths.js.map +1 -0
- package/dist/engine/pipeline/indexing/scanner/index.d.ts +14 -0
- package/dist/engine/pipeline/indexing/scanner/index.js +776 -0
- package/dist/engine/pipeline/indexing/scanner/index.js.map +1 -0
- package/dist/engine/pipeline/search/index.d.ts +12 -0
- package/dist/engine/pipeline/search/index.js +811 -0
- package/dist/engine/pipeline/search/index.js.map +1 -0
- package/dist/engine/service/index.d.ts +3 -0
- package/dist/engine/service/index.js +2 -0
- package/dist/engine/service/index.js.map +1 -0
- package/dist/engine/service/lexical.d.ts +28 -0
- package/dist/engine/service/lexical.js +446 -0
- package/dist/engine/service/lexical.js.map +1 -0
- package/dist/engine/service/root.d.ts +15 -0
- package/dist/engine/service/root.js +57 -0
- package/dist/engine/service/root.js.map +1 -0
- package/dist/engine/service/structure-enrichment.d.ts +8 -0
- package/dist/engine/service/structure-enrichment.js +178 -0
- package/dist/engine/service/structure-enrichment.js.map +1 -0
- package/dist/engine/service/types.d.ts +212 -0
- package/dist/engine/service/types.js +2 -0
- package/dist/engine/service/types.js.map +1 -0
- package/dist/engine/service/workspace-index.d.ts +26 -0
- package/dist/engine/service/workspace-index.js +157 -0
- package/dist/engine/service/workspace-index.js.map +1 -0
- package/dist/engine/service/zvec-grep.d.ts +15 -0
- package/dist/engine/service/zvec-grep.js +1520 -0
- package/dist/engine/service/zvec-grep.js.map +1 -0
- package/dist/engine/storage/index.d.ts +53 -0
- package/dist/engine/storage/index.js +3 -0
- package/dist/engine/storage/index.js.map +1 -0
- package/dist/engine/storage/layout.d.ts +10 -0
- package/dist/engine/storage/layout.js +29 -0
- package/dist/engine/storage/layout.js.map +1 -0
- package/dist/engine/storage/zvec.d.ts +4 -0
- package/dist/engine/storage/zvec.js +976 -0
- package/dist/engine/storage/zvec.js.map +1 -0
- package/dist/engine/types.d.ts +303 -0
- package/dist/engine/types.js +14 -0
- package/dist/engine/types.js.map +1 -0
- package/dist/engine/utils/atomic-file.d.ts +3 -0
- package/dist/engine/utils/atomic-file.js +39 -0
- package/dist/engine/utils/atomic-file.js.map +1 -0
- package/dist/engine/utils/daemon-lease.d.ts +17 -0
- package/dist/engine/utils/daemon-lease.js +175 -0
- package/dist/engine/utils/daemon-lease.js.map +1 -0
- package/dist/engine/utils/file-selection.d.ts +10 -0
- package/dist/engine/utils/file-selection.js +157 -0
- package/dist/engine/utils/file-selection.js.map +1 -0
- package/dist/engine/utils/glob.d.ts +9 -0
- package/dist/engine/utils/glob.js +208 -0
- package/dist/engine/utils/glob.js.map +1 -0
- package/dist/engine/utils/hash.d.ts +2 -0
- package/dist/engine/utils/hash.js +8 -0
- package/dist/engine/utils/hash.js.map +1 -0
- package/dist/engine/utils/json.d.ts +8 -0
- package/dist/engine/utils/json.js +83 -0
- package/dist/engine/utils/json.js.map +1 -0
- package/dist/engine/utils/lock.d.ts +19 -0
- package/dist/engine/utils/lock.js +254 -0
- package/dist/engine/utils/lock.js.map +1 -0
- package/dist/engine/utils/path.d.ts +4 -0
- package/dist/engine/utils/path.js +18 -0
- package/dist/engine/utils/path.js.map +1 -0
- package/dist/engine/utils/timing.d.ts +19 -0
- package/dist/engine/utils/timing.js +87 -0
- package/dist/engine/utils/timing.js.map +1 -0
- package/dist/index-progress.d.ts +10 -0
- package/dist/index-progress.js +159 -0
- package/dist/index-progress.js.map +1 -0
- package/dist/index.d.ts +6 -0
- package/dist/index.js +4 -0
- package/dist/index.js.map +1 -0
- package/dist/mcp/http-transport.d.ts +27 -0
- package/dist/mcp/http-transport.js +182 -0
- package/dist/mcp/http-transport.js.map +1 -0
- package/dist/mcp/input-normalization.d.ts +38 -0
- package/dist/mcp/input-normalization.js +104 -0
- package/dist/mcp/input-normalization.js.map +1 -0
- package/dist/mcp/progress-heartbeat.d.ts +17 -0
- package/dist/mcp/progress-heartbeat.js +46 -0
- package/dist/mcp/progress-heartbeat.js.map +1 -0
- package/dist/mcp/request-metadata.d.ts +2 -0
- package/dist/mcp/request-metadata.js +11 -0
- package/dist/mcp/request-metadata.js.map +1 -0
- package/dist/mcp/request-state.d.ts +40 -0
- package/dist/mcp/request-state.js +210 -0
- package/dist/mcp/request-state.js.map +1 -0
- package/dist/mcp/result-format.d.ts +13 -0
- package/dist/mcp/result-format.js +75 -0
- package/dist/mcp/result-format.js.map +1 -0
- package/dist/mcp/schemas.d.ts +668 -0
- package/dist/mcp/schemas.js +512 -0
- package/dist/mcp/schemas.js.map +1 -0
- package/dist/mcp/stdio-bridge.d.ts +15 -0
- package/dist/mcp/stdio-bridge.js +190 -0
- package/dist/mcp/stdio-bridge.js.map +1 -0
- package/dist/mcp/tools.d.ts +153 -0
- package/dist/mcp/tools.js +488 -0
- package/dist/mcp/tools.js.map +1 -0
- package/dist/mcp/toolset.d.ts +5 -0
- package/dist/mcp/toolset.js +12 -0
- package/dist/mcp/toolset.js.map +1 -0
- package/dist/observability/trace-context.d.ts +11 -0
- package/dist/observability/trace-context.js +138 -0
- package/dist/observability/trace-context.js.map +1 -0
- package/dist/prompts/zvec-grep-guidance.d.ts +2 -0
- package/dist/prompts/zvec-grep-guidance.js +9 -0
- package/dist/prompts/zvec-grep-guidance.js.map +1 -0
- package/docs/01-agents.md +217 -0
- package/docs/02-cli.md +259 -0
- package/docs/03-mcp.md +185 -0
- package/docs/04-pipeline.md +234 -0
- package/docs/05-architecture.md +86 -0
- package/docs/06-server.md +279 -0
- package/docs/07-embedding.md +227 -0
- package/docs/08-roadmap.md +85 -0
- package/docs/README.md +53 -0
- package/package.json +87 -0
|
@@ -0,0 +1,13 @@
|
|
|
1
|
+
import { readFileSync } from "node:fs";
|
|
2
|
+
export function readPackageVersion() {
|
|
3
|
+
try {
|
|
4
|
+
const packageJson = JSON.parse(readFileSync(new URL("../../package.json", import.meta.url), "utf8"));
|
|
5
|
+
return typeof packageJson.version === "string"
|
|
6
|
+
? packageJson.version
|
|
7
|
+
: "0.0.0";
|
|
8
|
+
}
|
|
9
|
+
catch {
|
|
10
|
+
return "0.0.0";
|
|
11
|
+
}
|
|
12
|
+
}
|
|
13
|
+
//# sourceMappingURL=version.js.map
|
|
@@ -0,0 +1 @@
|
|
|
1
|
+
{"version":3,"file":"version.js","sourceRoot":"","sources":["../../src/cli/version.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,YAAY,EAAE,MAAM,SAAS,CAAC;AAEvC,MAAM,UAAU,kBAAkB;IAChC,IAAI,CAAC;QACH,MAAM,WAAW,GAAG,IAAI,CAAC,KAAK,CAC5B,YAAY,CAAC,IAAI,GAAG,CAAC,oBAAoB,EAAE,MAAM,CAAC,IAAI,CAAC,GAAG,CAAC,EAAE,MAAM,CAAC,CAC5C,CAAC;QAE3B,OAAO,OAAO,WAAW,CAAC,OAAO,KAAK,QAAQ;YAC5C,CAAC,CAAC,WAAW,CAAC,OAAO;YACrB,CAAC,CAAC,OAAO,CAAC;IACd,CAAC;IAAC,MAAM,CAAC;QACP,OAAO,OAAO,CAAC;IACjB,CAAC;AACH,CAAC"}
|
|
@@ -0,0 +1,31 @@
|
|
|
1
|
+
import type { Progress } from "@modelcontextprotocol/client";
|
|
2
|
+
type DaemonToolCallOptions = {
|
|
3
|
+
onProgress?: (progress: Progress) => void;
|
|
4
|
+
embeddingEnvironment?: string;
|
|
5
|
+
toolContract?: {
|
|
6
|
+
inputProperties?: readonly string[];
|
|
7
|
+
outputProperties?: readonly string[];
|
|
8
|
+
errorMessage: string;
|
|
9
|
+
};
|
|
10
|
+
};
|
|
11
|
+
export declare class DaemonClient {
|
|
12
|
+
private readonly options;
|
|
13
|
+
constructor(options: {
|
|
14
|
+
serverUrl: string;
|
|
15
|
+
home?: string;
|
|
16
|
+
tokenFile?: string;
|
|
17
|
+
allowRemote?: boolean;
|
|
18
|
+
});
|
|
19
|
+
callTool(name: string, args: Record<string, unknown>, callOptions?: DaemonToolCallOptions): Promise<Record<string, unknown>>;
|
|
20
|
+
callTextTool(name: string, args: Record<string, unknown>, callOptions?: DaemonToolCallOptions): Promise<string>;
|
|
21
|
+
private invokeTool;
|
|
22
|
+
}
|
|
23
|
+
export declare function toolSatisfiesContract(tool: {
|
|
24
|
+
inputSchema?: unknown;
|
|
25
|
+
outputSchema?: unknown;
|
|
26
|
+
} | null | undefined, contract: {
|
|
27
|
+
inputProperties?: readonly string[];
|
|
28
|
+
outputProperties?: readonly string[];
|
|
29
|
+
}): boolean;
|
|
30
|
+
export declare function daemonAdminServerUrl(serverUrl: string): URL;
|
|
31
|
+
export {};
|
|
@@ -0,0 +1,203 @@
|
|
|
1
|
+
import { Client, StreamableHTTPClientTransport, } from "@modelcontextprotocol/client";
|
|
2
|
+
import { createInterface } from "node:readline/promises";
|
|
3
|
+
import { resolveClientToken } from "../daemon/config.js";
|
|
4
|
+
import { LONG_RUNNING_MCP_TIMEOUT_MS, withProgressHeartbeat, } from "../mcp/progress-heartbeat.js";
|
|
5
|
+
import { EMBEDDING_ENVIRONMENT_META_KEY } from "../mcp/request-metadata.js";
|
|
6
|
+
export class DaemonClient {
|
|
7
|
+
options;
|
|
8
|
+
constructor(options) {
|
|
9
|
+
this.options = options;
|
|
10
|
+
}
|
|
11
|
+
async callTool(name, args, callOptions = {}) {
|
|
12
|
+
return (await this.invokeTool(name, args, callOptions, "structured"));
|
|
13
|
+
}
|
|
14
|
+
async callTextTool(name, args, callOptions = {}) {
|
|
15
|
+
return (await this.invokeTool(name, args, callOptions, "text"));
|
|
16
|
+
}
|
|
17
|
+
async invokeTool(name, args, callOptions, resultKind) {
|
|
18
|
+
const abortController = new AbortController();
|
|
19
|
+
let cancelledByCtrlC = false;
|
|
20
|
+
const onInterrupt = () => {
|
|
21
|
+
abortController.abort(new Error("Operation cancelled by user."));
|
|
22
|
+
};
|
|
23
|
+
const token = await resolveClientToken({
|
|
24
|
+
home: this.options.home,
|
|
25
|
+
tokenFile: this.options.tokenFile,
|
|
26
|
+
});
|
|
27
|
+
process.once("SIGINT", onInterrupt);
|
|
28
|
+
const client = new Client({ name: "zvec-grep-cli", version: "1.0.0" }, {
|
|
29
|
+
capabilities: { elicitation: { form: {} } },
|
|
30
|
+
versionNegotiation: { mode: { pin: "2026-07-28" } },
|
|
31
|
+
});
|
|
32
|
+
client.setRequestHandler("elicitation/create", async (request, ctx) => {
|
|
33
|
+
if (this.options.allowRemote) {
|
|
34
|
+
return {
|
|
35
|
+
action: "accept",
|
|
36
|
+
content: { decision: "allow_once" },
|
|
37
|
+
};
|
|
38
|
+
}
|
|
39
|
+
if (!process.stdin.isTTY || !process.stdout.isTTY) {
|
|
40
|
+
return { action: "decline" };
|
|
41
|
+
}
|
|
42
|
+
console.error(request.params.message);
|
|
43
|
+
console.error("");
|
|
44
|
+
console.error("1. Allow once");
|
|
45
|
+
console.error("2. Allow for this workspace");
|
|
46
|
+
const requested = request.params.mode === "form"
|
|
47
|
+
? JSON.stringify(request.params.requestedSchema)
|
|
48
|
+
: "";
|
|
49
|
+
const localDecision = requested.includes("use_local_search")
|
|
50
|
+
? { value: "use_local_search", label: "Use FTS only" }
|
|
51
|
+
: undefined;
|
|
52
|
+
if (localDecision)
|
|
53
|
+
console.error(`3. ${localDecision.label}`);
|
|
54
|
+
const cancelChoice = localDecision ? 4 : 3;
|
|
55
|
+
console.error(`${cancelChoice}. Cancel`);
|
|
56
|
+
const readline = createInterface({
|
|
57
|
+
input: process.stdin,
|
|
58
|
+
output: process.stderr,
|
|
59
|
+
});
|
|
60
|
+
try {
|
|
61
|
+
let answer;
|
|
62
|
+
try {
|
|
63
|
+
answer = await withProgressHeartbeat(ctx, async () => await readline.question(`Choose [1-${cancelChoice}]: `, {
|
|
64
|
+
signal: AbortSignal.any([
|
|
65
|
+
abortController.signal,
|
|
66
|
+
ctx.mcpReq.signal,
|
|
67
|
+
]),
|
|
68
|
+
}), { message: "Waiting for Remote Embedding authorization input." });
|
|
69
|
+
}
|
|
70
|
+
catch (error) {
|
|
71
|
+
if (isCtrlCError(error)) {
|
|
72
|
+
cancelledByCtrlC = true;
|
|
73
|
+
return { action: "cancel" };
|
|
74
|
+
}
|
|
75
|
+
throw error;
|
|
76
|
+
}
|
|
77
|
+
const decision = answer.trim();
|
|
78
|
+
if (decision === "1") {
|
|
79
|
+
return {
|
|
80
|
+
action: "accept",
|
|
81
|
+
content: { decision: "allow_once" },
|
|
82
|
+
};
|
|
83
|
+
}
|
|
84
|
+
if (decision === "2") {
|
|
85
|
+
return {
|
|
86
|
+
action: "accept",
|
|
87
|
+
content: { decision: "allow_workspace" },
|
|
88
|
+
};
|
|
89
|
+
}
|
|
90
|
+
if (decision === "3" && localDecision) {
|
|
91
|
+
return {
|
|
92
|
+
action: "accept",
|
|
93
|
+
content: { decision: localDecision.value },
|
|
94
|
+
};
|
|
95
|
+
}
|
|
96
|
+
return { action: "decline" };
|
|
97
|
+
}
|
|
98
|
+
finally {
|
|
99
|
+
readline.close();
|
|
100
|
+
}
|
|
101
|
+
});
|
|
102
|
+
const transport = new StreamableHTTPClientTransport(daemonAdminServerUrl(this.options.serverUrl), {
|
|
103
|
+
requestInit: {
|
|
104
|
+
headers: token ? { Authorization: `Bearer ${token}` } : {},
|
|
105
|
+
},
|
|
106
|
+
});
|
|
107
|
+
try {
|
|
108
|
+
await client.connect(transport);
|
|
109
|
+
if (callOptions.toolContract) {
|
|
110
|
+
const listed = await client.listTools();
|
|
111
|
+
const tool = listed.tools.find((candidate) => candidate.name === name);
|
|
112
|
+
if (!toolSatisfiesContract(tool, callOptions.toolContract)) {
|
|
113
|
+
throw new Error(callOptions.toolContract.errorMessage);
|
|
114
|
+
}
|
|
115
|
+
}
|
|
116
|
+
const result = await client.callTool({
|
|
117
|
+
name,
|
|
118
|
+
arguments: args,
|
|
119
|
+
...(callOptions.embeddingEnvironment
|
|
120
|
+
? {
|
|
121
|
+
_meta: {
|
|
122
|
+
[EMBEDDING_ENVIRONMENT_META_KEY]: callOptions.embeddingEnvironment,
|
|
123
|
+
},
|
|
124
|
+
}
|
|
125
|
+
: {}),
|
|
126
|
+
}, {
|
|
127
|
+
signal: abortController.signal,
|
|
128
|
+
timeout: LONG_RUNNING_MCP_TIMEOUT_MS,
|
|
129
|
+
onprogress: callOptions.onProgress ?? (() => undefined),
|
|
130
|
+
resetTimeoutOnProgress: true,
|
|
131
|
+
});
|
|
132
|
+
if (cancelledByCtrlC) {
|
|
133
|
+
throw new Error("Operation cancelled by user.");
|
|
134
|
+
}
|
|
135
|
+
if (result.isError) {
|
|
136
|
+
const text = toolResultText(result.content);
|
|
137
|
+
throw new Error(text ?? `${name} failed`);
|
|
138
|
+
}
|
|
139
|
+
if (resultKind === "text") {
|
|
140
|
+
const text = toolResultText(result.content);
|
|
141
|
+
if (text === undefined) {
|
|
142
|
+
throw new Error(`${name} returned no text content`);
|
|
143
|
+
}
|
|
144
|
+
return text;
|
|
145
|
+
}
|
|
146
|
+
return (result.structuredContent ?? {});
|
|
147
|
+
}
|
|
148
|
+
catch (error) {
|
|
149
|
+
if (abortController.signal.aborted || isCtrlCError(error)) {
|
|
150
|
+
throw new Error("Operation cancelled by user.", { cause: error });
|
|
151
|
+
}
|
|
152
|
+
throw error;
|
|
153
|
+
}
|
|
154
|
+
finally {
|
|
155
|
+
process.off("SIGINT", onInterrupt);
|
|
156
|
+
await client.close().catch(() => undefined);
|
|
157
|
+
}
|
|
158
|
+
}
|
|
159
|
+
}
|
|
160
|
+
export function toolSatisfiesContract(tool, contract) {
|
|
161
|
+
if (!tool)
|
|
162
|
+
return false;
|
|
163
|
+
return (hasSchemaProperties(tool.inputSchema, contract.inputProperties) &&
|
|
164
|
+
hasSchemaProperties(tool.outputSchema, contract.outputProperties));
|
|
165
|
+
}
|
|
166
|
+
function hasSchemaProperties(schema, required) {
|
|
167
|
+
if (!required || required.length === 0)
|
|
168
|
+
return true;
|
|
169
|
+
if (typeof schema !== "object" || schema === null)
|
|
170
|
+
return false;
|
|
171
|
+
const properties = schema.properties;
|
|
172
|
+
if (typeof properties !== "object" || properties === null)
|
|
173
|
+
return false;
|
|
174
|
+
return required.every((property) => property in properties);
|
|
175
|
+
}
|
|
176
|
+
export function daemonAdminServerUrl(serverUrl) {
|
|
177
|
+
const url = new URL(serverUrl);
|
|
178
|
+
const publicPath = url.pathname.replace(/\/+$/, "");
|
|
179
|
+
if (!publicPath.endsWith("/mcp")) {
|
|
180
|
+
throw new Error(`zvec-grep server URL must end with /mcp (received ${url.pathname})`);
|
|
181
|
+
}
|
|
182
|
+
url.pathname = `${publicPath}/admin`;
|
|
183
|
+
return url;
|
|
184
|
+
}
|
|
185
|
+
function toolResultText(content) {
|
|
186
|
+
if (!Array.isArray(content)) {
|
|
187
|
+
return undefined;
|
|
188
|
+
}
|
|
189
|
+
for (const value of content) {
|
|
190
|
+
if (typeof value !== "object" || value === null) {
|
|
191
|
+
continue;
|
|
192
|
+
}
|
|
193
|
+
const item = value;
|
|
194
|
+
if (item.type === "text" && typeof item.text === "string") {
|
|
195
|
+
return item.text;
|
|
196
|
+
}
|
|
197
|
+
}
|
|
198
|
+
return undefined;
|
|
199
|
+
}
|
|
200
|
+
function isCtrlCError(error) {
|
|
201
|
+
return error instanceof Error && /aborted with Ctrl\+C/i.test(error.message);
|
|
202
|
+
}
|
|
203
|
+
//# sourceMappingURL=daemon-client.js.map
|
|
@@ -0,0 +1 @@
|
|
|
1
|
+
{"version":3,"file":"daemon-client.js","sourceRoot":"","sources":["../../src/client/daemon-client.ts"],"names":[],"mappings":"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"}
|
|
@@ -0,0 +1,9 @@
|
|
|
1
|
+
import { type ZvecGrepClientMode } from "../engine/config.js";
|
|
2
|
+
export declare function resolveClientMode(explicit?: ZvecGrepClientMode): ZvecGrepClientMode;
|
|
3
|
+
export declare function resolveServerUrl(): string;
|
|
4
|
+
export declare function routeByMode<T>(options: {
|
|
5
|
+
mode: ZvecGrepClientMode;
|
|
6
|
+
direct: () => Promise<T>;
|
|
7
|
+
server: () => Promise<T>;
|
|
8
|
+
serverAvailable: () => Promise<boolean>;
|
|
9
|
+
}): Promise<T>;
|
|
@@ -0,0 +1,28 @@
|
|
|
1
|
+
import { readGlobalConfig } from "../engine/config.js";
|
|
2
|
+
import { configuredServerUrl } from "../daemon/config.js";
|
|
3
|
+
export function resolveClientMode(explicit) {
|
|
4
|
+
const configured = explicit ??
|
|
5
|
+
parseMode(process.env.ZVEC_GREP_MODE) ??
|
|
6
|
+
readGlobalConfig().client?.mode;
|
|
7
|
+
return configured ?? "auto";
|
|
8
|
+
}
|
|
9
|
+
export function resolveServerUrl() {
|
|
10
|
+
return process.env.ZVEC_GREP_SERVER_URL ?? configuredServerUrl();
|
|
11
|
+
}
|
|
12
|
+
export async function routeByMode(options) {
|
|
13
|
+
if (options.mode === "direct")
|
|
14
|
+
return options.direct();
|
|
15
|
+
if (options.mode === "server")
|
|
16
|
+
return options.server();
|
|
17
|
+
return (await options.serverAvailable())
|
|
18
|
+
? options.server()
|
|
19
|
+
: options.direct();
|
|
20
|
+
}
|
|
21
|
+
function parseMode(value) {
|
|
22
|
+
if (!value)
|
|
23
|
+
return undefined;
|
|
24
|
+
if (value === "direct" || value === "server" || value === "auto")
|
|
25
|
+
return value;
|
|
26
|
+
throw new Error("ZVEC_GREP_MODE must be direct, server, or auto");
|
|
27
|
+
}
|
|
28
|
+
//# sourceMappingURL=mode-router.js.map
|
|
@@ -0,0 +1 @@
|
|
|
1
|
+
{"version":3,"file":"mode-router.js","sourceRoot":"","sources":["../../src/client/mode-router.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,gBAAgB,EAA2B,MAAM,qBAAqB,CAAC;AAChF,OAAO,EAAE,mBAAmB,EAAE,MAAM,qBAAqB,CAAC;AAE1D,MAAM,UAAU,iBAAiB,CAC/B,QAA6B;IAE7B,MAAM,UAAU,GACd,QAAQ;QACR,SAAS,CAAC,OAAO,CAAC,GAAG,CAAC,cAAc,CAAC;QACrC,gBAAgB,EAAE,CAAC,MAAM,EAAE,IAAI,CAAC;IAClC,OAAO,UAAU,IAAI,MAAM,CAAC;AAC9B,CAAC;AAED,MAAM,UAAU,gBAAgB;IAC9B,OAAO,OAAO,CAAC,GAAG,CAAC,oBAAoB,IAAI,mBAAmB,EAAE,CAAC;AACnE,CAAC;AAED,MAAM,CAAC,KAAK,UAAU,WAAW,CAAI,OAKpC;IACC,IAAI,OAAO,CAAC,IAAI,KAAK,QAAQ;QAAE,OAAO,OAAO,CAAC,MAAM,EAAE,CAAC;IACvD,IAAI,OAAO,CAAC,IAAI,KAAK,QAAQ;QAAE,OAAO,OAAO,CAAC,MAAM,EAAE,CAAC;IACvD,OAAO,CAAC,MAAM,OAAO,CAAC,eAAe,EAAE,CAAC;QACtC,CAAC,CAAC,OAAO,CAAC,MAAM,EAAE;QAClB,CAAC,CAAC,OAAO,CAAC,MAAM,EAAE,CAAC;AACvB,CAAC;AAED,SAAS,SAAS,CAAC,KAAyB;IAC1C,IAAI,CAAC,KAAK;QAAE,OAAO,SAAS,CAAC;IAC7B,IAAI,KAAK,KAAK,QAAQ,IAAI,KAAK,KAAK,QAAQ,IAAI,KAAK,KAAK,MAAM;QAC9D,OAAO,KAAK,CAAC;IACf,MAAM,IAAI,KAAK,CAAC,gDAAgD,CAAC,CAAC;AACpE,CAAC"}
|
|
@@ -0,0 +1,11 @@
|
|
|
1
|
+
import type { CliOptions } from "../cli/types.js";
|
|
2
|
+
export type ServerSearchPolicy = {
|
|
3
|
+
freshness: "eventual" | "wait_for_fresh";
|
|
4
|
+
autoUpdate: boolean;
|
|
5
|
+
};
|
|
6
|
+
export type DirectSearchPolicy = {
|
|
7
|
+
freshness: "eventual" | "wait_for_fresh";
|
|
8
|
+
autoUpdate: boolean;
|
|
9
|
+
};
|
|
10
|
+
export declare function resolveServerSearchPolicy(options: Pick<CliOptions, "refresh">): ServerSearchPolicy;
|
|
11
|
+
export declare function resolveDirectSearchPolicy(options: Pick<CliOptions, "refresh">): DirectSearchPolicy;
|
|
@@ -0,0 +1,15 @@
|
|
|
1
|
+
export function resolveServerSearchPolicy(options) {
|
|
2
|
+
const refresh = options.refresh ?? "background";
|
|
3
|
+
return {
|
|
4
|
+
freshness: refresh === "wait" ? "wait_for_fresh" : "eventual",
|
|
5
|
+
autoUpdate: refresh !== "off",
|
|
6
|
+
};
|
|
7
|
+
}
|
|
8
|
+
export function resolveDirectSearchPolicy(options) {
|
|
9
|
+
const wait = options.refresh === "wait";
|
|
10
|
+
return {
|
|
11
|
+
freshness: wait ? "wait_for_fresh" : "eventual",
|
|
12
|
+
autoUpdate: wait,
|
|
13
|
+
};
|
|
14
|
+
}
|
|
15
|
+
//# sourceMappingURL=search-policy.js.map
|
|
@@ -0,0 +1 @@
|
|
|
1
|
+
{"version":3,"file":"search-policy.js","sourceRoot":"","sources":["../../src/client/search-policy.ts"],"names":[],"mappings":"AAYA,MAAM,UAAU,yBAAyB,CACvC,OAAoC;IAEpC,MAAM,OAAO,GAAG,OAAO,CAAC,OAAO,IAAI,YAAY,CAAC;IAChD,OAAO;QACL,SAAS,EAAE,OAAO,KAAK,MAAM,CAAC,CAAC,CAAC,gBAAgB,CAAC,CAAC,CAAC,UAAU;QAC7D,UAAU,EAAE,OAAO,KAAK,KAAK;KAC9B,CAAC;AACJ,CAAC;AAED,MAAM,UAAU,yBAAyB,CACvC,OAAoC;IAEpC,MAAM,IAAI,GAAG,OAAO,CAAC,OAAO,KAAK,MAAM,CAAC;IACxC,OAAO;QACL,SAAS,EAAE,IAAI,CAAC,CAAC,CAAC,gBAAgB,CAAC,CAAC,CAAC,UAAU;QAC/C,UAAU,EAAE,IAAI;KACjB,CAAC;AACJ,CAAC"}
|
|
@@ -0,0 +1,78 @@
|
|
|
1
|
+
import { createZvecGrep } from "../engine/service/index.js";
|
|
2
|
+
import type { CreateZvecGrepOptions } from "../engine/service/types.js";
|
|
3
|
+
import type { IndexProgress } from "../engine/types.js";
|
|
4
|
+
import { type NormalizedSearchInput } from "../mcp/input-normalization.js";
|
|
5
|
+
import type { ZvecGrepDaemonBackend, ZvecGrepIndexDropResult, ZvecGrepIndexResult, ZvecGrepIndexStatusResult, ZvecGrepRgResult, ZvecGrepSearchResult, ZvecGrepServerStatusResult } from "../mcp/tools.js";
|
|
6
|
+
import type { ZvecGrepIndexRequest, ZvecGrepIndexDropInput, ZvecGrepIndexStatusInput, ZvecGrepRgInput } from "../mcp/schemas.js";
|
|
7
|
+
import { JobScheduler, type JobSchedulerOptions } from "./job-scheduler.js";
|
|
8
|
+
import { EmbeddingModelPool, type EmbeddingModelPoolOptions } from "./model-pool.js";
|
|
9
|
+
import { inspectRoot, RuntimeManager } from "./runtime-manager.js";
|
|
10
|
+
import { WatchManager, type WatchManagerOptions } from "./watch-manager.js";
|
|
11
|
+
import { type DaemonLogger } from "./logger.js";
|
|
12
|
+
import { RemoteEmbeddingAuthorizationStore, type RemoteEmbeddingAuthorizationPlan, type RemoteEmbeddingAuthorizationScope, type RemoteEmbeddingOperationPermit } from "../authorization/index.js";
|
|
13
|
+
export type DaemonBackendOptions = {
|
|
14
|
+
version: string;
|
|
15
|
+
serviceOptions?: CreateZvecGrepOptions;
|
|
16
|
+
modelPoolOptions?: EmbeddingModelPoolOptions;
|
|
17
|
+
schedulerOptions?: JobSchedulerOptions;
|
|
18
|
+
readSessionIdleTtlMs?: number;
|
|
19
|
+
runtimeIdleTtlMs?: number;
|
|
20
|
+
createService?: typeof createZvecGrep;
|
|
21
|
+
watchManagerFactory?: (options: WatchManagerOptions) => WatchManager;
|
|
22
|
+
logger?: DaemonLogger;
|
|
23
|
+
authorizationStore?: RemoteEmbeddingAuthorizationStore;
|
|
24
|
+
inspectRoot?: typeof inspectRoot;
|
|
25
|
+
};
|
|
26
|
+
export declare class DaemonBackend implements ZvecGrepDaemonBackend {
|
|
27
|
+
private readonly options;
|
|
28
|
+
readonly modelPool: EmbeddingModelPool;
|
|
29
|
+
readonly runtimeManager: RuntimeManager;
|
|
30
|
+
readonly scheduler: JobScheduler;
|
|
31
|
+
private readonly startedAt;
|
|
32
|
+
private readonly statusCache;
|
|
33
|
+
private readonly lastScanDiagnostics;
|
|
34
|
+
private readonly workspaceRuntimeCache;
|
|
35
|
+
private readonly watchers;
|
|
36
|
+
private readonly indexCoordinators;
|
|
37
|
+
private readonly droppingRoots;
|
|
38
|
+
private readonly authorizationManager;
|
|
39
|
+
private shuttingDown;
|
|
40
|
+
private closePromise?;
|
|
41
|
+
constructor(options: DaemonBackendOptions);
|
|
42
|
+
planIndexAuthorization(input: ZvecGrepIndexRequest): Promise<RemoteEmbeddingAuthorizationPlan | undefined>;
|
|
43
|
+
planSearchAuthorization(input: NormalizedSearchInput): Promise<RemoteEmbeddingAuthorizationPlan | undefined>;
|
|
44
|
+
existingRemoteEmbeddingPermit(plan: RemoteEmbeddingAuthorizationPlan): Promise<RemoteEmbeddingOperationPermit | undefined>;
|
|
45
|
+
grantRemoteEmbedding(plan: RemoteEmbeddingAuthorizationPlan, scope: RemoteEmbeddingAuthorizationScope): Promise<RemoteEmbeddingOperationPermit>;
|
|
46
|
+
index(input: ZvecGrepIndexRequest, options?: {
|
|
47
|
+
authorization?: RemoteEmbeddingOperationPermit;
|
|
48
|
+
onProgress?: (progress: IndexProgress) => void;
|
|
49
|
+
}): Promise<ZvecGrepIndexResult>;
|
|
50
|
+
dropIndex(input: ZvecGrepIndexDropInput): Promise<ZvecGrepIndexDropResult>;
|
|
51
|
+
search(input: NormalizedSearchInput, options?: {
|
|
52
|
+
authorization?: RemoteEmbeddingOperationPermit;
|
|
53
|
+
}): Promise<ZvecGrepSearchResult>;
|
|
54
|
+
private currentIndexCompletion;
|
|
55
|
+
indexStatus(input: ZvecGrepIndexStatusInput): Promise<ZvecGrepIndexStatusResult>;
|
|
56
|
+
serverStatus(): Promise<ZvecGrepServerStatusResult>;
|
|
57
|
+
rg(input: ZvecGrepRgInput): Promise<ZvecGrepRgResult>;
|
|
58
|
+
close(): Promise<void>;
|
|
59
|
+
private runIndex;
|
|
60
|
+
private runIndexOperation;
|
|
61
|
+
private submitIndex;
|
|
62
|
+
private ensureWatcher;
|
|
63
|
+
private settleKnownChanges;
|
|
64
|
+
private automaticIndexAuthorization;
|
|
65
|
+
private waitForFresh;
|
|
66
|
+
private loadEmbeddingModelInfo;
|
|
67
|
+
private probeCurrentFreshness;
|
|
68
|
+
private closeWatcher;
|
|
69
|
+
private assertRootNotDropping;
|
|
70
|
+
private indexModel;
|
|
71
|
+
private indexModelLoadRequest;
|
|
72
|
+
private searchModelLoadRequest;
|
|
73
|
+
private resolveModelRuntime;
|
|
74
|
+
private overrideActiveModelLoadRequest;
|
|
75
|
+
private readWorkspaceEmbeddingRuntime;
|
|
76
|
+
private inspectRootWithCache;
|
|
77
|
+
private inspectRoot;
|
|
78
|
+
}
|