@langchain/langgraph 0.4.8 → 1.0.0-alpha.0

package/dist/interrupt.js

@@ -1,85 +1,81 @@
-import { AsyncLocalStorageProviderSingleton } from "@langchain/core/singletons";
 import { GraphInterrupt, GraphValueError } from "./errors.js";
-import { CONFIG_KEY_CHECKPOINT_NS, CONFIG_KEY_SCRATCHPAD, CONFIG_KEY_SEND, CONFIG_KEY_CHECKPOINTER, CHECKPOINT_NAMESPACE_SEPARATOR, RESUME, } from "./constants.js";
+import { CHECKPOINT_NAMESPACE_SEPARATOR, CONFIG_KEY_CHECKPOINTER, CONFIG_KEY_CHECKPOINT_NS, CONFIG_KEY_SCRATCHPAD, CONFIG_KEY_SEND, RESUME } from "./constants.js";
 import { XXH3 } from "./hash.js";
+import { AsyncLocalStorageProviderSingleton } from "@langchain/core/singletons";
+
+//#region src/interrupt.ts
 /**
- * Interrupts the execution of a graph node.
- * This function can be used to pause execution of a node, and return the value of the `resume`
- * input when the graph is re-invoked using `Command`.
- * Multiple interrupts can be called within a single node, and each will be handled sequentially.
- *
- * When an interrupt is called:
- * 1. If there's a `resume` value available (from a previous `Command`), it returns that value.
- * 2. Otherwise, it throws a `GraphInterrupt` with the provided value
- * 3. The graph can be resumed by passing a `Command` with a `resume` value
- *
- * Because the `interrupt` function propagates by throwing a special `GraphInterrupt` error,
- * you should avoid using `try/catch` blocks around the `interrupt` function,
- * or if you do, ensure that the `GraphInterrupt` error is thrown again within your `catch` block.
- *
- * @param value - The value to include in the interrupt. This will be available in task.interrupts[].value
- * @returns The `resume` value provided when the graph is re-invoked with a Command
- *
- * @example
- * ```typescript
- * // Define a node that uses multiple interrupts
- * const nodeWithInterrupts = () => {
- *   // First interrupt - will pause execution and include {value: 1} in task values
- *   const answer1 = interrupt({ value: 1 });
- *
- *   // Second interrupt - only called after first interrupt is resumed
- *   const answer2 = interrupt({ value: 2 });
- *
- *   // Use the resume values
- *   return { myKey: answer1 + " " + answer2 };
- * };
- *
- * // Resume the graph after first interrupt
- * await graph.stream(new Command({ resume: "answer 1" }));
- *
- * // Resume the graph after second interrupt
- * await graph.stream(new Command({ resume: "answer 2" }));
- * // Final result: { myKey: "answer 1 answer 2" }
- * ```
- *
- * @throws {Error} If called outside the context of a graph
- * @throws {GraphInterrupt} When no resume value is available
- */
-// eslint-disable-next-line @typescript-eslint/no-explicit-any
-export function interrupt(value) {
-    const config = AsyncLocalStorageProviderSingleton.getRunnableConfig();
-    if (!config) {
-        throw new Error("Called interrupt() outside the context of a graph.");
-    }
-    const conf = config.configurable;
-    if (!conf) {
-        throw new Error("No configurable found in config");
-    }
-    const checkpointer = conf[CONFIG_KEY_CHECKPOINTER];
-    if (!checkpointer)
-        throw new GraphValueError("No checkpointer set");
-    // Track interrupt index
-    const scratchpad = conf[CONFIG_KEY_SCRATCHPAD];
-    scratchpad.interruptCounter += 1;
-    const idx = scratchpad.interruptCounter;
-    // Find previous resume values
-    if (scratchpad.resume.length > 0 && idx < scratchpad.resume.length) {
-        conf[CONFIG_KEY_SEND]?.([[RESUME, scratchpad.resume]]);
-        return scratchpad.resume[idx];
-    }
-    // Find current resume value
-    if (scratchpad.nullResume !== undefined) {
-        if (scratchpad.resume.length !== idx) {
-            throw new Error(`Resume length mismatch: ${scratchpad.resume.length} !== ${idx}`);
-        }
-        const v = scratchpad.consumeNullResume();
-        scratchpad.resume.push(v);
-        conf[CONFIG_KEY_SEND]?.([[RESUME, scratchpad.resume]]);
-        return v;
-    }
-    // No resume value found
-    const ns = conf[CONFIG_KEY_CHECKPOINT_NS]?.split(CHECKPOINT_NAMESPACE_SEPARATOR);
-    const id = ns ? XXH3(ns.join(CHECKPOINT_NAMESPACE_SEPARATOR)) : undefined;
-    throw new GraphInterrupt([{ id, value }]);
+* Interrupts the execution of a graph node.
+* This function can be used to pause execution of a node, and return the value of the `resume`
+* input when the graph is re-invoked using `Command`.
+* Multiple interrupts can be called within a single node, and each will be handled sequentially.
+*
+* When an interrupt is called:
+* 1. If there's a `resume` value available (from a previous `Command`), it returns that value.
+* 2. Otherwise, it throws a `GraphInterrupt` with the provided value
+* 3. The graph can be resumed by passing a `Command` with a `resume` value
+*
+* Because the `interrupt` function propagates by throwing a special `GraphInterrupt` error,
+* you should avoid using `try/catch` blocks around the `interrupt` function,
+* or if you do, ensure that the `GraphInterrupt` error is thrown again within your `catch` block.
+*
+* @param value - The value to include in the interrupt. This will be available in task.interrupts[].value
+* @returns The `resume` value provided when the graph is re-invoked with a Command
+*
+* @example
+* ```typescript
+* // Define a node that uses multiple interrupts
+* const nodeWithInterrupts = () => {
+*   // First interrupt - will pause execution and include {value: 1} in task values
+*   const answer1 = interrupt({ value: 1 });
+*
+*   // Second interrupt - only called after first interrupt is resumed
+*   const answer2 = interrupt({ value: 2 });
+*
+*   // Use the resume values
+*   return { myKey: answer1 + " " + answer2 };
+* };
+*
+* // Resume the graph after first interrupt
+* await graph.stream(new Command({ resume: "answer 1" }));
+*
+* // Resume the graph after second interrupt
+* await graph.stream(new Command({ resume: "answer 2" }));
+* // Final result: { myKey: "answer 1 answer 2" }
+* ```
+*
+* @throws {Error} If called outside the context of a graph
+* @throws {GraphInterrupt} When no resume value is available
+*/
+function interrupt(value) {
+	const config = AsyncLocalStorageProviderSingleton.getRunnableConfig();
+	if (!config) throw new Error("Called interrupt() outside the context of a graph.");
+	const conf = config.configurable;
+	if (!conf) throw new Error("No configurable found in config");
+	const checkpointer = conf[CONFIG_KEY_CHECKPOINTER];
+	if (!checkpointer) throw new GraphValueError("No checkpointer set");
+	const scratchpad = conf[CONFIG_KEY_SCRATCHPAD];
+	scratchpad.interruptCounter += 1;
+	const idx = scratchpad.interruptCounter;
+	if (scratchpad.resume.length > 0 && idx < scratchpad.resume.length) {
+		conf[CONFIG_KEY_SEND]?.([[RESUME, scratchpad.resume]]);
+		return scratchpad.resume[idx];
+	}
+	if (scratchpad.nullResume !== void 0) {
+		if (scratchpad.resume.length !== idx) throw new Error(`Resume length mismatch: ${scratchpad.resume.length} !== ${idx}`);
+		const v = scratchpad.consumeNullResume();
+		scratchpad.resume.push(v);
+		conf[CONFIG_KEY_SEND]?.([[RESUME, scratchpad.resume]]);
+		return v;
+	}
+	const ns = conf[CONFIG_KEY_CHECKPOINT_NS]?.split(CHECKPOINT_NAMESPACE_SEPARATOR);
+	const id = ns ? XXH3(ns.join(CHECKPOINT_NAMESPACE_SEPARATOR)) : void 0;
+	throw new GraphInterrupt([{
+		id,
+		value
+	}]);
 }
+
+//#endregion
+export { interrupt };
 //# sourceMappingURL=interrupt.js.map

package/dist/interrupt.js.map

@@ -1 +1 @@
-{"version":3,"file":"interrupt.js","sourceRoot":"","sources":["../src/interrupt.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,kCAAkC,EAAE,MAAM,4BAA4B,CAAC;AAMhF,OAAO,EAAE,cAAc,EAAE,eAAe,EAAE,MAAM,aAAa,CAAC;AAC9D,OAAO,EACL,wBAAwB,EACxB,qBAAqB,EACrB,eAAe,EACf,uBAAuB,EACvB,8BAA8B,EAC9B,MAAM,GACP,MAAM,gBAAgB,CAAC;AAExB,OAAO,EAAE,IAAI,EAAE,MAAM,WAAW,CAAC;AAEjC;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GA0CG;AACH,8DAA8D;AAC9D,MAAM,UAAU,SAAS,CAAuB,KAAQ;IACtD,MAAM,MAAM,GACV,kCAAkC,CAAC,iBAAiB,EAAE,CAAC;IACzD,IAAI,CAAC,MAAM,EAAE,CAAC;QACZ,MAAM,IAAI,KAAK,CAAC,oDAAoD,CAAC,CAAC;IACxE,CAAC;IAED,MAAM,IAAI,GAAG,MAAM,CAAC,YAAY,CAAC;IACjC,IAAI,CAAC,IAAI,EAAE,CAAC;QACV,MAAM,IAAI,KAAK,CAAC,iCAAiC,CAAC,CAAC;IACrD,CAAC;IAED,MAAM,YAAY,GAAwB,IAAI,CAAC,uBAAuB,CAAC,CAAC;IACxE,IAAI,CAAC,YAAY;QAAE,MAAM,IAAI,eAAe,CAAC,qBAAqB,CAAC,CAAC;IAEpE,wBAAwB;IACxB,MAAM,UAAU,GAAqB,IAAI,CAAC,qBAAqB,CAAC,CAAC;IACjE,UAAU,CAAC,gBAAgB,IAAI,CAAC,CAAC;IACjC,MAAM,GAAG,GAAG,UAAU,CAAC,gBAAgB,CAAC;IAExC,8BAA8B;IAC9B,IAAI,UAAU,CAAC,MAAM,CAAC,MAAM,GAAG,CAAC,IAAI,GAAG,GAAG,UAAU,CAAC,MAAM,CAAC,MAAM,EAAE,CAAC;QACnE,IAAI,CAAC,eAAe,CAAC,EAAE,CAAC,CAAC,CAAC,MAAM,EAAE,UAAU,CAAC,MAAM,CAAiB,CAAC,CAAC,CAAC;QACvE,OAAO,UAAU,CAAC,MAAM,CAAC,GAAG,CAAM,CAAC;IACrC,CAAC;IAED,4BAA4B;IAC5B,IAAI,UAAU,CAAC,UAAU,KAAK,SAAS,EAAE,CAAC;QACxC,IAAI,UAAU,CAAC,MAAM,CAAC,MAAM,KAAK,GAAG,EAAE,CAAC;YACrC,MAAM,IAAI,KAAK,CACb,2BAA2B,UAAU,CAAC,MAAM,CAAC,MAAM,QAAQ,GAAG,EAAE,CACjE,CAAC;QACJ,CAAC;QACD,MAAM,CAAC,GAAG,UAAU,CAAC,iBAAiB,EAAE,CAAC;QACzC,UAAU,CAAC,MAAM,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC;QAC1B,IAAI,CAAC,eAAe,CAAC,EAAE,CAAC,CAAC,CAAC,MAAM,EAAE,UAAU,CAAC,MAAM,CAAiB,CAAC,CAAC,CAAC;QACvE,OAAO,CAAM,CAAC;IAChB,CAAC;IAED,wBAAwB;IACxB,MAAM,EAAE,GAAyB,IAAI,CAAC,wBAAwB,CAAC,EAAE,KAAK,CACpE,8BAA8B,CAC/B,CAAC;IAEF,MAAM,EAAE,GAAG,EAAE,CAAC,CAAC,CAAC,IAAI,CAAC,EAAE,CAAC,IAAI,CAAC,8BAA8B,CAAC,CAAC,CAAC,CAAC,CAAC,SAAS,CAAC;IAC1E,MAAM,IAAI,cAAc,CAAC,CAAC,EAAE,EAAE,EAAE,KAAK,EAAE,CAAC,CAAC,CAAC;AAC5C,CAAC"}
+{"version":3,"file":"interrupt.js","names":["config: RunnableConfig | undefined","checkpointer: BaseCheckpointSaver","scratchpad: PregelScratchpad","ns: string[] | undefined"],"sources":["../src/interrupt.ts"],"sourcesContent":["import { AsyncLocalStorageProviderSingleton } from \"@langchain/core/singletons\";\nimport { RunnableConfig } from \"@langchain/core/runnables\";\nimport {\n  BaseCheckpointSaver,\n  type PendingWrite,\n} from \"@langchain/langgraph-checkpoint\";\nimport { GraphInterrupt, GraphValueError } from \"./errors.js\";\nimport {\n  CONFIG_KEY_CHECKPOINT_NS,\n  CONFIG_KEY_SCRATCHPAD,\n  CONFIG_KEY_SEND,\n  CONFIG_KEY_CHECKPOINTER,\n  CHECKPOINT_NAMESPACE_SEPARATOR,\n  RESUME,\n} from \"./constants.js\";\nimport { PregelScratchpad } from \"./pregel/types.js\";\nimport { XXH3 } from \"./hash.js\";\n\n/**\n * Interrupts the execution of a graph node.\n * This function can be used to pause execution of a node, and return the value of the `resume`\n * input when the graph is re-invoked using `Command`.\n * Multiple interrupts can be called within a single node, and each will be handled sequentially.\n *\n * When an interrupt is called:\n * 1. If there's a `resume` value available (from a previous `Command`), it returns that value.\n * 2. Otherwise, it throws a `GraphInterrupt` with the provided value\n * 3. The graph can be resumed by passing a `Command` with a `resume` value\n *\n * Because the `interrupt` function propagates by throwing a special `GraphInterrupt` error,\n * you should avoid using `try/catch` blocks around the `interrupt` function,\n * or if you do, ensure that the `GraphInterrupt` error is thrown again within your `catch` block.\n *\n * @param value - The value to include in the interrupt. This will be available in task.interrupts[].value\n * @returns The `resume` value provided when the graph is re-invoked with a Command\n *\n * @example\n * ```typescript\n * // Define a node that uses multiple interrupts\n * const nodeWithInterrupts = () => {\n *   // First interrupt - will pause execution and include {value: 1} in task values\n *   const answer1 = interrupt({ value: 1 });\n *\n *   // Second interrupt - only called after first interrupt is resumed\n *   const answer2 = interrupt({ value: 2 });\n *\n *   // Use the resume values\n *   return { myKey: answer1 + \" \" + answer2 };\n * };\n *\n * // Resume the graph after first interrupt\n * await graph.stream(new Command({ resume: \"answer 1\" }));\n *\n * // Resume the graph after second interrupt\n * await graph.stream(new Command({ resume: \"answer 2\" }));\n * // Final result: { myKey: \"answer 1 answer 2\" }\n * ```\n *\n * @throws {Error} If called outside the context of a graph\n * @throws {GraphInterrupt} When no resume value is available\n */\n// eslint-disable-next-line @typescript-eslint/no-explicit-any\nexport function interrupt<I = unknown, R = any>(value: I): R {\n  const config: RunnableConfig | undefined =\n    AsyncLocalStorageProviderSingleton.getRunnableConfig();\n  if (!config) {\n    throw new Error(\"Called interrupt() outside the context of a graph.\");\n  }\n\n  const conf = config.configurable;\n  if (!conf) {\n    throw new Error(\"No configurable found in config\");\n  }\n\n  const checkpointer: BaseCheckpointSaver = conf[CONFIG_KEY_CHECKPOINTER];\n  if (!checkpointer) throw new GraphValueError(\"No checkpointer set\");\n\n  // Track interrupt index\n  const scratchpad: PregelScratchpad = conf[CONFIG_KEY_SCRATCHPAD];\n  scratchpad.interruptCounter += 1;\n  const idx = scratchpad.interruptCounter;\n\n  // Find previous resume values\n  if (scratchpad.resume.length > 0 && idx < scratchpad.resume.length) {\n    conf[CONFIG_KEY_SEND]?.([[RESUME, scratchpad.resume] as PendingWrite]);\n    return scratchpad.resume[idx] as R;\n  }\n\n  // Find current resume value\n  if (scratchpad.nullResume !== undefined) {\n    if (scratchpad.resume.length !== idx) {\n      throw new Error(\n        `Resume length mismatch: ${scratchpad.resume.length} !== ${idx}`\n      );\n    }\n    const v = scratchpad.consumeNullResume();\n    scratchpad.resume.push(v);\n    conf[CONFIG_KEY_SEND]?.([[RESUME, scratchpad.resume] as PendingWrite]);\n    return v as R;\n  }\n\n  // No resume value found\n  const ns: string[] | undefined = conf[CONFIG_KEY_CHECKPOINT_NS]?.split(\n    CHECKPOINT_NAMESPACE_SEPARATOR\n  );\n\n  const id = ns ? XXH3(ns.join(CHECKPOINT_NAMESPACE_SEPARATOR)) : undefined;\n  throw new GraphInterrupt([{ id, value }]);\n}\n"],"mappings":";;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;AA8DA,SAAgB,UAAgC,OAAa;CAC3D,MAAMA,SACJ,mCAAmC;AACrC,KAAI,CAAC,OACH,OAAM,IAAI,MAAM;CAGlB,MAAM,OAAO,OAAO;AACpB,KAAI,CAAC,KACH,OAAM,IAAI,MAAM;CAGlB,MAAMC,eAAoC,KAAK;AAC/C,KAAI,CAAC,aAAc,OAAM,IAAI,gBAAgB;CAG7C,MAAMC,aAA+B,KAAK;AAC1C,YAAW,oBAAoB;CAC/B,MAAM,MAAM,WAAW;AAGvB,KAAI,WAAW,OAAO,SAAS,KAAK,MAAM,WAAW,OAAO,QAAQ;AAClE,OAAK,mBAAmB,CAAC,CAAC,QAAQ,WAAW;AAC7C,SAAO,WAAW,OAAO;;AAI3B,KAAI,WAAW,eAAe,QAAW;AACvC,MAAI,WAAW,OAAO,WAAW,IAC/B,OAAM,IAAI,MACR,2BAA2B,WAAW,OAAO,OAAO,OAAO;EAG/D,MAAM,IAAI,WAAW;AACrB,aAAW,OAAO,KAAK;AACvB,OAAK,mBAAmB,CAAC,CAAC,QAAQ,WAAW;AAC7C,SAAO;;CAIT,MAAMC,KAA2B,KAAK,2BAA2B,MAC/D;CAGF,MAAM,KAAK,KAAK,KAAK,GAAG,KAAK,mCAAmC;AAChE,OAAM,IAAI,eAAe,CAAC;EAAE;EAAI"}

package/dist/prebuilt/agentName.cjs

@@ -1,183 +1,150 @@
-"use strict";
-Object.defineProperty(exports, "__esModule", { value: true });
-exports._addInlineAgentName = _addInlineAgentName;
-exports._removeInlineAgentName = _removeInlineAgentName;
-exports.withAgentName = withAgentName;
-const messages_1 = require("@langchain/core/messages");
-const runnables_1 = require("@langchain/core/runnables");
+const require_rolldown_runtime = require('../_virtual/rolldown_runtime.cjs');
+const __langchain_core_runnables = require_rolldown_runtime.__toESM(require("@langchain/core/runnables"));
+const __langchain_core_messages = require_rolldown_runtime.__toESM(require("@langchain/core/messages"));
+
+//#region src/prebuilt/agentName.ts
 const NAME_PATTERN = /<name>(.*?)<\/name>/s;
 const CONTENT_PATTERN = /<content>(.*?)<\/content>/s;
 /**
- * Attach formatted agent names to the messages passed to and from a language model.
- *
- * This is useful for making a message history with multiple agents more coherent.
- *
- * NOTE: agent name is consumed from the message.name field.
- * If you're using an agent built with createReactAgent, name is automatically set.
- * If you're building a custom agent, make sure to set the name on the AI message returned by the LLM.
- *
- * @param message - Message to add agent name formatting to
- * @returns Message with agent name formatting
- *
- * @internal
- */
+* Attach formatted agent names to the messages passed to and from a language model.
+*
+* This is useful for making a message history with multiple agents more coherent.
+*
+* NOTE: agent name is consumed from the message.name field.
+* If you're using an agent built with createReactAgent, name is automatically set.
+* If you're building a custom agent, make sure to set the name on the AI message returned by the LLM.
+*
+* @deprecated migrated to `langchain` package.
+*
+* @param message - Message to add agent name formatting to
+* @returns Message with agent name formatting
+*
+* @internal
+*/
 function _addInlineAgentName(message) {
-    const isAI = (0, messages_1.isBaseMessage)(message) &&
-        ((0, messages_1.isAIMessage)(message) ||
-            ((0, messages_1.isBaseMessageChunk)(message) && (0, messages_1.isAIMessageChunk)(message)));
-    if (!isAI || !message.name) {
-        return message;
-    }
-    const { name } = message;
-    if (typeof message.content === "string") {
-        return new messages_1.AIMessage({
-            ...(Object.keys(message.lc_kwargs ?? {}).length > 0
-                ? message.lc_kwargs
-                : message),
-            content: `<name>${name}</name><content>${message.content}</content>`,
-            name: undefined,
-        });
-    }
-    const updatedContent = [];
-    let textBlockCount = 0;
-    for (const contentBlock of message.content) {
-        if (typeof contentBlock === "string") {
-            textBlockCount += 1;
-            updatedContent.push(`<name>${name}</name><content>${contentBlock}</content>`);
-        }
-        else if (typeof contentBlock === "object" &&
-            "type" in contentBlock &&
-            contentBlock.type === "text") {
-            textBlockCount += 1;
-            updatedContent.push({
-                ...contentBlock,
-                text: `<name>${name}</name><content>${contentBlock.text}</content>`,
-            });
-        }
-        else {
-            updatedContent.push(contentBlock);
-        }
-    }
-    if (!textBlockCount) {
-        updatedContent.unshift({
-            type: "text",
-            text: `<name>${name}</name><content></content>`,
-        });
-    }
-    return new messages_1.AIMessage({
-        ...message.lc_kwargs,
-        content: updatedContent,
-        name: undefined,
-    });
+	const isAI = (0, __langchain_core_messages.isBaseMessage)(message) && ((0, __langchain_core_messages.isAIMessage)(message) || (0, __langchain_core_messages.isBaseMessageChunk)(message) && (0, __langchain_core_messages.isAIMessageChunk)(message));
+	if (!isAI || !message.name) return message;
+	const { name } = message;
+	if (typeof message.content === "string") return new __langchain_core_messages.AIMessage({
+		...Object.keys(message.lc_kwargs ?? {}).length > 0 ? message.lc_kwargs : message,
+		content: `<name>${name}</name><content>${message.content}</content>`,
+		name: void 0
+	});
+	const updatedContent = [];
+	let textBlockCount = 0;
+	for (const contentBlock of message.content) if (typeof contentBlock === "string") {
+		textBlockCount += 1;
+		updatedContent.push(`<name>${name}</name><content>${contentBlock}</content>`);
+	} else if (typeof contentBlock === "object" && "type" in contentBlock && contentBlock.type === "text") {
+		textBlockCount += 1;
+		updatedContent.push({
+			...contentBlock,
+			text: `<name>${name}</name><content>${contentBlock.text}</content>`
+		});
+	} else updatedContent.push(contentBlock);
+	if (!textBlockCount) updatedContent.unshift({
+		type: "text",
+		text: `<name>${name}</name><content></content>`
+	});
+	return new __langchain_core_messages.AIMessage({
+		...message.lc_kwargs,
+		content: updatedContent,
+		name: void 0
+	});
 }
 /**
- * Remove explicit name and content XML tags from the AI message content.
- *
- * Examples:
- *
- * @example
- * ```typescript
- * removeInlineAgentName(new AIMessage({ content: "<name>assistant</name><content>Hello</content>", name: "assistant" }))
- * // AIMessage with content: "Hello"
- *
- * removeInlineAgentName(new AIMessage({ content: [{type: "text", text: "<name>assistant</name><content>Hello</content>"}], name: "assistant" }))
- * // AIMessage with content: [{type: "text", text: "Hello"}]
- * ```
- *
- * @internal
- */
+* Remove explicit name and content XML tags from the AI message content.
+*
+* @deprecated migrated to `langchain` package.
+*
+* Examples:
+*
+* @example
+* ```typescript
+* removeInlineAgentName(new AIMessage({ content: "<name>assistant</name><content>Hello</content>", name: "assistant" }))
+* // AIMessage with content: "Hello"
+*
+* removeInlineAgentName(new AIMessage({ content: [{type: "text", text: "<name>assistant</name><content>Hello</content>"}], name: "assistant" }))
+* // AIMessage with content: [{type: "text", text: "Hello"}]
+* ```
+*
+* @internal
+*/
 function _removeInlineAgentName(message) {
-    if (!(0, messages_1.isAIMessage)(message) || !message.content) {
-        return message;
-    }
-    let updatedContent = [];
-    let updatedName;
-    if (Array.isArray(message.content)) {
-        updatedContent = message.content
-            .filter((block) => {
-            if (block.type === "text") {
-                const nameMatch = block.text.match(NAME_PATTERN);
-                const contentMatch = block.text.match(CONTENT_PATTERN);
-                // don't include empty content blocks that were added because there was no text block to modify
-                if (nameMatch && (!contentMatch || contentMatch[1] === "")) {
-                    // capture name from text block
-                    // eslint-disable-next-line prefer-destructuring
-                    updatedName = nameMatch[1];
-                    return false;
-                }
-                return true;
-            }
-            return true;
-        })
-            .map((block) => {
-            if (block.type === "text") {
-                const nameMatch = block.text.match(NAME_PATTERN);
-                const contentMatch = block.text.match(CONTENT_PATTERN);
-                if (!nameMatch || !contentMatch) {
-                    return block;
-                }
-                // capture name from text block
-                // eslint-disable-next-line prefer-destructuring
-                updatedName = nameMatch[1];
-                return {
-                    ...block,
-                    text: contentMatch[1],
-                };
-            }
-            return block;
-        });
-    }
-    else {
-        const content = message.content;
-        const nameMatch = content.match(NAME_PATTERN);
-        const contentMatch = content.match(CONTENT_PATTERN);
-        if (!nameMatch || !contentMatch) {
-            return message;
-        }
-        // eslint-disable-next-line prefer-destructuring
-        updatedName = nameMatch[1];
-        // eslint-disable-next-line prefer-destructuring
-        updatedContent = contentMatch[1];
-    }
-    return new messages_1.AIMessage({
-        ...(Object.keys(message.lc_kwargs ?? {}).length > 0
-            ? message.lc_kwargs
-            : message),
-        content: updatedContent,
-        name: updatedName,
-    });
+	if (!(0, __langchain_core_messages.isAIMessage)(message) || !message.content) return message;
+	let updatedContent = [];
+	let updatedName;
+	if (Array.isArray(message.content)) updatedContent = message.content.filter((block) => {
+		if (block.type === "text" && typeof block.text === "string") {
+			const nameMatch = block.text.match(NAME_PATTERN);
+			const contentMatch = block.text.match(CONTENT_PATTERN);
+			if (nameMatch && (!contentMatch || contentMatch[1] === "")) {
+				updatedName = nameMatch[1];
+				return false;
+			}
+			return true;
+		}
+		return true;
+	}).map((block) => {
+		if (block.type === "text" && typeof block.text === "string") {
+			const nameMatch = block.text.match(NAME_PATTERN);
+			const contentMatch = block.text.match(CONTENT_PATTERN);
+			if (!nameMatch || !contentMatch) return block;
+			updatedName = nameMatch[1];
+			return {
+				...block,
+				text: contentMatch[1]
+			};
+		}
+		return block;
+	});
+	else {
+		const content = message.content;
+		const nameMatch = content.match(NAME_PATTERN);
+		const contentMatch = content.match(CONTENT_PATTERN);
+		if (!nameMatch || !contentMatch) return message;
+		updatedName = nameMatch[1];
+		updatedContent = contentMatch[1];
+	}
+	return new __langchain_core_messages.AIMessage({
+		...Object.keys(message.lc_kwargs ?? {}).length > 0 ? message.lc_kwargs : message,
+		content: updatedContent,
+		name: updatedName
+	});
 }
 /**
- * Attach formatted agent names to the messages passed to and from a language model.
- *
- * This is useful for making a message history with multiple agents more coherent.
- *
- * NOTE: agent name is consumed from the message.name field.
- * If you're using an agent built with createReactAgent, name is automatically set.
- * If you're building a custom agent, make sure to set the name on the AI message returned by the LLM.
- *
- * @param model - Language model to add agent name formatting to
- * @param agentNameMode - How to expose the agent name to the LLM
- *   - "inline": Add the agent name directly into the content field of the AI message using XML-style tags.
- *     Example: "How can I help you" -> "<name>agent_name</name><content>How can I help you?</content>".
- */
+* Attach formatted agent names to the messages passed to and from a language model.
+*
+* This is useful for making a message history with multiple agents more coherent.
+*
+* * @deprecated migrated to `langchain` package.
+*
+* NOTE: agent name is consumed from the message.name field.
+* If you're using an agent built with createReactAgent, name is automatically set.
+* If you're building a custom agent, make sure to set the name on the AI message returned by the LLM.
+*
+* @param model - Language model to add agent name formatting to
+* @param agentNameMode - How to expose the agent name to the LLM
+*   - "inline": Add the agent name directly into the content field of the AI message using XML-style tags.
+*     Example: "How can I help you" -> "<name>agent_name</name><content>How can I help you?</content>".
+*/
 function withAgentName(model, agentNameMode) {
-    let processInputMessage;
-    let processOutputMessage;
-    if (agentNameMode === "inline") {
-        processInputMessage = _addInlineAgentName;
-        processOutputMessage = _removeInlineAgentName;
-    }
-    else {
-        throw new Error(`Invalid agent name mode: ${agentNameMode}. Needs to be one of: "inline"`);
-    }
-    function processInputMessages(messages) {
-        return messages.map(processInputMessage);
-    }
-    return runnables_1.RunnableSequence.from([
-        runnables_1.RunnableLambda.from(processInputMessages),
-        model,
-        runnables_1.RunnableLambda.from(processOutputMessage),
-    ]);
+	let processInputMessage;
+	let processOutputMessage;
+	if (agentNameMode === "inline") {
+		processInputMessage = _addInlineAgentName;
+		processOutputMessage = _removeInlineAgentName;
+	} else throw new Error(`Invalid agent name mode: ${agentNameMode}. Needs to be one of: "inline"`);
+	function processInputMessages(messages) {
+		return messages.map(processInputMessage);
+	}
+	return __langchain_core_runnables.RunnableSequence.from([
+		__langchain_core_runnables.RunnableLambda.from(processInputMessages),
+		model,
+		__langchain_core_runnables.RunnableLambda.from(processOutputMessage)
+	]);
 }
-//# sourceMappingURL=agentName.js.map
+
+//#endregion
+exports.withAgentName = withAgentName;
+//# sourceMappingURL=agentName.cjs.map

package/dist/prebuilt/agentName.cjs.map

@@ -0,0 +1 @@
+{"version":3,"file":"agentName.cjs","names":["AIMessage","updatedContent: MessageContent","updatedName: string | undefined","processInputMessage: (message: BaseMessageLike) => BaseMessageLike","processOutputMessage: (message: BaseMessage) => BaseMessage","RunnableSequence","RunnableLambda"],"sources":["../../src/prebuilt/agentName.ts"],"sourcesContent":["import { LanguageModelLike } from \"@langchain/core/language_models/base\";\nimport {\n  AIMessage,\n  BaseMessage,\n  BaseMessageLike,\n  isAIMessage,\n  isAIMessageChunk,\n  isBaseMessage,\n  isBaseMessageChunk,\n  MessageContent,\n} from \"@langchain/core/messages\";\nimport { RunnableLambda, RunnableSequence } from \"@langchain/core/runnables\";\n\nconst NAME_PATTERN = /<name>(.*?)<\\/name>/s;\nconst CONTENT_PATTERN = /<content>(.*?)<\\/content>/s;\n\nexport type AgentNameMode = \"inline\";\n\n/**\n * Attach formatted agent names to the messages passed to and from a language model.\n *\n * This is useful for making a message history with multiple agents more coherent.\n *\n * NOTE: agent name is consumed from the message.name field.\n * If you're using an agent built with createReactAgent, name is automatically set.\n * If you're building a custom agent, make sure to set the name on the AI message returned by the LLM.\n *\n * @deprecated migrated to `langchain` package.\n *\n * @param message - Message to add agent name formatting to\n * @returns Message with agent name formatting\n *\n * @internal\n */\nexport function _addInlineAgentName<T extends BaseMessageLike>(\n  message: T\n): T | AIMessage {\n  const isAI =\n    isBaseMessage(message) &&\n    (isAIMessage(message) ||\n      (isBaseMessageChunk(message) && isAIMessageChunk(message)));\n\n  if (!isAI || !message.name) {\n    return message;\n  }\n\n  const { name } = message;\n\n  if (typeof message.content === \"string\") {\n    return new AIMessage({\n      ...(Object.keys(message.lc_kwargs ?? {}).length > 0\n        ? message.lc_kwargs\n        : message),\n      content: `<name>${name}</name><content>${message.content}</content>`,\n      name: undefined,\n    });\n  }\n\n  const updatedContent = [];\n  let textBlockCount = 0;\n\n  for (const contentBlock of message.content) {\n    if (typeof contentBlock === \"string\") {\n      textBlockCount += 1;\n      updatedContent.push(\n        `<name>${name}</name><content>${contentBlock}</content>`\n      );\n    } else if (\n      typeof contentBlock === \"object\" &&\n      \"type\" in contentBlock &&\n      contentBlock.type === \"text\"\n    ) {\n      textBlockCount += 1;\n      updatedContent.push({\n        ...contentBlock,\n        text: `<name>${name}</name><content>${contentBlock.text}</content>`,\n      });\n    } else {\n      updatedContent.push(contentBlock);\n    }\n  }\n\n  if (!textBlockCount) {\n    updatedContent.unshift({\n      type: \"text\",\n      text: `<name>${name}</name><content></content>`,\n    });\n  }\n  return new AIMessage({\n    ...message.lc_kwargs,\n    content: updatedContent as MessageContent,\n    name: undefined,\n  });\n}\n\n/**\n * Remove explicit name and content XML tags from the AI message content.\n *\n * @deprecated migrated to `langchain` package.\n *\n * Examples:\n *\n * @example\n * ```typescript\n * removeInlineAgentName(new AIMessage({ content: \"<name>assistant</name><content>Hello</content>\", name: \"assistant\" }))\n * // AIMessage with content: \"Hello\"\n *\n * removeInlineAgentName(new AIMessage({ content: [{type: \"text\", text: \"<name>assistant</name><content>Hello</content>\"}], name: \"assistant\" }))\n * // AIMessage with content: [{type: \"text\", text: \"Hello\"}]\n * ```\n *\n * @internal\n */\nexport function _removeInlineAgentName<T extends BaseMessage>(message: T): T {\n  if (!isAIMessage(message) || !message.content) {\n    return message;\n  }\n\n  let updatedContent: MessageContent = [];\n  let updatedName: string | undefined;\n\n  if (Array.isArray(message.content)) {\n    updatedContent = message.content\n      .filter((block) => {\n        if (block.type === \"text\" && typeof block.text === \"string\") {\n          const nameMatch = block.text.match(NAME_PATTERN);\n          const contentMatch = block.text.match(CONTENT_PATTERN);\n          // don't include empty content blocks that were added because there was no text block to modify\n          if (nameMatch && (!contentMatch || contentMatch[1] === \"\")) {\n            // capture name from text block\n            // eslint-disable-next-line prefer-destructuring\n            updatedName = nameMatch[1];\n            return false;\n          }\n          return true;\n        }\n        return true;\n      })\n      .map((block) => {\n        if (block.type === \"text\" && typeof block.text === \"string\") {\n          const nameMatch = block.text.match(NAME_PATTERN);\n          const contentMatch = block.text.match(CONTENT_PATTERN);\n\n          if (!nameMatch || !contentMatch) {\n            return block;\n          }\n\n          // capture name from text block\n          // eslint-disable-next-line prefer-destructuring\n          updatedName = nameMatch[1];\n\n          return {\n            ...block,\n            text: contentMatch[1],\n          };\n        }\n        return block;\n      });\n  } else {\n    const content = message.content as string;\n    const nameMatch = content.match(NAME_PATTERN);\n    const contentMatch = content.match(CONTENT_PATTERN);\n\n    if (!nameMatch || !contentMatch) {\n      return message;\n    }\n\n    // eslint-disable-next-line prefer-destructuring\n    updatedName = nameMatch[1];\n    // eslint-disable-next-line prefer-destructuring\n    updatedContent = contentMatch[1];\n  }\n\n  return new AIMessage({\n    ...(Object.keys(message.lc_kwargs ?? {}).length > 0\n      ? message.lc_kwargs\n      : message),\n    content: updatedContent,\n    name: updatedName,\n  }) as T;\n}\n\n/**\n * Attach formatted agent names to the messages passed to and from a language model.\n *\n * This is useful for making a message history with multiple agents more coherent.\n *\n * * @deprecated migrated to `langchain` package.\n *\n * NOTE: agent name is consumed from the message.name field.\n * If you're using an agent built with createReactAgent, name is automatically set.\n * If you're building a custom agent, make sure to set the name on the AI message returned by the LLM.\n *\n * @param model - Language model to add agent name formatting to\n * @param agentNameMode - How to expose the agent name to the LLM\n *   - \"inline\": Add the agent name directly into the content field of the AI message using XML-style tags.\n *     Example: \"How can I help you\" -> \"<name>agent_name</name><content>How can I help you?</content>\".\n */\nexport function withAgentName(\n  model: LanguageModelLike,\n  agentNameMode: AgentNameMode\n): LanguageModelLike {\n  let processInputMessage: (message: BaseMessageLike) => BaseMessageLike;\n  let processOutputMessage: (message: BaseMessage) => BaseMessage;\n\n  if (agentNameMode === \"inline\") {\n    processInputMessage = _addInlineAgentName;\n    processOutputMessage = _removeInlineAgentName;\n  } else {\n    throw new Error(\n      `Invalid agent name mode: ${agentNameMode}. Needs to be one of: \"inline\"`\n    );\n  }\n\n  function processInputMessages(\n    messages: BaseMessageLike[]\n  ): BaseMessageLike[] {\n    return messages.map(processInputMessage);\n  }\n\n  return RunnableSequence.from([\n    RunnableLambda.from(processInputMessages),\n    model,\n    RunnableLambda.from(processOutputMessage),\n  ]);\n}\n"],"mappings":";;;;;AAaA,MAAM,eAAe;AACrB,MAAM,kBAAkB;;;;;;;;;;;;;;;;;AAoBxB,SAAgB,oBACd,SACe;CACf,MAAM,oDACU,wDACD,8DACS,4DAA6B;AAErD,KAAI,CAAC,QAAQ,CAAC,QAAQ,KACpB,QAAO;CAGT,MAAM,EAAE,SAAS;AAEjB,KAAI,OAAO,QAAQ,YAAY,SAC7B,QAAO,IAAIA,oCAAU;EACnB,GAAI,OAAO,KAAK,QAAQ,aAAa,IAAI,SAAS,IAC9C,QAAQ,YACR;EACJ,SAAS,SAAS,KAAK,kBAAkB,QAAQ,QAAQ;EACzD,MAAM;;CAIV,MAAM,iBAAiB;CACvB,IAAI,iBAAiB;AAErB,MAAK,MAAM,gBAAgB,QAAQ,QACjC,KAAI,OAAO,iBAAiB,UAAU;AACpC,oBAAkB;AAClB,iBAAe,KACb,SAAS,KAAK,kBAAkB,aAAa;YAG/C,OAAO,iBAAiB,YACxB,UAAU,gBACV,aAAa,SAAS,QACtB;AACA,oBAAkB;AAClB,iBAAe,KAAK;GAClB,GAAG;GACH,MAAM,SAAS,KAAK,kBAAkB,aAAa,KAAK;;OAG1D,gBAAe,KAAK;AAIxB,KAAI,CAAC,eACH,gBAAe,QAAQ;EACrB,MAAM;EACN,MAAM,SAAS,KAAK;;AAGxB,QAAO,IAAIA,oCAAU;EACnB,GAAG,QAAQ;EACX,SAAS;EACT,MAAM;;;;;;;;;;;;;;;;;;;;;AAsBV,SAAgB,uBAA8C,SAAe;AAC3E,KAAI,4CAAa,YAAY,CAAC,QAAQ,QACpC,QAAO;CAGT,IAAIC,iBAAiC;CACrC,IAAIC;AAEJ,KAAI,MAAM,QAAQ,QAAQ,SACxB,kBAAiB,QAAQ,QACtB,QAAQ,UAAU;AACjB,MAAI,MAAM,SAAS,UAAU,OAAO,MAAM,SAAS,UAAU;GAC3D,MAAM,YAAY,MAAM,KAAK,MAAM;GACnC,MAAM,eAAe,MAAM,KAAK,MAAM;AAEtC,OAAI,cAAc,CAAC,gBAAgB,aAAa,OAAO,KAAK;AAG1D,kBAAc,UAAU;AACxB,WAAO;;AAET,UAAO;;AAET,SAAO;IAER,KAAK,UAAU;AACd,MAAI,MAAM,SAAS,UAAU,OAAO,MAAM,SAAS,UAAU;GAC3D,MAAM,YAAY,MAAM,KAAK,MAAM;GACnC,MAAM,eAAe,MAAM,KAAK,MAAM;AAEtC,OAAI,CAAC,aAAa,CAAC,aACjB,QAAO;AAKT,iBAAc,UAAU;AAExB,UAAO;IACL,GAAG;IACH,MAAM,aAAa;;;AAGvB,SAAO;;MAEN;EACL,MAAM,UAAU,QAAQ;EACxB,MAAM,YAAY,QAAQ,MAAM;EAChC,MAAM,eAAe,QAAQ,MAAM;AAEnC,MAAI,CAAC,aAAa,CAAC,aACjB,QAAO;AAIT,gBAAc,UAAU;AAExB,mBAAiB,aAAa;;AAGhC,QAAO,IAAIF,oCAAU;EACnB,GAAI,OAAO,KAAK,QAAQ,aAAa,IAAI,SAAS,IAC9C,QAAQ,YACR;EACJ,SAAS;EACT,MAAM;;;;;;;;;;;;;;;;;;;AAoBV,SAAgB,cACd,OACA,eACmB;CACnB,IAAIG;CACJ,IAAIC;AAEJ,KAAI,kBAAkB,UAAU;AAC9B,wBAAsB;AACtB,yBAAuB;OAEvB,OAAM,IAAI,MACR,4BAA4B,cAAc;CAI9C,SAAS,qBACP,UACmB;AACnB,SAAO,SAAS,IAAI;;AAGtB,QAAOC,4CAAiB,KAAK;EAC3BC,0CAAe,KAAK;EACpB;EACAA,0CAAe,KAAK"}

package/dist/prebuilt/agentName.d.cts

@@ -0,0 +1,42 @@
+import { BaseMessage, BaseMessageLike } from "@langchain/core/messages";
+import { LanguageModelLike } from "@langchain/core/language_models/base";
+
+//#region src/prebuilt/agentName.d.ts
+type AgentNameMode = "inline";
+/**
+ * Attach formatted agent names to the messages passed to and from a language model.
+ *
+ * This is useful for making a message history with multiple agents more coherent.
+ *
+ * NOTE: agent name is consumed from the message.name field.
+ * If you're using an agent built with createReactAgent, name is automatically set.
+ * If you're building a custom agent, make sure to set the name on the AI message returned by the LLM.
+ *
+ * @deprecated migrated to `langchain` package.
+ *
+ * @param message - Message to add agent name formatting to
+ * @returns Message with agent name formatting
+ *
+ * @internal
+ */
+
+/**
+ * Attach formatted agent names to the messages passed to and from a language model.
+ *
+ * This is useful for making a message history with multiple agents more coherent.
+ *
+ * * @deprecated migrated to `langchain` package.
+ *
+ * NOTE: agent name is consumed from the message.name field.
+ * If you're using an agent built with createReactAgent, name is automatically set.
+ * If you're building a custom agent, make sure to set the name on the AI message returned by the LLM.
+ *
+ * @param model - Language model to add agent name formatting to
+ * @param agentNameMode - How to expose the agent name to the LLM
+ *   - "inline": Add the agent name directly into the content field of the AI message using XML-style tags.
+ *     Example: "How can I help you" -> "<name>agent_name</name><content>How can I help you?</content>".
+ */
+declare function withAgentName(model: LanguageModelLike, agentNameMode: AgentNameMode): LanguageModelLike;
+//#endregion
+export { AgentNameMode, withAgentName };
+//# sourceMappingURL=agentName.d.cts.map

package/dist/prebuilt/agentName.d.cts.map

@@ -0,0 +1 @@
+{"version":3,"file":"agentName.d.cts","names":["LanguageModelLike","AIMessage","BaseMessage","BaseMessageLike","AgentNameMode","_addInlineAgentName","T","_removeInlineAgentName","withAgentName"],"sources":["../../src/prebuilt/agentName.d.ts"],"sourcesContent":["import { LanguageModelLike } from \"@langchain/core/language_models/base\";\nimport { AIMessage, BaseMessage, BaseMessageLike } from \"@langchain/core/messages\";\nexport type AgentNameMode = \"inline\";\n/**\n * Attach formatted agent names to the messages passed to and from a language model.\n *\n * This is useful for making a message history with multiple agents more coherent.\n *\n * NOTE: agent name is consumed from the message.name field.\n * If you're using an agent built with createReactAgent, name is automatically set.\n * If you're building a custom agent, make sure to set the name on the AI message returned by the LLM.\n *\n * @deprecated migrated to `langchain` package.\n *\n * @param message - Message to add agent name formatting to\n * @returns Message with agent name formatting\n *\n * @internal\n */\nexport declare function _addInlineAgentName<T extends BaseMessageLike>(message: T): T | AIMessage;\n/**\n * Remove explicit name and content XML tags from the AI message content.\n *\n * @deprecated migrated to `langchain` package.\n *\n * Examples:\n *\n * @example\n * ```typescript\n * removeInlineAgentName(new AIMessage({ content: \"<name>assistant</name><content>Hello</content>\", name: \"assistant\" }))\n * // AIMessage with content: \"Hello\"\n *\n * removeInlineAgentName(new AIMessage({ content: [{type: \"text\", text: \"<name>assistant</name><content>Hello</content>\"}], name: \"assistant\" }))\n * // AIMessage with content: [{type: \"text\", text: \"Hello\"}]\n * ```\n *\n * @internal\n */\nexport declare function _removeInlineAgentName<T extends BaseMessage>(message: T): T;\n/**\n * Attach formatted agent names to the messages passed to and from a language model.\n *\n * This is useful for making a message history with multiple agents more coherent.\n *\n * * @deprecated migrated to `langchain` package.\n *\n * NOTE: agent name is consumed from the message.name field.\n * If you're using an agent built with createReactAgent, name is automatically set.\n * If you're building a custom agent, make sure to set the name on the AI message returned by the LLM.\n *\n * @param model - Language model to add agent name formatting to\n * @param agentNameMode - How to expose the agent name to the LLM\n *   - \"inline\": Add the agent name directly into the content field of the AI message using XML-style tags.\n *     Example: \"How can I help you\" -> \"<name>agent_name</name><content>How can I help you?</content>\".\n */\nexport declare function withAgentName(model: LanguageModelLike, agentNameMode: AgentNameMode): LanguageModelLike;\n"],"mappings":";;;;KAEYI,aAAAA;;AAAZ;AAqDA;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;iBAAwBI,aAAAA,QAAqBR,kCAAkCI,gBAAgBJ"}