@langchain/core 1.3.0 → 1.3.1
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 +12 -0
- package/dist/callbacks/manager.cjs +20 -3
- package/dist/callbacks/manager.cjs.map +1 -1
- package/dist/callbacks/manager.d.cts.map +1 -1
- package/dist/callbacks/manager.d.ts.map +1 -1
- package/dist/callbacks/manager.js +20 -3
- 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/graph.cjs +2 -1
- package/dist/runnables/graph.cjs.map +1 -1
- package/dist/runnables/graph.d.cts.map +1 -1
- package/dist/runnables/graph.d.ts.map +1 -1
- package/dist/runnables/graph.js +2 -1
- package/dist/runnables/graph.js.map +1 -1
- package/dist/runnables/graph_mermaid.cjs +28 -1
- package/dist/runnables/graph_mermaid.cjs.map +1 -1
- package/dist/runnables/graph_mermaid.js +28 -1
- package/dist/runnables/graph_mermaid.js.map +1 -1
- package/package.json +1 -1
package/CHANGELOG.md
CHANGED
|
@@ -1,5 +1,17 @@
|
|
|
1
1
|
# @langchain/core
|
|
2
2
|
|
|
3
|
+
## 1.3.1
|
|
4
|
+
|
|
5
|
+
### Patch Changes
|
|
6
|
+
|
|
7
|
+
- [#12026](https://github.com/langchain-ai/langchainjs/pull/12026) [`178af31`](https://github.com/langchain-ai/langchainjs/commit/178af31ee41b7e36fa2971af61ade6a5460b6d2e) Thanks [@eliornl](https://github.com/eliornl)! - fix(core): deliver callbacks once to a handler registered twice by merged configs
|
|
8
|
+
|
|
9
|
+
Merging two runnable configs that both carry the same callback handler, as happens when an agent's `streamEvents()` runs inside a LangGraph node with tracing on, registered that handler twice, so it received every callback twice: every streamed chunk arrived twice. The configured callback manager now keeps each handler once, in order, including a handler passed as a plain object of methods that merged configs wrapped twice.
|
|
10
|
+
|
|
11
|
+
- [#12042](https://github.com/langchain-ai/langchainjs/pull/12042) [`50343ba`](https://github.com/langchain-ai/langchainjs/commit/50343ba94c2388b3d3a7d4d6cd0977fa60a90294) Thanks [@sera-wi](https://github.com/sera-wi)! - fix(core): include node `metadata` in `Graph.toJSON()` output when set, matching Python
|
|
12
|
+
|
|
13
|
+
- [#12048](https://github.com/langchain-ai/langchainjs/pull/12048) [`304d190`](https://github.com/langchain-ai/langchainjs/commit/304d190a30343ecb8ae5f06081a2b5a6d93d9968) Thanks [@sera-wi](https://github.com/sera-wi)! - fix(core): escape `drawMermaid` node metadata labels and leave out object values, so metadata with brackets or objects no longer breaks Mermaid parsing
|
|
14
|
+
|
|
3
15
|
## 1.3.0
|
|
4
16
|
|
|
5
17
|
### Minor Changes
|
|
@@ -589,15 +589,32 @@ var CallbackManager = class CallbackManager extends BaseCallbackManager {
|
|
|
589
589
|
}
|
|
590
590
|
if (callbackManager) {
|
|
591
591
|
const coalesced = coalesceTracers(callbackManager.handlers, callbackManager.inheritableHandlers);
|
|
592
|
-
|
|
593
|
-
|
|
592
|
+
const inheritableHandlers = uniqueHandlers(coalesced.inheritableHandlers);
|
|
593
|
+
const inheritableBySource = new Map(inheritableHandlers.map((handler) => [handlerSource(handler), handler]));
|
|
594
|
+
callbackManager.handlers = uniqueHandlers(coalesced.handlers).map((handler) => inheritableBySource.get(handlerSource(handler)) ?? handler);
|
|
595
|
+
callbackManager.inheritableHandlers = inheritableHandlers;
|
|
594
596
|
}
|
|
595
597
|
return callbackManager;
|
|
596
598
|
}
|
|
597
599
|
};
|
|
600
|
+
const HANDLER_SOURCE = Symbol("handlerSource");
|
|
601
|
+
function handlerSource(handler) {
|
|
602
|
+
return handler[HANDLER_SOURCE] ?? handler;
|
|
603
|
+
}
|
|
604
|
+
function uniqueHandlers(handlers) {
|
|
605
|
+
const seen = /* @__PURE__ */ new Set();
|
|
606
|
+
return handlers.filter((handler) => {
|
|
607
|
+
const source = handlerSource(handler);
|
|
608
|
+
if (seen.has(source)) return false;
|
|
609
|
+
seen.add(source);
|
|
610
|
+
return true;
|
|
611
|
+
});
|
|
612
|
+
}
|
|
598
613
|
function ensureHandler(handler) {
|
|
599
614
|
if ("name" in handler) return handler;
|
|
600
|
-
|
|
615
|
+
const wrapped = require_callbacks_base.BaseCallbackHandler.fromMethods(handler);
|
|
616
|
+
Object.defineProperty(wrapped, HANDLER_SOURCE, { value: handler });
|
|
617
|
+
return wrapped;
|
|
601
618
|
}
|
|
602
619
|
//#endregion
|
|
603
620
|
exports.BaseCallbackManager = BaseCallbackManager;
|
|
@@ -1 +1 @@
|
|
|
1
|
-
{"version":3,"file":"manager.cjs","names":["candidate","LangChainTracer","consumeCallback","uuidv7","isBaseTracer","getBufferString","BaseCallbackHandler","getEnvironmentVariable","isTracingEnabled","ConsoleCallbackHandler","_getConfigureHooks","getContextVariable","isBaseCallbackHandler"],"sources":["../../src/callbacks/manager.ts"],"sourcesContent":["import { v7 as uuidv7 } from \"../utils/uuid/index.js\";\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 type { ChatModelStreamEvent } from \"../language_models/event.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\nfunction getTracerRunStoreKey(tracer: LangChainTracer): object {\n const candidate = tracer as LangChainTracer & {\n _getRunStoreKey?: () => object;\n };\n return candidate._getRunStoreKey?.() ?? tracer;\n}\n\nfunction mergeTracerConfig(\n target: LangChainTracer,\n source: LangChainTracer\n): LangChainTracer {\n if (target === source) {\n return target;\n }\n return target.copyWithTracingConfig({\n metadata: source.tracingMetadata,\n tags: source.tracingTags,\n });\n}\n\nfunction coalesceTracers(\n handlers: BaseCallbackHandler[],\n inheritableHandlers: BaseCallbackHandler[]\n): {\n handlers: BaseCallbackHandler[];\n inheritableHandlers: BaseCallbackHandler[];\n} {\n const inheritableSet = new Set<BaseCallbackHandler>(inheritableHandlers);\n const groups = new Map<\n object,\n { index: number; tracer: LangChainTracer; hasInheritable: boolean }\n >();\n const coalescedHandlers: BaseCallbackHandler[] = [];\n\n // Fold a tracer into its run-store group, keeping a single representative per\n // store (one tracer per store avoids the double-\"end\" throw). The\n // representative's tracing config is drawn from inheritable entries once any\n // exist, so a local-only tracer sharing the store cannot leak its tags or\n // metadata into child runs, which inherit `inheritableHandlers`. Stores with\n // only local entries keep merging those local entries.\n const fold = (handler: LangChainTracer) => {\n const key = getTracerRunStoreKey(handler);\n const isInheritable = inheritableSet.has(handler);\n const group = groups.get(key);\n if (group === undefined) {\n groups.set(key, {\n index: coalescedHandlers.length,\n tracer: handler,\n hasInheritable: isInheritable,\n });\n coalescedHandlers.push(handler);\n return;\n }\n\n if (isInheritable && !group.hasInheritable) {\n // First inheritable entry for this store: drop any local-only config\n // merged so far and restart from an inheritable baseline.\n group.tracer = handler;\n group.hasInheritable = true;\n } else if (isInheritable || !group.hasInheritable) {\n group.tracer = mergeTracerConfig(group.tracer, handler);\n }\n // A local entry on a store that already has inheritable config contributes\n // nothing, so its config cannot ride into children.\n coalescedHandlers[group.index] = group.tracer;\n };\n\n for (const handler of handlers) {\n if (handler instanceof LangChainTracer) {\n fold(handler);\n } else {\n coalescedHandlers.push(handler);\n }\n }\n\n // `inheritableHandlers` is a subset of `handlers` by identity, so its tracers\n // were already folded above. This only promotes an inheritable-only orphan\n // (an alias broken upstream) back into `handlers`.\n for (const handler of inheritableHandlers) {\n if (\n handler instanceof LangChainTracer &&\n !groups.has(getTracerRunStoreKey(handler))\n ) {\n fold(handler);\n }\n }\n\n const seenTracerStores = new Set<object>();\n const coalescedInheritableHandlers = inheritableHandlers.flatMap(\n (handler) => {\n if (!(handler instanceof LangChainTracer)) {\n return [handler];\n }\n\n const key = getTracerRunStoreKey(handler);\n if (seenTracerStores.has(key)) {\n return [];\n }\n seenTracerStores.add(key);\n return [groups.get(key)?.tracer ?? handler];\n }\n );\n\n return {\n handlers: coalescedHandlers,\n inheritableHandlers: coalescedInheritableHandlers,\n };\n}\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 handleChatModelStreamEvent(event: ChatModelStreamEvent): Promise<void> {\n await Promise.all(\n this.handlers.map((handler) =>\n consumeCallback(async () => {\n if (!handler.ignoreLLM) {\n try {\n await handler.handleChatModelStreamEvent?.(\n event,\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}, handleChatModelStreamEvent: ${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 | Record<string, unknown>,\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 toolCallId\n );\n }\n return consumeCallback(async () => {\n try {\n await handler.handleToolStart?.(\n tool,\n typeof input === \"string\" ? input : JSON.stringify(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 const replacements = new Map<BaseCallbackHandler, BaseCallbackHandler>();\n const applyTracingConfig = (\n handler: BaseCallbackHandler\n ): BaseCallbackHandler => {\n if (!(handler instanceof LangChainTracer)) {\n return handler;\n }\n const existing = replacements.get(handler);\n if (existing !== undefined) {\n return existing;\n }\n const replacement = handler.copyWithTracingConfig({\n metadata: tracerInheritableMetadata,\n tags: tracerInheritableTags,\n });\n replacements.set(handler, replacement);\n return replacement;\n };\n\n callbackManager.handlers =\n callbackManager.handlers.map(applyTracingConfig);\n callbackManager.inheritableHandlers =\n callbackManager.inheritableHandlers.map(applyTracingConfig);\n }\n\n if (callbackManager) {\n const coalesced = coalesceTracers(\n callbackManager.handlers,\n callbackManager.inheritableHandlers\n );\n callbackManager.handlers = coalesced.handlers;\n callbackManager.inheritableHandlers = coalesced.inheritableHandlers;\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.cjs","names":["candidate","LangChainTracer","consumeCallback","uuidv7","isBaseTracer","getBufferString","BaseCallbackHandler","getEnvironmentVariable","isTracingEnabled","ConsoleCallbackHandler","_getConfigureHooks","getContextVariable","isBaseCallbackHandler"],"sources":["../../src/callbacks/manager.ts"],"sourcesContent":["import { v7 as uuidv7 } from \"../utils/uuid/index.js\";\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 type { ChatModelStreamEvent } from \"../language_models/event.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\nfunction getTracerRunStoreKey(tracer: LangChainTracer): object {\n const candidate = tracer as LangChainTracer & {\n _getRunStoreKey?: () => object;\n };\n return candidate._getRunStoreKey?.() ?? tracer;\n}\n\nfunction mergeTracerConfig(\n target: LangChainTracer,\n source: LangChainTracer\n): LangChainTracer {\n if (target === source) {\n return target;\n }\n return target.copyWithTracingConfig({\n metadata: source.tracingMetadata,\n tags: source.tracingTags,\n });\n}\n\nfunction coalesceTracers(\n handlers: BaseCallbackHandler[],\n inheritableHandlers: BaseCallbackHandler[]\n): {\n handlers: BaseCallbackHandler[];\n inheritableHandlers: BaseCallbackHandler[];\n} {\n const inheritableSet = new Set<BaseCallbackHandler>(inheritableHandlers);\n const groups = new Map<\n object,\n { index: number; tracer: LangChainTracer; hasInheritable: boolean }\n >();\n const coalescedHandlers: BaseCallbackHandler[] = [];\n\n // Fold a tracer into its run-store group, keeping a single representative per\n // store (one tracer per store avoids the double-\"end\" throw). The\n // representative's tracing config is drawn from inheritable entries once any\n // exist, so a local-only tracer sharing the store cannot leak its tags or\n // metadata into child runs, which inherit `inheritableHandlers`. Stores with\n // only local entries keep merging those local entries.\n const fold = (handler: LangChainTracer) => {\n const key = getTracerRunStoreKey(handler);\n const isInheritable = inheritableSet.has(handler);\n const group = groups.get(key);\n if (group === undefined) {\n groups.set(key, {\n index: coalescedHandlers.length,\n tracer: handler,\n hasInheritable: isInheritable,\n });\n coalescedHandlers.push(handler);\n return;\n }\n\n if (isInheritable && !group.hasInheritable) {\n // First inheritable entry for this store: drop any local-only config\n // merged so far and restart from an inheritable baseline.\n group.tracer = handler;\n group.hasInheritable = true;\n } else if (isInheritable || !group.hasInheritable) {\n group.tracer = mergeTracerConfig(group.tracer, handler);\n }\n // A local entry on a store that already has inheritable config contributes\n // nothing, so its config cannot ride into children.\n coalescedHandlers[group.index] = group.tracer;\n };\n\n for (const handler of handlers) {\n if (handler instanceof LangChainTracer) {\n fold(handler);\n } else {\n coalescedHandlers.push(handler);\n }\n }\n\n // `inheritableHandlers` is a subset of `handlers` by identity, so its tracers\n // were already folded above. This only promotes an inheritable-only orphan\n // (an alias broken upstream) back into `handlers`.\n for (const handler of inheritableHandlers) {\n if (\n handler instanceof LangChainTracer &&\n !groups.has(getTracerRunStoreKey(handler))\n ) {\n fold(handler);\n }\n }\n\n const seenTracerStores = new Set<object>();\n const coalescedInheritableHandlers = inheritableHandlers.flatMap(\n (handler) => {\n if (!(handler instanceof LangChainTracer)) {\n return [handler];\n }\n\n const key = getTracerRunStoreKey(handler);\n if (seenTracerStores.has(key)) {\n return [];\n }\n seenTracerStores.add(key);\n return [groups.get(key)?.tracer ?? handler];\n }\n );\n\n return {\n handlers: coalescedHandlers,\n inheritableHandlers: coalescedInheritableHandlers,\n };\n}\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 handleChatModelStreamEvent(event: ChatModelStreamEvent): Promise<void> {\n await Promise.all(\n this.handlers.map((handler) =>\n consumeCallback(async () => {\n if (!handler.ignoreLLM) {\n try {\n await handler.handleChatModelStreamEvent?.(\n event,\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}, handleChatModelStreamEvent: ${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 | Record<string, unknown>,\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 toolCallId\n );\n }\n return consumeCallback(async () => {\n try {\n await handler.handleToolStart?.(\n tool,\n typeof input === \"string\" ? input : JSON.stringify(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 const replacements = new Map<BaseCallbackHandler, BaseCallbackHandler>();\n const applyTracingConfig = (\n handler: BaseCallbackHandler\n ): BaseCallbackHandler => {\n if (!(handler instanceof LangChainTracer)) {\n return handler;\n }\n const existing = replacements.get(handler);\n if (existing !== undefined) {\n return existing;\n }\n const replacement = handler.copyWithTracingConfig({\n metadata: tracerInheritableMetadata,\n tags: tracerInheritableTags,\n });\n replacements.set(handler, replacement);\n return replacement;\n };\n\n callbackManager.handlers =\n callbackManager.handlers.map(applyTracingConfig);\n callbackManager.inheritableHandlers =\n callbackManager.inheritableHandlers.map(applyTracingConfig);\n }\n\n if (callbackManager) {\n const coalesced = coalesceTracers(\n callbackManager.handlers,\n callbackManager.inheritableHandlers\n );\n // Merged configs can register one handler more than once, which would\n // deliver every callback to it that many times. Both lists keep the same\n // wrapper per handler: copy() tells inheritable handlers by identity.\n const inheritableHandlers = uniqueHandlers(coalesced.inheritableHandlers);\n const inheritableBySource = new Map(\n inheritableHandlers.map((handler) => [handlerSource(handler), handler])\n );\n callbackManager.handlers = uniqueHandlers(coalesced.handlers).map(\n (handler) => inheritableBySource.get(handlerSource(handler)) ?? handler\n );\n callbackManager.inheritableHandlers = inheritableHandlers;\n }\n\n return callbackManager;\n }\n}\n\n// Set on a wrapper to the plain object it was made from. Merged configs can\n// wrap one object twice, and configure() keeps one wrapper per object.\nconst HANDLER_SOURCE = Symbol(\"handlerSource\");\n\nfunction handlerSource(handler: BaseCallbackHandler): object {\n return (handler as { [HANDLER_SOURCE]?: object })[HANDLER_SOURCE] ?? handler;\n}\n\nfunction uniqueHandlers(\n handlers: BaseCallbackHandler[]\n): BaseCallbackHandler[] {\n const seen = new Set<object>();\n return handlers.filter((handler) => {\n const source = handlerSource(handler);\n if (seen.has(source)) return false;\n seen.add(source);\n return true;\n });\n}\n\nexport function ensureHandler(\n handler: BaseCallbackHandler | CallbackHandlerMethods\n): BaseCallbackHandler {\n if (\"name\" in handler) {\n return handler;\n }\n\n const wrapped = BaseCallbackHandler.fromMethods(handler);\n Object.defineProperty(wrapped, HANDLER_SOURCE, { value: handler });\n return wrapped;\n}\n"],"mappings":"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"}
|
|
@@ -1 +1 @@
|
|
|
1
|
-
{"version":3,"file":"manager.d.cts","names":[],"sources":["../../src/callbacks/manager.ts"],"mappings":"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
|
|
1
|
+
{"version":3,"file":"manager.d.cts","names":[],"sources":["../../src/callbacks/manager.ts"],"mappings":"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"}
|
|
@@ -1 +1 @@
|
|
|
1
|
-
{"version":3,"file":"manager.d.ts","names":[],"sources":["../../src/callbacks/manager.ts"],"mappings":"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
|
|
1
|
+
{"version":3,"file":"manager.d.ts","names":[],"sources":["../../src/callbacks/manager.ts"],"mappings":"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"}
|
|
@@ -588,15 +588,32 @@ var CallbackManager = class CallbackManager extends BaseCallbackManager {
|
|
|
588
588
|
}
|
|
589
589
|
if (callbackManager) {
|
|
590
590
|
const coalesced = coalesceTracers(callbackManager.handlers, callbackManager.inheritableHandlers);
|
|
591
|
-
|
|
592
|
-
|
|
591
|
+
const inheritableHandlers = uniqueHandlers(coalesced.inheritableHandlers);
|
|
592
|
+
const inheritableBySource = new Map(inheritableHandlers.map((handler) => [handlerSource(handler), handler]));
|
|
593
|
+
callbackManager.handlers = uniqueHandlers(coalesced.handlers).map((handler) => inheritableBySource.get(handlerSource(handler)) ?? handler);
|
|
594
|
+
callbackManager.inheritableHandlers = inheritableHandlers;
|
|
593
595
|
}
|
|
594
596
|
return callbackManager;
|
|
595
597
|
}
|
|
596
598
|
};
|
|
599
|
+
const HANDLER_SOURCE = Symbol("handlerSource");
|
|
600
|
+
function handlerSource(handler) {
|
|
601
|
+
return handler[HANDLER_SOURCE] ?? handler;
|
|
602
|
+
}
|
|
603
|
+
function uniqueHandlers(handlers) {
|
|
604
|
+
const seen = /* @__PURE__ */ new Set();
|
|
605
|
+
return handlers.filter((handler) => {
|
|
606
|
+
const source = handlerSource(handler);
|
|
607
|
+
if (seen.has(source)) return false;
|
|
608
|
+
seen.add(source);
|
|
609
|
+
return true;
|
|
610
|
+
});
|
|
611
|
+
}
|
|
597
612
|
function ensureHandler(handler) {
|
|
598
613
|
if ("name" in handler) return handler;
|
|
599
|
-
|
|
614
|
+
const wrapped = BaseCallbackHandler.fromMethods(handler);
|
|
615
|
+
Object.defineProperty(wrapped, HANDLER_SOURCE, { value: handler });
|
|
616
|
+
return wrapped;
|
|
600
617
|
}
|
|
601
618
|
//#endregion
|
|
602
619
|
export { BaseCallbackManager, BaseRunManager, CallbackManager, CallbackManagerForChainRun, CallbackManagerForLLMRun, CallbackManagerForRetrieverRun, CallbackManagerForToolRun, ensureHandler, manager_exports, parseCallbackConfigArg };
|
|
@@ -1 +1 @@
|
|
|
1
|
-
{"version":3,"file":"manager.js","names":["candidate","uuidv7"],"sources":["../../src/callbacks/manager.ts"],"sourcesContent":["import { v7 as uuidv7 } from \"../utils/uuid/index.js\";\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 type { ChatModelStreamEvent } from \"../language_models/event.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\nfunction getTracerRunStoreKey(tracer: LangChainTracer): object {\n const candidate = tracer as LangChainTracer & {\n _getRunStoreKey?: () => object;\n };\n return candidate._getRunStoreKey?.() ?? tracer;\n}\n\nfunction mergeTracerConfig(\n target: LangChainTracer,\n source: LangChainTracer\n): LangChainTracer {\n if (target === source) {\n return target;\n }\n return target.copyWithTracingConfig({\n metadata: source.tracingMetadata,\n tags: source.tracingTags,\n });\n}\n\nfunction coalesceTracers(\n handlers: BaseCallbackHandler[],\n inheritableHandlers: BaseCallbackHandler[]\n): {\n handlers: BaseCallbackHandler[];\n inheritableHandlers: BaseCallbackHandler[];\n} {\n const inheritableSet = new Set<BaseCallbackHandler>(inheritableHandlers);\n const groups = new Map<\n object,\n { index: number; tracer: LangChainTracer; hasInheritable: boolean }\n >();\n const coalescedHandlers: BaseCallbackHandler[] = [];\n\n // Fold a tracer into its run-store group, keeping a single representative per\n // store (one tracer per store avoids the double-\"end\" throw). The\n // representative's tracing config is drawn from inheritable entries once any\n // exist, so a local-only tracer sharing the store cannot leak its tags or\n // metadata into child runs, which inherit `inheritableHandlers`. Stores with\n // only local entries keep merging those local entries.\n const fold = (handler: LangChainTracer) => {\n const key = getTracerRunStoreKey(handler);\n const isInheritable = inheritableSet.has(handler);\n const group = groups.get(key);\n if (group === undefined) {\n groups.set(key, {\n index: coalescedHandlers.length,\n tracer: handler,\n hasInheritable: isInheritable,\n });\n coalescedHandlers.push(handler);\n return;\n }\n\n if (isInheritable && !group.hasInheritable) {\n // First inheritable entry for this store: drop any local-only config\n // merged so far and restart from an inheritable baseline.\n group.tracer = handler;\n group.hasInheritable = true;\n } else if (isInheritable || !group.hasInheritable) {\n group.tracer = mergeTracerConfig(group.tracer, handler);\n }\n // A local entry on a store that already has inheritable config contributes\n // nothing, so its config cannot ride into children.\n coalescedHandlers[group.index] = group.tracer;\n };\n\n for (const handler of handlers) {\n if (handler instanceof LangChainTracer) {\n fold(handler);\n } else {\n coalescedHandlers.push(handler);\n }\n }\n\n // `inheritableHandlers` is a subset of `handlers` by identity, so its tracers\n // were already folded above. This only promotes an inheritable-only orphan\n // (an alias broken upstream) back into `handlers`.\n for (const handler of inheritableHandlers) {\n if (\n handler instanceof LangChainTracer &&\n !groups.has(getTracerRunStoreKey(handler))\n ) {\n fold(handler);\n }\n }\n\n const seenTracerStores = new Set<object>();\n const coalescedInheritableHandlers = inheritableHandlers.flatMap(\n (handler) => {\n if (!(handler instanceof LangChainTracer)) {\n return [handler];\n }\n\n const key = getTracerRunStoreKey(handler);\n if (seenTracerStores.has(key)) {\n return [];\n }\n seenTracerStores.add(key);\n return [groups.get(key)?.tracer ?? handler];\n }\n );\n\n return {\n handlers: coalescedHandlers,\n inheritableHandlers: coalescedInheritableHandlers,\n };\n}\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 handleChatModelStreamEvent(event: ChatModelStreamEvent): Promise<void> {\n await Promise.all(\n this.handlers.map((handler) =>\n consumeCallback(async () => {\n if (!handler.ignoreLLM) {\n try {\n await handler.handleChatModelStreamEvent?.(\n event,\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}, handleChatModelStreamEvent: ${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 | Record<string, unknown>,\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 toolCallId\n );\n }\n return consumeCallback(async () => {\n try {\n await handler.handleToolStart?.(\n tool,\n typeof input === \"string\" ? input : JSON.stringify(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 const replacements = new Map<BaseCallbackHandler, BaseCallbackHandler>();\n const applyTracingConfig = (\n handler: BaseCallbackHandler\n ): BaseCallbackHandler => {\n if (!(handler instanceof LangChainTracer)) {\n return handler;\n }\n const existing = replacements.get(handler);\n if (existing !== undefined) {\n return existing;\n }\n const replacement = handler.copyWithTracingConfig({\n metadata: tracerInheritableMetadata,\n tags: tracerInheritableTags,\n });\n replacements.set(handler, replacement);\n return replacement;\n };\n\n callbackManager.handlers =\n callbackManager.handlers.map(applyTracingConfig);\n callbackManager.inheritableHandlers =\n callbackManager.inheritableHandlers.map(applyTracingConfig);\n }\n\n if (callbackManager) {\n const coalesced = coalesceTracers(\n callbackManager.handlers,\n callbackManager.inheritableHandlers\n );\n callbackManager.handlers = coalesced.handlers;\n callbackManager.inheritableHandlers = coalesced.inheritableHandlers;\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":["candidate","uuidv7"],"sources":["../../src/callbacks/manager.ts"],"sourcesContent":["import { v7 as uuidv7 } from \"../utils/uuid/index.js\";\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 type { ChatModelStreamEvent } from \"../language_models/event.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\nfunction getTracerRunStoreKey(tracer: LangChainTracer): object {\n const candidate = tracer as LangChainTracer & {\n _getRunStoreKey?: () => object;\n };\n return candidate._getRunStoreKey?.() ?? tracer;\n}\n\nfunction mergeTracerConfig(\n target: LangChainTracer,\n source: LangChainTracer\n): LangChainTracer {\n if (target === source) {\n return target;\n }\n return target.copyWithTracingConfig({\n metadata: source.tracingMetadata,\n tags: source.tracingTags,\n });\n}\n\nfunction coalesceTracers(\n handlers: BaseCallbackHandler[],\n inheritableHandlers: BaseCallbackHandler[]\n): {\n handlers: BaseCallbackHandler[];\n inheritableHandlers: BaseCallbackHandler[];\n} {\n const inheritableSet = new Set<BaseCallbackHandler>(inheritableHandlers);\n const groups = new Map<\n object,\n { index: number; tracer: LangChainTracer; hasInheritable: boolean }\n >();\n const coalescedHandlers: BaseCallbackHandler[] = [];\n\n // Fold a tracer into its run-store group, keeping a single representative per\n // store (one tracer per store avoids the double-\"end\" throw). The\n // representative's tracing config is drawn from inheritable entries once any\n // exist, so a local-only tracer sharing the store cannot leak its tags or\n // metadata into child runs, which inherit `inheritableHandlers`. Stores with\n // only local entries keep merging those local entries.\n const fold = (handler: LangChainTracer) => {\n const key = getTracerRunStoreKey(handler);\n const isInheritable = inheritableSet.has(handler);\n const group = groups.get(key);\n if (group === undefined) {\n groups.set(key, {\n index: coalescedHandlers.length,\n tracer: handler,\n hasInheritable: isInheritable,\n });\n coalescedHandlers.push(handler);\n return;\n }\n\n if (isInheritable && !group.hasInheritable) {\n // First inheritable entry for this store: drop any local-only config\n // merged so far and restart from an inheritable baseline.\n group.tracer = handler;\n group.hasInheritable = true;\n } else if (isInheritable || !group.hasInheritable) {\n group.tracer = mergeTracerConfig(group.tracer, handler);\n }\n // A local entry on a store that already has inheritable config contributes\n // nothing, so its config cannot ride into children.\n coalescedHandlers[group.index] = group.tracer;\n };\n\n for (const handler of handlers) {\n if (handler instanceof LangChainTracer) {\n fold(handler);\n } else {\n coalescedHandlers.push(handler);\n }\n }\n\n // `inheritableHandlers` is a subset of `handlers` by identity, so its tracers\n // were already folded above. This only promotes an inheritable-only orphan\n // (an alias broken upstream) back into `handlers`.\n for (const handler of inheritableHandlers) {\n if (\n handler instanceof LangChainTracer &&\n !groups.has(getTracerRunStoreKey(handler))\n ) {\n fold(handler);\n }\n }\n\n const seenTracerStores = new Set<object>();\n const coalescedInheritableHandlers = inheritableHandlers.flatMap(\n (handler) => {\n if (!(handler instanceof LangChainTracer)) {\n return [handler];\n }\n\n const key = getTracerRunStoreKey(handler);\n if (seenTracerStores.has(key)) {\n return [];\n }\n seenTracerStores.add(key);\n return [groups.get(key)?.tracer ?? handler];\n }\n );\n\n return {\n handlers: coalescedHandlers,\n inheritableHandlers: coalescedInheritableHandlers,\n };\n}\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 handleChatModelStreamEvent(event: ChatModelStreamEvent): Promise<void> {\n await Promise.all(\n this.handlers.map((handler) =>\n consumeCallback(async () => {\n if (!handler.ignoreLLM) {\n try {\n await handler.handleChatModelStreamEvent?.(\n event,\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}, handleChatModelStreamEvent: ${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 | Record<string, unknown>,\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 toolCallId\n );\n }\n return consumeCallback(async () => {\n try {\n await handler.handleToolStart?.(\n tool,\n typeof input === \"string\" ? input : JSON.stringify(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 const replacements = new Map<BaseCallbackHandler, BaseCallbackHandler>();\n const applyTracingConfig = (\n handler: BaseCallbackHandler\n ): BaseCallbackHandler => {\n if (!(handler instanceof LangChainTracer)) {\n return handler;\n }\n const existing = replacements.get(handler);\n if (existing !== undefined) {\n return existing;\n }\n const replacement = handler.copyWithTracingConfig({\n metadata: tracerInheritableMetadata,\n tags: tracerInheritableTags,\n });\n replacements.set(handler, replacement);\n return replacement;\n };\n\n callbackManager.handlers =\n callbackManager.handlers.map(applyTracingConfig);\n callbackManager.inheritableHandlers =\n callbackManager.inheritableHandlers.map(applyTracingConfig);\n }\n\n if (callbackManager) {\n const coalesced = coalesceTracers(\n callbackManager.handlers,\n callbackManager.inheritableHandlers\n );\n // Merged configs can register one handler more than once, which would\n // deliver every callback to it that many times. Both lists keep the same\n // wrapper per handler: copy() tells inheritable handlers by identity.\n const inheritableHandlers = uniqueHandlers(coalesced.inheritableHandlers);\n const inheritableBySource = new Map(\n inheritableHandlers.map((handler) => [handlerSource(handler), handler])\n );\n callbackManager.handlers = uniqueHandlers(coalesced.handlers).map(\n (handler) => inheritableBySource.get(handlerSource(handler)) ?? handler\n );\n callbackManager.inheritableHandlers = inheritableHandlers;\n }\n\n return callbackManager;\n }\n}\n\n// Set on a wrapper to the plain object it was made from. Merged configs can\n// wrap one object twice, and configure() keeps one wrapper per object.\nconst HANDLER_SOURCE = Symbol(\"handlerSource\");\n\nfunction handlerSource(handler: BaseCallbackHandler): object {\n return (handler as { [HANDLER_SOURCE]?: object })[HANDLER_SOURCE] ?? handler;\n}\n\nfunction uniqueHandlers(\n handlers: BaseCallbackHandler[]\n): BaseCallbackHandler[] {\n const seen = new Set<object>();\n return handlers.filter((handler) => {\n const source = handlerSource(handler);\n if (seen.has(source)) return false;\n seen.add(source);\n return true;\n });\n}\n\nexport function ensureHandler(\n handler: BaseCallbackHandler | CallbackHandlerMethods\n): BaseCallbackHandler {\n if (\"name\" in handler) {\n return handler;\n }\n\n const wrapped = BaseCallbackHandler.fromMethods(handler);\n Object.defineProperty(wrapped, HANDLER_SOURCE, { value: handler });\n return wrapped;\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.3.
|
|
142
|
+
this._addVersion("@langchain/core", "1.3.1");
|
|
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.3.
|
|
141
|
+
this._addVersion("@langchain/core", "1.3.1");
|
|
142
142
|
}
|
|
143
143
|
_addVersion(pkg, version) {
|
|
144
144
|
const existing = this.metadata?.versions;
|
package/dist/runnables/graph.cjs
CHANGED
|
@@ -48,7 +48,8 @@ var Graph = class Graph {
|
|
|
48
48
|
return {
|
|
49
49
|
nodes: Object.values(this.nodes).map((node) => ({
|
|
50
50
|
id: stableNodeIds[node.id],
|
|
51
|
-
...nodeDataJson(node)
|
|
51
|
+
...nodeDataJson(node),
|
|
52
|
+
...node.metadata != null ? { metadata: node.metadata } : {}
|
|
52
53
|
})),
|
|
53
54
|
edges: this.edges.map((edge) => {
|
|
54
55
|
const item = {
|
|
@@ -1 +1 @@
|
|
|
1
|
-
{"version":3,"file":"graph.cjs","names":["isUuid","isRunnableInterface","toJsonSchema","uuidv4","drawMermaid","drawMermaidImage"],"sources":["../../src/runnables/graph.ts"],"sourcesContent":["import { v4 as uuidv4, validate as isUuid } from \"../utils/uuid/index.js\";\nimport type {\n RunnableInterface,\n RunnableIOSchema,\n Node,\n Edge,\n} from \"./types.js\";\nimport { isRunnableInterface } from \"./utils.js\";\nimport { drawMermaid, drawMermaidImage } from \"./graph_mermaid.js\";\nimport { toJsonSchema } from \"../utils/json_schema.js\";\n\nexport { Node, Edge };\n\nfunction nodeDataStr(\n id: string | undefined,\n data: RunnableInterface | RunnableIOSchema\n): string {\n if (id !== undefined && !isUuid(id)) {\n return id;\n } else if (isRunnableInterface(data)) {\n try {\n let dataStr = data.getName();\n dataStr = dataStr.startsWith(\"Runnable\")\n ? dataStr.slice(\"Runnable\".length)\n : dataStr;\n return dataStr;\n } catch {\n return data.getName();\n }\n } else {\n return data.name ?? \"UnknownSchema\";\n }\n}\n\nfunction nodeDataJson(node: Node) {\n // if node.data implements Runnable\n if (isRunnableInterface(node.data)) {\n return {\n type: \"runnable\",\n data: {\n id: node.data.lc_id,\n name: node.data.getName(),\n },\n };\n } else {\n return {\n type: \"schema\",\n data: { ...toJsonSchema(node.data.schema), title: node.data.name },\n };\n }\n}\n\nexport class Graph {\n nodes: Record<string, Node> = {};\n\n edges: Edge[] = [];\n\n constructor(params?: { nodes: Record<string, Node>; edges: Edge[] }) {\n this.nodes = params?.nodes ?? this.nodes;\n this.edges = params?.edges ?? this.edges;\n }\n\n // Convert the graph to a JSON-serializable format.\n // oxlint-disable-next-line @typescript-eslint/no-explicit-any\n toJSON(): Record<string, any> {\n const stableNodeIds: Record<string, string | number> = {};\n Object.values(this.nodes).forEach((node, i) => {\n stableNodeIds[node.id] = isUuid(node.id) ? i : node.id;\n });\n\n return {\n nodes: Object.values(this.nodes).map((node) => ({\n id: stableNodeIds[node.id],\n ...nodeDataJson(node),\n })),\n edges: this.edges.map((edge) => {\n const item: Record<string, unknown> = {\n source: stableNodeIds[edge.source],\n target: stableNodeIds[edge.target],\n };\n\n if (typeof edge.data !== \"undefined\") {\n item.data = edge.data;\n }\n\n if (typeof edge.conditional !== \"undefined\") {\n item.conditional = edge.conditional;\n }\n return item;\n }),\n };\n }\n\n addNode(\n data: RunnableInterface | RunnableIOSchema,\n id?: string,\n // oxlint-disable-next-line @typescript-eslint/no-explicit-any\n metadata?: Record<string, any>\n ): Node {\n if (id !== undefined && this.nodes[id] !== undefined) {\n throw new Error(`Node with id ${id} already exists`);\n }\n const nodeId = id ?? uuidv4();\n const node: Node = {\n id: nodeId,\n data,\n name: nodeDataStr(id, data),\n metadata,\n };\n this.nodes[nodeId] = node;\n return node;\n }\n\n removeNode(node: Node): void {\n // Remove the node from the nodes map\n delete this.nodes[node.id];\n\n // Filter out edges connected to the node\n this.edges = this.edges.filter(\n (edge) => edge.source !== node.id && edge.target !== node.id\n );\n }\n\n addEdge(\n source: Node,\n target: Node,\n data?: string,\n conditional?: boolean\n ): Edge {\n if (this.nodes[source.id] === undefined) {\n throw new Error(`Source node ${source.id} not in graph`);\n }\n if (this.nodes[target.id] === undefined) {\n throw new Error(`Target node ${target.id} not in graph`);\n }\n const edge: Edge = {\n source: source.id,\n target: target.id,\n data,\n conditional,\n };\n this.edges.push(edge);\n return edge;\n }\n\n firstNode(): Node | undefined {\n return _firstNode(this);\n }\n\n lastNode(): Node | undefined {\n return _lastNode(this);\n }\n\n /**\n * Add all nodes and edges from another graph.\n * Note this doesn't check for duplicates, nor does it connect the graphs.\n */\n extend(graph: Graph, prefix = \"\") {\n let finalPrefix = prefix;\n const nodeIds = Object.values(graph.nodes).map((node) => node.id);\n if (nodeIds.every(isUuid)) {\n finalPrefix = \"\";\n }\n\n const prefixed = (id: string) => {\n return finalPrefix ? `${finalPrefix}:${id}` : id;\n };\n\n Object.entries(graph.nodes).forEach(([key, value]) => {\n this.nodes[prefixed(key)] = { ...value, id: prefixed(key) };\n });\n\n const newEdges = graph.edges.map((edge) => {\n return {\n ...edge,\n source: prefixed(edge.source),\n target: prefixed(edge.target),\n };\n });\n // Add all edges from the other graph\n this.edges = [...this.edges, ...newEdges];\n const first = graph.firstNode();\n const last = graph.lastNode();\n return [\n first ? { id: prefixed(first.id), data: first.data } : undefined,\n last ? { id: prefixed(last.id), data: last.data } : undefined,\n ];\n }\n\n trimFirstNode(): void {\n const firstNode = this.firstNode();\n if (firstNode && _firstNode(this, [firstNode.id])) {\n this.removeNode(firstNode);\n }\n }\n\n trimLastNode(): void {\n const lastNode = this.lastNode();\n if (lastNode && _lastNode(this, [lastNode.id])) {\n this.removeNode(lastNode);\n }\n }\n\n /**\n * Return a new graph with all nodes re-identified,\n * using their unique, readable names where possible.\n */\n reid(): Graph {\n const nodeLabels: Record<string, string> = Object.fromEntries(\n Object.values(this.nodes).map((node) => [node.id, node.name])\n );\n const nodeLabelCounts = new Map<string, number>();\n Object.values(nodeLabels).forEach((label) => {\n nodeLabelCounts.set(label, (nodeLabelCounts.get(label) || 0) + 1);\n });\n\n const getNodeId = (nodeId: string): string => {\n const label = nodeLabels[nodeId];\n if (isUuid(nodeId) && nodeLabelCounts.get(label) === 1) {\n return label;\n } else {\n return nodeId;\n }\n };\n\n return new Graph({\n nodes: Object.fromEntries(\n Object.entries(this.nodes).map(([id, node]) => [\n getNodeId(id),\n { ...node, id: getNodeId(id) },\n ])\n ),\n edges: this.edges.map((edge) => ({\n ...edge,\n source: getNodeId(edge.source),\n target: getNodeId(edge.target),\n })),\n });\n }\n\n drawMermaid(params?: {\n withStyles?: boolean;\n curveStyle?: string;\n nodeColors?: Record<string, string>;\n wrapLabelNWords?: number;\n }): string {\n const {\n withStyles,\n curveStyle,\n nodeColors = {\n default: \"fill:#f2f0ff,line-height:1.2\",\n first: \"fill-opacity:0\",\n last: \"fill:#bfb6fc\",\n },\n wrapLabelNWords,\n } = params ?? {};\n const graph = this.reid();\n const firstNode = graph.firstNode();\n\n const lastNode = graph.lastNode();\n\n return drawMermaid(graph.nodes, graph.edges, {\n firstNode: firstNode?.id,\n lastNode: lastNode?.id,\n withStyles,\n curveStyle,\n nodeColors,\n wrapLabelNWords,\n });\n }\n\n async drawMermaidPng(params?: {\n withStyles?: boolean;\n curveStyle?: string;\n nodeColors?: Record<string, string>;\n wrapLabelNWords?: number;\n backgroundColor?: string;\n }): Promise<Blob> {\n const mermaidSyntax = this.drawMermaid(params);\n return drawMermaidImage(mermaidSyntax, {\n backgroundColor: params?.backgroundColor,\n });\n }\n}\n/**\n * Find the single node that is not a target of any edge.\n * Exclude nodes/sources with ids in the exclude list.\n * If there is no such node, or there are multiple, return undefined.\n * When drawing the graph, this node would be the origin.\n */\nfunction _firstNode(graph: Graph, exclude: string[] = []): Node | undefined {\n const targets = new Set(\n graph.edges\n .filter((edge) => !exclude.includes(edge.source))\n .map((edge) => edge.target)\n );\n\n const found: Node[] = [];\n for (const node of Object.values(graph.nodes)) {\n if (!exclude.includes(node.id) && !targets.has(node.id)) {\n found.push(node);\n }\n }\n return found.length === 1 ? found[0] : undefined;\n}\n\n/**\n * Find the single node that is not a source of any edge.\n * Exclude nodes/targets with ids in the exclude list.\n * If there is no such node, or there are multiple, return undefined.\n * When drawing the graph, this node would be the destination.\n */\nfunction _lastNode(graph: Graph, exclude: string[] = []): Node | undefined {\n const sources = new Set(\n graph.edges\n .filter((edge) => !exclude.includes(edge.target))\n .map((edge) => edge.source)\n );\n\n const found: Node[] = [];\n for (const node of Object.values(graph.nodes)) {\n if (!exclude.includes(node.id) && !sources.has(node.id)) {\n found.push(node);\n }\n }\n return found.length === 1 ? found[0] : undefined;\n}\n"],"mappings":";;;;;;;;AAaA,SAAS,YACP,IACA,MACQ;CACR,IAAI,OAAO,KAAA,KAAa,CAACA,yBAAAA,SAAO,EAAE,GAChC,OAAO;MACF,IAAIC,cAAAA,oBAAoB,IAAI,GACjC,IAAI;EACF,IAAI,UAAU,KAAK,QAAQ;EAC3B,UAAU,QAAQ,WAAW,UAAU,IACnC,QAAQ,MAAM,CAAiB,IAC/B;EACJ,OAAO;CACT,QAAQ;EACN,OAAO,KAAK,QAAQ;CACtB;MAEA,OAAO,KAAK,QAAQ;AAExB;AAEA,SAAS,aAAa,MAAY;CAEhC,IAAIA,cAAAA,oBAAoB,KAAK,IAAI,GAC/B,OAAO;EACL,MAAM;EACN,MAAM;GACJ,IAAI,KAAK,KAAK;GACd,MAAM,KAAK,KAAK,QAAQ;EAC1B;CACF;MAEA,OAAO;EACL,MAAM;EACN,MAAM;GAAE,GAAGC,0BAAAA,aAAa,KAAK,KAAK,MAAM;GAAG,OAAO,KAAK,KAAK;EAAK;CACnE;AAEJ;AAEA,IAAa,QAAb,MAAa,MAAM;CACjB,QAA8B,CAAC;CAE/B,QAAgB,CAAC;CAEjB,YAAY,QAAyD;EACnE,KAAK,QAAQ,QAAQ,SAAS,KAAK;EACnC,KAAK,QAAQ,QAAQ,SAAS,KAAK;CACrC;CAIA,SAA8B;EAC5B,MAAM,gBAAiD,CAAC;EACxD,OAAO,OAAO,KAAK,KAAK,CAAC,CAAC,SAAS,MAAM,MAAM;GAC7C,cAAc,KAAK,MAAMF,yBAAAA,SAAO,KAAK,EAAE,IAAI,IAAI,KAAK;EACtD,CAAC;EAED,OAAO;GACL,OAAO,OAAO,OAAO,KAAK,KAAK,CAAC,CAAC,KAAK,UAAU;IAC9C,IAAI,cAAc,KAAK;IACvB,GAAG,aAAa,IAAI;GACtB,EAAE;GACF,OAAO,KAAK,MAAM,KAAK,SAAS;IAC9B,MAAM,OAAgC;KACpC,QAAQ,cAAc,KAAK;KAC3B,QAAQ,cAAc,KAAK;IAC7B;IAEA,IAAI,OAAO,KAAK,SAAS,aACvB,KAAK,OAAO,KAAK;IAGnB,IAAI,OAAO,KAAK,gBAAgB,aAC9B,KAAK,cAAc,KAAK;IAE1B,OAAO;GACT,CAAC;EACH;CACF;CAEA,QACE,MACA,IAEA,UACM;EACN,IAAI,OAAO,KAAA,KAAa,KAAK,MAAM,QAAQ,KAAA,GACzC,MAAM,IAAI,MAAM,gBAAgB,GAAG,gBAAgB;EAErD,MAAM,SAAS,MAAMG,yBAAAA,GAAO;EAC5B,MAAM,OAAa;GACjB,IAAI;GACJ;GACA,MAAM,YAAY,IAAI,IAAI;GAC1B;EACF;EACA,KAAK,MAAM,UAAU;EACrB,OAAO;CACT;CAEA,WAAW,MAAkB;EAE3B,OAAO,KAAK,MAAM,KAAK;EAGvB,KAAK,QAAQ,KAAK,MAAM,QACrB,SAAS,KAAK,WAAW,KAAK,MAAM,KAAK,WAAW,KAAK,EAC5D;CACF;CAEA,QACE,QACA,QACA,MACA,aACM;EACN,IAAI,KAAK,MAAM,OAAO,QAAQ,KAAA,GAC5B,MAAM,IAAI,MAAM,eAAe,OAAO,GAAG,cAAc;EAEzD,IAAI,KAAK,MAAM,OAAO,QAAQ,KAAA,GAC5B,MAAM,IAAI,MAAM,eAAe,OAAO,GAAG,cAAc;EAEzD,MAAM,OAAa;GACjB,QAAQ,OAAO;GACf,QAAQ,OAAO;GACf;GACA;EACF;EACA,KAAK,MAAM,KAAK,IAAI;EACpB,OAAO;CACT;CAEA,YAA8B;EAC5B,OAAO,WAAW,IAAI;CACxB;CAEA,WAA6B;EAC3B,OAAO,UAAU,IAAI;CACvB;;;;;CAMA,OAAO,OAAc,SAAS,IAAI;EAChC,IAAI,cAAc;EAElB,IADgB,OAAO,OAAO,MAAM,KAAK,CAAC,CAAC,KAAK,SAAS,KAAK,EACpD,CAAC,CAAC,MAAMH,yBAAAA,QAAM,GACtB,cAAc;EAGhB,MAAM,YAAY,OAAe;GAC/B,OAAO,cAAc,GAAG,YAAY,GAAG,OAAO;EAChD;EAEA,OAAO,QAAQ,MAAM,KAAK,CAAC,CAAC,SAAS,CAAC,KAAK,WAAW;GACpD,KAAK,MAAM,SAAS,GAAG,KAAK;IAAE,GAAG;IAAO,IAAI,SAAS,GAAG;GAAE;EAC5D,CAAC;EAED,MAAM,WAAW,MAAM,MAAM,KAAK,SAAS;GACzC,OAAO;IACL,GAAG;IACH,QAAQ,SAAS,KAAK,MAAM;IAC5B,QAAQ,SAAS,KAAK,MAAM;GAC9B;EACF,CAAC;EAED,KAAK,QAAQ,CAAC,GAAG,KAAK,OAAO,GAAG,QAAQ;EACxC,MAAM,QAAQ,MAAM,UAAU;EAC9B,MAAM,OAAO,MAAM,SAAS;EAC5B,OAAO,CACL,QAAQ;GAAE,IAAI,SAAS,MAAM,EAAE;GAAG,MAAM,MAAM;EAAK,IAAI,KAAA,GACvD,OAAO;GAAE,IAAI,SAAS,KAAK,EAAE;GAAG,MAAM,KAAK;EAAK,IAAI,KAAA,CACtD;CACF;CAEA,gBAAsB;EACpB,MAAM,YAAY,KAAK,UAAU;EACjC,IAAI,aAAa,WAAW,MAAM,CAAC,UAAU,EAAE,CAAC,GAC9C,KAAK,WAAW,SAAS;CAE7B;CAEA,eAAqB;EACnB,MAAM,WAAW,KAAK,SAAS;EAC/B,IAAI,YAAY,UAAU,MAAM,CAAC,SAAS,EAAE,CAAC,GAC3C,KAAK,WAAW,QAAQ;CAE5B;;;;;CAMA,OAAc;EACZ,MAAM,aAAqC,OAAO,YAChD,OAAO,OAAO,KAAK,KAAK,CAAC,CAAC,KAAK,SAAS,CAAC,KAAK,IAAI,KAAK,IAAI,CAAC,CAC9D;EACA,MAAM,kCAAkB,IAAI,IAAoB;EAChD,OAAO,OAAO,UAAU,CAAC,CAAC,SAAS,UAAU;GAC3C,gBAAgB,IAAI,QAAQ,gBAAgB,IAAI,KAAK,KAAK,KAAK,CAAC;EAClE,CAAC;EAED,MAAM,aAAa,WAA2B;GAC5C,MAAM,QAAQ,WAAW;GACzB,IAAIA,yBAAAA,SAAO,MAAM,KAAK,gBAAgB,IAAI,KAAK,MAAM,GACnD,OAAO;QAEP,OAAO;EAEX;EAEA,OAAO,IAAI,MAAM;GACf,OAAO,OAAO,YACZ,OAAO,QAAQ,KAAK,KAAK,CAAC,CAAC,KAAK,CAAC,IAAI,UAAU,CAC7C,UAAU,EAAE,GACZ;IAAE,GAAG;IAAM,IAAI,UAAU,EAAE;GAAE,CAC/B,CAAC,CACH;GACA,OAAO,KAAK,MAAM,KAAK,UAAU;IAC/B,GAAG;IACH,QAAQ,UAAU,KAAK,MAAM;IAC7B,QAAQ,UAAU,KAAK,MAAM;GAC/B,EAAE;EACJ,CAAC;CACH;CAEA,YAAY,QAKD;EACT,MAAM,EACJ,YACA,YACA,aAAa;GACX,SAAS;GACT,OAAO;GACP,MAAM;EACR,GACA,oBACE,UAAU,CAAC;EACf,MAAM,QAAQ,KAAK,KAAK;EACxB,MAAM,YAAY,MAAM,UAAU;EAElC,MAAM,WAAW,MAAM,SAAS;EAEhC,OAAOI,sBAAAA,YAAY,MAAM,OAAO,MAAM,OAAO;GAC3C,WAAW,WAAW;GACtB,UAAU,UAAU;GACpB;GACA;GACA;GACA;EACF,CAAC;CACH;CAEA,MAAM,eAAe,QAMH;EAChB,MAAM,gBAAgB,KAAK,YAAY,MAAM;EAC7C,OAAOC,sBAAAA,iBAAiB,eAAe,EACrC,iBAAiB,QAAQ,gBAC3B,CAAC;CACH;AACF;;;;;;;AAOA,SAAS,WAAW,OAAc,UAAoB,CAAC,GAAqB;CAC1E,MAAM,UAAU,IAAI,IAClB,MAAM,MACH,QAAQ,SAAS,CAAC,QAAQ,SAAS,KAAK,MAAM,CAAC,CAAC,CAChD,KAAK,SAAS,KAAK,MAAM,CAC9B;CAEA,MAAM,QAAgB,CAAC;CACvB,KAAK,MAAM,QAAQ,OAAO,OAAO,MAAM,KAAK,GAC1C,IAAI,CAAC,QAAQ,SAAS,KAAK,EAAE,KAAK,CAAC,QAAQ,IAAI,KAAK,EAAE,GACpD,MAAM,KAAK,IAAI;CAGnB,OAAO,MAAM,WAAW,IAAI,MAAM,KAAK,KAAA;AACzC;;;;;;;AAQA,SAAS,UAAU,OAAc,UAAoB,CAAC,GAAqB;CACzE,MAAM,UAAU,IAAI,IAClB,MAAM,MACH,QAAQ,SAAS,CAAC,QAAQ,SAAS,KAAK,MAAM,CAAC,CAAC,CAChD,KAAK,SAAS,KAAK,MAAM,CAC9B;CAEA,MAAM,QAAgB,CAAC;CACvB,KAAK,MAAM,QAAQ,OAAO,OAAO,MAAM,KAAK,GAC1C,IAAI,CAAC,QAAQ,SAAS,KAAK,EAAE,KAAK,CAAC,QAAQ,IAAI,KAAK,EAAE,GACpD,MAAM,KAAK,IAAI;CAGnB,OAAO,MAAM,WAAW,IAAI,MAAM,KAAK,KAAA;AACzC"}
|
|
1
|
+
{"version":3,"file":"graph.cjs","names":["isUuid","isRunnableInterface","toJsonSchema","uuidv4","drawMermaid","drawMermaidImage"],"sources":["../../src/runnables/graph.ts"],"sourcesContent":["import { v4 as uuidv4, validate as isUuid } from \"../utils/uuid/index.js\";\nimport type {\n RunnableInterface,\n RunnableIOSchema,\n Node,\n Edge,\n} from \"./types.js\";\nimport { isRunnableInterface } from \"./utils.js\";\nimport { drawMermaid, drawMermaidImage } from \"./graph_mermaid.js\";\nimport { toJsonSchema } from \"../utils/json_schema.js\";\n\nexport { Node, Edge };\n\nfunction nodeDataStr(\n id: string | undefined,\n data: RunnableInterface | RunnableIOSchema\n): string {\n if (id !== undefined && !isUuid(id)) {\n return id;\n } else if (isRunnableInterface(data)) {\n try {\n let dataStr = data.getName();\n dataStr = dataStr.startsWith(\"Runnable\")\n ? dataStr.slice(\"Runnable\".length)\n : dataStr;\n return dataStr;\n } catch {\n return data.getName();\n }\n } else {\n return data.name ?? \"UnknownSchema\";\n }\n}\n\nfunction nodeDataJson(node: Node) {\n // if node.data implements Runnable\n if (isRunnableInterface(node.data)) {\n return {\n type: \"runnable\",\n data: {\n id: node.data.lc_id,\n name: node.data.getName(),\n },\n };\n } else {\n return {\n type: \"schema\",\n data: { ...toJsonSchema(node.data.schema), title: node.data.name },\n };\n }\n}\n\nexport class Graph {\n nodes: Record<string, Node> = {};\n\n edges: Edge[] = [];\n\n constructor(params?: { nodes: Record<string, Node>; edges: Edge[] }) {\n this.nodes = params?.nodes ?? this.nodes;\n this.edges = params?.edges ?? this.edges;\n }\n\n // Convert the graph to a JSON-serializable format.\n // oxlint-disable-next-line @typescript-eslint/no-explicit-any\n toJSON(): Record<string, any> {\n const stableNodeIds: Record<string, string | number> = {};\n Object.values(this.nodes).forEach((node, i) => {\n stableNodeIds[node.id] = isUuid(node.id) ? i : node.id;\n });\n\n return {\n nodes: Object.values(this.nodes).map((node) => ({\n id: stableNodeIds[node.id],\n ...nodeDataJson(node),\n ...(node.metadata != null ? { metadata: node.metadata } : {}),\n })),\n edges: this.edges.map((edge) => {\n const item: Record<string, unknown> = {\n source: stableNodeIds[edge.source],\n target: stableNodeIds[edge.target],\n };\n\n if (typeof edge.data !== \"undefined\") {\n item.data = edge.data;\n }\n\n if (typeof edge.conditional !== \"undefined\") {\n item.conditional = edge.conditional;\n }\n return item;\n }),\n };\n }\n\n addNode(\n data: RunnableInterface | RunnableIOSchema,\n id?: string,\n // oxlint-disable-next-line @typescript-eslint/no-explicit-any\n metadata?: Record<string, any>\n ): Node {\n if (id !== undefined && this.nodes[id] !== undefined) {\n throw new Error(`Node with id ${id} already exists`);\n }\n const nodeId = id ?? uuidv4();\n const node: Node = {\n id: nodeId,\n data,\n name: nodeDataStr(id, data),\n metadata,\n };\n this.nodes[nodeId] = node;\n return node;\n }\n\n removeNode(node: Node): void {\n // Remove the node from the nodes map\n delete this.nodes[node.id];\n\n // Filter out edges connected to the node\n this.edges = this.edges.filter(\n (edge) => edge.source !== node.id && edge.target !== node.id\n );\n }\n\n addEdge(\n source: Node,\n target: Node,\n data?: string,\n conditional?: boolean\n ): Edge {\n if (this.nodes[source.id] === undefined) {\n throw new Error(`Source node ${source.id} not in graph`);\n }\n if (this.nodes[target.id] === undefined) {\n throw new Error(`Target node ${target.id} not in graph`);\n }\n const edge: Edge = {\n source: source.id,\n target: target.id,\n data,\n conditional,\n };\n this.edges.push(edge);\n return edge;\n }\n\n firstNode(): Node | undefined {\n return _firstNode(this);\n }\n\n lastNode(): Node | undefined {\n return _lastNode(this);\n }\n\n /**\n * Add all nodes and edges from another graph.\n * Note this doesn't check for duplicates, nor does it connect the graphs.\n */\n extend(graph: Graph, prefix = \"\") {\n let finalPrefix = prefix;\n const nodeIds = Object.values(graph.nodes).map((node) => node.id);\n if (nodeIds.every(isUuid)) {\n finalPrefix = \"\";\n }\n\n const prefixed = (id: string) => {\n return finalPrefix ? `${finalPrefix}:${id}` : id;\n };\n\n Object.entries(graph.nodes).forEach(([key, value]) => {\n this.nodes[prefixed(key)] = { ...value, id: prefixed(key) };\n });\n\n const newEdges = graph.edges.map((edge) => {\n return {\n ...edge,\n source: prefixed(edge.source),\n target: prefixed(edge.target),\n };\n });\n // Add all edges from the other graph\n this.edges = [...this.edges, ...newEdges];\n const first = graph.firstNode();\n const last = graph.lastNode();\n return [\n first ? { id: prefixed(first.id), data: first.data } : undefined,\n last ? { id: prefixed(last.id), data: last.data } : undefined,\n ];\n }\n\n trimFirstNode(): void {\n const firstNode = this.firstNode();\n if (firstNode && _firstNode(this, [firstNode.id])) {\n this.removeNode(firstNode);\n }\n }\n\n trimLastNode(): void {\n const lastNode = this.lastNode();\n if (lastNode && _lastNode(this, [lastNode.id])) {\n this.removeNode(lastNode);\n }\n }\n\n /**\n * Return a new graph with all nodes re-identified,\n * using their unique, readable names where possible.\n */\n reid(): Graph {\n const nodeLabels: Record<string, string> = Object.fromEntries(\n Object.values(this.nodes).map((node) => [node.id, node.name])\n );\n const nodeLabelCounts = new Map<string, number>();\n Object.values(nodeLabels).forEach((label) => {\n nodeLabelCounts.set(label, (nodeLabelCounts.get(label) || 0) + 1);\n });\n\n const getNodeId = (nodeId: string): string => {\n const label = nodeLabels[nodeId];\n if (isUuid(nodeId) && nodeLabelCounts.get(label) === 1) {\n return label;\n } else {\n return nodeId;\n }\n };\n\n return new Graph({\n nodes: Object.fromEntries(\n Object.entries(this.nodes).map(([id, node]) => [\n getNodeId(id),\n { ...node, id: getNodeId(id) },\n ])\n ),\n edges: this.edges.map((edge) => ({\n ...edge,\n source: getNodeId(edge.source),\n target: getNodeId(edge.target),\n })),\n });\n }\n\n drawMermaid(params?: {\n withStyles?: boolean;\n curveStyle?: string;\n nodeColors?: Record<string, string>;\n wrapLabelNWords?: number;\n }): string {\n const {\n withStyles,\n curveStyle,\n nodeColors = {\n default: \"fill:#f2f0ff,line-height:1.2\",\n first: \"fill-opacity:0\",\n last: \"fill:#bfb6fc\",\n },\n wrapLabelNWords,\n } = params ?? {};\n const graph = this.reid();\n const firstNode = graph.firstNode();\n\n const lastNode = graph.lastNode();\n\n return drawMermaid(graph.nodes, graph.edges, {\n firstNode: firstNode?.id,\n lastNode: lastNode?.id,\n withStyles,\n curveStyle,\n nodeColors,\n wrapLabelNWords,\n });\n }\n\n async drawMermaidPng(params?: {\n withStyles?: boolean;\n curveStyle?: string;\n nodeColors?: Record<string, string>;\n wrapLabelNWords?: number;\n backgroundColor?: string;\n }): Promise<Blob> {\n const mermaidSyntax = this.drawMermaid(params);\n return drawMermaidImage(mermaidSyntax, {\n backgroundColor: params?.backgroundColor,\n });\n }\n}\n/**\n * Find the single node that is not a target of any edge.\n * Exclude nodes/sources with ids in the exclude list.\n * If there is no such node, or there are multiple, return undefined.\n * When drawing the graph, this node would be the origin.\n */\nfunction _firstNode(graph: Graph, exclude: string[] = []): Node | undefined {\n const targets = new Set(\n graph.edges\n .filter((edge) => !exclude.includes(edge.source))\n .map((edge) => edge.target)\n );\n\n const found: Node[] = [];\n for (const node of Object.values(graph.nodes)) {\n if (!exclude.includes(node.id) && !targets.has(node.id)) {\n found.push(node);\n }\n }\n return found.length === 1 ? found[0] : undefined;\n}\n\n/**\n * Find the single node that is not a source of any edge.\n * Exclude nodes/targets with ids in the exclude list.\n * If there is no such node, or there are multiple, return undefined.\n * When drawing the graph, this node would be the destination.\n */\nfunction _lastNode(graph: Graph, exclude: string[] = []): Node | undefined {\n const sources = new Set(\n graph.edges\n .filter((edge) => !exclude.includes(edge.target))\n .map((edge) => edge.source)\n );\n\n const found: Node[] = [];\n for (const node of Object.values(graph.nodes)) {\n if (!exclude.includes(node.id) && !sources.has(node.id)) {\n found.push(node);\n }\n }\n return found.length === 1 ? found[0] : undefined;\n}\n"],"mappings":"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"}
|
|
@@ -1 +1 @@
|
|
|
1
|
-
{"version":3,"file":"graph.d.cts","names":["_$__types_js0.RunnableConfig"],"sources":["../../src/runnables/graph.ts"],"mappings":";;qBAoDa;EACX,OAAO,eAAe;EAEtB,OAAO;EAEP,YAAY;IAAW,OAAO,eAAe;IAAO,OAAO;;EAO3D,UAAU;
|
|
1
|
+
{"version":3,"file":"graph.d.cts","names":["_$__types_js0.RunnableConfig"],"sources":["../../src/runnables/graph.ts"],"mappings":";;qBAoDa;EACX,OAAO,eAAe;EAEtB,OAAO;EAEP,YAAY;IAAW,OAAO,eAAe;IAAO,OAAO;;EAO3D,UAAU;EA8BV,QACE,MAAM,oBAAoB,kBAC1B,aAEA,WAAW,sBACV;EAeH,WAAW,MAAM;EAUjB,QACE,QAAQ,MACR,QAAQ,MACR,eACA,wBACC;EAiBH,aAAa;EAIb,YAAY;;;;;EAQZ,OAAO,OAAO,OAAO;;;;EAgCrB;EAOA;;;;;EAWA,QAAQ;EAiCR,YAAY;IACV;IACA;IACA,aAAa;IACb;;EA2BI,eAAe;IACnB;IACA;IACA,aAAa;IACb;IACA;MACE,QAAQ"}
|
|
@@ -1 +1 @@
|
|
|
1
|
-
{"version":3,"file":"graph.d.ts","names":["_$__types_js0.RunnableConfig"],"sources":["../../src/runnables/graph.ts"],"mappings":";;qBAoDa;EACX,OAAO,eAAe;EAEtB,OAAO;EAEP,YAAY;IAAW,OAAO,eAAe;IAAO,OAAO;;EAO3D,UAAU;
|
|
1
|
+
{"version":3,"file":"graph.d.ts","names":["_$__types_js0.RunnableConfig"],"sources":["../../src/runnables/graph.ts"],"mappings":";;qBAoDa;EACX,OAAO,eAAe;EAEtB,OAAO;EAEP,YAAY;IAAW,OAAO,eAAe;IAAO,OAAO;;EAO3D,UAAU;EA8BV,QACE,MAAM,oBAAoB,kBAC1B,aAEA,WAAW,sBACV;EAeH,WAAW,MAAM;EAUjB,QACE,QAAQ,MACR,QAAQ,MACR,eACA,wBACC;EAiBH,aAAa;EAIb,YAAY;;;;;EAQZ,OAAO,OAAO,OAAO;;;;EAgCrB;EAOA;;;;;EAWA,QAAQ;EAiCR,YAAY;IACV;IACA;IACA,aAAa;IACb;;EA2BI,eAAe;IACnB;IACA;IACA,aAAa;IACb;IACA;MACE,QAAQ"}
|
package/dist/runnables/graph.js
CHANGED
|
@@ -47,7 +47,8 @@ var Graph = class Graph {
|
|
|
47
47
|
return {
|
|
48
48
|
nodes: Object.values(this.nodes).map((node) => ({
|
|
49
49
|
id: stableNodeIds[node.id],
|
|
50
|
-
...nodeDataJson(node)
|
|
50
|
+
...nodeDataJson(node),
|
|
51
|
+
...node.metadata != null ? { metadata: node.metadata } : {}
|
|
51
52
|
})),
|
|
52
53
|
edges: this.edges.map((edge) => {
|
|
53
54
|
const item = {
|
|
@@ -1 +1 @@
|
|
|
1
|
-
{"version":3,"file":"graph.js","names":["isUuid","uuidv4"],"sources":["../../src/runnables/graph.ts"],"sourcesContent":["import { v4 as uuidv4, validate as isUuid } from \"../utils/uuid/index.js\";\nimport type {\n RunnableInterface,\n RunnableIOSchema,\n Node,\n Edge,\n} from \"./types.js\";\nimport { isRunnableInterface } from \"./utils.js\";\nimport { drawMermaid, drawMermaidImage } from \"./graph_mermaid.js\";\nimport { toJsonSchema } from \"../utils/json_schema.js\";\n\nexport { Node, Edge };\n\nfunction nodeDataStr(\n id: string | undefined,\n data: RunnableInterface | RunnableIOSchema\n): string {\n if (id !== undefined && !isUuid(id)) {\n return id;\n } else if (isRunnableInterface(data)) {\n try {\n let dataStr = data.getName();\n dataStr = dataStr.startsWith(\"Runnable\")\n ? dataStr.slice(\"Runnable\".length)\n : dataStr;\n return dataStr;\n } catch {\n return data.getName();\n }\n } else {\n return data.name ?? \"UnknownSchema\";\n }\n}\n\nfunction nodeDataJson(node: Node) {\n // if node.data implements Runnable\n if (isRunnableInterface(node.data)) {\n return {\n type: \"runnable\",\n data: {\n id: node.data.lc_id,\n name: node.data.getName(),\n },\n };\n } else {\n return {\n type: \"schema\",\n data: { ...toJsonSchema(node.data.schema), title: node.data.name },\n };\n }\n}\n\nexport class Graph {\n nodes: Record<string, Node> = {};\n\n edges: Edge[] = [];\n\n constructor(params?: { nodes: Record<string, Node>; edges: Edge[] }) {\n this.nodes = params?.nodes ?? this.nodes;\n this.edges = params?.edges ?? this.edges;\n }\n\n // Convert the graph to a JSON-serializable format.\n // oxlint-disable-next-line @typescript-eslint/no-explicit-any\n toJSON(): Record<string, any> {\n const stableNodeIds: Record<string, string | number> = {};\n Object.values(this.nodes).forEach((node, i) => {\n stableNodeIds[node.id] = isUuid(node.id) ? i : node.id;\n });\n\n return {\n nodes: Object.values(this.nodes).map((node) => ({\n id: stableNodeIds[node.id],\n ...nodeDataJson(node),\n })),\n edges: this.edges.map((edge) => {\n const item: Record<string, unknown> = {\n source: stableNodeIds[edge.source],\n target: stableNodeIds[edge.target],\n };\n\n if (typeof edge.data !== \"undefined\") {\n item.data = edge.data;\n }\n\n if (typeof edge.conditional !== \"undefined\") {\n item.conditional = edge.conditional;\n }\n return item;\n }),\n };\n }\n\n addNode(\n data: RunnableInterface | RunnableIOSchema,\n id?: string,\n // oxlint-disable-next-line @typescript-eslint/no-explicit-any\n metadata?: Record<string, any>\n ): Node {\n if (id !== undefined && this.nodes[id] !== undefined) {\n throw new Error(`Node with id ${id} already exists`);\n }\n const nodeId = id ?? uuidv4();\n const node: Node = {\n id: nodeId,\n data,\n name: nodeDataStr(id, data),\n metadata,\n };\n this.nodes[nodeId] = node;\n return node;\n }\n\n removeNode(node: Node): void {\n // Remove the node from the nodes map\n delete this.nodes[node.id];\n\n // Filter out edges connected to the node\n this.edges = this.edges.filter(\n (edge) => edge.source !== node.id && edge.target !== node.id\n );\n }\n\n addEdge(\n source: Node,\n target: Node,\n data?: string,\n conditional?: boolean\n ): Edge {\n if (this.nodes[source.id] === undefined) {\n throw new Error(`Source node ${source.id} not in graph`);\n }\n if (this.nodes[target.id] === undefined) {\n throw new Error(`Target node ${target.id} not in graph`);\n }\n const edge: Edge = {\n source: source.id,\n target: target.id,\n data,\n conditional,\n };\n this.edges.push(edge);\n return edge;\n }\n\n firstNode(): Node | undefined {\n return _firstNode(this);\n }\n\n lastNode(): Node | undefined {\n return _lastNode(this);\n }\n\n /**\n * Add all nodes and edges from another graph.\n * Note this doesn't check for duplicates, nor does it connect the graphs.\n */\n extend(graph: Graph, prefix = \"\") {\n let finalPrefix = prefix;\n const nodeIds = Object.values(graph.nodes).map((node) => node.id);\n if (nodeIds.every(isUuid)) {\n finalPrefix = \"\";\n }\n\n const prefixed = (id: string) => {\n return finalPrefix ? `${finalPrefix}:${id}` : id;\n };\n\n Object.entries(graph.nodes).forEach(([key, value]) => {\n this.nodes[prefixed(key)] = { ...value, id: prefixed(key) };\n });\n\n const newEdges = graph.edges.map((edge) => {\n return {\n ...edge,\n source: prefixed(edge.source),\n target: prefixed(edge.target),\n };\n });\n // Add all edges from the other graph\n this.edges = [...this.edges, ...newEdges];\n const first = graph.firstNode();\n const last = graph.lastNode();\n return [\n first ? { id: prefixed(first.id), data: first.data } : undefined,\n last ? { id: prefixed(last.id), data: last.data } : undefined,\n ];\n }\n\n trimFirstNode(): void {\n const firstNode = this.firstNode();\n if (firstNode && _firstNode(this, [firstNode.id])) {\n this.removeNode(firstNode);\n }\n }\n\n trimLastNode(): void {\n const lastNode = this.lastNode();\n if (lastNode && _lastNode(this, [lastNode.id])) {\n this.removeNode(lastNode);\n }\n }\n\n /**\n * Return a new graph with all nodes re-identified,\n * using their unique, readable names where possible.\n */\n reid(): Graph {\n const nodeLabels: Record<string, string> = Object.fromEntries(\n Object.values(this.nodes).map((node) => [node.id, node.name])\n );\n const nodeLabelCounts = new Map<string, number>();\n Object.values(nodeLabels).forEach((label) => {\n nodeLabelCounts.set(label, (nodeLabelCounts.get(label) || 0) + 1);\n });\n\n const getNodeId = (nodeId: string): string => {\n const label = nodeLabels[nodeId];\n if (isUuid(nodeId) && nodeLabelCounts.get(label) === 1) {\n return label;\n } else {\n return nodeId;\n }\n };\n\n return new Graph({\n nodes: Object.fromEntries(\n Object.entries(this.nodes).map(([id, node]) => [\n getNodeId(id),\n { ...node, id: getNodeId(id) },\n ])\n ),\n edges: this.edges.map((edge) => ({\n ...edge,\n source: getNodeId(edge.source),\n target: getNodeId(edge.target),\n })),\n });\n }\n\n drawMermaid(params?: {\n withStyles?: boolean;\n curveStyle?: string;\n nodeColors?: Record<string, string>;\n wrapLabelNWords?: number;\n }): string {\n const {\n withStyles,\n curveStyle,\n nodeColors = {\n default: \"fill:#f2f0ff,line-height:1.2\",\n first: \"fill-opacity:0\",\n last: \"fill:#bfb6fc\",\n },\n wrapLabelNWords,\n } = params ?? {};\n const graph = this.reid();\n const firstNode = graph.firstNode();\n\n const lastNode = graph.lastNode();\n\n return drawMermaid(graph.nodes, graph.edges, {\n firstNode: firstNode?.id,\n lastNode: lastNode?.id,\n withStyles,\n curveStyle,\n nodeColors,\n wrapLabelNWords,\n });\n }\n\n async drawMermaidPng(params?: {\n withStyles?: boolean;\n curveStyle?: string;\n nodeColors?: Record<string, string>;\n wrapLabelNWords?: number;\n backgroundColor?: string;\n }): Promise<Blob> {\n const mermaidSyntax = this.drawMermaid(params);\n return drawMermaidImage(mermaidSyntax, {\n backgroundColor: params?.backgroundColor,\n });\n }\n}\n/**\n * Find the single node that is not a target of any edge.\n * Exclude nodes/sources with ids in the exclude list.\n * If there is no such node, or there are multiple, return undefined.\n * When drawing the graph, this node would be the origin.\n */\nfunction _firstNode(graph: Graph, exclude: string[] = []): Node | undefined {\n const targets = new Set(\n graph.edges\n .filter((edge) => !exclude.includes(edge.source))\n .map((edge) => edge.target)\n );\n\n const found: Node[] = [];\n for (const node of Object.values(graph.nodes)) {\n if (!exclude.includes(node.id) && !targets.has(node.id)) {\n found.push(node);\n }\n }\n return found.length === 1 ? found[0] : undefined;\n}\n\n/**\n * Find the single node that is not a source of any edge.\n * Exclude nodes/targets with ids in the exclude list.\n * If there is no such node, or there are multiple, return undefined.\n * When drawing the graph, this node would be the destination.\n */\nfunction _lastNode(graph: Graph, exclude: string[] = []): Node | undefined {\n const sources = new Set(\n graph.edges\n .filter((edge) => !exclude.includes(edge.target))\n .map((edge) => edge.source)\n );\n\n const found: Node[] = [];\n for (const node of Object.values(graph.nodes)) {\n if (!exclude.includes(node.id) && !sources.has(node.id)) {\n found.push(node);\n }\n }\n return found.length === 1 ? found[0] : undefined;\n}\n"],"mappings":"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"}
|
|
1
|
+
{"version":3,"file":"graph.js","names":["isUuid","uuidv4"],"sources":["../../src/runnables/graph.ts"],"sourcesContent":["import { v4 as uuidv4, validate as isUuid } from \"../utils/uuid/index.js\";\nimport type {\n RunnableInterface,\n RunnableIOSchema,\n Node,\n Edge,\n} from \"./types.js\";\nimport { isRunnableInterface } from \"./utils.js\";\nimport { drawMermaid, drawMermaidImage } from \"./graph_mermaid.js\";\nimport { toJsonSchema } from \"../utils/json_schema.js\";\n\nexport { Node, Edge };\n\nfunction nodeDataStr(\n id: string | undefined,\n data: RunnableInterface | RunnableIOSchema\n): string {\n if (id !== undefined && !isUuid(id)) {\n return id;\n } else if (isRunnableInterface(data)) {\n try {\n let dataStr = data.getName();\n dataStr = dataStr.startsWith(\"Runnable\")\n ? dataStr.slice(\"Runnable\".length)\n : dataStr;\n return dataStr;\n } catch {\n return data.getName();\n }\n } else {\n return data.name ?? \"UnknownSchema\";\n }\n}\n\nfunction nodeDataJson(node: Node) {\n // if node.data implements Runnable\n if (isRunnableInterface(node.data)) {\n return {\n type: \"runnable\",\n data: {\n id: node.data.lc_id,\n name: node.data.getName(),\n },\n };\n } else {\n return {\n type: \"schema\",\n data: { ...toJsonSchema(node.data.schema), title: node.data.name },\n };\n }\n}\n\nexport class Graph {\n nodes: Record<string, Node> = {};\n\n edges: Edge[] = [];\n\n constructor(params?: { nodes: Record<string, Node>; edges: Edge[] }) {\n this.nodes = params?.nodes ?? this.nodes;\n this.edges = params?.edges ?? this.edges;\n }\n\n // Convert the graph to a JSON-serializable format.\n // oxlint-disable-next-line @typescript-eslint/no-explicit-any\n toJSON(): Record<string, any> {\n const stableNodeIds: Record<string, string | number> = {};\n Object.values(this.nodes).forEach((node, i) => {\n stableNodeIds[node.id] = isUuid(node.id) ? i : node.id;\n });\n\n return {\n nodes: Object.values(this.nodes).map((node) => ({\n id: stableNodeIds[node.id],\n ...nodeDataJson(node),\n ...(node.metadata != null ? { metadata: node.metadata } : {}),\n })),\n edges: this.edges.map((edge) => {\n const item: Record<string, unknown> = {\n source: stableNodeIds[edge.source],\n target: stableNodeIds[edge.target],\n };\n\n if (typeof edge.data !== \"undefined\") {\n item.data = edge.data;\n }\n\n if (typeof edge.conditional !== \"undefined\") {\n item.conditional = edge.conditional;\n }\n return item;\n }),\n };\n }\n\n addNode(\n data: RunnableInterface | RunnableIOSchema,\n id?: string,\n // oxlint-disable-next-line @typescript-eslint/no-explicit-any\n metadata?: Record<string, any>\n ): Node {\n if (id !== undefined && this.nodes[id] !== undefined) {\n throw new Error(`Node with id ${id} already exists`);\n }\n const nodeId = id ?? uuidv4();\n const node: Node = {\n id: nodeId,\n data,\n name: nodeDataStr(id, data),\n metadata,\n };\n this.nodes[nodeId] = node;\n return node;\n }\n\n removeNode(node: Node): void {\n // Remove the node from the nodes map\n delete this.nodes[node.id];\n\n // Filter out edges connected to the node\n this.edges = this.edges.filter(\n (edge) => edge.source !== node.id && edge.target !== node.id\n );\n }\n\n addEdge(\n source: Node,\n target: Node,\n data?: string,\n conditional?: boolean\n ): Edge {\n if (this.nodes[source.id] === undefined) {\n throw new Error(`Source node ${source.id} not in graph`);\n }\n if (this.nodes[target.id] === undefined) {\n throw new Error(`Target node ${target.id} not in graph`);\n }\n const edge: Edge = {\n source: source.id,\n target: target.id,\n data,\n conditional,\n };\n this.edges.push(edge);\n return edge;\n }\n\n firstNode(): Node | undefined {\n return _firstNode(this);\n }\n\n lastNode(): Node | undefined {\n return _lastNode(this);\n }\n\n /**\n * Add all nodes and edges from another graph.\n * Note this doesn't check for duplicates, nor does it connect the graphs.\n */\n extend(graph: Graph, prefix = \"\") {\n let finalPrefix = prefix;\n const nodeIds = Object.values(graph.nodes).map((node) => node.id);\n if (nodeIds.every(isUuid)) {\n finalPrefix = \"\";\n }\n\n const prefixed = (id: string) => {\n return finalPrefix ? `${finalPrefix}:${id}` : id;\n };\n\n Object.entries(graph.nodes).forEach(([key, value]) => {\n this.nodes[prefixed(key)] = { ...value, id: prefixed(key) };\n });\n\n const newEdges = graph.edges.map((edge) => {\n return {\n ...edge,\n source: prefixed(edge.source),\n target: prefixed(edge.target),\n };\n });\n // Add all edges from the other graph\n this.edges = [...this.edges, ...newEdges];\n const first = graph.firstNode();\n const last = graph.lastNode();\n return [\n first ? { id: prefixed(first.id), data: first.data } : undefined,\n last ? { id: prefixed(last.id), data: last.data } : undefined,\n ];\n }\n\n trimFirstNode(): void {\n const firstNode = this.firstNode();\n if (firstNode && _firstNode(this, [firstNode.id])) {\n this.removeNode(firstNode);\n }\n }\n\n trimLastNode(): void {\n const lastNode = this.lastNode();\n if (lastNode && _lastNode(this, [lastNode.id])) {\n this.removeNode(lastNode);\n }\n }\n\n /**\n * Return a new graph with all nodes re-identified,\n * using their unique, readable names where possible.\n */\n reid(): Graph {\n const nodeLabels: Record<string, string> = Object.fromEntries(\n Object.values(this.nodes).map((node) => [node.id, node.name])\n );\n const nodeLabelCounts = new Map<string, number>();\n Object.values(nodeLabels).forEach((label) => {\n nodeLabelCounts.set(label, (nodeLabelCounts.get(label) || 0) + 1);\n });\n\n const getNodeId = (nodeId: string): string => {\n const label = nodeLabels[nodeId];\n if (isUuid(nodeId) && nodeLabelCounts.get(label) === 1) {\n return label;\n } else {\n return nodeId;\n }\n };\n\n return new Graph({\n nodes: Object.fromEntries(\n Object.entries(this.nodes).map(([id, node]) => [\n getNodeId(id),\n { ...node, id: getNodeId(id) },\n ])\n ),\n edges: this.edges.map((edge) => ({\n ...edge,\n source: getNodeId(edge.source),\n target: getNodeId(edge.target),\n })),\n });\n }\n\n drawMermaid(params?: {\n withStyles?: boolean;\n curveStyle?: string;\n nodeColors?: Record<string, string>;\n wrapLabelNWords?: number;\n }): string {\n const {\n withStyles,\n curveStyle,\n nodeColors = {\n default: \"fill:#f2f0ff,line-height:1.2\",\n first: \"fill-opacity:0\",\n last: \"fill:#bfb6fc\",\n },\n wrapLabelNWords,\n } = params ?? {};\n const graph = this.reid();\n const firstNode = graph.firstNode();\n\n const lastNode = graph.lastNode();\n\n return drawMermaid(graph.nodes, graph.edges, {\n firstNode: firstNode?.id,\n lastNode: lastNode?.id,\n withStyles,\n curveStyle,\n nodeColors,\n wrapLabelNWords,\n });\n }\n\n async drawMermaidPng(params?: {\n withStyles?: boolean;\n curveStyle?: string;\n nodeColors?: Record<string, string>;\n wrapLabelNWords?: number;\n backgroundColor?: string;\n }): Promise<Blob> {\n const mermaidSyntax = this.drawMermaid(params);\n return drawMermaidImage(mermaidSyntax, {\n backgroundColor: params?.backgroundColor,\n });\n }\n}\n/**\n * Find the single node that is not a target of any edge.\n * Exclude nodes/sources with ids in the exclude list.\n * If there is no such node, or there are multiple, return undefined.\n * When drawing the graph, this node would be the origin.\n */\nfunction _firstNode(graph: Graph, exclude: string[] = []): Node | undefined {\n const targets = new Set(\n graph.edges\n .filter((edge) => !exclude.includes(edge.source))\n .map((edge) => edge.target)\n );\n\n const found: Node[] = [];\n for (const node of Object.values(graph.nodes)) {\n if (!exclude.includes(node.id) && !targets.has(node.id)) {\n found.push(node);\n }\n }\n return found.length === 1 ? found[0] : undefined;\n}\n\n/**\n * Find the single node that is not a source of any edge.\n * Exclude nodes/targets with ids in the exclude list.\n * If there is no such node, or there are multiple, return undefined.\n * When drawing the graph, this node would be the destination.\n */\nfunction _lastNode(graph: Graph, exclude: string[] = []): Node | undefined {\n const sources = new Set(\n graph.edges\n .filter((edge) => !exclude.includes(edge.target))\n .map((edge) => edge.source)\n );\n\n const found: Node[] = [];\n for (const node of Object.values(graph.nodes)) {\n if (!exclude.includes(node.id) && !sources.has(node.id)) {\n found.push(node);\n }\n }\n return found.length === 1 ? found[0] : undefined;\n}\n"],"mappings":"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"}
|
|
@@ -8,6 +8,29 @@ const MARKDOWN_SPECIAL_CHARS = [
|
|
|
8
8
|
"_",
|
|
9
9
|
"`"
|
|
10
10
|
];
|
|
11
|
+
const MERMAID_ENTITY_CODES = {
|
|
12
|
+
"#": "#35;",
|
|
13
|
+
"[": "#91;",
|
|
14
|
+
"]": "#93;",
|
|
15
|
+
"(": "#40;",
|
|
16
|
+
")": "#41;",
|
|
17
|
+
"{": "#123;",
|
|
18
|
+
"}": "#125;",
|
|
19
|
+
"\"": "#quot;",
|
|
20
|
+
"<": "#60;",
|
|
21
|
+
">": "#62;",
|
|
22
|
+
"|": "#124;"
|
|
23
|
+
};
|
|
24
|
+
function _escapeMetadataText(text) {
|
|
25
|
+
return text.replace(/[#[\](){}"<>|]/g, (char) => MERMAID_ENTITY_CODES[char]);
|
|
26
|
+
}
|
|
27
|
+
function _isScalar(value) {
|
|
28
|
+
return typeof value === "string" || typeof value === "number" || typeof value === "boolean";
|
|
29
|
+
}
|
|
30
|
+
function _formatMetadataValue(value) {
|
|
31
|
+
if (_isScalar(value)) return String(value);
|
|
32
|
+
if (Array.isArray(value) && value.every(_isScalar)) return value.join(",");
|
|
33
|
+
}
|
|
11
34
|
function _generateMermaidGraphStyles(nodeColors) {
|
|
12
35
|
let styles = "";
|
|
13
36
|
for (const [className, color] of Object.entries(nodeColors)) styles += `\tclassDef ${className} ${color};\n`;
|
|
@@ -27,7 +50,11 @@ function drawMermaid(nodes, edges, config) {
|
|
|
27
50
|
for (const [key, node] of Object.entries(nodes)) {
|
|
28
51
|
const nodeName = node.name.split(":").pop() ?? "";
|
|
29
52
|
let finalLabel = MARKDOWN_SPECIAL_CHARS.some((char) => nodeName.startsWith(char) && nodeName.endsWith(char)) ? `<p>${nodeName}</p>` : nodeName;
|
|
30
|
-
|
|
53
|
+
const metadataLines = Object.entries(node.metadata ?? {}).flatMap(([k, v]) => {
|
|
54
|
+
const value = _formatMetadataValue(v);
|
|
55
|
+
return value === void 0 ? [] : [_escapeMetadataText(`${k} = ${value}`)];
|
|
56
|
+
});
|
|
57
|
+
if (metadataLines.length) finalLabel += `<hr/><small><em>${metadataLines.join("\n")}</em></small>`;
|
|
31
58
|
const nodeLabel = (formatDict[key] ?? formatDict[defaultClassLabel]).replace("{0}", _escapeNodeLabel(key)).replace("{1}", finalLabel);
|
|
32
59
|
mermaidGraph += `\t${nodeLabel}\n`;
|
|
33
60
|
}
|
|
@@ -1 +1 @@
|
|
|
1
|
-
{"version":3,"file":"graph_mermaid.cjs","names":["toBase64Url"],"sources":["../../src/runnables/graph_mermaid.ts"],"sourcesContent":["import { Edge, Node } from \"./types.js\";\nimport { toBase64Url } from \"./utils.js\";\n\nfunction _escapeNodeLabel(nodeLabel: string): string {\n // Escapes the node label for Mermaid syntax.\n return nodeLabel.replace(/[^a-zA-Z-_0-9]/g, \"_\");\n}\n\nconst MARKDOWN_SPECIAL_CHARS = [\"*\", \"_\", \"`\"];\n\nfunction _generateMermaidGraphStyles(\n nodeColors: Record<string, string>\n): string {\n let styles = \"\";\n for (const [className, color] of Object.entries(nodeColors)) {\n styles += `\\tclassDef ${className} ${color};\\n`;\n }\n return styles;\n}\n\n/**\n * Draws a Mermaid graph using the provided graph data\n */\nexport function drawMermaid(\n nodes: Record<string, Node>,\n edges: Edge[],\n config?: {\n firstNode?: string;\n lastNode?: string;\n curveStyle?: string;\n withStyles?: boolean;\n nodeColors?: Record<string, string>;\n wrapLabelNWords?: number;\n }\n): string {\n const {\n firstNode,\n lastNode,\n nodeColors,\n withStyles = true,\n curveStyle = \"linear\",\n wrapLabelNWords = 9,\n } = config ?? {};\n // Initialize Mermaid graph configuration\n let mermaidGraph = withStyles\n ? `%%{init: {'flowchart': {'curve': '${curveStyle}'}}}%%\\ngraph TD;\\n`\n : \"graph TD;\\n\";\n if (withStyles) {\n // Node formatting templates\n const defaultClassLabel = \"default\";\n const formatDict: Record<string, string> = {\n [defaultClassLabel]: \"{0}({1})\",\n };\n if (firstNode !== undefined) {\n formatDict[firstNode] = \"{0}([{1}]):::first\";\n }\n if (lastNode !== undefined) {\n formatDict[lastNode] = \"{0}([{1}]):::last\";\n }\n\n // Add nodes to the graph\n for (const [key, node] of Object.entries(nodes)) {\n const nodeName = node.name.split(\":\").pop() ?? \"\";\n const label = MARKDOWN_SPECIAL_CHARS.some(\n (char) => nodeName.startsWith(char) && nodeName.endsWith(char)\n )\n ? `<p>${nodeName}</p>`\n : nodeName;\n\n let finalLabel = label;\n if (Object.keys(node.metadata ?? {}).length) {\n finalLabel += `<hr/><small><em>${Object.entries(node.metadata ?? {})\n .map(([k, v]) => `${k} = ${v}`)\n .join(\"\\n\")}</em></small>`;\n }\n\n const nodeLabel = (formatDict[key] ?? formatDict[defaultClassLabel])\n .replace(\"{0}\", _escapeNodeLabel(key))\n .replace(\"{1}\", finalLabel);\n\n mermaidGraph += `\\t${nodeLabel}\\n`;\n }\n }\n\n // Group edges by their common prefixes\n const edgeGroups: Record<string, Edge[]> = {};\n for (const edge of edges) {\n const srcParts = edge.source.split(\":\");\n const tgtParts = edge.target.split(\":\");\n const commonPrefix = srcParts\n .filter((src, i) => src === tgtParts[i])\n .join(\":\");\n if (!edgeGroups[commonPrefix]) {\n edgeGroups[commonPrefix] = [];\n }\n edgeGroups[commonPrefix].push(edge);\n }\n\n const seenSubgraphs = new Set<string>();\n\n // sort prefixes by path length for correct nesting\n function sortPrefixesByDepth(prefixes: string[]): string[] {\n return [...prefixes].sort((a, b) => {\n return a.split(\":\").length - b.split(\":\").length;\n });\n }\n\n function addSubgraph(edges: Edge[], prefix: string): void {\n const selfLoop = edges.length === 1 && edges[0].source === edges[0].target;\n if (prefix && !selfLoop) {\n const subgraph = prefix.split(\":\").pop()!;\n\n if (seenSubgraphs.has(prefix)) {\n throw new Error(\n `Found duplicate subgraph '${subgraph}' at '${prefix} -- this likely means that ` +\n \"you're reusing a subgraph node with the same name. \" +\n \"Please adjust your graph to have subgraph nodes with unique names.\"\n );\n }\n\n seenSubgraphs.add(prefix);\n mermaidGraph += `\\tsubgraph ${subgraph}\\n`;\n }\n\n // all nested prefixes for this level, sorted by depth\n const nestedPrefixes = sortPrefixesByDepth(\n Object.keys(edgeGroups).filter(\n (nestedPrefix) =>\n nestedPrefix.startsWith(`${prefix}:`) &&\n nestedPrefix !== prefix &&\n nestedPrefix.split(\":\").length === prefix.split(\":\").length + 1\n )\n );\n\n for (const nestedPrefix of nestedPrefixes) {\n addSubgraph(edgeGroups[nestedPrefix], nestedPrefix);\n }\n\n for (const edge of edges) {\n const { source, target, data, conditional } = edge;\n\n let edgeLabel = \"\";\n if (data !== undefined) {\n let edgeData = data;\n const words = edgeData.split(\" \");\n if (words.length > wrapLabelNWords) {\n edgeData = Array.from(\n { length: Math.ceil(words.length / wrapLabelNWords) },\n (_, i) =>\n words\n .slice(i * wrapLabelNWords, (i + 1) * wrapLabelNWords)\n .join(\" \")\n ).join(\" <br> \");\n }\n edgeLabel = conditional\n ? ` -. ${edgeData} .-> `\n : ` -- ${edgeData} --> `;\n } else {\n edgeLabel = conditional ? \" -.-> \" : \" --> \";\n }\n\n mermaidGraph += `\\t${_escapeNodeLabel(\n source\n )}${edgeLabel}${_escapeNodeLabel(target)};\\n`;\n }\n\n if (prefix && !selfLoop) {\n mermaidGraph += \"\\tend\\n\";\n }\n }\n\n // Start with the top-level edges (no common prefix)\n addSubgraph(edgeGroups[\"\"] ?? [], \"\");\n\n // Add remaining top-level subgraphs\n for (const prefix in edgeGroups) {\n if (!prefix.includes(\":\") && prefix !== \"\") {\n addSubgraph(edgeGroups[prefix], prefix);\n }\n }\n\n // Add custom styles for nodes\n if (withStyles) {\n mermaidGraph += _generateMermaidGraphStyles(nodeColors ?? {});\n }\n\n return mermaidGraph;\n}\n\n/**\n * Renders Mermaid graph using the Mermaid.INK API.\n *\n * @example\n * ```javascript\n * const image = await drawMermaidImage(mermaidSyntax, {\n * backgroundColor: \"white\",\n * imageType: \"png\",\n * });\n * fs.writeFileSync(\"image.png\", image);\n * ```\n *\n * @param mermaidSyntax - The Mermaid syntax to render.\n * @param config - The configuration for the image.\n * @returns The image as a Blob.\n */\nexport async function drawMermaidImage(\n mermaidSyntax: string,\n config?: {\n /**\n * The type of image to render.\n * @default \"png\"\n */\n imageType?: \"png\" | \"jpeg\" | \"webp\";\n backgroundColor?: string;\n }\n) {\n let backgroundColor = config?.backgroundColor ?? \"white\";\n const imageType = config?.imageType ?? \"png\";\n\n const mermaidSyntaxEncoded = toBase64Url(mermaidSyntax);\n\n // Check if the background color is a hexadecimal color code using regex\n if (backgroundColor !== undefined) {\n const hexColorPattern = /^#(?:[0-9a-fA-F]{3}){1,2}$/;\n if (!hexColorPattern.test(backgroundColor)) {\n backgroundColor = `!${backgroundColor}`;\n }\n }\n const imageUrl = `https://mermaid.ink/img/${mermaidSyntaxEncoded}?bgColor=${backgroundColor}&type=${imageType}`;\n const res = await fetch(imageUrl);\n if (!res.ok) {\n throw new Error(\n [\n `Failed to render the graph using the Mermaid.INK API.`,\n `Status code: ${res.status}`,\n `Status text: ${res.statusText}`,\n ].join(\"\\n\")\n );\n }\n const content = await res.blob();\n return content;\n}\n"],"mappings":"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"}
|
|
1
|
+
{"version":3,"file":"graph_mermaid.cjs","names":["toBase64Url"],"sources":["../../src/runnables/graph_mermaid.ts"],"sourcesContent":["import { Edge, Node } from \"./types.js\";\nimport { toBase64Url } from \"./utils.js\";\n\nfunction _escapeNodeLabel(nodeLabel: string): string {\n // Escapes the node label for Mermaid syntax.\n return nodeLabel.replace(/[^a-zA-Z-_0-9]/g, \"_\");\n}\n\nconst MARKDOWN_SPECIAL_CHARS = [\"*\", \"_\", \"`\"];\n\nconst MERMAID_ENTITY_CODES: Record<string, string> = {\n \"#\": \"#35;\",\n \"[\": \"#91;\",\n \"]\": \"#93;\",\n \"(\": \"#40;\",\n \")\": \"#41;\",\n \"{\": \"#123;\",\n \"}\": \"#125;\",\n '\"': \"#quot;\",\n \"<\": \"#60;\",\n \">\": \"#62;\",\n \"|\": \"#124;\",\n};\n\nfunction _escapeMetadataText(text: string): string {\n return text.replace(/[#[\\](){}\"<>|]/g, (char) => MERMAID_ENTITY_CODES[char]);\n}\n\nfunction _isScalar(value: unknown): value is string | number | boolean {\n return (\n typeof value === \"string\" ||\n typeof value === \"number\" ||\n typeof value === \"boolean\"\n );\n}\n\nfunction _formatMetadataValue(value: unknown): string | undefined {\n if (_isScalar(value)) {\n return String(value);\n }\n if (Array.isArray(value) && value.every(_isScalar)) {\n return value.join(\",\");\n }\n return undefined;\n}\n\nfunction _generateMermaidGraphStyles(\n nodeColors: Record<string, string>\n): string {\n let styles = \"\";\n for (const [className, color] of Object.entries(nodeColors)) {\n styles += `\\tclassDef ${className} ${color};\\n`;\n }\n return styles;\n}\n\n/**\n * Draws a Mermaid graph using the provided graph data\n */\nexport function drawMermaid(\n nodes: Record<string, Node>,\n edges: Edge[],\n config?: {\n firstNode?: string;\n lastNode?: string;\n curveStyle?: string;\n withStyles?: boolean;\n nodeColors?: Record<string, string>;\n wrapLabelNWords?: number;\n }\n): string {\n const {\n firstNode,\n lastNode,\n nodeColors,\n withStyles = true,\n curveStyle = \"linear\",\n wrapLabelNWords = 9,\n } = config ?? {};\n // Initialize Mermaid graph configuration\n let mermaidGraph = withStyles\n ? `%%{init: {'flowchart': {'curve': '${curveStyle}'}}}%%\\ngraph TD;\\n`\n : \"graph TD;\\n\";\n if (withStyles) {\n // Node formatting templates\n const defaultClassLabel = \"default\";\n const formatDict: Record<string, string> = {\n [defaultClassLabel]: \"{0}({1})\",\n };\n if (firstNode !== undefined) {\n formatDict[firstNode] = \"{0}([{1}]):::first\";\n }\n if (lastNode !== undefined) {\n formatDict[lastNode] = \"{0}([{1}]):::last\";\n }\n\n // Add nodes to the graph\n for (const [key, node] of Object.entries(nodes)) {\n const nodeName = node.name.split(\":\").pop() ?? \"\";\n const label = MARKDOWN_SPECIAL_CHARS.some(\n (char) => nodeName.startsWith(char) && nodeName.endsWith(char)\n )\n ? `<p>${nodeName}</p>`\n : nodeName;\n\n let finalLabel = label;\n const metadataLines = Object.entries(node.metadata ?? {}).flatMap(\n ([k, v]) => {\n const value = _formatMetadataValue(v);\n return value === undefined\n ? []\n : [_escapeMetadataText(`${k} = ${value}`)];\n }\n );\n if (metadataLines.length) {\n finalLabel += `<hr/><small><em>${metadataLines.join(\n \"\\n\"\n )}</em></small>`;\n }\n\n const nodeLabel = (formatDict[key] ?? formatDict[defaultClassLabel])\n .replace(\"{0}\", _escapeNodeLabel(key))\n .replace(\"{1}\", finalLabel);\n\n mermaidGraph += `\\t${nodeLabel}\\n`;\n }\n }\n\n // Group edges by their common prefixes\n const edgeGroups: Record<string, Edge[]> = {};\n for (const edge of edges) {\n const srcParts = edge.source.split(\":\");\n const tgtParts = edge.target.split(\":\");\n const commonPrefix = srcParts\n .filter((src, i) => src === tgtParts[i])\n .join(\":\");\n if (!edgeGroups[commonPrefix]) {\n edgeGroups[commonPrefix] = [];\n }\n edgeGroups[commonPrefix].push(edge);\n }\n\n const seenSubgraphs = new Set<string>();\n\n // sort prefixes by path length for correct nesting\n function sortPrefixesByDepth(prefixes: string[]): string[] {\n return [...prefixes].sort((a, b) => {\n return a.split(\":\").length - b.split(\":\").length;\n });\n }\n\n function addSubgraph(edges: Edge[], prefix: string): void {\n const selfLoop = edges.length === 1 && edges[0].source === edges[0].target;\n if (prefix && !selfLoop) {\n const subgraph = prefix.split(\":\").pop()!;\n\n if (seenSubgraphs.has(prefix)) {\n throw new Error(\n `Found duplicate subgraph '${subgraph}' at '${prefix} -- this likely means that ` +\n \"you're reusing a subgraph node with the same name. \" +\n \"Please adjust your graph to have subgraph nodes with unique names.\"\n );\n }\n\n seenSubgraphs.add(prefix);\n mermaidGraph += `\\tsubgraph ${subgraph}\\n`;\n }\n\n // all nested prefixes for this level, sorted by depth\n const nestedPrefixes = sortPrefixesByDepth(\n Object.keys(edgeGroups).filter(\n (nestedPrefix) =>\n nestedPrefix.startsWith(`${prefix}:`) &&\n nestedPrefix !== prefix &&\n nestedPrefix.split(\":\").length === prefix.split(\":\").length + 1\n )\n );\n\n for (const nestedPrefix of nestedPrefixes) {\n addSubgraph(edgeGroups[nestedPrefix], nestedPrefix);\n }\n\n for (const edge of edges) {\n const { source, target, data, conditional } = edge;\n\n let edgeLabel = \"\";\n if (data !== undefined) {\n let edgeData = data;\n const words = edgeData.split(\" \");\n if (words.length > wrapLabelNWords) {\n edgeData = Array.from(\n { length: Math.ceil(words.length / wrapLabelNWords) },\n (_, i) =>\n words\n .slice(i * wrapLabelNWords, (i + 1) * wrapLabelNWords)\n .join(\" \")\n ).join(\" <br> \");\n }\n edgeLabel = conditional\n ? ` -. ${edgeData} .-> `\n : ` -- ${edgeData} --> `;\n } else {\n edgeLabel = conditional ? \" -.-> \" : \" --> \";\n }\n\n mermaidGraph += `\\t${_escapeNodeLabel(\n source\n )}${edgeLabel}${_escapeNodeLabel(target)};\\n`;\n }\n\n if (prefix && !selfLoop) {\n mermaidGraph += \"\\tend\\n\";\n }\n }\n\n // Start with the top-level edges (no common prefix)\n addSubgraph(edgeGroups[\"\"] ?? [], \"\");\n\n // Add remaining top-level subgraphs\n for (const prefix in edgeGroups) {\n if (!prefix.includes(\":\") && prefix !== \"\") {\n addSubgraph(edgeGroups[prefix], prefix);\n }\n }\n\n // Add custom styles for nodes\n if (withStyles) {\n mermaidGraph += _generateMermaidGraphStyles(nodeColors ?? {});\n }\n\n return mermaidGraph;\n}\n\n/**\n * Renders Mermaid graph using the Mermaid.INK API.\n *\n * @example\n * ```javascript\n * const image = await drawMermaidImage(mermaidSyntax, {\n * backgroundColor: \"white\",\n * imageType: \"png\",\n * });\n * fs.writeFileSync(\"image.png\", image);\n * ```\n *\n * @param mermaidSyntax - The Mermaid syntax to render.\n * @param config - The configuration for the image.\n * @returns The image as a Blob.\n */\nexport async function drawMermaidImage(\n mermaidSyntax: string,\n config?: {\n /**\n * The type of image to render.\n * @default \"png\"\n */\n imageType?: \"png\" | \"jpeg\" | \"webp\";\n backgroundColor?: string;\n }\n) {\n let backgroundColor = config?.backgroundColor ?? \"white\";\n const imageType = config?.imageType ?? \"png\";\n\n const mermaidSyntaxEncoded = toBase64Url(mermaidSyntax);\n\n // Check if the background color is a hexadecimal color code using regex\n if (backgroundColor !== undefined) {\n const hexColorPattern = /^#(?:[0-9a-fA-F]{3}){1,2}$/;\n if (!hexColorPattern.test(backgroundColor)) {\n backgroundColor = `!${backgroundColor}`;\n }\n }\n const imageUrl = `https://mermaid.ink/img/${mermaidSyntaxEncoded}?bgColor=${backgroundColor}&type=${imageType}`;\n const res = await fetch(imageUrl);\n if (!res.ok) {\n throw new Error(\n [\n `Failed to render the graph using the Mermaid.INK API.`,\n `Status code: ${res.status}`,\n `Status text: ${res.statusText}`,\n ].join(\"\\n\")\n );\n }\n const content = await res.blob();\n return content;\n}\n"],"mappings":"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"}
|
|
@@ -8,6 +8,29 @@ const MARKDOWN_SPECIAL_CHARS = [
|
|
|
8
8
|
"_",
|
|
9
9
|
"`"
|
|
10
10
|
];
|
|
11
|
+
const MERMAID_ENTITY_CODES = {
|
|
12
|
+
"#": "#35;",
|
|
13
|
+
"[": "#91;",
|
|
14
|
+
"]": "#93;",
|
|
15
|
+
"(": "#40;",
|
|
16
|
+
")": "#41;",
|
|
17
|
+
"{": "#123;",
|
|
18
|
+
"}": "#125;",
|
|
19
|
+
"\"": "#quot;",
|
|
20
|
+
"<": "#60;",
|
|
21
|
+
">": "#62;",
|
|
22
|
+
"|": "#124;"
|
|
23
|
+
};
|
|
24
|
+
function _escapeMetadataText(text) {
|
|
25
|
+
return text.replace(/[#[\](){}"<>|]/g, (char) => MERMAID_ENTITY_CODES[char]);
|
|
26
|
+
}
|
|
27
|
+
function _isScalar(value) {
|
|
28
|
+
return typeof value === "string" || typeof value === "number" || typeof value === "boolean";
|
|
29
|
+
}
|
|
30
|
+
function _formatMetadataValue(value) {
|
|
31
|
+
if (_isScalar(value)) return String(value);
|
|
32
|
+
if (Array.isArray(value) && value.every(_isScalar)) return value.join(",");
|
|
33
|
+
}
|
|
11
34
|
function _generateMermaidGraphStyles(nodeColors) {
|
|
12
35
|
let styles = "";
|
|
13
36
|
for (const [className, color] of Object.entries(nodeColors)) styles += `\tclassDef ${className} ${color};\n`;
|
|
@@ -27,7 +50,11 @@ function drawMermaid(nodes, edges, config) {
|
|
|
27
50
|
for (const [key, node] of Object.entries(nodes)) {
|
|
28
51
|
const nodeName = node.name.split(":").pop() ?? "";
|
|
29
52
|
let finalLabel = MARKDOWN_SPECIAL_CHARS.some((char) => nodeName.startsWith(char) && nodeName.endsWith(char)) ? `<p>${nodeName}</p>` : nodeName;
|
|
30
|
-
|
|
53
|
+
const metadataLines = Object.entries(node.metadata ?? {}).flatMap(([k, v]) => {
|
|
54
|
+
const value = _formatMetadataValue(v);
|
|
55
|
+
return value === void 0 ? [] : [_escapeMetadataText(`${k} = ${value}`)];
|
|
56
|
+
});
|
|
57
|
+
if (metadataLines.length) finalLabel += `<hr/><small><em>${metadataLines.join("\n")}</em></small>`;
|
|
31
58
|
const nodeLabel = (formatDict[key] ?? formatDict[defaultClassLabel]).replace("{0}", _escapeNodeLabel(key)).replace("{1}", finalLabel);
|
|
32
59
|
mermaidGraph += `\t${nodeLabel}\n`;
|
|
33
60
|
}
|
|
@@ -1 +1 @@
|
|
|
1
|
-
{"version":3,"file":"graph_mermaid.js","names":[],"sources":["../../src/runnables/graph_mermaid.ts"],"sourcesContent":["import { Edge, Node } from \"./types.js\";\nimport { toBase64Url } from \"./utils.js\";\n\nfunction _escapeNodeLabel(nodeLabel: string): string {\n // Escapes the node label for Mermaid syntax.\n return nodeLabel.replace(/[^a-zA-Z-_0-9]/g, \"_\");\n}\n\nconst MARKDOWN_SPECIAL_CHARS = [\"*\", \"_\", \"`\"];\n\nfunction _generateMermaidGraphStyles(\n nodeColors: Record<string, string>\n): string {\n let styles = \"\";\n for (const [className, color] of Object.entries(nodeColors)) {\n styles += `\\tclassDef ${className} ${color};\\n`;\n }\n return styles;\n}\n\n/**\n * Draws a Mermaid graph using the provided graph data\n */\nexport function drawMermaid(\n nodes: Record<string, Node>,\n edges: Edge[],\n config?: {\n firstNode?: string;\n lastNode?: string;\n curveStyle?: string;\n withStyles?: boolean;\n nodeColors?: Record<string, string>;\n wrapLabelNWords?: number;\n }\n): string {\n const {\n firstNode,\n lastNode,\n nodeColors,\n withStyles = true,\n curveStyle = \"linear\",\n wrapLabelNWords = 9,\n } = config ?? {};\n // Initialize Mermaid graph configuration\n let mermaidGraph = withStyles\n ? `%%{init: {'flowchart': {'curve': '${curveStyle}'}}}%%\\ngraph TD;\\n`\n : \"graph TD;\\n\";\n if (withStyles) {\n // Node formatting templates\n const defaultClassLabel = \"default\";\n const formatDict: Record<string, string> = {\n [defaultClassLabel]: \"{0}({1})\",\n };\n if (firstNode !== undefined) {\n formatDict[firstNode] = \"{0}([{1}]):::first\";\n }\n if (lastNode !== undefined) {\n formatDict[lastNode] = \"{0}([{1}]):::last\";\n }\n\n // Add nodes to the graph\n for (const [key, node] of Object.entries(nodes)) {\n const nodeName = node.name.split(\":\").pop() ?? \"\";\n const label = MARKDOWN_SPECIAL_CHARS.some(\n (char) => nodeName.startsWith(char) && nodeName.endsWith(char)\n )\n ? `<p>${nodeName}</p>`\n : nodeName;\n\n let finalLabel = label;\n if (Object.keys(node.metadata ?? {}).length) {\n finalLabel += `<hr/><small><em>${Object.entries(node.metadata ?? {})\n .map(([k, v]) => `${k} = ${v}`)\n .join(\"\\n\")}</em></small>`;\n }\n\n const nodeLabel = (formatDict[key] ?? formatDict[defaultClassLabel])\n .replace(\"{0}\", _escapeNodeLabel(key))\n .replace(\"{1}\", finalLabel);\n\n mermaidGraph += `\\t${nodeLabel}\\n`;\n }\n }\n\n // Group edges by their common prefixes\n const edgeGroups: Record<string, Edge[]> = {};\n for (const edge of edges) {\n const srcParts = edge.source.split(\":\");\n const tgtParts = edge.target.split(\":\");\n const commonPrefix = srcParts\n .filter((src, i) => src === tgtParts[i])\n .join(\":\");\n if (!edgeGroups[commonPrefix]) {\n edgeGroups[commonPrefix] = [];\n }\n edgeGroups[commonPrefix].push(edge);\n }\n\n const seenSubgraphs = new Set<string>();\n\n // sort prefixes by path length for correct nesting\n function sortPrefixesByDepth(prefixes: string[]): string[] {\n return [...prefixes].sort((a, b) => {\n return a.split(\":\").length - b.split(\":\").length;\n });\n }\n\n function addSubgraph(edges: Edge[], prefix: string): void {\n const selfLoop = edges.length === 1 && edges[0].source === edges[0].target;\n if (prefix && !selfLoop) {\n const subgraph = prefix.split(\":\").pop()!;\n\n if (seenSubgraphs.has(prefix)) {\n throw new Error(\n `Found duplicate subgraph '${subgraph}' at '${prefix} -- this likely means that ` +\n \"you're reusing a subgraph node with the same name. \" +\n \"Please adjust your graph to have subgraph nodes with unique names.\"\n );\n }\n\n seenSubgraphs.add(prefix);\n mermaidGraph += `\\tsubgraph ${subgraph}\\n`;\n }\n\n // all nested prefixes for this level, sorted by depth\n const nestedPrefixes = sortPrefixesByDepth(\n Object.keys(edgeGroups).filter(\n (nestedPrefix) =>\n nestedPrefix.startsWith(`${prefix}:`) &&\n nestedPrefix !== prefix &&\n nestedPrefix.split(\":\").length === prefix.split(\":\").length + 1\n )\n );\n\n for (const nestedPrefix of nestedPrefixes) {\n addSubgraph(edgeGroups[nestedPrefix], nestedPrefix);\n }\n\n for (const edge of edges) {\n const { source, target, data, conditional } = edge;\n\n let edgeLabel = \"\";\n if (data !== undefined) {\n let edgeData = data;\n const words = edgeData.split(\" \");\n if (words.length > wrapLabelNWords) {\n edgeData = Array.from(\n { length: Math.ceil(words.length / wrapLabelNWords) },\n (_, i) =>\n words\n .slice(i * wrapLabelNWords, (i + 1) * wrapLabelNWords)\n .join(\" \")\n ).join(\" <br> \");\n }\n edgeLabel = conditional\n ? ` -. ${edgeData} .-> `\n : ` -- ${edgeData} --> `;\n } else {\n edgeLabel = conditional ? \" -.-> \" : \" --> \";\n }\n\n mermaidGraph += `\\t${_escapeNodeLabel(\n source\n )}${edgeLabel}${_escapeNodeLabel(target)};\\n`;\n }\n\n if (prefix && !selfLoop) {\n mermaidGraph += \"\\tend\\n\";\n }\n }\n\n // Start with the top-level edges (no common prefix)\n addSubgraph(edgeGroups[\"\"] ?? [], \"\");\n\n // Add remaining top-level subgraphs\n for (const prefix in edgeGroups) {\n if (!prefix.includes(\":\") && prefix !== \"\") {\n addSubgraph(edgeGroups[prefix], prefix);\n }\n }\n\n // Add custom styles for nodes\n if (withStyles) {\n mermaidGraph += _generateMermaidGraphStyles(nodeColors ?? {});\n }\n\n return mermaidGraph;\n}\n\n/**\n * Renders Mermaid graph using the Mermaid.INK API.\n *\n * @example\n * ```javascript\n * const image = await drawMermaidImage(mermaidSyntax, {\n * backgroundColor: \"white\",\n * imageType: \"png\",\n * });\n * fs.writeFileSync(\"image.png\", image);\n * ```\n *\n * @param mermaidSyntax - The Mermaid syntax to render.\n * @param config - The configuration for the image.\n * @returns The image as a Blob.\n */\nexport async function drawMermaidImage(\n mermaidSyntax: string,\n config?: {\n /**\n * The type of image to render.\n * @default \"png\"\n */\n imageType?: \"png\" | \"jpeg\" | \"webp\";\n backgroundColor?: string;\n }\n) {\n let backgroundColor = config?.backgroundColor ?? \"white\";\n const imageType = config?.imageType ?? \"png\";\n\n const mermaidSyntaxEncoded = toBase64Url(mermaidSyntax);\n\n // Check if the background color is a hexadecimal color code using regex\n if (backgroundColor !== undefined) {\n const hexColorPattern = /^#(?:[0-9a-fA-F]{3}){1,2}$/;\n if (!hexColorPattern.test(backgroundColor)) {\n backgroundColor = `!${backgroundColor}`;\n }\n }\n const imageUrl = `https://mermaid.ink/img/${mermaidSyntaxEncoded}?bgColor=${backgroundColor}&type=${imageType}`;\n const res = await fetch(imageUrl);\n if (!res.ok) {\n throw new Error(\n [\n `Failed to render the graph using the Mermaid.INK API.`,\n `Status code: ${res.status}`,\n `Status text: ${res.statusText}`,\n ].join(\"\\n\")\n );\n }\n const content = await res.blob();\n return content;\n}\n"],"mappings":"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"}
|
|
1
|
+
{"version":3,"file":"graph_mermaid.js","names":[],"sources":["../../src/runnables/graph_mermaid.ts"],"sourcesContent":["import { Edge, Node } from \"./types.js\";\nimport { toBase64Url } from \"./utils.js\";\n\nfunction _escapeNodeLabel(nodeLabel: string): string {\n // Escapes the node label for Mermaid syntax.\n return nodeLabel.replace(/[^a-zA-Z-_0-9]/g, \"_\");\n}\n\nconst MARKDOWN_SPECIAL_CHARS = [\"*\", \"_\", \"`\"];\n\nconst MERMAID_ENTITY_CODES: Record<string, string> = {\n \"#\": \"#35;\",\n \"[\": \"#91;\",\n \"]\": \"#93;\",\n \"(\": \"#40;\",\n \")\": \"#41;\",\n \"{\": \"#123;\",\n \"}\": \"#125;\",\n '\"': \"#quot;\",\n \"<\": \"#60;\",\n \">\": \"#62;\",\n \"|\": \"#124;\",\n};\n\nfunction _escapeMetadataText(text: string): string {\n return text.replace(/[#[\\](){}\"<>|]/g, (char) => MERMAID_ENTITY_CODES[char]);\n}\n\nfunction _isScalar(value: unknown): value is string | number | boolean {\n return (\n typeof value === \"string\" ||\n typeof value === \"number\" ||\n typeof value === \"boolean\"\n );\n}\n\nfunction _formatMetadataValue(value: unknown): string | undefined {\n if (_isScalar(value)) {\n return String(value);\n }\n if (Array.isArray(value) && value.every(_isScalar)) {\n return value.join(\",\");\n }\n return undefined;\n}\n\nfunction _generateMermaidGraphStyles(\n nodeColors: Record<string, string>\n): string {\n let styles = \"\";\n for (const [className, color] of Object.entries(nodeColors)) {\n styles += `\\tclassDef ${className} ${color};\\n`;\n }\n return styles;\n}\n\n/**\n * Draws a Mermaid graph using the provided graph data\n */\nexport function drawMermaid(\n nodes: Record<string, Node>,\n edges: Edge[],\n config?: {\n firstNode?: string;\n lastNode?: string;\n curveStyle?: string;\n withStyles?: boolean;\n nodeColors?: Record<string, string>;\n wrapLabelNWords?: number;\n }\n): string {\n const {\n firstNode,\n lastNode,\n nodeColors,\n withStyles = true,\n curveStyle = \"linear\",\n wrapLabelNWords = 9,\n } = config ?? {};\n // Initialize Mermaid graph configuration\n let mermaidGraph = withStyles\n ? `%%{init: {'flowchart': {'curve': '${curveStyle}'}}}%%\\ngraph TD;\\n`\n : \"graph TD;\\n\";\n if (withStyles) {\n // Node formatting templates\n const defaultClassLabel = \"default\";\n const formatDict: Record<string, string> = {\n [defaultClassLabel]: \"{0}({1})\",\n };\n if (firstNode !== undefined) {\n formatDict[firstNode] = \"{0}([{1}]):::first\";\n }\n if (lastNode !== undefined) {\n formatDict[lastNode] = \"{0}([{1}]):::last\";\n }\n\n // Add nodes to the graph\n for (const [key, node] of Object.entries(nodes)) {\n const nodeName = node.name.split(\":\").pop() ?? \"\";\n const label = MARKDOWN_SPECIAL_CHARS.some(\n (char) => nodeName.startsWith(char) && nodeName.endsWith(char)\n )\n ? `<p>${nodeName}</p>`\n : nodeName;\n\n let finalLabel = label;\n const metadataLines = Object.entries(node.metadata ?? {}).flatMap(\n ([k, v]) => {\n const value = _formatMetadataValue(v);\n return value === undefined\n ? []\n : [_escapeMetadataText(`${k} = ${value}`)];\n }\n );\n if (metadataLines.length) {\n finalLabel += `<hr/><small><em>${metadataLines.join(\n \"\\n\"\n )}</em></small>`;\n }\n\n const nodeLabel = (formatDict[key] ?? formatDict[defaultClassLabel])\n .replace(\"{0}\", _escapeNodeLabel(key))\n .replace(\"{1}\", finalLabel);\n\n mermaidGraph += `\\t${nodeLabel}\\n`;\n }\n }\n\n // Group edges by their common prefixes\n const edgeGroups: Record<string, Edge[]> = {};\n for (const edge of edges) {\n const srcParts = edge.source.split(\":\");\n const tgtParts = edge.target.split(\":\");\n const commonPrefix = srcParts\n .filter((src, i) => src === tgtParts[i])\n .join(\":\");\n if (!edgeGroups[commonPrefix]) {\n edgeGroups[commonPrefix] = [];\n }\n edgeGroups[commonPrefix].push(edge);\n }\n\n const seenSubgraphs = new Set<string>();\n\n // sort prefixes by path length for correct nesting\n function sortPrefixesByDepth(prefixes: string[]): string[] {\n return [...prefixes].sort((a, b) => {\n return a.split(\":\").length - b.split(\":\").length;\n });\n }\n\n function addSubgraph(edges: Edge[], prefix: string): void {\n const selfLoop = edges.length === 1 && edges[0].source === edges[0].target;\n if (prefix && !selfLoop) {\n const subgraph = prefix.split(\":\").pop()!;\n\n if (seenSubgraphs.has(prefix)) {\n throw new Error(\n `Found duplicate subgraph '${subgraph}' at '${prefix} -- this likely means that ` +\n \"you're reusing a subgraph node with the same name. \" +\n \"Please adjust your graph to have subgraph nodes with unique names.\"\n );\n }\n\n seenSubgraphs.add(prefix);\n mermaidGraph += `\\tsubgraph ${subgraph}\\n`;\n }\n\n // all nested prefixes for this level, sorted by depth\n const nestedPrefixes = sortPrefixesByDepth(\n Object.keys(edgeGroups).filter(\n (nestedPrefix) =>\n nestedPrefix.startsWith(`${prefix}:`) &&\n nestedPrefix !== prefix &&\n nestedPrefix.split(\":\").length === prefix.split(\":\").length + 1\n )\n );\n\n for (const nestedPrefix of nestedPrefixes) {\n addSubgraph(edgeGroups[nestedPrefix], nestedPrefix);\n }\n\n for (const edge of edges) {\n const { source, target, data, conditional } = edge;\n\n let edgeLabel = \"\";\n if (data !== undefined) {\n let edgeData = data;\n const words = edgeData.split(\" \");\n if (words.length > wrapLabelNWords) {\n edgeData = Array.from(\n { length: Math.ceil(words.length / wrapLabelNWords) },\n (_, i) =>\n words\n .slice(i * wrapLabelNWords, (i + 1) * wrapLabelNWords)\n .join(\" \")\n ).join(\" <br> \");\n }\n edgeLabel = conditional\n ? ` -. ${edgeData} .-> `\n : ` -- ${edgeData} --> `;\n } else {\n edgeLabel = conditional ? \" -.-> \" : \" --> \";\n }\n\n mermaidGraph += `\\t${_escapeNodeLabel(\n source\n )}${edgeLabel}${_escapeNodeLabel(target)};\\n`;\n }\n\n if (prefix && !selfLoop) {\n mermaidGraph += \"\\tend\\n\";\n }\n }\n\n // Start with the top-level edges (no common prefix)\n addSubgraph(edgeGroups[\"\"] ?? [], \"\");\n\n // Add remaining top-level subgraphs\n for (const prefix in edgeGroups) {\n if (!prefix.includes(\":\") && prefix !== \"\") {\n addSubgraph(edgeGroups[prefix], prefix);\n }\n }\n\n // Add custom styles for nodes\n if (withStyles) {\n mermaidGraph += _generateMermaidGraphStyles(nodeColors ?? {});\n }\n\n return mermaidGraph;\n}\n\n/**\n * Renders Mermaid graph using the Mermaid.INK API.\n *\n * @example\n * ```javascript\n * const image = await drawMermaidImage(mermaidSyntax, {\n * backgroundColor: \"white\",\n * imageType: \"png\",\n * });\n * fs.writeFileSync(\"image.png\", image);\n * ```\n *\n * @param mermaidSyntax - The Mermaid syntax to render.\n * @param config - The configuration for the image.\n * @returns The image as a Blob.\n */\nexport async function drawMermaidImage(\n mermaidSyntax: string,\n config?: {\n /**\n * The type of image to render.\n * @default \"png\"\n */\n imageType?: \"png\" | \"jpeg\" | \"webp\";\n backgroundColor?: string;\n }\n) {\n let backgroundColor = config?.backgroundColor ?? \"white\";\n const imageType = config?.imageType ?? \"png\";\n\n const mermaidSyntaxEncoded = toBase64Url(mermaidSyntax);\n\n // Check if the background color is a hexadecimal color code using regex\n if (backgroundColor !== undefined) {\n const hexColorPattern = /^#(?:[0-9a-fA-F]{3}){1,2}$/;\n if (!hexColorPattern.test(backgroundColor)) {\n backgroundColor = `!${backgroundColor}`;\n }\n }\n const imageUrl = `https://mermaid.ink/img/${mermaidSyntaxEncoded}?bgColor=${backgroundColor}&type=${imageType}`;\n const res = await fetch(imageUrl);\n if (!res.ok) {\n throw new Error(\n [\n `Failed to render the graph using the Mermaid.INK API.`,\n `Status code: ${res.status}`,\n `Status text: ${res.statusText}`,\n ].join(\"\\n\")\n );\n }\n const content = await res.blob();\n return content;\n}\n"],"mappings":"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"}
|