@langchain/core 0.3.72 → 1.0.0-alpha.2

package/dist/load/serializable.d.ts

@@ -1,76 +1,82 @@
-import { type SerializedFields } from "./map_keys.js";
-export interface BaseSerialized<T extends string> {
-    lc: number;
-    type: T;
-    id: string[];
-    name?: string;
-    graph?: Record<string, any>;
+import { SerializedFields } from "./map_keys.js";
+
+//#region src/load/serializable.d.ts
+interface BaseSerialized<T extends string> {
+  lc: number;
+  type: T;
+  id: string[];
+  name?: string;
+  // eslint-disable-next-line @typescript-eslint/no-explicit-any
+  graph?: Record<string, any>;
 }
-export interface SerializedConstructor extends BaseSerialized<"constructor"> {
-    kwargs: SerializedFields;
+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;
+interface SerializedSecret extends BaseSerialized<"secret"> {}
+interface SerializedNotImplemented extends BaseSerialized<"not_implemented"> {}
+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 interface SerializableInterface {
-    get lc_id(): string[];
+declare function get_lc_unique_name(
+// eslint-disable-next-line @typescript-eslint/no-use-before-define
+serializableClass: typeof Serializable): string;
+interface SerializableInterface {
+  get lc_id(): string[];
 }
-export declare abstract class Serializable implements SerializableInterface {
-    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;
-    /**
-     * A manual list of keys that should be serialized.
-     * If not overridden, all fields passed into the constructor will be serialized.
-     */
-    get lc_serializable_keys(): string[] | undefined;
-    constructor(kwargs?: SerializedFields, ..._args: never[]);
-    toJSON(): Serialized;
-    toJSONNotImplemented(): SerializedNotImplemented;
+declare abstract class Serializable implements SerializableInterface {
+  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;
+  /**
+   * A manual list of keys that should be serialized.
+   * If not overridden, all fields passed into the constructor will be serialized.
+   */
+  get lc_serializable_keys(): string[] | undefined;
+  constructor(kwargs?: SerializedFields, ..._args: never[]);
+  toJSON(): Serialized;
+  toJSONNotImplemented(): SerializedNotImplemented;
 }
+//#endregion
+export { BaseSerialized, Serializable, SerializableInterface, Serialized, SerializedConstructor, SerializedNotImplemented, SerializedSecret, get_lc_unique_name };
+//# sourceMappingURL=serializable.d.ts.map

package/dist/load/serializable.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"serializable.d.ts","names":["SerializedFields","BaseSerialized","T","Record","SerializedConstructor","SerializedSecret","SerializedNotImplemented","Serialized","get_lc_unique_name","Serializable","SerializableInterface"],"sources":["../../src/load/serializable.d.ts"],"sourcesContent":["import { type SerializedFields } from \"./map_keys.js\";\nexport interface BaseSerialized<T extends string> {\n    lc: number;\n    type: T;\n    id: string[];\n    name?: string;\n    // eslint-disable-next-line @typescript-eslint/no-explicit-any\n    graph?: Record<string, any>;\n}\nexport interface SerializedConstructor extends BaseSerialized<\"constructor\"> {\n    kwargs: SerializedFields;\n}\nexport interface SerializedSecret extends BaseSerialized<\"secret\"> {\n}\nexport interface SerializedNotImplemented extends BaseSerialized<\"not_implemented\"> {\n}\nexport type Serialized = SerializedConstructor | SerializedSecret | SerializedNotImplemented;\n/**\n * Get a unique name for the module, rather than parent class implementations.\n * Should not be subclassed, subclass lc_name above instead.\n */\nexport declare function get_lc_unique_name(\n// eslint-disable-next-line @typescript-eslint/no-use-before-define\nserializableClass: typeof Serializable): string;\nexport interface SerializableInterface {\n    get lc_id(): string[];\n}\nexport declare abstract class Serializable implements SerializableInterface {\n    lc_serializable: boolean;\n    lc_kwargs: SerializedFields;\n    /**\n     * A path to the module that contains the class, eg. [\"langchain\", \"llms\"]\n     * Usually should be the same as the entrypoint the class is exported from.\n     */\n    abstract lc_namespace: string[];\n    /**\n     * The name of the serializable. Override to provide an alias or\n     * to preserve the serialized module name in minified environments.\n     *\n     * Implemented as a static method to support loading logic.\n     */\n    static lc_name(): string;\n    /**\n     * The final serialized identifier for the module.\n     */\n    get lc_id(): string[];\n    /**\n     * A map of secrets, which will be omitted from serialization.\n     * Keys are paths to the secret in constructor args, e.g. \"foo.bar.baz\".\n     * Values are the secret ids, which will be used when deserializing.\n     */\n    get lc_secrets(): {\n        [key: string]: string;\n    } | undefined;\n    /**\n     * A map of additional attributes to merge with constructor args.\n     * Keys are the attribute names, e.g. \"foo\".\n     * Values are the attribute values, which will be serialized.\n     * These attributes need to be accepted by the constructor as arguments.\n     */\n    get lc_attributes(): SerializedFields | undefined;\n    /**\n     * A map of aliases for constructor args.\n     * Keys are the attribute names, e.g. \"foo\".\n     * Values are the alias that will replace the key in serialization.\n     * This is used to eg. make argument names match Python.\n     */\n    get lc_aliases(): {\n        [key: string]: string;\n    } | undefined;\n    /**\n     * A manual list of keys that should be serialized.\n     * If not overridden, all fields passed into the constructor will be serialized.\n     */\n    get lc_serializable_keys(): string[] | undefined;\n    constructor(kwargs?: SerializedFields, ..._args: never[]);\n    toJSON(): Serialized;\n    toJSONNotImplemented(): SerializedNotImplemented;\n}\n"],"mappings":";;;UACiBC;;EAAAA,IAAAA,EAEPC,CAFOD;EAAc,EAAA,EAAA,MAAA,EAAA;EAAA,IAErBC,CAAAA,EAAAA,MAAAA;EAAC;EAIO,KAAA,CAAA,EAANC,MAAM,CAAA,MAAA,EAAA,GAAA,CAAA;AAElB;AAAsC,UAArBC,qBAAAA,SAA8BH,cAAT,CAAA,aAAA,CAAA,CAAA;EAAA,MAC1BD,EAAAA,gBAAAA;;AADiD,UAG5CK,gBAAAA,SAAyBJ,cAHmB,CAAA,QAAA,CAAA,CAAA,CAG7D;AAEiBK,UAAAA,wBAAAA,SAAiCL,cAAc,CAAA,iBAAA,CAAA,CAAA,CAEhE;AAAsB,KAAVM,UAAAA,GAAaH,qBAAH,GAA2BC,gBAA3B,GAA8CC,wBAA9C;;;;AAAsE;AAKpEE,iBAAAA,kBAAAA;AAGxB;AAGA,iBAA8BC,EAAY,OAJhBA,YAIgB,CAAA,EAAA,MAAA;AAAA,UAHzBC,qBAAAA,CAGyB;EAAA,IAE3BV,KAAAA,EAAAA,EAAAA,MAAAA,EAAAA;;AA8CUA,uBAhDKS,YAAAA,YAAwBC,qBAgD7BV,CAAAA;EAAgB,eAC3BO,EAAAA,OAAAA;EAAU,SACID,EAhDbN,gBAgDaM;EAAwB;AAlDuB;;;;;;;;;;;;;;;;;;;;;;;;;;;;;uBAiClDN;;;;;;;;;;;;;;;uBAeAA;YACXO;0BACcD"}

package/dist/load/serializable.js

@@ -1,187 +1,143 @@
+import { __export } from "../_virtual/rolldown_runtime.js";
 import { keyToJson, mapKeys } from "./map_keys.js";
+
+//#region src/load/serializable.ts
+var serializable_exports = {};
+__export(serializable_exports, {
+	Serializable: () => Serializable,
+	get_lc_unique_name: () => get_lc_unique_name
+});
 function shallowCopy(obj) {
-    return Array.isArray(obj) ? [...obj] : { ...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;
+	const result = shallowCopy(root);
+	for (const [path, secretId] of Object.entries(secretsMap)) {
+		const [last, ...partsReverse] = path.split(".").reverse();
+		let current = result;
+		for (const part of partsReverse.reverse()) {
+			if (current[part] === void 0) break;
+			current[part] = shallowCopy(current[part]);
+			current = current[part];
+		}
+		if (current[last] !== void 0) 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;
-    }
-    /**
-     * A manual list of keys that should be serialized.
-     * If not overridden, all fields passed into the constructor will be serialized.
-     */
-    get lc_serializable_keys() {
-        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
-        });
-        if (this.lc_serializable_keys !== undefined) {
-            this.lc_kwargs = Object.fromEntries(Object.entries(kwargs || {}).filter(([key]) => this.lc_serializable_keys?.includes(key)));
-        }
-        else {
-            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,
-        };
-    }
+* 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(serializableClass) {
+	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;
 }
+var Serializable = class Serializable {
+	lc_serializable = false;
+	lc_kwargs;
+	/**
+	* 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 void 0;
+	}
+	/**
+	* 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 void 0;
+	}
+	/**
+	* 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 void 0;
+	}
+	/**
+	* A manual list of keys that should be serialized.
+	* If not overridden, all fields passed into the constructor will be serialized.
+	*/
+	get lc_serializable_keys() {
+		return void 0;
+	}
+	constructor(kwargs, ..._args) {
+		if (this.lc_serializable_keys !== void 0) this.lc_kwargs = Object.fromEntries(Object.entries(kwargs || {}).filter(([key]) => this.lc_serializable_keys?.includes(key)));
+		else this.lc_kwargs = kwargs ?? {};
+	}
+	toJSON() {
+		if (!this.lc_serializable) return this.toJSONNotImplemented();
+		if (this.lc_kwargs instanceof Serializable || typeof this.lc_kwargs !== "object" || Array.isArray(this.lc_kwargs)) 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;
+		}, {});
+		for (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));
+		}
+		Object.keys(secrets).forEach((keyPath) => {
+			let read = this;
+			let write = kwargs;
+			const [last, ...partsReverse] = keyPath.split(".").reverse();
+			for (const key of partsReverse.reverse()) {
+				if (!(key in read) || read[key] === void 0) return;
+				if (!(key in write) || write[key] === void 0) {
+					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] !== void 0) 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
+		};
+	}
+};
+
+//#endregion
+export { Serializable, get_lc_unique_name, serializable_exports };
+//# sourceMappingURL=serializable.js.map

package/dist/load/serializable.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"serializable.js","names":["obj: T","root: SerializedFields","secretsMap: { [key: string]: string }","current: any","serializableClass: typeof Serializable","kwargs?: SerializedFields","aliases: { [key: string]: string }","secrets: { [key: string]: string }","read: any","write: any"],"sources":["../../src/load/serializable.ts"],"sourcesContent":["import { type SerializedFields, keyToJson, mapKeys } from \"./map_keys.js\";\n\nexport interface BaseSerialized<T extends string> {\n  lc: number;\n  type: T;\n  id: string[];\n  name?: string;\n  // eslint-disable-next-line @typescript-eslint/no-explicit-any\n  graph?: Record<string, any>;\n}\n\nexport interface SerializedConstructor extends BaseSerialized<\"constructor\"> {\n  kwargs: SerializedFields;\n}\n\nexport interface SerializedSecret extends BaseSerialized<\"secret\"> {}\n\nexport interface SerializedNotImplemented\n  extends BaseSerialized<\"not_implemented\"> {}\n\nexport type Serialized =\n  | SerializedConstructor\n  | SerializedSecret\n  | SerializedNotImplemented;\n\nfunction shallowCopy<T extends object>(obj: T): T {\n  return Array.isArray(obj) ? ([...obj] as T) : ({ ...obj } as T);\n}\n\nfunction replaceSecrets(\n  root: SerializedFields,\n  secretsMap: { [key: string]: string }\n): SerializedFields {\n  const result = shallowCopy(root);\n  for (const [path, secretId] of Object.entries(secretsMap)) {\n    const [last, ...partsReverse] = path.split(\".\").reverse();\n    // eslint-disable-next-line @typescript-eslint/no-explicit-any\n    let current: any = result;\n    for (const part of partsReverse.reverse()) {\n      if (current[part] === undefined) {\n        break;\n      }\n      current[part] = shallowCopy(current[part]);\n      current = current[part];\n    }\n    if (current[last] !== undefined) {\n      current[last] = {\n        lc: 1,\n        type: \"secret\",\n        id: [secretId],\n      };\n    }\n  }\n  return result;\n}\n\n/**\n * Get a unique name for the module, rather than parent class implementations.\n * Should not be subclassed, subclass lc_name above instead.\n */\nexport function get_lc_unique_name(\n  // eslint-disable-next-line @typescript-eslint/no-use-before-define\n  serializableClass: typeof Serializable\n): string {\n  // \"super\" here would refer to the parent class of Serializable,\n  // when we want the parent class of the module actually calling this method.\n  const parentClass = Object.getPrototypeOf(serializableClass);\n  const lcNameIsSubclassed =\n    typeof serializableClass.lc_name === \"function\" &&\n    (typeof parentClass.lc_name !== \"function\" ||\n      serializableClass.lc_name() !== parentClass.lc_name());\n  if (lcNameIsSubclassed) {\n    return serializableClass.lc_name();\n  } else {\n    return serializableClass.name;\n  }\n}\n\nexport interface SerializableInterface {\n  get lc_id(): string[];\n}\n\nexport abstract class Serializable implements SerializableInterface {\n  lc_serializable = false;\n\n  lc_kwargs: SerializedFields;\n\n  /**\n   * A path to the module that contains the class, eg. [\"langchain\", \"llms\"]\n   * Usually should be the same as the entrypoint the class is exported from.\n   */\n  abstract lc_namespace: string[];\n\n  /**\n   * The name of the serializable. Override to provide an alias or\n   * to preserve the serialized module name in minified environments.\n   *\n   * Implemented as a static method to support loading logic.\n   */\n  static lc_name(): string {\n    return this.name;\n  }\n\n  /**\n   * The final serialized identifier for the module.\n   */\n  get lc_id(): string[] {\n    return [\n      ...this.lc_namespace,\n      get_lc_unique_name(this.constructor as typeof Serializable),\n    ];\n  }\n\n  /**\n   * A map of secrets, which will be omitted from serialization.\n   * Keys are paths to the secret in constructor args, e.g. \"foo.bar.baz\".\n   * Values are the secret ids, which will be used when deserializing.\n   */\n  get lc_secrets(): { [key: string]: string } | undefined {\n    return undefined;\n  }\n\n  /**\n   * A map of additional attributes to merge with constructor args.\n   * Keys are the attribute names, e.g. \"foo\".\n   * Values are the attribute values, which will be serialized.\n   * These attributes need to be accepted by the constructor as arguments.\n   */\n  get lc_attributes(): SerializedFields | undefined {\n    return undefined;\n  }\n\n  /**\n   * A map of aliases for constructor args.\n   * Keys are the attribute names, e.g. \"foo\".\n   * Values are the alias that will replace the key in serialization.\n   * This is used to eg. make argument names match Python.\n   */\n  get lc_aliases(): { [key: string]: string } | undefined {\n    return undefined;\n  }\n\n  /**\n   * A manual list of keys that should be serialized.\n   * If not overridden, all fields passed into the constructor will be serialized.\n   */\n  get lc_serializable_keys(): string[] | undefined {\n    return undefined;\n  }\n\n  constructor(kwargs?: SerializedFields, ..._args: never[]) {\n    if (this.lc_serializable_keys !== undefined) {\n      this.lc_kwargs = Object.fromEntries(\n        Object.entries(kwargs || {}).filter(([key]) =>\n          this.lc_serializable_keys?.includes(key)\n        )\n      );\n    } else {\n      this.lc_kwargs = kwargs ?? {};\n    }\n  }\n\n  toJSON(): Serialized {\n    if (!this.lc_serializable) {\n      return this.toJSONNotImplemented();\n    }\n    if (\n      // eslint-disable-next-line no-instanceof/no-instanceof\n      this.lc_kwargs instanceof Serializable ||\n      typeof this.lc_kwargs !== \"object\" ||\n      Array.isArray(this.lc_kwargs)\n    ) {\n      // We do not support serialization of classes with arg not a POJO\n      // I'm aware the check above isn't as strict as it could be\n      return this.toJSONNotImplemented();\n    }\n\n    const aliases: { [key: string]: string } = {};\n    const secrets: { [key: string]: string } = {};\n    const kwargs = Object.keys(this.lc_kwargs).reduce((acc, key) => {\n      acc[key] = key in this ? this[key as keyof this] : this.lc_kwargs[key];\n      return acc;\n    }, {} as SerializedFields);\n    // get secrets, attributes and aliases from all superclasses\n    for (\n      // eslint-disable-next-line @typescript-eslint/no-this-alias\n      let current = Object.getPrototypeOf(this);\n      current;\n      current = Object.getPrototypeOf(current)\n    ) {\n      Object.assign(aliases, Reflect.get(current, \"lc_aliases\", this));\n      Object.assign(secrets, Reflect.get(current, \"lc_secrets\", this));\n      Object.assign(kwargs, Reflect.get(current, \"lc_attributes\", this));\n    }\n\n    // include all secrets used, even if not in kwargs,\n    // will be replaced with sentinel value in replaceSecrets\n    Object.keys(secrets).forEach((keyPath) => {\n      // eslint-disable-next-line @typescript-eslint/no-this-alias, @typescript-eslint/no-explicit-any\n      let read: any = this;\n\n      // eslint-disable-next-line @typescript-eslint/no-explicit-any\n      let write: any = kwargs;\n\n      const [last, ...partsReverse] = keyPath.split(\".\").reverse();\n      for (const key of partsReverse.reverse()) {\n        if (!(key in read) || read[key] === undefined) return;\n        if (!(key in write) || write[key] === undefined) {\n          if (typeof read[key] === \"object\" && read[key] != null) {\n            write[key] = {};\n          } else if (Array.isArray(read[key])) {\n            write[key] = [];\n          }\n        }\n\n        read = read[key];\n        write = write[key];\n      }\n\n      if (last in read && read[last] !== undefined) {\n        write[last] = write[last] || read[last];\n      }\n    });\n\n    return {\n      lc: 1,\n      type: \"constructor\",\n      id: this.lc_id,\n      kwargs: mapKeys(\n        Object.keys(secrets).length ? replaceSecrets(kwargs, secrets) : kwargs,\n        keyToJson,\n        aliases\n      ),\n    };\n  }\n\n  toJSONNotImplemented(): SerializedNotImplemented {\n    return {\n      lc: 1,\n      type: \"not_implemented\",\n      id: this.lc_id,\n    };\n  }\n}\n"],"mappings":"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"}

package/dist/memory.cjs

@@ -1,63 +1,72 @@
-"use strict";
-Object.defineProperty(exports, "__esModule", { value: true });
-exports.getOutputValue = exports.getInputValue = exports.BaseMemory = void 0;
-exports.getPromptInputKey = getPromptInputKey;
+const require_rolldown_runtime = require('./_virtual/rolldown_runtime.cjs');
+
+//#region src/memory.ts
+var memory_exports = {};
+require_rolldown_runtime.__export(memory_exports, {
+	BaseMemory: () => BaseMemory,
+	getInputValue: () => getInputValue,
+	getOutputValue: () => getOutputValue,
+	getPromptInputKey: () => getPromptInputKey
+});
 /**
- * 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;
+* 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.
+*/
+var BaseMemory = class {};
 const getValue = (values, key) => {
-    if (key !== undefined) {
-        return values[key];
-    }
-    const keys = Object.keys(values);
-    if (keys.length === 1) {
-        return values[keys[0]];
-    }
+	if (key !== void 0) return values[key];
+	const keys = Object.keys(values);
+	if (keys.length === 1) return values[keys[0]];
 };
 /**
- * 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.
- */
+* 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;
+	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.
- */
+* 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 && 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;
+	const value = getValue(outputValues, outputKey);
+	if (!value && 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;
 /**
- * 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 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];
+	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];
 }
+
+//#endregion
+exports.BaseMemory = BaseMemory;
+exports.getInputValue = getInputValue;
+exports.getOutputValue = getOutputValue;
+exports.getPromptInputKey = getPromptInputKey;
+Object.defineProperty(exports, 'memory_exports', {
+  enumerable: true,
+  get: function () {
+    return memory_exports;
+  }
+});
+//# sourceMappingURL=memory.cjs.map

package/dist/memory.cjs.map

@@ -0,0 +1 @@
+{"version":3,"file":"memory.cjs","names":["values: InputValues | OutputValues","key?: string","inputValues: InputValues","inputKey?: string","outputValues: OutputValues","outputKey?: string","inputs: Record<string, unknown>","memoryVariables: string[]"],"sources":["../src/memory.ts"],"sourcesContent":["/**\n * Type alias for a record where the keys are strings and the values can\n * be any type. This is used to represent the input values for a Chain.\n */\n// eslint-disable-next-line @typescript-eslint/no-explicit-any\nexport type InputValues = Record<string, any>;\n\n/**\n * Type alias for a record where the keys are strings and the values can\n * be any type. This is used to represent the output values from a Chain.\n */\n// eslint-disable-next-line @typescript-eslint/no-explicit-any\nexport type OutputValues = Record<string, any>;\n\n/**\n * Type alias for a record where the keys are strings and the values can\n * be any type. This is used to represent the memory variables in a Chain.\n */\n// eslint-disable-next-line @typescript-eslint/no-explicit-any\nexport type MemoryVariables = Record<string, any>;\n\n/**\n * Abstract base class for memory in LangChain's Chains. Memory refers to\n * the state in Chains. It can be used to store information about past\n * executions of a Chain and inject that information into the inputs of\n * future executions of the Chain.\n */\nexport abstract class BaseMemory {\n  abstract get memoryKeys(): string[];\n\n  /**\n   * Abstract method that should take an object of input values and return a\n   * Promise that resolves with an object of memory variables. The\n   * implementation of this method should load the memory variables from the\n   * provided input values.\n   * @param values An object of input values.\n   * @returns Promise that resolves with an object of memory variables.\n   */\n  abstract loadMemoryVariables(values: InputValues): Promise<MemoryVariables>;\n\n  /**\n   * Abstract method that should take two objects, one of input values and\n   * one of output values, and return a Promise that resolves when the\n   * context has been saved. The implementation of this method should save\n   * the context based on the provided input and output values.\n   * @param inputValues An object of input values.\n   * @param outputValues An object of output values.\n   * @returns Promise that resolves when the context has been saved.\n   */\n  abstract saveContext(\n    inputValues: InputValues,\n    outputValues: OutputValues\n  ): Promise<void>;\n}\n\nconst getValue = (values: InputValues | OutputValues, key?: string) => {\n  if (key !== undefined) {\n    return values[key];\n  }\n  const keys = Object.keys(values);\n  if (keys.length === 1) {\n    return values[keys[0]];\n  }\n};\n\n/**\n * This function is used by memory classes to select the input value\n * to use for the memory. If there is only one input value, it is used.\n * If there are multiple input values, the inputKey must be specified.\n */\nexport const getInputValue = (inputValues: InputValues, inputKey?: string) => {\n  const value = getValue(inputValues, inputKey);\n  if (!value) {\n    const keys = Object.keys(inputValues);\n    throw new Error(\n      `input values have ${keys.length} keys, you must specify an input key or pass only 1 key as input`\n    );\n  }\n  return value;\n};\n\n/**\n * This function is used by memory classes to select the output value\n * to use for the memory. If there is only one output value, it is used.\n * If there are multiple output values, the outputKey must be specified.\n * If no outputKey is specified, an error is thrown.\n */\nexport const getOutputValue = (\n  outputValues: OutputValues,\n  outputKey?: string\n) => {\n  const value = getValue(outputValues, outputKey);\n  if (!value && value !== \"\") {\n    const keys = Object.keys(outputValues);\n    throw new Error(\n      `output values have ${keys.length} keys, you must specify an output key or pass only 1 key as output`\n    );\n  }\n  return value;\n};\n\n/**\n * Function used by memory classes to get the key of the prompt input,\n * excluding any keys that are memory variables or the \"stop\" key. If\n * there is not exactly one prompt input key, an error is thrown.\n */\nexport function getPromptInputKey(\n  inputs: Record<string, unknown>,\n  memoryVariables: string[]\n): string {\n  const promptInputKeys = Object.keys(inputs).filter(\n    (key) => !memoryVariables.includes(key) && key !== \"stop\"\n  );\n  if (promptInputKeys.length !== 1) {\n    throw new Error(\n      `One input key expected, but got ${promptInputKeys.length}`\n    );\n  }\n  return promptInputKeys[0];\n}\n"],"mappings":";;;;;;;;;;;;;;;;AA2BA,IAAsB,aAAtB,MAAiC,CA0BhC;AAED,MAAM,WAAW,CAACA,QAAoCC,QAAiB;AACrE,KAAI,QAAQ,OACV,QAAO,OAAO;CAEhB,MAAM,OAAO,OAAO,KAAK,OAAO;AAChC,KAAI,KAAK,WAAW,EAClB,QAAO,OAAO,KAAK;AAEtB;;;;;;AAOD,MAAa,gBAAgB,CAACC,aAA0BC,aAAsB;CAC5E,MAAM,QAAQ,SAAS,aAAa,SAAS;AAC7C,KAAI,CAAC,OAAO;EACV,MAAM,OAAO,OAAO,KAAK,YAAY;AACrC,QAAM,IAAI,MACR,CAAC,kBAAkB,EAAE,KAAK,OAAO,gEAAgE,CAAC;CAErG;AACD,QAAO;AACR;;;;;;;AAQD,MAAa,iBAAiB,CAC5BC,cACAC,cACG;CACH,MAAM,QAAQ,SAAS,cAAc,UAAU;AAC/C,KAAI,CAAC,SAAS,UAAU,IAAI;EAC1B,MAAM,OAAO,OAAO,KAAK,aAAa;AACtC,QAAM,IAAI,MACR,CAAC,mBAAmB,EAAE,KAAK,OAAO,kEAAkE,CAAC;CAExG;AACD,QAAO;AACR;;;;;;AAOD,SAAgB,kBACdC,QACAC,iBACQ;CACR,MAAM,kBAAkB,OAAO,KAAK,OAAO,CAAC,OAC1C,CAAC,QAAQ,CAAC,gBAAgB,SAAS,IAAI,IAAI,QAAQ,OACpD;AACD,KAAI,gBAAgB,WAAW,EAC7B,OAAM,IAAI,MACR,CAAC,gCAAgC,EAAE,gBAAgB,QAAQ;AAG/D,QAAO,gBAAgB;AACxB"}