consult-llm-mcp 2.5.2 → 2.5.3

package/README.md

@@ -64,7 +64,7 @@ to bring in the heavy artillery. Supports multi-turn conversations.
      -e OPENAI_API_KEY=your_openai_key \
      -e GEMINI_API_KEY=your_gemini_key \
      -e DEEPSEEK_API_KEY=your_deepseek_key \
-     -e GEMINI_BACKEND=gemini-cli \
+     -e CONSULT_LLM_GEMINI_BACKEND=gemini-cli \
      -- npx -y consult-llm-mcp
    ```
 
@@ -344,7 +344,7 @@ or use your Google AI Pro subscription.
 **Setup:**
 
 ```bash
-claude mcp add consult-llm -e GEMINI_BACKEND=gemini-cli -- npx -y consult-llm-mcp
+claude mcp add consult-llm -e CONSULT_LLM_GEMINI_BACKEND=gemini-cli -- npx -y consult-llm-mcp
 ```
 
 #### Codex CLI
@@ -359,12 +359,12 @@ Use OpenAI's Codex CLI for OpenAI models.
 **Setup:**
 
 ```bash
-claude mcp add consult-llm -e OPENAI_BACKEND=codex-cli -- npx -y consult-llm-mcp
+claude mcp add consult-llm -e CONSULT_LLM_OPENAI_BACKEND=codex-cli -- npx -y consult-llm-mcp
 ```
 
 <!-- prettier-ignore -->
 > [!TIP]
-> Set reasoning effort with `-e CODEX_REASONING_EFFORT=high`. Options:
+> Set reasoning effort with `-e CONSULT_LLM_CODEX_REASONING_EFFORT=high`. Options:
 > `none`, `minimal`, `low`, `medium`, `high`, `xhigh`.
 
 #### Cursor CLI
@@ -380,15 +380,17 @@ Use Cursor's agent CLI to route GPT and Gemini models through one tool.
 
 ```bash
 # Route GPT models through Cursor CLI
-claude mcp add consult-llm -e OPENAI_BACKEND=cursor-cli -- npx -y consult-llm-mcp
+claude mcp add consult-llm -e CONSULT_LLM_OPENAI_BACKEND=cursor-cli -- npx -y consult-llm-mcp
 
 # Route Gemini models through Cursor CLI
-claude mcp add consult-llm -e GEMINI_BACKEND=cursor-cli -- npx -y consult-llm-mcp
+claude mcp add consult-llm -e CONSULT_LLM_GEMINI_BACKEND=cursor-cli -- npx -y consult-llm-mcp
 
 # Route everything through Cursor CLI
 claude mcp add consult-llm \
-  -e OPENAI_BACKEND=cursor-cli \
-  -e GEMINI_BACKEND=cursor-cli \
+  -e CONSULT_LLM_OPENAI_BACKEND=cursor-cli \
+  -e CONSULT_LLM_GEMINI_BACKEND=cursor-cli \
+  -e CONSULT_LLM_CODEX_REASONING_EFFORT=high \
+  -e CONSULT_LLM_ALLOWED_MODELS="gemini-3-pro-preview,gpt-5.3-codex" \
   -- npx -y consult-llm-mcp
 ```
 
@@ -459,11 +461,12 @@ See the "Using web mode..." example above for a concrete transcript.
   - Options: `gpt-5.2` (default), `gpt-5.4`, `gemini-2.5-pro`,
     `gemini-3-pro-preview`, `gemini-3.1-pro-preview`, `deepseek-reasoner`,
     `gpt-5.3-codex`, `gpt-5.2-codex`
-- `GEMINI_BACKEND` - Backend for Gemini models (optional)
+- `CONSULT_LLM_GEMINI_BACKEND` - Backend for Gemini models (optional)
   - Options: `api` (default), `gemini-cli`, `cursor-cli`
-- `OPENAI_BACKEND` - Backend for OpenAI models (optional)
+- `CONSULT_LLM_OPENAI_BACKEND` - Backend for OpenAI models (optional)
   - Options: `api` (default), `codex-cli`, `cursor-cli`
-- `CODEX_REASONING_EFFORT` - Configure reasoning effort for Codex CLI (optional)
+- `CONSULT_LLM_CODEX_REASONING_EFFORT` - Configure reasoning effort for Codex
+  CLI (optional)
   - See [Codex CLI](#codex-cli) for details and available options
 - `CONSULT_LLM_EXTRA_MODELS` - Add models not in the built-in list (optional)
   - Comma-separated list, e.g., `grok-3,kimi-k2.5`

package/dist/config.d.ts

@@ -45,6 +45,8 @@ type ParsedConfig = z.infer<typeof Config>;
 export type Config = ParsedConfig & {
     allowedModels: string[];
 };
+/** Prefer CONSULT_LLM_-prefixed env var, fall back to unprefixed with deprecation warning. */
+export declare function migratePrefixedEnv(prefixed: string | undefined, unprefixed: string | undefined, unprefixedName: string, prefixedName: string): string | undefined;
 export declare function migrateBackendEnv(newVar: string | undefined, oldVar: string | undefined, providerCliValue: string, legacyName: string, newName: string): string | undefined;
 export declare const config: Config;
 export {};

package/dist/config.js

@@ -39,8 +39,11 @@ export function buildModelCatalog(builtinModels, extraModelsRaw, allowedModelsRa
         : allAvailable;
 }
 // Resolve backends early (needed for availability filtering)
-const resolvedGeminiBackend = migrateBackendEnv(process.env.GEMINI_BACKEND, process.env.GEMINI_MODE, 'gemini-cli', 'GEMINI_MODE', 'GEMINI_BACKEND');
-const resolvedOpenaiBackend = migrateBackendEnv(process.env.OPENAI_BACKEND, process.env.OPENAI_MODE, 'codex-cli', 'OPENAI_MODE', 'OPENAI_BACKEND');
+// Priority: CONSULT_LLM_*_BACKEND > *_BACKEND > *_MODE (deprecated)
+const geminiBackendRaw = migratePrefixedEnv(process.env.CONSULT_LLM_GEMINI_BACKEND, process.env.GEMINI_BACKEND, 'GEMINI_BACKEND', 'CONSULT_LLM_GEMINI_BACKEND');
+const resolvedGeminiBackend = migrateBackendEnv(geminiBackendRaw, process.env.GEMINI_MODE, 'gemini-cli', 'GEMINI_MODE', 'CONSULT_LLM_GEMINI_BACKEND');
+const openaiBackendRaw = migratePrefixedEnv(process.env.CONSULT_LLM_OPENAI_BACKEND, process.env.OPENAI_BACKEND, 'OPENAI_BACKEND', 'CONSULT_LLM_OPENAI_BACKEND');
+const resolvedOpenaiBackend = migrateBackendEnv(openaiBackendRaw, process.env.OPENAI_MODE, 'codex-cli', 'OPENAI_MODE', 'CONSULT_LLM_OPENAI_BACKEND');
 // Build catalog, then filter to only available providers
 const catalogModels = buildModelCatalog(ALL_MODELS, process.env.CONSULT_LLM_EXTRA_MODELS, process.env.CONSULT_LLM_ALLOWED_MODELS);
 const enabledModels = filterByAvailability(catalogModels, {
@@ -73,6 +76,15 @@ const Config = z.object({
         .optional(),
     systemPromptPath: z.string().optional(),
 });
+/** Prefer CONSULT_LLM_-prefixed env var, fall back to unprefixed with deprecation warning. */
+export function migratePrefixedEnv(prefixed, unprefixed, unprefixedName, prefixedName) {
+    if (prefixed)
+        return prefixed;
+    if (!unprefixed)
+        return undefined;
+    logToFile(`DEPRECATED: ${unprefixedName}=${unprefixed} → use ${prefixedName}=${unprefixed} instead`);
+    return unprefixed;
+}
 // Migrate legacy GEMINI_MODE / OPENAI_MODE env vars
 export function migrateBackendEnv(newVar, oldVar, providerCliValue, legacyName, newName) {
     if (newVar)
@@ -90,7 +102,7 @@ const parsedConfig = Config.safeParse({
     defaultModel: process.env.CONSULT_LLM_DEFAULT_MODEL,
     geminiBackend: resolvedGeminiBackend,
     openaiBackend: resolvedOpenaiBackend,
-    codexReasoningEffort: process.env.CODEX_REASONING_EFFORT,
+    codexReasoningEffort: migratePrefixedEnv(process.env.CONSULT_LLM_CODEX_REASONING_EFFORT, process.env.CODEX_REASONING_EFFORT, 'CODEX_REASONING_EFFORT', 'CONSULT_LLM_CODEX_REASONING_EFFORT'),
     systemPromptPath: process.env.CONSULT_LLM_SYSTEM_PROMPT_PATH,
 });
 if (!parsedConfig.success) {

package/dist/config.test.js

@@ -1,5 +1,5 @@
 import { describe, it, expect, vi } from 'vitest';
-import { migrateBackendEnv, buildModelCatalog, filterByAvailability, } from './config.js';
+import { migrateBackendEnv, migratePrefixedEnv, buildModelCatalog, filterByAvailability, } from './config.js';
 import { ALL_MODELS } from './models.js';
 vi.mock('./logger.js', () => ({ logToFile: vi.fn() }));
 describe('migrateBackendEnv', () => {
@@ -19,6 +19,17 @@ describe('migrateBackendEnv', () => {
         expect(migrateBackendEnv(undefined, 'cli', 'codex-cli', 'OPENAI_MODE', 'OPENAI_BACKEND')).toBe('codex-cli');
     });
 });
+describe('migratePrefixedEnv', () => {
+    it('returns prefixed value when set', () => {
+        expect(migratePrefixedEnv('codex-cli', 'api', 'OPENAI_BACKEND', 'CONSULT_LLM_OPENAI_BACKEND')).toBe('codex-cli');
+    });
+    it('falls back to unprefixed value with deprecation', () => {
+        expect(migratePrefixedEnv(undefined, 'gemini-cli', 'GEMINI_BACKEND', 'CONSULT_LLM_GEMINI_BACKEND')).toBe('gemini-cli');
+    });
+    it('returns undefined when both are missing', () => {
+        expect(migratePrefixedEnv(undefined, undefined, 'OPENAI_BACKEND', 'CONSULT_LLM_OPENAI_BACKEND')).toBeUndefined();
+    });
+});
 describe('filterByAvailability', () => {
     const allModels = ['gemini-2.5-pro', 'gpt-5.2', 'deepseek-reasoner'];
     it('includes gemini models when using gemini-cli backend', () => {

package/dist/version.d.ts

@@ -1 +1 @@
-export declare const GIT_HASH = "e6c6469";
+export declare const GIT_HASH = "0b76ca4";

package/dist/version.js

@@ -1 +1 @@
-export const GIT_HASH = "e6c6469";
+export const GIT_HASH = "0b76ca4";

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "consult-llm-mcp",
-  "version": "2.5.2",
+  "version": "2.5.3",
   "description": "MCP server for consulting powerful AI models",
   "type": "module",
   "main": "dist/main.js",