langchain 0.0.202 → 0.0.204-rc.0

package/dist/retrievers/zep.js

@@ -1,148 +1 @@
-import { NotFoundError, ZepClient, } from "@getzep/zep-js";
-import { BaseRetriever } from "../schema/retriever.js";
-import { Document } from "../document.js";
-/**
- * Class for retrieving information from a Zep long-term memory store.
- * Extends the BaseRetriever class.
- * @example
- * ```typescript
- * const retriever = new ZepRetriever({
- *   url: "http:
- *   sessionId: "session_exampleUUID",
- *   topK: 3,
- * });
- * const query = "Can I drive red cars in France?";
- * const docs = await retriever.getRelevantDocuments(query);
- * ```
- */
-export class ZepRetriever extends BaseRetriever {
-    static lc_name() {
-        return "ZepRetriever";
-    }
-    get lc_secrets() {
-        return {
-            apiKey: "ZEP_API_KEY",
-            url: "ZEP_API_URL",
-        };
-    }
-    get lc_aliases() {
-        return { apiKey: "api_key" };
-    }
-    constructor(config) {
-        super(config);
-        Object.defineProperty(this, "lc_namespace", {
-            enumerable: true,
-            configurable: true,
-            writable: true,
-            value: ["langchain", "retrievers", "zep"]
-        });
-        Object.defineProperty(this, "zepClientPromise", {
-            enumerable: true,
-            configurable: true,
-            writable: true,
-            value: void 0
-        });
-        Object.defineProperty(this, "sessionId", {
-            enumerable: true,
-            configurable: true,
-            writable: true,
-            value: void 0
-        });
-        Object.defineProperty(this, "topK", {
-            enumerable: true,
-            configurable: true,
-            writable: true,
-            value: void 0
-        });
-        Object.defineProperty(this, "searchScope", {
-            enumerable: true,
-            configurable: true,
-            writable: true,
-            value: void 0
-        });
-        Object.defineProperty(this, "searchType", {
-            enumerable: true,
-            configurable: true,
-            writable: true,
-            value: void 0
-        });
-        Object.defineProperty(this, "mmrLambda", {
-            enumerable: true,
-            configurable: true,
-            writable: true,
-            value: void 0
-        });
-        Object.defineProperty(this, "filter", {
-            enumerable: true,
-            configurable: true,
-            writable: true,
-            value: void 0
-        });
-        this.sessionId = config.sessionId;
-        this.topK = config.topK;
-        this.searchScope = config.searchScope;
-        this.searchType = config.searchType;
-        this.mmrLambda = config.mmrLambda;
-        this.filter = config.filter;
-        this.zepClientPromise = ZepClient.init(config.url, config.apiKey);
-    }
-    /**
-     *  Converts an array of message search results to an array of Document objects.
-     *  @param {MemorySearchResult[]} results - The array of search results.
-     *  @returns {Document[]} An array of Document objects representing the search results.
-     */
-    searchMessageResultToDoc(results) {
-        return results
-            .filter((r) => r.message)
-            .map(({ message: { content, metadata: messageMetadata } = {}, dist, ...rest }) => new Document({
-            pageContent: content ?? "",
-            metadata: { score: dist, ...messageMetadata, ...rest },
-        }));
-    }
-    /**
-     *  Converts an array of summary search results to an array of Document objects.
-     *  @param {MemorySearchResult[]} results - The array of search results.
-     *  @returns {Document[]} An array of Document objects representing the search results.
-     */
-    searchSummaryResultToDoc(results) {
-        return results
-            .filter((r) => r.summary)
-            .map(({ summary: { content, metadata: summaryMetadata } = {}, dist, ...rest }) => new Document({
-            pageContent: content ?? "",
-            metadata: { score: dist, ...summaryMetadata, ...rest },
-        }));
-    }
-    /**
-     *  Retrieves the relevant documents based on the given query.
-     *  @param {string} query - The query string.
-     *  @returns {Promise<Document[]>} A promise that resolves to an array of relevant Document objects.
-     */
-    async _getRelevantDocuments(query) {
-        const payload = {
-            text: query,
-            metadata: this.filter,
-            search_scope: this.searchScope,
-            search_type: this.searchType,
-            mmr_lambda: this.mmrLambda,
-        };
-        // Wait for ZepClient to be initialized
-        const zepClient = await this.zepClientPromise;
-        if (!zepClient) {
-            throw new Error("ZepClient is not initialized");
-        }
-        try {
-            const results = await zepClient.memory.searchMemory(this.sessionId, payload, this.topK);
-            return this.searchScope === "summary"
-                ? this.searchSummaryResultToDoc(results)
-                : this.searchMessageResultToDoc(results);
-        }
-        catch (error) {
-            // eslint-disable-next-line no-instanceof/no-instanceof
-            if (error instanceof NotFoundError) {
-                return Promise.resolve([]); // Return an empty Document array
-            }
-            // If it's not a NotFoundError, throw the error again
-            throw error;
-        }
-    }
-}
+export * from "@langchain/community/retrievers/zep";

package/dist/schema/document.cjs

@@ -1,20 +1,6 @@
 "use strict";
 Object.defineProperty(exports, "__esModule", { value: true });
 exports.MappingDocumentTransformer = exports.BaseDocumentTransformer = void 0;
-const documents_1 = require("@langchain/core/documents");
+var documents_1 = require("@langchain/core/documents");
 Object.defineProperty(exports, "BaseDocumentTransformer", { enumerable: true, get: function () { return documents_1.BaseDocumentTransformer; } });
-/**
- * Class for document transformers that return exactly one transformed document
- * for each input document.
- */
-class MappingDocumentTransformer extends documents_1.BaseDocumentTransformer {
-    async transformDocuments(documents) {
-        const newDocuments = [];
-        for (const document of documents) {
-            const transformedDocument = await this._transformDocument(document);
-            newDocuments.push(transformedDocument);
-        }
-        return newDocuments;
-    }
-}
-exports.MappingDocumentTransformer = MappingDocumentTransformer;
+Object.defineProperty(exports, "MappingDocumentTransformer", { enumerable: true, get: function () { return documents_1.MappingDocumentTransformer; } });

package/dist/schema/document.d.ts

@@ -1,11 +1 @@
-import { BaseDocumentTransformer } from "@langchain/core/documents";
-import { Document } from "../document.js";
-export { BaseDocumentTransformer };
-/**
- * Class for document transformers that return exactly one transformed document
- * for each input document.
- */
-export declare abstract class MappingDocumentTransformer extends BaseDocumentTransformer {
-    transformDocuments(documents: Document[]): Promise<Document[]>;
-    abstract _transformDocument(document: Document): Promise<Document>;
-}
+export { BaseDocumentTransformer, MappingDocumentTransformer, } from "@langchain/core/documents";

package/dist/schema/document.js

@@ -1,16 +1 @@
-import { BaseDocumentTransformer } from "@langchain/core/documents";
-export { BaseDocumentTransformer };
-/**
- * Class for document transformers that return exactly one transformed document
- * for each input document.
- */
-export class MappingDocumentTransformer extends BaseDocumentTransformer {
-    async transformDocuments(documents) {
-        const newDocuments = [];
-        for (const document of documents) {
-            const transformedDocument = await this._transformDocument(document);
-            newDocuments.push(transformedDocument);
-        }
-        return newDocuments;
-    }
-}
+export { BaseDocumentTransformer, MappingDocumentTransformer, } from "@langchain/core/documents";

package/dist/schema/index.cjs

@@ -68,10 +68,5 @@ exports.BaseFileStore = BaseFileStore;
 class BaseEntityStore extends serializable_js_1.Serializable {
 }
 exports.BaseEntityStore = BaseEntityStore;
-/**
- * Abstract class for a document store. All document stores should extend
- * this class.
- */
-class Docstore {
-}
-exports.Docstore = Docstore;
+var base_1 = require("@langchain/community/stores/doc/base");
+Object.defineProperty(exports, "Docstore", { enumerable: true, get: function () { return base_1.Docstore; } });

package/dist/schema/index.d.ts

@@ -1,6 +1,5 @@
-import type { OpenAI as OpenAIClient } from "openai";
+import type { OpenAIClient } from "@langchain/openai";
 import { BaseMessage, HumanMessage, AIMessage, SystemMessage } from "@langchain/core/messages";
-import { Document } from "../document.js";
 import { Serializable } from "../load/serializable.js";
 export { type AgentAction, type AgentFinish, type AgentStep, } from "@langchain/core/agents";
 export { RUN_KEY } from "@langchain/core/outputs";
@@ -54,11 +53,4 @@ export declare abstract class BaseEntityStore extends Serializable {
     abstract exists(key: string): Promise<boolean>;
     abstract clear(): Promise<void>;
 }
-/**
- * Abstract class for a document store. All document stores should extend
- * this class.
- */
-export declare abstract class Docstore {
-    abstract search(search: string): Promise<Document>;
-    abstract add(texts: Record<string, Document>): Promise<void>;
-}
+export { Docstore } from "@langchain/community/stores/doc/base";

package/dist/schema/index.js

@@ -39,9 +39,4 @@ export class BaseFileStore extends Serializable {
  */
 export class BaseEntityStore extends Serializable {
 }
-/**
- * Abstract class for a document store. All document stores should extend
- * this class.
- */
-export class Docstore {
-}
+export { Docstore } from "@langchain/community/stores/doc/base";

package/dist/storage/convex.cjs

@@ -1,145 +1,17 @@
 "use strict";
-Object.defineProperty(exports, "__esModule", { value: true });
-exports.ConvexKVStore = void 0;
-// eslint-disable-next-line import/no-extraneous-dependencies
-const server_1 = require("convex/server");
-const storage_js_1 = require("../schema/storage.cjs");
-/**
- * Class that extends the BaseStore class to interact with a Convex
- * database. It provides methods for getting, setting, and deleting key value pairs,
- * as well as yielding keys from the database.
- */
-class ConvexKVStore extends storage_js_1.BaseStore {
-    constructor(config) {
-        super(config);
-        Object.defineProperty(this, "lc_namespace", {
-            enumerable: true,
-            configurable: true,
-            writable: true,
-            value: ["langchain", "storage", "convex"]
-        });
-        Object.defineProperty(this, "ctx", {
-            enumerable: true,
-            configurable: true,
-            writable: true,
-            value: void 0
-        });
-        Object.defineProperty(this, "table", {
-            enumerable: true,
-            configurable: true,
-            writable: true,
-            value: void 0
-        });
-        Object.defineProperty(this, "index", {
-            enumerable: true,
-            configurable: true,
-            writable: true,
-            value: void 0
-        });
-        Object.defineProperty(this, "keyField", {
-            enumerable: true,
-            configurable: true,
-            writable: true,
-            value: void 0
-        });
-        Object.defineProperty(this, "valueField", {
-            enumerable: true,
-            configurable: true,
-            writable: true,
-            value: void 0
-        });
-        Object.defineProperty(this, "upsert", {
-            enumerable: true,
-            configurable: true,
-            writable: true,
-            value: void 0
-        });
-        Object.defineProperty(this, "lookup", {
-            enumerable: true,
-            configurable: true,
-            writable: true,
-            value: void 0
-        });
-        Object.defineProperty(this, "deleteMany", {
-            enumerable: true,
-            configurable: true,
-            writable: true,
-            value: void 0
-        });
-        this.ctx = config.ctx;
-        this.table = config.table ?? "cache";
-        this.index = config.index ?? "byKey";
-        this.keyField = config.keyField ?? "key";
-        this.valueField = config.valueField ?? "value";
-        this.upsert =
-            // eslint-disable-next-line @typescript-eslint/no-explicit-any
-            config.upsert ?? (0, server_1.makeFunctionReference)("langchain/db:upsert");
-        this.lookup =
-            // eslint-disable-next-line @typescript-eslint/no-explicit-any
-            config.lookup ?? (0, server_1.makeFunctionReference)("langchain/db:lookup");
-        this.deleteMany =
-            config.deleteMany ??
-                // eslint-disable-next-line @typescript-eslint/no-explicit-any
-                (0, server_1.makeFunctionReference)("langchain/db:deleteMany");
-    }
-    /**
-     * Gets multiple keys from the Convex database.
-     * @param keys Array of keys to be retrieved.
-     * @returns An array of retrieved values.
-     */
-    async mget(keys) {
-        return (await Promise.all(keys.map(async (key) => {
-            const found = (await this.ctx.runQuery(this.lookup, {
-                table: this.table,
-                index: this.index,
-                keyField: this.keyField,
-                key,
-                // eslint-disable-next-line @typescript-eslint/no-explicit-any
-            }));
-            return found.length > 0 ? found[0][this.valueField] : undefined;
-        })));
-    }
-    /**
-     * Sets multiple keys in the Convex database.
-     * @param keyValuePairs Array of key-value pairs to be set.
-     * @returns Promise that resolves when all keys have been set.
-     */
-    async mset(keyValuePairs) {
-        // TODO: Remove chunking when Convex handles the concurrent requests correctly
-        const PAGE_SIZE = 16;
-        for (let i = 0; i < keyValuePairs.length; i += PAGE_SIZE) {
-            await Promise.all(keyValuePairs.slice(i, i + PAGE_SIZE).map(([key, value]) => this.ctx.runMutation(this.upsert, {
-                table: this.table,
-                index: this.index,
-                keyField: this.keyField,
-                key,
-                document: { [this.keyField]: key, [this.valueField]: value },
-                // eslint-disable-next-line @typescript-eslint/no-explicit-any
-            })));
-        }
+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]; } };
     }
-    /**
-     * Deletes multiple keys from the Convex database.
-     * @param keys Array of keys to be deleted.
-     * @returns Promise that resolves when all keys have been deleted.
-     */
-    async mdelete(keys) {
-        await Promise.all(keys.map((key) => this.ctx.runMutation(this.deleteMany, {
-            table: this.table,
-            index: this.index,
-            keyField: this.keyField,
-            key,
-            // eslint-disable-next-line @typescript-eslint/no-explicit-any
-        })));
-    }
-    /**
-     * Yields keys from the Convex database.
-     * @param prefix Optional prefix to filter the keys.
-     * @returns An AsyncGenerator that yields keys from the Convex database.
-     */
-    // eslint-disable-next-line require-yield
-    async *yieldKeys(_prefix) {
-        throw new Error("yieldKeys not implemented yet for ConvexKVStore");
-    }
-}
-exports.ConvexKVStore = ConvexKVStore;
+    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/storage/convex"), exports);

package/dist/storage/convex.d.ts

@@ -1,106 +1 @@
-import { FieldPaths, FunctionReference, GenericActionCtx, GenericDataModel, NamedTableInfo, TableNamesInDataModel, VectorIndexNames } from "convex/server";
-import { Value } from "convex/values";
-import { BaseStore } from "../schema/storage.js";
-/**
- * Type that defines the config required to initialize the
- * ConvexKVStore class. It includes the table name,
- * index name, field name.
- */
-export type ConvexKVStoreConfig<DataModel extends GenericDataModel, TableName extends TableNamesInDataModel<DataModel>, IndexName extends VectorIndexNames<NamedTableInfo<DataModel, TableName>>, KeyFieldName extends FieldPaths<NamedTableInfo<DataModel, TableName>>, ValueFieldName extends FieldPaths<NamedTableInfo<DataModel, TableName>>, UpsertMutation extends FunctionReference<"mutation", "internal", {
-    table: string;
-    document: object;
-}>, LookupQuery extends FunctionReference<"query", "internal", {
-    table: string;
-    index: string;
-    keyField: string;
-    key: string;
-}, object[]>, DeleteManyMutation extends FunctionReference<"mutation", "internal", {
-    table: string;
-    index: string;
-    keyField: string;
-    key: string;
-}>> = {
-    readonly ctx: GenericActionCtx<DataModel>;
-    /**
-     * Defaults to "cache"
-     */
-    readonly table?: TableName;
-    /**
-     * Defaults to "byKey"
-     */
-    readonly index?: IndexName;
-    /**
-     * Defaults to "key"
-     */
-    readonly keyField?: KeyFieldName;
-    /**
-     * Defaults to "value"
-     */
-    readonly valueField?: ValueFieldName;
-    /**
-     * Defaults to `internal.langchain.db.upsert`
-     */
-    readonly upsert?: UpsertMutation;
-    /**
-     * Defaults to `internal.langchain.db.lookup`
-     */
-    readonly lookup?: LookupQuery;
-    /**
-     * Defaults to `internal.langchain.db.deleteMany`
-     */
-    readonly deleteMany?: DeleteManyMutation;
-};
-/**
- * Class that extends the BaseStore class to interact with a Convex
- * database. It provides methods for getting, setting, and deleting key value pairs,
- * as well as yielding keys from the database.
- */
-export declare class ConvexKVStore<T extends Value, DataModel extends GenericDataModel, TableName extends TableNamesInDataModel<DataModel>, IndexName extends VectorIndexNames<NamedTableInfo<DataModel, TableName>>, KeyFieldName extends FieldPaths<NamedTableInfo<DataModel, TableName>>, ValueFieldName extends FieldPaths<NamedTableInfo<DataModel, TableName>>, UpsertMutation extends FunctionReference<"mutation", "internal", {
-    table: string;
-    document: object;
-}>, LookupQuery extends FunctionReference<"query", "internal", {
-    table: string;
-    index: string;
-    keyField: string;
-    key: string;
-}, object[]>, DeleteManyMutation extends FunctionReference<"mutation", "internal", {
-    table: string;
-    index: string;
-    keyField: string;
-    key: string;
-}>> extends BaseStore<string, T> {
-    lc_namespace: string[];
-    private readonly ctx;
-    private readonly table;
-    private readonly index;
-    private readonly keyField;
-    private readonly valueField;
-    private readonly upsert;
-    private readonly lookup;
-    private readonly deleteMany;
-    constructor(config: ConvexKVStoreConfig<DataModel, TableName, IndexName, KeyFieldName, ValueFieldName, UpsertMutation, LookupQuery, DeleteManyMutation>);
-    /**
-     * Gets multiple keys from the Convex database.
-     * @param keys Array of keys to be retrieved.
-     * @returns An array of retrieved values.
-     */
-    mget(keys: string[]): Promise<(T | undefined)[]>;
-    /**
-     * Sets multiple keys in the Convex database.
-     * @param keyValuePairs Array of key-value pairs to be set.
-     * @returns Promise that resolves when all keys have been set.
-     */
-    mset(keyValuePairs: [string, T][]): Promise<void>;
-    /**
-     * Deletes multiple keys from the Convex database.
-     * @param keys Array of keys to be deleted.
-     * @returns Promise that resolves when all keys have been deleted.
-     */
-    mdelete(keys: string[]): Promise<void>;
-    /**
-     * Yields keys from the Convex database.
-     * @param prefix Optional prefix to filter the keys.
-     * @returns An AsyncGenerator that yields keys from the Convex database.
-     */
-    yieldKeys(_prefix?: string): AsyncGenerator<string>;
-}
+export * from "@langchain/community/storage/convex";

package/dist/storage/convex.js

@@ -1,141 +1 @@
-// eslint-disable-next-line import/no-extraneous-dependencies
-import { makeFunctionReference, } from "convex/server";
-import { BaseStore } from "../schema/storage.js";
-/**
- * Class that extends the BaseStore class to interact with a Convex
- * database. It provides methods for getting, setting, and deleting key value pairs,
- * as well as yielding keys from the database.
- */
-export class ConvexKVStore extends BaseStore {
-    constructor(config) {
-        super(config);
-        Object.defineProperty(this, "lc_namespace", {
-            enumerable: true,
-            configurable: true,
-            writable: true,
-            value: ["langchain", "storage", "convex"]
-        });
-        Object.defineProperty(this, "ctx", {
-            enumerable: true,
-            configurable: true,
-            writable: true,
-            value: void 0
-        });
-        Object.defineProperty(this, "table", {
-            enumerable: true,
-            configurable: true,
-            writable: true,
-            value: void 0
-        });
-        Object.defineProperty(this, "index", {
-            enumerable: true,
-            configurable: true,
-            writable: true,
-            value: void 0
-        });
-        Object.defineProperty(this, "keyField", {
-            enumerable: true,
-            configurable: true,
-            writable: true,
-            value: void 0
-        });
-        Object.defineProperty(this, "valueField", {
-            enumerable: true,
-            configurable: true,
-            writable: true,
-            value: void 0
-        });
-        Object.defineProperty(this, "upsert", {
-            enumerable: true,
-            configurable: true,
-            writable: true,
-            value: void 0
-        });
-        Object.defineProperty(this, "lookup", {
-            enumerable: true,
-            configurable: true,
-            writable: true,
-            value: void 0
-        });
-        Object.defineProperty(this, "deleteMany", {
-            enumerable: true,
-            configurable: true,
-            writable: true,
-            value: void 0
-        });
-        this.ctx = config.ctx;
-        this.table = config.table ?? "cache";
-        this.index = config.index ?? "byKey";
-        this.keyField = config.keyField ?? "key";
-        this.valueField = config.valueField ?? "value";
-        this.upsert =
-            // eslint-disable-next-line @typescript-eslint/no-explicit-any
-            config.upsert ?? makeFunctionReference("langchain/db:upsert");
-        this.lookup =
-            // eslint-disable-next-line @typescript-eslint/no-explicit-any
-            config.lookup ?? makeFunctionReference("langchain/db:lookup");
-        this.deleteMany =
-            config.deleteMany ??
-                // eslint-disable-next-line @typescript-eslint/no-explicit-any
-                makeFunctionReference("langchain/db:deleteMany");
-    }
-    /**
-     * Gets multiple keys from the Convex database.
-     * @param keys Array of keys to be retrieved.
-     * @returns An array of retrieved values.
-     */
-    async mget(keys) {
-        return (await Promise.all(keys.map(async (key) => {
-            const found = (await this.ctx.runQuery(this.lookup, {
-                table: this.table,
-                index: this.index,
-                keyField: this.keyField,
-                key,
-                // eslint-disable-next-line @typescript-eslint/no-explicit-any
-            }));
-            return found.length > 0 ? found[0][this.valueField] : undefined;
-        })));
-    }
-    /**
-     * Sets multiple keys in the Convex database.
-     * @param keyValuePairs Array of key-value pairs to be set.
-     * @returns Promise that resolves when all keys have been set.
-     */
-    async mset(keyValuePairs) {
-        // TODO: Remove chunking when Convex handles the concurrent requests correctly
-        const PAGE_SIZE = 16;
-        for (let i = 0; i < keyValuePairs.length; i += PAGE_SIZE) {
-            await Promise.all(keyValuePairs.slice(i, i + PAGE_SIZE).map(([key, value]) => this.ctx.runMutation(this.upsert, {
-                table: this.table,
-                index: this.index,
-                keyField: this.keyField,
-                key,
-                document: { [this.keyField]: key, [this.valueField]: value },
-                // eslint-disable-next-line @typescript-eslint/no-explicit-any
-            })));
-        }
-    }
-    /**
-     * Deletes multiple keys from the Convex database.
-     * @param keys Array of keys to be deleted.
-     * @returns Promise that resolves when all keys have been deleted.
-     */
-    async mdelete(keys) {
-        await Promise.all(keys.map((key) => this.ctx.runMutation(this.deleteMany, {
-            table: this.table,
-            index: this.index,
-            keyField: this.keyField,
-            key,
-            // eslint-disable-next-line @typescript-eslint/no-explicit-any
-        })));
-    }
-    /**
-     * Yields keys from the Convex database.
-     * @param prefix Optional prefix to filter the keys.
-     * @returns An AsyncGenerator that yields keys from the Convex database.
-     */
-    // eslint-disable-next-line require-yield
-    async *yieldKeys(_prefix) {
-        throw new Error("yieldKeys not implemented yet for ConvexKVStore");
-    }
-}
+export * from "@langchain/community/storage/convex";