@bnbagent/studio-cli 0.0.11 → 0.0.12-alpha.2

package/dist/{chunk-VGSWNATS.js → chunk-XJFJU2AT.js}

@@ -21,8 +21,15 @@ import { stringify as tomlStringify } from "smol-toml";
 import { createHash } from "crypto";
 import * as fs from "fs";
 import * as path from "path";
+import {
+  TURNKEY_SDK_SERVER_PACKAGE,
+  TURNKEY_VIEM_PACKAGE
+} from "@bnbagent/sdk/wallets";
 import { loadStudioToml } from "@bnbagent/studio-runtime/config";
-import { resolveProjectAltanaSdkEntry } from "@bnbagent/studio-runtime/wallet";
+import {
+  resolveProjectAltanaSdkEntry,
+  resolveProjectTurnkeySdkEntry
+} from "@bnbagent/studio-runtime/wallet";
 import { build as esbuildBuild } from "esbuild";
 
 // src/cli/utils/protocol.ts
@@ -141,6 +148,7 @@ async function buildZip(agentDir, outZip, opts = {}) {
     stageManifest(agentDir, buildRoot, entrypoint);
     stageStudioToml(agentDir, buildRoot);
     await stageAltanaSdk(agentDir, buildRoot, opts.bundle ?? bundleEntry);
+    await stageTurnkeySdk(agentDir, buildRoot, opts.bundle ?? bundleEntry);
     assertWithinUncompressedCap(
       buildRoot,
       opts.maxUncompressedBytes ?? MAX_UNCOMPRESSED_BYTES
@@ -277,7 +285,7 @@ async function stageAltanaSdk(agentDir, buildRoot, bundle) {
   }
   if (entry === null) {
     throw new Error(
-      "wallet.kind='altana' but @altananetwork/sdk is not resolvable from the agent project \u2014 the zip runtime could never load the Altana session wallet. Run `pnpm add @altananetwork/sdk@0.5.1` in app/agent, or deploy as a container."
+      "wallet.kind='altana' but @altananetwork/sdk is not resolvable from the agent project \u2014 the zip runtime could never load the Altana session wallet. Run `pnpm add @altananetwork/sdk@0.7.1` in app/agent, or deploy as a container."
     );
   }
   const pkgDir = path.join(buildRoot, "node_modules", "@altananetwork", "sdk");
@@ -288,7 +296,7 @@ async function stageAltanaSdk(agentDir, buildRoot, bundle) {
     `${JSON.stringify(
       {
         name: "@altananetwork/sdk",
-        version: altanaSdkVersionOf(entry),
+        version: packageVersionOf(entry, "@altananetwork/sdk"),
         private: true,
         type: "module",
         main: "index.js"
@@ -299,14 +307,76 @@ async function stageAltanaSdk(agentDir, buildRoot, bundle) {
 `
   );
 }
-function altanaSdkVersionOf(entry) {
+async function stageTurnkeySdk(agentDir, buildRoot, bundle) {
+  let kind = "evm-local";
+  try {
+    const cfg = loadStudioToml(path.join(agentDir, "studio.toml"));
+    const wallet = cfg.wallet;
+    if (wallet !== null && typeof wallet === "object" && !Array.isArray(wallet)) {
+      kind = String(wallet.kind ?? "evm-local");
+    }
+  } catch {
+  }
+  if (kind !== "turnkey") {
+    return;
+  }
+  const packageNames = [
+    TURNKEY_SDK_SERVER_PACKAGE,
+    TURNKEY_VIEM_PACKAGE
+  ];
+  const entries = /* @__PURE__ */ new Map();
+  try {
+    for (const packageName of packageNames) {
+      const entry = resolveProjectTurnkeySdkEntry(agentDir, packageName);
+      if (entry !== null) {
+        entries.set(packageName, entry);
+      }
+    }
+  } catch (exc) {
+    throw new Error(
+      `wallet.kind='turnkey' zip build: ${exc instanceof Error ? exc.message : exc}`
+    );
+  }
+  if (entries.size !== packageNames.length) {
+    const missing = packageNames.filter((name) => !entries.has(name));
+    throw new Error(
+      `wallet.kind='turnkey' zip build: missing ${missing.join(", ")}; install both Turnkey packages in app/agent: pnpm add ${TURNKEY_SDK_SERVER_PACKAGE} ${TURNKEY_VIEM_PACKAGE}, or deploy as a container.`
+    );
+  }
+  for (const packageName of packageNames) {
+    const entry = entries.get(packageName);
+    const packageDir = path.join(
+      buildRoot,
+      "node_modules",
+      ...packageName.split("/")
+    );
+    fs.mkdirSync(packageDir, { recursive: true });
+    await bundle(entry, path.join(packageDir, "index.js"));
+    fs.writeFileSync(
+      path.join(packageDir, "package.json"),
+      `${JSON.stringify(
+        {
+          name: packageName,
+          version: packageVersionOf(entry, packageName),
+          private: true,
+          type: "module",
+          main: "index.js"
+        },
+        null,
+        2
+      )}
+`
+    );
+  }
+}
+function packageVersionOf(entry, packageName) {
   let cursor = path.dirname(entry);
   for (let i = 0; i < 4; i += 1) {
     const manifest = path.join(cursor, "package.json");
     if (isFile(manifest)) {
       try {
         const pkg = JSON.parse(fs.readFileSync(manifest, "utf-8"));
-        if (pkg.name === "@altananetwork/sdk") {
+        if (pkg.name === packageName) {
           return typeof pkg.version === "string" ? pkg.version : "0.0.0";
         }
       } catch {
@@ -686,8 +756,8 @@ function packageRoot() {
   }
 }
 function studioCliVersion() {
-  if ("0.0.11") {
-    return "0.0.11";
+  if ("0.0.12-alpha.2") {
+    return "0.0.12-alpha.2";
   }
   const file = path3.join(packageRoot(), "package.json");
   const pkg = JSON.parse(fs3.readFileSync(file, "utf-8"));

package/dist/{deployCli-4ATY3SUP.js → deployCli-IVINTRNJ.js}

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

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@bnbagent/studio-cli",
-  "version": "0.0.11",
+  "version": "0.0.12-alpha.2",
   "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",
@@ -25,7 +25,6 @@
     "directory": "packages/studio-cli"
   },
   "type": "module",
-  "packageManager": "pnpm@10.24.0",
   "engines": {
     "node": ">=22"
   },
@@ -42,16 +41,8 @@
   "bin": {
     "bag": "./dist/bag.js"
   },
-  "scripts": {
-    "build": "tsup",
-    "test": "vitest run",
-    "lint": "biome check src tests",
-    "typecheck": "tsc --noEmit",
-    "check": "pnpm typecheck && pnpm lint && pnpm test && pnpm build"
-  },
   "dependencies": {
-    "@bnbagent/sdk": "0.5.0",
-    "@bnbagent/studio-runtime": "0.0.11",
+    "@bnbagent/sdk": "0.5.1-alpha.3",
     "ai": "^7.0.29",
     "archiver": "^8.0.0",
     "commander": "^15.0.0",
@@ -62,7 +53,8 @@
     "smol-toml": "^1.3.0",
     "tar": "^7.4.0",
     "viem": "^2.54.0",
-    "yaml": "^2.9.0"
+    "yaml": "^2.9.0",
+    "@bnbagent/studio-runtime": "0.0.12-alpha.2"
   },
   "devDependencies": {
     "@a2a-js/sdk": "^0.3.14",
@@ -78,5 +70,12 @@
     "typescript": "^5.5.0",
     "vitest": "^2.0.0",
     "zod": "^3.25.76"
+  },
+  "scripts": {
+    "build": "tsup",
+    "test": "vitest run",
+    "lint": "biome check src tests",
+    "typecheck": "tsc --noEmit",
+    "check": "pnpm typecheck && pnpm lint && pnpm test && pnpm build"
   }
-}
+}

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.0",
+    "@bnbagent/sdk@0.5.1-alpha.2",
 ]
 
 [env]

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.0",
+    "@bnbagent/sdk@0.5.1-alpha.2",
     # 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.0",
+    "@bnbagent/sdk@0.5.1-alpha.2",
     # 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/wallet/recipe.toml

@@ -1,17 +1,22 @@
 [recipe]
 name = "wallet"
-description = "Configures the agent's wallet: 'evm-local' (default encrypted keystore), 'twak' (Trust Wallet Agent Kit CLI), or 'altana' (encrypted admin keystore plus one bounded runtime session)."
+description = "Configures the agent's wallet: 'evm-local' (default encrypted keystore), 'twak' (Trust Wallet Agent Kit CLI), 'altana' (encrypted admin keystore plus one bounded runtime session), or 'turnkey' (remote signer; the key lives in Turnkey's AWS Nitro enclave)."
 
 [dependencies]
 node = ["@bnbagent/studio-runtime"]
 
 [dependencies.altana]
-node = ["@altananetwork/sdk@0.5.1"]
+node = ["@altananetwork/sdk@0.7.1"]
+
+[dependencies.turnkey]
+node = ["@turnkey/sdk-server@8.1.0", "@turnkey/viem@0.14.34"]
 
 [env]
 # kind='twak': the twak CLI reads the unlock password from the environment —
 # it never goes on a command line.
 TWAK_WALLET_PASSWORD = "unlocks ~/.twak/wallet.json (twak kind); set in .studio/.env.local"
+# kind='turnkey': P-256 API credential; the signing key never leaves Turnkey's enclave.
+TURNKEY_API_PRIVATE_KEY = "Turnkey P-256 API private key (turnkey kind); set in .studio/.env.local"
 # kind='evm-local' (the `bag init` default) or kind='altana' admin operations:
 WALLET_PASSWORD = "set to a strong password (>= 12 chars); encrypts .studio/wallets/<addr>.json (runtime never receives it for altana)"
 

package/recipes/x402-buyer/recipe.toml

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

package/skills/references/bnbagent-studio-buying-from-bazaar.md

@@ -51,6 +51,8 @@ verified = true                                         # studio-reviewed shelf
 
 Hard-stop cases: a reviewed merchant whose live payTo drifts from the studio pin (address rotation or tampering - upgrade studio or verify out-of-band and pass `--pay-to`), and `--cap` below the live per-call price.
 
+Wallet kinds and rails: `evm-local` signs EIP-3009 locally; `twak` and `altana` route through a delegated payer that prefers the merchant's permit2 route. Altana smart-account payments are verified by the B402 facilitator on its permit2 rails (live since 2026-08, CMC field-verified) and need the one-time `bag wallet session x402-setup` arming (checker approval + bounded U→Permit2 allowance) - `bag doctor` shows the arming state as `[wallet] Altana x402 buying`.
+
 ## Step 2 - wire the buyer tools into the agent
 
 ```bash
@@ -99,7 +101,8 @@ bag dev        # then ask the agent something that needs the paid data
 | `X402RecipientRequiredError` | No pinned recipient for that host → same fix |
 | `X402RecipientMismatchError` | Live payTo drifted from the pin - do NOT override casually; re-verify the merchant |
 | `X402BudgetExhaustedError` | Per-call cap or daily budget hit - raise `per_call_cap_usd` / `[budget].max_per_day_usd` deliberately |
-| `x402 402 has no EIP-3009-payable option` | Merchant offers only permit2/other methods for $U on this network - not payable by this buyer today |
+| `x402 402 has no EIP-3009-payable option` | Merchant offers only permit2/other methods for $U on this network - a local-signing (`evm-local`) buyer cannot sign those. Delegated wallets pay permit2 routes through their own client: `twak` (mainnet), or `altana` sessions (ERC-1271; B402 verifies them on the permit2 rails - arm once with `bag wallet session x402-setup`) |
+| `U→Permit2 allowance … cannot cover max_usd` | Altana only: the bounded Permit2 allowance is spent/too small - re-run `bag wallet session x402-setup --allowance-u <amount>` (admin key) |
 | `X402PolicyError` / `PolicyViolation` | Signing allowlist - see `bnbagent-studio-extending-signing.md` |
 
 **Different from**:

package/skills/references/bnbagent-studio-extending-signing.md

@@ -61,7 +61,7 @@ The user wants the agent to pay e.g. `api.example.com` via x402.
 2. The service uses **EIP-3009 `TransferWithAuthorization`** (or `ReceiveWithAuthorization`). If it uses Permit2 or a custom primary type → goes to Section B.
 3. The token contract address on BSC is known and the user can confirm it. Don't guess from a token symbol - look up the deployed address.
 
-If any of (1)-(3) fail, **stop and tell the user**. The current release cannot integrate cross-chain services or non-EIP-3009 payment rails. Do not work around it; the SigningPolicy will refuse the request.
+If any of (1)-(3) fail, **stop and tell the user**. The current release cannot integrate cross-chain services or non-EIP-3009 payment rails into the LOCAL signer. Do not work around it; the SigningPolicy will refuse the request. (Merchants that only offer permit2 are still payable without touching SigningPolicy - through a delegated wallet kind: `twak`, or `altana` sessions, whose ERC-1271 signatures B402 verifies on its permit2 rails. That is a wallet-kind choice, not a signing extension.)
 
 **Steps when (1)-(3) all pass:**
 

package/skills/references/bnbagent-studio-selling-via-b402.md

@@ -144,7 +144,7 @@ When the credentials, IP allowlist, and facilitator environment are ready, run t
 bag x402 sell status
 ```
 
-For a sandbox/trial agent, it must find exact/eip3009 U on `eip155:97`. For production it must find the mainnet environment expected by the project. A network mismatch is not safe to ignore.
+For a sandbox/trial agent, it must find an exact U kind on `eip155:97` (the probe lists the offered rails, e.g. `(eip3009, permit2-exact)`). For production it must find the mainnet environment expected by the project. A network mismatch is not safe to ignore.
 
 Run the deployment gate, then redeploy to activate the selected mode:
 
@@ -165,4 +165,5 @@ On the managed platform the deploy summary must say `x402 rail is ACTIVE` (or `A
 - Settlement happens before work. A later work failure retains the payment and does not trigger an automatic refund.
 - The rail activates on AgentCore and Azure Foundry targets (managed platform or self-hosted); self-hosted targets have no anonymous URL and need an operator-run envelope-v1 front.
 - PAID B402 payout wallets must use `wallet.kind` `evm-local` (private-key wallet stored as an encrypted keystore) or `twak`. Altana is unsupported. FREE x402 bypasses B402, has no payout, and must not be described as Altana B402 support.
+- Buyer compatibility: the 402 challenge advertises both `exact` rails - `eip3009` (EOA buyers, no pre-authorization) and `permit2-exact` (B402 verifies ERC-1271 smart-account signatures on this rail, so Altana sessions and ERC-4337 wallets can pay; the buyer needs a bounded U→Permit2 allowance first - see `bnbagent-studio-using-altana-wallet.md`). Rails are filtered against the facilitator's live `/supported`; `bag x402 sell status` prints which rails it actually offers, e.g. `(eip3009, permit2-exact)`. The seller never verifies signatures locally on either rail.
 - Never describe FREE as a zero-value B402 settlement. It bypasses B402.

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

@@ -48,6 +48,8 @@ x402 buying remains separate and exact-bounded:
 bag wallet session x402-setup --allowance-u <U> --yes
 ```
 
+Once armed, `bag x402 buy` pays b402-facilitated merchants (e.g. CoinMarketCap) end to end: B402 verifies the session's ERC-1271 signature on its **permit2 rails** (live since 2026-08). Studio's own b402 sellers advertise `permit2-exact` alongside `eip3009`, so Altana wallets can pay studio-hosted merchants too; eip3009-only merchants still need a 65-byte EOA signature and cannot be paid by a smart account. The buy preflight checks the U→Permit2 allowance against the spend cap, and `bag doctor` reports `[wallet] Altana x402 buying`. Use `@altananetwork/sdk` 0.7.1 in the project.
+
 Altana cannot be the b402 **seller** payout wallet for a positive price (paid mode allows `evm-local` and `twak` only); init, `bag x402 sell init`, and deploy readiness reject that paid combination. Explicit `price_usd = "0"` is allowed because FREE passthrough performs no payout and bypasses B402. The outbound buying authority above remains a separate feature.
 
 For troubleshooting, run `bag doctor` and `bag wallet session status`. Do not print, parse, or copy the `signer` portion of the serialized session, and never move `.studio/wallets/` under `app/agent/`.