@purpleschool/gptbot-tools 0.1.10 → 0.1.11

package/build/presentation/commands/create-presentation.command.js

@@ -4,6 +4,7 @@ exports.CreatePresentationCommand = void 0;
 const zod_1 = require("zod");
 const common_1 = require("../../common");
 const models_1 = require("../models");
+const enums_1 = require("../enums");
 var CreatePresentationCommand;
 (function (CreatePresentationCommand) {
     CreatePresentationCommand.RequestSchema = zod_1.z.object({
@@ -13,6 +14,8 @@ var CreatePresentationCommand;
         languageId: zod_1.z.string(),
         prompt: zod_1.z.string(),
         slideCount: zod_1.z.number(),
+        titlePage: models_1.PresentationTitlePageSchema.optional().nullable(),
+        targetAudience: zod_1.z.nativeEnum(enums_1.PRESENTATION_TARGET_AUDIENCE).optional(),
     });
     CreatePresentationCommand.ResponseSchema = (0, common_1.ICommandResponseSchema)(models_1.PresentationSchema);
 })(CreatePresentationCommand || (exports.CreatePresentationCommand = CreatePresentationCommand = {}));

package/build/presentation/commands/get-presentation-slides-generation-price.command.js

@@ -7,6 +7,7 @@ var GetPresentationSlidesGenerationPriceCommand;
 (function (GetPresentationSlidesGenerationPriceCommand) {
     GetPresentationSlidesGenerationPriceCommand.RequestSchema = zod_1.z.object({
         slideCount: zod_1.z.number().int().min(1),
+        templateId: zod_1.z.string().uuid(),
     });
     GetPresentationSlidesGenerationPriceCommand.ResponseDataSchema = zod_1.z.object({
         price: zod_1.z.number(),

package/build/presentation/enums/index.js

@@ -24,3 +24,4 @@ __exportStar(require("./slide-image-slot-action.enum"), exports);
 __exportStar(require("./presentation-ai-action-call-status.enum"), exports);
 __exportStar(require("./presentation-ai-action-type.enum"), exports);
 __exportStar(require("./presentation-ai-action-pricing-type.enum"), exports);
+__exportStar(require("./presentation-target-audience.enum"), exports);

package/build/presentation/enums/presentation-target-audience.enum.js

@@ -0,0 +1,10 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.PRESENTATION_TARGET_AUDIENCE = void 0;
+var PRESENTATION_TARGET_AUDIENCE;
+(function (PRESENTATION_TARGET_AUDIENCE) {
+    PRESENTATION_TARGET_AUDIENCE["NONE"] = "NONE";
+    PRESENTATION_TARGET_AUDIENCE["SCHOOL"] = "SCHOOL";
+    PRESENTATION_TARGET_AUDIENCE["UNIVERSITY"] = "UNIVERSITY";
+    PRESENTATION_TARGET_AUDIENCE["BUSINESS"] = "BUSINESS";
+})(PRESENTATION_TARGET_AUDIENCE || (exports.PRESENTATION_TARGET_AUDIENCE = PRESENTATION_TARGET_AUDIENCE = {}));

package/build/presentation/models/index.js

@@ -24,3 +24,4 @@ __exportStar(require("./slide.schema"), exports);
 __exportStar(require("./slide-image-slot.schema"), exports);
 __exportStar(require("./slide-content.schema"), exports);
 __exportStar(require("./presentation-ai-action.schema"), exports);
+__exportStar(require("./presentation-title-page.schema"), exports);

package/build/presentation/models/presentation-template.schema.js

@@ -7,6 +7,7 @@ exports.PresentationTemplateSchema = zod_1.z.object({
     title: zod_1.z.string(),
     image: zod_1.z.string(),
     order: zod_1.z.number(),
+    price: zod_1.z.number(),
     imagePlaceholder: zod_1.z.string(),
     createdAt: zod_1.z.date(),
     updatedAt: zod_1.z.date(),

package/build/presentation/models/presentation-title-page.schema.js

@@ -0,0 +1,9 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.PresentationTitlePageSchema = void 0;
+const zod_1 = require("zod");
+exports.PresentationTitlePageSchema = zod_1.z.object({
+    author: zod_1.z.string().optional().nullable(),
+    createdAt: zod_1.z.date().optional().nullable(),
+    email: zod_1.z.string().email().optional().nullable(),
+});

package/build/presentation/models/presentation.schema.js

@@ -6,6 +6,7 @@ const enums_1 = require("../enums");
 const slide_outline_schema_1 = require("./slide-outline.schema");
 const slide_schema_1 = require("./slide.schema");
 const common_1 = require("../../common");
+const presentation_title_page_schema_1 = require("./presentation-title-page.schema");
 exports.PresentationSchema = zod_1.z.object({
     uuid: zod_1.z.string().uuid(),
     prompt: zod_1.z.string(),
@@ -24,6 +25,8 @@ exports.PresentationSchema = zod_1.z.object({
     tokenReservationId: zod_1.z.string().nullable().optional(),
     lastContentUpdateAt: zod_1.z.date().nullable(),
     lastPptxExportedAt: zod_1.z.date().nullable(),
+    titlePage: presentation_title_page_schema_1.PresentationTitlePageSchema.nullable(),
+    targetAudience: zod_1.z.nativeEnum(enums_1.PRESENTATION_TARGET_AUDIENCE),
     createdAt: zod_1.z.date(),
     updatedAt: zod_1.z.date(),
 });
@@ -34,4 +37,5 @@ exports.PresentationWithSlidesSchema = exports.PresentationSchema.extend({
 exports.PresentationUpdateSchema = exports.PresentationSchema.pick({
     title: true,
     templateId: true,
+    titlePage: true,
 }).partial();

package/build/presentation/models/slide-content-edit.schema.js

@@ -10,18 +10,24 @@ const slide_content_schema_1 = require("./slide-content.schema");
 exports.CoverSlideDataUserEditSchema = zod_1.default.object({
     contentType: zod_1.default.literal(enums_1.SLIDE_CONTENT_TYPE.COVER),
     title: zod_1.default.string().min(1).max(500),
-    author: zod_1.default.object({
+    author: zod_1.default
+        .object({
         label: zod_1.default.string().min(1).max(100),
         value: zod_1.default.string().min(1).max(200),
-    }),
-    date: zod_1.default.object({
+    })
+        .optional(),
+    date: zod_1.default
+        .object({
         label: zod_1.default.string().min(1).max(100),
         value: zod_1.default.string().min(1).max(200),
-    }),
-    email: zod_1.default.object({
+    })
+        .optional(),
+    email: zod_1.default
+        .object({
         label: zod_1.default.string().min(1).max(100),
         value: zod_1.default.string().min(1).max(200),
-    }),
+    })
+        .optional(),
     version: zod_1.default.literal(1),
 });
 exports.ThankYouSlideDataUserEditSchema = zod_1.default.object({

package/build/presentation/models/slide-content.schema.js

@@ -12,7 +12,17 @@ exports.ImageSlotSchema = zod_1.z.object({
         .string()
         .uuid()
         .describe('Generate a valid uuid for image slot, that will be used for future lookups'),
-    prompt: zod_1.z.string().describe('Image prompt for slide'),
+    prompt: zod_1.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."'),
 });
 exports.IconSlotSchema = zod_1.z.object({
     uuid: zod_1.z
@@ -24,22 +34,26 @@ exports.IconSlotSchema = zod_1.z.object({
 exports.CoverSlideDataSchema = zod_1.z.object({
     contentType: zod_1.z.literal(enums_1.SLIDE_CONTENT_TYPE.COVER),
     title: zod_1.z.string().describe('Slide title in about 6 words').min(10).max(150),
-    author: zod_1.z.object({
+    author: zod_1.z
+        .object({
         label: zod_1.z.string().describe('Literal "Author" in presentation\'s language'),
-        value: zod_1.z
-            .string()
-            .describe('Literal "Author of the presentation" in presentation\'s language'),
-    }),
-    date: zod_1.z.object({
+        value: zod_1.z.string().describe('Author value from titlePage if provided'),
+    })
+        .optional(),
+    date: zod_1.z
+        .object({
         label: zod_1.z.string().describe('Literal "Date" in presentation\'s language'),
         value: zod_1.z
             .string()
-            .describe('Date of the presentation in the "dd month yyyy" format in presentation\'s locale'),
-    }),
-    email: zod_1.z.object({
-        label: zod_1.z.string().describe('Just default word "Email"'),
-        value: zod_1.z.string().describe('Just default "email@example.com"'),
-    }),
+            .describe('Date from titlePage in the "dd month yyyy" format in presentation\'s locale'),
+    })
+        .optional(),
+    email: zod_1.z
+        .object({
+        label: zod_1.z.string().describe('Localized contact/email label'),
+        value: zod_1.z.string().describe('Email value from titlePage if provided'),
+    })
+        .optional(),
     version: zod_1.z.literal(1),
 });
 exports.ThankYouSlideDataSchema = zod_1.z.object({
@@ -67,28 +81,49 @@ exports.ThankYouSlideDataSchema = zod_1.z.object({
 });
 exports.StructuredListSlideDataSchema = zod_1.z.object({
     contentType: zod_1.z.literal(enums_1.SLIDE_CONTENT_TYPE.STRUCTURED_LIST),
-    title: zod_1.z.string().describe('Slide title, 2–6 words').max(150),
-    description: zod_1.z.string().describe('One short framing sentence'),
+    title: zod_1.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: zod_1.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: zod_1.z
         .array(zod_1.z.object({
-        title: zod_1.z.string().describe('2–4 words, concrete'),
+        title: zod_1.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: zod_1.z
             .string()
-            .describe("One clear short framing sentence. DON'T CUT THE TEXT SHORT MID WORD/SENTENCE!. Generate less content if that happened")
+            .describe('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),
     version: zod_1.z.literal(1),
 });
 exports.TextSlideDataSchema = zod_1.z.object({
     contentType: zod_1.z.literal(enums_1.SLIDE_CONTENT_TYPE.TEXT),
-    title: zod_1.z.string().describe('Slide title in about 6 words').min(10).max(150),
+    title: zod_1.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: zod_1.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.")
+        .describe('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: zod_1.z.literal(1),
 });
 exports.ContentsSlideDataSchema = zod_1.z.object({
@@ -110,43 +145,92 @@ exports.ContentsSlideDataSchema = zod_1.z.object({
 exports.ImageSlideDataSchema = zod_1.z
     .object({
     contentType: zod_1.z.literal(enums_1.SLIDE_CONTENT_TYPE.TEXT_WITH_IMAGE),
-    title: zod_1.z.string().describe('Slide title in about 6 words').min(10).max(200),
-    description: zod_1.z
+    title: zod_1.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: zod_1.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: exports.ImageSlotSchema,
     version: zod_1.z.literal(1),
 })
-    .describe('Slide that contains a title, description of the title');
+    .describe('Slide with a large title and prose description on the left, and a full-bleed supporting image on the right.');
 exports.SectionBreakSlideDataSchema = zod_1.z.object({
     contentType: zod_1.z.literal(enums_1.SLIDE_CONTENT_TYPE.SECTION_BREAK),
-    title: zod_1.z.string().describe('Slide title in about 6 words').min(10).max(200),
-    description: zod_1.z.string().describe('Description of the slide in about 6 words').min(10).max(200),
+    title: zod_1.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: zod_1.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: zod_1.z.literal(1),
 });
 exports.TableSlideDataSchema = zod_1.z.object({
     contentType: zod_1.z.literal(enums_1.SLIDE_CONTENT_TYPE.TABLE),
     title: zod_1.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: zod_1.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: zod_1.z.string().describe('Description of the table represents').min(10).max(200),
+        .max(100),
     table: zod_1.z.object({
         columnHeaders: zod_1.z
-            .array(zod_1.z.string().min(1).max(50))
+            .array(zod_1.z
+            .string()
             .min(1)
-            .max(10)
-            .describe('Array of column header labels'),
+            .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: zod_1.z
-            .array(zod_1.z.array(zod_1.z.string().min(1).max(75)))
-            .min(3)
+            .array(zod_1.z
+            .array(zod_1.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'),
-        hasRowHeaders: zod_1.z.boolean().describe('If table needs special row headers, set this to true'),
-        hasSummaryRow: zod_1.z.boolean().describe('If table needs a summary row, set this to true'),
+            .describe('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: zod_1.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: zod_1.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.'),
     }),
     version: zod_1.z.literal(1),
 });
@@ -154,61 +238,113 @@ exports.TableSlideDataSchema = zod_1.z.object({
 exports.BarChartSlideDataSchema = zod_1.z.object({
     type: zod_1.z.literal(SLIDE_CHART_TYPE.BAR),
     categories: zod_1.z
-        .array(zod_1.z.string())
-        .min(1)
-        .max(12)
-        .describe('Category labels (e.g., months, products, regions)'),
+        .array(zod_1.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: zod_1.z
         .array(zod_1.z.object({
         name: zod_1.z
             .string()
-            .describe('Series name for legend. Try to include measurements if needed'),
-        data: zod_1.z.array(zod_1.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: zod_1.z
+            .array(zod_1.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: zod_1.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: zod_1.z.string().max(40).optional().describe('Y-axis label'),
-    unit: zod_1.z.string().max(10).optional().describe('Unit symbol (%, $, etc.)'),
+        .describe('Data series. Only ONE series is supported. Never add more than one.'),
+    yAxisLabel: zod_1.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: zod_1.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: zod_1.z.literal(1),
 });
 exports.ChartSlideDataSchema = zod_1.z.object({
     contentType: zod_1.z.literal(enums_1.SLIDE_CONTENT_TYPE.CHART),
-    title: zod_1.z.string().describe('Slide title in about 2-6 words').max(100),
-    description: zod_1.z.string().describe("Information on slide's topic").max(600),
+    title: zod_1.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: zod_1.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: zod_1.z.discriminatedUnion('type', [exports.BarChartSlideDataSchema]),
     version: zod_1.z.literal(1),
 });
 exports.TimelineSlideDataSchema = zod_1.z.object({
     contentType: zod_1.z.literal(enums_1.SLIDE_CONTENT_TYPE.TIMELINE),
-    title: zod_1.z.string().describe('Slide title in about 6 words').min(10).max(150),
-    description: zod_1.z.string().describe('Brief context for the timeline').min(10).max(200),
+    title: zod_1.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: zod_1.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: zod_1.z.object({
         events: zod_1.z
             .array(zod_1.z.object({
             date: zod_1.z
                 .string()
-                .describe('Date or time period label. MUST be general/approximate if exact date unknown (e.g., "Early 2020s", "Mid-1990s", "Recent years")')
+                .describe('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: zod_1.z
                 .string()
-                .describe('Event title. Prefer 2 words, max 3 words. Keep it short and punchy.')
-                .min(5)
-                .max(60),
+                .describe('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(3)
+                .max(35),
             description: zod_1.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: zod_1.z.literal(1),
 });

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@purpleschool/gptbot-tools",
-  "version": "0.1.10",
+  "version": "0.1.11",
   "main": "build/index.js",
   "types": "build/index.d.ts",
   "scripts": {

package/presentation/commands/create-presentation.command.ts

@@ -1,6 +1,7 @@
 import { z } from 'zod';
 import { ICommandResponseSchema } from '../../common';
-import { PresentationSchema } from '../models';
+import { PresentationSchema, PresentationTitlePageSchema } from '../models';
+import { PRESENTATION_TARGET_AUDIENCE } from '../enums';
 
 export namespace CreatePresentationCommand {
     export const RequestSchema = z.object({
@@ -10,6 +11,8 @@ export namespace CreatePresentationCommand {
         languageId: z.string(),
         prompt: z.string(),
         slideCount: z.number(),
+        titlePage: PresentationTitlePageSchema.optional().nullable(),
+        targetAudience: z.nativeEnum(PRESENTATION_TARGET_AUDIENCE).optional(),
     });
     export type Request = z.infer<typeof RequestSchema>;
 

package/presentation/commands/get-presentation-slides-generation-price.command.ts

@@ -4,6 +4,7 @@ import { ICommandResponseSchema } from '../../common';
 export namespace GetPresentationSlidesGenerationPriceCommand {
     export const RequestSchema = z.object({
         slideCount: z.number().int().min(1),
+        templateId: z.string().uuid(),
     });
     export type Request = z.infer<typeof RequestSchema>;
 

package/presentation/enums/index.ts

@@ -8,3 +8,4 @@ export * from './slide-image-slot-action.enum';
 export * from './presentation-ai-action-call-status.enum';
 export * from './presentation-ai-action-type.enum';
 export * from './presentation-ai-action-pricing-type.enum';
+export * from './presentation-target-audience.enum';

package/presentation/enums/presentation-target-audience.enum.ts

@@ -0,0 +1,6 @@
+export enum PRESENTATION_TARGET_AUDIENCE {
+    NONE = 'NONE',
+    SCHOOL = 'SCHOOL',
+    UNIVERSITY = 'UNIVERSITY',
+    BUSINESS = 'BUSINESS',
+}

package/presentation/models/index.ts

@@ -8,3 +8,4 @@ export * from './slide.schema';
 export * from './slide-image-slot.schema';
 export * from './slide-content.schema';
 export * from './presentation-ai-action.schema';
+export * from './presentation-title-page.schema';

package/presentation/models/presentation-template.schema.ts

@@ -5,6 +5,7 @@ export const PresentationTemplateSchema = z.object({
     title: z.string(),
     image: z.string(),
     order: z.number(),
+    price: z.number(),
     imagePlaceholder: z.string(),
     createdAt: z.date(),
     updatedAt: z.date(),

package/presentation/models/presentation-title-page.schema.ts

@@ -0,0 +1,9 @@
+import { z } from 'zod';
+
+export const PresentationTitlePageSchema = z.object({
+    author: z.string().optional().nullable(),
+    createdAt: z.date().optional().nullable(),
+    email: z.string().email().optional().nullable(),
+});
+
+export type PresentationTitlePage = z.infer<typeof PresentationTitlePageSchema>;

package/presentation/models/presentation.schema.ts

@@ -1,8 +1,9 @@
 import { z } from 'zod';
-import { PRESENTATION_STAGE } from '../enums';
+import { PRESENTATION_STAGE, PRESENTATION_TARGET_AUDIENCE } from '../enums';
 import { SlideOutlineSchema } from './slide-outline.schema';
 import { SlideSchema } from './slide.schema';
 import { USER_REACTION } from '../../common';
+import { PresentationTitlePageSchema } from './presentation-title-page.schema';
 
 export const PresentationSchema = z.object({
     uuid: z.string().uuid(),
@@ -22,6 +23,8 @@ export const PresentationSchema = z.object({
     tokenReservationId: z.string().nullable().optional(),
     lastContentUpdateAt: z.date().nullable(),
     lastPptxExportedAt: z.date().nullable(),
+    titlePage: PresentationTitlePageSchema.nullable(),
+    targetAudience: z.nativeEnum(PRESENTATION_TARGET_AUDIENCE),
     createdAt: z.date(),
     updatedAt: z.date(),
 });
@@ -36,5 +39,6 @@ export type PresentationWithSlides = z.infer<typeof PresentationWithSlidesSchema
 export const PresentationUpdateSchema = PresentationSchema.pick({
     title: true,
     templateId: true,
+    titlePage: true,
 }).partial();
 export type PresentationUpdate = z.infer<typeof PresentationUpdateSchema>;

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

@@ -19,18 +19,24 @@ import {
 export const CoverSlideDataUserEditSchema = z.object({
     contentType: z.literal(SLIDE_CONTENT_TYPE.COVER),
     title: z.string().min(1).max(500),
-    author: z.object({
-        label: z.string().min(1).max(100),
-        value: z.string().min(1).max(200),
-    }),
-    date: z.object({
-        label: z.string().min(1).max(100),
-        value: z.string().min(1).max(200),
-    }),
-    email: z.object({
-        label: z.string().min(1).max(100),
-        value: z.string().min(1).max(200),
-    }),
+    author: z
+        .object({
+            label: z.string().min(1).max(100),
+            value: z.string().min(1).max(200),
+        })
+        .optional(),
+    date: z
+        .object({
+            label: z.string().min(1).max(100),
+            value: z.string().min(1).max(200),
+        })
+        .optional(),
+    email: z
+        .object({
+            label: z.string().min(1).max(100),
+            value: z.string().min(1).max(200),
+        })
+        .optional(),
     version: z.literal(1),
 }) satisfies z.ZodType<ICoverSlideDataStructure>;
 

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>;
 
@@ -26,9 +38,9 @@ export type IconSlot = z.infer<typeof IconSlotSchema>;
 export interface ICoverSlideDataStructure {
     contentType: SLIDE_CONTENT_TYPE.COVER;
     title: string;
-    author: { label: string; value: string };
-    date: { label: string; value: string };
-    email: { label: string; value: string };
+    author?: { label: string; value: string };
+    date?: { label: string; value: string };
+    email?: { label: string; value: string };
     version: 1;
 }
 
@@ -125,24 +137,28 @@ export interface ITimelineSlideDataStructure {
 export const CoverSlideDataSchema = z.object({
     contentType: z.literal(SLIDE_CONTENT_TYPE.COVER),
     title: z.string().describe('Slide title in about 6 words').min(10).max(150),
-    author: z.object({
-        label: z.string().describe('Literal "Author" in presentation\'s language'),
-        value: z
-            .string()
-            .describe('Literal "Author of the presentation" in presentation\'s language'),
-    }),
-    date: z.object({
-        label: z.string().describe('Literal "Date" in presentation\'s language'),
-        value: z
-            .string()
-            .describe(
-                'Date of the presentation in the "dd month yyyy" format in presentation\'s locale',
-            ),
-    }),
-    email: z.object({
-        label: z.string().describe('Just default word "Email"'),
-        value: z.string().describe('Just default "email@example.com"'),
-    }),
+    author: z
+        .object({
+            label: z.string().describe('Literal "Author" in presentation\'s language'),
+            value: z.string().describe('Author value from titlePage if provided'),
+        })
+        .optional(),
+    date: z
+        .object({
+            label: z.string().describe('Literal "Date" in presentation\'s language'),
+            value: z
+                .string()
+                .describe(
+                    'Date from titlePage in the "dd month yyyy" format in presentation\'s locale',
+                ),
+        })
+        .optional(),
+    email: z
+        .object({
+            label: z.string().describe('Localized contact/email label'),
+            value: z.string().describe('Email value from titlePage if provided'),
+        })
+        .optional(),
     version: z.literal(1),
 }) satisfies z.ZodType<ICoverSlideDataStructure>;
 export type CoverSlideData = z.infer<typeof CoverSlideDataSchema>;
@@ -176,19 +192,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 +232,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 +282,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 +337,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 +413,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 +499,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 +522,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>;