@agentmedia/schema 0.4.0 → 0.5.0

package/dist/v2/character.d.ts

@@ -10,21 +10,21 @@
  */
 import { z } from 'zod';
 export declare const CharacterCreateSchema: z.ZodObject<{
-    photo_url: z.ZodString;
+    photo_url: z.ZodOptional<z.ZodString>;
     display_name: z.ZodString;
     description: z.ZodString;
     voice_brief: z.ZodOptional<z.ZodString>;
     preset_default: z.ZodOptional<z.ZodEnum<["bedroom-morning-ritual", "getting-ready-mirror-edge", "bathroom-skincare-routine", "bedside-lamp-evening", "kitchen-glow-up", "backyard-morning-coffee", "picnic-blanket-outdoor", "car-quick-honest-review", "car-passenger-honest", "outdoor-walking-talking", "couch-haul-show-off", "closet-fit-check", "studio-apartment-tour", "balcony-evening-vibes", "desk-wfh-quick-pitch", "cafe-window-seat", "office-bathroom-discreet", "gym-post-workout", "salon-mirror-result", "travel-hotel-room-review"]>>;
 }, "strip", z.ZodTypeAny, {
     description: string;
-    photo_url: string;
     display_name: string;
+    photo_url?: string | undefined;
     voice_brief?: string | undefined;
     preset_default?: "bedroom-morning-ritual" | "getting-ready-mirror-edge" | "bathroom-skincare-routine" | "bedside-lamp-evening" | "kitchen-glow-up" | "backyard-morning-coffee" | "picnic-blanket-outdoor" | "car-quick-honest-review" | "car-passenger-honest" | "outdoor-walking-talking" | "couch-haul-show-off" | "closet-fit-check" | "studio-apartment-tour" | "balcony-evening-vibes" | "desk-wfh-quick-pitch" | "cafe-window-seat" | "office-bathroom-discreet" | "gym-post-workout" | "salon-mirror-result" | "travel-hotel-room-review" | undefined;
 }, {
     description: string;
-    photo_url: string;
     display_name: string;
+    photo_url?: string | undefined;
     voice_brief?: string | undefined;
     preset_default?: "bedroom-morning-ritual" | "getting-ready-mirror-edge" | "bathroom-skincare-routine" | "bedside-lamp-evening" | "kitchen-glow-up" | "backyard-morning-coffee" | "picnic-blanket-outdoor" | "car-quick-honest-review" | "car-passenger-honest" | "outdoor-walking-talking" | "couch-haul-show-off" | "closet-fit-check" | "studio-apartment-tour" | "balcony-evening-vibes" | "desk-wfh-quick-pitch" | "cafe-window-seat" | "office-bathroom-discreet" | "gym-post-workout" | "salon-mirror-result" | "travel-hotel-room-review" | undefined;
 }>;

package/dist/v2/character.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"character.d.ts","sourceRoot":"","sources":["../../src/v2/character.ts"],"names":[],"mappings":"AAEA;;;;;;;;;GASG;AAEH,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AAGxB,eAAO,MAAM,qBAAqB;;;;;;;;;;;;;;;;;;EAoBhC,CAAC;AAEH,MAAM,MAAM,oBAAoB,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,qBAAqB,CAAC,CAAC"}
+{"version":3,"file":"character.d.ts","sourceRoot":"","sources":["../../src/v2/character.ts"],"names":[],"mappings":"AAEA;;;;;;;;;GASG;AAEH,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AAGxB,eAAO,MAAM,qBAAqB;;;;;;;;;;;;;;;;;;EAsBhC,CAAC;AAEH,MAAM,MAAM,oBAAoB,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,qBAAqB,CAAC,CAAC"}

package/dist/v2/character.js

@@ -12,8 +12,10 @@
 import { z } from 'zod';
 import { V2_SHOT_PRESETS } from './selfie.js';
 export const CharacterCreateSchema = z.object({
-    // Source photo — single file, frontal-ish, daylight ideally.
-    photo_url: z.string().url(),
+    // Optional source photo — if absent, agent-media generates the
+    // portrait from `description` alone. Pass a real person's photo
+    // ONLY when you want that exact person's likeness.
+    photo_url: z.string().url().optional(),
     // Required identity
     display_name: z
         .string()

package/dist/v2/character.js.map

@@ -1 +1 @@
-{"version":3,"file":"character.js","sourceRoot":"","sources":["../../src/v2/character.ts"],"names":[],"mappings":"AAAA,+DAA+D;AAE/D;;;;;;;;;GASG;AAEH,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AACxB,OAAO,EAAE,eAAe,EAAE,MAAM,aAAa,CAAC;AAE9C,MAAM,CAAC,MAAM,qBAAqB,GAAG,CAAC,CAAC,MAAM,CAAC;IAC5C,6DAA6D;IAC7D,SAAS,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,GAAG,EAAE;IAE3B,oBAAoB;IACpB,YAAY,EAAE,CAAC;SACZ,MAAM,EAAE;SACR,IAAI,EAAE;SACN,GAAG,CAAC,CAAC,CAAC;SACN,GAAG,CAAC,EAAE,CAAC;SACP,KAAK,CACJ,mBAAmB,EACnB,gFAAgF,CACjF;IAEH,WAAW,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,GAAG,CAAC,CAAC,CAAC,CAAC,GAAG,CAAC,GAAG,CAAC;IAEvC,uDAAuD;IACvD,WAAW,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,GAAG,CAAC,CAAC,CAAC,CAAC,GAAG,CAAC,GAAG,CAAC,CAAC,QAAQ,EAAE;IAClD,cAAc,EAAE,CAAC,CAAC,IAAI,CAAC,eAAe,CAAC,CAAC,QAAQ,EAAE;CACnD,CAAC,CAAC"}
+{"version":3,"file":"character.js","sourceRoot":"","sources":["../../src/v2/character.ts"],"names":[],"mappings":"AAAA,+DAA+D;AAE/D;;;;;;;;;GASG;AAEH,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AACxB,OAAO,EAAE,eAAe,EAAE,MAAM,aAAa,CAAC;AAE9C,MAAM,CAAC,MAAM,qBAAqB,GAAG,CAAC,CAAC,MAAM,CAAC;IAC5C,+DAA+D;IAC/D,gEAAgE;IAChE,mDAAmD;IACnD,SAAS,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,GAAG,EAAE,CAAC,QAAQ,EAAE;IAEtC,oBAAoB;IACpB,YAAY,EAAE,CAAC;SACZ,MAAM,EAAE;SACR,IAAI,EAAE;SACN,GAAG,CAAC,CAAC,CAAC;SACN,GAAG,CAAC,EAAE,CAAC;SACP,KAAK,CACJ,mBAAmB,EACnB,gFAAgF,CACjF;IAEH,WAAW,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,GAAG,CAAC,CAAC,CAAC,CAAC,GAAG,CAAC,GAAG,CAAC;IAEvC,uDAAuD;IACvD,WAAW,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,GAAG,CAAC,CAAC,CAAC,CAAC,GAAG,CAAC,GAAG,CAAC,CAAC,QAAQ,EAAE;IAClD,cAAc,EAAE,CAAC,CAAC,IAAI,CAAC,eAAe,CAAC,CAAC,QAAQ,EAAE;CACnD,CAAC,CAAC"}

package/dist/v2/selfie.d.ts

@@ -21,7 +21,7 @@ export declare const V2_SHOT_PRESETS: readonly ["bedroom-morning-ritual", "getti
 export type V2ShotPreset = (typeof V2_SHOT_PRESETS)[number];
 export declare const V2_VIBES: readonly ["excited", "calm", "sassy", "serious", "curious"];
 export type V2Vibe = (typeof V2_VIBES)[number];
-export declare const V2_DURATIONS: readonly [5, 8, 12, 15];
+export declare const V2_DURATIONS: readonly [5, 10, 15];
 export type V2Duration = (typeof V2_DURATIONS)[number];
 export declare const SelfieSchema: z.ZodEffects<z.ZodObject<{
     character_id: z.ZodOptional<z.ZodString>;
@@ -30,11 +30,11 @@ export declare const SelfieSchema: z.ZodEffects<z.ZodObject<{
     script: z.ZodString;
     preset: z.ZodDefault<z.ZodEnum<["bedroom-morning-ritual", "getting-ready-mirror-edge", "bathroom-skincare-routine", "bedside-lamp-evening", "kitchen-glow-up", "backyard-morning-coffee", "picnic-blanket-outdoor", "car-quick-honest-review", "car-passenger-honest", "outdoor-walking-talking", "couch-haul-show-off", "closet-fit-check", "studio-apartment-tour", "balcony-evening-vibes", "desk-wfh-quick-pitch", "cafe-window-seat", "office-bathroom-discreet", "gym-post-workout", "salon-mirror-result", "travel-hotel-room-review"]>>;
     vibe: z.ZodDefault<z.ZodEnum<["excited", "calm", "sassy", "serious", "curious"]>>;
-    duration: z.ZodDefault<z.ZodUnion<[z.ZodLiteral<5>, z.ZodLiteral<8>, z.ZodLiteral<12>, z.ZodLiteral<15>]>>;
+    duration: z.ZodDefault<z.ZodUnion<[z.ZodLiteral<5>, z.ZodLiteral<10>, z.ZodLiteral<15>]>>;
     voice_brief: z.ZodOptional<z.ZodString>;
     subtitles: z.ZodDefault<z.ZodBoolean>;
 }, "strip", z.ZodTypeAny, {
-    duration: 5 | 15 | 8 | 12;
+    duration: 5 | 10 | 15;
     script: string;
     subtitles: boolean;
     vibe: "serious" | "calm" | "excited" | "sassy" | "curious";
@@ -45,7 +45,7 @@ export declare const SelfieSchema: z.ZodEffects<z.ZodObject<{
     voice_brief?: string | undefined;
 }, {
     script: string;
-    duration?: 5 | 15 | 8 | 12 | undefined;
+    duration?: 5 | 10 | 15 | undefined;
     subtitles?: boolean | undefined;
     description?: string | undefined;
     vibe?: "serious" | "calm" | "excited" | "sassy" | "curious" | undefined;
@@ -54,7 +54,7 @@ export declare const SelfieSchema: z.ZodEffects<z.ZodObject<{
     preset?: "bedroom-morning-ritual" | "getting-ready-mirror-edge" | "bathroom-skincare-routine" | "bedside-lamp-evening" | "kitchen-glow-up" | "backyard-morning-coffee" | "picnic-blanket-outdoor" | "car-quick-honest-review" | "car-passenger-honest" | "outdoor-walking-talking" | "couch-haul-show-off" | "closet-fit-check" | "studio-apartment-tour" | "balcony-evening-vibes" | "desk-wfh-quick-pitch" | "cafe-window-seat" | "office-bathroom-discreet" | "gym-post-workout" | "salon-mirror-result" | "travel-hotel-room-review" | undefined;
     voice_brief?: string | undefined;
 }>, {
-    duration: 5 | 15 | 8 | 12;
+    duration: 5 | 10 | 15;
     script: string;
     subtitles: boolean;
     vibe: "serious" | "calm" | "excited" | "sassy" | "curious";
@@ -65,7 +65,7 @@ export declare const SelfieSchema: z.ZodEffects<z.ZodObject<{
     voice_brief?: string | undefined;
 }, {
     script: string;
-    duration?: 5 | 15 | 8 | 12 | undefined;
+    duration?: 5 | 10 | 15 | undefined;
     subtitles?: boolean | undefined;
     description?: string | undefined;
     vibe?: "serious" | "calm" | "excited" | "sassy" | "curious" | undefined;

package/dist/v2/selfie.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"selfie.d.ts","sourceRoot":"","sources":["../../src/v2/selfie.ts"],"names":[],"mappings":"AAEA;;;;;;;;;;;;;;;;;GAiBG;AAEH,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AAGxB,eAAO,MAAM,eAAe,yfAqBlB,CAAC;AACX,MAAM,MAAM,YAAY,GAAG,CAAC,OAAO,eAAe,CAAC,CAAC,MAAM,CAAC,CAAC;AAE5D,eAAO,MAAM,QAAQ,6DAA8D,CAAC;AACpF,MAAM,MAAM,MAAM,GAAG,CAAC,OAAO,QAAQ,CAAC,CAAC,MAAM,CAAC,CAAC;AAE/C,eAAO,MAAM,YAAY,yBAA0B,CAAC;AACpD,MAAM,MAAM,UAAU,GAAG,CAAC,OAAO,YAAY,CAAC,CAAC,MAAM,CAAC,CAAC;AAGvD,eAAO,MAAM,YAAY;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;EA6CrB,CAAC;AAEL,MAAM,MAAM,WAAW,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,YAAY,CAAC,CAAC"}
+{"version":3,"file":"selfie.d.ts","sourceRoot":"","sources":["../../src/v2/selfie.ts"],"names":[],"mappings":"AAEA;;;;;;;;;;;;;;;;;GAiBG;AAEH,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AAGxB,eAAO,MAAM,eAAe,yfAqBlB,CAAC;AACX,MAAM,MAAM,YAAY,GAAG,CAAC,OAAO,eAAe,CAAC,CAAC,MAAM,CAAC,CAAC;AAE5D,eAAO,MAAM,QAAQ,6DAA8D,CAAC;AACpF,MAAM,MAAM,MAAM,GAAG,CAAC,OAAO,QAAQ,CAAC,CAAC,MAAM,CAAC,CAAC;AAE/C,eAAO,MAAM,YAAY,sBAAuB,CAAC;AACjD,MAAM,MAAM,UAAU,GAAG,CAAC,OAAO,YAAY,CAAC,CAAC,MAAM,CAAC,CAAC;AAGvD,eAAO,MAAM,YAAY;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;EAyDrB,CAAC;AAEL,MAAM,MAAM,WAAW,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,YAAY,CAAC,CAAC"}

package/dist/v2/selfie.js

@@ -42,7 +42,7 @@ export const V2_SHOT_PRESETS = [
     'travel-hotel-room-review',
 ];
 export const V2_VIBES = ['excited', 'calm', 'sassy', 'serious', 'curious'];
-export const V2_DURATIONS = [5, 8, 12, 15];
+export const V2_DURATIONS = [5, 10, 15];
 // ── Input schema ──────────────────────────────────────────────────────────
 export const SelfieSchema = z
     .object({
@@ -59,8 +59,8 @@ export const SelfieSchema = z
     preset: z.enum(V2_SHOT_PRESETS).default('bedroom-morning-ritual'),
     vibe: z.enum(V2_VIBES).default('excited'),
     duration: z
-        .union([z.literal(5), z.literal(8), z.literal(12), z.literal(15)])
-        .default(8),
+        .union([z.literal(5), z.literal(10), z.literal(15)])
+        .default(10),
     // Voice direction (one line, natural language). Pulled from the
     // character record when character_id is used; user can still
     // override per-job.
@@ -70,17 +70,28 @@ export const SelfieSchema = z
 })
     .superRefine((val, ctx) => {
     const hasSavedCharacter = !!val.character_id;
-    const hasInlineCharacter = !!val.photo_url && !!val.description;
-    if (!hasSavedCharacter && !hasInlineCharacter) {
+    const hasDescription = !!val.description;
+    // Three valid input paths:
+    //   1. character_id alone (reuse saved character)
+    //   2. description alone (agent-media generates the portrait from text)
+    //   3. photo_url + description (use the user's photo as reference)
+    // Anything else is rejected.
+    if (!hasSavedCharacter && !hasDescription) {
         ctx.addIssue({
             code: z.ZodIssueCode.custom,
-            message: 'Provide either character_id, OR both photo_url and description.',
+            message: 'Provide either character_id, OR description (with optional photo_url for a real reference person).',
         });
     }
     if (hasSavedCharacter && (val.photo_url || val.description)) {
         ctx.addIssue({
             code: z.ZodIssueCode.custom,
-            message: 'Use character_id OR (photo_url + description) — not both.',
+            message: 'Use character_id OR description (+ optional photo_url) — not both.',
+        });
+    }
+    if (val.photo_url && !val.description) {
+        ctx.addIssue({
+            code: z.ZodIssueCode.custom,
+            message: 'photo_url requires a description so we know what to emphasize.',
         });
     }
 });

package/dist/v2/selfie.js.map

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

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@agentmedia/schema",
-  "version": "0.4.0",
+  "version": "0.5.0",
   "description": "Type-safe schema definitions for AI UGC video generation — enums, Zod validation, and generator registry. Single source of truth for the agent-media platform.",
   "type": "module",
   "license": "Apache-2.0",

package/scripts/generate-v2-docs.ts

@@ -55,8 +55,8 @@ function fmtPricing(def: V2GeneratorRecord): string {
     const c = def.pricing.baseCredits;
     return `One-shot: **${c} credits** ($${(c / 100).toFixed(2)})`;
   }
-  // per_clip — show 5/8/12/15
-  const rows = [5, 8, 12, 15].map((s) => {
+  // per_clip — show 5/10/15
+  const rows = [5, 10, 15].map((s) => {
     const c = quoteV2Credits(def.id as any, { durationSeconds: s });
     return `| ${s}s | ${c} | $${(c / 100).toFixed(2)} |`;
   });
@@ -210,12 +210,232 @@ function renderSkill(): string {
     '---',
     'name: agent-media-v2',
     'description: AI UGC video production via agent-media v2 — Selfie videos and reusable Characters. Use this skill when the user wants to make TikTok-style "AI person talking to camera" clips or save a character for reuse across multiple generations.',
-    'homepage: https://agent-media.ai',
-    `version: 1.0.0`,
+    'homepage: https://agent-media.ai/skill',
+    `version: 1.3.0`,
     '---',
     '',
     GENERATED_NOTE,
     '',
+    '# agent-media — STRICT RULES (read first, every time)',
+    '',
+    '## 0. CONVERSATION FLOW — follow this in order',
+    '',
+    'Before you EVER call the CLI, walk the user through these steps. Ask in batches of 2-3 questions at a time, never one-by-one, never silently default. Use the user\'s answers to populate the CLI args.',
+    '',
+    '### Step 1 — What\'s the video about?',
+    '',
+    'This is the FIRST question, every time. Even if the user typed a full prompt with a script, confirm:',
+    '',
+    '> *"Got it — quick check before I generate:*',
+    '> *• What\'s the video about?  (the topic / what they\'re selling / what\'s happening in the scene)*',
+    '> *• What\'s the exact line you want them to say?  (the script — 1-3 sentences usually works best)"*',
+    '',
+    'Don\'t skip this. The "topic" informs the preset + vibe selection later. If the user already gave you a script, repeat it back so they can confirm or tweak it.',
+    '',
+    '### Step 2 — Who\'s the character?',
+    '',
+    '**agent-media generates the character image itself from your description. You DO NOT need to provide a photo.** A description like "25yo asian woman with long wavy dark hair" is enough — the pipeline produces a consistent on-model person.',
+    '',
+    'Three valid input paths (in order of preference):',
+    '',
+    '1. **Description only** (the default — use this 95% of the time)',
+    '   Just `--description "..."`. agent-media generates the portrait and the multi-pose sheet, then runs the video. No photo, no upload, no questions about photos. Example:',
+    '   ```bash',
+    '   agent-media selfie --description "25yo asian woman, long wavy dark hair, soft smile" --script "..."',
+    '   ```',
+    '',
+    '2. **Saved character** (`--character char_xxxxxxxxxx`)',
+    '   Use when the user references a person from a previous run ("use the same girl again", "the one from yesterday\'s video"). Run `agent-media character` to list saved characters if you need to look one up.',
+    '',
+    '3. **Real-person photo + description** (`--photo <file|url> --description "..."`)',
+    '   Use ONLY when the user explicitly says "use THIS person" and gives you a photo of someone specific. Otherwise default to path 1.',
+    '',
+    'Hard rules:',
+    '- NEVER ask the user "do you have a photo?". Default to description-only.',
+    '- NEVER ask the user about the underlying models (gpt-image-2, Seedance, etc.). They are implementation details. Just say "agent-media generates the character".',
+    '- NEVER fall back to `agent-media ugc` or a stock actor library. Forbidden.',
+    '- If the user wants the SAME person across multiple videos, run `agent-media character create --description "..."` once first (no photo needed) to get a `char_xxxxxxxxxx`, then pass `--character <id>` to every selfie.',
+    '',
+    '### Step 3 — Where + how does it feel? (preset + vibe)',
+    '',
+    'Pick one **preset** (location/shot grammar) + one **vibe** (emotional tone). If you can guess from the topic, propose them as defaults to confirm; if not, ask.',
+    '',
+    '**Presets (20, one of):**',
+    '',
+    '| Preset | Best for |',
+    '|---|---|',
+    '| `bedroom-morning-ritual` | Default. Skincare, routine, "morning vibes" content |',
+    '| `getting-ready-mirror-edge` | OOTD, makeup, fashion |',
+    '| `bathroom-skincare-routine` | Beauty, hair care, skincare reveals |',
+    '| `bedside-lamp-evening` | Wind-down, journal, ASMR-style |',
+    '| `kitchen-glow-up` | Food, drinks, supplements, cooking |',
+    '| `backyard-morning-coffee` | Lifestyle, mindfulness, slow content |',
+    '| `picnic-blanket-outdoor` | Outdoor, summer, friends |',
+    '| `car-quick-honest-review` | Honest reviews, "I just bought this..." |',
+    '| `car-passenger-honest` | Same vibe, passenger angle |',
+    '| `outdoor-walking-talking` | Walking-and-talking, candid |',
+    '| `couch-haul-show-off` | Unboxing, hauls, "look what I got" |',
+    '| `closet-fit-check` | Fashion, fit-checks, OOTD |',
+    '| `studio-apartment-tour` | Lifestyle, apartment content |',
+    '| `balcony-evening-vibes` | Aesthetic, lifestyle, golden hour |',
+    '| `desk-wfh-quick-pitch` | SaaS, productivity, work-from-home |',
+    '| `cafe-window-seat` | Lifestyle, work, coffee culture |',
+    '| `office-bathroom-discreet` | Workplace anecdotes, "let me tell you" |',
+    '| `gym-post-workout` | Fitness, supplements, wellness |',
+    '| `salon-mirror-result` | Hair, beauty reveals, "before/after" |',
+    '| `travel-hotel-room-review` | Travel, hotel reviews |',
+    '',
+    '**Vibes (5, one of):** `excited` · `calm` · `sassy` · `serious` · `curious`',
+    '',
+    '- `excited` — high energy, "you won\'t believe this", default for hype/product/reveal',
+    '- `calm` — softer, intimate, default for wellness/skincare/lifestyle',
+    '- `sassy` — playful, eye-roll, default for "let me tell you" anecdotes',
+    '- `serious` — measured, default for honest reviews / SaaS / B2B',
+    '- `curious` — thoughtful, leaning-in, default for storytelling',
+    '',
+    '### Step 4 — How long?',
+    '',
+    '**Allowed durations: 5, 10, or 15 seconds. ONLY these three.** Default to 10 if unsure. The schema rejects any other value (the worker will reject 6, 8, 12, etc.).',
+    '',
+    '- `5` — single hook, no body. Best for ads with strong intro.',
+    '- `10` — default. Hook + payoff. Best for organic UGC.',
+    '- `15` — full mini-story with setup + reveal.',
+    '',
+    '### Step 5 — Voice direction (optional, but improves quality)',
+    '',
+    'Ask: *"Any voice direction? E.g. \'whisper\', \'gen-z deadpan\', \'NYC accent\', \'sleepy morning voice\'. Skip if you\'re happy with the default."*',
+    '',
+    'Pass as `--voice-brief "<text>"`. Max 240 chars. If the character has a saved `voice_brief`, it\'s used unless this is set.',
+    '',
+    '### Step 6 — Subtitles',
+    '',
+    'Subs are ON by default in Hormozi style. Offer alternatives only if asked.',
+    '',
+    '**Subtitle styles (17, one of):** `hormozi` (default) · `minimal` · `bold` · `karaoke` · `clean` · `tiktok` · `neon` · `fire` · `glow` · `pop` · `aesthetic` · `impact` · `pastel` · `electric` · `boxed` · `gradient` · `spotlight`',
+    '',
+    '### Step 7 — Quote price, confirm, run',
+    '',
+    'Print a one-line summary including ALL collected inputs + the credit cost + USD. ONLY then call the CLI. See section 4 for the pricing formula.',
+    '',
+    'Example summary line to print before submitting:',
+    '> *"Summary: 10s selfie · char_8x2vqp · preset=kitchen-glow-up · vibe=excited · subs=hormozi · voice="gen-z deadpan". Cost: **375 credits ($3.75)**. Run it?"*',
+    '',
+    '## 1. Commands you MUST use',
+    '',
+    '| User intent | Command |',
+    '|---|---|',
+    '| "make me a TikTok / UGC / Selfie / talking-head" | `agent-media selfie` |',
+    '| "save / persist this character" / "use the same person again" | `agent-media character create` (returns `char_xxxxxxxxxx`) |',
+    '| "add subtitles / captions / subs to a video" | `agent-media subs` |',
+    '',
+    '## 2. Commands you MUST NEVER use',
+    '',
+    'These are LEGACY v1 commands. They produce inferior output and use a stale actor library. They are hidden from `agent-media --help` in CLI 1.10.0+ but may still be callable directly:',
+    '',
+    '- ❌ `agent-media ugc` — replaced by `agent-media selfie`',
+    '- ❌ `agent-media show-your-app` — coming back as v2 product later',
+    '- ❌ `agent-media laptop-ugc` — coming back as v2 product later',
+    '- ❌ `agent-media character-video` — replaced by `agent-media selfie --character <id>`',
+    '- ❌ `agent-media text-to-video` — not part of v2 yet',
+    '- ❌ `agent-media subtitle` — replaced by `agent-media subs`',
+    '- ❌ `agent-media review` — not part of v2',
+    '- ❌ `agent-media product-acting` — coming back as v2 product later',
+    '',
+    'If you catch yourself reaching for any command in the list above, STOP and re-route to the v2 equivalent.',
+    '',
+    '## 3. Per-command required + optional flags',
+    '',
+    '### `agent-media selfie` (cheat-sheet)',
+    '',
+    '| Flag | Required | Allowed values | Default |',
+    '|---|---|---|---|',
+    '| `--description "..."` | ✓ (unless `--character`) | 8-400 chars describing the person | — |',
+    '| `--character <char_id>` | OR | `char_xxxxxxxxxx` (saved character) | — |',
+    '| `--photo <file\\|url>` | optional | only when user gives an exact-person reference photo | — |',
+    '| `--script "..."` | ✓ | 4-600 chars | — |',
+    '| `--preset <name>` |  | one of 20 (see Step 3) | `bedroom-morning-ritual` |',
+    '| `--vibe <name>` |  | `excited\\|calm\\|sassy\\|serious\\|curious` | `excited` |',
+    '| `--duration <n>` |  | **`5` \\| `10` \\| `15`** | `10` |',
+    '| `--voice-brief "..."` |  | 4-240 chars | (none / character default) |',
+    '| `--subs-style <name>` |  | one of 17 (see Step 6) | `hormozi` |',
+    '| `--no-subs` |  | flag | (subs on) |',
+    '',
+    '### `agent-media character create`',
+    '',
+    '| Flag | Required | Notes |',
+    '|---|---|---|',
+    '| `--name <slug>` | ✓ | lowercase, hyphens, e.g. `sofia` |',
+    '| `--description "..."` | ✓ | free text — age, look, vibe. agent-media generates the portrait from this. |',
+    '| `--photo <file\\|url>` | optional | ONLY when the user wants an exact real-person likeness. Otherwise omit. |',
+    '| `--voice-brief "..."` |  | default voice direction baked into character |',
+    '| `--preset-default <name>` |  | preset to use when this character runs selfie |',
+    '',
+    'Returns `char_xxxxxxxxxx` — copy and reuse it.',
+    '',
+    '### `agent-media subs`',
+    '',
+    '| Flag | Required | Notes |',
+    '|---|---|---|',
+    '| `--video <url>` | ✓ | publicly-fetchable mp4 URL |',
+    '| `--style <name>` |  | one of 17 (see Step 6). Default: `hormozi`. |',
+    '| `--transcript "..."` |  | skip Whisper if you already have the exact words |',
+    '| `--language <code>` |  | ISO code (`en`, `es`, `pt`, `fr`, …) |',
+    '',
+    '## 4. PRICING FORMULA — do not improvise',
+    '',
+    '**1 credit = $0.01 USD. Period.** Never quote a price without using this conversion.',
+    '',
+    'Selfie cost = `75 base + 30 × seconds`:',
+    '',
+    '| Duration | Credits | USD |',
+    '|---|---:|---:|',
+    '| 5s | 225 | **$2.25** |',
+    '| 10s | 375 | **$3.75** |',
+    '| 15s | 525 | **$5.25** |',
+    '',
+    'Character create = 27 credits = **$0.27** (one-shot).',
+    'Subtitle = `0 base + 3 × seconds` (a 10s clip = 30 credits = **$0.30**).',
+    '',
+    'If you find yourself about to print any USD value not in this table or derivable by `credits / 100`, STOP. Recompute.',
+    '',
+    '## 5. Output handling',
+    '',
+    'Every command returns a job id. Poll until terminal:',
+    '',
+    '```bash',
+    'agent-media status <job-id>',
+    '```',
+    '',
+    'When `status: "completed"`, the response carries `video_url`. Print the FULL url to the user verbatim — do not abbreviate.',
+    '',
+    'Sync mode (blocking): add `--sync` to selfie/subs and the CLI will poll for you and print the URL when done.',
+    '',
+    '### For `agent-media character create`',
+    '',
+    'Required: `--photo <file|url>`, `--name <slug>`, `--description "..."`.',
+    'Optional: `--voice-brief`, `--preset`.',
+    '',
+    'Cost: 27 credits ($0.27). Confirm.',
+    '',
+    '### For `agent-media subs`',
+    '',
+    'Required: `--video <url>`.',
+    'Optional: `--style` (default `hormozi`, one of 17), `--transcript` (skip Whisper), `--language`.',
+    '',
+    'Cost: ~24 credits / 8s clip. Confirm.',
+    '',
+    '## 4. Output handling',
+    '',
+    'Every command returns a job id. Poll until terminal:',
+    '',
+    '```bash',
+    'agent-media status <job-id>',
+    '```',
+    '',
+    'When status is `completed`, the final mp4 URL is printed. Show it to the user. Do not summarize or shorten it.',
+    '',
+    '---',
+    '',
     '# agent-media v2 — Selfie + Characters',
     '',
     'The v2 surface ships two generators today: **Selfie** (a 9:16 TikTok-style video of an AI person talking to camera) and **character_create** (persist an AI character so subsequent Selfies stay on-model). When the next v2 product lands (Product-in-hands), it appears here automatically — this file is generated from `packages/schema/src/v2/generators.ts`.',

package/src/v2/character.ts

@@ -15,8 +15,10 @@ import { z } from 'zod';
 import { V2_SHOT_PRESETS } from './selfie.js';
 
 export const CharacterCreateSchema = z.object({
-  // Source photo — single file, frontal-ish, daylight ideally.
-  photo_url: z.string().url(),
+  // Optional source photo — if absent, agent-media generates the
+  // portrait from `description` alone. Pass a real person's photo
+  // ONLY when you want that exact person's likeness.
+  photo_url: z.string().url().optional(),
 
   // Required identity
   display_name: z

package/src/v2/selfie.ts

@@ -49,7 +49,7 @@ export type V2ShotPreset = (typeof V2_SHOT_PRESETS)[number];
 export const V2_VIBES = ['excited', 'calm', 'sassy', 'serious', 'curious'] as const;
 export type V2Vibe = (typeof V2_VIBES)[number];
 
-export const V2_DURATIONS = [5, 8, 12, 15] as const;
+export const V2_DURATIONS = [5, 10, 15] as const;
 export type V2Duration = (typeof V2_DURATIONS)[number];
 
 // ── Input schema ──────────────────────────────────────────────────────────
@@ -70,8 +70,8 @@ export const SelfieSchema = z
     preset: z.enum(V2_SHOT_PRESETS).default('bedroom-morning-ritual'),
     vibe: z.enum(V2_VIBES).default('excited'),
     duration: z
-      .union([z.literal(5), z.literal(8), z.literal(12), z.literal(15)])
-      .default(8),
+      .union([z.literal(5), z.literal(10), z.literal(15)])
+      .default(10),
 
     // Voice direction (one line, natural language). Pulled from the
     // character record when character_id is used; user can still
@@ -83,19 +83,31 @@ export const SelfieSchema = z
   })
   .superRefine((val, ctx) => {
     const hasSavedCharacter = !!val.character_id;
-    const hasInlineCharacter = !!val.photo_url && !!val.description;
-    if (!hasSavedCharacter && !hasInlineCharacter) {
+    const hasDescription = !!val.description;
+    // Three valid input paths:
+    //   1. character_id alone (reuse saved character)
+    //   2. description alone (agent-media generates the portrait from text)
+    //   3. photo_url + description (use the user's photo as reference)
+    // Anything else is rejected.
+    if (!hasSavedCharacter && !hasDescription) {
       ctx.addIssue({
         code: z.ZodIssueCode.custom,
         message:
-          'Provide either character_id, OR both photo_url and description.',
+          'Provide either character_id, OR description (with optional photo_url for a real reference person).',
       });
     }
     if (hasSavedCharacter && (val.photo_url || val.description)) {
       ctx.addIssue({
         code: z.ZodIssueCode.custom,
         message:
-          'Use character_id OR (photo_url + description) — not both.',
+          'Use character_id OR description (+ optional photo_url) — not both.',
+      });
+    }
+    if (val.photo_url && !val.description) {
+      ctx.addIssue({
+        code: z.ZodIssueCode.custom,
+        message:
+          'photo_url requires a description so we know what to emphasize.',
       });
     }
   });