@usenaive-sdk/cli 1.0.0 → 1.0.2

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) === "") {
@@ -37148,6 +37321,7 @@ var CODE_BY_STATUS = {
 var BLOCKED_AT_EDGE = "the request was blocked before it reached the API (HTTP 403); this can happen when a request body looks like SQL";
 function unreadableMessage(status4) {
   if (status4 === 403) return BLOCKED_AT_EDGE;
+  if (status4 === 401) return "HTTP 401: the API key was rejected and the response had no readable details; check the API key and that baseUrl points at the API";
   return `HTTP ${status4}: the error response had no readable details`;
 }
 function apiErrorFrom(response, text32) {
@@ -37923,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
   })
 });
@@ -38556,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) }),
@@ -38568,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({
@@ -38763,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
   })
 });
@@ -38980,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;
@@ -38992,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 = {
@@ -39010,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;
@@ -39079,7 +39255,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. */
@@ -39289,9 +39465,11 @@ function withTool(tools3, name6, settings) {
     }
   };
 }
+var DEFAULT_BASE_URL = "https://api.vetta.sh";
 function createClient(options) {
   const config2 = {
     ...options,
+    baseUrl: (options.baseUrl ?? DEFAULT_BASE_URL).replace(/\/+$/, "").replace(/\/v1$/, ""),
     fetch: options.fetch ?? ((input, init) => globalThis.fetch(input, init)),
     idempotencyKey: options.idempotencyKey ?? (() => crypto.randomUUID())
   };
@@ -41062,6 +41240,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
 });
@@ -42606,7 +42786,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}.`));
@@ -42616,7 +42800,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()
 });
@@ -42903,7 +43088,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 = {
@@ -42947,6 +43149,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"
@@ -43010,10 +43214,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),
@@ -43024,7 +43244,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(),
@@ -43078,7 +43302,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(),
@@ -43087,7 +43319,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"),
@@ -43184,13 +43418,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"),
@@ -43204,6 +43451,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()
@@ -43216,9 +43469,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({
@@ -43228,6 +43484,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"),
@@ -43447,6 +43704,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
@@ -45026,11 +45287,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({
@@ -45040,7 +45302,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(),
@@ -47855,7 +48117,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();
@@ -48079,7 +48341,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));
@@ -48107,7 +48369,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 }) => {
@@ -48445,11 +48707,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);
   }
@@ -48696,8 +48958,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({
@@ -49404,6 +49666,7 @@ export default defineProject({
 });
 `;
 var TEMPLATE_KEY = /(\btemplate:\s*)(["'])[^"']*\2/;
+var TEMPLATE_ENV = /process\.env\[["']NAIVE_TEMPLATE["']\](?!\s*\?\?)/;
 function setTemplate(cmd, dir, template6) {
   const path = `${dir}/naive.config.ts`;
   let text4;
@@ -49413,6 +49676,17 @@ function setTemplate(cmd, dir, template6) {
     throw new UsageError(`cloned ${dir}, but could not read ${path} to set the template: ${message3(error51)}`);
   }
   if (!TEMPLATE_KEY.test(text4)) {
+    const index = `${dir}/templates/index.ts`;
+    let picker;
+    try {
+      picker = cmd.readFile(index);
+    } catch {
+      picker = void 0;
+    }
+    if (picker !== void 0 && TEMPLATE_ENV.test(picker)) {
+      cmd.writeFile(index, picker.replace(TEMPLATE_ENV, `(process.env["NAIVE_TEMPLATE"] ?? "${template6}")`));
+      return;
+    }
     throw new UsageError(`cloned ${dir}, but ${path} has no \`template:\` to set \u2014 this blueprint takes no template`);
   }
   cmd.writeFile(path, text4.replace(TEMPLATE_KEY, `$1"${template6}"`));
@@ -50250,7 +50524,8 @@ async function createBody4(cmd) {
   const outcome2 = args.str("outcome");
   return {
     agent_id: args.need("agent"),
-    message: args.str("message") ?? args.positionals[0] ?? "",
+    // The API refuses an empty first message, so a missing one is a usage error here, not a 400.
+    message: args.str("message") ?? args.positionals[0] ?? args.need("message"),
     // `naive session create --agent Concierge --identity ava-sales` (`docs/identity/personas.mdx`).
     ...identity3 === void 0 ? {} : { identity: identity3 },
     ...window === void 0 ? {} : { window: parseWindow(window) },
@@ -50265,10 +50540,14 @@ async function watch(cmd, sessionId, afterSeq) {
   let cursor = afterSeq;
   for (; ; ) {
     let parkedIdle = false;
+    let idleOutput = null;
     for await (const event of cmd.client.stream(sessionId, { afterSeq: cursor })) {
       printEvent(cmd.io, event, cmd.human);
       cursor = event.seq;
-      if (event.type === "session.idle") parkedIdle = event.data["stop_reason"] === "awaiting_delegation";
+      if (event.type === "session.idle") {
+        parkedIdle = event.data["stop_reason"] === "awaiting_delegation";
+        idleOutput = event.data["structured_output"] ?? null;
+      }
     }
     let final = await cmd.client.sessions.get(sessionId);
     for (let attempt2 = 0; final.stop_reason === null && attempt2 < SETTLE_ATTEMPTS; attempt2 += 1) {
@@ -50276,6 +50555,7 @@ async function watch(cmd, sessionId, afterSeq) {
       final = await cmd.client.sessions.get(sessionId);
     }
     if (parkedIdle && gradeOut(final)) continue;
+    if (final.structured_output == null && idleOutput !== null) final = { ...final, structured_output: idleOutput };
     return { out: final, code: exitForStopReason(final.stop_reason) };
   }
 }
@@ -51595,7 +51875,7 @@ var ALIASES = {
 };
 
 // src/cli.ts
-var VERSION = true ? "1.0.0" : "0.0.0-dev";
+var VERSION = true ? "1.0.2" : "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(", ");

package/package.json

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