@every-app/sdk 0.3.0-rc.10 → 0.3.0-rc.12

package/dist/internal/aiDefault.d.ts

@@ -1,13 +1,15 @@
 /**
  * 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
+ * chat model" (manifest `ai: { chat: true }`, the SDK's `aiBaseUrl()`, 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.
+ * The default is one setting per workspace, `<provider>[/<model>]`
+ * (`everyapp ai default`, Manage workspace → Usage → AI default, the
+ * `everyapp_ai_default` tool; `org_settings.ai_default`): the provider is
+ * everything up to the first slash, the model everything after it. With
+ * no setting, the shipped order below decides: the 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.
@@ -15,10 +17,9 @@
  * and fronts whichever provider the default resolves to when
  * `AI_GATEWAY_ID` is set (./capabilities.ts, `aig`).
  *
- * The models resolve the same way: the operator's model setting for the
- * provider (`everyapp ai model <provider> --chat … --embeddings …`,
- * `org_settings.ai_models`), else the catalog entry's seed (`chat.seedModel`,
- * `embeddings.seedModel`). Nothing reads a seed except through here.
+ * The chat model is the setting's model, else the catalog entry's seed
+ * (`chat.seedModel`); embeddings always use the entry's seed
+ * (`embeddings.seedModel`). Nothing reads a seed except through here.
  *
  * 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`.
@@ -44,39 +45,18 @@ export declare const AI_DEFAULT_ROUTES: {
 };
 export type AiDefaultRoute = keyof typeof AI_DEFAULT_ROUTES;
 /**
- * A choice as typed (`everyapp ai default openrouter/anthropic/claude-sonnet-5.5`,
- * the Usage page's dialog, `everyapp_ai_default`): the provider, and the
- * chat model to store for it. The provider goes to `org_settings.ai_default`,
- * the model to that provider's `chat` in `org_settings.ai_models`.
+ * The workspace's one setting, as typed (`everyapp ai default
+ * openrouter/anthropic/claude-sonnet-5.5`, the Usage page's dialog,
+ * `everyapp_ai_default`) and stored (`org_settings.ai_default`): the
+ * provider, and the chat model to fill in when an app names none (the
+ * provider's seed when left out).
  */
 export interface AiDefaultChoice {
     provider: string;
     model?: string;
 }
-/** The operator's models for one provider; a field left out serves the seed. */
-export interface AiModelSetting {
-    chat?: string;
-    embeddings?: string;
-}
-/** The operator's models by provider id (`org_settings.ai_models`, JSON). */
-export type AiModelSettings = Readonly<Record<string, AiModelSetting>>;
-/** A change to one provider's models: a name sets it, null puts the seed back, absent leaves it. */
-export interface AiModelPatch {
-    chat?: string | null;
-    embeddings?: string | null;
-}
 /** Whether `value` can be a model id: 1 to 200 characters, no surrounding or control whitespace. */
 export declare function isAiModelName(value: string): boolean;
-/**
- * `org_settings.ai_models` as stored: a JSON object of provider id →
- * `{ chat?, embeddings? }`. Anything else (null, malformed JSON, a field
- * that isn't a model name) reads as no setting, so the seed serves.
- */
-export declare function parseAiModelSettings(value: string | null | undefined): AiModelSettings;
-/** The stored text of the settings, providers sorted; null when nothing is set. */
-export declare function formatAiModelSettings(settings: AiModelSettings): string | null;
-/** `settings` with one provider's models changed by `patch`. */
-export declare function withAiModelSetting(settings: AiModelSettings, provider: string, patch: AiModelPatch): AiModelSettings;
 /**
  * `openrouter` or `openrouter/anthropic/claude-haiku-5.5` as typed:
  * the provider id up to the first slash, the model after it (a model id
@@ -85,12 +65,6 @@ export declare function withAiModelSetting(settings: AiModelSettings, provider:
 export declare function parseAiDefaultChoice(value: string | null | undefined): AiDefaultChoice | null;
 /** The text of a choice: `provider` or `provider/model`. */
 export declare function formatAiDefaultChoice(choice: AiDefaultChoice): string;
-/**
- * The provider id `org_settings.ai_default` holds, or null. The column
- * holds the provider alone (its models are in `ai_models`); text after a
- * first slash is not read.
- */
-export declare function parseAiDefaultProvider(value: string | null | undefined): string | null;
 /** 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. */
@@ -99,9 +73,10 @@ export type AiDefaultCapability = AiProviderCapability & {
 };
 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`).
+ * The Gateway settings an `ai` entry needs before it serves: every setting
+ * its `auth` names, the key and a Basic username held as a setting (unless
+ * the entry works without them, `authOptional`), and what its URL needs
+ * besides (`alsoNeeds`).
  */
 export declare function aiRequiredSettings(capability: AiProviderCapability): string[];
 /** Whether every setting the entry needs is set. */
@@ -117,22 +92,17 @@ export interface AiDefaultCandidate {
     /** The Gateway settings it needs; what to set when it isn't configured. */
     settings: string[];
     configured: boolean;
-    /** The chat model the Gateway fills in when the app names none: the operator's setting, else the seed. */
+    /** The catalog's chat model (the seed): what it serves when chosen without a model. */
     model: string;
-    /** The embeddings model, the same way; absent when the entry has no embeddings route. */
+    /** The catalog's embeddings model; absent when the entry has no embeddings route. */
     embeddingsModel?: string;
-    /** The catalog's seeds: what serves where the operator set no model. */
-    seed: {
-        chat: string;
-        embeddings?: 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. */
+/** The workspace's setting. */
 "setting"
 /** The shipped order: the first provider that is configured. */
  | "order"
@@ -141,15 +111,10 @@ export type AiDefaultSource =
 export interface AiDefaultResolution {
     provider: string;
     label: string;
-    /** The chat model the default serves: the operator's setting for the provider, else the seed. */
+    /** The chat model the default serves: the setting's model, else the provider's seed. */
     model: string;
-    /** The embeddings model, the same way; absent when the provider has no embeddings route. */
+    /** The embeddings model (the provider's seed); absent when the provider has no embeddings route. */
     embeddingsModel?: string;
-    /** The provider's seeds. */
-    seed: {
-        chat: string;
-        embeddings?: string;
-    };
     source: AiDefaultSource;
     /** Every setting the provider needs is set, so the default serves. */
     configured: boolean;
@@ -158,12 +123,12 @@ export interface AiDefaultResolution {
     via: "ai-gateway" | "direct";
     chat: AiRoute;
     embeddings?: AiRoute;
-    /** Every provider the default could be, in the shipped order, the choice first. */
+    /** Every provider the default could be, in the shipped order, the chosen one 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.
+     * The setting 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;
 }
@@ -172,27 +137,19 @@ export interface AiDefaultResolution {
  * 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, models?: AiModelSettings): AiDefaultCandidate[];
-/** Why `choice.provider` can't be the default, or null when it can. */
+export declare function aiDefaultCandidates(isSet: IsSet, lookup?: CapabilityLookup): AiDefaultCandidate[];
+/** Why `choice` can't be the default, or null when it can. */
 export declare function aiDefaultChoiceProblem(choice: AiDefaultChoice, lookup?: CapabilityLookup): string | null;
 /**
- * Why `patch` can't be stored for `provider`, or null when it can: the
- * provider must be one the default can be, a model name must be a model
- * name, and an embeddings model needs the entry's embeddings route.
- */
-export declare function aiModelPatchProblem(provider: string, patch: AiModelPatch, 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
+ * The Gateway's effective default, from the workspace's setting (or none)
+ * and what is set. A setting 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
+ * says what to set); a setting the default can't be is reported as
  * `problem` and the order decides.
  */
 export declare function resolveAiDefault(input: {
-    /** The stored provider (`org_settings.ai_default`), or null for the shipped order. */
-    provider: string | null;
-    /** The operator's models by provider (`org_settings.ai_models`); none: the seeds serve. */
-    models?: AiModelSettings;
+    /** The workspace's setting (`org_settings.ai_default`), or null for the shipped order. */
+    choice: AiDefaultChoice | null;
     isSet: IsSet;
     lookup?: CapabilityLookup;
 }): AiDefaultResolution;

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

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

package/dist/internal/aiDefault.js

@@ -1,13 +1,15 @@
 /**
  * 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
+ * chat model" (manifest `ai: { chat: true }`, the SDK's `aiBaseUrl()`, 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.
+ * The default is one setting per workspace, `<provider>[/<model>]`
+ * (`everyapp ai default`, Manage workspace → Usage → AI default, the
+ * `everyapp_ai_default` tool; `org_settings.ai_default`): the provider is
+ * everything up to the first slash, the model everything after it. With
+ * no setting, the shipped order below decides: the 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.
@@ -15,15 +17,14 @@
  * and fronts whichever provider the default resolves to when
  * `AI_GATEWAY_ID` is set (./capabilities.ts, `aig`).
  *
- * The models resolve the same way: the operator's model setting for the
- * provider (`everyapp ai model <provider> --chat … --embeddings …`,
- * `org_settings.ai_models`), else the catalog entry's seed (`chat.seedModel`,
- * `embeddings.seedModel`). Nothing reads a seed except through here.
+ * The chat model is the setting's model, else the catalog entry's seed
+ * (`chat.seedModel`); embeddings always use the entry's seed
+ * (`embeddings.seedModel`). Nothing reads a seed except through here.
  *
  * 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";
+import { CATALOG, authSettingNames, } 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. */
@@ -60,74 +61,6 @@ export function isAiModelName(value) {
         value.trim() === value &&
         !/[\u0000-\u001f\u007f]/.test(value));
 }
-/**
- * `org_settings.ai_models` as stored: a JSON object of provider id →
- * `{ chat?, embeddings? }`. Anything else (null, malformed JSON, a field
- * that isn't a model name) reads as no setting, so the seed serves.
- */
-export function parseAiModelSettings(value) {
-    if (typeof value !== "string" || value.trim() === "")
-        return {};
-    let parsed;
-    try {
-        parsed = JSON.parse(value);
-    }
-    catch {
-        return {};
-    }
-    if (!parsed || typeof parsed !== "object" || Array.isArray(parsed))
-        return {};
-    const settings = {};
-    for (const [provider, entry] of Object.entries(parsed)) {
-        if (!entry || typeof entry !== "object" || Array.isArray(entry))
-            continue;
-        const setting = {};
-        for (const kind of ["chat", "embeddings"]) {
-            const model = entry[kind];
-            if (typeof model === "string" && isAiModelName(model)) {
-                setting[kind] = model;
-            }
-        }
-        if (setting.chat !== undefined || setting.embeddings !== undefined) {
-            settings[provider] = setting;
-        }
-    }
-    return settings;
-}
-/** The stored text of the settings, providers sorted; null when nothing is set. */
-export function formatAiModelSettings(settings) {
-    const providers = Object.keys(settings)
-        .filter((id) => settings[id]?.chat !== undefined ||
-        settings[id]?.embeddings !== undefined)
-        .sort();
-    if (providers.length === 0)
-        return null;
-    return JSON.stringify(Object.fromEntries(providers.map((id) => {
-        const { chat, embeddings } = settings[id];
-        return [
-            id,
-            {
-                ...(chat === undefined ? {} : { chat }),
-                ...(embeddings === undefined ? {} : { embeddings }),
-            },
-        ];
-    })));
-}
-/** `settings` with one provider's models changed by `patch`. */
-export function withAiModelSetting(settings, provider, patch) {
-    const next = { ...settings[provider] };
-    for (const kind of ["chat", "embeddings"]) {
-        const value = patch[kind];
-        if (value === null)
-            delete next[kind];
-        else if (value !== undefined)
-            next[kind] = value;
-    }
-    const rest = Object.fromEntries(Object.entries(settings).filter(([id]) => id !== provider));
-    return next.chat === undefined && next.embeddings === undefined
-        ? rest
-        : { ...rest, [provider]: next };
-}
 /** A 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}))?$/;
 /**
@@ -148,27 +81,20 @@ export function parseAiDefaultChoice(value) {
 export function formatAiDefaultChoice(choice) {
     return choice.model ? `${choice.provider}/${choice.model}` : choice.provider;
 }
-/**
- * The provider id `org_settings.ai_default` holds, or null. The column
- * holds the provider alone (its models are in `ai_models`); text after a
- * first slash is not read.
- */
-export function parseAiDefaultProvider(value) {
-    return parseAiDefaultChoice(value)?.provider ?? null;
-}
 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`).
+ * The Gateway settings an `ai` entry needs before it serves: every setting
+ * its `auth` names, the key and a Basic username held as a setting (unless
+ * the entry works without them, `authOptional`), and what its URL needs
+ * besides (`alsoNeeds`).
  */
 export function aiRequiredSettings(capability) {
     return [
-        ...(capability.authOptional ? [] : [capability.auth.secret]),
+        ...(capability.authOptional ? [] : authSettingNames(capability.auth)),
         ...(capability.alsoNeeds ?? []),
     ];
 }
@@ -184,28 +110,16 @@ export function aiGatewayConfigured(isSet) {
 export function viaAiGateway(capability, isSet) {
     return capability.aig !== undefined && aiGatewayConfigured(isSet);
 }
-/** The provider's models: the operator's setting, else the seed. */
-function modelsOf(id, capability, models) {
-    const setting = models[id];
-    const { chat, embeddings } = capability;
-    return {
-        model: setting?.chat ?? chat.seedModel,
-        ...(embeddings
-            ? { embeddingsModel: setting?.embeddings ?? embeddings.seedModel }
-            : {}),
-        seed: {
-            chat: chat.seedModel,
-            ...(embeddings ? { embeddings: embeddings.seedModel } : {}),
-        },
-    };
-}
-function candidateOf(id, capability, isSet, models) {
+function candidateOf(id, capability, isSet) {
     return {
         id,
         label: capability.label,
         settings: aiRequiredSettings(capability),
         configured: aiProviderConfigured(capability, isSet),
-        ...modelsOf(id, capability, models),
+        model: capability.chat.seedModel,
+        ...(capability.embeddings
+            ? { embeddingsModel: capability.embeddings.seedModel }
+            : {}),
         viaAiGateway: viaAiGateway(capability, isSet),
         embeddings: capability.embeddings !== undefined,
     };
@@ -215,7 +129,7 @@ function candidateOf(id, capability, isSet, models) {
  * 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, models = {}) {
+export function aiDefaultCandidates(isSet, lookup = CATALOG) {
     const ids = [
         ...AI_DEFAULT_ORDER,
         ...lookup.ids().filter((id) => !AI_DEFAULT_ORDER.includes(id)),
@@ -225,12 +139,10 @@ export function aiDefaultCandidates(isSet, lookup = CATALOG, models = {}) {
         // A registered row whose key isn't bound to the hosts it has now reads
         // as unset everywhere (`providers.value-bound-to-hosts`).
         const set = lookup.bound && !lookup.bound(id) ? () => false : isSet;
-        return canBeAiDefault(capability)
-            ? [candidateOf(id, capability, set, models)]
-            : [];
+        return canBeAiDefault(capability) ? [candidateOf(id, capability, set)] : [];
     });
 }
-/** Why `choice.provider` can't be the default, or null when it can. */
+/** Why `choice` can't be the default, or null when it can. */
 export function aiDefaultChoiceProblem(choice, lookup = CATALOG) {
     const capability = lookup.get(choice.provider);
     if (!capability)
@@ -244,47 +156,29 @@ export function aiDefaultChoiceProblem(choice, lookup = CATALOG) {
     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;
-}
-/**
- * Why `patch` can't be stored for `provider`, or null when it can: the
- * provider must be one the default can be, a model name must be a model
- * name, and an embeddings model needs the entry's embeddings route.
- */
-export function aiModelPatchProblem(provider, patch, lookup = CATALOG) {
-    const why = aiDefaultChoiceProblem({ provider }, lookup);
-    if (why)
-        return why;
-    const capability = lookup.get(provider);
-    if (!canBeAiDefault(capability))
-        return `${provider} can't serve the default`;
-    for (const kind of ["chat", "embeddings"]) {
-        const value = patch[kind];
-        if (typeof value === "string" && !isAiModelName(value)) {
-            return `${JSON.stringify(value)} isn't a model id: 1 to 200 characters, no surrounding spaces`;
-        }
-    }
-    if (typeof patch.embeddings === "string" && !capability.embeddings) {
-        return `${capability.label} has no embeddings route, so it serves no embeddings model`;
+    if (choice.model !== undefined && !isAiModelName(choice.model)) {
+        return `${JSON.stringify(choice.model)} isn't a model id: 1 to 200 characters, no surrounding spaces`;
     }
     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
+ * The Gateway's effective default, from the workspace's setting (or none)
+ * and what is set. A setting 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
+ * says what to set); a setting the default can't be is reported as
  * `problem` and the order decides.
  */
 export function resolveAiDefault(input) {
     const lookup = input.lookup ?? CATALOG;
-    const models = input.models ?? {};
-    const { isSet } = input;
-    const candidates = aiDefaultCandidates(isSet, lookup, models);
-    const resolve = (id, capability, source, problem) => ({
+    const { isSet, choice } = input;
+    const candidates = aiDefaultCandidates(isSet, lookup);
+    const resolve = (id, capability, source, extra = {}) => ({
         provider: id,
         label: capability.label,
-        ...modelsOf(id, capability, models),
+        model: extra.model ?? capability.chat.seedModel,
+        ...(capability.embeddings
+            ? { embeddingsModel: capability.embeddings.seedModel }
+            : {}),
         source,
         configured: aiProviderConfigured(capability, isSet),
         settings: aiRequiredSettings(capability),
@@ -295,14 +189,16 @@ export function resolveAiDefault(input) {
             ...candidates.filter((candidate) => candidate.id === id),
             ...candidates.filter((candidate) => candidate.id !== id),
         ],
-        ...(problem ? { problem } : {}),
+        ...(extra.problem ? { problem: extra.problem } : {}),
     });
     let problem;
-    if (input.provider) {
-        const capability = lookup.get(input.provider);
-        const why = aiDefaultChoiceProblem({ provider: input.provider }, lookup);
+    if (choice) {
+        const capability = lookup.get(choice.provider);
+        const why = aiDefaultChoiceProblem(choice, lookup);
         if (!why && canBeAiDefault(capability)) {
-            return resolve(input.provider, capability, "setting");
+            return resolve(choice.provider, capability, "setting", {
+                ...(choice.model ? { model: choice.model } : {}),
+            });
         }
         problem = why ?? undefined;
     }
@@ -314,7 +210,9 @@ export function resolveAiDefault(input) {
     const capability = lookup.get(first.id);
     if (!canBeAiDefault(capability))
         throw new Error("unreachable");
-    return resolve(first.id, capability, configured ? "order" : "none", problem);
+    return resolve(first.id, capability, configured ? "order" : "none", {
+        ...(problem ? { problem } : {}),
+    });
 }
 /**
  * The sentence setup shows for an unconfigured default: the one key to

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,OAAO,EACZ,KAAK,UAAU,EACf,KAAK,kBAAkB,EACxB,MAAM,mBAAmB,CAAC;AAG3B,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,CAC3B,IAAI,EAAE,MAAM;AACZ,kHAAkH;AAClH,MAAM,CAAC,EAAE,QAAQ,CAAC,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC,GACzC,iBAAiB,GAAG,SAAS,CAS/B;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,EAIL,KAAK,oBAAoB,EACzB,KAAK,YAAY,EACjB,KAAK,OAAO,EACZ,KAAK,UAAU,EACf,KAAK,kBAAkB,EACxB,MAAM,mBAAmB,CAAC;AAG3B,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,CAC3B,IAAI,EAAE,MAAM;AACZ,kHAAkH;AAClH,MAAM,CAAC,EAAE,QAAQ,CAAC,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC,GACzC,iBAAiB,GAAG,SAAS,CAS/B;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

@@ -7,7 +7,7 @@
  * this derives the fallback's view of each, and holds the one response
  * rewrite the gateway has (Workers AI's numeric tokens).
  */
-import { CAPABILITIES, CAPABILITY_IDS, } from "./capabilities.js";
+import { CAPABILITIES, CAPABILITY_IDS, authSettingNames, } from "./capabilities.js";
 import { resolveDevProvider } from "./devProviders.js";
 /** The fallback's view of one `ai` catalog entry. */
 export function devAiProviderSpec(capability) {
@@ -54,7 +54,7 @@ values) {
 }
 /** Every setting a provider needs, its key first: the names `.dev.vars` and the gateway use. */
 export function aiProviderSettings(spec) {
-    return [spec.keyEnv, ...(spec.alsoNeeds ?? [])];
+    return [...authSettingNames(spec.auth), ...(spec.alsoNeeds ?? [])];
 }
 /**
  * An `ai` entry's `basePath` with each `{SETTING}` filled from the

package/dist/internal/appSettings.d.ts

@@ -70,9 +70,9 @@ export interface SettingNeedFields {
     /** The app works without it; the feature using it says so where it is used. */
     optional?: boolean;
     /**
-     * For an app's own secret: its setup guide, relative to the everyapp
-     * skill (`setup/main-secret.md`). Providers and capabilities take theirs
-     * from the registries and can't override it.
+     * For an app's own secret: its setup guide, a path in the app
+     * (`docs/setup/main-secret.md`). Providers and capabilities take theirs
+     * from the registries (guides in the everyapp skill) and can't override it.
      */
     setup?: string;
     /**
@@ -92,7 +92,6 @@ export interface SettingsManifestLike {
     readonly secrets?: ReadonlyArray<string | SecretEntry>;
     readonly settings?: ReadonlyArray<SettingEntry>;
     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;
     };
@@ -102,7 +101,7 @@ export interface SettingsManifestLike {
 }
 export type SettingKind = "provider" | "capability" | "secret"
 /** An app's plain setting (`settings`): a value on its Worker, not a key. */
- | "setting" | "ai-routes"
+ | "setting"
 /** 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. */
@@ -119,17 +118,15 @@ export type SettingNeed = {
 };
 /** What `appSettings` may be told about the Gateway, for the default model provider. */
 export interface AppSettingsOptions {
-    /** The operator's stored default provider (`everyapp ai default`), or none. */
-    aiDefault?: string | 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;
-    /** The provider id, capability id or secret name; "ai-routes" for the AI proxy's extra routes. */
+    /** The provider id, capability id or secret name. */
     id: string;
-    /** "OpenRouter", "DataForSEO", "MAIN_SECRET", "AI proxy routes". */
+    /** "OpenRouter", "DataForSEO", "MAIN_SECRET". */
     label: string;
     holder: SettingHolder;
     /** Every one of these must be set for the setting to count as set (or any one group of `alternatives`). */
@@ -146,11 +143,12 @@ export interface AppSetting {
     why?: string;
     docs?: string;
     /**
-     * The everyapp skill's setup guide for it, relative to the skill
-     * (`setup/dataforseo.md`; in an app `.claude/skills/everyapp/setup/…`, in
-     * the checkout `packages/cli/skills/everyapp/setup/…`): what an agent
-     * reads to set it up end to end. From the registries for providers and
-     * capabilities; from the manifest entry for an app's own secret.
+     * What an agent reads to set it up end to end. For providers and
+     * capabilities, the registry's guide in the everyapp skill, relative to the
+     * skill (`setup/dataforseo.md`; in an app
+     * `node_modules/everyapp/skills/everyapp/setup/…`, in the checkout
+     * `packages/cli/skills/everyapp/setup/…`). For an app's own secret, the
+     * manifest entry's guide, a path in the app (`docs/setup/main-secret.md`).
      */
     setup?: string;
     /**
@@ -188,7 +186,7 @@ export interface AnyOfGroup {
 export interface AppSettingsReport {
     /** No required setting is unset and every any-of group is met. */
     ready: boolean;
-    /** Every setting, in manifest order: providers, capabilities, the AI routes, secrets. */
+    /** Every setting, in manifest order: providers, capabilities, secrets. */
     settings: EvaluatedSetting[];
     groups: AnyOfGroup[];
     /** The settings that keep the app closed, in manifest order. */
@@ -228,8 +226,7 @@ export declare function settingValueTakes(rule: SettingValueRule): string;
 export declare function settingValueProblem(rule: Pick<SettingValueRule, "type" | "values">, value: string): string | null;
 /**
  * Every setting the manifest declares, in manifest order: its AI
- * providers, its capabilities, the AI proxy's extra routes when `ai.routes`
- * asks for any, then the app's own secrets. A provider or capability the
+ * providers, its capabilities, then the app's own secrets. A provider or capability the
  * gateway doesn't offer contributes nothing (the manifest validator refuses
  * it elsewhere); so does a capability with nothing to set (`members`),
  * which is always set. `lookup` is where ids are found: the catalog alone