@heyamiko/amiko-cli 0.7.9 → 0.8.0

package/dist/index.js

@@ -71810,12 +71810,14 @@ function resetConfig() {
   return true;
 }
 function getPrivyToken(config) {
-  return config.privyToken || config.creatorToken;
+  return config.privyToken;
 }
 function normalizeConfig(config) {
   const normalized = { ...config };
-  if (!normalized.privyToken && normalized.creatorToken) {
-    normalized.privyToken = normalized.creatorToken;
+  const raw = normalized;
+  if (!normalized.privyToken && typeof raw.creatorToken === "string") {
+    normalized.privyToken = raw.creatorToken;
+    delete raw.creatorToken;
   }
   if (LEGACY_SITE_BASES.has(normalized.siteBase)) {
     normalized.siteBase = DEFAULTS.siteBase;
@@ -71996,6 +71998,13 @@ function success(text) {
 function warn(text) {
   return source_default.yellow("⚠ ") + text;
 }
+function renderOutput(data, human, opts = {}) {
+  if (opts.json) {
+    console.log(JSON.stringify(data, null, 2));
+    return;
+  }
+  human(data);
+}
 
 // src/onboarding.ts
 var SKIP_COMMANDS = new Set([
@@ -72984,10 +72993,7 @@ function authHeaders() {
 }
 async function get(path) {
   const res = await fetch(`${mppBase()}${path}`, { headers: authHeaders() });
-  if (!res.ok) {
-    const text = await res.text().catch(() => "");
-    throw new Error(`${res.status} ${res.statusText}: ${text}`);
-  }
+  await assertOk(res);
   return res.json();
 }
 async function bootstrapPrivyAccount(token, base = loadConfig().billingBase) {
@@ -72997,10 +73003,7 @@ async function bootstrapPrivyAccount(token, base = loadConfig().billingBase) {
       "Content-Type": "application/json"
     }
   });
-  if (!res.ok) {
-    const text = await res.text().catch(() => "");
-    throw new Error(`${res.status} ${res.statusText}: ${text}`);
-  }
+  await assertOk(res);
   return res.json();
 }
 async function createConnectedKeyTopupCheckout(input) {
@@ -73017,15 +73020,18 @@ async function createConnectedKeyTopupCheckout(input) {
       cancelUrl: `${siteBase}/?topup=cancelled`
     })
   });
-  if (!res.ok) {
-    const text = await res.text().catch(() => "");
-    throw new Error(`${res.status} ${res.statusText}: ${text}`);
-  }
+  await assertOk(res);
   return res.json();
 }
 function trimBase(base) {
   return base.replace(/\/$/, "");
 }
+async function assertOk(res) {
+  if (!res.ok) {
+    const text = await res.text().catch(() => "");
+    throw new Error(`${res.status} ${res.statusText}: ${text}`);
+  }
+}
 
 // src/lib/tempo.ts
 import { execFile, execFileSync as execFileSync2 } from "node:child_process";
@@ -73321,7 +73327,6 @@ var VALID_KEYS = [
   "wallet",
   "apiKey",
   "privyToken",
-  "creatorToken",
   "userId",
   "twinId",
   "twinToken",
@@ -73475,7 +73480,6 @@ import { execFileSync as execFileSync4 } from "node:child_process";
 function buildVerifiedAuthConfig(token, bootstrap) {
   return {
     privyToken: token,
-    creatorToken: undefined,
     userId: bootstrap.userId,
     connectedKeyId: bootstrap.connectedKey?.id,
     connectedKeyName: bootstrap.connectedKey?.name,
@@ -73690,7 +73694,6 @@ Run "amiko login" again to re-authenticate, or "amiko logout" to sign out.
     }
     saveConfig({
       privyToken: undefined,
-      creatorToken: undefined,
       userId: undefined,
       connectedKeyId: undefined,
       connectedKeyName: undefined,
@@ -74166,7 +74169,8 @@ function registerBridgeCommand(program2) {
         params.originChainId = resolveChainId(opts.from);
       if (opts.to)
         params.destinationChainId = resolveChainId(opts.to);
-      const routes = await getAvailableRoutes(params);
+      const routesData = await getAvailableRoutes(params);
+      const routes = Array.isArray(routesData) ? routesData : [];
       const usdcRoutes = routes.filter((r19) => r19.originTokenSymbol === "USDC" || r19.destinationTokenSymbol === "USDC");
       spinner.stop();
       console.log(heading("USDC Bridge Routes"));
@@ -74407,6 +74411,9 @@ Tip: you can also generate a connect link from your Amiko settings`));
   });
 }
 
+// src/commands/credits.ts
+import readline from "node:readline";
+
 // src/lib/mpp-topup.ts
 async function mppCreditsTopup(params) {
   const config2 = loadConfig();
@@ -74468,6 +74475,21 @@ async function mppCreditsTopup(params) {
 }
 
 // src/commands/credits.ts
+function promptYesNo(question) {
+  if (!process.stdin.isTTY) {
+    return Promise.resolve(false);
+  }
+  const rl = readline.createInterface({
+    input: process.stdin,
+    output: process.stdout
+  });
+  return new Promise((resolve2) => {
+    rl.question(question, (answer) => {
+      rl.close();
+      resolve2(/^y(es)?$/i.test(answer.trim()));
+    });
+  });
+}
 function registerCreditsCommand(program2) {
   const credits = program2.command("credits").description("Manage Amiko credit balance and top-ups");
   credits.command("balance").description("Show credit balance and agent wallet balances").action(async () => {
@@ -74574,12 +74596,41 @@ function registerCreditsCommand(program2) {
       process.exit(1);
     }
   });
-  credits.command("topup <amount>").description("Top up credits by spending tokens from your agent wallet").option("--token <TOKEN>", "Token to use for top-up").option("--chain <CHAIN>", "Chain to use for top-up").option("--wallet <ADDR>", "Wallet address to use").option("--method <METHOD>", "Payment method: auto, crossmint, mpp", "auto").option("--yes", "Skip confirmation prompt").action(async (amountStr, options) => {
-    const creditsAmount = parseInt(amountStr.replace(/,/g, ""), 10);
-    if (isNaN(creditsAmount) || creditsAmount <= 0) {
-      console.error(error(`Invalid amount: ${amountStr}`));
+  credits.command("topup [amount]").description("Top up credits by spending tokens from your agent wallet. <amount> is in credits (10,000 = $1.00). Use --usd <n> to specify dollars, or --spend <n> to specify a token amount (e.g. 1 SOL worth).").option("--token <TOKEN>", "Token to use for top-up").option("--chain <CHAIN>", "Chain to use for top-up").option("--wallet <ADDR>", "Wallet address to use").option("--method <METHOD>", "Payment method: auto, crossmint, mpp", "auto").option("--usd <amount>", "Amount in USD instead of credits (e.g. --usd 1 for $1 = 10,000 credits)").option("--spend <amount>", "Spend this many units of --token and convert to credits at current price (e.g. --spend 1 --token SOL for '1 SOL worth of credits')").option("--yes", "Skip the interactive Proceed? prompt (summary still prints)").action(async (amountStr, options) => {
+    const inputs = [amountStr, options.usd, options.spend].filter((v8) => v8 != null && v8 !== "");
+    if (inputs.length !== 1) {
+      console.error(error("Specify exactly one of: <amount> (credits), --usd <dollars>, or --spend <token amount>."));
       process.exit(1);
     }
+    let presetCredits = null;
+    let presetUsd = null;
+    let presetSpend = null;
+    if (options.usd != null) {
+      const usd2 = parseFloat(String(options.usd).replace(/,/g, ""));
+      if (!isFinite(usd2) || usd2 <= 0) {
+        console.error(error(`Invalid --usd value: ${options.usd}`));
+        process.exit(1);
+      }
+      presetUsd = usd2;
+    } else if (options.spend != null) {
+      const spend = parseFloat(String(options.spend).replace(/,/g, ""));
+      if (!isFinite(spend) || spend <= 0) {
+        console.error(error(`Invalid --spend value: ${options.spend}`));
+        process.exit(1);
+      }
+      if (!options.token) {
+        console.error(error("--spend requires --token (e.g. --spend 1 --token SOL)"));
+        process.exit(1);
+      }
+      presetSpend = spend;
+    } else {
+      const credits2 = parseInt(String(amountStr).replace(/,/g, ""), 10);
+      if (isNaN(credits2) || credits2 <= 0) {
+        console.error(error(`Invalid amount: ${amountStr}`));
+        process.exit(1);
+      }
+      presetCredits = credits2;
+    }
     const spinner = ora("Resolving auth...").start();
     try {
       const auth = resolveAuth(loadConfig());
@@ -74605,39 +74656,11 @@ function registerCreditsCommand(program2) {
         "Content-Type": "application/json"
       };
       spinner.stop();
-      if (options.method === "mpp" && auth.userId && auth.connectedKeyId) {
-        const spinner2 = ora("Topping up credits via MPP...").start();
-        const mppResult = await mppCreditsTopup({
-          userId: auth.userId,
-          keyId: auth.connectedKeyId,
-          amount: creditsAmount / 1e4
-        });
-        spinner2.stop();
-        if (!mppResult.success) {
-          console.error(error(mppResult.error || "MPP top-up failed"));
-          process.exit(1);
-        }
-        console.log(heading("Top-up Complete (MPP)"));
-        console.log("");
-        if (mppResult.credits?.balance)
-          console.log(label("Balance", mppResult.credits.balance));
-        console.log(success("Credits topped up via MPP."));
-        return;
-      }
-      const agentWallet = auth.agentWallets?.find((w5) => w5.source === "agent");
-      const walletAddr = options.wallet || agentWallet?.address || auth.agentWallets?.[0]?.address;
-      const walletChain = options.chain || auth.agentWallets?.find((w5) => w5.address === walletAddr)?.chain || "solana";
       const token = options.token || "AMIKO";
-      if (!walletAddr) {
-        console.error(error("No wallet found. Specify --wallet <address>"));
-        process.exit(1);
-      }
-      const usdAmount = creditsAmount / 1e4;
-      let tokenAmount;
-      let pricePerToken = null;
       const stablecoins = ["usdc", "usdt", "usdc.e", "usdt0"];
-      if (stablecoins.includes(token.toLowerCase())) {
-        tokenAmount = usdAmount;
+      const isStable = stablecoins.includes(token.toLowerCase());
+      let pricePerToken = null;
+      if (isStable) {
         pricePerToken = 1;
       } else {
         const spinner2 = ora(`Fetching ${token} price...`).start();
@@ -74663,7 +74686,6 @@ function registerCreditsCommand(program2) {
           }
           const jupData = await jupRes.json();
           pricePerToken = parseFloat(jupData.outAmount) / 1e6;
-          tokenAmount = usdAmount / pricePerToken;
           spinner2.stop();
         } catch {
           spinner2.stop();
@@ -74671,6 +74693,62 @@ function registerCreditsCommand(program2) {
           process.exit(1);
         }
       }
+      let creditsAmount;
+      let usdAmount;
+      let tokenAmount;
+      if (presetSpend != null) {
+        tokenAmount = presetSpend;
+        usdAmount = tokenAmount * pricePerToken;
+        creditsAmount = Math.round(usdAmount * 1e4);
+      } else if (presetUsd != null) {
+        usdAmount = presetUsd;
+        creditsAmount = Math.round(usdAmount * 1e4);
+        tokenAmount = usdAmount / pricePerToken;
+      } else {
+        creditsAmount = presetCredits;
+        usdAmount = creditsAmount / 1e4;
+        tokenAmount = usdAmount / pricePerToken;
+      }
+      if (options.method === "mpp" && auth.userId && auth.connectedKeyId) {
+        if (!options.yes) {
+          console.log(heading("Top-up Summary (MPP)"));
+          console.log("");
+          console.log(label("Credits", creditsAmount.toLocaleString()));
+          console.log(label("USD", `$${usdAmount.toFixed(2)}`));
+          console.log(dim("Charged via MPP connected key."));
+          console.log("");
+          const ok = await promptYesNo("Proceed? [y/N] ");
+          if (!ok) {
+            console.log(dim("Top-up cancelled."));
+            process.exit(0);
+          }
+          console.log("");
+        }
+        const spinner2 = ora("Topping up credits via MPP...").start();
+        const mppResult = await mppCreditsTopup({
+          userId: auth.userId,
+          keyId: auth.connectedKeyId,
+          amount: usdAmount
+        });
+        spinner2.stop();
+        if (!mppResult.success) {
+          console.error(error(mppResult.error || "MPP top-up failed"));
+          process.exit(1);
+        }
+        console.log(heading("Top-up Complete (MPP)"));
+        console.log("");
+        if (mppResult.credits?.balance)
+          console.log(label("Balance", String(mppResult.credits.balance)));
+        console.log(success("Credits topped up via MPP."));
+        return;
+      }
+      const agentWallet = auth.agentWallets?.find((w5) => w5.source === "agent");
+      const walletAddr = options.wallet || agentWallet?.address || auth.agentWallets?.[0]?.address;
+      const walletChain = options.chain || auth.agentWallets?.find((w5) => w5.address === walletAddr)?.chain || "solana";
+      if (!walletAddr) {
+        console.error(error("No wallet found. Specify --wallet <address>"));
+        process.exit(1);
+      }
       const shortWallet = walletAddr.length > 12 ? `${walletAddr.slice(0, 6)}...${walletAddr.slice(-4)}` : walletAddr;
       console.log(heading("Top-up Summary"));
       console.log("");
@@ -74682,6 +74760,14 @@ function registerCreditsCommand(program2) {
       console.log(label("From", `wallet ${shortWallet} (${walletChain})`));
       console.log(dim("Tokens will be transferred from your agent wallet to the treasury."));
       console.log("");
+      if (!options.yes) {
+        const confirmed = await promptYesNo("Proceed? [y/N] ");
+        if (!confirmed) {
+          console.log(dim("Top-up cancelled."));
+          process.exit(0);
+        }
+        console.log("");
+      }
       if (["base", "ethereum", "tempo"].includes(walletChain)) {
         console.error(error("EVM topup not supported yet. Use a Solana wallet with --token AMIKO, USDC, USDT, or SOL."));
         process.exit(1);
@@ -74922,8 +75008,8 @@ function registerSwapCommand(program2) {
       console.log("");
       const isInteractive2 = process.stdin.isTTY && !opts.yes;
       if (isInteractive2) {
-        const readline = await import("readline");
-        const rl = readline.createInterface({
+        const readline2 = await import("readline");
+        const rl = readline2.createInterface({
           input: process.stdin,
           output: process.stdout
         });
@@ -75005,6 +75091,8 @@ function registerSwapCommand(program2) {
 
 // src/commands/update.ts
 import { execFileSync as execFileSync6 } from "node:child_process";
+import fs from "node:fs";
+import path from "node:path";
 function detectPackageManager() {
   try {
     execFileSync6("bun", ["--version"], { stdio: "ignore" });
@@ -75013,6 +75101,43 @@ function detectPackageManager() {
     return "npm";
   }
 }
+var DATA_CLI = "/data/.amiko-cli";
+var NPM_GLOBAL_CANDIDATES = [
+  "/usr/local/lib/node_modules/@heyamiko/amiko-cli",
+  "/usr/lib/node_modules/@heyamiko/amiko-cli"
+];
+var BIN_TARGET = "/usr/local/bin/amiko";
+var TWIN_SKILL_DIRS = [
+  "/data/.openclaw/skills/amiko-cli",
+  "/data/.openclaw/workspace/skills/amiko-cli"
+];
+function syncTwinInstall() {
+  if (!fs.existsSync(DATA_CLI))
+    return false;
+  const src = NPM_GLOBAL_CANDIDATES.find((p13) => fs.existsSync(p13));
+  if (!src)
+    return false;
+  fs.rmSync(DATA_CLI, { recursive: true, force: true });
+  execFileSync6("cp", ["-rL", src, DATA_CLI]);
+  try {
+    fs.unlinkSync(BIN_TARGET);
+  } catch {}
+  fs.symlinkSync(path.join(DATA_CLI, "dist/index.js"), BIN_TARGET);
+  try {
+    fs.chmodSync(BIN_TARGET, 493);
+  } catch {}
+  const skillSrc = path.join(DATA_CLI, "skills/SKILL.md");
+  if (fs.existsSync(skillSrc)) {
+    for (const dir of TWIN_SKILL_DIRS) {
+      const parent = path.dirname(dir);
+      if (!fs.existsSync(parent))
+        continue;
+      fs.mkdirSync(dir, { recursive: true });
+      fs.copyFileSync(skillSrc, path.join(dir, "SKILL.md"));
+    }
+  }
+  return true;
+}
 function registerUpdateCommand(program2) {
   program2.command("update").description("Update amiko-cli to the latest version").action(async () => {
     const pm = detectPackageManager();
@@ -75034,6 +75159,17 @@ function registerUpdateCommand(program2) {
         });
       }
       spinner.stop();
+      let syncedTwin = false;
+      try {
+        const twinSpinner = ora("Refreshing twin install...").start();
+        syncedTwin = syncTwinInstall();
+        twinSpinner.stop();
+        if (syncedTwin) {
+          console.log(dim("Refreshed /data/.amiko-cli, symlink, and skill files."));
+        }
+      } catch (err) {
+        console.log(dim(`Twin sync failed: ${err instanceof Error ? err.message : String(err)}. Container restart will apply the update.`));
+      }
       let newVersion = "latest";
       try {
         newVersion = execFileSync6("amiko", ["--version"], {
@@ -75056,10 +75192,123 @@ function registerUpdateCommand(program2) {
   });
 }
 
+// src/lib/balance.ts
+async function fetchCreditsBalance(auth) {
+  const billingToken = auth.platformKey || auth.twinToken || auth.privyToken;
+  if (!billingToken)
+    return null;
+  const base2 = (auth.billingBase || "https://billing.heyamiko.com").replace(/\/$/, "");
+  try {
+    const res = await fetch(`${base2}/api/credits`, {
+      headers: { Authorization: `Bearer ${billingToken}` }
+    });
+    if (!res.ok)
+      return null;
+    const data = await res.json();
+    const raw = data.displayBalance ?? Number(data.credits?.balance ?? 0);
+    return typeof raw === "number" && isFinite(raw) ? Math.round(raw) : null;
+  } catch {
+    return null;
+  }
+}
+async function printBalanceRemaining(auth) {
+  const balance = await fetchCreditsBalance(auth);
+  if (balance == null) {
+    console.log(dim("Balance: (could not fetch)"));
+    return;
+  }
+  const usd2 = (balance / 1e4).toFixed(2);
+  console.log(label("Balance", `${balance.toLocaleString()} credits (~$${usd2})`));
+}
+
+// src/lib/errors.ts
+async function reportHttpError(res, label2) {
+  const text = await res.text().catch(() => "");
+  console.error(error(`${label2} failed: ${res.status} ${res.statusText || ""}`.trim()));
+  if (!text)
+    return;
+  let pretty = text;
+  try {
+    const parsed = JSON.parse(text);
+    pretty = parsed?.error ?? parsed?.message ?? parsed?.detail ?? JSON.stringify(parsed, null, 2);
+  } catch {}
+  console.error(dim("Response body:"));
+  console.error(String(pretty).slice(0, 2000));
+}
+
+// src/lib/confirm.ts
+import readline2 from "node:readline";
+function promptYesNo2(question) {
+  const rl = readline2.createInterface({
+    input: process.stdin,
+    output: process.stdout
+  });
+  return new Promise((resolve2) => {
+    rl.question(question, (answer) => {
+      rl.close();
+      resolve2(/^y(es)?$/i.test(answer.trim()));
+    });
+  });
+}
+async function confirmDestructive(args) {
+  if (args.yes)
+    return;
+  if (process.stdin.isTTY) {
+    console.log("");
+    console.log(warn(args.action));
+    if (args.detail)
+      console.log(dim(args.detail));
+    const ok = await promptYesNo2("Proceed? [y/N] ");
+    if (!ok) {
+      console.log(dim("Cancelled."));
+      process.exit(0);
+    }
+    return;
+  }
+  console.error(error(`Refusing to run without --yes (non-interactive shell).`));
+  console.error("");
+  console.error(`Action: ${args.action}`);
+  if (args.detail)
+    console.error(dim(args.detail));
+  console.error("");
+  console.error(dim("Re-run with --yes to confirm:"));
+  console.error(dim(`  ${args.commandExample} --yes`));
+  process.exit(2);
+}
+async function requireApproval(args) {
+  if (args.yes)
+    return;
+  if (process.stdin.isTTY) {
+    console.log("");
+    console.log(`About to run: ${args.summary}`);
+    console.log(`Cost: ${args.cost}`);
+    const ok = await promptYesNo2("Proceed? [y/N] ");
+    if (!ok) {
+      console.log(dim("Cancelled."));
+      process.exit(0);
+    }
+    return;
+  }
+  console.error(error(`Refusing to run without --yes (non-interactive shell detected).`));
+  console.error("");
+  console.error(`This command will cost ${args.cost}.`);
+  console.error(`Action: ${args.summary}`);
+  console.error("");
+  console.error(dim(`Quote the cost to the user, get their explicit approval, then re-run with --yes:`));
+  console.error(dim(`  ${args.commandExample} --yes`));
+  process.exit(2);
+}
+
 // src/commands/search.ts
 var TREASURY = "FPiZAf3jEnNfCwfvbv46jdPfHbmSepD4Q6iHiLJDQXvb";
 function registerSearchCommand(program2) {
-  program2.command("search <query>").description("X Search — pays 1 AMIKO token per search").option("--raw", "Output raw JSON").option("--token <token>", "Payment token (AMIKO, USDC, SOL)", "AMIKO").action(async (query, opts) => {
+  program2.command("search <query>").description("X Search — pays 1 AMIKO token per search").option("--raw", "Output raw JSON").option("--token <token>", "Payment token (AMIKO, USDC, SOL)", "AMIKO").option("--yes", "Skip the pre-spend confirmation (required in non-interactive shells)").action(async (query, opts) => {
+    await requireApproval({
+      cost: `1 ${opts.token || "AMIKO"}`,
+      summary: `X/Twitter search: ${query.slice(0, 80)}${query.length > 80 ? "…" : ""}`,
+      yes: opts.yes,
+      commandExample: `amiko search ${JSON.stringify(query)}${opts.token && opts.token !== "AMIKO" ? ` --token ${opts.token}` : ""}`
+    });
     const spinner = ora("X Search...").start();
     try {
       const config2 = loadConfig();
@@ -75125,8 +75374,7 @@ function registerSearchCommand(program2) {
       });
       spinner.stop();
       if (!res.ok) {
-        const text = await res.text().catch(() => "");
-        console.error(error(`Search failed: ${res.status} ${text.slice(0, 200)}`));
+        await reportHttpError(res, "Search");
         const explorer = chain === "solana" ? `https://solscan.io/tx/${txHash}` : `https://explorer.tempo.xyz/tx/${txHash}`;
         console.log(dim(`Payment tx: ${explorer}`));
         process.exit(1);
@@ -75155,6 +75403,7 @@ function registerSearchCommand(program2) {
         }
       }
       console.log(success(`Paid ${amount2} ${token}`) + dim(` tx: ${txHash.slice(0, 16)}...`));
+      await printBalanceRemaining(auth);
     } catch (err) {
       spinner.stop();
       console.error(error(err instanceof Error ? err.message : "Search failed"));
@@ -75166,8 +75415,41 @@ function registerSearchCommand(program2) {
 // src/commands/image.ts
 var TREASURY2 = "FPiZAf3jEnNfCwfvbv46jdPfHbmSepD4Q6iHiLJDQXvb";
 function registerImageCommand(program2) {
-  program2.command("image <prompt>").alias("img").description("Generate an image — costs 5 AMIKO").option("--size <size>", "Image size: 1024x1024, 1024x1792, 1792x1024", "1024x1024").option("--quality <q>", "Quality: auto, low, medium, high (gpt-image-1) or standard, hd (dall-e-3)", "auto").option("--model <model>", "Model: gpt-image-1 or dall-e-3", "gpt-image-1").option("--background <bg>", "Background: transparent, opaque, auto (gpt-image-1 only)").option("--format <fmt>", "Output: png, webp, jpeg (gpt-image-1 only)", "png").option("--raw", "Output raw JSON").action(async (prompt2, opts) => {
-    const spinner = ora("Generating image...").start();
+  program2.command("image <prompt>").alias("img").description("Generate an image — costs 5 AMIKO").option("--size <size>", "Image size: 1024x1024, 1024x1792, 1792x1024", "1024x1024").option("--quality <q>", "Quality: auto, low, medium, high (gpt-image-1) or standard, hd (dall-e-3)", "auto").option("--model <model>", "Model: gpt-image-1 or dall-e-3", "gpt-image-1").option("--background <bg>", "Background: transparent, opaque, auto (gpt-image-1 only)").option("--format <fmt>", "Output: png, webp, jpeg (gpt-image-1 only)", "png").option("--raw", "Output raw JSON").option("--yes", "Skip the pre-spend confirmation (required in non-interactive shells)").action(async (prompt2, opts) => {
+    await requireApproval({
+      cost: "5 AMIKO",
+      summary: `Generate image: ${prompt2.slice(0, 80)}${prompt2.length > 80 ? "…" : ""}`,
+      yes: opts.yes,
+      commandExample: `amiko image ${JSON.stringify(prompt2)}`
+    });
+    const isTTY = process.stderr.isTTY;
+    const spinner = isTTY ? ora("Generating image...").start() : null;
+    let progressTimer = null;
+    const started = Date.now();
+    const setStatus = (text) => {
+      if (spinner) {
+        spinner.text = text;
+      } else {
+        console.error(text);
+      }
+    };
+    const startProgress = (text) => {
+      setStatus(text);
+      if (!spinner && !progressTimer) {
+        progressTimer = setInterval(() => {
+          const elapsed = Math.round((Date.now() - started) / 1000);
+          console.error(`  …still working (${elapsed}s elapsed)`);
+        }, 3000);
+      }
+    };
+    const stopProgress = () => {
+      if (progressTimer) {
+        clearInterval(progressTimer);
+        progressTimer = null;
+      }
+      if (spinner)
+        spinner.stop();
+    };
     try {
       const config2 = loadConfig();
       const auth = resolveAuth(config2);
@@ -75175,18 +75457,18 @@ function registerImageCommand(program2) {
       const billingBase = auth.billingBase || "https://billing.heyamiko.com";
       const billingToken = auth.platformKey || auth.twinToken || auth.privyToken;
       if (!billingToken) {
-        spinner.stop();
+        stopProgress();
         console.error(error("Not authenticated. Check .amiko.json credentials."));
         process.exit(1);
       }
       const allWallets = auth.agentWallets || config2.agentWallets || [];
       const solanaWallet = allWallets.find((w5) => w5.chain === "solana")?.address;
       if (!solanaWallet) {
-        spinner.stop();
+        stopProgress();
         console.error(error("No Solana wallet for AMIKO payment."));
         process.exit(1);
       }
-      spinner.text = "Paying 5 AMIKO...";
+      setStatus("Paying 5 AMIKO...");
       const transferRes = await fetch(`${billingBase}/api/crossmint/wallets/${encodeURIComponent(solanaWallet)}/transfer`, {
         method: "POST",
         headers: {
@@ -75201,7 +75483,7 @@ function registerImageCommand(program2) {
         })
       });
       if (!transferRes.ok) {
-        spinner.stop();
+        stopProgress();
         const err = await transferRes.json().catch(() => ({ error: "Transfer failed" }));
         console.error(error(err.error || `Payment failed: ${transferRes.status}`));
         process.exit(1);
@@ -75209,11 +75491,11 @@ function registerImageCommand(program2) {
       const transferData = await transferRes.json();
       const txHash = transferData.txHash;
       if (!txHash) {
-        spinner.stop();
+        stopProgress();
         console.error(error("Payment sent but no tx hash returned."));
         process.exit(1);
       }
-      spinner.text = "Generating image...";
+      startProgress("Generating image...");
       const res = await fetch(`${mppBase2}/v1/ai/openai/images`, {
         method: "POST",
         headers: {
@@ -75229,10 +75511,9 @@ function registerImageCommand(program2) {
           ...opts.model === "gpt-image-1" && { output_format: opts.format || "png" }
         })
       });
-      spinner.stop();
+      stopProgress();
       if (!res.ok) {
-        const text = await res.text().catch(() => "");
-        console.error(error(`Image generation failed: ${res.status} ${text.slice(0, 300)}`));
+        await reportHttpError(res, "Image generation");
         console.log(dim(`Payment tx: https://solscan.io/tx/${txHash}`));
         process.exit(1);
       }
@@ -75261,8 +75542,9 @@ function registerImageCommand(program2) {
       }
       console.log("");
       console.log(success("Paid 5 AMIKO") + dim(` tx: ${txHash.slice(0, 16)}...`));
+      await printBalanceRemaining(auth);
     } catch (err) {
-      spinner.stop();
+      stopProgress();
       console.error(error(err instanceof Error ? err.message : "Image generation failed"));
       process.exit(1);
     }
@@ -75291,7 +75573,13 @@ async function payAmiko(billingBase, billingToken, solanaWallet, amount2) {
 }
 function registerAmazonCommand(program2) {
   const cmd = program2.command("amazon").description("Search and buy products on Amazon — paid with AMIKO");
-  cmd.command("search <query>").description("Search Amazon products — 1 AMIKO").option("--limit <n>", "Number of results", "5").option("--raw", "Output raw JSON").action(async (query, opts) => {
+  cmd.command("search <query>").description("Search Amazon products — 1 AMIKO").option("--limit <n>", "Number of results", "5").option("--raw", "Output raw JSON").option("--yes", "Skip the pre-spend confirmation (required in non-interactive shells)").action(async (query, opts) => {
+    await requireApproval({
+      cost: "1 AMIKO",
+      summary: `Amazon product search: ${query.slice(0, 80)}${query.length > 80 ? "…" : ""}`,
+      yes: opts.yes,
+      commandExample: `amiko amazon search ${JSON.stringify(query)}`
+    });
     const spinner = ora("Searching Amazon...").start();
     try {
       const config2 = loadConfig();
@@ -75322,8 +75610,7 @@ function registerAmazonCommand(program2) {
       });
       spinner.stop();
       if (!res.ok) {
-        const text = await res.text().catch(() => "");
-        console.error(error(`Search failed: ${res.status} ${text.slice(0, 200)}`));
+        await reportHttpError(res, "Amazon search");
         process.exit(1);
       }
       const data = await res.json();
@@ -75353,6 +75640,7 @@ function registerAmazonCommand(program2) {
         console.log(dim("  No results found."));
       }
       console.log(success("Paid 1 AMIKO") + dim(` tx: ${txHash.slice(0, 16)}...`));
+      await printBalanceRemaining(auth);
     } catch (err) {
       spinner.stop();
       console.error(error(err instanceof Error ? err.message : "Search failed"));
@@ -75385,8 +75673,7 @@ function registerAmazonCommand(program2) {
       });
       spinner.stop();
       if (!res.ok) {
-        const text = await res.text().catch(() => "");
-        console.error(error(`Quote failed: ${res.status} ${text.slice(0, 300)}`));
+        await reportHttpError(res, "Amazon quote");
         process.exit(1);
       }
       const data = await res.json();
@@ -75433,7 +75720,7 @@ function usdToAmiko(usd2, pricePerAmiko) {
   const amount2 = usd2 / pricePerAmiko;
   return Math.ceil(amount2 * 100) / 100 + "";
 }
-async function payAndCall(mppBase2, method, path, billingBase, billingToken, solanaWallet, amountOrAuto, body, onProgress, token = "AMIKO") {
+async function payAndCall(mppBase2, method, path2, billingBase, billingToken, solanaWallet, amountOrAuto, body, onProgress, token = "AMIKO") {
   let amount2 = amountOrAuto;
   if (amount2 === "auto") {
     onProgress?.("Fetching price...");
@@ -75441,7 +75728,7 @@ async function payAndCall(mppBase2, method, path, billingBase, billingToken, sol
       const specRes = await fetch(`${mppBase2}/openapi.json`);
       if (specRes.ok) {
         const spec = await specRes.json();
-        const pathSpec = spec.paths?.[path];
+        const pathSpec = spec.paths?.[path2];
         const methodSpec = pathSpec?.[method.toLowerCase()];
         const usdPrice = parseFloat(methodSpec?.["x-payment-info"]?.price || "0");
         if (usdPrice > 0) {
@@ -75488,13 +75775,19 @@ async function payAndCall(mppBase2, method, path, billingBase, billingToken, sol
   if (body && method !== "GET") {
     fetchOpts.body = JSON.stringify(body);
   }
-  const url2 = path.startsWith("http") ? path : `${mppBase2}${path}`;
+  const url2 = path2.startsWith("http") ? path2 : `${mppBase2}${path2}`;
   const res = await fetch(url2, fetchOpts);
   return { res, txHash, amikoSpent: amount2 };
 }
 function registerServicesCommand(program2) {
   const svc = program2.command("service").alias("svc").description("Call any MPP service — pays with AMIKO tokens");
-  svc.command("tts <voiceId> <text>").description("Text-to-speech — 1 AMIKO").option("--raw", "Output raw response").action(async (voiceId, text, opts) => {
+  svc.command("tts <voiceId> <text>").description("Text-to-speech — 1 AMIKO").option("--raw", "Output raw response").option("--yes", "Skip the pre-spend confirmation (required in non-interactive shells)").action(async (voiceId, text, opts) => {
+    await requireApproval({
+      cost: "1 AMIKO",
+      summary: `Text-to-speech (voice ${voiceId}): "${text.slice(0, 60)}${text.length > 60 ? "…" : ""}"`,
+      yes: opts.yes,
+      commandExample: `amiko service tts ${voiceId} ${JSON.stringify(text)}`
+    });
     await callService({
       name: "Text-to-Speech",
       method: "POST",
@@ -75504,7 +75797,13 @@ function registerServicesCommand(program2) {
       opts
     });
   });
-  svc.command("stt <audioUrl>").description("Speech-to-text — 1 AMIKO").option("--raw", "Output raw response").action(async (audioUrl, opts) => {
+  svc.command("stt <audioUrl>").description("Speech-to-text — 1 AMIKO").option("--raw", "Output raw response").option("--yes", "Skip the pre-spend confirmation (required in non-interactive shells)").action(async (audioUrl, opts) => {
+    await requireApproval({
+      cost: "1 AMIKO",
+      summary: `Speech-to-text on ${audioUrl}`,
+      yes: opts.yes,
+      commandExample: `amiko service stt ${JSON.stringify(audioUrl)}`
+    });
     await callService({
       name: "Speech-to-Text",
       method: "POST",
@@ -75532,7 +75831,13 @@ function registerServicesCommand(program2) {
       console.log(JSON.stringify(data, null, 2));
     }
   });
-  svc.command("chat <message>").description("AI chat — 1 AMIKO").option("--model <model>", "Model to use").option("--raw", "Output raw response").action(async (message, opts) => {
+  svc.command("chat <message>").description("AI chat — 1 AMIKO").option("--model <model>", "Model to use").option("--raw", "Output raw response").option("--yes", "Skip the pre-spend confirmation (required in non-interactive shells)").action(async (message, opts) => {
+    await requireApproval({
+      cost: "1 AMIKO",
+      summary: `AI chat${opts.model ? ` (model ${opts.model})` : ""}: "${message.slice(0, 60)}${message.length > 60 ? "…" : ""}"`,
+      yes: opts.yes,
+      commandExample: `amiko service chat ${JSON.stringify(message)}${opts.model ? ` --model ${opts.model}` : ""}`
+    });
     const body = { message };
     if (opts.model)
       body.model = opts.model;
@@ -75545,7 +75850,14 @@ function registerServicesCommand(program2) {
       opts
     });
   });
-  svc.command("call <method> <path> [body]").description("Call any MPP endpoint — pays in AMIKO or USDC on Solana").option("--amiko <amount>", "AMIKO tokens to pay (default: auto-price from USD)").option("--usdc <amount>", "Pay in USDC instead of AMIKO").option("--raw", "Output raw response").action(async (method, path, bodyStr, opts) => {
+  svc.command("call <method> <path> [body]").description("Call any MPP endpoint — pays in AMIKO or USDC on Solana").option("--amiko <amount>", "AMIKO tokens to pay (default: auto-price from USD)").option("--usdc <amount>", "Pay in USDC instead of AMIKO").option("--raw", "Output raw response").option("--yes", "Skip the pre-spend confirmation (required in non-interactive shells)").action(async (method, path2, bodyStr, opts) => {
+    const costLabel = opts.usdc ? `${opts.usdc} USDC` : opts.amiko ? `${opts.amiko} AMIKO` : "auto-priced AMIKO (check /v1/ list for endpoint price first)";
+    await requireApproval({
+      cost: costLabel,
+      summary: `${method.toUpperCase()} ${path2}`,
+      yes: opts.yes,
+      commandExample: `amiko service call ${method.toUpperCase()} ${path2}${bodyStr ? ` ${JSON.stringify(bodyStr)}` : ""}${opts.amiko ? ` --amiko ${opts.amiko}` : ""}${opts.usdc ? ` --usdc ${opts.usdc}` : ""}`
+    });
     let body;
     if (bodyStr) {
       try {
@@ -75555,9 +75867,9 @@ function registerServicesCommand(program2) {
       }
     }
     await callService({
-      name: `${method.toUpperCase()} ${path}`,
+      name: `${method.toUpperCase()} ${path2}`,
       method: method.toUpperCase(),
-      path,
+      path: path2,
       body,
       amiko: opts.amiko || (opts.usdc ? undefined : "auto"),
       usdc: opts.usdc,
@@ -75575,11 +75887,11 @@ function registerServicesCommand(program2) {
       console.log(heading(`MPP Services
 `));
       const paths = spec.paths || {};
-      for (const [path, methods] of Object.entries(paths)) {
+      for (const [path2, methods] of Object.entries(paths)) {
         for (const [method, op] of Object.entries(methods)) {
           const price = op["x-payment-info"]?.price;
           const priceLabel = price === "0" || !price ? source_default.green("FREE") : source_default.yellow(`$${parseFloat(price).toFixed(2)}`);
-          console.log(`  ${source_default.bold(method.toUpperCase().padEnd(6))} ${path.padEnd(40)} ${priceLabel}`);
+          console.log(`  ${source_default.bold(method.toUpperCase().padEnd(6))} ${path2.padEnd(40)} ${priceLabel}`);
           if (op.summary)
             console.log(dim(`         ${op.summary}`));
         }
@@ -75615,11 +75927,9 @@ async function callService(params) {
     const { res, txHash, amikoSpent } = await payAndCall(mppBase2, params.method, params.path, billingBase, billingToken, solanaWallet, token === "USDC" ? amount2 : amount2, params.body, (msg) => {
       spinner.text = msg;
     });
-    if (params.usdc) {}
     spinner.stop();
     if (!res.ok) {
-      const text = await res.text().catch(() => "");
-      console.error(error(`${params.name} failed: ${res.status} ${text.slice(0, 300)}`));
+      await reportHttpError(res, params.name);
       console.log(dim(`Payment tx: https://solscan.io/tx/${txHash}`));
       process.exit(1);
     }
@@ -75641,6 +75951,7 @@ async function callService(params) {
     }
     console.log("");
     console.log(success(`Paid ${amikoSpent} ${token}`) + dim(` tx: ${txHash.slice(0, 16)}...`));
+    await printBalanceRemaining(auth);
   } catch (err) {
     spinner.stop();
     console.error(error(err instanceof Error ? err.message : "Service call failed"));
@@ -75648,6 +75959,904 @@ async function callService(params) {
   }
 }
 
+// src/lib/amiko-web.ts
+var DEFAULT_PLATFORM_URL = "https://platform.heyamiko.com";
+function baseUrl(auth) {
+  const url2 = auth.platformUrl || DEFAULT_PLATFORM_URL;
+  return url2.replace(/\/$/, "");
+}
+function authHeader(auth) {
+  if (auth.privyToken)
+    return `Bearer am-${auth.privyToken}`;
+  if (auth.twinToken)
+    return `Bearer ${auth.twinToken}`;
+  throw new Error("No amiko-web auth available. Run `amiko login` to link your account.");
+}
+async function amikoWebFetch(auth, path2, opts = {}) {
+  const url2 = new URL(`${baseUrl(auth)}${path2}`);
+  if (opts.query) {
+    for (const [k6, v8] of Object.entries(opts.query)) {
+      if (v8 !== undefined && v8 !== null)
+        url2.searchParams.set(k6, String(v8));
+    }
+  }
+  const headers = {
+    Authorization: authHeader(auth),
+    ...opts.headers
+  };
+  let body;
+  if (opts.multipart) {
+    body = opts.multipart;
+  } else if (opts.rawBody) {
+    body = opts.rawBody;
+    if (opts.rawContentType)
+      headers["Content-Type"] = opts.rawContentType;
+  } else if (opts.body) {
+    body = JSON.stringify(opts.body);
+    headers["Content-Type"] = "application/json";
+  }
+  const controller = new AbortController;
+  const timeoutMs = opts.timeoutMs ?? 30000;
+  const timer = setTimeout(() => controller.abort(), timeoutMs);
+  let res;
+  try {
+    res = await fetch(url2, {
+      method: opts.method ?? "GET",
+      headers,
+      body,
+      signal: controller.signal
+    });
+  } finally {
+    clearTimeout(timer);
+  }
+  if (!res.ok) {
+    const text = await res.text().catch(() => "");
+    const err = new Error(formatError2(res.status, text, path2));
+    err.status = res.status;
+    err.body = text;
+    throw err;
+  }
+  const ctype = res.headers.get("content-type") || "";
+  if (ctype.includes("application/json")) {
+    return await res.json();
+  }
+  return await res.text();
+}
+function formatError2(status, body, path2) {
+  const prefix = `${status} ${path2}`;
+  if (status === 401) {
+    return `${prefix}: unauthorized. Run \`amiko connect\` to refresh your session.`;
+  }
+  if (status === 403) {
+    return `${prefix}: forbidden. The twin token does not have access to this resource.`;
+  }
+  if (!body)
+    return prefix;
+  const snippet = body.length > 500 ? `${body.slice(0, 500)}...` : body;
+  return `${prefix}: ${snippet}`;
+}
+
+// src/lib/twin-context.ts
+class TwinResolutionError extends Error {
+  constructor(message) {
+    super(message);
+  }
+}
+function resolveTwinId(args) {
+  const { flag, config: config2, auth } = args;
+  if (flag)
+    return flag;
+  if (auth.twinId)
+    return auth.twinId;
+  if (config2.twinId)
+    return config2.twinId;
+  throw new TwinResolutionError("No twin configured. Pass --twin <id> or provision one via .amiko.json.");
+}
+
+// src/commands/accounts.ts
+function registerAccountsCommand(program2) {
+  program2.command("accounts").description("Show resolved identity (platform, user, twin, wallets)").option("--json", "Output as JSON").action(async (opts) => {
+    const config2 = loadConfig();
+    const auth = resolveAuth(config2);
+    const data = {
+      mode: auth.mode,
+      platformUrl: auth.platformUrl ?? config2.platformUrl ?? config2.siteBase,
+      userId: auth.userId ?? null,
+      activeTwinId: auth.twinId ?? config2.twinId ?? null,
+      wallets: auth.agentWallets ?? [],
+      hasTwinToken: Boolean(auth.twinToken),
+      hasPlatformKey: Boolean(auth.platformKey)
+    };
+    renderOutput(data, (d13) => {
+      console.log(heading("Amiko Account"));
+      console.log(label("Mode", d13.mode));
+      if (d13.platformUrl)
+        console.log(label("Platform", d13.platformUrl));
+      if (d13.userId)
+        console.log(label("User ID", d13.userId));
+      if (d13.activeTwinId)
+        console.log(label("Active twin", d13.activeTwinId));
+      console.log(label("Wallets", String(d13.wallets.length)));
+      if (d13.mode === "none") {
+        console.log("");
+        console.log(error("No credentials found. Provision auth via .amiko.json or an API key."));
+      }
+    }, { json: opts.json });
+  });
+  program2.command("info").description("Get twin info (name, description, voice, avatar)").option("--twin <idOrName>", "Target twin id or name").option("--json", "Output as JSON").action(async (opts) => {
+    const config2 = loadConfig();
+    const auth = resolveAuth(config2);
+    let twinId;
+    try {
+      twinId = resolveTwinId({ flag: opts.twin, config: config2, auth });
+    } catch (e8) {
+      if (e8 instanceof TwinResolutionError) {
+        console.error(error(e8.message));
+        process.exit(1);
+      }
+      throw e8;
+    }
+    const spinner = opts.json ? null : ora("Fetching twin info...").start();
+    try {
+      const twin = await amikoWebFetch(auth, `/api/agents/${twinId}`);
+      spinner?.stop();
+      renderOutput(twin, (t17) => {
+        console.log(success(`${t17.name}`));
+        console.log(label("ID", t17.id));
+        if (t17.description)
+          console.log(label("Description", t17.description));
+        console.log(label("Public", t17.is_public ? "yes" : "no"));
+        if (t17.voice_status)
+          console.log(label("Voice", t17.voice_status));
+        if (t17.avatar_url)
+          console.log(label("Avatar", t17.avatar_url));
+        if (t17.shipped_at)
+          console.log(label("Shipped", t17.shipped_at));
+        if (t17.updated_at)
+          console.log(dim(`Updated ${t17.updated_at}`));
+      }, { json: opts.json });
+    } catch (e8) {
+      spinner?.stop();
+      console.error(error(e8 instanceof Error ? e8.message : String(e8)));
+      process.exit(1);
+    }
+  });
+}
+
+// src/commands/twin.ts
+function parseBool(raw, flag) {
+  const v8 = raw.toLowerCase();
+  if (v8 === "true" || v8 === "1" || v8 === "yes")
+    return true;
+  if (v8 === "false" || v8 === "0" || v8 === "no")
+    return false;
+  throw new Error(`${flag} must be true or false, got "${raw}"`);
+}
+function registerTwinCommand(program2) {
+  program2.command("twin:update").description("Update twin name, description, or public visibility").option("--name <name>", "Display name").option("--description <text>", "Description").option("--public <bool>", "Public visibility (true/false)").option("--twin <idOrName>", "Target twin id or name").option("--yes", "Skip confirmation when changing visibility").option("--json", "Output as JSON").action(async (opts) => {
+    if (opts.name === undefined && opts.description === undefined && opts.public === undefined) {
+      console.error(error("Pass at least one of --name, --description, --public"));
+      process.exit(1);
+    }
+    const config2 = loadConfig();
+    const auth = resolveAuth(config2);
+    let twinId;
+    try {
+      twinId = resolveTwinId({ flag: opts.twin, config: config2, auth });
+    } catch (e8) {
+      if (e8 instanceof TwinResolutionError) {
+        console.error(error(e8.message));
+        process.exit(1);
+      }
+      throw e8;
+    }
+    const body = {};
+    if (opts.name !== undefined)
+      body.name = opts.name;
+    if (opts.description !== undefined)
+      body.description = opts.description;
+    if (opts.public !== undefined) {
+      let next;
+      try {
+        next = parseBool(opts.public, "--public");
+      } catch (e8) {
+        console.error(error(e8.message));
+        process.exit(1);
+      }
+      body.is_public = next;
+      await confirmDestructive({
+        action: `Set twin visibility to ${next ? "PUBLIC" : "PRIVATE"}`,
+        detail: next ? "Anyone on amiko.com will be able to find and chat with this twin." : "The twin will no longer be discoverable.",
+        yes: opts.yes,
+        commandExample: `amiko twin:update --public ${next}`
+      });
+    }
+    const spinner = opts.json ? null : ora("Updating twin...").start();
+    try {
+      const updated = await amikoWebFetch(auth, `/api/agents/${twinId}`, { method: "PATCH", body });
+      spinner?.stop();
+      renderOutput(updated, (u10) => {
+        console.log(success("Twin updated"));
+        if (u10.name)
+          console.log(label("Name", String(u10.name)));
+        if (u10.description !== undefined)
+          console.log(label("Description", String(u10.description ?? "")));
+        if (u10.is_public !== undefined)
+          console.log(label("Public", u10.is_public ? "yes" : "no"));
+      }, { json: opts.json });
+    } catch (e8) {
+      spinner?.stop();
+      console.error(error(e8 instanceof Error ? e8.message : String(e8)));
+      process.exit(1);
+    }
+  });
+}
+
+// src/lib/file-input.ts
+import { readFile } from "node:fs/promises";
+import { basename, extname } from "node:path";
+var MAX_BYTES = 100 * 1024 * 1024;
+var FETCH_TIMEOUT_MS = 30000;
+async function resolveFileInput(src, opts = {}) {
+  if (src === "-" || opts.stdin) {
+    const buffer4 = await readStdin();
+    const name2 = opts.hintName ?? "stdin";
+    const mime2 = opts.hintMime ?? detectMime(buffer4, name2);
+    return { buffer: buffer4, name: name2, mime: mime2, size: buffer4.length };
+  }
+  if (/^https?:\/\//i.test(src)) {
+    const buffer4 = await fetchRemote(src);
+    const urlPath = new URL(src).pathname;
+    const name2 = opts.hintName ?? (basename(urlPath) || "download");
+    const mime2 = opts.hintMime ?? detectMime(buffer4, name2);
+    return { buffer: buffer4, name: name2, mime: mime2, size: buffer4.length };
+  }
+  const buffer3 = await readFile(src);
+  if (buffer3.length > MAX_BYTES) {
+    throw new Error(`File too large: ${buffer3.length} bytes exceeds ${MAX_BYTES} byte cap.`);
+  }
+  const name = opts.hintName ?? basename(src);
+  const mime = opts.hintMime ?? detectMime(buffer3, name);
+  return { buffer: buffer3, name, mime, size: buffer3.length };
+}
+async function readStdin() {
+  const chunks = [];
+  let total = 0;
+  for await (const chunk of process.stdin) {
+    const buf = Buffer.isBuffer(chunk) ? chunk : Buffer.from(chunk);
+    total += buf.length;
+    if (total > MAX_BYTES) {
+      throw new Error(`stdin exceeded ${MAX_BYTES} byte cap.`);
+    }
+    chunks.push(buf);
+  }
+  return Buffer.concat(chunks);
+}
+async function fetchRemote(url2) {
+  const controller = new AbortController;
+  const timer = setTimeout(() => controller.abort(), FETCH_TIMEOUT_MS);
+  try {
+    const res = await fetch(url2, { signal: controller.signal });
+    if (!res.ok) {
+      throw new Error(`Fetch ${url2} failed: ${res.status} ${res.statusText}`);
+    }
+    const len = Number(res.headers.get("content-length") || 0);
+    if (len > MAX_BYTES) {
+      throw new Error(`Remote file too large: ${len} bytes exceeds ${MAX_BYTES} byte cap.`);
+    }
+    const buf = Buffer.from(await res.arrayBuffer());
+    if (buf.length > MAX_BYTES) {
+      throw new Error(`Remote file too large: ${buf.length} bytes exceeds ${MAX_BYTES} byte cap.`);
+    }
+    return buf;
+  } finally {
+    clearTimeout(timer);
+  }
+}
+var MAGIC = [
+  [Buffer.from([37, 80, 68, 70]), "application/pdf"],
+  [Buffer.from([137, 80, 78, 71]), "image/png"],
+  [Buffer.from([255, 216, 255]), "image/jpeg"],
+  [Buffer.from([71, 73, 70, 56]), "image/gif"],
+  [Buffer.from([82, 73, 70, 70]), "audio/wav"],
+  [Buffer.from([73, 68, 51]), "audio/mpeg"],
+  [Buffer.from([255, 251]), "audio/mpeg"],
+  [Buffer.from([80, 75, 3, 4]), "application/zip"]
+];
+var EXT_MIME = {
+  ".pdf": "application/pdf",
+  ".png": "image/png",
+  ".jpg": "image/jpeg",
+  ".jpeg": "image/jpeg",
+  ".gif": "image/gif",
+  ".webp": "image/webp",
+  ".txt": "text/plain",
+  ".md": "text/markdown",
+  ".json": "application/json",
+  ".wav": "audio/wav",
+  ".mp3": "audio/mpeg",
+  ".m4a": "audio/mp4",
+  ".ogg": "audio/ogg",
+  ".zip": "application/zip"
+};
+function detectMime(buffer3, name) {
+  for (const [sig, mime] of MAGIC) {
+    if (buffer3.length >= sig.length && buffer3.subarray(0, sig.length).equals(sig)) {
+      return mime;
+    }
+  }
+  const ext = extname(name).toLowerCase();
+  return EXT_MIME[ext] ?? "application/octet-stream";
+}
+
+// src/commands/docs.ts
+function twinFromFlag(opts) {
+  const config2 = loadConfig();
+  const auth = resolveAuth(config2);
+  try {
+    return { twinId: resolveTwinId({ flag: opts.twin, config: config2, auth }), auth };
+  } catch (e8) {
+    if (e8 instanceof TwinResolutionError) {
+      console.error(error(e8.message));
+      process.exit(1);
+    }
+    throw e8;
+  }
+}
+function fmtBytes(n20) {
+  if (!n20 || n20 <= 0)
+    return "-";
+  const units = ["B", "KB", "MB", "GB"];
+  let v8 = n20;
+  let i15 = 0;
+  while (v8 >= 1024 && i15 < units.length - 1) {
+    v8 /= 1024;
+    i15++;
+  }
+  return `${v8.toFixed(v8 >= 10 ? 0 : 1)} ${units[i15]}`;
+}
+function registerDocsCommand(program2) {
+  program2.command("docs").description("List uploaded documents for a twin").option("--twin <idOrName>", "Target twin id or name").option("--limit <n>", "Max results", "50").option("--json", "Output as JSON").action(async (opts) => {
+    const { twinId, auth } = twinFromFlag(opts);
+    const spinner = opts.json ? null : ora("Loading documents...").start();
+    try {
+      const data = await amikoWebFetch(auth, `/api/agents/${twinId}/docs`, { query: { limit: opts.limit ?? "50" } });
+      spinner?.stop();
+      renderOutput(data, (d13) => {
+        if (!d13.docs || d13.docs.length === 0) {
+          console.log(dim("No documents."));
+          return;
+        }
+        console.log(heading(`Documents (${d13.total ?? d13.docs.length})`));
+        const rows = [
+          [
+            dim("ID"),
+            dim("NAME"),
+            dim("SIZE"),
+            dim("STATUS"),
+            dim("CREATED")
+          ],
+          ...d13.docs.map((doc2) => [
+            doc2.id.slice(0, 8),
+            doc2.title || doc2.filename,
+            fmtBytes(doc2.file_size),
+            doc2.status || "-",
+            doc2.created_at?.slice(0, 10) || "-"
+          ])
+        ];
+        console.log(table(rows));
+      }, { json: opts.json });
+    } catch (e8) {
+      spinner?.stop();
+      console.error(error(e8 instanceof Error ? e8.message : String(e8)));
+      process.exit(1);
+    }
+  });
+  program2.command("docs:upload <source>").description("Upload a document (path | https URL | - for stdin)").option("--twin <idOrName>", "Target twin id or name").option("--name <filename>", "Override filename").option("--title <title>", "Document title (defaults to filename)").option("--description <text>", "Document description").option("--doc-type <type>", "Document type (e.g. 'other', 'memory')", "other").option("--stdin", "Read from stdin (source must be -)").option("--json", "Output as JSON").action(async (source, opts) => {
+    const { twinId, auth } = twinFromFlag(opts);
+    const spinner = opts.json ? null : ora("Reading input...").start();
+    try {
+      const file2 = await resolveFileInput(source, {
+        stdin: opts.stdin,
+        hintName: opts.name
+      });
+      if (spinner)
+        spinner.text = `Uploading ${file2.name}...`;
+      const form2 = new FormData;
+      form2.set("file", new Blob([new Uint8Array(file2.buffer)], { type: file2.mime }), file2.name);
+      const upload = await amikoWebFetch(auth, `/api/agents/${twinId}/docs/upload`, {
+        method: "POST",
+        multipart: form2
+      });
+      if (!upload.url || !upload.filename || !upload.fileType) {
+        throw new Error(`Upload response missing required fields: ${JSON.stringify(upload)}`);
+      }
+      if (spinner)
+        spinner.text = `Registering ${upload.filename}...`;
+      const title = opts.title || upload.filename.replace(/\.[^.]+$/, "");
+      const doc2 = await amikoWebFetch(auth, `/api/agents/${twinId}/docs`, {
+        method: "POST",
+        body: {
+          filename: upload.filename,
+          fileUrl: upload.url,
+          fileType: upload.fileType,
+          title,
+          description: opts.description ?? undefined,
+          doc_type: opts.docType ?? "other"
+        }
+      });
+      spinner?.stop();
+      renderOutput(doc2, (d13) => {
+        console.log(success(`Uploaded ${d13.filename}`));
+        console.log(label("Doc ID", d13.id));
+        console.log(label("Title", d13.title || "-"));
+        if (upload.fileSize)
+          console.log(label("Size", fmtBytes(upload.fileSize)));
+        if (upload.fileType)
+          console.log(label("Type", upload.fileType));
+        if (upload.url)
+          console.log(label("URL", upload.url));
+      }, { json: opts.json });
+    } catch (e8) {
+      spinner?.stop();
+      console.error(error(e8 instanceof Error ? e8.message : String(e8)));
+      process.exit(1);
+    }
+  });
+  program2.command("docs:delete <docId>").description("Delete a document").option("--twin <idOrName>", "Target twin id or name").option("--yes", "Skip confirmation").option("--json", "Output as JSON").action(async (docId, opts) => {
+    const { twinId, auth } = twinFromFlag(opts);
+    await confirmDestructive({
+      action: `Delete document ${docId}`,
+      detail: "This will remove the document and its embeddings from the twin's RAG.",
+      yes: opts.yes,
+      commandExample: `amiko docs:delete ${docId}`
+    });
+    const spinner = opts.json ? null : ora("Deleting document...").start();
+    try {
+      const result = await amikoWebFetch(auth, `/api/agents/${twinId}/docs/${docId}`, { method: "DELETE" });
+      spinner?.stop();
+      renderOutput(result, () => console.log(success(`Deleted ${docId}`)), { json: opts.json });
+    } catch (e8) {
+      spinner?.stop();
+      console.error(error(e8 instanceof Error ? e8.message : String(e8)));
+      process.exit(1);
+    }
+  });
+  program2.command("docs:presign <source>").description("Get a presigned upload URL for a document (no upload)").option("--twin <idOrName>", "Target twin id or name").option("--name <filename>", "Override filename used in the request").option("--json", "Output as JSON").action(async (source, opts) => {
+    const { twinId, auth } = twinFromFlag(opts);
+    const filename = opts.name ?? (source === "-" ? "stdin" : source.split("/").pop() ?? source);
+    try {
+      const result = await amikoWebFetch(auth, `/api/agents/${twinId}/docs/presigned-url`, { method: "POST", body: { filename } });
+      renderOutput(result, (r19) => console.log(JSON.stringify(r19, null, 2)), { json: opts.json });
+    } catch (e8) {
+      console.error(error(e8 instanceof Error ? e8.message : String(e8)));
+      process.exit(1);
+    }
+  });
+}
+
+// src/commands/voice.ts
+function twinFromFlag2(opts) {
+  const config2 = loadConfig();
+  const auth = resolveAuth(config2);
+  try {
+    return { twinId: resolveTwinId({ flag: opts.twin, config: config2, auth }), auth };
+  } catch (e8) {
+    if (e8 instanceof TwinResolutionError) {
+      console.error(error(e8.message));
+      process.exit(1);
+    }
+    throw e8;
+  }
+}
+function registerVoiceCommand(program2) {
+  program2.command("voice:design").description("Design a voice from a text description").requiredOption("--description <text>", "Voice description (min 20 chars)").option("--twin <idOrName>", "Target twin id or name").option("--json", "Output as JSON").action(async (opts) => {
+    if (opts.description.trim().length < 20) {
+      console.error(error("--description must be at least 20 characters"));
+      process.exit(1);
+    }
+    const { twinId, auth } = twinFromFlag2(opts);
+    const spinner = opts.json ? null : ora("Generating voice previews...").start();
+    try {
+      const result = await amikoWebFetch(auth, `/api/agents/${twinId}/voice/design`, {
+        method: "POST",
+        body: { voiceDescription: opts.description.trim() },
+        timeoutMs: 120000
+      });
+      spinner?.stop();
+      renderOutput(result, (r19) => {
+        console.log(heading(`Voice Previews (${r19.previews?.length ?? 0})`));
+        for (const [i15, p13] of (r19.previews ?? []).entries()) {
+          console.log(label(`#${i15 + 1} id`, p13.generated_voice_id ?? "?"));
+        }
+        console.log("");
+        console.log(dim("Pick one with: amiko voice:create --sample <id>"));
+      }, { json: opts.json });
+    } catch (e8) {
+      spinner?.stop();
+      console.error(error(e8 instanceof Error ? e8.message : String(e8)));
+      process.exit(1);
+    }
+  });
+  program2.command("voice:create").description("Create a voice from a previously designed preview").requiredOption("--sample <id>", "generated_voice_id from voice:design").option("--description <text>", "Optional voice description").option("--twin <idOrName>", "Target twin id or name").option("--json", "Output as JSON").action(async (opts) => {
+    const { twinId, auth } = twinFromFlag2(opts);
+    const spinner = opts.json ? null : ora("Creating voice...").start();
+    try {
+      const result = await amikoWebFetch(auth, `/api/agents/${twinId}/voice/create`, {
+        method: "POST",
+        body: {
+          generatedVoiceId: opts.sample,
+          voiceDescription: opts.description
+        },
+        timeoutMs: 120000
+      });
+      spinner?.stop();
+      renderOutput(result, (r19) => {
+        console.log(success("Voice created"));
+        if (r19.voice_id)
+          console.log(label("Voice ID", String(r19.voice_id)));
+        if (r19.voice_status)
+          console.log(label("Status", String(r19.voice_status)));
+      }, { json: opts.json });
+    } catch (e8) {
+      spinner?.stop();
+      console.error(error(e8 instanceof Error ? e8.message : String(e8)));
+      process.exit(1);
+    }
+  });
+  program2.command("voice:clone <source>").description("Clone a voice from an audio file (path | https URL | -)").option("--twin <idOrName>", "Target twin id or name").option("--name <filename>", "Override filename").option("--stdin", "Read from stdin (source must be -)").option("--json", "Output as JSON").action(async (source, opts) => {
+    const { twinId, auth } = twinFromFlag2(opts);
+    const spinner = opts.json ? null : ora("Reading audio...").start();
+    try {
+      const file2 = await resolveFileInput(source, {
+        stdin: opts.stdin,
+        hintName: opts.name,
+        hintMime: "audio/mpeg"
+      });
+      if (spinner)
+        spinner.text = `Cloning voice from ${file2.name}...`;
+      const form2 = new FormData;
+      form2.set("audio", new Blob([new Uint8Array(file2.buffer)], { type: file2.mime }), file2.name);
+      const result = await amikoWebFetch(auth, `/api/agents/${twinId}/voice/clone`, { method: "POST", multipart: form2, timeoutMs: 180000 });
+      spinner?.stop();
+      renderOutput(result, (r19) => {
+        console.log(success("Voice cloned"));
+        if (r19.voice_id)
+          console.log(label("Voice ID", String(r19.voice_id)));
+        if (r19.voice_status)
+          console.log(label("Status", String(r19.voice_status)));
+      }, { json: opts.json });
+    } catch (e8) {
+      spinner?.stop();
+      console.error(error(e8 instanceof Error ? e8.message : String(e8)));
+      process.exit(1);
+    }
+  });
+  program2.command("voice:reset").description("Reset the twin's voice to default").option("--twin <idOrName>", "Target twin id or name").option("--yes", "Skip confirmation").option("--json", "Output as JSON").action(async (opts) => {
+    const { twinId, auth } = twinFromFlag2(opts);
+    await confirmDestructive({
+      action: "Reset voice",
+      detail: "This removes the custom voice. You can redesign or clone a new one later.",
+      yes: opts.yes,
+      commandExample: "amiko voice:reset"
+    });
+    const spinner = opts.json ? null : ora("Resetting voice...").start();
+    try {
+      const result = await amikoWebFetch(auth, `/api/agents/${twinId}/voice/reset`, { method: "POST" });
+      spinner?.stop();
+      renderOutput(result, () => console.log(success("Voice reset")), { json: opts.json });
+    } catch (e8) {
+      spinner?.stop();
+      console.error(error(e8 instanceof Error ? e8.message : String(e8)));
+      process.exit(1);
+    }
+  });
+}
+
+// src/commands/avatar.ts
+function registerAvatarCommand(program2) {
+  program2.command("avatar:update").description("Update twin avatar image (path | https URL | - for stdin)").requiredOption("--file <source>", "Image source").option("--twin <idOrName>", "Target twin id or name").option("--stdin", "Read from stdin (file must be -)").option("--name <filename>", "Override filename").option("--yes", "Skip confirmation").option("--json", "Output as JSON").action(async (opts) => {
+    const config2 = loadConfig();
+    const auth = resolveAuth(config2);
+    let twinId;
+    try {
+      twinId = resolveTwinId({ flag: opts.twin, config: config2, auth });
+    } catch (e8) {
+      if (e8 instanceof TwinResolutionError) {
+        console.error(error(e8.message));
+        process.exit(1);
+      }
+      throw e8;
+    }
+    await confirmDestructive({
+      action: "Replace twin avatar",
+      detail: "The twin's public avatar will change immediately.",
+      yes: opts.yes,
+      commandExample: `amiko avatar:update --file ${opts.file}`
+    });
+    const spinner = opts.json ? null : ora("Reading image...").start();
+    try {
+      const file2 = await resolveFileInput(opts.file, {
+        stdin: opts.stdin,
+        hintName: opts.name
+      });
+      if (!file2.mime.startsWith("image/")) {
+        spinner?.stop();
+        console.error(error(`File is not an image (mime: ${file2.mime})`));
+        process.exit(1);
+      }
+      if (file2.size > 5 * 1024 * 1024) {
+        spinner?.stop();
+        console.error(error(`Image too large: ${file2.size} bytes (max 5 MB)`));
+        process.exit(1);
+      }
+      if (spinner)
+        spinner.text = `Uploading avatar (${file2.name})...`;
+      const form2 = new FormData;
+      form2.set("image", new Blob([new Uint8Array(file2.buffer)], { type: file2.mime }), file2.name);
+      const result = await amikoWebFetch(auth, `/api/agents/${twinId}/avatar`, {
+        method: "POST",
+        multipart: form2
+      });
+      spinner?.stop();
+      renderOutput(result, (r19) => {
+        console.log(success("Avatar updated"));
+        if (r19.avatar_url)
+          console.log(label("URL", r19.avatar_url));
+      }, { json: opts.json });
+    } catch (e8) {
+      spinner?.stop();
+      console.error(error(e8 instanceof Error ? e8.message : String(e8)));
+      process.exit(1);
+    }
+  });
+}
+
+// src/commands/friends.ts
+function registerFriendsCommand(program2) {
+  program2.command("friends").description("List friends").option("--type <user|twin>", "Filter by friend type").option("--json", "Output as JSON").action(async (opts) => {
+    const auth = resolveAuth(loadConfig());
+    const spinner = opts.json ? null : ora("Loading friends...").start();
+    try {
+      const data = await amikoWebFetch(auth, "/api/friends", { query: { type: opts.type } });
+      spinner?.stop();
+      renderOutput(data, (d13) => {
+        const items = d13.items ?? [];
+        if (items.length === 0) {
+          console.log(dim("No friends."));
+          return;
+        }
+        console.log(heading(`Friends (${items.length})`));
+        const rows = [
+          [dim("ID"), dim("NAME"), dim("HANDLE"), dim("TYPE"), dim("STATUS")],
+          ...items.map((f13) => [
+            f13.id.slice(0, 8),
+            f13.friend.name ?? "-",
+            f13.friend.handle ?? "-",
+            f13.friend.type,
+            f13.status
+          ])
+        ];
+        console.log(table(rows));
+      }, { json: opts.json });
+    } catch (e8) {
+      spinner?.stop();
+      console.error(error(e8 instanceof Error ? e8.message : String(e8)));
+      process.exit(1);
+    }
+  });
+  program2.command("friends:add").description("Send a friend request to a user by id").requiredOption("--id <userId>", "Target user id").option("--json", "Output as JSON").action(async (opts) => {
+    const auth = resolveAuth(loadConfig());
+    const spinner = opts.json ? null : ora("Sending friend request...").start();
+    try {
+      const data = await amikoWebFetch(auth, "/api/friends", {
+        method: "POST",
+        body: { friend_id: opts.id }
+      });
+      spinner?.stop();
+      renderOutput(data, (d13) => {
+        console.log(success(d13.auto_accepted ? "Auto-accepted" : "Request sent"));
+        if (d13.friendship_id)
+          console.log(label("Friendship ID", d13.friendship_id));
+      }, { json: opts.json });
+    } catch (e8) {
+      spinner?.stop();
+      console.error(error(e8 instanceof Error ? e8.message : String(e8)));
+      process.exit(1);
+    }
+  });
+  program2.command("friends:accept <friendshipId>").description("Accept a pending friend request").option("--json", "Output as JSON").action(async (friendshipId, opts) => {
+    const auth = resolveAuth(loadConfig());
+    const spinner = opts.json ? null : ora("Accepting...").start();
+    try {
+      const data = await amikoWebFetch(auth, `/api/friends/${friendshipId}`, { method: "PATCH", body: { action: "accept" } });
+      spinner?.stop();
+      renderOutput(data, () => console.log(success(`Accepted ${friendshipId}`)), { json: opts.json });
+    } catch (e8) {
+      spinner?.stop();
+      console.error(error(e8 instanceof Error ? e8.message : String(e8)));
+      process.exit(1);
+    }
+  });
+  program2.command("friends:remove <friendshipId>").description("Remove a friend").option("--yes", "Skip confirmation").option("--json", "Output as JSON").action(async (friendshipId, opts) => {
+    await confirmDestructive({
+      action: `Remove friend ${friendshipId}`,
+      yes: opts.yes,
+      commandExample: `amiko friends:remove ${friendshipId}`
+    });
+    const auth = resolveAuth(loadConfig());
+    const spinner = opts.json ? null : ora("Removing...").start();
+    try {
+      const data = await amikoWebFetch(auth, `/api/friends/${friendshipId}`, { method: "DELETE" });
+      spinner?.stop();
+      renderOutput(data, () => console.log(success(`Removed ${friendshipId}`)), { json: opts.json });
+    } catch (e8) {
+      spinner?.stop();
+      console.error(error(e8 instanceof Error ? e8.message : String(e8)));
+      process.exit(1);
+    }
+  });
+}
+
+// src/commands/feed.ts
+function registerFeedCommand(program2) {
+  program2.command("feed").description("Get feed posts").option("--type <for_you|friends>", "Feed type", "friends").option("--hashtag <tag>", "Filter by hashtag").option("--limit <n>", "Max results (default 10, max 100)").option("--cursor <id>", "Pagination cursor").option("--json", "Output as JSON").action(async (opts) => {
+    const auth = resolveAuth(loadConfig());
+    const spinner = opts.json ? null : ora("Loading feed...").start();
+    try {
+      const data = await amikoWebFetch(auth, "/api/feed", {
+        query: {
+          type: opts.type,
+          hashtag: opts.hashtag,
+          limit: opts.limit,
+          cursor: opts.cursor
+        }
+      });
+      spinner?.stop();
+      const posts = data.items ?? data.posts ?? [];
+      renderOutput({ ...data, posts }, (d13) => {
+        if (posts.length === 0) {
+          console.log(dim("No posts."));
+          return;
+        }
+        console.log(heading(`Feed (${opts.type ?? "friends"}) — ${posts.length} posts`));
+        for (const p13 of posts) {
+          const author = p13.twin?.name ?? p13.user?.name ?? p13.user?.handle ?? "unknown";
+          console.log("");
+          console.log(label(author, p13.created_at?.slice(0, 16) ?? ""));
+          console.log(p13.content);
+          if (p13._count) {
+            console.log(dim(`${p13._count.likes ?? 0} likes · ${p13._count.comments ?? 0} comments · ${p13._count.bookmarks ?? 0} bookmarks`));
+          }
+          console.log(dim(`id: ${p13.id}`));
+        }
+        if (d13.nextCursor) {
+          console.log("");
+          console.log(dim(`Next: --cursor ${d13.nextCursor}`));
+        }
+      }, { json: opts.json });
+    } catch (e8) {
+      spinner?.stop();
+      console.error(error(e8 instanceof Error ? e8.message : String(e8)));
+      process.exit(1);
+    }
+  });
+  program2.command("post:comment").description("Comment on a post").requiredOption("--id <postId>", "Target post id").requiredOption("--comment <text>", "Comment body").option("--twin <idOrName>", "Post as this twin (agent mode)").option("--json", "Output as JSON").action(async (opts) => {
+    const config2 = loadConfig();
+    const auth = resolveAuth(config2);
+    let twinId;
+    if (opts.twin || auth.twinId) {
+      try {
+        twinId = resolveTwinId({ flag: opts.twin, config: config2, auth });
+      } catch (e8) {
+        if (e8 instanceof TwinResolutionError) {
+          twinId = undefined;
+        } else {
+          throw e8;
+        }
+      }
+    }
+    const spinner = opts.json ? null : ora("Posting comment...").start();
+    try {
+      const body = { comment: opts.comment };
+      if (twinId)
+        body.twin_id = twinId;
+      const data = await amikoWebFetch(auth, `/api/posts/${opts.id}/comments`, { method: "POST", body });
+      spinner?.stop();
+      renderOutput(data, (d13) => {
+        console.log(success("Comment posted"));
+        if (d13.id)
+          console.log(label("Comment ID", String(d13.id)));
+      }, { json: opts.json });
+    } catch (e8) {
+      spinner?.stop();
+      console.error(error(e8 instanceof Error ? e8.message : String(e8)));
+      process.exit(1);
+    }
+  });
+}
+
+// src/commands/composio.ts
+function twinFromFlag3(opts) {
+  const config2 = loadConfig();
+  const auth = resolveAuth(config2);
+  try {
+    return { twinId: resolveTwinId({ flag: opts.twin, config: config2, auth }), auth };
+  } catch (e8) {
+    if (e8 instanceof TwinResolutionError) {
+      console.error(error(e8.message));
+      process.exit(1);
+    }
+    throw e8;
+  }
+}
+function registerComposioCommand(program2) {
+  program2.command("composio:connect").description("Start Composio OAuth for an app (gmail, github, ...)").requiredOption("--app <slug>", "App name (e.g. gmail)").option("--twin <idOrName>", "Target twin id or name").option("--redirect <url>", "Override OAuth redirect URL").option("--force", "Force reconnect if already connected").option("--json", "Output as JSON").action(async (opts) => {
+    const { twinId, auth } = twinFromFlag3(opts);
+    const spinner = opts.json ? null : ora(`Connecting ${opts.app}...`).start();
+    try {
+      const data = await amikoWebFetch(auth, `/api/agents/${twinId}/composio/connect`, {
+        method: "POST",
+        body: {
+          appName: opts.app,
+          redirectUrl: opts.redirect,
+          forceReconnect: opts.force ?? true
+        }
+      });
+      spinner?.stop();
+      renderOutput(data, (d13) => {
+        if (d13.alreadyConnected) {
+          console.log(success(`${opts.app} is already connected`));
+          if (d13.connectionId)
+            console.log(label("Connection ID", d13.connectionId));
+          return;
+        }
+        console.log(success(`OAuth URL ready for ${opts.app}`));
+        if (d13.redirectUrl) {
+          console.log("");
+          console.log(d13.redirectUrl);
+          console.log("");
+          console.log(dim("Open this URL in a browser to complete the connection."));
+        }
+        if (d13.connectionId)
+          console.log(label("Connection ID", d13.connectionId));
+      }, { json: opts.json });
+    } catch (e8) {
+      spinner?.stop();
+      console.error(error(e8 instanceof Error ? e8.message : String(e8)));
+      process.exit(1);
+    }
+  });
+  program2.command("composio:disconnect").description("Disconnect a Composio app for the twin").requiredOption("--app <slug>", "App name (e.g. gmail)").option("--twin <idOrName>", "Target twin id or name").option("--yes", "Skip confirmation").option("--json", "Output as JSON").action(async (opts) => {
+    const { twinId, auth } = twinFromFlag3(opts);
+    await confirmDestructive({
+      action: `Disconnect ${opts.app}`,
+      detail: "The twin will lose access to the app's tools until reconnected.",
+      yes: opts.yes,
+      commandExample: `amiko composio:disconnect --app ${opts.app}`
+    });
+    const spinner = opts.json ? null : ora("Finding connection...").start();
+    try {
+      const connections = await amikoWebFetch(auth, `/api/agents/${twinId}/composio/connections`);
+      const match = connections.details?.find((d13) => d13.appName?.toLowerCase() === opts.app.toLowerCase());
+      if (!match?.id) {
+        spinner?.stop();
+        console.error(error(`No active connection for "${opts.app}". Connected: ${connections.connections?.join(", ") || "none"}`));
+        process.exit(1);
+      }
+      if (spinner)
+        spinner.text = `Disconnecting ${opts.app}...`;
+      const result = await amikoWebFetch(auth, `/api/agents/${twinId}/composio/connections`, { method: "DELETE", body: { connectionId: match.id } });
+      spinner?.stop();
+      renderOutput(result, () => console.log(success(`Disconnected ${opts.app}`)), { json: opts.json });
+    } catch (e8) {
+      spinner?.stop();
+      console.error(error(e8 instanceof Error ? e8.message : String(e8)));
+      process.exit(1);
+    }
+  });
+}
+
 // src/index.ts
 var require2 = createRequire2(import.meta.url);
 var { version: PKG_VERSION } = require2("../package.json");
@@ -75669,4 +76878,12 @@ registerConfigCommand(program2);
 registerServicesCommand(program2);
 registerDiscoveryCommand(program2);
 registerUpdateCommand(program2);
+registerAccountsCommand(program2);
+registerTwinCommand(program2);
+registerDocsCommand(program2);
+registerVoiceCommand(program2);
+registerAvatarCommand(program2);
+registerFriendsCommand(program2);
+registerFeedCommand(program2);
+registerComposioCommand(program2);
 program2.parse();