@astro-minimax/ai 0.9.0 → 0.9.3

package/dist/tools/action-tools.js

@@ -0,0 +1,158 @@
+import { tool } from "ai";
+import { z } from "zod";
+import { searchArticles, searchProjects } from "../search/search-api.js";
+const toggleThemeTool = tool({
+  description: "Toggle the blog theme between light, dark, and system modes. Use this when the user wants to change the visual theme of the blog.",
+  inputSchema: z.object({
+    theme: z.enum(["light", "dark", "system"]).describe(
+      'The theme to switch to: "light" for bright mode, "dark" for dark mode, "system" to follow system preference'
+    )
+  })
+});
+const navigateToArticleTool = tool({
+  description: "Navigate to a specific blog article by its slug. Use this when the user wants to open or jump to a specific article.",
+  inputSchema: z.object({
+    slug: z.string().describe(
+      'The URL slug of the article to navigate to (e.g., "ai-module-architecture")'
+    ),
+    sectionId: z.string().optional().describe(
+      'Optional: The section ID to scroll to after navigation (e.g., "\u4E09\u7CFB\u7EDF\u67B6\u6784\u8BBE\u8BA1")'
+    ),
+    lang: z.enum(["zh", "en"]).optional().describe('Optional: The language of the article (defaults to "zh")')
+  })
+});
+const scrollToSectionTool = tool({
+  description: "Scroll to a specific section within the current article. Use this when the user wants to jump to a chapter or section.",
+  inputSchema: z.object({
+    sectionId: z.string().describe(
+      'The ID of the section to scroll to (e.g., "\u4E09\u7CFB\u7EDF\u67B6\u6784\u8BBE\u8BA1" or "chapter-3")'
+    ),
+    highlight: z.boolean().optional().describe(
+      "Whether to highlight the section after scrolling (default: true)"
+    ),
+    behavior: z.enum(["smooth", "instant"]).optional().describe('Scroll behavior (default: "smooth")')
+  })
+});
+const toggleReadingModeTool = tool({
+  description: "Toggle reading mode on or off. Reading mode provides a distraction-free reading experience with larger text and optimized layout.",
+  inputSchema: z.object({
+    enabled: z.boolean().optional().describe(
+      "Whether to enable (true) or disable (false) reading mode. If not specified, toggles the current state."
+    ),
+    fontSize: z.enum(["sm", "md", "lg", "xl"]).optional().describe("Font size for reading mode"),
+    fontFamily: z.string().optional().describe("Font family for reading mode")
+  })
+});
+const highlightTextTool = tool({
+  description: "Highlight specific text in the article. Use this when the user wants to emphasize or mark text.",
+  inputSchema: z.object({
+    text: z.string().optional().describe("The text content to highlight"),
+    selector: z.string().optional().describe("CSS selector for the element to highlight"),
+    style: z.enum(["accent", "warning", "info", "success"]).optional().describe('Highlight style (default: "accent")'),
+    duration: z.number().optional().describe(
+      "Duration in milliseconds for the highlight effect (default: 3000, 0 for permanent)"
+    ),
+    scrollIntoView: z.boolean().optional().describe("Whether to scroll the highlighted element into view")
+  })
+});
+const setPreferenceTool = tool({
+  description: "Set a user preference value. Use this when the user wants to customize their experience.",
+  inputSchema: z.object({
+    key: z.string().describe('The preference key (e.g., "theme", "reading.fontSize")'),
+    value: z.unknown().describe("The value to set")
+  })
+});
+const searchArticlesTool = tool({
+  description: 'Search for blog articles and projects matching a query. Use this when the user wants to find specific content or when they ask to navigate to a topic (e.g., "AI module", "architecture"). Returns matching articles with titles, URLs, and summaries.',
+  inputSchema: z.object({
+    query: z.string().describe("The search query (keywords or topic)"),
+    limit: z.number().optional().default(5).describe("Maximum number of results to return (default: 5)"),
+    includeProjects: z.boolean().optional().default(true).describe("Whether to include projects in search results")
+  }),
+  execute: async ({
+    query,
+    limit,
+    includeProjects
+  }) => {
+    const articles = searchArticles(query);
+    const projects = includeProjects ? searchProjects(query) : [];
+    return {
+      articles: articles.slice(0, limit ?? 5).map((a) => ({
+        title: a.title,
+        url: a.url,
+        excerpt: a.summary?.slice(0, 200) ?? "",
+        categories: a.categories ?? [],
+        tags: [],
+        keyPoints: a.keyPoints ?? [],
+        dateTime: a.dateTime,
+        lang: "zh",
+        score: a.score
+      })),
+      projects: projects.slice(0, 3).map((p) => ({
+        name: p.name,
+        url: p.url,
+        description: p.description?.slice(0, 200) ?? ""
+      }))
+    };
+  }
+});
+const builtinTools = {
+  toggleTheme: toggleThemeTool,
+  navigateToArticle: navigateToArticleTool,
+  scrollToSection: scrollToSectionTool,
+  toggleReadingMode: toggleReadingModeTool,
+  highlightText: highlightTextTool,
+  setPreference: setPreferenceTool,
+  searchArticles: searchArticlesTool
+};
+const customTools = {};
+function registerTool(name, definition) {
+  customTools[name] = definition;
+}
+function unregisterTool(name) {
+  delete customTools[name];
+}
+function getAllTools() {
+  return { ...builtinTools, ...customTools };
+}
+const allTools = builtinTools;
+const BUILTIN_CLIENT_TOOLS = [
+  "toggleTheme",
+  "navigateToArticle",
+  "scrollToSection",
+  "toggleReadingMode",
+  "highlightText",
+  "setPreference"
+];
+const BUILTIN_SERVER_TOOLS = ["searchArticles"];
+function getClientSideTools() {
+  return [
+    ...BUILTIN_CLIENT_TOOLS,
+    ...Object.keys(customTools).filter(
+      (k) => !customTools[k].execute
+    )
+  ];
+}
+function getServerSideTools() {
+  return [
+    ...BUILTIN_SERVER_TOOLS,
+    ...Object.keys(customTools).filter(
+      (k) => !!customTools[k].execute
+    )
+  ];
+}
+export {
+  allTools,
+  getAllTools,
+  getClientSideTools,
+  getServerSideTools,
+  highlightTextTool,
+  navigateToArticleTool,
+  registerTool,
+  scrollToSectionTool,
+  searchArticlesTool,
+  setPreferenceTool,
+  toggleReadingModeTool,
+  toggleThemeTool,
+  unregisterTool
+};

package/dist/tools/index.d.ts

@@ -0,0 +1,2 @@
+export { allTools, getAllTools, registerTool, unregisterTool, toggleThemeTool, navigateToArticleTool, scrollToSectionTool, toggleReadingModeTool, highlightTextTool, setPreferenceTool, searchArticlesTool, getClientSideTools, getServerSideTools, type ToolName, } from "./action-tools.js";
+//# sourceMappingURL=index.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/tools/index.ts"],"names":[],"mappings":"AAAA,OAAO,EACL,QAAQ,EACR,WAAW,EACX,YAAY,EACZ,cAAc,EACd,eAAe,EACf,qBAAqB,EACrB,mBAAmB,EACnB,qBAAqB,EACrB,iBAAiB,EACjB,iBAAiB,EACjB,kBAAkB,EAClB,kBAAkB,EAClB,kBAAkB,EAClB,KAAK,QAAQ,GACd,MAAM,mBAAmB,CAAC"}

package/dist/tools/index.js

@@ -0,0 +1,30 @@
+import {
+  allTools,
+  getAllTools,
+  registerTool,
+  unregisterTool,
+  toggleThemeTool,
+  navigateToArticleTool,
+  scrollToSectionTool,
+  toggleReadingModeTool,
+  highlightTextTool,
+  setPreferenceTool,
+  searchArticlesTool,
+  getClientSideTools,
+  getServerSideTools
+} from "./action-tools.js";
+export {
+  allTools,
+  getAllTools,
+  getClientSideTools,
+  getServerSideTools,
+  highlightTextTool,
+  navigateToArticleTool,
+  registerTool,
+  scrollToSectionTool,
+  searchArticlesTool,
+  setPreferenceTool,
+  toggleReadingModeTool,
+  toggleThemeTool,
+  unregisterTool
+};

package/dist/utils/i18n.d.ts

@@ -14,5 +14,5 @@ export declare function t(key: AITranslationKey, lang?: string, vars?: Record<st
  * Get normalized language code.
  * Returns 'zh' for Chinese, 'en' for everything else.
  */
-export declare function getLang(lang?: string): string;
+export declare function getLang(lang?: string): "zh" | "en";
 //# sourceMappingURL=i18n.d.ts.map

package/dist/utils/i18n.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"i18n.d.ts","sourceRoot":"","sources":["../../src/utils/i18n.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAEH,MAAM,MAAM,gBAAgB,GAExB,uBAAuB,GACvB,4BAA4B,GAC5B,sBAAsB,GAEtB,kBAAkB,GAClB,kBAAkB,GAClB,oBAAoB,GACpB,sBAAsB,GACtB,kBAAkB,GAClB,iBAAiB,GACjB,mBAAmB,GAEnB,gBAAgB,GAChB,UAAU,GACV,sBAAsB,GACtB,UAAU,GACV,cAAc,GACd,UAAU,GACV,qBAAqB,GACrB,sBAAsB,GACtB,iBAAiB,GACjB,oBAAoB,GACpB,oBAAoB,GAEpB,qBAAqB,GACrB,qBAAqB,GACrB,iBAAiB,GACjB,qBAAqB,GACrB,mBAAmB,GACnB,mBAAmB,GAEnB,oBAAoB,GACpB,oBAAoB,GACpB,qBAAqB,GACrB,iBAAiB,GACjB,qBAAqB,GACrB,uBAAuB,GAEvB,mBAAmB,GACnB,gBAAgB,GAEhB,kBAAkB,GAClB,gBAAgB,GAEhB,uBAAuB,GACvB,uBAAuB,GACvB,uBAAuB,GACvB,kBAAkB,GAElB,0BAA0B,GAC1B,8BAA8B,GAC9B,0BAA0B,GAE1B,oCAAoC,GACpC,0BAA0B,GAC1B,8BAA8B,GAC9B,+BAA+B,GAC/B,gCAAgC,GAChC,2BAA2B,GAC3B,+BAA+B,GAC/B,mCAAmC,GAEnC,4BAA4B,GAC5B,0BAA0B,GAC1B,8BAA8B,GAC9B,8BAA8B,CAAC;AA2InC;;;;;GAKG;AACH,wBAAgB,CAAC,CAAC,GAAG,EAAE,gBAAgB,EAAE,IAAI,GAAE,MAAa,EAAE,IAAI,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,GAAG,MAAM,CAAC,GAAG,MAAM,CAY5G;AAED;;;GAGG;AACH,wBAAgB,OAAO,CAAC,IAAI,CAAC,EAAE,MAAM,GAAG,MAAM,CAE7C"}
+{"version":3,"file":"i18n.d.ts","sourceRoot":"","sources":["../../src/utils/i18n.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAEH,MAAM,MAAM,gBAAgB,GAExB,uBAAuB,GACvB,4BAA4B,GAC5B,sBAAsB,GAEtB,kBAAkB,GAClB,kBAAkB,GAClB,oBAAoB,GACpB,sBAAsB,GACtB,kBAAkB,GAClB,iBAAiB,GACjB,mBAAmB,GAEnB,gBAAgB,GAChB,UAAU,GACV,sBAAsB,GACtB,UAAU,GACV,cAAc,GACd,UAAU,GACV,qBAAqB,GACrB,sBAAsB,GACtB,iBAAiB,GACjB,oBAAoB,GACpB,oBAAoB,GAEpB,qBAAqB,GACrB,qBAAqB,GACrB,iBAAiB,GACjB,qBAAqB,GACrB,mBAAmB,GACnB,mBAAmB,GAEnB,oBAAoB,GACpB,oBAAoB,GACpB,qBAAqB,GACrB,iBAAiB,GACjB,qBAAqB,GACrB,uBAAuB,GAEvB,mBAAmB,GACnB,gBAAgB,GAEhB,kBAAkB,GAClB,gBAAgB,GAEhB,uBAAuB,GACvB,uBAAuB,GACvB,uBAAuB,GACvB,kBAAkB,GAElB,0BAA0B,GAC1B,8BAA8B,GAC9B,0BAA0B,GAE1B,oCAAoC,GACpC,0BAA0B,GAC1B,8BAA8B,GAC9B,+BAA+B,GAC/B,gCAAgC,GAChC,2BAA2B,GAC3B,+BAA+B,GAC/B,mCAAmC,GAEnC,4BAA4B,GAC5B,0BAA0B,GAC1B,8BAA8B,GAC9B,8BAA8B,CAAC;AAyJnC;;;;;GAKG;AACH,wBAAgB,CAAC,CACf,GAAG,EAAE,gBAAgB,EACrB,IAAI,GAAE,MAAa,EACnB,IAAI,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,GAAG,MAAM,CAAC,GACrC,MAAM,CAYR;AAED;;;GAGG;AACH,wBAAgB,OAAO,CAAC,IAAI,CAAC,EAAE,MAAM,GAAG,IAAI,GAAG,IAAI,CAElD"}

package/dist/utils/i18n.js

@@ -136,7 +136,7 @@ Ask me to summarize, explain a concept, or explore related topics.`,
   }
 };
 function t(key, lang = "zh", vars) {
-  const l = lang === "zh" ? "zh" : "en";
+  const l = getLang(lang);
   let text = translations[l]?.[key] ?? translations["en"][key] ?? key;
   if (vars) {
     for (const [k, v] of Object.entries(vars)) {

package/dist/utils/logger.d.ts

@@ -0,0 +1,11 @@
+export type LogLevel = 'debug' | 'info' | 'warn' | 'error' | 'silent';
+export interface Logger {
+    debug(message: string, ...args: unknown[]): void;
+    info(message: string, ...args: unknown[]): void;
+    warn(message: string, ...args: unknown[]): void;
+    error(message: string, ...args: unknown[]): void;
+}
+export declare function setLogLevel(level: LogLevel): void;
+export declare function getLogLevel(): LogLevel;
+export declare function createLogger(namespace: string): Logger;
+//# sourceMappingURL=logger.d.ts.map

package/dist/utils/logger.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"logger.d.ts","sourceRoot":"","sources":["../../src/utils/logger.ts"],"names":[],"mappings":"AAAA,MAAM,MAAM,QAAQ,GAAG,OAAO,GAAG,MAAM,GAAG,MAAM,GAAG,OAAO,GAAG,QAAQ,CAAC;AAEtE,MAAM,WAAW,MAAM;IACrB,KAAK,CAAC,OAAO,EAAE,MAAM,EAAE,GAAG,IAAI,EAAE,OAAO,EAAE,GAAG,IAAI,CAAC;IACjD,IAAI,CAAC,OAAO,EAAE,MAAM,EAAE,GAAG,IAAI,EAAE,OAAO,EAAE,GAAG,IAAI,CAAC;IAChD,IAAI,CAAC,OAAO,EAAE,MAAM,EAAE,GAAG,IAAI,EAAE,OAAO,EAAE,GAAG,IAAI,CAAC;IAChD,KAAK,CAAC,OAAO,EAAE,MAAM,EAAE,GAAG,IAAI,EAAE,OAAO,EAAE,GAAG,IAAI,CAAC;CAClD;AAYD,wBAAgB,WAAW,CAAC,KAAK,EAAE,QAAQ,GAAG,IAAI,CAEjD;AAED,wBAAgB,WAAW,IAAI,QAAQ,CAEtC;AAED,wBAAgB,YAAY,CAAC,SAAS,EAAE,MAAM,GAAG,MAAM,CAiBtD"}

package/dist/utils/logger.js

@@ -0,0 +1,36 @@
+const LOG_LEVELS = {
+  debug: 0,
+  info: 1,
+  warn: 2,
+  error: 3,
+  silent: 4
+};
+let globalLevel = "warn";
+function setLogLevel(level) {
+  globalLevel = level;
+}
+function getLogLevel() {
+  return globalLevel;
+}
+function createLogger(namespace) {
+  const prefix = `[${namespace}]`;
+  return {
+    debug(message, ...args) {
+      if (LOG_LEVELS[globalLevel] <= LOG_LEVELS.debug) console.debug(prefix, message, ...args);
+    },
+    info(message, ...args) {
+      if (LOG_LEVELS[globalLevel] <= LOG_LEVELS.info) console.log(prefix, message, ...args);
+    },
+    warn(message, ...args) {
+      if (LOG_LEVELS[globalLevel] <= LOG_LEVELS.warn) console.warn(prefix, message, ...args);
+    },
+    error(message, ...args) {
+      if (LOG_LEVELS[globalLevel] <= LOG_LEVELS.error) console.error(prefix, message, ...args);
+    }
+  };
+}
+export {
+  createLogger,
+  getLogLevel,
+  setLogLevel
+};

package/dist/utils/text.d.ts

@@ -0,0 +1,11 @@
+/**
+ * Text normalization and tokenization utilities.
+ * Shared between search, intelligence, and other modules.
+ */
+export declare function normalizeText(text: string): string;
+export declare function tokenize(text: string): string[];
+export declare function dedupeByContainment(terms: string[]): string[];
+export declare function extractCodeAnchors(text: string): string[];
+export declare function hasCodeAnchors(text: string): boolean;
+export declare function normalizeCodeBlockLang(lang?: string): string;
+//# sourceMappingURL=text.d.ts.map

package/dist/utils/text.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"text.d.ts","sourceRoot":"","sources":["../../src/utils/text.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAEH,wBAAgB,aAAa,CAAC,IAAI,EAAE,MAAM,GAAG,MAAM,CAMlD;AAED,wBAAgB,QAAQ,CAAC,IAAI,EAAE,MAAM,GAAG,MAAM,EAAE,CAK/C;AA+BD,wBAAgB,mBAAmB,CAAC,KAAK,EAAE,MAAM,EAAE,GAAG,MAAM,EAAE,CAS7D;AAED,wBAAgB,kBAAkB,CAAC,IAAI,EAAE,MAAM,GAAG,MAAM,EAAE,CAqBzD;AAED,wBAAgB,cAAc,CAAC,IAAI,EAAE,MAAM,GAAG,OAAO,CAEpD;AAcD,wBAAgB,sBAAsB,CAAC,IAAI,CAAC,EAAE,MAAM,GAAG,MAAM,CAI5D"}

package/dist/utils/text.js

@@ -0,0 +1,87 @@
+function normalizeText(text) {
+  return text.toLowerCase().replace(/[^\u4e00-\u9fa5\w\s]/g, " ").replace(/\s+/g, " ").trim();
+}
+function tokenize(text) {
+  const normalized = normalizeText(text);
+  const parts = normalized.split(/\s+/).filter(Boolean);
+  const expanded = parts.flatMap((part) => expandToken(part));
+  return dedupeByContainment(expanded);
+}
+function expandToken(token) {
+  if (!token) return [];
+  if (/^[\u4e00-\u9fa5]+$/.test(token)) {
+    return buildCjkTokenVariants(token);
+  }
+  return [token];
+}
+function buildCjkTokenVariants(text) {
+  const chars = [...text].filter((char) => /[\u4e00-\u9fa5]/.test(char));
+  if (chars.length <= 1) return chars;
+  const variants = /* @__PURE__ */ new Set();
+  for (const char of chars) {
+    variants.add(char);
+  }
+  for (let size = 2; size <= Math.min(4, chars.length); size++) {
+    for (let i = 0; i <= chars.length - size; i++) {
+      variants.add(chars.slice(i, i + size).join(""));
+    }
+  }
+  variants.add(chars.join(""));
+  return [...variants];
+}
+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;
+}
+function extractCodeAnchors(text) {
+  if (!text.trim()) return [];
+  const anchors = /* @__PURE__ */ new Set();
+  const patterns = [
+    /`([^`]{2,})`/g,
+    /\b[a-z]+[A-Z][A-Za-z0-9]*\b/g,
+    /\buse[A-Z][A-Za-z0-9]*\b/g,
+    /\b[a-zA-Z_][\w-]*\.(?:ts|tsx|js|jsx|astro|md|json)\b/g,
+    /\b[a-zA-Z_][A-Za-z0-9_]*\(/g
+  ];
+  for (const pattern of patterns) {
+    for (const match of text.matchAll(pattern)) {
+      const rawValue = (match[1] ?? match[0] ?? "").trim();
+      const value = rawValue.endsWith("(") ? rawValue.slice(0, -1) : rawValue;
+      if (value.length >= 2) anchors.add(value);
+    }
+  }
+  return [...anchors].sort((a, b) => b.length - a.length);
+}
+function hasCodeAnchors(text) {
+  return extractCodeAnchors(text).length > 0;
+}
+const CODE_BLOCK_LANG_ALIASES = {
+  js: "javascript",
+  ts: "typescript",
+  py: "python",
+  rb: "ruby",
+  sh: "bash",
+  shell: "bash",
+  yml: "yaml",
+  md: "markdown",
+  text: "plaintext"
+};
+function normalizeCodeBlockLang(lang) {
+  if (!lang) return "plaintext";
+  const lower = lang.toLowerCase();
+  return CODE_BLOCK_LANG_ALIASES[lower] || lower;
+}
+export {
+  dedupeByContainment,
+  extractCodeAnchors,
+  hasCodeAnchors,
+  normalizeCodeBlockLang,
+  normalizeText,
+  tokenize
+};

package/dist/utils/url.d.ts

@@ -0,0 +1,19 @@
+/**
+ * URL utilities for safe URL construction.
+ */
+/**
+ * Safely joins a base URL with a path, preventing double slashes.
+ *
+ * @param baseUrl - The base URL (e.g., "https://example.com" or "https://example.com/")
+ * @param path - The path to append (e.g., "/posts/article" or "posts/article")
+ * @returns The joined URL without double slashes
+ *
+ * @example
+ * safeJoinUrl("https://example.com/", "/posts/article")  // "https://example.com/posts/article"
+ * safeJoinUrl("https://example.com", "posts/article")    // "https://example.com/posts/article"
+ * safeJoinUrl("https://example.com", "/posts/article")   // "https://example.com/posts/article"
+ * safeJoinUrl("", "/posts/article")                      // "/posts/article"
+ * safeJoinUrl("https://example.com/", "")                // "https://example.com"
+ */
+export declare function safeJoinUrl(baseUrl: string, path: string): string;
+//# sourceMappingURL=url.d.ts.map

package/dist/utils/url.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"url.d.ts","sourceRoot":"","sources":["../../src/utils/url.ts"],"names":[],"mappings":"AAAA;;GAEG;AAEH;;;;;;;;;;;;;GAaG;AACH,wBAAgB,WAAW,CAAC,OAAO,EAAE,MAAM,EAAE,IAAI,EAAE,MAAM,GAAG,MAAM,CAmBjE"}

package/dist/utils/url.js

@@ -0,0 +1,13 @@
+function safeJoinUrl(baseUrl, path) {
+  if (!baseUrl) return path;
+  if (!path) return baseUrl.replace(/\/+$/, "");
+  if (path.startsWith("http://") || path.startsWith("https://")) {
+    return path;
+  }
+  const cleanBase = baseUrl.replace(/\/+$/, "");
+  const cleanPath = path.startsWith("/") ? path : `/${path}`;
+  return `${cleanBase}${cleanPath}`;
+}
+export {
+  safeJoinUrl
+};

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@astro-minimax/ai",
-  "version": "0.9.0",
+  "version": "0.9.3",
   "type": "module",
   "description": "Vendor-agnostic AI integration package with full RAG pipeline for astro-minimax blogs — supports OpenAI, Cloudflare AI, and custom providers.",
   "author": "Souloss",
@@ -33,14 +33,14 @@
       "types": "./dist/index.d.ts",
       "import": "./dist/index.js"
     },
-    "./providers": {
-      "types": "./dist/providers/index.d.ts",
-      "import": "./dist/providers/index.js"
-    },
     "./middleware": {
       "types": "./dist/middleware/index.d.ts",
       "import": "./dist/middleware/index.js"
     },
+    "./cache": {
+      "types": "./dist/cache/index.d.ts",
+      "import": "./dist/cache/index.js"
+    },
     "./search": {
       "types": "./dist/search/index.d.ts",
       "import": "./dist/search/index.js"
@@ -61,14 +61,22 @@
       "types": "./dist/fact-registry/index.d.ts",
       "import": "./dist/fact-registry/index.js"
     },
-    "./stream": {
-      "types": "./dist/stream/index.d.ts",
-      "import": "./dist/stream/index.js"
-    },
     "./server": {
       "types": "./dist/server/index.d.ts",
       "import": "./dist/server/index.js"
     },
+    "./extensions": {
+      "types": "./dist/extensions/index.d.ts",
+      "import": "./dist/extensions/index.js"
+    },
+    "./structured-output": {
+      "types": "./dist/structured-output/index.d.ts",
+      "import": "./dist/structured-output/index.js"
+    },
+    "./tools": {
+      "types": "./dist/tools/index.d.ts",
+      "import": "./dist/tools/index.js"
+    },
     "./components/ChatPanel": {
       "types": "./dist/components/ChatPanel.d.ts",
       "import": "./dist/components/ChatPanel.js"
@@ -91,7 +99,8 @@
     "@ai-sdk/openai-compatible": "^2.0.35",
     "ai": "^6.0.116",
     "workers-ai-provider": "^3.1.2",
-    "@astro-minimax/notify": "0.7.5"
+    "zod": "^4.3.6",
+    "@astro-minimax/knowledge-model": "0.9.3"
   },
   "optionalDependencies": {
     "undici": "^6.0.0"
@@ -99,7 +108,12 @@
   "peerDependencies": {
     "@ai-sdk/react": "^3.0.0",
     "@cloudflare/workers-types": "^4.0.0",
-    "preact": "^10.0.0"
+    "preact": "^10.0.0",
+    "shiki": "^1.0.0 || ^2.0.0",
+    "mermaid": "^11.0.0",
+    "markmap-lib": "^0.18.0",
+    "markmap-view": "^0.18.0",
+    "@astro-minimax/notify": "0.9.3"
   },
   "peerDependenciesMeta": {
     "@ai-sdk/react": {
@@ -107,13 +121,30 @@
     },
     "preact": {
       "optional": true
+    },
+    "shiki": {
+      "optional": true
+    },
+    "mermaid": {
+      "optional": true
+    },
+    "markmap-lib": {
+      "optional": true
+    },
+    "markmap-view": {
+      "optional": true
+    },
+    "@astro-minimax/notify": {
+      "optional": true
     }
   },
   "devDependencies": {
     "@cloudflare/workers-types": "^4.0.0",
     "@types/node": "^22.0.0",
+    "@vitest/coverage-v8": "^3.0.0",
     "esbuild": "^0.25.0",
-    "typescript": "^5.9.3"
+    "typescript": "^5.9.3",
+    "vitest": "^3.0.0"
   },
   "engines": {
     "node": ">=22.12.0",
@@ -124,6 +155,9 @@
     "build:watch": "node scripts/build.mjs --watch",
     "build:components": "node scripts/build-components.mjs",
     "typecheck": "tsc --noEmit",
+    "test": "vitest run",
+    "test:watch": "vitest",
+    "test:coverage": "vitest run --coverage",
     "clean": "rm -rf dist"
   }
 }

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

@@ -1,40 +0,0 @@
-import type { CachedSearchContext, ArticleContext } from '../search/types.js';
-export type IntentCategory = 'setup' | 'config' | 'content' | 'feature' | 'deployment' | 'troubleshooting' | 'general';
-/**
- * Classifies the user query into an intent category.
- * Used to adjust search relevance scoring.
- */
-export declare function classifyIntent(query: string): IntentCategory;
-/**
- * Re-ranks articles by intent relevance with weighted multi-dimension scoring.
- * Scoring: title(+3) / categories(+2) / summary(+2) / keyPoints(+1) / recency(+1)
- */
-export declare function rankArticlesByIntent(query: string, articles: ArticleContext[]): ArticleContext[];
-/**
- * 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

@@ -1 +0,0 @@
-{"version":3,"file":"intent-detect.d.ts","sourceRoot":"","sources":["../../src/intelligence/intent-detect.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EAAE,mBAAmB,EAAE,cAAc,EAAE,MAAM,oBAAoB,CAAC;AAO9E,MAAM,MAAM,cAAc,GACtB,OAAO,GACP,QAAQ,GACR,SAAS,GACT,SAAS,GACT,YAAY,GACZ,iBAAiB,GACjB,SAAS,CAAC;AAYd;;;GAGG;AACH,wBAAgB,cAAc,CAAC,KAAK,EAAE,MAAM,GAAG,cAAc,CAY5D;AAiBD;;;GAGG;AACH,wBAAgB,oBAAoB,CAClC,KAAK,EAAE,MAAM,EACb,QAAQ,EAAE,cAAc,EAAE,GACzB,cAAc,EAAE,CAsBlB;AAID;;;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"}