@astro-minimax/ai 0.9.0 → 0.9.3

package/dist/server/types.d.ts

@@ -1,8 +1,8 @@
-import type { UIMessage } from 'ai';
-import type { ProviderManagerEnv } from '../provider-manager/types.js';
-import type { CacheEnv } from '../cache/types.js';
+import type { UIMessage } from "ai";
+import type { ProviderManagerEnv } from "../provider-manager/types.js";
+import type { CacheEnv } from "../cache/types.js";
 export interface ChatContext {
-    scope: 'global' | 'article';
+    scope: "global" | "article";
     article?: ArticleChatContext;
 }
 export interface ArticleChatContext {
@@ -20,9 +20,27 @@ export interface ChatRequestBody {
     messages: UIMessage[];
     lang?: string;
 }
-export interface ChatHandlerEnv extends ProviderManagerEnv, CacheEnv {
+export interface AiCacheEnv {
+    AI_CACHE_ENABLED?: boolean | string;
+    AI_CACHE_TTL?: number | string;
+    AI_CACHE_PLAYBACK_DELAY?: number | string;
+    AI_CACHE_CHUNK_SIZE?: number | string;
+    AI_CACHE_THINKING_DELAY?: number | string;
+}
+export interface AiTimeoutEnv {
+    AI_TIMEOUT_REQUEST?: number | string;
+    AI_TIMEOUT_KEYWORD?: number | string;
+    AI_TIMEOUT_EVIDENCE?: number | string;
+    AI_TIMEOUT_LLM?: number | string;
+}
+export interface AiHealthEnv {
+    AI_HEALTH_THRESHOLD?: number | string;
+    AI_HEALTH_RECOVERY_TTL?: number | string;
+}
+export interface ChatHandlerEnv extends ProviderManagerEnv, CacheEnv, AiCacheEnv, AiTimeoutEnv, AiHealthEnv {
     SITE_AUTHOR?: string;
     SITE_URL?: string;
+    SITE_LANG?: string;
     [key: string]: unknown;
 }
 export interface ChatHandlerOptions {
@@ -30,7 +48,7 @@ export interface ChatHandlerOptions {
     request: Request;
     waitUntil?: (promise: Promise<unknown>) => void;
 }
-export type ChatStatusStage = 'search' | 'answer' | 'complete';
+export type ChatStatusStage = "search" | "answer" | "complete";
 export interface ChatStatusData {
     stage: ChatStatusStage;
     message: string;
@@ -38,7 +56,7 @@ export interface ChatStatusData {
     done: boolean;
     at: number;
 }
-export declare function createChatStatusData(partial: Omit<ChatStatusData, 'done' | 'at'> & {
+export declare function createChatStatusData(partial: Omit<ChatStatusData, "done" | "at"> & {
     done?: boolean;
 }): ChatStatusData;
 export declare function isChatStatusData(value: unknown): value is ChatStatusData;
@@ -49,11 +67,28 @@ export interface ChatErrorResponse {
     retryAfter?: number;
 }
 export interface MetadataConfig {
-    summaries: unknown;
-    authorContext: unknown;
-    voiceProfile: unknown;
-    factRegistry?: unknown;
-    vectorIndex?: unknown;
+    knowledgeBundle: unknown;
     siteUrl?: string;
 }
+export interface NotifyArticleRef {
+    title: string;
+    url?: string;
+}
+export interface NotifyModelInfo {
+    name: string;
+    provider?: string;
+    apiHost?: string;
+}
+export interface NotifyTokenUsage {
+    total: number;
+    input: number;
+    output: number;
+}
+export interface PhaseTiming {
+    total: number;
+    keywordExtraction?: number;
+    search?: number;
+    evidenceAnalysis?: number;
+    generation?: number;
+}
 //# 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,YAAY,CAAC,EAAE,OAAO,CAAC;IACvB,WAAW,CAAC,EAAE,OAAO,CAAC;IACtB,OAAO,CAAC,EAAE,MAAM,CAAC;CAClB"}
+{"version":3,"file":"types.d.ts","sourceRoot":"","sources":["../../src/server/types.ts"],"names":[],"mappings":"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"}

package/dist/structured-output/generator.d.ts

@@ -0,0 +1,6 @@
+/**
+ * @fileoverview Core generator for structured output with fallback support.
+ */
+import type { StructuredOutputResult, GenerateStructuredOptions } from './types.js';
+export declare function generateStructured<T>(options: GenerateStructuredOptions<T>): Promise<StructuredOutputResult<T>>;
+//# sourceMappingURL=generator.d.ts.map

package/dist/structured-output/generator.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"generator.d.ts","sourceRoot":"","sources":["../../src/structured-output/generator.ts"],"names":[],"mappings":"AAAA;;GAEG;AAEH,OAAO,KAAK,EAEV,sBAAsB,EACtB,yBAAyB,EAG1B,MAAM,YAAY,CAAC;AA6CpB,wBAAsB,kBAAkB,CAAC,CAAC,EACxC,OAAO,EAAE,yBAAyB,CAAC,CAAC,CAAC,GACpC,OAAO,CAAC,sBAAsB,CAAC,CAAC,CAAC,CAAC,CAkIpC"}

package/dist/structured-output/generator.js

@@ -0,0 +1,164 @@
+import { TIMEOUTS } from "../constants.js";
+const DEFAULT_TIMEOUT_MS = TIMEOUTS.EVIDENCE_ANALYSIS;
+const DEFAULT_MAX_OUTPUT_TOKENS = 500;
+const DEFAULT_TEMPERATURE = 0;
+function toTokenStats(usage) {
+  if (!usage) return void 0;
+  return {
+    inputTokens: usage.inputTokens ?? 0,
+    outputTokens: usage.outputTokens ?? 0,
+    totalTokens: usage.totalTokens ?? (usage.inputTokens ?? 0) + (usage.outputTokens ?? 0)
+  };
+}
+function extractJsonFromText(text) {
+  const trimmed = text.trim();
+  if (trimmed.startsWith("{") || trimmed.startsWith("[")) {
+    try {
+      return JSON.parse(trimmed);
+    } catch {
+    }
+  }
+  const codeBlockMatch = trimmed.match(/```(?:json)?\s*([\s\S]*?)```/);
+  if (codeBlockMatch) {
+    try {
+      return JSON.parse(codeBlockMatch[1].trim());
+    } catch {
+    }
+  }
+  const jsonMatch = trimmed.match(/(\{[\s\S]*\}|\[[\s\S]*\])/);
+  if (jsonMatch) {
+    try {
+      return JSON.parse(jsonMatch[1]);
+    } catch {
+    }
+  }
+  return null;
+}
+function validateWithSchema(data, schema) {
+  const result = schema.safeParse(data);
+  if (result.success) {
+    return result.data;
+  }
+  return null;
+}
+async function generateStructured(options) {
+  const {
+    config,
+    provider,
+    systemPrompt,
+    userPrompt,
+    abortSignal
+  } = options;
+  const {
+    schema,
+    schemaName = "output",
+    schemaDescription,
+    fallbackParser,
+    repairStrategy = "lenient",
+    timeoutMs = DEFAULT_TIMEOUT_MS,
+    maxOutputTokens = DEFAULT_MAX_OUTPUT_TOKENS,
+    temperature = DEFAULT_TEMPERATURE
+  } = config;
+  const allowTextRepair = repairStrategy !== "none";
+  const allowFallbackParser = repairStrategy === "lenient";
+  const timeoutController = new AbortController();
+  const timeoutId = setTimeout(() => timeoutController.abort(), timeoutMs);
+  const abortHandler = () => timeoutController.abort();
+  if (abortSignal) {
+    if (abortSignal.aborted) {
+      clearTimeout(timeoutId);
+      return {
+        data: null,
+        success: false,
+        status: "timeout",
+        fallbackUsed: false,
+        error: "Request already aborted"
+      };
+    }
+    abortSignal.addEventListener("abort", abortHandler, { once: true });
+  }
+  let status = "request_error";
+  let rawText = "";
+  let usage;
+  try {
+    const result = await provider.generateObject({
+      schema,
+      schemaName,
+      schemaDescription,
+      systemPrompt,
+      userPrompt,
+      temperature,
+      maxOutputTokens,
+      abortSignal: timeoutController.signal
+    });
+    clearTimeout(timeoutId);
+    usage = toTokenStats(result.usage);
+    const validated = validateWithSchema(result.object, schema);
+    if (validated !== null) {
+      return {
+        data: validated,
+        success: true,
+        status: "success",
+        fallbackUsed: false,
+        rawText: JSON.stringify(result.object),
+        usage
+      };
+    }
+    status = "schema_error";
+    rawText = JSON.stringify(result.object);
+  } catch (error) {
+    clearTimeout(timeoutId);
+    if (timeoutController.signal.aborted || error instanceof Error && error.name === "AbortError") {
+      status = "timeout";
+    }
+  } finally {
+    if (abortSignal) {
+      abortSignal.removeEventListener("abort", abortHandler);
+    }
+  }
+  if (allowTextRepair) {
+    try {
+      const textResult = await provider.generateText({
+        systemPrompt,
+        userPrompt,
+        temperature,
+        maxOutputTokens,
+        abortSignal: timeoutController.signal
+      });
+      rawText = textResult.text;
+      usage = toTokenStats(textResult.usage);
+      const extracted = extractJsonFromText(rawText);
+      if (extracted) {
+        const validated = validateWithSchema(extracted, schema);
+        if (validated !== null) {
+          return { data: validated, success: true, status: "success_repaired", fallbackUsed: true, rawText, usage };
+        }
+        status = "schema_error";
+      } else {
+        status = "parse_error";
+      }
+      if (fallbackParser && allowFallbackParser) {
+        const fallbackData = fallbackParser(rawText);
+        if (fallbackData) {
+          const validated = validateWithSchema(fallbackData, schema);
+          if (validated !== null) {
+            return { data: validated, success: true, status: "success_repaired", fallbackUsed: true, rawText, usage };
+          }
+        }
+      }
+    } catch {
+    }
+  }
+  return {
+    data: null,
+    success: false,
+    status,
+    fallbackUsed: false,
+    rawText,
+    error: status === "timeout" ? "Request timed out" : `Failed to generate valid ${schemaName}`,
+    usage
+  };
+}
+export {
+  generateStructured
+};

package/dist/structured-output/index.d.ts

@@ -0,0 +1,4 @@
+export * from './types.js';
+export { generateStructured } from './generator.js';
+export * from './schemas/evidence.js';
+//# sourceMappingURL=index.d.ts.map

package/dist/structured-output/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/structured-output/index.ts"],"names":[],"mappings":"AAAA,cAAc,YAAY,CAAC;AAC3B,OAAO,EAAE,kBAAkB,EAAE,MAAM,gBAAgB,CAAC;AACpD,cAAc,uBAAuB,CAAC"}

package/dist/structured-output/index.js

@@ -0,0 +1,6 @@
+export * from "./types.js";
+import { generateStructured } from "./generator.js";
+export * from "./schemas/evidence.js";
+export {
+  generateStructured
+};

package/dist/structured-output/schemas/evidence.d.ts

@@ -0,0 +1,88 @@
+import { z } from 'zod';
+export declare const QuestionTypeSchema: z.ZodEnum<{
+    unknown: "unknown";
+    count: "count";
+    fact: "fact";
+    list: "list";
+    opinion: "opinion";
+    recommendation: "recommendation";
+    timeline: "timeline";
+    mixed: "mixed";
+}>;
+export declare const ConfidenceLevelSchema: z.ZodEnum<{
+    high: "high";
+    medium: "medium";
+    low: "low";
+}>;
+export declare const CountModeSchema: z.ZodEnum<{
+    exact: "exact";
+    unknown: "unknown";
+    at_least: "at_least";
+}>;
+export declare const EvidenceEntitySchema: z.ZodObject<{
+    name: z.ZodString;
+    relation: z.ZodString;
+    status: z.ZodString;
+    count: z.ZodOptional<z.ZodNumber>;
+    countMode: z.ZodOptional<z.ZodEnum<{
+        exact: "exact";
+        unknown: "unknown";
+        at_least: "at_least";
+    }>>;
+    note: z.ZodOptional<z.ZodString>;
+    evidenceUrls: z.ZodArray<z.ZodString>;
+}, z.core.$strip>;
+export declare const EvidenceFindingSchema: z.ZodObject<{
+    claim: z.ZodString;
+    confidence: z.ZodEnum<{
+        high: "high";
+        medium: "medium";
+        low: "low";
+    }>;
+    evidenceUrls: z.ZodArray<z.ZodString>;
+}, z.core.$strip>;
+export declare const EvidenceAnalysisSchema: z.ZodObject<{
+    questionType: z.ZodEnum<{
+        unknown: "unknown";
+        count: "count";
+        fact: "fact";
+        list: "list";
+        opinion: "opinion";
+        recommendation: "recommendation";
+        timeline: "timeline";
+        mixed: "mixed";
+    }>;
+    directAnswer: z.ZodString;
+    entities: z.ZodArray<z.ZodObject<{
+        name: z.ZodString;
+        relation: z.ZodString;
+        status: z.ZodString;
+        count: z.ZodOptional<z.ZodNumber>;
+        countMode: z.ZodOptional<z.ZodEnum<{
+            exact: "exact";
+            unknown: "unknown";
+            at_least: "at_least";
+        }>>;
+        note: z.ZodOptional<z.ZodString>;
+        evidenceUrls: z.ZodArray<z.ZodString>;
+    }, z.core.$strip>>;
+    keyFindings: z.ZodArray<z.ZodObject<{
+        claim: z.ZodString;
+        confidence: z.ZodEnum<{
+            high: "high";
+            medium: "medium";
+            low: "low";
+        }>;
+        evidenceUrls: z.ZodArray<z.ZodString>;
+    }, z.core.$strip>>;
+    uncertainties: z.ZodArray<z.ZodString>;
+    recommendedUrls: z.ZodArray<z.ZodString>;
+}, z.core.$strip>;
+export type QuestionType = z.infer<typeof QuestionTypeSchema>;
+export type ConfidenceLevel = z.infer<typeof ConfidenceLevelSchema>;
+export type CountMode = z.infer<typeof CountModeSchema>;
+export type EvidenceEntity = z.infer<typeof EvidenceEntitySchema>;
+export type EvidenceFinding = z.infer<typeof EvidenceFindingSchema>;
+export type EvidenceAnalysis = z.infer<typeof EvidenceAnalysisSchema>;
+export declare const EVIDENCE_ANALYSIS_SYSTEM_PROMPT = "\u4F60\u662F\u68C0\u7D22\u8BC1\u636E\u5206\u6790\u5668\u3002\u628A evidence pack \u6574\u7406\u6210 JSON \u7ED3\u8BBA\uFF0C\u4E0D\u5199\u6700\u7EC8\u56DE\u7B54\u3002\n\n\u89C4\u5219\uFF1A\n- \u53EA\u7528 evidence pack \u4E2D\u7684\u4E8B\u5B9E\uFF0C\u7981\u6B62\u8865\u5145\n- \u53EA\u8F93\u51FA JSON\uFF0C\u4E0D\u8981 Markdown\n- evidenceUrls \u5FC5\u987B\u9010\u5B57\u7528 evidence pack \u7ED9\u51FA\u7684\u5B8C\u6574 URL\n- \u8BC1\u636E\u4E0D\u8DB3\u65F6\u7528 uncertainties \u8BF4\u660E\uFF0C\u4E0D\u8981\u786C\u731C\n- \u805A\u5408\u7C7B\u95EE\u9898\uFF08\u53BB\u8FC7/\u8BFB\u8FC7/\u8DD1\u8FC7\u51E0\u6B21\uFF09\uFF1A\u53BB\u91CD\u3001\u533A\u5206 visited/planned/mentioned\n- \u540C\u4E00\u4E8B\u4EF6\u591A\u7BC7\u6587\u7AE0\u4E0D\u7B49\u4E8E\u591A\u6B21\n- countMode \u4F18\u5148 at_least \u6216 unknown\uFF0C\u9664\u975E\u8BC1\u636E\u660E\u786E\u5199\u4E86\u603B\u6570\n- entities\u22646 note\u7B80\u77ED\uFF1BkeyFindings\u22644\uFF1BrecommendedUrls\u22643\n\n\u8F93\u51FAJSON\u683C\u5F0F\uFF1A\n{\n  \"questionType\": \"fact|list|count|timeline|recommendation|opinion|mixed|unknown\",\n  \"directAnswer\": \"\u4E00\u53E5\u8BDD\u7ED3\u8BBA\",\n  \"entities\": [{\"name\":\"\",\"relation\":\"\",\"status\":\"\",\"count\":2,\"countMode\":\"exact|at_least|unknown\",\"note\":\"\",\"evidenceUrls\":[]}],\n  \"keyFindings\": [{\"claim\":\"\",\"confidence\":\"high|medium|low\",\"evidenceUrls\":[]}],\n  \"uncertainties\": [],\n  \"recommendedUrls\": []\n}";
+//# sourceMappingURL=evidence.d.ts.map

package/dist/structured-output/schemas/evidence.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"evidence.d.ts","sourceRoot":"","sources":["../../../src/structured-output/schemas/evidence.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AAExB,eAAO,MAAM,kBAAkB;;;;;;;;;EAS7B,CAAC;AAEH,eAAO,MAAM,qBAAqB;;;;EAAoC,CAAC;AAEvE,eAAO,MAAM,eAAe;;;;EAA2C,CAAC;AAExE,eAAO,MAAM,oBAAoB;;;;;;;;;;;;iBAQ/B,CAAC;AAEH,eAAO,MAAM,qBAAqB;;;;;;;;iBAIhC,CAAC;AAEH,eAAO,MAAM,sBAAsB;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;iBAOjC,CAAC;AAEH,MAAM,MAAM,YAAY,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,kBAAkB,CAAC,CAAC;AAC9D,MAAM,MAAM,eAAe,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,qBAAqB,CAAC,CAAC;AACpE,MAAM,MAAM,SAAS,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,eAAe,CAAC,CAAC;AACxD,MAAM,MAAM,cAAc,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,oBAAoB,CAAC,CAAC;AAClE,MAAM,MAAM,eAAe,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,qBAAqB,CAAC,CAAC;AACpE,MAAM,MAAM,gBAAgB,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,sBAAsB,CAAC,CAAC;AAEtE,eAAO,MAAM,+BAA+B,s7CAoB1C,CAAC"}

package/dist/structured-output/schemas/evidence.js

@@ -0,0 +1,65 @@
+import { z } from "zod";
+const QuestionTypeSchema = z.enum([
+  "fact",
+  "list",
+  "count",
+  "timeline",
+  "recommendation",
+  "opinion",
+  "mixed",
+  "unknown"
+]);
+const ConfidenceLevelSchema = z.enum(["high", "medium", "low"]);
+const CountModeSchema = z.enum(["exact", "at_least", "unknown"]);
+const EvidenceEntitySchema = z.object({
+  name: z.string(),
+  relation: z.string(),
+  status: z.string(),
+  count: z.number().int().positive().optional(),
+  countMode: CountModeSchema.optional(),
+  note: z.string().optional(),
+  evidenceUrls: z.array(z.string())
+});
+const EvidenceFindingSchema = z.object({
+  claim: z.string(),
+  confidence: ConfidenceLevelSchema,
+  evidenceUrls: z.array(z.string())
+});
+const EvidenceAnalysisSchema = z.object({
+  questionType: QuestionTypeSchema,
+  directAnswer: z.string(),
+  entities: z.array(EvidenceEntitySchema).max(6),
+  keyFindings: z.array(EvidenceFindingSchema).max(4),
+  uncertainties: z.array(z.string()).max(6),
+  recommendedUrls: z.array(z.string()).max(3)
+});
+const EVIDENCE_ANALYSIS_SYSTEM_PROMPT = `\u4F60\u662F\u68C0\u7D22\u8BC1\u636E\u5206\u6790\u5668\u3002\u628A evidence pack \u6574\u7406\u6210 JSON \u7ED3\u8BBA\uFF0C\u4E0D\u5199\u6700\u7EC8\u56DE\u7B54\u3002
+
+\u89C4\u5219\uFF1A
+- \u53EA\u7528 evidence pack \u4E2D\u7684\u4E8B\u5B9E\uFF0C\u7981\u6B62\u8865\u5145
+- \u53EA\u8F93\u51FA JSON\uFF0C\u4E0D\u8981 Markdown
+- evidenceUrls \u5FC5\u987B\u9010\u5B57\u7528 evidence pack \u7ED9\u51FA\u7684\u5B8C\u6574 URL
+- \u8BC1\u636E\u4E0D\u8DB3\u65F6\u7528 uncertainties \u8BF4\u660E\uFF0C\u4E0D\u8981\u786C\u731C
+- \u805A\u5408\u7C7B\u95EE\u9898\uFF08\u53BB\u8FC7/\u8BFB\u8FC7/\u8DD1\u8FC7\u51E0\u6B21\uFF09\uFF1A\u53BB\u91CD\u3001\u533A\u5206 visited/planned/mentioned
+- \u540C\u4E00\u4E8B\u4EF6\u591A\u7BC7\u6587\u7AE0\u4E0D\u7B49\u4E8E\u591A\u6B21
+- countMode \u4F18\u5148 at_least \u6216 unknown\uFF0C\u9664\u975E\u8BC1\u636E\u660E\u786E\u5199\u4E86\u603B\u6570
+- entities\u22646 note\u7B80\u77ED\uFF1BkeyFindings\u22644\uFF1BrecommendedUrls\u22643
+
+\u8F93\u51FAJSON\u683C\u5F0F\uFF1A
+{
+  "questionType": "fact|list|count|timeline|recommendation|opinion|mixed|unknown",
+  "directAnswer": "\u4E00\u53E5\u8BDD\u7ED3\u8BBA",
+  "entities": [{"name":"","relation":"","status":"","count":2,"countMode":"exact|at_least|unknown","note":"","evidenceUrls":[]}],
+  "keyFindings": [{"claim":"","confidence":"high|medium|low","evidenceUrls":[]}],
+  "uncertainties": [],
+  "recommendedUrls": []
+}`;
+export {
+  ConfidenceLevelSchema,
+  CountModeSchema,
+  EVIDENCE_ANALYSIS_SYSTEM_PROMPT,
+  EvidenceAnalysisSchema,
+  EvidenceEntitySchema,
+  EvidenceFindingSchema,
+  QuestionTypeSchema
+};

package/dist/structured-output/types.d.ts

@@ -0,0 +1,69 @@
+import type { z } from 'zod';
+import type { TokenUsageStats } from '../intelligence/types.js';
+export type { TokenUsageStats } from '../intelligence/types.js';
+export type StructuredOutputStatus = 'success' | 'success_repaired' | 'schema_error' | 'parse_error' | 'request_error' | 'timeout';
+export interface StructuredOutputConfig<T> {
+    schema: z.ZodSchema<T>;
+    schemaName?: string;
+    schemaDescription?: string;
+    fallbackParser?: (rawText: string) => T | null;
+    repairStrategy?: 'strict' | 'lenient' | 'none';
+    timeoutMs?: number;
+    maxOutputTokens?: number;
+    temperature?: number;
+}
+export interface RepairResult<T> {
+    data: T | null;
+    success: boolean;
+    repairsApplied: string[];
+}
+export interface StructuredOutputResult<T> {
+    data: T | null;
+    success: boolean;
+    status: StructuredOutputStatus;
+    fallbackUsed: boolean;
+    rawText?: string;
+    error?: string;
+    usage?: TokenUsageStats;
+}
+export interface StructuredOutputProvider {
+    generateObject<T>(options: {
+        schema: z.ZodSchema<T>;
+        schemaName?: string;
+        schemaDescription?: string;
+        systemPrompt: string;
+        userPrompt: string;
+        temperature?: number;
+        maxOutputTokens?: number;
+        abortSignal?: AbortSignal;
+    }): Promise<{
+        object: T;
+        usage?: {
+            inputTokens?: number;
+            outputTokens?: number;
+            totalTokens?: number;
+        };
+    }>;
+    generateText(options: {
+        systemPrompt: string;
+        userPrompt: string;
+        temperature?: number;
+        maxOutputTokens?: number;
+        abortSignal?: AbortSignal;
+    }): Promise<{
+        text: string;
+        usage?: {
+            inputTokens?: number;
+            outputTokens?: number;
+            totalTokens?: number;
+        };
+    }>;
+}
+export interface GenerateStructuredOptions<T> {
+    config: StructuredOutputConfig<T>;
+    provider: StructuredOutputProvider;
+    systemPrompt: string;
+    userPrompt: string;
+    abortSignal?: AbortSignal;
+}
+//# sourceMappingURL=types.d.ts.map

package/dist/structured-output/types.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"types.d.ts","sourceRoot":"","sources":["../../src/structured-output/types.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AAC7B,OAAO,KAAK,EAAE,eAAe,EAAE,MAAM,0BAA0B,CAAC;AAEhE,YAAY,EAAE,eAAe,EAAE,MAAM,0BAA0B,CAAC;AAEhE,MAAM,MAAM,sBAAsB,GAC9B,SAAS,GACT,kBAAkB,GAClB,cAAc,GACd,aAAa,GACb,eAAe,GACf,SAAS,CAAC;AAEd,MAAM,WAAW,sBAAsB,CAAC,CAAC;IACvC,MAAM,EAAE,CAAC,CAAC,SAAS,CAAC,CAAC,CAAC,CAAC;IACvB,UAAU,CAAC,EAAE,MAAM,CAAC;IACpB,iBAAiB,CAAC,EAAE,MAAM,CAAC;IAC3B,cAAc,CAAC,EAAE,CAAC,OAAO,EAAE,MAAM,KAAK,CAAC,GAAG,IAAI,CAAC;IAC/C,cAAc,CAAC,EAAE,QAAQ,GAAG,SAAS,GAAG,MAAM,CAAC;IAC/C,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,eAAe,CAAC,EAAE,MAAM,CAAC;IACzB,WAAW,CAAC,EAAE,MAAM,CAAC;CACtB;AAED,MAAM,WAAW,YAAY,CAAC,CAAC;IAC7B,IAAI,EAAE,CAAC,GAAG,IAAI,CAAC;IACf,OAAO,EAAE,OAAO,CAAC;IACjB,cAAc,EAAE,MAAM,EAAE,CAAC;CAC1B;AAED,MAAM,WAAW,sBAAsB,CAAC,CAAC;IACvC,IAAI,EAAE,CAAC,GAAG,IAAI,CAAC;IACf,OAAO,EAAE,OAAO,CAAC;IACjB,MAAM,EAAE,sBAAsB,CAAC;IAC/B,YAAY,EAAE,OAAO,CAAC;IACtB,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,KAAK,CAAC,EAAE,eAAe,CAAC;CACzB;AAED,MAAM,WAAW,wBAAwB;IACvC,cAAc,CAAC,CAAC,EAAE,OAAO,EAAE;QACzB,MAAM,EAAE,CAAC,CAAC,SAAS,CAAC,CAAC,CAAC,CAAC;QACvB,UAAU,CAAC,EAAE,MAAM,CAAC;QACpB,iBAAiB,CAAC,EAAE,MAAM,CAAC;QAC3B,YAAY,EAAE,MAAM,CAAC;QACrB,UAAU,EAAE,MAAM,CAAC;QACnB,WAAW,CAAC,EAAE,MAAM,CAAC;QACrB,eAAe,CAAC,EAAE,MAAM,CAAC;QACzB,WAAW,CAAC,EAAE,WAAW,CAAC;KAC3B,GAAG,OAAO,CAAC;QACV,MAAM,EAAE,CAAC,CAAC;QACV,KAAK,CAAC,EAAE;YAAE,WAAW,CAAC,EAAE,MAAM,CAAC;YAAC,YAAY,CAAC,EAAE,MAAM,CAAC;YAAC,WAAW,CAAC,EAAE,MAAM,CAAA;SAAE,CAAC;KAC/E,CAAC,CAAC;IAEH,YAAY,CAAC,OAAO,EAAE;QACpB,YAAY,EAAE,MAAM,CAAC;QACrB,UAAU,EAAE,MAAM,CAAC;QACnB,WAAW,CAAC,EAAE,MAAM,CAAC;QACrB,eAAe,CAAC,EAAE,MAAM,CAAC;QACzB,WAAW,CAAC,EAAE,WAAW,CAAC;KAC3B,GAAG,OAAO,CAAC;QACV,IAAI,EAAE,MAAM,CAAC;QACb,KAAK,CAAC,EAAE;YAAE,WAAW,CAAC,EAAE,MAAM,CAAC;YAAC,YAAY,CAAC,EAAE,MAAM,CAAC;YAAC,WAAW,CAAC,EAAE,MAAM,CAAA;SAAE,CAAC;KAC/E,CAAC,CAAC;CACJ;AAED,MAAM,WAAW,yBAAyB,CAAC,CAAC;IAC1C,MAAM,EAAE,sBAAsB,CAAC,CAAC,CAAC,CAAC;IAClC,QAAQ,EAAE,wBAAwB,CAAC;IACnC,YAAY,EAAE,MAAM,CAAC;IACrB,UAAU,EAAE,MAAM,CAAC;IACnB,WAAW,CAAC,EAAE,WAAW,CAAC;CAC3B"}

package/dist/tools/action-tools.d.ts

@@ -0,0 +1,63 @@
+import { type Tool } from "ai";
+export declare const toggleThemeTool: Tool<{
+    theme: "system" | "light" | "dark";
+}, never>;
+export declare const navigateToArticleTool: Tool<{
+    slug: string;
+    sectionId?: string | undefined;
+    lang?: "zh" | "en" | undefined;
+}, never>;
+export declare const scrollToSectionTool: Tool<{
+    sectionId: string;
+    highlight?: boolean | undefined;
+    behavior?: "smooth" | "instant" | undefined;
+}, never>;
+export declare const toggleReadingModeTool: Tool<{
+    enabled?: boolean | undefined;
+    fontSize?: "md" | "sm" | "lg" | "xl" | undefined;
+    fontFamily?: string | undefined;
+}, never>;
+export declare const highlightTextTool: Tool<{
+    text?: string | undefined;
+    selector?: string | undefined;
+    style?: "info" | "success" | "accent" | "warning" | undefined;
+    duration?: number | undefined;
+    scrollIntoView?: boolean | undefined;
+}, never>;
+export declare const setPreferenceTool: Tool<{
+    key: string;
+    value: unknown;
+}, never>;
+interface SearchResultItem {
+    title: string;
+    url: string;
+    excerpt: string;
+    categories: string[];
+    tags: string[];
+    keyPoints: string[];
+    dateTime: number;
+    lang: string;
+    score?: number;
+}
+export declare const searchArticlesTool: Tool<{
+    query: string;
+    limit: number;
+    includeProjects: boolean;
+}, {
+    articles: SearchResultItem[];
+    projects: {
+        name: string;
+        url: string;
+        description: string;
+    }[];
+}>;
+type AnyTool = Tool;
+export declare function registerTool(name: string, definition: AnyTool): void;
+export declare function unregisterTool(name: string): void;
+export declare function getAllTools(): Record<string, AnyTool>;
+export declare const allTools: Record<string, AnyTool>;
+export type ToolName = string;
+export declare function getClientSideTools(): string[];
+export declare function getServerSideTools(): string[];
+export {};
+//# sourceMappingURL=action-tools.d.ts.map

package/dist/tools/action-tools.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"action-tools.d.ts","sourceRoot":"","sources":["../../src/tools/action-tools.ts"],"names":[],"mappings":"AAAA,OAAO,EAAQ,KAAK,IAAI,EAAE,MAAM,IAAI,CAAC;AAIrC,eAAO,MAAM,eAAe;;SAU1B,CAAC;AAEH,eAAO,MAAM,qBAAqB;;;;SAoBhC,CAAC;AAEH,eAAO,MAAM,mBAAmB;;;;SAoB9B,CAAC;AAEH,eAAO,MAAM,qBAAqB;;;;SAgBhC,CAAC;AAEH,eAAO,MAAM,iBAAiB;;;;;;SAwB5B,CAAC;AAEH,eAAO,MAAM,iBAAiB;;;SAS5B,CAAC;AAEH,UAAU,gBAAgB;IACxB,KAAK,EAAE,MAAM,CAAC;IACd,GAAG,EAAE,MAAM,CAAC;IACZ,OAAO,EAAE,MAAM,CAAC;IAChB,UAAU,EAAE,MAAM,EAAE,CAAC;IACrB,IAAI,EAAE,MAAM,EAAE,CAAC;IACf,SAAS,EAAE,MAAM,EAAE,CAAC;IACpB,QAAQ,EAAE,MAAM,CAAC;IACjB,IAAI,EAAE,MAAM,CAAC;IACb,KAAK,CAAC,EAAE,MAAM,CAAC;CAChB;AAED,eAAO,MAAM,kBAAkB;;;;;cAqBjB,gBAAgB,EAAE;cAClB;QAAE,IAAI,EAAE,MAAM,CAAC;QAAC,GAAG,EAAE,MAAM,CAAC;QAAC,WAAW,EAAE,MAAM,CAAA;KAAE,EAAE;EAwBhE,CAAC;AAYH,KAAK,OAAO,GAAG,IAAI,CAAC;AAGpB,wBAAgB,YAAY,CAAC,IAAI,EAAE,MAAM,EAAE,UAAU,EAAE,OAAO,GAAG,IAAI,CAEpE;AAED,wBAAgB,cAAc,CAAC,IAAI,EAAE,MAAM,GAAG,IAAI,CAEjD;AAED,wBAAgB,WAAW,IAAI,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAErD;AAED,eAAO,MAAM,QAAQ,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAgB,CAAC;AAE9D,MAAM,MAAM,QAAQ,GAAG,MAAM,CAAC;AAY9B,wBAAgB,kBAAkB,IAAI,MAAM,EAAE,CAO7C;AAED,wBAAgB,kBAAkB,IAAI,MAAM,EAAE,CAO7C"}