@heyamiko/amiko-cli 0.15.2 → 0.16.1

package/dist/index.js

@@ -25320,6 +25320,11 @@ var init_client2 = __esm(() => {
 // src/index.ts
 import { createRequire as createRequire2 } from "node:module";
 
+// src/onboarding.ts
+async function runOnboarding(_argv) {
+  return false;
+}
+
 // node_modules/commander/esm.mjs
 var import__ = __toESM(require_commander(), 1);
 var {
@@ -25336,11 +25341,6 @@ var {
   Help
 } = import__.default;
 
-// src/onboarding.ts
-async function runOnboarding(_argv) {
-  return false;
-}
-
 // node_modules/chalk/source/vendor/ansi-styles/index.js
 var ANSI_BACKGROUND_OFFSET = 10;
 var wrapAnsi16 = (offset = 0) => (code) => `\x1B[${code + offset}m`;
@@ -27165,6 +27165,17 @@ function formatError(status, body, path) {
   const snippet = body.length > 500 ? `${body.slice(0, 500)}...` : body;
   return `${prefix}: ${snippet}`;
 }
+async function presignedPut(uploadUrl, body, contentType) {
+  const res = await fetch(uploadUrl, {
+    method: "PUT",
+    headers: { "Content-Type": contentType },
+    body
+  });
+  if (!res.ok) {
+    const text = await res.text().catch(() => "");
+    throw new Error(`Presigned PUT failed: ${res.status} ${text.slice(0, 200)}`);
+  }
+}
 
 // src/lib/wallet-default.ts
 var cache = null;
@@ -28404,107 +28415,606 @@ async function payTreasury(auth, args) {
   return transferData.txHash;
 }
 
+// src/lib/paid-search.ts
+function abort(spinner, e5, fallback2) {
+  spinner?.stop();
+  console.error(error(e5 instanceof Error ? e5.message : fallback2));
+  return process.exit(1);
+}
+function formatUsd(usd2) {
+  return `$${usd2.toFixed(3).replace(/0$/, "")}`;
+}
+function buildQuery(params) {
+  const query = new URLSearchParams;
+  for (const [key, value] of Object.entries(params)) {
+    if (value !== undefined && value !== "")
+      query.set(key, value);
+  }
+  return query;
+}
+async function paidSearch(req, opts, render) {
+  let token;
+  try {
+    token = normalizePaymentToken(opts.token);
+  } catch (e5) {
+    abort(null, e5, "invalid payment token");
+  }
+  let quote;
+  try {
+    quote = await quoteTokenAmount(resolveAuth(), token, req.usd);
+  } catch (e5) {
+    abort(null, e5, "could not price the payment");
+  }
+  const amount2 = quote.amount;
+  await requireApproval({
+    cost: `${amount2} ${token} (≈ ${formatUsd(req.usd)})`,
+    summary: req.label,
+    yes: opts.yes,
+    commandExample: req.commandExample
+  });
+  const spinner = ora(`${req.label}...`).start();
+  const config2 = loadConfig();
+  const mppBase2 = (config2.apiBase || "https://mpp.amikomarkets.com").replace(/\/$/, "");
+  let auth;
+  try {
+    auth = requireAuth();
+  } catch (e5) {
+    abort(spinner, e5, "auth failed");
+  }
+  let wallet;
+  try {
+    wallet = await resolveWalletAddress(auth, opts.wallet, "solana");
+  } catch (e5) {
+    abort(spinner, e5, "could not resolve a wallet to pay from");
+  }
+  spinner.text = `Paying ${amount2} ${token} (solana)...`;
+  let txHash;
+  try {
+    txHash = await payTreasury(auth, { wallet, amount: amount2, token });
+  } catch (e5) {
+    abort(spinner, e5, `${token} payment failed`);
+  }
+  const charged = dim(`Charged ${amount2} ${token} before this failed — tx: https://solscan.io/tx/${txHash}`);
+  spinner.text = `Paid ${amount2} ${token} — ${req.label}...`;
+  let res;
+  try {
+    res = await fetch(`${mppBase2}${req.path}?${buildQuery(req.params)}`, {
+      headers: {
+        "X-Payment-Tx": txHash,
+        "X-Payment-Amount": amount2,
+        "X-Payment-Token": token,
+        "X-Twin-Id": auth.twinId
+      }
+    });
+  } catch (e5) {
+    spinner.stop();
+    console.error(error(e5 instanceof Error ? e5.message : `${req.label} failed`));
+    console.error(charged);
+    process.exit(1);
+  }
+  spinner.stop();
+  if (!res.ok) {
+    await reportHttpError(res, req.label);
+    console.error(charged);
+    process.exit(1);
+  }
+  let data;
+  try {
+    data = await res.json();
+  } catch (e5) {
+    console.error(error("The service returned a response that could not be parsed as JSON."));
+    console.error(charged);
+    process.exit(1);
+  }
+  if (opts.raw) {
+    console.log(JSON.stringify(data, null, 2));
+    return;
+  }
+  render(data);
+  console.log(success(`Paid ${amount2} ${token}`) + dim(` tx: ${txHash.slice(0, 16)}...`));
+  await printBalanceRemaining(auth);
+}
+
 // src/commands/search.ts
-var SEARCH_USD = 0.01;
+var COUNTRY = { spec: "--country <code>", desc: "Country code (gl), e.g. us, gb, jp", param: "gl" };
+var LANG = { spec: "--lang <code>", desc: "Language code (hl), e.g. en, zh-cn", param: "hl" };
+var SINCE = { spec: "--since <period>", desc: "Time period, e.g. last_hour, last_day, last_week, last_year", param: "time_period" };
+function stars(rating, reviews) {
+  if (!rating)
+    return false;
+  return reviews ? `${rating}★ (${reviews})` : `${rating}★`;
+}
+function clip(text, max = 160) {
+  if (typeof text !== "string" || !text.trim())
+    return;
+  const flat = text.replace(/\s+/g, " ").trim();
+  return flat.length > max ? `${flat.slice(0, max)}…` : flat;
+}
+var VERTICALS = [
+  {
+    name: "news",
+    path: "/v1/search/news",
+    usd: 0.01,
+    summary: "Google News",
+    flags: [COUNTRY, LANG, SINCE, { spec: "--sort <by>", desc: "Sort order, e.g. date", param: "sort_by" }],
+    item: (r) => ({ title: r.title, body: clip(r.snippet), facts: [r.source, r.date], link: r.link })
+  },
+  {
+    name: "images",
+    path: "/v1/search/images",
+    usd: 0.01,
+    summary: "Google Images",
+    flags: [
+      COUNTRY,
+      LANG,
+      { spec: "--size <size>", desc: "Image size, e.g. large, medium, icon", param: "size" },
+      { spec: "--color <color>", desc: "Dominant colour filter", param: "color" },
+      { spec: "--image-type <type>", desc: "e.g. photo, clipart, lineart, face", param: "image_type" }
+    ],
+    item: (r) => ({ title: r.title, facts: [r.source], link: r.original || r.link })
+  },
+  {
+    name: "videos",
+    path: "/v1/search/videos",
+    usd: 0.01,
+    summary: "Google Videos",
+    serverLimit: true,
+    flags: [COUNTRY, LANG],
+    item: (r) => ({ title: r.title, facts: [r.channel || r.source, r.duration, r.date], link: r.link })
+  },
+  {
+    name: "youtube",
+    path: "/v1/search/youtube",
+    usd: 0.01,
+    summary: "YouTube",
+    flags: [COUNTRY, LANG, { spec: "--sp <token>", desc: "YouTube filter token (sp)", param: "sp" }],
+    item: (r) => ({
+      title: r.title,
+      body: clip(r.description),
+      facts: [r.channel, r.views && `${r.views} views`, r.duration, r.date],
+      link: r.link
+    })
+  },
+  {
+    name: "scholar",
+    path: "/v1/search/scholar",
+    usd: 0.01,
+    summary: "Google Scholar",
+    serverLimit: true,
+    flags: [
+      LANG,
+      { spec: "--from <year>", desc: "Earliest publication year", param: "as_ylo" },
+      { spec: "--to <year>", desc: "Latest publication year", param: "as_yhi" }
+    ],
+    item: (r) => ({
+      title: r.title,
+      body: clip(r.snippet),
+      facts: [r.publication_info, r.year, r.cited_by && `cited by ${r.cited_by}`],
+      link: r.link
+    })
+  },
+  {
+    name: "patents",
+    path: "/v1/search/patents",
+    usd: 0.01,
+    summary: "Google Patents",
+    serverLimit: true,
+    flags: [{ spec: "--page <n>", desc: "Result page", param: "page" }],
+    item: (r) => ({
+      title: r.title,
+      body: clip(r.snippet),
+      facts: [r.patent_id, r.assignee || r.inventor, r.date],
+      link: r.link
+    })
+  },
+  {
+    name: "maps",
+    path: "/v1/search/maps",
+    usd: 0.01,
+    summary: "Google Maps places",
+    flags: [COUNTRY, LANG, { spec: "--ll <coords>", desc: "Centre point, e.g. @40.71,-74.00,14z", param: "ll" }],
+    item: (r) => ({
+      title: r.title,
+      body: r.address,
+      facts: [stars(r.rating, r.reviews), r.type, r.phone],
+      link: r.website
+    })
+  },
+  {
+    name: "jobs",
+    path: "/v1/search/jobs",
+    usd: 0.01,
+    summary: "Google Jobs",
+    flags: [
+      COUNTRY,
+      LANG,
+      { spec: "--location <where>", desc: 'Where to search, e.g. "Berlin, Germany"', param: "location" },
+      { spec: "--page-token <token>", desc: "next_page_token from a previous page", param: "next_page_token" }
+    ],
+    item: (r) => ({
+      title: r.title,
+      body: clip(r.description),
+      facts: [r.company, r.location, r.salary, r.schedule, r.date, r.via],
+      link: r.link
+    })
+  },
+  {
+    name: "shopping",
+    path: "/v1/search/shopping",
+    usd: 0.01,
+    summary: "Google Shopping",
+    flags: [
+      COUNTRY,
+      LANG,
+      { spec: "--min <price>", desc: "Minimum price", param: "price_min" },
+      { spec: "--max <price>", desc: "Maximum price", param: "price_max" },
+      { spec: "--sort <by>", desc: "Sort order, e.g. price_low_to_high", param: "sort_by" },
+      { spec: "--condition <c>", desc: "e.g. new, used", param: "condition" }
+    ],
+    item: (r) => ({
+      title: r.title,
+      price: r.price || r.extracted_price && `$${r.extracted_price}` || undefined,
+      facts: [r.source, stars(r.rating, r.reviews), r.delivery],
+      link: r.link
+    })
+  },
+  {
+    name: "amazon",
+    path: "/v1/search/amazon",
+    usd: 0.01,
+    summary: "Amazon products",
+    flags: [
+      { spec: "--domain <domain>", desc: "Marketplace, e.g. amazon.co.uk", param: "amazon_domain" },
+      { spec: "--min <price>", desc: "Minimum price", param: "price_min" },
+      { spec: "--max <price>", desc: "Maximum price", param: "price_max" },
+      { spec: "--sort <by>", desc: "Sort order", param: "sort_by" },
+      { spec: "--page <n>", desc: "Result page", param: "page" }
+    ],
+    item: (r) => ({
+      title: r.title,
+      price: typeof r.price === "string" ? r.price : r.price ? `$${r.price}` : undefined,
+      facts: [
+        r.asin && `ASIN: ${r.asin}`,
+        r.rating && `${r.rating}★`,
+        r.reviews_count && `${r.reviews_count} reviews`,
+        r.is_prime && "Prime"
+      ],
+      link: r.link
+    })
+  },
+  {
+    name: "walmart",
+    path: "/v1/search/walmart",
+    usd: 0.01,
+    summary: "Walmart products",
+    flags: [
+      { spec: "--min <price>", desc: "Minimum price", param: "min_price" },
+      { spec: "--max <price>", desc: "Maximum price", param: "max_price" },
+      { spec: "--sort <by>", desc: "Sort order", param: "sort_by" },
+      { spec: "--page <n>", desc: "Result page", param: "page" }
+    ],
+    item: (r) => ({
+      title: r.title,
+      price: typeof r.price === "string" ? r.price : r.price ? `$${r.price}` : undefined,
+      facts: [r.seller, stars(r.rating, r.reviews_count)],
+      link: r.link
+    })
+  },
+  {
+    name: "finance",
+    path: "/v1/search/finance",
+    usd: 0.01,
+    summary: "Google Finance quote for a ticker",
+    render: renderFinance
+  },
+  {
+    name: "trends",
+    path: "/v1/search/trends",
+    usd: 0.01,
+    summary: "Google Trends interest over time",
+    flags: [
+      { spec: "--geo <code>", desc: "Region, e.g. US, GB, US-CA", param: "geo" },
+      { spec: "--date <range>", desc: "Range, e.g. today 12-m, 2024-01-01 2024-06-01", param: "date" },
+      { spec: "--data-type <type>", desc: "e.g. TIMESERIES, GEO_MAP, RELATED_QUERIES", param: "data_type" },
+      { spec: "--cat <id>", desc: "Category id", param: "cat" }
+    ],
+    render: renderTrends
+  }
+];
+var WEB_ENGINES = {
+  google: "/v1/search/google",
+  bing: "/v1/search/bing",
+  duckduckgo: "/v1/search/duckduckgo"
+};
+function printRendered(r) {
+  console.log(`  ${source_default.cyan(r.title || "Untitled")}`);
+  if (r.price)
+    console.log(`  ${source_default.yellow(r.price)}`);
+  if (r.body)
+    console.log(`  ${r.body}`);
+  const facts = (r.facts ?? []).filter(Boolean);
+  if (facts.length)
+    console.log(dim(`  ${facts.join(" · ")}`));
+  if (r.link)
+    console.log(dim(`  ${String(r.link).slice(0, 100)}`));
+  console.log("");
+}
+function renderResults(data, limit, item) {
+  const results = Array.isArray(data?.results) ? data.results : [];
+  if (results.length === 0) {
+    console.log(dim("  No results found."));
+    console.log("");
+    return;
+  }
+  for (const row of results.slice(0, limit))
+    printRendered(item(row));
+  if (results.length > limit) {
+    console.log(dim(`  …${results.length - limit} more — raise --limit or use --raw.`));
+    console.log("");
+  }
+}
+function renderWeb(data, limit) {
+  if (data?.answer_box) {
+    const box = data.answer_box;
+    const text = box.answer || box.snippet || box.result || clip(JSON.stringify(box), 200);
+    if (text) {
+      console.log(source_default.bold("  Answer"));
+      console.log(`  ${text}`);
+      console.log("");
+    }
+  }
+  if (data?.knowledge_graph?.title) {
+    const kg = data.knowledge_graph;
+    console.log(source_default.bold(`  ${kg.title}`));
+    if (kg.description)
+      console.log(`  ${clip(kg.description)}`);
+    console.log("");
+  }
+  renderResults(data, limit, (r) => ({
+    title: r.title,
+    body: clip(r.snippet),
+    facts: [r.date],
+    link: r.link
+  }));
+  const related = data?.related_questions ?? [];
+  if (related.length) {
+    console.log(dim("  Related questions:"));
+    for (const q of related.slice(0, 5)) {
+      console.log(dim(`    ${typeof q === "string" ? q : q.question || q.title}`));
+    }
+    console.log("");
+  }
+}
+function renderFinance(data, limit) {
+  const s = data?.summary;
+  if (s) {
+    const name = [s.title, s.stock && `(${s.stock})`].filter(Boolean).join(" ");
+    if (name)
+      console.log(`  ${source_default.cyan(name)}`);
+    const price = s.price ?? s.extracted_price;
+    if (price !== undefined) {
+      const move = s.price_movement;
+      const arrow = move?.movement === "Down" ? source_default.red("▼") : move?.movement === "Up" ? source_default.green("▲") : "";
+      const pct = move?.percentage !== undefined ? ` ${arrow} ${move.percentage}%` : "";
+      console.log(`  ${source_default.yellow(`${price}${s.currency ? ` ${s.currency}` : ""}`)}${pct}`);
+    }
+    if (s.exchange)
+      console.log(dim(`  ${s.exchange}`));
+    console.log("");
+  } else {
+    console.log(dim("  No quote summary returned."));
+    console.log("");
+  }
+  const news = data?.news ?? [];
+  if (news.length) {
+    console.log(dim("  News"));
+    for (const n of news.slice(0, limit)) {
+      console.log(`  ${source_default.cyan(n.title)}`);
+      console.log(dim(`  ${[n.source, n.date].filter(Boolean).join(" · ")}`));
+      if (n.link)
+        console.log(dim(`  ${String(n.link).slice(0, 100)}`));
+      console.log("");
+    }
+  }
+  const extra = ["graph", "knowledge_graph", "financials"].filter((k) => data?.[k]);
+  if (extra.length)
+    console.log(dim(`  Also returned (use --raw): ${extra.join(", ")}`));
+}
+function renderTrends(data, limit) {
+  const timeline = data?.interest_over_time?.timeline_data ?? [];
+  if (timeline.length) {
+    console.log(dim("  Interest over time"));
+    for (const point of timeline.slice(-limit)) {
+      const value = point.values?.[0]?.value ?? point.values?.[0]?.extracted_value;
+      console.log(`  ${dim(point.date ?? "")}  ${value ?? "-"}`);
+    }
+    console.log("");
+  } else {
+    console.log(dim("  No timeline returned — try --data-type TIMESERIES."));
+    console.log("");
+  }
+  const queries = data?.related_queries?.rising ?? data?.related_queries?.top ?? [];
+  if (Array.isArray(queries) && queries.length) {
+    console.log(dim("  Related queries"));
+    for (const q of queries.slice(0, limit)) {
+      console.log(`  ${q.query ?? q.topic?.title ?? JSON.stringify(q)}`);
+    }
+    console.log("");
+  }
+  const extra = ["compared_breakdown_by_region", "related_topics"].filter((k) => data?.[k]);
+  if (extra.length)
+    console.log(dim(`  Also returned (use --raw): ${extra.join(", ")}`));
+}
+function collectParam(value, previous) {
+  return [...previous, value];
+}
+function parseParams(pairs) {
+  const out = {};
+  for (const pair of pairs ?? []) {
+    const eq = pair.indexOf("=");
+    if (eq <= 0) {
+      console.error(error(`--param expects key=value, got: ${pair}`));
+      process.exit(1);
+    }
+    out[pair.slice(0, eq)] = pair.slice(eq + 1);
+  }
+  return out;
+}
+function limitOf(opts) {
+  const n = parseInt(opts.limit ?? "", 10);
+  return Number.isFinite(n) && n > 0 ? n : 5;
+}
+function paramsFor(v, query, opts) {
+  const params = { q: query };
+  for (const flag of v.flags ?? []) {
+    const key = flag.spec.replace(/^--/, "").replace(/ .*$/, "").replace(/-([a-z])/g, (_, c) => c.toUpperCase());
+    const value = opts[key];
+    if (value !== undefined)
+      params[flag.param] = String(value);
+  }
+  if (v.serverLimit)
+    params.num = String(limitOf(opts));
+  return { ...params, ...parseParams(opts.param) };
+}
+function attachCommonOptions(cmd, flags = []) {
+  for (const flag of flags)
+    cmd.option(flag.spec, flag.desc);
+  return cmd.option("--limit <n>", "Max results to print", "5").option("--param <key=value>", "Extra upstream parameter (repeat for more)", collectParam, []).option("--raw", "Output raw JSON — the full response, nothing else on stdout").option("--token <token>", "Payment token (AMIKO, USDC, USDT)", "AMIKO").option("--wallet <address>", "Wallet to pay from (defaults to your Solana wallet — run `amiko wallets create --chain solana` if you don't have one)").option("--yes", "Skip the pre-spend confirmation (required in non-interactive shells)");
+}
+function quoteArg(s) {
+  return JSON.stringify(s);
+}
+function oneQuery(parts, subcommand) {
+  if (parts.length > 1) {
+    console.error(error(`Quote the query — "${parts.join(" ")}" was read as ${parts.length} arguments.`));
+    console.error(dim(`  amiko search ${subcommand} ${quoteArg(parts.join(" "))}`));
+    process.exit(1);
+  }
+  return parts[0];
+}
 function registerSearchCommand(program2) {
-  program2.command("search <query>").description("X Search — $0.01 per search, paid in AMIKO, USDC, or USDT").option("--raw", "Output raw JSON").option("--token <token>", "Payment token (AMIKO, USDC, USDT)", "AMIKO").option("--wallet <address>", "Wallet to pay from (defaults to your Solana wallet — run `amiko wallets create --chain solana` if you don't have one)").option("--yes", "Skip the pre-spend confirmation (required in non-interactive shells)").action(async (query, opts) => {
-    let token;
-    try {
-      token = normalizePaymentToken(opts.token);
-    } catch (e5) {
-      console.error(error(e5 instanceof Error ? e5.message : String(e5)));
+  const search = program2.command("search").description("Paid web search across Google, Bing, X, Amazon, news, images, scholar and more — $0.01 per search");
+  attachCommonOptions(search.command("web <query...>").description("General web search — $0.01 (default engine: google)").option("--engine <engine>", "google, bing, or duckduckgo", "google"), [COUNTRY, LANG, SINCE]).action(async (parts, opts) => {
+    const query = oneQuery(parts, "web");
+    const engine = String(opts.engine).toLowerCase();
+    const path2 = WEB_ENGINES[engine];
+    if (!path2) {
+      console.error(error(`Unknown --engine "${opts.engine}". Choose google, bing, or duckduckgo.`));
       process.exit(1);
     }
-    let quote;
+    const params = engine === "google" ? paramsFor({ flags: [COUNTRY, LANG, SINCE], serverLimit: true }, query, opts) : { q: query, ...parseParams(opts.param) };
+    await paidSearch({
+      path: path2,
+      params,
+      usd: 0.01,
+      label: `${engine} search: ${clip(query, 60)}`,
+      commandExample: `amiko search web ${quoteArg(query)}${engine !== "google" ? ` --engine ${engine}` : ""}`
+    }, opts, (data) => {
+      console.log(heading(`${engine} — "${query}"
+`));
+      renderWeb(data, limitOf(opts));
+    });
+  });
+  attachCommonOptions(search.command("x <query...>").description("X / Twitter search — $0.01")).action(async (parts, opts) => {
+    const query = oneQuery(parts, "x");
+    await runXSearch(query, opts, `amiko search x ${quoteArg(query)}`);
+  });
+  for (const v of VERTICALS) {
+    attachCommonOptions(search.command(`${v.name} <query...>`).description(`${v.summary} — $${v.usd}`), v.flags).action(async (parts, opts) => {
+      const query = oneQuery(parts, v.name);
+      await runVertical(v.name, query, opts, `amiko search ${v.name} ${quoteArg(query)}`);
+    });
+  }
+  search.command("engines").description("List available search engines and their parameters — free").option("--raw", "Output raw JSON").action(async (opts) => {
+    const config2 = loadConfig();
+    const mppBase2 = (config2.apiBase || "https://mpp.amikomarkets.com").replace(/\/$/, "");
+    let auth;
     try {
-      quote = await quoteTokenAmount(resolveAuth(), token, SEARCH_USD);
+      auth = requireAuth();
     } catch (e5) {
-      console.error(error(e5 instanceof Error ? e5.message : String(e5)));
+      console.error(error(e5 instanceof Error ? e5.message : "auth failed"));
       process.exit(1);
     }
-    await requireApproval({
-      cost: `${quote.amount} ${token} (≈ $${SEARCH_USD.toFixed(2)})`,
-      summary: `X/Twitter search: ${query.slice(0, 80)}${query.length > 80 ? "…" : ""}`,
-      yes: opts.yes,
-      commandExample: `amiko markets search ${JSON.stringify(query)}${token !== "AMIKO" ? ` --token ${token}` : ""}`
+    const res = await fetch(`${mppBase2}/v1/search/engines`, {
+      headers: { "X-Twin-Id": auth.twinId }
     });
-    const spinner = ora("X Search...").start();
-    try {
-      const config2 = loadConfig();
-      let auth;
-      try {
-        auth = requireAuth();
-      } catch (e5) {
-        spinner.stop();
-        console.error(error(e5 instanceof Error ? e5.message : "auth failed"));
-        process.exit(1);
-      }
-      const mppBase2 = (config2.apiBase || "https://mpp.amikomarkets.com").replace(/\/$/, "");
-      const amount2 = quote.amount;
-      let wallet;
-      try {
-        wallet = await resolveWalletAddress(auth, opts.wallet, "solana");
-      } catch (e5) {
-        spinner.stop();
-        console.error(error(e5 instanceof Error ? e5.message : String(e5)));
-        process.exit(1);
-      }
-      spinner.text = `Paying ${amount2} ${token} (solana)...`;
-      let txHash;
-      try {
-        txHash = await payTreasury(auth, { wallet, amount: amount2, token });
-      } catch (e5) {
-        spinner.stop();
-        console.error(error(e5 instanceof Error ? e5.message : `${token} payment failed`));
-        process.exit(1);
-      }
-      spinner.text = `Paid ${amount2} ${token} — searching X...`;
-      const params = new URLSearchParams({ q: query });
-      const res = await fetch(`${mppBase2}/v1/x/search?${params}`, {
-        headers: {
-          "Content-Type": "application/json",
-          "X-Payment-Tx": txHash,
-          "X-Payment-Amount": amount2,
-          "X-Payment-Token": token,
-          "X-Twin-Id": auth.twinId
-        }
-      });
-      spinner.stop();
-      if (!res.ok) {
-        await reportHttpError(res, "Search");
-        console.log(dim(`Payment tx: https://solscan.io/tx/${txHash}`));
-        process.exit(1);
-      }
-      const data = await res.json();
-      if (opts.raw) {
-        console.log(JSON.stringify(data, null, 2));
-        return;
-      }
-      console.log(heading(`X Search — "${query}"
-`));
-      const tweets = data.data || [];
-      if (tweets.length === 0) {
-        console.log(dim("  No results found."));
-      } else {
-        for (const tweet of tweets) {
-          const author = tweet.author_id ? dim(`@${tweet.author_id}`) : "";
-          const date5 = tweet.created_at ? dim(new Date(tweet.created_at).toLocaleDateString()) : "";
-          const metrics = tweet.public_metrics;
-          const stats = metrics ? dim(`  ${metrics.like_count || 0} likes · ${metrics.retweet_count || 0} RTs · ${metrics.reply_count || 0} replies`) : "";
-          console.log(`  ${source_default.cyan(tweet.id)} ${author} ${date5}`);
-          console.log(`  ${tweet.text}`);
-          if (stats)
-            console.log(stats);
-          console.log("");
-        }
-      }
-      console.log(success(`Paid ${amount2} ${token}`) + dim(` tx: ${txHash.slice(0, 16)}...`));
-      await printBalanceRemaining(auth);
-    } catch (err) {
-      spinner.stop();
-      console.error(error(err instanceof Error ? err.message : "Search failed"));
+    if (!res.ok) {
+      await reportHttpError(res, "search engines");
       process.exit(1);
     }
+    const data = await res.json();
+    if (opts.raw) {
+      console.log(JSON.stringify(data, null, 2));
+      return;
+    }
+    console.log(heading(`Search engines (${data.total ?? 0}) — provider: ${data.provider ?? "unknown"}
+`));
+    for (const e5 of data.engines ?? []) {
+      console.log(`  ${source_default.cyan(e5.id)}  ${source_default.yellow(e5.price)}`);
+      console.log(dim(`  ${e5.path}`));
+      console.log(dim(`  params: ${e5.params}`));
+      console.log("");
+    }
+    console.log(dim("Anything without an `amiko search` subcommand is reachable via `amiko markets service call GET <path>`."));
+  });
+}
+async function runVertical(name, query, opts, commandExample) {
+  const v = VERTICALS.find((entry) => entry.name === name);
+  if (!v)
+    throw new Error(`unknown search vertical: ${name}`);
+  await paidSearch({
+    path: v.path,
+    params: paramsFor(v, query, opts),
+    usd: v.usd,
+    label: `${v.name} search: ${clip(query, 60)}`,
+    commandExample
+  }, opts, (data) => {
+    console.log(heading(`${v.summary} — "${query}"
+`));
+    if (v.render)
+      v.render(data, limitOf(opts));
+    else
+      renderResults(data, limitOf(opts), v.item);
+  });
+}
+function attachSearchOptions(cmd, vertical) {
+  return attachCommonOptions(cmd, VERTICALS.find((v) => v.name === vertical)?.flags);
+}
+async function runXSearch(query, opts, commandExample) {
+  await paidSearch({
+    path: "/v1/x/search",
+    params: { q: query, ...parseParams(opts.param) },
+    usd: 0.01,
+    label: `X search: ${clip(query, 60)}`,
+    commandExample
+  }, opts, (data) => {
+    console.log(heading(`X — "${query}"
+`));
+    const tweets = data?.data ?? [];
+    if (tweets.length === 0) {
+      console.log(dim("  No results found."));
+      console.log("");
+      return;
+    }
+    for (const tweet of tweets.slice(0, limitOf(opts))) {
+      const m = tweet.public_metrics;
+      printRendered({
+        title: tweet.id,
+        body: tweet.text,
+        facts: [
+          tweet.author_id && `@${tweet.author_id}`,
+          tweet.created_at && new Date(tweet.created_at).toLocaleDateString(),
+          m && `${m.like_count ?? 0} likes · ${m.retweet_count ?? 0} RTs · ${m.reply_count ?? 0} replies`
+        ]
+      });
+    }
+  });
+}
+function registerDeprecatedMarketsSearch(markets) {
+  attachCommonOptions(markets.command("search <query...>").description("[deprecated — use `amiko search x`] X / Twitter search — $0.01")).action(async (parts, opts) => {
+    const query = oneQuery(parts, "x");
+    console.error(warn("`amiko markets search` is deprecated — use `amiko search x` (or `amiko search web` for Google)."));
+    await runXSearch(query, opts, `amiko markets search ${quoteArg(query)}`);
   });
 }
 
@@ -28690,7 +29200,521 @@ function registerImageCommand(program2) {
 }
 
 // src/commands/create.ts
-import { randomUUID } from "node:crypto";
+import { randomUUID } from "node:crypto";
+
+// src/lib/media-duration.ts
+var H3_REFERENCE_AUDIO_MIN_MS = 2000;
+var H3_REFERENCE_AUDIO_MAX_MS = 15000;
+var REFERENCE_TOTAL_MAX_MS = 15000;
+function readMediaDurationMs(buffer, mime) {
+  if (mime === "audio/wav")
+    return wavDurationMs(buffer);
+  if (mime === "video/mp4" || mime === "video/quicktime")
+    return isoDurationMs(buffer);
+  return null;
+}
+function wavDurationMs(buffer) {
+  if (buffer.length < 12)
+    return null;
+  if (buffer.toString("ascii", 0, 4) !== "RIFF")
+    return null;
+  if (buffer.toString("ascii", 8, 12) !== "WAVE")
+    return null;
+  let byteRate = 0;
+  let dataSize = 0;
+  let offset = 12;
+  while (offset + 8 <= buffer.length) {
+    const id = buffer.toString("ascii", offset, offset + 4);
+    const size3 = buffer.readUInt32LE(offset + 4);
+    const body = offset + 8;
+    if (id === "fmt " && body + 16 <= buffer.length) {
+      byteRate = buffer.readUInt32LE(body + 8);
+    } else if (id === "data") {
+      dataSize = size3 > 0 && body + size3 <= buffer.length ? size3 : buffer.length - body;
+    }
+    if (size3 <= 0)
+      break;
+    offset = body + size3 + size3 % 2;
+  }
+  if (byteRate <= 0 || dataSize <= 0)
+    return null;
+  return Math.round(dataSize / byteRate * 1000);
+}
+function isoDurationMs(buffer) {
+  const moov = findBox(buffer, 0, buffer.length, "moov");
+  if (!moov)
+    return null;
+  const mvhd = findBox(buffer, moov.start, moov.end, "mvhd");
+  if (!mvhd || mvhd.start + 4 > buffer.length)
+    return null;
+  const version3 = buffer[mvhd.start];
+  const head = mvhd.start + 4 + (version3 === 1 ? 16 : 8);
+  let timescale;
+  let duration3;
+  if (version3 === 1) {
+    if (head + 12 > mvhd.end)
+      return null;
+    timescale = buffer.readUInt32BE(head);
+    const raw = buffer.readBigUInt64BE(head + 4);
+    if (raw > BigInt(Number.MAX_SAFE_INTEGER))
+      return null;
+    duration3 = Number(raw);
+  } else {
+    if (head + 8 > mvhd.end)
+      return null;
+    timescale = buffer.readUInt32BE(head);
+    duration3 = buffer.readUInt32BE(head + 4);
+  }
+  if (timescale <= 0 || duration3 <= 0 || duration3 === 4294967295)
+    return null;
+  return Math.round(duration3 / timescale * 1000);
+}
+function findBox(buffer, from7, until, type) {
+  let offset = from7;
+  while (offset + 8 <= until) {
+    let size3 = buffer.readUInt32BE(offset);
+    const boxType = buffer.toString("ascii", offset + 4, offset + 8);
+    let header = 8;
+    if (size3 === 1) {
+      if (offset + 16 > until)
+        return null;
+      const large = buffer.readBigUInt64BE(offset + 8);
+      if (large > BigInt(Number.MAX_SAFE_INTEGER))
+        return null;
+      size3 = Number(large);
+      header = 16;
+    } else if (size3 === 0) {
+      size3 = until - offset;
+    }
+    if (size3 < header)
+      return null;
+    const end = Math.min(offset + size3, until);
+    if (boxType === type)
+      return { start: offset + header, end };
+    offset += size3;
+  }
+  return null;
+}
+
+// src/lib/create-capabilities.ts
+var H3_VIDEO_MODEL = /^(minimax-h3|h3|hailuo-0?3)$/i;
+var H3_MIN_SECONDS = 4;
+var H3_MAX_SECONDS = 15;
+var H3_RESOLUTIONS = new Set(["768P", "2K"]);
+var H3_CONCRETE_RATIOS = new Set(["21:9", "16:9", "4:3", "1:1", "3:4", "9:16"]);
+var H3_MAX_PROMPT_CHARS = 7000;
+var NON_H3_MAX_PROMPT_CHARS = 2000;
+var H3_MAX_REFERENCE_FILES = 12;
+var H3_DEFAULT_T2V_ASPECT = "16:9";
+var NON_H3_VIDEO_SECONDS = new Set([4, 6, 8, 10]);
+function isH3VideoModel(model) {
+  return H3_VIDEO_MODEL.test(model);
+}
+function videoFamily(model) {
+  if (isH3VideoModel(model))
+    return "h3";
+  if (model === "grok-imagine-video")
+    return "grok";
+  if (/^(dreamina-seedance-|seedance-|ep-\d{14}-)/i.test(model))
+    return "seedance";
+  if (/^veo-/i.test(model))
+    return "veo";
+  return "hailuo";
+}
+var VIDEO_CAPS = {
+  h3: {
+    referenceImages: 9,
+    referenceVideos: 3,
+    referenceAudio: 3,
+    referenceFiles: H3_MAX_REFERENCE_FILES,
+    firstFrame: true,
+    lastFrame: true,
+    lastFrameNeedsFirst: false,
+    frameExcludesReference: true,
+    frameExclusionCountsAudio: true,
+    audioNeedsVisual: true,
+    subjectReferenceNative: false,
+    label: "MiniMax H3"
+  },
+  grok: {
+    referenceImages: 9,
+    referenceVideos: 0,
+    referenceAudio: 0,
+    firstFrame: true,
+    lastFrame: false,
+    lastFrameNeedsFirst: false,
+    frameExcludesReference: true,
+    frameExclusionCountsAudio: false,
+    audioNeedsVisual: false,
+    subjectReferenceNative: false,
+    label: "Grok Imagine Video"
+  },
+  seedance: {
+    referenceImages: 9,
+    referenceVideos: 3,
+    referenceAudio: 3,
+    firstFrame: true,
+    lastFrame: true,
+    lastFrameNeedsFirst: true,
+    frameExcludesReference: true,
+    frameExclusionCountsAudio: false,
+    audioNeedsVisual: true,
+    subjectReferenceNative: false,
+    label: "Seedance"
+  },
+  veo: {
+    referenceImages: 3,
+    referenceVideos: 0,
+    referenceAudio: 0,
+    firstFrame: true,
+    lastFrame: true,
+    lastFrameNeedsFirst: true,
+    frameExcludesReference: true,
+    frameExclusionCountsAudio: false,
+    audioNeedsVisual: false,
+    subjectReferenceNative: false,
+    label: "Veo"
+  },
+  hailuo: {
+    referenceImages: 0,
+    referenceVideos: 0,
+    referenceAudio: 0,
+    firstFrame: true,
+    lastFrame: true,
+    lastFrameNeedsFirst: false,
+    frameExcludesReference: false,
+    frameExclusionCountsAudio: false,
+    audioNeedsVisual: false,
+    subjectReferenceNative: true,
+    label: "MiniMax Hailuo"
+  }
+};
+function effectiveReferenceImageCount(input) {
+  if (VIDEO_CAPS[videoFamily(input.model)].subjectReferenceNative) {
+    return input.referenceImageUrls.length;
+  }
+  return input.subjectReference ? 1 : input.referenceImageUrls.length;
+}
+function validateVideoReferences(input) {
+  const family = videoFamily(input.model);
+  const caps = VIDEO_CAPS[family];
+  const images = effectiveReferenceImageCount(input);
+  const videos = input.referenceVideoUrls.length;
+  const audio = input.referenceAudioUrls.length;
+  if (input.referenceImageUrls.length > 0 && caps.referenceImages === 0) {
+    return `${caps.label} ignores --reference-image — mpp's ${family} branch never reads it, so the video would be generated and billed without it. Use --subject-reference for a single character image, or --model MiniMax-H3 for true reference-to-video.`;
+  }
+  if (videos > 0 && caps.referenceVideos === 0) {
+    return `${caps.label} ignores --reference-video — it would be dropped and the job billed anyway. Only MiniMax-H3 and Seedance read reference clips.`;
+  }
+  if (audio > 0 && caps.referenceAudio === 0) {
+    return `${caps.label} ignores --reference-audio — it would be dropped and the job billed anyway. Only MiniMax-H3 and Seedance read reference audio.`;
+  }
+  if (input.lastFrame && !caps.lastFrame) {
+    return `${caps.label} ignores --last-frame — it would be dropped and the job billed anyway. Drop the flag, or use a model with first-and-last-frame support (MiniMax-H3, Seedance, Veo).`;
+  }
+  if (input.lastFrame && !input.firstFrame && caps.lastFrameNeedsFirst) {
+    return `${caps.label} needs --first-frame alongside --last-frame.`;
+  }
+  const hasFrame = Boolean(input.firstFrame || input.lastFrame);
+  const hasReference = images > 0 || videos > 0 || caps.frameExclusionCountsAudio && audio > 0;
+  if (hasFrame && hasReference && caps.frameExcludesReference) {
+    const kinds = caps.frameExclusionCountsAudio ? "--reference-image/-video/-audio, --subject-reference" : "--reference-image/-video, --subject-reference";
+    return `${caps.label} cannot combine --first-frame/--last-frame with reference inputs (${kinds}). Use one mode or the other.`;
+  }
+  if (audio > 0 && images === 0 && videos === 0 && caps.audioNeedsVisual) {
+    return `${caps.label} reference audio needs at least one --reference-image or --reference-video alongside it.`;
+  }
+  if (images > caps.referenceImages) {
+    return `${caps.label} accepts at most ${caps.referenceImages} reference image${caps.referenceImages === 1 ? "" : "s"} (got ${images}).`;
+  }
+  if (videos > caps.referenceVideos) {
+    return `${caps.label} accepts at most ${caps.referenceVideos} reference video${caps.referenceVideos === 1 ? "" : "s"} (got ${videos}).`;
+  }
+  if (audio > caps.referenceAudio) {
+    return `${caps.label} accepts at most ${caps.referenceAudio} reference audio clip${caps.referenceAudio === 1 ? "" : "s"} (got ${audio}).`;
+  }
+  if (caps.referenceFiles !== undefined && images + videos + audio > caps.referenceFiles) {
+    return `${caps.label} accepts at most ${caps.referenceFiles} reference files in total (got ${images + videos + audio}).`;
+  }
+  return null;
+}
+function validateReferenceDurations(model, videoMs, audioMs) {
+  const family = videoFamily(model);
+  if (family !== "h3" && family !== "seedance")
+    return null;
+  const caps = VIDEO_CAPS[family];
+  if (family === "h3") {
+    for (const [index, ms] of audioMs.entries()) {
+      if (ms === null)
+        continue;
+      if (ms < H3_REFERENCE_AUDIO_MIN_MS || ms > H3_REFERENCE_AUDIO_MAX_MS) {
+        return `--reference-audio #${index + 1} is ${(ms / 1000).toFixed(1)}s; ${caps.label} accepts ${H3_REFERENCE_AUDIO_MIN_MS / 1000}–${H3_REFERENCE_AUDIO_MAX_MS / 1000}s per clip. Trim it before attaching.`;
+      }
+    }
+  }
+  const all = [...videoMs, ...audioMs];
+  if (all.length === 0 || all.some((ms) => ms === null))
+    return null;
+  const total = all.reduce((sum, ms) => sum + (ms ?? 0), 0);
+  if (total > REFERENCE_TOTAL_MAX_MS) {
+    return `Reference video + audio total ${(total / 1000).toFixed(1)}s; ${caps.label} caps the combined reference material at ${REFERENCE_TOTAL_MAX_MS / 1000}s.`;
+  }
+  return null;
+}
+function imageReferenceSupport(model) {
+  if (model.startsWith("nano-banana"))
+    return "multi";
+  if (model.startsWith("gpt-image"))
+    return "multi";
+  if (model === "image-01")
+    return "character";
+  return null;
+}
+var IMAGE_REFERENCE_MAX = {
+  multi: 4,
+  character: 1
+};
+function validateImageReferences(model, referenceImageUrls) {
+  if (referenceImageUrls.length === 0)
+    return null;
+  const support = imageReferenceSupport(model);
+  if (!support) {
+    return `${model} does not take reference images. Use nano-banana / nano-banana-pro / nano-banana-lite / nano-banana-2 or gpt-image-* (up to ${IMAGE_REFERENCE_MAX.multi}), or image-01 for a single character portrait.`;
+  }
+  const max = IMAGE_REFERENCE_MAX[support];
+  if (referenceImageUrls.length > max) {
+    return support === "character" ? `${model} takes exactly one reference image — a front-facing character portrait (got ${referenceImageUrls.length}).` : `${model} accepts at most ${max} reference images (got ${referenceImageUrls.length}).`;
+  }
+  return null;
+}
+
+// src/lib/create-input.ts
+import { basename as basename2, extname as extname2 } from "node:path";
+
+// src/lib/file-input.ts
+import { readFile } from "node:fs/promises";
+import { basename, extname } from "node:path";
+var MAX_BYTES = 100 * 1024 * 1024;
+var FETCH_TIMEOUT_MS = 30000;
+async function resolveFileInput(src, opts = {}) {
+  const maxBytes = opts.maxBytes ?? MAX_BYTES;
+  if (src === "-" || opts.stdin) {
+    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, 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 > 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(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 > maxBytes) {
+      throw new Error(`stdin exceeded ${maxBytes} byte cap.`);
+    }
+    chunks.push(buf);
+  }
+  return Buffer.concat(chunks);
+}
+async function fetchRemote(url2, maxBytes) {
+  const controller = new AbortController;
+  const timer = setTimeout(() => controller.abort(), FETCH_TIMEOUT_MS);
+  try {
+    const res = await fetch(url2, { signal: controller.signal });
+    if (!res.ok) {
+      throw new Error(`Fetch ${url2} failed: ${res.status} ${res.statusText}`);
+    }
+    const len = Number(res.headers.get("content-length") || 0);
+    if (len > maxBytes) {
+      throw new Error(`Remote file too large: ${len} bytes exceeds ${maxBytes} byte cap.`);
+    }
+    const buf = Buffer.from(await res.arrayBuffer());
+    if (buf.length > maxBytes) {
+      throw new Error(`Remote file too large: ${buf.length} bytes exceeds ${maxBytes} byte cap.`);
+    }
+    return buf;
+  } finally {
+    clearTimeout(timer);
+  }
+}
+var MAGIC = [
+  [Buffer.from([37, 80, 68, 70]), "application/pdf"],
+  [Buffer.from([137, 80, 78, 71]), "image/png"],
+  [Buffer.from([255, 216, 255]), "image/jpeg"],
+  [Buffer.from([71, 73, 70, 56]), "image/gif"],
+  [Buffer.from([82, 73, 70, 70]), "audio/wav"],
+  [Buffer.from([73, 68, 51]), "audio/mpeg"],
+  [Buffer.from([255, 251]), "audio/mpeg"],
+  [Buffer.from([80, 75, 3, 4]), "application/zip"]
+];
+var EXT_MIME = {
+  ".pdf": "application/pdf",
+  ".png": "image/png",
+  ".jpg": "image/jpeg",
+  ".jpeg": "image/jpeg",
+  ".gif": "image/gif",
+  ".webp": "image/webp",
+  ".txt": "text/plain",
+  ".md": "text/markdown",
+  ".json": "application/json",
+  ".wav": "audio/wav",
+  ".mp3": "audio/mpeg",
+  ".m4a": "audio/mp4",
+  ".ogg": "audio/ogg",
+  ".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) {
+  for (const [sig, mime] of MAGIC) {
+    if (buffer.length >= sig.length && buffer.subarray(0, sig.length).equals(sig)) {
+      return mime;
+    }
+  }
+  const ext = extname(name).toLowerCase();
+  return EXT_MIME[ext] ?? "application/octet-stream";
+}
+
+// src/lib/create-input.ts
+var IMAGE_MAX_BYTES = 30 * 1024 * 1024;
+var VIDEO_MAX_BYTES = 50 * 1024 * 1024;
+var AUDIO_MAX_BYTES = 15 * 1024 * 1024;
+var CREATE_INPUT_MEDIA = {
+  "image/jpeg": { extension: "jpg", maxBytes: IMAGE_MAX_BYTES },
+  "image/png": { extension: "png", maxBytes: IMAGE_MAX_BYTES },
+  "image/webp": { extension: "webp", maxBytes: IMAGE_MAX_BYTES },
+  "image/heic": { extension: "heic", maxBytes: IMAGE_MAX_BYTES },
+  "image/heif": { extension: "heif", maxBytes: IMAGE_MAX_BYTES },
+  "video/mp4": { extension: "mp4", maxBytes: VIDEO_MAX_BYTES },
+  "video/quicktime": { extension: "mov", maxBytes: VIDEO_MAX_BYTES },
+  "audio/mpeg": { extension: "mp3", maxBytes: AUDIO_MAX_BYTES },
+  "audio/wav": { extension: "wav", maxBytes: AUDIO_MAX_BYTES }
+};
+var MIME_ALIASES = {
+  "image/jpg": "image/jpeg",
+  "image/pjpeg": "image/jpeg",
+  "audio/mp3": "audio/mpeg",
+  "audio/x-wav": "audio/wav"
+};
+var EXT_TO_MIME = {
+  ".jpg": "image/jpeg",
+  ".jpeg": "image/jpeg",
+  ".png": "image/png",
+  ".webp": "image/webp",
+  ".heic": "image/heic",
+  ".heif": "image/heif",
+  ".mp4": "video/mp4",
+  ".m4v": "video/mp4",
+  ".mov": "video/quicktime",
+  ".mp3": "audio/mpeg",
+  ".wav": "audio/wav"
+};
+var KIND_PREFIX = {
+  image: "image/",
+  video: "video/",
+  audio: "audio/"
+};
+var KIND_ACCEPTS = {
+  image: "jpg, png, webp, heic, heif (max 30 MB)",
+  video: "mp4, mov (max 50 MB)",
+  audio: "mp3, wav (max 15 MB)"
+};
+function canonicalMime(rawMime, filename) {
+  const base = rawMime.split(";")[0]?.trim().toLowerCase() ?? "";
+  if (base) {
+    const aliased = MIME_ALIASES[base] ?? base;
+    if (CREATE_INPUT_MEDIA[aliased])
+      return aliased;
+  }
+  const fromExt = EXT_TO_MIME[extname2(filename).toLowerCase()];
+  return fromExt && CREATE_INPUT_MEDIA[fromExt] ? fromExt : undefined;
+}
+async function uploadCreateInput(auth, source, kind) {
+  const file2 = await resolveFileInput(source, {
+    maxBytes: VIDEO_MAX_BYTES
+  });
+  const mime = canonicalMime(file2.mime, file2.name || basename2(source));
+  if (!mime) {
+    throw new Error(`"${source}" is not a Create Studio input type (detected ${file2.mime || "unknown"}). Accepted: ${KIND_ACCEPTS[kind]}.`);
+  }
+  if (!mime.startsWith(KIND_PREFIX[kind])) {
+    throw new Error(`"${source}" is ${mime}, not ${kind === "audio" ? "an" : "a"} ${kind}. Accepted here: ${KIND_ACCEPTS[kind]}.`);
+  }
+  const config2 = CREATE_INPUT_MEDIA[mime];
+  if (file2.size > config2.maxBytes) {
+    throw new Error(`"${source}" is ${file2.size} bytes; the ${kind} limit is ${config2.maxBytes} bytes (${KIND_ACCEPTS[kind]}).`);
+  }
+  const session = await amikoWebFetch(auth, "/api/create/uploads", {
+    method: "POST",
+    body: { contentType: mime, sizeBytes: file2.size },
+    timeoutMs: 30000
+  });
+  if (!session.uploadUrl || !session.path) {
+    throw new Error(`Could not start the upload for "${source}".`);
+  }
+  await presignedPut(session.uploadUrl, file2.buffer, mime);
+  const finalized = await amikoWebFetch(auth, "/api/create/uploads", {
+    method: "PUT",
+    body: { path: session.path },
+    timeoutMs: 30000
+  });
+  if (!finalized.url) {
+    throw new Error(`Upload of "${source}" completed but returned no URL.`);
+  }
+  return { url: finalized.url, durationMs: readMediaDurationMs(file2.buffer, mime) };
+}
+async function resolveCreateInput(auth, value, kind, opts = {}) {
+  const trimmed = value.trim();
+  if (trimmed === "") {
+    throw new Error("Empty media argument.");
+  }
+  if (/^data:/i.test(trimmed)) {
+    if (!opts.allowDataUri) {
+      throw new Error("A data: URI only works for --first-frame/--last-frame. Reference media is fetched by the provider, so pass a local file path or an https URL.");
+    }
+    return { url: trimmed, durationMs: null };
+  }
+  if (/^https:\/\//i.test(trimmed))
+    return { url: trimmed, durationMs: null };
+  if (/^http:\/\//i.test(trimmed)) {
+    throw new Error(`"${trimmed}" is plain http. The provider fetches this URL server-side and amiko-web requires https — use an https URL, or pass the local file and let the CLI upload it.`);
+  }
+  return uploadCreateInput(auth, trimmed, kind);
+}
+async function resolveCreateInputs(auth, values, kind) {
+  const out = [];
+  for (const value of values) {
+    out.push(await resolveCreateInput(auth, value, kind));
+  }
+  return out;
+}
+function mediaUrls(items) {
+  return items.map((item) => item.url);
+}
+
+// src/commands/create.ts
 var MUSIC_MAX_SECONDS = 300;
 var ETA = {
   IMAGE: "~15–60s",
@@ -28712,11 +29736,9 @@ function autoApproveLimit() {
 function collectOption(value, previous) {
   return [...previous ?? [], value];
 }
-function assertMaxUrls(resourceName, urls, max) {
-  if (urls.length > max) {
-    console.error(error(`At most ${max} ${resourceName} allowed (got ${urls.length}).`));
-    process.exit(1);
-  }
+function failInput(message) {
+  console.error(error(message));
+  process.exit(1);
 }
 function printCompleted(final, title, deliveredToThisSession = false) {
   console.log(heading(`${title}
@@ -28751,13 +29773,28 @@ async function submitCreateJob(opts) {
     console.error(error(e5 instanceof Error ? e5.message : "auth failed"));
     process.exit(1);
   }
+  let bodies;
+  if (typeof opts.bodies === "function") {
+    const uploadSpinner = process.stderr.isTTY ? ora("Preparing media…").start() : null;
+    try {
+      bodies = await opts.bodies(auth);
+    } catch (e5) {
+      uploadSpinner?.stop();
+      console.error(error(e5 instanceof Error ? e5.message : "Could not prepare the media inputs."));
+      process.exit(1);
+    }
+    uploadSpinner?.stop();
+  } else {
+    bodies = opts.bodies;
+  }
+  const { jobBody, quoteBody } = bodies;
   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) {
+  if (payCredits && 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)";
@@ -28765,7 +29802,7 @@ async function submitCreateJob(opts) {
   try {
     const q = await amikoWebFetch(auth, "/api/create/quote", {
       method: "POST",
-      body: opts.quoteBody,
+      body: quoteBody,
       timeoutMs: 15000
     });
     if (q.cost_usd != null) {
@@ -28777,7 +29814,7 @@ async function submitCreateJob(opts) {
         quotedCostAmiko = n;
     }
   } catch {}
-  const preferredToken = typeof opts.jobBody.preferredToken === "string" ? opts.jobBody.preferredToken.toUpperCase() : undefined;
+  const preferredToken = typeof jobBody.preferredToken === "string" ? jobBody.preferredToken.toUpperCase() : undefined;
   const chargeIsAmiko = !payCredits && (preferredToken === undefined || preferredToken === "AMIKO");
   const autoApprovable = payCredits || chargeIsAmiko;
   const effectiveChargeToken = preferredToken ?? "AMIKO";
@@ -28810,7 +29847,7 @@ async function submitCreateJob(opts) {
     const submit = await amikoWebFetch(auth, "/api/create/jobs", {
       method: "POST",
       body: {
-        ...opts.jobBody,
+        ...jobBody,
         twinId: auth.twinId,
         ...autoApproved && !payCredits ? { preferredToken: effectiveChargeToken, strictToken: true } : {},
         ...payCredits ? {
@@ -28874,72 +29911,150 @@ async function submitCreateJob(opts) {
   }
 }
 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("--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) => {
+  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("--reference-image <file|url>", `Image-to-image reference: local file path or https URL (repeatable). nano-banana* / gpt-image*: up to ${IMAGE_REFERENCE_MAX.multi}; image-01: exactly 1 front-facing character portrait; grok-imagine-image-quality: not supported`, collectOption, []).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.length > NON_H3_MAX_PROMPT_CHARS) {
+      failInput(`Image prompts are limited to ${NON_H3_MAX_PROMPT_CHARS} characters (got ${prompt.length}).`);
+    }
+    const referenceImages = opts.referenceImage ?? [];
+    const refProblem = validateImageReferences(opts.model, referenceImages);
+    if (refProblem)
+      failInput(refProblem);
     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: {
-        mode: "IMAGE",
-        prompt,
-        model: opts.model,
-        size: opts.aspect,
-        ...opts.token ? { preferredToken: opts.token } : {}
+      bodies: async (auth) => {
+        const resolved = mediaUrls(await resolveCreateInputs(auth, referenceImages, "image"));
+        return {
+          quoteBody: {
+            mode: "IMAGE",
+            model: opts.model,
+            size: opts.aspect,
+            ...resolved.length ? { referenceImageUrls: resolved } : {}
+          },
+          jobBody: {
+            mode: "IMAGE",
+            prompt,
+            model: opts.model,
+            size: opts.aspect,
+            ...resolved.length ? { referenceImageUrls: resolved } : {},
+            ...opts.token ? { preferredToken: opts.token } : {}
+          }
+        };
       }
     });
   });
-  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) => {
+  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), MiniMax-H3 (aliases h3, hailuo-03; T2V+I2V+reference-to-video, 768P|2K, any 4–15s, billed per second), 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 (MiniMax, Grok, Seedance); 720p, 1080p, 4k (Veo); 768P or 2K (MiniMax-H3)", "768P").option("--seconds <n>", "Clip length: 6 or 10 (Hailuo), 4/6/8 (Veo), 4/6/8/10 (Grok, Seedance), any whole number 4–15 (MiniMax-H3)", "6").option("--aspect <ratio>", "Aspect ratio (provider-dependent). MiniMax-H3 text-to-video needs a concrete ratio (21:9, 16:9, 4:3, 1:1, 3:4, 9:16); defaults to 16:9 when omitted").option("--first-frame <file|url>", "Image-to-video: first frame — local file path, https URL, or data URI").option("--last-frame <file|url>", "First-and-last-frame video: ending frame — local file path, https URL, or data URI. MiniMax-H3, Seedance and Veo only (Seedance/Veo also need --first-frame)").option("--reference-image <file|url>", "Reference-to-video: local file path or https URL (repeatable). MiniMax-H3 / Seedance / Grok: max 9; Veo: max 3; Hailuo v1: NOT supported — use --subject-reference", collectOption, []).option("--reference-video <file|url>", "Reference-to-video: local file path or https URL (repeatable, max 3). MiniMax-H3 and Seedance only; combined reference video+audio must be ≤15s, and H3 bills 15 input-seconds whenever any is attached", collectOption, []).option("--reference-audio <file|url>", "Reference-to-video: local file path or https URL (repeatable, max 3). MiniMax-H3 and Seedance only; needs an image or video reference alongside, H3 wants 2–15s per clip", collectOption, []).option("--subject-reference <file|url>", "MiniMax S2V / H3: subject/character reference image — local file path or https URL. Takes the place of --reference-image rather than adding to it").option("--generate-audio", "Seedance: generate audio in the output video").option("--no-generate-audio", "Seedance: output silent video").option("--watermark", "Seedance: burn in a watermark").option("--no-watermark", "Seedance: no watermark").option("--camera-fixed", "Seedance: hold the camera still").option("--no-camera-fixed", "Seedance: allow camera movement").option("--prompt-optimizer", "MiniMax (H3 and Hailuo v1): let the model rewrite the prompt before generating").option("--no-prompt-optimizer", "MiniMax: use the prompt verbatim").option("--fast-pretreatment", "MiniMax Hailuo v1: faster input pre-processing (ignored by H3, Veo, Grok and Seedance)").option("--no-fast-pretreatment", "MiniMax Hailuo v1: standard input pre-processing").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 model = opts.model ?? (opts.firstFrame ? "MiniMax-Hailuo-2.3-Fast" : "MiniMax-Hailuo-02");
+    const isH3 = isH3VideoModel(model);
     const seconds = Number(opts.seconds);
-    if (seconds !== 6 && seconds !== 10) {
-      console.error(error("--seconds must be 6 or 10."));
-      process.exit(1);
+    if (isH3) {
+      if (!Number.isInteger(seconds) || seconds < H3_MIN_SECONDS || seconds > H3_MAX_SECONDS) {
+        failInput(`--seconds must be a whole number from ${H3_MIN_SECONDS} to ${H3_MAX_SECONDS} for MiniMax-H3.`);
+      }
+    } else if (!NON_H3_VIDEO_SECONDS.has(seconds)) {
+      failInput("--seconds must be 4, 6, 8, or 10 (Hailuo accepts 6 or 10; use --model MiniMax-H3 for any 4–15s).");
     }
-    const referenceImageUrls = opts.referenceImage ?? [];
-    const referenceVideoUrls = opts.referenceVideo ?? [];
-    const referenceAudioUrls = opts.referenceAudio ?? [];
-    assertMaxUrls("--reference-image", referenceImageUrls, 9);
-    assertMaxUrls("--reference-video", referenceVideoUrls, 3);
-    assertMaxUrls("--reference-audio", referenceAudioUrls, 3);
+    let resolution = opts.resolution;
+    if (isH3) {
+      const upper = resolution.toUpperCase();
+      if (!H3_RESOLUTIONS.has(upper)) {
+        failInput(`MiniMax-H3 only supports 768P and 2K, not ${resolution}.`);
+      }
+      resolution = upper;
+    }
+    const maxPromptChars = isH3 ? H3_MAX_PROMPT_CHARS : NON_H3_MAX_PROMPT_CHARS;
+    if (prompt.length > maxPromptChars) {
+      failInput(`${isH3 ? "MiniMax-H3" : model} prompts are limited to ${maxPromptChars} characters (got ${prompt.length}).` + (isH3 ? "" : " MiniMax-H3 accepts up to 7000."));
+    }
+    const referenceImageArgs = opts.referenceImage ?? [];
+    const referenceVideoArgs = opts.referenceVideo ?? [];
+    const referenceAudioArgs = opts.referenceAudio ?? [];
     const generateAudio = opts.generateAudio;
-    const model = opts.model ?? (opts.firstFrame ? "MiniMax-Hailuo-2.3-Fast" : "MiniMax-Hailuo-02");
+    const promptOptimizer = opts.promptOptimizer;
+    const watermark = opts.watermark;
+    const cameraFixed = opts.cameraFixed;
+    const fastPretreatment = opts.fastPretreatment;
+    const referenceProblem = validateVideoReferences({
+      model,
+      firstFrame: opts.firstFrame,
+      lastFrame: opts.lastFrame,
+      subjectReference: opts.subjectReference,
+      referenceImageUrls: referenceImageArgs,
+      referenceVideoUrls: referenceVideoArgs,
+      referenceAudioUrls: referenceAudioArgs
+    });
+    if (referenceProblem)
+      failInput(referenceProblem);
+    const hasFrame = Boolean(opts.firstFrame) || Boolean(opts.lastFrame);
+    const hasReference = Boolean(opts.subjectReference) || referenceImageArgs.length > 0 || referenceVideoArgs.length > 0 || referenceAudioArgs.length > 0;
+    const hasVisualInput = hasFrame || hasReference;
+    let aspect = opts.aspect;
+    if (isH3 && !hasVisualInput) {
+      if (!aspect) {
+        aspect = H3_DEFAULT_T2V_ASPECT;
+        if (!opts.raw) {
+          console.error(dim(`MiniMax-H3 text-to-video needs an aspect ratio; using ${aspect}.`));
+        }
+      } else if (!H3_CONCRETE_RATIOS.has(aspect)) {
+        failInput(`MiniMax-H3 text-to-video needs a specific aspect ratio (${[...H3_CONCRETE_RATIOS].join(", ")}), not ${aspect}.`);
+      }
+    }
     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,
-        size: opts.resolution,
-        seconds,
-        ...referenceVideoUrls.length ? { referenceVideoUrls } : {}
-      },
-      jobBody: {
-        mode: "VIDEO",
-        prompt,
-        model,
-        resolution: opts.resolution,
-        seconds,
-        ...opts.aspect ? { aspectRatio: opts.aspect } : {},
-        ...opts.firstFrame ? { firstFrameImage: opts.firstFrame } : {},
-        ...opts.lastFrame ? { lastFrameImage: opts.lastFrame } : {},
-        ...referenceImageUrls.length ? { referenceImageUrls } : {},
-        ...referenceVideoUrls.length ? { referenceVideoUrls } : {},
-        ...referenceAudioUrls.length ? { referenceAudioUrls } : {},
-        ...opts.subjectReference ? {
-          subjectReference: [
-            {
-              type: "character",
-              image: [opts.subjectReference]
-            }
-          ]
-        } : {},
-        ...generateAudio !== undefined ? { generateAudio } : {},
-        ...opts.token ? { preferredToken: opts.token } : {}
+      bodies: async (auth) => {
+        const firstFrame = opts.firstFrame ? (await resolveCreateInput(auth, opts.firstFrame, "image", { allowDataUri: true })).url : undefined;
+        const lastFrame = opts.lastFrame ? (await resolveCreateInput(auth, opts.lastFrame, "image", { allowDataUri: true })).url : undefined;
+        const subjectReference = opts.subjectReference ? (await resolveCreateInput(auth, opts.subjectReference, "image")).url : undefined;
+        const referenceImages = await resolveCreateInputs(auth, referenceImageArgs, "image");
+        const referenceVideos = await resolveCreateInputs(auth, referenceVideoArgs, "video");
+        const referenceAudio = await resolveCreateInputs(auth, referenceAudioArgs, "audio");
+        const durationProblem = validateReferenceDurations(model, referenceVideos.map((m) => m.durationMs), referenceAudio.map((m) => m.durationMs));
+        if (durationProblem)
+          failInput(durationProblem);
+        const referenceImageUrls = mediaUrls(referenceImages);
+        const referenceVideoUrls = mediaUrls(referenceVideos);
+        const referenceAudioUrls = mediaUrls(referenceAudio);
+        return {
+          quoteBody: {
+            mode: "VIDEO",
+            model,
+            size: resolution,
+            seconds,
+            ...referenceVideoUrls.length ? { referenceVideoUrls } : {},
+            ...referenceImageUrls.length ? { referenceImageUrls } : {}
+          },
+          jobBody: {
+            mode: "VIDEO",
+            prompt,
+            model,
+            resolution,
+            seconds,
+            ...aspect ? { aspectRatio: aspect } : {},
+            ...firstFrame ? { firstFrameImage: firstFrame } : {},
+            ...lastFrame ? { lastFrameImage: lastFrame } : {},
+            ...referenceImageUrls.length ? { referenceImageUrls } : {},
+            ...referenceVideoUrls.length ? { referenceVideoUrls } : {},
+            ...referenceAudioUrls.length ? { referenceAudioUrls } : {},
+            ...subjectReference ? {
+              subjectReference: [
+                { type: "character", image: [subjectReference] }
+              ]
+            } : {},
+            ...generateAudio !== undefined ? { generateAudio } : {},
+            ...promptOptimizer !== undefined ? { promptOptimizer } : {},
+            ...fastPretreatment !== undefined ? { fastPretreatment } : {},
+            ...watermark !== undefined ? { watermark } : {},
+            ...cameraFixed !== undefined ? { cameraFixed } : {},
+            ...opts.token ? { preferredToken: opts.token } : {}
+          }
+        };
       }
     });
   });
@@ -28985,17 +30100,19 @@ function registerCreateCommand(create2) {
       raw: opts.raw,
       pay: opts.pay,
       yes: opts.yes,
-      quoteBody: { mode: "TTS", model, prompt: text, voiceId: voice },
-      jobBody: {
-        mode: "TTS",
-        prompt: text,
-        model,
-        voiceId: voice,
-        ...opts.token ? { preferredToken: opts.token } : {}
+      bodies: {
+        quoteBody: { mode: "TTS", model, prompt: text, voiceId: voice },
+        jobBody: {
+          mode: "TTS",
+          prompt: text,
+          model,
+          voiceId: voice,
+          ...opts.token ? { preferredToken: opts.token } : {}
+        }
       }
     });
   });
-  create2.command("music [prompt]").description("Generate music (Create Studio)").option("--model <model>", "music-3.0 (default), music-cover, music_v1. The retired MiniMax ids (music-2.0/2.5/2.6, -free) still resolve to music-3.0", "music-3.0").option("--lyrics <lyrics>", "Lyrics (optional; a prompt is still required for the style). Needs section tags on their own lines, e.g. [verse] / [chorus] — plain lyrics are rejected").option("--duration <seconds>", "Track length in seconds, 1-300 — music-3.0 bills per second, so this sets the price").option("--audio-url <url>", "Public audio URL to cover (required by --model music-cover)").option("--instrumental", "Instrumental (no vocals)").option("--lyrics-optimizer", "Auto-write lyrics from the prompt. Only affects music_v1 — the fal models always write their own when no --lyrics is given").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) => {
+  create2.command("music [prompt]").description("Generate music (Create Studio)").option("--model <model>", "music-3.0 (default), music-cover, music_v1. The retired MiniMax ids (music-2.0/2.5/2.6, -free) still resolve to music-3.0", "music-3.0").option("--lyrics <lyrics>", "Lyrics (optional; a prompt is still required for the style). Needs section tags on their own lines, e.g. [verse] / [chorus] — plain lyrics are rejected").option("--duration <seconds>", "Track length in seconds, 1-300 — music-3.0 bills per second, so this sets the price").option("--audio-url <file|url>", "Audio to cover — local file path or https URL (required by --model music-cover)").option("--instrumental", "Instrumental (no vocals)").option("--lyrics-optimizer", "Auto-write lyrics from the prompt. Only affects music_v1 — the fal models always write their own when no --lyrics is given").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 isCover = String(opts.model ?? "").startsWith("music-cover");
     if (isCover) {
       if (!opts.audioUrl) {
@@ -29026,21 +30143,26 @@ function registerCreateCommand(create2) {
       raw: opts.raw,
       pay: opts.pay,
       yes: opts.yes,
-      quoteBody: {
-        mode: "MUSIC",
-        model: opts.model,
-        ...durationMs ? { durationMs } : {}
-      },
-      jobBody: {
-        mode: "MUSIC",
-        model: opts.model,
-        ...prompt ? { prompt } : {},
-        ...opts.lyrics ? { lyrics: opts.lyrics } : {},
-        ...durationMs ? { durationMs } : {},
-        ...opts.audioUrl ? { audioUrl: opts.audioUrl } : {},
-        ...opts.instrumental ? { isInstrumental: true } : {},
-        ...opts.lyricsOptimizer ? { lyricsOptimizer: true } : {},
-        ...opts.token ? { preferredToken: opts.token } : {}
+      bodies: async (auth) => {
+        const audioUrl = opts.audioUrl ? (await resolveCreateInput(auth, opts.audioUrl, "audio")).url : undefined;
+        return {
+          quoteBody: {
+            mode: "MUSIC",
+            model: opts.model,
+            ...durationMs ? { durationMs } : {}
+          },
+          jobBody: {
+            mode: "MUSIC",
+            model: opts.model,
+            ...prompt ? { prompt } : {},
+            ...opts.lyrics ? { lyrics: opts.lyrics } : {},
+            ...durationMs ? { durationMs } : {},
+            ...audioUrl ? { audioUrl } : {},
+            ...opts.instrumental ? { isInstrumental: true } : {},
+            ...opts.lyricsOptimizer ? { lyricsOptimizer: true } : {},
+            ...opts.token ? { preferredToken: opts.token } : {}
+          }
+        };
       }
     });
   });
@@ -29051,12 +30173,14 @@ function registerCreateCommand(create2) {
       raw: opts.raw,
       pay: opts.pay,
       yes: opts.yes,
-      quoteBody: { mode: "SFX" },
-      jobBody: {
-        mode: "SFX",
-        prompt: text,
-        ...opts.duration ? { durationSeconds: Number(opts.duration) } : {},
-        ...opts.token ? { preferredToken: opts.token } : {}
+      bodies: {
+        quoteBody: { mode: "SFX" },
+        jobBody: {
+          mode: "SFX",
+          prompt: text,
+          ...opts.duration ? { durationSeconds: Number(opts.duration) } : {},
+          ...opts.token ? { preferredToken: opts.token } : {}
+        }
       }
     });
   });
@@ -29141,111 +30265,6 @@ More available — raise --limit to see more.`));
   });
 }
 
-// src/lib/file-input.ts
-import { readFile } from "node:fs/promises";
-import { basename, extname } from "node:path";
-var MAX_BYTES = 100 * 1024 * 1024;
-var FETCH_TIMEOUT_MS = 30000;
-async function resolveFileInput(src, opts = {}) {
-  const maxBytes = opts.maxBytes ?? MAX_BYTES;
-  if (src === "-" || opts.stdin) {
-    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, 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 > 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(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 > maxBytes) {
-      throw new Error(`stdin exceeded ${maxBytes} byte cap.`);
-    }
-    chunks.push(buf);
-  }
-  return Buffer.concat(chunks);
-}
-async function fetchRemote(url2, maxBytes) {
-  const controller = new AbortController;
-  const timer = setTimeout(() => controller.abort(), FETCH_TIMEOUT_MS);
-  try {
-    const res = await fetch(url2, { signal: controller.signal });
-    if (!res.ok) {
-      throw new Error(`Fetch ${url2} failed: ${res.status} ${res.statusText}`);
-    }
-    const len = Number(res.headers.get("content-length") || 0);
-    if (len > maxBytes) {
-      throw new Error(`Remote file too large: ${len} bytes exceeds ${maxBytes} byte cap.`);
-    }
-    const buf = Buffer.from(await res.arrayBuffer());
-    if (buf.length > maxBytes) {
-      throw new Error(`Remote file too large: ${buf.length} bytes exceeds ${maxBytes} byte cap.`);
-    }
-    return buf;
-  } finally {
-    clearTimeout(timer);
-  }
-}
-var MAGIC = [
-  [Buffer.from([37, 80, 68, 70]), "application/pdf"],
-  [Buffer.from([137, 80, 78, 71]), "image/png"],
-  [Buffer.from([255, 216, 255]), "image/jpeg"],
-  [Buffer.from([71, 73, 70, 56]), "image/gif"],
-  [Buffer.from([82, 73, 70, 70]), "audio/wav"],
-  [Buffer.from([73, 68, 51]), "audio/mpeg"],
-  [Buffer.from([255, 251]), "audio/mpeg"],
-  [Buffer.from([80, 75, 3, 4]), "application/zip"]
-];
-var EXT_MIME = {
-  ".pdf": "application/pdf",
-  ".png": "image/png",
-  ".jpg": "image/jpeg",
-  ".jpeg": "image/jpeg",
-  ".gif": "image/gif",
-  ".webp": "image/webp",
-  ".txt": "text/plain",
-  ".md": "text/markdown",
-  ".json": "application/json",
-  ".wav": "audio/wav",
-  ".mp3": "audio/mpeg",
-  ".m4a": "audio/mp4",
-  ".ogg": "audio/ogg",
-  ".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) {
-  for (const [sig, mime] of MAGIC) {
-    if (buffer.length >= sig.length && buffer.subarray(0, sig.length).equals(sig)) {
-      return mime;
-    }
-  }
-  const ext = extname(name).toLowerCase();
-  return EXT_MIME[ext] ?? "application/octet-stream";
-}
-
 // src/lib/conversations.ts
 var UUID_RE = /^[0-9a-f]{8}-[0-9a-f]{4}-[0-9a-f]{4}-[0-9a-f]{4}-[0-9a-f]{12}$/i;
 var CUID_RE = /^c[a-z0-9]{20,}$/i;
@@ -31215,97 +32234,12 @@ 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 — pay in AMIKO, USDC, or USDT");
-  cmd.command("search <query>").description("Search Amazon products — $0.01, paid in AMIKO, USDC, or USDT").option("--limit <n>", "Number of results", "5").option("--wallet <address>", "Wallet to pay from (defaults to your Solana wallet — run `amiko wallets create --chain solana` if you don't have one)").option("--token <token>", "Payment token (AMIKO, USDC, USDT)", "AMIKO").option("--raw", "Output raw JSON").option("--yes", "Skip the pre-spend confirmation (required in non-interactive shells)").action(async (query, opts) => {
-    let payToken;
-    try {
-      payToken = normalizePaymentToken(opts.token);
-    } catch (e5) {
-      console.error(error(e5 instanceof Error ? e5.message : String(e5)));
-      process.exit(1);
-    }
-    let quote;
-    try {
-      quote = await quoteTokenAmount(resolveAuth(), payToken, AMAZON_SEARCH_USD);
-    } catch (e5) {
-      console.error(error(e5 instanceof Error ? e5.message : String(e5)));
-      process.exit(1);
-    }
-    await requireApproval({
-      cost: `${quote.amount} ${payToken} (≈ $${AMAZON_SEARCH_USD.toFixed(2)})`,
-      summary: `Amazon product search: ${query.slice(0, 80)}${query.length > 80 ? "…" : ""}`,
-      yes: opts.yes,
-      commandExample: `amiko markets amazon search ${JSON.stringify(query)}${payToken !== "AMIKO" ? ` --token ${payToken}` : ""}`
-    });
-    const spinner = ora("Searching Amazon...").start();
-    try {
-      const config2 = loadConfig();
-      let auth;
-      try {
-        auth = requireAuth();
-      } catch (e5) {
-        spinner.stop();
-        console.error(error(e5 instanceof Error ? e5.message : "auth failed"));
-        process.exit(1);
-      }
-      const mppBase2 = (config2.apiBase || "https://mpp.amikomarkets.com").replace(/\/$/, "");
-      let wallet;
-      try {
-        wallet = await resolveWalletAddress(auth, opts.wallet, "solana");
-      } catch (e5) {
-        spinner.stop();
-        console.error(error(e5 instanceof Error ? e5.message : String(e5)));
-        process.exit(1);
-      }
-      spinner.text = `Paying ${quote.amount} ${payToken}...`;
-      const txHash = await payTreasury(auth, { wallet, amount: quote.amount, token: payToken });
-      spinner.text = "Searching Amazon...";
-      const params = new URLSearchParams({
-        q: `site:amazon.com ${query}`
-      });
-      const res = await fetch(`${mppBase2}/v1/search/google_shopping?${params}`, {
-        headers: { "X-Payment-Tx": txHash, "X-Payment-Token": payToken, "X-Twin-Id": auth.twinId }
-      });
-      spinner.stop();
-      if (!res.ok) {
-        await reportHttpError(res, "Amazon search");
-        process.exit(1);
-      }
-      const data = await res.json();
-      if (opts.raw) {
-        console.log(JSON.stringify(data, null, 2));
-        return;
-      }
-      console.log(heading(`Amazon: "${query}"
-`));
-      const results = data.shopping_results || data.organic_results || [];
-      const limit = parseInt(opts.limit) || 5;
-      for (const item of results.slice(0, limit)) {
-        const title = item.title || "Unknown";
-        const price = item.price || item.extracted_price || "";
-        const link = item.link || item.product_link || "";
-        const asin = link.match(/\/dp\/([A-Z0-9]{10})/)?.[1] || "";
-        console.log(`  ${source_default.cyan(title)}`);
-        if (price)
-          console.log(`  ${source_default.yellow(typeof price === "string" ? price : `$${price}`)}`);
-        if (asin)
-          console.log(dim(`  ASIN: ${asin}`));
-        if (link)
-          console.log(dim(`  ${link.slice(0, 80)}`));
-        console.log("");
-      }
-      if (results.length === 0) {
-        console.log(dim("  No results found."));
-      }
-      console.log(success("Paid 1 AMIKO") + dim(` tx: ${txHash.slice(0, 16)}...`));
-      await printBalanceRemaining(auth);
-    } catch (err) {
-      spinner.stop();
-      console.error(error(err instanceof Error ? err.message : "Search failed"));
-      process.exit(1);
-    }
+  const cmd = program2.command("amazon").description("Buy products on Amazon — quote and order, paid in AMIKO, USDC, or USDT");
+  attachSearchOptions(cmd.command("search <query...>").description("[deprecated — use `amiko search amazon`] Search Amazon products — $0.01"), "amazon").action(async (parts, opts) => {
+    const query = oneQuery(parts, "amazon");
+    console.error(warn("`amiko markets amazon search` is deprecated — use `amiko search amazon`."));
+    await runVertical("amazon", query, opts, `amiko markets amazon search ${JSON.stringify(query)}`);
   });
   cmd.command("quote <product>").description("Get price quote for an Amazon product (ASIN or URL) — free").option("--raw", "Output raw JSON").action(async (product, opts) => {
     const spinner = ora("Getting quote...").start();
@@ -31794,7 +32728,7 @@ 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";
+import { basename as basename3, 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;
@@ -32047,7 +32981,7 @@ Search hits filename, title, description, and parsed RAG content (once processed
         process.stdout.write(buf);
         return;
       }
-      const outPath = resolvePath(opts.out ?? basename2(meta3.doc.filename));
+      const outPath = resolvePath(opts.out ?? basename3(meta3.doc.filename));
       await writeFile2(outPath, buf);
       spinner?.stop();
       console.log(success(`Saved ${meta3.doc.filename} → ${outPath}`));
@@ -34389,7 +35323,7 @@ function registerNotificationsCommand(program2) {
 
 // src/commands/memory.ts
 import { existsSync as existsSync2, readFileSync as readFileSync2, statSync as statSync2 } from "node:fs";
-import { basename as basename3, resolve } from "node:path";
+import { basename as basename4, resolve } from "node:path";
 var VALID_CATEGORIES = ["fact", "preference", "pattern", "decision", "context"];
 var VALID_SOURCES = ["chat", "file", "manual"];
 var UPLOAD_BATCH_SIZE = 100;
@@ -34587,7 +35521,7 @@ function registerMemoryCommand(program2) {
       } catch (e5) {
         fail(`Failed to read ${f}: ${e5 instanceof Error ? e5.message : String(e5)}`);
       }
-      const key = keyOverride && files.length === 1 ? keyOverride : basename3(abs);
+      const key = keyOverride && files.length === 1 ? keyOverride : basename4(abs);
       if (seenKeys.has(key)) {
         fail(`Duplicate path key "${key}" within this upload. Run separately or pass --key per file.`);
       }
@@ -34853,55 +35787,61 @@ function registerWalletsListCommand(program2) {
   });
 }
 
+// src/program.ts
+function buildProgram(version3) {
+  const program2 = new Command;
+  program2.name("amiko").description("Amiko CLI — Create Studio media generation, chats, drive, credits & wallets, social graph, and paid MPP marketplace services").version(version3);
+  const markets = program2.command("markets").description("MPP marketplace — discover and call paid AMIKO services");
+  const create2 = program2.command("create").description("Create Studio — generate images, video, speech, music, and SFX (charged on success)");
+  const chat = program2.command("chat").description("Your conversations (DMs + group chats) as the owner — list, read, send, manage groups");
+  const card = program2.command("card").description("Twin Cards (work/play/love) — generate, view, download, mint");
+  const wallets = program2.command("wallets").description("Manage twin wallets — list, swap, bridge");
+  const twin = program2.command("twin").description("Update twin identity (name, description, visibility)");
+  const drive = program2.command("drive").alias("docs").description("Manage twin drive — upload/download/search files, organise into folders");
+  const voice = program2.command("voice").description("Manage twin voice — design, create, clone, reset");
+  const avatar = program2.command("avatar").description("Manage twin avatar image");
+  const friends = program2.command("friends").description("Manage friendships — list, requests, add, accept, remove, nicknames, reports, matches");
+  const users = program2.command("users").description("Search users, view public profiles, and manage follows (follow, unfollow, followers, following)");
+  const post = program2.command("post").description("Create posts (notes) and comments on the feed — text, images, and documents");
+  const review = program2.command("review").description("Review queue — list, approve, or reject twin-drafted comments");
+  const notifications = program2.command("notifications").description("Platform notifications — list, mark as read");
+  registerCreditsCommand(program2);
+  registerSearchCommand(program2);
+  registerDeprecatedMarketsSearch(markets);
+  registerImageCommand(markets);
+  registerCreateCommand(create2);
+  registerChatCommand(chat);
+  registerCardCommand(card);
+  registerAmazonCommand(markets);
+  registerWalletsCreateCommand(wallets);
+  registerWalletsListCommand(wallets);
+  registerWalletsBalanceCommand(wallets);
+  registerWalletsTransferCommand(wallets);
+  registerSwapCommand(wallets);
+  registerBridgeCommand(wallets);
+  registerConfigCommand(program2);
+  registerServicesCommand(markets);
+  registerDiscoveryCommand(markets);
+  registerUpdateCommand(program2);
+  registerAccountsCommand(program2);
+  registerTwinCommand(twin);
+  registerDriveCommand(drive);
+  registerVoiceCommand(voice);
+  registerAvatarCommand(avatar);
+  registerFriendsCommand(friends);
+  registerUsersCommand(users);
+  registerFeedCommand(program2);
+  registerPostCommand(post);
+  registerReviewCommand(review);
+  registerNotificationsCommand(notifications);
+  registerMemoryCommand(program2);
+  return program2;
+}
+
 // src/index.ts
 var require2 = createRequire2(import.meta.url);
 var { version: PKG_VERSION } = require2("../package.json");
 var didOnboard = await runOnboarding(process.argv);
 if (didOnboard)
   process.exit(0);
-var program2 = new Command;
-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, 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, 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);
-registerSearchCommand(markets);
-registerImageCommand(markets);
-registerCreateCommand(create2);
-registerChatCommand(chat);
-registerCardCommand(card);
-registerAmazonCommand(markets);
-registerWalletsCreateCommand(wallets);
-registerWalletsListCommand(wallets);
-registerWalletsBalanceCommand(wallets);
-registerWalletsTransferCommand(wallets);
-registerSwapCommand(wallets);
-registerBridgeCommand(wallets);
-registerConfigCommand(program2);
-registerServicesCommand(markets);
-registerDiscoveryCommand(markets);
-registerUpdateCommand(program2);
-registerAccountsCommand(program2);
-registerTwinCommand(twin);
-registerDriveCommand(drive);
-registerVoiceCommand(voice);
-registerAvatarCommand(avatar);
-registerFriendsCommand(friends);
-registerUsersCommand(users);
-registerFeedCommand(program2);
-registerPostCommand(post);
-registerReviewCommand(review);
-registerNotificationsCommand(notifications);
-registerMemoryCommand(program2);
-program2.parse();
+buildProgram(PKG_VERSION).parse();