@heyamiko/amiko-cli 0.12.0-beta.5 → 0.12.0-beta.7

package/README.md

@@ -1,4 +1,4 @@
-# @heyamiko/amiko-cli (v0.12.0-beta.5)
+# @heyamiko/amiko-cli (v0.12.0-beta.7)
 
 Manage wallets, credits, swaps, MPP marketplace services, and your Amiko twin (identity, documents, voice, avatar, friends, feed) from the terminal. Works for both human users and AI agents running on OpenClaw.
 
@@ -206,7 +206,7 @@ amiko create media --service video --limit 5
 - **`amiko create media`** — lists your recent Create Studio generations (URL, type, model, prompt, date). `--service <type>` filters, `--limit <n>` caps (max 50), `--raw` for JSON. Use this once a job id has expired, or just to browse.
 - **Web:** `https://platform.heyamiko.com/media`
 
-**`--wait`** — if you'd rather block until it finishes and print the asset inline (e.g. an interactive terminal), pass `--wait`. It polls (10 min cap for video, 5 min otherwise) with a `…still generating (Ns)` tick; on timeout it falls back to the job-id + retrieval hint above. `--raw` prints the full job result as JSON either way.
+`create` is always non-blocking — there is no `--wait`. `--raw` prints the submit result (`{ jobId, status, check, eta }`) as JSON.
 
 > `amiko markets image` still exists and is unchanged — it's the direct MPP pay-per-call path (pre-pay in AMIKO). Use `amiko create` for the Create Studio experience (async, charge-on-success); use `amiko markets` for raw MPP endpoints.
 
@@ -230,6 +230,26 @@ amiko chat send @sophie "made this 🎵" --audio <generated-url> --yes  # attach
 - **Inline media**: `--image <pathOrUrl>` (jpg/png/webp/gif, local ≤10MB or an Amiko URL) and `--audio <pathOrUrl>` (local ≤25MB or an Amiko URL → sent as a voice note). One media block per message (image *or* audio). **Video isn't supported in chat yet.** A local file is uploaded; an Amiko URL (e.g. a generated asset from `amiko create`) attaches directly with no re-upload. (A local *audio* file is sent as a voice note, with your text as a separate message.)
 - `chat send` messages a real person, so it's **gated on `--yes`** in non-interactive shells. Delivery is real-time. `--raw` prints raw JSON on any subcommand.
 
+## Twin Cards
+
+Generate, view, download, and mint your **Twin Card** (template `twins_take`, flavors **work / play / love**).
+
+```bash
+amiko card templates                              # available flavors (DB-managed)
+amiko card create --flavor work                   # generate → prints slug + share link
+amiko card create --flavor love --reroll 1        # a fresh take
+amiko card list                                   # your latest card
+amiko card show <slug>                            # stored card data (JSON)
+amiko card image <slug> --flavor work --out card.png   # download the PNG
+amiko card share <slug>                           # print https://platform.heyamiko.com/s/<slug>
+amiko card mint <slug> --flavor work --yes        # mint as an NFT (gated on --yes)
+amiko card mint <slug> --status                   # check an existing mint
+```
+
+- Flavor defaults to `love`; flavors are DB-managed — `card templates` lists the valid ones.
+- `create` errors are user-fixable and exit with **code 2** (not a crash): `profile_not_ready`, `guardrails_failed`, `rate_limited` (reroll cooldown).
+- `card mint` creates an on-chain NFT → **gated on `--yes`**. All subcommands support `--json`.
+
 ## Amazon
 
 ```bash

package/dist/index.js

@@ -28589,7 +28589,6 @@ function registerImageCommand(program2) {
 }
 
 // src/commands/create.ts
-var POLL_INTERVAL_MS = 3000;
 var ETA = {
   IMAGE: "~15–60s",
   VIDEO: "~2–9 min",
@@ -28617,7 +28616,7 @@ function printCompleted(final, title) {
   }
   console.log(dim("View in your media space: https://platform.heyamiko.com/media"));
 }
-async function submitAndPoll(opts) {
+async function submitCreateJob(opts) {
   let auth;
   try {
     auth = requireAuth();
@@ -28644,27 +28643,7 @@ async function submitAndPoll(opts) {
   });
   const isTTY = process.stderr.isTTY;
   const spinner = isTTY ? ora("Submitting…").start() : null;
-  let progressTimer = null;
-  const started = Date.now();
-  const setStatus = (text) => {
-    if (spinner)
-      spinner.text = text;
-    else
-      console.error(text);
-  };
-  const startTicker = () => {
-    if (!spinner && !progressTimer) {
-      progressTimer = setInterval(() => {
-        const elapsed = Math.round((Date.now() - started) / 1000);
-        console.error(`  …still generating (${elapsed}s elapsed)`);
-      }, 3000);
-    }
-  };
   const stop = () => {
-    if (progressTimer) {
-      clearInterval(progressTimer);
-      progressTimer = null;
-    }
     if (spinner)
       spinner.stop();
   };
@@ -28686,68 +28665,28 @@ async function submitAndPoll(opts) {
     console.error(error(e5 instanceof Error ? e5.message : "Submit failed"));
     process.exit(1);
   }
-  if (!opts.wait) {
-    stop();
-    if (opts.raw) {
-      console.log(JSON.stringify({
-        jobId,
-        status: "PENDING",
-        check: `amiko create status ${jobId}`,
-        eta: ETA[opts.mode]
-      }, 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}`));
-    console.log(dim(`Usually ready in ${ETA[opts.mode]} — charged only on success. (Also: amiko create media)`));
-    return;
-  }
-  setStatus("Generating…");
-  startTicker();
-  const maxMs = opts.mode === "VIDEO" ? 600000 : 300000;
-  let final = null;
-  while (Date.now() - started < maxMs) {
-    await new Promise((r) => setTimeout(r, POLL_INTERVAL_MS));
-    try {
-      const p = await amikoWebFetch(auth, `/api/create/jobs/${encodeURIComponent(jobId)}`, { timeoutMs: 15000 });
-      if (p.status === "COMPLETED" || p.status === "FAILED") {
-        final = p;
-        break;
-      }
-    } catch (e5) {
-      const s = statusOf(e5);
-      if (s === 401 || s === 404) {
-        stop();
-        console.error(error(e5 instanceof Error ? e5.message : "Poll failed"));
-        process.exit(1);
-      }
-    }
-  }
   stop();
-  if (!final) {
-    console.error(error("Timed out waiting for the job. It may still be generating — check your media space at https://platform.heyamiko.com/media before retrying."));
-    console.log(dim(`Job id: ${jobId}`));
-    process.exit(1);
-  }
   if (opts.raw) {
-    console.log(JSON.stringify(final, null, 2));
+    console.log(JSON.stringify({
+      jobId,
+      status: "PENDING",
+      check: `amiko create status ${jobId}`,
+      eta: ETA[opts.mode]
+    }, null, 2));
     return;
   }
-  if (final.status === "FAILED") {
-    console.error(error(final.error ?? "Generation failed (you were not charged)."));
-    process.exit(1);
-  }
-  printCompleted(final, `${opts.mode[0]}${opts.mode.slice(1).toLowerCase()} created`);
+  console.log(success(`Submitted — job ${jobId}`));
+  console.log(label("Status", "PENDING — generating in the background"));
+  console.log(label("Check result", `amiko create status ${jobId}`));
+  console.log(dim(`Usually ready in ${ETA[opts.mode]} — charged only on success. (Also: amiko create media)`));
 }
 function registerCreateCommand(create2) {
-  create2.command("image <prompt>").description("Generate an image (Create Studio)").option("--model <model>", "Image model", "gpt-image-2").option("--aspect <ratio>", "Aspect ratio: 1:1, 16:9, 9:16, 4:3, 3:4", "1:1").option("--token <symbol>", "Preferred charge token: AMIKO, USDC, USDT, SOL").option("--raw", "Output raw JSON").option("--yes", "Skip the pre-spend confirmation (required in non-interactive shells)").option("--wait", "Block until generation finishes and print the asset (default: return a job id immediately)").action(async (prompt, opts) => {
-    await submitAndPoll({
+  create2.command("image <prompt>").description("Generate an image (Create Studio)").option("--model <model>", "Image model", "gpt-image-2").option("--aspect <ratio>", "Aspect ratio: 1:1, 16:9, 9:16, 4:3, 3:4", "1:1").option("--token <symbol>", "Preferred charge token: AMIKO, USDC, USDT, SOL").option("--raw", "Output raw JSON").option("--yes", "Skip the pre-spend confirmation (required in non-interactive shells)").action(async (prompt, opts) => {
+    await submitCreateJob({
       mode: "IMAGE",
       summary: `Create image: ${prompt.slice(0, 80)}${prompt.length > 80 ? "…" : ""}`,
       raw: opts.raw,
       yes: opts.yes,
-      wait: opts.wait,
       quoteBody: { mode: "IMAGE", model: opts.model, size: opts.aspect },
       jobBody: {
         mode: "IMAGE",
@@ -28758,18 +28697,17 @@ function registerCreateCommand(create2) {
       }
     });
   });
-  create2.command("video <prompt>").description("Generate a video (Create Studio)").option("--model <model>", "Video model", "MiniMax-Hailuo-2.3-Fast").option("--resolution <res>", "512P, 720P, 768P, 1080P", "768P").option("--seconds <n>", "Clip length: 6 or 10", "6").option("--aspect <ratio>", "Aspect ratio (provider-dependent)").option("--first-frame <url>", "Image-to-video: first frame URL/data URI").option("--token <symbol>", "Preferred charge token: AMIKO, USDC, USDT, SOL").option("--raw", "Output raw JSON").option("--yes", "Skip the pre-spend confirmation (required in non-interactive shells)").option("--wait", "Block until generation finishes and print the asset (default: return a job id immediately)").action(async (prompt, opts) => {
+  create2.command("video <prompt>").description("Generate a video (Create Studio)").option("--model <model>", "Video model", "MiniMax-Hailuo-2.3-Fast").option("--resolution <res>", "512P, 720P, 768P, 1080P", "768P").option("--seconds <n>", "Clip length: 6 or 10", "6").option("--aspect <ratio>", "Aspect ratio (provider-dependent)").option("--first-frame <url>", "Image-to-video: first frame URL/data URI").option("--token <symbol>", "Preferred charge token: AMIKO, USDC, USDT, SOL").option("--raw", "Output raw JSON").option("--yes", "Skip the pre-spend confirmation (required in non-interactive shells)").action(async (prompt, opts) => {
     const seconds = Number(opts.seconds);
     if (seconds !== 6 && seconds !== 10) {
       console.error(error("--seconds must be 6 or 10."));
       process.exit(1);
     }
-    await submitAndPoll({
+    await submitCreateJob({
       mode: "VIDEO",
       summary: `Create video: ${prompt.slice(0, 80)}${prompt.length > 80 ? "…" : ""}`,
       raw: opts.raw,
       yes: opts.yes,
-      wait: opts.wait,
       quoteBody: {
         mode: "VIDEO",
         model: opts.model,
@@ -28788,13 +28726,12 @@ 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)").option("--wait", "Block until generation finishes and print the asset (default: return a job id immediately)").action(async (text, opts) => {
-    await submitAndPoll({
+  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) => {
+    await submitCreateJob({
       mode: "TTS",
       summary: `Create speech: ${text.slice(0, 80)}${text.length > 80 ? "…" : ""}`,
       raw: opts.raw,
       yes: opts.yes,
-      wait: opts.wait,
       quoteBody: { mode: "TTS", model: opts.model, prompt: text },
       jobBody: {
         mode: "TTS",
@@ -28805,17 +28742,16 @@ function registerCreateCommand(create2) {
       }
     });
   });
-  create2.command("music [prompt]").description("Generate music (Create Studio)").option("--model <model>", "music_v1, music-2.6, music-cover", "music-2.6").option("--lyrics <lyrics>", "Lyrics (optional)").option("--duration <ms>", "Length in ms").option("--instrumental", "Instrumental (no vocals)").option("--token <symbol>", "Preferred charge token: AMIKO, USDC, USDT, SOL").option("--raw", "Output raw JSON").option("--yes", "Skip the pre-spend confirmation (required in non-interactive shells)").option("--wait", "Block until generation finishes and print the asset (default: return a job id immediately)").action(async (prompt, opts) => {
+  create2.command("music [prompt]").description("Generate music (Create Studio)").option("--model <model>", "music_v1, music-2.6, music-cover", "music-2.6").option("--lyrics <lyrics>", "Lyrics (optional)").option("--duration <ms>", "Length in ms").option("--instrumental", "Instrumental (no vocals)").option("--token <symbol>", "Preferred charge token: AMIKO, USDC, USDT, SOL").option("--raw", "Output raw JSON").option("--yes", "Skip the pre-spend confirmation (required in non-interactive shells)").action(async (prompt, opts) => {
     if (!prompt && !opts.lyrics) {
       console.error(error("Provide a prompt or --lyrics."));
       process.exit(1);
     }
-    await submitAndPoll({
+    await submitCreateJob({
       mode: "MUSIC",
       summary: `Create music: ${(prompt ?? opts.lyrics ?? "").slice(0, 80)}`,
       raw: opts.raw,
       yes: opts.yes,
-      wait: opts.wait,
       quoteBody: { mode: "MUSIC", model: opts.model },
       jobBody: {
         mode: "MUSIC",
@@ -28828,13 +28764,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)").option("--wait", "Block until generation finishes and print the asset (default: return a job id immediately)").action(async (text, opts) => {
-    await submitAndPoll({
+  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) => {
+    await submitCreateJob({
       mode: "SFX",
       summary: `Create SFX: ${text.slice(0, 80)}${text.length > 80 ? "…" : ""}`,
       raw: opts.raw,
       yes: opts.yes,
-      wait: opts.wait,
       quoteBody: { mode: "SFX" },
       jobBody: {
         mode: "SFX",
@@ -29255,6 +29190,218 @@ function registerChatCommand(chat) {
   });
 }
 
+// src/commands/card.ts
+import { writeFile } from "node:fs/promises";
+var TEMPLATE_ID = "twins_take";
+var DEFAULT_FLAVOR = "love";
+function authOrExit2() {
+  try {
+    return requireAuth();
+  } catch (e5) {
+    console.error(error(e5 instanceof Error ? e5.message : "auth failed"));
+    process.exit(1);
+  }
+}
+function platformBase(auth) {
+  return (auth.platformUrl ?? "https://platform.heyamiko.com").replace(/\/$/, "");
+}
+function cardErrorExit(e5) {
+  const err = e5;
+  let body = {};
+  try {
+    body = JSON.parse(err?.body ?? "{}");
+  } catch {}
+  const code = body.error ?? "";
+  const map2 = {
+    profile_not_ready: {
+      msg: "Your Amiko profile isn't complete enough to generate a card yet — flesh out your profile first.",
+      exit: 2
+    },
+    guardrails_failed: {
+      msg: "Content guardrails didn't pass — try again, or a different --flavor.",
+      exit: 2
+    },
+    rate_limited: {
+      msg: `Card generation is rate-limited right now — try again later${body.retry_after_seconds ? ` (~${body.retry_after_seconds}s)` : ""}.`,
+      exit: 2
+    },
+    unknown_flavor: {
+      msg: "Unknown flavor. Run `amiko card templates` to see the valid flavors.",
+      exit: 1
+    },
+    unknown_template: { msg: "Only the twins_take card can be generated.", exit: 1 },
+    template_not_generatable: {
+      msg: "Only the twins_take card can be generated.",
+      exit: 1
+    }
+  };
+  const hit = map2[code];
+  if (hit) {
+    console.error(error(hit.msg));
+    process.exit(hit.exit);
+  }
+  console.error(error(e5 instanceof Error ? e5.message : "Card request failed"));
+  process.exit(1);
+}
+function registerCardCommand(card) {
+  card.command("templates").description("List the available card flavors (work / play / love)").option("--json", "Output raw JSON").action(async (opts) => {
+    const auth = authOrExit2();
+    let data;
+    try {
+      data = await amikoWebFetch(auth, "/api/twin-cards/templates", {
+        timeoutMs: 15000
+      });
+    } catch (e5) {
+      cardErrorExit(e5);
+    }
+    if (opts.json) {
+      console.log(JSON.stringify(data, null, 2));
+      return;
+    }
+    const flavors = data.templates ?? [];
+    if (flavors.length === 0) {
+      console.log(dim("No flavors available."));
+      return;
+    }
+    console.log(heading(`Card flavors (${flavors.length})
+`));
+    for (const f of flavors)
+      console.log(label(f.key, f.name ?? ""));
+  });
+  card.command("list").description("Show your most recently generated card").option("--json", "Output raw JSON").action(async (opts) => {
+    const auth = authOrExit2();
+    let data;
+    try {
+      data = await amikoWebFetch(auth, "/api/twin-cards/me", {
+        timeoutMs: 15000
+      });
+    } catch (e5) {
+      cardErrorExit(e5);
+    }
+    if (opts.json) {
+      console.log(JSON.stringify(data, null, 2));
+      return;
+    }
+    if (!data.slug) {
+      console.log(dim("No card yet — generate one with `amiko card create`."));
+      return;
+    }
+    console.log(heading(`Your latest card
+`));
+    console.log(label("Slug", data.slug));
+    console.log(label("Flavors", Object.keys(data.cards ?? {}).join(", ") || "-"));
+    if (data.generated_at)
+      console.log(label("Generated", data.generated_at));
+    console.log(label("Share", `${platformBase(auth)}/s/${data.slug}`));
+  });
+  card.command("create").description("Generate (or reroll) your Twin Card").option("--flavor <flavor>", "Flavor: work, play, love (DB-managed; see `card templates`)", DEFAULT_FLAVOR).option("--reroll <n>", "Reroll number (≥0) for a fresh take", "0").option("--json", "Output raw JSON").action(async (opts) => {
+    const auth = authOrExit2();
+    let data;
+    try {
+      data = await amikoWebFetch(auth, "/api/share/generate-card", {
+        method: "POST",
+        body: {
+          template_id: TEMPLATE_ID,
+          flavor: opts.flavor,
+          reroll_number: Math.max(0, Math.floor(Number(opts.reroll) || 0))
+        },
+        timeoutMs: 120000
+      });
+    } catch (e5) {
+      cardErrorExit(e5);
+    }
+    if (opts.json) {
+      console.log(JSON.stringify(data, null, 2));
+      return;
+    }
+    console.log(heading(`${opts.flavor} card ready
+`));
+    if (data.slug) {
+      console.log(label("Slug", data.slug));
+      console.log(label("Share", `${platformBase(auth)}/s/${data.slug}`));
+      console.log(dim(`Image: amiko card image ${data.slug} --flavor ${opts.flavor}`));
+    }
+  });
+  card.command("show <slug>").description("Read a card's stored data").option("--json", "Output raw JSON").action(async (slug, opts) => {
+    const auth = authOrExit2();
+    let data;
+    try {
+      data = await amikoWebFetch(auth, `/api/share/${encodeURIComponent(slug)}`, { timeoutMs: 15000 });
+    } catch (e5) {
+      cardErrorExit(e5);
+    }
+    console.log(JSON.stringify(data, null, 2));
+  });
+  card.command("image <slug>").description("Download the card image (PNG)").option("--flavor <flavor>", "Flavor: work, play, love", DEFAULT_FLAVOR).option("--out <path>", "Output file (default: card-<slug>-<flavor>.png)").action(async (slug, opts) => {
+    const auth = authOrExit2();
+    const url2 = `${platformBase(auth)}/api/share/${encodeURIComponent(slug)}/image?flavor=${encodeURIComponent(opts.flavor)}`;
+    let buf;
+    try {
+      const res = await fetch(url2, {
+        headers: { Authorization: `Bearer ${auth.twinToken ?? ""}` },
+        signal: AbortSignal.timeout(60000)
+      });
+      if (!res.ok) {
+        console.error(error(`Failed to fetch card image: ${res.status} ${res.statusText}`));
+        process.exit(1);
+      }
+      buf = Buffer.from(await res.arrayBuffer());
+    } catch (e5) {
+      console.error(error(e5 instanceof Error ? e5.message : "Image download failed"));
+      process.exit(1);
+    }
+    const out = opts.out ?? `card-${slug}-${opts.flavor}.png`;
+    await writeFile(out, buf);
+    console.log(success(`Saved ${buf.length.toLocaleString()} bytes → ${out}`));
+  });
+  card.command("mint <slug>").description("Mint a card as an NFT (or --status to check an existing mint)").option("--flavor <flavor>", "Flavor: work, play, love", DEFAULT_FLAVOR).option("--name <name>", "NFT name (optional)").option("--description <desc>", "NFT description (optional)").option("--status", "Check mint status instead of minting").option("--yes", "Skip the confirmation (required in non-interactive shells)").option("--json", "Output raw JSON").action(async (slug, opts) => {
+    const auth = authOrExit2();
+    if (opts.status) {
+      let data2;
+      try {
+        data2 = await amikoWebFetch(auth, `/api/share/twin-cards/mint?slug=${encodeURIComponent(slug)}`, { timeoutMs: 15000 });
+      } catch (e5) {
+        cardErrorExit(e5);
+      }
+      console.log(JSON.stringify(data2, null, 2));
+      return;
+    }
+    await requireApproval({
+      cost: "mints an on-chain NFT (cNFT) from your twin card",
+      summary: `Mint ${opts.flavor} card ${slug} as an NFT`,
+      yes: opts.yes,
+      commandExample: `amiko card mint ${slug} --flavor ${opts.flavor}`
+    });
+    let data;
+    try {
+      data = await amikoWebFetch(auth, "/api/share/twin-cards/mint", {
+        method: "POST",
+        body: {
+          slug,
+          flavor: opts.flavor,
+          ...opts.name ? { name: opts.name } : {},
+          ...opts.description ? { description: opts.description } : {}
+        },
+        timeoutMs: 120000
+      });
+    } catch (e5) {
+      cardErrorExit(e5);
+    }
+    if (opts.json) {
+      console.log(JSON.stringify(data, null, 2));
+      return;
+    }
+    console.log(success(`Mint ${data.status ?? "submitted"}`));
+    if (data.mint_address)
+      console.log(label("Mint", data.mint_address));
+    console.log(dim(`Check status: amiko card mint ${slug} --status`));
+  });
+  card.command("share <slug>").description("Print the public share link for a card").action(async (slug) => {
+    const auth = authOrExit2();
+    console.log(`${platformBase(auth)}/s/${slug}`);
+  });
+}
+
 // src/commands/amazon.ts
 var TREASURY3 = "FPiZAf3jEnNfCwfvbv46jdPfHbmSepD4Q6iHiLJDQXvb";
 async function payAmiko(auth, wallet, amount2) {
@@ -29803,7 +29950,7 @@ function registerTwinCommand(program2) {
 }
 
 // src/commands/drive.ts
-import { writeFile } from "node:fs/promises";
+import { writeFile as writeFile2 } from "node:fs/promises";
 import { basename as basename2, resolve as resolvePath } from "node:path";
 function fmtBytes(n) {
   if (!n || n <= 0)
@@ -30016,7 +30163,7 @@ Search hits filename, title, description, and parsed RAG content (once processed
         return;
       }
       const outPath = resolvePath(opts.out ?? basename2(meta3.doc.filename));
-      await writeFile(outPath, buf);
+      await writeFile2(outPath, buf);
       spinner?.stop();
       console.log(success(`Saved ${meta3.doc.filename} → ${outPath}`));
       console.log(label("Size", fmtBytes(buf.length)));
@@ -32039,6 +32186,7 @@ program2.name("amiko").description("Amiko CLI — swap tokens, manage credits, b
 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 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");
@@ -32054,6 +32202,7 @@ registerSearchCommand(markets);
 registerImageCommand(markets);
 registerCreateCommand(create2);
 registerChatCommand(chat);
+registerCardCommand(card);
 registerAmazonCommand(markets);
 registerWalletsCreateCommand(wallets);
 registerWalletsListCommand(wallets);

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@heyamiko/amiko-cli",
-  "version": "0.12.0-beta.5",
+  "version": "0.12.0-beta.7",
   "description": "Amiko CLI — swap tokens, manage credits, bridge cross-chain, and call marketplace agents",
   "type": "module",
   "bin": {

package/skills/SKILL.md

@@ -41,13 +41,13 @@ The CLI is installed globally and is pre-authenticated when you're inside your w
 
 ## Command groups
 
-Discover everything via `amiko --help`. Groups: `markets` (paid MPP services), `create` (Create Studio — async media generation, charged on success), `chat` (owner's DMs + group chats), `wallets`, `credits`, `twin`, `drive` (files / folders / RAG; `docs` is an alias), `voice`, `avatar`, `friends`, `users`, `post`, `review`, `feed`, `notifications`, `memory`, plus the top-level `accounts`, `info`, `config`, `update`. All twin-scoped commands accept `--twin <id>`. Most commands support `--json`.
+Discover everything via `amiko --help`. Groups: `markets` (paid MPP services), `create` (Create Studio — async media generation, charged on success), `chat` (owner's DMs + group chats), `card` (Twin Cards — work/play/love), `wallets`, `credits`, `twin`, `drive` (files / folders / RAG; `docs` is an alias), `voice`, `avatar`, `friends`, `users`, `post`, `review`, `feed`, `notifications`, `memory`, plus the top-level `accounts`, `info`, `config`, `update`. All twin-scoped commands accept `--twin <id>`. Most commands support `--json`.
 
 > **Two chat surfaces — pick by identity.** `amiko chat` is the **owner's** DMs and group chats, acting **as the owner** (list / read / send). The openhermit gateway's `session_list` / `session_send` are the **agent's own** sessions, acting **as the agent**. "Send a message to Sophie for me" → `amiko chat send`; "have the twin reply as itself" → gateway. (The old `amiko conversation` namespace was removed in 0.10.1-beta.4; `amiko chat` is its owner-identity replacement.)
 
 ## Critical Rules
 
-1. **Every paid / value-moving command is hard-gated on `--yes` in a non-interactive shell.** The CLI refuses to run `markets *`, `create *`, `chat send`, `credits topup`, `wallets swap send`, `wallets bridge send`, `wallets transfer` (and destructive ops like `twin update --public`, `drive delete`, `friends remove`, `friends reports request`, `avatar update`, `voice reset`, `review reject`) unless `--yes` is passed. The refusal prints the cost and the re-run command. **Quote the cost, get explicit approval, THEN append `--yes`.**
+1. **Every paid / value-moving command is hard-gated on `--yes` in a non-interactive shell.** The CLI refuses to run `markets *`, `create *`, `chat send`, `card mint`, `credits topup`, `wallets swap send`, `wallets bridge send`, `wallets transfer` (and destructive ops like `twin update --public`, `drive delete`, `friends remove`, `friends reports request`, `avatar update`, `voice reset`, `review reject`) unless `--yes` is passed. The refusal prints the cost and the re-run command. **Quote the cost, get explicit approval, THEN append `--yes`.**
 2. **After every paid command, report the remaining balance.** The CLI prints a `Balance: N credits` line — include that figure in your reply.
 3. **Never retry a failed command.** Report and stop. Every paid call costs tokens even on failure.
 4. **Auth is automatic.** Never suggest `amiko login` / `amiko connect`. Run from the agent's workspace folder; if anything looks off, `amiko accounts` shows the resolved `userId` / `twinId`.
@@ -94,7 +94,7 @@ All paid markets commands auto-select the twin's active Solana wallet (see `--wa
 
 ## Create Studio — behavior notes
 
-`amiko create <image|video|tts|music|sfx>` is the CLI half of the platform Create Studio. It generates through Amiko's own authenticated endpoints (not raw MPP), runs **async**, and is **charged on success** from the twin's custodial wallet — a failed or timed-out generation is **never billed**, and there is no pre-pay. **The command returns immediately** with a `jobId` and `status: PENDING` — it does NOT block for the whole generation (so you're not held for 60s–9min). It prints how to check + a rough ETA. **Poll for the result** with `amiko create status <jobId>` (re-query that job, ~24h) — wait roughly: image ~15–60s, video ~2–9min, music ~30–120s, tts/sfx ~5–20s. Or `amiko create media` (list recent generations; `--service`/`--limit`/`--raw`). Result is a permanent Supabase Storage URL. (Pass `--wait` only if you deliberately want the command to block until done.) `--token <AMIKO|USDC|USDT|SOL>` selects the charge token (default auto, AMIKO-first). Prefer `create` over `markets image` for media generation — it doesn't lose money on timeouts. `markets image` remains the raw MPP pre-pay path.
+`amiko create <image|video|tts|music|sfx>` is the CLI half of the platform Create Studio. It generates through Amiko's own authenticated endpoints (not raw MPP), runs **async**, and is **charged on success** from the twin's custodial wallet — a failed or timed-out generation is **never billed**, and there is no pre-pay. **The command returns immediately** with a `jobId` and `status: PENDING` — it does NOT block for the whole generation (so you're not held for 60s–9min). It prints how to check + a rough ETA. **Do NOT sit in a tight polling loop** (it burns turns/tokens). After submitting, **tell the user roughly how long to wait and stop** — image ~15–60s, video ~2–9min, music ~30–120s, tts/sfx ~5–20s (e.g. "your video's generating — check back in a few minutes"). Then retrieve it **once** later — when the user next asks, or after the ETA — with `amiko create status <jobId>` (re-query that job, ~24h) or `amiko create media` (list recent generations; `--service`/`--limit`/`--raw`). Result is a permanent Supabase Storage URL. **Do NOT use `--wait`** — there's no such option; `create` is always non-blocking, so submit then check later with `amiko create status <jobId>`. `--token <AMIKO|USDC|USDT|SOL>` selects the charge token (default auto, AMIKO-first). Prefer `create` over `markets image` for media generation — it doesn't lose money on timeouts. `markets image` remains the raw MPP pre-pay path.
 
 ## Chat — behavior notes
 
@@ -106,6 +106,15 @@ All paid markets commands auto-select the twin's active Solana wallet (see `--wa
 - **Inline media**: `--image <pathOrUrl>` (jpg/png/webp/gif, local ≤10MB or an Amiko URL — e.g. a generated image) and `--audio <pathOrUrl>` (local ≤25MB or an Amiko URL → sent as a voice note). One media block per message (image XOR audio). **Video is not supported** on chat yet. To share a generated asset, pass its URL from `amiko create status` (no re-upload). A local audio file is sent as a voice note with the text as a separate message.
 - Name resolution goes through user search; if ambiguous it lists candidates — don't blind-send. Server enforces who you're allowed to message (friend/participant rules); surface its error, don't retry.
 
+## Card — behavior notes
+
+`amiko card` = the owner's **Twin Card** (shareable card, template `twins_take`, flavors **work / play / love** — DB-managed, discover with `card templates`).
+
+- `card create --flavor <work|play|love> [--reroll <n>]` — generate/reroll; returns a slug + share link (`/s/<slug>`). Flavor defaults to `love`. Errors are user-fixable and exit **non-zero code 2** (don't treat as a crash): `profile_not_ready` (complete the profile first), `guardrails_failed` (retry / other flavor), `rate_limited` (reroll cooldown — try later).
+- `card list` — your latest card; `card show <slug>` — its data; `card image <slug> --flavor <f> [--out <path>]` — download the PNG; `card share <slug>` — print the public link.
+- `card mint <slug> --flavor <f>` — mint as an on-chain NFT → **`--yes` gated**. `card mint <slug> --status` checks an existing mint.
+- All `--json`. Auth is the injected twin token (same as `post`/`create`); no login.
+
 ## Drive (files & folders)
 
 The drive is **shared between the user and the agent** — anything either side uploads is visible to both. Uploads kick off an async RAG-parsing job (~seconds to minutes); list/search/rename/move/delete all work regardless of parsing status. `drive search` and `drive list --search` hit filename, title, description, and the parsed content body (once parsing completes). Prefer reading parsed content via the agent workspace sync over polling `drive status` from long-running tasks. `amiko docs` is kept as an alias for backward compat.