@astralyn/pi 0.85.1 → 0.85.2

package/dist/extensions/provider/catalog.d.ts

@@ -0,0 +1,57 @@
+/**
+ * Built-in model catalog index and reference matching for Use Built-in Data.
+ *
+ * The index is built lazily on first use from pi-ai's raw builtin catalog
+ * (never from the runtime's user-modified getAll()). Matching is grouped by
+ * exact id, normalized id, then fuzzy match; ties prefer the current API.
+ */
+import type { Api, Model } from "@earendil-works/pi-ai";
+import type { ModelsJsonModel } from "../../core/model-config.ts";
+export interface CatalogEntry {
+    providerId: string;
+    model: Model<Api>;
+}
+export declare function builtinCatalogIndex(): readonly CatalogEntry[];
+/** True when models.json with this provider id overlays a built-in catalog. */
+export declare function isBuiltinProviderId(providerId: string): boolean;
+/**
+ * Builtin fallback api/baseUrl for a custom model, mirroring the runtime's
+ * findModelDefaults order: same id, then same api, then any openai-completions
+ * model, then the first catalog entry.
+ */
+export declare function builtinDefaults(providerId: string, modelId?: string, api?: string): {
+    api?: string;
+    baseUrl?: string;
+};
+export type MatchTier = "exact" | "normalized" | "fuzzy";
+export interface CatalogMatch {
+    entry: CatalogEntry;
+    tier: MatchTier;
+}
+/** Grouped reference candidates for a query id; at most `max` entries, best first. */
+export declare function matchBuiltinModels(query: string, preferredApi?: string, max?: number): CatalogMatch[];
+export type ReferenceField = "name" | "reasoning" | "input" | "contextWindow" | "maxTokens" | "thinkingLevelMap" | "compat" | "cost";
+export interface FieldChange {
+    field: ReferenceField;
+    /** Pre-selected per the completion rules (unset scalar fields are checked; map/compat/cost never are). */
+    checked: boolean;
+    /** False = cross-API map/compat: view-only, cannot be applied. */
+    applicable: boolean;
+    /** Left side of the preview, e.g. `not set (falls back to id)`. */
+    currentText: string;
+    /** Right side of the preview, e.g. the reference value. */
+    referenceText: string;
+    /** Extra detail lines for the expandable view (thinking map entries, compat keys, cost rates). */
+    referenceDetails?: string[];
+    /** Reference carries tiers; applying cost keeps current tiers and never imports reference tiers. */
+    referenceHasTiers?: boolean;
+}
+/**
+ * Compute the per-field change list for applying `reference` onto `current`.
+ * Only fields the reference actually has appear; an absent map/compat on the
+ * reference never implies clearing the current value.
+ */
+export declare function computeFieldChanges(current: Partial<ModelsJsonModel> & {
+    id?: string;
+}, reference: Model<Api>, effectiveApi: string | undefined): FieldChange[];
+//# sourceMappingURL=catalog.d.ts.map

package/dist/extensions/provider/catalog.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"catalog.d.ts","sourceRoot":"","sources":["../../../src/extensions/provider/catalog.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AAEH,OAAO,KAAK,EAAE,GAAG,EAAE,KAAK,EAAE,MAAM,uBAAuB,CAAC;AAGxD,OAAO,KAAK,EAAE,eAAe,EAAE,MAAM,4BAA4B,CAAC;AAGlE,MAAM,WAAW,YAAY;IAC5B,UAAU,EAAE,MAAM,CAAC;IACnB,KAAK,EAAE,KAAK,CAAC,GAAG,CAAC,CAAC;CAClB;AAID,wBAAgB,mBAAmB,IAAI,SAAS,YAAY,EAAE,CAQ7D;AAED,+EAA+E;AAC/E,wBAAgB,mBAAmB,CAAC,UAAU,EAAE,MAAM,GAAG,OAAO,CAE/D;AAED;;;;GAIG;AACH,wBAAgB,eAAe,CAC9B,UAAU,EAAE,MAAM,EAClB,OAAO,CAAC,EAAE,MAAM,EAChB,GAAG,CAAC,EAAE,MAAM,GACV;IAAE,GAAG,CAAC,EAAE,MAAM,CAAC;IAAC,OAAO,CAAC,EAAE,MAAM,CAAA;CAAE,CAUpC;AAWD,MAAM,MAAM,SAAS,GAAG,OAAO,GAAG,YAAY,GAAG,OAAO,CAAC;AAEzD,MAAM,WAAW,YAAY;IAC5B,KAAK,EAAE,YAAY,CAAC;IACpB,IAAI,EAAE,SAAS,CAAC;CAChB;AAaD,sFAAsF;AACtF,wBAAgB,kBAAkB,CAAC,KAAK,EAAE,MAAM,EAAE,YAAY,CAAC,EAAE,MAAM,EAAE,GAAG,GAAE,MAAuB,GAAG,YAAY,EAAE,CA2BrH;AAED,MAAM,MAAM,cAAc,GACvB,MAAM,GACN,WAAW,GACX,OAAO,GACP,eAAe,GACf,WAAW,GACX,kBAAkB,GAClB,QAAQ,GACR,MAAM,CAAC;AAEV,MAAM,WAAW,WAAW;IAC3B,KAAK,EAAE,cAAc,CAAC;IACtB,0GAA0G;IAC1G,OAAO,EAAE,OAAO,CAAC;IACjB,kEAAkE;IAClE,UAAU,EAAE,OAAO,CAAC;IACpB,mEAAmE;IACnE,WAAW,EAAE,MAAM,CAAC;IACpB,2DAA2D;IAC3D,aAAa,EAAE,MAAM,CAAC;IACtB,kGAAkG;IAClG,gBAAgB,CAAC,EAAE,MAAM,EAAE,CAAC;IAC5B,oGAAoG;IACpG,iBAAiB,CAAC,EAAE,OAAO,CAAC;CAC5B;AASD;;;;GAIG;AACH,wBAAgB,mBAAmB,CAClC,OAAO,EAAE,OAAO,CAAC,eAAe,CAAC,GAAG;IAAE,EAAE,CAAC,EAAE,MAAM,CAAA;CAAE,EACnD,SAAS,EAAE,KAAK,CAAC,GAAG,CAAC,EACrB,YAAY,EAAE,MAAM,GAAG,SAAS,GAC9B,WAAW,EAAE,CAwFf"}

package/dist/extensions/provider/catalog.js

@@ -0,0 +1,181 @@
+/**
+ * Built-in model catalog index and reference matching for Use Built-in Data.
+ *
+ * The index is built lazily on first use from pi-ai's raw builtin catalog
+ * (never from the runtime's user-modified getAll()). Matching is grouped by
+ * exact id, normalized id, then fuzzy match; ties prefer the current API.
+ */
+import { getBuiltinModels, getBuiltinProviders } from "@earendil-works/pi-ai/providers/all";
+import { fuzzyFilter } from "@earendil-works/pi-tui";
+import { MAX_CANDIDATES, plural } from "./constants.js";
+let indexCache;
+export function builtinCatalogIndex() {
+    if (indexCache)
+        return indexCache;
+    const entries = [];
+    for (const providerId of getBuiltinProviders()) {
+        for (const model of getBuiltinModels(providerId))
+            entries.push({ providerId, model });
+    }
+    indexCache = entries;
+    return entries;
+}
+/** True when models.json with this provider id overlays a built-in catalog. */
+export function isBuiltinProviderId(providerId) {
+    return getBuiltinProviders().includes(providerId);
+}
+/**
+ * Builtin fallback api/baseUrl for a custom model, mirroring the runtime's
+ * findModelDefaults order: same id, then same api, then any openai-completions
+ * model, then the first catalog entry.
+ */
+export function builtinDefaults(providerId, modelId, api) {
+    if (!isBuiltinProviderId(providerId))
+        return {};
+    const models = getBuiltinModels(providerId);
+    if (models.length === 0)
+        return {};
+    const found = (modelId ? models.find((model) => model.id === modelId) : undefined) ??
+        (api ? models.find((model) => model.api === api) : undefined) ??
+        models.find((model) => model.api === "openai-completions") ??
+        models[0];
+    return { api: found.api, baseUrl: found.baseUrl };
+}
+/** Case-insensitive, separator-tolerant comparison key; keeps version/date/thinking variants. */
+function normalizeId(id) {
+    const basename = id.includes("/") ? id.slice(id.lastIndexOf("/") + 1) : id;
+    return basename
+        .toLowerCase()
+        .replace(/[^a-z0-9]+/g, "-")
+        .replace(/^-+|-+$/g, "");
+}
+function sortTier(matches, preferredApi) {
+    return matches.sort((a, b) => {
+        if (preferredApi) {
+            const aPreferred = a.entry.model.api === preferredApi ? 0 : 1;
+            const bPreferred = b.entry.model.api === preferredApi ? 0 : 1;
+            if (aPreferred !== bPreferred)
+                return aPreferred - bPreferred;
+        }
+        return a.entry.model.id.localeCompare(b.entry.model.id);
+    });
+}
+/** Grouped reference candidates for a query id; at most `max` entries, best first. */
+export function matchBuiltinModels(query, preferredApi, max = MAX_CANDIDATES) {
+    const trimmed = query.trim();
+    if (!trimmed)
+        return [];
+    const index = builtinCatalogIndex();
+    const normalizedQuery = normalizeId(trimmed);
+    const exact = [];
+    const normalized = [];
+    const consumed = new Set();
+    for (const entry of index) {
+        if (entry.model.id === trimmed) {
+            exact.push({ entry, tier: "exact" });
+            consumed.add(entry);
+        }
+        else if (normalizeId(entry.model.id) === normalizedQuery) {
+            normalized.push({ entry, tier: "normalized" });
+            consumed.add(entry);
+        }
+    }
+    const remaining = sortTier(index.filter((entry) => !consumed.has(entry)).map((entry) => ({ entry, tier: "fuzzy" })), preferredApi);
+    const fuzzy = fuzzyFilter(remaining, trimmed, ({ entry }) => `${entry.model.id} ${entry.model.name} ${entry.providerId}`);
+    return [...sortTier(exact, preferredApi), ...sortTier(normalized, preferredApi), ...fuzzy].slice(0, max);
+}
+const DEFAULT_CONTEXT_WINDOW = 128000;
+const DEFAULT_MAX_TOKENS = 16384;
+function formatCostRates(cost) {
+    return `$${cost.input} / $${cost.output} in/out (cache $${cost.cacheRead} / $${cost.cacheWrite})`;
+}
+/**
+ * Compute the per-field change list for applying `reference` onto `current`.
+ * Only fields the reference actually has appear; an absent map/compat on the
+ * reference never implies clearing the current value.
+ */
+export function computeFieldChanges(current, reference, effectiveApi) {
+    const changes = [];
+    const unset = (key) => current[key] === undefined;
+    changes.push({
+        field: "name",
+        checked: unset("name") && reference.name !== reference.id,
+        applicable: true,
+        currentText: current.name ?? `not set (falls back to id${current.id ? ` "${current.id}"` : ""})`,
+        referenceText: reference.name,
+    });
+    changes.push({
+        field: "reasoning",
+        checked: unset("reasoning") && reference.reasoning === true,
+        applicable: true,
+        currentText: current.reasoning === undefined ? "false (default)" : String(current.reasoning),
+        referenceText: String(reference.reasoning),
+    });
+    changes.push({
+        field: "input",
+        checked: unset("input"),
+        applicable: true,
+        currentText: current.input ? current.input.join(", ") : "text (default)",
+        referenceText: reference.input.join(", "),
+    });
+    changes.push({
+        field: "contextWindow",
+        checked: unset("contextWindow"),
+        applicable: true,
+        currentText: current.contextWindow === undefined ? `${DEFAULT_CONTEXT_WINDOW} (default)` : String(current.contextWindow),
+        referenceText: String(reference.contextWindow),
+    });
+    changes.push({
+        field: "maxTokens",
+        checked: unset("maxTokens"),
+        applicable: true,
+        currentText: current.maxTokens === undefined ? `${DEFAULT_MAX_TOKENS} (default)` : String(current.maxTokens),
+        referenceText: String(reference.maxTokens),
+    });
+    const sameApi = effectiveApi !== undefined && reference.api === effectiveApi;
+    if (reference.thinkingLevelMap && Object.keys(reference.thinkingLevelMap).length > 0) {
+        const details = Object.entries(reference.thinkingLevelMap).map(([level, target]) => `${level}: ${target === null ? "null (hidden)" : target}`);
+        changes.push({
+            field: "thinkingLevelMap",
+            checked: false,
+            applicable: sameApi,
+            currentText: current.thinkingLevelMap
+                ? `${Object.keys(current.thinkingLevelMap).length} ${plural(Object.keys(current.thinkingLevelMap).length, "mapping")}`
+                : "not set",
+            // Cross-api maps are view-only; the preview pane annotates that.
+            referenceText: `${details.length} ${plural(details.length, "mapping")}`,
+            referenceDetails: details,
+        });
+    }
+    if (reference.compat && Object.keys(reference.compat).length > 0) {
+        const details = Object.entries(reference.compat).map(([key, value]) => `${key}: ${JSON.stringify(value)}`);
+        changes.push({
+            field: "compat",
+            checked: false,
+            applicable: sameApi,
+            currentText: current.compat
+                ? `${Object.keys(current.compat).length} ${plural(Object.keys(current.compat).length, "entry")}`
+                : "not set",
+            referenceText: `${details.length} ${plural(details.length, "entry")}`,
+            referenceDetails: details,
+        });
+    }
+    if (reference.cost) {
+        changes.push({
+            field: "cost",
+            checked: false,
+            applicable: true,
+            currentText: current.cost ? formatCostRates(current.cost) : "all 0 (default)",
+            referenceText: formatCostRates(reference.cost),
+            referenceDetails: [
+                `input: $${reference.cost.input} / M tokens`,
+                `output: $${reference.cost.output} / M tokens`,
+                `cacheRead: $${reference.cost.cacheRead} / M tokens`,
+                `cacheWrite: $${reference.cost.cacheWrite} / M tokens`,
+            ],
+            referenceHasTiers: Array.isArray(reference.cost.tiers) && reference.cost.tiers.length > 0,
+        });
+    }
+    return changes;
+}
+//# sourceMappingURL=catalog.js.map

package/dist/extensions/provider/catalog.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"catalog.js","sourceRoot":"","sources":["../../../src/extensions/provider/catalog.ts"],"names":[],"mappings":"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","sourcesContent":["/**\n * Built-in model catalog index and reference matching for Use Built-in Data.\n *\n * The index is built lazily on first use from pi-ai's raw builtin catalog\n * (never from the runtime's user-modified getAll()). Matching is grouped by\n * exact id, normalized id, then fuzzy match; ties prefer the current API.\n */\n\nimport type { Api, Model } from \"@earendil-works/pi-ai\";\nimport { getBuiltinModels, getBuiltinProviders } from \"@earendil-works/pi-ai/providers/all\";\nimport { fuzzyFilter } from \"@earendil-works/pi-tui\";\nimport type { ModelsJsonModel } from \"../../core/model-config.ts\";\nimport { MAX_CANDIDATES, plural } from \"./constants.ts\";\n\nexport interface CatalogEntry {\n\tproviderId: string;\n\tmodel: Model<Api>;\n}\n\nlet indexCache: readonly CatalogEntry[] | undefined;\n\nexport function builtinCatalogIndex(): readonly CatalogEntry[] {\n\tif (indexCache) return indexCache;\n\tconst entries: CatalogEntry[] = [];\n\tfor (const providerId of getBuiltinProviders()) {\n\t\tfor (const model of getBuiltinModels(providerId)) entries.push({ providerId, model });\n\t}\n\tindexCache = entries;\n\treturn entries;\n}\n\n/** True when models.json with this provider id overlays a built-in catalog. */\nexport function isBuiltinProviderId(providerId: string): boolean {\n\treturn (getBuiltinProviders() as readonly string[]).includes(providerId);\n}\n\n/**\n * Builtin fallback api/baseUrl for a custom model, mirroring the runtime's\n * findModelDefaults order: same id, then same api, then any openai-completions\n * model, then the first catalog entry.\n */\nexport function builtinDefaults(\n\tproviderId: string,\n\tmodelId?: string,\n\tapi?: string,\n): { api?: string; baseUrl?: string } {\n\tif (!isBuiltinProviderId(providerId)) return {};\n\tconst models = getBuiltinModels(providerId as never) as readonly Model<Api>[];\n\tif (models.length === 0) return {};\n\tconst found =\n\t\t(modelId ? models.find((model) => model.id === modelId) : undefined) ??\n\t\t(api ? models.find((model) => model.api === api) : undefined) ??\n\t\tmodels.find((model) => model.api === \"openai-completions\") ??\n\t\tmodels[0];\n\treturn { api: found.api, baseUrl: found.baseUrl };\n}\n\n/** Case-insensitive, separator-tolerant comparison key; keeps version/date/thinking variants. */\nfunction normalizeId(id: string): string {\n\tconst basename = id.includes(\"/\") ? id.slice(id.lastIndexOf(\"/\") + 1) : id;\n\treturn basename\n\t\t.toLowerCase()\n\t\t.replace(/[^a-z0-9]+/g, \"-\")\n\t\t.replace(/^-+|-+$/g, \"\");\n}\n\nexport type MatchTier = \"exact\" | \"normalized\" | \"fuzzy\";\n\nexport interface CatalogMatch {\n\tentry: CatalogEntry;\n\ttier: MatchTier;\n}\n\nfunction sortTier(matches: CatalogMatch[], preferredApi: string | undefined): CatalogMatch[] {\n\treturn matches.sort((a, b) => {\n\t\tif (preferredApi) {\n\t\t\tconst aPreferred = a.entry.model.api === preferredApi ? 0 : 1;\n\t\t\tconst bPreferred = b.entry.model.api === preferredApi ? 0 : 1;\n\t\t\tif (aPreferred !== bPreferred) return aPreferred - bPreferred;\n\t\t}\n\t\treturn a.entry.model.id.localeCompare(b.entry.model.id);\n\t});\n}\n\n/** Grouped reference candidates for a query id; at most `max` entries, best first. */\nexport function matchBuiltinModels(query: string, preferredApi?: string, max: number = MAX_CANDIDATES): CatalogMatch[] {\n\tconst trimmed = query.trim();\n\tif (!trimmed) return [];\n\tconst index = builtinCatalogIndex();\n\tconst normalizedQuery = normalizeId(trimmed);\n\tconst exact: CatalogMatch[] = [];\n\tconst normalized: CatalogMatch[] = [];\n\tconst consumed = new Set<CatalogEntry>();\n\tfor (const entry of index) {\n\t\tif (entry.model.id === trimmed) {\n\t\t\texact.push({ entry, tier: \"exact\" });\n\t\t\tconsumed.add(entry);\n\t\t} else if (normalizeId(entry.model.id) === normalizedQuery) {\n\t\t\tnormalized.push({ entry, tier: \"normalized\" });\n\t\t\tconsumed.add(entry);\n\t\t}\n\t}\n\tconst remaining = sortTier(\n\t\tindex.filter((entry) => !consumed.has(entry)).map((entry) => ({ entry, tier: \"fuzzy\" })),\n\t\tpreferredApi,\n\t);\n\tconst fuzzy: CatalogMatch[] = fuzzyFilter(\n\t\tremaining,\n\t\ttrimmed,\n\t\t({ entry }) => `${entry.model.id} ${entry.model.name} ${entry.providerId}`,\n\t);\n\treturn [...sortTier(exact, preferredApi), ...sortTier(normalized, preferredApi), ...fuzzy].slice(0, max);\n}\n\nexport type ReferenceField =\n\t| \"name\"\n\t| \"reasoning\"\n\t| \"input\"\n\t| \"contextWindow\"\n\t| \"maxTokens\"\n\t| \"thinkingLevelMap\"\n\t| \"compat\"\n\t| \"cost\";\n\nexport interface FieldChange {\n\tfield: ReferenceField;\n\t/** Pre-selected per the completion rules (unset scalar fields are checked; map/compat/cost never are). */\n\tchecked: boolean;\n\t/** False = cross-API map/compat: view-only, cannot be applied. */\n\tapplicable: boolean;\n\t/** Left side of the preview, e.g. `not set (falls back to id)`. */\n\tcurrentText: string;\n\t/** Right side of the preview, e.g. the reference value. */\n\treferenceText: string;\n\t/** Extra detail lines for the expandable view (thinking map entries, compat keys, cost rates). */\n\treferenceDetails?: string[];\n\t/** Reference carries tiers; applying cost keeps current tiers and never imports reference tiers. */\n\treferenceHasTiers?: boolean;\n}\n\nconst DEFAULT_CONTEXT_WINDOW = 128000;\nconst DEFAULT_MAX_TOKENS = 16384;\n\nfunction formatCostRates(cost: { input: number; output: number; cacheRead: number; cacheWrite: number }): string {\n\treturn `$${cost.input} / $${cost.output} in/out (cache $${cost.cacheRead} / $${cost.cacheWrite})`;\n}\n\n/**\n * Compute the per-field change list for applying `reference` onto `current`.\n * Only fields the reference actually has appear; an absent map/compat on the\n * reference never implies clearing the current value.\n */\nexport function computeFieldChanges(\n\tcurrent: Partial<ModelsJsonModel> & { id?: string },\n\treference: Model<Api>,\n\teffectiveApi: string | undefined,\n): FieldChange[] {\n\tconst changes: FieldChange[] = [];\n\tconst unset = (key: keyof ModelsJsonModel) => current[key] === undefined;\n\n\tchanges.push({\n\t\tfield: \"name\",\n\t\tchecked: unset(\"name\") && reference.name !== reference.id,\n\t\tapplicable: true,\n\t\tcurrentText: current.name ?? `not set (falls back to id${current.id ? ` \"${current.id}\"` : \"\"})`,\n\t\treferenceText: reference.name,\n\t});\n\tchanges.push({\n\t\tfield: \"reasoning\",\n\t\tchecked: unset(\"reasoning\") && reference.reasoning === true,\n\t\tapplicable: true,\n\t\tcurrentText: current.reasoning === undefined ? \"false (default)\" : String(current.reasoning),\n\t\treferenceText: String(reference.reasoning),\n\t});\n\tchanges.push({\n\t\tfield: \"input\",\n\t\tchecked: unset(\"input\"),\n\t\tapplicable: true,\n\t\tcurrentText: current.input ? current.input.join(\", \") : \"text (default)\",\n\t\treferenceText: reference.input.join(\", \"),\n\t});\n\tchanges.push({\n\t\tfield: \"contextWindow\",\n\t\tchecked: unset(\"contextWindow\"),\n\t\tapplicable: true,\n\t\tcurrentText:\n\t\t\tcurrent.contextWindow === undefined ? `${DEFAULT_CONTEXT_WINDOW} (default)` : String(current.contextWindow),\n\t\treferenceText: String(reference.contextWindow),\n\t});\n\tchanges.push({\n\t\tfield: \"maxTokens\",\n\t\tchecked: unset(\"maxTokens\"),\n\t\tapplicable: true,\n\t\tcurrentText: current.maxTokens === undefined ? `${DEFAULT_MAX_TOKENS} (default)` : String(current.maxTokens),\n\t\treferenceText: String(reference.maxTokens),\n\t});\n\n\tconst sameApi = effectiveApi !== undefined && reference.api === effectiveApi;\n\tif (reference.thinkingLevelMap && Object.keys(reference.thinkingLevelMap).length > 0) {\n\t\tconst details = Object.entries(reference.thinkingLevelMap).map(\n\t\t\t([level, target]) => `${level}: ${target === null ? \"null (hidden)\" : target}`,\n\t\t);\n\t\tchanges.push({\n\t\t\tfield: \"thinkingLevelMap\",\n\t\t\tchecked: false,\n\t\t\tapplicable: sameApi,\n\t\t\tcurrentText: current.thinkingLevelMap\n\t\t\t\t? `${Object.keys(current.thinkingLevelMap).length} ${plural(Object.keys(current.thinkingLevelMap).length, \"mapping\")}`\n\t\t\t\t: \"not set\",\n\t\t\t// Cross-api maps are view-only; the preview pane annotates that.\n\t\t\treferenceText: `${details.length} ${plural(details.length, \"mapping\")}`,\n\t\t\treferenceDetails: details,\n\t\t});\n\t}\n\tif (reference.compat && Object.keys(reference.compat).length > 0) {\n\t\tconst details = Object.entries(reference.compat).map(([key, value]) => `${key}: ${JSON.stringify(value)}`);\n\t\tchanges.push({\n\t\t\tfield: \"compat\",\n\t\t\tchecked: false,\n\t\t\tapplicable: sameApi,\n\t\t\tcurrentText: current.compat\n\t\t\t\t? `${Object.keys(current.compat).length} ${plural(Object.keys(current.compat).length, \"entry\")}`\n\t\t\t\t: \"not set\",\n\t\t\treferenceText: `${details.length} ${plural(details.length, \"entry\")}`,\n\t\t\treferenceDetails: details,\n\t\t});\n\t}\n\tif (reference.cost) {\n\t\tchanges.push({\n\t\t\tfield: \"cost\",\n\t\t\tchecked: false,\n\t\t\tapplicable: true,\n\t\t\tcurrentText: current.cost ? formatCostRates(current.cost) : \"all 0 (default)\",\n\t\t\treferenceText: formatCostRates(reference.cost),\n\t\t\treferenceDetails: [\n\t\t\t\t`input: $${reference.cost.input} / M tokens`,\n\t\t\t\t`output: $${reference.cost.output} / M tokens`,\n\t\t\t\t`cacheRead: $${reference.cost.cacheRead} / M tokens`,\n\t\t\t\t`cacheWrite: $${reference.cost.cacheWrite} / M tokens`,\n\t\t\t],\n\t\t\treferenceHasTiers: Array.isArray(reference.cost.tiers) && reference.cost.tiers.length > 0,\n\t\t});\n\t}\n\treturn changes;\n}\n"]}

package/dist/extensions/provider/compat-fields.d.ts

@@ -0,0 +1,25 @@
+/**
+ * Compat field catalog per effective API, derived from pi-ai's public compat
+ * types (OpenAICompletionsCompat / OpenAIResponsesCompat /
+ * AnthropicMessagesCompat / BedrockCompat). Each API variant exposes only the settings consumed by its published
+ * implementation; existing foreign fields are preserved by the editor.
+ */
+export type CompatValueKind = "boolean" | "enum" | "number" | "stringMap" | "json";
+export type CompatField<Key extends string = string> = {
+    key: Key;
+    note?: string;
+} & ({
+    kind: "enum";
+    options: readonly string[];
+} | {
+    kind: Exclude<CompatValueKind, "enum">;
+});
+export declare const THINKING_VARIABLES: readonly ["thinking.enabled", "thinking.effort", "thinking.budget"];
+/** Compat fields known for the given effective api; empty when the API consumes no compat object. */
+export declare function compatFieldsForApi(api: string): readonly CompatField[];
+export declare function compatFieldFor(api: string, key: string): CompatField | undefined;
+/** Parse JSON values and reuse the canonical models.json schema, including nested validation. */
+export declare function validateJsonCompatValue(key: string, text: string): string | undefined;
+/** Chat-template values share the core schema and the published pi-ai value contract. */
+export declare function validateChatTemplateKwarg(value: unknown): string | undefined;
+//# sourceMappingURL=compat-fields.d.ts.map

package/dist/extensions/provider/compat-fields.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"compat-fields.d.ts","sourceRoot":"","sources":["../../../src/extensions/provider/compat-fields.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAWH,MAAM,MAAM,eAAe,GAAG,SAAS,GAAG,MAAM,GAAG,QAAQ,GAAG,WAAW,GAAG,MAAM,CAAC;AAEnF,MAAM,MAAM,WAAW,CAAC,GAAG,SAAS,MAAM,GAAG,MAAM,IAAI;IACtD,GAAG,EAAE,GAAG,CAAC;IACT,IAAI,CAAC,EAAE,MAAM,CAAC;CACd,GAAG,CAAC;IAAE,IAAI,EAAE,MAAM,CAAC;IAAC,OAAO,EAAE,SAAS,MAAM,EAAE,CAAA;CAAE,GAAG;IAAE,IAAI,EAAE,OAAO,CAAC,eAAe,EAAE,MAAM,CAAC,CAAA;CAAE,CAAC,CAAC;AAEhG,eAAO,MAAM,kBAAkB,qEAI0D,CAAC;AA6F1F,qGAAqG;AACrG,wBAAgB,kBAAkB,CAAC,GAAG,EAAE,MAAM,GAAG,SAAS,WAAW,EAAE,CA0BtE;AAED,wBAAgB,cAAc,CAAC,GAAG,EAAE,MAAM,EAAE,GAAG,EAAE,MAAM,GAAG,WAAW,GAAG,SAAS,CAEhF;AAED,iGAAiG;AACjG,wBAAgB,uBAAuB,CAAC,GAAG,EAAE,MAAM,EAAE,IAAI,EAAE,MAAM,GAAG,MAAM,GAAG,SAAS,CAQrF;AAED,yFAAyF;AACzF,wBAAgB,yBAAyB,CAAC,KAAK,EAAE,OAAO,GAAG,MAAM,GAAG,SAAS,CAW5E"}

package/dist/extensions/provider/compat-fields.js

@@ -0,0 +1,148 @@
+/**
+ * Compat field catalog per effective API, derived from pi-ai's public compat
+ * types (OpenAICompletionsCompat / OpenAIResponsesCompat /
+ * AnthropicMessagesCompat / BedrockCompat). Each API variant exposes only the settings consumed by its published
+ * implementation; existing foreign fields are preserved by the editor.
+ */
+import { ModelConfig } from "../../core/model-config.js";
+export const THINKING_VARIABLES = [
+    "thinking.enabled",
+    "thinking.effort",
+    "thinking.budget",
+];
+const SESSION_AFFINITY = ["openai", "openai-nosession", "openrouter"];
+const OPENAI_COMPLETIONS_FIELDS = [
+    { key: "supportsStore", kind: "boolean", note: "Accepts the `store` parameter" },
+    { key: "supportsDeveloperRole", kind: "boolean", note: "Accepts `developer` role messages" },
+    { key: "supportsReasoningEffort", kind: "boolean", note: "Accepts `reasoning_effort`" },
+    { key: "supportsUsageInStreaming", kind: "boolean", note: "Streams usage chunks" },
+    { key: "supportsFinishReason", kind: "boolean", note: "Reports finish reasons" },
+    {
+        key: "maxTokensField",
+        kind: "enum",
+        options: ["max_completion_tokens", "max_tokens"],
+        note: "Token limit field name",
+    },
+    { key: "requiresToolResultName", kind: "boolean", note: "Tool results need a `name`" },
+    { key: "requiresAssistantAfterToolResult", kind: "boolean", note: "Needs assistant message after tool results" },
+    { key: "requiresThinkingAsText", kind: "boolean", note: "Thinking must be plain text" },
+    {
+        key: "requiresReasoningContentOnAssistantMessages",
+        kind: "boolean",
+        note: "Assistant messages must carry reasoning content",
+    },
+    {
+        key: "thinkingFormat",
+        kind: "enum",
+        options: [
+            "openai",
+            "openrouter",
+            "together",
+            "baseten",
+            "deepseek",
+            "zai",
+            "qwen",
+            "chat-template",
+            "qwen-chat-template",
+            "string-thinking",
+            "ant-ling",
+        ],
+        note: "Reasoning payload format",
+    },
+    { key: "chatTemplateKwargs", kind: "stringMap", note: "Extra chat-template kwargs (open dictionary)" },
+    { key: "chatTemplateArgs", kind: "stringMap", note: "Extra chat-template args (open dictionary)" },
+    { key: "cacheControlFormat", kind: "enum", options: ["anthropic"], note: "Cache-control payload format" },
+    { key: "openRouterRouting", kind: "json", note: "OpenRouter routing preferences object" },
+    { key: "vercelGatewayRouting", kind: "json", note: "Vercel AI Gateway routing object" },
+    { key: "supportsOpenAIGrammarTools", kind: "boolean", note: "Grammar-constrained tool calls" },
+    { key: "supportsStrictMode", kind: "boolean", note: "Strict tool schemas" },
+    { key: "sendSessionAffinityHeaders", kind: "boolean", note: "Send session affinity headers" },
+    { key: "deferredToolsMode", kind: "enum", options: ["kimi"], note: "Deferred tool-call handling" },
+    { key: "sessionAffinityFormat", kind: "enum", options: SESSION_AFFINITY, note: "Affinity header format" },
+    { key: "supportsLongCacheRetention", kind: "boolean", note: "Long-lived prompt cache retention" },
+    { key: "vllmPriority", kind: "number", note: "vLLM scheduling priority" },
+    { key: "zaiToolStream", kind: "boolean", note: "Z.AI streaming tool calls" },
+    { key: "supportsThinkingTokenBudget", kind: "boolean", note: "Enable the thinking-token budget alias" },
+    {
+        key: "thinkingTokenBudgetField",
+        kind: "enum",
+        options: ["thinking_token_budget", "thinking_budget", "thinking_budget_tokens"],
+        note: "Thinking budget field",
+    },
+];
+const OPENAI_RESPONSES_FIELDS = [
+    { key: "supportsDeveloperRole", kind: "boolean", note: "Accepts `developer` role messages" },
+    { key: "sessionAffinityFormat", kind: "enum", options: SESSION_AFFINITY, note: "Affinity header format" },
+    { key: "supportsLongCacheRetention", kind: "boolean", note: "Long-lived prompt cache retention" },
+    { key: "supportsStrictMode", kind: "boolean", note: "Strict tool schemas" },
+    { key: "supportsOpenAIGrammarTools", kind: "boolean", note: "Grammar-constrained tool calls" },
+    { key: "supportsAdditionalTools", kind: "boolean", note: "Accepts additional hosted tools" },
+    { key: "supportsToolSearch", kind: "boolean", note: "Tool search support" },
+    { key: "supportsMaxOutputTokens", kind: "boolean", note: "Accepts `max_output_tokens`" },
+    { key: "supportsExplicitPromptCacheMode", kind: "boolean", note: "Explicit prompt caching" },
+];
+const ANTHROPIC_MESSAGES_FIELDS = [
+    { key: "supportsEagerToolInputStreaming", kind: "boolean", note: "Streams tool input eagerly" },
+    { key: "supportsLongCacheRetention", kind: "boolean", note: "Long-lived prompt cache retention" },
+    { key: "sendSessionAffinityHeaders", kind: "boolean", note: "Send session affinity headers" },
+    { key: "supportsCacheControlOnTools", kind: "boolean", note: "Cache control on tool definitions" },
+    { key: "supportsTemperature", kind: "boolean", note: "Accepts `temperature`" },
+    { key: "forceAdaptiveThinking", kind: "boolean", note: "Force adaptive thinking mode" },
+    { key: "allowEmptySignature", kind: "boolean", note: "Tolerate empty thinking signatures" },
+    { key: "supportsStrictTools", kind: "boolean", note: "Strict tool schemas" },
+    { key: "supportsMidConvoEffort", kind: "boolean", note: "Effort changes mid-conversation" },
+    { key: "supportsToolReferences", kind: "boolean", note: "Tool references support" },
+];
+const BEDROCK_FIELDS = [
+    { key: "supportsStrictMode", kind: "boolean", note: "Strict tool schemas" },
+];
+/** Compat fields known for the given effective api; empty when the API consumes no compat object. */
+export function compatFieldsForApi(api) {
+    switch (api) {
+        case "openai-completions":
+            return OPENAI_COMPLETIONS_FIELDS;
+        case "openai-responses":
+            return OPENAI_RESPONSES_FIELDS;
+        case "azure-openai-responses":
+            return OPENAI_RESPONSES_FIELDS.filter((field) => ["supportsDeveloperRole", "supportsStrictMode", "supportsOpenAIGrammarTools"].includes(field.key));
+        case "openai-codex-responses":
+            return OPENAI_RESPONSES_FIELDS.filter((field) => [
+                "supportsStrictMode",
+                "supportsOpenAIGrammarTools",
+                "supportsAdditionalTools",
+                "supportsToolSearch",
+            ].includes(field.key));
+        case "anthropic-messages":
+            return ANTHROPIC_MESSAGES_FIELDS;
+        case "bedrock-converse-stream":
+            return BEDROCK_FIELDS;
+        default:
+            return [];
+    }
+}
+export function compatFieldFor(api, key) {
+    return compatFieldsForApi(api).find((field) => field.key === key);
+}
+/** Parse JSON values and reuse the canonical models.json schema, including nested validation. */
+export function validateJsonCompatValue(key, text) {
+    let value;
+    try {
+        value = JSON.parse(text);
+    }
+    catch {
+        return "Value is not valid JSON.";
+    }
+    return ModelConfig.validateCompat("openai-completions", { [key]: value });
+}
+/** Chat-template values share the core schema and the published pi-ai value contract. */
+export function validateChatTemplateKwarg(value) {
+    if (value !== null &&
+        typeof value === "object" &&
+        !Array.isArray(value) &&
+        !Object.keys(value).every((key) => key === "$var" || key === "omitWhenOff")) {
+        return 'Only "$var" and "omitWhenOff" are allowed.';
+    }
+    const error = ModelConfig.validateCompat("openai-completions", { chatTemplateKwargs: { value } });
+    return error ? `Value must be a scalar or valid $var reference: ${error}` : undefined;
+}
+//# sourceMappingURL=compat-fields.js.map

package/dist/extensions/provider/compat-fields.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"compat-fields.js","sourceRoot":"","sources":["../../../src/extensions/provider/compat-fields.ts"],"names":[],"mappings":"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","sourcesContent":["/**\n * Compat field catalog per effective API, derived from pi-ai's public compat\n * types (OpenAICompletionsCompat / OpenAIResponsesCompat /\n * AnthropicMessagesCompat / BedrockCompat). Each API variant exposes only the settings consumed by its published\n * implementation; existing foreign fields are preserved by the editor.\n */\n\nimport type {\n\tAnthropicMessagesCompat,\n\tBedrockCompat,\n\tChatTemplateKwargValue,\n\tOpenAICompletionsCompat,\n\tOpenAIResponsesCompat,\n} from \"@earendil-works/pi-ai\";\nimport { ModelConfig } from \"../../core/model-config.ts\";\n\nexport type CompatValueKind = \"boolean\" | \"enum\" | \"number\" | \"stringMap\" | \"json\";\n\nexport type CompatField<Key extends string = string> = {\n\tkey: Key;\n\tnote?: string;\n} & ({ kind: \"enum\"; options: readonly string[] } | { kind: Exclude<CompatValueKind, \"enum\"> });\n\nexport const THINKING_VARIABLES = [\n\t\"thinking.enabled\",\n\t\"thinking.effort\",\n\t\"thinking.budget\",\n] as const satisfies readonly Extract<ChatTemplateKwargValue, { $var: string }>[\"$var\"][];\n\nconst SESSION_AFFINITY = [\"openai\", \"openai-nosession\", \"openrouter\"] as const;\n\nconst OPENAI_COMPLETIONS_FIELDS: readonly CompatField<keyof OpenAICompletionsCompat>[] = [\n\t{ key: \"supportsStore\", kind: \"boolean\", note: \"Accepts the `store` parameter\" },\n\t{ key: \"supportsDeveloperRole\", kind: \"boolean\", note: \"Accepts `developer` role messages\" },\n\t{ key: \"supportsReasoningEffort\", kind: \"boolean\", note: \"Accepts `reasoning_effort`\" },\n\t{ key: \"supportsUsageInStreaming\", kind: \"boolean\", note: \"Streams usage chunks\" },\n\t{ key: \"supportsFinishReason\", kind: \"boolean\", note: \"Reports finish reasons\" },\n\t{\n\t\tkey: \"maxTokensField\",\n\t\tkind: \"enum\",\n\t\toptions: [\"max_completion_tokens\", \"max_tokens\"],\n\t\tnote: \"Token limit field name\",\n\t},\n\t{ key: \"requiresToolResultName\", kind: \"boolean\", note: \"Tool results need a `name`\" },\n\t{ key: \"requiresAssistantAfterToolResult\", kind: \"boolean\", note: \"Needs assistant message after tool results\" },\n\t{ key: \"requiresThinkingAsText\", kind: \"boolean\", note: \"Thinking must be plain text\" },\n\t{\n\t\tkey: \"requiresReasoningContentOnAssistantMessages\",\n\t\tkind: \"boolean\",\n\t\tnote: \"Assistant messages must carry reasoning content\",\n\t},\n\t{\n\t\tkey: \"thinkingFormat\",\n\t\tkind: \"enum\",\n\t\toptions: [\n\t\t\t\"openai\",\n\t\t\t\"openrouter\",\n\t\t\t\"together\",\n\t\t\t\"baseten\",\n\t\t\t\"deepseek\",\n\t\t\t\"zai\",\n\t\t\t\"qwen\",\n\t\t\t\"chat-template\",\n\t\t\t\"qwen-chat-template\",\n\t\t\t\"string-thinking\",\n\t\t\t\"ant-ling\",\n\t\t],\n\t\tnote: \"Reasoning payload format\",\n\t},\n\t{ key: \"chatTemplateKwargs\", kind: \"stringMap\", note: \"Extra chat-template kwargs (open dictionary)\" },\n\t{ key: \"chatTemplateArgs\", kind: \"stringMap\", note: \"Extra chat-template args (open dictionary)\" },\n\t{ key: \"cacheControlFormat\", kind: \"enum\", options: [\"anthropic\"], note: \"Cache-control payload format\" },\n\t{ key: \"openRouterRouting\", kind: \"json\", note: \"OpenRouter routing preferences object\" },\n\t{ key: \"vercelGatewayRouting\", kind: \"json\", note: \"Vercel AI Gateway routing object\" },\n\t{ key: \"supportsOpenAIGrammarTools\", kind: \"boolean\", note: \"Grammar-constrained tool calls\" },\n\t{ key: \"supportsStrictMode\", kind: \"boolean\", note: \"Strict tool schemas\" },\n\t{ key: \"sendSessionAffinityHeaders\", kind: \"boolean\", note: \"Send session affinity headers\" },\n\t{ key: \"deferredToolsMode\", kind: \"enum\", options: [\"kimi\"], note: \"Deferred tool-call handling\" },\n\t{ key: \"sessionAffinityFormat\", kind: \"enum\", options: SESSION_AFFINITY, note: \"Affinity header format\" },\n\t{ key: \"supportsLongCacheRetention\", kind: \"boolean\", note: \"Long-lived prompt cache retention\" },\n\t{ key: \"vllmPriority\", kind: \"number\", note: \"vLLM scheduling priority\" },\n\t{ key: \"zaiToolStream\", kind: \"boolean\", note: \"Z.AI streaming tool calls\" },\n\t{ key: \"supportsThinkingTokenBudget\", kind: \"boolean\", note: \"Enable the thinking-token budget alias\" },\n\t{\n\t\tkey: \"thinkingTokenBudgetField\",\n\t\tkind: \"enum\",\n\t\toptions: [\"thinking_token_budget\", \"thinking_budget\", \"thinking_budget_tokens\"],\n\t\tnote: \"Thinking budget field\",\n\t},\n];\n\nconst OPENAI_RESPONSES_FIELDS: readonly CompatField<keyof OpenAIResponsesCompat>[] = [\n\t{ key: \"supportsDeveloperRole\", kind: \"boolean\", note: \"Accepts `developer` role messages\" },\n\t{ key: \"sessionAffinityFormat\", kind: \"enum\", options: SESSION_AFFINITY, note: \"Affinity header format\" },\n\t{ key: \"supportsLongCacheRetention\", kind: \"boolean\", note: \"Long-lived prompt cache retention\" },\n\t{ key: \"supportsStrictMode\", kind: \"boolean\", note: \"Strict tool schemas\" },\n\t{ key: \"supportsOpenAIGrammarTools\", kind: \"boolean\", note: \"Grammar-constrained tool calls\" },\n\t{ key: \"supportsAdditionalTools\", kind: \"boolean\", note: \"Accepts additional hosted tools\" },\n\t{ key: \"supportsToolSearch\", kind: \"boolean\", note: \"Tool search support\" },\n\t{ key: \"supportsMaxOutputTokens\", kind: \"boolean\", note: \"Accepts `max_output_tokens`\" },\n\t{ key: \"supportsExplicitPromptCacheMode\", kind: \"boolean\", note: \"Explicit prompt caching\" },\n];\n\nconst ANTHROPIC_MESSAGES_FIELDS: readonly CompatField<keyof AnthropicMessagesCompat>[] = [\n\t{ key: \"supportsEagerToolInputStreaming\", kind: \"boolean\", note: \"Streams tool input eagerly\" },\n\t{ key: \"supportsLongCacheRetention\", kind: \"boolean\", note: \"Long-lived prompt cache retention\" },\n\t{ key: \"sendSessionAffinityHeaders\", kind: \"boolean\", note: \"Send session affinity headers\" },\n\t{ key: \"supportsCacheControlOnTools\", kind: \"boolean\", note: \"Cache control on tool definitions\" },\n\t{ key: \"supportsTemperature\", kind: \"boolean\", note: \"Accepts `temperature`\" },\n\t{ key: \"forceAdaptiveThinking\", kind: \"boolean\", note: \"Force adaptive thinking mode\" },\n\t{ key: \"allowEmptySignature\", kind: \"boolean\", note: \"Tolerate empty thinking signatures\" },\n\t{ key: \"supportsStrictTools\", kind: \"boolean\", note: \"Strict tool schemas\" },\n\t{ key: \"supportsMidConvoEffort\", kind: \"boolean\", note: \"Effort changes mid-conversation\" },\n\t{ key: \"supportsToolReferences\", kind: \"boolean\", note: \"Tool references support\" },\n];\n\nconst BEDROCK_FIELDS: readonly CompatField<keyof BedrockCompat>[] = [\n\t{ key: \"supportsStrictMode\", kind: \"boolean\", note: \"Strict tool schemas\" },\n];\n\n/** Compat fields known for the given effective api; empty when the API consumes no compat object. */\nexport function compatFieldsForApi(api: string): readonly CompatField[] {\n\tswitch (api) {\n\t\tcase \"openai-completions\":\n\t\t\treturn OPENAI_COMPLETIONS_FIELDS;\n\t\tcase \"openai-responses\":\n\t\t\treturn OPENAI_RESPONSES_FIELDS;\n\t\tcase \"azure-openai-responses\":\n\t\t\treturn OPENAI_RESPONSES_FIELDS.filter((field) =>\n\t\t\t\t[\"supportsDeveloperRole\", \"supportsStrictMode\", \"supportsOpenAIGrammarTools\"].includes(field.key),\n\t\t\t);\n\t\tcase \"openai-codex-responses\":\n\t\t\treturn OPENAI_RESPONSES_FIELDS.filter((field) =>\n\t\t\t\t[\n\t\t\t\t\t\"supportsStrictMode\",\n\t\t\t\t\t\"supportsOpenAIGrammarTools\",\n\t\t\t\t\t\"supportsAdditionalTools\",\n\t\t\t\t\t\"supportsToolSearch\",\n\t\t\t\t].includes(field.key),\n\t\t\t);\n\t\tcase \"anthropic-messages\":\n\t\t\treturn ANTHROPIC_MESSAGES_FIELDS;\n\t\tcase \"bedrock-converse-stream\":\n\t\t\treturn BEDROCK_FIELDS;\n\t\tdefault:\n\t\t\treturn [];\n\t}\n}\n\nexport function compatFieldFor(api: string, key: string): CompatField | undefined {\n\treturn compatFieldsForApi(api).find((field) => field.key === key);\n}\n\n/** Parse JSON values and reuse the canonical models.json schema, including nested validation. */\nexport function validateJsonCompatValue(key: string, text: string): string | undefined {\n\tlet value: unknown;\n\ttry {\n\t\tvalue = JSON.parse(text);\n\t} catch {\n\t\treturn \"Value is not valid JSON.\";\n\t}\n\treturn ModelConfig.validateCompat(\"openai-completions\", { [key]: value });\n}\n\n/** Chat-template values share the core schema and the published pi-ai value contract. */\nexport function validateChatTemplateKwarg(value: unknown): string | undefined {\n\tif (\n\t\tvalue !== null &&\n\t\ttypeof value === \"object\" &&\n\t\t!Array.isArray(value) &&\n\t\t!Object.keys(value).every((key) => key === \"$var\" || key === \"omitWhenOff\")\n\t) {\n\t\treturn 'Only \"$var\" and \"omitWhenOff\" are allowed.';\n\t}\n\tconst error = ModelConfig.validateCompat(\"openai-completions\", { chatTemplateKwargs: { value } });\n\treturn error ? `Value must be a scalar or valid $var reference: ${error}` : undefined;\n}\n"]}

package/dist/extensions/provider/configuration.d.ts

@@ -0,0 +1,8 @@
+/** Provider defaults and draft completeness shared by the editor and persistence layer. */
+import type { ModelsJsonModel, ModelsJsonProvider } from "../../core/model-config.ts";
+export declare function hasProviderSettings(provider: ModelsJsonProvider | undefined): boolean;
+export declare function effectiveModelSettings(providerId: string, provider: ModelsJsonProvider | undefined, model?: Partial<ModelsJsonModel>): {
+    api?: string;
+    baseUrl?: string;
+};
+//# sourceMappingURL=configuration.d.ts.map

package/dist/extensions/provider/configuration.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"configuration.d.ts","sourceRoot":"","sources":["../../../src/extensions/provider/configuration.ts"],"names":[],"mappings":"AAAA,2FAA2F;AAE3F,OAAO,KAAK,EAAE,eAAe,EAAE,kBAAkB,EAAE,MAAM,4BAA4B,CAAC;AAGtF,wBAAgB,mBAAmB,CAAC,QAAQ,EAAE,kBAAkB,GAAG,SAAS,GAAG,OAAO,CAYrF;AAED,wBAAgB,sBAAsB,CACrC,UAAU,EAAE,MAAM,EAClB,QAAQ,EAAE,kBAAkB,GAAG,SAAS,EACxC,KAAK,GAAE,OAAO,CAAC,eAAe,CAAM,GAClC;IAAE,GAAG,CAAC,EAAE,MAAM,CAAC;IAAC,OAAO,CAAC,EAAE,MAAM,CAAA;CAAE,CAMpC"}

package/dist/extensions/provider/configuration.js

@@ -0,0 +1,21 @@
+/** Provider defaults and draft completeness shared by the editor and persistence layer. */
+import { builtinDefaults } from "./catalog.js";
+export function hasProviderSettings(provider) {
+    return Boolean(provider &&
+        (provider.baseUrl ||
+            provider.apiKey ||
+            provider.headers ||
+            provider.compat ||
+            provider.oauth ||
+            provider.authHeader !== undefined ||
+            provider.models?.length ||
+            Object.keys(provider.modelOverrides ?? {}).length));
+}
+export function effectiveModelSettings(providerId, provider, model = {}) {
+    const fallback = builtinDefaults(providerId, model.id, model.api ?? provider?.api);
+    return {
+        api: model.api ?? provider?.api ?? fallback.api,
+        baseUrl: model.baseUrl ?? provider?.baseUrl ?? fallback.baseUrl,
+    };
+}
+//# sourceMappingURL=configuration.js.map

package/dist/extensions/provider/configuration.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"configuration.js","sourceRoot":"","sources":["../../../src/extensions/provider/configuration.ts"],"names":[],"mappings":"AAAA,2FAA2F;AAG3F,OAAO,EAAE,eAAe,EAAE,MAAM,cAAc,CAAC;AAE/C,MAAM,UAAU,mBAAmB,CAAC,QAAwC;IAC3E,OAAO,OAAO,CACb,QAAQ;QACP,CAAC,QAAQ,CAAC,OAAO;YAChB,QAAQ,CAAC,MAAM;YACf,QAAQ,CAAC,OAAO;YAChB,QAAQ,CAAC,MAAM;YACf,QAAQ,CAAC,KAAK;YACd,QAAQ,CAAC,UAAU,KAAK,SAAS;YACjC,QAAQ,CAAC,MAAM,EAAE,MAAM;YACvB,MAAM,CAAC,IAAI,CAAC,QAAQ,CAAC,cAAc,IAAI,EAAE,CAAC,CAAC,MAAM,CAAC,CACpD,CAAC;AACH,CAAC;AAED,MAAM,UAAU,sBAAsB,CACrC,UAAkB,EAClB,QAAwC,EACxC,QAAkC,EAAE;IAEpC,MAAM,QAAQ,GAAG,eAAe,CAAC,UAAU,EAAE,KAAK,CAAC,EAAE,EAAE,KAAK,CAAC,GAAG,IAAI,QAAQ,EAAE,GAAG,CAAC,CAAC;IACnF,OAAO;QACN,GAAG,EAAE,KAAK,CAAC,GAAG,IAAI,QAAQ,EAAE,GAAG,IAAI,QAAQ,CAAC,GAAG;QAC/C,OAAO,EAAE,KAAK,CAAC,OAAO,IAAI,QAAQ,EAAE,OAAO,IAAI,QAAQ,CAAC,OAAO;KAC/D,CAAC;AACH,CAAC","sourcesContent":["/** Provider defaults and draft completeness shared by the editor and persistence layer. */\n\nimport type { ModelsJsonModel, ModelsJsonProvider } from \"../../core/model-config.ts\";\nimport { builtinDefaults } from \"./catalog.ts\";\n\nexport function hasProviderSettings(provider: ModelsJsonProvider | undefined): boolean {\n\treturn Boolean(\n\t\tprovider &&\n\t\t\t(provider.baseUrl ||\n\t\t\t\tprovider.apiKey ||\n\t\t\t\tprovider.headers ||\n\t\t\t\tprovider.compat ||\n\t\t\t\tprovider.oauth ||\n\t\t\t\tprovider.authHeader !== undefined ||\n\t\t\t\tprovider.models?.length ||\n\t\t\t\tObject.keys(provider.modelOverrides ?? {}).length),\n\t);\n}\n\nexport function effectiveModelSettings(\n\tproviderId: string,\n\tprovider: ModelsJsonProvider | undefined,\n\tmodel: Partial<ModelsJsonModel> = {},\n): { api?: string; baseUrl?: string } {\n\tconst fallback = builtinDefaults(providerId, model.id, model.api ?? provider?.api);\n\treturn {\n\t\tapi: model.api ?? provider?.api ?? fallback.api,\n\t\tbaseUrl: model.baseUrl ?? provider?.baseUrl ?? fallback.baseUrl,\n\t};\n}\n"]}

package/dist/extensions/provider/connection.d.ts

@@ -0,0 +1,14 @@
+/** Saved provider configuration, canonical authentication, and catalog import operations. */
+import type { ModelRuntime } from "../../core/model-runtime.ts";
+import { type ProbeModel, type ProbeResult } from "./probe.ts";
+import type { RefreshCoordinator } from "./refresh.ts";
+import type { ModelsJsonStore } from "./store.ts";
+export interface ProviderConnectionOptions {
+    store: ModelsJsonStore;
+    refresher: RefreshCoordinator;
+    providerId: string;
+    runtime: Pick<ModelRuntime, "getAuth" | "getProviderAuthStatus">;
+}
+export declare function fetchProviderModels(options: ProviderConnectionOptions, signal: AbortSignal): Promise<ProbeResult>;
+export declare function importProviderModels(options: ProviderConnectionOptions, models: readonly ProbeModel[], signal: AbortSignal): Promise<string | undefined>;
+//# sourceMappingURL=connection.d.ts.map

package/dist/extensions/provider/connection.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"connection.d.ts","sourceRoot":"","sources":["../../../src/extensions/provider/connection.ts"],"names":[],"mappings":"AAAA,6FAA6F;AAE7F,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,6BAA6B,CAAC;AAIhE,OAAO,EAAE,KAAK,UAAU,EAAE,KAAK,WAAW,EAAuB,MAAM,YAAY,CAAC;AACpF,OAAO,KAAK,EAAE,kBAAkB,EAAE,MAAM,cAAc,CAAC;AACvD,OAAO,KAAK,EAAE,eAAe,EAAE,MAAM,YAAY,CAAC;AAElD,MAAM,WAAW,yBAAyB;IACzC,KAAK,EAAE,eAAe,CAAC;IACvB,SAAS,EAAE,kBAAkB,CAAC;IAC9B,UAAU,EAAE,MAAM,CAAC;IACnB,OAAO,EAAE,IAAI,CAAC,YAAY,EAAE,SAAS,GAAG,uBAAuB,CAAC,CAAC;CACjE;AAED,wBAAsB,mBAAmB,CACxC,OAAO,EAAE,yBAAyB,EAClC,MAAM,EAAE,WAAW,GACjB,OAAO,CAAC,WAAW,CAAC,CA0CtB;AAED,wBAAsB,oBAAoB,CACzC,OAAO,EAAE,yBAAyB,EAClC,MAAM,EAAE,SAAS,UAAU,EAAE,EAC7B,MAAM,EAAE,WAAW,GACjB,OAAO,CAAC,MAAM,GAAG,SAAS,CAAC,CA2B7B"}