@hasna/switcher 0.1.0 → 0.1.2

package/dist/opencode2-config.d.ts

@@ -0,0 +1,60 @@
+import { z } from "zod";
+declare const rule: z.ZodObject<{
+    action: z.ZodString;
+    resource: z.ZodString;
+    effect: z.ZodEnum<["allow", "deny", "ask"]>;
+}, "strict", z.ZodTypeAny, {
+    effect: "allow" | "deny" | "ask";
+    action: string;
+    resource: string;
+}, {
+    effect: "allow" | "deny" | "ask";
+    action: string;
+    resource: string;
+}>;
+type Rule = z.infer<typeof rule>;
+type Agent = {
+    system?: string;
+    description?: string;
+    mode?: "primary" | "subagent" | "all";
+    hidden?: boolean;
+    color?: string;
+    steps?: number;
+    disabled?: boolean;
+    permissions?: Rule[];
+};
+/** Preserve native policy and prompts as data, without running native plugins or loading provider settings. */
+export declare function isolateOpenCode2(cwd: string, stateDir: string, providerID: string, env?: NodeJS.ProcessEnv): Promise<{
+    config: {
+        experimental: {
+            policies: {
+                action: string;
+                resource: string;
+                effect: string;
+            }[];
+        };
+        default_agent?: string | undefined;
+        permissions: {
+            effect: "allow" | "deny" | "ask";
+            action: string;
+            resource: string;
+        }[];
+        agents: Record<string, Agent>;
+    };
+    env: {
+        HOME: string;
+        XDG_CONFIG_HOME: string;
+        OPENCODE_CONFIG_DIR: string;
+        XDG_CACHE_HOME: string;
+        XDG_STATE_HOME: string;
+        XDG_DATA_HOME: string;
+        OPENCODE_DISABLE_PROJECT_CONFIG: string;
+        OPENCODE_CONFIG_PROJECT_DISABLE: string;
+        OPENCODE_DISABLE_MODELS_FETCH: string;
+    };
+    instructionFile: string;
+    sourcePaths: string[];
+}>;
+/** Native substitutes variables before parsing JSON; quote literal prompt/model tokens without evaluating them. */
+export declare function openCode2ConfigText(config: Record<string, unknown>, providerID: string, keyEnv: string): string;
+export {};

package/dist/ori-backend.d.ts

@@ -0,0 +1,89 @@
+/** The Ori 0.12.1 command name for a Switcher harness. */
+export type OriTarget = "claude" | "codex" | "grok" | "opencode2" | "pi" | "dsh" | "gemini" | "aider" | "kilo";
+export type OriProtocol = "anthropic-messages" | "openai-responses" | "openai-chat" | "gemini-generate-content";
+export type OriReasoningEffort = "max" | "xhigh" | "high" | "medium" | "low" | "minimal" | "none";
+export type OriProviderCatalogEntry = {
+    id: "openrouter";
+    displayName: "OpenRouter";
+    credentialEnv: "OPENROUTER_API_KEY";
+    publicModelsUrl: "https://openrouter.ai/api/v1/models";
+    entitledModelsUrl: "https://openrouter.ai/api/v1/models/user";
+    protocols: readonly OriProtocol[];
+};
+/**
+ * Ori is an OpenRouter launcher, rather than a general provider adapter.
+ * Keep this list immutable so callers cannot accidentally broaden the boundary.
+ */
+export declare const oriProviderCatalog: readonly OriProviderCatalogEntry[];
+/** Native Ori flags verified from `ori <target> --help` for 0.12.1. */
+export declare const oriNativeFlags: Readonly<Record<"claude" | "codex" | "grok", readonly string[]>>;
+export type OriCatalogInput = {
+    /** IDs from Switcher's OpenRouter catalog; Ori does not own discovery. */
+    modelIds: readonly string[];
+    source: "switcher-openrouter";
+    /** A Switcher-generated Codex catalog, appended after Ori's provider config. */
+    codexModelCatalogPath?: string;
+};
+export type OriHarnessAvailability = {
+    kind: string;
+    displayName?: string;
+    installed: boolean;
+    path?: string;
+};
+export type OriContract = {
+    executable: string;
+    version: string;
+    harnesses: OriHarnessAvailability[];
+};
+export type OriEnvironment = NodeJS.ProcessEnv & {
+    OPENROUTER_API_KEY?: string;
+    ORI_FORCE_OPENROUTER_API_KEY?: string;
+    ORI_REQUIRE_LOGIN?: string;
+};
+export type OriLaunchRequest = {
+    target: OriTarget;
+    provider: string;
+    providerBaseUrl?: string;
+    protocol?: OriProtocol;
+    catalog?: OriCatalogInput;
+    model: string;
+    args?: string[];
+    reasoningEffort?: OriReasoningEffort;
+};
+export type OriLaunchPlan = {
+    executable: string;
+    args: string[];
+    env: Record<string, string>;
+    target: OriTarget;
+    provider: "openrouter";
+    model: string;
+    warnings: string[];
+};
+export declare class OriBackendError extends Error {
+    readonly code: string;
+    constructor(code: string, message: string);
+}
+export declare function assertOriLoginAllowed(environment: NodeJS.ProcessEnv): void;
+/** Read Ori version and launchable harness inventory without auth or mutation. */
+export declare function inspectOri(options?: {
+    executable?: string;
+    environment?: NodeJS.ProcessEnv;
+    cwd?: string;
+}): Promise<OriContract>;
+/** Keep the installed 0.12.x contract explicit; newer Ori builds need review. */
+export declare function assertSupportedOriVersion(contract: OriContract): void;
+/** Fail before Ori's interactive installer offer when the native binary is absent. */
+export declare function requireOriHarness(contract: OriContract, target: OriTarget): OriHarnessAvailability;
+/** Assert the exact OpenRouter provider boundary before constructing argv. */
+export declare function oriProvider(id: string): OriProviderCatalogEntry;
+/** Validate target, provider and catalog authority before resolving a key. */
+export declare function validateOriLaunchRequest(request: OriLaunchRequest): void;
+/**
+ * Construct an argv-only Ori launch. This function does no process start and
+ * does not read credentials; callers hand it the already-authorized environment.
+ */
+export declare function prepareOriLaunch(request: OriLaunchRequest & {
+    executable?: string;
+    environment?: NodeJS.ProcessEnv;
+}): OriLaunchPlan;
+export declare function oriLaunchWarnings(target: OriTarget): string[];

package/dist/presets.d.ts

@@ -0,0 +1,64 @@
+import { type ProviderInput, type ProviderPreset, type Profile } from "./domain";
+type Protocol = ProviderInput["protocol"];
+export declare const providerPresets: readonly ProviderPreset[];
+export declare function getProviderPreset(id: string): {
+    id: string;
+    name: string;
+    credentialAliases: string[];
+    protocols: {
+        protocol: "anthropic-messages" | "openai-responses" | "openai-chat" | "gemini-generate-content";
+        authStyle: "bearer" | "x-api-key" | "api-key";
+        catalogFormat: "openai" | "ollama" | "mistral" | "together" | "fireworks" | "dashscope" | "gemini" | "none";
+        modelsPath: string;
+        notes: string[];
+        baseUrl?: string | undefined;
+        catalogBaseUrl?: string | undefined;
+        catalogAuthStyle?: "bearer" | "x-api-key" | "api-key" | "none" | undefined;
+    }[];
+    sources: string[];
+    verification: "documented";
+    credentialEnv?: string | undefined;
+};
+export type PresetOptions = {
+    id?: string;
+    protocol?: Protocol;
+    harness?: Profile["harness"];
+    baseUrl?: string;
+    credentialEnv?: string;
+    authStyle?: "bearer" | "x-api-key" | "api-key";
+    catalogBaseUrl?: string;
+    catalogCredentialEnv?: string;
+    catalogAuthStyle?: "bearer" | "x-api-key" | "api-key" | "none";
+    modelsPath?: string;
+    catalogFormat?: ProviderInput["catalogFormat"];
+    catalogAccountId?: string;
+};
+export declare function providerFromPreset(presetId: string, options?: PresetOptions): {
+    id: string;
+    name: string;
+    baseUrl: string;
+    protocol: "anthropic-messages" | "openai-responses" | "openai-chat" | "gemini-generate-content";
+    authStyle: "bearer" | "x-api-key" | "api-key";
+    modelsPath: string;
+    manualModels: {
+        id: string;
+        name: string;
+        description?: string | undefined;
+        available?: boolean | undefined;
+        contextWindow?: number | undefined;
+        maxOutputTokens?: number | undefined;
+        inputModalities?: string[] | undefined;
+        outputModalities?: string[] | undefined;
+        supportedParameters?: string[] | undefined;
+        supportedGenerationMethods?: string[] | undefined;
+    }[];
+    credentialEnv?: string | undefined;
+    catalogBaseUrl?: string | undefined;
+    catalogFormat?: "openai" | "ollama" | "mistral" | "together" | "fireworks" | "dashscope" | "gemini" | "none" | undefined;
+    catalogAuthStyle?: "bearer" | "x-api-key" | "api-key" | "none" | undefined;
+    catalogCredentialEnv?: string | undefined;
+    catalogAccountId?: string | undefined;
+};
+/** Resolve an alias only for the preset's exact credential reference and origin. */
+export declare function providerCredential(provider: ProviderInput, env?: NodeJS.ProcessEnv): string | undefined;
+export {};

package/dist/runtime.d.ts

@@ -0,0 +1,20 @@
+import { SwitcherClient } from "./sdk";
+import type { CatalogCredentialResolver } from "./catalog";
+export declare function switcherHome(env?: NodeJS.ProcessEnv): string;
+export declare function privateDirectory(path: string): Promise<void>;
+/** Data access always uses HTTP, including the per-command owned local service. */
+export declare function openCliRuntime(env?: NodeJS.ProcessEnv, resolveCredential?: CatalogCredentialResolver): Promise<{
+    client: SwitcherClient;
+    mode: "remote";
+    providerEnv: {
+        [k: string]: string | undefined;
+    };
+    close: () => Promise<void>;
+} | {
+    client: SwitcherClient;
+    mode: "local";
+    providerEnv: {
+        [k: string]: string | undefined;
+    };
+    close: () => Promise<void>;
+}>;

package/dist/sdk.d.ts

@@ -1,4 +1,6 @@
 import type { components } from "./generated/api";
+export { providerFromPreset } from "./presets";
+export type ProviderPreset = components["schemas"]["ProviderPreset"];
 export type ProviderInput = components["schemas"]["ProviderInput"];
 export type Provider = components["schemas"]["Provider"];
 export type ProfileInput = components["schemas"]["ProfileInput"];
@@ -34,23 +36,63 @@ export declare class SwitcherClient {
         idempotencyKey?: string;
     }): Promise<T>;
     private query;
+    health(): Promise<{
+        status: "ok" | "degraded" | "unavailable";
+        version: string;
+        backend: "sqlite" | "postgresql";
+    }>;
+    ready(): Promise<{
+        ready: boolean;
+        reason?: string;
+    }>;
+    version(): Promise<{
+        version: string;
+    }>;
+    listProviderPresets(): Promise<{
+        data: ProviderPreset[];
+    }>;
+    getProviderPreset(id: string): Promise<{
+        id: string;
+        name: string;
+        credentialEnv?: string;
+        credentialAliases: string[];
+        protocols: {
+            protocol: "anthropic-messages" | "openai-responses" | "openai-chat" | "gemini-generate-content";
+            baseUrl?: string;
+            authStyle: "bearer" | "x-api-key" | "api-key";
+            catalogBaseUrl?: string;
+            catalogFormat: "openai" | "ollama" | "mistral" | "together" | "fireworks" | "dashscope" | "gemini" | "none";
+            catalogAuthStyle?: "bearer" | "x-api-key" | "api-key" | "none";
+            modelsPath: string;
+            notes: string[];
+        }[];
+        sources: string[];
+        verification: "documented";
+    }>;
     listProviders(options?: {}): Promise<Page<{
         id: string;
         name: string;
         baseUrl: string;
-        protocol: "anthropic-messages" | "openai-responses" | "openai-chat";
+        protocol: "anthropic-messages" | "openai-responses" | "openai-chat" | "gemini-generate-content";
         credentialEnv?: string;
-        authStyle: "bearer" | "x-api-key";
+        authStyle: "bearer" | "x-api-key" | "api-key";
+        catalogBaseUrl?: string;
+        catalogFormat?: "openai" | "ollama" | "mistral" | "together" | "fireworks" | "dashscope" | "gemini" | "none";
+        catalogAuthStyle?: "bearer" | "x-api-key" | "api-key" | "none";
+        catalogCredentialEnv?: string;
+        catalogAccountId?: string;
         modelsPath: string;
         manualModels: {
             id: string;
             name: string;
             description?: string;
+            available?: boolean;
             contextWindow?: number;
             maxOutputTokens?: number;
             inputModalities?: string[];
             outputModalities?: string[];
             supportedParameters?: string[];
+            supportedGenerationMethods?: string[];
         }[];
         version: number;
         updatedAt: string;
@@ -59,19 +101,26 @@ export declare class SwitcherClient {
         id: string;
         name: string;
         baseUrl: string;
-        protocol: "anthropic-messages" | "openai-responses" | "openai-chat";
+        protocol: "anthropic-messages" | "openai-responses" | "openai-chat" | "gemini-generate-content";
         credentialEnv?: string;
-        authStyle: "bearer" | "x-api-key";
+        authStyle: "bearer" | "x-api-key" | "api-key";
+        catalogBaseUrl?: string;
+        catalogFormat?: "openai" | "ollama" | "mistral" | "together" | "fireworks" | "dashscope" | "gemini" | "none";
+        catalogAuthStyle?: "bearer" | "x-api-key" | "api-key" | "none";
+        catalogCredentialEnv?: string;
+        catalogAccountId?: string;
         modelsPath: string;
         manualModels: {
             id: string;
             name: string;
             description?: string;
+            available?: boolean;
             contextWindow?: number;
             maxOutputTokens?: number;
             inputModalities?: string[];
             outputModalities?: string[];
             supportedParameters?: string[];
+            supportedGenerationMethods?: string[];
         }[];
         version: number;
         updatedAt: string;
@@ -80,19 +129,26 @@ export declare class SwitcherClient {
         id: string;
         name: string;
         baseUrl: string;
-        protocol: "anthropic-messages" | "openai-responses" | "openai-chat";
+        protocol: "anthropic-messages" | "openai-responses" | "openai-chat" | "gemini-generate-content";
         credentialEnv?: string;
-        authStyle: "bearer" | "x-api-key";
+        authStyle: "bearer" | "x-api-key" | "api-key";
+        catalogBaseUrl?: string;
+        catalogFormat?: "openai" | "ollama" | "mistral" | "together" | "fireworks" | "dashscope" | "gemini" | "none";
+        catalogAuthStyle?: "bearer" | "x-api-key" | "api-key" | "none";
+        catalogCredentialEnv?: string;
+        catalogAccountId?: string;
         modelsPath: string;
         manualModels: {
             id: string;
             name: string;
             description?: string;
+            available?: boolean;
             contextWindow?: number;
             maxOutputTokens?: number;
             inputModalities?: string[];
             outputModalities?: string[];
             supportedParameters?: string[];
+            supportedGenerationMethods?: string[];
         }[];
         version: number;
         updatedAt: string;
@@ -101,19 +157,26 @@ export declare class SwitcherClient {
         id: string;
         name: string;
         baseUrl: string;
-        protocol: "anthropic-messages" | "openai-responses" | "openai-chat";
+        protocol: "anthropic-messages" | "openai-responses" | "openai-chat" | "gemini-generate-content";
         credentialEnv?: string;
-        authStyle: "bearer" | "x-api-key";
+        authStyle: "bearer" | "x-api-key" | "api-key";
+        catalogBaseUrl?: string;
+        catalogFormat?: "openai" | "ollama" | "mistral" | "together" | "fireworks" | "dashscope" | "gemini" | "none";
+        catalogAuthStyle?: "bearer" | "x-api-key" | "api-key" | "none";
+        catalogCredentialEnv?: string;
+        catalogAccountId?: string;
         modelsPath: string;
         manualModels: {
             id: string;
             name: string;
             description?: string;
+            available?: boolean;
             contextWindow?: number;
             maxOutputTokens?: number;
             inputModalities?: string[];
             outputModalities?: string[];
             supportedParameters?: string[];
+            supportedGenerationMethods?: string[];
         }[];
         version: number;
         updatedAt: string;
@@ -126,11 +189,13 @@ export declare class SwitcherClient {
             id: string;
             name: string;
             description?: string;
+            available?: boolean;
             contextWindow?: number;
             maxOutputTokens?: number;
             inputModalities?: string[];
             outputModalities?: string[];
             supportedParameters?: string[];
+            supportedGenerationMethods?: string[];
         }[];
         refreshedAt: string;
         source: "remote" | "manual";
@@ -140,11 +205,13 @@ export declare class SwitcherClient {
             id: string;
             name: string;
             description?: string;
+            available?: boolean;
             contextWindow?: number;
             maxOutputTokens?: number;
             inputModalities?: string[];
             outputModalities?: string[];
             supportedParameters?: string[];
+            supportedGenerationMethods?: string[];
             codingEligible: boolean;
         }[];
         total: number;
@@ -157,7 +224,7 @@ export declare class SwitcherClient {
         id: string;
         name: string;
         providerId: 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;
@@ -166,7 +233,7 @@ export declare class SwitcherClient {
         id: string;
         name: string;
         providerId: 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;
@@ -175,7 +242,7 @@ export declare class SwitcherClient {
         id: string;
         name: string;
         providerId: 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;
@@ -184,7 +251,7 @@ export declare class SwitcherClient {
         id: string;
         name: string;
         providerId: 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;
@@ -197,19 +264,26 @@ export declare class SwitcherClient {
             id: string;
             name: string;
             baseUrl: string;
-            protocol: "anthropic-messages" | "openai-responses" | "openai-chat";
+            protocol: "anthropic-messages" | "openai-responses" | "openai-chat" | "gemini-generate-content";
             credentialEnv?: string;
-            authStyle: "bearer" | "x-api-key";
+            authStyle: "bearer" | "x-api-key" | "api-key";
+            catalogBaseUrl?: string;
+            catalogFormat?: "openai" | "ollama" | "mistral" | "together" | "fireworks" | "dashscope" | "gemini" | "none";
+            catalogAuthStyle?: "bearer" | "x-api-key" | "api-key" | "none";
+            catalogCredentialEnv?: string;
+            catalogAccountId?: string;
             modelsPath: string;
             manualModels: {
                 id: string;
                 name: string;
                 description?: string;
+                available?: boolean;
                 contextWindow?: number;
                 maxOutputTokens?: number;
                 inputModalities?: string[];
                 outputModalities?: string[];
                 supportedParameters?: string[];
+                supportedGenerationMethods?: string[];
             }[];
             version: number;
             updatedAt: string;
@@ -218,7 +292,7 @@ export declare class SwitcherClient {
             id: string;
             name: string;
             providerId: 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;
@@ -228,11 +302,13 @@ export declare class SwitcherClient {
                 id: string;
                 name: string;
                 description?: string;
+                available?: boolean;
                 contextWindow?: number;
                 maxOutputTokens?: number;
                 inputModalities?: string[];
                 outputModalities?: string[];
                 supportedParameters?: string[];
+                supportedGenerationMethods?: string[];
             }[];
             refreshedAt: string;
             source: "remote" | "manual";
@@ -242,7 +318,7 @@ export declare class SwitcherClient {
     }>;
     listRuns(options?: {}): Promise<Page<{
         profileId: 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;
@@ -258,7 +334,7 @@ export declare class SwitcherClient {
     }>>;
     getRun(id: string): Promise<{
         profileId: 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;
@@ -274,7 +350,7 @@ export declare class SwitcherClient {
     }>;
     createRun(input: components["schemas"]["RunInput"], idempotencyKey?: string): Promise<{
         profileId: 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;
@@ -293,7 +369,7 @@ export declare class SwitcherClient {
         exitCode: number;
     }, idempotencyKey?: string): Promise<{
         profileId: 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;