minovative-mind-cli 2.5.2 → 2.6.1

package/README.md

@@ -94,11 +94,13 @@ Hot-swap during a session using `/models`:
 | **Gemini 3.5 Flash Lite** | Best for speed and cost efficiency                  |
 
 ### BYOK (Bring Your Own Key)
-If you prefer to use your own Gemini API key, you can configure it via the settings.
-*   **Configuration:** Set `useByok: true` and `geminiApiKey: "YOUR_KEY"` in your credentials storage.
-*   **Error Handling:** If your key is invalid, expired, or you hit rate limits, the CLI will report a `BYOK AI Error`. Please check your API key status in the Google AI Studio dashboard.
 
-> Background tasks (routing, compression, commits) always use lightweight
+If you prefer to use your own API key instead of credits, you can configure it via the `/config-key` slash command. **Only API keys from [Google AI Studio](https://aistudio.google.com) are supported** — Vertex AI, OpenAI, and Anthropic keys are not compatible.
+
+- **Configuration:** Use `/config-key` in the chat session to set and manage your API key.
+- **Error Handling:** If your key is invalid, expired, or you hit rate limits, the CLI will report a `BYOK AI Error`. Please check your API key status in the [Google AI Studio dashboard](https://aistudio.google.com).
+
+> Background tasks (routing, history summarization, context compression, commits) always use lightweight
 > models automatically. You pay for those lightweight model
 > background ai models and for your selected model
 > during chat and code execution.
@@ -108,27 +110,27 @@ If you prefer to use your own Gemini API key, you can configure it via the setti
 
 ## Session Commands
 
-| Command         | What it does                                                                                                               |
-| --------------- | -------------------------------------------------------------------------------------------------------------------------- |
-| `/models`       | Hot-swap the active model                                                                                                  |
-| `/plan`         | Toggle plan mode to review implementation strategies                                                                       |
-| `/paste`        | Multi-line input mode (cancel with Ctrl+C)                                                                                 |
-| `/clear`        | Clear conversation history                                                                                                 |
-| `/debug`        | Expose internal agent diagnostics                                                                                          |
-| `/auto-approve` | Toggle skipping confirmation prompts for commands                                                                          |
-| `/sub-agents`   | Toggle the MMAAK Engine for parallel investigation and execution (concurrency limited to 2)                                |
-| `/stats`        | View current session statistics and configuration                                                                          |
-| `/commit`       | Generate a conventional commit message from your diff                                                                      |
-| `/revert`       | Undo changes from the last turn, or toggle the revert logger                                                               |
-| `/chats`        | View, resume, or delete previous chat sessions (with centralized token telemetry, Git branch, auto-approve status, and sub-agent state) |
-| `/workspaces`   | Manage active workspaces and linked cross-repo aliases                                                                     |
-| `stop`          | Abort generation immediately                                                                                               |
+| Command         | What it does                                                                                                                                    |
+| --------------- | ----------------------------------------------------------------------------------------------------------------------------------------------- |
+| `/models`       | Hot-swap the active model                                                                                                                       |
+| `/plan`         | Toggle plan mode to review implementation strategies                                                                                            |
+| `/paste`        | Multi-line input mode (cancel with Ctrl+C)                                                                                                      |
+| `/clear`        | Clear conversation history                                                                                                                      |
+| `/debug`        | Expose internal agent diagnostics                                                                                                               |
+| `/auto-approve` | Toggle skipping confirmation prompts for commands                                                                                               |
+| `/sub-agents`   | Toggle the MMAAK Engine for parallel investigation and execution (concurrency limited to 2)                                                     |
+| `/stats`        | View session and all-time statistics, plus configurations                                                                                       |
+| `/commit`       | Generate a conventional commit message from your diff                                                                                           |
+| `/revert`       | Undo changes from the last turn, or toggle the revert logger                                                                                    |
+| `/chats`        | View, resume, rename, or delete previous chat sessions (with centralized token telemetry, Git branch, auto-approve status, and sub-agent state) |
+| `/workspaces`   | Manage active workspaces and linked cross-repo aliases                                                                                          |
+| `stop`          | Abort generation immediately                                                                                                                    |
 
 ---
 
 ## 🌐 Multi-Workspace & Cross-Repo Support (Master & Sub-Workspaces)
 
-Minovative Mind CLI doesn't restrict you to a single repository. You can logically group multiple external repositories into **Master Workspaces** (Profiles) containing dedicated **Sub-Workspaces** (mapped to short aliases like `@backend` or `@frontend`). 
+Minovative Mind CLI doesn't restrict you to a single repository. You can logically group multiple external repositories into **Master Workspaces** (Profiles) containing dedicated **Sub-Workspaces** (mapped to short aliases like `@backend` or `@frontend`).
 
 The Context Agent and Thread Agents operate strictly within the boundaries of the active Master Workspace, ignoring other profiles to keep the context window highly targeted and memory-efficient.
 
@@ -140,7 +142,7 @@ By prefixing file paths with `@alias/` (e.g., `@backend/src/api.ts` and `@fronte
 
 Minovative Mind CLI fundamentally supports **ALL programming languages** for chat, code generation, planning, and execution, as it relies on Gemini's vast training data.
 
-However, the PCV engine features deep, context-aware analysis across **11 major programming language families**. Our core advanced engines—**Smart Dependency Tracing**, **Performance Auditing**, and **Ephemeral Analysis Scripts**—provide tailored support depending on the language's syntax and runtime model:
+However, the PCV engine features deep, context-aware analysis across **12 major programming language families**. Our core advanced engines—**Smart Dependency Tracing**, **Performance Auditing** (across 9 language families), and **Ephemeral Analysis Scripts**—provide tailored support depending on the language's syntax and runtime model:
 
 | Language Family              | Supported Extensions                         | Dependency Tracing | Performance Auditing | Ephemeral Analysis |
 | :--------------------------- | :------------------------------------------- | :----------------: | :------------------: | :----------------: |
@@ -148,11 +150,12 @@ However, the PCV engine features deep, context-aware analysis across **11 major
 | **Python**                   | `.py`, `.pyw`                                |         ✅         |          ✅          |         ✅         |
 | **Rust**                     | `.rs`                                        |         ✅         |          ✅          |         ✅         |
 | **Go**                       | `.go`                                        |         ✅         |          ✅          |         ✅         |
-| **C / C++**                  | `.c`, `.h`, `.cpp`, `.hpp`, `.cc`            |         ✅         |        ⚠️ \*         |       ⚠️ \*        |
-| **Java / Kotlin**            | `.java`, `.kt`, `.kts`                       |         ✅         |        ⚠️ \*         |       ⚠️ \*        |
+| **C / C++**                  | `.c`, `.h`, `.cpp`, `.hpp`, `.cc`, `.cxx`    |         ✅         |          ✅          |       ⚠️ \*        |
+| **C#**                       | `.cs`                                        |         ✅         |          ✅          |         ❌         |
+| **Java / Kotlin**            | `.java`, `.kt`, `.kts`                       |         ✅         |          ✅          |       ⚠️ \*        |
 | **PHP**                      | `.php`                                       |         ✅         |          ✅          |         ❌         |
+| **Ruby**                     | `.rb`                                        |         ✅         |          ✅          |         ❌         |
 | **CSS / SCSS / SASS / LESS** | `.css`, `.scss`, `.sass`, `.less`            |         ✅         |          ❌          |         ❌         |
-| **Ruby**                     | `.rb`                                        |         ✅         |          ❌          |         ❌         |
 | **Swift**                    | `.swift`                                     |         ✅         |          ❌          |         ❌         |
 | **Dart**                     | `.dart`                                      |         ✅         |          ❌          |         ❌         |
 
@@ -160,8 +163,8 @@ _⚠️\*Support is limited or requires custom local system tooling/environment
 
 ### Why do some features only support specific languages?
 
-1. **Dependency Tracing:** Fully supported for all 11 languages. It uses lightning-fast static regex pattern matching to resolve local import structures and determine the "blast radius" of code changes without requiring local compilations.
-2. **Performance Auditing:** Uses regex-based heuristic analysis to scan for issues. Extending this to complex grammars (such as Ruby or Swift) with pure regex can cause high false-positive rates; those require full AST parsing, which runs counter to the auditor's ultra-fast (<50ms) and zero-dependency goals.
+1. **Dependency Tracing:** Fully supported across language families. It uses lightning-fast static regex pattern matching to resolve local import structures and determine the "blast radius" of code changes without requiring local compilations.
+2. **Performance Auditing:** Executed natively across 9 major language families (JavaScript/TypeScript, Python, Go, Rust, PHP, C#, Java, C/C++, and Ruby). It uses zero-dependency, ultra-fast (<50ms) language-aware regex heuristics with comment/string stripping and line-preserving offset tracking to detect severe runtime anti-patterns (such as unbounded loops, synchronous I/O, chained array allocations, unnecessary allocations, and unclosed resources).
 3. **Ephemeral Analysis Scripts:** Runs temporary files in sandbox directories to parse and extract local symbols. Also used for infrastructure probing (detecting available runtimes, checking ports, identifying project type), post-change validation (importing modified modules and asserting expected behavior), and lightweight ML-powered analysis (e.g., TF-IDF file ranking, anomaly detection, Big-O estimation). Defaults to Node.js as a safe baseline, but natively leverages host-installed runtimes (Python, Rust, Go compilers) and standard libraries whenever available in the workspace.
 
 ---

package/dist/commands/chat.js

@@ -30,11 +30,11 @@ Inside the chat session, you can use the following commands in the slash menu:
   /auto-approve  - Toggle automatic approval of tool/command runs
   /sub-agents    - Toggle the MMAAK Engine for parallel investigation and execution
   /workspaces    - Manage external workspaces for cross-project development
-  /config-key    - BYOK (Bring Your Own Key) Configuration
+  /config-key    - BYOK — Use your own Google AI Studio API key
   /stats         - View current session statistics and configuration
   /commit        - Commit current workspace changes to Git
   /revert        - Revert the last file modification made by the agent
-  /chats         - View, resume, or delete previous chat sessions (includes bulk delete)
+  /chats         - View, resume, edit titles, or delete previous chat sessions (includes bulk delete)
  
 Chat Controls:
   - Multi-line Input: End a line with \\ to continue on the next line

package/dist/services/agent/inputHandler.d.ts

@@ -73,6 +73,15 @@ export declare class AsyncInputHandler {
      * the terminal stdin stream to its original raw/cooked state.
      */
     stop(): void;
+    /**
+     * Clears the spinner reference without stopping the input handler.
+     */
+    clearSpinner(): void;
+    /**
+     * Sets a new active spinner for the input handler to manage during prompts.
+     * Also applies the necessary monkey-patches to track the message state.
+     */
+    setSpinner(spinner: ReturnType<typeof p.spinner>): void;
     /**
      * Retrieves and flushes all user feedback messages accumulated during execution.
      *

package/dist/services/agent/inputHandler.js

@@ -192,6 +192,40 @@ export class AsyncInputHandler {
         }
         this.spinner = null;
     }
+    /**
+     * Clears the spinner reference without stopping the input handler.
+     */
+    clearSpinner() {
+        this.spinner = null;
+    }
+    /**
+     * Sets a new active spinner for the input handler to manage during prompts.
+     * Also applies the necessary monkey-patches to track the message state.
+     */
+    setSpinner(spinner) {
+        this.spinner = spinner;
+        if (!spinner._isPatched) {
+            ;
+            spinner._isPatched = true;
+            spinner._lastMessage = 'Executing...';
+            const originalMessage = spinner.message.bind(spinner);
+            spinner.message = (msg) => {
+                if (msg) {
+                    ;
+                    spinner._lastMessage = msg;
+                }
+                originalMessage(msg);
+            };
+            const originalStart = spinner.start.bind(spinner);
+            spinner.start = (msg) => {
+                if (msg) {
+                    ;
+                    spinner._lastMessage = msg;
+                }
+                originalStart(msg);
+            };
+        }
+    }
     /**
      * Retrieves and flushes all user feedback messages accumulated during execution.
      *

package/dist/services/agent/slashCommands.js

@@ -27,7 +27,7 @@ export async function handleSlashCommand(command, context) {
     if (lowerCommand === '/config-key') {
         const creds = await loadCredentials();
         const action = await p['select']({
-            message: 'BYOK (Bring Your Own Key) Configuration',
+            message: 'BYOK (Bring Your Own Key) Configuration — Google AI Studio keys only',
             options: [
                 { value: 'status', label: 'Status' },
                 { value: 'toggle', label: creds.useByok ? 'Disable BYOK' : 'Enable BYOK' },
@@ -47,7 +47,7 @@ export async function handleSlashCommand(command, context) {
         }
         else if (action === 'set') {
             const key = await p['text']({
-                message: 'Enter your Gemini API Key:',
+                message: 'Enter your Google AI Studio API Key (aistudio.google.com):',
                 validate: (value) => (value ? undefined : 'API Key is required'),
             });
             if (key && typeof key === 'string') {
@@ -64,6 +64,8 @@ export async function handleSlashCommand(command, context) {
     }
     if (lowerCommand === '/paste') {
         p.log.info(pc.cyan('Paste mode activated. Paste your text below, then press Ctrl+D on an empty line to submit. (Ctrl+C to cancel)'));
+        // Add space at the bottom to prevent terminal UI flickering when the cursor is at the absolute bottom
+        process.stdout.write('\n\n\n\x1b[3A');
         try {
             const content = await readPaste();
             if (content === null) {
@@ -105,31 +107,43 @@ export async function handleSlashCommand(command, context) {
     }
     if (lowerCommand === '/models') {
         const currentModel = getGlobalActiveModel();
+        const byokEnabled = await isByokEnabled();
+        const options = [
+            // {
+            //   value: 'claude-opus-5',
+            //   label: 'Claude 5 Opus',
+            //   hint: 'For hardcore & complex problems',
+            // },
+            {
+                value: 'gemini-3.1-pro-preview',
+                label: 'Gemini 3.1 Pro',
+                hint: 'For hardcore & complex problems',
+            },
+            // {
+            //   value: 'claude-sonnet-5',
+            //   label: 'Claude 5 Sonnet',
+            //   hint: 'Best for raw speed and cost efficiency',
+            // },
+            {
+                value: 'gemini-3.6-flash',
+                label: 'Gemini 3.6 Flash',
+                hint: 'Balanced performance & fast',
+            },
+            {
+                value: 'gemini-3.5-flash-lite',
+                label: 'Gemini 3.5 Flash-Lite',
+                hint: 'Best for raw speed and cost efficiency',
+            },
+            {
+                value: 'auto',
+                label: 'Auto (Flash-Lite / Flash)',
+                hint: 'Dynamically routes between Gemini 3.5 Flash-Lite and Gemini 3.6 based on prompt complexity',
+            },
+        ].filter(o => !(byokEnabled && o.value.includes('claude')));
         const selectedModel = await p['select']({
             message: `Select AI Model (Current: ${pc.cyan(currentModel)})`,
             initialValue: currentModel,
-            options: [
-                {
-                    value: 'gemini-3.1-pro-preview',
-                    label: 'Gemini 3.1 Pro',
-                    hint: 'For hardcore & complex problems',
-                },
-                {
-                    value: 'gemini-3.6-flash',
-                    label: 'Gemini 3.6 Flash',
-                    hint: 'Balanced performance & fast',
-                },
-                {
-                    value: 'gemini-3.5-flash-lite',
-                    label: 'Gemini 3.5 Flash-Lite',
-                    hint: 'Best for raw speed and cost efficiency',
-                },
-                {
-                    value: 'auto',
-                    label: 'Auto (Flash-Lite / Flash)',
-                    hint: 'Dynamically routes between Gemini 3.5 Flash-Lite and Gemini 3.6 based on prompt complexity',
-                },
-            ],
+            options: options,
         });
         if (!p.isCancel(selectedModel)) {
             chat.setModel(selectedModel);
@@ -196,7 +210,7 @@ export async function handleSlashCommand(command, context) {
         const autoApprove = getApprovalMode() === 'skip-all' ? 'Enabled' : 'Disabled';
         const subAgents = isSubAgentsEnabled() ? 'Enabled' : 'Disabled';
         const planMode = context.isPlanMode ? 'Enabled' : 'Disabled';
-        const byokEnabled = await isByokEnabled() ? 'Enabled' : 'Disabled';
+        const byokEnabled = (await isByokEnabled()) ? 'Enabled' : 'Disabled';
         p.log.step(pc.magenta('📊 Session Statistics & Status'));
         console.log(pc.dim('----------------------------------------'));
         console.log(`${pc.bold('AI Model:')}         ${pc.cyan(displayModel)}`);
@@ -218,7 +232,7 @@ export async function handleSlashCommand(command, context) {
             try {
                 const fs = await import('node:fs');
                 const path = await import('node:path');
-                const stat = fs.statSync(path.join(workspaceRoot, '.minovativemind', 'context_cache.json'));
+                const stat = await fs.promises.stat(path.join(workspaceRoot, '.minovativemind', 'context_cache.json'));
                 contextSizeKB = (stat.size / 1024).toFixed(1);
             }
             catch (e) { }
@@ -287,6 +301,26 @@ export async function handleSlashCommand(command, context) {
         if (context.chatSessionState?.totalTokens > 0) {
             console.log(`${pc.bold('Session Total:')}    ${context.chatSessionState.totalTokens.toLocaleString()} tokens`);
         }
+        if (context.chatSessionState?.totalCreditsUsed > 0) {
+            console.log(`${pc.bold('Session Credits:')}  ${context.chatSessionState.totalCreditsUsed.toLocaleString()} credits`);
+        }
+        try {
+            const { chatHistoryService } = await import('../chatHistoryService.js');
+            const sessions = chatHistoryService.getSessions() || [];
+            let allTimeTokens = 0;
+            let allTimeCredits = 0;
+            for (const s of sessions) {
+                allTimeTokens += s.totalTokens || 0;
+                allTimeCredits += s.totalCreditsUsed || 0;
+            }
+            if (allTimeTokens > 0) {
+                console.log(`${pc.bold('All-Time Tokens:')}  ${allTimeTokens.toLocaleString()} tokens`);
+            }
+            if (allTimeCredits > 0) {
+                console.log(`${pc.bold('All-Time Credits:')} ${allTimeCredits.toLocaleString()} credits`);
+            }
+        }
+        catch (e) { }
         console.log(pc.dim('----------------------------------------\n'));
         return { shouldContinue: true };
     }
@@ -399,6 +433,7 @@ export async function handleSlashCommand(command, context) {
         const options = [{ value: 'new', label: 'New Chat' }];
         if (hasSessions) {
             options.push({ value: 'resume', label: 'View Chats' });
+            options.push({ value: 'rename', label: 'Rename Chat' });
             options.push({ value: 'delete', label: 'Delete Chat' });
             options.push({ value: 'bulk-delete', label: 'Bulk Delete Chats' });
         }
@@ -422,6 +457,7 @@ export async function handleSlashCommand(command, context) {
                 chatSessionState.totalTokens = 0;
                 chatSessionState.totalInputTokens = 0;
                 chatSessionState.totalOutputTokens = 0;
+                chatSessionState.totalCreditsUsed = 0;
                 chat.setSessionInfo(chatSessionState.id, workspaceRoot);
             }
             process.stdout.write('\x1B[2J\x1B[3J\x1B[H'); // Hard clear screen and scrollback
@@ -436,7 +472,7 @@ export async function handleSlashCommand(command, context) {
         const { workspaceRegistry } = await import('../workspaceRegistry.js');
         const sessionOptions = sessions
             .slice()
-            .reverse()
+            .sort((a, b) => (b.timestamp || 0) - (a.timestamp || 0))
             .map((s) => {
             const externalWorkspaces = new Set();
             if (s.history) {
@@ -478,6 +514,9 @@ export async function handleSlashCommand(command, context) {
             }
             const session = sessions.find((s) => s.id === selectedSessionId);
             if (session) {
+                // Update timestamp so it becomes the most recently used session
+                session.timestamp = Date.now();
+                await chatHistoryService.saveSession(session);
                 chat.loadRawHistory([...session.history]);
                 if (chatSessionState) {
                     chatSessionState.id = session.id;
@@ -485,6 +524,7 @@ export async function handleSlashCommand(command, context) {
                     chatSessionState.totalTokens = session.totalTokens || 0;
                     chatSessionState.totalInputTokens = session.totalInputTokens || 0;
                     chatSessionState.totalOutputTokens = session.totalOutputTokens || 0;
+                    chatSessionState.totalCreditsUsed = session.totalCreditsUsed || 0;
                     chatSessionState.latestUsageMetadata = session.latestUsageMetadata;
                     chatSessionState.previousUsageMetadata = session.previousUsageMetadata;
                     chatSessionState.modelUsageCounts = session.modelUsageCounts || {};
@@ -583,6 +623,9 @@ export async function handleSlashCommand(command, context) {
                         : '';
                     p.log.info(`${pc.dim('Session Token Usage:')} ${pc.cyan(session.totalTokens.toLocaleString() + ' total tokens')}${pc.dim(inputStr)}`);
                 }
+                if (session.totalCreditsUsed !== undefined && session.totalCreditsUsed > 0) {
+                    p.log.info(`${pc.dim('Session Credits Used:')} ${pc.cyan(session.totalCreditsUsed.toLocaleString())}`);
+                }
                 if (session.gitBranch) {
                     p.log.info(`${pc.dim('Last Active Branch:')} ${pc.cyan(session.gitBranch)}`);
                 }
@@ -594,6 +637,36 @@ export async function handleSlashCommand(command, context) {
                 console.log(pc.dim('\nType your coding request below. Type "exit" or "quit" to leave.\n'));
             }
         }
+        else if (chatsMenu === 'rename') {
+            const selectedSessionId = await p['select']({
+                message: 'Select a session to rename:',
+                options: [...sessionOptions, { value: 'cancel', label: 'Cancel' }],
+            });
+            if (p.isCancel(selectedSessionId) || selectedSessionId === 'cancel') {
+                return { shouldContinue: true };
+            }
+            const targetSession = sessions.find((s) => s.id === selectedSessionId);
+            if (!targetSession) {
+                p.log.error('Session not found.');
+                return { shouldContinue: true };
+            }
+            const newTitleInput = await p['text']({
+                message: 'Enter new session title:',
+                initialValue: targetSession.title,
+                placeholder: 'e.g. Refactoring Auth Module',
+                validate: (value) => (value && value.trim().length > 0 ? undefined : 'Title cannot be empty'),
+            });
+            if (p.isCancel(newTitleInput)) {
+                p.log.warn('Rename canceled.');
+                return { shouldContinue: true };
+            }
+            const trimmedTitle = newTitleInput.trim();
+            await chatHistoryService.updateSessionTitle(selectedSessionId, trimmedTitle);
+            if (chatSessionState && chatSessionState.id === selectedSessionId) {
+                chatSessionState.title = trimmedTitle;
+            }
+            p.log.success(`Session renamed to: "${trimmedTitle}"`);
+        }
         else if (chatsMenu === 'delete') {
             const selectedSessionId = await p['select']({
                 message: 'Select a session to delete:',
@@ -618,7 +691,10 @@ export async function handleSlashCommand(command, context) {
         else if (chatsMenu === 'bulk-delete') {
             const selectedIds = await p['multiselect']({
                 message: 'Select chat sessions to delete:',
-                options: sessions.map((s) => ({
+                options: sessions
+                    .slice()
+                    .sort((a, b) => (b.timestamp || 0) - (a.timestamp || 0))
+                    .map((s) => ({
                     value: s.id,
                     label: `${truncate(s.title, 50)} (${new Date(s.timestamp).toLocaleString()})`,
                 })),
@@ -927,7 +1003,7 @@ ${diffOut}
         const creds = await loadCredentials();
         const byokEnabled = !!(creds.useByok && creds.geminiApiKey);
         const action = await p['select']({
-            message: `API Key Configuration (Current Mode: ${byokEnabled ? pc.green('BYOK') : pc.yellow('Credits')})`,
+            message: `API Key Configuration — Google AI Studio keys only (Current Mode: ${byokEnabled ? pc.green('BYOK') : pc.yellow('Credits')})`,
             options: [
                 { value: 'toggle', label: byokEnabled ? 'Disable BYOK (Use Credits)' : 'Enable BYOK (Use API Key)' },
                 { value: 'set', label: 'Set/Update API Key' },

package/dist/services/agent/syntaxAgent.d.ts

@@ -1,6 +1,7 @@
 /**
  * Validates file content and attempts to fix syntax errors.
  * Uses GEMINI_MODELS.FLASH to perform language-agnostic syntax repair.
+ * Utilizes local validation error context and windowed snippet repair for large files.
  *
  * @param content The file content to validate.
  * @param filePath The path of the file being validated.
@@ -8,3 +9,42 @@
  * @returns The fixed content, or undefined if it was completely valid or couldn't be fixed.
  */
 export declare function validateAndFixSyntax(content: string, filePath: string, error?: string): Promise<string | undefined>;
+export interface AIFuzzyMatchOptions {
+    /** Optional custom Gemini model override. Defaults to GEMINI_MODELS.FLASH. */
+    model?: string;
+    /** Whether to validate and fix syntax on the updated content. Defaults to true. */
+    validateSyntax?: boolean;
+}
+export interface AIFuzzyMatchResult {
+    /** Indicates whether the fuzzy search matching and edit application succeeded. */
+    success: boolean;
+    /** The updated file content after applying the replacement if successful. */
+    content?: string;
+    /** Error description if matching or edit application failed. */
+    error?: string;
+}
+/**
+ * Performs AI-assisted fuzzy search matching and edit application using Gemini Flash.
+ * Invoked when deterministic local fuzzy matchers fail to locate a search target block
+ * due to whitespace variations, formatting shifts, comment differences, or minor code drift.
+ *
+ * @param fileContent The current full file content.
+ * @param searchContent The search target block that local matchers failed to locate.
+ * @param replaceContent The replacement text block to insert in place of the target block.
+ * @param filePath The path of the file being edited (used for syntax and language context).
+ * @param options Optional configuration including custom model or syntax validation toggles.
+ * @returns A promise resolving to an AIFuzzyMatchResult.
+ */
+export declare function aiFuzzyMatch(fileContent: string, searchContent: string, replaceContent: string, filePath: string, options?: AIFuzzyMatchOptions): Promise<AIFuzzyMatchResult>;
+/**
+ * Convenience wrapper around aiFuzzyMatch that returns the updated file content string if successful,
+ * or undefined if fuzzy matching and replacement failed.
+ *
+ * @param fileContent The current full file content.
+ * @param searchContent The search target block that local matchers failed to locate.
+ * @param replaceContent The replacement text block to insert in place of the target block.
+ * @param filePath The path of the file being edited.
+ * @param options Optional configuration options.
+ * @returns The updated file content string if successful, or undefined if failed.
+ */
+export declare function aiFuzzySearchAndReplace(fileContent: string, searchContent: string, replaceContent: string, filePath: string, options?: AIFuzzyMatchOptions): Promise<string | undefined>;