ai.matey.middleware 0.2.0

package/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2025 AI Matey Contributors
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all
+copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+SOFTWARE.

package/dist/cjs/caching.js

@@ -0,0 +1,226 @@
+"use strict";
+/**
+ * Caching Middleware
+ *
+ * Caches responses with TTL-based expiration and LRU eviction.
+ *
+ * @module
+ */
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.InMemoryCacheStorage = void 0;
+exports.createCachingMiddleware = createCachingMiddleware;
+const crypto_1 = require("crypto");
+// ============================================================================
+// Default Key Generator
+// ============================================================================
+/**
+ * Default cache key generator.
+ *
+ * Generates cache key from model, messages, and parameters.
+ * Excludes metadata and streaming flag.
+ */
+function defaultKeyGenerator(request) {
+    // Create a stable cache key from request
+    const cacheableData = {
+        model: request.parameters?.model,
+        messages: request.messages,
+        temperature: request.parameters?.temperature,
+        maxTokens: request.parameters?.maxTokens,
+        topP: request.parameters?.topP,
+        topK: request.parameters?.topK,
+        stopSequences: request.parameters?.stopSequences,
+        tools: request.tools,
+        toolChoice: request.toolChoice,
+    };
+    // Generate hash
+    const json = JSON.stringify(cacheableData);
+    return (0, crypto_1.createHash)('sha256').update(json).digest('hex');
+}
+/**
+ * In-memory cache storage with LRU eviction.
+ */
+class InMemoryCacheStorage {
+    cache = new Map();
+    accessOrder = [];
+    maxSize;
+    constructor(maxSize = 1000) {
+        this.maxSize = maxSize;
+    }
+    get(key) {
+        const entry = this.cache.get(key);
+        if (!entry) {
+            return Promise.resolve(undefined);
+        }
+        // Check if expired
+        if (Date.now() > entry.expiresAt) {
+            this.cache.delete(key);
+            this.removeFromAccessOrder(key);
+            return Promise.resolve(undefined);
+        }
+        // Update access order (LRU)
+        this.updateAccessOrder(key);
+        return Promise.resolve(entry.value);
+    }
+    set(key, value, ttl = 3600000) {
+        // Evict if at max size
+        if (this.cache.size >= this.maxSize && !this.cache.has(key)) {
+            this.evictLRU();
+        }
+        // Store entry
+        this.cache.set(key, {
+            value,
+            expiresAt: Date.now() + ttl,
+        });
+        // Update access order
+        this.updateAccessOrder(key);
+        return Promise.resolve();
+    }
+    has(key) {
+        const entry = this.cache.get(key);
+        if (!entry) {
+            return Promise.resolve(false);
+        }
+        // Check if expired
+        if (Date.now() > entry.expiresAt) {
+            this.cache.delete(key);
+            this.removeFromAccessOrder(key);
+            return Promise.resolve(false);
+        }
+        return Promise.resolve(true);
+    }
+    delete(key) {
+        this.removeFromAccessOrder(key);
+        return Promise.resolve(this.cache.delete(key));
+    }
+    clear() {
+        this.cache.clear();
+        this.accessOrder = [];
+        return Promise.resolve();
+    }
+    /**
+     * Get cache statistics.
+     */
+    getStats() {
+        return {
+            size: this.cache.size,
+            maxSize: this.maxSize,
+        };
+    }
+    /**
+     * Update LRU access order.
+     */
+    updateAccessOrder(key) {
+        // Remove from current position
+        this.removeFromAccessOrder(key);
+        // Add to end (most recently used)
+        this.accessOrder.push(key);
+    }
+    /**
+     * Remove key from access order.
+     */
+    removeFromAccessOrder(key) {
+        const index = this.accessOrder.indexOf(key);
+        if (index !== -1) {
+            this.accessOrder.splice(index, 1);
+        }
+    }
+    /**
+     * Evict least recently used entry.
+     */
+    evictLRU() {
+        if (this.accessOrder.length === 0) {
+            return;
+        }
+        // Get least recently used key (first in array)
+        const lruKey = this.accessOrder[0];
+        if (lruKey) {
+            this.cache.delete(lruKey);
+            this.accessOrder.shift();
+        }
+    }
+    /**
+     * Clean up expired entries.
+     */
+    cleanup() {
+        const now = Date.now();
+        const expiredKeys = [];
+        // Use Array.from to avoid iteration issues
+        for (const [key, entry] of Array.from(this.cache.entries())) {
+            if (now > entry.expiresAt) {
+                expiredKeys.push(key);
+            }
+        }
+        for (const key of expiredKeys) {
+            this.cache.delete(key);
+            this.removeFromAccessOrder(key);
+        }
+    }
+}
+exports.InMemoryCacheStorage = InMemoryCacheStorage;
+// ============================================================================
+// Middleware Factory
+// ============================================================================
+/**
+ * Create caching middleware.
+ *
+ * Caches responses with TTL-based expiration and LRU eviction.
+ *
+ * @param config Caching configuration
+ * @returns Caching middleware
+ *
+ * @example
+ * ```typescript
+ * const caching = createCachingMiddleware({
+ *   ttl: 3600000, // 1 hour
+ *   maxSize: 1000,
+ *   cacheStreaming: false
+ * });
+ *
+ * bridge.use(caching);
+ * ```
+ */
+function createCachingMiddleware(config = {}) {
+    const { keyGenerator = defaultKeyGenerator, ttl = 3600000, // 1 hour
+    maxSize = 1000, storage = new InMemoryCacheStorage(maxSize), cacheStreaming = false, } = config;
+    return async (context, next) => {
+        // Skip caching for streaming requests unless explicitly enabled
+        if (context.request.stream && !cacheStreaming) {
+            return next();
+        }
+        // Generate cache key
+        const cacheKey = keyGenerator(context.request);
+        // Check cache
+        const cachedResponse = await storage.get(cacheKey);
+        if (cachedResponse) {
+            // Cache hit - add cache metadata
+            return {
+                ...cachedResponse,
+                metadata: {
+                    ...cachedResponse.metadata,
+                    custom: {
+                        ...cachedResponse.metadata.custom,
+                        cacheHit: true,
+                        cacheKey,
+                    },
+                },
+            };
+        }
+        // Cache miss - call next middleware/handler
+        const response = await next();
+        // Store in cache
+        await storage.set(cacheKey, response, ttl);
+        // Add cache metadata
+        return {
+            ...response,
+            metadata: {
+                ...response.metadata,
+                custom: {
+                    ...response.metadata.custom,
+                    cacheHit: false,
+                    cacheKey,
+                },
+            },
+        };
+    };
+}
+//# sourceMappingURL=caching.js.map

package/dist/cjs/caching.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"caching.js","sourceRoot":"","sources":["../../src/caching.ts"],"names":[],"mappings":";AAAA;;;;;;GAMG;;;AA6PH,0DAuDC;AAhTD,mCAAoC;AAyCpC,+EAA+E;AAC/E,wBAAwB;AACxB,+EAA+E;AAE/E;;;;;GAKG;AACH,SAAS,mBAAmB,CAAC,OAAsB;IACjD,yCAAyC;IACzC,MAAM,aAAa,GAAG;QACpB,KAAK,EAAE,OAAO,CAAC,UAAU,EAAE,KAAK;QAChC,QAAQ,EAAE,OAAO,CAAC,QAAQ;QAC1B,WAAW,EAAE,OAAO,CAAC,UAAU,EAAE,WAAW;QAC5C,SAAS,EAAE,OAAO,CAAC,UAAU,EAAE,SAAS;QACxC,IAAI,EAAE,OAAO,CAAC,UAAU,EAAE,IAAI;QAC9B,IAAI,EAAE,OAAO,CAAC,UAAU,EAAE,IAAI;QAC9B,aAAa,EAAE,OAAO,CAAC,UAAU,EAAE,aAAa;QAChD,KAAK,EAAE,OAAO,CAAC,KAAK;QACpB,UAAU,EAAE,OAAO,CAAC,UAAU;KAC/B,CAAC;IAEF,gBAAgB;IAChB,MAAM,IAAI,GAAG,IAAI,CAAC,SAAS,CAAC,aAAa,CAAC,CAAC;IAC3C,OAAO,IAAA,mBAAU,EAAC,QAAQ,CAAC,CAAC,MAAM,CAAC,IAAI,CAAC,CAAC,MAAM,CAAC,KAAK,CAAC,CAAC;AACzD,CAAC;AAWD;;GAEG;AACH,MAAa,oBAAoB;IACvB,KAAK,GAAG,IAAI,GAAG,EAAsB,CAAC;IACtC,WAAW,GAAa,EAAE,CAAC;IAC3B,OAAO,CAAS;IAExB,YAAY,UAAkB,IAAI;QAChC,IAAI,CAAC,OAAO,GAAG,OAAO,CAAC;IACzB,CAAC;IAED,GAAG,CAAC,GAAW;QACb,MAAM,KAAK,GAAG,IAAI,CAAC,KAAK,CAAC,GAAG,CAAC,GAAG,CAAC,CAAC;QAElC,IAAI,CAAC,KAAK,EAAE,CAAC;YACX,OAAO,OAAO,CAAC,OAAO,CAAC,SAAS,CAAC,CAAC;QACpC,CAAC;QAED,mBAAmB;QACnB,IAAI,IAAI,CAAC,GAAG,EAAE,GAAG,KAAK,CAAC,SAAS,EAAE,CAAC;YACjC,IAAI,CAAC,KAAK,CAAC,MAAM,CAAC,GAAG,CAAC,CAAC;YACvB,IAAI,CAAC,qBAAqB,CAAC,GAAG,CAAC,CAAC;YAChC,OAAO,OAAO,CAAC,OAAO,CAAC,SAAS,CAAC,CAAC;QACpC,CAAC;QAED,4BAA4B;QAC5B,IAAI,CAAC,iBAAiB,CAAC,GAAG,CAAC,CAAC;QAE5B,OAAO,OAAO,CAAC,OAAO,CAAC,KAAK,CAAC,KAAK,CAAC,CAAC;IACtC,CAAC;IAED,GAAG,CAAC,GAAW,EAAE,KAAqB,EAAE,MAAc,OAAO;QAC3D,uBAAuB;QACvB,IAAI,IAAI,CAAC,KAAK,CAAC,IAAI,IAAI,IAAI,CAAC,OAAO,IAAI,CAAC,IAAI,CAAC,KAAK,CAAC,GAAG,CAAC,GAAG,CAAC,EAAE,CAAC;YAC5D,IAAI,CAAC,QAAQ,EAAE,CAAC;QAClB,CAAC;QAED,cAAc;QACd,IAAI,CAAC,KAAK,CAAC,GAAG,CAAC,GAAG,EAAE;YAClB,KAAK;YACL,SAAS,EAAE,IAAI,CAAC,GAAG,EAAE,GAAG,GAAG;SAC5B,CAAC,CAAC;QAEH,sBAAsB;QACtB,IAAI,CAAC,iBAAiB,CAAC,GAAG,CAAC,CAAC;QAE5B,OAAO,OAAO,CAAC,OAAO,EAAE,CAAC;IAC3B,CAAC;IAED,GAAG,CAAC,GAAW;QACb,MAAM,KAAK,GAAG,IAAI,CAAC,KAAK,CAAC,GAAG,CAAC,GAAG,CAAC,CAAC;QAElC,IAAI,CAAC,KAAK,EAAE,CAAC;YACX,OAAO,OAAO,CAAC,OAAO,CAAC,KAAK,CAAC,CAAC;QAChC,CAAC;QAED,mBAAmB;QACnB,IAAI,IAAI,CAAC,GAAG,EAAE,GAAG,KAAK,CAAC,SAAS,EAAE,CAAC;YACjC,IAAI,CAAC,KAAK,CAAC,MAAM,CAAC,GAAG,CAAC,CAAC;YACvB,IAAI,CAAC,qBAAqB,CAAC,GAAG,CAAC,CAAC;YAChC,OAAO,OAAO,CAAC,OAAO,CAAC,KAAK,CAAC,CAAC;QAChC,CAAC;QAED,OAAO,OAAO,CAAC,OAAO,CAAC,IAAI,CAAC,CAAC;IAC/B,CAAC;IAED,MAAM,CAAC,GAAW;QAChB,IAAI,CAAC,qBAAqB,CAAC,GAAG,CAAC,CAAC;QAChC,OAAO,OAAO,CAAC,OAAO,CAAC,IAAI,CAAC,KAAK,CAAC,MAAM,CAAC,GAAG,CAAC,CAAC,CAAC;IACjD,CAAC;IAED,KAAK;QACH,IAAI,CAAC,KAAK,CAAC,KAAK,EAAE,CAAC;QACnB,IAAI,CAAC,WAAW,GAAG,EAAE,CAAC;QACtB,OAAO,OAAO,CAAC,OAAO,EAAE,CAAC;IAC3B,CAAC;IAED;;OAEG;IACH,QAAQ;QACN,OAAO;YACL,IAAI,EAAE,IAAI,CAAC,KAAK,CAAC,IAAI;YACrB,OAAO,EAAE,IAAI,CAAC,OAAO;SACtB,CAAC;IACJ,CAAC;IAED;;OAEG;IACK,iBAAiB,CAAC,GAAW;QACnC,+BAA+B;QAC/B,IAAI,CAAC,qBAAqB,CAAC,GAAG,CAAC,CAAC;QAEhC,kCAAkC;QAClC,IAAI,CAAC,WAAW,CAAC,IAAI,CAAC,GAAG,CAAC,CAAC;IAC7B,CAAC;IAED;;OAEG;IACK,qBAAqB,CAAC,GAAW;QACvC,MAAM,KAAK,GAAG,IAAI,CAAC,WAAW,CAAC,OAAO,CAAC,GAAG,CAAC,CAAC;QAC5C,IAAI,KAAK,KAAK,CAAC,CAAC,EAAE,CAAC;YACjB,IAAI,CAAC,WAAW,CAAC,MAAM,CAAC,KAAK,EAAE,CAAC,CAAC,CAAC;QACpC,CAAC;IACH,CAAC;IAED;;OAEG;IACK,QAAQ;QACd,IAAI,IAAI,CAAC,WAAW,CAAC,MAAM,KAAK,CAAC,EAAE,CAAC;YAClC,OAAO;QACT,CAAC;QAED,+CAA+C;QAC/C,MAAM,MAAM,GAAG,IAAI,CAAC,WAAW,CAAC,CAAC,CAAC,CAAC;QAEnC,IAAI,MAAM,EAAE,CAAC;YACX,IAAI,CAAC,KAAK,CAAC,MAAM,CAAC,MAAM,CAAC,CAAC;YAC1B,IAAI,CAAC,WAAW,CAAC,KAAK,EAAE,CAAC;QAC3B,CAAC;IACH,CAAC;IAED;;OAEG;IACH,OAAO;QACL,MAAM,GAAG,GAAG,IAAI,CAAC,GAAG,EAAE,CAAC;QACvB,MAAM,WAAW,GAAa,EAAE,CAAC;QAEjC,2CAA2C;QAC3C,KAAK,MAAM,CAAC,GAAG,EAAE,KAAK,CAAC,IAAI,KAAK,CAAC,IAAI,CAAC,IAAI,CAAC,KAAK,CAAC,OAAO,EAAE,CAAC,EAAE,CAAC;YAC5D,IAAI,GAAG,GAAG,KAAK,CAAC,SAAS,EAAE,CAAC;gBAC1B,WAAW,CAAC,IAAI,CAAC,GAAG,CAAC,CAAC;YACxB,CAAC;QACH,CAAC;QAED,KAAK,MAAM,GAAG,IAAI,WAAW,EAAE,CAAC;YAC9B,IAAI,CAAC,KAAK,CAAC,MAAM,CAAC,GAAG,CAAC,CAAC;YACvB,IAAI,CAAC,qBAAqB,CAAC,GAAG,CAAC,CAAC;QAClC,CAAC;IACH,CAAC;CACF;AA9ID,oDA8IC;AAED,+EAA+E;AAC/E,qBAAqB;AACrB,+EAA+E;AAE/E;;;;;;;;;;;;;;;;;;GAkBG;AACH,SAAgB,uBAAuB,CAAC,SAAwB,EAAE;IAChE,MAAM,EACJ,YAAY,GAAG,mBAAmB,EAClC,GAAG,GAAG,OAAO,EAAE,SAAS;IACxB,OAAO,GAAG,IAAI,EACd,OAAO,GAAG,IAAI,oBAAoB,CAAC,OAAO,CAAC,EAC3C,cAAc,GAAG,KAAK,GACvB,GAAG,MAAM,CAAC;IAEX,OAAO,KAAK,EAAE,OAA0B,EAAE,IAAoB,EAA2B,EAAE;QACzF,gEAAgE;QAChE,IAAI,OAAO,CAAC,OAAO,CAAC,MAAM,IAAI,CAAC,cAAc,EAAE,CAAC;YAC9C,OAAO,IAAI,EAAE,CAAC;QAChB,CAAC;QAED,qBAAqB;QACrB,MAAM,QAAQ,GAAG,YAAY,CAAC,OAAO,CAAC,OAAO,CAAC,CAAC;QAE/C,cAAc;QACd,MAAM,cAAc,GAAG,MAAM,OAAO,CAAC,GAAG,CAAC,QAAQ,CAAC,CAAC;QAEnD,IAAI,cAAc,EAAE,CAAC;YACnB,iCAAiC;YACjC,OAAO;gBACL,GAAG,cAAc;gBACjB,QAAQ,EAAE;oBACR,GAAG,cAAc,CAAC,QAAQ;oBAC1B,MAAM,EAAE;wBACN,GAAG,cAAc,CAAC,QAAQ,CAAC,MAAM;wBACjC,QAAQ,EAAE,IAAI;wBACd,QAAQ;qBACT;iBACF;aACF,CAAC;QACJ,CAAC;QAED,4CAA4C;QAC5C,MAAM,QAAQ,GAAG,MAAM,IAAI,EAAE,CAAC;QAE9B,iBAAiB;QACjB,MAAM,OAAO,CAAC,GAAG,CAAC,QAAQ,EAAE,QAAQ,EAAE,GAAG,CAAC,CAAC;QAE3C,qBAAqB;QACrB,OAAO;YACL,GAAG,QAAQ;YACX,QAAQ,EAAE;gBACR,GAAG,QAAQ,CAAC,QAAQ;gBACpB,MAAM,EAAE;oBACN,GAAG,QAAQ,CAAC,QAAQ,CAAC,MAAM;oBAC3B,QAAQ,EAAE,KAAK;oBACf,QAAQ;iBACT;aACF;SACF,CAAC;IACJ,CAAC,CAAC;AACJ,CAAC"}

package/dist/cjs/conversation-history.js

@@ -0,0 +1,213 @@
+"use strict";
+/**
+ * Conversation History Middleware
+ *
+ * Manages conversation history across requests with configurable trimming strategies.
+ * Maintains a global conversation history that can be accessed and modified by requests.
+ *
+ * @module
+ */
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.createConversationHistoryMiddleware = createConversationHistoryMiddleware;
+exports.simpleConversationHistory = simpleConversationHistory;
+exports.statelessConversation = statelessConversation;
+exports.conversationOnlyHistory = conversationOnlyHistory;
+const ai_matey_utils_1 = require("ai.matey.utils");
+// ============================================================================
+// Middleware Factory
+// ============================================================================
+/**
+ * Create conversation history middleware.
+ *
+ * Maintains a global conversation history across requests. Automatically prepends
+ * history to requests and appends responses to history after completion.
+ *
+ * @param config Conversation history configuration
+ * @returns Conversation history middleware and manager
+ *
+ * @example Basic Usage
+ * ```typescript
+ * const { middleware, manager } = createConversationHistoryMiddleware({
+ *   maxHistorySize: 10,
+ *   strategy: 'smart'
+ * });
+ *
+ * bridge.use(middleware);
+ *
+ * // Access history
+ * console.log('Pairs:', manager.getPairCount());
+ * console.log('History:', manager.getHistory());
+ *
+ * // Clear history when needed
+ * manager.clear();
+ * ```
+ *
+ * @example With Initial System Message
+ * ```typescript
+ * const { middleware } = createConversationHistoryMiddleware({
+ *   initialHistory: [
+ *     { role: 'system', content: 'You are a helpful assistant.' }
+ *   ],
+ *   maxHistorySize: 5,
+ *   strategy: 'smart' // Preserves system message
+ * });
+ * ```
+ *
+ * @example Stateless Mode (No History)
+ * ```typescript
+ * const { middleware } = createConversationHistoryMiddleware({
+ *   maxHistorySize: 0 // No history tracking
+ * });
+ * ```
+ *
+ * @example Custom Message Filtering
+ * ```typescript
+ * const { middleware } = createConversationHistoryMiddleware({
+ *   maxHistorySize: 10,
+ *   // Only track user and assistant messages, ignore system
+ *   messageFilter: (msg) => msg.role !== 'system'
+ * });
+ * ```
+ */
+function createConversationHistoryMiddleware(config = {}) {
+    const { maxHistorySize = -1, strategy = 'smart', prependHistory = true, trackResponses = true, initialHistory = [], messageFilter = () => true, } = config;
+    // Internal conversation history state
+    let history = [...initialHistory];
+    // Create manager for external access
+    const manager = {
+        getHistory: () => [...history],
+        addMessage: (message) => {
+            if (messageFilter(message)) {
+                history.push(message);
+                manager.trim();
+            }
+        },
+        addMessages: (messages) => {
+            for (const message of messages) {
+                if (messageFilter(message)) {
+                    history.push(message);
+                }
+            }
+            manager.trim();
+        },
+        clear: () => {
+            history = [];
+        },
+        setHistory: (newHistory) => {
+            history = [...newHistory];
+            manager.trim();
+        },
+        getPairCount: () => {
+            const nonSystemMessages = history.filter((m) => m.role !== 'system');
+            return Math.floor(nonSystemMessages.length / 2);
+        },
+        trim: () => {
+            if ((0, ai_matey_utils_1.shouldTrimHistory)(history, maxHistorySize, strategy)) {
+                history = (0, ai_matey_utils_1.trimHistory)(history, maxHistorySize, strategy);
+            }
+        },
+    };
+    // Create middleware
+    const middleware = async (context, next) => {
+        let request = context.request;
+        // Prepend history to request if enabled
+        if (prependHistory && maxHistorySize !== 0) {
+            const currentHistory = manager.getHistory();
+            // Merge history with request messages
+            // Filter out duplicate system messages from request if history already has them
+            const requestMessages = request.messages.filter((msg) => {
+                // Keep all non-system messages
+                if (msg.role !== 'system') {
+                    return true;
+                }
+                // For system messages, only keep if not already in history
+                const existingSystemMessage = currentHistory.find((h) => h.role === 'system' && h.content === msg.content);
+                return !existingSystemMessage;
+            });
+            request = {
+                ...request,
+                messages: [...currentHistory, ...requestMessages],
+            };
+            context.request = request;
+        }
+        // Call next middleware/handler
+        const response = await next();
+        // Track response in history if enabled
+        if (trackResponses && maxHistorySize !== 0) {
+            // Add the new user message(s) from this request to history
+            const newUserMessages = context.request.messages.filter((msg) => msg.role === 'user' || msg.role === 'assistant');
+            // Find messages that aren't already in history
+            for (const msg of newUserMessages) {
+                const alreadyInHistory = history.some((h) => h.role === msg.role &&
+                    h.content === msg.content &&
+                    h.timestamp === msg.timestamp);
+                if (!alreadyInHistory) {
+                    manager.addMessage(msg);
+                }
+            }
+            // Add assistant response to history
+            if (response.message) {
+                manager.addMessage(response.message);
+            }
+        }
+        return response;
+    };
+    return { middleware, manager };
+}
+// ============================================================================
+// Helper Functions
+// ============================================================================
+/**
+ * Create a simple conversation history middleware with minimal config.
+ *
+ * @param maxHistorySize Maximum number of message pairs to keep
+ * @returns Conversation history middleware
+ *
+ * @example
+ * ```typescript
+ * // Keep last 5 message pairs
+ * bridge.use(simpleConversationHistory(5));
+ * ```
+ */
+function simpleConversationHistory(maxHistorySize = 10) {
+    const { middleware } = createConversationHistoryMiddleware({ maxHistorySize });
+    return middleware;
+}
+/**
+ * Create a stateless conversation history middleware.
+ * Useful for explicitly disabling history in a pipeline.
+ *
+ * @returns Stateless middleware
+ *
+ * @example
+ * ```typescript
+ * // Explicitly disable history
+ * bridge.use(statelessConversation());
+ * ```
+ */
+function statelessConversation() {
+    const { middleware } = createConversationHistoryMiddleware({ maxHistorySize: 0 });
+    return middleware;
+}
+/**
+ * Create a conversation history middleware that only tracks user/assistant pairs.
+ * System messages from requests are passed through but not tracked.
+ *
+ * @param maxHistorySize Maximum number of message pairs
+ * @returns Conversation history middleware
+ *
+ * @example
+ * ```typescript
+ * // Track conversation but not system messages
+ * bridge.use(conversationOnlyHistory(10));
+ * ```
+ */
+function conversationOnlyHistory(maxHistorySize = 10) {
+    const { middleware } = createConversationHistoryMiddleware({
+        maxHistorySize,
+        strategy: 'fifo',
+        messageFilter: (msg) => msg.role !== 'system',
+    });
+    return middleware;
+}
+//# sourceMappingURL=conversation-history.js.map

package/dist/cjs/conversation-history.js.map

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