@astro-minimax/ai 0.9.0 → 0.9.3

package/dist/intelligence/citation-guard.js

@@ -2,19 +2,26 @@ import {
   PRIVACY_REFUSAL_TEMPLATES,
   NO_ARTICLE_TEMPLATES,
   ARTICLE_COUNT_TEMPLATES,
+  UNKNOWN_REFUSAL_TEMPLATES,
   pickTemplate,
   pickTemplateWithVars
 } from "./response-templates.js";
 const PRIVACY_PATTERNS = [
-  { 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" }
+  /具体住在哪|哪个小区|门牌号|家庭住址|具体地址|住址信息/u,
+  /赚多少钱|月收入|年收入|工资多少|薪资多少|收入多少/u,
+  /老婆叫什么|妻子叫什么|丈夫叫什么|孩子叫什么|父母叫什么|家人姓名/u,
+  /手机号码|电话号码|联系方式|微信号|QQ号/u,
+  /身份证号|护照号|证件号/u,
+  /你多大了|你几岁|年龄多大|今年多大|今年几岁/u
 ];
+function hasPrivacyIntent(query) {
+  const normalized = query.trim().toLowerCase();
+  if (!normalized) return false;
+  return PRIVACY_PATTERNS.some((pattern) => pattern.test(normalized));
+}
 function resolveAnswerMode(query) {
   const q = query.toLowerCase();
+  if (hasPrivacyIntent(query)) return "unknown";
   if (/几次|多少|几篇|数量|count|how many/u.test(q)) return "count";
   if (/哪些|哪几个|列表|列举|list|what are/u.test(q)) return "list";
   if (/怎么看|怎么想|看法|观点|opinion|think about/u.test(q)) return "opinion";
@@ -23,24 +30,31 @@ function resolveAnswerMode(query) {
   if (/有没有|是否|是不是|真的吗|does|is there/u.test(q)) return "fact";
   return "general";
 }
-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,
-        actions: ["preflight_reject"]
-      };
-    }
+function buildUnknownRefusal(query, lang = "zh") {
+  const normalized = query.trim().toLowerCase();
+  if (/(具体住在哪|哪个小区|门牌号|家庭住址|具体地址|住址)/u.test(normalized)) {
+    return pickTemplate(PRIVACY_REFUSAL_TEMPLATES.address, lang);
   }
-  return null;
+  if (/(赚多少钱|月收入|年收入|工资多少|薪资多少|收入)/u.test(normalized)) {
+    return pickTemplate(PRIVACY_REFUSAL_TEMPLATES.income, lang);
+  }
+  if (/(老婆叫什么|妻子叫什么|丈夫叫什么|孩子叫什么|父母叫什么|家人姓名|家人)/u.test(normalized)) {
+    return pickTemplate(PRIVACY_REFUSAL_TEMPLATES.family, lang);
+  }
+  if (/(手机号码|电话号码|联系方式|微信号|QQ号|电话|手机)/u.test(normalized)) {
+    return pickTemplate(PRIVACY_REFUSAL_TEMPLATES.phone, lang);
+  }
+  if (/(身份证号|护照号|证件号|身份证)/u.test(normalized)) {
+    return pickTemplate(PRIVACY_REFUSAL_TEMPLATES.id, lang);
+  }
+  if (/(你多大了|你几岁|年龄多大|今年多大|今年几岁|年龄)/u.test(normalized)) {
+    return pickTemplate(PRIVACY_REFUSAL_TEMPLATES.age, lang);
+  }
+  return pickTemplate(UNKNOWN_REFUSAL_TEMPLATES, lang);
 }
 function getCitationGuardPreflight(params) {
   const { userQuery, articles, projects, lang = "zh" } = params;
   const q = userQuery.toLowerCase();
-  const privacyRefusal = checkPrivacyRefusal(userQuery, lang);
-  if (privacyRefusal) return privacyRefusal;
   if (/有几篇|有多少篇|文章数量|总共.*文章|how many.*article/u.test(q)) {
     const total = articles.length;
     if (total > 0) {
@@ -57,11 +71,21 @@ function getCitationGuardPreflight(params) {
   return null;
 }
 function createCitationGuardTransform(params) {
-  const { articles, projects, onApplied } = params;
+  const { articles, projects, siteUrl = "", onApplied } = params;
+  const normalizeUrl = (url) => {
+    if (url.startsWith("/")) return `${siteUrl}${url}`;
+    if (url.startsWith("http://") || url.startsWith("https://")) return url;
+    return `${siteUrl}/${url}`;
+  };
   const validUrls = /* @__PURE__ */ new Set([
-    ...articles.map((a) => a.url),
-    ...projects.map((p) => p.url)
+    ...articles.map((a) => normalizeUrl(a.url)),
+    ...projects.map((p) => normalizeUrl(p.url))
   ]);
+  const isValidInternalUrl = (url) => {
+    if (url.startsWith("/") && !url.startsWith("//")) return true;
+    if (siteUrl && url.startsWith(siteUrl)) return true;
+    return validUrls.has(normalizeUrl(url));
+  };
   return (stream) => {
     const actions = [];
     let buffer = "";
@@ -75,7 +99,11 @@ function createCitationGuardTransform(params) {
         while ((match = linkPattern.exec(buffer)) !== null) {
           const [fullMatch, text, url] = match;
           output += buffer.slice(lastIndex, match.index);
-          if (url.startsWith("http") && !validUrls.has(url)) {
+          const normalizedUrl = normalizeUrl(url);
+          const isExternal = url.startsWith("http://") || url.startsWith("https://");
+          const isInternalValid = isValidInternalUrl(url);
+          const isInValidList = validUrls.has(normalizedUrl);
+          if (isExternal && !isInValidList && !isInternalValid) {
             output += text;
             actions.push("stream_rewrite");
           } else {
@@ -102,6 +130,7 @@ function createCitationGuardTransform(params) {
   };
 }
 export {
+  buildUnknownRefusal,
   createCitationGuardTransform,
   getCitationGuardPreflight,
   resolveAnswerMode

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

@@ -1,16 +1,27 @@
-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.
- */
+import type { ArticleContext, ProjectContext } from "../search/types.js";
+import type { EvidenceAnalysisResult, TokenUsageStats, QueryComplexity } from "./types.js";
+import { EvidenceAnalysis } from "../structured-output/index.js";
+export declare const EVIDENCE_ANALYSIS_TIMEOUT_MS: 8000;
+export declare const EVIDENCE_ANALYSIS_MAX_TOKENS: 360;
 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 interface StructuredEvidenceResult {
+    analysis: EvidenceAnalysis | null;
+    parseStatus: string;
+    usage?: TokenUsageStats;
+    error?: string;
+    rawText?: string;
+}
+export declare function analyzeRetrievedEvidenceStructured(params: {
+    userQuery: string;
+    articles: ArticleContext[];
+    projects: ProjectContext[];
+    provider: {
+        chatModel: (model: string) => unknown;
+    };
+    model: string;
+    maxOutputTokens?: number;
+    abortSignal?: AbortSignal;
+}): Promise<StructuredEvidenceResult>;
 export declare function analyzeRetrievedEvidence(params: {
     userQuery: string;
     articles: ArticleContext[];
@@ -22,8 +33,5 @@ export declare function analyzeRetrievedEvidence(params: {
     maxOutputTokens?: number;
     abortSignal?: AbortSignal;
 }): Promise<EvidenceAnalysisResult>;
-/**
- * Formats the evidence analysis for injection into the system prompt.
- */
-export declare function buildEvidenceSection(analysis: string): string;
+export declare function buildEvidenceSection(analysis: string | EvidenceAnalysis | null): string;
 //# sourceMappingURL=evidence-analysis.d.ts.map

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

@@ -1 +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,CAgDlC;AAED;;GAEG;AACH,wBAAgB,oBAAoB,CAAC,QAAQ,EAAE,MAAM,GAAG,MAAM,CAG7D"}
+{"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,EACV,sBAAsB,EACtB,eAAe,EACf,eAAe,EAChB,MAAM,YAAY,CAAC;AACpB,OAAO,EAEL,gBAAgB,EAEjB,MAAM,+BAA+B,CAAC;AAGvC,eAAO,MAAM,4BAA4B,MAA6B,CAAC;AACvE,eAAO,MAAM,4BAA4B,KACE,CAAC;AAE5C,wBAAgB,kBAAkB,CAChC,UAAU,EAAE,MAAM,EAClB,YAAY,EAAE,MAAM,EACpB,UAAU,EAAE,eAAe,GAC1B,OAAO,CAKT;AAsDD,MAAM,WAAW,wBAAwB;IACvC,QAAQ,EAAE,gBAAgB,GAAG,IAAI,CAAC;IAClC,WAAW,EAAE,MAAM,CAAC;IACpB,KAAK,CAAC,EAAE,eAAe,CAAC;IACxB,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,OAAO,CAAC,EAAE,MAAM,CAAC;CAClB;AAED,wBAAsB,kCAAkC,CAAC,MAAM,EAAE;IAC/D,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,wBAAwB,CAAC,CA2CpC;AAED,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,CAoDlC;AAED,wBAAgB,oBAAoB,CAClC,QAAQ,EAAE,MAAM,GAAG,gBAAgB,GAAG,IAAI,GACzC,MAAM,CA+CR"}

package/dist/intelligence/evidence-analysis.js

@@ -1,14 +1,93 @@
 import { generateText } from "ai";
-const EVIDENCE_ANALYSIS_TIMEOUT_MS = 8e3;
-const EVIDENCE_ANALYSIS_MAX_TOKENS = 360;
+import {
+  EvidenceAnalysisSchema,
+  EVIDENCE_ANALYSIS_SYSTEM_PROMPT
+} from "../structured-output/index.js";
+import { TIMEOUTS, INTELLIGENCE } from "../constants.js";
+const EVIDENCE_ANALYSIS_TIMEOUT_MS = TIMEOUTS.EVIDENCE_ANALYSIS;
+const EVIDENCE_ANALYSIS_MAX_TOKENS = INTELLIGENCE.EVIDENCE_ANALYSIS_MAX_TOKENS;
 function shouldSkipAnalysis(latestText, articleCount, complexity) {
   if (articleCount < 2) return true;
   if (complexity === "simple") return true;
   if (latestText.length < 15) return true;
   return false;
 }
+function buildEvidenceSummary(articles, projects) {
+  const lines = [];
+  for (const article of articles.slice(0, 6)) {
+    lines.push(`\u6587\u7AE0: ${article.title}`);
+    if (article.summary) lines.push(`  \u6458\u8981: ${article.summary}`);
+    if (article.keyPoints.length)
+      lines.push(`  \u8981\u70B9: ${article.keyPoints.slice(0, 3).join(", ")}`);
+    if (article.url) lines.push(`  URL: ${article.url}`);
+  }
+  for (const project of projects.slice(0, 3)) {
+    lines.push(`\u9879\u76EE: ${project.name} - ${project.description.slice(0, 100)}`);
+    if (project.url) lines.push(`  URL: ${project.url}`);
+  }
+  return lines.join("\n");
+}
+async function extractUsage(result) {
+  const usagePromise = typeof result === "object" && result !== null && "usage" in result ? result.usage : void 0;
+  if (!usagePromise) return void 0;
+  try {
+    const u = await Promise.resolve(usagePromise);
+    return {
+      inputTokens: u.inputTokens ?? 0,
+      outputTokens: u.outputTokens ?? 0,
+      totalTokens: u.totalTokens ?? 0
+    };
+  } catch {
+    return void 0;
+  }
+}
+async function analyzeRetrievedEvidenceStructured(params) {
+  const { userQuery, articles, projects, provider, model, abortSignal } = params;
+  if (articles.length === 0 && projects.length === 0) {
+    return { analysis: null, parseStatus: "no_content" };
+  }
+  const evidenceSummary = buildEvidenceSummary(articles, projects);
+  const userPrompt = `\u7528\u6237\u95EE\u9898\uFF1A${userQuery}
+
+\u68C0\u7D22\u5230\u7684\u76F8\u5173\u5185\u5BB9\uFF1A
+${evidenceSummary}`;
+  try {
+    const { generateObject } = await import("ai");
+    const result = await generateObject({
+      model: provider.chatModel(model),
+      schema: EvidenceAnalysisSchema,
+      schemaName: "evidence_analysis",
+      schemaDescription: "Structured evidence analysis for answer planning",
+      system: EVIDENCE_ANALYSIS_SYSTEM_PROMPT,
+      prompt: userPrompt,
+      temperature: 0,
+      abortSignal
+    });
+    const usage = await extractUsage(result);
+    return {
+      analysis: result.object,
+      parseStatus: "ok",
+      usage,
+      rawText: JSON.stringify(result.object)
+    };
+  } catch (error) {
+    return {
+      analysis: null,
+      parseStatus: "error",
+      error: error instanceof Error ? error.message : String(error)
+    };
+  }
+}
 async function analyzeRetrievedEvidence(params) {
-  const { userQuery, articles, projects, provider, model, maxOutputTokens = EVIDENCE_ANALYSIS_MAX_TOKENS, abortSignal } = params;
+  const {
+    userQuery,
+    articles,
+    projects,
+    provider,
+    model,
+    maxOutputTokens = EVIDENCE_ANALYSIS_MAX_TOKENS,
+    abortSignal
+  } = params;
   const evidenceSummary = buildEvidenceSummary(articles, projects);
   const prompt = `\u7528\u6237\u95EE\u9898\uFF1A${userQuery}
 
@@ -33,16 +112,12 @@ ${evidenceSummary}
     const rawText = result.text?.trim() ?? "";
     const match = rawText.match(/<evidence>([\s\S]*?)<\/evidence>/);
     const analysis = match?.[1]?.trim();
-    const u = result.usage;
+    const usage = await extractUsage(result);
     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)
-      } : void 0
+      usage
     };
   } catch (error) {
     return {
@@ -52,21 +127,43 @@ ${evidenceSummary}
   }
 }
 function buildEvidenceSection(analysis) {
-  if (!analysis.trim()) return "";
-  return `
+  if (!analysis) return "";
+  if (typeof analysis === "string") {
+    if (!analysis.trim()) return "";
+    return `
 ## \u5173\u952E\u8BC1\u636E\u5206\u6790
 ${analysis}
 `;
-}
-function buildEvidenceSummary(articles, projects) {
-  const lines = [];
-  for (const article of articles.slice(0, 6)) {
-    lines.push(`\u6587\u7AE0: ${article.title}`);
-    if (article.summary) lines.push(`  \u6458\u8981: ${article.summary}`);
-    if (article.keyPoints.length) lines.push(`  \u8981\u70B9: ${article.keyPoints.slice(0, 3).join(", ")}`);
   }
-  for (const project of projects.slice(0, 3)) {
-    lines.push(`\u9879\u76EE: ${project.name} - ${project.description.slice(0, 100)}`);
+  const lines = ["## \u5173\u952E\u8BC1\u636E\u5206\u6790"];
+  if (analysis.directAnswer) {
+    lines.push(`- \u76F4\u63A5\u7ED3\u8BBA\uFF1A${analysis.directAnswer}`);
+  }
+  if (analysis.entities.length > 0) {
+    lines.push("");
+    lines.push("### \u76F8\u5173\u5B9E\u4F53");
+    for (const entity of analysis.entities) {
+      const parts = [entity.name];
+      if (entity.count) {
+        const countStr = entity.countMode === "at_least" ? `\u81F3\u5C11 ${entity.count}` : `${entity.count}`;
+        parts.push(`(${countStr})`);
+      }
+      lines.push(`- ${parts.join(" ")}`);
+    }
+  }
+  if (analysis.keyFindings.length > 0) {
+    lines.push("");
+    lines.push("### \u5173\u952E\u53D1\u73B0");
+    for (const finding of analysis.keyFindings) {
+      lines.push(`- ${finding.claim} (\u7F6E\u4FE1\u5EA6: ${finding.confidence})`);
+    }
+  }
+  if (analysis.uncertainties.length > 0) {
+    lines.push("");
+    lines.push("### \u4E0D\u786E\u5B9A\u9879");
+    for (const item of analysis.uncertainties) {
+      lines.push(`- ${item}`);
+    }
   }
   return lines.join("\n");
 }
@@ -74,6 +171,7 @@ export {
   EVIDENCE_ANALYSIS_MAX_TOKENS,
   EVIDENCE_ANALYSIS_TIMEOUT_MS,
   analyzeRetrievedEvidence,
+  analyzeRetrievedEvidenceStructured,
   buildEvidenceSection,
   shouldSkipAnalysis
 };

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

@@ -0,0 +1,13 @@
+import type { QueryComplexity } from './types.js';
+import type { AnswerMode } from './citation-guard.js';
+import type { ArticleContext } from '../search/types.js';
+export interface EvidenceBudget {
+    maxArticles: number;
+    summaryMaxLength: number;
+    keyPointsMaxCount: number;
+    enableDeepContent: boolean;
+    analysisMaxTokens: number;
+}
+export declare function getEvidenceBudget(complexity: QueryComplexity, answerMode?: AnswerMode): EvidenceBudget;
+export declare function applyBudgetToArticles(articles: ArticleContext[], budget: EvidenceBudget): ArticleContext[];
+//# sourceMappingURL=evidence-budget.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"evidence-budget.d.ts","sourceRoot":"","sources":["../../src/intelligence/evidence-budget.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,eAAe,EAAE,MAAM,YAAY,CAAC;AAClD,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,qBAAqB,CAAC;AACtD,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,oBAAoB,CAAC;AAEzD,MAAM,WAAW,cAAc;IAC7B,WAAW,EAAE,MAAM,CAAC;IACpB,gBAAgB,EAAE,MAAM,CAAC;IACzB,iBAAiB,EAAE,MAAM,CAAC;IAC1B,iBAAiB,EAAE,OAAO,CAAC;IAC3B,iBAAiB,EAAE,MAAM,CAAC;CAC3B;AAkCD,wBAAgB,iBAAiB,CAC/B,UAAU,EAAE,eAAe,EAC3B,UAAU,CAAC,EAAE,UAAU,GACtB,cAAc,CAQhB;AAED,wBAAgB,qBAAqB,CACnC,QAAQ,EAAE,cAAc,EAAE,EAC1B,MAAM,EAAE,cAAc,GACrB,cAAc,EAAE,CAOlB"}

package/dist/intelligence/evidence-budget.js

@@ -0,0 +1,49 @@
+const BUDGET_PRESETS = {
+  simple: {
+    maxArticles: 4,
+    summaryMaxLength: 48,
+    keyPointsMaxCount: 2,
+    enableDeepContent: false,
+    analysisMaxTokens: 200
+  },
+  moderate: {
+    maxArticles: 6,
+    summaryMaxLength: 56,
+    keyPointsMaxCount: 3,
+    enableDeepContent: true,
+    analysisMaxTokens: 360
+  },
+  complex: {
+    maxArticles: 8,
+    summaryMaxLength: 64,
+    keyPointsMaxCount: 4,
+    enableDeepContent: true,
+    analysisMaxTokens: 500
+  }
+};
+const MODE_ADJUSTMENTS = {
+  count: { maxArticles: 2, enableDeepContent: false },
+  list: { maxArticles: 8, summaryMaxLength: 80 },
+  opinion: { analysisMaxTokens: 200 },
+  recommendation: { maxArticles: 6, keyPointsMaxCount: 2 },
+  unknown: { maxArticles: 2, enableDeepContent: false }
+};
+function getEvidenceBudget(complexity, answerMode) {
+  const base = { ...BUDGET_PRESETS[complexity] };
+  if (answerMode && MODE_ADJUSTMENTS[answerMode]) {
+    Object.assign(base, MODE_ADJUSTMENTS[answerMode]);
+  }
+  return base;
+}
+function applyBudgetToArticles(articles, budget) {
+  return articles.slice(0, budget.maxArticles).map((article) => ({
+    ...article,
+    summary: article.summary?.slice(0, budget.summaryMaxLength),
+    keyPoints: article.keyPoints.slice(0, budget.keyPointsMaxCount),
+    fullContent: budget.enableDeepContent ? article.fullContent : void 0
+  }));
+}
+export {
+  applyBudgetToArticles,
+  getEvidenceBudget
+};

package/dist/intelligence/index.d.ts

@@ -1,8 +1,14 @@
-export { isLikelyFollowUp, hasNewSignificantTokens, hasQueryOverlap, shouldReuseSearchContext, buildLocalSearchQuery, classifyIntent, rankArticlesByIntent, } from './intent-detect.js';
-export type { IntentCategory } from './intent-detect.js';
+export { isLikelyFollowUp, hasNewSignificantTokens, hasQueryOverlap, shouldReuseSearchContext, buildLocalSearchQuery, } from '../query/followup.js';
+export { classifyIntent, rankArticlesByCategory, rankArticlesByIntent, } from '../query/intent.js';
+export type { QueryIntentCategory as IntentCategory } from '../query/types.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, resolveAnswerMode, } from './citation-guard.js';
+export { shouldSkipAnalysis, analyzeRetrievedEvidence, analyzeRetrievedEvidenceStructured, buildEvidenceSection, EVIDENCE_ANALYSIS_TIMEOUT_MS, EVIDENCE_ANALYSIS_MAX_TOKENS, } from './evidence-analysis.js';
+export type { StructuredEvidenceResult } from './evidence-analysis.js';
+export { getEvidenceBudget, applyBudgetToArticles, } from './evidence-budget.js';
+export type { EvidenceBudget } from './evidence-budget.js';
+export { interpretRequest, resolveInterpretationBudget, classifyQueryComplexity, resolveSearchInterpretation, } from './request-interpretation.js';
+export type { SafetyDecision, SafetyReason, RequestInterpretation, InterpretRequestArgs, SearchInterpretation, } from './request-interpretation.js';
+export { getCitationGuardPreflight, createCitationGuardTransform, resolveAnswerMode, buildUnknownRefusal, } 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';

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,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"}
+{"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,sBAAsB,CAAC;AAE9B,OAAO,EACL,cAAc,EACd,sBAAsB,EACtB,oBAAoB,GACrB,MAAM,oBAAoB,CAAC;AAE5B,YAAY,EAAE,mBAAmB,IAAI,cAAc,EAAE,MAAM,mBAAmB,CAAC;AAE/E,OAAO,EACL,0BAA0B,EAC1B,qBAAqB,EACrB,6BAA6B,GAC9B,MAAM,sBAAsB,CAAC;AAE9B,OAAO,EACL,kBAAkB,EAClB,wBAAwB,EACxB,kCAAkC,EAClC,oBAAoB,EACpB,4BAA4B,EAC5B,4BAA4B,GAC7B,MAAM,wBAAwB,CAAC;AAEhC,YAAY,EAAE,wBAAwB,EAAE,MAAM,wBAAwB,CAAC;AAEvE,OAAO,EACL,iBAAiB,EACjB,qBAAqB,GACtB,MAAM,sBAAsB,CAAC;AAE9B,YAAY,EAAE,cAAc,EAAE,MAAM,sBAAsB,CAAC;AAE3D,OAAO,EACL,gBAAgB,EAChB,2BAA2B,EAC3B,uBAAuB,EACvB,2BAA2B,GAC5B,MAAM,6BAA6B,CAAC;AAErC,YAAY,EACV,cAAc,EACd,YAAY,EACZ,qBAAqB,EACrB,oBAAoB,EACpB,oBAAoB,GACrB,MAAM,6BAA6B,CAAC;AAErC,OAAO,EACL,yBAAyB,EACzB,4BAA4B,EAC5B,iBAAiB,EACjB,mBAAmB,GACpB,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

@@ -3,10 +3,13 @@ import {
   hasNewSignificantTokens,
   hasQueryOverlap,
   shouldReuseSearchContext,
-  buildLocalSearchQuery,
+  buildLocalSearchQuery
+} from "../query/followup.js";
+import {
   classifyIntent,
+  rankArticlesByCategory,
   rankArticlesByIntent
-} from "./intent-detect.js";
+} from "../query/intent.js";
 import {
   shouldRunKeywordExtraction,
   extractSearchKeywords,
@@ -15,14 +18,26 @@ import {
 import {
   shouldSkipAnalysis,
   analyzeRetrievedEvidence,
+  analyzeRetrievedEvidenceStructured,
   buildEvidenceSection,
   EVIDENCE_ANALYSIS_TIMEOUT_MS,
   EVIDENCE_ANALYSIS_MAX_TOKENS
 } from "./evidence-analysis.js";
+import {
+  getEvidenceBudget,
+  applyBudgetToArticles
+} from "./evidence-budget.js";
+import {
+  interpretRequest,
+  resolveInterpretationBudget,
+  classifyQueryComplexity,
+  resolveSearchInterpretation
+} from "./request-interpretation.js";
 import {
   getCitationGuardPreflight,
   createCitationGuardTransform,
-  resolveAnswerMode
+  resolveAnswerMode,
+  buildUnknownRefusal
 } from "./citation-guard.js";
 import {
   createCitationAppenderTransform,
@@ -35,19 +50,28 @@ export {
   EVIDENCE_ANALYSIS_TIMEOUT_MS,
   KEYWORD_EXTRACTION_TIMEOUT_MS,
   analyzeRetrievedEvidence,
+  analyzeRetrievedEvidenceStructured,
+  applyBudgetToArticles,
   buildEvidenceSection,
   buildLocalSearchQuery,
+  buildUnknownRefusal,
   classifyIntent,
+  classifyQueryComplexity,
   createCitationAppenderTransform,
   createCitationGuardTransform,
   extractSearchKeywords,
   formatCitationBlock,
   getCitationGuardPreflight,
+  getEvidenceBudget,
   hasNewSignificantTokens,
   hasQueryOverlap,
+  interpretRequest,
   isLikelyFollowUp,
+  rankArticlesByCategory,
   rankArticlesByIntent,
   resolveAnswerMode,
+  resolveInterpretationBudget,
+  resolveSearchInterpretation,
   selectCitations,
   shouldAppendCitations,
   shouldReuseSearchContext,

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

@@ -1,5 +1,5 @@
 import type { KeywordExtractionResult } from './types.js';
-export declare const KEYWORD_EXTRACTION_TIMEOUT_MS = 5000;
+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.

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

@@ -1 +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,CAkEnC"}
+{"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;AAI3E,eAAO,MAAM,6BAA6B,MAA8B,CAAC;AAEzE;;;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;AAED;;;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,CAkEnC"}

package/dist/intelligence/keyword-extract.js

@@ -1,6 +1,8 @@
 import { generateText } from "ai";
-import { tokenize } from "../search/search-utils.js";
-const KEYWORD_EXTRACTION_TIMEOUT_MS = 5e3;
+import { tokenize } from "../utils/text.js";
+import { TIMEOUTS } from "../constants.js";
+import { classifyQueryComplexity } from "./request-interpretation.js";
+const KEYWORD_EXTRACTION_TIMEOUT_MS = TIMEOUTS.KEYWORD_EXTRACTION;
 function shouldRunKeywordExtraction(params) {
   const { messageCount, localQuery, latestText } = params;
   if (messageCount < 3) return false;
@@ -9,17 +11,11 @@ function shouldRunKeywordExtraction(params) {
   if (tokens.length >= 3) return false;
   return true;
 }
-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";
-}
 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 complexity = classifyQueryComplexity(latestText);
   const conversationText = messages.slice(-6).map((m) => `${m.role}: ${getMessageText(m)}`).join("\n");
   const prompt = `\u4F60\u662F\u4E00\u4E2A\u641C\u7D22\u5173\u952E\u8BCD\u63D0\u53D6\u52A9\u624B\u3002\u5206\u6790\u4EE5\u4E0B\u5BF9\u8BDD\uFF0C\u63D0\u53D6\u6700\u4F73\u641C\u7D22\u5173\u952E\u8BCD\u3002
 

package/dist/intelligence/request-interpretation.d.ts

@@ -0,0 +1,40 @@
+import { type EvidenceBudget } from './evidence-budget.js';
+import type { QueryIntentCategory } from '../query/types.js';
+import type { AnswerMode } from './citation-guard.js';
+import type { CachedSearchContext } from '../search/types.js';
+import type { QueryComplexity } from './types.js';
+export type SafetyDecision = 'allow' | 'constrain' | 'refuse';
+export type SafetyReason = 'privacy' | 'policy' | 'unsupported_capability' | 'insufficient_public_evidence';
+export interface RequestInterpretation {
+    conversation: {
+        shouldReuseContext: boolean;
+    };
+    topic: {
+        primary: QueryIntentCategory;
+    };
+    answer: {
+        contract: AnswerMode;
+    };
+    safety: {
+        decision: SafetyDecision;
+        reason?: SafetyReason;
+    };
+    reasoning: {
+        complexity: QueryComplexity;
+    };
+}
+export interface InterpretRequestArgs {
+    latestText: string;
+    cachedContext?: CachedSearchContext;
+    userTurnCount?: number;
+    now?: number;
+}
+export interface SearchInterpretation {
+    interpretation: RequestInterpretation;
+    budget: EvidenceBudget;
+}
+export declare function classifyQueryComplexity(text: string): QueryComplexity;
+export declare function interpretRequest(args: InterpretRequestArgs): RequestInterpretation;
+export declare function resolveInterpretationBudget(interpretation: RequestInterpretation): EvidenceBudget;
+export declare function resolveSearchInterpretation(args: InterpretRequestArgs): SearchInterpretation;
+//# sourceMappingURL=request-interpretation.d.ts.map

package/dist/intelligence/request-interpretation.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"request-interpretation.d.ts","sourceRoot":"","sources":["../../src/intelligence/request-interpretation.ts"],"names":[],"mappings":"AAAA,OAAO,EAAqB,KAAK,cAAc,EAAE,MAAM,sBAAsB,CAAC;AAE9E,OAAO,KAAK,EAAE,mBAAmB,EAAE,MAAM,mBAAmB,CAAC;AAG7D,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,qBAAqB,CAAC;AACtD,OAAO,KAAK,EAAE,mBAAmB,EAAE,MAAM,oBAAoB,CAAC;AAC9D,OAAO,KAAK,EAAE,eAAe,EAAE,MAAM,YAAY,CAAC;AAElD,MAAM,MAAM,cAAc,GAAG,OAAO,GAAG,WAAW,GAAG,QAAQ,CAAC;AAE9D,MAAM,MAAM,YAAY,GACpB,SAAS,GACT,QAAQ,GACR,wBAAwB,GACxB,8BAA8B,CAAC;AAEnC,MAAM,WAAW,qBAAqB;IACpC,YAAY,EAAE;QACZ,kBAAkB,EAAE,OAAO,CAAC;KAC7B,CAAC;IACF,KAAK,EAAE;QACL,OAAO,EAAE,mBAAmB,CAAC;KAC9B,CAAC;IACF,MAAM,EAAE;QACN,QAAQ,EAAE,UAAU,CAAC;KACtB,CAAC;IACF,MAAM,EAAE;QACN,QAAQ,EAAE,cAAc,CAAC;QACzB,MAAM,CAAC,EAAE,YAAY,CAAC;KACvB,CAAC;IACF,SAAS,EAAE;QACT,UAAU,EAAE,eAAe,CAAC;KAC7B,CAAC;CACH;AAED,MAAM,WAAW,oBAAoB;IACnC,UAAU,EAAE,MAAM,CAAC;IACnB,aAAa,CAAC,EAAE,mBAAmB,CAAC;IACpC,aAAa,CAAC,EAAE,MAAM,CAAC;IACvB,GAAG,CAAC,EAAE,MAAM,CAAC;CACd;AAED,MAAM,WAAW,oBAAoB;IACnC,cAAc,EAAE,qBAAqB,CAAC;IACtC,MAAM,EAAE,cAAc,CAAC;CACxB;AAED,wBAAgB,uBAAuB,CAAC,IAAI,EAAE,MAAM,GAAG,eAAe,CAQrE;AAYD,wBAAgB,gBAAgB,CAAC,IAAI,EAAE,oBAAoB,GAAG,qBAAqB,CAkClF;AAED,wBAAgB,2BAA2B,CACzC,cAAc,EAAE,qBAAqB,GACpC,cAAc,CAKhB;AAED,wBAAgB,2BAA2B,CACzC,IAAI,EAAE,oBAAoB,GACzB,oBAAoB,CAMtB"}