@purpleschool/gptbot 0.14.27-stage2 → 0.14.28

package/commands/avatar-studio/{generation-job/generate-avatar-studio-voice-timings.command.ts → scene/set-avatar-studio-scene-slot.command.ts}

@@ -1,20 +1,23 @@
 import { z } from 'zod';
-import { AvatarStudioGenerationJobSchema } from '../../../models';
+import { AVATAR_STUDIO_SLOT } from '../../../constants';
+import { AvatarStudioSceneSchema } from '../../../models';
 import { AvatarStudioSceneIdParamsSchema } from '../shared/avatar-studio-common.schema';
 
-export namespace GenerateAvatarStudioVoiceTimingsCommand {
-    export const ParamsSchema = AvatarStudioSceneIdParamsSchema;
+export namespace SetAvatarStudioSceneSlotCommand {
+    export const ParamsSchema = AvatarStudioSceneIdParamsSchema.extend({
+        slot: z.nativeEnum(AVATAR_STUDIO_SLOT),
+    });
     export type Params = z.infer<typeof ParamsSchema>;
 
     export const RequestSchema = z
         .object({
-            mediaId: z.string().uuid().optional(),
+            mediaId: z.string().uuid(),
         })
         .strict();
     export type Request = z.infer<typeof RequestSchema>;
 
     export const ResponseSchema = z.object({
-        data: AvatarStudioGenerationJobSchema,
+        data: AvatarStudioSceneSchema,
     });
     export type Response = z.infer<typeof ResponseSchema>;
 }

package/commands/avatar-studio/scriptwriter/calculate-avatar-studio-scriptwriter-price.command.ts

@@ -1,21 +1,28 @@
 import { z } from 'zod';
-import { AvatarStudioClipIdParamsSchema } from '../shared/avatar-studio-common.schema';
 
-export namespace CalculateAvatarStudioScriptwriterPriceCommand {
-    export const ParamsSchema = AvatarStudioClipIdParamsSchema;
-    export type Params = z.infer<typeof ParamsSchema>;
+/** Сама цена, без транспортной обёртки: её считает и сервис сценариста. */
+export const AvatarStudioScriptwriterPriceSchema = z.object({
+    price: z.number(),
+    charsUntilNextPriceIncrease: z.number().int().nonnegative().nullable(),
+    charsUntilNextPriceDecrease: z.number().int().nonnegative().nullable(),
+});
+export type AvatarStudioScriptwriterPrice = z.infer<typeof AvatarStudioScriptwriterPriceSchema>;
 
+export namespace CalculateAvatarStudioScriptwriterPriceCommand {
+    /**
+     * Клип опционален: цену спрашивают ещё до его создания. Без клипа считаем по одной длине
+     * ввода, без контекста прошлого диалога — история в цену и не входит, если её нет.
+     */
     export const RequestSchema = z
         .object({
             inputLength: z.number().int().nonnegative(),
+            clipId: z.string().uuid().optional(),
         })
         .strict();
     export type Request = z.infer<typeof RequestSchema>;
 
     export const ResponseSchema = z.object({
-        price: z.number(),
-        charsUntilNextPriceIncrease: z.number().int().nonnegative().nullable(),
-        charsUntilNextPriceDecrease: z.number().int().nonnegative().nullable(),
+        data: AvatarStudioScriptwriterPriceSchema,
     });
     export type Response = z.infer<typeof ResponseSchema>;
 }

package/commands/avatar-studio/scriptwriter/create-avatar-studio-scriptwriter-message.command.ts

@@ -50,10 +50,35 @@ export namespace CreateAvatarStudioScriptwriterMessageCommand {
 
     export type ScenePlan = z.infer<typeof ScenePlanSchema>;
 
+    export const ModelOutputScenePlanSchema = z
+        .object({
+            voiceConfig: z.object({
+                text: z.string().trim().min(1),
+                trimStart: z.number().nonnegative().nullable(),
+                trimEnd: z.number().nonnegative().nullable(),
+            }),
+            imageConfig: z.object({
+                prompt: z.string().trim().min(1),
+                style: z.nativeEnum(AVATAR_STUDIO_IMAGE_STYLE),
+            }),
+            videoConfig: z.object({
+                prompt: z.string().trim().min(1),
+                durationSeconds: z.number().positive(),
+                videoMode: z.nativeEnum(AVATAR_STUDIO_VIDEO_MODE),
+                quality: z.nativeEnum(AVATAR_STUDIO_VIDEO_QUALITY),
+                sound: z.boolean(),
+                trimStart: z.number().nonnegative().nullable(),
+                trimEnd: z.number().nonnegative().nullable(),
+            }),
+        })
+        .strict();
+
+    export type ModelOutputScenePlan = z.infer<typeof ModelOutputScenePlanSchema>;
+
     export const ModelOutputSchema = z
         .object({
             message: z.string().trim().min(1),
-            scenes: z.array(ScenePlanSchema).min(1).max(20),
+            scenes: z.array(ModelOutputScenePlanSchema).min(1).max(20),
         })
         .strict();
     export type ModelOutput = z.infer<typeof ModelOutputSchema>;

package/commands/avatar-studio/shared/avatar-studio-common.schema.ts

@@ -15,7 +15,8 @@ export const AvatarStudioSceneIdParamsSchema = AvatarStudioClipIdParamsSchema.ex
     sceneId: z.string().uuid(),
 });
 
-export const AvatarStudioMediaIdParamsSchema = AvatarStudioClipIdParamsSchema.extend({
+// Медиа принадлежит пользователю, а не клипу, поэтому clipId в его параметрах нет.
+export const AvatarStudioMediaIdParamsSchema = z.object({
     mediaId: z.string().uuid(),
 });
 

package/commands/avatar-studio/shared/get-avatar-studio-config.query.ts

@@ -2,7 +2,7 @@ import { z } from 'zod';
 import {
     AVATAR_STUDIO_IMAGE_STYLE,
     AVATAR_STUDIO_MEDIA_KIND,
-    AVATAR_STUDIO_MEDIA_ROLE,
+    AVATAR_STUDIO_UNAVAILABLE_REASON,
     AVATAR_STUDIO_VIDEO_MODE,
     AVATAR_STUDIO_VIDEO_QUALITY,
 } from '../../../constants';
@@ -21,13 +21,32 @@ const AvatarStudioGenerationPriceSchema = z
     })
     .strict();
 
+/**
+ * Картинки генерирует одна модель, с референсами и без. Наценка за референсы плоская:
+ * её берёт сам инструмент за факт вложения, количество картинок значения не имеет.
+ */
+const AvatarStudioImagePricingSchema = z
+    .object({
+        base: AvatarStudioGenerationPriceSchema.nullable(),
+        referenceSurcharge: z.number().nonnegative(),
+    })
+    .strict();
+
 const AvatarStudioConfigSectionBaseSchema = z
     .object({
         available: z.boolean(),
-        unavailableReason: z.string().optional(),
+        /** Присутствует только когда available = false. */
+        unavailableReason: z.nativeEnum(AVATAR_STUDIO_UNAVAILABLE_REASON).optional(),
     })
     .strict();
 
+/**
+ * Сценарист доступен не всем: у анрега нет доступа к его модели. Цены здесь нет: она зависит
+ * от длины ввода и считается на лету — POST scriptwriter/price. Конфиг отвечает только на
+ * вопрос «можно ли пользоваться».
+ */
+const AvatarStudioScriptwriterConfigSectionSchema = AvatarStudioConfigSectionBaseSchema;
+
 const AvatarStudioTextFieldSchema = z
     .object({
         kind: z.literal('text'),
@@ -50,7 +69,6 @@ const AvatarStudioMediaFieldSchema = z
         kind: z.literal('media'),
         required: z.boolean(),
         mediaKind: z.nativeEnum(AVATAR_STUDIO_MEDIA_KIND),
-        mediaRole: z.nativeEnum(AVATAR_STUDIO_MEDIA_ROLE),
     })
     .strict();
 
@@ -59,6 +77,8 @@ const AvatarStudioMediaArrayFieldSchema = z
         kind: z.literal('media-array'),
         required: z.boolean(),
         supported: z.boolean(),
+        /** Предел задаёт модель (maxAttachedImages), поэтому он приезжает сюда, а не зашит в контракт. */
+        maxCount: z.number().int().nonnegative(),
     })
     .strict();
 
@@ -93,10 +113,11 @@ const AvatarStudioAudioConfigSectionSchema = AvatarStudioConfigSectionBaseSchema
             text: AvatarStudioTextFieldSchema.extend({
                 required: z.boolean(),
             }),
-            mediaId: AvatarStudioMediaFieldSchema.extend({
+            // Образец голоса — вход генерации наравне с текстом, поэтому живёт
+            // в voiceConfig и ставится через PATCH .../scenes/:sceneId.
+            voiceSampleMediaId: AvatarStudioMediaFieldSchema.extend({
                 required: z.boolean(),
                 mediaKind: z.literal(AVATAR_STUDIO_MEDIA_KIND.AUDIO),
-                mediaRole: z.literal(AVATAR_STUDIO_MEDIA_ROLE.VOICE_SAMPLE),
             }),
         })
         .strict(),
@@ -116,7 +137,7 @@ const AvatarStudioFrameConfigSectionSchema = AvatarStudioConfigSectionBaseSchema
             style: AvatarStudioSelectFieldSchema(z.nativeEnum(AVATAR_STUDIO_IMAGE_STYLE)).extend({
                 required: z.boolean(),
             }),
-            referenceMediaIds: AvatarStudioMediaArrayFieldSchema.extend({
+            references: AvatarStudioMediaArrayFieldSchema.extend({
                 required: z.boolean(),
             }),
             aspectRatio: AvatarStudioFixedFieldSchema(z.literal('9:16')),
@@ -125,12 +146,7 @@ const AvatarStudioFrameConfigSectionSchema = AvatarStudioConfigSectionBaseSchema
     defaults: AvatarStudioSceneImageConfigSchema.extend({
         aspectRatio: z.literal('9:16'),
     }),
-    pricing: z
-        .object({
-            withoutReference: AvatarStudioGenerationPriceSchema.nullable(),
-            withReference: AvatarStudioGenerationPriceSchema.nullable(),
-        })
-        .strict(),
+    pricing: AvatarStudioImagePricingSchema,
 });
 
 const AvatarStudioVideoConfigSectionSchema = AvatarStudioConfigSectionBaseSchema.extend({
@@ -183,7 +199,7 @@ const AvatarStudioLibraryImageConfigSectionSchema = AvatarStudioConfigSectionBas
     fields: z
         .object({
             prompt: AvatarStudioTextFieldSchema.extend({ required: z.boolean() }),
-            referenceMediaIds: AvatarStudioMediaArrayFieldSchema.extend({
+            references: AvatarStudioMediaArrayFieldSchema.extend({
                 required: z.boolean(),
             }),
             aspectRatio: AvatarStudioSelectFieldSchema(AvatarStudioAspectRatioSchema).extend({
@@ -197,12 +213,7 @@ const AvatarStudioLibraryImageConfigSectionSchema = AvatarStudioConfigSectionBas
             aspectRatio: AvatarStudioAspectRatioSchema,
         })
         .strict(),
-    pricing: z
-        .object({
-            withoutReference: AvatarStudioGenerationPriceSchema.nullable(),
-            withReference: AvatarStudioGenerationPriceSchema.nullable(),
-        })
-        .strict(),
+    pricing: AvatarStudioImagePricingSchema,
 });
 
 export namespace GetAvatarStudioConfigQuery {
@@ -213,6 +224,7 @@ export namespace GetAvatarStudioConfigQuery {
                 frame: AvatarStudioFrameConfigSectionSchema,
                 video: AvatarStudioVideoConfigSectionSchema,
                 libraryImage: AvatarStudioLibraryImageConfigSectionSchema,
+                scriptwriter: AvatarStudioScriptwriterConfigSectionSchema,
             })
             .strict(),
     });

package/commands/avatar-studio/voice/design-avatar-studio-voice.command.ts

@@ -1,15 +1,7 @@
 import { z } from 'zod';
-import {
-    AvatarStudioGenerationJobSchema,
-    AvatarStudioMediaSchema,
-    AvatarStudioVoiceSchema,
-} from '../../../models';
-import { AvatarStudioClipIdParamsSchema } from '../shared/avatar-studio-common.schema';
+import { AvatarStudioGenerationJobSchema } from '../../../models';
 
 export namespace DesignAvatarStudioVoiceCommand {
-    export const ParamsSchema = AvatarStudioClipIdParamsSchema;
-    export type Params = z.infer<typeof ParamsSchema>;
-
     export const RequestSchema = z
         .object({
             title: z.string().trim().min(1).optional(),
@@ -19,12 +11,12 @@ export namespace DesignAvatarStudioVoiceCommand {
         .strict();
     export type Request = z.infer<typeof RequestSchema>;
 
+    /**
+     * Отдаём job, как и все остальные генерации: созданный голос лежит в job.resultMedia.
+     * Отдельного поля media нет — форма ответа одинакова у всех роутов генерации.
+     */
     export const ResponseSchema = z.object({
-        data: z.object({
-            job: AvatarStudioGenerationJobSchema,
-            voice: AvatarStudioVoiceSchema,
-            media: AvatarStudioMediaSchema,
-        }),
+        data: AvatarStudioGenerationJobSchema,
     });
     export type Response = z.infer<typeof ResponseSchema>;
 }

package/commands/avatar-studio/voice/index.ts

@@ -1,4 +1 @@
 export * from './design-avatar-studio-voice.command';
-export * from './find-avatar-studio-clip-voices.query';
-export * from './find-avatar-studio-voices.query';
-export * from './update-avatar-studio-clip-voice.command';

package/constants/avatar-studio/enums/avatar-studio-job-type.enum.ts

@@ -2,11 +2,8 @@ export enum AVATAR_STUDIO_JOB_TYPE {
     FRAME_IMAGE = 'frame_image',
     LIBRARY_IMAGE = 'library_image',
     SCENE_VIDEO = 'scene_video',
-    SCENE_VOICE = 'scene_voice',
     VOICE_TTS = 'voice_tts',
     VOICE_STT = 'voice_stt',
-    VOICE_TIMINGS = 'voice_timings',
     TALKING_AVATAR = 'talking_avatar',
     VOICE_DESIGN = 'voice_design',
-    SCRIPTWRITER = 'scriptwriter',
 }

package/constants/avatar-studio/enums/avatar-studio-slot.enum.ts

@@ -1,11 +1,14 @@
+/**
+ * Слоты-результаты сцены: в каждом ровно одно медиа за раз.
+ *
+ * Здесь только то, что действительно является слотом сцены:
+ * - аватар и b-roll — два способа получить VIDEO, а не два слота (режим в videoConfig.videoMode);
+ * - образец голоса — вход сцены (scene.voiceSampleMediaId), а не её результат;
+ * - референсы — несколько упорядоченных медиа, у них своя join-таблица;
+ * - «медиатека» слотом никогда не была: у таких job'ов targetSlot = null.
+ */
 export enum AVATAR_STUDIO_SLOT {
+    VOICE = 'voice',
     FRAME = 'frame',
     VIDEO = 'video',
-    VOICE = 'voice',
-    AVATAR = 'avatar',
-    LIBRARY = 'library',
-    VOICE_TIMINGS = 'voice_timings',
-    VOICE_SAMPLE = 'voice_sample',
-    SCRIPTWRITER = 'scriptwriter',
-    EXPORT = 'export',
 }

package/constants/avatar-studio/enums/avatar-studio-unavailable-reason.enum.ts

@@ -0,0 +1,12 @@
+export enum AVATAR_STUDIO_UNAVAILABLE_REASON {
+    /**
+     * Функция есть, но этому пользователю не положена: анрег либо нет подходящей подписки.
+     * Фронт вправе звать зарегистрироваться или улучшить тариф.
+     */
+    NO_ACCESS = 'no_access',
+    /**
+     * Модель выключена, не найдена или проверка доступа не удалась. Пользователь ни при чём,
+     * звать его никуда не нужно — это наша проблема.
+     */
+    MODEL_UNAVAILABLE = 'model_unavailable',
+}

package/constants/avatar-studio/enums/index.ts

@@ -1,16 +1,12 @@
 export * from './avatar-studio-export-status.enum';
 export * from './avatar-studio-image-style.enum';
-export * from './avatar-studio-job-phase.enum';
 export * from './avatar-studio-job-status.enum';
 export * from './avatar-studio-job-type.enum';
 export * from './avatar-studio-media-kind.enum';
-export * from './avatar-studio-media-role.enum';
-export * from './avatar-studio-media-source.enum';
-export * from './avatar-studio-scene-kind.enum';
 export * from './avatar-studio-scriptwriter-role.enum';
 export * from './avatar-studio-slot.enum';
 export * from './avatar-studio-subtitle-font.enum';
+export * from './avatar-studio-unavailable-reason.enum';
 export * from './avatar-studio-subtitle-mode.enum';
 export * from './avatar-studio-video-mode.enum';
 export * from './avatar-studio-video-quality.enum';
-export * from './avatar-studio-voice-source.enum';

package/models/avatar-studio/avatar-studio.schema.ts

@@ -2,19 +2,15 @@ import { z } from 'zod';
 import {
     AVATAR_STUDIO_EXPORT_STATUS,
     AVATAR_STUDIO_IMAGE_STYLE,
-    AVATAR_STUDIO_JOB_PHASE,
     AVATAR_STUDIO_JOB_STATUS,
     AVATAR_STUDIO_JOB_TYPE,
     AVATAR_STUDIO_MEDIA_KIND,
-    AVATAR_STUDIO_MEDIA_ROLE,
-    AVATAR_STUDIO_MEDIA_SOURCE,
     AVATAR_STUDIO_SCRIPTWRITER_ROLE,
     AVATAR_STUDIO_SLOT,
     AVATAR_STUDIO_SUBTITLE_FONT,
     AVATAR_STUDIO_SUBTITLE_MODE,
     AVATAR_STUDIO_VIDEO_MODE,
     AVATAR_STUDIO_VIDEO_QUALITY,
-    AVATAR_STUDIO_VOICE_SOURCE,
 } from '../../constants';
 import { FileSchema } from '../file.schema';
 import { JsonObjectSchema, JsonValueSchema } from '../json-value.schema';
@@ -45,34 +41,31 @@ export type AvatarStudioWordTiming = z.infer<typeof AvatarStudioWordTimingSchema
 
 export const AvatarStudioMediaSchema = z.object({
     uuid: z.string().uuid(),
+    // Медиа принадлежит пользователю, а не клипу. Оба поля NULL — общее системное медиа (пресет).
     userId: z.string().uuid().nullable(),
-    clipId: z.string().uuid().nullable(),
-    sceneId: z.string().uuid().nullable(),
+    unregisteredUserId: z.string().uuid().nullable(),
     fileId: z.string().uuid(),
     kind: z.nativeEnum(AVATAR_STUDIO_MEDIA_KIND),
-    source: z.nativeEnum(AVATAR_STUDIO_MEDIA_SOURCE),
-    role: z.nativeEnum(AVATAR_STUDIO_MEDIA_ROLE),
     title: z.string().nullable(),
-    prompt: z.string().nullable(),
+    // Чем медиа сгенерировали, помнит job: media.toolJobId ⇢ job.request.
     toolJobId: z.string().uuid().nullable(),
     durationSeconds: z.number().nullable(),
+    /**
+     * Расшифровка аудио: «что сказано» — вход zero-shot TTS, когда медиа используют образцом.
+     * NULL — расшифровка ещё идёт или не удалась; таким медиа озвучивать нельзя.
+     */
     transcript: z.string().nullable(),
+    /** «Когда сказано», по словам: из этого рисуются субтитры. Свойство файла, не сцены. */
+    wordTimings: z.array(AvatarStudioWordTimingSchema).nullable(),
+    /** Готовые артефакты субтитров от провайдера STT. */
+    subtitles: JsonValueSchema.nullable(),
+    deletedAt: z.date().nullable(),
     file: FileSchema.optional(),
     createdAt: z.date(),
     updatedAt: z.date(),
 });
 export type AvatarStudioMedia = z.infer<typeof AvatarStudioMediaSchema>;
 
-export const AvatarStudioSceneReferenceMediaSchema = z.object({
-    uuid: z.string().uuid(),
-    sceneId: z.string().uuid(),
-    mediaId: z.string().uuid(),
-    position: z.number().int().min(0),
-    media: AvatarStudioMediaSchema.optional(),
-    createdAt: z.date(),
-});
-export type AvatarStudioSceneReferenceMedia = z.infer<typeof AvatarStudioSceneReferenceMediaSchema>;
-
 export const AvatarStudioTrimConfigFields = {
     trimStart: z.number().nonnegative().nullable().default(null),
     trimEnd: z.number().nonnegative().nullable().default(null),
@@ -91,9 +84,13 @@ export const validateAvatarStudioTrim = (
     }
 };
 
+/**
+ * Образец голоса — вход генерации наравне с текстом, поэтому лежит здесь, а не колонкой
+ * сцены: колонки сцены хранят результаты в слотах, конфиги — то, из чего их делают.
+ */
 export const AvatarStudioSceneVoiceConfigBaseSchema = z.object({
     text: z.string().default(''),
-    mediaId: z.string().uuid().nullable().default(null),
+    voiceSampleMediaId: z.string().uuid().nullable().default(null),
     ...AvatarStudioTrimConfigFields,
 });
 
@@ -101,9 +98,17 @@ export const AvatarStudioSceneVoiceConfigSchema =
     AvatarStudioSceneVoiceConfigBaseSchema.superRefine(validateAvatarStudioTrim);
 export type AvatarStudioSceneVoiceConfig = z.infer<typeof AvatarStudioSceneVoiceConfigSchema>;
 
+/**
+ * Референсы — вход генерации кадра, наравне с prompt и style, поэтому лежат здесь,
+ * а не отдельной связью сцены: больше они ни для чего не нужны.
+ *
+ * Верхнюю границу числа референсов задаёт модель (maxAttachedImages), а не контракт:
+ * она разная у разных моделей и приезжает в конфиге.
+ */
 export const AvatarStudioSceneImageConfigSchema = z.object({
     prompt: z.string().nullable().default(null),
     style: z.nativeEnum(AVATAR_STUDIO_IMAGE_STYLE).default(AVATAR_STUDIO_IMAGE_STYLE.UGC),
+    references: z.array(z.string().uuid()).default([]),
 });
 export type AvatarStudioSceneImageConfig = z.infer<typeof AvatarStudioSceneImageConfigSchema>;
 
@@ -123,8 +128,8 @@ export type AvatarStudioSceneVideoConfig = z.infer<typeof AvatarStudioSceneVideo
 export const AvatarStudioSceneGenerationJobSchema = z.object({
     jobId: z.string().uuid(),
     type: z.nativeEnum(AVATAR_STUDIO_JOB_TYPE),
-    phase: z.nativeEnum(AVATAR_STUDIO_JOB_PHASE).nullable(),
-    targetSlot: z.nativeEnum(AVATAR_STUDIO_SLOT),
+    /** NULL — генерация не целится ни в один слот сцены. */
+    targetSlot: z.nativeEnum(AVATAR_STUDIO_SLOT).nullable(),
     status: z.nativeEnum(AVATAR_STUDIO_JOB_STATUS),
     resultMediaId: z.string().uuid().nullable(),
     error: z.string().nullable(),
@@ -140,66 +145,39 @@ export const AvatarStudioSceneSchema = z.object({
     voiceConfig: AvatarStudioSceneVoiceConfigSchema,
     imageConfig: AvatarStudioSceneImageConfigSchema,
     videoConfig: AvatarStudioSceneVideoConfigSchema,
-    frameMediaId: z.string().uuid().nullable(),
-    sceneVideoMediaId: z.string().uuid().nullable(),
+    // Что лежит в слотах сцены прямо сейчас.
     voiceMediaId: z.string().uuid().nullable(),
-    avatarVideoMediaId: z.string().uuid().nullable(),
-    frameStatus: z.nativeEnum(AVATAR_STUDIO_JOB_STATUS),
-    videoStatus: z.nativeEnum(AVATAR_STUDIO_JOB_STATUS),
-    voiceStatus: z.nativeEnum(AVATAR_STUDIO_JOB_STATUS),
-    avatarStatus: z.nativeEnum(AVATAR_STUDIO_JOB_STATUS),
-    frameError: z.string().nullable(),
-    videoError: z.string().nullable(),
-    voiceError: z.string().nullable(),
-    avatarError: z.string().nullable(),
-    wordTimings: z.array(AvatarStudioWordTimingSchema).nullable(),
-    transcript: z.string().nullable(),
-    subtitles: JsonValueSchema.nullable(),
-    frameMedia: AvatarStudioMediaSchema.nullable().optional(),
-    sceneVideoMedia: AvatarStudioMediaSchema.nullable().optional(),
+    frameMediaId: z.string().uuid().nullable(),
+    videoMediaId: z.string().uuid().nullable(),
     voiceMedia: AvatarStudioMediaSchema.nullable().optional(),
-    avatarVideoMedia: AvatarStudioMediaSchema.nullable().optional(),
-    referenceMedia: z.array(AvatarStudioSceneReferenceMediaSchema).optional(),
+    frameMedia: AvatarStudioMediaSchema.nullable().optional(),
+    videoMedia: AvatarStudioMediaSchema.nullable().optional(),
+    /**
+     * Ход генерации слотов. Статус слота — это статус свежайшего job'а с нужным targetSlot;
+     * сцена его не дублирует, чтобы не хранить одно и то же в двух местах.
+     */
     generationJobs: z.array(AvatarStudioSceneGenerationJobSchema).optional(),
     createdAt: z.date(),
     updatedAt: z.date(),
 });
 export type AvatarStudioScene = z.infer<typeof AvatarStudioSceneSchema>;
 
-export const AvatarStudioVoiceSchema = z.object({
-    uuid: z.string().uuid(),
-    userId: z.string().uuid().nullable(),
-    clipId: z.string().uuid().nullable(),
-    title: z.string(),
-    source: z.nativeEnum(AVATAR_STUDIO_VOICE_SOURCE),
-    presetKey: z.string().nullable(),
-    gender: z.enum(['male', 'female']).nullable(),
-    sortOrder: z.number().int().nullable(),
-    sampleMediaId: z.string().uuid().nullable(),
-    sampleText: z.string().nullable(),
-    metadata: JsonObjectSchema.nullable(),
-    sampleMedia: AvatarStudioMediaSchema.nullable().optional(),
-    createdAt: z.date(),
-    updatedAt: z.date(),
-    deletedAt: z.date().nullable(),
-});
-export type AvatarStudioVoice = z.infer<typeof AvatarStudioVoiceSchema>;
-
 export const AvatarStudioGenerationJobBaseSchema = z.object({
     uuid: z.string().uuid(),
-    userId: z.string().uuid(),
+    // Владелец ровно один: зарегистрированный пользователь либо анрег.
+    userId: z.string().uuid().nullable(),
+    unregisteredUserId: z.string().uuid().nullable(),
     clipId: z.string().uuid().nullable(),
     sceneId: z.string().uuid().nullable(),
-    parentJobId: z.string().uuid().nullable(),
     toolJobId: z.string().uuid().nullable(),
     type: z.nativeEnum(AVATAR_STUDIO_JOB_TYPE),
-    phase: z.nativeEnum(AVATAR_STUDIO_JOB_PHASE).nullable(),
-    targetSlot: z.nativeEnum(AVATAR_STUDIO_SLOT),
+    /** NULL — генерация не целится ни в один слот сцены. */
+    targetSlot: z.nativeEnum(AVATAR_STUDIO_SLOT).nullable(),
     status: z.nativeEnum(AVATAR_STUDIO_JOB_STATUS),
     request: JsonObjectSchema.nullable(),
     resultMediaId: z.string().uuid().nullable(),
-    tokenReservationUuid: z.string().uuid().nullable(),
-    price: z.number().nullable(),
+    // tokenReservationUuid и price фронту не нужны: это внутренняя бухгалтерия резервирований.
+    // Колонки в БД остаются — по ним ведётся аудит списаний.
     error: z.string().nullable(),
     resultMedia: AvatarStudioMediaSchema.nullable().optional(),
     startedAt: z.date().nullable(),
@@ -208,14 +186,14 @@ export const AvatarStudioGenerationJobBaseSchema = z.object({
     updatedAt: z.date(),
 });
 
-export const AvatarStudioGenerationJobSchema = AvatarStudioGenerationJobBaseSchema.extend({
-    children: z.array(AvatarStudioGenerationJobBaseSchema).optional(),
-});
+export const AvatarStudioGenerationJobSchema = AvatarStudioGenerationJobBaseSchema;
 export type AvatarStudioGenerationJob = z.infer<typeof AvatarStudioGenerationJobSchema>;
 
 export const AvatarStudioExportJobSchema = z.object({
     uuid: z.string().uuid(),
-    userId: z.string().uuid(),
+    // Владелец ровно один: зарегистрированный пользователь либо анрег.
+    userId: z.string().uuid().nullable(),
+    unregisteredUserId: z.string().uuid().nullable(),
     clipId: z.string().uuid(),
     status: z.nativeEnum(AVATAR_STUDIO_EXPORT_STATUS),
     resultMediaId: z.string().uuid().nullable(),
@@ -231,7 +209,9 @@ export type AvatarStudioExportJob = z.infer<typeof AvatarStudioExportJobSchema>;
 
 export const AvatarStudioScriptwriterMessageSchema = z.object({
     uuid: z.string().uuid(),
-    userId: z.string().uuid(),
+    // Владелец ровно один: зарегистрированный пользователь либо анрег.
+    userId: z.string().uuid().nullable(),
+    unregisteredUserId: z.string().uuid().nullable(),
     clipId: z.string().uuid(),
     sceneId: z.string().uuid().nullable(),
     role: z.nativeEnum(AVATAR_STUDIO_SCRIPTWRITER_ROLE),
@@ -243,16 +223,20 @@ export type AvatarStudioScriptwriterMessage = z.infer<typeof AvatarStudioScriptw
 
 export const AvatarStudioClipSchema = z.object({
     uuid: z.string().uuid(),
-    userId: z.string().uuid(),
+    // Владелец ровно один: зарегистрированный пользователь либо анрег.
+    userId: z.string().uuid().nullable(),
+    unregisteredUserId: z.string().uuid().nullable(),
     title: z.string(),
     subtitleSettings: AvatarStudioSubtitleSettingsSchema,
-    selectedVoiceId: z.string().uuid().nullable(),
     exportMediaId: z.string().uuid().nullable(),
-    selectedVoice: AvatarStudioVoiceSchema.nullable().optional(),
+    /**
+     * Обложка клипа: кадр первой по порядку сцены, у которой он есть. NULL — кадров нет ни у одной.
+     * Считается на лету из уже загруженных сцен, отдельного поля в БД нет.
+     */
+    previewUrl: z.string().nullable(),
     exportMedia: AvatarStudioMediaSchema.nullable().optional(),
     scenes: z.array(AvatarStudioSceneSchema).optional(),
-    media: z.array(AvatarStudioMediaSchema).optional(),
-    voices: z.array(AvatarStudioVoiceSchema).optional(),
+    // Медиатеки у клипа нет: она принадлежит пользователю — GET /media?owner=me.
     generationJobs: z.array(AvatarStudioGenerationJobSchema).optional(),
     exportJobs: z.array(AvatarStudioExportJobSchema).optional(),
     scriptwriterMessages: z.array(AvatarStudioScriptwriterMessageSchema).optional(),

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@purpleschool/gptbot",
-  "version": "0.14.27-stage2",
+  "version": "0.14.28",
   "description": "",
   "main": "build/index.js",
   "types": "build/index.d.ts",

package/build/commands/avatar-studio/generation-job/generate-avatar-studio-library-image.command.js

@@ -1,20 +0,0 @@
-"use strict";
-Object.defineProperty(exports, "__esModule", { value: true });
-exports.GenerateAvatarStudioLibraryImageCommand = void 0;
-const zod_1 = require("zod");
-const models_1 = require("../../../models");
-const avatar_studio_common_schema_1 = require("../shared/avatar-studio-common.schema");
-var GenerateAvatarStudioLibraryImageCommand;
-(function (GenerateAvatarStudioLibraryImageCommand) {
-    GenerateAvatarStudioLibraryImageCommand.ParamsSchema = avatar_studio_common_schema_1.AvatarStudioClipIdParamsSchema;
-    GenerateAvatarStudioLibraryImageCommand.RequestSchema = zod_1.z
-        .object({
-        prompt: zod_1.z.string().trim().min(1),
-        referenceMediaIds: avatar_studio_common_schema_1.AvatarStudioUuidListSchema.optional(),
-        aspectRatio: models_1.AvatarStudioAspectRatioSchema.default('9:16'),
-    })
-        .strict();
-    GenerateAvatarStudioLibraryImageCommand.ResponseSchema = zod_1.z.object({
-        data: models_1.AvatarStudioGenerationJobSchema,
-    });
-})(GenerateAvatarStudioLibraryImageCommand || (exports.GenerateAvatarStudioLibraryImageCommand = GenerateAvatarStudioLibraryImageCommand = {}));

package/build/commands/avatar-studio/generation-job/generate-avatar-studio-media-image.command.js

@@ -1,19 +0,0 @@
-"use strict";
-Object.defineProperty(exports, "__esModule", { value: true });
-exports.GenerateAvatarStudioMediaImageCommand = void 0;
-const zod_1 = require("zod");
-const models_1 = require("../../../models");
-const avatar_studio_common_schema_1 = require("../shared/avatar-studio-common.schema");
-var GenerateAvatarStudioMediaImageCommand;
-(function (GenerateAvatarStudioMediaImageCommand) {
-    GenerateAvatarStudioMediaImageCommand.RequestSchema = zod_1.z
-        .object({
-        prompt: zod_1.z.string().trim().min(1),
-        referenceMediaIds: avatar_studio_common_schema_1.AvatarStudioUuidListSchema.optional(),
-        aspectRatio: models_1.AvatarStudioAspectRatioSchema.default('9:16'),
-    })
-        .strict();
-    GenerateAvatarStudioMediaImageCommand.ResponseSchema = zod_1.z.object({
-        data: models_1.AvatarStudioGenerationJobSchema,
-    });
-})(GenerateAvatarStudioMediaImageCommand || (exports.GenerateAvatarStudioMediaImageCommand = GenerateAvatarStudioMediaImageCommand = {}));