@langchain/core 1.1.39 → 1.1.40
This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
- package/CHANGELOG.md +9 -0
- package/dist/callbacks/base.d.cts.map +1 -1
- package/dist/callbacks/base.d.ts.map +1 -1
- package/dist/callbacks/manager.cjs +12 -0
- package/dist/callbacks/manager.cjs.map +1 -1
- package/dist/callbacks/manager.d.cts +2 -0
- package/dist/callbacks/manager.d.cts.map +1 -1
- package/dist/callbacks/manager.d.ts +2 -0
- package/dist/callbacks/manager.d.ts.map +1 -1
- package/dist/callbacks/manager.js +12 -0
- package/dist/callbacks/manager.js.map +1 -1
- package/dist/language_models/base.cjs +1 -1
- package/dist/language_models/base.js +1 -1
- package/dist/runnables/config.cjs +16 -8
- package/dist/runnables/config.cjs.map +1 -1
- package/dist/runnables/config.d.cts.map +1 -1
- package/dist/runnables/config.d.ts.map +1 -1
- package/dist/runnables/config.js +16 -8
- package/dist/runnables/config.js.map +1 -1
- package/dist/tracers/tracer_langchain.cjs +51 -1
- package/dist/tracers/tracer_langchain.cjs.map +1 -1
- package/dist/tracers/tracer_langchain.d.cts +13 -0
- package/dist/tracers/tracer_langchain.d.cts.map +1 -1
- package/dist/tracers/tracer_langchain.d.ts +13 -0
- package/dist/tracers/tracer_langchain.d.ts.map +1 -1
- package/dist/tracers/tracer_langchain.js +51 -1
- package/dist/tracers/tracer_langchain.js.map +1 -1
- package/package.json +1 -1
|
@@ -1 +1 @@
|
|
|
1
|
-
{"version":3,"file":"manager.js","names":["uuidv7"],"sources":["../../src/callbacks/manager.ts"],"sourcesContent":["import { v7 as uuidv7 } from \"uuid\";\nimport { AgentAction, AgentFinish } from \"../agents.js\";\nimport type { ChainValues } from \"../utils/types/index.js\";\nimport { LLMResult } from \"../outputs.js\";\nimport {\n BaseCallbackHandler,\n CallbackHandlerMethods,\n HandleLLMNewTokenCallbackFields,\n isBaseCallbackHandler,\n NewTokenIndices,\n} from \"./base.js\";\nimport { ConsoleCallbackHandler } from \"../tracers/console.js\";\nimport { type BaseMessage } from \"../messages/base.js\";\nimport { getBufferString } from \"../messages/utils.js\";\nimport { getEnvironmentVariable } from \"../utils/env.js\";\nimport { LangChainTracer } from \"../tracers/tracer_langchain.js\";\nimport { consumeCallback } from \"./promises.js\";\nimport { Serialized } from \"../load/serializable.js\";\nimport type { DocumentInterface } from \"../documents/document.js\";\nimport { isTracingEnabled } from \"../utils/callbacks.js\";\nimport { isBaseTracer } from \"../tracers/base.js\";\nimport {\n getContextVariable,\n _getConfigureHooks,\n} from \"../singletons/async_local_storage/context.js\";\n\ntype BaseCallbackManagerMethods = {\n [K in keyof CallbackHandlerMethods]?: (\n ...args: Parameters<Required<CallbackHandlerMethods>[K]>\n ) => Promise<unknown>;\n};\n\nexport interface CallbackManagerOptions {\n verbose?: boolean;\n tracing?: boolean;\n}\n\nexport type Callbacks =\n | CallbackManager\n | (BaseCallbackHandler | CallbackHandlerMethods)[];\n\nexport interface BaseCallbackConfig {\n /**\n * Name for the tracer run for this call. Defaults to the name of the class.\n */\n runName?: string;\n\n /**\n * Tags for this call and any sub-calls (eg. a Chain calling an LLM).\n * You can use these to filter calls.\n */\n tags?: string[];\n\n /**\n * Metadata for this call and any sub-calls (eg. a Chain calling an LLM).\n * Keys should be strings, values should be JSON-serializable.\n */\n metadata?: Record<string, unknown>;\n\n /**\n * Callbacks for this call and any sub-calls (eg. a Chain calling an LLM).\n * Tags are passed to all callbacks, metadata is passed to handle*Start callbacks.\n */\n callbacks?: Callbacks;\n\n /**\n * Unique identifier for the tracer run for this call. If not provided, a new UUID\n * will be generated.\n */\n runId?: string;\n}\n\nexport function parseCallbackConfigArg(\n arg: Callbacks | BaseCallbackConfig | undefined\n): BaseCallbackConfig {\n if (!arg) {\n return {};\n } else if (Array.isArray(arg) || \"name\" in arg) {\n return { callbacks: arg };\n } else {\n return arg;\n }\n}\n\n/**\n * Manage callbacks from different components of LangChain.\n */\nexport abstract class BaseCallbackManager {\n abstract addHandler(handler: BaseCallbackHandler): void;\n\n abstract removeHandler(handler: BaseCallbackHandler): void;\n\n abstract setHandlers(handlers: BaseCallbackHandler[]): void;\n\n setHandler(handler: BaseCallbackHandler): void {\n return this.setHandlers([handler]);\n }\n}\n\n/**\n * Base class for run manager in LangChain.\n */\nexport class BaseRunManager {\n constructor(\n public readonly runId: string,\n public readonly handlers: BaseCallbackHandler[],\n protected readonly inheritableHandlers: BaseCallbackHandler[],\n protected readonly tags: string[],\n protected readonly inheritableTags: string[],\n protected readonly metadata: Record<string, unknown>,\n protected readonly inheritableMetadata: Record<string, unknown>,\n protected readonly _parentRunId?: string\n ) {}\n\n get parentRunId() {\n return this._parentRunId;\n }\n\n async handleText(text: string): Promise<void> {\n await Promise.all(\n this.handlers.map((handler) =>\n consumeCallback(async () => {\n try {\n await handler.handleText?.(\n text,\n this.runId,\n this._parentRunId,\n this.tags\n );\n } catch (err) {\n const logFunction = handler.raiseError\n ? console.error\n : console.warn;\n logFunction(\n `Error in handler ${handler.constructor.name}, handleText: ${err}`\n );\n if (handler.raiseError) {\n throw err;\n }\n }\n }, handler.awaitHandlers)\n )\n );\n }\n\n async handleCustomEvent(\n eventName: string,\n // oxlint-disable-next-line @typescript-eslint/no-explicit-any\n data: any,\n _runId?: string,\n _tags?: string[],\n // oxlint-disable-next-line @typescript-eslint/no-explicit-any\n _metadata?: Record<string, any>\n ): Promise<void> {\n await Promise.all(\n this.handlers.map((handler) =>\n consumeCallback(async () => {\n try {\n await handler.handleCustomEvent?.(\n eventName,\n data,\n this.runId,\n this.tags,\n this.metadata\n );\n } catch (err) {\n const logFunction = handler.raiseError\n ? console.error\n : console.warn;\n logFunction(\n `Error in handler ${handler.constructor.name}, handleCustomEvent: ${err}`\n );\n if (handler.raiseError) {\n throw err;\n }\n }\n }, handler.awaitHandlers)\n )\n );\n }\n}\n\n/**\n * Manages callbacks for retriever runs.\n */\nexport class CallbackManagerForRetrieverRun\n extends BaseRunManager\n implements BaseCallbackManagerMethods\n{\n getChild(tag?: string): CallbackManager {\n // oxlint-disable-next-line @typescript-eslint/no-use-before-define\n const manager = new CallbackManager(this.runId);\n manager.setHandlers(this.inheritableHandlers);\n manager.addTags(this.inheritableTags);\n manager.addMetadata(this.inheritableMetadata);\n if (tag) {\n manager.addTags([tag], false);\n }\n return manager;\n }\n\n async handleRetrieverEnd(documents: DocumentInterface[]): Promise<void> {\n await Promise.all(\n this.handlers.map((handler) =>\n consumeCallback(async () => {\n if (!handler.ignoreRetriever) {\n try {\n await handler.handleRetrieverEnd?.(\n documents,\n this.runId,\n this._parentRunId,\n this.tags\n );\n } catch (err) {\n const logFunction = handler.raiseError\n ? console.error\n : console.warn;\n logFunction(\n `Error in handler ${handler.constructor.name}, handleRetriever`\n );\n if (handler.raiseError) {\n throw err;\n }\n }\n }\n }, handler.awaitHandlers)\n )\n );\n }\n\n async handleRetrieverError(err: Error | unknown): Promise<void> {\n await Promise.all(\n this.handlers.map((handler) =>\n consumeCallback(async () => {\n if (!handler.ignoreRetriever) {\n try {\n await handler.handleRetrieverError?.(\n err,\n this.runId,\n this._parentRunId,\n this.tags\n );\n } catch (error) {\n const logFunction = handler.raiseError\n ? console.error\n : console.warn;\n logFunction(\n `Error in handler ${handler.constructor.name}, handleRetrieverError: ${error}`\n );\n if (handler.raiseError) {\n throw err;\n }\n }\n }\n }, handler.awaitHandlers)\n )\n );\n }\n}\n\nexport class CallbackManagerForLLMRun\n extends BaseRunManager\n implements BaseCallbackManagerMethods\n{\n async handleLLMNewToken(\n token: string,\n idx?: NewTokenIndices,\n _runId?: string,\n _parentRunId?: string,\n _tags?: string[],\n fields?: HandleLLMNewTokenCallbackFields\n ): Promise<void> {\n await Promise.all(\n this.handlers.map((handler) =>\n consumeCallback(async () => {\n if (!handler.ignoreLLM) {\n try {\n await handler.handleLLMNewToken?.(\n token,\n idx ?? { prompt: 0, completion: 0 },\n this.runId,\n this._parentRunId,\n this.tags,\n fields\n );\n } catch (err) {\n const logFunction = handler.raiseError\n ? console.error\n : console.warn;\n logFunction(\n `Error in handler ${handler.constructor.name}, handleLLMNewToken: ${err}`\n );\n if (handler.raiseError) {\n throw err;\n }\n }\n }\n }, handler.awaitHandlers)\n )\n );\n }\n\n async handleLLMError(\n err: Error | unknown,\n _runId?: string,\n _parentRunId?: string,\n _tags?: string[],\n extraParams?: Record<string, unknown>\n ): Promise<void> {\n await Promise.all(\n this.handlers.map((handler) =>\n consumeCallback(async () => {\n if (!handler.ignoreLLM) {\n try {\n await handler.handleLLMError?.(\n err,\n this.runId,\n this._parentRunId,\n this.tags,\n extraParams\n );\n } catch (err) {\n const logFunction = handler.raiseError\n ? console.error\n : console.warn;\n logFunction(\n `Error in handler ${handler.constructor.name}, handleLLMError: ${err}`\n );\n if (handler.raiseError) {\n throw err;\n }\n }\n }\n }, handler.awaitHandlers)\n )\n );\n }\n\n async handleLLMEnd(\n output: LLMResult,\n _runId?: string,\n _parentRunId?: string,\n _tags?: string[],\n extraParams?: Record<string, unknown>\n ): Promise<void> {\n await Promise.all(\n this.handlers.map((handler) =>\n consumeCallback(async () => {\n if (!handler.ignoreLLM) {\n try {\n await handler.handleLLMEnd?.(\n output,\n this.runId,\n this._parentRunId,\n this.tags,\n extraParams\n );\n } catch (err) {\n const logFunction = handler.raiseError\n ? console.error\n : console.warn;\n logFunction(\n `Error in handler ${handler.constructor.name}, handleLLMEnd: ${err}`\n );\n if (handler.raiseError) {\n throw err;\n }\n }\n }\n }, handler.awaitHandlers)\n )\n );\n }\n}\n\nexport class CallbackManagerForChainRun\n extends BaseRunManager\n implements BaseCallbackManagerMethods\n{\n getChild(tag?: string): CallbackManager {\n // oxlint-disable-next-line @typescript-eslint/no-use-before-define\n const manager = new CallbackManager(this.runId);\n manager.setHandlers(this.inheritableHandlers);\n manager.addTags(this.inheritableTags);\n manager.addMetadata(this.inheritableMetadata);\n if (tag) {\n manager.addTags([tag], false);\n }\n return manager;\n }\n\n async handleChainError(\n err: Error | unknown,\n _runId?: string,\n _parentRunId?: string,\n _tags?: string[],\n kwargs?: { inputs?: Record<string, unknown> }\n ): Promise<void> {\n await Promise.all(\n this.handlers.map((handler) =>\n consumeCallback(async () => {\n if (!handler.ignoreChain) {\n try {\n await handler.handleChainError?.(\n err,\n this.runId,\n this._parentRunId,\n this.tags,\n kwargs\n );\n } catch (err) {\n const logFunction = handler.raiseError\n ? console.error\n : console.warn;\n logFunction(\n `Error in handler ${handler.constructor.name}, handleChainError: ${err}`\n );\n if (handler.raiseError) {\n throw err;\n }\n }\n }\n }, handler.awaitHandlers)\n )\n );\n }\n\n async handleChainEnd(\n output: ChainValues,\n _runId?: string,\n _parentRunId?: string,\n _tags?: string[],\n kwargs?: { inputs?: Record<string, unknown> }\n ): Promise<void> {\n await Promise.all(\n this.handlers.map((handler) =>\n consumeCallback(async () => {\n if (!handler.ignoreChain) {\n try {\n await handler.handleChainEnd?.(\n output,\n this.runId,\n this._parentRunId,\n this.tags,\n kwargs\n );\n } catch (err) {\n const logFunction = handler.raiseError\n ? console.error\n : console.warn;\n logFunction(\n `Error in handler ${handler.constructor.name}, handleChainEnd: ${err}`\n );\n if (handler.raiseError) {\n throw err;\n }\n }\n }\n }, handler.awaitHandlers)\n )\n );\n }\n\n async handleAgentAction(action: AgentAction): Promise<void> {\n await Promise.all(\n this.handlers.map((handler) =>\n consumeCallback(async () => {\n if (!handler.ignoreAgent) {\n try {\n await handler.handleAgentAction?.(\n action,\n this.runId,\n this._parentRunId,\n this.tags\n );\n } catch (err) {\n const logFunction = handler.raiseError\n ? console.error\n : console.warn;\n logFunction(\n `Error in handler ${handler.constructor.name}, handleAgentAction: ${err}`\n );\n if (handler.raiseError) {\n throw err;\n }\n }\n }\n }, handler.awaitHandlers)\n )\n );\n }\n\n async handleAgentEnd(action: AgentFinish): Promise<void> {\n await Promise.all(\n this.handlers.map((handler) =>\n consumeCallback(async () => {\n if (!handler.ignoreAgent) {\n try {\n await handler.handleAgentEnd?.(\n action,\n this.runId,\n this._parentRunId,\n this.tags\n );\n } catch (err) {\n const logFunction = handler.raiseError\n ? console.error\n : console.warn;\n logFunction(\n `Error in handler ${handler.constructor.name}, handleAgentEnd: ${err}`\n );\n if (handler.raiseError) {\n throw err;\n }\n }\n }\n }, handler.awaitHandlers)\n )\n );\n }\n}\n\nexport class CallbackManagerForToolRun\n extends BaseRunManager\n implements BaseCallbackManagerMethods\n{\n getChild(tag?: string): CallbackManager {\n // oxlint-disable-next-line @typescript-eslint/no-use-before-define\n const manager = new CallbackManager(this.runId);\n manager.setHandlers(this.inheritableHandlers);\n manager.addTags(this.inheritableTags);\n manager.addMetadata(this.inheritableMetadata);\n if (tag) {\n manager.addTags([tag], false);\n }\n return manager;\n }\n\n async handleToolError(err: Error | unknown): Promise<void> {\n await Promise.all(\n this.handlers.map((handler) =>\n consumeCallback(async () => {\n if (!handler.ignoreAgent) {\n try {\n await handler.handleToolError?.(\n err,\n this.runId,\n this._parentRunId,\n this.tags\n );\n } catch (err) {\n const logFunction = handler.raiseError\n ? console.error\n : console.warn;\n logFunction(\n `Error in handler ${handler.constructor.name}, handleToolError: ${err}`\n );\n if (handler.raiseError) {\n throw err;\n }\n }\n }\n }, handler.awaitHandlers)\n )\n );\n }\n\n async handleToolEvent(chunk: unknown): Promise<void> {\n await Promise.all(\n this.handlers.map((handler) =>\n consumeCallback(async () => {\n if (!handler.ignoreAgent) {\n try {\n await handler.handleToolEvent?.(\n chunk,\n this.runId,\n this._parentRunId,\n this.tags\n );\n } catch (err) {\n if (handler.raiseError) throw err;\n }\n }\n }, handler.awaitHandlers)\n )\n );\n }\n\n // oxlint-disable-next-line @typescript-eslint/no-explicit-any\n async handleToolEnd(output: any): Promise<void> {\n await Promise.all(\n this.handlers.map((handler) =>\n consumeCallback(async () => {\n if (!handler.ignoreAgent) {\n try {\n await handler.handleToolEnd?.(\n output,\n this.runId,\n this._parentRunId,\n this.tags\n );\n } catch (err) {\n const logFunction = handler.raiseError\n ? console.error\n : console.warn;\n logFunction(\n `Error in handler ${handler.constructor.name}, handleToolEnd: ${err}`\n );\n if (handler.raiseError) {\n throw err;\n }\n }\n }\n }, handler.awaitHandlers)\n )\n );\n }\n}\n\n/**\n * @example\n * ```typescript\n * const prompt = PromptTemplate.fromTemplate(\"What is the answer to {question}?\");\n *\n * // Example of using LLMChain with OpenAI and a simple prompt\n * const chain = new LLMChain({\n * llm: new ChatOpenAI({ model: \"gpt-4o-mini\", temperature: 0.9 }),\n * prompt,\n * });\n *\n * // Running the chain with a single question\n * const result = await chain.call({\n * question: \"What is the airspeed velocity of an unladen swallow?\",\n * });\n * console.log(\"The answer is:\", result);\n * ```\n */\nexport class CallbackManager\n extends BaseCallbackManager\n implements BaseCallbackManagerMethods\n{\n handlers: BaseCallbackHandler[] = [];\n\n inheritableHandlers: BaseCallbackHandler[] = [];\n\n tags: string[] = [];\n\n inheritableTags: string[] = [];\n\n metadata: Record<string, unknown> = {};\n\n inheritableMetadata: Record<string, unknown> = {};\n\n name = \"callback_manager\";\n\n public _parentRunId?: string;\n\n constructor(\n parentRunId?: string,\n options?: {\n handlers?: BaseCallbackHandler[];\n inheritableHandlers?: BaseCallbackHandler[];\n tags?: string[];\n inheritableTags?: string[];\n metadata?: Record<string, unknown>;\n inheritableMetadata?: Record<string, unknown>;\n }\n ) {\n super();\n this.handlers = options?.handlers ?? this.handlers;\n this.inheritableHandlers =\n options?.inheritableHandlers ?? this.inheritableHandlers;\n this.tags = options?.tags ?? this.tags;\n this.inheritableTags = options?.inheritableTags ?? this.inheritableTags;\n this.metadata = options?.metadata ?? this.metadata;\n this.inheritableMetadata =\n options?.inheritableMetadata ?? this.inheritableMetadata;\n this._parentRunId = parentRunId;\n }\n\n /**\n * Gets the parent run ID, if any.\n *\n * @returns The parent run ID.\n */\n getParentRunId() {\n return this._parentRunId;\n }\n\n async handleLLMStart(\n llm: Serialized,\n prompts: string[],\n runId: string | undefined = undefined,\n _parentRunId: string | undefined = undefined,\n extraParams: Record<string, unknown> | undefined = undefined,\n _tags: string[] | undefined = undefined,\n _metadata: Record<string, unknown> | undefined = undefined,\n runName: string | undefined = undefined\n ): Promise<CallbackManagerForLLMRun[]> {\n return Promise.all(\n prompts.map(async (prompt, idx) => {\n // Can't have duplicate runs with the same run ID (if provided)\n const runId_ = idx === 0 && runId ? runId : uuidv7();\n\n await Promise.all(\n this.handlers.map((handler) => {\n if (handler.ignoreLLM) {\n return;\n }\n if (isBaseTracer(handler)) {\n // Create and add run to the run map.\n // We do this synchronously to avoid race conditions\n // when callbacks are backgrounded.\n handler._createRunForLLMStart(\n llm,\n [prompt],\n runId_,\n this._parentRunId,\n extraParams,\n this.tags,\n this.metadata,\n runName\n );\n }\n return consumeCallback(async () => {\n try {\n await handler.handleLLMStart?.(\n llm,\n [prompt],\n runId_,\n this._parentRunId,\n extraParams,\n this.tags,\n this.metadata,\n runName\n );\n } catch (err) {\n const logFunction = handler.raiseError\n ? console.error\n : console.warn;\n logFunction(\n `Error in handler ${handler.constructor.name}, handleLLMStart: ${err}`\n );\n if (handler.raiseError) {\n throw err;\n }\n }\n }, handler.awaitHandlers);\n })\n );\n\n return new CallbackManagerForLLMRun(\n runId_,\n this.handlers,\n this.inheritableHandlers,\n this.tags,\n this.inheritableTags,\n this.metadata,\n this.inheritableMetadata,\n this._parentRunId\n );\n })\n );\n }\n\n async handleChatModelStart(\n llm: Serialized,\n messages: BaseMessage[][],\n runId: string | undefined = undefined,\n _parentRunId: string | undefined = undefined,\n extraParams: Record<string, unknown> | undefined = undefined,\n _tags: string[] | undefined = undefined,\n _metadata: Record<string, unknown> | undefined = undefined,\n runName: string | undefined = undefined\n ): Promise<CallbackManagerForLLMRun[]> {\n return Promise.all(\n messages.map(async (messageGroup, idx) => {\n // Can't have duplicate runs with the same run ID (if provided)\n const runId_ = idx === 0 && runId ? runId : uuidv7();\n\n await Promise.all(\n this.handlers.map((handler) => {\n if (handler.ignoreLLM) {\n return;\n }\n if (isBaseTracer(handler)) {\n // Create and add run to the run map.\n // We do this synchronously to avoid race conditions\n // when callbacks are backgrounded.\n handler._createRunForChatModelStart(\n llm,\n [messageGroup],\n runId_,\n this._parentRunId,\n extraParams,\n this.tags,\n this.metadata,\n runName\n );\n }\n return consumeCallback(async () => {\n try {\n if (handler.handleChatModelStart) {\n await handler.handleChatModelStart?.(\n llm,\n [messageGroup],\n runId_,\n this._parentRunId,\n extraParams,\n this.tags,\n this.metadata,\n runName\n );\n } else if (handler.handleLLMStart) {\n const messageString = getBufferString(messageGroup);\n await handler.handleLLMStart?.(\n llm,\n [messageString],\n runId_,\n this._parentRunId,\n extraParams,\n this.tags,\n this.metadata,\n runName\n );\n }\n } catch (err) {\n const logFunction = handler.raiseError\n ? console.error\n : console.warn;\n logFunction(\n `Error in handler ${handler.constructor.name}, handleLLMStart: ${err}`\n );\n if (handler.raiseError) {\n throw err;\n }\n }\n }, handler.awaitHandlers);\n })\n );\n\n return new CallbackManagerForLLMRun(\n runId_,\n this.handlers,\n this.inheritableHandlers,\n this.tags,\n this.inheritableTags,\n this.metadata,\n this.inheritableMetadata,\n this._parentRunId\n );\n })\n );\n }\n\n async handleChainStart(\n chain: Serialized,\n inputs: ChainValues,\n runId = uuidv7(),\n runType: string | undefined = undefined,\n _tags: string[] | undefined = undefined,\n _metadata: Record<string, unknown> | undefined = undefined,\n runName: string | undefined = undefined,\n _parentRunId: string | undefined = undefined,\n extra: Record<string, unknown> | undefined = undefined\n ): Promise<CallbackManagerForChainRun> {\n await Promise.all(\n this.handlers.map((handler) => {\n if (handler.ignoreChain) {\n return;\n }\n if (isBaseTracer(handler)) {\n // Create and add run to the run map.\n // We do this synchronously to avoid race conditions\n // when callbacks are backgrounded.\n handler._createRunForChainStart(\n chain,\n inputs,\n runId,\n this._parentRunId,\n this.tags,\n this.metadata,\n runType,\n runName,\n extra\n );\n }\n return consumeCallback(async () => {\n try {\n await handler.handleChainStart?.(\n chain,\n inputs,\n runId,\n this._parentRunId,\n this.tags,\n this.metadata,\n runType,\n runName,\n extra\n );\n } catch (err) {\n const logFunction = handler.raiseError\n ? console.error\n : console.warn;\n logFunction(\n `Error in handler ${handler.constructor.name}, handleChainStart: ${err}`\n );\n if (handler.raiseError) {\n throw err;\n }\n }\n }, handler.awaitHandlers);\n })\n );\n return new CallbackManagerForChainRun(\n runId,\n this.handlers,\n this.inheritableHandlers,\n this.tags,\n this.inheritableTags,\n this.metadata,\n this.inheritableMetadata,\n this._parentRunId\n );\n }\n\n async handleToolStart(\n tool: Serialized,\n input: string,\n runId = uuidv7(),\n _parentRunId: string | undefined = undefined,\n _tags: string[] | undefined = undefined,\n _metadata: Record<string, unknown> | undefined = undefined,\n runName: string | undefined = undefined,\n toolCallId: string | undefined = undefined\n ): Promise<CallbackManagerForToolRun> {\n await Promise.all(\n this.handlers.map((handler) => {\n if (handler.ignoreAgent) {\n return;\n }\n if (isBaseTracer(handler)) {\n // Create and add run to the run map.\n // We do this synchronously to avoid race conditions\n // when callbacks are backgrounded.\n handler._createRunForToolStart(\n tool,\n input,\n runId,\n this._parentRunId,\n this.tags,\n this.metadata,\n runName\n );\n }\n return consumeCallback(async () => {\n try {\n await handler.handleToolStart?.(\n tool,\n input,\n runId,\n this._parentRunId,\n this.tags,\n this.metadata,\n runName,\n toolCallId\n );\n } catch (err) {\n const logFunction = handler.raiseError\n ? console.error\n : console.warn;\n logFunction(\n `Error in handler ${handler.constructor.name}, handleToolStart: ${err}`\n );\n if (handler.raiseError) {\n throw err;\n }\n }\n }, handler.awaitHandlers);\n })\n );\n return new CallbackManagerForToolRun(\n runId,\n this.handlers,\n this.inheritableHandlers,\n this.tags,\n this.inheritableTags,\n this.metadata,\n this.inheritableMetadata,\n this._parentRunId\n );\n }\n\n async handleRetrieverStart(\n retriever: Serialized,\n query: string,\n runId: string = uuidv7(),\n _parentRunId: string | undefined = undefined,\n _tags: string[] | undefined = undefined,\n _metadata: Record<string, unknown> | undefined = undefined,\n runName: string | undefined = undefined\n ): Promise<CallbackManagerForRetrieverRun> {\n await Promise.all(\n this.handlers.map((handler) => {\n if (handler.ignoreRetriever) {\n return;\n }\n if (isBaseTracer(handler)) {\n // Create and add run to the run map.\n // We do this synchronously to avoid race conditions\n // when callbacks are backgrounded.\n handler._createRunForRetrieverStart(\n retriever,\n query,\n runId,\n this._parentRunId,\n this.tags,\n this.metadata,\n runName\n );\n }\n return consumeCallback(async () => {\n try {\n await handler.handleRetrieverStart?.(\n retriever,\n query,\n runId,\n this._parentRunId,\n this.tags,\n this.metadata,\n runName\n );\n } catch (err) {\n const logFunction = handler.raiseError\n ? console.error\n : console.warn;\n logFunction(\n `Error in handler ${handler.constructor.name}, handleRetrieverStart: ${err}`\n );\n if (handler.raiseError) {\n throw err;\n }\n }\n }, handler.awaitHandlers);\n })\n );\n return new CallbackManagerForRetrieverRun(\n runId,\n this.handlers,\n this.inheritableHandlers,\n this.tags,\n this.inheritableTags,\n this.metadata,\n this.inheritableMetadata,\n this._parentRunId\n );\n }\n\n async handleCustomEvent?(\n eventName: string,\n // oxlint-disable-next-line @typescript-eslint/no-explicit-any\n data: any,\n runId: string,\n _tags?: string[],\n // oxlint-disable-next-line @typescript-eslint/no-explicit-any\n _metadata?: Record<string, any>\n ): // oxlint-disable-next-line @typescript-eslint/no-explicit-any\n Promise<any> {\n await Promise.all(\n this.handlers.map((handler) =>\n consumeCallback(async () => {\n if (!handler.ignoreCustomEvent) {\n try {\n await handler.handleCustomEvent?.(\n eventName,\n data,\n runId,\n this.tags,\n this.metadata\n );\n } catch (err) {\n const logFunction = handler.raiseError\n ? console.error\n : console.warn;\n logFunction(\n `Error in handler ${handler.constructor.name}, handleCustomEvent: ${err}`\n );\n if (handler.raiseError) {\n throw err;\n }\n }\n }\n }, handler.awaitHandlers)\n )\n );\n }\n\n addHandler(handler: BaseCallbackHandler, inherit = true): void {\n this.handlers.push(handler);\n if (inherit) {\n this.inheritableHandlers.push(handler);\n }\n }\n\n removeHandler(handler: BaseCallbackHandler): void {\n this.handlers = this.handlers.filter((_handler) => _handler !== handler);\n this.inheritableHandlers = this.inheritableHandlers.filter(\n (_handler) => _handler !== handler\n );\n }\n\n setHandlers(handlers: BaseCallbackHandler[], inherit = true): void {\n this.handlers = [];\n this.inheritableHandlers = [];\n for (const handler of handlers) {\n this.addHandler(handler, inherit);\n }\n }\n\n addTags(tags: string[], inherit = true): void {\n this.removeTags(tags); // Remove duplicates\n this.tags.push(...tags);\n if (inherit) {\n this.inheritableTags.push(...tags);\n }\n }\n\n removeTags(tags: string[]): void {\n this.tags = this.tags.filter((tag) => !tags.includes(tag));\n this.inheritableTags = this.inheritableTags.filter(\n (tag) => !tags.includes(tag)\n );\n }\n\n addMetadata(metadata: Record<string, unknown>, inherit = true): void {\n this.metadata = { ...this.metadata, ...metadata };\n if (inherit) {\n this.inheritableMetadata = { ...this.inheritableMetadata, ...metadata };\n }\n }\n\n removeMetadata(metadata: Record<string, unknown>): void {\n for (const key of Object.keys(metadata)) {\n delete this.metadata[key];\n delete this.inheritableMetadata[key];\n }\n }\n\n copy(\n additionalHandlers: BaseCallbackHandler[] = [],\n inherit = true\n ): CallbackManager {\n const manager = new CallbackManager(this._parentRunId);\n for (const handler of this.handlers) {\n const inheritable = this.inheritableHandlers.includes(handler);\n manager.addHandler(handler, inheritable);\n }\n for (const tag of this.tags) {\n const inheritable = this.inheritableTags.includes(tag);\n manager.addTags([tag], inheritable);\n }\n for (const key of Object.keys(this.metadata)) {\n const inheritable = Object.keys(this.inheritableMetadata).includes(key);\n manager.addMetadata({ [key]: this.metadata[key] }, inheritable);\n }\n for (const handler of additionalHandlers) {\n if (\n // Prevent multiple copies of console_callback_handler\n manager.handlers\n .filter((h) => h.name === \"console_callback_handler\")\n .some((h) => h.name === handler.name)\n ) {\n continue;\n }\n manager.addHandler(handler, inherit);\n }\n return manager;\n }\n\n static fromHandlers(handlers: CallbackHandlerMethods) {\n class Handler extends BaseCallbackHandler {\n name = uuidv7();\n\n constructor() {\n super();\n Object.assign(this, handlers);\n }\n }\n\n const manager = new this();\n manager.addHandler(new Handler());\n return manager;\n }\n\n static configure(\n inheritableHandlers?: Callbacks,\n localHandlers?: Callbacks,\n inheritableTags?: string[],\n localTags?: string[],\n inheritableMetadata?: Record<string, unknown>,\n localMetadata?: Record<string, unknown>,\n options?: CallbackManagerOptions\n ): CallbackManager | undefined {\n return this._configureSync(\n inheritableHandlers,\n localHandlers,\n inheritableTags,\n localTags,\n inheritableMetadata,\n localMetadata,\n options\n );\n }\n\n // TODO: Deprecate async method in favor of this one.\n static _configureSync(\n inheritableHandlers?: Callbacks,\n localHandlers?: Callbacks,\n inheritableTags?: string[],\n localTags?: string[],\n inheritableMetadata?: Record<string, unknown>,\n localMetadata?: Record<string, unknown>,\n options?: CallbackManagerOptions\n ) {\n let callbackManager: CallbackManager | undefined;\n if (inheritableHandlers || localHandlers) {\n if (Array.isArray(inheritableHandlers) || !inheritableHandlers) {\n callbackManager = new CallbackManager();\n callbackManager.setHandlers(\n inheritableHandlers?.map(ensureHandler) ?? [],\n true\n );\n } else {\n callbackManager = inheritableHandlers;\n }\n\n callbackManager = callbackManager.copy(\n Array.isArray(localHandlers)\n ? localHandlers.map(ensureHandler)\n : localHandlers?.handlers,\n false\n );\n }\n\n const verboseEnabled =\n getEnvironmentVariable(\"LANGCHAIN_VERBOSE\") === \"true\" ||\n options?.verbose;\n\n const traceableRunTree = LangChainTracer.getTraceableRunTree();\n const tracingV2Enabled =\n traceableRunTree?.tracingEnabled ?? isTracingEnabled();\n\n // If tracing is explicitly disabled by the RunTree (e.g. via\n // traceable({ tracingEnabled: false })), remove any inherited\n // LangChainTracer handlers so that child runs don't trace either.\n if (traceableRunTree?.tracingEnabled === false && callbackManager) {\n const inheritedTracers = callbackManager.handlers.filter(\n (handler) => handler.name === \"langchain_tracer\"\n );\n for (const tracer of inheritedTracers) {\n callbackManager.removeHandler(tracer);\n }\n }\n\n const tracingEnabled =\n tracingV2Enabled ||\n (getEnvironmentVariable(\"LANGCHAIN_TRACING\") ?? false);\n if (verboseEnabled || tracingEnabled) {\n if (!callbackManager) {\n callbackManager = new CallbackManager();\n }\n if (\n verboseEnabled &&\n !callbackManager.handlers.some(\n (handler) => handler.name === ConsoleCallbackHandler.prototype.name\n )\n ) {\n const consoleHandler = new ConsoleCallbackHandler();\n callbackManager.addHandler(consoleHandler, true);\n }\n if (\n tracingEnabled &&\n !callbackManager.handlers.some(\n (handler) => handler.name === \"langchain_tracer\"\n )\n ) {\n if (tracingV2Enabled) {\n const tracerV2 = new LangChainTracer();\n callbackManager.addHandler(tracerV2, true);\n }\n }\n if (tracingV2Enabled) {\n // handoff between langchain and langsmith/traceable\n // override the parent run ID\n if (traceableRunTree && callbackManager._parentRunId === undefined) {\n callbackManager._parentRunId = traceableRunTree.id;\n const tracerV2 = callbackManager.handlers.find(\n (handler) => handler.name === \"langchain_tracer\"\n ) as LangChainTracer | undefined;\n tracerV2?.updateFromRunTree(traceableRunTree);\n }\n }\n }\n\n for (const {\n contextVar,\n inheritable = true,\n handlerClass,\n envVar,\n } of _getConfigureHooks()) {\n const createIfNotInContext =\n envVar && getEnvironmentVariable(envVar) === \"true\" && handlerClass;\n let handler: BaseCallbackHandler | undefined;\n const contextVarValue =\n contextVar !== undefined ? getContextVariable(contextVar) : undefined;\n if (contextVarValue && isBaseCallbackHandler(contextVarValue)) {\n handler = contextVarValue;\n } else if (createIfNotInContext) {\n // oxlint-disable-next-line @typescript-eslint/no-explicit-any\n handler = new (handlerClass as any)({});\n }\n if (handler !== undefined) {\n if (!callbackManager) {\n callbackManager = new CallbackManager();\n }\n\n if (!callbackManager.handlers.some((h) => h.name === handler!.name)) {\n callbackManager.addHandler(handler, inheritable);\n }\n }\n }\n\n if (inheritableTags || localTags) {\n if (callbackManager) {\n callbackManager.addTags(inheritableTags ?? []);\n callbackManager.addTags(localTags ?? [], false);\n }\n }\n if (inheritableMetadata || localMetadata) {\n if (callbackManager) {\n callbackManager.addMetadata(inheritableMetadata ?? {});\n callbackManager.addMetadata(localMetadata ?? {}, false);\n }\n }\n\n return callbackManager;\n }\n}\n\nexport function ensureHandler(\n handler: BaseCallbackHandler | CallbackHandlerMethods\n): BaseCallbackHandler {\n if (\"name\" in handler) {\n return handler;\n }\n\n return BaseCallbackHandler.fromMethods(handler);\n}\n"],"mappings":"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"}
|
|
1
|
+
{"version":3,"file":"manager.js","names":["uuidv7"],"sources":["../../src/callbacks/manager.ts"],"sourcesContent":["import { v7 as uuidv7 } from \"uuid\";\nimport { AgentAction, AgentFinish } from \"../agents.js\";\nimport type { ChainValues } from \"../utils/types/index.js\";\nimport { LLMResult } from \"../outputs.js\";\nimport {\n BaseCallbackHandler,\n CallbackHandlerMethods,\n HandleLLMNewTokenCallbackFields,\n isBaseCallbackHandler,\n NewTokenIndices,\n} from \"./base.js\";\nimport { ConsoleCallbackHandler } from \"../tracers/console.js\";\nimport { type BaseMessage } from \"../messages/base.js\";\nimport { getBufferString } from \"../messages/utils.js\";\nimport { getEnvironmentVariable } from \"../utils/env.js\";\nimport { LangChainTracer } from \"../tracers/tracer_langchain.js\";\nimport { consumeCallback } from \"./promises.js\";\nimport { Serialized } from \"../load/serializable.js\";\nimport type { DocumentInterface } from \"../documents/document.js\";\nimport { isTracingEnabled } from \"../utils/callbacks.js\";\nimport { isBaseTracer } from \"../tracers/base.js\";\nimport {\n getContextVariable,\n _getConfigureHooks,\n} from \"../singletons/async_local_storage/context.js\";\n\ntype BaseCallbackManagerMethods = {\n [K in keyof CallbackHandlerMethods]?: (\n ...args: Parameters<Required<CallbackHandlerMethods>[K]>\n ) => Promise<unknown>;\n};\n\nexport interface CallbackManagerOptions {\n verbose?: boolean;\n tracing?: boolean;\n tracerInheritableMetadata?: Record<string, unknown>;\n tracerInheritableTags?: string[];\n}\n\nexport type Callbacks =\n | CallbackManager\n | (BaseCallbackHandler | CallbackHandlerMethods)[];\n\nexport interface BaseCallbackConfig {\n /**\n * Name for the tracer run for this call. Defaults to the name of the class.\n */\n runName?: string;\n\n /**\n * Tags for this call and any sub-calls (eg. a Chain calling an LLM).\n * You can use these to filter calls.\n */\n tags?: string[];\n\n /**\n * Metadata for this call and any sub-calls (eg. a Chain calling an LLM).\n * Keys should be strings, values should be JSON-serializable.\n */\n metadata?: Record<string, unknown>;\n\n /**\n * Callbacks for this call and any sub-calls (eg. a Chain calling an LLM).\n * Tags are passed to all callbacks, metadata is passed to handle*Start callbacks.\n */\n callbacks?: Callbacks;\n\n /**\n * Unique identifier for the tracer run for this call. If not provided, a new UUID\n * will be generated.\n */\n runId?: string;\n}\n\nexport function parseCallbackConfigArg(\n arg: Callbacks | BaseCallbackConfig | undefined\n): BaseCallbackConfig {\n if (!arg) {\n return {};\n } else if (Array.isArray(arg) || \"name\" in arg) {\n return { callbacks: arg };\n } else {\n return arg;\n }\n}\n\n/**\n * Manage callbacks from different components of LangChain.\n */\nexport abstract class BaseCallbackManager {\n abstract addHandler(handler: BaseCallbackHandler): void;\n\n abstract removeHandler(handler: BaseCallbackHandler): void;\n\n abstract setHandlers(handlers: BaseCallbackHandler[]): void;\n\n setHandler(handler: BaseCallbackHandler): void {\n return this.setHandlers([handler]);\n }\n}\n\n/**\n * Base class for run manager in LangChain.\n */\nexport class BaseRunManager {\n constructor(\n public readonly runId: string,\n public readonly handlers: BaseCallbackHandler[],\n protected readonly inheritableHandlers: BaseCallbackHandler[],\n protected readonly tags: string[],\n protected readonly inheritableTags: string[],\n protected readonly metadata: Record<string, unknown>,\n protected readonly inheritableMetadata: Record<string, unknown>,\n protected readonly _parentRunId?: string\n ) {}\n\n get parentRunId() {\n return this._parentRunId;\n }\n\n async handleText(text: string): Promise<void> {\n await Promise.all(\n this.handlers.map((handler) =>\n consumeCallback(async () => {\n try {\n await handler.handleText?.(\n text,\n this.runId,\n this._parentRunId,\n this.tags\n );\n } catch (err) {\n const logFunction = handler.raiseError\n ? console.error\n : console.warn;\n logFunction(\n `Error in handler ${handler.constructor.name}, handleText: ${err}`\n );\n if (handler.raiseError) {\n throw err;\n }\n }\n }, handler.awaitHandlers)\n )\n );\n }\n\n async handleCustomEvent(\n eventName: string,\n // oxlint-disable-next-line @typescript-eslint/no-explicit-any\n data: any,\n _runId?: string,\n _tags?: string[],\n // oxlint-disable-next-line @typescript-eslint/no-explicit-any\n _metadata?: Record<string, any>\n ): Promise<void> {\n await Promise.all(\n this.handlers.map((handler) =>\n consumeCallback(async () => {\n try {\n await handler.handleCustomEvent?.(\n eventName,\n data,\n this.runId,\n this.tags,\n this.metadata\n );\n } catch (err) {\n const logFunction = handler.raiseError\n ? console.error\n : console.warn;\n logFunction(\n `Error in handler ${handler.constructor.name}, handleCustomEvent: ${err}`\n );\n if (handler.raiseError) {\n throw err;\n }\n }\n }, handler.awaitHandlers)\n )\n );\n }\n}\n\n/**\n * Manages callbacks for retriever runs.\n */\nexport class CallbackManagerForRetrieverRun\n extends BaseRunManager\n implements BaseCallbackManagerMethods\n{\n getChild(tag?: string): CallbackManager {\n // oxlint-disable-next-line @typescript-eslint/no-use-before-define\n const manager = new CallbackManager(this.runId);\n manager.setHandlers(this.inheritableHandlers);\n manager.addTags(this.inheritableTags);\n manager.addMetadata(this.inheritableMetadata);\n if (tag) {\n manager.addTags([tag], false);\n }\n return manager;\n }\n\n async handleRetrieverEnd(documents: DocumentInterface[]): Promise<void> {\n await Promise.all(\n this.handlers.map((handler) =>\n consumeCallback(async () => {\n if (!handler.ignoreRetriever) {\n try {\n await handler.handleRetrieverEnd?.(\n documents,\n this.runId,\n this._parentRunId,\n this.tags\n );\n } catch (err) {\n const logFunction = handler.raiseError\n ? console.error\n : console.warn;\n logFunction(\n `Error in handler ${handler.constructor.name}, handleRetriever`\n );\n if (handler.raiseError) {\n throw err;\n }\n }\n }\n }, handler.awaitHandlers)\n )\n );\n }\n\n async handleRetrieverError(err: Error | unknown): Promise<void> {\n await Promise.all(\n this.handlers.map((handler) =>\n consumeCallback(async () => {\n if (!handler.ignoreRetriever) {\n try {\n await handler.handleRetrieverError?.(\n err,\n this.runId,\n this._parentRunId,\n this.tags\n );\n } catch (error) {\n const logFunction = handler.raiseError\n ? console.error\n : console.warn;\n logFunction(\n `Error in handler ${handler.constructor.name}, handleRetrieverError: ${error}`\n );\n if (handler.raiseError) {\n throw err;\n }\n }\n }\n }, handler.awaitHandlers)\n )\n );\n }\n}\n\nexport class CallbackManagerForLLMRun\n extends BaseRunManager\n implements BaseCallbackManagerMethods\n{\n async handleLLMNewToken(\n token: string,\n idx?: NewTokenIndices,\n _runId?: string,\n _parentRunId?: string,\n _tags?: string[],\n fields?: HandleLLMNewTokenCallbackFields\n ): Promise<void> {\n await Promise.all(\n this.handlers.map((handler) =>\n consumeCallback(async () => {\n if (!handler.ignoreLLM) {\n try {\n await handler.handleLLMNewToken?.(\n token,\n idx ?? { prompt: 0, completion: 0 },\n this.runId,\n this._parentRunId,\n this.tags,\n fields\n );\n } catch (err) {\n const logFunction = handler.raiseError\n ? console.error\n : console.warn;\n logFunction(\n `Error in handler ${handler.constructor.name}, handleLLMNewToken: ${err}`\n );\n if (handler.raiseError) {\n throw err;\n }\n }\n }\n }, handler.awaitHandlers)\n )\n );\n }\n\n async handleLLMError(\n err: Error | unknown,\n _runId?: string,\n _parentRunId?: string,\n _tags?: string[],\n extraParams?: Record<string, unknown>\n ): Promise<void> {\n await Promise.all(\n this.handlers.map((handler) =>\n consumeCallback(async () => {\n if (!handler.ignoreLLM) {\n try {\n await handler.handleLLMError?.(\n err,\n this.runId,\n this._parentRunId,\n this.tags,\n extraParams\n );\n } catch (err) {\n const logFunction = handler.raiseError\n ? console.error\n : console.warn;\n logFunction(\n `Error in handler ${handler.constructor.name}, handleLLMError: ${err}`\n );\n if (handler.raiseError) {\n throw err;\n }\n }\n }\n }, handler.awaitHandlers)\n )\n );\n }\n\n async handleLLMEnd(\n output: LLMResult,\n _runId?: string,\n _parentRunId?: string,\n _tags?: string[],\n extraParams?: Record<string, unknown>\n ): Promise<void> {\n await Promise.all(\n this.handlers.map((handler) =>\n consumeCallback(async () => {\n if (!handler.ignoreLLM) {\n try {\n await handler.handleLLMEnd?.(\n output,\n this.runId,\n this._parentRunId,\n this.tags,\n extraParams\n );\n } catch (err) {\n const logFunction = handler.raiseError\n ? console.error\n : console.warn;\n logFunction(\n `Error in handler ${handler.constructor.name}, handleLLMEnd: ${err}`\n );\n if (handler.raiseError) {\n throw err;\n }\n }\n }\n }, handler.awaitHandlers)\n )\n );\n }\n}\n\nexport class CallbackManagerForChainRun\n extends BaseRunManager\n implements BaseCallbackManagerMethods\n{\n getChild(tag?: string): CallbackManager {\n // oxlint-disable-next-line @typescript-eslint/no-use-before-define\n const manager = new CallbackManager(this.runId);\n manager.setHandlers(this.inheritableHandlers);\n manager.addTags(this.inheritableTags);\n manager.addMetadata(this.inheritableMetadata);\n if (tag) {\n manager.addTags([tag], false);\n }\n return manager;\n }\n\n async handleChainError(\n err: Error | unknown,\n _runId?: string,\n _parentRunId?: string,\n _tags?: string[],\n kwargs?: { inputs?: Record<string, unknown> }\n ): Promise<void> {\n await Promise.all(\n this.handlers.map((handler) =>\n consumeCallback(async () => {\n if (!handler.ignoreChain) {\n try {\n await handler.handleChainError?.(\n err,\n this.runId,\n this._parentRunId,\n this.tags,\n kwargs\n );\n } catch (err) {\n const logFunction = handler.raiseError\n ? console.error\n : console.warn;\n logFunction(\n `Error in handler ${handler.constructor.name}, handleChainError: ${err}`\n );\n if (handler.raiseError) {\n throw err;\n }\n }\n }\n }, handler.awaitHandlers)\n )\n );\n }\n\n async handleChainEnd(\n output: ChainValues,\n _runId?: string,\n _parentRunId?: string,\n _tags?: string[],\n kwargs?: { inputs?: Record<string, unknown> }\n ): Promise<void> {\n await Promise.all(\n this.handlers.map((handler) =>\n consumeCallback(async () => {\n if (!handler.ignoreChain) {\n try {\n await handler.handleChainEnd?.(\n output,\n this.runId,\n this._parentRunId,\n this.tags,\n kwargs\n );\n } catch (err) {\n const logFunction = handler.raiseError\n ? console.error\n : console.warn;\n logFunction(\n `Error in handler ${handler.constructor.name}, handleChainEnd: ${err}`\n );\n if (handler.raiseError) {\n throw err;\n }\n }\n }\n }, handler.awaitHandlers)\n )\n );\n }\n\n async handleAgentAction(action: AgentAction): Promise<void> {\n await Promise.all(\n this.handlers.map((handler) =>\n consumeCallback(async () => {\n if (!handler.ignoreAgent) {\n try {\n await handler.handleAgentAction?.(\n action,\n this.runId,\n this._parentRunId,\n this.tags\n );\n } catch (err) {\n const logFunction = handler.raiseError\n ? console.error\n : console.warn;\n logFunction(\n `Error in handler ${handler.constructor.name}, handleAgentAction: ${err}`\n );\n if (handler.raiseError) {\n throw err;\n }\n }\n }\n }, handler.awaitHandlers)\n )\n );\n }\n\n async handleAgentEnd(action: AgentFinish): Promise<void> {\n await Promise.all(\n this.handlers.map((handler) =>\n consumeCallback(async () => {\n if (!handler.ignoreAgent) {\n try {\n await handler.handleAgentEnd?.(\n action,\n this.runId,\n this._parentRunId,\n this.tags\n );\n } catch (err) {\n const logFunction = handler.raiseError\n ? console.error\n : console.warn;\n logFunction(\n `Error in handler ${handler.constructor.name}, handleAgentEnd: ${err}`\n );\n if (handler.raiseError) {\n throw err;\n }\n }\n }\n }, handler.awaitHandlers)\n )\n );\n }\n}\n\nexport class CallbackManagerForToolRun\n extends BaseRunManager\n implements BaseCallbackManagerMethods\n{\n getChild(tag?: string): CallbackManager {\n // oxlint-disable-next-line @typescript-eslint/no-use-before-define\n const manager = new CallbackManager(this.runId);\n manager.setHandlers(this.inheritableHandlers);\n manager.addTags(this.inheritableTags);\n manager.addMetadata(this.inheritableMetadata);\n if (tag) {\n manager.addTags([tag], false);\n }\n return manager;\n }\n\n async handleToolError(err: Error | unknown): Promise<void> {\n await Promise.all(\n this.handlers.map((handler) =>\n consumeCallback(async () => {\n if (!handler.ignoreAgent) {\n try {\n await handler.handleToolError?.(\n err,\n this.runId,\n this._parentRunId,\n this.tags\n );\n } catch (err) {\n const logFunction = handler.raiseError\n ? console.error\n : console.warn;\n logFunction(\n `Error in handler ${handler.constructor.name}, handleToolError: ${err}`\n );\n if (handler.raiseError) {\n throw err;\n }\n }\n }\n }, handler.awaitHandlers)\n )\n );\n }\n\n async handleToolEvent(chunk: unknown): Promise<void> {\n await Promise.all(\n this.handlers.map((handler) =>\n consumeCallback(async () => {\n if (!handler.ignoreAgent) {\n try {\n await handler.handleToolEvent?.(\n chunk,\n this.runId,\n this._parentRunId,\n this.tags\n );\n } catch (err) {\n if (handler.raiseError) throw err;\n }\n }\n }, handler.awaitHandlers)\n )\n );\n }\n\n // oxlint-disable-next-line @typescript-eslint/no-explicit-any\n async handleToolEnd(output: any): Promise<void> {\n await Promise.all(\n this.handlers.map((handler) =>\n consumeCallback(async () => {\n if (!handler.ignoreAgent) {\n try {\n await handler.handleToolEnd?.(\n output,\n this.runId,\n this._parentRunId,\n this.tags\n );\n } catch (err) {\n const logFunction = handler.raiseError\n ? console.error\n : console.warn;\n logFunction(\n `Error in handler ${handler.constructor.name}, handleToolEnd: ${err}`\n );\n if (handler.raiseError) {\n throw err;\n }\n }\n }\n }, handler.awaitHandlers)\n )\n );\n }\n}\n\n/**\n * @example\n * ```typescript\n * const prompt = PromptTemplate.fromTemplate(\"What is the answer to {question}?\");\n *\n * // Example of using LLMChain with OpenAI and a simple prompt\n * const chain = new LLMChain({\n * llm: new ChatOpenAI({ model: \"gpt-4o-mini\", temperature: 0.9 }),\n * prompt,\n * });\n *\n * // Running the chain with a single question\n * const result = await chain.call({\n * question: \"What is the airspeed velocity of an unladen swallow?\",\n * });\n * console.log(\"The answer is:\", result);\n * ```\n */\nexport class CallbackManager\n extends BaseCallbackManager\n implements BaseCallbackManagerMethods\n{\n handlers: BaseCallbackHandler[] = [];\n\n inheritableHandlers: BaseCallbackHandler[] = [];\n\n tags: string[] = [];\n\n inheritableTags: string[] = [];\n\n metadata: Record<string, unknown> = {};\n\n inheritableMetadata: Record<string, unknown> = {};\n\n name = \"callback_manager\";\n\n public _parentRunId?: string;\n\n constructor(\n parentRunId?: string,\n options?: {\n handlers?: BaseCallbackHandler[];\n inheritableHandlers?: BaseCallbackHandler[];\n tags?: string[];\n inheritableTags?: string[];\n metadata?: Record<string, unknown>;\n inheritableMetadata?: Record<string, unknown>;\n }\n ) {\n super();\n this.handlers = options?.handlers ?? this.handlers;\n this.inheritableHandlers =\n options?.inheritableHandlers ?? this.inheritableHandlers;\n this.tags = options?.tags ?? this.tags;\n this.inheritableTags = options?.inheritableTags ?? this.inheritableTags;\n this.metadata = options?.metadata ?? this.metadata;\n this.inheritableMetadata =\n options?.inheritableMetadata ?? this.inheritableMetadata;\n this._parentRunId = parentRunId;\n }\n\n /**\n * Gets the parent run ID, if any.\n *\n * @returns The parent run ID.\n */\n getParentRunId() {\n return this._parentRunId;\n }\n\n async handleLLMStart(\n llm: Serialized,\n prompts: string[],\n runId: string | undefined = undefined,\n _parentRunId: string | undefined = undefined,\n extraParams: Record<string, unknown> | undefined = undefined,\n _tags: string[] | undefined = undefined,\n _metadata: Record<string, unknown> | undefined = undefined,\n runName: string | undefined = undefined\n ): Promise<CallbackManagerForLLMRun[]> {\n return Promise.all(\n prompts.map(async (prompt, idx) => {\n // Can't have duplicate runs with the same run ID (if provided)\n const runId_ = idx === 0 && runId ? runId : uuidv7();\n\n await Promise.all(\n this.handlers.map((handler) => {\n if (handler.ignoreLLM) {\n return;\n }\n if (isBaseTracer(handler)) {\n // Create and add run to the run map.\n // We do this synchronously to avoid race conditions\n // when callbacks are backgrounded.\n handler._createRunForLLMStart(\n llm,\n [prompt],\n runId_,\n this._parentRunId,\n extraParams,\n this.tags,\n this.metadata,\n runName\n );\n }\n return consumeCallback(async () => {\n try {\n await handler.handleLLMStart?.(\n llm,\n [prompt],\n runId_,\n this._parentRunId,\n extraParams,\n this.tags,\n this.metadata,\n runName\n );\n } catch (err) {\n const logFunction = handler.raiseError\n ? console.error\n : console.warn;\n logFunction(\n `Error in handler ${handler.constructor.name}, handleLLMStart: ${err}`\n );\n if (handler.raiseError) {\n throw err;\n }\n }\n }, handler.awaitHandlers);\n })\n );\n\n return new CallbackManagerForLLMRun(\n runId_,\n this.handlers,\n this.inheritableHandlers,\n this.tags,\n this.inheritableTags,\n this.metadata,\n this.inheritableMetadata,\n this._parentRunId\n );\n })\n );\n }\n\n async handleChatModelStart(\n llm: Serialized,\n messages: BaseMessage[][],\n runId: string | undefined = undefined,\n _parentRunId: string | undefined = undefined,\n extraParams: Record<string, unknown> | undefined = undefined,\n _tags: string[] | undefined = undefined,\n _metadata: Record<string, unknown> | undefined = undefined,\n runName: string | undefined = undefined\n ): Promise<CallbackManagerForLLMRun[]> {\n return Promise.all(\n messages.map(async (messageGroup, idx) => {\n // Can't have duplicate runs with the same run ID (if provided)\n const runId_ = idx === 0 && runId ? runId : uuidv7();\n\n await Promise.all(\n this.handlers.map((handler) => {\n if (handler.ignoreLLM) {\n return;\n }\n if (isBaseTracer(handler)) {\n // Create and add run to the run map.\n // We do this synchronously to avoid race conditions\n // when callbacks are backgrounded.\n handler._createRunForChatModelStart(\n llm,\n [messageGroup],\n runId_,\n this._parentRunId,\n extraParams,\n this.tags,\n this.metadata,\n runName\n );\n }\n return consumeCallback(async () => {\n try {\n if (handler.handleChatModelStart) {\n await handler.handleChatModelStart?.(\n llm,\n [messageGroup],\n runId_,\n this._parentRunId,\n extraParams,\n this.tags,\n this.metadata,\n runName\n );\n } else if (handler.handleLLMStart) {\n const messageString = getBufferString(messageGroup);\n await handler.handleLLMStart?.(\n llm,\n [messageString],\n runId_,\n this._parentRunId,\n extraParams,\n this.tags,\n this.metadata,\n runName\n );\n }\n } catch (err) {\n const logFunction = handler.raiseError\n ? console.error\n : console.warn;\n logFunction(\n `Error in handler ${handler.constructor.name}, handleLLMStart: ${err}`\n );\n if (handler.raiseError) {\n throw err;\n }\n }\n }, handler.awaitHandlers);\n })\n );\n\n return new CallbackManagerForLLMRun(\n runId_,\n this.handlers,\n this.inheritableHandlers,\n this.tags,\n this.inheritableTags,\n this.metadata,\n this.inheritableMetadata,\n this._parentRunId\n );\n })\n );\n }\n\n async handleChainStart(\n chain: Serialized,\n inputs: ChainValues,\n runId = uuidv7(),\n runType: string | undefined = undefined,\n _tags: string[] | undefined = undefined,\n _metadata: Record<string, unknown> | undefined = undefined,\n runName: string | undefined = undefined,\n _parentRunId: string | undefined = undefined,\n extra: Record<string, unknown> | undefined = undefined\n ): Promise<CallbackManagerForChainRun> {\n await Promise.all(\n this.handlers.map((handler) => {\n if (handler.ignoreChain) {\n return;\n }\n if (isBaseTracer(handler)) {\n // Create and add run to the run map.\n // We do this synchronously to avoid race conditions\n // when callbacks are backgrounded.\n handler._createRunForChainStart(\n chain,\n inputs,\n runId,\n this._parentRunId,\n this.tags,\n this.metadata,\n runType,\n runName,\n extra\n );\n }\n return consumeCallback(async () => {\n try {\n await handler.handleChainStart?.(\n chain,\n inputs,\n runId,\n this._parentRunId,\n this.tags,\n this.metadata,\n runType,\n runName,\n extra\n );\n } catch (err) {\n const logFunction = handler.raiseError\n ? console.error\n : console.warn;\n logFunction(\n `Error in handler ${handler.constructor.name}, handleChainStart: ${err}`\n );\n if (handler.raiseError) {\n throw err;\n }\n }\n }, handler.awaitHandlers);\n })\n );\n return new CallbackManagerForChainRun(\n runId,\n this.handlers,\n this.inheritableHandlers,\n this.tags,\n this.inheritableTags,\n this.metadata,\n this.inheritableMetadata,\n this._parentRunId\n );\n }\n\n async handleToolStart(\n tool: Serialized,\n input: string,\n runId = uuidv7(),\n _parentRunId: string | undefined = undefined,\n _tags: string[] | undefined = undefined,\n _metadata: Record<string, unknown> | undefined = undefined,\n runName: string | undefined = undefined,\n toolCallId: string | undefined = undefined\n ): Promise<CallbackManagerForToolRun> {\n await Promise.all(\n this.handlers.map((handler) => {\n if (handler.ignoreAgent) {\n return;\n }\n if (isBaseTracer(handler)) {\n // Create and add run to the run map.\n // We do this synchronously to avoid race conditions\n // when callbacks are backgrounded.\n handler._createRunForToolStart(\n tool,\n input,\n runId,\n this._parentRunId,\n this.tags,\n this.metadata,\n runName\n );\n }\n return consumeCallback(async () => {\n try {\n await handler.handleToolStart?.(\n tool,\n input,\n runId,\n this._parentRunId,\n this.tags,\n this.metadata,\n runName,\n toolCallId\n );\n } catch (err) {\n const logFunction = handler.raiseError\n ? console.error\n : console.warn;\n logFunction(\n `Error in handler ${handler.constructor.name}, handleToolStart: ${err}`\n );\n if (handler.raiseError) {\n throw err;\n }\n }\n }, handler.awaitHandlers);\n })\n );\n return new CallbackManagerForToolRun(\n runId,\n this.handlers,\n this.inheritableHandlers,\n this.tags,\n this.inheritableTags,\n this.metadata,\n this.inheritableMetadata,\n this._parentRunId\n );\n }\n\n async handleRetrieverStart(\n retriever: Serialized,\n query: string,\n runId: string = uuidv7(),\n _parentRunId: string | undefined = undefined,\n _tags: string[] | undefined = undefined,\n _metadata: Record<string, unknown> | undefined = undefined,\n runName: string | undefined = undefined\n ): Promise<CallbackManagerForRetrieverRun> {\n await Promise.all(\n this.handlers.map((handler) => {\n if (handler.ignoreRetriever) {\n return;\n }\n if (isBaseTracer(handler)) {\n // Create and add run to the run map.\n // We do this synchronously to avoid race conditions\n // when callbacks are backgrounded.\n handler._createRunForRetrieverStart(\n retriever,\n query,\n runId,\n this._parentRunId,\n this.tags,\n this.metadata,\n runName\n );\n }\n return consumeCallback(async () => {\n try {\n await handler.handleRetrieverStart?.(\n retriever,\n query,\n runId,\n this._parentRunId,\n this.tags,\n this.metadata,\n runName\n );\n } catch (err) {\n const logFunction = handler.raiseError\n ? console.error\n : console.warn;\n logFunction(\n `Error in handler ${handler.constructor.name}, handleRetrieverStart: ${err}`\n );\n if (handler.raiseError) {\n throw err;\n }\n }\n }, handler.awaitHandlers);\n })\n );\n return new CallbackManagerForRetrieverRun(\n runId,\n this.handlers,\n this.inheritableHandlers,\n this.tags,\n this.inheritableTags,\n this.metadata,\n this.inheritableMetadata,\n this._parentRunId\n );\n }\n\n async handleCustomEvent?(\n eventName: string,\n // oxlint-disable-next-line @typescript-eslint/no-explicit-any\n data: any,\n runId: string,\n _tags?: string[],\n // oxlint-disable-next-line @typescript-eslint/no-explicit-any\n _metadata?: Record<string, any>\n ): // oxlint-disable-next-line @typescript-eslint/no-explicit-any\n Promise<any> {\n await Promise.all(\n this.handlers.map((handler) =>\n consumeCallback(async () => {\n if (!handler.ignoreCustomEvent) {\n try {\n await handler.handleCustomEvent?.(\n eventName,\n data,\n runId,\n this.tags,\n this.metadata\n );\n } catch (err) {\n const logFunction = handler.raiseError\n ? console.error\n : console.warn;\n logFunction(\n `Error in handler ${handler.constructor.name}, handleCustomEvent: ${err}`\n );\n if (handler.raiseError) {\n throw err;\n }\n }\n }\n }, handler.awaitHandlers)\n )\n );\n }\n\n addHandler(handler: BaseCallbackHandler, inherit = true): void {\n this.handlers.push(handler);\n if (inherit) {\n this.inheritableHandlers.push(handler);\n }\n }\n\n removeHandler(handler: BaseCallbackHandler): void {\n this.handlers = this.handlers.filter((_handler) => _handler !== handler);\n this.inheritableHandlers = this.inheritableHandlers.filter(\n (_handler) => _handler !== handler\n );\n }\n\n setHandlers(handlers: BaseCallbackHandler[], inherit = true): void {\n this.handlers = [];\n this.inheritableHandlers = [];\n for (const handler of handlers) {\n this.addHandler(handler, inherit);\n }\n }\n\n addTags(tags: string[], inherit = true): void {\n this.removeTags(tags); // Remove duplicates\n this.tags.push(...tags);\n if (inherit) {\n this.inheritableTags.push(...tags);\n }\n }\n\n removeTags(tags: string[]): void {\n this.tags = this.tags.filter((tag) => !tags.includes(tag));\n this.inheritableTags = this.inheritableTags.filter(\n (tag) => !tags.includes(tag)\n );\n }\n\n addMetadata(metadata: Record<string, unknown>, inherit = true): void {\n this.metadata = { ...this.metadata, ...metadata };\n if (inherit) {\n this.inheritableMetadata = { ...this.inheritableMetadata, ...metadata };\n }\n }\n\n removeMetadata(metadata: Record<string, unknown>): void {\n for (const key of Object.keys(metadata)) {\n delete this.metadata[key];\n delete this.inheritableMetadata[key];\n }\n }\n\n copy(\n additionalHandlers: BaseCallbackHandler[] = [],\n inherit = true\n ): CallbackManager {\n const manager = new CallbackManager(this._parentRunId);\n for (const handler of this.handlers) {\n const inheritable = this.inheritableHandlers.includes(handler);\n manager.addHandler(handler, inheritable);\n }\n for (const tag of this.tags) {\n const inheritable = this.inheritableTags.includes(tag);\n manager.addTags([tag], inheritable);\n }\n for (const key of Object.keys(this.metadata)) {\n const inheritable = Object.keys(this.inheritableMetadata).includes(key);\n manager.addMetadata({ [key]: this.metadata[key] }, inheritable);\n }\n for (const handler of additionalHandlers) {\n if (\n // Prevent multiple copies of console_callback_handler\n manager.handlers\n .filter((h) => h.name === \"console_callback_handler\")\n .some((h) => h.name === handler.name)\n ) {\n continue;\n }\n manager.addHandler(handler, inherit);\n }\n return manager;\n }\n\n static fromHandlers(handlers: CallbackHandlerMethods) {\n class Handler extends BaseCallbackHandler {\n name = uuidv7();\n\n constructor() {\n super();\n Object.assign(this, handlers);\n }\n }\n\n const manager = new this();\n manager.addHandler(new Handler());\n return manager;\n }\n\n static configure(\n inheritableHandlers?: Callbacks,\n localHandlers?: Callbacks,\n inheritableTags?: string[],\n localTags?: string[],\n inheritableMetadata?: Record<string, unknown>,\n localMetadata?: Record<string, unknown>,\n options?: CallbackManagerOptions\n ): CallbackManager | undefined {\n return this._configureSync(\n inheritableHandlers,\n localHandlers,\n inheritableTags,\n localTags,\n inheritableMetadata,\n localMetadata,\n options\n );\n }\n\n // TODO: Deprecate async method in favor of this one.\n static _configureSync(\n inheritableHandlers?: Callbacks,\n localHandlers?: Callbacks,\n inheritableTags?: string[],\n localTags?: string[],\n inheritableMetadata?: Record<string, unknown>,\n localMetadata?: Record<string, unknown>,\n options?: CallbackManagerOptions\n ) {\n let callbackManager: CallbackManager | undefined;\n if (inheritableHandlers || localHandlers) {\n if (Array.isArray(inheritableHandlers) || !inheritableHandlers) {\n callbackManager = new CallbackManager();\n callbackManager.setHandlers(\n inheritableHandlers?.map(ensureHandler) ?? [],\n true\n );\n } else {\n callbackManager = inheritableHandlers;\n }\n\n callbackManager = callbackManager.copy(\n Array.isArray(localHandlers)\n ? localHandlers.map(ensureHandler)\n : localHandlers?.handlers,\n false\n );\n }\n\n const verboseEnabled =\n getEnvironmentVariable(\"LANGCHAIN_VERBOSE\") === \"true\" ||\n options?.verbose;\n\n const traceableRunTree = LangChainTracer.getTraceableRunTree();\n const tracingV2Enabled =\n traceableRunTree?.tracingEnabled ?? isTracingEnabled();\n\n // If tracing is explicitly disabled by the RunTree (e.g. via\n // traceable({ tracingEnabled: false })), remove any inherited\n // LangChainTracer handlers so that child runs don't trace either.\n if (traceableRunTree?.tracingEnabled === false && callbackManager) {\n const inheritedTracers = callbackManager.handlers.filter(\n (handler) => handler.name === \"langchain_tracer\"\n );\n for (const tracer of inheritedTracers) {\n callbackManager.removeHandler(tracer);\n }\n }\n\n const tracingEnabled =\n tracingV2Enabled ||\n (getEnvironmentVariable(\"LANGCHAIN_TRACING\") ?? false);\n if (verboseEnabled || tracingEnabled) {\n if (!callbackManager) {\n callbackManager = new CallbackManager();\n }\n if (\n verboseEnabled &&\n !callbackManager.handlers.some(\n (handler) => handler.name === ConsoleCallbackHandler.prototype.name\n )\n ) {\n const consoleHandler = new ConsoleCallbackHandler();\n callbackManager.addHandler(consoleHandler, true);\n }\n if (\n tracingEnabled &&\n !callbackManager.handlers.some(\n (handler) => handler.name === \"langchain_tracer\"\n )\n ) {\n if (tracingV2Enabled) {\n const tracerV2 = new LangChainTracer();\n callbackManager.addHandler(tracerV2, true);\n }\n }\n if (tracingV2Enabled) {\n // handoff between langchain and langsmith/traceable\n // override the parent run ID\n if (traceableRunTree && callbackManager._parentRunId === undefined) {\n callbackManager._parentRunId = traceableRunTree.id;\n const tracerV2 = callbackManager.handlers.find(\n (handler) => handler.name === \"langchain_tracer\"\n ) as LangChainTracer | undefined;\n tracerV2?.updateFromRunTree(traceableRunTree);\n }\n }\n }\n\n for (const {\n contextVar,\n inheritable = true,\n handlerClass,\n envVar,\n } of _getConfigureHooks()) {\n const createIfNotInContext =\n envVar && getEnvironmentVariable(envVar) === \"true\" && handlerClass;\n let handler: BaseCallbackHandler | undefined;\n const contextVarValue =\n contextVar !== undefined ? getContextVariable(contextVar) : undefined;\n if (contextVarValue && isBaseCallbackHandler(contextVarValue)) {\n handler = contextVarValue;\n } else if (createIfNotInContext) {\n // oxlint-disable-next-line @typescript-eslint/no-explicit-any\n handler = new (handlerClass as any)({});\n }\n if (handler !== undefined) {\n if (!callbackManager) {\n callbackManager = new CallbackManager();\n }\n\n if (!callbackManager.handlers.some((h) => h.name === handler!.name)) {\n callbackManager.addHandler(handler, inheritable);\n }\n }\n }\n\n if (inheritableTags || localTags) {\n if (callbackManager) {\n callbackManager.addTags(inheritableTags ?? []);\n callbackManager.addTags(localTags ?? [], false);\n }\n }\n if (inheritableMetadata || localMetadata) {\n if (callbackManager) {\n callbackManager.addMetadata(inheritableMetadata ?? {});\n callbackManager.addMetadata(localMetadata ?? {}, false);\n }\n }\n const tracerInheritableMetadata = options?.tracerInheritableMetadata;\n const tracerInheritableTags = options?.tracerInheritableTags;\n\n if (\n callbackManager &&\n (tracerInheritableMetadata || tracerInheritableTags)\n ) {\n callbackManager.handlers = callbackManager.handlers.map((handler) =>\n handler instanceof LangChainTracer\n ? handler.copyWithTracingConfig({\n metadata: tracerInheritableMetadata,\n tags: tracerInheritableTags,\n })\n : handler\n );\n callbackManager.inheritableHandlers =\n callbackManager.inheritableHandlers.map((handler) =>\n handler instanceof LangChainTracer\n ? handler.copyWithTracingConfig({\n metadata: tracerInheritableMetadata,\n tags: tracerInheritableTags,\n })\n : handler\n );\n }\n\n return callbackManager;\n }\n}\n\nexport function ensureHandler(\n handler: BaseCallbackHandler | CallbackHandlerMethods\n): BaseCallbackHandler {\n if (\"name\" in handler) {\n return handler;\n }\n\n return BaseCallbackHandler.fromMethods(handler);\n}\n"],"mappings":"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"}
|
|
@@ -139,7 +139,7 @@ var BaseLangChain = class extends require_base.Runnable {
|
|
|
139
139
|
this.callbacks = params.callbacks;
|
|
140
140
|
this.tags = params.tags ?? [];
|
|
141
141
|
this.metadata = params.metadata ?? {};
|
|
142
|
-
this._addVersion("@langchain/core", "1.1.
|
|
142
|
+
this._addVersion("@langchain/core", "1.1.40");
|
|
143
143
|
}
|
|
144
144
|
_addVersion(pkg, version) {
|
|
145
145
|
const existing = this.metadata?.versions;
|
|
@@ -138,7 +138,7 @@ var BaseLangChain = class extends Runnable {
|
|
|
138
138
|
this.callbacks = params.callbacks;
|
|
139
139
|
this.tags = params.tags ?? [];
|
|
140
140
|
this.metadata = params.metadata ?? {};
|
|
141
|
-
this._addVersion("@langchain/core", "1.1.
|
|
141
|
+
this._addVersion("@langchain/core", "1.1.40");
|
|
142
142
|
}
|
|
143
143
|
_addVersion(pkg, version) {
|
|
144
144
|
const existing = this.metadata?.versions;
|
|
@@ -2,8 +2,21 @@ const require_callbacks_manager = require("../callbacks/manager.cjs");
|
|
|
2
2
|
const require_index = require("../singletons/async_local_storage/index.cjs");
|
|
3
3
|
require("../singletons/index.cjs");
|
|
4
4
|
//#region src/runnables/config.ts
|
|
5
|
+
const CONFIGURABLE_TO_TRACING_METADATA_EXCLUDED_KEYS = new Set(["api_key"]);
|
|
6
|
+
const PRIMITIVES = new Set([
|
|
7
|
+
"string",
|
|
8
|
+
"number",
|
|
9
|
+
"boolean"
|
|
10
|
+
]);
|
|
11
|
+
function _getTracingInheritableMetadataFromConfig(config) {
|
|
12
|
+
const configurable = config.configurable ?? {};
|
|
13
|
+
const metadata = config.metadata ?? {};
|
|
14
|
+
const langSmithMetadata = {};
|
|
15
|
+
for (const [key, value] of Object.entries(configurable)) if (!key.startsWith("__") && !Object.prototype.hasOwnProperty.call(metadata, key) && !CONFIGURABLE_TO_TRACING_METADATA_EXCLUDED_KEYS.has(key) && PRIMITIVES.has(typeof value)) langSmithMetadata[key] = value;
|
|
16
|
+
return Object.keys(langSmithMetadata).length > 0 ? langSmithMetadata : void 0;
|
|
17
|
+
}
|
|
5
18
|
async function getCallbackManagerForConfig(config) {
|
|
6
|
-
return require_callbacks_manager.CallbackManager._configureSync(config?.callbacks, void 0, config?.tags, void 0, config?.metadata);
|
|
19
|
+
return require_callbacks_manager.CallbackManager._configureSync(config?.callbacks, void 0, config?.tags, void 0, config?.metadata, void 0, { tracerInheritableMetadata: config ? _getTracingInheritableMetadataFromConfig(config) : void 0 });
|
|
7
20
|
}
|
|
8
21
|
function mergeConfigs(...configs) {
|
|
9
22
|
const copy = {};
|
|
@@ -56,11 +69,6 @@ function mergeConfigs(...configs) {
|
|
|
56
69
|
}
|
|
57
70
|
return copy;
|
|
58
71
|
}
|
|
59
|
-
const PRIMITIVES = new Set([
|
|
60
|
-
"string",
|
|
61
|
-
"number",
|
|
62
|
-
"boolean"
|
|
63
|
-
]);
|
|
64
72
|
/**
|
|
65
73
|
* Ensure that a passed config is an object with all required keys present.
|
|
66
74
|
*/
|
|
@@ -84,9 +92,9 @@ function ensureConfig(config) {
|
|
|
84
92
|
return currentConfig;
|
|
85
93
|
}, empty);
|
|
86
94
|
if (empty?.configurable) {
|
|
87
|
-
|
|
95
|
+
if (typeof empty.configurable.model === "string" && empty.metadata?.model === void 0) {
|
|
88
96
|
if (!empty.metadata) empty.metadata = {};
|
|
89
|
-
empty.metadata
|
|
97
|
+
empty.metadata.model = empty.configurable.model;
|
|
90
98
|
}
|
|
91
99
|
}
|
|
92
100
|
if (empty.timeout !== void 0) {
|
|
@@ -1 +1 @@
|
|
|
1
|
-
{"version":3,"file":"config.cjs","names":["CallbackManager","ensureHandler","AsyncLocalStorageProviderSingleton"],"sources":["../../src/runnables/config.ts"],"sourcesContent":["import { CallbackManager, ensureHandler } from \"../callbacks/manager.js\";\nimport { AsyncLocalStorageProviderSingleton } from \"../singletons/index.js\";\nimport { RunnableConfig } from \"./types.js\";\n\nexport const DEFAULT_RECURSION_LIMIT = 25;\n\nexport { type RunnableConfig };\n\nexport async function getCallbackManagerForConfig(config?: RunnableConfig) {\n return CallbackManager._configureSync(\n config?.callbacks,\n undefined,\n config?.tags,\n undefined,\n config?.metadata\n );\n}\n\nexport function mergeConfigs<CallOptions extends RunnableConfig>(\n ...configs: (CallOptions | RunnableConfig | undefined | null)[]\n): Partial<CallOptions> {\n // We do not want to call ensureConfig on the empty state here as this may cause\n // double loading of callbacks if async local storage is being used.\n const copy: Partial<CallOptions> = {};\n for (const options of configs.filter((c): c is CallOptions => !!c)) {\n for (const key of Object.keys(options)) {\n if (key === \"metadata\") {\n copy[key] = { ...copy[key], ...options[key] };\n } else if (key === \"tags\") {\n const baseKeys: string[] = copy[key] ?? [];\n copy[key] = [...new Set(baseKeys.concat(options[key] ?? []))];\n } else if (key === \"configurable\") {\n copy[key] = { ...copy[key], ...options[key] };\n } else if (key === \"timeout\") {\n if (copy.timeout === undefined) {\n copy.timeout = options.timeout;\n } else if (options.timeout !== undefined) {\n copy.timeout = Math.min(copy.timeout, options.timeout);\n }\n } else if (key === \"signal\") {\n if (copy.signal === undefined) {\n copy.signal = options.signal;\n } else if (options.signal !== undefined) {\n if (\"any\" in AbortSignal) {\n // oxlint-disable-next-line @typescript-eslint/no-explicit-any\n copy.signal = (AbortSignal as any).any([\n copy.signal,\n options.signal,\n ]);\n } else {\n copy.signal = options.signal;\n }\n }\n } else if (key === \"callbacks\") {\n const baseCallbacks = copy.callbacks;\n const providedCallbacks = options.callbacks;\n // callbacks can be either undefined, Array<handler> or manager\n // so merging two callbacks values has 6 cases\n if (Array.isArray(providedCallbacks)) {\n if (!baseCallbacks) {\n copy.callbacks = providedCallbacks;\n } else if (Array.isArray(baseCallbacks)) {\n copy.callbacks = baseCallbacks.concat(providedCallbacks);\n } else {\n // baseCallbacks is a manager\n const manager = baseCallbacks.copy();\n for (const callback of providedCallbacks) {\n manager.addHandler(ensureHandler(callback), true);\n }\n copy.callbacks = manager;\n }\n } else if (providedCallbacks) {\n // providedCallbacks is a manager\n if (!baseCallbacks) {\n copy.callbacks = providedCallbacks;\n } else if (Array.isArray(baseCallbacks)) {\n const manager = providedCallbacks.copy();\n for (const callback of baseCallbacks) {\n manager.addHandler(ensureHandler(callback), true);\n }\n copy.callbacks = manager;\n } else {\n // baseCallbacks is also a manager\n copy.callbacks = new CallbackManager(\n providedCallbacks._parentRunId,\n {\n handlers: baseCallbacks.handlers.concat(\n providedCallbacks.handlers\n ),\n inheritableHandlers: baseCallbacks.inheritableHandlers.concat(\n providedCallbacks.inheritableHandlers\n ),\n tags: Array.from(\n new Set(baseCallbacks.tags.concat(providedCallbacks.tags))\n ),\n inheritableTags: Array.from(\n new Set(\n baseCallbacks.inheritableTags.concat(\n providedCallbacks.inheritableTags\n )\n )\n ),\n metadata: {\n ...baseCallbacks.metadata,\n ...providedCallbacks.metadata,\n },\n }\n );\n }\n }\n } else {\n const typedKey = key as keyof CallOptions;\n copy[typedKey] = options[typedKey] ?? copy[typedKey];\n }\n }\n }\n return copy as Partial<CallOptions>;\n}\n\nconst PRIMITIVES = new Set([\"string\", \"number\", \"boolean\"]);\n\n/**\n * Ensure that a passed config is an object with all required keys present.\n */\nexport function ensureConfig<CallOptions extends RunnableConfig>(\n config?: CallOptions\n): CallOptions {\n const implicitConfig = AsyncLocalStorageProviderSingleton.getRunnableConfig();\n let empty: RunnableConfig = {\n tags: [],\n metadata: {},\n recursionLimit: 25,\n runId: undefined,\n };\n if (implicitConfig) {\n // Don't allow runId and runName to be loaded implicitly, as this can cause\n // child runs to improperly inherit their parents' run ids.\n const { runId, runName, ...rest } = implicitConfig;\n empty = Object.entries(rest).reduce(\n // oxlint-disable-next-line @typescript-eslint/no-explicit-any\n (currentConfig: Record<string, any>, [key, value]) => {\n if (value !== undefined) {\n currentConfig[key] = value;\n }\n return currentConfig;\n },\n empty\n );\n }\n if (config) {\n empty = Object.entries(config).reduce(\n // oxlint-disable-next-line @typescript-eslint/no-explicit-any\n (currentConfig: Record<string, any>, [key, value]) => {\n if (value !== undefined) {\n currentConfig[key] = value;\n }\n return currentConfig;\n },\n empty\n );\n }\n if (empty?.configurable) {\n for (const key of Object.keys(empty.configurable)) {\n if (\n PRIMITIVES.has(typeof empty.configurable[key]) &&\n !empty.metadata?.[key]\n ) {\n if (!empty.metadata) {\n empty.metadata = {};\n }\n empty.metadata[key] = empty.configurable[key];\n }\n }\n }\n if (empty.timeout !== undefined) {\n if (empty.timeout <= 0) {\n throw new Error(\"Timeout must be a positive number\");\n }\n const originalTimeoutMs = empty.timeout;\n const timeoutSignal = AbortSignal.timeout(originalTimeoutMs);\n // Preserve the numeric timeout for downstream consumers that need to pass\n // an explicit timeout value to underlying SDKs in addition to an AbortSignal.\n // We store it in metadata to avoid changing the public config shape.\n if (!empty.metadata) {\n empty.metadata = {};\n }\n // Do not overwrite if already set upstream.\n if (empty.metadata.timeoutMs === undefined) {\n empty.metadata.timeoutMs = originalTimeoutMs;\n }\n if (empty.signal !== undefined) {\n if (\"any\" in AbortSignal) {\n // oxlint-disable-next-line @typescript-eslint/no-explicit-any\n empty.signal = (AbortSignal as any).any([empty.signal, timeoutSignal]);\n }\n } else {\n empty.signal = timeoutSignal;\n }\n\n /**\n * We are deleting the timeout key for the following reasons:\n * - Idempotent normalization: ensureConfig may be called multiple times down the stack. If timeout remains,\n * each call would synthesize new timeout signals and combine them, changing the effective timeout unpredictably.\n * - Single enforcement path: downstream code relies on signal to enforce cancellation. Leaving timeout means two\n * competing mechanisms (numeric timeout and signal) can be applied, sometimes with different semantics.\n * - Propagation to children: pickRunnableConfigKeys would keep forwarding timeout to nested runnables, causing\n * repeated re-normalization and stacked timeouts.\n * - Backward compatibility: a lot of components and tests assume ensureConfig removes timeout post-normalization;\n * changing that would be a breaking change.\n */\n delete empty.timeout;\n }\n return empty as CallOptions;\n}\n\n/**\n * Helper function that patches runnable configs with updated properties.\n */\nexport function patchConfig<CallOptions extends RunnableConfig>(\n config: Partial<CallOptions> = {},\n {\n callbacks,\n maxConcurrency,\n recursionLimit,\n runName,\n configurable,\n runId,\n }: RunnableConfig = {}\n): Partial<CallOptions> {\n const newConfig = ensureConfig(config);\n if (callbacks !== undefined) {\n /**\n * If we're replacing callbacks we need to unset runName\n * since that should apply only to the same run as the original callbacks\n */\n delete newConfig.runName;\n newConfig.callbacks = callbacks;\n }\n if (recursionLimit !== undefined) {\n newConfig.recursionLimit = recursionLimit;\n }\n if (maxConcurrency !== undefined) {\n newConfig.maxConcurrency = maxConcurrency;\n }\n if (runName !== undefined) {\n newConfig.runName = runName;\n }\n if (configurable !== undefined) {\n newConfig.configurable = { ...newConfig.configurable, ...configurable };\n }\n if (runId !== undefined) {\n delete newConfig.runId;\n }\n return newConfig;\n}\n\n// oxlint-disable-next-line @typescript-eslint/no-explicit-any\nexport function pickRunnableConfigKeys<CallOptions extends Record<string, any>>(\n config?: CallOptions\n): Partial<RunnableConfig> | undefined {\n if (!config) return undefined;\n\n return {\n configurable: config.configurable,\n recursionLimit: config.recursionLimit,\n callbacks: config.callbacks,\n tags: config.tags,\n metadata: config.metadata,\n maxConcurrency: config.maxConcurrency,\n timeout: config.timeout,\n signal: config.signal,\n // @ts-expect-error - Store is a LangGraph-specific property\n // which wewant to pass through to all runnables.\n // (eg. tools should have access to writing to the store)\n store: config.store,\n };\n}\n"],"mappings":"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"}
|
|
1
|
+
{"version":3,"file":"config.cjs","names":["CallbackManager","ensureHandler","AsyncLocalStorageProviderSingleton"],"sources":["../../src/runnables/config.ts"],"sourcesContent":["import { CallbackManager, ensureHandler } from \"../callbacks/manager.js\";\nimport { AsyncLocalStorageProviderSingleton } from \"../singletons/index.js\";\nimport { RunnableConfig } from \"./types.js\";\n\nexport const DEFAULT_RECURSION_LIMIT = 25;\n\nexport { type RunnableConfig };\n\nconst CONFIGURABLE_TO_TRACING_METADATA_EXCLUDED_KEYS = new Set([\"api_key\"]);\nconst PRIMITIVES = new Set([\"string\", \"number\", \"boolean\"]);\n\nexport function _getTracingInheritableMetadataFromConfig(\n config: RunnableConfig\n): Record<string, unknown> | undefined {\n const configurable = config.configurable ?? {};\n const metadata = config.metadata ?? {};\n const langSmithMetadata: Record<string, unknown> = {};\n for (const [key, value] of Object.entries(configurable)) {\n if (\n !key.startsWith(\"__\") &&\n !Object.prototype.hasOwnProperty.call(metadata, key) &&\n !CONFIGURABLE_TO_TRACING_METADATA_EXCLUDED_KEYS.has(key) &&\n PRIMITIVES.has(typeof value)\n ) {\n langSmithMetadata[key] = value;\n }\n }\n return Object.keys(langSmithMetadata).length > 0\n ? langSmithMetadata\n : undefined;\n}\n\nexport async function getCallbackManagerForConfig(config?: RunnableConfig) {\n return CallbackManager._configureSync(\n config?.callbacks,\n undefined,\n config?.tags,\n undefined,\n config?.metadata,\n undefined,\n {\n tracerInheritableMetadata: config\n ? _getTracingInheritableMetadataFromConfig(config)\n : undefined,\n }\n );\n}\n\nexport function mergeConfigs<CallOptions extends RunnableConfig>(\n ...configs: (CallOptions | RunnableConfig | undefined | null)[]\n): Partial<CallOptions> {\n // We do not want to call ensureConfig on the empty state here as this may cause\n // double loading of callbacks if async local storage is being used.\n const copy: Partial<CallOptions> = {};\n for (const options of configs.filter((c): c is CallOptions => !!c)) {\n for (const key of Object.keys(options)) {\n if (key === \"metadata\") {\n copy[key] = { ...copy[key], ...options[key] };\n } else if (key === \"tags\") {\n const baseKeys: string[] = copy[key] ?? [];\n copy[key] = [...new Set(baseKeys.concat(options[key] ?? []))];\n } else if (key === \"configurable\") {\n copy[key] = { ...copy[key], ...options[key] };\n } else if (key === \"timeout\") {\n if (copy.timeout === undefined) {\n copy.timeout = options.timeout;\n } else if (options.timeout !== undefined) {\n copy.timeout = Math.min(copy.timeout, options.timeout);\n }\n } else if (key === \"signal\") {\n if (copy.signal === undefined) {\n copy.signal = options.signal;\n } else if (options.signal !== undefined) {\n if (\"any\" in AbortSignal) {\n // oxlint-disable-next-line @typescript-eslint/no-explicit-any\n copy.signal = (AbortSignal as any).any([\n copy.signal,\n options.signal,\n ]);\n } else {\n copy.signal = options.signal;\n }\n }\n } else if (key === \"callbacks\") {\n const baseCallbacks = copy.callbacks;\n const providedCallbacks = options.callbacks;\n // callbacks can be either undefined, Array<handler> or manager\n // so merging two callbacks values has 6 cases\n if (Array.isArray(providedCallbacks)) {\n if (!baseCallbacks) {\n copy.callbacks = providedCallbacks;\n } else if (Array.isArray(baseCallbacks)) {\n copy.callbacks = baseCallbacks.concat(providedCallbacks);\n } else {\n // baseCallbacks is a manager\n const manager = baseCallbacks.copy();\n for (const callback of providedCallbacks) {\n manager.addHandler(ensureHandler(callback), true);\n }\n copy.callbacks = manager;\n }\n } else if (providedCallbacks) {\n // providedCallbacks is a manager\n if (!baseCallbacks) {\n copy.callbacks = providedCallbacks;\n } else if (Array.isArray(baseCallbacks)) {\n const manager = providedCallbacks.copy();\n for (const callback of baseCallbacks) {\n manager.addHandler(ensureHandler(callback), true);\n }\n copy.callbacks = manager;\n } else {\n // baseCallbacks is also a manager\n copy.callbacks = new CallbackManager(\n providedCallbacks._parentRunId,\n {\n handlers: baseCallbacks.handlers.concat(\n providedCallbacks.handlers\n ),\n inheritableHandlers: baseCallbacks.inheritableHandlers.concat(\n providedCallbacks.inheritableHandlers\n ),\n tags: Array.from(\n new Set(baseCallbacks.tags.concat(providedCallbacks.tags))\n ),\n inheritableTags: Array.from(\n new Set(\n baseCallbacks.inheritableTags.concat(\n providedCallbacks.inheritableTags\n )\n )\n ),\n metadata: {\n ...baseCallbacks.metadata,\n ...providedCallbacks.metadata,\n },\n }\n );\n }\n }\n } else {\n const typedKey = key as keyof CallOptions;\n copy[typedKey] = options[typedKey] ?? copy[typedKey];\n }\n }\n }\n return copy as Partial<CallOptions>;\n}\n\n/**\n * Ensure that a passed config is an object with all required keys present.\n */\nexport function ensureConfig<CallOptions extends RunnableConfig>(\n config?: CallOptions\n): CallOptions {\n const implicitConfig = AsyncLocalStorageProviderSingleton.getRunnableConfig();\n let empty: RunnableConfig = {\n tags: [],\n metadata: {},\n recursionLimit: 25,\n runId: undefined,\n };\n if (implicitConfig) {\n // Don't allow runId and runName to be loaded implicitly, as this can cause\n // child runs to improperly inherit their parents' run ids.\n const { runId, runName, ...rest } = implicitConfig;\n empty = Object.entries(rest).reduce(\n // oxlint-disable-next-line @typescript-eslint/no-explicit-any\n (currentConfig: Record<string, any>, [key, value]) => {\n if (value !== undefined) {\n currentConfig[key] = value;\n }\n return currentConfig;\n },\n empty\n );\n }\n if (config) {\n empty = Object.entries(config).reduce(\n // oxlint-disable-next-line @typescript-eslint/no-explicit-any\n (currentConfig: Record<string, any>, [key, value]) => {\n if (value !== undefined) {\n currentConfig[key] = value;\n }\n return currentConfig;\n },\n empty\n );\n }\n if (empty?.configurable) {\n if (\n typeof empty.configurable.model === \"string\" &&\n empty.metadata?.model === undefined\n ) {\n if (!empty.metadata) {\n empty.metadata = {};\n }\n empty.metadata.model = empty.configurable.model;\n }\n }\n if (empty.timeout !== undefined) {\n if (empty.timeout <= 0) {\n throw new Error(\"Timeout must be a positive number\");\n }\n const originalTimeoutMs = empty.timeout;\n const timeoutSignal = AbortSignal.timeout(originalTimeoutMs);\n // Preserve the numeric timeout for downstream consumers that need to pass\n // an explicit timeout value to underlying SDKs in addition to an AbortSignal.\n // We store it in metadata to avoid changing the public config shape.\n if (!empty.metadata) {\n empty.metadata = {};\n }\n // Do not overwrite if already set upstream.\n if (empty.metadata.timeoutMs === undefined) {\n empty.metadata.timeoutMs = originalTimeoutMs;\n }\n if (empty.signal !== undefined) {\n if (\"any\" in AbortSignal) {\n // oxlint-disable-next-line @typescript-eslint/no-explicit-any\n empty.signal = (AbortSignal as any).any([empty.signal, timeoutSignal]);\n }\n } else {\n empty.signal = timeoutSignal;\n }\n\n /**\n * We are deleting the timeout key for the following reasons:\n * - Idempotent normalization: ensureConfig may be called multiple times down the stack. If timeout remains,\n * each call would synthesize new timeout signals and combine them, changing the effective timeout unpredictably.\n * - Single enforcement path: downstream code relies on signal to enforce cancellation. Leaving timeout means two\n * competing mechanisms (numeric timeout and signal) can be applied, sometimes with different semantics.\n * - Propagation to children: pickRunnableConfigKeys would keep forwarding timeout to nested runnables, causing\n * repeated re-normalization and stacked timeouts.\n * - Backward compatibility: a lot of components and tests assume ensureConfig removes timeout post-normalization;\n * changing that would be a breaking change.\n */\n delete empty.timeout;\n }\n return empty as CallOptions;\n}\n\n/**\n * Helper function that patches runnable configs with updated properties.\n */\nexport function patchConfig<CallOptions extends RunnableConfig>(\n config: Partial<CallOptions> = {},\n {\n callbacks,\n maxConcurrency,\n recursionLimit,\n runName,\n configurable,\n runId,\n }: RunnableConfig = {}\n): Partial<CallOptions> {\n const newConfig = ensureConfig(config);\n if (callbacks !== undefined) {\n /**\n * If we're replacing callbacks we need to unset runName\n * since that should apply only to the same run as the original callbacks\n */\n delete newConfig.runName;\n newConfig.callbacks = callbacks;\n }\n if (recursionLimit !== undefined) {\n newConfig.recursionLimit = recursionLimit;\n }\n if (maxConcurrency !== undefined) {\n newConfig.maxConcurrency = maxConcurrency;\n }\n if (runName !== undefined) {\n newConfig.runName = runName;\n }\n if (configurable !== undefined) {\n newConfig.configurable = { ...newConfig.configurable, ...configurable };\n }\n if (runId !== undefined) {\n delete newConfig.runId;\n }\n return newConfig;\n}\n\n// oxlint-disable-next-line @typescript-eslint/no-explicit-any\nexport function pickRunnableConfigKeys<CallOptions extends Record<string, any>>(\n config?: CallOptions\n): Partial<RunnableConfig> | undefined {\n if (!config) return undefined;\n\n return {\n configurable: config.configurable,\n recursionLimit: config.recursionLimit,\n callbacks: config.callbacks,\n tags: config.tags,\n metadata: config.metadata,\n maxConcurrency: config.maxConcurrency,\n timeout: config.timeout,\n signal: config.signal,\n // @ts-expect-error - Store is a LangGraph-specific property\n // which wewant to pass through to all runnables.\n // (eg. tools should have access to writing to the store)\n store: config.store,\n };\n}\n"],"mappings":"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"}
|
|
@@ -1 +1 @@
|
|
|
1
|
-
{"version":3,"file":"config.d.cts","names":[],"sources":["../../src/runnables/config.ts"],"mappings":";;;;
|
|
1
|
+
{"version":3,"file":"config.d.cts","names":[],"sources":["../../src/runnables/config.ts"],"mappings":";;;;iBAgCsB,2BAAA,CAA4B,MAAA,GAAS,cAAA,GAAc,OAAA,CAAA,eAAA;AAAA,iBAgBzD,YAAA,qBAAiC,cAAA,CAAA,CAAA,GAC5C,OAAA,GAAU,WAAA,GAAc,cAAA,yBAC1B,OAAA,CAAQ,WAAA;;;;iBAsGK,YAAA,qBAAiC,cAAA,CAAA,CAC/C,MAAA,GAAS,WAAA,GACR,WAAA;;;;iBA0Fa,WAAA,qBAAgC,cAAA,CAAA,CAC9C,MAAA,GAAQ,OAAA,CAAQ,WAAA;EAEd,SAAA;EACA,cAAA;EACA,cAAA;EACA,OAAA;EACA,YAAA;EACA;AAAA,IACC,cAAA,GACF,OAAA,CAAQ,WAAA;AAAA,iBA6BK,sBAAA,qBAA2C,MAAA,cAAA,CACzD,MAAA,GAAS,WAAA,GACR,OAAA,CAAQ,cAAA"}
|
|
@@ -1 +1 @@
|
|
|
1
|
-
{"version":3,"file":"config.d.ts","names":[],"sources":["../../src/runnables/config.ts"],"mappings":";;;;
|
|
1
|
+
{"version":3,"file":"config.d.ts","names":[],"sources":["../../src/runnables/config.ts"],"mappings":";;;;iBAgCsB,2BAAA,CAA4B,MAAA,GAAS,cAAA,GAAc,OAAA,CAAA,eAAA;AAAA,iBAgBzD,YAAA,qBAAiC,cAAA,CAAA,CAAA,GAC5C,OAAA,GAAU,WAAA,GAAc,cAAA,yBAC1B,OAAA,CAAQ,WAAA;;;;iBAsGK,YAAA,qBAAiC,cAAA,CAAA,CAC/C,MAAA,GAAS,WAAA,GACR,WAAA;;;;iBA0Fa,WAAA,qBAAgC,cAAA,CAAA,CAC9C,MAAA,GAAQ,OAAA,CAAQ,WAAA;EAEd,SAAA;EACA,cAAA;EACA,cAAA;EACA,OAAA;EACA,YAAA;EACA;AAAA,IACC,cAAA,GACF,OAAA,CAAQ,WAAA;AAAA,iBA6BK,sBAAA,qBAA2C,MAAA,cAAA,CACzD,MAAA,GAAS,WAAA,GACR,OAAA,CAAQ,cAAA"}
|
package/dist/runnables/config.js
CHANGED
|
@@ -2,8 +2,21 @@ import { CallbackManager, ensureHandler } from "../callbacks/manager.js";
|
|
|
2
2
|
import { AsyncLocalStorageProviderSingleton } from "../singletons/async_local_storage/index.js";
|
|
3
3
|
import "../singletons/index.js";
|
|
4
4
|
//#region src/runnables/config.ts
|
|
5
|
+
const CONFIGURABLE_TO_TRACING_METADATA_EXCLUDED_KEYS = new Set(["api_key"]);
|
|
6
|
+
const PRIMITIVES = new Set([
|
|
7
|
+
"string",
|
|
8
|
+
"number",
|
|
9
|
+
"boolean"
|
|
10
|
+
]);
|
|
11
|
+
function _getTracingInheritableMetadataFromConfig(config) {
|
|
12
|
+
const configurable = config.configurable ?? {};
|
|
13
|
+
const metadata = config.metadata ?? {};
|
|
14
|
+
const langSmithMetadata = {};
|
|
15
|
+
for (const [key, value] of Object.entries(configurable)) if (!key.startsWith("__") && !Object.prototype.hasOwnProperty.call(metadata, key) && !CONFIGURABLE_TO_TRACING_METADATA_EXCLUDED_KEYS.has(key) && PRIMITIVES.has(typeof value)) langSmithMetadata[key] = value;
|
|
16
|
+
return Object.keys(langSmithMetadata).length > 0 ? langSmithMetadata : void 0;
|
|
17
|
+
}
|
|
5
18
|
async function getCallbackManagerForConfig(config) {
|
|
6
|
-
return CallbackManager._configureSync(config?.callbacks, void 0, config?.tags, void 0, config?.metadata);
|
|
19
|
+
return CallbackManager._configureSync(config?.callbacks, void 0, config?.tags, void 0, config?.metadata, void 0, { tracerInheritableMetadata: config ? _getTracingInheritableMetadataFromConfig(config) : void 0 });
|
|
7
20
|
}
|
|
8
21
|
function mergeConfigs(...configs) {
|
|
9
22
|
const copy = {};
|
|
@@ -56,11 +69,6 @@ function mergeConfigs(...configs) {
|
|
|
56
69
|
}
|
|
57
70
|
return copy;
|
|
58
71
|
}
|
|
59
|
-
const PRIMITIVES = new Set([
|
|
60
|
-
"string",
|
|
61
|
-
"number",
|
|
62
|
-
"boolean"
|
|
63
|
-
]);
|
|
64
72
|
/**
|
|
65
73
|
* Ensure that a passed config is an object with all required keys present.
|
|
66
74
|
*/
|
|
@@ -84,9 +92,9 @@ function ensureConfig(config) {
|
|
|
84
92
|
return currentConfig;
|
|
85
93
|
}, empty);
|
|
86
94
|
if (empty?.configurable) {
|
|
87
|
-
|
|
95
|
+
if (typeof empty.configurable.model === "string" && empty.metadata?.model === void 0) {
|
|
88
96
|
if (!empty.metadata) empty.metadata = {};
|
|
89
|
-
empty.metadata
|
|
97
|
+
empty.metadata.model = empty.configurable.model;
|
|
90
98
|
}
|
|
91
99
|
}
|
|
92
100
|
if (empty.timeout !== void 0) {
|
|
@@ -1 +1 @@
|
|
|
1
|
-
{"version":3,"file":"config.js","names":[],"sources":["../../src/runnables/config.ts"],"sourcesContent":["import { CallbackManager, ensureHandler } from \"../callbacks/manager.js\";\nimport { AsyncLocalStorageProviderSingleton } from \"../singletons/index.js\";\nimport { RunnableConfig } from \"./types.js\";\n\nexport const DEFAULT_RECURSION_LIMIT = 25;\n\nexport { type RunnableConfig };\n\nexport async function getCallbackManagerForConfig(config?: RunnableConfig) {\n return CallbackManager._configureSync(\n config?.callbacks,\n undefined,\n config?.tags,\n undefined,\n config?.metadata\n );\n}\n\nexport function mergeConfigs<CallOptions extends RunnableConfig>(\n ...configs: (CallOptions | RunnableConfig | undefined | null)[]\n): Partial<CallOptions> {\n // We do not want to call ensureConfig on the empty state here as this may cause\n // double loading of callbacks if async local storage is being used.\n const copy: Partial<CallOptions> = {};\n for (const options of configs.filter((c): c is CallOptions => !!c)) {\n for (const key of Object.keys(options)) {\n if (key === \"metadata\") {\n copy[key] = { ...copy[key], ...options[key] };\n } else if (key === \"tags\") {\n const baseKeys: string[] = copy[key] ?? [];\n copy[key] = [...new Set(baseKeys.concat(options[key] ?? []))];\n } else if (key === \"configurable\") {\n copy[key] = { ...copy[key], ...options[key] };\n } else if (key === \"timeout\") {\n if (copy.timeout === undefined) {\n copy.timeout = options.timeout;\n } else if (options.timeout !== undefined) {\n copy.timeout = Math.min(copy.timeout, options.timeout);\n }\n } else if (key === \"signal\") {\n if (copy.signal === undefined) {\n copy.signal = options.signal;\n } else if (options.signal !== undefined) {\n if (\"any\" in AbortSignal) {\n // oxlint-disable-next-line @typescript-eslint/no-explicit-any\n copy.signal = (AbortSignal as any).any([\n copy.signal,\n options.signal,\n ]);\n } else {\n copy.signal = options.signal;\n }\n }\n } else if (key === \"callbacks\") {\n const baseCallbacks = copy.callbacks;\n const providedCallbacks = options.callbacks;\n // callbacks can be either undefined, Array<handler> or manager\n // so merging two callbacks values has 6 cases\n if (Array.isArray(providedCallbacks)) {\n if (!baseCallbacks) {\n copy.callbacks = providedCallbacks;\n } else if (Array.isArray(baseCallbacks)) {\n copy.callbacks = baseCallbacks.concat(providedCallbacks);\n } else {\n // baseCallbacks is a manager\n const manager = baseCallbacks.copy();\n for (const callback of providedCallbacks) {\n manager.addHandler(ensureHandler(callback), true);\n }\n copy.callbacks = manager;\n }\n } else if (providedCallbacks) {\n // providedCallbacks is a manager\n if (!baseCallbacks) {\n copy.callbacks = providedCallbacks;\n } else if (Array.isArray(baseCallbacks)) {\n const manager = providedCallbacks.copy();\n for (const callback of baseCallbacks) {\n manager.addHandler(ensureHandler(callback), true);\n }\n copy.callbacks = manager;\n } else {\n // baseCallbacks is also a manager\n copy.callbacks = new CallbackManager(\n providedCallbacks._parentRunId,\n {\n handlers: baseCallbacks.handlers.concat(\n providedCallbacks.handlers\n ),\n inheritableHandlers: baseCallbacks.inheritableHandlers.concat(\n providedCallbacks.inheritableHandlers\n ),\n tags: Array.from(\n new Set(baseCallbacks.tags.concat(providedCallbacks.tags))\n ),\n inheritableTags: Array.from(\n new Set(\n baseCallbacks.inheritableTags.concat(\n providedCallbacks.inheritableTags\n )\n )\n ),\n metadata: {\n ...baseCallbacks.metadata,\n ...providedCallbacks.metadata,\n },\n }\n );\n }\n }\n } else {\n const typedKey = key as keyof CallOptions;\n copy[typedKey] = options[typedKey] ?? copy[typedKey];\n }\n }\n }\n return copy as Partial<CallOptions>;\n}\n\nconst PRIMITIVES = new Set([\"string\", \"number\", \"boolean\"]);\n\n/**\n * Ensure that a passed config is an object with all required keys present.\n */\nexport function ensureConfig<CallOptions extends RunnableConfig>(\n config?: CallOptions\n): CallOptions {\n const implicitConfig = AsyncLocalStorageProviderSingleton.getRunnableConfig();\n let empty: RunnableConfig = {\n tags: [],\n metadata: {},\n recursionLimit: 25,\n runId: undefined,\n };\n if (implicitConfig) {\n // Don't allow runId and runName to be loaded implicitly, as this can cause\n // child runs to improperly inherit their parents' run ids.\n const { runId, runName, ...rest } = implicitConfig;\n empty = Object.entries(rest).reduce(\n // oxlint-disable-next-line @typescript-eslint/no-explicit-any\n (currentConfig: Record<string, any>, [key, value]) => {\n if (value !== undefined) {\n currentConfig[key] = value;\n }\n return currentConfig;\n },\n empty\n );\n }\n if (config) {\n empty = Object.entries(config).reduce(\n // oxlint-disable-next-line @typescript-eslint/no-explicit-any\n (currentConfig: Record<string, any>, [key, value]) => {\n if (value !== undefined) {\n currentConfig[key] = value;\n }\n return currentConfig;\n },\n empty\n );\n }\n if (empty?.configurable) {\n for (const key of Object.keys(empty.configurable)) {\n if (\n PRIMITIVES.has(typeof empty.configurable[key]) &&\n !empty.metadata?.[key]\n ) {\n if (!empty.metadata) {\n empty.metadata = {};\n }\n empty.metadata[key] = empty.configurable[key];\n }\n }\n }\n if (empty.timeout !== undefined) {\n if (empty.timeout <= 0) {\n throw new Error(\"Timeout must be a positive number\");\n }\n const originalTimeoutMs = empty.timeout;\n const timeoutSignal = AbortSignal.timeout(originalTimeoutMs);\n // Preserve the numeric timeout for downstream consumers that need to pass\n // an explicit timeout value to underlying SDKs in addition to an AbortSignal.\n // We store it in metadata to avoid changing the public config shape.\n if (!empty.metadata) {\n empty.metadata = {};\n }\n // Do not overwrite if already set upstream.\n if (empty.metadata.timeoutMs === undefined) {\n empty.metadata.timeoutMs = originalTimeoutMs;\n }\n if (empty.signal !== undefined) {\n if (\"any\" in AbortSignal) {\n // oxlint-disable-next-line @typescript-eslint/no-explicit-any\n empty.signal = (AbortSignal as any).any([empty.signal, timeoutSignal]);\n }\n } else {\n empty.signal = timeoutSignal;\n }\n\n /**\n * We are deleting the timeout key for the following reasons:\n * - Idempotent normalization: ensureConfig may be called multiple times down the stack. If timeout remains,\n * each call would synthesize new timeout signals and combine them, changing the effective timeout unpredictably.\n * - Single enforcement path: downstream code relies on signal to enforce cancellation. Leaving timeout means two\n * competing mechanisms (numeric timeout and signal) can be applied, sometimes with different semantics.\n * - Propagation to children: pickRunnableConfigKeys would keep forwarding timeout to nested runnables, causing\n * repeated re-normalization and stacked timeouts.\n * - Backward compatibility: a lot of components and tests assume ensureConfig removes timeout post-normalization;\n * changing that would be a breaking change.\n */\n delete empty.timeout;\n }\n return empty as CallOptions;\n}\n\n/**\n * Helper function that patches runnable configs with updated properties.\n */\nexport function patchConfig<CallOptions extends RunnableConfig>(\n config: Partial<CallOptions> = {},\n {\n callbacks,\n maxConcurrency,\n recursionLimit,\n runName,\n configurable,\n runId,\n }: RunnableConfig = {}\n): Partial<CallOptions> {\n const newConfig = ensureConfig(config);\n if (callbacks !== undefined) {\n /**\n * If we're replacing callbacks we need to unset runName\n * since that should apply only to the same run as the original callbacks\n */\n delete newConfig.runName;\n newConfig.callbacks = callbacks;\n }\n if (recursionLimit !== undefined) {\n newConfig.recursionLimit = recursionLimit;\n }\n if (maxConcurrency !== undefined) {\n newConfig.maxConcurrency = maxConcurrency;\n }\n if (runName !== undefined) {\n newConfig.runName = runName;\n }\n if (configurable !== undefined) {\n newConfig.configurable = { ...newConfig.configurable, ...configurable };\n }\n if (runId !== undefined) {\n delete newConfig.runId;\n }\n return newConfig;\n}\n\n// oxlint-disable-next-line @typescript-eslint/no-explicit-any\nexport function pickRunnableConfigKeys<CallOptions extends Record<string, any>>(\n config?: CallOptions\n): Partial<RunnableConfig> | undefined {\n if (!config) return undefined;\n\n return {\n configurable: config.configurable,\n recursionLimit: config.recursionLimit,\n callbacks: config.callbacks,\n tags: config.tags,\n metadata: config.metadata,\n maxConcurrency: config.maxConcurrency,\n timeout: config.timeout,\n signal: config.signal,\n // @ts-expect-error - Store is a LangGraph-specific property\n // which wewant to pass through to all runnables.\n // (eg. tools should have access to writing to the store)\n store: config.store,\n };\n}\n"],"mappings":"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"}
|
|
1
|
+
{"version":3,"file":"config.js","names":[],"sources":["../../src/runnables/config.ts"],"sourcesContent":["import { CallbackManager, ensureHandler } from \"../callbacks/manager.js\";\nimport { AsyncLocalStorageProviderSingleton } from \"../singletons/index.js\";\nimport { RunnableConfig } from \"./types.js\";\n\nexport const DEFAULT_RECURSION_LIMIT = 25;\n\nexport { type RunnableConfig };\n\nconst CONFIGURABLE_TO_TRACING_METADATA_EXCLUDED_KEYS = new Set([\"api_key\"]);\nconst PRIMITIVES = new Set([\"string\", \"number\", \"boolean\"]);\n\nexport function _getTracingInheritableMetadataFromConfig(\n config: RunnableConfig\n): Record<string, unknown> | undefined {\n const configurable = config.configurable ?? {};\n const metadata = config.metadata ?? {};\n const langSmithMetadata: Record<string, unknown> = {};\n for (const [key, value] of Object.entries(configurable)) {\n if (\n !key.startsWith(\"__\") &&\n !Object.prototype.hasOwnProperty.call(metadata, key) &&\n !CONFIGURABLE_TO_TRACING_METADATA_EXCLUDED_KEYS.has(key) &&\n PRIMITIVES.has(typeof value)\n ) {\n langSmithMetadata[key] = value;\n }\n }\n return Object.keys(langSmithMetadata).length > 0\n ? langSmithMetadata\n : undefined;\n}\n\nexport async function getCallbackManagerForConfig(config?: RunnableConfig) {\n return CallbackManager._configureSync(\n config?.callbacks,\n undefined,\n config?.tags,\n undefined,\n config?.metadata,\n undefined,\n {\n tracerInheritableMetadata: config\n ? _getTracingInheritableMetadataFromConfig(config)\n : undefined,\n }\n );\n}\n\nexport function mergeConfigs<CallOptions extends RunnableConfig>(\n ...configs: (CallOptions | RunnableConfig | undefined | null)[]\n): Partial<CallOptions> {\n // We do not want to call ensureConfig on the empty state here as this may cause\n // double loading of callbacks if async local storage is being used.\n const copy: Partial<CallOptions> = {};\n for (const options of configs.filter((c): c is CallOptions => !!c)) {\n for (const key of Object.keys(options)) {\n if (key === \"metadata\") {\n copy[key] = { ...copy[key], ...options[key] };\n } else if (key === \"tags\") {\n const baseKeys: string[] = copy[key] ?? [];\n copy[key] = [...new Set(baseKeys.concat(options[key] ?? []))];\n } else if (key === \"configurable\") {\n copy[key] = { ...copy[key], ...options[key] };\n } else if (key === \"timeout\") {\n if (copy.timeout === undefined) {\n copy.timeout = options.timeout;\n } else if (options.timeout !== undefined) {\n copy.timeout = Math.min(copy.timeout, options.timeout);\n }\n } else if (key === \"signal\") {\n if (copy.signal === undefined) {\n copy.signal = options.signal;\n } else if (options.signal !== undefined) {\n if (\"any\" in AbortSignal) {\n // oxlint-disable-next-line @typescript-eslint/no-explicit-any\n copy.signal = (AbortSignal as any).any([\n copy.signal,\n options.signal,\n ]);\n } else {\n copy.signal = options.signal;\n }\n }\n } else if (key === \"callbacks\") {\n const baseCallbacks = copy.callbacks;\n const providedCallbacks = options.callbacks;\n // callbacks can be either undefined, Array<handler> or manager\n // so merging two callbacks values has 6 cases\n if (Array.isArray(providedCallbacks)) {\n if (!baseCallbacks) {\n copy.callbacks = providedCallbacks;\n } else if (Array.isArray(baseCallbacks)) {\n copy.callbacks = baseCallbacks.concat(providedCallbacks);\n } else {\n // baseCallbacks is a manager\n const manager = baseCallbacks.copy();\n for (const callback of providedCallbacks) {\n manager.addHandler(ensureHandler(callback), true);\n }\n copy.callbacks = manager;\n }\n } else if (providedCallbacks) {\n // providedCallbacks is a manager\n if (!baseCallbacks) {\n copy.callbacks = providedCallbacks;\n } else if (Array.isArray(baseCallbacks)) {\n const manager = providedCallbacks.copy();\n for (const callback of baseCallbacks) {\n manager.addHandler(ensureHandler(callback), true);\n }\n copy.callbacks = manager;\n } else {\n // baseCallbacks is also a manager\n copy.callbacks = new CallbackManager(\n providedCallbacks._parentRunId,\n {\n handlers: baseCallbacks.handlers.concat(\n providedCallbacks.handlers\n ),\n inheritableHandlers: baseCallbacks.inheritableHandlers.concat(\n providedCallbacks.inheritableHandlers\n ),\n tags: Array.from(\n new Set(baseCallbacks.tags.concat(providedCallbacks.tags))\n ),\n inheritableTags: Array.from(\n new Set(\n baseCallbacks.inheritableTags.concat(\n providedCallbacks.inheritableTags\n )\n )\n ),\n metadata: {\n ...baseCallbacks.metadata,\n ...providedCallbacks.metadata,\n },\n }\n );\n }\n }\n } else {\n const typedKey = key as keyof CallOptions;\n copy[typedKey] = options[typedKey] ?? copy[typedKey];\n }\n }\n }\n return copy as Partial<CallOptions>;\n}\n\n/**\n * Ensure that a passed config is an object with all required keys present.\n */\nexport function ensureConfig<CallOptions extends RunnableConfig>(\n config?: CallOptions\n): CallOptions {\n const implicitConfig = AsyncLocalStorageProviderSingleton.getRunnableConfig();\n let empty: RunnableConfig = {\n tags: [],\n metadata: {},\n recursionLimit: 25,\n runId: undefined,\n };\n if (implicitConfig) {\n // Don't allow runId and runName to be loaded implicitly, as this can cause\n // child runs to improperly inherit their parents' run ids.\n const { runId, runName, ...rest } = implicitConfig;\n empty = Object.entries(rest).reduce(\n // oxlint-disable-next-line @typescript-eslint/no-explicit-any\n (currentConfig: Record<string, any>, [key, value]) => {\n if (value !== undefined) {\n currentConfig[key] = value;\n }\n return currentConfig;\n },\n empty\n );\n }\n if (config) {\n empty = Object.entries(config).reduce(\n // oxlint-disable-next-line @typescript-eslint/no-explicit-any\n (currentConfig: Record<string, any>, [key, value]) => {\n if (value !== undefined) {\n currentConfig[key] = value;\n }\n return currentConfig;\n },\n empty\n );\n }\n if (empty?.configurable) {\n if (\n typeof empty.configurable.model === \"string\" &&\n empty.metadata?.model === undefined\n ) {\n if (!empty.metadata) {\n empty.metadata = {};\n }\n empty.metadata.model = empty.configurable.model;\n }\n }\n if (empty.timeout !== undefined) {\n if (empty.timeout <= 0) {\n throw new Error(\"Timeout must be a positive number\");\n }\n const originalTimeoutMs = empty.timeout;\n const timeoutSignal = AbortSignal.timeout(originalTimeoutMs);\n // Preserve the numeric timeout for downstream consumers that need to pass\n // an explicit timeout value to underlying SDKs in addition to an AbortSignal.\n // We store it in metadata to avoid changing the public config shape.\n if (!empty.metadata) {\n empty.metadata = {};\n }\n // Do not overwrite if already set upstream.\n if (empty.metadata.timeoutMs === undefined) {\n empty.metadata.timeoutMs = originalTimeoutMs;\n }\n if (empty.signal !== undefined) {\n if (\"any\" in AbortSignal) {\n // oxlint-disable-next-line @typescript-eslint/no-explicit-any\n empty.signal = (AbortSignal as any).any([empty.signal, timeoutSignal]);\n }\n } else {\n empty.signal = timeoutSignal;\n }\n\n /**\n * We are deleting the timeout key for the following reasons:\n * - Idempotent normalization: ensureConfig may be called multiple times down the stack. If timeout remains,\n * each call would synthesize new timeout signals and combine them, changing the effective timeout unpredictably.\n * - Single enforcement path: downstream code relies on signal to enforce cancellation. Leaving timeout means two\n * competing mechanisms (numeric timeout and signal) can be applied, sometimes with different semantics.\n * - Propagation to children: pickRunnableConfigKeys would keep forwarding timeout to nested runnables, causing\n * repeated re-normalization and stacked timeouts.\n * - Backward compatibility: a lot of components and tests assume ensureConfig removes timeout post-normalization;\n * changing that would be a breaking change.\n */\n delete empty.timeout;\n }\n return empty as CallOptions;\n}\n\n/**\n * Helper function that patches runnable configs with updated properties.\n */\nexport function patchConfig<CallOptions extends RunnableConfig>(\n config: Partial<CallOptions> = {},\n {\n callbacks,\n maxConcurrency,\n recursionLimit,\n runName,\n configurable,\n runId,\n }: RunnableConfig = {}\n): Partial<CallOptions> {\n const newConfig = ensureConfig(config);\n if (callbacks !== undefined) {\n /**\n * If we're replacing callbacks we need to unset runName\n * since that should apply only to the same run as the original callbacks\n */\n delete newConfig.runName;\n newConfig.callbacks = callbacks;\n }\n if (recursionLimit !== undefined) {\n newConfig.recursionLimit = recursionLimit;\n }\n if (maxConcurrency !== undefined) {\n newConfig.maxConcurrency = maxConcurrency;\n }\n if (runName !== undefined) {\n newConfig.runName = runName;\n }\n if (configurable !== undefined) {\n newConfig.configurable = { ...newConfig.configurable, ...configurable };\n }\n if (runId !== undefined) {\n delete newConfig.runId;\n }\n return newConfig;\n}\n\n// oxlint-disable-next-line @typescript-eslint/no-explicit-any\nexport function pickRunnableConfigKeys<CallOptions extends Record<string, any>>(\n config?: CallOptions\n): Partial<RunnableConfig> | undefined {\n if (!config) return undefined;\n\n return {\n configurable: config.configurable,\n recursionLimit: config.recursionLimit,\n callbacks: config.callbacks,\n tags: config.tags,\n metadata: config.metadata,\n maxConcurrency: config.maxConcurrency,\n timeout: config.timeout,\n signal: config.signal,\n // @ts-expect-error - Store is a LangGraph-specific property\n // which wewant to pass through to all runnables.\n // (eg. tools should have access to writing to the store)\n store: config.store,\n };\n}\n"],"mappings":";;;;AAQA,MAAM,iDAAiD,IAAI,IAAI,CAAC,UAAU,CAAC;AAC3E,MAAM,aAAa,IAAI,IAAI;CAAC;CAAU;CAAU;CAAU,CAAC;AAE3D,SAAgB,yCACd,QACqC;CACrC,MAAM,eAAe,OAAO,gBAAgB,EAAE;CAC9C,MAAM,WAAW,OAAO,YAAY,EAAE;CACtC,MAAM,oBAA6C,EAAE;AACrD,MAAK,MAAM,CAAC,KAAK,UAAU,OAAO,QAAQ,aAAa,CACrD,KACE,CAAC,IAAI,WAAW,KAAK,IACrB,CAAC,OAAO,UAAU,eAAe,KAAK,UAAU,IAAI,IACpD,CAAC,+CAA+C,IAAI,IAAI,IACxD,WAAW,IAAI,OAAO,MAAM,CAE5B,mBAAkB,OAAO;AAG7B,QAAO,OAAO,KAAK,kBAAkB,CAAC,SAAS,IAC3C,oBACA,KAAA;;AAGN,eAAsB,4BAA4B,QAAyB;AACzE,QAAO,gBAAgB,eACrB,QAAQ,WACR,KAAA,GACA,QAAQ,MACR,KAAA,GACA,QAAQ,UACR,KAAA,GACA,EACE,2BAA2B,SACvB,yCAAyC,OAAO,GAChD,KAAA,GACL,CACF;;AAGH,SAAgB,aACd,GAAG,SACmB;CAGtB,MAAM,OAA6B,EAAE;AACrC,MAAK,MAAM,WAAW,QAAQ,QAAQ,MAAwB,CAAC,CAAC,EAAE,CAChE,MAAK,MAAM,OAAO,OAAO,KAAK,QAAQ,CACpC,KAAI,QAAQ,WACV,MAAK,OAAO;EAAE,GAAG,KAAK;EAAM,GAAG,QAAQ;EAAM;UACpC,QAAQ,QAAQ;EACzB,MAAM,WAAqB,KAAK,QAAQ,EAAE;AAC1C,OAAK,OAAO,CAAC,GAAG,IAAI,IAAI,SAAS,OAAO,QAAQ,QAAQ,EAAE,CAAC,CAAC,CAAC;YACpD,QAAQ,eACjB,MAAK,OAAO;EAAE,GAAG,KAAK;EAAM,GAAG,QAAQ;EAAM;UACpC,QAAQ;MACb,KAAK,YAAY,KAAA,EACnB,MAAK,UAAU,QAAQ;WACd,QAAQ,YAAY,KAAA,EAC7B,MAAK,UAAU,KAAK,IAAI,KAAK,SAAS,QAAQ,QAAQ;YAE/C,QAAQ;MACb,KAAK,WAAW,KAAA,EAClB,MAAK,SAAS,QAAQ;WACb,QAAQ,WAAW,KAAA,EAC5B,KAAI,SAAS,YAEX,MAAK,SAAU,YAAoB,IAAI,CACrC,KAAK,QACL,QAAQ,OACT,CAAC;MAEF,MAAK,SAAS,QAAQ;YAGjB,QAAQ,aAAa;EAC9B,MAAM,gBAAgB,KAAK;EAC3B,MAAM,oBAAoB,QAAQ;AAGlC,MAAI,MAAM,QAAQ,kBAAkB,CAClC,KAAI,CAAC,cACH,MAAK,YAAY;WACR,MAAM,QAAQ,cAAc,CACrC,MAAK,YAAY,cAAc,OAAO,kBAAkB;OACnD;GAEL,MAAM,UAAU,cAAc,MAAM;AACpC,QAAK,MAAM,YAAY,kBACrB,SAAQ,WAAW,cAAc,SAAS,EAAE,KAAK;AAEnD,QAAK,YAAY;;WAEV,kBAET,KAAI,CAAC,cACH,MAAK,YAAY;WACR,MAAM,QAAQ,cAAc,EAAE;GACvC,MAAM,UAAU,kBAAkB,MAAM;AACxC,QAAK,MAAM,YAAY,cACrB,SAAQ,WAAW,cAAc,SAAS,EAAE,KAAK;AAEnD,QAAK,YAAY;QAGjB,MAAK,YAAY,IAAI,gBACnB,kBAAkB,cAClB;GACE,UAAU,cAAc,SAAS,OAC/B,kBAAkB,SACnB;GACD,qBAAqB,cAAc,oBAAoB,OACrD,kBAAkB,oBACnB;GACD,MAAM,MAAM,KACV,IAAI,IAAI,cAAc,KAAK,OAAO,kBAAkB,KAAK,CAAC,CAC3D;GACD,iBAAiB,MAAM,KACrB,IAAI,IACF,cAAc,gBAAgB,OAC5B,kBAAkB,gBACnB,CACF,CACF;GACD,UAAU;IACR,GAAG,cAAc;IACjB,GAAG,kBAAkB;IACtB;GACF,CACF;QAGA;EACL,MAAM,WAAW;AACjB,OAAK,YAAY,QAAQ,aAAa,KAAK;;AAIjD,QAAO;;;;;AAMT,SAAgB,aACd,QACa;CACb,MAAM,iBAAiB,mCAAmC,mBAAmB;CAC7E,IAAI,QAAwB;EAC1B,MAAM,EAAE;EACR,UAAU,EAAE;EACZ,gBAAgB;EAChB,OAAO,KAAA;EACR;AACD,KAAI,gBAAgB;EAGlB,MAAM,EAAE,OAAO,SAAS,GAAG,SAAS;AACpC,UAAQ,OAAO,QAAQ,KAAK,CAAC,QAE1B,eAAoC,CAAC,KAAK,WAAW;AACpD,OAAI,UAAU,KAAA,EACZ,eAAc,OAAO;AAEvB,UAAO;KAET,MACD;;AAEH,KAAI,OACF,SAAQ,OAAO,QAAQ,OAAO,CAAC,QAE5B,eAAoC,CAAC,KAAK,WAAW;AACpD,MAAI,UAAU,KAAA,EACZ,eAAc,OAAO;AAEvB,SAAO;IAET,MACD;AAEH,KAAI,OAAO;MAEP,OAAO,MAAM,aAAa,UAAU,YACpC,MAAM,UAAU,UAAU,KAAA,GAC1B;AACA,OAAI,CAAC,MAAM,SACT,OAAM,WAAW,EAAE;AAErB,SAAM,SAAS,QAAQ,MAAM,aAAa;;;AAG9C,KAAI,MAAM,YAAY,KAAA,GAAW;AAC/B,MAAI,MAAM,WAAW,EACnB,OAAM,IAAI,MAAM,oCAAoC;EAEtD,MAAM,oBAAoB,MAAM;EAChC,MAAM,gBAAgB,YAAY,QAAQ,kBAAkB;AAI5D,MAAI,CAAC,MAAM,SACT,OAAM,WAAW,EAAE;AAGrB,MAAI,MAAM,SAAS,cAAc,KAAA,EAC/B,OAAM,SAAS,YAAY;AAE7B,MAAI,MAAM,WAAW,KAAA;OACf,SAAS,YAEX,OAAM,SAAU,YAAoB,IAAI,CAAC,MAAM,QAAQ,cAAc,CAAC;QAGxE,OAAM,SAAS;;;;;;;;;;;;AAcjB,SAAO,MAAM;;AAEf,QAAO;;;;;AAMT,SAAgB,YACd,SAA+B,EAAE,EACjC,EACE,WACA,gBACA,gBACA,SACA,cACA,UACkB,EAAE,EACA;CACtB,MAAM,YAAY,aAAa,OAAO;AACtC,KAAI,cAAc,KAAA,GAAW;;;;;AAK3B,SAAO,UAAU;AACjB,YAAU,YAAY;;AAExB,KAAI,mBAAmB,KAAA,EACrB,WAAU,iBAAiB;AAE7B,KAAI,mBAAmB,KAAA,EACrB,WAAU,iBAAiB;AAE7B,KAAI,YAAY,KAAA,EACd,WAAU,UAAU;AAEtB,KAAI,iBAAiB,KAAA,EACnB,WAAU,eAAe;EAAE,GAAG,UAAU;EAAc,GAAG;EAAc;AAEzE,KAAI,UAAU,KAAA,EACZ,QAAO,UAAU;AAEnB,QAAO;;AAIT,SAAgB,uBACd,QACqC;AACrC,KAAI,CAAC,OAAQ,QAAO,KAAA;AAEpB,QAAO;EACL,cAAc,OAAO;EACrB,gBAAgB,OAAO;EACvB,WAAW,OAAO;EAClB,MAAM,OAAO;EACb,UAAU,OAAO;EACjB,gBAAgB,OAAO;EACvB,SAAS,OAAO;EAChB,QAAQ,OAAO;EAIf,OAAO,OAAO;EACf"}
|