@astro-minimax/ai 0.2.0

package/dist/intelligence/citation-guard.js

@@ -0,0 +1,82 @@
+/**
+ * Pre-flight check: if the user is asking about something that can be
+ * answered directly from the available context without an LLM, return it.
+ * This prevents hallucination for specific factual queries.
+ */
+export function getCitationGuardPreflight(params) {
+    const { userQuery, articles, projects } = params;
+    const q = userQuery.toLowerCase();
+    // Detect queries asking for article counts or lists
+    if (/有几篇|有多少篇|文章数量|总共.*文章/.test(q)) {
+        const total = articles.length;
+        if (total > 0) {
+            return {
+                text: `根据我检索到的信息，当前共找到 ${total} 篇相关文章。`,
+                actions: ['preflight_reject'],
+            };
+        }
+    }
+    // Detect queries about specific article existence that we can verify
+    if (/有没有|是否有|有.*文章|写过.*吗/.test(q)) {
+        if (articles.length === 0 && projects.length === 0) {
+            return {
+                text: '根据博客内容搜索，目前没有找到与这个主题直接相关的文章。你可以尝试用其他关键词搜索，或者问我其他问题。',
+                actions: ['preflight_reject'],
+            };
+        }
+    }
+    return null;
+}
+/**
+ * Creates a transform stream that monitors the AI output for hallucinated references.
+ * Rewrites or suppresses fabricated article/project links.
+ */
+export function createCitationGuardTransform(params) {
+    const { articles, projects, onApplied } = params;
+    const validUrls = new Set([
+        ...articles.map(a => a.url),
+        ...projects.map(p => p.url),
+    ]);
+    return (stream) => {
+        const actions = [];
+        let buffer = '';
+        const transform = new TransformStream({
+            transform(chunk, controller) {
+                buffer += chunk;
+                // Check for Markdown links: [text](url)
+                const linkPattern = /\[([^\]]+)\]\(([^)]+)\)/g;
+                let match;
+                let lastIndex = 0;
+                let output = '';
+                while ((match = linkPattern.exec(buffer)) !== null) {
+                    const [fullMatch, text, url] = match;
+                    output += buffer.slice(lastIndex, match.index);
+                    if (url.startsWith('http') && !validUrls.has(url)) {
+                        // Fabricated external URL — keep the text, remove the link
+                        output += text;
+                        actions.push('stream_rewrite');
+                    }
+                    else {
+                        output += fullMatch;
+                    }
+                    lastIndex = match.index + fullMatch.length;
+                }
+                // Keep unparsed remainder in buffer (may be mid-link)
+                buffer = buffer.slice(lastIndex);
+                if (output) {
+                    controller.enqueue(output);
+                }
+            },
+            flush(controller) {
+                if (buffer) {
+                    controller.enqueue(buffer);
+                    buffer = '';
+                }
+                if (actions.length > 0) {
+                    onApplied?.({ actions });
+                }
+            },
+        });
+        return stream.pipeThrough(transform);
+    };
+}

package/dist/intelligence/evidence-analysis.d.ts

@@ -0,0 +1,29 @@
+import type { ArticleContext, ProjectContext } from '../search/types.js';
+import type { EvidenceAnalysisResult, QueryComplexity } from './types.js';
+export declare const EVIDENCE_ANALYSIS_TIMEOUT_MS = 8000;
+export declare const EVIDENCE_ANALYSIS_MAX_TOKENS = 360;
+/**
+ * Determines whether evidence analysis should be skipped.
+ * Skips for simple queries or when there's insufficient content to analyze.
+ */
+export declare function shouldSkipAnalysis(latestText: string, articleCount: number, complexity: QueryComplexity): boolean;
+/**
+ * Uses an LLM to pre-analyze retrieved evidence and identify the most relevant pieces.
+ * This improves the quality of the final system prompt by pre-filtering noise.
+ */
+export declare function analyzeRetrievedEvidence(params: {
+    userQuery: string;
+    articles: ArticleContext[];
+    projects: ProjectContext[];
+    provider: {
+        chatModel: (model: string) => unknown;
+    };
+    model: string;
+    maxOutputTokens?: number;
+    abortSignal?: AbortSignal;
+}): Promise<EvidenceAnalysisResult>;
+/**
+ * Formats the evidence analysis for injection into the system prompt.
+ */
+export declare function buildEvidenceSection(analysis: string): string;
+//# sourceMappingURL=evidence-analysis.d.ts.map

package/dist/intelligence/evidence-analysis.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"evidence-analysis.d.ts","sourceRoot":"","sources":["../../src/intelligence/evidence-analysis.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EAAE,cAAc,EAAE,cAAc,EAAE,MAAM,oBAAoB,CAAC;AACzE,OAAO,KAAK,EAAE,sBAAsB,EAAE,eAAe,EAAE,MAAM,YAAY,CAAC;AAE1E,eAAO,MAAM,4BAA4B,OAAO,CAAC;AACjD,eAAO,MAAM,4BAA4B,MAAM,CAAC;AAEhD;;;GAGG;AACH,wBAAgB,kBAAkB,CAChC,UAAU,EAAE,MAAM,EAClB,YAAY,EAAE,MAAM,EACpB,UAAU,EAAE,eAAe,GAC1B,OAAO,CAKT;AAED;;;GAGG;AACH,wBAAsB,wBAAwB,CAAC,MAAM,EAAE;IACrD,SAAS,EAAE,MAAM,CAAC;IAClB,QAAQ,EAAE,cAAc,EAAE,CAAC;IAC3B,QAAQ,EAAE,cAAc,EAAE,CAAC;IAC3B,QAAQ,EAAE;QAAE,SAAS,EAAE,CAAC,KAAK,EAAE,MAAM,KAAK,OAAO,CAAA;KAAE,CAAC;IACpD,KAAK,EAAE,MAAM,CAAC;IACd,eAAe,CAAC,EAAE,MAAM,CAAC;IACzB,WAAW,CAAC,EAAE,WAAW,CAAC;CAC3B,GAAG,OAAO,CAAC,sBAAsB,CAAC,CAiDlC;AAED;;GAEG;AACH,wBAAgB,oBAAoB,CAAC,QAAQ,EAAE,MAAM,GAAG,MAAM,CAG7D"}

package/dist/intelligence/evidence-analysis.js

@@ -0,0 +1,88 @@
+import { generateText } from 'ai';
+export const EVIDENCE_ANALYSIS_TIMEOUT_MS = 8000;
+export const EVIDENCE_ANALYSIS_MAX_TOKENS = 360;
+/**
+ * Determines whether evidence analysis should be skipped.
+ * Skips for simple queries or when there's insufficient content to analyze.
+ */
+export function shouldSkipAnalysis(latestText, articleCount, complexity) {
+    if (articleCount < 2)
+        return true;
+    if (complexity === 'simple')
+        return true;
+    if (latestText.length < 15)
+        return true;
+    return false;
+}
+/**
+ * Uses an LLM to pre-analyze retrieved evidence and identify the most relevant pieces.
+ * This improves the quality of the final system prompt by pre-filtering noise.
+ */
+export async function analyzeRetrievedEvidence(params) {
+    const { userQuery, articles, projects, provider, model, maxOutputTokens = EVIDENCE_ANALYSIS_MAX_TOKENS, abortSignal } = params;
+    const evidenceSummary = buildEvidenceSummary(articles, projects);
+    const prompt = `用户问题：${userQuery}
+
+检索到的相关内容：
+${evidenceSummary}
+
+请分析这些内容，提取与用户问题最相关的2-3个关键信息点。格式：
+<evidence>
+[关键信息点1]
+[关键信息点2]
+</evidence>
+
+只返回evidence标签内的内容，简洁准确。`;
+    try {
+        const result = await generateText({
+            // eslint-disable-next-line @typescript-eslint/no-explicit-any
+            model: provider.chatModel(model),
+            prompt,
+            maxOutputTokens,
+            temperature: 0.1,
+            abortSignal,
+        });
+        const rawText = result.text?.trim() ?? '';
+        const match = rawText.match(/<evidence>([\s\S]*?)<\/evidence>/);
+        const analysis = match?.[1]?.trim();
+        const u = result.usage;
+        return {
+            analysis,
+            parseStatus: analysis ? 'ok' : 'no_match',
+            rawText,
+            usage: u ? {
+                inputTokens: u.inputTokens ?? 0,
+                outputTokens: u.outputTokens ?? 0,
+                totalTokens: (u.inputTokens ?? 0) + (u.outputTokens ?? 0),
+            } : undefined,
+        };
+    }
+    catch (error) {
+        return {
+            parseStatus: 'error',
+            error: error instanceof Error ? error.message : String(error),
+        };
+    }
+}
+/**
+ * Formats the evidence analysis for injection into the system prompt.
+ */
+export function buildEvidenceSection(analysis) {
+    if (!analysis.trim())
+        return '';
+    return `\n## 关键证据分析\n${analysis}\n`;
+}
+function buildEvidenceSummary(articles, projects) {
+    const lines = [];
+    for (const article of articles.slice(0, 6)) {
+        lines.push(`文章: ${article.title}`);
+        if (article.summary)
+            lines.push(`  摘要: ${article.summary}`);
+        if (article.keyPoints.length)
+            lines.push(`  要点: ${article.keyPoints.slice(0, 3).join(', ')}`);
+    }
+    for (const project of projects.slice(0, 3)) {
+        lines.push(`项目: ${project.name} - ${project.description.slice(0, 100)}`);
+    }
+    return lines.join('\n');
+}

package/dist/intelligence/index.d.ts

@@ -0,0 +1,6 @@
+export { isLikelyFollowUp, hasNewSignificantTokens, hasQueryOverlap, shouldReuseSearchContext, buildLocalSearchQuery, } from './intent-detect.js';
+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, } from './citation-guard.js';
+export type { QueryComplexity, KeywordExtractionResult, TokenUsageStats, EvidenceAnalysisResult, CitationGuardPreflight, CitationGuardAction, } from './types.js';
+//# sourceMappingURL=index.d.ts.map

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

@@ -0,0 +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,GACtB,MAAM,oBAAoB,CAAC;AAE5B,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,GAC7B,MAAM,qBAAqB,CAAC;AAE7B,YAAY,EACV,eAAe,EACf,uBAAuB,EACvB,eAAe,EACf,sBAAsB,EACtB,sBAAsB,EACtB,mBAAmB,GACpB,MAAM,YAAY,CAAC"}

package/dist/intelligence/index.js

@@ -0,0 +1,4 @@
+export { isLikelyFollowUp, hasNewSignificantTokens, hasQueryOverlap, shouldReuseSearchContext, buildLocalSearchQuery, } from './intent-detect.js';
+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, } from './citation-guard.js';

package/dist/intelligence/intent-detect.d.ts

@@ -0,0 +1,29 @@
+import type { CachedSearchContext } from '../search/types.js';
+/**
+ * Determines if the latest message is likely a follow-up to the previous context.
+ * Uses heuristics: message length, punctuation, word count.
+ */
+export declare function isLikelyFollowUp(message: string): boolean;
+/**
+ * Checks whether the current query contains significant new tokens
+ * that aren't present in the cached query.
+ */
+export declare function hasNewSignificantTokens(currentQuery: string, cachedQuery: string): boolean;
+/**
+ * Checks whether the current query overlaps significantly with the cached query.
+ */
+export declare function hasQueryOverlap(currentQuery: string, cachedQuery: string): boolean;
+/**
+ * Determines whether to reuse the cached search context for this request.
+ */
+export declare function shouldReuseSearchContext(params: {
+    latestText: string;
+    cachedContext: CachedSearchContext | undefined;
+    userTurnCount: number;
+    now: number;
+}): boolean;
+/**
+ * Builds a normalized local search query from the latest message.
+ */
+export declare function buildLocalSearchQuery(latestText: string): string;
+//# sourceMappingURL=intent-detect.d.ts.map

package/dist/intelligence/intent-detect.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"intent-detect.d.ts","sourceRoot":"","sources":["../../src/intelligence/intent-detect.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EAAE,mBAAmB,EAAE,MAAM,oBAAoB,CAAC;AAK9D;;;GAGG;AACH,wBAAgB,gBAAgB,CAAC,OAAO,EAAE,MAAM,GAAG,OAAO,CAUzD;AAED;;;GAGG;AACH,wBAAgB,uBAAuB,CAAC,YAAY,EAAE,MAAM,EAAE,WAAW,EAAE,MAAM,GAAG,OAAO,CAK1F;AAED;;GAEG;AACH,wBAAgB,eAAe,CAAC,YAAY,EAAE,MAAM,EAAE,WAAW,EAAE,MAAM,GAAG,OAAO,CAKlF;AAED;;GAEG;AACH,wBAAgB,wBAAwB,CAAC,MAAM,EAAE;IAC/C,UAAU,EAAE,MAAM,CAAC;IACnB,aAAa,EAAE,mBAAmB,GAAG,SAAS,CAAC;IAC/C,aAAa,EAAE,MAAM,CAAC;IACtB,GAAG,EAAE,MAAM,CAAC;CACb,GAAG,OAAO,CASV;AAED;;GAEG;AACH,wBAAgB,qBAAqB,CAAC,UAAU,EAAE,MAAM,GAAG,MAAM,CAEhE"}

package/dist/intelligence/intent-detect.js

@@ -0,0 +1,64 @@
+import { tokenize, normalizeText } from '../search/search-utils.js';
+import { SESSION_CACHE_TTL_MS } from '../search/session-cache.js';
+const MAX_FOLLOW_UP_LENGTH = 48;
+/**
+ * Determines if the latest message is likely a follow-up to the previous context.
+ * Uses heuristics: message length, punctuation, word count.
+ */
+export function isLikelyFollowUp(message) {
+    const text = message.trim();
+    if (!text || text.length > MAX_FOLLOW_UP_LENGTH)
+        return false;
+    const hasTerminalPunctuation = /[?？!！。.…]$/.test(text);
+    const wordCount = text.split(/\s+/).filter(Boolean).length;
+    if (text.length <= 16)
+        return true;
+    if (!/\s/.test(text) && text.length <= 24)
+        return true;
+    return hasTerminalPunctuation && wordCount <= 6 && text.length <= 36;
+}
+/**
+ * Checks whether the current query contains significant new tokens
+ * that aren't present in the cached query.
+ */
+export function hasNewSignificantTokens(currentQuery, cachedQuery) {
+    const currentTokens = new Set(tokenize(currentQuery));
+    const cachedTokens = new Set(tokenize(cachedQuery));
+    const newTokens = [...currentTokens].filter(t => !cachedTokens.has(t) && t.length >= 2);
+    return newTokens.length > 0;
+}
+/**
+ * Checks whether the current query overlaps significantly with the cached query.
+ */
+export function hasQueryOverlap(currentQuery, cachedQuery) {
+    const currentTokens = tokenize(currentQuery);
+    const cachedNorm = normalizeText(cachedQuery);
+    if (!currentTokens.length || !cachedNorm)
+        return false;
+    return currentTokens.some(t => cachedNorm.includes(t));
+}
+/**
+ * Determines whether to reuse the cached search context for this request.
+ */
+export function shouldReuseSearchContext(params) {
+    const { latestText, cachedContext, userTurnCount, now } = params;
+    if (!cachedContext)
+        return false;
+    if (userTurnCount <= 1)
+        return false;
+    if (now - cachedContext.updatedAt > SESSION_CACHE_TTL_MS)
+        return false;
+    if (!isLikelyFollowUp(latestText))
+        return false;
+    if (!hasQueryOverlap(latestText, cachedContext.query))
+        return false;
+    if (hasNewSignificantTokens(latestText, cachedContext.query))
+        return false;
+    return true;
+}
+/**
+ * Builds a normalized local search query from the latest message.
+ */
+export function buildLocalSearchQuery(latestText) {
+    return tokenize(latestText).join(' ');
+}

package/dist/intelligence/keyword-extract.d.ts

@@ -0,0 +1,31 @@
+import type { KeywordExtractionResult } from './types.js';
+export declare const KEYWORD_EXTRACTION_TIMEOUT_MS = 5000;
+/**
+ * Determines whether to run LLM-based keyword extraction.
+ * Skips extraction for simple single-turn queries with a clear local query.
+ */
+export declare function shouldRunKeywordExtraction(params: {
+    messageCount: number;
+    localQuery: string;
+    latestText: string;
+}): boolean;
+/**
+ * Extracts optimized search keywords from the conversation using LLM.
+ * Falls back to local tokenization if LLM call fails or times out.
+ */
+export declare function extractSearchKeywords(params: {
+    messages: Array<{
+        role: string;
+        parts?: Array<{
+            type: string;
+            text?: string;
+        }>;
+        content?: string;
+    }>;
+    provider: {
+        chatModel: (model: string) => unknown;
+    };
+    model: string;
+    abortSignal?: AbortSignal;
+}): Promise<KeywordExtractionResult>;
+//# sourceMappingURL=keyword-extract.d.ts.map

package/dist/intelligence/keyword-extract.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"keyword-extract.d.ts","sourceRoot":"","sources":["../../src/intelligence/keyword-extract.ts"],"names":[],"mappings":"AAEA,OAAO,KAAK,EAAE,uBAAuB,EAAmB,MAAM,YAAY,CAAC;AAE3E,eAAO,MAAM,6BAA6B,OAAO,CAAC;AAElD;;;GAGG;AACH,wBAAgB,0BAA0B,CAAC,MAAM,EAAE;IACjD,YAAY,EAAE,MAAM,CAAC;IACrB,UAAU,EAAE,MAAM,CAAC;IACnB,UAAU,EAAE,MAAM,CAAC;CACpB,GAAG,OAAO,CASV;AAYD;;;GAGG;AACH,wBAAsB,qBAAqB,CAAC,MAAM,EAAE;IAClD,QAAQ,EAAE,KAAK,CAAC;QAAE,IAAI,EAAE,MAAM,CAAC;QAAC,KAAK,CAAC,EAAE,KAAK,CAAC;YAAE,IAAI,EAAE,MAAM,CAAC;YAAC,IAAI,CAAC,EAAE,MAAM,CAAA;SAAE,CAAC,CAAC;QAAC,OAAO,CAAC,EAAE,MAAM,CAAA;KAAE,CAAC,CAAC;IACpG,QAAQ,EAAE;QAAE,SAAS,EAAE,CAAC,KAAK,EAAE,MAAM,KAAK,OAAO,CAAA;KAAE,CAAC;IACpD,KAAK,EAAE,MAAM,CAAC;IACd,WAAW,CAAC,EAAE,WAAW,CAAC;CAC3B,GAAG,OAAO,CAAC,uBAAuB,CAAC,CAmEnC"}

package/dist/intelligence/keyword-extract.js

@@ -0,0 +1,114 @@
+import { generateText } from 'ai';
+import { tokenize } from '../search/search-utils.js';
+export const KEYWORD_EXTRACTION_TIMEOUT_MS = 5000;
+/**
+ * Determines whether to run LLM-based keyword extraction.
+ * Skips extraction for simple single-turn queries with a clear local query.
+ */
+export function shouldRunKeywordExtraction(params) {
+    const { messageCount, localQuery, latestText } = params;
+    // Only extract for multi-turn conversations or ambiguous short messages
+    if (messageCount < 3)
+        return false;
+    if (latestText.length < 10)
+        return false;
+    // If the local query is already clear (multiple tokens), skip LLM
+    const tokens = tokenize(localQuery || latestText);
+    if (tokens.length >= 3)
+        return false;
+    return true;
+}
+/**
+ * Classifies the complexity of the user's query.
+ */
+function classifyComplexity(text) {
+    const tokens = tokenize(text);
+    if (tokens.length <= 1 || text.length <= 10)
+        return 'simple';
+    if (tokens.length >= 5 || text.length > 80)
+        return 'complex';
+    return 'moderate';
+}
+/**
+ * Extracts optimized search keywords from the conversation using LLM.
+ * Falls back to local tokenization if LLM call fails or times out.
+ */
+export async function extractSearchKeywords(params) {
+    const { messages, provider, model, abortSignal } = params;
+    const latestMessage = messages[messages.length - 1];
+    const latestText = getMessageText(latestMessage);
+    const complexity = classifyComplexity(latestText);
+    const conversationText = messages
+        .slice(-6) // Last 3 turns
+        .map(m => `${m.role}: ${getMessageText(m)}`)
+        .join('\n');
+    const prompt = `你是一个搜索关键词提取助手。分析以下对话，提取最佳搜索关键词。
+
+对话:
+${conversationText}
+
+请提取：
+1. 主查询词（最重要的1-2个关键词，用空格分隔）
+2. 补充查询词（可选的辅助关键词）
+
+仅返回JSON格式，不要其他内容：
+{"query": "主查询词", "primaryQuery": "核心词"}`;
+    try {
+        const result = await generateText({
+            // eslint-disable-next-line @typescript-eslint/no-explicit-any
+            model: provider.chatModel(model),
+            prompt,
+            maxOutputTokens: 100,
+            temperature: 0,
+            abortSignal,
+        });
+        const rawText = result.text?.trim() ?? '';
+        // Try to parse JSON response
+        const jsonMatch = rawText.match(/\{[^}]+\}/);
+        if (jsonMatch) {
+            try {
+                const parsed = JSON.parse(jsonMatch[0]);
+                const query = (parsed.query ?? '').trim();
+                const primaryQuery = (parsed.primaryQuery ?? query).trim();
+                if (query) {
+                    const u = result.usage;
+                    return {
+                        query,
+                        primaryQuery,
+                        complexity,
+                        usedFallback: false,
+                        usage: u ? {
+                            inputTokens: u.inputTokens ?? 0,
+                            outputTokens: u.outputTokens ?? 0,
+                            totalTokens: (u.inputTokens ?? 0) + (u.outputTokens ?? 0),
+                        } : undefined,
+                    };
+                }
+            }
+            catch {
+                // Parse failed — fall through to fallback
+            }
+        }
+        return buildFallback(latestText, complexity, 'json_parse_failed');
+    }
+    catch (error) {
+        const message = error instanceof Error ? error.message : String(error);
+        return buildFallback(latestText, complexity, message);
+    }
+}
+function buildFallback(latestText, complexity, error) {
+    const tokens = tokenize(latestText);
+    const query = tokens.slice(0, 3).join(' ') || latestText.slice(0, 30);
+    return { query, primaryQuery: query, complexity, usedFallback: true, error };
+}
+function getMessageText(message) {
+    if (message.content && typeof message.content === 'string')
+        return message.content;
+    if (Array.isArray(message.parts)) {
+        return message.parts
+            .filter((p) => p.type === 'text' && typeof p.text === 'string')
+            .map(p => p.text)
+            .join('');
+    }
+    return '';
+}

package/dist/intelligence/types.d.ts

@@ -0,0 +1,27 @@
+export type QueryComplexity = 'simple' | 'moderate' | 'complex';
+export interface KeywordExtractionResult {
+    query: string;
+    primaryQuery: string;
+    complexity: QueryComplexity;
+    usedFallback: boolean;
+    error?: string;
+    usage?: TokenUsageStats;
+}
+export interface TokenUsageStats {
+    inputTokens: number;
+    outputTokens: number;
+    totalTokens: number;
+}
+export interface EvidenceAnalysisResult {
+    analysis?: string;
+    parseStatus: string;
+    usage?: TokenUsageStats;
+    error?: string;
+    rawText?: string;
+}
+export interface CitationGuardPreflight {
+    text: string;
+    actions: CitationGuardAction[];
+}
+export type CitationGuardAction = 'preflight_reject' | 'stream_rewrite' | 'stream_suppress';
+//# sourceMappingURL=types.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"types.d.ts","sourceRoot":"","sources":["../../src/intelligence/types.ts"],"names":[],"mappings":"AAAA,MAAM,MAAM,eAAe,GAAG,QAAQ,GAAG,UAAU,GAAG,SAAS,CAAC;AAEhE,MAAM,WAAW,uBAAuB;IACtC,KAAK,EAAE,MAAM,CAAC;IACd,YAAY,EAAE,MAAM,CAAC;IACrB,UAAU,EAAE,eAAe,CAAC;IAC5B,YAAY,EAAE,OAAO,CAAC;IACtB,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,KAAK,CAAC,EAAE,eAAe,CAAC;CACzB;AAED,MAAM,WAAW,eAAe;IAC9B,WAAW,EAAE,MAAM,CAAC;IACpB,YAAY,EAAE,MAAM,CAAC;IACrB,WAAW,EAAE,MAAM,CAAC;CACrB;AAED,MAAM,WAAW,sBAAsB;IACrC,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB,WAAW,EAAE,MAAM,CAAC;IACpB,KAAK,CAAC,EAAE,eAAe,CAAC;IACxB,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,OAAO,CAAC,EAAE,MAAM,CAAC;CAClB;AAED,MAAM,WAAW,sBAAsB;IACrC,IAAI,EAAE,MAAM,CAAC;IACb,OAAO,EAAE,mBAAmB,EAAE,CAAC;CAChC;AAED,MAAM,MAAM,mBAAmB,GAAG,kBAAkB,GAAG,gBAAgB,GAAG,iBAAiB,CAAC"}

package/dist/intelligence/types.js

@@ -0,0 +1 @@
+export {};

package/dist/middleware/index.d.ts

@@ -0,0 +1,3 @@
+export { getClientIP, checkRateLimit, rateLimitResponse, } from './rate-limiter.js';
+export type { RateLimitResult } from './rate-limiter.js';
+//# sourceMappingURL=index.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/middleware/index.ts"],"names":[],"mappings":"AAAA,OAAO,EACL,WAAW,EACX,cAAc,EACd,iBAAiB,GAClB,MAAM,mBAAmB,CAAC;AAC3B,YAAY,EAAE,eAAe,EAAE,MAAM,mBAAmB,CAAC"}

package/dist/middleware/index.js

@@ -0,0 +1 @@
+export { getClientIP, checkRateLimit, rateLimitResponse, } from './rate-limiter.js';

package/dist/middleware/rate-limiter.d.ts

@@ -0,0 +1,26 @@
+/**
+ * Three-tier IP-based rate limiter for chat API.
+ * Tiers: burst (short), sustained (medium), daily (long).
+ */
+export interface RateLimitResult {
+    allowed: boolean;
+    retryAfterMs: number;
+    limit: number;
+    remaining: number;
+    triggeredBy: 'burst' | 'sustained' | 'daily' | null;
+}
+/**
+ * Extracts the real client IP from the request headers.
+ * Priority: cf-connecting-ip > x-forwarded-for > x-real-ip > 'unknown'
+ */
+export declare function getClientIP(req: Request): string;
+/**
+ * Checks the rate limit for the given IP and env configuration.
+ * Records the request if allowed.
+ */
+export declare function checkRateLimit(ip: string, env?: Record<string, string | undefined>): RateLimitResult;
+/**
+ * Builds a 429 response for a rejected rate limit check.
+ */
+export declare function rateLimitResponse(result: RateLimitResult, lang?: string): Response;
+//# sourceMappingURL=rate-limiter.d.ts.map

package/dist/middleware/rate-limiter.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"rate-limiter.d.ts","sourceRoot":"","sources":["../../src/middleware/rate-limiter.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAqBH,MAAM,WAAW,eAAe;IAC9B,OAAO,EAAE,OAAO,CAAC;IACjB,YAAY,EAAE,MAAM,CAAC;IACrB,KAAK,EAAE,MAAM,CAAC;IACd,SAAS,EAAE,MAAM,CAAC;IAClB,WAAW,EAAE,OAAO,GAAG,WAAW,GAAG,OAAO,GAAG,IAAI,CAAC;CACrD;AA8CD;;;GAGG;AACH,wBAAgB,WAAW,CAAC,GAAG,EAAE,OAAO,GAAG,MAAM,CAOhD;AAED;;;GAGG;AACH,wBAAgB,cAAc,CAC5B,EAAE,EAAE,MAAM,EACV,GAAG,GAAE,MAAM,CAAC,MAAM,EAAE,MAAM,GAAG,SAAS,CAAM,GAC3C,eAAe,CAsDjB;AAWD;;GAEG;AACH,wBAAgB,iBAAiB,CAAC,MAAM,EAAE,eAAe,EAAE,IAAI,CAAC,EAAE,MAAM,GAAG,QAAQ,CAalF"}