@heyamiko/amiko-cli 0.16.4 → 0.17.1

package/README.md

@@ -880,8 +880,8 @@ Generate a video (Create Studio)
 | Flag | Default | Description |
 |---|---|---|
 | `--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), S2V-01 (default with --subject-reference; the only MiniMax model that accepts subject_reference), 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-2-5-260628 (BytePlus Seedance 2.5; any whole 4–30s, billed per token so a long 1080p clip runs into dollars — quote it), other dreamina-seedance-* (BytePlus, ≤15s). ONLY these — kling and other ids are not supported |
-| `--resolution <res>` | `768P` | 512P, 720P, 768P, 1080P (MiniMax, Grok, Seedance); 720p, 1080p, 4k (Veo); 768P or 2K (MiniMax-H3) |
-| `--seconds <n>` | `6` | Clip length: 6 or 10 (Hailuo), 4/6/8 (Veo), 4/6/8/10 (Grok, Seedance 2.0), any whole number 4–15 (MiniMax-H3), any whole number 4–30 (Seedance 2.5) |
+| `--resolution <res>` | `768P` | 512P, 720P, 768P, 1080P (MiniMax, Grok, Seedance); 720p, 1080p, 4k (Veo); 768P or 2K (MiniMax-H3). Hailuo pairs these with --seconds: 1080P is 6s only, and 512P exists on MiniMax-Hailuo-02 alone |
+| `--seconds <n>` | `6` | Clip length: 6 or 10 (Hailuo — 10 needs 768P or lower, since 1080P is 6s only), 4/6/8 (Veo), 4/6/8/10 (Grok, Seedance 2.0), any whole number 4–15 (MiniMax-H3), any whole number 4–30 (Seedance 2.5) |
 | `--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 |
 | `--first-frame <file|url>` |  | Image-to-video: first frame — local file path, https URL, or data URI |
 | `--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) |
@@ -2042,6 +2042,7 @@ Create posts (notes) and comments on the feed — text, images, and documents
 | `post create` | Create a post (a.k.a. note) on your feed |
 | `post drafts` | List your draft posts (newest first) |
 | `post publish` | Publish a draft post (stamps a fresh timestamp and notifies mentions) |
+| `post delete` | Delete one of your posts. Use this to clean up a post that went out wrong (bad link, test post, wrong version) |
 | `post comments` | List comments on a post |
 | `post comment` | Comment on a post |
 | `post likers` | List everyone who liked ONE OF THE OWNER'S OWN posts — pages through ALL likes (up to a cap), for 'who/which friends liked this'. Another user's post returns 403: engagement lists are visible only to the post's owner |
@@ -2053,11 +2054,13 @@ Create a post (a.k.a. note) on your feed
 | Flag | Default | Description |
 |---|---|---|
 | `--content <text>` |  | Post body. Optional when --media or --doc is given (an image-only note is a normal post) |
+| `--markdown` |  | Render --content as markdown (bold/lists/links/tables). @mentions and #hashtags still link. Default is plain text. |
 | `--title <text>` |  | Note title, max 150 chars — the heading shown on the feed card. Optional but strongly recommended for image notes |
 | `--visibility <public|private>` | `public` | Post visibility |
 | `--media <pathOrUrl...>` |  | Attach media: local IMAGE file paths (uploaded automatically); Amiko-hosted URLs (image/music/video from `amiko create`); or `drive:<docId>` for a media file in your Drive (`amiko drive list`) |
 | `--doc <pathOrUrl...>` |  | Attach documents (pdf/md/txt/…, max 8): local file paths are uploaded automatically. Rendered as file cards, not images |
 | `--draft` |  | Save as a draft instead of publishing (list: amiko post drafts · publish: amiko post publish <id>) |
+| `--yes` |  | Skip the publish confirmation (drafts never prompt). Only pass this after the owner has reviewed the exact copy and approved sending it. |
 | `--json` |  | Output as JSON |
 
 #### `amiko post drafts`
@@ -2076,6 +2079,16 @@ Publish a draft post (stamps a fresh timestamp and notifies mentions)
 
 | Flag | Default | Description |
 |---|---|---|
+| `--yes` |  | Skip the publish confirmation. Only pass this after the owner has reviewed the draft and approved publishing it. |
+| `--json` |  | Output as JSON |
+
+#### `amiko post delete <postId>`
+
+Delete one of your posts. Use this to clean up a post that went out wrong (bad link, test post, wrong version)
+
+| Flag | Default | Description |
+|---|---|---|
+| `--yes` |  | Skip confirmation. Only pass this after the owner has confirmed which post to remove. |
 | `--json` |  | Output as JSON |
 
 #### `amiko post comments`

package/dist/index.js

@@ -29311,6 +29311,49 @@ 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]);
+var HAILUO_COMBOS = {
+  "MiniMax-Hailuo-02:512P": [6, 10],
+  "MiniMax-Hailuo-02:768P": [6, 10],
+  "MiniMax-Hailuo-02:1080P": [6],
+  "MiniMax-Hailuo-2.3:768P": [6, 10],
+  "MiniMax-Hailuo-2.3:1080P": [6],
+  "MiniMax-Hailuo-2.3-Fast:768P": [6, 10],
+  "MiniMax-Hailuo-2.3-Fast:1080P": [6]
+};
+var HAILUO_MATRIX_FAMILY = /^MiniMax-Hailuo-/i;
+function canonicalHailuoModel(model) {
+  const aliases = {
+    "hailuo-02": "MiniMax-Hailuo-02",
+    "hailuo-2.3": "MiniMax-Hailuo-2.3",
+    "hailuo-2.3-fast": "MiniMax-Hailuo-2.3-Fast"
+  };
+  const byAlias = aliases[model.toLowerCase()];
+  if (byAlias)
+    return byAlias;
+  if (!HAILUO_MATRIX_FAMILY.test(model))
+    return null;
+  const known = ["MiniMax-Hailuo-02", "MiniMax-Hailuo-2.3", "MiniMax-Hailuo-2.3-Fast"];
+  return known.find((m) => m.toLowerCase() === model.toLowerCase()) ?? null;
+}
+function hailuoComboError(model, resolution, seconds) {
+  const id = canonicalHailuoModel(model);
+  if (!id)
+    return null;
+  const upper = resolution.toUpperCase();
+  const tier = upper === "720P" ? "768P" : upper;
+  const allowed = HAILUO_COMBOS[`${id}:${tier}`];
+  if (allowed?.includes(seconds))
+    return null;
+  const tiersForSeconds = Object.keys(HAILUO_COMBOS).filter((k) => k.startsWith(`${id}:`) && HAILUO_COMBOS[k].includes(seconds)).map((k) => k.split(":")[1]);
+  const fixes = [];
+  if (allowed?.length) {
+    fixes.push(`${tier} renders at ${allowed.join("s or ")}s`);
+  }
+  if (tiersForSeconds.length) {
+    fixes.push(`${seconds}s renders at ${tiersForSeconds.join(" or ")}`);
+  }
+  return `${id} does not support ${tier} at ${seconds}s` + (fixes.length ? ` — ${fixes.join("; ")}.` : ".") + " Use --model MiniMax-H3 for any 4–15s at 768P or 2K.";
+}
 var SEEDANCE_25_MODEL = /^(dreamina-)?seedance-2-5(-|$)/i;
 var SEEDANCE_25_MIN_SECONDS = 4;
 var SEEDANCE_25_MAX_SECONDS = 30;
@@ -29980,7 +30023,7 @@ function registerCreateCommand(create2) {
       }
     });
   });
-  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), S2V-01 (default with --subject-reference; the only MiniMax model that accepts subject_reference), 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-2-5-260628 (BytePlus Seedance 2.5; any whole 4–30s, billed per token so a long 1080p clip runs into dollars — quote it), other dreamina-seedance-* (BytePlus, ≤15s). 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 2.0), any whole number 4–15 (MiniMax-H3), any whole number 4–30 (Seedance 2.5)", "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 --model MiniMax-H3", 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>", "Subject/character reference image — local file path or https URL. Takes the place of --reference-image rather than adding to it. Selects S2V-01 unless --model says otherwise; Hailuo 02/2.3/2.3-Fast reject it, use MiniMax-H3 for reference-to-video").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) => {
+  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), S2V-01 (default with --subject-reference; the only MiniMax model that accepts subject_reference), 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-2-5-260628 (BytePlus Seedance 2.5; any whole 4–30s, billed per token so a long 1080p clip runs into dollars — quote it), other dreamina-seedance-* (BytePlus, ≤15s). 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). Hailuo pairs these with --seconds: 1080P is 6s only, and 512P exists on MiniMax-Hailuo-02 alone", "768P").option("--seconds <n>", "Clip length: 6 or 10 (Hailuo — 10 needs 768P or lower, since 1080P is 6s only), 4/6/8 (Veo), 4/6/8/10 (Grok, Seedance 2.0), any whole number 4–15 (MiniMax-H3), any whole number 4–30 (Seedance 2.5)", "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 --model MiniMax-H3", 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>", "Subject/character reference image — local file path or https URL. Takes the place of --reference-image rather than adding to it. Selects S2V-01 unless --model says otherwise; Hailuo 02/2.3/2.3-Fast reject it, use MiniMax-H3 for reference-to-video").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.subjectReference ? "S2V-01" : opts.firstFrame ? "MiniMax-Hailuo-2.3-Fast" : "MiniMax-Hailuo-02");
     const isH3 = isH3VideoModel(model);
     const seconds = Number(opts.seconds);
@@ -30003,6 +30046,9 @@ function registerCreateCommand(create2) {
       }
       resolution = upper;
     }
+    const comboProblem = hailuoComboError(model, resolution, seconds);
+    if (comboProblem)
+      failInput(comboProblem);
     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."));
@@ -34944,7 +34990,7 @@ function registerFeedCommand(program2) {
   });
 }
 function registerPostCommand(program2) {
-  program2.command("create").description("Create a post (a.k.a. note) on your feed").option("--content <text>", "Post body. Optional when --media or --doc is given (an image-only note is a normal post)").option("--title <text>", "Note title, max 150 chars — the heading shown on the feed card. Optional but strongly recommended for image notes").option("--visibility <public|private>", "Post visibility", "public").option("--media <pathOrUrl...>", "Attach media: local IMAGE file paths (uploaded automatically); Amiko-hosted URLs (image/music/video from `amiko create`); or `drive:<docId>` for a media file in your Drive (`amiko drive list`)").option("--doc <pathOrUrl...>", "Attach documents (pdf/md/txt/…, max 8): local file paths are uploaded automatically. Rendered as file cards, not images").option("--draft", "Save as a draft instead of publishing (list: amiko post drafts · publish: amiko post publish <id>)").option("--json", "Output as JSON").action(async (opts) => {
+  program2.command("create").description("Create a post (a.k.a. note) on your feed").option("--content <text>", "Post body. Optional when --media or --doc is given (an image-only note is a normal post)").option("--markdown", "Render --content as markdown (bold/lists/links/tables). @mentions and #hashtags still link. Default is plain text.").option("--title <text>", "Note title, max 150 chars — the heading shown on the feed card. Optional but strongly recommended for image notes").option("--visibility <public|private>", "Post visibility", "public").option("--media <pathOrUrl...>", "Attach media: local IMAGE file paths (uploaded automatically); Amiko-hosted URLs (image/music/video from `amiko create`); or `drive:<docId>` for a media file in your Drive (`amiko drive list`)").option("--doc <pathOrUrl...>", "Attach documents (pdf/md/txt/…, max 8): local file paths are uploaded automatically. Rendered as file cards, not images").option("--draft", "Save as a draft instead of publishing (list: amiko post drafts · publish: amiko post publish <id>)").option("--yes", "Skip the publish confirmation (drafts never prompt). Only pass this after the owner has reviewed the exact copy and approved sending it.").option("--json", "Output as JSON").action(async (opts) => {
     const auth = resolveAuth();
     const visibility = opts.visibility === "private" ? "private" : "public";
     const content = opts.content?.trim() ?? "";
@@ -34958,6 +35004,19 @@ function registerPostCommand(program2) {
       console.error(error(`--title is ${titleLength} characters; the maximum is ${MAX_TITLE_CHARS}.`));
       process.exit(1);
     }
+    if (!opts.draft) {
+      const previewLine = (title ? `${title} — ` : "") + content;
+      const attachSummary = [
+        opts.media?.length ? `${opts.media.length} media` : "",
+        opts.doc?.length ? `${opts.doc.length} doc` : ""
+      ].filter(Boolean).join(", ");
+      await requireApproval({
+        free: "publishes a post to your public feed — everyone can see it",
+        summary: `Publish ${visibility} post${attachSummary ? ` [+${attachSummary}]` : ""}: ${previewLine.slice(0, 80)}${previewLine.length > 80 ? "…" : ""}`,
+        yes: opts.yes,
+        commandExample: `amiko post create` + (opts.content ? ` --content ${JSON.stringify(opts.content)}` : "") + (opts.markdown ? " --markdown" : "") + (opts.title ? ` --title ${JSON.stringify(opts.title)}` : "") + (opts.visibility && opts.visibility !== "public" ? ` --visibility ${opts.visibility}` : "") + (opts.media?.length ? ` --media ${opts.media.map((m) => JSON.stringify(m)).join(" ")}` : "") + (opts.doc?.length ? ` --doc ${opts.doc.map((d) => JSON.stringify(d)).join(" ")}` : "")
+      });
+    }
     const workingText = opts.draft ? "Saving draft..." : "Publishing post...";
     const spinner = opts.json ? null : ora(workingText).start();
     try {
@@ -34965,6 +35024,8 @@ function registerPostCommand(program2) {
         content,
         visibility
       };
+      if (opts.markdown)
+        body.content_format = "markdown";
       if (title)
         body.title = title;
       if (opts.draft)
@@ -35068,8 +35129,14 @@ function registerPostCommand(program2) {
       process.exit(1);
     }
   });
-  program2.command("publish <postId>").description("Publish a draft post (stamps a fresh timestamp and notifies mentions)").option("--json", "Output as JSON").action(async (postId, opts) => {
+  program2.command("publish <postId>").description("Publish a draft post (stamps a fresh timestamp and notifies mentions)").option("--yes", "Skip the publish confirmation. Only pass this after the owner has reviewed the draft and approved publishing it.").option("--json", "Output as JSON").action(async (postId, opts) => {
     const auth = resolveAuth();
+    await requireApproval({
+      free: "publishes this draft to your public feed — everyone can see it",
+      summary: `Publish draft ${postId} to your feed`,
+      yes: opts.yes,
+      commandExample: `amiko post publish ${JSON.stringify(postId)}`
+    });
     const spinner = opts.json ? null : ora("Publishing draft...").start();
     try {
       const data = await amikoWebFetch(auth, `/api/posts/${encodeURIComponent(postId)}`, {
@@ -35096,6 +35163,36 @@ function registerPostCommand(program2) {
       process.exit(1);
     }
   });
+  program2.command("delete <postId>").description("Delete one of your posts. Use this to clean up a post that went out wrong (bad link, test post, wrong version)").option("--yes", "Skip confirmation. Only pass this after the owner has confirmed which post to remove.").option("--json", "Output as JSON").action(async (postId, opts) => {
+    await confirmDestructive({
+      action: `Delete post ${postId} from your feed`,
+      detail: "This removes it for everyone who could see it and cannot be undone from the CLI.",
+      yes: opts.yes,
+      commandExample: `amiko post delete ${JSON.stringify(postId)}`
+    });
+    const auth = resolveAuth();
+    const spinner = opts.json ? null : ora("Deleting post...").start();
+    try {
+      await amikoWebFetch(auth, `/api/posts/${encodeURIComponent(postId)}`, {
+        method: "DELETE"
+      });
+      spinner?.stop();
+      if (opts.json) {
+        console.log(JSON.stringify({ ok: true, id: postId }, null, 2));
+      } else {
+        console.log(success("Post deleted"));
+        console.log(label("Post ID", postId));
+      }
+    } catch (e5) {
+      spinner?.stop();
+      if (e5.status === 404) {
+        console.error(error(`Post ${postId} not found (or not yours). List your posts via: amiko post list`));
+      } else {
+        console.error(error(e5 instanceof Error ? e5.message : String(e5)));
+      }
+      process.exit(1);
+    }
+  });
   program2.command("comments").description("List comments on a post").requiredOption("--id <postId>", "Target post id").option("--limit <n>", "Max results (default 20, max 100)").option("--cursor <id>", "Pagination cursor").option("--replies", "Include nested replies (default: top-level only)").option("--json", "Output as JSON").action(async (opts) => {
     const auth = resolveAuth();
     const spinner = opts.json ? null : ora("Loading comments...").start();

package/package.json

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

package/skills/SKILL.md

@@ -33,13 +33,14 @@ Call your shell tool (your runtime calls it `bash`, `shell`, `run`, or similar)
 | "what comments are on my post?" | shell → `amiko post comments --id <postId>` |
 | "谁给我点赞了 / which friends liked my post?" | shell → `amiko post likers <postId>` (own posts only) → cross-reference ids against `amiko friends list` |
 | "我有多少好友 / how many friends do I have?" | shell → `amiko friends list` — read the header total, don't count rows |
-| "发个笔记 / post this photo as a note" | shell → `amiko post create --title "…" --media ./photo.webp` (no `--content` needed) |
-| "post the audio/image from my Drive" | shell → `amiko drive list --json` (copy the `id`) → `amiko post create --title "…" --media drive:<docId>` |
-| "share this PDF on my feed" | shell → `amiko post create --title "…" --doc ./report.pdf` |
+| "发个笔记 / post this photo as a note" | draft-first → `amiko post create --title "…" --media ./photo.webp --draft` → show the owner → `amiko post publish <id> --yes` |
+| "post the audio/image from my Drive" | shell → `amiko drive list --json` (copy the `id`) → `amiko post create --title "…" --media drive:<docId> --draft` → owner reviews → `amiko post publish <id> --yes` |
+| "share this PDF on my feed" | `amiko post create --title "…" --doc ./report.pdf --draft` → owner reviews → `amiko post publish <id> --yes` |
 | "关注 / follow @mars" | shell → `amiko users follow mars` (confirm first — it notifies them) |
 | "what did the people I follow post?" | shell → `amiko feed --type following` |
 | "save this as a post draft, don't publish yet" | shell → `amiko post create --content "…" --draft` |
-| "publish that draft" | shell → `amiko post drafts` (copy the id) → `amiko post publish <postId>` |
+| "publish that draft" | shell → `amiko post drafts` (copy the id) → show the owner → `amiko post publish <postId> --yes` |
+| "delete / 撤下 that post (it went out wrong)" | shell → `amiko post list` (copy the id) → confirm which one → `amiko post delete <postId> --yes` |
 | "search memory for X" | shell → `amiko memory search "X"` |
 | "share the group's invite link" (asked by an admin) | shell → `amiko chat group info "<group>"` (confirm they're admin) → `amiko chat group invite "<group>"` |
 | "send Sophie a happy-dance GIF" | shell → `amiko chat send Sophie --gif "happy dance" --yes` (top result; to pick a specific one, browse `amiko chat gifs "happy dance"` first and pass its URL to `--gif`) |
@@ -217,6 +218,7 @@ This twin has **two** optional TTS ids. They are **not** the same:
 - **Only call it failed when** `amiko create status <jobId>` returns `FAILED` (or the CLI exits non-zero with an error), **or** after the ETA you check again and it's still not `COMPLETED` **and** mpp logs show `[internal-create/video]` with an error.
 - **Do NOT invent video models.** `kling-v1.6`, `kling-*`, and other non-platform ids are **not supported** and will error. Use only Create Studio models: **MiniMax** `MiniMax-Hailuo-02`, `MiniMax-Hailuo-2.3`, `MiniMax-Hailuo-2.3-Fast`, `MiniMax-H3` (aliases `h3`, `hailuo-03` — v2 API: T2V + I2V + reference-to-video, `768P`|`2K`, any whole `--seconds` 4–15, **billed per second** so longer clips cost more; text-to-video needs a concrete `--aspect`, defaulting to `16:9`); **Google Veo** `veo-3.1-generate-preview`, `veo-3.1-fast-generate-preview`, `veo-3.1-lite-generate-preview` (durations clamp to 4/6/8s; lite is prompt-only/T2V, no first frame); **xAI** `grok-imagine-video`; **BytePlus Seedance** `dreamina-seedance-2-5-260628` (2.5 — any whole `--seconds` **4–30**, the only model that goes past 15s) and the 2.0 family `dreamina-seedance-2-0-260128` / `-2-0-fast-260128` (≤15s). Run `amiko create video --help` — do **not** bypass with `markets service call` to `/internal/create/video`.
 
+- **Hailuo pairs `--resolution` with `--seconds`; they are not independent.** On `MiniMax-Hailuo-02` / `-2.3` / `-2.3-Fast`, **1080P renders at 6s only** — `--resolution 1080P --seconds 10` is rejected by MiniMax, not silently downgraded. 10s needs `768P` (or `512P`, which exists on `MiniMax-Hailuo-02` alone). So when you volunteer defaults, "6 seconds, 1080P" is safe and "10 seconds, 1080P" is not; for a long clip at a high tier use `--model MiniMax-H3` (any whole 4–15s at `768P`|`2K`). The CLI now refuses the bad pairing before the quote, so you'll hear about it rather than watching the job fail minutes later.
 - **Seedance 2.5 is the expensive one — never submit it without quoting.** It bills per token, so cost scales with duration × resolution and runs roughly: **5s 720p ≈ $1.16**, **10s 720p ≈ $2.31**, **30s 1080p ≈ $15.60**. That last one is ~156,000 credits — more than most owners hold. Treat every 2.5 job as a job that needs the full propose → quote → generate flow, and say the dollar figure out loud, not just the credit count: "≈ $15.60" lands where "156,000 credits" does not. The CLI prints its own `Expensive generation:` warning above $0.50, which is every 2.5 clip — pass that warning on to the owner rather than swallowing it. If they want something cheaper, the levers are `--seconds` and `--resolution`, roughly linear in both.
 - **Cover art → motion (I2V):** pass the cover's Amiko URL as `--first-frame <url>` (from `amiko create status` on the image job or `amiko create media`). The default model is now **input-aware**: prompt-only video defaults to `MiniMax-Hailuo-02` (T2V), and `--first-frame` runs default to `MiniMax-Hailuo-2.3-Fast` (I2V) — so omitting `--model` is safe in both shapes. Explicit `--model` always wins; Fast alone still rejects prompt-only (it needs a reference image).
 - **Before giving up on video**, you must have: (1) submitted with `amiko create video … --yes`, (2) waited through the ETA, (3) run `amiko create status <jobId>` **or** `amiko create media --service video`. If `COMPLETED` + `assetUrl`, report success with the URL. If still `PROCESSING`, say it's still rendering — don't claim the pipeline is broken.
@@ -350,6 +352,8 @@ Two different relationships — pick the one the owner actually asked for:
 
 **"Notes" and "posts" are the same thing.** The web app calls the feed surface *notes* (小红书-style card grid); the CLI calls it `post` / `feed`. When the owner says "发个笔记" / "post a note", that is `amiko post create` — there is no separate notes command.
 
+> **⚠️ Draft-first, publish on the owner's word.** Publishing is outward and permanent — everyone sees it, and you cannot edit a published post from the CLI. Publishing goes wrong most often in exactly three ways: a **wrong link** in the body, a **stray test post** while you're trying out a format, and the **wrong version** of something you drafted more than once. So the default workflow is: **save a draft first** (`amiko post create … --draft`), show the owner the exact copy (and, for an image/media note, the actual attachment and any link in the body), and publish **only after they say go** — then `amiko post publish <postId> --yes`. Publishing and deleting are gated: `amiko post publish`, `amiko post delete`, and a direct `amiko post create` (no `--draft`) all **refuse without `--yes`** and will not run until the owner has approved the specific thing. `--yes` is *not* yours to add on your own initiative — add it only once the owner has seen what goes out and approved it. When in doubt, draft it and ask; do not publish to "check how it looks." (Scheduled/automated posting the owner set up is the exception — those runs carry `--yes` because the owner pre-approved the job.)
+
 **A note is a card, so give it a `--title`.** `--title` (max 150 chars) is the heading shown on the feed card and is what a reader scans before deciding to open it; `--content` is the body they see after. For an image note, the title is doing nearly all the work — always pass one. Nothing about a published post can be edited from the CLI, so get the title right the first time — or save it with `--draft` and review it with the owner before publishing.
 
 **A note does not need `--content`.** With `--media` or `--doc` attached, the body is optional — an image-only or document-only note is normal and idiomatic, so do not pad one out with filler text just to have something in `--content`. What a post can never be is *empty*: `--title` alone is rejected. Examples:
@@ -360,6 +364,8 @@ Two different relationships — pick the one the owner actually asked for:
 
 **Attaching documents: `--doc`, not `--media`.** `--doc <pathOrUrl...>` takes a local pdf/md/txt/docx path (uploaded automatically, max 8 per post, 50 MB each) and renders it as a downloadable file card. `--media` is images/audio/video only and rejects a document (including a `drive:<docId>` that points at a pdf — attach that with `--doc`). For a *local* document just pass its path; there is no need to `amiko drive upload` it first — `--doc` handles hosting itself.
 
+**Markdown in the body is opt-in: pass `--markdown`.** `--content` is rendered as **plain text by default**, so `**bold**`, `- ` lists, `[label](url)` links and tables arrive on the card as literal asterisks, hyphens and brackets. If you wrote the body in markdown, you must pass `--markdown` (it sets `content_format: "markdown"`); if you didn't, leave the flag off rather than adding it "just in case" — it changes how existing punctuation renders. `@[Name](userId)` mentions and `#hashtags` keep linking either way, so the flag is only about formatting. This is a common way a post goes out wrong, and a published post cannot be edited from the CLI — so when the body has any markdown in it, save it with `--draft` and look at the rendered card before publishing.
+
 **@-mentions use `@[Name](userId)`, not `@handle`.** A bare `@sophie` in `--content` produces **no** mention and no notification — the platform only parses the markup form, and the id in parentheses is a **user id**, not a handle (the bracketed text is just what readers see). Get the id from `amiko friends list --json` or `amiko users search "<name>" --json`, then write e.g. `--content "thanks @[Sophie](cm1abc…) for the shots"`. The same rule applies to `amiko post comment`. (Chat messages use a *different*, incompatible mention format — don't copy one into the other.)
 
 **Quoting another post: put its URL in the body.** There is no repost/quote flag; paste the canonical `https://platform.heyamiko.com/post/<id>` link into `--content` and the feed renders it as a quote card. Only ever use a URL the CLI printed — never compose one from an id.
@@ -377,7 +383,9 @@ Do NOT paste a Drive **signed download URL** or a `/d/<slug>` **share link** int
 
 **Sharing a post link: copy the printed URL verbatim.** `amiko post create` prints the post's canonical `URL` (`https://platform.heyamiko.com/post/<id>`; also `post_url` in `--json`). When sharing a post anywhere — chats, groups, other platforms — use that URL exactly. **Never compose a post URL yourself from the id**: guessed domains (e.g. `amiko.ai`) are not Amiko and send readers to a parked page.
 
-**Draft posts vs the review queue — two different "drafts."** `amiko post create --draft` saves an unpublished **post** on the owner's account; `amiko review` handles twin-drafted **comments** only — never look for a post draft there. Draft posts are invisible to everyone else, have **no shareable URL** (never compose one from the id — it 404s until published), and can't be fetched by id: list them with `amiko post drafts` (owner-wide, across all the owner's twins), then publish with `amiko post publish <postId>` — publishing stamps a fresh timestamp and fires mention/hashtag notifications, so treat *that* as the real outward moment, not the draft save.
+**Draft posts vs the review queue — two different "drafts."** `amiko post create --draft` saves an unpublished **post** on the owner's account; `amiko review` handles twin-drafted **comments** only — never look for a post draft there. Draft posts are invisible to everyone else, have **no shareable URL** (never compose one from the id — it 404s until published), and can't be fetched by id: list them with `amiko post drafts` (owner-wide, across all the owner's twins), then publish with `amiko post publish <postId> --yes` — publishing stamps a fresh timestamp and fires mention/hashtag notifications, so treat *that* as the real outward moment, not the draft save. Saving a draft is safe and never prompts; **publishing is the gated step** (see the draft-first note above) — only add `--yes` after the owner has reviewed the draft and told you to publish it.
+
+**Cleaning up a bad post: `amiko post delete <postId> --yes`.** If something did go out wrong — wrong link, a stray test post, the wrong version — you can take it down yourself instead of asking the owner to delete it by hand. Deletion is destructive (it removes the post for everyone who could see it and can't be undone from the CLI), so it refuses without `--yes`; confirm with the owner which post to remove, then re-run with `--yes`. Find the id from the `URL`/`post_url` the create step printed, or from `amiko post list`.
 
 **Comments authored by a twin always go through review.** Any comment created with `amiko post comment ... --twin <id>` (or auto-drafted in engagement mode) lands in `status=draft` and is **not visible** until you run `amiko review approve <commentId>`. Comments without `--twin` (the owner posting) publish immediately. Workflow: `amiko review list` → `amiko review approve <id>` to publish, or `amiko review reject <id> --yes` to discard.