langchain 0.0.195 → 0.0.197-rc.0

package/dist/prompts/base.d.ts

@@ -1,132 +1,3 @@
-import { BasePromptValue, Example, HumanMessage, InputValues, PartialValues } from "../schema/index.js";
-import { BaseOutputParser } from "../schema/output_parser.js";
-import { Serializable } from "../load/serializable.js";
-import { SerializedBasePromptTemplate } from "./serde.js";
-import { SerializedFields } from "../load/map_keys.js";
-import { Runnable } from "../schema/runnable/index.js";
-import { BaseCallbackConfig } from "../callbacks/manager.js";
-import type { StringWithAutocomplete } from "../util/types.js";
-export type TypedPromptInputValues<RunInput> = InputValues<StringWithAutocomplete<Extract<keyof RunInput, string>>>;
-/**
- * Represents a prompt value as a string. It extends the BasePromptValue
- * class and overrides the toString and toChatMessages methods.
- */
-export declare class StringPromptValue extends BasePromptValue {
-    lc_namespace: string[];
-    value: string;
-    constructor(value: string);
-    toString(): string;
-    toChatMessages(): HumanMessage[];
-}
-/**
- * Input common to all prompt templates.
- */
-export interface BasePromptTemplateInput<InputVariables extends InputValues = any, PartialVariableName extends string = any> {
-    /**
-     * A list of variable names the prompt template expects
-     */
-    inputVariables: Array<Extract<keyof InputVariables, string>>;
-    /**
-     * How to parse the output of calling an LLM on this formatted prompt
-     */
-    outputParser?: BaseOutputParser;
-    /** Partial variables */
-    partialVariables?: PartialValues<PartialVariableName>;
-}
-/**
- * Base class for prompt templates. Exposes a format method that returns a
- * string prompt given a set of input values.
- */
-export declare abstract class BasePromptTemplate<RunInput extends InputValues = any, RunOutput extends BasePromptValue = BasePromptValue, PartialVariableName extends string = any> extends Runnable<RunInput, RunOutput> implements BasePromptTemplateInput {
-    PromptValueReturnType: RunOutput;
-    lc_serializable: boolean;
-    lc_namespace: string[];
-    get lc_attributes(): SerializedFields | undefined;
-    inputVariables: Array<Extract<keyof RunInput, string>>;
-    outputParser?: BaseOutputParser;
-    partialVariables: PartialValues<PartialVariableName>;
-    constructor(input: BasePromptTemplateInput);
-    abstract partial(values: PartialValues): Promise<BasePromptTemplate<RunInput, RunOutput, PartialVariableName>>;
-    /**
-     * 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.
-     */
-    mergePartialAndUserVariables(userVariables: TypedPromptInputValues<RunInput>): Promise<InputValues<Extract<keyof RunInput, string> | PartialVariableName>>;
-    /**
-     * 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.
-     */
-    invoke(input: RunInput, options?: BaseCallbackConfig): Promise<RunOutput>;
-    /**
-     * Format the prompt given the input values.
-     *
-     * @param values - A dictionary of arguments to be passed to the prompt template.
-     * @returns A formatted prompt string.
-     *
-     * @example
-     * ```ts
-     * prompt.format({ foo: "bar" });
-     * ```
-     */
-    abstract format(values: TypedPromptInputValues<RunInput>): Promise<string>;
-    /**
-     * Format the prompt given the input values and return a formatted prompt value.
-     * @param values
-     * @returns A formatted PromptValue.
-     */
-    abstract formatPromptValue(values: TypedPromptInputValues<RunInput>): Promise<RunOutput>;
-    /**
-     * Return the string type key uniquely identifying this class of prompt template.
-     */
-    abstract _getPromptType(): string;
-    /**
-     * Return a json-like object representing this prompt template.
-     * @deprecated
-     */
-    serialize(): SerializedBasePromptTemplate;
-    /**
-     * @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 deserialize(data: SerializedBasePromptTemplate): Promise<BasePromptTemplate<InputValues, BasePromptValue, string>>;
-}
-/**
- * Base class for string prompt templates. It extends the
- * BasePromptTemplate class and overrides the formatPromptValue method to
- * return a StringPromptValue.
- */
-export declare abstract class BaseStringPromptTemplate<RunInput extends InputValues = any, PartialVariableName extends string = any> extends BasePromptTemplate<RunInput, StringPromptValue, PartialVariableName> {
-    /**
-     * 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.
-     */
-    formatPromptValue(values: TypedPromptInputValues<RunInput>): Promise<StringPromptValue>;
-}
-/**
- * Base class for example selectors.
- */
-export declare abstract class BaseExampleSelector extends Serializable {
-    lc_namespace: string[];
-    /**
-     * Adds an example to the example selector.
-     * @param example The example to add to the example selector.
-     * @returns A Promise that resolves to void or a string.
-     */
-    abstract addExample(example: Example): Promise<void | string>;
-    /**
-     * Selects examples from the example selector given the input variables.
-     * @param input_variables The input variables to select examples with.
-     * @returns A Promise that resolves to an array of selected examples.
-     */
-    abstract selectExamples(input_variables: Example): Promise<Example[]>;
-}
+export { type TypedPromptInputValues, BaseStringPromptTemplate, type BasePromptTemplateInput, BasePromptTemplate, } from "langchain-core/prompts";
+export { StringPromptValue } from "langchain-core/prompt_values";
+export { BaseExampleSelector } from "langchain-core/example_selectors";

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 { BaseStringPromptTemplate, BasePromptTemplate, } from "langchain-core/prompts";
+export { StringPromptValue } from "langchain-core/prompt_values";
+export { BaseExampleSelector } from "langchain-core/example_selectors";