@astro-minimax/ai 0.2.0 → 0.7.0

package/dist/server/chat-handler.js

@@ -1,12 +1,37 @@
 import { createUIMessageStream, createUIMessageStreamResponse, streamText, convertToModelMessages, } from 'ai';
 import { t, getLang } from '../utils/i18n.js';
-import { getClientIP, checkRateLimit, rateLimitResponse, searchArticles, searchProjects, getSessionCacheKey, getCachedContext, setCachedContext, shouldReuseSearchContext, buildLocalSearchQuery, shouldRunKeywordExtraction, extractSearchKeywords, KEYWORD_EXTRACTION_TIMEOUT_MS, shouldSkipAnalysis, analyzeRetrievedEvidence, buildEvidenceSection, EVIDENCE_ANALYSIS_TIMEOUT_MS, getCitationGuardPreflight, buildSystemPrompt, getAuthorContext, getVoiceProfile, mergeResults, ProviderManager, createCacheAdapter, detectPublicQuestion, getGlobalSearchCache, setGlobalSearchCache, getGlobalCacheTTL, getResponseCache, setResponseCache, getResponseCacheConfig, createResponsePlaybackGenerator, } from '../index.js';
+import { getClientIP, checkRateLimit, rateLimitResponse, searchArticles, searchProjects, getSessionCacheKey, getCachedContext, setCachedContext, shouldReuseSearchContext, buildLocalSearchQuery, shouldRunKeywordExtraction, extractSearchKeywords, KEYWORD_EXTRACTION_TIMEOUT_MS, shouldSkipAnalysis, analyzeRetrievedEvidence, buildEvidenceSection, EVIDENCE_ANALYSIS_TIMEOUT_MS, getCitationGuardPreflight, buildSystemPrompt, getAuthorContext, getVoiceProfile, mergeResults, getProviderManager, createCacheAdapter, detectPublicQuestion, getGlobalSearchCache, setGlobalSearchCache, getGlobalCacheTTL, getResponseCache, setResponseCache, getResponseCacheConfig, rankArticlesByIntent, } from '../index.js';
 import { createChatStatusData } from './types.js';
 import { errors, corsPreflightResponse } from './errors.js';
 import { notifyAiChat } from './notify.js';
+import { writeSearchStatus, writeGeneratingStatus, writeSourceArticles, streamLLMResponse, streamMockFallback, streamCachedResponse, } from './stream-helpers.js';
 const MAX_HISTORY_MESSAGES = 20;
 const MAX_INPUT_LENGTH = 500;
 const REQUEST_TIMEOUT_MS = 45_000;
+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, 5).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;
+    }
+}
 // ── Message Helpers ───────────────────────────────────────────
 function getMessageText(message) {
     if (Array.isArray(message.parts)) {
@@ -64,7 +89,7 @@ function buildArticleContextPrompt(context) {
 }
 // ── Main Handler ──────────────────────────────────────────────
 export async function handleChatRequest(options) {
-    const { env, request: req } = options;
+    const { env, request: req, waitUntil } = options;
     if (req.method === 'OPTIONS')
         return corsPreflightResponse();
     if (req.method !== 'POST')
@@ -97,7 +122,7 @@ export async function handleChatRequest(options) {
     const requestAbort = new AbortController();
     const requestTimer = setTimeout(() => requestAbort.abort(), REQUEST_TIMEOUT_MS);
     try {
-        return await runPipeline({ env, messages, latestText, context, req, requestAbort, lang });
+        return await runPipeline({ env, messages, latestText, context, req, requestAbort, lang, waitUntil });
     }
     catch (err) {
         if (requestAbort.signal.aborted)
@@ -110,11 +135,11 @@ export async function handleChatRequest(options) {
     }
 }
 async function runPipeline(args) {
-    const { env, messages, latestText, context, req, lang } = args;
+    const { env, messages, latestText, context, req, lang, waitUntil } = args;
     const timing = { start: Date.now() };
     const cache = createCacheAdapter(env);
     const responseCacheConfig = getResponseCacheConfig(env);
-    const manager = new ProviderManager(env, {
+    const manager = getProviderManager(env, {
         enableMockFallback: true,
         unhealthyThreshold: 3,
         healthRecoveryTTL: 60_000,
@@ -136,93 +161,14 @@ async function runPipeline(args) {
             if (cachedResponse) {
                 globalCacheHit = true;
                 globalCacheType = publicQuestion.type;
+                const notifyTiming = { total: Date.now() - timing.start };
+                sendNotification({ env, messages, responseText: cachedResponse.response, relatedArticles: cachedResponse.articles, timing: notifyTiming, waitUntil });
                 const stream = createUIMessageStream({
                     execute: async ({ writer }) => {
-                        writer.write({
-                            type: 'message-metadata',
-                            messageMetadata: createChatStatusData({
-                                stage: 'search',
-                                message: t('ai.status.found', lang, { count: cachedResponse.articles.length + cachedResponse.projects.length }),
-                                progress: 40,
-                            }),
-                        });
-                        writer.write({
-                            type: 'message-metadata',
-                            messageMetadata: createChatStatusData({
-                                stage: 'answer',
-                                message: t('ai.status.generating', lang),
-                                progress: 60,
-                            }),
-                        });
-                        for (const article of cachedResponse.articles.slice(0, 3)) {
-                            try {
-                                writer.write({
-                                    type: 'source-url',
-                                    sourceId: `source-${article.title}`,
-                                    url: article.url ?? '#',
-                                    title: article.title,
-                                });
-                            }
-                            catch { /* best-effort */ }
-                        }
-                        writer.write({
-                            type: 'message-metadata',
-                            messageMetadata: createChatStatusData({
-                                stage: 'answer',
-                                message: t('ai.status.generating', lang),
-                                progress: 70,
-                            }),
-                        });
-                        const playbackGenerator = createResponsePlaybackGenerator(cachedResponse, responseCacheConfig);
-                        let hasThinking = !!cachedResponse.thinking;
-                        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 });
-                        }
-                        writer.write({
-                            type: 'message-metadata',
-                            messageMetadata: createChatStatusData({
-                                stage: 'answer',
-                                message: t('ai.status.generating', lang),
-                                progress: 100,
-                                done: true,
-                            }),
-                        });
-                        writer.write({ type: 'finish', finishReason: 'stop' });
-                    },
-                });
-                return createUIMessageStreamResponse({
-                    stream,
-                    headers: {
-                        'Access-Control-Allow-Origin': '*',
-                        'Cache-Control': 'no-cache',
+                        await streamCachedResponse(writer, cachedResponse, responseCacheConfig, lang);
                     },
                 });
+                return createUIMessageStreamResponse({ stream, headers: { 'Access-Control-Allow-Origin': '*', 'Cache-Control': 'no-cache' } });
             }
         }
         // Check search context cache
@@ -232,159 +178,37 @@ async function runPipeline(args) {
             globalCacheType = publicQuestion.type;
             const stream = createUIMessageStream({
                 execute: async ({ writer }) => {
-                    writer.write({
-                        type: 'message-metadata',
-                        messageMetadata: createChatStatusData({
-                            stage: 'search',
-                            message: t('ai.status.found', lang, { count: cachedSearch.articles.length + cachedSearch.projects.length }),
-                            progress: 40,
-                        }),
-                    });
-                    const articleCount = cachedSearch.articles.length + cachedSearch.projects.length;
-                    if (articleCount > 0) {
-                        writer.write({
-                            type: 'message-metadata',
-                            messageMetadata: createChatStatusData({
-                                stage: 'answer',
-                                message: t('ai.status.generating', lang),
-                                progress: 60,
-                            }),
-                        });
-                    }
-                    for (const article of cachedSearch.articles.slice(0, 3)) {
-                        try {
-                            writer.write({
-                                type: 'source-url',
-                                sourceId: `source-${article.title}`,
-                                url: article.url ?? '#',
-                                title: article.title,
-                            });
-                        }
-                        catch { /* best-effort */ }
+                    const w = writer;
+                    writeSearchStatus(w, cachedSearch.articles.length + cachedSearch.projects.length, lang);
+                    if (cachedSearch.articles.length + cachedSearch.projects.length > 0) {
+                        writeGeneratingStatus(w, lang);
                     }
+                    writeSourceArticles(w, cachedSearch.articles);
                     let responseText = '';
                     if (adapter) {
-                        try {
-                            const provider = adapter.getProvider();
-                            const articlePrompt = buildArticleContextPrompt(context);
-                            const systemPrompt = buildSystemPrompt({
-                                static: {
-                                    authorName: env.SITE_AUTHOR || '博主',
-                                    siteUrl: env.SITE_URL || '',
-                                    lang,
-                                },
-                                semiStatic: {
-                                    authorContext: getAuthorContext(),
-                                    voiceProfile: getVoiceProfile(),
-                                },
-                                dynamic: {
-                                    userQuery: cachedSearch.query,
-                                    articles: cachedSearch.articles,
-                                    projects: cachedSearch.projects,
-                                    evidenceSection: articlePrompt,
-                                },
-                            });
-                            const result = streamText({
-                                model: provider.chatModel(adapter.model),
-                                system: systemPrompt,
-                                messages: await convertToModelMessages(messages),
-                                temperature: 0.3,
-                                maxOutputTokens: 2500,
-                            });
-                            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;
-                            const reasoningPromise = result.reasoning;
-                            let reasoningText;
-                            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 */ }
-                            }
-                            responseText = text;
-                            if (streamErrors.length > 0) {
-                                adapter.recordFailure(streamErrors[0]);
-                                const errorId = `error-${Date.now()}`;
-                                writer.write({ type: 'text-start', id: errorId });
-                                writer.write({
-                                    type: 'text-delta',
-                                    id: errorId,
-                                    delta: t('ai.error.generic', lang)
-                                });
-                                writer.write({ type: 'text-end', id: errorId });
-                                writer.write({ type: 'finish', finishReason: 'error' });
-                            }
-                            else if (text.length > 0) {
-                                adapter.recordSuccess();
-                                writer.write({ type: 'finish', finishReason: 'stop' });
-                            }
-                            else {
-                                const noOutputId = `no-output-${Date.now()}`;
-                                writer.write({ type: 'text-start', id: noOutputId });
-                                writer.write({ type: 'text-delta', id: noOutputId, delta: t('ai.error.noOutput', lang) });
-                                writer.write({ type: 'text-end', id: noOutputId });
-                                writer.write({ type: 'finish', finishReason: 'stop' });
-                            }
-                            // Save to response cache if enabled
-                            if (responseCacheConfig.enabled && text.length > 0 && streamErrors.length === 0) {
-                                const globalTTL = getGlobalCacheTTL(publicQuestion.type);
-                                const responseCacheData = {
-                                    query: cachedSearch.query,
-                                    thinking: reasoningText,
-                                    response: text,
-                                    articles: cachedSearch.articles,
-                                    projects: cachedSearch.projects,
-                                    lang,
-                                    model: adapter.model,
-                                    updatedAt: Date.now(),
-                                };
-                                await setResponseCache(cache, publicQuestion.type, responseCacheData, globalTTL, globalCacheContext);
-                            }
-                        }
-                        catch (err) {
-                            console.error('[chat-handler] Global cache LLM error:', err);
-                            const errorId = `error-${Date.now()}`;
-                            writer.write({ type: 'text-start', id: errorId });
-                            writer.write({
-                                type: 'text-delta',
-                                id: errorId,
-                                delta: t('ai.error.generic', lang)
-                            });
-                            writer.write({ type: 'text-end', id: errorId });
-                            writer.write({ type: 'finish', finishReason: 'error' });
+                        const articlePrompt = buildArticleContextPrompt(context);
+                        const systemPrompt = buildSystemPrompt({
+                            static: { authorName: env.SITE_AUTHOR || '博主', siteUrl: env.SITE_URL || '', lang },
+                            semiStatic: { authorContext: getAuthorContext(), voiceProfile: getVoiceProfile() },
+                            dynamic: { userQuery: cachedSearch.query, articles: cachedSearch.articles, projects: cachedSearch.projects, evidenceSection: articlePrompt },
+                        });
+                        const llmResult = await streamLLMResponse({ writer: w, adapter, systemPrompt, messages, lang });
+                        responseText = llmResult.responseText;
+                        if (responseCacheConfig.enabled && llmResult.success && llmResult.responseText.length > 0) {
+                            const globalTTL = getGlobalCacheTTL(publicQuestion.type);
+                            const responseCacheData = {
+                                query: cachedSearch.query, thinking: llmResult.reasoningText, response: llmResult.responseText,
+                                articles: cachedSearch.articles, projects: cachedSearch.projects, lang, model: adapter.model, updatedAt: Date.now(),
+                            };
+                            await setResponseCache(cache, publicQuestion.type, responseCacheData, globalTTL, globalCacheContext);
                         }
                     }
                     else {
-                        const { getMockResponse } = await import('../providers/mock.js');
-                        const mockText = getMockResponse(latestText, lang);
-                        responseText = mockText;
-                        const mockId = `mock-${Date.now()}`;
-                        writer.write({ type: 'text-start', id: mockId });
-                        writer.write({ type: 'text-delta', id: mockId, delta: mockText });
-                        writer.write({ type: 'text-end', id: mockId });
-                        writer.write({ type: 'finish', finishReason: 'stop' });
+                        responseText = await streamMockFallback(w, latestText, lang);
                     }
                 },
             });
-            return createUIMessageStreamResponse({
-                stream,
-                headers: {
-                    'Access-Control-Allow-Origin': '*',
-                    'Cache-Control': 'no-cache',
-                },
-            });
+            return createUIMessageStreamResponse({ stream, headers: { 'Access-Control-Allow-Origin': '*', 'Cache-Control': 'no-cache' } });
         }
     }
     // ── Search / Retrieval ──────────────────────────────────────
@@ -445,6 +269,7 @@ async function runPipeline(args) {
             relatedProjects = searchProjects(searchQuery);
             timing.search = Date.now() - searchStart;
         }
+        relatedArticles = rankArticlesByIntent(latestText, relatedArticles);
         if (cacheKey) {
             await setCachedContext(cacheKey, {
                 query: searchQuery,
@@ -499,6 +324,7 @@ async function runPipeline(args) {
         userQuery: latestText,
         articles: relatedArticles,
         projects: relatedProjects,
+        lang,
     });
     // ── Build System Prompt ─────────────────────────────────────
     const articlePrompt = buildArticleContextPrompt(context);
@@ -519,6 +345,7 @@ async function runPipeline(args) {
             evidenceSection: articlePrompt
                 ? `${evidenceSection}\n${articlePrompt}`
                 : evidenceSection,
+            lang,
         },
     });
     // ── Stream Response via createUIMessageStream ───────────────
@@ -722,20 +549,16 @@ async function runPipeline(args) {
                     provider: env.AI_PROVIDER || undefined,
                     apiHost: env.AI_BASE_URL || undefined,
                 } : undefined;
-                const notifyArticles = relatedArticles.slice(0, 5).map(a => ({
-                    title: a.title,
-                    url: a.url,
-                }));
-                const sessionId = cacheKey || `dev-${Date.now().toString(36)}`;
-                void notifyAiChat({
+                sendNotification({
                     env,
-                    sessionId,
                     messages,
-                    aiResponse: responseText,
-                    referencedArticles: notifyArticles,
+                    responseText,
+                    relatedArticles,
                     model: notifyModel,
                     usage: tokenUsage,
                     timing: notifyTiming,
+                    cacheKey,
+                    waitUntil,
                 });
             }
         },

package/dist/server/index.d.ts

@@ -3,6 +3,7 @@ export { initializeMetadata, resetMetadataInit } from './metadata-init.js';
 export { errors, corsPreflightResponse, chatError } from './errors.js';
 export { notifyAiChat } from './notify.js';
 export type { ChatNotifyOptions } from './notify.js';
+export { writeSearchStatus, writeGeneratingStatus, writeDoneStatus, writeSourceArticles, writeTextChunk, writeFinish, streamLLMResponse, streamMockFallback, streamCachedResponse, } from './stream-helpers.js';
 export { createChatStatusData, isChatStatusData, } from './types.js';
 export type { ChatContext, ArticleChatContext, ChatRequestBody, ChatHandlerEnv, ChatHandlerOptions, ChatStatusData, ChatStatusStage, ChatErrorResponse, MetadataConfig, } from './types.js';
 //# sourceMappingURL=index.d.ts.map

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

@@ -1 +1 @@
-{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/server/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,iBAAiB,EAAE,MAAM,mBAAmB,CAAC;AACtD,OAAO,EAAE,kBAAkB,EAAE,iBAAiB,EAAE,MAAM,oBAAoB,CAAC;AAC3E,OAAO,EAAE,MAAM,EAAE,qBAAqB,EAAE,SAAS,EAAE,MAAM,aAAa,CAAC;AACvE,OAAO,EAAE,YAAY,EAAE,MAAM,aAAa,CAAC;AAC3C,YAAY,EAAE,iBAAiB,EAAE,MAAM,aAAa,CAAC;AACrD,OAAO,EACL,oBAAoB,EACpB,gBAAgB,GACjB,MAAM,YAAY,CAAC;AACpB,YAAY,EACV,WAAW,EACX,kBAAkB,EAClB,eAAe,EACf,cAAc,EACd,kBAAkB,EAClB,cAAc,EACd,eAAe,EACf,iBAAiB,EACjB,cAAc,GACf,MAAM,YAAY,CAAC"}
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/server/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,iBAAiB,EAAE,MAAM,mBAAmB,CAAC;AACtD,OAAO,EAAE,kBAAkB,EAAE,iBAAiB,EAAE,MAAM,oBAAoB,CAAC;AAC3E,OAAO,EAAE,MAAM,EAAE,qBAAqB,EAAE,SAAS,EAAE,MAAM,aAAa,CAAC;AACvE,OAAO,EAAE,YAAY,EAAE,MAAM,aAAa,CAAC;AAC3C,YAAY,EAAE,iBAAiB,EAAE,MAAM,aAAa,CAAC;AACrD,OAAO,EACL,iBAAiB,EACjB,qBAAqB,EACrB,eAAe,EACf,mBAAmB,EACnB,cAAc,EACd,WAAW,EACX,iBAAiB,EACjB,kBAAkB,EAClB,oBAAoB,GACrB,MAAM,qBAAqB,CAAC;AAC7B,OAAO,EACL,oBAAoB,EACpB,gBAAgB,GACjB,MAAM,YAAY,CAAC;AACpB,YAAY,EACV,WAAW,EACX,kBAAkB,EAClB,eAAe,EACf,cAAc,EACd,kBAAkB,EAClB,cAAc,EACd,eAAe,EACf,iBAAiB,EACjB,cAAc,GACf,MAAM,YAAY,CAAC"}

package/dist/server/index.js

@@ -2,4 +2,5 @@ export { handleChatRequest } from './chat-handler.js';
 export { initializeMetadata, resetMetadataInit } from './metadata-init.js';
 export { errors, corsPreflightResponse, chatError } from './errors.js';
 export { notifyAiChat } from './notify.js';
+export { writeSearchStatus, writeGeneratingStatus, writeDoneStatus, writeSourceArticles, writeTextChunk, writeFinish, streamLLMResponse, streamMockFallback, streamCachedResponse, } from './stream-helpers.js';
 export { createChatStatusData, isChatStatusData, } from './types.js';

package/dist/server/notify.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"notify.d.ts","sourceRoot":"","sources":["../../src/server/notify.ts"],"names":[],"mappings":"AAAA,OAAO,EAAiC,KAAK,YAAY,EAAE,KAAK,UAAU,EAAE,KAAK,SAAS,EAAE,KAAK,UAAU,EAAE,KAAK,WAAW,EAAE,MAAM,uBAAuB,CAAC;AAC7J,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,IAAI,CAAC;AAEpC,UAAU,SAAS;IACjB,yBAAyB,CAAC,EAAE,MAAM,CAAC;IACnC,uBAAuB,CAAC,EAAE,MAAM,CAAC;IACjC,kBAAkB,CAAC,EAAE,MAAM,CAAC;IAC5B,qBAAqB,CAAC,EAAE,MAAM,CAAC;IAC/B,kBAAkB,CAAC,EAAE,MAAM,CAAC;IAC5B,gBAAgB,CAAC,EAAE,MAAM,CAAC;IAC1B,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB,CAAC,GAAG,EAAE,MAAM,GAAG,OAAO,CAAC;CACxB;AAuCD,MAAM,WAAW,iBAAiB;IAChC,GAAG,EAAE,SAAS,CAAC;IACf,SAAS,EAAE,MAAM,CAAC;IAClB,QAAQ,EAAE,SAAS,EAAE,CAAC;IACtB,UAAU,CAAC,EAAE,MAAM,CAAC;IACpB,kBAAkB,CAAC,EAAE,UAAU,EAAE,CAAC;IAClC,KAAK,CAAC,EAAE,SAAS,CAAC;IAClB,KAAK,CAAC,EAAE,UAAU,CAAC;IACnB,MAAM,CAAC,EAAE,WAAW,CAAC;CACtB;AAED,wBAAgB,YAAY,CAAC,OAAO,EAAE,iBAAiB,GAAG,OAAO,CAAC,YAAY,GAAG,IAAI,CAAC,CAgCrF"}
+{"version":3,"file":"notify.d.ts","sourceRoot":"","sources":["../../src/server/notify.ts"],"names":[],"mappings":"AAAA,OAAO,EAAiC,KAAK,YAAY,EAAE,KAAK,UAAU,EAAE,KAAK,SAAS,EAAE,KAAK,UAAU,EAAE,KAAK,WAAW,EAAE,MAAM,uBAAuB,CAAC;AAC7J,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,IAAI,CAAC;AAEpC,UAAU,SAAS;IACjB,yBAAyB,CAAC,EAAE,MAAM,CAAC;IACnC,uBAAuB,CAAC,EAAE,MAAM,CAAC;IACjC,kBAAkB,CAAC,EAAE,MAAM,CAAC;IAC5B,qBAAqB,CAAC,EAAE,MAAM,CAAC;IAC/B,kBAAkB,CAAC,EAAE,MAAM,CAAC;IAC5B,gBAAgB,CAAC,EAAE,MAAM,CAAC;IAC1B,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB,CAAC,GAAG,EAAE,MAAM,GAAG,OAAO,CAAC;CACxB;AAiDD,MAAM,WAAW,iBAAiB;IAChC,GAAG,EAAE,SAAS,CAAC;IACf,SAAS,EAAE,MAAM,CAAC;IAClB,QAAQ,EAAE,SAAS,EAAE,CAAC;IACtB,UAAU,CAAC,EAAE,MAAM,CAAC;IACpB,kBAAkB,CAAC,EAAE,UAAU,EAAE,CAAC;IAClC,KAAK,CAAC,EAAE,SAAS,CAAC;IAClB,KAAK,CAAC,EAAE,UAAU,CAAC;IACnB,MAAM,CAAC,EAAE,WAAW,CAAC;CACtB;AAED,wBAAgB,YAAY,CAAC,OAAO,EAAE,iBAAiB,GAAG,OAAO,CAAC,YAAY,GAAG,IAAI,CAAC,CAkCrF"}

package/dist/server/notify.js

@@ -4,8 +4,18 @@ 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)
+    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,
@@ -36,11 +46,13 @@ 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);

package/dist/server/stream-helpers.d.ts

@@ -0,0 +1,45 @@
+/**
+ * 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 { type UIMessage } from 'ai';
+import type { TokenUsage } from '@astro-minimax/notify';
+import type { ProviderAdapter } from '../provider-manager/types.js';
+import type { CachedAIResponse, ResponseCacheConfig } from '../cache/response-cache.js';
+type MessageStreamWriter = {
+    write: (part: unknown) => void;
+    merge: (stream: ReadableStream) => void;
+};
+interface SourceArticle {
+    title: string;
+    url?: string;
+}
+interface StreamLLMParams {
+    writer: MessageStreamWriter;
+    adapter: ProviderAdapter;
+    systemPrompt: string;
+    messages: UIMessage[];
+    lang: string;
+    temperature?: number;
+    maxOutputTokens?: number;
+}
+interface StreamLLMResult {
+    success: boolean;
+    responseText: string;
+    reasoningText?: string;
+    tokenUsage?: TokenUsage;
+    generationMs: number;
+}
+export declare function writeSearchStatus(writer: MessageStreamWriter, count: number, lang: string): void;
+export declare function writeGeneratingStatus(writer: MessageStreamWriter, lang: string, progress?: number): void;
+export declare function writeDoneStatus(writer: MessageStreamWriter, lang: string): void;
+export declare function writeSourceArticles(writer: MessageStreamWriter, articles: SourceArticle[], max?: number): void;
+export declare function writeTextChunk(writer: MessageStreamWriter, text: string, idPrefix?: string): void;
+export declare function writeFinish(writer: MessageStreamWriter, reason?: 'stop' | 'error'): void;
+export declare function streamLLMResponse(params: StreamLLMParams): Promise<StreamLLMResult>;
+export declare function streamMockFallback(writer: MessageStreamWriter, question: string, lang: string): Promise<string>;
+export declare function streamCachedResponse(writer: MessageStreamWriter, cachedResponse: CachedAIResponse, config: ResponseCacheConfig, lang: string): Promise<void>;
+export {};
+//# sourceMappingURL=stream-helpers.d.ts.map

package/dist/server/stream-helpers.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"stream-helpers.d.ts","sourceRoot":"","sources":["../../src/server/stream-helpers.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAEH,OAAO,EACL,KAAK,SAAS,EAGf,MAAM,IAAI,CAAC;AAGZ,OAAO,KAAK,EAAyB,UAAU,EAAe,MAAM,uBAAuB,CAAC;AAC5F,OAAO,KAAK,EAAE,eAAe,EAAE,MAAM,8BAA8B,CAAC;AACpE,OAAO,KAAK,EACV,gBAAgB,EAChB,mBAAmB,EACpB,MAAM,4BAA4B,CAAC;AAKpC,KAAK,mBAAmB,GAAG;IACzB,KAAK,EAAE,CAAC,IAAI,EAAE,OAAO,KAAK,IAAI,CAAC;IAC/B,KAAK,EAAE,CAAC,MAAM,EAAE,cAAc,KAAK,IAAI,CAAC;CACzC,CAAC;AAEF,UAAU,aAAa;IACrB,KAAK,EAAE,MAAM,CAAC;IACd,GAAG,CAAC,EAAE,MAAM,CAAC;CACd;AAED,UAAU,eAAe;IACvB,MAAM,EAAE,mBAAmB,CAAC;IAC5B,OAAO,EAAE,eAAe,CAAC;IACzB,YAAY,EAAE,MAAM,CAAC;IACrB,QAAQ,EAAE,SAAS,EAAE,CAAC;IACtB,IAAI,EAAE,MAAM,CAAC;IACb,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,eAAe,CAAC,EAAE,MAAM,CAAC;CAC1B;AAED,UAAU,eAAe;IACvB,OAAO,EAAE,OAAO,CAAC;IACjB,YAAY,EAAE,MAAM,CAAC;IACrB,aAAa,CAAC,EAAE,MAAM,CAAC;IACvB,UAAU,CAAC,EAAE,UAAU,CAAC;IACxB,YAAY,EAAE,MAAM,CAAC;CACtB;AAID,wBAAgB,iBAAiB,CAC/B,MAAM,EAAE,mBAAmB,EAC3B,KAAK,EAAE,MAAM,EACb,IAAI,EAAE,MAAM,GACX,IAAI,CASN;AAED,wBAAgB,qBAAqB,CACnC,MAAM,EAAE,mBAAmB,EAC3B,IAAI,EAAE,MAAM,EACZ,QAAQ,SAAK,GACZ,IAAI,CASN;AAED,wBAAgB,eAAe,CAC7B,MAAM,EAAE,mBAAmB,EAC3B,IAAI,EAAE,MAAM,GACX,IAAI,CAUN;AAED,wBAAgB,mBAAmB,CACjC,MAAM,EAAE,mBAAmB,EAC3B,QAAQ,EAAE,aAAa,EAAE,EACzB,GAAG,SAAI,GACN,IAAI,CAWN;AAED,wBAAgB,cAAc,CAC5B,MAAM,EAAE,mBAAmB,EAC3B,IAAI,EAAE,MAAM,EACZ,QAAQ,SAAS,GAChB,IAAI,CAKN;AAED,wBAAgB,WAAW,CACzB,MAAM,EAAE,mBAAmB,EAC3B,MAAM,GAAE,MAAM,GAAG,OAAgB,GAChC,IAAI,CAEN;AAID,wBAAsB,iBAAiB,CACrC,MAAM,EAAE,eAAe,GACtB,OAAO,CAAC,eAAe,CAAC,CA6F1B;AAID,wBAAsB,kBAAkB,CACtC,MAAM,EAAE,mBAAmB,EAC3B,QAAQ,EAAE,MAAM,EAChB,IAAI,EAAE,MAAM,GACX,OAAO,CAAC,MAAM,CAAC,CAgBjB;AAID,wBAAsB,oBAAoB,CACxC,MAAM,EAAE,mBAAmB,EAC3B,cAAc,EAAE,gBAAgB,EAChC,MAAM,EAAE,mBAAmB,EAC3B,IAAI,EAAE,MAAM,GACX,OAAO,CAAC,IAAI,CAAC,CAyCf"}