@bnbagent/studio-cli 0.0.10 → 0.0.11-alpha.1

package/dist/bag.js

@@ -6,17 +6,21 @@ import {
   CliExit,
   DEFAULT_B402_PRICE_USD,
   DEFAULT_B402_TESTNET_BASE_URL,
+  LEGACY_ENTRY_STEMS,
+  X402_CAPABLE_RUNTIMES,
   act,
   agentcoreFlavor,
   b402Credentials,
   bnbEnv,
   bnbPlatformApiUrl,
+  checkBunx,
   checkDocker,
   checkTwak,
   commerceRails,
   deployChecks,
   deployEndpointValue,
   devPortOf,
+  dryRunBundle,
   entryStemOf,
   getEnvVar,
   hasA2aFace,
@@ -44,7 +48,7 @@ import {
   x402SellerIsFree,
   x402SellerPricingState,
   x402SellerUsesB402
-} from "./chunk-YFEM4564.js";
+} from "./chunk-TTPOH453.js";
 import {
   TWAK_CLI_MIN_VERSION,
   TWAK_CLI_VERSION,
@@ -222,7 +226,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-NJFCWBSF.js");
+  const { bnbPlatformApiUrl: bnbPlatformApiUrl2 } = await import("./deployCli-K55GXDVO.js");
   const controller = new AbortController();
   const timer = setTimeout(() => controller.abort(), CAMPAIGN_CHECK_TIMEOUT_MS);
   try {
@@ -454,8 +458,8 @@ function packageRoot() {
   }
 }
 function studioCliVersion() {
-  if ("0.0.10") {
-    return "0.0.10";
+  if ("0.0.11-alpha.1") {
+    return "0.0.11-alpha.1";
   }
   const file = path2.join(packageRoot(), "package.json");
   const pkg = JSON.parse(fs3.readFileSync(file, "utf-8"));
@@ -491,15 +495,34 @@ import { parse, stringify } from "smol-toml";
 
 // src/cli/utils/prompt.ts
 import * as readline from "readline/promises";
+var PromptCancelled = class extends Error {
+  constructor() {
+    super("prompt cancelled");
+    this.name = "PromptCancelled";
+  }
+};
+async function ask(rl, question) {
+  try {
+    return await Promise.race([
+      rl.question(question),
+      new Promise((_, reject) => {
+        rl.once("SIGINT", () => reject(new PromptCancelled()));
+      })
+    ]);
+  } catch (exc) {
+    if (exc instanceof PromptCancelled) {
+      throw exc;
+    }
+    return "";
+  }
+}
 async function promptUser(question) {
   const rl = readline.createInterface({
     input: process.stdin,
     output: process.stdout
   });
   try {
-    return await rl.question(question);
-  } catch {
-    return "";
+    return await ask(rl, question);
   } finally {
     rl.close();
   }
@@ -510,9 +533,7 @@ async function promptUserStderr(question) {
     output: process.stderr
   });
   try {
-    return await rl.question(question);
-  } catch {
-    return "";
+    return await ask(rl, question);
   } finally {
     rl.close();
   }
@@ -526,9 +547,7 @@ async function promptHidden(question) {
     terminal: false
   });
   try {
-    return await rl.question("");
-  } catch {
-    return "";
+    return await ask(rl, "");
   } finally {
     rl.close();
     process.stderr.write("\n");
@@ -3455,13 +3474,13 @@ function unavailableProvidersForProject(root) {
     const cfg = loadStudioToml6(path13.join(agentRoot2, "studio.toml"));
     runtime = text(tableOf3(cfg, "stack").runtime) ?? "agentcore";
     const faces = stackFaces(tableOf3(cfg, "stack"), tableOf3(cfg, "payments"));
-    azureProtocolUnsupported = !hasA2aFace(faces) || hasMcpFace(faces);
+    azureProtocolUnsupported = hasMcpFace(faces) || !hasA2aFace(faces) && !hasX402Face(faces);
   } catch {
     return {};
   }
   if (runtime === "azure-foundry") {
     const reason = "this project uses a different container adapter; scaffold an agentcore project before selecting this provider";
-    const azureProtocolReason = "Azure Foundry deploy currently supports A2A projects only; use an A2A azure-foundry scaffold or AgentCore for MCP";
+    const azureProtocolReason = "Azure Foundry deploy supports A2A and X402 seller projects; use AgentCore for MCP";
     return {
       aws: reason,
       ...azureProtocolUnsupported ? {
@@ -4488,22 +4507,23 @@ var checkEntrypointAndDockerfile = async (root, _target) => {
   const findings = [];
   const cfg = loadStudioCfg(deployWorkspaceRoot(root));
   const faces = stackFaces(tableOf4(cfg, "stack"), tableOf4(cfg, "payments"));
-  if (!hasA2aFace(faces) || hasMcpFace(faces)) {
+  if (hasMcpFace(faces) || !hasA2aFace(faces) && !hasX402Face(faces)) {
     return [
       {
         level: "CRITICAL",
         name: "azure_protocol_supported",
-        message: "azure-foundry deploy currently supports protocol A2A only. The delegated Foundry version declares the invocations contract (:8088, /readiness, /invocations), not native MCP /mcp. Re-scaffold with --protocols A2A (optionally X402) or use AgentCore for MCP.",
+        message: "azure-foundry deploy supports the A2A carrier, including X402-only seller configs. The delegated Foundry version declares the invocations contract (:8088, /readiness, /invocations), not native MCP /mcp. Re-scaffold with --protocols A2A, X402, or A2A,X402; or use AgentCore for MCP.",
         details: { faces }
       }
     ];
   }
-  const entry = "src/foundryMain.ts";
+  const entryCandidates = ["src/unifiedMain.ts", "src/foundryMain.ts"];
+  const entry = entryCandidates.find((c2) => isFile6(path17.join(agentRoot2, c2))) ?? entryCandidates[0];
   if (!isFile6(path17.join(agentRoot2, entry))) {
     findings.push({
       level: "CRITICAL",
       name: "azure_agent_entrypoint",
-      message: `app/agent/${entry} is missing \u2014 the A2A Foundry entrypoint the container image runs. Re-scaffold with \`bag init \u2026 --runtime azure-foundry\`.`,
+      message: `app/agent/${entry} is missing \u2014 the A2A entrypoint the container image runs. Re-scaffold with \`bag init \u2026 --runtime azure-foundry\`.`,
       details: { entrypoint: entry }
     });
   }
@@ -4606,7 +4626,11 @@ import * as walletRt2 from "@bnbagent/studio-runtime/wallet";
 import { generateText } from "ai";
 
 // src/cli/_pieverseHelpers.ts
-import { fromRaw as fromRaw2, getNetwork as getNetwork3 } from "@bnbagent/studio-runtime/networks";
+import {
+  BSC_TESTNET_U_FAUCET_URL,
+  fromRaw as fromRaw2,
+  getNetwork as getNetwork3
+} from "@bnbagent/studio-runtime/networks";
 import {
   siweLogin
 } from "@bnbagent/studio-runtime/pieverse";
@@ -4659,9 +4683,7 @@ function printUBalanceShortfall(walletAddress, currentRaw, neededRaw, neededUsd,
       `  swap on PancakeSwap: https://pancakeswap.finance/swap?outputCurrency=${u.address}`
     );
   } else {
-    printErr(
-      "  testnet U faucet URL is TBD \u2014 see docs/guides/pieverse-integration.md \xA76"
-    );
+    printErr(`  testnet U faucet: ${BSC_TESTNET_U_FAUCET_URL}`);
   }
 }
 function writeEnvLocal(key, value, envPath = ".env.local") {
@@ -6450,6 +6472,7 @@ import {
   findProjectRoot as findProjectRoot3,
   loadStudioToml as loadStudioToml10
 } from "@bnbagent/studio-runtime/config";
+import { tbnbFaucetHint as tbnbFaucetHint2 } from "@bnbagent/studio-runtime/networks";
 import { buildPolicy, buildWallet } from "@bnbagent/studio-runtime/wallet";
 
 // src/cli/walletSession.ts
@@ -6467,8 +6490,8 @@ import {
 import { auditedOp as auditedOp2 } from "@bnbagent/studio-runtime/audit";
 import { loadStudioToml as loadStudioToml9 } from "@bnbagent/studio-runtime/config";
 import {
-  BSC_TESTNET_FAUCET_URLS,
   getNetwork as getNetwork5,
+  tbnbFaucetHint,
   toRaw as toRaw2
 } from "@bnbagent/studio-runtime/networks";
 import { writePrivate } from "@bnbagent/studio-runtime/secretWrite";
@@ -6538,7 +6561,7 @@ async function requireAltanaAdminGas(ctx) {
   }
   if (balance !== 0n) return;
   const symbol = ctx.networkName === "bsc-testnet" ? "tBNB" : "BNB";
-  const funding = ctx.networkName === "bsc-testnet" ? ` Fund it and retry. Testnet faucets: ${BSC_TESTNET_FAUCET_URLS.join(", ")}` : " Fund it with BNB and retry.";
+  const funding = ctx.networkName === "bsc-testnet" ? ` Fund it and retry \u2014 ${tbnbFaucetHint(ctx.address)}` : " Fund it with BNB and retry.";
   throw new Error(
     `Altana admin wallet ${ctx.address} has 0 ${symbol} on ${ctx.networkName} and cannot pay gas for session administration.${funding}`
   );
@@ -7000,6 +7023,14 @@ function projectNetwork(projectRoot) {
   const dflt = net2 !== null && typeof net2 === "object" ? net2.default : void 0;
   return dflt ? String(dflt) : "bsc-testnet";
 }
+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";
+  printErr(
+    `Next: ${fund}
+      then \`bag doctor\` to verify the project, \`bag dev\` to run it locally.`
+  );
+}
 function twakProvider(projectRoot, walletCfg) {
   return buildWallet(walletCfg, projectRoot, {
     network: projectNetwork(projectRoot)
@@ -7193,6 +7224,8 @@ async function cmdNew(opts) {
     printErr(
       "Altana admin keystore created. Fund this address with about 0.05 tBNB for testnet bootstrap/registration, then run `bag wallet session grant` to create the bounded runtime session."
     );
+  } else {
+    printNextAfterNew(projectRoot, provider.address);
   }
   return 0;
 }
@@ -7232,6 +7265,7 @@ Install it (Node >=22):  npm install -g @trustwallet/cli@${TWAK_CLI_VERSION}`
   const address = provider.address;
   printOut(address);
   persistAddress(projectRoot, address);
+  printNextAfterNew(projectRoot, address);
   return 0;
 }
 function ensureTwakCredentials(walletFile, homeDir) {
@@ -7964,6 +7998,44 @@ function enclosingProjectRoot(start) {
   }
 }
 async function cmdInit(nameArg, opts) {
+  const target = path23.resolve(process.cwd(), nameArg);
+  const targetPreexisted = fs24.existsSync(target);
+  const cleanupOnCancel = () => {
+    if (targetPreexisted || !fs24.existsSync(target)) {
+      printErr("cancelled: no project was created.");
+      return;
+    }
+    const walletsDir = path23.join(target, ".studio", "wallets");
+    const hasWallet = fs24.existsSync(walletsDir) && fs24.readdirSync(walletsDir).length > 0;
+    if (hasWallet) {
+      printErr(
+        `cancelled: ${target} is KEPT \u2014 it already contains a wallet keystore (.studio/wallets/). Finish setup there, or back the keystore up before removing the directory.`
+      );
+    } else {
+      fs24.rmSync(target, { recursive: true, force: true });
+      printErr(
+        `cancelled: removed the partially created ${target}; re-run \`bag init\` to start over.`
+      );
+    }
+  };
+  const onSigint = () => {
+    cleanupOnCancel();
+    process.exit(130);
+  };
+  process.once("SIGINT", onSigint);
+  try {
+    return await cmdInitFlow(nameArg, opts);
+  } catch (exc) {
+    if (exc instanceof Error && exc.name === "PromptCancelled") {
+      cleanupOnCancel();
+      return 130;
+    }
+    throw exc;
+  } finally {
+    process.removeListener("SIGINT", onSigint);
+  }
+}
+async function cmdInitFlow(nameArg, opts) {
   const target = path23.resolve(process.cwd(), nameArg);
   let projectName2 = path23.basename(target);
   if (!projectName2) {
@@ -7972,6 +8044,14 @@ async function cmdInit(nameArg, opts) {
     );
     return 2;
   }
+  if (opts.runtime === "agentcore" || opts.destination === "platform") {
+    try {
+      projectName2 = validateProjectName(projectName2);
+    } catch (exc) {
+      printErr(`error: ${exc instanceof Error ? exc.message : exc}`);
+      return 2;
+    }
+  }
   if (opts.protocols !== void 0 && opts.protocol !== void 0) {
     printErr("error: pass either --protocols or --protocol, not both.");
     return 2;
@@ -8062,7 +8142,9 @@ async function cmdInit(nameArg, opts) {
     return 2;
   }
   if (fs24.existsSync(target) && !opts.force) {
-    printErr(`error: ${target} already exists. Use --force to overwrite.`);
+    printErr(
+      `error: ${target} already exists (perhaps from an interrupted \`bag init\`). Re-run with --force to overwrite \u2014 this DELETES the whole directory, including any wallet keystore under its .studio/ \u2014 or pick another name.`
+    );
     return 2;
   }
   if (opts.destination === "platform" && opts.network === "bsc-mainnet") {
@@ -8086,13 +8168,20 @@ async function cmdInit(nameArg, opts) {
     destination = "self";
     runtime = "agentcore";
   }
-  if (destination === "self" && runtime === "azure-foundry" && (!hasA2aFace(faces) || hasMcpFace(faces))) {
+  if (destination === "self" && runtime === "azure-foundry" && (hasMcpFace(faces) || !hasA2aFace(faces) && !hasX402Face(faces))) {
     printErr(
-      "error: azure-foundry supports protocol A2A only as its native face (X402 is optional) and does not support an MCP face. Foundry is delegated through its invocations container contract (:8088, /readiness, /invocations), not the native MCP /mcp transport. Use --protocols A2A (optionally with X402), or use --runtime agentcore for MCP."
+      "error: azure-foundry supports the A2A carrier (including X402-only seller configs) and does not support an MCP face. Foundry is delegated through its invocations container contract (:8088, /readiness, /invocations), not the native MCP /mcp transport. Use --protocols A2A, X402, or A2A,X402; or use --runtime agentcore for MCP."
     );
     return 2;
   }
   if (fs24.existsSync(target)) {
+    const walletsDir = path23.join(target, ".studio", "wallets");
+    if (fs24.existsSync(walletsDir) && fs24.readdirSync(walletsDir).length > 0) {
+      printErr(
+        `error: refusing --force: ${walletsDir} contains a wallet keystore and overwriting would DELETE the key. Back the keystore up and remove the directory yourself, or init under a different name.`
+      );
+      return 2;
+    }
     fs24.rmSync(target, { recursive: true, force: true });
   }
   if (destination === "platform") {
@@ -8410,17 +8499,18 @@ function scaffold(target, name, o) {
   const isContainer = packaging === "container";
   const mode = recipeModeOf(o.faces);
   const stem2 = entryStemOf(o.faces);
-  const a2aEntry = o.runtime === "azure-foundry" ? "dist/foundryMain.js" : "dist/main.js";
   const runtimeCtx = {
     PKG: AGENT_SRC,
     TWAK_CLI_VERSION,
     PNPM_VERSION: packageManagerVersion,
     DEPLOYMENT_TYPE: isContainer ? "container" : "direct_code_deploy",
-    ENTRYPOINT: o.runtime === "azure-foundry" ? a2aEntry : `dist/${stem2}.js`,
-    // Foundry Hosted Agents have a provider-level container contract that is
-    // independent of Studio's local A2A/MCP ports: plain HTTP on :8088 plus
-    // GET /readiness and the declared protocol route.  The deploy host below
-    // declares invocations, so its image must always expose :8088.
+    // The A2A entrypoint (unifiedMain) is cloud-portable: it binds BOTH the
+    // AgentCore (9000) and Foundry (8088) contract ports itself, so the same
+    // rendered image deploys to either cloud — no runtime-specific entry.
+    ENTRYPOINT: `dist/${stem2}.js`,
+    // AGENT_PORT only prepends a primary override; the Foundry contract port
+    // stays reachable regardless. MCP keeps its 8000 contract; Foundry
+    // renders 8088 for continuity with the provider's documented default.
     CONTAINER_PORT: o.runtime === "azure-foundry" ? "8088" : String(devPortOf(o.faces))
   };
   emitRecipe(agentRoot2, "agent", { context: runtimeCtx });
@@ -8786,10 +8876,11 @@ function renderAgentStudioToml(name, o) {
 # Read by the Agent: it quotes the FIXED \`price\`, CLAMPS it to [min,max],
 # freezes a short-TTL offer, and EIP-191 signs it \u2014 pricing is rule-based, the
 # LLM never prices. price=0 is FREE and is supported by the canonical stack.
-currency = "${currencyAddr}"   # $U token address \u2014 prefilled from [network].default
-price = "${o.erc8183Price}"                    # token base units; 0 = FREE (zero token escrow)
+currency = "${currencyAddr}"   # $U token address \u2014 prefilled from [network].default; rarely changed
+# All prices are in wei of the currency token. U has 18 decimals (not 6 like USDC).
+price = "${o.erc8183Price}"                    # wei; 0 = FREE (zero token escrow)
 min_price = "0"                                # wei \u2014 clamp floor
-max_price = ""                                 # wei \u2014 clamp ceiling; SET before going live
+max_price = ""                                 # wei \u2014 clamp ceiling; empty = unbounded; SET before going live
 quote_ttl_seconds = 900                        # seconds a signed quote stays valid; SDK caps at 900 (~15min work window)
 default_estimated_completion_seconds = 600
 poll_interval_seconds = 30
@@ -8927,7 +9018,7 @@ function renderAgentReadme(name, faces, destination, walletKind2) {
   const port = String(devPortOf(faces));
   const x402Only = faces.length === 1 && hasX402Face(faces);
   const surface = mode === "both" ? "A2A natively on `0.0.0.0:9000` (agent card + JSON-RPC `message/send`) and buffered streamable-HTTP MCP on `/mcp` through the platform envelope tunnel" : mode === "mcp" ? "streamable-HTTP MCP on `0.0.0.0:8000/mcp` (negotiate + notify_funded sync-delivery + read-only chain tools)" : x402Only ? "only the public `/x402` seller face; AgentCore uses an internal A2A-native process on port 9000 but the gateway suppresses A2A discovery" : "`serveA2a`: the agent card at `/.well-known/agent-card.json` + JSON-RPC `message/send` on `0.0.0.0:9000`";
-  const filesA2a = `- \`src/main.ts\` \u2014 A2A serving entrypoint (\`serveA2a\` on port 9000).
+  const filesA2a = `- \`src/unifiedMain.ts\` \u2014 unified serving entrypoint (A2A on port 9000 + Foundry invocations on 8088).
 - \`src/executor.ts\` \u2014 the SellerAgentExecutor: the negotiate + notify_funded A2A skills.
 - \`src/agentCard.ts\` \u2014 the discoverable AgentCard (+ OAuth2/Cognito scheme).`;
   const filesMcp = `- \`src/mcpMain.ts\` \u2014 MCP serving entrypoint (streamable HTTP on \`/mcp\`; deploy
@@ -9077,10 +9168,23 @@ async function resolveWalletKind(flagValue, isTty) {
     );
     return "evm-local";
   }
-  const answer = (await promptUser(
-    "Wallet backend? [evm-local] local keystore / altana bounded session / twak Trust Wallet CLI: "
-  )).trim().toLowerCase();
-  return answer === "twak" || answer === "altana" ? answer : "evm-local";
+  printOut("Wallet backend (who holds the Agent's signer key):");
+  printOut(
+    "  1. evm-local  [default] \u2014 encrypted local keystore under .studio/; simplest, works everywhere"
+  );
+  printOut(
+    "  2. twak    \u2014 Trust Wallet CLI wallet; forces container packaging for deploys"
+  );
+  printOut(
+    "  3. altana  \u2014 bounded session signer; incompatible with pieverse-llm and paid b402 selling"
+  );
+  const answer = (await promptUser("Wallet backend [1-3, Enter = evm-local]: ")).trim().toLowerCase();
+  if (answer === "2" || answer === "twak") return "twak";
+  if (answer === "3" || answer === "altana") return "altana";
+  if (answer !== "" && answer !== "1" && answer !== "evm-local") {
+    printErr(`hint: unknown wallet backend '${answer}' \u2014 using evm-local.`);
+  }
+  return "evm-local";
 }
 async function resolveLlmProviderForWallet(walletKind2, configuredProvider, valueSource, isTty) {
   if (walletKind2 !== "altana") {
@@ -9263,12 +9367,22 @@ function readWalletAddress(studioToml) {
 async function printFaucetHint(network, address) {
   printOut("");
   if (network === "bsc-testnet") {
-    const { BSC_TESTNET_FAUCET_URLS: BSC_TESTNET_FAUCET_URLS5 } = await import("@bnbagent/studio-runtime/networks");
+    const {
+      BSC_TESTNET_TBNB_TELEGRAM_FAUCET: BSC_TESTNET_TBNB_TELEGRAM_FAUCET2,
+      BSC_TESTNET_FAUCET_DOCS_URL: BSC_TESTNET_FAUCET_DOCS_URL2,
+      BSC_TESTNET_U_FAUCET_URL: BSC_TESTNET_U_FAUCET_URL4
+    } = await import("@bnbagent/studio-runtime/networks");
     printOut(`Your testnet wallet address: ${address}`);
-    printOut("Fund it (free) from these faucets \u2014 paste the address above:");
-    for (const url of BSC_TESTNET_FAUCET_URLS5) {
-      printOut(`  \xB7 ${url}`);
-    }
+    printOut("Fund it (free):");
+    printOut(
+      `  tBNB \u2014 message the official Telegram bot ${BSC_TESTNET_TBNB_TELEGRAM_FAUCET2}`
+    );
+    printOut(
+      `         send: "I would like to get tBNB to my wallet ${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("(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.)");
@@ -9632,18 +9746,26 @@ function printMainTwakWalletWarning() {
   );
 }
 async function onboardIpfsKey(envPath, ipfsKey) {
+  const url = (await promptUser(
+    "\nIPFS pinning-service UPLOAD ENDPOINT for deliverable storage \u2014 REQUIRED before `bag deploy` (e.g. your provider's pin/upload URL or a self-hosted node's /api/v0/add; blank to fill STORAGE_API_URL later): "
+  )).trim();
+  if (url) {
+    setEnvVar(envPath, "STORAGE_API_URL", url);
+    printOut("\u2713 STORAGE_API_URL written to .studio/.env.local");
+  }
   let key = ipfsKey;
   if (key === void 0) {
     key = (await promptUser(
-      "\nIPFS pinning-service write key/JWT for deliverable storage (blank to skip, fill STORAGE_API_KEY later): "
+      "IPFS pinning-service write key/JWT (blank to skip, fill STORAGE_API_KEY later): "
     )).trim();
   }
   if (key) {
     setEnvVar(envPath, "STORAGE_API_KEY", key);
     printOut("\u2713 STORAGE_API_KEY written to .studio/.env.local");
-  } else {
+  }
+  if (!url || !key) {
     printErr(
-      "hint: set STORAGE_API_URL (your pinning service's upload endpoint) and STORAGE_API_KEY (its write key/JWT)\n      in .studio/.env.local before `bag dev`, or re-scaffold with --storage-provider local for offline dev."
+      "hint: set STORAGE_API_URL (your pinning service's upload endpoint) and STORAGE_API_KEY (its write key/JWT)\n      in .studio/.env.local before `bag dev`, or re-scaffold with --storage-provider local for offline dev.\n      `bag deploy prepare` blocks (CRITICAL) until STORAGE_API_URL is set."
     );
   }
 }
@@ -9665,7 +9787,7 @@ function printCampaignIntro() {
   );
 }
 function printTwakNotice(destination = "self") {
-  const deployLine = destination === "platform" ? " \xB7 DEPLOY (managed platform): builds + pushes the arm64 twak image\n   (Node + the twak CLI) FROM YOUR MACHINE \u2014 local Docker is\n   REQUIRED (no CodeBuild fallback on this path); start Docker Desktop." : " \xB7 RUN/DEPLOY: local `bag dev` runs the agent IN-PROCESS by default\n   (`tsx src/main.ts`, no Docker); `bag dev --container` runs it via\n   `agentcore dev` in Docker for image parity. DEPLOY builds the twak\n   container image (Node + the twak CLI) via AWS CodeBuild \u2014\n   Docker is optional locally. `bag init` already configured\n   build=Container + a Dockerfile.";
+  const deployLine = destination === "platform" ? " \xB7 DEPLOY (managed platform): builds + pushes the arm64 twak image\n   (Node + the twak CLI) FROM YOUR MACHINE \u2014 local Docker is\n   REQUIRED (no CodeBuild fallback on this path); start Docker Desktop." : " \xB7 RUN/DEPLOY: local `bag dev` runs the agent IN-PROCESS by default\n   (`tsx src/unifiedMain.ts`, no Docker); `bag dev --container` runs it via\n   `agentcore dev` in Docker for image parity. DEPLOY builds the twak\n   container image (Node + the twak CLI) via AWS CodeBuild \u2014\n   Docker is optional locally. `bag init` already configured\n   build=Container + a Dockerfile.";
   printOut(
     `
 NOTE \u2014 wallet.kind = "twak" (Trust Wallet Agent Kit, CLI >= ${TWAK_CLI_VERSION}):
@@ -9772,9 +9894,9 @@ function entrypointHint(faces) {
     return "app/agent/src/mcpMain.ts  = MCP entrypoint (build your value here)";
   }
   if (faces.length === 1 && hasX402Face(faces)) {
-    return "app/agent/src/main.ts  = X402-only runtime entrypoint (build your value here)";
+    return "app/agent/src/unifiedMain.ts  = X402-only runtime entrypoint (build your value here)";
   }
-  return "app/agent/src/main.ts + executor.ts  = A2A entrypoint (build your value here)";
+  return "app/agent/src/unifiedMain.ts + executor.ts  = A2A entrypoint (build your value here)";
 }
 function hasVendoredTarballs(agentDir) {
   const vendor = path23.join(agentDir, "vendor");
@@ -9822,18 +9944,17 @@ function printCompactNextSteps(name, o = {}) {
       "  pnpm install               # one-time: install the agent dependencies"
     );
   }
+  printOut("  bag doctor             # verify config + env before funding");
+  printOut("  bag dev                # run the Agent locally");
   if (destination === "platform") {
-    printOut("  bag dev                # run the Agent locally");
     printOut(
       "  bag deploy --provider bnb  # Agent \u2192 managed platform (48h testnet trial)"
     );
   } else if (runtime === "azure-foundry") {
-    printOut("  bag dev                # run the Agent locally");
     printOut(
       "  bag deploy --provider azure   # Agent \u2192 Azure AI Foundry (delegated to bnbagent-deploy; browser login, no azd)"
     );
   } else {
-    printOut("  agentcore dev          # run the Agent locally on AgentCore");
     printOut("  bag deploy --provider aws  # Agent \u2192 AgentCore");
   }
   printOut("");
@@ -9963,19 +10084,7 @@ function printNextSteps(name, provider, o = {}) {
     printOut("  #    is `auto/free` (Free) \u2014 no funding required to start.");
     printOut("  bag llm activate");
     printOut("");
-    printOut(
-      "  # 4. (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("  #    mainnet:  swap a small amount via PancakeSwap:");
-    printOut(
-      "  #              https://pancakeswap.finance/swap?outputCurrency=0xcE24439F2D9C6a2289F741120FE202248B666666"
-    );
-    printOut("  #    Then: bag llm topup --amount N   (allocate paid credits)");
-    printOut("");
-    nextStep = 5;
+    nextStep = 4;
   } else {
     const keyEnv = PROVIDER_KEY_ENV[provider];
     if (keyEnv) {
@@ -9987,6 +10096,26 @@ function printNextSteps(name, provider, o = {}) {
     }
     nextStep = 4;
   }
+  printOut(`  # ${nextStep}. verify + run the agent locally (no funds needed)`);
+  printOut("  bag doctor   # diagnose config + env; fix FAILs before deploy");
+  printOut("  bag dev      # serve the Agent locally for a smoke test");
+  nextStep += 1;
+  if (provider === "pieverse-llm") {
+    printOut("");
+    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("  #    mainnet:  swap a small amount via PancakeSwap:");
+    printOut(
+      "  #              https://pancakeswap.finance/swap?outputCurrency=0xcE24439F2D9C6a2289F741120FE202248B666666"
+    );
+    printOut("  #    Then: bag llm topup --amount N   (allocate paid credits)");
+    nextStep += 1;
+  }
+  printOut("");
   printOut(
     `  # ${nextStep}. review ERC-8183 pricing in studio.toml [payments.erc8183]`
   );
@@ -9994,10 +10123,6 @@ function printNextSteps(name, provider, o = {}) {
     "  #    (price was selected at init; `bag config set payments.erc8183.price 0` explicitly switches to FREE)"
   );
   nextStep += 1;
-  printOut(`  # ${nextStep}. verify + run the agent locally`);
-  printOut("  bag doctor");
-  printOut("  bag dev");
-  nextStep += 1;
   if (destination === "platform") {
     printOut(
       `  # ${nextStep}. deploy: app/agent \u2192 managed platform (48h testnet trial)`
@@ -10298,6 +10423,11 @@ function runtimeEnvKeysCore(cfg, resolvable) {
   if (resolvable("RPC_URL")) {
     keys.push("RPC_URL");
   }
+  const runtimeName = String(tableOf8(cfg, "stack").runtime ?? "agentcore");
+  const publicUrlKeys = runtimeName === "azure-foundry" ? ["BNBAGENT_PUBLIC_URL"] : ["BNBAGENT_PUBLIC_URL", "AGENT_PUBLIC_URL"];
+  for (const key of publicUrlKeys) {
+    if (resolvable(key)) keys.push(key);
+  }
   for (const key of PAYMASTER_URL_ENV_KEYS) {
     if (resolvable(key)) keys.push(key);
   }
@@ -10306,8 +10436,7 @@ function runtimeEnvKeysCore(cfg, resolvable) {
       if (resolvable(key)) keys.push(key);
     }
   }
-  const runtime = String(tableOf8(cfg, "stack").runtime ?? "agentcore");
-  if (runtime === "agentcore" && x402SellerUsesB402(cfg)) {
+  if (X402_CAPABLE_RUNTIMES.has(runtimeName) && x402SellerUsesB402(cfg)) {
     for (const key of B402_RUNTIME_KEYS) {
       if (resolvable(key)) keys.push(key);
     }
@@ -10413,8 +10542,12 @@ function agentFaces(workspaceRoot) {
   const cfg = loadAgentToml2(workspaceRoot);
   return stackFaces(tableOf9(cfg, "stack"), tableOf9(cfg, "payments"));
 }
-function localEntryFile(faces) {
-  return `src/${entryStemOf(faces)}.ts`;
+function localEntryFile(faces, agentDir) {
+  const stem2 = entryStemOf(faces);
+  const candidates = [stem2, ...LEGACY_ENTRY_STEMS[stem2]].map(
+    (s) => `src/${s}.ts`
+  );
+  return candidates.find((c2) => isFile10(path24.join(agentDir, c2))) ?? candidates[0];
 }
 function defaultAgentPort(faces) {
   return devPortOf(faces);
@@ -10786,11 +10919,11 @@ async function cmdDev(opts) {
   const agentPort = opts.port ?? defaultAgentPort(faces);
   const runtime = agentRuntime(workspaceRoot);
   const container = Boolean(opts.container);
-  const entryFile = localEntryFile(faces);
+  const entryFile = localEntryFile(faces, agentDir);
   const agentFile = path24.join(agentDir, entryFile);
   if (!isFile10(agentFile)) {
     printErr(
-      `error: Agent entrypoint file ${agentFile} does not exist. [stack] faces = [${faces.join(", ")}], so the entrypoint is ${entryFile} (A2A/X402-only \u2192 src/main.ts, MCP \u2192 src/mcpMain.ts, A2A+MCP \u2192 src/dualMain.ts). Run \`bag init\` to scaffold the workspace.`
+      `error: Agent entrypoint file ${agentFile} does not exist. [stack] faces = [${faces.join(", ")}], so the entrypoint is ${entryFile} (A2A/X402-only \u2192 src/unifiedMain.ts, MCP \u2192 src/mcpMain.ts, A2A+MCP \u2192 src/dualMain.ts; legacy src/main.ts scaffolds still run). Run \`bag init\` to scaffold the workspace.`
     );
     return 2;
   }
@@ -10929,7 +11062,7 @@ Switch to Node \u226522 so it wins on PATH, then reopen the shell and retry. Ver
     printOut(
       `bag dev: starting Agent in-process (\`tsx ${args.join(" ")}\` on :${agentPort}, no Docker \u2014 the entrypoint self-serves; cwd=${agentDir}, runner=${runner2})`
     );
-    if (runtime === RUNTIME_AZURE_FOUNDRY) {
+    if (runtime === RUNTIME_AZURE_FOUNDRY && isFile10(path24.join(agentDir, "src/foundryMain.ts"))) {
       printOut(
         "bag dev: azure-foundry serves this local A2A/MCP entrypoint in-process; src/foundryMain.ts is the deploy-only Foundry host (the entrypoint `bag doctor` reports) and never runs here."
       );
@@ -11102,7 +11235,10 @@ async function checkAgentPackagePresent(root, target) {
   const cfg = loadAgentToml(root);
   const faces = stackFaces(tableOf2(cfg, "stack"), tableOf2(cfg, "payments"));
   const stem2 = entryStemOf(faces);
-  const sourceEntries = [`src/${stem2}.ts`];
+  const effectiveStem = [stem2, ...LEGACY_ENTRY_STEMS[stem2]].find(
+    (s) => isFile11(path25.join(agentRoot2, `src/${s}.ts`))
+  ) ?? stem2;
+  const sourceEntries = [`src/${effectiveStem}.ts`];
   if (stem2 === "dualMain") {
     sourceEntries.push("src/mcpMain.ts");
   }
@@ -11120,7 +11256,7 @@ async function checkAgentPackagePresent(root, target) {
       }
     ];
   }
-  const distEntries = [`dist/${stem2}.js`];
+  const distEntries = [`dist/${effectiveStem}.js`];
   if (stem2 === "dualMain") {
     distEntries.push("dist/mcpMain.js");
   }
@@ -11600,12 +11736,12 @@ function x402SellerRailChecks(agentRoot2, cfg, target) {
   }
   const destination = String(tableOf2(cfg, "deploy").destination ?? "self");
   const stackRuntime2 = String(tableOf2(cfg, "stack").runtime ?? "agentcore");
-  if (rails.x402 && (free || credentials.complete) && destination !== "platform" && (target !== "agentcore" || stackRuntime2 !== "agentcore")) {
-    const blocking = target !== "agentcore" ? target : stackRuntime2;
+  if (rails.x402 && (free || credentials.complete) && !target.startsWith("platform") && !(X402_CAPABLE_RUNTIMES.has(target) && X402_CAPABLE_RUNTIMES.has(stackRuntime2))) {
+    const blocking = !X402_CAPABLE_RUNTIMES.has(target) ? target : stackRuntime2;
     out.push({
       level: Level.WARNING,
       name: "x402_forced_dormant_runtime",
-      message: `x402 pricing is ready, but the ${blocking} runtime has no x402 path; this target is forced dormant. Deploy to AgentCore (managed platform or self-hosted) to activate the rail.`,
+      message: `x402 pricing is ready, but the ${blocking} runtime has no x402 path; this target is forced dormant. Deploy to AgentCore or Azure Foundry (managed platform or self-hosted) to activate the rail.`,
       details: { destination, target, stackRuntime: stackRuntime2 }
     });
   }
@@ -11656,7 +11792,7 @@ async function checkCommerceReady(root, target) {
   return out;
 }
 async function checkDeployCliRunnable(_root, target) {
-  if (target !== "agentcore") {
+  if (target !== "agentcore" && target !== "platform" && target !== "platform-azure") {
     return [];
   }
   const override = (process.env.BNBAGENT_DEPLOY_COMMAND ?? "").trim();
@@ -13062,7 +13198,11 @@ import {
   findSubProjectRoot as findSubProjectRoot13,
   loadStudioToml as loadStudioToml17
 } from "@bnbagent/studio-runtime/config";
-import { BSC_TESTNET_FAUCET_URLS as BSC_TESTNET_FAUCET_URLS2 } from "@bnbagent/studio-runtime/networks";
+import {
+  BSC_TESTNET_FAUCET_DOCS_URL,
+  BSC_TESTNET_TBNB_TELEGRAM_FAUCET,
+  BSC_TESTNET_U_FAUCET_URL as BSC_TESTNET_U_FAUCET_URL2
+} from "@bnbagent/studio-runtime/networks";
 
 // src/cli/_deploy/checks/warning.ts
 import * as crypto4 from "crypto";
@@ -13372,7 +13512,10 @@ var checkPlatformEntrypointPresent = async (root, _target) => {
   const data = loadAgent(root);
   const faces = stackFaces(tableOf11(data, "stack"), tableOf11(data, "payments"));
   const stem2 = entryStemOf(faces);
-  const filenames = [`${stem2}.ts`];
+  const effectiveStem = [stem2, ...LEGACY_ENTRY_STEMS[stem2]].find(
+    (s) => fs35.existsSync(path34.join(agentRoot(root), "src", `${s}.ts`))
+  ) ?? stem2;
+  const filenames = [`${effectiveStem}.ts`];
   if (stem2 === "dualMain") filenames.push("mcpMain.ts");
   const filename = filenames.find(
     (candidate) => !fs35.existsSync(path34.join(agentRoot(root), "src", candidate))
@@ -13536,8 +13679,14 @@ 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. Faucets: ${BSC_TESTNET_FAUCET_URLS2.join(" \xB7 ")}`,
-    details: { faucets: [...BSC_TESTNET_FAUCET_URLS2] }
+    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}`,
+    details: {
+      faucets: [
+        BSC_TESTNET_TBNB_TELEGRAM_FAUCET,
+        BSC_TESTNET_FAUCET_DOCS_URL,
+        BSC_TESTNET_U_FAUCET_URL2
+      ]
+    }
   }
 ];
 var criticalChecks = [
@@ -13546,6 +13695,7 @@ var criticalChecks = [
   checkPlatformTestnetOnly,
   checkPlatformSlugValid,
   checkPlatformLoggedIn,
+  checkDeployCliRunnable,
   checkPlatformDockerAvailable,
   checkPlatformStorageEndpoint,
   checkTwakCustomContractsUnsupported,
@@ -14308,7 +14458,7 @@ async function platformAgent(opts) {
   const root = opts.root;
   const backend = opts.backend ?? "aws";
   const isTty = opts.isTty ?? stdinIsTty;
-  const ask = opts.promptUser ?? promptUser;
+  const ask2 = opts.promptUser ?? promptUser;
   warn(
     `note: deploying to the BNB Chain managed platform (backend=${backend}) \u2014 a 48h TESTNET trial sandbox (network is forced to bsc-testnet; the runtime is auto-reclaimed at 48h). Not a production seller.`
   );
@@ -14317,12 +14467,6 @@ async function platformAgent(opts) {
     const cfg2 = loadAgentCfg(root);
     const faces2 = stackFaces(tableOf12(cfg2, "stack"), tableOf12(cfg2, "payments"));
     const protocol2 = nativeProtocolOf(faces2);
-    if (hasX402Face(faces2)) {
-      warn(
-        "error: x402 publication is not supported on the managed Azure backend. No build or upload was started."
-      );
-      return 1;
-    }
     const runtimeProfile = protocol2 === "A2A" ? "foundry-responses-v1" : "foundry-invocations-v1";
     const capability = await platformCmd(["capabilities"], { json: true });
     const platform = isJsonObject(capability.data.platform) ? capability.data.platform : {};
@@ -14336,6 +14480,12 @@ async function platformAgent(opts) {
       );
       return capability.code || 1;
     }
+    if (hasX402Face(faces2) && azure.x402 !== true) {
+      warn(
+        "error: this platform deployment does not accept x402 publication on the managed Azure backend yet. No build or upload was started. Deploy without the X402 face, or self-host the x402 gateway (`bag deploy --provider azure` + docs/guides/self-hosted-x402-gateway-azure.md)."
+      );
+      return 1;
+    }
   }
   const campaignProbe = opts.campaignActive ?? (async () => null);
   const trialRes = await platformCmd(["trial"], { json: true });
@@ -14364,7 +14514,7 @@ async function platformAgent(opts) {
     const rc = await termsConsentGate(root, {
       acceptRisk: opts.acceptRisk ?? false,
       isTty,
-      promptUser: ask
+      promptUser: ask2
     });
     if (rc !== null) {
       return rc;
@@ -14375,7 +14525,7 @@ async function platformAgent(opts) {
     const confirm = opts.confirmPackaging ?? ((r, p) => confirmPackagingDefault(r, p, {
       acceptRisk: opts.acceptRisk ?? false,
       isTty,
-      promptUser: ask
+      promptUser: ask2
     }));
     const rc = await confirm(root, packaging);
     if (rc !== null && rc !== 0) {
@@ -16861,12 +17011,13 @@ import { pieverseKeyHash as pieverseKeyHash4 } from "@bnbagent/studio-runtime/ll
 import {
   BSC_MAINNET_MIN_BNB,
   BSC_MAINNET_MIN_U,
-  BSC_TESTNET_FAUCET_URLS as BSC_TESTNET_FAUCET_URLS3,
   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 fromRaw3,
-  getNetwork as getNetwork9
+  getNetwork as getNetwork9,
+  tbnbFaucetHint as tbnbFaucetHint3
 } from "@bnbagent/studio-runtime/networks";
 import { listModels as listModels2 } from "@bnbagent/studio-runtime/pieverse";
 import * as walletRt5 from "@bnbagent/studio-runtime/wallet";
@@ -16971,6 +17122,9 @@ async function cmdDoctor(opts) {
   checks.push(...await check8004(projectRoot, data, opts.network));
   const destination = String(tableOf14(data, "deploy").destination ?? "self").trim().toLowerCase();
   checks.push(...await checkDeployTools(data, destination));
+  checks.push(
+    ...await checkPlatformZipBundle(data, destination, projectRoot)
+  );
   checks.push(...checkAgentsMdSkillTrigger(projectRoot));
   printChecks(checks);
   return checks.some((c2) => c2.status === FAIL) ? 1 : 0;
@@ -17053,16 +17207,12 @@ function checkAppMain(projectRootArg2) {
     }
   }
   const stack = tableOf14(config, "stack");
+  const faces = stackFaces(stack, tableOf14(config, "payments"));
+  const stem2 = entryStemOf(faces);
   const runtime = String(stack.runtime ?? "").toLowerCase();
-  let entrypoint;
-  if (runtime === "azure-foundry") {
-    entrypoint = "src/foundryMain.ts";
-  } else if (runtime === "agentcore") {
-    const faces = stackFaces(stack, tableOf14(config, "payments"));
-    entrypoint = `src/${entryStemOf(faces)}.ts`;
-  } else {
-    entrypoint = "src/main.ts";
-  }
+  const legacyStems = runtime === "azure-foundry" && stem2 === "unifiedMain" ? ["foundryMain", "main"] : LEGACY_ENTRY_STEMS[stem2];
+  const candidates = [stem2, ...legacyStems].map((s) => `src/${s}.ts`);
+  const entrypoint = candidates.find((c2) => isFile17(path39.join(agentDir, c2))) ?? candidates[0];
   const entryFile = path39.join(agentDir, entrypoint);
   if (!isFile17(entryFile)) {
     return [
@@ -17073,7 +17223,7 @@ function checkAppMain(projectRootArg2) {
       }
     ];
   }
-  const detail = runtime === "azure-foundry" ? `${entrypoint} (deploy entrypoint; \`bag dev\` serves src/main.ts or src/mcpMain.ts locally)` : entrypoint;
+  const detail = entrypoint === "src/foundryMain.ts" ? `${entrypoint} (deploy entrypoint; \`bag dev\` serves src/main.ts or src/mcpMain.ts locally)` : entrypoint;
   return [{ name: "agent entrypoint", status: PASS, detail }];
 }
 function checkAgentcoreName(projectRoot) {
@@ -17851,7 +18001,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 faucetHint = isTestnet ? ` \u2014 faucets: ${BSC_TESTNET_FAUCET_URLS3.join(", ")}` : "";
+    const bnbFaucetHint = isTestnet ? ` \u2014 ${tbnbFaucetHint3(address)}` : "";
+    const uFaucetHint = isTestnet ? ` \u2014 $U faucet: ${BSC_TESTNET_U_FAUCET_URL3}` : "";
     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)`;
@@ -17872,7 +18023,7 @@ async function checkBalances(projectRoot, data, networkOverride) {
       out.push({
         name: "wallet BNB balance",
         status: WARN,
-        detail: `${bnbRaw} wei @ ${address} \u2014 need \u2265 ${minBnb} BNB on ${name} for 8183 escrow / ERC-8004 register${reserveHint}${faucetHint}`
+        detail: `${bnbRaw} wei @ ${address} \u2014 need \u2265 ${minBnb} BNB on ${name} for 8183 escrow / ERC-8004 register${reserveHint}${bnbFaucetHint}`
       });
     }
     const uToken = net2.tokens.U;
@@ -17898,7 +18049,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${faucetHint}`
+        detail: `${uRaw} raw @ ${address} \u2014 need \u2265 ${minU} U on ${name} for one auto-topup chunk${uFaucetHint}`
       });
     }
     return out;
@@ -18047,11 +18198,7 @@ async function checkDeployTools(data, destination) {
   });
   if (destination === "platform") {
     const out = [
-      {
-        name: "deploy: bnbagent-deploy",
-        status: INFO,
-        detail: "[deploy].destination='platform' also delegates to bnbagent-deploy (bunx); `bag deploy prepare` verifies it."
-      },
+      emit2(await checkBunx()),
       {
         name: "deploy: AWS credentials",
         status: INFO,
@@ -18081,6 +18228,49 @@ async function checkDeployTools(data, destination) {
   }
   return (await deployChecks()).map(emit2);
 }
+async function checkPlatformZipBundle(data, destination, projectRootArg2) {
+  if (destination !== "platform" || platformPackagingRequiresContainer(data)) {
+    return [];
+  }
+  let projectRoot = projectRootArg2;
+  const parent = path39.dirname(projectRoot);
+  if (isFile17(path39.join(parent, "agent", "studio.toml"))) {
+    projectRoot = parent;
+  }
+  const agentDir = path39.join(projectRoot, "agent");
+  if (!isFile17(path39.join(agentDir, "studio.toml"))) {
+    return [];
+  }
+  if (!fs39.existsSync(path39.join(agentDir, "node_modules"))) {
+    return [
+      {
+        name: "deploy: zip bundle",
+        status: INFO,
+        detail: "skipped \u2014 dependencies not installed yet (run `pnpm install`); re-run `bag doctor` to dry-run the zip bundle."
+      }
+    ];
+  }
+  const stack = tableOf14(data, "stack");
+  const faces = stackFaces(stack, tableOf14(data, "payments"));
+  try {
+    await dryRunBundle(agentDir, { protocols: faces });
+  } catch (exc) {
+    return [
+      {
+        name: "deploy: zip bundle",
+        status: WARN,
+        detail: errMsg3(exc)
+      }
+    ];
+  }
+  return [
+    {
+      name: "deploy: zip bundle",
+      status: PASS,
+      detail: "esbuild dry run OK \u2014 the agent bundles for the platform ZIP runtime."
+    }
+  ];
+}
 function checkAgentsMdSkillTrigger(projectRoot) {
   const ws = findStudioWorkspaceRoot4(projectRoot);
   if (ws === null) {
@@ -18259,9 +18449,9 @@ import {
   updateServiceEndpoint as updateServiceEndpoint2
 } from "@bnbagent/studio-runtime/erc8004";
 import {
-  BSC_TESTNET_FAUCET_URLS as BSC_TESTNET_FAUCET_URLS4,
   fromRaw as fromRaw4,
-  getNetwork as getNetwork10
+  getNetwork as getNetwork10,
+  tbnbFaucetHint as tbnbFaucetHint4
 } from "@bnbagent/studio-runtime/networks";
 import * as walletRt6 from "@bnbagent/studio-runtime/wallet";
 import { Option as Option5 } from "commander";
@@ -18423,8 +18613,7 @@ async function precheckRegisterGas(wallet, network) {
   if (balance >= REGISTER_MIN_BNB) {
     return null;
   }
-  const faucet = BSC_TESTNET_FAUCET_URLS4[0];
-  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. Faucet: ${faucet}`;
+  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)}`;
 }
 function syncAgentRegistry(agentId, op) {
   try {
@@ -19374,7 +19563,7 @@ async function promptInstallScope() {
 }
 function printNextSteps2() {
   printOut(
-    "\nNext: `bag init my-agent` to scaffold a single seller agent project.\nIn your IDE, type /bnbagent-studio to drive any studio task \u2014 the one\ninstalled skill routes everything (its playbooks load on demand).\nSee `bag --help` for the full command surface, or https://github.com/bnb-chain/bnbagent-studio for docs."
+    "\nNext: `bag init myagent` to scaffold a single seller agent project.\nIn your IDE, type /bnbagent-studio to drive any studio task \u2014 the one\ninstalled skill routes everything (its playbooks load on demand).\nSee `bag --help` for the full command surface, or https://github.com/bnb-chain/bnbagent-studio for docs."
   );
 }
 async function installInteractive(flags) {
@@ -21183,6 +21372,10 @@ async function main(argv) {
     if (err instanceof CliExit) {
       return err.code;
     }
+    if (err instanceof Error && err.name === "PromptCancelled") {
+      process.stderr.write("cancelled.\n");
+      return 130;
+    }
     if (isCommanderExit(err)) {
       return err.exitCode;
     }