@bnbagent/studio-cli 0.0.6-alpha.1

package/dist/chunk-7RAKL4AS.js

@@ -0,0 +1,172 @@
+#!/usr/bin/env node
+
+// src/cli/_twak.ts
+import * as os from "os";
+import * as path from "path";
+import { resolveTwakHome } from "@bnbagent/studio-runtime/wallet";
+
+// src/cli/proc.ts
+import { execa } from "execa";
+async function runCapture(cmd, args, opts = {}) {
+  const result = await execa(cmd, args, {
+    cwd: opts.cwd,
+    env: opts.env,
+    input: opts.input,
+    timeout: opts.timeoutMs,
+    reject: false,
+    stripFinalNewline: false
+  });
+  return {
+    code: result.exitCode ?? 1,
+    stdout: typeof result.stdout === "string" ? result.stdout : "",
+    stderr: typeof result.stderr === "string" ? result.stderr : ""
+  };
+}
+async function runStream(cmd, args, opts = {}) {
+  const result = await execa(cmd, args, {
+    cwd: opts.cwd,
+    env: opts.env,
+    timeout: opts.timeoutMs,
+    reject: false,
+    stdio: "inherit"
+  });
+  return result.exitCode ?? 1;
+}
+async function runCaptureOut(cmd, args, opts = {}) {
+  const result = await execa(cmd, args, {
+    cwd: opts.cwd,
+    env: opts.env,
+    input: opts.input,
+    timeout: opts.timeoutMs,
+    reject: false,
+    stripFinalNewline: false,
+    stdout: "pipe",
+    stderr: "inherit"
+  });
+  return {
+    code: result.exitCode ?? 1,
+    stdout: typeof result.stdout === "string" ? result.stdout : ""
+  };
+}
+
+// src/cli/_twak.ts
+var TWAK_CLI_VERSION = "0.20.0";
+var TWAK_CLI_MIN_VERSION = [
+  0,
+  20,
+  0
+];
+var TWAK_NODE_MIN_MAJOR = 20;
+function twakVersionBelowFloor(installed) {
+  const floor = TWAK_CLI_MIN_VERSION;
+  for (let i = 0; i < floor.length; i += 1) {
+    const a = installed[i] ?? 0;
+    const b = floor[i];
+    if (a !== b) {
+      return a < b;
+    }
+  }
+  return false;
+}
+async function whichTwak() {
+  const cmd = process.platform === "win32" ? "where" : "which";
+  const result = await runCapture(cmd, ["twak"]);
+  if (result.code !== 0) {
+    return null;
+  }
+  const line = result.stdout.split("\n")[0]?.trim();
+  return line ? line : null;
+}
+async function twakInstalledVersion() {
+  if (await whichTwak() === null) {
+    return null;
+  }
+  let out;
+  try {
+    const result = await runCapture("twak", ["--version"], {
+      timeoutMs: 15e3
+    });
+    out = result.stdout;
+  } catch {
+    return null;
+  }
+  const m = /(\d+)\.(\d+)\.(\d+)/.exec(out || "");
+  if (m === null) {
+    return null;
+  }
+  return [
+    Number.parseInt(m[1], 10),
+    Number.parseInt(m[2], 10),
+    Number.parseInt(m[3], 10)
+  ];
+}
+function twakHomeDir(walletCfg, projectRoot) {
+  const home = resolveTwakHome(walletCfg ?? {}, projectRoot ?? null);
+  return path.join(home ?? os.homedir(), ".twak");
+}
+function twakWalletFile(walletCfg, projectRoot) {
+  return path.join(twakHomeDir(walletCfg, projectRoot), "wallet.json");
+}
+function twakDoubledHomeHint(walletFile) {
+  const doubled = `${path.sep}.twak${path.sep}.twak${path.sep}`;
+  if (!walletFile.includes(doubled)) {
+    return null;
+  }
+  return `hint: the resolved wallet path ${walletFile} nests .twak/.twak \u2014 [wallet].twak_home in studio.toml likely points at the .twak directory itself. Set it to the PARENT directory (the runtime appends .twak/wallet.json) and re-run.`;
+}
+function twakCreateGuidance(fields) {
+  return `error: wallet.kind = "twak" \u2014 \`bag wallet new\` does not create twak wallets.
+studio never puts a wallet password on argv (upstream S-8), so it will not shell
+out \`twak wallet create --password \u2026\` for you. Create the wallet ONCE
+(you choose the password; pick a strong one).
+
+RECOMMENDED \u2014 let studio drive the create step with the password OFF argv:
+
+    bag wallet twak-init --password-stdin      # CI: printf %s "$PW" | bag wallet twak-init --password-stdin
+    bag wallet twak-init --password-file <f>   # file must be chmod 600
+    bag wallet twak-init                       # interactive hidden prompt
+
+(the one-time NaaS setup below applies to BOTH paths; the manual twak
+commands follow it.)
+
+First get Trust Wallet NaaS API credentials (one time): make an app at
+https://portal.trustwallet.com/dashboard/apps \u2192 copy its Access ID + HMAC
+secret, then run \`twak setup\` (without them \`twak wallet create\` fails with
+"No API credentials found"):
+
+    ${fields.setupCmd}
+
+then create the wallet \u2014 interactive (password on twak's own argv; twak warns,
+and it lands in your shell history \u2014 acceptable for a throwaway hot wallet):
+
+    ${fields.createCmd}
+
+  \u2014 or, to keep the password OFF argv (CI / scripts), pass it via the
+    environment and let \`twak setup\` create the wallet non-interactively:
+
+    TWAK_NONINTERACTIVE=1 TWAK_SETUP_WALLET=create TWAK_WALLET_PASSWORD=<pw> ${fields.setupCmd}
+
+    (this stores the password in the OS keychain and needs one that persists;
+    on headless / Docker runners without a keychain it aborts \u2014 use the argv
+    form above there.)
+
+then set TWAK_WALLET_PASSWORD in .studio/.env.local and re-run
+    bag wallet new        # adopts the address into studio.toml
+Guide: the bnbagent-studio-using-twak-wallet.md reference (installed by \`bag skills install\`).`;
+}
+
+export {
+  runCapture,
+  runStream,
+  runCaptureOut,
+  TWAK_CLI_VERSION,
+  TWAK_CLI_MIN_VERSION,
+  TWAK_NODE_MIN_MAJOR,
+  twakVersionBelowFloor,
+  whichTwak,
+  twakInstalledVersion,
+  twakHomeDir,
+  twakWalletFile,
+  twakDoubledHomeHint,
+  twakCreateGuidance
+};