@purpleschool/gptbot 0.14.27 → 0.14.29

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';

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/commands/photo-studio/execute-photo-studio-action.command.ts

@@ -6,6 +6,7 @@ import {
     PHOTO_STUDIO_PLACEMENT_ALIAS,
     PHOTO_STUDIO_UPSCALE_SIZE,
     PHOTO_STUDIO_VARIATION_STRENGTH_ALIAS,
+    IMAGE_GENERATION_RESOLUTION,
 } from '../../constants';
 import { CanvasNodePositionSchema, ToolJobSchema } from '../../models';
 
@@ -14,6 +15,7 @@ export namespace ExecutePhotoStudioActionCommand {
         .object({
             enhancePrompt: z.boolean().optional(),
             aspectRatio: z.string().optional(),
+            resolution: z.nativeEnum(IMAGE_GENERATION_RESOLUTION).optional(),
         })
         .strict();
     const OneImageParamsSchema = z
@@ -41,6 +43,7 @@ export namespace ExecutePhotoStudioActionCommand {
             variationsCount: z.union([z.literal(2), z.literal(3), z.literal(4)]),
             variationStrength: z.nativeEnum(PHOTO_STUDIO_VARIATION_STRENGTH_ALIAS).optional(),
             enhancePrompt: z.boolean().optional(),
+            aspectRatio: z.string().optional(),
             positions: z.array(CanvasNodePositionSchema).min(2).max(4).optional(),
         })
         .strict();
@@ -69,18 +72,20 @@ export namespace ExecutePhotoStudioActionCommand {
         .object({
             imageUrls: z.array(z.string().uuid()).min(2).max(5),
             enhancePrompt: z.boolean().optional(),
+            aspectRatio: z.string().optional(),
         })
         .strict();
     const StyleParamsSchema = z
         .object({
             imageUrls: z.array(z.string().uuid()).length(2),
+            aspectRatio: z.string().optional(),
         })
         .strict();
 
     const BaseRequestSchema = z.object({
         actionAlias: z.nativeEnum(PHOTO_STUDIO_ACTION_ALIAS),
         position: CanvasNodePositionSchema,
-        baseCheckpointSequence: z.number().int().optional(),
+        baseCheckpointSequence: z.number().int().min(0).optional(),
     });
 
     const GenerationActionRequestSchema = BaseRequestSchema.extend({
@@ -184,7 +189,8 @@ export namespace ExecutePhotoStudioActionCommand {
 
     export const PhotoStudioExecuteJobSchema = ToolJobSchema.extend({
         actionType: z.nativeEnum(PHOTO_STUDIO_ACTION_ALIAS),
-        checkpointSequence: z.number().int().positive(),
+        baseCheckpointSequence: z.number().int().min(0).nullable(),
+        targetCheckpointSequence: z.number().int().positive().nullable(),
         position: CanvasNodePositionSchema,
         params: PhotoStudioJobParamsSchema,
     });

package/commands/photo-studio/find-photo-studio-job-by-id.query.ts

@@ -28,7 +28,8 @@ export namespace FindPhotoStudioJobByIdQuery {
         jobId: z.string().uuid(),
         actionType: z.nativeEnum(PHOTO_STUDIO_ACTION_ALIAS),
         status: z.nativeEnum(TOOL_JOB_STATUS),
-        checkpointSequence: z.number().int().positive(),
+        baseCheckpointSequence: z.number().int().min(0).nullable(),
+        targetCheckpointSequence: z.number().int().positive().nullable(),
         position: CanvasNodePositionSchema,
         params: PhotoStudioJobParamsSchema,
         images: z.array(PhotoStudioJobImageSchema),

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';