@astro-minimax/ai 0.2.0

package/dist/stream/mock-stream.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"mock-stream.d.ts","sourceRoot":"","sources":["../../src/stream/mock-stream.ts"],"names":[],"mappings":"AAEA,MAAM,WAAW,iBAAiB;IAChC,QAAQ,EAAE,MAAM,CAAC;IACjB,IAAI,CAAC,EAAE,MAAM,CAAC;IACd,uDAAuD;IACvD,UAAU,CAAC,EAAE,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;CAC/B;AAED;;;GAGG;AACH,wBAAgB,kBAAkB,CAAC,OAAO,EAAE,iBAAiB,GAAG,cAAc,CAAC,MAAM,CAAC,CAoBrF"}

package/dist/stream/mock-stream.js

@@ -0,0 +1,27 @@
+import { getMockResponse } from '../providers/mock.js';
+/**
+ * Streams a mock response character-by-character as a ReadableStream<string>.
+ * Simulates natural typing speed with variable delays.
+ */
+export function streamMockResponse(options) {
+    const { question, lang = 'zh', delayRange = [12, 35] } = options;
+    const text = getMockResponse(question, lang);
+    const [minDelay, maxDelay] = delayRange;
+    let index = 0;
+    return new ReadableStream({
+        async pull(controller) {
+            if (index >= text.length) {
+                controller.close();
+                return;
+            }
+            const chunkSize = Math.random() < 0.25 ? 2 : 1;
+            const chunk = text.slice(index, index + chunkSize);
+            index += chunkSize;
+            controller.enqueue(chunk);
+            await sleep(minDelay + Math.random() * (maxDelay - minDelay));
+        },
+    });
+}
+function sleep(ms) {
+    return new Promise(resolve => setTimeout(resolve, ms));
+}

package/dist/stream/response.d.ts

@@ -0,0 +1,10 @@
+/**
+ * Common CORS + SSE headers for chat API responses.
+ */
+export declare const STREAM_HEADERS: HeadersInit;
+export declare const JSON_HEADERS: HeadersInit;
+/**
+ * Creates a standard error JSON response.
+ */
+export declare function errorResponse(message: string, status?: number): Response;
+//# sourceMappingURL=response.d.ts.map

package/dist/stream/response.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"response.d.ts","sourceRoot":"","sources":["../../src/stream/response.ts"],"names":[],"mappings":"AAAA;;GAEG;AACH,eAAO,MAAM,cAAc,EAAE,WAK5B,CAAC;AAEF,eAAO,MAAM,YAAY,EAAE,WAG1B,CAAC;AAEF;;GAEG;AACH,wBAAgB,aAAa,CAAC,OAAO,EAAE,MAAM,EAAE,MAAM,SAAM,GAAG,QAAQ,CAKrE"}

package/dist/stream/response.js

@@ -0,0 +1,22 @@
+/**
+ * Common CORS + SSE headers for chat API responses.
+ */
+export const STREAM_HEADERS = {
+    'Content-Type': 'text/event-stream',
+    'Cache-Control': 'no-cache',
+    'Connection': 'keep-alive',
+    'Access-Control-Allow-Origin': '*',
+};
+export const JSON_HEADERS = {
+    'Content-Type': 'application/json',
+    'Access-Control-Allow-Origin': '*',
+};
+/**
+ * Creates a standard error JSON response.
+ */
+export function errorResponse(message, status = 500) {
+    return new Response(JSON.stringify({ error: message }), {
+        status,
+        headers: JSON_HEADERS,
+    });
+}

package/dist/utils/i18n.d.ts

@@ -0,0 +1,18 @@
+/**
+ * AI Package Internationalization
+ * Follows the same pattern as packages/core/src/utils/i18n.ts
+ */
+export type AITranslationKey = "ai.reasoning.thinking" | "ai.reasoning.viewReasoning" | "ai.reasoning.waiting" | "ai.error.network" | "ai.error.aborted" | "ai.error.rateLimit" | "ai.error.unavailable" | "ai.error.generic" | "ai.error.format" | "ai.error.noOutput" | "ai.placeholder" | "ai.clear" | "ai.clearConversation" | "ai.close" | "ai.closeChat" | "ai.retry" | "ai.status.searching" | "ai.status.generating" | "ai.status.found" | "ai.status.citation" | "ai.status.fallback" | "ai.prompt.techStack" | "ai.prompt.recommend" | "ai.prompt.build" | "ai.prompt.summarize" | "ai.prompt.explain" | "ai.prompt.related" | "ai.welcome.reading" | "ai.welcome.canHelp" | "ai.welcome.greeting" | "ai.welcome.demo" | "ai.welcome.demoHint" | "ai.welcome.demoPrompt" | "ai.header.reading" | "ai.header.mode" | "ai.assistantName" | "ai.status.live" | "ai.error.emptyMessage" | "ai.error.emptyContent" | "ai.error.inputTooLong" | "ai.error.timeout" | "ai.error.rateLimit.burst" | "ai.error.rateLimit.sustained" | "ai.error.rateLimit.daily" | "ai.prompt.section.responsibilities" | "ai.prompt.section.format" | "ai.prompt.section.principles" | "ai.prompt.section.constraints";
+/**
+ * Get translation by key.
+ * @param key - Translation key (type-safe)
+ * @param lang - Language code ('zh' or 'en')
+ * @param vars - Optional variables for interpolation (e.g., { count: 5 })
+ */
+export declare function t(key: AITranslationKey, lang?: string, vars?: Record<string, string | number>): string;
+/**
+ * Get normalized language code.
+ * Returns 'zh' for Chinese, 'en' for everything else.
+ */
+export declare function getLang(lang?: string): string;
+//# sourceMappingURL=i18n.d.ts.map

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

@@ -0,0 +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,CAAC;AA2HpC;;;;;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"}

package/dist/utils/i18n.js

@@ -0,0 +1,148 @@
+/**
+ * AI Package Internationalization
+ * Follows the same pattern as packages/core/src/utils/i18n.ts
+ */
+const translations = {
+    en: {
+        // Reasoning UI
+        "ai.reasoning.thinking": "Thinking...",
+        "ai.reasoning.viewReasoning": "View reasoning",
+        "ai.reasoning.waiting": "Waiting for thoughts...",
+        // Error messages
+        "ai.error.network": "Network connection failed. Please check your connection.",
+        "ai.error.aborted": "Request was cancelled.",
+        "ai.error.rateLimit": "Too many requests. Please try again later.",
+        "ai.error.unavailable": "AI service is temporarily unavailable.",
+        "ai.error.generic": "Something went wrong. Please try again later.",
+        "ai.error.format": "Invalid request format.",
+        // UI labels
+        "ai.placeholder": "Ask a question...",
+        "ai.clear": "Clear",
+        "ai.clearConversation": "Clear conversation",
+        "ai.close": "Close",
+        "ai.closeChat": "Close chat",
+        "ai.retry": "Retry",
+        "ai.status.searching": "Searching...",
+        "ai.status.generating": "Generating response...",
+        "ai.status.found": "Found {count} related items",
+        "ai.status.citation": "Answered from public records",
+        "ai.status.fallback": "AI service unavailable, using demo mode",
+        // Quick prompts
+        "ai.prompt.techStack": "What tech stack is used?",
+        "ai.prompt.recommend": "Recommend some articles?",
+        "ai.prompt.build": "How to build a similar blog?",
+        "ai.prompt.summarize": 'Summarize the key points of "{title}"',
+        "ai.prompt.explain": 'Explain "{point}"',
+        "ai.prompt.related": "What related content should I read next?",
+        // Welcome messages
+        "ai.welcome.reading": 'I\'m reading "{title}" with you.\nAsk me to summarize, explain a concept, or explore related topics.',
+        "ai.welcome.canHelp": "Hi! I'm the blog AI assistant. Ask me anything and I'll help you find related articles.",
+        "ai.welcome.greeting": "Hi! I'm the blog AI assistant.",
+        "ai.welcome.demo": "I'm running in demo mode. I can recommend blog articles and external resources.",
+        "ai.welcome.demoHint": "For full AI features (RAG search), configure AI_BASE_URL and AI_API_KEY.",
+        "ai.welcome.demoPrompt": 'Try: "Recommend articles?" or "How to build this blog?"',
+        // Header
+        "ai.header.reading": "Reading:",
+        "ai.header.mode": "Demo",
+        // Assistant branding
+        "ai.assistantName": "Blog Avatar",
+        "ai.status.live": "Live",
+        // Additional error messages
+        "ai.error.emptyMessage": "Message cannot be empty.",
+        "ai.error.emptyContent": "Message content cannot be empty.",
+        "ai.error.inputTooLong": "Message too long, max {max} characters.",
+        "ai.error.timeout": "Response timeout, please retry or simplify your question.",
+        // Rate limit messages
+        "ai.error.rateLimit.burst": "Too many requests, please try again later.",
+        "ai.error.rateLimit.sustained": "Too many requests, please wait a minute.",
+        "ai.error.rateLimit.daily": "Daily limit reached, please come back tomorrow.",
+        "ai.error.noOutput": "Sorry, I could not generate a valid response. Please try rephrasing your question.",
+        "ai.prompt.section.responsibilities": "Your Responsibilities",
+        "ai.prompt.section.format": "Response Format",
+        "ai.prompt.section.principles": "Recommendation Principles",
+        "ai.prompt.section.constraints": "Constraints",
+    },
+    zh: {
+        // Reasoning UI
+        "ai.reasoning.thinking": "思考中...",
+        "ai.reasoning.viewReasoning": "查看思考过程",
+        "ai.reasoning.waiting": "等待思考...",
+        // Error messages
+        "ai.error.network": "网络连接失败，请检查网络",
+        "ai.error.aborted": "请求已取消",
+        "ai.error.rateLimit": "请求太频繁，请稍后再试",
+        "ai.error.unavailable": "AI 服务暂时不可用",
+        "ai.error.generic": "出了点问题，请稍后再试",
+        "ai.error.format": "请求格式错误",
+        // UI labels
+        "ai.placeholder": "输入你的问题...",
+        "ai.clear": "清除",
+        "ai.clearConversation": "清除对话",
+        "ai.close": "关闭",
+        "ai.closeChat": "关闭聊天",
+        "ai.retry": "重试",
+        "ai.status.searching": "搜索中...",
+        "ai.status.generating": "正在生成回答...",
+        "ai.status.found": "找到 {count} 篇相关内容",
+        "ai.status.citation": "已基于公开记录直接给出回答",
+        "ai.status.fallback": "AI 服务不可用，使用演示模式回复",
+        // Quick prompts
+        "ai.prompt.techStack": "这个博客用了什么技术？",
+        "ai.prompt.recommend": "有哪些文章推荐？",
+        "ai.prompt.build": "怎么搭建类似的博客？",
+        "ai.prompt.summarize": "总结一下《{title}》的核心观点",
+        "ai.prompt.explain": "解释一下「{point}」",
+        "ai.prompt.related": "这篇文章和哪些内容相关？",
+        // Welcome messages
+        "ai.welcome.reading": "我在结合《{title}》陪你阅读。\n你可以让我总结这篇文章、解释某个观点，或者顺着这篇文章继续延伸到相关主题。",
+        "ai.welcome.canHelp": "你好！我是博客 AI 助手，问我任何关于博客内容的问题，我可以帮你找到相关文章。",
+        "ai.welcome.greeting": "你好！我是博客 AI 助手。",
+        "ai.welcome.demo": "我目前在 Demo 模式下，可以推荐博客文章和外部资源。",
+        "ai.welcome.demoHint": "启用完整 AI 功能（RAG 搜索增强）需要配置 AI_BASE_URL 和 AI_API_KEY 环境变量。",
+        "ai.welcome.demoPrompt": "试试：「有哪些文章推荐？」或「怎么搭建类似的博客？」",
+        // Header
+        "ai.header.reading": "正在阅读：",
+        "ai.header.mode": "演示",
+        // Assistant branding
+        "ai.assistantName": "博客分身",
+        "ai.status.live": "在线",
+        // Additional error messages
+        "ai.error.emptyMessage": "消息不能为空。",
+        "ai.error.emptyContent": "消息内容不能为空。",
+        "ai.error.inputTooLong": "消息过长，最多 {max} 字。",
+        "ai.error.timeout": "响应超时，请重试或简化问题。",
+        // Rate limit messages
+        "ai.error.rateLimit.burst": "请求太频繁，请稍后再试。",
+        "ai.error.rateLimit.sustained": "请求次数过多，请一分钟后再试。",
+        "ai.error.rateLimit.daily": "今日对话次数已达上限，请明天再来。",
+        "ai.error.noOutput": "抱歉，我无法生成有效的回答。请尝试换一种方式提问。",
+        "ai.prompt.section.responsibilities": "你的职责",
+        "ai.prompt.section.format": "回答格式",
+        "ai.prompt.section.principles": "推荐原则",
+        "ai.prompt.section.constraints": "约束",
+    },
+};
+/**
+ * Get translation by key.
+ * @param key - Translation key (type-safe)
+ * @param lang - Language code ('zh' or 'en')
+ * @param vars - Optional variables for interpolation (e.g., { count: 5 })
+ */
+export function t(key, lang = 'zh', vars) {
+    const l = lang === 'zh' ? 'zh' : 'en';
+    let text = translations[l]?.[key] ?? translations['en'][key] ?? key;
+    // Interpolate variables like {count}, {title}, etc.
+    if (vars) {
+        for (const [k, v] of Object.entries(vars)) {
+            text = text.replace(new RegExp(`\\{${k}\\}`, 'g'), String(v));
+        }
+    }
+    return text;
+}
+/**
+ * Get normalized language code.
+ * Returns 'zh' for Chinese, 'en' for everything else.
+ */
+export function getLang(lang) {
+    return lang === 'zh' ? 'zh' : 'en';
+}

package/package.json

@@ -0,0 +1,93 @@
+{
+  "name": "@astro-minimax/ai",
+  "version": "0.2.0",
+  "type": "module",
+  "description": "Vendor-agnostic AI integration package with full RAG pipeline for astro-minimax blogs.",
+  "author": "Souloss",
+  "license": "MIT",
+  "bin": {
+    "astro-ai-dev": "./dist/server/dev-server.js"
+  },
+  "exports": {
+    ".": {
+      "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"
+    },
+    "./search": {
+      "types": "./dist/search/index.d.ts",
+      "import": "./dist/search/index.js"
+    },
+    "./intelligence": {
+      "types": "./dist/intelligence/index.d.ts",
+      "import": "./dist/intelligence/index.js"
+    },
+    "./prompt": {
+      "types": "./dist/prompt/index.d.ts",
+      "import": "./dist/prompt/index.js"
+    },
+    "./data": {
+      "types": "./dist/data/index.d.ts",
+      "import": "./dist/data/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"
+    },
+    "./components/*": "./src/components/*",
+    "./styles/source.css": "./src/styles/source.css",
+    "./package.json": "./package.json"
+  },
+  "files": [
+    "dist/",
+    "src/components/",
+    "src/styles/",
+    "README.md"
+  ],
+  "sideEffects": false,
+  "scripts": {
+    "build": "tsc -p tsconfig.build.json",
+    "build:watch": "tsc -p tsconfig.build.json --watch",
+    "clean": "rm -rf dist",
+    "prepublishOnly": "pnpm run clean && pnpm run build"
+  },
+  "dependencies": {
+    "@ai-sdk/openai-compatible": "^2.0.35",
+    "@astro-minimax/notify": "workspace:*",
+    "ai": "^6.0.116",
+    "undici": "^6.0.0",
+    "workers-ai-provider": "^3.1.2"
+  },
+  "peerDependencies": {
+    "@ai-sdk/react": "^3.0.0",
+    "@cloudflare/workers-types": "^4.0.0",
+    "preact": "^10.0.0"
+  },
+  "peerDependenciesMeta": {
+    "@ai-sdk/react": {
+      "optional": true
+    },
+    "preact": {
+      "optional": true
+    }
+  },
+  "devDependencies": {
+    "@cloudflare/workers-types": "^4.0.0",
+    "@types/node": "^22.0.0",
+    "typescript": "^5.9.3"
+  },
+  "engines": {
+    "node": ">=22.12.0"
+  }
+}

package/src/components/AIChatContainer.tsx

@@ -0,0 +1,30 @@
+import { useState, useCallback } from 'preact/hooks';
+import { ChatPanel } from './ChatPanel.js';
+import type { AIChatConfig } from './ChatPanel.js';
+import type { ArticleChatContext } from '../server/types.js';
+
+interface Props {
+  config: AIChatConfig;
+  articleContext?: ArticleChatContext;
+}
+
+export default function AIChatContainer({ config, articleContext }: Props) {
+  const [open, setOpen] = useState(false);
+
+  const handleToggle = useCallback(() => setOpen(prev => !prev), []);
+  const handleClose = useCallback(() => setOpen(false), []);
+
+  if (typeof window !== 'undefined') {
+    // eslint-disable-next-line @typescript-eslint/no-explicit-any
+    (window as any).__aiChatToggle = handleToggle;
+  }
+
+  return (
+    <ChatPanel
+      open={open}
+      onClose={handleClose}
+      config={config}
+      articleContext={articleContext}
+    />
+  );
+}

package/src/components/AIChatWidget.astro

@@ -0,0 +1,30 @@
+---
+import { SITE } from "virtual:astro-minimax/config";
+import AIChatContainer from "./AIChatContainer.js";
+import type { ArticleChatContext } from "../server/types.js";
+
+interface Props {
+  lang?: string;
+  articleContext?: ArticleChatContext;
+}
+
+const { lang = SITE.lang ?? "zh", articleContext } = Astro.props;
+const aiEnabled = SITE.ai?.enabled ?? false;
+
+const aiConfig = {
+  enabled: aiEnabled,
+  mockMode: SITE.ai?.mockMode ?? true,
+  apiEndpoint: SITE.ai?.apiEndpoint || "/api/chat",
+  welcomeMessage: SITE.ai?.welcomeMessage,
+  placeholder: SITE.ai?.placeholder,
+  lang,
+};
+---
+
+{aiEnabled && (
+  <AIChatContainer
+    client:only="preact"
+    config={aiConfig}
+    articleContext={articleContext}
+  />
+)}