@slkiser/opencode-quota 4.0.1 → 4.1.0

package/dist/lib/provider-metadata.js

@@ -1,257 +1,351 @@
-export const QUOTA_PROVIDER_LABELS = {
-    anthropic: "Anthropic",
-    openai: "OpenAI",
-    copilot: "Copilot",
-    "google-antigravity": "Google",
-    "google-gemini-cli": "Gemini CLI",
-    "google-agy": "Google AGY",
-    synthetic: "Synthetic",
-    chutes: "Chutes",
-    cursor: "Cursor",
-    "qwen-code": "Qwen",
-    "alibaba-coding-plan": "Alibaba Coding Plan",
-    zai: "Z.ai",
-    zhipu: "Zhipu",
-    nanogpt: "NanoGPT",
-    "minimax-coding-plan": "MiniMax Coding Plan",
-    "minimax-china-coding-plan": "MiniMax Coding Plan (CN)",
-    "minimax-cn-coding-plan": "MiniMax Coding Plan (CN)",
-    "kimi-for-coding": "Kimi Code",
-    "kimi-code": "Kimi Code",
-    deepseek: "DeepSeek",
-    "opencode-go": "OpenCode Go",
-    "ollama-cloud": "Ollama Cloud",
-    "quota-providers": "Quota providers",
-};
-export const QUOTA_PROVIDER_ID_SYNONYMS = {
-    "github-copilot": "copilot",
-    "copilot-chat": "copilot",
-    "github-copilot-chat": "copilot",
-    "cursor-acp": "cursor",
-    "open-cursor": "cursor",
-    "@rama_nigg/open-cursor": "cursor",
-    claude: "anthropic",
-    "claude-code": "anthropic",
-    qwen: "qwen-code",
-    alibaba: "alibaba-coding-plan",
-    "nano-gpt": "nanogpt",
-    minimax: "minimax-coding-plan",
-    "minimax-cn": "minimax-china-coding-plan",
-    "minimax-china": "minimax-china-coding-plan",
-    "minimax-cn-coding-plan": "minimax-china-coding-plan",
-    kimi: "kimi-for-coding",
-    "kimi-for-code": "kimi-for-coding",
-    "kimi-code": "kimi-for-coding",
-    "deep-seek": "deepseek",
-    "opencode-go-subscription": "opencode-go",
-    "gemini-cli": "google-gemini-cli",
-    "google-gemini": "google-gemini-cli",
-    "opencode-gemini-auth": "google-gemini-cli",
-    gemini: "google-gemini-cli",
-    "opencode-agy-auth": "google-agy",
-    "google-agy-auth": "google-agy",
-    "glm-coding-plan": "zhipu",
-    "zhipu-coding-plan": "zhipu",
-    "zhipuai-coding-plan": "zhipu",
-};
-export const QUOTA_PROVIDER_RUNTIME_IDS = {
-    anthropic: ["anthropic"],
-    copilot: ["copilot", "github-copilot", "copilot-chat", "github-copilot-chat"],
-    openai: ["openai", "chatgpt", "codex"],
-    cursor: ["cursor", "cursor-acp"],
-    "qwen-code": ["qwen-code"],
-    "alibaba-coding-plan": ["alibaba-coding-plan"],
-    synthetic: ["synthetic"],
-    chutes: ["chutes", "chutes-ai"],
-    "google-antigravity": ["google-antigravity", "google", "antigravity"],
-    "google-gemini-cli": [
-        "google-gemini-cli",
-        "gemini-cli",
-        "gemini",
-        "opencode-gemini-auth",
-        "google",
-    ],
-    "google-agy": ["google-agy", "opencode-agy-auth", "google-agy-auth"],
-    zai: ["zai", "glm", "zai-coding-plan"],
-    zhipu: ["zhipu", "glm-coding-plan", "zhipu-coding-plan", "zhipuai-coding-plan"],
-    nanogpt: ["nanogpt", "nano-gpt"],
-    "minimax-coding-plan": ["minimax-coding-plan", "minimax"],
-    "minimax-china-coding-plan": [
-        "minimax-china-coding-plan",
-        "minimax-cn-coding-plan",
-        "minimax-cn",
-        "minimax-china",
-    ],
-    "kimi-for-coding": ["kimi-for-coding", "kimi", "kimi-code"],
-    deepseek: ["deepseek"],
-    "opencode-go": ["opencode-go"],
-    "ollama-cloud": ["ollama-cloud"],
-    "quota-providers": [],
-};
-const LIVE_LOCAL_USAGE_PROVIDER_ID_SET = new Set([
-    "qwen-code",
-    "alibaba-coding-plan",
-    "cursor",
-]);
-export const QUOTA_PROVIDER_SHAPES = [
-    {
-        id: "anthropic",
-        autoSetup: "needs_quick_setup",
-        authentication: "local_cli_auth",
-        quota: "local_cli_report",
-        quickSetupAnchor: "anthropic-claude",
+const PROVIDER_CATALOG_SOURCE = {
+    anthropic: {
+        label: "Anthropic",
+        runtimeIds: ["anthropic"],
+        synonyms: ["claude", "claude-code"],
+        shape: {
+            autoSetup: "needs_quick_setup",
+            authentication: "local_cli_auth",
+            quota: "local_cli_report",
+            quickSetupAnchor: "anthropic-claude",
+        },
+    },
+    copilot: {
+        label: "Copilot",
+        runtimeIds: ["copilot", "github-copilot", "copilot-chat", "github-copilot-chat"],
+        synonyms: ["github-copilot", "copilot-chat", "github-copilot-chat"],
+        shape: {
+            autoSetup: "usually",
+            authentication: "github_oauth_or_pat",
+            quota: "remote_api",
+            notes: "OAuth for personal flow; PAT for managed billing",
+        },
+    },
+    openai: {
+        label: "OpenAI",
+        runtimeIds: ["openai", "chatgpt", "codex"],
+        synonyms: [],
+        shape: {
+            autoSetup: "yes",
+            authentication: "opencode_auth_oauth_token",
+            quota: "remote_api",
+        },
+    },
+    cursor: {
+        label: "Cursor",
+        runtimeIds: ["cursor", "cursor-acp"],
+        synonyms: ["cursor-acp", "open-cursor", "@rama_nigg/open-cursor"],
+        liveLocalUsage: true,
+        shape: {
+            autoSetup: "needs_quick_setup",
+            authentication: "companion_auth_oauth_token",
+            quota: "local_runtime_accounting",
+            quickSetupAnchor: "cursor",
+            notes: "companion runtime/plugin integration plus local usage accounting",
+        },
     },
-    {
-        id: "copilot",
-        autoSetup: "usually",
-        authentication: "github_oauth_or_pat",
-        quota: "remote_api",
-        notes: "OAuth for personal flow; PAT for managed billing",
+    "qwen-code": {
+        label: "Qwen",
+        runtimeIds: ["qwen-code"],
+        synonyms: ["qwen"],
+        liveLocalUsage: true,
+        shape: {
+            autoSetup: "needs_quick_setup",
+            authentication: "companion_auth_oauth_token",
+            quota: "local_estimation",
+            quickSetupAnchor: "qwen-code",
+        },
     },
-    {
-        id: "openai",
-        autoSetup: "yes",
-        authentication: "opencode_auth_oauth_token",
-        quota: "remote_api",
+    "alibaba-coding-plan": {
+        label: "Alibaba Coding Plan",
+        runtimeIds: ["alibaba-coding-plan"],
+        synonyms: ["alibaba"],
+        liveLocalUsage: true,
+        shape: {
+            autoSetup: "yes",
+            authentication: "opencode_auth_api_key",
+            authFallbacks: ["env_api_key", "global_opencode_config"],
+            quota: "local_estimation",
+        },
     },
-    {
-        id: "cursor",
-        autoSetup: "needs_quick_setup",
-        authentication: "companion_auth_oauth_token",
-        quota: "local_runtime_accounting",
-        quickSetupAnchor: "cursor",
-        notes: "companion runtime/plugin integration plus local usage accounting",
+    synthetic: {
+        label: "Synthetic",
+        runtimeIds: ["synthetic"],
+        synonyms: [],
+        shape: {
+            autoSetup: "yes",
+            authentication: "opencode_auth_api_key",
+            authFallbacks: ["env_api_key", "global_opencode_config"],
+            quota: "remote_api",
+        },
     },
-    {
-        id: "qwen-code",
-        autoSetup: "needs_quick_setup",
-        authentication: "companion_auth_oauth_token",
-        quota: "local_estimation",
-        quickSetupAnchor: "qwen-code",
+    chutes: {
+        label: "Chutes",
+        runtimeIds: ["chutes", "chutes-ai"],
+        synonyms: [],
+        shape: {
+            autoSetup: "usually",
+            authentication: "opencode_auth_api_key",
+            authFallbacks: ["env_api_key", "global_opencode_config"],
+            quota: "remote_api",
+        },
     },
-    {
-        id: "alibaba-coding-plan",
-        autoSetup: "yes",
-        authentication: "opencode_auth_api_key",
-        authFallbacks: ["env_api_key", "global_opencode_config"],
-        quota: "local_estimation",
+    "google-antigravity": {
+        label: "Google",
+        runtimeIds: ["google-antigravity", "google", "antigravity"],
+        synonyms: [],
+        shape: {
+            autoSetup: "needs_quick_setup",
+            authentication: "companion_auth_oauth_token",
+            quota: "remote_api",
+            quickSetupAnchor: "google-antigravity",
+        },
     },
-    {
-        id: "synthetic",
-        autoSetup: "yes",
-        authentication: "opencode_auth_api_key",
-        authFallbacks: ["env_api_key", "global_opencode_config"],
-        quota: "remote_api",
+    "google-gemini-cli": {
+        label: "Gemini CLI",
+        runtimeIds: ["google-gemini-cli", "gemini-cli", "gemini", "opencode-gemini-auth", "google"],
+        synonyms: ["gemini-cli", "google-gemini", "opencode-gemini-auth", "gemini"],
+        shape: {
+            lifecycle: "deprecated",
+            recommendedReplacementId: "google-agy",
+            autoSetup: "needs_quick_setup",
+            authentication: "companion_auth_oauth_token",
+            quota: "remote_api",
+            quickSetupAnchor: "gemini-cli",
+        },
     },
-    {
-        id: "chutes",
-        autoSetup: "usually",
-        authentication: "opencode_auth_api_key",
-        authFallbacks: ["env_api_key", "global_opencode_config"],
-        quota: "remote_api",
+    "google-agy": {
+        label: "Google AGY",
+        runtimeIds: ["google-agy", "opencode-agy-auth", "google-agy-auth"],
+        synonyms: ["opencode-agy-auth", "google-agy-auth"],
+        shape: {
+            autoSetup: "needs_quick_setup",
+            authentication: "companion_auth_oauth_token",
+            quota: "remote_api",
+            quickSetupAnchor: "google-agy-quick-setup",
+        },
     },
-    {
-        id: "google-antigravity",
-        autoSetup: "needs_quick_setup",
-        authentication: "companion_auth_oauth_token",
-        quota: "remote_api",
-        quickSetupAnchor: "google-antigravity",
+    zai: {
+        label: "Z.ai",
+        runtimeIds: ["zai", "glm", "zai-coding-plan"],
+        synonyms: [],
+        shape: {
+            autoSetup: "yes",
+            authentication: "opencode_auth_api_key",
+            authFallbacks: ["env_api_key", "global_opencode_config"],
+            quota: "remote_api",
+        },
     },
-    {
-        id: "google-gemini-cli",
-        autoSetup: "needs_quick_setup",
-        authentication: "companion_auth_oauth_token",
-        quota: "remote_api",
-        quickSetupAnchor: "gemini-cli",
+    zhipu: {
+        label: "Zhipu",
+        runtimeIds: ["zhipu", "glm-coding-plan", "zhipu-coding-plan", "zhipuai-coding-plan"],
+        synonyms: ["glm-coding-plan", "zhipu-coding-plan", "zhipuai-coding-plan"],
+        shape: {
+            autoSetup: "yes",
+            authentication: "opencode_auth_api_key",
+            authFallbacks: ["env_api_key", "global_opencode_config"],
+            quota: "remote_api",
+        },
     },
-    {
-        id: "google-agy",
-        autoSetup: "needs_quick_setup",
-        authentication: "companion_auth_oauth_token",
-        quota: "remote_api",
-        quickSetupAnchor: "google-agy-quick-setup",
+    nanogpt: {
+        label: "NanoGPT",
+        runtimeIds: ["nanogpt", "nano-gpt"],
+        synonyms: ["nano-gpt"],
+        shape: {
+            autoSetup: "usually",
+            authentication: "opencode_auth_api_key",
+            authFallbacks: ["env_api_key", "global_opencode_config"],
+            quota: "remote_api",
+        },
     },
-    {
-        id: "zai",
-        autoSetup: "yes",
-        authentication: "opencode_auth_api_key",
-        authFallbacks: ["env_api_key", "global_opencode_config"],
-        quota: "remote_api",
+    "minimax-coding-plan": {
+        label: "MiniMax Coding Plan",
+        runtimeIds: ["minimax-coding-plan", "minimax"],
+        synonyms: ["minimax"],
+        shape: {
+            autoSetup: "yes",
+            authentication: "opencode_auth_api_key",
+            authFallbacks: ["env_api_key", "global_opencode_config"],
+            quota: "remote_api",
+        },
     },
-    {
-        id: "zhipu",
-        autoSetup: "yes",
-        authentication: "opencode_auth_api_key",
-        authFallbacks: ["env_api_key", "global_opencode_config"],
-        quota: "remote_api",
+    "minimax-china-coding-plan": {
+        label: "MiniMax Coding Plan (CN)",
+        labelAliases: ["minimax-cn-coding-plan"],
+        runtimeIds: [
+            "minimax-china-coding-plan",
+            "minimax-cn-coding-plan",
+            "minimax-cn",
+            "minimax-china",
+        ],
+        synonyms: ["minimax-cn", "minimax-china", "minimax-cn-coding-plan"],
+        shape: {
+            autoSetup: "yes",
+            authentication: "opencode_auth_api_key",
+            authFallbacks: ["env_api_key", "global_opencode_config"],
+            quota: "remote_api",
+        },
     },
-    {
-        id: "nanogpt",
-        autoSetup: "usually",
-        authentication: "opencode_auth_api_key",
-        authFallbacks: ["env_api_key", "global_opencode_config"],
-        quota: "remote_api",
+    "kimi-for-coding": {
+        label: "Kimi Code",
+        labelAliases: ["kimi-code"],
+        runtimeIds: ["kimi-for-coding", "kimi", "kimi-code"],
+        synonyms: ["kimi", "kimi-for-code", "kimi-code"],
+        shape: {
+            autoSetup: "yes",
+            authentication: "opencode_auth_api_key",
+            authFallbacks: ["env_api_key", "global_opencode_config"],
+            quota: "remote_api",
+        },
     },
-    {
-        id: "minimax-coding-plan",
-        autoSetup: "yes",
-        authentication: "opencode_auth_api_key",
-        authFallbacks: ["env_api_key", "global_opencode_config"],
-        quota: "remote_api",
+    deepseek: {
+        label: "DeepSeek",
+        runtimeIds: ["deepseek"],
+        synonyms: ["deep-seek"],
+        shape: {
+            autoSetup: "yes",
+            authentication: "opencode_auth_api_key",
+            authFallbacks: ["env_api_key", "global_opencode_config"],
+            quota: "remote_api",
+        },
     },
-    {
-        id: "minimax-china-coding-plan",
-        autoSetup: "yes",
-        authentication: "opencode_auth_api_key",
-        authFallbacks: ["env_api_key", "global_opencode_config"],
-        quota: "remote_api",
+    xai: {
+        label: "xAI",
+        runtimeIds: ["xai"],
+        synonyms: [],
+        shape: {
+            autoSetup: "yes",
+            authentication: "opencode_auth_oauth_token",
+            quota: "remote_api",
+            notes: "SuperGrok OAuth via OpenCode /connect; shared weekly credit meter",
+        },
     },
-    {
-        id: "kimi-for-coding",
-        autoSetup: "yes",
-        authentication: "opencode_auth_api_key",
-        authFallbacks: ["env_api_key", "global_opencode_config"],
-        quota: "remote_api",
+    xiaomi: {
+        label: "Xiaomi MiMo",
+        runtimeIds: [
+            "xiaomi",
+            "xiaomi-token-plan-cn",
+            "xiaomi-token-plan-ams",
+            "xiaomi-token-plan-sgp",
+        ],
+        synonyms: ["xiaomi-token-plan-cn", "xiaomi-token-plan-ams", "xiaomi-token-plan-sgp"],
+        shape: {
+            autoSetup: "needs_quick_setup",
+            authentication: "state_only",
+            quota: "remote_api",
+            quickSetupAnchor: "xiaomi-mimo",
+            notes: "Reads the Xiaomi MiMo dashboard with a filtered trusted cookie",
+        },
     },
-    {
-        id: "deepseek",
-        autoSetup: "yes",
-        authentication: "opencode_auth_api_key",
-        authFallbacks: ["env_api_key", "global_opencode_config"],
-        quota: "remote_api",
+    "opencode-go": {
+        label: "OpenCode Go",
+        runtimeIds: ["opencode-go"],
+        synonyms: ["opencode-go-subscription"],
+        shape: {
+            autoSetup: "needs_quick_setup",
+            authentication: "state_only",
+            quota: "remote_api",
+            quickSetupAnchor: "opencode-go",
+            notes: "Scrapes the OpenCode Go dashboard; requires workspaceId and authCookie",
+        },
     },
-    {
-        id: "opencode-go",
-        autoSetup: "needs_quick_setup",
-        authentication: "state_only",
-        quota: "remote_api",
-        quickSetupAnchor: "opencode-go",
-        notes: "Scrapes the OpenCode Go dashboard; requires workspaceId and authCookie",
+    opencode: {
+        label: "OpenCode Zen",
+        runtimeIds: ["opencode", "opencode-zen"],
+        synonyms: ["opencode-zen"],
+        shape: {
+            autoSetup: "needs_quick_setup",
+            authentication: "state_only",
+            quota: "remote_api",
+            quickSetupAnchor: "opencode-zen",
+            notes: "Scrapes the OpenCode Zen billing page; requires workspaceId and authCookie",
+        },
     },
-    {
-        id: "ollama-cloud",
-        autoSetup: "manual_env_config",
-        authentication: "state_only",
-        quota: "remote_api",
-        notes: "Scrapes the Ollama Cloud settings page; requires __Secure-session cookie via OLLAMA_USAGE_COOKIE env or ollama-usage config",
+    "ollama-cloud": {
+        label: "Ollama Cloud",
+        runtimeIds: ["ollama-cloud"],
+        synonyms: [],
+        shape: {
+            autoSetup: "manual_env_config",
+            authentication: "state_only",
+            quota: "remote_api",
+            notes: "Scrapes the Ollama Cloud settings page; requires __Secure-session cookie via OLLAMA_USAGE_COOKIE env or ollama-usage config",
+        },
     },
-    {
-        id: "quota-providers",
-        autoSetup: "manual_env_config",
-        authentication: "external_api_key",
-        authFallbacks: ["env_api_key", "global_opencode_config"],
-        quota: "remote_api",
-        notes: "Aggregates exact user-configured accounting sources",
+    "quota-providers": {
+        label: "Quota providers",
+        runtimeIds: [],
+        synonyms: [],
+        shape: {
+            autoSetup: "manual_env_config",
+            authentication: "external_api_key",
+            authFallbacks: ["env_api_key", "global_opencode_config"],
+            quota: "remote_api",
+            notes: "Aggregates exact user-configured accounting sources",
+        },
     },
-];
-const QUOTA_PROVIDER_SHAPES_BY_ID = Object.fromEntries(QUOTA_PROVIDER_SHAPES.map((shape) => [shape.id, shape]));
+};
+function catalogKeys() {
+    return Object.keys(PROVIDER_CATALOG_SOURCE);
+}
+function isCanonicalQuotaProviderId(value) {
+    return value in PROVIDER_CATALOG_SOURCE;
+}
+function buildProviderShape(id, source) {
+    const { recommendedReplacementId, authFallbacks, ...shape } = source.shape;
+    let replacementId;
+    if (recommendedReplacementId) {
+        if (!isCanonicalQuotaProviderId(recommendedReplacementId)) {
+            throw new Error(`Unknown quota provider replacement: ${recommendedReplacementId}`);
+        }
+        replacementId = recommendedReplacementId;
+    }
+    return {
+        id,
+        ...shape,
+        ...(replacementId ? { recommendedReplacementId: replacementId } : {}),
+        ...(authFallbacks ? { authFallbacks: [...authFallbacks] } : {}),
+    };
+}
+function completeCatalogRecord(entries) {
+    const record = {};
+    for (const [id, value] of entries)
+        record[id] = value;
+    return record;
+}
+export const QUOTA_PROVIDER_CATALOG = completeCatalogRecord(catalogKeys().map((id) => {
+    const source = PROVIDER_CATALOG_SOURCE[id];
+    return [
+        id,
+        {
+            label: source.label,
+            labelAliases: [...("labelAliases" in source ? source.labelAliases : [])],
+            runtimeIds: [...source.runtimeIds],
+            synonyms: [...source.synonyms],
+            shape: buildProviderShape(id, source),
+        },
+    ];
+}));
+export const QUOTA_PROVIDER_LABELS = Object.fromEntries(catalogKeys().flatMap((id) => {
+    const entry = QUOTA_PROVIDER_CATALOG[id];
+    return [[id, entry.label], ...entry.labelAliases.map((alias) => [alias, entry.label])];
+}));
+export const QUOTA_PROVIDER_ID_SYNONYMS = Object.fromEntries(catalogKeys().flatMap((id) => QUOTA_PROVIDER_CATALOG[id].synonyms.map((synonym) => [synonym, id])));
+export const QUOTA_PROVIDER_RUNTIME_IDS = completeCatalogRecord(catalogKeys().map((id) => [id, QUOTA_PROVIDER_CATALOG[id].runtimeIds]));
+export const QUOTA_PROVIDER_SHAPES = catalogKeys().map((id) => QUOTA_PROVIDER_CATALOG[id].shape);
+const LIVE_LOCAL_USAGE_PROVIDER_ID_SET = new Set(catalogKeys().filter((id) => {
+    const source = PROVIDER_CATALOG_SOURCE[id];
+    return "liveLocalUsage" in source && source.liveLocalUsage === true;
+}));
 export function normalizeQuotaProviderId(id) {
     const normalized = id.trim().toLowerCase();
     return QUOTA_PROVIDER_ID_SYNONYMS[normalized] ?? normalized;
 }
 export function getQuotaProviderShape(id) {
     const normalized = normalizeQuotaProviderId(id);
-    return QUOTA_PROVIDER_SHAPES_BY_ID[normalized];
+    return isCanonicalQuotaProviderId(normalized)
+        ? QUOTA_PROVIDER_CATALOG[normalized].shape
+        : undefined;
 }
 export function getQuotaProviderDisplayLabel(id) {
     const normalized = normalizeQuotaProviderId(id);