@heyamiko/amiko-cli 0.14.0-beta.8 → 0.14.1

package/dist/index.js

@@ -25861,27 +25861,50 @@ function readFromFile(path) {
       twinId: asString(parsed.amikoTwinId) ?? asString(parsed.AMIKO_TWIN_ID),
       userId: asString(parsed.amikoUserId) ?? asString(parsed.AMIKO_USER_ID),
       platformUrl: asString(parsed.amikoPlatformUrl) ?? asString(parsed.AMIKO_PLATFORM_URL),
-      apiBase: asString(parsed.amikoApiBase) ?? asString(parsed.AMIKO_API_BASE) ?? asString(parsed.apiBase)
+      apiBase: asString(parsed.amikoApiBase) ?? asString(parsed.AMIKO_API_BASE) ?? asString(parsed.apiBase),
+      billingApiKey: asString(parsed.amikoApiKey) ?? asString(parsed.AMIKO_API_KEY) ?? asString(parsed.billingApiKey),
+      billingUrl: asString(parsed.amikoBillingUrl) ?? asString(parsed.AMIKO_BILLING_URL) ?? asString(parsed.billingUrl)
     };
   } catch {
     return null;
   }
 }
+function readRoutingIdsFromEnv() {
+  return {
+    agentId: asString(process.env.OPENHERMIT_AGENT_ID),
+    sessionId: asString(process.env.OPENHERMIT_SESSION_ID)
+  };
+}
 function readFromEnv() {
   return {
     twinToken: asString(process.env.AMIKO_TWIN_TOKEN) ?? asString(process.env.AMIKO_USER_TOKEN),
     twinId: asString(process.env.AMIKO_TWIN_ID),
     userId: asString(process.env.AMIKO_USER_ID),
     platformUrl: asString(process.env.AMIKO_PLATFORM_URL),
-    apiBase: asString(process.env.AMIKO_API_BASE)
+    apiBase: asString(process.env.AMIKO_API_BASE),
+    billingApiKey: asString(process.env.AMIKO_API_KEY),
+    billingUrl: asString(process.env.AMIKO_BILLING_URL),
+    ...readRoutingIdsFromEnv()
+  };
+}
+function resolveFileAuth(path) {
+  const fromFile = readFromFile(path);
+  if (!fromFile)
+    return null;
+  const fromEnv = readFromEnv();
+  return {
+    ...fromFile,
+    ...readRoutingIdsFromEnv(),
+    billingApiKey: fromEnv.billingApiKey ?? fromFile.billingApiKey,
+    billingUrl: fromEnv.billingUrl ?? fromFile.billingUrl
   };
 }
 function resolveAuth() {
   const filePath = findAmikoJsonPath();
   if (filePath) {
-    const fromFile = readFromFile(filePath);
-    if (fromFile)
-      return fromFile;
+    const merged = resolveFileAuth(filePath);
+    if (merged)
+      return merged;
   }
   return readFromEnv();
 }
@@ -27611,7 +27634,31 @@ function registerBridgeCommand(program2) {
 import readline2 from "node:readline";
 
 // src/lib/balance.ts
-async function fetchCreditsBalance(auth) {
+var DEFAULT_BILLING_URL = "https://billing.heyamiko.com";
+function billingBase(auth) {
+  const url = auth.billingUrl || DEFAULT_BILLING_URL;
+  return url.replace(/\/$/, "");
+}
+async function fetchCreditsBalanceViaAmk(auth) {
+  const apiKey = auth.billingApiKey;
+  if (!apiKey || !apiKey.startsWith("amk_"))
+    return null;
+  try {
+    const res = await fetch(`${billingBase(auth)}/api/credits`, {
+      method: "GET",
+      headers: { Authorization: `Bearer ${apiKey}` },
+      signal: AbortSignal.timeout(15000)
+    });
+    if (!res.ok)
+      return null;
+    const data = await res.json();
+    const raw = data.displayBalance;
+    return typeof raw === "number" && isFinite(raw) ? Math.round(raw) : null;
+  } catch {
+    return null;
+  }
+}
+async function fetchCreditsBalanceViaPlatformProxy(auth) {
   if (!auth.twinToken)
     return null;
   try {
@@ -27622,6 +27669,12 @@ async function fetchCreditsBalance(auth) {
     return null;
   }
 }
+async function fetchCreditsBalance(auth) {
+  const viaAmk = await fetchCreditsBalanceViaAmk(auth);
+  if (viaAmk != null)
+    return viaAmk;
+  return fetchCreditsBalanceViaPlatformProxy(auth);
+}
 async function printBalanceRemaining(auth) {
   const balance = await fetchCreditsBalance(auth);
   if (balance == null) {
@@ -28473,7 +28526,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 (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) => {
+  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);
@@ -28637,6 +28690,7 @@ function registerImageCommand(program2) {
 }
 
 // src/commands/create.ts
+import { randomUUID } from "node:crypto";
 var ETA = {
   IMAGE: "~15–60s",
   VIDEO: "~2–9 min",
@@ -28647,6 +28701,13 @@ var ETA = {
 function statusOf(err) {
   return err?.status;
 }
+function autoApproveLimit() {
+  const raw = process.env.AMIKO_AUTO_APPROVE_LIMIT;
+  if (typeof raw !== "string" || raw.trim() === "")
+    return;
+  const limit = Number(raw);
+  return Number.isFinite(limit) ? limit : undefined;
+}
 function collectOption(value, previous) {
   return [...previous ?? [], value];
 }
@@ -28656,7 +28717,7 @@ function assertMaxUrls(resourceName, urls, max) {
     process.exit(1);
   }
 }
-function printCompleted(final, title) {
+function printCompleted(final, title, deliveredToThisSession = false) {
   console.log(heading(`${title}
 `));
   if (final.prompt)
@@ -28665,6 +28726,9 @@ function printCompleted(final, title) {
     console.log(label("URL", final.assetUrl));
   if (final.assetMime)
     console.log(label("Type", final.assetMime));
+  if (deliveredToThisSession) {
+    console.log(success("Already delivered to the user in this chat automatically. Do NOT send this file again and do NOT paste the URL — you would duplicate it."));
+  }
   console.log("");
   if (final.charged) {
     const amt = final.chargeAmount ?? final.costAmiko ?? "?";
@@ -28673,6 +28737,9 @@ function printCompleted(final, title) {
   } else {
     console.log(dim("Not charged (settlement pending or waived)."));
   }
+  if (final.driveDocId) {
+    console.log(label("Saved to drive", final.driveDocId) + dim("  (amiko drive get " + final.driveDocId + ")"));
+  }
   console.log(dim("View in your media space: https://platform.heyamiko.com/media"));
 }
 async function submitCreateJob(opts) {
@@ -28683,7 +28750,17 @@ async function submitCreateJob(opts) {
     console.error(error(e5 instanceof Error ? e5.message : "auth failed"));
     process.exit(1);
   }
-  let costLine = "charged from your twin wallet on success (nothing on failure)";
+  const payMethod = (opts.pay ?? "credits").toLowerCase();
+  if (payMethod !== "wallet" && payMethod !== "credits") {
+    console.error(error(`Unknown --pay "${opts.pay}". Allowed: wallet, credits.`));
+    process.exit(1);
+  }
+  const payCredits = payMethod === "credits";
+  if (payCredits && opts.jobBody.preferredToken) {
+    console.error(dim("--token is ignored with --pay credits (credits come from your Amiko account, not a wallet token)."));
+  }
+  let costLine = payCredits ? "reserved from your Amiko account credits, captured on success (released on failure)" : "charged from your twin wallet on success (nothing on failure)";
+  let quotedCostAmiko;
   try {
     const q = await amikoWebFetch(auth, "/api/create/quote", {
       method: "POST",
@@ -28691,13 +28768,32 @@ async function submitCreateJob(opts) {
       timeoutMs: 15000
     });
     if (q.cost_usd != null) {
-      costLine = `${q.cost_amiko ?? "?"} AMIKO (≈ $${q.cost_usd.toFixed(4)}) — charged only on success`;
+      costLine = payCredits ? `≈ ${Math.ceil(q.cost_usd * 1e4)} Amiko credits (≈ $${q.cost_usd.toFixed(4)}) — reserved on submit, captured only on success` : `${q.cost_amiko ?? "?"} AMIKO (≈ $${q.cost_usd.toFixed(4)}) — charged only on success`;
+    }
+    if (typeof q.cost_amiko === "string" && q.cost_amiko.trim() !== "") {
+      const n = Number(q.cost_amiko);
+      if (Number.isFinite(n))
+        quotedCostAmiko = n;
     }
   } catch {}
+  const preferredToken = typeof opts.jobBody.preferredToken === "string" ? opts.jobBody.preferredToken.toUpperCase() : undefined;
+  const chargeIsAmiko = !payCredits && (preferredToken === undefined || preferredToken === "AMIKO");
+  const autoApprovable = payCredits || chargeIsAmiko;
+  const effectiveChargeToken = preferredToken ?? "AMIKO";
+  let yes = opts.yes;
+  let autoApproved = false;
+  if (!yes) {
+    const limit = autoApproveLimit();
+    if (limit !== undefined && quotedCostAmiko !== undefined && quotedCostAmiko > 0 && autoApprovable && quotedCostAmiko <= limit) {
+      yes = true;
+      autoApproved = true;
+      console.log(dim(`Auto-approved (cost ${quotedCostAmiko} ≤ limit ${limit} AMIKO${payCredits ? ", charged as account credits" : ""})`));
+    }
+  }
   await requireApproval({
     cost: costLine,
     summary: opts.summary,
-    yes: opts.yes,
+    yes,
     commandExample: `amiko create ${opts.mode.toLowerCase()} ...`
   });
   const isTTY = process.stderr.isTTY;
@@ -28707,10 +28803,22 @@ async function submitCreateJob(opts) {
       spinner.stop();
   };
   let jobId;
+  let routedAgentId;
+  let routedSessionId;
   try {
     const submit = await amikoWebFetch(auth, "/api/create/jobs", {
       method: "POST",
-      body: { ...opts.jobBody, twinId: auth.twinId },
+      body: {
+        ...opts.jobBody,
+        twinId: auth.twinId,
+        ...autoApproved && !payCredits ? { preferredToken: effectiveChargeToken, strictToken: true } : {},
+        ...payCredits ? {
+          paymentMethod: { kind: "account_credits" },
+          requestId: randomUUID()
+        } : {},
+        ...auth.agentId ? { agentId: auth.agentId } : {},
+        ...auth.sessionId ? { sessionId: auth.sessionId } : {}
+      },
       timeoutMs: 30000
     });
     if (!submit.jobId) {
@@ -28719,35 +28827,58 @@ async function submitCreateJob(opts) {
       process.exit(1);
     }
     jobId = submit.jobId;
+    routedAgentId = submit.agentId;
+    routedSessionId = submit.sessionId;
   } catch (e5) {
     stop();
-    console.error(error(e5 instanceof Error ? e5.message : "Submit failed"));
+    const webErr = e5;
+    let message = e5 instanceof Error ? e5.message : "Submit failed";
+    let errorCode;
+    if (typeof webErr.body === "string" && webErr.body) {
+      try {
+        const parsed = JSON.parse(webErr.body);
+        if (parsed.error)
+          message = parsed.error;
+        if (typeof parsed.code === "string")
+          errorCode = parsed.code;
+      } catch {}
+    }
+    console.error(error(message));
+    if (payCredits && (errorCode === "ACCOUNT_CREDITS_DISABLED" || errorCode === "ACCOUNT_NOT_UNIFIED")) {
+      console.error(dim("Account credits are not available for this account yet — retry without --pay credits to charge the twin wallet."));
+    }
     process.exit(1);
   }
+  const sessionRouted = !!(routedAgentId && routedSessionId);
   stop();
   if (opts.raw) {
     console.log(JSON.stringify({
       jobId,
       status: "PENDING",
       check: `amiko create status ${jobId}`,
-      eta: ETA[opts.mode]
+      eta: ETA[opts.mode],
+      ...sessionRouted ? { sessionRouted: true, deliveredToSession: routedSessionId } : {}
     }, null, 2));
     return;
   }
   console.log(success(`Submitted — job ${jobId}`));
   console.log(label("Status", "PENDING — generating in the background"));
   console.log(label("Check result", `amiko create status ${jobId}`));
+  if (sessionRouted) {
+    console.log(dim("A generating-placeholder is already showing in the chat and the finished media will be delivered there automatically — do not send the file or URL yourself."));
+  }
   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: 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) => {
+  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("--pay <method>", "Payment method: credits (Amiko account credits, default) or wallet (twin wallet)", "credits").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 ? "…" : ""}`,
       raw: opts.raw,
+      pay: opts.pay,
       yes: opts.yes,
       quoteBody: { mode: "IMAGE", model: opts.model, size: opts.aspect },
       jobBody: {
@@ -28759,7 +28890,7 @@ 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("--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) => {
+  create2.command("video <prompt>").description("Generate a video (Create Studio)").option("--model <model>", "Video model: MiniMax-Hailuo-02 (default for prompt-only; T2V+I2V), MiniMax-Hailuo-2.3-Fast (default with --first-frame; I2V only), MiniMax-Hailuo-2.3 (T2V+I2V), veo-3.1[-fast|-lite]-generate-preview (Google; durations clamp to 4/6/8s), grok-imagine-video (xAI), dreamina-seedance-* (BytePlus). ONLY these — kling and other ids are not supported").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("--pay <method>", "Payment method: credits (Amiko account credits, default) or wallet (twin wallet)", "credits").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."));
@@ -28772,21 +28903,24 @@ function registerCreateCommand(create2) {
     assertMaxUrls("--reference-video", referenceVideoUrls, 3);
     assertMaxUrls("--reference-audio", referenceAudioUrls, 3);
     const generateAudio = opts.generateAudio;
+    const model = opts.model ?? (opts.firstFrame ? "MiniMax-Hailuo-2.3-Fast" : "MiniMax-Hailuo-02");
     await submitCreateJob({
       mode: "VIDEO",
       summary: `Create video: ${prompt.slice(0, 80)}${prompt.length > 80 ? "…" : ""}`,
       raw: opts.raw,
+      pay: opts.pay,
       yes: opts.yes,
       quoteBody: {
         mode: "VIDEO",
-        model: opts.model,
+        model,
         size: opts.resolution,
-        seconds
+        seconds,
+        ...referenceVideoUrls.length ? { referenceVideoUrls } : {}
       },
       jobBody: {
         mode: "VIDEO",
         prompt,
-        model: opts.model,
+        model,
         resolution: opts.resolution,
         seconds,
         ...opts.aspect ? { aspectRatio: opts.aspect } : {},
@@ -28808,23 +28942,59 @@ function registerCreateCommand(create2) {
       }
     });
   });
-  create2.command("tts <text>").description("Generate speech from text (Create Studio)").option("--model <model>", "TTS model id", "eleven_multilingual_v2").option("--voice <voiceId>", "Voice id", "21m00Tcm4TlvDq8ikWAM").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 (text, opts) => {
+  const DEFAULT_EL_TTS_MODEL = "eleven_multilingual_v2";
+  const DEFAULT_EL_TTS_VOICE = "21m00Tcm4TlvDq8ikWAM";
+  const DEFAULT_MM_TTS_MODEL = "speech-2.8-turbo";
+  const DEFAULT_MM_TTS_VOICE = "English_expressive_narrator";
+  const MINIMAX_TTS_MODELS = new Set([
+    "speech-2.8-turbo",
+    "speech-2.8-hd",
+    "speech-2.6-turbo",
+    "speech-2.6-hd"
+  ]);
+  create2.command("tts <text>").description("Generate speech from text (Create Studio)").option("--provider <name>", "TTS provider: minimax | elevenlabs (sets defaults when --model/--voice omitted)").option("--model <model>", `TTS model id (MiniMax: speech-2.8-turbo|hd, speech-2.6-turbo|hd; ElevenLabs: eleven_*)`).option("--voice <voiceId>", "Voice id (MiniMax system e.g. English_expressive_narrator, or a cloned voice_id; ElevenLabs voice hash)").option("--token <symbol>", "Preferred charge token: AMIKO, USDC, USDT, SOL").option("--pay <method>", "Payment method: credits (Amiko account credits, default) or wallet (twin wallet)", "credits").option("--raw", "Output raw JSON").option("--yes", "Skip the pre-spend confirmation (required in non-interactive shells)").action(async (text, opts) => {
+    const providerRaw = typeof opts.provider === "string" ? opts.provider.trim().toLowerCase() : "";
+    if (providerRaw && providerRaw !== "minimax" && providerRaw !== "elevenlabs") {
+      console.error(error("--provider must be minimax or elevenlabs"));
+      process.exit(1);
+    }
+    let model = typeof opts.model === "string" && opts.model.trim().length > 0 ? opts.model.trim() : undefined;
+    let voice = typeof opts.voice === "string" && opts.voice.trim().length > 0 ? opts.voice.trim() : undefined;
+    let provider = providerRaw === "minimax" || providerRaw === "elevenlabs" ? providerRaw : model && MINIMAX_TTS_MODELS.has(model) ? "minimax" : model && model.startsWith("eleven") ? "elevenlabs" : "elevenlabs";
+    if (!model) {
+      model = provider === "minimax" ? DEFAULT_MM_TTS_MODEL : DEFAULT_EL_TTS_MODEL;
+    }
+    if (!voice) {
+      voice = provider === "minimax" ? DEFAULT_MM_TTS_VOICE : DEFAULT_EL_TTS_VOICE;
+    }
+    if (MINIMAX_TTS_MODELS.has(model) && providerRaw !== "elevenlabs") {
+      provider = "minimax";
+    }
+    if (provider === "minimax" && !MINIMAX_TTS_MODELS.has(model)) {
+      console.error(error(`--provider minimax requires a MiniMax speech model (${[...MINIMAX_TTS_MODELS].join(", ")})`));
+      process.exit(1);
+    }
+    if (provider === "elevenlabs" && !model.startsWith("eleven")) {
+      console.error(error("--provider elevenlabs requires an eleven_* model"));
+      process.exit(1);
+    }
     await submitCreateJob({
       mode: "TTS",
-      summary: `Create speech: ${text.slice(0, 80)}${text.length > 80 ? "…" : ""}`,
+      summary: `Create speech (${provider}/${model}): ${text.slice(0, 80)}${text.length > 80 ? "…" : ""}`,
       raw: opts.raw,
+      pay: opts.pay,
       yes: opts.yes,
-      quoteBody: { mode: "TTS", model: opts.model, prompt: text },
+      quoteBody: { mode: "TTS", model, prompt: text, voiceId: voice },
       jobBody: {
         mode: "TTS",
         prompt: text,
-        model: opts.model,
-        voiceId: opts.voice,
+        model,
+        voiceId: voice,
         ...opts.token ? { preferredToken: opts.token } : {}
       }
     });
   });
-  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("--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) => {
+  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("--pay <method>", "Payment method: credits (Amiko account credits, default) or wallet (twin wallet)", "credits").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);
@@ -28833,6 +29003,7 @@ function registerCreateCommand(create2) {
       mode: "MUSIC",
       summary: `Create music: ${(prompt ?? opts.lyrics ?? "").slice(0, 80)}`,
       raw: opts.raw,
+      pay: opts.pay,
       yes: opts.yes,
       quoteBody: { mode: "MUSIC", model: opts.model },
       jobBody: {
@@ -28847,11 +29018,12 @@ function registerCreateCommand(create2) {
       }
     });
   });
-  create2.command("sfx <text>").description("Generate a sound effect (Create Studio)").option("--duration <seconds>", "Clip length in seconds").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 (text, opts) => {
+  create2.command("sfx <text>").description("Generate a sound effect (Create Studio)").option("--duration <seconds>", "Clip length in seconds").option("--token <symbol>", "Preferred charge token: AMIKO, USDC, USDT, SOL").option("--pay <method>", "Payment method: credits (Amiko account credits, default) or wallet (twin wallet)", "credits").option("--raw", "Output raw JSON").option("--yes", "Skip the pre-spend confirmation (required in non-interactive shells)").action(async (text, opts) => {
     await submitCreateJob({
       mode: "SFX",
       summary: `Create SFX: ${text.slice(0, 80)}${text.length > 80 ? "…" : ""}`,
       raw: opts.raw,
+      pay: opts.pay,
       yes: opts.yes,
       quoteBody: { mode: "SFX" },
       jobBody: {
@@ -28881,8 +29053,9 @@ function registerCreateCommand(create2) {
       }
       process.exit(1);
     }
+    const deliveredToThisSession = !!(p.agentId && p.sessionId && auth.sessionId && p.sessionId === auth.sessionId);
     if (opts.raw) {
-      console.log(JSON.stringify(p, null, 2));
+      console.log(JSON.stringify(deliveredToThisSession ? { ...p, sessionRouted: true, deliveredToSession: p.sessionId } : p, null, 2));
       return;
     }
     if (p.status === "FAILED") {
@@ -28894,7 +29067,7 @@ function registerCreateCommand(create2) {
       console.log(dim(`Job id: ${jobId}`));
       return;
     }
-    printCompleted(p, "Job complete");
+    printCompleted(p, "Job complete", deliveredToThisSession);
   });
   create2.command("media").description("List your recent Create Studio generations").option("--limit <n>", "How many to show (max 50)", "20").option("--service <type>", "Filter by type: image, video, tts, music, sfx").option("--raw", "Output raw JSON").action(async (opts) => {
     let auth;
@@ -28948,41 +29121,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 {
@@ -28991,12 +29165,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 {
@@ -29027,6 +29201,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) {
@@ -29220,6 +29401,170 @@ async function resolveGroup(auth, target) {
   }
   return fetchConversationById(auth, matches[0].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 (!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
+    });
+    if (!prof.user?.id)
+      throw new Error(`No user @${handle}.`);
+    return person({ ...prof.user, id: prof.user.id });
+  }
+  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)}"`,
+          conversation: conv
+        };
+      } catch (e5) {
+        const status = e5.status;
+        if (status === 403) {
+          throw new Error(`Conversation ${t} exists but you are not a participant.`);
+        }
+        if (status !== undefined && 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);
+  }
+  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}`);
+  }
+  const p = resolved[0];
+  return person({ id: p.userId, name: p.name, handle: p.handle });
+}
+
+// src/lib/mentions.ts
+var MENTION_ALL_TOKEN = "@[all](all:all)";
+var MENTION_ALL_LITERAL_SRC = String.raw`(^|[^\w@])@all\b`;
+function hasMentionAllToken(content) {
+  return content.includes(MENTION_ALL_TOKEN);
+}
+function hasMentionAllLiteral(content) {
+  return new RegExp(MENTION_ALL_LITERAL_SRC, "i").test(content);
+}
+function rewriteMentionAllLiteral(content) {
+  return content.replace(new RegExp(MENTION_ALL_LITERAL_SRC, "gi"), `$1${MENTION_ALL_TOKEN}`);
+}
+function applyMentionAll(content) {
+  if (hasMentionAllToken(content))
+    return content;
+  return content ? `${MENTION_ALL_TOKEN} ${content}` : MENTION_ALL_TOKEN;
+}
+function mentionMarkupToPlainText(content) {
+  return content.replace(/@\[([^\]]+)\]\(([^:()\s]+):(user|agent|all)\)/g, "@$1");
+}
+function canMentionAll(conv, selfUserId) {
+  if (conv.conversation_type !== "group" || !selfUserId)
+    return false;
+  const me = normalizeUserId(selfUserId);
+  const self = (conv.participants ?? []).find((p) => p.participant_type === "user" && normalizeUserId(p.participant_id) === me && !p.left_at);
+  if (!self)
+    return false;
+  return self.role === "admin" || self.role === "owner" || conv.allow_everyone_mention_all === true;
+}
+
+// src/lib/reactions.ts
+var EMOJI_MAX = 32;
+function validateEmoji(raw) {
+  const emoji3 = (raw ?? "").trim();
+  if (!emoji3)
+    throw new Error("No emoji given. Pass the emoji to react with, e.g. ❤️.");
+  if (emoji3.length > EMOJI_MAX) {
+    throw new Error(`Emoji is too long (max ${EMOJI_MAX} characters).`);
+  }
+  return emoji3;
+}
+async function fetchMessage(auth, messageId) {
+  const data = await amikoWebFetch(auth, `/api/messages/${encodeURIComponent(messageId)}`, { timeoutMs: 20000 });
+  if (!data.message?.id) {
+    throw new Error(`Message ${messageId} not found.`);
+  }
+  return { ...data.message, reactions: data.message.reactions ?? [] };
+}
+function ownReaction(reactions, userId) {
+  if (!userId)
+    return null;
+  const me = normalizeUserId(userId);
+  const mine = reactions.find((r) => normalizeUserId(r.user_id) === me);
+  return mine?.emoji ?? null;
+}
+function previewText(msg, max = 60) {
+  const content = (msg.content ?? "").trim();
+  if (content) {
+    return content.length > max ? `${content.slice(0, max)}…` : content;
+  }
+  if (msg.message_type === "voice")
+    return "[voice message]";
+  if (msg.metadata?.images?.length)
+    return "[image]";
+  return `[${msg.message_type || "message"}]`;
+}
+function groupReactions(reactions) {
+  const counts = new Map;
+  for (const r of reactions) {
+    counts.set(r.emoji, (counts.get(r.emoji) ?? 0) + 1);
+  }
+  return Array.from(counts.entries());
+}
+function summarizeReactions(reactions) {
+  return groupReactions(reactions).map(([emoji3, count]) => `${emoji3}×${count}`).join(" ");
+}
 
 // src/commands/chat-group.ts
 var collect = (v, prev) => [...prev, v];
@@ -29359,7 +29704,7 @@ function registerChatGroupCommand(group) {
         g.id,
         String(g.participants?.length ?? "-"),
         g.unread_count ? String(g.unread_count) : "-",
-        g.last_message?.content?.slice(0, 40) ?? "-"
+        g.last_message?.content ? mentionMarkupToPlainText(g.last_message.content).slice(0, 40) : "-"
       ])
     ];
     console.log(table(rows));
@@ -29376,6 +29721,7 @@ function registerChatGroupCommand(group) {
     console.log(heading(conv.title ?? "(untitled group)"));
     console.log(label("ID", conv.id));
     console.log(label("Members", String(active.length)));
+    console.log(label("@all mentions", conv.allow_everyone_mention_all ? "everyone" : "admins only"));
     console.log("");
     const rows = [
       [dim("NAME"), dim("HANDLE"), dim("USER ID"), dim("TYPE"), dim("ROLE")],
@@ -29581,111 +29927,461 @@ function registerChatGroupCommand(group) {
     }
     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",
-    body: {
-      participant_ids: [userId],
-      participant_types: ["user"],
-      conversation_type: "direct"
-    },
-    timeoutMs: 20000
+  group.command("mention-all <group> <state>").description("Allow everyone (on) or only admins (off, the default) to use @all in a group (admins only)").option("--yes", "Skip the confirmation (required in non-interactive shells)").option("--raw", "Output raw JSON").action(async (target, stateArg, opts) => {
+    const state = stateArg.trim().toLowerCase();
+    if (state !== "on" && state !== "off") {
+      console.error(error(`Pass "on" or "off" (got "${stateArg}"): on lets every member use @all, off restricts it to admins.`));
+      process.exit(1);
+    }
+    const enable = state === "on";
+    const auth = authOrExit();
+    const conv = await resolveGroupOrExit(auth, target);
+    await confirmDestructive({
+      action: enable ? `Allow EVERYONE in "${conv.title ?? conv.id}" to use @all (notifies every member)` : `Restrict @all in "${conv.title ?? conv.id}" to group admins only`,
+      yes: opts.yes,
+      commandExample: `amiko chat group mention-all ${JSON.stringify(target)} ${state}`
+    });
+    let data;
+    try {
+      data = await amikoWebFetch(auth, `/api/conversations/${encodeURIComponent(conv.id)}/mention-all-permission`, {
+        method: "PATCH",
+        body: { allow_everyone_mention_all: enable },
+        timeoutMs: 20000
+      });
+    } catch (e5) {
+      if (statusOf2(e5) === 403) {
+        console.error(error(`Changing the @all setting failed. ${ADMIN_TIP}`));
+        process.exit(1);
+      }
+      exitWithError(e5, "Failed to update the @all setting");
+    }
+    if (opts.raw) {
+      console.log(JSON.stringify(data, null, 2));
+      return;
+    }
+    const now = data.conversation?.allow_everyone_mention_all ?? enable;
+    console.log(success(`@all in "${conv.title ?? conv.id}": ${now ? "everyone can use it" : "admins only"}`) + dim(` (${conv.id})`));
   });
-  const id = data.conversation?.id;
-  if (!id)
-    throw new Error("Could not open a conversation with that user.");
-  return id;
 }
-async function fetchUserById(auth, id) {
+
+// src/lib/gifs.ts
+function parseUrl(url2) {
   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;
+    return new URL(url2);
+  } catch {
+    return null;
   }
 }
-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 isKlipyMediaUrl(url2) {
+  const parsed = parseUrl(url2);
+  if (!parsed)
+    return false;
+  return parsed.hostname === "klipy.com" || parsed.hostname.endsWith(".klipy.com");
 }
-function personLabel(u) {
-  const name = u.name ?? u.id;
-  return u.handle ? `${name} (@${u.handle})` : name;
+var KLIPY_VIDEO_EXTENSION_RE = /\.(?:mp4|webm)(?:[?#].*)?$/i;
+function isKlipyVideoMediaUrl(url2) {
+  if (!isKlipyMediaUrl(url2))
+    return false;
+  const parsed = parseUrl(url2);
+  if (!parsed)
+    return false;
+  return KLIPY_VIDEO_EXTENSION_RE.test(parsed.pathname);
 }
-async function resolveConversation(auth, target) {
-  const t = target.trim();
-  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)}`
+async function searchGifs(auth, q, page = 1) {
+  return amikoWebFetch(auth, "/api/gifs", {
+    query: { q, page }
   });
-  if (t.startsWith("@")) {
-    const handle = t.slice(1);
-    const prof = await amikoWebFetch(auth, `/api/users/${encodeURIComponent(handle)}`, {
-      timeoutMs: 15000
-    });
-    if (!prof.user?.id)
-      throw new Error(`No user @${handle}.`);
-    return person({ ...prof.user, id: prof.user.id });
+}
+function urlBasename(url2) {
+  const last = parseUrl(url2)?.pathname.split("/").pop();
+  if (!last)
+    return "GIF";
+  try {
+    return decodeURIComponent(last);
+  } catch {
+    return last;
   }
-  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.`);
+}
+function gifToMetadata(gif) {
+  return {
+    url: gif.url,
+    name: gif.title || urlBasename(gif.url),
+    contentType: isKlipyVideoMediaUrl(gif.url) ? "video/mp4" : "image/gif",
+    kind: "gif",
+    ...gif.width && gif.height ? { width: gif.width, height: gif.height } : {}
+  };
+}
+
+// src/commands/chat-gifs.ts
+var DEFAULT_LIMIT = 10;
+var MAX_TITLE = 40;
+function clampLimit(raw) {
+  const n = Number.parseInt(raw, 10);
+  if (!Number.isFinite(n))
+    return DEFAULT_LIMIT;
+  return Math.min(24, Math.max(1, n));
+}
+function truncate(text, max) {
+  return text.length > max ? `${text.slice(0, max - 1)}…` : text;
+}
+function registerChatGifsCommand(chat) {
+  chat.command("gifs [query]").description("Search Klipy GIFs (trending when no query) — pass a result URL to `amiko chat send --gif`").option("--page <n>", "Result page (24 per page)", "1").option("--limit <n>", "Max results shown (1-24)", String(DEFAULT_LIMIT)).option("--raw", "Output raw JSON").action(async (query, opts) => {
+    const auth = authOrExit();
+    const q = query?.trim() ?? "";
+    const page = Math.max(1, Number.parseInt(opts.page, 10) || 1);
+    let data;
+    try {
+      data = await searchGifs(auth, q, page);
+    } catch (e5) {
+      console.error(error(e5 instanceof Error ? e5.message : "GIF search failed"));
+      process.exit(1);
+    }
+    renderOutput(data, (d) => {
+      const items = (d.items ?? []).slice(0, clampLimit(opts.limit));
+      if (items.length === 0) {
+        console.log(dim(q ? `No GIFs found for "${q}".` : "No trending GIFs."));
+        console.log(dim("Powered by KLIPY"));
+        return;
+      }
+      console.log(heading(q ? `GIFs matching "${q}" (page ${d.page})` : `Trending GIFs (page ${d.page})`));
+      const rows = [
+        [dim("TITLE"), dim("SIZE"), dim("URL")],
+        ...items.map((gif) => [
+          truncate(gif.title || "GIF", MAX_TITLE),
+          gif.width && gif.height ? `${gif.width}x${gif.height}` : "-",
+          gif.gifUrl
+        ])
+      ];
+      console.log(table(rows));
+      console.log(dim(`
+Send one: amiko chat send <target> --gif <url>${d.hasNext ? `  (more: --page ${d.page + 1})` : ""}`));
+      console.log(dim("Powered by KLIPY"));
+    }, { json: opts.raw });
+  });
+}
+
+// src/commands/chat-lists.ts
+var collect2 = (v, prev) => [...prev, v];
+function exitWithError2(e5, fallback2) {
+  console.error(error(e5 instanceof Error ? e5.message : fallback2));
+  process.exit(1);
+}
+function conversationFlags(tokens) {
+  return tokens.map((t) => ` --conversation ${JSON.stringify(t)}`).join("");
+}
+function countNoun(n) {
+  return `${n} conversation${n === 1 ? "" : "s"}`;
+}
+async function fetchChatLists(auth) {
+  const data = await amikoWebFetch(auth, "/api/chat-lists", { timeoutMs: 20000 });
+  return data.chatLists ?? [];
+}
+async function resolveList(auth, target) {
+  const t = target.trim();
+  if (!t) {
+    throw new Error("No list given. Run `amiko chat lists` and pass a list id or name.");
+  }
+  const all = await fetchChatLists(auth);
+  if (looksLikeConversationId(t)) {
+    const byId = all.find((l) => l.id === t);
+    if (byId)
+      return byId;
+  }
+  const lower = t.toLowerCase();
+  const exact = all.filter((l) => l.name.toLowerCase() === lower);
+  const matches = exact.length ? exact : all.filter((l) => l.name.toLowerCase().includes(lower));
+  if (matches.length === 0) {
+    throw new Error(`No chat list matching "${t}". Run \`amiko chat lists\` to see them.`);
+  }
+  if (matches.length > 1) {
+    const names = matches.map((l) => `"${l.name}" (${l.id})`).join(", ");
+    throw new Error(`"${t}" is ambiguous — matches: ${names}. Use the list's id.`);
+  }
+  return matches[0];
+}
+async function resolveListOrExit(auth, target) {
+  try {
+    return await resolveList(auth, target);
+  } catch (e5) {
+    exitWithError2(e5, "Could not resolve the chat list");
+  }
+}
+async function resolveEntriesOrExit(auth, tokens) {
+  if (tokens.length === 0) {
+    console.error(error("At least one --conversation is required."));
+    process.exit(1);
+  }
+  const entries = [];
+  const failures = [];
+  const seen = new Set;
+  for (const raw of tokens) {
+    try {
+      const resolved = await resolveConversation(auth, raw);
+      let entry;
+      if (resolved.kind === "conversation") {
+        entry = { id: resolved.id, label: resolved.label };
+      } else {
+        const existing = await findDmByUserId(auth, resolved.userId);
+        if (!existing) {
+          throw new Error(`no ${resolved.label} exists yet — a chat list can only hold existing conversations.`);
         }
-        if (status !== 404)
-          throw e5;
+        entry = { id: existing, label: resolved.label };
       }
+      if (seen.has(entry.id))
+        continue;
+      seen.add(entry.id);
+      entries.push(entry);
+    } catch (e5) {
+      failures.push({
+        token: raw,
+        reason: e5 instanceof Error ? e5.message : "could not be resolved"
+      });
     }
-    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\`.`);
+  }
+  if (failures.length > 0) {
+    console.error(error("Could not resolve every conversation — nothing was changed."));
+    for (const entry of entries) {
+      console.error(dim(`  resolved: ${entry.label} → ${entry.id}`));
     }
-    return person(user);
+    for (const f of failures) {
+      console.error(error(`  ${JSON.stringify(f.token)}: ${f.reason}`));
+    }
+    process.exit(1);
   }
-  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 entries;
+}
+async function conversationLabels(auth) {
+  const labels = new Map;
+  try {
+    const data = await amikoWebFetch(auth, "/api/conversations", { query: { limit: 100, archived: "all" }, timeoutMs: 20000 });
+    for (const c of data.conversations ?? []) {
+      labels.set(c.id, convLabel(c, auth.userId));
+    }
+  } catch {}
+  return labels;
+}
+function listNotFound(e5) {
+  return e5.status === 404;
+}
+function registerChatListsCommand(lists) {
+  lists.option("--raw", "Output raw JSON").action(async (opts) => {
+    const auth = authOrExit();
+    let all;
+    try {
+      all = await fetchChatLists(auth);
+    } catch (e5) {
+      exitWithError2(e5, "Failed to load chat lists");
+    }
+    if (opts.raw) {
+      console.log(JSON.stringify({ chatLists: all }, null, 2));
+      return;
+    }
+    if (all.length === 0) {
+      console.log(dim("No chat lists."));
+      console.log(dim("Create one with `amiko chat lists create <name> --conversation <who>`."));
+      return;
+    }
+    const labels = await conversationLabels(auth);
+    console.log(heading(`Chat lists (${all.length})
+`));
+    for (const l of all) {
+      const ids = l.conversation_ids ?? [];
+      console.log(label(l.name, dim(`${l.id}  ·  ${countNoun(ids.length)}`)));
+      for (const id of ids) {
+        const name = labels.get(id);
+        console.log(dim(name ? `  - ${name}  (${id})` : `  - ${id}`));
+      }
+    }
+  });
+  lists.command("create <name>").description("Create a chat list, optionally with initial conversations").option("--conversation <target>", "Conversation to include (conversation id, user id, @handle, group title, or name); repeat per conversation", collect2, []).option("--yes", "Skip the confirmation (required in non-interactive shells)").option("--raw", "Output raw JSON").action(async (name, opts) => {
+    const auth = authOrExit();
+    const entries = opts.conversation.length > 0 ? await resolveEntriesOrExit(auth, opts.conversation) : [];
+    await confirmDestructive({
+      action: `Create chat list "${name}"${entries.length ? ` with ${entries.map((e5) => e5.label).join(", ")}` : " (empty)"}`,
+      detail: "Chat lists are private folders — only you see them, in every Amiko app.",
+      yes: opts.yes,
+      commandExample: `amiko chat lists create ${JSON.stringify(name)}${conversationFlags(opts.conversation)}`
+    });
+    let data;
+    try {
+      data = await amikoWebFetch(auth, "/api/chat-lists", {
+        method: "POST",
+        body: { name, conversation_ids: entries.map((e5) => e5.id) },
+        timeoutMs: 20000
+      });
+    } catch (e5) {
+      exitWithError2(e5, "Failed to create the chat list");
+    }
+    if (opts.raw) {
+      console.log(JSON.stringify(data, null, 2));
+      return;
+    }
+    console.log(success(`Chat list created: ${name}`));
+    if (data.chatList?.id)
+      console.log(label("ID", data.chatList.id));
+    if (entries.length) {
+      console.log(label("Conversations", entries.map((e5) => e5.label).join(", ")));
+    }
+  });
+  lists.command("rename <list> <newName>").description("Rename a chat list (list id or name)").option("--yes", "Skip the confirmation (required in non-interactive shells)").option("--raw", "Output raw JSON").action(async (target, newName, opts) => {
+    const auth = authOrExit();
+    const list = await resolveListOrExit(auth, target);
+    await confirmDestructive({
+      action: `Rename chat list "${list.name}" to "${newName}"`,
+      yes: opts.yes,
+      commandExample: `amiko chat lists rename ${JSON.stringify(target)} ${JSON.stringify(newName)}`
+    });
+    let data;
+    try {
+      data = await amikoWebFetch(auth, `/api/chat-lists/${encodeURIComponent(list.id)}`, { method: "PATCH", body: { name: newName }, timeoutMs: 20000 });
+    } catch (e5) {
+      exitWithError2(e5, "Rename failed");
+    }
+    if (opts.raw) {
+      console.log(JSON.stringify(data, null, 2));
+      return;
+    }
+    console.log(success(`Chat list renamed to: ${newName}`) + dim(` (${list.id})`));
+  });
+  lists.command("add <list>").description("Add conversations to a chat list (list id or name)").option("--conversation <target>", "Conversation to add (conversation id, user id, @handle, group title, or name); repeat per conversation", collect2, []).option("--yes", "Skip the confirmation (required in non-interactive shells)").option("--raw", "Output raw JSON").action(async (target, opts) => {
+    const auth = authOrExit();
+    const entries = await resolveEntriesOrExit(auth, opts.conversation);
+    const list = await resolveListOrExit(auth, target);
+    const current = list.conversation_ids ?? [];
+    const currentSet = new Set(current);
+    const fresh = entries.filter((e5) => !currentSet.has(e5.id));
+    const already = entries.filter((e5) => currentSet.has(e5.id));
+    if (fresh.length === 0) {
+      console.log(dim(`Already in "${list.name}" — nothing to add.`));
+      return;
+    }
+    await confirmDestructive({
+      action: `Add ${fresh.map((e5) => e5.label).join(", ")} to chat list "${list.name}"`,
+      yes: opts.yes,
+      commandExample: `amiko chat lists add ${JSON.stringify(target)}${conversationFlags(opts.conversation)}`
+    });
+    let data;
+    try {
+      data = await amikoWebFetch(auth, `/api/chat-lists/${encodeURIComponent(list.id)}`, {
+        method: "PATCH",
+        body: {
+          conversation_ids: [...current, ...fresh.map((e5) => e5.id)]
+        },
+        timeoutMs: 20000
+      });
+    } catch (e5) {
+      if (listNotFound(e5)) {
+        exitWithError2(null, `Chat list "${list.name}" no longer exists.`);
+      }
+      exitWithError2(e5, "Failed to update the chat list");
+    }
+    if (opts.raw) {
+      console.log(JSON.stringify(data, null, 2));
+      return;
+    }
+    console.log(success(`Added ${fresh.map((e5) => e5.label).join(", ")} to "${list.name}"`) + dim(` (now ${countNoun(current.length + fresh.length)})`));
+    for (const e5 of already) {
+      console.log(dim(`  ${e5.label} was already in the list.`));
+    }
+  });
+  lists.command("remove <list>").description("Remove conversations from a chat list (the conversations themselves are untouched)").option("--conversation <target>", "Conversation to remove (conversation id, user id, @handle, group title, or name); repeat per conversation", collect2, []).option("--yes", "Skip the confirmation (required in non-interactive shells)").option("--raw", "Output raw JSON").action(async (target, opts) => {
+    const auth = authOrExit();
+    const entries = await resolveEntriesOrExit(auth, opts.conversation);
+    const list = await resolveListOrExit(auth, target);
+    const current = list.conversation_ids ?? [];
+    const currentSet = new Set(current);
+    const inList = entries.filter((e5) => currentSet.has(e5.id));
+    const notInList = entries.filter((e5) => !currentSet.has(e5.id));
+    if (inList.length === 0) {
+      console.log(dim(`None of those are in "${list.name}".`));
+      return;
+    }
+    await confirmDestructive({
+      action: `Remove ${inList.map((e5) => e5.label).join(", ")} from chat list "${list.name}"`,
+      yes: opts.yes,
+      commandExample: `amiko chat lists remove ${JSON.stringify(target)}${conversationFlags(opts.conversation)}`
+    });
+    const removeIds = new Set(inList.map((e5) => e5.id));
+    let data;
+    try {
+      data = await amikoWebFetch(auth, `/api/chat-lists/${encodeURIComponent(list.id)}`, {
+        method: "PATCH",
+        body: {
+          conversation_ids: current.filter((id) => !removeIds.has(id))
+        },
+        timeoutMs: 20000
+      });
+    } catch (e5) {
+      if (listNotFound(e5)) {
+        exitWithError2(null, `Chat list "${list.name}" no longer exists.`);
+      }
+      exitWithError2(e5, "Failed to update the chat list");
+    }
+    if (opts.raw) {
+      console.log(JSON.stringify(data, null, 2));
+      return;
+    }
+    console.log(success(`Removed ${inList.map((e5) => e5.label).join(", ")} from "${list.name}"`) + dim(` (now ${countNoun(current.length - inList.length)})`));
+    for (const e5 of notInList) {
+      console.log(dim(`  ${e5.label} was not in the list.`));
+    }
+  });
+  lists.command("delete <list>").description("Delete a chat list (the conversations in it are untouched)").option("--yes", "Skip the confirmation (required in non-interactive shells)").option("--raw", "Output raw JSON").action(async (target, opts) => {
+    const auth = authOrExit();
+    const list = await resolveListOrExit(auth, target);
+    const count = (list.conversation_ids ?? []).length;
+    await confirmDestructive({
+      action: `Delete chat list "${list.name}" (${countNoun(count)})`,
+      detail: "The list's name and membership are gone for good; the conversations themselves are not affected.",
+      yes: opts.yes,
+      commandExample: `amiko chat lists delete ${JSON.stringify(target)}`
+    });
+    let data;
+    try {
+      data = await amikoWebFetch(auth, `/api/chat-lists/${encodeURIComponent(list.id)}`, { method: "DELETE", timeoutMs: 20000 });
+    } catch (e5) {
+      exitWithError2(e5, "Failed to delete the chat list");
+    }
+    if (opts.raw) {
+      console.log(JSON.stringify(data, null, 2));
+      return;
+    }
+    console.log(success(`Chat list deleted: ${list.name}`));
+  });
+}
+
+// src/commands/chat.ts
+var PIN_LIMIT = 20;
+function pinErrorMessage(e5, fallback2) {
+  const status = e5.status;
+  if (status === 403) {
+    return "Only group admins can pin or unpin messages in a group — check roles with `amiko chat group info`. In a DM either side can pin.";
   }
-  const p = resolved[0];
-  return person({ id: p.userId, name: p.name, handle: p.handle });
+  if (status === 409) {
+    return `Pin limit reached (${PIN_LIMIT}) — unpin one first (see them with \`amiko chat pinned\`).`;
+  }
+  if (status === 400) {
+    return "This message can't be pinned (system and in-flight messages aren't pinnable).";
+  }
+  return e5 instanceof Error ? e5.message : fallback2;
+}
+async function findOrCreateDm(auth, userId) {
+  const data = await amikoWebFetch(auth, "/api/conversations", {
+    method: "POST",
+    body: {
+      participant_ids: [userId],
+      participant_types: ["user"],
+      conversation_type: "direct"
+    },
+    timeoutMs: 20000
+  });
+  const id = data.conversation?.id;
+  if (!id)
+    throw new Error("Could not open a conversation with that user.");
+  return id;
 }
 var HTTPS_RE = /^https:\/\//i;
+var URL_SHAPED_RE = /^[a-z][a-z0-9+.-]*:\/\//i;
 var CHAT_IMAGE_MIME = new Set([
   "image/jpeg",
   "image/jpg",
@@ -29732,45 +30428,466 @@ async function uploadChatVoice(auth, convId, path2) {
   await amikoWebFetch(auth, `/api/conversations/${encodeURIComponent(convId)}/audio/upload`, { method: "POST", multipart: form, timeoutMs: 120000 });
 }
 function registerChatCommand(chat) {
-  chat.command("list").description("List your conversations (DMs and group chats)").option("--limit <n>", "Max conversations", "30").option("--archived", "Include archived conversations").option("--raw", "Output raw JSON").action(async (opts) => {
+  chat.command("list").description("List your conversations (DMs and group chats)").option("--limit <n>", "Max conversations", "30").option("--archived", "Include archived conversations").option("--mentions", "Only conversations with an unread @mention of you, a permitted @all, or a reply to one of your messages").option("--raw", "Output raw JSON").action(async (opts) => {
+    const auth = authOrExit();
+    let data;
+    try {
+      data = await amikoWebFetch(auth, "/api/conversations", {
+        query: {
+          limit: opts.limit,
+          ...opts.archived ? { archived: "all" } : {}
+        },
+        timeoutMs: 20000
+      });
+    } catch (e5) {
+      console.error(error(e5 instanceof Error ? e5.message : "Failed to list conversations"));
+      process.exit(1);
+    }
+    const mentionsMe = (c) => !!c.unread_count && !!c.has_unread_mention;
+    const convs = opts.mentions ? (data.conversations ?? []).filter(mentionsMe) : data.conversations ?? [];
+    if (opts.raw) {
+      console.log(JSON.stringify(opts.mentions ? { ...data, conversations: convs } : data, null, 2));
+      return;
+    }
+    if (convs.length === 0) {
+      console.log(dim(opts.mentions ? "No conversations with unread mentions or replies to you." : "No conversations."));
+      return;
+    }
+    console.log(heading(`Conversations (${convs.length})
+`));
+    for (const c of convs) {
+      const kind = c.conversation_type === "direct" ? "DM" : c.conversation_type;
+      const unread = c.unread_count ? `  (${c.unread_count} unread${mentionsMe(c) ? ", @you" : ""})` : "";
+      console.log(label(`[${kind}] ${convLabel(c, auth.userId)}`, dim(c.id)));
+      if (c.last_message?.content) {
+        const who = c.last_message.name ? `${c.last_message.name}: ` : "";
+        const preview = mentionMarkupToPlainText(c.last_message.content);
+        console.log(dim(`  ${who}${preview.slice(0, 80)}`));
+      }
+      if (unread)
+        console.log(dim(` ${unread.trim()}`));
+    }
+  });
+  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 {
+      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);
+    }
+    let data;
+    try {
+      data = await amikoWebFetch(auth, `/api/conversations/${encodeURIComponent(convId)}/messages`, { query: { limit: opts.limit }, timeoutMs: 20000 });
+    } catch (e5) {
+      console.error(error(e5 instanceof Error ? e5.message : "Failed to read messages"));
+      process.exit(1);
+    }
+    if (opts.raw) {
+      console.log(JSON.stringify(data, null, 2));
+      return;
+    }
+    const msgs = (data.messages ?? []).slice().reverse();
+    if (msgs.length === 0) {
+      console.log(dim("No messages."));
+      return;
+    }
+    console.log(heading(`Messages (${msgs.length})
+`));
+    for (const m of msgs) {
+      const who = m.sender?.name ?? m.name ?? (m.sender_id ? m.sender_id.slice(0, 8) : "?");
+      const when = m.created_at ? m.created_at.slice(0, 19).replace("T", " ") : "";
+      console.log(label(who, mentionMarkupToPlainText(m.content ?? "")));
+      const meta3 = [when, `id ${m.id}`].filter(Boolean).join("  ");
+      console.log(dim(`  ${meta3}`));
+      if (m.reactions?.length) {
+        console.log(dim(`  reactions: ${summarizeReactions(m.reactions)}`));
+      }
+    }
+  });
+  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). The message is optional only with --gif.").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("--gif <queryOrUrl>", "Attach a GIF: search words (sends the top Klipy result) or a Klipy URL from `amiko chat gifs`").option("--all", "Mention @all — notifies every member of the group (admins/owners always; others only when enabled via `amiko chat group mention-all`)").option("--yes", "Skip the confirmation (required in non-interactive shells)").option("--raw", "Output raw JSON").action(async (target, message, opts) => {
     const auth = authOrExit();
+    const mediaFlagCount = [opts.image, opts.audio, opts.gif].filter(Boolean).length;
+    if (mediaFlagCount > 1) {
+      console.error(error("Attach only one of --image, --audio, or --gif (one media block per message)."));
+      process.exit(1);
+    }
+    if (message === undefined && !opts.gif) {
+      console.error(error("A message is required (it may only be omitted when sending a GIF with --gif)."));
+      process.exit(1);
+    }
+    let resolved;
+    try {
+      resolved = await resolveConversation(auth, target);
+    } catch (e5) {
+      console.error(error(e5 instanceof Error ? e5.message : "Could not resolve target"));
+      process.exit(1);
+    }
+    const wantsAll = Boolean(opts.all);
+    const messageText = message ?? "";
+    let outgoing = messageText;
+    let mentionAllActive = false;
+    if (wantsAll || hasMentionAllLiteral(messageText) || hasMentionAllToken(messageText)) {
+      const plainTextNote = "Note: @all only notifies people in group chats — sending it as plain text.";
+      let conv = null;
+      if (resolved.kind === "conversation") {
+        try {
+          conv = resolved.conversation ?? await fetchConversationById(auth, resolved.id);
+        } catch (e5) {
+          console.error(error(e5 instanceof Error ? e5.message : "Could not load the conversation"));
+          process.exit(1);
+        }
+      }
+      if (!conv || conv.conversation_type !== "group") {
+        if (wantsAll) {
+          console.error(error("@all only works in group chats — this target is a direct message."));
+          process.exit(1);
+        }
+        console.log(dim(plainTextNote));
+      } else if (!canMentionAll(conv, auth.userId)) {
+        if (wantsAll) {
+          console.error(error(`You can't @all in "${conv.title ?? conv.id}" — only group admins can, unless an admin allows everyone with \`amiko chat group mention-all ${JSON.stringify(target)} on\`.`));
+          process.exit(1);
+        }
+        console.log(dim('Note: you don\'t have @all permission in this group — "@all" goes out as plain text. An admin can enable it with `amiko chat group mention-all <group> on`.'));
+      } else {
+        outgoing = rewriteMentionAllLiteral(messageText);
+        if (wantsAll)
+          outgoing = applyMentionAll(outgoing);
+        mentionAllActive = true;
+      }
+    }
+    let gifAttachment = null;
+    if (opts.gif) {
+      try {
+        if (URL_SHAPED_RE.test(opts.gif)) {
+          if (!HTTPS_RE.test(opts.gif) || !isKlipyMediaUrl(opts.gif)) {
+            throw new Error("--gif accepts search words or an https Klipy URL (from `amiko chat gifs`). For other images use --image with a local file or an Amiko URL.");
+          }
+          gifAttachment = gifToMetadata({ url: opts.gif });
+        } else {
+          const results = await searchGifs(auth, opts.gif);
+          const top = results.items?.[0];
+          if (!top) {
+            throw new Error(`No GIFs found for "${opts.gif}" — try different words or browse with \`amiko chat gifs\`.`);
+          }
+          gifAttachment = gifToMetadata({
+            url: top.gifUrl,
+            title: top.title,
+            width: top.width,
+            height: top.height
+          });
+        }
+      } catch (e5) {
+        console.error(error(e5 instanceof Error ? e5.message : "Could not resolve the GIF"));
+        process.exit(1);
+      }
+    }
+    const media = opts.image ? `image ${opts.image}` : opts.audio ? `audio ${opts.audio}` : gifAttachment ? `gif "${gifAttachment.name.slice(0, 40)}"` : "";
+    const shown = mentionMarkupToPlainText(outgoing);
+    await requireApproval({
+      free: "sends a message as you (the owner) — the recipients see it",
+      summary: `Send to ${resolved.label}${media ? ` [+${media}]` : ""}${mentionAllActive ? " [@all — notifies every member]" : ""}: ${shown.slice(0, 80)}${shown.length > 80 ? "…" : ""}`,
+      yes: opts.yes,
+      commandExample: `amiko chat send ${JSON.stringify(target)}${message !== undefined ? ` ${JSON.stringify(message)}` : ""}${opts.image ? ` --image ${JSON.stringify(opts.image)}` : ""}${opts.audio ? ` --audio ${JSON.stringify(opts.audio)}` : ""}${opts.gif ? ` --gif ${JSON.stringify(opts.gif)}` : ""}${opts.all ? " --all" : ""}`
+    });
+    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",
+      body,
+      timeoutMs: 20000
+    });
+    let data;
+    try {
+      if (gifAttachment) {
+        const isVideo = isKlipyVideoMediaUrl(gifAttachment.url);
+        data = await post({
+          content: outgoing || "GIF",
+          message_type: isVideo ? "video" : "image",
+          metadata: {
+            [isVideo ? "videos" : "images"]: [gifAttachment],
+            image_caption: outgoing || null
+          }
+        });
+      } else if (opts.image) {
+        const img = HTTPS_RE.test(opts.image) ? { url: opts.image, name: urlName(opts.image) } : await uploadChatImage(auth, convId, opts.image);
+        data = await post({
+          content: outgoing,
+          metadata: { images: [img], image_caption: outgoing || null }
+        });
+      } else if (opts.audio) {
+        if (HTTPS_RE.test(opts.audio)) {
+          data = await post({
+            content: outgoing,
+            message_type: "voice",
+            metadata: { audioUrl: opts.audio }
+          });
+        } else {
+          data = await post({ content: outgoing });
+          await uploadChatVoice(auth, convId, opts.audio);
+        }
+      } else {
+        data = await post({ content: outgoing });
+      }
+    } catch (e5) {
+      console.error(error(e5 instanceof Error ? e5.message : "Send failed"));
+      process.exit(1);
+    }
+    if (opts.raw) {
+      console.log(JSON.stringify(data, null, 2));
+      return;
+    }
+    const what = opts.image ? "Message + image sent" : opts.audio ? "Message + voice note sent" : gifAttachment ? outgoing ? "Message + GIF sent" : "GIF sent" : "Message sent";
+    console.log(success(what) + dim(` (conversation ${convId.slice(0, 8)}…)`));
+  });
+  chat.command("react <messageId> <emoji>").description("React to a message as yourself (the owner). Get the message id from `amiko chat read`. One reaction per message — a new emoji replaces your previous one.").option("--yes", "Skip the confirmation (required in non-interactive shells)").option("--raw", "Output raw JSON").action(async (messageId, emojiArg, opts) => {
+    const auth = authOrExit();
+    let emoji3;
+    try {
+      emoji3 = validateEmoji(emojiArg);
+    } catch (e5) {
+      console.error(error(e5 instanceof Error ? e5.message : "Invalid emoji"));
+      process.exit(1);
+    }
+    let msg;
+    try {
+      msg = await fetchMessage(auth, messageId);
+    } catch (e5) {
+      console.error(error(e5 instanceof Error ? e5.message : "Could not load that message"));
+      process.exit(1);
+    }
+    if (ownReaction(msg.reactions, auth.userId) === emoji3) {
+      if (opts.raw) {
+        console.log(JSON.stringify({ success: true, action: "unchanged", reactions: msg.reactions }, null, 2));
+        return;
+      }
+      console.log(success(`Already reacted with ${emoji3}`));
+      return;
+    }
+    await requireApproval({
+      free: "adds your reaction — people in the chat see it",
+      summary: `React ${emoji3} to "${previewText(msg)}"`,
+      yes: opts.yes,
+      commandExample: `amiko chat react ${JSON.stringify(messageId)} ${JSON.stringify(emoji3)}`
+    });
+    let data;
+    try {
+      data = await amikoWebFetch(auth, `/api/messages/${encodeURIComponent(messageId)}/reactions`, { method: "POST", body: { emoji: emoji3 }, timeoutMs: 20000 });
+    } catch (e5) {
+      console.error(error(e5 instanceof Error ? e5.message : "Failed to react"));
+      process.exit(1);
+    }
+    if (opts.raw) {
+      console.log(JSON.stringify(data, null, 2));
+      return;
+    }
+    const what = data.action === "removed" ? `Removed your ${emoji3} reaction` : data.action === "updated" ? `Reaction changed to ${emoji3}` : `Reacted ${emoji3}`;
+    console.log(success(what));
+  });
+  chat.command("unreact <messageId>").description("Remove your (the owner's) reaction from a message. Get the message id from `amiko chat read`.").option("--yes", "Skip the confirmation (required in non-interactive shells)").option("--raw", "Output raw JSON").action(async (messageId, opts) => {
+    const auth = authOrExit();
+    let msg;
+    try {
+      msg = await fetchMessage(auth, messageId);
+    } catch (e5) {
+      console.error(error(e5 instanceof Error ? e5.message : "Could not load that message"));
+      process.exit(1);
+    }
+    const mine = ownReaction(msg.reactions, auth.userId);
+    if (!mine) {
+      if (opts.raw) {
+        console.log(JSON.stringify({ success: true, action: "none", reactions: msg.reactions }, null, 2));
+        return;
+      }
+      console.log(dim("You have no reaction on that message."));
+      return;
+    }
+    await requireApproval({
+      free: "removes your reaction from the chat",
+      summary: `Remove your ${mine} reaction from "${previewText(msg)}"`,
+      yes: opts.yes,
+      commandExample: `amiko chat unreact ${JSON.stringify(messageId)}`
+    });
     let data;
     try {
-      data = await amikoWebFetch(auth, "/api/conversations", {
-        query: {
-          limit: opts.limit,
-          ...opts.archived ? { archived: "all" } : {}
-        },
-        timeoutMs: 20000
-      });
+      data = await amikoWebFetch(auth, `/api/messages/${encodeURIComponent(messageId)}/reactions`, { method: "POST", body: { emoji: mine }, timeoutMs: 20000 });
     } catch (e5) {
-      console.error(error(e5 instanceof Error ? e5.message : "Failed to list conversations"));
+      console.error(error(e5 instanceof Error ? e5.message : "Failed to remove reaction"));
       process.exit(1);
     }
     if (opts.raw) {
       console.log(JSON.stringify(data, null, 2));
       return;
     }
-    const convs = data.conversations ?? [];
-    if (convs.length === 0) {
-      console.log(dim("No conversations."));
+    const what = data.action === "removed" ? `Removed your ${mine} reaction` : data.action === "updated" ? `Reaction changed to ${mine}` : `Reacted ${mine}`;
+    console.log(success(what));
+  });
+  chat.command("reactions <messageId>").description("Show the reactions on a message. Get the message id from `amiko chat read`.").option("--raw", "Output raw JSON").action(async (messageId, opts) => {
+    const auth = authOrExit();
+    let msg;
+    try {
+      msg = await fetchMessage(auth, messageId);
+    } catch (e5) {
+      console.error(error(e5 instanceof Error ? e5.message : "Could not load that message"));
+      process.exit(1);
+    }
+    if (opts.raw) {
+      console.log(JSON.stringify({ reactions: msg.reactions }, null, 2));
       return;
     }
-    console.log(heading(`Conversations (${convs.length})
+    if (msg.reactions.length === 0) {
+      console.log(dim("No reactions yet."));
+      return;
+    }
+    const mine = ownReaction(msg.reactions, auth.userId);
+    console.log(heading(`Reactions (${msg.reactions.length})
 `));
-    for (const c of convs) {
-      const kind = c.conversation_type === "direct" ? "DM" : c.conversation_type;
-      const unread = c.unread_count ? `  (${c.unread_count} unread)` : "";
-      console.log(label(`[${kind}] ${convLabel(c, auth.userId)}`, dim(c.id)));
-      if (c.last_message?.content) {
-        const who = c.last_message.name ? `${c.last_message.name}: ` : "";
-        console.log(dim(`  ${who}${c.last_message.content.slice(0, 80)}`));
+    for (const [emoji3, count] of groupReactions(msg.reactions)) {
+      const you = emoji3 === mine ? dim("  (includes you)") : "";
+      console.log(label(emoji3, `×${count}`) + you);
+    }
+  });
+  chat.command("receipts <messageId>").description("Show who read your message and when (sender-only). Get the message id from `amiko chat read`.").option("--raw", "Output raw JSON").action(async (messageId, opts) => {
+    const auth = authOrExit();
+    let msg;
+    try {
+      msg = await fetchMessage(auth, messageId);
+    } catch (e5) {
+      console.error(error(e5 instanceof Error ? e5.message : "Could not load that message"));
+      process.exit(1);
+    }
+    let data;
+    try {
+      data = await amikoWebFetch(auth, `/api/messages/${encodeURIComponent(messageId)}/receipts`, { timeoutMs: 20000 });
+    } catch (e5) {
+      const status = e5.status;
+      console.error(error(status === 403 ? "Read receipts are only available for messages you sent (as the owner)." : e5 instanceof Error ? e5.message : "Failed to load receipts"));
+      process.exit(1);
+    }
+    const reads = data.reads ?? [];
+    const delivered = data.delivered_to ?? [];
+    if (opts.raw) {
+      console.log(JSON.stringify(data, null, 2));
+      return;
+    }
+    const names = new Map;
+    if (msg.conversation_id) {
+      try {
+        const conv = await fetchConversationById(auth, msg.conversation_id);
+        for (const p of conv.participants ?? []) {
+          if (p.participant_type !== "user")
+            continue;
+          const id = normalizeUserId(p.participant_id);
+          names.set(id, p.user?.name ?? p.user?.handle ?? id.slice(0, 8));
+        }
+      } catch {}
+    }
+    const nameFor = (userId) => {
+      const id = normalizeUserId(userId);
+      return names.get(id) ?? id.slice(0, 8);
+    };
+    const fmt = (iso) => iso.slice(0, 19).replace("T", " ");
+    console.log(label("Message", previewText(msg)));
+    console.log(label("Sent", fmt(data.sent_at)));
+    console.log("");
+    console.log(heading(`Read by (${reads.length})`));
+    if (reads.length === 0) {
+      console.log(dim("  No one has read this yet."));
+    } else {
+      for (const r of reads) {
+        const when = r.approximate ? dim("read (exact time unknown)") : fmt(r.read_at);
+        console.log(`  ${label(nameFor(r.user_id), when)}`);
+      }
+    }
+    if (delivered.length > 0) {
+      console.log("");
+      console.log(heading(`Delivered to (${delivered.length})`));
+      for (const userId of delivered) {
+        console.log(`  ${nameFor(userId)}`);
       }
-      if (unread)
-        console.log(dim(` ${unread.trim()}`));
     }
   });
-  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) => {
+  chat.command("pin <messageId>").description("Pin a message for everyone in the conversation. Get the message id from `amiko chat read`. Groups require the admin role; the chat sees a pinned-message announcement.").option("--yes", "Skip the confirmation (required in non-interactive shells)").option("--raw", "Output raw JSON").action(async (messageId, opts) => {
+    const auth = authOrExit();
+    let msg;
+    try {
+      msg = await fetchMessage(auth, messageId);
+    } catch (e5) {
+      console.error(error(e5 instanceof Error ? e5.message : "Could not load that message"));
+      process.exit(1);
+    }
+    await requireApproval({
+      free: "pins the message for everyone — the chat sees a pinned-message announcement",
+      summary: `Pin "${previewText(msg)}"`,
+      yes: opts.yes,
+      commandExample: `amiko chat pin ${JSON.stringify(messageId)}`
+    });
+    let data;
+    try {
+      data = await amikoWebFetch(auth, `/api/messages/${encodeURIComponent(messageId)}/pin`, { method: "POST", timeoutMs: 20000 });
+    } catch (e5) {
+      console.error(error(pinErrorMessage(e5, "Failed to pin the message")));
+      process.exit(1);
+    }
+    if (opts.raw) {
+      console.log(JSON.stringify(data, null, 2));
+      return;
+    }
+    console.log(success(`Pinned "${previewText(msg)}"`));
+    const total = data.pins?.length;
+    if (typeof total === "number") {
+      console.log(dim(`  ${total}/${PIN_LIMIT} pinned in this conversation — see them with \`amiko chat pinned\`.`));
+    }
+  });
+  chat.command("unpin <messageId>").description("Unpin a message — removes it from the conversation's pinned list for everyone. Get the message id from `amiko chat read` or `amiko chat pinned`.").option("--yes", "Skip the confirmation (required in non-interactive shells)").option("--raw", "Output raw JSON").action(async (messageId, opts) => {
+    const auth = authOrExit();
+    let msg;
+    try {
+      msg = await fetchMessage(auth, messageId);
+    } catch (e5) {
+      console.error(error(e5 instanceof Error ? e5.message : "Could not load that message"));
+      process.exit(1);
+    }
+    await confirmDestructive({
+      action: `Unpin "${previewText(msg)}" for everyone in the conversation`,
+      yes: opts.yes,
+      commandExample: `amiko chat unpin ${JSON.stringify(messageId)}`
+    });
+    let data;
+    try {
+      data = await amikoWebFetch(auth, `/api/messages/${encodeURIComponent(messageId)}/pin`, { method: "DELETE", timeoutMs: 20000 });
+    } catch (e5) {
+      console.error(error(pinErrorMessage(e5, "Failed to unpin the message")));
+      process.exit(1);
+    }
+    if (opts.raw) {
+      console.log(JSON.stringify(data, null, 2));
+      return;
+    }
+    console.log(success(`Unpinned "${previewText(msg)}"`));
+    const remaining = data.pins?.length;
+    if (typeof remaining === "number" && remaining > 0) {
+      console.log(dim(`  ${remaining} still pinned in this conversation.`));
+    }
+  });
+  chat.command("pinned <target>").description("List a conversation's pinned messages, oldest first (conversation id, user id, @handle, or name)").option("--raw", "Output raw JSON").action(async (target, opts) => {
     const auth = authOrExit();
     let convId;
     try {
@@ -29790,95 +30907,73 @@ function registerChatCommand(chat) {
     }
     let data;
     try {
-      data = await amikoWebFetch(auth, `/api/conversations/${encodeURIComponent(convId)}/messages`, { query: { limit: opts.limit }, timeoutMs: 20000 });
+      data = await amikoWebFetch(auth, `/api/conversations/${encodeURIComponent(convId)}/pinned-messages`, { timeoutMs: 20000 });
     } catch (e5) {
-      console.error(error(e5 instanceof Error ? e5.message : "Failed to read messages"));
+      console.error(error(e5 instanceof Error ? e5.message : "Failed to load pinned messages"));
       process.exit(1);
     }
     if (opts.raw) {
       console.log(JSON.stringify(data, null, 2));
       return;
     }
-    const msgs = (data.messages ?? []).slice().reverse();
-    if (msgs.length === 0) {
-      console.log(dim("No messages."));
+    const pins = data.pins ?? [];
+    if (pins.length === 0) {
+      console.log(dim("No pinned messages."));
       return;
     }
-    console.log(heading(`Messages (${msgs.length})
+    console.log(heading(`Pinned messages (${pins.length})
 `));
-    for (const m of msgs) {
-      const who = m.sender?.name ?? m.name ?? (m.sender_id ? m.sender_id.slice(0, 8) : "?");
+    for (const pin of pins) {
+      const m = pin.message;
+      const who = m.name ?? (m.sender_id ? m.sender_id.slice(0, 8) : "?");
       const when = m.created_at ? m.created_at.slice(0, 19).replace("T", " ") : "";
-      console.log(label(who, m.content));
-      if (when)
-        console.log(dim(`  ${when}`));
+      console.log(label(who, mentionMarkupToPlainText(m.content ?? "")));
+      const meta3 = [when, `id ${m.id}`].filter(Boolean).join("  ");
+      console.log(dim(`  ${meta3}`));
+      if (pin.pinned_by_name) {
+        console.log(dim(`  pinned by ${pin.pinned_by_name}`));
+      }
     }
   });
-  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)."));
+  chat.command("mark-read").description("Mark ALL conversations as read (requires --all). Clears every unread badge on the owner's devices; senders see read ticks.").option("--all", "Mark every conversation as read").option("--yes", "Skip the confirmation (required in non-interactive shells)").option("--raw", "Output raw JSON").action(async (opts) => {
+    if (!opts.all) {
+      console.error(error("Pass --all to mark every conversation as read"));
       process.exit(1);
     }
-    let resolved;
-    try {
-      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({
-      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 ? "…" : ""}`,
+    const auth = authOrExit();
+    await confirmDestructive({
+      action: "Mark ALL of the owner's conversations as read",
+      detail: "Clears every unread badge on web and mobile; senders see read ticks on their messages. This cannot be undone.",
       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",
-      body,
-      timeoutMs: 20000
+      commandExample: "amiko chat mark-read --all"
     });
     let data;
     try {
-      if (opts.image) {
-        const img = HTTPS_RE.test(opts.image) ? { url: opts.image, name: urlName(opts.image) } : await uploadChatImage(auth, convId, opts.image);
-        data = await post({ content: message, metadata: { images: [img] } });
-      } else if (opts.audio) {
-        if (HTTPS_RE.test(opts.audio)) {
-          data = await post({
-            content: message,
-            message_type: "voice",
-            metadata: { audioUrl: opts.audio }
-          });
-        } else {
-          data = await post({ content: message });
-          await uploadChatVoice(auth, convId, opts.audio);
-        }
-      } else {
-        data = await post({ content: message });
-      }
+      data = await amikoWebFetch(auth, "/api/conversations/read-all", {
+        method: "POST",
+        timeoutMs: 20000
+      });
     } catch (e5) {
-      console.error(error(e5 instanceof Error ? e5.message : "Send failed"));
+      console.error(error(e5 instanceof Error ? e5.message : "Failed to mark all as read"));
       process.exit(1);
     }
     if (opts.raw) {
       console.log(JSON.stringify(data, null, 2));
       return;
     }
-    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)}…)`));
+    console.log(success("All conversations marked as read."));
+    const cleared = data.cleared_notifications;
+    if (typeof cleared === "number" && cleared > 0) {
+      console.log(dim(`  ${cleared} chat notification${cleared === 1 ? "" : "s"} cleared`));
+    } else if ((data.unread_conversation_ids ?? []).length === 0) {
+      console.log(dim("  Nothing was unread."));
+    }
   });
-  const group = chat.command("group").description("Group chats — create, list, info, rename, add/remove members, leave");
+  registerChatGifsCommand(chat);
+  const group = chat.command("group").description("Group chats — create, list, info, rename, add/remove members, @all permission, leave");
   registerChatGroupCommand(group);
+  const lists = chat.command("lists").description("Your chat lists (private folders of conversations) — run bare to see them; create, rename, add/remove conversations, delete");
+  registerChatListsCommand(lists);
 }
 
 // src/commands/card.ts
@@ -30096,7 +31191,7 @@ function registerCardCommand(card) {
 // src/commands/amazon.ts
 var AMAZON_SEARCH_USD = 0.01;
 function registerAmazonCommand(program2) {
-  const cmd = program2.command("amazon").description("Search and buy products on Amazon — paid with AMIKO");
+  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 {
@@ -30313,19 +31408,33 @@ 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");
-  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) => {
+  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 via mpp /v1/tts (pay-per-call)").option("--provider <name>", "elevenlabs (default) | minimax").option("--model <model>", "MiniMax speech-* model when provider=minimax").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) => {
+    const provider = typeof opts.provider === "string" ? opts.provider.trim().toLowerCase() : "";
+    const body = { text };
+    if (provider === "minimax") {
+      body.provider = "minimax";
+      if (opts.model)
+        body.model_id = opts.model;
+      else
+        body.model_id = "speech-2.8-turbo";
+    } else if (provider && provider !== "elevenlabs") {
+      console.error(error("--provider must be minimax or elevenlabs"));
+      process.exit(1);
+    }
+    const providerArgs = provider ? ` --provider ${provider}` : "";
+    const modelArgs = provider === "minimax" ? ` --model ${JSON.stringify(typeof opts.model === "string" && opts.model ? opts.model : "speech-2.8-turbo")}` : "";
     await requireApproval({
-      cost: "1 AMIKO",
-      summary: `Text-to-speech (voice ${voiceId}): "${text.slice(0, 60)}${text.length > 60 ? "…" : ""}"`,
+      cost: "variable (see mpp pricing)",
+      summary: `Text-to-speech (voice ${voiceId}${provider ? `, ${provider}` : ""}): "${text.slice(0, 60)}${text.length > 60 ? "…" : ""}"`,
       yes: opts.yes,
-      commandExample: `amiko markets service tts ${voiceId} ${JSON.stringify(text)}`
+      commandExample: `amiko markets service tts ${voiceId} ${JSON.stringify(text)}${providerArgs}${modelArgs}`
     });
     await callService({
       name: "Text-to-Speech",
       method: "POST",
       path: `/v1/tts/${encodeURIComponent(voiceId)}`,
-      body: { text },
+      body,
       amiko: "1",
       opts
     });
@@ -30537,7 +31646,7 @@ function registerAccountsCommand(program2) {
       }
     }, { 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) => {
+  program2.command("info").description("Get twin info (name, description, voice ids, avatar)").option("--twin <idOrName>", "Target twin id or name").option("--json", "Output as JSON").action(async (opts) => {
     const config2 = loadConfig();
     const auth = resolveAuth();
     let twinId;
@@ -30561,13 +31670,24 @@ function registerAccountsCommand(program2) {
           console.log(label("Description", t.description));
         console.log(label("Public", t.is_public ? "yes" : "no"));
         if (t.voice_status)
-          console.log(label("Voice", t.voice_status));
+          console.log(label("Voice status", t.voice_status));
+        if (t.voice_id)
+          console.log(label("ElevenLabs voice_id", t.voice_id));
+        else
+          console.log(label("ElevenLabs voice_id", dim("(none)")));
+        if (t.minimax_voice_id)
+          console.log(label("MiniMax voice_id", t.minimax_voice_id));
+        else
+          console.log(label("MiniMax voice_id", dim("(none — clone with amiko voice clone)")));
         if (t.avatar_url)
           console.log(label("Avatar", t.avatar_url));
         if (t.shipped_at)
           console.log(label("Shipped", t.shipped_at));
         if (t.updated_at)
           console.log(dim(`Updated ${t.updated_at}`));
+        console.log("");
+        console.log(dim('MiniMax TTS: amiko create tts "…" --provider minimax --voice <MiniMax voice_id> --yes'));
+        console.log(dim('ElevenLabs TTS: amiko create tts "…" --provider elevenlabs --voice <ElevenLabs voice_id> --yes'));
       }, { json: opts.json });
     } catch (e5) {
       spinner?.stop();
@@ -30649,6 +31769,9 @@ 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(/\/$/, "");
 }
@@ -30783,26 +31906,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"
       };
@@ -30818,10 +31971,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."));
@@ -31173,8 +32324,18 @@ function twinFromFlag2(opts) {
     throw e5;
   }
 }
+function parseProvider(raw, fallback2) {
+  if (raw == null || raw.trim() === "")
+    return fallback2;
+  const p = raw.trim().toLowerCase();
+  if (p !== "minimax" && p !== "elevenlabs") {
+    console.error(error("--provider must be minimax or elevenlabs"));
+    process.exit(1);
+  }
+  return p;
+}
 function registerVoiceCommand(program2) {
-  program2.command("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) => {
+  program2.command("design").description("Design a voice from a text description (ElevenLabs)").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);
@@ -31202,7 +32363,7 @@ function registerVoiceCommand(program2) {
       process.exit(1);
     }
   });
-  program2.command("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) => {
+  program2.command("create").description("Create a voice from a previously designed preview (ElevenLabs)").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 {
@@ -31228,7 +32389,8 @@ function registerVoiceCommand(program2) {
       process.exit(1);
     }
   });
-  program2.command("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) => {
+  program2.command("clone <source>").description("Clone a voice from an audio file (path | https URL | -). Default provider: minimax").option("--provider <name>", "minimax (default, mpp rapid clone) | elevenlabs (platform IVC)", "minimax").option("--voice-id <id>", "MiniMax: optional custom voice_id (8–256 chars)").option("--model <model>", "MiniMax preview TTS model", "speech-2.8-turbo").option("--preview-text <text>", "MiniMax: preview line (empty string skips preview)").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 provider = parseProvider(opts.provider, "minimax");
     const { twinId, auth } = twinFromFlag2(opts);
     const spinner = opts.json ? null : ora("Reading audio...").start();
     try {
@@ -31238,17 +32400,30 @@ function registerVoiceCommand(program2) {
         hintMime: "audio/mpeg"
       });
       if (spinner)
-        spinner.text = `Cloning voice from ${file2.name}...`;
+        spinner.text = `Cloning voice (${provider}) from ${file2.name}...`;
       const form = new FormData;
       form.set("audio", new Blob([new Uint8Array(file2.buffer)], { type: file2.mime }), file2.name);
+      form.set("provider", provider);
+      if (provider === "minimax") {
+        if (opts.voiceId)
+          form.set("voice_id", opts.voiceId);
+        if (opts.model)
+          form.set("model_id", opts.model);
+        if (opts.previewText !== undefined)
+          form.set("text", opts.previewText);
+      }
       const result = await amikoWebFetch(auth, `/api/agents/${twinId}/voice/clone`, { method: "POST", multipart: form, timeoutMs: 180000 });
       spinner?.stop();
       renderOutput(result, (r) => {
-        console.log(success("Voice cloned"));
+        console.log(success(`Voice cloned (${String(r.provider ?? provider)})`));
         if (r.voice_id)
           console.log(label("Voice ID", String(r.voice_id)));
         if (r.voice_status)
           console.log(label("Status", String(r.voice_status)));
+        if (r.demo_audio)
+          console.log(label("Demo", String(r.demo_audio)));
+        console.log("");
+        console.log(dim(`Synthesize: amiko create tts "Hello" --provider ${provider} --voice ${String(r.voice_id ?? "<id>")} --yes`));
       }, { json: opts.json });
     } catch (e5) {
       spinner?.stop();
@@ -31451,33 +32626,223 @@ async function mppFriendReportGenerate(auth, body, opts = {}) {
   log("Generating report...");
   const url2 = `${mppBase2}/v1/friend-reports/generate`;
   try {
-    const res = await fetch(url2, {
-      method: "POST",
-      headers: {
-        "Content-Type": "application/json",
-        "X-Payment-Tx": txHash
-      },
-      body: JSON.stringify(normalizedBody)
+    const res = await fetch(url2, {
+      method: "POST",
+      headers: {
+        "Content-Type": "application/json",
+        "X-Payment-Tx": txHash
+      },
+      body: JSON.stringify(normalizedBody)
+    });
+    const data = await res.json().catch(() => ({}));
+    if (!res.ok) {
+      return {
+        ok: false,
+        status: res.status,
+        error: (typeof data.error === "string" ? data.error : null) ?? `mpp-service returned ${res.status}`,
+        stage: "generate",
+        body: data
+      };
+    }
+    return { ok: true, status: res.status, body: data, txHash, amikoAmount };
+  } catch (err) {
+    return {
+      ok: false,
+      status: 0,
+      error: err instanceof Error ? err.message : "mpp-service fetch failed",
+      stage: "generate"
+    };
+  }
+}
+
+// src/lib/nickname.ts
+var NICKNAME_MAX_CODE_POINTS = 50;
+var CONTROL_CHARS = /\p{Cc}/u;
+function validateNickname(input) {
+  if (CONTROL_CHARS.test(input)) {
+    return {
+      ok: false,
+      error: "invalid_characters",
+      message: "Nickname contains unsupported characters (control characters are not allowed)."
+    };
+  }
+  const trimmed = input.trim();
+  if (!trimmed) {
+    return { ok: false, error: "empty", message: "Nickname is empty." };
+  }
+  if ([...trimmed].length > NICKNAME_MAX_CODE_POINTS) {
+    return {
+      ok: false,
+      error: "too_long",
+      message: `Nickname is too long (max ${NICKNAME_MAX_CODE_POINTS} characters).`
+    };
+  }
+  return { ok: true, value: trimmed };
+}
+
+// src/commands/friends-nickname.ts
+function exitWithError3(e5, fallback2) {
+  console.error(error(e5 instanceof Error ? e5.message : fallback2));
+  process.exit(1);
+}
+function friendLabel(f) {
+  const name = f.friend.name ?? f.friend.id;
+  return f.friend.handle ? `${name} (@${f.friend.handle})` : name;
+}
+async function fetchUserFriends(auth) {
+  const limit = 100;
+  const all = [];
+  for (let offset = 0;offset < 1e4; offset += limit) {
+    const data = await amikoWebFetch(auth, "/api/friends", {
+      query: { type: "user", limit, offset },
+      timeoutMs: 20000
+    });
+    const page = data.friends ?? [];
+    all.push(...page);
+    if (page.length < limit || data.pagination?.has_more === false)
+      break;
+  }
+  return all;
+}
+async function resolveFriend(auth, target) {
+  const t = target.trim();
+  if (!t) {
+    throw new Error("No friend given. Pass a name, @handle, user id, or friendship id.");
+  }
+  const all = await fetchUserFriends(auth);
+  const asId = normalizeUserId(t);
+  const byId = all.find((f) => f.friendship_id === asId || f.friend.id === asId);
+  if (byId)
+    return byId;
+  if (t.startsWith("@")) {
+    const handle = t.slice(1).toLowerCase();
+    const byHandle = all.filter((f) => f.friend.handle?.toLowerCase() === handle);
+    if (byHandle.length === 1)
+      return byHandle[0];
+    throw new Error(`No friend ${t}. Nicknames only work for accepted friends — run \`amiko friends list\`.`);
+  }
+  const lower = t.toLowerCase();
+  const exact = all.filter((f) => f.friend.name?.toLowerCase() === lower || f.friend.handle?.toLowerCase() === lower || f.nickname?.toLowerCase() === lower);
+  const matches = exact.length ? exact : all.filter((f) => f.friend.name?.toLowerCase().includes(lower) || f.friend.handle?.toLowerCase().includes(lower) || f.nickname?.toLowerCase().includes(lower));
+  if (matches.length === 0) {
+    throw new Error(`No friend matching "${t}". Nicknames only work for accepted friends — run \`amiko friends list\`.`);
+  }
+  if (matches.length > 1) {
+    const names = matches.map((f) => `${friendLabel(f)} (${f.friend.id})`).join(", ");
+    throw new Error(`"${t}" is ambiguous — matches: ${names}. Use the friend's @handle or user id.`);
+  }
+  return matches[0];
+}
+async function resolveFriendOrExit(auth, target) {
+  try {
+    return await resolveFriend(auth, target);
+  } catch (e5) {
+    exitWithError3(e5, "Could not resolve the friend");
+  }
+}
+async function patchNickname(auth, friendshipId, nickname, spinner) {
+  try {
+    const data = await amikoWebFetch(auth, `/api/friends/${encodeURIComponent(friendshipId)}/nickname`, { method: "PATCH", body: { nickname }, timeoutMs: 20000 });
+    spinner?.stop();
+    return data;
+  } catch (e5) {
+    spinner?.stop();
+    if (e5.status === 403) {
+      console.error(error(e5 instanceof Error ? e5.message : "Forbidden"));
+      console.error(dim("Tip: nickname writes need an amiko-web deploy that allows twin tokens to manage nicknames (feat/friend-nicknames)."));
+      process.exit(1);
+    }
+    exitWithError3(e5, "Failed to update the nickname");
+  }
+}
+async function runList(opts) {
+  const auth = authOrExit();
+  const spinner = opts.json ? null : ora("Loading nicknames...").start();
+  let all;
+  try {
+    all = await fetchUserFriends(auth);
+  } catch (e5) {
+    spinner?.stop();
+    exitWithError3(e5, "Failed to load friends");
+  }
+  spinner?.stop();
+  const named = all.filter((f) => !!f.nickname);
+  renderOutput({
+    nicknames: named.map((f) => ({
+      nickname: f.nickname ?? null,
+      user_id: f.friend.id,
+      name: f.friend.name ?? null,
+      handle: f.friend.handle ?? null,
+      friendship_id: f.friendship_id
+    }))
+  }, () => {
+    if (named.length === 0) {
+      console.log(dim("No nicknames set."));
+      console.log(dim('Set one with `amiko friends nickname set <friend> "<nickname>"`.'));
+      return;
+    }
+    console.log(heading(`Nicknames (${named.length})`));
+    const rows = [
+      [
+        dim("NICKNAME"),
+        dim("NAME"),
+        dim("HANDLE"),
+        dim("USER ID"),
+        dim("FRIENDSHIP")
+      ],
+      ...named.map((f) => [
+        f.nickname ?? "-",
+        f.friend.name ?? "-",
+        f.friend.handle ?? "-",
+        f.friend.id,
+        f.friendship_id
+      ])
+    ];
+    console.log(table(rows));
+  }, { json: opts.json });
+}
+function registerFriendsNicknameCommand(nickname) {
+  nickname.option("--json", "Output as JSON").action(runList);
+  nickname.command("list").description("List every nickname you've set").option("--json", "Output as JSON").action((_opts, cmd) => runList(cmd.optsWithGlobals()));
+  nickname.command("set <friend> <nickname>").description("Set or change your private nickname for a friend (name, @handle, user id, or friendship id)").option("--yes", "Skip the confirmation (required in non-interactive shells)").option("--json", "Output as JSON").action(async (target, rawNickname, _opts, cmd) => {
+    const opts = cmd.optsWithGlobals();
+    const checked = validateNickname(rawNickname);
+    if (!checked.ok) {
+      console.error(error(checked.message));
+      if (checked.error === "empty") {
+        console.error(dim(`Tip: to clear a nickname, run \`amiko friends nickname remove ${JSON.stringify(target)}\`.`));
+      }
+      process.exit(1);
+    }
+    const auth = authOrExit();
+    const friend = await resolveFriendOrExit(auth, target);
+    await confirmDestructive({
+      action: friend.nickname ? `Change your private nickname for ${friendLabel(friend)} from "${friend.nickname}" to "${checked.value}"` : `Set your private nickname for ${friendLabel(friend)} to "${checked.value}"`,
+      detail: "Nicknames are private — only you ever see them, in every Amiko app.",
+      yes: opts.yes,
+      commandExample: `amiko friends nickname set ${JSON.stringify(target)} ${JSON.stringify(checked.value)}`
     });
-    const data = await res.json().catch(() => ({}));
-    if (!res.ok) {
-      return {
-        ok: false,
-        status: res.status,
-        error: (typeof data.error === "string" ? data.error : null) ?? `mpp-service returned ${res.status}`,
-        stage: "generate",
-        body: data
-      };
+    const spinner = opts.json ? null : ora("Saving nickname...").start();
+    const data = await patchNickname(auth, friend.friendship_id, checked.value, spinner);
+    renderOutput(data, (d) => console.log(success(`${friendLabel(friend)} is now "${d.nickname}" to you`)), { json: opts.json });
+  });
+  nickname.command("remove <friend>").description("Remove your private nickname for a friend").option("--yes", "Skip the confirmation (required in non-interactive shells)").option("--json", "Output as JSON").action(async (target, _opts, cmd) => {
+    const opts = cmd.optsWithGlobals();
+    const auth = authOrExit();
+    const friend = await resolveFriendOrExit(auth, target);
+    if (!friend.nickname) {
+      renderOutput({ nickname: null }, () => console.log(dim(`No nickname set for ${friendLabel(friend)}.`)), { json: opts.json });
+      return;
     }
-    return { ok: true, status: res.status, body: data, txHash, amikoAmount };
-  } catch (err) {
-    return {
-      ok: false,
-      status: 0,
-      error: err instanceof Error ? err.message : "mpp-service fetch failed",
-      stage: "generate"
-    };
-  }
+    await confirmDestructive({
+      action: `Remove your private nickname "${friend.nickname}" for ${friendLabel(friend)}`,
+      yes: opts.yes,
+      commandExample: `amiko friends nickname remove ${JSON.stringify(target)}`
+    });
+    const spinner = opts.json ? null : ora("Removing nickname...").start();
+    const data = await patchNickname(auth, friend.friendship_id, null, spinner);
+    renderOutput(data, () => console.log(success(`Nickname removed — ${friendLabel(friend)} shows their real name again`)), { json: opts.json });
+  });
 }
 
 // src/commands/friends.ts
@@ -31603,11 +32968,12 @@ function registerFriendsCommand(program2) {
           console.log(dim("No friends."));
           return;
         }
-        console.log(heading(`Friends (${items.length})`));
+        console.log(heading(`Friends (${d.pagination?.total ?? items.length})`));
         const rows = [
           [
             dim("USER ID"),
             dim("NAME"),
+            dim("NICKNAME"),
             dim("HANDLE"),
             dim("TYPE"),
             dim("FRIENDSHIP"),
@@ -31616,6 +32982,7 @@ function registerFriendsCommand(program2) {
           ...items.map((f) => [
             f.friend.id,
             f.friend.name ?? "-",
+            f.nickname ?? "-",
             f.friend.handle ?? "-",
             f.friend.type,
             f.friendship_id,
@@ -31720,6 +33087,8 @@ Accept with: amiko friends accept <friendshipId>`));
       process.exit(1);
     }
   });
+  const nickname = program2.command("nickname").description("Private nicknames for friends — set, remove, list (only you ever see them)");
+  registerFriendsNicknameCommand(nickname);
   const reports = program2.command("reports").description("Friend matching reports");
   reports.command("list").description("List friend matching reports").option("--page <n>", "Page number", "1").option("--limit <n>", "Page size (1-50)", "20").option("--json", "Output as JSON").action(async (opts) => {
     const auth = resolveAuth();
@@ -32063,20 +33432,62 @@ The other user will be notified and must consent before the report is generated.
   });
 }
 
+// src/lib/paginate.ts
+var defaultFetcher = (auth, path2, opts) => amikoWebFetch(auth, path2, opts);
+var DEFAULT_PAGE_CAP = 2000;
+async function fetchAllCursor(auth, path2, opts) {
+  const pageSize = opts.pageSize ?? 100;
+  const cap = opts.cap ?? DEFAULT_PAGE_CAP;
+  const fetcher = opts.fetcher ?? defaultFetcher;
+  const items = [];
+  let cursor;
+  for (let i = 0;i < 1e4; i += 1) {
+    const data = await fetcher(auth, path2, {
+      query: { ...opts.query, limit: pageSize, cursor },
+      timeoutMs: opts.timeoutMs
+    });
+    const page = data[opts.itemsKey] ?? [];
+    items.push(...page);
+    if (!data.hasMore || !data.nextCursor) {
+      return { items, partial: false };
+    }
+    if (items.length >= cap) {
+      return { items: items.slice(0, cap), partial: true };
+    }
+    cursor = data.nextCursor;
+  }
+  return { items: items.slice(0, cap), partial: true };
+}
+
 // src/commands/users.ts
+var SEARCH_ALL_CAP = 200;
+async function searchOnePage(auth, query, limit, cursor) {
+  const data = await amikoWebFetch(auth, "/api/search", {
+    query: { q: query, type: "people", limit, cursor }
+  });
+  return { ...data, partial: false };
+}
+async function searchAll(auth, query) {
+  const { items, partial: partial3 } = await fetchAllCursor(auth, "/api/search", {
+    itemsKey: "users",
+    query: { q: query, type: "people" },
+    pageSize: 20,
+    cap: SEARCH_ALL_CAP
+  });
+  return { users: items, hasMore: false, nextCursor: null, partial: partial3 };
+}
+function printFollowState(state) {
+  console.log(label("Following them", state.following ? "yes" : "no"));
+  console.log(label("Follows you", state.followsMe ? "yes" : "no"));
+  console.log(label("Followers", String(state.followerCount ?? 0)));
+  console.log(label("Following", String(state.followingCount ?? 0)));
+}
 function registerUsersCommand(program2) {
-  program2.command("search <query>").description("Search for users by name or handle").option("--limit <n>", "Max results (1-20)", "10").option("--cursor <cursor>", "Pagination cursor").option("--json", "Output as JSON").action(async (query, opts) => {
+  program2.command("search <query>").description("Search for users by name or handle").option("--limit <n>", "Max results (1-20)", "10").option("--all", 'Page through EVERY match (up to a safety cap) — use for "how many people match X". Ignores --limit').option("--cursor <cursor>", "Pagination cursor").option("--json", "Output as JSON").action(async (query, opts) => {
     const auth = resolveAuth();
     const spinner = opts.json ? null : ora("Searching users...").start();
     try {
-      const data = await amikoWebFetch(auth, "/api/search", {
-        query: {
-          q: query,
-          type: "people",
-          limit: opts.limit,
-          cursor: opts.cursor
-        }
-      });
+      const data = opts.all ? await searchAll(auth, query) : await searchOnePage(auth, query, opts.limit, opts.cursor);
       spinner?.stop();
       renderOutput(data, (d) => {
         const items = d.users ?? [];
@@ -32084,19 +33495,18 @@ function registerUsersCommand(program2) {
           console.log(dim("No users found."));
           return;
         }
-        console.log(heading(`Users (${items.length})`));
+        console.log(heading(`Users (${items.length}${d.partial ? "+" : ""})`));
         const rows = [
           [dim("ID"), dim("NAME"), dim("HANDLE")],
-          ...items.map((u) => [
-            u.id,
-            u.name ?? "-",
-            u.handle ?? "-"
-          ])
+          ...items.map((u) => [u.id, u.name ?? "-", u.handle ?? "-"])
         ];
         console.log(table(rows));
-        if (d.hasMore && d.nextCursor) {
+        if (d.partial) {
           console.log(dim(`
-Next cursor: ${d.nextCursor}`));
+⚠ Partial results: stopped at the ${items.length}-match cap; more exist. Not the full set/count.`));
+        } else if (d.hasMore && d.nextCursor) {
+          console.log(dim(`
+More matches exist. Next page: --cursor ${d.nextCursor} · every match: --all`));
         }
       }, { json: opts.json });
     } catch (e5) {
@@ -32140,6 +33550,97 @@ Twins (${u.twins.length})`));
       process.exit(1);
     }
   });
+  program2.command("follow <handleOrId>").description("Follow a user (one-way, no approval needed — their posts appear in `amiko feed --type following`)").option("--json", "Output as JSON").action(async (target, opts) => {
+    const auth = resolveAuth();
+    const spinner = opts.json ? null : ora(`Following ${target}...`).start();
+    try {
+      const data = await amikoWebFetch(auth, `/api/users/${encodeURIComponent(target)}/follow`, { method: "POST" });
+      spinner?.stop();
+      renderOutput(data, (d) => {
+        console.log(success(`Now following ${target}`));
+        printFollowState(d);
+      }, { json: opts.json });
+    } catch (e5) {
+      spinner?.stop();
+      console.error(error(e5 instanceof Error ? e5.message : String(e5)));
+      process.exit(1);
+    }
+  });
+  program2.command("unfollow <handleOrId>").description("Stop following a user").option("--json", "Output as JSON").action(async (target, opts) => {
+    const auth = resolveAuth();
+    const spinner = opts.json ? null : ora(`Unfollowing ${target}...`).start();
+    try {
+      const data = await amikoWebFetch(auth, `/api/users/${encodeURIComponent(target)}/follow`, { method: "DELETE" });
+      spinner?.stop();
+      renderOutput(data, (d) => {
+        console.log(success(`Unfollowed ${target}`));
+        printFollowState(d);
+      }, { json: opts.json });
+    } catch (e5) {
+      spinner?.stop();
+      console.error(error(e5 instanceof Error ? e5.message : String(e5)));
+      process.exit(1);
+    }
+  });
+  program2.command("follow-status <handleOrId>").description("Check whether you follow a user (and whether they follow you)").option("--json", "Output as JSON").action(async (target, opts) => {
+    const auth = resolveAuth();
+    const spinner = opts.json ? null : ora(`Checking follow status for ${target}...`).start();
+    try {
+      const data = await amikoWebFetch(auth, `/api/users/${encodeURIComponent(target)}/follow`);
+      spinner?.stop();
+      renderOutput(data, (d) => {
+        console.log(heading(target));
+        printFollowState(d);
+      }, { json: opts.json });
+    } catch (e5) {
+      spinner?.stop();
+      console.error(error(e5 instanceof Error ? e5.message : String(e5)));
+      process.exit(1);
+    }
+  });
+  for (const kind of ["followers", "following"]) {
+    program2.command(`${kind} <handleOrId>`).description(kind === "followers" ? "List who follows a user (newest first)" : "List who a user follows (newest first)").option("--limit <n>", "Max results (1-50, default 20)", "20").option("--cursor <cursor>", "Pagination cursor").option("--json", "Output as JSON").action(async (target, opts) => {
+      const limit = Number(opts.limit ?? "20");
+      if (!Number.isInteger(limit) || limit < 1 || limit > 50) {
+        console.error(error("--limit must be an integer between 1 and 50"));
+        process.exit(1);
+      }
+      const auth = resolveAuth();
+      const spinner = opts.json ? null : ora(`Loading ${kind}...`).start();
+      try {
+        const data = await amikoWebFetch(auth, `/api/users/${encodeURIComponent(target)}/${kind}`, {
+          query: { limit, cursor: opts.cursor }
+        });
+        spinner?.stop();
+        const items = data.items ?? [];
+        renderOutput(data, (d) => {
+          if (items.length === 0) {
+            console.log(dim(`No ${kind}.`));
+            return;
+          }
+          console.log(heading(`${target} — ${kind} (${items.length}${d.nextCursor ? "+" : ""})`));
+          const rows = [
+            [dim("ID"), dim("NAME"), dim("HANDLE"), dim("YOU FOLLOW")],
+            ...items.map((u) => [
+              u.id,
+              u.name ?? "-",
+              u.handle ?? "-",
+              u.followedByMe ? "yes" : "no"
+            ])
+          ];
+          console.log(table(rows));
+          if (d.nextCursor) {
+            console.log(dim(`
+Next: --cursor ${d.nextCursor}`));
+          }
+        }, { json: opts.json });
+      } catch (e5) {
+        spinner?.stop();
+        console.error(error(e5 instanceof Error ? e5.message : String(e5)));
+        process.exit(1);
+      }
+    });
+  }
 }
 
 // src/lib/post-media.ts
@@ -32193,15 +33694,167 @@ async function resolveMediaUrls(auth, inputs) {
   return resolved;
 }
 
+// src/lib/post-doc.ts
+var MAX_DOC_ATTACHMENTS = 8;
+var MULTIPART_MAX_BYTES = 4 * 1024 * 1024;
+var MAX_DOC_BYTES = 50 * 1024 * 1024;
+var SIGNED_PUT_TIMEOUT_MS = 10 * 60 * 1000;
+function isMediaMime(mime) {
+  return mime.startsWith("image/") || mime.startsWith("video/") || mime.startsWith("audio/");
+}
+async function uploadPostDoc(auth, source) {
+  const file2 = await resolveFileInput(source, { maxBytes: MAX_DOC_BYTES });
+  if (isMediaMime(file2.mime)) {
+    throw new Error(`"${source}" is a media file (${file2.mime}). Attach images/audio/video with --media, not --doc.`);
+  }
+  if (file2.size > MAX_DOC_BYTES) {
+    throw new Error(`"${source}" is ${file2.size} bytes; exceeds the 50 MB document limit.`);
+  }
+  if (file2.size <= MULTIPART_MAX_BYTES) {
+    const form = new FormData;
+    form.set("file", new Blob([new Uint8Array(file2.buffer)], { type: file2.mime }), file2.name);
+    const res = await amikoWebFetch(auth, "/api/upload/post-doc", {
+      method: "POST",
+      multipart: form,
+      timeoutMs: 120000
+    });
+    if (!res.url) {
+      throw new Error(res.error ?? "post-doc upload returned no URL.");
+    }
+    return {
+      url: res.url,
+      filename: res.filename ?? file2.name,
+      mime_type: res.mime_type ?? file2.mime,
+      size: res.size ?? file2.size
+    };
+  }
+  const signed = await amikoWebFetch(auth, "/api/upload/post-doc/sign", {
+    method: "POST",
+    body: { filename: file2.name, contentType: file2.mime, size: file2.size }
+  });
+  if (!signed.signedUrl || !signed.url) {
+    throw new Error(signed.error ?? "Could not prepare the document upload.");
+  }
+  const put = await fetch(signed.signedUrl, {
+    method: "PUT",
+    headers: { "content-type": file2.mime },
+    body: new Uint8Array(file2.buffer),
+    signal: AbortSignal.timeout(SIGNED_PUT_TIMEOUT_MS)
+  });
+  if (!put.ok) {
+    const detail = await put.text().catch(() => "");
+    throw new Error(`Direct storage upload failed: ${put.status} ${put.statusText}${detail ? ` — ${detail.slice(0, 200)}` : ""}`);
+  }
+  return {
+    url: signed.url,
+    filename: file2.name,
+    mime_type: file2.mime,
+    size: file2.size
+  };
+}
+function deriveFilename(url2) {
+  try {
+    const path2 = new URL(url2, "https://x").pathname;
+    return decodeURIComponent(path2.split("/").pop() || "") || "file";
+  } catch {
+    return "file";
+  }
+}
+async function resolveDocAttachments(auth, inputs) {
+  const values = inputs.map((v) => v.trim()).filter((v) => v.length > 0);
+  if (values.length > MAX_DOC_ATTACHMENTS) {
+    throw new Error(`Too many documents: ${values.length}. A post accepts at most ${MAX_DOC_ATTACHMENTS}.`);
+  }
+  const resolved = [];
+  for (const value of values) {
+    if (/^https?:\/\//i.test(value)) {
+      if (!/^https:\/\//i.test(value)) {
+        throw new Error(`"${value}" must be an https URL — plain http documents are not accepted.`);
+      }
+      resolved.push({ url: value, filename: deriveFilename(value) });
+    } else {
+      resolved.push(await uploadPostDoc(auth, value));
+    }
+  }
+  return resolved;
+}
+
 // src/commands/feed.ts
+var MAX_TITLE_CHARS = 150;
+var graphemeSegmenter = new Intl.Segmenter(undefined, {
+  granularity: "grapheme"
+});
+function graphemeLength(text) {
+  let n = 0;
+  for (const _ of graphemeSegmenter.segment(text))
+    n++;
+  return n;
+}
+var FEED_TYPES = [
+  "all",
+  "for_you",
+  "friends",
+  "following",
+  "media",
+  "humans",
+  "amikos"
+];
+var MEDIA_KINDS = ["image", "audio", "video"];
+async function runMediaFeed(auth, opts) {
+  const spinner = opts.json ? null : ora("Loading media feed...").start();
+  try {
+    const data = await amikoWebFetch(auth, "/api/media/feed", {
+      query: { type: opts.kind, limit: opts.limit, cursor: opts.cursor }
+    });
+    spinner?.stop();
+    const items = data.items ?? [];
+    renderOutput({ ...data, items }, (d) => {
+      if (items.length === 0) {
+        console.log(dim("No public media."));
+        return;
+      }
+      console.log(heading(`Media feed${opts.kind ? ` (${opts.kind})` : ""} — ${items.length} items`));
+      for (const m of items) {
+        const author = m.twin?.name ?? m.user?.name ?? m.user?.handle ?? "unknown";
+        console.log("");
+        console.log(label(author, m.created_at?.slice(0, 16) ?? ""));
+        if (m.prompt)
+          console.log(m.prompt);
+        console.log(dim(`${m.mime_type}${m.model ? ` · ${m.model}` : ""}`));
+        console.log(m.url);
+      }
+      if (d.nextCursor) {
+        console.log("");
+        console.log(dim(`Next: --cursor ${d.nextCursor}`));
+      }
+    }, { json: opts.json });
+  } catch (e5) {
+    spinner?.stop();
+    console.error(error(e5 instanceof Error ? e5.message : String(e5)));
+    process.exit(1);
+  }
+}
 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("--unread", "Only return posts not yet read. Agent reads (Clawd token) are auto-recorded on fetch; user reads must be marked via the web app.").option("--json", "Output as JSON").action(async (opts) => {
+  program2.command("feed").description("Get feed posts (notes)").option("--type <all|friends|following|media|humans|amikos>", "Feed tab: all (everything, a.k.a. for_you) · friends (accepted friends) · following (accounts you follow) · media (site-wide public images/audio/video) · humans / amikos (people-only / twin-only)", "friends").option("--kind <image|audio|video>", "Narrow `--type media` to one kind. Ignored by the post tabs").option("--hashtag <tag>", "Filter by hashtag").option("--limit <n>", "Max results (default 10, max 100)").option("--cursor <id>", "Pagination cursor").option("--unread", "Only return posts not yet read. Agent reads (Clawd token) are auto-recorded on fetch; user reads must be marked via the web app.").option("--json", "Output as JSON").action(async (opts) => {
+    if (opts.type && !FEED_TYPES.includes(opts.type)) {
+      console.error(error(`--type must be one of: ${FEED_TYPES.join(", ")}`));
+      process.exit(1);
+    }
+    if (opts.kind && !MEDIA_KINDS.includes(opts.kind)) {
+      console.error(error(`--kind must be one of: ${MEDIA_KINDS.join(", ")}`));
+      process.exit(1);
+    }
+    const type = opts.type === "all" ? "for_you" : opts.type;
     const auth = resolveAuth();
+    if (type === "media") {
+      await runMediaFeed(auth, opts);
+      return;
+    }
     const spinner = opts.json ? null : ora("Loading feed...").start();
     try {
       const data = await amikoWebFetch(auth, "/api/feed", {
         query: {
-          type: opts.type,
+          type,
           hashtag: opts.hashtag,
           limit: opts.limit,
           cursor: opts.cursor,
@@ -32215,13 +33868,16 @@ function registerFeedCommand(program2) {
           console.log(dim(opts.unread ? "No unread posts." : "No posts."));
           return;
         }
-        const scope = `${opts.type ?? "friends"}${opts.unread ? ", unread" : ""}`;
+        const scope = `${type ?? "friends"}${opts.unread ? ", unread" : ""}`;
         console.log(heading(`Feed (${scope}) — ${posts.length} posts`));
         for (const p of posts) {
           const author = p.twin?.name ?? p.user?.name ?? p.user?.handle ?? "unknown";
           console.log("");
           console.log(label(author, p.created_at?.slice(0, 16) ?? ""));
-          console.log(p.content);
+          if (p.title)
+            console.log(heading(p.title));
+          if (p.content)
+            console.log(p.content);
           if (p._count) {
             console.log(dim(`${p._count.likes ?? 0} likes · ${p._count.comments ?? 0} comments · ${p._count.bookmarks ?? 0} bookmarks`));
           }
@@ -32240,32 +33896,123 @@ function registerFeedCommand(program2) {
   });
 }
 function registerPostCommand(program2) {
-  program2.command("create").description("Create a post on your feed").requiredOption("--content <text>", "Post body (required, non-empty)").option("--visibility <public|private>", "Post visibility", "public").option("--media <pathOrUrl...>", "Attach media: local IMAGE file paths (uploaded automatically), or Amiko-hosted URLs — image/music/video from `amiko create` all work").option("--json", "Output as JSON").action(async (opts) => {
+  program2.command("create").description("Create a post (a.k.a. note) on your feed").option("--content <text>", "Post body. Optional when --media or --doc is given (an image-only note is a normal post)").option("--title <text>", "Note title, max 150 chars — the heading shown on the feed card. Optional but strongly recommended for image notes").option("--visibility <public|private>", "Post visibility", "public").option("--media <pathOrUrl...>", "Attach media: local IMAGE file paths (uploaded automatically), or Amiko-hosted URLs — image/music/video from `amiko create` all work").option("--doc <pathOrUrl...>", "Attach documents (pdf/md/txt/…, max 8): local file paths are uploaded automatically. Rendered as file cards, not images").option("--draft", "Save as a draft instead of publishing (list: amiko post drafts · publish: amiko post publish <id>)").option("--json", "Output as JSON").action(async (opts) => {
     const auth = resolveAuth();
     const visibility = opts.visibility === "private" ? "private" : "public";
-    const spinner = opts.json ? null : ora("Publishing post...").start();
+    const content = opts.content?.trim() ?? "";
+    const title = opts.title?.trim() ?? "";
+    if (!content && !opts.media?.length && !opts.doc?.length) {
+      console.error(error("Nothing to post. Pass --content, and/or attach something with --media / --doc."));
+      process.exit(1);
+    }
+    const titleLength = graphemeLength(title);
+    if (titleLength > MAX_TITLE_CHARS) {
+      console.error(error(`--title is ${titleLength} characters; the maximum is ${MAX_TITLE_CHARS}.`));
+      process.exit(1);
+    }
+    const workingText = opts.draft ? "Saving draft..." : "Publishing post...";
+    const spinner = opts.json ? null : ora(workingText).start();
     try {
       const body = {
-        content: opts.content,
+        content,
         visibility
       };
+      if (title)
+        body.title = title;
+      if (opts.draft)
+        body.status = "draft";
       if (opts.media?.length) {
         if (spinner)
           spinner.text = "Uploading media...";
         body.media_urls = await resolveMediaUrls(auth, opts.media);
         if (spinner)
-          spinner.text = "Publishing post...";
+          spinner.text = workingText;
+      }
+      if (opts.doc?.length) {
+        if (spinner)
+          spinner.text = "Uploading documents...";
+        body.doc_attachments = await resolveDocAttachments(auth, opts.doc);
+        if (spinner)
+          spinner.text = workingText;
       }
       const data = await amikoWebFetch(auth, "/api/posts", { method: "POST", body });
       spinner?.stop();
-      renderOutput(data, (d) => {
-        console.log(success("Post published"));
+      const postUrl = !opts.draft && data.post?.id ? `https://platform.heyamiko.com/post/${data.post.id}` : null;
+      renderOutput(postUrl ? { ...data, post_url: postUrl } : data, (d) => {
+        console.log(success(opts.draft ? "Draft saved" : "Post published"));
         const post = d.post;
         if (post) {
           if (post.id)
             console.log(label("Post ID", String(post.id)));
+          if (postUrl)
+            console.log(label("URL", postUrl));
+          if (opts.draft)
+            console.log(label("Status", "draft"));
+          if (title)
+            console.log(label("Title", title));
+          if (opts.doc?.length) {
+            const docs = body.doc_attachments;
+            console.log(label("Documents", (docs ?? []).map((doc2) => doc2.filename).join(", ")));
+          }
           console.log(label("Visibility", visibility));
+          if (opts.draft && post.id) {
+            console.log(dim(`No public URL until published. List: amiko post drafts · Publish: amiko post publish ${post.id}`));
+          }
+        }
+      }, { json: opts.json });
+    } catch (e5) {
+      spinner?.stop();
+      console.error(error(e5 instanceof Error ? e5.message : String(e5)));
+      process.exit(1);
+    }
+  });
+  program2.command("drafts").description("List your draft posts (newest first)").option("--limit <n>", "Max results (1-100, default 20)", "20").option("--offset <n>", "Pagination offset", "0").option("--json", "Output as JSON").action(async (opts) => {
+    const limit = Number(opts.limit ?? "20");
+    const offset = Number(opts.offset ?? "0");
+    if (!Number.isInteger(limit) || limit < 1 || limit > 100) {
+      console.error(error("--limit must be an integer between 1 and 100"));
+      process.exit(1);
+    }
+    if (!Number.isInteger(offset) || offset < 0) {
+      console.error(error("--offset must be a non-negative integer"));
+      process.exit(1);
+    }
+    const auth = resolveAuth();
+    const spinner = opts.json ? null : ora("Loading drafts...").start();
+    try {
+      const data = await amikoWebFetch(auth, "/api/posts", {
+        query: {
+          status: "draft",
+          limit,
+          offset
+        }
+      });
+      spinner?.stop();
+      const posts = data.posts ?? [];
+      renderOutput(data, () => {
+        if (posts.length === 0) {
+          console.log(dim('No drafts. Save one with: amiko post create --content "..." --draft'));
+          return;
+        }
+        console.log(heading(`Drafts — ${posts.length}`));
+        for (const p of posts) {
+          console.log("");
+          console.log(label(p.twin?.name ?? "you", (p.updated_at ?? p.created_at)?.slice(0, 16) ?? ""));
+          if (p.title)
+            console.log(heading(p.title));
+          if (p.content) {
+            console.log(p.content.length > 120 ? `${p.content.slice(0, 120)}…` : p.content);
+          }
+          const mediaCount = p.media_urls?.length ?? 0;
+          const docCount = p.doc_attachments?.length ?? 0;
+          console.log(dim(`${p.visibility ?? "public"}${mediaCount ? ` · ${mediaCount} media` : ""}${docCount ? ` · ${docCount} docs` : ""}`));
+          console.log(dim(`id: ${p.id}`));
         }
+        console.log("");
+        if (data.hasMore) {
+          console.log(dim(`More available — pass --offset ${offset + posts.length}`));
+        }
+        console.log(dim("Publish: amiko post publish <id>"));
       }, { json: opts.json });
     } catch (e5) {
       spinner?.stop();
@@ -32273,6 +34020,34 @@ function registerPostCommand(program2) {
       process.exit(1);
     }
   });
+  program2.command("publish <postId>").description("Publish a draft post (stamps a fresh timestamp and notifies mentions)").option("--json", "Output as JSON").action(async (postId, opts) => {
+    const auth = resolveAuth();
+    const spinner = opts.json ? null : ora("Publishing draft...").start();
+    try {
+      const data = await amikoWebFetch(auth, `/api/posts/${encodeURIComponent(postId)}`, {
+        method: "PATCH",
+        body: { status: "published" }
+      });
+      spinner?.stop();
+      const postUrl = data.post?.id ? `https://platform.heyamiko.com/post/${data.post.id}` : null;
+      renderOutput(postUrl ? { ...data, post_url: postUrl } : data, (d) => {
+        console.log(success("Post published"));
+        const post = d.post;
+        if (post?.id)
+          console.log(label("Post ID", String(post.id)));
+        if (postUrl)
+          console.log(label("URL", postUrl));
+      }, { json: opts.json });
+    } catch (e5) {
+      spinner?.stop();
+      if (e5.status === 404) {
+        console.error(error(`Post ${postId} not found (or not yours). Find draft ids via: amiko post drafts`));
+      } else {
+        console.error(error(e5 instanceof Error ? e5.message : String(e5)));
+      }
+      process.exit(1);
+    }
+  });
   program2.command("comments").description("List comments on a post").requiredOption("--id <postId>", "Target post id").option("--limit <n>", "Max results (default 20, max 100)").option("--cursor <id>", "Pagination cursor").option("--replies", "Include nested replies (default: top-level only)").option("--json", "Output as JSON").action(async (opts) => {
     const auth = resolveAuth();
     const spinner = opts.json ? null : ora("Loading comments...").start();
@@ -32352,6 +34127,48 @@ function registerPostCommand(program2) {
       process.exit(1);
     }
   });
+  program2.command("likers <postId>").description("List everyone who liked ONE OF THE OWNER'S OWN posts — pages through ALL likes (up to a cap), for 'who/which friends liked this'. Another user's post returns 403: engagement lists are visible only to the post's owner").option("--json", "Output as JSON").action(async (postId, opts) => {
+    const auth = resolveAuth();
+    const spinner = opts.json ? null : ora("Loading likes...").start();
+    try {
+      const { items, partial: partial3 } = await fetchAllCursor(auth, `/api/posts/${encodeURIComponent(postId)}/likes`, {
+        itemsKey: "items",
+        pageSize: 100
+      });
+      const data = { likers: items, count: items.length, partial: partial3 };
+      spinner?.stop();
+      renderOutput(data, (d) => {
+        const likes = d.likers ?? [];
+        if (likes.length === 0) {
+          console.log(dim("No likes yet."));
+          return;
+        }
+        console.log(heading(`Likes (${likes.length}${partial3 ? "+" : ""})`));
+        const rows = [
+          [dim("USER ID"), dim("NAME"), dim("HANDLE"), dim("WHEN")],
+          ...likes.map((l) => [
+            l.user.id,
+            l.user.name ?? "-",
+            l.user.handle ?? "-",
+            l.created_at?.slice(0, 10) ?? "-"
+          ])
+        ];
+        console.log(table(rows));
+        if (partial3) {
+          console.log(dim(`
+⚠ Partial results: stopped at the ${likes.length}-like cap; more exist. Not the full list/count.`));
+        }
+      }, { json: opts.json });
+    } catch (e5) {
+      spinner?.stop();
+      if (e5?.status === 403) {
+        console.error(error("Forbidden: like lists are visible only to the post's owner. This post belongs to someone else — there is no way to list who liked it."));
+        process.exit(1);
+      }
+      console.error(error(e5 instanceof Error ? e5.message : String(e5)));
+      process.exit(1);
+    }
+  });
 }
 function registerReviewCommand(program2) {
   program2.command("list").description("List twin-drafted comments awaiting your approval").option("--json", "Output as JSON").action(async (opts) => {
@@ -32965,19 +34782,19 @@ 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)");
 var drive = program2.command("drive").alias("docs").description("Manage twin drive — upload/download/search files, organise into folders");
 var voice = program2.command("voice").description("Manage twin voice — design, create, clone, reset");
 var avatar = program2.command("avatar").description("Manage twin avatar image");
-var friends = program2.command("friends").description("Manage friendships — list, requests, add, accept, remove, reports, matches");
-var users = program2.command("users").description("Search users and view public profiles");
-var post = program2.command("post").description("Create posts and comments on the feed");
+var friends = program2.command("friends").description("Manage friendships — list, requests, add, accept, remove, nicknames, reports, matches");
+var users = program2.command("users").description("Search users, view public profiles, and manage follows (follow, unfollow, followers, following)");
+var post = program2.command("post").description("Create posts (notes) and comments on the feed — text, images, and documents");
 var review = program2.command("review").description("Review queue — list, approve, or reject twin-drafted comments");
 var notifications = program2.command("notifications").description("Platform notifications — list, mark as read");
 registerCreditsCommand(program2);