@bnbagent/studio-cli 0.0.13-alpha.3 → 0.0.13-alpha.5

package/README.md

@@ -253,7 +253,7 @@ When multiple deployments exist, select the provider explicitly for logs, verifi
 ERC-8183 uses the 18-decimal testnet **U** token. tBNB pays fallback gas; it is not the escrow currency.
 
 1. Run `bag wallet show` and copy the agent wallet address.
-2. Claim ERC-8183 testnet U from <https://united-coin-u.github.io/u-faucet/>.
+2. Claim ERC-8183 testnet U by messaging the official Telegram bot <https://t.me/bnbchain_official_bot> — send `I would like to get U to my wallet <address>`. More options: <https://united-coin-u.github.io/u-faucet/>.
 3. Claim tBNB by messaging the official Telegram bot <https://t.me/bnbchain_official_bot> — send `I would like to get tBNB to my wallet <address>` (up to 0.3 tBNB/day). More options: <https://docs.bnbchain.org/bnb-smart-chain/developers/faucet/>.
 4. Run `bag wallet balance --all` and `bag doctor` before testing paid work.
 

package/dist/bag.js

@@ -55,7 +55,7 @@ import {
   x402SellerIsFree,
   x402SellerPricingState,
   x402SellerUsesB402
-} from "./chunk-E4C75NSV.js";
+} from "./chunk-BCUJGB4Y.js";
 import {
   TWAK_CLI_MIN_VERSION,
   TWAK_CLI_VERSION,
@@ -233,7 +233,7 @@ import {
 var CAMPAIGN_DOC_URL = "https://www.bnbchain.org/en/blog/bnb-agent-studio-is-live-on-bnb-chain-ai-agents-from-one-prompt";
 var CAMPAIGN_CHECK_TIMEOUT_MS = 6e3;
 async function fetchCampaignActive() {
-  const { bnbPlatformApiUrl: bnbPlatformApiUrl2 } = await import("./deployCli-UOUCOIW5.js");
+  const { bnbPlatformApiUrl: bnbPlatformApiUrl2 } = await import("./deployCli-2YVGILHK.js");
   const controller = new AbortController();
   const timer = setTimeout(() => controller.abort(), CAMPAIGN_CHECK_TIMEOUT_MS);
   try {
@@ -3420,7 +3420,11 @@ function relocateKeys(src, target, label) {
 import * as fs23 from "fs";
 import * as os4 from "os";
 import * as path22 from "path";
-import { getNetwork as getNetwork6 } from "@bnbagent/studio-runtime/networks";
+import {
+  getNetwork as getNetwork6,
+  tbnbFaucetHint as tbnbFaucetHint3,
+  uFaucetHint as uFaucetHint3
+} from "@bnbagent/studio-runtime/networks";
 import { ensureTwakKeychain } from "@bnbagent/studio-runtime/wallet";
 import { Option as Option2 } from "commander";
 import { parse as parseToml } from "smol-toml";
@@ -4996,9 +5000,9 @@ import { generateText } from "ai";
 
 // src/cli/_pieverseHelpers.ts
 import {
-  BSC_TESTNET_U_FAUCET_URL,
   fromRaw as fromRaw2,
-  getNetwork as getNetwork3
+  getNetwork as getNetwork3,
+  uFaucetHint
 } from "@bnbagent/studio-runtime/networks";
 import {
   siweLogin
@@ -5052,7 +5056,7 @@ function printUBalanceShortfall(walletAddress, currentRaw, neededRaw, neededUsd,
       `  swap on PancakeSwap: https://pancakeswap.finance/swap?outputCurrency=${u.address}`
     );
   } else {
-    printErr(`  testnet U faucet: ${BSC_TESTNET_U_FAUCET_URL}`);
+    printErr(`  testnet U faucet: ${uFaucetHint(walletAddress)}`);
   }
 }
 function writeEnvLocal(key, value, envPath = ".env.local") {
@@ -6836,7 +6840,7 @@ import {
   findProjectRoot as findProjectRoot3,
   loadStudioToml as loadStudioToml10
 } from "@bnbagent/studio-runtime/config";
-import { tbnbFaucetHint as tbnbFaucetHint2 } from "@bnbagent/studio-runtime/networks";
+import { tbnbFaucetHint as tbnbFaucetHint2, uFaucetHint as uFaucetHint2 } from "@bnbagent/studio-runtime/networks";
 import { buildPolicy, buildWallet } from "@bnbagent/studio-runtime/wallet";
 import { getAddress as toChecksumAddress } from "viem";
 
@@ -7433,7 +7437,9 @@ function projectNetwork(projectRoot) {
 }
 function printNextAfterNew(projectRoot, address) {
   const network = projectNetwork(projectRoot);
-  const fund = network === "bsc-testnet" ? `fund it (free, only needed for paid models / on-chain settle): ${tbnbFaucetHint2(address)}` : "fund it with BNB (gas) + U before selling paid work";
+  const fund = network === "bsc-testnet" ? `fund it (free, only needed for paid models / on-chain settle):
+      tBNB: ${tbnbFaucetHint2(address)}
+      U: ${uFaucetHint2(address)}` : "fund it with BNB (gas) + U before selling paid work";
   printErr(
     `Next: ${fund}
       then \`bag doctor\` to verify the project, \`bag dev\` to run it locally.`
@@ -9980,8 +9986,9 @@ async function printFaucetHint(network, address) {
   if (network === "bsc-testnet") {
     const {
       BSC_TESTNET_TBNB_TELEGRAM_FAUCET: BSC_TESTNET_TBNB_TELEGRAM_FAUCET2,
+      BSC_TESTNET_U_TELEGRAM_FAUCET,
       BSC_TESTNET_FAUCET_DOCS_URL: BSC_TESTNET_FAUCET_DOCS_URL2,
-      BSC_TESTNET_U_FAUCET_URL: BSC_TESTNET_U_FAUCET_URL4
+      BSC_TESTNET_U_FAUCET_URL: BSC_TESTNET_U_FAUCET_URL2
     } = await import("@bnbagent/studio-runtime/networks");
     printOut(`Your testnet wallet address: ${address}`);
     printOut("Fund it (free):");
@@ -9993,7 +10000,11 @@ async function printFaucetHint(network, address) {
     );
     printOut("         (up to 0.3 tBNB per day; it replies with the tx hash)");
     printOut(`         more ways to get tBNB: ${BSC_TESTNET_FAUCET_DOCS_URL2}`);
-    printOut(`  $U   \u2014 ${BSC_TESTNET_U_FAUCET_URL4}`);
+    printOut(
+      `  $U   \u2014 message the official Telegram bot ${BSC_TESTNET_U_TELEGRAM_FAUCET}`
+    );
+    printOut(`         send: "I would like to get U to my wallet ${address}"`);
+    printOut(`         more ways to get U: ${BSC_TESTNET_U_FAUCET_URL2}`);
     printOut("(Faucets are needed only for paid models / on-chain settle.");
     printOut(" The default `auto/free` LLM model and AgentCore deploy");
     printOut(" do NOT require any funds.)");
@@ -10790,9 +10801,8 @@ function printNextSteps(name, provider, o = {}) {
     printOut(
       `  # ${nextStep}. (optional) fund the wallet \u2014 only when you need paid model / deploy / publish:`
     );
-    printOut(
-      "  #    testnet:  send testnet BNB (gas) + testnet U to the address above"
-    );
+    printOut(`  #    testnet tBNB: ${tbnbFaucetHint3()}`);
+    printOut(`  #    testnet U:    ${uFaucetHint3()}`);
     printOut("  #    mainnet:  swap a small amount via PancakeSwap:");
     printOut(
       "  #              https://pancakeswap.finance/swap?outputCurrency=0xcE24439F2D9C6a2289F741120FE202248B666666"
@@ -14038,7 +14048,9 @@ import {
 import {
   BSC_TESTNET_FAUCET_DOCS_URL,
   BSC_TESTNET_TBNB_TELEGRAM_FAUCET,
-  BSC_TESTNET_U_FAUCET_URL as BSC_TESTNET_U_FAUCET_URL2
+  BSC_TESTNET_U_FAUCET_URL,
+  tbnbFaucetHint as tbnbFaucetHint5,
+  uFaucetHint as uFaucetHint5
 } from "@bnbagent/studio-runtime/networks";
 
 // src/cli/_deploy/checks/warning.ts
@@ -14047,7 +14059,12 @@ import * as fs33 from "fs";
 import * as path32 from "path";
 import { envLocalPath as envLocalPath15 } from "@bnbagent/studio-runtime/config";
 import { show } from "@bnbagent/studio-runtime/erc8004";
-import { DEFAULT_RPC, getNetwork as getNetwork8 } from "@bnbagent/studio-runtime/networks";
+import {
+  DEFAULT_RPC,
+  getNetwork as getNetwork8,
+  tbnbFaucetHint as tbnbFaucetHint4,
+  uFaucetHint as uFaucetHint4
+} from "@bnbagent/studio-runtime/networks";
 import * as walletRt3 from "@bnbagent/studio-runtime/wallet";
 var TBNB_MIN_WEI = 7n * 10n ** 15n;
 function isFile14(p) {
@@ -14063,11 +14080,12 @@ async function checkWalletBalancesAllZero(root, _target) {
     return [];
   }
   if (bals.bnbWei === 0n && bals.uRaw === 0n) {
+    const fundingHint = bals.network === "bsc-testnet" ? `; tBNB: ${tbnbFaucetHint4(bals.address)}; U: ${uFaucetHint4(bals.address)}` : "";
     return [
       {
         level: Level.WARNING,
         name: "wallet_balances_all_zero",
-        message: `wallet ${bals.address} has 0 BNB and 0 U on ${bals.network}; fund it when you need a paid LLM model or on-chain settle (AgentCore deploy + auto/free model don't require funds)`,
+        message: `wallet ${bals.address} has 0 BNB and 0 U on ${bals.network}; fund it when you need a paid LLM model or on-chain settle (AgentCore deploy + auto/free model don't require funds)${fundingHint}`,
         details: {
           address: bals.address,
           network: bals.network,
@@ -14129,11 +14147,12 @@ async function checkWalletUBalanceNonzero(root, _target) {
   if (bal === null || bal !== 0n) {
     return [];
   }
+  const fundingHint = netName === "bsc-testnet" ? `; ${uFaucetHint4(address)}` : "";
   return [
     {
       level: Level.WARNING,
       name: "wallet_u_balance_nonzero",
-      message: `wallet ${address} has 0 U on ${netName}; buyer/seller flows will fail without funded U balance`,
+      message: `wallet ${address} has 0 U on ${netName}; buyer/seller flows will fail without funded U balance${fundingHint}`,
       details: { address, balance_raw: 0, network: netName }
     }
   ];
@@ -14516,12 +14535,12 @@ var checkPlatformFundingHint = async (_root, _target) => [
   {
     level: Level.INFO,
     name: "platform_funding_hint",
-    message: `testnet trial \u2014 keep a little tBNB for gas and testnet $U for commerce. tBNB: message ${BSC_TESTNET_TBNB_TELEGRAM_FAUCET} (more options: ${BSC_TESTNET_FAUCET_DOCS_URL}) \xB7 $U: ${BSC_TESTNET_U_FAUCET_URL2}`,
+    message: `testnet trial \u2014 keep a little tBNB for gas and testnet $U for commerce. tBNB: ${tbnbFaucetHint5()} \xB7 $U: ${uFaucetHint5()}`,
     details: {
       faucets: [
         BSC_TESTNET_TBNB_TELEGRAM_FAUCET,
         BSC_TESTNET_FAUCET_DOCS_URL,
-        BSC_TESTNET_U_FAUCET_URL2
+        BSC_TESTNET_U_FAUCET_URL
       ]
     }
   }
@@ -18303,11 +18322,11 @@ import {
   BSC_MAINNET_MIN_U,
   BSC_TESTNET_MIN_BNB,
   BSC_TESTNET_MIN_U,
-  BSC_TESTNET_U_FAUCET_URL as BSC_TESTNET_U_FAUCET_URL3,
   ERC8183_SUBMIT_GAS_RESERVE_BNB,
   fromRaw as fromRaw4,
   getNetwork as getNetwork9,
-  tbnbFaucetHint as tbnbFaucetHint3
+  tbnbFaucetHint as tbnbFaucetHint6,
+  uFaucetHint as uFaucetHint6
 } from "@bnbagent/studio-runtime/networks";
 import { listModels as listModels2 } from "@bnbagent/studio-runtime/pieverse";
 import * as walletRt5 from "@bnbagent/studio-runtime/wallet";
@@ -19509,8 +19528,8 @@ async function checkBalances(projectRoot, data, networkOverride) {
     const isMainnet = name === "bsc-mainnet";
     const minBnb = isTestnet ? BSC_TESTNET_MIN_BNB : isMainnet ? BSC_MAINNET_MIN_BNB : 0;
     const minBnbWei = BigInt(Math.round(minBnb * 1e6)) * 10n ** 12n;
-    const bnbFaucetHint = isTestnet ? ` \u2014 ${tbnbFaucetHint3(address)}` : "";
-    const uFaucetHint = isTestnet ? ` \u2014 $U faucet: ${BSC_TESTNET_U_FAUCET_URL3}` : "";
+    const bnbFaucetHint = isTestnet ? ` \u2014 ${tbnbFaucetHint6(address)}` : "";
+    const uFundingHint = isTestnet ? ` \u2014 ${uFaucetHint6(address)}` : "";
     const bnbRaw = await readNativeBalanceRaw(address, name);
     const reserve = ERC8183_SUBMIT_GAS_RESERVE_BNB;
     const reserveHint = ` (each on-chain action reserves \u2248 ${reserve} BNB worst-case)`;
@@ -19557,7 +19576,7 @@ async function checkBalances(projectRoot, data, networkOverride) {
       out.push({
         name: "wallet U balance",
         status: WARN,
-        detail: `${uRaw} raw @ ${address} \u2014 need \u2265 ${minU} U on ${name} for one auto-topup chunk${uFaucetHint}`
+        detail: `${uRaw} raw @ ${address} \u2014 need \u2265 ${minU} U on ${name} for one auto-topup chunk${uFundingHint}`
       });
     }
     return out;
@@ -19992,7 +20011,7 @@ import {
 import {
   fromRaw as fromRaw5,
   getNetwork as getNetwork10,
-  tbnbFaucetHint as tbnbFaucetHint4
+  tbnbFaucetHint as tbnbFaucetHint7
 } from "@bnbagent/studio-runtime/networks";
 import * as walletRt6 from "@bnbagent/studio-runtime/wallet";
 import { Option as Option5 } from "commander";
@@ -20154,7 +20173,7 @@ async function precheckRegisterGas(wallet, network) {
   if (balance >= REGISTER_MIN_BNB) {
     return null;
   }
-  return `ERC-8004 register needs gas to broadcast, but ${wallet.address} holds only ${balance} BNB on ${network} (need ~${REGISTER_MIN_BNB}). Fund a little tBNB and retry \u2014 ${tbnbFaucetHint4(wallet.address)}`;
+  return `ERC-8004 register needs gas to broadcast, but ${wallet.address} holds only ${balance} BNB on ${network} (need ~${REGISTER_MIN_BNB}). Fund a little tBNB and retry \u2014 ${tbnbFaucetHint7(wallet.address)}`;
 }
 function syncAgentRegistry(agentId, op) {
   try {

package/dist/{chunk-E4C75NSV.js → chunk-BCUJGB4Y.js}

@@ -791,8 +791,8 @@ function packageRoot() {
   }
 }
 function studioCliVersion() {
-  if ("0.0.13-alpha.3") {
-    return "0.0.13-alpha.3";
+  if ("0.0.13-alpha.5") {
+    return "0.0.13-alpha.5";
   }
   const file = path3.join(packageRoot(), "package.json");
   const pkg = JSON.parse(fs3.readFileSync(file, "utf-8"));

package/dist/{deployCli-UOUCOIW5.js → deployCli-2YVGILHK.js}

@@ -18,7 +18,7 @@ import {
   runPlatformAccountCommand,
   trialFromDeployCliJson,
   withDeployFiles
-} from "./chunk-E4C75NSV.js";
+} from "./chunk-BCUJGB4Y.js";
 import "./chunk-RO726HJG.js";
 export {
   BNB_PLATFORM_API_URL,

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@bnbagent/studio-cli",
-  "version": "0.0.13-alpha.3",
+  "version": "0.0.13-alpha.5",
   "description": "Skills-first toolkit and bag CLI for BNB Chain seller agents: ERC-8004 identity, ERC-8183 escrowed commerce, and x402 payments.",
   "keywords": [
     "bnb-chain",
@@ -42,7 +42,7 @@
     "bag": "./dist/bag.js"
   },
   "dependencies": {
-    "@bnbagent/sdk": "0.5.2",
+    "@bnbagent/sdk": "0.5.3",
     "ai": "^7.0.29",
     "archiver": "^8.0.0",
     "commander": "^15.0.0",
@@ -54,7 +54,7 @@
     "tar": "^7.4.0",
     "viem": "^2.54.0",
     "yaml": "^2.9.0",
-    "@bnbagent/studio-runtime": "0.0.13-alpha.3"
+    "@bnbagent/studio-runtime": "0.0.13-alpha.5"
   },
   "devDependencies": {
     "@a2a-js/sdk": "^0.3.14",

package/recipes/agent/recipe.toml

@@ -11,7 +11,7 @@ node = [
     # neutral. The agent project's serving deps (@a2a-js/sdk / MCP SDK / ai)
     # come from the runtimes/<R>/ recipe selected at `bag init` time.
     "@bnbagent/studio-runtime",
-    "@bnbagent/sdk@0.5.2",
+    "@bnbagent/sdk@0.5.3",
 ]
 
 [env]

package/recipes/mpp-buyer/recipe.toml

@@ -6,7 +6,7 @@ status = "v0.0.x"
 [dependencies]
 node = [
     "@bnbagent/studio-runtime",
-    "@bnbagent/sdk@0.5.2",
+    "@bnbagent/sdk@0.5.3",
     "ai@^7.0.29",
     "zod@^3.25.0",
 ]

package/recipes/runtimes/agentcore/recipe.toml

@@ -32,7 +32,7 @@ node = [
     # BNBAGENT_RUNTIME_SECRET_ID is set (default secretsmanager mode + platform).
     "@aws-sdk/client-secrets-manager@^3.600.0",
     "@bnbagent/studio-runtime",
-    "@bnbagent/sdk@0.5.2",
+    "@bnbagent/sdk@0.5.3",
     # The LLM work hook (generateText + tools) and the model factory.
     "ai@^7.0.29",
     # Tool input schemas (AI SDK tools + MCP registerTool).

package/recipes/runtimes/azure-foundry/recipe.toml

@@ -29,7 +29,7 @@ node = [
     # on either cloud.
     "@aws-sdk/client-secrets-manager@^3.600.0",
     "@bnbagent/studio-runtime",
-    "@bnbagent/sdk@0.5.2",
+    "@bnbagent/sdk@0.5.3",
     # The LLM work hook (generateText + tools) and the model factory
     # (model.ts buildModel — studio.toml [llm] + the provider key env).
     "ai@^7.0.29",

package/recipes/x402-buyer/recipe.toml

@@ -6,7 +6,7 @@ status = "v0.0.x"
 [dependencies]
 node = [
     "@bnbagent/studio-runtime",
-    "@bnbagent/sdk@0.5.2",
+    "@bnbagent/sdk@0.5.3",
     "ai@^7.0.29",   # AI SDK `tool` wrappers around the buyer functions
     "zod@^3.25.0",  # tool input schemas
 ]

package/skills/references/bnbagent-studio-operating.md

@@ -112,7 +112,7 @@ Returns a rich table of checks across the `app/agent/` sub-project:
 | LLM provider key | API key env not set | Edit `.studio/.env.local` or export the right `*_API_KEY` |
 | Network reachable | RPC down/wrong URL | Override via `STUDIO_BSC_TESTNET_RPC=...` (testnet) / `STUDIO_BSC_RPC=...` (mainnet) - per-network env vars read by `@bnbagent/studio-runtime/networks` `getNetwork` |
 | Wallet tBNB balance | 0 tBNB | Message https://t.me/bnbchain_official_bot: `I would like to get tBNB to my wallet <address>` (more options: docs.bnbchain.org/bnb-smart-chain/developers/faucet/) |
-| Wallet U balance | 0 U | Transfer from holder, or ask for sponsor U |
+| Wallet U balance | 0 U | Message https://t.me/bnbchain_official_bot: `I would like to get U to my wallet <address>` (more options: https://united-coin-u.github.io/u-faucet/) |
 | 8004 registered | Not registered | Normally registered automatically at `bag deploy verify`. Manual: `bag erc8004 register --endpoint <url>` (only if you need an on-chain identity before deploy). WARN-only in `bag doctor` - it doesn't block local dev. |
 
 WARN-only items don't block; FAIL items do (exit 1).

package/skills/references/bnbagent-studio-scaffolding-agent.md

@@ -190,7 +190,7 @@ Build a TodoWrite list. The shape depends on the `wallet kind`. The canonical 8-
 5. **Fund the wallet - OPTIONAL; do NOT block on it.** The default `auto/free` LLM model runs at $0 and AgentCore deploy consumes no wallet balance, so a brand-new seller can scaffold, run `bag dev`, and deploy with an empty wallet. `bag doctor` and `bag deploy` only **WARN** (never block) on zero balance. Funding is needed later only for: a paid LLM model, on-chain settle, paying positive-price ERC-8183 job buys, or buying/smoking a PAID B402 request. A FREE ERC-8183 buy needs no U escrow or ERC-20 approval, but still needs the ERC-8183 state-changing calls and their gas/paymaster path. A FREE B402/x402 request needs neither token funding nor a facilitator call. When funding is needed, the wallet uses **TWO distinct U balances on TWO chains** (same wallet address, same private key, different chains):
    - **tBNB (gas)** on BSC testnet: message the official Telegram bot https://t.me/bnbchain_official_bot with `I would like to get tBNB to my wallet <address>` (up to 0.3 tBNB/day; replies with the tx hash). More options: https://docs.bnbchain.org/bnb-smart-chain/developers/faucet/
    - **BSC mainnet U** (`0xcE24439F2D9C6a2289F741120FE202248B666666`) - for Pieverse LLM topup. Minimum **0.2 U** recommended (0.1 for activate + slack). Pieverse runs **only on mainnet chainId=56**; testnet U cannot pay for LLM credits. Acquire via PancakeSwap. Wallet-funded renewal stays off unless the operator explicitly enables it with `bag budget enable`; otherwise refill Account Balance with `bag llm topup` as needed.
-   - **BSC testnet U** (`0xc70B8741B8B07A6d61E54fd4B20f22Fa648E5565`) - for ERC-8183 job payments if `[network].default = bsc-testnet`. Faucet: https://united-coin-u.github.io/u-faucet/ (paste the agent wallet address; see also `docs/guides/U-token-testnet.md`).
+   - **BSC testnet U** (`0xc70B8741B8B07A6d61E54fd4B20f22Fa648E5565`) - for ERC-8183 job payments if `[network].default = bsc-testnet`. Message the official Telegram bot https://t.me/bnbchain_official_bot with `I would like to get U to my wallet <address>`. More options: https://united-coin-u.github.io/u-faucet/ (see also `docs/guides/U-token-testnet.md`).
 
    Both U balances live in the **same agent wallet** - one address, same private key - just on different chains. Verify both with `bag wallet balance --all`.
 

package/skills/references/bnbagent-studio-using-twak-wallet.md

@@ -116,7 +116,7 @@ Two assets, two different rules:
 
 **Hot-wallet rule**: fund only a few days of spend. The Agent wallet is an operational hot wallet, not a treasury - the on-chain balance is the one spending limit nothing can bypass. Studio's daily caps (`[budget].max_per_day_usd`) are in-process guardrails: real across CLI runs (persisted to `.studio/spend-ledger.json`), best-effort in the deployed runtime (in-memory, resets on cold start).
 
-Testnet faucet: https://www.bnbchain.org/en/testnet-faucet (tBNB fallback). Mainnet: U via PancakeSwap; keep BNB for ERC-8183 fund/settle.
+On testnet, message https://t.me/bnbchain_official_bot with `I would like to get tBNB to my wallet <address>` for gas and `I would like to get U to my wallet <address>` for ERC-8183 U. More options: https://docs.bnbchain.org/bnb-smart-chain/developers/faucet/ (tBNB) and https://united-coin-u.github.io/u-faucet/ (U). Mainnet: U via PancakeSwap; keep BNB for ERC-8183 fund/settle.
 
 ## 4. SIWE binding (Pieverse) - ALWAYS bind before paying