@shipit-ai/cli 1.170.0 → 1.171.0-pr14.c0a7138

package/dist/packages/core/src/infrastructure/services/agents/common/executors/claude-code-executor.service.d.ts

@@ -8,7 +8,7 @@
  * Uses constructor dependency injection for the spawn function
  * to enable testability without mocking node:child_process directly.
  */
-import type { AgentType, AgentFeature } from '../../../../../domain/generated/output.js';
+import type { AgentType, AgentFeature, LiteLLMProxyConfig } from '../../../../../domain/generated/output.js';
 import type { AgentExecutionOptions, AgentExecutionResult, AgentExecutionStreamEvent } from '../../../../../application/ports/output/agents/agent-executor.interface.js';
 import type { SpawnFunction } from '../types.js';
 import { ExecutorBase } from './executor-base.js';
@@ -18,7 +18,10 @@ import { ExecutorBase } from './executor-base.js';
  */
 export declare class ClaudeCodeExecutorService extends ExecutorBase {
     readonly agentType: AgentType;
+    private proxyConfig?;
     constructor(spawn: SpawnFunction);
+    updateProxyConfig(config?: LiteLLMProxyConfig): void;
+    protected buildSpawnEnv(): Record<string, string | undefined>;
     execute(prompt: string, options?: AgentExecutionOptions): Promise<AgentExecutionResult>;
     executeStream(prompt: string, options?: AgentExecutionOptions): AsyncIterable<AgentExecutionStreamEvent>;
     /**

package/dist/packages/core/src/infrastructure/services/agents/common/executors/claude-code-executor.service.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"claude-code-executor.service.d.ts","sourceRoot":"","sources":["../../../../../../../../../packages/core/src/infrastructure/services/agents/common/executors/claude-code-executor.service.ts"],"names":[],"mappings":"AAAA;;;;;;;;;GASG;AAEH,OAAO,KAAK,EACV,SAAS,EACT,YAAY,EAEb,MAAM,2CAA2C,CAAC;AACnD,OAAO,KAAK,EACV,qBAAqB,EACrB,oBAAoB,EAEpB,yBAAyB,EAC1B,MAAM,4EAA4E,CAAC;AACpF,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,aAAa,CAAC;AACjD,OAAO,EAAE,YAAY,EAAE,MAAM,oBAAoB,CAAC;AAWlD;;;GAGG;AACH,qBAAa,yBAA0B,SAAQ,YAAY;IACzD,QAAQ,CAAC,SAAS,EAAE,SAAS,CAA8B;gBAE/C,KAAK,EAAE,aAAa;IAI1B,OAAO,CAAC,MAAM,EAAE,MAAM,EAAE,OAAO,CAAC,EAAE,qBAAqB,GAAG,OAAO,CAAC,oBAAoB,CAAC;IA4FtF,aAAa,CAClB,MAAM,EAAE,MAAM,EACd,OAAO,CAAC,EAAE,qBAAqB,GAC9B,aAAa,CAAC,yBAAyB,CAAC;IA6D3C;;;OAGG;IACH,OAAO,CAAC,cAAc;IA0CtB,eAAe,CAAC,OAAO,EAAE,YAAY,GAAG,OAAO;IAI/C,OAAO,CAAC,SAAS;IA4BjB,OAAO,CAAC,eAAe;IAUvB,OAAO,CAAC,eAAe;IA6BvB;;;OAGG;IACH,OAAO,CAAC,YAAY;IAqBpB,OAAO,CAAC,eAAe;CAkExB"}
+{"version":3,"file":"claude-code-executor.service.d.ts","sourceRoot":"","sources":["../../../../../../../../../packages/core/src/infrastructure/services/agents/common/executors/claude-code-executor.service.ts"],"names":[],"mappings":"AAAA;;;;;;;;;GASG;AAEH,OAAO,KAAK,EACV,SAAS,EACT,YAAY,EAEZ,kBAAkB,EACnB,MAAM,2CAA2C,CAAC;AAEnD,OAAO,KAAK,EACV,qBAAqB,EACrB,oBAAoB,EAEpB,yBAAyB,EAC1B,MAAM,4EAA4E,CAAC;AACpF,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,aAAa,CAAC;AACjD,OAAO,EAAE,YAAY,EAAE,MAAM,oBAAoB,CAAC;AAWlD;;;GAGG;AACH,qBAAa,yBAA0B,SAAQ,YAAY;IACzD,QAAQ,CAAC,SAAS,EAAE,SAAS,CAA8B;IAC3D,OAAO,CAAC,WAAW,CAAC,CAAqB;gBAE7B,KAAK,EAAE,aAAa;IAIhC,iBAAiB,CAAC,MAAM,CAAC,EAAE,kBAAkB,GAAG,IAAI;cAIjC,aAAa,IAAI,MAAM,CAAC,MAAM,EAAE,MAAM,GAAG,SAAS,CAAC;IAkDhE,OAAO,CAAC,MAAM,EAAE,MAAM,EAAE,OAAO,CAAC,EAAE,qBAAqB,GAAG,OAAO,CAAC,oBAAoB,CAAC;IA4FtF,aAAa,CAClB,MAAM,EAAE,MAAM,EACd,OAAO,CAAC,EAAE,qBAAqB,GAC9B,aAAa,CAAC,yBAAyB,CAAC;IA6D3C;;;OAGG;IACH,OAAO,CAAC,cAAc;IA0CtB,eAAe,CAAC,OAAO,EAAE,YAAY,GAAG,OAAO;IAI/C,OAAO,CAAC,SAAS;IA4BjB,OAAO,CAAC,eAAe;IAUvB,OAAO,CAAC,eAAe;IA6BvB;;;OAGG;IACH,OAAO,CAAC,YAAY;IAqBpB,OAAO,CAAC,eAAe;CAkExB"}

package/dist/packages/core/src/infrastructure/services/agents/common/executors/claude-code-executor.service.js

@@ -8,6 +8,7 @@
  * Uses constructor dependency injection for the spawn function
  * to enable testability without mocking node:child_process directly.
  */
+import { LiteLLMProxyRoutingMode } from '../../../../../domain/generated/output.js';
 import { ExecutorBase } from './executor-base.js';
 /** Features supported by Claude Code CLI */
 const SUPPORTED_FEATURES = new Set([
@@ -23,9 +24,61 @@ const SUPPORTED_FEATURES = new Set([
  */
 export class ClaudeCodeExecutorService extends ExecutorBase {
     agentType = 'claude-code';
+    proxyConfig;
     constructor(spawn) {
         super(spawn);
     }
+    updateProxyConfig(config) {
+        this.proxyConfig = config;
+    }
+    buildSpawnEnv() {
+        const env = super.buildSpawnEnv();
+        const cc = this.proxyConfig?.claudeCode;
+        if (!cc || !this.proxyConfig?.baseUrl)
+            return env;
+        const mode = cc.routingMode ?? LiteLLMProxyRoutingMode.direct;
+        if (mode === LiteLLMProxyRoutingMode.direct)
+            return env;
+        // Guard against unrecognized routing modes (DB corruption, future enum additions)
+        if (mode !== LiteLLMProxyRoutingMode.proxy && mode !== LiteLLMProxyRoutingMode.passthrough) {
+            this.log(`WARNING: Unknown LiteLLM routing mode "${mode}", falling back to direct mode`);
+            return env;
+        }
+        // Both proxy and passthrough set BASE_URL
+        env.ANTHROPIC_BASE_URL = this.proxyConfig.baseUrl;
+        if (mode === LiteLLMProxyRoutingMode.proxy) {
+            if (this.proxyConfig.apiKey) {
+                env.ANTHROPIC_AUTH_TOKEN = this.proxyConfig.apiKey;
+            }
+            if (cc.customHeaders) {
+                env.ANTHROPIC_CUSTOM_HEADERS = cc.customHeaders;
+            }
+        }
+        else {
+            // passthrough mode
+            const headers = [];
+            if (this.proxyConfig.apiKey) {
+                headers.push(`x-litellm-api-key: Bearer ${this.proxyConfig.apiKey}`);
+            }
+            else {
+                this.log('WARNING: Passthrough mode active but no proxy API key configured — proxy may reject requests');
+            }
+            if (cc.customHeaders) {
+                headers.push(cc.customHeaders);
+            }
+            if (headers.length) {
+                env.ANTHROPIC_CUSTOM_HEADERS = headers.join('\n');
+            }
+        }
+        // Model overrides (both proxy and passthrough)
+        if (cc.sonnetModel)
+            env.ANTHROPIC_DEFAULT_SONNET_MODEL = cc.sonnetModel;
+        if (cc.haikuModel)
+            env.ANTHROPIC_DEFAULT_HAIKU_MODEL = cc.haikuModel;
+        if (cc.opusModel)
+            env.ANTHROPIC_DEFAULT_OPUS_MODEL = cc.opusModel;
+        return env;
+    }
     async execute(prompt, options) {
         this.silent = options?.silent ?? false;
         // Use stream-json so we get real-time events in the worker log

package/dist/packages/core/src/infrastructure/services/agents/common/executors/codex-cli-executor.service.d.ts

@@ -7,7 +7,7 @@
  * Uses constructor dependency injection for the spawn function
  * to enable testability without mocking node:child_process directly.
  */
-import type { AgentType, AgentFeature, AgentConfig } from '../../../../../domain/generated/output.js';
+import type { AgentType, AgentFeature, AgentConfig, LiteLLMProxyConfig } from '../../../../../domain/generated/output.js';
 import type { AgentExecutionOptions, AgentExecutionResult, AgentExecutionStreamEvent } from '../../../../../application/ports/output/agents/agent-executor.interface.js';
 import type { SpawnFunction } from '../types.js';
 import { ExecutorBase } from './executor-base.js';
@@ -18,7 +18,9 @@ import { ExecutorBase } from './executor-base.js';
 export declare class CodexCliExecutorService extends ExecutorBase {
     readonly agentType: AgentType;
     private readonly authConfig?;
+    private proxyConfig?;
     constructor(spawn: SpawnFunction, authConfig?: AgentConfig);
+    updateProxyConfig(config?: LiteLLMProxyConfig): void;
     supportsFeature(feature: AgentFeature): boolean;
     execute(prompt: string, options?: AgentExecutionOptions): Promise<AgentExecutionResult>;
     executeStream(prompt: string, options?: AgentExecutionOptions): AsyncIterable<AgentExecutionStreamEvent>;

package/dist/packages/core/src/infrastructure/services/agents/common/executors/codex-cli-executor.service.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"codex-cli-executor.service.d.ts","sourceRoot":"","sources":["../../../../../../../../../packages/core/src/infrastructure/services/agents/common/executors/codex-cli-executor.service.ts"],"names":[],"mappings":"AAAA;;;;;;;;GAQG;AAKH,OAAO,KAAK,EACV,SAAS,EACT,YAAY,EACZ,WAAW,EAEZ,MAAM,2CAA2C,CAAC;AACnD,OAAO,KAAK,EACV,qBAAqB,EACrB,oBAAoB,EAEpB,yBAAyB,EAC1B,MAAM,4EAA4E,CAAC;AACpF,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,aAAa,CAAC;AACjD,OAAO,EAAE,YAAY,EAAE,MAAM,oBAAoB,CAAC;AAsBlD;;;GAGG;AACH,qBAAa,uBAAwB,SAAQ,YAAY;IACvD,QAAQ,CAAC,SAAS,EAAE,SAAS,CAA4B;IAEzD,OAAO,CAAC,QAAQ,CAAC,UAAU,CAAC,CAAc;gBAE9B,KAAK,EAAE,aAAa,EAAE,UAAU,CAAC,EAAE,WAAW;IAK1D,eAAe,CAAC,OAAO,EAAE,YAAY,GAAG,OAAO;IAIzC,OAAO,CAAC,MAAM,EAAE,MAAM,EAAE,OAAO,CAAC,EAAE,qBAAqB,GAAG,OAAO,CAAC,oBAAoB,CAAC;IAuItF,aAAa,CAClB,MAAM,EAAE,MAAM,EACd,OAAO,CAAC,EAAE,qBAAqB,GAC9B,aAAa,CAAC,yBAAyB,CAAC;IAoM3C;;;;OAIG;IACH,wDAAwD;IACxD,OAAO,CAAC,MAAM,CAAC,QAAQ,CAAC,kBAAkB,CAAyC;IAEnF,OAAO,CAAC,cAAc;IAkJtB;;;;;OAKG;IACH,OAAO,CAAC,SAAS;cA+BE,aAAa,IAAI,MAAM,CAAC,MAAM,EAAE,MAAM,GAAG,SAAS,CAAC;IAQtE;;OAEG;IACH,OAAO,CAAC,YAAY;IAUpB;;;OAGG;IACH,OAAO,CAAC,gBAAgB;IAgBxB;;;OAGG;IACH,OAAO,CAAC,eAAe;IAkBvB;;;OAGG;IACH,OAAO,CAAC,sBAAsB;CAU/B"}
+{"version":3,"file":"codex-cli-executor.service.d.ts","sourceRoot":"","sources":["../../../../../../../../../packages/core/src/infrastructure/services/agents/common/executors/codex-cli-executor.service.ts"],"names":[],"mappings":"AAAA;;;;;;;;GAQG;AAKH,OAAO,KAAK,EACV,SAAS,EACT,YAAY,EACZ,WAAW,EAEX,kBAAkB,EACnB,MAAM,2CAA2C,CAAC;AAEnD,OAAO,KAAK,EACV,qBAAqB,EACrB,oBAAoB,EAEpB,yBAAyB,EAC1B,MAAM,4EAA4E,CAAC;AACpF,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,aAAa,CAAC;AACjD,OAAO,EAAE,YAAY,EAAE,MAAM,oBAAoB,CAAC;AAsBlD;;;GAGG;AACH,qBAAa,uBAAwB,SAAQ,YAAY;IACvD,QAAQ,CAAC,SAAS,EAAE,SAAS,CAA4B;IAEzD,OAAO,CAAC,QAAQ,CAAC,UAAU,CAAC,CAAc;IAC1C,OAAO,CAAC,WAAW,CAAC,CAAqB;gBAE7B,KAAK,EAAE,aAAa,EAAE,UAAU,CAAC,EAAE,WAAW;IAK1D,iBAAiB,CAAC,MAAM,CAAC,EAAE,kBAAkB,GAAG,IAAI;IAIpD,eAAe,CAAC,OAAO,EAAE,YAAY,GAAG,OAAO;IAIzC,OAAO,CAAC,MAAM,EAAE,MAAM,EAAE,OAAO,CAAC,EAAE,qBAAqB,GAAG,OAAO,CAAC,oBAAoB,CAAC;IAuItF,aAAa,CAClB,MAAM,EAAE,MAAM,EACd,OAAO,CAAC,EAAE,qBAAqB,GAC9B,aAAa,CAAC,yBAAyB,CAAC;IAoM3C;;;;OAIG;IACH,wDAAwD;IACxD,OAAO,CAAC,MAAM,CAAC,QAAQ,CAAC,kBAAkB,CAAyC;IAEnF,OAAO,CAAC,cAAc;IAkJtB;;;;;OAKG;IACH,OAAO,CAAC,SAAS;cA+BE,aAAa,IAAI,MAAM,CAAC,MAAM,EAAE,MAAM,GAAG,SAAS,CAAC;IAoBtE;;OAEG;IACH,OAAO,CAAC,YAAY;IAUpB;;;OAGG;IACH,OAAO,CAAC,gBAAgB;IAgBxB;;;OAGG;IACH,OAAO,CAAC,eAAe;IAkBvB;;;OAGG;IACH,OAAO,CAAC,sBAAsB;CAU/B"}

package/dist/packages/core/src/infrastructure/services/agents/common/executors/codex-cli-executor.service.js

@@ -10,6 +10,7 @@
 import * as fs from 'node:fs';
 import * as os from 'node:os';
 import * as path from 'node:path';
+import { LiteLLMProxyRoutingMode } from '../../../../../domain/generated/output.js';
 import { ExecutorBase } from './executor-base.js';
 /** Features supported by Codex CLI */
 const SUPPORTED_FEATURES = new Set([
@@ -36,10 +37,14 @@ const FATAL_STDERR_PATTERNS = [
 export class CodexCliExecutorService extends ExecutorBase {
     agentType = 'codex-cli';
     authConfig;
+    proxyConfig;
     constructor(spawn, authConfig) {
         super(spawn);
         this.authConfig = authConfig;
     }
+    updateProxyConfig(config) {
+        this.proxyConfig = config;
+    }
     supportsFeature(feature) {
         return SUPPORTED_FEATURES.has(feature);
     }
@@ -491,8 +496,18 @@ export class CodexCliExecutorService extends ExecutorBase {
     }
     buildSpawnEnv() {
         const env = super.buildSpawnEnv();
+        // Proxy mode: use OPENAI_BASE_URL + OPENAI_API_KEY (not CODEX_API_KEY)
+        const cx = this.proxyConfig?.codexCli;
+        if (cx?.routingMode === LiteLLMProxyRoutingMode.proxy && this.proxyConfig?.baseUrl) {
+            env.OPENAI_BASE_URL = this.proxyConfig.baseUrl;
+            if (this.proxyConfig.apiKey) {
+                env.OPENAI_API_KEY = this.proxyConfig.apiKey;
+            }
+            return env;
+        }
+        // Direct mode: existing authConfig token injection
         if (this.authConfig?.authMethod === 'token' && this.authConfig.token) {
-            return { ...env, CODEX_API_KEY: this.authConfig.token };
+            env.CODEX_API_KEY = this.authConfig.token;
         }
         return env;
     }

package/dist/packages/core/src/infrastructure/services/agents/common/executors/gemini-cli-executor.service.d.ts

@@ -7,7 +7,7 @@
  * Uses constructor dependency injection for the spawn function
  * to enable testability without mocking node:child_process directly.
  */
-import type { AgentType, AgentFeature, AgentConfig } from '../../../../../domain/generated/output.js';
+import type { AgentType, AgentFeature, AgentConfig, LiteLLMProxyConfig } from '../../../../../domain/generated/output.js';
 import type { AgentExecutionOptions, AgentExecutionResult, AgentExecutionStreamEvent } from '../../../../../application/ports/output/agents/agent-executor.interface.js';
 import type { SpawnFunction } from '../types.js';
 import { ExecutorBase } from './executor-base.js';
@@ -18,7 +18,9 @@ import { ExecutorBase } from './executor-base.js';
 export declare class GeminiCliExecutorService extends ExecutorBase {
     readonly agentType: AgentType;
     private readonly authConfig?;
+    private proxyConfig?;
     constructor(spawn: SpawnFunction, authConfig?: AgentConfig);
+    updateProxyConfig(config?: LiteLLMProxyConfig): void;
     supportsFeature(feature: AgentFeature): boolean;
     execute(prompt: string, options?: AgentExecutionOptions): Promise<AgentExecutionResult>;
     executeStream(prompt: string, options?: AgentExecutionOptions): AsyncIterable<AgentExecutionStreamEvent>;

package/dist/packages/core/src/infrastructure/services/agents/common/executors/gemini-cli-executor.service.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"gemini-cli-executor.service.d.ts","sourceRoot":"","sources":["../../../../../../../../../packages/core/src/infrastructure/services/agents/common/executors/gemini-cli-executor.service.ts"],"names":[],"mappings":"AAAA;;;;;;;;GAQG;AAEH,OAAO,KAAK,EACV,SAAS,EACT,YAAY,EACZ,WAAW,EAEZ,MAAM,2CAA2C,CAAC;AACnD,OAAO,KAAK,EACV,qBAAqB,EACrB,oBAAoB,EACpB,yBAAyB,EAC1B,MAAM,4EAA4E,CAAC;AACpF,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,aAAa,CAAC;AACjD,OAAO,EAAE,YAAY,EAAE,MAAM,oBAAoB,CAAC;AAKlD;;;GAGG;AACH,qBAAa,wBAAyB,SAAQ,YAAY;IACxD,QAAQ,CAAC,SAAS,EAAE,SAAS,CAA6B;IAE1D,OAAO,CAAC,QAAQ,CAAC,UAAU,CAAC,CAAc;gBAE9B,KAAK,EAAE,aAAa,EAAE,UAAU,CAAC,EAAE,WAAW;IAK1D,eAAe,CAAC,OAAO,EAAE,YAAY,GAAG,OAAO;IAIzC,OAAO,CAAC,MAAM,EAAE,MAAM,EAAE,OAAO,CAAC,EAAE,qBAAqB,GAAG,OAAO,CAAC,oBAAoB,CAAC;IAsFtF,aAAa,CAClB,MAAM,EAAE,MAAM,EACd,OAAO,CAAC,EAAE,qBAAqB,GAC9B,aAAa,CAAC,yBAAyB,CAAC;IAgF3C;;;OAGG;IACH,OAAO,CAAC,gBAAgB;IAmDxB;;;OAGG;IACH,OAAO,CAAC,MAAM,CAAC,QAAQ,CAAC,qBAAqB,CAI3C;IAEF;;;OAGG;IACH,OAAO,CAAC,sBAAsB;IAY9B;;;OAGG;IACH,OAAO,CAAC,YAAY;IAgBpB,OAAO,CAAC,SAAS;cAyBE,aAAa,IAAI,MAAM,CAAC,MAAM,EAAE,MAAM,GAAG,SAAS,CAAC;CAOvE"}
+{"version":3,"file":"gemini-cli-executor.service.d.ts","sourceRoot":"","sources":["../../../../../../../../../packages/core/src/infrastructure/services/agents/common/executors/gemini-cli-executor.service.ts"],"names":[],"mappings":"AAAA;;;;;;;;GAQG;AAEH,OAAO,KAAK,EACV,SAAS,EACT,YAAY,EACZ,WAAW,EAEX,kBAAkB,EACnB,MAAM,2CAA2C,CAAC;AAEnD,OAAO,KAAK,EACV,qBAAqB,EACrB,oBAAoB,EACpB,yBAAyB,EAC1B,MAAM,4EAA4E,CAAC;AACpF,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,aAAa,CAAC;AACjD,OAAO,EAAE,YAAY,EAAE,MAAM,oBAAoB,CAAC;AAKlD;;;GAGG;AACH,qBAAa,wBAAyB,SAAQ,YAAY;IACxD,QAAQ,CAAC,SAAS,EAAE,SAAS,CAA6B;IAE1D,OAAO,CAAC,QAAQ,CAAC,UAAU,CAAC,CAAc;IAC1C,OAAO,CAAC,WAAW,CAAC,CAAqB;gBAE7B,KAAK,EAAE,aAAa,EAAE,UAAU,CAAC,EAAE,WAAW;IAK1D,iBAAiB,CAAC,MAAM,CAAC,EAAE,kBAAkB,GAAG,IAAI;IAIpD,eAAe,CAAC,OAAO,EAAE,YAAY,GAAG,OAAO;IAIzC,OAAO,CAAC,MAAM,EAAE,MAAM,EAAE,OAAO,CAAC,EAAE,qBAAqB,GAAG,OAAO,CAAC,oBAAoB,CAAC;IAsFtF,aAAa,CAClB,MAAM,EAAE,MAAM,EACd,OAAO,CAAC,EAAE,qBAAqB,GAC9B,aAAa,CAAC,yBAAyB,CAAC;IAgF3C;;;OAGG;IACH,OAAO,CAAC,gBAAgB;IAmDxB;;;OAGG;IACH,OAAO,CAAC,MAAM,CAAC,QAAQ,CAAC,qBAAqB,CAI3C;IAEF;;;OAGG;IACH,OAAO,CAAC,sBAAsB;IAY9B;;;OAGG;IACH,OAAO,CAAC,YAAY;IAgBpB,OAAO,CAAC,SAAS;cAyBE,aAAa,IAAI,MAAM,CAAC,MAAM,EAAE,MAAM,GAAG,SAAS,CAAC;CAmBvE"}

package/dist/packages/core/src/infrastructure/services/agents/common/executors/gemini-cli-executor.service.js

@@ -7,6 +7,7 @@
  * Uses constructor dependency injection for the spawn function
  * to enable testability without mocking node:child_process directly.
  */
+import { LiteLLMProxyRoutingMode } from '../../../../../domain/generated/output.js';
 import { ExecutorBase } from './executor-base.js';
 /** Features supported by Gemini CLI */
 const SUPPORTED_FEATURES = new Set(['session-resume', 'streaming', 'tool-scoping']);
@@ -17,10 +18,14 @@ const SUPPORTED_FEATURES = new Set(['session-resume', 'streaming', 'tool-scoping
 export class GeminiCliExecutorService extends ExecutorBase {
     agentType = 'gemini-cli';
     authConfig;
+    proxyConfig;
     constructor(spawn, authConfig) {
         super(spawn);
         this.authConfig = authConfig;
     }
+    updateProxyConfig(config) {
+        this.proxyConfig = config;
+    }
     supportsFeature(feature) {
         return SUPPORTED_FEATURES.has(feature);
     }
@@ -279,8 +284,18 @@ export class GeminiCliExecutorService extends ExecutorBase {
     }
     buildSpawnEnv() {
         const env = super.buildSpawnEnv();
+        // Proxy mode takes precedence — proxy key overrides authConfig token
+        const gc = this.proxyConfig?.geminiCli;
+        if (gc?.routingMode === LiteLLMProxyRoutingMode.proxy && this.proxyConfig?.baseUrl) {
+            env.GOOGLE_GEMINI_BASE_URL = this.proxyConfig.baseUrl;
+            if (this.proxyConfig.apiKey) {
+                env.GEMINI_API_KEY = this.proxyConfig.apiKey;
+                return env;
+            }
+        }
+        // Direct mode: existing authConfig token injection
         if (this.authConfig?.authMethod === 'token' && this.authConfig.token) {
-            return { ...env, GEMINI_API_KEY: this.authConfig.token };
+            env.GEMINI_API_KEY = this.authConfig.token;
         }
         return env;
     }

package/dist/packages/core/src/infrastructure/services/agents/feature-agent/feature-agent-worker.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"feature-agent-worker.d.ts","sourceRoot":"","sources":["../../../../../../../../packages/core/src/infrastructure/services/agents/feature-agent/feature-agent-worker.ts"],"names":[],"mappings":";AACA;;;;;;;;GAQG;AAEH,OAAO,kBAAkB,CAAC;AAgB1B,OAAO,EAAiC,KAAK,SAAS,EAAE,MAAM,8BAA8B,CAAC;AAW7F,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,8BAA8B,CAAC;AAElE,MAAM,WAAW,UAAU;IACzB,SAAS,EAAE,MAAM,CAAC;IAClB,KAAK,EAAE,MAAM,CAAC;IACd,IAAI,EAAE,MAAM,CAAC;IACb,OAAO,EAAE,MAAM,CAAC;IAChB,YAAY,CAAC,EAAE,MAAM,CAAC;IACtB,aAAa,CAAC,EAAE,aAAa,CAAC;IAC9B,MAAM,CAAC,EAAE,OAAO,CAAC;IACjB,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB,mBAAmB,CAAC,EAAE,OAAO,CAAC;IAC9B,IAAI,CAAC,EAAE,OAAO,CAAC;IACf,MAAM,CAAC,EAAE,OAAO,CAAC;IACjB,SAAS,CAAC,EAAE,OAAO,CAAC;IACpB,WAAW,CAAC,EAAE,OAAO,CAAC;IACtB,cAAc,CAAC,EAAE,OAAO,CAAC;IACzB,cAAc,CAAC,EAAE,OAAO,CAAC;IACzB,cAAc,CAAC,EAAE,OAAO,CAAC;IACzB,aAAa,CAAC,EAAE,MAAM,CAAC;IACvB,SAAS,CAAC,EAAE,SAAS,CAAC;IACtB,IAAI,CAAC,EAAE,OAAO,CAAC;IACf,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,YAAY,CAAC,EAAE,MAAM,CAAC;IACtB,cAAc,CAAC,EAAE,MAAM,CAAC;CACzB;AAED;;;GAGG;AACH,wBAAgB,eAAe,CAAC,IAAI,EAAE,MAAM,EAAE,GAAG,UAAU,CAyF1D;AAgCD;;;GAGG;AACH,wBAAsB,SAAS,CAAC,IAAI,EAAE,UAAU,GAAG,OAAO,CAAC,IAAI,CAAC,CA0S/D"}
+{"version":3,"file":"feature-agent-worker.d.ts","sourceRoot":"","sources":["../../../../../../../../packages/core/src/infrastructure/services/agents/feature-agent/feature-agent-worker.ts"],"names":[],"mappings":";AACA;;;;;;;;GAQG;AAEH,OAAO,kBAAkB,CAAC;AAmB1B,OAAO,EAAiC,KAAK,SAAS,EAAE,MAAM,8BAA8B,CAAC;AAW7F,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,8BAA8B,CAAC;AAElE,MAAM,WAAW,UAAU;IACzB,SAAS,EAAE,MAAM,CAAC;IAClB,KAAK,EAAE,MAAM,CAAC;IACd,IAAI,EAAE,MAAM,CAAC;IACb,OAAO,EAAE,MAAM,CAAC;IAChB,YAAY,CAAC,EAAE,MAAM,CAAC;IACtB,aAAa,CAAC,EAAE,aAAa,CAAC;IAC9B,MAAM,CAAC,EAAE,OAAO,CAAC;IACjB,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB,mBAAmB,CAAC,EAAE,OAAO,CAAC;IAC9B,IAAI,CAAC,EAAE,OAAO,CAAC;IACf,MAAM,CAAC,EAAE,OAAO,CAAC;IACjB,SAAS,CAAC,EAAE,OAAO,CAAC;IACpB,WAAW,CAAC,EAAE,OAAO,CAAC;IACtB,cAAc,CAAC,EAAE,OAAO,CAAC;IACzB,cAAc,CAAC,EAAE,OAAO,CAAC;IACzB,cAAc,CAAC,EAAE,OAAO,CAAC;IACzB,aAAa,CAAC,EAAE,MAAM,CAAC;IACvB,SAAS,CAAC,EAAE,SAAS,CAAC;IACtB,IAAI,CAAC,EAAE,OAAO,CAAC;IACf,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,YAAY,CAAC,EAAE,MAAM,CAAC;IACtB,cAAc,CAAC,EAAE,MAAM,CAAC;CACzB;AAED;;;GAGG;AACH,wBAAgB,eAAe,CAAC,IAAI,EAAE,MAAM,EAAE,GAAG,UAAU,CAyF1D;AAgCD;;;GAGG;AACH,wBAAsB,SAAS,CAAC,IAAI,EAAE,UAAU,GAAG,OAAO,CAAC,IAAI,CAAC,CAkT/D"}

package/dist/packages/core/src/infrastructure/services/agents/feature-agent/feature-agent-worker.js

@@ -16,6 +16,9 @@ import { initializeContainer, container } from '../../../di/container.js';
 import { createFeatureAgentGraph } from './feature-agent-graph.js';
 import { createFastFeatureAgentGraph } from './fast-feature-agent-graph.js';
 import { createCheckpointer } from '../common/checkpointer.js';
+import { ClaudeCodeExecutorService } from '../../../services/agents/common/executors/claude-code-executor.service.js';
+import { GeminiCliExecutorService } from '../../../services/agents/common/executors/gemini-cli-executor.service.js';
+import { CodexCliExecutorService } from '../../../services/agents/common/executors/codex-cli-executor.service.js';
 import { AgentRunStatus, SdlcLifecycle } from '../../../../domain/generated/output.js';
 import { initializeSettings } from '../../../services/settings.service.js';
 import { InitializeSettingsUseCase } from '../../../../application/use-cases/settings/initialize-settings.use-case.js';
@@ -183,6 +186,16 @@ export async function runWorker(args) {
         log(`Creating executor from pinned agent type: ${args.agentType}`);
         const factory = container.resolve('IAgentExecutorFactory');
         executor = factory.createExecutor(args.agentType, settings.agent);
+        // Update proxy config for direct factory calls (provider does this automatically)
+        if (executor instanceof ClaudeCodeExecutorService) {
+            executor.updateProxyConfig(settings.litellmProxy);
+        }
+        else if (executor instanceof GeminiCliExecutorService) {
+            executor.updateProxyConfig(settings.litellmProxy);
+        }
+        else if (executor instanceof CodexCliExecutorService) {
+            executor.updateProxyConfig(settings.litellmProxy);
+        }
     }
     else {
         log('Creating executor from configured agent settings...');

package/dist/src/presentation/web/components/features/plugins/plugins-page-client.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"plugins-page-client.d.ts","sourceRoot":"","sources":["../../../../../../../src/presentation/web/components/features/plugins/plugins-page-client.tsx"],"names":[],"mappings":"AAqBA,MAAM,WAAW,sBAAsB;IACrC,eAAe,EAAE,OAAO,CAAC;IACzB,YAAY,EAAE,OAAO,CAAC;CACvB;AAED,wBAAgB,iBAAiB,CAAC,EAAE,eAAe,EAAE,YAAY,EAAE,EAAE,sBAAsB,2CA0M1F"}
+{"version":3,"file":"plugins-page-client.d.ts","sourceRoot":"","sources":["../../../../../../../src/presentation/web/components/features/plugins/plugins-page-client.tsx"],"names":[],"mappings":"AAqBA,MAAM,WAAW,sBAAsB;IACrC,eAAe,EAAE,OAAO,CAAC;IACzB,YAAY,EAAE,OAAO,CAAC;CACvB;AAED,wBAAgB,iBAAiB,CAAC,EAAE,eAAe,EAAE,YAAY,EAAE,EAAE,sBAAsB,2CAiP1F"}

package/dist/src/presentation/web/components/features/plugins/plugins-page-client.js

@@ -19,6 +19,7 @@ export function PluginsPageClient({ proxyConfigured, isClaudeCode }) {
     const [, startTransition] = useTransition();
     const [searchQuery, setSearchQuery] = useState('');
     const [activeCategory, setActiveCategory] = useState(null);
+    const [statusFilter, setStatusFilter] = useState(null);
     const [selectedPlugin, setSelectedPlugin] = useState(null);
     const [plugins, setPlugins] = useState([]);
     const [installedPlugins, setInstalledPlugins] = useState([]);
@@ -47,6 +48,13 @@ export function PluginsPageClient({ proxyConfigured, isClaudeCode }) {
         return plugins.filter((p) => {
             if (activeCategory && p.category !== activeCategory)
                 return false;
+            if (statusFilter) {
+                const isInstalled = !!installedPlugins.find((ip) => ip.id.startsWith(`${p.name}@`));
+                if (statusFilter === 'installed' && !isInstalled)
+                    return false;
+                if (statusFilter === 'not-installed' && isInstalled)
+                    return false;
+            }
             if (query) {
                 const matchesName = p.name.toLowerCase().includes(query);
                 const matchesDescription = p.description.toLowerCase().includes(query);
@@ -55,7 +63,7 @@ export function PluginsPageClient({ proxyConfigured, isClaudeCode }) {
             }
             return true;
         });
-    }, [plugins, searchQuery, activeCategory]);
+    }, [plugins, searchQuery, activeCategory, statusFilter, installedPlugins]);
     const getInstalled = (pluginName) => installedPlugins.find((ip) => ip.id.startsWith(`${pluginName}@`));
     const handleInstall = (pluginName) => {
         startTransition(async () => {
@@ -108,8 +116,9 @@ export function PluginsPageClient({ proxyConfigured, isClaudeCode }) {
     if (plugins.length === 0) {
         return (_jsxs("div", { className: "flex flex-col gap-8 p-8", children: [_jsx(PageHeader, { eyebrow: "Developer Portal", title: t('plugins.title') }), _jsx(EmptyState, { icon: _jsx(Blocks, { className: "size-10" }), title: t('plugins.emptyState') })] }));
     }
-    return (_jsxs("div", { className: "flex flex-col gap-8 p-8", children: [_jsx(PageHeader, { eyebrow: "Developer Portal", title: t('plugins.title') }), _jsxs("div", { className: "relative", children: [_jsx(Search, { className: "text-muted-foreground absolute top-1/2 left-3 size-4 -translate-y-1/2" }), _jsx(Input, { placeholder: t('plugins.searchPlaceholder'), value: searchQuery, onChange: (e) => setSearchQuery(e.target.value), className: "ps-9", "data-testid": "plugin-search" })] }), _jsxs("div", { className: "flex flex-wrap gap-2", children: [_jsx(Button, { variant: activeCategory === null ? 'default' : 'outline', size: "sm", onClick: () => setActiveCategory(null), children: t('plugins.allCategories') }), categories.map((cat) => (_jsx(Button, { variant: activeCategory === cat ? 'default' : 'outline', size: "sm", onClick: () => setActiveCategory(cat === activeCategory ? null : cat), children: cat }, cat)))] }), filteredPlugins.length > 0 ? (_jsx("div", { className: "grid grid-cols-1 gap-4 sm:grid-cols-2 lg:grid-cols-3", children: filteredPlugins.map((plugin) => (_jsx(PluginCard, { plugin: plugin, installed: getInstalled(plugin.name), onSelect: setSelectedPlugin, onToggle: handleToggle }, plugin.name))) })) : (_jsx(EmptyState, { icon: _jsx(Search, { className: "size-10" }), title: t('plugins.emptyState'), action: _jsx(Button, { variant: "outline", onClick: () => {
+    return (_jsxs("div", { className: "flex flex-col gap-8 p-8", children: [_jsx(PageHeader, { eyebrow: "Developer Portal", title: t('plugins.title') }), _jsxs("div", { className: "relative", children: [_jsx(Search, { className: "text-muted-foreground absolute top-1/2 left-3 size-4 -translate-y-1/2" }), _jsx(Input, { placeholder: t('plugins.searchPlaceholder'), value: searchQuery, onChange: (e) => setSearchQuery(e.target.value), className: "ps-9", "data-testid": "plugin-search" })] }), _jsxs("div", { className: "flex flex-wrap items-center gap-4", children: [_jsxs("div", { className: "flex flex-wrap gap-2", children: [_jsx(Button, { variant: activeCategory === null ? 'default' : 'outline', size: "sm", onClick: () => setActiveCategory(null), children: t('plugins.allCategories') }), categories.map((cat) => (_jsx(Button, { variant: activeCategory === cat ? 'default' : 'outline', size: "sm", onClick: () => setActiveCategory(cat === activeCategory ? null : cat), children: cat }, cat)))] }), _jsx("div", { className: "bg-border h-6 w-px" }), _jsxs("div", { className: "flex flex-wrap gap-2", children: [_jsx(Button, { variant: statusFilter === null ? 'default' : 'outline', size: "sm", onClick: () => setStatusFilter(null), children: "All Status" }), _jsx(Button, { variant: statusFilter === 'installed' ? 'default' : 'outline', size: "sm", onClick: () => setStatusFilter(statusFilter === 'installed' ? null : 'installed'), children: t('plugins.installed') }), _jsx(Button, { variant: statusFilter === 'not-installed' ? 'default' : 'outline', size: "sm", onClick: () => setStatusFilter(statusFilter === 'not-installed' ? null : 'not-installed'), children: t('plugins.notInstalled') })] })] }), filteredPlugins.length > 0 ? (_jsx("div", { className: "grid grid-cols-1 gap-4 sm:grid-cols-2 lg:grid-cols-3", children: filteredPlugins.map((plugin) => (_jsx(PluginCard, { plugin: plugin, installed: getInstalled(plugin.name), onSelect: setSelectedPlugin, onToggle: handleToggle }, plugin.name))) })) : (_jsx(EmptyState, { icon: _jsx(Search, { className: "size-10" }), title: t('plugins.emptyState'), action: _jsx(Button, { variant: "outline", onClick: () => {
                         setSearchQuery('');
                         setActiveCategory(null);
+                        setStatusFilter(null);
                     }, children: t('plugins.clearFilters') }) })), _jsx(PluginDetailDrawer, { plugin: selectedPlugin, installed: selectedPlugin ? getInstalled(selectedPlugin.name) : undefined, open: !!selectedPlugin, onClose: () => setSelectedPlugin(null), onInstall: handleInstall, onUninstall: handleUninstall })] }));
 }

package/dist/src/presentation/web/components/features/settings/feature-flags-settings-section.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"feature-flags-settings-section.d.ts","sourceRoot":"","sources":["../../../../../../../src/presentation/web/components/features/settings/feature-flags-settings-section.tsx"],"names":[],"mappings":"AAOA,OAAO,KAAK,EAAE,QAAQ,EAAgB,MAAM,yCAAyC,CAAC;AAGtF,MAAM,WAAW,gCAAgC;IAC/C,QAAQ,EAAE,QAAQ,CAAC;CACpB;AAED,wBAAgB,2BAA2B,CAAC,EAAE,QAAQ,EAAE,EAAE,gCAAgC,2CA6IzF"}
+{"version":3,"file":"feature-flags-settings-section.d.ts","sourceRoot":"","sources":["../../../../../../../src/presentation/web/components/features/settings/feature-flags-settings-section.tsx"],"names":[],"mappings":"AAOA,OAAO,KAAK,EAAE,QAAQ,EAAgB,MAAM,yCAAyC,CAAC;AAGtF,MAAM,WAAW,gCAAgC;IAC/C,QAAQ,EAAE,QAAQ,CAAC;CACpB;AAED,wBAAgB,2BAA2B,CAAC,EAAE,QAAQ,EAAE,EAAE,gCAAgC,2CAkJzF"}

package/dist/src/presentation/web/components/features/settings/feature-flags-settings-section.js

@@ -56,7 +56,9 @@ export function FeatureFlagsSettingsSection({ settings }) {
                     const newFlags = { ...flags, reactFileManager: v };
                     setFlags(newFlags);
                     save({ featureFlags: newFlags });
-                } }), _jsx(SwitchRow, { label: t('settings.featureFlags.plugins'), description: t('settings.featureFlags.pluginsDescription'), tooltip: "Enables the Plugins page for browsing and managing Claude Code plugins from a LiteLLM marketplace.", id: "flag-plugins", testId: "switch-flag-plugins", checked: flags.plugins, onChange: (v) => {
+                } }), _jsx(SwitchRow, { label: t('settings.featureFlags.plugins'), description: settings.litellmProxy?.baseUrl
+                    ? t('settings.featureFlags.pluginsDescription')
+                    : `${t('settings.featureFlags.pluginsDescription')} — ${t('plugins.noProxy')}`, tooltip: "Enables the Plugins page for browsing and managing Claude Code plugins from a LiteLLM marketplace. Requires a LiteLLM proxy URL to be configured.", id: "flag-plugins", testId: "switch-flag-plugins", checked: flags.plugins, disabled: !settings.litellmProxy?.baseUrl, onChange: (v) => {
                     const newFlags = { ...flags, plugins: v };
                     setFlags(newFlags);
                     save({ featureFlags: newFlags });

package/dist/src/presentation/web/components/features/settings/litellm-proxy-routing-section.d.ts

@@ -0,0 +1,6 @@
+import type { Settings } from '../../../../../../packages/core/src/domain/generated/output.js';
+export interface LiteLLMProxyRoutingSectionProps {
+    settings: Settings;
+}
+export declare function LiteLLMProxyRoutingSection({ settings }: LiteLLMProxyRoutingSectionProps): import("react/jsx-runtime").JSX.Element;
+//# sourceMappingURL=litellm-proxy-routing-section.d.ts.map

package/dist/src/presentation/web/components/features/settings/litellm-proxy-routing-section.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"litellm-proxy-routing-section.d.ts","sourceRoot":"","sources":["../../../../../../../src/presentation/web/components/features/settings/litellm-proxy-routing-section.tsx"],"names":[],"mappings":"AAOA,OAAO,KAAK,EAAE,QAAQ,EAAE,MAAM,yCAAyC,CAAC;AAaxE,MAAM,WAAW,+BAA+B;IAC9C,QAAQ,EAAE,QAAQ,CAAC;CACpB;AAyCD,wBAAgB,0BAA0B,CAAC,EAAE,QAAQ,EAAE,EAAE,+BAA+B,2CAmQvF"}

package/dist/src/presentation/web/components/features/settings/litellm-proxy-routing-section.js

@@ -0,0 +1,137 @@
+'use client';
+import { jsx as _jsx, jsxs as _jsxs, Fragment as _Fragment } from "react/jsx-runtime";
+import { useState, useTransition } from 'react';
+import { Route } from 'lucide-react';
+import { toast } from 'sonner';
+import { useTranslation } from 'react-i18next';
+import { updateSettingsAction } from '../../../app/actions/update-settings.js';
+import { LiteLLMProxyRoutingMode } from '../../../../../../packages/core/src/domain/generated/output.js';
+import { SettingsSection, SettingsRow } from './settings-section-utils.js';
+import { Input } from '../../ui/input.js';
+import { Textarea } from '../../ui/textarea.js';
+import { Select, SelectContent, SelectItem, SelectTrigger, SelectValue, } from '../../ui/select.js';
+/** Agent types that support env-var-based proxy routing (Tier 1) */
+const TIER1_AGENTS = new Set(['claude-code', 'gemini-cli', 'codex-cli']);
+/** Agent types that need documentation-only panels (Tier 2) */
+const TIER2_AGENTS = new Set(['cursor', 'copilot-cli']);
+/** Get the per-agent proxy config key for building payloads */
+function agentConfigKey(agentType) {
+    switch (agentType) {
+        case 'claude-code':
+            return 'claudeCode';
+        case 'gemini-cli':
+            return 'geminiCli';
+        case 'codex-cli':
+            return 'codexCli';
+        default:
+            return null;
+    }
+}
+/** Get the current routing mode for the active agent */
+function getRoutingMode(settings) {
+    const agentType = settings.agent.type;
+    switch (agentType) {
+        case 'claude-code':
+            return settings.litellmProxy?.claudeCode?.routingMode ?? LiteLLMProxyRoutingMode.direct;
+        case 'gemini-cli':
+            return settings.litellmProxy?.geminiCli?.routingMode ?? LiteLLMProxyRoutingMode.direct;
+        case 'codex-cli':
+            return settings.litellmProxy?.codexCli?.routingMode ?? LiteLLMProxyRoutingMode.direct;
+        default:
+            return LiteLLMProxyRoutingMode.direct;
+    }
+}
+/** Whether this agent supports passthrough mode */
+function supportsPassthrough(agentType) {
+    return agentType === 'claude-code';
+}
+export function LiteLLMProxyRoutingSection({ settings }) {
+    const { t } = useTranslation('web');
+    const [, startTransition] = useTransition();
+    const agentType = settings.agent.type;
+    const cc = settings.litellmProxy?.claudeCode;
+    const [routingMode, setRoutingMode] = useState(getRoutingMode(settings));
+    const [customHeaders, setCustomHeaders] = useState(cc?.customHeaders ?? '');
+    const [sonnetModel, setSonnetModel] = useState(cc?.sonnetModel ?? '');
+    const [haikuModel, setHaikuModel] = useState(cc?.haikuModel ?? '');
+    const [opusModel, setOpusModel] = useState(cc?.opusModel ?? '');
+    const originalCustomHeaders = cc?.customHeaders ?? '';
+    const originalSonnetModel = cc?.sonnetModel ?? '';
+    const originalHaikuModel = cc?.haikuModel ?? '';
+    const originalOpusModel = cc?.opusModel ?? '';
+    const showProxyFields = routingMode !== LiteLLMProxyRoutingMode.direct;
+    const isTier1 = TIER1_AGENTS.has(agentType);
+    const isTier2 = TIER2_AGENTS.has(agentType);
+    const proxyUrl = settings.litellmProxy?.baseUrl ?? '';
+    const proxyApiKey = settings.litellmProxy?.apiKey ?? '';
+    function save(payload) {
+        startTransition(async () => {
+            const result = await updateSettingsAction(payload);
+            if (!result.success) {
+                toast.error(result.error ?? t('settings.failedToSave'));
+            }
+        });
+    }
+    function buildPayload(overrides) {
+        const key = agentConfigKey(agentType);
+        if (!key)
+            return {};
+        if (agentType === 'claude-code') {
+            return {
+                litellmProxy: {
+                    claudeCode: {
+                        routingMode: overrides?.routingMode ?? routingMode,
+                        customHeaders: overrides?.customHeaders ?? customHeaders,
+                        sonnetModel: overrides?.sonnetModel ?? sonnetModel,
+                        haikuModel: overrides?.haikuModel ?? haikuModel,
+                        opusModel: overrides?.opusModel ?? opusModel,
+                    },
+                },
+            };
+        }
+        // Gemini CLI and Codex CLI: only routingMode
+        return {
+            litellmProxy: {
+                [key]: {
+                    routingMode: overrides?.routingMode ?? routingMode,
+                },
+            },
+        };
+    }
+    function handleModeChange(value) {
+        setRoutingMode(value);
+        save(buildPayload({ routingMode: value }));
+    }
+    // Unsupported agent type
+    if (!isTier1 && !isTier2) {
+        return (_jsx(SettingsSection, { icon: Route, title: t('settings.litellmProxy.routing.title'), description: t('settings.litellmProxy.routing.description'), testId: "litellm-proxy-routing-section", tooltip: t('settings.litellmProxy.routing.hint'), children: _jsx(SettingsRow, { label: "", description: t('settings.litellmProxy.routing.notSupported'), children: _jsx("span", {}) }) }));
+    }
+    // Tier 2: Documentation-only panels
+    if (isTier2) {
+        const isCursor = agentType === 'cursor';
+        const displayUrl = isCursor ? `${proxyUrl.replace(/\/+$/, '')}/cursor` : proxyUrl;
+        return (_jsx(SettingsSection, { icon: Route, title: t('settings.litellmProxy.routing.title'), description: t('settings.litellmProxy.routing.description'), testId: "litellm-proxy-routing-section", tooltip: t('settings.litellmProxy.routing.hint'), children: _jsx(SettingsRow, { label: isCursor
+                    ? t('settings.litellmProxy.routing.cursorInstructions')
+                    : t('settings.litellmProxy.routing.copilotInstructions'), description: isCursor
+                    ? t('settings.litellmProxy.routing.cursorDescription')
+                    : t('settings.litellmProxy.routing.copilotDescription'), children: _jsxs("div", { className: "w-64 space-y-2", children: [_jsx("code", { className: "bg-muted block rounded px-2 py-1 text-xs break-all", children: displayUrl }), isCursor && proxyApiKey ? (_jsx("code", { className: "bg-muted block rounded px-2 py-1 text-xs break-all", children: proxyApiKey })) : null] }) }) }));
+    }
+    // Tier 1: Env-var-based proxy routing (Claude Code, Gemini CLI, Codex CLI)
+    return (_jsxs(SettingsSection, { icon: Route, title: t('settings.litellmProxy.routing.title'), description: t('settings.litellmProxy.routing.description'), testId: "litellm-proxy-routing-section", tooltip: t('settings.litellmProxy.routing.hint'), children: [_jsx(SettingsRow, { label: t('settings.litellmProxy.routing.mode'), description: t('settings.litellmProxy.routing.modeDescription'), htmlFor: "litellm-routing-mode", children: _jsxs(Select, { value: routingMode, onValueChange: handleModeChange, children: [_jsx(SelectTrigger, { id: "litellm-routing-mode", "data-testid": "litellm-routing-mode-select", className: "w-48 text-xs", children: _jsx(SelectValue, {}) }), _jsxs(SelectContent, { children: [_jsx(SelectItem, { value: LiteLLMProxyRoutingMode.direct, children: t('settings.litellmProxy.routing.modeDirect') }), _jsx(SelectItem, { value: LiteLLMProxyRoutingMode.proxy, children: t('settings.litellmProxy.routing.modeProxy') }), supportsPassthrough(agentType) && (_jsx(SelectItem, { value: LiteLLMProxyRoutingMode.passthrough, children: t('settings.litellmProxy.routing.modePassthrough') }))] })] }) }), routingMode === LiteLLMProxyRoutingMode.passthrough && (_jsx(SettingsRow, { label: "", description: t('settings.litellmProxy.routing.passthroughHelp'), children: _jsx("span", {}) })), showProxyFields && agentType === 'claude-code' ? (_jsxs(_Fragment, { children: [_jsx(SettingsRow, { label: t('settings.litellmProxy.routing.customHeaders'), description: t('settings.litellmProxy.routing.customHeadersDescription'), htmlFor: "litellm-custom-headers", children: _jsx(Textarea, { id: "litellm-custom-headers", "data-testid": "litellm-custom-headers-input", placeholder: 'x-litellm-customer-id: my-user\nx-litellm-tags: project:acme', value: customHeaders, onChange: (e) => setCustomHeaders(e.target.value), onBlur: () => {
+                                if (customHeaders !== originalCustomHeaders) {
+                                    save(buildPayload({ customHeaders }));
+                                }
+                            }, rows: 3, className: "w-64 text-xs" }) }), _jsx(SettingsRow, { label: t('settings.litellmProxy.routing.sonnetModel'), description: t('settings.litellmProxy.routing.modelOverrideDescription'), htmlFor: "litellm-sonnet-model", children: _jsx(Input, { id: "litellm-sonnet-model", "data-testid": "litellm-sonnet-model-input", type: "text", placeholder: "claude-sonnet-4-6", value: sonnetModel, onChange: (e) => setSonnetModel(e.target.value), onBlur: () => {
+                                if (sonnetModel !== originalSonnetModel) {
+                                    save(buildPayload({ sonnetModel }));
+                                }
+                            }, className: "w-64 text-xs" }) }), _jsx(SettingsRow, { label: t('settings.litellmProxy.routing.haikuModel'), htmlFor: "litellm-haiku-model", children: _jsx(Input, { id: "litellm-haiku-model", "data-testid": "litellm-haiku-model-input", type: "text", placeholder: "claude-haiku-4-5", value: haikuModel, onChange: (e) => setHaikuModel(e.target.value), onBlur: () => {
+                                if (haikuModel !== originalHaikuModel) {
+                                    save(buildPayload({ haikuModel }));
+                                }
+                            }, className: "w-64 text-xs" }) }), _jsx(SettingsRow, { label: t('settings.litellmProxy.routing.opusModel'), htmlFor: "litellm-opus-model", children: _jsx(Input, { id: "litellm-opus-model", "data-testid": "litellm-opus-model-input", type: "text", placeholder: "claude-opus-4-6", value: opusModel, onChange: (e) => setOpusModel(e.target.value), onBlur: () => {
+                                if (opusModel !== originalOpusModel) {
+                                    save(buildPayload({ opusModel }));
+                                }
+                            }, className: "w-64 text-xs" }) })] })) : null] }));
+}

package/dist/src/presentation/web/components/features/settings/litellm-proxy-routing-section.stories.d.ts

@@ -0,0 +1,23 @@
+import type { StoryObj } from '@storybook/react-vite';
+import { LiteLLMProxyRoutingSection } from './litellm-proxy-routing-section.js';
+declare const meta: {
+    title: string;
+    component: typeof LiteLLMProxyRoutingSection;
+    tags: string[];
+    parameters: {
+        layout: string;
+    };
+};
+export default meta;
+type Story = StoryObj<typeof meta>;
+export declare const ClaudeCodeDirect: Story;
+export declare const ClaudeCodeProxy: Story;
+export declare const ClaudeCodePassthrough: Story;
+export declare const GeminiCliDirect: Story;
+export declare const GeminiCliProxy: Story;
+export declare const CodexCliDirect: Story;
+export declare const CodexCliProxy: Story;
+export declare const CursorDocs: Story;
+export declare const CopilotDocs: Story;
+export declare const UnsupportedAgent: Story;
+//# sourceMappingURL=litellm-proxy-routing-section.stories.d.ts.map

package/dist/src/presentation/web/components/features/settings/litellm-proxy-routing-section.stories.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"litellm-proxy-routing-section.stories.d.ts","sourceRoot":"","sources":["../../../../../../../src/presentation/web/components/features/settings/litellm-proxy-routing-section.stories.tsx"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAQ,QAAQ,EAAE,MAAM,uBAAuB,CAAC;AAC5D,OAAO,EAAE,0BAA0B,EAAE,MAAM,iCAAiC,CAAC;AAa7E,QAAA,MAAM,IAAI;;;;;;;CAOyC,CAAC;AAEpD,eAAe,IAAI,CAAC;AACpB,KAAK,KAAK,GAAG,QAAQ,CAAC,OAAO,IAAI,CAAC,CAAC;AAInC,eAAO,MAAM,gBAAgB,EAAE,KAW9B,CAAC;AAEF,eAAO,MAAM,eAAe,EAAE,KAe7B,CAAC;AAEF,eAAO,MAAM,qBAAqB,EAAE,KAWnC,CAAC;AAIF,eAAO,MAAM,eAAe,EAAE,KAW7B,CAAC;AAEF,eAAO,MAAM,cAAc,EAAE,KAW5B,CAAC;AAIF,eAAO,MAAM,cAAc,EAAE,KAW5B,CAAC;AAEF,eAAO,MAAM,aAAa,EAAE,KAW3B,CAAC;AAIF,eAAO,MAAM,UAAU,EAAE,KAOxB,CAAC;AAIF,eAAO,MAAM,WAAW,EAAE,KAOzB,CAAC;AAIF,eAAO,MAAM,gBAAgB,EAAE,KAO9B,CAAC"}