@kenkaiiii/gg-core 5.81.0 → 5.83.0

package/dist/model-registry.d.cts

@@ -64,10 +64,35 @@ interface ModelInfo {
      *     every MiMo model, so a Credits-only user still reaches these).
      *   - `mimo-v2.6-pro-ultraspeed`: `[XIAOMI_CREDITS_KEY]` only — not served
      *     over the Token Plan endpoint, so there's no fallback to it.
+     *   - every Gemini model: `[GEMINI_API_KEY, "gemini"]` — an AI Studio API key
+     *     first (the user chose to pay per token, and Code Assist OAuth now
+     *     refuses personal accounts), then the Code Assist OAuth login.
      * Falls back to `[provider]` — the normal single-credential case — when
      * unset. Read via `getAuthStorageKeys()` / `getAuthStorageKey()`.
      */
     authStorageKeys?: string[];
+    /**
+     * How this model bills beyond the normal plan/API rate, shown wherever the
+     * model is picked or active. Only set where picking the model changes what
+     * the user pays: `paid` marks real money (Claude fast mode bills usage
+     * credits, never included plan usage), unset `paid` a plan-usage multiplier.
+     */
+    billing?: ModelBilling;
+}
+interface ModelBilling {
+    /** Short picker label, e.g. "bills usage credits". */
+    label: string;
+    /** One-sentence explanation for tooltips and notes. */
+    detail: string;
+    /** True when choosing the model spends real money, not just plan allowance. */
+    paid: boolean;
+    /**
+     * The same-provider model to run instead wherever a paid tier must not be
+     * carried silently (saved defaults, restored sessions, Ken, sub-agents, goal
+     * workers). Required when `paid` is true; registry tests enforce that it is
+     * registered, same-provider and itself not paid.
+     */
+    standardModel?: string;
 }
 declare const MODELS: ModelInfo[];
 /** Add (or replace) runtime-discovered models. Later registrations win by id. */
@@ -81,6 +106,21 @@ declare function clearRuntimeModels(predicate?: (model: ModelInfo) => boolean):
 declare function getAllModels(): ModelInfo[];
 declare function getModel(id: string): ModelInfo | undefined;
 declare function getModelsForProvider(provider: Provider): ModelInfo[];
+/** True when running `modelId` spends real money (Claude fast mode, MiMo UltraSpeed). */
+declare function isPaidModel(modelId: string): boolean;
+/**
+ * The model to run instead of a paid tier: its `billing.standardModel`
+ * (`claude-opus-5-5-fast` → `claude-opus-5-5`, `mimo-v2.6-pro-ultraspeed` →
+ * `mimo-v2.6-pro`); every unpaid id is returned unchanged. A paid tier must be
+ * picked on purpose for the one session the user is watching, so everything
+ * that would otherwise carry it silently (saved defaults, restored sessions,
+ * Ken following GG, sub-agents, goal workers) runs through this instead.
+ *
+ * Fails closed: when the standard model is missing, unregistered or itself
+ * paid, it falls back to the provider's default, then the global default —
+ * never to the paid id.
+ */
+declare function withoutPaidTier(modelId: string): string;
 /**
  * Ordered auth-storage keys to try resolving credentials from for
  * `(provider, model)`, first match wins. Almost every model just uses its
@@ -147,4 +187,4 @@ declare function getDefaultThinkingLevel(modelId: string, options?: {
  */
 declare function getSummaryModel(provider: Provider, currentModelId: string): ModelInfo;
 
-export { type ContextWindowOptions, DEFAULT_MAX_VIDEO_BYTES, MODELS, type ModelInfo, clearRuntimeModels, getAllModels, getAuthStorageKey, getAuthStorageKeys, getContextWindow, getDefaultModel, getDefaultThinkingLevel, getMaxThinkingLevel, getModel, getModelsForProvider, getSummaryModel, getToolResultCharLimit, getVideoByteLimit, registerRuntimeModels, usesOpenAICodexTransport };
+export { type ContextWindowOptions, DEFAULT_MAX_VIDEO_BYTES, MODELS, type ModelBilling, type ModelInfo, clearRuntimeModels, getAllModels, getAuthStorageKey, getAuthStorageKeys, getContextWindow, getDefaultModel, getDefaultThinkingLevel, getMaxThinkingLevel, getModel, getModelsForProvider, getSummaryModel, getToolResultCharLimit, getVideoByteLimit, isPaidModel, registerRuntimeModels, usesOpenAICodexTransport, withoutPaidTier };

package/dist/model-registry.d.ts

@@ -64,10 +64,35 @@ interface ModelInfo {
      *     every MiMo model, so a Credits-only user still reaches these).
      *   - `mimo-v2.6-pro-ultraspeed`: `[XIAOMI_CREDITS_KEY]` only — not served
      *     over the Token Plan endpoint, so there's no fallback to it.
+     *   - every Gemini model: `[GEMINI_API_KEY, "gemini"]` — an AI Studio API key
+     *     first (the user chose to pay per token, and Code Assist OAuth now
+     *     refuses personal accounts), then the Code Assist OAuth login.
      * Falls back to `[provider]` — the normal single-credential case — when
      * unset. Read via `getAuthStorageKeys()` / `getAuthStorageKey()`.
      */
     authStorageKeys?: string[];
+    /**
+     * How this model bills beyond the normal plan/API rate, shown wherever the
+     * model is picked or active. Only set where picking the model changes what
+     * the user pays: `paid` marks real money (Claude fast mode bills usage
+     * credits, never included plan usage), unset `paid` a plan-usage multiplier.
+     */
+    billing?: ModelBilling;
+}
+interface ModelBilling {
+    /** Short picker label, e.g. "bills usage credits". */
+    label: string;
+    /** One-sentence explanation for tooltips and notes. */
+    detail: string;
+    /** True when choosing the model spends real money, not just plan allowance. */
+    paid: boolean;
+    /**
+     * The same-provider model to run instead wherever a paid tier must not be
+     * carried silently (saved defaults, restored sessions, Ken, sub-agents, goal
+     * workers). Required when `paid` is true; registry tests enforce that it is
+     * registered, same-provider and itself not paid.
+     */
+    standardModel?: string;
 }
 declare const MODELS: ModelInfo[];
 /** Add (or replace) runtime-discovered models. Later registrations win by id. */
@@ -81,6 +106,21 @@ declare function clearRuntimeModels(predicate?: (model: ModelInfo) => boolean):
 declare function getAllModels(): ModelInfo[];
 declare function getModel(id: string): ModelInfo | undefined;
 declare function getModelsForProvider(provider: Provider): ModelInfo[];
+/** True when running `modelId` spends real money (Claude fast mode, MiMo UltraSpeed). */
+declare function isPaidModel(modelId: string): boolean;
+/**
+ * The model to run instead of a paid tier: its `billing.standardModel`
+ * (`claude-opus-5-5-fast` → `claude-opus-5-5`, `mimo-v2.6-pro-ultraspeed` →
+ * `mimo-v2.6-pro`); every unpaid id is returned unchanged. A paid tier must be
+ * picked on purpose for the one session the user is watching, so everything
+ * that would otherwise carry it silently (saved defaults, restored sessions,
+ * Ken following GG, sub-agents, goal workers) runs through this instead.
+ *
+ * Fails closed: when the standard model is missing, unregistered or itself
+ * paid, it falls back to the provider's default, then the global default —
+ * never to the paid id.
+ */
+declare function withoutPaidTier(modelId: string): string;
 /**
  * Ordered auth-storage keys to try resolving credentials from for
  * `(provider, model)`, first match wins. Almost every model just uses its
@@ -147,4 +187,4 @@ declare function getDefaultThinkingLevel(modelId: string, options?: {
  */
 declare function getSummaryModel(provider: Provider, currentModelId: string): ModelInfo;
 
-export { type ContextWindowOptions, DEFAULT_MAX_VIDEO_BYTES, MODELS, type ModelInfo, clearRuntimeModels, getAllModels, getAuthStorageKey, getAuthStorageKeys, getContextWindow, getDefaultModel, getDefaultThinkingLevel, getMaxThinkingLevel, getModel, getModelsForProvider, getSummaryModel, getToolResultCharLimit, getVideoByteLimit, registerRuntimeModels, usesOpenAICodexTransport };
+export { type ContextWindowOptions, DEFAULT_MAX_VIDEO_BYTES, MODELS, type ModelBilling, type ModelInfo, clearRuntimeModels, getAllModels, getAuthStorageKey, getAuthStorageKeys, getContextWindow, getDefaultModel, getDefaultThinkingLevel, getMaxThinkingLevel, getModel, getModelsForProvider, getSummaryModel, getToolResultCharLimit, getVideoByteLimit, isPaidModel, registerRuntimeModels, usesOpenAICodexTransport, withoutPaidTier };

package/dist/model-registry.js

@@ -14,9 +14,11 @@ import {
   getSummaryModel,
   getToolResultCharLimit,
   getVideoByteLimit,
+  isPaidModel,
   registerRuntimeModels,
-  usesOpenAICodexTransport
-} from "./chunk-BNMQ6VWC.js";
+  usesOpenAICodexTransport,
+  withoutPaidTier
+} from "./chunk-JJED477O.js";
 import "./chunk-EAIPT76S.js";
 export {
   DEFAULT_MAX_VIDEO_BYTES,
@@ -34,7 +36,9 @@ export {
   getSummaryModel,
   getToolResultCharLimit,
   getVideoByteLimit,
+  isPaidModel,
   registerRuntimeModels,
-  usesOpenAICodexTransport
+  usesOpenAICodexTransport,
+  withoutPaidTier
 };
 //# sourceMappingURL=model-registry.js.map

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@kenkaiiii/gg-core",
-  "version": "5.81.0",
+  "version": "5.83.0",
   "type": "module",
   "description": "Provider-agnostic, UI-free shared foundation: model registry, auth, paths, telegram, voice",
   "license": "MIT",
@@ -36,7 +36,7 @@
     "dist"
   ],
   "dependencies": {
-    "@kenkaiiii/gg-ai": "5.81.0"
+    "@kenkaiiii/gg-ai": "5.83.0"
   },
   "optionalDependencies": {
     "@huggingface/transformers": "4.2.0",