@astro-minimax/ai 0.7.4 → 0.8.0

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@astro-minimax/ai",
-  "version": "0.7.4",
+  "version": "0.8.0",
   "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",
@@ -69,25 +69,29 @@
       "types": "./dist/server/index.d.ts",
       "import": "./dist/server/index.js"
     },
-    "./components/*": "./src/components/*",
+    "./components/ChatPanel": {
+      "types": "./dist/components/ChatPanel.d.ts",
+      "import": "./dist/components/ChatPanel.js"
+    },
+    "./components/AIChatContainer": {
+      "types": "./dist/components/AIChatContainer.d.ts",
+      "import": "./dist/components/AIChatContainer.js"
+    },
+    "./components/AIChatWidget.astro": "./dist/components/AIChatWidget.astro",
     "./styles/source.css": "./src/styles/source.css",
     "./package.json": "./package.json"
   },
   "files": [
     "dist/",
-    "src/components/",
-    "src/providers/mock.ts",
-    "src/server/types.ts",
-    "src/utils/i18n.ts",
     "src/styles/",
     "README.md"
   ],
   "sideEffects": false,
   "dependencies": {
     "@ai-sdk/openai-compatible": "^2.0.35",
+    "@astro-minimax/notify": "^0.7.5",
     "ai": "^6.0.116",
-    "workers-ai-provider": "^3.1.2",
-    "@astro-minimax/notify": "0.7.4"
+    "workers-ai-provider": "^3.1.2"
   },
   "optionalDependencies": {
     "undici": "^6.0.0"
@@ -108,6 +112,7 @@
   "devDependencies": {
     "@cloudflare/workers-types": "^4.0.0",
     "@types/node": "^22.0.0",
+    "esbuild": "^0.25.0",
     "typescript": "^5.9.3"
   },
   "engines": {
@@ -115,8 +120,9 @@
     "pnpm": ">=9.0.0"
   },
   "scripts": {
-    "build": "tsc -p tsconfig.build.json && chmod +x dist/server/dev-server.js",
-    "build:watch": "tsc -p tsconfig.build.json --watch",
+    "build": "node scripts/build.mjs",
+    "build:watch": "node scripts/build.mjs --watch",
+    "build:components": "node scripts/build-components.mjs",
     "typecheck": "tsc --noEmit",
     "clean": "rm -rf dist"
   }

package/dist/cache/global-cache.js

@@ -1,141 +0,0 @@
-export const PUBLIC_QUESTION_PATTERNS = [
-    {
-        type: 'tech',
-        keywords: ['技术栈', '技术', '框架', '用了什么', 'built with', 'tech stack', 'framework'],
-        patterns: [
-            /这个博客用了什么/,
-            /博客.*技术栈/,
-            /用了什么技术/,
-            /what.*tech.*stack/,
-            /built with/,
-            /用什么框架/,
-        ],
-        ttl: 86400,
-        needsContext: false,
-    },
-    {
-        type: 'recommend',
-        keywords: ['推荐', '文章推荐', '好文', 'recommend', 'suggest'],
-        patterns: [
-            /推荐.*文章/,
-            /有哪些推荐/,
-            /文章推荐/,
-            /recommend.*article/,
-            /any.*recommend/,
-        ],
-        ttl: 1800,
-        needsContext: false,
-    },
-    {
-        type: 'build',
-        keywords: ['搭建', '部署', '怎么建', 'how to build', 'deploy', 'setup'],
-        patterns: [
-            /怎么搭建/,
-            /如何搭建/,
-            /怎么部署/,
-            /how to build/,
-            /how to deploy/,
-            /搭建.*博客/,
-        ],
-        ttl: 86400,
-        needsContext: false,
-    },
-    {
-        type: 'summary',
-        keywords: ['总结', '概括', '摘要', 'summarize', 'summary', 'tl;dr'],
-        patterns: [
-            /总结(一下|这篇文章)/,
-            /概括(一下|这篇文章)/,
-            /文章摘要/,
-            /summarize/,
-            /summary/,
-            /主要讲了什么/,
-        ],
-        ttl: 14400,
-        needsContext: true,
-    },
-    {
-        type: 'author',
-        keywords: ['作者', '博主', '谁', 'author', 'who'],
-        patterns: [
-            /作者是谁/,
-            /博主是谁/,
-            /关于作者/,
-            /who.*author/,
-            /about author/,
-        ],
-        ttl: 86400,
-        needsContext: false,
-    },
-    {
-        type: 'about',
-        keywords: ['关于', '介绍', 'about', 'intro'],
-        patterns: [
-            /关于.*博客/,
-            /博客介绍/,
-            /about.*blog/,
-            /介绍一下/,
-        ],
-        ttl: 86400,
-        needsContext: false,
-    },
-];
-export function detectPublicQuestion(query) {
-    const normalized = normalizeQuery(query);
-    let bestMatch = null;
-    let bestScore = 0;
-    for (const pattern of PUBLIC_QUESTION_PATTERNS) {
-        let score = 0;
-        for (const keyword of pattern.keywords) {
-            if (normalized.includes(keyword.toLowerCase())) {
-                score += 1;
-            }
-        }
-        for (const regex of pattern.patterns) {
-            if (regex.test(normalized)) {
-                score += 3;
-            }
-        }
-        if (score > bestScore && score >= 2) {
-            bestScore = score;
-            const confidence = Math.min(score / 5, 1);
-            bestMatch = {
-                type: pattern.type,
-                confidence,
-                ttl: pattern.ttl,
-                needsContext: pattern.needsContext,
-            };
-        }
-    }
-    return bestMatch;
-}
-export function buildGlobalCacheKey(type, context) {
-    const parts = ['global', type];
-    if (context?.articleSlug) {
-        parts.push(context.articleSlug);
-    }
-    if (context?.lang) {
-        parts.push(context.lang);
-    }
-    return parts.join(':');
-}
-function normalizeQuery(query) {
-    return query
-        .toLowerCase()
-        .replace(/[？?!！。，,.]/g, '')
-        .replace(/\s+/g, ' ')
-        .trim();
-}
-export async function getGlobalSearchCache(cache, type, context) {
-    const key = buildGlobalCacheKey(type, context);
-    const entry = await cache.get(key);
-    return entry?.value ?? null;
-}
-export async function setGlobalSearchCache(cache, type, data, ttl, context) {
-    const key = buildGlobalCacheKey(type, context);
-    await cache.set(key, data, { ttl });
-}
-export function getGlobalCacheTTL(type) {
-    const pattern = PUBLIC_QUESTION_PATTERNS.find(p => p.type === type);
-    return pattern?.ttl ?? 3600;
-}

package/dist/cache/index.js

@@ -1,62 +0,0 @@
-export { MemoryCacheAdapter, } from './memory-adapter.js';
-export { KVCacheAdapter, } from './kv-adapter.js';
-export { createCacheKeyBuilder, } from './types.js';
-export { detectPublicQuestion, buildGlobalCacheKey, getGlobalSearchCache, setGlobalSearchCache, getGlobalCacheTTL, PUBLIC_QUESTION_PATTERNS, } from './global-cache.js';
-export { getResponseCache, setResponseCache, deleteResponseCache, getResponseCacheConfig, buildResponseCacheKey, createResponsePlaybackGenerator, DEFAULT_RESPONSE_CACHE_CONFIG, } from './response-cache.js';
-import { MemoryCacheAdapter } from './memory-adapter.js';
-import { KVCacheAdapter } from './kv-adapter.js';
-const DEFAULT_TTL = 600;
-const DEFAULT_MAX_ENTRIES = 400;
-let globalMemoryCache = null;
-function getGlobalMemoryCache(ttl, maxEntries) {
-    if (!globalMemoryCache) {
-        globalMemoryCache = new MemoryCacheAdapter({ defaultTtl: ttl, maxEntries });
-    }
-    return globalMemoryCache;
-}
-export function createCacheAdapter(env, config) {
-    const ttl = config?.defaultTtl ?? parseTtl(env.CACHE_TTL) ?? DEFAULT_TTL;
-    const maxEntries = config?.maxEntries ?? DEFAULT_MAX_ENTRIES;
-    if (isCacheDisabled(env)) {
-        return getGlobalMemoryCache(ttl, maxEntries);
-    }
-    const kvBinding = getKVBinding(env);
-    if (kvBinding) {
-        return new KVCacheAdapter(kvBinding, { defaultTtl: ttl });
-    }
-    return getGlobalMemoryCache(ttl, maxEntries);
-}
-function isCacheDisabled(env) {
-    const val = env.CACHE_DISABLED;
-    if (val === true || val === 'true' || val === '1') {
-        return true;
-    }
-    return false;
-}
-function getKVBinding(env) {
-    const customBinding = env.CACHE_KV_BINDING;
-    if (customBinding && typeof customBinding === 'string') {
-        const binding = env[customBinding];
-        return isKVNamespace(binding) ? binding : null;
-    }
-    if (env.CACHE_KV && isKVNamespace(env.CACHE_KV)) {
-        return env.CACHE_KV;
-    }
-    const defaultBinding = env['CACHE_KV'];
-    return isKVNamespace(defaultBinding) ? defaultBinding : null;
-}
-function isKVNamespace(value) {
-    return (typeof value === 'object' &&
-        value !== null &&
-        'get' in value &&
-        'put' in value &&
-        'delete' in value);
-}
-function parseTtl(value) {
-    if (value === undefined)
-        return undefined;
-    if (typeof value === 'number')
-        return value;
-    const parsed = parseInt(value, 10);
-    return isNaN(parsed) ? undefined : parsed;
-}

package/dist/cache/kv-adapter.js

@@ -1,102 +0,0 @@
-const DEFAULT_TTL_SECONDS = 600;
-const MIN_TTL_SECONDS = 60;
-export class KVCacheAdapter {
-    name = 'cloudflare-kv';
-    kv;
-    defaultTtl;
-    prefix;
-    constructor(kv, options) {
-        this.kv = kv;
-        this.defaultTtl = options?.defaultTtl ?? DEFAULT_TTL_SECONDS;
-        this.prefix = options?.prefix ?? '';
-    }
-    buildKey(key) {
-        return this.prefix ? `${this.prefix}:${key}` : key;
-    }
-    async get(key, options) {
-        try {
-            const fullKey = this.buildKey(key);
-            const result = await this.kv.getWithMetadata(fullKey, 'json');
-            if (!result.value) {
-                return null;
-            }
-            const storedEntry = result.value;
-            if (!storedEntry.value || !storedEntry.metadata) {
-                return null;
-            }
-            return {
-                value: storedEntry.value,
-                metadata: storedEntry.metadata,
-            };
-        }
-        catch (error) {
-            if (!options?.silent) {
-                console.error('[KVCacheAdapter] Get error:', error);
-            }
-            return null;
-        }
-    }
-    async set(key, value, options) {
-        try {
-            const now = Date.now();
-            const ttl = options?.ttl ?? this.defaultTtl;
-            const entry = {
-                value,
-                metadata: {
-                    createdAt: now,
-                    updatedAt: now,
-                    custom: options?.metadata,
-                },
-            };
-            const fullKey = this.buildKey(key);
-            const effectiveTtl = Math.max(ttl, MIN_TTL_SECONDS);
-            await this.kv.put(fullKey, JSON.stringify(entry), {
-                expirationTtl: effectiveTtl,
-            });
-        }
-        catch (error) {
-            console.error('[KVCacheAdapter] Set error:', error);
-            throw error;
-        }
-    }
-    async delete(key) {
-        try {
-            const fullKey = this.buildKey(key);
-            const existing = await this.kv.get(fullKey);
-            if (existing === null) {
-                return false;
-            }
-            await this.kv.delete(fullKey);
-            return true;
-        }
-        catch (error) {
-            console.error('[KVCacheAdapter] Delete error:', error);
-            return false;
-        }
-    }
-    async clear() {
-        console.warn('[KVCacheAdapter] Clear not supported for KV namespace');
-    }
-    async has(key) {
-        try {
-            const fullKey = this.buildKey(key);
-            const value = await this.kv.get(fullKey);
-            return value !== null;
-        }
-        catch {
-            return false;
-        }
-    }
-    async isAvailable() {
-        try {
-            await this.kv.get('__health_check__');
-            return true;
-        }
-        catch {
-            return false;
-        }
-    }
-    dispose() {
-        // KV adapter doesn't hold any resources that need cleanup
-    }
-}

package/dist/cache/memory-adapter.js

@@ -1,95 +0,0 @@
-const DEFAULT_MAX_ENTRIES = 400;
-const DEFAULT_TTL_SECONDS = 600;
-export class MemoryCacheAdapter {
-    name = 'memory';
-    cache = new Map();
-    maxEntries;
-    defaultTtl;
-    cleanupTimer;
-    constructor(options) {
-        this.maxEntries = options?.maxEntries ?? DEFAULT_MAX_ENTRIES;
-        this.defaultTtl = options?.defaultTtl ?? DEFAULT_TTL_SECONDS;
-        if (options?.cleanupInterval) {
-            this.cleanupTimer = setInterval(() => this.cleanup(), options.cleanupInterval * 1000);
-        }
-    }
-    async get(key, _options) {
-        const entry = this.cache.get(key);
-        if (!entry)
-            return null;
-        if (entry.expiresAt && Date.now() > entry.expiresAt) {
-            this.cache.delete(key);
-            return null;
-        }
-        this.cache.delete(key);
-        this.cache.set(key, entry);
-        return {
-            value: entry.value,
-            metadata: entry.metadata,
-        };
-    }
-    async set(key, value, options) {
-        const now = Date.now();
-        const ttl = options?.ttl ?? this.defaultTtl;
-        const entry = {
-            value,
-            metadata: {
-                createdAt: now,
-                updatedAt: now,
-                custom: options?.metadata,
-            },
-            expiresAt: ttl ? now + ttl * 1000 : undefined,
-        };
-        this.cache.delete(key);
-        this.cache.set(key, entry);
-        if (this.cache.size > this.maxEntries) {
-            this.evictLRU();
-        }
-    }
-    async delete(key) {
-        return this.cache.delete(key);
-    }
-    async clear() {
-        this.cache.clear();
-    }
-    async has(key) {
-        const entry = this.cache.get(key);
-        if (!entry)
-            return false;
-        if (entry.expiresAt && Date.now() > entry.expiresAt) {
-            this.cache.delete(key);
-            return false;
-        }
-        return true;
-    }
-    async isAvailable() {
-        return true;
-    }
-    cleanup() {
-        const now = Date.now();
-        for (const [key, entry] of this.cache) {
-            if (entry.expiresAt && now > entry.expiresAt) {
-                this.cache.delete(key);
-            }
-        }
-    }
-    evictLRU() {
-        const overflow = this.cache.size - this.maxEntries;
-        if (overflow <= 0)
-            return;
-        const keys = this.cache.keys();
-        for (let i = 0; i < overflow; i++) {
-            const next = keys.next();
-            if (next.done)
-                break;
-            this.cache.delete(next.value);
-        }
-    }
-    dispose() {
-        if (this.cleanupTimer) {
-            clearInterval(this.cleanupTimer);
-            this.cleanupTimer = undefined;
-        }
-        this.cache.clear();
-    }
-}

package/dist/cache/response-cache.js

@@ -1,85 +0,0 @@
-export const DEFAULT_RESPONSE_CACHE_CONFIG = {
-    enabled: false,
-    defaultTtl: 3600,
-    playbackDelayMs: 20,
-    chunkSize: 15,
-    thinkingPlaybackDelayMs: 5,
-};
-export function getResponseCacheConfig(env) {
-    const parseBool = (val) => {
-        if (val === undefined)
-            return false;
-        if (typeof val === 'boolean')
-            return val;
-        if (typeof val === 'string')
-            return val === 'true' || val === '1';
-        return false;
-    };
-    const parseNum = (val, defaultVal) => {
-        if (val === undefined)
-            return defaultVal;
-        if (typeof val === 'number')
-            return val;
-        if (typeof val === 'string') {
-            const num = parseInt(val, 10);
-            return isNaN(num) ? defaultVal : num;
-        }
-        return defaultVal;
-    };
-    return {
-        enabled: parseBool(env.AI_RESPONSE_CACHE_ENABLED),
-        defaultTtl: parseNum(env.AI_RESPONSE_CACHE_TTL, 3600),
-        playbackDelayMs: parseNum(env.AI_RESPONSE_CACHE_PLAYBACK_DELAY, 20),
-        chunkSize: parseNum(env.AI_RESPONSE_CACHE_CHUNK_SIZE, 15),
-        thinkingPlaybackDelayMs: parseNum(env.AI_RESPONSE_CACHE_THINKING_DELAY, 5),
-    };
-}
-const RESPONSE_CACHE_PREFIX = 'response';
-export function buildResponseCacheKey(type, context) {
-    const parts = [RESPONSE_CACHE_PREFIX, type];
-    if (context?.articleSlug)
-        parts.push(context.articleSlug);
-    if (context?.lang)
-        parts.push(context.lang);
-    return parts.join(':');
-}
-export async function getResponseCache(cache, type, context) {
-    const key = buildResponseCacheKey(type, context);
-    const entry = await cache.get(key);
-    return entry?.value ?? null;
-}
-export async function setResponseCache(cache, type, data, ttl, context) {
-    const key = buildResponseCacheKey(type, context);
-    await cache.set(key, data, { ttl });
-}
-export async function deleteResponseCache(cache, type, context) {
-    const key = buildResponseCacheKey(type, context);
-    return cache.delete(key);
-}
-export function createResponsePlaybackGenerator(cached, config) {
-    const { playbackDelayMs, chunkSize, thinkingPlaybackDelayMs } = config;
-    return (async function* () {
-        if (cached.thinking) {
-            const thinkingChunks = Math.ceil(cached.thinking.length / chunkSize);
-            for (let i = 0; i < thinkingChunks; i++) {
-                const chunk = cached.thinking.slice(i * chunkSize, (i + 1) * chunkSize);
-                if (chunk) {
-                    yield { type: 'thinking', text: chunk };
-                    if (i < thinkingChunks - 1 && thinkingPlaybackDelayMs > 0) {
-                        await new Promise(resolve => setTimeout(resolve, thinkingPlaybackDelayMs));
-                    }
-                }
-            }
-        }
-        const responseChunks = Math.ceil(cached.response.length / chunkSize);
-        for (let i = 0; i < responseChunks; i++) {
-            const chunk = cached.response.slice(i * chunkSize, (i + 1) * chunkSize);
-            if (chunk) {
-                yield { type: 'response', text: chunk };
-                if (i < responseChunks - 1 && playbackDelayMs > 0) {
-                    await new Promise(resolve => setTimeout(resolve, playbackDelayMs));
-                }
-            }
-        }
-    })();
-}

package/dist/cache/types.js

@@ -1,16 +0,0 @@
-/**
- * @astro-minimax/ai
- *
- * Cache abstraction layer for AI conversation system.
- * Supports multiple storage backends (memory, Cloudflare KV).
- *
- * @module cache/types
- */
-/**
- * Default cache key builder implementation.
- */
-export const createCacheKeyBuilder = (prefix = 'chat') => ({
-    session: (sessionId) => `${prefix}:sid:${sessionId}`,
-    article: (sessionId, slug) => `${prefix}:sid:${sessionId}:article:${slug}`,
-    custom: (...parts) => `${prefix}:${parts.join(':')}`,
-});

package/dist/data/metadata-loader.js

@@ -1,66 +0,0 @@
-import { loadFactRegistry as loadFactRegistryCache } from '../fact-registry/registry.js';
-import { loadVectorIndex as loadVectorIndexCache } from '../search/vector-reranker.js';
-// Lazy-loaded, memory-cached metadata
-let cachedMetadata = null;
-/**
- * Pre-loads metadata synchronously from imported JSON objects.
- * Use this at function initialization time in edge environments.
- *
- * Example (in functions/lib/ai.ts):
- *   import summaries from '../../datas/ai-summaries.json' with { type: 'json' };
- *   preloadMetadata({ summaries, authorContext, voiceProfile, factRegistry });
- */
-export function preloadMetadata(data) {
-    cachedMetadata = {
-        summaries: data.summaries ?? null,
-        authorContext: data.authorContext ?? null,
-        voiceProfile: data.voiceProfile ?? null,
-        factRegistry: data.factRegistry ?? null,
-        vectorIndex: data.vectorIndex ?? null,
-    };
-    if (cachedMetadata.factRegistry) {
-        loadFactRegistryCache(cachedMetadata.factRegistry);
-    }
-    if (cachedMetadata.vectorIndex) {
-        loadVectorIndexCache(cachedMetadata.vectorIndex);
-    }
-}
-/**
- * Clears the metadata cache and all associated sub-caches (useful for testing).
- */
-export function clearMetadataCache() {
-    cachedMetadata = null;
-    loadFactRegistryCache(null);
-    loadVectorIndexCache(null);
-}
-/**
- * Returns the cached metadata. Must call preloadMetadata() first.
- */
-export function getMetadata() {
-    return cachedMetadata ?? { summaries: null, authorContext: null, voiceProfile: null, factRegistry: null, vectorIndex: null };
-}
-/**
- * Returns the AI-generated summary for an article by its slug.
- */
-export function getArticleSummary(slug) {
-    return cachedMetadata?.summaries?.articles[slug]?.data;
-}
-/**
- * Returns all article summaries as a flat array.
- */
-export function getAllSummaries() {
-    const articles = cachedMetadata?.summaries?.articles ?? {};
-    return Object.entries(articles).map(([slug, entry]) => ({ slug, ...entry.data }));
-}
-/**
- * Returns the author context (name, site URL, recent posts list).
- */
-export function getAuthorContext() {
-    return cachedMetadata?.authorContext ?? null;
-}
-/**
- * Returns the author's voice/style profile.
- */
-export function getVoiceProfile() {
-    return cachedMetadata?.voiceProfile ?? null;
-}

package/dist/data/types.js

@@ -1 +0,0 @@
-export {};