@darkjd/opencode-openai-codex-auth 4.10.1

package/dist/lib/request/helpers/model-map.js

@@ -0,0 +1,134 @@
+/**
+ * Model Configuration Map
+ *
+ * Maps model config IDs to their normalized API model names.
+ * Only includes exact config IDs that OpenCode will pass to the plugin.
+ */
+/**
+ * Map of config model IDs to normalized API model names
+ *
+ * Key: The model ID as specified in opencode.json config
+ * Value: The normalized model name to send to the API
+ */
+export const MODEL_MAP = {
+    // ============================================================================
+    // GPT-5.6 Models (none/low/medium/high/xhigh/max)
+    // ============================================================================
+    "gpt-5.6": "gpt-5.6-sol",
+    "gpt-5.6-sol": "gpt-5.6-sol",
+    "gpt-5.6-sol-none": "gpt-5.6-sol",
+    "gpt-5.6-sol-low": "gpt-5.6-sol",
+    "gpt-5.6-sol-medium": "gpt-5.6-sol",
+    "gpt-5.6-sol-high": "gpt-5.6-sol",
+    "gpt-5.6-sol-xhigh": "gpt-5.6-sol",
+    "gpt-5.6-sol-max": "gpt-5.6-sol",
+    "gpt-5.6-terra": "gpt-5.6-terra",
+    "gpt-5.6-terra-none": "gpt-5.6-terra",
+    "gpt-5.6-terra-low": "gpt-5.6-terra",
+    "gpt-5.6-terra-medium": "gpt-5.6-terra",
+    "gpt-5.6-terra-high": "gpt-5.6-terra",
+    "gpt-5.6-terra-xhigh": "gpt-5.6-terra",
+    "gpt-5.6-terra-max": "gpt-5.6-terra",
+    "gpt-5.6-luna": "gpt-5.6-luna",
+    "gpt-5.6-luna-none": "gpt-5.6-luna",
+    "gpt-5.6-luna-low": "gpt-5.6-luna",
+    "gpt-5.6-luna-medium": "gpt-5.6-luna",
+    "gpt-5.6-luna-high": "gpt-5.6-luna",
+    "gpt-5.6-luna-xhigh": "gpt-5.6-luna",
+    "gpt-5.6-luna-max": "gpt-5.6-luna",
+    // ============================================================================
+    // GPT-5.1 Codex Models
+    // ============================================================================
+    "gpt-5.1-codex": "gpt-5.1-codex",
+    "gpt-5.1-codex-low": "gpt-5.1-codex",
+    "gpt-5.1-codex-medium": "gpt-5.1-codex",
+    "gpt-5.1-codex-high": "gpt-5.1-codex",
+    // ============================================================================
+    // GPT-5.1 Codex Max Models
+    // ============================================================================
+    "gpt-5.1-codex-max": "gpt-5.1-codex-max",
+    "gpt-5.1-codex-max-low": "gpt-5.1-codex-max",
+    "gpt-5.1-codex-max-medium": "gpt-5.1-codex-max",
+    "gpt-5.1-codex-max-high": "gpt-5.1-codex-max",
+    "gpt-5.1-codex-max-xhigh": "gpt-5.1-codex-max",
+    // ============================================================================
+    // GPT-5.2 Models (supports none/low/medium/high/xhigh per OpenAI API docs)
+    // ============================================================================
+    "gpt-5.2": "gpt-5.2",
+    "gpt-5.2-none": "gpt-5.2",
+    "gpt-5.2-low": "gpt-5.2",
+    "gpt-5.2-medium": "gpt-5.2",
+    "gpt-5.2-high": "gpt-5.2",
+    "gpt-5.2-xhigh": "gpt-5.2",
+    // ============================================================================
+    // GPT-5.2 Codex Models (low/medium/high/xhigh)
+    // ============================================================================
+    "gpt-5.2-codex": "gpt-5.2-codex",
+    "gpt-5.2-codex-low": "gpt-5.2-codex",
+    "gpt-5.2-codex-medium": "gpt-5.2-codex",
+    "gpt-5.2-codex-high": "gpt-5.2-codex",
+    "gpt-5.2-codex-xhigh": "gpt-5.2-codex",
+    // ============================================================================
+    // GPT-5.1 Codex Mini Models
+    // ============================================================================
+    "gpt-5.1-codex-mini": "gpt-5.1-codex-mini",
+    "gpt-5.1-codex-mini-medium": "gpt-5.1-codex-mini",
+    "gpt-5.1-codex-mini-high": "gpt-5.1-codex-mini",
+    // ============================================================================
+    // GPT-5.1 General Purpose Models (supports none/low/medium/high per OpenAI API docs)
+    // ============================================================================
+    "gpt-5.1": "gpt-5.1",
+    "gpt-5.1-none": "gpt-5.1",
+    "gpt-5.1-low": "gpt-5.1",
+    "gpt-5.1-medium": "gpt-5.1",
+    "gpt-5.1-high": "gpt-5.1",
+    "gpt-5.1-chat-latest": "gpt-5.1",
+    // ============================================================================
+    // GPT-5 Codex Models (LEGACY - maps to gpt-5.1-codex as gpt-5 is being phased out)
+    // ============================================================================
+    "gpt-5-codex": "gpt-5.1-codex",
+    // ============================================================================
+    // GPT-5 Codex Mini Models (LEGACY - maps to gpt-5.1-codex-mini)
+    // ============================================================================
+    "codex-mini-latest": "gpt-5.1-codex-mini",
+    "gpt-5-codex-mini": "gpt-5.1-codex-mini",
+    "gpt-5-codex-mini-medium": "gpt-5.1-codex-mini",
+    "gpt-5-codex-mini-high": "gpt-5.1-codex-mini",
+    // ============================================================================
+    // GPT-5 General Purpose Models (LEGACY - maps to gpt-5.1 as gpt-5 is being phased out)
+    // ============================================================================
+    "gpt-5": "gpt-5.1",
+    "gpt-5-mini": "gpt-5.1",
+    "gpt-5-nano": "gpt-5.1",
+};
+/**
+ * Get normalized model name from config ID
+ *
+ * @param modelId - Model ID from config (e.g., "gpt-5.1-codex-low")
+ * @returns Normalized model name (e.g., "gpt-5.1-codex") or undefined if not found
+ */
+export function getNormalizedModel(modelId) {
+    try {
+        // Try direct lookup first
+        if (MODEL_MAP[modelId]) {
+            return MODEL_MAP[modelId];
+        }
+        // Try case-insensitive lookup
+        const lowerModelId = modelId.toLowerCase();
+        const match = Object.keys(MODEL_MAP).find((key) => key.toLowerCase() === lowerModelId);
+        return match ? MODEL_MAP[match] : undefined;
+    }
+    catch {
+        return undefined;
+    }
+}
+/**
+ * Check if a model ID is in the model map
+ *
+ * @param modelId - Model ID to check
+ * @returns True if model is in the map
+ */
+export function isKnownModel(modelId) {
+    return getNormalizedModel(modelId) !== undefined;
+}
+//# sourceMappingURL=model-map.js.map

package/dist/lib/request/helpers/model-map.js.map

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

package/dist/lib/request/helpers/model-registry-data.d.ts

@@ -0,0 +1,86 @@
+/**
+ * Model Registry — bundled defaults
+ *
+ * Single source of truth for "what models does this plugin know about".
+ *
+ * WHY THIS FILE EXISTS
+ * ---------------------
+ * Historically, adding support for a brand-new model (e.g. GPT-5.6) required
+ * touching every one of these places by hand:
+ *   - lib/request/helpers/model-map.ts   (exact preset id -> API model id)
+ *   - lib/request/request-transformer.ts (reasoning capability booleans)
+ *   - lib/prompts/codex.ts               (prompt-family + cache-file maps)
+ *   - config/opencode-legacy.json + config/opencode-modern.json (presets)
+ *   - README.md + config/README.md
+ *   - several test files
+ *
+ * That is a lot of surface area for a maintainer to keep in sync, especially
+ * for a solo/volunteer-maintained plugin. This registry collapses the *model
+ * knowledge* part (normalization, reasoning capabilities, prompt family) into
+ * ONE array of plain data objects. Adding a new model family now means
+ * appending one `ModelRegistryEntry` here — normalizeModel(), getReasoningConfig(),
+ * and getModelFamily() all consult this data automatically (see model-registry.ts).
+ *
+ * Config presets (config/opencode-*.json) and README tables still need their
+ * own entries, because they carry human-facing metadata (display names,
+ * context limits) this registry intentionally does not duplicate. But the
+ * *behavioral* wiring — which API model id to send, which reasoning efforts
+ * are legal, and which Codex CLI prompt to use — is now data-driven.
+ *
+ * REMOTE OVERLAY
+ * ---------------
+ * lib/request/helpers/model-registry.ts can optionally merge this bundled
+ * list with a remotely-hosted JSON overlay (ETag-cached, same pattern as
+ * lib/prompts/codex.ts's instruction fetching). That lets an active
+ * maintainer ship recognition for a new model instantly (by updating a JSON
+ * file on GitHub) without waiting for users to upgrade the npm package. It
+ * is entirely opt-in (no default URL is configured) — see README.md.
+ */
+import type { ModelFamily } from "../../prompts/codex.js";
+/** Reasoning effort values accepted anywhere in this plugin. */
+export type ReasoningEffort = "none" | "minimal" | "low" | "medium" | "high" | "xhigh" | "max";
+/**
+ * Which non-universal reasoning effort tiers a model family accepts.
+ * "low"/"medium"/"high" are assumed universal and are not tracked here.
+ */
+export interface ModelCapabilities {
+    /** Accepts reasoning.effort = "none" (general-purpose GPT-5.x/5.6 models). */
+    none?: boolean;
+    /** Accepts reasoning.effort = "xhigh" (flagship + Codex Max/5.2-codex/5.6). */
+    xhigh?: boolean;
+    /** Accepts reasoning.effort = "max" (currently GPT-5.6 only). */
+    max?: boolean;
+}
+/**
+ * One model family known to the plugin.
+ *
+ * `id` is what gets sent to the Codex API. `aliases` are every exact preset
+ * id (config key / model string) that should resolve to this entry,
+ * matched case-insensitively. Always include `id` itself in `aliases`.
+ */
+export interface ModelRegistryEntry {
+    /** Canonical model id sent to the Codex API, e.g. "gpt-5.2-codex". */
+    id: string;
+    /** Exact preset/config ids that resolve to this entry (case-insensitive). */
+    aliases: string[];
+    /** Codex CLI prompt/instructions family used to pick the system prompt. */
+    family: ModelFamily;
+    /** Reasoning effort tiers this model accepts beyond low/medium/high. */
+    capabilities?: ModelCapabilities;
+    /** Effort used when the user hasn't configured one explicitly. */
+    defaultEffort: ReasoningEffort;
+    /** Codex Mini has a narrow effort range (medium/high only) with its own clamp rules. */
+    isCodexMini?: boolean;
+    /** Legacy nano/mini presets default to a lower effort before being clamped to "low". */
+    isLightweight?: boolean;
+    /** Optional human-readable note for maintainers browsing this file. */
+    note?: string;
+}
+/**
+ * Bundled model registry, shipped with every release of this package.
+ *
+ * ORDER DOES NOT MATTER — lookups are by exact alias, not by scanning order —
+ * but keep newest models near the top for readability.
+ */
+export declare const BUNDLED_MODEL_REGISTRY: ModelRegistryEntry[];
+//# sourceMappingURL=model-registry-data.d.ts.map

package/dist/lib/request/helpers/model-registry-data.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"model-registry-data.d.ts","sourceRoot":"","sources":["../../../../lib/request/helpers/model-registry-data.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GAqCG;AAEH,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,wBAAwB,CAAC;AAE1D,gEAAgE;AAChE,MAAM,MAAM,eAAe,GACxB,MAAM,GACN,SAAS,GACT,KAAK,GACL,QAAQ,GACR,MAAM,GACN,OAAO,GACP,KAAK,CAAC;AAET;;;GAGG;AACH,MAAM,WAAW,iBAAiB;IACjC,8EAA8E;IAC9E,IAAI,CAAC,EAAE,OAAO,CAAC;IACf,+EAA+E;IAC/E,KAAK,CAAC,EAAE,OAAO,CAAC;IAChB,iEAAiE;IACjE,GAAG,CAAC,EAAE,OAAO,CAAC;CACd;AAED;;;;;;GAMG;AACH,MAAM,WAAW,kBAAkB;IAClC,sEAAsE;IACtE,EAAE,EAAE,MAAM,CAAC;IACX,6EAA6E;IAC7E,OAAO,EAAE,MAAM,EAAE,CAAC;IAClB,2EAA2E;IAC3E,MAAM,EAAE,WAAW,CAAC;IACpB,wEAAwE;IACxE,YAAY,CAAC,EAAE,iBAAiB,CAAC;IACjC,kEAAkE;IAClE,aAAa,EAAE,eAAe,CAAC;IAC/B,wFAAwF;IACxF,WAAW,CAAC,EAAE,OAAO,CAAC;IACtB,wFAAwF;IACxF,aAAa,CAAC,EAAE,OAAO,CAAC;IACxB,uEAAuE;IACvE,IAAI,CAAC,EAAE,MAAM,CAAC;CACd;AAED;;;;;GAKG;AACH,eAAO,MAAM,sBAAsB,EAAE,kBAAkB,EAmQtD,CAAC"}

package/dist/lib/request/helpers/model-registry-data.js

@@ -0,0 +1,293 @@
+/**
+ * Model Registry — bundled defaults
+ *
+ * Single source of truth for "what models does this plugin know about".
+ *
+ * WHY THIS FILE EXISTS
+ * ---------------------
+ * Historically, adding support for a brand-new model (e.g. GPT-5.6) required
+ * touching every one of these places by hand:
+ *   - lib/request/helpers/model-map.ts   (exact preset id -> API model id)
+ *   - lib/request/request-transformer.ts (reasoning capability booleans)
+ *   - lib/prompts/codex.ts               (prompt-family + cache-file maps)
+ *   - config/opencode-legacy.json + config/opencode-modern.json (presets)
+ *   - README.md + config/README.md
+ *   - several test files
+ *
+ * That is a lot of surface area for a maintainer to keep in sync, especially
+ * for a solo/volunteer-maintained plugin. This registry collapses the *model
+ * knowledge* part (normalization, reasoning capabilities, prompt family) into
+ * ONE array of plain data objects. Adding a new model family now means
+ * appending one `ModelRegistryEntry` here — normalizeModel(), getReasoningConfig(),
+ * and getModelFamily() all consult this data automatically (see model-registry.ts).
+ *
+ * Config presets (config/opencode-*.json) and README tables still need their
+ * own entries, because they carry human-facing metadata (display names,
+ * context limits) this registry intentionally does not duplicate. But the
+ * *behavioral* wiring — which API model id to send, which reasoning efforts
+ * are legal, and which Codex CLI prompt to use — is now data-driven.
+ *
+ * REMOTE OVERLAY
+ * ---------------
+ * lib/request/helpers/model-registry.ts can optionally merge this bundled
+ * list with a remotely-hosted JSON overlay (ETag-cached, same pattern as
+ * lib/prompts/codex.ts's instruction fetching). That lets an active
+ * maintainer ship recognition for a new model instantly (by updating a JSON
+ * file on GitHub) without waiting for users to upgrade the npm package. It
+ * is entirely opt-in (no default URL is configured) — see README.md.
+ */
+/**
+ * Bundled model registry, shipped with every release of this package.
+ *
+ * ORDER DOES NOT MATTER — lookups are by exact alias, not by scanning order —
+ * but keep newest models near the top for readability.
+ */
+export const BUNDLED_MODEL_REGISTRY = [
+    // ============================================================================
+    // GPT-6 Astra (low/medium/high/xhigh/max — no "none")
+    // ============================================================================
+    {
+        id: "gpt-6-astra",
+        aliases: [
+            "gpt-6-astra",
+            "gpt-6",
+            "gpt-6-astra-low",
+            "gpt-6-astra-medium",
+            "gpt-6-astra-high",
+            "gpt-6-astra-xhigh",
+            "gpt-6-astra-max",
+        ],
+        // openai/codex has not published a dedicated gpt-6 prompt file yet
+        // (checked release rust-v0.153.4: codex-rs/core has no gpt-6* prompt).
+        // Reuses the gpt-5.2 general-purpose prompt family until one exists.
+        family: "gpt-5.2",
+        capabilities: { xhigh: true, max: true },
+        defaultEffort: "high",
+        note: "Verified live against the ChatGPT Codex backend (2026-09-06): " +
+            "'gpt-6-astra' is the real API model id — bare 'gpt-6' is REJECTED " +
+            "by the API ({\"detail\":\"The 'gpt-6' model is not supported...\"}) " +
+            "but is kept here as a convenience alias, same as 'gpt-5.6' -> sol. " +
+            "Supported reasoning efforts confirmed via the API's own error " +
+            "message when 'none' was rejected: \"Supported values are: 'low', " +
+            "'medium', 'high', 'xhigh', and 'max'.\" Context/output limits in " +
+            "the config presets are provisional (borrowed from gpt-5.2) — " +
+            "OpenAI hasn't published official numbers for this model yet.",
+    },
+    // ============================================================================
+    // GPT-6 Sol / Luna (none/low/medium/high/xhigh/max) — reuses the gpt-5.6
+    // prompt family, same behavior/effort tiers as gpt-5.6-sol/terra/luna.
+    // ============================================================================
+    {
+        id: "gpt-6-sol",
+        aliases: [
+            "gpt-6-sol",
+            "gpt-6-sol-none",
+            "gpt-6-sol-low",
+            "gpt-6-sol-medium",
+            "gpt-6-sol-high",
+            "gpt-6-sol-xhigh",
+            "gpt-6-sol-max",
+        ],
+        family: "gpt-5.6",
+        capabilities: { none: true, xhigh: true, max: true },
+        defaultEffort: "medium",
+        note: "Verified live against the ChatGPT Codex backend (2026-09-22): " +
+            "'gpt-6-sol' is a real API model id (HTTP 200 for a bare probe, plus " +
+            "HTTP 200 for reasoning.effort = none/minimal/low/medium/high/xhigh/max, " +
+            "confirmed via the same methodology as gpt-6-astra). openai/codex has " +
+            "not published a dedicated gpt-6 prompt file yet (checked release " +
+            "rust-v0.156.0: codex-rs/core still only has 5.1/5.1-codex-max/5.2/" +
+            "5.2-codex prompt files) — reuses the gpt-5.6 prompt family. Context " +
+            "window (1,050,000 / 922,000 input / 128,000 output) confirmed via " +
+            "models.dev's public catalog, not guessed.",
+    },
+    {
+        id: "gpt-6-luna",
+        aliases: [
+            "gpt-6-luna",
+            "gpt-6-luna-none",
+            "gpt-6-luna-low",
+            "gpt-6-luna-medium",
+            "gpt-6-luna-high",
+            "gpt-6-luna-xhigh",
+            "gpt-6-luna-max",
+        ],
+        family: "gpt-5.6",
+        capabilities: { none: true, xhigh: true, max: true },
+        defaultEffort: "medium",
+        note: "Verified live against the ChatGPT Codex backend (2026-09-22), same " +
+            "methodology and same result as gpt-6-sol (see its note): real API " +
+            "model id, full none/minimal/low/medium/high/xhigh/max reasoning " +
+            "range, reuses the gpt-5.6 prompt family, 1,050,000 context window " +
+            "confirmed via models.dev.",
+    },
+    // ============================================================================
+    // GPT-5.6 (none/low/medium/high/xhigh/max)
+    // ============================================================================
+    {
+        id: "gpt-5.6-sol",
+        aliases: [
+            "gpt-5.6",
+            "gpt-5.6-sol",
+            "gpt-5.6-sol-none",
+            "gpt-5.6-sol-low",
+            "gpt-5.6-sol-medium",
+            "gpt-5.6-sol-high",
+            "gpt-5.6-sol-xhigh",
+            "gpt-5.6-sol-max",
+        ],
+        family: "gpt-5.6",
+        capabilities: { none: true, xhigh: true, max: true },
+        defaultEffort: "medium",
+    },
+    {
+        id: "gpt-5.6-terra",
+        aliases: [
+            "gpt-5.6-terra",
+            "gpt-5.6-terra-none",
+            "gpt-5.6-terra-low",
+            "gpt-5.6-terra-medium",
+            "gpt-5.6-terra-high",
+            "gpt-5.6-terra-xhigh",
+            "gpt-5.6-terra-max",
+        ],
+        family: "gpt-5.6",
+        capabilities: { none: true, xhigh: true, max: true },
+        defaultEffort: "medium",
+    },
+    {
+        id: "gpt-5.6-luna",
+        aliases: [
+            "gpt-5.6-luna",
+            "gpt-5.6-luna-none",
+            "gpt-5.6-luna-low",
+            "gpt-5.6-luna-medium",
+            "gpt-5.6-luna-high",
+            "gpt-5.6-luna-xhigh",
+            "gpt-5.6-luna-max",
+        ],
+        family: "gpt-5.6",
+        capabilities: { none: true, xhigh: true, max: true },
+        defaultEffort: "medium",
+    },
+    // ============================================================================
+    // GPT-5.2 Codex (low/medium/high/xhigh)
+    // ============================================================================
+    {
+        id: "gpt-5.2-codex",
+        aliases: [
+            "gpt-5.2-codex",
+            "gpt-5.2-codex-low",
+            "gpt-5.2-codex-medium",
+            "gpt-5.2-codex-high",
+            "gpt-5.2-codex-xhigh",
+        ],
+        family: "gpt-5.2-codex",
+        capabilities: { xhigh: true },
+        defaultEffort: "high",
+    },
+    // ============================================================================
+    // GPT-5.2 general purpose (none/low/medium/high/xhigh)
+    // ============================================================================
+    {
+        id: "gpt-5.2",
+        aliases: [
+            "gpt-5.2",
+            "gpt-5.2-none",
+            "gpt-5.2-low",
+            "gpt-5.2-medium",
+            "gpt-5.2-high",
+            "gpt-5.2-xhigh",
+        ],
+        family: "gpt-5.2",
+        capabilities: { none: true, xhigh: true },
+        defaultEffort: "high",
+    },
+    // ============================================================================
+    // GPT-5.1 Codex Max (low/medium/high/xhigh)
+    // ============================================================================
+    {
+        id: "gpt-5.1-codex-max",
+        aliases: [
+            "gpt-5.1-codex-max",
+            "gpt-5.1-codex-max-low",
+            "gpt-5.1-codex-max-medium",
+            "gpt-5.1-codex-max-high",
+            "gpt-5.1-codex-max-xhigh",
+        ],
+        family: "codex-max",
+        capabilities: { xhigh: true },
+        defaultEffort: "high",
+    },
+    // ============================================================================
+    // GPT-5.1 Codex Mini (medium/high only, own clamp rules)
+    // ============================================================================
+    {
+        id: "gpt-5.1-codex-mini",
+        aliases: [
+            "gpt-5.1-codex-mini",
+            "gpt-5.1-codex-mini-medium",
+            "gpt-5.1-codex-mini-high",
+            // Legacy GPT-5.0 codex-mini names (being phased out) share the same behavior
+            "codex-mini-latest",
+            "gpt-5-codex-mini",
+            "gpt-5-codex-mini-medium",
+            "gpt-5-codex-mini-high",
+        ],
+        family: "codex",
+        defaultEffort: "medium",
+        isCodexMini: true,
+    },
+    // ============================================================================
+    // GPT-5.1 Codex (low/medium/high)
+    // ============================================================================
+    {
+        id: "gpt-5.1-codex",
+        aliases: [
+            "gpt-5.1-codex",
+            "gpt-5.1-codex-low",
+            "gpt-5.1-codex-medium",
+            "gpt-5.1-codex-high",
+            // Legacy GPT-5.0 codex name (being phased out) shares the same behavior
+            "gpt-5-codex",
+        ],
+        family: "codex",
+        defaultEffort: "medium",
+    },
+    // ============================================================================
+    // GPT-5.1 general purpose (none/low/medium/high)
+    // ============================================================================
+    {
+        id: "gpt-5.1",
+        aliases: [
+            "gpt-5.1",
+            "gpt-5.1-none",
+            "gpt-5.1-low",
+            "gpt-5.1-medium",
+            "gpt-5.1-high",
+            "gpt-5.1-chat-latest",
+            // Legacy GPT-5.0 names (being phased out) normalize to gpt-5.1
+            "gpt-5",
+        ],
+        family: "gpt-5.1",
+        capabilities: { none: true },
+        defaultEffort: "medium",
+    },
+    // ============================================================================
+    // Legacy GPT-5.0 lightweight presets (being phased out; normalize to gpt-5.1)
+    // Kept as distinct aliases (not merged into the "gpt-5.1" entry above) so
+    // getReasoningConfig() still recognizes them as lightweight when called with
+    // the raw preset id, before normalizeModel() has stripped the "nano"/"mini"
+    // signal from the model string.
+    // ============================================================================
+    {
+        id: "gpt-5.1",
+        aliases: ["gpt-5-mini", "gpt-5-nano"],
+        family: "gpt-5.1",
+        capabilities: { none: true },
+        defaultEffort: "minimal",
+        isLightweight: true,
+        note: "Legacy gpt-5-mini/gpt-5-nano presets. gpt-5 is being phased out in favor of gpt-5.1.",
+    },
+];
+//# sourceMappingURL=model-registry-data.js.map

package/dist/lib/request/helpers/model-registry-data.js.map

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

package/dist/lib/request/helpers/model-registry.d.ts

@@ -0,0 +1,45 @@
+/**
+ * Model Registry — lookup, merging, and optional remote overlay
+ *
+ * Consumers (normalizeModel, getReasoningConfig, getModelFamily) call
+ * `lookupModelRegistryEntry()` synchronously. The registry itself is always
+ * available synchronously (bundled defaults + last-persisted remote overlay,
+ * both loaded once at module init); a remote refresh — when configured — runs
+ * in the background and updates the in-memory copy for *future* lookups. This
+ * means a request is never delayed or blocked by a network call.
+ *
+ * The remote overlay is entirely OPT-IN: unless a maintainer or user
+ * explicitly configures `modelRegistryUrl` (plugin config) or the
+ * `OPENCODE_CODEX_MODEL_REGISTRY_URL` env var, no network request is ever
+ * made. This keeps the default (and every existing test) fully offline.
+ */
+import { type ModelRegistryEntry } from "./model-registry-data.js";
+/**
+ * Configure the remote overlay source. Called once by index.ts from the
+ * loaded plugin config. Pass `undefined`/empty to disable.
+ */
+export declare function configureModelRegistrySource(url: string | undefined): void;
+/**
+ * Test-only: deterministically run (and await) a refresh attempt against the
+ * currently configured URL, bypassing the fire-and-forget wrapper. No-op
+ * (resolves immediately) if no URL is configured.
+ */
+export declare function __triggerModelRegistryRefreshForTests(): Promise<void>;
+/**
+ * Get the current model registry (bundled defaults + any merged overlay).
+ * Synchronous — safe to call from hot request-handling paths.
+ */
+export declare function getModelRegistry(): ModelRegistryEntry[];
+/**
+ * Look up a model id or preset name in the registry, case-insensitively.
+ * Returns undefined if nothing matches (callers should fall back to their
+ * own generic pattern matching for completely unrecognized names).
+ */
+export declare function lookupModelRegistryEntry(modelId: string | undefined): ModelRegistryEntry | undefined;
+/**
+ * Test-only: reset in-memory state and force a specific configured URL.
+ * Not exported from the package's public surface.
+ */
+export declare function __resetModelRegistryForTests(): void;
+export type { ModelRegistryEntry } from "./model-registry-data.js";
+//# sourceMappingURL=model-registry.d.ts.map

package/dist/lib/request/helpers/model-registry.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"model-registry.d.ts","sourceRoot":"","sources":["../../../../lib/request/helpers/model-registry.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;GAcG;AAKH,OAAO,EAEN,KAAK,kBAAkB,EACvB,MAAM,0BAA0B,CAAC;AA+FlC;;;GAGG;AACH,wBAAgB,4BAA4B,CAAC,GAAG,EAAE,MAAM,GAAG,SAAS,GAAG,IAAI,CAE1E;AAqFD;;;;GAIG;AACH,wBAAsB,qCAAqC,IAAI,OAAO,CAAC,IAAI,CAAC,CAI3E;AAED;;;GAGG;AACH,wBAAgB,gBAAgB,IAAI,kBAAkB,EAAE,CAGvD;AAED;;;;GAIG;AACH,wBAAgB,wBAAwB,CACvC,OAAO,EAAE,MAAM,GAAG,SAAS,GACzB,kBAAkB,GAAG,SAAS,CAIhC;AAED;;;GAGG;AACH,wBAAgB,4BAA4B,IAAI,IAAI,CAKnD;AAED,YAAY,EAAE,kBAAkB,EAAE,MAAM,0BAA0B,CAAC"}