@hasna/switcher 0.1.0 → 0.1.2

package/dist/generated/api.d.ts

@@ -63,6 +63,38 @@ export interface paths {
         patch?: never;
         trace?: never;
     };
+    "/v1/provider-presets": {
+        parameters: {
+            query?: never;
+            header?: never;
+            path?: never;
+            cookie?: never;
+        };
+        get: operations["listProviderPresets"];
+        put?: never;
+        post?: never;
+        delete?: never;
+        options?: never;
+        head?: never;
+        patch?: never;
+        trace?: never;
+    };
+    "/v1/provider-presets/{id}": {
+        parameters: {
+            query?: never;
+            header?: never;
+            path?: never;
+            cookie?: never;
+        };
+        get: operations["getProviderPreset"];
+        put?: never;
+        post?: never;
+        delete?: never;
+        options?: never;
+        head?: never;
+        patch?: never;
+        trace?: never;
+    };
     "/v1/providers/{id}/models": {
         parameters: {
             query?: never;
@@ -211,18 +243,48 @@ export interface paths {
 export type webhooks = Record<string, never>;
 export interface components {
     schemas: {
+        ProviderPreset: {
+            id: string;
+            name: string;
+            credentialEnv?: string;
+            credentialAliases: string[];
+            protocols: {
+                /** @enum {string} */
+                protocol: "anthropic-messages" | "openai-responses" | "openai-chat" | "gemini-generate-content";
+                baseUrl?: string;
+                /** @enum {string} */
+                authStyle: "bearer" | "x-api-key" | "api-key";
+                catalogBaseUrl?: string;
+                /** @enum {string} */
+                catalogFormat: "openai" | "ollama" | "mistral" | "together" | "fireworks" | "dashscope" | "gemini" | "none";
+                /** @enum {string} */
+                catalogAuthStyle?: "bearer" | "x-api-key" | "api-key" | "none";
+                modelsPath: string;
+                notes: string[];
+            }[];
+            sources: string[];
+            /** @enum {string} */
+            verification: "documented";
+        };
         ProviderInput: {
             id: string;
             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" | "gemini" | "none";
+            /** @enum {string} */
+            catalogAuthStyle?: "bearer" | "x-api-key" | "api-key" | "none";
+            catalogCredentialEnv?: string;
+            catalogAccountId?: string;
             /** @default models */
             modelsPath: string;
             /** @default [] */
@@ -230,11 +292,13 @@ export interface components {
                 id: string;
                 name: string;
                 description?: string;
+                available?: boolean;
                 contextWindow?: number;
                 maxOutputTokens?: number;
                 inputModalities?: string[];
                 outputModalities?: string[];
                 supportedParameters?: string[];
+                supportedGenerationMethods?: string[];
             }[];
         };
         Provider: {
@@ -242,13 +306,20 @@ 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" | "gemini" | "none";
+            /** @enum {string} */
+            catalogAuthStyle?: "bearer" | "x-api-key" | "api-key" | "none";
+            catalogCredentialEnv?: string;
+            catalogAccountId?: string;
             /** @default models */
             modelsPath: string;
             /** @default [] */
@@ -256,11 +327,13 @@ export interface components {
                 id: string;
                 name: string;
                 description?: string;
+                available?: boolean;
                 contextWindow?: number;
                 maxOutputTokens?: number;
                 inputModalities?: string[];
                 outputModalities?: string[];
                 supportedParameters?: string[];
+                supportedGenerationMethods?: string[];
             }[];
             version: number;
             updatedAt: string;
@@ -270,7 +343,7 @@ export interface components {
             name: string;
             providerId: string;
             /** @enum {string} */
-            harness: "claude" | "codex" | "grok" | "opencode2";
+            harness: "claude" | "codex" | "grok" | "opencode" | "opencode2" | "pi" | "omp" | "dsh" | "cline" | "hermes" | "prime-agent" | "gemini" | "aider" | "kilo";
             model: string;
         };
         Profile: {
@@ -278,7 +351,7 @@ export interface components {
             name: string;
             providerId: string;
             /** @enum {string} */
-            harness: "claude" | "codex" | "grok" | "opencode2";
+            harness: "claude" | "codex" | "grok" | "opencode" | "opencode2" | "pi" | "omp" | "dsh" | "cline" | "hermes" | "prime-agent" | "gemini" | "aider" | "kilo";
             model: string;
             version: number;
             updatedAt: string;
@@ -287,22 +360,26 @@ export interface components {
             id: string;
             name: string;
             description?: string;
+            available?: boolean;
             contextWindow?: number;
             maxOutputTokens?: number;
             inputModalities?: string[];
             outputModalities?: string[];
             supportedParameters?: string[];
+            supportedGenerationMethods?: string[];
         };
         ModelPage: {
             data: {
                 id: string;
                 name: string;
                 description?: string;
+                available?: boolean;
                 contextWindow?: number;
                 maxOutputTokens?: number;
                 inputModalities?: string[];
                 outputModalities?: string[];
                 supportedParameters?: string[];
+                supportedGenerationMethods?: string[];
                 codingEligible: boolean;
             }[];
             total: number;
@@ -317,11 +394,13 @@ export interface components {
                 id: string;
                 name: string;
                 description?: string;
+                available?: boolean;
                 contextWindow?: number;
                 maxOutputTokens?: number;
                 inputModalities?: string[];
                 outputModalities?: string[];
                 supportedParameters?: string[];
+                supportedGenerationMethods?: string[];
             }[];
             refreshedAt: string;
             /** @enum {string} */
@@ -333,13 +412,20 @@ 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" | "gemini" | "none";
+                /** @enum {string} */
+                catalogAuthStyle?: "bearer" | "x-api-key" | "api-key" | "none";
+                catalogCredentialEnv?: string;
+                catalogAccountId?: string;
                 /** @default models */
                 modelsPath: string;
                 /** @default [] */
@@ -347,11 +433,13 @@ export interface components {
                     id: string;
                     name: string;
                     description?: string;
+                    available?: boolean;
                     contextWindow?: number;
                     maxOutputTokens?: number;
                     inputModalities?: string[];
                     outputModalities?: string[];
                     supportedParameters?: string[];
+                    supportedGenerationMethods?: string[];
                 }[];
                 version: number;
                 updatedAt: string;
@@ -361,7 +449,7 @@ export interface components {
                 name: string;
                 providerId: string;
                 /** @enum {string} */
-                harness: "claude" | "codex" | "grok" | "opencode2";
+                harness: "claude" | "codex" | "grok" | "opencode" | "opencode2" | "pi" | "omp" | "dsh" | "cline" | "hermes" | "prime-agent" | "gemini" | "aider" | "kilo";
                 model: string;
                 version: number;
                 updatedAt: string;
@@ -371,11 +459,13 @@ export interface components {
                     id: string;
                     name: string;
                     description?: string;
+                    available?: boolean;
                     contextWindow?: number;
                     maxOutputTokens?: number;
                     inputModalities?: string[];
                     outputModalities?: string[];
                     supportedParameters?: string[];
+                    supportedGenerationMethods?: string[];
                 }[];
                 refreshedAt: string;
                 /** @enum {string} */
@@ -387,7 +477,7 @@ export interface components {
         RunInput: {
             profileId: string;
             /** @enum {string} */
-            harness: "claude" | "codex" | "grok" | "opencode2";
+            harness: "claude" | "codex" | "grok" | "opencode" | "opencode2" | "pi" | "omp" | "dsh" | "cline" | "hermes" | "prime-agent" | "gemini" | "aider" | "kilo";
             model: string;
             planToken: string;
         };
@@ -399,7 +489,7 @@ export interface components {
         Run: {
             profileId: string;
             /** @enum {string} */
-            harness: "claude" | "codex" | "grok" | "opencode2";
+            harness: "claude" | "codex" | "grok" | "opencode" | "opencode2" | "pi" | "omp" | "dsh" | "cline" | "hermes" | "prime-agent" | "gemini" | "aider" | "kilo";
             model: string;
             planToken: string;
             version: number;
@@ -804,6 +894,68 @@ export interface operations {
             };
         };
     };
+    listProviderPresets: {
+        parameters: {
+            query?: never;
+            header?: never;
+            path?: never;
+            cookie?: never;
+        };
+        requestBody?: never;
+        responses: {
+            /** @description Success */
+            200: {
+                headers: {
+                    [name: string]: unknown;
+                };
+                content: {
+                    "application/json": {
+                        data: components["schemas"]["ProviderPreset"][];
+                    };
+                };
+            };
+            /** @description Structured error */
+            default: {
+                headers: {
+                    [name: string]: unknown;
+                };
+                content: {
+                    "application/json": components["schemas"]["Error"];
+                };
+            };
+        };
+    };
+    getProviderPreset: {
+        parameters: {
+            query?: never;
+            header?: never;
+            path: {
+                id: string;
+            };
+            cookie?: never;
+        };
+        requestBody?: never;
+        responses: {
+            /** @description Success */
+            200: {
+                headers: {
+                    [name: string]: unknown;
+                };
+                content: {
+                    "application/json": components["schemas"]["ProviderPreset"];
+                };
+            };
+            /** @description Structured error */
+            default: {
+                headers: {
+                    [name: string]: unknown;
+                };
+                content: {
+                    "application/json": components["schemas"]["Error"];
+                };
+            };
+        };
+    };
     listModels: {
         parameters: {
             query?: {

package/dist/grok-args.d.ts

@@ -0,0 +1 @@
+export declare function validateGrokResume(args: string[]): void;

package/dist/harness-arguments.d.ts

@@ -0,0 +1,6 @@
+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;
+}): void;

package/dist/harness-environment.d.ts

@@ -0,0 +1 @@
+export declare function childEnvironment(env?: NodeJS.ProcessEnv): Record<string, string>;

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-process.d.ts

@@ -0,0 +1,11 @@
+/** Own a POSIX process group; interactive children get a controlling terminal. */
+export declare function runHarnessProcess(options: {
+    executable: string;
+    args: string[];
+    cwd: string;
+    env: NodeJS.ProcessEnv;
+    timeoutMs?: number;
+}): Promise<{
+    code: number;
+    interrupted: boolean;
+}>;

package/dist/harness-types.d.ts

@@ -13,6 +13,7 @@ export type HarnessLaunchInput = {
     stateDir: string;
     cwd: string;
     version?: string;
+    sessionDir?: string;
 };
 export type PreparedLaunch = {
     executable: string;
@@ -20,5 +21,6 @@ export type PreparedLaunch = {
     env: Record<string, string>;
     configPaths: string[];
     warnings: string[];
+    beforeLaunch?: () => Promise<void>;
     cleanup?: () => Promise<void>;
 };

package/dist/harnesses.d.ts

@@ -1,13 +1,47 @@
 import type { HarnessId, HarnessLaunchInput, PreparedLaunch } from "./harness-types";
 export declare function detectHarness(harness: HarnessId, override?: string): Promise<{
-    harness: "claude" | "codex" | "grok" | "opencode2";
+    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";
+    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;
+    display_name: string;
+    description: string;
+    shell_type: string;
+    visibility: string;
+    supported_in_api: boolean;
+    priority: number;
+    supported_reasoning_levels: never[];
+    default_reasoning_level: null;
+    support_verbosity: boolean;
+    supports_reasoning_summary_parameter: boolean;
+    default_verbosity: null;
+    supports_parallel_tool_calls: boolean;
+    apply_patch_tool_type: null;
+    truncation_policy: {
+        mode: string;
+        limit: number;
+    };
+    experimental_supported_tools: never[];
+    context_window: number | null;
+    max_context_window: number | null;
+    input_modalities: ("text" | "image")[];
+    prefer_websockets: boolean;
+    use_responses_lite: boolean;
+    model_messages: {
+        instructions_template: string;
+        instructions_variables: null;
+    };
+};
 export declare function prepareHarnessLaunch(input: HarnessLaunchInput): Promise<PreparedLaunch>;

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>;