langchain 0.0.194 → 0.0.196

package/dist/prompts/base.js

@@ -1,178 +1,3 @@
-// Default generic "any" values are for backwards compatibility.
-// Replace with "string" when we are comfortable with a breaking change.
-import { BasePromptValue, HumanMessage, } from "../schema/index.js";
-import { Serializable } from "../load/serializable.js";
-import { Runnable } from "../schema/runnable/index.js";
-/**
- * Represents a prompt value as a string. It extends the BasePromptValue
- * class and overrides the toString and toChatMessages methods.
- */
-export class StringPromptValue extends BasePromptValue {
-    constructor(value) {
-        super({ value });
-        Object.defineProperty(this, "lc_namespace", {
-            enumerable: true,
-            configurable: true,
-            writable: true,
-            value: ["langchain", "prompts", "base"]
-        });
-        Object.defineProperty(this, "value", {
-            enumerable: true,
-            configurable: true,
-            writable: true,
-            value: void 0
-        });
-        this.value = value;
-    }
-    toString() {
-        return this.value;
-    }
-    toChatMessages() {
-        return [new HumanMessage(this.value)];
-    }
-}
-/**
- * Base class for prompt templates. Exposes a format method that returns a
- * string prompt given a set of input values.
- */
-export class BasePromptTemplate extends Runnable {
-    get lc_attributes() {
-        return {
-            partialVariables: undefined, // python doesn't support this yet
-        };
-    }
-    constructor(input) {
-        super(input);
-        Object.defineProperty(this, "lc_serializable", {
-            enumerable: true,
-            configurable: true,
-            writable: true,
-            value: true
-        });
-        Object.defineProperty(this, "lc_namespace", {
-            enumerable: true,
-            configurable: true,
-            writable: true,
-            value: ["langchain", "prompts", this._getPromptType()]
-        });
-        Object.defineProperty(this, "inputVariables", {
-            enumerable: true,
-            configurable: true,
-            writable: true,
-            value: void 0
-        });
-        Object.defineProperty(this, "outputParser", {
-            enumerable: true,
-            configurable: true,
-            writable: true,
-            value: void 0
-        });
-        Object.defineProperty(this, "partialVariables", {
-            enumerable: true,
-            configurable: true,
-            writable: true,
-            value: void 0
-        });
-        const { inputVariables } = input;
-        if (inputVariables.includes("stop")) {
-            throw new Error("Cannot have an input variable named 'stop', as it is used internally, please rename.");
-        }
-        Object.assign(this, input);
-    }
-    /**
-     * Merges partial variables and user variables.
-     * @param userVariables The user variables to merge with the partial variables.
-     * @returns A Promise that resolves to an object containing the merged variables.
-     */
-    async mergePartialAndUserVariables(userVariables) {
-        const partialVariables = this.partialVariables ?? {};
-        const partialValues = {};
-        for (const [key, value] of Object.entries(partialVariables)) {
-            if (typeof value === "string") {
-                partialValues[key] = value;
-            }
-            else {
-                partialValues[key] = await value();
-            }
-        }
-        const allKwargs = {
-            ...partialValues,
-            ...userVariables,
-        };
-        return allKwargs;
-    }
-    /**
-     * Invokes the prompt template with the given input and options.
-     * @param input The input to invoke the prompt template with.
-     * @param options Optional configuration for the callback.
-     * @returns A Promise that resolves to the output of the prompt template.
-     */
-    async invoke(input, options) {
-        return this._callWithConfig((input) => this.formatPromptValue(input), input, { ...options, runType: "prompt" });
-    }
-    /**
-     * Return a json-like object representing this prompt template.
-     * @deprecated
-     */
-    serialize() {
-        throw new Error("Use .toJSON() instead");
-    }
-    /**
-     * @deprecated
-     * Load a prompt template from a json-like object describing it.
-     *
-     * @remarks
-     * Deserializing needs to be async because templates (e.g. {@link FewShotPromptTemplate}) can
-     * reference remote resources that we read asynchronously with a web
-     * request.
-     */
-    static async deserialize(data) {
-        switch (data._type) {
-            case "prompt": {
-                const { PromptTemplate } = await import("./prompt.js");
-                return PromptTemplate.deserialize(data);
-            }
-            case undefined: {
-                const { PromptTemplate } = await import("./prompt.js");
-                return PromptTemplate.deserialize({ ...data, _type: "prompt" });
-            }
-            case "few_shot": {
-                const { FewShotPromptTemplate } = await import("./few_shot.js");
-                return FewShotPromptTemplate.deserialize(data);
-            }
-            default:
-                throw new Error(`Invalid prompt type in config: ${data._type}`);
-        }
-    }
-}
-/**
- * Base class for string prompt templates. It extends the
- * BasePromptTemplate class and overrides the formatPromptValue method to
- * return a StringPromptValue.
- */
-export class BaseStringPromptTemplate extends BasePromptTemplate {
-    /**
-     * Formats the prompt given the input values and returns a formatted
-     * prompt value.
-     * @param values The input values to format the prompt.
-     * @returns A Promise that resolves to a formatted prompt value.
-     */
-    async formatPromptValue(values) {
-        const formattedPrompt = await this.format(values);
-        return new StringPromptValue(formattedPrompt);
-    }
-}
-/**
- * Base class for example selectors.
- */
-export class BaseExampleSelector extends Serializable {
-    constructor() {
-        super(...arguments);
-        Object.defineProperty(this, "lc_namespace", {
-            enumerable: true,
-            configurable: true,
-            writable: true,
-            value: ["langchain", "prompts", "selectors"]
-        });
-    }
-}
+export { StringPromptValue, BaseStringPromptTemplate, } from "langchain-core/prompts/base";
+export { BasePromptTemplate, } from "langchain-core/schema/prompt_template";
+export { BaseExampleSelector } from "langchain-core/prompts/example_selector/base";

package/dist/prompts/chat.cjs

@@ -1,479 +1,17 @@
 "use strict";
-// Default generic "any" values are for backwards compatibility.
-// Replace with "string" when we are comfortable with a breaking change.
+var __createBinding = (this && this.__createBinding) || (Object.create ? (function(o, m, k, k2) {
+    if (k2 === undefined) k2 = k;
+    var desc = Object.getOwnPropertyDescriptor(m, k);
+    if (!desc || ("get" in desc ? !m.__esModule : desc.writable || desc.configurable)) {
+      desc = { enumerable: true, get: function() { return m[k]; } };
+    }
+    Object.defineProperty(o, k2, desc);
+}) : (function(o, m, k, k2) {
+    if (k2 === undefined) k2 = k;
+    o[k2] = m[k];
+}));
+var __exportStar = (this && this.__exportStar) || function(m, exports) {
+    for (var p in m) if (p !== "default" && !Object.prototype.hasOwnProperty.call(exports, p)) __createBinding(exports, m, p);
+};
 Object.defineProperty(exports, "__esModule", { value: true });
-exports.ChatPromptTemplate = exports.SystemMessagePromptTemplate = exports.AIMessagePromptTemplate = exports.HumanMessagePromptTemplate = exports.ChatMessagePromptTemplate = exports.BaseChatPromptTemplate = exports.BaseMessageStringPromptTemplate = exports.MessagesPlaceholder = exports.ChatPromptValue = exports.BaseMessagePromptTemplate = void 0;
-const base_js_1 = require("../memory/base.cjs");
-const index_js_1 = require("../schema/index.cjs");
-const index_js_2 = require("../schema/runnable/index.cjs");
-const base_js_2 = require("./base.cjs");
-const prompt_js_1 = require("./prompt.cjs");
-/**
- * Abstract class that serves as a base for creating message prompt
- * templates. It defines how to format messages for different roles in a
- * conversation.
- */
-class BaseMessagePromptTemplate extends index_js_2.Runnable {
-    constructor() {
-        super(...arguments);
-        Object.defineProperty(this, "lc_namespace", {
-            enumerable: true,
-            configurable: true,
-            writable: true,
-            value: ["langchain", "prompts", "chat"]
-        });
-        Object.defineProperty(this, "lc_serializable", {
-            enumerable: true,
-            configurable: true,
-            writable: true,
-            value: true
-        });
-    }
-    /**
-     * Calls the formatMessages method with the provided input and options.
-     * @param input Input for the formatMessages method
-     * @param options Optional BaseCallbackConfig
-     * @returns Formatted output messages
-     */
-    async invoke(input, options) {
-        return this._callWithConfig((input) => this.formatMessages(input), input, { ...options, runType: "prompt" });
-    }
-}
-exports.BaseMessagePromptTemplate = BaseMessagePromptTemplate;
-/**
- * Class that represents a chat prompt value. It extends the
- * BasePromptValue and includes an array of BaseMessage instances.
- */
-class ChatPromptValue extends index_js_1.BasePromptValue {
-    static lc_name() {
-        return "ChatPromptValue";
-    }
-    constructor(fields) {
-        if (Array.isArray(fields)) {
-            // eslint-disable-next-line no-param-reassign
-            fields = { messages: fields };
-        }
-        super(fields);
-        Object.defineProperty(this, "lc_namespace", {
-            enumerable: true,
-            configurable: true,
-            writable: true,
-            value: ["langchain", "prompts", "chat"]
-        });
-        Object.defineProperty(this, "lc_serializable", {
-            enumerable: true,
-            configurable: true,
-            writable: true,
-            value: true
-        });
-        Object.defineProperty(this, "messages", {
-            enumerable: true,
-            configurable: true,
-            writable: true,
-            value: void 0
-        });
-        this.messages = fields.messages;
-    }
-    toString() {
-        return (0, base_js_1.getBufferString)(this.messages);
-    }
-    toChatMessages() {
-        return this.messages;
-    }
-}
-exports.ChatPromptValue = ChatPromptValue;
-/**
- * Class that represents a placeholder for messages in a chat prompt. It
- * extends the BaseMessagePromptTemplate.
- */
-class MessagesPlaceholder extends BaseMessagePromptTemplate {
-    static lc_name() {
-        return "MessagesPlaceholder";
-    }
-    constructor(fields) {
-        if (typeof fields === "string") {
-            // eslint-disable-next-line no-param-reassign
-            fields = { variableName: fields };
-        }
-        super(fields);
-        Object.defineProperty(this, "variableName", {
-            enumerable: true,
-            configurable: true,
-            writable: true,
-            value: void 0
-        });
-        this.variableName = fields.variableName;
-    }
-    get inputVariables() {
-        return [this.variableName];
-    }
-    validateInputOrThrow(input, variableName) {
-        let isInputBaseMessage = false;
-        if (Array.isArray(input)) {
-            isInputBaseMessage = input.every((message) => (0, index_js_1.isBaseMessage)(message));
-        }
-        else {
-            isInputBaseMessage = (0, index_js_1.isBaseMessage)(input);
-        }
-        if (!isInputBaseMessage) {
-            const readableInput = typeof input === "string" ? input : JSON.stringify(input, null, 2);
-            const error = new Error(`Error: Field "${variableName}" in prompt uses a MessagesPlaceholder, which expects an array of BaseMessages as an input value. Received: ${readableInput}`);
-            error.name = "InputFormatError";
-            throw error;
-        }
-        return true;
-    }
-    async formatMessages(values) {
-        this.validateInputOrThrow(values[this.variableName], this.variableName);
-        return values[this.variableName];
-    }
-}
-exports.MessagesPlaceholder = MessagesPlaceholder;
-/**
- * Abstract class that serves as a base for creating message string prompt
- * templates. It extends the BaseMessagePromptTemplate.
- */
-class BaseMessageStringPromptTemplate extends BaseMessagePromptTemplate {
-    constructor(fields) {
-        if (!("prompt" in fields)) {
-            // eslint-disable-next-line no-param-reassign
-            fields = { prompt: fields };
-        }
-        super(fields);
-        Object.defineProperty(this, "prompt", {
-            enumerable: true,
-            configurable: true,
-            writable: true,
-            value: void 0
-        });
-        this.prompt = fields.prompt;
-    }
-    get inputVariables() {
-        return this.prompt.inputVariables;
-    }
-    async formatMessages(values) {
-        return [await this.format(values)];
-    }
-}
-exports.BaseMessageStringPromptTemplate = BaseMessageStringPromptTemplate;
-/**
- * Abstract class that serves as a base for creating chat prompt
- * templates. It extends the BasePromptTemplate.
- */
-class BaseChatPromptTemplate extends base_js_2.BasePromptTemplate {
-    constructor(input) {
-        super(input);
-    }
-    async format(values) {
-        return (await this.formatPromptValue(values)).toString();
-    }
-    async formatPromptValue(values) {
-        const resultMessages = await this.formatMessages(values);
-        return new ChatPromptValue(resultMessages);
-    }
-}
-exports.BaseChatPromptTemplate = BaseChatPromptTemplate;
-/**
- * Class that represents a chat message prompt template. It extends the
- * BaseMessageStringPromptTemplate.
- */
-class ChatMessagePromptTemplate extends BaseMessageStringPromptTemplate {
-    static lc_name() {
-        return "ChatMessagePromptTemplate";
-    }
-    constructor(fields, role) {
-        if (!("prompt" in fields)) {
-            // eslint-disable-next-line no-param-reassign, @typescript-eslint/no-non-null-assertion
-            fields = { prompt: fields, role: role };
-        }
-        super(fields);
-        Object.defineProperty(this, "role", {
-            enumerable: true,
-            configurable: true,
-            writable: true,
-            value: void 0
-        });
-        this.role = fields.role;
-    }
-    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);
-    }
-}
-exports.ChatMessagePromptTemplate = ChatMessagePromptTemplate;
-/**
- * Class that represents a human message prompt template. It extends the
- * BaseMessageStringPromptTemplate.
- * @example
- * ```typescript
- * const message = HumanMessagePromptTemplate.fromTemplate("{text}");
- * const formatted = await message.format({ text: "Hello world!" });
- *
- * const chatPrompt = ChatPromptTemplate.fromMessages([message]);
- * const formattedChatPrompt = await chatPrompt.invoke({
- *   text: "Hello world!",
- * });
- * ```
- */
-class HumanMessagePromptTemplate extends BaseMessageStringPromptTemplate {
-    static lc_name() {
-        return "HumanMessagePromptTemplate";
-    }
-    async format(values) {
-        return new index_js_1.HumanMessage(await this.prompt.format(values));
-    }
-    static fromTemplate(template) {
-        return new this(prompt_js_1.PromptTemplate.fromTemplate(template));
-    }
-}
-exports.HumanMessagePromptTemplate = HumanMessagePromptTemplate;
-/**
- * Class that represents an AI message prompt template. It extends the
- * BaseMessageStringPromptTemplate.
- */
-class AIMessagePromptTemplate extends BaseMessageStringPromptTemplate {
-    static lc_name() {
-        return "AIMessagePromptTemplate";
-    }
-    async format(values) {
-        return new index_js_1.AIMessage(await this.prompt.format(values));
-    }
-    static fromTemplate(template) {
-        return new this(prompt_js_1.PromptTemplate.fromTemplate(template));
-    }
-}
-exports.AIMessagePromptTemplate = AIMessagePromptTemplate;
-/**
- * Class that represents a system message prompt template. It extends the
- * BaseMessageStringPromptTemplate.
- * @example
- * ```typescript
- * const message = SystemMessagePromptTemplate.fromTemplate("{text}");
- * const formatted = await message.format({ text: "Hello world!" });
- *
- * const chatPrompt = ChatPromptTemplate.fromMessages([message]);
- * const formattedChatPrompt = await chatPrompt.invoke({
- *   text: "Hello world!",
- * });
- * ```
- */
-class SystemMessagePromptTemplate extends BaseMessageStringPromptTemplate {
-    static lc_name() {
-        return "SystemMessagePromptTemplate";
-    }
-    async format(values) {
-        return new index_js_1.SystemMessage(await this.prompt.format(values));
-    }
-    static fromTemplate(template) {
-        return new this(prompt_js_1.PromptTemplate.fromTemplate(template));
-    }
-}
-exports.SystemMessagePromptTemplate = SystemMessagePromptTemplate;
-function _isBaseMessagePromptTemplate(baseMessagePromptTemplateLike) {
-    return (typeof baseMessagePromptTemplateLike
-        .formatMessages === "function");
-}
-function _coerceMessagePromptTemplateLike(messagePromptTemplateLike) {
-    if (_isBaseMessagePromptTemplate(messagePromptTemplateLike) ||
-        (0, index_js_1.isBaseMessage)(messagePromptTemplateLike)) {
-        return messagePromptTemplateLike;
-    }
-    const message = (0, index_js_1.coerceMessageLikeToMessage)(messagePromptTemplateLike);
-    if (message._getType() === "human") {
-        return HumanMessagePromptTemplate.fromTemplate(message.content);
-    }
-    else if (message._getType() === "ai") {
-        return AIMessagePromptTemplate.fromTemplate(message.content);
-    }
-    else if (message._getType() === "system") {
-        return SystemMessagePromptTemplate.fromTemplate(message.content);
-    }
-    else if (index_js_1.ChatMessage.isInstance(message)) {
-        return ChatMessagePromptTemplate.fromTemplate(message.content, message.role);
-    }
-    else {
-        throw new Error(`Could not coerce message prompt template from input. Received message type: "${message._getType()}".`);
-    }
-}
-/**
- * Class that represents a chat prompt. It extends the
- * BaseChatPromptTemplate and uses an array of BaseMessagePromptTemplate
- * instances to format a series of messages for a conversation.
- * @example
- * ```typescript
- * const message = SystemMessagePromptTemplate.fromTemplate("{text}");
- * const chatPrompt = ChatPromptTemplate.fromMessages([
- *   ["ai", "You are a helpful assistant."],
- *   message,
- * ]);
- * const formattedChatPrompt = await chatPrompt.invoke({
- *   text: "Hello world!",
- * });
- * ```
- */
-class ChatPromptTemplate extends BaseChatPromptTemplate {
-    static lc_name() {
-        return "ChatPromptTemplate";
-    }
-    get lc_aliases() {
-        return {
-            promptMessages: "messages",
-        };
-    }
-    constructor(input) {
-        super(input);
-        Object.defineProperty(this, "promptMessages", {
-            enumerable: true,
-            configurable: true,
-            writable: true,
-            value: void 0
-        });
-        Object.defineProperty(this, "validateTemplate", {
-            enumerable: true,
-            configurable: true,
-            writable: true,
-            value: true
-        });
-        Object.assign(this, input);
-        if (this.validateTemplate) {
-            const inputVariablesMessages = new Set();
-            for (const promptMessage of this.promptMessages) {
-                // eslint-disable-next-line no-instanceof/no-instanceof
-                if (promptMessage instanceof index_js_1.BaseMessage)
-                    continue;
-                for (const inputVariable of promptMessage.inputVariables) {
-                    inputVariablesMessages.add(inputVariable);
-                }
-            }
-            const totalInputVariables = this.inputVariables;
-            const inputVariablesInstance = new Set(this.partialVariables
-                ? totalInputVariables.concat(Object.keys(this.partialVariables))
-                : totalInputVariables);
-            const difference = new Set([...inputVariablesInstance].filter((x) => !inputVariablesMessages.has(x)));
-            if (difference.size > 0) {
-                throw new Error(`Input variables \`${[
-                    ...difference,
-                ]}\` are not used in any of the prompt messages.`);
-            }
-            const otherDifference = new Set([...inputVariablesMessages].filter((x) => !inputVariablesInstance.has(x)));
-            if (otherDifference.size > 0) {
-                throw new Error(`Input variables \`${[
-                    ...otherDifference,
-                ]}\` are used in prompt messages but not in the prompt template.`);
-            }
-        }
-    }
-    _getPromptType() {
-        return "chat";
-    }
-    async _parseImagePrompts(message, inputValues) {
-        if (typeof message.content === "string") {
-            return message;
-        }
-        const formattedMessageContent = await Promise.all(message.content.map(async (item) => {
-            if (item.type !== "image_url" ||
-                typeof item.image_url === "string" ||
-                !item.image_url?.url) {
-                return item;
-            }
-            const imageUrl = item.image_url.url;
-            const promptTemplatePlaceholder = prompt_js_1.PromptTemplate.fromTemplate(imageUrl);
-            const formattedUrl = await promptTemplatePlaceholder.format(inputValues);
-            // eslint-disable-next-line no-param-reassign
-            item.image_url.url = formattedUrl;
-            return item;
-        }));
-        // eslint-disable-next-line no-param-reassign
-        message.content = formattedMessageContent;
-        return message;
-    }
-    async formatMessages(values) {
-        const allValues = await this.mergePartialAndUserVariables(values);
-        let resultMessages = [];
-        for (const promptMessage of this.promptMessages) {
-            // eslint-disable-next-line no-instanceof/no-instanceof
-            if (promptMessage instanceof index_js_1.BaseMessage) {
-                resultMessages.push(await this._parseImagePrompts(promptMessage, allValues));
-            }
-            else {
-                const inputValues = promptMessage.inputVariables.reduce((acc, inputVariable) => {
-                    if (!(inputVariable in allValues)) {
-                        throw new Error(`Missing value for input variable \`${inputVariable.toString()}\``);
-                    }
-                    acc[inputVariable] = allValues[inputVariable];
-                    return acc;
-                }, {});
-                const message = await promptMessage.formatMessages(inputValues);
-                resultMessages = resultMessages.concat(message);
-            }
-        }
-        return resultMessages;
-    }
-    async partial(values) {
-        // This is implemented in a way it doesn't require making
-        // BaseMessagePromptTemplate aware of .partial()
-        const newInputVariables = this.inputVariables.filter((iv) => !(iv in values));
-        const newPartialVariables = {
-            ...(this.partialVariables ?? {}),
-            ...values,
-        };
-        const promptDict = {
-            ...this,
-            inputVariables: newInputVariables,
-            partialVariables: newPartialVariables,
-        };
-        return new ChatPromptTemplate(promptDict);
-    }
-    /**
-     * Load prompt template from a template f-string
-     */
-    static fromTemplate(template) {
-        const prompt = prompt_js_1.PromptTemplate.fromTemplate(template);
-        const humanTemplate = new HumanMessagePromptTemplate({ prompt });
-        return this.fromMessages([humanTemplate]);
-    }
-    /**
-     * Create a chat model-specific prompt from individual chat messages
-     * or message-like tuples.
-     * @param promptMessages Messages to be passed to the chat model
-     * @returns A new ChatPromptTemplate
-     */
-    // eslint-disable-next-line @typescript-eslint/no-explicit-any
-    static fromMessages(promptMessages) {
-        const flattenedMessages = promptMessages.reduce((acc, promptMessage) => acc.concat(
-        // eslint-disable-next-line no-instanceof/no-instanceof
-        promptMessage instanceof ChatPromptTemplate
-            ? promptMessage.promptMessages
-            : [_coerceMessagePromptTemplateLike(promptMessage)]), []);
-        const flattenedPartialVariables = promptMessages.reduce((acc, promptMessage) => 
-        // eslint-disable-next-line no-instanceof/no-instanceof
-        promptMessage instanceof ChatPromptTemplate
-            ? Object.assign(acc, promptMessage.partialVariables)
-            : acc, Object.create(null));
-        const inputVariables = new Set();
-        for (const promptMessage of flattenedMessages) {
-            // eslint-disable-next-line no-instanceof/no-instanceof
-            if (promptMessage instanceof index_js_1.BaseMessage)
-                continue;
-            for (const inputVariable of promptMessage.inputVariables) {
-                if (inputVariable in flattenedPartialVariables) {
-                    continue;
-                }
-                inputVariables.add(inputVariable);
-            }
-        }
-        return new ChatPromptTemplate({
-            inputVariables: [...inputVariables],
-            promptMessages: flattenedMessages,
-            partialVariables: flattenedPartialVariables,
-        });
-    }
-    /** @deprecated Renamed to .fromMessages */
-    // eslint-disable-next-line @typescript-eslint/no-explicit-any
-    static fromPromptMessages(promptMessages) {
-        return this.fromMessages(promptMessages);
-    }
-}
-exports.ChatPromptTemplate = ChatPromptTemplate;
+__exportStar(require("langchain-core/prompts/chat"), exports);