@astro-minimax/ai 0.7.1 → 0.7.3

package/dist/search/search-index.js

@@ -1,12 +1,25 @@
 import { normalizeText } from './search-utils.js';
+import { buildIDFMap } from './idf.js';
+let cachedIDFMap = null;
 /**
- * Builds an in-memory inverted index from a list of documents.
+ * Builds an in-memory inverted index from a list of documents
+ * and computes IDF weights across the corpus.
+ *
+ * IDF map is only updated when the document set is non-empty,
+ * preventing an empty index (e.g. projects) from wiping article IDF.
  */
 export function buildSearchIndex(documents) {
-    return documents.map(doc => ({
+    const indexed = documents.map(doc => ({
         ...doc,
         tokens: buildDocumentTokens(doc),
     }));
+    if (indexed.length > 0) {
+        cachedIDFMap = buildIDFMap(indexed);
+    }
+    return indexed;
+}
+export function getIDFMapForIndex() {
+    return cachedIDFMap;
 }
 function buildDocumentTokens(doc) {
     const parts = [

package/dist/search/search-utils.d.ts

@@ -1,6 +1,7 @@
 /**
  * Text normalization and tokenization utilities for search.
  */
+import type { IDFMap } from './idf.js';
 /**
  * Normalizes text for search: lowercase, remove punctuation, normalize whitespace.
  */
@@ -14,8 +15,11 @@ export declare function tokenize(text: string): string[];
  */
 export declare function dedupeByContainment(terms: string[]): string[];
 /**
- * Computes a relevance score for a document against a set of query tokens.
- * Title matches score higher than content matches.
+ * Computes a relevance score for a document against query tokens.
+ *
+ * When an IDF map is provided, each token's contribution is weighted by its
+ * inverse document frequency — rare terms contribute more, common terms less.
+ * Falls back to uniform weighting when IDF is unavailable.
  */
 export declare function scoreDocument(tokens: string[], doc: {
     title: string;
@@ -24,7 +28,7 @@ export declare function scoreDocument(tokens: string[], doc: {
     keyPoints: string[];
     categories: string[];
     tags: string[];
-}): number;
+}, idfMap?: IDFMap | null): number;
 /**
  * Filters out low-relevance results relative to the top score.
  */

package/dist/search/search-utils.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"search-utils.d.ts","sourceRoot":"","sources":["../../src/search/search-utils.ts"],"names":[],"mappings":"AAAA;;GAEG;AAEH;;GAEG;AACH,wBAAgB,aAAa,CAAC,IAAI,EAAE,MAAM,GAAG,MAAM,CAMlD;AAED;;GAEG;AACH,wBAAgB,QAAQ,CAAC,IAAI,EAAE,MAAM,GAAG,MAAM,EAAE,CAK/C;AAED;;GAEG;AACH,wBAAgB,mBAAmB,CAAC,KAAK,EAAE,MAAM,EAAE,GAAG,MAAM,EAAE,CAS7D;AAED;;;GAGG;AACH,wBAAgB,aAAa,CAAC,MAAM,EAAE,MAAM,EAAE,EAAE,GAAG,EAAE;IAAE,KAAK,EAAE,MAAM,CAAC;IAAC,OAAO,EAAE,MAAM,CAAC;IAAC,OAAO,EAAE,MAAM,CAAC;IAAC,SAAS,EAAE,MAAM,EAAE,CAAC;IAAC,UAAU,EAAE,MAAM,EAAE,CAAC;IAAC,IAAI,EAAE,MAAM,EAAE,CAAA;CAAE,GAAG,MAAM,CA2B3K;AAED;;GAEG;AACH,wBAAgB,kBAAkB,CAAC,CAAC,SAAS;IAAE,KAAK,EAAE,MAAM,CAAA;CAAE,EAC5D,OAAO,EAAE,CAAC,EAAE,EACZ,iBAAiB,SAAO,EACxB,gBAAgB,SAAI,GACnB,CAAC,EAAE,CAML;AAED;;;GAGG;AACH,wBAAgB,eAAe,CAC7B,KAAK,EAAE,MAAM,EACb,UAAU,EAAE,KAAK,CAAC;IAAE,KAAK,EAAE,MAAM,CAAC;IAAC,SAAS,EAAE,MAAM,EAAE,CAAC;IAAC,UAAU,EAAE,MAAM,EAAE,CAAA;CAAE,CAAC,EAC/E,QAAQ,SAAI,EACZ,aAAa,SAAI,GAChB,MAAM,EAAE,CAuBV"}
+{"version":3,"file":"search-utils.d.ts","sourceRoot":"","sources":["../../src/search/search-utils.ts"],"names":[],"mappings":"AAAA;;GAEG;AAEH,OAAO,KAAK,EAAE,MAAM,EAAE,MAAM,UAAU,CAAC;AAGvC;;GAEG;AACH,wBAAgB,aAAa,CAAC,IAAI,EAAE,MAAM,GAAG,MAAM,CAMlD;AAED;;GAEG;AACH,wBAAgB,QAAQ,CAAC,IAAI,EAAE,MAAM,GAAG,MAAM,EAAE,CAI/C;AAED;;GAEG;AACH,wBAAgB,mBAAmB,CAAC,KAAK,EAAE,MAAM,EAAE,GAAG,MAAM,EAAE,CAS7D;AAYD;;;;;;GAMG;AACH,wBAAgB,aAAa,CAC3B,MAAM,EAAE,MAAM,EAAE,EAChB,GAAG,EAAE;IAAE,KAAK,EAAE,MAAM,CAAC;IAAC,OAAO,EAAE,MAAM,CAAC;IAAC,OAAO,EAAE,MAAM,CAAC;IAAC,SAAS,EAAE,MAAM,EAAE,CAAC;IAAC,UAAU,EAAE,MAAM,EAAE,CAAC;IAAC,IAAI,EAAE,MAAM,EAAE,CAAA;CAAE,EACnH,MAAM,CAAC,EAAE,MAAM,GAAG,IAAI,GACrB,MAAM,CAwBR;AAED;;GAEG;AACH,wBAAgB,kBAAkB,CAAC,CAAC,SAAS;IAAE,KAAK,EAAE,MAAM,CAAA;CAAE,EAC5D,OAAO,EAAE,CAAC,EAAE,EACZ,iBAAiB,SAAO,EACxB,gBAAgB,SAAI,GACnB,CAAC,EAAE,CAML;AAED;;;GAGG;AACH,wBAAgB,eAAe,CAC7B,KAAK,EAAE,MAAM,EACb,UAAU,EAAE,KAAK,CAAC;IAAE,KAAK,EAAE,MAAM,CAAC;IAAC,SAAS,EAAE,MAAM,EAAE,CAAC;IAAC,UAAU,EAAE,MAAM,EAAE,CAAA;CAAE,CAAC,EAC/E,QAAQ,SAAI,EACZ,aAAa,SAAI,GAChB,MAAM,EAAE,CAuBV"}

package/dist/search/search-utils.js

@@ -1,6 +1,7 @@
 /**
  * Text normalization and tokenization utilities for search.
  */
+import { getIDFWeight } from './idf.js';
 /**
  * Normalizes text for search: lowercase, remove punctuation, normalize whitespace.
  */
@@ -16,7 +17,6 @@ export function normalizeText(text) {
  */
 export function tokenize(text) {
     const normalized = normalizeText(text);
-    // Split on whitespace for multi-word queries
     const parts = normalized.split(/\s+/).filter(Boolean);
     return dedupeByContainment(parts);
 }
@@ -33,11 +33,23 @@ export function dedupeByContainment(terms) {
     }
     return kept;
 }
+/** Positional weight multipliers for each document field */
+const FIELD_WEIGHTS = {
+    title: 8,
+    keyPoints: 5,
+    categories: 4,
+    tags: 3,
+    excerpt: 3,
+    content: 1,
+};
 /**
- * Computes a relevance score for a document against a set of query tokens.
- * Title matches score higher than content matches.
+ * Computes a relevance score for a document against query tokens.
+ *
+ * When an IDF map is provided, each token's contribution is weighted by its
+ * inverse document frequency — rare terms contribute more, common terms less.
+ * Falls back to uniform weighting when IDF is unavailable.
  */
-export function scoreDocument(tokens, doc) {
+export function scoreDocument(tokens, doc, idfMap) {
     if (!tokens.length)
         return 0;
     let score = 0;
@@ -50,23 +62,19 @@ export function scoreDocument(tokens, doc) {
     for (const token of tokens) {
         if (!token)
             continue;
-        // Title: highest weight
+        const idf = getIDFWeight(idfMap ?? null, token);
         if (title.includes(token))
-            score += 8;
-        // KeyPoints: high weight
+            score += FIELD_WEIGHTS.title * idf;
         if (keyPointsText.includes(token))
-            score += 5;
-        // Categories/tags: medium weight
+            score += FIELD_WEIGHTS.keyPoints * idf;
         if (categoriesText.includes(token))
-            score += 4;
+            score += FIELD_WEIGHTS.categories * idf;
         if (tagsText.includes(token))
-            score += 3;
-        // Excerpt: medium weight
+            score += FIELD_WEIGHTS.tags * idf;
         if (excerpt.includes(token))
-            score += 3;
-        // Content sample: low weight
+            score += FIELD_WEIGHTS.excerpt * idf;
         if (contentSample.includes(token))
-            score += 1;
+            score += FIELD_WEIGHTS.content * idf;
     }
     return score;
 }

package/dist/search/vector-reranker.d.ts

@@ -0,0 +1,38 @@
+/**
+ * Optional TF-IDF vector reranker.
+ *
+ * When a pre-built vector index is available (from `vectorize.ts`),
+ * uses cosine similarity to refine the ranking of search results.
+ * Gracefully degrades to a no-op when no vector index is loaded.
+ */
+import type { ArticleContext } from './types.js';
+export interface VectorChunk {
+    postId: string;
+    title: string;
+    lang: string;
+    chunkIndex: number;
+    text: string;
+    vector?: number[];
+}
+export interface VectorIndex {
+    version: number;
+    method: 'tfidf' | 'openai';
+    createdAt: string;
+    vocabulary?: string[];
+    chunks: VectorChunk[];
+}
+export declare function loadVectorIndex(data: VectorIndex | null): void;
+export declare function clearVectorIndex(): void;
+export declare function hasVectorIndex(): boolean;
+/**
+ * Reranks article search results using vector cosine similarity.
+ *
+ * For each candidate article, finds the best-matching chunk in the vector
+ * index and uses the cosine similarity as a reranking signal.
+ *
+ * Final score = original_score * (1 - alpha) + vector_score * alpha
+ *
+ * @param alpha - Blend factor (0 = ignore vectors, 1 = vectors only). Default 0.3
+ */
+export declare function rerankWithVectors<T extends Pick<ArticleContext, 'url' | 'score'>>(query: string, candidates: T[], alpha?: number): T[];
+//# sourceMappingURL=vector-reranker.d.ts.map

package/dist/search/vector-reranker.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"vector-reranker.d.ts","sourceRoot":"","sources":["../../src/search/vector-reranker.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AAEH,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,YAAY,CAAC;AAIjD,MAAM,WAAW,WAAW;IAC1B,MAAM,EAAE,MAAM,CAAC;IACf,KAAK,EAAE,MAAM,CAAC;IACd,IAAI,EAAE,MAAM,CAAC;IACb,UAAU,EAAE,MAAM,CAAC;IACnB,IAAI,EAAE,MAAM,CAAC;IACb,MAAM,CAAC,EAAE,MAAM,EAAE,CAAC;CACnB;AAED,MAAM,WAAW,WAAW;IAC1B,OAAO,EAAE,MAAM,CAAC;IAChB,MAAM,EAAE,OAAO,GAAG,QAAQ,CAAC;IAC3B,SAAS,EAAE,MAAM,CAAC;IAClB,UAAU,CAAC,EAAE,MAAM,EAAE,CAAC;IACtB,MAAM,EAAE,WAAW,EAAE,CAAC;CACvB;AAOD,wBAAgB,eAAe,CAAC,IAAI,EAAE,WAAW,GAAG,IAAI,GAAG,IAAI,CAO9D;AAED,wBAAgB,gBAAgB,IAAI,IAAI,CAGvC;AAED,wBAAgB,cAAc,IAAI,OAAO,CAExC;AAID;;;;;;;;;GASG;AACH,wBAAgB,iBAAiB,CAAC,CAAC,SAAS,IAAI,CAAC,cAAc,EAAE,KAAK,GAAG,OAAO,CAAC,EAC/E,KAAK,EAAE,MAAM,EACb,UAAU,EAAE,CAAC,EAAE,EACf,KAAK,SAAM,GACV,CAAC,EAAE,CAkCL"}

package/dist/search/vector-reranker.js

@@ -0,0 +1,135 @@
+/**
+ * Optional TF-IDF vector reranker.
+ *
+ * When a pre-built vector index is available (from `vectorize.ts`),
+ * uses cosine similarity to refine the ranking of search results.
+ * Gracefully degrades to a no-op when no vector index is loaded.
+ */
+// ── State ────────────────────────────────────────────────────
+let loadedIndex = null;
+let idfCache = null;
+export function loadVectorIndex(data) {
+    loadedIndex = data;
+    idfCache = null;
+    if (data?.vocabulary && data.chunks.length > 0) {
+        idfCache = buildIDFFromVocab(data.vocabulary, data.chunks);
+    }
+}
+export function clearVectorIndex() {
+    loadedIndex = null;
+    idfCache = null;
+}
+export function hasVectorIndex() {
+    return loadedIndex !== null && loadedIndex.chunks.length > 0;
+}
+// ── Core: Rerank ──────────────────────────────────────────────
+/**
+ * Reranks article search results using vector cosine similarity.
+ *
+ * For each candidate article, finds the best-matching chunk in the vector
+ * index and uses the cosine similarity as a reranking signal.
+ *
+ * Final score = original_score * (1 - alpha) + vector_score * alpha
+ *
+ * @param alpha - Blend factor (0 = ignore vectors, 1 = vectors only). Default 0.3
+ */
+export function rerankWithVectors(query, candidates, alpha = 0.3) {
+    if (!loadedIndex || !idfCache || !loadedIndex.vocabulary) {
+        return candidates;
+    }
+    const queryVector = computeQueryVector(query, loadedIndex.vocabulary, idfCache);
+    if (!queryVector)
+        return candidates;
+    // Map postId → best chunk cosine similarity
+    const articleScores = new Map();
+    for (const chunk of loadedIndex.chunks) {
+        if (!chunk.vector)
+            continue;
+        const sim = cosineSimilarity(queryVector, chunk.vector);
+        const current = articleScores.get(chunk.postId) ?? 0;
+        if (sim > current) {
+            articleScores.set(chunk.postId, sim);
+        }
+    }
+    if (articleScores.size === 0)
+        return candidates;
+    // Normalize original scores to 0-1
+    const maxOriginal = Math.max(...candidates.map(c => c.score ?? 0), 1);
+    const reranked = candidates.map(article => {
+        const slug = extractSlugFromUrl(article.url);
+        const vectorScore = articleScores.get(slug) ?? 0;
+        const originalNorm = (article.score ?? 0) / maxOriginal;
+        const blended = originalNorm * (1 - alpha) + vectorScore * alpha;
+        return { ...article, score: blended };
+    });
+    return reranked.sort((a, b) => (b.score ?? 0) - (a.score ?? 0));
+}
+// ── Math Utilities ────────────────────────────────────────────
+function cosineSimilarity(a, b) {
+    if (a.length !== b.length)
+        return 0;
+    let dot = 0, magA = 0, magB = 0;
+    for (let i = 0; i < a.length; i++) {
+        dot += a[i] * b[i];
+        magA += a[i] * a[i];
+        magB += b[i] * b[i];
+    }
+    const mag = Math.sqrt(magA) * Math.sqrt(magB);
+    return mag === 0 ? 0 : dot / mag;
+}
+function computeQueryVector(query, vocabulary, idf) {
+    const tokens = tokenizeForVector(query);
+    if (!tokens.length)
+        return null;
+    const tf = new Map();
+    for (const t of tokens)
+        tf.set(t, (tf.get(t) || 0) + 1);
+    const maxTf = Math.max(...tf.values(), 1);
+    const vector = vocabulary.map(term => {
+        const termTf = (tf.get(term) || 0) / maxTf;
+        const termIdf = idf.get(term) || 0;
+        return termTf * termIdf;
+    });
+    // Check if vector is all zeros
+    if (vector.every(v => v === 0))
+        return null;
+    return vector;
+}
+function tokenizeForVector(text) {
+    const CJK = /[\u4e00-\u9fff\u3400-\u4dbf]/g;
+    const cjkChars = text.match(CJK) || [];
+    const latin = text
+        .replace(CJK, ' ')
+        .toLowerCase()
+        .split(/\W+/)
+        .filter(w => w.length > 2);
+    return [...cjkChars, ...latin];
+}
+function buildIDFFromVocab(vocabulary, chunks) {
+    const N = chunks.length;
+    const df = new Map();
+    for (const chunk of chunks) {
+        const tokens = new Set(tokenizeForVector(chunk.text));
+        for (const term of vocabulary) {
+            if (tokens.has(term)) {
+                df.set(term, (df.get(term) || 0) + 1);
+            }
+        }
+    }
+    const idf = new Map();
+    for (const term of vocabulary) {
+        const docCount = df.get(term) || 0;
+        idf.set(term, Math.log(N / (docCount + 1)) + 1);
+    }
+    return idf;
+}
+/**
+ * Extracts a slug/postId from a URL path like "/zh/posts/some-slug/" → "zh/some-slug"
+ */
+function extractSlugFromUrl(url) {
+    const path = url.replace(/^https?:\/\/[^/]+/, '');
+    const match = path.match(/^\/([\w-]+)\/posts\/(.+?)\/?$/);
+    if (match)
+        return `${match[1]}/${match[2]}`;
+    return path.replace(/^\/|\/$/g, '');
+}

package/dist/server/chat-handler.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"chat-handler.d.ts","sourceRoot":"","sources":["../../src/server/chat-handler.ts"],"names":[],"mappings":"AA+CA,OAAO,KAAK,EAAE,kBAAkB,EAAgC,MAAM,YAAY,CAAC;AA4HnF,wBAAsB,iBAAiB,CAAC,OAAO,EAAE,kBAAkB,GAAG,OAAO,CAAC,QAAQ,CAAC,CA0CtF"}
+{"version":3,"file":"chat-handler.d.ts","sourceRoot":"","sources":["../../src/server/chat-handler.ts"],"names":[],"mappings":"AAiDA,OAAO,KAAK,EAAE,kBAAkB,EAAgC,MAAM,YAAY,CAAC;AA4HnF,wBAAsB,iBAAiB,CAAC,OAAO,EAAE,kBAAkB,GAAG,OAAO,CAAC,QAAQ,CAAC,CA0CtF"}

package/dist/server/chat-handler.js

@@ -1,6 +1,6 @@
 import { createUIMessageStream, createUIMessageStreamResponse, streamText, convertToModelMessages, } from 'ai';
 import { t, getLang } from '../utils/i18n.js';
-import { getClientIP, checkRateLimit, rateLimitResponse, searchArticles, searchProjects, getSessionCacheKey, getCachedContext, setCachedContext, shouldReuseSearchContext, buildLocalSearchQuery, shouldRunKeywordExtraction, extractSearchKeywords, KEYWORD_EXTRACTION_TIMEOUT_MS, shouldSkipAnalysis, analyzeRetrievedEvidence, buildEvidenceSection, EVIDENCE_ANALYSIS_TIMEOUT_MS, getCitationGuardPreflight, buildSystemPrompt, getAuthorContext, getVoiceProfile, mergeResults, getProviderManager, createCacheAdapter, detectPublicQuestion, getGlobalSearchCache, shouldAppendCitations, formatCitationBlock, selectCitations, setGlobalSearchCache, getGlobalCacheTTL, getResponseCache, setResponseCache, getResponseCacheConfig, rankArticlesByIntent, } from '../index.js';
+import { getClientIP, checkRateLimit, rateLimitResponse, searchArticles, searchProjects, getSessionCacheKey, getCachedContext, setCachedContext, shouldReuseSearchContext, buildLocalSearchQuery, shouldRunKeywordExtraction, extractSearchKeywords, KEYWORD_EXTRACTION_TIMEOUT_MS, shouldSkipAnalysis, analyzeRetrievedEvidence, buildEvidenceSection, EVIDENCE_ANALYSIS_TIMEOUT_MS, getCitationGuardPreflight, buildSystemPrompt, getAuthorContext, getVoiceProfile, mergeResults, getProviderManager, createCacheAdapter, detectPublicQuestion, getGlobalSearchCache, shouldAppendCitations, formatCitationBlock, selectCitations, setGlobalSearchCache, getGlobalCacheTTL, getResponseCache, setResponseCache, getResponseCacheConfig, rankArticlesByIntent, matchFactsToQuery, buildFactSection, } from '../index.js';
 import { createChatStatusData } from './types.js';
 import { errors, corsPreflightResponse } from './errors.js';
 import { notifyAiChat } from './notify.js';
@@ -187,10 +187,12 @@ async function runPipeline(args) {
                     let responseText = '';
                     if (adapter) {
                         const articlePrompt = buildArticleContextPrompt(context);
+                        const matchedFacts = matchFactsToQuery(cachedSearch.query, lang);
+                        const factPromptSection = buildFactSection(matchedFacts, lang);
                         const systemPrompt = buildSystemPrompt({
                             static: { authorName: env.SITE_AUTHOR || '博主', siteUrl: env.SITE_URL || '', lang },
                             semiStatic: { authorContext: getAuthorContext(), voiceProfile: getVoiceProfile() },
-                            dynamic: { userQuery: cachedSearch.query, articles: cachedSearch.articles, projects: cachedSearch.projects, evidenceSection: articlePrompt },
+                            dynamic: { userQuery: cachedSearch.query, articles: cachedSearch.articles, projects: cachedSearch.projects, evidenceSection: articlePrompt, factSection: factPromptSection },
                         });
                         const llmResult = await streamLLMResponse({ writer: w, adapter, systemPrompt, messages, lang });
                         responseText = llmResult.responseText;
@@ -326,6 +328,9 @@ async function runPipeline(args) {
         projects: relatedProjects,
         lang,
     });
+    // ── Fact Registry ───────────────────────────────────────────
+    const matchedFacts = matchFactsToQuery(latestText, lang);
+    const factPromptSection = buildFactSection(matchedFacts, lang);
     // ── Build System Prompt ─────────────────────────────────────
     const articlePrompt = buildArticleContextPrompt(context);
     const systemPrompt = buildSystemPrompt({
@@ -345,6 +350,7 @@ async function runPipeline(args) {
             evidenceSection: articlePrompt
                 ? `${evidenceSection}\n${articlePrompt}`
                 : evidenceSection,
+            factSection: factPromptSection,
             lang,
         },
     });

package/dist/server/metadata-init.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"metadata-init.d.ts","sourceRoot":"","sources":["../../src/server/metadata-init.ts"],"names":[],"mappings":"AASA,OAAO,KAAK,EAAE,cAAc,EAAE,cAAc,EAAE,MAAM,YAAY,CAAC;AAIjE;;;GAGG;AACH,wBAAgB,kBAAkB,CAAC,MAAM,EAAE,cAAc,EAAE,GAAG,CAAC,EAAE,cAAc,GAAG,IAAI,CAoCrF;AAED;;GAEG;AACH,wBAAgB,iBAAiB,IAAI,IAAI,CAExC"}
+{"version":3,"file":"metadata-init.d.ts","sourceRoot":"","sources":["../../src/server/metadata-init.ts"],"names":[],"mappings":"AASA,OAAO,KAAK,EAAE,cAAc,EAAE,cAAc,EAAE,MAAM,YAAY,CAAC;AAIjE;;;GAGG;AACH,wBAAgB,kBAAkB,CAAC,MAAM,EAAE,cAAc,EAAE,GAAG,CAAC,EAAE,cAAc,GAAG,IAAI,CAsCrF;AAED;;GAEG;AACH,wBAAgB,iBAAiB,IAAI,IAAI,CAExC"}

package/dist/server/metadata-init.js

@@ -12,6 +12,8 @@ export function initializeMetadata(config, env) {
         summaries: config.summaries,
         authorContext: config.authorContext,
         voiceProfile: config.voiceProfile,
+        factRegistry: (config.factRegistry ?? null),
+        vectorIndex: (config.vectorIndex ?? null),
     });
     const authorCtx = getAuthorContext();
     const allSummaries = getAllSummaries();

package/dist/server/types.d.ts

@@ -52,6 +52,8 @@ export interface MetadataConfig {
     summaries: unknown;
     authorContext: unknown;
     voiceProfile: unknown;
+    factRegistry?: unknown;
+    vectorIndex?: unknown;
     siteUrl?: string;
 }
 //# sourceMappingURL=types.d.ts.map

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

@@ -1 +1 @@
-{"version":3,"file":"types.d.ts","sourceRoot":"","sources":["../../src/server/types.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,IAAI,CAAC;AACpC,OAAO,KAAK,EAAE,kBAAkB,EAAE,MAAM,8BAA8B,CAAC;AACvE,OAAO,KAAK,EAAE,QAAQ,EAAE,MAAM,mBAAmB,CAAC;AAIlD,MAAM,WAAW,WAAW;IAC1B,KAAK,EAAE,QAAQ,GAAG,SAAS,CAAC;IAC5B,OAAO,CAAC,EAAE,kBAAkB,CAAC;CAC9B;AAED,MAAM,WAAW,kBAAkB;IACjC,IAAI,EAAE,MAAM,CAAC;IACb,KAAK,EAAE,MAAM,CAAC;IACd,UAAU,CAAC,EAAE,MAAM,EAAE,CAAC;IACtB,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB,SAAS,CAAC,EAAE,MAAM,EAAE,CAAC;IACrB,YAAY,CAAC,EAAE,MAAM,EAAE,CAAC;CACzB;AAID,MAAM,WAAW,eAAe;IAC9B,OAAO,CAAC,EAAE,WAAW,CAAC;IACtB,EAAE,CAAC,EAAE,MAAM,CAAC;IACZ,QAAQ,EAAE,SAAS,EAAE,CAAC;IACtB,IAAI,CAAC,EAAE,MAAM,CAAC;CACf;AAED,MAAM,WAAW,cAAe,SAAQ,kBAAkB,EAAE,QAAQ;IAClE,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB,CAAC,GAAG,EAAE,MAAM,GAAG,OAAO,CAAC;CACxB;AAED,MAAM,WAAW,kBAAkB;IACjC,GAAG,EAAE,cAAc,CAAC;IACpB,OAAO,EAAE,OAAO,CAAC;IACjB,SAAS,CAAC,EAAE,CAAC,OAAO,EAAE,OAAO,CAAC,OAAO,CAAC,KAAK,IAAI,CAAC;CACjD;AAID,MAAM,MAAM,eAAe,GAAG,QAAQ,GAAG,QAAQ,GAAG,UAAU,CAAC;AAE/D,MAAM,WAAW,cAAc;IAC7B,KAAK,EAAE,eAAe,CAAC;IACvB,OAAO,EAAE,MAAM,CAAC;IAChB,QAAQ,EAAE,MAAM,CAAC;IACjB,IAAI,EAAE,OAAO,CAAC;IACd,EAAE,EAAE,MAAM,CAAC;CACZ;AAED,wBAAgB,oBAAoB,CAClC,OAAO,EAAE,IAAI,CAAC,cAAc,EAAE,MAAM,GAAG,IAAI,CAAC,GAAG;IAAE,IAAI,CAAC,EAAE,OAAO,CAAA;CAAE,GAChE,cAAc,CAMhB;AAED,wBAAgB,gBAAgB,CAAC,KAAK,EAAE,OAAO,GAAG,KAAK,IAAI,cAAc,CAIxE;AAID,MAAM,WAAW,iBAAiB;IAChC,KAAK,EAAE,MAAM,CAAC;IACd,IAAI,EAAE,MAAM,CAAC;IACb,SAAS,EAAE,OAAO,CAAC;IACnB,UAAU,CAAC,EAAE,MAAM,CAAC;CACrB;AAID,MAAM,WAAW,cAAc;IAC7B,SAAS,EAAE,OAAO,CAAC;IACnB,aAAa,EAAE,OAAO,CAAC;IACvB,YAAY,EAAE,OAAO,CAAC;IACtB,OAAO,CAAC,EAAE,MAAM,CAAC;CAClB"}
+{"version":3,"file":"types.d.ts","sourceRoot":"","sources":["../../src/server/types.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,IAAI,CAAC;AACpC,OAAO,KAAK,EAAE,kBAAkB,EAAE,MAAM,8BAA8B,CAAC;AACvE,OAAO,KAAK,EAAE,QAAQ,EAAE,MAAM,mBAAmB,CAAC;AAIlD,MAAM,WAAW,WAAW;IAC1B,KAAK,EAAE,QAAQ,GAAG,SAAS,CAAC;IAC5B,OAAO,CAAC,EAAE,kBAAkB,CAAC;CAC9B;AAED,MAAM,WAAW,kBAAkB;IACjC,IAAI,EAAE,MAAM,CAAC;IACb,KAAK,EAAE,MAAM,CAAC;IACd,UAAU,CAAC,EAAE,MAAM,EAAE,CAAC;IACtB,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB,SAAS,CAAC,EAAE,MAAM,EAAE,CAAC;IACrB,YAAY,CAAC,EAAE,MAAM,EAAE,CAAC;CACzB;AAID,MAAM,WAAW,eAAe;IAC9B,OAAO,CAAC,EAAE,WAAW,CAAC;IACtB,EAAE,CAAC,EAAE,MAAM,CAAC;IACZ,QAAQ,EAAE,SAAS,EAAE,CAAC;IACtB,IAAI,CAAC,EAAE,MAAM,CAAC;CACf;AAED,MAAM,WAAW,cAAe,SAAQ,kBAAkB,EAAE,QAAQ;IAClE,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB,CAAC,GAAG,EAAE,MAAM,GAAG,OAAO,CAAC;CACxB;AAED,MAAM,WAAW,kBAAkB;IACjC,GAAG,EAAE,cAAc,CAAC;IACpB,OAAO,EAAE,OAAO,CAAC;IACjB,SAAS,CAAC,EAAE,CAAC,OAAO,EAAE,OAAO,CAAC,OAAO,CAAC,KAAK,IAAI,CAAC;CACjD;AAID,MAAM,MAAM,eAAe,GAAG,QAAQ,GAAG,QAAQ,GAAG,UAAU,CAAC;AAE/D,MAAM,WAAW,cAAc;IAC7B,KAAK,EAAE,eAAe,CAAC;IACvB,OAAO,EAAE,MAAM,CAAC;IAChB,QAAQ,EAAE,MAAM,CAAC;IACjB,IAAI,EAAE,OAAO,CAAC;IACd,EAAE,EAAE,MAAM,CAAC;CACZ;AAED,wBAAgB,oBAAoB,CAClC,OAAO,EAAE,IAAI,CAAC,cAAc,EAAE,MAAM,GAAG,IAAI,CAAC,GAAG;IAAE,IAAI,CAAC,EAAE,OAAO,CAAA;CAAE,GAChE,cAAc,CAMhB;AAED,wBAAgB,gBAAgB,CAAC,KAAK,EAAE,OAAO,GAAG,KAAK,IAAI,cAAc,CAIxE;AAID,MAAM,WAAW,iBAAiB;IAChC,KAAK,EAAE,MAAM,CAAC;IACd,IAAI,EAAE,MAAM,CAAC;IACb,SAAS,EAAE,OAAO,CAAC;IACnB,UAAU,CAAC,EAAE,MAAM,CAAC;CACrB;AAID,MAAM,WAAW,cAAc;IAC7B,SAAS,EAAE,OAAO,CAAC;IACnB,aAAa,EAAE,OAAO,CAAC;IACvB,YAAY,EAAE,OAAO,CAAC;IACtB,YAAY,CAAC,EAAE,OAAO,CAAC;IACvB,WAAW,CAAC,EAAE,OAAO,CAAC;IACtB,OAAO,CAAC,EAAE,MAAM,CAAC;CAClB"}

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@astro-minimax/ai",
-  "version": "0.7.1",
+  "version": "0.7.3",
   "type": "module",
   "description": "Vendor-agnostic AI integration package with full RAG pipeline for astro-minimax blogs — supports OpenAI, Cloudflare AI, and custom providers.",
   "author": "Souloss",
@@ -57,6 +57,10 @@
       "types": "./dist/data/index.d.ts",
       "import": "./dist/data/index.js"
     },
+    "./fact-registry": {
+      "types": "./dist/fact-registry/index.d.ts",
+      "import": "./dist/fact-registry/index.js"
+    },
     "./stream": {
       "types": "./dist/stream/index.d.ts",
       "import": "./dist/stream/index.js"
@@ -72,6 +76,9 @@
   "files": [
     "dist/",
     "src/components/",
+    "src/providers/mock.ts",
+    "src/server/types.ts",
+    "src/utils/i18n.ts",
     "src/styles/",
     "README.md"
   ],
@@ -80,7 +87,7 @@
     "@ai-sdk/openai-compatible": "^2.0.35",
     "ai": "^6.0.116",
     "workers-ai-provider": "^3.1.2",
-    "@astro-minimax/notify": "0.7.1"
+    "@astro-minimax/notify": "0.7.3"
   },
   "optionalDependencies": {
     "undici": "^6.0.0"
@@ -108,7 +115,7 @@
     "pnpm": ">=9.0.0"
   },
   "scripts": {
-    "build": "tsc -p tsconfig.build.json",
+    "build": "tsc -p tsconfig.build.json && chmod +x dist/server/dev-server.js",
     "build:watch": "tsc -p tsconfig.build.json --watch",
     "typecheck": "tsc --noEmit",
     "clean": "rm -rf dist"

package/src/components/AIChatContainer.tsx

@@ -1,7 +1,8 @@
+/** @jsxImportSource preact */
 import { useState, useCallback } from 'preact/hooks';
-import { ChatPanel } from './ChatPanel.js';
-import type { AIChatConfig } from './ChatPanel.js';
-import type { ArticleChatContext } from '../server/types.js';
+import { ChatPanel } from './ChatPanel.tsx';
+import type { AIChatConfig } from './ChatPanel.tsx';
+import type { ArticleChatContext } from '../server/types.ts';
 
 interface Props {
   config: AIChatConfig;

package/src/components/AIChatWidget.astro

@@ -9,7 +9,7 @@ interface Props {
 }
 
 const { lang = SITE.lang ?? "zh", articleContext } = Astro.props;
-const aiEnabled = SITE.ai?.enabled ?? false;
+const aiEnabled = SITE.aiEnabled ?? false;
 
 const aiConfig = {
   enabled: aiEnabled,

package/src/components/ChatPanel.tsx

@@ -1,11 +1,12 @@
+/** @jsxImportSource preact */
 import { useCallback, useEffect, useMemo, useRef, useState } from 'preact/hooks';
 import { useChat } from '@ai-sdk/react';
 import { DefaultChatTransport } from 'ai';
 import type { UIMessage } from 'ai';
-import { getMockResponse, createMockStream } from '../providers/mock.js';
-import type { ArticleChatContext, ChatStatusData } from '../server/types.js';
-import { isChatStatusData } from '../server/types.js';
-import { t, getLang } from '../utils/i18n.js';
+import { getMockResponse, createMockStream } from '../providers/mock.ts';
+import type { ArticleChatContext, ChatStatusData } from '../server/types.ts';
+import { isChatStatusData } from '../server/types.ts';
+import { t, getLang } from '../utils/i18n.ts';
 
 export interface AIChatConfig {
   enabled?: boolean;