@oracle/langchain-oracledb 1.0.0 → 1.1.0

package/dist/chatMessageHistories.js

@@ -0,0 +1,338 @@
+import { BaseListChatMessageHistory } from "@langchain/core/chat_history";
+import { dropTablePurge } from "./vectorstores.js";
+import { createHash } from "node:crypto";
+import oracledb from "oracledb";
+import { ErrorCode, throwError, handleError, createErrorFromCodeWithCause, } from "./errors.js";
+import { mapStoredMessageToChatMessage, } from "@langchain/core/messages";
+import { withConnection, quoteIdentifier, } from "./utils.js";
+const DEFAULT_TABLE_NAME = "langchain_message_store";
+const DEFAULT_SESSION_ID_KEY = "session_id";
+const DEFAULT_HISTORY_KEY = "message";
+const DEFAULT_ID_KEY = quoteIdentifier("id");
+function unqualifiedIdentifier(name) {
+    return name.replaceAll('"', "").split(".").pop();
+}
+function defaultIndexName(tableName, sessionIdKey) {
+    const baseName = `idx_${unqualifiedIdentifier(tableName)}_` +
+        unqualifiedIdentifier(sessionIdKey);
+    const encoded = Buffer.from(baseName, "utf-8");
+    if (encoded.length <= 128)
+        return baseName;
+    const digest = createHash("sha1").update(encoded).digest("hex").slice(0, 8);
+    const prefix = new TextDecoder("utf-8").decode(encoded.subarray(0, 119), {
+        stream: true,
+    });
+    return `${prefix}_${digest}`;
+}
+/**
+ * Stores conversation messages in Oracle Database, with one row per message
+ * and a session ID identifying each conversation. Extends BaseListChatMessageHistory.
+ *
+ * Call `createTables()` before using the history unless the table already exists.
+ * A single table can hold many sessions separated by the configured session ID column.
+ * @example
+ * ```typescript
+ * // `pool` is an Oracle connection pool.
+ * await OracleChatMessageHistory.createTables({
+ *    client: pool,
+ *    tableName: "langchain_chat_histories"
+ * });
+ *
+ * const chatHistory = new OracleChatMessageHistory({
+ *   client: pool,
+ *   tableName: "langchain_chat_histories",
+ *   sessionId: "lc-example",
+ *   historySize: 20,
+ * });
+ *
+ * ```
+ */
+export class OracleChatMessageHistory extends BaseListChatMessageHistory {
+    /**
+     * Creates an OracleChatMessageHistory instance without performing database setup.
+     * @param {OracleChatMessageHistoryInput} options The history configuration.
+     * @param {OracleDBClient | OracleDBClientProvider} options.client The connection, pool, or async provider to use.
+     * @param {string} options.sessionId The session ID used to store and retrieve messages.
+     * @param {string} options.tableName Table used to store chat history rows. Defaults to `langchain_message_store`.
+     * @param {string} options.sessionIdKey Column containing the session identifier. Defaults to `session_id`.
+     * @param {string} options.historyKey Column containing the serialized message payload. Defaults to `message`.
+     * @param {number} options.historySize Optional maximum number of most recent messages to return.
+     * @throws If the client is missing, the session ID is empty or not a string,
+     * an identifier is invalid, or the history size is not a positive safe integer.
+     */
+    constructor({ client, sessionId, tableName = DEFAULT_TABLE_NAME, sessionIdKey = DEFAULT_SESSION_ID_KEY, historyKey = DEFAULT_HISTORY_KEY, historySize, }) {
+        super();
+        Object.defineProperty(this, "lc_namespace", {
+            enumerable: true,
+            configurable: true,
+            writable: true,
+            value: ["langchain", "stores", "message", "oracle"]
+        });
+        Object.defineProperty(this, "client", {
+            enumerable: true,
+            configurable: true,
+            writable: true,
+            value: void 0
+        });
+        Object.defineProperty(this, "sessionId", {
+            enumerable: true,
+            configurable: true,
+            writable: true,
+            value: void 0
+        });
+        Object.defineProperty(this, "quotedTableName", {
+            enumerable: true,
+            configurable: true,
+            writable: true,
+            value: void 0
+        });
+        Object.defineProperty(this, "quotedSessionIdKey", {
+            enumerable: true,
+            configurable: true,
+            writable: true,
+            value: void 0
+        });
+        Object.defineProperty(this, "quotedHistoryKey", {
+            enumerable: true,
+            configurable: true,
+            writable: true,
+            value: void 0
+        });
+        Object.defineProperty(this, "historySize", {
+            enumerable: true,
+            configurable: true,
+            writable: true,
+            value: void 0
+        });
+        if (typeof sessionId !== "string" || !sessionId) {
+            throwError(ErrorCode.VALIDATION_INVALID_INPUT, "sessionId must be a non-empty string");
+        }
+        if (client == null) {
+            throwError(ErrorCode.VALIDATION_MISSING_REQUIRED_PARAMETER, "client");
+        }
+        if (historySize !== undefined &&
+            (!Number.isSafeInteger(historySize) || historySize < 1)) {
+            throwError(ErrorCode.VALIDATION_INVALID_INPUT, "historySize must be greater than 0");
+        }
+        this.client = client;
+        this.sessionId = sessionId;
+        this.historySize = historySize;
+        this.quotedTableName = quoteIdentifier(tableName);
+        this.quotedSessionIdKey = quoteIdentifier(sessionIdKey);
+        this.quotedHistoryKey = quoteIdentifier(historyKey);
+    }
+    /**
+     * Creates the history table and optional session index if they do not exist.
+     * @param {OracleChatMessageHistorySetupInput} options The database setup configuration.
+     * @param {boolean} options.createIndex Whether to create the session index. Defaults to `true`.
+     * @returns Promise that resolves when database setup completes.
+     */
+    static async createTables({ client, tableName = DEFAULT_TABLE_NAME, createIndex = true, sessionIdKey = DEFAULT_SESSION_ID_KEY, historyKey = DEFAULT_HISTORY_KEY, }) {
+        try {
+            const quotedTableName = quoteIdentifier(tableName);
+            const quotedSessionIdKey = quoteIdentifier(sessionIdKey);
+            const quotedHistoryKey = quoteIdentifier(historyKey);
+            const createTableSql = `
+      CREATE TABLE IF NOT EXISTS ${quotedTableName} (
+        ${DEFAULT_ID_KEY} NUMBER GENERATED BY DEFAULT AS IDENTITY PRIMARY KEY,
+        ${quotedSessionIdKey} VARCHAR2(255) NOT NULL,
+        ${quotedHistoryKey} CLOB NOT NULL,
+        created_at TIMESTAMP WITH TIME ZONE DEFAULT CURRENT_TIMESTAMP NOT NULL
+      )`;
+            const indexName = defaultIndexName(tableName, sessionIdKey);
+            const createIndexSql = `
+        CREATE INDEX IF NOT EXISTS ${quoteIdentifier(indexName)}
+        ON ${quotedTableName} (${quotedSessionIdKey})
+      `;
+            await withConnection(client, async (connection) => {
+                await connection.execute(createTableSql);
+                if (createIndex) {
+                    await connection.execute(createIndexSql);
+                }
+            });
+        }
+        catch (error) {
+            handleError(error);
+        }
+    }
+    /**
+     * Drops and purges the history table if it exists, removing every session's messages.
+     * @param {OracleDBClient | OracleDBClientProvider} client The connection, pool, or async provider to use.
+     * @param {string} tableName The table to drop. Defaults to `langchain_message_store`.
+     * @returns Promise that resolves when the table has been dropped or does not exist.
+     */
+    static async dropTable(client, tableName = DEFAULT_TABLE_NAME) {
+        try {
+            await withConnection(client, async (connection) => {
+                await dropTablePurge(connection, tableName);
+            });
+        }
+        catch (error) {
+            handleError(error);
+        }
+    }
+    /**
+     * Adds one message to the session.
+     * @param {BaseMessage} message The message to store.
+     * @returns Promise that resolves when the message has been stored.
+     */
+    async addMessage(message) {
+        try {
+            const binds = [this.sessionId, JSON.stringify(message.toDict())];
+            await withConnection(this.client, async (connection) => {
+                await connection.execute(this.insertQuery, binds);
+                await connection.commit();
+            });
+        }
+        catch (error) {
+            handleError(error);
+        }
+    }
+    /**
+     * Adds a batch of messages in insertion order.
+     * @param {BaseMessage[]} messages The messages to store.
+     * @returns Promise that resolves when the messages have been stored.
+     */
+    async addMessages(messages) {
+        try {
+            if (messages.length === 0)
+                return;
+            const rows = messages.map((message) => [
+                this.sessionId,
+                JSON.stringify(message.toDict()),
+            ]);
+            await withConnection(this.client, async (connection) => {
+                await connection.executeMany(this.insertQuery, rows, {
+                    autoCommit: false,
+                });
+                await connection.commit();
+            });
+        }
+        catch (error) {
+            handleError(error);
+        }
+    }
+    /**
+     * Retrieves messages for the configured session in ascending ID order.
+     * When `historySize` is set, returns only the most recent messages in that order.
+     * @returns Promise resolving to the stored messages, or an empty array for an empty session.
+     */
+    async getMessages() {
+        try {
+            let query;
+            let params;
+            if (this.historySize === undefined) {
+                query = `
+        SELECT ${this.quotedHistoryKey} AS "payload", ${DEFAULT_ID_KEY}
+        FROM ${this.quotedTableName}
+        WHERE ${this.quotedSessionIdKey} = :session_id
+        ORDER BY ${DEFAULT_ID_KEY}
+      `;
+                params = { session_id: this.sessionId };
+            }
+            else {
+                query = `
+        SELECT payload AS "payload", ${DEFAULT_ID_KEY}
+        FROM (
+          SELECT ${this.quotedHistoryKey} AS payload, ${DEFAULT_ID_KEY}
+          FROM ${this.quotedTableName}
+          WHERE ${this.quotedSessionIdKey} = :session_id
+          ORDER BY ${DEFAULT_ID_KEY} DESC
+        )
+        WHERE ROWNUM <= :history_size
+        ORDER BY ${DEFAULT_ID_KEY}
+      `;
+                params = {
+                    session_id: this.sessionId,
+                    history_size: this.historySize,
+                };
+            }
+            const result = await withConnection(this.client, (connection) => connection.execute(query, params, {
+                outFormat: oracledb.OUT_FORMAT_OBJECT,
+                fetchInfo: {
+                    payload: { type: oracledb.STRING },
+                },
+            }));
+            return (result.rows ?? []).map((row) => {
+                try {
+                    return mapStoredMessageToChatMessage(JSON.parse(row.payload));
+                }
+                catch (error) {
+                    throw createErrorFromCodeWithCause(ErrorCode.HISTORY_DESERIALIZATION_FAILED, error);
+                }
+            });
+        }
+        catch (error) {
+            handleError(error);
+        }
+    }
+    /**
+     * Deletes all messages belonging to the configured session.
+     * @returns Promise that resolves when this session's messages have been cleared.
+     */
+    async clear() {
+        try {
+            await withConnection(this.client, async (connection) => {
+                await connection.execute(this.deleteQuery, { session_id: this.sessionId }, { autoCommit: true });
+            });
+        }
+        catch (error) {
+            handleError(error);
+        }
+    }
+    /**
+     * Replaces the configured session's stored messages. An empty array clears the session.
+     * @param {BaseMessage[]} messages The replacement messages in insertion order.
+     * @returns Promise that resolves when the replacement has been committed.
+     */
+    async replaceMessages(messages) {
+        try {
+            const rows = messages.map((message) => [
+                this.sessionId,
+                JSON.stringify(message.toDict()),
+            ]);
+            await withConnection(this.client, async (connection) => {
+                try {
+                    await connection.execute(this.deleteQuery, { session_id: this.sessionId }, { autoCommit: false });
+                    if (rows.length > 0) {
+                        await connection.executeMany(this.insertQuery, rows, {
+                            autoCommit: false,
+                            batchErrors: false,
+                        });
+                    }
+                    await connection.commit();
+                }
+                catch (error) {
+                    let cause = error;
+                    try {
+                        await connection.rollback();
+                    }
+                    catch (rollbackError) {
+                        cause = new AggregateError([error, rollbackError], "Replacing messages failed, and rollback also failed.");
+                    }
+                    throw createErrorFromCodeWithCause(ErrorCode.HISTORY_REPLACEMENT_FAILED, cause);
+                }
+            });
+        }
+        catch (error) {
+            handleError(error);
+        }
+    }
+    get insertQuery() {
+        return `
+      INSERT INTO ${this.quotedTableName}
+        (
+          ${this.quotedSessionIdKey},
+          ${this.quotedHistoryKey}
+        )
+      VALUES (:1, :2)
+    `;
+    }
+    get deleteQuery() {
+        return `
+      DELETE FROM ${this.quotedTableName}
+      WHERE ${this.quotedSessionIdKey} = :session_id
+    `;
+    }
+}
+//# sourceMappingURL=chatMessageHistories.js.map

package/dist/chatMessageHistories.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"chatMessageHistories.js","sourceRoot":"","sources":["../src/chatMessageHistories.ts"],"names":[],"mappings":"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"}

package/dist/errors.cjs

@@ -1,7 +1,7 @@
 "use strict";
 var _a;
 Object.defineProperty(exports, "__esModule", { value: true });
-exports.throwError = exports.createErrorFromCodeWithCause = exports.createErrorFromCode = exports.isLangChainOracleError = exports.createError = exports.LangChainOracleError = exports.ErrorCode = void 0;
+exports.throwError = exports.createErrorFromCodeWithCause = exports.createErrorFromCode = exports.isLangChainOracleError = exports.createError = exports.handleError = exports.LangChainOracleError = exports.ErrorCode = void 0;
 exports.ErrorCode = {
     VALIDATION_INVALID_INPUT: "VALIDATION_INVALID_INPUT",
     VALIDATION_MISSING_REQUIRED_PARAMETER: "VALIDATION_MISSING_REQUIRED_PARAMETER",
@@ -15,6 +15,9 @@ exports.ErrorCode = {
     VECTOR_INVALID_INDEX_PARAMETERS: "VECTOR_INVALID_INDEX_PARAMETERS",
     STATE_INVALID: "STATE_INVALID",
     QUERY_NO_ROWS_FOUND: "QUERY_NO_ROWS_FOUND",
+    CACHE_DESERIALIZATION_FAILED: "CACHE_DESERIALIZATION_FAILED",
+    HISTORY_DESERIALIZATION_FAILED: "HISTORY_DESERIALIZATION_FAILED",
+    HISTORY_REPLACEMENT_FAILED: "HISTORY_REPLACEMENT_FAILED",
     SYSTEM_ERROR: "SYSTEM_ERROR",
 };
 const LANGCHAIN_ORACLE_ERROR_BRAND = Symbol.for("@oracle/langchain-oracledb/LangChainOracleError");
@@ -54,6 +57,24 @@ class LangChainOracleError extends Error {
 }
 exports.LangChainOracleError = LangChainOracleError;
 _a = LANGCHAIN_ORACLE_ERROR_BRAND;
+function handleError(error) {
+    // Preserve LangChainOracleError instances created by this package instead of
+    // wrapping them again as generic SYSTEM_ERROR failures.
+    if (isLangChainOracleError(error)) {
+        throw error;
+    }
+    // Preserve a useful message for both real Error instances and thrown
+    // object literals shaped like { message: string }.
+    const details = typeof error === "object" &&
+        error !== null &&
+        "message" in error &&
+        typeof error.message === "string"
+        ? error.message
+        : String(error);
+    // Preserve the original cause when wrapping an unexpected error.
+    throw createErrorFromCodeWithCause(exports.ErrorCode.SYSTEM_ERROR, error, `An unexpected error occurred during the operation. ${details}`);
+}
+exports.handleError = handleError;
 function createError(code, message, cause) {
     return new LangChainOracleError(code, message, cause);
 }
@@ -79,6 +100,9 @@ const errorMessageFactories = {
     [exports.ErrorCode.VECTOR_INVALID_INDEX_PARAMETERS]: (invalidKeys) => `Invalid parameter(s): ${invalidKeys.join(", ")}`,
     [exports.ErrorCode.STATE_INVALID]: (message) => message,
     [exports.ErrorCode.QUERY_NO_ROWS_FOUND]: () => "No rows found.",
+    [exports.ErrorCode.CACHE_DESERIALIZATION_FAILED]: () => "Failed to deserialize cached generations.",
+    [exports.ErrorCode.HISTORY_DESERIALIZATION_FAILED]: () => "Failed to deserialize a stored history message.",
+    [exports.ErrorCode.HISTORY_REPLACEMENT_FAILED]: () => "Failed to replace stored history messages.",
     [exports.ErrorCode.SYSTEM_ERROR]: (message) => message,
 };
 function getErrorMessage(code, ...args) {

package/dist/errors.cjs.map

@@ -1 +1 @@
-{"version":3,"file":"errors.cjs","sourceRoot":"","sources":["../src/errors.ts"],"names":[],"mappings":"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"}
+{"version":3,"file":"errors.cjs","sourceRoot":"","sources":["../src/errors.ts"],"names":[],"mappings":"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"}

package/dist/errors.d.cts

@@ -11,6 +11,9 @@ export declare const ErrorCode: {
     readonly VECTOR_INVALID_INDEX_PARAMETERS: "VECTOR_INVALID_INDEX_PARAMETERS";
     readonly STATE_INVALID: "STATE_INVALID";
     readonly QUERY_NO_ROWS_FOUND: "QUERY_NO_ROWS_FOUND";
+    readonly CACHE_DESERIALIZATION_FAILED: "CACHE_DESERIALIZATION_FAILED";
+    readonly HISTORY_DESERIALIZATION_FAILED: "HISTORY_DESERIALIZATION_FAILED";
+    readonly HISTORY_REPLACEMENT_FAILED: "HISTORY_REPLACEMENT_FAILED";
     readonly SYSTEM_ERROR: "SYSTEM_ERROR";
 };
 export type ErrorCode = (typeof ErrorCode)[keyof typeof ErrorCode];
@@ -28,6 +31,9 @@ type ErrorArgs = {
     [ErrorCode.VECTOR_INVALID_INDEX_PARAMETERS]: [invalidKeys: string[]];
     [ErrorCode.STATE_INVALID]: [message: string];
     [ErrorCode.QUERY_NO_ROWS_FOUND]: [];
+    [ErrorCode.CACHE_DESERIALIZATION_FAILED]: [];
+    [ErrorCode.HISTORY_DESERIALIZATION_FAILED]: [];
+    [ErrorCode.HISTORY_REPLACEMENT_FAILED]: [];
     [ErrorCode.SYSTEM_ERROR]: [message: string];
 };
 /**
@@ -42,6 +48,7 @@ export declare class LangChainOracleError extends Error {
     readonly [LANGCHAIN_ORACLE_ERROR_BRAND] = true;
     constructor(code: ErrorCode, message: string, cause?: unknown);
 }
+export declare function handleError(error: unknown): never;
 export declare function createError(code: ErrorCode, message: string, cause?: unknown): LangChainOracleError;
 export declare function isLangChainOracleError(error: unknown): error is LangChainOracleError;
 export declare function createErrorFromCode<K extends ErrorCode>(code: K, ...args: ErrorArgs[K]): LangChainOracleError;

package/dist/errors.d.ts

@@ -11,6 +11,9 @@ export declare const ErrorCode: {
     readonly VECTOR_INVALID_INDEX_PARAMETERS: "VECTOR_INVALID_INDEX_PARAMETERS";
     readonly STATE_INVALID: "STATE_INVALID";
     readonly QUERY_NO_ROWS_FOUND: "QUERY_NO_ROWS_FOUND";
+    readonly CACHE_DESERIALIZATION_FAILED: "CACHE_DESERIALIZATION_FAILED";
+    readonly HISTORY_DESERIALIZATION_FAILED: "HISTORY_DESERIALIZATION_FAILED";
+    readonly HISTORY_REPLACEMENT_FAILED: "HISTORY_REPLACEMENT_FAILED";
     readonly SYSTEM_ERROR: "SYSTEM_ERROR";
 };
 export type ErrorCode = (typeof ErrorCode)[keyof typeof ErrorCode];
@@ -28,6 +31,9 @@ type ErrorArgs = {
     [ErrorCode.VECTOR_INVALID_INDEX_PARAMETERS]: [invalidKeys: string[]];
     [ErrorCode.STATE_INVALID]: [message: string];
     [ErrorCode.QUERY_NO_ROWS_FOUND]: [];
+    [ErrorCode.CACHE_DESERIALIZATION_FAILED]: [];
+    [ErrorCode.HISTORY_DESERIALIZATION_FAILED]: [];
+    [ErrorCode.HISTORY_REPLACEMENT_FAILED]: [];
     [ErrorCode.SYSTEM_ERROR]: [message: string];
 };
 /**
@@ -42,6 +48,7 @@ export declare class LangChainOracleError extends Error {
     readonly [LANGCHAIN_ORACLE_ERROR_BRAND] = true;
     constructor(code: ErrorCode, message: string, cause?: unknown);
 }
+export declare function handleError(error: unknown): never;
 export declare function createError(code: ErrorCode, message: string, cause?: unknown): LangChainOracleError;
 export declare function isLangChainOracleError(error: unknown): error is LangChainOracleError;
 export declare function createErrorFromCode<K extends ErrorCode>(code: K, ...args: ErrorArgs[K]): LangChainOracleError;

package/dist/errors.js

@@ -12,6 +12,9 @@ export const ErrorCode = {
     VECTOR_INVALID_INDEX_PARAMETERS: "VECTOR_INVALID_INDEX_PARAMETERS",
     STATE_INVALID: "STATE_INVALID",
     QUERY_NO_ROWS_FOUND: "QUERY_NO_ROWS_FOUND",
+    CACHE_DESERIALIZATION_FAILED: "CACHE_DESERIALIZATION_FAILED",
+    HISTORY_DESERIALIZATION_FAILED: "HISTORY_DESERIALIZATION_FAILED",
+    HISTORY_REPLACEMENT_FAILED: "HISTORY_REPLACEMENT_FAILED",
     SYSTEM_ERROR: "SYSTEM_ERROR",
 };
 const LANGCHAIN_ORACLE_ERROR_BRAND = Symbol.for("@oracle/langchain-oracledb/LangChainOracleError");
@@ -50,6 +53,23 @@ export class LangChainOracleError extends Error {
     }
 }
 _a = LANGCHAIN_ORACLE_ERROR_BRAND;
+export function handleError(error) {
+    // Preserve LangChainOracleError instances created by this package instead of
+    // wrapping them again as generic SYSTEM_ERROR failures.
+    if (isLangChainOracleError(error)) {
+        throw error;
+    }
+    // Preserve a useful message for both real Error instances and thrown
+    // object literals shaped like { message: string }.
+    const details = typeof error === "object" &&
+        error !== null &&
+        "message" in error &&
+        typeof error.message === "string"
+        ? error.message
+        : String(error);
+    // Preserve the original cause when wrapping an unexpected error.
+    throw createErrorFromCodeWithCause(ErrorCode.SYSTEM_ERROR, error, `An unexpected error occurred during the operation. ${details}`);
+}
 export function createError(code, message, cause) {
     return new LangChainOracleError(code, message, cause);
 }
@@ -73,6 +93,9 @@ const errorMessageFactories = {
     [ErrorCode.VECTOR_INVALID_INDEX_PARAMETERS]: (invalidKeys) => `Invalid parameter(s): ${invalidKeys.join(", ")}`,
     [ErrorCode.STATE_INVALID]: (message) => message,
     [ErrorCode.QUERY_NO_ROWS_FOUND]: () => "No rows found.",
+    [ErrorCode.CACHE_DESERIALIZATION_FAILED]: () => "Failed to deserialize cached generations.",
+    [ErrorCode.HISTORY_DESERIALIZATION_FAILED]: () => "Failed to deserialize a stored history message.",
+    [ErrorCode.HISTORY_REPLACEMENT_FAILED]: () => "Failed to replace stored history messages.",
     [ErrorCode.SYSTEM_ERROR]: (message) => message,
 };
 function getErrorMessage(code, ...args) {

package/dist/errors.js.map

@@ -1 +1 @@
-{"version":3,"file":"errors.js","sourceRoot":"","sources":["../src/errors.ts"],"names":[],"mappings":"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"}
+{"version":3,"file":"errors.js","sourceRoot":"","sources":["../src/errors.ts"],"names":[],"mappings":"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"}

package/dist/index.cjs

@@ -14,10 +14,20 @@ 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.throwError = exports.isLangChainOracleError = exports.createErrorFromCodeWithCause = exports.createErrorFromCode = exports.createError = exports.LangChainOracleError = exports.ErrorCode = void 0;
 __exportStar(require("./document_loaders.cjs"), exports);
 __exportStar(require("./embeddings.cjs"), exports);
-__exportStar(require("./errors.cjs"), exports);
+var errors_js_1 = require("./errors.cjs");
+Object.defineProperty(exports, "ErrorCode", { enumerable: true, get: function () { return errors_js_1.ErrorCode; } });
+Object.defineProperty(exports, "LangChainOracleError", { enumerable: true, get: function () { return errors_js_1.LangChainOracleError; } });
+Object.defineProperty(exports, "createError", { enumerable: true, get: function () { return errors_js_1.createError; } });
+Object.defineProperty(exports, "createErrorFromCode", { enumerable: true, get: function () { return errors_js_1.createErrorFromCode; } });
+Object.defineProperty(exports, "createErrorFromCodeWithCause", { enumerable: true, get: function () { return errors_js_1.createErrorFromCodeWithCause; } });
+Object.defineProperty(exports, "isLangChainOracleError", { enumerable: true, get: function () { return errors_js_1.isLangChainOracleError; } });
+Object.defineProperty(exports, "throwError", { enumerable: true, get: function () { return errors_js_1.throwError; } });
 __exportStar(require("./summary.cjs"), exports);
 __exportStar(require("./text_splitter.cjs"), exports);
 __exportStar(require("./vectorstores.cjs"), exports);
+__exportStar(require("./chatMessageHistories.cjs"), exports);
+__exportStar(require("./cache.cjs"), exports);
 //# sourceMappingURL=index.cjs.map

package/dist/index.cjs.map

@@ -1 +1 @@
-{"version":3,"file":"index.cjs","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":";;;;;;;;;;;;;;;;AAAA,wDAAsC;AACtC,kDAAgC;AAChC,8CAA4B;AAC5B,+CAA6B;AAC7B,qDAAmC;AACnC,oDAAkC"}
+{"version":3,"file":"index.cjs","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":";;;;;;;;;;;;;;;;;AAAA,wDAAsC;AACtC,kDAAgC;AAChC,yCAQqB;AAPnB,sGAAA,SAAS,OAAA;AACT,iHAAA,oBAAoB,OAAA;AACpB,wGAAA,WAAW,OAAA;AACX,gHAAA,mBAAmB,OAAA;AACnB,yHAAA,4BAA4B,OAAA;AAC5B,mHAAA,sBAAsB,OAAA;AACtB,uGAAA,UAAU,OAAA;AAEZ,+CAA6B;AAC7B,qDAAmC;AACnC,oDAAkC;AAClC,4DAA0C;AAC1C,6CAA2B"}

package/dist/index.d.cts

@@ -1,6 +1,8 @@
 export * from "./document_loaders.js";
 export * from "./embeddings.js";
-export * from "./errors.js";
+export { ErrorCode, LangChainOracleError, createError, createErrorFromCode, createErrorFromCodeWithCause, isLangChainOracleError, throwError, } from "./errors.js";
 export * from "./summary.js";
 export * from "./text_splitter.js";
 export * from "./vectorstores.js";
+export * from "./chatMessageHistories.js";
+export * from "./cache.js";

package/dist/index.d.ts

@@ -1,6 +1,8 @@
 export * from "./document_loaders.js";
 export * from "./embeddings.js";
-export * from "./errors.js";
+export { ErrorCode, LangChainOracleError, createError, createErrorFromCode, createErrorFromCodeWithCause, isLangChainOracleError, throwError, } from "./errors.js";
 export * from "./summary.js";
 export * from "./text_splitter.js";
 export * from "./vectorstores.js";
+export * from "./chatMessageHistories.js";
+export * from "./cache.js";

package/dist/index.js

@@ -1,7 +1,9 @@
 export * from "./document_loaders.js";
 export * from "./embeddings.js";
-export * from "./errors.js";
+export { ErrorCode, LangChainOracleError, createError, createErrorFromCode, createErrorFromCodeWithCause, isLangChainOracleError, throwError, } from "./errors.js";
 export * from "./summary.js";
 export * from "./text_splitter.js";
 export * from "./vectorstores.js";
+export * from "./chatMessageHistories.js";
+export * from "./cache.js";
 //# sourceMappingURL=index.js.map

package/dist/index.js.map

@@ -1 +1 @@
-{"version":3,"file":"index.js","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA,cAAc,uBAAuB,CAAC;AACtC,cAAc,iBAAiB,CAAC;AAChC,cAAc,aAAa,CAAC;AAC5B,cAAc,cAAc,CAAC;AAC7B,cAAc,oBAAoB,CAAC;AACnC,cAAc,mBAAmB,CAAC"}
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA,cAAc,uBAAuB,CAAC;AACtC,cAAc,iBAAiB,CAAC;AAChC,OAAO,EACL,SAAS,EACT,oBAAoB,EACpB,WAAW,EACX,mBAAmB,EACnB,4BAA4B,EAC5B,sBAAsB,EACtB,UAAU,GACX,MAAM,aAAa,CAAC;AACrB,cAAc,cAAc,CAAC;AAC7B,cAAc,oBAAoB,CAAC;AACnC,cAAc,mBAAmB,CAAC;AAClC,cAAc,2BAA2B,CAAC;AAC1C,cAAc,YAAY,CAAC"}