@hasna/switcher 0.1.1 → 0.1.3

package/dist/gemini-model-policy.d.ts

@@ -0,0 +1,56 @@
+import { type Model } from "./domain";
+import type { CompiledModelPolicy } from "./model-policy";
+/** The settings fragment understood by Gemini CLI 0.58.0. */
+export type GeminiModelPolicyFragment = {
+    modelConfigs: {
+        customOverrides: Array<{
+            match: {
+                model: string;
+            };
+            modelConfig: {
+                model: string;
+            };
+        }>;
+        modelChains: Record<string, Array<{
+            model: string;
+            isLastResort: true;
+        }>>;
+        modelDefinitions: Record<string, {
+            displayName: string;
+            tier: "custom";
+            family: "switcher";
+            isPreview: false;
+            isVisible: true;
+            features: {
+                thinking: false;
+                multimodalToolUse: boolean;
+            };
+        }>;
+        modelIdResolutions: Record<string, {
+            default: string;
+            contexts: [];
+        }>;
+        classifierIdResolutions: Record<string, {
+            default: string;
+            contexts: [];
+        }>;
+    };
+    agents?: {
+        overrides: {
+            codebase_investigator: {
+                modelConfig: {
+                    model: string;
+                };
+            };
+        };
+    };
+};
+/**
+ * Compile the portable Switcher policy into native Gemini 0.58.0 settings.
+ *
+ * Gemini's stable native route controls are modelConfigs.modelIdResolutions
+ * and agents.overrides.<agent>.modelConfig.model. Its modelConfigs.modelChains
+ * field receives terminal selected-model chains; the gateway owns explicit
+ * ordered fallback and retry semantics.
+ */
+export declare function compileGeminiModelPolicy(selectedModel: string, models: readonly Model[], compiled: CompiledModelPolicy): GeminiModelPolicyFragment;

package/dist/generated/api.d.ts

@@ -250,15 +250,15 @@ export interface components {
             credentialAliases: string[];
             protocols: {
                 /** @enum {string} */
-                protocol: "anthropic-messages" | "openai-responses" | "openai-chat";
+                protocol: "anthropic-messages" | "openai-responses" | "openai-chat" | "gemini-generate-content";
                 baseUrl?: string;
                 /** @enum {string} */
-                authStyle: "bearer" | "x-api-key";
+                authStyle: "bearer" | "x-api-key" | "api-key";
                 catalogBaseUrl?: string;
                 /** @enum {string} */
-                catalogFormat: "openai" | "ollama" | "mistral" | "together" | "fireworks" | "dashscope" | "none";
+                catalogFormat: "openai" | "ollama" | "mistral" | "together" | "fireworks" | "dashscope" | "gemini" | "none";
                 /** @enum {string} */
-                catalogAuthStyle?: "bearer" | "x-api-key" | "none";
+                catalogAuthStyle?: "bearer" | "x-api-key" | "api-key" | "none";
                 modelsPath: string;
                 notes: string[];
             }[];
@@ -271,18 +271,18 @@ export interface components {
             name: string;
             baseUrl: string;
             /** @enum {string} */
-            protocol: "anthropic-messages" | "openai-responses" | "openai-chat";
+            protocol: "anthropic-messages" | "openai-responses" | "openai-chat" | "gemini-generate-content";
             credentialEnv?: string;
             /**
              * @default bearer
              * @enum {string}
              */
-            authStyle: "bearer" | "x-api-key";
+            authStyle: "bearer" | "x-api-key" | "api-key";
             catalogBaseUrl?: string;
             /** @enum {string} */
-            catalogFormat?: "openai" | "ollama" | "mistral" | "together" | "fireworks" | "dashscope" | "none";
+            catalogFormat?: "openai" | "ollama" | "mistral" | "together" | "fireworks" | "dashscope" | "gemini" | "none";
             /** @enum {string} */
-            catalogAuthStyle?: "bearer" | "x-api-key" | "none";
+            catalogAuthStyle?: "bearer" | "x-api-key" | "api-key" | "none";
             catalogCredentialEnv?: string;
             catalogAccountId?: string;
             /** @default models */
@@ -298,6 +298,7 @@ export interface components {
                 inputModalities?: string[];
                 outputModalities?: string[];
                 supportedParameters?: string[];
+                supportedGenerationMethods?: string[];
             }[];
         };
         Provider: {
@@ -305,18 +306,18 @@ export interface components {
             name: string;
             baseUrl: string;
             /** @enum {string} */
-            protocol: "anthropic-messages" | "openai-responses" | "openai-chat";
+            protocol: "anthropic-messages" | "openai-responses" | "openai-chat" | "gemini-generate-content";
             credentialEnv?: string;
             /**
              * @default bearer
              * @enum {string}
              */
-            authStyle: "bearer" | "x-api-key";
+            authStyle: "bearer" | "x-api-key" | "api-key";
             catalogBaseUrl?: string;
             /** @enum {string} */
-            catalogFormat?: "openai" | "ollama" | "mistral" | "together" | "fireworks" | "dashscope" | "none";
+            catalogFormat?: "openai" | "ollama" | "mistral" | "together" | "fireworks" | "dashscope" | "gemini" | "none";
             /** @enum {string} */
-            catalogAuthStyle?: "bearer" | "x-api-key" | "none";
+            catalogAuthStyle?: "bearer" | "x-api-key" | "api-key" | "none";
             catalogCredentialEnv?: string;
             catalogAccountId?: string;
             /** @default models */
@@ -332,6 +333,7 @@ export interface components {
                 inputModalities?: string[];
                 outputModalities?: string[];
                 supportedParameters?: string[];
+                supportedGenerationMethods?: string[];
             }[];
             version: number;
             updatedAt: string;
@@ -341,16 +343,64 @@ export interface components {
             name: string;
             providerId: string;
             /** @enum {string} */
-            harness: "claude" | "codex" | "grok" | "opencode2" | "pi";
+            harness: "claude" | "codex" | "grok" | "opencode" | "opencode2" | "pi" | "omp" | "dsh" | "cline" | "hermes" | "prime-agent" | "gemini" | "aider" | "kilo";
             model: string;
+            modelPolicy?: {
+                /**
+                 * @default 1
+                 * @enum {number}
+                 */
+                version: 1;
+                roles?: {
+                    subagent?: string;
+                    fast?: string;
+                    planning?: string;
+                    review?: string;
+                    summary?: string;
+                    compaction?: string;
+                    weak?: string;
+                    editor?: string;
+                };
+                allowedModels?: string[];
+                aliases?: {
+                    [key: string]: string;
+                };
+                fallbacks?: {
+                    [key: string]: string[];
+                };
+            };
         };
         Profile: {
             id: string;
             name: string;
             providerId: string;
             /** @enum {string} */
-            harness: "claude" | "codex" | "grok" | "opencode2" | "pi";
+            harness: "claude" | "codex" | "grok" | "opencode" | "opencode2" | "pi" | "omp" | "dsh" | "cline" | "hermes" | "prime-agent" | "gemini" | "aider" | "kilo";
             model: string;
+            modelPolicy?: {
+                /**
+                 * @default 1
+                 * @enum {number}
+                 */
+                version: 1;
+                roles?: {
+                    subagent?: string;
+                    fast?: string;
+                    planning?: string;
+                    review?: string;
+                    summary?: string;
+                    compaction?: string;
+                    weak?: string;
+                    editor?: string;
+                };
+                allowedModels?: string[];
+                aliases?: {
+                    [key: string]: string;
+                };
+                fallbacks?: {
+                    [key: string]: string[];
+                };
+            };
             version: number;
             updatedAt: string;
         };
@@ -364,6 +414,45 @@ export interface components {
             inputModalities?: string[];
             outputModalities?: string[];
             supportedParameters?: string[];
+            supportedGenerationMethods?: string[];
+        };
+        ModelPolicy: {
+            /**
+             * @default 1
+             * @enum {number}
+             */
+            version: 1;
+            roles?: {
+                subagent?: string;
+                fast?: string;
+                planning?: string;
+                review?: string;
+                summary?: string;
+                compaction?: string;
+                weak?: string;
+                editor?: string;
+            };
+            allowedModels?: string[];
+            aliases?: {
+                [key: string]: string;
+            };
+            fallbacks?: {
+                [key: string]: string[];
+            };
+        };
+        RoutingEvent: {
+            /** Format: date-time */
+            at: string;
+            requestId: string;
+            requestedModel: string;
+            resolvedModel?: string;
+            reportedModel?: string;
+            /** @enum {string} */
+            decision: "allow" | "alias" | "reject" | "fallback";
+            /** @enum {string} */
+            role?: "main" | "subagent" | "fast" | "planning" | "review" | "summary" | "compaction" | "weak" | "editor";
+            reason?: string;
+            upstreamStatus?: number;
         };
         ModelPage: {
             data: {
@@ -376,6 +465,7 @@ export interface components {
                 inputModalities?: string[];
                 outputModalities?: string[];
                 supportedParameters?: string[];
+                supportedGenerationMethods?: string[];
                 codingEligible: boolean;
             }[];
             total: number;
@@ -396,6 +486,7 @@ export interface components {
                 inputModalities?: string[];
                 outputModalities?: string[];
                 supportedParameters?: string[];
+                supportedGenerationMethods?: string[];
             }[];
             refreshedAt: string;
             /** @enum {string} */
@@ -407,18 +498,18 @@ export interface components {
                 name: string;
                 baseUrl: string;
                 /** @enum {string} */
-                protocol: "anthropic-messages" | "openai-responses" | "openai-chat";
+                protocol: "anthropic-messages" | "openai-responses" | "openai-chat" | "gemini-generate-content";
                 credentialEnv?: string;
                 /**
                  * @default bearer
                  * @enum {string}
                  */
-                authStyle: "bearer" | "x-api-key";
+                authStyle: "bearer" | "x-api-key" | "api-key";
                 catalogBaseUrl?: string;
                 /** @enum {string} */
-                catalogFormat?: "openai" | "ollama" | "mistral" | "together" | "fireworks" | "dashscope" | "none";
+                catalogFormat?: "openai" | "ollama" | "mistral" | "together" | "fireworks" | "dashscope" | "gemini" | "none";
                 /** @enum {string} */
-                catalogAuthStyle?: "bearer" | "x-api-key" | "none";
+                catalogAuthStyle?: "bearer" | "x-api-key" | "api-key" | "none";
                 catalogCredentialEnv?: string;
                 catalogAccountId?: string;
                 /** @default models */
@@ -434,6 +525,7 @@ export interface components {
                     inputModalities?: string[];
                     outputModalities?: string[];
                     supportedParameters?: string[];
+                    supportedGenerationMethods?: string[];
                 }[];
                 version: number;
                 updatedAt: string;
@@ -443,8 +535,32 @@ export interface components {
                 name: string;
                 providerId: string;
                 /** @enum {string} */
-                harness: "claude" | "codex" | "grok" | "opencode2" | "pi";
+                harness: "claude" | "codex" | "grok" | "opencode" | "opencode2" | "pi" | "omp" | "dsh" | "cline" | "hermes" | "prime-agent" | "gemini" | "aider" | "kilo";
                 model: string;
+                modelPolicy?: {
+                    /**
+                     * @default 1
+                     * @enum {number}
+                     */
+                    version: 1;
+                    roles?: {
+                        subagent?: string;
+                        fast?: string;
+                        planning?: string;
+                        review?: string;
+                        summary?: string;
+                        compaction?: string;
+                        weak?: string;
+                        editor?: string;
+                    };
+                    allowedModels?: string[];
+                    aliases?: {
+                        [key: string]: string;
+                    };
+                    fallbacks?: {
+                        [key: string]: string[];
+                    };
+                };
                 version: number;
                 updatedAt: string;
             };
@@ -459,6 +575,7 @@ export interface components {
                     inputModalities?: string[];
                     outputModalities?: string[];
                     supportedParameters?: string[];
+                    supportedGenerationMethods?: string[];
                 }[];
                 refreshedAt: string;
                 /** @enum {string} */
@@ -468,22 +585,89 @@ export interface components {
             warnings: string[];
         };
         RunInput: {
+            /** @enum {number} */
+            modelPolicyVersion: 1;
             profileId: string;
             /** @enum {string} */
-            harness: "claude" | "codex" | "grok" | "opencode2" | "pi";
+            harness: "claude" | "codex" | "grok" | "opencode" | "opencode2" | "pi" | "omp" | "dsh" | "cline" | "hermes" | "prime-agent" | "gemini" | "aider" | "kilo";
             model: string;
+            modelPolicy?: {
+                /**
+                 * @default 1
+                 * @enum {number}
+                 */
+                version: 1;
+                roles?: {
+                    subagent?: string;
+                    fast?: string;
+                    planning?: string;
+                    review?: string;
+                    summary?: string;
+                    compaction?: string;
+                    weak?: string;
+                    editor?: string;
+                };
+                allowedModels?: string[];
+                aliases?: {
+                    [key: string]: string;
+                };
+                fallbacks?: {
+                    [key: string]: string[];
+                };
+            };
             planToken: string;
         };
         RunUpdate: {
             /** @enum {string} */
             status: "exited" | "failed" | "interrupted";
             exitCode: number;
+            routingEvents?: {
+                /** Format: date-time */
+                at: string;
+                requestId: string;
+                requestedModel: string;
+                resolvedModel?: string;
+                reportedModel?: string;
+                /** @enum {string} */
+                decision: "allow" | "alias" | "reject" | "fallback";
+                /** @enum {string} */
+                role?: "main" | "subagent" | "fast" | "planning" | "review" | "summary" | "compaction" | "weak" | "editor";
+                reason?: string;
+                upstreamStatus?: number;
+            }[];
+            routingEventsDropped?: number;
         };
         Run: {
+            /** @enum {number} */
+            modelPolicyVersion?: 1;
             profileId: string;
             /** @enum {string} */
-            harness: "claude" | "codex" | "grok" | "opencode2" | "pi";
+            harness: "claude" | "codex" | "grok" | "opencode" | "opencode2" | "pi" | "omp" | "dsh" | "cline" | "hermes" | "prime-agent" | "gemini" | "aider" | "kilo";
             model: string;
+            modelPolicy?: {
+                /**
+                 * @default 1
+                 * @enum {number}
+                 */
+                version: 1;
+                roles?: {
+                    subagent?: string;
+                    fast?: string;
+                    planning?: string;
+                    review?: string;
+                    summary?: string;
+                    compaction?: string;
+                    weak?: string;
+                    editor?: string;
+                };
+                allowedModels?: string[];
+                aliases?: {
+                    [key: string]: string;
+                };
+                fallbacks?: {
+                    [key: string]: string[];
+                };
+            };
             planToken: string;
             version: number;
             updatedAt: string;
@@ -496,6 +680,21 @@ export interface components {
             startedAt: string;
             endedAt?: string;
             exitCode?: number;
+            routingEvents?: {
+                /** Format: date-time */
+                at: string;
+                requestId: string;
+                requestedModel: string;
+                resolvedModel?: string;
+                reportedModel?: string;
+                /** @enum {string} */
+                decision: "allow" | "alias" | "reject" | "fallback";
+                /** @enum {string} */
+                role?: "main" | "subagent" | "fast" | "planning" | "review" | "summary" | "compaction" | "weak" | "editor";
+                reason?: string;
+                upstreamStatus?: number;
+            }[];
+            routingEventsDropped?: number;
         };
         Health: {
             /** @enum {string} */

package/dist/harness-arguments.d.ts

@@ -1,4 +1,5 @@
 import type { HarnessId } from "./harness-types";
+export declare function geminiPolicyArguments(input: readonly string[], originalHome: string): string[];
 export declare function assertHarnessArguments(harness: HarnessId, args: readonly string[], options?: {
     additionalReserved?: readonly string[];
     reserveCodexConfig?: boolean;

package/dist/harness-installation.d.ts

@@ -0,0 +1,19 @@
+import type { HarnessId } from "./harness-types";
+/**
+ * Native installation facts used by doctor and missing-executable errors.
+ *
+ * These records deliberately distinguish a verified package from a project
+ * distribution.  A project entry has no guessed npm command: the operator is
+ * sent to the upstream installation instructions and can pass the resulting
+ * executable with --executable.
+ */
+export type HarnessInstallation = {
+    displayName: string;
+    executable: string;
+    versionRequirement: string;
+    packageOrProject: string;
+    documentationUrl: string;
+    installationGuidance: string;
+};
+export declare function harnessInstallation(harness: HarnessId): HarnessInstallation;
+export declare function harnessInstallationMessage(harness: HarnessId, executable: string, explicitOverride: boolean): string;

package/dist/harness-types.d.ts

@@ -1,4 +1,7 @@
 import type { Model, Provider, Profile } from "./domain";
+import type { CompiledModelPolicy, ModelPolicy } from "./model-policy";
+import type { NativeModelPolicy } from "./native-model-policy";
+import type { RoutingEvent } from "./inference-gateway";
 export type HarnessId = Profile["harness"];
 export type HarnessLaunchInput = {
     harness: HarnessId;
@@ -14,6 +17,12 @@ export type HarnessLaunchInput = {
     cwd: string;
     version?: string;
     sessionDir?: string;
+    providerId?: string;
+    providerBaseUrl?: string;
+    modelPolicy?: ModelPolicy;
+    compiledPolicy?: CompiledModelPolicy;
+    nativePolicy?: NativeModelPolicy;
+    onRoutingEvent?: (event: RoutingEvent) => void;
 };
 export type PreparedLaunch = {
     executable: string;
@@ -21,5 +30,6 @@ export type PreparedLaunch = {
     env: Record<string, string>;
     configPaths: string[];
     warnings: string[];
+    beforeLaunch?: () => Promise<void>;
     cleanup?: () => Promise<void>;
 };

package/dist/harnesses.d.ts

@@ -1,15 +1,18 @@
 import type { HarnessId, HarnessLaunchInput, PreparedLaunch } from "./harness-types";
 export declare function detectHarness(harness: HarnessId, override?: string): Promise<{
-    harness: "claude" | "codex" | "grok" | "opencode2" | "pi";
+    harness: "gemini" | "claude" | "codex" | "grok" | "opencode" | "opencode2" | "pi" | "omp" | "dsh" | "cline" | "hermes" | "prime-agent" | "aider" | "kilo";
     executable: string;
     available: boolean;
     version: string;
+    installation: import("./harness-installation").HarnessInstallation;
 } | {
-    harness: "claude" | "codex" | "grok" | "opencode2" | "pi";
+    harness: "gemini" | "claude" | "codex" | "grok" | "opencode" | "opencode2" | "pi" | "omp" | "dsh" | "cline" | "hermes" | "prime-agent" | "aider" | "kilo";
     executable: string;
     available: boolean;
     version: undefined;
+    installation: import("./harness-installation").HarnessInstallation;
 }>;
+export declare function validateHarnessConfiguration(harness: HarnessId, cwd: string, args?: readonly string[]): Promise<void>;
 export declare function validateHarnessVersion(harness: HarnessId, version: string | undefined): void;
 export declare function codexModel(model: HarnessLaunchInput["models"][number], priority: number): {
     slug: string;

package/dist/hermes-backend.d.ts

@@ -0,0 +1,19 @@
+import type { HarnessLaunchInput, PreparedLaunch } from "./harness-types";
+/** Hermes' native runtime names for the three Switcher wire contracts. */
+export declare const hermesApiMode: {
+    readonly "anthropic-messages": "anthropic_messages";
+    readonly "openai-responses": "codex_responses";
+    readonly "openai-chat": "chat_completions";
+};
+/**
+ * Keep Hermes' picker and inference route on the exact Switcher catalog.
+ * Hermes' custom provider client uses Bearer locally; this bridge translates
+ * that local credential into the provider's declared upstream header style.
+ */
+export declare function createHermesBridge(input: Pick<HarnessLaunchInput, "baseUrl" | "protocol" | "authStyle" | "model" | "models" | "credential">): {
+    baseUrl: string;
+    token: string;
+    cleanup: () => Promise<void>;
+};
+/** Prepare a Hermes run with isolated config, catalog and durable session state. */
+export declare function prepareHermesLaunch(input: HarnessLaunchInput): Promise<PreparedLaunch>;

package/dist/hermes-model-policy.d.ts

@@ -0,0 +1,30 @@
+export type HermesModelRoles = {
+    subagent?: string;
+    fast?: string;
+    planning?: string;
+    review?: string;
+    summary?: string;
+    compaction?: string;
+    weak?: string;
+    editor?: string;
+};
+export type HermesModelPolicyFragment = {
+    auxiliary: Record<string, {
+        api_mode: string;
+        provider: "custom";
+        model: string;
+        base_url: string;
+        api_key_env: "SWITCHER_HERMES_AUX_API_KEY";
+        fallback_chain: [];
+    }>;
+    delegation: {
+        model: string;
+        provider: "custom";
+        base_url: string;
+    };
+    env: {
+        apiKeyEnv: "SWITCHER_HERMES_AUX_API_KEY";
+    };
+};
+/** Compile verified Hermes auxiliary config fields without serializing credentials. */
+export declare function compileHermesModelPolicy(currentModel: string, roles: HermesModelRoles, baseUrl: string, apiMode?: string): HermesModelPolicyFragment;