@astro-minimax/ai 0.7.4 → 0.8.0

package/dist/server/notify.js

@@ -1,74 +0,0 @@
-import { createNotifier } from '@astro-minimax/notify';
-let notifierInstance = null;
-function getNotifier(env) {
-    if (notifierInstance)
-        return notifierInstance;
-    const hasConfig = env.NOTIFY_TELEGRAM_BOT_TOKEN || env.NOTIFY_WEBHOOK_URL || env.NOTIFY_RESEND_API_KEY;
-    if (!hasConfig) {
-        console.warn('[notify] No notification providers configured. Missing environment variables: NOTIFY_TELEGRAM_BOT_TOKEN, NOTIFY_WEBHOOK_URL, or NOTIFY_RESEND_API_KEY');
-        return null;
-    }
-    const providers = [];
-    if (env.NOTIFY_TELEGRAM_BOT_TOKEN && env.NOTIFY_TELEGRAM_CHAT_ID)
-        providers.push('telegram');
-    if (env.NOTIFY_WEBHOOK_URL)
-        providers.push('webhook');
-    if (env.NOTIFY_RESEND_API_KEY && env.NOTIFY_RESEND_FROM && env.NOTIFY_RESEND_TO)
-        providers.push('email');
-    console.log(`[notify] Initializing notifier with providers: ${providers.join(', ') || 'none'}`);
-    notifierInstance = createNotifier({
-        telegram: env.NOTIFY_TELEGRAM_BOT_TOKEN && env.NOTIFY_TELEGRAM_CHAT_ID ? {
-            botToken: env.NOTIFY_TELEGRAM_BOT_TOKEN,
-            chatId: env.NOTIFY_TELEGRAM_CHAT_ID,
-        } : undefined,
-        webhook: env.NOTIFY_WEBHOOK_URL ? {
-            url: env.NOTIFY_WEBHOOK_URL,
-        } : undefined,
-        email: env.NOTIFY_RESEND_API_KEY && env.NOTIFY_RESEND_FROM && env.NOTIFY_RESEND_TO ? {
-            provider: 'resend',
-            apiKey: env.NOTIFY_RESEND_API_KEY,
-            from: env.NOTIFY_RESEND_FROM,
-            to: env.NOTIFY_RESEND_TO,
-        } : undefined,
-    });
-    return notifierInstance;
-}
-function getMessageText(message) {
-    if (Array.isArray(message.parts)) {
-        return message.parts
-            .filter((p) => p.type === 'text')
-            .map(p => p.text)
-            .join('');
-    }
-    return '';
-}
-export function notifyAiChat(options) {
-    const { env, sessionId, messages, aiResponse, referencedArticles, model, usage, timing } = options;
-    const notifier = getNotifier(env);
-    if (!notifier) {
-        console.warn('[notify] AI chat notification skipped: no notifier available. Check environment variables.');
-        return Promise.resolve(null);
-    }
-    const userMessages = messages.filter(m => m.role === 'user');
-    const lastUserMessage = userMessages[userMessages.length - 1];
-    if (!lastUserMessage) {
-        console.warn('[notify] AI chat notification skipped: no user message found in messages array');
-        return Promise.resolve(null);
-    }
-    const userMessage = getMessageText(lastUserMessage);
-    const roundNumber = userMessages.length;
-    return notifier.aiChat({
-        sessionId,
-        roundNumber,
-        userMessage,
-        aiResponse: aiResponse?.slice(0, 500),
-        referencedArticles,
-        model,
-        usage,
-        timing,
-        siteUrl: env.SITE_URL,
-    }).catch((error) => {
-        console.error('[notify] AI chat notification failed:', error);
-        return null;
-    });
-}

package/dist/server/stream-helpers.js

@@ -1,197 +0,0 @@
-/**
- * Stream helper utilities for chat-handler.
- *
- * Extracts duplicated stream-writing logic into reusable functions,
- * eliminating 34+ `as never` casts and reducing chat-handler.ts size.
- */
-import { streamText, convertToModelMessages, } from 'ai';
-import { t } from '../utils/i18n.js';
-import { createChatStatusData } from './types.js';
-import { createResponsePlaybackGenerator } from '../cache/response-cache.js';
-// ── Metadata Writers ──────────────────────────────────────
-export function writeSearchStatus(writer, count, lang) {
-    writer.write({
-        type: 'message-metadata',
-        messageMetadata: createChatStatusData({
-            stage: 'search',
-            message: t('ai.status.found', lang, { count }),
-            progress: 40,
-        }),
-    });
-}
-export function writeGeneratingStatus(writer, lang, progress = 60) {
-    writer.write({
-        type: 'message-metadata',
-        messageMetadata: createChatStatusData({
-            stage: 'answer',
-            message: t('ai.status.generating', lang),
-            progress,
-        }),
-    });
-}
-export function writeDoneStatus(writer, lang) {
-    writer.write({
-        type: 'message-metadata',
-        messageMetadata: createChatStatusData({
-            stage: 'answer',
-            message: t('ai.status.generating', lang),
-            progress: 100,
-            done: true,
-        }),
-    });
-}
-export function writeSourceArticles(writer, articles, max = 3) {
-    for (const article of articles.slice(0, max)) {
-        try {
-            writer.write({
-                type: 'source-url',
-                sourceId: `source-${article.title}`,
-                url: article.url ?? '#',
-                title: article.title,
-            });
-        }
-        catch { /* best-effort */ }
-    }
-}
-export function writeTextChunk(writer, text, idPrefix = 'text') {
-    const id = `${idPrefix}-${Date.now()}`;
-    writer.write({ type: 'text-start', id });
-    writer.write({ type: 'text-delta', id, delta: text });
-    writer.write({ type: 'text-end', id });
-}
-export function writeFinish(writer, reason = 'stop') {
-    writer.write({ type: 'finish', finishReason: reason });
-}
-// ── LLM Streaming ─────────────────────────────────────────
-export async function streamLLMResponse(params) {
-    const { writer, adapter, systemPrompt, messages, lang, temperature = 0.3, maxOutputTokens = 2500, } = params;
-    const start = Date.now();
-    try {
-        const provider = adapter.getProvider();
-        const result = streamText({
-            model: provider.chatModel(adapter.model),
-            system: systemPrompt,
-            messages: await convertToModelMessages(messages),
-            temperature,
-            maxOutputTokens,
-            onError: ({ error }) => {
-                console.error('[stream-helpers] streamText error:', error);
-            },
-        });
-        const streamErrors = [];
-        writer.merge(result.toUIMessageStream({ sendFinish: false }));
-        await result.consumeStream({
-            onError: (error) => {
-                streamErrors.push(error instanceof Error ? error : new Error(String(error)));
-            },
-        });
-        const text = await result.text;
-        let reasoningText;
-        const reasoningPromise = result.reasoning;
-        if (reasoningPromise) {
-            try {
-                const reasoningOutput = await Promise.resolve(reasoningPromise);
-                reasoningText = typeof reasoningOutput === 'string'
-                    ? reasoningOutput
-                    : (Array.isArray(reasoningOutput)
-                        ? reasoningOutput.map((r) => {
-                            if (typeof r === 'object' && r !== null && 'text' in r)
-                                return r.text;
-                            return String(r);
-                        }).join('')
-                        : undefined);
-            }
-            catch { /* reasoning is optional */ }
-        }
-        let tokenUsage;
-        const usagePromise = result.usage;
-        if (usagePromise) {
-            try {
-                const usage = await Promise.resolve(usagePromise);
-                const inputTokens = usage.inputTokens ?? 0;
-                const outputTokens = usage.outputTokens ?? 0;
-                tokenUsage = {
-                    total: usage.totalTokens ?? inputTokens + outputTokens,
-                    input: inputTokens,
-                    output: outputTokens,
-                };
-            }
-            catch { /* usage is optional */ }
-        }
-        const generationMs = Date.now() - start;
-        if (streamErrors.length > 0) {
-            adapter.recordFailure(streamErrors[0]);
-            writeTextChunk(writer, t('ai.error.generic', lang), 'error');
-            writeFinish(writer, 'error');
-            return { success: true, responseText: text, reasoningText, tokenUsage, generationMs };
-        }
-        if (text.length > 0) {
-            adapter.recordSuccess();
-            writeFinish(writer);
-            return { success: true, responseText: text, reasoningText, tokenUsage, generationMs };
-        }
-        writeTextChunk(writer, t('ai.error.noOutput', lang), 'no-output');
-        writeFinish(writer);
-        return { success: true, responseText: '', reasoningText, tokenUsage, generationMs };
-    }
-    catch (err) {
-        adapter.recordFailure(err instanceof Error ? err : new Error(String(err)));
-        console.error('[stream-helpers] Provider threw:', err.message);
-        return { success: false, responseText: '', generationMs: Date.now() - start };
-    }
-}
-// ── Mock Fallback ─────────────────────────────────────────
-export async function streamMockFallback(writer, question, lang) {
-    const { getMockResponse } = await import('../providers/mock.js');
-    const mockText = getMockResponse(question, lang);
-    writer.write({
-        type: 'message-metadata',
-        messageMetadata: createChatStatusData({
-            stage: 'answer',
-            message: t('ai.status.fallback', lang),
-            progress: 80,
-        }),
-    });
-    writeTextChunk(writer, mockText, 'fallback');
-    writeFinish(writer);
-    return mockText;
-}
-// ── Cached Response Playback ──────────────────────────────
-export async function streamCachedResponse(writer, cachedResponse, config, lang) {
-    writeSearchStatus(writer, cachedResponse.articles.length + cachedResponse.projects.length, lang);
-    writeGeneratingStatus(writer, lang);
-    writeSourceArticles(writer, cachedResponse.articles);
-    writeGeneratingStatus(writer, lang, 70);
-    const playbackGenerator = createResponsePlaybackGenerator(cachedResponse, config);
-    let thinkingId;
-    const textId = `text-${Date.now()}`;
-    let textStarted = false;
-    for await (const chunk of playbackGenerator) {
-        if (chunk.type === 'thinking') {
-            if (!thinkingId) {
-                thinkingId = `thinking-${Date.now()}`;
-                writer.write({ type: 'reasoning-start', id: thinkingId });
-            }
-            writer.write({ type: 'reasoning-delta', id: thinkingId, delta: chunk.text });
-        }
-        else {
-            if (thinkingId) {
-                writer.write({ type: 'reasoning-end', id: thinkingId });
-                thinkingId = undefined;
-            }
-            if (!textStarted) {
-                writer.write({ type: 'text-start', id: textId });
-                textStarted = true;
-            }
-            writer.write({ type: 'text-delta', id: textId, delta: chunk.text });
-        }
-    }
-    if (thinkingId) {
-        writer.write({ type: 'reasoning-end', id: thinkingId });
-    }
-    if (textStarted) {
-        writer.write({ type: 'text-end', id: textId });
-    }
-    writeDoneStatus(writer, lang);
-    writeFinish(writer);
-}

package/dist/server/types.js

@@ -1,13 +0,0 @@
-export function createChatStatusData(partial) {
-    return {
-        ...partial,
-        done: partial.done ?? partial.stage === 'complete',
-        at: Date.now(),
-    };
-}
-export function isChatStatusData(value) {
-    if (!value || typeof value !== 'object')
-        return false;
-    const v = value;
-    return typeof v.stage === 'string' && typeof v.message === 'string' && typeof v.progress === 'number';
-}

package/dist/stream/mock-stream.js

@@ -1,27 +0,0 @@
-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.js

@@ -1,22 +0,0 @@
-/**
- * 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.js

@@ -1,164 +0,0 @@
-/**
- * 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",
-        "ai.prompt.section.sourceLayers": "Source Priority Protocol (must follow)",
-        "ai.prompt.section.privacy": "Privacy Protection",
-        "ai.prompt.section.answerModes": "Answer Mode Guide (follow detected mode)",
-        "ai.prompt.section.preOutputChecks": "Pre-Output Checks (execute mentally, do not output steps)",
-        "ai.semiStatic.blogOverview": "Blog Overview",
-        "ai.semiStatic.totalPosts": "{count} posts total",
-        "ai.semiStatic.mainCategories": "Main categories: {categories}",
-        "ai.semiStatic.latestArticles": "Latest Posts",
-    },
-    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": "约束",
-        "ai.prompt.section.sourceLayers": "来源分层协议（必须遵守）",
-        "ai.prompt.section.privacy": "隐私保护",
-        "ai.prompt.section.answerModes": "回答模式指导（按检测到的模式执行）",
-        "ai.prompt.section.preOutputChecks": "输出前检查（在心里执行，不输出步骤）",
-        "ai.semiStatic.blogOverview": "博客概况",
-        "ai.semiStatic.totalPosts": "共有 {count} 篇文章",
-        "ai.semiStatic.mainCategories": "主要分类：{categories}",
-        "ai.semiStatic.latestArticles": "最新文章",
-    },
-};
-/**
- * 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/src/components/AIChatContainer.tsx

@@ -1,31 +0,0 @@
-/** @jsxImportSource preact */
-import { useState, useCallback } from 'preact/hooks';
-import { ChatPanel } from './ChatPanel.tsx';
-import type { AIChatConfig } from './ChatPanel.tsx';
-import type { ArticleChatContext } from '../server/types.ts';
-
-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}
-    />
-  );
-}