@vymalo/opencode-models-info 0.11.0 → 0.14.0

package/README.md

@@ -90,6 +90,7 @@ This warms the cache for the **next** `config` run (the next launch, the next wi
 | `meta.modelsInfoOverwrite`      | _(none)_           | Array of field names (`name`, `attachment`, `reasoning`, `temperature`, `tool_call`, `cost`, `limit`, `modalities`) that the endpoint is allowed to overwrite even when already set. Opts those fields out of upstream-wins — see [Forcing endpoint values to win](#forcing-endpoint-values-to-win). Unknown names are ignored. |
 | `meta.modelsInfoHideTextOnly`   | `false`             | When `true`, makes the `modelsInfoUrl` catalog authoritative for which models are shown: drops a model from `provider.models` entirely if the catalog reports it as text-in/text-out only, **or** if the catalog doesn't mention it at all — see [Hiding text-only models](#hiding-text-only-models). |
 | `meta.modelsInfoHideInternal`   | `false`             | When `true`, drops a model from `provider.models` if the catalog reports a non-standard `internal: true` field for it. Independent of `modelsInfoHideTextOnly` — modality and internal/restricted status are unrelated signals — see [Hiding internal models](#hiding-internal-models). |
+| `meta.modelsInfoHideUnmatched`  | `false`             | When `true`, drops a model from `provider.models` if the catalog has no entry for it at all — the membership half of `modelsInfoHideTextOnly`, without its modality filtering. Either flag alone triggers the same deletion — see [Requiring a catalog entry](#requiring-a-catalog-entry). |
 
 ### Auth composition
 
@@ -174,6 +175,29 @@ This is a hard delete, not a flag — a hidden model can't be selected at all, t
 
 > **Composes with `modelsInfoOverwrite`.** Turning on `modelsInfoHideTextOnly` doesn't change how surviving models are merged — upstream-wins (or your `modelsInfoOverwrite` list) still governs individual fields. It only changes which model entries survive to be merged at all.
 
+### Requiring a catalog entry
+
+Case 2 above — dropping a model the catalog doesn't mention at all — is useful on its own, without the modality filtering that comes bundled into `modelsInfoHideTextOnly`. Set `meta.modelsInfoHideUnmatched: true` to get just that:
+
+```jsonc
+{
+  "options": {
+    "meta": {
+      "modelsInfoUrl": "models/info",
+      "modelsInfoHideUnmatched": true
+    }
+  }
+}
+```
+
+This exists because a real adopter needed catalog-authoritative *membership* — a client's `provider.models` can carry ids the catalog has since dropped (renamed, removed, access-scoped, or just stale local state a client picked up a while ago) — but `modelsInfoHideTextOnly`'s modality filtering was hiding legitimate text-only external models right along with the stale ones.
+
+- A model with no catalog entry is hidden, regardless of modality.
+- A matched text-only model is left alone by this flag on its own (it's still subject to `modelsInfoHideTextOnly`'s modality check if that flag is *also* set).
+- `modelsInfoHideTextOnly` and `modelsInfoHideUnmatched` reach the same deletion for an unmatched model — either alone is enough, setting both is redundant, not additive.
+
+Don't reach for `modelsInfoHideTextOnly` just to get this behavior if you don't also want modality filtering — that's exactly the trap `modelsInfoHideInternal` was built to avoid for the internal/access-scope axis (see below). Logs at debug (`models_info_model_hidden_unmatched`, shared with `modelsInfoHideTextOnly`'s own unmatched-hiding).
+
 ### Hiding internal models
 
 If your catalog serves both externally-usable and internal-only/restricted models — models that exist on the backend but shouldn't be selectable in OpenCode — flag them explicitly and set `meta.modelsInfoHideInternal: true`:
@@ -201,7 +225,7 @@ Your catalog entry adds a non-standard `internal: true` field:
 - `internal` absent or `false` → never hidden by this flag, regardless of modality.
 - Unknown (`internal` field absent from the catalog entry) is left alone, not treated as `false` — same "known before we assert" rule as everywhere else in this plugin.
 
-The two flags compose freely; set whichever your catalog's semantics call for, or both. Note that `modelsInfoHideInternal` does **not** extend case 2 above (dropping a model your catalog has no entry for at all) — that stays governed solely by `modelsInfoHideTextOnly`, since an unmatched model's status is unknown, not "internal." Logs at debug (`models_info_model_hidden_internal`).
+All three flags compose freely; set whichever your catalog's semantics call for. Note that `modelsInfoHideInternal` does **not** extend case 2 above (dropping a model your catalog has no entry for at all) — that's governed by `modelsInfoHideTextOnly` or `modelsInfoHideUnmatched` (see above), since an unmatched model's status is unknown, not "internal." Logs at debug (`models_info_model_hidden_internal`).
 
 ### Expected response shape (OpenRouter)
 

package/dist/cache.d.ts

@@ -1,33 +1,33 @@
 import type { CachedModelsRecord } from "./types.js";
 export declare function resolveCacheDir(namespace?: string): string;
 /**
- * Cache key = sha256(providerId :: url :: stableJSON(headers)).
- *
- * Only the **caller-specified** headers (i.e. `meta.modelsInfoHeaders`) go
- * into the key — NOT the provider's other request headers. Rationale: if a
- * rotating bearer (e.g. from `@vymalo/opencode-oauth2`) were keyed in, the
- * cache would thrash on every token refresh. Headers the user explicitly
- * configures for the metadata fetch (tenant selectors, static auth, etc.)
- * are exactly the ones that should bust the cache when they change.
- */
+* Cache key = sha256(providerId :: url :: stableJSON(headers)).
+*
+* Only the **caller-specified** headers (i.e. `meta.modelsInfoHeaders`) go
+* into the key — NOT the provider's other request headers. Rationale: if a
+* rotating bearer (e.g. from `@vymalo/opencode-oauth2`) were keyed in, the
+* cache would thrash on every token refresh. Headers the user explicitly
+* configures for the metadata fetch (tenant selectors, static auth, etc.)
+* are exactly the ones that should bust the cache when they change.
+*/
 export declare function cacheKey(providerId: string, url: string, headers?: Record<string, string>): string;
 export interface CacheStore {
-    get(key: string): Promise<CachedModelsRecord | undefined>;
-    put(key: string, record: CachedModelsRecord): Promise<void>;
+	get(key: string): Promise<CachedModelsRecord | undefined>;
+	put(key: string, record: CachedModelsRecord): Promise<void>;
 }
 /**
- * Two-layer cache: an in-memory map for the process lifetime, backed by JSON
- * files on disk so cold starts reuse the last good snapshot. Disk writes are
- * atomic via rename-after-write so a crashed process can't leave a torn file.
- */
+* Two-layer cache: an in-memory map for the process lifetime, backed by JSON
+* files on disk so cold starts reuse the last good snapshot. Disk writes are
+* atomic via rename-after-write so a crashed process can't leave a torn file.
+*/
 export declare class FileCacheStore implements CacheStore {
-    private readonly baseDir;
-    private readonly memory;
-    private ready;
-    constructor(baseDir?: string);
-    private ensureReady;
-    private filePath;
-    get(key: string): Promise<CachedModelsRecord | undefined>;
-    put(key: string, record: CachedModelsRecord): Promise<void>;
+	private readonly baseDir;
+	private readonly memory;
+	private ready;
+	constructor(baseDir?: string);
+	private ensureReady;
+	private filePath;
+	get(key: string): Promise<CachedModelsRecord | undefined>;
+	put(key: string, record: CachedModelsRecord): Promise<void>;
 }
 export declare function isExpired(record: CachedModelsRecord, now?: number): boolean;

package/dist/cache.js

@@ -3,112 +3,110 @@ import { mkdir, readFile, rename, unlink, writeFile } from "node:fs/promises";
 import { homedir } from "node:os";
 import { join } from "node:path";
 function resolveDefaultCacheRoot() {
-    if (process.platform === "win32") {
-        return process.env.LOCALAPPDATA ?? join(homedir(), "AppData", "Local");
-    }
-    if (process.platform === "darwin") {
-        return join(homedir(), "Library", "Caches");
-    }
-    return process.env.XDG_CACHE_HOME ?? join(homedir(), ".cache");
+	if (process.platform === "win32") {
+		return process.env.LOCALAPPDATA ?? join(homedir(), "AppData", "Local");
+	}
+	if (process.platform === "darwin") {
+		return join(homedir(), "Library", "Caches");
+	}
+	return process.env.XDG_CACHE_HOME ?? join(homedir(), ".cache");
 }
 export function resolveCacheDir(namespace = "opencode-models-info") {
-    return join(resolveDefaultCacheRoot(), namespace);
+	return join(resolveDefaultCacheRoot(), namespace);
 }
 /**
- * Cache key = sha256(providerId :: url :: stableJSON(headers)).
- *
- * Only the **caller-specified** headers (i.e. `meta.modelsInfoHeaders`) go
- * into the key — NOT the provider's other request headers. Rationale: if a
- * rotating bearer (e.g. from `@vymalo/opencode-oauth2`) were keyed in, the
- * cache would thrash on every token refresh. Headers the user explicitly
- * configures for the metadata fetch (tenant selectors, static auth, etc.)
- * are exactly the ones that should bust the cache when they change.
- */
+* Cache key = sha256(providerId :: url :: stableJSON(headers)).
+*
+* Only the **caller-specified** headers (i.e. `meta.modelsInfoHeaders`) go
+* into the key — NOT the provider's other request headers. Rationale: if a
+* rotating bearer (e.g. from `@vymalo/opencode-oauth2`) were keyed in, the
+* cache would thrash on every token refresh. Headers the user explicitly
+* configures for the metadata fetch (tenant selectors, static auth, etc.)
+* are exactly the ones that should bust the cache when they change.
+*/
 export function cacheKey(providerId, url, headers) {
-    const headerPart = headers ? stableStringify(headers) : "";
-    return createHash("sha256").update(`${providerId}::${url}::${headerPart}`).digest("hex");
+	const headerPart = headers ? stableStringify(headers) : "";
+	return createHash("sha256").update(`${providerId}::${url}::${headerPart}`).digest("hex");
 }
 function stableStringify(headers) {
-    const sorted = Object.keys(headers)
-        .sort()
-        .map((k) => [k.toLowerCase(), headers[k]]);
-    return JSON.stringify(sorted);
+	const sorted = Object.keys(headers).sort().map((k) => [k.toLowerCase(), headers[k]]);
+	return JSON.stringify(sorted);
 }
 /**
- * Two-layer cache: an in-memory map for the process lifetime, backed by JSON
- * files on disk so cold starts reuse the last good snapshot. Disk writes are
- * atomic via rename-after-write so a crashed process can't leave a torn file.
- */
+* Two-layer cache: an in-memory map for the process lifetime, backed by JSON
+* files on disk so cold starts reuse the last good snapshot. Disk writes are
+* atomic via rename-after-write so a crashed process can't leave a torn file.
+*/
 export class FileCacheStore {
-    baseDir;
-    memory = new Map();
-    ready;
-    constructor(baseDir = resolveCacheDir()) {
-        this.baseDir = baseDir;
-    }
-    async ensureReady() {
-        if (!this.ready) {
-            this.ready = mkdir(this.baseDir, { recursive: true, mode: 0o700 }).then(() => undefined);
-        }
-        await this.ready;
-    }
-    filePath(key) {
-        return join(this.baseDir, `${key}.json`);
-    }
-    async get(key) {
-        const memHit = this.memory.get(key);
-        if (memHit) {
-            return memHit;
-        }
-        try {
-            await this.ensureReady();
-            const raw = await readFile(this.filePath(key), "utf8");
-            const parsed = JSON.parse(raw);
-            if (!isValidRecord(parsed)) {
-                return undefined;
-            }
-            this.memory.set(key, parsed);
-            return parsed;
-        }
-        catch (error) {
-            if (isFileNotFound(error)) {
-                return undefined;
-            }
-            return undefined;
-        }
-    }
-    async put(key, record) {
-        this.memory.set(key, record);
-        await this.ensureReady();
-        const target = this.filePath(key);
-        // Unique per-write temp name (pid + uuid) so concurrent opencode instances
-        // — or two enrich passes in one process racing the same key — never collide
-        // on the temp file and trip an ENOENT on rename. See opencode-oauth2's
-        // saveServerState for the full rationale.
-        const tmp = `${target}.${process.pid}.${randomUUID()}.tmp`;
-        try {
-            await writeFile(tmp, JSON.stringify(record), { mode: 0o600 });
-            await rename(tmp, target);
-        }
-        catch (error) {
-            await unlink(tmp).catch(() => { });
-            throw error;
-        }
-    }
+	baseDir;
+	memory = new Map();
+	ready;
+	constructor(baseDir = resolveCacheDir()) {
+		this.baseDir = baseDir;
+	}
+	async ensureReady() {
+		if (!this.ready) {
+			this.ready = mkdir(this.baseDir, {
+				recursive: true,
+				mode: 448
+			}).then(() => undefined);
+		}
+		await this.ready;
+	}
+	filePath(key) {
+		return join(this.baseDir, `${key}.json`);
+	}
+	async get(key) {
+		const memHit = this.memory.get(key);
+		if (memHit) {
+			return memHit;
+		}
+		try {
+			await this.ensureReady();
+			const raw = await readFile(this.filePath(key), "utf8");
+			const parsed = JSON.parse(raw);
+			if (!isValidRecord(parsed)) {
+				return undefined;
+			}
+			this.memory.set(key, parsed);
+			return parsed;
+		} catch (error) {
+			if (isFileNotFound(error)) {
+				return undefined;
+			}
+			return undefined;
+		}
+	}
+	async put(key, record) {
+		this.memory.set(key, record);
+		await this.ensureReady();
+		const target = this.filePath(key);
+		// Unique per-write temp name (pid + uuid) so concurrent opencode instances
+		// — or two enrich passes in one process racing the same key — never collide
+		// on the temp file and trip an ENOENT on rename. See opencode-oauth2's
+		// saveServerState for the full rationale.
+		const tmp = `${target}.${process.pid}.${randomUUID()}.tmp`;
+		try {
+			await writeFile(tmp, JSON.stringify(record), { mode: 384 });
+			await rename(tmp, target);
+		} catch (error) {
+			await unlink(tmp).catch(() => {});
+			throw error;
+		}
+	}
 }
 export function isExpired(record, now = Date.now()) {
-    return now - record.fetchedAt > record.ttlSeconds * 1000;
+	return now - record.fetchedAt > record.ttlSeconds * 1e3;
 }
 function isValidRecord(value) {
-    if (!value || typeof value !== "object") {
-        return false;
-    }
-    const record = value;
-    return (typeof record.fetchedAt === "number" &&
-        typeof record.ttlSeconds === "number" &&
-        Array.isArray(record.models));
+	if (!value || typeof value !== "object") {
+		return false;
+	}
+	const record = value;
+	return typeof record.fetchedAt === "number" && typeof record.ttlSeconds === "number" && Array.isArray(record.models);
 }
 function isFileNotFound(error) {
-    return Boolean(error && typeof error === "object" && error.code === "ENOENT");
+	return Boolean(error && typeof error === "object" && error.code === "ENOENT");
 }
+
 //# sourceMappingURL=cache.js.map

package/dist/cache.js.map

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

package/dist/config.d.ts

@@ -1,27 +1,27 @@
 import type { MetaProviderOptions } from "./types.js";
 export declare const DEFAULT_TTL_SECONDS = 86400;
-export declare const DEFAULT_TIMEOUT_MS = 5000;
+export declare const DEFAULT_TIMEOUT_MS = 5e3;
 /**
- * Parse a provider's `options.meta` for opt-in model-info fields. Returns
- * `null` if the provider has not opted in (no `meta.modelsInfoUrl`).
- *
- * URL resolution follows the WHATWG URL spec when `modelsInfoUrl` is not
- * absolute:
- *   - Absolute URL (`https://…`)            → used as-is.
- *   - Path starting with `/`                → resolves from the **origin**
- *                                             of `baseURL`. So with
- *                                             `baseURL: "https://x.test/v1"`
- *                                             and `modelsInfoUrl: "/models"`,
- *                                             you get `https://x.test/models`.
- *                                             Useful when your metadata
- *                                             endpoint sits at a different
- *                                             path than the inference API.
- *   - Path without leading `/`              → resolves **relative to**
- *                                             `baseURL`. So with
- *                                             `baseURL: "https://x.test/v1"`
- *                                             and `modelsInfoUrl: "models"`,
- *                                             you get `https://x.test/v1/models`.
- *                                             Useful when metadata sits under
- *                                             the same path as inference.
- */
+* Parse a provider's `options.meta` for opt-in model-info fields. Returns
+* `null` if the provider has not opted in (no `meta.modelsInfoUrl`).
+*
+* URL resolution follows the WHATWG URL spec when `modelsInfoUrl` is not
+* absolute:
+*   - Absolute URL (`https://…`)            → used as-is.
+*   - Path starting with `/`                → resolves from the **origin**
+*                                             of `baseURL`. So with
+*                                             `baseURL: "https://x.test/v1"`
+*                                             and `modelsInfoUrl: "/models"`,
+*                                             you get `https://x.test/models`.
+*                                             Useful when your metadata
+*                                             endpoint sits at a different
+*                                             path than the inference API.
+*   - Path without leading `/`              → resolves **relative to**
+*                                             `baseURL`. So with
+*                                             `baseURL: "https://x.test/v1"`
+*                                             and `modelsInfoUrl: "models"`,
+*                                             you get `https://x.test/v1/models`.
+*                                             Useful when metadata sits under
+*                                             the same path as inference.
+*/
 export declare function parseMetaOptions(providerOptions: Record<string, unknown> | undefined): MetaProviderOptions | null;

package/dist/config.js

@@ -1,130 +1,131 @@
-export const DEFAULT_TTL_SECONDS = 86_400;
-export const DEFAULT_TIMEOUT_MS = 5_000;
+export const DEFAULT_TTL_SECONDS = 86400;
+export const DEFAULT_TIMEOUT_MS = 5e3;
 const META_KEY = "meta";
 /**
- * Fields a user may opt out of upstream-wins via `meta.modelsInfoOverwrite`.
- * Mirrors the keys of `ModelMetadata` — anything outside this set is ignored
- * so a typo never silently clobbers an unrelated field.
- */
+* Fields a user may opt out of upstream-wins via `meta.modelsInfoOverwrite`.
+* Mirrors the keys of `ModelMetadata` — anything outside this set is ignored
+* so a typo never silently clobbers an unrelated field.
+*/
 const OVERWRITABLE_FIELDS = new Set([
-    "name",
-    "attachment",
-    "reasoning",
-    "temperature",
-    "tool_call",
-    "cost",
-    "limit",
-    "modalities"
+	"name",
+	"attachment",
+	"reasoning",
+	"temperature",
+	"tool_call",
+	"cost",
+	"limit",
+	"modalities"
 ]);
 function asRecord(value) {
-    if (!value || typeof value !== "object" || Array.isArray(value)) {
-        return undefined;
-    }
-    return value;
+	if (!value || typeof value !== "object" || Array.isArray(value)) {
+		return undefined;
+	}
+	return value;
 }
 function asString(value) {
-    return typeof value === "string" && value.trim().length > 0 ? value.trim() : undefined;
+	return typeof value === "string" && value.trim().length > 0 ? value.trim() : undefined;
 }
 function asStringMap(value) {
-    const record = asRecord(value);
-    if (!record) {
-        return undefined;
-    }
-    const out = {};
-    for (const [key, raw] of Object.entries(record)) {
-        if (typeof raw === "string" && raw.length > 0) {
-            out[key] = raw;
-        }
-    }
-    return Object.keys(out).length > 0 ? out : undefined;
+	const record = asRecord(value);
+	if (!record) {
+		return undefined;
+	}
+	const out = {};
+	for (const [key, raw] of Object.entries(record)) {
+		if (typeof raw === "string" && raw.length > 0) {
+			out[key] = raw;
+		}
+	}
+	return Object.keys(out).length > 0 ? out : undefined;
 }
 function asOverwriteList(value) {
-    if (!Array.isArray(value)) {
-        return undefined;
-    }
-    const out = [];
-    for (const raw of value) {
-        if (typeof raw === "string" && OVERWRITABLE_FIELDS.has(raw) && !out.includes(raw)) {
-            out.push(raw);
-        }
-    }
-    return out.length > 0 ? out : undefined;
+	if (!Array.isArray(value)) {
+		return undefined;
+	}
+	const out = [];
+	for (const raw of value) {
+		if (typeof raw === "string" && OVERWRITABLE_FIELDS.has(raw) && !out.includes(raw)) {
+			out.push(raw);
+		}
+	}
+	return out.length > 0 ? out : undefined;
 }
 function asPositiveInt(value, fallback) {
-    if (typeof value === "number" && Number.isFinite(value) && value > 0) {
-        return Math.floor(value);
-    }
-    return fallback;
+	if (typeof value === "number" && Number.isFinite(value) && value > 0) {
+		return Math.floor(value);
+	}
+	return fallback;
 }
 function asBoolean(value) {
-    return value === true;
+	return value === true;
 }
 /**
- * Parse a provider's `options.meta` for opt-in model-info fields. Returns
- * `null` if the provider has not opted in (no `meta.modelsInfoUrl`).
- *
- * URL resolution follows the WHATWG URL spec when `modelsInfoUrl` is not
- * absolute:
- *   - Absolute URL (`https://…`)            → used as-is.
- *   - Path starting with `/`                → resolves from the **origin**
- *                                             of `baseURL`. So with
- *                                             `baseURL: "https://x.test/v1"`
- *                                             and `modelsInfoUrl: "/models"`,
- *                                             you get `https://x.test/models`.
- *                                             Useful when your metadata
- *                                             endpoint sits at a different
- *                                             path than the inference API.
- *   - Path without leading `/`              → resolves **relative to**
- *                                             `baseURL`. So with
- *                                             `baseURL: "https://x.test/v1"`
- *                                             and `modelsInfoUrl: "models"`,
- *                                             you get `https://x.test/v1/models`.
- *                                             Useful when metadata sits under
- *                                             the same path as inference.
- */
+* Parse a provider's `options.meta` for opt-in model-info fields. Returns
+* `null` if the provider has not opted in (no `meta.modelsInfoUrl`).
+*
+* URL resolution follows the WHATWG URL spec when `modelsInfoUrl` is not
+* absolute:
+*   - Absolute URL (`https://…`)            → used as-is.
+*   - Path starting with `/`                → resolves from the **origin**
+*                                             of `baseURL`. So with
+*                                             `baseURL: "https://x.test/v1"`
+*                                             and `modelsInfoUrl: "/models"`,
+*                                             you get `https://x.test/models`.
+*                                             Useful when your metadata
+*                                             endpoint sits at a different
+*                                             path than the inference API.
+*   - Path without leading `/`              → resolves **relative to**
+*                                             `baseURL`. So with
+*                                             `baseURL: "https://x.test/v1"`
+*                                             and `modelsInfoUrl: "models"`,
+*                                             you get `https://x.test/v1/models`.
+*                                             Useful when metadata sits under
+*                                             the same path as inference.
+*/
 export function parseMetaOptions(providerOptions) {
-    if (!providerOptions) {
-        return null;
-    }
-    const meta = asRecord(providerOptions[META_KEY]);
-    if (!meta) {
-        return null;
-    }
-    const rawUrl = asString(meta.modelsInfoUrl);
-    if (!rawUrl) {
-        return null;
-    }
-    const baseURL = asString(providerOptions.baseURL);
-    const modelsInfoUrl = resolveUrl(rawUrl, baseURL);
-    return {
-        modelsInfoUrl,
-        modelsInfoTtlSeconds: asPositiveInt(meta.modelsInfoTtlSeconds, DEFAULT_TTL_SECONDS),
-        modelsInfoTimeoutMs: asPositiveInt(meta.modelsInfoTimeoutMs, DEFAULT_TIMEOUT_MS),
-        modelsInfoHeaders: asStringMap(meta.modelsInfoHeaders),
-        modelsInfoOverwrite: asOverwriteList(meta.modelsInfoOverwrite),
-        modelsInfoHideTextOnly: asBoolean(meta.modelsInfoHideTextOnly),
-        modelsInfoHideInternal: asBoolean(meta.modelsInfoHideInternal),
-        modelsInfoFormat: "openrouter"
-    };
+	if (!providerOptions) {
+		return null;
+	}
+	const meta = asRecord(providerOptions[META_KEY]);
+	if (!meta) {
+		return null;
+	}
+	const rawUrl = asString(meta.modelsInfoUrl);
+	if (!rawUrl) {
+		return null;
+	}
+	const baseURL = asString(providerOptions.baseURL);
+	const modelsInfoUrl = resolveUrl(rawUrl, baseURL);
+	return {
+		modelsInfoUrl,
+		modelsInfoTtlSeconds: asPositiveInt(meta.modelsInfoTtlSeconds, DEFAULT_TTL_SECONDS),
+		modelsInfoTimeoutMs: asPositiveInt(meta.modelsInfoTimeoutMs, DEFAULT_TIMEOUT_MS),
+		modelsInfoHeaders: asStringMap(meta.modelsInfoHeaders),
+		modelsInfoOverwrite: asOverwriteList(meta.modelsInfoOverwrite),
+		modelsInfoHideTextOnly: asBoolean(meta.modelsInfoHideTextOnly),
+		modelsInfoHideInternal: asBoolean(meta.modelsInfoHideInternal),
+		modelsInfoHideUnmatched: asBoolean(meta.modelsInfoHideUnmatched),
+		modelsInfoFormat: "openrouter"
+	};
 }
 function resolveUrl(candidate, baseURL) {
-    if (/^https?:\/\//i.test(candidate)) {
-        return candidate;
-    }
-    if (!baseURL) {
-        return candidate;
-    }
-    // Always treat the baseURL as a directory by appending a trailing slash if
-    // it's missing. This way a path-relative `modelsInfoUrl` ("models/info")
-    // resolves under the baseURL's path instead of replacing its last segment
-    // (the WHATWG default). A leading-slash candidate ("/models/info") still
-    // resolves from the origin per spec.
-    const base = baseURL.endsWith("/") ? baseURL : `${baseURL}/`;
-    try {
-        return new URL(candidate, base).toString();
-    }
-    catch {
-        return candidate;
-    }
+	if (/^https?:\/\//i.test(candidate)) {
+		return candidate;
+	}
+	if (!baseURL) {
+		return candidate;
+	}
+	// Always treat the baseURL as a directory by appending a trailing slash if
+	// it's missing. This way a path-relative `modelsInfoUrl` ("models/info")
+	// resolves under the baseURL's path instead of replacing its last segment
+	// (the WHATWG default). A leading-slash candidate ("/models/info") still
+	// resolves from the origin per spec.
+	const base = baseURL.endsWith("/") ? baseURL : `${baseURL}/`;
+	try {
+		return new URL(candidate, base).toString();
+	} catch {
+		return candidate;
+	}
 }
+
 //# sourceMappingURL=config.js.map