@usenaive-sdk/cli 1.0.2 → 1.0.4

package/dist/index.js

@@ -28590,6 +28590,10 @@ var PayoutDetailsSchema = external_exports.object({
 var CreatorStatusSchema = external_exports.enum(["active", "suspended", "archived"]);
 var CreatorSourceSchema = external_exports.enum(["youtube", "channel_license", "doomscroll"]);
 var CreatorStudioBudgetSchema = MicroUsdField.positive().max(1e10);
+var CreatorModeSchema = external_exports.enum(["ai_clips", "sports_clips", "movie_clips", "dance_clips"]);
+var VIDEO_CREATOR_MODES = ["sports_clips", "movie_clips", "dance_clips"];
+var VideoCreatorModeSchema = external_exports.enum(VIDEO_CREATOR_MODES);
+var CreatorModesSchema = external_exports.array(CreatorModeSchema).min(1, "keep at least one account type").refine((modes) => new Set(modes).size === modes.length, "each account type at most once");
 var CreatorSchema = external_exports.object({
   id: idOf("crt"),
   object: external_exports.literal("creator"),
@@ -28603,6 +28607,8 @@ var CreatorSchema = external_exports.object({
   clicks: external_exports.number().int().nonnegative(),
   /** This creator's per-draft studio cap, overriding `CREATOR_PROGRAM.studio`; `null` = the default. */
   studio_budget_micro_usd: CreatorStudioBudgetSchema.nullable(),
+  /** Its campaign modes (migration 0181); a row read before it parses as `ai_clips` only. */
+  modes: CreatorModesSchema.default(["ai_clips"]),
   created_at: Timestamp,
   updated_at: Timestamp
 });
@@ -28715,7 +28721,9 @@ var CREATOR_PROGRAM = {
     review_check_budget_micro_usd: 5e6,
     /** A `video` origin build (§42.14): one raw clip and its characters, recast by Mira. */
     video: {
-      min_seconds: 3,
+      /** The object swap refuses a clip under 4 s (§42.15). */
+      min_seconds: 4,
+      /** The longest part of a clip a render uses: a longer upload is taken and cut to its first 15 s (ADR-2204). */
       max_seconds: 15,
       video_max_bytes: 95 * 1024 * 1024,
       image_max_bytes: 10 * 1024 * 1024,
@@ -28723,8 +28731,8 @@ var CREATOR_PROGRAM = {
       characters_max: 3,
       /** After the first render. A refused or failed render does not use one up. */
       revisions: 5,
-      /** Per doomscroll account, until one of its templates is approved. */
-      unapproved_templates: 2,
+      /** Per doomscroll account, until one of its templates is approved. Only drafts that rendered a video count. */
+      unapproved_templates: 5,
       /** Upload tickets a doomscroll account may ask for, per template. */
       upload_tickets: 20,
       /** A draft never submitted loses its source and character bytes this long after `updated_at`. */
@@ -28852,8 +28860,11 @@ var StudioCharacterSchema = external_exports.object({
   file_id: external_exports.string().nullable(),
   bytes: external_exports.number().int().positive().max(CREATOR_PROGRAM.studio.video.image_max_bytes),
   content_type: StudioImageContentTypeSchema,
-  filename: external_exports.string().min(1).max(200)
+  filename: external_exports.string().min(1).max(200),
+  /** Who this is in the clip, in the creator's words ("the driver"): the render is told which photo is whom. */
+  label: external_exports.string().min(1).max(80).optional()
 });
+var StudioEditModeSchema = external_exports.enum(["edit", "motion_transfer"]);
 var CreatorStudioSchema = external_exports.object({
   uploads: external_exports.array(StudioUploadSchema).max(CREATOR_PROGRAM.studio.uploads).default([]),
   /** `links`: built from 1–3 reel links (`imports`), prompts optional; `upload`: the creator's three videos; `video`: one raw clip recast by Mira (§42.14). */
@@ -28872,7 +28883,11 @@ var CreatorStudioSchema = external_exports.object({
   /** A `video` origin's raw clip, its characters, and the round submitted (§42.14). */
   source_video: StudioSourceVideoSchema.nullable().default(null),
   characters: external_exports.array(StudioCharacterSchema).max(CREATOR_PROGRAM.studio.video.characters_max).default([]),
-  chosen_round: external_exports.number().int().positive().nullable().default(null)
+  chosen_round: external_exports.number().int().positive().nullable().default(null),
+  /** A `video` origin's campaign mode (§42.15); absent on a draft made before modes, which reads as generic. */
+  mode: VideoCreatorModeSchema.optional(),
+  /** A `video` origin's kind of Mira edit (ADR-2410); absent is `edit`. Not `mode`, which is the campaign mode. */
+  edit_mode: StudioEditModeSchema.optional()
 });
 var CreatorTemplateListingSchema = external_exports.object({
   listed: external_exports.boolean(),
@@ -29044,19 +29059,28 @@ var CreatorAnalyticsSchema = external_exports.object({
 var CreatorTemplateCreateKindSchema = external_exports.object({
   kind: CreatorTemplateKindSchema.default("crew"),
   /** `video` makes a draft built from one raw clip (§42.14); it needs `kind: niche`. */
-  origin: external_exports.literal("video").optional()
+  origin: external_exports.literal("video").optional(),
+  /** Required with `origin: "video"`: one of the creator's video modes (§42.15). */
+  mode: VideoCreatorModeSchema.optional(),
+  /** Only with `origin: "video"`: how its rounds are made on Mira (ADR-2410); absent is `edit`. */
+  edit_mode: StudioEditModeSchema.optional()
 });
 var StudioUploadCreateSchema = external_exports.object({
   purpose: external_exports.enum(["source", "character"]).optional(),
   position: UploadPosition.optional(),
   filename: external_exports.string().min(1).max(200),
   content_type: external_exports.union([StudioUploadContentTypeSchema, StudioImageContentTypeSchema]),
-  bytes: external_exports.number().int().positive()
+  bytes: external_exports.number().int().positive(),
+  /** A `source` only: its length as the browser read it. Prices the render, held to the program's 4–15 s (§42.15). */
+  seconds: external_exports.number().positive().max(600).optional(),
+  /** A `character` only: who it is in the clip. */
+  label: external_exports.string().trim().min(1).max(80).optional()
 }).superRefine((body2, ctx) => {
   const { video, upload_max_bytes } = CREATOR_PROGRAM.studio;
   const character2 = body2.purpose === "character";
   const issue2 = (path, message4) => ctx.addIssue({ code: "custom", path: [path], message: message4 });
   if (body2.purpose !== "source" && body2.position === void 0) issue2("position", "position is required");
+  if (body2.label !== void 0 && !character2) issue2("label", "only a character takes a label");
   if (character2 !== StudioImageContentTypeSchema.safeParse(body2.content_type).success) {
     issue2("content_type", character2 ? "a character must be a PNG, JPEG or WebP image" : "this upload must be an MP4, MOV or WebM video");
   }
@@ -29097,8 +29121,16 @@ var CreatorStudioViewSchema = external_exports.object({
   studio: CreatorStudioSchema.extend({
     source_video: StudioSourceVideoSchema.extend({ url: external_exports.string().nullable().optional() }).nullable().default(null)
   }),
-  /** Newest first. A `video` round also carries a signed `sample_url`. */
-  rounds: external_exports.array(CreatorTemplateRoundSchema.extend({ sample_url: external_exports.string().nullable().optional() })),
+  /**
+   * Newest first. A `video` round also carries a signed `sample_url`; a `motion_transfer` build's ended
+   * round carries `rendered_as`, how Mira made it (`edit` when the motion could not be copied, ADR-2410).
+   */
+  rounds: external_exports.array(
+    CreatorTemplateRoundSchema.extend({
+      sample_url: external_exports.string().nullable().optional(),
+      rendered_as: external_exports.enum(["edit", "motion_transfer"]).nullable().optional()
+    })
+  ),
   budget: StudioBudgetSchema
 });
 var NicheSubmitSchema = external_exports.object({
@@ -30948,7 +30980,9 @@ var MusicGenerationSchema = external_exports.object({
   duration_seconds: Seconds2.nullable(),
   cost_micro_usd: MicroUsdField
 });
-var EditModeSchema = external_exports.enum(["scene", "outfit_or_object", "person_swap", "recast"]);
+var EditModeSchema = external_exports.enum(["edit", "scene", "outfit_or_object", "person_swap", "recast", "motion_transfer"]).describe(
+  `What kind of edit. "edit" (the default): the regular editor, reading what to do from the prompt. "scene", "outfit_or_object", "person_swap" and "recast" narrow it. "motion_transfer": copy the clip's exact motion onto the characters in the reference photos (fil_ images, at most 3 used), keeping the place; best for 5-15 s fights and dances; with 2-3 photos, start the prompt with <Character1>who photo 1 replaces<Character2>who photo 2 replaces and a new line. A clip it cannot take is made by the regular editor.`
+);
 var EditRequestSchema = external_exports.object({
   video: external_exports.string().min(1),
   prompt: external_exports.string().min(1).max(1e3),
@@ -30964,6 +30998,12 @@ var EditJobSchema = external_exports.object({
   prompt: external_exports.string(),
   references: external_exports.array(external_exports.string()),
   mode: EditModeSchema.nullable(),
+  /**
+   * How the finished edit was made: `motion_transfer` when the motion was copied, `edit` when the regular
+   * editor made it (every other mode, or a motion transfer that fell back). `null` until it is completed, and
+   * from a server older than the field.
+   */
+  rendered_as: external_exports.enum(["edit", "motion_transfer"]).nullable().default(null).describe("How the finished edit was made: motion_transfer, or edit (the regular editor). null until completed."),
   result: external_exports.object({ file_id: external_exports.string().startsWith("fil_") }).nullable(),
   error: external_exports.object({ code: EditFailureCodeSchema, message: external_exports.string() }).nullable(),
   cost_micro_usd: MicroUsdField.nullable(),
@@ -33960,6 +34000,10 @@ var PayoutDetailsSchema2 = external_exports.object({
 var CreatorStatusSchema2 = external_exports.enum(["active", "suspended", "archived"]);
 var CreatorSourceSchema2 = external_exports.enum(["youtube", "channel_license", "doomscroll"]);
 var CreatorStudioBudgetSchema2 = MicroUsdField2.positive().max(1e10);
+var CreatorModeSchema2 = external_exports.enum(["ai_clips", "sports_clips", "movie_clips", "dance_clips"]);
+var VIDEO_CREATOR_MODES2 = ["sports_clips", "movie_clips", "dance_clips"];
+var VideoCreatorModeSchema2 = external_exports.enum(VIDEO_CREATOR_MODES2);
+var CreatorModesSchema2 = external_exports.array(CreatorModeSchema2).min(1, "keep at least one account type").refine((modes) => new Set(modes).size === modes.length, "each account type at most once");
 var CreatorSchema2 = external_exports.object({
   id: idOf2("crt"),
   object: external_exports.literal("creator"),
@@ -33973,6 +34017,8 @@ var CreatorSchema2 = external_exports.object({
   clicks: external_exports.number().int().nonnegative(),
   /** This creator's per-draft studio cap, overriding `CREATOR_PROGRAM.studio`; `null` = the default. */
   studio_budget_micro_usd: CreatorStudioBudgetSchema2.nullable(),
+  /** Its campaign modes (migration 0181); a row read before it parses as `ai_clips` only. */
+  modes: CreatorModesSchema2.default(["ai_clips"]),
   created_at: Timestamp2,
   updated_at: Timestamp2
 });
@@ -34085,7 +34131,9 @@ var CREATOR_PROGRAM2 = {
     review_check_budget_micro_usd: 5e6,
     /** A `video` origin build (§42.14): one raw clip and its characters, recast by Mira. */
     video: {
-      min_seconds: 3,
+      /** The object swap refuses a clip under 4 s (§42.15). */
+      min_seconds: 4,
+      /** The longest part of a clip a render uses: a longer upload is taken and cut to its first 15 s (ADR-2204). */
       max_seconds: 15,
       video_max_bytes: 95 * 1024 * 1024,
       image_max_bytes: 10 * 1024 * 1024,
@@ -34093,8 +34141,8 @@ var CREATOR_PROGRAM2 = {
       characters_max: 3,
       /** After the first render. A refused or failed render does not use one up. */
       revisions: 5,
-      /** Per doomscroll account, until one of its templates is approved. */
-      unapproved_templates: 2,
+      /** Per doomscroll account, until one of its templates is approved. Only drafts that rendered a video count. */
+      unapproved_templates: 5,
       /** Upload tickets a doomscroll account may ask for, per template. */
       upload_tickets: 20,
       /** A draft never submitted loses its source and character bytes this long after `updated_at`. */
@@ -34222,8 +34270,11 @@ var StudioCharacterSchema2 = external_exports.object({
   file_id: external_exports.string().nullable(),
   bytes: external_exports.number().int().positive().max(CREATOR_PROGRAM2.studio.video.image_max_bytes),
   content_type: StudioImageContentTypeSchema2,
-  filename: external_exports.string().min(1).max(200)
+  filename: external_exports.string().min(1).max(200),
+  /** Who this is in the clip, in the creator's words ("the driver"): the render is told which photo is whom. */
+  label: external_exports.string().min(1).max(80).optional()
 });
+var StudioEditModeSchema2 = external_exports.enum(["edit", "motion_transfer"]);
 var CreatorStudioSchema2 = external_exports.object({
   uploads: external_exports.array(StudioUploadSchema2).max(CREATOR_PROGRAM2.studio.uploads).default([]),
   /** `links`: built from 1–3 reel links (`imports`), prompts optional; `upload`: the creator's three videos; `video`: one raw clip recast by Mira (§42.14). */
@@ -34242,7 +34293,11 @@ var CreatorStudioSchema2 = external_exports.object({
   /** A `video` origin's raw clip, its characters, and the round submitted (§42.14). */
   source_video: StudioSourceVideoSchema2.nullable().default(null),
   characters: external_exports.array(StudioCharacterSchema2).max(CREATOR_PROGRAM2.studio.video.characters_max).default([]),
-  chosen_round: external_exports.number().int().positive().nullable().default(null)
+  chosen_round: external_exports.number().int().positive().nullable().default(null),
+  /** A `video` origin's campaign mode (§42.15); absent on a draft made before modes, which reads as generic. */
+  mode: VideoCreatorModeSchema2.optional(),
+  /** A `video` origin's kind of Mira edit (ADR-2410); absent is `edit`. Not `mode`, which is the campaign mode. */
+  edit_mode: StudioEditModeSchema2.optional()
 });
 var CreatorTemplateListingSchema2 = external_exports.object({
   listed: external_exports.boolean(),
@@ -34414,19 +34469,28 @@ var CreatorAnalyticsSchema2 = external_exports.object({
 var CreatorTemplateCreateKindSchema2 = external_exports.object({
   kind: CreatorTemplateKindSchema2.default("crew"),
   /** `video` makes a draft built from one raw clip (§42.14); it needs `kind: niche`. */
-  origin: external_exports.literal("video").optional()
+  origin: external_exports.literal("video").optional(),
+  /** Required with `origin: "video"`: one of the creator's video modes (§42.15). */
+  mode: VideoCreatorModeSchema2.optional(),
+  /** Only with `origin: "video"`: how its rounds are made on Mira (ADR-2410); absent is `edit`. */
+  edit_mode: StudioEditModeSchema2.optional()
 });
 var StudioUploadCreateSchema2 = external_exports.object({
   purpose: external_exports.enum(["source", "character"]).optional(),
   position: UploadPosition2.optional(),
   filename: external_exports.string().min(1).max(200),
   content_type: external_exports.union([StudioUploadContentTypeSchema2, StudioImageContentTypeSchema2]),
-  bytes: external_exports.number().int().positive()
+  bytes: external_exports.number().int().positive(),
+  /** A `source` only: its length as the browser read it. Prices the render, held to the program's 4–15 s (§42.15). */
+  seconds: external_exports.number().positive().max(600).optional(),
+  /** A `character` only: who it is in the clip. */
+  label: external_exports.string().trim().min(1).max(80).optional()
 }).superRefine((body2, ctx) => {
   const { video, upload_max_bytes } = CREATOR_PROGRAM2.studio;
   const character2 = body2.purpose === "character";
   const issue2 = (path, message4) => ctx.addIssue({ code: "custom", path: [path], message: message4 });
   if (body2.purpose !== "source" && body2.position === void 0) issue2("position", "position is required");
+  if (body2.label !== void 0 && !character2) issue2("label", "only a character takes a label");
   if (character2 !== StudioImageContentTypeSchema2.safeParse(body2.content_type).success) {
     issue2("content_type", character2 ? "a character must be a PNG, JPEG or WebP image" : "this upload must be an MP4, MOV or WebM video");
   }
@@ -34467,8 +34531,16 @@ var CreatorStudioViewSchema2 = external_exports.object({
   studio: CreatorStudioSchema2.extend({
     source_video: StudioSourceVideoSchema2.extend({ url: external_exports.string().nullable().optional() }).nullable().default(null)
   }),
-  /** Newest first. A `video` round also carries a signed `sample_url`. */
-  rounds: external_exports.array(CreatorTemplateRoundSchema2.extend({ sample_url: external_exports.string().nullable().optional() })),
+  /**
+   * Newest first. A `video` round also carries a signed `sample_url`; a `motion_transfer` build's ended
+   * round carries `rendered_as`, how Mira made it (`edit` when the motion could not be copied, ADR-2410).
+   */
+  rounds: external_exports.array(
+    CreatorTemplateRoundSchema2.extend({
+      sample_url: external_exports.string().nullable().optional(),
+      rendered_as: external_exports.enum(["edit", "motion_transfer"]).nullable().optional()
+    })
+  ),
   budget: StudioBudgetSchema2
 });
 var NicheSubmitSchema2 = external_exports.object({
@@ -36275,7 +36347,9 @@ var MusicGenerationSchema2 = external_exports.object({
   duration_seconds: Seconds22.nullable(),
   cost_micro_usd: MicroUsdField2
 });
-var EditModeSchema2 = external_exports.enum(["scene", "outfit_or_object", "person_swap", "recast"]);
+var EditModeSchema2 = external_exports.enum(["edit", "scene", "outfit_or_object", "person_swap", "recast", "motion_transfer"]).describe(
+  `What kind of edit. "edit" (the default): the regular editor, reading what to do from the prompt. "scene", "outfit_or_object", "person_swap" and "recast" narrow it. "motion_transfer": copy the clip's exact motion onto the characters in the reference photos (fil_ images, at most 3 used), keeping the place; best for 5-15 s fights and dances; with 2-3 photos, start the prompt with <Character1>who photo 1 replaces<Character2>who photo 2 replaces and a new line. A clip it cannot take is made by the regular editor.`
+);
 var EditRequestSchema2 = external_exports.object({
   video: external_exports.string().min(1),
   prompt: external_exports.string().min(1).max(1e3),
@@ -36291,6 +36365,12 @@ var EditJobSchema2 = external_exports.object({
   prompt: external_exports.string(),
   references: external_exports.array(external_exports.string()),
   mode: EditModeSchema2.nullable(),
+  /**
+   * How the finished edit was made: `motion_transfer` when the motion was copied, `edit` when the regular
+   * editor made it (every other mode, or a motion transfer that fell back). `null` until it is completed, and
+   * from a server older than the field.
+   */
+  rendered_as: external_exports.enum(["edit", "motion_transfer"]).nullable().default(null).describe("How the finished edit was made: motion_transfer, or edit (the regular editor). null until completed."),
   result: external_exports.object({ file_id: external_exports.string().startsWith("fil_") }).nullable(),
   error: external_exports.object({ code: EditFailureCodeSchema2, message: external_exports.string() }).nullable(),
   cost_micro_usd: MicroUsdField2.nullable(),
@@ -39216,6 +39296,21 @@ var ExecResultSchema = external_exports.object({
   truncated: external_exports.boolean().optional()
 });
 var DirectorySchema = external_exports.object({ entries: external_exports.array(FileEntrySchema2) });
+async function* untilExit(path, frames2) {
+  let exited = false;
+  for await (const frame of frames2) {
+    if ("exit" in frame) exited = true;
+    yield frame;
+  }
+  if (!exited) {
+    throw new ApiError(502, {
+      type: "api_error",
+      code: "internal_error",
+      message: `POST ${path} ended without an exit frame; the command may have run \u2014 check GET \u2026/commands before re-running it`,
+      request_id: ""
+    });
+  }
+}
 var workspace = (config2) => ({
   /** The name, and nothing else (§41.5). */
   update: (id, body2) => request(config2, ComputerSchema2, { method: "PATCH", path: `/v1/computers/${encodeURIComponent(id)}`, body: body2 }),
@@ -39225,11 +39320,14 @@ var workspace = (config2) => ({
    * The same run as `exec`, frame by frame (§41.2): `{stdout}`/`{stderr}` as they arrive, then one
    * `{exit}` naming the `computer_command` row it was recorded as. One connection, no resume.
    */
-  execStream: (id, command, opts = {}) => streamFrames(config2, ExecStreamFrameSchema2, {
-    method: "POST",
-    path: `/v1/computers/${encodeURIComponent(id)}/exec/stream`,
-    body: { command, ...opts.timeoutMs === void 0 ? {} : { timeout_ms: opts.timeoutMs } }
-  }),
+  execStream: (id, command, opts = {}) => {
+    const body2 = { command, ...opts.timeoutMs === void 0 ? {} : { timeout_ms: opts.timeoutMs } };
+    return untilExit(`/v1/computers/${encodeURIComponent(id)}/exec/stream`, streamFrames(config2, ExecStreamFrameSchema2, {
+      method: "POST",
+      path: `/v1/computers/${encodeURIComponent(id)}/exec/stream`,
+      body: body2
+    }));
+  },
   /** What has been run on the box, newest first (§41.3). */
   commands: (id, query2 = {}) => request(config2, page(ComputerCommandSchema2), {
     method: "GET",
@@ -42966,6 +43064,10 @@ var PayoutDetailsSchema3 = external_exports.object({
 var CreatorStatusSchema3 = external_exports.enum(["active", "suspended", "archived"]);
 var CreatorSourceSchema3 = external_exports.enum(["youtube", "channel_license", "doomscroll"]);
 var CreatorStudioBudgetSchema3 = MicroUsdField3.positive().max(1e10);
+var CreatorModeSchema3 = external_exports.enum(["ai_clips", "sports_clips", "movie_clips", "dance_clips"]);
+var VIDEO_CREATOR_MODES3 = ["sports_clips", "movie_clips", "dance_clips"];
+var VideoCreatorModeSchema3 = external_exports.enum(VIDEO_CREATOR_MODES3);
+var CreatorModesSchema3 = external_exports.array(CreatorModeSchema3).min(1, "keep at least one account type").refine((modes) => new Set(modes).size === modes.length, "each account type at most once");
 var CreatorSchema3 = external_exports.object({
   id: idOf3("crt"),
   object: external_exports.literal("creator"),
@@ -42979,6 +43081,8 @@ var CreatorSchema3 = external_exports.object({
   clicks: external_exports.number().int().nonnegative(),
   /** This creator's per-draft studio cap, overriding `CREATOR_PROGRAM.studio`; `null` = the default. */
   studio_budget_micro_usd: CreatorStudioBudgetSchema3.nullable(),
+  /** Its campaign modes (migration 0181); a row read before it parses as `ai_clips` only. */
+  modes: CreatorModesSchema3.default(["ai_clips"]),
   created_at: Timestamp3,
   updated_at: Timestamp3
 });
@@ -43091,7 +43195,9 @@ var CREATOR_PROGRAM3 = {
     review_check_budget_micro_usd: 5e6,
     /** A `video` origin build (§42.14): one raw clip and its characters, recast by Mira. */
     video: {
-      min_seconds: 3,
+      /** The object swap refuses a clip under 4 s (§42.15). */
+      min_seconds: 4,
+      /** The longest part of a clip a render uses: a longer upload is taken and cut to its first 15 s (ADR-2204). */
       max_seconds: 15,
       video_max_bytes: 95 * 1024 * 1024,
       image_max_bytes: 10 * 1024 * 1024,
@@ -43099,8 +43205,8 @@ var CREATOR_PROGRAM3 = {
       characters_max: 3,
       /** After the first render. A refused or failed render does not use one up. */
       revisions: 5,
-      /** Per doomscroll account, until one of its templates is approved. */
-      unapproved_templates: 2,
+      /** Per doomscroll account, until one of its templates is approved. Only drafts that rendered a video count. */
+      unapproved_templates: 5,
       /** Upload tickets a doomscroll account may ask for, per template. */
       upload_tickets: 20,
       /** A draft never submitted loses its source and character bytes this long after `updated_at`. */
@@ -43228,8 +43334,11 @@ var StudioCharacterSchema3 = external_exports.object({
   file_id: external_exports.string().nullable(),
   bytes: external_exports.number().int().positive().max(CREATOR_PROGRAM3.studio.video.image_max_bytes),
   content_type: StudioImageContentTypeSchema3,
-  filename: external_exports.string().min(1).max(200)
+  filename: external_exports.string().min(1).max(200),
+  /** Who this is in the clip, in the creator's words ("the driver"): the render is told which photo is whom. */
+  label: external_exports.string().min(1).max(80).optional()
 });
+var StudioEditModeSchema3 = external_exports.enum(["edit", "motion_transfer"]);
 var CreatorStudioSchema3 = external_exports.object({
   uploads: external_exports.array(StudioUploadSchema3).max(CREATOR_PROGRAM3.studio.uploads).default([]),
   /** `links`: built from 1–3 reel links (`imports`), prompts optional; `upload`: the creator's three videos; `video`: one raw clip recast by Mira (§42.14). */
@@ -43248,7 +43357,11 @@ var CreatorStudioSchema3 = external_exports.object({
   /** A `video` origin's raw clip, its characters, and the round submitted (§42.14). */
   source_video: StudioSourceVideoSchema3.nullable().default(null),
   characters: external_exports.array(StudioCharacterSchema3).max(CREATOR_PROGRAM3.studio.video.characters_max).default([]),
-  chosen_round: external_exports.number().int().positive().nullable().default(null)
+  chosen_round: external_exports.number().int().positive().nullable().default(null),
+  /** A `video` origin's campaign mode (§42.15); absent on a draft made before modes, which reads as generic. */
+  mode: VideoCreatorModeSchema3.optional(),
+  /** A `video` origin's kind of Mira edit (ADR-2410); absent is `edit`. Not `mode`, which is the campaign mode. */
+  edit_mode: StudioEditModeSchema3.optional()
 });
 var CreatorTemplateListingSchema3 = external_exports.object({
   listed: external_exports.boolean(),
@@ -43420,19 +43533,28 @@ var CreatorAnalyticsSchema3 = external_exports.object({
 var CreatorTemplateCreateKindSchema3 = external_exports.object({
   kind: CreatorTemplateKindSchema3.default("crew"),
   /** `video` makes a draft built from one raw clip (§42.14); it needs `kind: niche`. */
-  origin: external_exports.literal("video").optional()
+  origin: external_exports.literal("video").optional(),
+  /** Required with `origin: "video"`: one of the creator's video modes (§42.15). */
+  mode: VideoCreatorModeSchema3.optional(),
+  /** Only with `origin: "video"`: how its rounds are made on Mira (ADR-2410); absent is `edit`. */
+  edit_mode: StudioEditModeSchema3.optional()
 });
 var StudioUploadCreateSchema3 = external_exports.object({
   purpose: external_exports.enum(["source", "character"]).optional(),
   position: UploadPosition3.optional(),
   filename: external_exports.string().min(1).max(200),
   content_type: external_exports.union([StudioUploadContentTypeSchema3, StudioImageContentTypeSchema3]),
-  bytes: external_exports.number().int().positive()
+  bytes: external_exports.number().int().positive(),
+  /** A `source` only: its length as the browser read it. Prices the render, held to the program's 4–15 s (§42.15). */
+  seconds: external_exports.number().positive().max(600).optional(),
+  /** A `character` only: who it is in the clip. */
+  label: external_exports.string().trim().min(1).max(80).optional()
 }).superRefine((body2, ctx) => {
   const { video, upload_max_bytes } = CREATOR_PROGRAM3.studio;
   const character2 = body2.purpose === "character";
   const issue2 = (path, message32) => ctx.addIssue({ code: "custom", path: [path], message: message32 });
   if (body2.purpose !== "source" && body2.position === void 0) issue2("position", "position is required");
+  if (body2.label !== void 0 && !character2) issue2("label", "only a character takes a label");
   if (character2 !== StudioImageContentTypeSchema3.safeParse(body2.content_type).success) {
     issue2("content_type", character2 ? "a character must be a PNG, JPEG or WebP image" : "this upload must be an MP4, MOV or WebM video");
   }
@@ -43473,8 +43595,16 @@ var CreatorStudioViewSchema3 = external_exports.object({
   studio: CreatorStudioSchema3.extend({
     source_video: StudioSourceVideoSchema3.extend({ url: external_exports.string().nullable().optional() }).nullable().default(null)
   }),
-  /** Newest first. A `video` round also carries a signed `sample_url`. */
-  rounds: external_exports.array(CreatorTemplateRoundSchema3.extend({ sample_url: external_exports.string().nullable().optional() })),
+  /**
+   * Newest first. A `video` round also carries a signed `sample_url`; a `motion_transfer` build's ended
+   * round carries `rendered_as`, how Mira made it (`edit` when the motion could not be copied, ADR-2410).
+   */
+  rounds: external_exports.array(
+    CreatorTemplateRoundSchema3.extend({
+      sample_url: external_exports.string().nullable().optional(),
+      rendered_as: external_exports.enum(["edit", "motion_transfer"]).nullable().optional()
+    })
+  ),
   budget: StudioBudgetSchema3
 });
 var NicheSubmitSchema3 = external_exports.object({
@@ -45287,7 +45417,9 @@ var MusicGenerationSchema3 = external_exports.object({
   duration_seconds: Seconds23.nullable(),
   cost_micro_usd: MicroUsdField3
 });
-var EditModeSchema3 = external_exports.enum(["scene", "outfit_or_object", "person_swap", "recast"]);
+var EditModeSchema3 = external_exports.enum(["edit", "scene", "outfit_or_object", "person_swap", "recast", "motion_transfer"]).describe(
+  `What kind of edit. "edit" (the default): the regular editor, reading what to do from the prompt. "scene", "outfit_or_object", "person_swap" and "recast" narrow it. "motion_transfer": copy the clip's exact motion onto the characters in the reference photos (fil_ images, at most 3 used), keeping the place; best for 5-15 s fights and dances; with 2-3 photos, start the prompt with <Character1>who photo 1 replaces<Character2>who photo 2 replaces and a new line. A clip it cannot take is made by the regular editor.`
+);
 var EditRequestSchema3 = external_exports.object({
   video: external_exports.string().min(1),
   prompt: external_exports.string().min(1).max(1e3),
@@ -45303,6 +45435,12 @@ var EditJobSchema3 = external_exports.object({
   prompt: external_exports.string(),
   references: external_exports.array(external_exports.string()),
   mode: EditModeSchema3.nullable(),
+  /**
+   * How the finished edit was made: `motion_transfer` when the motion was copied, `edit` when the regular
+   * editor made it (every other mode, or a motion transfer that fell back). `null` until it is completed, and
+   * from a server older than the field.
+   */
+  rendered_as: external_exports.enum(["edit", "motion_transfer"]).nullable().default(null).describe("How the finished edit was made: motion_transfer, or edit (the regular editor). null until completed."),
   result: external_exports.object({ file_id: external_exports.string().startsWith("fil_") }).nullable(),
   error: external_exports.object({ code: EditFailureCodeSchema3, message: external_exports.string() }).nullable(),
   cost_micro_usd: MicroUsdField3.nullable(),
@@ -48955,12 +49093,11 @@ var media6 = {
       ...args.bool("loop") ? { loop: true } : {}
     })
   }),
-  // §55: `naive media edit "<prompt>" --video <fil_|url>`. `--wait` follows the edit job.
+  // §55: `naive media edit "<prompt>" --video <fil_|url>`. `--wait` follows the edit job. `--mode` is
+  // `edit` (the default) or a narrower mode, or `motion_transfer`, which copies the clip's exact motion onto
+  // the characters in the `--reference` photos (ADR-2410).
   edit: async ({ client, args }) => {
-    const mode = args.str("mode");
-    if (mode !== void 0 && mode !== "scene" && mode !== "outfit_or_object" && mode !== "person_swap" && mode !== "recast") {
-      throw new UsageError("--mode must be scene, outfit_or_object, person_swap or recast");
-    }
+    const mode = editMode(args.str("mode"));
     const references = args.list("reference");
     let job = await client.media.edits.create({
       video: args.need("video"),
@@ -48996,6 +49133,13 @@ var media6 = {
     })
   })
 };
+var EDIT_MODES = ["edit", "scene", "outfit_or_object", "person_swap", "recast", "motion_transfer"];
+function editMode(mode) {
+  if (mode === void 0) return void 0;
+  const known = EDIT_MODES.find((value) => value === mode);
+  if (known !== void 0) return known;
+  throw new UsageError("--mode must be edit, scene, outfit_or_object, person_swap, recast or motion_transfer");
+}
 function jobKind(kind) {
   if (kind === void 0 || kind === "video" || kind === "clip" || kind === "transcription" || kind === "mesh")
     return kind;
@@ -51479,7 +51623,8 @@ var FLAGS = {
     "sound-effect": "seconds loop",
     // core-gaps: U12-music — prompt is the positional; `--seconds` (3–300) and `--instrumental` are optional.
     music: "seconds instrumental",
-    // §55: a Mira edit. Prompt is the positional; `--video` is the clip, `--reference` repeats.
+    // §55: a Mira edit. Prompt is the positional; `--video` is the clip, `--reference` repeats; `--mode` is
+    // edit (default), scene, outfit_or_object, person_swap, recast or motion_transfer (ADR-2410).
     edit: "video reference mode wait",
     show: "",
     list: "kind status session limit after"
@@ -51875,7 +52020,7 @@ var ALIASES = {
 };
 
 // src/cli.ts
-var VERSION = true ? "1.0.2" : "0.0.0-dev";
+var VERSION = true ? "1.0.4" : "0.0.0-dev";
 var GLOBAL_FLAGS_HELP = "global flags: --json (default) --human --profile <name> --api-key <key> --org <org_id> --api-base-url <url>";
 function usage() {
   const groups = [...Object.keys(GROUPS), ...Object.keys(ALIASES)].sort().join(", ");
@@ -51949,9 +52094,13 @@ function clients(deps2, baseUrl) {
   const fetch = namingHost(deps2.fetch, baseUrl);
   return (apiKey) => createClient({ baseUrl, apiKey, fetch, idempotencyKey: deps2.idempotencyKey });
 }
+function argvKeyWarning(flag) {
+  return `warning: ${flag} leaves the key in shell history and, under npx, in ~/.npm/_logs; pipe it on stdin (read -rs KEY && printf '%s\\n' "$KEY" | naive login) or set NAIVE_API_KEY`;
+}
 async function run(argv, deps2) {
   const parsed = parseLine(argv);
   const first = parsed.words[0] ?? "";
+  let argvKey;
   try {
     if (parsed.args(2).bool("version")) {
       deps2.io.out(`naive ${VERSION} (api ${API_VERSION})`);
@@ -51972,6 +52121,8 @@ async function run(argv, deps2) {
     const args = parsed.args(sub2 ? 3 : alias ? 1 : 2);
     rejectUnknownFlags(args.names(), group, command);
     const config2 = resolveConfig(args, deps2.env, deps2.readConfig, { login: group === "auth" && command === "login" });
+    const claimKey = group === "naive" && command === "claim" && args.str("key") !== void 0;
+    argvKey = args.str("api-key") !== void 0 ? "--api-key" : claimKey ? "--key" : void 0;
     if (config2.apiKey === "" && group !== "auth" && group !== "naive") throw new UsageError(NO_API_KEY);
     const withApiKey = clients(deps2, config2.baseUrl);
     const human2 = args.bool("human");
@@ -51988,6 +52139,8 @@ async function run(argv, deps2) {
   } catch (cause) {
     deps2.io.err(describeError(cause));
     return exitForError(cause);
+  } finally {
+    if (argvKey !== void 0) deps2.io.err(argvKeyWarning(argvKey));
   }
 }
 

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@usenaive-sdk/cli",
-  "version": "1.0.2",
+  "version": "1.0.4",
   "description": "Naive Managed Agents command line — create agents, run sessions, watch events, see cost.",
   "license": "MIT",
   "type": "module",
@@ -27,8 +27,8 @@
     "esbuild": "0.28.2",
     "yaml": "^2.9.0",
     "@vetta/core": "0.0.0",
-    "@usenaive-sdk/managed-agents": "0.12.2",
-    "@usenaive-sdk/blueprints": "0.18.0"
+    "@usenaive-sdk/blueprints": "0.18.0",
+    "@usenaive-sdk/managed-agents": "0.12.4"
   },
   "scripts": {
     "build": "node build.mjs",