@providerkit/core 0.6.0 → 0.7.0

package/dist/index.d.ts

@@ -11,9 +11,11 @@ export * from "./tools.ts";
 export * from "./schema.ts";
 export * from "./context.ts";
 export * from "./capability.ts";
+export * from "./presets.ts";
 export * from "./providers/anthropic.ts";
 export * from "./providers/openai.ts";
 export * from "./providers/responses.ts";
 export * from "./providers/gemini.ts";
 export * from "./providers/zai.ts";
+export * from "./providers/factory.ts";
 //# sourceMappingURL=index.d.ts.map

package/dist/index.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA,cAAc,YAAY,CAAC;AAC3B,cAAc,aAAa,CAAC;AAC5B,cAAc,YAAY,CAAC;AAC3B,cAAc,eAAe,CAAC;AAC9B,cAAc,eAAe,CAAC;AAC9B,cAAc,YAAY,CAAC;AAC3B,cAAc,gBAAgB,CAAC;AAC/B,cAAc,iBAAiB,CAAC;AAChC,cAAc,gBAAgB,CAAC;AAC/B,cAAc,YAAY,CAAC;AAC3B,cAAc,aAAa,CAAC;AAC5B,cAAc,cAAc,CAAC;AAC7B,cAAc,iBAAiB,CAAC;AAChC,cAAc,0BAA0B,CAAC;AACzC,cAAc,uBAAuB,CAAC;AACtC,cAAc,0BAA0B,CAAC;AACzC,cAAc,uBAAuB,CAAC;AACtC,cAAc,oBAAoB,CAAC"}
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA,cAAc,YAAY,CAAC;AAC3B,cAAc,aAAa,CAAC;AAC5B,cAAc,YAAY,CAAC;AAC3B,cAAc,eAAe,CAAC;AAC9B,cAAc,eAAe,CAAC;AAC9B,cAAc,YAAY,CAAC;AAC3B,cAAc,gBAAgB,CAAC;AAC/B,cAAc,iBAAiB,CAAC;AAChC,cAAc,gBAAgB,CAAC;AAC/B,cAAc,YAAY,CAAC;AAC3B,cAAc,aAAa,CAAC;AAC5B,cAAc,cAAc,CAAC;AAC7B,cAAc,iBAAiB,CAAC;AAChC,cAAc,cAAc,CAAC;AAC7B,cAAc,0BAA0B,CAAC;AACzC,cAAc,uBAAuB,CAAC;AACtC,cAAc,0BAA0B,CAAC;AACzC,cAAc,uBAAuB,CAAC;AACtC,cAAc,oBAAoB,CAAC;AACnC,cAAc,wBAAwB,CAAC"}

package/dist/index.js

@@ -11,9 +11,11 @@ export * from "./tools.js";
 export * from "./schema.js";
 export * from "./context.js";
 export * from "./capability.js";
+export * from "./presets.js";
 export * from "./providers/anthropic.js";
 export * from "./providers/openai.js";
 export * from "./providers/responses.js";
 export * from "./providers/gemini.js";
 export * from "./providers/zai.js";
+export * from "./providers/factory.js";
 //# sourceMappingURL=index.js.map

package/dist/index.js.map

@@ -1 +1 @@
-{"version":3,"file":"index.js","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA,cAAc,YAAY,CAAC;AAC3B,cAAc,aAAa,CAAC;AAC5B,cAAc,YAAY,CAAC;AAC3B,cAAc,eAAe,CAAC;AAC9B,cAAc,eAAe,CAAC;AAC9B,cAAc,YAAY,CAAC;AAC3B,cAAc,gBAAgB,CAAC;AAC/B,cAAc,iBAAiB,CAAC;AAChC,cAAc,gBAAgB,CAAC;AAC/B,cAAc,YAAY,CAAC;AAC3B,cAAc,aAAa,CAAC;AAC5B,cAAc,cAAc,CAAC;AAC7B,cAAc,iBAAiB,CAAC;AAChC,cAAc,0BAA0B,CAAC;AACzC,cAAc,uBAAuB,CAAC;AACtC,cAAc,0BAA0B,CAAC;AACzC,cAAc,uBAAuB,CAAC;AACtC,cAAc,oBAAoB,CAAC"}
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA,cAAc,YAAY,CAAC;AAC3B,cAAc,aAAa,CAAC;AAC5B,cAAc,YAAY,CAAC;AAC3B,cAAc,eAAe,CAAC;AAC9B,cAAc,eAAe,CAAC;AAC9B,cAAc,YAAY,CAAC;AAC3B,cAAc,gBAAgB,CAAC;AAC/B,cAAc,iBAAiB,CAAC;AAChC,cAAc,gBAAgB,CAAC;AAC/B,cAAc,YAAY,CAAC;AAC3B,cAAc,aAAa,CAAC;AAC5B,cAAc,cAAc,CAAC;AAC7B,cAAc,iBAAiB,CAAC;AAChC,cAAc,cAAc,CAAC;AAC7B,cAAc,0BAA0B,CAAC;AACzC,cAAc,uBAAuB,CAAC;AACtC,cAAc,0BAA0B,CAAC;AACzC,cAAc,uBAAuB,CAAC;AACtC,cAAc,oBAAoB,CAAC;AACnC,cAAc,wBAAwB,CAAC"}

package/dist/presets.d.ts

@@ -0,0 +1,249 @@
+/**
+ * Provider presets — hand-curated, wire-level facts only.
+ *
+ * A preset is everything `createPresetProvider` needs to speak to one
+ * endpoint: which adapter shape it speaks, its API root, how the credential
+ * rides, and what it is called. Deliberately absent: prices (invariant 9 —
+ * they drift on a vendor's schedule and a wrong number in a library is a
+ * wrong number in everyone's ledger), icons, colors, marketing names, and
+ * sign-in flows (an `oauth` preset expects the CALLER to hand over an access
+ * token; acquiring one stays app-side).
+ *
+ * Sources: the coding-plan endpoints and auth quirks are measured
+ * (tabrunner's extension + this repo's adopters, 2026-09); the model lists
+ * are representative, not exhaustive — every adapter takes a per-call model,
+ * so a missing id costs nothing.
+ *
+ * Azure is deliberately ABSENT: its base URL is per-deployment
+ * (`https://<resource>.openai.azure.com`), so no static preset can carry it —
+ * point createOpenAIProvider's baseUrl at your resource instead.
+ */
+export type PresetShape = "anthropic" | "openai" | "responses" | "gemini";
+/**
+ * How the credential reaches the endpoint.
+ * - `key`: the vendor's native key header (Anthropic reads `x-api-key`,
+ *   Gemini `x-goog-api-key`); the OpenAI shapes have only Bearer, so they
+ *   never use this.
+ * - `bearer`: `Authorization: Bearer` — the OpenAI shapes' only mode, and the
+ *   coding-plan gateways' mode on the Anthropic wire (measured: Z.ai's coding
+ *   endpoint ignores `x-api-key` and reads Bearer).
+ * - `oauth`: same wire as `bearer`, but the token is a short-lived access
+ *   token from a sign-in flow the caller owns. The preset may carry the beta
+ *   headers that switch the endpoint into OAuth mode.
+ */
+export type PresetAuth = "key" | "bearer" | "oauth";
+export interface ProviderPreset {
+    /** Adapter wire format. */
+    shape: PresetShape;
+    /** API root — the adapter appends its own path (/v1/chat/completions,
+     *  /v1/messages, …), so this must NOT carry the version. */
+    baseUrl: string;
+    auth: PresetAuth;
+    /** Fallback when the caller passes no model. */
+    defaultModel?: string;
+    /** Representative model ids. */
+    models?: string[];
+    /** Static protocol headers the endpoint requires (e.g. OAuth beta flags).
+     *  Per-request headers (request ids, account ids) are the caller's. */
+    headers?: Record<string, string>;
+    /** True when the endpoint hard-400s image parts (measured on DeepSeek). */
+    textOnly?: boolean;
+    /** Anthropic-shape dialect: say "no thinking" with an explicit
+     *  `thinking: { type: "disabled" }` marker when effort is none. For
+     *  endpoints where an ABSENT field means the model's default — thinking ON
+     *  for reasoning-mandatory models (measured on Z.ai's coding endpoint:
+     *  omit → thinking block; disabled → none). Native Anthropic defaults to
+     *  off when the field is absent and must stay unset. */
+    explicitNone?: boolean;
+}
+export declare const PROVIDER_PRESETS: {
+    readonly anthropic: {
+        readonly shape: "anthropic";
+        readonly baseUrl: "https://api.anthropic.com";
+        readonly auth: "key";
+        readonly defaultModel: "claude-sonnet-4-6";
+        readonly models: ["claude-sonnet-4-6", "claude-opus-5", "claude-fable-5-1"];
+    };
+    readonly openai: {
+        readonly shape: "openai";
+        readonly baseUrl: "https://api.openai.com";
+        readonly auth: "key";
+        readonly defaultModel: "gpt-5.6-sol";
+        readonly models: ["gpt-5.6-sol", "gpt-5-pro", "gpt-5-nano"];
+    };
+    readonly google: {
+        readonly shape: "gemini";
+        readonly baseUrl: "https://generativelanguage.googleapis.com";
+        readonly auth: "key";
+        readonly defaultModel: "gemini-3.1-pro";
+        readonly models: ["gemini-3.1-pro", "gemini-2.5-flash"];
+    };
+    /** Gemini behind its OpenAI-compatible route — the drop-in for codebases
+     *  that only speak the openai shape. */
+    readonly "google-openai": {
+        readonly shape: "openai";
+        readonly baseUrl: "https://generativelanguage.googleapis.com/v1beta/openai";
+        readonly auth: "key";
+        readonly defaultModel: "gemini-3.1-pro";
+        readonly models: ["gemini-3.1-pro", "gemini-2.5-flash"];
+    };
+    readonly deepseek: {
+        readonly shape: "openai";
+        readonly baseUrl: "https://api.deepseek.com";
+        readonly auth: "key";
+        readonly defaultModel: "deepseek-v4-flash";
+        readonly models: ["deepseek-v4-flash", "deepseek-v4-pro", "deepseek-flash"];
+        readonly textOnly: true;
+    };
+    readonly openrouter: {
+        readonly shape: "openai";
+        readonly baseUrl: "https://openrouter.ai/api";
+        readonly auth: "key";
+        readonly defaultModel: "deepseek/deepseek-v4.1-flash";
+        readonly models: ["deepseek/deepseek-v4.1-flash", "z-ai/glm-5.3-flash", "qwen/qwen3.7-max"];
+    };
+    readonly groq: {
+        readonly shape: "openai";
+        readonly baseUrl: "https://api.groq.com/openai/v1";
+        readonly auth: "key";
+        readonly defaultModel: "llama-3.3-70b-versatile";
+        readonly models: ["llama-3.3-70b-versatile", "qwen/qwen3.8-27b"];
+    };
+    readonly mistral: {
+        readonly shape: "openai";
+        readonly baseUrl: "https://api.mistral.ai/v1";
+        readonly auth: "key";
+        readonly defaultModel: "devstral-2512";
+        readonly models: ["devstral-2512", "magistral-small", "mistral-small-2506"];
+    };
+    readonly xai: {
+        readonly shape: "openai";
+        readonly baseUrl: "https://api.x.ai/v1";
+        readonly auth: "key";
+        readonly defaultModel: "grok-4.5";
+        readonly models: ["grok-4.5", "grok-4.3", "grok-4.20-0309-reasoning"];
+    };
+    readonly together: {
+        readonly shape: "openai";
+        readonly baseUrl: "https://api.together.xyz/v1";
+        readonly auth: "key";
+        readonly defaultModel: "deepseek-ai/DeepSeek-V3";
+    };
+    readonly fireworks: {
+        readonly shape: "openai";
+        readonly baseUrl: "https://api.fireworks.ai/inference/v1";
+        readonly auth: "key";
+    };
+    readonly cerebras: {
+        readonly shape: "openai";
+        readonly baseUrl: "https://api.cerebras.ai/v1";
+        readonly auth: "key";
+        readonly defaultModel: "gpt-oss-120b";
+        readonly models: ["gpt-oss-120b", "qwen-3.8-27b"];
+    };
+    readonly moonshot: {
+        readonly shape: "openai";
+        readonly baseUrl: "https://api.moonshot.ai/v1";
+        readonly auth: "key";
+        readonly defaultModel: "kimi-k2.7-code";
+        readonly models: ["kimi-k2.7-code", "kimi-k2.7-code-highspeed", "kimi-k3"];
+    };
+    readonly zhipu: {
+        readonly shape: "openai";
+        readonly baseUrl: "https://api.z.ai/api/paas/v4";
+        readonly auth: "key";
+        readonly defaultModel: "glm-5.3-flash";
+        readonly models: ["glm-5.3-flash", "glm-5.2", "glm-4.7"];
+    };
+    readonly minimax: {
+        readonly shape: "anthropic";
+        readonly baseUrl: "https://api.minimax.io/anthropic";
+        readonly auth: "key";
+        readonly defaultModel: "MiniMax-M2.5";
+        readonly models: ["MiniMax-M3", "MiniMax-M2.5", "MiniMax-M2.1"];
+    };
+    readonly zai: {
+        readonly shape: "anthropic";
+        readonly baseUrl: "https://api.z.ai/api/anthropic";
+        readonly auth: "bearer";
+        readonly defaultModel: "glm-5.3-flash";
+        readonly models: ["glm-5.3-flash", "glm-5.3-highspeed", "glm-5.2", "glm-5-turbo"];
+        readonly explicitNone: true;
+    };
+    readonly kimi: {
+        readonly shape: "anthropic";
+        readonly baseUrl: "https://api.kimi.ai/coding";
+        readonly auth: "bearer";
+        readonly defaultModel: "kimi-for-coding";
+        readonly models: ["kimi-for-coding", "kimi-for-coding-highspeed", "k3"];
+    };
+    /** Alibaba's dashscope coding plan — OpenAI-compatible per its registry. */
+    readonly "alibaba-coding-plan": {
+        readonly shape: "openai";
+        readonly baseUrl: "https://coding-intl.dashscope.aliyuncs.com/v1";
+        readonly auth: "bearer";
+        readonly defaultModel: "qwen3.7-max";
+        readonly models: ["qwen3.7-max", "qwen3-coder-next", "glm-4.7"];
+    };
+    /** QwenCloud's token plan — Anthropic wire (measured by tabrunner). */
+    readonly qwen: {
+        readonly shape: "anthropic";
+        readonly baseUrl: "https://token-plan.ap-southeast-1.maas.aliyuncs.com/apps/anthropic";
+        readonly auth: "bearer";
+        readonly defaultModel: "qwen3.8-max";
+        readonly models: ["qwen3.8-max", "qwen3.6-flash"];
+    };
+    readonly ollama: {
+        readonly shape: "openai";
+        readonly baseUrl: "http://localhost:11434/v1";
+        readonly auth: "bearer";
+    };
+    readonly lmstudio: {
+        readonly shape: "openai";
+        readonly baseUrl: "http://127.0.0.1:1234/v1";
+        readonly auth: "bearer";
+    };
+    readonly vllm: {
+        readonly shape: "openai";
+        readonly baseUrl: "http://localhost:8000/v1";
+        readonly auth: "bearer";
+    };
+    readonly claude: {
+        readonly shape: "anthropic";
+        readonly baseUrl: "https://api.anthropic.com";
+        readonly auth: "oauth";
+        readonly defaultModel: "claude-sonnet-4-6";
+        readonly models: ["claude-sonnet-4-6", "claude-opus-5"];
+        readonly headers: {
+            readonly "anthropic-beta": "claude-code-20250219,oauth-2025-04-20";
+        };
+    };
+    /** The Codex backend behind a ChatGPT sign-in — Responses wire, no public
+     *  model list, so these ids are the list. */
+    readonly chatgpt: {
+        readonly shape: "responses";
+        readonly baseUrl: "https://chatgpt.com/backend-api/codex";
+        readonly auth: "oauth";
+        readonly defaultModel: "gpt-5.3-codex";
+        readonly models: ["gpt-5.3-codex", "gpt-5.5", "gpt-5.4-mini"];
+    };
+    /** Kimi's coding endpoint reached with a subscription token instead of a
+     *  key — Kimi bills the two separately. */
+    readonly "kimi-plan": {
+        readonly shape: "anthropic";
+        readonly baseUrl: "https://api.kimi.ai/coding";
+        readonly auth: "oauth";
+        readonly defaultModel: "kimi-for-coding";
+    };
+    readonly "github-copilot": {
+        readonly shape: "openai";
+        readonly baseUrl: "https://api.githubcopilot.com";
+        readonly auth: "oauth";
+        readonly defaultModel: "gpt-5.6-sol";
+        readonly models: ["gpt-5.6-sol", "claude-opus-5", "claude-opus-4.8", "kimi-k2.7-code"];
+    };
+};
+export type ProviderPresetId = keyof typeof PROVIDER_PRESETS;
+/** Every valid preset id — the factory's unknown-id error lists these. */
+export declare const PRESET_IDS: ProviderPresetId[];
+//# sourceMappingURL=presets.d.ts.map

package/dist/presets.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"presets.d.ts","sourceRoot":"","sources":["../src/presets.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;GAmBG;AACH,MAAM,MAAM,WAAW,GAAG,WAAW,GAAG,QAAQ,GAAG,WAAW,GAAG,QAAQ,CAAC;AAE1E;;;;;;;;;;;GAWG;AACH,MAAM,MAAM,UAAU,GAAG,KAAK,GAAG,QAAQ,GAAG,OAAO,CAAC;AAEpD,MAAM,WAAW,cAAc;IAC7B,2BAA2B;IAC3B,KAAK,EAAE,WAAW,CAAC;IACnB;gEAC4D;IAC5D,OAAO,EAAE,MAAM,CAAC;IAChB,IAAI,EAAE,UAAU,CAAC;IACjB,gDAAgD;IAChD,YAAY,CAAC,EAAE,MAAM,CAAC;IACtB,gCAAgC;IAChC,MAAM,CAAC,EAAE,MAAM,EAAE,CAAC;IAClB;2EACuE;IACvE,OAAO,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;IACjC,2EAA2E;IAC3E,QAAQ,CAAC,EAAE,OAAO,CAAC;IACnB;;;;;4DAKwD;IACxD,YAAY,CAAC,EAAE,OAAO,CAAC;CACxB;AAED,eAAO,MAAM,gBAAgB;;;;;;;;;;;;;;;;;;;;;;IAyB3B;4CACwC;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;IAuGxC,4EAA4E;;;;;;;;IAQ5E,uEAAuE;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;IAqCvE;iDAC6C;;;;;;;;IAQ7C;+CAC2C;;;;;;;;;;;;;;CAcM,CAAC;AAEpD,MAAM,MAAM,gBAAgB,GAAG,MAAM,OAAO,gBAAgB,CAAC;AAE7D,0EAA0E;AAC1E,eAAO,MAAM,UAAU,EAAoC,gBAAgB,EAAE,CAAC"}

package/dist/presets.js

@@ -0,0 +1,199 @@
+export const PROVIDER_PRESETS = {
+    // ── Keyed, native shapes ────────────────────────────────────────────────
+    anthropic: {
+        shape: "anthropic",
+        baseUrl: "https://api.anthropic.com",
+        auth: "key",
+        defaultModel: "claude-sonnet-4-6",
+        models: ["claude-sonnet-4-6", "claude-opus-5", "claude-fable-5-1"],
+    },
+    openai: {
+        shape: "openai",
+        baseUrl: "https://api.openai.com",
+        auth: "key",
+        defaultModel: "gpt-5.6-sol",
+        models: ["gpt-5.6-sol", "gpt-5-pro", "gpt-5-nano"],
+    },
+    google: {
+        // Native Generative Language REST — the adapter authenticates with
+        // `x-goog-api-key` (NOT Bearer) and fixes its own /v1… paths.
+        shape: "gemini",
+        baseUrl: "https://generativelanguage.googleapis.com",
+        auth: "key",
+        defaultModel: "gemini-3.1-pro",
+        models: ["gemini-3.1-pro", "gemini-2.5-flash"],
+    },
+    /** Gemini behind its OpenAI-compatible route — the drop-in for codebases
+     *  that only speak the openai shape. */
+    "google-openai": {
+        shape: "openai",
+        baseUrl: "https://generativelanguage.googleapis.com/v1beta/openai",
+        auth: "key",
+        defaultModel: "gemini-3.1-pro",
+        models: ["gemini-3.1-pro", "gemini-2.5-flash"],
+    },
+    deepseek: {
+        shape: "openai",
+        baseUrl: "https://api.deepseek.com",
+        auth: "key",
+        defaultModel: "deepseek-v4-flash",
+        models: ["deepseek-v4-flash", "deepseek-v4-pro", "deepseek-flash"],
+        // Text-only API — an image part in the body is a hard 400 (measured).
+        textOnly: true,
+    },
+    openrouter: {
+        shape: "openai",
+        baseUrl: "https://openrouter.ai/api",
+        auth: "key",
+        defaultModel: "deepseek/deepseek-v4.1-flash",
+        models: ["deepseek/deepseek-v4.1-flash", "z-ai/glm-5.3-flash", "qwen/qwen3.7-max"],
+    },
+    groq: {
+        shape: "openai",
+        baseUrl: "https://api.groq.com/openai/v1",
+        auth: "key",
+        defaultModel: "llama-3.3-70b-versatile",
+        models: ["llama-3.3-70b-versatile", "qwen/qwen3.8-27b"],
+    },
+    mistral: {
+        shape: "openai",
+        baseUrl: "https://api.mistral.ai/v1",
+        auth: "key",
+        defaultModel: "devstral-2512",
+        models: ["devstral-2512", "magistral-small", "mistral-small-2506"],
+    },
+    xai: {
+        shape: "openai",
+        baseUrl: "https://api.x.ai/v1",
+        auth: "key",
+        defaultModel: "grok-4.5",
+        models: ["grok-4.5", "grok-4.3", "grok-4.20-0309-reasoning"],
+    },
+    together: {
+        shape: "openai",
+        baseUrl: "https://api.together.xyz/v1",
+        auth: "key",
+        defaultModel: "deepseek-ai/DeepSeek-V3",
+    },
+    fireworks: {
+        shape: "openai",
+        baseUrl: "https://api.fireworks.ai/inference/v1",
+        auth: "key",
+    },
+    cerebras: {
+        shape: "openai",
+        baseUrl: "https://api.cerebras.ai/v1",
+        auth: "key",
+        defaultModel: "gpt-oss-120b",
+        models: ["gpt-oss-120b", "qwen-3.8-27b"],
+    },
+    moonshot: {
+        shape: "openai",
+        baseUrl: "https://api.moonshot.ai/v1",
+        auth: "key",
+        defaultModel: "kimi-k2.7-code",
+        models: ["kimi-k2.7-code", "kimi-k2.7-code-highspeed", "kimi-k3"],
+    },
+    zhipu: {
+        shape: "openai",
+        baseUrl: "https://api.z.ai/api/paas/v4",
+        auth: "key",
+        defaultModel: "glm-5.3-flash",
+        models: ["glm-5.3-flash", "glm-5.2", "glm-4.7"],
+    },
+    minimax: {
+        shape: "anthropic",
+        baseUrl: "https://api.minimax.io/anthropic",
+        auth: "key",
+        defaultModel: "MiniMax-M2.5",
+        models: ["MiniMax-M3", "MiniMax-M2.5", "MiniMax-M2.1"],
+    },
+    // ── Coding plans — Anthropic wire + Bearer (measured family trait) ─────
+    zai: {
+        shape: "anthropic",
+        baseUrl: "https://api.z.ai/api/anthropic",
+        auth: "bearer",
+        defaultModel: "glm-5.3-flash",
+        models: ["glm-5.3-flash", "glm-5.3-highspeed", "glm-5.2", "glm-5-turbo"],
+        // Model ids are BARE here — the gateway-prefixed spelling
+        // (`z-ai/glm-5.3-flash`) answers 400 [1211] Unknown Model.
+        explicitNone: true,
+    },
+    kimi: {
+        shape: "anthropic",
+        baseUrl: "https://api.kimi.ai/coding",
+        auth: "bearer",
+        defaultModel: "kimi-for-coding",
+        models: ["kimi-for-coding", "kimi-for-coding-highspeed", "k3"],
+    },
+    /** Alibaba's dashscope coding plan — OpenAI-compatible per its registry. */
+    "alibaba-coding-plan": {
+        shape: "openai",
+        baseUrl: "https://coding-intl.dashscope.aliyuncs.com/v1",
+        auth: "bearer",
+        defaultModel: "qwen3.7-max",
+        models: ["qwen3.7-max", "qwen3-coder-next", "glm-4.7"],
+    },
+    /** QwenCloud's token plan — Anthropic wire (measured by tabrunner). */
+    qwen: {
+        shape: "anthropic",
+        baseUrl: "https://token-plan.ap-southeast-1.maas.aliyuncs.com/apps/anthropic",
+        auth: "bearer",
+        defaultModel: "qwen3.8-max",
+        models: ["qwen3.8-max", "qwen3.6-flash"],
+    },
+    // ── Local runtimes ──────────────────────────────────────────────────────
+    ollama: {
+        shape: "openai",
+        baseUrl: "http://localhost:11434/v1",
+        auth: "bearer",
+    },
+    lmstudio: {
+        shape: "openai",
+        baseUrl: "http://127.0.0.1:1234/v1",
+        auth: "bearer",
+    },
+    vllm: {
+        shape: "openai",
+        baseUrl: "http://localhost:8000/v1",
+        auth: "bearer",
+    },
+    // ── OAuth — the caller owns the sign-in flow and hands over the token ───
+    claude: {
+        shape: "anthropic",
+        baseUrl: "https://api.anthropic.com",
+        auth: "oauth",
+        defaultModel: "claude-sonnet-4-6",
+        models: ["claude-sonnet-4-6", "claude-opus-5"],
+        // The beta flag is what switches the API into OAuth-token mode (measured
+        // by tabrunner's Claude plan sign-in).
+        headers: { "anthropic-beta": "claude-code-20250219,oauth-2025-04-20" },
+    },
+    /** The Codex backend behind a ChatGPT sign-in — Responses wire, no public
+     *  model list, so these ids are the list. */
+    chatgpt: {
+        shape: "responses",
+        baseUrl: "https://chatgpt.com/backend-api/codex",
+        auth: "oauth",
+        defaultModel: "gpt-5.3-codex",
+        models: ["gpt-5.3-codex", "gpt-5.5", "gpt-5.4-mini"],
+    },
+    /** Kimi's coding endpoint reached with a subscription token instead of a
+     *  key — Kimi bills the two separately. */
+    "kimi-plan": {
+        shape: "anthropic",
+        baseUrl: "https://api.kimi.ai/coding",
+        auth: "oauth",
+        defaultModel: "kimi-for-coding",
+    },
+    "github-copilot": {
+        shape: "openai",
+        baseUrl: "https://api.githubcopilot.com",
+        auth: "oauth",
+        defaultModel: "gpt-5.6-sol",
+        models: ["gpt-5.6-sol", "claude-opus-5", "claude-opus-4.8", "kimi-k2.7-code"],
+    },
+};
+/** Every valid preset id — the factory's unknown-id error lists these. */
+export const PRESET_IDS = Object.keys(PROVIDER_PRESETS);
+//# sourceMappingURL=presets.js.map

package/dist/presets.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"presets.js","sourceRoot":"","sources":["../src/presets.ts"],"names":[],"mappings":"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"}

package/dist/providers/factory.d.ts

@@ -0,0 +1,19 @@
+import { type ProviderPresetId } from "../presets.ts";
+import type { Effort, Provider } from "../types.ts";
+export interface PresetProviderConfig {
+    /** The credential: an API key for `key`/`bearer` presets, an ACCESS TOKEN
+     *  for `oauth` ones. Acquiring the token is the caller's job. */
+    apiKey: string;
+    /** Which model to run. Absent = the preset's `defaultModel`; a preset
+     *  without either throws rather than sending a request nobody chose. */
+    model?: string;
+    effort?: Effort;
+    /** Output ceiling. The Anthropic shape requires one; adapters default it. */
+    maxTokens?: number;
+    /** Per-request headers (request ids, `ChatGPT-Account-Id`) on top of the
+     *  preset's static protocol headers. */
+    headers?: Record<string, string>;
+    fetchImpl?: typeof fetch;
+}
+export declare function createPresetProvider(id: ProviderPresetId, config: PresetProviderConfig): Provider;
+//# sourceMappingURL=factory.d.ts.map

package/dist/providers/factory.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"factory.d.ts","sourceRoot":"","sources":["../../src/providers/factory.ts"],"names":[],"mappings":"AAgBA,OAAO,EAAqD,KAAK,gBAAgB,EAAE,MAAM,eAAe,CAAC;AACzG,OAAO,KAAK,EAAE,MAAM,EAAE,QAAQ,EAAE,MAAM,aAAa,CAAC;AAEpD,MAAM,WAAW,oBAAoB;IACnC;qEACiE;IACjE,MAAM,EAAE,MAAM,CAAC;IACf;4EACwE;IACxE,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,6EAA6E;IAC7E,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB;4CACwC;IACxC,OAAO,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;IACjC,SAAS,CAAC,EAAE,OAAO,KAAK,CAAC;CAC1B;AAED,wBAAgB,oBAAoB,CAAC,EAAE,EAAE,gBAAgB,EAAE,MAAM,EAAE,oBAAoB,GAAG,QAAQ,CAkEjG"}

package/dist/providers/factory.js

@@ -0,0 +1,82 @@
+// The one-line switch: resolve a preset id into a wired provider.
+//
+// Consumers used to write their own switch over providers — the same
+// dispatch, re-derived per codebase, each quietly accumulating dialect
+// knowledge (which gateway takes Bearer, which needs the thinking marker).
+// The presets table + this factory is that dispatch, said once: a caller
+// names an id and hands over a credential, and the header style, endpoint
+// and adapter come from the table.
+//
+// `effort` passes through to the adapter unchanged — the per-endpoint
+// thinking dialects (Z.ai's explicit disabled marker, OpenRouter's floors)
+// are the adapters' knowledge, and this factory must not re-derive them.
+import { createAnthropicProvider } from "./anthropic.js";
+import { createGeminiProvider } from "./gemini.js";
+import { createOpenAIProvider } from "./openai.js";
+import { createResponsesProvider } from "./responses.js";
+import { PRESET_IDS, PROVIDER_PRESETS } from "../presets.js";
+export function createPresetProvider(id, config) {
+    // The table is closed (`satisfies`), but a caller may hold an id as a plain
+    // string — validate rather than index into undefined.
+    if (!(id in PROVIDER_PRESETS)) {
+        throw new Error(`[providerkit] Unknown provider preset "${id}". Valid ids: ${PRESET_IDS.join(", ")}`);
+    }
+    const preset = PROVIDER_PRESETS[id];
+    const model = config.model ?? preset.defaultModel;
+    if (!model) {
+        throw new Error(`[providerkit] Preset "${id}" has no defaultModel — pass a model.`);
+    }
+    const headers = { ...preset.headers, ...config.headers };
+    switch (preset.shape) {
+        case "anthropic":
+            // `key` rides Anthropic's native x-api-key; coding plans and OAuth
+            // tokens read Bearer (measured across the family's coding endpoints).
+            return createAnthropicProvider({
+                apiKey: config.apiKey,
+                model,
+                effort: config.effort,
+                maxTokens: config.maxTokens,
+                baseUrl: preset.baseUrl,
+                id,
+                headers,
+                bearer: preset.auth !== "key",
+                // The endpoint's thinking dialect rides the table (zai: silence means
+                // the model default, which is ON — "none" must be said out loud).
+                ...(preset.explicitNone ? { explicitNone: true } : {}),
+                fetchImpl: config.fetchImpl,
+            });
+        case "openai":
+            return createOpenAIProvider({
+                id,
+                apiKey: config.apiKey,
+                model,
+                effort: config.effort,
+                maxTokens: config.maxTokens,
+                baseUrl: preset.baseUrl,
+                headers,
+                fetchImpl: config.fetchImpl,
+            });
+        case "responses":
+            return createResponsesProvider({
+                apiKey: config.apiKey,
+                model,
+                effort: config.effort,
+                maxTokens: config.maxTokens,
+                baseUrl: preset.baseUrl,
+                id,
+                headers,
+                fetchImpl: config.fetchImpl,
+            });
+        case "gemini":
+            return createGeminiProvider({
+                apiKey: config.apiKey,
+                model,
+                effort: config.effort,
+                baseUrl: preset.baseUrl,
+                id,
+                headers,
+                fetchImpl: config.fetchImpl,
+            });
+    }
+}
+//# sourceMappingURL=factory.js.map

package/dist/providers/factory.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"factory.js","sourceRoot":"","sources":["../../src/providers/factory.ts"],"names":[],"mappings":"AAAA,kEAAkE;AAClE,EAAE;AACF,qEAAqE;AACrE,uEAAuE;AACvE,2EAA2E;AAC3E,yEAAyE;AACzE,0EAA0E;AAC1E,mCAAmC;AACnC,EAAE;AACF,sEAAsE;AACtE,2EAA2E;AAC3E,yEAAyE;AACzE,OAAO,EAAE,uBAAuB,EAAE,MAAM,gBAAgB,CAAC;AACzD,OAAO,EAAE,oBAAoB,EAAE,MAAM,aAAa,CAAC;AACnD,OAAO,EAAE,oBAAoB,EAAE,MAAM,aAAa,CAAC;AACnD,OAAO,EAAE,uBAAuB,EAAE,MAAM,gBAAgB,CAAC;AACzD,OAAO,EAAE,UAAU,EAAE,gBAAgB,EAA8C,MAAM,eAAe,CAAC;AAmBzG,MAAM,UAAU,oBAAoB,CAAC,EAAoB,EAAE,MAA4B;IACrF,4EAA4E;IAC5E,sDAAsD;IACtD,IAAI,CAAC,CAAC,EAAE,IAAI,gBAAgB,CAAC,EAAE,CAAC;QAC9B,MAAM,IAAI,KAAK,CACb,0CAA0C,EAAE,iBAAiB,UAAU,CAAC,IAAI,CAAC,IAAI,CAAC,EAAE,CACrF,CAAC;IACJ,CAAC;IACD,MAAM,MAAM,GAAmB,gBAAgB,CAAC,EAAE,CAAC,CAAC;IACpD,MAAM,KAAK,GAAG,MAAM,CAAC,KAAK,IAAI,MAAM,CAAC,YAAY,CAAC;IAClD,IAAI,CAAC,KAAK,EAAE,CAAC;QACX,MAAM,IAAI,KAAK,CAAC,yBAAyB,EAAE,uCAAuC,CAAC,CAAC;IACtF,CAAC;IACD,MAAM,OAAO,GAAG,EAAE,GAAG,MAAM,CAAC,OAAO,EAAE,GAAG,MAAM,CAAC,OAAO,EAAE,CAAC;IAEzD,QAAQ,MAAM,CAAC,KAAK,EAAE,CAAC;QACrB,KAAK,WAAW;YACd,mEAAmE;YACnE,sEAAsE;YACtE,OAAO,uBAAuB,CAAC;gBAC7B,MAAM,EAAE,MAAM,CAAC,MAAM;gBACrB,KAAK;gBACL,MAAM,EAAE,MAAM,CAAC,MAAM;gBACrB,SAAS,EAAE,MAAM,CAAC,SAAS;gBAC3B,OAAO,EAAE,MAAM,CAAC,OAAO;gBACvB,EAAE;gBACF,OAAO;gBACP,MAAM,EAAE,MAAM,CAAC,IAAI,KAAK,KAAK;gBAC7B,sEAAsE;gBACtE,kEAAkE;gBAClE,GAAG,CAAC,MAAM,CAAC,YAAY,CAAC,CAAC,CAAC,EAAE,YAAY,EAAE,IAAI,EAAE,CAAC,CAAC,CAAC,EAAE,CAAC;gBACtD,SAAS,EAAE,MAAM,CAAC,SAAS;aAC5B,CAAC,CAAC;QACL,KAAK,QAAQ;YACX,OAAO,oBAAoB,CAAC;gBAC1B,EAAE;gBACF,MAAM,EAAE,MAAM,CAAC,MAAM;gBACrB,KAAK;gBACL,MAAM,EAAE,MAAM,CAAC,MAAM;gBACrB,SAAS,EAAE,MAAM,CAAC,SAAS;gBAC3B,OAAO,EAAE,MAAM,CAAC,OAAO;gBACvB,OAAO;gBACP,SAAS,EAAE,MAAM,CAAC,SAAS;aAC5B,CAAC,CAAC;QACL,KAAK,WAAW;YACd,OAAO,uBAAuB,CAAC;gBAC7B,MAAM,EAAE,MAAM,CAAC,MAAM;gBACrB,KAAK;gBACL,MAAM,EAAE,MAAM,CAAC,MAAM;gBACrB,SAAS,EAAE,MAAM,CAAC,SAAS;gBAC3B,OAAO,EAAE,MAAM,CAAC,OAAO;gBACvB,EAAE;gBACF,OAAO;gBACP,SAAS,EAAE,MAAM,CAAC,SAAS;aAC5B,CAAC,CAAC;QACL,KAAK,QAAQ;YACX,OAAO,oBAAoB,CAAC;gBAC1B,MAAM,EAAE,MAAM,CAAC,MAAM;gBACrB,KAAK;gBACL,MAAM,EAAE,MAAM,CAAC,MAAM;gBACrB,OAAO,EAAE,MAAM,CAAC,OAAO;gBACvB,EAAE;gBACF,OAAO;gBACP,SAAS,EAAE,MAAM,CAAC,SAAS;aAC5B,CAAC,CAAC;IACP,CAAC;AACH,CAAC"}

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@providerkit/core",
-  "version": "0.6.0",
+  "version": "0.7.0",
   "description": "The layer under your agent loop: one seam for every LLM provider, plus the failure handling you only learn in production.",
   "type": "module",
   "license": "MIT",

package/src/index.ts

@@ -11,8 +11,10 @@ export * from "./tools.ts";
 export * from "./schema.ts";
 export * from "./context.ts";
 export * from "./capability.ts";
+export * from "./presets.ts";
 export * from "./providers/anthropic.ts";
 export * from "./providers/openai.ts";
 export * from "./providers/responses.ts";
 export * from "./providers/gemini.ts";
 export * from "./providers/zai.ts";
+export * from "./providers/factory.ts";

package/src/presets.ts

@@ -0,0 +1,265 @@
+/**
+ * Provider presets — hand-curated, wire-level facts only.
+ *
+ * A preset is everything `createPresetProvider` needs to speak to one
+ * endpoint: which adapter shape it speaks, its API root, how the credential
+ * rides, and what it is called. Deliberately absent: prices (invariant 9 —
+ * they drift on a vendor's schedule and a wrong number in a library is a
+ * wrong number in everyone's ledger), icons, colors, marketing names, and
+ * sign-in flows (an `oauth` preset expects the CALLER to hand over an access
+ * token; acquiring one stays app-side).
+ *
+ * Sources: the coding-plan endpoints and auth quirks are measured
+ * (tabrunner's extension + this repo's adopters, 2026-09); the model lists
+ * are representative, not exhaustive — every adapter takes a per-call model,
+ * so a missing id costs nothing.
+ *
+ * Azure is deliberately ABSENT: its base URL is per-deployment
+ * (`https://<resource>.openai.azure.com`), so no static preset can carry it —
+ * point createOpenAIProvider's baseUrl at your resource instead.
+ */
+export type PresetShape = "anthropic" | "openai" | "responses" | "gemini";
+
+/**
+ * How the credential reaches the endpoint.
+ * - `key`: the vendor's native key header (Anthropic reads `x-api-key`,
+ *   Gemini `x-goog-api-key`); the OpenAI shapes have only Bearer, so they
+ *   never use this.
+ * - `bearer`: `Authorization: Bearer` — the OpenAI shapes' only mode, and the
+ *   coding-plan gateways' mode on the Anthropic wire (measured: Z.ai's coding
+ *   endpoint ignores `x-api-key` and reads Bearer).
+ * - `oauth`: same wire as `bearer`, but the token is a short-lived access
+ *   token from a sign-in flow the caller owns. The preset may carry the beta
+ *   headers that switch the endpoint into OAuth mode.
+ */
+export type PresetAuth = "key" | "bearer" | "oauth";
+
+export interface ProviderPreset {
+  /** Adapter wire format. */
+  shape: PresetShape;
+  /** API root — the adapter appends its own path (/v1/chat/completions,
+   *  /v1/messages, …), so this must NOT carry the version. */
+  baseUrl: string;
+  auth: PresetAuth;
+  /** Fallback when the caller passes no model. */
+  defaultModel?: string;
+  /** Representative model ids. */
+  models?: string[];
+  /** Static protocol headers the endpoint requires (e.g. OAuth beta flags).
+   *  Per-request headers (request ids, account ids) are the caller's. */
+  headers?: Record<string, string>;
+  /** True when the endpoint hard-400s image parts (measured on DeepSeek). */
+  textOnly?: boolean;
+  /** Anthropic-shape dialect: say "no thinking" with an explicit
+   *  `thinking: { type: "disabled" }` marker when effort is none. For
+   *  endpoints where an ABSENT field means the model's default — thinking ON
+   *  for reasoning-mandatory models (measured on Z.ai's coding endpoint:
+   *  omit → thinking block; disabled → none). Native Anthropic defaults to
+   *  off when the field is absent and must stay unset. */
+  explicitNone?: boolean;
+}
+
+export const PROVIDER_PRESETS = {
+  // ── Keyed, native shapes ────────────────────────────────────────────────
+  anthropic: {
+    shape: "anthropic",
+    baseUrl: "https://api.anthropic.com",
+    auth: "key",
+    defaultModel: "claude-sonnet-4-6",
+    models: ["claude-sonnet-4-6", "claude-opus-5", "claude-fable-5-1"],
+  },
+  openai: {
+    shape: "openai",
+    baseUrl: "https://api.openai.com",
+    auth: "key",
+    defaultModel: "gpt-5.6-sol",
+    models: ["gpt-5.6-sol", "gpt-5-pro", "gpt-5-nano"],
+  },
+  google: {
+    // Native Generative Language REST — the adapter authenticates with
+    // `x-goog-api-key` (NOT Bearer) and fixes its own /v1… paths.
+    shape: "gemini",
+    baseUrl: "https://generativelanguage.googleapis.com",
+    auth: "key",
+    defaultModel: "gemini-3.1-pro",
+    models: ["gemini-3.1-pro", "gemini-2.5-flash"],
+  },
+  /** Gemini behind its OpenAI-compatible route — the drop-in for codebases
+   *  that only speak the openai shape. */
+  "google-openai": {
+    shape: "openai",
+    baseUrl: "https://generativelanguage.googleapis.com/v1beta/openai",
+    auth: "key",
+    defaultModel: "gemini-3.1-pro",
+    models: ["gemini-3.1-pro", "gemini-2.5-flash"],
+  },
+  deepseek: {
+    shape: "openai",
+    baseUrl: "https://api.deepseek.com",
+    auth: "key",
+    defaultModel: "deepseek-v4-flash",
+    models: ["deepseek-v4-flash", "deepseek-v4-pro", "deepseek-flash"],
+    // Text-only API — an image part in the body is a hard 400 (measured).
+    textOnly: true,
+  },
+  openrouter: {
+    shape: "openai",
+    baseUrl: "https://openrouter.ai/api",
+    auth: "key",
+    defaultModel: "deepseek/deepseek-v4.1-flash",
+    models: ["deepseek/deepseek-v4.1-flash", "z-ai/glm-5.3-flash", "qwen/qwen3.7-max"],
+  },
+  groq: {
+    shape: "openai",
+    baseUrl: "https://api.groq.com/openai/v1",
+    auth: "key",
+    defaultModel: "llama-3.3-70b-versatile",
+    models: ["llama-3.3-70b-versatile", "qwen/qwen3.8-27b"],
+  },
+  mistral: {
+    shape: "openai",
+    baseUrl: "https://api.mistral.ai/v1",
+    auth: "key",
+    defaultModel: "devstral-2512",
+    models: ["devstral-2512", "magistral-small", "mistral-small-2506"],
+  },
+  xai: {
+    shape: "openai",
+    baseUrl: "https://api.x.ai/v1",
+    auth: "key",
+    defaultModel: "grok-4.5",
+    models: ["grok-4.5", "grok-4.3", "grok-4.20-0309-reasoning"],
+  },
+  together: {
+    shape: "openai",
+    baseUrl: "https://api.together.xyz/v1",
+    auth: "key",
+    defaultModel: "deepseek-ai/DeepSeek-V3",
+  },
+  fireworks: {
+    shape: "openai",
+    baseUrl: "https://api.fireworks.ai/inference/v1",
+    auth: "key",
+  },
+  cerebras: {
+    shape: "openai",
+    baseUrl: "https://api.cerebras.ai/v1",
+    auth: "key",
+    defaultModel: "gpt-oss-120b",
+    models: ["gpt-oss-120b", "qwen-3.8-27b"],
+  },
+  moonshot: {
+    shape: "openai",
+    baseUrl: "https://api.moonshot.ai/v1",
+    auth: "key",
+    defaultModel: "kimi-k2.7-code",
+    models: ["kimi-k2.7-code", "kimi-k2.7-code-highspeed", "kimi-k3"],
+  },
+  zhipu: {
+    shape: "openai",
+    baseUrl: "https://api.z.ai/api/paas/v4",
+    auth: "key",
+    defaultModel: "glm-5.3-flash",
+    models: ["glm-5.3-flash", "glm-5.2", "glm-4.7"],
+  },
+  minimax: {
+    shape: "anthropic",
+    baseUrl: "https://api.minimax.io/anthropic",
+    auth: "key",
+    defaultModel: "MiniMax-M2.5",
+    models: ["MiniMax-M3", "MiniMax-M2.5", "MiniMax-M2.1"],
+  },
+
+  // ── Coding plans — Anthropic wire + Bearer (measured family trait) ─────
+  zai: {
+    shape: "anthropic",
+    baseUrl: "https://api.z.ai/api/anthropic",
+    auth: "bearer",
+    defaultModel: "glm-5.3-flash",
+    models: ["glm-5.3-flash", "glm-5.3-highspeed", "glm-5.2", "glm-5-turbo"],
+    // Model ids are BARE here — the gateway-prefixed spelling
+    // (`z-ai/glm-5.3-flash`) answers 400 [1211] Unknown Model.
+    explicitNone: true,
+  },
+  kimi: {
+    shape: "anthropic",
+    baseUrl: "https://api.kimi.ai/coding",
+    auth: "bearer",
+    defaultModel: "kimi-for-coding",
+    models: ["kimi-for-coding", "kimi-for-coding-highspeed", "k3"],
+  },
+  /** Alibaba's dashscope coding plan — OpenAI-compatible per its registry. */
+  "alibaba-coding-plan": {
+    shape: "openai",
+    baseUrl: "https://coding-intl.dashscope.aliyuncs.com/v1",
+    auth: "bearer",
+    defaultModel: "qwen3.7-max",
+    models: ["qwen3.7-max", "qwen3-coder-next", "glm-4.7"],
+  },
+  /** QwenCloud's token plan — Anthropic wire (measured by tabrunner). */
+  qwen: {
+    shape: "anthropic",
+    baseUrl: "https://token-plan.ap-southeast-1.maas.aliyuncs.com/apps/anthropic",
+    auth: "bearer",
+    defaultModel: "qwen3.8-max",
+    models: ["qwen3.8-max", "qwen3.6-flash"],
+  },
+
+  // ── Local runtimes ──────────────────────────────────────────────────────
+  ollama: {
+    shape: "openai",
+    baseUrl: "http://localhost:11434/v1",
+    auth: "bearer",
+  },
+  lmstudio: {
+    shape: "openai",
+    baseUrl: "http://127.0.0.1:1234/v1",
+    auth: "bearer",
+  },
+  vllm: {
+    shape: "openai",
+    baseUrl: "http://localhost:8000/v1",
+    auth: "bearer",
+  },
+
+  // ── OAuth — the caller owns the sign-in flow and hands over the token ───
+  claude: {
+    shape: "anthropic",
+    baseUrl: "https://api.anthropic.com",
+    auth: "oauth",
+    defaultModel: "claude-sonnet-4-6",
+    models: ["claude-sonnet-4-6", "claude-opus-5"],
+    // The beta flag is what switches the API into OAuth-token mode (measured
+    // by tabrunner's Claude plan sign-in).
+    headers: { "anthropic-beta": "claude-code-20250219,oauth-2025-04-20" },
+  },
+  /** The Codex backend behind a ChatGPT sign-in — Responses wire, no public
+   *  model list, so these ids are the list. */
+  chatgpt: {
+    shape: "responses",
+    baseUrl: "https://chatgpt.com/backend-api/codex",
+    auth: "oauth",
+    defaultModel: "gpt-5.3-codex",
+    models: ["gpt-5.3-codex", "gpt-5.5", "gpt-5.4-mini"],
+  },
+  /** Kimi's coding endpoint reached with a subscription token instead of a
+   *  key — Kimi bills the two separately. */
+  "kimi-plan": {
+    shape: "anthropic",
+    baseUrl: "https://api.kimi.ai/coding",
+    auth: "oauth",
+    defaultModel: "kimi-for-coding",
+  },
+  "github-copilot": {
+    shape: "openai",
+    baseUrl: "https://api.githubcopilot.com",
+    auth: "oauth",
+    defaultModel: "gpt-5.6-sol",
+    models: ["gpt-5.6-sol", "claude-opus-5", "claude-opus-4.8", "kimi-k2.7-code"],
+  },
+} as const satisfies Record<string, ProviderPreset>;
+
+export type ProviderPresetId = keyof typeof PROVIDER_PRESETS;
+
+/** Every valid preset id — the factory's unknown-id error lists these. */
+export const PRESET_IDS = Object.keys(PROVIDER_PRESETS) as ProviderPresetId[];

package/src/providers/factory.ts

@@ -0,0 +1,102 @@
+// The one-line switch: resolve a preset id into a wired provider.
+//
+// Consumers used to write their own switch over providers — the same
+// dispatch, re-derived per codebase, each quietly accumulating dialect
+// knowledge (which gateway takes Bearer, which needs the thinking marker).
+// The presets table + this factory is that dispatch, said once: a caller
+// names an id and hands over a credential, and the header style, endpoint
+// and adapter come from the table.
+//
+// `effort` passes through to the adapter unchanged — the per-endpoint
+// thinking dialects (Z.ai's explicit disabled marker, OpenRouter's floors)
+// are the adapters' knowledge, and this factory must not re-derive them.
+import { createAnthropicProvider } from "./anthropic.ts";
+import { createGeminiProvider } from "./gemini.ts";
+import { createOpenAIProvider } from "./openai.ts";
+import { createResponsesProvider } from "./responses.ts";
+import { PRESET_IDS, PROVIDER_PRESETS, type ProviderPreset, type ProviderPresetId } from "../presets.ts";
+import type { Effort, Provider } from "../types.ts";
+
+export interface PresetProviderConfig {
+  /** The credential: an API key for `key`/`bearer` presets, an ACCESS TOKEN
+   *  for `oauth` ones. Acquiring the token is the caller's job. */
+  apiKey: string;
+  /** Which model to run. Absent = the preset's `defaultModel`; a preset
+   *  without either throws rather than sending a request nobody chose. */
+  model?: string;
+  effort?: Effort;
+  /** Output ceiling. The Anthropic shape requires one; adapters default it. */
+  maxTokens?: number;
+  /** Per-request headers (request ids, `ChatGPT-Account-Id`) on top of the
+   *  preset's static protocol headers. */
+  headers?: Record<string, string>;
+  fetchImpl?: typeof fetch;
+}
+
+export function createPresetProvider(id: ProviderPresetId, config: PresetProviderConfig): Provider {
+  // The table is closed (`satisfies`), but a caller may hold an id as a plain
+  // string — validate rather than index into undefined.
+  if (!(id in PROVIDER_PRESETS)) {
+    throw new Error(
+      `[providerkit] Unknown provider preset "${id}". Valid ids: ${PRESET_IDS.join(", ")}`,
+    );
+  }
+  const preset: ProviderPreset = PROVIDER_PRESETS[id];
+  const model = config.model ?? preset.defaultModel;
+  if (!model) {
+    throw new Error(`[providerkit] Preset "${id}" has no defaultModel — pass a model.`);
+  }
+  const headers = { ...preset.headers, ...config.headers };
+
+  switch (preset.shape) {
+    case "anthropic":
+      // `key` rides Anthropic's native x-api-key; coding plans and OAuth
+      // tokens read Bearer (measured across the family's coding endpoints).
+      return createAnthropicProvider({
+        apiKey: config.apiKey,
+        model,
+        effort: config.effort,
+        maxTokens: config.maxTokens,
+        baseUrl: preset.baseUrl,
+        id,
+        headers,
+        bearer: preset.auth !== "key",
+        // The endpoint's thinking dialect rides the table (zai: silence means
+        // the model default, which is ON — "none" must be said out loud).
+        ...(preset.explicitNone ? { explicitNone: true } : {}),
+        fetchImpl: config.fetchImpl,
+      });
+    case "openai":
+      return createOpenAIProvider({
+        id,
+        apiKey: config.apiKey,
+        model,
+        effort: config.effort,
+        maxTokens: config.maxTokens,
+        baseUrl: preset.baseUrl,
+        headers,
+        fetchImpl: config.fetchImpl,
+      });
+    case "responses":
+      return createResponsesProvider({
+        apiKey: config.apiKey,
+        model,
+        effort: config.effort,
+        maxTokens: config.maxTokens,
+        baseUrl: preset.baseUrl,
+        id,
+        headers,
+        fetchImpl: config.fetchImpl,
+      });
+    case "gemini":
+      return createGeminiProvider({
+        apiKey: config.apiKey,
+        model,
+        effort: config.effort,
+        baseUrl: preset.baseUrl,
+        id,
+        headers,
+        fetchImpl: config.fetchImpl,
+      });
+  }
+}