@astro-minimax/ai 0.5.0 → 0.7.1

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"}

package/dist/server/stream-helpers.js

@@ -0,0 +1,197 @@
+/**
+ * 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.d.ts

@@ -28,6 +28,7 @@ export interface ChatHandlerEnv extends ProviderManagerEnv, CacheEnv {
 export interface ChatHandlerOptions {
     env: ChatHandlerEnv;
     request: Request;
+    waitUntil?: (promise: Promise<unknown>) => void;
 }
 export type ChatStatusStage = 'search' | 'answer' | 'complete';
 export interface ChatStatusData {

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

@@ -1 +1 @@
-{"version":3,"file":"types.d.ts","sourceRoot":"","sources":["../../src/server/types.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,IAAI,CAAC;AACpC,OAAO,KAAK,EAAE,kBAAkB,EAAE,MAAM,8BAA8B,CAAC;AACvE,OAAO,KAAK,EAAE,QAAQ,EAAE,MAAM,mBAAmB,CAAC;AAIlD,MAAM,WAAW,WAAW;IAC1B,KAAK,EAAE,QAAQ,GAAG,SAAS,CAAC;IAC5B,OAAO,CAAC,EAAE,kBAAkB,CAAC;CAC9B;AAED,MAAM,WAAW,kBAAkB;IACjC,IAAI,EAAE,MAAM,CAAC;IACb,KAAK,EAAE,MAAM,CAAC;IACd,UAAU,CAAC,EAAE,MAAM,EAAE,CAAC;IACtB,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB,SAAS,CAAC,EAAE,MAAM,EAAE,CAAC;IACrB,YAAY,CAAC,EAAE,MAAM,EAAE,CAAC;CACzB;AAID,MAAM,WAAW,eAAe;IAC9B,OAAO,CAAC,EAAE,WAAW,CAAC;IACtB,EAAE,CAAC,EAAE,MAAM,CAAC;IACZ,QAAQ,EAAE,SAAS,EAAE,CAAC;IACtB,IAAI,CAAC,EAAE,MAAM,CAAC;CACf;AAED,MAAM,WAAW,cAAe,SAAQ,kBAAkB,EAAE,QAAQ;IAClE,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB,CAAC,GAAG,EAAE,MAAM,GAAG,OAAO,CAAC;CACxB;AAED,MAAM,WAAW,kBAAkB;IACjC,GAAG,EAAE,cAAc,CAAC;IACpB,OAAO,EAAE,OAAO,CAAC;CAClB;AAID,MAAM,MAAM,eAAe,GAAG,QAAQ,GAAG,QAAQ,GAAG,UAAU,CAAC;AAE/D,MAAM,WAAW,cAAc;IAC7B,KAAK,EAAE,eAAe,CAAC;IACvB,OAAO,EAAE,MAAM,CAAC;IAChB,QAAQ,EAAE,MAAM,CAAC;IACjB,IAAI,EAAE,OAAO,CAAC;IACd,EAAE,EAAE,MAAM,CAAC;CACZ;AAED,wBAAgB,oBAAoB,CAClC,OAAO,EAAE,IAAI,CAAC,cAAc,EAAE,MAAM,GAAG,IAAI,CAAC,GAAG;IAAE,IAAI,CAAC,EAAE,OAAO,CAAA;CAAE,GAChE,cAAc,CAMhB;AAED,wBAAgB,gBAAgB,CAAC,KAAK,EAAE,OAAO,GAAG,KAAK,IAAI,cAAc,CAIxE;AAID,MAAM,WAAW,iBAAiB;IAChC,KAAK,EAAE,MAAM,CAAC;IACd,IAAI,EAAE,MAAM,CAAC;IACb,SAAS,EAAE,OAAO,CAAC;IACnB,UAAU,CAAC,EAAE,MAAM,CAAC;CACrB;AAID,MAAM,WAAW,cAAc;IAC7B,SAAS,EAAE,OAAO,CAAC;IACnB,aAAa,EAAE,OAAO,CAAC;IACvB,YAAY,EAAE,OAAO,CAAC;IACtB,OAAO,CAAC,EAAE,MAAM,CAAC;CAClB"}
+{"version":3,"file":"types.d.ts","sourceRoot":"","sources":["../../src/server/types.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,IAAI,CAAC;AACpC,OAAO,KAAK,EAAE,kBAAkB,EAAE,MAAM,8BAA8B,CAAC;AACvE,OAAO,KAAK,EAAE,QAAQ,EAAE,MAAM,mBAAmB,CAAC;AAIlD,MAAM,WAAW,WAAW;IAC1B,KAAK,EAAE,QAAQ,GAAG,SAAS,CAAC;IAC5B,OAAO,CAAC,EAAE,kBAAkB,CAAC;CAC9B;AAED,MAAM,WAAW,kBAAkB;IACjC,IAAI,EAAE,MAAM,CAAC;IACb,KAAK,EAAE,MAAM,CAAC;IACd,UAAU,CAAC,EAAE,MAAM,EAAE,CAAC;IACtB,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB,SAAS,CAAC,EAAE,MAAM,EAAE,CAAC;IACrB,YAAY,CAAC,EAAE,MAAM,EAAE,CAAC;CACzB;AAID,MAAM,WAAW,eAAe;IAC9B,OAAO,CAAC,EAAE,WAAW,CAAC;IACtB,EAAE,CAAC,EAAE,MAAM,CAAC;IACZ,QAAQ,EAAE,SAAS,EAAE,CAAC;IACtB,IAAI,CAAC,EAAE,MAAM,CAAC;CACf;AAED,MAAM,WAAW,cAAe,SAAQ,kBAAkB,EAAE,QAAQ;IAClE,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB,CAAC,GAAG,EAAE,MAAM,GAAG,OAAO,CAAC;CACxB;AAED,MAAM,WAAW,kBAAkB;IACjC,GAAG,EAAE,cAAc,CAAC;IACpB,OAAO,EAAE,OAAO,CAAC;IACjB,SAAS,CAAC,EAAE,CAAC,OAAO,EAAE,OAAO,CAAC,OAAO,CAAC,KAAK,IAAI,CAAC;CACjD;AAID,MAAM,MAAM,eAAe,GAAG,QAAQ,GAAG,QAAQ,GAAG,UAAU,CAAC;AAE/D,MAAM,WAAW,cAAc;IAC7B,KAAK,EAAE,eAAe,CAAC;IACvB,OAAO,EAAE,MAAM,CAAC;IAChB,QAAQ,EAAE,MAAM,CAAC;IACjB,IAAI,EAAE,OAAO,CAAC;IACd,EAAE,EAAE,MAAM,CAAC;CACZ;AAED,wBAAgB,oBAAoB,CAClC,OAAO,EAAE,IAAI,CAAC,cAAc,EAAE,MAAM,GAAG,IAAI,CAAC,GAAG;IAAE,IAAI,CAAC,EAAE,OAAO,CAAA;CAAE,GAChE,cAAc,CAMhB;AAED,wBAAgB,gBAAgB,CAAC,KAAK,EAAE,OAAO,GAAG,KAAK,IAAI,cAAc,CAIxE;AAID,MAAM,WAAW,iBAAiB;IAChC,KAAK,EAAE,MAAM,CAAC;IACd,IAAI,EAAE,MAAM,CAAC;IACb,SAAS,EAAE,OAAO,CAAC;IACnB,UAAU,CAAC,EAAE,MAAM,CAAC;CACrB;AAID,MAAM,WAAW,cAAc;IAC7B,SAAS,EAAE,OAAO,CAAC;IACnB,aAAa,EAAE,OAAO,CAAC;IACvB,YAAY,EAAE,OAAO,CAAC;IACtB,OAAO,CAAC,EAAE,MAAM,CAAC;CAClB"}

package/dist/utils/i18n.d.ts

@@ -2,7 +2,7 @@
  * 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";
+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" | "ai.prompt.section.sourceLayers" | "ai.prompt.section.privacy" | "ai.prompt.section.answerModes" | "ai.prompt.section.preOutputChecks" | "ai.semiStatic.blogOverview" | "ai.semiStatic.totalPosts" | "ai.semiStatic.mainCategories" | "ai.semiStatic.latestArticles";
 /**
  * Get translation by key.
  * @param key - Translation key (type-safe)

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

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

package/dist/utils/i18n.js

@@ -61,6 +61,14 @@ const translations = {
         "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
@@ -120,6 +128,14 @@ const translations = {
         "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": "最新文章",
     },
 };
 /**

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@astro-minimax/ai",
-  "version": "0.5.0",
+  "version": "0.7.1",
   "type": "module",
   "description": "Vendor-agnostic AI integration package with full RAG pipeline for astro-minimax blogs — supports OpenAI, Cloudflare AI, and custom providers.",
   "author": "Souloss",
@@ -80,7 +80,7 @@
     "@ai-sdk/openai-compatible": "^2.0.35",
     "ai": "^6.0.116",
     "workers-ai-provider": "^3.1.2",
-    "@astro-minimax/notify": "0.5.0"
+    "@astro-minimax/notify": "0.7.1"
   },
   "optionalDependencies": {
     "undici": "^6.0.0"