viberag 0.4.4 → 0.6.0

package/README.md

@@ -6,9 +6,9 @@
 
 VibeRAG is fully local, offline capable MCP server for local codebase search.
 
-- Semantic codebase search
-- Keyword codebase search (BM25)
-- Hybrid codebase search (with tunable parameters)
+- Intent-routed codebase search (definitions/files/blocks/usages)
+- Hybrid retrieval (full-text + vector search)
+- Explainable results with stable follow-ups (open spans, get symbols, find usages)
 
 VibeRAG automatically indexes your codebase into a local container-free vector database ([lancedb](https://lancedb.com/)). Every time you make a change, the indexes are automatically updated.
 
@@ -48,11 +48,11 @@ When using a coding agent like [Claude Code](https://claude.ai/code), add `use v
 ## Features
 
 - **CLI based setup** - CLI commands and wizards for setup, editor integration, and configuration
-- **Semantic code search** - Find code by meaning, not just keywords
+- **Agent-first search** - Find definitions, entry files, and relevant blocks (not just “chunks”)
 - **Flexible embeddings** - Local model (offline, free) or cloud providers (Gemini, Mistral, OpenAI)
 - **MCP server** - Works with Claude Code, Cursor, VS Code Copilot, and more
-- **Automatic incremental indexing** - Watches for file changes (respects `.gitignore`) and reindexes only what has changed in real time
-- **Resilient indexing** - Retries embedding errors and reports failed batches in `/status`
+- **Automatic incremental indexing** - Watches for file changes (respects `.gitignore` + `.viberagignore`) and reindexes only what has changed in real time
+- **Cancelable indexing** - Supports `/cancel` and clear status reporting via `/status`
 - **Multi-language support** - TypeScript, JavaScript, Python, Go, Rust, and more
 - **Blazing fast** - The data storage and search functionality is local on your machine, meaning the full power of your machine can churn through massive amounts of data and execute complex search queries in milliseconds.
 
@@ -452,120 +452,107 @@ args = ["-y", "viberag-mcp"]
 
 ## Exposed MCP Tools
 
-| Tool                       | Description                                          |
-| -------------------------- | ---------------------------------------------------- |
-| `codebase_search`          | Semantic, keyword, or hybrid search for code         |
-| `codebase_parallel_search` | Run multiple search strategies in parallel           |
-| `viberag_index`            | Index the codebase (incremental by default)          |
-| `viberag_status`           | Get index status, file count, and embedding provider |
-| `viberag_watch_status`     | Get file watcher status for auto-indexing            |
+VibeRAG exposes a small set of agent-centric tools. Backward compatibility with
+legacy tool names is not provided.
 
-#### `codebase_search`
+| Tool                   | Description                                                           |
+| ---------------------- | --------------------------------------------------------------------- |
+| `codebase_search`      | Intent-routed search with grouped results + stable IDs for follow-ups |
+| `help`                 | Usage guide for MCP tools + how search works                          |
+| `read_file_lines`      | Read an exact line range from disk                                    |
+| `get_symbol_details`   | Fetch a symbol definition + deterministic metadata by `symbol_id`     |
+| `find_references`      | Find usage occurrences (refs) for a symbol name or `symbol_id`        |
+| `get_surrounding_code` | Expand a hit into neighbors (symbols/chunks) and related metadata     |
+| `build_index`          | Build/update the index (incremental by default)                       |
+| `get_status`           | Get index + daemon status summary                                     |
+| `get_watcher_status`   | Get watcher status (auto-indexing)                                    |
+| `cancel_operation`     | Cancel indexing or warmup without shutting down the daemon            |
 
-The primary search tool. Finds code by meaning, not just keywords.
+### `codebase_search`
 
-**Search Modes:**
+Single entry point with intent routing. Use `scope` for transparent filters.
 
-| Mode         | Best For                                     |
-| ------------ | -------------------------------------------- |
-| `hybrid`     | Most queries (default) - combines both       |
-| `semantic`   | Conceptual queries ("how does auth work?")   |
-| `exact`      | Symbol names, specific strings               |
-| `definition` | Direct symbol lookup ("where is X defined?") |
-| `similar`    | Find code similar to a snippet               |
+- `intent`: `auto|definition|usage|concept|exact_text|similar_code`
+- Definition-style symbol lookups tolerate small typos via fuzzy (Levenshtein) name matching.
+- `scope`: `path_prefix`, `path_contains`, `path_not_contains`, `extension`
+- `explain`: include per-hit channels + ranking priors
 
-**Key Parameters:**
-
-- `query` - Natural language search query
-- `mode` - Search mode (default: `hybrid`)
-- `limit` - Max results (default: 10, max: 100)
-- `bm25_weight` - Balance keyword vs semantic (0-1, default: 0.3)
-- `filters` - Path, type, and metadata filters
-
-**Example:**
+Example:
 
 ```json
 {
-	"query": "authentication middleware",
-	"mode": "hybrid",
-	"limit": 15,
-	"filters": {
-		"path_not_contains": ["test", "mock"],
-		"is_exported": true
-	}
+	"query": "how does authentication work",
+	"intent": "concept",
+	"scope": {
+		"path_prefix": ["src/"],
+		"path_not_contains": ["test", "__tests__", ".spec.", ".test."]
+	},
+	"k": 20,
+	"explain": true
 }
 ```
 
-#### `codebase_parallel_search`
-
-Run multiple search strategies simultaneously and merge results. Best for comprehensive exploration.
-
-**Use Cases:**
+Follow-ups: `get_symbol_details`, `read_file_lines`, `get_surrounding_code`, `find_references`.
 
-- Compare semantic vs keyword results
-- Search related concepts together
-- Test different weight settings
+## CLI Commands
 
-**Example:**
+VibeRAG includes a CLI for easy execution of initialization, indexing, setup, and other things you may want to manually control outside of agent use.
 
-```json
-{
-	"searches": [
-		{"query": "authentication", "mode": "semantic", "limit": 10},
-		{"query": "auth login JWT", "mode": "exact", "limit": 10},
-		{"query": "user session", "mode": "hybrid", "bm25_weight": 0.5, "limit": 10}
-	],
-	"merge_results": true,
-	"merge_strategy": "rrf",
-	"merged_limit": 20
-}
-```
+| Command           | Description                                               |
+| ----------------- | --------------------------------------------------------- |
+| `/init`           | Initialize VibeRAG (configure embeddings, index codebase) |
+| `/index`          | Index the codebase (incremental)                          |
+| `/reindex`        | Force full reindex                                        |
+| `/search <query>` | Semantic search                                           |
+| `/status`         | Show daemon and index status                              |
+| `/cancel`         | Cancel indexing or warmup                                 |
+| `/mcp-setup`      | Configure MCP server for AI tools                         |
+| `/clean`          | Remove VibeRAG from project                               |
+| `/help`           | Show all commands                                         |
 
-#### `viberag_index`
+## Data Directory
 
-Manually trigger indexing. Normally not needed as file watching handles updates automatically.
+VibeRAG stores all per-project state (config, index, logs) globally under:
 
-**Parameters:**
+- `~/.local/share/viberag/projects/<projectId>/` (override via `VIBERAG_HOME`)
 
-- `force` - Full reindex ignoring cache (default: `false`)
+No files are written into your repo.
 
-#### `viberag_status`
+## Ignoring Files
 
-Check index health and configuration.
+VibeRAG uses `.gitignore` rules to exclude files and folders from indexing. For
+non-git projects (or for additional ignore patterns), you can create a
+`.viberagignore` file in the project root.
 
-**Returns:**
+- `.viberagignore` uses the exact same pattern syntax as `.gitignore`
+- It is applied in addition to `.gitignore` (if present)
 
-- File count, chunk count
-- Embedding provider and dimensions
-- Schema version
-- Last update timestamp
-- Warmup status (ready, initializing, etc.)
+Example `.viberagignore`:
 
-#### `viberag_watch_status`
+```gitignore
+# build outputs
+dist/
+build/
 
-Check the file watcher for auto-indexing.
+# local artifacts
+coverage/
+tmp/
 
-**Returns:**
+# generated bundles
+**/*.min.js
+```
 
-- Whether watching is active
-- Number of files being watched
-- Pending changes count
-- Last update timestamp
+## Logs
 
-## CLI Commands
+VibeRAG writes per-service logs with hourly rotation:
 
-VibeRAG includes a CLI for easy execution of initialization, indexing, setup, and other things you may want to manually control outside of agent use.
+- `~/.local/share/viberag/projects/<projectId>/logs/daemon/` - daemon lifecycle and IPC errors
+- `~/.local/share/viberag/projects/<projectId>/logs/indexer/` - indexing progress, retries, and batch failures
+- `~/.local/share/viberag/projects/<projectId>/logs/mcp/` - MCP server errors
+- `~/.local/share/viberag/projects/<projectId>/logs/cli/` - CLI errors
 
-| Command           | Description                                               |
-| ----------------- | --------------------------------------------------------- |
-| `/init`           | Initialize VibeRAG (configure embeddings, index codebase) |
-| `/index`          | Index the codebase (incremental)                          |
-| `/reindex`        | Force full reindex                                        |
-| `/search <query>` | Semantic search                                           |
-| `/status`         | Show index status                                         |
-| `/mcp-setup`      | Configure MCP server for AI tools                         |
-| `/clean`          | Remove VibeRAG from project                               |
-| `/help`           | Show all commands                                         |
+If indexing appears slow or retries are happening, check the latest file under
+`~/.local/share/viberag/projects/<projectId>/logs/indexer/`.
 
 ## Embedding Providers
 
@@ -593,7 +580,7 @@ Choose your embedding provider during `/init`:
 - **Mistral** - Code-optimized embeddings for technical content
 - **OpenAI** - Fast and reliable with low cost
 
-API keys are entered during the `/init` wizard and stored securely in `.viberag/config.json` (automatically added to `.gitignore`).
+API keys are entered during the `/init` wizard and stored globally in `~/.local/share/viberag/secrets/secrets.json` (override via `VIBERAG_HOME`). Project configs store only a key id reference (never the raw API key).
 
 ## How It Works
 
@@ -633,7 +620,7 @@ Add to your `CLAUDE.md`:
 
 ```markdown
 When exploring the codebase, use Task(subagent_type='Explore') and instruct it
-to use codebase_search or codebase_parallel_search. This keeps the main context clean.
+to use the viberag `codebase_search` tool (and follow-ups like `get_symbol_details` / `read_file_lines`). This keeps the main context clean.
 ```
 
 #### VS Code Copilot
@@ -686,46 +673,53 @@ to use codebase_search or codebase_parallel_search. This keeps the main context
 
 ### Quick Lookup vs Exploration
 
-| Task Type                       | Recommended Approach                            |
-| ------------------------------- | ----------------------------------------------- |
-| "Where is function X defined?"  | Direct `codebase_search` with mode='definition' |
-| "What file handles Y?"          | Direct `codebase_search` - single query         |
-| "How does authentication work?" | **Sub-agent** - needs multiple searches         |
-| "Find all API endpoints"        | **Sub-agent** or `codebase_parallel_search`     |
-| "Understand the data flow"      | **Sub-agent** - iterative exploration           |
+| Task Type                       | Recommended Approach                                      |
+| ------------------------------- | --------------------------------------------------------- |
+| "Where is function X defined?"  | `codebase_search` with `intent="definition"`              |
+| "What file handles Y?"          | `codebase_search` with `intent="concept"` (check `files`) |
+| "How does authentication work?" | **Sub-agent** - needs multi-step search + follow-ups      |
+| "Find all API endpoints"        | **Sub-agent** - iterative search + scope filters          |
+| "Understand the data flow"      | **Sub-agent** - iterative exploration                     |
 
 ### For Platforms Without Sub-Agents
 
-Use `codebase_parallel_search` to run multiple search strategies in a single call:
+Use a few targeted `codebase_search` calls with different intents, then follow up with
+`get_symbol_details`, `read_file_lines`, `get_surrounding_code`, and `find_references` as needed.
+
+Example sequence:
+
+```json
+{"query": "authentication", "intent": "concept", "k": 20}
+```
 
 ```json
 {
-	"searches": [
-		{"query": "authentication", "mode": "semantic"},
-		{"query": "auth login", "mode": "exact"},
-		{"query": "user session", "mode": "hybrid", "bm25_weight": 0.5}
-	],
-	"merge_results": true,
-	"merge_strategy": "rrf"
+	"query": "login",
+	"intent": "definition",
+	"k": 20,
+	"scope": {"path_prefix": ["src/"]}
 }
 ```
 
-This provides comprehensive coverage without multiple round-trips.
+```json
+{"symbol_name": "login", "k": 200}
+```
 
 ## Troubleshooting
 
 ### Watcher EMFILE (too many open files)
 
-Large repos can exceed OS watch limits. The watcher now honors `.gitignore`, but if you still see EMFILE:
+Large repos can exceed OS watch limits. The watcher honors `.gitignore` and `.viberagignore`, but if you still see EMFILE:
 
-- Add more ignores in `.gitignore` to reduce watched files.
+- Add more ignores in `.gitignore` or `.viberagignore` to reduce watched files.
 - Increase OS limits:
   - macOS: raise `kern.maxfiles`, `kern.maxfilesperproc`, and `ulimit -n`
   - Linux: raise `fs.inotify.max_user_watches`, `fs.inotify.max_user_instances`, and `ulimit -n`
 
 ### Index failures (network/API errors)
 
-Embedding batches retry up to 10 attempts. If failures persist:
+If indexing fails due to transient network/API issues:
 
-- Run `/status` to see failed batch counts.
-- Re-run `/index` to retry failed files once connectivity is stable.
+- Run `/status` to confirm daemon/index state.
+- Re-run `/index` after connectivity is stable.
+- Use `/cancel` to stop a stuck run, then `/reindex` if you need a clean rebuild.

package/dist/cli/app.js

@@ -5,7 +5,7 @@ import { Provider } from 'react-redux';
 import { store } from './store/store.js';
 import { useAppDispatch, useAppSelector } from './store/hooks.js';
 import { WizardActions } from './store/wizard/slice.js';
-import { selectActiveWizard, selectInitStep, selectMcpStep, selectInitConfig, selectMcpConfig, selectIsReinit, selectShowMcpPrompt, selectExistingApiKey, selectExistingProvider, } from './store/wizard/selectors.js';
+import { selectActiveWizard, selectInitStep, selectMcpStep, selectInitConfig, selectMcpConfig, selectIsReinit, selectShowMcpPrompt, selectExistingApiKeyId, selectExistingProvider, } from './store/wizard/selectors.js';
 import { AppActions } from './store/app/slice.js';
 import { selectIsInitialized, selectIndexStats, selectAppStatus, selectOutputItems, selectStartupLoaded, } from './store/app/selectors.js';
 // Common infrastructure
@@ -26,6 +26,8 @@ import { DaemonStatusProvider } from './contexts/DaemonStatusContext.js';
 import { checkInitialized, loadIndexStats, runInit, runIndex, formatIndexStats, } from './commands/handlers.js';
 import { getViberagDir } from '../daemon/lib/constants.js';
 import { loadConfig } from '../daemon/lib/config.js';
+import { checkNpmForUpdate } from '../daemon/lib/update-check.js';
+import { checkV2IndexCompatibility } from '../daemon/services/v2/manifest.js';
 const require = createRequire(import.meta.url);
 // Path is relative from dist/ after compilation
 const { version } = require('../../package.json');
@@ -41,7 +43,8 @@ const COMMANDS = [
     { command: '/index', description: 'Index the codebase' },
     { command: '/reindex', description: 'Force full reindex' },
     { command: '/search', description: 'Search codebase semantically' },
-    { command: '/status', description: 'Show index statistics' },
+    { command: '/status', description: 'Show daemon and index status' },
+    { command: '/cancel', description: 'Cancel indexing or warmup' },
     { command: '/mcp-setup', description: 'Configure MCP for AI tools' },
     { command: '/clean', description: 'Remove Viberag from project' },
     { command: '/quit', description: 'Exit the application' },
@@ -60,7 +63,7 @@ function AppContent() {
     const mcpConfig = useAppSelector(selectMcpConfig);
     const isReinit = useAppSelector(selectIsReinit);
     const showMcpPrompt = useAppSelector(selectShowMcpPrompt);
-    const existingApiKey = useAppSelector(selectExistingApiKey);
+    const existingApiKeyId = useAppSelector(selectExistingApiKeyId);
     const existingProvider = useAppSelector(selectExistingProvider);
     // Redux app state (migrated from useState)
     const isInitialized = useAppSelector(selectIsInitialized);
@@ -81,29 +84,53 @@ function AppContent() {
             if (initialized) {
                 const config = await loadConfig(projectRoot);
                 dispatch(WizardActions.setExistingConfig({
-                    apiKey: config.apiKey,
+                    apiKeyId: config.apiKeyRef?.keyId,
                     provider: config.embeddingProvider,
                 }));
             }
         });
         loadIndexStats(projectRoot).then(stats => dispatch(AppActions.setIndexStats(stats)));
     }, [projectRoot, dispatch]);
-    // Command history
-    const { addToHistory, navigateUp, navigateDown, resetIndex } = useCommandHistory();
     const addOutput = useCallback((type, content) => {
         dispatch(AppActions.addOutput({ type, content }));
     }, [dispatch]);
     const addSearchResults = useCallback((data) => {
         dispatch(AppActions.addSearchResults(data));
     }, [dispatch]);
+    // Startup checks: updates + index compatibility (best-effort, non-blocking)
+    useEffect(() => {
+        const disabled = process.env['VIBERAG_SKIP_UPDATE_CHECK'] === '1' ||
+            process.env['VIBERAG_SKIP_UPDATE_CHECK'] === 'true' ||
+            process.env['NODE_ENV'] === 'test';
+        if (!disabled) {
+            checkNpmForUpdate({ timeoutMs: 3000 })
+                .then(result => {
+                if (result.status === 'update_available' && result.message) {
+                    addOutput('system', result.message);
+                }
+            })
+                .catch(() => { });
+        }
+        checkV2IndexCompatibility(projectRoot)
+            .then(result => {
+            if ((result.status === 'needs_reindex' ||
+                result.status === 'corrupt_manifest') &&
+                result.message) {
+                addOutput('system', result.message);
+            }
+        })
+            .catch(() => { });
+    }, [projectRoot, addOutput]);
+    // Command history
+    const { addToHistory, navigateUp, navigateDown, resetIndex } = useCommandHistory();
     // Start the init wizard
     const startInitWizard = useCallback((isReinit) => {
         dispatch(WizardActions.startInit({
             isReinit,
-            existingApiKey: existingApiKey ?? undefined,
+            existingApiKeyId: existingApiKeyId ?? undefined,
             existingProvider: existingProvider ?? undefined,
         }));
-    }, [dispatch, existingApiKey, existingProvider]);
+    }, [dispatch, existingApiKeyId, existingProvider]);
     // Start the MCP setup wizard
     const startMcpSetupWizard = useCallback((showPrompt = false) => {
         dispatch(WizardActions.startMcpSetup({ showPrompt }));
@@ -133,9 +160,9 @@ function AppContent() {
         // Wait for next tick so wizard unmounts before we add output
         await new Promise(resolve => setTimeout(resolve, 50));
         addOutput('system', 'Initializing Viberag...');
-        dispatch(AppActions.setWarning('Initializing...'));
+        dispatch(AppActions.setWorking('Initializing...'));
         try {
-            const result = await runInit(projectRoot, isInitialized ?? false, config);
+            const result = await runInit(projectRoot, isInitialized ?? false, config, message => dispatch(AppActions.setWorking(message)));
             addOutput('system', result);
             dispatch(AppActions.setInitialized(true));
             // Automatically start indexing after init
@@ -230,7 +257,7 @@ function AppContent() {
                 item.content)) : (React.createElement(Text, null, item.content))));
         }),
         React.createElement(StatusBar, { status: appStatus, stats: indexStats }),
-        activeWizard === 'init' ? (React.createElement(InitWizard, { step: initStep, config: initConfig, isReinit: isReinit, existingApiKey: existingApiKey ?? undefined, existingProvider: existingProvider ?? undefined, onStepChange: handleInitWizardStep, onComplete: handleInitWizardComplete, onCancel: handleWizardCancel })) : activeWizard === 'mcp-setup' ? (React.createElement(McpSetupWizard, { step: mcpStep, config: mcpConfig, projectRoot: projectRoot, showPrompt: showMcpPrompt, onStepChange: handleMcpWizardStep, onComplete: handleMcpWizardComplete, onCancel: handleWizardCancel, addOutput: addOutput })) : activeWizard === 'clean' ? (React.createElement(CleanWizard, { projectRoot: projectRoot, viberagDir: getViberagDir(projectRoot), onComplete: handleCleanWizardComplete, onCancel: handleWizardCancel, addOutput: addOutput })) : (React.createElement(TextInput, { onSubmit: handleSubmit, onCtrlC: handleCtrlC, commands: COMMANDS, navigateHistoryUp: navigateUp, navigateHistoryDown: navigateDown, resetHistoryIndex: resetIndex }))));
+        activeWizard === 'init' ? (React.createElement(InitWizard, { step: initStep, config: initConfig, isReinit: isReinit, existingApiKeyId: existingApiKeyId ?? undefined, existingProvider: existingProvider ?? undefined, onStepChange: handleInitWizardStep, onComplete: handleInitWizardComplete, onCancel: handleWizardCancel })) : activeWizard === 'mcp-setup' ? (React.createElement(McpSetupWizard, { step: mcpStep, config: mcpConfig, projectRoot: projectRoot, showPrompt: showMcpPrompt, onStepChange: handleMcpWizardStep, onComplete: handleMcpWizardComplete, onCancel: handleWizardCancel, addOutput: addOutput })) : activeWizard === 'clean' ? (React.createElement(CleanWizard, { projectRoot: projectRoot, viberagDir: getViberagDir(projectRoot), onComplete: handleCleanWizardComplete, onCancel: handleWizardCancel, addOutput: addOutput })) : (React.createElement(TextInput, { onSubmit: handleSubmit, onCtrlC: handleCtrlC, commands: COMMANDS, navigateHistoryUp: navigateUp, navigateHistoryDown: navigateDown, resetHistoryIndex: resetIndex }))));
 }
 /**
  * Main App component with Redux Provider and DaemonStatusProvider.

package/dist/cli/commands/handlers.d.ts

@@ -1,15 +1,8 @@
 /**
  * RAG commands for the CLI.
  */
-import type { IndexStats, SearchResults } from '../../client/types.js';
-import type { InitWizardConfig } from '../../common/types.js';
-/**
- * Index display stats type (re-exported for convenience).
- */
-export type IndexDisplayStats = {
-    totalFiles: number;
-    totalChunks: number;
-};
+import type { IndexStats, EvalReport } from '../../client/types.js';
+import type { InitWizardConfig, IndexDisplayStats, SearchResultsData } from '../../common/types.js';
 /**
  * Check if project is initialized.
  */
@@ -20,10 +13,11 @@ export declare function checkInitialized(projectRoot: string): Promise<boolean>;
 export declare function loadIndexStats(projectRoot: string): Promise<IndexDisplayStats | null>;
 /**
  * Initialize a project for Viberag.
- * Creates .viberag/ directory with config.json.
+ * Creates a global per-project data directory with config.json.
  * With isReinit=true, shuts down daemon and deletes everything first.
+ * Optionally reports progress for UI status updates.
  */
-export declare function runInit(projectRoot: string, isReinit?: boolean, wizardConfig?: InitWizardConfig): Promise<string>;
+export declare function runInit(projectRoot: string, isReinit?: boolean, wizardConfig?: InitWizardConfig, onProgress?: (message: string) => void): Promise<string>;
 /**
  * Run the indexer and return stats.
  * Delegates to daemon which handles dimension sync internally.
@@ -39,18 +33,27 @@ export declare function formatIndexStats(stats: IndexStats): string;
  * Run a search query and return results.
  * Delegates to daemon for search.
  */
-export declare function runSearch(projectRoot: string, query: string, limit?: number): Promise<SearchResults>;
+export declare function runSearch(projectRoot: string, query: string, k?: number): Promise<SearchResultsData>;
+/**
+ * Run the v2 eval harness via daemon.
+ */
+export declare function runEval(projectRoot: string): Promise<EvalReport>;
+export declare function formatEvalReport(report: EvalReport): string;
 /**
  * Format search results for display with colors.
  */
-export declare function formatSearchResults(results: SearchResults): string;
+export declare function formatSearchResults(data: SearchResultsData): string;
 /**
  * Get index status.
  */
 export declare function getStatus(projectRoot: string): Promise<string>;
+/**
+ * Cancel indexing or warmup.
+ */
+export declare function cancelActivity(projectRoot: string, target?: string): Promise<string>;
 /**
  * Clean/uninstall Viberag from a project.
- * Shuts down daemon first, then removes the entire .viberag/ directory.
+ * Shuts down daemon first, then removes the entire project data directory.
  */
 export declare function runClean(projectRoot: string): Promise<string>;
 /**