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

package/dist/dev/index.d.ts

@@ -0,0 +1,8 @@
+/**
+ * @every-app/sdk/dev — the well-known dev identity: the keypair `everyapp dev`
+ * signs with, its issuer and its key id. For the platform's local dev tools
+ * (the CLI, `@every-app/perimeter/dev`); never imported by a Worker.
+ */
+export { DEV_ISSUER, DEV_ORG_ID, DEV_PRIVATE_KEY_PEM, DEV_PUBLIC_KEY_PEM, } from "./keypair.js";
+export { IDENTITY_DEV_KEY_ID } from "../internal/protocol.js";
+//# sourceMappingURL=index.d.ts.map

package/dist/dev/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/dev/index.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AACH,OAAO,EACL,UAAU,EACV,UAAU,EACV,mBAAmB,EACnB,kBAAkB,GACnB,MAAM,cAAc,CAAC;AACtB,OAAO,EAAE,mBAAmB,EAAE,MAAM,yBAAyB,CAAC"}

package/dist/dev/index.js

@@ -0,0 +1,7 @@
+/**
+ * @every-app/sdk/dev — the well-known dev identity: the keypair `everyapp dev`
+ * signs with, its issuer and its key id. For the platform's local dev tools
+ * (the CLI, `@every-app/perimeter/dev`); never imported by a Worker.
+ */
+export { DEV_ISSUER, DEV_ORG_ID, DEV_PRIVATE_KEY_PEM, DEV_PUBLIC_KEY_PEM, } from "./keypair.js";
+export { IDENTITY_DEV_KEY_ID } from "../internal/protocol.js";

package/dist/dev/keypair.d.ts

@@ -0,0 +1,26 @@
+/**
+ * The well-known keypair and issuer of local dev identities.
+ *
+ * Public by design: the private key is in this file for anyone to read, so a
+ * token signed with it proves nothing outside dev. The SDK accepts it only
+ * under the dev key id, only behind the dev opt-in (`EVERYAPP_DEV`, which
+ * `everyAppWorker()` sets in development and a deploy never does), and only
+ * from {@link DEV_ISSUER}. Anything that reaches the local dev ports can mint
+ * a dev identity with it; that is the local-dev trust boundary, which is why
+ * `everyapp dev` listens on 127.0.0.1 unless told otherwise.
+ *
+ * A leaf module: `cloudflare.config.ts` loads it through
+ * `@every-app/sdk/cloudflare`, and the Vite plugin hides from the Worker
+ * every file the config loads, so the Worker never imports it. The Worker
+ * side keeps its own copy of the issuer (`internal/protocol.ts`); a test
+ * pins the two together.
+ */
+/** Issuer of locally minted dev identity tokens. */
+export declare const DEV_ISSUER = "https://gateway.dev.localhost";
+/** The organization the dev gateway's seeded user belongs to (`everyAppWorker()` sets it as `EVERY_APP_ORG_ID` in dev). */
+export declare const DEV_ORG_ID = "dev-org";
+/** SPKI PEM public half of the dev keypair. */
+export declare const DEV_PUBLIC_KEY_PEM = "-----BEGIN PUBLIC KEY-----\nMIIBIjANBgkqhkiG9w0BAQEFAAOCAQ8AMIIBCgKCAQEAh40zWf+QK3rJdMTNoy+X\nF9iydV5raWSeEt4DXyeY98c8IZHRjy2UXaaYejweebRsv9Az+bZuL3cfJ0E7pOGd\n4VCOiSG1BjJglmTC1whV4Md6qhLDVOP6iztUJSxDwnlR85UtOyNJ4G5dYY6RrAWl\nPMMXPSYdGWqAP4n5QXAw+7uTFmJMdWy1W8KLbTj//NSGn3DCm+EZJIC8q9yDhMSc\nM0ejJnBVColvp4T8k8dt2kYGu2Wd7dCMrHv/lxUoqD58avpdMOzbaZtwsQ7BAaIa\nmIeQ1AKxmnCj1np23uWvYQmoaZocvupLSALK7fWGUyVDZ+RW4HtN5KqzZypfiyZ8\nkQIDAQAB\n-----END PUBLIC KEY-----\n";
+/** PKCS#8 PEM private half of the dev keypair. Public, see above. */
+export declare const DEV_PRIVATE_KEY_PEM = "-----BEGIN PRIVATE KEY-----\nMIIEvAIBADANBgkqhkiG9w0BAQEFAASCBKYwggSiAgEAAoIBAQCHjTNZ/5Aresl0\nxM2jL5cX2LJ1XmtpZJ4S3gNfJ5j3xzwhkdGPLZRdpph6PB55tGy/0DP5tm4vdx8n\nQTuk4Z3hUI6JIbUGMmCWZMLXCFXgx3qqEsNU4/qLO1QlLEPCeVHzlS07I0ngbl1h\njpGsBaU8wxc9Jh0ZaoA/iflBcDD7u5MWYkx1bLVbwottOP/81IafcMKb4RkkgLyr\n3IOExJwzR6MmcFUKiW+nhPyTx23aRga7ZZ3t0Iyse/+XFSioPnxq+l0w7Ntpm3Cx\nDsEBohqYh5DUArGacKPWenbe5a9hCahpmhy+6ktIAsrt9YZTJUNn5Fbge03kqrNn\nKl+LJnyRAgMBAAECggEABCi9GAB3URw3APgWarDHwS2vGRqU72KM1p2dCx8FCqpA\ncjO+Ezd171Mwp8R/N2MFuLN32sxCEH8GU88kuDwLevm8q+C+xBJI5ChykYRCFU/t\nl7kUaP8HRZ0kCXF0oUuVbATKYt+D8WjVgOwt1FJGhgki5geMukZKKdjvDtbVS+4D\nqGRBV4/XT4Y5JDNrjnITwSV2xfMD6Yd92/NN375+V9vWFI4kaESPbE/YQ7yF1o66\nDfhjRMSMmTgWEeoVDwFMlnXppo1nkdEXY8MXlgho0mDGre4PurAvQmZRYlU6VJ63\nx7/NTaNPnQEJ7+FkUXvtOz8sCBjLzgtilGnBNwGqeQKBgQC7zA7kojSPYvlm7nbC\nL2kO8iAL3p/B1vtS6XLTFiV0Wv2kT6Cy51ulVteUijwGMrDuCMdBqXfIocQvYhls\nJzPR/DaFcE2qClCei9L4wxvdBLcqoQH7LsllGA9oHSoZNnzT0muNech0xuL75X6B\nLLMpVtOyb/prd8N6hhBlcGElCQKBgQC4x8A9aDnFlcyztcutW2YQMfEyDEK+PcuC\nn6cnSJ8MjmFEyulKZuklqKkhwMiNBm8xNhI6UdUtrFPfKmGqYifjEUX4D6xGLL8b\nLNOZojkMAI3jtuD+IGzlpkSCy2TWXVb53TTi82LUD7Sbb5siYhL5uW0IRzbJt1aR\nn2JNphvFSQKBgA1NPNjQ7GwjlIrH5T2H4ice20o78JDoS1DqHCn7bZe6QjD7OuSx\nInqplgd9axb9TC7wDD0IZeWeH6lDh41zkWYUOUBmXfnnVSKFwOHB4B1dkiPA18UU\n4Ur5002Kk0rJ4zmVs+yHbb1nwPgan0VDB0WsUr5W1CP8jaoGCO9GcHsRAoGAX6Xm\neOLupLx6DbxZBg99sXxoocN++QL7yU3jNI5+5fz9lKKESCMlJH09r18fcQCXph2b\nKd0aQF4nvCkwDQZqJzvVwCY8wsZ+1g5KKgizBudyiyErLeCS/f0nEZ0/QUdnskcz\nDRd3XNYUYzFOWGnz8JhvPA3A6oGgqhiaxh7p2SECgYA+7s6WRfQLSad3dXuDNajQ\nsBwG4E6M/yUbgdbNjnv+AuVYS8Uyvf6x/xaWH3zssluIXhod0Two22bjtkPGJ2nx\n1ZXmbxSdWVGwLZn3GYRoRu6X6VGTbFAaK1mb7KDfwjoaauV7G3A2mw6M5xxg4zx/\nhsbx0DA4sMMIUEniw9W/YA==\n-----END PRIVATE KEY-----\n";
+//# sourceMappingURL=keypair.d.ts.map

package/dist/dev/keypair.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"keypair.d.ts","sourceRoot":"","sources":["../../src/dev/keypair.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;GAgBG;AAEH,oDAAoD;AACpD,eAAO,MAAM,UAAU,kCAAkC,CAAC;AAC1D,2HAA2H;AAC3H,eAAO,MAAM,UAAU,YAAY,CAAC;AAEpC,+CAA+C;AAC/C,eAAO,MAAM,kBAAkB,idAS9B,CAAC;AAEF,qEAAqE;AACrE,eAAO,MAAM,mBAAmB,ysDA4B/B,CAAC"}

package/dist/dev/keypair.js

@@ -0,0 +1,62 @@
+/**
+ * The well-known keypair and issuer of local dev identities.
+ *
+ * Public by design: the private key is in this file for anyone to read, so a
+ * token signed with it proves nothing outside dev. The SDK accepts it only
+ * under the dev key id, only behind the dev opt-in (`EVERYAPP_DEV`, which
+ * `everyAppWorker()` sets in development and a deploy never does), and only
+ * from {@link DEV_ISSUER}. Anything that reaches the local dev ports can mint
+ * a dev identity with it; that is the local-dev trust boundary, which is why
+ * `everyapp dev` listens on 127.0.0.1 unless told otherwise.
+ *
+ * A leaf module: `cloudflare.config.ts` loads it through
+ * `@every-app/sdk/cloudflare`, and the Vite plugin hides from the Worker
+ * every file the config loads, so the Worker never imports it. The Worker
+ * side keeps its own copy of the issuer (`internal/protocol.ts`); a test
+ * pins the two together.
+ */
+/** Issuer of locally minted dev identity tokens. */
+export const DEV_ISSUER = "https://gateway.dev.localhost";
+/** The organization the dev gateway's seeded user belongs to (`everyAppWorker()` sets it as `EVERY_APP_ORG_ID` in dev). */
+export const DEV_ORG_ID = "dev-org";
+/** SPKI PEM public half of the dev keypair. */
+export const DEV_PUBLIC_KEY_PEM = `-----BEGIN PUBLIC KEY-----
+MIIBIjANBgkqhkiG9w0BAQEFAAOCAQ8AMIIBCgKCAQEAh40zWf+QK3rJdMTNoy+X
+F9iydV5raWSeEt4DXyeY98c8IZHRjy2UXaaYejweebRsv9Az+bZuL3cfJ0E7pOGd
+4VCOiSG1BjJglmTC1whV4Md6qhLDVOP6iztUJSxDwnlR85UtOyNJ4G5dYY6RrAWl
+PMMXPSYdGWqAP4n5QXAw+7uTFmJMdWy1W8KLbTj//NSGn3DCm+EZJIC8q9yDhMSc
+M0ejJnBVColvp4T8k8dt2kYGu2Wd7dCMrHv/lxUoqD58avpdMOzbaZtwsQ7BAaIa
+mIeQ1AKxmnCj1np23uWvYQmoaZocvupLSALK7fWGUyVDZ+RW4HtN5KqzZypfiyZ8
+kQIDAQAB
+-----END PUBLIC KEY-----
+`;
+/** PKCS#8 PEM private half of the dev keypair. Public, see above. */
+export const DEV_PRIVATE_KEY_PEM = `-----BEGIN PRIVATE KEY-----
+MIIEvAIBADANBgkqhkiG9w0BAQEFAASCBKYwggSiAgEAAoIBAQCHjTNZ/5Aresl0
+xM2jL5cX2LJ1XmtpZJ4S3gNfJ5j3xzwhkdGPLZRdpph6PB55tGy/0DP5tm4vdx8n
+QTuk4Z3hUI6JIbUGMmCWZMLXCFXgx3qqEsNU4/qLO1QlLEPCeVHzlS07I0ngbl1h
+jpGsBaU8wxc9Jh0ZaoA/iflBcDD7u5MWYkx1bLVbwottOP/81IafcMKb4RkkgLyr
+3IOExJwzR6MmcFUKiW+nhPyTx23aRga7ZZ3t0Iyse/+XFSioPnxq+l0w7Ntpm3Cx
+DsEBohqYh5DUArGacKPWenbe5a9hCahpmhy+6ktIAsrt9YZTJUNn5Fbge03kqrNn
+Kl+LJnyRAgMBAAECggEABCi9GAB3URw3APgWarDHwS2vGRqU72KM1p2dCx8FCqpA
+cjO+Ezd171Mwp8R/N2MFuLN32sxCEH8GU88kuDwLevm8q+C+xBJI5ChykYRCFU/t
+l7kUaP8HRZ0kCXF0oUuVbATKYt+D8WjVgOwt1FJGhgki5geMukZKKdjvDtbVS+4D
+qGRBV4/XT4Y5JDNrjnITwSV2xfMD6Yd92/NN375+V9vWFI4kaESPbE/YQ7yF1o66
+DfhjRMSMmTgWEeoVDwFMlnXppo1nkdEXY8MXlgho0mDGre4PurAvQmZRYlU6VJ63
+x7/NTaNPnQEJ7+FkUXvtOz8sCBjLzgtilGnBNwGqeQKBgQC7zA7kojSPYvlm7nbC
+L2kO8iAL3p/B1vtS6XLTFiV0Wv2kT6Cy51ulVteUijwGMrDuCMdBqXfIocQvYhls
+JzPR/DaFcE2qClCei9L4wxvdBLcqoQH7LsllGA9oHSoZNnzT0muNech0xuL75X6B
+LLMpVtOyb/prd8N6hhBlcGElCQKBgQC4x8A9aDnFlcyztcutW2YQMfEyDEK+PcuC
+n6cnSJ8MjmFEyulKZuklqKkhwMiNBm8xNhI6UdUtrFPfKmGqYifjEUX4D6xGLL8b
+LNOZojkMAI3jtuD+IGzlpkSCy2TWXVb53TTi82LUD7Sbb5siYhL5uW0IRzbJt1aR
+n2JNphvFSQKBgA1NPNjQ7GwjlIrH5T2H4ice20o78JDoS1DqHCn7bZe6QjD7OuSx
+Inqplgd9axb9TC7wDD0IZeWeH6lDh41zkWYUOUBmXfnnVSKFwOHB4B1dkiPA18UU
+4Ur5002Kk0rJ4zmVs+yHbb1nwPgan0VDB0WsUr5W1CP8jaoGCO9GcHsRAoGAX6Xm
+eOLupLx6DbxZBg99sXxoocN++QL7yU3jNI5+5fz9lKKESCMlJH09r18fcQCXph2b
+Kd0aQF4nvCkwDQZqJzvVwCY8wsZ+1g5KKgizBudyiyErLeCS/f0nEZ0/QUdnskcz
+DRd3XNYUYzFOWGnz8JhvPA3A6oGgqhiaxh7p2SECgYA+7s6WRfQLSad3dXuDNajQ
+sBwG4E6M/yUbgdbNjnv+AuVYS8Uyvf6x/xaWH3zssluIXhod0Two22bjtkPGJ2nx
+1ZXmbxSdWVGwLZn3GYRoRu6X6VGTbFAaK1mb7KDfwjoaauV7G3A2mw6M5xxg4zx/
+hsbx0DA4sMMIUEniw9W/YA==
+-----END PRIVATE KEY-----
+`;

package/dist/index.d.ts

@@ -0,0 +1,6 @@
+/**
+ * @every-app/sdk — what `everyapp.config.ts` imports: `defineEveryApp` and
+ * the manifest's types. A leaf, like the config itself (see ./manifest.ts).
+ */
+export { defineEveryApp, type EveryAppCapabilityEntry, type EveryAppClassResource, type EveryAppManifest, type EveryAppPublicRoute, type EveryAppQueueConsumer, type EveryAppResources, type EveryAppSecretEntry, type EveryAppSettingEntry, type EveryAppSettingNeed, type EveryAppWorkerLimits, } from "./manifest.js";
+//# sourceMappingURL=index.d.ts.map

package/dist/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA;;;GAGG;AACH,OAAO,EACL,cAAc,EACd,KAAK,uBAAuB,EAC5B,KAAK,qBAAqB,EAC1B,KAAK,gBAAgB,EACrB,KAAK,mBAAmB,EACxB,KAAK,qBAAqB,EAC1B,KAAK,iBAAiB,EACtB,KAAK,mBAAmB,EACxB,KAAK,oBAAoB,EACzB,KAAK,mBAAmB,EACxB,KAAK,oBAAoB,GAC1B,MAAM,eAAe,CAAC"}

package/dist/index.js

@@ -0,0 +1,5 @@
+/**
+ * @every-app/sdk — what `everyapp.config.ts` imports: `defineEveryApp` and
+ * the manifest's types. A leaf, like the config itself (see ./manifest.ts).
+ */
+export { defineEveryApp, } from "./manifest.js";

package/dist/internal/aiDefault.d.ts

@@ -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`).
+ *
+ * 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.
+ *
+ * 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;
+/**
+ * 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`.
+ */
+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
+ * may hold slashes of its own). Null for blank or malformed text.
+ */
+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. */
+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 chat model the Gateway fills in when the app names none: the operator's setting, else the seed. */
+    model: string;
+    /** The embeddings model, the same way; 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. */
+"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 chat model the default serves: the operator's setting for the provider, else the seed. */
+    model: string;
+    /** The embeddings model, the same way; 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;
+    /** 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, models?: AiModelSettings): AiDefaultCandidate[];
+/** Why `choice.provider` 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
+ * 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: {
+    /** 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;
+    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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"}