langchain 0.0.203 → 0.0.204-rc.0

package/dist/tools/aws_sfn.js

@@ -1,197 +1 @@
-import { SFNClient as Client, StartExecutionCommand as Invoker, DescribeExecutionCommand as Describer, SendTaskSuccessCommand as TaskSuccessSender, } from "@aws-sdk/client-sfn";
-import { Tool } from "./base.js";
-/**
- * Class for starting the execution of an AWS Step Function.
- */
-export class StartExecutionAWSSfnTool extends Tool {
-    static lc_name() {
-        return "StartExecutionAWSSfnTool";
-    }
-    constructor({ name, description, ...rest }) {
-        super();
-        Object.defineProperty(this, "sfnConfig", {
-            enumerable: true,
-            configurable: true,
-            writable: true,
-            value: void 0
-        });
-        Object.defineProperty(this, "name", {
-            enumerable: true,
-            configurable: true,
-            writable: true,
-            value: void 0
-        });
-        Object.defineProperty(this, "description", {
-            enumerable: true,
-            configurable: true,
-            writable: true,
-            value: void 0
-        });
-        this.name = name;
-        this.description = description;
-        this.sfnConfig = rest;
-    }
-    /**
-     * Generates a formatted description for the StartExecutionAWSSfnTool.
-     * @param name Name of the state machine.
-     * @param description Description of the state machine.
-     * @returns A formatted description string.
-     */
-    static formatDescription(name, description) {
-        return `Use to start executing the ${name} state machine. Use to run ${name} workflows. Whenever you need to start (or execute) an asynchronous workflow (or state machine) about ${description} you should ALWAYS use this. Input should be a valid JSON string.`;
-    }
-    /** @ignore */
-    async _call(input) {
-        const clientConstructorArgs = getClientConstructorArgs(this.sfnConfig);
-        const sfnClient = new Client(clientConstructorArgs);
-        return new Promise((resolve) => {
-            let payload;
-            try {
-                payload = JSON.parse(input);
-            }
-            catch (e) {
-                console.error("Error starting state machine execution:", e);
-                resolve("failed to complete request");
-            }
-            const command = new Invoker({
-                stateMachineArn: this.sfnConfig.stateMachineArn,
-                input: JSON.stringify(payload),
-            });
-            sfnClient
-                .send(command)
-                .then((response) => resolve(response.executionArn ? response.executionArn : "request completed."))
-                .catch((error) => {
-                console.error("Error starting state machine execution:", error);
-                resolve("failed to complete request");
-            });
-        });
-    }
-}
-/**
- * Class for checking the status of an AWS Step Function execution.
- */
-export class DescribeExecutionAWSSfnTool extends Tool {
-    static lc_name() {
-        return "DescribeExecutionAWSSfnTool";
-    }
-    constructor(config) {
-        super(config);
-        Object.defineProperty(this, "name", {
-            enumerable: true,
-            configurable: true,
-            writable: true,
-            value: "describe-execution-aws-sfn"
-        });
-        Object.defineProperty(this, "description", {
-            enumerable: true,
-            configurable: true,
-            writable: true,
-            value: "This tool should ALWAYS be used for checking the status of any AWS Step Function execution (aka. state machine execution). Input to this tool is a properly formatted AWS Step Function Execution ARN (executionArn). The output is a stringified JSON object containing the executionArn, name, status, startDate, stopDate, input, output, error, and cause of the execution."
-        });
-        Object.defineProperty(this, "sfnConfig", {
-            enumerable: true,
-            configurable: true,
-            writable: true,
-            value: void 0
-        });
-        this.sfnConfig = config;
-    }
-    /** @ignore */
-    async _call(input) {
-        const clientConstructorArgs = getClientConstructorArgs(this.sfnConfig);
-        const sfnClient = new Client(clientConstructorArgs);
-        const command = new Describer({
-            executionArn: input,
-        });
-        return await sfnClient
-            .send(command)
-            .then((response) => response.executionArn
-            ? JSON.stringify({
-                executionArn: response.executionArn,
-                name: response.name,
-                status: response.status,
-                startDate: response.startDate,
-                stopDate: response.stopDate,
-                input: response.input,
-                output: response.output,
-                error: response.error,
-                cause: response.cause,
-            })
-            : "{}")
-            .catch((error) => {
-            console.error("Error describing state machine execution:", error);
-            return "failed to complete request";
-        });
-    }
-}
-/**
- * Class for sending a task success signal to an AWS Step Function
- * execution.
- */
-export class SendTaskSuccessAWSSfnTool extends Tool {
-    static lc_name() {
-        return "SendTaskSuccessAWSSfnTool";
-    }
-    constructor(config) {
-        super(config);
-        Object.defineProperty(this, "name", {
-            enumerable: true,
-            configurable: true,
-            writable: true,
-            value: "send-task-success-aws-sfn"
-        });
-        Object.defineProperty(this, "description", {
-            enumerable: true,
-            configurable: true,
-            writable: true,
-            value: "This tool should ALWAYS be used for sending task success to an AWS Step Function execution (aka. statemachine exeuction). Input to this tool is a stringify JSON object containing the taskToken and output."
-        });
-        Object.defineProperty(this, "sfnConfig", {
-            enumerable: true,
-            configurable: true,
-            writable: true,
-            value: void 0
-        });
-        this.sfnConfig = config;
-    }
-    /** @ignore */
-    async _call(input) {
-        const clientConstructorArgs = getClientConstructorArgs(this.sfnConfig);
-        const sfnClient = new Client(clientConstructorArgs);
-        let payload;
-        try {
-            payload = JSON.parse(input);
-        }
-        catch (e) {
-            console.error("Error starting state machine execution:", e);
-            return "failed to complete request";
-        }
-        const command = new TaskSuccessSender({
-            taskToken: payload.taskToken,
-            output: JSON.stringify(payload.output),
-        });
-        return await sfnClient
-            .send(command)
-            .then(() => "request completed.")
-            .catch((error) => {
-            console.error("Error sending task success to state machine execution:", error);
-            return "failed to complete request";
-        });
-    }
-}
-/**
- * Helper function to construct the AWS SFN client.
- */
-function getClientConstructorArgs(config) {
-    const clientConstructorArgs = {};
-    if (config.region) {
-        clientConstructorArgs.region = config.region;
-    }
-    if (config.accessKeyId && config.secretAccessKey) {
-        clientConstructorArgs.credentials = {
-            accessKeyId: config.accessKeyId,
-            secretAccessKey: config.secretAccessKey,
-        };
-    }
-    return clientConstructorArgs;
-}
+export * from "@langchain/community/tools/aws_sfn";

package/dist/tools/bingserpapi.cjs

@@ -1,78 +1,17 @@
 "use strict";
-Object.defineProperty(exports, "__esModule", { value: true });
-exports.BingSerpAPI = void 0;
-const env_js_1 = require("../util/env.cjs");
-const base_js_1 = require("./base.cjs");
-/**
- * A tool for web search functionality using Bing's search engine. It
- * extends the base `Tool` class and implements the `_call` method to
- * perform the search operation. Requires an API key for Bing's search
- * engine, which can be set in the environment variables. Also accepts
- * additional parameters for the search query.
- */
-class BingSerpAPI extends base_js_1.Tool {
-    static lc_name() {
-        return "BingSerpAPI";
-    }
-    /**
-     * Not implemented. Will throw an error if called.
-     */
-    toJSON() {
-        return this.toJSONNotImplemented();
-    }
-    constructor(apiKey = (0, env_js_1.getEnvironmentVariable)("BingApiKey"), params = {}) {
-        super(...arguments);
-        Object.defineProperty(this, "name", {
-            enumerable: true,
-            configurable: true,
-            writable: true,
-            value: "bing-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."
-        });
-        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
-        });
-        if (!apiKey) {
-            throw new Error("BingSerpAPI API key not set. You can set it as BingApiKey in your .env file.");
-        }
-        this.key = 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]; } };
     }
-    /** @ignore */
-    async _call(input) {
-        const headers = { "Ocp-Apim-Subscription-Key": this.key };
-        const params = { q: input, textDecorations: "true", textFormat: "HTML" };
-        const searchUrl = new URL("https://api.bing.microsoft.com/v7.0/search");
-        Object.entries(params).forEach(([key, value]) => {
-            searchUrl.searchParams.append(key, value);
-        });
-        const response = await fetch(searchUrl, { headers });
-        if (!response.ok) {
-            throw new Error(`HTTP error ${response.status}`);
-        }
-        const res = await response.json();
-        const results = res.webPages.value;
-        if (results.length === 0) {
-            return "No good results found.";
-        }
-        const snippets = results
-            .map((result) => result.snippet)
-            .join(" ");
-        return snippets;
-    }
-}
-exports.BingSerpAPI = BingSerpAPI;
+    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/bingserpapi"), exports);

package/dist/tools/bingserpapi.d.ts

@@ -1,23 +1 @@
-import { Tool } from "./base.js";
-/**
- * A tool for web search functionality using Bing's search engine. It
- * extends the base `Tool` class and implements the `_call` method to
- * perform the search operation. Requires an API key for Bing's search
- * engine, which can be set in the environment variables. Also accepts
- * additional parameters for the search query.
- */
-declare class BingSerpAPI extends Tool {
-    static lc_name(): string;
-    /**
-     * Not implemented. Will throw an error if called.
-     */
-    toJSON(): import("@langchain/core/load/serializable").SerializedNotImplemented;
-    name: string;
-    description: string;
-    key: string;
-    params: Record<string, string>;
-    constructor(apiKey?: string | undefined, params?: Record<string, string>);
-    /** @ignore */
-    _call(input: string): Promise<string>;
-}
-export { BingSerpAPI };
+export * from "@langchain/community/tools/bingserpapi";

package/dist/tools/bingserpapi.js

@@ -1,75 +1 @@
-import { getEnvironmentVariable } from "../util/env.js";
-import { Tool } from "./base.js";
-/**
- * A tool for web search functionality using Bing's search engine. It
- * extends the base `Tool` class and implements the `_call` method to
- * perform the search operation. Requires an API key for Bing's search
- * engine, which can be set in the environment variables. Also accepts
- * additional parameters for the search query.
- */
-class BingSerpAPI extends Tool {
-    static lc_name() {
-        return "BingSerpAPI";
-    }
-    /**
-     * Not implemented. Will throw an error if called.
-     */
-    toJSON() {
-        return this.toJSONNotImplemented();
-    }
-    constructor(apiKey = getEnvironmentVariable("BingApiKey"), params = {}) {
-        super(...arguments);
-        Object.defineProperty(this, "name", {
-            enumerable: true,
-            configurable: true,
-            writable: true,
-            value: "bing-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."
-        });
-        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
-        });
-        if (!apiKey) {
-            throw new Error("BingSerpAPI API key not set. You can set it as BingApiKey in your .env file.");
-        }
-        this.key = apiKey;
-        this.params = params;
-    }
-    /** @ignore */
-    async _call(input) {
-        const headers = { "Ocp-Apim-Subscription-Key": this.key };
-        const params = { q: input, textDecorations: "true", textFormat: "HTML" };
-        const searchUrl = new URL("https://api.bing.microsoft.com/v7.0/search");
-        Object.entries(params).forEach(([key, value]) => {
-            searchUrl.searchParams.append(key, value);
-        });
-        const response = await fetch(searchUrl, { headers });
-        if (!response.ok) {
-            throw new Error(`HTTP error ${response.status}`);
-        }
-        const res = await response.json();
-        const results = res.webPages.value;
-        if (results.length === 0) {
-            return "No good results found.";
-        }
-        const snippets = results
-            .map((result) => result.snippet)
-            .join(" ");
-        return snippets;
-    }
-}
-export { BingSerpAPI };
+export * from "@langchain/community/tools/bingserpapi";

package/dist/tools/brave_search.cjs

@@ -1,66 +1,17 @@
 "use strict";
-Object.defineProperty(exports, "__esModule", { value: true });
-exports.BraveSearch = void 0;
-const env_js_1 = require("../util/env.cjs");
-const base_js_1 = require("./base.cjs");
-/**
- * Class for interacting with the Brave Search engine. It extends the Tool
- * class and requires an API key to function. The API key can be passed in
- * during instantiation or set as an environment variable named
- * 'BRAVE_SEARCH_API_KEY'.
- */
-class BraveSearch extends base_js_1.Tool {
-    static lc_name() {
-        return "BraveSearch";
-    }
-    constructor(fields = {
-        apiKey: (0, env_js_1.getEnvironmentVariable)("BRAVE_SEARCH_API_KEY"),
-    }) {
-        super();
-        Object.defineProperty(this, "name", {
-            enumerable: true,
-            configurable: true,
-            writable: true,
-            value: "brave-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."
-        });
-        Object.defineProperty(this, "apiKey", {
-            enumerable: true,
-            configurable: true,
-            writable: true,
-            value: void 0
-        });
-        if (!fields.apiKey) {
-            throw new Error(`Brave API key not set. Please pass it in or set it as an environment variable named "BRAVE_SEARCH_API_KEY".`);
-        }
-        this.apiKey = fields.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]; } };
     }
-    /** @ignore */
-    async _call(input) {
-        const headers = {
-            "X-Subscription-Token": this.apiKey,
-            Accept: "application/json",
-        };
-        const searchUrl = new URL(`https://api.search.brave.com/res/v1/web/search?q=${encodeURIComponent(input)}`);
-        const response = await fetch(searchUrl, { headers });
-        if (!response.ok) {
-            throw new Error(`HTTP error ${response.status}`);
-        }
-        const parsedResponse = await response.json();
-        const webSearchResults = parsedResponse.web?.results;
-        const finalResults = Array.isArray(webSearchResults)
-            ? webSearchResults.map((item) => ({
-                title: item.title,
-                link: item.url,
-                snippet: item.description,
-            }))
-            : [];
-        return JSON.stringify(finalResults);
-    }
-}
-exports.BraveSearch = BraveSearch;
+    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/brave_search"), exports);

package/dist/tools/brave_search.d.ts

@@ -1,23 +1 @@
-import { Tool } from "./base.js";
-/**
- * Interface for the parameters required to instantiate a BraveSearch
- * instance.
- */
-export interface BraveSearchParams {
-    apiKey?: string;
-}
-/**
- * Class for interacting with the Brave Search engine. It extends the Tool
- * class and requires an API key to function. The API key can be passed in
- * during instantiation or set as an environment variable named
- * 'BRAVE_SEARCH_API_KEY'.
- */
-export declare class BraveSearch extends Tool {
-    static lc_name(): string;
-    name: string;
-    description: string;
-    apiKey: string;
-    constructor(fields?: BraveSearchParams);
-    /** @ignore */
-    _call(input: string): Promise<string>;
-}
+export * from "@langchain/community/tools/brave_search";

package/dist/tools/brave_search.js

@@ -1,62 +1 @@
-import { getEnvironmentVariable } from "../util/env.js";
-import { Tool } from "./base.js";
-/**
- * Class for interacting with the Brave Search engine. It extends the Tool
- * class and requires an API key to function. The API key can be passed in
- * during instantiation or set as an environment variable named
- * 'BRAVE_SEARCH_API_KEY'.
- */
-export class BraveSearch extends Tool {
-    static lc_name() {
-        return "BraveSearch";
-    }
-    constructor(fields = {
-        apiKey: getEnvironmentVariable("BRAVE_SEARCH_API_KEY"),
-    }) {
-        super();
-        Object.defineProperty(this, "name", {
-            enumerable: true,
-            configurable: true,
-            writable: true,
-            value: "brave-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."
-        });
-        Object.defineProperty(this, "apiKey", {
-            enumerable: true,
-            configurable: true,
-            writable: true,
-            value: void 0
-        });
-        if (!fields.apiKey) {
-            throw new Error(`Brave API key not set. Please pass it in or set it as an environment variable named "BRAVE_SEARCH_API_KEY".`);
-        }
-        this.apiKey = fields.apiKey;
-    }
-    /** @ignore */
-    async _call(input) {
-        const headers = {
-            "X-Subscription-Token": this.apiKey,
-            Accept: "application/json",
-        };
-        const searchUrl = new URL(`https://api.search.brave.com/res/v1/web/search?q=${encodeURIComponent(input)}`);
-        const response = await fetch(searchUrl, { headers });
-        if (!response.ok) {
-            throw new Error(`HTTP error ${response.status}`);
-        }
-        const parsedResponse = await response.json();
-        const webSearchResults = parsedResponse.web?.results;
-        const finalResults = Array.isArray(webSearchResults)
-            ? webSearchResults.map((item) => ({
-                title: item.title,
-                link: item.url,
-                snippet: item.description,
-            }))
-            : [];
-        return JSON.stringify(finalResults);
-    }
-}
+export * from "@langchain/community/tools/brave_search";