langchain 0.0.202 → 0.0.204-rc.0

package/dist/tools/IFTTTWebhook.js

@@ -1,85 +1 @@
-/** From https://github.com/SidU/teams-langchain-js/wiki/Connecting-IFTTT-Services.
-
-# Creating a webhook
-- Go to https://ifttt.com/create
-
-# Configuring the "If This"
-- Click on the "If This" button in the IFTTT interface.
-- Search for "Webhooks" in the search bar.
-- Choose the first option for "Receive a web request with a JSON payload."
-- Choose an Event Name that is specific to the service you plan to connect to.
-This will make it easier for you to manage the webhook URL.
-For example, if you're connecting to Spotify, you could use "Spotify" as your
-Event Name.
-- Click the "Create Trigger" button to save your settings and create your webhook.
-
-# Configuring the "Then That"
-- Tap on the "Then That" button in the IFTTT interface.
-- Search for the service you want to connect, such as Spotify.
-- Choose an action from the service, such as "Add track to a playlist".
-- Configure the action by specifying the necessary details, such as the playlist name,
-e.g., "Songs from AI".
-- Reference the JSON Payload received by the Webhook in your action. For the Spotify
-scenario, choose "{{JsonPayload}}" as your search query.
-- Tap the "Create Action" button to save your action settings.
-- Once you have finished configuring your action, click the "Finish" button to
-complete the setup.
-- Congratulations! You have successfully connected the Webhook to the desired
-service, and you're ready to start receiving data and triggering actions 🎉
-
-# Finishing up
-- To get your webhook URL go to https://ifttt.com/maker_webhooks/settings
-- Copy the IFTTT key value from there. The URL is of the form
-https://maker.ifttt.com/use/YOUR_IFTTT_KEY. Grab the YOUR_IFTTT_KEY value.
- */
-import { Tool } from "./base.js";
-/**
- * Represents a tool for creating and managing webhooks with the IFTTT (If
- * This Then That) service. The IFTTT service allows users to create
- * chains of simple conditional statements, called applets, which are
- * triggered based on changes to other web services.
- */
-export class IFTTTWebhook extends Tool {
-    static lc_name() {
-        return "IFTTTWebhook";
-    }
-    constructor(url, name, description) {
-        super(...arguments);
-        Object.defineProperty(this, "url", {
-            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.url = url;
-        this.name = name;
-        this.description = description;
-    }
-    /** @ignore */
-    async _call(input) {
-        const headers = { "Content-Type": "application/json" };
-        const body = JSON.stringify({ this: input });
-        const response = await fetch(this.url, {
-            method: "POST",
-            headers,
-            body,
-        });
-        if (!response.ok) {
-            throw new Error(`HTTP error ${response.status}`);
-        }
-        const result = await response.text();
-        return result;
-    }
-}
+export * from "@langchain/community/tools/ifttt";

package/dist/tools/aiplugin.cjs

@@ -1,75 +1,17 @@
 "use strict";
-Object.defineProperty(exports, "__esModule", { value: true });
-exports.AIPluginTool = void 0;
-const base_js_1 = require("./base.cjs");
-/**
- * Class for creating instances of AI tools from plugins. It extends the
- * Tool class and implements the AIPluginToolParams interface.
- */
-class AIPluginTool extends base_js_1.Tool {
-    static lc_name() {
-        return "AIPluginTool";
-    }
-    get name() {
-        return this._name;
-    }
-    get description() {
-        return this._description;
-    }
-    constructor(params) {
-        super(params);
-        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
-        });
-        Object.defineProperty(this, "apiSpec", {
-            enumerable: true,
-            configurable: true,
-            writable: true,
-            value: void 0
-        });
-        this._name = params.name;
-        this._description = params.description;
-        this.apiSpec = params.apiSpec;
+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) {
-        return this.apiSpec;
-    }
-    /**
-     * Static method that creates an instance of AIPluginTool from a given
-     * plugin URL. It fetches the plugin and its API specification from the
-     * provided URL and returns a new instance of AIPluginTool with the
-     * fetched data.
-     * @param url The URL of the AI plugin.
-     * @returns A new instance of AIPluginTool.
-     */
-    static async fromPluginUrl(url) {
-        const aiPluginRes = await fetch(url);
-        if (!aiPluginRes.ok) {
-            throw new Error(`Failed to fetch plugin from ${url} with status ${aiPluginRes.status}`);
-        }
-        const aiPluginJson = await aiPluginRes.json();
-        const apiUrlRes = await fetch(aiPluginJson.api.url);
-        if (!apiUrlRes.ok) {
-            throw new Error(`Failed to fetch API spec from ${aiPluginJson.api.url} with status ${apiUrlRes.status}`);
-        }
-        const apiUrlJson = await apiUrlRes.text();
-        return new AIPluginTool({
-            name: aiPluginJson.name_for_model,
-            description: `Call this tool to get the OpenAPI spec (and usage guide) for interacting with the ${aiPluginJson.name_for_human} API. You should only call this ONCE! What is the ${aiPluginJson.name_for_human} API useful for? ${aiPluginJson.description_for_human}`,
-            apiSpec: `Usage Guide: ${aiPluginJson.description_for_model}
-
-OpenAPI Spec in JSON or YAML format:\n${apiUrlJson}`,
-        });
-    }
-}
-exports.AIPluginTool = AIPluginTool;
+    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/aiplugin"), exports);

package/dist/tools/aiplugin.d.ts

@@ -1,34 +1 @@
-import { Tool, ToolParams } from "./base.js";
-/**
- * Interface for parameters required to create an instance of
- * AIPluginTool.
- */
-export interface AIPluginToolParams extends ToolParams {
-    name: string;
-    description: string;
-    apiSpec: string;
-}
-/**
- * Class for creating instances of AI tools from plugins. It extends the
- * Tool class and implements the AIPluginToolParams interface.
- */
-export declare class AIPluginTool extends Tool implements AIPluginToolParams {
-    static lc_name(): string;
-    private _name;
-    private _description;
-    apiSpec: string;
-    get name(): string;
-    get description(): string;
-    constructor(params: AIPluginToolParams);
-    /** @ignore */
-    _call(_input: string): Promise<string>;
-    /**
-     * Static method that creates an instance of AIPluginTool from a given
-     * plugin URL. It fetches the plugin and its API specification from the
-     * provided URL and returns a new instance of AIPluginTool with the
-     * fetched data.
-     * @param url The URL of the AI plugin.
-     * @returns A new instance of AIPluginTool.
-     */
-    static fromPluginUrl(url: string): Promise<AIPluginTool>;
-}
+export * from "@langchain/community/tools/aiplugin";

package/dist/tools/aiplugin.js

@@ -1,71 +1 @@
-import { Tool } from "./base.js";
-/**
- * Class for creating instances of AI tools from plugins. It extends the
- * Tool class and implements the AIPluginToolParams interface.
- */
-export class AIPluginTool extends Tool {
-    static lc_name() {
-        return "AIPluginTool";
-    }
-    get name() {
-        return this._name;
-    }
-    get description() {
-        return this._description;
-    }
-    constructor(params) {
-        super(params);
-        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
-        });
-        Object.defineProperty(this, "apiSpec", {
-            enumerable: true,
-            configurable: true,
-            writable: true,
-            value: void 0
-        });
-        this._name = params.name;
-        this._description = params.description;
-        this.apiSpec = params.apiSpec;
-    }
-    /** @ignore */
-    async _call(_input) {
-        return this.apiSpec;
-    }
-    /**
-     * Static method that creates an instance of AIPluginTool from a given
-     * plugin URL. It fetches the plugin and its API specification from the
-     * provided URL and returns a new instance of AIPluginTool with the
-     * fetched data.
-     * @param url The URL of the AI plugin.
-     * @returns A new instance of AIPluginTool.
-     */
-    static async fromPluginUrl(url) {
-        const aiPluginRes = await fetch(url);
-        if (!aiPluginRes.ok) {
-            throw new Error(`Failed to fetch plugin from ${url} with status ${aiPluginRes.status}`);
-        }
-        const aiPluginJson = await aiPluginRes.json();
-        const apiUrlRes = await fetch(aiPluginJson.api.url);
-        if (!apiUrlRes.ok) {
-            throw new Error(`Failed to fetch API spec from ${aiPluginJson.api.url} with status ${apiUrlRes.status}`);
-        }
-        const apiUrlJson = await apiUrlRes.text();
-        return new AIPluginTool({
-            name: aiPluginJson.name_for_model,
-            description: `Call this tool to get the OpenAPI spec (and usage guide) for interacting with the ${aiPluginJson.name_for_human} API. You should only call this ONCE! What is the ${aiPluginJson.name_for_human} API useful for? ${aiPluginJson.description_for_human}`,
-            apiSpec: `Usage Guide: ${aiPluginJson.description_for_model}
-
-OpenAPI Spec in JSON or YAML format:\n${apiUrlJson}`,
-        });
-    }
-}
+export * from "@langchain/community/tools/aiplugin";

package/dist/tools/aws_sfn.cjs

@@ -1,203 +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.SendTaskSuccessAWSSfnTool = exports.DescribeExecutionAWSSfnTool = exports.StartExecutionAWSSfnTool = void 0;
-const client_sfn_1 = require("@aws-sdk/client-sfn");
-const base_js_1 = require("./base.cjs");
-/**
- * Class for starting the execution of an AWS Step Function.
- */
-class StartExecutionAWSSfnTool extends base_js_1.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_sfn_1.SFNClient(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 client_sfn_1.StartExecutionCommand({
-                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");
-            });
-        });
-    }
-}
-exports.StartExecutionAWSSfnTool = StartExecutionAWSSfnTool;
-/**
- * Class for checking the status of an AWS Step Function execution.
- */
-class DescribeExecutionAWSSfnTool extends base_js_1.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_sfn_1.SFNClient(clientConstructorArgs);
-        const command = new client_sfn_1.DescribeExecutionCommand({
-            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";
-        });
-    }
-}
-exports.DescribeExecutionAWSSfnTool = DescribeExecutionAWSSfnTool;
-/**
- * Class for sending a task success signal to an AWS Step Function
- * execution.
- */
-class SendTaskSuccessAWSSfnTool extends base_js_1.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_sfn_1.SFNClient(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 client_sfn_1.SendTaskSuccessCommand({
-            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";
-        });
-    }
-}
-exports.SendTaskSuccessAWSSfnTool = SendTaskSuccessAWSSfnTool;
-/**
- * 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;
-}
+__exportStar(require("@langchain/community/tools/aws_sfn"), exports);

package/dist/tools/aws_sfn.d.ts

@@ -1,57 +1 @@
-import { Tool, ToolParams } from "./base.js";
-/**
- * Interface for AWS Step Functions configuration.
- */
-export interface SfnConfig {
-    stateMachineArn: string;
-    region?: string;
-    accessKeyId?: string;
-    secretAccessKey?: string;
-}
-/**
- * Class for starting the execution of an AWS Step Function.
- */
-export declare class StartExecutionAWSSfnTool extends Tool {
-    static lc_name(): string;
-    private sfnConfig;
-    name: string;
-    description: string;
-    constructor({ name, description, ...rest }: SfnConfig & {
-        name: string;
-        description: string;
-    });
-    /**
-     * 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: string, description: string): string;
-    /** @ignore */
-    _call(input: string): Promise<string>;
-}
-/**
- * Class for checking the status of an AWS Step Function execution.
- */
-export declare class DescribeExecutionAWSSfnTool extends Tool {
-    static lc_name(): string;
-    name: string;
-    description: string;
-    sfnConfig: Omit<SfnConfig, "stateMachineArn">;
-    constructor(config: Omit<SfnConfig, "stateMachineArn"> & ToolParams);
-    /** @ignore */
-    _call(input: string): Promise<string>;
-}
-/**
- * Class for sending a task success signal to an AWS Step Function
- * execution.
- */
-export declare class SendTaskSuccessAWSSfnTool extends Tool {
-    static lc_name(): string;
-    name: string;
-    description: string;
-    sfnConfig: Omit<SfnConfig, "stateMachineArn">;
-    constructor(config: Omit<SfnConfig, "stateMachineArn"> & ToolParams);
-    /** @ignore */
-    _call(input: string): Promise<string>;
-}
+export * from "@langchain/community/tools/aws_sfn";