langchain 0.0.203 → 0.0.204-rc.1

package/dist/cache/ioredis.cjs

@@ -1,79 +1,17 @@
 "use strict";
-Object.defineProperty(exports, "__esModule", { value: true });
-exports.RedisCache = void 0;
-const index_js_1 = require("../schema/index.cjs");
-const base_js_1 = require("./base.cjs");
-/**
- * Cache LLM results using Redis.
- * @example
- * ```typescript
- * const model = new ChatOpenAI({
- *   cache: new RedisCache(new Redis(), { ttl: 60 }),
- * });
- *
- * // Invoke the model with a prompt
- * const response = await model.invoke("Do something random!");
- * console.log(response);
- *
- * // Remember to disconnect the Redis client when done
- * await redisClient.disconnect();
- * ```
- */
-class RedisCache extends index_js_1.BaseCache {
-    constructor(redisClient, config) {
-        super();
-        Object.defineProperty(this, "redisClient", {
-            enumerable: true,
-            configurable: true,
-            writable: true,
-            value: void 0
-        });
-        Object.defineProperty(this, "ttl", {
-            enumerable: true,
-            configurable: true,
-            writable: true,
-            value: void 0
-        });
-        this.redisClient = redisClient;
-        this.ttl = config?.ttl;
-    }
-    /**
-     * Retrieves data from the Redis server using a prompt and an LLM key. If
-     * the data is not found, it returns null.
-     * @param prompt The prompt used to find the data.
-     * @param llmKey The LLM key used to find the data.
-     * @returns The corresponding data as an array of Generation objects, or null if not found.
-     */
-    async lookup(prompt, llmKey) {
-        let idx = 0;
-        let key = (0, base_js_1.getCacheKey)(prompt, llmKey, String(idx));
-        let value = await this.redisClient.get(key);
-        const generations = [];
-        while (value) {
-            const storedGeneration = JSON.parse(value);
-            generations.push((0, base_js_1.deserializeStoredGeneration)(storedGeneration));
-            idx += 1;
-            key = (0, base_js_1.getCacheKey)(prompt, llmKey, String(idx));
-            value = await this.redisClient.get(key);
-        }
-        return generations.length > 0 ? generations : null;
+var __createBinding = (this && this.__createBinding) || (Object.create ? (function(o, m, k, k2) {
+    if (k2 === undefined) k2 = k;
+    var desc = Object.getOwnPropertyDescriptor(m, k);
+    if (!desc || ("get" in desc ? !m.__esModule : desc.writable || desc.configurable)) {
+      desc = { enumerable: true, get: function() { return m[k]; } };
     }
-    /**
-     * Updates the data in the Redis server using a prompt and an LLM key.
-     * @param prompt The prompt used to store the data.
-     * @param llmKey The LLM key used to store the data.
-     * @param value The data to be stored, represented as an array of Generation objects.
-     */
-    async update(prompt, llmKey, value) {
-        for (let i = 0; i < value.length; i += 1) {
-            const key = (0, base_js_1.getCacheKey)(prompt, llmKey, String(i));
-            if (this.ttl !== undefined) {
-                await this.redisClient.set(key, JSON.stringify((0, base_js_1.serializeGeneration)(value[i])), "EX", this.ttl);
-            }
-            else {
-                await this.redisClient.set(key, JSON.stringify((0, base_js_1.serializeGeneration)(value[i])));
-            }
-        }
-    }
-}
-exports.RedisCache = RedisCache;
+    Object.defineProperty(o, k2, desc);
+}) : (function(o, m, k, k2) {
+    if (k2 === undefined) k2 = k;
+    o[k2] = m[k];
+}));
+var __exportStar = (this && this.__exportStar) || function(m, exports) {
+    for (var p in m) if (p !== "default" && !Object.prototype.hasOwnProperty.call(exports, p)) __createBinding(exports, m, p);
+};
+Object.defineProperty(exports, "__esModule", { value: true });
+__exportStar(require("@langchain/community/caches/ioredis"), exports);

package/dist/cache/ioredis.d.ts

@@ -1,40 +1 @@
-import { Redis } from "ioredis";
-import { BaseCache, Generation } from "../schema/index.js";
-/**
- * Cache LLM results using Redis.
- * @example
- * ```typescript
- * const model = new ChatOpenAI({
- *   cache: new RedisCache(new Redis(), { ttl: 60 }),
- * });
- *
- * // Invoke the model with a prompt
- * const response = await model.invoke("Do something random!");
- * console.log(response);
- *
- * // Remember to disconnect the Redis client when done
- * await redisClient.disconnect();
- * ```
- */
-export declare class RedisCache extends BaseCache {
-    protected redisClient: Redis;
-    protected ttl?: number;
-    constructor(redisClient: Redis, config?: {
-        ttl?: number;
-    });
-    /**
-     * Retrieves data from the Redis server using a prompt and an LLM key. If
-     * the data is not found, it returns null.
-     * @param prompt The prompt used to find the data.
-     * @param llmKey The LLM key used to find the data.
-     * @returns The corresponding data as an array of Generation objects, or null if not found.
-     */
-    lookup(prompt: string, llmKey: string): Promise<Generation[] | null>;
-    /**
-     * Updates the data in the Redis server using a prompt and an LLM key.
-     * @param prompt The prompt used to store the data.
-     * @param llmKey The LLM key used to store the data.
-     * @param value The data to be stored, represented as an array of Generation objects.
-     */
-    update(prompt: string, llmKey: string, value: Generation[]): Promise<void>;
-}
+export * from "@langchain/community/caches/ioredis";

package/dist/cache/ioredis.js

@@ -1,75 +1 @@
-import { BaseCache } from "../schema/index.js";
-import { serializeGeneration, deserializeStoredGeneration, getCacheKey, } from "./base.js";
-/**
- * Cache LLM results using Redis.
- * @example
- * ```typescript
- * const model = new ChatOpenAI({
- *   cache: new RedisCache(new Redis(), { ttl: 60 }),
- * });
- *
- * // Invoke the model with a prompt
- * const response = await model.invoke("Do something random!");
- * console.log(response);
- *
- * // Remember to disconnect the Redis client when done
- * await redisClient.disconnect();
- * ```
- */
-export class RedisCache extends BaseCache {
-    constructor(redisClient, config) {
-        super();
-        Object.defineProperty(this, "redisClient", {
-            enumerable: true,
-            configurable: true,
-            writable: true,
-            value: void 0
-        });
-        Object.defineProperty(this, "ttl", {
-            enumerable: true,
-            configurable: true,
-            writable: true,
-            value: void 0
-        });
-        this.redisClient = redisClient;
-        this.ttl = config?.ttl;
-    }
-    /**
-     * Retrieves data from the Redis server using a prompt and an LLM key. If
-     * the data is not found, it returns null.
-     * @param prompt The prompt used to find the data.
-     * @param llmKey The LLM key used to find the data.
-     * @returns The corresponding data as an array of Generation objects, or null if not found.
-     */
-    async lookup(prompt, llmKey) {
-        let idx = 0;
-        let key = getCacheKey(prompt, llmKey, String(idx));
-        let value = await this.redisClient.get(key);
-        const generations = [];
-        while (value) {
-            const storedGeneration = JSON.parse(value);
-            generations.push(deserializeStoredGeneration(storedGeneration));
-            idx += 1;
-            key = getCacheKey(prompt, llmKey, String(idx));
-            value = await this.redisClient.get(key);
-        }
-        return generations.length > 0 ? generations : null;
-    }
-    /**
-     * Updates the data in the Redis server using a prompt and an LLM key.
-     * @param prompt The prompt used to store the data.
-     * @param llmKey The LLM key used to store the data.
-     * @param value The data to be stored, represented as an array of Generation objects.
-     */
-    async update(prompt, llmKey, value) {
-        for (let i = 0; i < value.length; i += 1) {
-            const key = getCacheKey(prompt, llmKey, String(i));
-            if (this.ttl !== undefined) {
-                await this.redisClient.set(key, JSON.stringify(serializeGeneration(value[i])), "EX", this.ttl);
-            }
-            else {
-                await this.redisClient.set(key, JSON.stringify(serializeGeneration(value[i])));
-            }
-        }
-    }
-}
+export * from "@langchain/community/caches/ioredis";

package/dist/cache/momento.cjs

@@ -1,137 +1,17 @@
 "use strict";
-Object.defineProperty(exports, "__esModule", { value: true });
-exports.MomentoCache = void 0;
-/* eslint-disable no-instanceof/no-instanceof */
-const sdk_core_1 = require("@gomomento/sdk-core");
-const index_js_1 = require("../schema/index.cjs");
-const base_js_1 = require("./base.cjs");
-const momento_js_1 = require("../util/momento.cjs");
-/**
- * A cache that uses Momento as the backing store.
- * See https://gomomento.com.
- * @example
- * ```typescript
- * const cache = new MomentoCache({
- *   client: new CacheClient({
- *     configuration: Configurations.Laptop.v1(),
- *     credentialProvider: CredentialProvider.fromEnvironmentVariable({
- *       environmentVariableName: "MOMENTO_API_KEY",
- *     }),
- *     defaultTtlSeconds: 60 * 60 * 24, // Cache TTL set to 24 hours.
- *   }),
- *   cacheName: "langchain",
- * });
- * // Initialize the OpenAI model with Momento cache for caching responses
- * const model = new ChatOpenAI({
- *   cache,
- * });
- * await model.invoke("How are you today?");
- * const cachedValues = await cache.lookup("How are you today?", "llmKey");
- * ```
- */
-class MomentoCache extends index_js_1.BaseCache {
-    constructor(props) {
-        super();
-        Object.defineProperty(this, "client", {
-            enumerable: true,
-            configurable: true,
-            writable: true,
-            value: void 0
-        });
-        Object.defineProperty(this, "cacheName", {
-            enumerable: true,
-            configurable: true,
-            writable: true,
-            value: void 0
-        });
-        Object.defineProperty(this, "ttlSeconds", {
-            enumerable: true,
-            configurable: true,
-            writable: true,
-            value: void 0
-        });
-        this.client = props.client;
-        this.cacheName = props.cacheName;
-        this.validateTtlSeconds(props.ttlSeconds);
-        this.ttlSeconds = props.ttlSeconds;
-    }
-    /**
-     * Create a new standard cache backed by Momento.
-     *
-     * @param {MomentoCacheProps} props The settings to instantiate the cache.
-     * @param {ICacheClient} props.client The Momento cache client.
-     * @param {string} props.cacheName The name of the cache to use to store the data.
-     * @param {number} props.ttlSeconds The time to live for the cache items. If not specified,
-     * the cache client default is used.
-     * @param {boolean} props.ensureCacheExists If true, ensure that the cache exists before returning.
-     * If false, the cache is not checked for existence. Defaults to true.
-     * @throws {@link InvalidArgumentError} if {@link props.ttlSeconds} is not strictly positive.
-     * @returns The Momento-backed cache.
-     */
-    static async fromProps(props) {
-        const instance = new MomentoCache(props);
-        if (props.ensureCacheExists || props.ensureCacheExists === undefined) {
-            await (0, momento_js_1.ensureCacheExists)(props.client, props.cacheName);
-        }
-        return instance;
-    }
-    /**
-     * Validate the user-specified TTL, if provided, is strictly positive.
-     * @param ttlSeconds The TTL to validate.
-     */
-    validateTtlSeconds(ttlSeconds) {
-        if (ttlSeconds !== undefined && ttlSeconds <= 0) {
-            throw new sdk_core_1.InvalidArgumentError("ttlSeconds must be positive.");
-        }
+var __createBinding = (this && this.__createBinding) || (Object.create ? (function(o, m, k, k2) {
+    if (k2 === undefined) k2 = k;
+    var desc = Object.getOwnPropertyDescriptor(m, k);
+    if (!desc || ("get" in desc ? !m.__esModule : desc.writable || desc.configurable)) {
+      desc = { enumerable: true, get: function() { return m[k]; } };
     }
-    /**
-     * Lookup LLM generations in cache by prompt and associated LLM key.
-     * @param prompt The prompt to lookup.
-     * @param llmKey The LLM key to lookup.
-     * @returns The generations associated with the prompt and LLM key, or null if not found.
-     */
-    async lookup(prompt, llmKey) {
-        const key = (0, base_js_1.getCacheKey)(prompt, llmKey);
-        const getResponse = await this.client.get(this.cacheName, key);
-        if (getResponse instanceof sdk_core_1.CacheGet.Hit) {
-            const value = getResponse.valueString();
-            const parsedValue = JSON.parse(value);
-            if (!Array.isArray(parsedValue)) {
-                return null;
-            }
-            return JSON.parse(value).map(base_js_1.deserializeStoredGeneration);
-        }
-        else if (getResponse instanceof sdk_core_1.CacheGet.Miss) {
-            return null;
-        }
-        else if (getResponse instanceof sdk_core_1.CacheGet.Error) {
-            throw getResponse.innerException();
-        }
-        else {
-            throw new Error(`Unknown response type: ${getResponse.toString()}`);
-        }
-    }
-    /**
-     * Update the cache with the given generations.
-     *
-     * Note this overwrites any existing generations for the given prompt and LLM key.
-     *
-     * @param prompt The prompt to update.
-     * @param llmKey The LLM key to update.
-     * @param value The generations to store.
-     */
-    async update(prompt, llmKey, value) {
-        const key = (0, base_js_1.getCacheKey)(prompt, llmKey);
-        const setResponse = await this.client.set(this.cacheName, key, JSON.stringify(value.map(base_js_1.serializeGeneration)), { ttl: this.ttlSeconds });
-        if (setResponse instanceof sdk_core_1.CacheSet.Success) {
-            // pass
-        }
-        else if (setResponse instanceof sdk_core_1.CacheSet.Error) {
-            throw setResponse.innerException();
-        }
-        else {
-            throw new Error(`Unknown response type: ${setResponse.toString()}`);
-        }
-    }
-}
-exports.MomentoCache = MomentoCache;
+    Object.defineProperty(o, k2, desc);
+}) : (function(o, m, k, k2) {
+    if (k2 === undefined) k2 = k;
+    o[k2] = m[k];
+}));
+var __exportStar = (this && this.__exportStar) || function(m, exports) {
+    for (var p in m) if (p !== "default" && !Object.prototype.hasOwnProperty.call(exports, p)) __createBinding(exports, m, p);
+};
+Object.defineProperty(exports, "__esModule", { value: true });
+__exportStar(require("@langchain/community/caches/momento"), exports);

package/dist/cache/momento.d.ts

@@ -1,91 +1 @@
-import { ICacheClient } from "@gomomento/sdk-core";
-import { BaseCache, Generation } from "../schema/index.js";
-/**
- * The settings to instantiate the Momento standard cache.
- */
-export interface MomentoCacheProps {
-    /**
-     * The Momento cache client.
-     */
-    client: ICacheClient;
-    /**
-     * The name of the cache to use to store the data.
-     */
-    cacheName: string;
-    /**
-     * The time to live for the cache items. If not specified,
-     * the cache client default is used.
-     */
-    ttlSeconds?: number;
-    /**
-     * If true, ensure that the cache exists before returning.
-     * If false, the cache is not checked for existence.
-     * Defaults to true.
-     */
-    ensureCacheExists?: true;
-}
-/**
- * A cache that uses Momento as the backing store.
- * See https://gomomento.com.
- * @example
- * ```typescript
- * const cache = new MomentoCache({
- *   client: new CacheClient({
- *     configuration: Configurations.Laptop.v1(),
- *     credentialProvider: CredentialProvider.fromEnvironmentVariable({
- *       environmentVariableName: "MOMENTO_API_KEY",
- *     }),
- *     defaultTtlSeconds: 60 * 60 * 24, // Cache TTL set to 24 hours.
- *   }),
- *   cacheName: "langchain",
- * });
- * // Initialize the OpenAI model with Momento cache for caching responses
- * const model = new ChatOpenAI({
- *   cache,
- * });
- * await model.invoke("How are you today?");
- * const cachedValues = await cache.lookup("How are you today?", "llmKey");
- * ```
- */
-export declare class MomentoCache extends BaseCache {
-    private client;
-    private readonly cacheName;
-    private readonly ttlSeconds?;
-    private constructor();
-    /**
-     * Create a new standard cache backed by Momento.
-     *
-     * @param {MomentoCacheProps} props The settings to instantiate the cache.
-     * @param {ICacheClient} props.client The Momento cache client.
-     * @param {string} props.cacheName The name of the cache to use to store the data.
-     * @param {number} props.ttlSeconds The time to live for the cache items. If not specified,
-     * the cache client default is used.
-     * @param {boolean} props.ensureCacheExists If true, ensure that the cache exists before returning.
-     * If false, the cache is not checked for existence. Defaults to true.
-     * @throws {@link InvalidArgumentError} if {@link props.ttlSeconds} is not strictly positive.
-     * @returns The Momento-backed cache.
-     */
-    static fromProps(props: MomentoCacheProps): Promise<MomentoCache>;
-    /**
-     * Validate the user-specified TTL, if provided, is strictly positive.
-     * @param ttlSeconds The TTL to validate.
-     */
-    private validateTtlSeconds;
-    /**
-     * Lookup LLM generations in cache by prompt and associated LLM key.
-     * @param prompt The prompt to lookup.
-     * @param llmKey The LLM key to lookup.
-     * @returns The generations associated with the prompt and LLM key, or null if not found.
-     */
-    lookup(prompt: string, llmKey: string): Promise<Generation[] | null>;
-    /**
-     * Update the cache with the given generations.
-     *
-     * Note this overwrites any existing generations for the given prompt and LLM key.
-     *
-     * @param prompt The prompt to update.
-     * @param llmKey The LLM key to update.
-     * @param value The generations to store.
-     */
-    update(prompt: string, llmKey: string, value: Generation[]): Promise<void>;
-}
+export * from "@langchain/community/caches/momento";

package/dist/cache/momento.js

@@ -1,133 +1 @@
-/* eslint-disable no-instanceof/no-instanceof */
-import { CacheGet, CacheSet, InvalidArgumentError, } from "@gomomento/sdk-core";
-import { BaseCache } from "../schema/index.js";
-import { deserializeStoredGeneration, getCacheKey, serializeGeneration, } from "./base.js";
-import { ensureCacheExists } from "../util/momento.js";
-/**
- * A cache that uses Momento as the backing store.
- * See https://gomomento.com.
- * @example
- * ```typescript
- * const cache = new MomentoCache({
- *   client: new CacheClient({
- *     configuration: Configurations.Laptop.v1(),
- *     credentialProvider: CredentialProvider.fromEnvironmentVariable({
- *       environmentVariableName: "MOMENTO_API_KEY",
- *     }),
- *     defaultTtlSeconds: 60 * 60 * 24, // Cache TTL set to 24 hours.
- *   }),
- *   cacheName: "langchain",
- * });
- * // Initialize the OpenAI model with Momento cache for caching responses
- * const model = new ChatOpenAI({
- *   cache,
- * });
- * await model.invoke("How are you today?");
- * const cachedValues = await cache.lookup("How are you today?", "llmKey");
- * ```
- */
-export class MomentoCache extends BaseCache {
-    constructor(props) {
-        super();
-        Object.defineProperty(this, "client", {
-            enumerable: true,
-            configurable: true,
-            writable: true,
-            value: void 0
-        });
-        Object.defineProperty(this, "cacheName", {
-            enumerable: true,
-            configurable: true,
-            writable: true,
-            value: void 0
-        });
-        Object.defineProperty(this, "ttlSeconds", {
-            enumerable: true,
-            configurable: true,
-            writable: true,
-            value: void 0
-        });
-        this.client = props.client;
-        this.cacheName = props.cacheName;
-        this.validateTtlSeconds(props.ttlSeconds);
-        this.ttlSeconds = props.ttlSeconds;
-    }
-    /**
-     * Create a new standard cache backed by Momento.
-     *
-     * @param {MomentoCacheProps} props The settings to instantiate the cache.
-     * @param {ICacheClient} props.client The Momento cache client.
-     * @param {string} props.cacheName The name of the cache to use to store the data.
-     * @param {number} props.ttlSeconds The time to live for the cache items. If not specified,
-     * the cache client default is used.
-     * @param {boolean} props.ensureCacheExists If true, ensure that the cache exists before returning.
-     * If false, the cache is not checked for existence. Defaults to true.
-     * @throws {@link InvalidArgumentError} if {@link props.ttlSeconds} is not strictly positive.
-     * @returns The Momento-backed cache.
-     */
-    static async fromProps(props) {
-        const instance = new MomentoCache(props);
-        if (props.ensureCacheExists || props.ensureCacheExists === undefined) {
-            await ensureCacheExists(props.client, props.cacheName);
-        }
-        return instance;
-    }
-    /**
-     * Validate the user-specified TTL, if provided, is strictly positive.
-     * @param ttlSeconds The TTL to validate.
-     */
-    validateTtlSeconds(ttlSeconds) {
-        if (ttlSeconds !== undefined && ttlSeconds <= 0) {
-            throw new InvalidArgumentError("ttlSeconds must be positive.");
-        }
-    }
-    /**
-     * Lookup LLM generations in cache by prompt and associated LLM key.
-     * @param prompt The prompt to lookup.
-     * @param llmKey The LLM key to lookup.
-     * @returns The generations associated with the prompt and LLM key, or null if not found.
-     */
-    async lookup(prompt, llmKey) {
-        const key = getCacheKey(prompt, llmKey);
-        const getResponse = await this.client.get(this.cacheName, key);
-        if (getResponse instanceof CacheGet.Hit) {
-            const value = getResponse.valueString();
-            const parsedValue = JSON.parse(value);
-            if (!Array.isArray(parsedValue)) {
-                return null;
-            }
-            return JSON.parse(value).map(deserializeStoredGeneration);
-        }
-        else if (getResponse instanceof CacheGet.Miss) {
-            return null;
-        }
-        else if (getResponse instanceof CacheGet.Error) {
-            throw getResponse.innerException();
-        }
-        else {
-            throw new Error(`Unknown response type: ${getResponse.toString()}`);
-        }
-    }
-    /**
-     * Update the cache with the given generations.
-     *
-     * Note this overwrites any existing generations for the given prompt and LLM key.
-     *
-     * @param prompt The prompt to update.
-     * @param llmKey The LLM key to update.
-     * @param value The generations to store.
-     */
-    async update(prompt, llmKey, value) {
-        const key = getCacheKey(prompt, llmKey);
-        const setResponse = await this.client.set(this.cacheName, key, JSON.stringify(value.map(serializeGeneration)), { ttl: this.ttlSeconds });
-        if (setResponse instanceof CacheSet.Success) {
-            // pass
-        }
-        else if (setResponse instanceof CacheSet.Error) {
-            throw setResponse.innerException();
-        }
-        else {
-            throw new Error(`Unknown response type: ${setResponse.toString()}`);
-        }
-    }
-}
+export * from "@langchain/community/caches/momento";