@langchain/core 0.1.56 → 0.1.58

package/dist/messages/ai.cjs

@@ -32,7 +32,7 @@ class AIMessage extends base_js_1.BaseMessage {
             initParams = fields;
             const rawToolCalls = initParams.additional_kwargs?.tool_calls;
             const toolCalls = initParams.tool_calls;
-            if (rawToolCalls !== undefined &&
+            if (!(rawToolCalls == null) &&
                 rawToolCalls.length > 0 &&
                 (toolCalls === undefined || toolCalls.length === 0)) {
                 console.warn([
@@ -43,7 +43,7 @@ class AIMessage extends base_js_1.BaseMessage {
                 ].join(" "));
             }
             try {
-                if (rawToolCalls !== undefined && toolCalls === undefined) {
+                if (!(rawToolCalls == null) && toolCalls === undefined) {
                     const [toolCalls, invalidToolCalls] = (0, tool_js_1.defaultToolCallParser)(rawToolCalls);
                     initParams.tool_calls = toolCalls ?? [];
                     initParams.invalid_tool_calls = invalidToolCalls ?? [];

package/dist/messages/ai.js

@@ -29,7 +29,7 @@ export class AIMessage extends BaseMessage {
             initParams = fields;
             const rawToolCalls = initParams.additional_kwargs?.tool_calls;
             const toolCalls = initParams.tool_calls;
-            if (rawToolCalls !== undefined &&
+            if (!(rawToolCalls == null) &&
                 rawToolCalls.length > 0 &&
                 (toolCalls === undefined || toolCalls.length === 0)) {
                 console.warn([
@@ -40,7 +40,7 @@ export class AIMessage extends BaseMessage {
                 ].join(" "));
             }
             try {
-                if (rawToolCalls !== undefined && toolCalls === undefined) {
+                if (!(rawToolCalls == null) && toolCalls === undefined) {
                     const [toolCalls, invalidToolCalls] = defaultToolCallParser(rawToolCalls);
                     initParams.tool_calls = toolCalls ?? [];
                     initParams.invalid_tool_calls = invalidToolCalls ?? [];

package/dist/prompts/chat.cjs

@@ -174,8 +174,10 @@ class ChatMessagePromptTemplate extends BaseMessageStringPromptTemplate {
     async format(values) {
         return new index_js_1.ChatMessage(await this.prompt.format(values), this.role);
     }
-    static fromTemplate(template, role) {
-        return new this(prompt_js_1.PromptTemplate.fromTemplate(template), role);
+    static fromTemplate(template, role, options) {
+        return new this(prompt_js_1.PromptTemplate.fromTemplate(template, {
+            templateFormat: options?.templateFormat,
+        }), role);
     }
 }
 exports.ChatMessagePromptTemplate = ChatMessagePromptTemplate;
@@ -286,7 +288,7 @@ class _StringImageMessagePromptTemplate extends BaseMessagePromptTemplate {
     }
     static fromTemplate(template, additionalOptions) {
         if (typeof template === "string") {
-            return new this(prompt_js_1.PromptTemplate.fromTemplate(template));
+            return new this(prompt_js_1.PromptTemplate.fromTemplate(template, additionalOptions));
         }
         const prompt = [];
         for (const item of template) {
@@ -446,7 +448,7 @@ function _isBaseMessagePromptTemplate(baseMessagePromptTemplateLike) {
     return (typeof baseMessagePromptTemplateLike
         .formatMessages === "function");
 }
-function _coerceMessagePromptTemplateLike(messagePromptTemplateLike) {
+function _coerceMessagePromptTemplateLike(messagePromptTemplateLike, extra) {
     if (_isBaseMessagePromptTemplate(messagePromptTemplateLike) ||
         (0, index_js_1.isBaseMessage)(messagePromptTemplateLike)) {
         return messagePromptTemplateLike;
@@ -477,21 +479,21 @@ function _coerceMessagePromptTemplateLike(messagePromptTemplateLike) {
                 return { image_url: item.image_url };
             }
             else {
-                throw new Error("Invalid message content");
+                return item;
             }
         });
     }
     if (message._getType() === "human") {
-        return HumanMessagePromptTemplate.fromTemplate(templateData);
+        return HumanMessagePromptTemplate.fromTemplate(templateData, extra);
     }
     else if (message._getType() === "ai") {
-        return AIMessagePromptTemplate.fromTemplate(templateData);
+        return AIMessagePromptTemplate.fromTemplate(templateData, extra);
     }
     else if (message._getType() === "system") {
-        return SystemMessagePromptTemplate.fromTemplate(templateData);
+        return SystemMessagePromptTemplate.fromTemplate(templateData, extra);
     }
     else if (index_js_1.ChatMessage.isInstance(message)) {
-        return ChatMessagePromptTemplate.fromTemplate(message.content, message.role);
+        return ChatMessagePromptTemplate.fromTemplate(message.content, message.role, extra);
     }
     else {
         throw new Error(`Could not coerce message prompt template from input. Received message type: "${message._getType()}".`);
@@ -540,6 +542,17 @@ class ChatPromptTemplate extends BaseChatPromptTemplate {
             writable: true,
             value: true
         });
+        Object.defineProperty(this, "templateFormat", {
+            enumerable: true,
+            configurable: true,
+            writable: true,
+            value: "f-string"
+        });
+        // If input is mustache and validateTemplate is not defined, set it to false
+        if (input.templateFormat === "mustache" &&
+            input.validateTemplate === undefined) {
+            this.validateTemplate = false;
+        }
         Object.assign(this, input);
         if (this.validateTemplate) {
             const inputVariablesMessages = new Set();
@@ -641,11 +654,8 @@ class ChatPromptTemplate extends BaseChatPromptTemplate {
         };
         return new ChatPromptTemplate(promptDict);
     }
-    /**
-     * Load prompt template from a template f-string
-     */
-    static fromTemplate(template) {
-        const prompt = prompt_js_1.PromptTemplate.fromTemplate(template);
+    static fromTemplate(template, options) {
+        const prompt = prompt_js_1.PromptTemplate.fromTemplate(template, options);
         const humanTemplate = new HumanMessagePromptTemplate({ prompt });
         return this.fromMessages([humanTemplate]);
     }
@@ -660,7 +670,9 @@ class ChatPromptTemplate extends BaseChatPromptTemplate {
         // eslint-disable-next-line no-instanceof/no-instanceof
         promptMessage instanceof ChatPromptTemplate
             ? promptMessage.promptMessages
-            : [_coerceMessagePromptTemplateLike(promptMessage)]), []);
+            : [
+                _coerceMessagePromptTemplateLike(promptMessage, extra),
+            ]), []);
         const flattenedPartialVariables = promptMessages.reduce((acc, promptMessage) => 
         // eslint-disable-next-line no-instanceof/no-instanceof
         promptMessage instanceof ChatPromptTemplate
@@ -683,6 +695,7 @@ class ChatPromptTemplate extends BaseChatPromptTemplate {
             inputVariables: [...inputVariables],
             promptMessages: flattenedMessages,
             partialVariables: flattenedPartialVariables,
+            templateFormat: extra?.templateFormat,
         });
     }
     /** @deprecated Renamed to .fromMessages */

package/dist/prompts/chat.d.ts

@@ -5,8 +5,9 @@ import type { InputValues, PartialValues } from "../utils/types/index.js";
 import { Runnable } from "../runnables/base.js";
 import { BaseStringPromptTemplate } from "./string.js";
 import { BasePromptTemplate, type BasePromptTemplateInput, type TypedPromptInputValues } from "./base.js";
-import { type ParamsFromFString } from "./prompt.js";
+import { PromptTemplateInput, ExtractedFStringParams } from "./prompt.js";
 import { ImagePromptTemplate } from "./image.js";
+import { TemplateFormat } from "./template.js";
 /**
  * Abstract class that serves as a base for creating message prompt
  * templates. It defines how to format messages for different roles in a
@@ -96,7 +97,9 @@ export declare class ChatMessagePromptTemplate<RunInput extends InputValues = an
     constructor(prompt: BaseStringPromptTemplate<InputValues<Extract<keyof RunInput, string>>>, role: string);
     constructor(fields: ChatMessagePromptTemplateFields<InputValues<Extract<keyof RunInput, string>>>);
     format(values: RunInput): Promise<BaseMessage>;
-    static fromTemplate(template: string, role: string): ChatMessagePromptTemplate<any>;
+    static fromTemplate(template: string, role: string, options?: {
+        templateFormat?: TemplateFormat;
+    }): ChatMessagePromptTemplate<any>;
 }
 interface _TextTemplateParam {
     text?: string | Record<string, any>;
@@ -106,21 +109,24 @@ interface _ImageTemplateParam {
 }
 type MessageClass = typeof HumanMessage | typeof AIMessage | typeof SystemMessage;
 type ChatMessageClass = typeof ChatMessage;
+interface _StringImageMessagePromptTemplateOptions<Format extends TemplateFormat = TemplateFormat> extends Record<string, unknown> {
+    templateFormat?: Format;
+}
 declare class _StringImageMessagePromptTemplate<RunInput extends InputValues = any, RunOutput extends BaseMessage[] = BaseMessage[]> extends BaseMessagePromptTemplate<RunInput, RunOutput> {
     lc_namespace: string[];
     lc_serializable: boolean;
     inputVariables: Array<Extract<keyof RunInput, string>>;
-    additionalOptions: Record<string, unknown>;
+    additionalOptions: _StringImageMessagePromptTemplateOptions;
     prompt: BaseStringPromptTemplate<InputValues<Extract<keyof RunInput, string>>, string> | Array<BaseStringPromptTemplate<InputValues<Extract<keyof RunInput, string>>, string> | ImagePromptTemplate<InputValues<Extract<keyof RunInput, string>>, string> | MessageStringPromptTemplateFields<InputValues<Extract<keyof RunInput, string>>>>;
     protected messageClass?: MessageClass;
     static _messageClass(): MessageClass;
     protected chatMessageClass?: ChatMessageClass;
     constructor(
     /** @TODO When we come up with a better way to type prompt templates, fix this */
-    fields: any, additionalOptions?: Record<string, unknown>);
+    fields: any, additionalOptions?: _StringImageMessagePromptTemplateOptions);
     createMessage(content: MessageContent): any;
     getRoleFromMessageClass(name: string): "human" | "ai" | "system" | "chat";
-    static fromTemplate(template: string | Array<string | _TextTemplateParam | _ImageTemplateParam>, additionalOptions?: Record<string, unknown>): _StringImageMessagePromptTemplate<any, BaseMessage[]>;
+    static fromTemplate(template: string | Array<string | _TextTemplateParam | _ImageTemplateParam>, additionalOptions?: _StringImageMessagePromptTemplateOptions): _StringImageMessagePromptTemplate<any, BaseMessage[]>;
     format(input: TypedPromptInputValues<RunInput>): Promise<BaseMessage>;
     formatMessages(values: RunInput): Promise<RunOutput>;
 }
@@ -182,6 +188,11 @@ export interface ChatPromptTemplateInput<RunInput extends InputValues = any, Par
      * @defaultValue `true`
      */
     validateTemplate?: boolean;
+    /**
+     * The formatting method to use on the prompt.
+     * @default "f-string"
+     */
+    templateFormat?: TemplateFormat;
 }
 export type BaseMessagePromptTemplateLike = BaseMessagePromptTemplate | BaseMessageLike;
 /**
@@ -205,6 +216,7 @@ export declare class ChatPromptTemplate<RunInput extends InputValues = any, Part
     get lc_aliases(): Record<string, string>;
     promptMessages: Array<BaseMessagePromptTemplate | BaseMessage>;
     validateTemplate: boolean;
+    templateFormat: TemplateFormat;
     constructor(input: ChatPromptTemplateInput<RunInput, PartialVariableName>);
     _getPromptType(): "chat";
     private _parseImagePrompts;
@@ -213,7 +225,9 @@ export declare class ChatPromptTemplate<RunInput extends InputValues = any, Part
     /**
      * Load prompt template from a template f-string
      */
-    static fromTemplate<RunInput extends InputValues = Symbol, T extends string = string>(template: T): ChatPromptTemplate<RunInput extends Symbol ? ParamsFromFString<T> : RunInput, any>;
+    static fromTemplate<RunInput extends InputValues = Symbol, T extends string = string>(template: T, options?: Omit<PromptTemplateInput<RunInput, string, "f-string">, "template" | "inputVariables">): ChatPromptTemplate<ExtractedFStringParams<T, RunInput>>;
+    static fromTemplate<RunInput extends InputValues = Symbol, T extends string = string>(template: T, options?: Omit<PromptTemplateInput<RunInput, string>, "template" | "inputVariables">): ChatPromptTemplate<ExtractedFStringParams<T, RunInput>>;
+    static fromTemplate<RunInput extends InputValues = Symbol, T extends string = string>(template: T, options?: Omit<PromptTemplateInput<RunInput, string, "mustache">, "template" | "inputVariables">): ChatPromptTemplate<InputValues>;
     /**
      * Create a chat model-specific prompt from individual chat messages
      * or message-like tuples.

package/dist/prompts/chat.js

@@ -5,7 +5,7 @@ import { ChatPromptValue, } from "../prompt_values.js";
 import { Runnable } from "../runnables/base.js";
 import { BaseStringPromptTemplate } from "./string.js";
 import { BasePromptTemplate, } from "./base.js";
-import { PromptTemplate } from "./prompt.js";
+import { PromptTemplate, } from "./prompt.js";
 import { ImagePromptTemplate } from "./image.js";
 import { parseFString } from "./template.js";
 /**
@@ -167,8 +167,10 @@ export class ChatMessagePromptTemplate extends BaseMessageStringPromptTemplate {
     async format(values) {
         return new ChatMessage(await this.prompt.format(values), this.role);
     }
-    static fromTemplate(template, role) {
-        return new this(PromptTemplate.fromTemplate(template), role);
+    static fromTemplate(template, role, options) {
+        return new this(PromptTemplate.fromTemplate(template, {
+            templateFormat: options?.templateFormat,
+        }), role);
     }
 }
 class _StringImageMessagePromptTemplate extends BaseMessagePromptTemplate {
@@ -278,7 +280,7 @@ class _StringImageMessagePromptTemplate extends BaseMessagePromptTemplate {
     }
     static fromTemplate(template, additionalOptions) {
         if (typeof template === "string") {
-            return new this(PromptTemplate.fromTemplate(template));
+            return new this(PromptTemplate.fromTemplate(template, additionalOptions));
         }
         const prompt = [];
         for (const item of template) {
@@ -435,7 +437,7 @@ function _isBaseMessagePromptTemplate(baseMessagePromptTemplateLike) {
     return (typeof baseMessagePromptTemplateLike
         .formatMessages === "function");
 }
-function _coerceMessagePromptTemplateLike(messagePromptTemplateLike) {
+function _coerceMessagePromptTemplateLike(messagePromptTemplateLike, extra) {
     if (_isBaseMessagePromptTemplate(messagePromptTemplateLike) ||
         isBaseMessage(messagePromptTemplateLike)) {
         return messagePromptTemplateLike;
@@ -466,21 +468,21 @@ function _coerceMessagePromptTemplateLike(messagePromptTemplateLike) {
                 return { image_url: item.image_url };
             }
             else {
-                throw new Error("Invalid message content");
+                return item;
             }
         });
     }
     if (message._getType() === "human") {
-        return HumanMessagePromptTemplate.fromTemplate(templateData);
+        return HumanMessagePromptTemplate.fromTemplate(templateData, extra);
     }
     else if (message._getType() === "ai") {
-        return AIMessagePromptTemplate.fromTemplate(templateData);
+        return AIMessagePromptTemplate.fromTemplate(templateData, extra);
     }
     else if (message._getType() === "system") {
-        return SystemMessagePromptTemplate.fromTemplate(templateData);
+        return SystemMessagePromptTemplate.fromTemplate(templateData, extra);
     }
     else if (ChatMessage.isInstance(message)) {
-        return ChatMessagePromptTemplate.fromTemplate(message.content, message.role);
+        return ChatMessagePromptTemplate.fromTemplate(message.content, message.role, extra);
     }
     else {
         throw new Error(`Could not coerce message prompt template from input. Received message type: "${message._getType()}".`);
@@ -529,6 +531,17 @@ export class ChatPromptTemplate extends BaseChatPromptTemplate {
             writable: true,
             value: true
         });
+        Object.defineProperty(this, "templateFormat", {
+            enumerable: true,
+            configurable: true,
+            writable: true,
+            value: "f-string"
+        });
+        // If input is mustache and validateTemplate is not defined, set it to false
+        if (input.templateFormat === "mustache" &&
+            input.validateTemplate === undefined) {
+            this.validateTemplate = false;
+        }
         Object.assign(this, input);
         if (this.validateTemplate) {
             const inputVariablesMessages = new Set();
@@ -630,11 +643,8 @@ export class ChatPromptTemplate extends BaseChatPromptTemplate {
         };
         return new ChatPromptTemplate(promptDict);
     }
-    /**
-     * Load prompt template from a template f-string
-     */
-    static fromTemplate(template) {
-        const prompt = PromptTemplate.fromTemplate(template);
+    static fromTemplate(template, options) {
+        const prompt = PromptTemplate.fromTemplate(template, options);
         const humanTemplate = new HumanMessagePromptTemplate({ prompt });
         return this.fromMessages([humanTemplate]);
     }
@@ -649,7 +659,9 @@ export class ChatPromptTemplate extends BaseChatPromptTemplate {
         // eslint-disable-next-line no-instanceof/no-instanceof
         promptMessage instanceof ChatPromptTemplate
             ? promptMessage.promptMessages
-            : [_coerceMessagePromptTemplateLike(promptMessage)]), []);
+            : [
+                _coerceMessagePromptTemplateLike(promptMessage, extra),
+            ]), []);
         const flattenedPartialVariables = promptMessages.reduce((acc, promptMessage) => 
         // eslint-disable-next-line no-instanceof/no-instanceof
         promptMessage instanceof ChatPromptTemplate
@@ -672,6 +684,7 @@ export class ChatPromptTemplate extends BaseChatPromptTemplate {
             inputVariables: [...inputVariables],
             promptMessages: flattenedMessages,
             partialVariables: flattenedPartialVariables,
+            templateFormat: extra?.templateFormat,
         });
     }
     /** @deprecated Renamed to .fromMessages */

package/dist/prompts/prompt.cjs

@@ -44,8 +44,16 @@ class PromptTemplate extends string_js_1.BaseStringPromptTemplate {
             writable: true,
             value: true
         });
+        // If input is mustache and validateTemplate is not defined, set it to false
+        if (input.templateFormat === "mustache" &&
+            input.validateTemplate === undefined) {
+            this.validateTemplate = false;
+        }
         Object.assign(this, input);
         if (this.validateTemplate) {
+            if (this.templateFormat === "mustache") {
+                throw new Error("Mustache templates cannot be validated.");
+            }
             let totalInputVariables = this.inputVariables;
             if (this.partialVariables) {
                 totalInputVariables = totalInputVariables.concat(Object.keys(this.partialVariables));
@@ -85,10 +93,8 @@ class PromptTemplate extends string_js_1.BaseStringPromptTemplate {
             template,
         });
     }
-    /**
-     * Load prompt template from a template f-string
-     */
-    static fromTemplate(template, { templateFormat = "f-string", ...rest } = {}) {
+    static fromTemplate(template, options) {
+        const { templateFormat = "f-string", ...rest } = options ?? {};
         const names = new Set();
         (0, template_js_1.parseTemplate)(template, templateFormat).forEach((node) => {
             if (node.type === "variable") {

package/dist/prompts/prompt.d.ts

@@ -8,17 +8,15 @@ import { MessageContent } from "../messages/index.js";
  * Inputs to create a {@link PromptTemplate}
  * @augments BasePromptTemplateInput
  */
-export interface PromptTemplateInput<RunInput extends InputValues = any, PartialVariableName extends string = any> extends BasePromptTemplateInput<RunInput, PartialVariableName> {
+export interface PromptTemplateInput<RunInput extends InputValues = any, PartialVariableName extends string = any, Format extends TemplateFormat = TemplateFormat> extends BasePromptTemplateInput<RunInput, PartialVariableName> {
     /**
      * The prompt template
      */
     template: MessageContent;
     /**
-     * The format of the prompt template. Options are 'f-string'
-     *
-     * @defaultValue 'f-string'
+     * The format of the prompt template. Options are "f-string" and "mustache"
      */
-    templateFormat?: TemplateFormat;
+    templateFormat?: Format;
     /**
      * Whether or not to try validating the template on initialization
      *
@@ -36,6 +34,7 @@ type ExtractTemplateParamsRecursive<T extends string, Result extends string[] =
 export type ParamsFromFString<T extends string> = {
     [Key in ExtractTemplateParamsRecursive<T>[number] | (string & Record<never, never>)]: string;
 };
+export type ExtractedFStringParams<T extends string, RunInput extends InputValues = Symbol> = RunInput extends Symbol ? ParamsFromFString<T> : RunInput;
 /**
  * Schema to represent a basic prompt for an LLM.
  * @augments BasePromptTemplate
@@ -81,7 +80,9 @@ export declare class PromptTemplate<RunInput extends InputValues = any, PartialV
     /**
      * Load prompt template from a template f-string
      */
-    static fromTemplate<RunInput extends InputValues = Symbol, T extends string = string>(template: T, { templateFormat, ...rest }?: Omit<PromptTemplateInput<RunInput, string>, "template" | "inputVariables">): PromptTemplate<RunInput extends Symbol ? ParamsFromFString<T> : RunInput, any>;
+    static fromTemplate<RunInput extends InputValues = Symbol, T extends string = string>(template: T, options?: Omit<PromptTemplateInput<RunInput, string, "f-string">, "template" | "inputVariables">): PromptTemplate<ExtractedFStringParams<T, RunInput>>;
+    static fromTemplate<RunInput extends InputValues = Symbol, T extends string = string>(template: T, options?: Omit<PromptTemplateInput<RunInput, string>, "template" | "inputVariables">): PromptTemplate<ExtractedFStringParams<T, RunInput>>;
+    static fromTemplate<RunInput extends InputValues = Symbol, T extends string = string>(template: T, options?: Omit<PromptTemplateInput<RunInput, string, "mustache">, "template" | "inputVariables">): PromptTemplate<InputValues>;
     /**
      * Partially applies values to the prompt template.
      * @param values The values to be partially applied to the prompt template.

package/dist/prompts/prompt.js

@@ -41,8 +41,16 @@ export class PromptTemplate extends BaseStringPromptTemplate {
             writable: true,
             value: true
         });
+        // If input is mustache and validateTemplate is not defined, set it to false
+        if (input.templateFormat === "mustache" &&
+            input.validateTemplate === undefined) {
+            this.validateTemplate = false;
+        }
         Object.assign(this, input);
         if (this.validateTemplate) {
+            if (this.templateFormat === "mustache") {
+                throw new Error("Mustache templates cannot be validated.");
+            }
             let totalInputVariables = this.inputVariables;
             if (this.partialVariables) {
                 totalInputVariables = totalInputVariables.concat(Object.keys(this.partialVariables));
@@ -82,10 +90,8 @@ export class PromptTemplate extends BaseStringPromptTemplate {
             template,
         });
     }
-    /**
-     * Load prompt template from a template f-string
-     */
-    static fromTemplate(template, { templateFormat = "f-string", ...rest } = {}) {
+    static fromTemplate(template, options) {
+        const { templateFormat = "f-string", ...rest } = options ?? {};
         const names = new Set();
         parseTemplate(template, templateFormat).forEach((node) => {
             if (node.type === "variable") {

package/dist/prompts/template.cjs

@@ -1,6 +1,10 @@
 "use strict";
+var __importDefault = (this && this.__importDefault) || function (mod) {
+    return (mod && mod.__esModule) ? mod : { "default": mod };
+};
 Object.defineProperty(exports, "__esModule", { value: true });
-exports.checkValidTemplate = exports.parseTemplate = exports.renderTemplate = exports.DEFAULT_PARSER_MAPPING = exports.DEFAULT_FORMATTER_MAPPING = exports.interpolateFString = exports.parseFString = void 0;
+exports.checkValidTemplate = exports.parseTemplate = exports.renderTemplate = exports.DEFAULT_PARSER_MAPPING = exports.DEFAULT_FORMATTER_MAPPING = exports.interpolateMustache = exports.interpolateFString = exports.parseMustache = exports.parseFString = void 0;
+const mustache_1 = __importDefault(require("mustache"));
 const parseFString = (template) => {
     // Core logic replicated from internals of pythons built in Formatter class.
     // https://github.com/python/cpython/blob/135ec7cefbaffd516b77362ad2b2ad1025af462e/Objects/stringlib/unicode_format.h#L700-L706
@@ -50,21 +54,49 @@ const parseFString = (template) => {
     return nodes;
 };
 exports.parseFString = parseFString;
+/**
+ * Convert the result of mustache.parse into an array of ParsedTemplateNode,
+ * to make it compatible with other LangChain string parsing template formats.
+ *
+ * @param {mustache.TemplateSpans} template The result of parsing a mustache template with the mustache.js library.
+ * @returns {ParsedTemplateNode[]}
+ */
+const mustacheTemplateToNodes = (template) => template.map((temp) => {
+    if (temp[0] === "name") {
+        const name = temp[1].includes(".") ? temp[1].split(".")[0] : temp[1];
+        return { type: "variable", name };
+    }
+    else if (temp[0] === "#") {
+        return { type: "variable", name: temp[1] };
+    }
+    else {
+        return { type: "literal", text: temp[1] };
+    }
+});
+const parseMustache = (template) => {
+    const parsed = mustache_1.default.parse(template);
+    return mustacheTemplateToNodes(parsed);
+};
+exports.parseMustache = parseMustache;
 const interpolateFString = (template, values) => (0, exports.parseFString)(template).reduce((res, node) => {
     if (node.type === "variable") {
         if (node.name in values) {
             return res + values[node.name];
         }
-        throw new Error(`Missing value for input ${node.name}`);
+        throw new Error(`(f-string) Missing value for input ${node.name}`);
     }
     return res + node.text;
 }, "");
 exports.interpolateFString = interpolateFString;
+const interpolateMustache = (template, values) => mustache_1.default.render(template, values);
+exports.interpolateMustache = interpolateMustache;
 exports.DEFAULT_FORMATTER_MAPPING = {
     "f-string": exports.interpolateFString,
+    mustache: exports.interpolateMustache,
 };
 exports.DEFAULT_PARSER_MAPPING = {
     "f-string": exports.parseFString,
+    mustache: exports.parseMustache,
 };
 const renderTemplate = (template, templateFormat, inputValues) => exports.DEFAULT_FORMATTER_MAPPING[templateFormat](template, inputValues);
 exports.renderTemplate = renderTemplate;

package/dist/prompts/template.d.ts

@@ -1,23 +1,29 @@
 import { MessageContent } from "../messages/index.js";
 import type { InputValues } from "../utils/types/index.js";
 /**
- * Type that specifies the format of a template. Only
- * "f-string" is supported currently.
+ * Type that specifies the format of a template.
  */
-export type TemplateFormat = "f-string";
+export type TemplateFormat = "f-string" | "mustache";
 /**
  * Type that represents a node in a parsed format string. It can be either
  * a literal text or a variable name.
  */
-export type ParsedFStringNode = {
+export type ParsedTemplateNode = {
     type: "literal";
     text: string;
 } | {
     type: "variable";
     name: string;
 };
-export declare const parseFString: (template: string) => ParsedFStringNode[];
+/**
+ * Alias for `ParsedTemplateNode` since it is the same for
+ * both f-string and mustache templates.
+ */
+export type ParsedFStringNode = ParsedTemplateNode;
+export declare const parseFString: (template: string) => ParsedTemplateNode[];
+export declare const parseMustache: (template: string) => ParsedTemplateNode[];
 export declare const interpolateFString: (template: string, values: InputValues) => string;
+export declare const interpolateMustache: (template: string, values: InputValues) => string;
 /**
  * Type that represents a function that takes a template string and a set
  * of input values, and returns a string where all variables in the
@@ -26,12 +32,12 @@ export declare const interpolateFString: (template: string, values: InputValues)
 type Interpolator = (template: string, values: InputValues) => string;
 /**
  * Type that represents a function that takes a template string and
- * returns an array of `ParsedFStringNode`.
+ * returns an array of `ParsedTemplateNode`.
  */
-type Parser = (template: string) => ParsedFStringNode[];
+type Parser = (template: string) => ParsedTemplateNode[];
 export declare const DEFAULT_FORMATTER_MAPPING: Record<TemplateFormat, Interpolator>;
 export declare const DEFAULT_PARSER_MAPPING: Record<TemplateFormat, Parser>;
 export declare const renderTemplate: (template: string, templateFormat: TemplateFormat, inputValues: InputValues) => string;
-export declare const parseTemplate: (template: string, templateFormat: TemplateFormat) => ParsedFStringNode[];
+export declare const parseTemplate: (template: string, templateFormat: TemplateFormat) => ParsedTemplateNode[];
 export declare const checkValidTemplate: (template: MessageContent, templateFormat: TemplateFormat, inputVariables: string[]) => void;
 export {};

package/dist/prompts/template.js

@@ -1,3 +1,4 @@
+import mustache from "mustache";
 export const parseFString = (template) => {
     // Core logic replicated from internals of pythons built in Formatter class.
     // https://github.com/python/cpython/blob/135ec7cefbaffd516b77362ad2b2ad1025af462e/Objects/stringlib/unicode_format.h#L700-L706
@@ -46,20 +47,46 @@ export const parseFString = (template) => {
     }
     return nodes;
 };
+/**
+ * Convert the result of mustache.parse into an array of ParsedTemplateNode,
+ * to make it compatible with other LangChain string parsing template formats.
+ *
+ * @param {mustache.TemplateSpans} template The result of parsing a mustache template with the mustache.js library.
+ * @returns {ParsedTemplateNode[]}
+ */
+const mustacheTemplateToNodes = (template) => template.map((temp) => {
+    if (temp[0] === "name") {
+        const name = temp[1].includes(".") ? temp[1].split(".")[0] : temp[1];
+        return { type: "variable", name };
+    }
+    else if (temp[0] === "#") {
+        return { type: "variable", name: temp[1] };
+    }
+    else {
+        return { type: "literal", text: temp[1] };
+    }
+});
+export const parseMustache = (template) => {
+    const parsed = mustache.parse(template);
+    return mustacheTemplateToNodes(parsed);
+};
 export const interpolateFString = (template, values) => parseFString(template).reduce((res, node) => {
     if (node.type === "variable") {
         if (node.name in values) {
             return res + values[node.name];
         }
-        throw new Error(`Missing value for input ${node.name}`);
+        throw new Error(`(f-string) Missing value for input ${node.name}`);
     }
     return res + node.text;
 }, "");
+export const interpolateMustache = (template, values) => mustache.render(template, values);
 export const DEFAULT_FORMATTER_MAPPING = {
     "f-string": interpolateFString,
+    mustache: interpolateMustache,
 };
 export const DEFAULT_PARSER_MAPPING = {
     "f-string": parseFString,
+    mustache: parseMustache,
 };
 export const renderTemplate = (template, templateFormat, inputValues) => DEFAULT_FORMATTER_MAPPING[templateFormat](template, inputValues);
 export const parseTemplate = (template, templateFormat) => DEFAULT_PARSER_MAPPING[templateFormat](template);

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@langchain/core",
-  "version": "0.1.56",
+  "version": "0.1.58",
   "description": "Core LangChain.js abstractions and schemas",
   "type": "module",
   "engines": {
@@ -46,6 +46,7 @@
     "js-tiktoken": "^1.0.8",
     "langsmith": "~0.1.7",
     "ml-distance": "^4.0.0",
+    "mustache": "^4.2.0",
     "p-queue": "^6.6.2",
     "p-retry": "4",
     "uuid": "^9.0.0",
@@ -57,6 +58,7 @@
     "@langchain/scripts": "~0.0",
     "@swc/core": "^1.3.90",
     "@swc/jest": "^0.2.29",
+    "@types/mustache": "^4",
     "dpdm": "^3.12.0",
     "eslint": "^8.33.0",
     "eslint-config-airbnb-base": "^15.0.0",