blitzreels 0.1.11 → 0.1.13

package/README.md

@@ -4,6 +4,10 @@ Command-line video editing control surface for BlitzReels.
 
 Official website: https://blitzreels.com/
 
+Official npm package: https://www.npmjs.com/package/blitzreels
+
+Machine-readable CLI guide: https://blitzreels.com/cli.md
+
 This CLI is designed for AI agents to edit videos inside BlitzReels.
 
 This is the primary CLI package. The scoped package `@blitzreels/cli` wraps this
@@ -11,6 +15,17 @@ package for users who prefer scoped installs.
 
 ## Install
 
+Global install:
+
+```bash
+npm install --global blitzreels
+blitzreels version
+blitzreels doctor
+blitzreels agent-context --json
+```
+
+Run without installing:
+
 ```bash
 npx blitzreels version
 npx blitzreels doctor
@@ -137,10 +152,23 @@ blitzreels recording-sets get --recording-set-id SET_ID --json
 blitzreels recording-sets delete --recording-set-id EMPTY_SET_ID --confirm-delete \
   --idempotency-key recording-set:delete:v1
 blitzreels recording-sets clips create --recording-set-id SET_ID --max-clip-count 5 \
+  --max-duration 60 \
   --layout-mode prefer_focus --content-type-hint podcast --caption-theme-id hormozi \
   --studio-sound \
   --idempotency-key recording-set:clips:v1
 
+# `clips get|list --json` exposes `layout.segments` with time ranges, panel assets,
+# crops, canvas geometry, and split-only caption placement.
+
+blitzreels characters create --name "Virgile" \
+  --reference-asset-ids CHARACTER_SHEET_ASSET_ID \
+  --primary-reference-asset-id CHARACTER_SHEET_ASSET_ID \
+  --idempotency-key character:virgile:v1
+blitzreels characters list --json
+blitzreels faceless plans create --project-id PROJECT_ID --script-file ./script.txt \
+  --character-ids CHARACTER_ID --video-model seedance-2.0-ref2v \
+  --idempotency-key faceless:PROJECT_ID:v1
+
 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
@@ -302,8 +330,8 @@ auth.
 ## Source, releases, and license
 
 The npm package is publicly installable, but its canonical source is private and proprietary.
-Workspace `0.1.11` adds large-media upload recovery, media download and verification, Recording Set discovery,
-share-download controls, and simple-clip Studio Sound.
+Workspace `0.1.13` adds official package discovery metadata and explicit global installation guidance.
+It includes the `0.1.12` reusable character commands and faceless-generation character selection.
 
 Admin recovery and other internal operator commands are not part of the public CLI artifact.
 

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

@@ -1 +1 @@
-{"version":3,"file":"command-registry.d.ts","sourceRoot":"","sources":["../src/command-registry.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,uBAAuB,CAAC;AA0BzD,eAAO,MAAM,aAAa,EAAE,WAAW,EAyBtC,CAAC"}
+{"version":3,"file":"command-registry.d.ts","sourceRoot":"","sources":["../src/command-registry.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,uBAAuB,CAAC;AAgCzD,eAAO,MAAM,aAAa,EAAE,WAAW,EA4BtC,CAAC"}

package/dist/command-registry.js

@@ -3,6 +3,7 @@ import { API_COMMAND_SPECS } from "./commands/api.js";
 import { AUDIO_COMMAND_SPECS } from "./commands/audio.js";
 import { AUTH_COMMAND_SPECS } from "./commands/auth.js";
 import { CAPTIONS_COMMAND_SPECS } from "./commands/captions.js";
+import { CHARACTER_COMMAND_SPECS } from "./commands/characters.js";
 import { CLIPS_COMMAND_SPECS } from "./commands/clips.js";
 import { EDITING_WORKFLOW_COMMAND_SPECS } from "./commands/editing-workflows.js";
 import { EFFECTS_COMMAND_SPECS } from "./commands/effects.js";
@@ -16,8 +17,10 @@ import { MEDIA_OVERLAY_COMMAND_SPECS } from "./commands/media-overlays.js";
 import { ONBOARDING_COMMAND_SPECS } from "./commands/onboarding.js";
 import { PROJECT_READ_COMMAND_SPECS } from "./commands/project-read.js";
 import { PROJECTS_COMMAND_SPECS } from "./commands/projects.js";
+import { isPublishingAgentSurfaceEnabled, PUBLISHING_COMMAND_SPECS, } from "./commands/publishing.js";
 import { RECORDING_SET_COMMAND_SPECS } from "./commands/recording-sets.js";
 import { STOCK_LIBRARY_COMMAND_SPECS } from "./commands/stock-library.js";
+import { STORY_KIT_COMMAND_SPECS } from "./commands/story-kits.js";
 import { SYSTEM_COMMAND_SPECS } from "./commands/system.js";
 import { TEXT_OVERLAY_COMMAND_SPECS } from "./commands/text-overlays.js";
 import { TIMELINE_COMMAND_SPECS } from "./commands/timeline.js";
@@ -40,12 +43,15 @@ export const COMMAND_SPECS = [
     ...STOCK_LIBRARY_COMMAND_SPECS,
     ...EDITING_WORKFLOW_COMMAND_SPECS,
     ...CAPTIONS_COMMAND_SPECS,
+    ...CHARACTER_COMMAND_SPECS,
     ...EXPORTS_COMMAND_SPECS,
     ...FACELESS_COMMAND_SPECS,
+    ...STORY_KIT_COMMAND_SPECS,
     ...FORMATS_COMMAND_SPECS,
     ...GENERATION_COMMAND_SPECS,
     ...JOBS_COMMAND_SPECS,
     ...AI_EDIT_COMMAND_SPECS,
     ...API_COMMAND_SPECS,
+    ...(isPublishingAgentSurfaceEnabled() ? PUBLISHING_COMMAND_SPECS : []),
 ];
 //# sourceMappingURL=command-registry.js.map

package/dist/command-registry.js.map

@@ -1 +1 @@
-{"version":3,"file":"command-registry.js","sourceRoot":"","sources":["../src/command-registry.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,qBAAqB,EAAE,MAAM,uBAAuB,CAAC;AAC9D,OAAO,EAAE,iBAAiB,EAAE,MAAM,mBAAmB,CAAC;AACtD,OAAO,EAAE,mBAAmB,EAAE,MAAM,qBAAqB,CAAC;AAC1D,OAAO,EAAE,kBAAkB,EAAE,MAAM,oBAAoB,CAAC;AACxD,OAAO,EAAE,sBAAsB,EAAE,MAAM,wBAAwB,CAAC;AAChE,OAAO,EAAE,mBAAmB,EAAE,MAAM,qBAAqB,CAAC;AAC1D,OAAO,EAAE,8BAA8B,EAAE,MAAM,iCAAiC,CAAC;AACjF,OAAO,EAAE,qBAAqB,EAAE,MAAM,uBAAuB,CAAC;AAC9D,OAAO,EAAE,qBAAqB,EAAE,MAAM,uBAAuB,CAAC;AAC9D,OAAO,EAAE,sBAAsB,EAAE,MAAM,wBAAwB,CAAC;AAChE,OAAO,EAAE,qBAAqB,EAAE,MAAM,uBAAuB,CAAC;AAC9D,OAAO,EAAE,wBAAwB,EAAE,MAAM,0BAA0B,CAAC;AACpE,OAAO,EAAE,kBAAkB,EAAE,MAAM,oBAAoB,CAAC;AACxD,OAAO,EAAE,yBAAyB,EAAE,MAAM,4BAA4B,CAAC;AACvE,OAAO,EAAE,2BAA2B,EAAE,MAAM,8BAA8B,CAAC;AAC3E,OAAO,EAAE,wBAAwB,EAAE,MAAM,0BAA0B,CAAC;AACpE,OAAO,EAAE,0BAA0B,EAAE,MAAM,4BAA4B,CAAC;AACxE,OAAO,EAAE,sBAAsB,EAAE,MAAM,wBAAwB,CAAC;AAChE,OAAO,EAAE,2BAA2B,EAAE,MAAM,8BAA8B,CAAC;AAC3E,OAAO,EAAE,2BAA2B,EAAE,MAAM,6BAA6B,CAAC;AAC1E,OAAO,EAAE,oBAAoB,EAAE,MAAM,sBAAsB,CAAC;AAC5D,OAAO,EAAE,0BAA0B,EAAE,MAAM,6BAA6B,CAAC;AACzE,OAAO,EAAE,sBAAsB,EAAE,MAAM,wBAAwB,CAAC;AAChE,OAAO,EAAE,uBAAuB,EAAE,MAAM,yBAAyB,CAAC;AAElE,MAAM,CAAC,MAAM,aAAa,GAAkB;IAC1C,GAAG,oBAAoB;IACvB,GAAG,kBAAkB;IACrB,GAAG,wBAAwB;IAC3B,GAAG,uBAAuB;IAC1B,GAAG,sBAAsB;IACzB,GAAG,2BAA2B;IAC9B,GAAG,yBAAyB;IAC5B,GAAG,2BAA2B;IAC9B,GAAG,mBAAmB;IACtB,GAAG,0BAA0B;IAC7B,GAAG,sBAAsB;IACzB,GAAG,0BAA0B;IAC7B,GAAG,mBAAmB;IACtB,GAAG,qBAAqB;IACxB,GAAG,2BAA2B;IAC9B,GAAG,8BAA8B;IACjC,GAAG,sBAAsB;IACzB,GAAG,qBAAqB;IACxB,GAAG,sBAAsB;IACzB,GAAG,qBAAqB;IACxB,GAAG,wBAAwB;IAC3B,GAAG,kBAAkB;IACrB,GAAG,qBAAqB;IACxB,GAAG,iBAAiB;CACrB,CAAC"}
+{"version":3,"file":"command-registry.js","sourceRoot":"","sources":["../src/command-registry.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,qBAAqB,EAAE,MAAM,uBAAuB,CAAC;AAC9D,OAAO,EAAE,iBAAiB,EAAE,MAAM,mBAAmB,CAAC;AACtD,OAAO,EAAE,mBAAmB,EAAE,MAAM,qBAAqB,CAAC;AAC1D,OAAO,EAAE,kBAAkB,EAAE,MAAM,oBAAoB,CAAC;AACxD,OAAO,EAAE,sBAAsB,EAAE,MAAM,wBAAwB,CAAC;AAChE,OAAO,EAAE,uBAAuB,EAAE,MAAM,0BAA0B,CAAC;AACnE,OAAO,EAAE,mBAAmB,EAAE,MAAM,qBAAqB,CAAC;AAC1D,OAAO,EAAE,8BAA8B,EAAE,MAAM,iCAAiC,CAAC;AACjF,OAAO,EAAE,qBAAqB,EAAE,MAAM,uBAAuB,CAAC;AAC9D,OAAO,EAAE,qBAAqB,EAAE,MAAM,uBAAuB,CAAC;AAC9D,OAAO,EAAE,sBAAsB,EAAE,MAAM,wBAAwB,CAAC;AAChE,OAAO,EAAE,qBAAqB,EAAE,MAAM,uBAAuB,CAAC;AAC9D,OAAO,EAAE,wBAAwB,EAAE,MAAM,0BAA0B,CAAC;AACpE,OAAO,EAAE,kBAAkB,EAAE,MAAM,oBAAoB,CAAC;AACxD,OAAO,EAAE,yBAAyB,EAAE,MAAM,4BAA4B,CAAC;AACvE,OAAO,EAAE,2BAA2B,EAAE,MAAM,8BAA8B,CAAC;AAC3E,OAAO,EAAE,wBAAwB,EAAE,MAAM,0BAA0B,CAAC;AACpE,OAAO,EAAE,0BAA0B,EAAE,MAAM,4BAA4B,CAAC;AACxE,OAAO,EAAE,sBAAsB,EAAE,MAAM,wBAAwB,CAAC;AAChE,OAAO,EACL,+BAA+B,EAC/B,wBAAwB,GACzB,MAAM,0BAA0B,CAAC;AAClC,OAAO,EAAE,2BAA2B,EAAE,MAAM,8BAA8B,CAAC;AAC3E,OAAO,EAAE,2BAA2B,EAAE,MAAM,6BAA6B,CAAC;AAC1E,OAAO,EAAE,uBAAuB,EAAE,MAAM,0BAA0B,CAAC;AACnE,OAAO,EAAE,oBAAoB,EAAE,MAAM,sBAAsB,CAAC;AAC5D,OAAO,EAAE,0BAA0B,EAAE,MAAM,6BAA6B,CAAC;AACzE,OAAO,EAAE,sBAAsB,EAAE,MAAM,wBAAwB,CAAC;AAChE,OAAO,EAAE,uBAAuB,EAAE,MAAM,yBAAyB,CAAC;AAElE,MAAM,CAAC,MAAM,aAAa,GAAkB;IAC1C,GAAG,oBAAoB;IACvB,GAAG,kBAAkB;IACrB,GAAG,wBAAwB;IAC3B,GAAG,uBAAuB;IAC1B,GAAG,sBAAsB;IACzB,GAAG,2BAA2B;IAC9B,GAAG,yBAAyB;IAC5B,GAAG,2BAA2B;IAC9B,GAAG,mBAAmB;IACtB,GAAG,0BAA0B;IAC7B,GAAG,sBAAsB;IACzB,GAAG,0BAA0B;IAC7B,GAAG,mBAAmB;IACtB,GAAG,qBAAqB;IACxB,GAAG,2BAA2B;IAC9B,GAAG,8BAA8B;IACjC,GAAG,sBAAsB;IACzB,GAAG,uBAAuB;IAC1B,GAAG,qBAAqB;IACxB,GAAG,sBAAsB;IACzB,GAAG,uBAAuB;IAC1B,GAAG,qBAAqB;IACxB,GAAG,wBAAwB;IAC3B,GAAG,kBAAkB;IACrB,GAAG,qBAAqB;IACxB,GAAG,iBAAiB;IACpB,GAAG,CAAC,+BAA+B,EAAE,CAAC,CAAC,CAAC,wBAAwB,CAAC,CAAC,CAAC,EAAE,CAAC;CACvE,CAAC"}

package/dist/commands/characters.d.ts

@@ -0,0 +1,40 @@
+import type { Flags } from "../cli-types.js";
+import { type CommandSpec } from "../command-metadata.js";
+import type { DryRunPreview } from "../preview-first-edit.js";
+import type { CommandOperation } from "./command-operation.js";
+export declare const CHARACTER_COMMAND_SPECS: CommandSpec[];
+type CharacterCommandHelpers = {
+    dryRunRequest: (params: {
+        spec: CommandSpec;
+        method: string;
+        path: string;
+        body: unknown;
+    }) => DryRunPreview;
+    getNumberFlag: (params: {
+        flags: Flags;
+        name: string;
+    }) => number | undefined;
+    getOptionalBooleanFlag: (params: {
+        flags: Flags;
+        name: string;
+    }) => boolean | undefined;
+    getStringFlag: (params: {
+        flags: Flags;
+        name: string;
+    }) => string | undefined;
+    requireStringFlag: (params: {
+        flags: Flags;
+        name: string;
+    }) => string;
+    printResult: (params: {
+        json: boolean;
+        value: unknown;
+        human: string[];
+        fields?: string[];
+    }) => void;
+};
+export declare function createCharactersCommandOperation({ helpers, }: {
+    helpers: CharacterCommandHelpers;
+}): CommandOperation;
+export {};
+//# sourceMappingURL=characters.d.ts.map

package/dist/commands/characters.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"characters.d.ts","sourceRoot":"","sources":["../../src/commands/characters.ts"],"names":[],"mappings":"AAEA,OAAO,KAAK,EAAc,KAAK,EAAE,MAAM,iBAAiB,CAAC;AACzD,OAAO,EAAE,KAAK,WAAW,EAAe,MAAM,wBAAwB,CAAC;AACvE,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,0BAA0B,CAAC;AAC9D,OAAO,KAAK,EAAE,gBAAgB,EAAE,MAAM,wBAAwB,CAAC;AAE/D,eAAO,MAAM,uBAAuB,EAAE,WAAW,EAgFhD,CAAC;AAEF,KAAK,uBAAuB,GAAG;IAC7B,aAAa,EAAE,CAAC,MAAM,EAAE;QACtB,IAAI,EAAE,WAAW,CAAC;QAClB,MAAM,EAAE,MAAM,CAAC;QACf,IAAI,EAAE,MAAM,CAAC;QACb,IAAI,EAAE,OAAO,CAAC;KACf,KAAK,aAAa,CAAC;IACpB,aAAa,EAAE,CAAC,MAAM,EAAE;QAAE,KAAK,EAAE,KAAK,CAAC;QAAC,IAAI,EAAE,MAAM,CAAA;KAAE,KAAK,MAAM,GAAG,SAAS,CAAC;IAC9E,sBAAsB,EAAE,CAAC,MAAM,EAAE;QAC/B,KAAK,EAAE,KAAK,CAAC;QACb,IAAI,EAAE,MAAM,CAAC;KACd,KAAK,OAAO,GAAG,SAAS,CAAC;IAC1B,aAAa,EAAE,CAAC,MAAM,EAAE;QAAE,KAAK,EAAE,KAAK,CAAC;QAAC,IAAI,EAAE,MAAM,CAAA;KAAE,KAAK,MAAM,GAAG,SAAS,CAAC;IAC9E,iBAAiB,EAAE,CAAC,MAAM,EAAE;QAAE,KAAK,EAAE,KAAK,CAAC;QAAC,IAAI,EAAE,MAAM,CAAA;KAAE,KAAK,MAAM,CAAC;IACtE,WAAW,EAAE,CAAC,MAAM,EAAE;QACpB,IAAI,EAAE,OAAO,CAAC;QACd,KAAK,EAAE,OAAO,CAAC;QACf,KAAK,EAAE,MAAM,EAAE,CAAC;QAChB,MAAM,CAAC,EAAE,MAAM,EAAE,CAAC;KACnB,KAAK,IAAI,CAAC;CACZ,CAAC;AAsGF,wBAAgB,gCAAgC,CAAC,EAC/C,OAAO,GACR,EAAE;IACD,OAAO,EAAE,uBAAuB,CAAC;CAClC,GAAG,gBAAgB,CAyMnB"}

package/dist/commands/characters.js

@@ -0,0 +1,344 @@
+import { CliUsageError } from "../cli-errors.js";
+import { commandSpec } from "../command-metadata.js";
+export const CHARACTER_COMMAND_SPECS = [
+    commandSpec({
+        command: ["characters", "list"],
+        usage: "blitzreels characters list [--include-archived] [--limit 50] [--offset 0] [--json]",
+        description: "List reusable workspace characters and reference asset IDs.",
+        flags: [{ name: "include-archived", type: "boolean" }, "limit", "offset"],
+    }),
+    commandSpec({
+        command: ["characters", "get"],
+        usage: "blitzreels characters get --character-id ID [--json]",
+        description: "Get one workspace character and its reference asset IDs.",
+        flags: ["character-id"],
+    }),
+    commandSpec({
+        command: ["characters", "create"],
+        usage: "blitzreels characters create --name NAME [--type human] [--reference-asset-ids ID,ID] [--primary-reference-asset-id ID] --idempotency-key KEY [--dry-run] [--json]",
+        description: "Create a reusable character from workspace image assets.",
+        mutates: true,
+        dryRunSupported: true,
+        flags: [
+            "name",
+            "type",
+            "consistency-mode",
+            "reference-asset-ids",
+            "primary-reference-asset-id",
+            { name: "idempotency-key", required: true },
+        ],
+    }),
+    commandSpec({
+        command: ["characters", "update"],
+        usage: "blitzreels characters update --character-id ID [--name NAME] [--type human] [--consistency-mode reference] --idempotency-key KEY [--dry-run] [--json]",
+        description: "Update one workspace character.",
+        mutates: true,
+        dryRunSupported: true,
+        flags: [
+            "character-id",
+            "name",
+            "type",
+            "consistency-mode",
+            { name: "idempotency-key", required: true },
+        ],
+    }),
+    commandSpec({
+        command: ["characters", "references", "add"],
+        usage: "blitzreels characters references add --character-id ID --asset-ids ID,ID --idempotency-key KEY [--dry-run] [--json]",
+        description: "Add existing workspace image assets as character references.",
+        mutates: true,
+        dryRunSupported: true,
+        flags: [
+            "character-id",
+            "asset-ids",
+            { name: "idempotency-key", required: true },
+        ],
+    }),
+    commandSpec({
+        command: ["characters", "primary-reference", "set"],
+        usage: "blitzreels characters primary-reference set --character-id ID --asset-id ID --idempotency-key KEY [--dry-run] [--json]",
+        description: "Set one attached image as the primary character reference.",
+        mutates: true,
+        dryRunSupported: true,
+        flags: [
+            "character-id",
+            "asset-id",
+            { name: "idempotency-key", required: true },
+        ],
+    }),
+    commandSpec({
+        command: ["characters", "archive"],
+        usage: "blitzreels characters archive --character-id ID --idempotency-key KEY [--dry-run] [--json]",
+        description: "Archive one workspace character without deleting its assets.",
+        mutates: true,
+        dryRunSupported: true,
+        flags: ["character-id", { name: "idempotency-key", required: true }],
+    }),
+];
+function parseIds({ value, name }) {
+    const ids = Array.from(new Set(value
+        .split(",")
+        .map((item) => item.trim())
+        .filter(Boolean)));
+    if (ids.length === 0) {
+        throw new CliUsageError({
+            code: "invalid_flag_value",
+            message: `--${name} must contain at least one ID.`,
+        });
+    }
+    return ids;
+}
+function parseCharacterType({ value, }) {
+    if (value === undefined)
+        return undefined;
+    if (value === "human" || value === "fictional" || value === "other") {
+        return value;
+    }
+    throw new CliUsageError({
+        code: "invalid_flag_value",
+        message: "--type must be human, fictional, or other.",
+    });
+}
+function parseConsistencyMode({ value, }) {
+    if (value === undefined)
+        return undefined;
+    if (value === "reference" || value === "trained_lora")
+        return value;
+    throw new CliUsageError({
+        code: "invalid_flag_value",
+        message: "--consistency-mode must be reference or trained_lora.",
+    });
+}
+function buildCharacterSummary({ character, }) {
+    return [
+        `Character: ${character.id}`,
+        `Name: ${character.name}`,
+        `Status: ${character.status}`,
+        `References: ${character.references.length}`,
+        `Primary reference: ${character.primary_reference_asset_id ?? "none"}`,
+    ];
+}
+function buildCreateInput({ context, helpers, }) {
+    const flags = context.args.flags;
+    const referenceIds = helpers.getStringFlag({
+        flags,
+        name: "reference-asset-ids",
+    });
+    return {
+        name: helpers.requireStringFlag({ flags, name: "name" }),
+        type: parseCharacterType({
+            value: helpers.getStringFlag({ flags, name: "type" }),
+        }),
+        consistencyMode: parseConsistencyMode({
+            value: helpers.getStringFlag({ flags, name: "consistency-mode" }),
+        }),
+        referenceAssetIds: referenceIds
+            ? parseIds({ value: referenceIds, name: "reference-asset-ids" })
+            : undefined,
+        primaryReferenceAssetId: helpers.getStringFlag({
+            flags,
+            name: "primary-reference-asset-id",
+        }),
+        idempotencyKey: helpers.requireStringFlag({
+            flags,
+            name: "idempotency-key",
+        }),
+    };
+}
+export function createCharactersCommandOperation({ helpers, }) {
+    return {
+        name: "characters",
+        matches: ({ command }) => command[0] === "characters",
+        handle: async ({ context }) => {
+            const [domain, action, nestedAction] = context.args.command;
+            const flags = context.args.flags;
+            if (domain !== "characters")
+                return false;
+            if (action === "list") {
+                const result = await context.client.characters.list({
+                    includeArchived: helpers.getOptionalBooleanFlag({
+                        flags,
+                        name: "include-archived",
+                    }),
+                    limit: helpers.getNumberFlag({ flags, name: "limit" }),
+                    offset: helpers.getNumberFlag({ flags, name: "offset" }),
+                });
+                helpers.printResult({
+                    json: context.json,
+                    value: result,
+                    human: result.items.map((character) => `${character.id} | ${character.name} | ${character.status} | refs=${character.references.length}`),
+                });
+                return true;
+            }
+            const characterId = action === "create"
+                ? undefined
+                : helpers.requireStringFlag({ flags, name: "character-id" });
+            if (action === "get" && characterId) {
+                const result = await context.client.characters.get({ characterId });
+                helpers.printResult({
+                    json: context.json,
+                    value: result,
+                    human: buildCharacterSummary({ character: result }),
+                });
+                return true;
+            }
+            if (action === "create") {
+                const result = await context.client.characters.create(buildCreateInput({ context, helpers }));
+                helpers.printResult({
+                    json: context.json,
+                    value: result,
+                    human: buildCharacterSummary({ character: result }),
+                });
+                return true;
+            }
+            const idempotencyKey = helpers.requireStringFlag({
+                flags,
+                name: "idempotency-key",
+            });
+            if (action === "update" && characterId) {
+                const result = await context.client.characters.update({
+                    characterId,
+                    name: helpers.getStringFlag({ flags, name: "name" }),
+                    type: parseCharacterType({
+                        value: helpers.getStringFlag({ flags, name: "type" }),
+                    }),
+                    consistencyMode: parseConsistencyMode({
+                        value: helpers.getStringFlag({ flags, name: "consistency-mode" }),
+                    }),
+                    idempotencyKey,
+                });
+                helpers.printResult({
+                    json: context.json,
+                    value: result,
+                    human: buildCharacterSummary({ character: result }),
+                });
+                return true;
+            }
+            if (action === "references" && nestedAction === "add" && characterId) {
+                const result = await context.client.characters.addReferences({
+                    characterId,
+                    assetIds: parseIds({
+                        value: helpers.requireStringFlag({ flags, name: "asset-ids" }),
+                        name: "asset-ids",
+                    }),
+                    idempotencyKey,
+                });
+                helpers.printResult({
+                    json: context.json,
+                    value: result,
+                    human: [
+                        ...buildCharacterSummary({ character: result.character }),
+                        `Added: ${result.added_count}`,
+                        `Skipped: ${result.skipped_count}`,
+                    ],
+                });
+                return true;
+            }
+            if (action === "primary-reference" &&
+                nestedAction === "set" &&
+                characterId) {
+                const result = await context.client.characters.setPrimaryReference({
+                    characterId,
+                    assetId: helpers.requireStringFlag({ flags, name: "asset-id" }),
+                    idempotencyKey,
+                });
+                helpers.printResult({
+                    json: context.json,
+                    value: result,
+                    human: buildCharacterSummary({ character: result }),
+                });
+                return true;
+            }
+            if (action === "archive" && characterId) {
+                const result = await context.client.characters.archive({
+                    characterId,
+                    idempotencyKey,
+                });
+                helpers.printResult({
+                    json: context.json,
+                    value: result,
+                    human: buildCharacterSummary({ character: result }),
+                });
+                return true;
+            }
+            return false;
+        },
+        buildDryRun: ({ context, spec }) => {
+            const [domain, action, nestedAction] = context.args.command;
+            const flags = context.args.flags;
+            if (domain !== "characters")
+                return undefined;
+            if (action === "create") {
+                const input = buildCreateInput({ context, helpers });
+                return helpers.dryRunRequest({
+                    spec,
+                    method: "POST",
+                    path: "/characters",
+                    body: {
+                        name: input.name,
+                        type: input.type,
+                        consistency_mode: input.consistencyMode,
+                        reference_asset_ids: input.referenceAssetIds,
+                        primary_reference_asset_id: input.primaryReferenceAssetId,
+                    },
+                });
+            }
+            const characterId = helpers.requireStringFlag({
+                flags,
+                name: "character-id",
+            });
+            if (action === "update") {
+                return helpers.dryRunRequest({
+                    spec,
+                    method: "PATCH",
+                    path: `/characters/${encodeURIComponent(characterId)}`,
+                    body: {
+                        name: helpers.getStringFlag({ flags, name: "name" }),
+                        type: parseCharacterType({
+                            value: helpers.getStringFlag({ flags, name: "type" }),
+                        }),
+                        consistency_mode: parseConsistencyMode({
+                            value: helpers.getStringFlag({
+                                flags,
+                                name: "consistency-mode",
+                            }),
+                        }),
+                    },
+                });
+            }
+            if (action === "references" && nestedAction === "add") {
+                return helpers.dryRunRequest({
+                    spec,
+                    method: "POST",
+                    path: `/characters/${encodeURIComponent(characterId)}/references`,
+                    body: {
+                        asset_ids: parseIds({
+                            value: helpers.requireStringFlag({ flags, name: "asset-ids" }),
+                            name: "asset-ids",
+                        }),
+                    },
+                });
+            }
+            if (action === "primary-reference" && nestedAction === "set") {
+                return helpers.dryRunRequest({
+                    spec,
+                    method: "POST",
+                    path: `/characters/${encodeURIComponent(characterId)}/primary-reference`,
+                    body: {
+                        asset_id: helpers.requireStringFlag({ flags, name: "asset-id" }),
+                    },
+                });
+            }
+            if (action === "archive") {
+                return helpers.dryRunRequest({
+                    spec,
+                    method: "POST",
+                    path: `/characters/${encodeURIComponent(characterId)}/archive`,
+                    body: {},
+                });
+            }
+            return undefined;
+        },
+    };
+}
+//# sourceMappingURL=characters.js.map

package/dist/commands/characters.js.map

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

package/dist/commands/clips.d.ts

@@ -1,4 +1,4 @@
-import type { ClipEnvelope, ClipSelectionOptions, ClipTargetOptions, ExportClipOptions, RepairClipOptions } from "@blitzreels/sdk";
+import { type ClipEnvelope, type ClipSelectionOptions, type ClipTargetOptions, type ExportClipOptions, type RepairClipOptions } from "@blitzreels/sdk";
 import type { CliContext, Flags } from "../cli-types.js";
 import { type CommandSpec } from "../command-metadata.js";
 import type { DryRunPreview } from "../preview-first-edit.js";

package/dist/commands/clips.d.ts.map

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

package/dist/commands/clips.js

@@ -1,5 +1,6 @@
 import { mkdir, writeFile } from "node:fs/promises";
 import { join, resolve } from "node:path";
+import { BlitzReelsError, } from "@blitzreels/sdk";
 import { CliOperationError, CliUsageError } from "../cli-errors.js";
 import { commandSpec } from "../command-metadata.js";
 export const CLIPS_COMMAND_SPECS = [
@@ -388,7 +389,28 @@ async function waitForClipBatch({ context, helpers, }) {
     }) ?? 20 * 60 * 1000;
     const startedAt = Date.now();
     while (true) {
-        const result = await context.client.clipBatches.get({ batchId });
+        let result;
+        try {
+            result = await context.client.clipBatches.get({ batchId });
+        }
+        catch (error) {
+            if (!(error instanceof BlitzReelsError) || !error.retryable) {
+                throw error;
+            }
+            if (Date.now() - startedAt >= timeoutMs) {
+                throw new CliOperationError({
+                    code: "clip_batch_wait_timeout",
+                    exitCode: 7,
+                    message: `Timed out waiting for clip batch ${batchId}.`,
+                    retryable: true,
+                    suggestions: [
+                        `blitzreels clip-batches get --batch-id ${batchId} --json`,
+                    ],
+                });
+            }
+            await helpers.sleep({ ms: intervalMs });
+            continue;
+        }
         if (result.batch.studio_sound.status === "failed") {
             throw new CliOperationError({
                 code: "studio_sound_failed",