getagenthook 0.2.1 → 1.0.0

package/README.md

@@ -10,7 +10,7 @@ agenthook login --key <your-api-key>
 agenthook tools
 agenthook run make_video --prompt "A barista holds a latte and says: try our new oat flat white" --quality pro --aspect-ratio 9:16 --captions
 agenthook run make_image --prompt "studio shot of a ceramic mug" --count 2
-agenthook run caption_video --video-url https://…/video.mp4 --style tiktok
+agenthook run caption_video --video-url https://…/video.mp4 --style chunk
 agenthook list --search "flat white"
 agenthook balance
 agenthook history

package/dist/cli.js

@@ -33,8 +33,10 @@ Commands:
 Run flags:
   --prompt <text>  --ref <url> (repeatable)  --owns-references  --model <m>
   --quality <standard|pro>  --duration <s>  --aspect-ratio <r>  --no-audio
-  --captions  --caption-style <movie|tiktok>  --enhance-prompt
-  --video-url <url>  --style <movie|tiktok>  --count <n>  --resolution <1k|2k|4k>
+  --captions  --caption-style <chunk|highlight|subtitle>  --caption-size <small|medium|large>
+  --caption-placement <top|center|bottom>  --enhance-prompt
+  --video-url <url>  --style <chunk|highlight|subtitle>  --size <small|medium|large>
+  --placement <top|center|bottom>  --count <n>  --resolution <1k|2k|4k>
   --dry-run        price + validate against the server without spending credits
 
 Auth: pass --key, set AGENTHOOK_API_KEY, or run auth:login (precedence: flag > env > file).

package/dist/commands/run.js

@@ -58,9 +58,13 @@ const RUN_FLAGS = {
     "no-audio": "boolean",
     captions: "boolean",
     "caption-style": "string",
+    "caption-size": "string",
+    "caption-placement": "string",
     "enhance-prompt": "boolean",
     "video-url": "string",
     style: "string",
+    size: "string",
+    placement: "string",
     count: "number",
     resolution: "string",
     language: "string",

package/dist/schema-snapshot.js

@@ -26,8 +26,23 @@ exports.TOOLS_SNAPSHOT = [
                 default: "9:16",
             },
             audio: { type: "boolean", default: true },
-            captions: { type: "boolean", default: false },
-            caption_style: { type: "string", enum: ["movie", "tiktok"], default: "tiktok" },
+            captions: {
+                type: "boolean",
+                default: false,
+                description: "Burn spoken-word captions into the video. When true the run returns two files: output[0] is captioned, output[1] is the original uncaptioned video.",
+            },
+            caption_style: {
+                type: "string",
+                enum: ["chunk", "highlight", "subtitle"],
+                default: "chunk",
+                description: "Caption look. chunk = 2–4 words per line, centered, bold with a heavy outline (the standard TikTok/Reels style). highlight = the same block with the active word lit in colour (the Hormozi/retention style). subtitle = one clean line at the bottom (cinematic / YouTube).",
+            },
+            caption_size: { type: "string", enum: ["small", "medium", "large"], default: "medium", description: "Caption text size." },
+            caption_placement: {
+                type: "string",
+                enum: ["top", "center", "bottom"],
+                description: "Where captions sit. Defaults per style: chunk/highlight → center, subtitle → bottom.",
+            },
             enhance_prompt: { type: "boolean", default: false },
             influencer: {
                 type: "string",
@@ -62,10 +77,21 @@ exports.TOOLS_SNAPSHOT = [
     },
     {
         name: "caption_video",
-        description: "Burn styled subtitles into an existing video.",
+        description: "Burn styled captions into an existing video. Returns two files: output[0] is the captioned video, output[1] is the original uncaptioned video — so you can re-caption with a different style without regenerating. (A speechless video returns just the original.)",
         params: {
             video_url: { type: "string", required: true },
-            style: { type: "string", enum: ["movie", "tiktok"], default: "movie" },
+            style: {
+                type: "string",
+                enum: ["chunk", "highlight", "subtitle"],
+                default: "chunk",
+                description: "Caption look. chunk = bold centered word blocks (standard TikTok/Reels). highlight = active word lit in colour (Hormozi/retention). subtitle = clean bottom line (cinematic / YouTube).",
+            },
+            size: { type: "string", enum: ["small", "medium", "large"], default: "medium", description: "Caption text size." },
+            placement: {
+                type: "string",
+                enum: ["top", "center", "bottom"],
+                description: "Where captions sit. Defaults per style: chunk/highlight → center, subtitle → bottom.",
+            },
             language: { type: "string", default: "auto" },
         },
     },

package/dist/validate.js

@@ -26,9 +26,13 @@ exports.FLAG_FOR = {
     audio: "--no-audio",
     captions: "--captions",
     caption_style: "--caption-style",
+    caption_size: "--caption-size",
+    caption_placement: "--caption-placement",
     enhance_prompt: "--enhance-prompt",
     video_url: "--video-url",
     style: "--style",
+    size: "--size",
+    placement: "--placement",
     count: "--count",
     resolution: "--resolution",
     language: "--language",
@@ -47,8 +51,12 @@ function buildToolInput(flags) {
         ["duration", "duration"],
         ["aspect-ratio", "aspect_ratio"],
         ["caption-style", "caption_style"],
+        ["caption-size", "caption_size"],
+        ["caption-placement", "caption_placement"],
         ["video-url", "video_url"],
         ["style", "style"],
+        ["size", "size"],
+        ["placement", "placement"],
         ["count", "count"],
         ["resolution", "resolution"],
         ["language", "language"],

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "getagenthook",
-  "version": "0.2.1",
+  "version": "1.0.0",
   "description": "CLI for the AgentHook hosted media-generation API — generate video, images, and captions from your terminal or agent.",
   "license": "Apache-2.0",
   "homepage": "https://getagenthook.com",