@osanoai/multicli 1.5.0

package/dist/modelCatalog.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"modelCatalog.d.ts","sourceRoot":"","sources":["../src/modelCatalog.ts"],"names":[],"mappings":"AAAA,MAAM,WAAW,SAAS;IACxB,IAAI,EAAE,MAAM,GAAG,UAAU,GAAG,UAAU,CAAC;IACvC,KAAK,EAAE,MAAM,CAAC;IACd,MAAM,EAAE,MAAM,EAAE,CAAC;IACjB,OAAO,EAAE,MAAM,CAAC;CACjB;AAED,MAAM,WAAW,UAAU;IACzB,GAAG,EAAE,QAAQ,GAAG,OAAO,GAAG,QAAQ,CAAC;IACnC,KAAK,EAAE,SAAS,EAAE,CAAC;IACnB,IAAI,EAAE,MAAM,CAAC;CACd;AAmFD,wBAAgB,UAAU,CAAC,GAAG,EAAE,QAAQ,GAAG,OAAO,GAAG,QAAQ,GAAG,UAAU,CAEzE;AAOD,wBAAgB,aAAa,CAAC,GAAG,EAAE,QAAQ,GAAG,OAAO,GAAG,QAAQ,GAAG,MAAM,CAgBxE"}

package/dist/modelCatalog.js

@@ -0,0 +1,99 @@
+const GEMINI_CATALOG = {
+    cli: 'gemini',
+    tiers: [
+        {
+            tier: 'fast',
+            label: 'Flash (DEFAULT)',
+            models: ['gemini-2.5-flash', 'gemini-2.5-flash-lite'],
+            useWhen: 'Simple questions, math, lookups, summaries, short code, trivial tasks. USE THIS BY DEFAULT.',
+        },
+        {
+            tier: 'balanced',
+            label: 'Flash Preview',
+            models: ['gemini-3-flash-preview'],
+            useWhen: 'Moderate tasks needing newer capabilities but still fast. Multi-step but not deeply complex.',
+        },
+        {
+            tier: 'powerful',
+            label: 'Pro',
+            models: ['gemini-3.1-pro-preview', 'gemini-2.5-pro'],
+            useWhen: 'ONLY for: complex analysis, deep reasoning, large codebase understanding, nuanced opinions, architectural decisions.',
+        },
+    ],
+    note: 'Run Gemini Help for the latest CLI options. Model IDs may change as Google releases new versions.',
+};
+const CODEX_CATALOG = {
+    cli: 'codex',
+    tiers: [
+        {
+            tier: 'fast',
+            label: 'Codex Mini (DEFAULT)',
+            models: ['gpt-5.1-codex-mini'],
+            useWhen: 'Simple questions, math, lookups, short code snippets, trivial tasks. USE THIS BY DEFAULT.',
+        },
+        {
+            tier: 'balanced',
+            label: 'Codex',
+            models: ['gpt-5.2-codex'],
+            useWhen: 'Moderate coding tasks, multi-file changes, debugging, code review.',
+        },
+        {
+            tier: 'powerful',
+            label: 'Codex Max / GPT',
+            models: ['gpt-5.3-codex', 'gpt-5.1-codex-max', 'gpt-5.2'],
+            useWhen: 'ONLY for: complex architecture, large refactors, deep reasoning, nuanced analysis, multi-step planning.',
+        },
+    ],
+    note: 'Run Codex Help for the latest CLI options. Model IDs may change as OpenAI releases new versions.',
+};
+const CLAUDE_CATALOG = {
+    cli: 'claude',
+    tiers: [
+        {
+            tier: 'fast',
+            label: 'Haiku (DEFAULT)',
+            models: ['claude-haiku-4-5-20251001'],
+            useWhen: 'Simple questions, math, lookups, summaries, short code, trivial tasks. USE THIS BY DEFAULT.',
+        },
+        {
+            tier: 'balanced',
+            label: 'Sonnet',
+            models: ['claude-sonnet-4-6'],
+            useWhen: 'Moderate coding, analysis, multi-step tasks, following detailed instructions.',
+        },
+        {
+            tier: 'powerful',
+            label: 'Opus',
+            models: ['claude-opus-4-6'],
+            useWhen: 'ONLY for: complex reasoning, nuanced analysis, difficult multi-step tasks, architectural decisions.',
+        },
+    ],
+    note: 'Run Claude Help for the latest CLI options.',
+};
+const CATALOGS = {
+    gemini: GEMINI_CATALOG,
+    codex: CODEX_CATALOG,
+    claude: CLAUDE_CATALOG,
+};
+export function getCatalog(cli) {
+    return CATALOGS[cli];
+}
+const SELECTION_RULE = `MODEL SELECTION RULE: Always use the fastest (smallest) model that can handle the task. ` +
+    `Default to the "fast" tier. Only escalate when the task clearly requires more capability. ` +
+    `Simple questions, math, lookups, and trivial code do NOT need powerful models.\n`;
+export function formatCatalog(cli) {
+    const catalog = CATALOGS[cli];
+    const lines = [
+        `${catalog.cli.toUpperCase()} — Available Models\n`,
+        SELECTION_RULE,
+    ];
+    for (const tier of catalog.tiers) {
+        lines.push(`[${tier.tier.toUpperCase()}] ${tier.label}`);
+        lines.push(`  Use when: ${tier.useWhen}`);
+        lines.push(`  Model IDs: ${tier.models.join(', ')}`);
+        lines.push('');
+    }
+    lines.push(`> ${catalog.note}`);
+    return lines.join('\n');
+}
+//# sourceMappingURL=modelCatalog.js.map

package/dist/modelCatalog.js.map

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

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

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

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

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

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

@@ -0,0 +1,28 @@
+import { z } from 'zod';
+import { executeClaudeCLI } from '../utils/claudeExecutor.js';
+import { ERROR_MESSAGES, STATUS_MESSAGES } from '../constants.js';
+const askClaudeArgsSchema = z.object({
+    prompt: z.string().min(1).describe("The question or task for Claude Code. REQUIRED — MUST be a non-empty string. Claude Code has FULL access to the filesystem and can read files itself. Do NOT pre-read or inline file contents — just describe the task and let Claude explore the codebase."),
+    model: z.string().min(1).describe("REQUIRED — you MUST first call List Claude Models, review the available model families and their strengths, then select the best model for your task's scope and complexity. It's the law. Empty strings will be rejected."),
+    permissionMode: z.enum(['default', 'acceptEdits', 'bypassPermissions', 'dontAsk', 'plan']).optional().describe("Optional. Do NOT set unless explicitly needed. Permission mode: 'default' (requires approval), 'acceptEdits' (auto-accepts file edits), 'bypassPermissions' (skips all checks — use with care), 'dontAsk', or 'plan'."),
+    maxBudgetUsd: z.number().positive().optional().describe("Optional. Do NOT set unless explicitly needed. Maximum dollar amount to spend on API calls for this request."),
+    systemPrompt: z.string().optional().describe("Optional. Do NOT set unless explicitly needed. Override or append a system prompt for this request."),
+});
+export const askClaudeTool = {
+    name: "Ask Claude",
+    description: "Ask Claude Code a question or give it a task. Claude Code has full filesystem access and will read files itself — do NOT pre-gather context or inline file contents into the prompt. Just describe what you need. You MUST call List Claude Models first to select an appropriate model. Do NOT set optional parameters unless you have a specific reason.",
+    zodSchema: askClaudeArgsSchema,
+    prompt: {
+        description: "Execute 'claude --print <prompt>' to get Claude Code's response.",
+    },
+    category: 'claude',
+    execute: async (args, onProgress) => {
+        const { prompt, model, permissionMode, maxBudgetUsd, systemPrompt } = args;
+        if (!prompt?.trim()) {
+            throw new Error(ERROR_MESSAGES.NO_PROMPT_PROVIDED);
+        }
+        const result = await executeClaudeCLI(prompt, model, permissionMode, maxBudgetUsd, systemPrompt, onProgress);
+        return `${STATUS_MESSAGES.CLAUDE_RESPONSE}\n${result}`;
+    }
+};
+//# sourceMappingURL=ask-claude.tool.js.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"ask-claude.tool.js","sourceRoot":"","sources":["../../src/tools/ask-claude.tool.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AAExB,OAAO,EAAE,gBAAgB,EAAE,MAAM,4BAA4B,CAAC;AAC9D,OAAO,EAAE,cAAc,EAAE,eAAe,EAAE,MAAM,iBAAiB,CAAC;AAElE,MAAM,mBAAmB,GAAG,CAAC,CAAC,MAAM,CAAC;IACnC,MAAM,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,GAAG,CAAC,CAAC,CAAC,CAAC,QAAQ,CAAC,6PAA6P,CAAC;IACjS,KAAK,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,GAAG,CAAC,CAAC,CAAC,CAAC,QAAQ,CAAC,4NAA4N,CAAC;IAC/P,cAAc,EAAE,CAAC,CAAC,IAAI,CAAC,CAAC,SAAS,EAAE,aAAa,EAAE,mBAAmB,EAAE,SAAS,EAAE,MAAM,CAAC,CAAC,CAAC,QAAQ,EAAE,CAAC,QAAQ,CAAC,uNAAuN,CAAC;IACvU,YAAY,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,QAAQ,EAAE,CAAC,QAAQ,EAAE,CAAC,QAAQ,CAAC,8GAA8G,CAAC;IACvK,YAAY,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,QAAQ,EAAE,CAAC,QAAQ,CAAC,qGAAqG,CAAC;CACpJ,CAAC,CAAC;AAEH,MAAM,CAAC,MAAM,aAAa,GAAgB;IACxC,IAAI,EAAE,YAAY;IAClB,WAAW,EAAE,4VAA4V;IACzW,SAAS,EAAE,mBAAmB;IAC9B,MAAM,EAAE;QACN,WAAW,EAAE,kEAAkE;KAChF;IACD,QAAQ,EAAE,QAAQ;IAClB,OAAO,EAAE,KAAK,EAAE,IAAI,EAAE,UAAU,EAAE,EAAE;QAClC,MAAM,EAAE,MAAM,EAAE,KAAK,EAAE,cAAc,EAAE,YAAY,EAAE,YAAY,EAAE,GAAG,IAAI,CAAC;QAE3E,IAAI,CAAC,MAAM,EAAE,IAAI,EAAE,EAAE,CAAC;YACpB,MAAM,IAAI,KAAK,CAAC,cAAc,CAAC,kBAAkB,CAAC,CAAC;QACrD,CAAC;QAED,MAAM,MAAM,GAAG,MAAM,gBAAgB,CACnC,MAAgB,EAChB,KAAe,EACf,cAAoC,EACpC,YAAkC,EAClC,YAAkC,EAClC,UAAU,CACX,CAAC;QAEF,OAAO,GAAG,eAAe,CAAC,eAAe,KAAK,MAAM,EAAE,CAAC;IACzD,CAAC;CACF,CAAC"}

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

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

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

@@ -0,0 +1 @@
+{"version":3,"file":"ask-codex.tool.d.ts","sourceRoot":"","sources":["../../src/tools/ask-codex.tool.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,WAAW,EAAE,MAAM,eAAe,CAAC;AAW5C,eAAO,MAAM,YAAY,EAAE,WAyB1B,CAAC"}

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

@@ -0,0 +1,27 @@
+import { z } from 'zod';
+import { executeCodexCLI } from '../utils/codexExecutor.js';
+import { ERROR_MESSAGES, STATUS_MESSAGES } from '../constants.js';
+const askCodexArgsSchema = z.object({
+    prompt: z.string().min(1).describe("The question or task for Codex. REQUIRED — MUST be a non-empty string. Codex has FULL access to the filesystem and can read files itself. Do NOT pre-read or inline file contents — just describe the task and let Codex explore the codebase."),
+    model: z.string().min(1).describe("REQUIRED — you MUST first call List Codex Models, review the available model families and their strengths, then select the best model for your task's scope and complexity. It's the law. Empty strings will be rejected."),
+    sandbox: z.enum(['read-only', 'workspace-write', 'danger-full-access']).optional().describe("Optional. Do NOT set unless explicitly needed. Sandbox mode: 'read-only' (safe), 'workspace-write' (default), or 'danger-full-access' (unrestricted)."),
+    approvalPolicy: z.enum(['never', 'on-request', 'on-failure', 'untrusted']).optional().describe("Optional. Do NOT set unless explicitly needed. Approval policy: 'never', 'on-request' (default), 'on-failure', or 'untrusted'."),
+});
+export const askCodexTool = {
+    name: "Ask Codex",
+    description: "Ask OpenAI Codex a question or give it a task. Codex has full filesystem access and will read files itself — do NOT pre-gather context or inline file contents into the prompt. Just describe what you need. You MUST call List Codex Models first to select an appropriate model. Do NOT set optional parameters unless you have a specific reason.",
+    zodSchema: askCodexArgsSchema,
+    prompt: {
+        description: "Execute 'codex exec <prompt> --full-auto' to get Codex's response.",
+    },
+    category: 'codex',
+    execute: async (args, onProgress) => {
+        const { prompt, model, sandbox, approvalPolicy } = args;
+        if (!prompt?.trim()) {
+            throw new Error(ERROR_MESSAGES.NO_PROMPT_PROVIDED);
+        }
+        const result = await executeCodexCLI(prompt, model, sandbox, approvalPolicy, onProgress);
+        return `${STATUS_MESSAGES.CODEX_RESPONSE}\n${result}`;
+    }
+};
+//# sourceMappingURL=ask-codex.tool.js.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"ask-codex.tool.js","sourceRoot":"","sources":["../../src/tools/ask-codex.tool.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AAExB,OAAO,EAAE,eAAe,EAAE,MAAM,2BAA2B,CAAC;AAC5D,OAAO,EAAE,cAAc,EAAE,eAAe,EAAE,MAAM,iBAAiB,CAAC;AAElE,MAAM,kBAAkB,GAAG,CAAC,CAAC,MAAM,CAAC;IAClC,MAAM,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,GAAG,CAAC,CAAC,CAAC,CAAC,QAAQ,CAAC,gPAAgP,CAAC;IACpR,KAAK,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,GAAG,CAAC,CAAC,CAAC,CAAC,QAAQ,CAAC,2NAA2N,CAAC;IAC9P,OAAO,EAAE,CAAC,CAAC,IAAI,CAAC,CAAC,WAAW,EAAE,iBAAiB,EAAE,oBAAoB,CAAC,CAAC,CAAC,QAAQ,EAAE,CAAC,QAAQ,CAAC,uJAAuJ,CAAC;IACpP,cAAc,EAAE,CAAC,CAAC,IAAI,CAAC,CAAC,OAAO,EAAE,YAAY,EAAE,YAAY,EAAE,WAAW,CAAC,CAAC,CAAC,QAAQ,EAAE,CAAC,QAAQ,CAAC,gIAAgI,CAAC;CACjO,CAAC,CAAC;AAEH,MAAM,CAAC,MAAM,YAAY,GAAgB;IACvC,IAAI,EAAE,WAAW;IACjB,WAAW,EAAE,sVAAsV;IACnW,SAAS,EAAE,kBAAkB;IAC7B,MAAM,EAAE;QACN,WAAW,EAAE,oEAAoE;KAClF;IACD,QAAQ,EAAE,OAAO;IACjB,OAAO,EAAE,KAAK,EAAE,IAAI,EAAE,UAAU,EAAE,EAAE;QAClC,MAAM,EAAE,MAAM,EAAE,KAAK,EAAE,OAAO,EAAE,cAAc,EAAE,GAAG,IAAI,CAAC;QAExD,IAAI,CAAC,MAAM,EAAE,IAAI,EAAE,EAAE,CAAC;YACpB,MAAM,IAAI,KAAK,CAAC,cAAc,CAAC,kBAAkB,CAAC,CAAC;QACrD,CAAC;QAED,MAAM,MAAM,GAAG,MAAM,eAAe,CAClC,MAAgB,EAChB,KAAe,EACf,OAA6B,EAC7B,cAAoC,EACpC,UAAU,CACX,CAAC;QAEF,OAAO,GAAG,eAAe,CAAC,cAAc,KAAK,MAAM,EAAE,CAAC;IACxD,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;AAgB5C,eAAO,MAAM,aAAa,EAAE,WAsC3B,CAAC"}

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

@@ -0,0 +1,36 @@
+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("The question or task for Gemini. REQUIRED — MUST be a non-empty string. Gemini has filesystem access — use @ syntax to reference files (e.g., '@src/index.ts review this'). Do NOT pre-read or inline file contents — just describe the task and reference files with @."),
+    model: z.string().min(1).describe("REQUIRED — you MUST first call List Gemini Models, review the available model families and their strengths, then select the best model for your task's scope and complexity. It's the law. Empty strings will be rejected."),
+    sandbox: z.boolean().default(false).describe("Optional. Do NOT set unless explicitly needed. Run in sandbox mode (-s flag) for safely testing code changes in an isolated environment. Defaults to false."),
+    changeMode: z.boolean().default(false).describe("Optional. Do NOT set unless explicitly needed. Return structured edit suggestions instead of plain text. Defaults to false."),
+    chunkIndex: z.union([z.number(), z.string()]).optional().describe("Internal — do NOT set unless you received a chunked changeMode response. Which chunk to return (1-based)."),
+    chunkCacheKey: z.string().optional().describe("Internal — do NOT set unless you received a chunked changeMode response. Cache key from a prior response for fetching subsequent chunks."),
+});
+export const askGeminiTool = {
+    name: "Ask Gemini",
+    description: "Ask Google Gemini a question or give it a task. Gemini has filesystem access via @ syntax — do NOT pre-gather context or inline file contents into the prompt. Just describe what you need and use @file references. You MUST call List Gemini Models first to select an appropriate model. Do NOT set optional parameters unless you have a specific reason.",
+    zodSchema: askGeminiArgsSchema,
+    prompt: {
+        description: "Execute 'gemini <prompt>' to get Gemini AI's response. Supports enhanced change mode for structured edit suggestions.",
+    },
+    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":"AAAA,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AAExB,OAAO,EAAE,gBAAgB,EAAE,uBAAuB,EAAE,MAAM,4BAA4B,CAAC;AACvF,OAAO,EACL,cAAc,EACd,eAAe,EAChB,MAAM,iBAAiB,CAAC;AAEzB,MAAM,mBAAmB,GAAG,CAAC,CAAC,MAAM,CAAC;IACnC,MAAM,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,GAAG,CAAC,CAAC,CAAC,CAAC,QAAQ,CAAC,0QAA0Q,CAAC;IAC9S,KAAK,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,GAAG,CAAC,CAAC,CAAC,CAAC,QAAQ,CAAC,4NAA4N,CAAC;IAC/P,OAAO,EAAE,CAAC,CAAC,OAAO,EAAE,CAAC,OAAO,CAAC,KAAK,CAAC,CAAC,QAAQ,CAAC,6JAA6J,CAAC;IAC3M,UAAU,EAAE,CAAC,CAAC,OAAO,EAAE,CAAC,OAAO,CAAC,KAAK,CAAC,CAAC,QAAQ,CAAC,6HAA6H,CAAC;IAC9K,UAAU,EAAE,CAAC,CAAC,KAAK,CAAC,CAAC,CAAC,CAAC,MAAM,EAAE,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,CAAC,CAAC,QAAQ,EAAE,CAAC,QAAQ,CAAC,2GAA2G,CAAC;IAC9K,aAAa,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,QAAQ,EAAE,CAAC,QAAQ,CAAC,0IAA0I,CAAC;CAC1L,CAAC,CAAC;AAEH,MAAM,CAAC,MAAM,aAAa,GAAgB;IACxC,IAAI,EAAE,YAAY;IAClB,WAAW,EAAE,+VAA+V;IAC5W,SAAS,EAAE,mBAAmB;IAC9B,MAAM,EAAE;QACN,WAAW,EAAE,uHAAuH;KACrI;IACD,QAAQ,EAAE,QAAQ;IAClB,OAAO,EAAE,KAAK,EAAE,IAAI,EAAE,UAAU,EAAE,EAAE;QAClC,MAAM,EAAE,MAAM,EAAE,KAAK,EAAE,OAAO,EAAE,UAAU,EAAE,UAAU,EAAE,aAAa,EAAE,GAAG,IAAI,CAAC;QAAC,IAAI,CAAC,MAAM,EAAE,IAAI,EAAE,EAAE,CAAC;YAAC,MAAM,IAAI,KAAK,CAAC,cAAc,CAAC,kBAAkB,CAAC,CAAC;QAAC,CAAC;QAE5J,IAAI,UAAU,IAAI,UAAU,IAAI,aAAa,EAAE,CAAC;YAC9C,OAAO,uBAAuB,CAC5B,EAAE,EAAE,qBAAqB;YACzB,UAAoB,EACpB,aAAuB,EACvB,MAAgB,CACjB,CAAC;QACJ,CAAC;QAED,MAAM,MAAM,GAAG,MAAM,gBAAgB,CACnC,MAAgB,EAChB,KAAe,EACf,CAAC,CAAC,OAAO,EACT,CAAC,CAAC,UAAU,EACZ,UAAU,CACX,CAAC;QAEF,IAAI,UAAU,EAAE,CAAC;YACf,OAAO,uBAAuB,CAC5B,MAAM,EACN,IAAI,CAAC,UAAgC,EACrC,SAAS,EACT,MAAgB,CACjB,CAAC;QACJ,CAAC;QACD,OAAO,GAAG,eAAe,CAAC,eAAe,KAAK,MAAM,EAAE,CAAC,CAAC,mBAAmB;IAC7E,CAAC;CACF,CAAC"}

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

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

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

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

package/dist/tools/brainstorm-claude.tool.js

@@ -0,0 +1,42 @@
+import { z } from 'zod';
+import { Logger } from '../utils/logger.js';
+import { executeClaudeCLI } from '../utils/claudeExecutor.js';
+import { buildBrainstormPrompt } from '../utils/brainstormPromptBuilder.js';
+const brainstormClaudeArgsSchema = z.object({
+    prompt: z.string().min(1).describe("Primary brainstorming challenge or question to explore"),
+    model: z.string().min(1).describe("Required. Call claude-list-models to see available models and families. Accepts aliases ('sonnet', 'opus', 'haiku') or full model IDs."),
+    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 brainstormClaudeTool = {
+    name: "claude-brainstorm",
+    description: "Generate novel ideas using Claude Code. Model is required — call claude-list-models first. Supports SCAMPER, Design Thinking, etc.",
+    zodSchema: brainstormClaudeArgsSchema,
+    prompt: {
+        description: "Generate structured brainstorming prompt with methodology-driven ideation, domain context integration, and analytical evaluation framework",
+    },
+    category: 'claude',
+    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");
+        }
+        const enhancedPrompt = buildBrainstormPrompt({
+            prompt: prompt.trim(),
+            methodology: methodology,
+            domain: domain,
+            constraints: constraints,
+            existingContext: existingContext,
+            ideaCount: ideaCount,
+            includeAnalysis: includeAnalysis
+        });
+        Logger.debug(`Brainstorm (Claude): Using methodology '${methodology}' for domain '${domain || 'general'}'`);
+        onProgress?.(`Generating ${ideaCount} ideas via ${methodology} methodology...`);
+        return await executeClaudeCLI(enhancedPrompt, model, undefined, undefined, undefined, onProgress);
+    }
+};
+//# sourceMappingURL=brainstorm-claude.tool.js.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"brainstorm-claude.tool.js","sourceRoot":"","sources":["../../src/tools/brainstorm-claude.tool.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AAExB,OAAO,EAAE,MAAM,EAAE,MAAM,oBAAoB,CAAC;AAC5C,OAAO,EAAE,gBAAgB,EAAE,MAAM,4BAA4B,CAAC;AAC9D,OAAO,EAAE,qBAAqB,EAAE,MAAM,qCAAqC,CAAC;AAE5E,MAAM,0BAA0B,GAAG,CAAC,CAAC,MAAM,CAAC;IAC1C,MAAM,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,GAAG,CAAC,CAAC,CAAC,CAAC,QAAQ,CAAC,wDAAwD,CAAC;IAC5F,KAAK,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,GAAG,CAAC,CAAC,CAAC,CAAC,QAAQ,CAAC,wIAAwI,CAAC;IAC3K,WAAW,EAAE,CAAC,CAAC,IAAI,CAAC,CAAC,WAAW,EAAE,YAAY,EAAE,SAAS,EAAE,iBAAiB,EAAE,SAAS,EAAE,MAAM,CAAC,CAAC,CAAC,OAAO,CAAC,MAAM,CAAC,CAAC,QAAQ,CAAC,+NAA+N,CAAC;IAC3V,MAAM,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,QAAQ,EAAE,CAAC,QAAQ,CAAC,6HAA6H,CAAC;IACrK,WAAW,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,QAAQ,EAAE,CAAC,QAAQ,CAAC,uFAAuF,CAAC;IACpI,eAAe,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,QAAQ,EAAE,CAAC,QAAQ,CAAC,2EAA2E,CAAC;IAC5H,SAAS,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,GAAG,EAAE,CAAC,QAAQ,EAAE,CAAC,OAAO,CAAC,EAAE,CAAC,CAAC,QAAQ,CAAC,qDAAqD,CAAC;IAClH,eAAe,EAAE,CAAC,CAAC,OAAO,EAAE,CAAC,OAAO,CAAC,IAAI,CAAC,CAAC,QAAQ,CAAC,8EAA8E,CAAC;CACpI,CAAC,CAAC;AAEH,MAAM,CAAC,MAAM,oBAAoB,GAAgB;IAC/C,IAAI,EAAE,mBAAmB;IACzB,WAAW,EAAE,oIAAoI;IACjJ,SAAS,EAAE,0BAA0B;IACrC,MAAM,EAAE;QACN,WAAW,EAAE,4IAA4I;KAC1J;IACD,QAAQ,EAAE,QAAQ;IAClB,OAAO,EAAE,KAAK,EAAE,IAAI,EAAE,UAAU,EAAE,EAAE;QAClC,MAAM,EACJ,MAAM,EACN,KAAK,EACL,WAAW,GAAG,MAAM,EACpB,MAAM,EACN,WAAW,EACX,eAAe,EACf,SAAS,GAAG,EAAE,EACd,eAAe,GAAG,IAAI,EACvB,GAAG,IAAI,CAAC;QAET,IAAI,CAAC,MAAM,EAAE,IAAI,EAAE,EAAE,CAAC;YACpB,MAAM,IAAI,KAAK,CAAC,yEAAyE,CAAC,CAAC;QAC7F,CAAC;QAED,MAAM,cAAc,GAAG,qBAAqB,CAAC;YAC3C,MAAM,EAAG,MAAiB,CAAC,IAAI,EAAE;YACjC,WAAW,EAAE,WAAqB;YAClC,MAAM,EAAE,MAA4B;YACpC,WAAW,EAAE,WAAiC;YAC9C,eAAe,EAAE,eAAqC;YACtD,SAAS,EAAE,SAAmB;YAC9B,eAAe,EAAE,eAA0B;SAC5C,CAAC,CAAC;QAEH,MAAM,CAAC,KAAK,CAAC,2CAA2C,WAAW,iBAAiB,MAAM,IAAI,SAAS,GAAG,CAAC,CAAC;QAE5G,UAAU,EAAE,CAAC,cAAc,SAAS,cAAc,WAAW,iBAAiB,CAAC,CAAC;QAEhF,OAAO,MAAM,gBAAgB,CAAC,cAAc,EAAE,KAAe,EAAE,SAAS,EAAE,SAAS,EAAE,SAAS,EAAE,UAAU,CAAC,CAAC;IAC9G,CAAC;CACF,CAAC"}

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

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

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

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

package/dist/tools/brainstorm-codex.tool.js

@@ -0,0 +1,42 @@
+import { z } from 'zod';
+import { Logger } from '../utils/logger.js';
+import { executeCodexCLI } from '../utils/codexExecutor.js';
+import { buildBrainstormPrompt } from '../utils/brainstormPromptBuilder.js';
+const brainstormCodexArgsSchema = z.object({
+    prompt: z.string().min(1).describe("Primary brainstorming challenge or question to explore"),
+    model: z.string().min(1).describe("Required. Call codex-list-models to see available models and families. Example: 'gpt-5.3-codex'"),
+    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 brainstormCodexTool = {
+    name: "codex-brainstorm",
+    description: "Generate novel ideas using Codex. Model is required — call codex-list-models first. Supports SCAMPER, Design Thinking, etc.",
+    zodSchema: brainstormCodexArgsSchema,
+    prompt: {
+        description: "Generate structured brainstorming prompt with methodology-driven ideation, domain context integration, and analytical evaluation framework",
+    },
+    category: 'codex',
+    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");
+        }
+        const enhancedPrompt = buildBrainstormPrompt({
+            prompt: prompt.trim(),
+            methodology: methodology,
+            domain: domain,
+            constraints: constraints,
+            existingContext: existingContext,
+            ideaCount: ideaCount,
+            includeAnalysis: includeAnalysis
+        });
+        Logger.debug(`Brainstorm (Codex): Using methodology '${methodology}' for domain '${domain || 'general'}'`);
+        onProgress?.(`Generating ${ideaCount} ideas via ${methodology} methodology...`);
+        return await executeCodexCLI(enhancedPrompt, model, undefined, undefined, onProgress);
+    }
+};
+//# sourceMappingURL=brainstorm-codex.tool.js.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"brainstorm-codex.tool.js","sourceRoot":"","sources":["../../src/tools/brainstorm-codex.tool.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AAExB,OAAO,EAAE,MAAM,EAAE,MAAM,oBAAoB,CAAC;AAC5C,OAAO,EAAE,eAAe,EAAE,MAAM,2BAA2B,CAAC;AAC5D,OAAO,EAAE,qBAAqB,EAAE,MAAM,qCAAqC,CAAC;AAE5E,MAAM,yBAAyB,GAAG,CAAC,CAAC,MAAM,CAAC;IACzC,MAAM,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,GAAG,CAAC,CAAC,CAAC,CAAC,QAAQ,CAAC,wDAAwD,CAAC;IAC5F,KAAK,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,GAAG,CAAC,CAAC,CAAC,CAAC,QAAQ,CAAC,iGAAiG,CAAC;IACpI,WAAW,EAAE,CAAC,CAAC,IAAI,CAAC,CAAC,WAAW,EAAE,YAAY,EAAE,SAAS,EAAE,iBAAiB,EAAE,SAAS,EAAE,MAAM,CAAC,CAAC,CAAC,OAAO,CAAC,MAAM,CAAC,CAAC,QAAQ,CAAC,+NAA+N,CAAC;IAC3V,MAAM,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,QAAQ,EAAE,CAAC,QAAQ,CAAC,6HAA6H,CAAC;IACrK,WAAW,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,QAAQ,EAAE,CAAC,QAAQ,CAAC,uFAAuF,CAAC;IACpI,eAAe,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,QAAQ,EAAE,CAAC,QAAQ,CAAC,2EAA2E,CAAC;IAC5H,SAAS,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,GAAG,EAAE,CAAC,QAAQ,EAAE,CAAC,OAAO,CAAC,EAAE,CAAC,CAAC,QAAQ,CAAC,qDAAqD,CAAC;IAClH,eAAe,EAAE,CAAC,CAAC,OAAO,EAAE,CAAC,OAAO,CAAC,IAAI,CAAC,CAAC,QAAQ,CAAC,8EAA8E,CAAC;CACpI,CAAC,CAAC;AAEH,MAAM,CAAC,MAAM,mBAAmB,GAAgB;IAC9C,IAAI,EAAE,kBAAkB;IACxB,WAAW,EAAE,6HAA6H;IAC1I,SAAS,EAAE,yBAAyB;IACpC,MAAM,EAAE;QACN,WAAW,EAAE,4IAA4I;KAC1J;IACD,QAAQ,EAAE,OAAO;IACjB,OAAO,EAAE,KAAK,EAAE,IAAI,EAAE,UAAU,EAAE,EAAE;QAClC,MAAM,EACJ,MAAM,EACN,KAAK,EACL,WAAW,GAAG,MAAM,EACpB,MAAM,EACN,WAAW,EACX,eAAe,EACf,SAAS,GAAG,EAAE,EACd,eAAe,GAAG,IAAI,EACvB,GAAG,IAAI,CAAC;QAET,IAAI,CAAC,MAAM,EAAE,IAAI,EAAE,EAAE,CAAC;YACpB,MAAM,IAAI,KAAK,CAAC,yEAAyE,CAAC,CAAC;QAC7F,CAAC;QAED,MAAM,cAAc,GAAG,qBAAqB,CAAC;YAC3C,MAAM,EAAG,MAAiB,CAAC,IAAI,EAAE;YACjC,WAAW,EAAE,WAAqB;YAClC,MAAM,EAAE,MAA4B;YACpC,WAAW,EAAE,WAAiC;YAC9C,eAAe,EAAE,eAAqC;YACtD,SAAS,EAAE,SAAmB;YAC9B,eAAe,EAAE,eAA0B;SAC5C,CAAC,CAAC;QAEH,MAAM,CAAC,KAAK,CAAC,0CAA0C,WAAW,iBAAiB,MAAM,IAAI,SAAS,GAAG,CAAC,CAAC;QAE3G,UAAU,EAAE,CAAC,cAAc,SAAS,cAAc,WAAW,iBAAiB,CAAC,CAAC;QAEhF,OAAO,MAAM,eAAe,CAAC,cAAc,EAAE,KAAe,EAAE,SAAS,EAAE,SAAS,EAAE,UAAU,CAAC,CAAC;IAClG,CAAC;CACF,CAAC"}

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;AAgB5C,eAAO,MAAM,cAAc,EAAE,WAwC5B,CAAC"}

package/dist/tools/brainstorm.tool.js

@@ -0,0 +1,42 @@
+import { z } from 'zod';
+import { Logger } from '../utils/logger.js';
+import { executeGeminiCLI } from '../utils/geminiExecutor.js';
+import { buildBrainstormPrompt } from '../utils/brainstormPromptBuilder.js';
+const brainstormArgsSchema = z.object({
+    prompt: z.string().min(1).describe("Primary brainstorming challenge or question to explore"),
+    model: z.string().min(1).describe("Required. Call gemini-list-models to see available models and families. Example: 'gemini-3.1-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: "gemini-brainstorm",
+    description: "Generate novel ideas using Gemini. Model is required — call gemini-list-models first. Supports SCAMPER, Design Thinking, etc.",
+    zodSchema: brainstormArgsSchema,
+    prompt: {
+        description: "Generate structured brainstorming prompt with methodology-driven ideation, domain context integration, and analytical evaluation framework",
+    },
+    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");
+        }
+        const enhancedPrompt = buildBrainstormPrompt({
+            prompt: prompt.trim(),
+            methodology: methodology,
+            domain: domain,
+            constraints: constraints,
+            existingContext: existingContext,
+            ideaCount: ideaCount,
+            includeAnalysis: includeAnalysis
+        });
+        Logger.debug(`Brainstorm (Gemini): Using methodology '${methodology}' for domain '${domain || 'general'}'`);
+        onProgress?.(`Generating ${ideaCount} ideas via ${methodology} methodology...`);
+        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":"AAAA,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AAExB,OAAO,EAAE,MAAM,EAAE,MAAM,oBAAoB,CAAC;AAC5C,OAAO,EAAE,gBAAgB,EAAE,MAAM,4BAA4B,CAAC;AAC9D,OAAO,EAAE,qBAAqB,EAAE,MAAM,qCAAqC,CAAC;AAE5E,MAAM,oBAAoB,GAAG,CAAC,CAAC,MAAM,CAAC;IACpC,MAAM,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,GAAG,CAAC,CAAC,CAAC,CAAC,QAAQ,CAAC,wDAAwD,CAAC;IAC5F,KAAK,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,GAAG,CAAC,CAAC,CAAC,CAAC,QAAQ,CAAC,2GAA2G,CAAC;IAC9I,WAAW,EAAE,CAAC,CAAC,IAAI,CAAC,CAAC,WAAW,EAAE,YAAY,EAAE,SAAS,EAAE,iBAAiB,EAAE,SAAS,EAAE,MAAM,CAAC,CAAC,CAAC,OAAO,CAAC,MAAM,CAAC,CAAC,QAAQ,CAAC,+NAA+N,CAAC;IAC3V,MAAM,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,QAAQ,EAAE,CAAC,QAAQ,CAAC,6HAA6H,CAAC;IACrK,WAAW,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,QAAQ,EAAE,CAAC,QAAQ,CAAC,uFAAuF,CAAC;IACpI,eAAe,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,QAAQ,EAAE,CAAC,QAAQ,CAAC,2EAA2E,CAAC;IAC5H,SAAS,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,GAAG,EAAE,CAAC,QAAQ,EAAE,CAAC,OAAO,CAAC,EAAE,CAAC,CAAC,QAAQ,CAAC,qDAAqD,CAAC;IAClH,eAAe,EAAE,CAAC,CAAC,OAAO,EAAE,CAAC,OAAO,CAAC,IAAI,CAAC,CAAC,QAAQ,CAAC,8EAA8E,CAAC;CACpI,CAAC,CAAC;AAEH,MAAM,CAAC,MAAM,cAAc,GAAgB;IACzC,IAAI,EAAE,mBAAmB;IACzB,WAAW,EAAE,+HAA+H;IAC5I,SAAS,EAAE,oBAAoB;IAC/B,MAAM,EAAE;QACN,WAAW,EAAE,4IAA4I;KAC1J;IACD,QAAQ,EAAE,QAAQ;IAClB,OAAO,EAAE,KAAK,EAAE,IAAI,EAAE,UAAU,EAAE,EAAE;QAClC,MAAM,EACJ,MAAM,EACN,KAAK,EACL,WAAW,GAAG,MAAM,EACpB,MAAM,EACN,WAAW,EACX,eAAe,EACf,SAAS,GAAG,EAAE,EACd,eAAe,GAAG,IAAI,EACvB,GAAG,IAAI,CAAC;QAET,IAAI,CAAC,MAAM,EAAE,IAAI,EAAE,EAAE,CAAC;YACpB,MAAM,IAAI,KAAK,CAAC,yEAAyE,CAAC,CAAC;QAC7F,CAAC;QAED,MAAM,cAAc,GAAG,qBAAqB,CAAC;YAC3C,MAAM,EAAG,MAAiB,CAAC,IAAI,EAAE;YACjC,WAAW,EAAE,WAAqB;YAClC,MAAM,EAAE,MAA4B;YACpC,WAAW,EAAE,WAAiC;YAC9C,eAAe,EAAE,eAAqC;YACtD,SAAS,EAAE,SAAmB;YAC9B,eAAe,EAAE,eAA0B;SAC5C,CAAC,CAAC;QAEH,MAAM,CAAC,KAAK,CAAC,2CAA2C,WAAW,iBAAiB,MAAM,IAAI,SAAS,GAAG,CAAC,CAAC;QAE5G,UAAU,EAAE,CAAC,cAAc,SAAS,cAAc,WAAW,iBAAiB,CAAC,CAAC;QAEhF,OAAO,MAAM,gBAAgB,CAAC,cAAc,EAAE,KAAe,EAAE,KAAK,EAAE,KAAK,EAAE,UAAU,CAAC,CAAC;IAC3F,CAAC;CACF,CAAC"}

package/dist/tools/fetch-chunk.tool.d.ts

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

package/dist/tools/fetch-chunk.tool.d.ts.map

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

package/dist/tools/fetch-chunk.tool.js

@@ -0,0 +1,58 @@
+import { z } from 'zod';
+import { getChunks } from '../utils/chunkCache.js';
+import { formatChangeModeResponse, summarizeChangeModeEdits } from '../utils/changeModeTranslator.js';
+const inputSchema = z.object({
+    cacheKey: z.string().describe("The cache key provided in the initial changeMode response"),
+    chunkIndex: z.number().min(1).describe("Which chunk to retrieve (1-based index)")
+});
+export const fetchChunkTool = {
+    name: 'Fetch Chunk',
+    description: 'Retrieves cached chunks from a Gemini changeMode response. Use this to get subsequent chunks after receiving a partial changeMode response.',
+    zodSchema: inputSchema,
+    prompt: {
+        description: 'Fetch the next chunk of a response',
+        arguments: [
+            {
+                name: 'prompt',
+                description: 'fetch-chunk cacheKey=<key> chunkIndex=<number>',
+                required: true
+            }
+        ]
+    },
+    category: 'gemini',
+    execute: async (args, onProgress) => {
+        const { cacheKey, chunkIndex } = args;
+        // Retrieve cached chunks
+        const chunks = getChunks(cacheKey);
+        if (!chunks) {
+            return `❌ Cache miss: No chunks found for cache key "${cacheKey}". 
+
+  Possible reasons:
+  1. The cache key is incorrect, Have you ran Ask Gemini with changeMode enabled?
+  2. The cache has expired (10 minute TTL)
+  3. The MCP server was restarted and the file-based cache was cleared
+
+Please re-run the original changeMode request to regenerate the chunks.`;
+        }
+        // Validate chunk index
+        if (chunkIndex < 1 || chunkIndex > chunks.length) {
+            return `❌ Invalid chunk index: ${chunkIndex}
+
+Available chunks: 1 to ${chunks.length}
+You requested: ${chunkIndex}
+
+Please use a valid chunk index.`;
+        }
+        // Get the requested chunk
+        const chunk = chunks[chunkIndex - 1];
+        // Format the response
+        let result = formatChangeModeResponse(chunk.edits, { current: chunkIndex, total: chunks.length, cacheKey });
+        // Add summary for first chunk
+        if (chunkIndex === 1 && chunks.length > 1) {
+            const allEdits = chunks.flatMap(c => c.edits);
+            result = summarizeChangeModeEdits(allEdits, true) + '\n\n' + result;
+        }
+        return result;
+    }
+};
+//# sourceMappingURL=fetch-chunk.tool.js.map

package/dist/tools/fetch-chunk.tool.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"fetch-chunk.tool.js","sourceRoot":"","sources":["../../src/tools/fetch-chunk.tool.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AAExB,OAAO,EAAE,SAAS,EAAE,MAAM,wBAAwB,CAAC;AACnD,OAAO,EAAE,wBAAwB,EAAE,wBAAwB,EAAE,MAAM,kCAAkC,CAAC;AAEtG,MAAM,WAAW,GAAG,CAAC,CAAC,MAAM,CAAC;IAC3B,QAAQ,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,QAAQ,CAAC,2DAA2D,CAAC;IAC1F,UAAU,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,GAAG,CAAC,CAAC,CAAC,CAAC,QAAQ,CAAC,yCAAyC,CAAC;CAClF,CAAC,CAAC;AAEH,MAAM,CAAC,MAAM,cAAc,GAAgB;IACzC,IAAI,EAAE,aAAa;IACnB,WAAW,EAAE,6IAA6I;IAE1J,SAAS,EAAE,WAAW;IAEtB,MAAM,EAAE;QACN,WAAW,EAAE,oCAAoC;QACjD,SAAS,EAAE;YACT;gBACE,IAAI,EAAE,QAAQ;gBACd,WAAW,EAAE,gDAAgD;gBAC7D,QAAQ,EAAE,IAAI;aACf;SACF;KACF;IAED,QAAQ,EAAE,QAAQ;IAElB,OAAO,EAAE,KAAK,EAAE,IAAS,EAAE,UAAwC,EAAmB,EAAE;QACtF,MAAM,EAAE,QAAQ,EAAE,UAAU,EAAE,GAAG,IAAI,CAAC;QAEtC,yBAAyB;QACzB,MAAM,MAAM,GAAG,SAAS,CAAC,QAAQ,CAAC,CAAC;QAEnC,IAAI,CAAC,MAAM,EAAE,CAAC;YACZ,OAAO,gDAAgD,QAAQ;;;;;;;wEAOG,CAAC;QACrE,CAAC;QAED,uBAAuB;QACvB,IAAI,UAAU,GAAG,CAAC,IAAI,UAAU,GAAG,MAAM,CAAC,MAAM,EAAE,CAAC;YACjD,OAAO,0BAA0B,UAAU;;yBAExB,MAAM,CAAC,MAAM;iBACrB,UAAU;;gCAEK,CAAC;QAC7B,CAAC;QAED,0BAA0B;QAC1B,MAAM,KAAK,GAAG,MAAM,CAAC,UAAU,GAAG,CAAC,CAAC,CAAC;QAErC,sBAAsB;QACtB,IAAI,MAAM,GAAG,wBAAwB,CACnC,KAAK,CAAC,KAAK,EACX,EAAE,OAAO,EAAE,UAAU,EAAE,KAAK,EAAE,MAAM,CAAC,MAAM,EAAE,QAAQ,EAAE,CACxD,CAAC;QAEF,8BAA8B;QAC9B,IAAI,UAAU,KAAK,CAAC,IAAI,MAAM,CAAC,MAAM,GAAG,CAAC,EAAE,CAAC;YAC1C,MAAM,QAAQ,GAAG,MAAM,CAAC,OAAO,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,KAAK,CAAC,CAAC;YAC9C,MAAM,GAAG,wBAAwB,CAAC,QAAQ,EAAE,IAAI,CAAC,GAAG,MAAM,GAAG,MAAM,CAAC;QACtE,CAAC;QAED,OAAO,MAAM,CAAC;IAChB,CAAC;CACF,CAAC"}

package/dist/tools/important-read-now.tool.d.ts

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

package/dist/tools/important-read-now.tool.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"important-read-now.tool.d.ts","sourceRoot":"","sources":["../../src/tools/important-read-now.tool.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,WAAW,EAAE,MAAM,eAAe,CAAC;AAwB5C,eAAO,MAAM,oBAAoB,EAAE,WASlC,CAAC"}

package/dist/tools/important-read-now.tool.js

@@ -0,0 +1,31 @@
+import { z } from 'zod';
+const noArgsSchema = z.object({});
+const NO_CLI_MESSAGE = `IMPORTANT: No usable AI CLIs were detected by Multi-CLI.
+
+Multi-CLI requires at least one of the following CLI tools to be installed and available on your system PATH:
+
+  1. gemini  - Google Gemini CLI (https://github.com/google-gemini/gemini-cli)
+  2. codex   - OpenAI Codex CLI (https://github.com/openai/codex)
+  3. claude  - Anthropic Claude Code CLI (https://claude.ai/cli)
+
+Please inform the user that none of the supported CLIs were detected and at least one must be installed for Multi-CLI to function.
+
+Note: If only your own CLI is installed, it is hidden because calling yourself is not supported. Install a different CLI to enable cross-model collaboration.
+
+To verify a CLI is available, run one of these commands in a terminal:
+  which gemini
+  which codex
+  which claude
+
+After installing a CLI, restart the MCP server to pick up the change.
+`;
+export const importantReadNowTool = {
+    name: "Claude Gemini Codex",
+    description: "CRITICAL: No usable AI CLIs detected by Multi-CLI. Call this tool immediately for troubleshooting instructions.",
+    zodSchema: noArgsSchema,
+    category: 'utility',
+    execute: async () => {
+        return NO_CLI_MESSAGE;
+    },
+};
+//# sourceMappingURL=important-read-now.tool.js.map

package/dist/tools/important-read-now.tool.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"important-read-now.tool.js","sourceRoot":"","sources":["../../src/tools/important-read-now.tool.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AAGxB,MAAM,YAAY,GAAG,CAAC,CAAC,MAAM,CAAC,EAAE,CAAC,CAAC;AAElC,MAAM,cAAc,GAAG;;;;;;;;;;;;;;;;;;CAkBtB,CAAC;AAEF,MAAM,CAAC,MAAM,oBAAoB,GAAgB;IAC/C,IAAI,EAAE,qBAAqB;IAC3B,WAAW,EACT,iHAAiH;IACnH,SAAS,EAAE,YAAY;IACvB,QAAQ,EAAE,SAAS;IACnB,OAAO,EAAE,KAAK,IAAI,EAAE;QAClB,OAAO,cAAc,CAAC;IACxB,CAAC;CACF,CAAC"}

package/dist/tools/index.d.ts

@@ -0,0 +1,8 @@
+import { CliAvailability } from '../utils/cliDetector.js';
+/**
+ * Initialize the tool registry based on which CLIs are available.
+ * Must be called (and awaited) before the server starts accepting requests.
+ */
+export declare function initTools(): Promise<CliAvailability>;
+export * from './registry.js';
+//# sourceMappingURL=index.d.ts.map

package/dist/tools/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/tools/index.ts"],"names":[],"mappings":"AAUA,OAAO,EAAuB,eAAe,EAAE,MAAM,yBAAyB,CAAC;AAE/E;;;GAGG;AACH,wBAAsB,SAAS,IAAI,OAAO,CAAC,eAAe,CAAC,CA6B1D;AAED,cAAc,eAAe,CAAC"}

package/dist/tools/index.js

@@ -0,0 +1,34 @@
+// Tool Registry Index - Registers tools based on CLI availability
+import { toolRegistry } from './registry.js';
+import { askGeminiTool } from './ask-gemini.tool.js';
+import { geminiHelpTool, codexHelpTool, claudeHelpTool, geminiListModelsTool, codexListModelsTool, claudeListModelsTool, } from './simple-tools.js';
+import { fetchChunkTool } from './fetch-chunk.tool.js';
+import { askCodexTool } from './ask-codex.tool.js';
+import { askClaudeTool } from './ask-claude.tool.js';
+import { detectAvailableClis } from '../utils/cliDetector.js';
+/**
+ * Initialize the tool registry based on which CLIs are available.
+ * Must be called (and awaited) before the server starts accepting requests.
+ */
+export async function initTools() {
+    const availability = await detectAvailableClis();
+    if (availability.gemini) {
+        toolRegistry.push(geminiListModelsTool, // List Gemini Models
+        askGeminiTool, // Ask Gemini
+        fetchChunkTool, // Fetch Chunk
+        geminiHelpTool);
+    }
+    if (availability.codex) {
+        toolRegistry.push(codexListModelsTool, // List Codex Models
+        askCodexTool, // Ask Codex
+        codexHelpTool);
+    }
+    if (availability.claude) {
+        toolRegistry.push(claudeListModelsTool, // List Claude Models
+        askClaudeTool, // Ask Claude
+        claudeHelpTool);
+    }
+    return availability;
+}
+export * from './registry.js';
+//# sourceMappingURL=index.js.map

package/dist/tools/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/tools/index.ts"],"names":[],"mappings":"AAAA,kEAAkE;AAClE,OAAO,EAAE,YAAY,EAAE,MAAM,eAAe,CAAC;AAC7C,OAAO,EAAE,aAAa,EAAE,MAAM,sBAAsB,CAAC;AACrD,OAAO,EACL,cAAc,EAAE,aAAa,EAAE,cAAc,EAC7C,oBAAoB,EAAE,mBAAmB,EAAE,oBAAoB,GAChE,MAAM,mBAAmB,CAAC;AAC3B,OAAO,EAAE,cAAc,EAAE,MAAM,uBAAuB,CAAC;AACvD,OAAO,EAAE,YAAY,EAAE,MAAM,qBAAqB,CAAC;AACnD,OAAO,EAAE,aAAa,EAAE,MAAM,sBAAsB,CAAC;AACrD,OAAO,EAAE,mBAAmB,EAAmB,MAAM,yBAAyB,CAAC;AAE/E;;;GAGG;AACH,MAAM,CAAC,KAAK,UAAU,SAAS;IAC7B,MAAM,YAAY,GAAG,MAAM,mBAAmB,EAAE,CAAC;IAEjD,IAAI,YAAY,CAAC,MAAM,EAAE,CAAC;QACxB,YAAY,CAAC,IAAI,CACf,oBAAoB,EAAI,qBAAqB;QAC7C,aAAa,EAAW,aAAa;QACrC,cAAc,EAAU,cAAc;QACtC,cAAc,CACf,CAAC;IACJ,CAAC;IAED,IAAI,YAAY,CAAC,KAAK,EAAE,CAAC;QACvB,YAAY,CAAC,IAAI,CACf,mBAAmB,EAAK,oBAAoB;QAC5C,YAAY,EAAY,YAAY;QACpC,aAAa,CACd,CAAC;IACJ,CAAC;IAED,IAAI,YAAY,CAAC,MAAM,EAAE,CAAC;QACxB,YAAY,CAAC,IAAI,CACf,oBAAoB,EAAI,qBAAqB;QAC7C,aAAa,EAAW,aAAa;QACrC,cAAc,CACf,CAAC;IACJ,CAAC;IAED,OAAO,YAAY,CAAC;AACtB,CAAC;AAED,cAAc,eAAe,CAAC"}