@linxiraos/pi-ai 1.0.0

package/dist/types/registry/registry.d.ts

@@ -0,0 +1,367 @@
+import type { ProviderDefinition } from "./types.js";
+/**
+ * The single per-provider list. Adding a provider = create `./providers/<id>.ts`
+ * and add its export here. Every legacy structure (`KnownProvider`/`OAuthProvider`
+ * unions, descriptors, env map, login list, refresh/login dispatch, CLI callback
+ * maps) is derived from this registry. Order matches the interactive `/login`
+ * list for the loginable providers; non-login model providers are appended.
+ */
+declare const ALL: ({
+    readonly id: "aiand";
+    readonly name: "ai&";
+    readonly login: (cb: import("./oauth/index.js").OAuthLoginCallbacks) => Promise<string>;
+} | {
+    readonly id: "aimlapi";
+    readonly name: "AIML API";
+} | {
+    readonly id: "alibaba-coding-plan";
+    readonly name: "Alibaba Coding Plan";
+    readonly login: (cb: import("./oauth/index.js").OAuthLoginCallbacks) => Promise<import("./oauth/index.js").OAuthCredentials>;
+    readonly getApiKey: (credentials: import("./oauth/index.js").OAuthCredentials) => string;
+} | {
+    readonly id: "alibaba-token-plan";
+    readonly name: "QwenCloud Token Plan";
+    readonly login: (cb: import("./oauth/index.js").OAuthLoginCallbacks) => Promise<string>;
+} | {
+    readonly id: "amazon-bedrock";
+    readonly name: "Amazon Bedrock";
+    readonly envKeys: () => "<authenticated>" | undefined;
+} | {
+    readonly id: "anthropic";
+    readonly name: "Anthropic (Claude Pro/Max)";
+    readonly envKeys: () => string | undefined;
+    readonly login: (cb: import("./oauth/index.js").OAuthLoginCallbacks) => Promise<import("./oauth/index.js").OAuthCredentials>;
+    readonly refreshToken: (credentials: import("./oauth/index.js").OAuthCredentials) => Promise<import("./oauth/index.js").OAuthCredentials>;
+    readonly callbackPort: 54545;
+    readonly pasteCodeFlow: true;
+} | {
+    readonly id: "azure";
+    readonly name: "Azure OpenAI";
+} | {
+    readonly id: "baseten";
+    readonly name: "Baseten";
+    readonly login: (cb: import("./oauth/index.js").OAuthLoginCallbacks) => Promise<string>;
+} | {
+    readonly id: "bedrock-mantle";
+    readonly name: "Amazon Bedrock Mantle";
+    readonly envKeys: typeof import("./aws.js").resolveAwsRegistryApiKey;
+    readonly allowsMissingApiKey: true;
+    readonly prepareRequest: (model: import("@linxiraos/pi-catalog").Model<import("@linxiraos/pi-catalog").Api>, options: import("../index.js").StreamOptions) => import("../providers/bedrock-mantle.js").PreparedBedrockMantleRequest;
+    readonly mapSimpleOptions: (options: import("../index.js").SimpleStreamOptions) => {
+        providerOptions: Readonly<Record<string, unknown>> | undefined;
+    };
+    readonly prepareModelDiscovery: (config: import("./types.js").ProviderModelDiscoveryConfig) => {
+        baseUrl?: string;
+        fetch?: import("@linxiraos/pi-utils").FetchImpl;
+        apiKey: undefined;
+        authenticated: false;
+    } | {
+        authenticated: true;
+        baseUrl: string;
+        fetch: import("@linxiraos/pi-utils").FetchImpl;
+    };
+} | {
+    readonly id: "cerebras";
+    readonly name: "Cerebras";
+    readonly login: (cb: import("./oauth/index.js").OAuthLoginCallbacks) => Promise<string>;
+} | {
+    readonly id: "cloudflare-ai-gateway";
+    readonly name: "Cloudflare AI Gateway";
+    readonly login: (cb: import("./oauth/index.js").OAuthLoginCallbacks) => Promise<string>;
+} | {
+    readonly id: "coreweave";
+    readonly name: "CoreWeave Serverless Inference";
+    readonly login: (cb: import("./oauth/index.js").OAuthLoginCallbacks) => Promise<string>;
+} | {
+    readonly id: "cursor";
+    readonly name: "Cursor (Claude, GPT, etc.)";
+    readonly login: (cb: import("./oauth/index.js").OAuthLoginCallbacks) => Promise<import("./oauth/index.js").OAuthCredentials>;
+    readonly refreshToken: (credentials: import("./oauth/index.js").OAuthCredentials) => Promise<import("./oauth/index.js").OAuthCredentials>;
+} | {
+    readonly id: "deepseek";
+    readonly name: "DeepSeek";
+    readonly login: (cb: import("./oauth/index.js").OAuthLoginCallbacks) => Promise<string>;
+} | {
+    readonly id: "devin";
+    readonly name: "Devin";
+    readonly login: (cb: import("./oauth/index.js").OAuthLoginCallbacks) => Promise<string>;
+    readonly callbackPort: 59653;
+    readonly pasteCodeFlow: true;
+} | {
+    readonly id: "exa";
+    readonly name: "Exa";
+    readonly envKeys: "EXA_API_KEY";
+    readonly login: (cb: import("./oauth/index.js").OAuthLoginCallbacks) => Promise<string>;
+} | {
+    readonly id: "firepass";
+    readonly name: "Fire Pass (Fireworks Kimi K2.6 Turbo subscription)";
+    readonly login: (cb: import("./oauth/index.js").OAuthLoginCallbacks) => Promise<string>;
+} | {
+    readonly id: "fireworks";
+    readonly name: "Fireworks";
+    readonly login: (cb: import("./oauth/index.js").OAuthLoginCallbacks) => Promise<string>;
+} | {
+    readonly id: "github-copilot";
+    readonly name: "GitHub Copilot";
+    readonly login: (cb: import("./oauth/index.js").OAuthLoginCallbacks) => Promise<import("./oauth/index.js").OAuthCredentials>;
+    readonly refreshToken: (credentials: import("./oauth/index.js").OAuthCredentials) => Promise<import("./oauth/index.js").OAuthCredentials>;
+} | {
+    readonly id: "gitlab-duo";
+    readonly name: "GitLab Duo Non-Agentic";
+    readonly login: (cb: import("./oauth/index.js").OAuthLoginCallbacks) => Promise<import("./oauth/index.js").OAuthCredentials>;
+    readonly refreshToken: (credentials: import("./oauth/index.js").OAuthCredentials) => Promise<import("./oauth/index.js").OAuthCredentials>;
+    readonly callbackPort: 8080;
+    readonly pasteCodeFlow: true;
+} | {
+    readonly id: "gitlab-duo-agent";
+    readonly name: "GitLab Duo Agent";
+    readonly envKeys: "GITLAB_TOKEN";
+    readonly login: (cb: import("./oauth/index.js").OAuthLoginCallbacks) => Promise<import("./oauth/index.js").OAuthCredentials>;
+    readonly refreshToken: (credentials: import("./oauth/index.js").OAuthCredentials) => Promise<import("./oauth/index.js").OAuthCredentials>;
+    readonly callbackPort: 8080;
+    readonly pasteCodeFlow: true;
+} | {
+    readonly id: "gmi-cloud";
+    readonly name: "GMI Cloud";
+    readonly login: (cb: import("./oauth/index.js").OAuthLoginCallbacks) => Promise<string>;
+} | {
+    readonly id: "google";
+    readonly name: "Google Gemini";
+} | {
+    readonly id: "google-antigravity";
+    readonly name: "Antigravity (Gemini 3, Claude, GPT-OSS)";
+    readonly login: (cb: import("./oauth/index.js").OAuthLoginCallbacks) => Promise<import("./oauth/index.js").OAuthCredentials>;
+    readonly refreshToken: (credentials: import("./oauth/index.js").OAuthCredentials) => Promise<import("./oauth/index.js").OAuthCredentials>;
+    readonly callbackPort: 51121;
+    readonly pasteCodeFlow: true;
+} | {
+    readonly id: "google-gemini-cli";
+    readonly name: "Google Cloud Code Assist (Gemini CLI)";
+    readonly login: (cb: import("./oauth/index.js").OAuthLoginCallbacks) => Promise<import("./oauth/index.js").OAuthCredentials>;
+    readonly refreshToken: (credentials: import("./oauth/index.js").OAuthCredentials) => Promise<import("./oauth/index.js").OAuthCredentials>;
+    readonly callbackPort: 8085;
+    readonly pasteCodeFlow: true;
+} | {
+    readonly id: "google-vertex";
+    readonly name: "Google Vertex AI";
+    readonly envKeys: () => string | undefined;
+} | {
+    readonly id: "groq";
+    readonly name: "Groq";
+} | {
+    readonly id: "huggingface";
+    readonly name: "Hugging Face Inference";
+    readonly login: (cb: import("./oauth/index.js").OAuthLoginCallbacks) => Promise<string>;
+} | {
+    readonly id: "kagi";
+    readonly name: "Kagi";
+    readonly envKeys: "KAGI_API_KEY";
+    readonly login: (cb: import("./oauth/index.js").OAuthLoginCallbacks) => Promise<string>;
+} | {
+    readonly id: "kilo";
+    readonly name: "Kilo Gateway";
+    readonly login: typeof import("./kilo.js").loginKilo;
+} | {
+    readonly id: "kimi-code";
+    readonly name: "Kimi Code";
+    readonly login: (cb: import("./oauth/index.js").OAuthLoginCallbacks) => Promise<import("./oauth/index.js").OAuthCredentials>;
+    readonly refreshToken: (credentials: import("./oauth/index.js").OAuthCredentials) => Promise<import("./oauth/index.js").OAuthCredentials>;
+} | {
+    readonly id: "litellm";
+    readonly name: "LiteLLM";
+    readonly login: (cb: import("./oauth/index.js").OAuthLoginCallbacks) => Promise<string>;
+} | {
+    readonly id: "llama.cpp";
+    readonly name: "llama.cpp (Local OpenAI-compatible)";
+    readonly envKeys: "LLAMA_CPP_API_KEY";
+    readonly login: (cb: import("./oauth/index.js").OAuthLoginCallbacks) => Promise<string>;
+} | {
+    readonly id: "lm-studio";
+    readonly name: "LM Studio (Local OpenAI-compatible)";
+    readonly login: (cb: import("./oauth/index.js").OAuthLoginCallbacks) => Promise<string>;
+} | {
+    readonly id: "meta";
+    readonly name: "Meta Model API";
+    readonly login: (cb: import("./oauth/index.js").OAuthLoginCallbacks) => Promise<string>;
+} | {
+    readonly id: "minimax";
+    readonly name: "MiniMax";
+} | {
+    readonly id: "minimax-code";
+    readonly name: "MiniMax Token Plan (International)";
+    readonly login: (cb: import("./oauth/index.js").OAuthLoginCallbacks) => Promise<string>;
+} | {
+    readonly id: "minimax-code-cn";
+    readonly name: "MiniMax Token Plan (China)";
+    readonly login: (cb: import("./oauth/index.js").OAuthLoginCallbacks) => Promise<string>;
+} | {
+    readonly id: "mistral";
+    readonly name: "Mistral";
+} | {
+    readonly id: "moonshot";
+    readonly name: "Moonshot (Kimi API)";
+    readonly login: (cb: import("./oauth/index.js").OAuthLoginCallbacks) => Promise<string>;
+} | {
+    readonly id: "nanogpt";
+    readonly name: "NanoGPT";
+    readonly login: (cb: import("./oauth/index.js").OAuthLoginCallbacks) => Promise<string>;
+} | {
+    id: "novita";
+    name: string;
+    login: (options: import("./oauth/index.js").OAuthController) => Promise<string>;
+} | {
+    readonly id: "nvidia";
+    readonly name: "NVIDIA";
+    readonly login: (cb: import("./oauth/index.js").OAuthLoginCallbacks) => Promise<string>;
+} | {
+    readonly id: "ollama";
+    readonly name: "Ollama (Local OpenAI-compatible)";
+    readonly login: typeof import("./ollama.js").loginOllama;
+} | {
+    readonly id: "ollama-cloud";
+    readonly name: "Ollama Cloud";
+    readonly login: (cb: import("./oauth/index.js").OAuthLoginCallbacks) => Promise<string>;
+} | {
+    readonly id: "openai";
+    readonly name: "OpenAI";
+} | {
+    readonly id: "openai-codex";
+    readonly name: "ChatGPT Plus/Pro (Codex Subscription)";
+    readonly login: (cb: import("./oauth/index.js").OAuthLoginCallbacks) => Promise<import("./oauth/index.js").OAuthCredentials>;
+    readonly refreshToken: (credentials: import("./oauth/index.js").OAuthCredentials) => Promise<import("./oauth/index.js").OAuthCredentials>;
+    readonly callbackPort: 1455;
+    readonly pasteCodeFlow: true;
+} | {
+    readonly id: "openai-codex-device";
+    readonly name: "ChatGPT Plus/Pro (Codex, headless/device)";
+    readonly login: (cb: import("./oauth/index.js").OAuthLoginCallbacks) => Promise<import("./oauth/index.js").OAuthCredentials>;
+    readonly refreshToken: (credentials: import("./oauth/index.js").OAuthCredentials) => Promise<import("./oauth/index.js").OAuthCredentials>;
+    readonly storeCredentialsAs: "openai-codex";
+} | {
+    readonly id: "opencode-go";
+    readonly name: "OpenCode Go";
+    readonly login: (cb: import("./oauth/index.js").OAuthLoginCallbacks) => Promise<string>;
+} | {
+    readonly id: "opencode-zen";
+    readonly name: "OpenCode Zen";
+    readonly login: (cb: import("./oauth/index.js").OAuthLoginCallbacks) => Promise<string>;
+} | {
+    readonly id: "openrouter";
+    readonly name: "OpenRouter";
+    readonly login: (cb: import("./oauth/index.js").OAuthLoginCallbacks) => Promise<string>;
+} | {
+    readonly id: "parallel";
+    readonly name: "Parallel";
+    readonly envKeys: "PARALLEL_API_KEY";
+    readonly login: (cb: import("./oauth/index.js").OAuthLoginCallbacks) => Promise<string>;
+} | {
+    readonly id: "perplexity";
+    readonly name: "Perplexity (Pro/Max)";
+    readonly envKeys: "PERPLEXITY_API_KEY";
+    readonly login: (cb: import("./oauth/index.js").OAuthLoginCallbacks) => Promise<import("./oauth/index.js").OAuthCredentials>;
+} | {
+    readonly id: "qianfan";
+    readonly name: "Qianfan";
+    readonly login: (cb: import("./oauth/index.js").OAuthLoginCallbacks) => Promise<string>;
+} | {
+    readonly id: "qwen-portal";
+    readonly name: "Qwen Portal";
+    readonly login: (cb: import("./oauth/index.js").OAuthLoginCallbacks) => Promise<string>;
+} | {
+    readonly id: "sakana";
+    readonly name: "Sakana AI";
+    readonly login: (cb: import("./oauth/index.js").OAuthLoginCallbacks) => Promise<string>;
+} | {
+    readonly id: "siliconflow";
+    readonly name: "SiliconFlow";
+    readonly login: (cb: import("./oauth/index.js").OAuthLoginCallbacks) => Promise<string>;
+} | {
+    readonly id: "siliconflow-cn";
+    readonly name: "SiliconFlow (China)";
+    readonly login: (cb: import("./oauth/index.js").OAuthLoginCallbacks) => Promise<string>;
+} | {
+    readonly id: "synthetic";
+    readonly name: "Synthetic";
+    readonly login: (options: import("./oauth/index.js").OAuthController) => Promise<string>;
+} | {
+    readonly id: "tavily";
+    readonly name: "Tavily";
+    readonly envKeys: "TAVILY_API_KEY";
+    readonly login: (cb: import("./oauth/index.js").OAuthLoginCallbacks) => Promise<string>;
+} | {
+    readonly id: "together";
+    readonly name: "Together";
+    readonly login: (cb: Parameters<typeof import("./together.js").loginTogether>[0]) => Promise<string>;
+} | {
+    readonly id: "umans";
+    readonly name: "Umans AI Coding Plan";
+    readonly login: (cb: import("./oauth/index.js").OAuthLoginCallbacks) => Promise<string>;
+} | {
+    readonly id: "venice";
+    readonly name: "Venice";
+    readonly login: (cb: import("./oauth/index.js").OAuthLoginCallbacks) => Promise<string>;
+} | {
+    readonly id: "vercel-ai-gateway";
+    readonly name: "Vercel AI Gateway";
+    readonly login: (cb: import("./oauth/index.js").OAuthLoginCallbacks) => Promise<string>;
+} | {
+    readonly id: "vllm";
+    readonly name: "vLLM (Local OpenAI-compatible)";
+    readonly login: (cb: import("./oauth/index.js").OAuthLoginCallbacks) => Promise<string>;
+} | {
+    readonly id: "wafer-serverless";
+    readonly name: "Wafer Serverless (pay-as-you-go)";
+    readonly login: (cb: import("./oauth/index.js").OAuthLoginCallbacks) => Promise<string>;
+} | {
+    readonly id: "xai";
+    readonly name: "xAI API";
+    readonly login: (cb: import("./oauth/index.js").OAuthLoginCallbacks) => Promise<string>;
+} | {
+    readonly id: "xai-oauth";
+    readonly name: "xAI Grok OAuth (SuperGrok or X Premium+)";
+    readonly login: (cb: import("./oauth/index.js").OAuthLoginCallbacks) => Promise<import("./oauth/index.js").OAuthCredentials>;
+    readonly refreshToken: (credentials: import("./oauth/index.js").OAuthCredentials) => Promise<import("./oauth/index.js").OAuthCredentials>;
+} | {
+    readonly id: "xiaomi";
+    readonly name: "Xiaomi MiMo";
+    readonly login: (cb: import("./oauth/index.js").OAuthLoginCallbacks) => Promise<string>;
+} | {
+    readonly id: "xiaomi-token-plan-ams";
+    readonly name: "Xiaomi Token Plan (Europe)";
+    readonly login: (cb: import("./oauth/index.js").OAuthLoginCallbacks) => Promise<string>;
+} | {
+    readonly id: "xiaomi-token-plan-cn";
+    readonly name: "Xiaomi Token Plan (China)";
+    readonly login: (cb: import("./oauth/index.js").OAuthLoginCallbacks) => Promise<string>;
+} | {
+    readonly id: "xiaomi-token-plan-sgp";
+    readonly name: "Xiaomi Token Plan (Singapore)";
+    readonly login: (cb: import("./oauth/index.js").OAuthLoginCallbacks) => Promise<string>;
+} | {
+    readonly id: "zai";
+    readonly name: "Z.AI (GLM Coding Plan)";
+    readonly login: (cb: import("./oauth/index.js").OAuthLoginCallbacks) => Promise<string>;
+} | {
+    readonly id: "zai-coding-plan";
+    readonly name: "Z.AI (GLM Coding Plan · Sign in)";
+    readonly storeCredentialsAs: "zai";
+    readonly callbackPort: 54548;
+    readonly pasteCodeFlow: true;
+    readonly login: (cb: import("./oauth/index.js").OAuthLoginCallbacks) => Promise<string | import("./oauth/index.js").OAuthCredentials>;
+} | {
+    readonly id: "zenmux";
+    readonly name: "ZenMux";
+    readonly login: (cb: import("./oauth/index.js").OAuthLoginCallbacks) => Promise<string>;
+} | {
+    readonly id: "zhipu-coding-plan";
+    readonly name: "Zhipu Coding Plan (智谱)";
+    readonly login: (cb: import("./oauth/index.js").OAuthLoginCallbacks) => Promise<string>;
+})[];
+export type RegistryDef = (typeof ALL)[number];
+export declare const PROVIDER_REGISTRY: readonly ProviderDefinition[];
+export declare function getProviderDefinition(id: string): ProviderDefinition | undefined;
+/** Loginable providers (those carrying a `login` flow). */
+export type OAuthProviderUnion = Extract<RegistryDef, {
+    login: object;
+}>["id"];
+export {};

package/dist/types/registry/sakana.d.ts

@@ -0,0 +1,7 @@
+import type { OAuthLoginCallbacks } from "./oauth/types.js";
+export declare const loginSakana: (options: import("./oauth/index.js").OAuthController) => Promise<string>;
+export declare const sakanaProvider: {
+    readonly id: "sakana";
+    readonly name: "Sakana AI";
+    readonly login: (cb: OAuthLoginCallbacks) => Promise<string>;
+};

package/dist/types/registry/siliconflow-cn.d.ts

@@ -0,0 +1,7 @@
+import type { OAuthLoginCallbacks } from "./oauth/types.js";
+export declare const loginSiliconFlowCn: (options: import("./oauth/index.js").OAuthController) => Promise<string>;
+export declare const siliconflowCnProvider: {
+    readonly id: "siliconflow-cn";
+    readonly name: "SiliconFlow (China)";
+    readonly login: (cb: OAuthLoginCallbacks) => Promise<string>;
+};

package/dist/types/registry/siliconflow.d.ts

@@ -0,0 +1,7 @@
+import type { OAuthLoginCallbacks } from "./oauth/types.js";
+export declare const loginSiliconFlow: (options: import("./oauth/index.js").OAuthController) => Promise<string>;
+export declare const siliconflowProvider: {
+    readonly id: "siliconflow";
+    readonly name: "SiliconFlow";
+    readonly login: (cb: OAuthLoginCallbacks) => Promise<string>;
+};

package/dist/types/registry/synthetic.d.ts

@@ -0,0 +1,6 @@
+export declare const loginSynthetic: (options: import("./oauth/index.js").OAuthController) => Promise<string>;
+export declare const syntheticProvider: {
+    readonly id: "synthetic";
+    readonly name: "Synthetic";
+    readonly login: (options: import("./oauth/index.js").OAuthController) => Promise<string>;
+};

package/dist/types/registry/tavily.d.ts

@@ -0,0 +1,14 @@
+import type { OAuthLoginCallbacks } from "./oauth/types.js";
+/**
+ * Login to Tavily.
+ *
+ * Opens browser to API keys page and prompts user to paste their API key.
+ * Returns the API key directly (not OAuthCredentials - this isn't OAuth).
+ */
+export declare function loginTavily(options: OAuthLoginCallbacks): Promise<string>;
+export declare const tavilyProvider: {
+    readonly id: "tavily";
+    readonly name: "Tavily";
+    readonly envKeys: "TAVILY_API_KEY";
+    readonly login: (cb: OAuthLoginCallbacks) => Promise<string>;
+};

package/dist/types/registry/together.d.ts

@@ -0,0 +1,6 @@
+export declare const loginTogether: (options: import("./oauth/index.js").OAuthController) => Promise<string>;
+export declare const togetherProvider: {
+    readonly id: "together";
+    readonly name: "Together";
+    readonly login: (cb: Parameters<typeof loginTogether>[0]) => Promise<string>;
+};

package/dist/types/registry/types.d.ts

@@ -0,0 +1,75 @@
+/**
+ * Single-source provider auth model. Every provider — model providers,
+ * gateways, search/tool credentials, and login-only flows — is described by
+ * one {@link ProviderDefinition}. The legacy scattered structures (the
+ * `OAuthProvider` union, `serviceProviderMap`, `builtInOAuthProviders`, the
+ * refresh/login switches, and the CLI callback maps) are all *derived* from
+ * the registry of these definitions. Adding a provider is one new file in
+ * `./providers/` plus one line in `./registry.ts`. Model-catalog metadata
+ * (default model, model-manager factory, catalog discovery) lives in
+ * `@linxiraos/pi-catalog`'s descriptor table.
+ */
+import type { Api, FetchImpl, Model, SimpleStreamOptions, StreamOptions } from "../types.js";
+import type { OAuthCredentials, OAuthLoginCallbacks } from "./oauth/types.js";
+/**
+ * API-key environment fallback: either a single env var name (e.g.
+ * `"OPENAI_API_KEY"`) or a resolver that inspects several env vars / probes
+ * the host (Vertex ADC, Bedrock credential chains, …).
+ */
+export type KeyResolver = string | (() => string | undefined);
+/** Credentials are resolved by the provider transport rather than used as a bearer string. */
+export declare const AUTHENTICATED_SENTINEL = "<authenticated>";
+export interface PreparedProviderRequest {
+    readonly model: Model<Api>;
+    readonly options: StreamOptions;
+}
+export type ProviderRequestPreparer = (model: Model<Api>, options: StreamOptions) => PreparedProviderRequest;
+export type ProviderSimpleOptionsMapper = (options: SimpleStreamOptions) => Readonly<Record<string, unknown>>;
+export interface ProviderModelDiscoveryConfig {
+    readonly apiKey?: string;
+    readonly baseUrl?: string;
+    readonly fetch?: FetchImpl;
+    readonly authenticated?: boolean;
+}
+export type ProviderModelDiscoveryPreparer = (config: ProviderModelDiscoveryConfig) => ProviderModelDiscoveryConfig;
+/**
+ * Declarative description of a single provider's auth/login wiring. All
+ * fields are optional except `id`/`name`; presence of a field opts the
+ * provider into a derived structure:
+ *
+ * - `envKeys` present ⇒ env-var fallback in `getEnvApiKey`, overriding the
+ *   catalog table's `envVars` for that provider.
+ * - `login` present ⇒ member of `OAuthProvider`, shown in the `/login` list
+ *   (unless `showInLoginList === false`) and dispatchable via `AuthStorage.login`.
+ * - `callbackPort` present ⇒ entry in the auth-broker `CALLBACK_PORTS` map.
+ * - `pasteCodeFlow` ⇒ member of `PASTE_CODE_LOGIN_PROVIDERS`.
+ *
+ * Heavy OAuth flow modules MUST be reached through dynamic-import thunks in
+ * `login`/`refreshToken` so they stay out of the eager startup graph.
+ */
+export interface ProviderDefinition {
+    readonly id: string;
+    readonly name: string;
+    /** Login-list availability flag. Defaults to true when shown. */
+    readonly available?: boolean;
+    /** Whether to surface in the interactive login list. Defaults to true when `login` is present. */
+    readonly showInLoginList?: boolean;
+    readonly envKeys?: KeyResolver;
+    /** Provider transport can authenticate without a resolved API-key string. */
+    readonly allowsMissingApiKey?: boolean;
+    /** Provider-owned request shaping applied before generic API dispatch. */
+    readonly prepareRequest?: ProviderRequestPreparer;
+    /** Provider-owned projection from the generic simple-stream option bag. */
+    readonly mapSimpleOptions?: ProviderSimpleOptionsMapper;
+    /** Provider-owned authentication and endpoint setup for model discovery. */
+    readonly prepareModelDiscovery?: ProviderModelDiscoveryPreparer;
+    readonly login?: (callbacks: OAuthLoginCallbacks) => Promise<OAuthCredentials | string>;
+    readonly refreshToken?: (credentials: OAuthCredentials) => Promise<OAuthCredentials>;
+    readonly getApiKey?: (credentials: OAuthCredentials) => string;
+    /** Store OAuth credentials under a different provider id (e.g. `openai-codex-device` ⇒ `openai-codex`). */
+    readonly storeCredentialsAs?: string;
+    /** Auth-broker local callback-server port. Presence ⇒ entry in `CALLBACK_PORTS`. */
+    readonly callbackPort?: number;
+    /** OAuth flow needs a pasted code/redirect URL rather than a callback server. */
+    readonly pasteCodeFlow?: boolean;
+}

package/dist/types/registry/umans.d.ts

@@ -0,0 +1,7 @@
+import type { OAuthLoginCallbacks } from "./oauth/types.js";
+export declare const loginUmans: (options: import("./oauth/index.js").OAuthController) => Promise<string>;
+export declare const umansProvider: {
+    readonly id: "umans";
+    readonly name: "Umans AI Coding Plan";
+    readonly login: (cb: OAuthLoginCallbacks) => Promise<string>;
+};

package/dist/types/registry/venice.d.ts

@@ -0,0 +1,13 @@
+import type { OAuthLoginCallbacks } from "./oauth/types.js";
+/**
+ * Login to Venice.
+ *
+ * Opens browser to API keys page, prompts user to paste their API key.
+ * Returns the API key directly (not OAuthCredentials - this isn't OAuth).
+ */
+export declare const loginVenice: (options: import("./oauth/index.js").OAuthController) => Promise<string>;
+export declare const veniceProvider: {
+    readonly id: "venice";
+    readonly name: "Venice";
+    readonly login: (cb: OAuthLoginCallbacks) => Promise<string>;
+};

package/dist/types/registry/vercel-ai-gateway.d.ts

@@ -0,0 +1,7 @@
+import type { OAuthController, OAuthLoginCallbacks } from "./oauth/types.js";
+export declare function loginVercelAiGateway(options: OAuthController): Promise<string>;
+export declare const vercelAiGatewayProvider: {
+    readonly id: "vercel-ai-gateway";
+    readonly name: "Vercel AI Gateway";
+    readonly login: (cb: OAuthLoginCallbacks) => Promise<string>;
+};

package/dist/types/registry/vllm.d.ts

@@ -0,0 +1,7 @@
+import type { OAuthController, OAuthLoginCallbacks } from "./oauth/types.js";
+export declare function loginVllm(options: OAuthController): Promise<string>;
+export declare const vllmProvider: {
+    readonly id: "vllm";
+    readonly name: "vLLM (Local OpenAI-compatible)";
+    readonly login: (cb: OAuthLoginCallbacks) => Promise<string>;
+};

package/dist/types/registry/wafer-serverless.d.ts

@@ -0,0 +1,6 @@
+import type { OAuthLoginCallbacks } from "./oauth/types.js";
+export declare const waferServerlessProvider: {
+    readonly id: "wafer-serverless";
+    readonly name: "Wafer Serverless (pay-as-you-go)";
+    readonly login: (cb: OAuthLoginCallbacks) => Promise<string>;
+};

package/dist/types/registry/xai-oauth.d.ts

@@ -0,0 +1,7 @@
+import type { OAuthCredentials, OAuthLoginCallbacks } from "./oauth/types.js";
+export declare const xaiOauthProvider: {
+    readonly id: "xai-oauth";
+    readonly name: "xAI Grok OAuth (SuperGrok or X Premium+)";
+    readonly login: (cb: OAuthLoginCallbacks) => Promise<OAuthCredentials>;
+    readonly refreshToken: (credentials: OAuthCredentials) => Promise<OAuthCredentials>;
+};

package/dist/types/registry/xai.d.ts

@@ -0,0 +1,7 @@
+import type { OAuthLoginCallbacks } from "./oauth/types.js";
+export declare const loginXAI: (options: import("./oauth/index.js").OAuthController) => Promise<string>;
+export declare const xaiProvider: {
+    readonly id: "xai";
+    readonly name: "xAI API";
+    readonly login: (cb: OAuthLoginCallbacks) => Promise<string>;
+};

package/dist/types/registry/xiaomi-token-plan-ams.d.ts

@@ -0,0 +1,6 @@
+import type { OAuthLoginCallbacks } from "./oauth/types.js";
+export declare const xiaomiTokenPlanAmsProvider: {
+    readonly id: "xiaomi-token-plan-ams";
+    readonly name: "Xiaomi Token Plan (Europe)";
+    readonly login: (cb: OAuthLoginCallbacks) => Promise<string>;
+};

package/dist/types/registry/xiaomi-token-plan-cn.d.ts

@@ -0,0 +1,6 @@
+import type { OAuthLoginCallbacks } from "./oauth/types.js";
+export declare const xiaomiTokenPlanCnProvider: {
+    readonly id: "xiaomi-token-plan-cn";
+    readonly name: "Xiaomi Token Plan (China)";
+    readonly login: (cb: OAuthLoginCallbacks) => Promise<string>;
+};

package/dist/types/registry/xiaomi-token-plan-sgp.d.ts

@@ -0,0 +1,6 @@
+import type { OAuthLoginCallbacks } from "./oauth/types.js";
+export declare const xiaomiTokenPlanSgpProvider: {
+    readonly id: "xiaomi-token-plan-sgp";
+    readonly name: "Xiaomi Token Plan (Singapore)";
+    readonly login: (cb: OAuthLoginCallbacks) => Promise<string>;
+};

package/dist/types/registry/xiaomi.d.ts

@@ -0,0 +1,6 @@
+import type { OAuthLoginCallbacks } from "./oauth/types.js";
+export declare const xiaomiProvider: {
+    readonly id: "xiaomi";
+    readonly name: "Xiaomi MiMo";
+    readonly login: (cb: OAuthLoginCallbacks) => Promise<string>;
+};

package/dist/types/registry/zai.d.ts

@@ -0,0 +1,15 @@
+import type { OAuthLoginCallbacks } from "./oauth/types.js";
+export declare const loginZai: (options: import("./oauth/index.js").OAuthController) => Promise<string>;
+export declare const zaiProvider: {
+    readonly id: "zai";
+    readonly name: "Z.AI (GLM Coding Plan)";
+    readonly login: (cb: OAuthLoginCallbacks) => Promise<string>;
+};
+export declare const zaiCodingPlanProvider: {
+    readonly id: "zai-coding-plan";
+    readonly name: "Z.AI (GLM Coding Plan · Sign in)";
+    readonly storeCredentialsAs: "zai";
+    readonly callbackPort: 54548;
+    readonly pasteCodeFlow: true;
+    readonly login: (cb: OAuthLoginCallbacks) => Promise<string | import("./oauth/index.js").OAuthCredentials>;
+};

package/dist/types/registry/zenmux.d.ts

@@ -0,0 +1,7 @@
+import type { OAuthLoginCallbacks } from "./oauth/types.js";
+export declare const loginZenMux: (options: import("./oauth/index.js").OAuthController) => Promise<string>;
+export declare const zenmuxProvider: {
+    readonly id: "zenmux";
+    readonly name: "ZenMux";
+    readonly login: (cb: OAuthLoginCallbacks) => Promise<string>;
+};

package/dist/types/registry/zhipu-coding-plan.d.ts

@@ -0,0 +1,7 @@
+import type { OAuthLoginCallbacks } from "./oauth/types.js";
+export declare const loginZhipuCodingPlan: (options: import("./oauth/index.js").OAuthController) => Promise<string>;
+export declare const zhipuCodingPlanProvider: {
+    readonly id: "zhipu-coding-plan";
+    readonly name: "Zhipu Coding Plan (智谱)";
+    readonly login: (cb: OAuthLoginCallbacks) => Promise<string>;
+};