@astro-minimax/ai 0.9.0 → 0.9.3

package/README.md

@@ -31,11 +31,81 @@ Vendor-agnostic AI integration package with full RAG pipeline for astro-minimax
 | `server/`           | Reusable API handlers (`handleChatRequest`, `initializeMetadata`)      |
 | `provider-manager/` | Multi-provider management with priority, failover, health tracking     |
 | `search/`           | In-memory article/project search with session caching                  |
-| `intelligence/`     | Keyword extraction, evidence analysis, citation guard                  |
+| `intelligence/`     | Keyword extraction, evidence analysis, citation guard, answer mode, dynamic evidence budget |
 | `prompt/`           | Three-layer system prompt builder (static → semi-static → dynamic)     |
-| `data/`             | Build-time metadata loading (summaries, author context, voice profile) |
-| `stream/`           | Stream helpers and response utilities                                  |
+| `data/`             | Bundle-backed runtime metadata loading and shared data types            |
 | `components/`       | Preact UI components (ChatPanel, AIChatWidget, AIChatContainer)        |
+| `extensions/`       | Search/prompt extensions and semantic fallback rules                   |
+| `structured-output/`| Schema-validated structured generation helpers                         |
+| `cache/`            | Response/session/injection cache utilities                             |
+| `fact-registry/`    | Verified facts used for grounded prompt assembly                       |
+| `tools/`            | Runtime tool registry and built-in action/search tools                 |
+
+## Features
+
+### Dynamic Evidence Budget
+
+The system dynamically adjusts retrieval and analysis resources based on query complexity:
+
+| Complexity | Max Articles | Summary Length | Key Points | Deep Content |
+|------------|--------------|----------------|------------|--------------|
+| `simple`   | 4            | 48 chars       | 2          | No           |
+| `moderate` | 6            | 56 chars       | 3          | Yes          |
+| `complex`  | 8            | 64 chars       | 4          | Yes          |
+
+Budget is further adjusted by **answer mode** (count, list, opinion, recommendation):
+
+```typescript
+import { getEvidenceBudget, applyBudgetToArticles } from '@astro-minimax/ai/intelligence';
+
+const budget = getEvidenceBudget('moderate', 'list');
+// → { maxArticles: 8, summaryMaxLength: 80, ... }
+
+const trimmedArticles = applyBudgetToArticles(articles, budget);
+```
+
+### Answer Mode Detection
+
+Automatically detects the expected response format from user queries:
+
+| Mode            | Trigger Patterns              | Response Style                    |
+|-----------------|-------------------------------|-----------------------------------|
+| `fact`          | "是什么", "what is"           | Conclusion first, then evidence   |
+| `count`         | "多少", "how many"            | Number in first sentence          |
+| `list`          | "哪些", "what are"            | 2-6 items directly                |
+| `opinion`       | "怎么看", "what do you think" | "I think..." + 2-3 points         |
+| `recommendation`| "推荐", "suggest"             | 2-4 recommendations + reasons     |
+
+Answer mode hints are injected into the dynamic prompt layer, guiding the LLM toward the appropriate format.
+
+### Reading Time Display
+
+Article reading time is now displayed in the dynamic prompt layer:
+
+```
+**[Article Title](/posts/article)**
+阅读时间：约 5 分钟
+摘要：Article summary...
+```
+
+### Enhanced Citation Guard
+
+Improved URL validation prevents hallucinated links:
+
+- **Scheme whitelist**: Only `http://` and `https://` allowed
+- **Domain validation**: Blocks localhost, private IPs, internal networks
+- **XSS prevention**: Sanitizes dangerous URL patterns
+
+```typescript
+import { createCitationGuardTransform } from '@astro-minimax/ai/intelligence';
+
+const guard = createCitationGuardTransform({
+  articles,
+  projects,
+  siteUrl: 'https://example.com',
+  onApplied: ({ actions }) => console.log('Rewrote:', actions),
+});
+```
 
 ## Installation
 
@@ -77,13 +147,13 @@ export const SITE = {
 
 ### Response Cache Configuration
 
-| Variable                           | Default | Description                               |
-| ---------------------------------- | ------- | ----------------------------------------- |
-| `AI_RESPONSE_CACHE_ENABLED`        | `false` | Enable AI response caching                |
-| `AI_RESPONSE_CACHE_TTL`            | `3600`  | Cache TTL in seconds (1 hour)             |
-| `AI_RESPONSE_CACHE_PLAYBACK_DELAY` | `20`    | Delay between chunks during playback (ms) |
-| `AI_RESPONSE_CACHE_CHUNK_SIZE`     | `15`    | Characters per chunk during playback      |
-| `AI_RESPONSE_CACHE_THINKING_DELAY` | `5`     | Delay for thinking content playback (ms)  |
+| Variable                    | Default | Description                               |
+| --------------------------- | ------- | ----------------------------------------- |
+| `AI_CACHE_ENABLED`          | `false` | Enable AI response caching                |
+| `AI_CACHE_TTL`              | `3600`  | Cache TTL in seconds (1 hour)             |
+| `AI_CACHE_PLAYBACK_DELAY`   | `20`    | Delay between chunks during playback (ms) |
+| `AI_CACHE_CHUNK_SIZE`       | `15`    | Characters per chunk during playback      |
+| `AI_CACHE_THINKING_DELAY`   | `5`     | Delay for thinking content playback (ms)  |
 
 When enabled, the system caches complete AI responses (including thinking/reasoning content) for public questions like "What tech stack does this blog use?". Subsequent identical queries are served from cache with simulated streaming playback, reducing API costs and response time.
 
@@ -96,12 +166,11 @@ The server module provides reusable request handlers, decoupled from any specifi
 ```typescript
 // functions/api/chat.ts
 import { handleChatRequest, initializeMetadata } from '@astro-minimax/ai/server';
-import summaries from '../../datas/ai-summaries.json';
-import authorContext from '../../datas/author-context.json';
-import voiceProfile from '../../datas/voice-profile.json';
+import knowledgeBundle from '../../datas/knowledge/runtime/knowledge-bundle.json';
 
 export const onRequest: PagesFunction = async (context) => {
-  initializeMetadata({ summaries, authorContext, voiceProfile }, context.env);
+  initializeMetadata({ knowledgeBundle }, context.env);
+
   return handleChatRequest({ env: context.env, request: context.request });
 };
 ```
@@ -213,11 +282,32 @@ Core chat UI built on `useChat` from `@ai-sdk/react`:
 | ---------------- | --------------------------------------------------------------- |
 | `.`              | All modules                                                     |
 | `./server`       | `handleChatRequest`, `initializeMetadata`, error helpers, types |
-| `./providers`    | Mock response/stream utilities                                  |
 | `./middleware`   | Rate limiting                                                   |
 | `./search`       | Article/project search, session cache                           |
-| `./intelligence` | Keyword extraction, evidence analysis, citation guard           |
+| `./intelligence` | Keyword extraction, evidence analysis, citation guard, answer mode, evidence budget |
 | `./prompt`       | System prompt builder                                           |
+| `./cache`        | Cache adapters and response/session cache utilities             |
 | `./data`         | Metadata loading                                                |
-| `./stream`       | Stream utilities                                                |
-| `./components/*` | Astro/Preact components                                         |
+| `./fact-registry`| Verified facts registry                                         |
+| `./extensions`   | Extension registry, loader, and injector                        |
+| `./structured-output` | Structured output helpers                                   |
+| `./tools`        | Tool registry and built-in AI tools                             |
+| `./components/ChatPanel` | Preact chat panel component                             |
+| `./components/AIChatContainer` | Preact chat container component                   |
+| `./components/AIChatWidget.astro` | Astro chat widget entry point                  |
+
+## Testing
+
+The package includes comprehensive unit tests with Vitest:
+
+```bash
+cd packages/ai
+pnpm test
+```
+
+Test coverage includes:
+- Citation guard (10 tests)
+- Intent detection (7 tests)
+- Keyword extraction (7 tests)
+- Evidence analysis (7 tests)
+- Evidence budget (5 tests)

package/dist/cache/global-cache.d.ts

@@ -1,5 +1,5 @@
-import type { CacheAdapter, CachedSearchContext } from './types.js';
-export type PublicQuestionType = 'tech' | 'recommend' | 'build' | 'summary' | 'author' | 'about';
+import type { CacheAdapter, CachedSearchContext } from "./types.js";
+export type PublicQuestionType = "tech" | "recommend" | "build" | "summary" | "author" | "about";
 export interface PublicQuestionPattern {
     type: PublicQuestionType;
     keywords: string[];
@@ -18,14 +18,18 @@ export declare function detectPublicQuestion(query: string): DetectedPublicQuest
 export declare function buildGlobalCacheKey(type: PublicQuestionType, context?: {
     articleSlug?: string;
     lang?: string;
+    queryKey?: string;
 }): string;
+export declare function normalizePublicCacheQuery(query: string): string;
 export declare function getGlobalSearchCache(cache: CacheAdapter, type: PublicQuestionType, context?: {
     articleSlug?: string;
     lang?: string;
+    queryKey?: string;
 }): Promise<CachedSearchContext | null>;
 export declare function setGlobalSearchCache(cache: CacheAdapter, type: PublicQuestionType, data: CachedSearchContext, ttl: number, context?: {
     articleSlug?: string;
     lang?: string;
+    queryKey?: string;
 }): Promise<void>;
 export declare function getGlobalCacheTTL(type: PublicQuestionType): number;
 //# sourceMappingURL=global-cache.d.ts.map

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

@@ -1 +1 @@
-{"version":3,"file":"global-cache.d.ts","sourceRoot":"","sources":["../../src/cache/global-cache.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,YAAY,EAAE,mBAAmB,EAAE,MAAM,YAAY,CAAC;AAEpE,MAAM,MAAM,kBAAkB,GAC1B,MAAM,GACN,WAAW,GACX,OAAO,GACP,SAAS,GACT,QAAQ,GACR,OAAO,CAAC;AAEZ,MAAM,WAAW,qBAAqB;IACpC,IAAI,EAAE,kBAAkB,CAAC;IACzB,QAAQ,EAAE,MAAM,EAAE,CAAC;IACnB,QAAQ,EAAE,MAAM,EAAE,CAAC;IACnB,GAAG,EAAE,MAAM,CAAC;IACZ,YAAY,EAAE,OAAO,CAAC;CACvB;AAED,eAAO,MAAM,wBAAwB,EAAE,qBAAqB,EAiF3D,CAAC;AAEF,MAAM,WAAW,sBAAsB;IACrC,IAAI,EAAE,kBAAkB,CAAC;IACzB,UAAU,EAAE,MAAM,CAAC;IACnB,GAAG,EAAE,MAAM,CAAC;IACZ,YAAY,EAAE,OAAO,CAAC;CACvB;AAED,wBAAgB,oBAAoB,CAAC,KAAK,EAAE,MAAM,GAAG,sBAAsB,GAAG,IAAI,CAkCjF;AAED,wBAAgB,mBAAmB,CACjC,IAAI,EAAE,kBAAkB,EACxB,OAAO,CAAC,EAAE;IAAE,WAAW,CAAC,EAAE,MAAM,CAAC;IAAC,IAAI,CAAC,EAAE,MAAM,CAAA;CAAE,GAChD,MAAM,CAYR;AAUD,wBAAsB,oBAAoB,CACxC,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,mBAAmB,GAAG,IAAI,CAAC,CAIrC;AAED,wBAAsB,oBAAoB,CACxC,KAAK,EAAE,YAAY,EACnB,IAAI,EAAE,kBAAkB,EACxB,IAAI,EAAE,mBAAmB,EACzB,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,wBAAgB,iBAAiB,CAAC,IAAI,EAAE,kBAAkB,GAAG,MAAM,CAGlE"}
+{"version":3,"file":"global-cache.d.ts","sourceRoot":"","sources":["../../src/cache/global-cache.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,YAAY,EAAE,mBAAmB,EAAE,MAAM,YAAY,CAAC;AAEpE,MAAM,MAAM,kBAAkB,GAC1B,MAAM,GACN,WAAW,GACX,OAAO,GACP,SAAS,GACT,QAAQ,GACR,OAAO,CAAC;AAEZ,MAAM,WAAW,qBAAqB;IACpC,IAAI,EAAE,kBAAkB,CAAC;IACzB,QAAQ,EAAE,MAAM,EAAE,CAAC;IACnB,QAAQ,EAAE,MAAM,EAAE,CAAC;IACnB,GAAG,EAAE,MAAM,CAAC;IACZ,YAAY,EAAE,OAAO,CAAC;CACvB;AAED,eAAO,MAAM,wBAAwB,EAAE,qBAAqB,EAoF3D,CAAC;AAEF,MAAM,WAAW,sBAAsB;IACrC,IAAI,EAAE,kBAAkB,CAAC;IACzB,UAAU,EAAE,MAAM,CAAC;IACnB,GAAG,EAAE,MAAM,CAAC;IACZ,YAAY,EAAE,OAAO,CAAC;CACvB;AAED,wBAAgB,oBAAoB,CAClC,KAAK,EAAE,MAAM,GACZ,sBAAsB,GAAG,IAAI,CAkC/B;AAED,wBAAgB,mBAAmB,CACjC,IAAI,EAAE,kBAAkB,EACxB,OAAO,CAAC,EAAE;IAAE,WAAW,CAAC,EAAE,MAAM,CAAC;IAAC,IAAI,CAAC,EAAE,MAAM,CAAC;IAAC,QAAQ,CAAC,EAAE,MAAM,CAAA;CAAE,GACnE,MAAM,CAgBR;AAED,wBAAgB,yBAAyB,CAAC,KAAK,EAAE,MAAM,GAAG,MAAM,CAM/D;AAED,wBAAsB,oBAAoB,CACxC,KAAK,EAAE,YAAY,EACnB,IAAI,EAAE,kBAAkB,EACxB,OAAO,CAAC,EAAE;IAAE,WAAW,CAAC,EAAE,MAAM,CAAC;IAAC,IAAI,CAAC,EAAE,MAAM,CAAC;IAAC,QAAQ,CAAC,EAAE,MAAM,CAAA;CAAE,GACnE,OAAO,CAAC,mBAAmB,GAAG,IAAI,CAAC,CAOrC;AAED,wBAAsB,oBAAoB,CACxC,KAAK,EAAE,YAAY,EACnB,IAAI,EAAE,kBAAkB,EACxB,IAAI,EAAE,mBAAmB,EACzB,GAAG,EAAE,MAAM,EACX,OAAO,CAAC,EAAE;IAAE,WAAW,CAAC,EAAE,MAAM,CAAC;IAAC,IAAI,CAAC,EAAE,MAAM,CAAC;IAAC,QAAQ,CAAC,EAAE,MAAM,CAAA;CAAE,GACnE,OAAO,CAAC,IAAI,CAAC,CAMf;AAED,wBAAgB,iBAAiB,CAAC,IAAI,EAAE,kBAAkB,GAAG,MAAM,CAGlE"}

package/dist/cache/global-cache.js

@@ -1,7 +1,15 @@
 const PUBLIC_QUESTION_PATTERNS = [
   {
     type: "tech",
-    keywords: ["\u6280\u672F\u6808", "\u6280\u672F", "\u6846\u67B6", "\u7528\u4E86\u4EC0\u4E48", "built with", "tech stack", "framework"],
+    keywords: [
+      "\u6280\u672F\u6808",
+      "\u6280\u672F",
+      "\u6846\u67B6",
+      "\u7528\u4E86\u4EC0\u4E48",
+      "built with",
+      "tech stack",
+      "framework"
+    ],
     patterns: [
       /这个博客用了什么/,
       /博客.*技术栈/,
@@ -70,18 +78,13 @@ const PUBLIC_QUESTION_PATTERNS = [
   {
     type: "about",
     keywords: ["\u5173\u4E8E", "\u4ECB\u7ECD", "about", "intro"],
-    patterns: [
-      /关于.*博客/,
-      /博客介绍/,
-      /about.*blog/,
-      /介绍一下/
-    ],
+    patterns: [/关于.*博客/, /博客介绍/, /about.*blog/, /介绍一下/],
     ttl: 86400,
     needsContext: false
   }
 ];
 function detectPublicQuestion(query) {
-  const normalized = normalizeQuery(query);
+  const normalized = normalizePublicCacheQuery(query);
   let bestMatch = null;
   let bestScore = 0;
   for (const pattern of PUBLIC_QUESTION_PATTERNS) {
@@ -117,29 +120,41 @@ function buildGlobalCacheKey(type, context) {
   if (context?.lang) {
     parts.push(context.lang);
   }
+  if (context?.queryKey) {
+    parts.push(context.queryKey);
+  }
   return parts.join(":");
 }
-function normalizeQuery(query) {
+function normalizePublicCacheQuery(query) {
   return query.toLowerCase().replace(/[？?!！。，,.]/g, "").replace(/\s+/g, " ").trim();
 }
 async function getGlobalSearchCache(cache, type, context) {
   const key = buildGlobalCacheKey(type, context);
   const entry = await cache.get(key);
+  log.debug(
+    `getGlobalSearchCache: key=${key}, hit=${Boolean(entry?.value)}, adapter=${cache.name}`
+  );
   return entry?.value ?? null;
 }
 async function setGlobalSearchCache(cache, type, data, ttl, context) {
   const key = buildGlobalCacheKey(type, context);
   await cache.set(key, data, { ttl });
+  log.debug(
+    `setGlobalSearchCache: key=${key}, articles=${data.articles.length}, projects=${data.projects.length}, ttl=${ttl}, adapter=${cache.name}`
+  );
 }
 function getGlobalCacheTTL(type) {
   const pattern = PUBLIC_QUESTION_PATTERNS.find((p) => p.type === type);
   return pattern?.ttl ?? 3600;
 }
+import { createLogger } from "../utils/logger.js";
+const log = createLogger("global-cache");
 export {
   PUBLIC_QUESTION_PATTERNS,
   buildGlobalCacheKey,
   detectPublicQuestion,
   getGlobalCacheTTL,
   getGlobalSearchCache,
+  normalizePublicCacheQuery,
   setGlobalSearchCache
 };

package/dist/cache/index.d.ts

@@ -1,8 +1,9 @@
-export { MemoryCacheAdapter, type MemoryCacheOptions, } from './memory-adapter.js';
-export { KVCacheAdapter, type KVCacheOptions, } from './kv-adapter.js';
-export { createCacheKeyBuilder, type CacheAdapter, type CacheEntry, type CacheEntryMetadata, type CacheSetOptions, type CacheGetOptions, type CacheManagerConfig, type CacheEnv, type CachedSearchContext, type CacheResult, type CacheKeyBuilder, } from './types.js';
-export { detectPublicQuestion, buildGlobalCacheKey, getGlobalSearchCache, setGlobalSearchCache, getGlobalCacheTTL, PUBLIC_QUESTION_PATTERNS, type PublicQuestionType, type PublicQuestionPattern, type DetectedPublicQuestion, } from './global-cache.js';
-export { getResponseCache, setResponseCache, deleteResponseCache, getResponseCacheConfig, buildResponseCacheKey, createResponsePlaybackGenerator, DEFAULT_RESPONSE_CACHE_CONFIG, type CachedAIResponse, type ResponseCacheConfig, type ResponseCacheEnv, type PlaybackChunk, } from './response-cache.js';
-import type { CacheAdapter, CacheEnv, CacheManagerConfig } from './types.js';
+export { MemoryCacheAdapter, type MemoryCacheOptions, } from "./memory-adapter.js";
+export { KVCacheAdapter, type KVCacheOptions } from "./kv-adapter.js";
+export { createCacheKeyBuilder, type CacheAdapter, type CacheEntry, type CacheEntryMetadata, type CacheSetOptions, type CacheGetOptions, type CacheManagerConfig, type CacheEnv, type CachedSearchContext, type CacheResult, type CacheKeyBuilder, } from "./types.js";
+export { detectPublicQuestion, buildGlobalCacheKey, normalizePublicCacheQuery, getGlobalSearchCache, setGlobalSearchCache, getGlobalCacheTTL, PUBLIC_QUESTION_PATTERNS, type PublicQuestionType, type PublicQuestionPattern, type DetectedPublicQuestion, } from "./global-cache.js";
+export { getResponseCache, setResponseCache, deleteResponseCache, getResponseCacheConfig, buildResponseCacheKey, createResponsePlaybackGenerator, DEFAULT_RESPONSE_CACHE_CONFIG, type CachedAIResponse, type ResponseCacheConfig, type ResponseCacheEnv, type PlaybackChunk, } from "./response-cache.js";
+export { injectionCache, type InjectionCacheEntry } from "./injection-cache.js";
+import type { CacheAdapter, CacheEnv, CacheManagerConfig } from "./types.js";
 export declare function createCacheAdapter(env: CacheEnv, config?: CacheManagerConfig): CacheAdapter;
 //# sourceMappingURL=index.d.ts.map

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

@@ -1 +1 @@
-{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/cache/index.ts"],"names":[],"mappings":"AAAA,OAAO,EACL,kBAAkB,EAClB,KAAK,kBAAkB,GACxB,MAAM,qBAAqB,CAAC;AAE7B,OAAO,EACL,cAAc,EACd,KAAK,cAAc,GACpB,MAAM,iBAAiB,CAAC;AAEzB,OAAO,EACL,qBAAqB,EACrB,KAAK,YAAY,EACjB,KAAK,UAAU,EACf,KAAK,kBAAkB,EACvB,KAAK,eAAe,EACpB,KAAK,eAAe,EACpB,KAAK,kBAAkB,EACvB,KAAK,QAAQ,EACb,KAAK,mBAAmB,EACxB,KAAK,WAAW,EAChB,KAAK,eAAe,GACrB,MAAM,YAAY,CAAC;AAEpB,OAAO,EACL,oBAAoB,EACpB,mBAAmB,EACnB,oBAAoB,EACpB,oBAAoB,EACpB,iBAAiB,EACjB,wBAAwB,EACxB,KAAK,kBAAkB,EACvB,KAAK,qBAAqB,EAC1B,KAAK,sBAAsB,GAC5B,MAAM,mBAAmB,CAAC;AAE3B,OAAO,EACL,gBAAgB,EAChB,gBAAgB,EAChB,mBAAmB,EACnB,sBAAsB,EACtB,qBAAqB,EACrB,+BAA+B,EAC/B,6BAA6B,EAC7B,KAAK,gBAAgB,EACrB,KAAK,mBAAmB,EACxB,KAAK,gBAAgB,EACrB,KAAK,aAAa,GACnB,MAAM,qBAAqB,CAAC;AAI7B,OAAO,KAAK,EAAE,YAAY,EAAE,QAAQ,EAAE,kBAAkB,EAAE,MAAM,YAAY,CAAC;AAc7E,wBAAgB,kBAAkB,CAChC,GAAG,EAAE,QAAQ,EACb,MAAM,CAAC,EAAE,kBAAkB,GAC1B,YAAY,CAcd"}
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/cache/index.ts"],"names":[],"mappings":"AAAA,OAAO,EACL,kBAAkB,EAClB,KAAK,kBAAkB,GACxB,MAAM,qBAAqB,CAAC;AAE7B,OAAO,EAAE,cAAc,EAAE,KAAK,cAAc,EAAE,MAAM,iBAAiB,CAAC;AAEtE,OAAO,EACL,qBAAqB,EACrB,KAAK,YAAY,EACjB,KAAK,UAAU,EACf,KAAK,kBAAkB,EACvB,KAAK,eAAe,EACpB,KAAK,eAAe,EACpB,KAAK,kBAAkB,EACvB,KAAK,QAAQ,EACb,KAAK,mBAAmB,EACxB,KAAK,WAAW,EAChB,KAAK,eAAe,GACrB,MAAM,YAAY,CAAC;AAEpB,OAAO,EACL,oBAAoB,EACpB,mBAAmB,EACnB,yBAAyB,EACzB,oBAAoB,EACpB,oBAAoB,EACpB,iBAAiB,EACjB,wBAAwB,EACxB,KAAK,kBAAkB,EACvB,KAAK,qBAAqB,EAC1B,KAAK,sBAAsB,GAC5B,MAAM,mBAAmB,CAAC;AAE3B,OAAO,EACL,gBAAgB,EAChB,gBAAgB,EAChB,mBAAmB,EACnB,sBAAsB,EACtB,qBAAqB,EACrB,+BAA+B,EAC/B,6BAA6B,EAC7B,KAAK,gBAAgB,EACrB,KAAK,mBAAmB,EACxB,KAAK,gBAAgB,EACrB,KAAK,aAAa,GACnB,MAAM,qBAAqB,CAAC;AAE7B,OAAO,EAAE,cAAc,EAAE,KAAK,mBAAmB,EAAE,MAAM,sBAAsB,CAAC;AAIhF,OAAO,KAAK,EAAE,YAAY,EAAE,QAAQ,EAAE,kBAAkB,EAAE,MAAM,YAAY,CAAC;AAsB7E,wBAAgB,kBAAkB,CAChC,GAAG,EAAE,QAAQ,EACb,MAAM,CAAC,EAAE,kBAAkB,GAC1B,YAAY,CAiBd"}

package/dist/cache/index.js

@@ -1,15 +1,14 @@
 import {
   MemoryCacheAdapter
 } from "./memory-adapter.js";
-import {
-  KVCacheAdapter
-} from "./kv-adapter.js";
+import { KVCacheAdapter } from "./kv-adapter.js";
 import {
   createCacheKeyBuilder
 } from "./types.js";
 import {
   detectPublicQuestion,
   buildGlobalCacheKey,
+  normalizePublicCacheQuery,
   getGlobalSearchCache,
   setGlobalSearchCache,
   getGlobalCacheTTL,
@@ -24,9 +23,13 @@ import {
   createResponsePlaybackGenerator,
   DEFAULT_RESPONSE_CACHE_CONFIG
 } from "./response-cache.js";
+import { injectionCache } from "./injection-cache.js";
 import { MemoryCacheAdapter as MemoryCacheAdapter2 } from "./memory-adapter.js";
 import { KVCacheAdapter as KVCacheAdapter2 } from "./kv-adapter.js";
-const DEFAULT_TTL = 600;
+import { CACHE } from "../constants.js";
+import { createLogger } from "../utils/logger.js";
+const log = createLogger("cache");
+const DEFAULT_TTL = CACHE.DEFAULT_TTL;
 const DEFAULT_MAX_ENTRIES = 400;
 let globalMemoryCache = null;
 function getGlobalMemoryCache(ttl, maxEntries) {
@@ -39,12 +42,15 @@ function createCacheAdapter(env, config) {
   const ttl = config?.defaultTtl ?? parseTtl(env.CACHE_TTL) ?? DEFAULT_TTL;
   const maxEntries = config?.maxEntries ?? DEFAULT_MAX_ENTRIES;
   if (isCacheDisabled(env)) {
+    log.debug(`createCacheAdapter: cache disabled, using memory ttl=${ttl}`);
     return getGlobalMemoryCache(ttl, maxEntries);
   }
   const kvBinding = getKVBinding(env);
   if (kvBinding) {
+    log.debug(`createCacheAdapter: using kv adapter ttl=${ttl}`);
     return new KVCacheAdapter2(kvBinding, { defaultTtl: ttl });
   }
+  log.debug(`createCacheAdapter: using memory adapter ttl=${ttl}`);
   return getGlobalMemoryCache(ttl, maxEntries);
 }
 function isCacheDisabled(env) {
@@ -91,6 +97,8 @@ export {
   getGlobalSearchCache,
   getResponseCache,
   getResponseCacheConfig,
+  injectionCache,
+  normalizePublicCacheQuery,
   setGlobalSearchCache,
   setResponseCache
 };

package/dist/cache/injection-cache.d.ts

@@ -0,0 +1,36 @@
+/**
+ * 注入缓存管理
+ *
+ * 用于多轮对话中去重已注入的段落，避免重复注入浪费 token。
+ */
+export interface InjectionCacheEntry {
+    sessionId: string;
+    injectedChunks: Set<string>;
+    createdAt: number;
+    updatedAt: number;
+}
+declare class InjectionCacheManager {
+    private caches;
+    private ttl;
+    constructor(ttl?: number);
+    get(sessionId: string): InjectionCacheEntry | undefined;
+    getOrCreate(sessionId: string): InjectionCacheEntry;
+    filterNewChunks(sessionId: string, chunks: Array<{
+        id: string;
+        content: string;
+    }>): Array<{
+        id: string;
+        content: string;
+    }>;
+    markAsInjected(sessionId: string, chunkIds: string[]): void;
+    cleanup(): void;
+    clear(sessionId?: string): void;
+    size(): number;
+    getStats(): {
+        totalSessions: number;
+        totalInjectedChunks: number;
+    };
+}
+export declare const injectionCache: InjectionCacheManager;
+export {};
+//# sourceMappingURL=injection-cache.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"injection-cache.d.ts","sourceRoot":"","sources":["../../src/cache/injection-cache.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAEH,MAAM,WAAW,mBAAmB;IAClC,SAAS,EAAE,MAAM,CAAC;IAClB,cAAc,EAAE,GAAG,CAAC,MAAM,CAAC,CAAC;IAC5B,SAAS,EAAE,MAAM,CAAC;IAClB,SAAS,EAAE,MAAM,CAAC;CACnB;AAKD,cAAM,qBAAqB;IACzB,OAAO,CAAC,MAAM,CAA+C;IAC7D,OAAO,CAAC,GAAG,CAAS;gBAER,GAAG,GAAE,MAAoB;IAIrC,GAAG,CAAC,SAAS,EAAE,MAAM,GAAG,mBAAmB,GAAG,SAAS;IAKvD,WAAW,CAAC,SAAS,EAAE,MAAM,GAAG,mBAAmB;IAiBnD,eAAe,CACb,SAAS,EAAE,MAAM,EACjB,MAAM,EAAE,KAAK,CAAC;QAAE,EAAE,EAAE,MAAM,CAAC;QAAC,OAAO,EAAE,MAAM,CAAA;KAAE,CAAC,GAC7C,KAAK,CAAC;QAAE,EAAE,EAAE,MAAM,CAAC;QAAC,OAAO,EAAE,MAAM,CAAA;KAAE,CAAC;IAazC,cAAc,CAAC,SAAS,EAAE,MAAM,EAAE,QAAQ,EAAE,MAAM,EAAE,GAAG,IAAI;IAW3D,OAAO,IAAI,IAAI;IAqBf,KAAK,CAAC,SAAS,CAAC,EAAE,MAAM,GAAG,IAAI;IAQ/B,IAAI,IAAI,MAAM;IAId,QAAQ,IAAI;QAAE,aAAa,EAAE,MAAM,CAAC;QAAC,mBAAmB,EAAE,MAAM,CAAA;KAAE;CAUnE;AAED,eAAO,MAAM,cAAc,uBAA8B,CAAC"}

package/dist/cache/injection-cache.js

@@ -0,0 +1,90 @@
+const DEFAULT_TTL = 10 * 60 * 1e3;
+const MAX_CACHE_SIZE = 100;
+class InjectionCacheManager {
+  caches = /* @__PURE__ */ new Map();
+  ttl;
+  constructor(ttl = DEFAULT_TTL) {
+    this.ttl = ttl;
+  }
+  get(sessionId) {
+    this.cleanup();
+    return this.caches.get(sessionId);
+  }
+  getOrCreate(sessionId) {
+    this.cleanup();
+    let entry = this.caches.get(sessionId);
+    if (!entry) {
+      entry = {
+        sessionId,
+        injectedChunks: /* @__PURE__ */ new Set(),
+        createdAt: Date.now(),
+        updatedAt: Date.now()
+      };
+      this.caches.set(sessionId, entry);
+    }
+    return entry;
+  }
+  filterNewChunks(sessionId, chunks) {
+    const entry = this.getOrCreate(sessionId);
+    const newChunks = chunks.filter(
+      (chunk) => !entry.injectedChunks.has(chunk.id)
+    );
+    log.debug(
+      `filterNewChunks: session=${sessionId}, incoming=${chunks.length}, new=${newChunks.length}, existing=${entry.injectedChunks.size}`
+    );
+    return newChunks;
+  }
+  markAsInjected(sessionId, chunkIds) {
+    const entry = this.getOrCreate(sessionId);
+    for (const id of chunkIds) {
+      entry.injectedChunks.add(id);
+    }
+    entry.updatedAt = Date.now();
+    log.debug(
+      `markAsInjected: session=${sessionId}, added=${chunkIds.length}, total=${entry.injectedChunks.size}`
+    );
+  }
+  cleanup() {
+    const now = Date.now();
+    for (const [key, entry] of this.caches) {
+      if (now - entry.updatedAt > this.ttl) {
+        this.caches.delete(key);
+      }
+    }
+    if (this.caches.size > MAX_CACHE_SIZE) {
+      const entries = [...this.caches.entries()].sort(
+        (a, b) => a[1].updatedAt - b[1].updatedAt
+      );
+      const toDelete = entries.slice(0, this.caches.size - MAX_CACHE_SIZE);
+      for (const [key] of toDelete) {
+        this.caches.delete(key);
+      }
+    }
+  }
+  clear(sessionId) {
+    if (sessionId) {
+      this.caches.delete(sessionId);
+    } else {
+      this.caches.clear();
+    }
+  }
+  size() {
+    return this.caches.size;
+  }
+  getStats() {
+    let totalInjectedChunks = 0;
+    for (const entry of this.caches.values()) {
+      totalInjectedChunks += entry.injectedChunks.size;
+    }
+    return {
+      totalSessions: this.caches.size,
+      totalInjectedChunks
+    };
+  }
+}
+const injectionCache = new InjectionCacheManager();
+import { createLogger } from "../utils/logger.js";
+const log = createLogger("injection-cache");
+export {
+  injectionCache
+};

package/dist/cache/kv-adapter.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"kv-adapter.d.ts","sourceRoot":"","sources":["../../src/cache/kv-adapter.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EACV,YAAY,EACZ,UAAU,EAEV,eAAe,EACf,eAAe,EAChB,MAAM,YAAY,CAAC;AAOpB,MAAM,WAAW,cAAc;IAC7B,UAAU,CAAC,EAAE,MAAM,CAAC;IACpB,MAAM,CAAC,EAAE,MAAM,CAAC;CACjB;AAKD,qBAAa,cAAe,YAAW,YAAY;IACjD,QAAQ,CAAC,IAAI,mBAAmB;IAChC,OAAO,CAAC,EAAE,CAAc;IACxB,OAAO,CAAC,UAAU,CAAS;IAC3B,OAAO,CAAC,MAAM,CAAS;gBAEX,EAAE,EAAE,WAAW,EAAE,OAAO,CAAC,EAAE,cAAc;IAMrD,OAAO,CAAC,QAAQ;IAIV,GAAG,CAAC,CAAC,EAAE,GAAG,EAAE,MAAM,EAAE,OAAO,CAAC,EAAE,eAAe,GAAG,OAAO,CAAC,UAAU,CAAC,CAAC,CAAC,GAAG,IAAI,CAAC;IA0B7E,GAAG,CAAC,CAAC,EAAE,GAAG,EAAE,MAAM,EAAE,KAAK,EAAE,CAAC,EAAE,OAAO,CAAC,EAAE,eAAe,GAAG,OAAO,CAAC,IAAI,CAAC;IA0BvE,MAAM,CAAC,GAAG,EAAE,MAAM,GAAG,OAAO,CAAC,OAAO,CAAC;IAerC,KAAK,IAAI,OAAO,CAAC,IAAI,CAAC;IAItB,GAAG,CAAC,GAAG,EAAE,MAAM,GAAG,OAAO,CAAC,OAAO,CAAC;IAUlC,WAAW,IAAI,OAAO,CAAC,OAAO,CAAC;IASrC,OAAO,IAAI,IAAI;CAGhB"}
+{"version":3,"file":"kv-adapter.d.ts","sourceRoot":"","sources":["../../src/cache/kv-adapter.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EACV,YAAY,EACZ,UAAU,EAEV,eAAe,EACf,eAAe,EAChB,MAAM,YAAY,CAAC;AAOpB,MAAM,WAAW,cAAc;IAC7B,UAAU,CAAC,EAAE,MAAM,CAAC;IACpB,MAAM,CAAC,EAAE,MAAM,CAAC;CACjB;AAOD,qBAAa,cAAe,YAAW,YAAY;IACjD,QAAQ,CAAC,IAAI,mBAAmB;IAChC,OAAO,CAAC,EAAE,CAAc;IACxB,OAAO,CAAC,UAAU,CAAS;IAC3B,OAAO,CAAC,MAAM,CAAS;gBAEX,EAAE,EAAE,WAAW,EAAE,OAAO,CAAC,EAAE,cAAc;IAMrD,OAAO,CAAC,QAAQ;IAIV,GAAG,CAAC,CAAC,EAAE,GAAG,EAAE,MAAM,EAAE,OAAO,CAAC,EAAE,eAAe,GAAG,OAAO,CAAC,UAAU,CAAC,CAAC,CAAC,GAAG,IAAI,CAAC;IA0B7E,GAAG,CAAC,CAAC,EAAE,GAAG,EAAE,MAAM,EAAE,KAAK,EAAE,CAAC,EAAE,OAAO,CAAC,EAAE,eAAe,GAAG,OAAO,CAAC,IAAI,CAAC;IA0BvE,MAAM,CAAC,GAAG,EAAE,MAAM,GAAG,OAAO,CAAC,OAAO,CAAC;IAerC,KAAK,IAAI,OAAO,CAAC,IAAI,CAAC;IAItB,GAAG,CAAC,GAAG,EAAE,MAAM,GAAG,OAAO,CAAC,OAAO,CAAC;IAUlC,WAAW,IAAI,OAAO,CAAC,OAAO,CAAC;IASrC,OAAO,IAAI,IAAI;CAGhB"}

package/dist/cache/kv-adapter.js

@@ -1,4 +1,5 @@
-const DEFAULT_TTL_SECONDS = 600;
+import { CACHE } from "../constants.js";
+const DEFAULT_TTL_SECONDS = CACHE.DEFAULT_TTL;
 const MIN_TTL_SECONDS = 60;
 class KVCacheAdapter {
   name = "cloudflare-kv";

package/dist/cache/memory-adapter.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"memory-adapter.d.ts","sourceRoot":"","sources":["../../src/cache/memory-adapter.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EACV,YAAY,EACZ,UAAU,EAEV,eAAe,EACf,eAAe,EAChB,MAAM,YAAY,CAAC;AAQpB,MAAM,WAAW,kBAAkB;IACjC,UAAU,CAAC,EAAE,MAAM,CAAC;IACpB,UAAU,CAAC,EAAE,MAAM,CAAC;IACpB,eAAe,CAAC,EAAE,MAAM,CAAC;CAC1B;AAKD,qBAAa,kBAAmB,YAAW,YAAY;IACrD,QAAQ,CAAC,IAAI,YAAY;IACzB,OAAO,CAAC,KAAK,CAA6C;IAC1D,OAAO,CAAC,UAAU,CAAS;IAC3B,OAAO,CAAC,UAAU,CAAS;IAC3B,OAAO,CAAC,YAAY,CAAC,CAAiC;gBAE1C,OAAO,CAAC,EAAE,kBAAkB;IAYlC,GAAG,CAAC,CAAC,EAAE,GAAG,EAAE,MAAM,EAAE,QAAQ,CAAC,EAAE,eAAe,GAAG,OAAO,CAAC,UAAU,CAAC,CAAC,CAAC,GAAG,IAAI,CAAC;IAmB9E,GAAG,CAAC,CAAC,EAAE,GAAG,EAAE,MAAM,EAAE,KAAK,EAAE,CAAC,EAAE,OAAO,CAAC,EAAE,eAAe,GAAG,OAAO,CAAC,IAAI,CAAC;IAsBvE,MAAM,CAAC,GAAG,EAAE,MAAM,GAAG,OAAO,CAAC,OAAO,CAAC;IAIrC,KAAK,IAAI,OAAO,CAAC,IAAI,CAAC;IAItB,GAAG,CAAC,GAAG,EAAE,MAAM,GAAG,OAAO,CAAC,OAAO,CAAC;IAYlC,WAAW,IAAI,OAAO,CAAC,OAAO,CAAC;IAIrC,OAAO,CAAC,OAAO;IASf,OAAO,CAAC,QAAQ;IAYhB,OAAO,IAAI,IAAI;CAOhB"}
+{"version":3,"file":"memory-adapter.d.ts","sourceRoot":"","sources":["../../src/cache/memory-adapter.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EACV,YAAY,EACZ,UAAU,EAEV,eAAe,EACf,eAAe,EAChB,MAAM,YAAY,CAAC;AAQpB,MAAM,WAAW,kBAAkB;IACjC,UAAU,CAAC,EAAE,MAAM,CAAC;IACpB,UAAU,CAAC,EAAE,MAAM,CAAC;IACpB,eAAe,CAAC,EAAE,MAAM,CAAC;CAC1B;AAOD,qBAAa,kBAAmB,YAAW,YAAY;IACrD,QAAQ,CAAC,IAAI,YAAY;IACzB,OAAO,CAAC,KAAK,CAA6C;IAC1D,OAAO,CAAC,UAAU,CAAS;IAC3B,OAAO,CAAC,UAAU,CAAS;IAC3B,OAAO,CAAC,YAAY,CAAC,CAAiC;gBAE1C,OAAO,CAAC,EAAE,kBAAkB;IAYlC,GAAG,CAAC,CAAC,EAAE,GAAG,EAAE,MAAM,EAAE,QAAQ,CAAC,EAAE,eAAe,GAAG,OAAO,CAAC,UAAU,CAAC,CAAC,CAAC,GAAG,IAAI,CAAC;IAmB9E,GAAG,CAAC,CAAC,EAAE,GAAG,EAAE,MAAM,EAAE,KAAK,EAAE,CAAC,EAAE,OAAO,CAAC,EAAE,eAAe,GAAG,OAAO,CAAC,IAAI,CAAC;IAsBvE,MAAM,CAAC,GAAG,EAAE,MAAM,GAAG,OAAO,CAAC,OAAO,CAAC;IAIrC,KAAK,IAAI,OAAO,CAAC,IAAI,CAAC;IAItB,GAAG,CAAC,GAAG,EAAE,MAAM,GAAG,OAAO,CAAC,OAAO,CAAC;IAYlC,WAAW,IAAI,OAAO,CAAC,OAAO,CAAC;IAIrC,OAAO,CAAC,OAAO;IASf,OAAO,CAAC,QAAQ;IAYhB,OAAO,IAAI,IAAI;CAOhB"}

package/dist/cache/memory-adapter.js

@@ -1,5 +1,6 @@
 const DEFAULT_MAX_ENTRIES = 400;
-const DEFAULT_TTL_SECONDS = 600;
+import { CACHE } from "../constants.js";
+const DEFAULT_TTL_SECONDS = CACHE.DEFAULT_TTL;
 class MemoryCacheAdapter {
   name = "memory";
   cache = /* @__PURE__ */ new Map();

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

@@ -1,12 +1,13 @@
-import type { CacheAdapter } from './types.js';
-import type { ArticleContext, ProjectContext } from '../search/types.js';
-import type { PublicQuestionType } from './global-cache.js';
+import type { CacheAdapter } from "./types.js";
+import type { ArticleContext, ProjectContext, SourceSelection } from "../search/types.js";
+import type { PublicQuestionType } from "./global-cache.js";
 export interface CachedAIResponse {
     query: string;
     thinking?: string;
     response: string;
     articles: ArticleContext[];
     projects: ProjectContext[];
+    sources: SourceSelection[];
     lang: string;
     model?: string;
     updatedAt: number;
@@ -24,22 +25,26 @@ export declare function getResponseCacheConfig(env: Record<string, unknown>): Re
 export declare function buildResponseCacheKey(type: PublicQuestionType, context?: {
     articleSlug?: string;
     lang?: string;
+    queryKey?: string;
 }): string;
 export declare function getResponseCache(cache: CacheAdapter, type: PublicQuestionType, context?: {
     articleSlug?: string;
     lang?: string;
+    queryKey?: string;
 }): Promise<CachedAIResponse | null>;
 export declare function setResponseCache(cache: CacheAdapter, type: PublicQuestionType, data: CachedAIResponse, ttl: number, context?: {
     articleSlug?: string;
     lang?: string;
+    queryKey?: string;
 }): Promise<void>;
 export declare function deleteResponseCache(cache: CacheAdapter, type: PublicQuestionType, context?: {
     articleSlug?: string;
     lang?: string;
+    queryKey?: string;
 }): Promise<boolean>;
 export interface PlaybackChunk {
-    type: 'thinking' | 'response';
+    type: "thinking" | "response";
     text: string;
 }
-export declare function createResponsePlaybackGenerator(cached: CachedAIResponse, config: Pick<ResponseCacheConfig, 'playbackDelayMs' | 'chunkSize' | 'thinkingPlaybackDelayMs'>): AsyncGenerator<PlaybackChunk, void, unknown>;
+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

@@ -1 +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"}
+{"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,EACV,cAAc,EACd,cAAc,EACd,eAAe,EAChB,MAAM,oBAAoB,CAAC;AAC5B,OAAO,KAAK,EAAE,kBAAkB,EAAE,MAAM,mBAAmB,CAAC;AAK5D,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,OAAO,EAAE,eAAe,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,CACpC,GAAG,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,GAC3B,mBAAmB,CAyBrB;AAID,wBAAgB,qBAAqB,CACnC,IAAI,EAAE,kBAAkB,EACxB,OAAO,CAAC,EAAE;IAAE,WAAW,CAAC,EAAE,MAAM,CAAC;IAAC,IAAI,CAAC,EAAE,MAAM,CAAC;IAAC,QAAQ,CAAC,EAAE,MAAM,CAAA;CAAE,GACnE,MAAM,CAMR;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,CAAC;IAAC,QAAQ,CAAC,EAAE,MAAM,CAAA;CAAE,GACnE,OAAO,CAAC,gBAAgB,GAAG,IAAI,CAAC,CAOlC;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,CAAC;IAAC,QAAQ,CAAC,EAAE,MAAM,CAAA;CAAE,GACnE,OAAO,CAAC,IAAI,CAAC,CAMf;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,CAAC;IAAC,QAAQ,CAAC,EAAE,MAAM,CAAA;CAAE,GACnE,OAAO,CAAC,OAAO,CAAC,CAIlB;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,CACV,mBAAmB,EACnB,iBAAiB,GAAG,WAAW,GAAG,yBAAyB,CAC5D,GACA,cAAc,CAAC,aAAa,EAAE,IAAI,EAAE,OAAO,CAAC,CA8B9C"}

package/dist/cache/response-cache.js

@@ -1,3 +1,5 @@
+import { createLogger } from "../utils/logger.js";
+const log = createLogger("response-cache");
 const DEFAULT_RESPONSE_CACHE_CONFIG = {
   enabled: false,
   defaultTtl: 3600,
@@ -22,11 +24,11 @@ function getResponseCacheConfig(env) {
     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)
+    enabled: parseBool(env.AI_CACHE_ENABLED),
+    defaultTtl: parseNum(env.AI_CACHE_TTL, 3600),
+    playbackDelayMs: parseNum(env.AI_CACHE_PLAYBACK_DELAY, 20),
+    chunkSize: parseNum(env.AI_CACHE_CHUNK_SIZE, 15),
+    thinkingPlaybackDelayMs: parseNum(env.AI_CACHE_THINKING_DELAY, 5)
   };
 }
 const RESPONSE_CACHE_PREFIX = "response";
@@ -34,19 +36,27 @@ function buildResponseCacheKey(type, context) {
   const parts = [RESPONSE_CACHE_PREFIX, type];
   if (context?.articleSlug) parts.push(context.articleSlug);
   if (context?.lang) parts.push(context.lang);
+  if (context?.queryKey) parts.push(context.queryKey);
   return parts.join(":");
 }
 async function getResponseCache(cache, type, context) {
   const key = buildResponseCacheKey(type, context);
   const entry = await cache.get(key);
+  log.debug(
+    `getResponseCache: key=${key}, hit=${Boolean(entry?.value)}, adapter=${cache.name}`
+  );
   return entry?.value ?? null;
 }
 async function setResponseCache(cache, type, data, ttl, context) {
   const key = buildResponseCacheKey(type, context);
   await cache.set(key, data, { ttl });
+  log.debug(
+    `setResponseCache: key=${key}, articles=${data.articles.length}, projects=${data.projects.length}, sources=${data.sources.length}, ttl=${ttl}, adapter=${cache.name}`
+  );
 }
 async function deleteResponseCache(cache, type, context) {
   const key = buildResponseCacheKey(type, context);
+  log.debug(`deleteResponseCache: key=${key}, adapter=${cache.name}`);
   return cache.delete(key);
 }
 function createResponsePlaybackGenerator(cached, config) {
@@ -59,7 +69,9 @@ function createResponsePlaybackGenerator(cached, config) {
         if (chunk) {
           yield { type: "thinking", text: chunk };
           if (i < thinkingChunks - 1 && thinkingPlaybackDelayMs > 0) {
-            await new Promise((resolve) => setTimeout(resolve, thinkingPlaybackDelayMs));
+            await new Promise(
+              (resolve) => setTimeout(resolve, thinkingPlaybackDelayMs)
+            );
           }
         }
       }