@purpleschool/gptbot 0.14.27 → 0.14.28

package/build/commands/avatar-studio/shared/get-avatar-studio-config.query.js

@@ -11,12 +11,29 @@ const AvatarStudioGenerationPriceSchema = zod_1.z
     pricePerSymbol: zod_1.z.number().nonnegative().optional(),
 })
     .strict();
+/**
+ * Картинки генерирует одна модель, с референсами и без. Наценка за референсы плоская:
+ * её берёт сам инструмент за факт вложения, количество картинок значения не имеет.
+ */
+const AvatarStudioImagePricingSchema = zod_1.z
+    .object({
+    base: AvatarStudioGenerationPriceSchema.nullable(),
+    referenceSurcharge: zod_1.z.number().nonnegative(),
+})
+    .strict();
 const AvatarStudioConfigSectionBaseSchema = zod_1.z
     .object({
     available: zod_1.z.boolean(),
-    unavailableReason: zod_1.z.string().optional(),
+    /** Присутствует только когда available = false. */
+    unavailableReason: zod_1.z.nativeEnum(constants_1.AVATAR_STUDIO_UNAVAILABLE_REASON).optional(),
 })
     .strict();
+/**
+ * Сценарист доступен не всем: у анрега нет доступа к его модели. Цены здесь нет: она зависит
+ * от длины ввода и считается на лету — POST scriptwriter/price. Конфиг отвечает только на
+ * вопрос «можно ли пользоваться».
+ */
+const AvatarStudioScriptwriterConfigSectionSchema = AvatarStudioConfigSectionBaseSchema;
 const AvatarStudioTextFieldSchema = zod_1.z
     .object({
     kind: zod_1.z.literal('text'),
@@ -36,7 +53,6 @@ const AvatarStudioMediaFieldSchema = zod_1.z
     kind: zod_1.z.literal('media'),
     required: zod_1.z.boolean(),
     mediaKind: zod_1.z.nativeEnum(constants_1.AVATAR_STUDIO_MEDIA_KIND),
-    mediaRole: zod_1.z.nativeEnum(constants_1.AVATAR_STUDIO_MEDIA_ROLE),
 })
     .strict();
 const AvatarStudioMediaArrayFieldSchema = zod_1.z
@@ -44,6 +60,8 @@ const AvatarStudioMediaArrayFieldSchema = zod_1.z
     kind: zod_1.z.literal('media-array'),
     required: zod_1.z.boolean(),
     supported: zod_1.z.boolean(),
+    /** Предел задаёт модель (maxAttachedImages), поэтому он приезжает сюда, а не зашит в контракт. */
+    maxCount: zod_1.z.number().int().nonnegative(),
 })
     .strict();
 const AvatarStudioFixedFieldSchema = (valueSchema) => zod_1.z
@@ -73,10 +91,11 @@ const AvatarStudioAudioConfigSectionSchema = AvatarStudioConfigSectionBaseSchema
         text: AvatarStudioTextFieldSchema.extend({
             required: zod_1.z.boolean(),
         }),
-        mediaId: AvatarStudioMediaFieldSchema.extend({
+        // Образец голоса — вход генерации наравне с текстом, поэтому живёт
+        // в voiceConfig и ставится через PATCH .../scenes/:sceneId.
+        voiceSampleMediaId: AvatarStudioMediaFieldSchema.extend({
             required: zod_1.z.boolean(),
             mediaKind: zod_1.z.literal(constants_1.AVATAR_STUDIO_MEDIA_KIND.AUDIO),
-            mediaRole: zod_1.z.literal(constants_1.AVATAR_STUDIO_MEDIA_ROLE.VOICE_SAMPLE),
         }),
     })
         .strict(),
@@ -95,7 +114,7 @@ const AvatarStudioFrameConfigSectionSchema = AvatarStudioConfigSectionBaseSchema
         style: AvatarStudioSelectFieldSchema(zod_1.z.nativeEnum(constants_1.AVATAR_STUDIO_IMAGE_STYLE)).extend({
             required: zod_1.z.boolean(),
         }),
-        referenceMediaIds: AvatarStudioMediaArrayFieldSchema.extend({
+        references: AvatarStudioMediaArrayFieldSchema.extend({
             required: zod_1.z.boolean(),
         }),
         aspectRatio: AvatarStudioFixedFieldSchema(zod_1.z.literal('9:16')),
@@ -104,12 +123,7 @@ const AvatarStudioFrameConfigSectionSchema = AvatarStudioConfigSectionBaseSchema
     defaults: models_1.AvatarStudioSceneImageConfigSchema.extend({
         aspectRatio: zod_1.z.literal('9:16'),
     }),
-    pricing: zod_1.z
-        .object({
-        withoutReference: AvatarStudioGenerationPriceSchema.nullable(),
-        withReference: AvatarStudioGenerationPriceSchema.nullable(),
-    })
-        .strict(),
+    pricing: AvatarStudioImagePricingSchema,
 });
 const AvatarStudioVideoConfigSectionSchema = AvatarStudioConfigSectionBaseSchema.extend({
     fields: zod_1.z
@@ -152,7 +166,7 @@ const AvatarStudioLibraryImageConfigSectionSchema = AvatarStudioConfigSectionBas
     fields: zod_1.z
         .object({
         prompt: AvatarStudioTextFieldSchema.extend({ required: zod_1.z.boolean() }),
-        referenceMediaIds: AvatarStudioMediaArrayFieldSchema.extend({
+        references: AvatarStudioMediaArrayFieldSchema.extend({
             required: zod_1.z.boolean(),
         }),
         aspectRatio: AvatarStudioSelectFieldSchema(models_1.AvatarStudioAspectRatioSchema).extend({
@@ -166,12 +180,7 @@ const AvatarStudioLibraryImageConfigSectionSchema = AvatarStudioConfigSectionBas
         aspectRatio: models_1.AvatarStudioAspectRatioSchema,
     })
         .strict(),
-    pricing: zod_1.z
-        .object({
-        withoutReference: AvatarStudioGenerationPriceSchema.nullable(),
-        withReference: AvatarStudioGenerationPriceSchema.nullable(),
-    })
-        .strict(),
+    pricing: AvatarStudioImagePricingSchema,
 });
 var GetAvatarStudioConfigQuery;
 (function (GetAvatarStudioConfigQuery) {
@@ -182,6 +191,7 @@ var GetAvatarStudioConfigQuery;
             frame: AvatarStudioFrameConfigSectionSchema,
             video: AvatarStudioVideoConfigSectionSchema,
             libraryImage: AvatarStudioLibraryImageConfigSectionSchema,
+            scriptwriter: AvatarStudioScriptwriterConfigSectionSchema,
         })
             .strict(),
     });

package/build/commands/avatar-studio/voice/design-avatar-studio-voice.command.js

@@ -3,10 +3,8 @@ Object.defineProperty(exports, "__esModule", { value: true });
 exports.DesignAvatarStudioVoiceCommand = 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 DesignAvatarStudioVoiceCommand;
 (function (DesignAvatarStudioVoiceCommand) {
-    DesignAvatarStudioVoiceCommand.ParamsSchema = avatar_studio_common_schema_1.AvatarStudioClipIdParamsSchema;
     DesignAvatarStudioVoiceCommand.RequestSchema = zod_1.z
         .object({
         title: zod_1.z.string().trim().min(1).optional(),
@@ -14,11 +12,11 @@ var DesignAvatarStudioVoiceCommand;
         language: zod_1.z.string().trim().min(2).optional(),
     })
         .strict();
+    /**
+     * Отдаём job, как и все остальные генерации: созданный голос лежит в job.resultMedia.
+     * Отдельного поля media нет — форма ответа одинакова у всех роутов генерации.
+     */
     DesignAvatarStudioVoiceCommand.ResponseSchema = zod_1.z.object({
-        data: zod_1.z.object({
-            job: models_1.AvatarStudioGenerationJobSchema,
-            voice: models_1.AvatarStudioVoiceSchema,
-            media: models_1.AvatarStudioMediaSchema,
-        }),
+        data: models_1.AvatarStudioGenerationJobSchema,
     });
 })(DesignAvatarStudioVoiceCommand || (exports.DesignAvatarStudioVoiceCommand = DesignAvatarStudioVoiceCommand = {}));

package/build/commands/avatar-studio/voice/index.js

@@ -15,6 +15,3 @@ var __exportStar = (this && this.__exportStar) || function(m, exports) {
 };
 Object.defineProperty(exports, "__esModule", { value: true });
 __exportStar(require("./design-avatar-studio-voice.command"), exports);
-__exportStar(require("./find-avatar-studio-clip-voices.query"), exports);
-__exportStar(require("./find-avatar-studio-voices.query"), exports);
-__exportStar(require("./update-avatar-studio-clip-voice.command"), exports);

package/build/constants/avatar-studio/enums/avatar-studio-job-type.enum.js

@@ -6,11 +6,8 @@ var AVATAR_STUDIO_JOB_TYPE;
     AVATAR_STUDIO_JOB_TYPE["FRAME_IMAGE"] = "frame_image";
     AVATAR_STUDIO_JOB_TYPE["LIBRARY_IMAGE"] = "library_image";
     AVATAR_STUDIO_JOB_TYPE["SCENE_VIDEO"] = "scene_video";
-    AVATAR_STUDIO_JOB_TYPE["SCENE_VOICE"] = "scene_voice";
     AVATAR_STUDIO_JOB_TYPE["VOICE_TTS"] = "voice_tts";
     AVATAR_STUDIO_JOB_TYPE["VOICE_STT"] = "voice_stt";
-    AVATAR_STUDIO_JOB_TYPE["VOICE_TIMINGS"] = "voice_timings";
     AVATAR_STUDIO_JOB_TYPE["TALKING_AVATAR"] = "talking_avatar";
     AVATAR_STUDIO_JOB_TYPE["VOICE_DESIGN"] = "voice_design";
-    AVATAR_STUDIO_JOB_TYPE["SCRIPTWRITER"] = "scriptwriter";
 })(AVATAR_STUDIO_JOB_TYPE || (exports.AVATAR_STUDIO_JOB_TYPE = AVATAR_STUDIO_JOB_TYPE = {}));

package/build/constants/avatar-studio/enums/avatar-studio-slot.enum.js

@@ -1,15 +1,18 @@
 "use strict";
 Object.defineProperty(exports, "__esModule", { value: true });
 exports.AVATAR_STUDIO_SLOT = void 0;
+/**
+ * Слоты-результаты сцены: в каждом ровно одно медиа за раз.
+ *
+ * Здесь только то, что действительно является слотом сцены:
+ * - аватар и b-roll — два способа получить VIDEO, а не два слота (режим в videoConfig.videoMode);
+ * - образец голоса — вход сцены (scene.voiceSampleMediaId), а не её результат;
+ * - референсы — несколько упорядоченных медиа, у них своя join-таблица;
+ * - «медиатека» слотом никогда не была: у таких job'ов targetSlot = null.
+ */
 var AVATAR_STUDIO_SLOT;
 (function (AVATAR_STUDIO_SLOT) {
+    AVATAR_STUDIO_SLOT["VOICE"] = "voice";
     AVATAR_STUDIO_SLOT["FRAME"] = "frame";
     AVATAR_STUDIO_SLOT["VIDEO"] = "video";
-    AVATAR_STUDIO_SLOT["VOICE"] = "voice";
-    AVATAR_STUDIO_SLOT["AVATAR"] = "avatar";
-    AVATAR_STUDIO_SLOT["LIBRARY"] = "library";
-    AVATAR_STUDIO_SLOT["VOICE_TIMINGS"] = "voice_timings";
-    AVATAR_STUDIO_SLOT["VOICE_SAMPLE"] = "voice_sample";
-    AVATAR_STUDIO_SLOT["SCRIPTWRITER"] = "scriptwriter";
-    AVATAR_STUDIO_SLOT["EXPORT"] = "export";
 })(AVATAR_STUDIO_SLOT || (exports.AVATAR_STUDIO_SLOT = AVATAR_STUDIO_SLOT = {}));

package/build/constants/avatar-studio/enums/avatar-studio-unavailable-reason.enum.js

@@ -0,0 +1,16 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.AVATAR_STUDIO_UNAVAILABLE_REASON = void 0;
+var AVATAR_STUDIO_UNAVAILABLE_REASON;
+(function (AVATAR_STUDIO_UNAVAILABLE_REASON) {
+    /**
+     * Функция есть, но этому пользователю не положена: анрег либо нет подходящей подписки.
+     * Фронт вправе звать зарегистрироваться или улучшить тариф.
+     */
+    AVATAR_STUDIO_UNAVAILABLE_REASON["NO_ACCESS"] = "no_access";
+    /**
+     * Модель выключена, не найдена или проверка доступа не удалась. Пользователь ни при чём,
+     * звать его никуда не нужно — это наша проблема.
+     */
+    AVATAR_STUDIO_UNAVAILABLE_REASON["MODEL_UNAVAILABLE"] = "model_unavailable";
+})(AVATAR_STUDIO_UNAVAILABLE_REASON || (exports.AVATAR_STUDIO_UNAVAILABLE_REASON = AVATAR_STUDIO_UNAVAILABLE_REASON = {}));

package/build/constants/avatar-studio/enums/index.js

@@ -16,17 +16,13 @@ var __exportStar = (this && this.__exportStar) || function(m, exports) {
 Object.defineProperty(exports, "__esModule", { value: true });
 __exportStar(require("./avatar-studio-export-status.enum"), exports);
 __exportStar(require("./avatar-studio-image-style.enum"), exports);
-__exportStar(require("./avatar-studio-job-phase.enum"), exports);
 __exportStar(require("./avatar-studio-job-status.enum"), exports);
 __exportStar(require("./avatar-studio-job-type.enum"), exports);
 __exportStar(require("./avatar-studio-media-kind.enum"), exports);
-__exportStar(require("./avatar-studio-media-role.enum"), exports);
-__exportStar(require("./avatar-studio-media-source.enum"), exports);
-__exportStar(require("./avatar-studio-scene-kind.enum"), exports);
 __exportStar(require("./avatar-studio-scriptwriter-role.enum"), exports);
 __exportStar(require("./avatar-studio-slot.enum"), exports);
 __exportStar(require("./avatar-studio-subtitle-font.enum"), exports);
+__exportStar(require("./avatar-studio-unavailable-reason.enum"), exports);
 __exportStar(require("./avatar-studio-subtitle-mode.enum"), exports);
 __exportStar(require("./avatar-studio-video-mode.enum"), exports);
 __exportStar(require("./avatar-studio-video-quality.enum"), exports);
-__exportStar(require("./avatar-studio-voice-source.enum"), exports);

package/build/models/avatar-studio/avatar-studio.schema.js

@@ -1,6 +1,6 @@
 "use strict";
 Object.defineProperty(exports, "__esModule", { value: true });
-exports.AvatarStudioClipSchema = exports.AvatarStudioScriptwriterMessageSchema = exports.AvatarStudioExportJobSchema = exports.AvatarStudioGenerationJobSchema = exports.AvatarStudioGenerationJobBaseSchema = exports.AvatarStudioVoiceSchema = exports.AvatarStudioSceneSchema = exports.AvatarStudioSceneGenerationJobSchema = exports.AvatarStudioSceneVideoConfigSchema = exports.AvatarStudioSceneVideoConfigBaseSchema = exports.AvatarStudioSceneImageConfigSchema = exports.AvatarStudioSceneVoiceConfigSchema = exports.AvatarStudioSceneVoiceConfigBaseSchema = exports.validateAvatarStudioTrim = exports.AvatarStudioTrimConfigFields = exports.AvatarStudioSceneReferenceMediaSchema = exports.AvatarStudioMediaSchema = exports.AvatarStudioWordTimingSchema = exports.AvatarStudioSubtitleSettingsSchema = exports.AvatarStudioAspectRatioSchema = void 0;
+exports.AvatarStudioClipSchema = exports.AvatarStudioScriptwriterMessageSchema = exports.AvatarStudioExportJobSchema = exports.AvatarStudioGenerationJobSchema = exports.AvatarStudioGenerationJobBaseSchema = exports.AvatarStudioSceneSchema = exports.AvatarStudioSceneGenerationJobSchema = exports.AvatarStudioSceneVideoConfigSchema = exports.AvatarStudioSceneVideoConfigBaseSchema = exports.AvatarStudioSceneImageConfigSchema = exports.AvatarStudioSceneVoiceConfigSchema = exports.AvatarStudioSceneVoiceConfigBaseSchema = exports.validateAvatarStudioTrim = exports.AvatarStudioTrimConfigFields = exports.AvatarStudioMediaSchema = exports.AvatarStudioWordTimingSchema = exports.AvatarStudioSubtitleSettingsSchema = exports.AvatarStudioAspectRatioSchema = void 0;
 const zod_1 = require("zod");
 const constants_1 = require("../../constants");
 const file_schema_1 = require("../file.schema");
@@ -24,30 +24,29 @@ exports.AvatarStudioWordTimingSchema = zod_1.z.object({
 });
 exports.AvatarStudioMediaSchema = zod_1.z.object({
     uuid: zod_1.z.string().uuid(),
+    // Медиа принадлежит пользователю, а не клипу. Оба поля NULL — общее системное медиа (пресет).
     userId: zod_1.z.string().uuid().nullable(),
-    clipId: zod_1.z.string().uuid().nullable(),
-    sceneId: zod_1.z.string().uuid().nullable(),
+    unregisteredUserId: zod_1.z.string().uuid().nullable(),
     fileId: zod_1.z.string().uuid(),
     kind: zod_1.z.nativeEnum(constants_1.AVATAR_STUDIO_MEDIA_KIND),
-    source: zod_1.z.nativeEnum(constants_1.AVATAR_STUDIO_MEDIA_SOURCE),
-    role: zod_1.z.nativeEnum(constants_1.AVATAR_STUDIO_MEDIA_ROLE),
     title: zod_1.z.string().nullable(),
-    prompt: zod_1.z.string().nullable(),
+    // Чем медиа сгенерировали, помнит job: media.toolJobId ⇢ job.request.
     toolJobId: zod_1.z.string().uuid().nullable(),
     durationSeconds: zod_1.z.number().nullable(),
+    /**
+     * Расшифровка аудио: «что сказано» — вход zero-shot TTS, когда медиа используют образцом.
+     * NULL — расшифровка ещё идёт или не удалась; таким медиа озвучивать нельзя.
+     */
     transcript: zod_1.z.string().nullable(),
+    /** «Когда сказано», по словам: из этого рисуются субтитры. Свойство файла, не сцены. */
+    wordTimings: zod_1.z.array(exports.AvatarStudioWordTimingSchema).nullable(),
+    /** Готовые артефакты субтитров от провайдера STT. */
+    subtitles: json_value_schema_1.JsonValueSchema.nullable(),
+    deletedAt: zod_1.z.date().nullable(),
     file: file_schema_1.FileSchema.optional(),
     createdAt: zod_1.z.date(),
     updatedAt: zod_1.z.date(),
 });
-exports.AvatarStudioSceneReferenceMediaSchema = zod_1.z.object({
-    uuid: zod_1.z.string().uuid(),
-    sceneId: zod_1.z.string().uuid(),
-    mediaId: zod_1.z.string().uuid(),
-    position: zod_1.z.number().int().min(0),
-    media: exports.AvatarStudioMediaSchema.optional(),
-    createdAt: zod_1.z.date(),
-});
 exports.AvatarStudioTrimConfigFields = {
     trimStart: zod_1.z.number().nonnegative().nullable().default(null),
     trimEnd: zod_1.z.number().nonnegative().nullable().default(null),
@@ -62,19 +61,31 @@ const validateAvatarStudioTrim = ({ trimStart, trimEnd }, ctx) => {
     }
 };
 exports.validateAvatarStudioTrim = validateAvatarStudioTrim;
-exports.AvatarStudioSceneVoiceConfigBaseSchema = zod_1.z.object(Object.assign({ text: zod_1.z.string().default(''), mediaId: zod_1.z.string().uuid().nullable().default(null) }, exports.AvatarStudioTrimConfigFields));
+/**
+ * Образец голоса — вход генерации наравне с текстом, поэтому лежит здесь, а не колонкой
+ * сцены: колонки сцены хранят результаты в слотах, конфиги — то, из чего их делают.
+ */
+exports.AvatarStudioSceneVoiceConfigBaseSchema = zod_1.z.object(Object.assign({ text: zod_1.z.string().default(''), voiceSampleMediaId: zod_1.z.string().uuid().nullable().default(null) }, exports.AvatarStudioTrimConfigFields));
 exports.AvatarStudioSceneVoiceConfigSchema = exports.AvatarStudioSceneVoiceConfigBaseSchema.superRefine(exports.validateAvatarStudioTrim);
+/**
+ * Референсы — вход генерации кадра, наравне с prompt и style, поэтому лежат здесь,
+ * а не отдельной связью сцены: больше они ни для чего не нужны.
+ *
+ * Верхнюю границу числа референсов задаёт модель (maxAttachedImages), а не контракт:
+ * она разная у разных моделей и приезжает в конфиге.
+ */
 exports.AvatarStudioSceneImageConfigSchema = zod_1.z.object({
     prompt: zod_1.z.string().nullable().default(null),
     style: zod_1.z.nativeEnum(constants_1.AVATAR_STUDIO_IMAGE_STYLE).default(constants_1.AVATAR_STUDIO_IMAGE_STYLE.UGC),
+    references: zod_1.z.array(zod_1.z.string().uuid()).default([]),
 });
 exports.AvatarStudioSceneVideoConfigBaseSchema = zod_1.z.object(Object.assign({ prompt: zod_1.z.string().nullable().default(null), durationSeconds: zod_1.z.number().positive().default(5), videoMode: zod_1.z.nativeEnum(constants_1.AVATAR_STUDIO_VIDEO_MODE).default(constants_1.AVATAR_STUDIO_VIDEO_MODE.B_ROLL), quality: zod_1.z.nativeEnum(constants_1.AVATAR_STUDIO_VIDEO_QUALITY).default(constants_1.AVATAR_STUDIO_VIDEO_QUALITY.P720), sound: zod_1.z.boolean().default(false) }, exports.AvatarStudioTrimConfigFields));
 exports.AvatarStudioSceneVideoConfigSchema = exports.AvatarStudioSceneVideoConfigBaseSchema.superRefine(exports.validateAvatarStudioTrim);
 exports.AvatarStudioSceneGenerationJobSchema = zod_1.z.object({
     jobId: zod_1.z.string().uuid(),
     type: zod_1.z.nativeEnum(constants_1.AVATAR_STUDIO_JOB_TYPE),
-    phase: zod_1.z.nativeEnum(constants_1.AVATAR_STUDIO_JOB_PHASE).nullable(),
-    targetSlot: zod_1.z.nativeEnum(constants_1.AVATAR_STUDIO_SLOT),
+    /** NULL — генерация не целится ни в один слот сцены. */
+    targetSlot: zod_1.z.nativeEnum(constants_1.AVATAR_STUDIO_SLOT).nullable(),
     status: zod_1.z.nativeEnum(constants_1.AVATAR_STUDIO_JOB_STATUS),
     resultMediaId: zod_1.z.string().uuid().nullable(),
     error: zod_1.z.string().nullable(),
@@ -88,62 +99,37 @@ exports.AvatarStudioSceneSchema = zod_1.z.object({
     voiceConfig: exports.AvatarStudioSceneVoiceConfigSchema,
     imageConfig: exports.AvatarStudioSceneImageConfigSchema,
     videoConfig: exports.AvatarStudioSceneVideoConfigSchema,
-    frameMediaId: zod_1.z.string().uuid().nullable(),
-    sceneVideoMediaId: zod_1.z.string().uuid().nullable(),
+    // Что лежит в слотах сцены прямо сейчас.
     voiceMediaId: zod_1.z.string().uuid().nullable(),
-    avatarVideoMediaId: zod_1.z.string().uuid().nullable(),
-    frameStatus: zod_1.z.nativeEnum(constants_1.AVATAR_STUDIO_JOB_STATUS),
-    videoStatus: zod_1.z.nativeEnum(constants_1.AVATAR_STUDIO_JOB_STATUS),
-    voiceStatus: zod_1.z.nativeEnum(constants_1.AVATAR_STUDIO_JOB_STATUS),
-    avatarStatus: zod_1.z.nativeEnum(constants_1.AVATAR_STUDIO_JOB_STATUS),
-    frameError: zod_1.z.string().nullable(),
-    videoError: zod_1.z.string().nullable(),
-    voiceError: zod_1.z.string().nullable(),
-    avatarError: zod_1.z.string().nullable(),
-    wordTimings: zod_1.z.array(exports.AvatarStudioWordTimingSchema).nullable(),
-    transcript: zod_1.z.string().nullable(),
-    subtitles: json_value_schema_1.JsonValueSchema.nullable(),
-    frameMedia: exports.AvatarStudioMediaSchema.nullable().optional(),
-    sceneVideoMedia: exports.AvatarStudioMediaSchema.nullable().optional(),
+    frameMediaId: zod_1.z.string().uuid().nullable(),
+    videoMediaId: zod_1.z.string().uuid().nullable(),
     voiceMedia: exports.AvatarStudioMediaSchema.nullable().optional(),
-    avatarVideoMedia: exports.AvatarStudioMediaSchema.nullable().optional(),
-    referenceMedia: zod_1.z.array(exports.AvatarStudioSceneReferenceMediaSchema).optional(),
+    frameMedia: exports.AvatarStudioMediaSchema.nullable().optional(),
+    videoMedia: exports.AvatarStudioMediaSchema.nullable().optional(),
+    /**
+     * Ход генерации слотов. Статус слота — это статус свежайшего job'а с нужным targetSlot;
+     * сцена его не дублирует, чтобы не хранить одно и то же в двух местах.
+     */
     generationJobs: zod_1.z.array(exports.AvatarStudioSceneGenerationJobSchema).optional(),
     createdAt: zod_1.z.date(),
     updatedAt: zod_1.z.date(),
 });
-exports.AvatarStudioVoiceSchema = zod_1.z.object({
-    uuid: zod_1.z.string().uuid(),
-    userId: zod_1.z.string().uuid().nullable(),
-    clipId: zod_1.z.string().uuid().nullable(),
-    title: zod_1.z.string(),
-    source: zod_1.z.nativeEnum(constants_1.AVATAR_STUDIO_VOICE_SOURCE),
-    presetKey: zod_1.z.string().nullable(),
-    gender: zod_1.z.enum(['male', 'female']).nullable(),
-    sortOrder: zod_1.z.number().int().nullable(),
-    sampleMediaId: zod_1.z.string().uuid().nullable(),
-    sampleText: zod_1.z.string().nullable(),
-    metadata: json_value_schema_1.JsonObjectSchema.nullable(),
-    sampleMedia: exports.AvatarStudioMediaSchema.nullable().optional(),
-    createdAt: zod_1.z.date(),
-    updatedAt: zod_1.z.date(),
-    deletedAt: zod_1.z.date().nullable(),
-});
 exports.AvatarStudioGenerationJobBaseSchema = zod_1.z.object({
     uuid: zod_1.z.string().uuid(),
-    userId: zod_1.z.string().uuid(),
+    // Владелец ровно один: зарегистрированный пользователь либо анрег.
+    userId: zod_1.z.string().uuid().nullable(),
+    unregisteredUserId: zod_1.z.string().uuid().nullable(),
     clipId: zod_1.z.string().uuid().nullable(),
     sceneId: zod_1.z.string().uuid().nullable(),
-    parentJobId: zod_1.z.string().uuid().nullable(),
     toolJobId: zod_1.z.string().uuid().nullable(),
     type: zod_1.z.nativeEnum(constants_1.AVATAR_STUDIO_JOB_TYPE),
-    phase: zod_1.z.nativeEnum(constants_1.AVATAR_STUDIO_JOB_PHASE).nullable(),
-    targetSlot: zod_1.z.nativeEnum(constants_1.AVATAR_STUDIO_SLOT),
+    /** NULL — генерация не целится ни в один слот сцены. */
+    targetSlot: zod_1.z.nativeEnum(constants_1.AVATAR_STUDIO_SLOT).nullable(),
     status: zod_1.z.nativeEnum(constants_1.AVATAR_STUDIO_JOB_STATUS),
     request: json_value_schema_1.JsonObjectSchema.nullable(),
     resultMediaId: zod_1.z.string().uuid().nullable(),
-    tokenReservationUuid: zod_1.z.string().uuid().nullable(),
-    price: zod_1.z.number().nullable(),
+    // tokenReservationUuid и price фронту не нужны: это внутренняя бухгалтерия резервирований.
+    // Колонки в БД остаются — по ним ведётся аудит списаний.
     error: zod_1.z.string().nullable(),
     resultMedia: exports.AvatarStudioMediaSchema.nullable().optional(),
     startedAt: zod_1.z.date().nullable(),
@@ -151,12 +137,12 @@ exports.AvatarStudioGenerationJobBaseSchema = zod_1.z.object({
     createdAt: zod_1.z.date(),
     updatedAt: zod_1.z.date(),
 });
-exports.AvatarStudioGenerationJobSchema = exports.AvatarStudioGenerationJobBaseSchema.extend({
-    children: zod_1.z.array(exports.AvatarStudioGenerationJobBaseSchema).optional(),
-});
+exports.AvatarStudioGenerationJobSchema = exports.AvatarStudioGenerationJobBaseSchema;
 exports.AvatarStudioExportJobSchema = zod_1.z.object({
     uuid: zod_1.z.string().uuid(),
-    userId: zod_1.z.string().uuid(),
+    // Владелец ровно один: зарегистрированный пользователь либо анрег.
+    userId: zod_1.z.string().uuid().nullable(),
+    unregisteredUserId: zod_1.z.string().uuid().nullable(),
     clipId: zod_1.z.string().uuid(),
     status: zod_1.z.nativeEnum(constants_1.AVATAR_STUDIO_EXPORT_STATUS),
     resultMediaId: zod_1.z.string().uuid().nullable(),
@@ -170,7 +156,9 @@ exports.AvatarStudioExportJobSchema = zod_1.z.object({
 });
 exports.AvatarStudioScriptwriterMessageSchema = zod_1.z.object({
     uuid: zod_1.z.string().uuid(),
-    userId: zod_1.z.string().uuid(),
+    // Владелец ровно один: зарегистрированный пользователь либо анрег.
+    userId: zod_1.z.string().uuid().nullable(),
+    unregisteredUserId: zod_1.z.string().uuid().nullable(),
     clipId: zod_1.z.string().uuid(),
     sceneId: zod_1.z.string().uuid().nullable(),
     role: zod_1.z.nativeEnum(constants_1.AVATAR_STUDIO_SCRIPTWRITER_ROLE),
@@ -180,16 +168,20 @@ exports.AvatarStudioScriptwriterMessageSchema = zod_1.z.object({
 });
 exports.AvatarStudioClipSchema = zod_1.z.object({
     uuid: zod_1.z.string().uuid(),
-    userId: zod_1.z.string().uuid(),
+    // Владелец ровно один: зарегистрированный пользователь либо анрег.
+    userId: zod_1.z.string().uuid().nullable(),
+    unregisteredUserId: zod_1.z.string().uuid().nullable(),
     title: zod_1.z.string(),
     subtitleSettings: exports.AvatarStudioSubtitleSettingsSchema,
-    selectedVoiceId: zod_1.z.string().uuid().nullable(),
     exportMediaId: zod_1.z.string().uuid().nullable(),
-    selectedVoice: exports.AvatarStudioVoiceSchema.nullable().optional(),
+    /**
+     * Обложка клипа: кадр первой по порядку сцены, у которой он есть. NULL — кадров нет ни у одной.
+     * Считается на лету из уже загруженных сцен, отдельного поля в БД нет.
+     */
+    previewUrl: zod_1.z.string().nullable(),
     exportMedia: exports.AvatarStudioMediaSchema.nullable().optional(),
     scenes: zod_1.z.array(exports.AvatarStudioSceneSchema).optional(),
-    media: zod_1.z.array(exports.AvatarStudioMediaSchema).optional(),
-    voices: zod_1.z.array(exports.AvatarStudioVoiceSchema).optional(),
+    // Медиатеки у клипа нет: она принадлежит пользователю — GET /media?owner=me.
     generationJobs: zod_1.z.array(exports.AvatarStudioGenerationJobSchema).optional(),
     exportJobs: zod_1.z.array(exports.AvatarStudioExportJobSchema).optional(),
     scriptwriterMessages: zod_1.z.array(exports.AvatarStudioScriptwriterMessageSchema).optional(),

package/commands/avatar-studio/generation-job/generate-avatar-studio-frame.command.ts

@@ -10,11 +10,12 @@ export namespace GenerateAvatarStudioFrameCommand {
     export const ParamsSchema = AvatarStudioSceneIdParamsSchema;
     export type Params = z.infer<typeof ParamsSchema>;
 
+    /** Все три поля — параметры imageConfig сцены: они же в неё и сохраняются. */
     export const RequestSchema = z
         .object({
             prompt: z.string().trim().min(1),
             style: z.nativeEnum(AVATAR_STUDIO_IMAGE_STYLE).default(AVATAR_STUDIO_IMAGE_STYLE.UGC),
-            referenceMediaIds: AvatarStudioUuidListSchema.optional(),
+            references: AvatarStudioUuidListSchema,
         })
         .strict();
     export type Request = z.infer<typeof RequestSchema>;

package/commands/avatar-studio/generation-job/{generate-avatar-studio-media-image.command.ts → generate-avatar-studio-image.command.ts}

@@ -2,7 +2,11 @@ import { z } from 'zod';
 import { AvatarStudioAspectRatioSchema, AvatarStudioGenerationJobSchema } from '../../../models';
 import { AvatarStudioUuidListSchema } from '../shared/avatar-studio-common.schema';
 
-export namespace GenerateAvatarStudioMediaImageCommand {
+/**
+ * Генерация изображения в медиатеку пользователя. Клипа у неё нет: медиатека
+ * принадлежит пользователю, и картинка доступна из любого его клипа.
+ */
+export namespace GenerateAvatarStudioImageCommand {
     export const RequestSchema = z
         .object({
             prompt: z.string().trim().min(1),

package/commands/avatar-studio/generation-job/generate-avatar-studio-scene-voice.command.ts

@@ -6,10 +6,13 @@ export namespace GenerateAvatarStudioSceneVoiceCommand {
     export const ParamsSchema = AvatarStudioSceneIdParamsSchema;
     export type Params = z.infer<typeof ParamsSchema>;
 
+    /**
+     * Образец голоса не передаётся: он берётся из voiceConfig.voiceSampleMediaId сцены.
+     * Сменить образец — обычный PATCH сцены, а не отдельная операция.
+     */
     export const RequestSchema = z
         .object({
             text: z.string().trim().min(1).optional(),
-            mediaId: z.string().uuid().optional(),
         })
         .strict();
     export type Request = z.infer<typeof RequestSchema>;

package/commands/avatar-studio/generation-job/index.ts

@@ -1,9 +1,7 @@
 export * from './find-avatar-studio-generation-jobs.query';
 export * from './generate-avatar-studio-frame.command';
-export * from './generate-avatar-studio-library-image.command';
-export * from './generate-avatar-studio-media-image.command';
+export * from './generate-avatar-studio-image.command';
 export * from './generate-avatar-studio-scene-video.command';
 export * from './generate-avatar-studio-scene-voice.command';
 export * from './generate-avatar-studio-talking-avatar.command';
-export * from './generate-avatar-studio-voice-timings.command';
 export * from './get-avatar-studio-generation-job.query';

package/commands/avatar-studio/media/create-avatar-studio-media-from-file.command.ts

@@ -1,28 +1,19 @@
 import { z } from 'zod';
-import {
-    AVATAR_STUDIO_MEDIA_KIND,
-    AVATAR_STUDIO_MEDIA_ROLE,
-    AVATAR_STUDIO_MEDIA_SOURCE,
-} from '../../../constants';
+import { AVATAR_STUDIO_MEDIA_KIND } from '../../../constants';
 import { AvatarStudioMediaSchema } from '../../../models';
-import { AvatarStudioClipIdParamsSchema } from '../shared/avatar-studio-common.schema';
 
+/**
+ * Загруженный файл попадает в медиатеку пользователя и доступен из любого его клипа.
+ * Положить его в сцену — отдельная операция: PUT .../scenes/:sceneId/slots/:slot.
+ * Чем медиа будет — озвучкой, образцом голоса, референсом — решает поле, которое на него
+ * сошлётся, а не признак на самом медиа.
+ */
 export namespace CreateAvatarStudioMediaFromFileCommand {
-    export const ParamsSchema = AvatarStudioClipIdParamsSchema;
-    export type Params = z.infer<typeof ParamsSchema>;
-
     export const RequestSchema = z
         .object({
             fileId: z.string().uuid(),
-            sceneId: z.string().uuid().optional(),
             kind: z.nativeEnum(AVATAR_STUDIO_MEDIA_KIND),
-            source: z
-                .nativeEnum(AVATAR_STUDIO_MEDIA_SOURCE)
-                .default(AVATAR_STUDIO_MEDIA_SOURCE.UPLOAD)
-                .optional(),
-            role: z.nativeEnum(AVATAR_STUDIO_MEDIA_ROLE),
             title: z.string().trim().min(1).max(255).optional(),
-            prompt: z.string().optional(),
         })
         .strict();
     export type Request = z.infer<typeof RequestSchema>;

package/commands/avatar-studio/media/find-avatar-studio-media.query.ts

@@ -1,20 +1,22 @@
 import { z } from 'zod';
-import { AVATAR_STUDIO_MEDIA_KIND, AVATAR_STUDIO_MEDIA_ROLE } from '../../../constants';
+import { AVATAR_STUDIO_MEDIA_KIND } from '../../../constants';
 import { AvatarStudioMediaSchema } from '../../../models';
 import {
     AvatarStudioPagedResponseSchema,
     AvatarStudioPaginationQuerySchema,
 } from '../shared/avatar-studio-common.schema';
 
-export namespace FindAvatarStudioMediaQuery {
-    export const ParamsSchema = z.object({}).strict();
-    export type Params = z.infer<typeof ParamsSchema>;
+/**
+ * Список медиа всегда однороден по владельцу: либо медиатека пользователя,
+ * либо общие системные медиа. Смешанного списка нет, поэтому owner обязателен.
+ */
+export const AvatarStudioMediaOwnerSchema = z.enum(['me', 'system']);
+export type AvatarStudioMediaOwner = z.infer<typeof AvatarStudioMediaOwnerSchema>;
 
+export namespace FindAvatarStudioMediaQuery {
     export const QuerySchema = AvatarStudioPaginationQuerySchema.extend({
-        clipId: z.string().uuid().optional(),
-        sceneId: z.string().uuid().optional(),
+        owner: AvatarStudioMediaOwnerSchema,
         kind: z.nativeEnum(AVATAR_STUDIO_MEDIA_KIND).optional(),
-        role: z.nativeEnum(AVATAR_STUDIO_MEDIA_ROLE).optional(),
     });
     export type Query = z.infer<typeof QuerySchema>;
 

package/commands/avatar-studio/media/update-avatar-studio-media.command.ts

@@ -1,18 +1,15 @@
 import { z } from 'zod';
-import { AVATAR_STUDIO_MEDIA_ROLE } from '../../../constants';
 import { AvatarStudioMediaSchema } from '../../../models';
 import { AvatarStudioMediaIdParamsSchema } from '../shared/avatar-studio-common.schema';
 
+/** Только метаданные: прикрепление медиа в сцену — операция сцены, а не медиа. */
 export namespace UpdateAvatarStudioMediaCommand {
     export const ParamsSchema = AvatarStudioMediaIdParamsSchema;
     export type Params = z.infer<typeof ParamsSchema>;
 
     export const RequestSchema = z
         .object({
-            sceneId: z.string().uuid().nullable().optional(),
-            role: z.nativeEnum(AVATAR_STUDIO_MEDIA_ROLE).optional(),
             title: z.string().trim().min(1).max(255).nullable().optional(),
-            prompt: z.string().nullable().optional(),
         })
         .strict();
     export type Request = z.infer<typeof RequestSchema>;

package/commands/avatar-studio/scene/apply-avatar-studio-voice-sample-to-all-scenes.command.ts

@@ -0,0 +1,20 @@
+import { z } from 'zod';
+import { AvatarStudioClipSchema } from '../../../models';
+import {
+    AvatarStudioClipIdParamsSchema,
+    AvatarStudioMediaIdParamsSchema,
+} from '../shared/avatar-studio-common.schema';
+
+export namespace ApplyAvatarStudioVoiceSampleToAllScenesCommand {
+    export const ParamsSchema = AvatarStudioClipIdParamsSchema.merge(
+        AvatarStudioMediaIdParamsSchema,
+    );
+    export type Params = z.infer<typeof ParamsSchema>;
+
+    // Ответ — клип со сценами, а не список сцен: фронт перерисовывает клип целиком
+    // и не ходит следом за GET /clips/:clipId.
+    export const ResponseSchema = z.object({
+        data: AvatarStudioClipSchema,
+    });
+    export type Response = z.infer<typeof ResponseSchema>;
+}

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

@@ -1,4 +1,6 @@
+export * from './apply-avatar-studio-voice-sample-to-all-scenes.command';
 export * from './create-avatar-studio-scene.command';
 export * from './delete-avatar-studio-scene.command';
 export * from './reorder-avatar-studio-scenes.command';
+export * from './set-avatar-studio-scene-slot.command';
 export * from './update-avatar-studio-scene.command';