langchain 0.0.202 → 0.0.204-rc.0

package/dist/tools/dataforseo_api_search.js

@@ -1,278 +1 @@
-import { getEnvironmentVariable } from "../util/env.js";
-import { Tool } from "./base.js";
-/**
- * @class DataForSeoAPISearch
- * @extends {Tool}
- * @description Represents a wrapper class to work with DataForSEO SERP API.
- */
-export class DataForSeoAPISearch extends Tool {
-    static lc_name() {
-        return "DataForSeoAPISearch";
-    }
-    /**
-     * @constructor
-     * @param {DataForSeoApiConfig} config
-     * @description Sets up the class, throws an error if the API login/password isn't provided.
-     */
-    constructor(config = {}) {
-        super();
-        Object.defineProperty(this, "name", {
-            enumerable: true,
-            configurable: true,
-            writable: true,
-            value: "dataforseo-api-wrapper"
-        });
-        Object.defineProperty(this, "description", {
-            enumerable: true,
-            configurable: true,
-            writable: true,
-            value: "A robust Google Search API provided by DataForSeo. This tool is handy when you need information about trending topics or current events."
-        });
-        Object.defineProperty(this, "apiLogin", {
-            enumerable: true,
-            configurable: true,
-            writable: true,
-            value: void 0
-        });
-        Object.defineProperty(this, "apiPassword", {
-            enumerable: true,
-            configurable: true,
-            writable: true,
-            value: void 0
-        });
-        /**
-         * @property defaultParams
-         * @type {Record<string, string | number | boolean>}
-         * @description These are the default parameters to be used when making an API request.
-         */
-        Object.defineProperty(this, "defaultParams", {
-            enumerable: true,
-            configurable: true,
-            writable: true,
-            value: {
-                location_name: "United States",
-                language_code: "en",
-                depth: 10,
-                se_name: "google",
-                se_type: "organic",
-            }
-        });
-        Object.defineProperty(this, "params", {
-            enumerable: true,
-            configurable: true,
-            writable: true,
-            value: {}
-        });
-        Object.defineProperty(this, "jsonResultTypes", {
-            enumerable: true,
-            configurable: true,
-            writable: true,
-            value: void 0
-        });
-        Object.defineProperty(this, "jsonResultFields", {
-            enumerable: true,
-            configurable: true,
-            writable: true,
-            value: void 0
-        });
-        Object.defineProperty(this, "topCount", {
-            enumerable: true,
-            configurable: true,
-            writable: true,
-            value: void 0
-        });
-        Object.defineProperty(this, "useJsonOutput", {
-            enumerable: true,
-            configurable: true,
-            writable: true,
-            value: false
-        });
-        const apiLogin = config.apiLogin ?? getEnvironmentVariable("DATAFORSEO_LOGIN");
-        const apiPassword = config.apiPassword ?? getEnvironmentVariable("DATAFORSEO_PASSWORD");
-        const params = config.params ?? {};
-        if (!apiLogin || !apiPassword) {
-            throw new Error("DataForSEO login or password not set. You can set it as DATAFORSEO_LOGIN and DATAFORSEO_PASSWORD in your .env file, or pass it to DataForSeoAPISearch.");
-        }
-        this.params = { ...this.defaultParams, ...params };
-        this.apiLogin = apiLogin;
-        this.apiPassword = apiPassword;
-        this.jsonResultTypes = config.jsonResultTypes;
-        this.jsonResultFields = config.jsonResultFields;
-        this.useJsonOutput = config.useJsonOutput ?? false;
-        this.topCount = config.topCount;
-    }
-    /**
-     * @method _call
-     * @param {string} keyword
-     * @returns {Promise<string>}
-     * @description Initiates a call to the API and processes the response.
-     */
-    async _call(keyword) {
-        return this.useJsonOutput
-            ? JSON.stringify(await this.results(keyword))
-            : this.processResponse(await this.getResponseJson(keyword));
-    }
-    /**
-     * @method results
-     * @param {string} keyword
-     * @returns {Promise<Array<any>>}
-     * @description Fetches the results from the API for the given keyword.
-     */
-    // eslint-disable-next-line @typescript-eslint/no-explicit-any
-    async results(keyword) {
-        const res = await this.getResponseJson(keyword);
-        return this.filterResults(res, this.jsonResultTypes);
-    }
-    /**
-     * @method prepareRequest
-     * @param {string} keyword
-     * @returns {{url: string; headers: HeadersInit; data: BodyInit}}
-     * @description Prepares the request details for the API call.
-     */
-    prepareRequest(keyword) {
-        if (this.apiLogin === undefined || this.apiPassword === undefined) {
-            throw new Error("api_login or api_password is not provided");
-        }
-        const credentials = Buffer.from(`${this.apiLogin}:${this.apiPassword}`, "utf-8").toString("base64");
-        const headers = {
-            Authorization: `Basic ${credentials}`,
-            "Content-Type": "application/json",
-        };
-        const params = { ...this.params };
-        params.keyword ??= keyword;
-        const data = [params];
-        return {
-            url: `https://api.dataforseo.com/v3/serp/${params.se_name}/${params.se_type}/live/advanced`,
-            headers,
-            data: JSON.stringify(data),
-        };
-    }
-    /**
-     * @method getResponseJson
-     * @param {string} keyword
-     * @returns {Promise<ApiResponse>}
-     * @description Executes a POST request to the provided URL and returns a parsed JSON response.
-     */
-    async getResponseJson(keyword) {
-        const requestDetails = this.prepareRequest(keyword);
-        const response = await fetch(requestDetails.url, {
-            method: "POST",
-            headers: requestDetails.headers,
-            body: requestDetails.data,
-        });
-        if (!response.ok) {
-            throw new Error(`Got ${response.status} error from DataForSEO: ${response.statusText}`);
-        }
-        const result = await response.json();
-        return this.checkResponse(result);
-    }
-    /**
-     * @method checkResponse
-     * @param {ApiResponse} response
-     * @returns {ApiResponse}
-     * @description Checks the response status code.
-     */
-    checkResponse(response) {
-        if (response.status_code !== 20000) {
-            throw new Error(`Got error from DataForSEO SERP API: ${response.status_message}`);
-        }
-        for (const task of response.tasks) {
-            if (task.status_code !== 20000) {
-                throw new Error(`Got error from DataForSEO SERP API: ${task.status_message}`);
-            }
-        }
-        return response;
-    }
-    /* eslint-disable @typescript-eslint/no-explicit-any */
-    /**
-     * @method filterResults
-     * @param {ApiResponse} res
-     * @param {Array<string> | undefined} types
-     * @returns {Array<any>}
-     * @description Filters the results based on the specified result types.
-     */
-    filterResults(res, types) {
-        const output = [];
-        for (const task of res.tasks || []) {
-            for (const result of task.result || []) {
-                for (const item of result.items || []) {
-                    if (types === undefined ||
-                        types.length === 0 ||
-                        types.includes(item.type)) {
-                        const newItem = this.cleanupUnnecessaryItems(item);
-                        if (Object.keys(newItem).length !== 0) {
-                            output.push(newItem);
-                        }
-                    }
-                    if (this.topCount !== undefined && output.length >= this.topCount) {
-                        break;
-                    }
-                }
-            }
-        }
-        return output;
-    }
-    /* eslint-disable @typescript-eslint/no-explicit-any */
-    /* eslint-disable no-param-reassign */
-    /**
-     * @method cleanupUnnecessaryItems
-     * @param {any} d
-     * @description Removes unnecessary items from the response.
-     */
-    cleanupUnnecessaryItems(d) {
-        if (Array.isArray(d)) {
-            return d.map((item) => this.cleanupUnnecessaryItems(item));
-        }
-        const toRemove = ["xpath", "position", "rectangle"];
-        if (typeof d === "object" && d !== null) {
-            return Object.keys(d).reduce((newObj, key) => {
-                if ((this.jsonResultFields === undefined ||
-                    this.jsonResultFields.includes(key)) &&
-                    !toRemove.includes(key)) {
-                    if (typeof d[key] === "object" && d[key] !== null) {
-                        newObj[key] = this.cleanupUnnecessaryItems(d[key]);
-                    }
-                    else {
-                        newObj[key] = d[key];
-                    }
-                }
-                return newObj;
-            }, {});
-        }
-        return d;
-    }
-    /**
-     * @method processResponse
-     * @param {ApiResponse} res
-     * @returns {string}
-     * @description Processes the response to extract meaningful data.
-     */
-    processResponse(res) {
-        let returnValue = "No good search result found";
-        for (const task of res.tasks || []) {
-            for (const result of task.result || []) {
-                const { item_types } = result;
-                const items = result.items || [];
-                if (item_types.includes("answer_box")) {
-                    returnValue = items.find((item) => item.type === "answer_box").text;
-                }
-                else if (item_types.includes("knowledge_graph")) {
-                    returnValue = items.find((item) => item.type === "knowledge_graph").description;
-                }
-                else if (item_types.includes("featured_snippet")) {
-                    returnValue = items.find((item) => item.type === "featured_snippet").description;
-                }
-                else if (item_types.includes("shopping")) {
-                    returnValue = items.find((item) => item.type === "shopping").price;
-                }
-                else if (item_types.includes("organic")) {
-                    returnValue = items.find((item) => item.type === "organic").description;
-                }
-                if (returnValue) {
-                    break;
-                }
-            }
-        }
-        return returnValue;
-    }
-}
+export * from "@langchain/community/tools/dataforseo_api_search";

package/dist/tools/gmail/index.cjs

@@ -1,13 +1,17 @@
 "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 });
-exports.GmailSendMessage = exports.GmailSearch = exports.GmailGetThread = exports.GmailGetMessage = exports.GmailCreateDraft = void 0;
-var create_draft_js_1 = require("./create_draft.cjs");
-Object.defineProperty(exports, "GmailCreateDraft", { enumerable: true, get: function () { return create_draft_js_1.GmailCreateDraft; } });
-var get_message_js_1 = require("./get_message.cjs");
-Object.defineProperty(exports, "GmailGetMessage", { enumerable: true, get: function () { return get_message_js_1.GmailGetMessage; } });
-var get_thread_js_1 = require("./get_thread.cjs");
-Object.defineProperty(exports, "GmailGetThread", { enumerable: true, get: function () { return get_thread_js_1.GmailGetThread; } });
-var search_js_1 = require("./search.cjs");
-Object.defineProperty(exports, "GmailSearch", { enumerable: true, get: function () { return search_js_1.GmailSearch; } });
-var send_message_js_1 = require("./send_message.cjs");
-Object.defineProperty(exports, "GmailSendMessage", { enumerable: true, get: function () { return send_message_js_1.GmailSendMessage; } });
+__exportStar(require("@langchain/community/tools/gmail"), exports);

package/dist/tools/gmail/index.d.ts

@@ -1,11 +1 @@
-export { GmailCreateDraft } from "./create_draft.js";
-export { GmailGetMessage } from "./get_message.js";
-export { GmailGetThread } from "./get_thread.js";
-export { GmailSearch } from "./search.js";
-export { GmailSendMessage } from "./send_message.js";
-export type { GmailBaseToolParams } from "./base.js";
-export type { CreateDraftSchema } from "./create_draft.js";
-export type { GetMessageSchema } from "./get_message.js";
-export type { GetThreadSchema } from "./get_thread.js";
-export type { SearchSchema } from "./search.js";
-export type { SendMessageSchema } from "./send_message.js";
+export * from "@langchain/community/tools/gmail";

package/dist/tools/gmail/index.js

@@ -1,5 +1 @@
-export { GmailCreateDraft } from "./create_draft.js";
-export { GmailGetMessage } from "./get_message.js";
-export { GmailGetThread } from "./get_thread.js";
-export { GmailSearch } from "./search.js";
-export { GmailSendMessage } from "./send_message.js";
+export * from "@langchain/community/tools/gmail";

package/dist/tools/google_custom_search.cjs

@@ -1,72 +1,17 @@
 "use strict";
-Object.defineProperty(exports, "__esModule", { value: true });
-exports.GoogleCustomSearch = void 0;
-const env_js_1 = require("../util/env.cjs");
-const base_js_1 = require("./base.cjs");
-/**
- * Class that uses the Google Search API to perform custom searches.
- * Requires environment variables `GOOGLE_API_KEY` and `GOOGLE_CSE_ID` to
- * be set.
- */
-class GoogleCustomSearch extends base_js_1.Tool {
-    static lc_name() {
-        return "GoogleCustomSearch";
-    }
-    get lc_secrets() {
-        return {
-            apiKey: "GOOGLE_API_KEY",
-        };
-    }
-    constructor(fields = {
-        apiKey: (0, env_js_1.getEnvironmentVariable)("GOOGLE_API_KEY"),
-        googleCSEId: (0, env_js_1.getEnvironmentVariable)("GOOGLE_CSE_ID"),
-    }) {
-        super(...arguments);
-        Object.defineProperty(this, "name", {
-            enumerable: true,
-            configurable: true,
-            writable: true,
-            value: "google-custom-search"
-        });
-        Object.defineProperty(this, "apiKey", {
-            enumerable: true,
-            configurable: true,
-            writable: true,
-            value: void 0
-        });
-        Object.defineProperty(this, "googleCSEId", {
-            enumerable: true,
-            configurable: true,
-            writable: true,
-            value: void 0
-        });
-        Object.defineProperty(this, "description", {
-            enumerable: true,
-            configurable: true,
-            writable: true,
-            value: "a custom search engine. useful for when you need to answer questions about current events. input should be a search query. outputs a JSON array of results."
-        });
-        if (!fields.apiKey) {
-            throw new Error(`Google API key not set. You can set it as "GOOGLE_API_KEY" in your environment variables.`);
-        }
-        if (!fields.googleCSEId) {
-            throw new Error(`Google custom search engine id not set. You can set it as "GOOGLE_CSE_ID" in your environment variables.`);
-        }
-        this.apiKey = fields.apiKey;
-        this.googleCSEId = fields.googleCSEId;
+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(input) {
-        const res = await fetch(`https://www.googleapis.com/customsearch/v1?key=${this.apiKey}&cx=${this.googleCSEId}&q=${encodeURIComponent(input)}`);
-        if (!res.ok) {
-            throw new Error(`Got ${res.status} error from Google custom search: ${res.statusText}`);
-        }
-        const json = await res.json();
-        const results = json?.items?.map((item) => ({
-            title: item.title,
-            link: item.link,
-            snippet: item.snippet,
-        })) ?? [];
-        return JSON.stringify(results);
-    }
-}
-exports.GoogleCustomSearch = GoogleCustomSearch;
+    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/google_custom_search"), exports);

package/dist/tools/google_custom_search.d.ts

@@ -1,25 +1 @@
-import { Tool } from "./base.js";
-/**
- * Interface for parameters required by GoogleCustomSearch class.
- */
-export interface GoogleCustomSearchParams {
-    apiKey?: string;
-    googleCSEId?: string;
-}
-/**
- * Class that uses the Google Search API to perform custom searches.
- * Requires environment variables `GOOGLE_API_KEY` and `GOOGLE_CSE_ID` to
- * be set.
- */
-export declare class GoogleCustomSearch extends Tool {
-    static lc_name(): string;
-    get lc_secrets(): {
-        [key: string]: string;
-    } | undefined;
-    name: string;
-    protected apiKey: string;
-    protected googleCSEId: string;
-    description: string;
-    constructor(fields?: GoogleCustomSearchParams);
-    _call(input: string): Promise<string>;
-}
+export * from "@langchain/community/tools/google_custom_search";

package/dist/tools/google_custom_search.js

@@ -1,68 +1 @@
-import { getEnvironmentVariable } from "../util/env.js";
-import { Tool } from "./base.js";
-/**
- * Class that uses the Google Search API to perform custom searches.
- * Requires environment variables `GOOGLE_API_KEY` and `GOOGLE_CSE_ID` to
- * be set.
- */
-export class GoogleCustomSearch extends Tool {
-    static lc_name() {
-        return "GoogleCustomSearch";
-    }
-    get lc_secrets() {
-        return {
-            apiKey: "GOOGLE_API_KEY",
-        };
-    }
-    constructor(fields = {
-        apiKey: getEnvironmentVariable("GOOGLE_API_KEY"),
-        googleCSEId: getEnvironmentVariable("GOOGLE_CSE_ID"),
-    }) {
-        super(...arguments);
-        Object.defineProperty(this, "name", {
-            enumerable: true,
-            configurable: true,
-            writable: true,
-            value: "google-custom-search"
-        });
-        Object.defineProperty(this, "apiKey", {
-            enumerable: true,
-            configurable: true,
-            writable: true,
-            value: void 0
-        });
-        Object.defineProperty(this, "googleCSEId", {
-            enumerable: true,
-            configurable: true,
-            writable: true,
-            value: void 0
-        });
-        Object.defineProperty(this, "description", {
-            enumerable: true,
-            configurable: true,
-            writable: true,
-            value: "a custom search engine. useful for when you need to answer questions about current events. input should be a search query. outputs a JSON array of results."
-        });
-        if (!fields.apiKey) {
-            throw new Error(`Google API key not set. You can set it as "GOOGLE_API_KEY" in your environment variables.`);
-        }
-        if (!fields.googleCSEId) {
-            throw new Error(`Google custom search engine id not set. You can set it as "GOOGLE_CSE_ID" in your environment variables.`);
-        }
-        this.apiKey = fields.apiKey;
-        this.googleCSEId = fields.googleCSEId;
-    }
-    async _call(input) {
-        const res = await fetch(`https://www.googleapis.com/customsearch/v1?key=${this.apiKey}&cx=${this.googleCSEId}&q=${encodeURIComponent(input)}`);
-        if (!res.ok) {
-            throw new Error(`Got ${res.status} error from Google custom search: ${res.statusText}`);
-        }
-        const json = await res.json();
-        const results = json?.items?.map((item) => ({
-            title: item.title,
-            link: item.link,
-            snippet: item.snippet,
-        })) ?? [];
-        return JSON.stringify(results);
-    }
-}
+export * from "@langchain/community/tools/google_custom_search";

package/dist/tools/google_places.cjs

@@ -1,81 +1,17 @@
 "use strict";
-Object.defineProperty(exports, "__esModule", { value: true });
-exports.GooglePlacesAPI = void 0;
-const env_js_1 = require("../util/env.cjs");
-const base_js_1 = require("./base.cjs");
-/**
- * Tool that queries the Google Places API
- */
-class GooglePlacesAPI extends base_js_1.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 ?? (0, env_js_1.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;
+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(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);
-    }
-}
-exports.GooglePlacesAPI = GooglePlacesAPI;
+    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/google_places"), exports);

package/dist/tools/google_places.d.ts

@@ -1,21 +1 @@
-import { Tool } from "./base.js";
-/**
- * Interface for parameters required by GooglePlacesAPI class.
- */
-export interface GooglePlacesAPIParams {
-    apiKey?: string;
-}
-/**
- * Tool that queries the Google Places API
- */
-export declare class GooglePlacesAPI extends Tool {
-    static lc_name(): string;
-    get lc_secrets(): {
-        [key: string]: string;
-    } | undefined;
-    name: string;
-    protected apiKey: string;
-    description: string;
-    constructor(fields?: GooglePlacesAPIParams);
-    _call(input: string): Promise<string>;
-}
+export * from "@langchain/community/tools/google_places";