@astro-minimax/ai 0.2.0

package/dist/server/dev-server.d.ts

@@ -0,0 +1,18 @@
+#!/usr/bin/env node
+/**
+ * Standalone local AI dev server using Node.js built-in HTTP.
+ * Runs alongside `astro dev` to provide /api/chat and /api/ai-info endpoints
+ * when wrangler pages dev is unavailable.
+ *
+ * Usage:
+ *   pnpm exec astro-ai-dev           # Start dev server
+ *   pnpm exec astro-ai-dev --init    # Initialize datas/ directory
+ *
+ * Environment variables:
+ *   AI_DEV_PORT - Port to listen on (default: 8787)
+ *   AI_BASE_URL - AI provider base URL
+ *   AI_API_KEY  - AI provider API key
+ *   AI_MODEL    - AI model name
+ */
+export {};
+//# sourceMappingURL=dev-server.d.ts.map

package/dist/server/dev-server.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"dev-server.d.ts","sourceRoot":"","sources":["../../src/server/dev-server.ts"],"names":[],"mappings":";AACA;;;;;;;;;;;;;;GAcG"}

package/dist/server/dev-server.js

@@ -0,0 +1,294 @@
+#!/usr/bin/env node
+/**
+ * Standalone local AI dev server using Node.js built-in HTTP.
+ * Runs alongside `astro dev` to provide /api/chat and /api/ai-info endpoints
+ * when wrangler pages dev is unavailable.
+ *
+ * Usage:
+ *   pnpm exec astro-ai-dev           # Start dev server
+ *   pnpm exec astro-ai-dev --init    # Initialize datas/ directory
+ *
+ * Environment variables:
+ *   AI_DEV_PORT - Port to listen on (default: 8787)
+ *   AI_BASE_URL - AI provider base URL
+ *   AI_API_KEY  - AI provider API key
+ *   AI_MODEL    - AI model name
+ */
+import { createServer } from 'node:http';
+import { readFileSync, existsSync, mkdirSync, writeFileSync } from 'node:fs';
+import { resolve, dirname } from 'node:path';
+import { fileURLToPath } from 'node:url';
+const __filename = fileURLToPath(import.meta.url);
+const __dirname = dirname(__filename);
+const DEFAULT_SUMMARIES = { meta: { lastUpdated: new Date().toISOString(), model: 'none', totalProcessed: 0 }, articles: {} };
+const DEFAULT_AUTHOR_CONTEXT = { author: {}, posts: [] };
+const DEFAULT_VOICE_PROFILE = { style: {}, examples: [] };
+function extractPostTitle(url) {
+    const match = url.match(/\/posts\/([^/]+)/);
+    if (match) {
+        return decodeURIComponent(match[1].replace(/-/g, ' '));
+    }
+    return '博客文章';
+}
+function findBlogRoot() {
+    let dir = process.cwd();
+    for (let i = 0; i < 10; i++) {
+        if (existsSync(resolve(dir, 'datas'))) {
+            return { root: dir, datasDir: resolve(dir, 'datas'), hasDatas: true };
+        }
+        if (existsSync(resolve(dir, 'apps', 'blog', 'datas'))) {
+            return { root: resolve(dir, 'apps', 'blog'), datasDir: resolve(dir, 'apps', 'blog', 'datas'), hasDatas: true };
+        }
+        if (existsSync(resolve(dir, 'src', 'data'))) {
+            return { root: dir, datasDir: resolve(dir, 'src', 'data'), hasDatas: true };
+        }
+        const parent = resolve(dir, '..');
+        if (parent === dir)
+            break;
+        dir = parent;
+    }
+    return { root: process.cwd(), datasDir: resolve(process.cwd(), 'datas'), hasDatas: false };
+}
+function loadEnv(envPath) {
+    if (!existsSync(envPath))
+        return;
+    const content = readFileSync(envPath, 'utf-8');
+    for (const line of content.split('\n')) {
+        const trimmed = line.trim();
+        if (!trimmed || trimmed.startsWith('#'))
+            continue;
+        const eqIndex = trimmed.indexOf('=');
+        if (eqIndex === -1)
+            continue;
+        const key = trimmed.slice(0, eqIndex).trim();
+        let value = trimmed.slice(eqIndex + 1).trim();
+        if ((value.startsWith('"') && value.endsWith('"')) || (value.startsWith("'") && value.endsWith("'"))) {
+            value = value.slice(1, -1);
+        }
+        if (!process.env[key]) {
+            process.env[key] = value;
+        }
+    }
+}
+function initDatasDirectory(datasDir) {
+    if (!existsSync(datasDir)) {
+        mkdirSync(datasDir, { recursive: true });
+    }
+    const files = [
+        { name: 'ai-summaries.json', content: DEFAULT_SUMMARIES },
+        { name: 'author-context.json', content: DEFAULT_AUTHOR_CONTEXT },
+        { name: 'voice-profile.json', content: DEFAULT_VOICE_PROFILE },
+    ];
+    for (const file of files) {
+        const filePath = resolve(datasDir, file.name);
+        if (!existsSync(filePath)) {
+            writeFileSync(filePath, JSON.stringify(file.content, null, 2) + '\n');
+            console.log(`   Created ${file.name}`);
+        }
+        else {
+            console.log(`   Skipped ${file.name} (already exists)`);
+        }
+    }
+}
+function loadJson(datasDir, file, defaultValue) {
+    const path = resolve(datasDir, file);
+    if (existsSync(path)) {
+        try {
+            return JSON.parse(readFileSync(path, 'utf-8'));
+        }
+        catch (e) {
+            console.warn(`   Warning: Failed to parse ${file}, using defaults`);
+            return defaultValue;
+        }
+    }
+    return defaultValue;
+}
+async function setupHandler(datasDir, hasDatas) {
+    const { handleChatRequest, initializeMetadata } = await import('./index.js');
+    // Show warnings for missing metadata
+    if (!hasDatas) {
+        console.log('\n   ⚠️  No datas/ directory found. AI chat will work with empty context.');
+        console.log('   Run "pnpm exec astro-ai-dev --init" to create placeholder files.\n');
+    }
+    else {
+        const hasSummaries = existsSync(resolve(datasDir, 'ai-summaries.json'));
+        const hasAuthor = existsSync(resolve(datasDir, 'author-context.json'));
+        if (!hasSummaries || !hasAuthor) {
+            console.log('\n   ⚠️  Some metadata files are missing. AI chat may have limited context.\n');
+        }
+    }
+    const summaries = loadJson(datasDir, 'ai-summaries.json', DEFAULT_SUMMARIES);
+    const authorContext = loadJson(datasDir, 'author-context.json', DEFAULT_AUTHOR_CONTEXT);
+    const voiceProfile = loadJson(datasDir, 'voice-profile.json', DEFAULT_VOICE_PROFILE);
+    const env = { ...process.env };
+    initializeMetadata({
+        summaries: summaries,
+        authorContext: authorContext,
+        voiceProfile: voiceProfile,
+        siteUrl: process.env.SITE_URL || 'http://localhost:4321',
+    }, env);
+    return { handleChatRequest, env };
+}
+function toWebRequest(req) {
+    return new Promise((resolve, reject) => {
+        const chunks = [];
+        req.on('data', (chunk) => chunks.push(chunk));
+        req.on('end', () => {
+            const body = Buffer.concat(chunks);
+            const url = `http://localhost${req.url || '/'}`;
+            resolve(new Request(url, {
+                method: req.method || 'GET',
+                headers: req.headers,
+                body: req.method !== 'GET' && req.method !== 'HEAD' ? body : undefined,
+            }));
+        });
+        req.on('error', reject);
+    });
+}
+async function sendWebResponse(webRes, res) {
+    res.writeHead(webRes.status, Object.fromEntries(webRes.headers));
+    if (!webRes.body) {
+        res.end();
+        return;
+    }
+    const reader = webRes.body.getReader();
+    try {
+        while (true) {
+            const { done, value } = await reader.read();
+            if (done)
+                break;
+            res.write(value);
+        }
+    }
+    finally {
+        res.end();
+    }
+}
+async function main() {
+    const args = process.argv.slice(2);
+    if (args.includes('--init') || args.includes('-i')) {
+        const { datasDir } = findBlogRoot();
+        console.log('\n📦 Initializing datas/ directory...\n');
+        console.log(`   Location: ${datasDir}\n`);
+        initDatasDirectory(datasDir);
+        console.log('\n✅ Done! You can now configure your AI metadata files.\n');
+        process.exit(0);
+    }
+    const port = parseInt(process.env.AI_DEV_PORT || '8787', 10);
+    const { root: blogRoot, datasDir, hasDatas } = findBlogRoot();
+    loadEnv(resolve(blogRoot, '.env'));
+    console.log('\n🤖 AI Dev Server starting...\n');
+    console.log(`   Working directory: ${blogRoot}`);
+    console.log(`   Datas directory: ${datasDir} ${hasDatas ? '✓' : '(not found)'}`);
+    console.log(`   Port: ${port}`);
+    console.log(`   AI_BASE_URL: ${process.env.AI_BASE_URL ? '✓ configured' : '✗ not set'}`);
+    console.log(`   AI_API_KEY: ${process.env.AI_API_KEY ? '✓ configured' : '✗ not set'}`);
+    console.log(`   AI_MODEL: ${process.env.AI_MODEL || '(default)'}`);
+    const { handleChatRequest, env } = await setupHandler(datasDir, hasDatas);
+    const server = createServer(async (req, res) => {
+        res.setHeader('Access-Control-Allow-Origin', '*');
+        res.setHeader('Access-Control-Allow-Methods', 'GET, POST, OPTIONS');
+        res.setHeader('Access-Control-Allow-Headers', 'Content-Type, x-session-id');
+        if (req.method === 'OPTIONS') {
+            res.writeHead(204);
+            res.end();
+            return;
+        }
+        const url = req.url || '/';
+        try {
+            if (url.startsWith('/api/chat')) {
+                const webReq = await toWebRequest(req);
+                const webRes = await handleChatRequest({ env: env, request: webReq });
+                await sendWebResponse(webRes, res);
+                return;
+            }
+            if (url.startsWith('/api/notify/comment')) {
+                const { createNotifier } = await import('@astro-minimax/notify');
+                const webReq = await toWebRequest(req);
+                const body = await webReq.json();
+                if (body.type !== 'new_comment' && body.type !== 'new_reply') {
+                    res.writeHead(400, { 'Content-Type': 'application/json' });
+                    res.end(JSON.stringify({ error: 'Unsupported event type' }));
+                    return;
+                }
+                const data = body.data || {};
+                const siteUrl = process.env.SITE_URL || 'http://localhost:4321';
+                const postUrl = data.url?.startsWith('http') ? data.url : `${siteUrl}${data.url || '/'}`;
+                const notifier = createNotifier({
+                    telegram: process.env.NOTIFY_TELEGRAM_BOT_TOKEN && process.env.NOTIFY_TELEGRAM_CHAT_ID ? {
+                        botToken: process.env.NOTIFY_TELEGRAM_BOT_TOKEN,
+                        chatId: process.env.NOTIFY_TELEGRAM_CHAT_ID,
+                    } : undefined,
+                    webhook: process.env.NOTIFY_WEBHOOK_URL ? {
+                        url: process.env.NOTIFY_WEBHOOK_URL,
+                    } : undefined,
+                    email: process.env.NOTIFY_RESEND_API_KEY && process.env.NOTIFY_RESEND_FROM && process.env.NOTIFY_RESEND_TO ? {
+                        provider: 'resend',
+                        apiKey: process.env.NOTIFY_RESEND_API_KEY,
+                        from: process.env.NOTIFY_RESEND_FROM,
+                        to: process.env.NOTIFY_RESEND_TO,
+                    } : undefined,
+                });
+                const result = await notifier.comment({
+                    author: data.nick || '匿名用户',
+                    content: data.comment || '',
+                    postTitle: extractPostTitle(data.url || '/'),
+                    postUrl,
+                });
+                console.log('[notify] Comment notification sent:', result.success ? '✓' : '✗', result.results);
+                res.writeHead(200, { 'Content-Type': 'application/json' });
+                res.end(JSON.stringify({
+                    success: result.success,
+                    event: 'comment',
+                    channels: result.results.map(r => ({ channel: r.channel, success: r.success, error: r.error })),
+                }));
+                return;
+            }
+            if (url.startsWith('/api/ai-info')) {
+                res.writeHead(200, { 'Content-Type': 'application/json' });
+                res.end(JSON.stringify({
+                    status: 'ok',
+                    mode: 'dev-server',
+                    datas: { found: hasDatas, path: datasDir },
+                    ai: {
+                        configured: !!(process.env.AI_BASE_URL && process.env.AI_API_KEY),
+                        model: process.env.AI_MODEL || 'unknown',
+                    },
+                }, null, 2));
+                return;
+            }
+            res.writeHead(404, { 'Content-Type': 'application/json' });
+            res.end(JSON.stringify({ error: 'Not found' }));
+        }
+        catch (err) {
+            console.error('[AI Dev Server] Error:', err);
+            res.writeHead(500, { 'Content-Type': 'application/json' });
+            res.end(JSON.stringify({ error: 'Internal server error', detail: err instanceof Error ? err.message : String(err) }));
+        }
+    });
+    server.listen(port, () => {
+        console.log(`\n✅ AI Dev Server running at http://localhost:${port}`);
+        console.log(`   POST http://localhost:${port}/api/chat`);
+        console.log(`   GET  http://localhost:${port}/api/ai-info`);
+        console.log(`\n   Tip: Run "pnpm exec astro-ai-dev --init" to create datas/ directory.\n`);
+    });
+    // Graceful shutdown on SIGINT (Ctrl+C) and SIGTERM
+    const shutdown = (signal) => {
+        console.log(`\n🛑 AI Dev Server received ${signal}, shutting down...`);
+        server.close(() => {
+            console.log('✅ AI Dev Server closed');
+            process.exit(0);
+        });
+        // Force exit after 3 seconds if connections are pending
+        setTimeout(() => {
+            console.log('⚠️  Force closing after timeout');
+            process.exit(1);
+        }, 3000);
+    };
+    process.on('SIGINT', () => shutdown('SIGINT'));
+    process.on('SIGTERM', () => shutdown('SIGTERM'));
+}
+main().catch((err) => {
+    console.error('\n❌ Failed to start AI Dev Server:', err);
+    process.exit(1);
+});

package/dist/server/errors.d.ts

@@ -0,0 +1,17 @@
+export declare function chatError(code: string, error: string, status: number, options?: {
+    retryable?: boolean;
+    retryAfter?: number;
+}): Response;
+export declare const errors: {
+    methodNotAllowed: (lang?: string) => Response;
+    invalidRequest: (detail?: string, lang?: string) => Response;
+    emptyMessage: (lang?: string) => Response;
+    emptyContent: (lang?: string) => Response;
+    inputTooLong: (max: number, lang?: string) => Response;
+    rateLimited: (retryAfter?: number, lang?: string) => Response;
+    timeout: (lang?: string) => Response;
+    providerUnavailable: (lang?: string) => Response;
+    internal: (detail?: string, lang?: string) => Response;
+};
+export declare function corsPreflightResponse(): Response;
+//# sourceMappingURL=errors.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"errors.d.ts","sourceRoot":"","sources":["../../src/server/errors.ts"],"names":[],"mappings":"AAQA,wBAAgB,SAAS,CACvB,IAAI,EAAE,MAAM,EACZ,KAAK,EAAE,MAAM,EACb,MAAM,EAAE,MAAM,EACd,OAAO,CAAC,EAAE;IAAE,SAAS,CAAC,EAAE,OAAO,CAAC;IAAC,UAAU,CAAC,EAAE,MAAM,CAAA;CAAE,GACrD,QAAQ,CAYV;AAMD,eAAO,MAAM,MAAM;8BACS,MAAM;8BAEN,MAAM,SAAS,MAAM;0BAEzB,MAAM;0BAEN,MAAM;wBAER,MAAM,SAAS,MAAM;+BAEd,MAAM,SAAS,MAAM;qBAE/B,MAAM;iCAEM,MAAM;wBAEf,MAAM,SAAS,MAAM;CAE1C,CAAC;AAEF,wBAAgB,qBAAqB,IAAI,QAAQ,CAQhD"}

package/dist/server/errors.js

@@ -0,0 +1,41 @@
+import { t } from '../utils/i18n.js';
+const CORS_HEADERS = {
+    'Content-Type': 'application/json',
+    'Access-Control-Allow-Origin': '*',
+};
+export function chatError(code, error, status, options) {
+    const body = {
+        error,
+        code,
+        retryable: options?.retryable ?? false,
+        retryAfter: options?.retryAfter,
+    };
+    const headers = { ...CORS_HEADERS };
+    if (options?.retryAfter) {
+        headers['Retry-After'] = String(options.retryAfter);
+    }
+    return new Response(JSON.stringify(body), { status, headers });
+}
+function te(key, lang, vars) {
+    return t(key, lang ?? 'zh', vars);
+}
+export const errors = {
+    methodNotAllowed: (lang) => chatError('METHOD_NOT_ALLOWED', lang === 'en' ? 'Method not allowed' : '方法不允许', 405),
+    invalidRequest: (detail, lang) => chatError('INVALID_REQUEST', detail ?? te('ai.error.format', lang), 400),
+    emptyMessage: (lang) => chatError('INVALID_REQUEST', te('ai.error.emptyMessage', lang), 400),
+    emptyContent: (lang) => chatError('INVALID_REQUEST', te('ai.error.emptyContent', lang), 400),
+    inputTooLong: (max, lang) => chatError('INPUT_TOO_LONG', te('ai.error.inputTooLong', lang, { max }), 400),
+    rateLimited: (retryAfter, lang) => chatError('RATE_LIMITED', te('ai.error.rateLimit', lang), 429, { retryable: true, retryAfter: retryAfter ?? 10 }),
+    timeout: (lang) => chatError('TIMEOUT', te('ai.error.timeout', lang), 504, { retryable: true }),
+    providerUnavailable: (lang) => chatError('PROVIDER_UNAVAILABLE', te('ai.error.unavailable', lang), 503, { retryable: true, retryAfter: 30 }),
+    internal: (detail, lang) => chatError('INTERNAL_ERROR', detail ?? te('ai.error.generic', lang), 500, { retryable: true, retryAfter: 5 }),
+};
+export function corsPreflightResponse() {
+    return new Response(null, {
+        headers: {
+            'Access-Control-Allow-Origin': '*',
+            'Access-Control-Allow-Methods': 'POST, OPTIONS',
+            'Access-Control-Allow-Headers': 'Content-Type, x-session-id',
+        },
+    });
+}

package/dist/server/index.d.ts

@@ -0,0 +1,8 @@
+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 type { ChatNotifyOptions } from './notify.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

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

package/dist/server/index.js

@@ -0,0 +1,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 { createChatStatusData, isChatStatusData, } from './types.js';

package/dist/server/metadata-init.d.ts

@@ -0,0 +1,11 @@
+import type { MetadataConfig, ChatHandlerEnv } from './types.js';
+/**
+ * Initializes AI metadata: loads summaries, author context, voice profile,
+ * and builds search indices. Safe to call multiple times (idempotent).
+ */
+export declare function initializeMetadata(config: MetadataConfig, env?: ChatHandlerEnv): void;
+/**
+ * Resets initialization state (for testing).
+ */
+export declare function resetMetadataInit(): void;
+//# sourceMappingURL=metadata-init.d.ts.map

package/dist/server/metadata-init.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"metadata-init.d.ts","sourceRoot":"","sources":["../../src/server/metadata-init.ts"],"names":[],"mappings":"AASA,OAAO,KAAK,EAAE,cAAc,EAAE,cAAc,EAAE,MAAM,YAAY,CAAC;AAIjE;;;GAGG;AACH,wBAAgB,kBAAkB,CAAC,MAAM,EAAE,cAAc,EAAE,GAAG,CAAC,EAAE,cAAc,GAAG,IAAI,CAoCrF;AAED;;GAEG;AACH,wBAAgB,iBAAiB,IAAI,IAAI,CAExC"}

package/dist/server/metadata-init.js

@@ -0,0 +1,45 @@
+import { preloadMetadata, getAuthorContext, getAllSummaries, initArticleIndex, initProjectIndex, } from '../index.js';
+let initialized = false;
+/**
+ * Initializes AI metadata: loads summaries, author context, voice profile,
+ * and builds search indices. Safe to call multiple times (idempotent).
+ */
+export function initializeMetadata(config, env) {
+    if (initialized)
+        return;
+    initialized = true;
+    preloadMetadata({
+        summaries: config.summaries,
+        authorContext: config.authorContext,
+        voiceProfile: config.voiceProfile,
+    });
+    const authorCtx = getAuthorContext();
+    const allSummaries = getAllSummaries();
+    const summaryMap = new Map(allSummaries.map(s => [s.slug, s]));
+    const siteUrl = config.siteUrl ?? env?.SITE_URL ?? '';
+    const articleDocs = (authorCtx?.posts ?? []).map((post) => {
+        const summary = summaryMap.get(post.id);
+        const baseUrl = post.url?.startsWith('http') ? '' : siteUrl;
+        return {
+            id: post.id,
+            title: post.title,
+            url: post.url ? `${baseUrl}${post.url}` : `${siteUrl}/${post.id}`,
+            excerpt: post.summary || summary?.summary || '',
+            content: [...(post.keyPoints ?? []), ...(summary?.keyPoints ?? [])].join(' '),
+            categories: [post.category].filter(Boolean),
+            tags: post.tags ?? [],
+            keyPoints: [...(post.keyPoints ?? []), ...(summary?.keyPoints ?? [])],
+            dateTime: post.date ? new Date(post.date).getTime() : 0,
+            lang: post.lang,
+            summary: summary?.summary,
+        };
+    });
+    initArticleIndex(articleDocs);
+    initProjectIndex([]);
+}
+/**
+ * Resets initialization state (for testing).
+ */
+export function resetMetadataInit() {
+    initialized = false;
+}

package/dist/server/notify.d.ts

@@ -0,0 +1,25 @@
+import { type NotifyResult, type ArticleRef, type ModelInfo, type TokenUsage, type PhaseTiming } from '@astro-minimax/notify';
+import type { UIMessage } from 'ai';
+interface NotifyEnv {
+    NOTIFY_TELEGRAM_BOT_TOKEN?: string;
+    NOTIFY_TELEGRAM_CHAT_ID?: string;
+    NOTIFY_WEBHOOK_URL?: string;
+    NOTIFY_RESEND_API_KEY?: string;
+    NOTIFY_RESEND_FROM?: string;
+    NOTIFY_RESEND_TO?: string;
+    SITE_URL?: string;
+    [key: string]: unknown;
+}
+export interface ChatNotifyOptions {
+    env: NotifyEnv;
+    sessionId: string;
+    messages: UIMessage[];
+    aiResponse?: string;
+    referencedArticles?: ArticleRef[];
+    model?: ModelInfo;
+    usage?: TokenUsage;
+    timing?: PhaseTiming;
+}
+export declare function notifyAiChat(options: ChatNotifyOptions): Promise<NotifyResult | null>;
+export {};
+//# sourceMappingURL=notify.d.ts.map

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

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

package/dist/server/notify.js

@@ -0,0 +1,62 @@
+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)
+        return null;
+    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) {
+        return Promise.resolve(null);
+    }
+    const userMessages = messages.filter(m => m.role === 'user');
+    const lastUserMessage = userMessages[userMessages.length - 1];
+    if (!lastUserMessage) {
+        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/types.d.ts

@@ -0,0 +1,56 @@
+import type { UIMessage } from 'ai';
+import type { ProviderManagerEnv } from '../provider-manager/types.js';
+import type { CacheEnv } from '../cache/types.js';
+export interface ChatContext {
+    scope: 'global' | 'article';
+    article?: ArticleChatContext;
+}
+export interface ArticleChatContext {
+    slug: string;
+    title: string;
+    categories?: string[];
+    summary?: string;
+    abstract?: string;
+    keyPoints?: string[];
+    relatedSlugs?: string[];
+}
+export interface ChatRequestBody {
+    context?: ChatContext;
+    id?: string;
+    messages: UIMessage[];
+    lang?: string;
+}
+export interface ChatHandlerEnv extends ProviderManagerEnv, CacheEnv {
+    SITE_AUTHOR?: string;
+    SITE_URL?: string;
+    [key: string]: unknown;
+}
+export interface ChatHandlerOptions {
+    env: ChatHandlerEnv;
+    request: Request;
+}
+export type ChatStatusStage = 'search' | 'answer' | 'complete';
+export interface ChatStatusData {
+    stage: ChatStatusStage;
+    message: string;
+    progress: number;
+    done: boolean;
+    at: number;
+}
+export declare function createChatStatusData(partial: Omit<ChatStatusData, 'done' | 'at'> & {
+    done?: boolean;
+}): ChatStatusData;
+export declare function isChatStatusData(value: unknown): value is ChatStatusData;
+export interface ChatErrorResponse {
+    error: string;
+    code: string;
+    retryable: boolean;
+    retryAfter?: number;
+}
+export interface MetadataConfig {
+    summaries: unknown;
+    authorContext: unknown;
+    voiceProfile: unknown;
+    siteUrl?: string;
+}
+//# sourceMappingURL=types.d.ts.map

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

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

package/dist/server/types.js

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

@@ -0,0 +1,3 @@
+export { streamMockResponse } from './mock-stream.js';
+export { STREAM_HEADERS, JSON_HEADERS, errorResponse } from './response.js';
+//# sourceMappingURL=index.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/stream/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,kBAAkB,EAAE,MAAM,kBAAkB,CAAC;AACtD,OAAO,EAAE,cAAc,EAAE,YAAY,EAAE,aAAa,EAAE,MAAM,eAAe,CAAC"}

package/dist/stream/index.js

@@ -0,0 +1,2 @@
+export { streamMockResponse } from './mock-stream.js';
+export { STREAM_HEADERS, JSON_HEADERS, errorResponse } from './response.js';

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

@@ -0,0 +1,12 @@
+export interface MockStreamOptions {
+    question: string;
+    lang?: string;
+    /** Delay range per character chunk in ms [min, max] */
+    delayRange?: [number, number];
+}
+/**
+ * Streams a mock response character-by-character as a ReadableStream<string>.
+ * Simulates natural typing speed with variable delays.
+ */
+export declare function streamMockResponse(options: MockStreamOptions): ReadableStream<string>;
+//# sourceMappingURL=mock-stream.d.ts.map