@tuannvm/gemini-mcp-server 1.0.4 → 1.1.1

package/README.md

@@ -4,28 +4,24 @@
 [![npm downloads](https://img.shields.io/npm/dm/@tuannvm/gemini-mcp-server.svg)](https://www.npmjs.com/package/@tuannvm/gemini-mcp-server)
 [![license](https://img.shields.io/npm/l/@tuannvm/gemini-mcp-server.svg)](https://www.npmjs.com/package/@tuannvm/gemini-mcp-server)
 
-MCP server for Google Gemini CLI integration with large file analysis, web search, multimodal analysis, shell commands, and brainstorming support.
+Give Claude superpowers with Gemini's massive context window. Analyze entire codebases, search the web, process images, and brainstorm ideas—all through MCP.
 
 ```mermaid
 graph LR
     A[Claude Code] --> B[Gemini MCP Server]
-
-    B --> C[ask-gemini]
-    B --> S[search]
+    B --> C[gemini]
+    B --> S[web-search]
     B --> M[analyze-media]
     B --> SH[shell]
     B --> D[brainstorm]
-    B --> E[fetch-chunk]
-    B --> F[ping]
-    B --> G[help]
-
     C --> H[Gemini CLI]
     S --> H
     M --> H
     SH --> H
     D --> H
-    C --> I[Chunk Cache]
-    E --> I
+    H --> E[Extensions]
+    E --> W[Google Workspace]
+    E --> X[Custom Extensions]
 
     style A fill:#FF6B35
     style B fill:#4A90E2
@@ -34,49 +30,39 @@ graph LR
     style M fill:#00D4AA
     style SH fill:#00D4AA
     style D fill:#00D4AA
-    style E fill:#00D4AA
-    style F fill:#00D4AA
-    style G fill:#00D4AA
     style H fill:#4285F4
-    style I fill:#9B59B6
+    style E fill:#FBBC05
+    style W fill:#34A853
+    style X fill:#EA4335
 ```
 
-## Prerequisites
+## Quick Start
 
-- **Google Gemini CLI v0.22.2+** must be pre-installed and configured
-  - Install: `npm install -g @google/gemini-cli`
-  - Authenticate: Run `gemini` and login with Google (free tier: 60 req/min, 1000 req/day)
-  - Or set API key: `export GEMINI_API_KEY="YOUR_API_KEY"`
-  - **Recommended**: Set default model to Gemini 3 Pro (see [Model Configuration](#model-configuration))
-- **Node.js v18+** installed
-- **Claude Code** or compatible MCP client
+### Prerequisites
 
-## Installation
+1. **Install Gemini CLI**: `npm install -g @google/gemini-cli`
+2. **Authenticate**: Run `gemini` and login with Google (free: 60 req/min, 1000 req/day)
+3. **Set default model** (recommended): `export GEMINI_MODEL="gemini-3-pro-preview"`
 
-### One-Click Installation
+### Install
 
-#### VS Code
-[![Install in VS Code](https://img.shields.io/badge/VS_Code-Install_Gemini_MCP_Server-0098FF?style=flat-square&logo=visualstudiocode&logoColor=white)](https://vscode.dev/redirect/mcp/install?name=gemini-cli&config=%7B%22type%22%3A%22stdio%22%2C%22command%22%3A%22npx%22%2C%22args%22%3A%5B%22-y%22%2C%22%40tuannvm%2Fgemini-mcp-server%22%5D%7D)
+#### One-Click
 
-#### VS Code Insiders
-[![Install in VS Code Insiders](https://img.shields.io/badge/VS_Code_Insiders-Install_Gemini_MCP_Server-24bfa5?style=flat-square&logo=visualstudiocode&logoColor=white)](https://insiders.vscode.dev/redirect/mcp/install?name=gemini-cli&config=%7B%22type%22%3A%22stdio%22%2C%22command%22%3A%22npx%22%2C%22args%22%3A%5B%22-y%22%2C%22%40tuannvm%2Fgemini-mcp-server%22%5D%7D)
+[![VS Code](https://img.shields.io/badge/VS_Code-Install-0098FF?style=flat-square&logo=visualstudiocode&logoColor=white)](https://vscode.dev/redirect/mcp/install?name=gemini-cli&config=%7B%22type%22%3A%22stdio%22%2C%22command%22%3A%22npx%22%2C%22args%22%3A%5B%22-y%22%2C%22%40tuannvm%2Fgemini-mcp-server%22%5D%7D)
+[![VS Code Insiders](https://img.shields.io/badge/VS_Code_Insiders-Install-24bfa5?style=flat-square&logo=visualstudiocode&logoColor=white)](https://insiders.vscode.dev/redirect/mcp/install?name=gemini-cli&config=%7B%22type%22%3A%22stdio%22%2C%22command%22%3A%22npx%22%2C%22args%22%3A%5B%22-y%22%2C%22%40tuannvm%2Fgemini-mcp-server%22%5D%7D)
+[![Cursor](https://img.shields.io/badge/Cursor-Install-00D8FF?style=flat-square&logo=cursor&logoColor=white)](https://cursor.com/en/install-mcp?name=gemini-cli&config=eyJ0eXBlIjoic3RkaW8iLCJjb21tYW5kIjoibnB4IC15IEB0dWFubnZtL2dlbWluaS1tY3Atc2VydmVyIiwiZW52Ijp7fX0=)
 
-#### Cursor
-[![Install in Cursor](https://img.shields.io/badge/Cursor-Install_Gemini_MCP_Server-00D8FF?style=flat-square&logo=cursor&logoColor=white)](https://cursor.com/en/install-mcp?name=gemini-cli&config=eyJ0eXBlIjoic3RkaW8iLCJjb21tYW5kIjoibnB4IC15IEB0dWFubnZtL2dlbWluaS1tY3Atc2VydmVyIiwiZW52Ijp7fX0=)
+#### Manual
 
-### Manual Installation
-
-#### Claude Code
 ```bash
+# Claude Code
 claude mcp add gemini-cli -- npx -y @tuannvm/gemini-mcp-server
 ```
 
-#### Claude Desktop
-Add to your Claude Desktop configuration file:
-
-**macOS:** `~/Library/Application Support/Claude/claude_desktop_config.json`
+<details>
+<summary>Claude Desktop</summary>
 
-**Windows:** `%APPDATA%/Claude/claude_desktop_config.json`
+Add to `~/Library/Application Support/Claude/claude_desktop_config.json` (macOS) or `%APPDATA%/Claude/claude_desktop_config.json` (Windows):
 
 ```json
 {
@@ -88,294 +74,84 @@ Add to your Claude Desktop configuration file:
   }
 }
 ```
+</details>
 
-## Usage in Claude Code
+## What You Can Do
 
-Once installed, Claude Code can use these tools:
-
-### `ask-gemini` - File Analysis & Questions
-Analyze files and codebases using Gemini's large context window with the `@` syntax.
-
-**Basic Usage:**
-```
-Use ask-gemini to analyze @src/main.js and explain what it does
-```
-
-**Advanced Usage:**
-```
-# Model selection (defaults to gemini-3-pro-preview)
-Use ask-gemini with model "gemini-3-flash-preview" to quickly summarize @package.json
-
-# Sandbox mode for safe code execution
-Use ask-gemini with sandbox true to test @script.py safely
-
-# Change mode for structured edits
-Use ask-gemini with changeMode true to refactor @src/utils.ts
-```
+| Tool | What it does |
+|------|--------------|
+| **gemini** | Analyze files and codebases with Gemini's 1M+ token context |
+| **web-search** | Search the web with Google Search grounding |
+| **analyze-media** | Process images, PDFs, and screenshots |
+| **shell** | Generate and execute shell commands |
+| **brainstorm** | Creative ideation with structured methodologies |
 
-**Parameters:**
-- `prompt` (required): Your question or analysis request. Use `@` syntax for file references
-- `model` (optional): Model to use (`gemini-3-pro-preview` or `gemini-3-flash-preview`)
-- `sandbox` (optional): Enable sandbox mode for safe execution
-- `changeMode` (optional): Enable structured edit mode for code changes
+## Gemini CLI Extensions
 
-### `search` - Web Search with Google Grounding
-Search the web using Gemini with Google Search grounding for real-time information.
-
-**Basic Usage:**
-```
-Use search to find the latest React 19 features
-```
-
-**Advanced Usage:**
-```
-# Get raw results without summarization
-Use search with query "kubernetes security best practices 2025" and summarize false
-
-# Use specific model
-Use search with query "latest AI news" and model "gemini-3-pro-preview"
-```
-
-**Parameters:**
-- `query` (required): Search query
-- `summarize` (optional): Summarize results (default: true)
-- `model` (optional): Model to use (default: gemini-3-flash-preview for speed)
-
-### `analyze-media` - Multimodal Analysis
-Analyze images, PDFs, screenshots, and diagrams using Gemini's multimodal capabilities.
-
-**Basic Usage:**
-```
-Use analyze-media with filePath "@screenshot.png" and prompt "describe this UI"
-```
+Enable access to Gmail, Drive, Sheets, Docs, Calendar, and more through Gemini CLI extensions.
 
-**Advanced Usage:**
-```
-# Detailed analysis
-Use analyze-media with filePath "@architecture.pdf" and prompt "explain the system design" and detailed true
-
-# Quick analysis with Flash model
-Use analyze-media with filePath "@error.png" and prompt "what's the error?" and model "gemini-3-flash-preview"
-```
-
-**Parameters:**
-- `filePath` (required): Path to media file (use `@` syntax)
-- `prompt` (required): What to analyze or extract
-- `model` (optional): Model to use (default: gemini-3-pro-preview for multimodal)
-- `detailed` (optional): Provide detailed analysis
-
-### `shell` - Shell Command Generation
-Generate and optionally execute shell commands using Gemini.
-
-**Basic Usage:**
-```
-Use shell with task "find all TypeScript files larger than 100KB"
-```
-
-**Advanced Usage:**
-```
-# Dry run (default) - explains commands without executing
-Use shell with task "clean up node_modules and rebuild" and dryRun true
-
-# Execute in sandbox (safe)
-Use shell with task "run the test suite" and dryRun false
-
-# With working directory
-Use shell with task "list all TODO comments" and workingDirectory "@src/"
-```
-
-**Parameters:**
-- `task` (required): Description of the shell task
-- `dryRun` (optional): If true, explains commands without executing (default: true)
-- `workingDirectory` (optional): Working directory for execution
-- `model` (optional): Model to use (default: gemini-3-flash-preview)
-
-### `brainstorm` - Creative Ideation
-Generate ideas using various brainstorming methodologies.
-
-**Basic Usage:**
-```
-Use brainstorm to generate ideas for improving user onboarding
-```
-
-**Advanced Usage:**
-```
-# Specific methodology
-Use brainstorm with methodology "SCAMPER" to improve the checkout flow
-
-# Domain-specific brainstorming
-Use brainstorm with domain "mobile" and ideaCount 10 for app features
-
-# With analysis
-Use brainstorm with includeAnalysis true to evaluate idea feasibility
+```bash
+# Install the Google Workspace extension
+gemini extensions install https://github.com/gemini-cli-extensions/workspace
 ```
 
-**Parameters:**
-- `prompt` (required): The brainstorming topic
-- `methodology` (optional): Framework to use (`divergent`, `convergent`, `SCAMPER`, `design-thinking`, `lateral`, `auto`)
-- `domain` (optional): Domain context for specialized ideas
-- `constraints` (optional): Known limitations or requirements
-- `ideaCount` (optional): Target number of ideas to generate
-- `includeAnalysis` (optional): Include feasibility and impact analysis
-
-### `fetch-chunk` - Retrieve Cached Chunks
-Retrieve cached chunks from large changeMode responses.
+Then use with `yolo: true` to auto-approve extension tool calls:
 
-**Parameters:**
-- `cacheKey` (required): Cache key from previous response
-- `chunkIndex` (required): Chunk index to retrieve (1-based)
-
-### `ping` - Connection Test
-Test if the MCP server is working properly.
-
-### `help` - Gemini CLI Help
-Get information about Gemini CLI capabilities and commands.
-
-## Example Workflows
-
-**Large Codebase Analysis:**
-```
-Use ask-gemini to analyze @. and provide an architecture overview
 ```
+# Search your Google Drive
+Use gemini with yolo=true to search my Google Drive for Q4 reports
 
-**File Comparison:**
-```
-Use ask-gemini to compare @src/old.ts and @src/new.ts and explain the differences
-```
+# Read a Google Sheet
+Use gemini with yolo=true to read the first sheet from "Budget 2025"
 
-**Code Refactoring with Structured Edits:**
-```
-Use ask-gemini with changeMode true to refactor @src/utils.ts for better error handling
+# Access Gmail
+Use gemini with yolo=true to summarize my last 10 unread emails
 ```
 
-**Creative Brainstorming:**
-```
-Use brainstorm with methodology "design-thinking" to improve the user dashboard experience
-```
+> **Note:** Any Gemini CLI extension can be used. Pass the full GitHub URL or local path to `gemini extensions install`.
 
-**Web Research:**
-```
-Use search to find the latest security vulnerabilities in npm packages
-```
+## Examples
 
-**Screenshot Analysis:**
-```
-Use analyze-media with filePath "@error-screenshot.png" and prompt "explain this error and suggest a fix"
 ```
+# Analyze an entire codebase
+Use gemini to analyze @. and provide an architecture overview
 
-**Shell Task Automation:**
-```
-Use shell with task "find all files modified in the last 24 hours" and dryRun false
-```
-
-## Advanced Features
-
-### Large File Handling
-- Gemini's massive context window handles large files that would exceed other models' limits
-- Use `@` syntax to reference files: `@src/main.js`, `@.` (current directory)
-- Automatic chunking for very large responses with cache retrieval
-
-### Change Mode (Structured Edits)
-When `changeMode` is enabled, responses are formatted as structured edits that can be automatically applied:
-- Parses `**FILE: path:line**` format with `OLD/NEW` blocks
-- Chunks large edit responses for manageable processing
-- 10-minute cache TTL for chunk retrieval
-
-### Model Fallback
-- Automatically falls back from `gemini-3-pro-preview` to `gemini-3-flash-preview` when quota is exceeded
-- Transparent retry with status notification
+# Compare files
+Use gemini to compare @src/old.ts and @src/new.ts
 
-### Progress Notifications
-For long-running operations, the server sends `notifications/progress` messages when the client provides a `progressToken`.
+# Search the web
+Use web-search to find the latest React 19 features
 
-## Model Configuration
+# Analyze a screenshot
+Use analyze-media with filePath "@error.png" and prompt "what's this error?"
 
-### Setting the Default Model
-
-You can configure the default Gemini model using three methods (in order of precedence):
-
-**1. Environment Variable (Recommended)**
-```bash
-export GEMINI_MODEL="gemini-3-pro-preview"
+# Brainstorm ideas
+Use brainstorm with methodology "design-thinking" to improve user onboarding
 ```
 
-**2. Settings File**
-
-Create `~/.gemini/settings.json` (user-level) or `.gemini/settings.json` (project-level):
-```json
-{
-  "model": {
-    "name": "gemini-3-pro-preview"
-  }
-}
-```
-
-**3. Command-Line Flag**
-```bash
-gemini -m gemini-3-pro-preview
-```
-
-### Available Models
-
-| Model | ID | Best For |
-|-------|-----|----------|
-| **Gemini 3 Pro** (default) | `gemini-3-pro-preview` | Most capable, complex reasoning |
-| **Gemini 3 Flash** | `gemini-3-flash-preview` | Fast responses, good quality |
-| Gemini 2.5 Flash-Lite | `gemini-2.5-flash-lite` | Fastest, lightweight |
-
-### Configuration Precedence
-
-Settings are applied in order (highest priority last):
-1. Default values
-2. User settings file (`~/.gemini/settings.json`)
-3. Project settings file (`.gemini/settings.json`)
-4. Environment variables (`GEMINI_MODEL`)
-5. Command-line arguments (`-m`)
-6. MCP tool `model` parameter (overrides all)
-
-### Recommended Setup
-
-For best results, set Gemini 3 Pro as your default:
-
-```bash
-# Add to your shell profile (~/.bashrc, ~/.zshrc, etc.)
-export GEMINI_MODEL="gemini-3-pro-preview"
-```
+## Documentation
 
-Or create a user settings file:
-```bash
-mkdir -p ~/.gemini
-echo '{"model": {"name": "gemini-3-pro-preview"}}' > ~/.gemini/settings.json
-```
+- **[API Reference](docs/api-reference.md)** — Full tool parameters and options
+- **[Gemini CLI Integration](docs/gemini-cli-integration.md)** — Setup, models, and troubleshooting
+- **[Documentation Site](https://tuannvm.github.io/gemini-mcp-server/)**
 
 ## Development
 
 ```bash
-# Install dependencies
-npm install
-
-# Development mode
-npm run dev
-
-# Build
-npm run build
+npm install    # Install dependencies
+npm run dev    # Development mode
+npm run build  # Build
+npm test       # Run tests
+```
 
-# Run tests
-npm test
+## Acknowledgments
 
-# Lint and format
-npm run lint
-npm run format
-```
+Inspired by [gemini-mcp-tool](https://github.com/jamubc/gemini-mcp-tool).
 
-## Documentation
+## Related Projects
 
-- [API Reference](docs/api-reference.md)
-- [Gemini CLI Integration](docs/gemini-cli-integration.md)
-- [Full Documentation Site](https://tuannvm.github.io/gemini-mcp-server/)
+- **[codex-mcp-server](https://github.com/tuannvm/codex-mcp-server)** — MCP server for OpenAI Codex CLI with AI-powered code analysis and review
 
 ## License
 
-MIT
-
-**Disclaimer:** This is an unofficial, third-party tool and is not affiliated with, endorsed, or sponsored by Google.
+MIT — This is an unofficial tool, not affiliated with Google.

package/dist/constants.d.ts

@@ -48,6 +48,7 @@ export declare const CLI: {
         readonly SANDBOX: "-s";
         readonly PROMPT: "-p";
         readonly HELP: "-help";
+        readonly YOLO: "--yolo";
     };
     readonly DEFAULTS: {
         readonly MODEL: "default";

package/dist/constants.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"constants.d.ts","sourceRoot":"","sources":["../src/constants.ts"],"names":[],"mappings":"AAAA;;GAEG;AAGH,OAAO,EAAE,aAAa,EAAE,MAAM,EAAE,MAAM,YAAY,CAAC;AAGnD,eAAO,MAAM,UAAU,WAAW,CAAC;AAGnC,eAAO,MAAM,cAAc;;;;;CAOjB,CAAC;AAGX,eAAO,MAAM,eAAe;;;;;;;;;CAUlB,CAAC;AAGX,eAAO,MAAM,QAAQ;;;;;;;;;;;;;;;;;;CAkBX,CAAC;AAGX,eAAO,MAAM,GAAG;;;;;;;;;;;;;;;;CAgBN,CAAC"}
+{"version":3,"file":"constants.d.ts","sourceRoot":"","sources":["../src/constants.ts"],"names":[],"mappings":"AAAA;;GAEG;AAGH,OAAO,EAAE,aAAa,EAAE,MAAM,EAAE,MAAM,YAAY,CAAC;AAGnD,eAAO,MAAM,UAAU,WAAW,CAAC;AAGnC,eAAO,MAAM,cAAc;;;;;CAOjB,CAAC;AAGX,eAAO,MAAM,eAAe;;;;;;;;;CAUlB,CAAC;AAGX,eAAO,MAAM,QAAQ;;;;;;;;;;;;;;;;;;CAkBX,CAAC;AAGX,eAAO,MAAM,GAAG;;;;;;;;;;;;;;;;;CAiBN,CAAC"}

package/dist/constants.js

@@ -54,6 +54,7 @@ export const CLI = {
         SANDBOX: '-s',
         PROMPT: '-p',
         HELP: '-help',
+        YOLO: '--yolo',
     },
     DEFAULTS: {
         MODEL: 'default',

package/dist/constants.js.map

@@ -1 +1 @@
-{"version":3,"file":"constants.js","sourceRoot":"","sources":["../src/constants.ts"],"names":[],"mappings":"AAAA;;GAEG;AAEH,6CAA6C;AAC7C,OAAO,EAAiB,MAAM,EAAE,MAAM,YAAY,CAAC;AAEnD,UAAU;AACV,MAAM,CAAC,MAAM,UAAU,GAAG,QAAQ,CAAC;AAEnC,iBAAiB;AACjB,MAAM,CAAC,MAAM,cAAc,GAAG;IAC5B,cAAc,EAAE,yDAAyD;IACzE,oBAAoB,EAClB,sFAAsF;IACxF,cAAc,EAAE,uBAAuB;IACvC,kBAAkB,EAChB,6IAA6I;CACvI,CAAC;AAEX,kBAAkB;AAClB,MAAM,CAAC,MAAM,eAAe,GAAG;IAC7B,eAAe,EAAE,0DAA0D;IAC3E,WAAW,EAAE,iCAAiC;IAC9C,aAAa,EAAE,oCAAoC;IACnD,iBAAiB,EAAE,iDAAiD;IACpE,eAAe,EAAE,kBAAkB;IACnC,gBAAgB,EACd,+DAA+D;IACjE,mBAAmB,EAAE,uDAAuD;IAC5E,mBAAmB,EAAE,iCAAiC;CAC9C,CAAC;AAEX,yBAAyB;AACzB,MAAM,CAAC,MAAM,QAAQ,GAAG;IACtB,KAAK,EAAE;QACL,IAAI,EAAE,MAAM;QACZ,SAAS,EAAE,WAAW;KACvB;IACD,aAAa,EAAE;QACb,IAAI,EAAE,MAAM;KACb;IACD,MAAM,EAAE;QACN,OAAO,EAAE,SAAS;QAClB,KAAK,EAAE,OAAO;QACd,MAAM,EAAE,QAAQ;QAChB,MAAM,EAAE,QAAQ;KACjB;IACD,aAAa,EAAE;QACb,QAAQ,EAAE,wBAAwB;KACnC;IACD,kBAAkB,EAAE,KAAK;CACjB,CAAC;AAEX,gBAAgB;AAChB,MAAM,CAAC,MAAM,GAAG,GAAG;IACjB,QAAQ,EAAE;QACR,MAAM,EAAE,QAAQ;QAChB,IAAI,EAAE,MAAM;KACb;IACD,KAAK,EAAE;QACL,KAAK,EAAE,IAAI;QACX,OAAO,EAAE,IAAI;QACb,MAAM,EAAE,IAAI;QACZ,IAAI,EAAE,OAAO;KACd;IACD,QAAQ,EAAE;QACR,KAAK,EAAE,SAAS;QAChB,YAAY,EAAE,MAAM;QACpB,aAAa,EAAE,OAAO;KACvB;CACO,CAAC"}
+{"version":3,"file":"constants.js","sourceRoot":"","sources":["../src/constants.ts"],"names":[],"mappings":"AAAA;;GAEG;AAEH,6CAA6C;AAC7C,OAAO,EAAiB,MAAM,EAAE,MAAM,YAAY,CAAC;AAEnD,UAAU;AACV,MAAM,CAAC,MAAM,UAAU,GAAG,QAAQ,CAAC;AAEnC,iBAAiB;AACjB,MAAM,CAAC,MAAM,cAAc,GAAG;IAC5B,cAAc,EAAE,yDAAyD;IACzE,oBAAoB,EAClB,sFAAsF;IACxF,cAAc,EAAE,uBAAuB;IACvC,kBAAkB,EAChB,6IAA6I;CACvI,CAAC;AAEX,kBAAkB;AAClB,MAAM,CAAC,MAAM,eAAe,GAAG;IAC7B,eAAe,EAAE,0DAA0D;IAC3E,WAAW,EAAE,iCAAiC;IAC9C,aAAa,EAAE,oCAAoC;IACnD,iBAAiB,EAAE,iDAAiD;IACpE,eAAe,EAAE,kBAAkB;IACnC,gBAAgB,EACd,+DAA+D;IACjE,mBAAmB,EAAE,uDAAuD;IAC5E,mBAAmB,EAAE,iCAAiC;CAC9C,CAAC;AAEX,yBAAyB;AACzB,MAAM,CAAC,MAAM,QAAQ,GAAG;IACtB,KAAK,EAAE;QACL,IAAI,EAAE,MAAM;QACZ,SAAS,EAAE,WAAW;KACvB;IACD,aAAa,EAAE;QACb,IAAI,EAAE,MAAM;KACb;IACD,MAAM,EAAE;QACN,OAAO,EAAE,SAAS;QAClB,KAAK,EAAE,OAAO;QACd,MAAM,EAAE,QAAQ;QAChB,MAAM,EAAE,QAAQ;KACjB;IACD,aAAa,EAAE;QACb,QAAQ,EAAE,wBAAwB;KACnC;IACD,kBAAkB,EAAE,KAAK;CACjB,CAAC;AAEX,gBAAgB;AAChB,MAAM,CAAC,MAAM,GAAG,GAAG;IACjB,QAAQ,EAAE;QACR,MAAM,EAAE,QAAQ;QAChB,IAAI,EAAE,MAAM;KACb;IACD,KAAK,EAAE;QACL,KAAK,EAAE,IAAI;QACX,OAAO,EAAE,IAAI;QACb,MAAM,EAAE,IAAI;QACZ,IAAI,EAAE,OAAO;QACb,IAAI,EAAE,QAAQ;KACf;IACD,QAAQ,EAAE;QACR,KAAK,EAAE,SAAS;QAChB,YAAY,EAAE,MAAM;QACpB,aAAa,EAAE,OAAO;KACvB;CACO,CAAC"}

package/dist/tools/analyze-media.tool.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"analyze-media.tool.d.ts","sourceRoot":"","sources":["../../src/tools/analyze-media.tool.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,WAAW,EAAE,MAAM,eAAe,CAAC;AA0B5C,eAAO,MAAM,gBAAgB,EAAE,WAuG9B,CAAC"}
+{"version":3,"file":"analyze-media.tool.d.ts","sourceRoot":"","sources":["../../src/tools/analyze-media.tool.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,WAAW,EAAE,MAAM,eAAe,CAAC;AAgC5C,eAAO,MAAM,gBAAgB,EAAE,WAgH9B,CAAC"}

package/dist/tools/analyze-media.tool.js

@@ -6,43 +6,50 @@ const analyzeMediaArgsSchema = z.object({
     filePath: z
         .string()
         .min(1)
-        .describe('Path to the image or PDF file to analyze. Use @ syntax (e.g., @image.png, @document.pdf)'),
+        .describe('Path to the media file to analyze. REQUIRED. Use @ prefix for file reference (e.g., @screenshot.png, @diagram.pdf, @photo.jpg). Supports: PNG, JPG, JPEG, GIF, WebP, PDF. Relative paths work from current working directory.'),
     prompt: z
         .string()
         .min(1)
-        .describe('What to analyze or extract from the media file'),
+        .describe('What to analyze or extract from the media. REQUIRED. Be specific (e.g., "extract all text from this screenshot", "describe the UI components", "summarize this PDF document", "identify objects and their positions").'),
     model: z
         .string()
         .optional()
-        .describe('Model to use (default: gemini-3-pro-preview for multimodal)'),
+        .describe("Gemini model to use. DEFAULT: 'gemini-3-pro-preview' (best multimodal understanding). Use 'gemini-3-flash-preview' for faster but less detailed analysis. Pro recommended for complex images or documents."),
     detailed: z
         .boolean()
         .default(false)
-        .describe('Provide detailed analysis with more context'),
+        .describe('Enable comprehensive analysis mode. DEFAULT: false. Set to true for structured output with overview, key elements, technical details, observations, and recommendations. Use for complex analysis tasks.'),
 });
 export const analyzeMediaTool = {
     name: 'analyze-media',
     description: 'Analyze images, PDFs, or other media files using Gemini multimodal capabilities. Supports screenshots, diagrams, documents, and more.',
     zodSchema: analyzeMediaArgsSchema,
+    annotations: {
+        title: 'Analyze Media',
+        readOnlyHint: true,
+        destructiveHint: false,
+        idempotentHint: false,
+        openWorldHint: true,
+    },
     inputSchema: {
         type: 'object',
         properties: {
             filePath: {
                 type: 'string',
-                description: 'Path to the image or PDF file to analyze. Use @ syntax (e.g., @image.png, @document.pdf)',
+                description: 'Path to the media file to analyze. REQUIRED. Use @ prefix (e.g., @screenshot.png, @diagram.pdf). Supports: PNG, JPG, JPEG, GIF, WebP, PDF.',
             },
             prompt: {
                 type: 'string',
-                description: 'What to analyze or extract from the media file',
+                description: 'What to analyze or extract from the media. REQUIRED. Be specific (e.g., "extract all text", "describe UI components", "summarize document").',
             },
             model: {
                 type: 'string',
-                description: 'Model to use (default: gemini-3-pro-preview for multimodal)',
+                description: "Gemini model to use. DEFAULT: 'gemini-3-pro-preview' (best multimodal). Use 'gemini-3-flash-preview' for faster but less detailed analysis.",
             },
             detailed: {
                 type: 'boolean',
                 default: false,
-                description: 'Provide detailed analysis with more context',
+                description: 'Enable comprehensive analysis mode. DEFAULT: false. Set to true for structured output with overview, key elements, and recommendations.',
             },
         },
         required: ['filePath', 'prompt'],

package/dist/tools/analyze-media.tool.js.map

@@ -1 +1 @@
-{"version":3,"file":"analyze-media.tool.js","sourceRoot":"","sources":["../../src/tools/analyze-media.tool.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AAExB,OAAO,EAAE,cAAc,EAAE,MAAM,6BAA6B,CAAC;AAC7D,OAAO,EAAE,GAAG,EAAE,MAAM,EAAE,cAAc,EAAE,eAAe,EAAE,MAAM,iBAAiB,CAAC;AAC/E,OAAO,EAAE,MAAM,EAAE,MAAM,oBAAoB,CAAC;AAE5C,MAAM,sBAAsB,GAAG,CAAC,CAAC,MAAM,CAAC;IACtC,QAAQ,EAAE,CAAC;SACR,MAAM,EAAE;SACR,GAAG,CAAC,CAAC,CAAC;SACN,QAAQ,CACP,0FAA0F,CAC3F;IACH,MAAM,EAAE,CAAC;SACN,MAAM,EAAE;SACR,GAAG,CAAC,CAAC,CAAC;SACN,QAAQ,CAAC,gDAAgD,CAAC;IAC7D,KAAK,EAAE,CAAC;SACL,MAAM,EAAE;SACR,QAAQ,EAAE;SACV,QAAQ,CAAC,6DAA6D,CAAC;IAC1E,QAAQ,EAAE,CAAC;SACR,OAAO,EAAE;SACT,OAAO,CAAC,KAAK,CAAC;SACd,QAAQ,CAAC,6CAA6C,CAAC;CAC3D,CAAC,CAAC;AAEH,MAAM,CAAC,MAAM,gBAAgB,GAAgB;IAC3C,IAAI,EAAE,eAAe;IACrB,WAAW,EACT,uIAAuI;IACzI,SAAS,EAAE,sBAAsB;IACjC,WAAW,EAAE;QACX,IAAI,EAAE,QAAQ;QACd,UAAU,EAAE;YACV,QAAQ,EAAE;gBACR,IAAI,EAAE,QAAQ;gBACd,WAAW,EACT,0FAA0F;aAC7F;YACD,MAAM,EAAE;gBACN,IAAI,EAAE,QAAQ;gBACd,WAAW,EAAE,gDAAgD;aAC9D;YACD,KAAK,EAAE;gBACL,IAAI,EAAE,QAAQ;gBACd,WAAW,EACT,6DAA6D;aAChE;YACD,QAAQ,EAAE;gBACR,IAAI,EAAE,SAAS;gBACf,OAAO,EAAE,KAAK;gBACd,WAAW,EAAE,6CAA6C;aAC3D;SACF;QACD,QAAQ,EAAE,CAAC,UAAU,EAAE,QAAQ,CAAC;KACjC;IACD,MAAM,EAAE;QACN,WAAW,EACT,+DAA+D;KAClE;IACD,QAAQ,EAAE,QAAQ;IAClB,OAAO,EAAE,KAAK,EAAE,IAAI,EAAE,UAAU,EAAE,EAAE;QAClC,MAAM,EAAE,QAAQ,EAAE,MAAM,EAAE,KAAK,EAAE,QAAQ,EAAE,GAAG,IAAI,CAAC;QAEnD,IAAI,CAAC,QAAQ,EAAE,QAAQ,EAAE,CAAC,IAAI,EAAE,EAAE,CAAC;YACjC,MAAM,IAAI,KAAK,CAAC,uCAAuC,CAAC,CAAC;QAC3D,CAAC;QAED,IAAI,CAAC,MAAM,EAAE,QAAQ,EAAE,CAAC,IAAI,EAAE,EAAE,CAAC;YAC/B,MAAM,IAAI,KAAK,CAAC,oDAAoD,CAAC,CAAC;QACxE,CAAC;QAED,qCAAqC;QACrC,MAAM,OAAO,GAAI,QAAmB,CAAC,UAAU,CAAC,GAAG,CAAC;YAClD,CAAC,CAAC,QAAQ;YACV,CAAC,CAAC,IAAI,QAAQ,EAAE,CAAC;QAEnB,MAAM,cAAc,GAAG,QAAQ;YAC7B,CAAC,CAAC,gCAAgC,OAAO,gOAAgO,MAAM,EAAE;YACjR,CAAC,CAAC,YAAY,OAAO,OAAO,MAAM,EAAE,CAAC;QAEvC,MAAM,OAAO,GAAa,EAAE,CAAC;QAE7B,kEAAkE;QAClE,OAAO,CAAC,IAAI,CAAC,GAAG,CAAC,KAAK,CAAC,KAAK,EAAG,KAAgB,IAAI,MAAM,CAAC,GAAG,CAAC,CAAC;QAC/D,OAAO,CAAC,IAAI,CAAC,GAAG,CAAC,KAAK,CAAC,MAAM,EAAE,cAAc,CAAC,CAAC;QAE/C,IAAI,CAAC;YACH,MAAM,CAAC,KAAK,CAAC,oBAAoB,OAAO,EAAE,CAAC,CAAC;YAC5C,MAAM,MAAM,GAAG,MAAM,cAAc,CACjC,GAAG,CAAC,QAAQ,CAAC,MAAM,EACnB,OAAO,EACP,UAAU,CACX,CAAC;YACF,OAAO,GAAG,eAAe,CAAC,eAAe,iBAAiB,OAAO,OAAO,MAAM,EAAE,CAAC;QACnF,CAAC;QAAC,OAAO,KAAK,EAAE,CAAC;YACf,MAAM,YAAY,GAChB,KAAK,YAAY,KAAK,CAAC,CAAC,CAAC,KAAK,CAAC,OAAO,CAAC,CAAC,CAAC,MAAM,CAAC,KAAK,CAAC,CAAC;YAEzD,0CAA0C;YAC1C,IACE,YAAY,CAAC,QAAQ,CAAC,cAAc,CAAC,cAAc,CAAC;gBACnD,KAAgB,KAAK,MAAM,CAAC,KAAK,EAClC,CAAC;gBACD,MAAM,CAAC,IAAI,CAAC,2CAA2C,CAAC,CAAC;gBACzD,MAAM,YAAY,GAAG;oBACnB,GAAG,CAAC,KAAK,CAAC,KAAK;oBACf,MAAM,CAAC,KAAK;oBACZ,GAAG,CAAC,KAAK,CAAC,MAAM;oBAChB,cAAc;iBACf,CAAC;gBAEF,IAAI,CAAC;oBACH,MAAM,MAAM,GAAG,MAAM,cAAc,CACjC,GAAG,CAAC,QAAQ,CAAC,MAAM,EACnB,YAAY,EACZ,UAAU,CACX,CAAC;oBACF,OAAO,GAAG,eAAe,CAAC,eAAe,qCAAqC,OAAO,OAAO,MAAM,EAAE,CAAC;gBACvG,CAAC;gBAAC,OAAO,aAAa,EAAE,CAAC;oBACvB,MAAM,IAAI,KAAK,CACb,0BAA0B,aAAa,YAAY,KAAK,CAAC,CAAC,CAAC,aAAa,CAAC,OAAO,CAAC,CAAC,CAAC,MAAM,CAAC,aAAa,CAAC,EAAE,CAC3G,CAAC;gBACJ,CAAC;YACH,CAAC;YAED,MAAM,IAAI,KAAK,CAAC,0BAA0B,YAAY,EAAE,CAAC,CAAC;QAC5D,CAAC;IACH,CAAC;CACF,CAAC"}
+{"version":3,"file":"analyze-media.tool.js","sourceRoot":"","sources":["../../src/tools/analyze-media.tool.ts"],"names":[],"mappings":"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"}

package/dist/tools/ask-gemini.tool.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"ask-gemini.tool.d.ts","sourceRoot":"","sources":["../../src/tools/ask-gemini.tool.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,WAAW,EAAE,MAAM,eAAe,CAAC;AA0C5C,eAAO,MAAM,aAAa,EAAE,WAgF3B,CAAC"}
+{"version":3,"file":"ask-gemini.tool.d.ts","sourceRoot":"","sources":["../../src/tools/ask-gemini.tool.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,WAAW,EAAE,MAAM,eAAe,CAAC;AAoD5C,eAAO,MAAM,aAAa,EAAE,WAuG3B,CAAC"}