@zvec/zvec-grep 0.2.2 → 0.3.0-rc.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/README.md +87 -252
- package/bin/zg.exe +3 -0
- package/install.cjs +510 -0
- package/package.json +22 -72
- package/platforms.json +92 -0
- package/plugins.cjs +183 -0
- package/README_CN.md +0 -239
- package/dist/authorization/index.d.ts +0 -7
- package/dist/authorization/index.js +0 -7
- package/dist/authorization/index.js.map +0 -1
- package/dist/authorization/manager.d.ts +0 -8
- package/dist/authorization/manager.js +0 -19
- package/dist/authorization/manager.js.map +0 -1
- package/dist/authorization/operation.d.ts +0 -7
- package/dist/authorization/operation.js +0 -50
- package/dist/authorization/operation.js.map +0 -1
- package/dist/authorization/planner.d.ts +0 -21
- package/dist/authorization/planner.js +0 -97
- package/dist/authorization/planner.js.map +0 -1
- package/dist/authorization/prompt.d.ts +0 -12
- package/dist/authorization/prompt.js +0 -63
- package/dist/authorization/prompt.js.map +0 -1
- package/dist/authorization/store.d.ts +0 -20
- package/dist/authorization/store.js +0 -251
- package/dist/authorization/store.js.map +0 -1
- package/dist/authorization/target.d.ts +0 -15
- package/dist/authorization/target.js +0 -49
- package/dist/authorization/target.js.map +0 -1
- package/dist/authorization/types.d.ts +0 -61
- package/dist/authorization/types.js +0 -2
- package/dist/authorization/types.js.map +0 -1
- package/dist/cli/args.d.ts +0 -5
- package/dist/cli/args.js +0 -1210
- package/dist/cli/args.js.map +0 -1
- package/dist/cli/auth.d.ts +0 -21
- package/dist/cli/auth.js +0 -209
- package/dist/cli/auth.js.map +0 -1
- package/dist/cli/commands.d.ts +0 -4
- package/dist/cli/commands.js +0 -742
- package/dist/cli/commands.js.map +0 -1
- package/dist/cli/errors.d.ts +0 -9
- package/dist/cli/errors.js +0 -131
- package/dist/cli/errors.js.map +0 -1
- package/dist/cli/format/context.d.ts +0 -9
- package/dist/cli/format/context.js +0 -786
- package/dist/cli/format/context.js.map +0 -1
- package/dist/cli/format/debug.d.ts +0 -4
- package/dist/cli/format/debug.js +0 -60
- package/dist/cli/format/debug.js.map +0 -1
- package/dist/cli/format/highlight.d.ts +0 -3
- package/dist/cli/format/highlight.js +0 -106
- package/dist/cli/format/highlight.js.map +0 -1
- package/dist/cli/format/progress.d.ts +0 -13
- package/dist/cli/format/progress.js +0 -290
- package/dist/cli/format/progress.js.map +0 -1
- package/dist/cli/format/range.d.ts +0 -3
- package/dist/cli/format/range.js +0 -24
- package/dist/cli/format/range.js.map +0 -1
- package/dist/cli/format/status.d.ts +0 -83
- package/dist/cli/format/status.js +0 -530
- package/dist/cli/format/status.js.map +0 -1
- package/dist/cli/help.d.ts +0 -1
- package/dist/cli/help.js +0 -528
- package/dist/cli/help.js.map +0 -1
- package/dist/cli/index.d.ts +0 -2
- package/dist/cli/index.js +0 -34
- package/dist/cli/index.js.map +0 -1
- package/dist/cli/install.d.ts +0 -4
- package/dist/cli/install.js +0 -1661
- package/dist/cli/install.js.map +0 -1
- package/dist/cli/managed-rg.d.ts +0 -10
- package/dist/cli/managed-rg.js +0 -337
- package/dist/cli/managed-rg.js.map +0 -1
- package/dist/cli/server-search.d.ts +0 -3
- package/dist/cli/server-search.js +0 -12
- package/dist/cli/server-search.js.map +0 -1
- package/dist/cli/types.d.ts +0 -87
- package/dist/cli/types.js +0 -10
- package/dist/cli/types.js.map +0 -1
- package/dist/cli/version.d.ts +0 -1
- package/dist/cli/version.js +0 -13
- package/dist/cli/version.js.map +0 -1
- package/dist/client/daemon-client.d.ts +0 -31
- package/dist/client/daemon-client.js +0 -203
- package/dist/client/daemon-client.js.map +0 -1
- package/dist/client/mode-router.d.ts +0 -9
- package/dist/client/mode-router.js +0 -28
- package/dist/client/mode-router.js.map +0 -1
- package/dist/client/search-policy.d.ts +0 -11
- package/dist/client/search-policy.js +0 -15
- package/dist/client/search-policy.js.map +0 -1
- package/dist/daemon/backend.d.ts +0 -78
- package/dist/daemon/backend.js +0 -1089
- package/dist/daemon/backend.js.map +0 -1
- package/dist/daemon/change-set.d.ts +0 -30
- package/dist/daemon/change-set.js +0 -163
- package/dist/daemon/change-set.js.map +0 -1
- package/dist/daemon/config.d.ts +0 -27
- package/dist/daemon/config.js +0 -107
- package/dist/daemon/config.js.map +0 -1
- package/dist/daemon/errors.d.ts +0 -5
- package/dist/daemon/errors.js +0 -11
- package/dist/daemon/errors.js.map +0 -1
- package/dist/daemon/http-server.d.ts +0 -30
- package/dist/daemon/http-server.js +0 -288
- package/dist/daemon/http-server.js.map +0 -1
- package/dist/daemon/index-coordinator.d.ts +0 -22
- package/dist/daemon/index-coordinator.js +0 -55
- package/dist/daemon/index-coordinator.js.map +0 -1
- package/dist/daemon/job-scheduler.d.ts +0 -73
- package/dist/daemon/job-scheduler.js +0 -434
- package/dist/daemon/job-scheduler.js.map +0 -1
- package/dist/daemon/logger.d.ts +0 -9
- package/dist/daemon/logger.js +0 -53
- package/dist/daemon/logger.js.map +0 -1
- package/dist/daemon/model-pool.d.ts +0 -45
- package/dist/daemon/model-pool.js +0 -187
- package/dist/daemon/model-pool.js.map +0 -1
- package/dist/daemon/root-lease.d.ts +0 -14
- package/dist/daemon/root-lease.js +0 -197
- package/dist/daemon/root-lease.js.map +0 -1
- package/dist/daemon/root-runtime.d.ts +0 -80
- package/dist/daemon/root-runtime.js +0 -340
- package/dist/daemon/root-runtime.js.map +0 -1
- package/dist/daemon/runtime-manager.d.ts +0 -47
- package/dist/daemon/runtime-manager.js +0 -252
- package/dist/daemon/runtime-manager.js.map +0 -1
- package/dist/daemon/runtime.d.ts +0 -12
- package/dist/daemon/runtime.js +0 -104
- package/dist/daemon/runtime.js.map +0 -1
- package/dist/daemon/server-controller.d.ts +0 -38
- package/dist/daemon/server-controller.js +0 -327
- package/dist/daemon/server-controller.js.map +0 -1
- package/dist/daemon/watch-manager.d.ts +0 -55
- package/dist/daemon/watch-manager.js +0 -347
- package/dist/daemon/watch-manager.js.map +0 -1
- package/dist/daemon/workspace-read-session-cache.d.ts +0 -31
- package/dist/daemon/workspace-read-session-cache.js +0 -115
- package/dist/daemon/workspace-read-session-cache.js.map +0 -1
- package/dist/engine/code-formats.d.ts +0 -3
- package/dist/engine/code-formats.js +0 -14
- package/dist/engine/code-formats.js.map +0 -1
- package/dist/engine/config.d.ts +0 -50
- package/dist/engine/config.js +0 -321
- package/dist/engine/config.js.map +0 -1
- package/dist/engine/errors.d.ts +0 -20
- package/dist/engine/errors.js +0 -51
- package/dist/engine/errors.js.map +0 -1
- package/dist/engine/extraction/code/adapter.d.ts +0 -19
- package/dist/engine/extraction/code/adapter.js +0 -24
- package/dist/engine/extraction/code/adapter.js.map +0 -1
- package/dist/engine/extraction/code/extractor.d.ts +0 -13
- package/dist/engine/extraction/code/extractor.js +0 -696
- package/dist/engine/extraction/code/extractor.js.map +0 -1
- package/dist/engine/extraction/code/families/c-family.d.ts +0 -2
- package/dist/engine/extraction/code/families/c-family.js +0 -122
- package/dist/engine/extraction/code/families/c-family.js.map +0 -1
- package/dist/engine/extraction/code/families/js-ts.d.ts +0 -12
- package/dist/engine/extraction/code/families/js-ts.js +0 -118
- package/dist/engine/extraction/code/families/js-ts.js.map +0 -1
- package/dist/engine/extraction/code/families/metadata.d.ts +0 -8
- package/dist/engine/extraction/code/families/metadata.js +0 -86
- package/dist/engine/extraction/code/families/metadata.js.map +0 -1
- package/dist/engine/extraction/code/families/name-field.d.ts +0 -3
- package/dist/engine/extraction/code/families/name-field.js +0 -22
- package/dist/engine/extraction/code/families/name-field.js.map +0 -1
- package/dist/engine/extraction/code/languages/c.d.ts +0 -1
- package/dist/engine/extraction/code/languages/c.js +0 -12
- package/dist/engine/extraction/code/languages/c.js.map +0 -1
- package/dist/engine/extraction/code/languages/cpp.d.ts +0 -1
- package/dist/engine/extraction/code/languages/cpp.js +0 -18
- package/dist/engine/extraction/code/languages/cpp.js.map +0 -1
- package/dist/engine/extraction/code/languages/go.d.ts +0 -2
- package/dist/engine/extraction/code/languages/go.js +0 -70
- package/dist/engine/extraction/code/languages/go.js.map +0 -1
- package/dist/engine/extraction/code/languages/java.d.ts +0 -1
- package/dist/engine/extraction/code/languages/java.js +0 -17
- package/dist/engine/extraction/code/languages/java.js.map +0 -1
- package/dist/engine/extraction/code/languages/javascript.d.ts +0 -2
- package/dist/engine/extraction/code/languages/javascript.js +0 -23
- package/dist/engine/extraction/code/languages/javascript.js.map +0 -1
- package/dist/engine/extraction/code/languages/python.d.ts +0 -2
- package/dist/engine/extraction/code/languages/python.js +0 -52
- package/dist/engine/extraction/code/languages/python.js.map +0 -1
- package/dist/engine/extraction/code/languages/rust.d.ts +0 -2
- package/dist/engine/extraction/code/languages/rust.js +0 -25
- package/dist/engine/extraction/code/languages/rust.js.map +0 -1
- package/dist/engine/extraction/code/languages/typescript.d.ts +0 -2
- package/dist/engine/extraction/code/languages/typescript.js +0 -37
- package/dist/engine/extraction/code/languages/typescript.js.map +0 -1
- package/dist/engine/extraction/code/tree-sitter/grammar.d.ts +0 -4
- package/dist/engine/extraction/code/tree-sitter/grammar.js +0 -49
- package/dist/engine/extraction/code/tree-sitter/grammar.js.map +0 -1
- package/dist/engine/extraction/code/tree-sitter/nodes.d.ts +0 -3
- package/dist/engine/extraction/code/tree-sitter/nodes.js +0 -27
- package/dist/engine/extraction/code/tree-sitter/nodes.js.map +0 -1
- package/dist/engine/extraction/code/tree-sitter/parser.d.ts +0 -2
- package/dist/engine/extraction/code/tree-sitter/parser.js +0 -31
- package/dist/engine/extraction/code/tree-sitter/parser.js.map +0 -1
- package/dist/engine/extraction/ids.d.ts +0 -1
- package/dist/engine/extraction/ids.js +0 -5
- package/dist/engine/extraction/ids.js.map +0 -1
- package/dist/engine/extraction/image/extractor.d.ts +0 -5
- package/dist/engine/extraction/image/extractor.js +0 -35
- package/dist/engine/extraction/image/extractor.js.map +0 -1
- package/dist/engine/extraction/index.d.ts +0 -4
- package/dist/engine/extraction/index.js +0 -3
- package/dist/engine/extraction/index.js.map +0 -1
- package/dist/engine/extraction/markdown/extractor.d.ts +0 -7
- package/dist/engine/extraction/markdown/extractor.js +0 -362
- package/dist/engine/extraction/markdown/extractor.js.map +0 -1
- package/dist/engine/extraction/runtime.d.ts +0 -9
- package/dist/engine/extraction/runtime.js +0 -37
- package/dist/engine/extraction/runtime.js.map +0 -1
- package/dist/engine/extraction/source.d.ts +0 -18
- package/dist/engine/extraction/source.js +0 -22
- package/dist/engine/extraction/source.js.map +0 -1
- package/dist/engine/extraction/text/extractor.d.ts +0 -7
- package/dist/engine/extraction/text/extractor.js +0 -168
- package/dist/engine/extraction/text/extractor.js.map +0 -1
- package/dist/engine/extraction/types.d.ts +0 -4
- package/dist/engine/extraction/types.js +0 -2
- package/dist/engine/extraction/types.js.map +0 -1
- package/dist/engine/extraction/vector-content.d.ts +0 -5
- package/dist/engine/extraction/vector-content.js +0 -83
- package/dist/engine/extraction/vector-content.js.map +0 -1
- package/dist/engine/file-size-policy.d.ts +0 -6
- package/dist/engine/file-size-policy.js +0 -20
- package/dist/engine/file-size-policy.js.map +0 -1
- package/dist/engine/file-type.d.ts +0 -15
- package/dist/engine/file-type.js +0 -152
- package/dist/engine/file-type.js.map +0 -1
- package/dist/engine/index-status.d.ts +0 -9
- package/dist/engine/index-status.js +0 -38
- package/dist/engine/index-status.js.map +0 -1
- package/dist/engine/manifest.d.ts +0 -13
- package/dist/engine/manifest.js +0 -124
- package/dist/engine/manifest.js.map +0 -1
- package/dist/engine/models/artifact-cache-lock.d.ts +0 -16
- package/dist/engine/models/artifact-cache-lock.js +0 -228
- package/dist/engine/models/artifact-cache-lock.js.map +0 -1
- package/dist/engine/models/artifact-downloader.d.ts +0 -77
- package/dist/engine/models/artifact-downloader.js +0 -766
- package/dist/engine/models/artifact-downloader.js.map +0 -1
- package/dist/engine/models/backends/llama-cpp.d.ts +0 -99
- package/dist/engine/models/backends/llama-cpp.js +0 -573
- package/dist/engine/models/backends/llama-cpp.js.map +0 -1
- package/dist/engine/models/backends/model2vec-runtime.d.ts +0 -63
- package/dist/engine/models/backends/model2vec-runtime.js +0 -112
- package/dist/engine/models/backends/model2vec-runtime.js.map +0 -1
- package/dist/engine/models/backends/model2vec-tokenizer.d.ts +0 -2
- package/dist/engine/models/backends/model2vec-tokenizer.js +0 -42
- package/dist/engine/models/backends/model2vec-tokenizer.js.map +0 -1
- package/dist/engine/models/backends/model2vec-worker-pool.d.ts +0 -25
- package/dist/engine/models/backends/model2vec-worker-pool.js +0 -264
- package/dist/engine/models/backends/model2vec-worker-pool.js.map +0 -1
- package/dist/engine/models/backends/model2vec-worker.d.ts +0 -1
- package/dist/engine/models/backends/model2vec-worker.js +0 -41
- package/dist/engine/models/backends/model2vec-worker.js.map +0 -1
- package/dist/engine/models/backends/model2vec.d.ts +0 -38
- package/dist/engine/models/backends/model2vec.js +0 -344
- package/dist/engine/models/backends/model2vec.js.map +0 -1
- package/dist/engine/models/backends/qwen.d.ts +0 -44
- package/dist/engine/models/backends/qwen.js +0 -411
- package/dist/engine/models/backends/qwen.js.map +0 -1
- package/dist/engine/models/backends/transformers-js.d.ts +0 -87
- package/dist/engine/models/backends/transformers-js.js +0 -360
- package/dist/engine/models/backends/transformers-js.js.map +0 -1
- package/dist/engine/models/catalog.d.ts +0 -490
- package/dist/engine/models/catalog.js +0 -522
- package/dist/engine/models/catalog.js.map +0 -1
- package/dist/engine/models/download-progress.d.ts +0 -16
- package/dist/engine/models/download-progress.js +0 -47
- package/dist/engine/models/download-progress.js.map +0 -1
- package/dist/engine/models/embeddings.d.ts +0 -69
- package/dist/engine/models/embeddings.js +0 -125
- package/dist/engine/models/embeddings.js.map +0 -1
- package/dist/engine/models/factory.d.ts +0 -2
- package/dist/engine/models/factory.js +0 -51
- package/dist/engine/models/factory.js.map +0 -1
- package/dist/engine/models/index.d.ts +0 -4
- package/dist/engine/models/index.js +0 -5
- package/dist/engine/models/index.js.map +0 -1
- package/dist/engine/models/ranking.d.ts +0 -19
- package/dist/engine/models/ranking.js +0 -2
- package/dist/engine/models/ranking.js.map +0 -1
- package/dist/engine/models/resolution.d.ts +0 -8
- package/dist/engine/models/resolution.js +0 -22
- package/dist/engine/models/resolution.js.map +0 -1
- package/dist/engine/pipeline/indexing/index.d.ts +0 -14
- package/dist/engine/pipeline/indexing/index.js +0 -1217
- package/dist/engine/pipeline/indexing/index.js.map +0 -1
- package/dist/engine/pipeline/indexing/input-budget.d.ts +0 -2
- package/dist/engine/pipeline/indexing/input-budget.js +0 -51
- package/dist/engine/pipeline/indexing/input-budget.js.map +0 -1
- package/dist/engine/pipeline/indexing/root-paths.d.ts +0 -7
- package/dist/engine/pipeline/indexing/root-paths.js +0 -148
- package/dist/engine/pipeline/indexing/root-paths.js.map +0 -1
- package/dist/engine/pipeline/indexing/scanner/index.d.ts +0 -14
- package/dist/engine/pipeline/indexing/scanner/index.js +0 -776
- package/dist/engine/pipeline/indexing/scanner/index.js.map +0 -1
- package/dist/engine/pipeline/search/index.d.ts +0 -12
- package/dist/engine/pipeline/search/index.js +0 -811
- package/dist/engine/pipeline/search/index.js.map +0 -1
- package/dist/engine/service/index.d.ts +0 -3
- package/dist/engine/service/index.js +0 -2
- package/dist/engine/service/index.js.map +0 -1
- package/dist/engine/service/lexical.d.ts +0 -28
- package/dist/engine/service/lexical.js +0 -446
- package/dist/engine/service/lexical.js.map +0 -1
- package/dist/engine/service/root.d.ts +0 -15
- package/dist/engine/service/root.js +0 -57
- package/dist/engine/service/root.js.map +0 -1
- package/dist/engine/service/structure-enrichment.d.ts +0 -8
- package/dist/engine/service/structure-enrichment.js +0 -178
- package/dist/engine/service/structure-enrichment.js.map +0 -1
- package/dist/engine/service/types.d.ts +0 -210
- package/dist/engine/service/types.js +0 -2
- package/dist/engine/service/types.js.map +0 -1
- package/dist/engine/service/workspace-index.d.ts +0 -26
- package/dist/engine/service/workspace-index.js +0 -157
- package/dist/engine/service/workspace-index.js.map +0 -1
- package/dist/engine/service/zvec-grep.d.ts +0 -13
- package/dist/engine/service/zvec-grep.js +0 -1393
- package/dist/engine/service/zvec-grep.js.map +0 -1
- package/dist/engine/storage/index.d.ts +0 -53
- package/dist/engine/storage/index.js +0 -3
- package/dist/engine/storage/index.js.map +0 -1
- package/dist/engine/storage/layout.d.ts +0 -10
- package/dist/engine/storage/layout.js +0 -29
- package/dist/engine/storage/layout.js.map +0 -1
- package/dist/engine/storage/zvec.d.ts +0 -4
- package/dist/engine/storage/zvec.js +0 -976
- package/dist/engine/storage/zvec.js.map +0 -1
- package/dist/engine/types.d.ts +0 -303
- package/dist/engine/types.js +0 -14
- package/dist/engine/types.js.map +0 -1
- package/dist/engine/utils/atomic-file.d.ts +0 -3
- package/dist/engine/utils/atomic-file.js +0 -39
- package/dist/engine/utils/atomic-file.js.map +0 -1
- package/dist/engine/utils/daemon-lease.d.ts +0 -17
- package/dist/engine/utils/daemon-lease.js +0 -175
- package/dist/engine/utils/daemon-lease.js.map +0 -1
- package/dist/engine/utils/file-selection.d.ts +0 -10
- package/dist/engine/utils/file-selection.js +0 -157
- package/dist/engine/utils/file-selection.js.map +0 -1
- package/dist/engine/utils/glob.d.ts +0 -9
- package/dist/engine/utils/glob.js +0 -208
- package/dist/engine/utils/glob.js.map +0 -1
- package/dist/engine/utils/hash.d.ts +0 -2
- package/dist/engine/utils/hash.js +0 -8
- package/dist/engine/utils/hash.js.map +0 -1
- package/dist/engine/utils/json.d.ts +0 -8
- package/dist/engine/utils/json.js +0 -83
- package/dist/engine/utils/json.js.map +0 -1
- package/dist/engine/utils/lock.d.ts +0 -19
- package/dist/engine/utils/lock.js +0 -254
- package/dist/engine/utils/lock.js.map +0 -1
- package/dist/engine/utils/path.d.ts +0 -4
- package/dist/engine/utils/path.js +0 -18
- package/dist/engine/utils/path.js.map +0 -1
- package/dist/engine/utils/timing.d.ts +0 -19
- package/dist/engine/utils/timing.js +0 -87
- package/dist/engine/utils/timing.js.map +0 -1
- package/dist/index-progress.d.ts +0 -10
- package/dist/index-progress.js +0 -159
- package/dist/index-progress.js.map +0 -1
- package/dist/index.d.ts +0 -6
- package/dist/index.js +0 -4
- package/dist/index.js.map +0 -1
- package/dist/mcp/http-transport.d.ts +0 -27
- package/dist/mcp/http-transport.js +0 -182
- package/dist/mcp/http-transport.js.map +0 -1
- package/dist/mcp/input-normalization.d.ts +0 -38
- package/dist/mcp/input-normalization.js +0 -104
- package/dist/mcp/input-normalization.js.map +0 -1
- package/dist/mcp/progress-heartbeat.d.ts +0 -17
- package/dist/mcp/progress-heartbeat.js +0 -46
- package/dist/mcp/progress-heartbeat.js.map +0 -1
- package/dist/mcp/request-metadata.d.ts +0 -2
- package/dist/mcp/request-metadata.js +0 -11
- package/dist/mcp/request-metadata.js.map +0 -1
- package/dist/mcp/request-state.d.ts +0 -40
- package/dist/mcp/request-state.js +0 -210
- package/dist/mcp/request-state.js.map +0 -1
- package/dist/mcp/result-format.d.ts +0 -13
- package/dist/mcp/result-format.js +0 -75
- package/dist/mcp/result-format.js.map +0 -1
- package/dist/mcp/schemas.d.ts +0 -668
- package/dist/mcp/schemas.js +0 -512
- package/dist/mcp/schemas.js.map +0 -1
- package/dist/mcp/stdio-bridge.d.ts +0 -15
- package/dist/mcp/stdio-bridge.js +0 -190
- package/dist/mcp/stdio-bridge.js.map +0 -1
- package/dist/mcp/tools.d.ts +0 -153
- package/dist/mcp/tools.js +0 -488
- package/dist/mcp/tools.js.map +0 -1
- package/dist/mcp/toolset.d.ts +0 -5
- package/dist/mcp/toolset.js +0 -12
- package/dist/mcp/toolset.js.map +0 -1
- package/dist/observability/trace-context.d.ts +0 -11
- package/dist/observability/trace-context.js +0 -138
- package/dist/observability/trace-context.js.map +0 -1
- package/dist/prompts/zvec-grep-guidance.d.ts +0 -2
- package/dist/prompts/zvec-grep-guidance.js +0 -9
- package/dist/prompts/zvec-grep-guidance.js.map +0 -1
- package/docs/01-agents.md +0 -209
- package/docs/02-cli.md +0 -247
- package/docs/03-mcp.md +0 -185
- package/docs/04-pipeline.md +0 -226
- package/docs/05-architecture.md +0 -86
- package/docs/06-server.md +0 -233
- package/docs/07-embedding.md +0 -209
- package/docs/08-roadmap.md +0 -85
- package/docs/README.md +0 -53
|
@@ -1,187 +0,0 @@
|
|
|
1
|
-
import { randomUUID } from "node:crypto";
|
|
2
|
-
import { createEmbeddingModelForIdentity, embeddingModelPoolKeyForIdentity, } from "../engine/service/zvec-grep.js";
|
|
3
|
-
export class EmbeddingModelPool {
|
|
4
|
-
entries = new Map();
|
|
5
|
-
idleTtlMs;
|
|
6
|
-
maxLoadedModels;
|
|
7
|
-
createModel;
|
|
8
|
-
keyForRequest;
|
|
9
|
-
closed = false;
|
|
10
|
-
closePromise;
|
|
11
|
-
logger;
|
|
12
|
-
constructor(options = {}) {
|
|
13
|
-
this.idleTtlMs = options.idleTtlMs ?? 15 * 60_000;
|
|
14
|
-
this.maxLoadedModels = options.maxLoadedModels ?? 1;
|
|
15
|
-
this.createModel =
|
|
16
|
-
options.createModel ??
|
|
17
|
-
((request) => createEmbeddingModelForIdentity(request.model, {
|
|
18
|
-
...options.serviceOptions,
|
|
19
|
-
...request.runtime,
|
|
20
|
-
}));
|
|
21
|
-
this.keyForRequest =
|
|
22
|
-
options.keyForRequest ??
|
|
23
|
-
((request) => embeddingModelPoolKeyForIdentity(request.model, {
|
|
24
|
-
...options.serviceOptions,
|
|
25
|
-
...request.runtime,
|
|
26
|
-
}));
|
|
27
|
-
this.logger = options.logger;
|
|
28
|
-
}
|
|
29
|
-
async acquire(request) {
|
|
30
|
-
if (this.closed) {
|
|
31
|
-
throw new Error("Embedding model pool is closed.");
|
|
32
|
-
}
|
|
33
|
-
const key = this.keyFor(request);
|
|
34
|
-
let entry = this.entries.get(key);
|
|
35
|
-
if (!entry) {
|
|
36
|
-
entry = {
|
|
37
|
-
key,
|
|
38
|
-
logIdentity: randomUUID(),
|
|
39
|
-
leases: 0,
|
|
40
|
-
lastUsedAt: Date.now(),
|
|
41
|
-
retired: false,
|
|
42
|
-
};
|
|
43
|
-
this.entries.set(key, entry);
|
|
44
|
-
}
|
|
45
|
-
if (entry.idleTimer) {
|
|
46
|
-
clearTimeout(entry.idleTimer);
|
|
47
|
-
entry.idleTimer = undefined;
|
|
48
|
-
}
|
|
49
|
-
if (!entry.model) {
|
|
50
|
-
if (!entry.loading) {
|
|
51
|
-
this.logger?.event("model.load", { model_id: entry.logIdentity });
|
|
52
|
-
entry.loading = Promise.resolve(this.createModel(request));
|
|
53
|
-
}
|
|
54
|
-
try {
|
|
55
|
-
entry.model = await entry.loading;
|
|
56
|
-
}
|
|
57
|
-
catch (error) {
|
|
58
|
-
this.entries.delete(key);
|
|
59
|
-
throw error;
|
|
60
|
-
}
|
|
61
|
-
finally {
|
|
62
|
-
entry.loading = undefined;
|
|
63
|
-
}
|
|
64
|
-
}
|
|
65
|
-
else {
|
|
66
|
-
this.logger?.event("model.cache_hit", { model_id: entry.logIdentity });
|
|
67
|
-
}
|
|
68
|
-
if (this.closed) {
|
|
69
|
-
entry.retired = true;
|
|
70
|
-
throw new Error("Embedding model pool is closed.");
|
|
71
|
-
}
|
|
72
|
-
entry.leases += 1;
|
|
73
|
-
entry.lastUsedAt = Date.now();
|
|
74
|
-
try {
|
|
75
|
-
await this.trimIdleEntries(key);
|
|
76
|
-
}
|
|
77
|
-
catch (error) {
|
|
78
|
-
this.release(entry);
|
|
79
|
-
throw error;
|
|
80
|
-
}
|
|
81
|
-
if (this.closed) {
|
|
82
|
-
this.release(entry);
|
|
83
|
-
throw new Error("Embedding model pool is closed.");
|
|
84
|
-
}
|
|
85
|
-
let released = false;
|
|
86
|
-
return {
|
|
87
|
-
model: entry.model,
|
|
88
|
-
key,
|
|
89
|
-
release: () => {
|
|
90
|
-
if (released) {
|
|
91
|
-
return;
|
|
92
|
-
}
|
|
93
|
-
released = true;
|
|
94
|
-
this.release(entry);
|
|
95
|
-
},
|
|
96
|
-
};
|
|
97
|
-
}
|
|
98
|
-
keyFor(request) {
|
|
99
|
-
return this.keyForRequest(request);
|
|
100
|
-
}
|
|
101
|
-
snapshot() {
|
|
102
|
-
let activeLeases = 0;
|
|
103
|
-
let loaded = 0;
|
|
104
|
-
for (const entry of this.entries.values()) {
|
|
105
|
-
activeLeases += entry.leases;
|
|
106
|
-
if (entry.model) {
|
|
107
|
-
loaded += 1;
|
|
108
|
-
}
|
|
109
|
-
}
|
|
110
|
-
return { loaded, activeLeases };
|
|
111
|
-
}
|
|
112
|
-
close() {
|
|
113
|
-
if (!this.closePromise) {
|
|
114
|
-
this.closed = true;
|
|
115
|
-
this.closePromise = this.closeEntries();
|
|
116
|
-
}
|
|
117
|
-
return this.closePromise;
|
|
118
|
-
}
|
|
119
|
-
async closeEntries() {
|
|
120
|
-
const loadings = [...this.entries.values()].flatMap((entry) => entry.loading ? [entry.loading] : []);
|
|
121
|
-
await Promise.allSettled(loadings);
|
|
122
|
-
const disposals = [];
|
|
123
|
-
for (const entry of this.entries.values()) {
|
|
124
|
-
if (entry.idleTimer) {
|
|
125
|
-
clearTimeout(entry.idleTimer);
|
|
126
|
-
}
|
|
127
|
-
entry.retired = true;
|
|
128
|
-
if (entry.leases === 0 && entry.model) {
|
|
129
|
-
disposals.push(entry.model.dispose());
|
|
130
|
-
}
|
|
131
|
-
}
|
|
132
|
-
await Promise.all(disposals);
|
|
133
|
-
for (const [key, entry] of this.entries) {
|
|
134
|
-
if (entry.leases === 0) {
|
|
135
|
-
this.entries.delete(key);
|
|
136
|
-
}
|
|
137
|
-
}
|
|
138
|
-
}
|
|
139
|
-
release(entry) {
|
|
140
|
-
entry.leases = Math.max(0, entry.leases - 1);
|
|
141
|
-
entry.lastUsedAt = Date.now();
|
|
142
|
-
if (entry.leases > 0) {
|
|
143
|
-
return;
|
|
144
|
-
}
|
|
145
|
-
if (entry.retired || this.closed || this.idleTtlMs === 0) {
|
|
146
|
-
void this.disposeEntry(entry);
|
|
147
|
-
return;
|
|
148
|
-
}
|
|
149
|
-
const usedAt = entry.lastUsedAt;
|
|
150
|
-
entry.idleTimer = setTimeout(() => {
|
|
151
|
-
if (entry.leases === 0 && entry.lastUsedAt === usedAt) {
|
|
152
|
-
void this.disposeEntry(entry);
|
|
153
|
-
}
|
|
154
|
-
}, this.idleTtlMs);
|
|
155
|
-
entry.idleTimer.unref?.();
|
|
156
|
-
}
|
|
157
|
-
async trimIdleEntries(exceptKey) {
|
|
158
|
-
const loaded = [...this.entries.values()].filter((entry) => entry.model);
|
|
159
|
-
if (loaded.length <= this.maxLoadedModels) {
|
|
160
|
-
return;
|
|
161
|
-
}
|
|
162
|
-
const candidates = loaded
|
|
163
|
-
.filter((entry) => entry.key !== exceptKey && entry.leases === 0)
|
|
164
|
-
.sort((left, right) => left.lastUsedAt - right.lastUsedAt);
|
|
165
|
-
while (this.snapshot().loaded > this.maxLoadedModels &&
|
|
166
|
-
candidates.length > 0) {
|
|
167
|
-
await this.disposeEntry(candidates.shift());
|
|
168
|
-
}
|
|
169
|
-
}
|
|
170
|
-
async disposeEntry(entry) {
|
|
171
|
-
if (entry.leases > 0 || !entry.model) {
|
|
172
|
-
return;
|
|
173
|
-
}
|
|
174
|
-
if (entry.idleTimer) {
|
|
175
|
-
clearTimeout(entry.idleTimer);
|
|
176
|
-
entry.idleTimer = undefined;
|
|
177
|
-
}
|
|
178
|
-
const model = entry.model;
|
|
179
|
-
entry.model = undefined;
|
|
180
|
-
this.entries.delete(entry.key);
|
|
181
|
-
await model.dispose();
|
|
182
|
-
this.logger?.event("model.evicted", {
|
|
183
|
-
model_id: entry.logIdentity,
|
|
184
|
-
});
|
|
185
|
-
}
|
|
186
|
-
}
|
|
187
|
-
//# sourceMappingURL=model-pool.js.map
|
|
@@ -1 +0,0 @@
|
|
|
1
|
-
{"version":3,"file":"model-pool.js","sourceRoot":"","sources":["../../src/daemon/model-pool.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,UAAU,EAAE,MAAM,aAAa,CAAC;AAEzC,OAAO,EACL,+BAA+B,EAC/B,gCAAgC,GAEjC,MAAM,gCAAgC,CAAC;AA2CxC,MAAM,OAAO,kBAAkB;IACZ,OAAO,GAAG,IAAI,GAAG,EAAsB,CAAC;IACxC,SAAS,CAAS;IAClB,eAAe,CAAS;IACxB,WAAW,CAEkB;IAC7B,aAAa,CAElB;IACJ,MAAM,GAAG,KAAK,CAAC;IACf,YAAY,CAAiB;IACpB,MAAM,CAAgB;IAEvC,YAAY,UAAqC,EAAE;QACjD,IAAI,CAAC,SAAS,GAAG,OAAO,CAAC,SAAS,IAAI,EAAE,GAAG,MAAM,CAAC;QAClD,IAAI,CAAC,eAAe,GAAG,OAAO,CAAC,eAAe,IAAI,CAAC,CAAC;QACpD,IAAI,CAAC,WAAW;YACd,OAAO,CAAC,WAAW;gBACnB,CAAC,CAAC,OAAO,EAAE,EAAE,CACX,+BAA+B,CAAC,OAAO,CAAC,KAAK,EAAE;oBAC7C,GAAG,OAAO,CAAC,cAAc;oBACzB,GAAG,OAAO,CAAC,OAAO;iBACnB,CAAC,CAAC,CAAC;QACR,IAAI,CAAC,aAAa;YAChB,OAAO,CAAC,aAAa;gBACrB,CAAC,CAAC,OAAO,EAAE,EAAE,CACX,gCAAgC,CAAC,OAAO,CAAC,KAAK,EAAE;oBAC9C,GAAG,OAAO,CAAC,cAAc;oBACzB,GAAG,OAAO,CAAC,OAAO;iBACnB,CAAC,CAAC,CAAC;QACR,IAAI,CAAC,MAAM,GAAG,OAAO,CAAC,MAAM,CAAC;IAC/B,CAAC;IAED,KAAK,CAAC,OAAO,CAAC,OAAkC;QAC9C,IAAI,IAAI,CAAC,MAAM,EAAE,CAAC;YAChB,MAAM,IAAI,KAAK,CAAC,iCAAiC,CAAC,CAAC;QACrD,CAAC;QAED,MAAM,GAAG,GAAG,IAAI,CAAC,MAAM,CAAC,OAAO,CAAC,CAAC;QACjC,IAAI,KAAK,GAAG,IAAI,CAAC,OAAO,CAAC,GAAG,CAAC,GAAG,CAAC,CAAC;QAClC,IAAI,CAAC,KAAK,EAAE,CAAC;YACX,KAAK,GAAG;gBACN,GAAG;gBACH,WAAW,EAAE,UAAU,EAAE;gBACzB,MAAM,EAAE,CAAC;gBACT,UAAU,EAAE,IAAI,CAAC,GAAG,EAAE;gBACtB,OAAO,EAAE,KAAK;aACf,CAAC;YACF,IAAI,CAAC,OAAO,CAAC,GAAG,CAAC,GAAG,EAAE,KAAK,CAAC,CAAC;QAC/B,CAAC;QAED,IAAI,KAAK,CAAC,SAAS,EAAE,CAAC;YACpB,YAAY,CAAC,KAAK,CAAC,SAAS,CAAC,CAAC;YAC9B,KAAK,CAAC,SAAS,GAAG,SAAS,CAAC;QAC9B,CAAC;QAED,IAAI,CAAC,KAAK,CAAC,KAAK,EAAE,CAAC;YACjB,IAAI,CAAC,KAAK,CAAC,OAAO,EAAE,CAAC;gBACnB,IAAI,CAAC,MAAM,EAAE,KAAK,CAAC,YAAY,EAAE,EAAE,QAAQ,EAAE,KAAK,CAAC,WAAW,EAAE,CAAC,CAAC;gBAClE,KAAK,CAAC,OAAO,GAAG,OAAO,CAAC,OAAO,CAAC,IAAI,CAAC,WAAW,CAAC,OAAO,CAAC,CAAC,CAAC;YAC7D,CAAC;YACD,IAAI,CAAC;gBACH,KAAK,CAAC,KAAK,GAAG,MAAM,KAAK,CAAC,OAAO,CAAC;YACpC,CAAC;YAAC,OAAO,KAAK,EAAE,CAAC;gBACf,IAAI,CAAC,OAAO,CAAC,MAAM,CAAC,GAAG,CAAC,CAAC;gBACzB,MAAM,KAAK,CAAC;YACd,CAAC;oBAAS,CAAC;gBACT,KAAK,CAAC,OAAO,GAAG,SAAS,CAAC;YAC5B,CAAC;QACH,CAAC;aAAM,CAAC;YACN,IAAI,CAAC,MAAM,EAAE,KAAK,CAAC,iBAAiB,EAAE,EAAE,QAAQ,EAAE,KAAK,CAAC,WAAW,EAAE,CAAC,CAAC;QACzE,CAAC;QAED,IAAI,IAAI,CAAC,MAAM,EAAE,CAAC;YAChB,KAAK,CAAC,OAAO,GAAG,IAAI,CAAC;YACrB,MAAM,IAAI,KAAK,CAAC,iCAAiC,CAAC,CAAC;QACrD,CAAC;QAED,KAAK,CAAC,MAAM,IAAI,CAAC,CAAC;QAClB,KAAK,CAAC,UAAU,GAAG,IAAI,CAAC,GAAG,EAAE,CAAC;QAC9B,IAAI,CAAC;YACH,MAAM,IAAI,CAAC,eAAe,CAAC,GAAG,CAAC,CAAC;QAClC,CAAC;QAAC,OAAO,KAAK,EAAE,CAAC;YACf,IAAI,CAAC,OAAO,CAAC,KAAK,CAAC,CAAC;YACpB,MAAM,KAAK,CAAC;QACd,CAAC;QACD,IAAI,IAAI,CAAC,MAAM,EAAE,CAAC;YAChB,IAAI,CAAC,OAAO,CAAC,KAAK,CAAC,CAAC;YACpB,MAAM,IAAI,KAAK,CAAC,iCAAiC,CAAC,CAAC;QACrD,CAAC;QACD,IAAI,QAAQ,GAAG,KAAK,CAAC;QACrB,OAAO;YACL,KAAK,EAAE,KAAK,CAAC,KAAK;YAClB,GAAG;YACH,OAAO,EAAE,GAAG,EAAE;gBACZ,IAAI,QAAQ,EAAE,CAAC;oBACb,OAAO;gBACT,CAAC;gBACD,QAAQ,GAAG,IAAI,CAAC;gBAChB,IAAI,CAAC,OAAO,CAAC,KAAM,CAAC,CAAC;YACvB,CAAC;SACF,CAAC;IACJ,CAAC;IAED,MAAM,CAAC,OAAkC;QACvC,OAAO,IAAI,CAAC,aAAa,CAAC,OAAO,CAAC,CAAC;IACrC,CAAC;IAED,QAAQ;QACN,IAAI,YAAY,GAAG,CAAC,CAAC;QACrB,IAAI,MAAM,GAAG,CAAC,CAAC;QACf,KAAK,MAAM,KAAK,IAAI,IAAI,CAAC,OAAO,CAAC,MAAM,EAAE,EAAE,CAAC;YAC1C,YAAY,IAAI,KAAK,CAAC,MAAM,CAAC;YAC7B,IAAI,KAAK,CAAC,KAAK,EAAE,CAAC;gBAChB,MAAM,IAAI,CAAC,CAAC;YACd,CAAC;QACH,CAAC;QACD,OAAO,EAAE,MAAM,EAAE,YAAY,EAAE,CAAC;IAClC,CAAC;IAED,KAAK;QACH,IAAI,CAAC,IAAI,CAAC,YAAY,EAAE,CAAC;YACvB,IAAI,CAAC,MAAM,GAAG,IAAI,CAAC;YACnB,IAAI,CAAC,YAAY,GAAG,IAAI,CAAC,YAAY,EAAE,CAAC;QAC1C,CAAC;QACD,OAAO,IAAI,CAAC,YAAY,CAAC;IAC3B,CAAC;IAEO,KAAK,CAAC,YAAY;QACxB,MAAM,QAAQ,GAAG,CAAC,GAAG,IAAI,CAAC,OAAO,CAAC,MAAM,EAAE,CAAC,CAAC,OAAO,CAAC,CAAC,KAAK,EAAE,EAAE,CAC5D,KAAK,CAAC,OAAO,CAAC,CAAC,CAAC,CAAC,KAAK,CAAC,OAAO,CAAC,CAAC,CAAC,CAAC,EAAE,CACrC,CAAC;QACF,MAAM,OAAO,CAAC,UAAU,CAAC,QAAQ,CAAC,CAAC;QACnC,MAAM,SAAS,GAAoB,EAAE,CAAC;QACtC,KAAK,MAAM,KAAK,IAAI,IAAI,CAAC,OAAO,CAAC,MAAM,EAAE,EAAE,CAAC;YAC1C,IAAI,KAAK,CAAC,SAAS,EAAE,CAAC;gBACpB,YAAY,CAAC,KAAK,CAAC,SAAS,CAAC,CAAC;YAChC,CAAC;YACD,KAAK,CAAC,OAAO,GAAG,IAAI,CAAC;YACrB,IAAI,KAAK,CAAC,MAAM,KAAK,CAAC,IAAI,KAAK,CAAC,KAAK,EAAE,CAAC;gBACtC,SAAS,CAAC,IAAI,CAAC,KAAK,CAAC,KAAK,CAAC,OAAO,EAAE,CAAC,CAAC;YACxC,CAAC;QACH,CAAC;QACD,MAAM,OAAO,CAAC,GAAG,CAAC,SAAS,CAAC,CAAC;QAC7B,KAAK,MAAM,CAAC,GAAG,EAAE,KAAK,CAAC,IAAI,IAAI,CAAC,OAAO,EAAE,CAAC;YACxC,IAAI,KAAK,CAAC,MAAM,KAAK,CAAC,EAAE,CAAC;gBACvB,IAAI,CAAC,OAAO,CAAC,MAAM,CAAC,GAAG,CAAC,CAAC;YAC3B,CAAC;QACH,CAAC;IACH,CAAC;IAEO,OAAO,CAAC,KAAiB;QAC/B,KAAK,CAAC,MAAM,GAAG,IAAI,CAAC,GAAG,CAAC,CAAC,EAAE,KAAK,CAAC,MAAM,GAAG,CAAC,CAAC,CAAC;QAC7C,KAAK,CAAC,UAAU,GAAG,IAAI,CAAC,GAAG,EAAE,CAAC;QAC9B,IAAI,KAAK,CAAC,MAAM,GAAG,CAAC,EAAE,CAAC;YACrB,OAAO;QACT,CAAC;QAED,IAAI,KAAK,CAAC,OAAO,IAAI,IAAI,CAAC,MAAM,IAAI,IAAI,CAAC,SAAS,KAAK,CAAC,EAAE,CAAC;YACzD,KAAK,IAAI,CAAC,YAAY,CAAC,KAAK,CAAC,CAAC;YAC9B,OAAO;QACT,CAAC;QAED,MAAM,MAAM,GAAG,KAAK,CAAC,UAAU,CAAC;QAChC,KAAK,CAAC,SAAS,GAAG,UAAU,CAAC,GAAG,EAAE;YAChC,IAAI,KAAK,CAAC,MAAM,KAAK,CAAC,IAAI,KAAK,CAAC,UAAU,KAAK,MAAM,EAAE,CAAC;gBACtD,KAAK,IAAI,CAAC,YAAY,CAAC,KAAK,CAAC,CAAC;YAChC,CAAC;QACH,CAAC,EAAE,IAAI,CAAC,SAAS,CAAC,CAAC;QACnB,KAAK,CAAC,SAAS,CAAC,KAAK,EAAE,EAAE,CAAC;IAC5B,CAAC;IAEO,KAAK,CAAC,eAAe,CAAC,SAAiB;QAC7C,MAAM,MAAM,GAAG,CAAC,GAAG,IAAI,CAAC,OAAO,CAAC,MAAM,EAAE,CAAC,CAAC,MAAM,CAAC,CAAC,KAAK,EAAE,EAAE,CAAC,KAAK,CAAC,KAAK,CAAC,CAAC;QACzE,IAAI,MAAM,CAAC,MAAM,IAAI,IAAI,CAAC,eAAe,EAAE,CAAC;YAC1C,OAAO;QACT,CAAC;QAED,MAAM,UAAU,GAAG,MAAM;aACtB,MAAM,CAAC,CAAC,KAAK,EAAE,EAAE,CAAC,KAAK,CAAC,GAAG,KAAK,SAAS,IAAI,KAAK,CAAC,MAAM,KAAK,CAAC,CAAC;aAChE,IAAI,CAAC,CAAC,IAAI,EAAE,KAAK,EAAE,EAAE,CAAC,IAAI,CAAC,UAAU,GAAG,KAAK,CAAC,UAAU,CAAC,CAAC;QAC7D,OACE,IAAI,CAAC,QAAQ,EAAE,CAAC,MAAM,GAAG,IAAI,CAAC,eAAe;YAC7C,UAAU,CAAC,MAAM,GAAG,CAAC,EACrB,CAAC;YACD,MAAM,IAAI,CAAC,YAAY,CAAC,UAAU,CAAC,KAAK,EAAG,CAAC,CAAC;QAC/C,CAAC;IACH,CAAC;IAEO,KAAK,CAAC,YAAY,CAAC,KAAiB;QAC1C,IAAI,KAAK,CAAC,MAAM,GAAG,CAAC,IAAI,CAAC,KAAK,CAAC,KAAK,EAAE,CAAC;YACrC,OAAO;QACT,CAAC;QACD,IAAI,KAAK,CAAC,SAAS,EAAE,CAAC;YACpB,YAAY,CAAC,KAAK,CAAC,SAAS,CAAC,CAAC;YAC9B,KAAK,CAAC,SAAS,GAAG,SAAS,CAAC;QAC9B,CAAC;QACD,MAAM,KAAK,GAAG,KAAK,CAAC,KAAK,CAAC;QAC1B,KAAK,CAAC,KAAK,GAAG,SAAS,CAAC;QACxB,IAAI,CAAC,OAAO,CAAC,MAAM,CAAC,KAAK,CAAC,GAAG,CAAC,CAAC;QAC/B,MAAM,KAAK,CAAC,OAAO,EAAE,CAAC;QACtB,IAAI,CAAC,MAAM,EAAE,KAAK,CAAC,eAAe,EAAE;YAClC,QAAQ,EAAE,KAAK,CAAC,WAAW;SAC5B,CAAC,CAAC;IACL,CAAC;CACF"}
|
|
@@ -1,14 +0,0 @@
|
|
|
1
|
-
export type RootLease = {
|
|
2
|
-
readonly root: string;
|
|
3
|
-
release(): Promise<void>;
|
|
4
|
-
};
|
|
5
|
-
export declare class RootLeaseManager {
|
|
6
|
-
readonly instanceToken: `${string}-${string}-${string}-${string}-${string}`;
|
|
7
|
-
private readonly leases;
|
|
8
|
-
acquire(root: string): Promise<RootLease>;
|
|
9
|
-
close(): Promise<void>;
|
|
10
|
-
private createLease;
|
|
11
|
-
private release;
|
|
12
|
-
private startHeartbeat;
|
|
13
|
-
private removeOwnedLease;
|
|
14
|
-
}
|
|
@@ -1,197 +0,0 @@
|
|
|
1
|
-
import { randomUUID } from "node:crypto";
|
|
2
|
-
import { mkdir, open, readFile, unlink } from "node:fs/promises";
|
|
3
|
-
import { hostname } from "node:os";
|
|
4
|
-
import { dirname } from "node:path";
|
|
5
|
-
import { daemonLeasePath, acquireDaemonLeaseGuard, daemonLeaseFileIsAbandoned, processIsAlive, } from "../engine/utils/daemon-lease.js";
|
|
6
|
-
import { replaceFileAtomically } from "../engine/utils/atomic-file.js";
|
|
7
|
-
import { DaemonError } from "./errors.js";
|
|
8
|
-
export class RootLeaseManager {
|
|
9
|
-
instanceToken = randomUUID();
|
|
10
|
-
leases = new Map();
|
|
11
|
-
async acquire(root) {
|
|
12
|
-
let managed = this.leases.get(root);
|
|
13
|
-
if (!managed) {
|
|
14
|
-
const record = await this.createLease(root);
|
|
15
|
-
managed = {
|
|
16
|
-
refs: 0,
|
|
17
|
-
record,
|
|
18
|
-
stopped: false,
|
|
19
|
-
};
|
|
20
|
-
managed.heartbeat = this.startHeartbeat(root, managed);
|
|
21
|
-
this.leases.set(root, managed);
|
|
22
|
-
}
|
|
23
|
-
managed.refs += 1;
|
|
24
|
-
let released = false;
|
|
25
|
-
return {
|
|
26
|
-
root,
|
|
27
|
-
release: async () => {
|
|
28
|
-
if (released) {
|
|
29
|
-
return;
|
|
30
|
-
}
|
|
31
|
-
released = true;
|
|
32
|
-
await this.release(root, managed);
|
|
33
|
-
},
|
|
34
|
-
};
|
|
35
|
-
}
|
|
36
|
-
async close() {
|
|
37
|
-
const leases = [...this.leases.entries()];
|
|
38
|
-
this.leases.clear();
|
|
39
|
-
await Promise.all(leases.map(async ([root, managed]) => {
|
|
40
|
-
managed.stopped = true;
|
|
41
|
-
if (managed.heartbeat)
|
|
42
|
-
clearInterval(managed.heartbeat);
|
|
43
|
-
await managed.heartbeatInFlight;
|
|
44
|
-
await this.removeOwnedLease(root, managed.record);
|
|
45
|
-
}));
|
|
46
|
-
}
|
|
47
|
-
async createLease(root) {
|
|
48
|
-
const path = daemonLeasePath(root);
|
|
49
|
-
await mkdir(dirname(path), { recursive: true });
|
|
50
|
-
const now = Date.now();
|
|
51
|
-
const record = {
|
|
52
|
-
pid: process.pid,
|
|
53
|
-
hostname: hostname(),
|
|
54
|
-
instanceToken: this.instanceToken,
|
|
55
|
-
createdAt: now,
|
|
56
|
-
updatedAt: now,
|
|
57
|
-
};
|
|
58
|
-
const guard = acquireDaemonLeaseGuard(root, this.instanceToken);
|
|
59
|
-
if (!guard) {
|
|
60
|
-
throw new DaemonError("INDEX_BUSY", "Another daemon is changing the root lease.", true);
|
|
61
|
-
}
|
|
62
|
-
try {
|
|
63
|
-
try {
|
|
64
|
-
const handle = await open(path, "wx", 0o600);
|
|
65
|
-
try {
|
|
66
|
-
await handle.writeFile(`${JSON.stringify(record)}\n`);
|
|
67
|
-
}
|
|
68
|
-
finally {
|
|
69
|
-
await handle.close();
|
|
70
|
-
}
|
|
71
|
-
return record;
|
|
72
|
-
}
|
|
73
|
-
catch (error) {
|
|
74
|
-
if (error.code !== "EEXIST") {
|
|
75
|
-
throw error;
|
|
76
|
-
}
|
|
77
|
-
const existing = await readLeaseFile(path);
|
|
78
|
-
if (existing?.pid === process.pid &&
|
|
79
|
-
existing.instanceToken === this.instanceToken) {
|
|
80
|
-
return existing;
|
|
81
|
-
}
|
|
82
|
-
if (existing &&
|
|
83
|
-
existing.hostname === hostname() &&
|
|
84
|
-
!processIsAlive(existing.pid)) {
|
|
85
|
-
await unlink(path).catch(() => undefined);
|
|
86
|
-
const handle = await open(path, "wx", 0o600);
|
|
87
|
-
try {
|
|
88
|
-
await handle.writeFile(`${JSON.stringify(record)}\n`);
|
|
89
|
-
}
|
|
90
|
-
finally {
|
|
91
|
-
await handle.close();
|
|
92
|
-
}
|
|
93
|
-
return record;
|
|
94
|
-
}
|
|
95
|
-
if (!existing && daemonLeaseFileIsAbandoned(root)) {
|
|
96
|
-
await unlink(path).catch(() => undefined);
|
|
97
|
-
const handle = await open(path, "wx", 0o600);
|
|
98
|
-
try {
|
|
99
|
-
await handle.writeFile(`${JSON.stringify(record)}\n`);
|
|
100
|
-
}
|
|
101
|
-
finally {
|
|
102
|
-
await handle.close();
|
|
103
|
-
}
|
|
104
|
-
return record;
|
|
105
|
-
}
|
|
106
|
-
throw new DaemonError("INDEX_BUSY", "Another daemon owns index writes for this root.", true);
|
|
107
|
-
}
|
|
108
|
-
}
|
|
109
|
-
finally {
|
|
110
|
-
guard.release();
|
|
111
|
-
}
|
|
112
|
-
}
|
|
113
|
-
async release(root, managed) {
|
|
114
|
-
managed.refs -= 1;
|
|
115
|
-
if (managed.refs > 0 || this.leases.get(root) !== managed) {
|
|
116
|
-
return;
|
|
117
|
-
}
|
|
118
|
-
this.leases.delete(root);
|
|
119
|
-
managed.stopped = true;
|
|
120
|
-
if (managed.heartbeat)
|
|
121
|
-
clearInterval(managed.heartbeat);
|
|
122
|
-
await managed.heartbeatInFlight;
|
|
123
|
-
await this.removeOwnedLease(root, managed.record);
|
|
124
|
-
}
|
|
125
|
-
startHeartbeat(root, managed) {
|
|
126
|
-
const timer = setInterval(() => {
|
|
127
|
-
const heartbeat = (async () => {
|
|
128
|
-
if (managed.stopped)
|
|
129
|
-
return;
|
|
130
|
-
const guard = acquireDaemonLeaseGuard(root, this.instanceToken);
|
|
131
|
-
if (!guard)
|
|
132
|
-
return;
|
|
133
|
-
try {
|
|
134
|
-
const path = daemonLeasePath(root);
|
|
135
|
-
const current = await readLeaseFile(path);
|
|
136
|
-
if (managed.stopped ||
|
|
137
|
-
current?.pid !== managed.record.pid ||
|
|
138
|
-
current.instanceToken !== managed.record.instanceToken)
|
|
139
|
-
return;
|
|
140
|
-
const updatedAt = Date.now();
|
|
141
|
-
await replaceFileAtomically(path, `${JSON.stringify({ ...managed.record, updatedAt })}\n`, { mode: 0o600 });
|
|
142
|
-
managed.record.updatedAt = updatedAt;
|
|
143
|
-
}
|
|
144
|
-
finally {
|
|
145
|
-
guard.release();
|
|
146
|
-
}
|
|
147
|
-
})().catch(() => undefined);
|
|
148
|
-
managed.heartbeatInFlight = heartbeat;
|
|
149
|
-
void heartbeat.finally(() => {
|
|
150
|
-
if (managed.heartbeatInFlight === heartbeat)
|
|
151
|
-
managed.heartbeatInFlight = undefined;
|
|
152
|
-
});
|
|
153
|
-
}, 5_000);
|
|
154
|
-
timer.unref?.();
|
|
155
|
-
return timer;
|
|
156
|
-
}
|
|
157
|
-
async removeOwnedLease(root, expected) {
|
|
158
|
-
let guard;
|
|
159
|
-
for (let attempt = 0; attempt < 10 && !guard; attempt++) {
|
|
160
|
-
guard = acquireDaemonLeaseGuard(root, this.instanceToken);
|
|
161
|
-
if (!guard) {
|
|
162
|
-
await new Promise((resolve) => setTimeout(resolve, 10));
|
|
163
|
-
}
|
|
164
|
-
}
|
|
165
|
-
if (!guard) {
|
|
166
|
-
throw new DaemonError("INDEX_BUSY", "Could not remove the owned daemon lease.", true);
|
|
167
|
-
}
|
|
168
|
-
const path = daemonLeasePath(root);
|
|
169
|
-
try {
|
|
170
|
-
const current = await readLeaseFile(path);
|
|
171
|
-
if (current?.pid === expected.pid &&
|
|
172
|
-
current.instanceToken === expected.instanceToken) {
|
|
173
|
-
await unlink(path).catch(() => undefined);
|
|
174
|
-
}
|
|
175
|
-
}
|
|
176
|
-
finally {
|
|
177
|
-
guard.release();
|
|
178
|
-
}
|
|
179
|
-
}
|
|
180
|
-
}
|
|
181
|
-
async function readLeaseFile(path) {
|
|
182
|
-
try {
|
|
183
|
-
const parsed = JSON.parse(await readFile(path, "utf8"));
|
|
184
|
-
if (typeof parsed.pid !== "number" ||
|
|
185
|
-
typeof parsed.hostname !== "string" ||
|
|
186
|
-
typeof parsed.instanceToken !== "string" ||
|
|
187
|
-
typeof parsed.createdAt !== "number" ||
|
|
188
|
-
typeof parsed.updatedAt !== "number") {
|
|
189
|
-
return undefined;
|
|
190
|
-
}
|
|
191
|
-
return parsed;
|
|
192
|
-
}
|
|
193
|
-
catch {
|
|
194
|
-
return undefined;
|
|
195
|
-
}
|
|
196
|
-
}
|
|
197
|
-
//# sourceMappingURL=root-lease.js.map
|
|
@@ -1 +0,0 @@
|
|
|
1
|
-
{"version":3,"file":"root-lease.js","sourceRoot":"","sources":["../../src/daemon/root-lease.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,UAAU,EAAE,MAAM,aAAa,CAAC;AACzC,OAAO,EAAE,KAAK,EAAE,IAAI,EAAE,QAAQ,EAAE,MAAM,EAAE,MAAM,kBAAkB,CAAC;AACjE,OAAO,EAAE,QAAQ,EAAE,MAAM,SAAS,CAAC;AACnC,OAAO,EAAE,OAAO,EAAE,MAAM,WAAW,CAAC;AACpC,OAAO,EACL,eAAe,EACf,uBAAuB,EACvB,0BAA0B,EAC1B,cAAc,GAEf,MAAM,iCAAiC,CAAC;AACzC,OAAO,EAAE,qBAAqB,EAAE,MAAM,gCAAgC,CAAC;AACvE,OAAO,EAAE,WAAW,EAAE,MAAM,aAAa,CAAC;AAe1C,MAAM,OAAO,gBAAgB;IAClB,aAAa,GAAG,UAAU,EAAE,CAAC;IACrB,MAAM,GAAG,IAAI,GAAG,EAAwB,CAAC;IAE1D,KAAK,CAAC,OAAO,CAAC,IAAY;QACxB,IAAI,OAAO,GAAG,IAAI,CAAC,MAAM,CAAC,GAAG,CAAC,IAAI,CAAC,CAAC;QACpC,IAAI,CAAC,OAAO,EAAE,CAAC;YACb,MAAM,MAAM,GAAG,MAAM,IAAI,CAAC,WAAW,CAAC,IAAI,CAAC,CAAC;YAC5C,OAAO,GAAG;gBACR,IAAI,EAAE,CAAC;gBACP,MAAM;gBACN,OAAO,EAAE,KAAK;aACf,CAAC;YACF,OAAO,CAAC,SAAS,GAAG,IAAI,CAAC,cAAc,CAAC,IAAI,EAAE,OAAO,CAAC,CAAC;YACvD,IAAI,CAAC,MAAM,CAAC,GAAG,CAAC,IAAI,EAAE,OAAO,CAAC,CAAC;QACjC,CAAC;QACD,OAAO,CAAC,IAAI,IAAI,CAAC,CAAC;QAClB,IAAI,QAAQ,GAAG,KAAK,CAAC;QACrB,OAAO;YACL,IAAI;YACJ,OAAO,EAAE,KAAK,IAAI,EAAE;gBAClB,IAAI,QAAQ,EAAE,CAAC;oBACb,OAAO;gBACT,CAAC;gBACD,QAAQ,GAAG,IAAI,CAAC;gBAChB,MAAM,IAAI,CAAC,OAAO,CAAC,IAAI,EAAE,OAAQ,CAAC,CAAC;YACrC,CAAC;SACF,CAAC;IACJ,CAAC;IAED,KAAK,CAAC,KAAK;QACT,MAAM,MAAM,GAAG,CAAC,GAAG,IAAI,CAAC,MAAM,CAAC,OAAO,EAAE,CAAC,CAAC;QAC1C,IAAI,CAAC,MAAM,CAAC,KAAK,EAAE,CAAC;QACpB,MAAM,OAAO,CAAC,GAAG,CACf,MAAM,CAAC,GAAG,CAAC,KAAK,EAAE,CAAC,IAAI,EAAE,OAAO,CAAC,EAAE,EAAE;YACnC,OAAO,CAAC,OAAO,GAAG,IAAI,CAAC;YACvB,IAAI,OAAO,CAAC,SAAS;gBAAE,aAAa,CAAC,OAAO,CAAC,SAAS,CAAC,CAAC;YACxD,MAAM,OAAO,CAAC,iBAAiB,CAAC;YAChC,MAAM,IAAI,CAAC,gBAAgB,CAAC,IAAI,EAAE,OAAO,CAAC,MAAM,CAAC,CAAC;QACpD,CAAC,CAAC,CACH,CAAC;IACJ,CAAC;IAEO,KAAK,CAAC,WAAW,CAAC,IAAY;QACpC,MAAM,IAAI,GAAG,eAAe,CAAC,IAAI,CAAC,CAAC;QACnC,MAAM,KAAK,CAAC,OAAO,CAAC,IAAI,CAAC,EAAE,EAAE,SAAS,EAAE,IAAI,EAAE,CAAC,CAAC;QAChD,MAAM,GAAG,GAAG,IAAI,CAAC,GAAG,EAAE,CAAC;QACvB,MAAM,MAAM,GAAsB;YAChC,GAAG,EAAE,OAAO,CAAC,GAAG;YAChB,QAAQ,EAAE,QAAQ,EAAE;YACpB,aAAa,EAAE,IAAI,CAAC,aAAa;YACjC,SAAS,EAAE,GAAG;YACd,SAAS,EAAE,GAAG;SACf,CAAC;QAEF,MAAM,KAAK,GAAG,uBAAuB,CAAC,IAAI,EAAE,IAAI,CAAC,aAAa,CAAC,CAAC;QAChE,IAAI,CAAC,KAAK,EAAE,CAAC;YACX,MAAM,IAAI,WAAW,CACnB,YAAY,EACZ,4CAA4C,EAC5C,IAAI,CACL,CAAC;QACJ,CAAC;QACD,IAAI,CAAC;YACH,IAAI,CAAC;gBACH,MAAM,MAAM,GAAG,MAAM,IAAI,CAAC,IAAI,EAAE,IAAI,EAAE,KAAK,CAAC,CAAC;gBAC7C,IAAI,CAAC;oBACH,MAAM,MAAM,CAAC,SAAS,CAAC,GAAG,IAAI,CAAC,SAAS,CAAC,MAAM,CAAC,IAAI,CAAC,CAAC;gBACxD,CAAC;wBAAS,CAAC;oBACT,MAAM,MAAM,CAAC,KAAK,EAAE,CAAC;gBACvB,CAAC;gBACD,OAAO,MAAM,CAAC;YAChB,CAAC;YAAC,OAAO,KAAK,EAAE,CAAC;gBACf,IAAK,KAA+B,CAAC,IAAI,KAAK,QAAQ,EAAE,CAAC;oBACvD,MAAM,KAAK,CAAC;gBACd,CAAC;gBACD,MAAM,QAAQ,GAAG,MAAM,aAAa,CAAC,IAAI,CAAC,CAAC;gBAC3C,IACE,QAAQ,EAAE,GAAG,KAAK,OAAO,CAAC,GAAG;oBAC7B,QAAQ,CAAC,aAAa,KAAK,IAAI,CAAC,aAAa,EAC7C,CAAC;oBACD,OAAO,QAAQ,CAAC;gBAClB,CAAC;gBACD,IACE,QAAQ;oBACR,QAAQ,CAAC,QAAQ,KAAK,QAAQ,EAAE;oBAChC,CAAC,cAAc,CAAC,QAAQ,CAAC,GAAG,CAAC,EAC7B,CAAC;oBACD,MAAM,MAAM,CAAC,IAAI,CAAC,CAAC,KAAK,CAAC,GAAG,EAAE,CAAC,SAAS,CAAC,CAAC;oBAC1C,MAAM,MAAM,GAAG,MAAM,IAAI,CAAC,IAAI,EAAE,IAAI,EAAE,KAAK,CAAC,CAAC;oBAC7C,IAAI,CAAC;wBACH,MAAM,MAAM,CAAC,SAAS,CAAC,GAAG,IAAI,CAAC,SAAS,CAAC,MAAM,CAAC,IAAI,CAAC,CAAC;oBACxD,CAAC;4BAAS,CAAC;wBACT,MAAM,MAAM,CAAC,KAAK,EAAE,CAAC;oBACvB,CAAC;oBACD,OAAO,MAAM,CAAC;gBAChB,CAAC;gBACD,IAAI,CAAC,QAAQ,IAAI,0BAA0B,CAAC,IAAI,CAAC,EAAE,CAAC;oBAClD,MAAM,MAAM,CAAC,IAAI,CAAC,CAAC,KAAK,CAAC,GAAG,EAAE,CAAC,SAAS,CAAC,CAAC;oBAC1C,MAAM,MAAM,GAAG,MAAM,IAAI,CAAC,IAAI,EAAE,IAAI,EAAE,KAAK,CAAC,CAAC;oBAC7C,IAAI,CAAC;wBACH,MAAM,MAAM,CAAC,SAAS,CAAC,GAAG,IAAI,CAAC,SAAS,CAAC,MAAM,CAAC,IAAI,CAAC,CAAC;oBACxD,CAAC;4BAAS,CAAC;wBACT,MAAM,MAAM,CAAC,KAAK,EAAE,CAAC;oBACvB,CAAC;oBACD,OAAO,MAAM,CAAC;gBAChB,CAAC;gBACD,MAAM,IAAI,WAAW,CACnB,YAAY,EACZ,iDAAiD,EACjD,IAAI,CACL,CAAC;YACJ,CAAC;QACH,CAAC;gBAAS,CAAC;YACT,KAAK,CAAC,OAAO,EAAE,CAAC;QAClB,CAAC;IACH,CAAC;IAEO,KAAK,CAAC,OAAO,CAAC,IAAY,EAAE,OAAqB;QACvD,OAAO,CAAC,IAAI,IAAI,CAAC,CAAC;QAClB,IAAI,OAAO,CAAC,IAAI,GAAG,CAAC,IAAI,IAAI,CAAC,MAAM,CAAC,GAAG,CAAC,IAAI,CAAC,KAAK,OAAO,EAAE,CAAC;YAC1D,OAAO;QACT,CAAC;QACD,IAAI,CAAC,MAAM,CAAC,MAAM,CAAC,IAAI,CAAC,CAAC;QACzB,OAAO,CAAC,OAAO,GAAG,IAAI,CAAC;QACvB,IAAI,OAAO,CAAC,SAAS;YAAE,aAAa,CAAC,OAAO,CAAC,SAAS,CAAC,CAAC;QACxD,MAAM,OAAO,CAAC,iBAAiB,CAAC;QAChC,MAAM,IAAI,CAAC,gBAAgB,CAAC,IAAI,EAAE,OAAO,CAAC,MAAM,CAAC,CAAC;IACpD,CAAC;IAEO,cAAc,CACpB,IAAY,EACZ,OAAqB;QAErB,MAAM,KAAK,GAAG,WAAW,CAAC,GAAG,EAAE;YAC7B,MAAM,SAAS,GAAG,CAAC,KAAK,IAAI,EAAE;gBAC5B,IAAI,OAAO,CAAC,OAAO;oBAAE,OAAO;gBAC5B,MAAM,KAAK,GAAG,uBAAuB,CAAC,IAAI,EAAE,IAAI,CAAC,aAAa,CAAC,CAAC;gBAChE,IAAI,CAAC,KAAK;oBAAE,OAAO;gBACnB,IAAI,CAAC;oBACH,MAAM,IAAI,GAAG,eAAe,CAAC,IAAI,CAAC,CAAC;oBACnC,MAAM,OAAO,GAAG,MAAM,aAAa,CAAC,IAAI,CAAC,CAAC;oBAC1C,IACE,OAAO,CAAC,OAAO;wBACf,OAAO,EAAE,GAAG,KAAK,OAAO,CAAC,MAAM,CAAC,GAAG;wBACnC,OAAO,CAAC,aAAa,KAAK,OAAO,CAAC,MAAM,CAAC,aAAa;wBAEtD,OAAO;oBACT,MAAM,SAAS,GAAG,IAAI,CAAC,GAAG,EAAE,CAAC;oBAC7B,MAAM,qBAAqB,CACzB,IAAI,EACJ,GAAG,IAAI,CAAC,SAAS,CAAC,EAAE,GAAG,OAAO,CAAC,MAAM,EAAE,SAAS,EAAE,CAAC,IAAI,EACvD,EAAE,IAAI,EAAE,KAAK,EAAE,CAChB,CAAC;oBACF,OAAO,CAAC,MAAM,CAAC,SAAS,GAAG,SAAS,CAAC;gBACvC,CAAC;wBAAS,CAAC;oBACT,KAAK,CAAC,OAAO,EAAE,CAAC;gBAClB,CAAC;YACH,CAAC,CAAC,EAAE,CAAC,KAAK,CAAC,GAAG,EAAE,CAAC,SAAS,CAAC,CAAC;YAC5B,OAAO,CAAC,iBAAiB,GAAG,SAAS,CAAC;YACtC,KAAK,SAAS,CAAC,OAAO,CAAC,GAAG,EAAE;gBAC1B,IAAI,OAAO,CAAC,iBAAiB,KAAK,SAAS;oBACzC,OAAO,CAAC,iBAAiB,GAAG,SAAS,CAAC;YAC1C,CAAC,CAAC,CAAC;QACL,CAAC,EAAE,KAAK,CAAC,CAAC;QACV,KAAK,CAAC,KAAK,EAAE,EAAE,CAAC;QAChB,OAAO,KAAK,CAAC;IACf,CAAC;IAEO,KAAK,CAAC,gBAAgB,CAC5B,IAAY,EACZ,QAA2B;QAE3B,IAAI,KAAK,CAAC;QACV,KAAK,IAAI,OAAO,GAAG,CAAC,EAAE,OAAO,GAAG,EAAE,IAAI,CAAC,KAAK,EAAE,OAAO,EAAE,EAAE,CAAC;YACxD,KAAK,GAAG,uBAAuB,CAAC,IAAI,EAAE,IAAI,CAAC,aAAa,CAAC,CAAC;YAC1D,IAAI,CAAC,KAAK,EAAE,CAAC;gBACX,MAAM,IAAI,OAAO,CAAC,CAAC,OAAO,EAAE,EAAE,CAAC,UAAU,CAAC,OAAO,EAAE,EAAE,CAAC,CAAC,CAAC;YAC1D,CAAC;QACH,CAAC;QACD,IAAI,CAAC,KAAK,EAAE,CAAC;YACX,MAAM,IAAI,WAAW,CACnB,YAAY,EACZ,0CAA0C,EAC1C,IAAI,CACL,CAAC;QACJ,CAAC;QACD,MAAM,IAAI,GAAG,eAAe,CAAC,IAAI,CAAC,CAAC;QACnC,IAAI,CAAC;YACH,MAAM,OAAO,GAAG,MAAM,aAAa,CAAC,IAAI,CAAC,CAAC;YAC1C,IACE,OAAO,EAAE,GAAG,KAAK,QAAQ,CAAC,GAAG;gBAC7B,OAAO,CAAC,aAAa,KAAK,QAAQ,CAAC,aAAa,EAChD,CAAC;gBACD,MAAM,MAAM,CAAC,IAAI,CAAC,CAAC,KAAK,CAAC,GAAG,EAAE,CAAC,SAAS,CAAC,CAAC;YAC5C,CAAC;QACH,CAAC;gBAAS,CAAC;YACT,KAAK,CAAC,OAAO,EAAE,CAAC;QAClB,CAAC;IACH,CAAC;CACF;AAED,KAAK,UAAU,aAAa,CAC1B,IAAY;IAEZ,IAAI,CAAC;QACH,MAAM,MAAM,GAAG,IAAI,CAAC,KAAK,CACvB,MAAM,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAC,CACC,CAAC;QAChC,IACE,OAAO,MAAM,CAAC,GAAG,KAAK,QAAQ;YAC9B,OAAO,MAAM,CAAC,QAAQ,KAAK,QAAQ;YACnC,OAAO,MAAM,CAAC,aAAa,KAAK,QAAQ;YACxC,OAAO,MAAM,CAAC,SAAS,KAAK,QAAQ;YACpC,OAAO,MAAM,CAAC,SAAS,KAAK,QAAQ,EACpC,CAAC;YACD,OAAO,SAAS,CAAC;QACnB,CAAC;QACD,OAAO,MAA2B,CAAC;IACrC,CAAC;IAAC,MAAM,CAAC;QACP,OAAO,SAAS,CAAC;IACnB,CAAC;AACH,CAAC"}
|
|
@@ -1,80 +0,0 @@
|
|
|
1
|
-
import type { WorkspaceReadSession } from "../engine/service/zvec-grep.js";
|
|
2
|
-
import type { ZvecGrepContextOptions, ZvecGrepContextResult } from "../engine/service/types.js";
|
|
3
|
-
import type { EmbeddingModelLoadRequest, EmbeddingModelPool, ModelLease } from "./model-pool.js";
|
|
4
|
-
import type { RootLease } from "./root-lease.js";
|
|
5
|
-
export type RootRuntimeOptions = {
|
|
6
|
-
canonicalRoot: string;
|
|
7
|
-
modelPool: EmbeddingModelPool;
|
|
8
|
-
modelLoadRequest?: EmbeddingModelLoadRequest;
|
|
9
|
-
rootLease?: RootLease;
|
|
10
|
-
readSessionIdleTtlMs?: number;
|
|
11
|
-
openSession?: (lease: ModelLease) => WorkspaceReadSession | Promise<WorkspaceReadSession>;
|
|
12
|
-
onActivity?: () => void;
|
|
13
|
-
};
|
|
14
|
-
export declare class RootRuntime {
|
|
15
|
-
private readonly options;
|
|
16
|
-
readonly canonicalRoot: string;
|
|
17
|
-
private generation?;
|
|
18
|
-
private generationTail;
|
|
19
|
-
private modelLoadRequest?;
|
|
20
|
-
private dirtyRevision;
|
|
21
|
-
private indexedRevision;
|
|
22
|
-
private fullReconciliationEpoch;
|
|
23
|
-
private reconciledFullEpoch;
|
|
24
|
-
private nonProbeableFullEpoch;
|
|
25
|
-
private initialFreshnessProbe?;
|
|
26
|
-
private watcherActive;
|
|
27
|
-
private watcherPending;
|
|
28
|
-
private watcherEpoch;
|
|
29
|
-
private writerPending;
|
|
30
|
-
private writerReady?;
|
|
31
|
-
private writerReadyResolve?;
|
|
32
|
-
private writerContext?;
|
|
33
|
-
private writerModelKey?;
|
|
34
|
-
private activeWriterSearches;
|
|
35
|
-
private writerSearchesDrained?;
|
|
36
|
-
private writerSearchesDrainedResolve?;
|
|
37
|
-
private activeOperations;
|
|
38
|
-
private closed;
|
|
39
|
-
constructor(options: RootRuntimeOptions);
|
|
40
|
-
updateModelLoadRequest(request: EmbeddingModelLoadRequest): void;
|
|
41
|
-
embeddingProvider(): string | undefined;
|
|
42
|
-
currentModelLoadRequest(): EmbeddingModelLoadRequest | undefined;
|
|
43
|
-
beginActivity(): () => void;
|
|
44
|
-
search(options: ZvecGrepContextOptions, modelLoadRequest?: EmbeddingModelLoadRequest): Promise<ZvecGrepContextResult>;
|
|
45
|
-
setWriterPending(pending: boolean): void;
|
|
46
|
-
setWriterContext(context: (options: ZvecGrepContextOptions) => Promise<ZvecGrepContextResult>, modelKey: string): () => Promise<void>;
|
|
47
|
-
markDirty(): number;
|
|
48
|
-
markIndexed(revision?: number): void;
|
|
49
|
-
requireFullReconciliation(probeAllowed?: boolean): void;
|
|
50
|
-
private armWriterReady;
|
|
51
|
-
private notifyWriterStateChanged;
|
|
52
|
-
reconciliationEpoch(): number;
|
|
53
|
-
markReconciled(revision?: number, reconciliationEpoch?: number): void;
|
|
54
|
-
requiresFullReconciliation(): boolean;
|
|
55
|
-
canProbeFullReconciliation(): boolean;
|
|
56
|
-
needsReconciliation(): boolean;
|
|
57
|
-
hasKnownChanges(): boolean;
|
|
58
|
-
probeInitialFreshness(probe: () => Promise<boolean>, onResult?: (result: "fresh" | "stale") => void): Promise<"fresh" | "stale">;
|
|
59
|
-
probeFreshness(probe: () => Promise<boolean>): Promise<"fresh" | "stale">;
|
|
60
|
-
setWatcherActive(active: boolean): void;
|
|
61
|
-
recordWatcherActivity(): void;
|
|
62
|
-
setWatcherPending(pending: boolean): void;
|
|
63
|
-
withWrite<T>(operation: () => Promise<T>): Promise<T>;
|
|
64
|
-
snapshot(): {
|
|
65
|
-
readSessionOpen: boolean;
|
|
66
|
-
activeReaders: number;
|
|
67
|
-
activeOperations: number;
|
|
68
|
-
writerPending: boolean;
|
|
69
|
-
dirtyRevision: number;
|
|
70
|
-
indexedRevision: number;
|
|
71
|
-
watcherActive: boolean;
|
|
72
|
-
watcherPending: boolean;
|
|
73
|
-
watcherEpoch: number;
|
|
74
|
-
};
|
|
75
|
-
close(): Promise<void>;
|
|
76
|
-
private openLeasedSession;
|
|
77
|
-
private withWriterContext;
|
|
78
|
-
private runFreshnessProbe;
|
|
79
|
-
private runGenerationSerial;
|
|
80
|
-
}
|