@osanoai/multicli 1.5.0

package/README.md

@@ -0,0 +1,209 @@
+# Osano AI - Multi CLI MCP
+
+**The AI collab no one asked for, but everyone needed.**
+
+An MCP server that lets Claude, Gemini, and Codex call each other as tools. Because why argue about which AI is best when you can make them work together?
+
+```
+Claude: "Hey Gemini, what do you think about this code?"
+Gemini: "It's mass. Let me ask Codex for a second opinion."
+Codex:  "You're both wrong. Here's the fix."
+```
+
+## What It Does
+
+Multi-CLI sits between your AI clients and bridges them via the [Model Context Protocol](https://modelcontextprotocol.io/). Install it once, and whichever AI you're talking to gains the ability to call the others.
+
+- **Claude** can ask Gemini or Codex for help
+- **Gemini** can delegate to Claude or Codex
+- **Codex** can consult Claude or Gemini
+- Each client's own tools are hidden (no talking to yourself, that's weird)
+- Auto-detects which CLIs you have installed — only shows what's available
+
+## Prerequisites
+
+You need **Node.js >= 18** and at least **two** of these CLIs installed:
+
+| CLI | Install |
+|-----|---------|
+| [Gemini CLI](https://github.com/google-gemini/gemini-cli) | `npm install -g @google/gemini-cli` |
+| [Claude Code](https://docs.anthropic.com/en/docs/claude-code/overview) | `npm install -g @anthropic-ai/claude-code` |
+| [Codex CLI](https://github.com/openai/codex) | `npm install -g @openai/codex` |
+
+> Why two? Because one AI talking to itself is a monologue, not a collaboration.
+
+---
+
+## Installation
+
+### Claude Code
+
+```bash
+claude mcp add "Multi-CLI" -- npx -y "Multi-CLI"
+```
+
+That's it. Restart Claude Code and Gemini + Codex tools appear automatically.
+
+<details>
+<summary>Claude Desktop (JSON config)</summary>
+
+Add to your config file (`~/Library/Application Support/Claude/claude_desktop_config.json` on macOS):
+
+```json
+{
+  "mcpServers": {
+    "multicli-mcp": {
+      "command": "npx",
+      "args": ["-y", "multicli-mcp"]
+    }
+  }
+}
+```
+
+Restart Claude Desktop completely after saving.
+</details>
+
+---
+
+### Gemini CLI
+
+```bash
+gemini mcp add --scope user multicli-mcp npx -y multicli-mcp
+```
+
+Restart the Gemini CLI and Claude + Codex tools will be available.
+
+<details>
+<summary>Manual config (~/.gemini/settings.json)</summary>
+
+```json
+{
+  "mcpServers": {
+    "multicli-mcp": {
+      "command": "npx",
+      "args": ["-y", "multicli-mcp"]
+    }
+  }
+}
+```
+</details>
+
+---
+
+### Codex CLI
+
+```bash
+codex mcp add multicli-mcp -- npx -y multicli-mcp
+```
+
+Restart Codex and Claude + Gemini tools will be available.
+
+<details>
+<summary>Manual config (~/.codex/config.toml) or pass --mcp-config</summary>
+
+```bash
+codex --mcp-config mcp.json
+```
+
+Where `mcp.json` contains:
+
+```json
+{
+  "mcpServers": {
+    "Multi-CLI": {
+      "command": "npx",
+      "args": ["-y", "multicli"]
+    }
+  }
+}
+```
+</details>
+
+---
+
+### Any Other MCP Client
+
+Multi-CLI uses standard stdio transport. If your client supports MCP, point it at:
+
+```
+npx -y multicli
+```
+
+---
+
+## Available Tools
+
+Once connected, your AI client gains access to tools for the *other* CLIs (never its own):
+
+| Tool | Description |
+|------|-------------|
+| `List Gemini Models` | List available Gemini models and their strengths |
+| `Ask Gemini` | Ask Gemini a question or give it a task |
+| `Fetch Chunk` | Retrieve chunked responses from Gemini |
+| `Gemini Help` | Get Gemini CLI help info |
+| `List Codex Models` | List available Codex models |
+| `Ask Codex` | Ask Codex a question or give it a task |
+| `Codex Help` | Get Codex CLI help info |
+| `List Claude Models` | List available Claude models |
+| `Ask Claude` | Ask Claude a question or give it a task |
+| `Claude Help` | Get Claude Code CLI help info |
+
+## Usage Examples
+
+Once installed, just talk naturally to your AI:
+
+```
+"Ask Gemini what it thinks about this architecture"
+"Have Codex review this function for performance issues"
+"Get Claude's opinion on this error message"
+"Use Gemini to analyze @largefile.js"
+```
+
+Or get a second opinion on anything:
+
+```
+"I want three perspectives on how to refactor this module —
+ ask Gemini and Codex what they'd do differently"
+```
+
+## How It Works
+
+```
+┌─────────────┐     MCP (stdio)     ┌──────────────┐     CLI calls     ┌─────────────┐
+│  Your AI    │ ◄──────────────────► │ Multi-CLI │ ───────────────► │ Other AIs   │
+│  Client     │                      │   server     │                   │ (CLI tools) │
+└─────────────┘                      └──────────────┘                   └─────────────┘
+
+1. Your AI client connects to Multi-CLI via MCP
+2. Multi-CLI detects which CLIs are installed on your system
+3. It registers tools for the OTHER clients (hides tools for the calling client)
+4. When a tool is called, Multi-CLI executes the corresponding CLI command
+5. Results flow back through MCP to your AI client
+```
+
+## Troubleshooting
+
+**"No usable AI CLIs detected"**
+Make sure at least one other CLI is installed and on your PATH:
+```bash
+which gemini && which codex && which claude
+```
+
+**No tools showing up?**
+If only your own CLI is installed, Multi-CLI hides it (no self-calls). Install a *different* CLI to enable cross-model collaboration.
+
+**MCP server not responding?**
+1. Check that Node.js >= 18 is installed
+2. Run `npx multicli` directly to see if it starts
+3. Restart your AI client completely
+
+## Development
+
+```bash
+git clone https://github.com/osanoai/multicli.git
+cd multicli
+npm install
+npm run build
+npm run dev
+```
+

package/dist/clientFilter.d.ts

@@ -0,0 +1,5 @@
+import { UnifiedTool } from './tools/registry.js';
+export declare function getExcludedCategory(clientName: string | undefined): UnifiedTool['category'] | undefined;
+export declare function filterToolsForClient(tools: UnifiedTool[], clientName: string | undefined): UnifiedTool[];
+export declare function isToolBlockedForClient(tool: UnifiedTool | undefined, clientName: string | undefined): boolean;
+//# sourceMappingURL=clientFilter.d.ts.map

package/dist/clientFilter.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"clientFilter.d.ts","sourceRoot":"","sources":["../src/clientFilter.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,WAAW,EAAE,MAAM,qBAAqB,CAAC;AAalD,wBAAgB,mBAAmB,CAAC,UAAU,EAAE,MAAM,GAAG,SAAS,GAAG,WAAW,CAAC,UAAU,CAAC,GAAG,SAAS,CAGvG;AAED,wBAAgB,oBAAoB,CAAC,KAAK,EAAE,WAAW,EAAE,EAAE,UAAU,EAAE,MAAM,GAAG,SAAS,GAAG,WAAW,EAAE,CAKxG;AAED,wBAAgB,sBAAsB,CAAC,IAAI,EAAE,WAAW,GAAG,SAAS,EAAE,UAAU,EAAE,MAAM,GAAG,SAAS,GAAG,OAAO,CAI7G"}

package/dist/clientFilter.js

@@ -0,0 +1,27 @@
+/**
+ * Client-based tool filtering: hide a client's own tools
+ * (no point asking yourself for a second opinion).
+ */
+const CLIENT_EXCLUSIONS = {
+    'claude-code': 'claude',
+    'codex-mcp-client': 'codex',
+    'gemini-cli-mcp-client': 'gemini',
+};
+export function getExcludedCategory(clientName) {
+    if (!clientName)
+        return undefined;
+    return CLIENT_EXCLUSIONS[clientName];
+}
+export function filterToolsForClient(tools, clientName) {
+    const excluded = getExcludedCategory(clientName);
+    if (!excluded)
+        return tools;
+    return tools.filter(t => t.category !== excluded);
+}
+export function isToolBlockedForClient(tool, clientName) {
+    if (!tool)
+        return false;
+    const excluded = getExcludedCategory(clientName);
+    return excluded !== undefined && tool.category === excluded;
+}
+//# sourceMappingURL=clientFilter.js.map

package/dist/clientFilter.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"clientFilter.js","sourceRoot":"","sources":["../src/clientFilter.ts"],"names":[],"mappings":"AAEA;;;GAGG;AAEH,MAAM,iBAAiB,GAA4C;IACjE,aAAa,EAAa,QAAQ;IAClC,kBAAkB,EAAQ,OAAO;IACjC,uBAAuB,EAAG,QAAQ;CACnC,CAAC;AAEF,MAAM,UAAU,mBAAmB,CAAC,UAA8B;IAChE,IAAI,CAAC,UAAU;QAAE,OAAO,SAAS,CAAC;IAClC,OAAO,iBAAiB,CAAC,UAAU,CAAC,CAAC;AACvC,CAAC;AAED,MAAM,UAAU,oBAAoB,CAAC,KAAoB,EAAE,UAA8B;IACvF,MAAM,QAAQ,GAAG,mBAAmB,CAAC,UAAU,CAAC,CAAC;IACjD,IAAI,CAAC,QAAQ;QAAE,OAAO,KAAK,CAAC;IAE5B,OAAO,KAAK,CAAC,MAAM,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,QAAQ,KAAK,QAAQ,CAAC,CAAC;AACpD,CAAC;AAED,MAAM,UAAU,sBAAsB,CAAC,IAA6B,EAAE,UAA8B;IAClG,IAAI,CAAC,IAAI;QAAE,OAAO,KAAK,CAAC;IACxB,MAAM,QAAQ,GAAG,mBAAmB,CAAC,UAAU,CAAC,CAAC;IACjD,OAAO,QAAQ,KAAK,SAAS,IAAI,IAAI,CAAC,QAAQ,KAAK,QAAQ,CAAC;AAC9D,CAAC"}

package/dist/constants.d.ts

@@ -0,0 +1,88 @@
+export declare const ERROR_MESSAGES: {
+    readonly QUOTA_EXCEEDED: "Quota exceeded for Gemini model requests";
+    readonly QUOTA_EXCEEDED_SHORT: "⚠️ Gemini daily quota exceeded. Please try again later.";
+    readonly TOOL_NOT_FOUND: "not found in registry";
+    readonly NO_PROMPT_PROVIDED: "Please provide a prompt for analysis. Use @ syntax to include files (e.g., '@largefile.js explain what this does') or ask general questions";
+};
+export declare const STATUS_MESSAGES: {
+    readonly SANDBOX_EXECUTING: "🔒 Executing CLI command in sandbox mode...";
+    readonly GEMINI_RESPONSE: "Gemini response:";
+    readonly CODEX_RESPONSE: "Codex response:";
+    readonly CLAUDE_RESPONSE: "Claude response:";
+    readonly PROCESSING_START: "🔍 Starting analysis (may take 5-15 minutes for large codebases)";
+    readonly PROCESSING_CONTINUE: "⏳ Still processing...";
+    readonly PROCESSING_COMPLETE: "✅ Analysis completed successfully";
+};
+export declare const PROTOCOL: {
+    readonly ROLES: {
+        readonly USER: "user";
+        readonly ASSISTANT: "assistant";
+    };
+    readonly CONTENT_TYPES: {
+        readonly TEXT: "text";
+    };
+    readonly STATUS: {
+        readonly SUCCESS: "success";
+        readonly ERROR: "error";
+        readonly FAILED: "failed";
+        readonly REPORT: "report";
+    };
+    readonly NOTIFICATIONS: {
+        readonly PROGRESS: "notifications/progress";
+    };
+    readonly KEEPALIVE_INTERVAL: 25000;
+};
+export declare const CLI: {
+    readonly COMMANDS: {
+        readonly GEMINI: "gemini";
+        readonly CODEX: "codex";
+        readonly CLAUDE: "claude";
+        readonly ECHO: "echo";
+    };
+    readonly FLAGS: {
+        readonly MODEL: "-m";
+        readonly SANDBOX: "-s";
+        readonly PROMPT: "-p";
+        readonly HELP: "-help";
+    };
+    readonly SUBCOMMANDS: {
+        readonly EXEC: "exec";
+    };
+    readonly CODEX_FLAGS: {
+        readonly MODEL: "-m";
+        readonly SANDBOX: "-s";
+        readonly APPROVAL: "-a";
+        readonly COLOR: "--color";
+        readonly FULL_AUTO: "--full-auto";
+        readonly SKIP_GIT_CHECK: "--skip-git-repo-check";
+    };
+    readonly CLAUDE_FLAGS: {
+        readonly PRINT: "--print";
+        readonly MODEL: "--model";
+        readonly OUTPUT_FORMAT: "--output-format";
+        readonly PERMISSION_MODE: "--permission-mode";
+        readonly MAX_BUDGET: "--max-budget-usd";
+        readonly SYSTEM_PROMPT: "--system-prompt";
+        readonly TOOLS: "--tools";
+        readonly HELP: "--help";
+    };
+    readonly DEFAULTS: {
+        readonly BOOLEAN_TRUE: "true";
+        readonly BOOLEAN_FALSE: "false";
+    };
+};
+export interface ToolArguments {
+    prompt?: string;
+    model?: string;
+    sandbox?: boolean | string;
+    changeMode?: boolean | string;
+    chunkIndex?: number | string;
+    chunkCacheKey?: string;
+    message?: string;
+    approvalPolicy?: string;
+    permissionMode?: string;
+    maxBudgetUsd?: number;
+    systemPrompt?: string;
+    [key: string]: string | boolean | number | undefined;
+}
+//# sourceMappingURL=constants.d.ts.map

package/dist/constants.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"constants.d.ts","sourceRoot":"","sources":["../src/constants.ts"],"names":[],"mappings":"AAGA,eAAO,MAAM,cAAc;;;;;CAKjB,CAAC;AAGX,eAAO,MAAM,eAAe;;;;;;;;CASlB,CAAC;AAGX,eAAO,MAAM,QAAQ;;;;;;;;;;;;;;;;;;CAuBX,CAAC;AAIX,eAAO,MAAM,GAAG;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;CA4CN,CAAC;AAIX,MAAM,WAAW,aAAa;IAC5B,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,OAAO,CAAC,EAAE,OAAO,GAAG,MAAM,CAAC;IAC3B,UAAU,CAAC,EAAE,OAAO,GAAG,MAAM,CAAC;IAC9B,UAAU,CAAC,EAAE,MAAM,GAAG,MAAM,CAAC;IAC7B,aAAa,CAAC,EAAE,MAAM,CAAC;IACvB,OAAO,CAAC,EAAE,MAAM,CAAC;IAEjB,cAAc,CAAC,EAAE,MAAM,CAAC;IACxB,cAAc,CAAC,EAAE,MAAM,CAAC;IACxB,YAAY,CAAC,EAAE,MAAM,CAAC;IACtB,YAAY,CAAC,EAAE,MAAM,CAAC;IAEtB,CAAC,GAAG,EAAE,MAAM,GAAG,MAAM,GAAG,OAAO,GAAG,MAAM,GAAG,SAAS,CAAC;CACtD"}

package/dist/constants.js

@@ -0,0 +1,90 @@
+// Error messages
+export const ERROR_MESSAGES = {
+    QUOTA_EXCEEDED: "Quota exceeded for Gemini model requests",
+    QUOTA_EXCEEDED_SHORT: "⚠️ Gemini daily quota exceeded. Please try again later.",
+    TOOL_NOT_FOUND: "not found in registry",
+    NO_PROMPT_PROVIDED: "Please provide a prompt for analysis. Use @ syntax to include files (e.g., '@largefile.js explain what this does') or ask general questions",
+};
+// Status messages
+export const STATUS_MESSAGES = {
+    SANDBOX_EXECUTING: "🔒 Executing CLI command in sandbox mode...",
+    GEMINI_RESPONSE: "Gemini response:",
+    CODEX_RESPONSE: "Codex response:",
+    CLAUDE_RESPONSE: "Claude response:",
+    // Timeout prevention messages
+    PROCESSING_START: "🔍 Starting analysis (may take 5-15 minutes for large codebases)",
+    PROCESSING_CONTINUE: "⏳ Still processing...",
+    PROCESSING_COMPLETE: "✅ Analysis completed successfully",
+};
+// MCP Protocol Constants
+export const PROTOCOL = {
+    // Message roles
+    ROLES: {
+        USER: "user",
+        ASSISTANT: "assistant",
+    },
+    // Content types
+    CONTENT_TYPES: {
+        TEXT: "text",
+    },
+    // Status codes
+    STATUS: {
+        SUCCESS: "success",
+        ERROR: "error",
+        FAILED: "failed",
+        REPORT: "report",
+    },
+    // Notification methods
+    NOTIFICATIONS: {
+        PROGRESS: "notifications/progress",
+    },
+    // Timeout prevention
+    KEEPALIVE_INTERVAL: 25000, // 25 seconds
+};
+// CLI Constants
+export const CLI = {
+    // Command names
+    COMMANDS: {
+        GEMINI: "gemini",
+        CODEX: "codex",
+        CLAUDE: "claude",
+        ECHO: "echo",
+    },
+    // Gemini command flags
+    FLAGS: {
+        MODEL: "-m",
+        SANDBOX: "-s",
+        PROMPT: "-p",
+        HELP: "-help",
+    },
+    // Codex subcommands
+    SUBCOMMANDS: {
+        EXEC: "exec",
+    },
+    // Codex-specific flags
+    CODEX_FLAGS: {
+        MODEL: "-m",
+        SANDBOX: "-s",
+        APPROVAL: "-a",
+        COLOR: "--color",
+        FULL_AUTO: "--full-auto",
+        SKIP_GIT_CHECK: "--skip-git-repo-check",
+    },
+    // Claude Code flags
+    CLAUDE_FLAGS: {
+        PRINT: "--print",
+        MODEL: "--model",
+        OUTPUT_FORMAT: "--output-format",
+        PERMISSION_MODE: "--permission-mode",
+        MAX_BUDGET: "--max-budget-usd",
+        SYSTEM_PROMPT: "--system-prompt",
+        TOOLS: "--tools",
+        HELP: "--help",
+    },
+    // Default values
+    DEFAULTS: {
+        BOOLEAN_TRUE: "true",
+        BOOLEAN_FALSE: "false",
+    },
+};
+//# sourceMappingURL=constants.js.map

package/dist/constants.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"constants.js","sourceRoot":"","sources":["../src/constants.ts"],"names":[],"mappings":"AAEA,iBAAiB;AACjB,MAAM,CAAC,MAAM,cAAc,GAAG;IAC5B,cAAc,EAAE,0CAA0C;IAC1D,oBAAoB,EAAE,yDAAyD;IAC/E,cAAc,EAAE,uBAAuB;IACvC,kBAAkB,EAAE,6IAA6I;CACzJ,CAAC;AAEX,kBAAkB;AAClB,MAAM,CAAC,MAAM,eAAe,GAAG;IAC7B,iBAAiB,EAAE,6CAA6C;IAChE,eAAe,EAAE,kBAAkB;IACnC,cAAc,EAAE,iBAAiB;IACjC,eAAe,EAAE,kBAAkB;IACnC,8BAA8B;IAC9B,gBAAgB,EAAE,kEAAkE;IACpF,mBAAmB,EAAE,uBAAuB;IAC5C,mBAAmB,EAAE,mCAAmC;CAChD,CAAC;AAEX,yBAAyB;AACzB,MAAM,CAAC,MAAM,QAAQ,GAAG;IACtB,gBAAgB;IAChB,KAAK,EAAE;QACL,IAAI,EAAE,MAAM;QACZ,SAAS,EAAE,WAAW;KACvB;IACD,gBAAgB;IAChB,aAAa,EAAE;QACb,IAAI,EAAE,MAAM;KACb;IACD,eAAe;IACf,MAAM,EAAE;QACN,OAAO,EAAE,SAAS;QAClB,KAAK,EAAE,OAAO;QACd,MAAM,EAAE,QAAQ;QAChB,MAAM,EAAE,QAAQ;KACjB;IACD,uBAAuB;IACvB,aAAa,EAAE;QACb,QAAQ,EAAE,wBAAwB;KACnC;IACD,qBAAqB;IACrB,kBAAkB,EAAE,KAAK,EAAE,aAAa;CAChC,CAAC;AAGX,gBAAgB;AAChB,MAAM,CAAC,MAAM,GAAG,GAAG;IACjB,gBAAgB;IAChB,QAAQ,EAAE;QACR,MAAM,EAAE,QAAQ;QAChB,KAAK,EAAE,OAAO;QACd,MAAM,EAAE,QAAQ;QAChB,IAAI,EAAE,MAAM;KACb;IACD,uBAAuB;IACvB,KAAK,EAAE;QACL,KAAK,EAAE,IAAI;QACX,OAAO,EAAE,IAAI;QACb,MAAM,EAAE,IAAI;QACZ,IAAI,EAAE,OAAO;KACd;IACD,oBAAoB;IACpB,WAAW,EAAE;QACX,IAAI,EAAE,MAAM;KACb;IACD,uBAAuB;IACvB,WAAW,EAAE;QACX,KAAK,EAAE,IAAI;QACX,OAAO,EAAE,IAAI;QACb,QAAQ,EAAE,IAAI;QACd,KAAK,EAAE,SAAS;QAChB,SAAS,EAAE,aAAa;QACxB,cAAc,EAAE,uBAAuB;KACxC;IACD,oBAAoB;IACpB,YAAY,EAAE;QACZ,KAAK,EAAE,SAAS;QAChB,KAAK,EAAE,SAAS;QAChB,aAAa,EAAE,iBAAiB;QAChC,eAAe,EAAE,mBAAmB;QACpC,UAAU,EAAE,kBAAkB;QAC9B,aAAa,EAAE,iBAAiB;QAChC,KAAK,EAAE,SAAS;QAChB,IAAI,EAAE,QAAQ;KACf;IACD,iBAAiB;IACjB,QAAQ,EAAE;QACR,YAAY,EAAE,MAAM;QACpB,aAAa,EAAE,OAAO;KACvB;CACO,CAAC"}

package/dist/index.d.ts

@@ -0,0 +1,3 @@
+#!/usr/bin/env node
+import 'dotenv/config';
+//# sourceMappingURL=index.d.ts.map

package/dist/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":";AACA,OAAO,eAAe,CAAC"}

package/dist/index.js

@@ -0,0 +1,205 @@
+#!/usr/bin/env node
+import 'dotenv/config';
+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 { PROTOCOL } from "./constants.js";
+import { getToolDefinitions, getPromptDefinitions, executeTool, toolExists, getPromptMessage, toolRegistry, initTools, } from "./tools/index.js";
+import { importantReadNowTool } from './tools/important-read-now.tool.js';
+import { filterToolsForClient, isToolBlockedForClient } from './clientFilter.js';
+const server = new Server({
+    name: "Multi-CLI",
+    version: "1.5.0",
+}, {
+    capabilities: {
+        tools: {},
+        prompts: {},
+    },
+});
+let connectedClientName;
+server.oninitialized = () => {
+    const clientInfo = server.getClientVersion();
+    connectedClientName = clientInfo?.name;
+};
+let isProcessing = false;
+let currentOperationName = "";
+let latestOutput = "";
+/**
+ * @param progressToken The progress token provided by the client
+ * @param progress The current progress value
+ * @param total Optional total value
+ * @param message Optional status message
+ */
+async function sendProgressNotification(progressToken, progress, total, message) {
+    if (!progressToken)
+        return; // Only send if client requested progress
+    try {
+        const params = {
+            progressToken,
+            progress
+        };
+        if (total !== undefined)
+            params.total = total; // future cache progress
+        if (message)
+            params.message = message;
+        await server.notification({
+            method: PROTOCOL.NOTIFICATIONS.PROGRESS,
+            params
+        });
+    }
+    catch {
+        // progress notification errors are non-critical
+    }
+}
+function startProgressUpdates(operationName, progressToken) {
+    isProcessing = true;
+    currentOperationName = operationName;
+    latestOutput = ""; // Reset latest output
+    const progressMessages = [
+        `🧠 ${operationName} - Analyzing your request...`,
+        `📊 ${operationName} - Processing and generating insights...`,
+        `✨ ${operationName} - Creating structured response for your review...`,
+        `⏱️ ${operationName} - Large analysis in progress (this is normal for big requests)...`,
+        `🔍 ${operationName} - Still working on your request...`,
+    ];
+    let messageIndex = 0;
+    let progress = 0;
+    // Send immediate acknowledgment if progress requested
+    if (progressToken) {
+        sendProgressNotification(progressToken, 0, undefined, // No total - indeterminate progress
+        `🔍 Starting ${operationName}`);
+    }
+    // Keep client alive with periodic updates
+    const progressInterval = setInterval(async () => {
+        if (isProcessing && progressToken) {
+            // Simply increment progress value
+            progress += 1;
+            // Include latest output if available
+            const baseMessage = progressMessages[messageIndex % progressMessages.length];
+            const outputPreview = latestOutput.slice(-150).trim(); // Last 150 chars
+            const message = outputPreview
+                ? `${baseMessage}\n📝 Output: ...${outputPreview}`
+                : baseMessage;
+            await sendProgressNotification(progressToken, progress, undefined, // No total - indeterminate progress
+            message);
+            messageIndex++;
+        }
+        else if (!isProcessing) {
+            clearInterval(progressInterval);
+        }
+    }, PROTOCOL.KEEPALIVE_INTERVAL); // Every 25 seconds
+    return { interval: progressInterval, progressToken };
+}
+function stopProgressUpdates(progressData, success = true) {
+    const operationName = currentOperationName; // Store before clearing
+    isProcessing = false;
+    currentOperationName = "";
+    clearInterval(progressData.interval);
+    // Send final progress notification if client requested progress
+    if (progressData.progressToken) {
+        sendProgressNotification(progressData.progressToken, 100, 100, success ? `✅ ${operationName} completed successfully` : `❌ ${operationName} failed`);
+    }
+}
+// tools/list
+server.setRequestHandler(ListToolsRequestSchema, async (request) => {
+    const visible = filterToolsForClient(toolRegistry, connectedClientName);
+    if (visible.length === 0) {
+        return { tools: getToolDefinitions([importantReadNowTool]) };
+    }
+    return { tools: getToolDefinitions(visible) };
+});
+// tools/get
+server.setRequestHandler(CallToolRequestSchema, async (request) => {
+    const toolName = request.params.name;
+    // Handle fallback tool (dynamically injected, not in registry)
+    if (toolName === importantReadNowTool.name) {
+        const result = await importantReadNowTool.execute({});
+        return {
+            content: [{ type: "text", text: result }],
+            isError: false,
+        };
+    }
+    const toolEntry = toolRegistry.find(t => t.name === toolName);
+    if (isToolBlockedForClient(toolEntry, connectedClientName)) {
+        throw new Error(`Unknown tool: ${toolName}`);
+    }
+    if (toolExists(toolName)) {
+        // Check if client requested progress updates
+        const progressToken = request.params._meta?.progressToken;
+        // Start progress updates if client requested them
+        const progressData = startProgressUpdates(toolName, progressToken);
+        try {
+            // Get prompt and other parameters from arguments with proper typing
+            const args = request.params.arguments || {};
+            // Execute the tool using the unified registry with progress callback
+            const result = await executeTool(toolName, args, (newOutput) => {
+                latestOutput = newOutput;
+            });
+            // Stop progress updates
+            stopProgressUpdates(progressData, true);
+            return {
+                content: [
+                    {
+                        type: "text",
+                        text: result,
+                    },
+                ],
+                isError: false,
+            };
+        }
+        catch (error) {
+            // Stop progress updates on error
+            stopProgressUpdates(progressData, false);
+            const errorMessage = error instanceof Error ? error.message : String(error);
+            return {
+                content: [
+                    {
+                        type: "text",
+                        text: `Error executing ${toolName}: ${errorMessage}`,
+                    },
+                ],
+                isError: true,
+            };
+        }
+    }
+    else {
+        throw new Error(`Unknown tool: ${request.params.name}`);
+    }
+});
+// prompts/list
+server.setRequestHandler(ListPromptsRequestSchema, async (request) => {
+    const visible = filterToolsForClient(toolRegistry, connectedClientName);
+    return { prompts: getPromptDefinitions(visible) };
+});
+// prompts/get
+server.setRequestHandler(GetPromptRequestSchema, async (request) => {
+    const promptName = request.params.name;
+    const promptEntry = toolRegistry.find(t => t.name === promptName);
+    if (isToolBlockedForClient(promptEntry, connectedClientName)) {
+        throw new Error(`Unknown prompt: ${promptName}`);
+    }
+    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
+                }
+            }]
+    };
+});
+// Start the server
+async function main() {
+    await initTools();
+    const transport = new StdioServerTransport();
+    await server.connect(transport);
+}
+main().catch(() => {
+    process.exit(1);
+});
+//# sourceMappingURL=index.js.map

package/dist/index.js.map

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

package/dist/modelCatalog.d.ts

@@ -0,0 +1,14 @@
+export interface ModelTier {
+    tier: 'fast' | 'balanced' | 'powerful';
+    label: string;
+    models: string[];
+    useWhen: string;
+}
+export interface CLICatalog {
+    cli: 'gemini' | 'codex' | 'claude';
+    tiers: ModelTier[];
+    note: string;
+}
+export declare function getCatalog(cli: 'gemini' | 'codex' | 'claude'): CLICatalog;
+export declare function formatCatalog(cli: 'gemini' | 'codex' | 'claude'): string;
+//# sourceMappingURL=modelCatalog.d.ts.map