makaron-cli 0.8.1 → 0.8.2

package/bin/makaron.mjs

@@ -1252,6 +1252,48 @@ function saveMcpImage(result, outputPath) {
   return null;
 }
 
+function wantsHelp(values) {
+  return values.includes('--help') || values.includes('-h');
+}
+
+function printResponsesUsage() {
+  console.log(`Responses commands:
+  responses get <runId>                  Get status and output (JSON)
+  responses get <runId> --wait           Poll until completed
+  responses get <runId> --pick <field>   Extract: first_image_url, first_video_url, project_url, output
+  responses next <runId> --json          New Agent entry: compact timeline + checkpoint guidance
+  responses handle <messageId> --run <runId> --choice approve|revise|ask_user|continue
+  responses deliver <artifactId> --run <runId>   Record artifact delivered to the user
+  responses events <runId> --jsonl       Emit message/approval/artifact events for external Agents
+  responses timeline <runId> --jsonl     Alias for responses events
+  responses timeline <runId> --checkpoint-mode off   Disable text-only checkpoints for pure Q&A
+  responses approve <messageId> --run <runId>    Record approval for a Makaron message
+  responses revise <messageId> --run <runId>     Record revision request for a Makaron message
+  responses ask-user <messageId> --run <runId>   Record that the user must decide
+  responses continue <messageId> --run <runId>   Record continue decision
+  responses watch <runId> --jsonl        Watch until done (incremental events)
+  responses list --project <id>          List runs for a project
+`);
+}
+
+function printResponsesSubcommandUsage(sub) {
+  const usages = {
+    get: 'Usage: makaron responses get <runId> [--wait] [--json] [--pick <field>]',
+    watch: 'Usage: makaron responses watch <runId> [--jsonl] [--interval <ms>]',
+    next: 'Usage: makaron responses next <runId> [--json] [--checkpoint-mode service|off] [--no-fail]',
+    events: 'Usage: makaron responses events <runId> [--jsonl] [--compact] [--checkpoint-mode service|off] [--follow] [--interval <ms>] [--fail-on-unapproved]',
+    timeline: 'Usage: makaron responses timeline <runId> [--jsonl] [--compact] [--checkpoint-mode service|off] [--follow] [--interval <ms>] [--fail-on-unapproved]',
+    deliver: 'Usage: makaron responses deliver <artifactId> --run <runId> [--channel <name>] [--message-id <id>] [--note <text>]',
+    handle: 'Usage: makaron responses handle <messageId> --run <runId> --choice approve|revise|ask_user|continue [--note <text>]',
+    approve: 'Usage: makaron responses approve <messageId> --run <runId> [--note <text>]',
+    revise: 'Usage: makaron responses revise <messageId> --run <runId> [--note <text>]',
+    'ask-user': 'Usage: makaron responses ask-user <messageId> --run <runId> [--note <text>]',
+    continue: 'Usage: makaron responses continue <messageId> --run <runId> [--note <text>]',
+    list: 'Usage: makaron responses list --project <id>',
+  };
+  console.log(usages[sub] || 'Usage: makaron responses --help');
+}
+
 async function analyzeVideoCli(baseUrl, headers, rawVideo, questionParts) {
   if (!rawVideo) {
     console.error('Usage: makaron analyze --video <file|url> ["question"]');
@@ -1479,8 +1521,16 @@ if (command === '--version' || command === '-v' || command === 'version') {
     }
   }
 } else if (command === 'responses' || command === 'run') {
-  const { headers, baseUrl } = getAuth();
   const sub = args[1];
+  if (!sub || sub === '--help' || sub === '-h') {
+    printResponsesUsage();
+    process.exit(0);
+  }
+  if (wantsHelp(args.slice(2))) {
+    printResponsesSubcommandUsage(sub);
+    process.exit(0);
+  }
+  const { headers, baseUrl } = getAuth();
 
   if (sub === 'get') {
     const runId = args[2];
@@ -1616,23 +1666,7 @@ if (command === '--version' || command === '-v' || command === 'version') {
     }
 
   } else {
-    console.log(`Responses commands:
-  responses get <runId>                  Get status and output (JSON)
-  responses get <runId> --wait           Poll until completed
-  responses get <runId> --pick <field>   Extract: first_image_url, first_video_url, project_url, output
-  responses next <runId> --json          New Agent entry: compact timeline + checkpoint guidance
-  responses handle <messageId> --run <runId> --choice approve|revise|ask_user|continue
-  responses deliver <artifactId> --run <runId>   Record artifact delivered to the user
-  responses events <runId> --jsonl       Emit message/approval/artifact events for external Agents
-  responses timeline <runId> --jsonl     Alias for responses events
-  responses timeline <runId> --checkpoint-mode off   Disable text-only checkpoints for pure Q&A
-  responses approve <messageId> --run <runId>    Record approval for a Makaron message
-  responses revise <messageId> --run <runId>     Record revision request for a Makaron message
-  responses ask-user <messageId> --run <runId>   Record that the user must decide
-  responses continue <messageId> --run <runId>   Record continue decision
-  responses watch <runId> --jsonl        Watch until done (incremental events)
-  responses list --project <id>          List runs for a project
-`);
+    printResponsesUsage();
   }
 } else if (command === 'list' || command === 'ls') {
   const { headers, baseUrl } = getAuth();

package/package.json

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