langchain 0.0.202 → 0.0.204-rc.0

package/dist/tools/google_places.js

@@ -1,77 +1 @@
-import { getEnvironmentVariable } from "../util/env.js";
-import { Tool } from "./base.js";
-/**
- * Tool that queries the Google Places API
- */
-export class GooglePlacesAPI extends Tool {
-    static lc_name() {
-        return "GooglePlacesAPI";
-    }
-    get lc_secrets() {
-        return {
-            apiKey: "GOOGLE_PLACES_API_KEY",
-        };
-    }
-    constructor(fields) {
-        super(...arguments);
-        Object.defineProperty(this, "name", {
-            enumerable: true,
-            configurable: true,
-            writable: true,
-            value: "google_places"
-        });
-        Object.defineProperty(this, "apiKey", {
-            enumerable: true,
-            configurable: true,
-            writable: true,
-            value: void 0
-        });
-        Object.defineProperty(this, "description", {
-            enumerable: true,
-            configurable: true,
-            writable: true,
-            value: `A wrapper around Google Places API. Useful for when you need to validate or 
-  discover addresses from ambiguous text. Input should be a search query.`
-        });
-        const apiKey = fields?.apiKey ?? getEnvironmentVariable("GOOGLE_PLACES_API_KEY");
-        if (apiKey === undefined) {
-            throw new Error(`Google Places API key not set. You can set it as "GOOGLE_PLACES_API_KEY" in your environment variables.`);
-        }
-        this.apiKey = apiKey;
-    }
-    async _call(input) {
-        const res = await fetch(`https://places.googleapis.com/v1/places:searchText`, {
-            method: "POST",
-            body: JSON.stringify({
-                textQuery: input,
-                languageCode: "en",
-            }),
-            headers: {
-                "X-Goog-Api-Key": this.apiKey,
-                "X-Goog-FieldMask": "places.displayName,places.formattedAddress,places.id,places.internationalPhoneNumber,places.websiteUri",
-                "Content-Type": "application/json",
-            },
-        });
-        if (!res.ok) {
-            let message;
-            try {
-                const json = await res.json();
-                message = json.error.message;
-            }
-            catch (e) {
-                message =
-                    "Unable to parse error message: Google did not return a JSON response.";
-            }
-            throw new Error(`Got ${res.status}: ${res.statusText} error from Google Places API: ${message}`);
-        }
-        const json = await res.json();
-        const results = json?.places?.map((place) => ({
-            name: place.displayName?.text,
-            id: place.id,
-            address: place.formattedAddress,
-            phoneNumber: place.internationalPhoneNumber,
-            website: place.websiteUri,
-        })) ?? [];
-        return JSON.stringify(results);
-    }
-}
+export * from "@langchain/community/tools/google_places";

package/dist/tools/searchapi.cjs

@@ -1,166 +1,17 @@
 "use strict";
-Object.defineProperty(exports, "__esModule", { value: true });
-exports.SearchApi = void 0;
-const env_js_1 = require("../util/env.cjs");
-const base_js_1 = require("./base.cjs");
-function isJSONObject(value) {
-    return value !== null && typeof value === "object" && !Array.isArray(value);
-}
-/**
- * SearchApi Class Definition.
- *
- * Provides a wrapper around the SearchApi.
- *
- * Ensure you've set the SEARCHAPI_API_KEY environment variable for authentication.
- * You can obtain a free API key from https://www.searchapi.io/.
- * @example
- * ```typescript
- * const searchApi = new SearchApi("your-api-key", {
- *   engine: "google_news",
- * });
- * const agent = RunnableSequence.from([
- *   ChatPromptTemplate.fromMessages([
- *     ["ai", "Answer the following questions using a bulleted list markdown format.""],
- *     ["human", "{input}"],
- *   ]),
- *   new ChatOpenAI({ temperature: 0 }),
- *   (input: BaseMessageChunk) => ({
- *     log: "test",
- *     returnValues: {
- *       output: input,
- *     },
- *   }),
- * ]);
- * const executor = AgentExecutor.fromAgentAndTools({
- *   agent,
- *   tools: [searchApi],
- * });
- * const res = await executor.invoke({
- *   input: "What's happening in Ukraine today?"",
- * });
- * console.log(res);
- * ```
- */
-class SearchApi extends base_js_1.Tool {
-    static lc_name() {
-        return "SearchApi";
-    }
-    /**
-     * Converts the SearchApi 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 = (0, env_js_1.getEnvironmentVariable)("SEARCHAPI_API_KEY"), params = {}) {
-        super(...arguments);
-        Object.defineProperty(this, "apiKey", {
-            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("SearchApi requires an API key. Please set it as SEARCHAPI_API_KEY in your .env file, or pass it as a parameter to the SearchApi constructor.");
-        }
-        this.apiKey = apiKey;
-        this.params = params;
+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 SearchApi request.
-     * @param parameters The parameters for the request.
-     * @returns A string representing the built URL.
-     */
-    buildUrl(searchQuery) {
-        const preparedParams = Object.entries({
-            engine: "google",
-            api_key: this.apiKey,
-            ...this.params,
-            q: searchQuery,
-        })
-            .filter(([key, value]) => value !== undefined && value !== null && key !== "apiKey")
-            .map(([key, value]) => [key, `${value}`]);
-        const searchParams = new URLSearchParams(preparedParams);
-        return `https://www.searchapi.io/api/v1/search?${searchParams}`;
-    }
-    /** @ignore */
-    /**
-     * Calls the SearchAPI.
-     *
-     * Accepts an input query and fetches the result from SearchApi.
-     *
-     * @param {string} input - Search query.
-     * @returns {string} - Formatted search results or an error message.
-     *
-     * NOTE: This method is the core search handler and processes various types
-     * of search results including Google organic results, videos, jobs, and images.
-     */
-    async _call(input) {
-        const resp = await fetch(this.buildUrl(input));
-        const json = await resp.json();
-        if (json.error) {
-            throw new Error(`Failed to load search results from SearchApi due to: ${json.error}`);
-        }
-        // Google Search results
-        if (json.answer_box?.answer) {
-            return json.answer_box.answer;
-        }
-        if (json.answer_box?.snippet) {
-            return json.answer_box.snippet;
-        }
-        if (json.knowledge_graph?.description) {
-            return json.knowledge_graph.description;
-        }
-        // Organic results (Google, Google News)
-        if (json.organic_results) {
-            const snippets = json.organic_results
-                .filter((r) => r.snippet)
-                .map((r) => r.snippet);
-            return snippets.join("\n");
-        }
-        // Google Jobs results
-        if (json.jobs) {
-            const jobDescriptions = json.jobs
-                .slice(0, 1)
-                .filter((r) => r.description)
-                .map((r) => r.description);
-            return jobDescriptions.join("\n");
-        }
-        // Google Videos results
-        if (json.videos) {
-            const videoInfo = json.videos
-                .filter((r) => r.title && r.link)
-                .map((r) => `Title: "${r.title}" Link: ${r.link}`);
-            return videoInfo.join("\n");
-        }
-        // Google Images results
-        if (json.images) {
-            const image_results = json.images.slice(0, 15);
-            const imageInfo = image_results
-                .filter((r) => r.title && r.original && isJSONObject(r.original) && r.original.link)
-                .map((r) => `Title: "${r.title}" Link: ${r.original.link}`);
-            return imageInfo.join("\n");
-        }
-        return "No good search result found";
-    }
-}
-exports.SearchApi = SearchApi;
+    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/searchapi"), exports);

package/dist/tools/searchapi.d.ts

@@ -1,91 +1 @@
-import { Tool } from "./base.js";
-type JSONPrimitive = string | number | boolean | null;
-type JSONValue = JSONPrimitive | JSONObject | JSONArray;
-interface JSONObject {
-    [key: string]: JSONValue;
-}
-interface JSONArray extends Array<JSONValue> {
-}
-/**
- * SearchApiParameters Type Definition.
- *
- * For more parameters and supported search engines, refer specific engine documentation:
- * Google - https://www.searchapi.io/docs/google
- * Google News - https://www.searchapi.io/docs/google-news
- * Google Scholar - https://www.searchapi.io/docs/google-scholar
- * YouTube Transcripts - https://www.searchapi.io/docs/youtube-transcripts
- * and others.
- *
- */
-export type SearchApiParameters = {
-    [key: string]: JSONValue;
-};
-/**
- * SearchApi Class Definition.
- *
- * Provides a wrapper around the SearchApi.
- *
- * Ensure you've set the SEARCHAPI_API_KEY environment variable for authentication.
- * You can obtain a free API key from https://www.searchapi.io/.
- * @example
- * ```typescript
- * const searchApi = new SearchApi("your-api-key", {
- *   engine: "google_news",
- * });
- * const agent = RunnableSequence.from([
- *   ChatPromptTemplate.fromMessages([
- *     ["ai", "Answer the following questions using a bulleted list markdown format.""],
- *     ["human", "{input}"],
- *   ]),
- *   new ChatOpenAI({ temperature: 0 }),
- *   (input: BaseMessageChunk) => ({
- *     log: "test",
- *     returnValues: {
- *       output: input,
- *     },
- *   }),
- * ]);
- * const executor = AgentExecutor.fromAgentAndTools({
- *   agent,
- *   tools: [searchApi],
- * });
- * const res = await executor.invoke({
- *   input: "What's happening in Ukraine today?"",
- * });
- * console.log(res);
- * ```
- */
-export declare class SearchApi extends Tool {
-    static lc_name(): string;
-    /**
-     * Converts the SearchApi instance to JSON. This method is not implemented
-     * and will throw an error if called.
-     * @returns Throws an error.
-     */
-    toJSON(): import("@langchain/core/load/serializable").SerializedNotImplemented;
-    protected apiKey: string;
-    protected params: Partial<SearchApiParameters>;
-    constructor(apiKey?: string | undefined, params?: Partial<SearchApiParameters>);
-    name: string;
-    /**
-     * Builds a URL for the SearchApi request.
-     * @param parameters The parameters for the request.
-     * @returns A string representing the built URL.
-     */
-    protected buildUrl(searchQuery: string): string;
-    /** @ignore */
-    /**
-     * Calls the SearchAPI.
-     *
-     * Accepts an input query and fetches the result from SearchApi.
-     *
-     * @param {string} input - Search query.
-     * @returns {string} - Formatted search results or an error message.
-     *
-     * NOTE: This method is the core search handler and processes various types
-     * of search results including Google organic results, videos, jobs, and images.
-     */
-    _call(input: string): Promise<any>;
-    description: string;
-}
-export {};
+export * from "@langchain/community/tools/searchapi";

package/dist/tools/searchapi.js

@@ -1,162 +1 @@
-import { getEnvironmentVariable } from "../util/env.js";
-import { Tool } from "./base.js";
-function isJSONObject(value) {
-    return value !== null && typeof value === "object" && !Array.isArray(value);
-}
-/**
- * SearchApi Class Definition.
- *
- * Provides a wrapper around the SearchApi.
- *
- * Ensure you've set the SEARCHAPI_API_KEY environment variable for authentication.
- * You can obtain a free API key from https://www.searchapi.io/.
- * @example
- * ```typescript
- * const searchApi = new SearchApi("your-api-key", {
- *   engine: "google_news",
- * });
- * const agent = RunnableSequence.from([
- *   ChatPromptTemplate.fromMessages([
- *     ["ai", "Answer the following questions using a bulleted list markdown format.""],
- *     ["human", "{input}"],
- *   ]),
- *   new ChatOpenAI({ temperature: 0 }),
- *   (input: BaseMessageChunk) => ({
- *     log: "test",
- *     returnValues: {
- *       output: input,
- *     },
- *   }),
- * ]);
- * const executor = AgentExecutor.fromAgentAndTools({
- *   agent,
- *   tools: [searchApi],
- * });
- * const res = await executor.invoke({
- *   input: "What's happening in Ukraine today?"",
- * });
- * console.log(res);
- * ```
- */
-export class SearchApi extends Tool {
-    static lc_name() {
-        return "SearchApi";
-    }
-    /**
-     * Converts the SearchApi 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("SEARCHAPI_API_KEY"), params = {}) {
-        super(...arguments);
-        Object.defineProperty(this, "apiKey", {
-            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("SearchApi requires an API key. Please set it as SEARCHAPI_API_KEY in your .env file, or pass it as a parameter to the SearchApi constructor.");
-        }
-        this.apiKey = apiKey;
-        this.params = params;
-    }
-    /**
-     * Builds a URL for the SearchApi request.
-     * @param parameters The parameters for the request.
-     * @returns A string representing the built URL.
-     */
-    buildUrl(searchQuery) {
-        const preparedParams = Object.entries({
-            engine: "google",
-            api_key: this.apiKey,
-            ...this.params,
-            q: searchQuery,
-        })
-            .filter(([key, value]) => value !== undefined && value !== null && key !== "apiKey")
-            .map(([key, value]) => [key, `${value}`]);
-        const searchParams = new URLSearchParams(preparedParams);
-        return `https://www.searchapi.io/api/v1/search?${searchParams}`;
-    }
-    /** @ignore */
-    /**
-     * Calls the SearchAPI.
-     *
-     * Accepts an input query and fetches the result from SearchApi.
-     *
-     * @param {string} input - Search query.
-     * @returns {string} - Formatted search results or an error message.
-     *
-     * NOTE: This method is the core search handler and processes various types
-     * of search results including Google organic results, videos, jobs, and images.
-     */
-    async _call(input) {
-        const resp = await fetch(this.buildUrl(input));
-        const json = await resp.json();
-        if (json.error) {
-            throw new Error(`Failed to load search results from SearchApi due to: ${json.error}`);
-        }
-        // Google Search results
-        if (json.answer_box?.answer) {
-            return json.answer_box.answer;
-        }
-        if (json.answer_box?.snippet) {
-            return json.answer_box.snippet;
-        }
-        if (json.knowledge_graph?.description) {
-            return json.knowledge_graph.description;
-        }
-        // Organic results (Google, Google News)
-        if (json.organic_results) {
-            const snippets = json.organic_results
-                .filter((r) => r.snippet)
-                .map((r) => r.snippet);
-            return snippets.join("\n");
-        }
-        // Google Jobs results
-        if (json.jobs) {
-            const jobDescriptions = json.jobs
-                .slice(0, 1)
-                .filter((r) => r.description)
-                .map((r) => r.description);
-            return jobDescriptions.join("\n");
-        }
-        // Google Videos results
-        if (json.videos) {
-            const videoInfo = json.videos
-                .filter((r) => r.title && r.link)
-                .map((r) => `Title: "${r.title}" Link: ${r.link}`);
-            return videoInfo.join("\n");
-        }
-        // Google Images results
-        if (json.images) {
-            const image_results = json.images.slice(0, 15);
-            const imageInfo = image_results
-                .filter((r) => r.title && r.original && isJSONObject(r.original) && r.original.link)
-                .map((r) => `Title: "${r.title}" Link: ${r.original.link}`);
-            return imageInfo.join("\n");
-        }
-        return "No good search result found";
-    }
-}
+export * from "@langchain/community/tools/searchapi";

package/dist/tools/searxng_search.cjs

@@ -1,158 +1,17 @@
 "use strict";
-Object.defineProperty(exports, "__esModule", { value: true });
-exports.SearxngSearch = void 0;
-const env_js_1 = require("../util/env.cjs");
-const base_js_1 = require("./base.cjs");
-/**
- * SearxngSearch class represents a meta search engine tool.
- * Use this class when you need to answer questions about current events.
- * The input should be a search query, and the output is a JSON array of the query results.
- *
- * note: works best with *agentType*: `structured-chat-zero-shot-react-description`
- * https://github.com/searxng/searxng
- * @example
- * ```typescript
- * const executor = AgentExecutor.fromAgentAndTools({
- *   agent,
- *   tools: [
- *     new SearxngSearch({
- *       params: {
- *         format: "json",
- *         engines: "google",
- *       },
- *       headers: {},
- *     }),
- *   ],
- * });
- * const result = await executor.invoke({
- *   input: `What is Langchain? Describe in 50 words`,
- * });
- * ```
- */
-class SearxngSearch extends base_js_1.Tool {
-    static lc_name() {
-        return "SearxngSearch";
-    }
-    get lc_secrets() {
-        return {
-            apiBase: "SEARXNG_API_BASE",
-        };
-    }
-    /**
-     * Constructor for the SearxngSearch class
-     * @param apiBase Base URL of the Searxng instance
-     * @param params SearxNG parameters
-     * @param headers Custom headers
-     */
-    constructor({ apiBase, params, headers, }) {
-        super(...arguments);
-        Object.defineProperty(this, "name", {
-            enumerable: true,
-            configurable: true,
-            writable: true,
-            value: "searxng-search"
-        });
-        Object.defineProperty(this, "description", {
-            enumerable: true,
-            configurable: true,
-            writable: true,
-            value: "A meta search engine. Useful for when you need to answer questions about current events. Input should be a search query. Output is a JSON array of the query results"
-        });
-        Object.defineProperty(this, "apiBase", {
-            enumerable: true,
-            configurable: true,
-            writable: true,
-            value: void 0
-        });
-        Object.defineProperty(this, "params", {
-            enumerable: true,
-            configurable: true,
-            writable: true,
-            value: {
-                numResults: 10,
-                pageNumber: 1,
-                format: "json",
-                imageProxy: true,
-                safesearch: 0,
-            }
-        });
-        Object.defineProperty(this, "headers", {
-            enumerable: true,
-            configurable: true,
-            writable: true,
-            value: void 0
-        });
-        this.apiBase = (0, env_js_1.getEnvironmentVariable)("SEARXNG_API_BASE") || apiBase;
-        this.headers = { "content-type": "application/json", ...headers };
-        if (!this.apiBase) {
-            throw new Error(`SEARXNG_API_BASE not set. You can set it as "SEARXNG_API_BASE" in your environment variables.`);
-        }
-        if (params) {
-            this.params = { ...this.params, ...params };
-        }
+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 the URL for the Searxng search.
-     * @param path The path for the URL.
-     * @param parameters The parameters for the URL.
-     * @param baseUrl The base URL.
-     * @returns The complete URL as a string.
-     */
-    buildUrl(path, parameters, baseUrl) {
-        const nonUndefinedParams = Object.entries(parameters)
-            .filter(([_, value]) => value !== undefined)
-            .map(([key, value]) => [key, value.toString()]); // Avoid string conversion
-        const searchParams = new URLSearchParams(nonUndefinedParams);
-        return `${baseUrl}/${path}?${searchParams}`;
-    }
-    async _call(input) {
-        const queryParams = {
-            q: input,
-            ...this.params,
-        };
-        const url = this.buildUrl("search", queryParams, this.apiBase);
-        const resp = await fetch(url, {
-            method: "POST",
-            headers: this.headers,
-            signal: AbortSignal.timeout(5 * 1000), // 5 seconds
-        });
-        if (!resp.ok) {
-            throw new Error(resp.statusText);
-        }
-        const res = await resp.json();
-        if (!res.results.length &&
-            !res.answers.length &&
-            !res.infoboxes.length &&
-            !res.suggestions.length) {
-            return "No good results found.";
-        }
-        else if (res.results.length) {
-            const response = [];
-            res.results.forEach((r) => {
-                response.push(JSON.stringify({
-                    title: r.title || "",
-                    link: r.url || "",
-                    snippet: r.content || "",
-                }));
-            });
-            return response.slice(0, this.params?.numResults).toString();
-        }
-        else if (res.answers.length) {
-            return res.answers[0];
-        }
-        else if (res.infoboxes.length) {
-            return res.infoboxes[0]?.content.replaceAll(/<[^>]+>/gi, "");
-        }
-        else if (res.suggestions.length) {
-            let suggestions = "Suggestions: ";
-            res.suggestions.forEach((s) => {
-                suggestions += `${s}, `;
-            });
-            return suggestions;
-        }
-        else {
-            return "No good results found.";
-        }
-    }
-}
-exports.SearxngSearch = SearxngSearch;
+    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/searxng_search"), exports);