@every-app/sdk 0.3.0-rc.5 → 0.3.0-rc.7

package/dist/internal/providerSpec.js

@@ -6,11 +6,15 @@
  * JSON into an {@link ApiKeyCapability} or names every problem; nothing
  * here reads a value: a spec names Gateway settings, never holds one.
  *
- * Two kinds parse: API-key providers (`auth.kind` bearer, header, query
- * or basic) and OAuth providers (`auth.kind` oauth2-user, the half in
+ * Three kinds parse: API-key providers (`auth.kind` bearer, header, query
+ * or basic), OAuth providers (`auth.kind` oauth2-user, the half in
  * ./oauthSpec.ts: the Gateway runs the flow and holds the tokens,
- * docs/design/2026-10-oauth-providers.md). An AI provider is a catalog
- * entry only; the parser says so rather than guessing.
+ * docs/design/2026-10-oauth-providers.md), and OpenAI-compatible model
+ * providers (`mode: "ai"`: a `baseUrl`, the key's placement, the models
+ * it serves and the default, its inference routes; the AI proxy serves a
+ * row exactly as it serves a catalog `ai` entry, inference POSTs alone,
+ * `store: false` on chat, the usage tap, so a new model vendor is a
+ * registered spec, not a catalog release).
  *
  * The rules that make a row safe on a particular gateway (its secret names
  * are its own, its hosts are public, it shadows no catalog entry) are the
@@ -60,6 +64,15 @@ const RESERVED_HEADERS = new Set([
 ]);
 const MAX_HOSTS = 20;
 const MAX_ACCOUNT_WIDE_PATHS = 50;
+/** An inference route an `ai` row names: `/v1/chat/completions`, segments of lowercase letters, digits, `_` and `-`. */
+const AI_ROUTE = /^(?:\/[a-z0-9_-]+)+$/;
+const MAX_AI_ROUTES = 20;
+const MAX_MODELS = 100;
+/** A model name as OpenAI-compatible APIs spell them: `gpt-6-luna`, `meta-llama/llama-4`, `claude-haiku-5-5:beta`. */
+const MODEL_NAME = /^[A-Za-z0-9][A-Za-z0-9._:/@-]{0,199}$/;
+/** What an `ai` row serves by default: chat, and embeddings when it names an embeddings model. */
+export const AI_SPEC_CHAT_ROUTE = "/v1/chat/completions";
+export const AI_SPEC_EMBEDDINGS_ROUTE = "/v1/embeddings";
 const KNOWN_FIELDS = new Set([
     "id",
     "mode",
@@ -87,7 +100,39 @@ const KNOWN_FIELDS = new Set([
     "scopeSets",
     "alwaysRequested",
     "tolerated",
+    // An `ai` spec's own.
+    "baseUrl",
+    "models",
+    "defaultModel",
+    "embeddingsModel",
+    "routes",
+    "chatRoute",
+    "embeddingsRoute",
 ]);
+/** Fields only an `ai` spec has. */
+const AI_ONLY_FIELDS = [
+    "baseUrl",
+    "models",
+    "defaultModel",
+    "embeddingsModel",
+    "routes",
+    "chatRoute",
+    "embeddingsRoute",
+];
+/** Fields an `ai` spec never has: the key goes to one base URL, and the AI proxy's rules replace the capability proxy's. */
+const NOT_AI_FIELDS = [
+    "hosts",
+    "hostSetting",
+    "data",
+    "access",
+    "readMethods",
+    "writeMethods",
+    "accountWidePaths",
+    ...OAUTH_ONLY_FIELDS_LIST(),
+];
+function OAUTH_ONLY_FIELDS_LIST() {
+    return ["scopeSets", "alwaysRequested", "tolerated"];
+}
 /** Fields an API-key spec has that an `oauth2-user` spec does not. */
 const API_KEY_ONLY_FIELDS = [
     "hostSetting",
@@ -624,13 +669,20 @@ export function parseProviderSpec(input) {
         });
     }
     const isOAuth = isRecord(input["auth"]) && input["auth"]["kind"] === "oauth2-user";
+    const isAi = input["mode"] === "ai";
     const expectedMode = isOAuth ? "oauth_client" : "api_key";
-    if (input["mode"] !== undefined && input["mode"] !== expectedMode) {
+    if (!isAi && input["mode"] !== undefined && input["mode"] !== expectedMode) {
         problems.push({
             path: "mode",
             message: isOAuth
                 ? "an oauth2-user spec's mode is oauth_client (or left out)"
-                : "this gateway registers api_key and oauth_client (auth.kind oauth2-user) providers; an AI provider is a catalog entry",
+                : 'this gateway registers api_key, oauth_client (auth.kind oauth2-user) and ai (mode: "ai", an OpenAI-compatible model provider) providers',
+        });
+    }
+    if (isAi && isOAuth) {
+        problems.push({
+            path: "auth.kind",
+            message: "an ai spec's key is a bearer, header, query or basic key, never oauth2-user",
         });
     }
     const name = text(input["name"], "name", problems, { max: 64 });
@@ -659,6 +711,9 @@ export function parseProviderSpec(input) {
             }
         },
     });
+    if (isAi && !isOAuth) {
+        return parseAiSpec(input, problems, { id, name, description, docs, api });
+    }
     if (isOAuth) {
         const { access, readMethods, writeMethods } = grants(input, problems);
         const hint = text(input["hint"], "hint", problems, { max: 500 });
@@ -789,6 +844,197 @@ export function parseProviderSpec(input) {
     };
     return { ok: true, id, capability };
 }
+/**
+ * The `ai` half of `parseProviderSpec`: an OpenAI-compatible model
+ * provider. `baseUrl` is where the app's path is joined (`https://api.groq.com/openai`:
+ * the origin, and a base path the proxy keeps in front of every route);
+ * `auth` places the key as an API-key spec does; `models` lists what the
+ * provider serves (1 to 100; the proxy refuses any other) with
+ * `defaultModel` the one the Gateway's default route fills in and
+ * `embeddingsModel` the one for `/api/ai/default/v1/embeddings`; `routes`
+ * are the inference paths apps may POST to (default chat, and embeddings
+ * with an embeddings model), `chatRoute` and `embeddingsRoute` which of
+ * them the default route maps onto. Chat answers are never stored
+ * (`store: false` on the chat route). `cost.responseField` is where the
+ * answer carries the call's price, read by the usage tap as OpenRouter's
+ * `usage.cost` is.
+ */
+function parseAiSpec(input, problems, common) {
+    for (const field of NOT_AI_FIELDS) {
+        if (input[field] !== undefined) {
+            problems.push({ path: field, message: "not a field of an ai spec" });
+        }
+    }
+    const base = httpsUrl(input["baseUrl"], "baseUrl", problems);
+    let origin;
+    let basePath;
+    if (input["baseUrl"] === undefined) {
+        problems.push({
+            path: "baseUrl",
+            message: "required: the https URL the app's paths are joined onto (https://api.groq.com/openai)",
+        });
+    }
+    else if (base !== undefined) {
+        const url = new URL(base);
+        if (url.search || url.hash || url.username || url.password || url.port) {
+            problems.push({
+                path: "baseUrl",
+                message: "must be an https URL with no query, fragment, credentials or port",
+            });
+        }
+        else if (!PROVIDER_HOST.test(url.hostname)) {
+            problems.push({
+                path: "baseUrl",
+                message: "must name a public host with a dot (api.groq.com)",
+            });
+        }
+        else {
+            origin = url.origin;
+            const path = url.pathname.replace(/\/+$/, "");
+            if (path && !AI_ROUTE.test(path)) {
+                problems.push({
+                    path: "baseUrl",
+                    message: "its path must be segments of lowercase letters, digits, _ and -",
+                });
+            }
+            else if (path) {
+                basePath = path;
+            }
+        }
+    }
+    const parsedAuth = auth(input["auth"], problems);
+    if (input["auth"] === undefined) {
+        problems.push({ path: "auth", message: "required" });
+    }
+    const secrets = secretDetails(input["secrets"], parsedAuth ? authSettingNames(parsedAuth) : [], problems);
+    const models = stringList(input["models"], "models", problems, {
+        max: MAX_MODELS,
+        each: (model, at) => {
+            if (!MODEL_NAME.test(model)) {
+                problems.push({
+                    path: at,
+                    message: "must be a model name (gpt-6-luna, meta-llama/llama-4)",
+                });
+            }
+        },
+    });
+    if (input["models"] === undefined || (models && models.length === 0)) {
+        problems.push({
+            path: "models",
+            message: "required: the models the provider serves, at least one",
+        });
+    }
+    const defaultModel = text(input["defaultModel"], "defaultModel", problems, {
+        max: 200,
+    });
+    if (input["defaultModel"] === undefined) {
+        problems.push({
+            path: "defaultModel",
+            message: "required: the chat model the Gateway fills in when an app names none; one of models",
+        });
+    }
+    else if (defaultModel !== undefined &&
+        models &&
+        !models.includes(defaultModel)) {
+        problems.push({ path: "defaultModel", message: "must be one of models" });
+    }
+    const embeddingsModel = text(input["embeddingsModel"], "embeddingsModel", problems, { max: 200 });
+    if (embeddingsModel !== undefined &&
+        models &&
+        !models.includes(embeddingsModel)) {
+        problems.push({
+            path: "embeddingsModel",
+            message: "must be one of models",
+        });
+    }
+    const routeList = (value, path) => stringList(value, path, problems, {
+        max: MAX_AI_ROUTES,
+        each: (route, at) => {
+            if (!AI_ROUTE.test(route)) {
+                problems.push({
+                    path: at,
+                    message: "must be a path of lowercase segments starting with / (/v1/chat/completions)",
+                });
+            }
+        },
+    });
+    const chatRoute = text(input["chatRoute"], "chatRoute", problems, { max: 200 }) ??
+        AI_SPEC_CHAT_ROUTE;
+    const embeddingsRoute = text(input["embeddingsRoute"], "embeddingsRoute", problems, { max: 200 }) ??
+        AI_SPEC_EMBEDDINGS_ROUTE;
+    for (const [field, route] of [
+        ["chatRoute", chatRoute],
+        ["embeddingsRoute", embeddingsRoute],
+    ]) {
+        if (!AI_ROUTE.test(route)) {
+            problems.push({
+                path: field,
+                message: "must be a path of lowercase segments starting with /",
+            });
+        }
+    }
+    const routes = routeList(input["routes"], "routes") ?? [
+        chatRoute,
+        ...(embeddingsModel !== undefined ? [embeddingsRoute] : []),
+    ];
+    if (routes.length === 0) {
+        problems.push({ path: "routes", message: "must list a route" });
+    }
+    if (!routes.includes(chatRoute)) {
+        problems.push({ path: "chatRoute", message: "must be one of routes" });
+    }
+    if (embeddingsModel !== undefined && !routes.includes(embeddingsRoute)) {
+        problems.push({
+            path: "embeddingsRoute",
+            message: "must be one of routes",
+        });
+    }
+    const hint = text(input["hint"], "hint", problems, { max: 500 });
+    const smokeRequest = smoke(input["smoke"], origin ? [new URL(origin).host] : [], problems);
+    const parsedCost = cost(input["cost"], problems);
+    const parsedRate = rate(input["rate"], problems);
+    const example = text(input["example"], "example", problems, { max: 200 });
+    const parsedVerified = verified(input["verified"], problems);
+    const tags = tagList(input["tags"], problems);
+    const { id, name, description, docs, api } = common;
+    if (problems.length > 0 ||
+        typeof id !== "string" ||
+        name === undefined ||
+        docs === undefined ||
+        origin === undefined ||
+        !parsedAuth ||
+        !models ||
+        defaultModel === undefined) {
+        return { ok: false, problems };
+    }
+    const capability = {
+        mode: "ai",
+        label: name,
+        auth: parsedAuth,
+        docs,
+        origin,
+        ...(basePath === undefined ? {} : { basePath }),
+        inferenceRoutes: routes,
+        unstoredRoutes: [chatRoute],
+        shape: "openai",
+        chat: { path: chatRoute, seedModel: defaultModel },
+        ...(embeddingsModel === undefined
+            ? {}
+            : { embeddings: { path: embeddingsRoute, seedModel: embeddingsModel } }),
+        models,
+        ...(description === undefined ? {} : { description }),
+        ...(api === undefined ? {} : { api }),
+        ...(secrets === undefined ? {} : { secrets }),
+        ...(hint === undefined ? {} : { hint }),
+        ...(smokeRequest === undefined ? {} : { smoke: smokeRequest }),
+        ...(parsedCost === undefined ? {} : { cost: parsedCost }),
+        ...(parsedRate === undefined ? {} : { rate: parsedRate }),
+        ...(example === undefined ? {} : { example }),
+        ...(parsedVerified === undefined ? {} : { verified: parsedVerified }),
+        ...(tags === undefined ? {} : { tags }),
+    };
+    return { ok: true, id, capability };
+}
 /** The problems as one line: `auth.secret: must name a Gateway setting; hosts.0: …`. */
 export function describeSpecProblems(problems) {
     return problems
@@ -809,6 +1055,58 @@ export function providerSpecOf(id, capability) {
         }
         return spec;
     }
+    if (capability.mode === "ai") {
+        if (!capability.chat || !capability.models) {
+            throw new Error(`${id} is a catalog AI entry without a model list: it has no spec`);
+        }
+        return {
+            id,
+            mode: "ai",
+            name: capability.label,
+            ...(capability.description === undefined
+                ? {}
+                : { description: capability.description }),
+            docs: capability.docs,
+            ...(capability.api === undefined ? {} : { api: capability.api }),
+            baseUrl: `${capability.origin}${capability.basePath ?? ""}`,
+            auth: { ...capability.auth },
+            ...(capability.secrets === undefined
+                ? {}
+                : { secrets: capability.secrets.map((detail) => ({ ...detail })) }),
+            models: [...capability.models],
+            defaultModel: capability.chat.seedModel,
+            ...(capability.embeddings === undefined
+                ? {}
+                : { embeddingsModel: capability.embeddings.seedModel }),
+            routes: [...capability.inferenceRoutes],
+            chatRoute: capability.chat.path,
+            ...(capability.embeddings === undefined
+                ? {}
+                : { embeddingsRoute: capability.embeddings.path }),
+            ...(capability.hint === undefined ? {} : { hint: capability.hint }),
+            ...(capability.smoke === undefined
+                ? {}
+                : {
+                    smoke: {
+                        ...capability.smoke,
+                        expect: [...capability.smoke.expect],
+                    },
+                }),
+            ...(capability.cost === undefined
+                ? {}
+                : { cost: { ...capability.cost } }),
+            ...(capability.rate === undefined
+                ? {}
+                : { rate: { ...capability.rate } }),
+            ...(capability.example === undefined
+                ? {}
+                : { example: capability.example }),
+            ...(capability.verified === undefined
+                ? {}
+                : { verified: capability.verified }),
+            ...(capability.tags === undefined ? {} : { tags: [...capability.tags] }),
+        };
+    }
     return {
         id,
         name: capability.label,
@@ -851,5 +1149,6 @@ export function providerSpecOf(id, capability) {
 }
 /** The methods an app with `access: "write"` may use on `capability` besides its read methods. */
 export function writeMethodsOf(capability) {
-    return capability.writeMethods ?? DEFAULT_WRITE_METHODS;
+    return ((capability.mode === "ai" ? undefined : capability.writeMethods) ??
+        DEFAULT_WRITE_METHODS);
 }

package/dist/manifest.d.ts

@@ -111,6 +111,24 @@ export interface EveryAppCapabilityEntry extends EveryAppSettingNeed {
     /** An OAuth client's scope sets, by name (`["gmail.read"]`). */
     readonly scopes?: readonly string[];
 }
+/**
+ * One of the app's plain settings: a value that isn't a secret and
+ * differs per install (a PostHog host, a region), set with `everyapp
+ * configure <app>` and read from `env`.
+ */
+export interface EveryAppSettingEntry {
+    readonly name: string;
+    /** Why the app needs it: what whoever installs the app reads. */
+    readonly why: string;
+    readonly docs?: string;
+    readonly optional?: boolean;
+    /** What it takes; text when not given. */
+    readonly type?: "text" | "url" | "number" | "boolean";
+    /** The values a text setting may take. */
+    readonly values?: readonly string[];
+    /** What the app reads while nobody has set it; the deploy writes it. */
+    readonly default?: string;
+}
 /** One of the app's own secrets, with its need. */
 export interface EveryAppSecretEntry extends EveryAppSettingNeed {
     readonly name: string;
@@ -145,6 +163,11 @@ export interface EveryAppManifest {
     readonly limits?: EveryAppWorkerLimits;
     /** Routes open without a signed-in member. Default: none. */
     readonly public?: readonly EveryAppPublicRoute[];
+    /**
+     * Static files of the asset bundle anyone may fetch (favicons, icons, an
+     * OG image): path patterns, GET and HEAD, never Worker code.
+     */
+    readonly publicAssets?: readonly string[];
     /** AI providers the Gateway calls for the app, by id or with their need. */
     readonly providers?: readonly (string | (EveryAppSettingNeed & {
         readonly id: string;
@@ -155,10 +178,8 @@ export interface EveryAppManifest {
     };
     /** The app's own secrets, by name or with their need. */
     readonly secrets?: readonly (string | EveryAppSecretEntry)[];
-    /** App-domain scopes personal access tokens may request, with descriptions. */
-    readonly scopes?: {
-        readonly [scope: string]: string;
-    };
+    /** The app's plain settings: per-install values that aren't secrets. */
+    readonly settings?: readonly EveryAppSettingEntry[];
     readonly ai?: {
         /** Model ids the app may request; any other is `model_not_allowed`. */
         readonly models?: readonly string[];

package/dist/manifest.d.ts.map

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

package/dist/server/ai.d.ts

@@ -20,7 +20,9 @@
  * under `providers` and calling `/api/ai/<provider>/…`.
  */
 import { AI_DEFAULT_MODEL } from "../internal/index.js";
+import { type GatewayCallFor } from "./attribution.js";
 import { type CreateGatewayFetchOptions } from "./gatewayFetch.js";
+import type { SetupInfo } from "./refusal.js";
 export interface AiClient {
     /** `http://every-app-gateway.internal/api/ai/default/v1`: an OpenAI client's base URL. */
     baseURL: string;
@@ -45,6 +47,49 @@ export declare function ai(options: CreateGatewayFetchOptions & {
     optional: true;
 }): AiClient | null;
 export declare function ai(options: CreateGatewayFetchOptions): AiClient;
+/** Whether model calls to a provider (or the default) would go through. */
+export interface AiStatus extends SetupInfo {
+    /** The id asked about: `default`, or a provider's (`openrouter`, `workers-ai`, …). */
+    provider: string;
+    /** The manifest asks for it: `ai.chat` for `default`, else `providers`. */
+    requested: boolean;
+    /** The Gateway (in local dev, `.dev.vars`) holds every setting it needs. */
+    configured: boolean;
+    /** Calls would go through. */
+    ready: boolean;
+    /**
+     * For `default`: the provider and model calls go to now, or null while
+     * none is configured. Null for a named provider.
+     */
+    resolved: {
+        provider: string;
+        label: string;
+        model: string;
+    } | null;
+}
+/**
+ * Whether the app can use a model right now, without calling one: gate
+ * an AI feature and show `setup` ("A chat model isn't set up on this
+ * Gateway: it needs OPENROUTER_API_KEY. An admin runs: pnpm everyapp
+ * configure inbox") up front instead of failing mid-task. `provider`
+ * defaults to `default`, the Gateway's default model (`ai: { chat: true }`);
+ * name one the manifest lists under `providers` to ask about it instead.
+ * The Gateway owns the wording: show `setup` and `command` as they are.
+ *
+ * Over the binding it sends `GET /api/ai/<provider>`; in local dev it
+ * answers from `.dev.vars` by the same rule `createGatewayFetch()` uses.
+ */
+export declare function aiStatus({ env, provider, for: explicitTarget, }: {
+    env: object;
+    provider?: string;
+    /**
+     * Whom the status is for: the default resolves on that organization's
+     * choice (`everyapp ai default`). Left out, the request `everyApp()` is
+     * serving or the organization `withOrganization()` named, as on every
+     * call.
+     */
+    for?: GatewayCallFor;
+}): Promise<AiStatus>;
 /**
  * A provider's root behind the Gateway, `http://every-app-gateway.internal/api/ai/<provider>`:
  * join the provider's own paths onto it (`/api/v1/chat/completions` for

package/dist/server/ai.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"ai.d.ts","sourceRoot":"","sources":["../../src/server/ai.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;GAoBG;AACH,OAAO,EACL,gBAAgB,EAIjB,MAAM,sBAAsB,CAAC;AAC9B,OAAO,EAGL,KAAK,yBAAyB,EAC/B,MAAM,mBAAmB,CAAC;AAE3B,MAAM,WAAW,QAAQ;IACvB,0FAA0F;IAC1F,OAAO,EAAE,MAAM,CAAC;IAChB,8EAA8E;IAC9E,KAAK,EAAE,OAAO,KAAK,CAAC;IACpB,gFAAgF;IAChF,KAAK,EAAE,OAAO,gBAAgB,CAAC;IAC/B,qEAAqE;IACrE,kBAAkB,EAAE,MAAM,CAAC;IAC3B,+DAA+D;IAC/D,aAAa,EAAE,MAAM,CAAC;CACvB;AAED,0EAA0E;AAC1E,eAAO,MAAM,mBAAmB,wDAAuD,CAAC;AAExF;;;;;GAKG;AACH,wBAAgB,EAAE,CAChB,OAAO,EAAE,yBAAyB,GAAG;IAAE,QAAQ,EAAE,IAAI,CAAA;CAAE,GACtD,QAAQ,GAAG,IAAI,CAAC;AACnB,wBAAgB,EAAE,CAAC,OAAO,EAAE,yBAAyB,GAAG,QAAQ,CAAC;AAejE;;;;;GAKG;AACH,wBAAgB,eAAe,CAAC,QAAQ,EAAE,MAAM,GAAG,MAAM,CAExD;AAED;;;;;;;;;GASG;AACH,wBAAgB,SAAS,CAAC,QAAQ,GAAE,MAA4B,GAAG,MAAM,CAaxE"}
+{"version":3,"file":"ai.d.ts","sourceRoot":"","sources":["../../src/server/ai.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;GAoBG;AACH,OAAO,EACL,gBAAgB,EAOjB,MAAM,sBAAsB,CAAC;AAC9B,OAAO,EAGL,KAAK,cAAc,EACpB,MAAM,kBAAkB,CAAC;AAC1B,OAAO,EAGL,KAAK,yBAAyB,EAE/B,MAAM,mBAAmB,CAAC;AAC3B,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,cAAc,CAAC;AAE9C,MAAM,WAAW,QAAQ;IACvB,0FAA0F;IAC1F,OAAO,EAAE,MAAM,CAAC;IAChB,8EAA8E;IAC9E,KAAK,EAAE,OAAO,KAAK,CAAC;IACpB,gFAAgF;IAChF,KAAK,EAAE,OAAO,gBAAgB,CAAC;IAC/B,qEAAqE;IACrE,kBAAkB,EAAE,MAAM,CAAC;IAC3B,+DAA+D;IAC/D,aAAa,EAAE,MAAM,CAAC;CACvB;AAED,0EAA0E;AAC1E,eAAO,MAAM,mBAAmB,wDAAuD,CAAC;AAExF;;;;;GAKG;AACH,wBAAgB,EAAE,CAChB,OAAO,EAAE,yBAAyB,GAAG;IAAE,QAAQ,EAAE,IAAI,CAAA;CAAE,GACtD,QAAQ,GAAG,IAAI,CAAC;AACnB,wBAAgB,EAAE,CAAC,OAAO,EAAE,yBAAyB,GAAG,QAAQ,CAAC;AAajE,2EAA2E;AAC3E,MAAM,WAAW,QAAS,SAAQ,SAAS;IACzC,sFAAsF;IACtF,QAAQ,EAAE,MAAM,CAAC;IACjB,2EAA2E;IAC3E,SAAS,EAAE,OAAO,CAAC;IACnB,4EAA4E;IAC5E,UAAU,EAAE,OAAO,CAAC;IACpB,8BAA8B;IAC9B,KAAK,EAAE,OAAO,CAAC;IACf;;;OAGG;IACH,QAAQ,EAAE;QAAE,QAAQ,EAAE,MAAM,CAAC;QAAC,KAAK,EAAE,MAAM,CAAC;QAAC,KAAK,EAAE,MAAM,CAAA;KAAE,GAAG,IAAI,CAAC;CACrE;AAED;;;;;;;;;;;GAWG;AACH,wBAAsB,QAAQ,CAAC,EAC7B,GAAG,EACH,QAA8B,EAC9B,GAAG,EAAE,cAAc,GACpB,EAAE;IACD,GAAG,EAAE,MAAM,CAAC;IACZ,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB;;;;;OAKG;IACH,GAAG,CAAC,EAAE,cAAc,CAAC;CACtB,GAAG,OAAO,CAAC,QAAQ,CAAC,CAiFpB;AAID;;;;;GAKG;AACH,wBAAgB,eAAe,CAAC,QAAQ,EAAE,MAAM,GAAG,MAAM,CAExD;AAED;;;;;;;;;GASG;AACH,wBAAgB,SAAS,CAAC,QAAQ,GAAE,MAA4B,GAAG,MAAM,CAaxE"}

package/dist/server/ai.js

@@ -19,7 +19,8 @@
  * fallback). An app that needs one provider in particular keeps listing it
  * under `providers` and calling `/api/ai/<provider>/…`.
  */
-import { AI_DEFAULT_MODEL, AI_DEFAULT_PROVIDER, CATALOG, ConfigurationError, } from "../internal/index.js";
+import { AI_DEFAULT_MODEL, AI_DEFAULT_PROVIDER, CATALOG, ConfigurationError, aiProviderSettings, devAiProvider, resolveAiDefault, } from "../internal/index.js";
+import { applyAttribution, attributionFor, } from "./attribution.js";
 import { BINDING_ORIGIN, createGatewayFetch, } from "./gatewayFetch.js";
 /** The base URL of the default route, as the SDK and the docs name it. */
 export const AI_DEFAULT_BASE_URL = `${BINDING_ORIGIN}/api/ai/${AI_DEFAULT_PROVIDER}/v1`;
@@ -35,6 +36,81 @@ export function ai(options) {
         embeddingsUrl: `${AI_DEFAULT_BASE_URL}/embeddings`,
     };
 }
+/**
+ * Whether the app can use a model right now, without calling one: gate
+ * an AI feature and show `setup` ("A chat model isn't set up on this
+ * Gateway: it needs OPENROUTER_API_KEY. An admin runs: pnpm everyapp
+ * configure inbox") up front instead of failing mid-task. `provider`
+ * defaults to `default`, the Gateway's default model (`ai: { chat: true }`);
+ * name one the manifest lists under `providers` to ask about it instead.
+ * The Gateway owns the wording: show `setup` and `command` as they are.
+ *
+ * Over the binding it sends `GET /api/ai/<provider>`; in local dev it
+ * answers from `.dev.vars` by the same rule `createGatewayFetch()` uses.
+ */
+export async function aiStatus({ env, provider = AI_DEFAULT_PROVIDER, for: explicitTarget, }) {
+    const target = attributionFor(env, explicitTarget, "aiStatus");
+    const values = env;
+    const binding = values["EVERY_APP_GATEWAY"];
+    const unavailable = {
+        provider,
+        requested: false,
+        configured: false,
+        ready: false,
+        resolved: null,
+        settings: [],
+        setup: null,
+        command: null,
+    };
+    if (binding && typeof binding.fetch === "function") {
+        const headers = new Headers();
+        if (target !== undefined)
+            applyAttribution(headers, target);
+        const response = await binding.fetch(`${BINDING_ORIGIN}/api/ai/${encodeURIComponent(provider)}`, { headers });
+        if (!response.ok)
+            return unavailable;
+        const body = (await response.json());
+        return {
+            ...unavailable,
+            ...body,
+            provider,
+            settings: Array.isArray(body.settings) ? body.settings : [],
+            setup: typeof body.setup === "string" ? body.setup : null,
+            command: typeof body.command === "string" ? body.command : null,
+            resolved: body.resolved ?? null,
+        };
+    }
+    if (!values["EVERYAPP_DEV"])
+        return unavailable;
+    const isSet = (name) => typeof values[name] === "string" && values[name].trim() !== "";
+    const dev = (label, settings, configured, resolved, also = "") => ({
+        provider,
+        requested: true,
+        configured,
+        ready: configured,
+        resolved,
+        settings: configured ? [] : [...settings],
+        setup: configured
+            ? null
+            : `${label} isn't set up for local development: set ${settings.join(" and ")}${also} in .dev.vars.`,
+        command: null,
+    });
+    if (provider === AI_DEFAULT_PROVIDER) {
+        const resolution = resolveAiDefault({ provider: null, isSet });
+        return dev("A chat model", resolution.settings, resolution.configured, resolution.configured
+            ? {
+                provider: resolution.provider,
+                label: resolution.label,
+                model: resolution.model,
+            }
+            : null, " (or another model provider's key)");
+    }
+    const spec = devAiProvider(provider);
+    if (!spec)
+        return unavailable;
+    const settings = aiProviderSettings(spec);
+    return dev(CATALOG.get(provider)?.label ?? provider, settings, settings.every(isSet), null);
+}
 const CHAT_COMPLETIONS = "/chat/completions";
 /**
  * A provider's root behind the Gateway, `http://every-app-gateway.internal/api/ai/<provider>`:

package/dist/server/aiBinding.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"aiBinding.d.ts","sourceRoot":"","sources":["../../src/server/aiBinding.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;GAqBG;AACH,OAAO,EAEL,mBAAmB,EAInB,KAAK,YAAY,EAClB,MAAM,sBAAsB,CAAC;AAC9B,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,kBAAkB,CAAC;AAQvD,MAAM,WAAW,uBAAuB;IACtC;;;OAGG;IACH,GAAG,CAAC,EAAE,cAAc,CAAC;IACrB;;;;;;;OAOG;IACH,QAAQ,CAAC,EAAE,YAAY,GAAG,OAAO,mBAAmB,CAAC;IACrD;;;;;;OAMG;IACH,MAAM,CAAC,EAAE,QAAQ,CAAC,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC,CAAC;CAC3C;AAUD;;;;;;;;;;;;;;;;;GAiBG;AACH,wBAAgB,gBAAgB,CAC9B,GAAG,EAAE,MAAM,EACX,OAAO,GAAE,uBAA4B,GACpC,EAAE,CAoEJ"}
+{"version":3,"file":"aiBinding.d.ts","sourceRoot":"","sources":["../../src/server/aiBinding.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;GAqBG;AACH,OAAO,EAEL,mBAAmB,EAInB,KAAK,YAAY,EAClB,MAAM,sBAAsB,CAAC;AAC9B,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,kBAAkB,CAAC;AAIvD,MAAM,WAAW,uBAAuB;IACtC;;;OAGG;IACH,GAAG,CAAC,EAAE,cAAc,CAAC;IACrB;;;;;;;OAOG;IACH,QAAQ,CAAC,EAAE,YAAY,GAAG,OAAO,mBAAmB,CAAC;IACrD;;;;;;OAMG;IACH,MAAM,CAAC,EAAE,QAAQ,CAAC,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC,CAAC;CAC3C;AAUD;;;;;;;;;;;;;;;;;GAiBG;AACH,wBAAgB,gBAAgB,CAC9B,GAAG,EAAE,MAAM,EACX,OAAO,GAAE,uBAA4B,GACpC,EAAE,CAoEJ"}

package/dist/server/aiBinding.js

@@ -21,8 +21,8 @@
  * for Workers AI).
  */
 import { AI_DEFAULT_MODEL, AI_DEFAULT_PROVIDER, AI_DEFAULT_ROUTES, ConfigurationError, devAiProvider, } from "../internal/index.js";
-import { BINDING_ORIGIN, createGatewayFetch, } from "./gatewayFetch.js";
-import { GatewayRefusalError, gatewayRefusal } from "./integrationFetch.js";
+import { BINDING_ORIGIN, createGatewayFetch } from "./gatewayFetch.js";
+import { GatewayRefusalError, gatewayRefusal } from "./refusal.js";
 /**
  * A Workers AI binding (`Ai`) over the Gateway: pass it where code takes
  * `env.AI`. `run()` covers text generation (messages or prompt; tools;
@@ -63,7 +63,7 @@ export function gatewayAiBinding(env, options = {}) {
             ? { model: sent, input: inputs["text"] }
             : chatBody(sent, inputs);
         const gatewayFetch = createGatewayFetch({
-            env: env,
+            env,
             for: options.for,
         });
         const response = await gatewayFetch(url, {

package/dist/server/authorizeUrl.d.ts

@@ -31,7 +31,7 @@ export interface AuthorizeUrlOptions {
  * `codeChallenge`, PKCE as S256. The app keeps its `state` and verifier
  * for the callback.
  *
- * A client without scope sets (LinkedIn, Mastodon, ...) is refused: the
+ * A client without scope sets is refused: the
  * registry's checklist for one isn't what the gateway holds a token to,
  * so an app builds that URL itself from the status's `clientId`.
  *

package/dist/server/authorizeUrl.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"authorizeUrl.d.ts","sourceRoot":"","sources":["../../src/server/authorizeUrl.ts"],"names":[],"mappings":"AAAA,OAAO,EAKL,KAAK,uBAAuB,EAC7B,MAAM,sBAAsB,CAAC;AAC9B,OAAO,KAAK,EAAE,4BAA4B,EAAE,MAAM,uBAAuB,CAAC;AAE1E,MAAM,WAAW,mBAAmB;IAClC,oEAAoE;IACpE,QAAQ,EAAE,uBAAuB,CAAC;IAClC,iFAAiF;IACjF,MAAM,EAAE,4BAA4B,CAAC;IACrC,sEAAsE;IACtE,WAAW,EAAE,MAAM,CAAC;IACpB,4EAA4E;IAC5E,KAAK,EAAE,MAAM,CAAC;IACd,+EAA+E;IAC/E,aAAa,CAAC,EAAE,MAAM,CAAC;IACvB;;;;OAIG;IACH,MAAM,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;CACjC;AAgCD;;;;;;;;;;;;;;;;;;;;GAoBG;AACH,wBAAgB,YAAY,CAAC,EAC3B,QAAQ,EACR,MAAM,EACN,WAAW,EACX,KAAK,EACL,aAAa,EACb,MAAM,GACP,EAAE,mBAAmB,GAAG,GAAG,CA2D3B"}
+{"version":3,"file":"authorizeUrl.d.ts","sourceRoot":"","sources":["../../src/server/authorizeUrl.ts"],"names":[],"mappings":"AAAA,OAAO,EAKL,KAAK,uBAAuB,EAC7B,MAAM,sBAAsB,CAAC;AAC9B,OAAO,KAAK,EAAE,4BAA4B,EAAE,MAAM,uBAAuB,CAAC;AAE1E,MAAM,WAAW,mBAAmB;IAClC,oEAAoE;IACpE,QAAQ,EAAE,uBAAuB,CAAC;IAClC,iFAAiF;IACjF,MAAM,EAAE,4BAA4B,CAAC;IACrC,sEAAsE;IACtE,WAAW,EAAE,MAAM,CAAC;IACpB,4EAA4E;IAC5E,KAAK,EAAE,MAAM,CAAC;IACd,+EAA+E;IAC/E,aAAa,CAAC,EAAE,MAAM,CAAC;IACvB;;;;OAIG;IACH,MAAM,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;CACjC;AAgCD;;;;;;;;;;;;;;;;;;;;GAoBG;AACH,wBAAgB,YAAY,CAAC,EAC3B,QAAQ,EACR,MAAM,EACN,WAAW,EACX,KAAK,EACL,aAAa,EACb,MAAM,GACP,EAAE,mBAAmB,GAAG,GAAG,CAqD3B"}