@darkjd/opencode-openai-codex-auth 4.10.1

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

@@ -0,0 +1,208 @@
+/**
+ * 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 { existsSync, mkdirSync, readFileSync, writeFileSync } from "node:fs";
+import { homedir } from "node:os";
+import { join } from "node:path";
+import { BUNDLED_MODEL_REGISTRY, } from "./model-registry-data.js";
+const CACHE_DIR = join(homedir(), ".opencode", "cache");
+const CACHE_FILE = join(CACHE_DIR, "model-registry-overlay.json");
+const CACHE_META_FILE = join(CACHE_DIR, "model-registry-overlay-meta.json");
+const CACHE_TTL_MS = 15 * 60 * 1000; // 15 minutes, matches lib/prompts/codex.ts
+/** Set once (per process) by index.ts from the loaded plugin config. */
+let configuredUrl;
+/** In-memory registry: bundled defaults merged with the last-known overlay. */
+let activeRegistry = BUNDLED_MODEL_REGISTRY;
+let aliasIndex = buildAliasIndex(activeRegistry);
+let refreshInFlight = false;
+function buildAliasIndex(registry) {
+    const index = new Map();
+    for (const entry of registry) {
+        for (const alias of entry.aliases) {
+            index.set(alias.toLowerCase(), entry);
+        }
+    }
+    return index;
+}
+/**
+ * Merge a remote overlay into the bundled defaults.
+ * Overlay entries take precedence for any alias they also define, so a
+ * maintainer can both add brand-new models and patch an existing one.
+ */
+function mergeRegistries(bundled, overlay) {
+    if (overlay.length === 0)
+        return bundled;
+    const overlayAliases = new Set(overlay.flatMap((entry) => entry.aliases.map((a) => a.toLowerCase())));
+    const remainingBundled = bundled.filter((entry) => !entry.aliases.some((a) => overlayAliases.has(a.toLowerCase())));
+    return [...overlay, ...remainingBundled];
+}
+function isValidRegistryEntry(value) {
+    if (!value || typeof value !== "object")
+        return false;
+    const entry = value;
+    return (typeof entry.id === "string" &&
+        Array.isArray(entry.aliases) &&
+        entry.aliases.every((a) => typeof a === "string") &&
+        typeof entry.family === "string" &&
+        typeof entry.defaultEffort === "string");
+}
+function loadCachedOverlaySync() {
+    try {
+        if (!existsSync(CACHE_FILE))
+            return [];
+        const parsed = JSON.parse(readFileSync(CACHE_FILE, "utf8"));
+        if (!Array.isArray(parsed))
+            return [];
+        return parsed.filter(isValidRegistryEntry);
+    }
+    catch {
+        return [];
+    }
+}
+function loadCachedMetaSync() {
+    try {
+        if (!existsSync(CACHE_META_FILE))
+            return null;
+        return JSON.parse(readFileSync(CACHE_META_FILE, "utf8"));
+    }
+    catch {
+        return null;
+    }
+}
+// Initialize from any previously-cached overlay so a restarted process picks
+// up the last successful remote fetch immediately, without waiting on a
+// network round-trip.
+{
+    const cachedOverlay = loadCachedOverlaySync();
+    if (cachedOverlay.length > 0) {
+        activeRegistry = mergeRegistries(BUNDLED_MODEL_REGISTRY, cachedOverlay);
+        aliasIndex = buildAliasIndex(activeRegistry);
+    }
+}
+/**
+ * Configure the remote overlay source. Called once by index.ts from the
+ * loaded plugin config. Pass `undefined`/empty to disable.
+ */
+export function configureModelRegistrySource(url) {
+    configuredUrl = url?.trim() || undefined;
+}
+function getConfiguredRegistryUrl() {
+    return process.env.OPENCODE_CODEX_MODEL_REGISTRY_URL?.trim() || configuredUrl;
+}
+/**
+ * Fetch the remote overlay JSON with ETag-based conditional requests,
+ * mirroring the caching strategy in lib/prompts/codex.ts. Never throws —
+ * all failures are swallowed since this only ever refines an already-usable
+ * in-memory registry.
+ */
+async function fetchRemoteOverlay(url) {
+    const meta = loadCachedMetaSync();
+    const headers = {};
+    if (meta?.url === url && meta.etag) {
+        headers["If-None-Match"] = meta.etag;
+    }
+    const response = await fetch(url, { headers });
+    if (response.status === 304) {
+        return null; // Unchanged; nothing new to merge.
+    }
+    if (!response.ok) {
+        throw new Error(`HTTP ${response.status}`);
+    }
+    const data = (await response.json());
+    const entries = Array.isArray(data) ? data.filter(isValidRegistryEntry) : [];
+    if (!existsSync(CACHE_DIR)) {
+        mkdirSync(CACHE_DIR, { recursive: true });
+    }
+    writeFileSync(CACHE_FILE, JSON.stringify(entries), "utf8");
+    writeFileSync(CACHE_META_FILE, JSON.stringify({
+        etag: response.headers.get("etag"),
+        lastChecked: Date.now(),
+        url,
+    }), "utf8");
+    return entries;
+}
+async function performRefresh(url) {
+    refreshInFlight = true;
+    try {
+        const entries = await fetchRemoteOverlay(url);
+        if (entries && entries.length > 0) {
+            activeRegistry = mergeRegistries(BUNDLED_MODEL_REGISTRY, entries);
+            aliasIndex = buildAliasIndex(activeRegistry);
+        }
+    }
+    catch (error) {
+        console.error("[openai-codex-plugin] Failed to refresh remote model registry:", error.message);
+    }
+    finally {
+        refreshInFlight = false;
+    }
+}
+/**
+ * Kick off a background refresh if a remote source is configured and the
+ * cache is stale. Fire-and-forget: never awaited by request handling, so it
+ * can never slow down or fail a live request. Results apply to subsequent
+ * lookups only.
+ */
+function maybeTriggerBackgroundRefresh() {
+    const url = getConfiguredRegistryUrl();
+    if (!url || refreshInFlight)
+        return;
+    const meta = loadCachedMetaSync();
+    if (meta?.url === url && Date.now() - meta.lastChecked < CACHE_TTL_MS) {
+        return; // Cache is fresh enough; don't spam the network.
+    }
+    void performRefresh(url);
+}
+/**
+ * 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 async function __triggerModelRegistryRefreshForTests() {
+    const url = getConfiguredRegistryUrl();
+    if (!url)
+        return;
+    await performRefresh(url);
+}
+/**
+ * Get the current model registry (bundled defaults + any merged overlay).
+ * Synchronous — safe to call from hot request-handling paths.
+ */
+export function getModelRegistry() {
+    maybeTriggerBackgroundRefresh();
+    return activeRegistry;
+}
+/**
+ * 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 function lookupModelRegistryEntry(modelId) {
+    if (!modelId)
+        return undefined;
+    maybeTriggerBackgroundRefresh();
+    return aliasIndex.get(modelId.toLowerCase());
+}
+/**
+ * Test-only: reset in-memory state and force a specific configured URL.
+ * Not exported from the package's public surface.
+ */
+export function __resetModelRegistryForTests() {
+    configuredUrl = undefined;
+    refreshInFlight = false;
+    activeRegistry = BUNDLED_MODEL_REGISTRY;
+    aliasIndex = buildAliasIndex(activeRegistry);
+}
+//# sourceMappingURL=model-registry.js.map

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

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

package/dist/lib/request/helpers/skill-catalog.d.ts

@@ -0,0 +1,59 @@
+/**
+ * OpenCode capability-block passthrough for OpenAI OAuth (Codex) sessions.
+ *
+ * Background: opencode's `isOpenaiOauth` branch (session/llm/request.ts) puts
+ * the entire joined system prompt - persona, env, AGENTS.md, `<mcp_instructions>`,
+ * and the `<available_skills>` catalog - into `options.instructions`, which the
+ * AI SDK forwards as the Responses API's top-level `instructions` field. This
+ * plugin's `transformRequestBody()` then unconditionally overwrites
+ * `body.instructions` with the official Codex CLI instructions, silently
+ * discarding both blocks before Codex ever sees them (confirmed empirically -
+ * see specs/skill-catalog-passthrough.md).
+ *
+ * These helpers extract the two capability blocks before that overwrite so
+ * they can be re-appended afterwards, giving Codex sessions the same
+ * skill/MCP awareness Anthropic sessions already get. Kept as small, pure,
+ * regex-based string functions - no assumptions about the rest of the
+ * instructions string, safe to no-op if opencode ever changes its wording.
+ */
+/**
+ * Extract opencode's `<available_skills>...</available_skills>` block from an
+ * instructions string, if present.
+ * @param instructions - Raw instructions string (pre-overwrite)
+ * @returns The matched block verbatim, or null if absent/malformed
+ */
+export declare function extractSkillCatalog(instructions: string | undefined): string | null;
+/**
+ * Extract opencode's `<mcp_instructions>...</mcp_instructions>` block from an
+ * instructions string, if present.
+ * @param instructions - Raw instructions string (pre-overwrite)
+ * @returns The matched block verbatim, or null if absent/malformed
+ */
+export declare function extractMcpInstructions(instructions: string | undefined): string | null;
+/** Both capability blocks extracted from an instructions string, if present. */
+export interface OpenCodeCapabilityBlocks {
+    skillCatalog: string | null;
+    mcpInstructions: string | null;
+}
+/**
+ * Extract both preservable opencode capability blocks from an instructions
+ * string in one pass, before the caller overwrites `body.instructions`.
+ * @param instructions - Raw instructions string (pre-overwrite)
+ */
+export declare function extractOpenCodeCapabilityBlocks(instructions: string | undefined): OpenCodeCapabilityBlocks;
+/**
+ * Short framing line opencode itself prints just before `<available_skills>`
+ * (see session/system.ts `sys.skills()`). That framing text lives in plain
+ * prose *outside* the tag, so the regex above doesn't capture it - this is
+ * our own equivalent framing to reattach when re-injecting the catalog into
+ * Codex's instructions, so the block isn't dropped in with no context.
+ */
+export declare const SKILL_TOOL_BRIDGE_HEADER: string;
+/**
+ * Recompose preserved capability blocks into a suffix to append to Codex's
+ * instructions, in the same relative order opencode itself uses
+ * (mcp before skills). Returns an empty string if nothing was preserved.
+ * @param blocks - Extracted capability blocks
+ */
+export declare function formatPreservedCapabilityBlocks(blocks: OpenCodeCapabilityBlocks): string;
+//# sourceMappingURL=skill-catalog.d.ts.map

package/dist/lib/request/helpers/skill-catalog.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"skill-catalog.d.ts","sourceRoot":"","sources":["../../../../lib/request/helpers/skill-catalog.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;GAiBG;AAKH;;;;;GAKG;AACH,wBAAgB,mBAAmB,CAAC,YAAY,EAAE,MAAM,GAAG,SAAS,GAAG,MAAM,GAAG,IAAI,CAInF;AAED;;;;;GAKG;AACH,wBAAgB,sBAAsB,CAAC,YAAY,EAAE,MAAM,GAAG,SAAS,GAAG,MAAM,GAAG,IAAI,CAItF;AAED,gFAAgF;AAChF,MAAM,WAAW,wBAAwB;IACxC,YAAY,EAAE,MAAM,GAAG,IAAI,CAAC;IAC5B,eAAe,EAAE,MAAM,GAAG,IAAI,CAAC;CAC/B;AAED;;;;GAIG;AACH,wBAAgB,+BAA+B,CAC9C,YAAY,EAAE,MAAM,GAAG,SAAS,GAC9B,wBAAwB,CAK1B;AAED;;;;;;GAMG;AACH,eAAO,MAAM,wBAAwB,QAEqC,CAAC;AAE3E;;;;;GAKG;AACH,wBAAgB,+BAA+B,CAAC,MAAM,EAAE,wBAAwB,GAAG,MAAM,CASxF"}

package/dist/lib/request/helpers/skill-catalog.js

@@ -0,0 +1,81 @@
+/**
+ * OpenCode capability-block passthrough for OpenAI OAuth (Codex) sessions.
+ *
+ * Background: opencode's `isOpenaiOauth` branch (session/llm/request.ts) puts
+ * the entire joined system prompt - persona, env, AGENTS.md, `<mcp_instructions>`,
+ * and the `<available_skills>` catalog - into `options.instructions`, which the
+ * AI SDK forwards as the Responses API's top-level `instructions` field. This
+ * plugin's `transformRequestBody()` then unconditionally overwrites
+ * `body.instructions` with the official Codex CLI instructions, silently
+ * discarding both blocks before Codex ever sees them (confirmed empirically -
+ * see specs/skill-catalog-passthrough.md).
+ *
+ * These helpers extract the two capability blocks before that overwrite so
+ * they can be re-appended afterwards, giving Codex sessions the same
+ * skill/MCP awareness Anthropic sessions already get. Kept as small, pure,
+ * regex-based string functions - no assumptions about the rest of the
+ * instructions string, safe to no-op if opencode ever changes its wording.
+ */
+const AVAILABLE_SKILLS_RE = /<available_skills>[\s\S]*?<\/available_skills>/;
+const MCP_INSTRUCTIONS_RE = /<mcp_instructions>[\s\S]*?<\/mcp_instructions>/;
+/**
+ * Extract opencode's `<available_skills>...</available_skills>` block from an
+ * instructions string, if present.
+ * @param instructions - Raw instructions string (pre-overwrite)
+ * @returns The matched block verbatim, or null if absent/malformed
+ */
+export function extractSkillCatalog(instructions) {
+    if (!instructions)
+        return null;
+    const match = instructions.match(AVAILABLE_SKILLS_RE);
+    return match ? match[0] : null;
+}
+/**
+ * Extract opencode's `<mcp_instructions>...</mcp_instructions>` block from an
+ * instructions string, if present.
+ * @param instructions - Raw instructions string (pre-overwrite)
+ * @returns The matched block verbatim, or null if absent/malformed
+ */
+export function extractMcpInstructions(instructions) {
+    if (!instructions)
+        return null;
+    const match = instructions.match(MCP_INSTRUCTIONS_RE);
+    return match ? match[0] : null;
+}
+/**
+ * Extract both preservable opencode capability blocks from an instructions
+ * string in one pass, before the caller overwrites `body.instructions`.
+ * @param instructions - Raw instructions string (pre-overwrite)
+ */
+export function extractOpenCodeCapabilityBlocks(instructions) {
+    return {
+        skillCatalog: extractSkillCatalog(instructions),
+        mcpInstructions: extractMcpInstructions(instructions),
+    };
+}
+/**
+ * Short framing line opencode itself prints just before `<available_skills>`
+ * (see session/system.ts `sys.skills()`). That framing text lives in plain
+ * prose *outside* the tag, so the regex above doesn't capture it - this is
+ * our own equivalent framing to reattach when re-injecting the catalog into
+ * Codex's instructions, so the block isn't dropped in with no context.
+ */
+export const SKILL_TOOL_BRIDGE_HEADER = "Skills provide specialized instructions and workflows for specific tasks. " +
+    "Use the skill tool to load a skill when a task matches its description.";
+/**
+ * Recompose preserved capability blocks into a suffix to append to Codex's
+ * instructions, in the same relative order opencode itself uses
+ * (mcp before skills). Returns an empty string if nothing was preserved.
+ * @param blocks - Extracted capability blocks
+ */
+export function formatPreservedCapabilityBlocks(blocks) {
+    const parts = [];
+    if (blocks.mcpInstructions) {
+        parts.push(blocks.mcpInstructions);
+    }
+    if (blocks.skillCatalog) {
+        parts.push(`${SKILL_TOOL_BRIDGE_HEADER}\n${blocks.skillCatalog}`);
+    }
+    return parts.length > 0 ? `\n\n${parts.join("\n\n")}` : "";
+}
+//# sourceMappingURL=skill-catalog.js.map

package/dist/lib/request/helpers/skill-catalog.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"skill-catalog.js","sourceRoot":"","sources":["../../../../lib/request/helpers/skill-catalog.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;GAiBG;AAEH,MAAM,mBAAmB,GAAG,gDAAgD,CAAC;AAC7E,MAAM,mBAAmB,GAAG,gDAAgD,CAAC;AAE7E;;;;;GAKG;AACH,MAAM,UAAU,mBAAmB,CAAC,YAAgC;IACnE,IAAI,CAAC,YAAY;QAAE,OAAO,IAAI,CAAC;IAC/B,MAAM,KAAK,GAAG,YAAY,CAAC,KAAK,CAAC,mBAAmB,CAAC,CAAC;IACtD,OAAO,KAAK,CAAC,CAAC,CAAC,KAAK,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,IAAI,CAAC;AAChC,CAAC;AAED;;;;;GAKG;AACH,MAAM,UAAU,sBAAsB,CAAC,YAAgC;IACtE,IAAI,CAAC,YAAY;QAAE,OAAO,IAAI,CAAC;IAC/B,MAAM,KAAK,GAAG,YAAY,CAAC,KAAK,CAAC,mBAAmB,CAAC,CAAC;IACtD,OAAO,KAAK,CAAC,CAAC,CAAC,KAAK,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,IAAI,CAAC;AAChC,CAAC;AAQD;;;;GAIG;AACH,MAAM,UAAU,+BAA+B,CAC9C,YAAgC;IAEhC,OAAO;QACN,YAAY,EAAE,mBAAmB,CAAC,YAAY,CAAC;QAC/C,eAAe,EAAE,sBAAsB,CAAC,YAAY,CAAC;KACrD,CAAC;AACH,CAAC;AAED;;;;;;GAMG;AACH,MAAM,CAAC,MAAM,wBAAwB,GACpC,4EAA4E;IAC5E,yEAAyE,CAAC;AAE3E;;;;;GAKG;AACH,MAAM,UAAU,+BAA+B,CAAC,MAAgC;IAC/E,MAAM,KAAK,GAAa,EAAE,CAAC;IAC3B,IAAI,MAAM,CAAC,eAAe,EAAE,CAAC;QAC5B,KAAK,CAAC,IAAI,CAAC,MAAM,CAAC,eAAe,CAAC,CAAC;IACpC,CAAC;IACD,IAAI,MAAM,CAAC,YAAY,EAAE,CAAC;QACzB,KAAK,CAAC,IAAI,CAAC,GAAG,wBAAwB,KAAK,MAAM,CAAC,YAAY,EAAE,CAAC,CAAC;IACnE,CAAC;IACD,OAAO,KAAK,CAAC,MAAM,GAAG,CAAC,CAAC,CAAC,CAAC,OAAO,KAAK,CAAC,IAAI,CAAC,MAAM,CAAC,EAAE,CAAC,CAAC,CAAC,EAAE,CAAC;AAC5D,CAAC"}

package/dist/lib/request/request-transformer.d.ts

@@ -0,0 +1,81 @@
+import type { ConfigOptions, InputItem, ReasoningConfig, RequestBody, UserConfig } from "../types.js";
+export { isOpenCodeSystemPrompt, filterOpenCodeSystemPromptsWithCachedPrompt, } from "./helpers/input-utils.js";
+/**
+ * Normalize model name to Codex-supported variants
+ *
+ * Uses explicit model map for known models, with fallback pattern matching
+ * for unknown/custom model names.
+ *
+ * @param model - Original model name (e.g., "gpt-5.1-codex-low", "openai/gpt-5-codex")
+ * @returns Normalized model name (e.g., "gpt-5.1-codex", "gpt-5-codex")
+ */
+export declare function normalizeModel(model: string | undefined): string;
+/**
+ * Extract configuration for a specific model
+ * Merges global options with model-specific options (model-specific takes precedence)
+ * @param modelName - Model name (e.g., "gpt-5-codex")
+ * @param userConfig - Full user configuration object
+ * @returns Merged configuration for this model
+ */
+export declare function getModelConfig(modelName: string, userConfig?: UserConfig): ConfigOptions;
+export declare function getReasoningConfig(modelName: string | undefined, userConfig?: ConfigOptions): ReasoningConfig;
+/**
+ * Filter input array for stateless Codex API (store: false)
+ *
+ * Two transformations needed:
+ * 1. Remove AI SDK-specific items (not supported by Codex API)
+ * 2. Strip IDs from all remaining items (stateless mode)
+ *
+ * AI SDK constructs to REMOVE (not in OpenAI Responses API spec):
+ * - type: "item_reference" - AI SDK uses this for server-side state lookup
+ *
+ * Items to KEEP (strip IDs):
+ * - type: "message" - Conversation messages (provides context to LLM)
+ * - type: "function_call" - Tool calls from conversation
+ * - type: "function_call_output" - Tool results from conversation
+ *
+ * Context is maintained through:
+ * - Full message history (without IDs)
+ * - reasoning.encrypted_content (for reasoning continuity)
+ *
+ * @param input - Original input array from OpenCode/AI SDK
+ * @returns Filtered input array compatible with Codex API
+ */
+export declare function filterInput(input: InputItem[] | undefined): InputItem[] | undefined;
+/**
+ * Filter out OpenCode system prompts from input
+ * Used in CODEX_MODE to replace OpenCode prompts with Codex-OpenCode bridge
+ * @param input - Input array
+ * @returns Input array without OpenCode system prompts
+ */
+export declare function filterOpenCodeSystemPrompts(input: InputItem[] | undefined): Promise<InputItem[] | undefined>;
+/**
+ * Add Codex-OpenCode bridge message to input if tools are present
+ * @param input - Input array
+ * @param hasTools - Whether tools are present in request
+ * @returns Input array with bridge message prepended if needed
+ */
+export declare function addCodexBridgeMessage(input: InputItem[] | undefined, hasTools: boolean): InputItem[] | undefined;
+/**
+ * Add tool remapping message to input if tools are present
+ * @param input - Input array
+ * @param hasTools - Whether tools are present in request
+ * @returns Input array with tool remap message prepended if needed
+ */
+export declare function addToolRemapMessage(input: InputItem[] | undefined, hasTools: boolean): InputItem[] | undefined;
+/**
+ * Transform request body for Codex API
+ *
+ * NOTE: Configuration follows Codex CLI patterns instead of opencode defaults:
+ * - opencode sets textVerbosity="low" for gpt-5, but Codex CLI uses "medium"
+ * - opencode excludes gpt-5-codex from reasoning configuration
+ * - This plugin uses store=false (stateless), requiring encrypted reasoning content
+ *
+ * @param body - Original request body
+ * @param codexInstructions - Codex system instructions
+ * @param userConfig - User configuration from loader
+ * @param codexMode - Enable CODEX_MODE (bridge prompt instead of tool remap) - defaults to true
+ * @returns Transformed request body
+ */
+export declare function transformRequestBody(body: RequestBody, codexInstructions: string, userConfig?: UserConfig, codexMode?: boolean): Promise<RequestBody>;
+//# sourceMappingURL=request-transformer.d.ts.map

package/dist/lib/request/request-transformer.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"request-transformer.d.ts","sourceRoot":"","sources":["../../../lib/request/request-transformer.ts"],"names":[],"mappings":"AAcA,OAAO,KAAK,EACX,aAAa,EACb,SAAS,EACT,eAAe,EACf,WAAW,EACX,UAAU,EACV,MAAM,aAAa,CAAC;AAErB,OAAO,EACN,sBAAsB,EACtB,2CAA2C,GAC3C,MAAM,0BAA0B,CAAC;AAElC;;;;;;;;GAQG;AACH,wBAAgB,cAAc,CAAC,KAAK,EAAE,MAAM,GAAG,SAAS,GAAG,MAAM,CA0IhE;AAED;;;;;;GAMG;AACH,wBAAgB,cAAc,CAC7B,SAAS,EAAE,MAAM,EACjB,UAAU,GAAE,UAAuC,GACjD,aAAa,CAMf;AAiJD,wBAAgB,kBAAkB,CACjC,SAAS,EAAE,MAAM,GAAG,SAAS,EAC7B,UAAU,GAAE,aAAkB,GAC5B,eAAe,CAyDjB;AAED;;;;;;;;;;;;;;;;;;;;;GAqBG;AACH,wBAAgB,WAAW,CAC1B,KAAK,EAAE,SAAS,EAAE,GAAG,SAAS,GAC5B,SAAS,EAAE,GAAG,SAAS,CAmBzB;AAED;;;;;GAKG;AACH,wBAAsB,2BAA2B,CAChD,KAAK,EAAE,SAAS,EAAE,GAAG,SAAS,GAC5B,OAAO,CAAC,SAAS,EAAE,GAAG,SAAS,CAAC,CAalC;AAED;;;;;GAKG;AACH,wBAAgB,qBAAqB,CACpC,KAAK,EAAE,SAAS,EAAE,GAAG,SAAS,EAC9B,QAAQ,EAAE,OAAO,GACf,SAAS,EAAE,GAAG,SAAS,CAezB;AAED;;;;;GAKG;AACH,wBAAgB,mBAAmB,CAClC,KAAK,EAAE,SAAS,EAAE,GAAG,SAAS,EAC9B,QAAQ,EAAE,OAAO,GACf,SAAS,EAAE,GAAG,SAAS,CAezB;AAED;;;;;;;;;;;;;GAaG;AACH,wBAAsB,oBAAoB,CACzC,IAAI,EAAE,WAAW,EACjB,iBAAiB,EAAE,MAAM,EACzB,UAAU,GAAE,UAAuC,EACnD,SAAS,UAAO,GACd,OAAO,CAAC,WAAW,CAAC,CAgHtB"}