@every-app/sdk 0.3.0-rc.2 → 0.3.0-rc.4

package/dist/internal/aiDefault.d.ts

@@ -0,0 +1,141 @@
+/**
+ * The Gateway's default model provider: what an app that says "I need a
+ * chat model" (manifest `ai: { chat: true }`, the SDK's `ai()`, the route
+ * `/api/ai/default/…`) is served (docs/design/2026-10-model-providers.md).
+ *
+ * The default is resolved, never assumed: the operator's choice when one
+ * is stored (`everyapp ai default <provider>[/<model>]`, Manage workspace
+ * → Usage → AI default), else the shipped order below, first provider
+ * whose Gateway settings are all set; with none set, the first of the
+ * order with the settings it needs, so "Needs setup" asks for one key.
+ * OpenRouter comes first because one key reaches many models; Workers AI
+ * second because it needs no provider account (the Gateway's own
+ * Cloudflare token), with weaker models; then the single-vendor keys.
+ * Cloudflare AI Gateway is never a default: it has no models of its own
+ * and fronts whichever provider the default resolves to when
+ * `AI_GATEWAY_ID` is set (./capabilities.ts, `aig`).
+ *
+ * Everything here is pure: what is set is asked of the caller (`isSet`),
+ * which reads the Gateway's env, the Worker's secret names, or `.dev.vars`.
+ */
+import { type AiProviderCapability, type AiRoute, type Capability, type CapabilityLookup } from "./capabilities.js";
+/** The reserved provider id apps call for the default: `/api/ai/default/…`. */
+export declare const AI_DEFAULT_PROVIDER = "default";
+/** The catalog id of Cloudflare AI Gateway, the proxy entry. */
+export declare const AI_GATEWAY_PROVIDER = "ai-gateway";
+/** The settings that make AI Gateway front the providers that have a slug. */
+export declare const AI_GATEWAY_SETTINGS: readonly ["AI_GATEWAY_ID", "CLOUDFLARE_ACCOUNT_ID"];
+/**
+ * The shipped order: the provider the default resolves to when the
+ * operator chose none, the first of these whose settings are set.
+ */
+export declare const AI_DEFAULT_ORDER: readonly string[];
+/** The model name an app sends to mean "the default's model". */
+export declare const AI_DEFAULT_MODEL = "default";
+/** The paths an app calls under `/api/ai/default`, OpenAI-shaped. */
+export declare const AI_DEFAULT_ROUTES: {
+    readonly chat: "/v1/chat/completions";
+    readonly embeddings: "/v1/embeddings";
+};
+export type AiDefaultRoute = keyof typeof AI_DEFAULT_ROUTES;
+/** What the operator stored: a provider, and the model to fill in when the app names none. */
+export interface AiDefaultChoice {
+    provider: string;
+    model?: string;
+}
+/**
+ * `openrouter` or `openrouter/anthropic/claude-haiku-5.5` as a choice:
+ * the provider id up to the first slash, the model after it (a model id
+ * may hold slashes of its own). Null for blank or malformed text.
+ */
+export declare function parseAiDefaultChoice(value: string | null | undefined): AiDefaultChoice | null;
+/** The stored text of a choice: `provider` or `provider/model`. */
+export declare function formatAiDefaultChoice(choice: AiDefaultChoice): string;
+/** Whether `name` holds a value, as the Gateway's env or a secret list says. */
+export type IsSet = (name: string) => boolean;
+/** An `ai` entry the default may resolve to: not the proxy, with a chat route. */
+export type AiDefaultCapability = AiProviderCapability & {
+    chat: AiRoute;
+};
+export declare function canBeAiDefault(capability: Capability | undefined): capability is AiDefaultCapability;
+/**
+ * The Gateway settings an `ai` entry needs before it serves: its key
+ * (unless the entry works without one, `authOptional`) and what its URL
+ * needs besides (`alsoNeeds`).
+ */
+export declare function aiRequiredSettings(capability: AiProviderCapability): string[];
+/** Whether every setting the entry needs is set. */
+export declare function aiProviderConfigured(capability: AiProviderCapability, isSet: IsSet): boolean;
+/** Whether AI Gateway fronts calls: its id and the account are set. */
+export declare function aiGatewayConfigured(isSet: IsSet): boolean;
+/** Whether a call to `capability` goes through AI Gateway: it is configured and the entry has a slug. */
+export declare function viaAiGateway(capability: AiProviderCapability, isSet: IsSet): boolean;
+/** One provider the default may resolve to, with its state on this Gateway. */
+export interface AiDefaultCandidate {
+    id: string;
+    label: string;
+    /** The Gateway settings it needs; what to set when it isn't configured. */
+    settings: string[];
+    configured: boolean;
+    /** The model the Gateway fills in when the app names none. */
+    model: string;
+    /** Through Cloudflare AI Gateway, as things are set now. */
+    viaAiGateway: boolean;
+    embeddings: boolean;
+}
+/** Where the resolved default came from. */
+export type AiDefaultSource = 
+/** The operator's stored choice. */
+"setting"
+/** The shipped order: the first provider that is configured. */
+ | "order"
+/** Nothing is configured: the first of the order, with what to set. */
+ | "none";
+export interface AiDefaultResolution {
+    provider: string;
+    label: string;
+    /** The model the default serves: the choice's, else the entry's. */
+    model: string;
+    source: AiDefaultSource;
+    /** Every setting the provider needs is set, so the default serves. */
+    configured: boolean;
+    /** The Gateway settings the provider needs: what to set when it isn't configured. */
+    settings: string[];
+    via: "ai-gateway" | "direct";
+    chat: AiRoute;
+    embeddings?: AiRoute;
+    /** Every provider the default could be, in the shipped order, the choice first. */
+    candidates: AiDefaultCandidate[];
+    /**
+     * The stored choice names something the default can't be (an id the
+     * catalog doesn't have, an entry with no chat route, the proxy): the
+     * order decided instead, and this says why.
+     */
+    problem?: string;
+}
+/**
+ * Every provider the default may resolve to: the shipped order first,
+ * then any other `ai` entry of `lookup` with a chat route (a registered
+ * row, one day), each with its state.
+ */
+export declare function aiDefaultCandidates(isSet: IsSet, lookup?: CapabilityLookup): AiDefaultCandidate[];
+/** Why `choice.provider` can't be the default, or null when it can. */
+export declare function aiDefaultChoiceProblem(choice: AiDefaultChoice, lookup?: CapabilityLookup): string | null;
+/**
+ * The Gateway's effective default, from the stored choice (or none) and
+ * what is set. A choice that names a provider which isn't configured
+ * still wins (the operator chose it: `configured` is false and `settings`
+ * says what to set); a choice the default can't be is reported as
+ * `problem` and the order decides.
+ */
+export declare function resolveAiDefault(input: {
+    choice: AiDefaultChoice | null;
+    isSet: IsSet;
+    lookup?: CapabilityLookup;
+}): AiDefaultResolution;
+/**
+ * The sentence setup shows for an unconfigured default: the one key to
+ * set, and the alternatives in the order.
+ */
+export declare function aiDefaultSetupHint(resolution: AiDefaultResolution): string;
+//# sourceMappingURL=aiDefault.d.ts.map

package/dist/internal/aiDefault.d.ts.map

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

package/dist/internal/aiDefault.js

@@ -0,0 +1,204 @@
+/**
+ * The Gateway's default model provider: what an app that says "I need a
+ * chat model" (manifest `ai: { chat: true }`, the SDK's `ai()`, the route
+ * `/api/ai/default/…`) is served (docs/design/2026-10-model-providers.md).
+ *
+ * The default is resolved, never assumed: the operator's choice when one
+ * is stored (`everyapp ai default <provider>[/<model>]`, Manage workspace
+ * → Usage → AI default), else the shipped order below, first provider
+ * whose Gateway settings are all set; with none set, the first of the
+ * order with the settings it needs, so "Needs setup" asks for one key.
+ * OpenRouter comes first because one key reaches many models; Workers AI
+ * second because it needs no provider account (the Gateway's own
+ * Cloudflare token), with weaker models; then the single-vendor keys.
+ * Cloudflare AI Gateway is never a default: it has no models of its own
+ * and fronts whichever provider the default resolves to when
+ * `AI_GATEWAY_ID` is set (./capabilities.ts, `aig`).
+ *
+ * Everything here is pure: what is set is asked of the caller (`isSet`),
+ * which reads the Gateway's env, the Worker's secret names, or `.dev.vars`.
+ */
+import { CATALOG, } from "./capabilities.js";
+/** The reserved provider id apps call for the default: `/api/ai/default/…`. */
+export const AI_DEFAULT_PROVIDER = "default";
+/** The catalog id of Cloudflare AI Gateway, the proxy entry. */
+export const AI_GATEWAY_PROVIDER = "ai-gateway";
+/** The settings that make AI Gateway front the providers that have a slug. */
+export const AI_GATEWAY_SETTINGS = [
+    "AI_GATEWAY_ID",
+    "CLOUDFLARE_ACCOUNT_ID",
+];
+/**
+ * The shipped order: the provider the default resolves to when the
+ * operator chose none, the first of these whose settings are set.
+ */
+export const AI_DEFAULT_ORDER = [
+    "openrouter",
+    "workers-ai",
+    "openai",
+    "anthropic",
+    "groq",
+    "mistral",
+    "gemini",
+];
+/** The model name an app sends to mean "the default's model". */
+export const AI_DEFAULT_MODEL = "default";
+/** The paths an app calls under `/api/ai/default`, OpenAI-shaped. */
+export const AI_DEFAULT_ROUTES = {
+    chat: "/v1/chat/completions",
+    embeddings: "/v1/embeddings",
+};
+/** A stored choice must name a provider id; the model is free text after the first slash. */
+const CHOICE = /^([a-z][a-z0-9-]{1,39})(?:\/(.{1,200}))?$/;
+/**
+ * `openrouter` or `openrouter/anthropic/claude-haiku-5.5` as a choice:
+ * the provider id up to the first slash, the model after it (a model id
+ * may hold slashes of its own). Null for blank or malformed text.
+ */
+export function parseAiDefaultChoice(value) {
+    if (typeof value !== "string")
+        return null;
+    const match = CHOICE.exec(value.trim());
+    if (!match)
+        return null;
+    const model = match[2]?.trim();
+    return model ? { provider: match[1], model } : { provider: match[1] };
+}
+/** The stored text of a choice: `provider` or `provider/model`. */
+export function formatAiDefaultChoice(choice) {
+    return choice.model ? `${choice.provider}/${choice.model}` : choice.provider;
+}
+export function canBeAiDefault(capability) {
+    return (capability?.mode === "ai" &&
+        capability.kind !== "proxy" &&
+        capability.chat !== undefined);
+}
+/**
+ * The Gateway settings an `ai` entry needs before it serves: its key
+ * (unless the entry works without one, `authOptional`) and what its URL
+ * needs besides (`alsoNeeds`).
+ */
+export function aiRequiredSettings(capability) {
+    return [
+        ...(capability.authOptional ? [] : [capability.auth.secret]),
+        ...(capability.alsoNeeds ?? []),
+    ];
+}
+/** Whether every setting the entry needs is set. */
+export function aiProviderConfigured(capability, isSet) {
+    return aiRequiredSettings(capability).every((name) => isSet(name));
+}
+/** Whether AI Gateway fronts calls: its id and the account are set. */
+export function aiGatewayConfigured(isSet) {
+    return AI_GATEWAY_SETTINGS.every((name) => isSet(name));
+}
+/** Whether a call to `capability` goes through AI Gateway: it is configured and the entry has a slug. */
+export function viaAiGateway(capability, isSet) {
+    return capability.aig !== undefined && aiGatewayConfigured(isSet);
+}
+function candidateOf(id, capability, isSet) {
+    return {
+        id,
+        label: capability.label,
+        settings: aiRequiredSettings(capability),
+        configured: aiProviderConfigured(capability, isSet),
+        model: capability.chat.model,
+        viaAiGateway: viaAiGateway(capability, isSet),
+        embeddings: capability.embeddings !== undefined,
+    };
+}
+/**
+ * Every provider the default may resolve to: the shipped order first,
+ * then any other `ai` entry of `lookup` with a chat route (a registered
+ * row, one day), each with its state.
+ */
+export function aiDefaultCandidates(isSet, lookup = CATALOG) {
+    const ids = [
+        ...AI_DEFAULT_ORDER,
+        ...lookup.ids().filter((id) => !AI_DEFAULT_ORDER.includes(id)),
+    ];
+    return ids.flatMap((id) => {
+        const capability = lookup.get(id);
+        return canBeAiDefault(capability)
+            ? [candidateOf(id, capability, isSet)]
+            : [];
+    });
+}
+/** Why `choice.provider` can't be the default, or null when it can. */
+export function aiDefaultChoiceProblem(choice, lookup = CATALOG) {
+    const capability = lookup.get(choice.provider);
+    if (!capability)
+        return `${choice.provider} isn't a provider this Gateway knows`;
+    if (capability.mode !== "ai") {
+        return `${choice.provider} is an API provider, not a model provider`;
+    }
+    if (capability.kind === "proxy") {
+        return `${capability.label} fronts the model providers and serves no models of its own; set a provider, and turn the gateway on with everyapp ai gateway on`;
+    }
+    if (!capability.chat) {
+        return `${capability.label} has no OpenAI-shaped chat route, so it can't serve the default; an app pins it by listing it under providers`;
+    }
+    return null;
+}
+/**
+ * The Gateway's effective default, from the stored choice (or none) and
+ * what is set. A choice that names a provider which isn't configured
+ * still wins (the operator chose it: `configured` is false and `settings`
+ * says what to set); a choice the default can't be is reported as
+ * `problem` and the order decides.
+ */
+export function resolveAiDefault(input) {
+    const lookup = input.lookup ?? CATALOG;
+    const { isSet } = input;
+    const candidates = aiDefaultCandidates(isSet, lookup);
+    const resolve = (id, capability, source, model, problem) => ({
+        provider: id,
+        label: capability.label,
+        model: model ?? capability.chat.model,
+        source,
+        configured: aiProviderConfigured(capability, isSet),
+        settings: aiRequiredSettings(capability),
+        via: viaAiGateway(capability, isSet) ? "ai-gateway" : "direct",
+        chat: capability.chat,
+        ...(capability.embeddings ? { embeddings: capability.embeddings } : {}),
+        candidates: [
+            ...candidates.filter((candidate) => candidate.id === id),
+            ...candidates.filter((candidate) => candidate.id !== id),
+        ],
+        ...(problem ? { problem } : {}),
+    });
+    let problem;
+    if (input.choice) {
+        const capability = lookup.get(input.choice.provider);
+        const why = aiDefaultChoiceProblem(input.choice, lookup);
+        if (!why && canBeAiDefault(capability)) {
+            return resolve(input.choice.provider, capability, "setting", input.choice.model);
+        }
+        problem = why ?? undefined;
+    }
+    const configured = candidates.find((candidate) => candidate.configured);
+    const first = configured ?? candidates[0];
+    if (!first) {
+        throw new Error("the catalog has no AI provider with a chat route");
+    }
+    const capability = lookup.get(first.id);
+    if (!canBeAiDefault(capability))
+        throw new Error("unreachable");
+    return resolve(first.id, capability, configured ? "order" : "none", undefined, problem);
+}
+/**
+ * The sentence setup shows for an unconfigured default: the one key to
+ * set, and the alternatives in the order.
+ */
+export function aiDefaultSetupHint(resolution) {
+    const others = resolution.candidates
+        .filter((candidate) => candidate.id !== resolution.provider)
+        .slice(0, 3)
+        .map((candidate) => `${candidate.label} (${candidate.settings.join(" and ")})`);
+    const head = resolution.source === "setting"
+        ? `The Gateway's default model provider is ${resolution.label}; set ${resolution.settings.join(" and ")}.`
+        : `Any one model provider's key makes the app work; ${resolution.label} is first in the order: set ${resolution.settings.join(" and ")}.`;
+    return others.length > 0
+        ? `${head} Or another: ${others.join(", ")}; pick one with everyapp ai default <provider>.`
+        : head;
+}

package/dist/internal/aiProviders.d.ts

@@ -7,9 +7,12 @@
  * this derives the fallback's view of each, and holds the one response
  * rewrite the gateway has (Workers AI's numeric tokens).
  */
-import { type AiProviderCapability, type AiProviderId, type ApiKeyAuth, type CapabilitySettings } from "./capabilities.js";
+import { type AiProviderCapability, type AiProviderId, type AiRoute, type ApiKeyAuth, type CapabilitySettings } from "./capabilities.js";
 export interface DevAiProviderSpec {
     origin: string;
+    /** The routes the default maps onto in dev, with the model filled in (the entry's `chat` and `embeddings`). */
+    chat?: AiRoute;
+    embeddings?: AiRoute;
     /** The gateway secret holding the provider key; in local dev, the `.dev.vars` name. */
     keyEnv: string;
     /** Where the key goes on a request (`authorizationOf`). */

package/dist/internal/aiProviders.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"aiProviders.d.ts","sourceRoot":"","sources":["../../src/internal/aiProviders.ts"],"names":[],"mappings":"AAAA;;;;;;;;GAQG;AACH,OAAO,EAGL,KAAK,oBAAoB,EACzB,KAAK,YAAY,EACjB,KAAK,UAAU,EACf,KAAK,kBAAkB,EACxB,MAAM,mBAAmB,CAAC;AAE3B,MAAM,WAAW,iBAAiB;IAChC,MAAM,EAAE,MAAM,CAAC;IACf,uFAAuF;IACvF,MAAM,EAAE,MAAM,CAAC;IACf,2DAA2D;IAC3D,IAAI,EAAE,UAAU,CAAC;IACjB,oEAAoE;IACpE,IAAI,EAAE,MAAM,CAAC;IACb,0FAA0F;IAC1F,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,uFAAuF;IACvF,SAAS,CAAC,EAAE,SAAS,MAAM,EAAE,CAAC;IAC9B,wEAAwE;IACxE,QAAQ,CAAC,EAAE,CAAC,QAAQ,EAAE,QAAQ,CAAC,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC,KAAK,MAAM,CAAC;IAClE,8EAA8E;IAC9E,iBAAiB,CAAC,EAAE,CAAC,IAAI,EAAE,MAAM,EAAE,QAAQ,EAAE,QAAQ,KAAK,QAAQ,CAAC;CACpE;AAED,MAAM,MAAM,aAAa,GAAG,YAAY,CAAC;AAEzC,qDAAqD;AACrD,wBAAgB,iBAAiB,CAC/B,UAAU,EAAE,oBAAoB,GAC/B,iBAAiB,CAkBnB;AAED,eAAO,MAAM,gBAAgB,EAAE,QAAQ,CACrC,MAAM,CAAC,aAAa,EAAE,iBAAiB,CAAC,CAQG,CAAC;AAE9C,wBAAgB,aAAa,CAAC,IAAI,EAAE,MAAM,GAAG,iBAAiB,GAAG,SAAS,CAIzE;AAED,gGAAgG;AAChG,wBAAgB,kBAAkB,CAAC,IAAI,EAAE,iBAAiB,GAAG,MAAM,EAAE,CAEpE;AAED;;;;;GAKG;AACH,wBAAgB,YAAY,CAC1B,QAAQ,EAAE,MAAM,EAChB,QAAQ,EAAE,kBAAkB,GAC3B,MAAM,GAAG,IAAI,CAcf;AAED;;;;GAIG;AACH,wBAAgB,SAAS,CACvB,UAAU,EAAE,oBAAoB,EAChC,QAAQ,EAAE,kBAAkB,GAC3B,MAAM,GAAG,IAAI,CAIf;AAED,6DAA6D;AAC7D,wBAAgB,iBAAiB,CAAC,SAAS,EAAE,MAAM,GAAG,MAAM,CAE3D;AAED;;;;;GAKG;AACH,wBAAgB,eAAe,CAC7B,IAAI,EAAE,MAAM,EACZ,IAAI,EAAE,MAAM,EACZ,MAAM,SAAK,GACV,GAAG,GAAG,IAAI,CAOZ;AAWD;;;;;;;;GAQG;AACH,wBAAgB,0BAA0B,CACxC,IAAI,EAAE,MAAM,EACZ,QAAQ,EAAE,QAAQ,GACjB,QAAQ,CAqBV"}
+{"version":3,"file":"aiProviders.d.ts","sourceRoot":"","sources":["../../src/internal/aiProviders.ts"],"names":[],"mappings":"AAAA;;;;;;;;GAQG;AACH,OAAO,EAGL,KAAK,oBAAoB,EACzB,KAAK,YAAY,EACjB,KAAK,OAAO,EACZ,KAAK,UAAU,EACf,KAAK,kBAAkB,EACxB,MAAM,mBAAmB,CAAC;AAE3B,MAAM,WAAW,iBAAiB;IAChC,MAAM,EAAE,MAAM,CAAC;IACf,+GAA+G;IAC/G,IAAI,CAAC,EAAE,OAAO,CAAC;IACf,UAAU,CAAC,EAAE,OAAO,CAAC;IACrB,uFAAuF;IACvF,MAAM,EAAE,MAAM,CAAC;IACf,2DAA2D;IAC3D,IAAI,EAAE,UAAU,CAAC;IACjB,oEAAoE;IACpE,IAAI,EAAE,MAAM,CAAC;IACb,0FAA0F;IAC1F,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,uFAAuF;IACvF,SAAS,CAAC,EAAE,SAAS,MAAM,EAAE,CAAC;IAC9B,wEAAwE;IACxE,QAAQ,CAAC,EAAE,CAAC,QAAQ,EAAE,QAAQ,CAAC,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC,KAAK,MAAM,CAAC;IAClE,8EAA8E;IAC9E,iBAAiB,CAAC,EAAE,CAAC,IAAI,EAAE,MAAM,EAAE,QAAQ,EAAE,QAAQ,KAAK,QAAQ,CAAC;CACpE;AAED,MAAM,MAAM,aAAa,GAAG,YAAY,CAAC;AAEzC,qDAAqD;AACrD,wBAAgB,iBAAiB,CAC/B,UAAU,EAAE,oBAAoB,GAC/B,iBAAiB,CAoBnB;AAED,eAAO,MAAM,gBAAgB,EAAE,QAAQ,CACrC,MAAM,CAAC,aAAa,EAAE,iBAAiB,CAAC,CAUG,CAAC;AAE9C,wBAAgB,aAAa,CAAC,IAAI,EAAE,MAAM,GAAG,iBAAiB,GAAG,SAAS,CAIzE;AAED,gGAAgG;AAChG,wBAAgB,kBAAkB,CAAC,IAAI,EAAE,iBAAiB,GAAG,MAAM,EAAE,CAEpE;AAED;;;;;GAKG;AACH,wBAAgB,YAAY,CAC1B,QAAQ,EAAE,MAAM,EAChB,QAAQ,EAAE,kBAAkB,GAC3B,MAAM,GAAG,IAAI,CAcf;AAED;;;;GAIG;AACH,wBAAgB,SAAS,CACvB,UAAU,EAAE,oBAAoB,EAChC,QAAQ,EAAE,kBAAkB,GAC3B,MAAM,GAAG,IAAI,CAIf;AAED,6DAA6D;AAC7D,wBAAgB,iBAAiB,CAAC,SAAS,EAAE,MAAM,GAAG,MAAM,CAE3D;AAED;;;;;GAKG;AACH,wBAAgB,eAAe,CAC7B,IAAI,EAAE,MAAM,EACZ,IAAI,EAAE,MAAM,EACZ,MAAM,SAAK,GACV,GAAG,GAAG,IAAI,CAOZ;AAWD;;;;;;;;GAQG;AACH,wBAAgB,0BAA0B,CACxC,IAAI,EAAE,MAAM,EACZ,QAAQ,EAAE,QAAQ,GACjB,QAAQ,CAqBV"}

package/dist/internal/aiProviders.js

@@ -13,6 +13,8 @@ export function devAiProviderSpec(capability) {
     const { basePath, normalize } = capability;
     return {
         origin: capability.origin,
+        ...(capability.chat ? { chat: capability.chat } : {}),
+        ...(capability.embeddings ? { embeddings: capability.embeddings } : {}),
         keyEnv: capability.auth.secret,
         auth: capability.auth,
         docs: capability.docs,
@@ -30,7 +32,9 @@ export function devAiProviderSpec(capability) {
 }
 export const DEV_AI_PROVIDERS = Object.fromEntries(CAPABILITY_IDS.flatMap((id) => {
     const capability = CAPABILITIES[id];
-    return capability.mode === "ai"
+    // The proxy entry (AI Gateway) serves no models: never a dev target.
+    return capability.mode === "ai" &&
+        !("kind" in capability && capability.kind === "proxy")
         ? [[id, devAiProviderSpec(capability)]]
         : [];
 }));

package/dist/internal/appSettings.d.ts

@@ -23,6 +23,7 @@
  * the app Worker's secret names.
  */
 import { type ApiKeyCapability, type CapabilityLookup } from "./capabilities.js";
+import { type AiDefaultChoice, type IsSet } from "./aiDefault.js";
 /** A provider as `providers` lists it: its id, or an entry with a need. */
 export interface ProviderEntry extends SettingNeedFields {
     id: string;
@@ -62,12 +63,16 @@ export interface SettingsManifestLike {
     readonly secrets?: ReadonlyArray<string | SecretEntry>;
     readonly ai?: {
         readonly routes?: readonly string[];
+        /** The app needs the Gateway's default chat model (`/api/ai/default`): `true`, or an entry with its need. */
+        readonly chat?: boolean | SettingNeedFields;
     };
     /** A remote MCP app's registration (./remoteMcp.ts): its credential is a required Gateway setting. */
     readonly remote?: unknown;
     readonly name?: string;
 }
 export type SettingKind = "provider" | "capability" | "secret" | "ai-routes"
+/** The Gateway's default model provider (`ai.chat`): one key of any provider in the order, or the operator's choice. */
+ | "ai-default"
 /** A remote MCP app's credential (./remoteMcp.ts): one Gateway setting named by the row. */
  | "remote-mcp";
 /** Which Worker holds a setting: the Gateway's, or the app's own. */
@@ -80,6 +85,13 @@ export type SettingNeed = {
     kind: "anyOf";
     group: string;
 };
+/** What `appSettings` may be told about the Gateway, for the default model provider. */
+export interface AppSettingsOptions {
+    /** The operator's stored default (`everyapp ai default`), or none. */
+    aiDefault?: AiDefaultChoice | null;
+    /** What is set, to put the configured provider first; absent, the order decides. */
+    isSet?: IsSet;
+}
 /** One thing the app needs set, as the manifest declares it. */
 export interface AppSetting {
     kind: SettingKind;
@@ -88,8 +100,14 @@ export interface AppSetting {
     /** "OpenRouter", "DataForSEO", "MAIN_SECRET", "AI proxy routes". */
     label: string;
     holder: SettingHolder;
-    /** Every one of these must be set for the setting to count as set. */
+    /** Every one of these must be set for the setting to count as set (or any one group of `alternatives`). */
     names: string[];
+    /**
+     * For the default model provider: the settings of each provider that
+     * could serve it, any one group of which, all set, makes the setting
+     * set; `names` is the first group, what to ask for.
+     */
+    alternatives?: string[][];
     /** Read when set, never required (a capability's optional settings). */
     alsoReads: string[];
     need: SettingNeed;
@@ -157,7 +175,7 @@ export declare function secretNames(manifest: Pick<SettingsManifestLike, "secret
  * which is always set. `lookup` is where ids are found: the catalog alone
  * by default, or a gateway's registry with its registered rows.
  */
-export declare function appSettings(manifest: SettingsManifestLike, lookup?: CapabilityLookup): AppSetting[];
+export declare function appSettings(manifest: SettingsManifestLike, lookup?: CapabilityLookup, options?: AppSettingsOptions): AppSetting[];
 export interface EvaluateOptions {
     /**
      * A capability's own readiness rule, where names alone don't say (the

package/dist/internal/appSettings.d.ts.map

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

package/dist/internal/appSettings.js

@@ -23,6 +23,7 @@
  * the app Worker's secret names.
  */
 import { CATALOG, capabilitySettings, } from "./capabilities.js";
+import { aiDefaultSetupHint, aiRequiredSettings, resolveAiDefault, } from "./aiDefault.js";
 import { isInstallOwnedGatewaySetting, isSettableGatewaySetting, } from "./gatewaySettings.js";
 import { remoteMcpAuthLabel, remoteMcpOf, remoteMcpSecretOf, } from "./remoteMcp.js";
 /** The need an entry declares; required unless it says otherwise. */
@@ -86,7 +87,8 @@ export function secretNames(manifest) {
  * registered row's are its own, so they count too.
  */
 function providerNames(capability) {
-    return capabilitySettings(capability).filter((name) => !isInstallOwnedGatewaySetting(name));
+    // An optional key (AI Gateway's own token) is never a need.
+    return aiRequiredSettings(capability).filter((name) => !isInstallOwnedGatewaySetting(name));
 }
 /** A capability's Gateway settings: what it needs, and what it also reads. */
 function capabilityNames(capability) {
@@ -173,8 +175,37 @@ function withNeed(setting, entry, defaults = {}) {
  * which is always set. `lookup` is where ids are found: the catalog alone
  * by default, or a gateway's registry with its registered rows.
  */
-export function appSettings(manifest, lookup = CATALOG) {
+export function appSettings(manifest, lookup = CATALOG, options = {}) {
     const settings = [];
+    const chat = manifest.ai?.chat;
+    if (chat === true || (chat && typeof chat === "object")) {
+        // The default resolves on what is set: with nothing set, the first of
+        // the order (or the operator's choice) and its settings are what to
+        // ask for; with one configured, that provider's. `isSet` here only
+        // orders the candidates; evaluateAppSettings decides what is set.
+        const resolution = resolveAiDefault({
+            choice: options.aiDefault ?? null,
+            isSet: options.isSet ?? (() => false),
+            lookup,
+        });
+        const settable = (names) => names.filter((name) => !isInstallOwnedGatewaySetting(name));
+        const provider = lookup.get(resolution.provider);
+        settings.push(withNeed({
+            kind: "ai-default",
+            id: "ai-default",
+            label: `A chat model (${resolution.label})`,
+            holder: "gateway",
+            names: settable(resolution.settings),
+            alsoReads: [],
+            alternatives: resolution.candidates
+                .map((candidate) => settable(candidate.settings))
+                .filter((names) => names.length > 0),
+        }, chat === true ? undefined : chat, {
+            ...(provider?.mode === "ai" ? { docs: provider.docs } : {}),
+            setup: "setup/ai.md",
+            hint: aiDefaultSetupHint(resolution),
+        }));
+    }
     for (const entry of providerEntries(manifest)) {
         const capability = lookup.get(entry.id);
         if (capability?.mode !== "ai")
@@ -259,15 +290,30 @@ export function appSettings(manifest, lookup = CATALOG) {
 }
 /** Whether each name of `setting` is set: all → true, one unset → false, else unknown. */
 function settingIsSet(setting, isSet) {
+    const groupIsSet = (names) => {
+        let unknown = false;
+        for (const name of names) {
+            const state = isSet(setting.holder, name);
+            if (state === false)
+                return false;
+            if (state === null)
+                unknown = true;
+        }
+        return unknown ? null : true;
+    };
+    if (!setting.alternatives?.length)
+        return groupIsSet(setting.names);
+    // Any one provider configured makes the default serve; unknown only
+    // when no group is set and one couldn't be read.
     let unknown = false;
-    for (const name of setting.names) {
-        const state = isSet(setting.holder, name);
-        if (state === false)
-            return false;
+    for (const names of setting.alternatives) {
+        const state = groupIsSet(names);
+        if (state === true)
+            return true;
         if (state === null)
             unknown = true;
     }
-    return unknown ? null : true;
+    return unknown ? null : false;
 }
 /**
  * Every setting against what is set. `isSet` answers per holder and name: