@bowenqt/qiniu-ai-sdk 0.15.0 → 0.16.0

package/dist/ai/internal-types.d.ts.map

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

package/dist/ai/internal-types.js

@@ -7,6 +7,8 @@ Object.defineProperty(exports, "__esModule", { value: true });
 exports.stripMeta = stripMeta;
 exports.isDroppable = isDroppable;
 exports.getSkillId = getSkillId;
+exports.getSummaryId = getSummaryId;
+exports.getDroppableId = getDroppableId;
 /**
  * Strip internal metadata from messages before API call.
  */
@@ -25,4 +27,17 @@ function isDroppable(message) {
 function getSkillId(message) {
     return message._meta?.skillId;
 }
+/**
+ * Get summary ID from message.
+ */
+function getSummaryId(message) {
+    return message._meta?.summaryId;
+}
+/**
+ * Check if a message can be compacted (has skill or summary ID).
+ * Used by memory-node to determine which droppable messages to remove.
+ */
+function getDroppableId(message) {
+    return message._meta?.skillId ?? message._meta?.summaryId;
+}
 //# sourceMappingURL=internal-types.js.map

package/dist/ai/internal-types.js.map

@@ -1 +1 @@
-{"version":3,"file":"internal-types.js","sourceRoot":"","sources":["../../src/ai/internal-types.ts"],"names":[],"mappings":";AAAA;;;GAGG;;AAyGH,8BAEC;AAKD,kCAEC;AAKD,gCAEC;AAnBD;;GAEG;AACH,SAAgB,SAAS,CAAC,QAA2B;IACjD,OAAO,QAAQ,CAAC,GAAG,CAAC,CAAC,EAAE,KAAK,EAAE,GAAG,GAAG,EAAE,EAAE,EAAE,CAAC,GAAkB,CAAC,CAAC;AACnE,CAAC;AAED;;GAEG;AACH,SAAgB,WAAW,CAAC,OAAwB;IAChD,OAAO,OAAO,CAAC,KAAK,EAAE,SAAS,KAAK,IAAI,CAAC;AAC7C,CAAC;AAED;;GAEG;AACH,SAAgB,UAAU,CAAC,OAAwB;IAC/C,OAAO,OAAO,CAAC,KAAK,EAAE,OAAO,CAAC;AAClC,CAAC"}
+{"version":3,"file":"internal-types.js","sourceRoot":"","sources":["../../src/ai/internal-types.ts"],"names":[],"mappings":";AAAA;;;GAGG;;AA2GH,8BAEC;AAKD,kCAEC;AAKD,gCAEC;AAKD,oCAEC;AAMD,wCAEC;AAlCD;;GAEG;AACH,SAAgB,SAAS,CAAC,QAA2B;IACjD,OAAO,QAAQ,CAAC,GAAG,CAAC,CAAC,EAAE,KAAK,EAAE,GAAG,GAAG,EAAE,EAAE,EAAE,CAAC,GAAkB,CAAC,CAAC;AACnE,CAAC;AAED;;GAEG;AACH,SAAgB,WAAW,CAAC,OAAwB;IAChD,OAAO,OAAO,CAAC,KAAK,EAAE,SAAS,KAAK,IAAI,CAAC;AAC7C,CAAC;AAED;;GAEG;AACH,SAAgB,UAAU,CAAC,OAAwB;IAC/C,OAAO,OAAO,CAAC,KAAK,EAAE,OAAO,CAAC;AAClC,CAAC;AAED;;GAEG;AACH,SAAgB,YAAY,CAAC,OAAwB;IACjD,OAAO,OAAO,CAAC,KAAK,EAAE,SAAS,CAAC;AACpC,CAAC;AAED;;;GAGG;AACH,SAAgB,cAAc,CAAC,OAAwB;IACnD,OAAO,OAAO,CAAC,KAAK,EAAE,OAAO,IAAI,OAAO,CAAC,KAAK,EAAE,SAAS,CAAC;AAC9D,CAAC"}

package/dist/ai/internal-types.mjs

@@ -20,4 +20,17 @@ export function isDroppable(message) {
 export function getSkillId(message) {
     return message._meta?.skillId;
 }
+/**
+ * Get summary ID from message.
+ */
+export function getSummaryId(message) {
+    return message._meta?.summaryId;
+}
+/**
+ * Check if a message can be compacted (has skill or summary ID).
+ * Used by memory-node to determine which droppable messages to remove.
+ */
+export function getDroppableId(message) {
+    return message._meta?.skillId ?? message._meta?.summaryId;
+}
 //# sourceMappingURL=internal-types.js.map

package/dist/ai/memory/index.d.ts

@@ -0,0 +1,147 @@
+/**
+ * Memory Manager for Agent conversations.
+ * Provides short-term and long-term memory management with automatic summarization.
+ *
+ * @example
+ * ```typescript
+ * import { MemoryManager, InMemoryVectorStore } from '@bowenqt/qiniu-ai-sdk';
+ *
+ * const memory = new MemoryManager({
+ *     shortTerm: { maxMessages: 20 },
+ *     summarizer: {
+ *         enabled: true,
+ *         threshold: 50,
+ *         client,
+ *         model: 'gemini-2.5-flash',
+ *     },
+ * });
+ *
+ * // Apply memory to messages before sending to LLM
+ * const processedMessages = await memory.process(messages, options);
+ * ```
+ */
+import type { InternalMessage, MessageMeta } from '../internal-types';
+/** Short-term memory configuration */
+export interface ShortTermMemoryConfig {
+    /** Maximum number of recent messages to keep */
+    maxMessages?: number;
+}
+/** Summarizer configuration */
+export interface SummarizerConfig {
+    /** Enable automatic summarization */
+    enabled: boolean;
+    /** Message count threshold to trigger summarization */
+    threshold?: number;
+    /** System prompt for summarization */
+    systemPrompt?: string;
+}
+/** Vector store interface for long-term memory */
+export interface VectorStore {
+    /** Add documents to the store */
+    add(documents: VectorDocument[]): Promise<void>;
+    /** Search for similar documents */
+    search(query: string, limit?: number): Promise<VectorDocument[]>;
+    /** Clear all documents */
+    clear(): Promise<void>;
+}
+/** Document for vector storage */
+export interface VectorDocument {
+    id: string;
+    content: string;
+    metadata?: Record<string, unknown>;
+    embedding?: number[];
+}
+/** Long-term memory configuration */
+export interface LongTermMemoryConfig {
+    /** Vector store implementation */
+    store: VectorStore;
+    /** Number of documents to retrieve */
+    retrieveLimit?: number;
+}
+/** Memory manager configuration */
+export interface MemoryConfig {
+    /** Short-term memory (sliding window) */
+    shortTerm?: ShortTermMemoryConfig;
+    /** Long-term memory (vector store) */
+    longTerm?: LongTermMemoryConfig;
+    /** Automatic summarization */
+    summarizer?: SummarizerConfig;
+}
+/** Memory processing options */
+export interface MemoryProcessOptions {
+    /** Thread ID for memory isolation */
+    threadId?: string;
+    /** Whether to generate summary if threshold exceeded */
+    generateSummary?: boolean;
+}
+/** Memory processing result */
+export interface MemoryProcessResult {
+    /** Processed messages ready for LLM */
+    messages: InternalMessage[];
+    /** Whether summarization was triggered */
+    summarized: boolean;
+    /** Generated summary (if any) */
+    summary?: string;
+    /** Number of messages dropped */
+    droppedCount: number;
+}
+/** Summary message metadata */
+export interface SummaryMeta extends MessageMeta {
+    summaryId: string;
+    droppable: true;
+}
+/**
+ * Simple in-memory vector store for testing and small-scale use.
+ * Uses cosine similarity for search (requires embeddings).
+ */
+export declare class InMemoryVectorStore implements VectorStore {
+    private documents;
+    add(documents: VectorDocument[]): Promise<void>;
+    search(query: string, limit?: number): Promise<VectorDocument[]>;
+    clear(): Promise<void>;
+    private textSimilarity;
+}
+/**
+ * Memory manager for agent conversations.
+ * Handles short-term (sliding window) and long-term (vector) memory.
+ */
+export declare class MemoryManager {
+    private config;
+    private summaries;
+    constructor(config?: MemoryConfig);
+    /**
+     * Process messages with memory management.
+     * Applies summarization, trimming, and long-term retrieval.
+     */
+    process(messages: InternalMessage[], options?: MemoryProcessOptions): Promise<MemoryProcessResult>;
+    /**
+     * Generate summary from messages.
+     * Override this method for custom summarization logic.
+     */
+    protected generateSummary(messages: InternalMessage[], _threadId: string): Promise<string>;
+    /**
+     * Store messages to long-term memory.
+     */
+    persist(messages: InternalMessage[], threadId: string): Promise<void>;
+    /**
+     * Clear memory for a thread.
+     */
+    clearThread(threadId: string): void;
+    /**
+     * Clear all memory.
+     */
+    clearAll(): Promise<void>;
+    /**
+     * Get current summary for a thread.
+     */
+    getSummary(threadId: string): string | undefined;
+    /**
+     * Set summary for a thread (manual override).
+     */
+    setSummary(threadId: string, summary: string): void;
+}
+/**
+ * Check if a message is droppable (skill or summary).
+ */
+export declare function isDroppable(message: InternalMessage): boolean;
+//# sourceMappingURL=index.d.ts.map

package/dist/ai/memory/index.d.ts.map

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

package/dist/ai/memory/index.js

@@ -0,0 +1,240 @@
+"use strict";
+/**
+ * Memory Manager for Agent conversations.
+ * Provides short-term and long-term memory management with automatic summarization.
+ *
+ * @example
+ * ```typescript
+ * import { MemoryManager, InMemoryVectorStore } from '@bowenqt/qiniu-ai-sdk';
+ *
+ * const memory = new MemoryManager({
+ *     shortTerm: { maxMessages: 20 },
+ *     summarizer: {
+ *         enabled: true,
+ *         threshold: 50,
+ *         client,
+ *         model: 'gemini-2.5-flash',
+ *     },
+ * });
+ *
+ * // Apply memory to messages before sending to LLM
+ * const processedMessages = await memory.process(messages, options);
+ * ```
+ */
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.MemoryManager = exports.InMemoryVectorStore = void 0;
+exports.isDroppable = isDroppable;
+// ============================================================================
+// In-Memory Vector Store (Simple Implementation)
+// ============================================================================
+/**
+ * Simple in-memory vector store for testing and small-scale use.
+ * Uses cosine similarity for search (requires embeddings).
+ */
+class InMemoryVectorStore {
+    constructor() {
+        this.documents = [];
+    }
+    async add(documents) {
+        this.documents.push(...documents);
+    }
+    async search(query, limit = 5) {
+        // Simple text search (no embeddings)
+        // In production, use proper embeddings and vector similarity
+        const queryLower = query.toLowerCase();
+        const scored = this.documents.map(doc => ({
+            doc,
+            score: this.textSimilarity(queryLower, doc.content.toLowerCase()),
+        }));
+        return scored
+            .sort((a, b) => b.score - a.score)
+            .slice(0, limit)
+            .map(s => s.doc);
+    }
+    async clear() {
+        this.documents = [];
+    }
+    textSimilarity(a, b) {
+        // Simple word overlap score
+        const wordsA = new Set(a.split(/\s+/));
+        const wordsB = new Set(b.split(/\s+/));
+        let overlap = 0;
+        for (const word of wordsA) {
+            if (wordsB.has(word))
+                overlap++;
+        }
+        return overlap / Math.max(wordsA.size, wordsB.size, 1);
+    }
+}
+exports.InMemoryVectorStore = InMemoryVectorStore;
+// ============================================================================
+// Memory Manager
+// ============================================================================
+/**
+ * Memory manager for agent conversations.
+ * Handles short-term (sliding window) and long-term (vector) memory.
+ */
+class MemoryManager {
+    constructor(config = {}) {
+        this.summaries = new Map(); // threadId -> summary
+        this.config = {
+            shortTerm: { maxMessages: 50, ...config.shortTerm },
+            ...config,
+        };
+    }
+    /**
+     * Process messages with memory management.
+     * Applies summarization, trimming, and long-term retrieval.
+     */
+    async process(messages, options = {}) {
+        const { threadId = 'default', generateSummary = true } = options;
+        let processedMessages = [...messages];
+        let summarized = false;
+        let summary;
+        let droppedCount = 0;
+        // 1. Check if summarization is needed
+        const threshold = this.config.summarizer?.threshold ?? 50;
+        if (this.config.summarizer?.enabled &&
+            generateSummary &&
+            messages.length > threshold) {
+            // Generate summary from older messages
+            const messagesToSummarize = messages.slice(0, messages.length - Math.floor(threshold / 2));
+            summary = await this.generateSummary(messagesToSummarize, threadId);
+            this.summaries.set(threadId, summary);
+            summarized = true;
+        }
+        // 2. Apply short-term memory (sliding window)
+        const maxMessages = this.config.shortTerm?.maxMessages ?? 50;
+        if (processedMessages.length > maxMessages) {
+            droppedCount = processedMessages.length - maxMessages;
+            processedMessages = processedMessages.slice(-maxMessages);
+        }
+        // 3. Inject summary if available
+        const existingSummary = this.summaries.get(threadId);
+        if (existingSummary) {
+            const summaryMessage = {
+                role: 'system',
+                content: `[CONVERSATION SUMMARY]\n${existingSummary}`,
+                _meta: {
+                    summaryId: `summary_${threadId}`,
+                    droppable: true,
+                    priority: 100, // Low priority (drop first)
+                },
+            };
+            // Insert after first system message
+            const firstSystemIdx = processedMessages.findIndex(m => m.role === 'system');
+            if (firstSystemIdx >= 0) {
+                processedMessages.splice(firstSystemIdx + 1, 0, summaryMessage);
+            }
+            else {
+                processedMessages.unshift(summaryMessage);
+            }
+        }
+        // 4. Long-term retrieval (if configured)
+        if (this.config.longTerm) {
+            const lastUserMessage = [...messages].reverse().find(m => m.role === 'user');
+            if (lastUserMessage && typeof lastUserMessage.content === 'string') {
+                const retrieved = await this.config.longTerm.store.search(lastUserMessage.content, this.config.longTerm.retrieveLimit ?? 3);
+                if (retrieved.length > 0) {
+                    const contextMessage = {
+                        role: 'system',
+                        content: `[RELEVANT CONTEXT]\n${retrieved.map(d => d.content).join('\n---\n')}`,
+                        _meta: {
+                            summaryId: `context_${threadId}`,
+                            droppable: true,
+                            priority: 90,
+                        },
+                    };
+                    // Insert after summary (or first system)
+                    const insertIdx = processedMessages.findIndex(m => m._meta?.summaryId?.startsWith('summary_'));
+                    if (insertIdx >= 0) {
+                        processedMessages.splice(insertIdx + 1, 0, contextMessage);
+                    }
+                    else {
+                        const firstSystemIdx = processedMessages.findIndex(m => m.role === 'system');
+                        processedMessages.splice(firstSystemIdx + 1, 0, contextMessage);
+                    }
+                }
+            }
+        }
+        return {
+            messages: processedMessages,
+            summarized,
+            summary,
+            droppedCount,
+        };
+    }
+    /**
+     * Generate summary from messages.
+     * Override this method for custom summarization logic.
+     */
+    async generateSummary(messages, _threadId) {
+        // Default: Simple concatenation (override for LLM-based summarization)
+        const userMessages = messages
+            .filter(m => m.role === 'user' && typeof m.content === 'string')
+            .map(m => m.content);
+        const assistantMessages = messages
+            .filter(m => m.role === 'assistant' && typeof m.content === 'string')
+            .map(m => m.content);
+        return [
+            `User discussed: ${userMessages.slice(0, 3).join(', ').slice(0, 200)}...`,
+            `Assistant covered: ${assistantMessages.slice(0, 3).join(', ').slice(0, 200)}...`,
+        ].join('\n');
+    }
+    /**
+     * Store messages to long-term memory.
+     */
+    async persist(messages, threadId) {
+        if (!this.config.longTerm)
+            return;
+        const documents = messages
+            .filter(m => typeof m.content === 'string' && m.content.length > 20)
+            .map((m, i) => ({
+            id: `${threadId}_${Date.now()}_${i}`,
+            content: m.content,
+            metadata: { role: m.role, threadId },
+        }));
+        await this.config.longTerm.store.add(documents);
+    }
+    /**
+     * Clear memory for a thread.
+     */
+    clearThread(threadId) {
+        this.summaries.delete(threadId);
+    }
+    /**
+     * Clear all memory.
+     */
+    async clearAll() {
+        this.summaries.clear();
+        if (this.config.longTerm) {
+            await this.config.longTerm.store.clear();
+        }
+    }
+    /**
+     * Get current summary for a thread.
+     */
+    getSummary(threadId) {
+        return this.summaries.get(threadId);
+    }
+    /**
+     * Set summary for a thread (manual override).
+     */
+    setSummary(threadId, summary) {
+        this.summaries.set(threadId, summary);
+    }
+}
+exports.MemoryManager = MemoryManager;
+// ============================================================================
+// Helper: Check if message is droppable
+// ============================================================================
+/**
+ * Check if a message is droppable (skill or summary).
+ */
+function isDroppable(message) {
+    const meta = message._meta;
+    if (!meta?.droppable)
+        return false;
+    return meta.skillId != null || meta.summaryId != null;
+}
+//# sourceMappingURL=index.js.map

package/dist/ai/memory/index.js.map

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