@tuannvm/gemini-mcp-server 1.0.0

package/dist/server.d.ts

@@ -0,0 +1,19 @@
+/**
+ * Gemini MCP Server implementation
+ */
+import { ServerConfig } from './types.js';
+export declare class GeminiMcpServer {
+    private readonly server;
+    private readonly config;
+    private isProcessing;
+    private currentOperationName;
+    private latestOutput;
+    constructor(config: ServerConfig);
+    private setupHandlers;
+    private sendNotification;
+    private sendProgressNotification;
+    private startProgressUpdates;
+    private stopProgressUpdates;
+    start(): Promise<void>;
+}
+//# sourceMappingURL=server.d.ts.map

package/dist/server.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"server.d.ts","sourceRoot":"","sources":["../src/server.ts"],"names":[],"mappings":"AAAA;;GAEG;AAcH,OAAO,EAAE,YAAY,EAAiB,MAAM,YAAY,CAAC;AAUzD,qBAAa,eAAe;IAC1B,OAAO,CAAC,QAAQ,CAAC,MAAM,CAAS;IAChC,OAAO,CAAC,QAAQ,CAAC,MAAM,CAAe;IACtC,OAAO,CAAC,YAAY,CAAS;IAC7B,OAAO,CAAC,oBAAoB,CAAM;IAClC,OAAO,CAAC,YAAY,CAAM;gBAEd,MAAM,EAAE,YAAY;IAkBhC,OAAO,CAAC,aAAa;YA0EP,gBAAgB;YAQhB,wBAAwB;IAsBtC,OAAO,CAAC,oBAAoB;IA0C5B,OAAO,CAAC,mBAAmB;IAmBrB,KAAK,IAAI,OAAO,CAAC,IAAI,CAAC;CAM7B"}

package/dist/server.js

@@ -0,0 +1,166 @@
+/**
+ * Gemini MCP Server implementation
+ */
+import { Server } from '@modelcontextprotocol/sdk/server/index.js';
+import { StdioServerTransport } from '@modelcontextprotocol/sdk/server/stdio.js';
+import { CallToolRequestSchema, ListToolsRequestSchema, ListPromptsRequestSchema, GetPromptRequestSchema, } from '@modelcontextprotocol/sdk/types.js';
+import { Logger } from './utils/logger.js';
+import { PROTOCOL } from './constants.js';
+import { handleError } from './errors.js';
+import { getToolDefinitions, getPromptDefinitions, executeTool, toolExists, getPromptMessage, } from './tools/index.js';
+export class GeminiMcpServer {
+    server;
+    config;
+    isProcessing = false;
+    currentOperationName = '';
+    latestOutput = '';
+    constructor(config) {
+        this.config = config;
+        this.server = new Server({
+            name: config.name,
+            version: config.version,
+        }, {
+            capabilities: {
+                tools: {},
+                prompts: {},
+                logging: {},
+            },
+        });
+        this.setupHandlers();
+    }
+    setupHandlers() {
+        // tools/list
+        this.server.setRequestHandler(ListToolsRequestSchema, async () => {
+            return { tools: getToolDefinitions() };
+        });
+        // tools/call
+        this.server.setRequestHandler(CallToolRequestSchema, async (request) => {
+            const toolName = request.params.name;
+            if (!toolExists(toolName)) {
+                throw new Error(`Unknown tool: ${toolName}`);
+            }
+            const progressToken = request.params._meta?.progressToken;
+            const progressData = this.startProgressUpdates(toolName, progressToken);
+            try {
+                const args = request.params.arguments || {};
+                Logger.toolInvocation(toolName, request.params.arguments);
+                const result = await executeTool(toolName, args, (newOutput) => {
+                    this.latestOutput = newOutput;
+                });
+                this.stopProgressUpdates(progressData, true);
+                return {
+                    content: [{ type: 'text', text: result }],
+                    isError: false,
+                };
+            }
+            catch (error) {
+                this.stopProgressUpdates(progressData, false);
+                Logger.error(`Error in tool '${toolName}':`, error);
+                const errorMessage = handleError(error, toolName);
+                return {
+                    content: [{ type: 'text', text: errorMessage }],
+                    isError: true,
+                };
+            }
+        });
+        // prompts/list
+        this.server.setRequestHandler(ListPromptsRequestSchema, async () => {
+            return { prompts: getPromptDefinitions() };
+        });
+        // prompts/get
+        this.server.setRequestHandler(GetPromptRequestSchema, async (request) => {
+            const promptName = request.params.name;
+            const args = request.params.arguments || {};
+            const promptMessage = getPromptMessage(promptName, args);
+            if (!promptMessage) {
+                throw new Error(`Unknown prompt: ${promptName}`);
+            }
+            return {
+                messages: [
+                    {
+                        role: 'user',
+                        content: {
+                            type: 'text',
+                            text: promptMessage,
+                        },
+                    },
+                ],
+            };
+        });
+    }
+    async sendNotification(method, params) {
+        try {
+            await this.server.notification({ method, params });
+        }
+        catch (error) {
+            Logger.error('Notification failed:', error);
+        }
+    }
+    async sendProgressNotification(progressToken, progress, total, message) {
+        if (!progressToken)
+            return;
+        try {
+            const params = { progressToken, progress };
+            if (total !== undefined)
+                params.total = total;
+            if (message)
+                params.message = message;
+            await this.server.notification({
+                method: PROTOCOL.NOTIFICATIONS.PROGRESS,
+                params,
+            });
+        }
+        catch (error) {
+            Logger.error('Failed to send progress notification:', error);
+        }
+    }
+    startProgressUpdates(operationName, progressToken) {
+        this.isProcessing = true;
+        this.currentOperationName = operationName;
+        this.latestOutput = '';
+        const progressMessages = [
+            `Processing ${operationName} - Gemini is analyzing your request...`,
+            `Processing ${operationName} - Processing files and generating insights...`,
+            `Processing ${operationName} - Creating structured response...`,
+            `Processing ${operationName} - Large analysis in progress...`,
+            `Processing ${operationName} - Still working on quality results...`,
+        ];
+        let messageIndex = 0;
+        let progress = 0;
+        if (progressToken) {
+            this.sendProgressNotification(progressToken, 0, undefined, `Starting ${operationName}`);
+        }
+        const progressInterval = setInterval(async () => {
+            if (this.isProcessing && progressToken) {
+                progress += 1;
+                const baseMessage = progressMessages[messageIndex % progressMessages.length];
+                const outputPreview = this.latestOutput.slice(-150).trim();
+                const message = outputPreview
+                    ? `${baseMessage}\nOutput: ...${outputPreview}`
+                    : baseMessage;
+                await this.sendProgressNotification(progressToken, progress, undefined, message);
+                messageIndex++;
+            }
+            else if (!this.isProcessing) {
+                clearInterval(progressInterval);
+            }
+        }, PROTOCOL.KEEPALIVE_INTERVAL);
+        return { interval: progressInterval, progressToken };
+    }
+    stopProgressUpdates(progressData, success = true) {
+        const operationName = this.currentOperationName;
+        this.isProcessing = false;
+        this.currentOperationName = '';
+        clearInterval(progressData.interval);
+        if (progressData.progressToken) {
+            this.sendProgressNotification(progressData.progressToken, 100, 100, success ? `${operationName} completed successfully` : `${operationName} failed`);
+        }
+    }
+    async start() {
+        Logger.debug(`Starting ${this.config.name} v${this.config.version}`);
+        const transport = new StdioServerTransport();
+        await this.server.connect(transport);
+        Logger.debug(`${this.config.name} listening on stdio`);
+    }
+}
+//# sourceMappingURL=server.js.map

package/dist/server.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"server.js","sourceRoot":"","sources":["../src/server.ts"],"names":[],"mappings":"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"}

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

@@ -0,0 +1,3 @@
+import { UnifiedTool } from './registry.js';
+export declare const analyzeMediaTool: UnifiedTool;
+//# sourceMappingURL=analyze-media.tool.d.ts.map

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

@@ -0,0 +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"}

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

@@ -0,0 +1,102 @@
+import { z } from 'zod';
+import { executeCommand } from '../utils/commandExecutor.js';
+import { CLI, MODELS, ERROR_MESSAGES, STATUS_MESSAGES } from '../constants.js';
+import { Logger } from '../utils/logger.js';
+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)'),
+    prompt: z
+        .string()
+        .min(1)
+        .describe('What to analyze or extract from the media file'),
+    model: z
+        .string()
+        .optional()
+        .describe('Model to use (default: gemini-3-pro-preview for multimodal)'),
+    detailed: z
+        .boolean()
+        .default(false)
+        .describe('Provide detailed analysis with more context'),
+});
+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,
+    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)',
+            },
+            prompt: {
+                type: 'string',
+                description: 'What to analyze or extract from the media file',
+            },
+            model: {
+                type: 'string',
+                description: 'Model to use (default: gemini-3-pro-preview for multimodal)',
+            },
+            detailed: {
+                type: 'boolean',
+                default: false,
+                description: 'Provide detailed analysis with more context',
+            },
+        },
+        required: ['filePath', 'prompt'],
+    },
+    prompt: {
+        description: 'Analyze media files (images, PDFs) using Gemini multimodal AI',
+    },
+    category: 'gemini',
+    execute: async (args, onProgress) => {
+        const { filePath, prompt, model, detailed } = args;
+        if (!filePath?.toString().trim()) {
+            throw new Error('Please provide a file path to analyze');
+        }
+        if (!prompt?.toString().trim()) {
+            throw new Error('Please provide a prompt describing what to analyze');
+        }
+        // Ensure @ prefix for file reference
+        const fileRef = filePath.startsWith('@')
+            ? filePath
+            : `@${filePath}`;
+        const analysisPrompt = detailed
+            ? `Analyze this file in detail: ${fileRef}\n\nProvide a comprehensive analysis including:\n1. Overview/Summary\n2. Key elements and their significance\n3. Technical details (if applicable)\n4. Notable observations\n5. Recommendations or insights\n\nUser request: ${prompt}`
+            : `Analyze: ${fileRef}\n\n${prompt}`;
+        const cmdArgs = [];
+        // Use Gemini 3 Pro by default for better multimodal understanding
+        cmdArgs.push(CLI.FLAGS.MODEL, model || MODELS.PRO);
+        cmdArgs.push(CLI.FLAGS.PROMPT, analysisPrompt);
+        try {
+            Logger.debug(`Analyzing media: ${fileRef}`);
+            const result = await executeCommand(CLI.COMMANDS.GEMINI, cmdArgs, onProgress);
+            return `${STATUS_MESSAGES.GEMINI_RESPONSE}\n\n**File:** ${fileRef}\n\n${result}`;
+        }
+        catch (error) {
+            const errorMessage = error instanceof Error ? error.message : String(error);
+            // Fallback to flash if pro quota exceeded
+            if (errorMessage.includes(ERROR_MESSAGES.QUOTA_EXCEEDED) &&
+                model !== MODELS.FLASH) {
+                Logger.warn('Pro quota exceeded, trying Flash model...');
+                const fallbackArgs = [
+                    CLI.FLAGS.MODEL,
+                    MODELS.FLASH,
+                    CLI.FLAGS.PROMPT,
+                    analysisPrompt,
+                ];
+                try {
+                    const result = await executeCommand(CLI.COMMANDS.GEMINI, fallbackArgs, onProgress);
+                    return `${STATUS_MESSAGES.GEMINI_RESPONSE} (using Flash model)\n\n**File:** ${fileRef}\n\n${result}`;
+                }
+                catch (fallbackError) {
+                    throw new Error(`Media analysis failed: ${fallbackError instanceof Error ? fallbackError.message : String(fallbackError)}`);
+                }
+            }
+            throw new Error(`Media analysis failed: ${errorMessage}`);
+        }
+    },
+};
+//# sourceMappingURL=analyze-media.tool.js.map

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

@@ -0,0 +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"}

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

@@ -0,0 +1,3 @@
+import { UnifiedTool } from './registry.js';
+export declare const askGeminiTool: UnifiedTool;
+//# sourceMappingURL=ask-gemini.tool.d.ts.map

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

@@ -0,0 +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"}

package/dist/tools/ask-gemini.tool.js

@@ -0,0 +1,86 @@
+import { z } from 'zod';
+import { executeGeminiCLI, processChangeModeOutput, } from '../utils/geminiExecutor.js';
+import { ERROR_MESSAGES, STATUS_MESSAGES } from '../constants.js';
+const askGeminiArgsSchema = z.object({
+    prompt: z
+        .string()
+        .min(1)
+        .describe("Analysis request. Use @ syntax to include files (e.g., '@largefile.js explain what this does') or ask general questions"),
+    model: z
+        .string()
+        .optional()
+        .describe("Optional model to use (e.g., 'gemini-3-flash-preview'). If not specified, uses the default model (gemini-3-pro-preview)."),
+    sandbox: z
+        .boolean()
+        .default(false)
+        .describe('Use sandbox mode (-s flag) to safely test code changes, execute scripts, or run potentially risky operations in an isolated environment'),
+    changeMode: z
+        .boolean()
+        .default(false)
+        .describe('Enable structured change mode - formats prompts to prevent tool errors and returns structured edit suggestions that Claude can apply directly'),
+    chunkIndex: z
+        .union([z.number(), z.string()])
+        .optional()
+        .describe('Which chunk to return (1-based)'),
+    chunkCacheKey: z
+        .string()
+        .optional()
+        .describe('Optional cache key for continuation'),
+});
+export const askGeminiTool = {
+    name: 'gemini',
+    description: 'Query Gemini AI. Supports model selection, sandbox mode for safe code execution, and structured change mode for applying edits.',
+    zodSchema: askGeminiArgsSchema,
+    inputSchema: {
+        type: 'object',
+        properties: {
+            prompt: {
+                type: 'string',
+                description: "Analysis request. Use @ syntax to include files (e.g., '@largefile.js explain what this does') or ask general questions",
+            },
+            model: {
+                type: 'string',
+                description: "Optional model to use (e.g., 'gemini-3-flash-preview'). If not specified, uses the default model (gemini-3-pro-preview).",
+            },
+            sandbox: {
+                type: 'boolean',
+                default: false,
+                description: 'Use sandbox mode (-s flag) to safely test code changes, execute scripts, or run potentially risky operations in an isolated environment',
+            },
+            changeMode: {
+                type: 'boolean',
+                default: false,
+                description: 'Enable structured change mode - formats prompts to prevent tool errors and returns structured edit suggestions that Claude can apply directly',
+            },
+            chunkIndex: {
+                type: ['number', 'string'],
+                description: 'Which chunk to return (1-based)',
+            },
+            chunkCacheKey: {
+                type: 'string',
+                description: 'Optional cache key for continuation',
+            },
+        },
+        required: ['prompt'],
+    },
+    prompt: {
+        description: 'Query Gemini AI with optional sandbox execution and structured change mode.',
+    },
+    category: 'gemini',
+    execute: async (args, onProgress) => {
+        const { prompt, model, sandbox, changeMode, chunkIndex, chunkCacheKey } = args;
+        if (!prompt?.trim()) {
+            throw new Error(ERROR_MESSAGES.NO_PROMPT_PROVIDED);
+        }
+        if (changeMode && chunkIndex && chunkCacheKey) {
+            return processChangeModeOutput('', // empty for cache...
+            chunkIndex, chunkCacheKey, prompt);
+        }
+        const result = await executeGeminiCLI(prompt, model, !!sandbox, !!changeMode, onProgress);
+        if (changeMode) {
+            return processChangeModeOutput(result, args.chunkIndex, undefined, prompt);
+        }
+        return `${STATUS_MESSAGES.GEMINI_RESPONSE}\n${result}`; // changeMode false
+    },
+};
+//# sourceMappingURL=ask-gemini.tool.js.map

package/dist/tools/ask-gemini.tool.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"ask-gemini.tool.js","sourceRoot":"","sources":["../../src/tools/ask-gemini.tool.ts"],"names":[],"mappings":"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"}

package/dist/tools/brainstorm.tool.d.ts

@@ -0,0 +1,3 @@
+import { UnifiedTool } from './registry.js';
+export declare const brainstormTool: UnifiedTool;
+//# sourceMappingURL=brainstorm.tool.d.ts.map

package/dist/tools/brainstorm.tool.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"brainstorm.tool.d.ts","sourceRoot":"","sources":["../../src/tools/brainstorm.tool.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,WAAW,EAAE,MAAM,eAAe,CAAC;AA2L5C,eAAO,MAAM,cAAc,EAAE,WA+G5B,CAAC"}

package/dist/tools/brainstorm.tool.js

@@ -0,0 +1,220 @@
+import { z } from 'zod';
+import { Logger } from '../utils/logger.js';
+import { executeGeminiCLI } from '../utils/geminiExecutor.js';
+function buildBrainstormPrompt(config) {
+    const { prompt, methodology, domain, constraints, existingContext, ideaCount, includeAnalysis, } = config;
+    // Select methodology framework
+    let frameworkInstructions = getMethodologyInstructions(methodology, domain);
+    let enhancedPrompt = `# BRAINSTORMING SESSION
+
+## Core Challenge
+${prompt}
+
+## Methodology Framework
+${frameworkInstructions}
+
+## Context Engineering
+*Use the following context to inform your reasoning:*
+${domain ? `**Domain Focus:** ${domain} - Apply domain-specific knowledge, terminology, and best practices.` : ''}
+${constraints ? `**Constraints & Boundaries:** ${constraints}` : ''}
+${existingContext ? `**Background Context:** ${existingContext}` : ''}
+
+## Output Requirements
+- Generate ${ideaCount} distinct, creative ideas
+- Each idea should be unique and non-obvious
+- Focus on actionable, implementable concepts
+- Use clear, descriptive naming
+- Provide brief explanations for each idea
+
+${includeAnalysis
+        ? `
+## Analysis Framework
+For each idea, provide:
+- **Feasibility:** Implementation difficulty (1-5 scale)
+- **Impact:** Potential value/benefit (1-5 scale)
+- **Innovation:** Uniqueness/creativity (1-5 scale)
+- **Quick Assessment:** One-sentence evaluation
+`
+        : ''}
+
+## Format
+Present ideas in a structured format:
+
+### Idea [N]: [Creative Name]
+**Description:** [2-3 sentence explanation]
+${includeAnalysis ? '**Feasibility:** [1-5] | **Impact:** [1-5] | **Innovation:** [1-5]\n**Assessment:** [Brief evaluation]' : ''}
+
+---
+
+**Before finalizing, review the list: remove near-duplicates and ensure each idea satisfies the constraints.**
+
+Begin brainstorming session:`;
+    return enhancedPrompt;
+}
+/**
+ * Returns methodology-specific instructions for structured brainstorming
+ */
+function getMethodologyInstructions(methodology, domain) {
+    const methodologies = {
+        divergent: `**Divergent Thinking Approach:**
+- Generate maximum quantity of ideas without self-censoring
+- Build on wild or seemingly impractical ideas
+- Combine unrelated concepts for unexpected solutions
+- Use "Yes, and..." thinking to expand each concept
+- Postpone evaluation until all ideas are generated`,
+        convergent: `**Convergent Thinking Approach:**
+- Focus on refining and improving existing concepts
+- Synthesize related ideas into stronger solutions
+- Apply critical evaluation criteria
+- Prioritize based on feasibility and impact
+- Develop implementation pathways for top ideas`,
+        scamper: `**SCAMPER Creative Triggers:**
+- **Substitute:** What can be substituted or replaced?
+- **Combine:** What can be combined or merged?
+- **Adapt:** What can be adapted from other domains?
+- **Modify:** What can be magnified, minimized, or altered?
+- **Put to other use:** How else can this be used?
+- **Eliminate:** What can be removed or simplified?
+- **Reverse:** What can be rearranged or reversed?`,
+        'design-thinking': `**Human-Centered Design Thinking:**
+- **Empathize:** Consider user needs, pain points, and contexts
+- **Define:** Frame problems from user perspective
+- **Ideate:** Generate user-focused solutions
+- **Consider Journey:** Think through complete user experience
+- **Prototype Mindset:** Focus on testable, iterative concepts`,
+        lateral: `**Lateral Thinking Approach:**
+- Make unexpected connections between unrelated fields
+- Challenge fundamental assumptions
+- Use random word association to trigger new directions
+- Apply metaphors and analogies from other domains
+- Reverse conventional thinking patterns`,
+        auto: `**AI-Optimized Approach:**
+${domain ? `Given the ${domain} domain, I'll apply the most effective combination of:` : "I'll intelligently combine multiple methodologies:"}
+- Divergent exploration with domain-specific knowledge
+- SCAMPER triggers and lateral thinking
+- Human-centered perspective for practical value`,
+    };
+    return methodologies[methodology] || methodologies['auto'];
+}
+const brainstormArgsSchema = z.object({
+    prompt: z
+        .string()
+        .min(1)
+        .describe('Primary brainstorming challenge or question to explore'),
+    model: z
+        .string()
+        .optional()
+        .describe("Optional model to use (e.g., 'gemini-3-flash-preview'). If not specified, uses the default model (gemini-3-pro-preview)."),
+    methodology: z
+        .enum([
+        'divergent',
+        'convergent',
+        'scamper',
+        'design-thinking',
+        'lateral',
+        'auto',
+    ])
+        .default('auto')
+        .describe("Brainstorming framework: 'divergent' (generate many ideas), 'convergent' (refine existing), 'scamper' (systematic triggers), 'design-thinking' (human-centered), 'lateral' (unexpected connections), 'auto' (AI selects best)"),
+    domain: z
+        .string()
+        .optional()
+        .describe("Domain context for specialized brainstorming (e.g., 'software', 'business', 'creative', 'research', 'product', 'marketing')"),
+    constraints: z
+        .string()
+        .optional()
+        .describe('Known limitations, requirements, or boundaries (budget, time, technical, legal, etc.)'),
+    existingContext: z
+        .string()
+        .optional()
+        .describe('Background information, previous attempts, or current state to build upon'),
+    ideaCount: z
+        .number()
+        .int()
+        .positive()
+        .default(12)
+        .describe('Target number of ideas to generate (default: 10-15)'),
+    includeAnalysis: z
+        .boolean()
+        .default(true)
+        .describe('Include feasibility, impact, and implementation analysis for generated ideas'),
+});
+export const brainstormTool = {
+    name: 'brainstorm',
+    description: 'Generate creative ideas using structured frameworks (SCAMPER, Design Thinking, etc.) with domain context, feasibility analysis, and iterative refinement.',
+    zodSchema: brainstormArgsSchema,
+    inputSchema: {
+        type: 'object',
+        properties: {
+            prompt: {
+                type: 'string',
+                description: 'Primary brainstorming challenge or question to explore',
+            },
+            model: {
+                type: 'string',
+                description: "Optional model to use (e.g., 'gemini-3-flash-preview'). If not specified, uses the default model (gemini-3-pro-preview).",
+            },
+            methodology: {
+                type: 'string',
+                enum: [
+                    'divergent',
+                    'convergent',
+                    'scamper',
+                    'design-thinking',
+                    'lateral',
+                    'auto',
+                ],
+                default: 'auto',
+                description: "Brainstorming framework: 'divergent' (generate many ideas), 'convergent' (refine existing), 'scamper' (systematic triggers), 'design-thinking' (human-centered), 'lateral' (unexpected connections), 'auto' (AI selects best)",
+            },
+            domain: {
+                type: 'string',
+                description: "Domain context for specialized brainstorming (e.g., 'software', 'business', 'creative', 'research', 'product', 'marketing')",
+            },
+            constraints: {
+                type: 'string',
+                description: 'Known limitations, requirements, or boundaries (budget, time, technical, legal, etc.)',
+            },
+            existingContext: {
+                type: 'string',
+                description: 'Background information, previous attempts, or current state to build upon',
+            },
+            ideaCount: {
+                type: 'integer',
+                default: 12,
+                description: 'Target number of ideas to generate (default: 10-15)',
+            },
+            includeAnalysis: {
+                type: 'boolean',
+                default: true,
+                description: 'Include feasibility, impact, and implementation analysis for generated ideas',
+            },
+        },
+        required: ['prompt'],
+    },
+    prompt: {
+        description: 'Generate creative ideas using structured brainstorming methodologies.',
+    },
+    category: 'gemini',
+    execute: async (args, onProgress) => {
+        const { prompt, model, methodology = 'auto', domain, constraints, existingContext, ideaCount = 12, includeAnalysis = true, } = args;
+        if (!prompt?.trim()) {
+            throw new Error('You must provide a valid brainstorming challenge or question to explore');
+        }
+        let enhancedPrompt = buildBrainstormPrompt({
+            prompt: prompt.trim(),
+            methodology: methodology,
+            domain: domain,
+            constraints: constraints,
+            existingContext: existingContext,
+            ideaCount: ideaCount,
+            includeAnalysis: includeAnalysis,
+        });
+        Logger.debug(`Brainstorm: Using methodology '${methodology}' for domain '${domain || 'general'}'`);
+        // Report progress to user
+        onProgress?.(`Generating ${ideaCount} ideas via ${methodology} methodology...`);
+        // Execute with Gemini
+        return await executeGeminiCLI(enhancedPrompt, model, false, false, onProgress);
+    },
+};
+//# sourceMappingURL=brainstorm.tool.js.map

package/dist/tools/brainstorm.tool.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"brainstorm.tool.js","sourceRoot":"","sources":["../../src/tools/brainstorm.tool.ts"],"names":[],"mappings":"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"}