@juspay/neurolink 9.24.0 → 9.25.1

package/dist/lib/core/conversationMemoryInitializer.js

@@ -2,9 +2,9 @@
  * Conversation Memory Initializer
  * Provides integration with Redis storage for conversation memory
  */
-import { createConversationMemoryManager, getStorageType, getRedisConfigFromEnv, } from "./conversationMemoryFactory.js";
 import { applyConversationMemoryDefaults } from "../utils/conversationMemory.js";
 import { logger } from "../utils/logger.js";
+import { createConversationMemoryManager, getRedisConfigFromEnv, getStorageType, } from "./conversationMemoryFactory.js";
 /**
  * Initialize conversation memory for NeuroLink
  * This function decides whether to use in-memory or Redis storage
@@ -30,11 +30,14 @@ export async function initializeConversationMemory(config) {
             maxTurnsPerSession: memoryConfig.maxTurnsPerSession,
             enableSummarization: memoryConfig.enableSummarization,
         });
-        // Determine storage type from environment
-        const storageType = getStorageType();
+        // Determine storage type: if redisConfig is passed in the SDK config, use Redis
+        // regardless of STORAGE_TYPE env var. This lets consumers configure Redis via the API.
+        const hasRedisConfig = !!config.conversationMemory?.redisConfig;
+        const storageType = hasRedisConfig ? "redis" : getStorageType();
         logger.debug("[conversationMemoryInitializer] Storage type determined", {
             storageType,
-            fromEnv: !!process.env.STORAGE_TYPE,
+            fromConfig: hasRedisConfig,
+            fromEnv: !hasRedisConfig && !!process.env.STORAGE_TYPE,
         });
         if (storageType === "redis") {
             logger.info("[conversationMemoryInitializer] Initializing Redis-based conversation memory manager");

package/dist/lib/core/conversationMemoryManager.d.ts

@@ -71,4 +71,6 @@ export declare class ConversationMemoryManager implements IConversationMemoryMan
      * Resets summary pointers since old pointers may reference messages that no longer exist.
      */
     setSessionMessages(sessionId: string, messages: ChatMessage[], userId?: string): Promise<void>;
+    /** Close/shutdown — no-op for in-memory manager (no external connections to release) */
+    close(): Promise<void>;
 }

package/dist/lib/core/conversationMemoryManager.js

@@ -6,11 +6,11 @@ import { randomUUID } from "crypto";
 import { DEFAULT_MAX_SESSIONS, MEMORY_THRESHOLD_PERCENTAGE, MESSAGES_PER_TURN, } from "../config/conversationMemory.js";
 import { TokenUtils } from "../constants/tokens.js";
 import { SummarizationEngine } from "../context/summarizationEngine.js";
+import { runWithCurrentLangfuseContext } from "../services/server/ai/observability/instrumentation.js";
+import { tracers, withSpan } from "../telemetry/index.js";
 import { ConversationMemoryError } from "../types/conversation.js";
 import { buildContextFromPointer, getEffectiveTokenThreshold, } from "../utils/conversationMemory.js";
-import { runWithCurrentLangfuseContext } from "../services/server/ai/observability/instrumentation.js";
 import { logger } from "../utils/logger.js";
-import { tracers, withSpan } from "../telemetry/index.js";
 export class ConversationMemoryManager {
     sessions = new Map();
     config;
@@ -337,5 +337,9 @@ export class ConversationMemoryManager {
         session.lastCountedAt = undefined;
         session.lastActivity = Date.now();
     }
+    /** Close/shutdown — no-op for in-memory manager (no external connections to release) */
+    async close() {
+        // In-memory manager has nothing to close
+    }
 }
 //# sourceMappingURL=conversationMemoryManager.js.map

package/dist/lib/core/modules/GenerationHandler.d.ts

@@ -12,9 +12,9 @@
  *
  * @module core/modules/GenerationHandler
  */
-import type { LanguageModelV1, CoreMessage, Tool } from "ai";
+import type { CoreMessage, LanguageModelV1, Tool } from "ai";
 import { generateText } from "ai";
-import type { TextGenerationOptions, EnhancedGenerateResult, AIProviderName, StandardRecord } from "../../types/index.js";
+import type { AIProviderName, EnhancedGenerateResult, StandardRecord, TextGenerationOptions } from "../../types/index.js";
 /**
  * GenerationHandler class - Handles text generation operations for AI providers
  */

package/dist/lib/core/modules/GenerationHandler.js

@@ -12,13 +12,13 @@
  *
  * @module core/modules/GenerationHandler
  */
-import { generateText, Output, NoObjectGeneratedError } from "ai";
 import { SpanKind, SpanStatusCode } from "@opentelemetry/api";
+import { generateText, NoObjectGeneratedError, Output } from "ai";
 import { tracers } from "../../telemetry/tracers.js";
 import { logger } from "../../utils/logger.js";
-import { extractTokenUsage, extractCacheCreationTokens, extractCacheReadTokens, calculateCacheSavingsPercent, } from "../../utils/tokenUtils.js";
-import { withProviderRetry } from "../../utils/providerRetry.js";
 import { calculateCost } from "../../utils/pricing.js";
+import { withProviderRetry } from "../../utils/providerRetry.js";
+import { calculateCacheSavingsPercent, extractCacheCreationTokens, extractCacheReadTokens, extractTokenUsage, } from "../../utils/tokenUtils.js";
 import { DEFAULT_MAX_STEPS } from "../constants.js";
 const genTracer = tracers.generation;
 /**
@@ -67,8 +67,8 @@ export class GenerationHandler {
         // Gemini 2.5 and earlier cannot use tools + structured JSON output simultaneously.
         // When both are requested on a Google provider, disable structured output (tools take priority).
         const wantsStructuredOutput = includeStructuredOutput &&
-            !!options.schema &&
-            (options.output?.format === "json" ||
+            (!!options.schema ||
+                options.output?.format === "json" ||
                 options.output?.format === "structured");
         const useStructuredOutput = wantsStructuredOutput &&
             !(isGoogleProvider && shouldUseTools && Object.keys(tools).length > 0);
@@ -166,9 +166,9 @@ export class GenerationHandler {
         return genTracer.startActiveSpan("neurolink.executeGeneration", { kind: SpanKind.INTERNAL }, async (span) => {
             const shouldUseTools = !options.disableTools && this.supportsToolsFn();
             const toolCount = Object.keys(tools || {}).length;
-            const useStructuredOutput = !!options.schema &&
-                (options.output?.format === "json" ||
-                    options.output?.format === "structured");
+            const useStructuredOutput = !!options.schema ||
+                options.output?.format === "json" ||
+                options.output?.format === "structured";
             span.setAttribute("gen_ai.system", this.providerName || "unknown");
             span.setAttribute("neurolink.structured_output", useStructuredOutput);
             span.setAttribute("neurolink.tool_count", toolCount);
@@ -452,10 +452,10 @@ export class GenerationHandler {
      * Format the enhanced result
      */
     formatEnhancedResult(generateResult, tools, toolsUsed, toolExecutions, options) {
-        // Structured output check
-        const useStructuredOutput = !!options.schema &&
-            (options.output?.format === "json" ||
-                options.output?.format === "structured");
+        // Structured output check — schema alone is sufficient to activate
+        const useStructuredOutput = !!options.schema ||
+            options.output?.format === "json" ||
+            options.output?.format === "structured";
         let content;
         if (useStructuredOutput) {
             try {

package/dist/lib/evaluation/ragasEvaluator.js

@@ -1,6 +1,8 @@
 import { AIProviderFactory } from "../core/factory.js";
 import { PromptBuilder } from "./prompts.js";
 import { logger } from "../utils/logger.js";
+import { SpanSerializer, SpanType, SpanStatus, } from "../observability/index.js";
+import { getMetricsAggregator } from "../observability/index.js";
 /**
  * Implements a RAGAS-style evaluator that uses a "judge" LLM to score the
  * quality of an AI response based on rich, contextual information.
@@ -32,27 +34,45 @@ export class RAGASEvaluator {
      * @returns A promise that resolves to a detailed `EvaluationResult`.
      */
     async evaluate(context) {
-        const startTime = Date.now();
-        const prompt = this.promptBuilder.buildEvaluationPrompt(context, this.promptGenerator);
-        const provider = await AIProviderFactory.createProvider(this.providerName, this.evaluationModel);
-        const result = await provider.generate({
-            input: { text: prompt },
+        const span = SpanSerializer.createSpan(SpanType.EVALUATION, "evaluation.ragas", {
+            "evaluation.dimension": "relevance|accuracy|completeness",
+            "ai.provider": this.providerName,
+            "ai.model": this.evaluationModel,
         });
-        if (!result) {
-            throw new Error("Evaluation generation failed to return a result.");
+        const startTime = Date.now();
+        try {
+            const prompt = this.promptBuilder.buildEvaluationPrompt(context, this.promptGenerator);
+            const provider = await AIProviderFactory.createProvider(this.providerName, this.evaluationModel);
+            const result = await provider.generate({
+                input: { text: prompt },
+            });
+            if (!result) {
+                throw new Error("Evaluation generation failed to return a result.");
+            }
+            const rawEvaluationResponse = result.content;
+            const parsedResult = this.parseEvaluationResponse(rawEvaluationResponse);
+            const evaluationTime = Date.now() - startTime;
+            const finalResult = {
+                ...parsedResult,
+                isPassing: parsedResult.finalScore >= this.threshold, // This will be recalculated, but is needed for the type
+                evaluationModel: this.evaluationModel,
+                evaluationTime,
+                attemptNumber: context.attemptNumber,
+                rawEvaluationResponse,
+            };
+            span.durationMs = Date.now() - startTime;
+            const endedSpan = SpanSerializer.endSpan(span, SpanStatus.OK);
+            getMetricsAggregator().recordSpan(endedSpan);
+            return finalResult;
+        }
+        catch (error) {
+            span.durationMs = Date.now() - startTime;
+            const endedSpan = SpanSerializer.endSpan(span, SpanStatus.ERROR);
+            endedSpan.statusMessage =
+                error instanceof Error ? error.message : String(error);
+            getMetricsAggregator().recordSpan(endedSpan);
+            throw error;
         }
-        const rawEvaluationResponse = result.content;
-        const parsedResult = this.parseEvaluationResponse(rawEvaluationResponse);
-        const evaluationTime = Date.now() - startTime;
-        const finalResult = {
-            ...parsedResult,
-            isPassing: parsedResult.finalScore >= this.threshold, // This will be recalculated, but is needed for the type
-            evaluationModel: this.evaluationModel,
-            evaluationTime,
-            attemptNumber: context.attemptNumber,
-            rawEvaluationResponse,
-        };
-        return finalResult;
     }
     /**
      * Parses the raw JSON string from the judge LLM into a structured `EvaluationResult` object.

package/dist/lib/evaluation/scoring.js

@@ -1,6 +1,8 @@
 /**
  * @file Contains the logic for mapping raw evaluation results to the structured EvaluationData type.
  */
+import { SpanSerializer, SpanType, SpanStatus, } from "../observability/index.js";
+import { getMetricsAggregator } from "../observability/index.js";
 /**
  * Maps a raw `EvaluationResult` to the structured `EvaluationData` format.
  * This includes calculating derived fields like `isOffTopic` and `alertSeverity`.
@@ -12,25 +14,49 @@
  * @returns A structured `EvaluationData` object.
  */
 export function mapToEvaluationData(evalContext, result, threshold, offTopicThreshold = 5, highSeverityThreshold = 4) {
-    const isPassing = result.finalScore >= threshold;
-    return {
-        relevance: result.relevanceScore,
-        accuracy: result.accuracyScore,
-        completeness: result.completenessScore,
-        overall: result.finalScore,
-        isOffTopic: result.finalScore < offTopicThreshold,
-        alertSeverity: isPassing
-            ? "none"
-            : result.finalScore < highSeverityThreshold
-                ? "high"
-                : "medium",
-        reasoning: result.reasoning,
-        suggestedImprovements: result.suggestedImprovements,
-        evaluationModel: result.evaluationModel,
-        evaluationTime: result.evaluationTime,
-        evaluationAttempt: result.attemptNumber,
-        responseContent: evalContext.aiResponse,
-        queryContent: evalContext.userQuery,
-    };
+    const span = SpanSerializer.createSpan(SpanType.EVALUATION, "evaluation.score", {
+        "evaluation.dimension": "relevance|accuracy|completeness|overall",
+        scores: {
+            relevance: result.relevanceScore,
+            accuracy: result.accuracyScore,
+            completeness: result.completenessScore,
+            overall: result.finalScore,
+        },
+    });
+    const startTime = Date.now();
+    try {
+        const isPassing = result.finalScore >= threshold;
+        const evaluationData = {
+            relevance: result.relevanceScore,
+            accuracy: result.accuracyScore,
+            completeness: result.completenessScore,
+            overall: result.finalScore,
+            isOffTopic: result.finalScore < offTopicThreshold,
+            alertSeverity: isPassing
+                ? "none"
+                : result.finalScore < highSeverityThreshold
+                    ? "high"
+                    : "medium",
+            reasoning: result.reasoning,
+            suggestedImprovements: result.suggestedImprovements,
+            evaluationModel: result.evaluationModel,
+            evaluationTime: result.evaluationTime,
+            evaluationAttempt: result.attemptNumber,
+            responseContent: evalContext.aiResponse,
+            queryContent: evalContext.userQuery,
+        };
+        span.durationMs = Date.now() - startTime;
+        const endedSpan = SpanSerializer.endSpan(span, SpanStatus.OK);
+        getMetricsAggregator().recordSpan(endedSpan);
+        return evaluationData;
+    }
+    catch (error) {
+        span.durationMs = Date.now() - startTime;
+        const endedSpan = SpanSerializer.endSpan(span, SpanStatus.ERROR);
+        endedSpan.statusMessage =
+            error instanceof Error ? error.message : String(error);
+        getMetricsAggregator().recordSpan(endedSpan);
+        throw error;
+    }
 }
 //# sourceMappingURL=scoring.js.map

package/dist/lib/features/ppt/presentationOrchestrator.js

@@ -21,6 +21,8 @@ import { SlideGenerator } from "./slideGenerator.js";
 import { PPT_GENERATION_TIMEOUT_MS } from "./constants.js";
 import { logger } from "../../utils/logger.js";
 import { withTimeout, ErrorFactory } from "../../utils/errorHandling.js";
+import { SpanSerializer, SpanType, SpanStatus, } from "../../observability/index.js";
+import { getMetricsAggregator } from "../../observability/index.js";
 import { generateOutputPath, ensureOutputDirectory, normalizeLogoConfig, getLayoutName, getFailureStage, toError, } from "./utils.js";
 // ============================================================================
 // MAIN ORCHESTRATION FUNCTION
@@ -48,6 +50,13 @@ import { generateOutputPath, ensureOutputDirectory, normalizeLogoConfig, getLayo
  * ```
  */
 export async function generatePresentation(options) {
+    const span = SpanSerializer.createSpan(SpanType.PPT_GENERATION, "ppt.orchestrate", {
+        "ppt.operation": "orchestrate",
+        "ppt.slideCount": options.context.pages,
+        "ppt.theme": typeof options.context.theme === "string"
+            ? options.context.theme
+            : "custom",
+    });
     const state = {
         startTime: Date.now(),
         contentPlan: null,
@@ -73,6 +82,12 @@ export async function generatePresentation(options) {
         ErrorFactory.toolTimeout("contentPlanning", PPT_GENERATION_TIMEOUT_MS / 2));
         // Post-process: ensure title and thank-you slides
         state.contentPlan = postProcessPlan(planResult);
+        // Update span attributes with post-processed plan values (AI may have changed slide count/theme)
+        span.attributes["ppt.slideCount"] = state.contentPlan.totalSlides;
+        span.attributes["ppt.theme"] =
+            typeof state.contentPlan.theme === "string"
+                ? state.contentPlan.theme
+                : "custom";
         logger.info("[PresentationOrchestrator] Content plan ready", {
             title: state.contentPlan.title,
             totalSlides: state.contentPlan.totalSlides,
@@ -163,6 +178,9 @@ export async function generatePresentation(options) {
         // =========================================================================
         // STEP 5: Return Result
         // =========================================================================
+        const endedSpan = SpanSerializer.endSpan(span, SpanStatus.OK);
+        getMetricsAggregator().recordSpan(endedSpan);
+        neurolink?.recordMetricsSpan(endedSpan);
         // Use values from content plan (AI may have chosen them if "AI will decide" was passed)
         const finalTheme = state.contentPlan?.theme || context.theme;
         const finalAudience = state.contentPlan?.audience || context.audience;
@@ -185,6 +203,11 @@ export async function generatePresentation(options) {
         };
     }
     catch (error) {
+        const endedSpan = SpanSerializer.endSpan(span, SpanStatus.ERROR);
+        endedSpan.statusMessage =
+            error instanceof Error ? error.message : String(error);
+        getMetricsAggregator().recordSpan(endedSpan);
+        neurolink?.recordMetricsSpan(endedSpan);
         // Re-throw PPTError as-is
         if (error instanceof PPTError) {
             logger.error("[PresentationOrchestrator] Generation failed", {

package/dist/lib/features/ppt/slideGenerator.js

@@ -19,6 +19,8 @@ import { SLIDE_DIMENSIONS } from "./types.js";
 import { getTheme, isImageSlideType, enhanceImagePrompt, IMAGE_GENERATION_TIMEOUT_MS, MAX_CONCURRENT_IMAGE_GENERATIONS, } from "./constants.js";
 import { logger } from "../../utils/logger.js";
 import { withTimeout, ErrorFactory, NeuroLinkError, } from "../../utils/errorHandling.js";
+import { SpanSerializer, SpanType, SpanStatus, } from "../../observability/index.js";
+import { getMetricsAggregator } from "../../observability/index.js";
 import { NeuroLink } from "../../neurolink.js";
 import { LAYOUT_POSITIONS, renderTitleSlide, renderSectionHeaderSlide, renderThankYouSlide, renderContentSlide, renderImageSlide, renderTwoColumnSlide, renderThreeColumnSlide, renderQuoteSlide, renderStatisticsSlide, renderChartSlide, renderTableSlide, renderTimelineSlide, renderProcessFlowSlide, renderComparisonSlide, renderFeaturesSlide, renderTeamSlide, renderConclusionSlide, renderDashboardSlide, renderMixedContentSlide, renderStatsGridSlide, renderIconGridSlide, } from "./slideRenderers.js";
 // ============================================================================
@@ -86,6 +88,11 @@ export class SlideGenerator {
      * Generate a single complete slide
      */
     async generateSlide(slideSchema) {
+        const span = SpanSerializer.createSpan(SpanType.PPT_GENERATION, "ppt.generateSlide", {
+            "ppt.operation": "generateSlide",
+            "ppt.slideIndex": slideSchema.slideNumber,
+            "ppt.theme": this.theme.name,
+        });
         const startTime = Date.now();
         try {
             let imageBuffer;
@@ -126,6 +133,8 @@ export class SlideGenerator {
                 hasImage: !!imageBuffer,
                 generationTime,
             });
+            const endedSpan = SpanSerializer.endSpan(span, SpanStatus.OK);
+            getMetricsAggregator().recordSpan(endedSpan);
             return {
                 slideNumber: slideSchema.slideNumber,
                 schema: slideSchema,
@@ -135,6 +144,10 @@ export class SlideGenerator {
             };
         }
         catch (error) {
+            const endedSpan = SpanSerializer.endSpan(span, SpanStatus.ERROR);
+            endedSpan.statusMessage =
+                error instanceof Error ? error.message : String(error);
+            getMetricsAggregator().recordSpan(endedSpan);
             const err = error instanceof NeuroLinkError
                 ? error
                 : ErrorFactory.toolExecutionFailed("slideGenerator", error instanceof Error ? error : new Error(String(error)));

package/dist/lib/features/ppt/slideRenderers.d.ts

@@ -6,7 +6,7 @@
  *
  * @module presentation/slideRenderers
  */
-import type { SlideContent, SlideLayout, SlideType, PresentationTheme, BulletPoint, PptxChartName, PptxSlide, BackgroundStyle, RenderContentSlideOptions, ColumnData } from "./types.js";
+import type { BackgroundStyle, BulletPoint, ColumnData, PptxChartName, PptxSlide, PresentationTheme, RenderContentSlideOptions, SlideContent, SlideLayout, SlideType } from "./types.js";
 export declare const LAYOUT_POSITIONS: {
     margin: {
         x: number;

package/dist/lib/features/ppt/slideRenderers.js

@@ -6,9 +6,9 @@
  *
  * @module presentation/slideRenderers
  */
-import { getSlideTypeFormatting, getBulletOptions } from "./constants.js";
 import { logger } from "../../utils/logger.js";
-import { validateImageBuffer, bufferToDataUrl, parseMarkdownText, hasMarkdownFormatting, createFormattedTextProps, calculateFontSize, } from "./utils.js";
+import { getBulletOptions, getSlideTypeFormatting } from "./constants.js";
+import { bufferToDataUrl, calculateFontSize, createFormattedTextProps, hasMarkdownFormatting, parseMarkdownText, validateImageBuffer, } from "./utils.js";
 // ============================================================================
 // LAYOUT POSITIONS
 // ============================================================================
@@ -986,9 +986,11 @@ export function renderThankYouSlide(slide, title, content, theme, imageBuffer) {
                 fit: DEFAULT_TEXT_FIT,
             });
         }
-        if (content.contactInfo.social && content.contactInfo.social.length > 0) {
+        if (content.contactInfo.social &&
+            Array.isArray(content.contactInfo.social) &&
+            content.contactInfo.social.length > 0) {
             const socialText = content.contactInfo.social
-                .map((s) => `${s.platform}: ${s.handle}`)
+                .map((s) => `${s.platform || ""}: ${s.handle || ""}`)
                 .join("   •   ");
             slide.addText(socialText, {
                 x: 0.5,

package/dist/lib/features/ppt/slideTypeInference.d.ts

@@ -9,7 +9,7 @@
  * This helps ensure consistent slide rendering when AI doesn't explicitly
  * specify a slide type, or when we want to normalize AI responses.
  */
-import type { SlideType, BulletStyle, BulletPoint, SlideContent } from "./types.js";
+import type { BulletPoint, BulletStyle, SlideContent, SlideType } from "./types.js";
 /**
  * Infer slide type and bullet style from title text
  */

package/dist/lib/features/ppt/slideTypeInference.js

@@ -20,13 +20,13 @@ const TITLE_KEYWORD_PATTERNS = [
     // Agenda / Table of Contents - numbered list
     {
         patterns: [
-            /^agenda$/i,
-            /^table\s+of\s+contents$/i,
-            /^outline$/i,
-            /^overview$/i,
-            /^what\s+we('ll)?\s+cover$/i,
-            /^today('s)?\s+topics?$/i,
-            /^session\s+outline$/i,
+            /\bagenda\b/i,
+            /\btable\s+of\s+contents\b/i,
+            /\boutline\b/i,
+            /\boverview\b/i,
+            /\bwhat\s+we('ll)?\s+cover\b/i,
+            /\btoday('s)?\s+topics?\b/i,
+            /\bsession\s+outline\b/i,
         ],
         slideType: "agenda",
         bulletStyle: "number",
@@ -34,18 +34,18 @@ const TITLE_KEYWORD_PATTERNS = [
     // Conclusion / Summary - checkmark
     {
         patterns: [
-            /^conclusion$/i,
-            /^summary$/i,
-            /^key\s+takeaways?$/i,
-            /^takeaways?$/i,
-            /^recap$/i,
-            /^in\s+summary$/i,
-            /^what\s+we('ve)?\s+learned$/i,
-            /^main\s+points?$/i,
-            /^key\s+points?$/i,
-            /^highlights?$/i,
-            /^achievements?$/i,
-            /^accomplishments?$/i,
+            /\bconclusion\b/i,
+            /\bsummary\b/i,
+            /\bkey\s+takeaways?\b/i,
+            /\btakeaways?\b/i,
+            /\brecap\b/i,
+            /\bin\s+summary\b/i,
+            /\bwhat\s+we('ve)?\s+learned\b/i,
+            /\bmain\s+points?\b/i,
+            /\bkey\s+points?\b/i,
+            /\bhighlights?\b/i,
+            /\bachievements?\b/i,
+            /\baccomplishments?\b/i,
         ],
         slideType: "conclusion",
         bulletStyle: "checkmark",
@@ -53,15 +53,15 @@ const TITLE_KEYWORD_PATTERNS = [
     // Closing / Thank You - checkmark
     {
         patterns: [
-            /^thank\s+you$/i,
-            /^thanks?$/i,
-            /^questions?\??$/i,
-            /^q\s*&\s*a$/i,
-            /^contact(\s+us)?$/i,
-            /^next\s+steps?$/i,
-            /^action\s+items?$/i,
-            /^let('s)?\s+connect$/i,
-            /^get\s+(in\s+)?touch$/i,
+            /\bthank\s+you\b/i,
+            /\bthanks?\b/i,
+            /\bquestions?\b\??/i,
+            /\bq\s*&\s*a\b/i,
+            /\bcontact(\s+us)?\b/i,
+            /\bnext\s+steps?\b/i,
+            /\baction\s+items?\b/i,
+            /\blet('s)?\s+connect\b/i,
+            /\bget\s+(in\s+)?touch\b/i,
         ],
         slideType: "closing",
         bulletStyle: "checkmark",
@@ -69,14 +69,15 @@ const TITLE_KEYWORD_PATTERNS = [
     // Comparison - arrow bullets
     {
         patterns: [
-            /^comparison$/i,
-            /^vs\.?$/i,
-            /^versus$/i,
-            /^before\s+(and|&|vs\.?)\s+after$/i,
-            /^pros?\s+(and|&|vs\.?)\s+cons?$/i,
-            /^advantages?\s+(and|&|vs\.?)\s+disadvantages?$/i,
-            /^benefits?\s+(and|&|vs\.?)\s+risks?$/i,
-            /^old\s+vs\.?\s+new$/i,
+            /\bcomparison\b/i,
+            /\bcompare\b/i,
+            /\bvs\.?\b/i,
+            /\bversus\b/i,
+            /\bbefore\s+(and|&|vs\.?)\s+after\b/i,
+            /\bpros?\s+(and|&|vs\.?)\s+cons?\b/i,
+            /\badvantages?\s+(and|&|vs\.?)\s+disadvantages?\b/i,
+            /\bbenefits?\s+(and|&|vs\.?)\s+risks?\b/i,
+            /\bold\s+vs\.?\s+new\b/i,
         ],
         slideType: "comparison",
         bulletStyle: "arrow",
@@ -84,15 +85,16 @@ const TITLE_KEYWORD_PATTERNS = [
     // Process / Steps - numbered
     {
         patterns: [
-            /^process$/i,
-            /^steps?$/i,
-            /^how\s+to\b/i,
-            /^workflow$/i,
-            /^procedure$/i,
-            /^methodology$/i,
-            /^\d+\s+steps?\s+to\b/i,
-            /^implementation\s+steps?$/i,
-            /^getting\s+started$/i,
+            /\bprocess\b/i,
+            /\bsteps?\b/i,
+            /\bstep[\s-]+by[\s-]+step\b/i,
+            /\bhow\s+to\b/i,
+            /\bworkflow\b/i,
+            /\bprocedure\b/i,
+            /\bmethodology\b/i,
+            /\d+\s+steps?\s+to\b/i,
+            /\bimplementation\s+steps?\b/i,
+            /\bgetting\s+started\b/i,
         ],
         slideType: "numbered-list",
         bulletStyle: "number",
@@ -100,21 +102,21 @@ const TITLE_KEYWORD_PATTERNS = [
     // Features / Benefits - disc (but could be checkmark for benefits)
     {
         patterns: [
-            /^features?$/i,
-            /^capabilities?$/i,
-            /^what\s+(we|it)\s+offers?$/i,
-            /^our\s+offerings?$/i,
+            /\bfeatures?\b/i,
+            /\bcapabilities?\b/i,
+            /\bwhat\s+(we|it)\s+offers?\b/i,
+            /\bour\s+offerings?\b/i,
         ],
         slideType: "features",
         bulletStyle: "disc",
     },
     {
         patterns: [
-            /^benefits?$/i,
-            /^advantages?$/i,
-            /^why\s+choose\b/i,
-            /^reasons?\s+to\b/i,
-            /^value\s+proposition$/i,
+            /\bbenefits?\b/i,
+            /\badvantages?\b/i,
+            /\bwhy\s+choose\b/i,
+            /\breasons?\s+to\b/i,
+            /\bvalue\s+proposition\b/i,
         ],
         slideType: "content",
         bulletStyle: "checkmark",
@@ -122,12 +124,12 @@ const TITLE_KEYWORD_PATTERNS = [
     // Goals / Objectives - checkmark
     {
         patterns: [
-            /^goals?$/i,
-            /^objectives?$/i,
-            /^targets?$/i,
-            /^aims?$/i,
-            /^our\s+mission$/i,
-            /^what\s+we\s+aim\s+for$/i,
+            /\bgoals?\b/i,
+            /\bobjectives?\b/i,
+            /\btargets?\b/i,
+            /\baims?\b/i,
+            /\bour\s+mission\b/i,
+            /\bwhat\s+we\s+aim\s+for\b/i,
         ],
         slideType: "content",
         bulletStyle: "checkmark",
@@ -135,13 +137,13 @@ const TITLE_KEYWORD_PATTERNS = [
     // Challenges / Risks - arrow
     {
         patterns: [
-            /^challenges?$/i,
-            /^risks?$/i,
-            /^obstacles?$/i,
-            /^barriers?$/i,
-            /^concerns?$/i,
-            /^issues?$/i,
-            /^problems?$/i,
+            /\bchallenges?\b/i,
+            /\brisks?\b/i,
+            /\bobstacles?\b/i,
+            /\bbarriers?\b/i,
+            /\bconcerns?\b/i,
+            /\bissues?\b/i,
+            /\bproblems?\b/i,
         ],
         slideType: "content",
         bulletStyle: "arrow",
@@ -149,12 +151,12 @@ const TITLE_KEYWORD_PATTERNS = [
     // Requirements / Checklist - checkmark
     {
         patterns: [
-            /^requirements?$/i,
-            /^checklist$/i,
-            /^prerequisites?$/i,
-            /^what\s+you\s+need$/i,
-            /^must\s+haves?$/i,
-            /^essentials?$/i,
+            /\brequirements?\b/i,
+            /\bchecklist\b/i,
+            /\bprerequisites?\b/i,
+            /\bwhat\s+you\s+need\b/i,
+            /\bmust\s+haves?\b/i,
+            /\bessentials?\b/i,
         ],
         slideType: "content",
         bulletStyle: "checkmark",