langchain 0.0.130 → 0.0.132

package/dist/llms/openai-chat.d.ts

@@ -1,10 +1,15 @@
-import { ChatCompletionRequestMessage, CreateChatCompletionRequest, ConfigurationParameters, CreateChatCompletionResponse } from "openai";
+import { ChatCompletionRequestMessage, ConfigurationParameters, CreateChatCompletionRequest, CreateChatCompletionResponse } from "openai";
+import { CallbackManagerForLLMRun } from "../callbacks/manager.js";
+import { GenerationChunk, LLMResult } from "../schema/index.js";
 import { AzureOpenAIInput, OpenAICallOptions, OpenAIChatInput } from "../types/openai-types.js";
 import type { StreamingAxiosConfiguration } from "../util/axios-types.js";
 import { BaseLLMParams, LLM } from "./base.js";
-import { CallbackManagerForLLMRun } from "../callbacks/manager.js";
-import { LLMResult, GenerationChunk } from "../schema/index.js";
-export { OpenAIChatInput, AzureOpenAIInput };
+export { AzureOpenAIInput, OpenAIChatInput };
+/**
+ * Interface that extends the OpenAICallOptions interface and includes an
+ * optional promptIndex property. It represents the options that can be
+ * passed when making a call to the OpenAI Chat API.
+ */
 export interface OpenAIChatCallOptions extends OpenAICallOptions {
     promptIndex?: number;
 }
@@ -31,6 +36,7 @@ export interface OpenAIChatCallOptions extends OpenAICallOptions {
  * @augments AzureOpenAIChatInput
  */
 export declare class OpenAIChat extends LLM<OpenAIChatCallOptions> implements OpenAIChatInput, AzureOpenAIInput {
+    static lc_name(): string;
     get callKeys(): (keyof OpenAIChatCallOptions)[];
     lc_serializable: boolean;
     get lc_secrets(): {
@@ -57,6 +63,7 @@ export declare class OpenAIChat extends LLM<OpenAIChatCallOptions> implements Op
     azureOpenAIApiInstanceName?: string;
     azureOpenAIApiDeploymentName?: string;
     azureOpenAIBasePath?: string;
+    organization?: string;
     private client;
     private clientConfig;
     constructor(fields?: Partial<OpenAIChatInput> & Partial<AzureOpenAIInput> & BaseLLMParams & {
@@ -120,8 +127,19 @@ export declare class OpenAIChat extends LLM<OpenAIChatCallOptions> implements Op
         logit_bias?: object | null | undefined;
         model_name: string;
     };
+    /**
+     * Formats the messages for the OpenAI API.
+     * @param prompt The prompt to be formatted.
+     * @returns Array of formatted messages.
+     */
     private formatMessages;
     _streamResponseChunks(prompt: string, options: this["ParsedCallOptions"], runManager?: CallbackManagerForLLMRun): AsyncGenerator<GenerationChunk>;
+    /**
+     * Starts a stream of responses from the OpenAI API.
+     * @param request The request to be sent to the OpenAI API.
+     * @param options Optional configuration for the Axios request.
+     * @returns An iterable object that can be used to iterate over the response chunks.
+     */
     startStream(request: CreateChatCompletionRequest, options?: StreamingAxiosConfiguration): {
         next(): Promise<any>;
         [Symbol.asyncIterator](): any;
@@ -148,6 +166,12 @@ export declare class PromptLayerOpenAIChat extends OpenAIChat {
         plTags?: string[];
         returnPromptLayerId?: boolean;
     });
+    /**
+     * Makes a call to the OpenAI API with retry logic in case of failures.
+     * @param request The request to be sent to the OpenAI API.
+     * @param options Optional configuration for the Axios request.
+     * @returns The response from the OpenAI API.
+     */
     completionWithRetry(request: CreateChatCompletionRequest, options?: StreamingAxiosConfiguration): Promise<CreateChatCompletionResponse>;
     _generate(prompts: string[], options: this["ParsedCallOptions"], runManager?: CallbackManagerForLLMRun): Promise<LLMResult>;
 }

package/dist/llms/openai-chat.js

@@ -1,11 +1,11 @@
 import { Configuration, OpenAIApi, } from "openai";
-import { isNode, getEnvironmentVariable } from "../util/env.js";
-import fetchAdapter from "../util/axios-fetch-adapter.js";
-import { LLM } from "./base.js";
 import { GenerationChunk } from "../schema/index.js";
-import { promptLayerTrackRequest } from "../util/prompt-layer.js";
+import fetchAdapter from "../util/axios-fetch-adapter.js";
 import { getEndpoint } from "../util/azure.js";
+import { getEnvironmentVariable, isNode } from "../util/env.js";
+import { promptLayerTrackRequest } from "../util/prompt-layer.js";
 import { readableStreamToAsyncIterable } from "../util/stream.js";
+import { LLM } from "./base.js";
 /**
  * Wrapper around OpenAI large language models that use the Chat endpoint.
  *
@@ -29,6 +29,9 @@ import { readableStreamToAsyncIterable } from "../util/stream.js";
  * @augments AzureOpenAIChatInput
  */
 export class OpenAIChat extends LLM {
+    static lc_name() {
+        return "OpenAIChat";
+    }
     get callKeys() {
         return [
             ...super.callKeys,
@@ -40,6 +43,7 @@ export class OpenAIChat extends LLM {
         return {
             openAIApiKey: "OPENAI_API_KEY",
             azureOpenAIApiKey: "AZURE_OPENAI_API_KEY",
+            organization: "OPENAI_ORGANIZATION",
         };
     }
     get lc_aliases() {
@@ -182,6 +186,12 @@ export class OpenAIChat extends LLM {
             writable: true,
             value: void 0
         });
+        Object.defineProperty(this, "organization", {
+            enumerable: true,
+            configurable: true,
+            writable: true,
+            value: void 0
+        });
         Object.defineProperty(this, "client", {
             enumerable: true,
             configurable: true,
@@ -216,6 +226,9 @@ export class OpenAIChat extends LLM {
         this.azureOpenAIBasePath =
             fields?.azureOpenAIBasePath ??
                 getEnvironmentVariable("AZURE_OPENAI_BASE_PATH");
+        this.organization =
+            fields?.configuration?.organization ??
+                getEnvironmentVariable("OPENAI_ORGANIZATION");
         this.modelName = fields?.modelName ?? this.modelName;
         this.prefixMessages = fields?.prefixMessages ?? this.prefixMessages;
         this.modelKwargs = fields?.modelKwargs ?? {};
@@ -246,6 +259,7 @@ export class OpenAIChat extends LLM {
         }
         this.clientConfig = {
             apiKey: this.openAIApiKey,
+            organization: this.organization,
             ...configuration,
             ...fields?.configuration,
         };
@@ -287,6 +301,11 @@ export class OpenAIChat extends LLM {
             ...this.clientConfig,
         };
     }
+    /**
+     * Formats the messages for the OpenAI API.
+     * @param prompt The prompt to be formatted.
+     * @returns Array of formatted messages.
+     */
     formatMessages(prompt) {
         const message = {
             role: "user",
@@ -318,6 +337,12 @@ export class OpenAIChat extends LLM {
             void runManager?.handleLLMNewToken(generationChunk.text ?? "");
         }
     }
+    /**
+     * Starts a stream of responses from the OpenAI API.
+     * @param request The request to be sent to the OpenAI API.
+     * @param options Optional configuration for the Axios request.
+     * @returns An iterable object that can be used to iterate over the response chunks.
+     */
     startStream(request, options) {
         let done = false;
         const stream = new TransformStream();
@@ -552,6 +577,12 @@ export class PromptLayerOpenAIChat extends OpenAIChat {
             throw new Error("Missing PromptLayer API key");
         }
     }
+    /**
+     * Makes a call to the OpenAI API with retry logic in case of failures.
+     * @param request The request to be sent to the OpenAI API.
+     * @param options Optional configuration for the Axios request.
+     * @returns The response from the OpenAI API.
+     */
     async completionWithRetry(request, options) {
         if (request.stream) {
             return super.completionWithRetry(request, options);

package/dist/llms/openai.cjs

@@ -5,16 +5,16 @@ var __importDefault = (this && this.__importDefault) || function (mod) {
 Object.defineProperty(exports, "__esModule", { value: true });
 exports.PromptLayerOpenAIChat = exports.OpenAIChat = exports.PromptLayerOpenAI = exports.OpenAI = void 0;
 const openai_1 = require("openai");
-const env_js_1 = require("../util/env.cjs");
-const axios_fetch_adapter_js_1 = __importDefault(require("../util/axios-fetch-adapter.cjs"));
-const chunk_js_1 = require("../util/chunk.cjs");
-const base_js_1 = require("./base.cjs");
 const count_tokens_js_1 = require("../base_language/count_tokens.cjs");
-const openai_chat_js_1 = require("./openai-chat.cjs");
 const index_js_1 = require("../schema/index.cjs");
-const prompt_layer_js_1 = require("../util/prompt-layer.cjs");
+const axios_fetch_adapter_js_1 = __importDefault(require("../util/axios-fetch-adapter.cjs"));
 const azure_js_1 = require("../util/azure.cjs");
+const chunk_js_1 = require("../util/chunk.cjs");
+const env_js_1 = require("../util/env.cjs");
+const prompt_layer_js_1 = require("../util/prompt-layer.cjs");
 const stream_js_1 = require("../util/stream.cjs");
+const base_js_1 = require("./base.cjs");
+const openai_chat_js_1 = require("./openai-chat.cjs");
 /**
  * Wrapper around OpenAI large language models.
  *
@@ -34,6 +34,9 @@ const stream_js_1 = require("../util/stream.cjs");
  * if not explicitly available on this class.
  */
 class OpenAI extends base_js_1.BaseLLM {
+    static lc_name() {
+        return "OpenAI";
+    }
     get callKeys() {
         return [...super.callKeys, "options"];
     }
@@ -41,6 +44,7 @@ class OpenAI extends base_js_1.BaseLLM {
         return {
             openAIApiKey: "OPENAI_API_KEY",
             azureOpenAIApiKey: "AZURE_OPENAI_API_KEY",
+            organization: "OPENAI_ORGANIZATION",
         };
     }
     get lc_aliases() {
@@ -195,6 +199,12 @@ class OpenAI extends base_js_1.BaseLLM {
             writable: true,
             value: void 0
         });
+        Object.defineProperty(this, "organization", {
+            enumerable: true,
+            configurable: true,
+            writable: true,
+            value: void 0
+        });
         Object.defineProperty(this, "client", {
             enumerable: true,
             configurable: true,
@@ -229,6 +239,9 @@ class OpenAI extends base_js_1.BaseLLM {
         this.azureOpenAIBasePath =
             fields?.azureOpenAIBasePath ??
                 (0, env_js_1.getEnvironmentVariable)("AZURE_OPENAI_BASE_PATH");
+        this.organization =
+            fields?.configuration?.organization ??
+                (0, env_js_1.getEnvironmentVariable)("OPENAI_ORGANIZATION");
         this.modelName = fields?.modelName ?? this.modelName;
         this.modelKwargs = fields?.modelKwargs ?? {};
         this.batchSize = fields?.batchSize ?? this.batchSize;
@@ -260,6 +273,7 @@ class OpenAI extends base_js_1.BaseLLM {
         }
         this.clientConfig = {
             apiKey: this.openAIApiKey,
+            organization: this.organization,
             ...configuration,
             ...fields?.configuration,
         };
@@ -608,6 +622,12 @@ class PromptLayerOpenAI extends OpenAI {
             throw new Error("Missing PromptLayer API key");
         }
     }
+    /**
+     * Calls the OpenAI API with retry logic in case of failures.
+     * @param request The request to send to the OpenAI API.
+     * @param options Optional configuration for the API call.
+     * @returns The response from the OpenAI API.
+     */
     async completionWithRetry(request, options) {
         if (request.stream) {
             return super.completionWithRetry(request, options);

package/dist/llms/openai.d.ts

@@ -1,10 +1,10 @@
 import { ConfigurationParameters, CreateCompletionRequest, CreateCompletionResponse } from "openai";
+import { CallbackManagerForLLMRun } from "../callbacks/manager.js";
+import { GenerationChunk, LLMResult } from "../schema/index.js";
 import { AzureOpenAIInput, OpenAICallOptions, OpenAIInput } from "../types/openai-types.js";
 import type { StreamingAxiosConfiguration } from "../util/axios-types.js";
 import { BaseLLM, BaseLLMParams } from "./base.js";
-import { LLMResult, GenerationChunk } from "../schema/index.js";
-import { CallbackManagerForLLMRun } from "../callbacks/manager.js";
-export { OpenAICallOptions, AzureOpenAIInput, OpenAIInput };
+export { AzureOpenAIInput, OpenAICallOptions, OpenAIInput };
 /**
  * Wrapper around OpenAI large language models.
  *
@@ -24,6 +24,7 @@ export { OpenAICallOptions, AzureOpenAIInput, OpenAIInput };
  * if not explicitly available on this class.
  */
 export declare class OpenAI extends BaseLLM<OpenAICallOptions> implements OpenAIInput, AzureOpenAIInput {
+    static lc_name(): string;
     get callKeys(): (keyof OpenAICallOptions)[];
     lc_serializable: boolean;
     get lc_secrets(): {
@@ -51,6 +52,7 @@ export declare class OpenAI extends BaseLLM<OpenAICallOptions> implements OpenAI
     azureOpenAIApiInstanceName?: string;
     azureOpenAIApiDeploymentName?: string;
     azureOpenAIBasePath?: string;
+    organization?: string;
     private client;
     private clientConfig;
     constructor(fields?: Partial<OpenAIInput> & Partial<AzureOpenAIInput> & BaseLLMParams & {
@@ -162,6 +164,12 @@ export declare class PromptLayerOpenAI extends OpenAI {
         plTags?: string[];
         returnPromptLayerId?: boolean;
     });
+    /**
+     * Calls the OpenAI API with retry logic in case of failures.
+     * @param request The request to send to the OpenAI API.
+     * @param options Optional configuration for the API call.
+     * @returns The response from the OpenAI API.
+     */
     completionWithRetry(request: CreateCompletionRequest, options?: StreamingAxiosConfiguration): Promise<CreateCompletionResponse>;
     _generate(prompts: string[], options: this["ParsedCallOptions"], runManager?: CallbackManagerForLLMRun): Promise<LLMResult>;
 }

package/dist/llms/openai.js

@@ -1,14 +1,14 @@
 import { Configuration, OpenAIApi, } from "openai";
-import { isNode, getEnvironmentVariable } from "../util/env.js";
-import fetchAdapter from "../util/axios-fetch-adapter.js";
-import { chunkArray } from "../util/chunk.js";
-import { BaseLLM } from "./base.js";
 import { calculateMaxTokens } from "../base_language/count_tokens.js";
-import { OpenAIChat } from "./openai-chat.js";
 import { GenerationChunk } from "../schema/index.js";
-import { promptLayerTrackRequest } from "../util/prompt-layer.js";
+import fetchAdapter from "../util/axios-fetch-adapter.js";
 import { getEndpoint } from "../util/azure.js";
+import { chunkArray } from "../util/chunk.js";
+import { getEnvironmentVariable, isNode } from "../util/env.js";
+import { promptLayerTrackRequest } from "../util/prompt-layer.js";
 import { readableStreamToAsyncIterable } from "../util/stream.js";
+import { BaseLLM } from "./base.js";
+import { OpenAIChat } from "./openai-chat.js";
 /**
  * Wrapper around OpenAI large language models.
  *
@@ -28,6 +28,9 @@ import { readableStreamToAsyncIterable } from "../util/stream.js";
  * if not explicitly available on this class.
  */
 export class OpenAI extends BaseLLM {
+    static lc_name() {
+        return "OpenAI";
+    }
     get callKeys() {
         return [...super.callKeys, "options"];
     }
@@ -35,6 +38,7 @@ export class OpenAI extends BaseLLM {
         return {
             openAIApiKey: "OPENAI_API_KEY",
             azureOpenAIApiKey: "AZURE_OPENAI_API_KEY",
+            organization: "OPENAI_ORGANIZATION",
         };
     }
     get lc_aliases() {
@@ -189,6 +193,12 @@ export class OpenAI extends BaseLLM {
             writable: true,
             value: void 0
         });
+        Object.defineProperty(this, "organization", {
+            enumerable: true,
+            configurable: true,
+            writable: true,
+            value: void 0
+        });
         Object.defineProperty(this, "client", {
             enumerable: true,
             configurable: true,
@@ -223,6 +233,9 @@ export class OpenAI extends BaseLLM {
         this.azureOpenAIBasePath =
             fields?.azureOpenAIBasePath ??
                 getEnvironmentVariable("AZURE_OPENAI_BASE_PATH");
+        this.organization =
+            fields?.configuration?.organization ??
+                getEnvironmentVariable("OPENAI_ORGANIZATION");
         this.modelName = fields?.modelName ?? this.modelName;
         this.modelKwargs = fields?.modelKwargs ?? {};
         this.batchSize = fields?.batchSize ?? this.batchSize;
@@ -254,6 +267,7 @@ export class OpenAI extends BaseLLM {
         }
         this.clientConfig = {
             apiKey: this.openAIApiKey,
+            organization: this.organization,
             ...configuration,
             ...fields?.configuration,
         };
@@ -601,6 +615,12 @@ export class PromptLayerOpenAI extends OpenAI {
             throw new Error("Missing PromptLayer API key");
         }
     }
+    /**
+     * Calls the OpenAI API with retry logic in case of failures.
+     * @param request The request to send to the OpenAI API.
+     * @param options Optional configuration for the API call.
+     * @returns The response from the OpenAI API.
+     */
     async completionWithRetry(request, options) {
         if (request.stream) {
             return super.completionWithRetry(request, options);

package/dist/llms/replicate.cjs

@@ -3,7 +3,16 @@ Object.defineProperty(exports, "__esModule", { value: true });
 exports.Replicate = void 0;
 const env_js_1 = require("../util/env.cjs");
 const base_js_1 = require("./base.cjs");
+/**
+ * Class responsible for managing the interaction with the Replicate API.
+ * It handles the API key and model details, makes the actual API calls,
+ * and converts the API response into a format usable by the rest of the
+ * LangChain framework.
+ */
 class Replicate extends base_js_1.LLM {
+    static lc_name() {
+        return "Replicate";
+    }
     get lc_secrets() {
         return {
             apiKey: "REPLICATE_API_TOKEN",

package/dist/llms/replicate.d.ts

@@ -1,4 +1,9 @@
 import { LLM, BaseLLMParams } from "./base.js";
+/**
+ * Interface defining the structure of the input data for the Replicate
+ * class. It includes details about the model to be used, any additional
+ * input parameters, and the API key for the Replicate service.
+ */
 export interface ReplicateInput {
     model: `${string}/${string}:${string}`;
     input?: {
@@ -6,7 +11,14 @@ export interface ReplicateInput {
     };
     apiKey?: string;
 }
+/**
+ * Class responsible for managing the interaction with the Replicate API.
+ * It handles the API key and model details, makes the actual API calls,
+ * and converts the API response into a format usable by the rest of the
+ * LangChain framework.
+ */
 export declare class Replicate extends LLM implements ReplicateInput {
+    static lc_name(): string;
     get lc_secrets(): {
         [key: string]: string;
     } | undefined;

package/dist/llms/replicate.js

@@ -1,6 +1,15 @@
 import { getEnvironmentVariable } from "../util/env.js";
 import { LLM } from "./base.js";
+/**
+ * Class responsible for managing the interaction with the Replicate API.
+ * It handles the API key and model details, makes the actual API calls,
+ * and converts the API response into a format usable by the rest of the
+ * LangChain framework.
+ */
 export class Replicate extends LLM {
+    static lc_name() {
+        return "Replicate";
+    }
     get lc_secrets() {
         return {
             apiKey: "REPLICATE_API_TOKEN",

package/dist/llms/sagemaker_endpoint.cjs

@@ -49,6 +49,17 @@ class BaseSageMakerContentHandler {
     }
 }
 exports.BaseSageMakerContentHandler = BaseSageMakerContentHandler;
+/**
+ * The SageMakerEndpoint class is used to interact with SageMaker
+ * Inference Endpoint models. It extends the LLM class and overrides the
+ * _call method to transform the input and output between the LLM and the
+ * SageMaker endpoint using the provided content handler. The class uses
+ * AWS client for authentication, which automatically loads credentials.
+ * If a specific credential profile is to be used, the name of the profile
+ * from the ~/.aws/credentials file must be passed. The credentials or
+ * roles used should have the required policies to access the SageMaker
+ * endpoint.
+ */
 class SageMakerEndpoint extends base_js_1.LLM {
     get lc_secrets() {
         return {

package/dist/llms/sagemaker_endpoint.d.ts

@@ -45,6 +45,12 @@ export declare abstract class BaseSageMakerContentHandler<InputType, OutputType>
 }
 /** Content handler for LLM class. */
 export type SageMakerLLMContentHandler = BaseSageMakerContentHandler<string, string>;
+/**
+ * The SageMakerEndpointInput interface defines the input parameters for
+ * the SageMakerEndpoint class, which includes the endpoint name, client
+ * options for the SageMaker client, the content handler, and optional
+ * keyword arguments for the model and the endpoint.
+ */
 export interface SageMakerEndpointInput extends BaseLLMParams {
     /**
      * The name of the endpoint from the deployed SageMaker model. Must be unique
@@ -69,6 +75,17 @@ export interface SageMakerEndpointInput extends BaseLLMParams {
      */
     endpointKwargs?: Record<string, unknown>;
 }
+/**
+ * The SageMakerEndpoint class is used to interact with SageMaker
+ * Inference Endpoint models. It extends the LLM class and overrides the
+ * _call method to transform the input and output between the LLM and the
+ * SageMaker endpoint using the provided content handler. The class uses
+ * AWS client for authentication, which automatically loads credentials.
+ * If a specific credential profile is to be used, the name of the profile
+ * from the ~/.aws/credentials file must be passed. The credentials or
+ * roles used should have the required policies to access the SageMaker
+ * endpoint.
+ */
 export declare class SageMakerEndpoint extends LLM {
     get lc_secrets(): {
         [key: string]: string;

package/dist/llms/sagemaker_endpoint.js

@@ -45,6 +45,17 @@ export class BaseSageMakerContentHandler {
         });
     }
 }
+/**
+ * The SageMakerEndpoint class is used to interact with SageMaker
+ * Inference Endpoint models. It extends the LLM class and overrides the
+ * _call method to transform the input and output between the LLM and the
+ * SageMaker endpoint using the provided content handler. The class uses
+ * AWS client for authentication, which automatically loads credentials.
+ * If a specific credential profile is to be used, the name of the profile
+ * from the ~/.aws/credentials file must be passed. The credentials or
+ * roles used should have the required policies to access the SageMaker
+ * endpoint.
+ */
 export class SageMakerEndpoint extends LLM {
     get lc_secrets() {
         return {

package/dist/load/index.cjs

@@ -24,6 +24,7 @@ var __importStar = (this && this.__importStar) || function (mod) {
 };
 Object.defineProperty(exports, "__esModule", { value: true });
 exports.load = void 0;
+const serializable_js_1 = require("./serializable.cjs");
 const import_constants_js_1 = require("./import_constants.cjs");
 const importMap = __importStar(require("./import_map.cjs"));
 const map_keys_js_1 = require("./map_keys.cjs");
@@ -132,7 +133,12 @@ async function reviver(value) {
             throw new Error(`Invalid namespace: ${pathStr} -> ${str}`);
         }
         // Extract the builder from the import map.
-        const builder = module[name];
+        const builder = 
+        // look for a named export with the same name as the class
+        module[name] ??
+            // look for an export with a lc_name property matching the class name
+            // this is necessary for classes that are minified
+            Object.values(module).find((v) => typeof v === "function" && (0, serializable_js_1.get_lc_unique_name)(v) === name);
         if (typeof builder !== "function") {
             throw new Error(`Invalid identifer: ${pathStr} -> ${str}`);
         }

package/dist/load/index.js

@@ -1,3 +1,4 @@
+import { get_lc_unique_name, } from "./serializable.js";
 import { optionalImportEntrypoints } from "./import_constants.js";
 import * as importMap from "./import_map.js";
 import { keyFromJson, mapKeys } from "./map_keys.js";
@@ -106,7 +107,12 @@ async function reviver(value) {
             throw new Error(`Invalid namespace: ${pathStr} -> ${str}`);
         }
         // Extract the builder from the import map.
-        const builder = module[name];
+        const builder = 
+        // look for a named export with the same name as the class
+        module[name] ??
+            // look for an export with a lc_name property matching the class name
+            // this is necessary for classes that are minified
+            Object.values(module).find((v) => typeof v === "function" && get_lc_unique_name(v) === name);
         if (typeof builder !== "function") {
             throw new Error(`Invalid identifer: ${pathStr} -> ${str}`);
         }

package/dist/load/serializable.cjs

@@ -1,6 +1,6 @@
 "use strict";
 Object.defineProperty(exports, "__esModule", { value: true });
-exports.Serializable = void 0;
+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 };
@@ -28,7 +28,46 @@ function replaceSecrets(root, secretsMap) {
     }
     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".
@@ -107,7 +146,7 @@ class Serializable {
         return {
             lc: 1,
             type: "constructor",
-            id: [...this.lc_namespace, this.constructor.name],
+            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),
         };
     }
@@ -115,7 +154,7 @@ class Serializable {
         return {
             lc: 1,
             type: "not_implemented",
-            id: [...this.lc_namespace, this.constructor.name],
+            id: this.lc_id,
         };
     }
 }

package/dist/load/serializable.d.ts

@@ -12,6 +12,11 @@ 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;
@@ -20,6 +25,17 @@ export declare abstract class Serializable {
      * 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".