langchain 0.0.195 → 0.0.197-rc.0

package/dist/load/serializable.cjs

@@ -1,180 +1,17 @@
 "use strict";
+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.Serializable = exports.get_lc_unique_name = void 0;
-const map_keys_js_1 = require("./map_keys.cjs");
-function shallowCopy(obj) {
-    return Array.isArray(obj) ? [...obj] : { ...obj };
-}
-function replaceSecrets(root, secretsMap) {
-    const result = shallowCopy(root);
-    for (const [path, secretId] of Object.entries(secretsMap)) {
-        const [last, ...partsReverse] = path.split(".").reverse();
-        // eslint-disable-next-line @typescript-eslint/no-explicit-any
-        let current = result;
-        for (const part of partsReverse.reverse()) {
-            if (current[part] === undefined) {
-                break;
-            }
-            current[part] = shallowCopy(current[part]);
-            current = current[part];
-        }
-        if (current[last] !== undefined) {
-            current[last] = {
-                lc: 1,
-                type: "secret",
-                id: [secretId],
-            };
-        }
-    }
-    return result;
-}
-/**
- * Get a unique name for the module, rather than parent class implementations.
- * Should not be subclassed, subclass lc_name above instead.
- */
-function get_lc_unique_name(
-// eslint-disable-next-line @typescript-eslint/no-use-before-define
-serializableClass) {
-    // "super" here would refer to the parent class of Serializable,
-    // when we want the parent class of the module actually calling this method.
-    const parentClass = Object.getPrototypeOf(serializableClass);
-    const lcNameIsSubclassed = typeof serializableClass.lc_name === "function" &&
-        (typeof parentClass.lc_name !== "function" ||
-            serializableClass.lc_name() !== parentClass.lc_name());
-    if (lcNameIsSubclassed) {
-        return serializableClass.lc_name();
-    }
-    else {
-        return serializableClass.name;
-    }
-}
-exports.get_lc_unique_name = get_lc_unique_name;
-class Serializable {
-    /**
-     * The name of the serializable. Override to provide an alias or
-     * to preserve the serialized module name in minified environments.
-     *
-     * Implemented as a static method to support loading logic.
-     */
-    static lc_name() {
-        return this.name;
-    }
-    /**
-     * The final serialized identifier for the module.
-     */
-    get lc_id() {
-        return [
-            ...this.lc_namespace,
-            get_lc_unique_name(this.constructor),
-        ];
-    }
-    /**
-     * A map of secrets, which will be omitted from serialization.
-     * Keys are paths to the secret in constructor args, e.g. "foo.bar.baz".
-     * Values are the secret ids, which will be used when deserializing.
-     */
-    get lc_secrets() {
-        return undefined;
-    }
-    /**
-     * A map of additional attributes to merge with constructor args.
-     * Keys are the attribute names, e.g. "foo".
-     * Values are the attribute values, which will be serialized.
-     * These attributes need to be accepted by the constructor as arguments.
-     */
-    get lc_attributes() {
-        return undefined;
-    }
-    /**
-     * A map of aliases for constructor args.
-     * Keys are the attribute names, e.g. "foo".
-     * Values are the alias that will replace the key in serialization.
-     * This is used to eg. make argument names match Python.
-     */
-    get lc_aliases() {
-        return undefined;
-    }
-    constructor(kwargs, ..._args) {
-        Object.defineProperty(this, "lc_serializable", {
-            enumerable: true,
-            configurable: true,
-            writable: true,
-            value: false
-        });
-        Object.defineProperty(this, "lc_kwargs", {
-            enumerable: true,
-            configurable: true,
-            writable: true,
-            value: void 0
-        });
-        this.lc_kwargs = kwargs || {};
-    }
-    toJSON() {
-        if (!this.lc_serializable) {
-            return this.toJSONNotImplemented();
-        }
-        if (
-        // eslint-disable-next-line no-instanceof/no-instanceof
-        this.lc_kwargs instanceof Serializable ||
-            typeof this.lc_kwargs !== "object" ||
-            Array.isArray(this.lc_kwargs)) {
-            // We do not support serialization of classes with arg not a POJO
-            // I'm aware the check above isn't as strict as it could be
-            return this.toJSONNotImplemented();
-        }
-        const aliases = {};
-        const secrets = {};
-        const kwargs = Object.keys(this.lc_kwargs).reduce((acc, key) => {
-            acc[key] = key in this ? this[key] : this.lc_kwargs[key];
-            return acc;
-        }, {});
-        // get secrets, attributes and aliases from all superclasses
-        for (
-        // eslint-disable-next-line @typescript-eslint/no-this-alias
-        let current = Object.getPrototypeOf(this); current; current = Object.getPrototypeOf(current)) {
-            Object.assign(aliases, Reflect.get(current, "lc_aliases", this));
-            Object.assign(secrets, Reflect.get(current, "lc_secrets", this));
-            Object.assign(kwargs, Reflect.get(current, "lc_attributes", this));
-        }
-        // include all secrets used, even if not in kwargs,
-        // will be replaced with sentinel value in replaceSecrets
-        Object.keys(secrets).forEach((keyPath) => {
-            // eslint-disable-next-line @typescript-eslint/no-this-alias, @typescript-eslint/no-explicit-any
-            let read = this;
-            // eslint-disable-next-line @typescript-eslint/no-explicit-any
-            let write = kwargs;
-            const [last, ...partsReverse] = keyPath.split(".").reverse();
-            for (const key of partsReverse.reverse()) {
-                if (!(key in read) || read[key] === undefined)
-                    return;
-                if (!(key in write) || write[key] === undefined) {
-                    if (typeof read[key] === "object" && read[key] != null) {
-                        write[key] = {};
-                    }
-                    else if (Array.isArray(read[key])) {
-                        write[key] = [];
-                    }
-                }
-                read = read[key];
-                write = write[key];
-            }
-            if (last in read && read[last] !== undefined) {
-                write[last] = write[last] || read[last];
-            }
-        });
-        return {
-            lc: 1,
-            type: "constructor",
-            id: this.lc_id,
-            kwargs: (0, map_keys_js_1.mapKeys)(Object.keys(secrets).length ? replaceSecrets(kwargs, secrets) : kwargs, map_keys_js_1.keyToJson, aliases),
-        };
-    }
-    toJSONNotImplemented() {
-        return {
-            lc: 1,
-            type: "not_implemented",
-            id: this.lc_id,
-        };
-    }
-}
-exports.Serializable = Serializable;
+__exportStar(require("langchain-core/load/serializable"), exports);

package/dist/load/serializable.d.ts

@@ -1,66 +1 @@
-import { SerializedFields } from "./map_keys.js";
-export interface BaseSerialized<T extends string> {
-    lc: number;
-    type: T;
-    id: string[];
-}
-export interface SerializedConstructor extends BaseSerialized<"constructor"> {
-    kwargs: SerializedFields;
-}
-export interface SerializedSecret extends BaseSerialized<"secret"> {
-}
-export interface SerializedNotImplemented extends BaseSerialized<"not_implemented"> {
-}
-export type Serialized = SerializedConstructor | SerializedSecret | SerializedNotImplemented;
-/**
- * Get a unique name for the module, rather than parent class implementations.
- * Should not be subclassed, subclass lc_name above instead.
- */
-export declare function get_lc_unique_name(serializableClass: typeof Serializable): string;
-export declare abstract class Serializable {
-    lc_serializable: boolean;
-    lc_kwargs: SerializedFields;
-    /**
-     * A path to the module that contains the class, eg. ["langchain", "llms"]
-     * Usually should be the same as the entrypoint the class is exported from.
-     */
-    abstract lc_namespace: string[];
-    /**
-     * The name of the serializable. Override to provide an alias or
-     * to preserve the serialized module name in minified environments.
-     *
-     * Implemented as a static method to support loading logic.
-     */
-    static lc_name(): string;
-    /**
-     * The final serialized identifier for the module.
-     */
-    get lc_id(): string[];
-    /**
-     * A map of secrets, which will be omitted from serialization.
-     * Keys are paths to the secret in constructor args, e.g. "foo.bar.baz".
-     * Values are the secret ids, which will be used when deserializing.
-     */
-    get lc_secrets(): {
-        [key: string]: string;
-    } | undefined;
-    /**
-     * A map of additional attributes to merge with constructor args.
-     * Keys are the attribute names, e.g. "foo".
-     * Values are the attribute values, which will be serialized.
-     * These attributes need to be accepted by the constructor as arguments.
-     */
-    get lc_attributes(): SerializedFields | undefined;
-    /**
-     * A map of aliases for constructor args.
-     * Keys are the attribute names, e.g. "foo".
-     * Values are the alias that will replace the key in serialization.
-     * This is used to eg. make argument names match Python.
-     */
-    get lc_aliases(): {
-        [key: string]: string;
-    } | undefined;
-    constructor(kwargs?: SerializedFields, ..._args: never[]);
-    toJSON(): Serialized;
-    toJSONNotImplemented(): SerializedNotImplemented;
-}
+export * from "langchain-core/load/serializable";

package/dist/load/serializable.js

@@ -1,175 +1 @@
-import { keyToJson, mapKeys } from "./map_keys.js";
-function shallowCopy(obj) {
-    return Array.isArray(obj) ? [...obj] : { ...obj };
-}
-function replaceSecrets(root, secretsMap) {
-    const result = shallowCopy(root);
-    for (const [path, secretId] of Object.entries(secretsMap)) {
-        const [last, ...partsReverse] = path.split(".").reverse();
-        // eslint-disable-next-line @typescript-eslint/no-explicit-any
-        let current = result;
-        for (const part of partsReverse.reverse()) {
-            if (current[part] === undefined) {
-                break;
-            }
-            current[part] = shallowCopy(current[part]);
-            current = current[part];
-        }
-        if (current[last] !== undefined) {
-            current[last] = {
-                lc: 1,
-                type: "secret",
-                id: [secretId],
-            };
-        }
-    }
-    return result;
-}
-/**
- * Get a unique name for the module, rather than parent class implementations.
- * Should not be subclassed, subclass lc_name above instead.
- */
-export function get_lc_unique_name(
-// eslint-disable-next-line @typescript-eslint/no-use-before-define
-serializableClass) {
-    // "super" here would refer to the parent class of Serializable,
-    // when we want the parent class of the module actually calling this method.
-    const parentClass = Object.getPrototypeOf(serializableClass);
-    const lcNameIsSubclassed = typeof serializableClass.lc_name === "function" &&
-        (typeof parentClass.lc_name !== "function" ||
-            serializableClass.lc_name() !== parentClass.lc_name());
-    if (lcNameIsSubclassed) {
-        return serializableClass.lc_name();
-    }
-    else {
-        return serializableClass.name;
-    }
-}
-export class Serializable {
-    /**
-     * The name of the serializable. Override to provide an alias or
-     * to preserve the serialized module name in minified environments.
-     *
-     * Implemented as a static method to support loading logic.
-     */
-    static lc_name() {
-        return this.name;
-    }
-    /**
-     * The final serialized identifier for the module.
-     */
-    get lc_id() {
-        return [
-            ...this.lc_namespace,
-            get_lc_unique_name(this.constructor),
-        ];
-    }
-    /**
-     * A map of secrets, which will be omitted from serialization.
-     * Keys are paths to the secret in constructor args, e.g. "foo.bar.baz".
-     * Values are the secret ids, which will be used when deserializing.
-     */
-    get lc_secrets() {
-        return undefined;
-    }
-    /**
-     * A map of additional attributes to merge with constructor args.
-     * Keys are the attribute names, e.g. "foo".
-     * Values are the attribute values, which will be serialized.
-     * These attributes need to be accepted by the constructor as arguments.
-     */
-    get lc_attributes() {
-        return undefined;
-    }
-    /**
-     * A map of aliases for constructor args.
-     * Keys are the attribute names, e.g. "foo".
-     * Values are the alias that will replace the key in serialization.
-     * This is used to eg. make argument names match Python.
-     */
-    get lc_aliases() {
-        return undefined;
-    }
-    constructor(kwargs, ..._args) {
-        Object.defineProperty(this, "lc_serializable", {
-            enumerable: true,
-            configurable: true,
-            writable: true,
-            value: false
-        });
-        Object.defineProperty(this, "lc_kwargs", {
-            enumerable: true,
-            configurable: true,
-            writable: true,
-            value: void 0
-        });
-        this.lc_kwargs = kwargs || {};
-    }
-    toJSON() {
-        if (!this.lc_serializable) {
-            return this.toJSONNotImplemented();
-        }
-        if (
-        // eslint-disable-next-line no-instanceof/no-instanceof
-        this.lc_kwargs instanceof Serializable ||
-            typeof this.lc_kwargs !== "object" ||
-            Array.isArray(this.lc_kwargs)) {
-            // We do not support serialization of classes with arg not a POJO
-            // I'm aware the check above isn't as strict as it could be
-            return this.toJSONNotImplemented();
-        }
-        const aliases = {};
-        const secrets = {};
-        const kwargs = Object.keys(this.lc_kwargs).reduce((acc, key) => {
-            acc[key] = key in this ? this[key] : this.lc_kwargs[key];
-            return acc;
-        }, {});
-        // get secrets, attributes and aliases from all superclasses
-        for (
-        // eslint-disable-next-line @typescript-eslint/no-this-alias
-        let current = Object.getPrototypeOf(this); current; current = Object.getPrototypeOf(current)) {
-            Object.assign(aliases, Reflect.get(current, "lc_aliases", this));
-            Object.assign(secrets, Reflect.get(current, "lc_secrets", this));
-            Object.assign(kwargs, Reflect.get(current, "lc_attributes", this));
-        }
-        // include all secrets used, even if not in kwargs,
-        // will be replaced with sentinel value in replaceSecrets
-        Object.keys(secrets).forEach((keyPath) => {
-            // eslint-disable-next-line @typescript-eslint/no-this-alias, @typescript-eslint/no-explicit-any
-            let read = this;
-            // eslint-disable-next-line @typescript-eslint/no-explicit-any
-            let write = kwargs;
-            const [last, ...partsReverse] = keyPath.split(".").reverse();
-            for (const key of partsReverse.reverse()) {
-                if (!(key in read) || read[key] === undefined)
-                    return;
-                if (!(key in write) || write[key] === undefined) {
-                    if (typeof read[key] === "object" && read[key] != null) {
-                        write[key] = {};
-                    }
-                    else if (Array.isArray(read[key])) {
-                        write[key] = [];
-                    }
-                }
-                read = read[key];
-                write = write[key];
-            }
-            if (last in read && read[last] !== undefined) {
-                write[last] = write[last] || read[last];
-            }
-        });
-        return {
-            lc: 1,
-            type: "constructor",
-            id: this.lc_id,
-            kwargs: mapKeys(Object.keys(secrets).length ? replaceSecrets(kwargs, secrets) : kwargs, keyToJson, aliases),
-        };
-    }
-    toJSONNotImplemented() {
-        return {
-            lc: 1,
-            type: "not_implemented",
-            id: this.lc_id,
-        };
-    }
-}
+export * from "langchain-core/load/serializable";

package/dist/memory/base.cjs

@@ -1,95 +1,20 @@
 "use strict";
-Object.defineProperty(exports, "__esModule", { value: true });
-exports.getPromptInputKey = exports.getBufferString = exports.getOutputValue = exports.getInputValue = exports.BaseMemory = void 0;
-/**
- * Abstract base class for memory in LangChain's Chains. Memory refers to
- * the state in Chains. It can be used to store information about past
- * executions of a Chain and inject that information into the inputs of
- * future executions of the Chain.
- */
-class BaseMemory {
-}
-exports.BaseMemory = BaseMemory;
-const getValue = (values, key) => {
-    if (key !== undefined) {
-        return values[key];
-    }
-    const keys = Object.keys(values);
-    if (keys.length === 1) {
-        return values[keys[0]];
+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);
 };
-/**
- * This function is used by memory classes to select the input value
- * to use for the memory. If there is only one input value, it is used.
- * If there are multiple input values, the inputKey must be specified.
- */
-const getInputValue = (inputValues, inputKey) => {
-    const value = getValue(inputValues, inputKey);
-    if (!value) {
-        const keys = Object.keys(inputValues);
-        throw new Error(`input values have ${keys.length} keys, you must specify an input key or pass only 1 key as input`);
-    }
-    return value;
-};
-exports.getInputValue = getInputValue;
-/**
- * This function is used by memory classes to select the output value
- * to use for the memory. If there is only one output value, it is used.
- * If there are multiple output values, the outputKey must be specified.
- * If no outputKey is specified, an error is thrown.
- */
-const getOutputValue = (outputValues, outputKey) => {
-    const value = getValue(outputValues, outputKey);
-    if (!value) {
-        const keys = Object.keys(outputValues);
-        throw new Error(`output values have ${keys.length} keys, you must specify an output key or pass only 1 key as output`);
-    }
-    return value;
-};
-exports.getOutputValue = getOutputValue;
-/**
- * This function is used by memory classes to get a string representation
- * of the chat message history, based on the message content and role.
- */
-function getBufferString(messages, humanPrefix = "Human", aiPrefix = "AI") {
-    const string_messages = [];
-    for (const m of messages) {
-        let role;
-        if (m._getType() === "human") {
-            role = humanPrefix;
-        }
-        else if (m._getType() === "ai") {
-            role = aiPrefix;
-        }
-        else if (m._getType() === "system") {
-            role = "System";
-        }
-        else if (m._getType() === "function") {
-            role = "Function";
-        }
-        else if (m._getType() === "generic") {
-            role = m.role;
-        }
-        else {
-            throw new Error(`Got unsupported message type: ${m}`);
-        }
-        const nameStr = m.name ? `${m.name}, ` : "";
-        string_messages.push(`${role}: ${nameStr}${m.content}`);
-    }
-    return string_messages.join("\n");
-}
-exports.getBufferString = getBufferString;
-/**
- * Function used by memory classes to get the key of the prompt input,
- * excluding any keys that are memory variables or the "stop" key. If
- * there is not exactly one prompt input key, an error is thrown.
- */
-function getPromptInputKey(inputs, memoryVariables) {
-    const promptInputKeys = Object.keys(inputs).filter((key) => !memoryVariables.includes(key) && key !== "stop");
-    if (promptInputKeys.length !== 1) {
-        throw new Error(`One input key expected, but got ${promptInputKeys.length}`);
-    }
-    return promptInputKeys[0];
-}
-exports.getPromptInputKey = getPromptInputKey;
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.getBufferString = void 0;
+__exportStar(require("langchain-core/memory"), exports);
+var messages_1 = require("langchain-core/messages");
+Object.defineProperty(exports, "getBufferString", { enumerable: true, get: function () { return messages_1.getBufferString; } });

package/dist/memory/base.d.ts

@@ -1,68 +1,2 @@
-import { BaseMessage } from "../schema/index.js";
-/**
- * Type alias for a record where the keys are strings and the values can
- * be any type. This is used to represent the input values for a Chain.
- */
-export type InputValues = Record<string, any>;
-/**
- * Type alias for a record where the keys are strings and the values can
- * be any type. This is used to represent the output values from a Chain.
- */
-export type OutputValues = Record<string, any>;
-/**
- * Type alias for a record where the keys are strings and the values can
- * be any type. This is used to represent the memory variables in a Chain.
- */
-export type MemoryVariables = Record<string, any>;
-/**
- * Abstract base class for memory in LangChain's Chains. Memory refers to
- * the state in Chains. It can be used to store information about past
- * executions of a Chain and inject that information into the inputs of
- * future executions of the Chain.
- */
-export declare abstract class BaseMemory {
-    abstract get memoryKeys(): string[];
-    /**
-     * Abstract method that should take an object of input values and return a
-     * Promise that resolves with an object of memory variables. The
-     * implementation of this method should load the memory variables from the
-     * provided input values.
-     * @param values An object of input values.
-     * @returns Promise that resolves with an object of memory variables.
-     */
-    abstract loadMemoryVariables(values: InputValues): Promise<MemoryVariables>;
-    /**
-     * Abstract method that should take two objects, one of input values and
-     * one of output values, and return a Promise that resolves when the
-     * context has been saved. The implementation of this method should save
-     * the context based on the provided input and output values.
-     * @param inputValues An object of input values.
-     * @param outputValues An object of output values.
-     * @returns Promise that resolves when the context has been saved.
-     */
-    abstract saveContext(inputValues: InputValues, outputValues: OutputValues): Promise<void>;
-}
-/**
- * This function is used by memory classes to select the input value
- * to use for the memory. If there is only one input value, it is used.
- * If there are multiple input values, the inputKey must be specified.
- */
-export declare const getInputValue: (inputValues: InputValues, inputKey?: string) => any;
-/**
- * This function is used by memory classes to select the output value
- * to use for the memory. If there is only one output value, it is used.
- * If there are multiple output values, the outputKey must be specified.
- * If no outputKey is specified, an error is thrown.
- */
-export declare const getOutputValue: (outputValues: OutputValues, outputKey?: string) => any;
-/**
- * This function is used by memory classes to get a string representation
- * of the chat message history, based on the message content and role.
- */
-export declare function getBufferString(messages: BaseMessage[], humanPrefix?: string, aiPrefix?: string): string;
-/**
- * Function used by memory classes to get the key of the prompt input,
- * excluding any keys that are memory variables or the "stop" key. If
- * there is not exactly one prompt input key, an error is thrown.
- */
-export declare function getPromptInputKey(inputs: Record<string, unknown>, memoryVariables: string[]): string;
+export * from "langchain-core/memory";
+export { getBufferString } from "langchain-core/messages";