getagenthook 0.2.0 → 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

@@ -12,6 +12,7 @@ const run_1 = require("./commands/run");
 const tools_1 = require("./commands/tools");
 const exit_1 = require("./exit");
 const http_1 = require("./http");
+const version_1 = require("./version");
 const USAGE = `agenthook — hosted media generation for agents
 
 Usage: agenthook <command> [flags]
@@ -27,12 +28,15 @@ Commands:
   balance                                 credit balance
   history                                 credit ledger
   jobs                                    local run ledger (~/.agenthook/jobs.jsonl)
+  version                                 print the CLI version (also --version / -v)
 
 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).
@@ -64,6 +68,13 @@ async function runCli(argv) {
                 return await (0, history_1.history)(rest);
             case "jobs":
                 return await (0, jobs_1.jobs)(rest);
+            case "version":
+            case "--version":
+            case "-v":
+                // Agents probe this to detect a stale install — must exit 0 with the
+                // package version, never fall through to "Unknown command" (exit 1).
+                console.log(version_1.VERSION);
+                return 0;
             case undefined:
             case "help":
             case "--help":

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",
@@ -124,7 +128,7 @@ async function run(argv) {
             if (e instanceof http_1.ApiError) {
                 const code = (0, exit_1.exitCodeForApiError)(e);
                 if (asJson)
-                    emitError(true, e.message, code, e.status === 402 ? topUpUrl(apiUrl) : undefined);
+                    emitError(true, e.message, code, e.status === 402 ? topUpUrl(apiUrl) : undefined, e.details);
                 else
                     console.error((0, http_1.describeApiError)(e));
                 return code;
@@ -148,7 +152,7 @@ async function run(argv) {
         if (e instanceof http_1.ApiError) {
             const code = (0, exit_1.exitCodeForApiError)(e);
             if (asJson)
-                emitError(true, e.message, code, e.status === 402 ? topUpUrl(apiUrl) : undefined);
+                emitError(true, e.message, code, e.status === 402 ? topUpUrl(apiUrl) : undefined, e.details);
             else
                 console.error((0, http_1.describeApiError)(e));
             return code;
@@ -236,10 +240,17 @@ const topUpUrl = (apiUrl) => `${apiUrl}/credits`;
 function emit(obj) {
     console.log(JSON.stringify(obj));
 }
-/** Human message to stderr, or a JSON error object to stdout under --json. */
-function emitError(asJson, message, code, top_up_url) {
+/** Human message to stderr, or a JSON error object to stdout under --json.
+ * A server 400 carries a `details: [{path,message}]` array naming the offending
+ * params — surfaced in the JSON so an agent needn't re-run without --json. */
+function emitError(asJson, message, code, top_up_url, details) {
     if (asJson)
-        console.log(JSON.stringify({ error: message, exit_code: code, ...(top_up_url ? { top_up_url } : {}) }));
+        console.log(JSON.stringify({
+            error: message,
+            exit_code: code,
+            ...(details && details.length ? { details } : {}),
+            ...(top_up_url ? { top_up_url } : {}),
+        }));
     else
         console.error(message);
 }

package/dist/schema-snapshot.js

@@ -14,15 +14,35 @@ exports.TOOLS_SNAPSHOT = [
             },
             model: { type: "string", enum: ["seedance-2", "kling-3"], default: "seedance-2" },
             quality: { type: "string", enum: ["standard", "pro"], default: "standard" },
-            duration: { type: "number", default: 5, min: 1 },
+            duration: {
+                type: "number",
+                default: 5,
+                min: 1,
+                description: "Video length in seconds. Allowed values depend on model — seedance-2: 4, 5, 6, 8, 10, 12, 15; kling-3: 3, 5, 8, 10, 15.",
+            },
             aspect_ratio: {
                 type: "string",
                 enum: ["16:9", "9:16", "1:1", "4:3", "3:4", "21:9"],
                 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",
@@ -57,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/dist/version.js

@@ -0,0 +1,8 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.VERSION = void 0;
+// Package version, read from package.json at runtime. dist/*.js sits one level
+// under the package root (rootDir src → outDir dist), so ../package.json
+// resolves both from the installed npm package and from the repo's built dist.
+// require() (CommonJS build) reads it synchronously with no bundler step.
+exports.VERSION = require("../package.json").version;

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "getagenthook",
-  "version": "0.2.0",
+  "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",