@llm-newsletter-kit/core 2.0.5 → 2.1.0

package/README.md

@@ -149,6 +149,88 @@ const newsletterId = await generator.generate();
 
 👉 **See the reference implementation: https://github.com/heripo-lab/heripo-research-radar**
 
+## Customizing LLM Prompts (PromptProvider)
+
+The kit ships with built-in prompts designed to cover a wide range of domains. However, these general-purpose prompts may not be flexible enough for specialized requirements. For example:
+
+- Your domain uses unique terminology or jargon that the default prompts don't account for
+- You need a specific newsletter tone or structure (e.g., academic style, casual briefing)
+- Tag classification requires domain-specific taxonomy rules
+- Importance scoring needs custom criteria tailored to your industry
+
+`PromptProvider` lets you **replace** any built-in prompt — system prompt, user prompt, or both — on a per-stage basis while keeping the rest of the pipeline intact.
+
+### How It Works
+
+PromptProvider is organized by pipeline stage. Every field is optional — omitted prompts fall back to the built-in defaults.
+
+```
+PromptProvider
+├── analysis
+│   ├── classifyTags        — Tag classification (system / user)
+│   ├── analyzeImages       — Image analysis (system / user)
+│   └── determineImportance — Importance scoring (system / user)
+└── contentGenerate
+    └── generateNewsletter  — Final newsletter generation (system / user)
+```
+
+Each prompt slot is a `PromptBuilder<TContext>` — an object with optional `system` and `user` functions. The function receives a typed context object containing all the data the default prompt would use (articles, tags, expert fields, dates, etc.), so you have full control over prompt construction.
+
+> **Dependency note:** Analysis prompts (classifyTags → analyzeImages → determineImportance) produce data that flows into the content generation prompt. Changing an analysis prompt may indirectly affect the final newsletter output.
+
+### Example
+
+```ts
+import type {
+  GenerateNewsletterConfig,
+  PromptProvider,
+} from '@llm-newsletter-kit/core';
+
+const promptProvider: PromptProvider = {
+  analysis: {
+    // Override only the system prompt for tag classification
+    classifyTags: {
+      system: (ctx) =>
+        `You are a legal-domain specialist. Classify articles using ` +
+        `legal taxonomy standards. Available tags: ${ctx.existTags.join(', ')}. ` +
+        `Output language: ${ctx.outputLanguage}.`,
+      // user prompt falls back to the built-in default
+    },
+    // Override importance scoring with domain-specific criteria
+    determineImportance: {
+      system: (ctx) =>
+        `Score article importance for ${ctx.expertFields.join(', ')} professionals. ` +
+        `Regulatory changes and court rulings score 8+. ` +
+        `Commentary and opinion pieces score 3-5.`,
+      user: (ctx) =>
+        `Article: ${ctx.targetArticle.title}\n` +
+        `Content: ${ctx.targetArticle.detailContent}\n` +
+        `Score this article 1-10.`,
+    },
+  },
+  contentGenerate: {
+    // Override the newsletter generation prompt entirely
+    generateNewsletter: {
+      system: (ctx) =>
+        `You produce a weekly legal digest for "${ctx.newsletterBrandName}". ` +
+        `Write in ${ctx.outputLanguage}. Use formal academic tone.`,
+      user: (ctx) =>
+        `Publication date: ${ctx.dateService.getPublicationDisplayDateString()}\n\n` +
+        ctx.targetArticles
+          .map((a) => `- [${a.title}](${a.url}) (score: ${a.importanceScore})`)
+          .join('\n'),
+    },
+  },
+};
+
+const config: GenerateNewsletterConfig<string> = {
+  // ... other config (contentOptions, dateService, taskService, providers, etc.)
+  promptProvider, // Inject custom prompts
+};
+```
+
+For full context types (`ClassifyTagsPromptContext`, `GenerateNewsletterPromptContext`, etc.), see `src/generate-newsletter/models/prompt-provider.ts`.
+
 ## Public API Overview
 
 Entry point: `src/index.ts`
@@ -163,6 +245,7 @@ Entry point: `src/index.ts`
   - AnalysisProvider { classifyTagOptions.model, analyzeImagesOptions.model, determineScoreOptions(model, minimumImportanceScoreRules), fetchUnscoredArticles, fetchTags, update }
   - ContentGenerateProvider { model and generation options, issueOrder, publicationCriteria, subscribePageUrl, newsletterBrandName, fetchArticleCandidates, htmlTemplate, saveNewsletter }
   - GenerateNewsletterOptions { logger, llm, chain, previewNewsletter(emailService/emailMessage/fetchNewsletterForPreview) }
+  - PromptProvider { analysis?(classifyTags, analyzeImages, determineImportance), contentGenerate?(generateNewsletter) }
   - Domain models: DateService, EmailService, Newsletter, etc.
 
 For detailed field descriptions, see `src/generate-newsletter/models/interfaces.ts` and type definitions under `src/models/*`.

package/dist/index.cjs

@@ -193,8 +193,10 @@ class AnalyzeImages extends LLMQuery {
             .string()
             .describe('A high-level overview of the general theme, mood, and context conveyed by the images (without specific names, titles, or exact figures from text within images)'),
     });
+    promptBuilder;
     constructor(config) {
         super(config);
+        this.promptBuilder = config.promptBuilder;
     }
     async execute() {
         if (!this.targetArticle.hasAttachedImage ||
@@ -218,7 +220,17 @@ class AnalyzeImages extends LLMQuery {
         });
         return { result: output.imageContext, usage };
     }
+    get promptContext() {
+        return {
+            expertFields: this.expertFields,
+            outputLanguage: this.options.content.outputLanguage,
+            targetArticle: this.targetArticle,
+        };
+    }
     get systemPrompt() {
+        if (this.promptBuilder?.system) {
+            return this.promptBuilder.system(this.promptContext);
+        }
         return `# Image Analysis Expert System
 
 ## Identity & Expertise
@@ -289,6 +301,12 @@ You are a specialized image analysis expert in: ${this.expertFields.join(', ')}
         }));
     }
     get textMessage() {
+        if (this.promptBuilder?.user) {
+            return {
+                type: 'text',
+                text: this.promptBuilder.user(this.promptContext),
+            };
+        }
         return {
             type: 'text',
             text: `## Analysis Task
@@ -326,9 +344,11 @@ class ClassifyTags extends LLMQuery {
         tag2: zod.z.string(),
         tag3: zod.z.string(),
     });
+    promptBuilder;
     existTags = [];
     constructor(config) {
         super(config);
+        this.promptBuilder = config.promptBuilder;
     }
     async execute({ existTags }) {
         this.existTags = existTags;
@@ -341,7 +361,18 @@ class ClassifyTags extends LLMQuery {
         });
         return { result: output, usage };
     }
+    get promptContext() {
+        return {
+            expertFields: this.expertFields,
+            outputLanguage: this.options.content.outputLanguage,
+            targetArticle: this.targetArticle,
+            existTags: this.existTags,
+        };
+    }
     get systemPrompt() {
+        if (this.promptBuilder?.system) {
+            return this.promptBuilder.system(this.promptContext);
+        }
         return `You are an AI specializing in analyzing and categorizing articles for professionals in ${this.expertFields.join(', ')}.
 
 ## Core Responsibility
@@ -355,7 +386,7 @@ All classifications must be written in ${this.options.content.outputLanguage}.
 2. **New Tag Criteria**: Create new classifications only when:
    - Best existing match scores below 80% compatibility
    - New tag demonstrates versatility across 10+ similar articles
-3. **Naming Standards**: 
+3. **Naming Standards**:
    - Length: 3-15 characters
    - Style: Clear, intuitive ${this.options.content.outputLanguage} terms
    - Balance industry precision with general reader comprehension
@@ -369,6 +400,9 @@ Prioritize in order:
 - Long-term scalability and maintainability`;
     }
     get userPrompt() {
+        if (this.promptBuilder?.user) {
+            return this.promptBuilder.user(this.promptContext);
+        }
         return `**Task**: Classify this article with 3 optimal detailed tags.
 
 **Article Information**
@@ -406,10 +440,12 @@ class DetermineArticleImportance extends LLMQuery {
             .describe('Article importance score (1-10, 10 is most important)'),
     });
     dateService;
+    promptBuilder;
     constructor(config) {
         super(config);
         this.minimumImportanceScoreRules = config.minimumImportanceScoreRules ?? [];
         this.dateService = config.dateService;
+        this.promptBuilder = config.promptBuilder;
     }
     async execute() {
         const { output, usage } = await generateObjectByLLM({
@@ -428,7 +464,18 @@ class DetermineArticleImportance extends LLMQuery {
     get hasHigherMinimumScore() {
         return this.minPoint > 1;
     }
+    get promptContext() {
+        return {
+            expertFields: this.expertFields,
+            targetArticle: this.targetArticle,
+            dateService: this.dateService,
+            minimumImportanceScoreRules: this.minimumImportanceScoreRules,
+        };
+    }
     get systemPrompt() {
+        if (this.promptBuilder?.system) {
+            return this.promptBuilder.system(this.promptContext);
+        }
         return `You are an expert in importance evaluation in the field of ${this.expertFields.join(', ')}.
 
 Role:
@@ -465,6 +512,9 @@ Important Notes:
 - Be sensitive to core keywords, events, policies considered important in the field.`;
     }
     get userPrompt() {
+        if (this.promptBuilder?.user) {
+            return this.promptBuilder.user(this.promptContext);
+        }
         return `Please rate the importance of this article from ${this.minPoint} to 10.
 
 **Newsletter Publication Date:** ${this.dateService.getPublicationISODateString()}${this.targetArticle.publishedDate
@@ -509,9 +559,11 @@ class PrivateChain extends BaseChain {
 
 class ArticleInsightsChain extends PrivateChain {
     dateService;
+    promptProvider;
     constructor(config) {
         super(config);
         this.dateService = config.dateService;
+        this.promptProvider = config.promptProvider;
     }
     /* istanbul ignore next - pipeline arrow functions are exercised via higher-level tests */
     get chain() {
@@ -607,7 +659,10 @@ class ArticleInsightsChain extends PrivateChain {
                     },
                 });
                 try {
-                    const classifyTags = new ClassifyTags(this.getLlmQueryConfig(this.provider.classifyTagOptions.model, article));
+                    const classifyTags = new ClassifyTags({
+                        ...this.getLlmQueryConfig(this.provider.classifyTagOptions.model, article),
+                        promptBuilder: this.promptProvider?.classifyTags,
+                    });
                     const { result: generatedTags } = await classifyTags.execute({
                         existTags,
                     });
@@ -682,7 +737,10 @@ class ArticleInsightsChain extends PrivateChain {
                     },
                 });
                 try {
-                    const analyzeImages = new AnalyzeImages(this.getLlmQueryConfig(this.provider.analyzeImagesOptions.model, article));
+                    const analyzeImages = new AnalyzeImages({
+                        ...this.getLlmQueryConfig(this.provider.analyzeImagesOptions.model, article),
+                        promptBuilder: this.promptProvider?.analyzeImages,
+                    });
                     const { result: imageContextByLlm } = await analyzeImages.execute();
                     if (imageContextByLlm) {
                         articlesWithImageContext.push({
@@ -781,6 +839,7 @@ class ArticleInsightsChain extends PrivateChain {
                         ...this.getLlmQueryConfig(this.provider.determineScoreOptions.model, article),
                         minimumImportanceScoreRules: this.provider.determineScoreOptions.minimumImportanceScoreRules,
                         dateService: this.dateService,
+                        promptBuilder: this.promptProvider?.determineImportance,
                     });
                     const { result: importanceScore } = await determineArticleImportance.execute();
                     const processedArticle = {
@@ -845,9 +904,11 @@ class ArticleInsightsChain extends PrivateChain {
 
 class AnalysisChain extends Chain {
     dateService;
+    promptProvider;
     constructor(config) {
         super(config);
         this.dateService = config.dateService;
+        this.promptProvider = config.promptProvider;
     }
     get chain() {
         return runnables.RunnablePassthrough.assign({
@@ -903,6 +964,7 @@ class AnalysisChain extends Chain {
                 options: this.options,
                 loggingExecutor: new LoggingExecutor(this.logger, this.taskId),
                 dateService: this.dateService,
+                promptProvider: this.promptProvider,
             });
             return await articleInsightsChain.generateInsights();
         });
@@ -936,6 +998,7 @@ let GenerateNewsletter$1 = class GenerateNewsletter extends BaseLLMQuery {
     dateService;
     subscribePageUrl;
     newsletterBrandName;
+    promptBuilder;
     schema = zod.z.object({
         title: zod.z.string().max(70).min(20).describe('Title of the newsletter email'),
         content: zod.z.string().describe('Email content in markdown format'),
@@ -961,6 +1024,7 @@ let GenerateNewsletter$1 = class GenerateNewsletter extends BaseLLMQuery {
         this.dateService = config.dateService;
         this.subscribePageUrl = config.subscribePageUrl;
         this.newsletterBrandName = config.newsletterBrandName;
+        this.promptBuilder = config.promptBuilder;
     }
     async execute() {
         const { output, usage, finishReason } = await generateObjectByLLM({
@@ -995,7 +1059,22 @@ let GenerateNewsletter$1 = class GenerateNewsletter extends BaseLLMQuery {
         }
         return { result: esToolkit.pick(output, ['title', 'content']), usage };
     }
+    get promptContext() {
+        return {
+            expertFields: this.expertFields,
+            outputLanguage: this.options.content.outputLanguage,
+            dateService: this.dateService,
+            targetArticles: this.targetArticles,
+            freeFormIntro: this.options.content.freeFormIntro,
+            titleContext: this.options.content.titleContext,
+            subscribePageUrl: this.subscribePageUrl,
+            newsletterBrandName: this.newsletterBrandName,
+        };
+    }
     get systemPrompt() {
+        if (this.promptBuilder?.system) {
+            return this.promptBuilder.system(this.promptContext);
+        }
         return `You are a newsletter production expert for "${this.newsletterBrandName}" who analyzes and delivers trends in the fields of ${this.expertFields.join(', ')}. Your goal is to provide in-depth analysis that helps industry professionals easily understand complex information and make informed decisions.
 
 Important rule for displaying date ranges: When displaying date ranges, you must use a hyphen (-) instead of a tilde (~). For example, use 'June 1-2, 2025' instead of 'June 1~2, 2025'. The tilde (~) can be rendered as strikethrough in markdown.
@@ -1127,6 +1206,9 @@ Output Format & Requirements:
    ${this.subscribePageUrl ? `-   Add \`${this.subscribePageUrl}\`(Subscribe to ${this.newsletterBrandName}) page access link button at appropriate attention-worthy spot for natural recommendation to others.` : ''}`;
     }
     get userPrompt() {
+        if (this.promptBuilder?.user) {
+            return this.promptBuilder.user(this.promptContext);
+        }
         return `Below is the complete list of newly collected ${this.expertFields.join(', ')} related news:
 
 ${this.targetArticles
@@ -1203,9 +1285,11 @@ class ContentGenerateChain extends Chain {
     minimumArticleCountForIssue;
     priorityArticleScoreThreshold;
     htmlTemplate;
+    promptProvider;
     constructor(config) {
         super(config);
         this.dateService = config.dateService;
+        this.promptProvider = config.promptProvider;
         this.minimumArticleCountForIssue =
             config.provider.publicationCriteria?.minimumArticleCountForIssue ?? 5;
         this.priorityArticleScoreThreshold =
@@ -1288,6 +1372,7 @@ class ContentGenerateChain extends Chain {
                 subscribePageUrl: this.provider.subscribePageUrl,
                 newsletterBrandName: this.provider.newsletterBrandName,
                 dateService: this.dateService,
+                promptBuilder: this.promptProvider?.generateNewsletter,
             });
             const { result } = await generateNewsletter.execute();
             return result;
@@ -1777,6 +1862,7 @@ class GenerateNewsletter {
     contentGenerateProvider;
     logger;
     options;
+    promptProvider;
     previewNewsletterOptions;
     /** Independent internal field **/
     taskId = null;
@@ -1820,6 +1906,7 @@ class GenerateNewsletter {
                 ...config.options?.chain,
             },
         };
+        this.promptProvider = config.promptProvider;
         // Default logger (no-op)
         this.logger = config.options?.logger ?? {
             info: (_msg) => { },
@@ -1849,6 +1936,7 @@ class GenerateNewsletter {
                 options: this.options,
                 loggingExecutor,
                 dateService: this.dateService,
+                promptProvider: this.promptProvider?.analysis,
             });
             const contentGenerateChain = new ContentGenerateChain({
                 logger: this.logger,
@@ -1857,6 +1945,7 @@ class GenerateNewsletter {
                 options: this.options,
                 loggingExecutor,
                 dateService: this.dateService,
+                promptProvider: this.promptProvider?.contentGenerate,
             });
             const taskChain = runnables.RunnableSequence.from([
                 crawlingChain.chain,

package/dist/index.cjs.map

@@ -1 +1 @@
-{"version":3,"file":"index.cjs","sources":[],"sourcesContent":[],"names":[],"mappings":";;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;"}
+{"version":3,"file":"index.cjs","sources":[],"sourcesContent":[],"names":[],"mappings":";;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;"}

package/dist/index.d.ts

@@ -289,44 +289,6 @@ type ChainOptions = {
     stopAfterAttempt?: number;
 };
 
-/**
- * Token markers in template.
- */
-type HtmlTemplateMarkers = {
-    /**
-     * Title token
-     *
-     * When the title is set to "NEWSLETTER_TITLE", it replaces the "{{NEWSLETTER_TITLE}}" pattern in the template string.
-     *
-     * @default "NEWSLETTER_TITLE"
-     */
-    title?: string;
-    /**
-     * Content HTML token
-     *
-     * When content is set to "NEWSLETTER_CONTENT", it replaces the "{{NEWSLETTER_CONTENT}}" pattern in the template string.
-     *
-     * @default "NEWSLETTER_CONTENT"
-     */
-    content?: string;
-};
-/**
- * String template and marker set
- */
-type HtmlTemplate = {
-    /**
-     * Original template string
-     */
-    html: string;
-    /**
-     * Uses default markers when not specified
-     */
-    markers?: HtmlTemplateMarkers;
-};
-type RequiredHtmlTemplate = Pick<HtmlTemplate, 'html'> & {
-    markers: Required<HtmlTemplateMarkers>;
-};
-
 /**
  * Type representing an email address.
  * @example "user@example.com"
@@ -488,6 +450,108 @@ interface DateService {
     getPublicationDisplayDateString: () => string;
 }
 
+/**
+ * A pair of optional prompt builder functions.
+ * The returned string **replaces** the built-in default prompt entirely.
+ * If omitted, the default prompt is used.
+ */
+type PromptBuilder<TContext> = {
+    system?: (context: TContext) => string;
+    user?: (context: TContext) => string;
+};
+type ClassifyTagsPromptContext = {
+    expertFields: string[];
+    outputLanguage: string;
+    targetArticle: UnscoredArticle;
+    existTags: string[];
+};
+type AnalyzeImagesPromptContext = {
+    expertFields: string[];
+    outputLanguage: string;
+    targetArticle: UnscoredArticle;
+};
+type DetermineImportancePromptContext = {
+    expertFields: string[];
+    targetArticle: UnscoredArticle;
+    dateService: DateService;
+    minimumImportanceScoreRules: MinimumImportanceScoreRule[];
+};
+type GenerateNewsletterPromptContext = {
+    expertFields: string[];
+    outputLanguage: string;
+    dateService: DateService;
+    targetArticles: ArticleForGenerateContent[];
+    freeFormIntro?: boolean;
+    titleContext?: string;
+    subscribePageUrl?: UrlString;
+    newsletterBrandName: string;
+};
+/**
+ * Optional provider for customizing LLM prompts.
+ * Grouped by pipeline stage. All fields are optional —
+ * omitted prompts fall back to built-in defaults.
+ *
+ * **Dependency note:** Analysis prompts (❶❷❸) produce data that flows
+ * into the content generation prompt (❹). Changing an analysis prompt
+ * may indirectly affect the final newsletter output.
+ */
+interface PromptProvider {
+    /**
+     * Analysis stage prompts (❶ classifyTags → ❷ analyzeImages → ❸ determineImportance).
+     * Results feed into the content generation stage.
+     */
+    analysis?: {
+        classifyTags?: PromptBuilder<ClassifyTagsPromptContext>;
+        analyzeImages?: PromptBuilder<AnalyzeImagesPromptContext>;
+        determineImportance?: PromptBuilder<DetermineImportancePromptContext>;
+    };
+    /**
+     * Content generation stage prompt (❹ generateNewsletter).
+     * Produces the final newsletter title and body.
+     */
+    contentGenerate?: {
+        generateNewsletter?: PromptBuilder<GenerateNewsletterPromptContext>;
+    };
+}
+
+/**
+ * Token markers in template.
+ */
+type HtmlTemplateMarkers = {
+    /**
+     * Title token
+     *
+     * When the title is set to "NEWSLETTER_TITLE", it replaces the "{{NEWSLETTER_TITLE}}" pattern in the template string.
+     *
+     * @default "NEWSLETTER_TITLE"
+     */
+    title?: string;
+    /**
+     * Content HTML token
+     *
+     * When content is set to "NEWSLETTER_CONTENT", it replaces the "{{NEWSLETTER_CONTENT}}" pattern in the template string.
+     *
+     * @default "NEWSLETTER_CONTENT"
+     */
+    content?: string;
+};
+/**
+ * String template and marker set
+ */
+type HtmlTemplate = {
+    /**
+     * Original template string
+     */
+    html: string;
+    /**
+     * Uses default markers when not specified
+     */
+    markers?: HtmlTemplateMarkers;
+};
+type RequiredHtmlTemplate = Pick<HtmlTemplate, 'html'> & {
+    markers: Required<HtmlTemplateMarkers>;
+};
+
 /**
  * Publishable final Newsletter entity.
  */
@@ -807,6 +871,11 @@ type GenerateNewsletterConfig<TaskId> = {
      * Optional behavior/settings.
      */
     options?: GenerateNewsletterOptions;
+    /**
+     * Optional provider for customizing LLM prompts.
+     * When omitted, built-in default prompts are used.
+     */
+    promptProvider?: PromptProvider;
 };
 
 /**
@@ -822,6 +891,7 @@ declare class GenerateNewsletter<TaskId> {
     private readonly contentGenerateProvider;
     private readonly logger;
     private readonly options;
+    private readonly promptProvider?;
     private readonly previewNewsletterOptions?;
     /** Independent internal field **/
     private taskId;
@@ -858,4 +928,4 @@ declare class GenerateNewsletter<TaskId> {
 }
 
 export { DateType, GenerateNewsletter };
-export type { AnalysisProvider, AppLogger, ArticleForGenerateContent, ArticleForUpdateByAnalysis, ContentGenerateProvider, CrawlingProvider, CrawlingTarget, CrawlingTargetGroup, DateService, EmailAddress, EmailAttachment, EmailMessage, EmailService, GenerateNewsletterConfig, GenerateNewsletterOptions, HtmlString, HtmlTemplate, HtmlTemplateMarkers, IsoDateString, LogLevel, LogMessage, MarkdownString, MinimumImportanceScoreRule, Newsletter, ParsedTarget, ParsedTargetDetail, ParsedTargetListItem, RequiredHtmlTemplate, TaskService, UniqueIdentifier, UnscoredArticle, UrlString };
+export type { AnalysisProvider, AnalyzeImagesPromptContext, AppLogger, ArticleForGenerateContent, ArticleForUpdateByAnalysis, ClassifyTagsPromptContext, ContentGenerateProvider, CrawlingProvider, CrawlingTarget, CrawlingTargetGroup, DateService, DetermineImportancePromptContext, EmailAddress, EmailAttachment, EmailMessage, EmailService, GenerateNewsletterConfig, GenerateNewsletterOptions, GenerateNewsletterPromptContext, HtmlString, HtmlTemplate, HtmlTemplateMarkers, IsoDateString, LogLevel, LogMessage, MarkdownString, MinimumImportanceScoreRule, Newsletter, ParsedTarget, ParsedTargetDetail, ParsedTargetListItem, PromptBuilder, PromptProvider, RequiredHtmlTemplate, TaskService, UniqueIdentifier, UnscoredArticle, UrlString };

package/dist/index.js

@@ -191,8 +191,10 @@ class AnalyzeImages extends LLMQuery {
             .string()
             .describe('A high-level overview of the general theme, mood, and context conveyed by the images (without specific names, titles, or exact figures from text within images)'),
     });
+    promptBuilder;
     constructor(config) {
         super(config);
+        this.promptBuilder = config.promptBuilder;
     }
     async execute() {
         if (!this.targetArticle.hasAttachedImage ||
@@ -216,7 +218,17 @@ class AnalyzeImages extends LLMQuery {
         });
         return { result: output.imageContext, usage };
     }
+    get promptContext() {
+        return {
+            expertFields: this.expertFields,
+            outputLanguage: this.options.content.outputLanguage,
+            targetArticle: this.targetArticle,
+        };
+    }
     get systemPrompt() {
+        if (this.promptBuilder?.system) {
+            return this.promptBuilder.system(this.promptContext);
+        }
         return `# Image Analysis Expert System
 
 ## Identity & Expertise
@@ -287,6 +299,12 @@ You are a specialized image analysis expert in: ${this.expertFields.join(', ')}
         }));
     }
     get textMessage() {
+        if (this.promptBuilder?.user) {
+            return {
+                type: 'text',
+                text: this.promptBuilder.user(this.promptContext),
+            };
+        }
         return {
             type: 'text',
             text: `## Analysis Task
@@ -324,9 +342,11 @@ class ClassifyTags extends LLMQuery {
         tag2: z.string(),
         tag3: z.string(),
     });
+    promptBuilder;
     existTags = [];
     constructor(config) {
         super(config);
+        this.promptBuilder = config.promptBuilder;
     }
     async execute({ existTags }) {
         this.existTags = existTags;
@@ -339,7 +359,18 @@ class ClassifyTags extends LLMQuery {
         });
         return { result: output, usage };
     }
+    get promptContext() {
+        return {
+            expertFields: this.expertFields,
+            outputLanguage: this.options.content.outputLanguage,
+            targetArticle: this.targetArticle,
+            existTags: this.existTags,
+        };
+    }
     get systemPrompt() {
+        if (this.promptBuilder?.system) {
+            return this.promptBuilder.system(this.promptContext);
+        }
         return `You are an AI specializing in analyzing and categorizing articles for professionals in ${this.expertFields.join(', ')}.
 
 ## Core Responsibility
@@ -353,7 +384,7 @@ All classifications must be written in ${this.options.content.outputLanguage}.
 2. **New Tag Criteria**: Create new classifications only when:
    - Best existing match scores below 80% compatibility
    - New tag demonstrates versatility across 10+ similar articles
-3. **Naming Standards**: 
+3. **Naming Standards**:
    - Length: 3-15 characters
    - Style: Clear, intuitive ${this.options.content.outputLanguage} terms
    - Balance industry precision with general reader comprehension
@@ -367,6 +398,9 @@ Prioritize in order:
 - Long-term scalability and maintainability`;
     }
     get userPrompt() {
+        if (this.promptBuilder?.user) {
+            return this.promptBuilder.user(this.promptContext);
+        }
         return `**Task**: Classify this article with 3 optimal detailed tags.
 
 **Article Information**
@@ -404,10 +438,12 @@ class DetermineArticleImportance extends LLMQuery {
             .describe('Article importance score (1-10, 10 is most important)'),
     });
     dateService;
+    promptBuilder;
     constructor(config) {
         super(config);
         this.minimumImportanceScoreRules = config.minimumImportanceScoreRules ?? [];
         this.dateService = config.dateService;
+        this.promptBuilder = config.promptBuilder;
     }
     async execute() {
         const { output, usage } = await generateObjectByLLM({
@@ -426,7 +462,18 @@ class DetermineArticleImportance extends LLMQuery {
     get hasHigherMinimumScore() {
         return this.minPoint > 1;
     }
+    get promptContext() {
+        return {
+            expertFields: this.expertFields,
+            targetArticle: this.targetArticle,
+            dateService: this.dateService,
+            minimumImportanceScoreRules: this.minimumImportanceScoreRules,
+        };
+    }
     get systemPrompt() {
+        if (this.promptBuilder?.system) {
+            return this.promptBuilder.system(this.promptContext);
+        }
         return `You are an expert in importance evaluation in the field of ${this.expertFields.join(', ')}.
 
 Role:
@@ -463,6 +510,9 @@ Important Notes:
 - Be sensitive to core keywords, events, policies considered important in the field.`;
     }
     get userPrompt() {
+        if (this.promptBuilder?.user) {
+            return this.promptBuilder.user(this.promptContext);
+        }
         return `Please rate the importance of this article from ${this.minPoint} to 10.
 
 **Newsletter Publication Date:** ${this.dateService.getPublicationISODateString()}${this.targetArticle.publishedDate
@@ -507,9 +557,11 @@ class PrivateChain extends BaseChain {
 
 class ArticleInsightsChain extends PrivateChain {
     dateService;
+    promptProvider;
     constructor(config) {
         super(config);
         this.dateService = config.dateService;
+        this.promptProvider = config.promptProvider;
     }
     /* istanbul ignore next - pipeline arrow functions are exercised via higher-level tests */
     get chain() {
@@ -605,7 +657,10 @@ class ArticleInsightsChain extends PrivateChain {
                     },
                 });
                 try {
-                    const classifyTags = new ClassifyTags(this.getLlmQueryConfig(this.provider.classifyTagOptions.model, article));
+                    const classifyTags = new ClassifyTags({
+                        ...this.getLlmQueryConfig(this.provider.classifyTagOptions.model, article),
+                        promptBuilder: this.promptProvider?.classifyTags,
+                    });
                     const { result: generatedTags } = await classifyTags.execute({
                         existTags,
                     });
@@ -680,7 +735,10 @@ class ArticleInsightsChain extends PrivateChain {
                     },
                 });
                 try {
-                    const analyzeImages = new AnalyzeImages(this.getLlmQueryConfig(this.provider.analyzeImagesOptions.model, article));
+                    const analyzeImages = new AnalyzeImages({
+                        ...this.getLlmQueryConfig(this.provider.analyzeImagesOptions.model, article),
+                        promptBuilder: this.promptProvider?.analyzeImages,
+                    });
                     const { result: imageContextByLlm } = await analyzeImages.execute();
                     if (imageContextByLlm) {
                         articlesWithImageContext.push({
@@ -779,6 +837,7 @@ class ArticleInsightsChain extends PrivateChain {
                         ...this.getLlmQueryConfig(this.provider.determineScoreOptions.model, article),
                         minimumImportanceScoreRules: this.provider.determineScoreOptions.minimumImportanceScoreRules,
                         dateService: this.dateService,
+                        promptBuilder: this.promptProvider?.determineImportance,
                     });
                     const { result: importanceScore } = await determineArticleImportance.execute();
                     const processedArticle = {
@@ -843,9 +902,11 @@ class ArticleInsightsChain extends PrivateChain {
 
 class AnalysisChain extends Chain {
     dateService;
+    promptProvider;
     constructor(config) {
         super(config);
         this.dateService = config.dateService;
+        this.promptProvider = config.promptProvider;
     }
     get chain() {
         return RunnablePassthrough.assign({
@@ -901,6 +962,7 @@ class AnalysisChain extends Chain {
                 options: this.options,
                 loggingExecutor: new LoggingExecutor(this.logger, this.taskId),
                 dateService: this.dateService,
+                promptProvider: this.promptProvider,
             });
             return await articleInsightsChain.generateInsights();
         });
@@ -934,6 +996,7 @@ let GenerateNewsletter$1 = class GenerateNewsletter extends BaseLLMQuery {
     dateService;
     subscribePageUrl;
     newsletterBrandName;
+    promptBuilder;
     schema = z.object({
         title: z.string().max(70).min(20).describe('Title of the newsletter email'),
         content: z.string().describe('Email content in markdown format'),
@@ -959,6 +1022,7 @@ let GenerateNewsletter$1 = class GenerateNewsletter extends BaseLLMQuery {
         this.dateService = config.dateService;
         this.subscribePageUrl = config.subscribePageUrl;
         this.newsletterBrandName = config.newsletterBrandName;
+        this.promptBuilder = config.promptBuilder;
     }
     async execute() {
         const { output, usage, finishReason } = await generateObjectByLLM({
@@ -993,7 +1057,22 @@ let GenerateNewsletter$1 = class GenerateNewsletter extends BaseLLMQuery {
         }
         return { result: pick(output, ['title', 'content']), usage };
     }
+    get promptContext() {
+        return {
+            expertFields: this.expertFields,
+            outputLanguage: this.options.content.outputLanguage,
+            dateService: this.dateService,
+            targetArticles: this.targetArticles,
+            freeFormIntro: this.options.content.freeFormIntro,
+            titleContext: this.options.content.titleContext,
+            subscribePageUrl: this.subscribePageUrl,
+            newsletterBrandName: this.newsletterBrandName,
+        };
+    }
     get systemPrompt() {
+        if (this.promptBuilder?.system) {
+            return this.promptBuilder.system(this.promptContext);
+        }
         return `You are a newsletter production expert for "${this.newsletterBrandName}" who analyzes and delivers trends in the fields of ${this.expertFields.join(', ')}. Your goal is to provide in-depth analysis that helps industry professionals easily understand complex information and make informed decisions.
 
 Important rule for displaying date ranges: When displaying date ranges, you must use a hyphen (-) instead of a tilde (~). For example, use 'June 1-2, 2025' instead of 'June 1~2, 2025'. The tilde (~) can be rendered as strikethrough in markdown.
@@ -1125,6 +1204,9 @@ Output Format & Requirements:
    ${this.subscribePageUrl ? `-   Add \`${this.subscribePageUrl}\`(Subscribe to ${this.newsletterBrandName}) page access link button at appropriate attention-worthy spot for natural recommendation to others.` : ''}`;
     }
     get userPrompt() {
+        if (this.promptBuilder?.user) {
+            return this.promptBuilder.user(this.promptContext);
+        }
         return `Below is the complete list of newly collected ${this.expertFields.join(', ')} related news:
 
 ${this.targetArticles
@@ -1201,9 +1283,11 @@ class ContentGenerateChain extends Chain {
     minimumArticleCountForIssue;
     priorityArticleScoreThreshold;
     htmlTemplate;
+    promptProvider;
     constructor(config) {
         super(config);
         this.dateService = config.dateService;
+        this.promptProvider = config.promptProvider;
         this.minimumArticleCountForIssue =
             config.provider.publicationCriteria?.minimumArticleCountForIssue ?? 5;
         this.priorityArticleScoreThreshold =
@@ -1286,6 +1370,7 @@ class ContentGenerateChain extends Chain {
                 subscribePageUrl: this.provider.subscribePageUrl,
                 newsletterBrandName: this.provider.newsletterBrandName,
                 dateService: this.dateService,
+                promptBuilder: this.promptProvider?.generateNewsletter,
             });
             const { result } = await generateNewsletter.execute();
             return result;
@@ -1775,6 +1860,7 @@ class GenerateNewsletter {
     contentGenerateProvider;
     logger;
     options;
+    promptProvider;
     previewNewsletterOptions;
     /** Independent internal field **/
     taskId = null;
@@ -1818,6 +1904,7 @@ class GenerateNewsletter {
                 ...config.options?.chain,
             },
         };
+        this.promptProvider = config.promptProvider;
         // Default logger (no-op)
         this.logger = config.options?.logger ?? {
             info: (_msg) => { },
@@ -1847,6 +1934,7 @@ class GenerateNewsletter {
                 options: this.options,
                 loggingExecutor,
                 dateService: this.dateService,
+                promptProvider: this.promptProvider?.analysis,
             });
             const contentGenerateChain = new ContentGenerateChain({
                 logger: this.logger,
@@ -1855,6 +1943,7 @@ class GenerateNewsletter {
                 options: this.options,
                 loggingExecutor,
                 dateService: this.dateService,
+                promptProvider: this.promptProvider?.contentGenerate,
             });
             const taskChain = RunnableSequence.from([
                 crawlingChain.chain,

package/dist/index.js.map

@@ -1 +1 @@
-{"version":3,"file":"index.js","sources":[],"sourcesContent":[],"names":[],"mappings":";;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;"}
+{"version":3,"file":"index.js","sources":[],"sourcesContent":[],"names":[],"mappings":";;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;"}

package/package.json

@@ -2,7 +2,7 @@
   "name": "@llm-newsletter-kit/core",
   "private": false,
   "type": "module",
-  "version": "2.0.5",
+  "version": "2.1.0",
   "description": "An extensible framework to automate your entire newsletter workflow. Handles data collection, LLM-based content analysis, and email generation, letting you focus on your unique domain logic.",
   "main": "dist/index.cjs",
   "module": "dist/index.js",
@@ -49,36 +49,36 @@
   "author": "kimhongyeon",
   "license": "Apache-2.0",
   "dependencies": {
-    "@langchain/core": "^1.1.48",
-    "ai": "^6.0.197",
-    "es-toolkit": "^1.47.0",
+    "@langchain/core": "^1.2.0",
+    "ai": "^6.0.208",
+    "es-toolkit": "^1.47.1",
     "jsdom": "^29.1.1",
-    "juice": "^12.1.0",
-    "safe-markdown2html": "^1.0.6",
+    "juice": "^12.1.1",
+    "safe-markdown2html": "^1.0.8",
     "zod": "^4.4.3"
   },
   "devDependencies": {
-    "@ai-sdk/anthropic": "^3.0.81",
-    "@ai-sdk/google": "^3.0.80",
-    "@ai-sdk/openai": "^3.0.68",
-    "@ai-sdk/togetherai": "^2.0.53",
+    "@ai-sdk/anthropic": "^3.0.85",
+    "@ai-sdk/google": "^3.0.83",
+    "@ai-sdk/openai": "^3.0.73",
+    "@ai-sdk/togetherai": "^2.0.56",
     "@eslint/js": "^10.0.1",
     "@trivago/prettier-plugin-sort-imports": "^6.0.2",
     "@types/jsdom": "^28.0.3",
-    "@types/node": "^25.9.2",
-    "@vitest/coverage-v8": "^4.1.8",
-    "@vitest/expect": "^4.1.8",
-    "eslint": "^10.4.1",
+    "@types/node": "^26.0.0",
+    "@vitest/coverage-v8": "^4.1.9",
+    "@vitest/expect": "^4.1.9",
+    "eslint": "^10.5.0",
     "eslint-plugin-unused-imports": "^4.4.1",
-    "prettier": "^3.8.3",
+    "prettier": "^3.8.4",
     "rimraf": "^6.1.3",
-    "rollup": "^4.61.1",
+    "rollup": "^4.62.2",
     "rollup-plugin-dts": "^6.4.1",
     "rollup-plugin-typescript2": "^0.37.0",
     "tsx": "^4.22.4",
     "typescript": "^6.0.3",
-    "typescript-eslint": "^8.60.1",
-    "vitest": "^4.1.8"
+    "typescript-eslint": "^8.61.1",
+    "vitest": "^4.1.9"
   },
   "repository": {
     "type": "git",