@bnbagent/studio-cli 0.0.14-alpha.6 → 0.0.14-alpha.7
This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
- package/README.md +2 -2
- package/dist/bag.js +4 -4
- package/dist/{chunk-P4YB7JBD.js → chunk-DGGXWAGI.js} +3 -3
- package/dist/{deployCli-3E2EMAEW.js → deployCli-FDDZXKMO.js} +1 -1
- package/package.json +3 -3
- package/skills/bnbagent-studio.md +1 -1
- package/skills/references/bnbagent-studio-use-aws-agentcore.md +1 -1
- package/skills/references/bnbagent-studio-use-azure-foundry.md +2 -2
- package/skills/references/bnbagent-studio-use-bnb-trial.md +1 -1
- package/skills/references/bnbagent-studio-use-createos.md +6 -6
package/README.md
CHANGED
|
@@ -316,7 +316,7 @@ This package is licensed under Apache-2.0 and provided **as is**, without warran
|
|
|
316
316
|
|
|
317
317
|
### CreateOS (NodeOps)
|
|
318
318
|
|
|
319
|
-
Studio pins deploy 0.6.
|
|
319
|
+
Studio pins deploy 0.6.6 and loads its published Node.js SDK. Configure the agent:
|
|
320
320
|
|
|
321
321
|
```toml
|
|
322
322
|
[deploy.nodeops]
|
|
@@ -339,6 +339,6 @@ bag deploy destroy --provider nodeops # preview
|
|
|
339
339
|
bag deploy destroy --provider nodeops --execute --yes # delete project
|
|
340
340
|
```
|
|
341
341
|
|
|
342
|
-
Account mode supports ZIP/container deployment, runtime secrets and updates. An unhealthy endpoint makes deploy exit nonzero while preserving `.studio/deployments/nodeops.json`; inspect logs and retry verification. Wallet runtime variables use `settings.runEnvs` through the pinned deploy 0.6.
|
|
342
|
+
Account mode supports ZIP/container deployment, runtime secrets and updates. An unhealthy endpoint makes deploy exit nonzero while preserving `.studio/deployments/nodeops.json`; inspect logs and retry verification. Wallet runtime variables use `settings.runEnvs` through the pinned deploy 0.6.6; the pinned SDK 0.5.7-alpha.2 supports BSC nested Permit2 signing with explicit policy opt-in. The Studio bridge now supports bounded approval transactions with an explicit gas budget during authorized payments. Hosting renewal is not yet integrated. `bag deploy wallet --json` reads Gateway chains and USDC balances without signing or paying. CreateOS uses NodeOps infrastructure; AWS and Azure providers deploy into your own cloud account.
|
|
343
343
|
|
|
344
344
|
The installed skill includes `references/bnbagent-studio-use-createos.md` with configuration, capability limits and recovery steps.
|
package/dist/bag.js
CHANGED
|
@@ -72,7 +72,7 @@ import {
|
|
|
72
72
|
x402SellerIsFree,
|
|
73
73
|
x402SellerPricingState,
|
|
74
74
|
x402SellerUsesB402
|
|
75
|
-
} from "./chunk-
|
|
75
|
+
} from "./chunk-DGGXWAGI.js";
|
|
76
76
|
import {
|
|
77
77
|
validateAgentcoreName
|
|
78
78
|
} from "./chunk-U7IDQ3K5.js";
|
|
@@ -771,7 +771,7 @@ import {
|
|
|
771
771
|
var CAMPAIGN_DOC_URL = "https://www.bnbchain.org/en/blog/bnb-agent-studio-is-live-on-bnb-chain-ai-agents-from-one-prompt";
|
|
772
772
|
var CAMPAIGN_CHECK_TIMEOUT_MS = 6e3;
|
|
773
773
|
async function fetchCampaignActive() {
|
|
774
|
-
const { bnbPlatformApiUrl: bnbPlatformApiUrl2 } = await import("./deployCli-
|
|
774
|
+
const { bnbPlatformApiUrl: bnbPlatformApiUrl2 } = await import("./deployCli-FDDZXKMO.js");
|
|
775
775
|
const controller = new AbortController();
|
|
776
776
|
const timer = setTimeout(() => controller.abort(), CAMPAIGN_CHECK_TIMEOUT_MS);
|
|
777
777
|
try {
|
|
@@ -15200,7 +15200,7 @@ async function loadNodeOpsSdk() {
|
|
|
15200
15200
|
).resolve("@bnbagent/deploy-provider-nodeops/sdk");
|
|
15201
15201
|
} catch {
|
|
15202
15202
|
throw new Error(
|
|
15203
|
-
"Installed deploy package lacks the NodeOps Node.js SDK. Reinstall Studio with its pinned @bnbagent/deploy-cli 0.6.
|
|
15203
|
+
"Installed deploy package lacks the NodeOps Node.js SDK. Reinstall Studio with its pinned @bnbagent/deploy-cli 0.6.6 dependency."
|
|
15204
15204
|
);
|
|
15205
15205
|
}
|
|
15206
15206
|
}
|
|
@@ -15651,7 +15651,7 @@ async function inspectNodeOpsWallet(root, deps = {}) {
|
|
|
15651
15651
|
const sdk = await (deps.sdk ?? loadNodeOpsSdk)();
|
|
15652
15652
|
if (!sdk.createGatewayWalletClient)
|
|
15653
15653
|
throw new Error(
|
|
15654
|
-
"The installed deploy SDK lacks Gateway wallet queries. Reinstall Studio with its pinned deploy 0.6.
|
|
15654
|
+
"The installed deploy SDK lacks Gateway wallet queries. Reinstall Studio with its pinned deploy 0.6.6 dependency."
|
|
15655
15655
|
);
|
|
15656
15656
|
const address = cfg.options.walletAddress ?? (deps.wallet ?? getWallet3)().address;
|
|
15657
15657
|
if (typeof address !== "string" || !address)
|
|
@@ -947,8 +947,8 @@ function packageRoot() {
|
|
|
947
947
|
}
|
|
948
948
|
}
|
|
949
949
|
function studioCliVersion() {
|
|
950
|
-
if ("0.0.14-alpha.
|
|
951
|
-
return "0.0.14-alpha.
|
|
950
|
+
if ("0.0.14-alpha.7") {
|
|
951
|
+
return "0.0.14-alpha.7";
|
|
952
952
|
}
|
|
953
953
|
const file = path4.join(packageRoot(), "package.json");
|
|
954
954
|
const pkg = JSON.parse(fs4.readFileSync(file, "utf-8"));
|
|
@@ -1230,7 +1230,7 @@ function isTable(value) {
|
|
|
1230
1230
|
}
|
|
1231
1231
|
|
|
1232
1232
|
// src/cli/_deploy/deployCli.ts
|
|
1233
|
-
var DEPLOY_CLI_VERSION = "0.6.
|
|
1233
|
+
var DEPLOY_CLI_VERSION = "0.6.6";
|
|
1234
1234
|
var DEPLOY_CLI_PACKAGE = `@bnbagent/deploy-cli@${DEPLOY_CLI_VERSION}`;
|
|
1235
1235
|
var require2 = createRequire(import.meta.url);
|
|
1236
1236
|
function resolveLocalDeployCli() {
|
package/package.json
CHANGED
|
@@ -1,6 +1,6 @@
|
|
|
1
1
|
{
|
|
2
2
|
"name": "@bnbagent/studio-cli",
|
|
3
|
-
"version": "0.0.14-alpha.
|
|
3
|
+
"version": "0.0.14-alpha.7",
|
|
4
4
|
"description": "Skills-first toolkit and bag CLI for BNB Chain seller agents: ERC-8004 identity, ERC-8183 escrowed commerce, and x402 payments.",
|
|
5
5
|
"keywords": [
|
|
6
6
|
"bnb-chain",
|
|
@@ -42,7 +42,7 @@
|
|
|
42
42
|
"bag": "./dist/bag.js"
|
|
43
43
|
},
|
|
44
44
|
"dependencies": {
|
|
45
|
-
"@bnbagent/deploy-cli": "0.6.
|
|
45
|
+
"@bnbagent/deploy-cli": "0.6.6",
|
|
46
46
|
"@bnbagent/sdk": "0.5.7-alpha.2",
|
|
47
47
|
"ai": "^7.0.29",
|
|
48
48
|
"archiver": "^8.0.0",
|
|
@@ -55,7 +55,7 @@
|
|
|
55
55
|
"tar": "^7.4.0",
|
|
56
56
|
"viem": "^2.56.3",
|
|
57
57
|
"yaml": "^2.9.0",
|
|
58
|
-
"@bnbagent/studio-runtime": "0.0.14-alpha.
|
|
58
|
+
"@bnbagent/studio-runtime": "0.0.14-alpha.7"
|
|
59
59
|
},
|
|
60
60
|
"devDependencies": {
|
|
61
61
|
"@a2a-js/sdk": "^0.3.14",
|
|
@@ -67,7 +67,7 @@ Treat ERC-8183 amounts as decimal strings at CLI/config boundaries and `bigint`
|
|
|
67
67
|
|
|
68
68
|
## CLI groups at a glance
|
|
69
69
|
|
|
70
|
-
`init`, `scan`, `recipe`, `skills`, `wallet`, `erc8004`, `erc8183`, `x402`, `mpp`, `agents`, `config`, `env`, `dev`, `doctor`, `feedback`, `audit`, `deploy`, `platform`, `llm`, `bundle`, `budget` - see `bag --help` for details. `bag deploy [--provider bnb\|aws\|azure\|nodeops] [--backend aws\|azure]` is the primary deploy command; `--backend` is valid only for provider `bnb` and confirms the recipe-derived managed backend. `prepare`, `list`, `verify`, `status`, `info`, `destroy`, `logs`, and `fix-gitignore` remain lifecycle subcommands (`deploy agent` is a deprecated compatibility alias). Provider deploy/status/logs/destroy and deploy-time credential validation are delegated to pinned `@bnbagent/deploy-cli@0.6.
|
|
70
|
+
`init`, `scan`, `recipe`, `skills`, `wallet`, `erc8004`, `erc8183`, `x402`, `mpp`, `agents`, `config`, `env`, `dev`, `doctor`, `feedback`, `audit`, `deploy`, `platform`, `llm`, `bundle`, `budget` - see `bag --help` for details. `bag deploy [--provider bnb\|aws\|azure\|nodeops] [--backend aws\|azure]` is the primary deploy command; `--backend` is valid only for provider `bnb` and confirms the recipe-derived managed backend. `prepare`, `list`, `verify`, `status`, `info`, `destroy`, `logs`, and `fix-gitignore` remain lifecycle subcommands (`deploy agent` is a deprecated compatibility alias). Provider deploy/status/logs/destroy and deploy-time credential validation are delegated to pinned `@bnbagent/deploy-cli@0.6.6`.
|
|
71
71
|
|
|
72
72
|
## Tool surface
|
|
73
73
|
|
|
@@ -1,6 +1,6 @@
|
|
|
1
1
|
---
|
|
2
2
|
name: bnbagent-studio-use-aws-agentcore
|
|
3
|
-
description: When the user wants to deploy or operate a bnbagent-studio project on AWS Bedrock AgentCore - deploy with `bag deploy --provider aws` (all cloud lifecycle mutations are delegated to pinned `@bnbagent/deploy-cli@0.6.
|
|
3
|
+
description: When the user wants to deploy or operate a bnbagent-studio project on AWS Bedrock AgentCore - deploy with `bag deploy --provider aws` (all cloud lifecycle mutations are delegated to pinned `@bnbagent/deploy-cli@0.6.6`), inspect with `bag deploy status` / `logs --provider aws` / `verify --provider aws`, and tear down with `bag deploy destroy --provider aws --execute [--purge]`. Also covers AWS credential prerequisites, the optional read-only quota probe, and the runtime-secret channel.
|
|
4
4
|
---
|
|
5
5
|
|
|
6
6
|
> **Reference file** of the `bnbagent-studio` router skill - installed at `bnbagent-studio/references/` and loaded on demand (not a standalone skill). Route here via the router's decision tree.
|
|
@@ -1,6 +1,6 @@
|
|
|
1
1
|
---
|
|
2
2
|
name: bnbagent-studio-use-azure-foundry
|
|
3
|
-
description: When the user wants to deploy or operate a bnbagent-studio project on Azure AI Foundry Hosted Agents - scaffold with `bag init --runtime azure-foundry`, deploy either to the managed platform with `bag deploy --provider bnb --backend azure` or directly with `bag deploy --provider azure`; all cloud lifecycle execution is delegated to pinned `@bnbagent/deploy-cli@0.6.
|
|
3
|
+
description: When the user wants to deploy or operate a bnbagent-studio project on Azure AI Foundry Hosted Agents - scaffold with `bag init --runtime azure-foundry`, deploy either to the managed platform with `bag deploy --provider bnb --backend azure` or directly with `bag deploy --provider azure`; all cloud lifecycle execution is delegated to pinned `@bnbagent/deploy-cli@0.6.6`. Native MCP is not supported on Azure; use AgentCore for MCP.
|
|
4
4
|
---
|
|
5
5
|
|
|
6
6
|
> **Reference file** of the `bnbagent-studio` router skill - installed at `bnbagent-studio/references/` and loaded on demand (not a standalone skill). Route here via the router's decision tree.
|
|
@@ -31,7 +31,7 @@ Procedure for deploying and operating the seller Agent on **Azure AI Foundry Hos
|
|
|
31
31
|
|
|
32
32
|
1. **Bun 1.3+ (`bunx`) on PATH** - the pinned `@bnbagent/deploy-cli` runs through it.
|
|
33
33
|
2. **Docker running** - the image is built locally (linux/amd64) before push.
|
|
34
|
-
3. **An Azure subscription** the operator may provision in (Foundry account/project, container registry, hosted agent). Before a local self-deploy, run `bunx --bun @bnbagent/deploy-cli@0.6.
|
|
34
|
+
3. **An Azure subscription** the operator may provision in (Foundry account/project, container registry, hosted agent). Before a local self-deploy, run `bunx --bun @bnbagent/deploy-cli@0.6.6 login --provider azure`; use OIDC/service-principal credentials in CI.
|
|
35
35
|
|
|
36
36
|
## ⚠️ Foundry gotchas (read before deploying)
|
|
37
37
|
|
|
@@ -9,7 +9,7 @@ description: Use when deploying or operating a bnbagent-studio seller on the BNB
|
|
|
9
9
|
|
|
10
10
|
Treat this provider as a temporary testnet sandbox. Require a throwaway wallet, keep `bsc-testnet`, and explain that the runtime signing material is transmitted to the operator's managed secret store for the trial. Never use a mainnet key. Exception: `wallet.kind='altana'` ships only the bounded, budget-limited, revocable session - the throwaway-wallet advice does not apply; tighten the session instead (`bag wallet session grant --force --budget-u <small> --expiry-days <short>`) and never run `bag wallet new` on an altana project (it breaks the session's `[wallet].address` anchor).
|
|
11
11
|
|
|
12
|
-
All auth and cloud lifecycle work must cross the pinned `@bnbagent/deploy-cli@0.6.
|
|
12
|
+
All auth and cloud lifecycle work must cross the pinned `@bnbagent/deploy-cli@0.6.6` boundary. Do not call a cloud CLI or platform REST routes directly. The managed backend is recipe-derived: `agentcore` uses AWS; `azure-foundry` uses Azure. For headless managed Azure, confirm with `bag deploy --provider bnb --backend azure --yes`; never treat `--backend` as a cross-cloud recipe converter.
|
|
13
13
|
|
|
14
14
|
## Select and authenticate
|
|
15
15
|
|
|
@@ -1,17 +1,17 @@
|
|
|
1
1
|
---
|
|
2
2
|
name: bnbagent-studio-use-createos
|
|
3
|
-
description: Deploy and operate Studio agents on CreateOS through the nodeops provider and published deploy 0.6.
|
|
3
|
+
description: Deploy and operate Studio agents on CreateOS through the nodeops provider and published deploy 0.6.6 SDK. Covers account credentials, ZIP/container packaging, runtime secrets, health recovery, project lifecycle and wallet payment restrictions.
|
|
4
4
|
---
|
|
5
5
|
|
|
6
6
|
# Deploy and operate on CreateOS
|
|
7
7
|
|
|
8
|
-
Use Studio's `nodeops` provider for NodeOps-hosted infrastructure. AWS and Azure providers remain separate choices for infrastructure in the user's own cloud account. Studio pins `@bnbagent/deploy-cli@0.6.
|
|
8
|
+
Use Studio's `nodeops` provider for NodeOps-hosted infrastructure. AWS and Azure providers remain separate choices for infrastructure in the user's own cloud account. Studio pins `@bnbagent/deploy-cli@0.6.6` and resolves the published `@bnbagent/deploy-provider-nodeops/sdk` through that dependency. No local deploy checkout, source override or Bun process is required for NodeOps.
|
|
9
9
|
|
|
10
10
|
## Check the installed CLI
|
|
11
11
|
|
|
12
12
|
Run `bag --version` and `bag deploy --help`. Confirm that `nodeops` is advertised before following this reference; older Studio releases lack the adapter. If absent, use the main skill's approved upgrade workflow. Do not bypass Studio with a raw provider deployment, because it omits Studio packaging, secrets and resource records.
|
|
13
13
|
|
|
14
|
-
The generic router's minimum version does not establish NodeOps compatibility. Use the release's documented CLI version with deploy 0.6.
|
|
14
|
+
The generic router's minimum version does not establish NodeOps compatibility. Use the release's documented CLI version with deploy 0.6.6; an alpha may be required while npm `latest` lacks this integration. Do not repeatedly install `latest` without checking its capabilities. Reuse existing installation authorization and verify the selected CLI's version and provider after installation.
|
|
15
15
|
|
|
16
16
|
## Complete a build-and-deploy request
|
|
17
17
|
|
|
@@ -106,7 +106,7 @@ Deletion removes project environments too; registry images and payment history r
|
|
|
106
106
|
|
|
107
107
|
Read this section before choosing a wallet for NodeOps. Use `evm-local` for the currently tested Studio signing path. Turnkey implements the required public signing interfaces but still needs provider-specific live acceptance testing. TWAK lacks generic EIP-712 signing; Altana's session `x402.pay` is not wired into Gateway authentication/payment. Do not silently replace an existing wallet to work around these limits.
|
|
108
108
|
|
|
109
|
-
Studio pins published deploy 0.6.
|
|
109
|
+
Studio pins published deploy 0.6.6, which supports runtime credentials through `settings.runEnvs`, independently of the uploaded archive. The 2026-09-10 standalone live probe confirmed Dockerfile deployment, BSC MPP settlement and runtime variable injection; the installed-package integration suite covers the Studio path with injected HTTP responses. These do not establish secret-vault encryption, redaction or variable rotation. If readiness reports an older SDK without runtime variable support, follow the approved CLI upgrade workflow; do not use a source override or embed credentials in the artifact.
|
|
110
110
|
|
|
111
111
|
For evm-local workloads, runtime variables include the encrypted `WALLET_KEYSTORE_JSON` and its `WALLET_PASSWORD`. NodeOps therefore receives the material needed by the deployed agent to unlock and use that wallet. The claim "no private-key export" applies to the hosting-payment signer, not to runtime custody. Explain this boundary when choosing the deployment wallet, honor existing custody authorization and prefer a dedicated wallet for new third-party-hosted agents. Do not display or log the secret payload or imply that keystore encryption keeps it inaccessible to a runtime that also receives the password.
|
|
112
112
|
|
|
@@ -166,11 +166,11 @@ bag deploy verify --provider nodeops --skip-register
|
|
|
166
166
|
|
|
167
167
|
`--skip-prepare` skips readiness checks only; the fatal storage guard and deploy SDK validation still run. `--force` does not override fatal storage or wallet signing checks. The explicit `--force-deploy-broken-storage` override permits knowingly deploying broken/local storage with a warning; do not add it merely to get a deployment through. `prepare --provider nodeops` selects the cloud provider, not a local runtime named nodeops.
|
|
168
168
|
|
|
169
|
-
`deploy wallet` is read-only and reports on-chain USDC. `createosCredits: null` means unknown hosting credits, not zero. Funding and hidden credential entry may require the user's terminal/wallet. Base/Arbitrum require their exact USDC domain
|
|
169
|
+
`deploy wallet` is read-only and reports on-chain USDC. `createosCredits: null` means unknown hosting credits, not zero. Funding and hidden credential entry may require the user's terminal/wallet. Base/Arbitrum require their exact USDC domain instead of the BSC Permit2 configuration. With deploy 0.6.6 and SDK 0.5.7-alpha.2, their MPP/x402 credential windows are rejected by the default 600-second wallet policy; treat this as a compatibility blocker and do not relax that policy or switch chains without authorization. `RPC_URL_BSC` overrides the default `https://bsc-dataseed.bnbchain.org`; RPC requests have bounded timeouts and do not retry broadcasts automatically.
|
|
170
170
|
|
|
171
171
|
`--yes` confirms deployment; `--pay` additionally authorizes payment within the caps. An initial deploy POST may consume existing credits and create a project even without a payment challenge. `use_existing_credits` is the separate choice for credits shared by active projects. `auto_pay=true` additionally requires the approved `pay_to` recipient pin. It automates payment when deployment is invoked; it does not schedule renewal.
|
|
172
172
|
|
|
173
|
-
Wallet deployments are create-only. Use `status` and `verify` after an acknowledged build failure, timeout or uncertain response; retain `.studio/deployments/nodeops.json` and deploy's durable journal under `~/.bnbagent-deploy/nodeops/payments/`. With deploy 0.6.
|
|
173
|
+
Wallet deployments are create-only. Use `status` and `verify` after an acknowledged build failure, timeout or uncertain response; retain `.studio/deployments/nodeops.json` and deploy's durable journal under `~/.bnbagent-deploy/nodeops/payments/`. With deploy 0.6.6, a verified pre-broadcast failure releases the reservation and a retry can resume the same deployment. An ambiguous approval broadcast, a submitted payment, or an old reservation without preparation evidence must remain blocked for reconciliation; missing resource IDs are not proof that payment failed. All callers of a wallet must share one journal for budget aggregation and locking. Do not change names, clear the journal or submit another payment to recover an unknown outcome. Logs, existing-image deployment, named-environment management and in-place updates are not exposed by the current wallet adapter.
|
|
174
174
|
|
|
175
175
|
## When the user asks to renew
|
|
176
176
|
|