langchain 0.0.202 → 0.0.204-rc.0

package/dist/tools/serper.js

@@ -1,92 +1 @@
-import { getEnvironmentVariable } from "../util/env.js";
-import { Tool } from "./base.js";
-/**
- * Wrapper around serper.
- *
- * You can create a free API key at https://serper.dev.
- *
- * To use, you should have the SERPER_API_KEY environment variable set.
- */
-export class Serper extends Tool {
-    static lc_name() {
-        return "Serper";
-    }
-    /**
-     * Converts the Serper instance to JSON. This method is not implemented
-     * and will throw an error if called.
-     * @returns Throws an error.
-     */
-    toJSON() {
-        return this.toJSONNotImplemented();
-    }
-    constructor(apiKey = getEnvironmentVariable("SERPER_API_KEY"), params = {}) {
-        super();
-        Object.defineProperty(this, "key", {
-            enumerable: true,
-            configurable: true,
-            writable: true,
-            value: void 0
-        });
-        Object.defineProperty(this, "params", {
-            enumerable: true,
-            configurable: true,
-            writable: true,
-            value: void 0
-        });
-        Object.defineProperty(this, "name", {
-            enumerable: true,
-            configurable: true,
-            writable: true,
-            value: "search"
-        });
-        Object.defineProperty(this, "description", {
-            enumerable: true,
-            configurable: true,
-            writable: true,
-            value: "a search engine. useful for when you need to answer questions about current events. input should be a search query."
-        });
-        if (!apiKey) {
-            throw new Error("Serper API key not set. You can set it as SERPER_API_KEY in your .env file, or pass it to Serper.");
-        }
-        this.key = apiKey;
-        this.params = params;
-    }
-    /** @ignore */
-    async _call(input) {
-        const options = {
-            method: "POST",
-            headers: {
-                "X-API-KEY": this.key,
-                "Content-Type": "application/json",
-            },
-            body: JSON.stringify({
-                q: input,
-                ...this.params,
-            }),
-        };
-        const res = await fetch("https://google.serper.dev/search", options);
-        if (!res.ok) {
-            throw new Error(`Got ${res.status} error from serper: ${res.statusText}`);
-        }
-        const json = await res.json();
-        if (json.answerBox?.answer) {
-            return json.answerBox.answer;
-        }
-        if (json.answerBox?.snippet) {
-            return json.answerBox.snippet;
-        }
-        if (json.answerBox?.snippet_highlighted_words) {
-            return json.answerBox.snippet_highlighted_words[0];
-        }
-        if (json.sportsResults?.game_spotlight) {
-            return json.sportsResults.game_spotlight;
-        }
-        if (json.knowledgeGraph?.description) {
-            return json.knowledgeGraph.description;
-        }
-        if (json.organic?.[0]?.snippet) {
-            return json.organic[0].snippet;
-        }
-        return "No good search result found";
-    }
-}
+export * from "@langchain/community/tools/serper";

package/dist/tools/wikipedia_query_run.cjs

@@ -1,135 +1,17 @@
 "use strict";
-Object.defineProperty(exports, "__esModule", { value: true });
-exports.WikipediaQueryRun = void 0;
-const base_js_1 = require("./base.cjs");
-/**
- * Class for interacting with and fetching data from the Wikipedia API. It
- * extends the Tool class.
- * @example
- * ```typescript
- * const wikipediaQuery = new WikipediaQueryRun({
- *   topKResults: 3,
- *   maxDocContentLength: 4000,
- * });
- * const result = await wikipediaQuery.call("Langchain");
- * ```
- */
-class WikipediaQueryRun extends base_js_1.Tool {
-    static lc_name() {
-        return "WikipediaQueryRun";
-    }
-    constructor(params = {}) {
-        super();
-        Object.defineProperty(this, "name", {
-            enumerable: true,
-            configurable: true,
-            writable: true,
-            value: "wikipedia-api"
-        });
-        Object.defineProperty(this, "description", {
-            enumerable: true,
-            configurable: true,
-            writable: true,
-            value: "A tool for interacting with and fetching data from the Wikipedia API."
-        });
-        Object.defineProperty(this, "topKResults", {
-            enumerable: true,
-            configurable: true,
-            writable: true,
-            value: 3
-        });
-        Object.defineProperty(this, "maxDocContentLength", {
-            enumerable: true,
-            configurable: true,
-            writable: true,
-            value: 4000
-        });
-        Object.defineProperty(this, "baseUrl", {
-            enumerable: true,
-            configurable: true,
-            writable: true,
-            value: "https://en.wikipedia.org/w/api.php"
-        });
-        this.topKResults = params.topKResults ?? this.topKResults;
-        this.maxDocContentLength =
-            params.maxDocContentLength ?? this.maxDocContentLength;
-        this.baseUrl = params.baseUrl ?? this.baseUrl;
-    }
-    async _call(query) {
-        const searchResults = await this._fetchSearchResults(query);
-        const summaries = [];
-        for (let i = 0; i < Math.min(this.topKResults, searchResults.query.search.length); i += 1) {
-            const page = searchResults.query.search[i].title;
-            const pageDetails = await this._fetchPage(page, true);
-            if (pageDetails) {
-                const summary = `Page: ${page}\nSummary: ${pageDetails.extract}`;
-                summaries.push(summary);
-            }
-        }
-        if (summaries.length === 0) {
-            return "No good Wikipedia Search Result was found";
-        }
-        else {
-            return summaries.join("\n\n").slice(0, this.maxDocContentLength);
-        }
-    }
-    /**
-     * Fetches the content of a specific Wikipedia page. It returns the
-     * extracted content as a string.
-     * @param page The specific Wikipedia page to fetch its content.
-     * @param redirect A boolean value to indicate whether to redirect or not.
-     * @returns The extracted content of the specific Wikipedia page as a string.
-     */
-    async content(page, redirect = true) {
-        try {
-            const result = await this._fetchPage(page, redirect);
-            return result.extract;
-        }
-        catch (error) {
-            throw new Error(`Failed to fetch content for page "${page}": ${error}`);
-        }
+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]; } };
     }
-    /**
-     * Builds a URL for the Wikipedia API using the provided parameters.
-     * @param parameters The parameters to be used in building the URL.
-     * @returns A string representing the built URL.
-     */
-    buildUrl(parameters) {
-        const nonUndefinedParams = Object.entries(parameters)
-            .filter(([_, value]) => value !== undefined)
-            .map(([key, value]) => [key, `${value}`]);
-        const searchParams = new URLSearchParams(nonUndefinedParams);
-        return `${this.baseUrl}?${searchParams}`;
-    }
-    async _fetchSearchResults(query) {
-        const searchParams = new URLSearchParams({
-            action: "query",
-            list: "search",
-            srsearch: query,
-            format: "json",
-        });
-        const response = await fetch(`${this.baseUrl}?${searchParams.toString()}`);
-        if (!response.ok)
-            throw new Error("Network response was not ok");
-        const data = await response.json();
-        return data;
-    }
-    async _fetchPage(page, redirect) {
-        const params = new URLSearchParams({
-            action: "query",
-            prop: "extracts",
-            explaintext: "true",
-            redirects: redirect ? "1" : "0",
-            format: "json",
-            titles: page,
-        });
-        const response = await fetch(`${this.baseUrl}?${params.toString()}`);
-        if (!response.ok)
-            throw new Error("Network response was not ok");
-        const data = await response.json();
-        const { pages } = data.query;
-        const pageId = Object.keys(pages)[0];
-        return pages[pageId];
-    }
-}
-exports.WikipediaQueryRun = WikipediaQueryRun;
+    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/tools/wikipedia_query_run"), exports);

package/dist/tools/wikipedia_query_run.d.ts

@@ -1,54 +1 @@
-import { Tool } from "./base.js";
-/**
- * Interface for the parameters that can be passed to the
- * WikipediaQueryRun constructor.
- */
-export interface WikipediaQueryRunParams {
-    topKResults?: number;
-    maxDocContentLength?: number;
-    baseUrl?: string;
-}
-/**
- * Type alias for URL parameters. Represents a record where keys are
- * strings and values can be string, number, boolean, undefined, or null.
- */
-type UrlParameters = Record<string, string | number | boolean | undefined | null>;
-/**
- * Class for interacting with and fetching data from the Wikipedia API. It
- * extends the Tool class.
- * @example
- * ```typescript
- * const wikipediaQuery = new WikipediaQueryRun({
- *   topKResults: 3,
- *   maxDocContentLength: 4000,
- * });
- * const result = await wikipediaQuery.call("Langchain");
- * ```
- */
-export declare class WikipediaQueryRun extends Tool {
-    static lc_name(): string;
-    name: string;
-    description: string;
-    protected topKResults: number;
-    protected maxDocContentLength: number;
-    protected baseUrl: string;
-    constructor(params?: WikipediaQueryRunParams);
-    _call(query: string): Promise<string>;
-    /**
-     * Fetches the content of a specific Wikipedia page. It returns the
-     * extracted content as a string.
-     * @param page The specific Wikipedia page to fetch its content.
-     * @param redirect A boolean value to indicate whether to redirect or not.
-     * @returns The extracted content of the specific Wikipedia page as a string.
-     */
-    content(page: string, redirect?: boolean): Promise<string>;
-    /**
-     * Builds a URL for the Wikipedia API using the provided parameters.
-     * @param parameters The parameters to be used in building the URL.
-     * @returns A string representing the built URL.
-     */
-    protected buildUrl<P extends UrlParameters>(parameters: P): string;
-    private _fetchSearchResults;
-    private _fetchPage;
-}
-export {};
+export * from "@langchain/community/tools/wikipedia_query_run";

package/dist/tools/wikipedia_query_run.js

@@ -1,131 +1 @@
-import { Tool } from "./base.js";
-/**
- * Class for interacting with and fetching data from the Wikipedia API. It
- * extends the Tool class.
- * @example
- * ```typescript
- * const wikipediaQuery = new WikipediaQueryRun({
- *   topKResults: 3,
- *   maxDocContentLength: 4000,
- * });
- * const result = await wikipediaQuery.call("Langchain");
- * ```
- */
-export class WikipediaQueryRun extends Tool {
-    static lc_name() {
-        return "WikipediaQueryRun";
-    }
-    constructor(params = {}) {
-        super();
-        Object.defineProperty(this, "name", {
-            enumerable: true,
-            configurable: true,
-            writable: true,
-            value: "wikipedia-api"
-        });
-        Object.defineProperty(this, "description", {
-            enumerable: true,
-            configurable: true,
-            writable: true,
-            value: "A tool for interacting with and fetching data from the Wikipedia API."
-        });
-        Object.defineProperty(this, "topKResults", {
-            enumerable: true,
-            configurable: true,
-            writable: true,
-            value: 3
-        });
-        Object.defineProperty(this, "maxDocContentLength", {
-            enumerable: true,
-            configurable: true,
-            writable: true,
-            value: 4000
-        });
-        Object.defineProperty(this, "baseUrl", {
-            enumerable: true,
-            configurable: true,
-            writable: true,
-            value: "https://en.wikipedia.org/w/api.php"
-        });
-        this.topKResults = params.topKResults ?? this.topKResults;
-        this.maxDocContentLength =
-            params.maxDocContentLength ?? this.maxDocContentLength;
-        this.baseUrl = params.baseUrl ?? this.baseUrl;
-    }
-    async _call(query) {
-        const searchResults = await this._fetchSearchResults(query);
-        const summaries = [];
-        for (let i = 0; i < Math.min(this.topKResults, searchResults.query.search.length); i += 1) {
-            const page = searchResults.query.search[i].title;
-            const pageDetails = await this._fetchPage(page, true);
-            if (pageDetails) {
-                const summary = `Page: ${page}\nSummary: ${pageDetails.extract}`;
-                summaries.push(summary);
-            }
-        }
-        if (summaries.length === 0) {
-            return "No good Wikipedia Search Result was found";
-        }
-        else {
-            return summaries.join("\n\n").slice(0, this.maxDocContentLength);
-        }
-    }
-    /**
-     * Fetches the content of a specific Wikipedia page. It returns the
-     * extracted content as a string.
-     * @param page The specific Wikipedia page to fetch its content.
-     * @param redirect A boolean value to indicate whether to redirect or not.
-     * @returns The extracted content of the specific Wikipedia page as a string.
-     */
-    async content(page, redirect = true) {
-        try {
-            const result = await this._fetchPage(page, redirect);
-            return result.extract;
-        }
-        catch (error) {
-            throw new Error(`Failed to fetch content for page "${page}": ${error}`);
-        }
-    }
-    /**
-     * Builds a URL for the Wikipedia API using the provided parameters.
-     * @param parameters The parameters to be used in building the URL.
-     * @returns A string representing the built URL.
-     */
-    buildUrl(parameters) {
-        const nonUndefinedParams = Object.entries(parameters)
-            .filter(([_, value]) => value !== undefined)
-            .map(([key, value]) => [key, `${value}`]);
-        const searchParams = new URLSearchParams(nonUndefinedParams);
-        return `${this.baseUrl}?${searchParams}`;
-    }
-    async _fetchSearchResults(query) {
-        const searchParams = new URLSearchParams({
-            action: "query",
-            list: "search",
-            srsearch: query,
-            format: "json",
-        });
-        const response = await fetch(`${this.baseUrl}?${searchParams.toString()}`);
-        if (!response.ok)
-            throw new Error("Network response was not ok");
-        const data = await response.json();
-        return data;
-    }
-    async _fetchPage(page, redirect) {
-        const params = new URLSearchParams({
-            action: "query",
-            prop: "extracts",
-            explaintext: "true",
-            redirects: redirect ? "1" : "0",
-            format: "json",
-            titles: page,
-        });
-        const response = await fetch(`${this.baseUrl}?${params.toString()}`);
-        if (!response.ok)
-            throw new Error("Network response was not ok");
-        const data = await response.json();
-        const { pages } = data.query;
-        const pageId = Object.keys(pages)[0];
-        return pages[pageId];
-    }
-}
+export * from "@langchain/community/tools/wikipedia_query_run";

package/dist/tools/wolframalpha.cjs

@@ -1,49 +1,17 @@
 "use strict";
-Object.defineProperty(exports, "__esModule", { value: true });
-exports.WolframAlphaTool = void 0;
-const base_js_1 = require("./base.cjs");
-/**
- * @example
- * ```typescript
- * const tool = new WolframAlphaTool({
- *   appid: "YOUR_APP_ID",
- * });
- * const res = await tool.invoke("What is 2 * 2?");
- * ```
- */
-class WolframAlphaTool extends base_js_1.Tool {
-    constructor(fields) {
-        super(fields);
-        Object.defineProperty(this, "appid", {
-            enumerable: true,
-            configurable: true,
-            writable: true,
-            value: void 0
-        });
-        Object.defineProperty(this, "name", {
-            enumerable: true,
-            configurable: true,
-            writable: true,
-            value: "wolfram_alpha"
-        });
-        Object.defineProperty(this, "description", {
-            enumerable: true,
-            configurable: true,
-            writable: true,
-            value: `A wrapper around Wolfram Alpha. Useful for when you need to answer questions about Math, Science, Technology, Culture, Society and Everyday Life. Input should be a search query.`
-        });
-        this.appid = fields.appid;
-    }
-    get lc_namespace() {
-        return [...super.lc_namespace, "wolframalpha"];
-    }
-    static lc_name() {
-        return "WolframAlphaTool";
+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]; } };
     }
-    async _call(query) {
-        const url = `https://www.wolframalpha.com/api/v1/llm-api?appid=${this.appid}&input=${encodeURIComponent(query)}`;
-        const res = await fetch(url);
-        return res.text();
-    }
-}
-exports.WolframAlphaTool = WolframAlphaTool;
+    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/tools/wolframalpha"), exports);

package/dist/tools/wolframalpha.d.ts

@@ -1,21 +1 @@
-import { Tool, ToolParams } from "./base.js";
-/**
- * @example
- * ```typescript
- * const tool = new WolframAlphaTool({
- *   appid: "YOUR_APP_ID",
- * });
- * const res = await tool.invoke("What is 2 * 2?");
- * ```
- */
-export declare class WolframAlphaTool extends Tool {
-    appid: string;
-    name: string;
-    description: string;
-    constructor(fields: ToolParams & {
-        appid: string;
-    });
-    get lc_namespace(): string[];
-    static lc_name(): string;
-    _call(query: string): Promise<string>;
-}
+export * from "@langchain/community/tools/wolframalpha";

package/dist/tools/wolframalpha.js

@@ -1,45 +1 @@
-import { Tool } from "./base.js";
-/**
- * @example
- * ```typescript
- * const tool = new WolframAlphaTool({
- *   appid: "YOUR_APP_ID",
- * });
- * const res = await tool.invoke("What is 2 * 2?");
- * ```
- */
-export class WolframAlphaTool extends Tool {
-    constructor(fields) {
-        super(fields);
-        Object.defineProperty(this, "appid", {
-            enumerable: true,
-            configurable: true,
-            writable: true,
-            value: void 0
-        });
-        Object.defineProperty(this, "name", {
-            enumerable: true,
-            configurable: true,
-            writable: true,
-            value: "wolfram_alpha"
-        });
-        Object.defineProperty(this, "description", {
-            enumerable: true,
-            configurable: true,
-            writable: true,
-            value: `A wrapper around Wolfram Alpha. Useful for when you need to answer questions about Math, Science, Technology, Culture, Society and Everyday Life. Input should be a search query.`
-        });
-        this.appid = fields.appid;
-    }
-    get lc_namespace() {
-        return [...super.lc_namespace, "wolframalpha"];
-    }
-    static lc_name() {
-        return "WolframAlphaTool";
-    }
-    async _call(query) {
-        const url = `https://www.wolframalpha.com/api/v1/llm-api?appid=${this.appid}&input=${encodeURIComponent(query)}`;
-        const res = await fetch(url);
-        return res.text();
-    }
-}
+export * from "@langchain/community/tools/wolframalpha";

package/dist/types/openai-types.d.ts

@@ -1,4 +1,4 @@
-import type { OpenAI as OpenAIClient } from "openai";
+import type { OpenAIClient } from "@langchain/openai";
 import { TiktokenModel } from "js-tiktoken/lite";
 import { BaseLanguageModelCallOptions } from "../base_language/index.js";
 export type { TiktokenModel };

package/dist/util/convex.d.ts

@@ -13,8 +13,8 @@ export declare const lookup: import("convex/server").RegisteredQuery<"internal",
 }, Promise<any[]>>;
 export declare const upsert: import("convex/server").RegisteredMutation<"internal", {
     key: string;
-    index: string;
     document: any;
+    index: string;
     table: string;
     keyField: string;
 }, Promise<void>>;