langchain 0.0.60 → 0.0.61

package/dist/callbacks/base.cjs

@@ -1,11 +1,10 @@
 "use strict";
 Object.defineProperty(exports, "__esModule", { value: true });
-exports.BaseCallbackHandler = exports.BaseCallbackHandlerMethods = void 0;
+exports.BaseCallbackHandler = void 0;
 const uuid_1 = require("uuid");
-class BaseCallbackHandlerMethods {
+class BaseCallbackHandlerMethodsClass {
 }
-exports.BaseCallbackHandlerMethods = BaseCallbackHandlerMethods;
-class BaseCallbackHandler extends BaseCallbackHandlerMethods {
+class BaseCallbackHandler extends BaseCallbackHandlerMethodsClass {
     constructor(input) {
         super();
         Object.defineProperty(this, "ignoreLLM", {

package/dist/callbacks/base.d.ts

@@ -5,58 +5,150 @@ export interface BaseCallbackHandlerInput {
     ignoreChain?: boolean;
     ignoreAgent?: boolean;
 }
-export declare abstract class BaseCallbackHandlerMethods {
+declare abstract class BaseCallbackHandlerMethodsClass {
+    /**
+     * Called at the start of an LLM or Chat Model run, with the prompt(s)
+     * and the run ID.
+     */
     handleLLMStart?(llm: {
         name: string;
     }, prompts: string[], runId: string, parentRunId?: string): Promise<void> | void;
+    /**
+     * Called when an LLM/ChatModel in `streaming` mode produces a new token
+     */
     handleLLMNewToken?(token: string, runId: string, parentRunId?: string): Promise<void> | void;
+    /**
+     * Called if an LLM/ChatModel run encounters an error
+     */
     handleLLMError?(err: Error, runId: string, parentRunId?: string): Promise<void> | void;
+    /**
+     * Called at the end of an LLM/ChatModel run, with the output and the run ID.
+     */
     handleLLMEnd?(output: LLMResult, runId: string, parentRunId?: string): Promise<void> | void;
+    /**
+     * Called at the start of a Chain run, with the chain name and inputs
+     * and the run ID.
+     */
     handleChainStart?(chain: {
         name: string;
     }, inputs: ChainValues, runId: string, parentRunId?: string): Promise<void> | void;
+    /**
+     * Called if a Chain run encounters an error
+     */
     handleChainError?(err: Error, runId: string, parentRunId?: string): Promise<void> | void;
+    /**
+     * Called at the end of a Chain run, with the outputs and the run ID.
+     */
     handleChainEnd?(outputs: ChainValues, runId: string, parentRunId?: string): Promise<void> | void;
+    /**
+     * Called at the start of a Tool run, with the tool name and input
+     * and the run ID.
+     */
     handleToolStart?(tool: {
         name: string;
     }, input: string, runId: string, parentRunId?: string): Promise<void> | void;
+    /**
+     * Called if a Tool run encounters an error
+     */
     handleToolError?(err: Error, runId: string, parentRunId?: string): Promise<void> | void;
+    /**
+     * Called at the end of a Tool run, with the tool output and the run ID.
+     */
     handleToolEnd?(output: string, runId: string, parentRunId?: string): Promise<void> | void;
     handleText?(text: string, runId: string, parentRunId?: string): Promise<void> | void;
+    /**
+     * Called when an agent is about to execute an action,
+     * with the action and the run ID.
+     */
     handleAgentAction?(action: AgentAction, runId: string, parentRunId?: string): Promise<void> | void;
+    /**
+     * Called when an agent finishes execution, before it exits.
+     * with the final output and the run ID.
+     */
     handleAgentEnd?(action: AgentFinish, runId: string, parentRunId?: string): Promise<void> | void;
 }
-export declare abstract class BaseCallbackHandler extends BaseCallbackHandlerMethods implements BaseCallbackHandlerInput {
+/**
+ * Base interface for callbacks. All methods are optional. If a method is not
+ * implemented, it will be ignored. If a method is implemented, it will be
+ * called at the appropriate time. All methods are called with the run ID of
+ * the LLM/ChatModel/Chain that is running, which is generated by the
+ * CallbackManager.
+ *
+ * @interface
+ */
+export type CallbackHandlerMethods = BaseCallbackHandlerMethodsClass;
+export declare abstract class BaseCallbackHandler extends BaseCallbackHandlerMethodsClass implements BaseCallbackHandlerInput {
     abstract name: string;
     ignoreLLM: boolean;
     ignoreChain: boolean;
     ignoreAgent: boolean;
     constructor(input?: BaseCallbackHandlerInput);
     copy(): BaseCallbackHandler;
-    static fromMethods(methods: BaseCallbackHandlerMethods): {
+    static fromMethods(methods: CallbackHandlerMethods): {
         name: string;
         ignoreLLM: boolean;
         ignoreChain: boolean;
         ignoreAgent: boolean;
         copy(): BaseCallbackHandler;
+        /**
+         * Called at the start of an LLM or Chat Model run, with the prompt(s)
+         * and the run ID.
+         */
         handleLLMStart?(llm: {
             name: string;
         }, prompts: string[], runId: string, parentRunId?: string | undefined): void | Promise<void>;
+        /**
+         * Called when an LLM/ChatModel in `streaming` mode produces a new token
+         */
         handleLLMNewToken?(token: string, runId: string, parentRunId?: string | undefined): void | Promise<void>;
+        /**
+         * Called if an LLM/ChatModel run encounters an error
+         */
         handleLLMError?(err: any, runId: string, parentRunId?: string | undefined): void | Promise<void>;
+        /**
+         * Called at the end of an LLM/ChatModel run, with the output and the run ID.
+         */
         handleLLMEnd?(output: LLMResult, runId: string, parentRunId?: string | undefined): void | Promise<void>;
+        /**
+         * Called at the start of a Chain run, with the chain name and inputs
+         * and the run ID.
+         */
         handleChainStart?(chain: {
             name: string;
         }, inputs: ChainValues, runId: string, parentRunId?: string | undefined): void | Promise<void>;
+        /**
+         * Called if a Chain run encounters an error
+         */
         handleChainError?(err: any, runId: string, parentRunId?: string | undefined): void | Promise<void>;
+        /**
+         * Called at the end of a Chain run, with the outputs and the run ID.
+         */
         handleChainEnd?(outputs: ChainValues, runId: string, parentRunId?: string | undefined): void | Promise<void>;
+        /**
+         * Called at the start of a Tool run, with the tool name and input
+         * and the run ID.
+         */
         handleToolStart?(tool: {
             name: string;
         }, input: string, runId: string, parentRunId?: string | undefined): void | Promise<void>;
+        /**
+         * Called if a Tool run encounters an error
+         */
         handleToolError?(err: any, runId: string, parentRunId?: string | undefined): void | Promise<void>;
+        /**
+         * Called at the end of a Tool run, with the tool output and the run ID.
+         */
         handleToolEnd?(output: string, runId: string, parentRunId?: string | undefined): void | Promise<void>;
         handleText?(text: string, runId: string, parentRunId?: string | undefined): void | Promise<void>;
+        /**
+         * Called when an agent is about to execute an action,
+         * with the action and the run ID.
+         */
         handleAgentAction?(action: AgentAction, runId: string, parentRunId?: string | undefined): void | Promise<void>;
+        /**
+         * Called when an agent finishes execution, before it exits.
+         * with the final output and the run ID.
+         */
         handleAgentEnd?(action: AgentFinish, runId: string, parentRunId?: string | undefined): void | Promise<void>;
     };
 }

package/dist/callbacks/base.js

@@ -1,7 +1,7 @@
 import { v4 as uuidv4 } from "uuid";
-export class BaseCallbackHandlerMethods {
+class BaseCallbackHandlerMethodsClass {
 }
-export class BaseCallbackHandler extends BaseCallbackHandlerMethods {
+export class BaseCallbackHandler extends BaseCallbackHandlerMethodsClass {
     constructor(input) {
         super();
         Object.defineProperty(this, "ignoreLLM", {

package/dist/callbacks/index.cjs

@@ -1,9 +1,8 @@
 "use strict";
 Object.defineProperty(exports, "__esModule", { value: true });
-exports.ConsoleCallbackHandler = exports.CallbackManagerForToolRun = exports.CallbackManagerForLLMRun = exports.CallbackManagerForChainRun = exports.CallbackManager = exports.getTracingCallbackHandler = exports.LangChainTracer = exports.BaseCallbackHandlerMethods = exports.BaseCallbackHandler = void 0;
+exports.ConsoleCallbackHandler = exports.CallbackManagerForToolRun = exports.CallbackManagerForLLMRun = exports.CallbackManagerForChainRun = exports.CallbackManager = exports.getTracingCallbackHandler = exports.LangChainTracer = exports.BaseCallbackHandler = void 0;
 var base_js_1 = require("./base.cjs");
 Object.defineProperty(exports, "BaseCallbackHandler", { enumerable: true, get: function () { return base_js_1.BaseCallbackHandler; } });
-Object.defineProperty(exports, "BaseCallbackHandlerMethods", { enumerable: true, get: function () { return base_js_1.BaseCallbackHandlerMethods; } });
 var tracers_js_1 = require("./handlers/tracers.cjs");
 Object.defineProperty(exports, "LangChainTracer", { enumerable: true, get: function () { return tracers_js_1.LangChainTracer; } });
 var initialize_js_1 = require("./handlers/initialize.cjs");

package/dist/callbacks/index.d.ts

@@ -1,4 +1,4 @@
-export { BaseCallbackHandler, BaseCallbackHandlerMethods, BaseCallbackHandlerInput, } from "./base.js";
+export { BaseCallbackHandler, CallbackHandlerMethods, BaseCallbackHandlerInput, } from "./base.js";
 export { LangChainTracer, BaseRun, LLMRun, ChainRun, ToolRun, } from "./handlers/tracers.js";
 export { getTracingCallbackHandler } from "./handlers/initialize.js";
 export { CallbackManager, CallbackManagerForChainRun, CallbackManagerForLLMRun, CallbackManagerForToolRun, CallbackManagerOptions, Callbacks, } from "./manager.js";

package/dist/callbacks/index.js

@@ -1,4 +1,4 @@
-export { BaseCallbackHandler, BaseCallbackHandlerMethods, } from "./base.js";
+export { BaseCallbackHandler, } from "./base.js";
 export { LangChainTracer, } from "./handlers/tracers.js";
 export { getTracingCallbackHandler } from "./handlers/initialize.js";
 export { CallbackManager, CallbackManagerForChainRun, CallbackManagerForLLMRun, CallbackManagerForToolRun, } from "./manager.js";

package/dist/callbacks/manager.d.ts

@@ -1,13 +1,13 @@
 import { AgentAction, AgentFinish, ChainValues, LLMResult } from "../schema/index.js";
-import { BaseCallbackHandler, BaseCallbackHandlerMethods } from "./base.js";
+import { BaseCallbackHandler, CallbackHandlerMethods } from "./base.js";
 type BaseCallbackManagerMethods = {
-    [K in keyof BaseCallbackHandlerMethods]?: (...args: Parameters<Required<BaseCallbackHandlerMethods>[K]>) => Promise<unknown>;
+    [K in keyof CallbackHandlerMethods]?: (...args: Parameters<Required<CallbackHandlerMethods>[K]>) => Promise<unknown>;
 };
 export interface CallbackManagerOptions {
     verbose?: boolean;
     tracing?: boolean;
 }
-export type Callbacks = CallbackManager | (BaseCallbackHandler | BaseCallbackHandlerMethods)[];
+export type Callbacks = CallbackManager | (BaseCallbackHandler | CallbackHandlerMethods)[];
 export declare abstract class BaseCallbackManager {
     abstract addHandler(handler: BaseCallbackHandler): void;
     abstract removeHandler(handler: BaseCallbackHandler): void;
@@ -58,7 +58,7 @@ export declare class CallbackManager extends BaseCallbackManager implements Base
     removeHandler(handler: BaseCallbackHandler): void;
     setHandlers(handlers: BaseCallbackHandler[], inherit?: boolean): void;
     copy(additionalHandlers?: BaseCallbackHandler[], inherit?: boolean): CallbackManager;
-    static fromHandlers(handlers: BaseCallbackHandlerMethods): CallbackManager;
+    static fromHandlers(handlers: CallbackHandlerMethods): CallbackManager;
     static configure(inheritableHandlers?: Callbacks, localHandlers?: Callbacks, options?: CallbackManagerOptions): Promise<CallbackManager | undefined>;
 }
 export {};

package/dist/tools/index.cjs

@@ -1,6 +1,6 @@
 "use strict";
 Object.defineProperty(exports, "__esModule", { value: true });
-exports.WriteFileTool = exports.ReadFileTool = exports.AIPluginTool = exports.Serper = exports.ZapierNLAWrapper = exports.ZapierNLARunAction = exports.VectorStoreQATool = exports.RequestsPostTool = exports.RequestsGetTool = exports.JsonGetValueTool = exports.JsonListKeysTool = exports.JsonSpec = exports.QueryCheckerTool = exports.ListTablesSqlTool = exports.InfoSqlTool = exports.QuerySqlTool = exports.ChainTool = exports.IFTTTWebhook = exports.DynamicTool = exports.Tool = exports.BingSerpAPI = exports.DadJokeAPI = exports.SerpAPI = void 0;
+exports.WriteFileTool = exports.ReadFileTool = exports.AIPluginTool = exports.Serper = exports.ZapierNLAWrapper = exports.ZapierNLARunAction = exports.VectorStoreQATool = exports.RequestsPostTool = exports.RequestsGetTool = exports.JsonGetValueTool = exports.JsonListKeysTool = exports.JsonSpec = exports.QueryCheckerTool = exports.ListTablesSqlTool = exports.InfoSqlTool = exports.QuerySqlTool = exports.ChainTool = exports.IFTTTWebhook = exports.DynamicTool = exports.StructuredTool = exports.Tool = exports.BingSerpAPI = exports.DadJokeAPI = exports.SerpAPI = void 0;
 var serpapi_js_1 = require("./serpapi.cjs");
 Object.defineProperty(exports, "SerpAPI", { enumerable: true, get: function () { return serpapi_js_1.SerpAPI; } });
 var dadjokeapi_js_1 = require("./dadjokeapi.cjs");
@@ -9,6 +9,7 @@ var bingserpapi_js_1 = require("./bingserpapi.cjs");
 Object.defineProperty(exports, "BingSerpAPI", { enumerable: true, get: function () { return bingserpapi_js_1.BingSerpAPI; } });
 var base_js_1 = require("./base.cjs");
 Object.defineProperty(exports, "Tool", { enumerable: true, get: function () { return base_js_1.Tool; } });
+Object.defineProperty(exports, "StructuredTool", { enumerable: true, get: function () { return base_js_1.StructuredTool; } });
 var dynamic_js_1 = require("./dynamic.cjs");
 Object.defineProperty(exports, "DynamicTool", { enumerable: true, get: function () { return dynamic_js_1.DynamicTool; } });
 var IFTTTWebhook_js_1 = require("./IFTTTWebhook.cjs");

package/dist/tools/index.d.ts

@@ -1,7 +1,7 @@
 export { SerpAPI, SerpAPIParameters } from "./serpapi.js";
 export { DadJokeAPI } from "./dadjokeapi.js";
 export { BingSerpAPI } from "./bingserpapi.js";
-export { Tool, ToolParams } from "./base.js";
+export { Tool, ToolParams, StructuredTool } from "./base.js";
 export { DynamicTool, DynamicToolInput } from "./dynamic.js";
 export { IFTTTWebhook } from "./IFTTTWebhook.js";
 export { ChainTool, ChainToolInput } from "./chain.js";

package/dist/tools/index.js

@@ -1,7 +1,7 @@
 export { SerpAPI } from "./serpapi.js";
 export { DadJokeAPI } from "./dadjokeapi.js";
 export { BingSerpAPI } from "./bingserpapi.js";
-export { Tool } from "./base.js";
+export { Tool, StructuredTool } from "./base.js";
 export { DynamicTool } from "./dynamic.js";
 export { IFTTTWebhook } from "./IFTTTWebhook.js";
 export { ChainTool } from "./chain.js";

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "langchain",
-  "version": "0.0.60",
+  "version": "0.0.61",
   "description": "Typescript bindings for langchain",
   "type": "module",
   "engines": {