@farukada/aws-langgraph-dynamodb-ts 0.0.6 → 0.0.8

package/dist/history/index.d.ts

@@ -0,0 +1,74 @@
+/**
+ * DynamoDB-based chat message history implementation for LangChain
+ * Provides persistent storage for chat messages with automatic title generation
+ */
+import { BaseMessage } from '@langchain/core/messages';
+import type { DynamoDBChatMessageHistoryOptions, SessionMetadata } from './types';
+export declare class DynamoDBChatMessageHistory {
+    private readonly ddbClient;
+    private readonly client;
+    private readonly tableName;
+    private readonly ttlDays?;
+    /**
+     * Create a new DynamoDB chat message history instance
+     *
+     * @param options - Configuration options for the chat message history
+     * @param options.tableName - Name of the DynamoDB table to use
+     * @param options.ttlDays - Optional TTL in days for automatic cleanup (1-1825 days)
+     * @param options.clientConfig - Optional DynamoDB client configuration
+     */
+    constructor(options: DynamoDBChatMessageHistoryOptions);
+    /**
+     * Get all messages for a session
+     * Messages are returned in chronological order
+     *
+     * @param userId - User identifier
+     * @param sessionId - Session identifier
+     * @returns Array of BaseMessage objects in chronological order
+     * @throws Error if the operation fails or validation fails
+     */
+    getMessages(userId: string, sessionId: string): Promise<BaseMessage[]>;
+    /**
+     * Add a single message to a session
+     * Generates title from the first message if this is a new session
+     *
+     * @param userId - User identifier
+     * @param sessionId - Session identifier
+     * @param message - The BaseMessage to add to the session
+     * @param title - Optional session title (auto-generated from the first message if not provided)
+     * @throws Error if the operation fails or validation fails
+     */
+    addMessage(userId: string, sessionId: string, message: BaseMessage, title?: string): Promise<void>;
+    /**
+     * Add multiple messages to a session
+     * Generates title from the first message if this is a new session
+     * Preferred over calling addMessage multiple times for performance
+     *
+     * @param userId - User identifier
+     * @param sessionId - Session identifier
+     * @param messages - Array of BaseMessage objects to add
+     * @param title - Optional session title (auto-generated from the first message if not provided)
+     * @throws Error if the operation fails or validation fails
+     */
+    addMessages(userId: string, sessionId: string, messages: BaseMessage[], title?: string): Promise<void>;
+    /**
+     * Clear all messages in a session
+     * Deletes the session item from DynamoDB
+     *
+     * @param userId - User identifier
+     * @param sessionId - Session identifier
+     * @throws Error if the operation fails or validation fails
+     */
+    clear(userId: string, sessionId: string): Promise<void>;
+    /**
+     * List all sessions for a user, sorted by most recent
+     * Returns metadata only (excludes messages for performance)
+     *
+     * @param userId - User ID to list sessions for
+     * @param limit - Optional maximum number of sessions to return (default: no limit)
+     * @returns Array of session metadata, sorted by most recent first
+     * @throws Error if the operation fails or validation fails
+     */
+    listSessions(userId: string, limit?: number): Promise<SessionMetadata[]>;
+}
+//# sourceMappingURL=index.d.ts.map

package/dist/history/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/history/index.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAIH,OAAO,EAAE,WAAW,EAAE,MAAM,0BAA0B,CAAC;AAEvD,OAAO,KAAK,EAAE,iCAAiC,EAAE,eAAe,EAAE,MAAM,SAAS,CAAC;AASlF,qBAAa,0BAA0B;IACrC,OAAO,CAAC,QAAQ,CAAC,SAAS,CAAiB;IAC3C,OAAO,CAAC,QAAQ,CAAC,MAAM,CAAmB;IAC1C,OAAO,CAAC,QAAQ,CAAC,SAAS,CAAS;IACnC,OAAO,CAAC,QAAQ,CAAC,OAAO,CAAC,CAAS;IAElC;;;;;;;OAOG;gBACS,OAAO,EAAE,iCAAiC;IAOtD;;;;;;;;OAQG;IACG,WAAW,CAAC,MAAM,EAAE,MAAM,EAAE,SAAS,EAAE,MAAM,GAAG,OAAO,CAAC,WAAW,EAAE,CAAC;IAS5E;;;;;;;;;OASG;IACG,UAAU,CACd,MAAM,EAAE,MAAM,EACd,SAAS,EAAE,MAAM,EACjB,OAAO,EAAE,WAAW,EACpB,KAAK,CAAC,EAAE,MAAM,GACb,OAAO,CAAC,IAAI,CAAC;IAYhB;;;;;;;;;;OAUG;IACG,WAAW,CACf,MAAM,EAAE,MAAM,EACd,SAAS,EAAE,MAAM,EACjB,QAAQ,EAAE,WAAW,EAAE,EACvB,KAAK,CAAC,EAAE,MAAM,GACb,OAAO,CAAC,IAAI,CAAC;IAYhB;;;;;;;OAOG;IACG,KAAK,CAAC,MAAM,EAAE,MAAM,EAAE,SAAS,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC;IAS7D;;;;;;;;OAQG;IACG,YAAY,CAAC,MAAM,EAAE,MAAM,EAAE,KAAK,CAAC,EAAE,MAAM,GAAG,OAAO,CAAC,eAAe,EAAE,CAAC;CAQ/E"}

package/dist/history/index.js

@@ -0,0 +1,125 @@
+"use strict";
+/**
+ * DynamoDB-based chat message history implementation for LangChain
+ * Provides persistent storage for chat messages with automatic title generation
+ */
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.DynamoDBChatMessageHistory = void 0;
+const client_dynamodb_1 = require("@aws-sdk/client-dynamodb");
+const lib_dynamodb_1 = require("@aws-sdk/lib-dynamodb");
+const actions_1 = require("./actions");
+class DynamoDBChatMessageHistory {
+    ddbClient;
+    client;
+    tableName;
+    ttlDays;
+    /**
+     * Create a new DynamoDB chat message history instance
+     *
+     * @param options - Configuration options for the chat message history
+     * @param options.tableName - Name of the DynamoDB table to use
+     * @param options.ttlDays - Optional TTL in days for automatic cleanup (1-1825 days)
+     * @param options.clientConfig - Optional DynamoDB client configuration
+     */
+    constructor(options) {
+        this.ddbClient = new client_dynamodb_1.DynamoDBClient(options.clientConfig || {});
+        this.client = lib_dynamodb_1.DynamoDBDocument.from(this.ddbClient);
+        this.tableName = options.tableName;
+        this.ttlDays = options.ttlDays;
+    }
+    /**
+     * Get all messages for a session
+     * Messages are returned in chronological order
+     *
+     * @param userId - User identifier
+     * @param sessionId - Session identifier
+     * @returns Array of BaseMessage objects in chronological order
+     * @throws Error if the operation fails or validation fails
+     */
+    async getMessages(userId, sessionId) {
+        return await (0, actions_1.getMessagesAction)({
+            client: this.client,
+            tableName: this.tableName,
+            userId,
+            sessionId,
+        });
+    }
+    /**
+     * Add a single message to a session
+     * Generates title from the first message if this is a new session
+     *
+     * @param userId - User identifier
+     * @param sessionId - Session identifier
+     * @param message - The BaseMessage to add to the session
+     * @param title - Optional session title (auto-generated from the first message if not provided)
+     * @throws Error if the operation fails or validation fails
+     */
+    async addMessage(userId, sessionId, message, title) {
+        await (0, actions_1.addMessageAction)({
+            client: this.client,
+            tableName: this.tableName,
+            userId,
+            sessionId,
+            message,
+            title,
+            ttlDays: this.ttlDays,
+        });
+    }
+    /**
+     * Add multiple messages to a session
+     * Generates title from the first message if this is a new session
+     * Preferred over calling addMessage multiple times for performance
+     *
+     * @param userId - User identifier
+     * @param sessionId - Session identifier
+     * @param messages - Array of BaseMessage objects to add
+     * @param title - Optional session title (auto-generated from the first message if not provided)
+     * @throws Error if the operation fails or validation fails
+     */
+    async addMessages(userId, sessionId, messages, title) {
+        await (0, actions_1.addMessagesAction)({
+            client: this.client,
+            tableName: this.tableName,
+            userId,
+            sessionId,
+            messages,
+            title,
+            ttlDays: this.ttlDays,
+        });
+    }
+    /**
+     * Clear all messages in a session
+     * Deletes the session item from DynamoDB
+     *
+     * @param userId - User identifier
+     * @param sessionId - Session identifier
+     * @throws Error if the operation fails or validation fails
+     */
+    async clear(userId, sessionId) {
+        await (0, actions_1.clearAction)({
+            client: this.client,
+            tableName: this.tableName,
+            userId,
+            sessionId,
+        });
+    }
+    /**
+     * List all sessions for a user, sorted by most recent
+     * Returns metadata only (excludes messages for performance)
+     *
+     * @param userId - User ID to list sessions for
+     * @param limit - Optional maximum number of sessions to return (default: no limit)
+     * @returns Array of session metadata, sorted by most recent first
+     * @throws Error if the operation fails or validation fails
+     */
+    async listSessions(userId, limit) {
+        return await (0, actions_1.listSessionsAction)({
+            client: this.client,
+            tableName: this.tableName,
+            userId,
+            limit,
+        });
+    }
+}
+exports.DynamoDBChatMessageHistory = DynamoDBChatMessageHistory;
+//# sourceMappingURL=index.js.map

package/dist/history/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/history/index.ts"],"names":[],"mappings":";AAAA;;;GAGG;;;AAEH,8DAA0D;AAC1D,wDAAyD;AAIzD,uCAMmB;AAEnB,MAAa,0BAA0B;IACpB,SAAS,CAAiB;IAC1B,MAAM,CAAmB;IACzB,SAAS,CAAS;IAClB,OAAO,CAAU;IAElC;;;;;;;OAOG;IACH,YAAY,OAA0C;QACpD,IAAI,CAAC,SAAS,GAAG,IAAI,gCAAc,CAAC,OAAO,CAAC,YAAY,IAAI,EAAE,CAAC,CAAC;QAChE,IAAI,CAAC,MAAM,GAAG,+BAAgB,CAAC,IAAI,CAAC,IAAI,CAAC,SAAS,CAAC,CAAC;QACpD,IAAI,CAAC,SAAS,GAAG,OAAO,CAAC,SAAS,CAAC;QACnC,IAAI,CAAC,OAAO,GAAG,OAAO,CAAC,OAAO,CAAC;IACjC,CAAC;IAED;;;;;;;;OAQG;IACH,KAAK,CAAC,WAAW,CAAC,MAAc,EAAE,SAAiB;QACjD,OAAO,MAAM,IAAA,2BAAiB,EAAC;YAC7B,MAAM,EAAE,IAAI,CAAC,MAAM;YACnB,SAAS,EAAE,IAAI,CAAC,SAAS;YACzB,MAAM;YACN,SAAS;SACV,CAAC,CAAC;IACL,CAAC;IAED;;;;;;;;;OASG;IACH,KAAK,CAAC,UAAU,CACd,MAAc,EACd,SAAiB,EACjB,OAAoB,EACpB,KAAc;QAEd,MAAM,IAAA,0BAAgB,EAAC;YACrB,MAAM,EAAE,IAAI,CAAC,MAAM;YACnB,SAAS,EAAE,IAAI,CAAC,SAAS;YACzB,MAAM;YACN,SAAS;YACT,OAAO;YACP,KAAK;YACL,OAAO,EAAE,IAAI,CAAC,OAAO;SACtB,CAAC,CAAC;IACL,CAAC;IAED;;;;;;;;;;OAUG;IACH,KAAK,CAAC,WAAW,CACf,MAAc,EACd,SAAiB,EACjB,QAAuB,EACvB,KAAc;QAEd,MAAM,IAAA,2BAAiB,EAAC;YACtB,MAAM,EAAE,IAAI,CAAC,MAAM;YACnB,SAAS,EAAE,IAAI,CAAC,SAAS;YACzB,MAAM;YACN,SAAS;YACT,QAAQ;YACR,KAAK;YACL,OAAO,EAAE,IAAI,CAAC,OAAO;SACtB,CAAC,CAAC;IACL,CAAC;IAED;;;;;;;OAOG;IACH,KAAK,CAAC,KAAK,CAAC,MAAc,EAAE,SAAiB;QAC3C,MAAM,IAAA,qBAAW,EAAC;YAChB,MAAM,EAAE,IAAI,CAAC,MAAM;YACnB,SAAS,EAAE,IAAI,CAAC,SAAS;YACzB,MAAM;YACN,SAAS;SACV,CAAC,CAAC;IACL,CAAC;IAED;;;;;;;;OAQG;IACH,KAAK,CAAC,YAAY,CAAC,MAAc,EAAE,KAAc;QAC/C,OAAO,MAAM,IAAA,4BAAkB,EAAC;YAC9B,MAAM,EAAE,IAAI,CAAC,MAAM;YACnB,SAAS,EAAE,IAAI,CAAC,SAAS;YACzB,MAAM;YACN,KAAK;SACN,CAAC,CAAC;IACL,CAAC;CACF;AAhID,gEAgIC"}

package/dist/history/types/index.d.ts

@@ -0,0 +1,131 @@
+/**
+ * Type definitions for chat message history
+ */
+import { DynamoDBClientConfig } from '@aws-sdk/client-dynamodb';
+import { DynamoDBDocument } from '@aws-sdk/lib-dynamodb';
+import { BaseMessage } from '@langchain/core/messages';
+/**
+ * Configuration options for DynamoDBChatMessageHistory
+ */
+export interface DynamoDBChatMessageHistoryOptions {
+    /** Name of the DynamoDB table to use for storage */
+    tableName: string;
+    /** Optional TTL in days for stored items (1-1825 days) */
+    ttlDays?: number;
+    /** Optional DynamoDB client configuration */
+    clientConfig?: DynamoDBClientConfig;
+}
+/**
+ * DynamoDB item structure for a chat session
+ */
+export interface DynamoDBSessionItem {
+    /** User identifier (partition key) */
+    userId: string;
+    /** Session identifier (sort key) */
+    sessionId: string;
+    /** Array of messages in chronological order */
+    messages: BaseMessage[];
+    /** Session title (auto-generated from the first message) */
+    title: string;
+    /** Timestamp when session was created (milliseconds) */
+    createdAt: number;
+    /** Timestamp when the session was last updated (milliseconds) */
+    updatedAt: number;
+    /** Number of messages in the session */
+    messageCount: number;
+    /** Optional TTL timestamp (Unix timestamp in seconds) */
+    ttl?: number;
+}
+/**
+ * Session metadata for listing (excludes messages)
+ */
+export interface SessionMetadata {
+    /** Session identifier */
+    sessionId: string;
+    /** Session title */
+    title: string;
+    /** Timestamp when session was created (milliseconds) */
+    createdAt: number;
+    /** Timestamp when the session was last updated (milliseconds) */
+    updatedAt: number;
+    /** Number of messages in the session */
+    messageCount: number;
+}
+/**
+ * Parameters for get message action
+ */
+export interface GetMessagesActionParams {
+    /** DynamoDB document client */
+    client: DynamoDBDocument;
+    /** Name of the table */
+    tableName: string;
+    /** User identifier */
+    userId: string;
+    /** Session identifier */
+    sessionId: string;
+}
+/**
+ * Parameters for add message action
+ */
+export interface AddMessageActionParams {
+    /** DynamoDB document client */
+    client: DynamoDBDocument;
+    /** Name of the table */
+    tableName: string;
+    /** User identifier */
+    userId: string;
+    /** Session identifier */
+    sessionId: string;
+    /** Message to add */
+    message: BaseMessage;
+    /** Optional session title (auto-generated if not provided) */
+    title?: string;
+    /** Optional TTL in days */
+    ttlDays?: number;
+}
+/**
+ * Parameters for add messages action
+ */
+export interface AddMessagesActionParams {
+    /** DynamoDB document client */
+    client: DynamoDBDocument;
+    /** Name of the table */
+    tableName: string;
+    /** User identifier */
+    userId: string;
+    /** Session identifier */
+    sessionId: string;
+    /** Messages to add */
+    messages: BaseMessage[];
+    /** Optional session title (auto-generated if not provided) */
+    title?: string;
+    /** Optional TTL in days */
+    ttlDays?: number;
+}
+/**
+ * Parameters for clear action
+ */
+export interface ClearActionParams {
+    /** DynamoDB document client */
+    client: DynamoDBDocument;
+    /** Name of the table */
+    tableName: string;
+    /** User identifier */
+    userId: string;
+    /** Session identifier */
+    sessionId: string;
+}
+/**
+ * Parameters for list sessions action
+ */
+export interface ListSessionsActionParams {
+    /** DynamoDB document client */
+    client: DynamoDBDocument;
+    /** Name of the table */
+    tableName: string;
+    /** User identifier */
+    userId: string;
+    /** Optional maximum number of sessions to return */
+    limit?: number;
+}
+//# sourceMappingURL=index.d.ts.map

package/dist/history/types/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../src/history/types/index.ts"],"names":[],"mappings":"AAAA;;GAEG;AAEH,OAAO,EAAE,oBAAoB,EAAE,MAAM,0BAA0B,CAAC;AAChE,OAAO,EAAE,gBAAgB,EAAE,MAAM,uBAAuB,CAAC;AACzD,OAAO,EAAE,WAAW,EAAE,MAAM,0BAA0B,CAAC;AAEvD;;GAEG;AACH,MAAM,WAAW,iCAAiC;IAChD,oDAAoD;IACpD,SAAS,EAAE,MAAM,CAAC;IAClB,0DAA0D;IAC1D,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,6CAA6C;IAC7C,YAAY,CAAC,EAAE,oBAAoB,CAAC;CACrC;AAED;;GAEG;AACH,MAAM,WAAW,mBAAmB;IAClC,sCAAsC;IACtC,MAAM,EAAE,MAAM,CAAC;IACf,oCAAoC;IACpC,SAAS,EAAE,MAAM,CAAC;IAClB,+CAA+C;IAC/C,QAAQ,EAAE,WAAW,EAAE,CAAC;IACxB,4DAA4D;IAC5D,KAAK,EAAE,MAAM,CAAC;IACd,wDAAwD;IACxD,SAAS,EAAE,MAAM,CAAC;IAClB,iEAAiE;IACjE,SAAS,EAAE,MAAM,CAAC;IAClB,wCAAwC;IACxC,YAAY,EAAE,MAAM,CAAC;IACrB,yDAAyD;IACzD,GAAG,CAAC,EAAE,MAAM,CAAC;CACd;AAED;;GAEG;AACH,MAAM,WAAW,eAAe;IAC9B,yBAAyB;IACzB,SAAS,EAAE,MAAM,CAAC;IAClB,oBAAoB;IACpB,KAAK,EAAE,MAAM,CAAC;IACd,wDAAwD;IACxD,SAAS,EAAE,MAAM,CAAC;IAClB,iEAAiE;IACjE,SAAS,EAAE,MAAM,CAAC;IAClB,wCAAwC;IACxC,YAAY,EAAE,MAAM,CAAC;CACtB;AAED;;GAEG;AACH,MAAM,WAAW,uBAAuB;IACtC,+BAA+B;IAC/B,MAAM,EAAE,gBAAgB,CAAC;IACzB,wBAAwB;IACxB,SAAS,EAAE,MAAM,CAAC;IAClB,sBAAsB;IACtB,MAAM,EAAE,MAAM,CAAC;IACf,yBAAyB;IACzB,SAAS,EAAE,MAAM,CAAC;CACnB;AAED;;GAEG;AACH,MAAM,WAAW,sBAAsB;IACrC,+BAA+B;IAC/B,MAAM,EAAE,gBAAgB,CAAC;IACzB,wBAAwB;IACxB,SAAS,EAAE,MAAM,CAAC;IAClB,sBAAsB;IACtB,MAAM,EAAE,MAAM,CAAC;IACf,yBAAyB;IACzB,SAAS,EAAE,MAAM,CAAC;IAClB,qBAAqB;IACrB,OAAO,EAAE,WAAW,CAAC;IACrB,8DAA8D;IAC9D,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,2BAA2B;IAC3B,OAAO,CAAC,EAAE,MAAM,CAAC;CAClB;AAED;;GAEG;AACH,MAAM,WAAW,uBAAuB;IACtC,+BAA+B;IAC/B,MAAM,EAAE,gBAAgB,CAAC;IACzB,wBAAwB;IACxB,SAAS,EAAE,MAAM,CAAC;IAClB,sBAAsB;IACtB,MAAM,EAAE,MAAM,CAAC;IACf,yBAAyB;IACzB,SAAS,EAAE,MAAM,CAAC;IAClB,sBAAsB;IACtB,QAAQ,EAAE,WAAW,EAAE,CAAC;IACxB,8DAA8D;IAC9D,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,2BAA2B;IAC3B,OAAO,CAAC,EAAE,MAAM,CAAC;CAClB;AAED;;GAEG;AACH,MAAM,WAAW,iBAAiB;IAChC,+BAA+B;IAC/B,MAAM,EAAE,gBAAgB,CAAC;IACzB,wBAAwB;IACxB,SAAS,EAAE,MAAM,CAAC;IAClB,sBAAsB;IACtB,MAAM,EAAE,MAAM,CAAC;IACf,yBAAyB;IACzB,SAAS,EAAE,MAAM,CAAC;CACnB;AAED;;GAEG;AACH,MAAM,WAAW,wBAAwB;IACvC,+BAA+B;IAC/B,MAAM,EAAE,gBAAgB,CAAC;IACzB,wBAAwB;IACxB,SAAS,EAAE,MAAM,CAAC;IAClB,sBAAsB;IACtB,MAAM,EAAE,MAAM,CAAC;IACf,oDAAoD;IACpD,KAAK,CAAC,EAAE,MAAM,CAAC;CAChB"}

package/dist/history/types/index.js

@@ -0,0 +1,6 @@
+"use strict";
+/**
+ * Type definitions for chat message history
+ */
+Object.defineProperty(exports, "__esModule", { value: true });
+//# sourceMappingURL=index.js.map

package/dist/history/types/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../../src/history/types/index.ts"],"names":[],"mappings":";AAAA;;GAEG"}

package/dist/history/utils/index.d.ts

@@ -0,0 +1,7 @@
+/**
+ * Utility functions for chat message history
+ */
+export * from './validation';
+export * from './title-generator';
+export { withDynamoDBRetry } from '../../shared/utils';
+//# sourceMappingURL=index.d.ts.map

package/dist/history/utils/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../src/history/utils/index.ts"],"names":[],"mappings":"AAAA;;GAEG;AAEH,cAAc,cAAc,CAAC;AAC7B,cAAc,mBAAmB,CAAC;AAClC,OAAO,EAAE,iBAAiB,EAAE,MAAM,oBAAoB,CAAC"}

package/dist/history/utils/index.js

@@ -0,0 +1,25 @@
+"use strict";
+/**
+ * Utility functions for chat message history
+ */
+var __createBinding = (this && this.__createBinding) || (Object.create ? (function(o, m, k, k2) {
+    if (k2 === undefined) k2 = k;
+    var desc = Object.getOwnPropertyDescriptor(m, k);
+    if (!desc || ("get" in desc ? !m.__esModule : desc.writable || desc.configurable)) {
+      desc = { enumerable: true, get: function() { return m[k]; } };
+    }
+    Object.defineProperty(o, k2, desc);
+}) : (function(o, m, k, k2) {
+    if (k2 === undefined) k2 = k;
+    o[k2] = m[k];
+}));
+var __exportStar = (this && this.__exportStar) || function(m, exports) {
+    for (var p in m) if (p !== "default" && !Object.prototype.hasOwnProperty.call(exports, p)) __createBinding(exports, m, p);
+};
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.withDynamoDBRetry = void 0;
+__exportStar(require("./validation"), exports);
+__exportStar(require("./title-generator"), exports);
+var utils_1 = require("../../shared/utils");
+Object.defineProperty(exports, "withDynamoDBRetry", { enumerable: true, get: function () { return utils_1.withDynamoDBRetry; } });
+//# sourceMappingURL=index.js.map

package/dist/history/utils/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../../src/history/utils/index.ts"],"names":[],"mappings":";AAAA;;GAEG;;;;;;;;;;;;;;;;;AAEH,+CAA6B;AAC7B,oDAAkC;AAClC,4CAAuD;AAA9C,0GAAA,iBAAiB,OAAA"}

package/dist/history/utils/title-generator.d.ts

@@ -0,0 +1,12 @@
+/**
+ * Title generation utilities for chat sessions
+ */
+import { BaseMessage } from '@langchain/core/messages';
+/**
+ * Generate a session title from the first message
+ *
+ * @param message - The first message in the session
+ * @returns A generated title string
+ */
+export declare function generateTitle(message: BaseMessage): string;
+//# sourceMappingURL=title-generator.d.ts.map

package/dist/history/utils/title-generator.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"title-generator.d.ts","sourceRoot":"","sources":["../../../src/history/utils/title-generator.ts"],"names":[],"mappings":"AAAA;;GAEG;AAEH,OAAO,EAAE,WAAW,EAAE,MAAM,0BAA0B,CAAC;AAKvD;;;;;GAKG;AACH,wBAAgB,aAAa,CAAC,OAAO,EAAE,WAAW,GAAG,MAAM,CAuC1D"}

package/dist/history/utils/title-generator.js

@@ -0,0 +1,52 @@
+"use strict";
+/**
+ * Title generation utilities for chat sessions
+ */
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.generateTitle = generateTitle;
+const MAX_TITLE_LENGTH = 100;
+const DEFAULT_TITLE = 'New Conversation';
+/**
+ * Generate a session title from the first message
+ *
+ * @param message - The first message in the session
+ * @returns A generated title string
+ */
+function generateTitle(message) {
+    if (!message || !message.content) {
+        return DEFAULT_TITLE;
+    }
+    // Convert content to string (it can be string or array of content parts)
+    let contentText = '';
+    if (typeof message.content === 'string') {
+        contentText = message.content;
+    }
+    else if (Array.isArray(message.content)) {
+        // Extract text from content parts if it's an array
+        contentText = message.content
+            .map((part) => {
+            if (typeof part === 'string')
+                return part;
+            if (typeof part === 'object' && part !== null && 'text' in part) {
+                return part.text;
+            }
+            return '';
+        })
+            .join(' ');
+    }
+    // Clean and truncate the title
+    const cleaned = contentText
+        .replace(/\s+/g, ' ') // Replace multiple whitespace with a single space
+        .replace(/[\r\n]+/g, ' ') // Replace newlines with space
+        .trim();
+    if (!cleaned) {
+        return DEFAULT_TITLE;
+    }
+    // Truncate to max length
+    if (cleaned.length <= MAX_TITLE_LENGTH) {
+        return cleaned;
+    }
+    // Truncate and add ellipsis
+    return cleaned.substring(0, MAX_TITLE_LENGTH - 3) + '...';
+}
+//# sourceMappingURL=title-generator.js.map

package/dist/history/utils/title-generator.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"title-generator.js","sourceRoot":"","sources":["../../../src/history/utils/title-generator.ts"],"names":[],"mappings":";AAAA;;GAEG;;AAaH,sCAuCC;AAhDD,MAAM,gBAAgB,GAAG,GAAG,CAAC;AAC7B,MAAM,aAAa,GAAG,kBAAkB,CAAC;AAEzC;;;;;GAKG;AACH,SAAgB,aAAa,CAAC,OAAoB;IAChD,IAAI,CAAC,OAAO,IAAI,CAAC,OAAO,CAAC,OAAO,EAAE,CAAC;QACjC,OAAO,aAAa,CAAC;IACvB,CAAC;IAED,yEAAyE;IACzE,IAAI,WAAW,GAAG,EAAE,CAAC;IACrB,IAAI,OAAO,OAAO,CAAC,OAAO,KAAK,QAAQ,EAAE,CAAC;QACxC,WAAW,GAAG,OAAO,CAAC,OAAO,CAAC;IAChC,CAAC;SAAM,IAAI,KAAK,CAAC,OAAO,CAAC,OAAO,CAAC,OAAO,CAAC,EAAE,CAAC;QAC1C,mDAAmD;QACnD,WAAW,GAAG,OAAO,CAAC,OAAO;aAC1B,GAAG,CAAC,CAAC,IAAI,EAAE,EAAE;YACZ,IAAI,OAAO,IAAI,KAAK,QAAQ;gBAAE,OAAO,IAAI,CAAC;YAC1C,IAAI,OAAO,IAAI,KAAK,QAAQ,IAAI,IAAI,KAAK,IAAI,IAAI,MAAM,IAAI,IAAI,EAAE,CAAC;gBAChE,OAAQ,IAAY,CAAC,IAAI,CAAC;YAC5B,CAAC;YACD,OAAO,EAAE,CAAC;QACZ,CAAC,CAAC;aACD,IAAI,CAAC,GAAG,CAAC,CAAC;IACf,CAAC;IAED,+BAA+B;IAC/B,MAAM,OAAO,GAAG,WAAW;SACxB,OAAO,CAAC,MAAM,EAAE,GAAG,CAAC,CAAC,kDAAkD;SACvE,OAAO,CAAC,UAAU,EAAE,GAAG,CAAC,CAAC,8BAA8B;SACvD,IAAI,EAAE,CAAC;IAEV,IAAI,CAAC,OAAO,EAAE,CAAC;QACb,OAAO,aAAa,CAAC;IACvB,CAAC;IAED,yBAAyB;IACzB,IAAI,OAAO,CAAC,MAAM,IAAI,gBAAgB,EAAE,CAAC;QACvC,OAAO,OAAO,CAAC;IACjB,CAAC;IAED,4BAA4B;IAC5B,OAAO,OAAO,CAAC,SAAS,CAAC,CAAC,EAAE,gBAAgB,GAAG,CAAC,CAAC,GAAG,KAAK,CAAC;AAC5D,CAAC"}

package/dist/history/utils/validation.d.ts

@@ -0,0 +1,60 @@
+/**
+ * Validation utilities for chat message history operations
+ */
+import { BaseMessage } from '@langchain/core/messages';
+/**
+ * Custom error class for validation errors in chat message history
+ */
+export declare class HistoryValidationError extends Error {
+    constructor(message: string);
+}
+/**
+ * Validate user ID
+ *
+ * @param userId - User identifier to validate
+ * @throws HistoryValidationError if validation fails
+ */
+export declare function validateUserId(userId: string): void;
+/**
+ * Validate session ID
+ *
+ * @param sessionId - Session identifier to validate
+ * @throws HistoryValidationError if validation fails
+ */
+export declare function validateSessionId(sessionId: string): void;
+/**
+ * Validate a single message
+ *
+ * @param message - BaseMessage to validate
+ * @throws HistoryValidationError if validation fails
+ */
+export declare function validateMessage(message: BaseMessage): void;
+/**
+ * Validate messages array
+ *
+ * @param messages - Array of BaseMessage objects to validate
+ * @throws HistoryValidationError if validation fails
+ */
+export declare function validateMessages(messages: BaseMessage[]): void;
+/**
+ * Validate title
+ *
+ * @param title - Optional title string to validate
+ * @throws HistoryValidationError if validation fails
+ */
+export declare function validateTitle(title: string | undefined): void;
+/**
+ * Validate list limit parameter
+ *
+ * @param limit - Optional maximum number of items to return
+ * @throws HistoryValidationError if validation fails
+ */
+export declare function validateLimit(limit: number | undefined): void;
+/**
+ * Validate TTL days (wraps shared validation with a history-specific error type)
+ *
+ * @param ttlDays - Optional TTL in days
+ * @throws HistoryValidationError if validation fails
+ */
+export declare function validateTTLDays(ttlDays: number | undefined): void;
+//# sourceMappingURL=validation.d.ts.map

package/dist/history/utils/validation.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"validation.d.ts","sourceRoot":"","sources":["../../../src/history/utils/validation.ts"],"names":[],"mappings":"AAAA;;GAEG;AAEH,OAAO,EAAE,WAAW,EAAE,MAAM,0BAA0B,CAAC;AAUvD;;GAEG;AACH,qBAAa,sBAAuB,SAAQ,KAAK;gBACnC,OAAO,EAAE,MAAM;CAI5B;AAED;;;;;GAKG;AACH,wBAAgB,cAAc,CAAC,MAAM,EAAE,MAAM,GAAG,IAAI,CAoBnD;AAED;;;;;GAKG;AACH,wBAAgB,iBAAiB,CAAC,SAAS,EAAE,MAAM,GAAG,IAAI,CAoBzD;AAED;;;;;GAKG;AACH,wBAAgB,eAAe,CAAC,OAAO,EAAE,WAAW,GAAG,IAAI,CAa1D;AAED;;;;;GAKG;AACH,wBAAgB,gBAAgB,CAAC,QAAQ,EAAE,WAAW,EAAE,GAAG,IAAI,CAyB9D;AAED;;;;;GAKG;AACH,wBAAgB,aAAa,CAAC,KAAK,EAAE,MAAM,GAAG,SAAS,GAAG,IAAI,CAc7D;AAED;;;;;GAKG;AACH,wBAAgB,aAAa,CAAC,KAAK,EAAE,MAAM,GAAG,SAAS,GAAG,IAAI,CAgB7D;AAED;;;;;GAKG;AACH,wBAAgB,eAAe,CAAC,OAAO,EAAE,MAAM,GAAG,SAAS,GAAG,IAAI,CAOjE"}