langchain 0.0.183 → 0.0.184

package/dist/agents/agent.cjs

@@ -1,6 +1,6 @@
 "use strict";
 Object.defineProperty(exports, "__esModule", { value: true });
-exports.Agent = exports.LLMSingleActionAgent = exports.BaseMultiActionAgent = exports.RunnableAgent = exports.BaseSingleActionAgent = exports.BaseAgent = void 0;
+exports.Agent = exports.LLMSingleActionAgent = exports.RunnableAgent = exports.BaseMultiActionAgent = exports.BaseSingleActionAgent = exports.BaseAgent = void 0;
 const serializable_js_1 = require("../load/serializable.cjs");
 /**
  * Error class for parse errors in LangChain. Contains information about
@@ -66,12 +66,26 @@ class BaseSingleActionAgent extends BaseAgent {
     }
 }
 exports.BaseSingleActionAgent = BaseSingleActionAgent;
+/**
+ * Abstract base class for multi-action agents in LangChain. Extends the
+ * BaseAgent class and provides additional functionality specific to
+ * multi-action agents.
+ */
+class BaseMultiActionAgent extends BaseAgent {
+    _agentActionType() {
+        return "multi";
+    }
+}
+exports.BaseMultiActionAgent = BaseMultiActionAgent;
+function isAgentAction(input) {
+    return !Array.isArray(input) && input?.tool !== undefined;
+}
 /**
  * Class representing a single action agent which accepts runnables.
  * Extends the BaseSingleActionAgent class and provides methods for
  * planning agent actions with runnables.
  */
-class RunnableAgent extends BaseSingleActionAgent {
+class RunnableAgent extends BaseMultiActionAgent {
     get inputKeys() {
         return [];
     }
@@ -110,21 +124,13 @@ class RunnableAgent extends BaseSingleActionAgent {
             callbacks: callbackManager,
             runName: "RunnableAgent",
         });
+        if (isAgentAction(output)) {
+            return [output];
+        }
         return output;
     }
 }
 exports.RunnableAgent = RunnableAgent;
-/**
- * Abstract base class for multi-action agents in LangChain. Extends the
- * BaseAgent class and provides additional functionality specific to
- * multi-action agents.
- */
-class BaseMultiActionAgent extends BaseAgent {
-    _agentActionType() {
-        return "multi";
-    }
-}
-exports.BaseMultiActionAgent = BaseMultiActionAgent;
 /**
  * Class representing a single action agent using a LLMChain in LangChain.
  * Extends the BaseSingleActionAgent class and provides methods for

package/dist/agents/agent.d.ts

@@ -55,23 +55,6 @@ export declare abstract class BaseSingleActionAgent extends BaseAgent {
      */
     abstract plan(steps: AgentStep[], inputs: ChainValues, callbackManager?: CallbackManager): Promise<AgentAction | AgentFinish>;
 }
-/**
- * Class representing a single action agent which accepts runnables.
- * Extends the BaseSingleActionAgent class and provides methods for
- * planning agent actions with runnables.
- */
-export declare class RunnableAgent<RunInput extends ChainValues & {
-    agent_scratchpad?: string | BaseMessage[];
-    stop?: string[];
-}, RunOutput extends AgentAction | AgentFinish> extends BaseSingleActionAgent {
-    protected lc_runnable: boolean;
-    lc_namespace: string[];
-    runnable: Runnable<RunInput, RunOutput>;
-    stop?: string[];
-    get inputKeys(): string[];
-    constructor(fields: RunnableAgentInput<RunInput, RunOutput>);
-    plan(steps: AgentStep[], inputs: RunInput, callbackManager?: CallbackManager): Promise<AgentAction | AgentFinish>;
-}
 /**
  * Abstract base class for multi-action agents in LangChain. Extends the
  * BaseAgent class and provides additional functionality specific to
@@ -90,6 +73,22 @@ export declare abstract class BaseMultiActionAgent extends BaseAgent {
      */
     abstract plan(steps: AgentStep[], inputs: ChainValues, callbackManager?: CallbackManager): Promise<AgentAction[] | AgentFinish>;
 }
+/**
+ * Class representing a single action agent which accepts runnables.
+ * Extends the BaseSingleActionAgent class and provides methods for
+ * planning agent actions with runnables.
+ */
+export declare class RunnableAgent extends BaseMultiActionAgent {
+    protected lc_runnable: boolean;
+    lc_namespace: string[];
+    runnable: Runnable<ChainValues & {
+        steps: AgentStep[];
+    }, AgentAction[] | AgentAction | AgentFinish>;
+    stop?: string[];
+    get inputKeys(): string[];
+    constructor(fields: RunnableAgentInput);
+    plan(steps: AgentStep[], inputs: ChainValues, callbackManager?: CallbackManager): Promise<AgentAction[] | AgentFinish>;
+}
 /**
  * Interface for input data for creating a LLMSingleActionAgent.
  */

package/dist/agents/agent.js

@@ -61,12 +61,25 @@ export class BaseSingleActionAgent extends BaseAgent {
         return "single";
     }
 }
+/**
+ * Abstract base class for multi-action agents in LangChain. Extends the
+ * BaseAgent class and provides additional functionality specific to
+ * multi-action agents.
+ */
+export class BaseMultiActionAgent extends BaseAgent {
+    _agentActionType() {
+        return "multi";
+    }
+}
+function isAgentAction(input) {
+    return !Array.isArray(input) && input?.tool !== undefined;
+}
 /**
  * Class representing a single action agent which accepts runnables.
  * Extends the BaseSingleActionAgent class and provides methods for
  * planning agent actions with runnables.
  */
-export class RunnableAgent extends BaseSingleActionAgent {
+export class RunnableAgent extends BaseMultiActionAgent {
     get inputKeys() {
         return [];
     }
@@ -105,19 +118,12 @@ export class RunnableAgent extends BaseSingleActionAgent {
             callbacks: callbackManager,
             runName: "RunnableAgent",
         });
+        if (isAgentAction(output)) {
+            return [output];
+        }
         return output;
     }
 }
-/**
- * Abstract base class for multi-action agents in LangChain. Extends the
- * BaseAgent class and provides additional functionality specific to
- * multi-action agents.
- */
-export class BaseMultiActionAgent extends BaseAgent {
-    _agentActionType() {
-        return "multi";
-    }
-}
 /**
  * Class representing a single action agent using a LLMChain in LangChain.
  * Extends the BaseSingleActionAgent class and provides methods for

package/dist/agents/executor.d.ts

@@ -2,7 +2,7 @@ import { BaseChain, ChainInputs } from "../chains/base.js";
 import { BaseMultiActionAgent, BaseSingleActionAgent } from "./agent.js";
 import { StoppingMethod } from "./types.js";
 import { SerializedLLMChain } from "../chains/serde.js";
-import { AgentAction, AgentFinish, BaseMessage, ChainValues } from "../schema/index.js";
+import { AgentAction, AgentFinish, AgentStep, ChainValues } from "../schema/index.js";
 import { CallbackManagerForChainRun } from "../callbacks/manager.js";
 import { OutputParserException } from "../schema/output_parser.js";
 import { StructuredTool, Tool, ToolInputParsingException } from "../tools/base.js";
@@ -15,17 +15,17 @@ type ExtractToolType<T> = T extends {
  * AgentExecutor. It extends ChainInputs and includes additional
  * properties specific to agent execution.
  */
-export interface AgentExecutorInput<RunInput extends ChainValues & {
-    agent_scratchpad?: string | BaseMessage[];
-    stop?: string[];
-} = any, RunOutput extends AgentAction | AgentFinish = any> extends ChainInputs {
-    agent: BaseSingleActionAgent | BaseMultiActionAgent | Runnable<RunInput, RunOutput>;
+export interface AgentExecutorInput extends ChainInputs {
+    agent: BaseSingleActionAgent | BaseMultiActionAgent | Runnable<ChainValues & {
+        steps?: AgentStep[];
+    }, AgentAction[] | AgentAction | AgentFinish>;
     tools: ExtractToolType<this["agent"]>[];
     returnIntermediateSteps?: boolean;
     maxIterations?: number;
     earlyStoppingMethod?: StoppingMethod;
     handleParsingErrors?: boolean | string | ((e: OutputParserException | ToolInputParsingException) => string);
 }
+export type AgentExecutorOutput = ChainValues;
 /**
  * Tool that just returns the query.
  * Used for exception tracking.
@@ -39,10 +39,7 @@ export declare class ExceptionTool extends Tool {
  * A chain managing an agent using tools.
  * @augments BaseChain
  */
-export declare class AgentExecutor<RunInput extends ChainValues & {
-    agent_scratchpad?: string | BaseMessage[];
-    stop?: string[];
-} = any, RunOutput extends AgentAction | AgentFinish = any> extends BaseChain {
+export declare class AgentExecutor extends BaseChain<ChainValues, AgentExecutorOutput> {
     static lc_name(): string;
     get lc_namespace(): string[];
     agent: BaseSingleActionAgent | BaseMultiActionAgent;
@@ -63,12 +60,9 @@ export declare class AgentExecutor<RunInput extends ChainValues & {
     handleParsingErrors: boolean | string | ((e: OutputParserException | ToolInputParsingException) => string);
     get inputKeys(): string[];
     get outputKeys(): string[];
-    constructor(input: AgentExecutorInput<RunInput, RunOutput>);
+    constructor(input: AgentExecutorInput);
     /** Create from agent and a list of tools. */
-    static fromAgentAndTools<RunInput extends ChainValues & {
-        agent_scratchpad?: string | BaseMessage[];
-        stop?: string[];
-    }, RunOutput extends AgentAction | AgentFinish>(fields: AgentExecutorInput<RunInput, RunOutput>): AgentExecutor<RunInput, RunOutput>;
+    static fromAgentAndTools(fields: AgentExecutorInput): AgentExecutor;
     /**
      * Method that checks if the agent execution should continue based on the
      * number of iterations.
@@ -77,7 +71,7 @@ export declare class AgentExecutor<RunInput extends ChainValues & {
      */
     private shouldContinue;
     /** @ignore */
-    _call(inputs: ChainValues, runManager?: CallbackManagerForChainRun): Promise<ChainValues>;
+    _call(inputs: ChainValues, runManager?: CallbackManagerForChainRun): Promise<AgentExecutorOutput>;
     _chainType(): "agent_executor";
     serialize(): SerializedLLMChain;
 }

package/dist/agents/toolkits/aws_sfn.d.ts

@@ -30,7 +30,4 @@ export declare class AWSSfnToolkit extends Toolkit {
     asl: string;
     constructor(args: AWSSfnToolkitArgs & SfnConfig);
 }
-export declare function createAWSSfnAgent(llm: BaseLanguageModel, toolkit: AWSSfnToolkit, args?: AWSSfnCreatePromptArgs): AgentExecutor<import("../../schema/index.js").ChainValues & {
-    agent_scratchpad?: string | import("../../schema/index.js").BaseMessage[] | undefined;
-    stop?: string[] | undefined;
-}, import("../../schema/index.js").AgentAction | import("../../schema/index.js").AgentFinish>;
+export declare function createAWSSfnAgent(llm: BaseLanguageModel, toolkit: AWSSfnToolkit, args?: AWSSfnCreatePromptArgs): AgentExecutor;

package/dist/agents/toolkits/conversational_retrieval/openai_functions.d.ts

@@ -17,4 +17,4 @@ export type ConversationalRetrievalAgentOptions = {
  * @param options Optional ConversationalRetrievalAgentOptions to customize the agent.
  * @returns A Promise that resolves to an initialized AgentExecutor.
  */
-export declare function createConversationalRetrievalAgent(llm: ChatOpenAI, tools: StructuredTool[], options?: ConversationalRetrievalAgentOptions): Promise<import("../../executor.js").AgentExecutor<any, any>>;
+export declare function createConversationalRetrievalAgent(llm: ChatOpenAI, tools: StructuredTool[], options?: ConversationalRetrievalAgentOptions): Promise<import("../../executor.js").AgentExecutor>;

package/dist/agents/toolkits/json/json.d.ts

@@ -24,7 +24,4 @@ export declare class JsonToolkit extends Toolkit {
  * @param args Optional prompt arguments used to create the JSON agent.
  * @returns An AgentExecutor for executing the created JSON agent with the tools.
  */
-export declare function createJsonAgent(llm: BaseLanguageModel, toolkit: JsonToolkit, args?: ZeroShotCreatePromptArgs): AgentExecutor<import("../../../schema/index.js").ChainValues & {
-    agent_scratchpad?: string | import("../../../schema/index.js").BaseMessage[] | undefined;
-    stop?: string[] | undefined;
-}, import("../../../schema/index.js").AgentAction | import("../../../schema/index.js").AgentFinish>;
+export declare function createJsonAgent(llm: BaseLanguageModel, toolkit: JsonToolkit, args?: ZeroShotCreatePromptArgs): AgentExecutor;

package/dist/agents/toolkits/openapi/openapi.d.ts

@@ -41,7 +41,4 @@ export declare class OpenApiToolkit extends RequestsToolkit {
  *
  * @link See https://js.langchain.com/docs/security for more information.
  */
-export declare function createOpenApiAgent(llm: BaseLanguageModel, openApiToolkit: OpenApiToolkit, args?: ZeroShotCreatePromptArgs): AgentExecutor<import("../../../schema/index.js").ChainValues & {
-    agent_scratchpad?: string | import("../../../schema/index.js").BaseMessage[] | undefined;
-    stop?: string[] | undefined;
-}, import("../../../schema/index.js").AgentAction | import("../../../schema/index.js").AgentFinish>;
+export declare function createOpenApiAgent(llm: BaseLanguageModel, openApiToolkit: OpenApiToolkit, args?: ZeroShotCreatePromptArgs): AgentExecutor;

package/dist/agents/toolkits/sql/sql.d.ts

@@ -22,7 +22,4 @@ export declare class SqlToolkit extends Toolkit {
     dialect: string;
     constructor(db: SqlDatabase, llm?: BaseLanguageModel);
 }
-export declare function createSqlAgent(llm: BaseLanguageModel, toolkit: SqlToolkit, args?: SqlCreatePromptArgs): AgentExecutor<import("../../../schema/index.js").ChainValues & {
-    agent_scratchpad?: string | import("../../../schema/index.js").BaseMessage[] | undefined;
-    stop?: string[] | undefined;
-}, import("../../../schema/index.js").AgentAction | import("../../../schema/index.js").AgentFinish>;
+export declare function createSqlAgent(llm: BaseLanguageModel, toolkit: SqlToolkit, args?: SqlCreatePromptArgs): AgentExecutor;

package/dist/agents/toolkits/vectorstore/vectorstore.d.ts

@@ -34,11 +34,5 @@ export declare class VectorStoreRouterToolkit extends Toolkit {
     llm: BaseLanguageModel;
     constructor(vectorStoreInfos: VectorStoreInfo[], llm: BaseLanguageModel);
 }
-export declare function createVectorStoreAgent(llm: BaseLanguageModel, toolkit: VectorStoreToolkit, args?: ZeroShotCreatePromptArgs): AgentExecutor<import("../../../schema/index.js").ChainValues & {
-    agent_scratchpad?: string | import("../../../schema/index.js").BaseMessage[] | undefined;
-    stop?: string[] | undefined;
-}, import("../../../schema/index.js").AgentAction | import("../../../schema/index.js").AgentFinish>;
-export declare function createVectorStoreRouterAgent(llm: BaseLanguageModel, toolkit: VectorStoreRouterToolkit, args?: ZeroShotCreatePromptArgs): AgentExecutor<import("../../../schema/index.js").ChainValues & {
-    agent_scratchpad?: string | import("../../../schema/index.js").BaseMessage[] | undefined;
-    stop?: string[] | undefined;
-}, import("../../../schema/index.js").AgentAction | import("../../../schema/index.js").AgentFinish>;
+export declare function createVectorStoreAgent(llm: BaseLanguageModel, toolkit: VectorStoreToolkit, args?: ZeroShotCreatePromptArgs): AgentExecutor;
+export declare function createVectorStoreRouterAgent(llm: BaseLanguageModel, toolkit: VectorStoreRouterToolkit, args?: ZeroShotCreatePromptArgs): AgentExecutor;

package/dist/agents/types.d.ts

@@ -17,11 +17,11 @@ export interface AgentInput {
  * Interface defining the input for creating an agent that uses runnables.
  * It includes the Runnable instance, and an optional list of stop strings.
  */
-export interface RunnableAgentInput<RunInput extends ChainValues & {
-    agent_scratchpad?: string | BaseMessage[];
-    stop?: string[];
-} = any, RunOutput extends AgentAction | AgentFinish = any> {
-    runnable: Runnable<RunInput, RunOutput>;
+export interface RunnableAgentInput {
+    runnable: Runnable<ChainValues & {
+        agent_scratchpad?: string | BaseMessage[];
+        stop?: string[];
+    }, AgentAction[] | AgentAction | AgentFinish>;
     stop?: string[];
 }
 /**

package/dist/experimental/openai_assistant/index.cjs

@@ -0,0 +1,221 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.OpenAIAssistantRunnable = void 0;
+const openai_1 = require("openai");
+const base_js_1 = require("../../schema/runnable/base.cjs");
+const time_js_1 = require("../../util/time.cjs");
+const base_js_2 = require("../../tools/base.cjs");
+const convert_to_openai_js_1 = require("../../tools/convert_to_openai.cjs");
+class OpenAIAssistantRunnable extends base_js_1.Runnable {
+    constructor(fields) {
+        super(fields);
+        Object.defineProperty(this, "lc_namespace", {
+            enumerable: true,
+            configurable: true,
+            writable: true,
+            value: ["langchain", "experimental", "openai_assistant"]
+        });
+        Object.defineProperty(this, "client", {
+            enumerable: true,
+            configurable: true,
+            writable: true,
+            value: void 0
+        });
+        Object.defineProperty(this, "assistantId", {
+            enumerable: true,
+            configurable: true,
+            writable: true,
+            value: void 0
+        });
+        Object.defineProperty(this, "pollIntervalMs", {
+            enumerable: true,
+            configurable: true,
+            writable: true,
+            value: 1000
+        });
+        Object.defineProperty(this, "asAgent", {
+            enumerable: true,
+            configurable: true,
+            writable: true,
+            value: void 0
+        });
+        this.client = fields.client ?? new openai_1.OpenAI(fields?.clientOptions);
+        this.assistantId = fields.assistantId;
+        this.asAgent = fields.asAgent ?? this.asAgent;
+    }
+    static async createAssistant({ model, name, instructions, tools, client, clientOptions, asAgent, pollIntervalMs, }) {
+        const formattedTools = tools?.map((tool) => {
+            // eslint-disable-next-line no-instanceof/no-instanceof
+            if (tool instanceof base_js_2.StructuredTool) {
+                return (0, convert_to_openai_js_1.formatToOpenAIAssistantTool)(tool);
+            }
+            return tool;
+        }) ?? [];
+        const oaiClient = client ?? new openai_1.OpenAI(clientOptions);
+        const assistant = await oaiClient.beta.assistants.create({
+            name,
+            instructions,
+            tools: formattedTools,
+            model,
+        });
+        return new this({
+            client: oaiClient,
+            assistantId: assistant.id,
+            asAgent,
+            pollIntervalMs,
+        });
+    }
+    async invoke(input, _options) {
+        let run;
+        if (this.asAgent && input.steps && input.steps.length > 0) {
+            const parsedStepsInput = await this._parseStepsInput(input);
+            run = await this.client.beta.threads.runs.submitToolOutputs(parsedStepsInput.threadId, parsedStepsInput.runId, {
+                tool_outputs: parsedStepsInput.toolOutputs,
+            });
+        }
+        else if (!("threadId" in input)) {
+            const thread = {
+                messages: [
+                    {
+                        role: "user",
+                        content: input.content,
+                        file_ids: input.fileIds,
+                        metadata: input.messagesMetadata,
+                    },
+                ],
+                metadata: input.threadMetadata,
+            };
+            run = await this._createThreadAndRun({
+                ...input,
+                thread,
+            });
+        }
+        else if (!("runId" in input)) {
+            await this.client.beta.threads.messages.create(input.threadId, {
+                content: input.content,
+                role: "user",
+                file_ids: input.file_ids,
+                metadata: input.messagesMetadata,
+            });
+            run = await this._createRun(input);
+        }
+        else {
+            // Submitting tool outputs to an existing run, outside the AgentExecutor
+            // framework.
+            run = await this.client.beta.threads.runs.submitToolOutputs(input.runId, input.threadId, {
+                tool_outputs: input.toolOutputs,
+            });
+        }
+        return this._getResponse(run.id, run.thread_id);
+    }
+    async _parseStepsInput(input) {
+        const { action: { runId, threadId }, } = input.steps[input.steps.length - 1];
+        const run = await this._waitForRun(runId, threadId);
+        const toolCalls = run.required_action?.submit_tool_outputs.tool_calls;
+        if (!toolCalls) {
+            return input;
+        }
+        const toolOutputs = toolCalls.flatMap((toolCall) => {
+            const matchedAction = input.steps.find((step) => step.action.toolCallId === toolCall.id);
+            return matchedAction
+                ? [
+                    {
+                        output: matchedAction.observation,
+                        tool_call_id: matchedAction.action.toolCallId,
+                    },
+                ]
+                : [];
+        });
+        return { toolOutputs, runId, threadId };
+    }
+    async _createRun({ instructions, model, tools, metadata, threadId, }) {
+        const run = this.client.beta.threads.runs.create(threadId, {
+            assistant_id: this.assistantId,
+            instructions,
+            model,
+            tools,
+            metadata,
+        });
+        return run;
+    }
+    async _createThreadAndRun(input) {
+        const params = [
+            "instructions",
+            "model",
+            "tools",
+            "run_metadata",
+        ]
+            .filter((key) => key in input)
+            .reduce((obj, key) => {
+            const newObj = obj;
+            newObj[key] = input[key];
+            return newObj;
+        }, {});
+        const run = this.client.beta.threads.createAndRun({
+            ...params,
+            thread: input.thread,
+            assistant_id: this.assistantId,
+        });
+        return run;
+    }
+    async _waitForRun(runId, threadId) {
+        let inProgress = true;
+        let run = {};
+        while (inProgress) {
+            run = await this.client.beta.threads.runs.retrieve(threadId, runId);
+            inProgress = ["in_progress", "queued"].includes(run.status);
+            if (inProgress) {
+                await (0, time_js_1.sleep)(this.pollIntervalMs);
+            }
+        }
+        return run;
+    }
+    async _getResponse(runId, threadId) {
+        const run = await this._waitForRun(runId, threadId);
+        if (run.status === "completed") {
+            const messages = await this.client.beta.threads.messages.list(threadId, {
+                order: "asc",
+            });
+            const newMessages = messages.data.filter((msg) => msg.run_id === runId);
+            if (!this.asAgent) {
+                return newMessages;
+            }
+            const answer = newMessages.flatMap((msg) => msg.content);
+            if (answer.every((item) => item.type === "text")) {
+                const answerString = answer
+                    .map((item) => item.type === "text" && item.text.value)
+                    .join("\n");
+                return {
+                    returnValues: {
+                        output: answerString,
+                    },
+                    log: "",
+                    runId,
+                    threadId,
+                };
+            }
+        }
+        else if (run.status === "requires_action") {
+            if (!this.asAgent) {
+                return run.required_action?.submit_tool_outputs.tool_calls ?? [];
+            }
+            const actions = [];
+            run.required_action?.submit_tool_outputs.tool_calls.forEach((item) => {
+                const functionCall = item.function;
+                const args = JSON.parse(functionCall.arguments);
+                actions.push({
+                    tool: functionCall.name,
+                    toolInput: args,
+                    toolCallId: item.id,
+                    log: "",
+                    runId,
+                    threadId,
+                });
+            });
+            return actions;
+        }
+        const runInfo = JSON.stringify(run, null, 2);
+        throw new Error(`Unexpected run status ${run.status}.\nFull run info:\n\n${runInfo}`);
+    }
+}
+exports.OpenAIAssistantRunnable = OpenAIAssistantRunnable;

package/dist/experimental/openai_assistant/index.d.ts

@@ -0,0 +1,36 @@
+import { type ClientOptions, OpenAI as OpenAIClient } from "openai";
+import { Runnable } from "../../schema/runnable/base.js";
+import type { RunnableConfig } from "../../schema/runnable/config.js";
+import type { OpenAIAssistantFinish, OpenAIAssistantAction, OpenAIToolType } from "./schema.js";
+import { StructuredTool } from "../../tools/base.js";
+type ThreadMessage = OpenAIClient.Beta.Threads.ThreadMessage;
+type RequiredActionFunctionToolCall = OpenAIClient.Beta.Threads.RequiredActionFunctionToolCall;
+type ExtractRunOutput<AsAgent extends boolean | undefined> = AsAgent extends true ? OpenAIAssistantFinish | OpenAIAssistantAction[] : ThreadMessage[] | RequiredActionFunctionToolCall[];
+export type OpenAIAssistantRunnableInput<AsAgent extends boolean | undefined = undefined> = {
+    client?: OpenAIClient;
+    clientOptions?: ClientOptions;
+    assistantId: string;
+    pollIntervalMs?: number;
+    asAgent?: AsAgent;
+};
+export declare class OpenAIAssistantRunnable<AsAgent extends boolean | undefined, RunInput extends Record<string, any> = Record<string, any>> extends Runnable<RunInput, ExtractRunOutput<AsAgent>> {
+    lc_namespace: string[];
+    private client;
+    assistantId: string;
+    pollIntervalMs: number;
+    asAgent?: AsAgent;
+    constructor(fields: OpenAIAssistantRunnableInput<AsAgent>);
+    static createAssistant<AsAgent extends boolean>({ model, name, instructions, tools, client, clientOptions, asAgent, pollIntervalMs, }: Omit<OpenAIAssistantRunnableInput<AsAgent>, "assistantId"> & {
+        model: string;
+        name?: string;
+        instructions?: string;
+        tools?: OpenAIToolType | Array<StructuredTool>;
+    }): Promise<OpenAIAssistantRunnable<AsAgent, Record<string, any>>>;
+    invoke(input: RunInput, _options?: RunnableConfig): Promise<ExtractRunOutput<AsAgent>>;
+    private _parseStepsInput;
+    private _createRun;
+    private _createThreadAndRun;
+    private _waitForRun;
+    private _getResponse;
+}
+export {};

package/dist/experimental/openai_assistant/index.js

@@ -0,0 +1,217 @@
+import { OpenAI as OpenAIClient } from "openai";
+import { Runnable } from "../../schema/runnable/base.js";
+import { sleep } from "../../util/time.js";
+import { StructuredTool } from "../../tools/base.js";
+import { formatToOpenAIAssistantTool } from "../../tools/convert_to_openai.js";
+export class OpenAIAssistantRunnable extends Runnable {
+    constructor(fields) {
+        super(fields);
+        Object.defineProperty(this, "lc_namespace", {
+            enumerable: true,
+            configurable: true,
+            writable: true,
+            value: ["langchain", "experimental", "openai_assistant"]
+        });
+        Object.defineProperty(this, "client", {
+            enumerable: true,
+            configurable: true,
+            writable: true,
+            value: void 0
+        });
+        Object.defineProperty(this, "assistantId", {
+            enumerable: true,
+            configurable: true,
+            writable: true,
+            value: void 0
+        });
+        Object.defineProperty(this, "pollIntervalMs", {
+            enumerable: true,
+            configurable: true,
+            writable: true,
+            value: 1000
+        });
+        Object.defineProperty(this, "asAgent", {
+            enumerable: true,
+            configurable: true,
+            writable: true,
+            value: void 0
+        });
+        this.client = fields.client ?? new OpenAIClient(fields?.clientOptions);
+        this.assistantId = fields.assistantId;
+        this.asAgent = fields.asAgent ?? this.asAgent;
+    }
+    static async createAssistant({ model, name, instructions, tools, client, clientOptions, asAgent, pollIntervalMs, }) {
+        const formattedTools = tools?.map((tool) => {
+            // eslint-disable-next-line no-instanceof/no-instanceof
+            if (tool instanceof StructuredTool) {
+                return formatToOpenAIAssistantTool(tool);
+            }
+            return tool;
+        }) ?? [];
+        const oaiClient = client ?? new OpenAIClient(clientOptions);
+        const assistant = await oaiClient.beta.assistants.create({
+            name,
+            instructions,
+            tools: formattedTools,
+            model,
+        });
+        return new this({
+            client: oaiClient,
+            assistantId: assistant.id,
+            asAgent,
+            pollIntervalMs,
+        });
+    }
+    async invoke(input, _options) {
+        let run;
+        if (this.asAgent && input.steps && input.steps.length > 0) {
+            const parsedStepsInput = await this._parseStepsInput(input);
+            run = await this.client.beta.threads.runs.submitToolOutputs(parsedStepsInput.threadId, parsedStepsInput.runId, {
+                tool_outputs: parsedStepsInput.toolOutputs,
+            });
+        }
+        else if (!("threadId" in input)) {
+            const thread = {
+                messages: [
+                    {
+                        role: "user",
+                        content: input.content,
+                        file_ids: input.fileIds,
+                        metadata: input.messagesMetadata,
+                    },
+                ],
+                metadata: input.threadMetadata,
+            };
+            run = await this._createThreadAndRun({
+                ...input,
+                thread,
+            });
+        }
+        else if (!("runId" in input)) {
+            await this.client.beta.threads.messages.create(input.threadId, {
+                content: input.content,
+                role: "user",
+                file_ids: input.file_ids,
+                metadata: input.messagesMetadata,
+            });
+            run = await this._createRun(input);
+        }
+        else {
+            // Submitting tool outputs to an existing run, outside the AgentExecutor
+            // framework.
+            run = await this.client.beta.threads.runs.submitToolOutputs(input.runId, input.threadId, {
+                tool_outputs: input.toolOutputs,
+            });
+        }
+        return this._getResponse(run.id, run.thread_id);
+    }
+    async _parseStepsInput(input) {
+        const { action: { runId, threadId }, } = input.steps[input.steps.length - 1];
+        const run = await this._waitForRun(runId, threadId);
+        const toolCalls = run.required_action?.submit_tool_outputs.tool_calls;
+        if (!toolCalls) {
+            return input;
+        }
+        const toolOutputs = toolCalls.flatMap((toolCall) => {
+            const matchedAction = input.steps.find((step) => step.action.toolCallId === toolCall.id);
+            return matchedAction
+                ? [
+                    {
+                        output: matchedAction.observation,
+                        tool_call_id: matchedAction.action.toolCallId,
+                    },
+                ]
+                : [];
+        });
+        return { toolOutputs, runId, threadId };
+    }
+    async _createRun({ instructions, model, tools, metadata, threadId, }) {
+        const run = this.client.beta.threads.runs.create(threadId, {
+            assistant_id: this.assistantId,
+            instructions,
+            model,
+            tools,
+            metadata,
+        });
+        return run;
+    }
+    async _createThreadAndRun(input) {
+        const params = [
+            "instructions",
+            "model",
+            "tools",
+            "run_metadata",
+        ]
+            .filter((key) => key in input)
+            .reduce((obj, key) => {
+            const newObj = obj;
+            newObj[key] = input[key];
+            return newObj;
+        }, {});
+        const run = this.client.beta.threads.createAndRun({
+            ...params,
+            thread: input.thread,
+            assistant_id: this.assistantId,
+        });
+        return run;
+    }
+    async _waitForRun(runId, threadId) {
+        let inProgress = true;
+        let run = {};
+        while (inProgress) {
+            run = await this.client.beta.threads.runs.retrieve(threadId, runId);
+            inProgress = ["in_progress", "queued"].includes(run.status);
+            if (inProgress) {
+                await sleep(this.pollIntervalMs);
+            }
+        }
+        return run;
+    }
+    async _getResponse(runId, threadId) {
+        const run = await this._waitForRun(runId, threadId);
+        if (run.status === "completed") {
+            const messages = await this.client.beta.threads.messages.list(threadId, {
+                order: "asc",
+            });
+            const newMessages = messages.data.filter((msg) => msg.run_id === runId);
+            if (!this.asAgent) {
+                return newMessages;
+            }
+            const answer = newMessages.flatMap((msg) => msg.content);
+            if (answer.every((item) => item.type === "text")) {
+                const answerString = answer
+                    .map((item) => item.type === "text" && item.text.value)
+                    .join("\n");
+                return {
+                    returnValues: {
+                        output: answerString,
+                    },
+                    log: "",
+                    runId,
+                    threadId,
+                };
+            }
+        }
+        else if (run.status === "requires_action") {
+            if (!this.asAgent) {
+                return run.required_action?.submit_tool_outputs.tool_calls ?? [];
+            }
+            const actions = [];
+            run.required_action?.submit_tool_outputs.tool_calls.forEach((item) => {
+                const functionCall = item.function;
+                const args = JSON.parse(functionCall.arguments);
+                actions.push({
+                    tool: functionCall.name,
+                    toolInput: args,
+                    toolCallId: item.id,
+                    log: "",
+                    runId,
+                    threadId,
+                });
+            });
+            return actions;
+        }
+        const runInfo = JSON.stringify(run, null, 2);
+        throw new Error(`Unexpected run status ${run.status}.\nFull run info:\n\n${runInfo}`);
+    }
+}

package/dist/experimental/openai_assistant/schema.cjs

@@ -0,0 +1,2 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });

package/dist/experimental/openai_assistant/schema.d.ts

@@ -0,0 +1,12 @@
+import type { OpenAI as OpenAIClient } from "openai";
+import type { AgentFinish, AgentAction } from "../../schema/index.js";
+export type OpenAIAssistantFinish = AgentFinish & {
+    runId: string;
+    threadId: string;
+};
+export type OpenAIAssistantAction = AgentAction & {
+    toolCallId: string;
+    runId: string;
+    threadId: string;
+};
+export type OpenAIToolType = Array<OpenAIClient.Beta.AssistantCreateParams.AssistantToolsCode | OpenAIClient.Beta.AssistantCreateParams.AssistantToolsRetrieval | OpenAIClient.Beta.AssistantCreateParams.AssistantToolsFunction>;

package/dist/experimental/openai_assistant/schema.js

@@ -0,0 +1 @@
+export {};

package/dist/load/import_map.cjs

@@ -25,7 +25,7 @@ var __importStar = (this && this.__importStar) || function (mod) {
 };
 Object.defineProperty(exports, "__esModule", { value: true });
 exports.chat_models__cloudflare_workersai = exports.chat_models__anthropic = exports.chat_models__openai = exports.chat_models__base = exports.document_transformers__openai_functions = exports.document_loaders__web__sort_xyz_blockchain = exports.document_loaders__web__serpapi = exports.document_loaders__web__searchapi = exports.document_loaders__base = exports.document = exports.memory = exports.text_splitter = exports.vectorstores__xata = exports.vectorstores__vectara = exports.vectorstores__prisma = exports.vectorstores__memory = exports.vectorstores__base = exports.prompts = exports.llms__fake = exports.llms__yandex = exports.llms__fireworks = exports.llms__ollama = exports.llms__cloudflare_workersai = exports.llms__aleph_alpha = exports.llms__ai21 = exports.llms__openai = exports.llms__base = exports.embeddings__voyage = exports.embeddings__minimax = exports.embeddings__openai = exports.embeddings__ollama = exports.embeddings__fake = exports.embeddings__cache_backed = exports.embeddings__base = exports.chains__openai_functions = exports.chains__combine_documents__reduce = exports.chains = exports.tools__render = exports.tools = exports.base_language = exports.agents__openai__output_parser = exports.agents__xml__output_parser = exports.agents__react__output_parser = exports.agents__format_scratchpad__log_to_message = exports.agents__format_scratchpad__xml = exports.agents__format_scratchpad__log = exports.agents__format_scratchpad = exports.agents__toolkits = exports.agents = exports.load__serializable = void 0;
-exports.runnables__remote = exports.evaluation = exports.experimental__chains__violation_of_expectations = exports.experimental__chat_models__bittensor = exports.experimental__plan_and_execute = exports.experimental__generative_agents = exports.experimental__babyagi = exports.experimental__autogpt = exports.util__time = exports.util__math = exports.util__document = exports.storage__in_memory = exports.storage__encoder_backed = exports.stores__message__in_memory = exports.stores__file__in_memory = exports.stores__doc__in_memory = exports.cache = exports.retrievers__vespa = exports.retrievers__score_threshold = exports.retrievers__hyde = exports.retrievers__document_compressors__embeddings_filter = exports.retrievers__document_compressors__chain_extract = exports.retrievers__time_weighted = exports.retrievers__tavily_search_api = exports.retrievers__parent_document = exports.retrievers__multi_vector = exports.retrievers__multi_query = exports.retrievers__document_compressors = exports.retrievers__contextual_compression = exports.retrievers__databerry = exports.retrievers__chaindesk = exports.retrievers__remote = exports.output_parsers = exports.callbacks = exports.schema__storage = exports.schema__runnable = exports.schema__retriever = exports.schema__query_constructor = exports.schema__prompt_template = exports.schema__output_parser = exports.schema__document = exports.schema = exports.chat_models__fake = exports.chat_models__yandex = exports.chat_models__minimax = exports.chat_models__ollama = exports.chat_models__baiduwenxin = exports.chat_models__fireworks = void 0;
+exports.runnables__remote = exports.evaluation = exports.experimental__chains__violation_of_expectations = exports.experimental__chat_models__bittensor = exports.experimental__plan_and_execute = exports.experimental__generative_agents = exports.experimental__babyagi = exports.experimental__openai_assistant = exports.experimental__autogpt = exports.util__time = exports.util__math = exports.util__document = exports.storage__in_memory = exports.storage__encoder_backed = exports.stores__message__in_memory = exports.stores__file__in_memory = exports.stores__doc__in_memory = exports.cache = exports.retrievers__vespa = exports.retrievers__score_threshold = exports.retrievers__hyde = exports.retrievers__document_compressors__embeddings_filter = exports.retrievers__document_compressors__chain_extract = exports.retrievers__time_weighted = exports.retrievers__tavily_search_api = exports.retrievers__parent_document = exports.retrievers__multi_vector = exports.retrievers__multi_query = exports.retrievers__document_compressors = exports.retrievers__contextual_compression = exports.retrievers__databerry = exports.retrievers__chaindesk = exports.retrievers__remote = exports.output_parsers = exports.callbacks = exports.schema__storage = exports.schema__runnable = exports.schema__retriever = exports.schema__query_constructor = exports.schema__prompt_template = exports.schema__output_parser = exports.schema__document = exports.schema = exports.chat_models__fake = exports.chat_models__yandex = exports.chat_models__minimax = exports.chat_models__ollama = exports.chat_models__baiduwenxin = exports.chat_models__fireworks = void 0;
 exports.load__serializable = __importStar(require("../load/serializable.cjs"));
 exports.agents = __importStar(require("../agents/index.cjs"));
 exports.agents__toolkits = __importStar(require("../agents/toolkits/index.cjs"));
@@ -117,6 +117,7 @@ exports.util__document = __importStar(require("../util/document.cjs"));
 exports.util__math = __importStar(require("../util/math.cjs"));
 exports.util__time = __importStar(require("../util/time.cjs"));
 exports.experimental__autogpt = __importStar(require("../experimental/autogpt/index.cjs"));
+exports.experimental__openai_assistant = __importStar(require("../experimental/openai_assistant/index.cjs"));
 exports.experimental__babyagi = __importStar(require("../experimental/babyagi/index.cjs"));
 exports.experimental__generative_agents = __importStar(require("../experimental/generative_agents/index.cjs"));
 exports.experimental__plan_and_execute = __importStar(require("../experimental/plan_and_execute/index.cjs"));

package/dist/load/import_map.d.ts

@@ -89,6 +89,7 @@ export * as util__document from "../util/document.js";
 export * as util__math from "../util/math.js";
 export * as util__time from "../util/time.js";
 export * as experimental__autogpt from "../experimental/autogpt/index.js";
+export * as experimental__openai_assistant from "../experimental/openai_assistant/index.js";
 export * as experimental__babyagi from "../experimental/babyagi/index.js";
 export * as experimental__generative_agents from "../experimental/generative_agents/index.js";
 export * as experimental__plan_and_execute from "../experimental/plan_and_execute/index.js";

package/dist/load/import_map.js

@@ -90,6 +90,7 @@ export * as util__document from "../util/document.js";
 export * as util__math from "../util/math.js";
 export * as util__time from "../util/time.js";
 export * as experimental__autogpt from "../experimental/autogpt/index.js";
+export * as experimental__openai_assistant from "../experimental/openai_assistant/index.js";
 export * as experimental__babyagi from "../experimental/babyagi/index.js";
 export * as experimental__generative_agents from "../experimental/generative_agents/index.js";
 export * as experimental__plan_and_execute from "../experimental/plan_and_execute/index.js";

package/dist/tools/convert_to_openai.cjs

@@ -1,6 +1,6 @@
 "use strict";
 Object.defineProperty(exports, "__esModule", { value: true });
-exports.formatToOpenAITool = exports.formatToOpenAIFunction = void 0;
+exports.formatToOpenAIAssistantTool = exports.formatToOpenAITool = exports.formatToOpenAIFunction = void 0;
 const zod_to_json_schema_1 = require("zod-to-json-schema");
 /**
  * Formats a `StructuredTool` instance into a format that is compatible
@@ -27,3 +27,14 @@ function formatToOpenAITool(tool) {
     };
 }
 exports.formatToOpenAITool = formatToOpenAITool;
+function formatToOpenAIAssistantTool(tool) {
+    return {
+        type: "function",
+        function: {
+            name: tool.name,
+            description: tool.description,
+            parameters: (0, zod_to_json_schema_1.zodToJsonSchema)(tool.schema),
+        },
+    };
+}
+exports.formatToOpenAIAssistantTool = formatToOpenAIAssistantTool;

package/dist/tools/convert_to_openai.d.ts

@@ -8,3 +8,4 @@ import { StructuredTool } from "./base.js";
  */
 export declare function formatToOpenAIFunction(tool: StructuredTool): OpenAIClient.Chat.ChatCompletionCreateParams.Function;
 export declare function formatToOpenAITool(tool: StructuredTool): OpenAIClient.Chat.ChatCompletionTool;
+export declare function formatToOpenAIAssistantTool(tool: StructuredTool): OpenAIClient.Beta.AssistantCreateParams.AssistantToolsFunction;

package/dist/tools/convert_to_openai.js

@@ -22,3 +22,13 @@ export function formatToOpenAITool(tool) {
         },
     };
 }
+export function formatToOpenAIAssistantTool(tool) {
+    return {
+        type: "function",
+        function: {
+            name: tool.name,
+            description: tool.description,
+            parameters: zodToJsonSchema(tool.schema),
+        },
+    };
+}

package/dist/vectorstores/pinecone.cjs

@@ -151,7 +151,7 @@ class PineconeStore extends base_js_1.VectorStore {
      * @returns Promise that resolves when the delete operation is complete.
      */
     async delete(params) {
-        const { deleteAll, ids } = params;
+        const { deleteAll, ids, filter } = params;
         const namespace = this.pineconeIndex.namespace(this.namespace ?? "");
         if (deleteAll) {
             await namespace.deleteAll();
@@ -163,6 +163,9 @@ class PineconeStore extends base_js_1.VectorStore {
                 await namespace.deleteMany(batchIds);
             }
         }
+        else if (filter) {
+            await namespace.deleteMany(filter);
+        }
         else {
             throw new Error("Either ids or delete_all must be provided.");
         }

package/dist/vectorstores/pinecone.d.ts

@@ -12,11 +12,12 @@ export interface PineconeLibArgs extends AsyncCallerParams {
 }
 /**
  * Type that defines the parameters for the delete operation in the
- * PineconeStore class. It includes ids, deleteAll flag, and namespace.
+ * PineconeStore class. It includes ids, filter, deleteAll flag, and namespace.
  */
 export type PineconeDeleteParams = {
     ids?: string[];
     deleteAll?: boolean;
+    filter?: object;
     namespace?: string;
 };
 /**

package/dist/vectorstores/pinecone.js

@@ -122,7 +122,7 @@ export class PineconeStore extends VectorStore {
      * @returns Promise that resolves when the delete operation is complete.
      */
     async delete(params) {
-        const { deleteAll, ids } = params;
+        const { deleteAll, ids, filter } = params;
         const namespace = this.pineconeIndex.namespace(this.namespace ?? "");
         if (deleteAll) {
             await namespace.deleteAll();
@@ -134,6 +134,9 @@ export class PineconeStore extends VectorStore {
                 await namespace.deleteMany(batchIds);
             }
         }
+        else if (filter) {
+            await namespace.deleteMany(filter);
+        }
         else {
             throw new Error("Either ids or delete_all must be provided.");
         }

package/experimental/openai_assistant.cjs

@@ -0,0 +1 @@
+module.exports = require('../dist/experimental/openai_assistant/index.cjs');

package/experimental/openai_assistant.d.ts

@@ -0,0 +1 @@
+export * from '../dist/experimental/openai_assistant/index.js'

package/experimental/openai_assistant.js

@@ -0,0 +1 @@
+export * from '../dist/experimental/openai_assistant/index.js'

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "langchain",
-  "version": "0.0.183",
+  "version": "0.0.184",
   "description": "Typescript bindings for langchain",
   "type": "module",
   "engines": {
@@ -754,6 +754,9 @@
     "experimental/autogpt.cjs",
     "experimental/autogpt.js",
     "experimental/autogpt.d.ts",
+    "experimental/openai_assistant.cjs",
+    "experimental/openai_assistant.js",
+    "experimental/openai_assistant.d.ts",
     "experimental/babyagi.cjs",
     "experimental/babyagi.js",
     "experimental/babyagi.d.ts",
@@ -800,7 +803,7 @@
     "build:esm": "NODE_OPTIONS=--max-old-space-size=4096 tsc --outDir dist/ && rimraf dist/tests dist/**/tests",
     "build:cjs": "NODE_OPTIONS=--max-old-space-size=4096 tsc --outDir dist-cjs/ -p tsconfig.cjs.json && node scripts/move-cjs-to-dist.js && rimraf dist-cjs",
     "build:watch": "node scripts/create-entrypoints.js && tsc --outDir dist/ --watch",
-    "build:scripts": "node scripts/create-entrypoints.js && node scripts/check-tree-shaking.js",
+    "build:scripts": "node scripts/create-entrypoints.js && node scripts/check-tree-shaking.js && node scripts/generate-docs-llm-compatibility-table",
     "lint": "NODE_OPTIONS=--max-old-space-size=4096 eslint src && dpdm --exit-code circular:1 --no-warning --no-tree src/*.ts src/**/*.ts",
     "lint:fix": "yarn lint --fix",
     "precommit": "lint-staged",
@@ -2628,6 +2631,11 @@
       "import": "./experimental/autogpt.js",
       "require": "./experimental/autogpt.cjs"
     },
+    "./experimental/openai_assistant": {
+      "types": "./experimental/openai_assistant.d.ts",
+      "import": "./experimental/openai_assistant.js",
+      "require": "./experimental/openai_assistant.cjs"
+    },
     "./experimental/babyagi": {
       "types": "./experimental/babyagi.d.ts",
       "import": "./experimental/babyagi.js",