blitzreels 0.1.3 → 0.1.4

package/README.md

@@ -14,6 +14,10 @@ package for users who prefer scoped installs.
 After the first real publish:
 
 ```bash
+npx blitzreels version
+npx blitzreels doctor
+npx blitzreels prime
+npx blitzreels agent-context --json
 npx blitzreels auth login
 ```
 
@@ -70,6 +74,14 @@ blitzreels media folders rename --folder-id FOLDER_ID --name "New folder name"
 blitzreels media folders update --folder-id FOLDER_ID --parent-folder-id root
 blitzreels media folders delete --folder-id FOLDER_ID --confirm-delete
 
+blitzreels clips create --source-type youtube --youtube-url "https://www.youtube.com/watch?v=..." --name "MKBHD hero loop" --min-duration 8 --max-duration 12 --qa-mode permissive
+blitzreels clips create --source-type asset --asset-id ASSET_ID --selection-mode time_range --start-seconds 52 --end-seconds 64 --max-duration 12
+blitzreels clips get --clip-id CLIP_ID --json
+blitzreels clips wait --clip-id CLIP_ID --json
+blitzreels clips reselect --clip-id CLIP_ID --selection-mode time_range --start-seconds 52 --end-seconds 64 --min-duration 8 --max-duration 12
+blitzreels clips repair --clip-id CLIP_ID --repair-mode auto
+blitzreels clips export --clip-id CLIP_ID --resolution 1080p --format mp4 --allow-blocking-qa-bypass false
+
 blitzreels project inspect --project-id PROJECT_ID --json
 blitzreels project timeline --project-id PROJECT_ID --json
 blitzreels project snapshot --project-id PROJECT_ID --at 00:03
@@ -79,12 +91,19 @@ blitzreels timeline transform --project-id PROJECT_ID --timeline-item-id TIMELIN
 blitzreels timeline move --project-id PROJECT_ID --timeline-item-id TIMELINE_ITEM_ID --at 00:06 --layer-index 2
 blitzreels timeline delete --project-id PROJECT_ID --timeline-item-id TIMELINE_ITEM_ID --auto-pack false
 
+blitzreels effects zoom add --project-id PROJECT_ID --at 9.8 --duration 1.8 --scale-start 1 --scale-end 1.1 --easing easeInOut
+blitzreels effects zoom update --project-id PROJECT_ID --timeline-item-id EFFECT_TIMELINE_ITEM_ID --scale-end 1.1 --easing easeInOut --duration 1.8
+blitzreels effects mask add --project-id PROJECT_ID --settings-json '{"shape":"rounded","size":{"width":0.8,"height":0.8}}'
+blitzreels effects colorgrade update --project-id PROJECT_ID --timeline-item-id EFFECT_TIMELINE_ITEM_ID --settings-json '{"brightness":1.1,"vignetteEnabled":true}'
+
 blitzreels text add --project-id PROJECT_ID --text "Hook" --at 0 --duration 4
 blitzreels text add --project-id PROJECT_ID --text "SERVEURS MCP" --at 24.33 --duration 2.8 --font-family Pacifico --font-size 82 --color "#17FFA6" --background-color "rgba(3,7,18,0.82)" --top "24%"
 blitzreels text list --project-id PROJECT_ID --json
 blitzreels text update --project-id PROJECT_ID --content-item-id CONTENT_ITEM_ID --text "New hook" --font-family Inter --font-size 64 --color "#FFFFFF"
 blitzreels text remove --project-id PROJECT_ID --content-item-id CONTENT_ITEM_ID
 
+blitzreels audio search --query "ambient riser" --license cc0 --json
+blitzreels audio import --provider openverse --external-id AUDIO_ID --project-id PROJECT_ID --at 0 --duration 12 --volume 0.5
 blitzreels audio add --project-id PROJECT_ID --asset-id ASSET_ID --at 0 --volume 0.6
 
 blitzreels captions words list --project-id PROJECT_ID --match-text "Supabase" --json
@@ -115,6 +134,48 @@ blitzreels api spec
 ```
 
 Use `--json` for script and AI-agent workflows.
+Use `--fields id,name` with `--json` to trim large responses.
+
+## Agent Workflows
+
+```bash
+blitzreels prime
+blitzreels prime --command "media attach"
+blitzreels agent-context --json
+blitzreels agent-context --command "media attach" --json
+blitzreels schema --command "captions words style" --json
+blitzreels media attach --project-id PROJECT_ID --asset-id ASSET_ID --at 6 --dry-run
+```
+
+`prime` prints plain-language instructions that coding agents should read before
+editing BlitzReels projects. It is inspired by agent-first CLIs like Beans'
+`prime` command. `llms` is an alias.
+
+`agent-context` is the machine-readable command contract for agents. It includes
+command metadata, typed flags, examples, read/write markers, destructive markers,
+and known error categories.
+
+When the CLI detects an agent environment, command help also points agents to
+`prime` and `agent-context` for the focused command.
+
+`--dry-run` is available on mutating commands and prints the API request that
+would be made without making the write request. Destructive dry-runs still require
+the same explicit confirmation flags as real destructive commands.
+
+## Updates
+
+The CLI checks `https://www.blitzreels.com/api/cli/releases` at most once per
+day and prints a short update notice to stderr when a newer version is
+available. The notice is skipped for `--json`, CI, non-interactive shells, and
+commands where it would be noisy.
+
+```bash
+blitzreels version
+blitzreels doctor
+npm i -g blitzreels@latest
+```
+
+Set `BLITZREELS_NO_UPDATE_NOTIFIER=1` to disable passive update notices.
 
 ## Faulty Commands
 

package/dist/cli-runtime.d.ts

@@ -0,0 +1,25 @@
+import { BlitzReelsClient } from "@blitzreels/sdk";
+import type { Flags, StoredConfig } from "./cli-types.js";
+export declare const CLI_VERSION = "0.1.4";
+export declare const DEFAULT_BASE_URL = "https://www.blitzreels.com/api/v1";
+export declare const CONFIG_PATH: string;
+export declare function loadConfig(): Promise<StoredConfig>;
+export declare function resolveRuntimeConfig({ flags, storedConfig, }: {
+    flags: Flags;
+    storedConfig: StoredConfig;
+}): StoredConfig;
+export declare function createCliClient({ config, }: {
+    config: StoredConfig;
+}): BlitzReelsClient;
+export declare function storeApiKey({ apiKey, baseUrl, }: {
+    apiKey: string;
+    baseUrl: string | undefined;
+}): Promise<{
+    configPath: string;
+    keyStorage: StoredConfig["keyStorage"];
+}>;
+export declare function persistLoggedInApiKey({ apiKey, baseUrl, }: {
+    apiKey: string;
+    baseUrl: string | undefined;
+}): Promise<void>;
+//# sourceMappingURL=cli-runtime.d.ts.map

package/dist/cli-runtime.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"cli-runtime.d.ts","sourceRoot":"","sources":["../src/cli-runtime.ts"],"names":[],"mappings":"AAIA,OAAO,EAAE,gBAAgB,EAA+B,MAAM,iBAAiB,CAAC;AAChF,OAAO,KAAK,EAAE,KAAK,EAAE,YAAY,EAAE,MAAM,gBAAgB,CAAC;AAE1D,eAAO,MAAM,WAAW,UAAU,CAAC;AACnC,eAAO,MAAM,gBAAgB,sCAAsC,CAAC;AACpE,eAAO,MAAM,WAAW,QAAgD,CAAC;AAKzE,wBAAsB,UAAU,IAAI,OAAO,CAAC,YAAY,CAAC,CAiBxD;AAED,wBAAgB,oBAAoB,CAAC,EACnC,KAAK,EACL,YAAY,GACb,EAAE;IACD,KAAK,EAAE,KAAK,CAAC;IACb,YAAY,EAAE,YAAY,CAAC;CAC5B,GAAG,YAAY,CAYf;AAED,wBAAgB,eAAe,CAAC,EAC9B,MAAM,GACP,EAAE;IACD,MAAM,EAAE,YAAY,CAAC;CACtB,GAAG,gBAAgB,CAQnB;AAED,wBAAsB,WAAW,CAAC,EAChC,MAAM,EACN,OAAO,GACR,EAAE;IACD,MAAM,EAAE,MAAM,CAAC;IACf,OAAO,EAAE,MAAM,GAAG,SAAS,CAAC;CAC7B,GAAG,OAAO,CAAC;IAAE,UAAU,EAAE,MAAM,CAAC;IAAC,UAAU,EAAE,YAAY,CAAC,YAAY,CAAC,CAAA;CAAE,CAAC,CAW1E;AAED,wBAAsB,qBAAqB,CAAC,EAC1C,MAAM,EACN,OAAO,GACR,EAAE;IACD,MAAM,EAAE,MAAM,CAAC;IACf,OAAO,EAAE,MAAM,GAAG,SAAS,CAAC;CAC7B,GAAG,OAAO,CAAC,IAAI,CAAC,CAEhB"}

package/dist/cli-runtime.js

@@ -0,0 +1,125 @@
+import { spawn } from "node:child_process";
+import { mkdir, readFile, writeFile } from "node:fs/promises";
+import { homedir } from "node:os";
+import { dirname, join } from "node:path";
+import { BlitzReelsClient } from "@blitzreels/sdk";
+export const CLI_VERSION = "0.1.4";
+export const DEFAULT_BASE_URL = "https://www.blitzreels.com/api/v1";
+export const CONFIG_PATH = join(homedir(), ".blitzreels", "config.json");
+const KEYCHAIN_SERVICE = "BlitzReels CLI";
+const KEYCHAIN_ACCOUNT = "api-key";
+export async function loadConfig() {
+    try {
+        const raw = await readFile(CONFIG_PATH, "utf8");
+        const value = JSON.parse(raw);
+        const keyStorage = value.keyStorage === "keychain" ? "keychain" : "config";
+        const keychainApiKey = keyStorage === "keychain" ? await readKeychainApiKey() : "";
+        return {
+            apiKey: keychainApiKey ||
+                (typeof value.apiKey === "string" ? value.apiKey : ""),
+            baseUrl: typeof value.baseUrl === "string" ? value.baseUrl : undefined,
+            keyStorage,
+        };
+    }
+    catch {
+        return { apiKey: "", baseUrl: undefined, keyStorage: undefined };
+    }
+}
+export function resolveRuntimeConfig({ flags, storedConfig, }) {
+    return {
+        apiKey: getStringFlag({ flags, name: "api-key" }) ??
+            process.env.BLITZREELS_API_KEY ??
+            storedConfig.apiKey,
+        baseUrl: getStringFlag({ flags, name: "base-url" }) ??
+            process.env.BLITZREELS_BASE_URL ??
+            storedConfig.baseUrl,
+        keyStorage: storedConfig.keyStorage,
+    };
+}
+export function createCliClient({ config, }) {
+    const clientConfig = {
+        apiKey: config.apiKey,
+        baseUrl: config.baseUrl,
+        fetchFn: undefined,
+        userAgent: `blitzreels-cli/${CLI_VERSION}`,
+    };
+    return new BlitzReelsClient(clientConfig);
+}
+export async function storeApiKey({ apiKey, baseUrl, }) {
+    const savedToKeychain = await saveApiKey({ apiKey });
+    const keyStorage = savedToKeychain ? "keychain" : "config";
+    await writeConfig({
+        config: {
+            apiKey: savedToKeychain ? "" : apiKey,
+            baseUrl,
+            keyStorage,
+        },
+    });
+    return { configPath: CONFIG_PATH, keyStorage };
+}
+export async function persistLoggedInApiKey({ apiKey, baseUrl, }) {
+    await storeApiKey({ apiKey, baseUrl });
+}
+function getStringFlag({ flags, name, }) {
+    const value = flags[name];
+    return typeof value === "string" ? value : undefined;
+}
+async function writeConfig({ config, }) {
+    await mkdir(dirname(CONFIG_PATH), { recursive: true });
+    await writeFile(CONFIG_PATH, JSON.stringify(config, null, 2), {
+        mode: 0o600,
+    });
+}
+function canUseKeychain() {
+    return (process.platform === "darwin" &&
+        process.env.BLITZREELS_DISABLE_KEYCHAIN !== "1");
+}
+function runSecurity({ args, }) {
+    return new Promise((resolveCommand) => {
+        const child = spawn("security", args, {
+            stdio: ["ignore", "pipe", "ignore"],
+        });
+        const chunks = [];
+        child.stdout.on("data", (chunk) => chunks.push(Buffer.from(chunk)));
+        child.on("error", () => resolveCommand({ stdout: "", ok: false }));
+        child.on("close", (code) => resolveCommand({
+            stdout: Buffer.concat(chunks).toString("utf8").trim(),
+            ok: code === 0,
+        }));
+    });
+}
+async function saveApiKey({ apiKey }) {
+    if (!canUseKeychain()) {
+        return false;
+    }
+    const result = await runSecurity({
+        args: [
+            "add-generic-password",
+            "-a",
+            KEYCHAIN_ACCOUNT,
+            "-s",
+            KEYCHAIN_SERVICE,
+            "-w",
+            apiKey,
+            "-U",
+        ],
+    });
+    return result.ok;
+}
+async function readKeychainApiKey() {
+    if (!canUseKeychain()) {
+        return "";
+    }
+    const result = await runSecurity({
+        args: [
+            "find-generic-password",
+            "-a",
+            KEYCHAIN_ACCOUNT,
+            "-s",
+            KEYCHAIN_SERVICE,
+            "-w",
+        ],
+    });
+    return result.ok ? result.stdout : "";
+}
+//# sourceMappingURL=cli-runtime.js.map

package/dist/cli-runtime.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"cli-runtime.js","sourceRoot":"","sources":["../src/cli-runtime.ts"],"names":[],"mappings":"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"}

package/dist/cli-types.d.ts

@@ -0,0 +1,20 @@
+import type { BlitzReelsClient } from "@blitzreels/sdk";
+export type Flags = Record<string, string | boolean>;
+export type ParsedArgs = {
+    command: string[];
+    flags: Flags;
+};
+export type StoredConfig = {
+    apiKey: string;
+    baseUrl: string | undefined;
+    keyStorage: "config" | "keychain" | undefined;
+};
+export type CliContext = {
+    args: ParsedArgs;
+    json: boolean;
+    dryRun: boolean;
+    fields: string[] | undefined;
+    client: BlitzReelsClient;
+    config: StoredConfig;
+};
+//# sourceMappingURL=cli-types.d.ts.map

package/dist/cli-types.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"cli-types.d.ts","sourceRoot":"","sources":["../src/cli-types.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,gBAAgB,EAAE,MAAM,iBAAiB,CAAC;AAExD,MAAM,MAAM,KAAK,GAAG,MAAM,CAAC,MAAM,EAAE,MAAM,GAAG,OAAO,CAAC,CAAC;AAErD,MAAM,MAAM,UAAU,GAAG;IACvB,OAAO,EAAE,MAAM,EAAE,CAAC;IAClB,KAAK,EAAE,KAAK,CAAC;CACd,CAAC;AAEF,MAAM,MAAM,YAAY,GAAG;IACzB,MAAM,EAAE,MAAM,CAAC;IACf,OAAO,EAAE,MAAM,GAAG,SAAS,CAAC;IAC5B,UAAU,EAAE,QAAQ,GAAG,UAAU,GAAG,SAAS,CAAC;CAC/C,CAAC;AAEF,MAAM,MAAM,UAAU,GAAG;IACvB,IAAI,EAAE,UAAU,CAAC;IACjB,IAAI,EAAE,OAAO,CAAC;IACd,MAAM,EAAE,OAAO,CAAC;IAChB,MAAM,EAAE,MAAM,EAAE,GAAG,SAAS,CAAC;IAC7B,MAAM,EAAE,gBAAgB,CAAC;IACzB,MAAM,EAAE,YAAY,CAAC;CACtB,CAAC"}

package/dist/cli-types.js

@@ -0,0 +1,2 @@
+export {};
+//# sourceMappingURL=cli-types.js.map

package/dist/cli-types.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"cli-types.js","sourceRoot":"","sources":["../src/cli-types.ts"],"names":[],"mappings":""}

package/dist/command-metadata.d.ts

@@ -0,0 +1,54 @@
+export type CommandSpec = {
+    command: string[];
+    usage: string;
+    description: string;
+    flags: readonly FlagSpec[];
+    examples: readonly string[];
+    mutates: boolean;
+    destructive: boolean;
+    requiresAuth: boolean;
+    dryRunSupported: boolean;
+};
+export type FlagType = "string" | "number" | "boolean" | "json" | "csv" | "time";
+export type FlagSpec = {
+    name: string;
+    type: FlagType;
+    required: boolean;
+    default: string | number | boolean | null | undefined;
+    enum: readonly string[] | undefined;
+    description: string;
+};
+export type FlagInput = string | (Partial<FlagSpec> & {
+    name: string;
+});
+export declare const GLOBAL_FLAGS: readonly ["api-key", "base-url", "json", "help", "dry-run", "fields"];
+export declare const TEXT_STYLE_FLAGS: readonly ["spec-json", "font-family", "font-size", "font-weight", "color", "background-color", "padding-x", "padding-y", "border-radius", "top", "left", "text-align", "text-shadow", "no-background"];
+export declare const CAPTION_WORD_SELECTOR_FLAGS: readonly ["word-id", "word-ids", "timeline-item-id", "match-text", "match-pattern", "all", "from", "to"];
+export declare const CAPTION_WORD_STYLE_FLAGS: readonly ["style-json", "font-family", "font-weight", "font-style", "color", "active-color", "background-color", "active-animation", "text-transform", "text-shadow", "glow-color", "glow-blur-px", "scale", "offset-x", "offset-y", "rotation-deg", "letter-spacing", "opacity", "clear-existing"];
+export declare function commandSpec({ command, usage, flags, description, examples, mutates, destructive, requiresAuth, dryRunSupported, }: {
+    command: string[];
+    usage: string;
+    flags?: readonly FlagInput[];
+    description?: string;
+    examples?: readonly string[];
+    mutates?: boolean;
+    destructive?: boolean;
+    requiresAuth?: boolean;
+    dryRunSupported?: boolean;
+}): CommandSpec;
+export declare function commandLabel({ command }: {
+    command: string[];
+}): string;
+export declare function commandsEqual(left: string[], right: string[]): boolean;
+export declare function flagsForCommand({ spec }: {
+    spec: CommandSpec;
+}): FlagSpec[];
+export declare function suggestCommandSpecs({ command, specs, }: {
+    command: string[];
+    specs: CommandSpec[];
+}): CommandSpec[];
+export declare function suggestValues({ value, candidates, }: {
+    value: string;
+    candidates: string[];
+}): string[];
+//# sourceMappingURL=command-metadata.d.ts.map

package/dist/command-metadata.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"command-metadata.d.ts","sourceRoot":"","sources":["../src/command-metadata.ts"],"names":[],"mappings":"AAAA,MAAM,MAAM,WAAW,GAAG;IACxB,OAAO,EAAE,MAAM,EAAE,CAAC;IAClB,KAAK,EAAE,MAAM,CAAC;IACd,WAAW,EAAE,MAAM,CAAC;IACpB,KAAK,EAAE,SAAS,QAAQ,EAAE,CAAC;IAC3B,QAAQ,EAAE,SAAS,MAAM,EAAE,CAAC;IAC5B,OAAO,EAAE,OAAO,CAAC;IACjB,WAAW,EAAE,OAAO,CAAC;IACrB,YAAY,EAAE,OAAO,CAAC;IACtB,eAAe,EAAE,OAAO,CAAC;CAC1B,CAAC;AAEF,MAAM,MAAM,QAAQ,GAChB,QAAQ,GACR,QAAQ,GACR,SAAS,GACT,MAAM,GACN,KAAK,GACL,MAAM,CAAC;AAEX,MAAM,MAAM,QAAQ,GAAG;IACrB,IAAI,EAAE,MAAM,CAAC;IACb,IAAI,EAAE,QAAQ,CAAC;IACf,QAAQ,EAAE,OAAO,CAAC;IAClB,OAAO,EAAE,MAAM,GAAG,MAAM,GAAG,OAAO,GAAG,IAAI,GAAG,SAAS,CAAC;IACtD,IAAI,EAAE,SAAS,MAAM,EAAE,GAAG,SAAS,CAAC;IACpC,WAAW,EAAE,MAAM,CAAC;CACrB,CAAC;AAEF,MAAM,MAAM,SAAS,GAAG,MAAM,GAAG,CAAC,OAAO,CAAC,QAAQ,CAAC,GAAG;IAAE,IAAI,EAAE,MAAM,CAAA;CAAE,CAAC,CAAC;AAExE,eAAO,MAAM,YAAY,uEAOf,CAAC;AAEX,eAAO,MAAM,gBAAgB,wMAenB,CAAC;AAEX,eAAO,MAAM,2BAA2B,0GAS9B,CAAC;AAEX,eAAO,MAAM,wBAAwB,qSAoB3B,CAAC;AAEX,wBAAgB,WAAW,CAAC,EAC1B,OAAO,EACP,KAAK,EACL,KAAU,EACV,WAAW,EACX,QAAQ,EACR,OAAO,EACP,WAAW,EACX,YAAY,EACZ,eAAe,GAChB,EAAE;IACD,OAAO,EAAE,MAAM,EAAE,CAAC;IAClB,KAAK,EAAE,MAAM,CAAC;IACd,KAAK,CAAC,EAAE,SAAS,SAAS,EAAE,CAAC;IAC7B,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,QAAQ,CAAC,EAAE,SAAS,MAAM,EAAE,CAAC;IAC7B,OAAO,CAAC,EAAE,OAAO,CAAC;IAClB,WAAW,CAAC,EAAE,OAAO,CAAC;IACtB,YAAY,CAAC,EAAE,OAAO,CAAC;IACvB,eAAe,CAAC,EAAE,OAAO,CAAC;CAC3B,GAAG,WAAW,CAed;AAED,wBAAgB,YAAY,CAAC,EAAE,OAAO,EAAE,EAAE;IAAE,OAAO,EAAE,MAAM,EAAE,CAAA;CAAE,GAAG,MAAM,CAEvE;AAED,wBAAgB,aAAa,CAAC,IAAI,EAAE,MAAM,EAAE,EAAE,KAAK,EAAE,MAAM,EAAE,GAAG,OAAO,CAKtE;AAED,wBAAgB,eAAe,CAAC,EAAE,IAAI,EAAE,EAAE;IAAE,IAAI,EAAE,WAAW,CAAA;CAAE,GAAG,QAAQ,EAAE,CAgB3E;AAED,wBAAgB,mBAAmB,CAAC,EAClC,OAAO,EACP,KAAK,GACN,EAAE;IACD,OAAO,EAAE,MAAM,EAAE,CAAC;IAClB,KAAK,EAAE,WAAW,EAAE,CAAC;CACtB,GAAG,WAAW,EAAE,CAqBhB;AAED,wBAAgB,aAAa,CAAC,EAC5B,KAAK,EACL,UAAU,GACX,EAAE;IACD,KAAK,EAAE,MAAM,CAAC;IACd,UAAU,EAAE,MAAM,EAAE,CAAC;CACtB,GAAG,MAAM,EAAE,CAUX"}