@rithamnatani/agentmux 1.5.39

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) => {
+        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,EAAmB,EAAE;QAC5C,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/get-run.tool.d.ts

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

package/dist/tools/get-run.tool.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"get-run.tool.d.ts","sourceRoot":"","sources":["../../src/tools/get-run.tool.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,WAAW,EAAE,MAAM,eAAe,CAAC;AAU5C,eAAO,MAAM,UAAU,EAAE,WAkDxB,CAAC"}

package/dist/tools/get-run.tool.js

@@ -0,0 +1,53 @@
+import { z } from 'zod';
+import { getRunsDir } from '../service/paths.js';
+import { readFile, readdir, stat } from 'fs/promises';
+import path from 'path';
+const getRunArgsSchema = z.object({
+    runId: z.string().optional().describe("Specific run ID to retrieve. If omitted, and 'latest' is true, retrieves the most recent run."),
+    latest: z.boolean().optional().describe("If true, retrieves the most recent run summary. Defaults to true if runId is omitted."),
+});
+export const getRunTool = {
+    name: "Get-Run",
+    description: "Retrieve summary of a prior command execution (run ledger). Useful for diagnosing failures, reviewing logs, or checking retryability.",
+    zodSchema: getRunArgsSchema,
+    category: 'utility',
+    execution: { taskSupport: 'forbidden' },
+    timeoutClass: 'none',
+    execute: async (args) => {
+        const { runId, latest = !args.runId } = args;
+        const runsDir = getRunsDir();
+        try {
+            if (runId) {
+                const filePath = path.join(runsDir, `${runId}.json`);
+                const content = await readFile(filePath, 'utf-8');
+                return content;
+            }
+            if (latest) {
+                const files = await readdir(runsDir);
+                if (files.length === 0) {
+                    return "No runs found in ledger.";
+                }
+                const stats = await Promise.all(files.filter(f => f.endsWith('.json')).map(async (f) => {
+                    const p = path.join(runsDir, f);
+                    const s = await stat(p);
+                    return { name: f, mtime: s.mtimeMs };
+                }));
+                if (stats.length === 0) {
+                    return "No runs found in ledger.";
+                }
+                stats.sort((a, b) => b.mtime - a.mtime);
+                const latestFile = stats[0].name;
+                const content = await readFile(path.join(runsDir, latestFile), 'utf-8');
+                return content;
+            }
+            return "Please provide either runId or set latest: true.";
+        }
+        catch (error) {
+            if (error.code === 'ENOENT') {
+                return `Run not found: ${runId}`;
+            }
+            throw error;
+        }
+    }
+};
+//# sourceMappingURL=get-run.tool.js.map

package/dist/tools/get-run.tool.js.map

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

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 AgentMux.
+
+AgentMux 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 AgentMux 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 AgentMux. 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,gHAAgH;IAClH,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,12 @@
+import { CliAvailability } from '../utils/cliDetector.js';
+import { MultiCliConfig } from '../config.js';
+import type { Logger } from '../logger.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(config?: Pick<MultiCliConfig, 'cliDetectTimeoutMs'> & {
+    logger?: Logger;
+}): 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":"AAeA,OAAO,EAAuB,eAAe,EAAE,MAAM,yBAAyB,CAAC;AAC/E,OAAO,EAAE,cAAc,EAAE,MAAM,cAAc,CAAC;AAC9C,OAAO,KAAK,EAAE,MAAM,EAAE,MAAM,cAAc,CAAC;AAE3C;;;GAGG;AACH,wBAAsB,SAAS,CAC7B,MAAM,CAAC,EAAE,IAAI,CAAC,cAAc,EAAE,oBAAoB,CAAC,GAAG;IAAE,MAAM,CAAC,EAAE,MAAM,CAAA;CAAE,GACxE,OAAO,CAAC,eAAe,CAAC,CAgE1B;AAED,cAAc,eAAe,CAAC"}

package/dist/tools/index.js

@@ -0,0 +1,59 @@
+// 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, opencodeHelpTool, cursorHelpTool, geminiListModelsTool, codexListModelsTool, claudeListModelsTool, opencodeListModelsTool, cursorListModelsTool, } 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 { askOpencodeTool } from './ask-opencode.tool.js';
+import { opencodeCopilotUsageTool } from './opencode-copilot-usage.tool.js';
+import { askCursorTool } from './ask-cursor.tool.js';
+import { getRunTool } from './get-run.tool.js';
+import { askSubagentTool, hasAnyRouterBackend, routerTierTools } from './ask-router.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(config) {
+    toolRegistry.length = 0;
+    const availability = await detectAvailableClis(config?.cliDetectTimeoutMs, config?.logger);
+    toolRegistry.push(getRunTool);
+    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);
+    }
+    if (availability.opencode) {
+        toolRegistry.push(opencodeListModelsTool, // List-OpenCode-Models
+        askOpencodeTool, // Ask-OpenCode
+        opencodeCopilotUsageTool, // OpenCode-Copilot-Usage
+        opencodeHelpTool);
+    }
+    if (availability.cursor) {
+        toolRegistry.push(cursorListModelsTool, // List-Cursor-Models
+        askCursorTool, // Ask-Cursor
+        cursorHelpTool);
+    }
+    if (hasAnyRouterBackend()) {
+        toolRegistry.push(askSubagentTool, ...routerTierTools);
+    }
+    config?.logger?.info('tool_registry_initialized', {
+        availability,
+        toolNames: toolRegistry.map((tool) => tool.name),
+    });
+    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,EAAE,gBAAgB,EAAE,cAAc,EAC/E,oBAAoB,EAAE,mBAAmB,EAAE,oBAAoB,EAAE,sBAAsB,EAAE,oBAAoB,GAC9G,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,eAAe,EAAE,MAAM,wBAAwB,CAAC;AACzD,OAAO,EAAE,wBAAwB,EAAE,MAAM,kCAAkC,CAAC;AAC5E,OAAO,EAAE,aAAa,EAAE,MAAM,sBAAsB,CAAC;AACrD,OAAO,EAAE,UAAU,EAAE,MAAM,mBAAmB,CAAC;AAC/C,OAAO,EAAE,eAAe,EAAE,mBAAmB,EAAE,eAAe,EAAE,MAAM,sBAAsB,CAAC;AAC7F,OAAO,EAAE,mBAAmB,EAAmB,MAAM,yBAAyB,CAAC;AAI/E;;;GAGG;AACH,MAAM,CAAC,KAAK,UAAU,SAAS,CAC7B,MAAyE;IAEzE,YAAY,CAAC,MAAM,GAAG,CAAC,CAAC;IACxB,MAAM,YAAY,GAAG,MAAM,mBAAmB,CAC5C,MAAM,EAAE,kBAAkB,EAC1B,MAAM,EAAE,MAAM,CACf,CAAC;IAEF,YAAY,CAAC,IAAI,CAAC,UAAU,CAAC,CAAC;IAE9B,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,IAAI,YAAY,CAAC,QAAQ,EAAE,CAAC;QAC1B,YAAY,CAAC,IAAI,CACf,sBAAsB,EAAE,uBAAuB;QAC/C,eAAe,EAAS,eAAe;QACvC,wBAAwB,EAAE,yBAAyB;QACnD,gBAAgB,CACjB,CAAC;IACJ,CAAC;IAED,IAAI,YAAY,CAAC,MAAM,EAAE,CAAC;QACxB,YAAY,CAAC,IAAI,CACf,oBAAoB,EAAE,qBAAqB;QAC3C,aAAa,EAAS,aAAa;QACnC,cAAc,CACf,CAAC;IACJ,CAAC;IAED,IAAI,mBAAmB,EAAE,EAAE,CAAC;QAC1B,YAAY,CAAC,IAAI,CACf,eAAe,EACf,GAAG,eAAe,CACnB,CAAC;IACJ,CAAC;IAED,MAAM,EAAE,MAAM,EAAE,IAAI,CAAC,2BAA2B,EAAE;QAChD,YAAY;QACZ,SAAS,EAAE,YAAY,CAAC,GAAG,CAAC,CAAC,IAAI,EAAE,EAAE,CAAC,IAAI,CAAC,IAAI,CAAC;KACjD,CAAC,CAAC;IAEH,OAAO,YAAY,CAAC;AACtB,CAAC;AAED,cAAc,eAAe,CAAC"}

package/dist/tools/opencode-copilot-usage.tool.d.ts

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

package/dist/tools/opencode-copilot-usage.tool.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"opencode-copilot-usage.tool.d.ts","sourceRoot":"","sources":["../../src/tools/opencode-copilot-usage.tool.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,WAAW,EAAE,MAAM,eAAe,CAAC;AAsD5C,eAAO,MAAM,wBAAwB,EAAE,WAmDtC,CAAC"}

package/dist/tools/opencode-copilot-usage.tool.js

@@ -0,0 +1,85 @@
+import { z } from 'zod';
+import { executeGhApi, GhCliError } from '../utils/githubCli.js';
+const currentDate = new Date();
+const opencodeCopilotUsageArgsSchema = z.object({
+    username: z.string().min(1).optional().describe('Optional GitHub username to inspect. Defaults to the authenticated `gh` user.'),
+    year: z.coerce.number().int().min(1970).optional().describe(`Optional year for the usage window. Defaults to ${currentDate.getFullYear()}.`),
+    month: z.coerce.number().int().min(1).max(12).optional().describe(`Optional month for the usage window. Defaults to ${currentDate.getMonth() + 1}.`),
+    day: z.coerce.number().int().min(1).max(31).optional().describe('Optional day for a more specific usage window.'),
+    product: z.string().min(1).optional().describe('Optional product filter for the usage query.'),
+    model: z.string().min(1).optional().describe('Optional model filter for the usage query.'),
+});
+async function getAuthenticatedUsername(context) {
+    const username = await executeGhApi(['user', '--jq', '.login'], context);
+    if (!username.trim()) {
+        throw new Error('GitHub CLI returned an empty username. Run `gh auth status` and try again.');
+    }
+    return username.trim();
+}
+function buildQueryArgs(args) {
+    const queryArgs = ['--method', 'GET', '-f', `year=${args.year}`, '-f', `month=${args.month}`];
+    if (args.day !== undefined) {
+        queryArgs.push('-f', `day=${args.day}`);
+    }
+    if (args.product) {
+        queryArgs.push('-f', `product=${args.product}`);
+    }
+    if (args.model) {
+        queryArgs.push('-f', `model=${args.model}`);
+    }
+    return queryArgs;
+}
+function formatSummary(username, year, month, day) {
+    const period = day ? `${year}-${String(month).padStart(2, '0')}-${String(day).padStart(2, '0')}` : `${year}-${String(month).padStart(2, '0')}`;
+    return `GitHub Copilot premium request usage for ${username} (${period})`;
+}
+export const opencodeCopilotUsageTool = {
+    name: 'OpenCode-Copilot-Usage',
+    description: 'Check GitHub Copilot premium request usage for the authenticated OpenCode provider account or a specified GitHub username.',
+    zodSchema: opencodeCopilotUsageArgsSchema,
+    prompt: {
+        description: 'Read GitHub Copilot premium request usage for OpenCode via gh api.',
+    },
+    category: 'opencode',
+    execute: async (args, context) => {
+        const a = opencodeCopilotUsageArgsSchema.parse(args);
+        let resolvedUsername = a.username?.trim() || '';
+        let year = a.year ?? new Date().getFullYear();
+        let month = a.month ?? new Date().getMonth() + 1;
+        try {
+            resolvedUsername = resolvedUsername || await getAuthenticatedUsername(context);
+            const queryArgs = buildQueryArgs({
+                year,
+                month,
+                day: a.day,
+                product: a.product,
+                model: a.model,
+            });
+            const raw = await executeGhApi([
+                `/users/${encodeURIComponent(resolvedUsername)}/settings/billing/premium_request/usage`,
+                '-H', 'Accept: application/vnd.github+json',
+                '-H', 'X-GitHub-Api-Version: 2026-03-10',
+                ...queryArgs,
+            ], context);
+            const parsed = raw ? JSON.parse(raw) : {};
+            return `${formatSummary(resolvedUsername, year, month, a.day)}\n\nRaw JSON:\n${JSON.stringify({
+                request: {
+                    username: resolvedUsername,
+                    year,
+                    month,
+                    day: a.day,
+                    product: a.product,
+                    model: a.model,
+                },
+                response: parsed,
+            }, null, 2)}`;
+        }
+        catch (error) {
+            if (error instanceof GhCliError) {
+                return `${formatSummary(resolvedUsername, year, month, a.day)}\n\n${error.message}\n\nDebug:\n${JSON.stringify(error.details, null, 2)}`;
+            }
+            throw error;
+        }
+    },
+};
+//# sourceMappingURL=opencode-copilot-usage.tool.js.map

package/dist/tools/opencode-copilot-usage.tool.js.map

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

package/dist/tools/recommend-route.tool.d.ts

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

package/dist/tools/recommend-route.tool.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"recommend-route.tool.d.ts","sourceRoot":"","sources":["../../src/tools/recommend-route.tool.ts"],"names":[],"mappings":"AAQA,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,eAAe,CAAC;AAuDjD,eAAO,MAAM,kBAAkB,EAAE,WA8ChC,CAAC"}

package/dist/tools/recommend-route.tool.js

@@ -0,0 +1,88 @@
+import { z } from 'zod';
+import { loadRouterConfig } from '../router/config.js';
+import { buildRouteDecision } from '../router/router.js';
+import { toolRegistry } from './registry.js';
+const tierSchema = z.enum(['trivial', 'small', 'medium', 'large', 'long', 'crucial']);
+const providerSchema = z.enum(['codex', 'claude', 'gemini', 'opencode', 'cursor']);
+const domainSchema = z.enum(['general', 'code', 'review', 'docs', 'analysis']);
+const costClassSchema = z.enum(['free', 'included', 'low', 'medium', 'premium', 'any']);
+const recommendRouteArgsSchema = z.object({
+    prompt: z.string().describe('Task or question text used for sizing context (length only in this stage).'),
+    tier: tierSchema.describe('Workload tier used to pick the configured route list.'),
+    domain: domainSchema.optional().describe('Optional domain hint for future routing rules.'),
+    allowEdits: z.boolean().optional().describe('When set, overrides default allowEdits on chosen routes.'),
+    requireReview: z.boolean().optional().describe('When set, overrides default requireReview on chosen routes.'),
+    preferredProvider: providerSchema.optional().describe('Try this provider first (stable reorder).'),
+    blockedProviders: z.array(providerSchema).optional().describe('Providers that must not be selected.'),
+    maxCostClass: costClassSchema.optional().describe('Maximum cost class permitted for the primary route.'),
+    forceTask: z.boolean().optional().describe('If true, reject sync-only routes.'),
+});
+function inferAvailabilityFromRegistry() {
+    const out = {
+        gemini: false,
+        codex: false,
+        claude: false,
+        opencode: false,
+        cursor: false,
+    };
+    for (const t of toolRegistry) {
+        switch (t.category) {
+            case 'gemini':
+                out.gemini = true;
+                break;
+            case 'codex':
+                out.codex = true;
+                break;
+            case 'claude':
+                out.claude = true;
+                break;
+            case 'opencode':
+                out.opencode = true;
+                break;
+            case 'cursor':
+                out.cursor = true;
+                break;
+            default:
+                break;
+        }
+    }
+    return out;
+}
+export const recommendRouteTool = {
+    name: 'Recommend-Route',
+    description: 'Read-only routing helper: given a tier and constraints, returns a deterministic provider/model recommendation from merged router config (package defaults + ~/.config/multi-cli/config.json + multi-cli.config.json). Does not invoke provider CLIs.',
+    zodSchema: recommendRouteArgsSchema,
+    category: 'utility',
+    execution: { taskSupport: 'forbidden' },
+    timeoutClass: 'none',
+    execute: async (args, context) => {
+        const parsed = recommendRouteArgsSchema.parse(args);
+        const availability = context?.cliAvailability ?? inferAvailabilityFromRegistry();
+        const projectRoot = context?.cwd;
+        const { config, warnings: loadWarnings } = loadRouterConfig(projectRoot);
+        const decision = buildRouteDecision(config, {
+            prompt: parsed.prompt,
+            tier: parsed.tier,
+            domain: parsed.domain,
+            allowEdits: parsed.allowEdits,
+            requireReview: parsed.requireReview,
+            preferredProvider: parsed.preferredProvider,
+            blockedProviders: parsed.blockedProviders,
+            maxCostClass: parsed.maxCostClass,
+            forceTask: parsed.forceTask,
+        }, {
+            availability,
+            mcpClientName: context?.mcpClientName,
+            projectRoot,
+        }, loadWarnings);
+        const payload = {
+            selected: decision.selected,
+            fallbacks: decision.fallbacks,
+            rejected: decision.rejected,
+            reasons: decision.reasons,
+            warnings: decision.warnings,
+        };
+        return `\`\`\`json\n${JSON.stringify(payload, null, 2)}\n\`\`\``;
+    },
+};
+//# sourceMappingURL=recommend-route.tool.js.map

package/dist/tools/recommend-route.tool.js.map

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

package/dist/tools/registry.d.ts

@@ -0,0 +1,31 @@
+import { Tool, Prompt } from "@modelcontextprotocol/sdk/types.js";
+import { ToolArguments } from "../constants.js";
+import { z } from "zod";
+import { ToolExecutionContext, ToolTimeoutClass } from "../execution.js";
+export interface UnifiedTool {
+    name: string;
+    description: string;
+    zodSchema: z.ZodType;
+    prompt?: {
+        description: string;
+        arguments?: Array<{
+            name: string;
+            description: string;
+            required: boolean;
+        }>;
+    };
+    execute: (args: ToolArguments, context?: ToolExecutionContext) => Promise<string>;
+    category?: 'gemini' | 'codex' | 'claude' | 'opencode' | 'cursor' | 'utility';
+    execution?: Tool['execution'];
+    timeoutClass?: ToolTimeoutClass;
+}
+export declare const toolRegistry: UnifiedTool[];
+export declare function toolExists(toolName: string): boolean;
+export declare function getTool(toolName: string): UnifiedTool | undefined;
+export declare function getToolDefinitions(subset?: UnifiedTool[], mcpClientName?: string): Tool[];
+export declare function getPromptDefinitions(subset?: UnifiedTool[]): Prompt[];
+export declare function validateToolArguments(toolName: string, args: ToolArguments): ToolArguments;
+export declare function executeValidatedTool(tool: UnifiedTool, args: ToolArguments, context?: ToolExecutionContext): Promise<string>;
+export declare function executeTool(toolName: string, args: ToolArguments, context?: ToolExecutionContext): Promise<string>;
+export declare function getPromptMessage(toolName: string, args: Record<string, any>): string;
+//# sourceMappingURL=registry.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"registry.d.ts","sourceRoot":"","sources":["../../src/tools/registry.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,IAAI,EAAE,MAAM,EAAE,MAAM,oCAAoC,CAAC;AAElE,OAAO,EAAE,aAAa,EAAE,MAAM,iBAAiB,CAAC;AAChD,OAAO,EAAE,CAAC,EAAY,MAAM,KAAK,CAAC;AAClC,OAAO,EAAE,oBAAoB,EAAE,gBAAgB,EAAE,MAAM,iBAAiB,CAAC;AAGzE,MAAM,WAAW,WAAW;IAC1B,IAAI,EAAE,MAAM,CAAC;IACb,WAAW,EAAE,MAAM,CAAC;IACpB,SAAS,EAAE,CAAC,CAAC,OAAO,CAAC;IAErB,MAAM,CAAC,EAAE;QACP,WAAW,EAAE,MAAM,CAAC;QACpB,SAAS,CAAC,EAAE,KAAK,CAAC;YAChB,IAAI,EAAE,MAAM,CAAC;YACb,WAAW,EAAE,MAAM,CAAC;YACpB,QAAQ,EAAE,OAAO,CAAC;SACnB,CAAC,CAAC;KACJ,CAAC;IAEF,OAAO,EAAE,CAAC,IAAI,EAAE,aAAa,EAAE,OAAO,CAAC,EAAE,oBAAoB,KAAK,OAAO,CAAC,MAAM,CAAC,CAAC;IAClF,QAAQ,CAAC,EAAE,QAAQ,GAAG,OAAO,GAAG,QAAQ,GAAG,UAAU,GAAG,QAAQ,GAAG,SAAS,CAAC;IAC7E,SAAS,CAAC,EAAE,IAAI,CAAC,WAAW,CAAC,CAAC;IAC9B,YAAY,CAAC,EAAE,gBAAgB,CAAC;CACjC;AAED,eAAO,MAAM,YAAY,EAAE,WAAW,EAAO,CAAC;AAC9C,wBAAgB,UAAU,CAAC,QAAQ,EAAE,MAAM,GAAG,OAAO,CAEpD;AACD,wBAAgB,OAAO,CAAC,QAAQ,EAAE,MAAM,GAAG,WAAW,GAAG,SAAS,CAEjE;AACD,wBAAgB,kBAAkB,CAAC,MAAM,CAAC,EAAE,WAAW,EAAE,EAAE,aAAa,CAAC,EAAE,MAAM,GAAG,IAAI,EAAE,CA8BzF;AAcD,wBAAgB,oBAAoB,CAAC,MAAM,CAAC,EAAE,WAAW,EAAE,GAAG,MAAM,EAAE,CAQrE;AAED,wBAAgB,qBAAqB,CAAC,QAAQ,EAAE,MAAM,EAAE,IAAI,EAAE,aAAa,GAAG,aAAa,CAe1F;AAED,wBAAsB,oBAAoB,CACxC,IAAI,EAAE,WAAW,EACjB,IAAI,EAAE,aAAa,EACnB,OAAO,CAAC,EAAE,oBAAoB,GAC7B,OAAO,CAAC,MAAM,CAAC,CAEjB;AAED,wBAAsB,WAAW,CAC/B,QAAQ,EAAE,MAAM,EAChB,IAAI,EAAE,aAAa,EACnB,OAAO,CAAC,EAAE,oBAAoB,GAC7B,OAAO,CAAC,MAAM,CAAC,CAQjB;AAED,wBAAgB,gBAAgB,CAAC,QAAQ,EAAE,MAAM,EAAE,IAAI,EAAE,MAAM,CAAC,MAAM,EAAE,GAAG,CAAC,GAAG,MAAM,CAsBpF"}

package/dist/tools/registry.js

@@ -0,0 +1,105 @@
+import { z, ZodError } from "zod";
+import { shouldAdvertiseTaskRequiredForListTools } from "../taskClientPolicy.js";
+export const toolRegistry = [];
+export function toolExists(toolName) {
+    return toolRegistry.some(t => t.name === toolName);
+}
+export function getTool(toolName) {
+    return toolRegistry.find(t => t.name === toolName);
+}
+export function getToolDefinitions(subset, mcpClientName) {
+    return (subset ?? toolRegistry).map(tool => {
+        const jsonSchema = z.toJSONSchema(tool.zodSchema);
+        const inputSchema = {
+            type: "object",
+            properties: jsonSchema.properties || {},
+            required: jsonSchema.required || [],
+        };
+        // Derive MCP annotations from tool name
+        let annotations;
+        if (tool.name.startsWith('Ask-')) {
+            annotations = { openWorldHint: true, readOnlyHint: false, destructiveHint: false };
+        }
+        else if (tool.name.startsWith('List-') || tool.name.endsWith('-Help') || tool.name.endsWith('-Usage') || tool.name === 'Fetch-Chunk' || tool.name === 'Claude-Gemini-Codex' || tool.name === 'Get-Run') {
+            annotations = { readOnlyHint: true, destructiveHint: false, openWorldHint: false };
+        }
+        const execution = shouldAdvertiseTaskRequiredForListTools(mcpClientName, tool)
+            ? { taskSupport: 'required' }
+            : tool.execution;
+        return {
+            name: tool.name,
+            description: tool.description,
+            inputSchema,
+            ...(execution && { execution }),
+            ...(annotations && { annotations }),
+        };
+    });
+}
+function extractPromptArguments(zodSchema) {
+    const jsonSchema = z.toJSONSchema(zodSchema);
+    const properties = jsonSchema.properties || {};
+    const required = jsonSchema.required || [];
+    return Object.entries(properties).map(([name, prop]) => ({
+        name,
+        description: prop.description || `${name} parameter`,
+        required: required.includes(name)
+    }));
+}
+export function getPromptDefinitions(subset) {
+    return (subset ?? toolRegistry)
+        .filter(tool => tool.prompt)
+        .map(tool => ({
+        name: tool.name,
+        description: tool.prompt.description,
+        arguments: tool.prompt.arguments || extractPromptArguments(tool.zodSchema),
+    }));
+}
+export function validateToolArguments(toolName, args) {
+    const tool = getTool(toolName);
+    if (!tool) {
+        throw new Error(`Unknown tool: ${toolName}`);
+    }
+    try {
+        return tool.zodSchema.parse(args);
+    }
+    catch (error) {
+        if (error instanceof ZodError) {
+            const issues = error.issues.map(issue => `${issue.path.join('.')}: ${issue.message}`).join(', ');
+            throw new Error(`Invalid arguments for ${toolName}: ${issues}`);
+        }
+        throw error;
+    }
+}
+export async function executeValidatedTool(tool, args, context) {
+    return tool.execute(args, context);
+}
+export async function executeTool(toolName, args, context) {
+    const tool = getTool(toolName);
+    if (!tool) {
+        throw new Error(`Unknown tool: ${toolName}`);
+    }
+    const validatedArgs = validateToolArguments(toolName, args);
+    return executeValidatedTool(tool, validatedArgs, context);
+}
+export function getPromptMessage(toolName, args) {
+    const tool = toolRegistry.find(t => t.name === toolName);
+    if (!tool?.prompt) {
+        throw new Error(`No prompt defined for tool: ${toolName}`);
+    }
+    const paramStrings = [];
+    if (args.prompt) {
+        paramStrings.push(args.prompt);
+    }
+    Object.entries(args).forEach(([key, value]) => {
+        if (key !== 'prompt' && value !== undefined && value !== null && value !== false) {
+            if (typeof value === 'boolean') {
+                paramStrings.push(`[${key}]`);
+            }
+            else {
+                paramStrings.push(`(${key}: ${value})`);
+            }
+        }
+    });
+    return `Use the ${toolName} tool${paramStrings.length > 0 ? ': ' + paramStrings.join(' ') : ''}`;
+}
+//# sourceMappingURL=registry.js.map

package/dist/tools/registry.js.map

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