@astro-minimax/ai 0.7.0 → 0.7.2

package/dist/data/index.d.ts

@@ -1,3 +1,4 @@
 export { preloadMetadata, clearMetadataCache, getMetadata, getArticleSummary, getAllSummaries, getAuthorContext, getVoiceProfile, } from './metadata-loader.js';
 export type { AISummariesFile, AuthorContextFile, VoiceProfile, LoadedMetadata, ArticleSummaryData, AuthorPost, } from './types.js';
+export type { FactRegistryFile } from '../fact-registry/types.js';
 //# sourceMappingURL=index.d.ts.map

package/dist/data/index.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/data/index.ts"],"names":[],"mappings":"AAAA,OAAO,EACL,eAAe,EACf,kBAAkB,EAClB,WAAW,EACX,iBAAiB,EACjB,eAAe,EACf,gBAAgB,EAChB,eAAe,GAChB,MAAM,sBAAsB,CAAC;AAC9B,YAAY,EACV,eAAe,EACf,iBAAiB,EACjB,YAAY,EACZ,cAAc,EACd,kBAAkB,EAClB,UAAU,GACX,MAAM,YAAY,CAAC"}
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/data/index.ts"],"names":[],"mappings":"AAAA,OAAO,EACL,eAAe,EACf,kBAAkB,EAClB,WAAW,EACX,iBAAiB,EACjB,eAAe,EACf,gBAAgB,EAChB,eAAe,GAChB,MAAM,sBAAsB,CAAC;AAC9B,YAAY,EACV,eAAe,EACf,iBAAiB,EACjB,YAAY,EACZ,cAAc,EACd,kBAAkB,EAClB,UAAU,GACX,MAAM,YAAY,CAAC;AACpB,YAAY,EAAE,gBAAgB,EAAE,MAAM,2BAA2B,CAAC"}

package/dist/data/metadata-loader.d.ts

@@ -5,11 +5,11 @@ import type { AuthorContextFile, VoiceProfile, LoadedMetadata, ArticleSummaryDat
  *
  * Example (in functions/lib/ai.ts):
  *   import summaries from '../../datas/ai-summaries.json' with { type: 'json' };
- *   preloadMetadata({ summaries, authorContext, voiceProfile });
+ *   preloadMetadata({ summaries, authorContext, voiceProfile, factRegistry });
  */
 export declare function preloadMetadata(data: Partial<LoadedMetadata>): void;
 /**
- * Clears the metadata cache (useful for testing).
+ * Clears the metadata cache and all associated sub-caches (useful for testing).
  */
 export declare function clearMetadataCache(): void;
 /**

package/dist/data/metadata-loader.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"metadata-loader.d.ts","sourceRoot":"","sources":["../../src/data/metadata-loader.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAmB,iBAAiB,EAAE,YAAY,EAAE,cAAc,EAAE,kBAAkB,EAAE,MAAM,YAAY,CAAC;AAKvH;;;;;;;GAOG;AACH,wBAAgB,eAAe,CAAC,IAAI,EAAE,OAAO,CAAC,cAAc,CAAC,GAAG,IAAI,CAMnE;AAED;;GAEG;AACH,wBAAgB,kBAAkB,IAAI,IAAI,CAEzC;AAED;;GAEG;AACH,wBAAgB,WAAW,IAAI,cAAc,CAE5C;AAED;;GAEG;AACH,wBAAgB,iBAAiB,CAAC,IAAI,EAAE,MAAM,GAAG,kBAAkB,GAAG,SAAS,CAE9E;AAED;;GAEG;AACH,wBAAgB,eAAe,IAAI,KAAK,CAAC;IAAE,IAAI,EAAE,MAAM,CAAA;CAAE,GAAG,kBAAkB,CAAC,CAG9E;AAED;;GAEG;AACH,wBAAgB,gBAAgB,IAAI,iBAAiB,GAAG,IAAI,CAE3D;AAED;;GAEG;AACH,wBAAgB,eAAe,IAAI,YAAY,GAAG,IAAI,CAErD"}
+{"version":3,"file":"metadata-loader.d.ts","sourceRoot":"","sources":["../../src/data/metadata-loader.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAmB,iBAAiB,EAAE,YAAY,EAAE,cAAc,EAAE,kBAAkB,EAAE,MAAM,YAAY,CAAC;AAQvH;;;;;;;GAOG;AACH,wBAAgB,eAAe,CAAC,IAAI,EAAE,OAAO,CAAC,cAAc,CAAC,GAAG,IAAI,CAgBnE;AAED;;GAEG;AACH,wBAAgB,kBAAkB,IAAI,IAAI,CAIzC;AAED;;GAEG;AACH,wBAAgB,WAAW,IAAI,cAAc,CAE5C;AAED;;GAEG;AACH,wBAAgB,iBAAiB,CAAC,IAAI,EAAE,MAAM,GAAG,kBAAkB,GAAG,SAAS,CAE9E;AAED;;GAEG;AACH,wBAAgB,eAAe,IAAI,KAAK,CAAC;IAAE,IAAI,EAAE,MAAM,CAAA;CAAE,GAAG,kBAAkB,CAAC,CAG9E;AAED;;GAEG;AACH,wBAAgB,gBAAgB,IAAI,iBAAiB,GAAG,IAAI,CAE3D;AAED;;GAEG;AACH,wBAAgB,eAAe,IAAI,YAAY,GAAG,IAAI,CAErD"}

package/dist/data/metadata-loader.js

@@ -1,3 +1,5 @@
+import { loadFactRegistry as loadFactRegistryCache } from '../fact-registry/registry.js';
+import { loadVectorIndex as loadVectorIndexCache } from '../search/vector-reranker.js';
 // Lazy-loaded, memory-cached metadata
 let cachedMetadata = null;
 /**
@@ -6,26 +8,36 @@ let cachedMetadata = null;
  *
  * Example (in functions/lib/ai.ts):
  *   import summaries from '../../datas/ai-summaries.json' with { type: 'json' };
- *   preloadMetadata({ summaries, authorContext, voiceProfile });
+ *   preloadMetadata({ summaries, authorContext, voiceProfile, factRegistry });
  */
 export function preloadMetadata(data) {
     cachedMetadata = {
         summaries: data.summaries ?? null,
         authorContext: data.authorContext ?? null,
         voiceProfile: data.voiceProfile ?? null,
+        factRegistry: data.factRegistry ?? null,
+        vectorIndex: data.vectorIndex ?? null,
     };
+    if (cachedMetadata.factRegistry) {
+        loadFactRegistryCache(cachedMetadata.factRegistry);
+    }
+    if (cachedMetadata.vectorIndex) {
+        loadVectorIndexCache(cachedMetadata.vectorIndex);
+    }
 }
 /**
- * Clears the metadata cache (useful for testing).
+ * Clears the metadata cache and all associated sub-caches (useful for testing).
  */
 export function clearMetadataCache() {
     cachedMetadata = null;
+    loadFactRegistryCache(null);
+    loadVectorIndexCache(null);
 }
 /**
  * Returns the cached metadata. Must call preloadMetadata() first.
  */
 export function getMetadata() {
-    return cachedMetadata ?? { summaries: null, authorContext: null, voiceProfile: null };
+    return cachedMetadata ?? { summaries: null, authorContext: null, voiceProfile: null, factRegistry: null, vectorIndex: null };
 }
 /**
  * Returns the AI-generated summary for an article by its slug.

package/dist/data/types.d.ts

@@ -47,5 +47,7 @@ export interface LoadedMetadata {
     summaries: AISummariesFile | null;
     authorContext: AuthorContextFile | null;
     voiceProfile: VoiceProfile | null;
+    factRegistry: import('../fact-registry/types.js').FactRegistryFile | null;
+    vectorIndex: import('../search/vector-reranker.js').VectorIndex | null;
 }
 //# sourceMappingURL=types.d.ts.map

package/dist/data/types.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"types.d.ts","sourceRoot":"","sources":["../../src/data/types.ts"],"names":[],"mappings":"AAAA,MAAM,WAAW,kBAAkB;IACjC,OAAO,EAAE,MAAM,CAAC;IAChB,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB,SAAS,EAAE,MAAM,EAAE,CAAC;IACpB,IAAI,EAAE,MAAM,EAAE,CAAC;IACf,WAAW,CAAC,EAAE,MAAM,CAAC;CACtB;AAED,MAAM,WAAW,mBAAmB;IAClC,IAAI,EAAE,kBAAkB,CAAC;IACzB,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,WAAW,CAAC,EAAE,MAAM,CAAC;CACtB;AAED,MAAM,WAAW,eAAe;IAC9B,IAAI,EAAE;QACJ,WAAW,EAAE,MAAM,CAAC;QACpB,KAAK,EAAE,MAAM,CAAC;QACd,cAAc,EAAE,MAAM,CAAC;KACxB,CAAC;IACF,QAAQ,EAAE,MAAM,CAAC,MAAM,EAAE,mBAAmB,CAAC,CAAC;CAC/C;AAED,MAAM,WAAW,UAAU;IACzB,EAAE,EAAE,MAAM,CAAC;IACX,KAAK,EAAE,MAAM,CAAC;IACd,IAAI,EAAE,MAAM,CAAC;IACb,IAAI,EAAE,MAAM,CAAC;IACb,QAAQ,EAAE,MAAM,CAAC;IACjB,IAAI,EAAE,MAAM,EAAE,CAAC;IACf,OAAO,EAAE,MAAM,CAAC;IAChB,SAAS,EAAE,MAAM,EAAE,CAAC;IACpB,GAAG,EAAE,MAAM,CAAC;CACb;AAED,MAAM,WAAW,aAAa;IAC5B,IAAI,EAAE,MAAM,CAAC;IACb,OAAO,EAAE,MAAM,CAAC;IAChB,WAAW,EAAE,MAAM,CAAC;CACrB;AAED,MAAM,WAAW,iBAAiB;IAChC,OAAO,EAAE,aAAa,CAAC;IACvB,KAAK,EAAE,UAAU,EAAE,CAAC;CACrB;AAED,MAAM,WAAW,YAAY;IAC3B,IAAI,CAAC,EAAE,MAAM,CAAC;IACd,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,CAAC,GAAG,EAAE,MAAM,GAAG,OAAO,CAAC;CACxB;AAED,MAAM,WAAW,cAAc;IAC7B,SAAS,EAAE,eAAe,GAAG,IAAI,CAAC;IAClC,aAAa,EAAE,iBAAiB,GAAG,IAAI,CAAC;IACxC,YAAY,EAAE,YAAY,GAAG,IAAI,CAAC;CACnC"}
+{"version":3,"file":"types.d.ts","sourceRoot":"","sources":["../../src/data/types.ts"],"names":[],"mappings":"AAAA,MAAM,WAAW,kBAAkB;IACjC,OAAO,EAAE,MAAM,CAAC;IAChB,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB,SAAS,EAAE,MAAM,EAAE,CAAC;IACpB,IAAI,EAAE,MAAM,EAAE,CAAC;IACf,WAAW,CAAC,EAAE,MAAM,CAAC;CACtB;AAED,MAAM,WAAW,mBAAmB;IAClC,IAAI,EAAE,kBAAkB,CAAC;IACzB,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,WAAW,CAAC,EAAE,MAAM,CAAC;CACtB;AAED,MAAM,WAAW,eAAe;IAC9B,IAAI,EAAE;QACJ,WAAW,EAAE,MAAM,CAAC;QACpB,KAAK,EAAE,MAAM,CAAC;QACd,cAAc,EAAE,MAAM,CAAC;KACxB,CAAC;IACF,QAAQ,EAAE,MAAM,CAAC,MAAM,EAAE,mBAAmB,CAAC,CAAC;CAC/C;AAED,MAAM,WAAW,UAAU;IACzB,EAAE,EAAE,MAAM,CAAC;IACX,KAAK,EAAE,MAAM,CAAC;IACd,IAAI,EAAE,MAAM,CAAC;IACb,IAAI,EAAE,MAAM,CAAC;IACb,QAAQ,EAAE,MAAM,CAAC;IACjB,IAAI,EAAE,MAAM,EAAE,CAAC;IACf,OAAO,EAAE,MAAM,CAAC;IAChB,SAAS,EAAE,MAAM,EAAE,CAAC;IACpB,GAAG,EAAE,MAAM,CAAC;CACb;AAED,MAAM,WAAW,aAAa;IAC5B,IAAI,EAAE,MAAM,CAAC;IACb,OAAO,EAAE,MAAM,CAAC;IAChB,WAAW,EAAE,MAAM,CAAC;CACrB;AAED,MAAM,WAAW,iBAAiB;IAChC,OAAO,EAAE,aAAa,CAAC;IACvB,KAAK,EAAE,UAAU,EAAE,CAAC;CACrB;AAED,MAAM,WAAW,YAAY;IAC3B,IAAI,CAAC,EAAE,MAAM,CAAC;IACd,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,CAAC,GAAG,EAAE,MAAM,GAAG,OAAO,CAAC;CACxB;AAED,MAAM,WAAW,cAAc;IAC7B,SAAS,EAAE,eAAe,GAAG,IAAI,CAAC;IAClC,aAAa,EAAE,iBAAiB,GAAG,IAAI,CAAC;IACxC,YAAY,EAAE,YAAY,GAAG,IAAI,CAAC;IAClC,YAAY,EAAE,OAAO,2BAA2B,EAAE,gBAAgB,GAAG,IAAI,CAAC;IAC1E,WAAW,EAAE,OAAO,8BAA8B,EAAE,WAAW,GAAG,IAAI,CAAC;CACxE"}

package/dist/fact-registry/fact-matcher.d.ts

@@ -0,0 +1,12 @@
+import type { Fact } from './types.js';
+/**
+ * Selects facts most relevant to the user's query.
+ *
+ * Strategy:
+ * 1. Always include very-high-confidence core facts (confidence >= 0.95)
+ * 2. Add category-matched facts based on query keywords
+ * 3. Add tag-matched facts for more specific queries
+ * 4. Deduplicate and cap total count
+ */
+export declare function matchFactsToQuery(query: string, lang?: string, maxFacts?: number): Fact[];
+//# sourceMappingURL=fact-matcher.d.ts.map

package/dist/fact-registry/fact-matcher.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"fact-matcher.d.ts","sourceRoot":"","sources":["../../src/fact-registry/fact-matcher.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,IAAI,EAAgB,MAAM,YAAY,CAAC;AAwDrD;;;;;;;;GAQG;AACH,wBAAgB,iBAAiB,CAC/B,KAAK,EAAE,MAAM,EACb,IAAI,CAAC,EAAE,MAAM,EACb,QAAQ,SAAK,GACZ,IAAI,EAAE,CA2CR"}

package/dist/fact-registry/fact-matcher.js

@@ -0,0 +1,94 @@
+import { queryFacts } from './registry.js';
+/**
+ * Category detection keywords — when any keyword appears in the user query,
+ * the corresponding fact category is considered relevant.
+ */
+const CATEGORY_KEYWORDS = {
+    author: [
+        '作者', '博主', '谁', '关于我', '自我介绍', '个人',
+        'author', 'who', 'about me', 'introduce',
+    ],
+    blog: [
+        '博客', '文章', '多少', '数量', '统计', '总共', '分类', '标签', '语言',
+        'blog', 'post', 'how many', 'count', 'statistic', 'category', 'tag',
+    ],
+    content: [
+        '写过', '提到', '讨论', '观点', '主题', '话题', '涵盖', '领域',
+        'wrote', 'mention', 'discuss', 'topic', 'cover', 'area', 'opinion',
+    ],
+    project: [
+        '项目', '开源', '仓库', '工具', '产品',
+        'project', 'open source', 'repo', 'github', 'tool', 'product',
+    ],
+    tech: [
+        '技术', '技术栈', '框架', '库', '编程语言', '前端', '后端',
+        'tech', 'stack', 'framework', 'library', 'language', 'frontend', 'backend',
+    ],
+};
+/**
+ * Detect which fact categories are relevant to the user query.
+ */
+function detectRelevantCategories(query) {
+    const q = query.toLowerCase();
+    const matched = [];
+    for (const [category, keywords] of Object.entries(CATEGORY_KEYWORDS)) {
+        if (keywords.some(kw => q.includes(kw))) {
+            matched.push(category);
+        }
+    }
+    return matched;
+}
+/**
+ * Extract potential matching tags from the query by splitting into tokens.
+ */
+function extractQueryTags(query) {
+    const tokens = query.match(/[A-Za-z][A-Za-z0-9.+#-]{1,}|[\u4e00-\u9fa5]{2,6}/g);
+    return tokens?.map(t => t.toLowerCase()) ?? [];
+}
+/**
+ * Selects facts most relevant to the user's query.
+ *
+ * Strategy:
+ * 1. Always include very-high-confidence core facts (confidence >= 0.95)
+ * 2. Add category-matched facts based on query keywords
+ * 3. Add tag-matched facts for more specific queries
+ * 4. Deduplicate and cap total count
+ */
+export function matchFactsToQuery(query, lang, maxFacts = 15) {
+    const categories = detectRelevantCategories(query);
+    const queryTags = extractQueryTags(query);
+    // Layer 1: always-present core facts (highest confidence)
+    const coreFacts = queryFacts({
+        minConfidence: 0.95,
+        lang,
+        limit: 5,
+    });
+    // Layer 2: category-matched facts
+    const categoryFacts = categories.length > 0
+        ? queryFacts({
+            categories,
+            minConfidence: 0.7,
+            lang,
+            limit: 10,
+        })
+        : [];
+    // Layer 3: tag-matched facts (for specificity)
+    const tagFacts = queryTags.length > 0
+        ? queryFacts({
+            tags: queryTags,
+            minConfidence: 0.6,
+            lang,
+            limit: 5,
+        })
+        : [];
+    // Merge with deduplication, preserving priority order
+    const seen = new Set();
+    const result = [];
+    for (const fact of [...categoryFacts, ...tagFacts, ...coreFacts]) {
+        if (!seen.has(fact.id)) {
+            seen.add(fact.id);
+            result.push(fact);
+        }
+    }
+    return result.slice(0, maxFacts);
+}

package/dist/fact-registry/index.d.ts

@@ -0,0 +1,5 @@
+export { loadFactRegistry, clearFactRegistry, getFactRegistry, queryFacts, } from './registry.js';
+export { matchFactsToQuery } from './fact-matcher.js';
+export { buildFactSection } from './prompt-injector.js';
+export type { Fact, FactCategory, FactSource, FactRegistryFile, FactRegistryStats, FactQueryOptions, } from './types.js';
+//# sourceMappingURL=index.d.ts.map

package/dist/fact-registry/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/fact-registry/index.ts"],"names":[],"mappings":"AAAA,OAAO,EACL,gBAAgB,EAChB,iBAAiB,EACjB,eAAe,EACf,UAAU,GACX,MAAM,eAAe,CAAC;AACvB,OAAO,EAAE,iBAAiB,EAAE,MAAM,mBAAmB,CAAC;AACtD,OAAO,EAAE,gBAAgB,EAAE,MAAM,sBAAsB,CAAC;AACxD,YAAY,EACV,IAAI,EACJ,YAAY,EACZ,UAAU,EACV,gBAAgB,EAChB,iBAAiB,EACjB,gBAAgB,GACjB,MAAM,YAAY,CAAC"}

package/dist/fact-registry/index.js

@@ -0,0 +1,3 @@
+export { loadFactRegistry, clearFactRegistry, getFactRegistry, queryFacts, } from './registry.js';
+export { matchFactsToQuery } from './fact-matcher.js';
+export { buildFactSection } from './prompt-injector.js';

package/dist/fact-registry/prompt-injector.d.ts

@@ -0,0 +1,7 @@
+import type { Fact } from './types.js';
+/**
+ * Formats matched facts into a prompt section ready for injection.
+ * Groups facts by category with clear structure.
+ */
+export declare function buildFactSection(facts: Fact[], lang?: string): string;
+//# sourceMappingURL=prompt-injector.d.ts.map

package/dist/fact-registry/prompt-injector.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"prompt-injector.d.ts","sourceRoot":"","sources":["../../src/fact-registry/prompt-injector.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,IAAI,EAAgB,MAAM,YAAY,CAAC;AAgCrD;;;GAGG;AACH,wBAAgB,gBAAgB,CAAC,KAAK,EAAE,IAAI,EAAE,EAAE,IAAI,GAAE,MAAa,GAAG,MAAM,CA+B3E"}

package/dist/fact-registry/prompt-injector.js

@@ -0,0 +1,57 @@
+const CATEGORY_LABELS = {
+    zh: {
+        author: '关于作者',
+        blog: '博客数据',
+        content: '内容事实',
+        project: '项目信息',
+        tech: '技术相关',
+    },
+    en: {
+        author: 'About the Author',
+        blog: 'Blog Statistics',
+        content: 'Content Facts',
+        project: 'Project Info',
+        tech: 'Tech Related',
+    },
+};
+const SECTION_TEXT = {
+    zh: {
+        title: '已验证事实（基于博客真实数据）',
+        instruction: '以上事实来自博客的真实数据。回答时优先使用这些已验证的事实，不要编造与之矛盾的信息。如果某个问题的答案不在已验证事实中，请如实说明。',
+    },
+    en: {
+        title: 'Verified Facts (based on real blog data)',
+        instruction: 'The above facts are derived from real blog data. Prioritize these verified facts when answering. Do not fabricate information that contradicts them. If the answer is not among verified facts, state that honestly.',
+    },
+};
+/**
+ * Formats matched facts into a prompt section ready for injection.
+ * Groups facts by category with clear structure.
+ */
+export function buildFactSection(facts, lang = 'zh') {
+    if (!facts.length)
+        return '';
+    const l = lang === 'zh' ? 'zh' : 'en';
+    const labels = CATEGORY_LABELS[l];
+    const text = SECTION_TEXT[l];
+    // Group by category
+    const grouped = new Map();
+    for (const fact of facts) {
+        const group = grouped.get(fact.category) ?? [];
+        group.push(fact);
+        grouped.set(fact.category, group);
+    }
+    const lines = [];
+    lines.push(`## ${text.title}`);
+    for (const [category, categoryFacts] of grouped) {
+        const label = labels[category] ?? category;
+        lines.push('');
+        lines.push(`### ${label}`);
+        for (const fact of categoryFacts) {
+            lines.push(`- ${fact.statement}`);
+        }
+    }
+    lines.push('');
+    lines.push(`> ${text.instruction}`);
+    return lines.join('\n');
+}

package/dist/fact-registry/registry.d.ts

@@ -0,0 +1,10 @@
+import type { Fact, FactRegistryFile, FactQueryOptions } from './types.js';
+export declare function loadFactRegistry(data: FactRegistryFile | null): void;
+export declare function clearFactRegistry(): void;
+export declare function getFactRegistry(): FactRegistryFile | null;
+/**
+ * Query facts with optional filters.
+ * Returns facts sorted by confidence (highest first).
+ */
+export declare function queryFacts(options?: FactQueryOptions): Fact[];
+//# sourceMappingURL=registry.d.ts.map

package/dist/fact-registry/registry.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"registry.d.ts","sourceRoot":"","sources":["../../src/fact-registry/registry.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,IAAI,EAAE,gBAAgB,EAAE,gBAAgB,EAAE,MAAM,YAAY,CAAC;AAI3E,wBAAgB,gBAAgB,CAAC,IAAI,EAAE,gBAAgB,GAAG,IAAI,GAAG,IAAI,CAEpE;AAED,wBAAgB,iBAAiB,IAAI,IAAI,CAExC;AAED,wBAAgB,eAAe,IAAI,gBAAgB,GAAG,IAAI,CAEzD;AAED;;;GAGG;AACH,wBAAgB,UAAU,CAAC,OAAO,GAAE,gBAAqB,GAAG,IAAI,EAAE,CAgCjE"}

package/dist/fact-registry/registry.js

@@ -0,0 +1,38 @@
+let cachedRegistry = null;
+export function loadFactRegistry(data) {
+    cachedRegistry = data;
+}
+export function clearFactRegistry() {
+    cachedRegistry = null;
+}
+export function getFactRegistry() {
+    return cachedRegistry;
+}
+/**
+ * Query facts with optional filters.
+ * Returns facts sorted by confidence (highest first).
+ */
+export function queryFacts(options = {}) {
+    if (!cachedRegistry?.facts.length)
+        return [];
+    let facts = cachedRegistry.facts;
+    if (options.categories?.length) {
+        const cats = new Set(options.categories);
+        facts = facts.filter(f => cats.has(f.category));
+    }
+    if (options.lang) {
+        facts = facts.filter(f => f.lang === options.lang || f.lang === 'all');
+    }
+    if (options.minConfidence !== undefined) {
+        facts = facts.filter(f => f.confidence >= options.minConfidence);
+    }
+    if (options.tags?.length) {
+        const tagSet = new Set(options.tags.map(t => t.toLowerCase()));
+        facts = facts.filter(f => f.tags.some(t => tagSet.has(t.toLowerCase())));
+    }
+    facts = [...facts].sort((a, b) => b.confidence - a.confidence);
+    if (options.limit && options.limit > 0) {
+        facts = facts.slice(0, options.limit);
+    }
+    return facts;
+}

package/dist/fact-registry/types.d.ts

@@ -0,0 +1,46 @@
+/**
+ * Fact Registry — structured, verifiable facts extracted from blog data.
+ * Injected into prompts to ground AI responses in real data and reduce hallucination.
+ */
+export type FactCategory = 'author' | 'blog' | 'content' | 'project' | 'tech';
+/**
+ * How the fact was produced:
+ * - `explicit`: directly stated in blog content or configuration
+ * - `derived`: computed from blog data (counts, aggregations)
+ * - `aggregated`: synthesized from multiple posts/sources
+ */
+export type FactSource = 'explicit' | 'derived' | 'aggregated';
+export interface Fact {
+    id: string;
+    category: FactCategory;
+    /** Human-readable statement in the target language */
+    statement: string;
+    /** Where this fact comes from (file, config, computation) */
+    evidence: string;
+    source: FactSource;
+    /** 0–1 reliability score; 1 = absolute certainty */
+    confidence: number;
+    /** Keywords for query matching */
+    tags: string[];
+    lang: string;
+}
+export interface FactRegistryFile {
+    $schema: string;
+    generatedAt: string;
+    version: number;
+    facts: Fact[];
+    stats: FactRegistryStats;
+}
+export interface FactRegistryStats {
+    total: number;
+    byCategory: Record<FactCategory, number>;
+    avgConfidence: number;
+}
+export interface FactQueryOptions {
+    categories?: FactCategory[];
+    tags?: string[];
+    minConfidence?: number;
+    lang?: string;
+    limit?: number;
+}
+//# sourceMappingURL=types.d.ts.map

package/dist/fact-registry/types.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"types.d.ts","sourceRoot":"","sources":["../../src/fact-registry/types.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAEH,MAAM,MAAM,YAAY,GAAG,QAAQ,GAAG,MAAM,GAAG,SAAS,GAAG,SAAS,GAAG,MAAM,CAAC;AAE9E;;;;;GAKG;AACH,MAAM,MAAM,UAAU,GAAG,UAAU,GAAG,SAAS,GAAG,YAAY,CAAC;AAE/D,MAAM,WAAW,IAAI;IACnB,EAAE,EAAE,MAAM,CAAC;IACX,QAAQ,EAAE,YAAY,CAAC;IACvB,sDAAsD;IACtD,SAAS,EAAE,MAAM,CAAC;IAClB,6DAA6D;IAC7D,QAAQ,EAAE,MAAM,CAAC;IACjB,MAAM,EAAE,UAAU,CAAC;IACnB,oDAAoD;IACpD,UAAU,EAAE,MAAM,CAAC;IACnB,kCAAkC;IAClC,IAAI,EAAE,MAAM,EAAE,CAAC;IACf,IAAI,EAAE,MAAM,CAAC;CACd;AAED,MAAM,WAAW,gBAAgB;IAC/B,OAAO,EAAE,MAAM,CAAC;IAChB,WAAW,EAAE,MAAM,CAAC;IACpB,OAAO,EAAE,MAAM,CAAC;IAChB,KAAK,EAAE,IAAI,EAAE,CAAC;IACd,KAAK,EAAE,iBAAiB,CAAC;CAC1B;AAED,MAAM,WAAW,iBAAiB;IAChC,KAAK,EAAE,MAAM,CAAC;IACd,UAAU,EAAE,MAAM,CAAC,YAAY,EAAE,MAAM,CAAC,CAAC;IACzC,aAAa,EAAE,MAAM,CAAC;CACvB;AAED,MAAM,WAAW,gBAAgB;IAC/B,UAAU,CAAC,EAAE,YAAY,EAAE,CAAC;IAC5B,IAAI,CAAC,EAAE,MAAM,EAAE,CAAC;IAChB,aAAa,CAAC,EAAE,MAAM,CAAC;IACvB,IAAI,CAAC,EAAE,MAAM,CAAC;IACd,KAAK,CAAC,EAAE,MAAM,CAAC;CAChB"}

package/dist/fact-registry/types.js

@@ -0,0 +1,5 @@
+/**
+ * Fact Registry — structured, verifiable facts extracted from blog data.
+ * Injected into prompts to ground AI responses in real data and reduce hallucination.
+ */
+export {};

package/dist/index.d.ts

@@ -14,6 +14,7 @@ export * from './search/index.js';
 export * from './intelligence/index.js';
 export * from './prompt/index.js';
 export * from './data/index.js';
+export * from './fact-registry/index.js';
 export * from './stream/index.js';
 export * from './server/index.js';
 //# sourceMappingURL=index.d.ts.map

package/dist/index.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA;;;;;;;GAOG;AAGH,cAAc,sBAAsB,CAAC;AAGrC,cAAc,6BAA6B,CAAC;AAG5C,cAAc,uBAAuB,CAAC;AAGtC,cAAc,kBAAkB,CAAC;AAGjC,cAAc,mBAAmB,CAAC;AAGlC,cAAc,yBAAyB,CAAC;AAGxC,cAAc,mBAAmB,CAAC;AAGlC,cAAc,iBAAiB,CAAC;AAGhC,cAAc,mBAAmB,CAAC;AAGlC,cAAc,mBAAmB,CAAC"}
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA;;;;;;;GAOG;AAGH,cAAc,sBAAsB,CAAC;AAGrC,cAAc,6BAA6B,CAAC;AAG5C,cAAc,uBAAuB,CAAC;AAGtC,cAAc,kBAAkB,CAAC;AAGjC,cAAc,mBAAmB,CAAC;AAGlC,cAAc,yBAAyB,CAAC;AAGxC,cAAc,mBAAmB,CAAC;AAGlC,cAAc,iBAAiB,CAAC;AAGhC,cAAc,0BAA0B,CAAC;AAGzC,cAAc,mBAAmB,CAAC;AAGlC,cAAc,mBAAmB,CAAC"}

package/dist/index.js

@@ -22,6 +22,8 @@ export * from './intelligence/index.js';
 export * from './prompt/index.js';
 // Build-time metadata loading
 export * from './data/index.js';
+// Fact Registry: verified facts for hallucination reduction
+export * from './fact-registry/index.js';
 // Stream utilities
 export * from './stream/index.js';
 // Server-side API handlers (chat handler, metadata init)

package/dist/intelligence/citation-appender.d.ts

@@ -0,0 +1,19 @@
+import type { ArticleContext, ProjectContext } from '../search/types.js';
+export interface CitationAppenderConfig {
+    articles: ArticleContext[];
+    projects: ProjectContext[];
+    lang: string;
+    maxCitations: number;
+    minScore: number;
+}
+interface CitationCandidate {
+    title: string;
+    url: string;
+    score: number;
+}
+export declare function selectCitations(articles: ArticleContext[], projects: ProjectContext[], maxCitations: number, minScore: number): CitationCandidate[];
+export declare function formatCitationBlock(citations: CitationCandidate[], lang: string): string;
+export declare function createCitationAppenderTransform(config: CitationAppenderConfig): (stream: ReadableStream<string>) => ReadableStream<string>;
+export declare function shouldAppendCitations(response: string, articles: ArticleContext[], projects: ProjectContext[]): boolean;
+export {};
+//# sourceMappingURL=citation-appender.d.ts.map

package/dist/intelligence/citation-appender.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"citation-appender.d.ts","sourceRoot":"","sources":["../../src/intelligence/citation-appender.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,cAAc,EAAE,cAAc,EAAE,MAAM,oBAAoB,CAAC;AAGzE,MAAM,WAAW,sBAAsB;IACrC,QAAQ,EAAE,cAAc,EAAE,CAAC;IAC3B,QAAQ,EAAE,cAAc,EAAE,CAAC;IAC3B,IAAI,EAAE,MAAM,CAAC;IACb,YAAY,EAAE,MAAM,CAAC;IACrB,QAAQ,EAAE,MAAM,CAAC;CAClB;AAED,UAAU,iBAAiB;IACzB,KAAK,EAAE,MAAM,CAAC;IACd,GAAG,EAAE,MAAM,CAAC;IACZ,KAAK,EAAE,MAAM,CAAC;CACf;AAQD,wBAAgB,eAAe,CAC7B,QAAQ,EAAE,cAAc,EAAE,EAC1B,QAAQ,EAAE,cAAc,EAAE,EAC1B,YAAY,EAAE,MAAM,EACpB,QAAQ,EAAE,MAAM,GACf,iBAAiB,EAAE,CAarB;AAED,wBAAgB,mBAAmB,CACjC,SAAS,EAAE,iBAAiB,EAAE,EAC9B,IAAI,EAAE,MAAM,GACX,MAAM,CAYR;AAED,wBAAgB,+BAA+B,CAC7C,MAAM,EAAE,sBAAsB,GAC7B,CAAC,MAAM,EAAE,cAAc,CAAC,MAAM,CAAC,KAAK,cAAc,CAAC,MAAM,CAAC,CAkC5D;AAED,wBAAgB,qBAAqB,CACnC,QAAQ,EAAE,MAAM,EAChB,QAAQ,EAAE,cAAc,EAAE,EAC1B,QAAQ,EAAE,cAAc,EAAE,GACzB,OAAO,CAQT"}

package/dist/intelligence/citation-appender.js

@@ -0,0 +1,65 @@
+function hasExistingCitations(text, validUrls) {
+    const linkPattern = /\[([^\]]+)\]\(([^)]+)\)/g;
+    const matches = [...text.matchAll(linkPattern)];
+    return matches.some(m => validUrls.has(m[2]));
+}
+export function selectCitations(articles, projects, maxCitations, minScore) {
+    const candidates = [
+        ...articles
+            .filter(a => (a.score ?? 0) >= minScore)
+            .map(a => ({ title: a.title, url: a.url, score: a.score ?? 0 })),
+        ...projects
+            .filter(p => (p.score ?? 0) >= minScore)
+            .map(p => ({ title: p.name, url: p.url, score: p.score ?? 0 })),
+    ];
+    return candidates
+        .sort((a, b) => b.score - a.score)
+        .slice(0, maxCitations);
+}
+export function formatCitationBlock(citations, lang) {
+    if (citations.length === 0)
+        return '';
+    const heading = lang === 'zh' ? '延伸阅读' : 'Further Reading';
+    const lines = [
+        '',
+        `**${heading}:**`,
+        ...citations.map(c => `- [${c.title}](${c.url})`),
+    ];
+    return lines.join('\n');
+}
+export function createCitationAppenderTransform(config) {
+    const { articles, projects, lang, maxCitations = 3, minScore = 5 } = config;
+    const validUrls = new Set([
+        ...articles.map(a => a.url),
+        ...projects.map(p => p.url),
+    ]);
+    return (stream) => {
+        let fullText = '';
+        const transform = new TransformStream({
+            transform(chunk, controller) {
+                fullText += chunk;
+                controller.enqueue(chunk);
+            },
+            flush(controller) {
+                if (hasExistingCitations(fullText, validUrls)) {
+                    return;
+                }
+                const citations = selectCitations(articles, projects, maxCitations, minScore);
+                if (citations.length === 0) {
+                    return;
+                }
+                const citationBlock = formatCitationBlock(citations, lang);
+                controller.enqueue(citationBlock);
+            },
+        });
+        return stream.pipeThrough(transform);
+    };
+}
+export function shouldAppendCitations(response, articles, projects) {
+    const validUrls = new Set([
+        ...articles.map(a => a.url),
+        ...projects.map(p => p.url),
+    ]);
+    return !hasExistingCitations(response, validUrls) &&
+        [...articles, ...projects].some(item => (item.score ?? 0) >= 5);
+}

package/dist/intelligence/citation-guard.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"citation-guard.d.ts","sourceRoot":"","sources":["../../src/intelligence/citation-guard.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,cAAc,EAAE,cAAc,EAAE,MAAM,oBAAoB,CAAC;AACzE,OAAO,KAAK,EAAE,sBAAsB,EAAE,mBAAmB,EAAE,MAAM,YAAY,CAAC;AAE9E,MAAM,MAAM,UAAU,GAAG,MAAM,GAAG,OAAO,GAAG,MAAM,GAAG,SAAS,GAAG,gBAAgB,GAAG,SAAS,GAAG,SAAS,CAAC;AAiB1G;;;GAGG;AACH,wBAAgB,iBAAiB,CAAC,KAAK,EAAE,MAAM,GAAG,UAAU,CAS3D;AAkBD;;;;GAIG;AACH,wBAAgB,yBAAyB,CAAC,MAAM,EAAE;IAChD,SAAS,EAAE,MAAM,CAAC;IAClB,QAAQ,EAAE,cAAc,EAAE,CAAC;IAC3B,QAAQ,EAAE,cAAc,EAAE,CAAC;IAC3B,IAAI,CAAC,EAAE,MAAM,CAAC;CACf,GAAG,sBAAsB,GAAG,IAAI,CA2BhC;AAED;;;GAGG;AACH,wBAAgB,4BAA4B,CAAC,MAAM,EAAE;IACnD,QAAQ,EAAE,cAAc,EAAE,CAAC;IAC3B,QAAQ,EAAE,cAAc,EAAE,CAAC;IAC3B,SAAS,CAAC,EAAE,CAAC,MAAM,EAAE;QAAE,OAAO,EAAE,mBAAmB,EAAE,CAAA;KAAE,KAAK,IAAI,CAAC;CAClE,GAAG,CAAC,MAAM,EAAE,cAAc,CAAC,MAAM,CAAC,KAAK,cAAc,CAAC,MAAM,CAAC,CAuD7D"}
+{"version":3,"file":"citation-guard.d.ts","sourceRoot":"","sources":["../../src/intelligence/citation-guard.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,cAAc,EAAE,cAAc,EAAE,MAAM,oBAAoB,CAAC;AACzE,OAAO,KAAK,EAAE,sBAAsB,EAAE,mBAAmB,EAAE,MAAM,YAAY,CAAC;AAS9E,MAAM,MAAM,UAAU,GAAG,MAAM,GAAG,OAAO,GAAG,MAAM,GAAG,SAAS,GAAG,gBAAgB,GAAG,SAAS,GAAG,SAAS,CAAC;AAgB1G;;;GAGG;AACH,wBAAgB,iBAAiB,CAAC,KAAK,EAAE,MAAM,GAAG,UAAU,CAS3D;AAoBD;;;;GAIG;AACH,wBAAgB,yBAAyB,CAAC,MAAM,EAAE;IAChD,SAAS,EAAE,MAAM,CAAC;IAClB,QAAQ,EAAE,cAAc,EAAE,CAAC;IAC3B,QAAQ,EAAE,cAAc,EAAE,CAAC;IAC3B,IAAI,CAAC,EAAE,MAAM,CAAC;CACf,GAAG,sBAAsB,GAAG,IAAI,CAuBhC;AAED;;;GAGG;AACH,wBAAgB,4BAA4B,CAAC,MAAM,EAAE;IACnD,QAAQ,EAAE,cAAc,EAAE,CAAC;IAC3B,QAAQ,EAAE,cAAc,EAAE,CAAC;IAC3B,SAAS,CAAC,EAAE,CAAC,MAAM,EAAE;QAAE,OAAO,EAAE,mBAAmB,EAAE,CAAA;KAAE,KAAK,IAAI,CAAC;CAClE,GAAG,CAAC,MAAM,EAAE,cAAc,CAAC,MAAM,CAAC,KAAK,cAAc,CAAC,MAAM,CAAC,CAuD7D"}

package/dist/intelligence/citation-guard.js

@@ -1,10 +1,11 @@
+import { PRIVACY_REFUSAL_TEMPLATES, NO_ARTICLE_TEMPLATES, ARTICLE_COUNT_TEMPLATES, pickTemplate, pickTemplateWithVars, } from './response-templates.js';
 const PRIVACY_PATTERNS = [
-    { regex: /(住址|地址|住在哪|address|where.*live)/iu, zh: '具体住址是私人信息，未在博客中公开。', en: 'Address is private and not disclosed on the blog.' },
-    { regex: /(收入|工资|薪资|salary|income|earn)/iu, zh: '收入信息未在博客中公开。', en: 'Income information is not disclosed on the blog.' },
-    { regex: /(家人|妻子|丈夫|孩子|父母|family|wife|husband|children|parent)/iu, zh: '家人信息未在博客中公开。', en: 'Family information is not disclosed on the blog.' },
-    { regex: /(电话|手机号|phone|mobile)/iu, zh: '联系电话未在博客中公开。', en: 'Phone number is not disclosed on the blog.' },
-    { regex: /(身份证|id\s*card|passport)/iu, zh: '身份证件信息未在博客中公开。', en: 'ID information is not disclosed on the blog.' },
-    { regex: /(年龄|多大了|几岁|how old|age)/iu, zh: '年龄信息未在博客中公开。', en: 'Age information is not disclosed on the blog.' },
+    { regex: /(住址|地址|住在哪|address|where.*live)/iu, key: 'address' },
+    { regex: /(收入|工资|薪资|salary|income|earn)/iu, key: 'income' },
+    { regex: /(家人|妻子|丈夫|孩子|父母|family|wife|husband|children|parent)/iu, key: 'family' },
+    { regex: /(电话|手机号|phone|mobile)/iu, key: 'phone' },
+    { regex: /(身份证|id\s*card|passport)/iu, key: 'id' },
+    { regex: /(年龄|多大了|几岁|how old|age)/iu, key: 'age' },
 ];
 /**
  * Resolves the expected answer mode from the user query.
@@ -33,8 +34,10 @@ export function resolveAnswerMode(query) {
 function checkPrivacyRefusal(query, lang) {
     for (const pattern of PRIVACY_PATTERNS) {
         if (pattern.regex.test(query)) {
+            const templates = PRIVACY_REFUSAL_TEMPLATES[pattern.key];
+            const text = templates ? pickTemplate(templates, lang) : '';
             return {
-                text: lang === 'en' ? pattern.en : pattern.zh,
+                text,
                 actions: ['preflight_reject'],
             };
         }
@@ -55,17 +58,13 @@ export function getCitationGuardPreflight(params) {
     if (/有几篇|有多少篇|文章数量|总共.*文章|how many.*article/u.test(q)) {
         const total = articles.length;
         if (total > 0) {
-            const text = lang === 'en'
-                ? `Based on my search, I found ${total} related articles.`
-                : `根据我检索到的信息，当前共找到 ${total} 篇相关文章。`;
+            const text = pickTemplateWithVars(ARTICLE_COUNT_TEMPLATES, lang, { count: total });
             return { text, actions: ['preflight_reject'] };
         }
     }
     if (/有没有|是否有|有.*文章|写过.*吗|is there|any.*article/u.test(q)) {
         if (articles.length === 0 && projects.length === 0) {
-            const text = lang === 'en'
-                ? 'No articles directly related to this topic were found. Try different keywords or ask another question.'
-                : '根据博客内容搜索，目前没有找到与这个主题直接相关的文章。你可以尝试用其他关键词搜索，或者问我其他问题。';
+            const text = pickTemplate(NO_ARTICLE_TEMPLATES, lang);
             return { text, actions: ['preflight_reject'] };
         }
     }

package/dist/intelligence/index.d.ts

@@ -4,5 +4,7 @@ export { shouldRunKeywordExtraction, extractSearchKeywords, KEYWORD_EXTRACTION_T
 export { shouldSkipAnalysis, analyzeRetrievedEvidence, buildEvidenceSection, EVIDENCE_ANALYSIS_TIMEOUT_MS, EVIDENCE_ANALYSIS_MAX_TOKENS, } from './evidence-analysis.js';
 export { getCitationGuardPreflight, createCitationGuardTransform, resolveAnswerMode, } from './citation-guard.js';
 export type { AnswerMode } from './citation-guard.js';
+export { createCitationAppenderTransform, shouldAppendCitations, selectCitations, formatCitationBlock, } from './citation-appender.js';
+export type { CitationAppenderConfig } from './citation-appender.js';
 export type { QueryComplexity, KeywordExtractionResult, TokenUsageStats, EvidenceAnalysisResult, CitationGuardPreflight, CitationGuardAction, } from './types.js';
 //# sourceMappingURL=index.d.ts.map

package/dist/intelligence/index.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/intelligence/index.ts"],"names":[],"mappings":"AAAA,OAAO,EACL,gBAAgB,EAChB,uBAAuB,EACvB,eAAe,EACf,wBAAwB,EACxB,qBAAqB,EACrB,cAAc,EACd,oBAAoB,GACrB,MAAM,oBAAoB,CAAC;AAE5B,YAAY,EAAE,cAAc,EAAE,MAAM,oBAAoB,CAAC;AAEzD,OAAO,EACL,0BAA0B,EAC1B,qBAAqB,EACrB,6BAA6B,GAC9B,MAAM,sBAAsB,CAAC;AAE9B,OAAO,EACL,kBAAkB,EAClB,wBAAwB,EACxB,oBAAoB,EACpB,4BAA4B,EAC5B,4BAA4B,GAC7B,MAAM,wBAAwB,CAAC;AAEhC,OAAO,EACL,yBAAyB,EACzB,4BAA4B,EAC5B,iBAAiB,GAClB,MAAM,qBAAqB,CAAC;AAE7B,YAAY,EAAE,UAAU,EAAE,MAAM,qBAAqB,CAAC;AAEtD,YAAY,EACV,eAAe,EACf,uBAAuB,EACvB,eAAe,EACf,sBAAsB,EACtB,sBAAsB,EACtB,mBAAmB,GACpB,MAAM,YAAY,CAAC"}
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/intelligence/index.ts"],"names":[],"mappings":"AAAA,OAAO,EACL,gBAAgB,EAChB,uBAAuB,EACvB,eAAe,EACf,wBAAwB,EACxB,qBAAqB,EACrB,cAAc,EACd,oBAAoB,GACrB,MAAM,oBAAoB,CAAC;AAE5B,YAAY,EAAE,cAAc,EAAE,MAAM,oBAAoB,CAAC;AAEzD,OAAO,EACL,0BAA0B,EAC1B,qBAAqB,EACrB,6BAA6B,GAC9B,MAAM,sBAAsB,CAAC;AAE9B,OAAO,EACL,kBAAkB,EAClB,wBAAwB,EACxB,oBAAoB,EACpB,4BAA4B,EAC5B,4BAA4B,GAC7B,MAAM,wBAAwB,CAAC;AAEhC,OAAO,EACL,yBAAyB,EACzB,4BAA4B,EAC5B,iBAAiB,GAClB,MAAM,qBAAqB,CAAC;AAE7B,YAAY,EAAE,UAAU,EAAE,MAAM,qBAAqB,CAAC;AAEtD,OAAO,EACL,+BAA+B,EAC/B,qBAAqB,EACrB,eAAe,EACf,mBAAmB,GACpB,MAAM,wBAAwB,CAAC;AAEhC,YAAY,EAAE,sBAAsB,EAAE,MAAM,wBAAwB,CAAC;AAErE,YAAY,EACV,eAAe,EACf,uBAAuB,EACvB,eAAe,EACf,sBAAsB,EACtB,sBAAsB,EACtB,mBAAmB,GACpB,MAAM,YAAY,CAAC"}

package/dist/intelligence/index.js

@@ -2,3 +2,4 @@ export { isLikelyFollowUp, hasNewSignificantTokens, hasQueryOverlap, shouldReuse
 export { shouldRunKeywordExtraction, extractSearchKeywords, KEYWORD_EXTRACTION_TIMEOUT_MS, } from './keyword-extract.js';
 export { shouldSkipAnalysis, analyzeRetrievedEvidence, buildEvidenceSection, EVIDENCE_ANALYSIS_TIMEOUT_MS, EVIDENCE_ANALYSIS_MAX_TOKENS, } from './evidence-analysis.js';
 export { getCitationGuardPreflight, createCitationGuardTransform, resolveAnswerMode, } from './citation-guard.js';
+export { createCitationAppenderTransform, shouldAppendCitations, selectCitations, formatCitationBlock, } from './citation-appender.js';

package/dist/intelligence/response-templates.d.ts

@@ -0,0 +1,16 @@
+export interface ResponseTemplate {
+    zh: string[];
+    en: string[];
+}
+export declare const PRIVACY_REFUSAL_TEMPLATES: Record<string, ResponseTemplate>;
+export declare const NO_ARTICLE_TEMPLATES: ResponseTemplate;
+export declare const ARTICLE_COUNT_TEMPLATES: ResponseTemplate;
+/**
+ * Randomly selects a template from the available options.
+ */
+export declare function pickTemplate(templates: ResponseTemplate, lang: string): string;
+/**
+ * Picks a template and interpolates variables.
+ */
+export declare function pickTemplateWithVars(templates: ResponseTemplate, lang: string, vars: Record<string, string | number>): string;
+//# sourceMappingURL=response-templates.d.ts.map

package/dist/intelligence/response-templates.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"response-templates.d.ts","sourceRoot":"","sources":["../../src/intelligence/response-templates.ts"],"names":[],"mappings":"AAAA,MAAM,WAAW,gBAAgB;IAC/B,EAAE,EAAE,MAAM,EAAE,CAAC;IACb,EAAE,EAAE,MAAM,EAAE,CAAC;CACd;AAED,eAAO,MAAM,yBAAyB,EAAE,MAAM,CAAC,MAAM,EAAE,gBAAgB,CAyEtE,CAAC;AAEF,eAAO,MAAM,oBAAoB,EAAE,gBAWlC,CAAC;AAEF,eAAO,MAAM,uBAAuB,EAAE,gBAWrC,CAAC;AAEF;;GAEG;AACH,wBAAgB,YAAY,CAAC,SAAS,EAAE,gBAAgB,EAAE,IAAI,EAAE,MAAM,GAAG,MAAM,CAI9E;AAED;;GAEG;AACH,wBAAgB,oBAAoB,CAClC,SAAS,EAAE,gBAAgB,EAC3B,IAAI,EAAE,MAAM,EACZ,IAAI,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,GAAG,MAAM,CAAC,GACpC,MAAM,CAMR"}