@iam-brain/opencode-codex-auth 1.2.5 → 1.3.0

package/dist/lib/model-catalog/cache-helpers.js

@@ -0,0 +1,210 @@
+import fs from "node:fs/promises";
+import os from "node:os";
+import path from "node:path";
+import { fetchRemoteText } from "../remote-cache-fetch.js";
+import { isFsErrorCode, readJsonFileBestEffort, writeJsonFileBestEffort } from "../cache-io.js";
+import { withLockedDirectory } from "../cache-lock.js";
+import { buildCodexModelsMemoryCacheKey, codexAuthModelsCachePath, codexModelsCompatShardPath, codexModelsMetaPath, codexModelsSharedCachePath, isCodexModelsCacheFileName } from "../codex-cache-layout.js";
+import { CACHE_TTL_MS, compareSemver, FETCH_TIMEOUT_MS, githubModelsTag, githubModelsUrl, isRecord, normalizeSemver, parseCatalogResponse, parseSemver, parseFetchedAtFromUnknown, semverFromTag } from "./shared.js";
+export function cacheKey(cacheDir, accountId) {
+    return buildCodexModelsMemoryCacheKey(cacheDir, accountId);
+}
+export function cachePath(cacheDir, accountId) {
+    return codexAuthModelsCachePath(cacheDir, accountId);
+}
+export function opencodeShardCachePath(cacheDir, accountId) {
+    return codexModelsCompatShardPath(cacheDir, accountId);
+}
+function opencodeSharedCachePath(cacheDir) {
+    return codexModelsSharedCachePath(cacheDir);
+}
+async function readGitHubModelsCacheMeta(cacheDir) {
+    const file = codexModelsMetaPath(cacheDir);
+    const parsed = await readJsonFileBestEffort(file);
+    if (!isRecord(parsed))
+        return undefined;
+    const parsedVersion = normalizeSemver(typeof parsed.version === "string" ? parsed.version : undefined);
+    const parsedTag = typeof parsed.tag === "string" ? parsed.tag.trim() : "";
+    const tag = parsedTag || (parsedVersion ? githubModelsTag(parsedVersion) : "");
+    const url = typeof parsed.url === "string" ? parsed.url.trim() : "";
+    const lastChecked = typeof parsed.lastChecked === "number" && Number.isFinite(parsed.lastChecked) ? parsed.lastChecked : 0;
+    const etag = typeof parsed.etag === "string" ? parsed.etag.trim() : undefined;
+    if (!tag || !url)
+        return undefined;
+    return { etag, tag, url, lastChecked };
+}
+async function writeGitHubModelsCacheMeta(cacheDir, meta) {
+    const file = codexModelsMetaPath(cacheDir);
+    await writeJsonFileBestEffort(file, meta);
+}
+export async function refreshSharedGitHubModelsCache(input) {
+    const targetVersion = normalizeSemver(input.targetClientVersion);
+    if (!targetVersion)
+        return;
+    const existingMeta = await readGitHubModelsCacheMeta(input.cacheDir);
+    const existingVersion = parseSemver(semverFromTag(existingMeta?.tag));
+    const target = parseSemver(targetVersion);
+    if (!target)
+        return;
+    if (existingVersion && compareSemver(existingVersion, target) >= 0)
+        return;
+    const tag = githubModelsTag(targetVersion);
+    const url = githubModelsUrl(targetVersion);
+    const result = await fetchRemoteText({
+        key: "models",
+        url,
+        etag: existingMeta?.url === url ? existingMeta.etag : undefined
+    }, {
+        fetchImpl: input.fetchImpl,
+        timeoutMs: FETCH_TIMEOUT_MS,
+        allowedHosts: ["raw.githubusercontent.com"]
+    });
+    if (result.status === "not_modified" && existingMeta) {
+        await writeGitHubModelsCacheMeta(input.cacheDir, {
+            etag: existingMeta.etag,
+            tag,
+            lastChecked: input.now,
+            url
+        });
+        return;
+    }
+    if (result.status !== "ok") {
+        return;
+    }
+    try {
+        const payload = JSON.parse(result.text);
+        const models = parseCatalogResponse(payload);
+        if (models.length === 0)
+            return;
+        const etag = result.etag || (existingMeta?.url === url ? existingMeta.etag : undefined);
+        const file = opencodeSharedCachePath(input.cacheDir);
+        await writeJsonFileBestEffort(file, { fetchedAt: input.now, source: "github", models });
+        await writeGitHubModelsCacheMeta(input.cacheDir, {
+            etag,
+            tag,
+            lastChecked: input.now,
+            url
+        });
+    }
+    catch (_error) {
+        // Best effort refresh; continue without blocking catalog load.
+    }
+}
+export function isFresh(cache, now) {
+    return now - cache.fetchedAt < CACHE_TTL_MS;
+}
+async function withCacheLock(cacheDir, fn) {
+    return withLockedDirectory(cacheDir, fn, { staleMs: 10_000 });
+}
+export async function readCatalogFromDisk(cacheDir, accountId) {
+    return withCacheLock(cacheDir, async () => {
+        const file = cachePath(cacheDir, accountId);
+        const parsed = await readJsonFileBestEffort(file);
+        if (!isRecord(parsed))
+            return undefined;
+        if (typeof parsed.fetchedAt !== "number")
+            return undefined;
+        const models = parseCatalogResponse({ models: parsed.models });
+        return {
+            fetchedAt: parsed.fetchedAt,
+            models
+        };
+    });
+}
+export async function readCatalogFromOpencodeCache(cacheDir) {
+    try {
+        const entries = await fs.readdir(cacheDir);
+        const candidates = entries.filter((name) => {
+            return isCodexModelsCacheFileName(name);
+        });
+        if (candidates.length === 0)
+            return undefined;
+        let best;
+        for (const fileName of candidates) {
+            const parsed = await readJsonFileBestEffort(path.join(cacheDir, fileName));
+            if (!isRecord(parsed))
+                continue;
+            const models = parseCatalogResponse({ models: parsed.models });
+            if (models.length === 0)
+                continue;
+            const fetchedAt = typeof parsed.fetchedAt === "number" ? parsed.fetchedAt : 0;
+            if (!best || fetchedAt > best.fetchedAt) {
+                best = {
+                    fetchedAt,
+                    models
+                };
+            }
+        }
+        return best;
+    }
+    catch (error) {
+        if (!isFsErrorCode(error, "ENOENT")) {
+            // Best effort fallback discovery.
+        }
+        return undefined;
+    }
+}
+export async function readCatalogFromCodexCliCache() {
+    const file = path.join(os.homedir(), ".codex", "models_cache.json");
+    const parsed = await readJsonFileBestEffort(file);
+    if (!isRecord(parsed))
+        return undefined;
+    const models = parseCatalogResponse({ models: parsed.models });
+    if (models.length === 0)
+        return undefined;
+    return {
+        fetchedAt: parseFetchedAtFromUnknown(parsed.fetched_at ?? parsed.fetchedAt),
+        models
+    };
+}
+export async function writeCatalogToDisk(cacheDir, accountId, cache) {
+    await withCacheLock(cacheDir, async () => {
+        const primaryFile = cachePath(cacheDir, accountId);
+        const compatFile = opencodeShardCachePath(cacheDir, accountId);
+        const files = compatFile ? [primaryFile, compatFile] : [primaryFile];
+        for (const file of files) {
+            await writeJsonFileBestEffort(file, cache);
+        }
+    }).catch((error) => {
+        if (error instanceof Error) {
+            // Best effort cache persistence.
+        }
+        // Best effort cache persistence.
+    });
+}
+export function emitEvent(input, event) {
+    try {
+        input.onEvent?.({
+            ...event,
+            scope: input.accountId?.trim() ? "account" : "shared"
+        });
+    }
+    catch (error) {
+        if (error instanceof Error) {
+            // Keep catalog path side-effect free even if observer callback throws.
+        }
+        // Keep catalog path side-effect free.
+    }
+}
+export function deriveReason(value) {
+    if (value instanceof Error) {
+        return value.name || "error";
+    }
+    return "error";
+}
+export function emitStaleCacheFallback(input, fallback) {
+    if (fallback.disk) {
+        emitEvent(input, { type: "stale_cache_used", reason: "network_fetch_failed" });
+        return fallback.disk.models;
+    }
+    if (fallback.opencode) {
+        emitEvent(input, { type: "stale_cache_used", reason: "opencode_cache_fallback" });
+        return fallback.opencode.models;
+    }
+    if (fallback.codexCli) {
+        emitEvent(input, { type: "stale_cache_used", reason: "codex_cli_cache_fallback" });
+        return fallback.codexCli.models;
+    }
+    return undefined;
+}
+//# sourceMappingURL=cache-helpers.js.map

package/dist/lib/model-catalog/cache-helpers.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"cache-helpers.js","sourceRoot":"","sources":["../../../lib/model-catalog/cache-helpers.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,MAAM,kBAAkB,CAAA;AACjC,OAAO,EAAE,MAAM,SAAS,CAAA;AACxB,OAAO,IAAI,MAAM,WAAW,CAAA;AAC5B,OAAO,EAAE,eAAe,EAAE,MAAM,0BAA0B,CAAA;AAC1D,OAAO,EAAE,aAAa,EAAE,sBAAsB,EAAE,uBAAuB,EAAE,MAAM,gBAAgB,CAAA;AAC/F,OAAO,EAAE,mBAAmB,EAAE,MAAM,kBAAkB,CAAA;AACtD,OAAO,EACL,8BAA8B,EAC9B,wBAAwB,EACxB,0BAA0B,EAC1B,mBAAmB,EACnB,0BAA0B,EAC1B,0BAA0B,EAC3B,MAAM,0BAA0B,CAAA;AACjC,OAAO,EACL,YAAY,EACZ,aAAa,EAKb,gBAAgB,EAChB,eAAe,EACf,eAAe,EAEf,QAAQ,EACR,eAAe,EACf,oBAAoB,EACpB,WAAW,EACX,yBAAyB,EACzB,aAAa,EACd,MAAM,aAAa,CAAA;AAEpB,MAAM,UAAU,QAAQ,CAAC,QAAgB,EAAE,SAAkB;IAC3D,OAAO,8BAA8B,CAAC,QAAQ,EAAE,SAAS,CAAC,CAAA;AAC5D,CAAC;AAED,MAAM,UAAU,SAAS,CAAC,QAAgB,EAAE,SAAkB;IAC5D,OAAO,wBAAwB,CAAC,QAAQ,EAAE,SAAS,CAAC,CAAA;AACtD,CAAC;AAED,MAAM,UAAU,sBAAsB,CAAC,QAAgB,EAAE,SAAkB;IACzE,OAAO,0BAA0B,CAAC,QAAQ,EAAE,SAAS,CAAC,CAAA;AACxD,CAAC;AAED,SAAS,uBAAuB,CAAC,QAAgB;IAC/C,OAAO,0BAA0B,CAAC,QAAQ,CAAC,CAAA;AAC7C,CAAC;AAED,KAAK,UAAU,yBAAyB,CAAC,QAAgB;IACvD,MAAM,IAAI,GAAG,mBAAmB,CAAC,QAAQ,CAAC,CAAA;IAC1C,MAAM,MAAM,GAAG,MAAM,sBAAsB,CAAC,IAAI,CAAC,CAAA;IACjD,IAAI,CAAC,QAAQ,CAAC,MAAM,CAAC;QAAE,OAAO,SAAS,CAAA;IACvC,MAAM,aAAa,GAAG,eAAe,CAAC,OAAO,MAAM,CAAC,OAAO,KAAK,QAAQ,CAAC,CAAC,CAAC,MAAM,CAAC,OAAO,CAAC,CAAC,CAAC,SAAS,CAAC,CAAA;IACtG,MAAM,SAAS,GAAG,OAAO,MAAM,CAAC,GAAG,KAAK,QAAQ,CAAC,CAAC,CAAC,MAAM,CAAC,GAAG,CAAC,IAAI,EAAE,CAAC,CAAC,CAAC,EAAE,CAAA;IACzE,MAAM,GAAG,GAAG,SAAS,IAAI,CAAC,aAAa,CAAC,CAAC,CAAC,eAAe,CAAC,aAAa,CAAC,CAAC,CAAC,CAAC,EAAE,CAAC,CAAA;IAC9E,MAAM,GAAG,GAAG,OAAO,MAAM,CAAC,GAAG,KAAK,QAAQ,CAAC,CAAC,CAAC,MAAM,CAAC,GAAG,CAAC,IAAI,EAAE,CAAC,CAAC,CAAC,EAAE,CAAA;IACnE,MAAM,WAAW,GACf,OAAO,MAAM,CAAC,WAAW,KAAK,QAAQ,IAAI,MAAM,CAAC,QAAQ,CAAC,MAAM,CAAC,WAAW,CAAC,CAAC,CAAC,CAAC,MAAM,CAAC,WAAW,CAAC,CAAC,CAAC,CAAC,CAAA;IACxG,MAAM,IAAI,GAAG,OAAO,MAAM,CAAC,IAAI,KAAK,QAAQ,CAAC,CAAC,CAAC,MAAM,CAAC,IAAI,CAAC,IAAI,EAAE,CAAC,CAAC,CAAC,SAAS,CAAA;IAC7E,IAAI,CAAC,GAAG,IAAI,CAAC,GAAG;QAAE,OAAO,SAAS,CAAA;IAClC,OAAO,EAAE,IAAI,EAAE,GAAG,EAAE,GAAG,EAAE,WAAW,EAAE,CAAA;AACxC,CAAC;AAED,KAAK,UAAU,0BAA0B,CAAC,QAAgB,EAAE,IAA2B;IACrF,MAAM,IAAI,GAAG,mBAAmB,CAAC,QAAQ,CAAC,CAAA;IAC1C,MAAM,uBAAuB,CAAC,IAAI,EAAE,IAAI,CAAC,CAAA;AAC3C,CAAC;AAED,MAAM,CAAC,KAAK,UAAU,8BAA8B,CAAC,KAKpD;IACC,MAAM,aAAa,GAAG,eAAe,CAAC,KAAK,CAAC,mBAAmB,CAAC,CAAA;IAChE,IAAI,CAAC,aAAa;QAAE,OAAM;IAE1B,MAAM,YAAY,GAAG,MAAM,yBAAyB,CAAC,KAAK,CAAC,QAAQ,CAAC,CAAA;IACpE,MAAM,eAAe,GAAG,WAAW,CAAC,aAAa,CAAC,YAAY,EAAE,GAAG,CAAC,CAAC,CAAA;IACrE,MAAM,MAAM,GAAG,WAAW,CAAC,aAAa,CAAC,CAAA;IACzC,IAAI,CAAC,MAAM;QAAE,OAAM;IACnB,IAAI,eAAe,IAAI,aAAa,CAAC,eAAe,EAAE,MAAM,CAAC,IAAI,CAAC;QAAE,OAAM;IAE1E,MAAM,GAAG,GAAG,eAAe,CAAC,aAAa,CAAC,CAAA;IAC1C,MAAM,GAAG,GAAG,eAAe,CAAC,aAAa,CAAC,CAAA;IAC1C,MAAM,MAAM,GAAG,MAAM,eAAe,CAClC;QACE,GAAG,EAAE,QAAQ;QACb,GAAG;QACH,IAAI,EAAE,YAAY,EAAE,GAAG,KAAK,GAAG,CAAC,CAAC,CAAC,YAAY,CAAC,IAAI,CAAC,CAAC,CAAC,SAAS;KAChE,EACD;QACE,SAAS,EAAE,KAAK,CAAC,SAAS;QAC1B,SAAS,EAAE,gBAAgB;QAC3B,YAAY,EAAE,CAAC,2BAA2B,CAAC;KAC5C,CACF,CAAA;IAED,IAAI,MAAM,CAAC,MAAM,KAAK,cAAc,IAAI,YAAY,EAAE,CAAC;QACrD,MAAM,0BAA0B,CAAC,KAAK,CAAC,QAAQ,EAAE;YAC/C,IAAI,EAAE,YAAY,CAAC,IAAI;YACvB,GAAG;YACH,WAAW,EAAE,KAAK,CAAC,GAAG;YACtB,GAAG;SACJ,CAAC,CAAA;QACF,OAAM;IACR,CAAC;IAED,IAAI,MAAM,CAAC,MAAM,KAAK,IAAI,EAAE,CAAC;QAC3B,OAAM;IACR,CAAC;IAED,IAAI,CAAC;QACH,MAAM,OAAO,GAAG,IAAI,CAAC,KAAK,CAAC,MAAM,CAAC,IAAI,CAAY,CAAA;QAClD,MAAM,MAAM,GAAG,oBAAoB,CAAC,OAAO,CAAC,CAAA;QAC5C,IAAI,MAAM,CAAC,MAAM,KAAK,CAAC;YAAE,OAAM;QAC/B,MAAM,IAAI,GAAG,MAAM,CAAC,IAAI,IAAI,CAAC,YAAY,EAAE,GAAG,KAAK,GAAG,CAAC,CAAC,CAAC,YAAY,CAAC,IAAI,CAAC,CAAC,CAAC,SAAS,CAAC,CAAA;QAEvF,MAAM,IAAI,GAAG,uBAAuB,CAAC,KAAK,CAAC,QAAQ,CAAC,CAAA;QACpD,MAAM,uBAAuB,CAAC,IAAI,EAAE,EAAE,SAAS,EAAE,KAAK,CAAC,GAAG,EAAE,MAAM,EAAE,QAAQ,EAAE,MAAM,EAAE,CAAC,CAAA;QAEvF,MAAM,0BAA0B,CAAC,KAAK,CAAC,QAAQ,EAAE;YAC/C,IAAI;YACJ,GAAG;YACH,WAAW,EAAE,KAAK,CAAC,GAAG;YACtB,GAAG;SACJ,CAAC,CAAA;IACJ,CAAC;IAAC,OAAO,MAAM,EAAE,CAAC;QAChB,+DAA+D;IACjE,CAAC;AACH,CAAC;AAED,MAAM,UAAU,OAAO,CAAC,KAAuB,EAAE,GAAW;IAC1D,OAAO,GAAG,GAAG,KAAK,CAAC,SAAS,GAAG,YAAY,CAAA;AAC7C,CAAC;AAED,KAAK,UAAU,aAAa,CAAI,QAAgB,EAAE,EAAoB;IACpE,OAAO,mBAAmB,CAAC,QAAQ,EAAE,EAAE,EAAE,EAAE,OAAO,EAAE,MAAM,EAAE,CAAC,CAAA;AAC/D,CAAC;AAED,MAAM,CAAC,KAAK,UAAU,mBAAmB,CAAC,QAAgB,EAAE,SAAkB;IAC5E,OAAO,aAAa,CAAC,QAAQ,EAAE,KAAK,IAAI,EAAE;QACxC,MAAM,IAAI,GAAG,SAAS,CAAC,QAAQ,EAAE,SAAS,CAAC,CAAA;QAC3C,MAAM,MAAM,GAAG,MAAM,sBAAsB,CAAC,IAAI,CAAC,CAAA;QACjD,IAAI,CAAC,QAAQ,CAAC,MAAM,CAAC;YAAE,OAAO,SAAS,CAAA;QACvC,IAAI,OAAO,MAAM,CAAC,SAAS,KAAK,QAAQ;YAAE,OAAO,SAAS,CAAA;QAC1D,MAAM,MAAM,GAAG,oBAAoB,CAAC,EAAE,MAAM,EAAE,MAAM,CAAC,MAAM,EAAE,CAAC,CAAA;QAC9D,OAAO;YACL,SAAS,EAAE,MAAM,CAAC,SAAS;YAC3B,MAAM;SACP,CAAA;IACH,CAAC,CAAC,CAAA;AACJ,CAAC;AAED,MAAM,CAAC,KAAK,UAAU,4BAA4B,CAAC,QAAgB;IACjE,IAAI,CAAC;QACH,MAAM,OAAO,GAAG,MAAM,EAAE,CAAC,OAAO,CAAC,QAAQ,CAAC,CAAA;QAC1C,MAAM,UAAU,GAAG,OAAO,CAAC,MAAM,CAAC,CAAC,IAAI,EAAE,EAAE;YACzC,OAAO,0BAA0B,CAAC,IAAI,CAAC,CAAA;QACzC,CAAC,CAAC,CAAA;QACF,IAAI,UAAU,CAAC,MAAM,KAAK,CAAC;YAAE,OAAO,SAAS,CAAA;QAE7C,IAAI,IAAkC,CAAA;QACtC,KAAK,MAAM,QAAQ,IAAI,UAAU,EAAE,CAAC;YAClC,MAAM,MAAM,GAAG,MAAM,sBAAsB,CAAC,IAAI,CAAC,IAAI,CAAC,QAAQ,EAAE,QAAQ,CAAC,CAAC,CAAA;YAC1E,IAAI,CAAC,QAAQ,CAAC,MAAM,CAAC;gBAAE,SAAQ;YAC/B,MAAM,MAAM,GAAG,oBAAoB,CAAC,EAAE,MAAM,EAAE,MAAM,CAAC,MAAM,EAAE,CAAC,CAAA;YAC9D,IAAI,MAAM,CAAC,MAAM,KAAK,CAAC;gBAAE,SAAQ;YACjC,MAAM,SAAS,GAAG,OAAO,MAAM,CAAC,SAAS,KAAK,QAAQ,CAAC,CAAC,CAAC,MAAM,CAAC,SAAS,CAAC,CAAC,CAAC,CAAC,CAAA;YAC7E,IAAI,CAAC,IAAI,IAAI,SAAS,GAAG,IAAI,CAAC,SAAS,EAAE,CAAC;gBACxC,IAAI,GAAG;oBACL,SAAS;oBACT,MAAM;iBACP,CAAA;YACH,CAAC;QACH,CAAC;QAED,OAAO,IAAI,CAAA;IACb,CAAC;IAAC,OAAO,KAAK,EAAE,CAAC;QACf,IAAI,CAAC,aAAa,CAAC,KAAK,EAAE,QAAQ,CAAC,EAAE,CAAC;YACpC,kCAAkC;QACpC,CAAC;QACD,OAAO,SAAS,CAAA;IAClB,CAAC;AACH,CAAC;AAED,MAAM,CAAC,KAAK,UAAU,4BAA4B;IAChD,MAAM,IAAI,GAAG,IAAI,CAAC,IAAI,CAAC,EAAE,CAAC,OAAO,EAAE,EAAE,QAAQ,EAAE,mBAAmB,CAAC,CAAA;IACnE,MAAM,MAAM,GAAG,MAAM,sBAAsB,CAAC,IAAI,CAAC,CAAA;IACjD,IAAI,CAAC,QAAQ,CAAC,MAAM,CAAC;QAAE,OAAO,SAAS,CAAA;IACvC,MAAM,MAAM,GAAG,oBAAoB,CAAC,EAAE,MAAM,EAAE,MAAM,CAAC,MAAM,EAAE,CAAC,CAAA;IAC9D,IAAI,MAAM,CAAC,MAAM,KAAK,CAAC;QAAE,OAAO,SAAS,CAAA;IACzC,OAAO;QACL,SAAS,EAAE,yBAAyB,CAAC,MAAM,CAAC,UAAU,IAAI,MAAM,CAAC,SAAS,CAAC;QAC3E,MAAM;KACP,CAAA;AACH,CAAC;AAED,MAAM,CAAC,KAAK,UAAU,kBAAkB,CACtC,QAAgB,EAChB,SAA6B,EAC7B,KAAuB;IAEvB,MAAM,aAAa,CAAC,QAAQ,EAAE,KAAK,IAAI,EAAE;QACvC,MAAM,WAAW,GAAG,SAAS,CAAC,QAAQ,EAAE,SAAS,CAAC,CAAA;QAClD,MAAM,UAAU,GAAG,sBAAsB,CAAC,QAAQ,EAAE,SAAS,CAAC,CAAA;QAC9D,MAAM,KAAK,GAAG,UAAU,CAAC,CAAC,CAAC,CAAC,WAAW,EAAE,UAAU,CAAC,CAAC,CAAC,CAAC,CAAC,WAAW,CAAC,CAAA;QACpE,KAAK,MAAM,IAAI,IAAI,KAAK,EAAE,CAAC;YACzB,MAAM,uBAAuB,CAAC,IAAI,EAAE,KAAK,CAAC,CAAA;QAC5C,CAAC;IACH,CAAC,CAAC,CAAC,KAAK,CAAC,CAAC,KAAK,EAAE,EAAE;QACjB,IAAI,KAAK,YAAY,KAAK,EAAE,CAAC;YAC3B,iCAAiC;QACnC,CAAC;QACD,iCAAiC;IACnC,CAAC,CAAC,CAAA;AACJ,CAAC;AAED,MAAM,UAAU,SAAS,CAAC,KAAgC,EAAE,KAA4C;IACtG,IAAI,CAAC;QACH,KAAK,CAAC,OAAO,EAAE,CAAC;YACd,GAAG,KAAK;YACR,KAAK,EAAE,KAAK,CAAC,SAAS,EAAE,IAAI,EAAE,CAAC,CAAC,CAAC,SAAS,CAAC,CAAC,CAAC,QAAQ;SACtD,CAAC,CAAA;IACJ,CAAC;IAAC,OAAO,KAAK,EAAE,CAAC;QACf,IAAI,KAAK,YAAY,KAAK,EAAE,CAAC;YAC3B,uEAAuE;QACzE,CAAC;QACD,sCAAsC;IACxC,CAAC;AACH,CAAC;AAED,MAAM,UAAU,YAAY,CAAC,KAAc;IACzC,IAAI,KAAK,YAAY,KAAK,EAAE,CAAC;QAC3B,OAAO,KAAK,CAAC,IAAI,IAAI,OAAO,CAAA;IAC9B,CAAC;IACD,OAAO,OAAO,CAAA;AAChB,CAAC;AAED,MAAM,UAAU,sBAAsB,CACpC,KAAgC,EAChC,QAIC;IAED,IAAI,QAAQ,CAAC,IAAI,EAAE,CAAC;QAClB,SAAS,CAAC,KAAK,EAAE,EAAE,IAAI,EAAE,kBAAkB,EAAE,MAAM,EAAE,sBAAsB,EAAE,CAAC,CAAA;QAC9E,OAAO,QAAQ,CAAC,IAAI,CAAC,MAAM,CAAA;IAC7B,CAAC;IACD,IAAI,QAAQ,CAAC,QAAQ,EAAE,CAAC;QACtB,SAAS,CAAC,KAAK,EAAE,EAAE,IAAI,EAAE,kBAAkB,EAAE,MAAM,EAAE,yBAAyB,EAAE,CAAC,CAAA;QACjF,OAAO,QAAQ,CAAC,QAAQ,CAAC,MAAM,CAAA;IACjC,CAAC;IACD,IAAI,QAAQ,CAAC,QAAQ,EAAE,CAAC;QACtB,SAAS,CAAC,KAAK,EAAE,EAAE,IAAI,EAAE,kBAAkB,EAAE,MAAM,EAAE,0BAA0B,EAAE,CAAC,CAAA;QAClF,OAAO,QAAQ,CAAC,QAAQ,CAAC,MAAM,CAAA;IACjC,CAAC;IACD,OAAO,SAAS,CAAA;AAClB,CAAC"}

package/dist/lib/model-catalog/catalog-fetch.d.ts

@@ -0,0 +1,3 @@
+import { type CodexModelInfo, type GetCodexModelCatalogInput } from "./shared.js";
+export declare function getCodexModelCatalog(input: GetCodexModelCatalogInput): Promise<CodexModelInfo[] | undefined>;
+//# sourceMappingURL=catalog-fetch.d.ts.map

package/dist/lib/model-catalog/catalog-fetch.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"catalog-fetch.d.ts","sourceRoot":"","sources":["../../../lib/model-catalog/catalog-fetch.ts"],"names":[],"mappings":"AAYA,OAAO,EACL,KAAK,cAAc,EAInB,KAAK,yBAAyB,EAG/B,MAAM,aAAa,CAAA;AAkBpB,wBAAsB,oBAAoB,CAAC,KAAK,EAAE,yBAAyB,GAAG,OAAO,CAAC,cAAc,EAAE,GAAG,SAAS,CAAC,CAqJlH"}

package/dist/lib/model-catalog/catalog-fetch.js

@@ -0,0 +1,159 @@
+import { cacheKey, deriveReason, emitEvent, emitStaleCacheFallback, isFresh, readCatalogFromCodexCliCache, readCatalogFromDisk, readCatalogFromOpencodeCache, refreshSharedGitHubModelsCache, writeCatalogToDisk } from "./cache-helpers.js";
+import { CODEX_MODELS_ENDPOINT, DEFAULT_CLIENT_VERSION, FETCH_TIMEOUT_MS, parseCatalogResponse, normalizeSemver } from "./shared.js";
+import { resolveCodexCacheDir } from "../codex-cache-layout.js";
+const inMemoryCatalog = new Map();
+const inFlightCatalogFetches = new Map();
+function normalizeClientVersion(value, fallback) {
+    const trimmed = value?.trim();
+    if (trimmed)
+        return trimmed;
+    const fallbackTrimmed = fallback?.trim();
+    return fallbackTrimmed || DEFAULT_CLIENT_VERSION;
+}
+function buildModelsEndpoint(clientVersion) {
+    const separator = CODEX_MODELS_ENDPOINT.includes("?") ? "&" : "?";
+    return `${CODEX_MODELS_ENDPOINT}${separator}client_version=${encodeURIComponent(clientVersion)}`;
+}
+export async function getCodexModelCatalog(input) {
+    const now = (input.now ?? Date.now)();
+    const cacheDir = resolveCodexCacheDir(input.cacheDir);
+    const key = cacheKey(cacheDir, input.accountId);
+    const fetchImpl = input.fetchImpl ?? fetch;
+    const accessToken = input.accessToken?.trim();
+    const targetClientVersion = normalizeSemver(input.clientVersion) ?? normalizeSemver(input.versionHeader);
+    const defaultGithubModelsRefresh = Boolean(accessToken) && input.fetchImpl === undefined && targetClientVersion !== undefined;
+    const shouldRefreshGithubModelsCache = input.refreshGithubModelsCache ?? defaultGithubModelsRefresh;
+    if (shouldRefreshGithubModelsCache) {
+        await refreshSharedGitHubModelsCache({
+            cacheDir,
+            targetClientVersion,
+            now,
+            fetchImpl
+        });
+    }
+    const memory = inMemoryCatalog.get(key);
+    const allowMemoryHit = !memory?.staleFallback || !accessToken;
+    if (memory && !input.forceRefresh && isFresh(memory, now) && allowMemoryHit) {
+        emitEvent(input, { type: "memory_cache_hit" });
+        return memory.models;
+    }
+    const disk = await readCatalogFromDisk(cacheDir, input.accountId);
+    const hasFreshDisk = !!disk && isFresh(disk, now);
+    if (hasFreshDisk && !input.forceRefresh) {
+        inMemoryCatalog.set(key, disk);
+        emitEvent(input, { type: "disk_cache_hit" });
+        return disk.models;
+    }
+    let opencodeCacheFallback;
+    let codexCliCacheFallback;
+    const ensureFallbackCaches = async () => {
+        if (opencodeCacheFallback !== undefined || codexCliCacheFallback !== undefined)
+            return;
+        opencodeCacheFallback = await readCatalogFromOpencodeCache(cacheDir);
+        codexCliCacheFallback = await readCatalogFromCodexCliCache();
+    };
+    if (!accessToken) {
+        await ensureFallbackCaches();
+        if (disk) {
+            emitEvent(input, { type: "stale_cache_used", reason: "missing_access_token" });
+            inMemoryCatalog.set(key, disk);
+            return disk.models;
+        }
+        const stale = emitStaleCacheFallback(input, {
+            opencode: opencodeCacheFallback,
+            codexCli: codexCliCacheFallback
+        });
+        if (stale) {
+            inMemoryCatalog.set(key, {
+                fetchedAt: now,
+                models: stale,
+                staleFallback: true
+            });
+            return stale;
+        }
+        emitEvent(input, { type: "catalog_unavailable", reason: "missing_access_token" });
+        return undefined;
+    }
+    const headers = {
+        authorization: `Bearer ${accessToken}`,
+        originator: input.originator?.trim() || "opencode"
+    };
+    const clientVersion = normalizeClientVersion(input.clientVersion, input.versionHeader);
+    const versionHeader = normalizeClientVersion(input.versionHeader, input.clientVersion);
+    if (versionHeader)
+        headers.version = versionHeader;
+    const userAgent = input.userAgent?.trim();
+    if (userAgent)
+        headers["user-agent"] = userAgent;
+    const betaValue = input.openaiBeta?.trim();
+    if (betaValue)
+        headers["openai-beta"] = betaValue;
+    const accountId = input.accountId?.trim() || undefined;
+    if (accountId) {
+        headers["chatgpt-account-id"] = accountId;
+    }
+    const existingInFlight = inFlightCatalogFetches.get(key);
+    if (existingInFlight) {
+        return existingInFlight;
+    }
+    const inFlight = (async () => {
+        try {
+            const controller = new AbortController();
+            const timeout = setTimeout(() => controller.abort(), FETCH_TIMEOUT_MS);
+            let response;
+            try {
+                const endpoint = buildModelsEndpoint(clientVersion);
+                response = await fetchImpl(endpoint, {
+                    method: "GET",
+                    headers,
+                    signal: controller.signal
+                });
+            }
+            finally {
+                clearTimeout(timeout);
+            }
+            if (!response.ok) {
+                throw new Error(`codex models request failed with status ${response.status}`);
+            }
+            const payload = await response.json();
+            const models = parseCatalogResponse(payload);
+            if (models.length === 0) {
+                throw new Error("codex models response did not contain usable models");
+            }
+            const nextCache = {
+                fetchedAt: now,
+                models
+            };
+            inMemoryCatalog.set(key, nextCache);
+            await writeCatalogToDisk(cacheDir, accountId, nextCache);
+            emitEvent(input, { type: "network_fetch_success" });
+            return nextCache.models;
+        }
+        catch (error) {
+            emitEvent(input, { type: "network_fetch_failed", reason: deriveReason(error) });
+            await ensureFallbackCaches();
+            const stale = emitStaleCacheFallback(input, {
+                disk,
+                opencode: opencodeCacheFallback,
+                codexCli: codexCliCacheFallback
+            });
+            if (stale) {
+                inMemoryCatalog.set(key, {
+                    fetchedAt: now,
+                    models: stale,
+                    staleFallback: true
+                });
+                return stale;
+            }
+            emitEvent(input, { type: "catalog_unavailable", reason: "network_fetch_failed" });
+            return undefined;
+        }
+    })();
+    inFlightCatalogFetches.set(key, inFlight);
+    return inFlight.finally(() => {
+        if (inFlightCatalogFetches.get(key) === inFlight) {
+            inFlightCatalogFetches.delete(key);
+        }
+    });
+}
+//# sourceMappingURL=catalog-fetch.js.map

package/dist/lib/model-catalog/catalog-fetch.js.map

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

package/dist/lib/model-catalog/provider.d.ts

@@ -0,0 +1,6 @@
+import { type ApplyCodexCatalogInput, type CodexModelInfo, type CodexModelRuntimeDefaults, type PersonalityOption } from "./shared.js";
+export declare function resolveInstructionsForModel(model: CodexModelInfo, personality?: PersonalityOption): string | undefined;
+export declare function getRuntimeDefaultsForModel(model: CodexModelInfo | undefined): CodexModelRuntimeDefaults | undefined;
+export declare function getRuntimeDefaultsForSlug(slug: string, catalogModels: CodexModelInfo[] | undefined): CodexModelRuntimeDefaults | undefined;
+export declare function applyCodexCatalogToProviderModels(input: ApplyCodexCatalogInput): void;
+//# sourceMappingURL=provider.d.ts.map

package/dist/lib/model-catalog/provider.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"provider.d.ts","sourceRoot":"","sources":["../../../lib/model-catalog/provider.ts"],"names":[],"mappings":"AACA,OAAO,EACL,KAAK,sBAAsB,EAC3B,KAAK,cAAc,EACnB,KAAK,yBAAyB,EAK9B,KAAK,iBAAiB,EACvB,MAAM,aAAa,CAAA;AAqGpB,wBAAgB,2BAA2B,CACzC,KAAK,EAAE,cAAc,EACrB,WAAW,CAAC,EAAE,iBAAiB,GAC9B,MAAM,GAAG,SAAS,CAiBpB;AA4CD,wBAAgB,0BAA0B,CAAC,KAAK,EAAE,cAAc,GAAG,SAAS,GAAG,yBAAyB,GAAG,SAAS,CA6CnH;AAED,wBAAgB,yBAAyB,CACvC,IAAI,EAAE,MAAM,EACZ,aAAa,EAAE,cAAc,EAAE,GAAG,SAAS,GAC1C,yBAAyB,GAAG,SAAS,CAGvC;AAED,wBAAgB,iCAAiC,CAAC,KAAK,EAAE,sBAAsB,GAAG,IAAI,CAqErF"}

package/dist/lib/model-catalog/provider.js

@@ -0,0 +1,254 @@
+import { resolveCustomPersonalityDescription } from "../personalities.js";
+import { compareModelSlugs, EFFORT_SUFFIX_REGEX, normalizeReasoningEffort, normalizeVerbosity } from "./shared.js";
+const UNRESOLVED_TEMPLATE_MARKER_REGEX = /\{\{\s*[^}]+\s*\}\}/;
+const STALE_BRIDGE_MARKERS = [
+    /multi_tool_use\.parallel/i,
+    /assistant\s+to=multi_tool_use\.parallel/i,
+    /functions\.(read|exec_command|write_stdin|apply_patch|edit|grep|glob|list)\b/i,
+    /recipient_name\s*[:=]/i
+];
+function cloneModelTemplate(template, slug) {
+    const cloned = { ...template };
+    setModelIdentityFields(cloned, slug);
+    return cloned;
+}
+function formatModelDisplayNameFromSlug(slug) {
+    const tokens = slug
+        .trim()
+        .split("-")
+        .map((part) => part.trim())
+        .filter((part) => part.length > 0);
+    if (tokens.length === 0)
+        return slug;
+    const words = tokens.map((token) => {
+        if (token.toLowerCase() === "gpt")
+            return "GPT";
+        if (token.length === 1)
+            return token.toUpperCase();
+        return `${token.charAt(0).toUpperCase()}${token.slice(1).toLowerCase()}`;
+    });
+    if (words[0] === "GPT" && words.length > 1) {
+        return [`${words[0]}-${words[1]}`, ...words.slice(2)].join(" ");
+    }
+    return words.join(" ");
+}
+function setModelIdentityFields(model, slug) {
+    const display = formatModelDisplayNameFromSlug(slug);
+    for (const key of ["id", "slug", "model"]) {
+        model[key] = slug;
+    }
+    for (const key of ["name", "displayName", "display_name"]) {
+        model[key] = display;
+    }
+}
+function resolvePersonalityText(model, personality) {
+    const vars = model.model_messages?.instructions_variables;
+    const normalized = (personality ?? "none").trim().toLowerCase();
+    if (!normalized)
+        return undefined;
+    if (normalized !== "none") {
+        const fromFile = resolveCustomPersonalityDescription(normalized);
+        if (typeof fromFile === "string" && fromFile.trim()) {
+            return fromFile;
+        }
+    }
+    if (!vars)
+        return undefined;
+    if (vars.personalities && typeof vars.personalities === "object") {
+        const fromMap = vars.personalities[normalized] ?? vars.personalities.default;
+        if (typeof fromMap === "string" && fromMap.trim()) {
+            return fromMap;
+        }
+    }
+    if (normalized === "friendly" && typeof vars.personality_friendly === "string" && vars.personality_friendly.trim()) {
+        return vars.personality_friendly;
+    }
+    if (normalized === "pragmatic" &&
+        typeof vars.personality_pragmatic === "string" &&
+        vars.personality_pragmatic.trim()) {
+        return vars.personality_pragmatic;
+    }
+    if (typeof vars.personality_default === "string" && vars.personality_default.trim()) {
+        return vars.personality_default;
+    }
+    if (typeof vars.personality === "string" && vars.personality.trim()) {
+        return vars.personality;
+    }
+    return undefined;
+}
+function isCompatibleInstructionsText(value) {
+    if (UNRESOLVED_TEMPLATE_MARKER_REGEX.test(value))
+        return false;
+    return !STALE_BRIDGE_MARKERS.some((pattern) => pattern.test(value));
+}
+function normalizeSafeInstructions(value) {
+    if (!value)
+        return undefined;
+    const trimmed = value.trim();
+    if (!trimmed)
+        return undefined;
+    return isCompatibleInstructionsText(trimmed) ? trimmed : undefined;
+}
+export function resolveInstructionsForModel(model, personality) {
+    const template = model.model_messages?.instructions_template?.trim();
+    const base = model.base_instructions?.trim();
+    const safeBase = normalizeSafeInstructions(base);
+    if (!template)
+        return safeBase;
+    if (!template.includes("{{") && !template.includes("}}")) {
+        return normalizeSafeInstructions(template) ?? safeBase;
+    }
+    const personalityText = resolvePersonalityText(model, personality) ?? "";
+    const rendered = template
+        .replace(/\{\{\s*personality\s*\}\}/gi, personalityText)
+        .replace(/\n{3,}/g, "\n\n")
+        .trim();
+    return normalizeSafeInstructions(rendered) ?? safeBase;
+}
+function resolveAllowedSlugs(catalogModels, fallback) {
+    const preferred = (catalogModels ?? []).map((model) => model.slug).filter((slug) => slug.length > 0);
+    if (preferred.length > 0) {
+        return Array.from(new Set(preferred)).sort(compareModelSlugs);
+    }
+    return Array.from(new Set(fallback.map((slug) => slug.trim().toLowerCase()).filter(Boolean))).sort(compareModelSlugs);
+}
+function resolveTemplateSource(providerModels) {
+    for (const candidate of ["gpt-5.3-codex", "gpt-5.2-codex", "gpt-5.1-codex", "gpt-5.2"]) {
+        const found = providerModels[candidate];
+        if (found)
+            return found;
+    }
+    const first = Object.values(providerModels)[0];
+    return first;
+}
+function stripEffortSuffix(slug) {
+    return slug.replace(EFFORT_SUFFIX_REGEX, "");
+}
+function ensureModelOptions(model) {
+    const existing = model.options;
+    if (typeof existing === "object" && existing !== null && !Array.isArray(existing)) {
+        return existing;
+    }
+    const options = {};
+    model.options = options;
+    return options;
+}
+function findModelBySlug(catalogModels, slug) {
+    if (!catalogModels || catalogModels.length === 0)
+        return undefined;
+    const normalized = slug.trim().toLowerCase();
+    const exact = catalogModels.find((item) => item.slug === normalized);
+    if (exact)
+        return exact;
+    const base = stripEffortSuffix(normalized);
+    return catalogModels.find((item) => item.slug === base);
+}
+export function getRuntimeDefaultsForModel(model) {
+    if (!model)
+        return undefined;
+    const out = {};
+    if (typeof model.apply_patch_tool_type === "string") {
+        const next = model.apply_patch_tool_type.trim();
+        if (next)
+            out.applyPatchToolType = next;
+    }
+    const defaultReasoningEffort = normalizeReasoningEffort(model.default_reasoning_level);
+    if (defaultReasoningEffort) {
+        out.defaultReasoningEffort = defaultReasoningEffort;
+    }
+    const supportedReasoningEfforts = Array.from(new Set((model.supported_reasoning_levels ?? [])
+        .map((level) => normalizeReasoningEffort(level.effort))
+        .filter((value) => value !== undefined)));
+    if (supportedReasoningEfforts.length > 0) {
+        out.supportedReasoningEfforts = supportedReasoningEfforts;
+    }
+    if (typeof model.supports_reasoning_summaries === "boolean") {
+        out.supportsReasoningSummaries = model.supports_reasoning_summaries;
+    }
+    if (typeof model.reasoning_summary_format === "string") {
+        const next = model.reasoning_summary_format.trim();
+        if (next)
+            out.reasoningSummaryFormat = next;
+    }
+    if (typeof model.support_verbosity === "boolean") {
+        out.supportsVerbosity = model.support_verbosity;
+    }
+    const defaultVerbosity = normalizeVerbosity(model.default_verbosity);
+    if (defaultVerbosity) {
+        out.defaultVerbosity = defaultVerbosity;
+    }
+    return Object.keys(out).length > 0 ? out : undefined;
+}
+export function getRuntimeDefaultsForSlug(slug, catalogModels) {
+    const model = findModelBySlug(catalogModels, slug);
+    return getRuntimeDefaultsForModel(model);
+}
+export function applyCodexCatalogToProviderModels(input) {
+    const allowedSlugs = resolveAllowedSlugs(input.catalogModels, input.fallbackModels);
+    const allowed = new Set(allowedSlugs);
+    const bySlug = new Map((input.catalogModels ?? []).map((model) => [model.slug, model]));
+    const templateSource = resolveTemplateSource(input.providerModels);
+    for (const slug of allowedSlugs) {
+        if (!input.providerModels[slug]) {
+            if (templateSource) {
+                input.providerModels[slug] = cloneModelTemplate(templateSource, slug);
+            }
+            else {
+                input.providerModels[slug] = { id: slug, model: slug };
+            }
+        }
+        else {
+            setModelIdentityFields(input.providerModels[slug], slug);
+        }
+        const catalogModel = bySlug.get(slug);
+        const options = ensureModelOptions(input.providerModels[slug]);
+        if (catalogModel) {
+            const instructions = resolveInstructionsForModel(catalogModel, input.personality);
+            options.codexCatalogModel = catalogModel;
+            if (instructions) {
+                input.providerModels[slug].instructions = instructions;
+                options.codexInstructions = instructions;
+            }
+            else {
+                delete options.codexInstructions;
+            }
+        }
+        else {
+            delete options.codexCatalogModel;
+        }
+        const runtimeDefaults = getRuntimeDefaultsForSlug(slug, input.catalogModels);
+        if (runtimeDefaults) {
+            input.providerModels[slug].codexRuntimeDefaults = runtimeDefaults;
+            options.codexRuntimeDefaults = runtimeDefaults;
+        }
+        else {
+            delete input.providerModels[slug].codexRuntimeDefaults;
+            delete options.codexRuntimeDefaults;
+        }
+    }
+    for (const modelId of Object.keys(input.providerModels)) {
+        if (!allowed.has(modelId)) {
+            delete input.providerModels[modelId];
+        }
+    }
+    const orderedModelIds = Object.keys(input.providerModels).sort((a, b) => b.localeCompare(a));
+    if (orderedModelIds.length > 1) {
+        const orderedEntries = orderedModelIds.map((modelId) => [modelId, input.providerModels[modelId]]);
+        for (const modelId of Object.keys(input.providerModels)) {
+            delete input.providerModels[modelId];
+        }
+        for (const [modelId, model] of orderedEntries) {
+            if (model) {
+                input.providerModels[modelId] = model;
+            }
+        }
+    }
+    for (const model of Object.values(input.providerModels)) {
+        model.cost = {
+            input: 0,
+            output: 0,
+            cache: { read: 0, write: 0 }
+        };
+    }
+}
+//# sourceMappingURL=provider.js.map