@usenaive-sdk/cli 1.0.1 → 1.0.3

package/dist/index.js

@@ -11953,7 +11953,7 @@ function resolveConfig(args, env2, readConfig, { login = false } = {}) {
       `unknown profile "${profile}"; run \`naive login --profile ${profile}\` first (add --api-base-url <url> for a non-production API)`
     );
   }
-  const given = set(args.str("api-key")) ?? set(env2["VETTA_API_KEY"]) ?? set(env2["NAIVE_API_KEY"]);
+  const given = set(args.str("api-key")) ?? set(env2["NAIVE_API_KEY"]) ?? set(env2["VETTA_API_KEY"]);
   return {
     profile,
     baseUrl,
@@ -26963,6 +26963,8 @@ var LedgerEntrySchema = external_exports.object({
   session_id: idOf("ses").nullable(),
   agent_id: idOf("agt").nullable(),
   deployment_id: idOf("dep").nullable(),
+  /** The computer (`cmp_`), browser (`brw_`) or phone (`mob_`) a debit bills; `null` for anything else, and from a server older than the field. */
+  resource_id: external_exports.string().nullable().default(null),
   line_items: external_exports.array(external_exports.object({ tier: LineItemTierSchema, amount_micro_usd: MicroUsdField })),
   created_at: Timestamp
 });
@@ -28421,7 +28423,11 @@ var transposed = (a, b) => {
 };
 function toolNameProblem(name6) {
   if (BUILTIN_TOOLS.includes(name6) || name6 in FOLLOWS_TOOL || PLATFORM_TOOLS.includes(name6)) return null;
-  if (!/^[a-z0-9_-]+(\.[a-z0-9_-]+)+$/i.test(name6)) return `\`${name6}\` is not a tool: name a built-in, or a namespaced \`<namespace>.<tool>\``;
+  if (!/^[a-z0-9_-]+(\.[a-z0-9_-]+)+$/i.test(name6)) {
+    const bare = [...BUILTIN_TOOLS, ...Object.keys(FOLLOWS_TOOL)].find((tool) => transposed(tool, name6));
+    const hint = bare === void 0 ? "name a built-in, or a namespaced `<namespace>.<tool>`" : `did you mean \`${bare}\`?`;
+    return `\`${name6}\` is not a tool; ${hint}`;
+  }
   const namespace = name6.slice(0, name6.indexOf("."));
   if (PLATFORM_NAMESPACES.has(namespace)) {
     const known = [...PLATFORM_TOOLS, ...Object.keys(FOLLOWS_TOOL)].filter((tool) => tool.startsWith(`${namespace}.`));
@@ -28432,7 +28438,8 @@ function toolNameProblem(name6) {
 }
 var isToolName = (name6) => toolNameProblem(name6) === null;
 var ToolConfigSchema = external_exports.object({
-  enabled: external_exports.boolean(),
+  /** Absent is enabled (ADR-1911): naming a tool to set its permission already says it is wanted. */
+  enabled: external_exports.boolean().default(true),
   permission: ToolPermissionSchema,
   config: external_exports.record(external_exports.string(), external_exports.unknown()).optional()
 });
@@ -28705,7 +28712,24 @@ var CREATOR_PROGRAM = {
     upload_token_minutes: 15,
     skill_max_bytes: 32 * 1024,
     /** The reviewer's install check (§42.5): the hard cap on its one session, never charged to the draft. */
-    review_check_budget_micro_usd: 5e6
+    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,
+      max_seconds: 15,
+      video_max_bytes: 95 * 1024 * 1024,
+      image_max_bytes: 10 * 1024 * 1024,
+      characters_min: 1,
+      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,
+      /** 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`. */
+      draft_retention_days: 30
+    }
   }
 };
 var DOOMSCROLL_PROGRAM = {
@@ -28749,6 +28773,8 @@ var StudioStateSchema = external_exports.enum([
   "setup",
   "building",
   "ready",
+  /** A `video` origin only: a version was submitted and its author is writing the skill. */
+  "finalizing",
   "in_review",
   "live",
   "changes_requested"
@@ -28812,10 +28838,26 @@ var StudioSkillSchema = SavedSkillSchema.extend({
   id: idOf("skl").nullable(),
   version: external_exports.number().int().positive().nullable()
 });
+var StudioImageContentTypeSchema = external_exports.enum(["image/png", "image/jpeg", "image/webp"]);
+var StudioSourceVideoSchema = external_exports.object({
+  file_id: external_exports.string().nullable(),
+  bytes: external_exports.number().int().positive().max(CREATOR_PROGRAM.studio.video.video_max_bytes),
+  content_type: StudioUploadContentTypeSchema,
+  filename: external_exports.string().min(1).max(200),
+  seconds: external_exports.number().nonnegative().nullable()
+});
+var CharacterPosition = external_exports.number().int().min(1).max(CREATOR_PROGRAM.studio.video.characters_max);
+var StudioCharacterSchema = external_exports.object({
+  position: CharacterPosition,
+  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)
+});
 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. */
-  origin: external_exports.enum(["upload", "links"]).default("upload"),
+  /** `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). */
+  origin: external_exports.enum(["upload", "links", "video"]).default("upload"),
   imports: external_exports.array(StudioImportSchema).max(CREATOR_PROGRAM.studio.uploads).default([]),
   state: StudioStateSchema.default("setup"),
   spend_micro_usd: MicroUsdField.nonnegative().default(0),
@@ -28826,7 +28868,11 @@ var CreatorStudioSchema = external_exports.object({
   /** An org build's asked sample length (§57.2, ADR-1762); `null` is `sample_seconds`. */
   seconds: external_exports.number().int().min(10).max(60).nullable().default(null),
   /** An org build's own catalog text: its request's description when that fits a tagline; `null` lets the judge write one. */
-  tagline: external_exports.string().max(140).nullable().default(null)
+  tagline: external_exports.string().max(140).nullable().default(null),
+  /** 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)
 });
 var CreatorTemplateListingSchema = external_exports.object({
   listed: external_exports.boolean(),
@@ -28880,7 +28926,15 @@ var CreatorTemplateRoundSchema = external_exports.object({
   spend_micro_usd: MicroUsdField.nonnegative(),
   error: external_exports.string().nullable(),
   created_at: Timestamp,
-  finished_at: Timestamp.nullable()
+  finished_at: Timestamp.nullable(),
+  /** A `video` origin round's Mira edit and its result (migration 0172, §42.14). */
+  edit_job_id: external_exports.string().nullable().default(null),
+  sample_file_id: external_exports.string().nullable().default(null)
+});
+var StudioPlateSchema = external_exports.object({
+  file: external_exports.string().min(1),
+  kind: external_exports.enum(["video", "image"]),
+  file_id: external_exports.string().min(1)
 });
 var NicheVersionStudioSchema = external_exports.object({
   round: external_exports.number().int().positive(),
@@ -28889,7 +28943,9 @@ var NicheVersionStudioSchema = external_exports.object({
   frames: external_exports.array(StudioFrameSchema),
   samples: external_exports.array(StudioSampleSchema),
   tagline: external_exports.string().max(140),
-  hero_sample_index: external_exports.number().int().nonnegative()
+  hero_sample_index: external_exports.number().int().nonnegative(),
+  /** A `video` origin's default clip and characters. */
+  plates: external_exports.array(StudioPlateSchema).optional()
 });
 var CreatorTemplateSchema = external_exports.object({
   id: idOf("ctp"),
@@ -28986,13 +29042,26 @@ var CreatorAnalyticsSchema = external_exports.object({
   install_windows: external_exports.array(external_exports.object({ install_id: idOf("bpi"), from: Day, until: Day })).optional()
 });
 var CreatorTemplateCreateKindSchema = external_exports.object({
-  kind: CreatorTemplateKindSchema.default("crew")
+  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()
 });
 var StudioUploadCreateSchema = external_exports.object({
-  position: UploadPosition,
+  purpose: external_exports.enum(["source", "character"]).optional(),
+  position: UploadPosition.optional(),
   filename: external_exports.string().min(1).max(200),
-  content_type: StudioUploadContentTypeSchema,
-  bytes: external_exports.number().int().positive().max(CREATOR_PROGRAM.studio.upload_max_bytes)
+  content_type: external_exports.union([StudioUploadContentTypeSchema, StudioImageContentTypeSchema]),
+  bytes: external_exports.number().int().positive()
+}).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 (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");
+  }
+  const max = character2 ? video.image_max_bytes : body2.purpose === "source" ? video.video_max_bytes : upload_max_bytes;
+  if (body2.bytes > max) issue2("bytes", `this upload may be at most ${max} bytes`);
 });
 var StudioUploadTicketSchema = external_exports.object({
   object: external_exports.literal("studio_upload_ticket"),
@@ -29006,6 +29075,12 @@ var StudioUploadResultSchema = external_exports.object({
   template_id: idOf("ctp"),
   upload: StudioUploadSchema
 });
+var StudioVideoUploadResultSchema = external_exports.object({
+  object: external_exports.literal("studio_upload"),
+  template_id: idOf("ctp"),
+  source_video: StudioSourceVideoSchema.nullable(),
+  characters: external_exports.array(StudioCharacterSchema)
+});
 var StudioRoundCreateSchema = external_exports.object({
   feedback: external_exports.string().min(1).max(4e3).optional(),
   rights_attested: external_exports.boolean().optional()
@@ -29018,9 +29093,12 @@ var StudioBudgetSchema = external_exports.object({
 var CreatorStudioViewSchema = external_exports.object({
   object: external_exports.literal("creator_studio"),
   template_id: idOf("ctp"),
-  studio: CreatorStudioSchema,
-  /** Newest first. */
-  rounds: external_exports.array(CreatorTemplateRoundSchema),
+  /** A `video` origin's `source_video` also carries a signed `url` once its bytes landed. */
+  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() })),
   budget: StudioBudgetSchema
 });
 var NicheSubmitSchema = external_exports.object({
@@ -29030,6 +29108,7 @@ var NicheSubmitSchema = external_exports.object({
     hero_sample_index: external_exports.number().int().nonnegative()
   })
 });
+var VideoSubmitSchema = external_exports.object({ round: external_exports.number().int().positive() });
 var CreatorListingPatchSchema = CreatorTemplateListingSchema.partial();
 var CreatorListingSchema = external_exports.object({
   object: external_exports.literal("creator_listing"),
@@ -29255,6 +29334,10 @@ var EventTypeSchema = external_exports.enum([
   "span.harness_build.end",
   "span.box_resume.start",
   "span.box_resume.end",
+  "span.tools_resolve.start",
+  "span.tools_resolve.end",
+  "span.model_gate.start",
+  "span.model_gate.end",
   /**
    * A delegated thread's lifecycle, on the **coordinator's** stream (§28). The child's own
    * `ses_…` rides inside `data.thread_id` — the event schema gains no field and `vetta.event` gains
@@ -30865,11 +30948,12 @@ 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 EditRequestSchema = external_exports.object({
   video: external_exports.string().min(1),
   prompt: external_exports.string().min(1).max(1e3),
   references: external_exports.array(external_exports.string().min(1)).max(4).optional(),
-  mode: external_exports.enum(["scene", "outfit_or_object", "person_swap"]).optional()
+  mode: EditModeSchema.optional()
 });
 var EditFailureCodeSchema = external_exports.enum(["bad_source", "refused", "timed_out", "provider_error", "cancelled"]);
 var EditJobSchema = external_exports.object({
@@ -30879,7 +30963,7 @@ var EditJobSchema = external_exports.object({
   video: external_exports.string(),
   prompt: external_exports.string(),
   references: external_exports.array(external_exports.string()),
-  mode: external_exports.enum(["scene", "outfit_or_object", "person_swap"]).nullable(),
+  mode: EditModeSchema.nullable(),
   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(),
@@ -32286,6 +32370,8 @@ var LedgerEntrySchema2 = external_exports.object({
   session_id: idOf2("ses").nullable(),
   agent_id: idOf2("agt").nullable(),
   deployment_id: idOf2("dep").nullable(),
+  /** The computer (`cmp_`), browser (`brw_`) or phone (`mob_`) a debit bills; `null` for anything else, and from a server older than the field. */
+  resource_id: external_exports.string().nullable().default(null),
   line_items: external_exports.array(external_exports.object({ tier: LineItemTierSchema2, amount_micro_usd: MicroUsdField2 })),
   created_at: Timestamp2
 });
@@ -33720,7 +33806,11 @@ var transposed2 = (a, b) => {
 };
 function toolNameProblem2(name6) {
   if (BUILTIN_TOOLS2.includes(name6) || name6 in FOLLOWS_TOOL2 || PLATFORM_TOOLS2.includes(name6)) return null;
-  if (!/^[a-z0-9_-]+(\.[a-z0-9_-]+)+$/i.test(name6)) return `\`${name6}\` is not a tool: name a built-in, or a namespaced \`<namespace>.<tool>\``;
+  if (!/^[a-z0-9_-]+(\.[a-z0-9_-]+)+$/i.test(name6)) {
+    const bare = [...BUILTIN_TOOLS2, ...Object.keys(FOLLOWS_TOOL2)].find((tool) => transposed2(tool, name6));
+    const hint = bare === void 0 ? "name a built-in, or a namespaced `<namespace>.<tool>`" : `did you mean \`${bare}\`?`;
+    return `\`${name6}\` is not a tool; ${hint}`;
+  }
   const namespace = name6.slice(0, name6.indexOf("."));
   if (PLATFORM_NAMESPACES2.has(namespace)) {
     const known = [...PLATFORM_TOOLS2, ...Object.keys(FOLLOWS_TOOL2)].filter((tool) => tool.startsWith(`${namespace}.`));
@@ -33731,7 +33821,8 @@ function toolNameProblem2(name6) {
 }
 var isToolName2 = (name6) => toolNameProblem2(name6) === null;
 var ToolConfigSchema2 = external_exports.object({
-  enabled: external_exports.boolean(),
+  /** Absent is enabled (ADR-1911): naming a tool to set its permission already says it is wanted. */
+  enabled: external_exports.boolean().default(true),
   permission: ToolPermissionSchema2,
   config: external_exports.record(external_exports.string(), external_exports.unknown()).optional()
 });
@@ -33991,7 +34082,24 @@ var CREATOR_PROGRAM2 = {
     upload_token_minutes: 15,
     skill_max_bytes: 32 * 1024,
     /** The reviewer's install check (§42.5): the hard cap on its one session, never charged to the draft. */
-    review_check_budget_micro_usd: 5e6
+    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,
+      max_seconds: 15,
+      video_max_bytes: 95 * 1024 * 1024,
+      image_max_bytes: 10 * 1024 * 1024,
+      characters_min: 1,
+      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,
+      /** 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`. */
+      draft_retention_days: 30
+    }
   }
 };
 var DOOMSCROLL_PROGRAM2 = {
@@ -34035,6 +34143,8 @@ var StudioStateSchema2 = external_exports.enum([
   "setup",
   "building",
   "ready",
+  /** A `video` origin only: a version was submitted and its author is writing the skill. */
+  "finalizing",
   "in_review",
   "live",
   "changes_requested"
@@ -34098,10 +34208,26 @@ var StudioSkillSchema2 = SavedSkillSchema2.extend({
   id: idOf2("skl").nullable(),
   version: external_exports.number().int().positive().nullable()
 });
+var StudioImageContentTypeSchema2 = external_exports.enum(["image/png", "image/jpeg", "image/webp"]);
+var StudioSourceVideoSchema2 = external_exports.object({
+  file_id: external_exports.string().nullable(),
+  bytes: external_exports.number().int().positive().max(CREATOR_PROGRAM2.studio.video.video_max_bytes),
+  content_type: StudioUploadContentTypeSchema2,
+  filename: external_exports.string().min(1).max(200),
+  seconds: external_exports.number().nonnegative().nullable()
+});
+var CharacterPosition2 = external_exports.number().int().min(1).max(CREATOR_PROGRAM2.studio.video.characters_max);
+var StudioCharacterSchema2 = external_exports.object({
+  position: CharacterPosition2,
+  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)
+});
 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. */
-  origin: external_exports.enum(["upload", "links"]).default("upload"),
+  /** `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). */
+  origin: external_exports.enum(["upload", "links", "video"]).default("upload"),
   imports: external_exports.array(StudioImportSchema2).max(CREATOR_PROGRAM2.studio.uploads).default([]),
   state: StudioStateSchema2.default("setup"),
   spend_micro_usd: MicroUsdField2.nonnegative().default(0),
@@ -34112,7 +34238,11 @@ var CreatorStudioSchema2 = external_exports.object({
   /** An org build's asked sample length (§57.2, ADR-1762); `null` is `sample_seconds`. */
   seconds: external_exports.number().int().min(10).max(60).nullable().default(null),
   /** An org build's own catalog text: its request's description when that fits a tagline; `null` lets the judge write one. */
-  tagline: external_exports.string().max(140).nullable().default(null)
+  tagline: external_exports.string().max(140).nullable().default(null),
+  /** 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)
 });
 var CreatorTemplateListingSchema2 = external_exports.object({
   listed: external_exports.boolean(),
@@ -34166,7 +34296,15 @@ var CreatorTemplateRoundSchema2 = external_exports.object({
   spend_micro_usd: MicroUsdField2.nonnegative(),
   error: external_exports.string().nullable(),
   created_at: Timestamp2,
-  finished_at: Timestamp2.nullable()
+  finished_at: Timestamp2.nullable(),
+  /** A `video` origin round's Mira edit and its result (migration 0172, §42.14). */
+  edit_job_id: external_exports.string().nullable().default(null),
+  sample_file_id: external_exports.string().nullable().default(null)
+});
+var StudioPlateSchema2 = external_exports.object({
+  file: external_exports.string().min(1),
+  kind: external_exports.enum(["video", "image"]),
+  file_id: external_exports.string().min(1)
 });
 var NicheVersionStudioSchema2 = external_exports.object({
   round: external_exports.number().int().positive(),
@@ -34175,7 +34313,9 @@ var NicheVersionStudioSchema2 = external_exports.object({
   frames: external_exports.array(StudioFrameSchema2),
   samples: external_exports.array(StudioSampleSchema2),
   tagline: external_exports.string().max(140),
-  hero_sample_index: external_exports.number().int().nonnegative()
+  hero_sample_index: external_exports.number().int().nonnegative(),
+  /** A `video` origin's default clip and characters. */
+  plates: external_exports.array(StudioPlateSchema2).optional()
 });
 var CreatorTemplateSchema2 = external_exports.object({
   id: idOf2("ctp"),
@@ -34272,13 +34412,26 @@ var CreatorAnalyticsSchema2 = external_exports.object({
   install_windows: external_exports.array(external_exports.object({ install_id: idOf2("bpi"), from: Day3, until: Day3 })).optional()
 });
 var CreatorTemplateCreateKindSchema2 = external_exports.object({
-  kind: CreatorTemplateKindSchema2.default("crew")
+  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()
 });
 var StudioUploadCreateSchema2 = external_exports.object({
-  position: UploadPosition2,
+  purpose: external_exports.enum(["source", "character"]).optional(),
+  position: UploadPosition2.optional(),
   filename: external_exports.string().min(1).max(200),
-  content_type: StudioUploadContentTypeSchema2,
-  bytes: external_exports.number().int().positive().max(CREATOR_PROGRAM2.studio.upload_max_bytes)
+  content_type: external_exports.union([StudioUploadContentTypeSchema2, StudioImageContentTypeSchema2]),
+  bytes: external_exports.number().int().positive()
+}).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 (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");
+  }
+  const max = character2 ? video.image_max_bytes : body2.purpose === "source" ? video.video_max_bytes : upload_max_bytes;
+  if (body2.bytes > max) issue2("bytes", `this upload may be at most ${max} bytes`);
 });
 var StudioUploadTicketSchema2 = external_exports.object({
   object: external_exports.literal("studio_upload_ticket"),
@@ -34292,6 +34445,12 @@ var StudioUploadResultSchema2 = external_exports.object({
   template_id: idOf2("ctp"),
   upload: StudioUploadSchema2
 });
+var StudioVideoUploadResultSchema2 = external_exports.object({
+  object: external_exports.literal("studio_upload"),
+  template_id: idOf2("ctp"),
+  source_video: StudioSourceVideoSchema2.nullable(),
+  characters: external_exports.array(StudioCharacterSchema2)
+});
 var StudioRoundCreateSchema2 = external_exports.object({
   feedback: external_exports.string().min(1).max(4e3).optional(),
   rights_attested: external_exports.boolean().optional()
@@ -34304,9 +34463,12 @@ var StudioBudgetSchema2 = external_exports.object({
 var CreatorStudioViewSchema2 = external_exports.object({
   object: external_exports.literal("creator_studio"),
   template_id: idOf2("ctp"),
-  studio: CreatorStudioSchema2,
-  /** Newest first. */
-  rounds: external_exports.array(CreatorTemplateRoundSchema2),
+  /** A `video` origin's `source_video` also carries a signed `url` once its bytes landed. */
+  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() })),
   budget: StudioBudgetSchema2
 });
 var NicheSubmitSchema2 = external_exports.object({
@@ -34316,6 +34478,7 @@ var NicheSubmitSchema2 = external_exports.object({
     hero_sample_index: external_exports.number().int().nonnegative()
   })
 });
+var VideoSubmitSchema2 = external_exports.object({ round: external_exports.number().int().positive() });
 var CreatorListingPatchSchema2 = CreatorTemplateListingSchema2.partial();
 var CreatorListingSchema2 = external_exports.object({
   object: external_exports.literal("creator_listing"),
@@ -34535,6 +34698,10 @@ var EventTypeSchema2 = external_exports.enum([
   "span.harness_build.end",
   "span.box_resume.start",
   "span.box_resume.end",
+  "span.tools_resolve.start",
+  "span.tools_resolve.end",
+  "span.model_gate.start",
+  "span.model_gate.end",
   /**
    * A delegated thread's lifecycle, on the **coordinator's** stream (§28). The child's own
    * `ses_…` rides inside `data.thread_id` — the event schema gains no field and `vetta.event` gains
@@ -36108,11 +36275,12 @@ 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 EditRequestSchema2 = external_exports.object({
   video: external_exports.string().min(1),
   prompt: external_exports.string().min(1).max(1e3),
   references: external_exports.array(external_exports.string().min(1)).max(4).optional(),
-  mode: external_exports.enum(["scene", "outfit_or_object", "person_swap"]).optional()
+  mode: EditModeSchema2.optional()
 });
 var EditFailureCodeSchema2 = external_exports.enum(["bad_source", "refused", "timed_out", "provider_error", "cancelled"]);
 var EditJobSchema2 = external_exports.object({
@@ -36122,7 +36290,7 @@ var EditJobSchema2 = external_exports.object({
   video: external_exports.string(),
   prompt: external_exports.string(),
   references: external_exports.array(external_exports.string()),
-  mode: external_exports.enum(["scene", "outfit_or_object", "person_swap"]).nullable(),
+  mode: EditModeSchema2.nullable(),
   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(),
@@ -37096,6 +37264,11 @@ function tolerantPage(item) {
   });
 }
 var DOT_SEGMENT = /^(?:\.|%2e){1,2}$/i;
+function pathId(value, name6) {
+  if (value !== void 0 && value !== null && String(value) !== "") return encodeURIComponent(value);
+  const message4 = `${name6} is required`;
+  throw new ApiError(400, { type: "invalid_request", code: "validation_failed", message: message4, param: name6, request_id: "" });
+}
 function url2(config2, call) {
   const segments = call.path.split("/");
   if (segments.some((segment) => DOT_SEGMENT.test(segment)) || segments.at(-1) === "") {
@@ -37924,77 +38097,77 @@ var domains = (config2) => ({
   delete: (id) => request(config2, DeletedSchema, { method: "DELETE", path: `/v1/domains/${encodeURIComponent(id)}` })
 });
 var emails = (config2) => ({
-  create: (identityId, body2) => request(config2, EmailInboxSchema2, {
+  create: async (identityId, body2) => request(config2, EmailInboxSchema2, {
     method: "POST",
-    path: `/v1/identities/${encodeURIComponent(identityId)}/emails`,
+    path: `/v1/identities/${pathId(identityId, "identityId")}/emails`,
     body: body2
   }),
-  list: (identityId, query2 = {}) => request(config2, page(EmailInboxSchema2), {
+  list: async (identityId, query2 = {}) => request(config2, page(EmailInboxSchema2), {
     method: "GET",
-    path: `/v1/identities/${encodeURIComponent(identityId)}/emails`,
+    path: `/v1/identities/${pathId(identityId, "identityId")}/emails`,
     query: query2
   }),
   /** Turn on or off whether mail to the inbox wakes its owner. An inbox from before the wake shipped is off. */
-  update: (identityId, inboxId, body2) => request(config2, EmailInboxSchema2, {
+  update: async (identityId, inboxId, body2) => request(config2, EmailInboxSchema2, {
     method: "PATCH",
-    path: `/v1/identities/${encodeURIComponent(identityId)}/emails/${encodeURIComponent(inboxId)}`,
+    path: `/v1/identities/${pathId(identityId, "identityId")}/emails/${encodeURIComponent(inboxId)}`,
     body: body2
   }),
-  delete: (identityId, inboxId) => request(config2, DeletedSchema, {
+  delete: async (identityId, inboxId) => request(config2, DeletedSchema, {
     method: "DELETE",
-    path: `/v1/identities/${encodeURIComponent(identityId)}/emails/${encodeURIComponent(inboxId)}`
+    path: `/v1/identities/${pathId(identityId, "identityId")}/emails/${encodeURIComponent(inboxId)}`
   }),
   /** Gated on the domain's `dns_status`; a premature send is a retryable `job_not_ready`. */
-  send: (identityId, inboxId, body2) => request(config2, EmailSendSchema, {
+  send: async (identityId, inboxId, body2) => request(config2, EmailSendSchema, {
     method: "POST",
-    path: `/v1/identities/${encodeURIComponent(identityId)}/emails/${encodeURIComponent(inboxId)}/send`,
+    path: `/v1/identities/${pathId(identityId, "identityId")}/emails/${encodeURIComponent(inboxId)}/send`,
     body: body2
   }),
   /** Everything that arrived for this persona, both channels unless one is named. */
-  messages: (identityId, query2 = {}) => request(config2, page(InboundMessageSchema2), {
+  messages: async (identityId, query2 = {}) => request(config2, page(InboundMessageSchema2), {
     method: "GET",
-    path: `/v1/identities/${encodeURIComponent(identityId)}/messages`,
+    path: `/v1/identities/${pathId(identityId, "identityId")}/messages`,
     query: query2
   }),
   /** Mark one arrived message read or unread; a message already read keeps its first time. */
-  markRead: (identityId, messageId, read) => request(config2, InboundMessageSchema2, {
+  markRead: async (identityId, messageId, read) => request(config2, InboundMessageSchema2, {
     method: "POST",
-    path: `/v1/identities/${encodeURIComponent(identityId)}/messages/${encodeURIComponent(messageId)}/read`,
+    path: `/v1/identities/${pathId(identityId, "identityId")}/messages/${encodeURIComponent(messageId)}/read`,
     body: { read }
   }),
   /** What the persona sent, newest first — through the API and through its agent alike. */
-  sent: (identityId, query2 = {}) => request(config2, page(OutboundMessageSchema2), {
+  sent: async (identityId, query2 = {}) => request(config2, page(OutboundMessageSchema2), {
     method: "GET",
-    path: `/v1/identities/${encodeURIComponent(identityId)}/sent`,
+    path: `/v1/identities/${pathId(identityId, "identityId")}/sent`,
     query: query2
   })
 });
 var phones = (config2) => ({
   /** 202, not 201: the number exists and can receive, but outbound waits on a carrier decision. */
-  provision: (identityId, body2) => request(config2, PhoneNumberSchema2, {
+  provision: async (identityId, body2) => request(config2, PhoneNumberSchema2, {
     method: "POST",
-    path: `/v1/identities/${encodeURIComponent(identityId)}/phones`,
+    path: `/v1/identities/${pathId(identityId, "identityId")}/phones`,
     body: body2
   }),
-  list: (identityId, query2 = {}) => request(config2, page(PhoneNumberSchema2), {
+  list: async (identityId, query2 = {}) => request(config2, page(PhoneNumberSchema2), {
     method: "GET",
-    path: `/v1/identities/${encodeURIComponent(identityId)}/phones`,
+    path: `/v1/identities/${pathId(identityId, "identityId")}/phones`,
     query: query2
   }),
   /** Set, or clear with `null`, the agent this number's inbound texts are for. */
-  update: (identityId, phoneId, body2) => request(config2, PhoneNumberSchema2, {
+  update: async (identityId, phoneId, body2) => request(config2, PhoneNumberSchema2, {
     method: "PATCH",
-    path: `/v1/identities/${encodeURIComponent(identityId)}/phones/${encodeURIComponent(phoneId)}`,
+    path: `/v1/identities/${pathId(identityId, "identityId")}/phones/${encodeURIComponent(phoneId)}`,
     body: body2
   }),
-  release: (identityId, phoneId) => request(config2, DeletedSchema, {
+  release: async (identityId, phoneId) => request(config2, DeletedSchema, {
     method: "DELETE",
-    path: `/v1/identities/${encodeURIComponent(identityId)}/phones/${encodeURIComponent(phoneId)}`
+    path: `/v1/identities/${pathId(identityId, "identityId")}/phones/${encodeURIComponent(phoneId)}`
   }),
   /** Refused with `compliance_pending` until the campaign is approved. That is a carrier rule. */
-  send: (identityId, phoneId, body2) => request(config2, SmsSendSchema, {
+  send: async (identityId, phoneId, body2) => request(config2, SmsSendSchema, {
     method: "POST",
-    path: `/v1/identities/${encodeURIComponent(identityId)}/phones/${encodeURIComponent(phoneId)}/send`,
+    path: `/v1/identities/${pathId(identityId, "identityId")}/phones/${encodeURIComponent(phoneId)}/send`,
     body: body2
   })
 });
@@ -38557,7 +38730,7 @@ var wallet = (config2) => {
     updatePolicy: (identity3, body2, select3 = {}) => request(config2, WalletSchema2, { method: "PATCH", path: `/v1/identities/${encodeURIComponent(identity3)}/wallet/policy`, body: body2, query: select3 }),
     freeze: (identity3, select3 = {}) => request(config2, WalletSchema2, { method: "POST", path: `/v1/identities/${encodeURIComponent(identity3)}/wallet/freeze`, query: select3 }),
     unfreeze: (identity3, select3 = {}) => request(config2, WalletSchema2, { method: "POST", path: `/v1/identities/${encodeURIComponent(identity3)}/wallet/unfreeze`, query: select3 }),
-    /** The three money moves take an `idempotencyKey` so a retry of one move reuses its key and moves the money once. */
+    /** The money moves (and `pay`) take an `idempotencyKey` so a retry of one move reuses its key and moves the money once. */
     fund: (identity3, body2, select3 = {}, opts = {}) => request(config2, WalletTransactionSchema2, { method: "POST", path: `/v1/identities/${encodeURIComponent(identity3)}/wallet/fund`, body: body2, query: select3, headers: keyed(opts) }),
     transfer: (identity3, body2, select3 = {}, opts = {}) => request(config2, WalletTransactionSchema2, { method: "POST", path: `/v1/identities/${encodeURIComponent(identity3)}/wallet/transfer`, body: body2, query: select3, headers: keyed(opts) }),
     sweep: (identity3, body2 = {}, select3 = {}, opts = {}) => request(config2, WalletTransactionSchema2, { method: "POST", path: `/v1/identities/${encodeURIComponent(identity3)}/wallet/sweep`, body: body2, query: select3, headers: keyed(opts) }),
@@ -38569,7 +38742,7 @@ var wallet = (config2) => {
       query: { ...query2, kind: "pay" }
     }),
     quote: (identity3, body2, select3 = {}) => request(config2, WalletQuoteSchema2, { method: "POST", path: `/v1/identities/${encodeURIComponent(identity3)}/wallet/quote`, body: body2, query: select3 }),
-    pay: (identity3, body2, select3 = {}) => request(config2, WalletPaymentSchema2, { method: "POST", path: `/v1/identities/${encodeURIComponent(identity3)}/wallet/pay`, body: body2, query: select3 })
+    pay: (identity3, body2, select3 = {}, opts = {}) => request(config2, WalletPaymentSchema2, { method: "POST", path: `/v1/identities/${encodeURIComponent(identity3)}/wallet/pay`, body: body2, query: select3, headers: keyed(opts) })
   };
 };
 var GrantSchema = external_exports.object({
@@ -38764,65 +38937,65 @@ var SocialWorkspaceSchema = external_exports.object({
 });
 var SocialPortalSchema = external_exports.object({ object: external_exports.literal("social_portal_link"), url: external_exports.url() });
 var setup = (config2) => ({
-  activate: (identity3) => request(config2, SocialWorkspaceSchema, {
+  activate: async (identity3) => request(config2, SocialWorkspaceSchema, {
     method: "POST",
-    path: `/v1/identities/${encodeURIComponent(identity3)}/social/activate`
+    path: `/v1/identities/${pathId(identity3, "identity")}/social/activate`
   }),
-  status: (identity3) => request(config2, SocialWorkspaceSchema, {
+  status: async (identity3) => request(config2, SocialWorkspaceSchema, {
     method: "GET",
-    path: `/v1/identities/${encodeURIComponent(identity3)}/social`
+    path: `/v1/identities/${pathId(identity3, "identity")}/social`
   }),
-  portal: (identity3, body2 = {}) => request(config2, SocialPortalSchema, {
+  portal: async (identity3, body2 = {}) => request(config2, SocialPortalSchema, {
     method: "POST",
-    path: `/v1/identities/${encodeURIComponent(identity3)}/social/portal`,
+    path: `/v1/identities/${pathId(identity3, "identity")}/social/portal`,
     body: body2
   }),
-  accounts: (identity3, query2 = {}) => request(config2, page(SocialAccountSchema2), {
+  accounts: async (identity3, query2 = {}) => request(config2, page(SocialAccountSchema2), {
     method: "GET",
-    path: `/v1/identities/${encodeURIComponent(identity3)}/social/accounts`,
+    path: `/v1/identities/${pathId(identity3, "identity")}/social/accounts`,
     query: query2
   }),
-  accountAnalytics: (identity3, account) => request(config2, SocialAnalyticsSchema2, {
+  accountAnalytics: async (identity3, account) => request(config2, SocialAnalyticsSchema2, {
     method: "GET",
-    path: `/v1/identities/${encodeURIComponent(identity3)}/social/accounts/${encodeURIComponent(account)}/analytics`
+    path: `/v1/identities/${pathId(identity3, "identity")}/social/accounts/${encodeURIComponent(account)}/analytics`
   }),
-  upload: (identity3, body2) => request(config2, SocialUploadSchema2, {
+  upload: async (identity3, body2) => request(config2, SocialUploadSchema2, {
     method: "POST",
-    path: `/v1/identities/${encodeURIComponent(identity3)}/social/uploads`,
+    path: `/v1/identities/${pathId(identity3, "identity")}/social/uploads`,
     body: body2
   })
 });
 var publishing = (config2) => ({
-  createPost: (identity3, body2) => request(config2, SocialPostSchema2, {
+  createPost: async (identity3, body2) => request(config2, SocialPostSchema2, {
     method: "POST",
-    path: `/v1/identities/${encodeURIComponent(identity3)}/social/posts`,
+    path: `/v1/identities/${pathId(identity3, "identity")}/social/posts`,
     body: body2
   }),
-  getPost: (identity3, post2) => request(config2, SocialPostSchema2, {
+  getPost: async (identity3, post2) => request(config2, SocialPostSchema2, {
     method: "GET",
-    path: `/v1/identities/${encodeURIComponent(identity3)}/social/posts/${encodeURIComponent(post2)}`
+    path: `/v1/identities/${pathId(identity3, "identity")}/social/posts/${encodeURIComponent(post2)}`
   }),
-  deletePost: (identity3, post2) => request(config2, DeletedSchema, {
+  deletePost: async (identity3, post2) => request(config2, DeletedSchema, {
     method: "DELETE",
-    path: `/v1/identities/${encodeURIComponent(identity3)}/social/posts/${encodeURIComponent(post2)}`
+    path: `/v1/identities/${pathId(identity3, "identity")}/social/posts/${encodeURIComponent(post2)}`
   }),
-  postAnalytics: (identity3, post2) => request(config2, SocialAnalyticsSchema2, {
+  postAnalytics: async (identity3, post2) => request(config2, SocialAnalyticsSchema2, {
     method: "GET",
-    path: `/v1/identities/${encodeURIComponent(identity3)}/social/posts/${encodeURIComponent(post2)}/analytics`
+    path: `/v1/identities/${pathId(identity3, "identity")}/social/posts/${encodeURIComponent(post2)}/analytics`
   }),
   /**
    * `GET /v1/posts` — every post the company files, across identities and sessions (§27.1): the
    * `social.post` calls waiting on a person (`pending`), and the ones sent, with their latest numbers.
    * `reconcile: false` lists what is stored without asking the provider about due posts first.
    */
-  listPosts: ({ reconcile, ...query2 } = {}) => request(config2, page(PostSchema2), {
+  listPosts: async ({ reconcile, ...query2 } = {}) => request(config2, page(PostSchema2), {
     method: "GET",
     path: "/v1/posts",
     query: { ...query2, ...reconcile === void 0 ? {} : { reconcile: String(reconcile) } }
   }),
-  comments: (identity3, post2, query2 = {}) => request(config2, page(SocialCommentSchema2), {
+  comments: async (identity3, post2, query2 = {}) => request(config2, page(SocialCommentSchema2), {
     method: "GET",
-    path: `/v1/identities/${encodeURIComponent(identity3)}/social/posts/${encodeURIComponent(post2)}/comments`,
+    path: `/v1/identities/${pathId(identity3, "identity")}/social/posts/${encodeURIComponent(post2)}/comments`,
     query: query2
   })
 });
@@ -38981,10 +39154,10 @@ async function* streamFrames(config2, schema, call) {
     yield parsed.data;
   }
 }
-function settled(session2, afterSeq, throughGrades) {
-  if (session2.status === "running" || session2.status === "queued") return false;
-  if (throughGrades && session2.stop_reason === "awaiting_delegation") return false;
-  return session2.last_seq <= afterSeq;
+function settledAt(session2, throughGrades) {
+  if (session2.status === "running" || session2.status === "queued") return null;
+  if (throughGrades && session2.stop_reason === "awaiting_delegation") return null;
+  return session2.last_seq;
 }
 async function* streamEvents(config2, sessionId, options = {}) {
   const maxRetries = options.maxRetries ?? 5;
@@ -38993,7 +39166,8 @@ async function* streamEvents(config2, sessionId, options = {}) {
   let failures = 0;
   const grading = /* @__PURE__ */ new Set();
   let held = false;
-  if (lastSeq > 0 && settled(await sessions(config2).get(sessionId), lastSeq, throughGrades)) return;
+  const endAt = lastSeq > 0 ? settledAt(await sessions(config2).get(sessionId), throughGrades) : null;
+  if (endAt !== null && endAt <= lastSeq) return;
   for (; ; ) {
     try {
       const call = {
@@ -39011,6 +39185,7 @@ async function* streamEvents(config2, sessionId, options = {}) {
         if (event.type === "outcome.evaluation.started") grading.add(gradeKey(event));
         if (event.type === "outcome.evaluation.completed") grading.delete(gradeKey(event));
         yield event;
+        if (endAt !== null && event.seq >= endAt) return;
         if (event.type === "session.idle") {
           held = throughGrades && grading.size > 0 && parkedOnGrade(event);
           if (!held) return;
@@ -39041,6 +39216,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 }),
@@ -39050,11 +39240,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",
@@ -39080,7 +39273,7 @@ var computers = (config2) => ({
     path: `/v1/computers/${encodeURIComponent(id)}/exec`,
     body: { command, ...timeoutMs === void 0 ? {} : { timeout_ms: timeoutMs } }
   }),
-  /** Paused bills storage only — the first efficiency lever (`memory/context.md`). */
+  /** Paused bills nothing (disk is never metered) — the first efficiency lever (`memory/context.md`). */
   pause: (id) => request(config2, ComputerSchema2, { method: "POST", path: `/v1/computers/${encodeURIComponent(id)}/pause`, body: {} }),
   resume: (id) => request(config2, ComputerSchema2, { method: "POST", path: `/v1/computers/${encodeURIComponent(id)}/resume`, body: {} }),
   /** An agent's computer only (§41.8): a person holds it, and its sessions wait until it is handed back. */
@@ -41065,6 +41258,8 @@ var LedgerEntrySchema3 = external_exports.object({
   session_id: idOf3("ses").nullable(),
   agent_id: idOf3("agt").nullable(),
   deployment_id: idOf3("dep").nullable(),
+  /** The computer (`cmp_`), browser (`brw_`) or phone (`mob_`) a debit bills; `null` for anything else, and from a server older than the field. */
+  resource_id: external_exports.string().nullable().default(null),
   line_items: external_exports.array(external_exports.object({ tier: LineItemTierSchema3, amount_micro_usd: MicroUsdField3 })),
   created_at: Timestamp3
 });
@@ -42609,7 +42804,11 @@ var transposed3 = (a, b) => {
 };
 function toolNameProblem3(name6) {
   if (BUILTIN_TOOLS3.includes(name6) || name6 in FOLLOWS_TOOL3 || PLATFORM_TOOLS3.includes(name6)) return null;
-  if (!/^[a-z0-9_-]+(\.[a-z0-9_-]+)+$/i.test(name6)) return `\`${name6}\` is not a tool: name a built-in, or a namespaced \`<namespace>.<tool>\``;
+  if (!/^[a-z0-9_-]+(\.[a-z0-9_-]+)+$/i.test(name6)) {
+    const bare = [...BUILTIN_TOOLS3, ...Object.keys(FOLLOWS_TOOL3)].find((tool) => transposed3(tool, name6));
+    const hint = bare === void 0 ? "name a built-in, or a namespaced `<namespace>.<tool>`" : `did you mean \`${bare}\`?`;
+    return `\`${name6}\` is not a tool; ${hint}`;
+  }
   const namespace = name6.slice(0, name6.indexOf("."));
   if (PLATFORM_NAMESPACES3.has(namespace)) {
     const known = [...PLATFORM_TOOLS3, ...Object.keys(FOLLOWS_TOOL3)].filter((tool) => tool.startsWith(`${namespace}.`));
@@ -42619,7 +42818,8 @@ function toolNameProblem3(name6) {
   return meant === void 0 ? null : `\`${name6}\` is not a tool; did you mean \`${meant}${name6.slice(namespace.length)}\`?`;
 }
 var ToolConfigSchema3 = external_exports.object({
-  enabled: external_exports.boolean(),
+  /** Absent is enabled (ADR-1911): naming a tool to set its permission already says it is wanted. */
+  enabled: external_exports.boolean().default(true),
   permission: ToolPermissionSchema3,
   config: external_exports.record(external_exports.string(), external_exports.unknown()).optional()
 });
@@ -42906,7 +43106,24 @@ var CREATOR_PROGRAM3 = {
     upload_token_minutes: 15,
     skill_max_bytes: 32 * 1024,
     /** The reviewer's install check (§42.5): the hard cap on its one session, never charged to the draft. */
-    review_check_budget_micro_usd: 5e6
+    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,
+      max_seconds: 15,
+      video_max_bytes: 95 * 1024 * 1024,
+      image_max_bytes: 10 * 1024 * 1024,
+      characters_min: 1,
+      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,
+      /** 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`. */
+      draft_retention_days: 30
+    }
   }
 };
 var DOOMSCROLL_PROGRAM3 = {
@@ -42950,6 +43167,8 @@ var StudioStateSchema3 = external_exports.enum([
   "setup",
   "building",
   "ready",
+  /** A `video` origin only: a version was submitted and its author is writing the skill. */
+  "finalizing",
   "in_review",
   "live",
   "changes_requested"
@@ -43013,10 +43232,26 @@ var StudioSkillSchema3 = SavedSkillSchema3.extend({
   id: idOf3("skl").nullable(),
   version: external_exports.number().int().positive().nullable()
 });
+var StudioImageContentTypeSchema3 = external_exports.enum(["image/png", "image/jpeg", "image/webp"]);
+var StudioSourceVideoSchema3 = external_exports.object({
+  file_id: external_exports.string().nullable(),
+  bytes: external_exports.number().int().positive().max(CREATOR_PROGRAM3.studio.video.video_max_bytes),
+  content_type: StudioUploadContentTypeSchema3,
+  filename: external_exports.string().min(1).max(200),
+  seconds: external_exports.number().nonnegative().nullable()
+});
+var CharacterPosition3 = external_exports.number().int().min(1).max(CREATOR_PROGRAM3.studio.video.characters_max);
+var StudioCharacterSchema3 = external_exports.object({
+  position: CharacterPosition3,
+  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)
+});
 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. */
-  origin: external_exports.enum(["upload", "links"]).default("upload"),
+  /** `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). */
+  origin: external_exports.enum(["upload", "links", "video"]).default("upload"),
   imports: external_exports.array(StudioImportSchema3).max(CREATOR_PROGRAM3.studio.uploads).default([]),
   state: StudioStateSchema3.default("setup"),
   spend_micro_usd: MicroUsdField3.nonnegative().default(0),
@@ -43027,7 +43262,11 @@ var CreatorStudioSchema3 = external_exports.object({
   /** An org build's asked sample length (§57.2, ADR-1762); `null` is `sample_seconds`. */
   seconds: external_exports.number().int().min(10).max(60).nullable().default(null),
   /** An org build's own catalog text: its request's description when that fits a tagline; `null` lets the judge write one. */
-  tagline: external_exports.string().max(140).nullable().default(null)
+  tagline: external_exports.string().max(140).nullable().default(null),
+  /** 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)
 });
 var CreatorTemplateListingSchema3 = external_exports.object({
   listed: external_exports.boolean(),
@@ -43081,7 +43320,15 @@ var CreatorTemplateRoundSchema3 = external_exports.object({
   spend_micro_usd: MicroUsdField3.nonnegative(),
   error: external_exports.string().nullable(),
   created_at: Timestamp3,
-  finished_at: Timestamp3.nullable()
+  finished_at: Timestamp3.nullable(),
+  /** A `video` origin round's Mira edit and its result (migration 0172, §42.14). */
+  edit_job_id: external_exports.string().nullable().default(null),
+  sample_file_id: external_exports.string().nullable().default(null)
+});
+var StudioPlateSchema3 = external_exports.object({
+  file: external_exports.string().min(1),
+  kind: external_exports.enum(["video", "image"]),
+  file_id: external_exports.string().min(1)
 });
 var NicheVersionStudioSchema3 = external_exports.object({
   round: external_exports.number().int().positive(),
@@ -43090,7 +43337,9 @@ var NicheVersionStudioSchema3 = external_exports.object({
   frames: external_exports.array(StudioFrameSchema3),
   samples: external_exports.array(StudioSampleSchema3),
   tagline: external_exports.string().max(140),
-  hero_sample_index: external_exports.number().int().nonnegative()
+  hero_sample_index: external_exports.number().int().nonnegative(),
+  /** A `video` origin's default clip and characters. */
+  plates: external_exports.array(StudioPlateSchema3).optional()
 });
 var CreatorTemplateSchema3 = external_exports.object({
   id: idOf3("ctp"),
@@ -43187,13 +43436,26 @@ var CreatorAnalyticsSchema3 = external_exports.object({
   install_windows: external_exports.array(external_exports.object({ install_id: idOf3("bpi"), from: Day4, until: Day4 })).optional()
 });
 var CreatorTemplateCreateKindSchema3 = external_exports.object({
-  kind: CreatorTemplateKindSchema3.default("crew")
+  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()
 });
 var StudioUploadCreateSchema3 = external_exports.object({
-  position: UploadPosition3,
+  purpose: external_exports.enum(["source", "character"]).optional(),
+  position: UploadPosition3.optional(),
   filename: external_exports.string().min(1).max(200),
-  content_type: StudioUploadContentTypeSchema3,
-  bytes: external_exports.number().int().positive().max(CREATOR_PROGRAM3.studio.upload_max_bytes)
+  content_type: external_exports.union([StudioUploadContentTypeSchema3, StudioImageContentTypeSchema3]),
+  bytes: external_exports.number().int().positive()
+}).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 (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");
+  }
+  const max = character2 ? video.image_max_bytes : body2.purpose === "source" ? video.video_max_bytes : upload_max_bytes;
+  if (body2.bytes > max) issue2("bytes", `this upload may be at most ${max} bytes`);
 });
 var StudioUploadTicketSchema3 = external_exports.object({
   object: external_exports.literal("studio_upload_ticket"),
@@ -43207,6 +43469,12 @@ var StudioUploadResultSchema3 = external_exports.object({
   template_id: idOf3("ctp"),
   upload: StudioUploadSchema3
 });
+var StudioVideoUploadResultSchema3 = external_exports.object({
+  object: external_exports.literal("studio_upload"),
+  template_id: idOf3("ctp"),
+  source_video: StudioSourceVideoSchema3.nullable(),
+  characters: external_exports.array(StudioCharacterSchema3)
+});
 var StudioRoundCreateSchema3 = external_exports.object({
   feedback: external_exports.string().min(1).max(4e3).optional(),
   rights_attested: external_exports.boolean().optional()
@@ -43219,9 +43487,12 @@ var StudioBudgetSchema3 = external_exports.object({
 var CreatorStudioViewSchema3 = external_exports.object({
   object: external_exports.literal("creator_studio"),
   template_id: idOf3("ctp"),
-  studio: CreatorStudioSchema3,
-  /** Newest first. */
-  rounds: external_exports.array(CreatorTemplateRoundSchema3),
+  /** A `video` origin's `source_video` also carries a signed `url` once its bytes landed. */
+  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() })),
   budget: StudioBudgetSchema3
 });
 var NicheSubmitSchema3 = external_exports.object({
@@ -43231,6 +43502,7 @@ var NicheSubmitSchema3 = external_exports.object({
     hero_sample_index: external_exports.number().int().nonnegative()
   })
 });
+var VideoSubmitSchema3 = external_exports.object({ round: external_exports.number().int().positive() });
 var CreatorListingPatchSchema3 = CreatorTemplateListingSchema3.partial();
 var CreatorListingSchema3 = external_exports.object({
   object: external_exports.literal("creator_listing"),
@@ -43450,6 +43722,10 @@ var EventTypeSchema3 = external_exports.enum([
   "span.harness_build.end",
   "span.box_resume.start",
   "span.box_resume.end",
+  "span.tools_resolve.start",
+  "span.tools_resolve.end",
+  "span.model_gate.start",
+  "span.model_gate.end",
   /**
    * A delegated thread's lifecycle, on the **coordinator's** stream (§28). The child's own
    * `ses_…` rides inside `data.thread_id` — the event schema gains no field and `vetta.event` gains
@@ -45029,11 +45305,12 @@ 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 EditRequestSchema3 = external_exports.object({
   video: external_exports.string().min(1),
   prompt: external_exports.string().min(1).max(1e3),
   references: external_exports.array(external_exports.string().min(1)).max(4).optional(),
-  mode: external_exports.enum(["scene", "outfit_or_object", "person_swap"]).optional()
+  mode: EditModeSchema3.optional()
 });
 var EditFailureCodeSchema3 = external_exports.enum(["bad_source", "refused", "timed_out", "provider_error", "cancelled"]);
 var EditJobSchema3 = external_exports.object({
@@ -45043,7 +45320,7 @@ var EditJobSchema3 = external_exports.object({
   video: external_exports.string(),
   prompt: external_exports.string(),
   references: external_exports.array(external_exports.string()),
-  mode: external_exports.enum(["scene", "outfit_or_object", "person_swap"]).nullable(),
+  mode: EditModeSchema3.nullable(),
   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(),
@@ -47858,7 +48135,7 @@ var auth2 = {
     } else if (apiKey === "" || cmd.config.apiKeyFromProfile) {
       const piped = cmd.readStdin()?.trim() ?? "";
       if (piped !== "") apiKey = piped;
-      if (apiKey === "") throw new UsageError("pipe the key on stdin, set VETTA_API_KEY, or pass --email and --password");
+      if (apiKey === "") throw new UsageError("pipe the key on stdin, set NAIVE_API_KEY, or pass --email and --password");
     }
     const client = cmd.withApiKey(apiKey);
     const me = await client.auth.me();
@@ -48082,7 +48359,7 @@ function status2(args) {
   if (found === void 0) throw new UsageError(`--status must be ${CardStatusSchema.options.join("|")}`);
   return found;
 }
-async function settled2(cmd, issued) {
+async function settled(cmd, issued) {
   let current = issued;
   for (let attempt2 = 0; SETTLING.has(current.status) && attempt2 < WAIT_ATTEMPTS; attempt2 += 1) {
     await new Promise((resolve5) => setTimeout(resolve5, WAIT_MS));
@@ -48110,7 +48387,7 @@ var cards2 = {
       label: args.need("label"),
       load_micro_usd: microFromUsdFlag("usd", args.need("usd"))
     });
-    return { out: args.bool("wait") ? await settled2(cmd, issued) : issued };
+    return { out: args.bool("wait") ? await settled(cmd, issued) : issued };
   },
   show: async ({ client, args }) => ({ out: await client.identities.cards.get(ref(args), card(args)) }),
   reveal: async ({ client, args }) => {
@@ -48448,11 +48725,11 @@ var WAIT_MS2 = 5e3;
 var WAIT_ATTEMPTS2 = 1440;
 var STATES = ["setup", "building", "ready"];
 var newest = (build) => build.rounds[0];
-var settled3 = (build) => newest(build)?.state === "ready" || newest(build)?.state === "failed";
+var settled2 = (build) => newest(build)?.state === "ready" || newest(build)?.state === "failed";
 async function finish(cmd, queued, wait) {
   if (!wait) return { out: queued };
   let build = queued;
-  for (let attempt2 = 0; attempt2 < WAIT_ATTEMPTS2 && !settled3(build); attempt2 += 1) {
+  for (let attempt2 = 0; attempt2 < WAIT_ATTEMPTS2 && !settled2(build); attempt2 += 1) {
     await new Promise((resolve5) => setTimeout(resolve5, WAIT_MS2));
     build = await cmd.client.media.skills.get(queued.id);
   }
@@ -48699,8 +48976,8 @@ var media6 = {
   // §55: `naive media edit "<prompt>" --video <fil_|url>`. `--wait` follows the edit job.
   edit: async ({ client, args }) => {
     const mode = args.str("mode");
-    if (mode !== void 0 && mode !== "scene" && mode !== "outfit_or_object" && mode !== "person_swap") {
-      throw new UsageError("--mode must be scene, outfit_or_object or person_swap");
+    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 references = args.list("reference");
     let job = await client.media.edits.create({
@@ -51616,7 +51893,7 @@ var ALIASES = {
 };
 
 // src/cli.ts
-var VERSION = true ? "1.0.1" : "0.0.0-dev";
+var VERSION = true ? "1.0.3" : "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(", ");
@@ -51690,9 +51967,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})`);
@@ -51713,6 +51994,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");
@@ -51729,6 +52012,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.1",
+  "version": "1.0.3",
   "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/blueprints": "0.18.0",
-    "@usenaive-sdk/managed-agents": "0.12.1"
+    "@usenaive-sdk/managed-agents": "0.12.3",
+    "@usenaive-sdk/blueprints": "0.18.0"
   },
   "scripts": {
     "build": "node build.mjs",