@astro-minimax/ai 0.2.0

package/dist/providers/index.js

@@ -0,0 +1 @@
+export { getMockResponse, createMockStream } from './mock.js';

package/dist/providers/mock.d.ts

@@ -0,0 +1,14 @@
+/**
+ * Mock provider for development and testing.
+ * Returns predefined responses with article/link recommendations.
+ * Responses use Markdown links which the ChatPanel renders as clickable elements.
+ */
+/**
+ * Returns a mock response with Markdown links for article/external link recommendations.
+ */
+export declare function getMockResponse(question: string, lang?: string): string;
+/**
+ * Creates a ReadableStream that simulates character-by-character streaming.
+ */
+export declare function createMockStream(text: string): ReadableStream<string>;
+//# sourceMappingURL=mock.d.ts.map

package/dist/providers/mock.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"mock.d.ts","sourceRoot":"","sources":["../../src/providers/mock.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAyMH;;GAEG;AACH,wBAAgB,eAAe,CAAC,QAAQ,EAAE,MAAM,EAAE,IAAI,SAAO,GAAG,MAAM,CAWrE;AAED;;GAEG;AACH,wBAAgB,gBAAgB,CAAC,IAAI,EAAE,MAAM,GAAG,cAAc,CAAC,MAAM,CAAC,CAerE"}

package/dist/providers/mock.js

@@ -0,0 +1,234 @@
+/**
+ * Mock provider for development and testing.
+ * Returns predefined responses with article/link recommendations.
+ * Responses use Markdown links which the ChatPanel renders as clickable elements.
+ */
+const MOCK_RESPONSES = [
+    {
+        patterns: [/astro/i, /框架/],
+        zh: `Astro 是一个现代化的静态站点生成器，核心优势是"岛屿架构"——默认零 JS，只在交互组件上加载脚本。本博客基于 Astro 构建。
+
+推荐阅读：
+- [快速上手：两种集成方式](/zh/posts/getting-started) — 了解如何搭建 astro-minimax 博客
+- [如何配置主题](/zh/posts/how-to-configure-astro-minimax-theme) — 自定义你的博客外观
+
+外部资源：
+- [Astro 官方文档](https://docs.astro.build) — 深入学习 Astro 框架
+- [Astro 主题市场](https://astro.build/themes/) — 发现更多 Astro 主题`,
+        en: `Astro is a modern static site generator with an "Islands Architecture" — zero JS by default, loading scripts only for interactive components. This blog is built with Astro.
+
+Recommended reading:
+- [Getting Started: Two Integration Methods](/en/posts/getting-started) — Learn how to set up an astro-minimax blog
+- [How to Configure the Theme](/en/posts/how-to-configure-astro-minimax-theme) — Customize your blog
+
+External resources:
+- [Astro Documentation](https://docs.astro.build) — Learn Astro in depth
+- [Astro Themes](https://astro.build/themes/) — Discover more themes`,
+    },
+    {
+        patterns: [/推荐|文章|看什么|读什么|recommend/i],
+        zh: `以下是一些热门文章推荐：
+
+**入门系列：**
+- [快速上手：两种集成方式](/zh/posts/getting-started) — 搭建你的第一个博客
+- [如何添加新文章](/zh/posts/adding-new-post) — 内容创作指南
+- [预定义配色方案](/zh/posts/predefined-color-schemes) — 选一个你喜欢的主题色
+
+**技术深度：**
+- [如何在博客中使用 LaTeX 公式](/zh/posts/how-to-add-latex-equations-in-blog-posts) — 数学公式支持
+- [动态 OG 图片生成](/zh/posts/dynamic-og-images) — 自动生成社交分享图
+
+你对哪个方向的内容更感兴趣？我可以做更精准的推荐。`,
+        en: `Here are some recommended articles:
+
+**Getting Started:**
+- [Getting Started: Two Integration Methods](/en/posts/getting-started) — Build your first blog
+- [Adding New Posts](/en/posts/adding-new-post) — Content creation guide
+- [Predefined Color Schemes](/en/posts/predefined-color-schemes) — Pick your favorite theme color
+
+**Technical Deep Dives:**
+- [LaTeX Equations in Blog Posts](/en/posts/how-to-add-latex-equations-in-blog-posts) — Math formula support
+- [Dynamic OG Images](/en/posts/dynamic-og-images) — Auto-generate social share images
+
+What direction interests you more? I can provide more specific recommendations.`,
+    },
+    {
+        patterns: [/博客|blog|功能|feature/i],
+        zh: `这个博客基于 **astro-minimax** 主题，功能丰富：
+
+核心功能：Markdown/MDX、代码高亮、[数学公式(KaTeX)](/zh/posts/how-to-add-latex-equations-in-blog-posts)、[Mermaid 图表](/zh/posts/mermaid-diagrams)、标签分类、全文搜索(Pagefind)、[Waline 评论](https://waline.js.org)、深色模式。
+
+了解更多：
+- [配置指南](/zh/posts/how-to-configure-astro-minimax-theme) — 完整配置选项
+- [Markdown 扩展语法](/zh/posts/markdown-extended) — 所有支持的语法特性
+
+开源地址：[souloss/astro-minimax](https://github.com/souloss/astro-minimax)`,
+        en: `This blog uses the **astro-minimax** theme with rich features:
+
+Core features: Markdown/MDX, syntax highlighting, [math equations (KaTeX)](/en/posts/how-to-add-latex-equations-in-blog-posts), [Mermaid diagrams](/en/posts/mermaid-diagrams), tags & categories, full-text search (Pagefind), [Waline comments](https://waline.js.org), dark mode.
+
+Learn more:
+- [Configuration Guide](/en/posts/how-to-configure-astro-minimax-theme) — Full config options
+- [Extended Markdown](/en/posts/markdown-extended) — All supported syntax features
+
+Open source: [souloss/astro-minimax](https://github.com/souloss/astro-minimax)`,
+    },
+    {
+        patterns: [/主题|theme|暗色|dark|颜色|color|配色/i],
+        zh: `博客支持亮色和暗色主题，右下角按钮即可切换，也会自动检测系统偏好。
+
+配色方案可以在配置中自定义，目前提供多种预设：
+- [预定义配色方案](/zh/posts/predefined-color-schemes) — 查看所有可用配色
+- [自定义主题色](/zh/posts/customizing-astro-minimax-theme-color-schemes) — 创建你自己的配色
+
+参考 [Tailwind CSS 调色板](https://tailwindcss.com/docs/customizing-colors) 获取灵感。`,
+        en: `The blog supports light and dark themes — toggle with the bottom-right button or auto-detect system preference.
+
+Color schemes are customizable:
+- [Predefined Color Schemes](/en/posts/predefined-color-schemes) — See all available schemes
+- [Custom Theme Colors](/en/posts/customizing-astro-minimax-theme-color-schemes) — Create your own
+
+Check [Tailwind CSS Color Palette](https://tailwindcss.com/docs/customizing-colors) for inspiration.`,
+    },
+    {
+        patterns: [/搭建|部署|deploy|build|install|安装|搭/i],
+        zh: `搭建类似的博客非常简单！有两种方式：
+
+1. **GitHub 模板**（推荐新手）— 一键 Fork，开箱即用
+2. **NPM 包集成** — 适合内容与系统分离的进阶用法
+
+详细步骤请看 [快速上手](/zh/posts/getting-started)。
+
+部署推荐 [Cloudflare Pages](https://pages.cloudflare.com)（免费、全球 CDN），也支持 [Vercel](https://vercel.com) 和 [Netlify](https://netlify.com)。`,
+        en: `Setting up a similar blog is easy! Two methods:
+
+1. **GitHub Template** (recommended for beginners) — One-click fork, ready to use
+2. **NPM Package Integration** — For advanced content/system separation
+
+See [Getting Started](/en/posts/getting-started) for detailed steps.
+
+Deploy with [Cloudflare Pages](https://pages.cloudflare.com) (free, global CDN), or [Vercel](https://vercel.com) / [Netlify](https://netlify.com).`,
+    },
+    {
+        patterns: [/rust/i],
+        zh: `博客中有一系列 Rust 文章：
+- [Rust 入门介绍](/zh/posts/rust-series-01-introduction) — 语言基础
+- [所有权系统](/zh/posts/rust-series-02-ownership) — Rust 核心概念
+- [错误处理](/zh/posts/rust-series-03-error-handling) — Result 和 Option
+- [并发编程](/zh/posts/rust-series-04-concurrency) — 安全的多线程
+
+外部学习资源：
+- [The Rust Book](https://doc.rust-lang.org/book/) — 官方教程
+- [Rust by Example](https://doc.rust-lang.org/rust-by-example/) — 实例学习`,
+        en: `The blog has a Rust series:
+- [Rust Introduction](/en/posts/rust-series-01-introduction) — Language basics
+- [Ownership System](/en/posts/rust-series-02-ownership) — Core Rust concept
+- [Error Handling](/en/posts/rust-series-03-error-handling) — Result and Option
+- [Concurrency](/en/posts/rust-series-04-concurrency) — Safe multithreading
+
+External resources:
+- [The Rust Book](https://doc.rust-lang.org/book/) — Official tutorial
+- [Rust by Example](https://doc.rust-lang.org/rust-by-example/) — Learn by examples`,
+    },
+    {
+        patterns: [/ai|人工智能|助手|assistant|chat/i],
+        zh: `我是这个博客的 AI 助手！当前运行在 Demo 模式，可以：
+- 根据你的问题推荐相关博客文章
+- 推荐有用的外部学习资源
+- 解答关于博客技术栈的问题
+
+启用完整 AI 功能（RAG 搜索增强）需要配置 \`AI_BASE_URL\` 和 \`AI_API_KEY\` 环境变量。
+
+试试问我："有哪些文章推荐？" 或 "怎么搭建类似的博客？"`,
+        en: `I'm the blog AI assistant! Currently in Demo mode, I can:
+- Recommend relevant blog articles based on your questions
+- Suggest useful external learning resources
+- Answer questions about the blog's tech stack
+
+For full AI features (RAG search enhancement), configure \`AI_BASE_URL\` and \`AI_API_KEY\` environment variables.
+
+Try asking: "Recommend some articles?" or "How to build a similar blog?"`,
+    },
+    {
+        patterns: [/搜索|search|pagefind/i],
+        zh: `博客集成了 [Pagefind](https://pagefind.app) 全文搜索引擎，构建时自动索引。点击页面顶部搜索图标即可使用。
+
+了解更多搜索功能：
+- [Pagefind 官方文档](https://pagefind.app/docs/) — 完整配置指南
+- 搜索支持中文和英文内容`,
+        en: `The blog integrates [Pagefind](https://pagefind.app) for full-text search, auto-indexed at build time. Click the search icon at the top to use it.
+
+Learn more:
+- [Pagefind Documentation](https://pagefind.app/docs/) — Complete configuration guide
+- Search supports both Chinese and English content`,
+    },
+    {
+        patterns: [/markdown|mdx|语法|syntax|公式|latex|mermaid|图表/i],
+        zh: `博客支持丰富的内容语法：
+
+- [Markdown 基础语法](/zh/posts/markdown-basics) — 标题、列表、表格等
+- [Markdown 扩展语法](/zh/posts/markdown-extended) — 脚注、高亮、折叠等
+- [LaTeX 数学公式](/zh/posts/how-to-add-latex-equations-in-blog-posts) — KaTeX 渲染
+- [Mermaid 图表](/zh/posts/mermaid-diagrams) — 流程图、时序图
+- [Markmap 思维导图](/zh/posts/markmap-mindmaps) — 交互式思维导图
+
+外部参考：[GitHub Flavored Markdown](https://github.github.com/gfm/)`,
+        en: `The blog supports rich content syntax:
+
+- [Markdown Basics](/en/posts/markdown-basics) — Headings, lists, tables
+- [Extended Markdown](/en/posts/markdown-extended) — Footnotes, highlights, collapsible
+- [LaTeX Equations](/en/posts/how-to-add-latex-equations-in-blog-posts) — KaTeX rendering
+- [Mermaid Diagrams](/en/posts/mermaid-diagrams) — Flowcharts, sequence diagrams
+- [Markmap Mind Maps](/en/posts/markmap-mindmaps) — Interactive mind maps
+
+Reference: [GitHub Flavored Markdown](https://github.github.com/gfm/)`,
+    },
+];
+const FALLBACK = {
+    zh: `感谢提问！我目前在 Demo 模式下，可以推荐博客文章和外部资源。
+
+试试这些话题：
+- "有哪些文章推荐？"
+- "Astro 框架是什么？"
+- "怎么搭建类似的博客？"
+- "支持哪些 Markdown 语法？"`,
+    en: `Thanks for asking! I'm in Demo mode and can recommend blog articles and external resources.
+
+Try these topics:
+- "Recommend some articles?"
+- "What is Astro?"
+- "How to build a similar blog?"
+- "What Markdown syntax is supported?"`,
+};
+/**
+ * Returns a mock response with Markdown links for article/external link recommendations.
+ */
+export function getMockResponse(question, lang = 'zh') {
+    const q = question.toLowerCase();
+    const isZh = lang !== 'en';
+    for (const { patterns, zh, en } of MOCK_RESPONSES) {
+        if (patterns.some(p => p.test(q))) {
+            return isZh ? zh : en;
+        }
+    }
+    return isZh ? FALLBACK.zh : FALLBACK.en;
+}
+/**
+ * Creates a ReadableStream that simulates character-by-character streaming.
+ */
+export function createMockStream(text) {
+    let index = 0;
+    return new ReadableStream({
+        async pull(controller) {
+            if (index >= text.length) {
+                controller.close();
+                return;
+            }
+            const chunkSize = Math.random() < 0.3 ? 2 : 1;
+            const chunk = text.slice(index, index + chunkSize);
+            index += chunkSize;
+            controller.enqueue(chunk);
+            await new Promise(resolve => setTimeout(resolve, 12 + Math.random() * 23));
+        },
+    });
+}

package/dist/search/index.d.ts

@@ -0,0 +1,5 @@
+export { initArticleIndex, initProjectIndex, searchArticles, searchProjects, mergeResults } from './search-api.js';
+export { getSessionCacheKey, getCachedContext, setCachedContext, deleteCachedContext, setCacheAdapter, getCacheAdapter, cleanupCache, SESSION_CACHE_TTL_SECONDS, SESSION_CACHE_TTL_MS, getCachedContextSync, setCachedContextSync, cleanupCacheLegacy, } from './session-cache.js';
+export { normalizeText, tokenize, scoreDocument } from './search-utils.js';
+export type { SearchDocument, ArticleContext, ProjectContext, CachedSearchContext, SearchResult } from './types.js';
+//# sourceMappingURL=index.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/search/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,gBAAgB,EAAE,gBAAgB,EAAE,cAAc,EAAE,cAAc,EAAE,YAAY,EAAE,MAAM,iBAAiB,CAAC;AACnH,OAAO,EACL,kBAAkB,EAClB,gBAAgB,EAChB,gBAAgB,EAChB,mBAAmB,EACnB,eAAe,EACf,eAAe,EACf,YAAY,EACZ,yBAAyB,EACzB,oBAAoB,EACpB,oBAAoB,EACpB,oBAAoB,EACpB,kBAAkB,GACnB,MAAM,oBAAoB,CAAC;AAC5B,OAAO,EAAE,aAAa,EAAE,QAAQ,EAAE,aAAa,EAAE,MAAM,mBAAmB,CAAC;AAC3E,YAAY,EAAE,cAAc,EAAE,cAAc,EAAE,cAAc,EAAE,mBAAmB,EAAE,YAAY,EAAE,MAAM,YAAY,CAAC"}

package/dist/search/index.js

@@ -0,0 +1,3 @@
+export { initArticleIndex, initProjectIndex, searchArticles, searchProjects, mergeResults } from './search-api.js';
+export { getSessionCacheKey, getCachedContext, setCachedContext, deleteCachedContext, setCacheAdapter, getCacheAdapter, cleanupCache, SESSION_CACHE_TTL_SECONDS, SESSION_CACHE_TTL_MS, getCachedContextSync, setCachedContextSync, cleanupCacheLegacy, } from './session-cache.js';
+export { normalizeText, tokenize, scoreDocument } from './search-utils.js';

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

@@ -0,0 +1,28 @@
+import type { SearchDocument, ArticleContext, ProjectContext } from './types.js';
+/**
+ * Initializes the article search index from the provided documents.
+ * Should be called once at startup (e.g., when the edge function initializes).
+ */
+export declare function initArticleIndex(documents: SearchDocument[]): void;
+export declare function initProjectIndex(documents: SearchDocument[]): void;
+/**
+ * Searches for articles related to the query.
+ * Returns enriched ArticleContext objects ready for prompt injection.
+ */
+export declare function searchArticles(query: string, options?: {
+    enableDeepContent?: boolean;
+    siteUrl?: string;
+}): ArticleContext[];
+/**
+ * Searches for projects related to the query.
+ */
+export declare function searchProjects(query: string, options?: {
+    siteUrl?: string;
+}): ProjectContext[];
+/**
+ * Merges two result arrays by URL, preferring items from the primary array.
+ */
+export declare function mergeResults<T extends {
+    url: string;
+}>(primary: T[], secondary: T[]): T[];
+//# sourceMappingURL=search-api.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"search-api.d.ts","sourceRoot":"","sources":["../../src/search/search-api.ts"],"names":[],"mappings":"AAEA,OAAO,KAAK,EAAE,cAAc,EAAiC,cAAc,EAAE,cAAc,EAAE,MAAM,YAAY,CAAC;AAYhH;;;GAGG;AACH,wBAAgB,gBAAgB,CAAC,SAAS,EAAE,cAAc,EAAE,GAAG,IAAI,CAElE;AAED,wBAAgB,gBAAgB,CAAC,SAAS,EAAE,cAAc,EAAE,GAAG,IAAI,CAElE;AAED;;;GAGG;AACH,wBAAgB,cAAc,CAC5B,KAAK,EAAE,MAAM,EACb,OAAO,GAAE;IAAE,iBAAiB,CAAC,EAAE,OAAO,CAAC;IAAC,OAAO,CAAC,EAAE,MAAM,CAAA;CAAO,GAC9D,cAAc,EAAE,CAqClB;AAED;;GAEG;AACH,wBAAgB,cAAc,CAC5B,KAAK,EAAE,MAAM,EACb,OAAO,GAAE;IAAE,OAAO,CAAC,EAAE,MAAM,CAAA;CAAO,GACjC,cAAc,EAAE,CAelB;AAED;;GAEG;AACH,wBAAgB,YAAY,CAAC,CAAC,SAAS;IAAE,GAAG,EAAE,MAAM,CAAA;CAAE,EAAE,OAAO,EAAE,CAAC,EAAE,EAAE,SAAS,EAAE,CAAC,EAAE,GAAG,CAAC,EAAE,CAUzF"}

package/dist/search/search-api.js

@@ -0,0 +1,110 @@
+import { scoreDocument, filterLowRelevance, tokenize, pickAnchorTerms, normalizeText } from './search-utils.js';
+import { buildSearchIndex } from './search-index.js';
+// Lazy-initialized, cached indexes
+let articleIndex = null;
+let projectIndex = null;
+const ARTICLE_LIMIT = 10;
+const ARTICLE_LIMIT_BROAD = 20;
+const PROJECT_LIMIT = 5;
+const DEEP_CONTENT_SCORE_THRESHOLD = 8;
+const DEEP_CONTENT_MAX_LENGTH = 1500;
+/**
+ * Initializes the article search index from the provided documents.
+ * Should be called once at startup (e.g., when the edge function initializes).
+ */
+export function initArticleIndex(documents) {
+    articleIndex = buildSearchIndex(documents);
+}
+export function initProjectIndex(documents) {
+    projectIndex = buildSearchIndex(documents);
+}
+/**
+ * Searches for articles related to the query.
+ * Returns enriched ArticleContext objects ready for prompt injection.
+ */
+export function searchArticles(query, options = {}) {
+    if (!query.trim() || !articleIndex)
+        return [];
+    const tokens = tokenize(query);
+    if (!tokens.length)
+        return [];
+    const limit = tokens.length <= 2 ? ARTICLE_LIMIT_BROAD : ARTICLE_LIMIT;
+    const rawResults = scoreDocs(articleIndex, tokens, limit * 2);
+    const filtered = applyAnchorFilter(rawResults, query, tokens);
+    const deduplicated = filterLowRelevance(filtered.length > 0 ? filtered : rawResults);
+    const results = deduplicated.slice(0, limit);
+    const topScore = results[0]?.score ?? 0;
+    const secondScore = results[1]?.score ?? 0;
+    const isDeepHit = options.enableDeepContent &&
+        topScore >= DEEP_CONTENT_SCORE_THRESHOLD &&
+        topScore > secondScore * 1.5;
+    return results.map((result, index) => {
+        const baseUrl = options.siteUrl ?? '';
+        const url = result.url.startsWith('http') ? result.url : `${baseUrl}${result.url}`;
+        const fullContent = isDeepHit && index === 0 && result.content
+            ? result.content.slice(0, DEEP_CONTENT_MAX_LENGTH)
+            : undefined;
+        return {
+            title: result.title,
+            url,
+            summary: result.summary ?? result.excerpt,
+            keyPoints: result.keyPoints,
+            categories: result.categories,
+            dateTime: result.dateTime,
+            fullContent,
+        };
+    });
+}
+/**
+ * Searches for projects related to the query.
+ */
+export function searchProjects(query, options = {}) {
+    if (!query.trim() || !projectIndex)
+        return [];
+    const tokens = tokenize(query);
+    if (!tokens.length)
+        return [];
+    const rawResults = scoreDocs(projectIndex, tokens, PROJECT_LIMIT * 2);
+    if (!rawResults.length)
+        return [];
+    const baseUrl = options.siteUrl ?? '';
+    return rawResults.slice(0, PROJECT_LIMIT).map(r => ({
+        name: r.title,
+        url: r.url.startsWith('http') ? r.url : `${baseUrl}${r.url}`,
+        description: r.excerpt || r.content.slice(0, 200),
+    }));
+}
+/**
+ * Merges two result arrays by URL, preferring items from the primary array.
+ */
+export function mergeResults(primary, secondary) {
+    const seen = new Set(primary.map(i => i.url));
+    const merged = [...primary];
+    for (const item of secondary) {
+        if (!seen.has(item.url)) {
+            seen.add(item.url);
+            merged.push(item);
+        }
+    }
+    return merged;
+}
+// ---- Internals ----
+function scoreDocs(index, tokens, limit) {
+    return index
+        .map(doc => ({ ...doc, score: scoreDocument(tokens, doc) }))
+        .filter(doc => doc.score > 0)
+        .sort((a, b) => b.score - a.score)
+        .slice(0, limit);
+}
+function applyAnchorFilter(results, query, tokens) {
+    if (tokens.length > 2)
+        return results;
+    const anchorTerms = pickAnchorTerms(query, results, 2, 2);
+    if (!anchorTerms.length)
+        return results;
+    const strict = results.filter(r => {
+        const text = normalizeText([r.title, ...r.keyPoints, ...r.categories].join(' '));
+        return anchorTerms.some(term => text.includes(term));
+    });
+    return strict.length > 0 ? strict : results;
+}

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

@@ -0,0 +1,6 @@
+import type { SearchDocument, IndexedDocument } from './types.js';
+/**
+ * Builds an in-memory inverted index from a list of documents.
+ */
+export declare function buildSearchIndex(documents: SearchDocument[]): IndexedDocument[];
+//# sourceMappingURL=search-index.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"search-index.d.ts","sourceRoot":"","sources":["../../src/search/search-index.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EAAE,cAAc,EAAE,eAAe,EAAE,MAAM,YAAY,CAAC;AAElE;;GAEG;AACH,wBAAgB,gBAAgB,CAAC,SAAS,EAAE,cAAc,EAAE,GAAG,eAAe,EAAE,CAK/E"}

package/dist/search/search-index.js

@@ -0,0 +1,22 @@
+import { normalizeText } from './search-utils.js';
+/**
+ * Builds an in-memory inverted index from a list of documents.
+ */
+export function buildSearchIndex(documents) {
+    return documents.map(doc => ({
+        ...doc,
+        tokens: buildDocumentTokens(doc),
+    }));
+}
+function buildDocumentTokens(doc) {
+    const parts = [
+        doc.title,
+        doc.excerpt,
+        doc.content.slice(0, 1000),
+        ...doc.keyPoints,
+        ...doc.categories,
+        ...doc.tags,
+        doc.summary ?? '',
+    ];
+    return [...new Set(parts.map(normalizeText).join(' ').split(/\s+/).filter(Boolean))];
+}

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

@@ -0,0 +1,43 @@
+/**
+ * Text normalization and tokenization utilities for search.
+ */
+/**
+ * Normalizes text for search: lowercase, remove punctuation, normalize whitespace.
+ */
+export declare function normalizeText(text: string): string;
+/**
+ * Splits a query into normalized tokens (handles both Chinese and Latin text).
+ */
+export declare function tokenize(text: string): string[];
+/**
+ * Removes tokens that are substrings of longer tokens (avoids redundant matching).
+ */
+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.
+ */
+export declare function scoreDocument(tokens: string[], doc: {
+    title: string;
+    content: string;
+    excerpt: string;
+    keyPoints: string[];
+    categories: string[];
+    tags: string[];
+}): number;
+/**
+ * Filters out low-relevance results relative to the top score.
+ */
+export declare function filterLowRelevance<T extends {
+    score: number;
+}>(results: T[], relativeThreshold?: number, minAbsoluteScore?: number): T[];
+/**
+ * Selects the best "anchor terms" from the query — terms that are specific
+ * enough to be meaningful but appear in enough results to be useful.
+ */
+export declare function pickAnchorTerms(query: string, candidates: Array<{
+    title: string;
+    keyPoints: string[];
+    categories: string[];
+}>, maxTerms?: number, minTermLength?: number): string[];
+//# sourceMappingURL=search-utils.d.ts.map

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

@@ -0,0 +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"}

package/dist/search/search-utils.js

@@ -0,0 +1,114 @@
+/**
+ * Text normalization and tokenization utilities for search.
+ */
+/**
+ * Normalizes text for search: lowercase, remove punctuation, normalize whitespace.
+ */
+export function normalizeText(text) {
+    return text
+        .toLowerCase()
+        .replace(/[^\u4e00-\u9fa5\w\s]/g, ' ')
+        .replace(/\s+/g, ' ')
+        .trim();
+}
+/**
+ * Splits a query into normalized tokens (handles both Chinese and Latin 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);
+}
+/**
+ * Removes tokens that are substrings of longer tokens (avoids redundant matching).
+ */
+export function dedupeByContainment(terms) {
+    const unique = [...new Set(terms)];
+    const kept = [];
+    for (const term of unique.sort((a, b) => b.length - a.length)) {
+        if (!kept.some(existing => existing.includes(term))) {
+            kept.push(term);
+        }
+    }
+    return kept;
+}
+/**
+ * Computes a relevance score for a document against a set of query tokens.
+ * Title matches score higher than content matches.
+ */
+export function scoreDocument(tokens, doc) {
+    if (!tokens.length)
+        return 0;
+    let score = 0;
+    const title = normalizeText(doc.title);
+    const excerpt = normalizeText(doc.excerpt);
+    const keyPointsText = normalizeText(doc.keyPoints.join(' '));
+    const categoriesText = normalizeText(doc.categories.join(' '));
+    const tagsText = normalizeText(doc.tags.join(' '));
+    const contentSample = normalizeText(doc.content.slice(0, 500));
+    for (const token of tokens) {
+        if (!token)
+            continue;
+        // Title: highest weight
+        if (title.includes(token))
+            score += 8;
+        // KeyPoints: high weight
+        if (keyPointsText.includes(token))
+            score += 5;
+        // Categories/tags: medium weight
+        if (categoriesText.includes(token))
+            score += 4;
+        if (tagsText.includes(token))
+            score += 3;
+        // Excerpt: medium weight
+        if (excerpt.includes(token))
+            score += 3;
+        // Content sample: low weight
+        if (contentSample.includes(token))
+            score += 1;
+    }
+    return score;
+}
+/**
+ * Filters out low-relevance results relative to the top score.
+ */
+export function filterLowRelevance(results, relativeThreshold = 0.35, minAbsoluteScore = 2) {
+    if (results.length <= 3)
+        return results;
+    const topScore = results[0]?.score ?? 0;
+    if (topScore <= 0)
+        return results;
+    const threshold = Math.max(minAbsoluteScore, topScore * relativeThreshold);
+    return results.filter((item, index) => index < 3 || item.score >= threshold);
+}
+/**
+ * Selects the best "anchor terms" from the query — terms that are specific
+ * enough to be meaningful but appear in enough results to be useful.
+ */
+export function pickAnchorTerms(query, candidates, maxTerms = 2, minTermLength = 2) {
+    const terms = tokenize(query).filter(t => t.length >= minTermLength);
+    if (terms.length <= maxTerms)
+        return terms.slice(0, maxTerms);
+    if (!candidates.length)
+        return terms.slice(0, maxTerms);
+    const scored = terms.map(term => {
+        let hitCount = 0;
+        for (const c of candidates) {
+            const text = normalizeText([c.title, ...c.keyPoints, ...c.categories].join(' '));
+            if (text.includes(term))
+                hitCount++;
+        }
+        if (hitCount <= 0)
+            return { term, score: Number.NEGATIVE_INFINITY };
+        const coverage = hitCount / candidates.length;
+        const specificity = 1 - coverage;
+        const lengthScore = Math.min(term.length, 8) / 8;
+        return { term, score: specificity * 2 + lengthScore };
+    });
+    return scored
+        .filter(s => Number.isFinite(s.score))
+        .sort((a, b) => b.score - a.score)
+        .map(s => s.term)
+        .slice(0, maxTerms);
+}

package/dist/search/session-cache.d.ts

@@ -0,0 +1,19 @@
+import type { CacheAdapter } from '../cache/types.js';
+import type { CachedSearchContext } from './types.js';
+export { type CachedSearchContext, type ArticleContext, type ProjectContext } from './types.js';
+export declare const SESSION_CACHE_TTL_SECONDS = 600;
+export declare const SESSION_CACHE_TTL_MS: number;
+export declare function getSessionCacheKey(req: Request): string | null;
+export declare function setCacheAdapter(cache: CacheAdapter): void;
+export declare function getCacheAdapter(): CacheAdapter;
+export declare function getCachedContext(key: string, cache?: CacheAdapter): Promise<CachedSearchContext | undefined>;
+export declare function setCachedContext(key: string, ctx: CachedSearchContext, cache?: CacheAdapter): Promise<void>;
+export declare function deleteCachedContext(key: string, cache?: CacheAdapter): Promise<boolean>;
+export declare function cleanupCache(_now: number): void;
+/** @deprecated Use getCachedContext instead */
+export declare function getCachedContextSync(key: string): CachedSearchContext | undefined;
+/** @deprecated Use setCachedContext instead */
+export declare function setCachedContextSync(key: string, ctx: CachedSearchContext): void;
+/** @deprecated Use cleanupCache instead (no-op) */
+export declare function cleanupCacheLegacy(now: number): void;
+//# sourceMappingURL=session-cache.d.ts.map

package/dist/search/session-cache.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"session-cache.d.ts","sourceRoot":"","sources":["../../src/search/session-cache.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,mBAAmB,CAAC;AACtD,OAAO,KAAK,EAAE,mBAAmB,EAAkC,MAAM,YAAY,CAAC;AAGtF,OAAO,EAAE,KAAK,mBAAmB,EAAE,KAAK,cAAc,EAAE,KAAK,cAAc,EAAE,MAAM,YAAY,CAAC;AAGhG,eAAO,MAAM,yBAAyB,MAAM,CAAC;AAC7C,eAAO,MAAM,oBAAoB,QAAmC,CAAC;AAcrE,wBAAgB,kBAAkB,CAAC,GAAG,EAAE,OAAO,GAAG,MAAM,GAAG,IAAI,CAM9D;AAED,wBAAgB,eAAe,CAAC,KAAK,EAAE,YAAY,GAAG,IAAI,CAEzD;AAED,wBAAgB,eAAe,IAAI,YAAY,CAE9C;AAED,wBAAsB,gBAAgB,CACpC,GAAG,EAAE,MAAM,EACX,KAAK,CAAC,EAAE,YAAY,GACnB,OAAO,CAAC,mBAAmB,GAAG,SAAS,CAAC,CAI1C;AAED,wBAAsB,gBAAgB,CACpC,GAAG,EAAE,MAAM,EACX,GAAG,EAAE,mBAAmB,EACxB,KAAK,CAAC,EAAE,YAAY,GACnB,OAAO,CAAC,IAAI,CAAC,CAGf;AAED,wBAAsB,mBAAmB,CACvC,GAAG,EAAE,MAAM,EACX,KAAK,CAAC,EAAE,YAAY,GACnB,OAAO,CAAC,OAAO,CAAC,CAGlB;AAED,wBAAgB,YAAY,CAAC,IAAI,EAAE,MAAM,GAAG,IAAI,CAG/C;AAQD,+CAA+C;AAC/C,wBAAgB,oBAAoB,CAAC,GAAG,EAAE,MAAM,GAAG,mBAAmB,GAAG,SAAS,CASjF;AAED,+CAA+C;AAC/C,wBAAgB,oBAAoB,CAAC,GAAG,EAAE,MAAM,EAAE,GAAG,EAAE,mBAAmB,GAAG,IAAI,CAYhF;AAED,mDAAmD;AACnD,wBAAgB,kBAAkB,CAAC,GAAG,EAAE,MAAM,GAAG,IAAI,CAepD"}