@purpleschool/gptbot-tools 0.1.9 → 0.1.11-stage-2

package/build/writer/queries/get-writer-config.query.js

@@ -5,5 +5,6 @@ const common_1 = require("../../common");
 const models_1 = require("../models");
 var GetWriterConfigQuery;
 (function (GetWriterConfigQuery) {
+    GetWriterConfigQuery.RequestSchema = common_1.LocaleRequestSchema;
     GetWriterConfigQuery.ResponseSchema = (0, common_1.ICommandResponseSchema)(models_1.WriterConfigSchema);
 })(GetWriterConfigQuery || (exports.GetWriterConfigQuery = GetWriterConfigQuery = {}));

package/common/models/index.ts

@@ -1,3 +1,4 @@
 export * from './command-response.schema';
 export * from './icon-variants.schema';
 export * from './attached-file.schema';
+export * from './locale.schema';

package/common/models/locale.schema.ts

@@ -0,0 +1,11 @@
+import { LOCALE } from '@purpleschool/rugpt-lib-common';
+import { z } from 'zod';
+
+export const LocaleSchema = z.nativeEnum(LOCALE);
+
+export const LocaleRequestSchema = z.object({
+    locale: LocaleSchema,
+});
+
+export type Locale = z.infer<typeof LocaleSchema>;
+export type LocaleRequest = z.infer<typeof LocaleRequestSchema>;

package/image-editor/commands/image-editor-model/get-image-editor-model-by-uuid.command.ts

@@ -1,10 +1,11 @@
 import { z } from 'zod';
 import { ImageEditorModelSchema } from '../../models';
-import { ICommandResponseSchema } from '../../../common';
+import { ICommandResponseSchema, LocaleSchema } from '../../../common';
 
 export namespace GetImageEditorModelByUuidCommand {
     export const RequestSchema = z.object({
         uuid: z.string().uuid(),
+        locale: LocaleSchema,
     });
     export type Request = z.infer<typeof RequestSchema>;
 

package/image-editor/models/image-editor-model.schema.ts

@@ -39,6 +39,8 @@ export const ImageEditorModelSchema = z.object({
     title: z.string(),
     description: z.string(),
     aiModel: z.string(),
+    isNew: z.boolean(),
+    tierLabel: z.string(),
     pricePerImage: z.number(),
     order: z.number(),
     status: z.nativeEnum(TOOL_MODEL_STATUS),

package/image-editor/queries/get-image-editor-config.query.ts

@@ -1,8 +1,11 @@
 import { z } from 'zod';
-import { ICommandResponseSchema } from '../../common/models/command-response.schema';
+import { ICommandResponseSchema, LocaleRequestSchema } from '../../common';
 import { ImageEditorConfigSchema } from '../models';
 
 export namespace GetImageEditorConfigQuery {
+    export const RequestSchema = LocaleRequestSchema;
+    export type Request = z.infer<typeof RequestSchema>;
+
     export const ResponseSchema = ICommandResponseSchema(ImageEditorConfigSchema);
     export type Response = z.infer<typeof ResponseSchema>;
 }

package/image-generation/commands/image-generation-model/get-image-generation-model-by-uuid.command.ts

@@ -1,10 +1,11 @@
 import { z } from 'zod';
 import { ImageGenerationModelSchema } from '../../models';
-import { ICommandResponseSchema } from '../../../common';
+import { ICommandResponseSchema, LocaleSchema } from '../../../common';
 
 export namespace GetImageGenerationModelByUuidCommand {
     export const RequestSchema = z.object({
         uuid: z.string().uuid(),
+        locale: LocaleSchema,
     });
     export type Request = z.infer<typeof RequestSchema>;
 

package/image-generation/models/image-generation-model.schema.ts

@@ -46,6 +46,7 @@ export const ImageGenerationModelSchema = z.object({
     title: z.string(),
     description: z.string(),
     aiModel: z.string(),
+    isNew: z.boolean(),
     price: z.number(),
     order: z.number(),
     params: ImageGenerationModelParamsSchema,

package/image-generation/queries/get-image-generation-config.query.ts

@@ -1,9 +1,9 @@
 import { z } from 'zod';
-import { ICommandResponseSchema } from '../../common/models/command-response.schema';
+import { ICommandResponseSchema, LocaleRequestSchema } from '../../common';
 import { ImageGenerationConfigSchema } from '../models';
 
 export namespace GetImageGenerationConfigQuery {
-    export const RequestSchema = z.object({});
+    export const RequestSchema = LocaleRequestSchema;
     export type Request = z.infer<typeof RequestSchema>;
 
     export const ResponseSchema = ICommandResponseSchema(ImageGenerationConfigSchema);

package/interior-design/commands/interior-design-model/get-interior-design-model-by-uuid.command.ts

@@ -1,10 +1,11 @@
 import { z } from 'zod';
-import { ICommandResponseSchema } from '../../../common';
+import { ICommandResponseSchema, LocaleSchema } from '../../../common';
 import { InteriorDesignModelSchema } from '../../models';
 
 export namespace GetInteriorDesignModelByUuidCommand {
     export const RequestSchema = z.object({
         uuid: z.string().uuid(),
+        locale: LocaleSchema,
     });
     export type Request = z.infer<typeof RequestSchema>;
 

package/interior-design/queries/get-interior-design-config.query.ts

@@ -1,8 +1,11 @@
 import { z } from 'zod';
-import { ICommandResponseSchema } from '../../common/models/command-response.schema';
+import { ICommandResponseSchema, LocaleRequestSchema } from '../../common';
 import { InteriorDesignConfigSchema } from '../models/interior-design-config.schema';
 
 export namespace GetInteriorDesignConfigQuery {
+    export const RequestSchema = LocaleRequestSchema;
+    export type Request = z.infer<typeof RequestSchema>;
+
     export const ResponseSchema = ICommandResponseSchema(InteriorDesignConfigSchema);
     export type Response = z.infer<typeof ResponseSchema>;
 }

package/marketplace-card/queries/get-marketplace-card-config.query.ts

@@ -1,9 +1,9 @@
 import { z } from 'zod';
-import { ICommandResponseSchema } from '../../common';
+import { ICommandResponseSchema, LocaleRequestSchema } from '../../common';
 import { MarketplaceCardConfigSchema } from '../models';
 
 export namespace GetMarketplaceCardConfigQuery {
-    export const RequestSchema = z.object({});
+    export const RequestSchema = LocaleRequestSchema;
     export type Request = z.infer<typeof RequestSchema>;
     export const ResponseSchema = ICommandResponseSchema(MarketplaceCardConfigSchema);
     export type Response = z.infer<typeof ResponseSchema>;

package/music/commands/music-model/get-music-model-by-uuid.command.ts

@@ -1,10 +1,11 @@
 import { z } from 'zod';
 import { MusicModelSchema } from '../../models';
-import { ICommandResponseSchema } from '../../../common';
+import { ICommandResponseSchema, LocaleSchema } from '../../../common';
 
 export namespace GetMusicModelByUuidCommand {
     export const RequestSchema = z.object({
         uuid: z.string().uuid(),
+        locale: LocaleSchema,
     });
     export type Request = z.infer<typeof RequestSchema>;
 

package/music/queries/get-music-config.query.ts

@@ -1,8 +1,11 @@
 import { z } from 'zod';
-import { ICommandResponseSchema } from '../../common/models/command-response.schema';
+import { ICommandResponseSchema, LocaleRequestSchema } from '../../common';
 import { MusicConfigSchema } from '../models';
 
 export namespace GetMusicConfigQuery {
+    export const RequestSchema = LocaleRequestSchema;
+    export type Request = z.infer<typeof RequestSchema>;
+
     export const ResponseSchema = ICommandResponseSchema(MusicConfigSchema);
     export type Response = z.infer<typeof ResponseSchema>;
 }

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@purpleschool/gptbot-tools",
-  "version": "0.1.9",
+  "version": "0.1.11-stage-2",
   "main": "build/index.js",
   "types": "build/index.d.ts",
   "scripts": {
@@ -12,6 +12,7 @@
   "license": "ISC",
   "description": "",
   "dependencies": {
+    "@purpleschool/rugpt-lib-common": "^0.0.18",
     "zod": "^3.25.67"
   }
 }

package/paraphrase/queries/get-paraphrase-tool-config.query.ts

@@ -1,8 +1,11 @@
 import { z } from 'zod';
-import { ICommandResponseSchema } from '../../common/models/command-response.schema';
+import { ICommandResponseSchema, LocaleRequestSchema } from '../../common';
 import { ParaphraseToolConfigSchema } from '../models';
 
 export namespace GetParaphraseToolConfigQuery {
+    export const RequestSchema = LocaleRequestSchema;
+    export type Request = z.infer<typeof RequestSchema>;
+
     export const ResponseSchema = ICommandResponseSchema(ParaphraseToolConfigSchema);
     export type Response = z.infer<typeof ResponseSchema>;
 }

package/presentation/models/slide-content.schema.ts

@@ -10,7 +10,19 @@ export const ImageSlotSchema = z.object({
         .string()
         .uuid()
         .describe('Generate a valid uuid for image slot, that will be used for future lookups'),
-    prompt: z.string().describe('Image prompt for slide'),
+    prompt: z
+        .string()
+        .describe(
+            'Image generation prompt. MUST be written in ENGLISH regardless of the presentation language. ' +
+                'AI image generators excel at: atmospheric scenes, landscapes, cityscapes, architecture, nature, abstract light and texture, anonymous silhouettes, artistic photography. ' +
+                'AI fundamentally cannot render accurately: legible text on any surface, complex diagrams or flowcharts, data charts/graphs, specific product logos, clocks, precise mechanical parts. ' +
+                'Choose scene types from the first category. Avoid anything in the second. ' +
+                'Structure: [subject/scene] → [mood/atmosphere] → [lighting] → [visual style]. ' +
+                'Evoke the emotional register of the slide — do not illustrate the topic literally. ' +
+                'MODERATION: if the slide topic involves conflict, suffering, politics, or crime, redirect to abstract/atmospheric imagery (fog, ruins, empty landscapes) rather than depicting the subject directly — flagged prompts produce empty placeholders. ' +
+                'GOOD: "A lone figure on an observation deck at dusk gazing over an illuminated city. Cinematic wide-angle, golden-hour light, photorealistic." ' +
+                'BAD: "A bar chart showing quarterly growth. A robot at a laptop with code on the screen."',
+        ),
 });
 export type ImageSlot = z.infer<typeof ImageSlotSchema>;
 
@@ -176,19 +188,37 @@ export type ThankYouSlideData = z.infer<typeof ThankYouSlideDataSchema>;
 
 export const StructuredListSlideDataSchema = z.object({
     contentType: z.literal(SLIDE_CONTENT_TYPE.STRUCTURED_LIST),
-    title: z.string().describe('Slide title, 2–6 words').max(150),
-    description: z.string().describe('One short framing sentence'),
+    title: z
+        .string()
+        .describe(
+            'Slide headline — 2–4 words naming the group. A noun phrase, NOT a full sentence. Displayed in very large font on the left panel.',
+        )
+        .min(5)
+        .max(40),
+    description: z
+        .string()
+        .describe(
+            'One framing sentence answering "What are these 4 things about?". Displayed in small text below the title on the left panel.',
+        )
+        .min(30)
+        .max(80),
     list: z
         .array(
             z.object({
-                title: z.string().describe('2–4 words, concrete'),
+                title: z
+                    .string()
+                    .describe(
+                        '2–4 concrete words. A noun phrase or short verb phrase. All 4 titles MUST be grammatically parallel. Displayed in bold next to a large number (01–04).',
+                    )
+                    .min(3)
+                    .max(30),
                 description: z
                     .string()
                     .describe(
-                        "One clear short framing sentence. DON'T CUT THE TEXT SHORT MID WORD/SENTENCE!. Generate less content if that happened",
+                        'ONE complete sentence that expands on the title with a specific fact or benefit. NEVER just restate the title. NEVER cut short mid-word or mid-sentence. All 4 descriptions must be roughly equal in length.',
                     )
                     .min(50)
-                    .max(120),
+                    .max(100),
             }),
         )
         .length(4),
@@ -198,14 +228,25 @@ export type StructuredListSlideData = z.infer<typeof StructuredListSlideDataSche
 
 export const TextSlideDataSchema = z.object({
     contentType: z.literal(SLIDE_CONTENT_TYPE.TEXT),
-    title: z.string().describe('Slide title in about 6 words').min(10).max(150),
+    title: z
+        .string()
+        .describe(
+            'Slide headline rendered in very large bold font. Keep to 3–7 words (max 70 characters). It should name the topic or thesis — not summarise all content.',
+        )
+        .min(10)
+        .max(70),
     description: z
         .string()
         .describe(
-            "Fairly long textual description of the point presented in the title. A couple of paragraphs. Consider maximum amount of text to be 600 characters. Don't cut the text short.",
+            'Expository prose split into 2–3 paragraphs separated by \\n\\n (double newline). Total length 300–800 characters. ' +
+                'Use **bold** to highlight 1–3 key terms per paragraph (NOT entire sentences). ' +
+                'Use *italics* for definitions, counter-points, or light emphasis (1 per paragraph max). ' +
+                'NO bullet points, NO markdown headers, NO numbered lists. ' +
+                'Each paragraph covers ONE focused idea: e.g. context → main argument → implication. ' +
+                'Do NOT start consecutive paragraphs with the same word. Do NOT cut text short mid-sentence.',
         )
         .min(300)
-        .max(600),
+        .max(800),
     version: z.literal(1),
 }) satisfies z.ZodType<ITextSlideDataStructure>;
 export type TextSlideData = z.infer<typeof TextSlideDataSchema>;
@@ -237,24 +278,53 @@ export type ContentsSlideData = z.infer<typeof ContentsSlideDataSchema>;
 export const ImageSlideDataSchema = z
     .object({
         contentType: z.literal(SLIDE_CONTENT_TYPE.TEXT_WITH_IMAGE),
-        title: z.string().describe('Slide title in about 6 words').min(10).max(200),
-        description: z
+        title: z
             .string()
-            .describe("Text that elaborates on the title and doesn't just describe the image")
+            .describe(
+                'Slide headline rendered in very large bold font on the LEFT column. Keep to 3–7 words (max 70 characters). Aim for under 50 characters to avoid overflow. A noun phrase or short declarative phrase — NOT a full sentence.',
+            )
             .min(10)
+            .max(70),
+        description: z
+            .string()
+            .describe(
+                'Expository prose in 2 paragraphs separated by \\n\\n (double newline). Total length 150–500 characters. ' +
+                    'Use **bold** for 1–2 key terms per paragraph (NOT entire sentences). ' +
+                    'Use *italics* for definitions or emphasis at most once per paragraph. ' +
+                    'NO bullet points, NO headers, NO numbered lists. ' +
+                    'Each paragraph covers ONE focused idea. NEVER reference or describe the image in the text. ' +
+                    'The image provides visual atmosphere — the text must stand alone as complete, readable prose.',
+            )
+            .min(150)
             .max(500),
         imageSlot: ImageSlotSchema,
         version: z.literal(1),
     })
     .describe(
-        'Slide that contains a title, description of the title',
+        'Slide with a large title and prose description on the left, and a full-bleed supporting image on the right.',
     ) satisfies z.ZodType<IImageSlideDataStructure>;
 export type ImageSlideData = z.infer<typeof ImageSlideDataSchema>;
 
 export const SectionBreakSlideDataSchema = z.object({
     contentType: z.literal(SLIDE_CONTENT_TYPE.SECTION_BREAK),
-    title: z.string().describe('Slide title in about 6 words').min(10).max(200),
-    description: z.string().describe('Description of the slide in about 6 words').min(10).max(200),
+    title: z
+        .string()
+        .describe(
+            'The section name — a clean noun phrase of 3–6 words that names the thematic block which follows. ' +
+                'NEVER prefix with "Раздел:", "Section:", "Part:", "Глава:", or any structural label. ' +
+                'NEVER include numbers. Just the name itself. ' +
+                'GOOD: "Технологические достижения". BAD: "Раздел 2: Технологические достижения".',
+        )
+        .min(5)
+        .max(60),
+    description: z
+        .string()
+        .describe(
+            'One sentence (up to 100 characters) that briefly hints at the content of the upcoming section. ' +
+                'Should complement the title without repeating it. No markdown, no labels.',
+        )
+        .min(10)
+        .max(120),
     version: z.literal(1),
 }) satisfies z.ZodType<ISectionBreakSlideDataStructure>;
 export type SectionBreakSlideData = z.infer<typeof SectionBreakSlideDataSchema>;
@@ -263,25 +333,73 @@ export const TableSlideDataSchema = z.object({
     contentType: z.literal(SLIDE_CONTENT_TYPE.TABLE),
     title: z
         .string()
-        .describe('Slide title and table title at the same time in a couple of words')
+        .describe(
+            'Table name — 2–4 words rendered as large bold heading above the table. ' +
+                'Doubles as both the slide title and the table heading. Keep concise.',
+        )
+        .min(5)
+        .max(55),
+    description: z
+        .string()
+        .describe(
+            'One short sentence (max 80 characters) describing what the table shows. ' +
+                'Rendered in small gray text below the title. No markdown.',
+        )
         .min(10)
-        .max(200),
-    description: z.string().describe('Description of the table represents').min(10).max(200),
+        .max(100),
     table: z.object({
         columnHeaders: z
-            .array(z.string().min(1).max(50))
-            .min(1)
-            .max(10)
-            .describe('Array of column header labels'),
+            .array(
+                z
+                    .string()
+                    .min(1)
+                    .max(20)
+                    .describe(
+                        'Column label. Keep SHORT — 1–3 words. Include units here (e.g., "Сумма, ₽"), not in cells. ' +
+                            'When hasRowHeaders is true, the first header should be a single space " " or a short category label.',
+                    ),
+            )
+            .min(2)
+            .max(5)
+            .describe(
+                'Column header labels. MAXIMUM 5 columns total. Recommended 3–4 data columns. ' +
+                    'More columns will overflow the slide — NEVER exceed 5.',
+            ),
         rows: z
-            .array(z.array(z.string().min(1).max(75)))
-            .min(3)
+            .array(
+                z
+                    .array(
+                        z
+                            .string()
+                            .min(1)
+                            .max(40)
+                            .describe(
+                                'Cell content. NUMERIC tables: numbers only (e.g., "1 200", "85%"). ' +
+                                    'TEXTUAL tables: 1–3 words maximum — keywords or short phrases ONLY, NEVER full sentences. ' +
+                                    'Row header cells (first cell when hasRowHeaders=true): category label, max 22 characters.',
+                            ),
+                    )
+                    .describe('One row. Cell count MUST equal columnHeaders length exactly.'),
+            )
+            .min(2)
             .max(4)
             .describe(
-                'Table rows; each row must have exactly the same number of cells as columnHeaders',
+                'Table rows. Max 4 rows total. ' +
+                    'When hasSummaryRow is true, the LAST row is the summary row — so at most 3 regular rows + 1 summary = 4 total. ' +
+                    'NEVER exceed 4 rows.',
+            ),
+        hasRowHeaders: z
+            .boolean()
+            .describe(
+                'True when the first cell of each row is a descriptive label or category (pivot table). ' +
+                    'False for plain data tables where all cells are equivalent data.',
+            ),
+        hasSummaryRow: z
+            .boolean()
+            .describe(
+                'True when the last row contains totals, averages, or aggregated values. ' +
+                    'That summary row must be the last element of the rows array.',
             ),
-        hasRowHeaders: z.boolean().describe('If table needs special row headers, set this to true'),
-        hasSummaryRow: z.boolean().describe('If table needs a summary row, set this to true'),
     }),
     version: z.literal(1),
 }) satisfies z.ZodType<ITableSlideDataStructure>;
@@ -291,37 +409,85 @@ export type TableSlideData = z.infer<typeof TableSlideDataSchema>;
 export const BarChartSlideDataSchema = z.object({
     type: z.literal(SLIDE_CHART_TYPE.BAR),
     categories: z
-        .array(z.string())
-        .min(1)
-        .max(12)
-        .describe('Category labels (e.g., months, products, regions)'),
+        .array(z.string().min(1).max(20))
+        .min(3)
+        .max(10)
+        .describe(
+            'Category labels (e.g., months, product names, departments). ' +
+                'Recommended: 4–8 items. Keep each label SHORT — 1–3 words, max 15 characters. ' +
+                'Categories work best when naturally ordered: time periods, rankings, or comparable groups.',
+        ),
     series: z
         .array(
             z.object({
                 name: z
                     .string()
-                    .describe('Series name for legend. Try to include measurements if needed'),
-                data: z.array(z.number()).describe('Values corresponding to categories'),
+                    .max(40)
+                    .describe(
+                        'Series name shown in the chart legend. Do NOT include units here — units belong in the unit field. ' +
+                            'GOOD: "Рост продаж". BAD: "Рост продаж (%)" or "Выручка (₽)".',
+                    ),
+                data: z
+                    .array(z.number())
+                    .min(3)
+                    .describe(
+                        'Numeric values corresponding to categories. ' +
+                            'MUST have EXACTLY the same number of values as categories — mismatch will break the chart. ' +
+                            'Use round numbers or simple approximations. NEVER hallucinate precise figures. ' +
+                            'Values should show meaningful variation — avoid all bars being the same height.',
+                    ),
                 type: z
                     .number()
                     .min(0)
                     .max(11)
-                    .describe('Series type. Used to discriminate colors when applying theme'),
+                    .describe(
+                        'Color index from the theme palette. ALWAYS use 0 (primary blue). Never change this value.',
+                    ),
             }),
         )
         .min(1)
         .max(1)
-        .describe('Data series for the chart. Only one series is supported'),
-    yAxisLabel: z.string().max(40).optional().describe('Y-axis label'),
-    unit: z.string().max(10).optional().describe('Unit symbol (%, $, etc.)'),
+        .describe('Data series. Only ONE series is supported. Never add more than one.'),
+    yAxisLabel: z
+        .string()
+        .max(30)
+        .optional()
+        .describe(
+            'Y-axis label. Include ONLY when the axis needs a descriptor that is not already covered by the unit field. ' +
+                'GOOD use: "Количество студентов" (when there is no unit symbol). ' +
+                'OMIT when unit is set (e.g., "%", "₽") — the unit already contextualises the values.',
+        ),
+    unit: z
+        .string()
+        .max(10)
+        .optional()
+        .describe(
+            'Unit symbol displayed with each bar value (e.g., "%", "₽", "шт.", "млн"). ' +
+                'ALWAYS include when values represent percentages, currency, or any measurable quantity with a unit. ' +
+                'Omit only for dimensionless counts that are self-explanatory (e.g., raw ranking scores without a fixed scale).',
+        ),
     version: z.literal(1),
 }) satisfies z.ZodType<IBarChartSlideDataStructure>;
 export type BarChartSlideData = z.infer<typeof BarChartSlideDataSchema>;
 
 export const ChartSlideDataSchema = z.object({
     contentType: z.literal(SLIDE_CONTENT_TYPE.CHART),
-    title: z.string().describe('Slide title in about 2-6 words').max(100),
-    description: z.string().describe("Information on slide's topic").max(600),
+    title: z
+        .string()
+        .describe(
+            'Chart name — 2–4 words rendered as large bold heading on the LEFT panel of the slide. ' +
+                'Keep short: the left panel is narrow and the title font is very large.',
+        )
+        .min(5)
+        .max(50),
+    description: z
+        .string()
+        .describe(
+            '1–2 sentences (max 120 characters) explaining what the chart shows. ' +
+                'Rendered in small gray text below the title on the LEFT panel. No markdown.',
+        )
+        .min(10)
+        .max(150),
     chart: z.discriminatedUnion('type', [BarChartSlideDataSchema]),
     version: z.literal(1),
 }) satisfies z.ZodType<IChartSlideDataStructure>;
@@ -329,8 +495,22 @@ export type ChartSlideData = z.infer<typeof ChartSlideDataSchema>;
 
 export const TimelineSlideDataSchema = z.object({
     contentType: z.literal(SLIDE_CONTENT_TYPE.TIMELINE),
-    title: z.string().describe('Slide title in about 6 words').min(10).max(150),
-    description: z.string().describe('Brief context for the timeline').min(10).max(200),
+    title: z
+        .string()
+        .describe(
+            'Timeline name — 2–5 words, rendered as large bold heading above the timeline. ' +
+                'Names the subject or scope of the chronological sequence.',
+        )
+        .min(5)
+        .max(65),
+    description: z
+        .string()
+        .describe(
+            'One sentence (max 100 characters) providing context for the timeline. ' +
+                'Rendered in small gray text below the title. No markdown.',
+        )
+        .min(10)
+        .max(120),
     timeline: z.object({
         events: z
             .array(
@@ -338,26 +518,40 @@ export const TimelineSlideDataSchema = z.object({
                     date: z
                         .string()
                         .describe(
-                            'Date or time period label. MUST be general/approximate if exact date unknown (e.g., "Early 2020s", "Mid-1990s", "Recent years")',
+                            'Temporal label displayed inside the arrow/chevron shape at the top of each column. ' +
+                                'MUST be SHORT — max 20 characters — to fit inside the arrow. ' +
+                                'Use a year ("2015"), a range ("2010–2015"), a quarter ("Q1 2023"), ' +
+                                'an approximate period ("Early 2020s", "Середина 2010-х"), ' +
+                                'or a phase label ("Этап 1", "Запуск") for process timelines. ' +
+                                'NEVER fabricate specific dates you are not certain about.',
                         )
                         .min(2)
-                        .max(50),
+                        .max(25),
                     title: z
                         .string()
                         .describe(
-                            'Event title. Prefer 2 words, max 3 words. Keep it short and punchy.',
+                            'Event name in bold below the arrow. 2–3 words maximum. ' +
+                                'Short and punchy — the column is narrow, long titles wrap to many lines. ' +
+                                'GOOD: "Первый запуск", "Выход на рынок". BAD: "Успешный выход компании на международный рынок".',
                         )
-                        .min(5)
-                        .max(60),
+                        .min(3)
+                        .max(35),
                     description: z
                         .string()
-                        .describe('Brief description of the event or milestone')
+                        .describe(
+                            'Brief description below the event title. 1–2 sentences, max 100 characters. ' +
+                                'The column is narrow — text wraps to ~5 lines at this limit. ' +
+                                'Do NOT exceed 100 characters or the description will overflow off the slide.',
+                        )
                         .min(20)
-                        .max(150),
+                        .max(110),
                 }),
             )
-            .length(4)
-            .describe('Timeline must contain exactly 4 chronological events'),
+            .length(5)
+            .describe(
+                'Exactly 5 chronological events in sequential order (oldest → newest). ' +
+                    'The template renders exactly 5 equal columns — NEVER generate fewer or more.',
+            ),
     }),
     version: z.literal(1),
 }) satisfies z.ZodType<ITimelineSlideDataStructure>;

package/presentation/queries/get-presentation-config.query.ts

@@ -1,8 +1,11 @@
 import { z } from 'zod';
-import { ICommandResponseSchema } from '../../common';
+import { ICommandResponseSchema, LocaleRequestSchema } from '../../common';
 import { PresentationConfigSchema } from '../models';
 
 export namespace GetPresentationConfigQuery {
+    export const RequestSchema = LocaleRequestSchema;
+    export type Request = z.infer<typeof RequestSchema>;
+
     export const ResponseSchema = ICommandResponseSchema(PresentationConfigSchema);
     export type Response = z.infer<typeof ResponseSchema>;
 }

package/solving-edu-task/queries/get-solving-edu-task-config.query.ts

@@ -1,9 +1,9 @@
 import { z } from 'zod';
-import { ICommandResponseSchema } from '../../common';
+import { ICommandResponseSchema, LocaleRequestSchema } from '../../common';
 import { SolvingEduTaskConfigSchema } from '../models';
 
 export namespace GetSolvingEduTaskConfigQuery {
-    export const RequestSchema = z.object({});
+    export const RequestSchema = LocaleRequestSchema;
     export type Request = z.infer<typeof RequestSchema>;
 
     export const ResponseSchema = ICommandResponseSchema(SolvingEduTaskConfigSchema);