minovative-mind-cli 2.14.1 → 2.14.2

package/README.md

@@ -7,7 +7,7 @@ and hope for the best.
 
 This CLI does the opposite — it uses a custom built agentic system called,
 **Precision-Context Verification (PCV)** engine to feed lightweight Flash models
-exactly the right context via **AST-level targeted reads** and **2-tier context compression**, execute code, verify compilation, execute Property-Based Testing (PBT) suites and diff-scoped mutation audits, and self-correct (if it even needs to), until
+exactly the right context via **3-tier IR/graph context ranking**, **AST-level targeted reads**, and **asymmetric outline injection**, execute code, verify compilation, execute Property-Based Testing (PBT) suites and diff-scoped mutation audits, and self-correct (if it even needs to), until
 the build/performance metrics are green.
 
 > The result: **Genuine Pro reasoning accuracy at Flash-level speed and efficiency.**
@@ -20,6 +20,7 @@ the build/performance metrics are green.
 [![License](https://img.shields.io/npm/l/minovative-mind-cli.svg)](https://github.com/quarantiine/minovative-mind-cli/blob/main/LICENSE.md)
 
 - Official Website: [Main Website](https://www.minovativemind.dev/)
+- Pricing & BYOK: [Pricing](https://www.minovativemind.dev/pricing)
 - Latest Updates: [Updates](https://www.minovativemind.dev/updates)
 
 ---
@@ -38,13 +39,23 @@ npm install -g minovative-mind-cli
 npm install -g minovative-mind-cli
 ```
 
-Create a free account at [minovativemind.dev](https://www.minovativemind.dev),
-then:
+### 1. Subscribe to BYOK ($3.99/mo)
+
+Minovative Mind CLI operates on a transparent Bring Your Own Key (BYOK) subscription for **$3.99/month** with **0% token markup**.
+
+- Subscribe at [minovativemind.dev/pricing](https://www.minovativemind.dev/pricing)
+- 🎉 **Launch Special**: Use promo code **`MMCLI`** at checkout for **1 Month 100% Free** (limited to the first 1,000 developers).
+
+### 2. Get your Google AI Studio API Key
+
+- Generate your free or paid API key at [Google AI Studio](https://aistudio.google.com).
+
+### 3. Login & Start Coding
 
 ```bash
-minovative-mind-cli login   # One-click GitHub sign-in
+minovative-mind-cli login   # One-click GitHub or Google sign-in with your subscribed account
 cd your-project
-minovative-mind-cli chat    # Start coding
+minovative-mind-cli chat    # Start coding (set your key when prompted or via /config-key)
 ```
 
 Works in any terminal — SSH, Docker, CI pipelines, Vim, Windows Command Prompt, PowerShell, anywhere Node runs.
@@ -92,7 +103,7 @@ minovative-mind-cli eval -i test_instances.jsonl -o predictions.jsonl -r evaluat
 minovative-mind-cli eval -i instances.jsonl --repo astropy/astropy --concurrency 2
 ```
 
-> **Token Economics & Efficiency**: With AST-level symbol chunking (`targetElements`), SHA-256 context caching, and in-place historical tool response pruning, benchmark evaluations achieve up to **85%–95% lower token usage per instance**, eliminating token-per-minute (TPM) rate limit thrashing while preserving deep reasoning fidelity.
+> **Token Economics & Efficiency**: With deterministic 3-tier IR context ranking, AST-level symbol chunking (`targetElements`), asymmetric outline injection, SHA-256 context caching, and in-place historical tool response pruning, benchmark evaluations achieve up to **85%–95% lower token usage per instance**, eliminating token-per-minute (TPM) rate limit thrashing while preserving deep reasoning fidelity.
 
 ---
 
@@ -118,39 +129,31 @@ Gemini 3.x models support native provider-level reasoning control via `thinking_
 
 _(Note: Internal `Minimal` reasoning is strictly reserved for lightweight background micro-agents and is excluded from user-facing selection to ensure optimal coding performance.)_
 
-### BYOK (Bring Your Own Key)
-
-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.
+### 🔑 BYOK (Bring Your Own Key) All-Access
 
-- **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).
+Minovative Mind CLI operates exclusively on a **Bring Your Own Key (BYOK)** model ($3.99/month flat developer subscription with **zero token markups**):
 
-### Auxiliary Model Routing Defaults & Reasoning Invariants
+- **Wholesale AI Pricing:** You pay Google AI Studio directly at pure wholesale rates (or $0 on their generous free tier) with no middleman markup or expiring credit packs.
+- **Supported Provider:** **Only API keys from [Google AI Studio](https://aistudio.google.com) are supported** (all Gemini 3.x Flash, Pro, Lite, Thinking, and Experimental models). Vertex AI, OpenAI, and Anthropic keys are not compatible.
+- **Secure Keychain Storage:** Your API key is encrypted and stored locally in your operating system keychain (`keytar` / local secure storage) and is never sent to Minovative Mind servers.
+- **Configuration:** Set or update your key anytime in the chat session via `/config-key`.
+- **Error Handling:** If your key is invalid, expired, or you hit rate limits, the CLI will report a `BYOK AI Error`. Check your key and quota status in the [Google AI Studio dashboard](https://aistudio.google.com).
 
-Background tasks automatically route to dedicated auxiliary models with native `responseSchema` constraints, AST symbol extractors, persistent caches, and deterministic reasoning invariants for optimal latency, cost efficiency, and structured output reliability:
+### 🧠 Adaptive Persona & Pair Programming Memory Bank
 
-- **Intent Routing (`routeIntent`)**: `Gemini 3.7 Flash` (Temp 0, native `responseSchema`, `MINIMAL` invariant) — permissive zero-temperature classification into `SEARCH` vs `SKIP` and `CHAT` vs `EXECUTE` with resilient fallback to repository exploration.
-- **Complexity Evaluators (`evaluateInvestigationComplexity`)**: `Gemini 3.7 Flash` (Temp 0, native `responseSchema`, `MINIMAL` invariant) — permissive parallel domain partitioning, global override detection, primary sub-path auto-focusing, and dynamic agent assignment recovery.
-- **Context Compressor & Caching**: `Gemini 3.7 Flash` (Temp 0.2, `MINIMAL` invariant) — surgical code distillation for files exceeding 2,000 characters backed by a persistent 2-tier SHA-256 disk cache (`context_cache.json`) capped at 5MB LRU. Files under 2,000 characters retain 100% full fidelity without compression overhead.
-- **AST Symbol Extraction & Targeted Reads**: Polyglot AST declaration extractor (`symbolExtractor.ts`) enabling granular `targetElements` symbol chunking in `read_file`, slashing input token bloat by up to 85%–95%.
-- **In-Place Tool History Pruning**: Active working memory management preserving raw workspace file blocks while compacting historical command/test outputs across multi-turn reasoning loops.
-- **Session Titling**: `Gemini 3.7 Flash` (Temp 0.7, native `responseSchema`, `MINIMAL` invariant) — automated concise chat session titling.
-- **Semantic Cache Classifier**: `Gemini 3.5 Flash Lite` (Temp 0, native `responseSchema`, `MINIMAL` invariant) — intent and topic classification for cache hits.
-- **History Summarizer**: `Gemini 3.7 Flash` (Temp 0.2, `MINIMAL` invariant) — 3-part structured conversation compression preserving recent history.
-- **Commit Generator**: `Gemini 3.5 Flash Lite` (`MINIMAL` invariant) — conventional commit message synthesis.
-- **Micro-Agent Safety Invariants & Normalization**: All internal background micro-agents enforce a hardcoded `MINIMAL` invariant to guarantee zero-latency execution without conversational token burn. The generation pipeline's `normalizeGenerationConfig` automatically strips unsupported internal minimal payloads before dispatching to Google's API, preventing `400 Bad Request` schema errors while ensuring user-selected thinking levels never pollute lightweight background micro-agents.
-- **Subsystem Reasoning Budgets**: Orchestrated subsystems maintain tailored reasoning allocations: **PM Kernel Task Decomposition** operates at `HIGH` reasoning depth for optimal topological dependency sorting; **Investigation & Context Sub-Agents** dynamically inherit your configured model thinking level (default: `MEDIUM`) for comprehensive repository reconnaissance; **Syntax Repair Agents** operate at `LOW` reasoning depth for precise AST corrections; and **Execution Sub-Agents / Main Agent** dynamically inherit your configured model thinking level (`LOW` | `MEDIUM` | `HIGH`).
+Minovative Mind CLI continuously adapts to your unique developer personality and working habits without adding latency or telemetry bloat:
 
-> You pay for auxiliary model background AI operations and for your selected model during chat and code execution. Use `/debug` to inspect real-time routing diagnostics.
-
----
+- **Conversational Wavelength & Pairing Dynamics:** Learns your relationship model (collaborative peer vs. direct operator), banter and humor affinity, speech formality, apology tolerance, and conversational quirks (e.g. catchphrases like _"lgtm"_ and _"ship it"_).
+- **Cognitive & Decision Spectrums:** Adapts to your architectural preferences (top-down vs. bottom-up), decision autonomy, risk tolerance, and debugging style.
+- **Zero-Latency Flash-Lite Profiling:** A dedicated background `gemini-3.5-flash-lite` agent classifies turns and reconciles behavioral drift asynchronously.
+- **100% Client-Side Privacy:** Stored globally at `~/.minovativemind/user_profile.json` (`0600` permissions), never synced to cloud databases, and fully manageable via `/profile`.
 
 ## Session Commands
 
 | Command         | What it does                                                                                                                                    |
 | --------------- | ----------------------------------------------------------------------------------------------------------------------------------------------- |
 | `/config-key`   | Configure custom Google AI Studio API key (BYOK mode)                                                                                           |
-| `/profile`      | View, inspect, delete, or reset global adaptive persona memory and AI side-notes                                                                |
+| `/profile`      | View, inspect, delete, or reset global adaptive persona memory, pairing dynamics, and AI side-notes                                             |
 | `/models`       | Hot-swap the active model or configure its native reasoning thinking level (`Low`, `Medium`, `High`)                                            |
 | `/paste`        | Multi-line input mode (cancel with Ctrl+C)                                                                                                      |
 | `/clear`        | Clear conversation history                                                                                                                      |
@@ -166,10 +169,6 @@ Background tasks automatically route to dedicated auxiliary models with native `
 
 ---
 
-## 🏷️ @ Context Mentions & Interactive Autocomplete
-
-Minovative Mind CLI features real-time, interactive **@ Context Mentions** directly in your terminal prompt. Type `@` anywhere while writing a prompt to trigger fuzzy-filtered autocomplete and inject targeted codebase context, AST symbols, Git status/diffs, diagnostics, or cross-workspace files directly into the model's reasoning loop without manual copy-pasting or extra discovery tool turns.
-
 ### Interactive Autocomplete & Keyboard Navigation
 
 When typing `@`, the interactive terminal autocomplete popup immediately renders:
@@ -200,31 +199,12 @@ When typing `@`, the interactive terminal autocomplete popup immediately renders
 | `@<alias>/<path>`                        | `[ws]`              | **Cross-Workspace File** | Injects file contents from registered external workspaces (e.g. `@backend/src/routes.ts` or `@frontend/src/App.tsx`).                                              |
 | `@<alias>`                               | `[ws]`              | **Workspace Summary**    | Injects configuration, manifest overview, and path details for a registered external workspace.                                                                    |
 
-### Visual Terminal Indicators & Status Tracking
-
-When a prompt with `@` context mentions is submitted, the CLI provides real-time, high-contrast visual confirmation indicators in the terminal:
-
-- **Success Indicators (`✔`)**: High-contrast green checkmark with dim status summary confirming successful extraction (e.g. `✔ Context @src/index.ts:1-25 (lines 1-25, 420 chars)`, `✔ Context @symbol:startServer (src/index.ts, 12 lines)`, `✔ Context @git:status (short status, clean)`, `✔ Context @diagnostics (syntax scan clean)`, `✔ Context @terminal (Darwin arm64, node v20.x)`, `✔ Context @backend (external workspace)`).
-- **Failure Indicators (`✖`)**: Clear red indicator with explicit error reasoning when resolution fails (e.g. `✖ Context @missing.ts (File does not exist)`, `✖ Context @symbol:unknownFunc (Could not find declaration for symbol)`).
-- **Structured Metadata Status Tracking**: Every resolved mention produces a rich `metadata` envelope (capturing line counts, char counts, symbol kind, git diff stats, and syntax scan metrics) powering both visual indicators and token-budgeted prompt injection.
-
-### Context Resolution & Safety Architecture
-
-- **Token Budgeting & Safety Allocation**: All parsed mentions are resolved into structured XML blocks (`<context_mentions>`) wrapped in CDATA sections with strict token budgeting and prompt injection defenses.
-- **Read-Guard Pre-Registration (`fileReadGuard`)**: Files referenced via `@` mentions are automatically registered in the system's `fileReadGuard`. This allows the AI agent to immediately invoke file modifications (`modify_file`, `write_file`) without redundant `read_file` roundtrips, accelerating execution speed.
-- **Multi-Workspace Path Resolution**: Automatically validates boundaries across registered workspaces via `resolveAndValidateMultiWorkspacePath`, preventing directory traversal escapes (`../`).
-
 ---
 
 ## 🌐 Multi-Workspace, Sub-Path Focusing & Security Guardrails
 
 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`).
 
-- **Primary Sub-Path Auto-Focusing & Global Override Detection**: Workspaces can designate a default primary sub-path (e.g. `src/` or `packages/core`), automatically scoping file operations and context turns without repetitive prefixing. If global override search phrases (e.g., "across the codebase", "entire project", "global", "end to end") or root monorepo configurations are detected, sub-path auto-focusing is dynamically bypassed to evaluate the entire repository.
-- **Multi-Workspace Path Security Boundaries**: Strictly enforces workspace and profile containment via `resolveAndValidateMultiWorkspacePath`, preventing directory traversal (`../`), null-byte injections (`\0`), and absolute path escapes.
-- **Canonical Lock Path Resolution in Scoped Tool Execution**: In parallel multi-agent workflows (MMAAK), file mutation tools automatically resolve relative paths, auto-focused sub-paths, and `@alias/` cross-repo prefixes to canonical absolute filesystem paths before acquiring mutexes in `FileLockRegistry`, preventing race conditions and lock collisions across concurrent agents.
-- **Cross-Repo Coordination**: Prefix file paths with `@alias/` (e.g., `@backend/src/api.ts` and `@frontend/src/App.tsx`) to investigate, refactor, and coordinate changes across your entire stack in a single prompt. The terminal highlights cross-workspace actions with a blue `[alias]` visual tag. Use `/workspaces` to create profiles, link sub-workspaces, or switch active environments.
-
 ---
 
 ## 🌐 Supported Languages
@@ -248,13 +228,13 @@ However, the PCV engine features deep, context-aware analysis across **12 major
 | **Swift**                    | `.swift`                                     |         ✅         |       ✅       |          ❌          |         ❌         |
 | **Dart**                     | `.dart`                                      |         ✅         |       ✅       |          ❌          |         ❌         |
 
-_⚠️\*Support is limited or requires custom local system tooling/environment setup._
+_⚠️\*Support is limited or requires custom local system tooling/environment setup from the developer's end._
 
 ### Why do some features only support specific languages?
 
 1. **Dependency Tracing & AST Symbol Extraction:** Fully supported across major language families. It uses lightning-fast static regex pattern matching and AST outline parsers to resolve local import structures, extract targeted symbol definitions (`targetElements`), and determine the "blast radius" of code changes without requiring heavy 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 & Property-Based Probing:** 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.
+3. **Ephemeral Analysis & Property-Based Probing:** 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. Features direct binary subprocess spawning without shell overhead, zero-disk stdin streaming for interpreted scripts, per-workspace LRU environment caching, 1:1 stack trace line preservation, and dedicated FD-3 out-of-band telemetry streaming for high-precision diagnostic and property-based verification tools (`run_debug_script`, `run_fuzz_probe`, `check_heap_delta`, `check_behavioral_drift`).
 
 ---
 
@@ -262,7 +242,8 @@ _⚠️\*Support is limited or requires custom local system tooling/environment
 
 During heavy, multi-turn AI agent sessions, Minovative Mind CLI includes built-in architectural optimizations to eliminate IDE lag, CPU spikes, and dev-server interference:
 
-- **Ephemeral Scratch Isolation (`os.tmpdir()`)**: Diagnostic probes, validation scripts, and benchmark tests execute in a sandboxed OS temp directory (`os.tmpdir()`) rather than writing disposable files into your workspace root. This prevents file watcher churn (`fsevents`, `inotify`), avoids Language Server Protocol (LSP) re-indexing storms (TSServer, Pyright, rust-analyzer), and prevents running dev servers (Vite, Turbopack, Nodemon) from triggering unneeded full-page reloads.
+- **Ephemeral Scratch Isolation (`os.tmpdir()`) & Zero-Disk Stdin Streaming**: Diagnostic probes, validation scripts, and benchmark tests execute via direct subprocess spawning with zero-disk stdin streaming (for Node.js, Python, Bash, Ruby, and PHP) or within a sandboxed OS temp directory (`os.tmpdir()`) rather than writing disposable files into your workspace root. This prevents file watcher churn (`fsevents`, `inotify`), avoids Language Server Protocol (LSP) re-indexing storms (TSServer, Pyright, rust-analyzer), and prevents running dev servers (Vite, Turbopack, Nodemon) from triggering unneeded full-page reloads.
+- **Per-Workspace LRU Environment Caching & Out-of-Band FD-3 Telemetry**: The sandboxed execution engine caches runner binaries, virtual environments, and module types in an LRU cache (30s TTL) to minimize process startup latency, while streaming structured `emitResult` telemetry over a dedicated FD 3 pipe (`stdio: ['pipe', 'pipe', 'pipe', 'pipe']`) without polluting console standard output or altering 1:1 stack trace line numbers.
 - **Automatic IDE Watcher Exclusions (`.vscode/settings.json`)**: On session startup, the CLI automatically and non-destructively ensures that `.minovativemind/**`, `.tmp/**`, and `scratch/**` are added to `files.watcherExclude` and `search.exclude`. This stops IDE background processes from burning CPU on internal telemetry, chat session logs, and cache files.
 - **Clean Git Status Synchronization**: The CLI automatically ensures `.minovativemind/`, `.tmp/`, and `scratch/` are excluded from `.gitignore`, `.dockerignore`, and `.npmignore`, keeping your IDE's Source Control pane fast and responsive.
 - **Terminal Render Efficiency**: For long-running evaluation sweeps (`eval`) or massive test outputs, minimizing the terminal pane or running it in the background pauses Electron/xterm.js GPU canvas repaints and frees up system resources.

package/dist/services/agent/slashCommands.js

@@ -1222,15 +1222,49 @@ Strict Formatting Rules:
                 profile.cognitiveTraits?.delegationDepth ||
                 profile.cognitiveTraits?.debuggingStyle ||
                 profile.cognitiveTraits?.explanationFormat;
+            const hasPersona = profile.conversationalPersona?.relationshipModel ||
+                profile.conversationalPersona?.banterAffinity ||
+                profile.conversationalPersona?.formalityLevel ||
+                profile.conversationalPersona?.apologyTolerance ||
+                profile.conversationalPersona?.stressCadence ||
+                profile.conversationalPersona?.promptingHabit ||
+                (profile.conversationalPersona?.conversationalQuirks &&
+                    profile.conversationalPersona.conversationalQuirks.length > 0);
             const hasStrengths = profile.technicalPreferences?.strengths && profile.technicalPreferences.strengths.length > 0;
             const hasConventions = profile.technicalPreferences?.conventions && profile.technicalPreferences.conventions.length > 0;
             const hasNotes = profile.agentNotes && profile.agentNotes.length > 0;
             console.log(`\n${pc.bold(pc.cyan('🧠 Global Adaptive User Profile & Persona Memory'))}`);
             console.log(`${pc.dim('Storage:')} ${pc.dim(getUserProfilePath())}\n`);
-            if (!hasStyle && !hasCognitive && !hasStrengths && !hasConventions && !hasNotes) {
+            if (!hasStyle && !hasCognitive && !hasPersona && !hasStrengths && !hasConventions && !hasNotes) {
                 p.log.info(pc.yellow('No personalized observations recorded yet. Mino will learn your communication style and preferences organically as you chat.'));
             }
             else {
+                if (hasPersona) {
+                    console.log(pc.bold('Conversational Persona & Teammate Dynamics:'));
+                    if (profile.conversationalPersona?.relationshipModel) {
+                        console.log(`  ${pc.dim('•')} Pairing Dynamic: ${pc.blue(profile.conversationalPersona.relationshipModel)}`);
+                    }
+                    if (profile.conversationalPersona?.banterAffinity) {
+                        console.log(`  ${pc.dim('•')} Banter & Humor: ${pc.blue(profile.conversationalPersona.banterAffinity)}`);
+                    }
+                    if (profile.conversationalPersona?.formalityLevel) {
+                        console.log(`  ${pc.dim('•')} Formality & Demeanor: ${pc.blue(profile.conversationalPersona.formalityLevel)}`);
+                    }
+                    if (profile.conversationalPersona?.apologyTolerance) {
+                        console.log(`  ${pc.dim('•')} Apology Reaction: ${pc.blue(profile.conversationalPersona.apologyTolerance)}`);
+                    }
+                    if (profile.conversationalPersona?.stressCadence) {
+                        console.log(`  ${pc.dim('•')} Stress Cadence: ${pc.blue(profile.conversationalPersona.stressCadence)}`);
+                    }
+                    if (profile.conversationalPersona?.promptingHabit) {
+                        console.log(`  ${pc.dim('•')} Prompting Habit: ${pc.blue(profile.conversationalPersona.promptingHabit)}`);
+                    }
+                    if (profile.conversationalPersona?.conversationalQuirks &&
+                        profile.conversationalPersona.conversationalQuirks.length > 0) {
+                        console.log(`  ${pc.dim('•')} Catchphrases & Quirks: ${pc.blue(profile.conversationalPersona.conversationalQuirks.join(', '))}`);
+                    }
+                    console.log('');
+                }
                 if (hasStyle) {
                     console.log(pc.bold('Communication Style:'));
                     if (profile.communicationStyle?.tonePreference) {

package/dist/services/agent/toolLoop.js

@@ -3,7 +3,7 @@ import * as p from '@clack/prompts';
 import pc from 'picocolors';
 import { debugLog } from '../../utils/logger.js';
 import { executeTool } from '../agent-tools.js';
-import { getPlanExecutionConfig } from '../ai.js';
+import { getPlanExecutionConfig, HISTORICAL_TOOL_OUTPUT_THRESHOLD } from '../ai.js';
 import { routeIntent } from '../contextAgent.js';
 import { requestCommandApproval } from './commandApproval.js';
 import { getMetricCollector, recordRecoveryCircuitBreakerTrip } from '../metrics.js';
@@ -276,6 +276,8 @@ export async function processResponse(chat, result, workspaceRoot, inputHandler,
                 }
             }
         }
+        // Apply in-place history pruning to collapse oversized tool responses older than 1 turn
+        chat.pruneToolOutputHistory(HISTORICAL_TOOL_OUTPUT_THRESHOLD, 1);
         // Feed tool results and potential interruption text back to the model
         let followUp;
         try {

package/dist/services/agent-tools.d.ts

@@ -25,6 +25,8 @@ export interface ToolResult {
         mimeType: string;
         data: string;
     };
+    /** Optional structured JSON result extracted from the script execution. */
+    structuredResult?: unknown;
 }
 /**
  * Returns the list of available function declarations for Gemini function calling.
@@ -138,6 +140,22 @@ export declare function modifyFile(workspaceRoot: string, filePath: string, edit
  * @returns A promise resolving to a {@link ToolResult} containing the formatted tree output.
  */
 export declare function listDirectory(workspaceRoot: string, dirPath: string, maxDepth?: number): Promise<ToolResult>;
+/**
+ * Truncates large string output using bounded head and tail windows with a structured metadata receipt.
+ * Preserves early context (e.g. invocation, build targets) and late context (e.g. error summaries, exit codes)
+ * while bounding total character and line count.
+ *
+ * @param text - The raw output text to truncate.
+ * @param options - Configuration options for character/line limits and custom receipt notices.
+ * @returns The windowed text containing head, structured metadata receipt, and tail.
+ */
+export declare function truncateWithHeadTailWindow(text: string, options?: {
+    maxChars?: number;
+    maxLines?: number;
+    headRatio?: number;
+    receiptLabel?: string;
+    hint?: string;
+}): string;
 /**
  * Condenses verbose command and test failure outputs into high-signal diagnostic error logs
  * with dynamic tail sizing and stack trace boundary snapping.