@juspay/neurolink 8.38.0 → 8.40.0

package/CHANGELOG.md

@@ -1,3 +1,15 @@
+## [8.40.0](https://github.com/juspay/neurolink/compare/v8.39.0...v8.40.0) (2026-01-28)
+
+### Features
+
+- **(events):** Emit event when title generation is finished ([aab4a1f](https://github.com/juspay/neurolink/commit/aab4a1f9d336a9b1fa20a5b6196155ab1d8673ed))
+
+## [8.39.0](https://github.com/juspay/neurolink/compare/v8.38.0...v8.39.0) (2026-01-27)
+
+### Features
+
+- **(ppt):** Implement SlideGenerator() for PPT Gen ([c804e97](https://github.com/juspay/neurolink/commit/c804e97ceda8d90bfc5ee5b976b1a8b3864f86ef))
+
 ## [8.38.0](https://github.com/juspay/neurolink/compare/v8.37.0...v8.38.0) (2026-01-23)
 
 ### Features

package/README.md

@@ -37,10 +37,13 @@ Extracted from production systems at Juspay and battle-tested at enterprise scal
 
 | Feature                            | Version | Description                                                                                                                                    | Guide                                                        |
 | ---------------------------------- | ------- | ---------------------------------------------------------------------------------------------------------------------------------------------- | ------------------------------------------------------------ |
+| **Title Generation Events**        | v8.38.0 | Emit `conversation:titleGenerated` event when conversation title is generated. Supports custom title prompts via `NEUROLINK_TITLE_PROMPT`.     | [Conversation Memory Guide](docs/conversation-memory.md)     |
 | **Video Generation with Veo**      | v8.32.0 | Video generation using Veo 3.1 (`veo-3.1`). Realistic video generation with many parameter options                                             | [Video Generation Guide](docs/features/video-generation.md)  |
 | **Image Generation with Gemini**   | v8.31.0 | Native image generation using Gemini 2.0 Flash Experimental (`imagen-3.0-generate-002`). High-quality image synthesis directly from Google AI. | [Image Generation Guide](docs/image-generation-streaming.md) |
 | **HTTP/Streamable HTTP Transport** | v8.29.0 | Connect to remote MCP servers via HTTP with authentication headers, automatic retry with exponential backoff, and configurable rate limiting.  | [HTTP Transport Guide](docs/mcp-http-transport.md)           |
 
+- **Title Generation Events** – Emit real-time events when conversation titles are auto-generated. Listen to `conversation:titleGenerated` for session tracking. → [Conversation Memory Guide](docs/conversation-memory.md#title-generation-events)
+- **Custom Title Prompts** – Customize conversation title generation with `NEUROLINK_TITLE_PROMPT` environment variable. Use `${userMessage}` placeholder for dynamic prompts. → [Conversation Memory Guide](docs/conversation-memory.md#customizing-the-title-prompt)
 - **Video Generation** – Transform images into 8-second videos with synchronized audio using Google Veo 3.1 via Vertex AI. Supports 720p/1080p resolutions, portrait/landscape aspect ratios. → [Video Generation Guide](docs/features/video-generation.md)
 - **Image Generation** – Generate images from text prompts using Gemini models via Vertex AI or Google AI Studio. Supports streaming mode with automatic file saving. → [Image Generation Guide](docs/IMAGE-GENERATION-STREAMING.md)
 - **HTTP/Streamable HTTP Transport for MCP** – Connect to remote MCP servers via HTTP with authentication headers, retry logic, and rate limiting. → [HTTP Transport Guide](docs/MCP-HTTP-TRANSPORT.md)

package/dist/core/conversationMemoryFactory.d.ts

@@ -3,13 +3,13 @@
  * Creates appropriate conversation memory manager based on configuration
  */
 import type { ConversationMemoryConfig, RedisStorageConfig } from "../types/conversation.js";
-import type { StorageType } from "../types/common.js";
+import type { StorageType, TypedEventEmitter, NeuroLinkEvents } from "../types/common.js";
 import { ConversationMemoryManager } from "./conversationMemoryManager.js";
 import { RedisConversationMemoryManager } from "./redisConversationMemoryManager.js";
 /**
  * Creates a conversation memory manager based on configuration
  */
-export declare function createConversationMemoryManager(config: ConversationMemoryConfig, storageType?: StorageType, redisConfig?: RedisStorageConfig): ConversationMemoryManager | RedisConversationMemoryManager;
+export declare function createConversationMemoryManager(config: ConversationMemoryConfig, storageType?: StorageType, redisConfig?: RedisStorageConfig, eventEmitter?: TypedEventEmitter<NeuroLinkEvents>): ConversationMemoryManager | RedisConversationMemoryManager;
 /**
  * Get storage type from environment variable or configuration
  */

package/dist/core/conversationMemoryFactory.js

@@ -8,7 +8,7 @@ import { logger } from "../utils/logger.js";
 /**
  * Creates a conversation memory manager based on configuration
  */
-export function createConversationMemoryManager(config, storageType = "memory", redisConfig) {
+export function createConversationMemoryManager(config, storageType = "memory", redisConfig, eventEmitter) {
     logger.debug("[conversationMemoryFactory] Creating conversation memory manager", {
         storageType,
         config: {
@@ -38,7 +38,7 @@ export function createConversationMemoryManager(config, storageType = "memory",
             ttl: redisConfig?.ttl || 86400,
             hasConnectionOptions: !!redisConfig?.connectionOptions,
         });
-        const redisManager = new RedisConversationMemoryManager(config, redisConfig);
+        const redisManager = new RedisConversationMemoryManager(config, redisConfig, eventEmitter);
         logger.debug("[conversationMemoryFactory] Redis conversation manager created successfully", {
             managerType: redisManager.constructor.name,
             config: {

package/dist/core/conversationMemoryInitializer.d.ts

@@ -5,10 +5,11 @@
 import type { ConversationMemoryConfig } from "../types/conversation.js";
 import type { ConversationMemoryManager } from "./conversationMemoryManager.js";
 import type { RedisConversationMemoryManager } from "./redisConversationMemoryManager.js";
+import type { TypedEventEmitter, NeuroLinkEvents } from "../types/common.js";
 /**
  * Initialize conversation memory for NeuroLink
  * This function decides whether to use in-memory or Redis storage
  */
 export declare function initializeConversationMemory(config?: {
     conversationMemory?: Partial<ConversationMemoryConfig>;
-}): Promise<ConversationMemoryManager | RedisConversationMemoryManager | null>;
+}, eventEmitter?: TypedEventEmitter<NeuroLinkEvents>): Promise<ConversationMemoryManager | RedisConversationMemoryManager | null>;

package/dist/core/conversationMemoryInitializer.js

@@ -9,7 +9,7 @@ import { logger } from "../utils/logger.js";
  * Initialize conversation memory for NeuroLink
  * This function decides whether to use in-memory or Redis storage
  */
-export async function initializeConversationMemory(config) {
+export async function initializeConversationMemory(config, eventEmitter) {
     logger.debug("[conversationMemoryInitializer] Initialize conversation memory called", {
         hasConfig: !!config,
         hasMemoryConfig: !!config?.conversationMemory,
@@ -55,7 +55,7 @@ export async function initializeConversationMemory(config) {
             });
             // Create Redis-based conversation memory manager
             logger.debug("[conversationMemoryInitializer] Creating Redis conversation memory manager");
-            const redisMemoryManager = createConversationMemoryManager(memoryConfig, "redis", redisConfig);
+            const redisMemoryManager = createConversationMemoryManager(memoryConfig, "redis", redisConfig, eventEmitter);
             logger.debug("[conversationMemoryInitializer] Checking Redis manager creation result", {
                 managerType: redisMemoryManager?.constructor?.name || "unknown",
                 isRedisType: redisMemoryManager?.constructor?.name ===

package/dist/core/redisConversationMemoryManager.d.ts

@@ -3,6 +3,7 @@
  * Redis-based implementation of conversation storage with same interface as ConversationMemoryManager
  */
 import type { ConversationMemoryConfig, ConversationMemoryStats, ChatMessage, RedisStorageConfig, SessionMetadata, RedisConversationObject, StoreConversationTurnOptions } from "../types/conversation.js";
+import type { TypedEventEmitter, NeuroLinkEvents } from "../types/common.js";
 /**
  * Redis-based implementation of the ConversationMemoryManager
  * Uses the same interface but stores data in Redis
@@ -12,6 +13,10 @@ export declare class RedisConversationMemoryManager {
     private isInitialized;
     private redisConfig;
     private redisClient;
+    /**
+     * Event emitter for conversation memory events
+     */
+    private eventEmitter?;
     /**
      * Temporary storage for tool execution data to prevent race conditions
      * Key format: "${sessionId}:${userId}"
@@ -27,7 +32,7 @@ export declare class RedisConversationMemoryManager {
      * Key format: "${sessionId}:${userId}"
      */
     private summarizationInProgress;
-    constructor(config: ConversationMemoryConfig, redisConfig?: RedisStorageConfig);
+    constructor(config: ConversationMemoryConfig, redisConfig?: RedisStorageConfig, eventEmitter?: TypedEventEmitter<NeuroLinkEvents>);
     /**
      * Initialize the memory manager with Redis connection
      */

package/dist/core/redisConversationMemoryManager.js

@@ -19,6 +19,10 @@ export class RedisConversationMemoryManager {
     isInitialized = false;
     redisConfig;
     redisClient = null;
+    /**
+     * Event emitter for conversation memory events
+     */
+    eventEmitter;
     /**
      * Temporary storage for tool execution data to prevent race conditions
      * Key format: "${sessionId}:${userId}"
@@ -34,9 +38,10 @@ export class RedisConversationMemoryManager {
      * Key format: "${sessionId}:${userId}"
      */
     summarizationInProgress = new Set();
-    constructor(config, redisConfig = {}) {
+    constructor(config, redisConfig = {}, eventEmitter) {
         this.config = config;
         this.redisConfig = getNormalizedConfig(redisConfig);
+        this.eventEmitter = eventEmitter;
     }
     /**
      * Initialize the memory manager with Redis connection
@@ -253,6 +258,14 @@ export class RedisConversationMemoryManager {
                             if (this.redisConfig.ttl > 0) {
                                 await this.redisClient?.expire(updatedRedisKey, this.redisConfig.ttl);
                             }
+                            if (this.eventEmitter) {
+                                this.eventEmitter.emit("conversation:titleGenerated", {
+                                    sessionId: options.sessionId,
+                                    userId: normalizedUserId,
+                                    title,
+                                    timestamp: Date.now(),
+                                });
+                            }
                         }
                     }
                     catch (titleError) {
@@ -687,12 +700,11 @@ export class RedisConversationMemoryManager {
             const titleGenerator = new NeuroLink({
                 conversationMemory: { enabled: false },
             });
-            const titlePrompt = `Generate a clear, concise, and descriptive title (5–8 words maximum) for a conversation based on the following user message. 
-The title must meaningfully reflect the topic or intent of the message. 
-Do not output anything unrelated, vague, or generic. 
-Do not say you cannot create a title. Always return a valid title.
-
-User message: "${userMessage}`;
+            const fallbackTitlePrompt = `\nYou are an expert at generating ultra-concise conversation titles.\n\nGenerate a single clear, descriptive title that accurately reflects the core topic of the user's message.\n\nStrict rules:\n- The title MUST be 18 characters or fewer (including spaces).\n- Output ONLY the title text (no quotes, no punctuation, no explanations).\n- Use natural words; abbreviations are allowed only if they improve clarity.\n- Avoid generic words like "issue", "problem", "help", or "discussion".\n- Do not say you cannot generate a title.\n- Always return exactly one valid title within the character limit.\n\nUser message:\n"${userMessage}"\n`;
+            const envPrompt = process.env.NEUROLINK_TITLE_PROMPT;
+            const titlePrompt = envPrompt
+                ? envPrompt.replace(/\$\{userMessage\}/g, userMessage)
+                : fallbackTitlePrompt;
             const result = await titleGenerator.generate({
                 input: { text: titlePrompt },
                 provider: this.config.summarizationProvider || "vertex",

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

@@ -14,3 +14,4 @@ export type { SlideType, SlideLayout, BulletPoint, SlideContent, SlideSchema, Co
 export { PPTError, PPT_ERROR_CODES, extractPPTContext, MIN_SLIDES, MAX_SLIDES, SLIDE_DIMENSIONS, isValidHexColor, normalizeHexColor, } from "./types.js";
 export { THEMES, getTheme, SLIDE_TYPE_TO_LAYOUT, SLIDE_TYPE_CATEGORIES, getLayoutForType, DIAGRAM_SLIDE_TYPES, IMAGE_SLIDE_TYPES, isDiagramSlideType, isImageSlideType, AUDIENCE_GUIDELINES, TONE_GUIDELINES, CONTENT_PLANNING_SYSTEM_PROMPT, buildContentPlanningPrompt, enhanceImagePrompt, MIN_PAGES, MAX_PAGES, MIN_TOPIC_LENGTH, MAX_TOPIC_LENGTH, VALID_THEMES, VALID_AUDIENCES, VALID_TONES, VALID_ASPECT_RATIOS, CONTENT_PLANNING_TIMEOUT_MS, IMAGE_GENERATION_TIMEOUT_MS, MAX_CONCURRENT_IMAGE_GENERATIONS, PPT_GENERATION_TIMEOUT_MS, } from "./constants.js";
 export { generateContentPlan, ensureTitleSlide, ensureThankYouSlide, postProcessPlan, } from "./contentPlanner.js";
+export { SlideGenerator, createSlideGenerator, generateSlidesFromPlan, PptxGenJS, type SlideGeneratorConfig, type SlideGenerationBatchResult, type LogoConfig, type LogoPosition, } from "./slideGenerator.js";

package/dist/features/ppt/index.js

@@ -23,3 +23,5 @@ MIN_PAGES, MAX_PAGES, MIN_TOPIC_LENGTH, MAX_TOPIC_LENGTH, VALID_THEMES, VALID_AU
 CONTENT_PLANNING_TIMEOUT_MS, IMAGE_GENERATION_TIMEOUT_MS, MAX_CONCURRENT_IMAGE_GENERATIONS, PPT_GENERATION_TIMEOUT_MS, } from "./constants.js";
 // Content Planner
 export { generateContentPlan, ensureTitleSlide, ensureThankYouSlide, postProcessPlan, } from "./contentPlanner.js";
+// Slide Generator
+export { SlideGenerator, createSlideGenerator, generateSlidesFromPlan, PptxGenJS, } from "./slideGenerator.js";

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

@@ -0,0 +1,96 @@
+/**
+ * PPT Slide Generator
+ *
+ * Generates individual complete slides with content, images, and layout.
+ * Uses existing NeuroLink image generation capabilities and pptxgenjs for slide creation.
+ *
+ * Architecture:
+ * - Receives SlideSchema from ContentPlanner
+ * - Generates AI images for applicable slide types
+ * - Creates pptxgenjs slides with proper layouts
+ * - Returns CompleteSlide objects ready for assembly
+ *
+ * @module presentation/slideGenerator
+ */
+import PptxGenJS from "pptxgenjs";
+import type { SlideSchema, CompleteSlide, PresentationTheme, AspectRatioOption, PptxSlide, PptxPresentation } from "./types.js";
+import { NeuroLink } from "../../neurolink.js";
+/**
+ * Logo position options for slides
+ */
+export type LogoPosition = "top-left" | "top-right" | "bottom-left" | "bottom-right" | "title-only";
+/**
+ * Logo configuration options
+ */
+export type LogoConfig = {
+    /** Logo data - Buffer, base64 string, data URI, or file path */
+    data: Buffer | string;
+    /** Position on slides (default: "bottom-right") */
+    position?: LogoPosition;
+    /** Width in inches (default: 1) */
+    width?: number;
+    /** Height in inches (default: 0.4) */
+    height?: number;
+    /** Show on all slides or specific types (default: "all-slides") */
+    showOn?: "all-slides" | "title-only" | "title-and-closing";
+};
+/**
+ * Configuration for slide generation
+ */
+export type SlideGeneratorConfig = {
+    /** Theme name or custom theme */
+    theme: string | PresentationTheme;
+    /** Whether to generate AI images */
+    includeImages: boolean;
+    /** Aspect ratio for slides */
+    aspectRatio: AspectRatioOption;
+    /** Provider for image generation */
+    provider?: string;
+    /** Model for image generation */
+    imageModel?: string;
+    /** Logo configuration */
+    logo?: Buffer | string | LogoConfig;
+    /** NeuroLink instance for image generation */
+    neurolink?: NeuroLink;
+};
+/**
+ * Result from generating a batch of slides
+ */
+export type SlideGenerationBatchResult = {
+    slides: CompleteSlide[];
+    totalImages: number;
+    failedImages: number;
+    generationTime: number;
+};
+/**
+ * Generates individual slides with content, images, and proper layouts
+ */
+export declare class SlideGenerator {
+    private theme;
+    private config;
+    private neurolink;
+    private imageLimit;
+    constructor(config: SlideGeneratorConfig);
+    /**
+     * Generate a single complete slide
+     */
+    generateSlide(slideSchema: SlideSchema): Promise<CompleteSlide>;
+    /**
+     * Generate multiple slides in parallel (with concurrency limit)
+     */
+    generateSlides(schemas: SlideSchema[]): Promise<SlideGenerationBatchResult>;
+    /**
+     * Render a CompleteSlide to a pptxgenjs slide
+     */
+    renderSlide(ppt: PptxPresentation, completeSlide: CompleteSlide, slideNumber: number, totalSlides: number): PptxSlide;
+    private generateImage;
+    private applyBackground;
+    private applyLayout;
+    private getLogoConfig;
+    private getLogoDataUri;
+    private addLogo;
+    private addSlideNumber;
+}
+export { PptxGenJS };
+export declare function createSlideGenerator(config: SlideGeneratorConfig): SlideGenerator;
+export declare function generateSlidesFromPlan(schemas: SlideSchema[], config: SlideGeneratorConfig): Promise<SlideGenerationBatchResult>;