@hasna/switcher 0.1.0 → 0.1.1

package/dist/mcp/index.js

@@ -8,8 +8,8 @@ import { z as z2 } from "zod";
 
 // src/domain.ts
 import { z } from "zod";
-var VERSION = "0.1.0";
-var harnessSchema = z.enum(["claude", "codex", "grok", "opencode2"]);
+var VERSION = "0.1.1";
+var harnessSchema = z.enum(["claude", "codex", "grok", "opencode2", "pi"]);
 var protocolSchema = z.enum(["anthropic-messages", "openai-responses", "openai-chat"]);
 var idSchema = z.string().regex(/^[a-zA-Z0-9][a-zA-Z0-9._-]{0,79}$/);
 var label = z.string().min(1).max(200);
@@ -37,6 +37,7 @@ var modelSchema = z.object({
   id: z.string().min(1).max(300),
   name: label,
   description: z.string().max(8000).optional(),
+  available: z.boolean().optional(),
   contextWindow: z.number().int().positive().optional(),
   maxOutputTokens: z.number().int().positive().optional(),
   inputModalities: z.array(z.string().max(50)).max(20).optional(),
@@ -50,9 +51,32 @@ var providerInputSchema = z.object({
   protocol: protocolSchema,
   credentialEnv: envRef.optional(),
   authStyle: z.enum(["bearer", "x-api-key"]).default("bearer"),
+  catalogBaseUrl: urlSchema.optional(),
+  catalogFormat: z.enum(["openai", "ollama", "mistral", "together", "fireworks", "dashscope", "none"]).optional(),
+  catalogAuthStyle: z.enum(["bearer", "x-api-key", "none"]).optional(),
+  catalogCredentialEnv: envRef.optional(),
+  catalogAccountId: z.string().regex(/^[A-Za-z0-9][A-Za-z0-9._-]{0,127}$/).optional(),
   modelsPath: z.string().regex(/^[a-zA-Z0-9_/-]+$/).max(200).default("models"),
   manualModels: z.array(modelSchema).max(1e4).default([])
 }).strict().refine((p) => !p.modelsPath.split("/").includes("..") && !p.modelsPath.startsWith("/"), "modelsPath must be relative");
+var providerPresetSchema = z.object({
+  id: idSchema,
+  name: label,
+  credentialEnv: envRef.optional(),
+  credentialAliases: z.array(z.string().regex(/^[A-Z][A-Z0-9_]+$/)),
+  protocols: z.array(z.object({
+    protocol: protocolSchema,
+    baseUrl: urlSchema.optional(),
+    authStyle: z.enum(["bearer", "x-api-key"]),
+    catalogBaseUrl: urlSchema.optional(),
+    catalogFormat: z.enum(["openai", "ollama", "mistral", "together", "fireworks", "dashscope", "none"]),
+    catalogAuthStyle: z.enum(["bearer", "x-api-key", "none"]).optional(),
+    modelsPath: z.string(),
+    notes: z.array(z.string())
+  }).strict()).min(1),
+  sources: z.array(z.string().url()),
+  verification: z.literal("documented")
+}).strict();
 var profileInputSchema = z.object({
   id: idSchema,
   name: label,
@@ -80,6 +104,12 @@ class Fault extends Error {
     this.code = code;
   }
 }
+function parse(schema, value) {
+  const result = schema.safeParse(value);
+  if (!result.success)
+    throw new Fault(400, "invalid_request", result.error.issues.map((i) => `${i.path.join(".")}: ${i.message}`).join("; "));
+  return result.data;
+}
 
 // src/http.ts
 var MAX_BYTES = 16 * 1024 * 1024;
@@ -118,6 +148,81 @@ async function boundedJson(response, maxBytes = MAX_BYTES) {
 // src/sdk.ts
 import { resolveCredential } from "@hasna/contracts/client";
 
+// src/presets.ts
+var route = (protocol, baseUrl, options = {}) => ({
+  protocol,
+  baseUrl,
+  authStyle: "bearer",
+  catalogFormat: "openai",
+  modelsPath: "models",
+  notes: [],
+  ...options
+});
+var preset = (id, name, protocols, sources, alias) => parse(providerPresetSchema, {
+  id,
+  name,
+  protocols,
+  sources,
+  credentialAliases: alias ? [alias] : [],
+  credentialEnv: alias ? `SWITCHER_PROVIDER_${id.toUpperCase().replace(/-/g, "_")}` : undefined,
+  verification: "documented"
+});
+var providerPresets = [
+  preset("deepseek", "DeepSeek", [
+    route("openai-chat", "https://api.deepseek.com", { catalogBaseUrl: "https://api.deepseek.com" }),
+    route("anthropic-messages", "https://api.deepseek.com/anthropic/v1", { catalogBaseUrl: "https://api.deepseek.com" })
+  ], ["https://api-docs.deepseek.com/guides/anthropic_api", "https://api-docs.deepseek.com/api/list-models"], "DEEPSEEK_API_KEY"),
+  preset("openrouter", "OpenRouter", ["openai-chat", "openai-responses", "anthropic-messages"].map((protocol) => route(protocol, "https://openrouter.ai/api/v1", { catalogAuthStyle: "none" })), ["https://openrouter.ai/docs/api/api-reference/models/list-all-models-and-their-properties", "https://openrouter.ai/docs/guides/overview"], "OPENROUTER_API_KEY"),
+  preset("anthropic", "Anthropic", [route("anthropic-messages", "https://api.anthropic.com/v1", { authStyle: "x-api-key" })], ["https://platform.claude.com/docs/en/api/overview", "https://platform.claude.com/docs/en/api/models/list"], "ANTHROPIC_API_KEY"),
+  preset("openai", "OpenAI", [route("openai-responses", "https://api.openai.com/v1"), route("openai-chat", "https://api.openai.com/v1")], ["https://platform.openai.com/docs/api-reference/introduction", "https://platform.openai.com/docs/api-reference/models/list"], "OPENAI_API_KEY"),
+  preset("xai", "xAI", ["openai-chat", "openai-responses", "anthropic-messages"].map((protocol) => route(protocol, "https://api.x.ai/v1")), ["https://api.x.ai/docs/", "https://docs.x.ai/developers/model-capabilities/text/generate-text"], "XAI_API_KEY"),
+  preset("ollama", "Ollama", ["openai-chat", "openai-responses"].map((protocol) => route(protocol, "http://127.0.0.1:11434/v1", {
+    catalogBaseUrl: "http://127.0.0.1:11434",
+    modelsPath: "api/tags",
+    catalogFormat: "ollama",
+    catalogAuthStyle: "none",
+    notes: protocol === "openai-responses" ? ["Requires Ollama 0.13.3 or newer; only stateless Responses are supported."] : []
+  })), ["https://docs.ollama.com/api/openai-compatibility", "https://docs.ollama.com/api/tags"]),
+  preset("lmstudio", "LM Studio", ["openai-chat", "openai-responses", "anthropic-messages"].map((protocol) => route(protocol, "http://127.0.0.1:1234/v1", {
+    notes: ["Server authentication is optional. Use --credential-env when authentication is enabled."]
+  })), ["https://lmstudio.ai/docs/developer/rest"]),
+  preset("vllm", "vLLM (operator endpoint)", [
+    route("openai-chat", undefined, { notes: ["Pass the operator's OpenAI-compatible URL, normally ending in /v1. vLLM exposes Chat Completions at /chat/completions and GET /models under that prefix; configure --credential-env only when the server was started with --api-key or VLLM_API_KEY."] }),
+    route("openai-responses", undefined, { notes: ["Pass the operator's OpenAI-compatible URL, normally ending in /v1. Responses is available for supported text-generation models at /responses; configure --credential-env only when the server was started with --api-key or VLLM_API_KEY."] }),
+    route("anthropic-messages", undefined, { notes: ["Pass the operator's URL, normally ending in /v1. vLLM exposes the Anthropic Messages API at /messages for supported deployments. Chat templates and the configured tool parser determine whether streaming and tool calls work for a served model; configure --credential-env only when the server was started with --api-key or VLLM_API_KEY."] })
+  ], ["https://docs.vllm.ai/en/latest/serving/online_serving/openai_compatible_server/", "https://github.com/vllm-project/vllm/blob/main/docs/serving/online_serving/README.md"]),
+  preset("litellm", "LiteLLM Proxy (operator endpoint)", [
+    route("openai-chat", undefined, { notes: ["Pass the proxy's documented OpenAI-compatible base URL exactly; the official quick start uses the root server URL, while a deployment may add a prefix such as /v1. LiteLLM serves Chat Completions and GET /models relative to that URL; use --credential-env for the proxy's configured master key or other bearer token."] }),
+    route("openai-responses", undefined, { notes: ["Pass the proxy's documented OpenAI-compatible base URL exactly; LiteLLM documents the Responses API under the same proxy root or deployment prefix. Use --credential-env for the proxy's configured master key or other bearer token."] }),
+    route("anthropic-messages", undefined, { notes: ["Pass the complete inference prefix ending in /v1, including any deployment prefix. LiteLLM registers /v1/messages; Switcher appends /messages to the stored prefix and discovers /models there. This is a gateway adapter: streaming and tool behavior depend on the configured upstream model and route, so verify those capabilities independently. Use --credential-env for the proxy's configured master key or other bearer token."] })
+  ], ["https://docs.litellm.ai/", "https://docs.litellm.ai/docs/proxy/quick_start", "https://github.com/BerriAI/litellm/blob/main/litellm/proxy/anthropic_endpoints/endpoints.py"]),
+  preset("groq", "Groq", [route("openai-chat", "https://api.groq.com/openai/v1"), route("openai-responses", "https://api.groq.com/openai/v1", { notes: ["Responses is an upstream beta API."] })], ["https://console.groq.com/docs/api-reference"], "GROQ_API_KEY"),
+  preset("cerebras", "Cerebras", [route("openai-chat", "https://api.cerebras.ai/v1")], ["https://inference-docs.cerebras.ai/api-reference/chat-completions"], "CEREBRAS_API_KEY"),
+  preset("mistral", "Mistral", [route("openai-chat", "https://api.mistral.ai/v1", { catalogFormat: "mistral" })], ["https://docs.mistral.ai/api/endpoint/chat", "https://docs.mistral.ai/api/endpoint/models"], "MISTRAL_API_KEY"),
+  preset("together", "Together AI", [route("openai-chat", "https://api.together.ai/v1", { catalogFormat: "together" })], ["https://docs.together.ai/docs/inference/openai-compatibility", "https://docs.together.ai/reference/models"], "TOGETHER_API_KEY"),
+  preset("fireworks", "Fireworks AI", [
+    route("openai-chat", "https://api.fireworks.ai/inference/v1", { catalogFormat: "fireworks", notes: ["Model discovery uses GET /v1/accounts/{account_id}/models; provide --catalog-account-id or --catalog-url."] }),
+    route("openai-responses", "https://api.fireworks.ai/inference/v1", { catalogFormat: "fireworks", notes: ["Model discovery uses GET /v1/accounts/{account_id}/models; provide --catalog-account-id or --catalog-url."] }),
+    route("anthropic-messages", "https://api.fireworks.ai/inference/v1", { catalogFormat: "fireworks", notes: ["Model discovery uses GET /v1/accounts/{account_id}/models; provide --catalog-account-id or --catalog-url."] })
+  ], ["https://docs.fireworks.ai/getting-started/quickstart", "https://docs.fireworks.ai/tools-sdks/python-client/api-reference", "https://docs.fireworks.ai/api-reference/anthropic-messages", "https://docs.fireworks.ai/api-reference/post-chatcompletions", "https://docs.fireworks.ai/api-reference/list-models"], "FIREWORKS_API_KEY"),
+  preset("moonshot", "Moonshot AI (Kimi)", [route("openai-chat", "https://api.moonshot.ai/v1", { catalogBaseUrl: "https://api.moonshot.ai/v1" })], ["https://platform.kimi.ai/docs/api/chat", "https://platform.kimi.ai/docs/api/list-models"], "MOONSHOT_API_KEY"),
+  preset("dashscope", "Alibaba Cloud Model Studio (Qwen)", [route("openai-chat", "https://dashscope-us.aliyuncs.com/compatible-mode/v1", {
+    catalogFormat: "none",
+    notes: ["Inference keys and endpoints are region/workspace-specific. Model discovery uses GET /api/v1/models on a documented region or workspace catalog URL; pass --catalog-url and --catalog-format dashscope."]
+  })], ["https://help.aliyun.com/en/model-studio/base-url", "https://help.aliyun.com/en/model-studio/compatibility-of-openai-with-dashscope", "https://help.aliyun.com/en/model-studio/list-models"], "DASHSCOPE_API_KEY"),
+  preset("zai", "Z.AI", [route("openai-chat", "https://api.z.ai/api/paas/v4", {
+    catalogFormat: "none",
+    notes: ["The published API reference documents inference endpoints but no model-list endpoint; use manual models or provide an explicit catalog URL and parser."]
+  })], ["https://docs.z.ai/api-reference/introduction", "https://docs.z.ai/devpack/quick-start"], "ZAI_API_KEY"),
+  preset("minimax", "MiniMax", [
+    route("openai-chat", "https://api.minimax.cn/v1", { catalogBaseUrl: "https://api.minimax.cn/v1", notes: ["The Open Platform contract uses api.minimax.cn and Bearer auth. Token Plan documentation uses api.minimaxi.com; select that authority explicitly with --url and matching auth/credential settings."] }),
+    route("anthropic-messages", "https://api.minimax.cn/anthropic/v1", { authStyle: "x-api-key", catalogBaseUrl: "https://api.minimax.cn/anthropic/v1", catalogAuthStyle: "x-api-key", notes: ["The Open Platform contract uses api.minimax.cn/anthropic/v1 and X-Api-Key. Token Plan documentation uses api.minimaxi.com/anthropic; select that authority explicitly with --url and matching auth/credential settings."] })
+  ], ["https://platform.minimaxi.com/docs/api-reference/text-chat-anthropic", "https://platform.minimaxi.com/docs/api-reference/models/anthropic/list-models", "https://platform.minimaxi.com/docs/api-reference/models/openai/list-models", "https://platform.minimaxi.com/docs/token-plan/other-tools"], "MINIMAX_API_KEY"),
+  preset("siliconflow", "SiliconFlow", [route("openai-chat", "https://api.siliconflow.cn/v1", { catalogBaseUrl: "https://api.siliconflow.cn/v1", catalogFormat: "openai", notes: ["The official SiliconCloud OpenAPI contract defines GET /models with Bearer auth and data[] model rows; optional type and sub_type filters are available at the upstream endpoint."] })], ["https://github.com/siliconflow/siliconcloud/blob/main/openapi.yaml", "https://docs.siliconflow.cn/docs/userguide/quickstart", "https://docs.siliconflow.cn/docs/api/chat-completions-post"], "SILICONFLOW_API_KEY"),
+  ...["anthropic-messages", "openai-responses", "openai-chat"].map((protocol) => preset(`generic-${protocol}`, `Custom ${protocol}`, [route(protocol)], []))
+];
+
+// src/sdk.ts
 class SwitcherError extends Error {
   status;
   code;
@@ -140,7 +245,7 @@ class SwitcherClient {
     this.options = { ...options };
   }
   async request(method, path, body, options = {}) {
-    if (!/^\/v1\/[a-zA-Z0-9/?&=._%+-]+$/.test(path) || path.includes(".."))
+    if (!/^\/v1\/[a-zA-Z0-9/?&=._%+-]+$/.test(path) && !["/health", "/ready", "/version"].includes(path) || path.includes(".."))
       throw new Error("Invalid API path.");
     const apiKey = typeof this.options.apiKey === "function" ? this.options.apiKey() : this.options.apiKey;
     if (!apiKey || /[\r\n]/.test(apiKey))
@@ -171,6 +276,21 @@ class SwitcherClient {
   query(options = {}) {
     return new URLSearchParams(Object.entries(options).filter(([, v]) => v !== undefined).map(([k, v]) => [k, String(v)])).toString();
   }
+  health() {
+    return this.request("GET", "/health");
+  }
+  ready() {
+    return this.request("GET", "/ready");
+  }
+  version() {
+    return this.request("GET", "/version");
+  }
+  listProviderPresets() {
+    return this.request("GET", "/v1/provider-presets");
+  }
+  getProviderPreset(id) {
+    return this.request("GET", `/v1/provider-presets/${encodeURIComponent(id)}`);
+  }
   listProviders(options = {}) {
     return this.request("GET", `/v1/providers?${this.query(options)}`);
   }

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, {
+    action: string;
+    resource: string;
+    effect: "allow" | "deny" | "ask";
+}, {
+    action: string;
+    resource: string;
+    effect: "allow" | "deny" | "ask";
+}>;
+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: {
+            action: string;
+            resource: string;
+            effect: "allow" | "deny" | "ask";
+        }[];
+        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";
+export type OriProtocol = "anthropic-messages" | "openai-responses" | "openai-chat";
+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,63 @@
+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";
+        authStyle: "bearer" | "x-api-key";
+        catalogFormat: "openai" | "ollama" | "mistral" | "together" | "fireworks" | "dashscope" | "none";
+        modelsPath: string;
+        notes: string[];
+        baseUrl?: string | undefined;
+        catalogBaseUrl?: string | undefined;
+        catalogAuthStyle?: "bearer" | "x-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";
+    catalogBaseUrl?: string;
+    catalogCredentialEnv?: string;
+    catalogAuthStyle?: "bearer" | "x-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";
+    authStyle: "bearer" | "x-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;
+    }[];
+    credentialEnv?: string | undefined;
+    catalogBaseUrl?: string | undefined;
+    catalogFormat?: "openai" | "ollama" | "mistral" | "together" | "fireworks" | "dashscope" | "none" | undefined;
+    catalogAuthStyle?: "bearer" | "x-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,6 +36,39 @@ 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";
+            baseUrl?: string;
+            authStyle: "bearer" | "x-api-key";
+            catalogBaseUrl?: string;
+            catalogFormat: "openai" | "ollama" | "mistral" | "together" | "fireworks" | "dashscope" | "none";
+            catalogAuthStyle?: "bearer" | "x-api-key" | "none";
+            modelsPath: string;
+            notes: string[];
+        }[];
+        sources: string[];
+        verification: "documented";
+    }>;
     listProviders(options?: {}): Promise<Page<{
         id: string;
         name: string;
@@ -41,11 +76,17 @@ export declare class SwitcherClient {
         protocol: "anthropic-messages" | "openai-responses" | "openai-chat";
         credentialEnv?: string;
         authStyle: "bearer" | "x-api-key";
+        catalogBaseUrl?: string;
+        catalogFormat?: "openai" | "ollama" | "mistral" | "together" | "fireworks" | "dashscope" | "none";
+        catalogAuthStyle?: "bearer" | "x-api-key" | "none";
+        catalogCredentialEnv?: string;
+        catalogAccountId?: string;
         modelsPath: string;
         manualModels: {
             id: string;
             name: string;
             description?: string;
+            available?: boolean;
             contextWindow?: number;
             maxOutputTokens?: number;
             inputModalities?: string[];
@@ -62,11 +103,17 @@ export declare class SwitcherClient {
         protocol: "anthropic-messages" | "openai-responses" | "openai-chat";
         credentialEnv?: string;
         authStyle: "bearer" | "x-api-key";
+        catalogBaseUrl?: string;
+        catalogFormat?: "openai" | "ollama" | "mistral" | "together" | "fireworks" | "dashscope" | "none";
+        catalogAuthStyle?: "bearer" | "x-api-key" | "none";
+        catalogCredentialEnv?: string;
+        catalogAccountId?: string;
         modelsPath: string;
         manualModels: {
             id: string;
             name: string;
             description?: string;
+            available?: boolean;
             contextWindow?: number;
             maxOutputTokens?: number;
             inputModalities?: string[];
@@ -83,11 +130,17 @@ export declare class SwitcherClient {
         protocol: "anthropic-messages" | "openai-responses" | "openai-chat";
         credentialEnv?: string;
         authStyle: "bearer" | "x-api-key";
+        catalogBaseUrl?: string;
+        catalogFormat?: "openai" | "ollama" | "mistral" | "together" | "fireworks" | "dashscope" | "none";
+        catalogAuthStyle?: "bearer" | "x-api-key" | "none";
+        catalogCredentialEnv?: string;
+        catalogAccountId?: string;
         modelsPath: string;
         manualModels: {
             id: string;
             name: string;
             description?: string;
+            available?: boolean;
             contextWindow?: number;
             maxOutputTokens?: number;
             inputModalities?: string[];
@@ -104,11 +157,17 @@ export declare class SwitcherClient {
         protocol: "anthropic-messages" | "openai-responses" | "openai-chat";
         credentialEnv?: string;
         authStyle: "bearer" | "x-api-key";
+        catalogBaseUrl?: string;
+        catalogFormat?: "openai" | "ollama" | "mistral" | "together" | "fireworks" | "dashscope" | "none";
+        catalogAuthStyle?: "bearer" | "x-api-key" | "none";
+        catalogCredentialEnv?: string;
+        catalogAccountId?: string;
         modelsPath: string;
         manualModels: {
             id: string;
             name: string;
             description?: string;
+            available?: boolean;
             contextWindow?: number;
             maxOutputTokens?: number;
             inputModalities?: string[];
@@ -126,6 +185,7 @@ export declare class SwitcherClient {
             id: string;
             name: string;
             description?: string;
+            available?: boolean;
             contextWindow?: number;
             maxOutputTokens?: number;
             inputModalities?: string[];
@@ -140,6 +200,7 @@ export declare class SwitcherClient {
             id: string;
             name: string;
             description?: string;
+            available?: boolean;
             contextWindow?: number;
             maxOutputTokens?: number;
             inputModalities?: string[];
@@ -157,7 +218,7 @@ export declare class SwitcherClient {
         id: string;
         name: string;
         providerId: string;
-        harness: "claude" | "codex" | "grok" | "opencode2";
+        harness: "claude" | "codex" | "grok" | "opencode2" | "pi";
         model: string;
         version: number;
         updatedAt: string;
@@ -166,7 +227,7 @@ export declare class SwitcherClient {
         id: string;
         name: string;
         providerId: string;
-        harness: "claude" | "codex" | "grok" | "opencode2";
+        harness: "claude" | "codex" | "grok" | "opencode2" | "pi";
         model: string;
         version: number;
         updatedAt: string;
@@ -175,7 +236,7 @@ export declare class SwitcherClient {
         id: string;
         name: string;
         providerId: string;
-        harness: "claude" | "codex" | "grok" | "opencode2";
+        harness: "claude" | "codex" | "grok" | "opencode2" | "pi";
         model: string;
         version: number;
         updatedAt: string;
@@ -184,7 +245,7 @@ export declare class SwitcherClient {
         id: string;
         name: string;
         providerId: string;
-        harness: "claude" | "codex" | "grok" | "opencode2";
+        harness: "claude" | "codex" | "grok" | "opencode2" | "pi";
         model: string;
         version: number;
         updatedAt: string;
@@ -200,11 +261,17 @@ export declare class SwitcherClient {
             protocol: "anthropic-messages" | "openai-responses" | "openai-chat";
             credentialEnv?: string;
             authStyle: "bearer" | "x-api-key";
+            catalogBaseUrl?: string;
+            catalogFormat?: "openai" | "ollama" | "mistral" | "together" | "fireworks" | "dashscope" | "none";
+            catalogAuthStyle?: "bearer" | "x-api-key" | "none";
+            catalogCredentialEnv?: string;
+            catalogAccountId?: string;
             modelsPath: string;
             manualModels: {
                 id: string;
                 name: string;
                 description?: string;
+                available?: boolean;
                 contextWindow?: number;
                 maxOutputTokens?: number;
                 inputModalities?: string[];
@@ -218,7 +285,7 @@ export declare class SwitcherClient {
             id: string;
             name: string;
             providerId: string;
-            harness: "claude" | "codex" | "grok" | "opencode2";
+            harness: "claude" | "codex" | "grok" | "opencode2" | "pi";
             model: string;
             version: number;
             updatedAt: string;
@@ -228,6 +295,7 @@ export declare class SwitcherClient {
                 id: string;
                 name: string;
                 description?: string;
+                available?: boolean;
                 contextWindow?: number;
                 maxOutputTokens?: number;
                 inputModalities?: string[];
@@ -242,7 +310,7 @@ export declare class SwitcherClient {
     }>;
     listRuns(options?: {}): Promise<Page<{
         profileId: string;
-        harness: "claude" | "codex" | "grok" | "opencode2";
+        harness: "claude" | "codex" | "grok" | "opencode2" | "pi";
         model: string;
         planToken: string;
         version: number;
@@ -258,7 +326,7 @@ export declare class SwitcherClient {
     }>>;
     getRun(id: string): Promise<{
         profileId: string;
-        harness: "claude" | "codex" | "grok" | "opencode2";
+        harness: "claude" | "codex" | "grok" | "opencode2" | "pi";
         model: string;
         planToken: string;
         version: number;
@@ -274,7 +342,7 @@ export declare class SwitcherClient {
     }>;
     createRun(input: components["schemas"]["RunInput"], idempotencyKey?: string): Promise<{
         profileId: string;
-        harness: "claude" | "codex" | "grok" | "opencode2";
+        harness: "claude" | "codex" | "grok" | "opencode2" | "pi";
         model: string;
         planToken: string;
         version: number;
@@ -293,7 +361,7 @@ export declare class SwitcherClient {
         exitCode: number;
     }, idempotencyKey?: string): Promise<{
         profileId: string;
-        harness: "claude" | "codex" | "grok" | "opencode2";
+        harness: "claude" | "codex" | "grok" | "opencode2" | "pi";
         model: string;
         planToken: string;
         version: number;