@langchain/core 0.3.72 → 1.0.0-alpha.2

package/dist/callbacks/base.d.cts

@@ -0,0 +1,318 @@
+import { AgentAction, AgentFinish } from "../agents.cjs";
+import { SerializedFields } from "../load/map_keys.cjs";
+import { Serializable, Serialized, SerializedNotImplemented } from "../load/serializable.cjs";
+import { ChainValues } from "../utils/types/index.cjs";
+import { BaseMessage } from "../messages/base.cjs";
+import { ChatGenerationChunk, GenerationChunk, LLMResult } from "../outputs.cjs";
+import { DocumentInterface } from "../documents/document.cjs";
+
+//#region src/callbacks/base.d.ts
+// eslint-disable-next-line @typescript-eslint/no-explicit-any
+type Error = any;
+/**
+ * Interface for the input parameters of the BaseCallbackHandler class. It
+ * allows to specify which types of events should be ignored by the
+ * callback handler.
+ */
+interface BaseCallbackHandlerInput {
+  ignoreLLM?: boolean;
+  ignoreChain?: boolean;
+  ignoreAgent?: boolean;
+  ignoreRetriever?: boolean;
+  ignoreCustomEvent?: boolean;
+  _awaitHandler?: boolean;
+  raiseError?: boolean;
+}
+/**
+ * Interface for the indices of a new token produced by an LLM or Chat
+ * Model in streaming mode.
+ */
+interface NewTokenIndices {
+  prompt: number;
+  completion: number;
+}
+// TODO: Add all additional callback fields here
+type HandleLLMNewTokenCallbackFields = {
+  chunk?: GenerationChunk | ChatGenerationChunk;
+};
+/**
+ * Abstract class that provides a set of optional methods that can be
+ * overridden in derived classes to handle various events during the
+ * execution of a LangChain application.
+ */
+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: Serialized, prompts: string[], runId: string, parentRunId?: string, extraParams?: Record<string, unknown>, tags?: string[], metadata?: Record<string, unknown>, runName?: string):
+  // eslint-disable-next-line @typescript-eslint/no-explicit-any
+  Promise<any> | any;
+  /**
+   * Called when an LLM/ChatModel in `streaming` mode produces a new token
+   */
+  handleLLMNewToken?(token: string,
+  /**
+   * idx.prompt is the index of the prompt that produced the token
+   *   (if there are multiple prompts)
+   * idx.completion is the index of the completion that produced the token
+   *   (if multiple completions per prompt are requested)
+   */
+  idx: NewTokenIndices, runId: string, parentRunId?: string, tags?: string[], fields?: HandleLLMNewTokenCallbackFields):
+  // eslint-disable-next-line @typescript-eslint/no-explicit-any
+  Promise<any> | any;
+  /**
+   * Called if an LLM/ChatModel run encounters an error
+   */
+  handleLLMError?(err: Error, runId: string, parentRunId?: string, tags?: string[], extraParams?: Record<string, unknown>):
+  // eslint-disable-next-line @typescript-eslint/no-explicit-any
+  Promise<any> | any;
+  /**
+   * Called at the end of an LLM/ChatModel run, with the output and the run ID.
+   */
+  handleLLMEnd?(output: LLMResult, runId: string, parentRunId?: string, tags?: string[], extraParams?: Record<string, unknown>):
+  // eslint-disable-next-line @typescript-eslint/no-explicit-any
+  Promise<any> | any;
+  /**
+   * Called at the start of a Chat Model run, with the prompt(s)
+   * and the run ID.
+   */
+  handleChatModelStart?(llm: Serialized, messages: BaseMessage[][], runId: string, parentRunId?: string, extraParams?: Record<string, unknown>, tags?: string[], metadata?: Record<string, unknown>, runName?: string):
+  // eslint-disable-next-line @typescript-eslint/no-explicit-any
+  Promise<any> | any;
+  /**
+   * Called at the start of a Chain run, with the chain name and inputs
+   * and the run ID.
+   */
+  handleChainStart?(chain: Serialized, inputs: ChainValues, runId: string, parentRunId?: string, tags?: string[], metadata?: Record<string, unknown>, runType?: string, runName?: string):
+  // eslint-disable-next-line @typescript-eslint/no-explicit-any
+  Promise<any> | any;
+  /**
+   * Called if a Chain run encounters an error
+   */
+  handleChainError?(err: Error, runId: string, parentRunId?: string, tags?: string[], kwargs?: {
+    inputs?: Record<string, unknown>;
+  }):
+  // eslint-disable-next-line @typescript-eslint/no-explicit-any
+  Promise<any> | any;
+  /**
+   * Called at the end of a Chain run, with the outputs and the run ID.
+   */
+  handleChainEnd?(outputs: ChainValues, runId: string, parentRunId?: string, tags?: string[], kwargs?: {
+    inputs?: Record<string, unknown>;
+  }):
+  // eslint-disable-next-line @typescript-eslint/no-explicit-any
+  Promise<any> | any;
+  /**
+   * Called at the start of a Tool run, with the tool name and input
+   * and the run ID.
+   */
+  handleToolStart?(tool: Serialized, input: string, runId: string, parentRunId?: string, tags?: string[], metadata?: Record<string, unknown>, runName?: string):
+  // eslint-disable-next-line @typescript-eslint/no-explicit-any
+  Promise<any> | any;
+  /**
+   * Called if a Tool run encounters an error
+   */
+  handleToolError?(err: Error, runId: string, parentRunId?: string, tags?: string[]):
+  // eslint-disable-next-line @typescript-eslint/no-explicit-any
+  Promise<any> | any;
+  /**
+   * Called at the end of a Tool run, with the tool output and the run ID.
+   */
+  handleToolEnd?(
+  // eslint-disable-next-line @typescript-eslint/no-explicit-any
+  output: any, runId: string, parentRunId?: string, tags?: string[]):
+  // eslint-disable-next-line @typescript-eslint/no-explicit-any
+  Promise<any> | any;
+  handleText?(text: string, runId: string, parentRunId?: string, tags?: 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, tags?: 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, tags?: string[]): Promise<void> | void;
+  handleRetrieverStart?(retriever: Serialized, query: string, runId: string, parentRunId?: string, tags?: string[], metadata?: Record<string, unknown>, name?: string):
+  // eslint-disable-next-line @typescript-eslint/no-explicit-any
+  Promise<any> | any;
+  handleRetrieverEnd?(documents: DocumentInterface[], runId: string, parentRunId?: string, tags?: string[]):
+  // eslint-disable-next-line @typescript-eslint/no-explicit-any
+  Promise<any> | any;
+  handleRetrieverError?(err: Error, runId: string, parentRunId?: string, tags?: string[]):
+  // eslint-disable-next-line @typescript-eslint/no-explicit-any
+  Promise<any> | any;
+  handleCustomEvent?(eventName: string,
+  // eslint-disable-next-line @typescript-eslint/no-explicit-any
+  data: any, runId: string, tags?: string[],
+  // eslint-disable-next-line @typescript-eslint/no-explicit-any
+  metadata?: Record<string, any>):
+  // eslint-disable-next-line @typescript-eslint/no-explicit-any
+  Promise<any> | any;
+}
+/**
+ * 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
+ */
+type CallbackHandlerMethods = BaseCallbackHandlerMethodsClass;
+/**
+ * Interface for handlers that can indicate a preference for streaming responses.
+ * When implemented, this allows the handler to signal whether it prefers to receive
+ * streaming responses from language models rather than complete responses.
+ */
+interface CallbackHandlerPrefersStreaming {
+  readonly lc_prefer_streaming: boolean;
+}
+declare function callbackHandlerPrefersStreaming(x: BaseCallbackHandler): unknown;
+/**
+ * Abstract base class for creating callback handlers in the LangChain
+ * framework. It provides a set of optional methods that can be overridden
+ * in derived classes to handle various events during the execution of a
+ * LangChain application.
+ */
+declare abstract class BaseCallbackHandler extends BaseCallbackHandlerMethodsClass implements BaseCallbackHandlerInput, Serializable {
+  lc_serializable: boolean;
+  get lc_namespace(): ["langchain_core", "callbacks", string];
+  get lc_secrets(): {
+    [key: string]: string;
+  } | undefined;
+  get lc_attributes(): {
+    [key: string]: string;
+  } | undefined;
+  get lc_aliases(): {
+    [key: string]: string;
+  } | undefined;
+  get lc_serializable_keys(): string[] | undefined;
+  /**
+   * The name of the serializable. Override to provide an alias or
+   * to preserve the serialized module name in minified environments.
+   *
+   * Implemented as a static method to support loading logic.
+   */
+  static lc_name(): string;
+  /**
+   * The final serialized identifier for the module.
+   */
+  get lc_id(): string[];
+  lc_kwargs: SerializedFields;
+  abstract name: string;
+  ignoreLLM: boolean;
+  ignoreChain: boolean;
+  ignoreAgent: boolean;
+  ignoreRetriever: boolean;
+  ignoreCustomEvent: boolean;
+  raiseError: boolean;
+  awaitHandlers: boolean;
+  constructor(input?: BaseCallbackHandlerInput);
+  copy(): BaseCallbackHandler;
+  toJSON(): Serialized;
+  toJSONNotImplemented(): SerializedNotImplemented;
+  static fromMethods(methods: CallbackHandlerMethods): {
+    /**
+     * Called at the start of an LLM or Chat Model run, with the prompt(s)
+     * and the run ID.
+     */
+    handleLLMStart?(llm: Serialized, prompts: string[], runId: string, parentRunId?: string | undefined, extraParams?: Record<string, unknown> | undefined, tags?: string[] | undefined, metadata?: Record<string, unknown> | undefined, runName?: string | undefined): any;
+    /**
+     * Called when an LLM/ChatModel in `streaming` mode produces a new token
+     */
+    handleLLMNewToken?(token: string, idx: NewTokenIndices, runId: string, parentRunId?: string | undefined, tags?: string[] | undefined, fields?: HandleLLMNewTokenCallbackFields | undefined): any;
+    /**
+     * Called if an LLM/ChatModel run encounters an error
+     */
+    handleLLMError?(err: any, runId: string, parentRunId?: string | undefined, tags?: string[] | undefined, extraParams?: Record<string, unknown> | undefined): any;
+    /**
+     * Called at the end of an LLM/ChatModel run, with the output and the run ID.
+     */
+    handleLLMEnd?(output: LLMResult, runId: string, parentRunId?: string | undefined, tags?: string[] | undefined, extraParams?: Record<string, unknown> | undefined): any;
+    /**
+     * Called at the start of a Chat Model run, with the prompt(s)
+     * and the run ID.
+     */
+    handleChatModelStart?(llm: Serialized, messages: BaseMessage[][], runId: string, parentRunId?: string | undefined, extraParams?: Record<string, unknown> | undefined, tags?: string[] | undefined, metadata?: Record<string, unknown> | undefined, runName?: string | undefined): any;
+    /**
+     * Called at the start of a Chain run, with the chain name and inputs
+     * and the run ID.
+     */
+    handleChainStart?(chain: Serialized, inputs: ChainValues, runId: string, parentRunId?: string | undefined, tags?: string[] | undefined, metadata?: Record<string, unknown> | undefined, runType?: string | undefined, runName?: string | undefined): any;
+    /**
+     * Called if a Chain run encounters an error
+     */
+    handleChainError?(err: any, runId: string, parentRunId?: string | undefined, tags?: string[] | undefined, kwargs?: {
+      inputs?: Record<string, unknown> | undefined;
+    } | undefined): any;
+    /**
+     * Called at the end of a Chain run, with the outputs and the run ID.
+     */
+    handleChainEnd?(outputs: ChainValues, runId: string, parentRunId?: string | undefined, tags?: string[] | undefined, kwargs?: {
+      inputs?: Record<string, unknown> | undefined;
+    } | undefined): any;
+    /**
+     * Called at the start of a Tool run, with the tool name and input
+     * and the run ID.
+     */
+    handleToolStart?(tool: Serialized, input: string, runId: string, parentRunId?: string | undefined, tags?: string[] | undefined, metadata?: Record<string, unknown> | undefined, runName?: string | undefined): any;
+    /**
+     * Called if a Tool run encounters an error
+     */
+    handleToolError?(err: any, runId: string, parentRunId?: string | undefined, tags?: string[] | undefined): any;
+    /**
+     * Called at the end of a Tool run, with the tool output and the run ID.
+     */
+    handleToolEnd?(output: any, runId: string, parentRunId?: string | undefined, tags?: string[] | undefined): any;
+    handleText?(text: string, runId: string, parentRunId?: string | undefined, tags?: 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, tags?: 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, tags?: string[] | undefined): void | Promise<void>;
+    handleRetrieverStart?(retriever: Serialized, query: string, runId: string, parentRunId?: string | undefined, tags?: string[] | undefined, metadata?: Record<string, unknown> | undefined, name?: string | undefined): any;
+    handleRetrieverEnd?(documents: DocumentInterface<Record<string, any>>[], runId: string, parentRunId?: string | undefined, tags?: string[] | undefined): any;
+    handleRetrieverError?(err: any, runId: string, parentRunId?: string | undefined, tags?: string[] | undefined): any;
+    handleCustomEvent?(eventName: string, data: any, runId: string, tags?: string[] | undefined, metadata?: Record<string, any> | undefined): any;
+    lc_serializable: boolean;
+    readonly lc_namespace: ["langchain_core", "callbacks", string];
+    readonly lc_secrets: {
+      [key: string]: string;
+    } | undefined;
+    readonly lc_attributes: {
+      [key: string]: string;
+    } | undefined;
+    readonly lc_aliases: {
+      [key: string]: string;
+    } | undefined;
+    readonly lc_serializable_keys: string[] | undefined;
+    /**
+     * The final serialized identifier for the module.
+     */
+    readonly lc_id: string[];
+    lc_kwargs: SerializedFields;
+    ignoreLLM: boolean;
+    ignoreChain: boolean;
+    ignoreAgent: boolean;
+    ignoreRetriever: boolean;
+    ignoreCustomEvent: boolean;
+    raiseError: boolean;
+    awaitHandlers: boolean;
+    copy(): BaseCallbackHandler;
+    toJSON(): Serialized;
+    toJSONNotImplemented(): SerializedNotImplemented;
+    name: string;
+  };
+}
+declare const isBaseCallbackHandler: (x: unknown) => boolean;
+//#endregion
+export { BaseCallbackHandler, BaseCallbackHandlerInput, CallbackHandlerMethods, CallbackHandlerPrefersStreaming, HandleLLMNewTokenCallbackFields, NewTokenIndices, callbackHandlerPrefersStreaming, isBaseCallbackHandler };
+//# sourceMappingURL=base.d.cts.map

package/dist/callbacks/base.d.cts.map

@@ -0,0 +1 @@
+{"version":3,"file":"base.d.cts","names":["ChainValues","BaseMessage","AgentAction","AgentFinish","ChatGenerationChunk","GenerationChunk","LLMResult","Serializable","Serialized","SerializedNotImplemented","SerializedFields","DocumentInterface","Error","BaseCallbackHandlerInput","NewTokenIndices","HandleLLMNewTokenCallbackFields","BaseCallbackHandlerMethodsClass","Record","Promise","CallbackHandlerMethods","CallbackHandlerPrefersStreaming","callbackHandlerPrefersStreaming","BaseCallbackHandler","isBaseCallbackHandler"],"sources":["../../src/callbacks/base.d.ts"],"sourcesContent":["import type { ChainValues } from \"../utils/types/index.js\";\nimport type { BaseMessage } from \"../messages/base.js\";\nimport type { AgentAction, AgentFinish } from \"../agents.js\";\nimport type { ChatGenerationChunk, GenerationChunk, LLMResult } from \"../outputs.js\";\nimport { Serializable, Serialized, SerializedNotImplemented } from \"../load/serializable.js\";\nimport type { SerializedFields } from \"../load/map_keys.js\";\nimport type { DocumentInterface } from \"../documents/document.js\";\n// eslint-disable-next-line @typescript-eslint/no-explicit-any\ntype Error = any;\n/**\n * Interface for the input parameters of the BaseCallbackHandler class. It\n * allows to specify which types of events should be ignored by the\n * callback handler.\n */\nexport interface BaseCallbackHandlerInput {\n    ignoreLLM?: boolean;\n    ignoreChain?: boolean;\n    ignoreAgent?: boolean;\n    ignoreRetriever?: boolean;\n    ignoreCustomEvent?: boolean;\n    _awaitHandler?: boolean;\n    raiseError?: boolean;\n}\n/**\n * Interface for the indices of a new token produced by an LLM or Chat\n * Model in streaming mode.\n */\nexport interface NewTokenIndices {\n    prompt: number;\n    completion: number;\n}\n// TODO: Add all additional callback fields here\nexport type HandleLLMNewTokenCallbackFields = {\n    chunk?: GenerationChunk | ChatGenerationChunk;\n};\n/**\n * Abstract class that provides a set of optional methods that can be\n * overridden in derived classes to handle various events during the\n * execution of a LangChain application.\n */\ndeclare abstract class BaseCallbackHandlerMethodsClass {\n    /**\n     * Called at the start of an LLM or Chat Model run, with the prompt(s)\n     * and the run ID.\n     */\n    handleLLMStart?(llm: Serialized, prompts: string[], runId: string, parentRunId?: string, extraParams?: Record<string, unknown>, tags?: string[], metadata?: Record<string, unknown>, runName?: string): // eslint-disable-next-line @typescript-eslint/no-explicit-any\n    Promise<any> | any;\n    /**\n     * Called when an LLM/ChatModel in `streaming` mode produces a new token\n     */\n    handleLLMNewToken?(token: string, \n    /**\n     * idx.prompt is the index of the prompt that produced the token\n     *   (if there are multiple prompts)\n     * idx.completion is the index of the completion that produced the token\n     *   (if multiple completions per prompt are requested)\n     */\n    idx: NewTokenIndices, runId: string, parentRunId?: string, tags?: string[], fields?: HandleLLMNewTokenCallbackFields): // eslint-disable-next-line @typescript-eslint/no-explicit-any\n    Promise<any> | any;\n    /**\n     * Called if an LLM/ChatModel run encounters an error\n     */\n    handleLLMError?(err: Error, runId: string, parentRunId?: string, tags?: string[], extraParams?: Record<string, unknown>): // eslint-disable-next-line @typescript-eslint/no-explicit-any\n    Promise<any> | any;\n    /**\n     * Called at the end of an LLM/ChatModel run, with the output and the run ID.\n     */\n    handleLLMEnd?(output: LLMResult, runId: string, parentRunId?: string, tags?: string[], extraParams?: Record<string, unknown>): // eslint-disable-next-line @typescript-eslint/no-explicit-any\n    Promise<any> | any;\n    /**\n     * Called at the start of a Chat Model run, with the prompt(s)\n     * and the run ID.\n     */\n    handleChatModelStart?(llm: Serialized, messages: BaseMessage[][], runId: string, parentRunId?: string, extraParams?: Record<string, unknown>, tags?: string[], metadata?: Record<string, unknown>, runName?: string): // eslint-disable-next-line @typescript-eslint/no-explicit-any\n    Promise<any> | any;\n    /**\n     * Called at the start of a Chain run, with the chain name and inputs\n     * and the run ID.\n     */\n    handleChainStart?(chain: Serialized, inputs: ChainValues, runId: string, parentRunId?: string, tags?: string[], metadata?: Record<string, unknown>, runType?: string, runName?: string): // eslint-disable-next-line @typescript-eslint/no-explicit-any\n    Promise<any> | any;\n    /**\n     * Called if a Chain run encounters an error\n     */\n    handleChainError?(err: Error, runId: string, parentRunId?: string, tags?: string[], kwargs?: {\n        inputs?: Record<string, unknown>;\n    }): // eslint-disable-next-line @typescript-eslint/no-explicit-any\n    Promise<any> | any;\n    /**\n     * Called at the end of a Chain run, with the outputs and the run ID.\n     */\n    handleChainEnd?(outputs: ChainValues, runId: string, parentRunId?: string, tags?: string[], kwargs?: {\n        inputs?: Record<string, unknown>;\n    }): // eslint-disable-next-line @typescript-eslint/no-explicit-any\n    Promise<any> | any;\n    /**\n     * Called at the start of a Tool run, with the tool name and input\n     * and the run ID.\n     */\n    handleToolStart?(tool: Serialized, input: string, runId: string, parentRunId?: string, tags?: string[], metadata?: Record<string, unknown>, runName?: string): // eslint-disable-next-line @typescript-eslint/no-explicit-any\n    Promise<any> | any;\n    /**\n     * Called if a Tool run encounters an error\n     */\n    handleToolError?(err: Error, runId: string, parentRunId?: string, tags?: string[]): // eslint-disable-next-line @typescript-eslint/no-explicit-any\n    Promise<any> | any;\n    /**\n     * Called at the end of a Tool run, with the tool output and the run ID.\n     */\n    handleToolEnd?(\n    // eslint-disable-next-line @typescript-eslint/no-explicit-any\n    output: any, runId: string, parentRunId?: string, tags?: string[]): // eslint-disable-next-line @typescript-eslint/no-explicit-any\n    Promise<any> | any;\n    handleText?(text: string, runId: string, parentRunId?: string, tags?: string[]): Promise<void> | void;\n    /**\n     * Called when an agent is about to execute an action,\n     * with the action and the run ID.\n     */\n    handleAgentAction?(action: AgentAction, runId: string, parentRunId?: string, tags?: string[]): Promise<void> | void;\n    /**\n     * Called when an agent finishes execution, before it exits.\n     * with the final output and the run ID.\n     */\n    handleAgentEnd?(action: AgentFinish, runId: string, parentRunId?: string, tags?: string[]): Promise<void> | void;\n    handleRetrieverStart?(retriever: Serialized, query: string, runId: string, parentRunId?: string, tags?: string[], metadata?: Record<string, unknown>, name?: string): // eslint-disable-next-line @typescript-eslint/no-explicit-any\n    Promise<any> | any;\n    handleRetrieverEnd?(documents: DocumentInterface[], runId: string, parentRunId?: string, tags?: string[]): // eslint-disable-next-line @typescript-eslint/no-explicit-any\n    Promise<any> | any;\n    handleRetrieverError?(err: Error, runId: string, parentRunId?: string, tags?: string[]): // eslint-disable-next-line @typescript-eslint/no-explicit-any\n    Promise<any> | any;\n    handleCustomEvent?(eventName: string, \n    // eslint-disable-next-line @typescript-eslint/no-explicit-any\n    data: any, runId: string, tags?: string[], \n    // eslint-disable-next-line @typescript-eslint/no-explicit-any\n    metadata?: Record<string, any>): // eslint-disable-next-line @typescript-eslint/no-explicit-any\n    Promise<any> | any;\n}\n/**\n * Base interface for callbacks. All methods are optional. If a method is not\n * implemented, it will be ignored. If a method is implemented, it will be\n * called at the appropriate time. All methods are called with the run ID of\n * the LLM/ChatModel/Chain that is running, which is generated by the\n * CallbackManager.\n *\n * @interface\n */\nexport type CallbackHandlerMethods = BaseCallbackHandlerMethodsClass;\n/**\n * Interface for handlers that can indicate a preference for streaming responses.\n * When implemented, this allows the handler to signal whether it prefers to receive\n * streaming responses from language models rather than complete responses.\n */\nexport interface CallbackHandlerPrefersStreaming {\n    readonly lc_prefer_streaming: boolean;\n}\nexport declare function callbackHandlerPrefersStreaming(x: BaseCallbackHandler): unknown;\n/**\n * Abstract base class for creating callback handlers in the LangChain\n * framework. It provides a set of optional methods that can be overridden\n * in derived classes to handle various events during the execution of a\n * LangChain application.\n */\nexport declare abstract class BaseCallbackHandler extends BaseCallbackHandlerMethodsClass implements BaseCallbackHandlerInput, Serializable {\n    lc_serializable: boolean;\n    get lc_namespace(): [\"langchain_core\", \"callbacks\", string];\n    get lc_secrets(): {\n        [key: string]: string;\n    } | undefined;\n    get lc_attributes(): {\n        [key: string]: string;\n    } | undefined;\n    get lc_aliases(): {\n        [key: string]: string;\n    } | undefined;\n    get lc_serializable_keys(): string[] | undefined;\n    /**\n     * The name of the serializable. Override to provide an alias or\n     * to preserve the serialized module name in minified environments.\n     *\n     * Implemented as a static method to support loading logic.\n     */\n    static lc_name(): string;\n    /**\n     * The final serialized identifier for the module.\n     */\n    get lc_id(): string[];\n    lc_kwargs: SerializedFields;\n    abstract name: string;\n    ignoreLLM: boolean;\n    ignoreChain: boolean;\n    ignoreAgent: boolean;\n    ignoreRetriever: boolean;\n    ignoreCustomEvent: boolean;\n    raiseError: boolean;\n    awaitHandlers: boolean;\n    constructor(input?: BaseCallbackHandlerInput);\n    copy(): BaseCallbackHandler;\n    toJSON(): Serialized;\n    toJSONNotImplemented(): SerializedNotImplemented;\n    static fromMethods(methods: CallbackHandlerMethods): {\n        /**\n         * Called at the start of an LLM or Chat Model run, with the prompt(s)\n         * and the run ID.\n         */\n        handleLLMStart?(llm: Serialized, prompts: string[], runId: string, parentRunId?: string | undefined, extraParams?: Record<string, unknown> | undefined, tags?: string[] | undefined, metadata?: Record<string, unknown> | undefined, runName?: string | undefined): any;\n        /**\n         * Called when an LLM/ChatModel in `streaming` mode produces a new token\n         */\n        handleLLMNewToken?(token: string, idx: NewTokenIndices, runId: string, parentRunId?: string | undefined, tags?: string[] | undefined, fields?: HandleLLMNewTokenCallbackFields | undefined): any;\n        /**\n         * Called if an LLM/ChatModel run encounters an error\n         */\n        handleLLMError?(err: any, runId: string, parentRunId?: string | undefined, tags?: string[] | undefined, extraParams?: Record<string, unknown> | undefined): any;\n        /**\n         * Called at the end of an LLM/ChatModel run, with the output and the run ID.\n         */\n        handleLLMEnd?(output: LLMResult, runId: string, parentRunId?: string | undefined, tags?: string[] | undefined, extraParams?: Record<string, unknown> | undefined): any;\n        /**\n         * Called at the start of a Chat Model run, with the prompt(s)\n         * and the run ID.\n         */\n        handleChatModelStart?(llm: Serialized, messages: BaseMessage[][], runId: string, parentRunId?: string | undefined, extraParams?: Record<string, unknown> | undefined, tags?: string[] | undefined, metadata?: Record<string, unknown> | undefined, runName?: string | undefined): any;\n        /**\n         * Called at the start of a Chain run, with the chain name and inputs\n         * and the run ID.\n         */\n        handleChainStart?(chain: Serialized, inputs: ChainValues, runId: string, parentRunId?: string | undefined, tags?: string[] | undefined, metadata?: Record<string, unknown> | undefined, runType?: string | undefined, runName?: string | undefined): any;\n        /**\n         * Called if a Chain run encounters an error\n         */\n        handleChainError?(err: any, runId: string, parentRunId?: string | undefined, tags?: string[] | undefined, kwargs?: {\n            inputs?: Record<string, unknown> | undefined;\n        } | undefined): any;\n        /**\n         * Called at the end of a Chain run, with the outputs and the run ID.\n         */\n        handleChainEnd?(outputs: ChainValues, runId: string, parentRunId?: string | undefined, tags?: string[] | undefined, kwargs?: {\n            inputs?: Record<string, unknown> | undefined;\n        } | undefined): any;\n        /**\n         * Called at the start of a Tool run, with the tool name and input\n         * and the run ID.\n         */\n        handleToolStart?(tool: Serialized, input: string, runId: string, parentRunId?: string | undefined, tags?: string[] | undefined, metadata?: Record<string, unknown> | undefined, runName?: string | undefined): any;\n        /**\n         * Called if a Tool run encounters an error\n         */\n        handleToolError?(err: any, runId: string, parentRunId?: string | undefined, tags?: string[] | undefined): any;\n        /**\n         * Called at the end of a Tool run, with the tool output and the run ID.\n         */\n        handleToolEnd?(output: any, runId: string, parentRunId?: string | undefined, tags?: string[] | undefined): any;\n        handleText?(text: string, runId: string, parentRunId?: string | undefined, tags?: string[] | undefined): void | Promise<void>;\n        /**\n         * Called when an agent is about to execute an action,\n         * with the action and the run ID.\n         */\n        handleAgentAction?(action: AgentAction, runId: string, parentRunId?: string | undefined, tags?: string[] | undefined): void | Promise<void>;\n        /**\n         * Called when an agent finishes execution, before it exits.\n         * with the final output and the run ID.\n         */\n        handleAgentEnd?(action: AgentFinish, runId: string, parentRunId?: string | undefined, tags?: string[] | undefined): void | Promise<void>;\n        handleRetrieverStart?(retriever: Serialized, query: string, runId: string, parentRunId?: string | undefined, tags?: string[] | undefined, metadata?: Record<string, unknown> | undefined, name?: string | undefined): any;\n        handleRetrieverEnd?(documents: DocumentInterface<Record<string, any>>[], runId: string, parentRunId?: string | undefined, tags?: string[] | undefined): any;\n        handleRetrieverError?(err: any, runId: string, parentRunId?: string | undefined, tags?: string[] | undefined): any;\n        handleCustomEvent?(eventName: string, data: any, runId: string, tags?: string[] | undefined, metadata?: Record<string, any> | undefined): any;\n        lc_serializable: boolean;\n        readonly lc_namespace: [\"langchain_core\", \"callbacks\", string];\n        readonly lc_secrets: {\n            [key: string]: string;\n        } | undefined;\n        readonly lc_attributes: {\n            [key: string]: string;\n        } | undefined;\n        readonly lc_aliases: {\n            [key: string]: string;\n        } | undefined;\n        readonly lc_serializable_keys: string[] | undefined;\n        /**\n         * The final serialized identifier for the module.\n         */\n        readonly lc_id: string[];\n        lc_kwargs: SerializedFields;\n        ignoreLLM: boolean;\n        ignoreChain: boolean;\n        ignoreAgent: boolean;\n        ignoreRetriever: boolean;\n        ignoreCustomEvent: boolean;\n        raiseError: boolean;\n        awaitHandlers: boolean;\n        copy(): BaseCallbackHandler;\n        toJSON(): Serialized;\n        toJSONNotImplemented(): SerializedNotImplemented;\n        name: string;\n    };\n}\nexport declare const isBaseCallbackHandler: (x: unknown) => boolean;\nexport {};\n"],"mappings":"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"}