@purpleschool/gptbot-tools 0.4.1-stage-2-no-html → 0.4.2-stage-2

package/build/html-page-builder/commands/get-html-page-builder-price-calculation-data.command.d.ts

@@ -1,10 +1,13 @@
 import { z } from 'zod';
-import { HTML_PAGE_BUILDER_SESSION_STAGE } from '../enums';
 export declare namespace GetHtmlPageBuilderPriceCalculationDataCommand {
     const RequestSchema: z.ZodObject<{
         modelId: z.ZodUUID;
         inputLength: z.ZodNumber;
         sessionId: z.ZodOptional<z.ZodNullable<z.ZodUUID>>;
+        pagesCount: z.ZodNumber;
+        styleId: z.ZodUUID;
+        fontId: z.ZodUUID;
+        clarificationsLength: z.ZodOptional<z.ZodNumber>;
     }, z.core.$strip>;
     type Request = z.infer<typeof RequestSchema>;
     const ResponseDataSchema: z.ZodObject<{
@@ -12,18 +15,25 @@ export declare namespace GetHtmlPageBuilderPriceCalculationDataCommand {
             inputPrice: z.ZodNumber;
             outputPrice: z.ZodNumber;
         }, z.core.$strip>;
+        clarificationsModelPricing: z.ZodOptional<z.ZodObject<{
+            inputPrice: z.ZodNumber;
+            outputPrice: z.ZodNumber;
+        }, z.core.$strip>>;
         effectivePromptLength: z.ZodNumber;
         breakdown: z.ZodObject<{
             systemPromptLength: z.ZodNumber;
             inputLength: z.ZodNumber;
-            currentHtmlLength: z.ZodNumber;
             userPromptTemplateOverheadLength: z.ZodNumber;
             modeHintLength: z.ZodNumber;
             userMessageLength: z.ZodNumber;
             attachmentsTextLength: z.ZodNumber;
+            pagesCount: z.ZodOptional<z.ZodNumber>;
+            clarificationsLength: z.ZodOptional<z.ZodNumber>;
+            sitemapPromptLength: z.ZodOptional<z.ZodNumber>;
+            subPagesPromptLength: z.ZodOptional<z.ZodNumber>;
+            clarificationsStepPromptLength: z.ZodOptional<z.ZodNumber>;
         }, z.core.$strip>;
         metadata: z.ZodObject<{
-            mode: z.ZodEnum<typeof HTML_PAGE_BUILDER_SESSION_STAGE>;
             modelId: z.ZodUUID;
             sessionId: z.ZodNullable<z.ZodUUID>;
         }, z.core.$strip>;
@@ -36,18 +46,25 @@ export declare namespace GetHtmlPageBuilderPriceCalculationDataCommand {
                 inputPrice: number;
                 outputPrice: number;
             };
+            clarificationsModelPricing?: {
+                inputPrice: number;
+                outputPrice: number;
+            } | undefined;
             effectivePromptLength: number;
             breakdown: {
                 systemPromptLength: number;
                 inputLength: number;
-                currentHtmlLength: number;
                 userPromptTemplateOverheadLength: number;
                 modeHintLength: number;
                 userMessageLength: number;
                 attachmentsTextLength: number;
+                pagesCount?: number | undefined;
+                clarificationsLength?: number | undefined;
+                sitemapPromptLength?: number | undefined;
+                subPagesPromptLength?: number | undefined;
+                clarificationsStepPromptLength?: number | undefined;
             };
             metadata: {
-                mode: HTML_PAGE_BUILDER_SESSION_STAGE;
                 modelId: string;
                 sessionId: string | null;
             };
@@ -56,18 +73,25 @@ export declare namespace GetHtmlPageBuilderPriceCalculationDataCommand {
                 inputPrice: number;
                 outputPrice: number;
             };
+            clarificationsModelPricing?: {
+                inputPrice: number;
+                outputPrice: number;
+            } | undefined;
             effectivePromptLength: number;
             breakdown: {
                 systemPromptLength: number;
                 inputLength: number;
-                currentHtmlLength: number;
                 userPromptTemplateOverheadLength: number;
                 modeHintLength: number;
                 userMessageLength: number;
                 attachmentsTextLength: number;
+                pagesCount?: number | undefined;
+                clarificationsLength?: number | undefined;
+                sitemapPromptLength?: number | undefined;
+                subPagesPromptLength?: number | undefined;
+                clarificationsStepPromptLength?: number | undefined;
             };
             metadata: {
-                mode: HTML_PAGE_BUILDER_SESSION_STAGE;
                 modelId: string;
                 sessionId: string | null;
             };

package/build/html-page-builder/commands/get-html-page-builder-price-calculation-data.command.js

@@ -3,31 +3,58 @@ Object.defineProperty(exports, "__esModule", { value: true });
 exports.GetHtmlPageBuilderPriceCalculationDataCommand = void 0;
 const zod_1 = require("zod");
 const command_response_schema_1 = require("../../common/models/command-response.schema");
-const enums_1 = require("../enums");
 var GetHtmlPageBuilderPriceCalculationDataCommand;
 (function (GetHtmlPageBuilderPriceCalculationDataCommand) {
     GetHtmlPageBuilderPriceCalculationDataCommand.RequestSchema = zod_1.z.object({
         modelId: zod_1.z.uuid(),
+        // Bounded by the model's own `maxPromptLength`, checked in the service: a quote for a
+        // prompt `execute` would refuse is meaningless, and the estimate builds placeholder
+        // strings of this length.
         inputLength: zod_1.z.number().int().nonnegative(),
         sessionId: zod_1.z.uuid().nullable().optional(),
+        // Required, exactly as in `execute`: the volume is what the run is priced by
+        pagesCount: zod_1.z.number().int().positive(),
+        /**
+         * Design of the planned site. The style and font directives are part of the prompt of the
+         * clarifying step, so they are part of what is quoted — a quote without them would
+         * under-reserve by their own length. Required for the same reason `execute` requires them.
+         */
+        styleId: zod_1.z.uuid(),
+        fontId: zod_1.z.uuid(),
+        // Length of the rendered clarifications block; it is part of the paid prompt
+        clarificationsLength: zod_1.z.number().int().nonnegative().optional(),
     });
     GetHtmlPageBuilderPriceCalculationDataCommand.ResponseDataSchema = zod_1.z.object({
         modelPricing: zod_1.z.object({
             inputPrice: zod_1.z.number(),
             outputPrice: zod_1.z.number(),
         }),
+        /**
+         * The clarifying step runs on a model of its own, fixed inside the service, so its price
+         * cannot be derived from `modelPricing`.
+         */
+        clarificationsModelPricing: zod_1.z
+            .object({
+            inputPrice: zod_1.z.number(),
+            outputPrice: zod_1.z.number(),
+        })
+            .optional(),
         effectivePromptLength: zod_1.z.number(),
         breakdown: zod_1.z.object({
             systemPromptLength: zod_1.z.number(),
             inputLength: zod_1.z.number(),
-            currentHtmlLength: zod_1.z.number(),
             userPromptTemplateOverheadLength: zod_1.z.number(),
             modeHintLength: zod_1.z.number(),
             userMessageLength: zod_1.z.number(),
             attachmentsTextLength: zod_1.z.number(),
+            pagesCount: zod_1.z.number().optional(),
+            clarificationsLength: zod_1.z.number().optional(),
+            sitemapPromptLength: zod_1.z.number().optional(),
+            subPagesPromptLength: zod_1.z.number().optional(),
+            // Prompt length of the clarifying step, priced by `clarificationsModelPricing`
+            clarificationsStepPromptLength: zod_1.z.number().optional(),
         }),
         metadata: zod_1.z.object({
-            mode: zod_1.z.enum(enums_1.HTML_PAGE_BUILDER_SESSION_STAGE),
             modelId: zod_1.z.uuid(),
             sessionId: zod_1.z.uuid().nullable(),
         }),

package/build/html-page-builder/commands/html-page-builder-answer-questions.command.d.ts

@@ -0,0 +1,244 @@
+import { z } from 'zod';
+/**
+ * Free on purpose: the generation was already paid for by `execute`, and this is the same run
+ * continuing. It carries no `tokenReservationId` and no price.
+ */
+export declare namespace HtmlPageBuilderAnswerQuestionsCommand {
+    const RequestSchema: z.ZodObject<{
+        userId: z.ZodOptional<z.ZodNullable<z.ZodUUID>>;
+        unregisteredUserId: z.ZodOptional<z.ZodNullable<z.ZodUUID>>;
+        jobId: z.ZodUUID;
+        answers: z.ZodArray<z.ZodObject<{
+            questionId: z.ZodString;
+            answers: z.ZodArray<z.ZodString>;
+        }, z.core.$strip>>;
+    }, z.core.$strip>;
+    type Request = z.infer<typeof RequestSchema>;
+    const ResponseSchema: z.ZodObject<{
+        isSuccess: z.ZodBoolean;
+        data: z.ZodOptional<z.ZodType<{
+            uuid: string;
+            title: string;
+            status: import("..").HTML_PAGE_BUILDER_SESSION_STATUS;
+            currentHtml?: string | null | undefined;
+            currentJobId?: string | null | undefined;
+            currentJob?: {
+                uuid: string;
+                status: import("../..").JOB_STATUS;
+                previewUrl?: string | undefined;
+                files?: {
+                    stylesheet: string;
+                    script: string;
+                    pages: {
+                        slug: string;
+                        url: string;
+                    }[];
+                } | undefined;
+                error: string | null;
+                createdAt: Date;
+                completedAt?: Date | null | undefined;
+            } | null | undefined;
+            lastUsedModelId?: string | null | undefined;
+            reaction: import("../..").USER_REACTION | null;
+            dislikeReason: string | null;
+            userId?: string | null | undefined;
+            unregisteredUserId?: string | null | undefined;
+            isDeleted: boolean;
+            isFavorite: boolean;
+            jobs?: {
+                uuid: string;
+                sessionId: string;
+                modelId: string;
+                userPrompt: string;
+                title: string;
+                generatedHtml?: string | null | undefined;
+                generatedPages?: {
+                    slug: string;
+                    title: string;
+                    html: string;
+                    order: number;
+                    isHome: boolean;
+                }[] | null | undefined;
+                previewUrl?: string | undefined;
+                files?: {
+                    stylesheet: string;
+                    script: string;
+                    pages: {
+                        slug: string;
+                        url: string;
+                    }[];
+                } | undefined;
+                status: import("../..").JOB_STATUS;
+                error: string | null;
+                internalError?: string | null | undefined;
+                price: number;
+                inputTokens?: number | null | undefined;
+                outputTokens?: number | null | undefined;
+                totalTokens?: number | null | undefined;
+                tokenReservationId?: string | null | undefined;
+                questions: {
+                    id: string;
+                    question: string;
+                    type: import("..").HTML_PAGE_BUILDER_QUESTION_TYPE;
+                    options: string[];
+                    recommendedAnswer: string;
+                    allowCustomAnswer: boolean;
+                }[];
+                answers: {
+                    questionId: string;
+                    answers: string[];
+                }[];
+                styleId?: string | null | undefined;
+                fontId?: string | null | undefined;
+                accentColor: string;
+                userId?: string | null | undefined;
+                unregisteredUserId?: string | null | undefined;
+                params: {
+                    attachedFiles: {
+                        uuid: string;
+                        url: string;
+                        name: string;
+                        mimeType: string;
+                        type: string;
+                        size: number;
+                        duration?: number | null | undefined;
+                        content?: string | null | undefined;
+                        contentLength?: number | null | undefined;
+                    }[];
+                    pagesCount?: number | undefined;
+                    clarifications: {
+                        question: string;
+                        answer: string;
+                    }[];
+                    mock?: boolean | undefined;
+                };
+                isDeleted: boolean;
+                createdAt: Date;
+                completedAt?: Date | null | undefined;
+                updatedAt: Date;
+            }[] | undefined;
+            pages?: {
+                slug: string;
+                title: string;
+                html: string;
+                order: number;
+                isHome: boolean;
+            }[] | undefined;
+            createdAt: Date;
+            updatedAt: Date;
+        }, unknown, z.core.$ZodTypeInternals<{
+            uuid: string;
+            title: string;
+            status: import("..").HTML_PAGE_BUILDER_SESSION_STATUS;
+            currentHtml?: string | null | undefined;
+            currentJobId?: string | null | undefined;
+            currentJob?: {
+                uuid: string;
+                status: import("../..").JOB_STATUS;
+                previewUrl?: string | undefined;
+                files?: {
+                    stylesheet: string;
+                    script: string;
+                    pages: {
+                        slug: string;
+                        url: string;
+                    }[];
+                } | undefined;
+                error: string | null;
+                createdAt: Date;
+                completedAt?: Date | null | undefined;
+            } | null | undefined;
+            lastUsedModelId?: string | null | undefined;
+            reaction: import("../..").USER_REACTION | null;
+            dislikeReason: string | null;
+            userId?: string | null | undefined;
+            unregisteredUserId?: string | null | undefined;
+            isDeleted: boolean;
+            isFavorite: boolean;
+            jobs?: {
+                uuid: string;
+                sessionId: string;
+                modelId: string;
+                userPrompt: string;
+                title: string;
+                generatedHtml?: string | null | undefined;
+                generatedPages?: {
+                    slug: string;
+                    title: string;
+                    html: string;
+                    order: number;
+                    isHome: boolean;
+                }[] | null | undefined;
+                previewUrl?: string | undefined;
+                files?: {
+                    stylesheet: string;
+                    script: string;
+                    pages: {
+                        slug: string;
+                        url: string;
+                    }[];
+                } | undefined;
+                status: import("../..").JOB_STATUS;
+                error: string | null;
+                internalError?: string | null | undefined;
+                price: number;
+                inputTokens?: number | null | undefined;
+                outputTokens?: number | null | undefined;
+                totalTokens?: number | null | undefined;
+                tokenReservationId?: string | null | undefined;
+                questions: {
+                    id: string;
+                    question: string;
+                    type: import("..").HTML_PAGE_BUILDER_QUESTION_TYPE;
+                    options: string[];
+                    recommendedAnswer: string;
+                    allowCustomAnswer: boolean;
+                }[];
+                answers: {
+                    questionId: string;
+                    answers: string[];
+                }[];
+                styleId?: string | null | undefined;
+                fontId?: string | null | undefined;
+                accentColor: string;
+                userId?: string | null | undefined;
+                unregisteredUserId?: string | null | undefined;
+                params: {
+                    attachedFiles: {
+                        uuid: string;
+                        url: string;
+                        name: string;
+                        mimeType: string;
+                        type: string;
+                        size: number;
+                        duration?: number | null | undefined;
+                        content?: string | null | undefined;
+                        contentLength?: number | null | undefined;
+                    }[];
+                    pagesCount?: number | undefined;
+                    clarifications: {
+                        question: string;
+                        answer: string;
+                    }[];
+                    mock?: boolean | undefined;
+                };
+                isDeleted: boolean;
+                createdAt: Date;
+                completedAt?: Date | null | undefined;
+                updatedAt: Date;
+            }[] | undefined;
+            pages?: {
+                slug: string;
+                title: string;
+                html: string;
+                order: number;
+                isHome: boolean;
+            }[] | undefined;
+            createdAt: Date;
+            updatedAt: Date;
+        }, unknown>>>;
+        code: z.ZodOptional<z.ZodString>;
+        message: z.ZodOptional<z.ZodString>;
+    }, z.core.$strip>;
+    type Response = z.infer<typeof ResponseSchema>;
+}

package/build/html-page-builder/commands/html-page-builder-answer-questions.command.js

@@ -0,0 +1,23 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.HtmlPageBuilderAnswerQuestionsCommand = void 0;
+const zod_1 = require("zod");
+const command_response_schema_1 = require("../../common/models/command-response.schema");
+const models_1 = require("../models");
+/**
+ * Free on purpose: the generation was already paid for by `execute`, and this is the same run
+ * continuing. It carries no `tokenReservationId` and no price.
+ */
+var HtmlPageBuilderAnswerQuestionsCommand;
+(function (HtmlPageBuilderAnswerQuestionsCommand) {
+    HtmlPageBuilderAnswerQuestionsCommand.RequestSchema = zod_1.z.object({
+        userId: zod_1.z.uuid().nullable().optional(),
+        unregisteredUserId: zod_1.z.uuid().nullable().optional(),
+        jobId: zod_1.z.uuid(),
+        // An empty array is valid: the user is allowed to skip the questions on purpose,
+        // and the brief then falls back to the model's own recommendations
+        answers: models_1.HtmlPageBuilderClarificationAnswersSchema,
+    });
+    // Answers the session, like execute does: the client is polling it anyway
+    HtmlPageBuilderAnswerQuestionsCommand.ResponseSchema = (0, command_response_schema_1.ICommandResponseSchema)(models_1.HtmlPageBuilderSessionSchema);
+})(HtmlPageBuilderAnswerQuestionsCommand || (exports.HtmlPageBuilderAnswerQuestionsCommand = HtmlPageBuilderAnswerQuestionsCommand = {}));

package/build/html-page-builder/commands/html-page-builder-execute.command.d.ts

@@ -20,7 +20,17 @@ export declare namespace HtmlPageBuilderExecuteCommand {
                 content: z.ZodNullable<z.ZodOptional<z.ZodString>>;
                 contentLength: z.ZodNullable<z.ZodOptional<z.ZodNumber>>;
             }, z.core.$strip>>;
+            pagesCount: z.ZodOptional<z.ZodNumber>;
+            clarifications: z.ZodDefault<z.ZodArray<z.ZodObject<{
+                question: z.ZodString;
+                answer: z.ZodString;
+            }, z.core.$strip>>>;
+            mock: z.ZodOptional<z.ZodBoolean>;
         }, z.core.$strip>;
+        pagesCount: z.ZodNumber;
+        styleId: z.ZodUUID;
+        fontId: z.ZodUUID;
+        accentColor: z.ZodOptional<z.ZodString>;
         tokenReservationId: z.ZodOptional<z.ZodUUID>;
         precalculatedPrice: z.ZodOptional<z.ZodNumber>;
         mock: z.ZodOptional<z.ZodBoolean>;
@@ -31,10 +41,28 @@ export declare namespace HtmlPageBuilderExecuteCommand {
         data: z.ZodOptional<z.ZodType<{
             uuid: string;
             title: string;
-            status: import("../..").JOB_STATUS;
-            stage: import("..").HTML_PAGE_BUILDER_SESSION_STAGE;
+            status: import("..").HTML_PAGE_BUILDER_SESSION_STATUS;
             currentHtml?: string | null | undefined;
+            currentJobId?: string | null | undefined;
+            currentJob?: {
+                uuid: string;
+                status: import("../..").JOB_STATUS;
+                previewUrl?: string | undefined;
+                files?: {
+                    stylesheet: string;
+                    script: string;
+                    pages: {
+                        slug: string;
+                        url: string;
+                    }[];
+                } | undefined;
+                error: string | null;
+                createdAt: Date;
+                completedAt?: Date | null | undefined;
+            } | null | undefined;
             lastUsedModelId?: string | null | undefined;
+            reaction: import("../..").USER_REACTION | null;
+            dislikeReason: string | null;
             userId?: string | null | undefined;
             unregisteredUserId?: string | null | undefined;
             isDeleted: boolean;
@@ -46,16 +74,45 @@ export declare namespace HtmlPageBuilderExecuteCommand {
                 userPrompt: string;
                 title: string;
                 generatedHtml?: string | null | undefined;
+                generatedPages?: {
+                    slug: string;
+                    title: string;
+                    html: string;
+                    order: number;
+                    isHome: boolean;
+                }[] | null | undefined;
+                previewUrl?: string | undefined;
+                files?: {
+                    stylesheet: string;
+                    script: string;
+                    pages: {
+                        slug: string;
+                        url: string;
+                    }[];
+                } | undefined;
                 status: import("../..").JOB_STATUS;
                 error: string | null;
                 internalError?: string | null | undefined;
                 price: number;
-                reaction: import("../..").USER_REACTION | null;
-                dislikeReason: string | null;
                 inputTokens?: number | null | undefined;
                 outputTokens?: number | null | undefined;
                 totalTokens?: number | null | undefined;
                 tokenReservationId?: string | null | undefined;
+                questions: {
+                    id: string;
+                    question: string;
+                    type: import("..").HTML_PAGE_BUILDER_QUESTION_TYPE;
+                    options: string[];
+                    recommendedAnswer: string;
+                    allowCustomAnswer: boolean;
+                }[];
+                answers: {
+                    questionId: string;
+                    answers: string[];
+                }[];
+                styleId?: string | null | undefined;
+                fontId?: string | null | undefined;
+                accentColor: string;
                 userId?: string | null | undefined;
                 unregisteredUserId?: string | null | undefined;
                 params: {
@@ -70,21 +127,52 @@ export declare namespace HtmlPageBuilderExecuteCommand {
                         content?: string | null | undefined;
                         contentLength?: number | null | undefined;
                     }[];
+                    pagesCount?: number | undefined;
+                    clarifications: {
+                        question: string;
+                        answer: string;
+                    }[];
+                    mock?: boolean | undefined;
                 };
                 isDeleted: boolean;
                 createdAt: Date;
                 completedAt?: Date | null | undefined;
                 updatedAt: Date;
             }[] | undefined;
+            pages?: {
+                slug: string;
+                title: string;
+                html: string;
+                order: number;
+                isHome: boolean;
+            }[] | undefined;
             createdAt: Date;
             updatedAt: Date;
         }, unknown, z.core.$ZodTypeInternals<{
             uuid: string;
             title: string;
-            status: import("../..").JOB_STATUS;
-            stage: import("..").HTML_PAGE_BUILDER_SESSION_STAGE;
+            status: import("..").HTML_PAGE_BUILDER_SESSION_STATUS;
             currentHtml?: string | null | undefined;
+            currentJobId?: string | null | undefined;
+            currentJob?: {
+                uuid: string;
+                status: import("../..").JOB_STATUS;
+                previewUrl?: string | undefined;
+                files?: {
+                    stylesheet: string;
+                    script: string;
+                    pages: {
+                        slug: string;
+                        url: string;
+                    }[];
+                } | undefined;
+                error: string | null;
+                createdAt: Date;
+                completedAt?: Date | null | undefined;
+            } | null | undefined;
             lastUsedModelId?: string | null | undefined;
+            reaction: import("../..").USER_REACTION | null;
+            dislikeReason: string | null;
             userId?: string | null | undefined;
             unregisteredUserId?: string | null | undefined;
             isDeleted: boolean;
@@ -96,16 +184,45 @@ export declare namespace HtmlPageBuilderExecuteCommand {
                 userPrompt: string;
                 title: string;
                 generatedHtml?: string | null | undefined;
+                generatedPages?: {
+                    slug: string;
+                    title: string;
+                    html: string;
+                    order: number;
+                    isHome: boolean;
+                }[] | null | undefined;
+                previewUrl?: string | undefined;
+                files?: {
+                    stylesheet: string;
+                    script: string;
+                    pages: {
+                        slug: string;
+                        url: string;
+                    }[];
+                } | undefined;
                 status: import("../..").JOB_STATUS;
                 error: string | null;
                 internalError?: string | null | undefined;
                 price: number;
-                reaction: import("../..").USER_REACTION | null;
-                dislikeReason: string | null;
                 inputTokens?: number | null | undefined;
                 outputTokens?: number | null | undefined;
                 totalTokens?: number | null | undefined;
                 tokenReservationId?: string | null | undefined;
+                questions: {
+                    id: string;
+                    question: string;
+                    type: import("..").HTML_PAGE_BUILDER_QUESTION_TYPE;
+                    options: string[];
+                    recommendedAnswer: string;
+                    allowCustomAnswer: boolean;
+                }[];
+                answers: {
+                    questionId: string;
+                    answers: string[];
+                }[];
+                styleId?: string | null | undefined;
+                fontId?: string | null | undefined;
+                accentColor: string;
                 userId?: string | null | undefined;
                 unregisteredUserId?: string | null | undefined;
                 params: {
@@ -120,12 +237,25 @@ export declare namespace HtmlPageBuilderExecuteCommand {
                         content?: string | null | undefined;
                         contentLength?: number | null | undefined;
                     }[];
+                    pagesCount?: number | undefined;
+                    clarifications: {
+                        question: string;
+                        answer: string;
+                    }[];
+                    mock?: boolean | undefined;
                 };
                 isDeleted: boolean;
                 createdAt: Date;
                 completedAt?: Date | null | undefined;
                 updatedAt: Date;
             }[] | undefined;
+            pages?: {
+                slug: string;
+                title: string;
+                html: string;
+                order: number;
+                isHome: boolean;
+            }[] | undefined;
             createdAt: Date;
             updatedAt: Date;
         }, unknown>>>;

package/build/html-page-builder/commands/html-page-builder-execute.command.js

@@ -11,10 +11,28 @@ var HtmlPageBuilderExecuteCommand;
         userId: zod_1.z.uuid().nullable().optional(),
         unregisteredUserId: zod_1.z.uuid().nullable().optional(),
         scope: zod_1.z.enum(common_1.JOB_SCOPE).optional().default(common_1.JOB_SCOPE.TOOL),
+        // A repeated execute builds another site in the same session: its own questions, its own
+        // payment, its own job. The previous variants stay in the history.
         sessionId: zod_1.z.uuid().optional(),
         userPrompt: zod_1.z.string(),
         modelId: zod_1.z.uuid(),
         params: models_1.HtmlPageBuilderJobParamsSchema,
+        // Clamped to [1, 3, 5] on the server. Required: the volume is what the run is priced by,
+        // so a request that does not name it would be paid for as something else.
+        pagesCount: zod_1.z.number().int().positive(),
+        /**
+         * Design of the site. Required: every run builds a site from scratch, and a generation
+         * without a style is not a cheaper site, it is a different one. The prompts behind
+         * `styleId` / `fontId` are resolved on the server and never leave it.
+         */
+        styleId: zod_1.z.uuid(),
+        fontId: zod_1.z.uuid(),
+        /**
+         * The one optional part of the design: a palette the model is free to choose itself.
+         * Bounded on purpose — it lands in the prompt, so it must not become a way to smuggle
+         * unlimited text past the model's maxPromptLength check.
+         */
+        accentColor: zod_1.z.string().max(64).optional(),
         tokenReservationId: zod_1.z.uuid().optional(),
         precalculatedPrice: zod_1.z.number().optional(),
         mock: zod_1.z.boolean().optional(),