@astro-minimax/ai 0.9.0 → 0.9.3

package/dist/server/chat-message-utils.d.ts

@@ -0,0 +1,6 @@
+import type { UIMessage } from 'ai';
+export declare function getMessageText(message: UIMessage): string;
+export declare function hasContent(message: UIMessage): boolean;
+export declare function filterValidMessages(messages: UIMessage[]): UIMessage[];
+export declare function getLatestUserText(messages: UIMessage[]): string;
+//# sourceMappingURL=chat-message-utils.d.ts.map

package/dist/server/chat-message-utils.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"chat-message-utils.d.ts","sourceRoot":"","sources":["../../src/server/chat-message-utils.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,IAAI,CAAC;AAEpC,wBAAgB,cAAc,CAAC,OAAO,EAAE,SAAS,GAAG,MAAM,CAQzD;AAED,wBAAgB,UAAU,CAAC,OAAO,EAAE,SAAS,GAAG,OAAO,CAOtD;AAED,wBAAgB,mBAAmB,CAAC,QAAQ,EAAE,SAAS,EAAE,GAAG,SAAS,EAAE,CAYtE;AAED,wBAAgB,iBAAiB,CAAC,QAAQ,EAAE,SAAS,EAAE,GAAG,MAAM,CAQ/D"}

package/dist/server/chat-message-utils.js

@@ -0,0 +1,40 @@
+function getMessageText(message) {
+  if (Array.isArray(message.parts)) {
+    return message.parts.filter((p) => p.type === "text").map((p) => p.text).join("");
+  }
+  return "";
+}
+function hasContent(message) {
+  const text = getMessageText(message);
+  if (text.trim()) return true;
+  if (Array.isArray(message.parts)) {
+    return message.parts.some((p) => p.type !== "text");
+  }
+  return false;
+}
+function filterValidMessages(messages) {
+  const filtered = [];
+  let lastRole = null;
+  for (const msg of messages) {
+    if (!hasContent(msg)) continue;
+    if (msg.role === lastRole) continue;
+    filtered.push(msg);
+    lastRole = msg.role;
+  }
+  return filtered;
+}
+function getLatestUserText(messages) {
+  for (let i = messages.length - 1; i >= 0; i--) {
+    const msg = messages[i];
+    if (msg?.role !== "user") continue;
+    const text = getMessageText(msg);
+    if (text.trim()) return text;
+  }
+  return "";
+}
+export {
+  filterValidMessages,
+  getLatestUserText,
+  getMessageText,
+  hasContent
+};

package/dist/server/chat-utils.d.ts

@@ -0,0 +1,30 @@
+import type { UIMessage } from "ai";
+import type { ChatContext, NotifyModelInfo as ModelInfo, NotifyTokenUsage as TokenUsage, PhaseTiming } from "./types.js";
+export declare function buildArticleContextPrompt(context: ChatContext): string;
+export interface SendNotificationArgs {
+    env: Record<string, unknown>;
+    messages: UIMessage[];
+    responseText: string;
+    relatedArticles: Array<{
+        title: string;
+        url?: string;
+    }>;
+    model?: ModelInfo;
+    usage?: TokenUsage;
+    timing: PhaseTiming;
+    cacheKey?: string | null;
+    waitUntil?: (promise: Promise<unknown>) => void;
+}
+export declare function sendNotification(args: SendNotificationArgs): void;
+export declare function parseNum(val: unknown, defaultVal: number): number;
+export declare function getTimeoutConfig(env: Record<string, unknown>): {
+    request: number;
+    keywordExtraction: number;
+    evidenceAnalysis: number;
+    llmStreaming: number;
+};
+export declare function getHealthConfig(env: Record<string, unknown>): {
+    unhealthyThreshold: number;
+    recoveryTtl: number;
+};
+//# sourceMappingURL=chat-utils.d.ts.map

package/dist/server/chat-utils.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"chat-utils.d.ts","sourceRoot":"","sources":["../../src/server/chat-utils.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,IAAI,CAAC;AACpC,OAAO,KAAK,EACV,WAAW,EAEX,eAAe,IAAI,SAAS,EAC5B,gBAAgB,IAAI,UAAU,EAC9B,WAAW,EACZ,MAAM,YAAY,CAAC;AAIpB,wBAAgB,yBAAyB,CAAC,OAAO,EAAE,WAAW,GAAG,MAAM,CAiBtE;AAED,MAAM,WAAW,oBAAoB;IACnC,GAAG,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;IAC7B,QAAQ,EAAE,SAAS,EAAE,CAAC;IACtB,YAAY,EAAE,MAAM,CAAC;IACrB,eAAe,EAAE,KAAK,CAAC;QAAE,KAAK,EAAE,MAAM,CAAC;QAAC,GAAG,CAAC,EAAE,MAAM,CAAA;KAAE,CAAC,CAAC;IACxD,KAAK,CAAC,EAAE,SAAS,CAAC;IAClB,KAAK,CAAC,EAAE,UAAU,CAAC;IACnB,MAAM,EAAE,WAAW,CAAC;IACpB,QAAQ,CAAC,EAAE,MAAM,GAAG,IAAI,CAAC;IACzB,SAAS,CAAC,EAAE,CAAC,OAAO,EAAE,OAAO,CAAC,OAAO,CAAC,KAAK,IAAI,CAAC;CACjD;AAED,wBAAgB,gBAAgB,CAAC,IAAI,EAAE,oBAAoB,GAAG,IAAI,CAqCjE;AAED,wBAAgB,QAAQ,CAAC,GAAG,EAAE,OAAO,EAAE,UAAU,EAAE,MAAM,GAAG,MAAM,CAQjE;AAED,wBAAgB,gBAAgB,CAAC,GAAG,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC;;;;;EAa5D;AAED,wBAAgB,eAAe,CAAC,GAAG,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC;;;EAQ3D"}

package/dist/server/chat-utils.js

@@ -0,0 +1,88 @@
+import { notifyAiChat } from "./notify.js";
+import { NOTIFICATION, TIMEOUTS, HEALTH } from "../constants.js";
+function buildArticleContextPrompt(context) {
+  if (context.scope !== "article" || !context.article) return "";
+  const a = context.article;
+  const parts = ["\n[\u5F53\u524D\u9605\u8BFB\u6587\u7AE0]", `\u7528\u6237\u6B63\u5728\u9605\u8BFB\uFF1A\u300A${a.title}\u300B`];
+  if (a.categories?.length) parts.push(`\u5206\u7C7B\uFF1A${a.categories.join("\u3001")}`);
+  parts.push(
+    "",
+    "\u4F60\u6B63\u5728\u966A\u7528\u6237\u9605\u8BFB\u8FD9\u7BC7\u6587\u7AE0\u3002\u4F18\u5148\u56F4\u7ED5\u8FD9\u7BC7\u6587\u7AE0\u7684\u5185\u5BB9\u56DE\u7B54\u95EE\u9898\u3002",
+    "\u5F53\u7528\u6237\u7684\u95EE\u9898\u4E0E\u5F53\u524D\u6587\u7AE0\u76F8\u5173\u65F6\uFF0C\u4F18\u5148\u4F7F\u7528\u5F53\u524D\u6587\u7AE0\u539F\u6587\u6BB5\u843D\u4F5C\u7B54\uFF0C\u800C\u4E0D\u662F\u53EA\u590D\u8FF0\u6458\u8981\u3002",
+    "\u5982\u679C\u95EE\u9898\u662F\u5728\u95EE\u201C\u524D\u9762/\u540E\u9762\u662F\u4EC0\u4E48\u201D\u201C\u8FD9\u4E00\u8282\u8BB2\u4E86\u4EC0\u4E48\u201D\u201C\u8FD9\u4E00\u9879\u540E\u7EED\u5185\u5BB9\u662F\u4EC0\u4E48\u201D\uFF0C\u9ED8\u8BA4\u4F18\u5148\u4F9D\u636E\u5F53\u524D\u6587\u7AE0\u5DF2\u6CE8\u5165\u7684\u539F\u6587\u6BB5\u843D\u56DE\u7B54\u3002",
+    "\u5F53\u7528\u6237\u60F3\u8981\u5EF6\u4F38\u65F6\uFF0C\u63A8\u8350\u76F8\u5173\u7684\u535A\u5BA2\u6587\u7AE0\u3002"
+  );
+  return parts.join("\n");
+}
+function sendNotification(args) {
+  const {
+    env,
+    messages,
+    responseText,
+    relatedArticles,
+    model,
+    usage,
+    timing,
+    cacheKey,
+    waitUntil
+  } = args;
+  const sessionId = cacheKey || `dev-${Date.now().toString(36)}`;
+  const notifyArticles = relatedArticles.slice(0, NOTIFICATION.MAX_REFERENCED_ARTICLES).map((a) => ({
+    title: a.title,
+    url: a.url
+  }));
+  const notifyPromise = notifyAiChat({
+    env,
+    sessionId,
+    messages,
+    aiResponse: responseText,
+    referencedArticles: notifyArticles,
+    model,
+    usage,
+    timing
+  });
+  if (waitUntil) {
+    waitUntil(notifyPromise);
+  } else {
+    void notifyPromise;
+  }
+}
+function parseNum(val, defaultVal) {
+  if (val === void 0) return defaultVal;
+  if (typeof val === "number") return val;
+  if (typeof val === "string") {
+    const num = parseInt(val, 10);
+    return isNaN(num) ? defaultVal : num;
+  }
+  return defaultVal;
+}
+function getTimeoutConfig(env) {
+  return {
+    request: parseNum(env.AI_TIMEOUT_REQUEST, TIMEOUTS.REQUEST),
+    keywordExtraction: parseNum(
+      env.AI_TIMEOUT_KEYWORD,
+      TIMEOUTS.KEYWORD_EXTRACTION
+    ),
+    evidenceAnalysis: parseNum(
+      env.AI_TIMEOUT_EVIDENCE,
+      TIMEOUTS.EVIDENCE_ANALYSIS
+    ),
+    llmStreaming: parseNum(env.AI_TIMEOUT_LLM, TIMEOUTS.LLM_STREAMING)
+  };
+}
+function getHealthConfig(env) {
+  return {
+    unhealthyThreshold: parseNum(
+      env.AI_HEALTH_THRESHOLD,
+      HEALTH.UNHEALTHY_THRESHOLD
+    ),
+    recoveryTtl: parseNum(env.AI_HEALTH_RECOVERY_TTL, HEALTH.RECOVERY_TTL)
+  };
+}
+export {
+  buildArticleContextPrompt,
+  getHealthConfig,
+  getTimeoutConfig,
+  parseNum,
+  sendNotification
+};

package/dist/server/dev-server.js

@@ -1,20 +1,62 @@
 #!/usr/bin/env node
-import { createServer } from "node:http";
+import {
+  createServer
+} from "node:http";
 import { readFileSync, existsSync, mkdirSync, writeFileSync } from "node:fs";
-import { resolve, dirname } from "node:path";
-import { fileURLToPath } from "node:url";
-const __filename = fileURLToPath(import.meta.url);
-const __dirname = dirname(__filename);
-const DEFAULT_SUMMARIES = { meta: { lastUpdated: (/* @__PURE__ */ new Date()).toISOString(), model: "none", totalProcessed: 0 }, articles: {} };
+import { resolve } from "node:path";
+import { setLogLevel } from "../utils/logger.js";
+const DEFAULT_SUMMARIES = {
+  meta: {
+    lastUpdated: (/* @__PURE__ */ new Date()).toISOString(),
+    model: "none",
+    totalProcessed: 0
+  },
+  articles: {}
+};
 const DEFAULT_AUTHOR_CONTEXT = { author: {}, posts: [] };
 const DEFAULT_VOICE_PROFILE = { style: {}, examples: [] };
-function extractPostTitle(url) {
-  const match = url.match(/\/posts\/([^/]+)/);
-  if (match) {
-    return decodeURIComponent(match[1].replace(/-/g, " "));
+const DEFAULT_FACT_REGISTRY = {
+  $schema: "fact-registry-v1",
+  generatedAt: (/* @__PURE__ */ new Date()).toISOString(),
+  version: 1,
+  facts: [],
+  stats: {
+    total: 0,
+    byCategory: {
+      author: 0,
+      blog: 0,
+      content: 0,
+      project: 0,
+      tech: 0
+    },
+    avgConfidence: 0
   }
-  return "\u535A\u5BA2\u6587\u7AE0";
-}
+};
+const DEFAULT_KNOWLEDGE_BUNDLE = {
+  $schema: "knowledge-bundle-v1",
+  version: 1,
+  generatedAt: (/* @__PURE__ */ new Date()).toISOString(),
+  corpusHash: "dev-server-default",
+  runtime: {
+    summaries: DEFAULT_SUMMARIES,
+    authorContext: DEFAULT_AUTHOR_CONTEXT,
+    voiceProfile: DEFAULT_VOICE_PROFILE,
+    factRegistry: DEFAULT_FACT_REGISTRY,
+    vectorIndex: null
+  },
+  corpus: {
+    $schema: "knowledge-corpus-v1",
+    version: 1,
+    generatedAt: (/* @__PURE__ */ new Date()).toISOString(),
+    documents: []
+  },
+  passages: {
+    $schema: "knowledge-passages-v1",
+    version: 1,
+    generatedAt: (/* @__PURE__ */ new Date()).toISOString(),
+    passages: []
+  }
+};
 function findBlogRoot() {
   let dir = process.cwd();
   for (let i = 0; i < 10; i++) {
@@ -22,16 +64,21 @@ function findBlogRoot() {
       return { root: dir, datasDir: resolve(dir, "datas"), hasDatas: true };
     }
     if (existsSync(resolve(dir, "apps", "blog", "datas"))) {
-      return { root: resolve(dir, "apps", "blog"), datasDir: resolve(dir, "apps", "blog", "datas"), hasDatas: true };
-    }
-    if (existsSync(resolve(dir, "src", "data"))) {
-      return { root: dir, datasDir: resolve(dir, "src", "data"), hasDatas: true };
+      return {
+        root: resolve(dir, "apps", "blog"),
+        datasDir: resolve(dir, "apps", "blog", "datas"),
+        hasDatas: true
+      };
     }
     const parent = resolve(dir, "..");
     if (parent === dir) break;
     dir = parent;
   }
-  return { root: process.cwd(), datasDir: resolve(process.cwd(), "datas"), hasDatas: false };
+  return {
+    root: process.cwd(),
+    datasDir: resolve(process.cwd(), "datas"),
+    hasDatas: false
+  };
 }
 function loadEnv(envPath) {
   if (!existsSync(envPath)) return;
@@ -55,18 +102,21 @@ function initDatasDirectory(datasDir) {
   if (!existsSync(datasDir)) {
     mkdirSync(datasDir, { recursive: true });
   }
+  const runtimeDir = resolve(datasDir, "knowledge", "runtime");
+  mkdirSync(runtimeDir, { recursive: true });
   const files = [
-    { name: "ai-summaries.json", content: DEFAULT_SUMMARIES },
-    { name: "author-context.json", content: DEFAULT_AUTHOR_CONTEXT },
-    { name: "voice-profile.json", content: DEFAULT_VOICE_PROFILE }
+    {
+      name: resolve(runtimeDir, "knowledge-bundle.json"),
+      label: "knowledge/runtime/knowledge-bundle.json",
+      content: DEFAULT_KNOWLEDGE_BUNDLE
+    }
   ];
   for (const file of files) {
-    const filePath = resolve(datasDir, file.name);
-    if (!existsSync(filePath)) {
-      writeFileSync(filePath, JSON.stringify(file.content, null, 2) + "\n");
-      console.log(`   Created ${file.name}`);
+    if (!existsSync(file.name)) {
+      writeFileSync(file.name, JSON.stringify(file.content, null, 2) + "\n");
+      console.log(`   Created ${file.label}`);
     } else {
-      console.log(`   Skipped ${file.name} (already exists)`);
+      console.log(`   Skipped ${file.label} (already exists)`);
     }
   }
 }
@@ -84,27 +134,51 @@ function loadJson(datasDir, file, defaultValue) {
 }
 async function setupHandler(datasDir, hasDatas) {
   const { handleChatRequest, initializeMetadata } = await import("./index.js");
+  const {
+    getProviderManager,
+    hasAnyProviderConfigured,
+    getResponseCacheConfig
+  } = await import("../index.js");
   if (!hasDatas) {
-    console.log("\n   \u26A0\uFE0F  No datas/ directory found. AI chat will work with empty context.");
-    console.log('   Run "pnpm exec astro-ai-dev --init" to create placeholder files.\n');
+    console.log(
+      "\n   \u26A0\uFE0F  No datas/ directory found. AI chat will work with empty context."
+    );
+    console.log(
+      '   Run "pnpm exec astro-ai-dev --init" to create placeholder files.\n'
+    );
   } else {
-    const hasSummaries = existsSync(resolve(datasDir, "ai-summaries.json"));
-    const hasAuthor = existsSync(resolve(datasDir, "author-context.json"));
-    if (!hasSummaries || !hasAuthor) {
-      console.log("\n   \u26A0\uFE0F  Some metadata files are missing. AI chat may have limited context.\n");
+    const hasKnowledgeBundle = existsSync(
+      resolve(datasDir, "knowledge", "runtime", "knowledge-bundle.json")
+    );
+    if (!hasKnowledgeBundle) {
+      console.log(
+        "\n   \u26A0\uFE0F  knowledge/runtime/knowledge-bundle.json is missing. AI chat may have limited context.\n"
+      );
     }
   }
-  const summaries = loadJson(datasDir, "ai-summaries.json", DEFAULT_SUMMARIES);
-  const authorContext = loadJson(datasDir, "author-context.json", DEFAULT_AUTHOR_CONTEXT);
-  const voiceProfile = loadJson(datasDir, "voice-profile.json", DEFAULT_VOICE_PROFILE);
+  const knowledgeBundle = loadJson(
+    datasDir,
+    "knowledge/runtime/knowledge-bundle.json",
+    DEFAULT_KNOWLEDGE_BUNDLE
+  );
   const env = { ...process.env };
-  initializeMetadata({
-    summaries,
-    authorContext,
-    voiceProfile,
-    siteUrl: process.env.SITE_URL || "http://localhost:4321"
-  }, env);
-  return { handleChatRequest, env };
+  initializeMetadata(
+    {
+      knowledgeBundle,
+      siteUrl: process.env.SITE_URL || "http://localhost:4321"
+    },
+    env
+  );
+  return {
+    handleChatRequest,
+    initializeMetadata,
+    getProviderManager,
+    hasAnyProviderConfigured,
+    getResponseCacheConfig,
+    env,
+    knowledgeBundle,
+    vectorIndex: knowledgeBundle.runtime.vectorIndex ?? null
+  };
 }
 function toWebRequest(req) {
   return new Promise((resolve2, reject) => {
@@ -113,17 +187,23 @@ function toWebRequest(req) {
     req.on("end", () => {
       const body = Buffer.concat(chunks);
       const url = `http://localhost${req.url || "/"}`;
-      resolve2(new Request(url, {
-        method: req.method || "GET",
-        headers: req.headers,
-        body: req.method !== "GET" && req.method !== "HEAD" ? body : void 0
-      }));
+      resolve2(
+        new Request(url, {
+          method: req.method || "GET",
+          headers: req.headers,
+          body: req.method !== "GET" && req.method !== "HEAD" ? body : void 0
+        })
+      );
     });
     req.on("error", reject);
   });
 }
 async function sendWebResponse(webRes, res) {
-  res.writeHead(webRes.status, Object.fromEntries(webRes.headers));
+  const headerEntries = [];
+  webRes.headers.forEach((value, key) => {
+    headerEntries.push([key, value]);
+  });
+  res.writeHead(webRes.status, Object.fromEntries(headerEntries));
   if (!webRes.body) {
     res.end();
     return;
@@ -150,17 +230,36 @@ async function main() {
     console.log("\n\u2705 Done! You can now configure your AI metadata files.\n");
     process.exit(0);
   }
+  if (process.env.AI_DEBUG) setLogLevel("debug");
+  else if (process.env.AI_LOG_LEVEL)
+    setLogLevel(
+      process.env.AI_LOG_LEVEL
+    );
   const port = parseInt(process.env.AI_DEV_PORT || "8787", 10);
   const { root: blogRoot, datasDir, hasDatas } = findBlogRoot();
   loadEnv(resolve(blogRoot, ".env"));
   console.log("\n\u{1F916} AI Dev Server starting...\n");
   console.log(`   Working directory: ${blogRoot}`);
-  console.log(`   Datas directory: ${datasDir} ${hasDatas ? "\u2713" : "(not found)"}`);
+  console.log(
+    `   Datas directory: ${datasDir} ${hasDatas ? "\u2713" : "(not found)"}`
+  );
   console.log(`   Port: ${port}`);
-  console.log(`   AI_BASE_URL: ${process.env.AI_BASE_URL ? "\u2713 configured" : "\u2717 not set"}`);
-  console.log(`   AI_API_KEY: ${process.env.AI_API_KEY ? "\u2713 configured" : "\u2717 not set"}`);
+  console.log(
+    `   AI_BASE_URL: ${process.env.AI_BASE_URL ? "\u2713 configured" : "\u2717 not set"}`
+  );
+  console.log(
+    `   AI_API_KEY: ${process.env.AI_API_KEY ? "\u2713 configured" : "\u2717 not set"}`
+  );
   console.log(`   AI_MODEL: ${process.env.AI_MODEL || "(default)"}`);
-  const { handleChatRequest, env } = await setupHandler(datasDir, hasDatas);
+  const {
+    handleChatRequest,
+    getProviderManager,
+    hasAnyProviderConfigured,
+    getResponseCacheConfig,
+    env,
+    knowledgeBundle,
+    vectorIndex
+  } = await setupHandler(datasDir, hasDatas);
   const server = createServer(async (req, res) => {
     res.setHeader("Access-Control-Allow-Origin", "*");
     res.setHeader("Access-Control-Allow-Methods", "GET, POST, OPTIONS");
@@ -179,58 +278,89 @@ async function main() {
         return;
       }
       if (url.startsWith("/api/notify/comment")) {
-        const { createNotifier } = await import("@astro-minimax/notify");
+        const { handleCommentWebhook } = await import("@astro-minimax/notify");
         const webReq = await toWebRequest(req);
-        const body = await webReq.json();
-        if (body.type !== "new_comment" && body.type !== "new_reply") {
-          res.writeHead(400, { "Content-Type": "application/json" });
-          res.end(JSON.stringify({ error: "Unsupported event type" }));
-          return;
-        }
-        const data = body.data || {};
-        const siteUrl = process.env.SITE_URL || "http://localhost:4321";
-        const postUrl = data.url?.startsWith("http") ? data.url : `${siteUrl}${data.url || "/"}`;
-        const notifier = createNotifier({
-          telegram: process.env.NOTIFY_TELEGRAM_BOT_TOKEN && process.env.NOTIFY_TELEGRAM_CHAT_ID ? {
-            botToken: process.env.NOTIFY_TELEGRAM_BOT_TOKEN,
-            chatId: process.env.NOTIFY_TELEGRAM_CHAT_ID
-          } : void 0,
-          webhook: process.env.NOTIFY_WEBHOOK_URL ? {
-            url: process.env.NOTIFY_WEBHOOK_URL
-          } : void 0,
-          email: process.env.NOTIFY_RESEND_API_KEY && process.env.NOTIFY_RESEND_FROM && process.env.NOTIFY_RESEND_TO ? {
-            provider: "resend",
-            apiKey: process.env.NOTIFY_RESEND_API_KEY,
-            from: process.env.NOTIFY_RESEND_FROM,
-            to: process.env.NOTIFY_RESEND_TO
-          } : void 0
-        });
-        const result = await notifier.comment({
-          author: data.nick || "\u533F\u540D\u7528\u6237",
-          content: data.comment || "",
-          postTitle: extractPostTitle(data.url || "/"),
-          postUrl
-        });
-        console.log("[notify] Comment notification sent:", result.success ? "\u2713" : "\u2717", result.results);
-        res.writeHead(200, { "Content-Type": "application/json" });
-        res.end(JSON.stringify({
-          success: result.success,
-          event: "comment",
-          channels: result.results.map((r) => ({ channel: r.channel, success: r.success, error: r.error }))
-        }));
+        const webRes = await handleCommentWebhook(webReq, process.env);
+        await sendWebResponse(webRes, res);
         return;
       }
       if (url.startsWith("/api/ai-info")) {
-        res.writeHead(200, { "Content-Type": "application/json" });
-        res.end(JSON.stringify({
-          status: "ok",
-          mode: "dev-server",
-          datas: { found: hasDatas, path: datasDir },
-          ai: {
-            configured: !!(process.env.AI_BASE_URL && process.env.AI_API_KEY),
-            model: process.env.AI_MODEL || "unknown"
+        const manager = getProviderManager(env, { enableMockFallback: true });
+        const providerStatus = manager.getProviderStatus();
+        const configured = hasAnyProviderConfigured(env);
+        const responseCacheConfig = getResponseCacheConfig(env);
+        const timeoutConfig = {
+          request: env.AI_TIMEOUT_REQUEST ?? 45e3,
+          keywordExtraction: env.AI_TIMEOUT_KEYWORD ?? 5e3,
+          evidenceAnalysis: env.AI_TIMEOUT_EVIDENCE ?? 8e3,
+          llmStreaming: env.AI_TIMEOUT_LLM ?? 3e4
+        };
+        const healthConfig = {
+          unhealthyThreshold: env.AI_HEALTH_THRESHOLD ?? 3,
+          recoveryTtl: env.AI_HEALTH_RECOVERY_TTL ?? 6e4
+        };
+        const dataStatus = {
+          knowledgeBundle: {
+            loaded: true,
+            count: Array.isArray(
+              knowledgeBundle?.corpus?.documents
+            ) ? knowledgeBundle.corpus.documents.length : void 0,
+            lastUpdated: knowledgeBundle?.generatedAt
+          },
+          vectorIndex: {
+            loaded: Boolean(vectorIndex),
+            lastUpdated: knowledgeBundle?.generatedAt
           }
-        }, null, 2));
+        };
+        res.writeHead(200, { "Content-Type": "application/json" });
+        res.end(
+          JSON.stringify(
+            {
+              status: "ok",
+              mode: "dev-server",
+              timestamp: (/* @__PURE__ */ new Date()).toISOString(),
+              ai: {
+                enabled: true,
+                mockMode: !!env.AI_MOCK_MODE,
+                configured,
+                cache: {
+                  enabled: responseCacheConfig.enabled,
+                  ttl: responseCacheConfig.defaultTtl,
+                  playbackDelay: responseCacheConfig.playbackDelayMs,
+                  chunkSize: responseCacheConfig.chunkSize,
+                  thinkingDelay: responseCacheConfig.thinkingPlaybackDelayMs
+                },
+                timeouts: timeoutConfig,
+                health: healthConfig,
+                providers: providerStatus.map((p) => ({
+                  id: p.id,
+                  type: p.type,
+                  weight: p.weight,
+                  healthy: p.health.healthy,
+                  model: p.model,
+                  healthDetails: {
+                    consecutiveFailures: p.health.consecutiveFailures,
+                    totalRequests: p.health.totalRequests,
+                    successfulRequests: p.health.successfulRequests,
+                    lastError: p.health.lastError,
+                    lastErrorTime: p.health.lastErrorTime,
+                    lastSuccessTime: p.health.lastSuccessTime
+                  }
+                })),
+                dataStatus
+              },
+              hints: manager.hasProviders() ? [
+                `Providers available: ${manager.getProviderCount()}`,
+                "Mock fallback: enabled",
+                responseCacheConfig.enabled ? "Response cache: enabled" : "Response cache: disabled"
+              ] : [
+                "No AI providers configured. Set AI_BASE_URL + AI_API_KEY environment variables."
+              ]
+            },
+            null,
+            2
+          )
+        );
         return;
       }
       res.writeHead(404, { "Content-Type": "application/json" });
@@ -238,7 +368,12 @@ async function main() {
     } catch (err) {
       console.error("[AI Dev Server] Error:", err);
       res.writeHead(500, { "Content-Type": "application/json" });
-      res.end(JSON.stringify({ error: "Internal server error", detail: err instanceof Error ? err.message : String(err) }));
+      res.end(
+        JSON.stringify({
+          error: "Internal server error",
+          detail: err instanceof Error ? err.message : String(err)
+        })
+      );
     }
   });
   server.listen(port, () => {
@@ -246,9 +381,11 @@ async function main() {
 \u2705 AI Dev Server running at http://localhost:${port}`);
     console.log(`   POST http://localhost:${port}/api/chat`);
     console.log(`   GET  http://localhost:${port}/api/ai-info`);
-    console.log(`
+    console.log(
+      `
    Tip: Run "pnpm exec astro-ai-dev --init" to create datas/ directory.
-`);
+`
+    );
   });
   const shutdown = (signal) => {
     console.log(`

package/dist/server/env-config.d.ts

@@ -0,0 +1,22 @@
+import type { ChatHandlerEnv } from "./types.js";
+export declare function applyAiConfigDefaults(baseEnv: ChatHandlerEnv, aiConfig: {
+    cache?: {
+        enabled?: boolean;
+        ttl?: number;
+        playbackDelay?: number;
+        chunkSize?: number;
+        thinkingDelay?: number;
+    };
+    timeouts?: {
+        request?: number;
+        keywordExtraction?: number;
+        evidenceAnalysis?: number;
+        llmStreaming?: number;
+    };
+    health?: {
+        unhealthyThreshold?: number;
+        recoveryTtl?: number;
+    };
+    mockMode?: boolean;
+} | null | undefined): ChatHandlerEnv;
+//# sourceMappingURL=env-config.d.ts.map

package/dist/server/env-config.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"env-config.d.ts","sourceRoot":"","sources":["../../src/server/env-config.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,YAAY,CAAC;AAEjD,wBAAgB,qBAAqB,CACnC,OAAO,EAAE,cAAc,EACvB,QAAQ,EACJ;IACE,KAAK,CAAC,EAAE;QACN,OAAO,CAAC,EAAE,OAAO,CAAC;QAClB,GAAG,CAAC,EAAE,MAAM,CAAC;QACb,aAAa,CAAC,EAAE,MAAM,CAAC;QACvB,SAAS,CAAC,EAAE,MAAM,CAAC;QACnB,aAAa,CAAC,EAAE,MAAM,CAAC;KACxB,CAAC;IACF,QAAQ,CAAC,EAAE;QACT,OAAO,CAAC,EAAE,MAAM,CAAC;QACjB,iBAAiB,CAAC,EAAE,MAAM,CAAC;QAC3B,gBAAgB,CAAC,EAAE,MAAM,CAAC;QAC1B,YAAY,CAAC,EAAE,MAAM,CAAC;KACvB,CAAC;IACF,MAAM,CAAC,EAAE;QACP,kBAAkB,CAAC,EAAE,MAAM,CAAC;QAC5B,WAAW,CAAC,EAAE,MAAM,CAAC;KACtB,CAAC;IACF,QAAQ,CAAC,EAAE,OAAO,CAAC;CACpB,GACD,IAAI,GACJ,SAAS,GACZ,cAAc,CA4BhB"}

package/dist/server/env-config.js

@@ -0,0 +1,25 @@
+function applyAiConfigDefaults(baseEnv, aiConfig) {
+  if (!aiConfig) return { ...baseEnv };
+  const envWithConfig = { ...baseEnv };
+  const setIfMissing = (envKey, configValue) => {
+    if (envWithConfig[envKey] === void 0 && configValue !== void 0) {
+      envWithConfig[envKey] = configValue;
+    }
+  };
+  setIfMissing("AI_CACHE_ENABLED", aiConfig.cache?.enabled);
+  setIfMissing("AI_CACHE_TTL", aiConfig.cache?.ttl);
+  setIfMissing("AI_CACHE_PLAYBACK_DELAY", aiConfig.cache?.playbackDelay);
+  setIfMissing("AI_CACHE_CHUNK_SIZE", aiConfig.cache?.chunkSize);
+  setIfMissing("AI_CACHE_THINKING_DELAY", aiConfig.cache?.thinkingDelay);
+  setIfMissing("AI_TIMEOUT_REQUEST", aiConfig.timeouts?.request);
+  setIfMissing("AI_TIMEOUT_KEYWORD", aiConfig.timeouts?.keywordExtraction);
+  setIfMissing("AI_TIMEOUT_EVIDENCE", aiConfig.timeouts?.evidenceAnalysis);
+  setIfMissing("AI_TIMEOUT_LLM", aiConfig.timeouts?.llmStreaming);
+  setIfMissing("AI_HEALTH_THRESHOLD", aiConfig.health?.unhealthyThreshold);
+  setIfMissing("AI_HEALTH_RECOVERY_TTL", aiConfig.health?.recoveryTtl);
+  setIfMissing("AI_MOCK_MODE", aiConfig.mockMode);
+  return envWithConfig;
+}
+export {
+  applyAiConfigDefaults
+};

package/dist/server/errors.d.ts

@@ -1,3 +1,4 @@
+export declare function setCorsOrigin(origin: string): void;
 export declare function chatError(code: string, error: string, status: number, options?: {
     retryable?: boolean;
     retryAfter?: number;