@astro-minimax/ai 0.2.0

package/dist/cache/memory-adapter.js

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

@@ -0,0 +1,45 @@
+import type { CacheAdapter } from './types.js';
+import type { ArticleContext, ProjectContext } from '../search/types.js';
+import type { PublicQuestionType } from './global-cache.js';
+export interface CachedAIResponse {
+    query: string;
+    thinking?: string;
+    response: string;
+    articles: ArticleContext[];
+    projects: ProjectContext[];
+    lang: string;
+    model?: string;
+    updatedAt: number;
+}
+export interface ResponseCacheConfig {
+    enabled: boolean;
+    defaultTtl: number;
+    playbackDelayMs: number;
+    chunkSize: number;
+    thinkingPlaybackDelayMs: number;
+}
+export declare const DEFAULT_RESPONSE_CACHE_CONFIG: ResponseCacheConfig;
+export type ResponseCacheEnv = Record<string, unknown>;
+export declare function getResponseCacheConfig(env: Record<string, unknown>): ResponseCacheConfig;
+export declare function buildResponseCacheKey(type: PublicQuestionType, context?: {
+    articleSlug?: string;
+    lang?: string;
+}): string;
+export declare function getResponseCache(cache: CacheAdapter, type: PublicQuestionType, context?: {
+    articleSlug?: string;
+    lang?: string;
+}): Promise<CachedAIResponse | null>;
+export declare function setResponseCache(cache: CacheAdapter, type: PublicQuestionType, data: CachedAIResponse, ttl: number, context?: {
+    articleSlug?: string;
+    lang?: string;
+}): Promise<void>;
+export declare function deleteResponseCache(cache: CacheAdapter, type: PublicQuestionType, context?: {
+    articleSlug?: string;
+    lang?: string;
+}): Promise<boolean>;
+export interface PlaybackChunk {
+    type: 'thinking' | 'response';
+    text: string;
+}
+export declare function createResponsePlaybackGenerator(cached: CachedAIResponse, config: Pick<ResponseCacheConfig, 'playbackDelayMs' | 'chunkSize' | 'thinkingPlaybackDelayMs'>): AsyncGenerator<PlaybackChunk, void, unknown>;
+//# sourceMappingURL=response-cache.d.ts.map

package/dist/cache/response-cache.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"response-cache.d.ts","sourceRoot":"","sources":["../../src/cache/response-cache.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,YAAY,CAAC;AAC/C,OAAO,KAAK,EAAE,cAAc,EAAE,cAAc,EAAE,MAAM,oBAAoB,CAAC;AACzE,OAAO,KAAK,EAAE,kBAAkB,EAAE,MAAM,mBAAmB,CAAC;AAE5D,MAAM,WAAW,gBAAgB;IAC/B,KAAK,EAAE,MAAM,CAAC;IACd,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB,QAAQ,EAAE,MAAM,CAAC;IACjB,QAAQ,EAAE,cAAc,EAAE,CAAC;IAC3B,QAAQ,EAAE,cAAc,EAAE,CAAC;IAC3B,IAAI,EAAE,MAAM,CAAC;IACb,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,SAAS,EAAE,MAAM,CAAC;CACnB;AAED,MAAM,WAAW,mBAAmB;IAClC,OAAO,EAAE,OAAO,CAAC;IACjB,UAAU,EAAE,MAAM,CAAC;IACnB,eAAe,EAAE,MAAM,CAAC;IACxB,SAAS,EAAE,MAAM,CAAC;IAClB,uBAAuB,EAAE,MAAM,CAAC;CACjC;AAED,eAAO,MAAM,6BAA6B,EAAE,mBAM3C,CAAC;AAEF,MAAM,MAAM,gBAAgB,GAAG,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;AAEvD,wBAAgB,sBAAsB,CAAC,GAAG,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,GAAG,mBAAmB,CAyBxF;AAID,wBAAgB,qBAAqB,CACnC,IAAI,EAAE,kBAAkB,EACxB,OAAO,CAAC,EAAE;IAAE,WAAW,CAAC,EAAE,MAAM,CAAC;IAAC,IAAI,CAAC,EAAE,MAAM,CAAA;CAAE,GAChD,MAAM,CAKR;AAED,wBAAsB,gBAAgB,CACpC,KAAK,EAAE,YAAY,EACnB,IAAI,EAAE,kBAAkB,EACxB,OAAO,CAAC,EAAE;IAAE,WAAW,CAAC,EAAE,MAAM,CAAC;IAAC,IAAI,CAAC,EAAE,MAAM,CAAA;CAAE,GAChD,OAAO,CAAC,gBAAgB,GAAG,IAAI,CAAC,CAIlC;AAED,wBAAsB,gBAAgB,CACpC,KAAK,EAAE,YAAY,EACnB,IAAI,EAAE,kBAAkB,EACxB,IAAI,EAAE,gBAAgB,EACtB,GAAG,EAAE,MAAM,EACX,OAAO,CAAC,EAAE;IAAE,WAAW,CAAC,EAAE,MAAM,CAAC;IAAC,IAAI,CAAC,EAAE,MAAM,CAAA;CAAE,GAChD,OAAO,CAAC,IAAI,CAAC,CAGf;AAED,wBAAsB,mBAAmB,CACvC,KAAK,EAAE,YAAY,EACnB,IAAI,EAAE,kBAAkB,EACxB,OAAO,CAAC,EAAE;IAAE,WAAW,CAAC,EAAE,MAAM,CAAC;IAAC,IAAI,CAAC,EAAE,MAAM,CAAA;CAAE,GAChD,OAAO,CAAC,OAAO,CAAC,CAGlB;AAED,MAAM,WAAW,aAAa;IAC5B,IAAI,EAAE,UAAU,GAAG,UAAU,CAAC;IAC9B,IAAI,EAAE,MAAM,CAAC;CACd;AAED,wBAAgB,+BAA+B,CAC7C,MAAM,EAAE,gBAAgB,EACxB,MAAM,EAAE,IAAI,CAAC,mBAAmB,EAAE,iBAAiB,GAAG,WAAW,GAAG,yBAAyB,CAAC,GAC7F,cAAc,CAAC,aAAa,EAAE,IAAI,EAAE,OAAO,CAAC,CA4B9C"}

package/dist/cache/response-cache.js

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

@@ -0,0 +1,118 @@
+/**
+ * @astro-minimax/ai
+ *
+ * Cache abstraction layer for AI conversation system.
+ * Supports multiple storage backends (memory, Cloudflare KV).
+ *
+ * @module cache/types
+ */
+/**
+ * Metadata stored alongside cache entries.
+ */
+export interface CacheEntryMetadata {
+    /** Timestamp when the entry was created (ms since epoch) */
+    createdAt: number;
+    /** Timestamp when the entry was last updated (ms since epoch) */
+    updatedAt: number;
+    /** Custom metadata provided by the caller */
+    custom?: Record<string, unknown>;
+}
+/**
+ * A cached entry with its value and metadata.
+ */
+export interface CacheEntry<T> {
+    /** The cached value */
+    value: T;
+    /** Entry metadata */
+    metadata: CacheEntryMetadata;
+}
+/**
+ * Options for setting a cache entry.
+ */
+export interface CacheSetOptions {
+    /** Time-to-live in seconds. If not provided, entry won't expire automatically. */
+    ttl?: number;
+    /** Custom metadata to store with the entry */
+    metadata?: Record<string, unknown>;
+}
+/**
+ * Options for getting a cache entry.
+ */
+export interface CacheGetOptions {
+    /** If true, return null instead of throwing on parse errors */
+    silent?: boolean;
+}
+/**
+ * Abstract cache adapter interface.
+ * Implementations: MemoryCacheAdapter, KVCacheAdapter.
+ *
+ * @example
+ * ```typescript
+ * const cache = new MemoryCacheAdapter();
+ * await cache.set('key', { data: 'value' }, { ttl: 600 });
+ * const entry = await cache.get<{ data: string }>('key');
+ * ```
+ */
+export interface CacheAdapter {
+    readonly name: string;
+    get<T>(key: string, options?: CacheGetOptions): Promise<CacheEntry<T> | null>;
+    set<T>(key: string, value: T, options?: CacheSetOptions): Promise<void>;
+    delete(key: string): Promise<boolean>;
+    clear(): Promise<void>;
+    has(key: string): Promise<boolean>;
+    isAvailable(): Promise<boolean>;
+    dispose?(): void;
+}
+/**
+ * Configuration for cache manager.
+ */
+export interface CacheManagerConfig {
+    /** Default TTL for entries (seconds). Default: 600 (10 minutes) */
+    defaultTtl?: number;
+    /** Maximum number of entries for memory cache. Default: 400 */
+    maxEntries?: number;
+    /** KV binding name in Cloudflare environment. Default: 'CACHE_KV' */
+    kvBindingName?: string;
+    /** Enable fallback to memory cache if KV is unavailable. Default: true */
+    enableFallback?: boolean;
+}
+/**
+ * Environment interface for cache initialization.
+ */
+export interface CacheEnv {
+    /** Cloudflare KV namespace binding */
+    CACHE_KV?: KVNamespace;
+    /** Custom KV binding name (overrides default) */
+    CACHE_KV_BINDING?: string;
+    /** Disable KV cache (force memory cache) */
+    CACHE_DISABLED?: string | boolean;
+    /** Default TTL override (seconds) */
+    CACHE_TTL?: string | number;
+}
+export type { CachedSearchContext } from '../search/types.js';
+/**
+ * Result of a cache operation.
+ */
+export type CacheResult<T> = {
+    success: true;
+    entry: CacheEntry<T>;
+} | {
+    success: false;
+    error: Error;
+};
+/**
+ * Key builder for cache keys.
+ */
+export interface CacheKeyBuilder {
+    /** Build a session-based cache key */
+    session(sessionId: string): string;
+    /** Build an article-scoped cache key */
+    article(sessionId: string, slug: string): string;
+    /** Build a custom cache key */
+    custom(...parts: string[]): string;
+}
+/**
+ * Default cache key builder implementation.
+ */
+export declare const createCacheKeyBuilder: (prefix?: string) => CacheKeyBuilder;
+//# sourceMappingURL=types.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"types.d.ts","sourceRoot":"","sources":["../../src/cache/types.ts"],"names":[],"mappings":"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"}

package/dist/cache/types.js

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

@@ -0,0 +1,3 @@
+export { preloadMetadata, clearMetadataCache, getMetadata, getArticleSummary, getAllSummaries, getAuthorContext, getVoiceProfile, } from './metadata-loader.js';
+export type { AISummariesFile, AuthorContextFile, VoiceProfile, LoadedMetadata, ArticleSummaryData, AuthorPost, } from './types.js';
+//# sourceMappingURL=index.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/data/index.ts"],"names":[],"mappings":"AAAA,OAAO,EACL,eAAe,EACf,kBAAkB,EAClB,WAAW,EACX,iBAAiB,EACjB,eAAe,EACf,gBAAgB,EAChB,eAAe,GAChB,MAAM,sBAAsB,CAAC;AAC9B,YAAY,EACV,eAAe,EACf,iBAAiB,EACjB,YAAY,EACZ,cAAc,EACd,kBAAkB,EAClB,UAAU,GACX,MAAM,YAAY,CAAC"}

package/dist/data/index.js

@@ -0,0 +1 @@
+export { preloadMetadata, clearMetadataCache, getMetadata, getArticleSummary, getAllSummaries, getAuthorContext, getVoiceProfile, } from './metadata-loader.js';

package/dist/data/metadata-loader.d.ts

@@ -0,0 +1,37 @@
+import type { AuthorContextFile, VoiceProfile, LoadedMetadata, ArticleSummaryData } from './types.js';
+/**
+ * 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 });
+ */
+export declare function preloadMetadata(data: Partial<LoadedMetadata>): void;
+/**
+ * Clears the metadata cache (useful for testing).
+ */
+export declare function clearMetadataCache(): void;
+/**
+ * Returns the cached metadata. Must call preloadMetadata() first.
+ */
+export declare function getMetadata(): LoadedMetadata;
+/**
+ * Returns the AI-generated summary for an article by its slug.
+ */
+export declare function getArticleSummary(slug: string): ArticleSummaryData | undefined;
+/**
+ * Returns all article summaries as a flat array.
+ */
+export declare function getAllSummaries(): Array<{
+    slug: string;
+} & ArticleSummaryData>;
+/**
+ * Returns the author context (name, site URL, recent posts list).
+ */
+export declare function getAuthorContext(): AuthorContextFile | null;
+/**
+ * Returns the author's voice/style profile.
+ */
+export declare function getVoiceProfile(): VoiceProfile | null;
+//# sourceMappingURL=metadata-loader.d.ts.map

package/dist/data/metadata-loader.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"metadata-loader.d.ts","sourceRoot":"","sources":["../../src/data/metadata-loader.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAmB,iBAAiB,EAAE,YAAY,EAAE,cAAc,EAAE,kBAAkB,EAAE,MAAM,YAAY,CAAC;AAKvH;;;;;;;GAOG;AACH,wBAAgB,eAAe,CAAC,IAAI,EAAE,OAAO,CAAC,cAAc,CAAC,GAAG,IAAI,CAMnE;AAED;;GAEG;AACH,wBAAgB,kBAAkB,IAAI,IAAI,CAEzC;AAED;;GAEG;AACH,wBAAgB,WAAW,IAAI,cAAc,CAE5C;AAED;;GAEG;AACH,wBAAgB,iBAAiB,CAAC,IAAI,EAAE,MAAM,GAAG,kBAAkB,GAAG,SAAS,CAE9E;AAED;;GAEG;AACH,wBAAgB,eAAe,IAAI,KAAK,CAAC;IAAE,IAAI,EAAE,MAAM,CAAA;CAAE,GAAG,kBAAkB,CAAC,CAG9E;AAED;;GAEG;AACH,wBAAgB,gBAAgB,IAAI,iBAAiB,GAAG,IAAI,CAE3D;AAED;;GAEG;AACH,wBAAgB,eAAe,IAAI,YAAY,GAAG,IAAI,CAErD"}

package/dist/data/metadata-loader.js

@@ -0,0 +1,54 @@
+// 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 });
+ */
+export function preloadMetadata(data) {
+    cachedMetadata = {
+        summaries: data.summaries ?? null,
+        authorContext: data.authorContext ?? null,
+        voiceProfile: data.voiceProfile ?? null,
+    };
+}
+/**
+ * Clears the metadata cache (useful for testing).
+ */
+export function clearMetadataCache() {
+    cachedMetadata = null;
+}
+/**
+ * Returns the cached metadata. Must call preloadMetadata() first.
+ */
+export function getMetadata() {
+    return cachedMetadata ?? { summaries: null, authorContext: null, voiceProfile: 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.d.ts

@@ -0,0 +1,51 @@
+export interface ArticleSummaryData {
+    summary: string;
+    abstract?: string;
+    keyPoints: string[];
+    tags: string[];
+    readingTime?: number;
+}
+export interface ArticleSummaryEntry {
+    data: ArticleSummaryData;
+    contentHash?: string;
+    processedAt?: string;
+}
+export interface AISummariesFile {
+    meta: {
+        lastUpdated: string;
+        model: string;
+        totalProcessed: number;
+    };
+    articles: Record<string, ArticleSummaryEntry>;
+}
+export interface AuthorPost {
+    id: string;
+    title: string;
+    date: string;
+    lang: string;
+    category: string;
+    tags: string[];
+    summary: string;
+    keyPoints: string[];
+    url: string;
+}
+export interface AuthorProfile {
+    name: string;
+    siteUrl: string;
+    description: string;
+}
+export interface AuthorContextFile {
+    profile: AuthorProfile;
+    posts: AuthorPost[];
+}
+export interface VoiceProfile {
+    tone?: string;
+    style?: string;
+    [key: string]: unknown;
+}
+export interface LoadedMetadata {
+    summaries: AISummariesFile | null;
+    authorContext: AuthorContextFile | null;
+    voiceProfile: VoiceProfile | null;
+}
+//# sourceMappingURL=types.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"types.d.ts","sourceRoot":"","sources":["../../src/data/types.ts"],"names":[],"mappings":"AAAA,MAAM,WAAW,kBAAkB;IACjC,OAAO,EAAE,MAAM,CAAC;IAChB,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB,SAAS,EAAE,MAAM,EAAE,CAAC;IACpB,IAAI,EAAE,MAAM,EAAE,CAAC;IACf,WAAW,CAAC,EAAE,MAAM,CAAC;CACtB;AAED,MAAM,WAAW,mBAAmB;IAClC,IAAI,EAAE,kBAAkB,CAAC;IACzB,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,WAAW,CAAC,EAAE,MAAM,CAAC;CACtB;AAED,MAAM,WAAW,eAAe;IAC9B,IAAI,EAAE;QACJ,WAAW,EAAE,MAAM,CAAC;QACpB,KAAK,EAAE,MAAM,CAAC;QACd,cAAc,EAAE,MAAM,CAAC;KACxB,CAAC;IACF,QAAQ,EAAE,MAAM,CAAC,MAAM,EAAE,mBAAmB,CAAC,CAAC;CAC/C;AAED,MAAM,WAAW,UAAU;IACzB,EAAE,EAAE,MAAM,CAAC;IACX,KAAK,EAAE,MAAM,CAAC;IACd,IAAI,EAAE,MAAM,CAAC;IACb,IAAI,EAAE,MAAM,CAAC;IACb,QAAQ,EAAE,MAAM,CAAC;IACjB,IAAI,EAAE,MAAM,EAAE,CAAC;IACf,OAAO,EAAE,MAAM,CAAC;IAChB,SAAS,EAAE,MAAM,EAAE,CAAC;IACpB,GAAG,EAAE,MAAM,CAAC;CACb;AAED,MAAM,WAAW,aAAa;IAC5B,IAAI,EAAE,MAAM,CAAC;IACb,OAAO,EAAE,MAAM,CAAC;IAChB,WAAW,EAAE,MAAM,CAAC;CACrB;AAED,MAAM,WAAW,iBAAiB;IAChC,OAAO,EAAE,aAAa,CAAC;IACvB,KAAK,EAAE,UAAU,EAAE,CAAC;CACrB;AAED,MAAM,WAAW,YAAY;IAC3B,IAAI,CAAC,EAAE,MAAM,CAAC;IACd,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,CAAC,GAAG,EAAE,MAAM,GAAG,OAAO,CAAC;CACxB;AAED,MAAM,WAAW,cAAc;IAC7B,SAAS,EAAE,eAAe,GAAG,IAAI,CAAC;IAClC,aAAa,EAAE,iBAAiB,GAAG,IAAI,CAAC;IACxC,YAAY,EAAE,YAAY,GAAG,IAAI,CAAC;CACnC"}

package/dist/data/types.js

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

package/dist/index.d.ts

@@ -0,0 +1,19 @@
+/**
+ * @astro-minimax/ai
+ *
+ * Vendor-agnostic AI integration package with full RAG pipeline.
+ * Supports OpenAI-compatible APIs and Cloudflare Workers AI.
+ *
+ * @packageDocumentation
+ */
+export * from './providers/index.js';
+export * from './provider-manager/index.js';
+export * from './middleware/index.js';
+export * from './cache/index.js';
+export * from './search/index.js';
+export * from './intelligence/index.js';
+export * from './prompt/index.js';
+export * from './data/index.js';
+export * from './stream/index.js';
+export * from './server/index.js';
+//# sourceMappingURL=index.d.ts.map

package/dist/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA;;;;;;;GAOG;AAGH,cAAc,sBAAsB,CAAC;AAGrC,cAAc,6BAA6B,CAAC;AAG5C,cAAc,uBAAuB,CAAC;AAGtC,cAAc,kBAAkB,CAAC;AAGjC,cAAc,mBAAmB,CAAC;AAGlC,cAAc,yBAAyB,CAAC;AAGxC,cAAc,mBAAmB,CAAC;AAGlC,cAAc,iBAAiB,CAAC;AAGhC,cAAc,mBAAmB,CAAC;AAGlC,cAAc,mBAAmB,CAAC"}

package/dist/index.js

@@ -0,0 +1,28 @@
+/**
+ * @astro-minimax/ai
+ *
+ * Vendor-agnostic AI integration package with full RAG pipeline.
+ * Supports OpenAI-compatible APIs and Cloudflare Workers AI.
+ *
+ * @packageDocumentation
+ */
+// Provider abstractions
+export * from './providers/index.js';
+// Provider Manager (unified multi-provider management)
+export * from './provider-manager/index.js';
+// Middleware (rate limiting)
+export * from './middleware/index.js';
+// Cache abstraction layer
+export * from './cache/index.js';
+// Search API + session cache
+export * from './search/index.js';
+// Intelligence: intent detection, keyword extraction, evidence analysis, citation guard
+export * from './intelligence/index.js';
+// System prompt builder (three layers)
+export * from './prompt/index.js';
+// Build-time metadata loading
+export * from './data/index.js';
+// Stream utilities
+export * from './stream/index.js';
+// Server-side API handlers (chat handler, metadata init)
+export * from './server/index.js';

package/dist/intelligence/citation-guard.d.ts

@@ -0,0 +1,24 @@
+import type { ArticleContext, ProjectContext } from '../search/types.js';
+import type { CitationGuardPreflight, CitationGuardAction } from './types.js';
+/**
+ * Pre-flight check: if the user is asking about something that can be
+ * answered directly from the available context without an LLM, return it.
+ * This prevents hallucination for specific factual queries.
+ */
+export declare function getCitationGuardPreflight(params: {
+    userQuery: string;
+    articles: ArticleContext[];
+    projects: ProjectContext[];
+}): CitationGuardPreflight | null;
+/**
+ * Creates a transform stream that monitors the AI output for hallucinated references.
+ * Rewrites or suppresses fabricated article/project links.
+ */
+export declare function createCitationGuardTransform(params: {
+    articles: ArticleContext[];
+    projects: ProjectContext[];
+    onApplied?: (result: {
+        actions: CitationGuardAction[];
+    }) => void;
+}): (stream: ReadableStream<string>) => ReadableStream<string>;
+//# sourceMappingURL=citation-guard.d.ts.map

package/dist/intelligence/citation-guard.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"citation-guard.d.ts","sourceRoot":"","sources":["../../src/intelligence/citation-guard.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,cAAc,EAAE,cAAc,EAAE,MAAM,oBAAoB,CAAC;AACzE,OAAO,KAAK,EAAE,sBAAsB,EAAE,mBAAmB,EAAE,MAAM,YAAY,CAAC;AAE9E;;;;GAIG;AACH,wBAAgB,yBAAyB,CAAC,MAAM,EAAE;IAChD,SAAS,EAAE,MAAM,CAAC;IAClB,QAAQ,EAAE,cAAc,EAAE,CAAC;IAC3B,QAAQ,EAAE,cAAc,EAAE,CAAC;CAC5B,GAAG,sBAAsB,GAAG,IAAI,CA0BhC;AAED;;;GAGG;AACH,wBAAgB,4BAA4B,CAAC,MAAM,EAAE;IACnD,QAAQ,EAAE,cAAc,EAAE,CAAC;IAC3B,QAAQ,EAAE,cAAc,EAAE,CAAC;IAC3B,SAAS,CAAC,EAAE,CAAC,MAAM,EAAE;QAAE,OAAO,EAAE,mBAAmB,EAAE,CAAA;KAAE,KAAK,IAAI,CAAC;CAClE,GAAG,CAAC,MAAM,EAAE,cAAc,CAAC,MAAM,CAAC,KAAK,cAAc,CAAC,MAAM,CAAC,CAuD7D"}