makaron-cli 0.13.0 → 0.13.2

package/.claude-plugin/plugin.json

@@ -1,6 +1,6 @@
 {
   "name": "makaron-cli",
-  "version": "0.11.5",
+  "version": "0.13.2",
   "description": "AI image editing, video generation, music creation, and marketplace skill workflows via CLI. Agents can self-register, install skills, create projects, and produce creative media.",
   "author": {
     "name": "Makaron AI",

package/.codex-plugin/plugin.json

@@ -1,6 +1,6 @@
 {
   "name": "makaron-cli",
-  "version": "0.11.5",
+  "version": "0.13.2",
   "description": "AI image editing, video generation, music creation, and marketplace skill workflows via CLI. Agents can self-register, install skills, create projects, and produce creative media.",
   "displayName": "Makaron",
   "shortDescription": "AI image/video/music creation from the terminal",

package/README.md

@@ -48,6 +48,12 @@ export MAKARON_API_KEY=mk_live_xxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxx
 
 Verify: `npx makaron-cli list` should show projects.
 
+Check the current credit balance and subscription:
+```bash
+npx makaron-cli credits
+npx makaron-cli credits --json
+```
+
 ### Let a human claim your account
 
 After registering, generate a link for a human to link your API key to their account:
@@ -95,7 +101,7 @@ npx makaron-cli chat --project auto --image img1.jpg --image img2.jpg --json -b
 npx makaron-cli chat --project auto --agent-model deepseek-v4-pro --image-model qwen "design a product poster"
 ```
 
-Model flags are role-specific: `--agent-model` controls reasoning and tool use, `--image-model` controls image generation/editing, and `--video-model` controls video generation. `--agent-model` accepts `auto|sonnet-4.6|sonnet-5|opus-4.8|grok-4.5|deepseek-v4-pro`. `MAKARON_AGENT_MODEL` can set the default for automation; the command flag takes precedence. The legacy `--model` flag remains temporarily supported with a deprecation warning.
+Model flags are role-specific: `--agent-model` controls reasoning and tool use, `--image-model` controls image generation/editing, and `--video-model` controls video generation. `--agent-model` accepts `auto|gpt-5.6-terra|gpt-5.6-sol|gpt-5.6-luna|grok-4.5|deepseek-v4-pro`. `auto` currently uses GPT-5.6 Terra. `MAKARON_AGENT_MODEL` can set the default for automation; the command flag takes precedence. The legacy `--model` flag remains temporarily supported with a deprecation warning.
 
 Returns immediately:
 ```json
@@ -451,8 +457,23 @@ Admin commands require an API key with admin privileges. Ask your admin to run `
 
 ```bash
 npx makaron-cli admin skills
+npx makaron-cli admin skills --json
+```
+
+The human-readable list includes assigned categories plus title/prompt locale completeness.
+
+### Manage marketplace categories
+
+```bash
+npx makaron-cli admin skill-categories
+npx makaron-cli admin skill-categories --json
+npx makaron-cli admin skill-categories add '{"id":"portrait-effects","labels":{"en":"Portrait Effects","zh":"人像特效","zh-Hant":"人像特效","ja":"ポートレート効果"},"icon":"✨","sort_order":10}'
+npx makaron-cli admin skill-categories update portrait-effects '{"icon":"📸"}'
+npx makaron-cli admin skill-categories delete portrait-effects
 ```
 
+Deleting a category is blocked while any marketplace skill still uses it.
+
 ### Upload assets to Storage
 
 ```bash
@@ -475,9 +496,10 @@ Storage paths follow this convention:
 
 ```bash
 npx makaron-cli admin skills add '{
-  "labels": {"zh": "中文名", "en": "English Name"},
+  "labels": {"en": "English Name", "zh": "中文名", "zh-Hant": "繁體名稱", "ja": "日本語名"},
   "image": "https://sdyrtztrjgmmpnirswxt.supabase.co/storage/v1/object/public/images/marketplace/covers/skill-name.jpg",
-  "prompt": "Default prompt shown to users",
+  "prompts": {"en": "Default prompt", "zh": "默认提示词", "zh-Hant": "預設提示詞", "ja": "デフォルトプロンプト"},
+  "categories": ["portrait-effects"],
   "skill_path": "https://sdyrtztrjgmmpnirswxt.supabase.co/storage/v1/object/public/images/marketplace/skills/skill-name.zip",
   "image_count": 2,
   "sort_order": 10,
@@ -486,6 +508,8 @@ npx makaron-cli admin skills add '{
 }'
 ```
 
+New skills require all four localized titles, all four localized default prompts, and at least one existing category. Partial `labels` or `prompts` updates are merged with existing locales, so updating one language does not erase the others.
+
 ### Update / delete a skill
 
 ```bash
@@ -520,7 +544,7 @@ npx makaron-cli admin fetch-skill https://www.makaron.app/s/4c4cbd57
    ```
 6. **Add to marketplace**:
    ```bash
-   npx makaron-cli admin skills add '{"labels":{"zh":"...","en":"..."},"image":"<cover_url>","skill_path":"<zip_url>","before_images":["<before_url>"],"image_count":2,"sort_order":10,"is_active":true}'
+   npx makaron-cli admin skills add '{"labels":{"en":"...","zh":"...","zh-Hant":"...","ja":"..."},"prompts":{"en":"...","zh":"...","zh-Hant":"...","ja":"..."},"categories":["portrait-effects"],"image":"<cover_url>","skill_path":"<zip_url>","before_images":["<before_url>"],"image_count":2,"sort_order":10,"is_active":true}'
    ```
 7. **Verify** — visit https://www.makaron.app/home and confirm the skill appears, can be clicked, and works
 

package/bin/makaron.mjs

@@ -27,7 +27,8 @@ const APP_URL = process.env.MAKARON_APP_URL || DEFAULT_URL;
 const NPM_PACKAGE_NAME = 'makaron-cli';
 const UPDATE_CHECK_INTERVAL_MS = 24 * 60 * 60 * 1000;
 const UPDATE_CHECK_TIMEOUT_MS = 400;
-const AGENT_MODELS = ['auto', 'sonnet-4.6', 'sonnet-5', 'opus-4.8', 'grok-4.5', 'deepseek-v4-pro'];
+const AGENT_MODELS = ['auto', 'gpt-5.6-terra', 'gpt-5.6-sol', 'gpt-5.6-luna', 'grok-4.5', 'deepseek-v4-pro'];
+const AGENT_WAIT_TIMEOUT_SECONDS = Math.max(900, Number(process.env.MAKARON_AGENT_WAIT_TIMEOUT_SECONDS || 10_800));
 
 // Public anon key (safe to embed — only enables auth, not data access)
 const SUPABASE_URL = 'https://sdyrtztrjgmmpnirswxt.supabase.co';
@@ -292,7 +293,7 @@ Options:
   --skill <id|label|name>   Use an installed skill or auto-install a matched marketplace skill.
   --image-model <name>      Image model: gemini, gemini-lite, qwen, openai, pony, or wai.
   --video-model <name>      Preferred video model: seedance-fast, seedance-mini, seedance, kling, grok, or google-omni.
-  --agent-model <name>      Agent model: auto, sonnet-4.6, sonnet-5, opus-4.8, grok-4.5, or deepseek-v4-pro.
+  --agent-model <name>      Agent model: auto, gpt-5.6-terra, gpt-5.6-sol, gpt-5.6-luna, grok-4.5, or deepseek-v4-pro.
   --video-resolution <res>  Video resolution: auto, 480p, 720p, 1080p, or 4k.
   --background, -b          Submit and print a runId.
   --json                    Output structured JSON.
@@ -363,6 +364,8 @@ async function streamAgent(baseUrl, headers, projectId, prompt, opts = {}) {
       ...(opts.videoModel ? { videoModel: opts.videoModel } : {}),
       ...(opts.videoResolution ? { videoResolution: opts.videoResolution } : {}),
       ...(opts.agentModel && opts.agentModel !== 'auto' ? { agentModel: opts.agentModel } : {}),
+      ...(opts.uploadedVideoCount ? { uploadedVideoCount: opts.uploadedVideoCount } : {}),
+      ...(opts.turnMediaCount ? { turnMediaCount: opts.turnMediaCount } : {}),
     }),
     signal: controller.signal,
   });
@@ -476,6 +479,8 @@ async function submitRun(baseUrl, headers, projectId, prompt, opts = {}) {
   if (opts.currentSnapshotIndex != null) body.currentSnapshotIndex = opts.currentSnapshotIndex;
   if (opts.isNsfw) body.isNsfw = opts.isNsfw;
   if (opts.audioAttachments?.length) body.audioAttachments = opts.audioAttachments;
+  if (opts.uploadedVideoCount) body.uploadedVideoCount = opts.uploadedVideoCount;
+  if (opts.turnMediaCount) body.turnMediaCount = opts.turnMediaCount;
 
   const res = await fetch(`${baseUrl}/api/agent/run`, {
     method: 'POST',
@@ -519,7 +524,7 @@ async function pollRun(baseUrl, headers, runId, opts = {}) {
     try {
       const res = await fetch(`${baseUrl}/api/agent/run/${runId}?${params}`, { headers });
       if (!res.ok) {
-        if (elapsed > 800) { process.stderr.write(`\n❌ Timeout after ${elapsed}s\n`); process.exit(1); }
+        if (elapsed > AGENT_WAIT_TIMEOUT_SECONDS) { process.stderr.write(`\n❌ Timeout after ${elapsed}s\n`); process.exit(1); }
         continue;
       }
       data = await res.json();
@@ -569,6 +574,13 @@ async function pollRun(baseUrl, headers, runId, opts = {}) {
           case 'music_task':
             process.stderr.write(`\n🎵 Music submitted: ${ev.data?.taskId}\n`);
             break;
+          case 'studio_run': {
+            const stage = ev.data?.currentStage || ev.data?.current_stage || 'complete';
+            const recipe = ev.data?.recipe || 'studio';
+            const status = ev.data?.status || 'running';
+            process.stderr.write(`\nStudio Run: ${recipe} / ${stage} / ${status}\n`);
+            break;
+          }
           case 'error':
             process.stderr.write(`\n❌ Error: ${ev.data?.message}\n`);
             break;
@@ -580,6 +592,7 @@ async function pollRun(baseUrl, headers, runId, opts = {}) {
 
     // Check terminal status
     if (data.status === 'completed' || data.status === 'failed' || data.status === 'aborted') {
+      normalizeRunResponse(data);
       if (printedText && !json) process.stdout.write('\n');
       if (data.status === 'completed' && exportCompositions) {
         data = await exportAnimatedCompositionsFromRun(baseUrl, headers, data, {
@@ -611,7 +624,7 @@ async function pollRun(baseUrl, headers, runId, opts = {}) {
         process.stderr.write(`🔗  ${APP_URL}/projects/${data.projectId}\n`);
       }
 
-      if (data.status === 'failed') process.exit(1);
+      if (data.status === 'failed' || data.status === 'aborted') process.exit(1);
       return data;
     }
   }
@@ -620,11 +633,15 @@ async function pollRun(baseUrl, headers, runId, opts = {}) {
 // ─── Pick Helper ────────────────────────────────────────────────────────────
 
 function applyPick(data, field) {
+  const videoUrls = [...new Set([
+    ...(data.output || []).filter(o => o.type === 'video' && o.url).map(o => o.url),
+    ...(data.result?.videos || []).filter(v => v.videoUrl).map(v => v.videoUrl),
+  ])];
   switch (field) {
     case 'first_image_url': return data.output?.find(o => o.type === 'image')?.url || null;
     case 'image_urls': return (data.output || []).filter(o => o.type === 'image' && o.url).map(o => o.url);
-    case 'first_video_url': return data.output?.find(o => o.type === 'video' && o.url)?.url || null;
-    case 'video_urls': return (data.output || []).filter(o => o.type === 'video' && o.url).map(o => o.url);
+    case 'first_video_url': return videoUrls[0] || null;
+    case 'video_urls': return videoUrls;
     case 'first_design_url': return data.output?.find(o => o.type === 'design')?.url || null;
     case 'design_urls': return (data.output || []).filter(o => o.type === 'design' && o.url).map(o => o.url);
     case 'first_music_url': return data.output?.find(o => o.type === 'music' && o.url)?.url || null;
@@ -635,6 +652,8 @@ function applyPick(data, field) {
       description: action.description,
       source: action.source,
     }));
+    case 'studio_run': return [...(data.output || [])].reverse().find(o => o.type === 'studio_run') || null;
+    case 'studio_recipe': return [...(data.output || [])].reverse().find(o => o.type === 'studio_run')?.recipe || null;
     case 'project_url': return data.project_url || data.projectUrl || null;
     case 'output': return data.output || [];
     case 'text': return data.output?.find(o => o.type === 'text')?.content || null;
@@ -656,7 +675,7 @@ async function watchRun(baseUrl, headers, runId, opts = {}) {
     try {
       const res = await fetch(`${baseUrl}/api/agent/run/${runId}`, { headers });
       if (!res.ok) {
-        if (elapsed > 800) { process.stderr.write(`Timeout after ${elapsed}s\n`); process.exit(2); }
+        if (elapsed > AGENT_WAIT_TIMEOUT_SECONDS) { process.stderr.write(`Timeout after ${elapsed}s\n`); process.exit(2); }
         await new Promise(r => setTimeout(r, interval));
         continue;
       }
@@ -990,6 +1009,17 @@ function timeSince(date) {
 
 // ─── Skill Marketplace ──────────────────────────────────────────────────────
 
+const MARKETPLACE_LOCALES = ['en', 'zh', 'zh-Hant', 'ja'];
+
+function localizedValues(value) {
+  if (!value || typeof value !== 'object' || Array.isArray(value)) return [];
+  return Object.values(value).filter(item => typeof item === 'string' && item.trim());
+}
+
+function localizedCoverage(value) {
+  return MARKETPLACE_LOCALES.filter(locale => typeof value?.[locale] === 'string' && value[locale].trim()).length;
+}
+
 function getSkillLabel(skill) {
   return skill.labels?.en || skill.labels?.zh || skill.label || skill.name || skill.id;
 }
@@ -1031,16 +1061,43 @@ async function fetchMarketplaceSkills(baseUrl, opts = {}) {
   return skills.map(normalizeMarketplaceSkill);
 }
 
+async function fetchBuiltInSkills(baseUrl) {
+  const res = await fetch(`${baseUrl}/api/skills?include=internal`);
+  if (!res.ok) {
+    process.stderr.write(`Error ${res.status}: ${await res.text()}\n`);
+    process.exit(1);
+  }
+  const data = await res.json();
+  return (data.skills || []).filter(skill => skill.builtIn);
+}
+
+function printBuiltInSkills(skills) {
+  if (!skills.length) {
+    console.log('No built-in skills found.');
+    return;
+  }
+  console.log(`Built-in skills: ${skills.length}\n`);
+  for (const skill of skills) {
+    const recipe = skill.studioRunRecipe ? `  [Studio Run: ${skill.studioRunRecipe}]` : '';
+    const source = skill.sourceMediaRequired ? '  [source media required]' : '';
+    const adapter = skill.sourceProject === 'openmontage'
+      ? `  [OpenMontage: ${skill.supportLevel || 'adapted'}${skill.canonicalSkill && skill.canonicalSkill !== skill.name ? ` -> ${skill.canonicalSkill}` : ''}]`
+      : '';
+    console.log(`  ${skill.name}${recipe}${source}${adapter}`);
+    if (skill.description) console.log(`    ${String(skill.description).replace(/\s+/g, ' ').trim()}`);
+  }
+}
+
 function marketplaceSearchText(skill) {
+  const localized = [...localizedValues(skill.labels), ...localizedValues(skill.prompts)];
   return [
     skill.id,
     skill.label,
-    skill.labels?.en,
-    skill.labels?.zh,
+    ...localized,
     skill.prompt,
+    ...(Array.isArray(skill.categories) ? skill.categories : []),
     slugifySkill(skill.label),
-    slugifySkill(skill.labels?.en),
-    slugifySkill(skill.labels?.zh),
+    ...localized.map(slugifySkill),
   ].filter(Boolean).join(' ').toLowerCase();
 }
 
@@ -1048,9 +1105,10 @@ function marketplaceSkillTokens(skill) {
   return [
     skill.id,
     skill.label,
-    skill.labels?.en,
-    skill.labels?.zh,
+    ...localizedValues(skill.labels),
+    ...localizedValues(skill.prompts),
     skill.prompt,
+    ...(Array.isArray(skill.categories) ? skill.categories : []),
   ].filter(Boolean).map(value => String(value).toLowerCase());
 }
 
@@ -1098,8 +1156,13 @@ function printMarketplaceSkill(skill) {
   console.log(`${skill.label}`);
   console.log(`ID: ${skill.id}`);
   console.log(`Type: ${skill.hasSkill ? 'installable skill' : 'prompt template'}`);
-  if (skill.labels?.zh && skill.labels.zh !== skill.label) console.log(`ZH: ${skill.labels.zh}`);
-  if (skill.prompt) console.log(`Prompt: ${skill.prompt}`);
+  for (const locale of MARKETPLACE_LOCALES) {
+    const label = skill.labels?.[locale];
+    if (label && label !== skill.label) console.log(`${locale}: ${label}`);
+  }
+  if (Array.isArray(skill.categories) && skill.categories.length) console.log(`Categories: ${skill.categories.join(', ')}`);
+  console.log(`i18n: titles ${localizedCoverage(skill.labels)}/4 · prompts ${localizedCoverage(skill.prompts)}/4`);
+  if (skill.prompts?.en || skill.prompt) console.log(`Prompt (en): ${skill.prompts?.en || skill.prompt}`);
   if (skill.image) console.log(`Cover: ${skill.image}`);
   if (skill.hasSkill) console.log(`Install: makaron skills install ${skill.id}`);
 }
@@ -1537,6 +1600,7 @@ Commands:
   register --verify --challenge-id <id> --answer <n>  Verify and save API key
   claim                              Get claim URL for human to link account
   login                              Log in to Makaron (human interactive)
+  credits                            Show current credit balance
   list (ls)                          List all projects
   project media <projectId> --json    List timeline media for a project
   create --image <file>              Create project from local image
@@ -1544,7 +1608,7 @@ Commands:
   create --title "name"              Create empty project (text-to-image)
 
   chat --project <id> "message"      Chat (non-blocking, polls for result)
-  chat --project <id> --skill <id>   Use or auto-install a marketplace skill
+  chat --project <id> --skill <id>   Use a built-in or marketplace skill
   chat --project <id> --video <file> Attach video to conversation
   chat --project <id> --audio <file> Attach song/beat/voice reference
   chat --project <id> -b "message"   Background: submit and print runId
@@ -1561,7 +1625,7 @@ Commands:
                                      Export editable Remotion composition to MP4
   responses list --project <id>      List runs for a project
   abort <runId>                      Abort a running Agent
-  skills list|search|show|install    Browse and install marketplace skills
+  skills list|search|show|install    Browse built-in and marketplace skills
 
   edit [--image <file>] "prompt"     AI image edit / text-to-image
   analyze --video <file|url>         Analyze video content
@@ -1571,8 +1635,8 @@ Commands:
   admin                              Admin commands (skills, upload, set-admin)
 
 Model selection:
-  --agent-model <name>               Reasoning/tool model: auto, sonnet-4.6, sonnet-5,
-                                     opus-4.8, grok-4.5, or deepseek-v4-pro
+  --agent-model <name>               Reasoning/tool model: auto, gpt-5.6-terra, gpt-5.6-sol,
+                                     gpt-5.6-luna, grok-4.5, or deepseek-v4-pro
   --image-model <name>               Image model: gemini, gemini-lite, qwen, openai,
                                      pony, or wai
   --video-model <name>               Video model: seedance-fast, seedance-mini, seedance,
@@ -1580,7 +1644,7 @@ Model selection:
 
 Examples:
   makaron chat --project auto --agent-model deepseek-v4-pro "plan a launch poster"
-  makaron chat --project <id> --agent-model sonnet-5 --image-model qwen "make it cinematic"
+  makaron chat --project <id> --agent-model gpt-5.6-terra --image-model qwen "make it cinematic"
   makaron chat --project <id> --video-model seedance-fast "turn this into a short video"
 
 Run makaron <command> --help for command-specific options.
@@ -1660,6 +1724,8 @@ function printHelp(topic, subtopic) {
 `);
   } else if (topic === 'list' || topic === 'ls') {
     console.log('Usage: makaron list');
+  } else if (topic === 'credits' || topic === 'credit' || topic === 'balance') {
+    console.log('Usage: makaron credits [--json]');
   } else if (topic === 'project' || topic === 'projects') {
     if (subtopic === 'media') console.log('Usage: makaron project media <projectId> [--json]');
     else console.log(`Project commands:
@@ -1672,13 +1738,17 @@ function printHelp(topic, subtopic) {
   } else if (topic === 'install-skill') {
     console.log('Usage: makaron install-skill [--global] [--agent <agent>] [--yes]');
   } else if (topic === 'skills') {
-    if (subtopic === 'list') console.log('Usage: makaron skills list [--json]');
+    if (subtopic === 'list') console.log('Usage: makaron skills list [--built-in] [--json]');
     else if (subtopic === 'search') console.log('Usage: makaron skills search <query> [--json]');
     else if (subtopic === 'show') console.log('Usage: makaron skills show <marketplace-id|label> [--json]');
     else if (subtopic === 'install') console.log('Usage: makaron skills install <marketplace-id|label> [--json]');
-    else console.log(`Skill marketplace commands:
+    else console.log(`Skill commands:
+  skills list --built-in              List all built-in Makaron skills and Studio Run recipes
+  skills list --built-in --openmontage
+                                      List OpenMontage-native adapters only
   skills list                         List marketplace skills
   skills search <query>               Search marketplace skills
+  skills show <id|label> --built-in   Show a built-in skill
   skills show <id|label>              Show a marketplace skill
   skills install <id|label>           Install a marketplace skill to your workspace
 
@@ -1719,7 +1789,8 @@ Use with chat:
   music status <taskId>                                      Check music status
 `);
   } else if (topic === 'admin') {
-    if (subtopic === 'skills') console.log('Usage: makaron admin skills [add|update|delete] ...');
+    if (subtopic === 'skills') console.log('Usage: makaron admin skills [--json|add|update|delete] ...');
+    else if (subtopic === 'skill-categories') console.log('Usage: makaron admin skill-categories [--json|add|update|delete] ...');
     else if (subtopic === 'upload') console.log('Usage: makaron admin upload <local-file> <storage-path>');
     else if (subtopic === 'fetch-skill') console.log('Usage: makaron admin fetch-skill <share-code|url>');
     else if (subtopic === 'set-admin') console.log('Usage: makaron admin set-admin <email>');
@@ -1728,6 +1799,10 @@ Use with chat:
   admin skills add '<json>'            Add a new skill
   admin skills update <id> '<json>'    Update a skill
   admin skills delete <id>             Delete a skill
+  admin skill-categories               List marketplace categories
+  admin skill-categories add '<json>'  Add a category
+  admin skill-categories update <id> '<json>'
+  admin skill-categories delete <id>   Delete a category
   admin upload <file> <storage-path>   Upload file to Storage
   admin fetch-skill <code|url>         Download skill from share link
   admin set-admin <email>              Grant admin access to a user
@@ -1761,6 +1836,29 @@ if (!command || command === '--help' || command === '-h' || command === 'help')
   installAgentSkill(args.slice(1));
 } else if (command === 'login') {
   await login();
+} else if (command === 'credits' || command === 'credit' || command === 'balance') {
+  const { headers, baseUrl } = getAuth();
+  const res = await fetch(`${baseUrl}/api/billing/credits`, { headers });
+  const data = await res.json().catch(() => null);
+  if (!res.ok || !data) {
+    const message = data?.error || data?.message || (res.ok ? 'Invalid response' : `HTTP ${res.status}`);
+    process.stderr.write(`Failed to get credits: ${message}\n`);
+    process.exit(1);
+  }
+  if (args.includes('--json')) {
+    console.log(JSON.stringify(data));
+  } else {
+    console.log(`Credits: ${data.balance ?? 0}`);
+    console.log(`Lifetime purchased: ${data.lifetimePurchased ?? 0}`);
+    console.log(`Lifetime used: ${data.lifetimeUsed ?? 0}`);
+    if (data.subscription) {
+      const plan = data.subscription.planId || 'unknown';
+      const status = data.subscription.status ? ` (${data.subscription.status})` : '';
+      console.log(`Subscription: ${plan}${status}`);
+    } else {
+      console.log('Subscription: none');
+    }
+  }
 } else if (command === 'create') {
   const { headers, baseUrl } = getAuth();
   const opts = { images: [], imageUrls: [] };
@@ -1866,6 +1964,9 @@ if (!command || command === '--help' || command === '-h' || command === 'help')
     process.exit(1);
   }
 
+  let uploadedTurnMediaCount = 0;
+  let uploadedTurnVideoCount = 0;
+
   // --project auto: create a new project (with images/videos if provided)
   if (!projectId || projectId === 'auto') {
     // Create an empty project first, then attach media by URL. Local images use
@@ -1903,6 +2004,7 @@ if (!command || command === '--help' || command === '-h' || command === 'help')
         process.exit(1);
       }
       process.stderr.write(`📤 Added ${addedCount} image(s) to project\n`);
+      uploadedTurnMediaCount += addedCount;
     } else {
       process.stderr.write(`❌ Failed to add images: ${await res.text()}\n`);
       process.exit(1);
@@ -1994,19 +2096,25 @@ if (!command || command === '--help' || command === '-h' || command === 'help')
         const data = await res.json();
         const videoSnaps = (data.snapshots || []).filter(s => s.type === 'video');
         process.stderr.write(`📹 Added ${videoSnaps.length} video(s) to timeline\n`);
+        uploadedTurnVideoCount += videoSnaps.length;
+        uploadedTurnMediaCount += videoSnaps.length;
       } else {
         process.stderr.write(`⚠️ Failed to add videos: ${await res.text()}\n`);
       }
     }
 
-    // Inject hint so Agent knows videos are available
-    const hint = `[User uploaded ${chatVideos.length === 1 ? 'a video' : `${chatVideos.length} videos`}. Use analyze_video to understand the content.]`;
-    finalPrompt = `${finalPrompt}\n\n${hint}`;
   }
 
   if (useStream) {
     // Legacy SSE mode
-    const { results } = await streamAgent(baseUrl, headers, projectId, finalPrompt, { videoModel, videoResolution, preferredModel, agentModel });
+    const { results } = await streamAgent(baseUrl, headers, projectId, finalPrompt, {
+      videoModel,
+      videoResolution,
+      preferredModel,
+      agentModel,
+      uploadedVideoCount: uploadedTurnVideoCount,
+      turnMediaCount: uploadedTurnMediaCount,
+    });
     process.stderr.write('\n━━━ Results ━━━\n');
     for (const img of results.images) process.stderr.write(`🖼️  Image: ${img.imageUrl}\n`);
     for (const d of results.designs) process.stderr.write(`🎨  ${d.desc}\n`);
@@ -2015,7 +2123,15 @@ if (!command || command === '--help' || command === '-h' || command === 'help')
     for (const task of results.musicTasks) await pollMusic(baseUrl, headers, task.taskId);
   } else {
     // Default: fire-and-forget + poll
-    const { runId } = await submitRun(baseUrl, headers, projectId, finalPrompt, { videoModel, videoResolution, preferredModel, agentModel, audioAttachments });
+    const { runId } = await submitRun(baseUrl, headers, projectId, finalPrompt, {
+      videoModel,
+      videoResolution,
+      preferredModel,
+      agentModel,
+      audioAttachments,
+      uploadedVideoCount: uploadedTurnVideoCount,
+      turnMediaCount: uploadedTurnMediaCount,
+    });
     if (background) {
       // Just print runId and exit
       if (jsonOutput) {
@@ -2203,8 +2319,13 @@ if (!command || command === '--help' || command === '-h' || command === 'help')
   const jsonOutput = args.includes('--json');
 
   if (sub === 'list') {
-    const skills = await fetchMarketplaceSkills(baseUrl);
+    const builtIn = args.includes('--built-in');
+    let skills = builtIn ? await fetchBuiltInSkills(baseUrl) : await fetchMarketplaceSkills(baseUrl);
+    if (builtIn && args.includes('--openmontage')) {
+      skills = skills.filter(skill => skill.sourceProject === 'openmontage');
+    }
     if (jsonOutput) console.log(JSON.stringify({ skills }, null, 2));
+    else if (builtIn) printBuiltInSkills(skills);
     else printMarketplaceSkills(skills);
   } else if (sub === 'search') {
     const query = args.filter((arg, index) => index > 1 && arg !== '--json').join(' ').trim();
@@ -2221,11 +2342,15 @@ if (!command || command === '--help' || command === '-h' || command === 'help')
     else printMarketplaceSkills(skills);
   } else if (sub === 'show') {
     const identifier = args[2];
-    if (!identifier) { console.error('Usage: makaron skills show <marketplace-id|label> [--json]'); process.exit(1); }
-    const skills = await fetchMarketplaceSkills(baseUrl);
-    const skill = findMarketplaceSkill(skills, identifier);
+    if (!identifier) { console.error('Usage: makaron skills show <id|label> [--built-in] [--json]'); process.exit(1); }
+    const builtIn = args.includes('--built-in');
+    const skills = builtIn ? await fetchBuiltInSkills(baseUrl) : await fetchMarketplaceSkills(baseUrl);
+    const skill = builtIn
+      ? skills.find(candidate => candidate.name === identifier || candidate.label?.toLowerCase() === identifier.toLowerCase())
+      : findMarketplaceSkill(skills, identifier);
     if (!skill) { console.error(`Skill not found: ${identifier}`); process.exit(1); }
     if (jsonOutput) console.log(JSON.stringify(skill, null, 2));
+    else if (builtIn) printBuiltInSkills([skill]);
     else printMarketplaceSkill(skill);
   } else if (sub === 'install') {
     const identifier = args[2];
@@ -2238,9 +2363,13 @@ if (!command || command === '--help' || command === '-h' || command === 'help')
     if (jsonOutput) console.log(JSON.stringify({ ...data, marketplaceId: skill.id, label: skill.label }, null, 2));
     else console.log(data.skillName);
   } else {
-    console.log(`Skill marketplace commands:
+    console.log(`Skill commands:
+  skills list --built-in              List all built-in Makaron skills and Studio Run recipes
+  skills list --built-in --openmontage
+                                      List OpenMontage-native adapters only
   skills list                         List marketplace skills
   skills search <query>               Search marketplace skills
+  skills show <id|label> --built-in   Show a built-in skill
   skills show <id|label>              Show a marketplace skill
   skills install <id|label>           Install a marketplace skill to your workspace
 `);
@@ -2492,18 +2621,23 @@ if (!command || command === '--help' || command === '-h' || command === 'help')
   const sub = args[1];
 
   if (sub === 'skills') {
-    const action = args[2]; // add, update, delete, or none (list)
+    const action = args[2] === '--json' ? null : args[2]; // add, update, delete, or none (list)
     if (!action) {
       // List all skills
       const res = await fetch(`${baseUrl}/api/admin/home-skills`, { headers });
       if (!res.ok) { console.error(`Error ${res.status}:`, await res.text()); process.exit(1); }
       const skills = await res.json();
+      if (args.includes('--json')) {
+        console.log(JSON.stringify(skills, null, 2));
+        process.exit(0);
+      }
       console.log(`📋 ${skills.length} skills\n`);
       for (const s of skills) {
         const label = s.labels?.en || s.labels?.zh || '(no label)';
         const active = s.is_active ? '✅' : '❌';
         const hasZip = s.skill_path ? '📦' : '  ';
-        console.log(`  ${active} ${hasZip} ${String(s.sort_order).padStart(3)}  ${s.id}  ${label}`);
+        const categories = Array.isArray(s.categories) && s.categories.length ? s.categories.join(',') : 'uncategorized';
+        console.log(`  ${active} ${hasZip} ${String(s.sort_order).padStart(3)}  ${s.id}  ${label}  [${categories}]  title ${localizedCoverage(s.labels)}/4 · prompt ${localizedCoverage(s.prompts)}/4`);
       }
     } else if (action === 'add') {
       const json = args.slice(3).join(' ');
@@ -2541,6 +2675,59 @@ if (!command || command === '--help' || command === '-h' || command === 'help')
       process.exit(1);
     }
 
+  } else if (sub === 'skill-categories') {
+    const action = args[2] === '--json' ? null : args[2];
+    if (!action) {
+      const res = await fetch(`${baseUrl}/api/admin/skill-categories`, { headers });
+      if (!res.ok) { console.error(`Error ${res.status}:`, await res.text()); process.exit(1); }
+      const categories = await res.json();
+      if (args.includes('--json')) {
+        console.log(JSON.stringify(categories, null, 2));
+        process.exit(0);
+      }
+      console.log(`📂 ${categories.length} skill categories\n`);
+      for (const category of categories) {
+        const label = category.labels?.en || category.labels?.zh || category.id;
+        const active = category.is_active ? '✅' : '❌';
+        const icon = category.icon || ' ';
+        console.log(`  ${active} ${icon} ${String(category.sort_order).padStart(3)}  ${category.id}  ${label}  title ${localizedCoverage(category.labels)}/4`);
+      }
+    } else if (action === 'add') {
+      const json = args.slice(3).join(' ');
+      if (!json) { console.error('Usage: makaron admin skill-categories add \'{"id":"...","labels":{...}}\''); process.exit(1); }
+      let body;
+      try { body = JSON.parse(json); } catch { console.error('Invalid JSON'); process.exit(1); }
+      const res = await fetch(`${baseUrl}/api/admin/skill-categories`, {
+        method: 'POST', headers: { 'Content-Type': 'application/json', ...headers }, body: JSON.stringify(body),
+      });
+      if (!res.ok) { console.error(`Error ${res.status}:`, await res.text()); process.exit(1); }
+      const data = await res.json();
+      console.log(`✅ Skill category created: ${data.id}`);
+    } else if (action === 'update') {
+      const id = args[3];
+      const json = args.slice(4).join(' ');
+      if (!id || !json) { console.error('Usage: makaron admin skill-categories update <id> \'{"field":"value"}\''); process.exit(1); }
+      let body;
+      try { body = JSON.parse(json); } catch { console.error('Invalid JSON'); process.exit(1); }
+      body.id = id;
+      const res = await fetch(`${baseUrl}/api/admin/skill-categories`, {
+        method: 'PUT', headers: { 'Content-Type': 'application/json', ...headers }, body: JSON.stringify(body),
+      });
+      if (!res.ok) { console.error(`Error ${res.status}:`, await res.text()); process.exit(1); }
+      console.log(`✅ Skill category ${id} updated`);
+    } else if (action === 'delete') {
+      const id = args[3];
+      if (!id) { console.error('Usage: makaron admin skill-categories delete <id>'); process.exit(1); }
+      const res = await fetch(`${baseUrl}/api/admin/skill-categories`, {
+        method: 'DELETE', headers: { 'Content-Type': 'application/json', ...headers }, body: JSON.stringify({ id }),
+      });
+      if (!res.ok) { console.error(`Error ${res.status}:`, await res.text()); process.exit(1); }
+      console.log(`✅ Skill category ${id} deleted`);
+    } else {
+      console.error(`Unknown action: ${action}. Use: add, update, delete, or omit to list.`);
+      process.exit(1);
+    }
+
   } else if (sub === 'upload') {
     const filePath = args[2];
     const storagePath = args[3];
@@ -2600,6 +2787,10 @@ if (!command || command === '--help' || command === '-h' || command === 'help')
   admin skills add '<json>'            Add a new skill
   admin skills update <id> '<json>'    Update a skill
   admin skills delete <id>             Delete a skill
+  admin skill-categories               List marketplace categories
+  admin skill-categories add '<json>'  Add a category
+  admin skill-categories update <id> '<json>'
+  admin skill-categories delete <id>   Delete a category
   admin upload <file> <storage-path>   Upload file to Storage
   admin fetch-skill <code|url>         Download skill from share link
   admin set-admin <email>              Grant admin access to a user

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "makaron-cli",
-  "version": "0.13.0",
+  "version": "0.13.2",
   "description": "Talk to Makaron Agent from the terminal — create projects, edit images, generate videos",
   "type": "module",
   "scripts": {

package/skills/makaron/SKILL.md

@@ -44,6 +44,12 @@ export MAKARON_API_KEY=mk_live_xxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxx
 
 Verify: `npx makaron-cli list` should show projects.
 
+Check the current credit balance and subscription:
+```bash
+npx makaron-cli credits
+npx makaron-cli credits --json
+```
+
 ## Core Workflow
 
 ```bash
@@ -82,7 +88,7 @@ npx makaron-cli chat --project auto --image img1.jpg --image img2.jpg --json -b
 npx makaron-cli chat --project auto --agent-model deepseek-v4-pro --image-model qwen "design a product poster"
 ```
 
-Model flags are role-specific: `--agent-model` controls reasoning and tool use, `--image-model` controls image generation/editing, and `--video-model` controls video generation. `--agent-model` accepts `auto|sonnet-4.6|sonnet-5|opus-4.8|grok-4.5|deepseek-v4-pro`. `MAKARON_AGENT_MODEL` can set the default for automation; the command flag takes precedence. The legacy `--model` flag remains temporarily supported with a deprecation warning.
+Model flags are role-specific: `--agent-model` controls reasoning and tool use, `--image-model` controls image generation/editing, and `--video-model` controls video generation. `--agent-model` accepts `auto|gpt-5.6-terra|gpt-5.6-sol|gpt-5.6-luna|grok-4.5|deepseek-v4-pro`. `auto` currently uses GPT-5.6 Terra. `MAKARON_AGENT_MODEL` can set the default for automation; the command flag takes precedence. The legacy `--model` flag remains temporarily supported with a deprecation warning.
 
 Returns immediately:
 ```json
@@ -126,7 +132,9 @@ npx makaron-cli chat --project auto \
   -b "make this with the selected skill"
 ```
 
-`--skill` accepts an installed skill name, a marketplace UUID, or a unique marketplace label. If a marketplace skill is matched, the CLI installs or reuses it and sends `[Active skill: <installed-skill-name>]` to Makaron Agent. Do not call admin skill commands for ordinary users. There is intentionally no user-facing CLI delete command for marketplace skills.
+`--skill` accepts an installed skill name, a marketplace UUID, or a unique marketplace label. Marketplace search matches every localized title, every localized default prompt, and category ids. If a marketplace skill is matched, the CLI installs or reuses it and sends `[Active skill: <installed-skill-name>]` to Makaron Agent. Do not call admin skill commands for ordinary users. There is intentionally no user-facing CLI delete command for marketplace skills.
+
+For an explicitly authorized marketplace administrator, `admin skills` shows category assignment and 4-locale title/prompt completeness, while `admin skill-categories` supports list/add/update/delete. New skills must include `en`, `zh`, `zh-Hant`, and `ja` in both `labels` and `prompts`, plus at least one existing `categories` id. Partial localized updates are safely merged server-side.
 
 ### With additional images (existing project)