@heyamiko/amiko-cli 0.12.0-beta.8 → 0.14.0-beta.10

package/dist/index.js

@@ -27031,12 +27031,19 @@ async function confirmDestructive(args) {
   process.exit(2);
 }
 async function requireApproval(args) {
+  if (args.cost === undefined === (args.free === undefined)) {
+    throw new Error("requireApproval: set exactly one of `cost` or `free`.");
+  }
   if (args.yes)
     return;
   if (process.stdin.isTTY) {
     console.log("");
     console.log(`About to run: ${args.summary}`);
-    console.log(`Cost: ${args.cost}`);
+    if (args.cost !== undefined) {
+      console.log(`Cost: ${args.cost}`);
+    } else {
+      console.log(`Free — but this is a real outward action other people will see (${args.free}).`);
+    }
     const ok = await promptYesNo("Proceed? [y/N] ");
     if (!ok) {
       console.log(dim("Cancelled."));
@@ -27046,10 +27053,17 @@ async function requireApproval(args) {
   }
   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:`));
+  if (args.cost !== undefined) {
+    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:`));
+  } else {
+    console.error(`This action is FREE — do not quote a price or say "cost: 0". It is outward-facing: ${args.free}.`);
+    console.error(`Action: ${args.summary}`);
+    console.error("");
+    console.error(dim(`Ask the owner to confirm the action itself (what will be sent and who sees it), then re-run with --yes:`));
+  }
   console.error(dim(`  ${args.commandExample} --yes`));
   process.exit(2);
 }
@@ -28306,15 +28320,60 @@ async function reportHttpError(res, label2) {
   console.error(String(pretty).slice(0, 2000));
 }
 
-// src/commands/search.ts
+// src/lib/treasury-payment.ts
 var TREASURY = "FPiZAf3jEnNfCwfvbv46jdPfHbmSepD4Q6iHiLJDQXvb";
+var PAYMENT_TOKENS = ["AMIKO", "USDC", "USDT"];
+function normalizePaymentToken(raw) {
+  const sym = (raw ?? "AMIKO").trim().toUpperCase();
+  if (!PAYMENT_TOKENS.includes(sym)) {
+    throw new Error(`Unsupported payment token "${raw}". Supported: ${PAYMENT_TOKENS.join(", ")}.`);
+  }
+  return sym;
+}
+async function quoteTokenAmount(auth, token, usd2) {
+  if (token === "USDC" || token === "USDT") {
+    return { amount: usd2.toFixed(6), priceUsd: 1 };
+  }
+  const priceUsd = await getTokenUsdPrice(auth, "AMIKO");
+  if (!priceUsd || priceUsd <= 0) {
+    throw new Error("Could not fetch AMIKO/USD price from the Amiko platform. Try again in a moment, or pay with --token USDT/USDC.");
+  }
+  const amount2 = (usd2 / priceUsd * 1.01).toFixed(6);
+  return { amount: amount2, priceUsd };
+}
+async function payTreasury(auth, args) {
+  const transferData = await amikoWebFetch(auth, `/api/agents/${encodeURIComponent(auth.twinId)}/wallets/${encodeURIComponent(args.wallet)}/transfer`, {
+    method: "POST",
+    body: { to: TREASURY, amount: args.amount, token: args.token, chain: "solana" }
+  });
+  if (!transferData.txHash)
+    throw new Error("Payment sent but no tx hash returned.");
+  return transferData.txHash;
+}
+
+// src/commands/search.ts
+var SEARCH_USD = 0.01;
 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").option("--wallet <address>", "Wallet to pay from (defaults to your Solana wallet — run `amiko wallets create --chain solana` if you don't have one)").option("--yes", "Skip the pre-spend confirmation (required in non-interactive shells)").action(async (query, opts) => {
+  program2.command("search <query>").description("X Search — $0.01 per search, paid in AMIKO, USDC, or USDT").option("--raw", "Output raw JSON").option("--token <token>", "Payment token (AMIKO, USDC, USDT)", "AMIKO").option("--wallet <address>", "Wallet to pay from (defaults to your Solana wallet — run `amiko wallets create --chain solana` if you don't have one)").option("--yes", "Skip the pre-spend confirmation (required in non-interactive shells)").action(async (query, opts) => {
+    let token;
+    try {
+      token = normalizePaymentToken(opts.token);
+    } catch (e5) {
+      console.error(error(e5 instanceof Error ? e5.message : String(e5)));
+      process.exit(1);
+    }
+    let quote;
+    try {
+      quote = await quoteTokenAmount(resolveAuth(), token, SEARCH_USD);
+    } catch (e5) {
+      console.error(error(e5 instanceof Error ? e5.message : String(e5)));
+      process.exit(1);
+    }
     await requireApproval({
-      cost: `1 ${opts.token || "AMIKO"}`,
+      cost: `${quote.amount} ${token} (≈ $${SEARCH_USD.toFixed(2)})`,
       summary: `X/Twitter search: ${query.slice(0, 80)}${query.length > 80 ? "…" : ""}`,
       yes: opts.yes,
-      commandExample: `amiko markets search ${JSON.stringify(query)}${opts.token && opts.token !== "AMIKO" ? ` --token ${opts.token}` : ""}`
+      commandExample: `amiko markets search ${JSON.stringify(query)}${token !== "AMIKO" ? ` --token ${token}` : ""}`
     });
     const spinner = ora("X Search...").start();
     try {
@@ -28328,9 +28387,7 @@ function registerSearchCommand(program2) {
         process.exit(1);
       }
       const mppBase2 = (config2.apiBase || "https://mpp.amikomarkets.com").replace(/\/$/, "");
-      const token = opts.token || "AMIKO";
-      const chain = "solana";
-      const amount2 = token === "AMIKO" ? "1" : "0.01";
+      const amount2 = quote.amount;
       let wallet;
       try {
         wallet = await resolveWalletAddress(auth, opts.wallet, "solana");
@@ -28339,19 +28396,10 @@ function registerSearchCommand(program2) {
         console.error(error(e5 instanceof Error ? e5.message : String(e5)));
         process.exit(1);
       }
-      spinner.text = `Paying ${amount2} ${token} (${chain})...`;
+      spinner.text = `Paying ${amount2} ${token} (solana)...`;
       let txHash;
       try {
-        const transferData = await amikoWebFetch(auth, `/api/agents/${encodeURIComponent(auth.twinId)}/wallets/${encodeURIComponent(wallet)}/transfer`, {
-          method: "POST",
-          body: { to: TREASURY, amount: amount2, token, chain }
-        });
-        if (!transferData.txHash) {
-          spinner.stop();
-          console.error(error("Payment sent but no tx hash returned."));
-          process.exit(1);
-        }
-        txHash = transferData.txHash;
+        txHash = await payTreasury(auth, { wallet, amount: amount2, token });
       } catch (e5) {
         spinner.stop();
         console.error(error(e5 instanceof Error ? e5.message : `${token} payment failed`));
@@ -28408,7 +28456,6 @@ function registerSearchCommand(program2) {
 }
 
 // src/commands/image.ts
-var TREASURY2 = "FPiZAf3jEnNfCwfvbv46jdPfHbmSepD4Q6iHiLJDQXvb";
 var IMAGE_MARKUP = 1.3;
 var IMAGE_PRICING = {
   "gpt-image-2": { low: { sq: 0.006, lg: 0.005 }, medium: { sq: 0.053, lg: 0.041 }, high: { sq: 0.211, lg: 0.165 } },
@@ -28426,7 +28473,7 @@ function computeImageUsd(model, quality, size3, n) {
   return Number((pricing[q][tier] * clamped * IMAGE_MARKUP).toFixed(6));
 }
 function registerImageCommand(program2) {
-  program2.command("image <prompt>").alias("img").description("Generate an image — pays in AMIKO at OpenAI pass-through pricing × 1.30 (cost varies by model/quality/size)").option("--size <size>", "Image size: 1024x1024, 1024x1536, 1536x1024", "1024x1024").option("--quality <q>", "Quality: low, medium, high, auto", "high").option("--model <model>", `Model: ${SUPPORTED_MODELS.join(", ")}`, DEFAULT_IMAGE_MODEL).option("--n <count>", "Number of images (1–4)", "1").option("--background <bg>", "Background: transparent, opaque, auto").option("--format <fmt>", "Output: png, webp, jpeg", "png").option("--wallet <address>", "Wallet to pay from (defaults to your Solana wallet — run `amiko wallets create --chain solana` if you don't have one)").option("--raw", "Output raw JSON").option("--yes", "Skip the pre-spend confirmation (required in non-interactive shells)").action(async (prompt, opts) => {
+  program2.command("image <prompt>").alias("img").description("Generate an image — pay in AMIKO, USDC, or USDT (cost varies by model/quality/size; exact amount quoted before charging)").option("--size <size>", "Image size: 1024x1024, 1024x1536, 1536x1024", "1024x1024").option("--quality <q>", "Quality: low, medium, high, auto", "high").option("--model <model>", `Model: ${SUPPORTED_MODELS.join(", ")}`, DEFAULT_IMAGE_MODEL).option("--n <count>", "Number of images (1–4)", "1").option("--background <bg>", "Background: transparent, opaque, auto").option("--format <fmt>", "Output: png, webp, jpeg", "png").option("--wallet <address>", "Wallet to pay from (defaults to your Solana wallet — run `amiko wallets create --chain solana` if you don't have one)").option("--token <token>", "Payment token (AMIKO, USDC, USDT)", "AMIKO").option("--raw", "Output raw JSON").option("--yes", "Skip the pre-spend confirmation (required in non-interactive shells)").action(async (prompt, opts) => {
     if (!SUPPORTED_MODELS.includes(opts.model)) {
       console.error(error(`Unknown model "${opts.model}". Supported: ${SUPPORTED_MODELS.join(", ")}.`));
       process.exit(1);
@@ -28461,14 +28508,23 @@ function registerImageCommand(program2) {
       console.error(error(e5 instanceof Error ? e5.message : "auth failed"));
       process.exit(1);
     }
-    const amikoUsd = await getTokenUsdPrice(auth, "AMIKO");
-    if (!amikoUsd || amikoUsd <= 0) {
-      console.error(error("Could not fetch AMIKO/USD price from the Amiko platform. Try again in a moment, or top up via `amiko credits topup` and use credit auto-pay instead."));
+    let payToken;
+    try {
+      payToken = normalizePaymentToken(opts.token);
+    } catch (e5) {
+      console.error(error(e5 instanceof Error ? e5.message : String(e5)));
+      process.exit(1);
+    }
+    let quote;
+    try {
+      quote = await quoteTokenAmount(auth, payToken, usdCost);
+    } catch (e5) {
+      console.error(error(e5 instanceof Error ? e5.message : String(e5)));
       process.exit(1);
     }
-    const amikoAmount = (usdCost / amikoUsd).toFixed(6);
+    const payAmount = quote.amount;
     await requireApproval({
-      cost: `${amikoAmount} AMIKO (≈ $${usdCost.toFixed(4)} @ $${amikoUsd.toFixed(6)}/AMIKO, ${opts.model} ${opts.quality} ${opts.size}${n > 1 ? ` ×${n}` : ""})`,
+      cost: `${payAmount} ${payToken} (≈ $${usdCost.toFixed(4)} @ $${quote.priceUsd.toFixed(6)}/${payToken}, ${opts.model} ${opts.quality} ${opts.size}${n > 1 ? ` ×${n}` : ""})`,
       summary: `Generate image: ${prompt.slice(0, 80)}${prompt.length > 80 ? "…" : ""}`,
       yes: opts.yes,
       commandExample: `amiko markets image ${JSON.stringify(prompt)}`
@@ -28512,19 +28568,10 @@ function registerImageCommand(program2) {
         console.error(error(e5 instanceof Error ? e5.message : String(e5)));
         process.exit(1);
       }
-      setStatus(`Paying ${amikoAmount} AMIKO...`);
+      setStatus(`Paying ${payAmount} ${payToken}...`);
       let txHash;
       try {
-        const transferData = await amikoWebFetch(auth, `/api/agents/${encodeURIComponent(auth.twinId)}/wallets/${encodeURIComponent(wallet)}/transfer`, {
-          method: "POST",
-          body: { to: TREASURY2, amount: amikoAmount, token: "AMIKO", chain: "solana" }
-        });
-        if (!transferData.txHash) {
-          stopProgress();
-          console.error(error("Payment sent but no tx hash returned."));
-          process.exit(1);
-        }
-        txHash = transferData.txHash;
+        txHash = await payTreasury(auth, { wallet, amount: payAmount, token: payToken });
       } catch (e5) {
         stopProgress();
         console.error(error(e5 instanceof Error ? e5.message : "Payment failed"));
@@ -28536,6 +28583,7 @@ function registerImageCommand(program2) {
         headers: {
           "Content-Type": "application/json",
           "X-Payment-Tx": txHash,
+          "X-Payment-Token": payToken,
           "X-Twin-Id": auth.twinId
         },
         body: JSON.stringify({
@@ -28578,7 +28626,7 @@ function registerImageCommand(program2) {
         }
       }
       console.log("");
-      console.log(success(`Paid ${amikoAmount} AMIKO (≈ $${usdCost.toFixed(4)})`) + dim(` tx: ${txHash.slice(0, 16)}...`));
+      console.log(success(`Paid ${payAmount} ${payToken} (≈ $${usdCost.toFixed(4)})`) + dim(` tx: ${txHash.slice(0, 16)}...`));
       await printBalanceRemaining(auth);
     } catch (err) {
       stopProgress();
@@ -28599,6 +28647,15 @@ var ETA = {
 function statusOf(err) {
   return err?.status;
 }
+function collectOption(value, previous) {
+  return [...previous ?? [], value];
+}
+function assertMaxUrls(resourceName, urls, max) {
+  if (urls.length > max) {
+    console.error(error(`At most ${max} ${resourceName} allowed (got ${urls.length}).`));
+    process.exit(1);
+  }
+}
 function printCompleted(final, title) {
   console.log(heading(`${title}
 `));
@@ -28610,7 +28667,9 @@ function printCompleted(final, title) {
     console.log(label("Type", final.assetMime));
   console.log("");
   if (final.charged) {
-    console.log(success(`Charged ${final.costAmiko ?? "?"} AMIKO`) + (final.chargeTx ? dim(` tx: ${final.chargeTx.slice(0, 16)}…`) : ""));
+    const amt = final.chargeAmount ?? final.costAmiko ?? "?";
+    const tok = final.chargeToken ?? "AMIKO";
+    console.log(success(`Charged ${amt} ${tok}`) + (final.chargeTx ? dim(` tx: ${final.chargeTx.slice(0, 16)}…`) : ""));
   } else {
     console.log(dim("Not charged (settlement pending or waived)."));
   }
@@ -28679,9 +28738,12 @@ async function submitCreateJob(opts) {
   console.log(label("Status", "PENDING — generating in the background"));
   console.log(label("Check result", `amiko create status ${jobId}`));
   console.log(dim(`Usually ready in ${ETA[opts.mode]} — charged only on success. (Also: amiko create media)`));
+  if (opts.mode === "VIDEO") {
+    console.log(dim("Async video: HTTP 202 / PENDING means the job was accepted — not a failure. Poll status after ~2–9 min."));
+  }
 }
 function registerCreateCommand(create2) {
-  create2.command("image <prompt>").description("Generate an image (Create Studio)").option("--model <model>", "Image model", "gpt-image-2").option("--aspect <ratio>", "Aspect ratio: 1:1, 16:9, 9:16, 4:3, 3:4", "1:1").option("--token <symbol>", "Preferred charge token: AMIKO, USDC, USDT, SOL").option("--raw", "Output raw JSON").option("--yes", "Skip the pre-spend confirmation (required in non-interactive shells)").action(async (prompt, opts) => {
+  create2.command("image <prompt>").description("Generate an image (Create Studio)").option("--model <model>", "Image model: nano-banana-2 (default), nano-banana[-pro|-lite] (Google), gpt-image-2/-1.5/-1/-1-mini (OpenAI), grok-imagine-image-quality (xAI), image-01 (MiniMax)", "nano-banana-2").option("--aspect <ratio>", "Aspect ratio: 1:1, 16:9, 9:16, 4:3, 3:4", "1:1").option("--token <symbol>", "Preferred charge token: AMIKO, USDC, USDT, SOL").option("--raw", "Output raw JSON").option("--yes", "Skip the pre-spend confirmation (required in non-interactive shells)").action(async (prompt, opts) => {
     await submitCreateJob({
       mode: "IMAGE",
       summary: `Create image: ${prompt.slice(0, 80)}${prompt.length > 80 ? "…" : ""}`,
@@ -28697,12 +28759,19 @@ function registerCreateCommand(create2) {
       }
     });
   });
-  create2.command("video <prompt>").description("Generate a video (Create Studio)").option("--model <model>", "Video model", "MiniMax-Hailuo-2.3-Fast").option("--resolution <res>", "512P, 720P, 768P, 1080P", "768P").option("--seconds <n>", "Clip length: 6 or 10", "6").option("--aspect <ratio>", "Aspect ratio (provider-dependent)").option("--first-frame <url>", "Image-to-video: first frame URL/data URI").option("--token <symbol>", "Preferred charge token: AMIKO, USDC, USDT, SOL").option("--raw", "Output raw JSON").option("--yes", "Skip the pre-spend confirmation (required in non-interactive shells)").action(async (prompt, opts) => {
+  create2.command("video <prompt>").description("Generate a video (Create Studio)").option("--model <model>", "Video model: MiniMax-Hailuo-2.3-Fast (default; I2V — needs --first-frame), MiniMax-Hailuo-02 / MiniMax-Hailuo-2.3 (T2V+I2V), grok-imagine-video (xAI), dreamina-seedance-* (BytePlus). ONLY these — kling and other ids are not supported", "MiniMax-Hailuo-2.3-Fast").option("--resolution <res>", "512P, 720P, 768P, 1080P", "768P").option("--seconds <n>", "Clip length: 6 or 10", "6").option("--aspect <ratio>", "Aspect ratio (provider-dependent)").option("--first-frame <url>", "Image-to-video: first frame URL/data URI").option("--last-frame <url>", "First-and-last-frame video: ending frame URL/data URI").option("--reference-image <url>", "Seedance multimodal: reference image URL (repeatable, max 9)", collectOption, []).option("--reference-video <url>", "Seedance multimodal: reference video URL (repeatable, max 3)", collectOption, []).option("--reference-audio <url>", "Seedance multimodal: reference audio URL (repeatable, max 3)", collectOption, []).option("--subject-reference <url>", "MiniMax S2V: subject/character reference image URL").option("--generate-audio", "Seedance: generate audio in the output video").option("--no-generate-audio", "Seedance: output silent video").option("--token <symbol>", "Preferred charge token: AMIKO, USDC, USDT, SOL").option("--raw", "Output raw JSON").option("--yes", "Skip the pre-spend confirmation (required in non-interactive shells)").action(async (prompt, opts) => {
     const seconds = Number(opts.seconds);
     if (seconds !== 6 && seconds !== 10) {
       console.error(error("--seconds must be 6 or 10."));
       process.exit(1);
     }
+    const referenceImageUrls = opts.referenceImage ?? [];
+    const referenceVideoUrls = opts.referenceVideo ?? [];
+    const referenceAudioUrls = opts.referenceAudio ?? [];
+    assertMaxUrls("--reference-image", referenceImageUrls, 9);
+    assertMaxUrls("--reference-video", referenceVideoUrls, 3);
+    assertMaxUrls("--reference-audio", referenceAudioUrls, 3);
+    const generateAudio = opts.generateAudio;
     await submitCreateJob({
       mode: "VIDEO",
       summary: `Create video: ${prompt.slice(0, 80)}${prompt.length > 80 ? "…" : ""}`,
@@ -28722,6 +28791,19 @@ function registerCreateCommand(create2) {
         seconds,
         ...opts.aspect ? { aspectRatio: opts.aspect } : {},
         ...opts.firstFrame ? { firstFrameImage: opts.firstFrame } : {},
+        ...opts.lastFrame ? { lastFrameImage: opts.lastFrame } : {},
+        ...referenceImageUrls.length ? { referenceImageUrls } : {},
+        ...referenceVideoUrls.length ? { referenceVideoUrls } : {},
+        ...referenceAudioUrls.length ? { referenceAudioUrls } : {},
+        ...opts.subjectReference ? {
+          subjectReference: [
+            {
+              type: "character",
+              image: [opts.subjectReference]
+            }
+          ]
+        } : {},
+        ...generateAudio !== undefined ? { generateAudio } : {},
         ...opts.token ? { preferredToken: opts.token } : {}
       }
     });
@@ -28742,7 +28824,7 @@ function registerCreateCommand(create2) {
       }
     });
   });
-  create2.command("music [prompt]").description("Generate music (Create Studio)").option("--model <model>", "music_v1, music-2.6, music-cover", "music-2.6").option("--lyrics <lyrics>", "Lyrics (optional)").option("--duration <ms>", "Length in ms").option("--instrumental", "Instrumental (no vocals)").option("--token <symbol>", "Preferred charge token: AMIKO, USDC, USDT, SOL").option("--raw", "Output raw JSON").option("--yes", "Skip the pre-spend confirmation (required in non-interactive shells)").action(async (prompt, opts) => {
+  create2.command("music [prompt]").description("Generate music (Create Studio)").option("--model <model>", "music_v1, music-2.6[-free], music-cover[-free]", "music-2.6").option("--lyrics <lyrics>", "Lyrics (optional)").option("--duration <ms>", "Length in ms").option("--instrumental", "Instrumental (no vocals)").option("--lyrics-optimizer", "Auto-write lyrics from the prompt (music_v1 only; on by default when no --lyrics/--instrumental)").option("--token <symbol>", "Preferred charge token: AMIKO, USDC, USDT, SOL").option("--raw", "Output raw JSON").option("--yes", "Skip the pre-spend confirmation (required in non-interactive shells)").action(async (prompt, opts) => {
     if (!prompt && !opts.lyrics) {
       console.error(error("Provide a prompt or --lyrics."));
       process.exit(1);
@@ -28760,6 +28842,7 @@ function registerCreateCommand(create2) {
         ...opts.lyrics ? { lyrics: opts.lyrics } : {},
         ...opts.duration ? { durationMs: Number(opts.duration) } : {},
         ...opts.instrumental ? { isInstrumental: true } : {},
+        ...opts.lyricsOptimizer ? { lyricsOptimizer: true } : {},
         ...opts.token ? { preferredToken: opts.token } : {}
       }
     });
@@ -28865,41 +28948,42 @@ import { basename, extname } from "node:path";
 var MAX_BYTES = 100 * 1024 * 1024;
 var FETCH_TIMEOUT_MS = 30000;
 async function resolveFileInput(src, opts = {}) {
+  const maxBytes = opts.maxBytes ?? MAX_BYTES;
   if (src === "-" || opts.stdin) {
-    const buffer2 = await readStdin();
+    const buffer2 = await readStdin(maxBytes);
     const name2 = opts.hintName ?? "stdin";
     const mime2 = opts.hintMime ?? detectMime(buffer2, name2);
     return { buffer: buffer2, name: name2, mime: mime2, size: buffer2.length };
   }
   if (/^https?:\/\//i.test(src)) {
-    const buffer2 = await fetchRemote(src);
+    const buffer2 = await fetchRemote(src, maxBytes);
     const urlPath = new URL(src).pathname;
     const name2 = opts.hintName ?? (basename(urlPath) || "download");
     const mime2 = opts.hintMime ?? detectMime(buffer2, name2);
     return { buffer: buffer2, name: name2, mime: mime2, size: buffer2.length };
   }
   const buffer = await readFile(src);
-  if (buffer.length > MAX_BYTES) {
-    throw new Error(`File too large: ${buffer.length} bytes exceeds ${MAX_BYTES} byte cap.`);
+  if (buffer.length > maxBytes) {
+    throw new Error(`File too large: ${buffer.length} bytes exceeds ${maxBytes} byte cap.`);
   }
   const name = opts.hintName ?? basename(src);
   const mime = opts.hintMime ?? detectMime(buffer, name);
   return { buffer, name, mime, size: buffer.length };
 }
-async function readStdin() {
+async function readStdin(maxBytes) {
   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.`);
+    if (total > maxBytes) {
+      throw new Error(`stdin exceeded ${maxBytes} byte cap.`);
     }
     chunks.push(buf);
   }
   return Buffer.concat(chunks);
 }
-async function fetchRemote(url2) {
+async function fetchRemote(url2, maxBytes) {
   const controller = new AbortController;
   const timer = setTimeout(() => controller.abort(), FETCH_TIMEOUT_MS);
   try {
@@ -28908,12 +28992,12 @@ async function fetchRemote(url2) {
       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.`);
+    if (len > maxBytes) {
+      throw new Error(`Remote file too large: ${len} bytes exceeds ${maxBytes} 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.`);
+    if (buf.length > maxBytes) {
+      throw new Error(`Remote file too large: ${buf.length} bytes exceeds ${maxBytes} byte cap.`);
     }
     return buf;
   } finally {
@@ -28944,6 +29028,13 @@ var EXT_MIME = {
   ".mp3": "audio/mpeg",
   ".m4a": "audio/mp4",
   ".ogg": "audio/ogg",
+  ".aac": "audio/aac",
+  ".flac": "audio/flac",
+  ".mp4": "video/mp4",
+  ".m4v": "video/x-m4v",
+  ".webm": "video/webm",
+  ".mov": "video/quicktime",
+  ".mkv": "video/x-matroska",
   ".zip": "application/zip"
 };
 function detectMime(buffer, name) {
@@ -28956,12 +29047,15 @@ function detectMime(buffer, name) {
   return EXT_MIME[ext] ?? "application/octet-stream";
 }
 
-// src/commands/chat.ts
+// src/lib/conversations.ts
 var UUID_RE = /^[0-9a-f]{8}-[0-9a-f]{4}-[0-9a-f]{4}-[0-9a-f]{4}-[0-9a-f]{12}$/i;
 var CUID_RE = /^c[a-z0-9]{20,}$/i;
 function looksLikeConversationId(t) {
   return UUID_RE.test(t) || CUID_RE.test(t);
 }
+function normalizeUserId(id) {
+  return id.replace(/^did:privy:/, "");
+}
 function authOrExit() {
   try {
     return requireAuth();
@@ -28973,9 +29067,531 @@ function authOrExit() {
 function convLabel(conv, selfUserId) {
   if (conv.title)
     return conv.title;
-  const others = (conv.participants ?? []).filter((p) => !(p.participant_type === "user" && p.participant_id === selfUserId)).map((p) => p.user?.name ?? p.twin?.name ?? p.participant_id.slice(0, 8)).filter((n) => !!n);
+  const self = selfUserId ? normalizeUserId(selfUserId) : undefined;
+  const others = (conv.participants ?? []).filter((p) => !(p.participant_type === "user" && normalizeUserId(p.participant_id) === self)).map((p) => p.user?.name ?? p.twin?.name ?? p.participant_id.slice(0, 8)).filter((n) => !!n);
   return others.length ? others.join(", ") : "(conversation)";
 }
+function candidateList(users) {
+  return users.map((u) => `${u.name ?? "?"} (@${u.handle ?? u.id.slice(0, 8)})`).join(", ");
+}
+async function resolveMembers(auth, tokens) {
+  const resolved = [];
+  const failures = [];
+  const seen = new Set;
+  let friendsCache = null;
+  const getFriends = async () => {
+    if (friendsCache)
+      return friendsCache;
+    const data = await amikoWebFetch(auth, "/api/friends", {
+      query: { type: "user" },
+      timeoutMs: 15000
+    });
+    friendsCache = (data.friends ?? []).map((f) => f.friend).filter((f) => !!f && f.type === "user");
+    return friendsCache;
+  };
+  const push = (m) => {
+    if (seen.has(m.userId))
+      return;
+    seen.add(m.userId);
+    resolved.push(m);
+  };
+  for (const raw of tokens) {
+    const token = raw.trim();
+    if (!token)
+      continue;
+    const asId = normalizeUserId(token);
+    if (looksLikeConversationId(asId)) {
+      push({ token, userId: asId, source: "id" });
+      continue;
+    }
+    if (token.startsWith("@")) {
+      const handle = token.slice(1);
+      try {
+        const prof = await amikoWebFetch(auth, `/api/users/${encodeURIComponent(handle)}`, {
+          timeoutMs: 15000
+        });
+        if (!prof.user?.id)
+          throw new Error(`No user @${handle}.`);
+        push({
+          token,
+          userId: prof.user.id,
+          name: prof.user.name ?? undefined,
+          handle: prof.user.handle ?? handle,
+          source: "handle"
+        });
+      } catch (e5) {
+        failures.push({
+          token,
+          reason: e5 instanceof Error ? e5.message : `No user @${handle}.`
+        });
+      }
+      continue;
+    }
+    try {
+      const friends = await getFriends();
+      const lower = token.toLowerCase();
+      const exact = friends.filter((f) => f.name?.toLowerCase() === lower || f.handle?.toLowerCase() === lower);
+      const matches = exact.length ? exact : friends.filter((f) => f.name?.toLowerCase().includes(lower) || f.handle?.toLowerCase().includes(lower));
+      if (matches.length === 1) {
+        const f = matches[0];
+        push({
+          token,
+          userId: f.id,
+          name: f.name,
+          handle: f.handle,
+          source: "friend"
+        });
+        continue;
+      }
+      if (matches.length > 1) {
+        failures.push({
+          token,
+          reason: `ambiguous — matches: ${candidateList(matches)}. Use an exact @handle or a user id.`
+        });
+        continue;
+      }
+      const res = await amikoWebFetch(auth, "/api/search", {
+        query: { q: token, type: "people", limit: 8 },
+        timeoutMs: 15000
+      });
+      const users = res.users ?? [];
+      if (users.length === 1) {
+        const u = users[0];
+        push({
+          token,
+          userId: u.id,
+          name: u.name,
+          handle: u.handle,
+          source: "search"
+        });
+      } else if (users.length > 1) {
+        failures.push({
+          token,
+          reason: `ambiguous — matches: ${candidateList(users)}. Use an exact @handle or a user id.`
+        });
+      } else {
+        failures.push({
+          token,
+          reason: `no friend or user matches. Use an exact @handle, or an id from \`amiko friends list --json\`.`
+        });
+      }
+    } catch (e5) {
+      failures.push({
+        token,
+        reason: e5 instanceof Error ? e5.message : "lookup failed"
+      });
+    }
+  }
+  return { resolved, failures };
+}
+async function fetchConversationById(auth, id) {
+  const data = await amikoWebFetch(auth, `/api/conversations/${encodeURIComponent(id)}`, { timeoutMs: 20000 });
+  if (!data.conversation) {
+    throw new Error(`Conversation ${id} not found or you are not a participant.`);
+  }
+  return data.conversation;
+}
+async function listGroups(auth, limit = 100) {
+  const data = await amikoWebFetch(auth, "/api/conversations", { query: { limit }, timeoutMs: 20000 });
+  return (data.conversations ?? []).filter((c) => c.conversation_type === "group");
+}
+async function findGroupIdByExactTitle(auth, title) {
+  const lower = title.trim().toLowerCase();
+  if (!lower)
+    return null;
+  const groups = await listGroups(auth);
+  const matches = groups.filter((g) => g.title?.toLowerCase() === lower);
+  return matches.length === 1 ? matches[0].id : null;
+}
+async function resolveGroup(auth, target) {
+  const t = target.trim();
+  if (!t) {
+    throw new Error("No group given. Run `amiko chat group list` and pass a group id or title.");
+  }
+  if (looksLikeConversationId(t)) {
+    const conv = await fetchConversationById(auth, t);
+    if (conv.conversation_type !== "group") {
+      throw new Error(`Conversation ${t} is not a group chat (type: ${conv.conversation_type}).`);
+    }
+    return conv;
+  }
+  const groups = await listGroups(auth);
+  const lower = t.toLowerCase();
+  const exact = groups.filter((g) => g.title?.toLowerCase() === lower);
+  const matches = exact.length ? exact : groups.filter((g) => g.title?.toLowerCase().includes(lower));
+  if (matches.length === 0) {
+    throw new Error(`No group matching "${t}". Run \`amiko chat group list\` and use the group's id or exact title.`);
+  }
+  if (matches.length > 1) {
+    const names = matches.map((g) => `"${g.title}" (${g.id})`).join(", ");
+    throw new Error(`"${t}" is ambiguous — matches: ${names}. Use the group's id.`);
+  }
+  return fetchConversationById(auth, matches[0].id);
+}
+
+// src/commands/chat-group.ts
+var collect = (v, prev) => [...prev, v];
+function statusOf2(e5) {
+  return e5 && typeof e5 === "object" && "status" in e5 ? e5.status : undefined;
+}
+var ADMIN_TIP = "Only group admins can do this — check roles with `amiko chat group info`.";
+function memberLabel(m) {
+  const name = m.name ?? m.token;
+  return m.handle ? `${name} (@${m.handle})` : name;
+}
+function memberFlags(tokens) {
+  return tokens.map((t) => `--member ${JSON.stringify(t)}`).join(" ");
+}
+function exitWithError(e5, fallback2) {
+  console.error(error(e5 instanceof Error ? e5.message : fallback2));
+  process.exit(1);
+}
+async function resolveMembersOrExit(auth, tokens) {
+  if (tokens.length === 0) {
+    console.error(error("At least one --member is required."));
+    process.exit(1);
+  }
+  let resolution;
+  try {
+    resolution = await resolveMembers(auth, tokens);
+  } catch (e5) {
+    exitWithError(e5, "Could not resolve members");
+  }
+  const { resolved, failures } = resolution;
+  if (failures.length > 0) {
+    console.error(error("Could not resolve every member — nothing was changed."));
+    for (const m of resolved) {
+      console.error(dim(`  resolved: ${memberLabel(m)} → ${m.userId}`));
+    }
+    for (const f of failures) {
+      console.error(error(`  ${JSON.stringify(f.token)}: ${f.reason}`));
+    }
+    process.exit(1);
+  }
+  return resolved;
+}
+async function resolveGroupOrExit(auth, target) {
+  try {
+    return await resolveGroup(auth, target);
+  } catch (e5) {
+    exitWithError(e5, "Could not resolve group");
+  }
+}
+function activeParticipantOf(conv, userId) {
+  return (conv.participants ?? []).find((p) => p.participant_type === "user" && normalizeUserId(p.participant_id) === userId && !p.left_at);
+}
+function participantName(p) {
+  return p.user?.name ?? p.twin?.name ?? p.user?.handle ?? p.participant_id.slice(0, 8);
+}
+function reportMemberResults(conversationId, results, raw) {
+  if (raw) {
+    console.log(JSON.stringify({
+      conversation_id: conversationId,
+      results: results.map((r) => ({
+        user_id: r.member.userId,
+        member: memberLabel(r.member),
+        outcome: r.outcome,
+        ok: r.ok
+      }))
+    }, null, 2));
+    return;
+  }
+  for (const r of results) {
+    const line = `${memberLabel(r.member)} — ${r.outcome}`;
+    console.log(r.ok ? success(line) : error(line));
+  }
+}
+function registerChatGroupCommand(group) {
+  group.command("create <name>").description("Create a group chat with the given name and members").option("--member <who>", "Member to add (name, @handle, or user id); repeat per member", collect, []).option("--yes", "Skip the confirmation (required in non-interactive shells)").option("--raw", "Output raw JSON").action(async (name, opts) => {
+    const auth = authOrExit();
+    const members = await resolveMembersOrExit(auth, opts.member);
+    await requireApproval({
+      free: "creates a group chat that real people are added to",
+      summary: `Create group "${name}" with ${members.map(memberLabel).join(", ")}`,
+      yes: opts.yes,
+      commandExample: `amiko chat group create ${JSON.stringify(name)} ${memberFlags(opts.member)}`
+    });
+    let data;
+    try {
+      data = await amikoWebFetch(auth, "/api/conversations", {
+        method: "POST",
+        body: {
+          participant_ids: members.map((m) => m.userId),
+          participant_types: members.map(() => "user"),
+          conversation_type: "group",
+          title: name
+        },
+        timeoutMs: 20000
+      });
+    } catch (e5) {
+      exitWithError(e5, "Failed to create group");
+    }
+    if (opts.raw) {
+      console.log(JSON.stringify(data, null, 2));
+      return;
+    }
+    if (!data.conversation?.id) {
+      console.error(error("Group creation returned no conversation id."));
+      process.exit(1);
+    }
+    console.log(success(`Group created: ${name}`));
+    console.log(label("ID", data.conversation.id));
+    console.log(label("Members", `${members.map(memberLabel).join(", ")} + you (admin)`));
+    if (data.reused_existing) {
+      console.log(dim("Note: an existing matching group was reused."));
+    }
+  });
+  group.command("list").description("List your group chats").option("--limit <n>", "Max conversations to scan", "100").option("--raw", "Output raw JSON").action(async (opts) => {
+    const auth = authOrExit();
+    let groups;
+    try {
+      const data = await amikoWebFetch(auth, "/api/conversations", { query: { limit: opts.limit }, timeoutMs: 20000 });
+      groups = (data.conversations ?? []).filter((c) => c.conversation_type === "group");
+    } catch (e5) {
+      exitWithError(e5, "Failed to list groups");
+    }
+    if (opts.raw) {
+      console.log(JSON.stringify({ groups }, null, 2));
+      return;
+    }
+    if (groups.length === 0) {
+      console.log(dim("No group chats."));
+      return;
+    }
+    console.log(heading(`Groups (${groups.length})
+`));
+    const rows = [
+      [dim("TITLE"), dim("ID"), dim("MEMBERS"), dim("UNREAD"), dim("LAST")],
+      ...groups.map((g) => [
+        g.title ?? "(untitled)",
+        g.id,
+        String(g.participants?.length ?? "-"),
+        g.unread_count ? String(g.unread_count) : "-",
+        g.last_message?.content?.slice(0, 40) ?? "-"
+      ])
+    ];
+    console.log(table(rows));
+  });
+  group.command("info <group>").description("Show a group's members and roles (group id or title)").option("--raw", "Output raw JSON").action(async (target, opts) => {
+    const auth = authOrExit();
+    const conv = await resolveGroupOrExit(auth, target);
+    if (opts.raw) {
+      console.log(JSON.stringify({ conversation: conv }, null, 2));
+      return;
+    }
+    const selfId = auth.userId ? normalizeUserId(auth.userId) : undefined;
+    const active = (conv.participants ?? []).filter((p) => !p.left_at);
+    console.log(heading(conv.title ?? "(untitled group)"));
+    console.log(label("ID", conv.id));
+    console.log(label("Members", String(active.length)));
+    console.log("");
+    const rows = [
+      [dim("NAME"), dim("HANDLE"), dim("USER ID"), dim("TYPE"), dim("ROLE")],
+      ...active.map((p) => {
+        const isSelf = p.participant_type === "user" && normalizeUserId(p.participant_id) === selfId;
+        return [
+          participantName(p) + (isSelf ? " (you)" : ""),
+          p.user?.handle ? `@${p.user.handle}` : "-",
+          p.participant_id,
+          p.participant_type,
+          p.role ?? "member"
+        ];
+      })
+    ];
+    console.log(table(rows));
+  });
+  group.command("invite <group>").description("Show a group's invite/join link + QR image URL (admins only)").option("--raw", "Output raw JSON").action(async (target, opts) => {
+    const auth = authOrExit();
+    const conv = await resolveGroupOrExit(auth, target);
+    let data;
+    try {
+      data = await amikoWebFetch(auth, `/api/conversations/${encodeURIComponent(conv.id)}/invite`, { timeoutMs: 20000 });
+    } catch (e5) {
+      if (statusOf2(e5) === 403) {
+        console.error(error(`Can't view the invite link. ${ADMIN_TIP}`));
+        process.exit(1);
+      }
+      exitWithError(e5, "Failed to load invite link");
+    }
+    if (!data.url || !data.qrUrl) {
+      exitWithError(null, "The invite link response was missing its link or QR URL — nothing to share.");
+    }
+    if (opts.raw) {
+      console.log(JSON.stringify(data, null, 2));
+      return;
+    }
+    console.log(heading(conv.title ?? "(untitled group)"));
+    console.log(label("Invite link", data.url));
+    console.log(label("QR image", data.qrUrl));
+    console.log(dim("Share with group admins only — anyone who opens it can join."));
+  });
+  group.command("rename <group> <newTitle>").description("Rename a group (admins only)").option("--yes", "Skip the confirmation (required in non-interactive shells)").option("--raw", "Output raw JSON").action(async (target, newTitle, opts) => {
+    const auth = authOrExit();
+    const conv = await resolveGroupOrExit(auth, target);
+    await confirmDestructive({
+      action: `Rename group "${conv.title ?? conv.id}" to "${newTitle}"`,
+      yes: opts.yes,
+      commandExample: `amiko chat group rename ${JSON.stringify(target)} ${JSON.stringify(newTitle)}`
+    });
+    let data;
+    try {
+      data = await amikoWebFetch(auth, `/api/conversations/${encodeURIComponent(conv.id)}`, { method: "PATCH", body: { title: newTitle }, timeoutMs: 20000 });
+    } catch (e5) {
+      if (statusOf2(e5) === 403) {
+        console.error(error(`Rename failed. ${ADMIN_TIP}`));
+        process.exit(1);
+      }
+      exitWithError(e5, "Rename failed");
+    }
+    if (opts.raw) {
+      console.log(JSON.stringify(data, null, 2));
+      return;
+    }
+    console.log(success(`Group renamed to: ${newTitle}`) + dim(` (${conv.id})`));
+  });
+  group.command("add <group>").description("Add members to a group (admins only)").option("--member <who>", "Member to add (name, @handle, or user id); repeat per member", collect, []).option("--yes", "Skip the confirmation (required in non-interactive shells)").option("--raw", "Output raw JSON").action(async (target, opts) => {
+    const auth = authOrExit();
+    const members = await resolveMembersOrExit(auth, opts.member);
+    const conv = await resolveGroupOrExit(auth, target);
+    await requireApproval({
+      free: "adds real people to the group",
+      summary: `Add ${members.map(memberLabel).join(", ")} to group "${conv.title ?? conv.id}"`,
+      yes: opts.yes,
+      commandExample: `amiko chat group add ${JSON.stringify(target)} ${memberFlags(opts.member)}`
+    });
+    const results = [];
+    let hardFailure = false;
+    for (const m of members) {
+      if (activeParticipantOf(conv, m.userId)) {
+        results.push({ member: m, outcome: "already a member", ok: true });
+        continue;
+      }
+      try {
+        await amikoWebFetch(auth, `/api/conversations/${encodeURIComponent(conv.id)}/participants`, {
+          method: "POST",
+          body: { participant_id: m.userId, participant_type: "user" },
+          timeoutMs: 20000
+        });
+        results.push({ member: m, outcome: "added", ok: true });
+      } catch (e5) {
+        const status = statusOf2(e5);
+        if (status === 409) {
+          results.push({ member: m, outcome: "already a member", ok: true });
+        } else if (status === 403) {
+          if (results.length)
+            reportMemberResults(conv.id, results, opts.raw);
+          console.error(error(`Adding members failed. ${ADMIN_TIP}`));
+          process.exit(1);
+        } else if (status === 404) {
+          results.push({ member: m, outcome: "user not found", ok: false });
+          hardFailure = true;
+        } else {
+          results.push({
+            member: m,
+            outcome: e5 instanceof Error ? e5.message : "failed",
+            ok: false
+          });
+          hardFailure = true;
+        }
+      }
+    }
+    reportMemberResults(conv.id, results, opts.raw);
+    if (hardFailure)
+      process.exit(1);
+  });
+  group.command("remove <group>").description("Remove members from a group (admins only; anyone can remove themselves)").option("--member <who>", "Member to remove (name, @handle, or user id); repeat per member", collect, []).option("--yes", "Skip the confirmation (required in non-interactive shells)").option("--raw", "Output raw JSON").action(async (target, opts) => {
+    const auth = authOrExit();
+    const members = await resolveMembersOrExit(auth, opts.member);
+    const conv = await resolveGroupOrExit(auth, target);
+    await confirmDestructive({
+      action: `Remove ${members.map(memberLabel).join(", ")} from group "${conv.title ?? conv.id}"`,
+      yes: opts.yes,
+      commandExample: `amiko chat group remove ${JSON.stringify(target)} ${memberFlags(opts.member)}`
+    });
+    const results = [];
+    let hardFailure = false;
+    for (const m of members) {
+      const row = activeParticipantOf(conv, m.userId);
+      if (!row?.id) {
+        results.push({ member: m, outcome: "not a member", ok: true });
+        continue;
+      }
+      try {
+        await amikoWebFetch(auth, `/api/conversations/${encodeURIComponent(conv.id)}/participants/${encodeURIComponent(row.id)}`, { method: "DELETE", timeoutMs: 20000 });
+        results.push({ member: m, outcome: "removed", ok: true });
+      } catch (e5) {
+        if (statusOf2(e5) === 403) {
+          if (results.length)
+            reportMemberResults(conv.id, results, opts.raw);
+          console.error(error(`Removing members failed. ${ADMIN_TIP}`));
+          process.exit(1);
+        }
+        results.push({
+          member: m,
+          outcome: e5 instanceof Error ? e5.message : "failed",
+          ok: false
+        });
+        hardFailure = true;
+      }
+    }
+    reportMemberResults(conv.id, results, opts.raw);
+    if (hardFailure)
+      process.exit(1);
+  });
+  group.command("leave <group>").alias("delete").description("Leave a group (hides it for you only — other members keep the conversation)").option("--yes", "Skip the confirmation (required in non-interactive shells)").option("--raw", "Output raw JSON").action(async (target, opts) => {
+    const auth = authOrExit();
+    const conv = await resolveGroupOrExit(auth, target);
+    await confirmDestructive({
+      action: `Leave group "${conv.title ?? conv.id}" — this removes/hides the conversation for YOU only; other members keep it and its history.`,
+      yes: opts.yes,
+      commandExample: `amiko chat group leave ${JSON.stringify(target)}`
+    });
+    let data;
+    try {
+      data = await amikoWebFetch(auth, `/api/conversations/${encodeURIComponent(conv.id)}`, { method: "DELETE", timeoutMs: 20000 });
+    } catch (e5) {
+      exitWithError(e5, "Leave failed");
+    }
+    if (opts.raw) {
+      console.log(JSON.stringify(data, null, 2));
+      return;
+    }
+    console.log(success(`Left group "${conv.title ?? conv.id}"`) + dim(" (hidden for you; other members keep it)"));
+  });
+  group.command("promote <group>").description("Promote a member to group admin (admins only)").requiredOption("--member <who>", "Member to promote (name, @handle, or user id)").option("--yes", "Skip the confirmation (required in non-interactive shells)").option("--raw", "Output raw JSON").action(async (target, opts) => {
+    const auth = authOrExit();
+    const [member] = await resolveMembersOrExit(auth, [opts.member]);
+    const conv = await resolveGroupOrExit(auth, target);
+    const row = activeParticipantOf(conv, member.userId);
+    if (!row?.id) {
+      console.error(error(`${memberLabel(member)} is not a member of "${conv.title ?? conv.id}".`));
+      process.exit(1);
+    }
+    await confirmDestructive({
+      action: `Promote ${memberLabel(member)} to admin in "${conv.title ?? conv.id}"`,
+      detail: "There is no demote — this cannot be undone from the CLI.",
+      yes: opts.yes,
+      commandExample: `amiko chat group promote ${JSON.stringify(target)} --member ${JSON.stringify(opts.member)}`
+    });
+    let data;
+    try {
+      data = await amikoWebFetch(auth, `/api/conversations/${encodeURIComponent(conv.id)}/participants/${encodeURIComponent(row.id)}`, { method: "PATCH", body: { role: "admin" }, timeoutMs: 20000 });
+    } catch (e5) {
+      if (statusOf2(e5) === 403) {
+        console.error(error(`Promote failed. ${ADMIN_TIP}`));
+        process.exit(1);
+      }
+      exitWithError(e5, "Promote failed");
+    }
+    if (opts.raw) {
+      console.log(JSON.stringify(data, null, 2));
+      return;
+    }
+    console.log(success(`${memberLabel(member)} is now an admin.`));
+  });
+}
+
+// src/commands/chat.ts
 async function findOrCreateDm(auth, userId) {
   const data = await amikoWebFetch(auth, "/api/conversations", {
     method: "POST",
@@ -28991,30 +29607,91 @@ async function findOrCreateDm(auth, userId) {
     throw new Error("Could not open a conversation with that user.");
   return id;
 }
+async function fetchUserById(auth, id) {
+  try {
+    const prof = await amikoWebFetch(auth, `/api/users/${encodeURIComponent(id)}`, { timeoutMs: 15000 });
+    return prof.user?.id ? { ...prof.user, id: prof.user.id } : null;
+  } catch (e5) {
+    if (e5.status === 404)
+      return null;
+    throw e5;
+  }
+}
+async function findDmByUserId(auth, userId) {
+  const want = normalizeUserId(userId);
+  const limit = 100;
+  for (let offset = 0;offset < 1e4; offset += limit) {
+    const data = await amikoWebFetch(auth, "/api/conversations", {
+      query: { limit, offset },
+      timeoutMs: 20000
+    });
+    const page = data.conversations ?? [];
+    const dm = page.find((c) => c.conversation_type === "direct" && (c.participants ?? []).some((p) => p.participant_type === "user" && normalizeUserId(p.participant_id) === want));
+    if (dm)
+      return dm.id;
+    if (page.length < limit || data.pagination?.has_more === false)
+      return null;
+  }
+  return null;
+}
+function personLabel(u) {
+  const name = u.name ?? u.id;
+  return u.handle ? `${name} (@${u.handle})` : name;
+}
 async function resolveConversation(auth, target) {
   const t = target.trim();
-  if (looksLikeConversationId(t))
-    return t;
+  if (!t) {
+    throw new Error("No target given. Pass a conversation id, a user id, an @handle, or a name.");
+  }
+  const person = (u) => ({
+    kind: "user",
+    userId: u.id,
+    label: `DM with ${personLabel(u)}`
+  });
   if (t.startsWith("@")) {
     const handle = t.slice(1);
-    const prof = await amikoWebFetch(auth, `/api/users/${encodeURIComponent(handle)}`, { timeoutMs: 15000 });
+    const prof = await amikoWebFetch(auth, `/api/users/${encodeURIComponent(handle)}`, {
+      timeoutMs: 15000
+    });
     if (!prof.user?.id)
       throw new Error(`No user @${handle}.`);
-    return findOrCreateDm(auth, prof.user.id);
+    return person({ ...prof.user, id: prof.user.id });
   }
-  const res = await amikoWebFetch(auth, "/api/search", {
-    query: { q: t, type: "people", limit: 8 },
-    timeoutMs: 15000
-  });
-  const users = res.users ?? [];
-  if (users.length === 0) {
-    throw new Error(`No user matching "${t}". Use an exact @handle, or a conversation id from \`amiko chat list\`.`);
+  const idish = normalizeUserId(t);
+  if (looksLikeConversationId(idish)) {
+    if (idish === t) {
+      try {
+        const conv = await fetchConversationById(auth, t);
+        return {
+          kind: "conversation",
+          id: conv.id,
+          label: conv.conversation_type === "direct" ? `DM with ${convLabel(conv, auth.userId)}` : `group "${convLabel(conv, auth.userId)}"`
+        };
+      } catch (e5) {
+        const status = e5.status;
+        if (status === 403) {
+          throw new Error(`Conversation ${t} exists but you are not a participant.`);
+        }
+        if (status !== 404)
+          throw e5;
+      }
+    }
+    const user = await fetchUserById(auth, idish);
+    if (!user) {
+      throw new Error(`"${t}" is neither a conversation nor a user id — check \`amiko chat list\` or \`amiko friends list --json\`.`);
+    }
+    return person(user);
   }
-  if (users.length > 1) {
-    const names = users.map((u) => `${u.name ?? "?"} (@${u.handle ?? u.id.slice(0, 8)})`).join(", ");
-    throw new Error(`"${t}" is ambiguous — matches: ${names}. Use an exact @handle or a conversation id.`);
+  const groupId = await findGroupIdByExactTitle(auth, t);
+  if (groupId)
+    return { kind: "conversation", id: groupId, label: `group "${t}"` };
+  const { resolved, failures } = await resolveMembers(auth, [t]);
+  if (failures.length || resolved.length !== 1) {
+    const reason = failures[0]?.reason ?? "could not be resolved";
+    throw new Error(`"${t}" ${reason}`);
   }
-  return findOrCreateDm(auth, users[0].id);
+  const p = resolved[0];
+  return person({ id: p.userId, name: p.name, handle: p.handle });
 }
 var HTTPS_RE = /^https:\/\//i;
 var CHAT_IMAGE_MIME = new Set([
@@ -29101,11 +29778,20 @@ function registerChatCommand(chat) {
         console.log(dim(` ${unread.trim()}`));
     }
   });
-  chat.command("read <target>").description("Read recent messages in a conversation (conversation id, @handle, or name)").option("--limit <n>", "Max messages", "20").option("--raw", "Output raw JSON").action(async (target, opts) => {
+  chat.command("read <target>").description("Read recent messages in a conversation (conversation id, user id, @handle, or name)").option("--limit <n>", "Max messages", "20").option("--raw", "Output raw JSON").action(async (target, opts) => {
     const auth = authOrExit();
     let convId;
     try {
-      convId = await resolveConversation(auth, target);
+      const resolved = await resolveConversation(auth, target);
+      if (resolved.kind === "user") {
+        const existing = await findDmByUserId(auth, resolved.userId);
+        if (!existing) {
+          throw new Error(`No ${resolved.label} yet — start one with \`amiko chat send\`.`);
+        }
+        convId = existing;
+      } else {
+        convId = resolved.id;
+      }
     } catch (e5) {
       console.error(error(e5 instanceof Error ? e5.message : "Could not resolve target"));
       process.exit(1);
@@ -29136,26 +29822,33 @@ function registerChatCommand(chat) {
         console.log(dim(`  ${when}`));
     }
   });
-  chat.command("send <target> <message>").description("Send a message as yourself (the owner) to a conversation (id, @handle, or name)").option("--image <pathOrUrl>", "Attach an image: local file (jpg/png/webp/gif, ≤10MB) or an Amiko URL (e.g. from `amiko create`)").option("--audio <pathOrUrl>", "Attach audio as a voice note: local file (≤25MB) or an Amiko URL").option("--yes", "Skip the confirmation (required in non-interactive shells)").option("--raw", "Output raw JSON").action(async (target, message, opts) => {
+  chat.command("send <target> <message>").description("Send a message as yourself (the owner) to a conversation or person (conversation id, user id, @handle, or name — DMs are opened automatically)").option("--image <pathOrUrl>", "Attach an image: local file (jpg/png/webp/gif, ≤10MB) or an Amiko URL (e.g. from `amiko create`)").option("--audio <pathOrUrl>", "Attach audio as a voice note: local file (≤25MB) or an Amiko URL").option("--yes", "Skip the confirmation (required in non-interactive shells)").option("--raw", "Output raw JSON").action(async (target, message, opts) => {
     const auth = authOrExit();
     if (opts.image && opts.audio) {
       console.error(error("Attach either --image or --audio, not both (one media block per message)."));
       process.exit(1);
     }
-    let convId;
+    let resolved;
     try {
-      convId = await resolveConversation(auth, target);
+      resolved = await resolveConversation(auth, target);
     } catch (e5) {
       console.error(error(e5 instanceof Error ? e5.message : "Could not resolve target"));
       process.exit(1);
     }
     const media = opts.image ? `image ${opts.image}` : opts.audio ? `audio ${opts.audio}` : "";
     await requireApproval({
-      cost: "no charge — sends a message as you (the owner)",
-      summary: `Send to ${target}${media ? ` [+${media}]` : ""}: ${message.slice(0, 80)}${message.length > 80 ? "…" : ""}`,
+      free: "sends a message as you (the owner) — the recipients see it",
+      summary: `Send to ${resolved.label}${media ? ` [+${media}]` : ""}: ${message.slice(0, 80)}${message.length > 80 ? "…" : ""}`,
       yes: opts.yes,
       commandExample: `amiko chat send ${JSON.stringify(target)} ${JSON.stringify(message)}`
     });
+    let convId;
+    try {
+      convId = resolved.kind === "user" ? await findOrCreateDm(auth, resolved.userId) : resolved.id;
+    } catch (e5) {
+      console.error(error(e5 instanceof Error ? e5.message : "Could not open the conversation"));
+      process.exit(1);
+    }
     const messagesPath = `/api/conversations/${encodeURIComponent(convId)}/messages`;
     const post = (body) => amikoWebFetch(auth, messagesPath, {
       method: "POST",
@@ -29192,6 +29885,8 @@ function registerChatCommand(chat) {
     const what = opts.image ? "Message + image sent" : opts.audio ? "Message + voice note sent" : "Message sent";
     console.log(success(what) + dim(` (conversation ${convId.slice(0, 8)}…)`));
   });
+  const group = chat.command("group").description("Group chats — create, list, info, rename, add/remove members, leave");
+  registerChatGroupCommand(group);
 }
 
 // src/commands/card.ts
@@ -29407,24 +30102,29 @@ function registerCardCommand(card) {
 }
 
 // src/commands/amazon.ts
-var TREASURY3 = "FPiZAf3jEnNfCwfvbv46jdPfHbmSepD4Q6iHiLJDQXvb";
-async function payAmiko(auth, wallet, amount2) {
-  const data = await amikoWebFetch(auth, `/api/agents/${encodeURIComponent(auth.twinId)}/wallets/${encodeURIComponent(wallet)}/transfer`, {
-    method: "POST",
-    body: { to: TREASURY3, amount: amount2, token: "AMIKO", chain: "solana" }
-  });
-  if (!data.txHash)
-    throw new Error("No tx hash returned.");
-  return data.txHash;
-}
+var AMAZON_SEARCH_USD = 0.01;
 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("--wallet <address>", "Wallet to pay from (defaults to your Solana wallet — run `amiko wallets create --chain solana` if you don't have one)").option("--raw", "Output raw JSON").option("--yes", "Skip the pre-spend confirmation (required in non-interactive shells)").action(async (query, opts) => {
+  const cmd = program2.command("amazon").description("Search and buy products on Amazon — pay in AMIKO, USDC, or USDT");
+  cmd.command("search <query>").description("Search Amazon products — $0.01, paid in AMIKO, USDC, or USDT").option("--limit <n>", "Number of results", "5").option("--wallet <address>", "Wallet to pay from (defaults to your Solana wallet — run `amiko wallets create --chain solana` if you don't have one)").option("--token <token>", "Payment token (AMIKO, USDC, USDT)", "AMIKO").option("--raw", "Output raw JSON").option("--yes", "Skip the pre-spend confirmation (required in non-interactive shells)").action(async (query, opts) => {
+    let payToken;
+    try {
+      payToken = normalizePaymentToken(opts.token);
+    } catch (e5) {
+      console.error(error(e5 instanceof Error ? e5.message : String(e5)));
+      process.exit(1);
+    }
+    let quote;
+    try {
+      quote = await quoteTokenAmount(resolveAuth(), payToken, AMAZON_SEARCH_USD);
+    } catch (e5) {
+      console.error(error(e5 instanceof Error ? e5.message : String(e5)));
+      process.exit(1);
+    }
     await requireApproval({
-      cost: "1 AMIKO",
+      cost: `${quote.amount} ${payToken} (≈ $${AMAZON_SEARCH_USD.toFixed(2)})`,
       summary: `Amazon product search: ${query.slice(0, 80)}${query.length > 80 ? "…" : ""}`,
       yes: opts.yes,
-      commandExample: `amiko markets amazon search ${JSON.stringify(query)}`
+      commandExample: `amiko markets amazon search ${JSON.stringify(query)}${payToken !== "AMIKO" ? ` --token ${payToken}` : ""}`
     });
     const spinner = ora("Searching Amazon...").start();
     try {
@@ -29446,14 +30146,14 @@ function registerAmazonCommand(program2) {
         console.error(error(e5 instanceof Error ? e5.message : String(e5)));
         process.exit(1);
       }
-      spinner.text = "Paying 1 AMIKO...";
-      const txHash = await payAmiko(auth, wallet, "1");
+      spinner.text = `Paying ${quote.amount} ${payToken}...`;
+      const txHash = await payTreasury(auth, { wallet, amount: quote.amount, token: payToken });
       spinner.text = "Searching Amazon...";
       const params = new URLSearchParams({
         q: `site:amazon.com ${query}`
       });
       const res = await fetch(`${mppBase2}/v1/search/google_shopping?${params}`, {
-        headers: { "X-Payment-Tx": txHash, "X-Twin-Id": auth.twinId }
+        headers: { "X-Payment-Tx": txHash, "X-Payment-Token": payToken, "X-Twin-Id": auth.twinId }
       });
       spinner.stop();
       if (!res.ok) {
@@ -29550,52 +30250,52 @@ function registerAmazonCommand(program2) {
 }
 
 // src/commands/services.ts
-var TREASURY4 = "FPiZAf3jEnNfCwfvbv46jdPfHbmSepD4Q6iHiLJDQXvb";
 function usdToAmiko(usd2, pricePerAmiko) {
   if (pricePerAmiko <= 0)
     return "1";
   const amount2 = usd2 / pricePerAmiko;
   return Math.ceil(amount2 * 100) / 100 + "";
 }
-async function payAndCall(mppBase2, method, path2, auth, wallet, amountOrAuto, body, onProgress, token = "AMIKO") {
+async function payAndCall(mppBase2, method, path2, auth, wallet, amountOrAuto, body, onProgress, rawToken = "AMIKO") {
+  const token = normalizePaymentToken(rawToken);
   if (!path2.startsWith("/")) {
     throw new Error(`path must start with "/" — got: ${path2}`);
   }
   let amount2 = amountOrAuto;
   if (amount2 === "auto") {
     onProgress?.("Fetching price...");
+    let usdPrice = 0;
     try {
       const specRes = await fetchWithTimeout2(`${mppBase2}/openapi.json`, {}, 15000);
       if (specRes.ok) {
         const spec = await specRes.json();
         const pathSpec = spec.paths?.[path2];
         const methodSpec = pathSpec?.[method.toLowerCase()];
-        const usdPrice = parseFloat(methodSpec?.["x-payment-info"]?.price || "0");
-        if (usdPrice > 0) {
-          const amikoPrice = await getTokenUsdPrice(auth, "AMIKO") ?? 0;
-          amount2 = usdToAmiko(usdPrice, amikoPrice);
-          onProgress?.(`Price: $${usdPrice.toFixed(4)} = ${amount2} AMIKO`);
-        } else {
-          amount2 = "1";
-        }
-      } else {
-        amount2 = "1";
+        usdPrice = parseFloat(methodSpec?.["x-payment-info"]?.price || "0");
       }
     } catch {
+      usdPrice = 0;
+    }
+    if (token === "USDC" || token === "USDT") {
+      if (!(usdPrice > 0)) {
+        throw new Error(`Could not auto-price ${path2} in USD — pass an explicit amount (e.g. --${token.toLowerCase()} 0.01).`);
+      }
+      amount2 = usdPrice.toFixed(6);
+      onProgress?.(`Price: $${usdPrice.toFixed(4)} = ${amount2} ${token}`);
+    } else if (usdPrice > 0) {
+      const amikoPrice = await getTokenUsdPrice(auth, "AMIKO") ?? 0;
+      amount2 = usdToAmiko(usdPrice, amikoPrice);
+      onProgress?.(`Price: $${usdPrice.toFixed(4)} = ${amount2} AMIKO`);
+    } else {
       amount2 = "1";
     }
   }
   onProgress?.(`Paying ${amount2} ${token}...`);
-  const transferData = await amikoWebFetch(auth, `/api/agents/${encodeURIComponent(auth.twinId)}/wallets/${encodeURIComponent(wallet)}/transfer`, {
-    method: "POST",
-    body: { to: TREASURY4, amount: amount2, token, chain: "solana" }
-  });
-  const txHash = transferData.txHash;
-  if (!txHash)
-    throw new Error("Payment sent but no tx hash returned.");
+  const txHash = await payTreasury(auth, { wallet, amount: amount2, token });
   const headers = {
     "Content-Type": "application/json",
     "X-Payment-Tx": txHash,
+    "X-Payment-Token": token,
     "X-Twin-Id": auth.twinId
   };
   const fetchOpts = { method, headers };
@@ -29621,7 +30321,7 @@ async function fetchWithTimeout2(url2, init = {}, timeoutMs) {
   }
 }
 function registerServicesCommand(program2) {
-  const svc = program2.command("service").alias("svc").description("Call any MPP service — pays with AMIKO tokens");
+  const svc = program2.command("service").alias("svc").description("Call any MPP service — pay in AMIKO, USDC, or USDT");
   svc.command("tts <voiceId> <text>").description("Text-to-speech — 1 AMIKO").option("--raw", "Output raw response").option("--wallet <address>", "Wallet to pay from (defaults to your Solana wallet — run `amiko wallets create --chain solana` if none)").option("--yes", "Skip the pre-spend confirmation (required in non-interactive shells)").action(async (voiceId, text, opts) => {
     await requireApproval({
       cost: "1 AMIKO",
@@ -29691,13 +30391,13 @@ 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").option("--wallet <address>", "Wallet to pay from (defaults to your Solana wallet — run `amiko wallets create --chain solana` if none)").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)";
+  svc.command("call <method> <path> [body]").description("Call any MPP endpoint — pays in AMIKO, USDC, or USDT on Solana").option("--amiko <amount>", "AMIKO tokens to pay (default: auto-price from USD)").option("--usdc <amount>", 'Pay in USDC instead of AMIKO ("auto" to price from USD)').option("--usdt <amount>", 'Pay in USDT instead of AMIKO ("auto" to price from USD)').option("--raw", "Output raw response").option("--wallet <address>", "Wallet to pay from (defaults to your Solana wallet — run `amiko wallets create --chain solana` if none)").option("--yes", "Skip the pre-spend confirmation (required in non-interactive shells)").action(async (method, path2, bodyStr, opts) => {
+    const costLabel = opts.usdt ? `${opts.usdt} USDT` : 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 markets service call ${method.toUpperCase()} ${path2}${bodyStr ? ` ${JSON.stringify(bodyStr)}` : ""}${opts.amiko ? ` --amiko ${opts.amiko}` : ""}${opts.usdc ? ` --usdc ${opts.usdc}` : ""}`
+      commandExample: `amiko markets service call ${method.toUpperCase()} ${path2}${bodyStr ? ` ${JSON.stringify(bodyStr)}` : ""}${opts.amiko ? ` --amiko ${opts.amiko}` : ""}${opts.usdc ? ` --usdc ${opts.usdc}` : ""}${opts.usdt ? ` --usdt ${opts.usdt}` : ""}`
     });
     let body;
     if (bodyStr) {
@@ -29712,8 +30412,9 @@ function registerServicesCommand(program2) {
       method: method.toUpperCase(),
       path: path2,
       body,
-      amiko: opts.amiko || (opts.usdc ? undefined : "auto"),
+      amiko: opts.amiko || (opts.usdc || opts.usdt ? undefined : "auto"),
       usdc: opts.usdc,
+      usdt: opts.usdt,
       opts
     });
   });
@@ -29764,8 +30465,8 @@ async function callService(params) {
       console.error(error(e5 instanceof Error ? e5.message : String(e5)));
       process.exit(1);
     }
-    const token = params.usdc ? "USDC" : "AMIKO";
-    const amount2 = params.usdc || params.amiko || "auto";
+    const token = params.usdt ? "USDT" : params.usdc ? "USDC" : "AMIKO";
+    const amount2 = params.usdt || params.usdc || params.amiko || "auto";
     const { res, txHash, amikoSpent } = await payAndCall(mppBase2, params.method, params.path, auth, wallet, amount2, params.body, (msg) => {
       spinner.text = msg;
     }, token);
@@ -29956,6 +30657,18 @@ function registerTwinCommand(program2) {
 // src/commands/drive.ts
 import { writeFile as writeFile2 } from "node:fs/promises";
 import { basename as basename2, resolve as resolvePath } from "node:path";
+var DIRECT_UPLOAD_MAX_BYTES = 4 * 1024 * 1024;
+var MAX_DRIVE_UPLOAD_BYTES = 200 * 1024 * 1024;
+var PRESIGNED_PUT_TIMEOUT_MS = 10 * 60 * 1000;
+function shareBase(auth) {
+  return (auth.platformUrl ?? "https://platform.heyamiko.com").replace(/\/$/, "");
+}
+function fileShareUrl(auth, slug) {
+  return `${shareBase(auth)}/d/${slug}`;
+}
+function folderShareUrl(auth, slug) {
+  return `${shareBase(auth)}/d/f/${slug}`;
+}
 function fmtBytes(n) {
   if (!n || n <= 0)
     return "-";
@@ -29968,7 +30681,7 @@ function fmtBytes(n) {
   }
   return `${v.toFixed(v >= 10 ? 0 : 1)} ${units[i]}`;
 }
-function statusOf2(doc2) {
+function statusOf3(doc2) {
   const meta3 = doc2.metadata?.status;
   if (meta3)
     return meta3;
@@ -29999,6 +30712,7 @@ function renderDocTable(docs) {
       dim("TYPE"),
       dim("FOLDER"),
       dim("STATUS"),
+      dim("PUBLIC"),
       dim("CREATED")
     ],
     ...docs.map((doc2) => [
@@ -30006,7 +30720,8 @@ function renderDocTable(docs) {
       doc2.title || doc2.filename,
       doc2.file_type || "-",
       doc2.folder_id || dim("root"),
-      statusOf2(doc2),
+      statusOf3(doc2),
+      doc2.is_public ? "yes" : dim("-"),
       doc2.created_at?.slice(0, 10) || "-"
     ])
   ];
@@ -30079,26 +30794,56 @@ Search hits filename, title, description, and parsed RAG content (once processed
     try {
       const file2 = await resolveFileInput(source, {
         stdin: opts.stdin,
-        hintName: opts.name
+        hintName: opts.name,
+        maxBytes: MAX_DRIVE_UPLOAD_BYTES
       });
       if (spinner)
-        spinner.text = `Uploading ${file2.name}...`;
-      const form = new FormData;
-      form.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: form
-      });
-      if (!upload.url || !upload.filename || !upload.fileType) {
-        throw new Error(`Upload response missing required fields: ${JSON.stringify(upload)}`);
+        spinner.text = `Uploading ${file2.name} (${fmtBytes(file2.size)})...`;
+      let uploadedUrl;
+      let uploadedName;
+      let uploadedType;
+      if (file2.size > DIRECT_UPLOAD_MAX_BYTES) {
+        const pres = await amikoWebFetch(auth, `/api/agents/${twinId}/docs/presigned-url`, {
+          method: "POST",
+          body: { filename: file2.name }
+        });
+        if (!pres.uploadUrl || !pres.publicUrl) {
+          throw new Error(`Presigned-URL response missing fields: ${JSON.stringify(pres)}`);
+        }
+        const putRes = await fetch(pres.uploadUrl, {
+          method: "PUT",
+          headers: { "Content-Type": file2.mime },
+          body: new Uint8Array(file2.buffer),
+          signal: AbortSignal.timeout(PRESIGNED_PUT_TIMEOUT_MS)
+        });
+        if (!putRes.ok) {
+          const detail = await putRes.text().catch(() => "");
+          throw new Error(`Direct storage upload failed: ${putRes.status} ${putRes.statusText}${detail ? ` — ${detail.slice(0, 200)}` : ""}`);
+        }
+        uploadedUrl = pres.publicUrl;
+        uploadedName = file2.name;
+        uploadedType = file2.mime;
+      } else {
+        const form = new FormData;
+        form.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: form
+        });
+        if (!upload.url || !upload.filename || !upload.fileType) {
+          throw new Error(`Upload response missing required fields: ${JSON.stringify(upload)}`);
+        }
+        uploadedUrl = upload.url;
+        uploadedName = upload.filename;
+        uploadedType = upload.fileType;
       }
       if (spinner)
-        spinner.text = `Registering ${upload.filename}...`;
-      const title = opts.title || upload.filename.replace(/\.[^.]+$/, "");
+        spinner.text = `Registering ${uploadedName}...`;
+      const title = opts.title || uploadedName.replace(/\.[^.]+$/, "");
       const body = {
-        filename: upload.filename,
-        fileUrl: upload.url,
-        fileType: upload.fileType,
+        filename: uploadedName,
+        fileUrl: uploadedUrl,
+        fileType: uploadedType,
         title,
         doc_type: opts.docType ?? "other"
       };
@@ -30114,10 +30859,8 @@ Search hits filename, title, description, and parsed RAG content (once processed
         console.log(label("Title", d.title || "-"));
         if (d.folder_id)
           console.log(label("Folder", d.folder_id));
-        if (upload.fileSize)
-          console.log(label("Size", fmtBytes(upload.fileSize)));
-        if (upload.fileType)
-          console.log(label("Type", upload.fileType));
+        console.log(label("Size", fmtBytes(file2.size)));
+        console.log(label("Type", uploadedType));
         if (d.job_id) {
           console.log(label("RAG job", d.job_id));
           console.log(dim("Processing runs in the background. Use `amiko drive status <id>` to check."));
@@ -30195,9 +30938,15 @@ Search hits filename, title, description, and parsed RAG content (once processed
           console.log(label("Folder", d.doc.folder_id));
         if (d.doc.description)
           console.log(label("Description", d.doc.description));
-        console.log(label("Status", statusOf2(d.doc)));
+        console.log(label("Status", statusOf3(d.doc)));
         if (d.doc.metadata?.error)
           console.log(label("Error", d.doc.metadata.error));
+        if (d.doc.is_public && d.doc.public_slug) {
+          console.log(label("Public", "yes"));
+          console.log(label("Share URL", fileShareUrl(auth, d.doc.public_slug)));
+        } else {
+          console.log(label("Public", "no"));
+        }
         console.log(label("Signed URL", d.signed_url));
         if (opts.content && d.doc.content) {
           console.log(heading(`
@@ -30259,6 +31008,40 @@ Parsed content available (${d.doc.content.length} chars). Pass --content to prin
       process.exit(1);
     }
   });
+  program2.command("share <docId>").description("Make a file public and print its share link").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: `Make file ${docId} PUBLIC`,
+      detail: "Anyone with the link can view and download it — no Amiko login required. The link stays stable across unshare/re-share.",
+      yes: opts.yes,
+      commandExample: `amiko drive share ${docId}`
+    });
+    try {
+      const result = await amikoWebFetch(auth, `/api/agents/${twinId}/docs/${docId}`, { method: "PATCH", body: { isPublic: true } });
+      renderOutput(result, (r) => {
+        console.log(success(`${r.doc.title || r.doc.filename} is now public`));
+        if (r.doc.public_slug)
+          console.log(label("Share URL", fileShareUrl(auth, r.doc.public_slug)));
+        console.log(dim("Revoke anytime: amiko drive unshare " + docId));
+      }, { json: opts.json });
+    } catch (e5) {
+      console.error(error(e5 instanceof Error ? e5.message : String(e5)));
+      process.exit(1);
+    }
+  });
+  program2.command("unshare <docId>").description("Revoke a file's public share link").option("--twin <idOrName>", "Target twin id or name").option("--json", "Output as JSON").action(async (docId, opts) => {
+    const { twinId, auth } = twinFromFlag(opts);
+    try {
+      const result = await amikoWebFetch(auth, `/api/agents/${twinId}/docs/${docId}`, { method: "PATCH", body: { isPublic: false } });
+      renderOutput(result, (r) => {
+        console.log(success(`${r.doc.title || r.doc.filename} is private again`));
+        console.log(dim("The link no longer works. Re-sharing later restores the SAME link. Note: the file stays reachable if a parent folder is still shared."));
+      }, { json: opts.json });
+    } catch (e5) {
+      console.error(error(e5 instanceof Error ? e5.message : String(e5)));
+      process.exit(1);
+    }
+  });
   program2.command("presign <name>").description("Get a presigned upload URL (browser-direct uploads; no upload performed)").option("--twin <idOrName>", "Target twin id or name").option("--json", "Output as JSON").action(async (name, opts) => {
     const { twinId, auth } = twinFromFlag(opts);
     try {
@@ -30300,11 +31083,12 @@ Parsed content available (${d.doc.content.length} chars). Pass --content to prin
         }
         console.log(heading(`Folders (${d.folders.length})`));
         const rows = [
-          [dim("ID"), dim("NAME"), dim("PARENT"), dim("CREATED")],
+          [dim("ID"), dim("NAME"), dim("PARENT"), dim("PUBLIC"), dim("CREATED")],
           ...d.folders.map((f) => [
             f.id,
             f.name,
             f.parent_id || dim("root"),
+            f.is_public ? "yes" : dim("-"),
             f.created_at?.slice(0, 10) || "-"
           ])
         ];
@@ -30353,6 +31137,40 @@ Parsed content available (${d.doc.content.length} chars). Pass --content to prin
       process.exit(1);
     }
   });
+  folder.command("share <folderId>").description("Make a folder public (shares its ENTIRE subtree) and print the link").option("--twin <idOrName>", "Target twin id or name").option("--yes", "Skip confirmation").option("--json", "Output as JSON").action(async (folderId, opts) => {
+    const { twinId, auth } = twinFromFlag(opts);
+    await confirmDestructive({
+      action: `Make folder ${folderId} PUBLIC`,
+      detail: "Anyone with the link can browse and download EVERY file and subfolder inside it — no Amiko login required. Files added later are exposed too.",
+      yes: opts.yes,
+      commandExample: `amiko drive folder share ${folderId}`
+    });
+    try {
+      const result = await amikoWebFetch(auth, `/api/agents/${twinId}/docs/folders/${folderId}`, { method: "PATCH", body: { isPublic: true } });
+      renderOutput(result, (r) => {
+        console.log(success(`Folder "${r.folder.name}" is now public`));
+        if (r.folder.public_slug)
+          console.log(label("Share URL", folderShareUrl(auth, r.folder.public_slug)));
+        console.log(dim("Revoke anytime: amiko drive folder unshare " + folderId));
+      }, { json: opts.json });
+    } catch (e5) {
+      console.error(error(e5 instanceof Error ? e5.message : String(e5)));
+      process.exit(1);
+    }
+  });
+  folder.command("unshare <folderId>").description("Revoke a folder's public share link (instantly unshares the subtree)").option("--twin <idOrName>", "Target twin id or name").option("--json", "Output as JSON").action(async (folderId, opts) => {
+    const { twinId, auth } = twinFromFlag(opts);
+    try {
+      const result = await amikoWebFetch(auth, `/api/agents/${twinId}/docs/folders/${folderId}`, { method: "PATCH", body: { isPublic: false } });
+      renderOutput(result, (r) => {
+        console.log(success(`Folder "${r.folder.name}" is private again`));
+        console.log(dim("The link no longer works and the whole subtree is unshared (unless an ancestor folder or individual file is still public). Re-sharing restores the SAME link."));
+      }, { json: opts.json });
+    } catch (e5) {
+      console.error(error(e5 instanceof Error ? e5.message : String(e5)));
+      process.exit(1);
+    }
+  });
   folder.command("delete <folderId>").description("Delete a folder (use --force to delete non-empty folders + their contents)").option("--twin <idOrName>", "Target twin id or name").option("--force", "Recursively delete subfolders and files in the subtree").option("--yes", "Skip confirmation").option("--json", "Output as JSON").action(async (folderId, opts) => {
     const { twinId, auth } = twinFromFlag(opts);
     await confirmDestructive({
@@ -32186,10 +33004,10 @@ var didOnboard = await runOnboarding(process.argv);
 if (didOnboard)
   process.exit(0);
 var program2 = new Command;
-program2.name("amiko").description("Amiko CLI — swap tokens, manage credits, bridge cross-chain, and call marketplace services").version(PKG_VERSION);
+program2.name("amiko").description("Amiko CLI — Create Studio media generation, chats, drive, credits & wallets, social graph, and paid MPP marketplace services").version(PKG_VERSION);
 var markets = program2.command("markets").description("MPP marketplace — discover and call paid AMIKO services");
 var create2 = program2.command("create").description("Create Studio — generate images, video, speech, music, and SFX (charged on success)");
-var chat = program2.command("chat").description("Your conversations (DMs + group chats) as the owner — list, read, send");
+var chat = program2.command("chat").description("Your conversations (DMs + group chats) as the owner — list, read, send, manage groups");
 var card = program2.command("card").description("Twin Cards (work/play/love) — generate, view, download, mint");
 var wallets = program2.command("wallets").description("Manage twin wallets — list, swap, bridge");
 var twin = program2.command("twin").description("Update twin identity (name, description, visibility)");