vidjutsu 1.3.0 → 1.4.0

package/README.md

@@ -1,8 +1,14 @@
 # vidjutsu
 
-TypeScript SDK for the [VidJutsu](https://vidjutsu.ai) video intelligence API.
+Clone viral TikTok and Instagram videos onto your own characters. Typed SDK, CLI, and MCP server for the [VidJutsu](https://vidjutsu.ai) API, auto-generated from the [OpenAPI spec](https://raw.githubusercontent.com/tfcbot/vidjutsu-openapi/main/openapi/spec.json).
 
-Watch, extract, transcribe, and overlay — fully typed, auto-generated from the [OpenAPI spec](https://raw.githubusercontent.com/tfcbot/vidjutsu-openapi/main/openapi/spec.json).
+Point it at a source video and it does three things:
+
+1. **Score it.** A clone check tells you whether the video will clone well before you spend anything on rendering.
+2. **Swap in your character.** Create a reusable character once, then reuse it across every clone.
+3. **Get a rendered clone.** Kling 3.0 Motion Control maps the source motion onto your character while preserving the source soundtrack.
+
+Supporting endpoints cover discovery (scrape TikTok/Instagram), single-video download, and media processing (watch, extract, transcribe, overlay, compliance).
 
 ## Install
 
@@ -10,130 +16,209 @@ Watch, extract, transcribe, and overlay — fully typed, auto-generated from the
 npm install vidjutsu
 ```
 
-## Get your API key
+Or install the standalone CLI (no Node required):
 
 ```bash
 curl -fsSL https://vidjutsu.ai/install.sh | bash
+```
+
+## Get an API key
+
+```bash
 vidjutsu subscribe --email you@example.com
 ```
 
-Your key saves to `~/.vidjutsu/config.json` automatically. The SDK reads it from there — no extra setup needed.
+The key saves to `~/.vidjutsu/config.json`. The SDK and CLI read it from there, so nothing else needs configuring.
+
+## Three ways to use it
+
+- **MCP** — connect an agent (Claude and others) and let it drive the clone workflow.
+- **CLI** — `vidjutsu clone ...` from a terminal.
+- **SDK** — typed methods in TypeScript.
+
+### MCP
+
+For **Claude Code**:
+
+```bash
+claude mcp add --transport http vidjutsu https://api.vidjutsu.ai/mcp
+```
+
+For the **Claude desktop and web apps**, add a custom connector pointing at `https://api.vidjutsu.ai/mcp` and complete the OAuth prompt. There is no command to run.
+
+### CLI
+
+Characters are reusable. Create one, then clone any number of videos with it.
+
+```bash
+# 1. Create a character once. This prints a char_... id.
+vidjutsu clone character --prompt "A neutral, camera-ready presenter"
+
+# 2. Check whether a source video will clone well (optional but recommended).
+vidjutsu clone check "https://www.tiktok.com/@creator/video/123456789"
+
+# 3. Clone the video onto your character.
+vidjutsu clone run "https://www.tiktok.com/@creator/video/123456789" \
+  --character char_abc123
+
+# List your characters any time.
+vidjutsu clone character list
+```
+
+`clone run` downloads the source video, runs the clone check, extracts frame 0, builds a character-swapped starting frame, submits a Kling 3.0 Motion Control generation, and waits for the final URL. It stops if the check verdict is weak unless you pass `--force`. Source clips are limited to 15 seconds.
 
-## Quick start
+### SDK
 
 ```ts
 import { createClient } from "vidjutsu";
 
-const vj = createClient();
+const vj = createClient(); // reads ~/.vidjutsu/config.json or env vars
 
-// Watch — AI analyzes a video and answers your prompt (50/day)
-const { data: watch } = await vj.watchMedia({
-  mediaUrl: "https://cdn.example.com/video.mp4",
-  prompt: "Is the hook strong enough for fitness TikTok?",
+// 1. Create a reusable character (returns { id: "char_...", imageUrl, model }).
+const { data: character } = await vj.createCharacter({
+  prompt: "A neutral, camera-ready presenter",
 });
-console.log(watch.response);
 
-// Extract — pull frames, audio, and metadata (100/day)
-const { data: extract } = await vj.extractMedia({
-  mediaUrl: "https://cdn.example.com/video.mp4",
-  frames: "auto",
-  audio: true,
+// 2. Stage the source video's file, then check it.
+const { data: source } = await vj.downloadTikTokVideo({
+  url: "https://www.tiktok.com/@creator/video/123456789",
+});
+const { data: check } = await vj.cloneCheck({ videoUrl: source.url });
+console.log(check.verdict, check.score);
+
+// 3. Extract frame 0 and build a character-swapped starting frame.
+const { data: extracted } = await vj.extractMedia({
+  mediaUrl: source.url,
+  frames: [0],
+  audio: false,
+  metadata: false,
 });
-console.log(extract.frames, extract.metadata);
+const firstFrame = extracted.frames?.[0]?.url;
+if (!firstFrame) throw new Error("No first frame returned");
 
-// Transcribe — speech-to-text with word-level timing (30/day)
-const { data: transcript } = await vj.transcribeMedia({
-  mediaUrl: "https://cdn.example.com/video.mp4",
+const { data: starting } = await vj.cloneStartingImage({
+  firstFrame,
+  characterId: character.id,
+  prompt: "Match the framing and lighting of the source",
 });
-console.log(transcript.transcript, transcript.words);
 
-// Overlay — burn text onto video (50/day)
-const { data: overlay } = await vj.createOverlay({
-  videoUrl: "https://cdn.example.com/video.mp4",
-  text: "Follow for more tips",
-  position: "bottom",
+// 4. Generate the clone video, then poll for the final URL.
+const { data: task } = await vj.cloneVideo({
+  startingImageUrl: starting.imageUrl,
+  sourceVideoUrl: source.url,
+  model: "kling", // the only supported clone-video model
 });
-console.log(overlay.resultUrl);
+let result;
+do {
+  await new Promise((resolve) => setTimeout(resolve, 3000));
+  ({ data: result } = await vj.getCloneVideo(task.id));
+} while (result.status === "processing");
+if (result.status === "failed") throw new Error(result.error);
+console.log(result.videoUrl);
 ```
 
+Every method returns the `openapi-fetch` shape: `{ data, error, response }`.
+
 ## Authentication
 
 The client resolves your API key in this order:
 
 1. **Explicit** — `createClient({ apiKey: "vj_live_..." })`
 2. **Environment variable** — `VIDJUTSU_API_KEY`
-3. **Config file** — `~/.vidjutsu/config.json` (written by `vidjutsu auth`)
+3. **Config file** — `~/.vidjutsu/config.json` (written by `vidjutsu subscribe` / `vidjutsu auth`)
 
 ```ts
-// Reads from env or config file
-const vj = createClient();
+const vj = createClient();                                  // env or config file
+const vj = createClient({ apiKey: "vj_live_..." });         // explicit
+const vj = createClient({ baseUrl: "https://staging.api.vidjutsu.ai" }); // custom host
+```
 
-// Or pass explicitly
-const vj = createClient({ apiKey: "vj_live_..." });
+The default base URL is `https://api.vidjutsu.ai`.
 
-// Custom base URL
-const vj = createClient({ baseUrl: "https://staging.api.vidjutsu.ai" });
-```
+## Methods
 
-## All methods
+### Clone
 
-### Video intelligence (metered)
+| Method | Description |
+|--------|-------------|
+| `cloneCheck(body)` | Score whether a source video will clone well |
+| `createCharacter(body)` / `getCharacter(id)` / `listCharacters()` | Create and reuse persisted characters |
+| `cloneStartingImage(body)` | Build a character-swapped starting frame (no overlays) |
+| `cloneVideo(body)` / `getCloneVideo(id)` | Generate a clone video and poll the task |
+
+### Discovery (scrape)
 
-Requires an active subscription. Each endpoint has its own daily rate limit (fixed window, resets 00:00 UTC). Hitting a limit returns HTTP 429 with a `retryAfter` hint.
+Metadata and discovery only. Scrape returns the provider's raw source URLs and never stages media.
 
-| Method | Daily limit | Description |
-|--------|-------------|-------------|
-| `watchMedia(body)` | 50 / day | AI watches a video/image and answers your prompt |
-| `extractMedia(body)` | 100 / day | Extract frames, audio, and metadata from video |
-| `transcribeMedia(body)` | 30 / day | Speech-to-text with word-level timing |
-| `checkSpec(body)` | 100 / day | Validate a VidLang spec against rules |
-| `createOverlay(body)` | 50 / day | Burn text overlay onto video |
+| Method | Description |
+|--------|-------------|
+| `scrapeTikTokTrending(body)` / `scrapeTikTokProfile(body)` / `scrapeTikTokProfileVideos(body)` | Find TikTok videos |
+| `scrapeTikTokVideo(body)` / `scrapeTikTokVideoTranscript(body)` / `scrapeTikTokVideoComments(body)` | Single TikTok video, transcript, comments |
+| `scrapeTikTokSearchUsers(body)` | Search TikTok users |
+| `scrapeInstagramProfile(body)` / `scrapeInstagramUserPosts(body)` / `scrapeInstagramUserReels(body)` | Find Instagram content |
+| `scrapeInstagramPost(body)` / `scrapeInstagramPostComments(body)` | Single Instagram post, comments |
+
+### Download
+
+Stage one video's file to the CDN, one call per video.
+
+| Method | Description |
+|--------|-------------|
+| `downloadTikTokVideo(body)` / `downloadInstagramVideo(body)` | Download and stage a single video |
+
+### Media processing (metered)
+
+Each endpoint has its own daily rate limit (fixed window, resets 00:00 UTC). Hitting a limit returns HTTP 429 with a `retryAfter` hint.
+
+| Method | Description |
+|--------|-------------|
+| `watchMedia(body)` | AI watches a video/image and answers your prompt |
+| `extractMedia(body)` | Extract frames, audio, and metadata |
+| `transcribeMedia(body)` | Speech-to-text with word-level timing |
+| `createOverlay(body)` / `createDisclaimer(body)` | Burn text or a disclaimer onto video |
+| `checkComplianceVideo(body)` / `checkCompliancePrompt(body)` | Ad-compliance checks |
 
-### Resources (unmetered)
+### Resources
 
 | Method | Description |
 |--------|-------------|
-| `createAccount(body)` / `updateAccount(body, query)` / `listOrGetAccounts(query)` / `deleteAccount(query)` | Manage accounts |
-| `createPost(body)` / `updatePost(body, query)` / `listOrGetPosts(query)` / `deletePost(query)` | Manage posts |
-| `createAsset(body)` / `updateAsset(body, query)` / `listOrGetAssets(query)` / `deleteAsset(query)` | Manage assets |
-| `createReference(body)` / `updateReference(body, query)` / `listOrGetReferences(query)` / `deleteReference(query)` | Manage references |
-| `uploadFile(body)` / `uploadFromUrl(body)` | Upload media to CDN |
+| `createAccount` / `updateAccount` / `listOrGetAccounts` / `deleteAccount` | Accounts |
+| `createPost` / `updatePost` / `listOrGetPosts` / `deletePost` | Posts |
+| `createAsset` / `updateAsset` / `listOrGetAssets` / `deleteAsset` | Assets |
+| `createReference` / `updateReference` / `listOrGetReferences` / `deleteReference` | References |
+| `createEditorProject` / `updateEditorProject` / `listOrGetEditorProjects` / `deleteEditorProject` | Editor projects |
+| `uploadFile(body)` / `uploadFromUrl(body)` | Upload media to the CDN |
 
-### Utilities (free)
+### Account and billing
 
 | Method | Description |
 |--------|-------------|
-| `getInfo()` | API info and endpoint discovery |
-| `getPricing()` | Current pricing |
-| `createCheckout(body)` | Create Stripe checkout session |
-| `getCheckoutStatus(query)` | Check checkout status |
-| `createSubscription(body)` | Subscribe ($99/mo) |
-| `rotateApiKey()` | Rotate API key (invalidates current key) |
-| `recoverApiKey(body)` | Recover key via email |
+| `getInfo()` / `getPricing()` / `getUsage()` | API info, pricing, remaining daily capacity |
+| `createSubscription(body)` / `getCheckoutStatus(query)` | Subscribe and check checkout status |
+| `rotateApiKey()` / `recoverApiKey(body)` | Rotate or recover your key |
 
 ## Raw client
 
-Every method returns the `openapi-fetch` response shape: `{ data, error, response }`. For endpoints not covered by convenience methods, use the raw client:
+For any endpoint without a convenience method, use the raw `openapi-fetch` client:
 
 ```ts
-const { data, error } = await vj.api.GET("/v1/usage");
-const { data, error } = await vj.api.POST("/v1/watch", {
-  body: { mediaUrl: "...", prompt: "..." },
+const { data } = await vj.api.GET("/v1/usage");
+const { data } = await vj.api.POST("/v1/clones/check", {
+  body: { videoUrl: "https://..." },
 });
 ```
 
-## Pricing & billing
+## Pricing and billing
 
-- **$99/month flat** — full API access via Stripe, billed monthly, cancel anytime.
-- **No credits, no metered billing, no top-ups** — usage is governed by per-endpoint daily rate limits (reset 00:00 UTC), not a credit balance.
+- **$99/month flat** for full API access, via Stripe, billed monthly, cancel anytime.
+- No credits and no top-ups. Usage is governed by per-endpoint daily rate limits that reset at 00:00 UTC.
 - Hitting a daily limit returns **HTTP 429** with a `retryAfter` hint. Check remaining capacity with `getUsage()` or `GET /v1/usage`.
-- `GET /v1/pricing` is the single source of truth for current price and limits.
+- `GET /v1/pricing` is the source of truth for current price and limits.
 
 ## Links
 
 - [Documentation](https://docs.vidjutsu.ai)
 - [API Reference](https://docs.vidjutsu.ai/api-reference/introduction)
-- [CLI](https://github.com/tfcbot/vidjutsu-sdk) (included in this package)
 - [OpenAPI Spec](https://raw.githubusercontent.com/tfcbot/vidjutsu-openapi/main/openapi/spec.json)
 
 ## License

package/dist/cli/index.mjs

@@ -2190,7 +2190,7 @@ var init_dist2 = __esm(() => {
 });
 
 // src/cli/version.ts
-var VERSION = "1.0.0";
+var VERSION = "1.4.0";
 
 // src/cli/client.ts
 import { readFileSync, writeFileSync, existsSync, mkdirSync } from "fs";
@@ -2607,21 +2607,19 @@ var init_status = __esm(() => {
   status_default = defineCommand({
     meta: { name: "status", description: "Check resource status by ID" },
     args: {
-      id: { type: "positional", description: "Resource ID (job_xxx, acc_xxx, post_xxx, ref_xxx)", required: true }
+      id: { type: "positional", description: "Resource ID (acc_xxx, post_xxx, ref_xxx)", required: true }
     },
     async run({ args }) {
       const id = args.id;
       let path;
-      if (id.startsWith("job_"))
-        path = `/v1/distribution/jobs?id=${id}`;
-      else if (id.startsWith("acc_"))
+      if (id.startsWith("acc_"))
         path = `/v1/accounts?id=${id}`;
       else if (id.startsWith("post_"))
         path = `/v1/posts?id=${id}`;
       else if (id.startsWith("ref_"))
         path = `/v1/references?id=${id}`;
       else {
-        console.error("Unknown ID prefix. Expected job_, acc_, post_, or ref_");
+        console.error("Unknown ID prefix. Expected acc_, post_, or ref_");
         process.exit(1);
       }
       const result = await apiRequest("GET", path);
@@ -2630,148 +2628,6 @@ var init_status = __esm(() => {
   });
 });
 
-// src/cli/commands/balance.ts
-var exports_balance = {};
-__export(exports_balance, {
-  default: () => balance_default
-});
-function fmtTs(ms) {
-  const d2 = new Date(ms);
-  const pad = (n2) => String(n2).padStart(2, "0");
-  return `${d2.getUTCFullYear()}-${pad(d2.getUTCMonth() + 1)}-${pad(d2.getUTCDate())} ${pad(d2.getUTCHours())}:${pad(d2.getUTCMinutes())} UTC`;
-}
-function fmtDelta(n2) {
-  const s2 = n2 >= 0 ? `+${n2}` : String(n2);
-  return s2.padStart(6);
-}
-var balance_default;
-var init_balance = __esm(() => {
-  init_dist2();
-  init_client();
-  balance_default = defineCommand({
-    meta: {
-      name: "balance",
-      description: "Show credit balance and recent ledger entries"
-    },
-    args: {
-      json: {
-        type: "boolean",
-        description: "Emit raw JSON instead of a table",
-        default: false
-      }
-    },
-    async run({ args }) {
-      const res = await apiRequest("GET", "/v1/balance");
-      if (args.json) {
-        console.log(JSON.stringify(res, null, 2));
-        return;
-      }
-      console.log(`Balance: ${res.balance} credits`);
-      if (!res.ledger || res.ledger.length === 0) {
-        console.log(`
-No ledger entries yet.`);
-        return;
-      }
-      console.log(`
-Recent ledger (newest first):`);
-      for (const e2 of res.ledger) {
-        const detail = e2.operationId ?? e2.note ?? "";
-        console.log(`  ${fmtDelta(e2.delta)}  ${e2.reason.padEnd(7)}  ${fmtTs(e2.createdAt)}  ${detail}`);
-      }
-    }
-  });
-});
-
-// src/cli/commands/admin.ts
-var exports_admin = {};
-__export(exports_admin, {
-  default: () => admin_default
-});
-import { spawnSync } from "node:child_process";
-var grant, admin_default;
-var init_admin = __esm(() => {
-  init_dist2();
-  grant = defineCommand({
-    meta: {
-      name: "grant",
-      description: "Grant credits to a client (looked up by email or clientId). Runs the Convex mutation directly via 'npx convex run'."
-    },
-    args: {
-      email: {
-        type: "string",
-        description: "Email of the client to grant credits to"
-      },
-      client: {
-        type: "string",
-        description: "clientId of the client to grant credits to"
-      },
-      amount: {
-        type: "string",
-        description: "Number of credits to grant (positive integer)",
-        required: true
-      },
-      note: {
-        type: "string",
-        description: "Optional admin note recorded on the ledger row"
-      },
-      repo: {
-        type: "string",
-        description: "Path to the vidjutsu Convex repo where 'npx convex run' executes (defaults to cwd)"
-      }
-    },
-    async run({ args }) {
-      if (!args.email && !args.client) {
-        console.error("Error: provide --email <e> or --client <clientId>");
-        process.exit(1);
-      }
-      const amount = Number(args.amount);
-      if (!Number.isInteger(amount) || amount <= 0) {
-        console.error("Error: --amount must be a positive integer");
-        process.exit(1);
-      }
-      const payload = { amount };
-      if (args.email)
-        payload.email = args.email;
-      if (args.client)
-        payload.clientId = args.client;
-      if (args.note)
-        payload.note = args.note;
-      const cwd = args.repo ?? process.cwd();
-      const cmdArgs = [
-        "convex",
-        "run",
-        "services/machineClients:grantCreditsByLookup",
-        JSON.stringify(payload)
-      ];
-      const result = spawnSync("npx", cmdArgs, {
-        cwd,
-        encoding: "utf-8",
-        stdio: ["ignore", "pipe", "pipe"]
-      });
-      if (result.error) {
-        console.error("Error invoking npx convex:", result.error.message);
-        process.exit(1);
-      }
-      if (result.stdout)
-        process.stdout.write(result.stdout);
-      if (result.stderr)
-        process.stderr.write(result.stderr);
-      if (result.status !== 0) {
-        process.exit(result.status ?? 1);
-      }
-    }
-  });
-  admin_default = defineCommand({
-    meta: {
-      name: "admin",
-      description: "Admin operations (credit grants, etc.)"
-    },
-    subCommands: {
-      grant: () => grant
-    }
-  });
-});
-
 // src/cli/commands/version.ts
 var exports_version = {};
 __export(exports_version, {
@@ -2866,58 +2722,6 @@ var init_update = __esm(() => {
   });
 });
 
-// src/cli/commands/jobs.ts
-var exports_jobs = {};
-__export(exports_jobs, {
-  default: () => jobs_default
-});
-async function getJob(jobId) {
-  return await apiRequest("GET", `/v1/jobs?id=${encodeURIComponent(jobId)}`);
-}
-var jobs_default;
-var init_jobs = __esm(() => {
-  init_dist2();
-  init_client();
-  jobs_default = defineCommand({
-    meta: { name: "jobs", description: "Inspect durable VidJutsu media jobs" },
-    subCommands: {
-      get: defineCommand({
-        meta: { name: "get", description: "Get a job" },
-        args: {
-          id: { type: "positional", description: "Job ID", required: true }
-        },
-        async run({ args }) {
-          console.log(JSON.stringify(await getJob(args.id), null, 2));
-        }
-      }),
-      wait: defineCommand({
-        meta: { name: "wait", description: "Wait for a job to complete" },
-        args: {
-          id: { type: "positional", description: "Job ID", required: true },
-          timeout: { type: "string", description: "Timeout in seconds", default: "600" },
-          interval: { type: "string", description: "Poll interval in milliseconds", default: "1000" }
-        },
-        async run({ args }) {
-          const deadline = Date.now() + Number(args.timeout) * 1000;
-          while (true) {
-            const job = await getJob(args.id);
-            if (job?.status === "completed") {
-              console.log(JSON.stringify(job, null, 2));
-              return;
-            }
-            if (job?.status === "failed" || job?.status === "cancelled") {
-              throw new Error(job.error?.message ?? `Job ${job.status}`);
-            }
-            if (Date.now() >= deadline)
-              throw new Error(`Timed out waiting for ${args.id}`);
-            await new Promise((resolve) => setTimeout(resolve, Number(args.interval)));
-          }
-        }
-      })
-    }
-  });
-});
-
 // src/cli/commands/clone.ts
 var exports_clone = {};
 __export(exports_clone, {
@@ -2934,8 +2738,11 @@ function validateModel(model) {
 function isCharacterId(value) {
   return value.startsWith("char_");
 }
-function characterRef(value) {
-  return isCharacterId(value) ? { characterId: value } : { characterImageUrl: value };
+function requireCharacterId(value) {
+  if (!isCharacterId(value)) {
+    throw new Error("--character must be a stored character id beginning with char_");
+  }
+  return value;
 }
 async function pollCloneVideo(id, { intervalMs = 3000, timeoutMs = 600000 } = {}) {
   const deadline = Date.now() + timeoutMs;
@@ -2954,17 +2761,17 @@ var VALID_MODELS, clone_default;
 var init_clone = __esm(() => {
   init_dist2();
   init_client();
-  VALID_MODELS = ["kling", "seedance"];
+  VALID_MODELS = ["kling"];
   clone_default = defineCommand({
     meta: {
       name: "clone",
-      description: "Clone a source video's motion onto a new character. About 5 minutes end to end for the full chain. " + "Kling motion control is the default model; output is 480p 9:16. Source clips are capped at 15 seconds. " + "Each step below is metered per call."
+      description: "Clone a source video's motion onto a new character. About 5 minutes end to end for the full chain. " + "Kling 3.0 Motion Control is the supported model. Source clips are capped at 15 seconds. " + "Generation steps share the subscription's daily clone limit."
     },
     subCommands: {
       check: defineCommand({
         meta: {
           name: "check",
-          description: "Evaluate whether a source video can be cloned reliably. Metered per call. " + "Exits nonzero when the verdict is weak."
+          description: "Evaluate whether a source video can be cloned reliably. Uses the daily clone limit. " + "Exits nonzero when the verdict is weak."
         },
         args: {
           videoUrl: { type: "positional", description: "Public HTTPS URL of the source video", required: true },
@@ -2989,7 +2796,7 @@ var init_clone = __esm(() => {
       character: defineCommand({
         meta: {
           name: "character",
-          description: "Create a reusable, persisted character. Create it once, then reuse the printed id for every " + "clone (see `vidjutsu clone starting-image --character <id>` and `clone run --character <id>`). " + "Metered per call."
+          description: "Create a reusable, persisted character. Create it once, then reuse the printed id for every " + "clone (see `vidjutsu clone starting-image --character <id>` and `clone run --character <id>`). " + "Uses the daily clone limit."
         },
         subCommands: {
           list: defineCommand({
@@ -3034,22 +2841,26 @@ var init_clone = __esm(() => {
       "starting-image": defineCommand({
         meta: {
           name: "starting-image",
-          description: "Create a character-swapped starting frame, with no overlays. --character accepts either a stored " + "character id (char_...) or a public HTTPS character image URL. Metered per call."
+          description: "Create a character-swapped starting frame from an extracted first frame and a stored character id. Uses the daily clone limit."
         },
         args: {
           character: {
             type: "string",
-            description: "Stored character id (char_...) from `clone character`, or a public HTTPS character image URL",
+            description: "Stored character id (char_...) from `clone character`",
+            required: true
+          },
+          "first-frame": {
+            type: "string",
+            description: "Public HTTPS URL of the source video's extracted first-frame image",
             required: true
           },
-          prompt: { type: "string", description: "Instructions for composing the starting frame", required: true },
-          source: { type: "string", description: "Optional public HTTPS source video URL to ground the composition" }
+          prompt: { type: "string", description: "Instructions for composing the starting frame", required: true }
         },
         async run({ args }) {
           const result = await apiRequest("POST", "/v1/clones/starting-image", {
-            ...characterRef(args.character),
-            prompt: args.prompt,
-            sourceVideoUrl: args.source
+            firstFrame: args["first-frame"],
+            characterId: requireCharacterId(args.character),
+            prompt: args.prompt
           });
           console.log(result.imageUrl);
         }
@@ -3057,13 +2868,13 @@ var init_clone = __esm(() => {
       video: defineCommand({
         meta: {
           name: "video",
-          description: "Clone source motion onto a starting image. Kling motion control is the default; seedance is the " + "alternate model, 9:16 at 480p. Metered per call. Returns a task id (HTTP 202); use --wait to poll to completion."
+          description: "Clone source motion onto a starting image with Kling 3.0 Motion Control. Uses the daily clone limit. " + "Returns a task id (HTTP 202); use --wait to poll to completion."
         },
         args: {
           "starting-image": { type: "string", description: "Public HTTPS URL of the starting frame", required: true },
           source: { type: "string", description: "Public HTTPS URL of the source video whose motion is cloned", required: true },
-          model: { type: "string", description: "kling (default) or seedance" },
-          prompt: { type: "string", description: "Optional override for the default identity-swap prompt (seedance only)" },
+          model: { type: "string", description: "kling (the only supported model)" },
+          prompt: { type: "string", description: "Optional override for the default motion-control prompt" },
           wait: { type: "boolean", description: "Poll GET status until completed or failed, then print videoUrl" }
         },
         async run({ args }) {
@@ -3097,7 +2908,7 @@ var init_clone = __esm(() => {
       run: defineCommand({
         meta: {
           name: "run",
-          description: "Run the full clone chain: download the TikTok video, check it, generate a starting image from a " + "reusable stored character, generate the clone video, and wait for it to finish. About 5 minutes end " + "to end. Characters are reusable: create one once with `vidjutsu clone character --prompt ...`, then " + "pass its id here with --character on every run — this command never generates a new random character. " + "--character is required. Kling motion control is the default model; output is 480p 9:16, source clips " + "are capped at 15 seconds. Each step is metered per call. Stops before spending on generation when the " + "check verdict is weak, unless --force is given."
+          description: "Run the full clone chain: download the TikTok video, check it, generate a starting image from a " + "reusable stored character, generate the clone video, and wait for it to finish. About 5 minutes end " + "to end. Characters are reusable: create one once with `vidjutsu clone character --prompt ...`, then " + "pass its id here with --character on every run — this command never generates a new random character. " + "--character is required. Kling 3.0 Motion Control is the only model; source clips " + "are capped at 15 seconds. Generation steps share the daily clone limit. Stops before generation when the " + "check verdict is weak, unless --force is given. The command extracts frame 0 and passes it directly " + "to the character edit step."
         },
         args: {
           tiktokUrl: { type: "positional", description: "TikTok video URL to clone", required: true },
@@ -3106,16 +2917,17 @@ var init_clone = __esm(() => {
             description: "Required. Stored character id (char_...) from `vidjutsu clone character --prompt ...`. " + "Characters are reusable across runs — create one once, then pass its id here every time."
           },
           "starting-prompt": { type: "string", description: "Prompt for the starting frame composition" },
-          model: { type: "string", description: "kling (default) or seedance" },
+          model: { type: "string", description: "kling (the only supported model)" },
           force: { type: "boolean", description: "Proceed even if the clone check verdict is weak" }
         },
         async run({ args }) {
-          const model = validateModel(args.model);
+          const model = validateModel(args.model) ?? "kling";
           if (!args.character) {
             console.log("Missing --character. Create a reusable character first with: " + 'vidjutsu clone character --prompt "A neutral, camera-ready presenter"');
             console.log("Then pass its id here: vidjutsu clone run <url> --character char_...");
             process.exit(1);
           }
+          const characterId = requireCharacterId(args.character);
           console.log(`Downloading ${args.tiktokUrl}...`);
           const download = await apiRequest("POST", "/v1/videos/download/tiktok", {
             url: args.tiktokUrl
@@ -3132,11 +2944,21 @@ var init_clone = __esm(() => {
             console.log("Stopping: the source clip is unlikely to clone well. Pass --force to continue anyway.");
             process.exit(1);
           }
+          console.log("Extracting first frame...");
+          const extracted = await apiRequest("POST", "/v1/extract", {
+            mediaUrl: download.url,
+            frames: [0],
+            audio: false,
+            metadata: false
+          });
+          const firstFrame = extracted.frames?.find((frame) => frame.index === 0)?.url ?? extracted.frames?.[0]?.url;
+          if (!firstFrame)
+            throw new Error("The source video did not return an extracted first frame");
           console.log("Generating starting image...");
           const startingImage = await apiRequest("POST", "/v1/clones/starting-image", {
-            ...characterRef(args.character),
-            prompt: args["starting-prompt"] ?? "Match the framing and pose of the source video's opening frame",
-            sourceVideoUrl: download.url
+            firstFrame,
+            characterId,
+            prompt: args["starting-prompt"] ?? "Match the framing and pose of the source video's opening frame"
           });
           console.log("Generating clone video...");
           const accepted = await apiRequest("POST", "/v1/clones/video", {
@@ -3924,7 +3746,7 @@ var main = defineCommand({
   meta: {
     name: "vidjutsu",
     version: VERSION,
-    description: "Video intelligence API — watch, extract, transcribe, check."
+    description: "Clone short-form videos and process media with the VidJutsu API."
   },
   subCommands: {
     auth: () => Promise.resolve().then(() => (init_auth(), exports_auth)).then((m2) => m2.default),
@@ -3932,11 +3754,8 @@ var main = defineCommand({
     upload: () => Promise.resolve().then(() => (init_upload(), exports_upload)).then((m2) => m2.default),
     subscribe: () => Promise.resolve().then(() => (init_subscribe(), exports_subscribe)).then((m2) => m2.default),
     status: () => Promise.resolve().then(() => (init_status(), exports_status)).then((m2) => m2.default),
-    balance: () => Promise.resolve().then(() => (init_balance(), exports_balance)).then((m2) => m2.default),
-    admin: () => Promise.resolve().then(() => (init_admin(), exports_admin)).then((m2) => m2.default),
     version: () => Promise.resolve().then(() => (init_version(), exports_version)).then((m2) => m2.default),
     update: () => Promise.resolve().then(() => (init_update(), exports_update)).then((m2) => m2.default),
-    jobs: () => Promise.resolve().then(() => (init_jobs(), exports_jobs)).then((m2) => m2.default),
     clone: () => Promise.resolve().then(() => (init_clone(), exports_clone)).then((m2) => m2.default),
     watch: () => Promise.resolve().then(() => (init_watch(), exports_watch)).then((m2) => m2.default),
     extract: () => Promise.resolve().then(() => (init_extract(), exports_extract)).then((m2) => m2.default),

package/dist/client.d.ts

@@ -1,8 +1,6 @@
 import createFetchClient from "openapi-fetch";
 import type { paths } from "./schema.js";
 import { type VidJutsuMethods } from "./methods.js";
-import { type DistributionNamespaces } from "./distribution.js";
-import { type JobsNamespaces } from "./jobs.js";
 export interface VidJutsuConfig {
     /** API key. Falls back to VIDJUTSU_API_KEY env var, then ~/.vidjutsu/config.json. */
     apiKey?: string;
@@ -12,7 +10,7 @@ export interface VidJutsuConfig {
 /** The raw openapi-fetch client with typed GET/POST/PUT/DELETE */
 type FetchClient = ReturnType<typeof createFetchClient<paths>>;
 /** Combined client: typed convenience methods + raw openapi-fetch escape hatch */
-export type VidJutsuClient = VidJutsuMethods & DistributionNamespaces & JobsNamespaces & {
+export type VidJutsuClient = VidJutsuMethods & {
     api: FetchClient;
 };
 /**

package/dist/client.js

@@ -1,7 +1,5 @@
 import createFetchClient from "openapi-fetch";
 import { bindMethods } from "./methods.js";
-import { bindDistribution } from "./distribution.js";
-import { bindJobs } from "./jobs.js";
 import { readFileSync, existsSync } from "fs";
 import { join } from "path";
 import { homedir } from "os";
@@ -52,7 +50,5 @@ export function createClient(config = {}) {
         },
     });
     const methods = bindMethods(fetchClient);
-    const distribution = bindDistribution(fetchClient);
-    const jobs = bindJobs(fetchClient);
-    return { ...methods, ...distribution, ...jobs, api: fetchClient };
+    return { ...methods, api: fetchClient };
 }

package/dist/index.d.ts

@@ -1,6 +1,4 @@
 export { createClient } from "./client.js";
 export type { VidJutsuConfig, VidJutsuClient } from "./client.js";
 export type { VidJutsuMethods } from "./methods.js";
-export type { DistributionNamespaces, MutationOptions, WaitOptions } from "./distribution.js";
-export type { JobsNamespaces } from "./jobs.js";
 export type { paths, components } from "./schema.js";

package/dist/methods.d.ts

@@ -14,143 +14,137 @@ type QueryParams<P extends keyof paths, M extends keyof paths[P]> = paths[P][M]
     };
 } ? Q : never;
 export interface VidJutsuMethods {
-    /** Create account Auth required. */
+    /** Create account Bearer API key required. */
     createAccount(body: ReqBody<"/v1/accounts", "post">): ReturnType<Client["POST"]>;
-    /** Update account Auth required. */
+    /** Update account Bearer API key required. */
     updateAccount(body: ReqBody<"/v1/accounts", "put">, query?: QueryParams<"/v1/accounts", "put">): ReturnType<Client["PUT"]>;
-    /** List accounts or get by ID Auth required. */
+    /** List accounts or get by ID Bearer API key required. */
     listOrGetAccounts(query?: QueryParams<"/v1/accounts", "get">): ReturnType<Client["GET"]>;
-    /** Delete account Auth required. */
+    /** Delete account Bearer API key required. */
     deleteAccount(query?: QueryParams<"/v1/accounts", "delete">): ReturnType<Client["DELETE"]>;
     /** Recover API key Public endpoint. */
     recoverApiKey(body: ReqBody<"/v1/api_keys/recover", "post">): ReturnType<Client["POST"]>;
-    /** Rotate API key Auth required. */
+    /** Rotate API key Bearer API key required. */
     rotateApiKey(): ReturnType<Client["POST"]>;
-    /** Create asset from existing URL Auth required. */
+    /** Create asset from existing URL Bearer API key required. */
     createAsset(body: ReqBody<"/v1/assets", "post">): ReturnType<Client["POST"]>;
-    /** Update asset metadata Auth required. */
+    /** Update asset metadata Bearer API key required. */
     updateAsset(body: ReqBody<"/v1/assets", "put">, query?: QueryParams<"/v1/assets", "put">): ReturnType<Client["PUT"]>;
-    /** List assets or get by ID Auth required. */
+    /** List assets or get by ID Bearer API key required. */
     listOrGetAssets(query?: QueryParams<"/v1/assets", "get">): ReturnType<Client["GET"]>;
-    /** Delete asset (soft) Auth required. */
+    /** Delete asset (soft) Bearer API key required. */
     deleteAsset(query?: QueryParams<"/v1/assets", "delete">): ReturnType<Client["DELETE"]>;
-    /** Agent registration (auth.md) */
+    /** Agent registration (auth.md) Public endpoint. */
     signupAgent(body: ReqBody<"/v1/auth/agent", "post">): ReturnType<Client["POST"]>;
-    /** Initiate claim flow */
+    /** Initiate claim flow Public endpoint. */
     agentClaim(body: ReqBody<"/v1/auth/agent/claim", "post">): ReturnType<Client["POST"]>;
-    /** Complete claim flow */
+    /** Complete claim flow Public endpoint. */
     agentClaimComplete(body: ReqBody<"/v1/auth/agent/claim/complete", "post">): ReturnType<Client["POST"]>;
-    /** Revoke credential */
+    /** Revoke credential Public endpoint. */
     agentRevoke(): ReturnType<Client["POST"]>;
     /** Confirm email verification code Public endpoint. */
     confirmVerification(body: ReqBody<"/v1/auth/verify/confirm", "post">): ReturnType<Client["POST"]>;
     /** Request email verification code Public endpoint. */
     requestVerification(body: ReqBody<"/v1/auth/verify/request", "post">): ReturnType<Client["POST"]>;
-    /** Create a reusable, persisted character image */
+    /** Create a reusable, persisted character image Active subscription and daily quota required. */
     createCharacter(body: ReqBody<"/v1/characters", "post">): ReturnType<Client["POST"]>;
-    /** List your persisted characters */
+    /** List your persisted characters Bearer API key required. */
     listCharacters(): ReturnType<Client["GET"]>;
-    /** Fetch a persisted character by id */
+    /** Fetch a persisted character by id Bearer API key required. */
     getCharacter(id: string): ReturnType<Client["GET"]>;
-    /** Check spec Auth required. 5 credits. */
+    /** Check spec Active subscription and daily quota required. */
     checkSpec(body: ReqBody<"/v1/check", "post">): ReturnType<Client["POST"]>;
-    /** Get check rules Auth required. */
+    /** Get check rules Bearer API key required. */
     getCheckRules(): ReturnType<Client["GET"]>;
-    /** Update check rules Auth required. */
+    /** Update check rules Bearer API key required. */
     updateCheckRules(body: ReqBody<"/v1/check/rules", "put">): ReturnType<Client["PUT"]>;
-    /** Evaluate whether a source video can be cloned reliably */
+    /** Evaluate whether a source video can be cloned reliably Active subscription and daily quota required. */
     cloneCheck(body: ReqBody<"/v1/clones/check", "post">): ReturnType<Client["POST"]>;
-    /** Create a character-swapped starting frame */
+    /** Create a character-swapped starting frame Active subscription and daily quota required. */
     cloneStartingImage(body: ReqBody<"/v1/clones/starting-image", "post">): ReturnType<Client["POST"]>;
-    /** Clone source motion with Kling motion control or Seedance */
+    /** Clone source motion with Kling 3.0 Motion Control Active subscription and daily quota required. */
     cloneVideo(body: ReqBody<"/v1/clones/video", "post">): ReturnType<Client["POST"]>;
-    /** Poll a clone video task */
+    /** Poll a clone video task Bearer API key required. */
     getCloneVideo(id: string): ReturnType<Client["GET"]>;
-    /** Check prompt compliance */
+    /** Check prompt compliance Active subscription and daily quota required. */
     checkCompliancePrompt(body: ReqBody<"/v1/compliance/prompt", "post">): ReturnType<Client["POST"]>;
-    /** Check video compliance */
+    /** Check video compliance Active subscription and daily quota required. */
     checkComplianceVideo(body: ReqBody<"/v1/compliance/video", "post">): ReturnType<Client["POST"]>;
     /** Check checkout status Public endpoint. */
     getCheckoutStatus(query?: QueryParams<"/v1/credits/status", "get">): ReturnType<Client["GET"]>;
-    /** Burn fine-print disclaimer onto video */
+    /** Burn fine-print disclaimer onto video Active subscription and daily quota required. */
     createDisclaimer(body: ReqBody<"/v1/disclaimer", "post">): ReturnType<Client["POST"]>;
-    /** Inspect a distribution job Auth required. */
-    getDistributionJob(query?: QueryParams<"/v1/distribution/jobs", "get">): ReturnType<Client["GET"]>;
-    /** Extract from media Auth required. 5 credits. */
+    /** Extract from media Active subscription and daily quota required. */
     extractMedia(body: ReqBody<"/v1/extract", "post">): ReturnType<Client["POST"]>;
     /** API info Public endpoint. */
     getInfo(): ReturnType<Client["GET"]>;
-    /** Inspect a durable VidJutsu media job Auth required. */
-    getJob(query?: QueryParams<"/v1/jobs", "get">): ReturnType<Client["GET"]>;
-    /** Burn text overlay onto video Auth required. 5 credits. */
+    /** Burn text overlay onto video Active subscription and daily quota required. */
     createOverlay(body: ReqBody<"/v1/overlay", "post">): ReturnType<Client["POST"]>;
-    /** Create post Auth required. */
+    /** Create post Bearer API key required. */
     createPost(body: ReqBody<"/v1/posts", "post">): ReturnType<Client["POST"]>;
-    /** Update post Auth required. */
+    /** Update post Bearer API key required. */
     updatePost(body: ReqBody<"/v1/posts", "put">, query?: QueryParams<"/v1/posts", "put">): ReturnType<Client["PUT"]>;
-    /** List posts or get by ID Auth required. */
+    /** List posts or get by ID Bearer API key required. */
     listOrGetPosts(query?: QueryParams<"/v1/posts", "get">): ReturnType<Client["GET"]>;
-    /** Delete post Auth required. */
+    /** Delete post Bearer API key required. */
     deletePost(query?: QueryParams<"/v1/posts", "delete">): ReturnType<Client["DELETE"]>;
     /** Get pricing Public endpoint. */
     getPricing(): ReturnType<Client["GET"]>;
-    /** Create editor project */
+    /** Create editor project Bearer API key required. */
     createEditorProject(body: ReqBody<"/v1/projects", "post">): ReturnType<Client["POST"]>;
-    /** Update editor project */
+    /** Update editor project Bearer API key required. */
     updateEditorProject(body: ReqBody<"/v1/projects", "put">, query?: QueryParams<"/v1/projects", "put">): ReturnType<Client["PUT"]>;
-    /** List projects or get by ID */
+    /** List projects or get by ID Bearer API key required. */
     listOrGetEditorProjects(query?: QueryParams<"/v1/projects", "get">): ReturnType<Client["GET"]>;
-    /** Archive editor project (soft) */
+    /** Archive editor project (soft) Bearer API key required. */
     deleteEditorProject(query?: QueryParams<"/v1/projects", "delete">): ReturnType<Client["DELETE"]>;
-    /** Create reference Auth required. */
+    /** Create reference Bearer API key required. */
     createReference(body: ReqBody<"/v1/references", "post">): ReturnType<Client["POST"]>;
-    /** Update reference Auth required. */
+    /** Update reference Bearer API key required. */
     updateReference(body: ReqBody<"/v1/references", "put">, query?: QueryParams<"/v1/references", "put">): ReturnType<Client["PUT"]>;
-    /** List references or get by ID Auth required. */
+    /** List references or get by ID Bearer API key required. */
     listOrGetReferences(query?: QueryParams<"/v1/references", "get">): ReturnType<Client["GET"]>;
-    /** Delete reference Auth required. */
+    /** Delete reference Bearer API key required. */
     deleteReference(query?: QueryParams<"/v1/references", "delete">): ReturnType<Client["DELETE"]>;
-    /** Scrape Instagram post or reel Auth required. 1 credits. */
+    /** Scrape Instagram post or reel Active subscription and daily quota required. */
     scrapeInstagramPost(body: ReqBody<"/v1/scrape/instagram/post", "post">): ReturnType<Client["POST"]>;
-    /** Scrape Instagram post comments Auth required. 1 credits. */
+    /** Scrape Instagram post comments Active subscription and daily quota required. */
     scrapeInstagramPostComments(body: ReqBody<"/v1/scrape/instagram/post/comments", "post">): ReturnType<Client["POST"]>;
-    /** Scrape Instagram profile Auth required. 1 credits. */
+    /** Scrape Instagram profile Active subscription and daily quota required. */
     scrapeInstagramProfile(body: ReqBody<"/v1/scrape/instagram/profile", "post">): ReturnType<Client["POST"]>;
-    /** Scrape Instagram user posts Auth required. 1 credits. */
+    /** Scrape Instagram user posts Active subscription and daily quota required. */
     scrapeInstagramUserPosts(body: ReqBody<"/v1/scrape/instagram/user/posts", "post">): ReturnType<Client["POST"]>;
-    /** Scrape Instagram user reels Auth required. 1 credits. */
+    /** Scrape Instagram user reels Active subscription and daily quota required. */
     scrapeInstagramUserReels(body: ReqBody<"/v1/scrape/instagram/user/reels", "post">): ReturnType<Client["POST"]>;
-    /** Scrape TikTok profile Auth required. 1 credits. */
+    /** Scrape TikTok profile Active subscription and daily quota required. */
     scrapeTikTokProfile(body: ReqBody<"/v1/scrape/tiktok/profile", "post">): ReturnType<Client["POST"]>;
-    /** Scrape TikTok profile videos Auth required. 1 credits. */
+    /** Scrape TikTok profile videos Active subscription and daily quota required. */
     scrapeTikTokProfileVideos(body: ReqBody<"/v1/scrape/tiktok/profile/videos", "post">): ReturnType<Client["POST"]>;
-    /** Scrape TikTok user search Auth required. 1 credits. */
+    /** Scrape TikTok user search Active subscription and daily quota required. */
     scrapeTikTokSearchUsers(body: ReqBody<"/v1/scrape/tiktok/search/users", "post">): ReturnType<Client["POST"]>;
-    /** Scrape TikTok trending feed Auth required. 1 credits. */
+    /** Scrape TikTok trending feed Active subscription and daily quota required. */
     scrapeTikTokTrending(body: ReqBody<"/v1/scrape/tiktok/trending", "post">): ReturnType<Client["POST"]>;
-    /** Scrape TikTok video Auth required. 1 credits. */
+    /** Scrape TikTok video Active subscription and daily quota required. */
     scrapeTikTokVideo(body: ReqBody<"/v1/scrape/tiktok/video", "post">): ReturnType<Client["POST"]>;
-    /** Scrape TikTok video comments Auth required. 1 credits. */
+    /** Scrape TikTok video comments Active subscription and daily quota required. */
     scrapeTikTokVideoComments(body: ReqBody<"/v1/scrape/tiktok/video/comments", "post">): ReturnType<Client["POST"]>;
-    /** Scrape TikTok video transcript Auth required. 1 credits. */
+    /** Scrape TikTok video transcript Active subscription and daily quota required. */
     scrapeTikTokVideoTranscript(body: ReqBody<"/v1/scrape/tiktok/video/transcript", "post">): ReturnType<Client["POST"]>;
     /** Create subscription Public endpoint. */
     createSubscription(body: ReqBody<"/v1/subscribe", "post">): ReturnType<Client["POST"]>;
-    /** Transcribe media Auth required. 10 credits. */
+    /** Transcribe media Active subscription and daily quota required. */
     transcribeMedia(body: ReqBody<"/v1/transcribe", "post">): ReturnType<Client["POST"]>;
-    /** Upload file Auth required. */
-    uploadFile(): ReturnType<Client["POST"]>;
-    /** Upload from URL Auth required. */
+    /** Upload file Bearer API key required. */
+    uploadFile(body: Blob | ArrayBuffer | ReadableStream): ReturnType<Client["POST"]>;
+    /** Upload from URL Bearer API key required. */
     uploadFromUrl(body: ReqBody<"/v1/upload/url", "post">): ReturnType<Client["POST"]>;
-    /** Get daily usage */
+    /** Get daily usage Bearer API key required. */
     getUsage(): ReturnType<Client["GET"]>;
-    /** Add a video from an uploaded asset or direct MP4 URL Auth required. */
-    addVideo(body: ReqBody<"/v1/videos/add", "post">): ReturnType<Client["POST"]>;
-    /** Import an Instagram video into VidJutsu Auth required. 1 credits. */
+    /** Import an Instagram video into VidJutsu Active subscription and daily quota required. */
     downloadInstagramVideo(body: ReqBody<"/v1/videos/download/instagram", "post">): ReturnType<Client["POST"]>;
-    /** Import a TikTok video into VidJutsu Auth required. 1 credits. */
+    /** Import a TikTok video into VidJutsu Active subscription and daily quota required. */
     downloadTikTokVideo(body: ReqBody<"/v1/videos/download/tiktok", "post">): ReturnType<Client["POST"]>;
-    /** Watch media Auth required. 10 credits. */
+    /** Watch media Active subscription and daily quota required. */
     watchMedia(body: ReqBody<"/v1/watch", "post">): ReturnType<Client["POST"]>;
 }
 export declare function bindMethods(client: Client): VidJutsuMethods;

package/dist/methods.js

@@ -90,18 +90,12 @@ export function bindMethods(client) {
         createDisclaimer(body) {
             return client.POST("/v1/disclaimer", { body });
         },
-        getDistributionJob(query) {
-            return client.GET("/v1/distribution/jobs", { params: { query } });
-        },
         extractMedia(body) {
             return client.POST("/v1/extract", { body });
         },
         getInfo() {
             return client.GET("/v1/info", {});
         },
-        getJob(query) {
-            return client.GET("/v1/jobs", { params: { query } });
-        },
         createOverlay(body) {
             return client.POST("/v1/overlay", { body });
         },
@@ -186,8 +180,12 @@ export function bindMethods(client) {
         transcribeMedia(body) {
             return client.POST("/v1/transcribe", { body });
         },
-        uploadFile() {
-            return client.POST("/v1/upload", {});
+        uploadFile(body) {
+            return client.POST("/v1/upload", {
+                body: body,
+                bodySerializer: (b) => b,
+                headers: { "Content-Type": "application/octet-stream" },
+            });
         },
         uploadFromUrl(body) {
             return client.POST("/v1/upload/url", { body });
@@ -195,9 +193,6 @@ export function bindMethods(client) {
         getUsage() {
             return client.GET("/v1/usage", {});
         },
-        addVideo(body) {
-            return client.POST("/v1/videos/add", { body });
-        },
         downloadInstagramVideo(body) {
             return client.POST("/v1/videos/download/instagram", { body });
         },

package/install.sh

@@ -43,45 +43,6 @@ detect_platform() {
   info "Detected platform: ${BOLD}${PLATFORM}${RESET}"
 }
 
-# --- Prerequisites ---
-
-ensure_node() {
-  if command -v node >/dev/null 2>&1; then
-    success "Node.js $(node --version) found"
-    return
-  fi
-
-  error "Node.js is required. Install it from https://nodejs.org"
-}
-
-ensure_bun() {
-  if command -v bun >/dev/null 2>&1; then
-    success "Bun $(bun --version) found"
-    return
-  fi
-
-  info "Installing Bun..."
-  curl -fsSL https://bun.sh/install | bash
-  export BUN_INSTALL="$HOME/.bun"
-  export PATH="$BUN_INSTALL/bin:$PATH"
-  success "Bun installed: $(bun --version)"
-}
-
-ensure_typescript() {
-  if command -v tsc >/dev/null 2>&1; then
-    success "TypeScript $(tsc --version) found"
-    return
-  fi
-
-  info "Installing TypeScript globally..."
-  if command -v bun >/dev/null 2>&1; then
-    bun add -g typescript
-  elif command -v npm >/dev/null 2>&1; then
-    npm install -g typescript
-  fi
-  success "TypeScript installed"
-}
-
 # --- Version Detection ---
 
 get_version() {
@@ -180,9 +141,6 @@ main() {
   printf "\n${BOLD}  VidJutsu CLI Installer${RESET}\n\n"
 
   detect_platform
-  ensure_node
-  ensure_bun
-  ensure_typescript
   get_version
   install_binary
   verify
@@ -190,7 +148,7 @@ main() {
   printf "\n${GREEN}${BOLD}  ✓ VidJutsu CLI v${VERSION} installed successfully${RESET}\n"
   printf "\n  Get started:\n"
   printf "    ${CYAN}vidjutsu auth${RESET}       — authenticate your account\n"
-  printf "    ${CYAN}vidjutsu generate${RESET}   — generate AI video\n"
+  printf "    ${CYAN}vidjutsu clone --help${RESET} — clone a staged short video\n"
   printf "    ${CYAN}vidjutsu --help${RESET}     — see all commands\n\n"
 }
 

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "vidjutsu",
-  "version": "1.3.0",
+  "version": "1.4.0",
   "description": "VidJutsu — video intelligence API. SDK + CLI.",
   "type": "module",
   "main": "./dist/index.js",
@@ -20,6 +20,8 @@
   ],
   "scripts": {
     "generate": "bun scripts/generate-schema.ts && bun scripts/generate-methods.ts",
+    "test": "bun test",
+    "check:release": "bun scripts/check-release.ts",
     "build": "bun run build:sdk && bun run build:cli",
     "build:sdk": "tsc",
     "build:cli": "bun build src/cli/index.ts --outfile dist/cli/index.mjs --target node",
@@ -29,7 +31,7 @@
     "build:binary:linux-x64": "bun build src/cli/index.ts --compile --target=bun-linux-x64 --outfile dist/vidjutsu-linux-x64",
     "build:binary:linux-arm64": "bun build src/cli/index.ts --compile --target=bun-linux-arm64 --outfile dist/vidjutsu-linux-arm64",
     "dev": "bun run src/cli/index.ts",
-    "prepublishOnly": "bun run generate && bun run build"
+    "prepublishOnly": "bun run generate && bun run check:release && bun test && bun run build"
   },
   "dependencies": {
     "citty": "^0.1",

package/dist/distribution.d.ts

@@ -1,23 +0,0 @@
-import type createFetchClient from "openapi-fetch";
-import type { components, paths } from "./schema.js";
-type FetchClient = ReturnType<typeof createFetchClient<paths>>;
-type Job = components["schemas"]["DistributionJob"];
-type AddVideoRequest = components["schemas"]["AddVideoRequest"];
-export interface MutationOptions {
-    idempotencyKey?: string;
-}
-export interface WaitOptions {
-    timeoutMs?: number;
-    pollIntervalMs?: number;
-}
-export interface DistributionNamespaces {
-    videos: {
-        add(body: AddVideoRequest, options?: MutationOptions): Promise<Job>;
-    };
-    jobs: {
-        get(jobId: string): Promise<Job>;
-        waitForResult(jobId: string, options?: WaitOptions): Promise<Job>;
-    };
-}
-export declare function bindDistribution(client: FetchClient): DistributionNamespaces;
-export {};

package/dist/distribution.js

@@ -1,56 +0,0 @@
-export function bindDistribution(client) {
-    const jobs = {
-        async get(jobId) {
-            const result = await client.GET("/v1/distribution/jobs", {
-                params: { query: { id: jobId } },
-            });
-            return requireData(result, "get distribution job");
-        },
-        async waitForResult(jobId, options = {}) {
-            const timeoutMs = options.timeoutMs ?? 10 * 60_000;
-            const pollIntervalMs = options.pollIntervalMs ?? 1_000;
-            const deadline = Date.now() + timeoutMs;
-            while (true) {
-                const job = await jobs.get(jobId);
-                if (job.status === "completed")
-                    return job;
-                if (job.status === "failed" || job.status === "cancelled") {
-                    throw new Error(job.error?.message ?? `Distribution job ${job.status}`);
-                }
-                if (Date.now() >= deadline)
-                    throw new Error(`Timed out waiting for distribution job ${jobId}`);
-                await new Promise((resolve) => setTimeout(resolve, pollIntervalMs));
-            }
-        },
-    };
-    return {
-        videos: {
-            async add(body, options) {
-                const result = await client.POST("/v1/videos/add", {
-                    body,
-                    params: { header: idempotencyHeader(options) },
-                });
-                return requireData(result, "add video");
-            },
-        },
-        jobs,
-    };
-}
-function idempotencyHeader(options) {
-    return options?.idempotencyKey ? { "Idempotency-Key": options.idempotencyKey } : {};
-}
-function requireData(result, operation) {
-    if (result.data !== undefined)
-        return result.data;
-    const message = extractErrorMessage(result.error) ?? `Vidjutsu failed to ${operation} (HTTP ${result.response.status})`;
-    throw new Error(message);
-}
-function extractErrorMessage(error) {
-    if (!error || typeof error !== "object")
-        return undefined;
-    if ("message" in error && typeof error.message === "string")
-        return error.message;
-    if ("error" in error && typeof error.error === "string")
-        return error.error;
-    return undefined;
-}

package/dist/jobs.d.ts

@@ -1,14 +0,0 @@
-import type createFetchClient from "openapi-fetch";
-import type { components, paths } from "./schema.js";
-import type { WaitOptions } from "./distribution.js";
-type FetchClient = ReturnType<typeof createFetchClient<paths>>;
-type MediaJob = components["schemas"]["MediaJob"];
-export interface JobsNamespaces {
-    mediaJobs: {
-        get(jobId: string): Promise<MediaJob>;
-        awaitJob(jobId: string, options?: WaitOptions): Promise<MediaJob>;
-    };
-    awaitJob(jobId: string, options?: WaitOptions): Promise<MediaJob>;
-}
-export declare function bindJobs(client: FetchClient): JobsNamespaces;
-export {};

package/dist/jobs.js

@@ -1,50 +0,0 @@
-export function bindJobs(client) {
-    const mediaJobs = {
-        async get(jobId) {
-            const result = await client.GET("/v1/jobs", {
-                params: { query: { id: jobId } },
-            });
-            return requireData(result, "get media job");
-        },
-        async awaitJob(jobId, options = {}) {
-            const timeoutMs = options.timeoutMs ?? 10 * 60_000;
-            const pollIntervalMs = options.pollIntervalMs ?? 1_000;
-            if (timeoutMs <= 0 || pollIntervalMs <= 0) {
-                throw new Error("timeoutMs and pollIntervalMs must be positive");
-            }
-            const deadline = Date.now() + timeoutMs;
-            while (true) {
-                const job = await mediaJobs.get(jobId);
-                if (job.status === "completed")
-                    return job;
-                if (job.status === "failed" || job.status === "cancelled") {
-                    throw new Error(job.error?.message ?? `Media job ${job.status}`);
-                }
-                if (Date.now() >= deadline) {
-                    throw new Error(`Timed out waiting for media job ${jobId}`);
-                }
-                await new Promise((resolve) => setTimeout(resolve, pollIntervalMs));
-            }
-        },
-    };
-    return {
-        mediaJobs,
-        awaitJob: mediaJobs.awaitJob,
-    };
-}
-function requireData(result, operation) {
-    if (result.data !== undefined)
-        return result.data;
-    const message = extractErrorMessage(result.error) ??
-        `VidJutsu failed to ${operation} (HTTP ${result.response.status})`;
-    throw new Error(message);
-}
-function extractErrorMessage(error) {
-    if (!error || typeof error !== "object")
-        return undefined;
-    if ("message" in error && typeof error.message === "string")
-        return error.message;
-    if ("error" in error && typeof error.error === "string")
-        return error.error;
-    return undefined;
-}