langchain 0.0.212 → 0.0.214

package/dist/retrievers/vespa.cjs

@@ -1,80 +1,17 @@
 "use strict";
-Object.defineProperty(exports, "__esModule", { value: true });
-exports.VespaRetriever = void 0;
-const document_js_1 = require("../document.cjs");
-const base_js_1 = require("./remote/base.cjs");
-/**
- * Class responsible for retrieving data from Vespa. It extends the
- * `RemoteRetriever` class and includes methods for creating the JSON body
- * for a query and processing the JSON response from Vespa.
- * @example
- * ```typescript
- * const retriever = new VespaRetriever({
- *   url: "https:
- *   auth: false,
- *   query_body: {
- *     yql: "select content from paragraph where userQuery()",
- *     hits: 5,
- *     ranking: "documentation",
- *     locale: "en-us",
- *   },
- *   content_field: "content",
- * });
- * const result = await retriever.getRelevantDocuments("what is vespa?");
- * ```
- */
-class VespaRetriever extends base_js_1.RemoteRetriever {
-    static lc_name() {
-        return "VespaRetriever";
-    }
-    constructor(fields) {
-        super(fields);
-        Object.defineProperty(this, "lc_namespace", {
-            enumerable: true,
-            configurable: true,
-            writable: true,
-            value: ["langchain", "retrievers", "vespa"]
-        });
-        Object.defineProperty(this, "query_body", {
-            enumerable: true,
-            configurable: true,
-            writable: true,
-            value: void 0
-        });
-        Object.defineProperty(this, "content_field", {
-            enumerable: true,
-            configurable: true,
-            writable: true,
-            value: void 0
-        });
-        this.query_body = fields.query_body;
-        this.content_field = fields.content_field;
-        this.url = `${this.url}/search/?`;
-    }
-    /**
-     * Method that takes a query string as input and returns a JSON object
-     * that includes the query and the original `query_body`.
-     * @param query The query string to be sent to Vespa.
-     * @returns A JSON object that includes the query and the original `query_body`.
-     */
-    createJsonBody(query) {
-        return {
-            ...this.query_body,
-            query,
-        };
+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]; } };
     }
-    /**
-     * Method that processes the JSON response from Vespa into an array of
-     * `Document` instances. Each `Document` instance includes the content
-     * from the specified `content_field` and the document's ID.
-     * @param json The JSON response from Vespa.
-     * @returns An array of `Document` instances.
-     */
-    processJsonResponse(json) {
-        return json.root.children.map((doc) => new document_js_1.Document({
-            pageContent: doc.fields[this.content_field],
-            metadata: { id: doc.id },
-        }));
-    }
-}
-exports.VespaRetriever = VespaRetriever;
+    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/retrievers/vespa"), exports);

package/dist/retrievers/vespa.d.ts

@@ -1,54 +1 @@
-import { Document } from "../document.js";
-import { RemoteRetriever, RemoteRetrieverValues, RemoteRetrieverParams } from "./remote/base.js";
-export interface VespaRetrieverParams extends RemoteRetrieverParams {
-    /**
-     * The body of the query to send to Vespa
-     */
-    query_body: object;
-    /**
-     * The name of the field the content resides in
-     */
-    content_field: string;
-}
-/**
- * Class responsible for retrieving data from Vespa. It extends the
- * `RemoteRetriever` class and includes methods for creating the JSON body
- * for a query and processing the JSON response from Vespa.
- * @example
- * ```typescript
- * const retriever = new VespaRetriever({
- *   url: "https:
- *   auth: false,
- *   query_body: {
- *     yql: "select content from paragraph where userQuery()",
- *     hits: 5,
- *     ranking: "documentation",
- *     locale: "en-us",
- *   },
- *   content_field: "content",
- * });
- * const result = await retriever.getRelevantDocuments("what is vespa?");
- * ```
- */
-export declare class VespaRetriever extends RemoteRetriever {
-    static lc_name(): string;
-    lc_namespace: string[];
-    query_body: object;
-    content_field: string;
-    constructor(fields: VespaRetrieverParams);
-    /**
-     * Method that takes a query string as input and returns a JSON object
-     * that includes the query and the original `query_body`.
-     * @param query The query string to be sent to Vespa.
-     * @returns A JSON object that includes the query and the original `query_body`.
-     */
-    createJsonBody(query: string): RemoteRetrieverValues;
-    /**
-     * Method that processes the JSON response from Vespa into an array of
-     * `Document` instances. Each `Document` instance includes the content
-     * from the specified `content_field` and the document's ID.
-     * @param json The JSON response from Vespa.
-     * @returns An array of `Document` instances.
-     */
-    processJsonResponse(json: RemoteRetrieverValues): Document[];
-}
+export * from "@langchain/community/retrievers/vespa";

package/dist/retrievers/vespa.js

@@ -1,76 +1 @@
-import { Document } from "../document.js";
-import { RemoteRetriever, } from "./remote/base.js";
-/**
- * Class responsible for retrieving data from Vespa. It extends the
- * `RemoteRetriever` class and includes methods for creating the JSON body
- * for a query and processing the JSON response from Vespa.
- * @example
- * ```typescript
- * const retriever = new VespaRetriever({
- *   url: "https:
- *   auth: false,
- *   query_body: {
- *     yql: "select content from paragraph where userQuery()",
- *     hits: 5,
- *     ranking: "documentation",
- *     locale: "en-us",
- *   },
- *   content_field: "content",
- * });
- * const result = await retriever.getRelevantDocuments("what is vespa?");
- * ```
- */
-export class VespaRetriever extends RemoteRetriever {
-    static lc_name() {
-        return "VespaRetriever";
-    }
-    constructor(fields) {
-        super(fields);
-        Object.defineProperty(this, "lc_namespace", {
-            enumerable: true,
-            configurable: true,
-            writable: true,
-            value: ["langchain", "retrievers", "vespa"]
-        });
-        Object.defineProperty(this, "query_body", {
-            enumerable: true,
-            configurable: true,
-            writable: true,
-            value: void 0
-        });
-        Object.defineProperty(this, "content_field", {
-            enumerable: true,
-            configurable: true,
-            writable: true,
-            value: void 0
-        });
-        this.query_body = fields.query_body;
-        this.content_field = fields.content_field;
-        this.url = `${this.url}/search/?`;
-    }
-    /**
-     * Method that takes a query string as input and returns a JSON object
-     * that includes the query and the original `query_body`.
-     * @param query The query string to be sent to Vespa.
-     * @returns A JSON object that includes the query and the original `query_body`.
-     */
-    createJsonBody(query) {
-        return {
-            ...this.query_body,
-            query,
-        };
-    }
-    /**
-     * Method that processes the JSON response from Vespa into an array of
-     * `Document` instances. Each `Document` instance includes the content
-     * from the specified `content_field` and the document's ID.
-     * @param json The JSON response from Vespa.
-     * @returns An array of `Document` instances.
-     */
-    processJsonResponse(json) {
-        return json.root.children.map((doc) => new Document({
-            pageContent: doc.fields[this.content_field],
-            metadata: { id: doc.id },
-        }));
-    }
-}
+export * from "@langchain/community/retrievers/vespa";

package/dist/schema/runnable/config.d.ts

@@ -1 +1 @@
-export { getCallbackMangerForConfig, RunnableConfig, } from "@langchain/core/runnables";
+export { RunnableConfig } from "@langchain/core/runnables";

package/dist/tools/retriever.cjs

@@ -0,0 +1,17 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.createRetrieverTool = void 0;
+const zod_1 = require("zod");
+const dynamic_1 = require("@langchain/community/tools/dynamic");
+const document_js_1 = require("../util/document.cjs");
+function createRetrieverTool(retriever, input) {
+    const func = async ({ query }, runManager) => {
+        const docs = await retriever.getRelevantDocuments(query, runManager?.getChild("retriever"));
+        return (0, document_js_1.formatDocumentsAsString)(docs);
+    };
+    const schema = zod_1.z.object({
+        query: zod_1.z.string().describe("query to look up in retriever"),
+    });
+    return new dynamic_1.DynamicStructuredTool({ ...input, func, schema });
+}
+exports.createRetrieverTool = createRetrieverTool;

package/dist/tools/retriever.d.ts

@@ -0,0 +1,10 @@
+import type { BaseRetrieverInterface } from "@langchain/core/retrievers";
+import { z } from "zod";
+import { DynamicStructuredTool, type DynamicStructuredToolInput } from "@langchain/community/tools/dynamic";
+export declare function createRetrieverTool(retriever: BaseRetrieverInterface, input: Omit<DynamicStructuredToolInput, "func" | "schema">): DynamicStructuredTool<z.ZodObject<{
+    query: z.ZodString;
+}, "strip", z.ZodTypeAny, {
+    query: string;
+}, {
+    query: string;
+}>>;

package/dist/tools/retriever.js

@@ -0,0 +1,13 @@
+import { z } from "zod";
+import { DynamicStructuredTool, } from "@langchain/community/tools/dynamic";
+import { formatDocumentsAsString } from "../util/document.js";
+export function createRetrieverTool(retriever, input) {
+    const func = async ({ query }, runManager) => {
+        const docs = await retriever.getRelevantDocuments(query, runManager?.getChild("retriever"));
+        return formatDocumentsAsString(docs);
+    };
+    const schema = z.object({
+        query: z.string().describe("query to look up in retriever"),
+    });
+    return new DynamicStructuredTool({ ...input, func, schema });
+}

package/dist/util/entrypoint_deprecation.cjs

@@ -0,0 +1,18 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.logVersion010MigrationWarning = void 0;
+function logVersion010MigrationWarning({ oldEntrypointName, newEntrypointName, newPackageName = "@langchain/community", }) {
+    /* #__PURE__ */ console.warn([
+        `[WARNING]: Importing from "langchain/${oldEntrypointName}" is deprecated.\n`,
+        `Instead, please add the "${newPackageName}" package to your project with e.g.`,
+        ``,
+        `    $ npm install ${newPackageName}`,
+        ``,
+        `and import from "${newPackageName}${newEntrypointName === undefined
+            ? `/${oldEntrypointName}`
+            : newEntrypointName}".`,
+        ``,
+        `This will be mandatory after the next "langchain" minor version bump to 0.2.`,
+    ].join("\n"));
+}
+exports.logVersion010MigrationWarning = logVersion010MigrationWarning;

package/dist/util/entrypoint_deprecation.d.ts

@@ -0,0 +1,5 @@
+export declare function logVersion010MigrationWarning({ oldEntrypointName, newEntrypointName, newPackageName, }: {
+    oldEntrypointName: string;
+    newEntrypointName?: string;
+    newPackageName?: string;
+}): void;

package/dist/util/entrypoint_deprecation.js

@@ -0,0 +1,14 @@
+export function logVersion010MigrationWarning({ oldEntrypointName, newEntrypointName, newPackageName = "@langchain/community", }) {
+    /* #__PURE__ */ console.warn([
+        `[WARNING]: Importing from "langchain/${oldEntrypointName}" is deprecated.\n`,
+        `Instead, please add the "${newPackageName}" package to your project with e.g.`,
+        ``,
+        `    $ npm install ${newPackageName}`,
+        ``,
+        `and import from "${newPackageName}${newEntrypointName === undefined
+            ? `/${oldEntrypointName}`
+            : newEntrypointName}".`,
+        ``,
+        `This will be mandatory after the next "langchain" minor version bump to 0.2.`,
+    ].join("\n"));
+}

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "langchain",
-  "version": "0.0.212",
+  "version": "0.0.214",
   "description": "Typescript bindings for langchain",
   "type": "module",
   "engines": {
@@ -79,6 +79,9 @@
     "tools/render.cjs",
     "tools/render.js",
     "tools/render.d.ts",
+    "tools/retriever.cjs",
+    "tools/retriever.js",
+    "tools/retriever.d.ts",
     "tools/sql.cjs",
     "tools/sql.js",
     "tools/sql.d.ts",
@@ -97,9 +100,15 @@
     "chains.cjs",
     "chains.js",
     "chains.d.ts",
+    "chains/combine_documents.cjs",
+    "chains/combine_documents.js",
+    "chains/combine_documents.d.ts",
     "chains/combine_documents/reduce.cjs",
     "chains/combine_documents/reduce.js",
     "chains/combine_documents/reduce.d.ts",
+    "chains/history_aware_retriever.cjs",
+    "chains/history_aware_retriever.js",
+    "chains/history_aware_retriever.d.ts",
     "chains/load.cjs",
     "chains/load.js",
     "chains/load.d.ts",
@@ -112,6 +121,9 @@
     "chains/query_constructor/ir.cjs",
     "chains/query_constructor/ir.js",
     "chains/query_constructor/ir.d.ts",
+    "chains/retrieval.cjs",
+    "chains/retrieval.js",
+    "chains/retrieval.d.ts",
     "chains/sql_db.cjs",
     "chains/sql_db.js",
     "chains/sql_db.d.ts",
@@ -1178,9 +1190,9 @@
   },
   "dependencies": {
     "@anthropic-ai/sdk": "^0.9.1",
-    "@langchain/community": "~0.0.8",
-    "@langchain/core": "~0.1.3",
-    "@langchain/openai": "~0.0.7",
+    "@langchain/community": "~0.0.13",
+    "@langchain/core": "~0.1.5",
+    "@langchain/openai": "~0.0.9",
     "binary-extensions": "^2.2.0",
     "expr-eval": "^2.0.2",
     "js-tiktoken": "^1.0.7",
@@ -1329,6 +1341,11 @@
       "import": "./tools/render.js",
       "require": "./tools/render.cjs"
     },
+    "./tools/retriever": {
+      "types": "./tools/retriever.d.ts",
+      "import": "./tools/retriever.js",
+      "require": "./tools/retriever.cjs"
+    },
     "./tools/sql": {
       "types": "./tools/sql.d.ts",
       "import": "./tools/sql.js",
@@ -1359,11 +1376,21 @@
       "import": "./chains.js",
       "require": "./chains.cjs"
     },
+    "./chains/combine_documents": {
+      "types": "./chains/combine_documents.d.ts",
+      "import": "./chains/combine_documents.js",
+      "require": "./chains/combine_documents.cjs"
+    },
     "./chains/combine_documents/reduce": {
       "types": "./chains/combine_documents/reduce.d.ts",
       "import": "./chains/combine_documents/reduce.js",
       "require": "./chains/combine_documents/reduce.cjs"
     },
+    "./chains/history_aware_retriever": {
+      "types": "./chains/history_aware_retriever.d.ts",
+      "import": "./chains/history_aware_retriever.js",
+      "require": "./chains/history_aware_retriever.cjs"
+    },
     "./chains/load": {
       "types": "./chains/load.d.ts",
       "import": "./chains/load.js",
@@ -1384,6 +1411,11 @@
       "import": "./chains/query_constructor/ir.js",
       "require": "./chains/query_constructor/ir.cjs"
     },
+    "./chains/retrieval": {
+      "types": "./chains/retrieval.d.ts",
+      "import": "./chains/retrieval.js",
+      "require": "./chains/retrieval.cjs"
+    },
     "./chains/sql_db": {
       "types": "./chains/sql_db.d.ts",
       "import": "./chains/sql_db.js",

package/tools/retriever.cjs

@@ -0,0 +1 @@
+module.exports = require('../dist/tools/retriever.cjs');

package/tools/retriever.d.ts

@@ -0,0 +1 @@
+export * from '../dist/tools/retriever.js'

package/tools/retriever.js

@@ -0,0 +1 @@
+export * from '../dist/tools/retriever.js'

package/dist/callbacks/handlers/tracer_langchain_v1.cjs

@@ -1,17 +0,0 @@
-"use strict";
-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]; } };
-    }
-    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/core/tracers/tracer_langchain_v1"), exports);

package/dist/callbacks/handlers/tracer_langchain_v1.d.ts

@@ -1 +0,0 @@
-export * from "@langchain/core/tracers/tracer_langchain_v1";

package/dist/callbacks/handlers/tracer_langchain_v1.js

@@ -1 +0,0 @@
-export * from "@langchain/core/tracers/tracer_langchain_v1";

package/dist/retrievers/remote/base.cjs

@@ -1,68 +0,0 @@
-"use strict";
-Object.defineProperty(exports, "__esModule", { value: true });
-exports.RemoteRetriever = void 0;
-const retrievers_1 = require("@langchain/core/retrievers");
-const async_caller_js_1 = require("../../util/async_caller.cjs");
-/**
- * Abstract class for interacting with a remote server to retrieve
- * relevant documents based on a given query.
- */
-class RemoteRetriever extends retrievers_1.BaseRetriever {
-    get lc_secrets() {
-        return {
-            "auth.bearer": "REMOTE_RETRIEVER_AUTH_BEARER",
-        };
-    }
-    constructor(fields) {
-        super(fields);
-        Object.defineProperty(this, "url", {
-            enumerable: true,
-            configurable: true,
-            writable: true,
-            value: void 0
-        });
-        Object.defineProperty(this, "auth", {
-            enumerable: true,
-            configurable: true,
-            writable: true,
-            value: void 0
-        });
-        Object.defineProperty(this, "headers", {
-            enumerable: true,
-            configurable: true,
-            writable: true,
-            value: void 0
-        });
-        Object.defineProperty(this, "asyncCaller", {
-            enumerable: true,
-            configurable: true,
-            writable: true,
-            value: void 0
-        });
-        const { url, auth, ...rest } = fields;
-        this.url = url;
-        this.auth = auth;
-        this.headers = {
-            Accept: "application/json",
-            "Content-Type": "application/json",
-            ...(this.auth && this.auth.bearer
-                ? { Authorization: `Bearer ${this.auth.bearer}` }
-                : {}),
-        };
-        this.asyncCaller = new async_caller_js_1.AsyncCaller(rest);
-    }
-    async _getRelevantDocuments(query) {
-        const body = this.createJsonBody(query);
-        const response = await this.asyncCaller.call(() => fetch(this.url, {
-            method: "POST",
-            headers: this.headers,
-            body: JSON.stringify(body),
-        }));
-        if (!response.ok) {
-            throw new Error(`Failed to retrieve documents from ${this.url}: ${response.status} ${response.statusText}`);
-        }
-        const json = await response.json();
-        return this.processJsonResponse(json);
-    }
-}
-exports.RemoteRetriever = RemoteRetriever;

package/dist/retrievers/remote/base.d.ts

@@ -1,60 +0,0 @@
-import { BaseRetriever, type BaseRetrieverInput } from "@langchain/core/retrievers";
-import { AsyncCaller, AsyncCallerParams } from "../../util/async_caller.js";
-import { Document } from "../../document.js";
-/**
- * Type for the authentication method used by the RemoteRetriever. It can
- * either be false (no authentication) or an object with a bearer token.
- */
-export type RemoteRetrieverAuth = false | {
-    bearer: string;
-};
-/**
- * Type for the JSON response values from the remote server.
- */
-export type RemoteRetrieverValues = Record<string, any>;
-/**
- * Interface for the parameters required to initialize a RemoteRetriever
- * instance.
- */
-export interface RemoteRetrieverParams extends AsyncCallerParams, BaseRetrieverInput {
-    /**
-     * The URL of the remote retriever server
-     */
-    url: string;
-    /**
-     * The authentication method to use, currently implemented is
-     * - false: no authentication
-     * - { bearer: string }: Bearer token authentication
-     */
-    auth: RemoteRetrieverAuth;
-}
-/**
- * Abstract class for interacting with a remote server to retrieve
- * relevant documents based on a given query.
- */
-export declare abstract class RemoteRetriever extends BaseRetriever implements RemoteRetrieverParams {
-    get lc_secrets(): {
-        [key: string]: string;
-    } | undefined;
-    url: string;
-    auth: RemoteRetrieverAuth;
-    headers: Record<string, string>;
-    asyncCaller: AsyncCaller;
-    constructor(fields: RemoteRetrieverParams);
-    /**
-     * Abstract method that should be implemented by subclasses to create the
-     * JSON body of the request based on the given query.
-     * @param query The query based on which the JSON body of the request is created.
-     * @returns The JSON body of the request.
-     */
-    abstract createJsonBody(query: string): RemoteRetrieverValues;
-    /**
-     * Abstract method that should be implemented by subclasses to process the
-     * JSON response from the server and convert it into an array of Document
-     * instances.
-     * @param json The JSON response from the server.
-     * @returns An array of Document instances.
-     */
-    abstract processJsonResponse(json: RemoteRetrieverValues): Document[];
-    _getRelevantDocuments(query: string): Promise<Document[]>;
-}

package/dist/retrievers/remote/base.js

@@ -1,64 +0,0 @@
-import { BaseRetriever, } from "@langchain/core/retrievers";
-import { AsyncCaller } from "../../util/async_caller.js";
-/**
- * Abstract class for interacting with a remote server to retrieve
- * relevant documents based on a given query.
- */
-export class RemoteRetriever extends BaseRetriever {
-    get lc_secrets() {
-        return {
-            "auth.bearer": "REMOTE_RETRIEVER_AUTH_BEARER",
-        };
-    }
-    constructor(fields) {
-        super(fields);
-        Object.defineProperty(this, "url", {
-            enumerable: true,
-            configurable: true,
-            writable: true,
-            value: void 0
-        });
-        Object.defineProperty(this, "auth", {
-            enumerable: true,
-            configurable: true,
-            writable: true,
-            value: void 0
-        });
-        Object.defineProperty(this, "headers", {
-            enumerable: true,
-            configurable: true,
-            writable: true,
-            value: void 0
-        });
-        Object.defineProperty(this, "asyncCaller", {
-            enumerable: true,
-            configurable: true,
-            writable: true,
-            value: void 0
-        });
-        const { url, auth, ...rest } = fields;
-        this.url = url;
-        this.auth = auth;
-        this.headers = {
-            Accept: "application/json",
-            "Content-Type": "application/json",
-            ...(this.auth && this.auth.bearer
-                ? { Authorization: `Bearer ${this.auth.bearer}` }
-                : {}),
-        };
-        this.asyncCaller = new AsyncCaller(rest);
-    }
-    async _getRelevantDocuments(query) {
-        const body = this.createJsonBody(query);
-        const response = await this.asyncCaller.call(() => fetch(this.url, {
-            method: "POST",
-            headers: this.headers,
-            body: JSON.stringify(body),
-        }));
-        if (!response.ok) {
-            throw new Error(`Failed to retrieve documents from ${this.url}: ${response.status} ${response.statusText}`);
-        }
-        const json = await response.json();
-        return this.processJsonResponse(json);
-    }
-}