@clipit-ai/cli 0.2.6 → 0.2.7

package/bin/clipit.mjs

@@ -9,7 +9,7 @@ import path from 'node:path';
 import process from 'node:process';
 import { fileURLToPath } from 'node:url';
 
-const VERSION = '0.2.6';
+const VERSION = '0.2.7';
 const DEFAULT_BASE_URL = 'https://clipit.dev';
 const DEFAULT_SCOPES = [
   'clippy_agent',
@@ -466,7 +466,7 @@ function usage() {
     '  clipit mcp [stdio]',
     '  clipit run <functionName> [--params @file.json] [--clip-id id] [--video-id id] [--confirm] [--max-credits n]',
     '  clipit videos list|get|upload|abort-upload|import-url|transcribe|transcript|suggest-clips|delete ...',
-    '  clipit clips list|get|delivery-state|create|update|render|download|delete ...',
+    '  clipit clips list|get|delivery-state|create|update|initialize-snapshot|render|download|delete ...',
     '  clipit jobs get|wait <jobId>',
     '  clipit credits balance|usage|estimate ...',
     '  clipit billing capabilities|catalog|create-attempt|attempt|receipt|subscription ...',
@@ -1251,6 +1251,13 @@ async function enforceRunMaxCredits(config, options, functionName, parameters =
   const isMetered = Boolean(tool?.costBand && tool.costBand !== 'free');
   const isMeteredExempt = RUN_METERED_CONFIRMATION_EXEMPTIONS.has(functionName);
 
+  if (tool?.costBand === 'free') {
+    if (tool?.confirmation?.required) {
+      requireConfirm(options, `Running confirmation-gated tool ${functionName}`);
+    }
+    return null;
+  }
+
   let staticEstimates = null;
   if (!runEstimate && (limit !== null || needsConfirmationPreflight)) {
     staticEstimates = await buildStaticRunEstimates(config, options, functionName, parameters, payload);
@@ -2718,6 +2725,12 @@ async function clips(config, options, action, args) {
   }
   if (action === 'update') {
     if (!args[0]) throw Object.assign(new Error('Clip id is required.'), { exitCode: EXIT.USAGE });
+    if (options.aspect !== undefined || options['aspect-ratio'] !== undefined) {
+      throw Object.assign(
+        new Error('clips update does not accept --aspect-ratio. Use clipit run setClipAspectRatio --clip-id <id> --params \'{"aspectRatio":"4:5"}\', then start an explicit render.'),
+        { exitCode: EXIT.USAGE },
+      );
+    }
     const body = options.params
       ? await readJsonOption(String(options.params))
       : {
@@ -2732,6 +2745,26 @@ async function clips(config, options, action, args) {
     output(await apiFetch(config, options, 'PATCH', `/api/v1/clips/${encodeURIComponent(args[0])}`, body), options);
     return;
   }
+  if (action === 'initialize-snapshot') {
+    if (!args[0]) throw Object.assign(new Error('Clip id is required.'), { exitCode: EXIT.USAGE });
+    const body = options.params
+      ? await readJsonOption(String(options.params))
+      : compactObject({
+          aspectRatio: options.aspect || options['aspect-ratio'],
+          fitBackground: options['fit-background'],
+          quality: options.quality,
+          includeCaptions: options.captions === undefined ? undefined : boolOption(options.captions),
+          captionStyle: options['caption-style'],
+        });
+    output(await apiFetch(
+      config,
+      options,
+      'POST',
+      `/api/v1/clips/${encodeURIComponent(args[0])}/editor-snapshot/initialize`,
+      body,
+    ), options);
+    return;
+  }
   if (action === 'render') {
     if (!args[0]) throw Object.assign(new Error('Clip id is required.'), { exitCode: EXIT.USAGE });
     const body = options.params

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@clipit-ai/cli",
-  "version": "0.2.6",
+  "version": "0.2.7",
   "description": "ClipIt CLI for connecting shell-capable agents to ClipIt.",
   "type": "module",
   "bin": {