@genex-ai/embed-sdk 0.21.1 → 0.22.1

package/README.md

@@ -47,7 +47,7 @@ trusted Genex parent to show its modal. Native WebViews and local-test identity
 return `native_unsupported` and `local_test_unsupported` until they have supported
 confirmation surfaces.
 
-`GenerateOptions` requires `estimateCoins` (an integer from 0 to 1,000,000), `modelId`, `prompt`, `outputFormat: 'text' | 'json'`,
+`GenerateOptions` requires `estimateCoins` (an integer from 1 to 1,000,000 for an API-backed selection), `modelId`, `prompt`, `outputFormat: 'text' | 'json'`,
 optional bounded `schema`, `allowExternal` (default false), `idempotencyKey` and
 `timeoutMs` (default ten minutes). Reuse an idempotency key only for the same
 operation; store it if you need retries to survive a reload. Only models returned
@@ -75,8 +75,10 @@ the frozen request before approval. New public quotes carry
 is the developer-declared **fixed price of a started attempt**: declaring 5 coins
 charges 5 even when actual usage would cost 2. Failure, cancellation or reaching
 the budget limit after work starts also charges the full price; a usable result
-is not guaranteed. No model work means zero charge. Zero is accepted only for a
-server-authorized free or personal-only option.
+is not guaranteed. No model work means zero charge; an unsuccessful attempt with
+verified zero model cost is also uncharged. Every Genex API model
+requires a positive price, including Gemini and GLM. Personal funding chosen in
+the trusted approval modal remains zero coin.
 
 The provider hard budget is derived from that price after the frozen platform
 tariff, then capped by operator limits. Output is clipped to remaining funding;
@@ -85,6 +87,9 @@ keeps billing pending and the reservation held until verified. The trusted UI
 must acknowledge the quote's exact `billingPolicy` at confirmation; an old UI
 cannot approve new terms. Previously issued `consumed-v1` quotes keep actual-
 usage billing and quotes without a policy keep their original promise.
+Already-approved zero-price API requests retain their saved terms. An old
+unconfirmed zero-price API quote needs a fresh price review before coin approval;
+never silently replace its price or start a paid request during recovery.
 
 With `allowExternal: true`, Genex can offer the configured personal plan matching
 the selected model alongside coins: Claude for `anthropic/` models, ChatGPT for
@@ -115,7 +120,7 @@ import { getWorkflowOfferings, requestWorkflow, getEmbedToken } from '@genex-ai/
 
 // Load from this game's registered workflow before enabling the model picker.
 const catalog = await getWorkflowOfferings(configuredWorkflowId);
-// Public offerings contain API/model rows, including sponsored free models.
+// Public offerings contain paid API/model rows.
 // Personal plan funding is offered only by the trusted Genex approval modal.
 // Keep the complete selected offering: availability, funding, model and prices.
 renderModelPicker(catalog.offerings);
@@ -179,9 +184,11 @@ Legacy quotes without `billingPolicy` retain their original fixed-price and
 refund terms. Never replace a saved quote's policy with the current catalog's
 policy, infer a missing multiplier, or reprice an approved operation.
 
-The designated `google/gemini-3.8-flash` and `z-ai/glm-5.3-flash` offerings
-cost **0 coins**. Personal Claude/ChatGPT funding choices in the Genex approval
-modal also cost **0 coins** and use the player's own account through Genex-owned
+All API-backed Genex offerings are paid, including `google/gemini-3.8-flash` and
+`z-ai/glm-5.3-flash`. Airena's free access to those models is game-funded through
+its own direct OpenRouter path, outside the Genex runtime API.
+Personal Claude/ChatGPT funding choices in the Genex approval modal cost
+**0 coins** and use the player's own account through Genex-owned
 MCP connectors. Claude uses `/player/mcp`; ChatGPT uses `/player/chatgpt/mcp`.
 ChatGPT connector availability depends on account and workspace policy. One
 external request may be active per player across both providers. Follow the
@@ -191,7 +198,7 @@ Submitted results remain user-supplied; the executor must validate them before
 delivery. Both APIs restrict personal funding to the selected model's provider.
 
 These workflow endpoints still require signed-in production play, including
-zero-coin offerings. Airena's existing sponsored free guest path is separate;
+personal funding. Airena's sponsored direct guest path is separate;
 do not weaken the workflow's player/session checks to reproduce it.
 
 The [runtime API contract](../../CLI_INTEGRATION.md#10-player-funded-runtime-generation)
@@ -209,8 +216,8 @@ the subpath is disabled for browser resolution and rejects browser execution.
 
 `maxCoins` is an explicit positive maximum from your own wallet. Development
 uses `consumed-v1`: actual model usage at the frozen normal tariff, including
-failed usage, up to that maximum. Public-sponsored Gemini/GLM models also use
-this normal paid tariff when benchmarking. Actual zero cost is zero coin;
+failed usage, up to that maximum. Gemini/GLM models use this normal paid tariff
+too. Actual zero cost is zero coin;
 unknown expense remains held. No personal or paid fallback occurs.
 
 ```ts

package/dist/{chunk-CKFZQ7AP.js → chunk-PXHBV67S.js}

@@ -298,7 +298,7 @@ var RETRY_FLAG = "genex:embed:retry";
 var POPOVER_DISMISSED_FLAG = "genex:guest:popover-dismissed";
 var LOCAL_AUTH_FLAG = "genex:embed:local-auth";
 var PLAYER_ID_KEY = "genex:player";
-var SDK_VERSION = "0.21.1";
+var SDK_VERSION = "0.22.1";
 var config2 = null;
 var state = "pending";
 var user = null;

package/dist/index.js

@@ -28,7 +28,7 @@ import {
   waitForAuth,
   waitForGeneration,
   waitForPlayer
-} from "./chunk-CKFZQ7AP.js";
+} from "./chunk-PXHBV67S.js";
 import "./chunk-Q476GJHI.js";
 export {
   __resetForTests,

package/dist/sentry.js

@@ -2,7 +2,7 @@ import {
   _stashTicketFromUrl,
   getUser,
   on
-} from "./chunk-CKFZQ7AP.js";
+} from "./chunk-PXHBV67S.js";
 import "./chunk-Q476GJHI.js";
 
 // src/sentry.ts

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@genex-ai/embed-sdk",
-  "version": "0.21.1",
+  "version": "0.22.1",
   "description": "Player identity + durable game state for genex games — signed-in or guest play, per-player save slots, shared world state, and soft-trust leaderboards.",
   "type": "module",
   "main": "./dist/index.js",