@juspay/neurolink 9.0.1 → 9.1.0

package/CHANGELOG.md

@@ -1,3 +1,9 @@
+## [9.1.0](https://github.com/juspay/neurolink/compare/v9.0.1...v9.1.0) (2026-02-05)
+
+### Features
+
+- **(ppt):** Implement Orchestration and Assembly layer For PPT Gen ([7e53846](https://github.com/juspay/neurolink/commit/7e53846815a14e6b4793e31048efe121bbc84ef5))
+
 ## [9.0.1](https://github.com/juspay/neurolink/compare/v9.0.0...v9.0.1) (2026-02-03)
 
 ### Bug Fixes

package/dist/core/baseProvider.d.ts

@@ -256,6 +256,30 @@ export declare abstract class BaseProvider implements AIProvider {
      * ```
      */
     private handleVideoGeneration;
+    /**
+     * Handle PPT generation mode
+     *
+     * Generates a complete PowerPoint presentation using AI content planning
+     * and slide generation. This method orchestrates:
+     * 1. Input validation
+     * 2. Content planning via AI
+     * 3. Individual slide generation (with optional images)
+     * 4. PPTX assembly and file output
+     *
+     * @param options - Text generation options with PPT config
+     * @param startTime - Generation start timestamp for metrics
+     * @returns Enhanced result with PPT data
+     *
+     * @example
+     * ```typescript
+     * const result = await provider.generate({
+     *   input: { text: "Introducing Our New Product" },
+     *   output: { mode: "ppt", ppt: { pages: 10, theme: "modern" } }
+     * });
+     * // result.ppt contains the generated presentation info
+     * ```
+     */
+    private handlePPTGeneration;
     /**
      * Create analytics - delegated to TelemetryHandler
      */

package/dist/core/baseProvider.js

@@ -346,9 +346,15 @@ export class BaseProvider {
         try {
             // ===== VIDEO GENERATION MODE =====
             // Generate video from image + prompt using Veo 3.1
-            if (options.output?.mode === "video") {
+            if (options.output?.mode === "video" || options.output?.video) {
                 return await this.handleVideoGeneration(options, startTime);
             }
+            // ===== PPT GENERATION MODE =====
+            // Generate PowerPoint presentation from topic using AI content planning
+            // Triggered by mode="ppt" OR presence of ppt config block
+            if (options.output?.mode === "ppt" || options.output?.ppt) {
+                return await this.handlePPTGeneration(options, startTime);
+            }
             // ===== IMAGE GENERATION MODE =====
             // Route to executeImageGeneration for image generation models
             const isImageModel = IMAGE_GENERATION_MODELS.some((m) => this.modelName.includes(m));
@@ -682,14 +688,21 @@ export class BaseProvider {
     }
     async enhanceResult(result, options, startTime) {
         const responseTime = Date.now() - startTime;
-        // CRITICAL FIX: Store imageOutput separately to ensure it's preserved
         const imageOutput = result.imageOutput;
+        const ppt = result.ppt;
+        const video = result.video;
         let enhancedResult = { ...result };
         if (options.enableAnalytics) {
             try {
                 const analytics = await this.createAnalytics(result, responseTime, options);
-                // Preserve ALL fields including imageOutput when adding analytics
-                enhancedResult = { ...enhancedResult, analytics, imageOutput };
+                // Preserve ALL fields when adding analytics
+                enhancedResult = {
+                    ...enhancedResult,
+                    analytics,
+                    imageOutput,
+                    ppt,
+                    video,
+                };
             }
             catch (error) {
                 logger.warn(`Analytics creation failed for ${this.providerName}:`, error);
@@ -698,17 +711,28 @@ export class BaseProvider {
         if (options.enableEvaluation) {
             try {
                 const evaluation = await this.createEvaluation(result, options);
-                // Preserve ALL fields including imageOutput when adding evaluation
-                enhancedResult = { ...enhancedResult, evaluation, imageOutput };
+                // Preserve ALL fields when adding evaluation
+                enhancedResult = {
+                    ...enhancedResult,
+                    evaluation,
+                    imageOutput,
+                    ppt,
+                    video,
+                };
             }
             catch (error) {
                 logger.warn(`Evaluation creation failed for ${this.providerName}:`, error);
             }
         }
-        // CRITICAL FIX: Always restore imageOutput if it existed in the original result
         if (imageOutput) {
             enhancedResult.imageOutput = imageOutput;
         }
+        if (ppt) {
+            enhancedResult.ppt = ppt;
+        }
+        if (video) {
+            enhancedResult.video = video;
+        }
         return enhancedResult;
     }
     /**
@@ -880,6 +904,103 @@ export class BaseProvider {
         };
         return await this.enhanceResult(baseResult, options, startTime);
     }
+    /**
+     * Handle PPT generation mode
+     *
+     * Generates a complete PowerPoint presentation using AI content planning
+     * and slide generation. This method orchestrates:
+     * 1. Input validation
+     * 2. Content planning via AI
+     * 3. Individual slide generation (with optional images)
+     * 4. PPTX assembly and file output
+     *
+     * @param options - Text generation options with PPT config
+     * @param startTime - Generation start timestamp for metrics
+     * @returns Enhanced result with PPT data
+     *
+     * @example
+     * ```typescript
+     * const result = await provider.generate({
+     *   input: { text: "Introducing Our New Product" },
+     *   output: { mode: "ppt", ppt: { pages: 10, theme: "modern" } }
+     * });
+     * // result.ppt contains the generated presentation info
+     * ```
+     */
+    async handlePPTGeneration(options, startTime) {
+        // Dynamic imports to avoid loading PPT dependencies unless needed
+        const { generatePresentation } = await import("../features/ppt/presentationOrchestrator.js");
+        const { PPT_GENERATION_TIMEOUT_MS } = await import("../features/ppt/constants.js");
+        const { validatePPTGenerationInput } = await import("../utils/parameterValidation.js");
+        const { ErrorFactory, withTimeout } = await import("../utils/errorHandling.js");
+        const { extractPPTContext, getEffectivePPTProvider } = await import("../features/ppt/utils.js");
+        // Get effective PPT provider (handles validation and auto-selection)
+        const effective = await getEffectivePPTProvider(this, this.providerName, this.modelName, this.neurolink);
+        // Build input from prompt or input.text (preserve images for logo)
+        const inputText = options.input?.text || options.prompt || "";
+        const generateOptions = {
+            input: {
+                text: inputText,
+                images: options.input?.images, // Pass through images for logo
+            },
+            output: options.output,
+            provider: effective.providerName,
+            model: options.model,
+        };
+        // Validate PPT generation input
+        const validation = validatePPTGenerationInput(generateOptions);
+        if (!validation.isValid) {
+            const errorMessages = validation.errors.map((e) => e.message).join("; ");
+            throw ErrorFactory.invalidParameters("ppt-generation", new Error(errorMessages), { errors: validation.errors });
+        }
+        // Log warnings
+        for (const warning of validation.warnings) {
+            logger.warn(`PPT generation warning: ${warning}`);
+        }
+        // Extract context with all PPT options (including images for logo)
+        const context = extractPPTContext({
+            input: {
+                text: inputText,
+                images: options.input?.images, // Pass through images for logo
+            },
+            output: generateOptions.output,
+            provider: effective.providerName,
+            model: effective.modelName,
+        });
+        logger.info("Starting PPT generation", {
+            provider: effective.providerName,
+            model: effective.modelName,
+            topic: context.topic.substring(0, 100),
+            pages: context.pages,
+            theme: context.theme,
+            generateAIImages: context.generateAIImages,
+        });
+        // Generate presentation using orchestrator (with timeout)
+        const pptResult = await withTimeout(generatePresentation({
+            context,
+            provider: effective.provider,
+            providerName: effective.providerName,
+            modelName: effective.modelName,
+            neurolink: this.neurolink,
+            imageProvider: effective.providerName,
+            imageModel: effective.modelName,
+        }), PPT_GENERATION_TIMEOUT_MS, ErrorFactory.toolTimeout("pptGeneration", PPT_GENERATION_TIMEOUT_MS));
+        logger.info("PPT generation complete", {
+            filePath: pptResult.filePath,
+            totalSlides: pptResult.totalSlides,
+            processingTime: Date.now() - startTime,
+        });
+        // Ensure we always have model name - fallback to this provider's modelName or default
+        const finalModelName = effective.modelName || this.modelName || this.getDefaultModel();
+        // Build result
+        return await this.enhanceResult({
+            content: context.topic,
+            provider: effective.providerName,
+            model: finalModelName,
+            usage: { input: 0, output: 0, total: 0 },
+            ppt: pptResult,
+        }, options, startTime);
+    }
     /**
      * Create analytics - delegated to TelemetryHandler
      */

package/dist/features/ppt/constants.d.ts

@@ -4,7 +4,7 @@
  * Contains theme definitions, layout configs, and AI prompt templates
  * for presentation generation.
  */
-import type { PresentationTheme, SlideType, SlideLayout } from "./types.js";
+import type { PromptTier, PPTModelInfo, BuildContentPlanningPromptOptions, BulletStyle, SlideFormattingConfig, PresentationTheme, SlideType, SlideLayout } from "./types.js";
 /**
  * Built-in theme registry
  * Each theme defines colors, fonts, and styling for the presentation
@@ -54,6 +54,10 @@ export declare function isDiagramSlideType(type: SlideType): boolean;
  * Check if a slide type benefits from AI image generation
  */
 export declare function isImageSlideType(type: SlideType): boolean;
+/**
+ * Theme-specific design guidelines for the AI
+ */
+export declare const THEME_GUIDELINES: Record<string, string>;
 /**
  * Audience-specific content guidelines for the AI
  */
@@ -62,14 +66,19 @@ export declare const AUDIENCE_GUIDELINES: Record<string, string>;
  * Tone-specific writing guidelines for the AI
  */
 export declare const TONE_GUIDELINES: Record<string, string>;
+/**
+ * Detect prompt tier based on model name
+ */
+export declare function getPromptTier(modelInfo: PPTModelInfo): PromptTier;
 /**
  * System prompt for content planning AI
  */
-export declare const CONTENT_PLANNING_SYSTEM_PROMPT = "You are an expert presentation designer and content strategist. Your task is to create a detailed, structured content plan for a presentation based on the given topic and requirements.\n\nYou must output ONLY valid JSON with no additional text, markdown formatting, or explanation.\n\nCRITICAL RULES:\n1. Each slide MUST have a clear, specific title (not generic like \"Slide 2\")\n2. Content bullets should be concise (max 10 words each)\n3. Maximum 5-6 bullets per slide for readability\n4. Image prompts should describe VISUAL scenes without any text in the image\n5. Speaker notes should provide detailed talking points for the presenter\n6. First slide is always type \"title\", last slide is always type \"thank-you\" or \"closing\"\n7. Include an \"agenda\" slide as slide 2 for presentations with 8+ slides\n8. Create visual variety: mix content, data, quote, and image slides\n9. For data slides, provide realistic sample data that matches the topic\n10. Use statistics slides for key metrics, chart slides for trends/comparisons\n11. Include at least one quote or highlight slide for impact\n12. Use section-header slides to break up long presentations (15+ slides)";
+export declare const CONTENT_PLANNING_SYSTEM_PROMPT = "You are an expert presentation designer and content strategist. Your task is to create a detailed, structured content plan for a presentation based on the given topic and requirements.\n\nYou must output ONLY valid JSON with no additional text, markdown formatting, or explanation.\n\nCRITICAL RULES:\n1. Each slide MUST have a clear, specific title (not generic like \"Slide 2\")\n2. Content bullets should be concise (max 10 words each)\n3. Maximum 5-6 bullets per slide for readability\n4. Image prompts should describe VISUAL scenes without any text in the image\n5. Speaker notes should provide detailed talking points for the presenter\n6. First slide is always type \"title\", last slide is always type \"closing\"\n7. Include an \"agenda\" slide as slide 2 for presentations with 8+ slides\n8. Create visual variety: mix content, data, quote, and image slides\n9. For data slides, provide realistic sample data that matches the topic\n10. Use statistics slides for key metrics, chart slides for trends/comparisons\n11. Include at least one quote slide for impact\n12. Use section-header slides to break up long presentations (15+ slides)\n13. Title and closing slides should be clean and simple";
 /**
  * Build the user prompt for content planning
+ * Modular design: each section is a separate constant for easy debugging/changes
  */
-export declare function buildContentPlanningPrompt(topic: string, pages: number, audience: string, tone: string, theme: string, includeImages: boolean): string;
+export declare function buildContentPlanningPrompt(options: BuildContentPlanningPromptOptions): string;
 /**
  * Enhance an image prompt for better AI image generation
  */
@@ -82,6 +91,26 @@ export declare const VALID_THEMES: string[];
 export declare const VALID_AUDIENCES: string[];
 export declare const VALID_TONES: string[];
 export declare const VALID_ASPECT_RATIOS: string[];
+/**
+ * Default formatting config per slide type
+ * AI can override these by specifying formatting in content
+ */
+export declare const SLIDE_TYPE_FORMATTING: Record<string, SlideFormattingConfig & {
+    bulletStyle: BulletStyle;
+}>;
+/**
+ * Get formatting config for a slide type
+ */
+export declare function getSlideTypeFormatting(slideType: string): SlideFormattingConfig & {
+    bulletStyle: BulletStyle;
+};
+/**
+ * Map BulletStyle to pptxgenjs bullet options
+ */
+export declare function getBulletOptions(style: BulletStyle): {
+    type?: "bullet" | "number";
+    code?: string;
+} | boolean;
 /** Timeout for content planning AI call (60 seconds) */
 export declare const CONTENT_PLANNING_TIMEOUT_MS = 60000;
 /** Timeout for image generation per slide (30 seconds) */